From 5c4ffc8a8cd880bfeefc8590f06e539c3ab1ff45 Mon Sep 17 00:00:00 2001
From: SivagurunathanV <sivadeva.93@gmail.com>
Date: Thu, 24 Jan 2019 08:00:46 -0600
Subject: [PATCH 001/686] Fix for #37739

---
 .../rest/src/main/java/org/elasticsearch/client/RestClient.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/client/rest/src/main/java/org/elasticsearch/client/RestClient.java b/client/rest/src/main/java/org/elasticsearch/client/RestClient.java
index 3b1946ef9ed58..c587e71973f65 100644
--- a/client/rest/src/main/java/org/elasticsearch/client/RestClient.java
+++ b/client/rest/src/main/java/org/elasticsearch/client/RestClient.java
@@ -398,7 +398,7 @@ static Iterable<Node> selectNodes(NodeTuple<List<Node>> nodeTuple, Map<HttpHost,
         /*
          * Sort the nodes into living and dead lists.
          */
-        List<Node> livingNodes = new ArrayList<>(nodeTuple.nodes.size() - blacklist.size());
+        List<Node> livingNodes = new ArrayList<>(Math.max(0,nodeTuple.nodes.size() - blacklist.size()));
         List<DeadNode> deadNodes = new ArrayList<>(blacklist.size());
         for (Node node : nodeTuple.nodes) {
             DeadHostState deadness = blacklist.get(node.getHost());

From b5625fd2bb786829266ae11ccf241fd2281c63ac Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 24 Jan 2019 19:40:13 -0600
Subject: [PATCH 002/686] Adding Test Case

---
 .../main/java/org/elasticsearch/client/RestClient.java   | 2 +-
 .../java/org/elasticsearch/client/RestClientTests.java   | 9 +++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/client/rest/src/main/java/org/elasticsearch/client/RestClient.java b/client/rest/src/main/java/org/elasticsearch/client/RestClient.java
index c587e71973f65..d053bda7d44fa 100644
--- a/client/rest/src/main/java/org/elasticsearch/client/RestClient.java
+++ b/client/rest/src/main/java/org/elasticsearch/client/RestClient.java
@@ -398,7 +398,7 @@ static Iterable<Node> selectNodes(NodeTuple<List<Node>> nodeTuple, Map<HttpHost,
         /*
          * Sort the nodes into living and dead lists.
          */
-        List<Node> livingNodes = new ArrayList<>(Math.max(0,nodeTuple.nodes.size() - blacklist.size()));
+        List<Node> livingNodes = new ArrayList<>(Math.max(0, nodeTuple.nodes.size() - blacklist.size()));
         List<DeadNode> deadNodes = new ArrayList<>(blacklist.size());
         for (Node node : nodeTuple.nodes) {
             DeadHostState deadness = blacklist.get(node.getHost());
diff --git a/client/rest/src/test/java/org/elasticsearch/client/RestClientTests.java b/client/rest/src/test/java/org/elasticsearch/client/RestClientTests.java
index 69cdfeae85dff..f3f0f0e58b98d 100644
--- a/client/rest/src/test/java/org/elasticsearch/client/RestClientTests.java
+++ b/client/rest/src/test/java/org/elasticsearch/client/RestClientTests.java
@@ -272,6 +272,15 @@ public String toString() {
             blacklist.put(n2.getHost(), new DeadHostState(new DeadHostState(timeSupplier)));
             blacklist.put(n3.getHost(), new DeadHostState(new DeadHostState(new DeadHostState(timeSupplier))));
 
+            /*
+             * case when fewer nodeTuple than blacklist, wont result in any IllegalCapacityException
+             */
+            {
+                NodeTuple<List<Node>> fewerNodeTuple = new NodeTuple<>(Arrays.asList(n1, n2), null);
+                assertSelectLivingHosts(Arrays.asList(n1), fewerNodeTuple, blacklist, NodeSelector.ANY);
+                assertSelectLivingHosts(Arrays.asList(n2), fewerNodeTuple, blacklist, not1);
+            }
+
             /*
              * selectHosts will revive a single host if regardless of
              * blacklist time. It'll revive the node that is closest

From 29eac2f7583c3fec806351dc4af9a5f605782515 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 27 Oct 2019 10:07:49 -0700
Subject: [PATCH 003/686] Pure disjunctions should rewrite to a
 MatchNoneQueryBuilder

---
 .../org/elasticsearch/index/query/BoolQueryBuilder.java   | 8 +++++++-
 .../elasticsearch/index/query/BoolQueryBuilderTests.java  | 6 ++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
index 573fee708f20a..b75fd3ce285c3 100644
--- a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
@@ -418,11 +418,17 @@ protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext) throws
         changed |= rewriteClauses(queryRewriteContext, filterClauses, newBuilder::filter);
         changed |= rewriteClauses(queryRewriteContext, shouldClauses, newBuilder::should);
         // lets do some early termination and prevent any kind of rewriting if we have a mandatory query that is a MatchNoneQueryBuilder
-        Optional<QueryBuilder> any = Stream.concat(newBuilder.mustClauses.stream(), newBuilder.filterClauses.stream())
+        final Stream<QueryBuilder> mustAndFilterClauseStream =
+            Stream.concat(newBuilder.mustClauses.stream(), newBuilder.filterClauses.stream());
+        Optional<QueryBuilder> any = mustAndFilterClauseStream
             .filter(b -> b instanceof MatchNoneQueryBuilder).findAny();
         if (any.isPresent()) {
             return any.get();
         }
+        boolean allMatchNoneQuery = mustAndFilterClauseStream.allMatch(b -> b instanceof MatchNoneQueryBuilder);
+        if (allMatchNoneQuery) {
+            return new MatchNoneQueryBuilder();
+        }
         if (changed) {
             newBuilder.adjustPureNegative = adjustPureNegative;
             newBuilder.minimumShouldMatch = minimumShouldMatch;
diff --git a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
index 10a31d8054801..4bde1a70939f2 100644
--- a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
@@ -371,5 +371,11 @@ public void testRewriteWithMatchNone() throws IOException {
             .filter(new MatchNoneQueryBuilder()));
         rewritten = Rewriteable.rewrite(boolQueryBuilder, createShardContext());
         assertEquals(new MatchNoneQueryBuilder(), rewritten);
+
+        boolQueryBuilder = new BoolQueryBuilder();
+        boolQueryBuilder.must(new WrapperQueryBuilder(new MatchNoneQueryBuilder().toString()));
+        boolQueryBuilder.filter(new WrapperQueryBuilder(new WrapperQueryBuilder(new MatchNoneQueryBuilder().toString()).toString()));
+        rewritten = Rewriteable.rewrite(boolQueryBuilder, createShardContext());
+        assertEquals(new MatchNoneQueryBuilder(), rewritten);
     }
 }

From 7cae811cc79ba3b7366d61ffa037e32ca48dbe27 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Mon, 28 Oct 2019 22:33:42 -0700
Subject: [PATCH 004/686] Handling optional clause changes as per review
 comments

---
 .../elasticsearch/index/query/BoolQueryBuilder.java | 13 +++++++------
 .../index/query/BoolQueryBuilderTests.java          |  3 +--
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
index b75fd3ce285c3..b2d602f16075d 100644
--- a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
@@ -418,16 +418,17 @@ protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext) throws
         changed |= rewriteClauses(queryRewriteContext, filterClauses, newBuilder::filter);
         changed |= rewriteClauses(queryRewriteContext, shouldClauses, newBuilder::should);
         // lets do some early termination and prevent any kind of rewriting if we have a mandatory query that is a MatchNoneQueryBuilder
-        final Stream<QueryBuilder> mustAndFilterClauseStream =
-            Stream.concat(newBuilder.mustClauses.stream(), newBuilder.filterClauses.stream());
-        Optional<QueryBuilder> any = mustAndFilterClauseStream
+        Optional<QueryBuilder> any = Stream.concat(newBuilder.mustClauses.stream(), newBuilder.filterClauses.stream())
             .filter(b -> b instanceof MatchNoneQueryBuilder).findAny();
         if (any.isPresent()) {
             return any.get();
         }
-        boolean allMatchNoneQuery = mustAndFilterClauseStream.allMatch(b -> b instanceof MatchNoneQueryBuilder);
-        if (allMatchNoneQuery) {
-            return new MatchNoneQueryBuilder();
+        // early termination when must clause is empty and optional clauses is returning MatchNoneQueryBuilder
+        if(mustClauses.size() == 0 && filterClauses.size() == 0) {
+           any = newBuilder.shouldClauses.stream().filter(b -> b instanceof MatchNoneQueryBuilder).findAny();
+           if (any.isPresent()) {
+               return any.get();
+           }
         }
         if (changed) {
             newBuilder.adjustPureNegative = adjustPureNegative;
diff --git a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
index 4bde1a70939f2..76d60ea9274d1 100644
--- a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
@@ -373,8 +373,7 @@ public void testRewriteWithMatchNone() throws IOException {
         assertEquals(new MatchNoneQueryBuilder(), rewritten);
 
         boolQueryBuilder = new BoolQueryBuilder();
-        boolQueryBuilder.must(new WrapperQueryBuilder(new MatchNoneQueryBuilder().toString()));
-        boolQueryBuilder.filter(new WrapperQueryBuilder(new WrapperQueryBuilder(new MatchNoneQueryBuilder().toString()).toString()));
+        boolQueryBuilder.should(new WrapperQueryBuilder(new MatchNoneQueryBuilder().toString()));
         rewritten = Rewriteable.rewrite(boolQueryBuilder, createShardContext());
         assertEquals(new MatchNoneQueryBuilder(), rewritten);
     }

From 9cf3f5ac69d0d3d19192e0be74024b8b6e94ac4b Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Tue, 29 Oct 2019 07:45:03 -0700
Subject: [PATCH 005/686] All should clause MatchNone and modified Testcase

---
 .../index/query/BoolQueryBuilder.java              | 14 +++++++-------
 .../index/query/BoolQueryBuilderTests.java         |  6 ++++++
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
index b2d602f16075d..2f769e8097493 100644
--- a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
@@ -417,19 +417,19 @@ protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext) throws
         changed |= rewriteClauses(queryRewriteContext, mustNotClauses, newBuilder::mustNot);
         changed |= rewriteClauses(queryRewriteContext, filterClauses, newBuilder::filter);
         changed |= rewriteClauses(queryRewriteContext, shouldClauses, newBuilder::should);
+        // early termination when must clause is empty and optional clauses is returning MatchNoneQueryBuilder
+        if(mustClauses.size() == 0 && filterClauses.size() == 0
+            && newBuilder.shouldClauses.stream().allMatch(b -> b instanceof MatchNoneQueryBuilder)) {
+                return new MatchNoneQueryBuilder();
+        }
+
         // lets do some early termination and prevent any kind of rewriting if we have a mandatory query that is a MatchNoneQueryBuilder
         Optional<QueryBuilder> any = Stream.concat(newBuilder.mustClauses.stream(), newBuilder.filterClauses.stream())
             .filter(b -> b instanceof MatchNoneQueryBuilder).findAny();
         if (any.isPresent()) {
             return any.get();
         }
-        // early termination when must clause is empty and optional clauses is returning MatchNoneQueryBuilder
-        if(mustClauses.size() == 0 && filterClauses.size() == 0) {
-           any = newBuilder.shouldClauses.stream().filter(b -> b instanceof MatchNoneQueryBuilder).findAny();
-           if (any.isPresent()) {
-               return any.get();
-           }
-        }
+
         if (changed) {
             newBuilder.adjustPureNegative = adjustPureNegative;
             newBuilder.minimumShouldMatch = minimumShouldMatch;
diff --git a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
index 76d60ea9274d1..df0118b9992d6 100644
--- a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
@@ -376,5 +376,11 @@ public void testRewriteWithMatchNone() throws IOException {
         boolQueryBuilder.should(new WrapperQueryBuilder(new MatchNoneQueryBuilder().toString()));
         rewritten = Rewriteable.rewrite(boolQueryBuilder, createShardContext());
         assertEquals(new MatchNoneQueryBuilder(), rewritten);
+
+        boolQueryBuilder = new BoolQueryBuilder();
+        boolQueryBuilder.should(new TermQueryBuilder("foo", "bar"));
+        boolQueryBuilder.should(new WrapperQueryBuilder(new MatchNoneQueryBuilder().toString()));
+        rewritten = Rewriteable.rewrite(boolQueryBuilder, createShardContext());
+        assertNotEquals(new MatchNoneQueryBuilder(), rewritten);
     }
 }

From 76287289727272e809df199cd692f27da53f7a41 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Tue, 26 Nov 2019 15:48:41 -0800
Subject: [PATCH 006/686] Adding cases for empty should clause

---
 .../java/org/elasticsearch/index/query/BoolQueryBuilder.java  | 2 +-
 .../org/elasticsearch/index/query/BoolQueryBuilderTests.java  | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
index 2f769e8097493..5dd7903141ddb 100644
--- a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
@@ -418,7 +418,7 @@ protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext) throws
         changed |= rewriteClauses(queryRewriteContext, filterClauses, newBuilder::filter);
         changed |= rewriteClauses(queryRewriteContext, shouldClauses, newBuilder::should);
         // early termination when must clause is empty and optional clauses is returning MatchNoneQueryBuilder
-        if(mustClauses.size() == 0 && filterClauses.size() == 0
+        if(mustClauses.size() == 0 && filterClauses.size() == 0 && shouldClauses.size() > 0
             && newBuilder.shouldClauses.stream().allMatch(b -> b instanceof MatchNoneQueryBuilder)) {
                 return new MatchNoneQueryBuilder();
         }
diff --git a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
index df0118b9992d6..1a1609fe7c50e 100644
--- a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
@@ -382,5 +382,9 @@ public void testRewriteWithMatchNone() throws IOException {
         boolQueryBuilder.should(new WrapperQueryBuilder(new MatchNoneQueryBuilder().toString()));
         rewritten = Rewriteable.rewrite(boolQueryBuilder, createShardContext());
         assertNotEquals(new MatchNoneQueryBuilder(), rewritten);
+
+        boolQueryBuilder = new BoolQueryBuilder();
+        rewritten = Rewriteable.rewrite(boolQueryBuilder, createShardContext());
+        assertNotEquals(new MatchNoneQueryBuilder(), rewritten);
     }
 }

From ada16e9ecd1702c249cb1e220932251e6dbb65bb Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 8 Dec 2019 14:52:32 -0800
Subject: [PATCH 007/686] Adding best compression inital commit

---
 .../xpack/core/ilm/CloseIndexStep.java        |  42 +++++
 .../xpack/core/ilm/ForceMergeAction.java      |  42 ++++-
 .../xpack/core/ilm/OpenIndexStep.java         |  38 +++++
 .../xpack/core/ilm/WaitForIndexGreenStep.java |  98 +++++++++++
 .../xpack/core/ilm/CloseIndexStepTest.java    | 155 +++++++++++++++++
 .../xpack/core/ilm/ForceMergeActionTests.java |  77 +++++++--
 .../xpack/core/ilm/OpenIndexStepTest.java     | 158 ++++++++++++++++++
 .../ilm/TimeseriesLifecycleTypeTests.java     |   4 +-
 .../core/ilm/WaitForIndexGreenStepTest.java   | 155 +++++++++++++++++
 9 files changed, 745 insertions(+), 24 deletions(-)
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
new file mode 100644
index 0000000000000..8f78ce75653e5
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.close.CloseIndexRequest;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateObserver;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.xpack.core.ilm.AsyncActionStep;
+
+/**
+ * Invokes a Close Index Step on a index.
+ */
+public class CloseIndexStep extends AsyncActionStep {
+    public static final String NAME = "close-index";
+
+    CloseIndexStep(StepKey key, StepKey nextStepKey, Client client) {
+        super(key, nextStepKey, client);
+    }
+
+    @Override
+    public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState, ClusterStateObserver observer, Listener listener) {
+        if(indexMetaData.getState() == IndexMetaData.State.OPEN) {
+            CloseIndexRequest request = new CloseIndexRequest(indexMetaData.getIndex().getName());
+            getClient().admin().indices()
+                .close(request, ActionListener.wrap(closeIndexResponse -> listener.onResponse(true), listener::onFailure));
+        }
+        else {
+            listener.onResponse(true);
+        }
+    }
+
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index eb5f2b61017a1..5d4227a766f58 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -15,6 +15,8 @@
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.index.codec.CodecService;
+import org.elasticsearch.index.engine.EngineConfig;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 
 import java.io.IOException;
@@ -28,42 +30,53 @@
 public class ForceMergeAction implements LifecycleAction {
     public static final String NAME = "forcemerge";
     public static final ParseField MAX_NUM_SEGMENTS_FIELD = new ParseField("max_num_segments");
+    public static final ParseField BEST_COMPRESSION_FIELD = new ParseField("best_compression");
 
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        return new ForceMergeAction(maxNumSegments);
+        boolean bestCompression = a[1] != null && (boolean) a[1];
+        return new ForceMergeAction(maxNumSegments, bestCompression);
     });
 
     static {
         PARSER.declareInt(ConstructingObjectParser.constructorArg(), MAX_NUM_SEGMENTS_FIELD);
+        PARSER.declareBoolean(ConstructingObjectParser.constructorArg(), BEST_COMPRESSION_FIELD);
     }
 
     private final int maxNumSegments;
+    private final boolean bestCompression;
 
     public static ForceMergeAction parse(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    public ForceMergeAction(int maxNumSegments) {
+    public ForceMergeAction(int maxNumSegments, boolean bestCompression) {
         if (maxNumSegments <= 0) {
             throw new IllegalArgumentException("[" + MAX_NUM_SEGMENTS_FIELD.getPreferredName()
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
+        this.bestCompression = bestCompression;
     }
 
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
+        this.bestCompression = in.readBoolean();
     }
 
     public int getMaxNumSegments() {
         return maxNumSegments;
     }
 
+    public boolean isBestCompression() {
+        return bestCompression;
+    }
+
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
+        out.writeBoolean(bestCompression);
     }
 
     @Override
@@ -80,6 +93,7 @@ public boolean isSafeAction() {
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
         builder.field(MAX_NUM_SEGMENTS_FIELD.getPreferredName(), maxNumSegments);
+        builder.field(BEST_COMPRESSION_FIELD.getPreferredName(), bestCompression);
         builder.endObject();
         return builder;
     }
@@ -92,6 +106,25 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         StepKey forceMergeKey = new StepKey(phase, NAME, ForceMergeStep.NAME);
         StepKey countKey = new StepKey(phase, NAME, SegmentCountStep.NAME);
 
+
+        if (this.bestCompression) {
+            StepKey closeKey = new StepKey(phase, NAME, CloseIndexStep.NAME);
+            StepKey openKey = new StepKey(phase, NAME, OpenIndexStep.NAME);
+            StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexGreenStep.NAME);
+            StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
+            Settings bestCompressionSettings = Settings.builder()
+                .put(EngineConfig.INDEX_CODEC_SETTING.getKey(), CodecService.BEST_COMPRESSION_CODEC).build();
+
+            CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
+            UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
+                openKey, client, bestCompressionSettings);
+            OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
+            WaitForIndexGreenStep waitForIndexGreenStep = new WaitForIndexGreenStep(waitForGreenIndexKey, forceMergeKey);
+            ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, nextStepKey, client, maxNumSegments);
+            return Arrays.asList(closeIndexStep, updateBestCompressionSettings,
+                openIndexStep, waitForIndexGreenStep, forceMergeStep);
+        }
+
         UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, forceMergeKey, client, readOnlySettings);
         ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
         SegmentCountStep segmentCountStep = new SegmentCountStep(countKey, nextStepKey, client, maxNumSegments);
@@ -100,7 +133,7 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
 
     @Override
     public int hashCode() {
-        return Objects.hash(maxNumSegments);
+        return Objects.hash(maxNumSegments, bestCompression);
     }
 
     @Override
@@ -112,7 +145,8 @@ public boolean equals(Object obj) {
             return false;
         }
         ForceMergeAction other = (ForceMergeAction) obj;
-        return Objects.equals(maxNumSegments, other.maxNumSegments);
+        return Objects.equals(maxNumSegments, other.maxNumSegments)
+            && Objects.equals(bestCompression, other.bestCompression);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
new file mode 100644
index 0000000000000..793db17eb8376
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateObserver;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+
+final class OpenIndexStep extends AsyncActionStep {
+
+    static final String NAME = "open-index";
+
+    OpenIndexStep(StepKey key, StepKey nextStepKey, Client client) {
+        super(key, nextStepKey, client);
+    }
+
+    @Override
+    public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState,
+                              ClusterStateObserver observer, Listener listener) {
+        if (indexMetaData.getState() == IndexMetaData.State.CLOSE) {
+            OpenIndexRequest request = new OpenIndexRequest(indexMetaData.getIndex().getName());
+            getClient().admin().indices()
+                .open(request,
+                    ActionListener.wrap(closeIndexResponse -> listener.onResponse(true), listener::onFailure));
+
+        } else {
+            listener.onResponse(true);
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
new file mode 100644
index 0000000000000..f001644da2022
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
@@ -0,0 +1,98 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+package org.elasticsearch.xpack.core.ilm;
+
+import com.carrotsearch.hppc.cursors.IntObjectCursor;
+import com.carrotsearch.hppc.cursors.ObjectCursor;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.routing.IndexRoutingTable;
+import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
+import org.elasticsearch.cluster.routing.RoutingTable;
+import org.elasticsearch.cluster.routing.ShardRouting;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.index.Index;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Objects;
+import java.util.stream.Stream;
+
+class WaitForIndexGreenStep extends ClusterStateWaitStep {
+
+    static final String NAME = "wait-for-index-green-step";
+
+    WaitForIndexGreenStep(StepKey key, StepKey nextStepKey) {
+        super(key, nextStepKey);
+    }
+
+    @Override
+    public Result isConditionMet(Index index, ClusterState clusterState) {
+        RoutingTable routingTable = clusterState.routingTable();
+        IndexRoutingTable indexRoutingTable = routingTable.index(index);
+        if (indexRoutingTable == null) {
+            return new Result(false, new Info("index is red; no IndexRoutingTable"));
+        }
+
+        boolean indexIsGreen = false;
+        if(indexRoutingTable.allPrimaryShardsActive()) {
+            boolean replicaIndexIsGreen = false;
+            for (ObjectCursor<IndexShardRoutingTable> shardRouting : indexRoutingTable.getShards().values()) {
+                replicaIndexIsGreen = shardRouting.value.replicaShards().stream().allMatch(ShardRouting::active);
+                if(!replicaIndexIsGreen) {
+                    return new Result(false, new Info("index is yellow; not all replica shards are active"));
+                }
+            }
+            indexIsGreen = replicaIndexIsGreen;
+        }
+
+
+        if (indexIsGreen) {
+            return new Result(true, null);
+        } else {
+            return new Result(false, new Info("index is not green; not all shards are active"));
+        }
+    }
+
+    static final class Info implements ToXContentObject {
+
+        static final ParseField MESSAGE_FIELD = new ParseField("message");
+
+        private final String message;
+
+        Info(String message) {
+            this.message = message;
+        }
+
+        String getMessage() {
+            return message;
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(MESSAGE_FIELD.getPreferredName(), message);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Info info = (Info) o;
+            return Objects.equals(getMessage(), info.getMessage());
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(getMessage());
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
new file mode 100644
index 0000000000000..7d7a64edc6336
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
@@ -0,0 +1,155 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+
+package org.elasticsearch.xpack.core.ilm;
+
+import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.close.CloseIndexRequest;
+import org.elasticsearch.action.admin.indices.close.CloseIndexResponse;
+import org.elasticsearch.client.AdminClient;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.client.IndicesAdminClient;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.junit.Before;
+import org.mockito.Mockito;
+import org.mockito.stubbing.Answer;
+
+import java.util.Collections;
+
+import static org.hamcrest.Matchers.equalTo;
+
+/**
+ * Created by sivagurunathanvelayutham on Dec, 2019
+ */
+public class CloseIndexStepTest extends AbstractStepTestCase<CloseIndexStep> {
+
+    private Client client;
+
+    @Before
+    public void setup() {
+        client = Mockito.mock(Client.class);
+    }
+
+    @Override
+    protected CloseIndexStep createRandomInstance() {
+        return new CloseIndexStep(randomStepKey(), randomStepKey(), client);
+    }
+
+    @Override
+    protected CloseIndexStep mutateInstance(CloseIndexStep instance) {
+        Step.StepKey key = instance.getKey();
+        Step.StepKey nextKey = instance.getNextStepKey();
+
+        switch (between(0, 1)) {
+            case 0:
+                key = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 1:
+                nextKey = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+
+        return new CloseIndexStep(key, nextKey, client);
+    }
+
+    @Override
+    protected CloseIndexStep copyInstance(CloseIndexStep instance) {
+        return new CloseIndexStep(instance.getKey(), instance.getNextStepKey(), instance.getClient());
+    }
+
+    public void testPerformAction() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10)).settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
+
+        CloseIndexStep step = createRandomInstance();
+
+        AdminClient adminClient = Mockito.mock(AdminClient.class);
+        IndicesAdminClient indicesClient = Mockito.mock(IndicesAdminClient.class);
+
+        Mockito.when(client.admin()).thenReturn(adminClient);
+        Mockito.when(adminClient.indices()).thenReturn(indicesClient);
+
+        Mockito.doAnswer((Answer<Void>) invocation -> {
+            CloseIndexRequest request = (CloseIndexRequest) invocation.getArguments()[0];
+            @SuppressWarnings("unchecked")
+            ActionListener<CloseIndexResponse> listener = (ActionListener<CloseIndexResponse>) invocation.getArguments()[1];
+            assertThat(request.indices(), equalTo(new String[]{indexMetaData.getIndex().getName()}));
+            listener.onResponse(new CloseIndexResponse(true, true,
+                Collections.singletonList(new CloseIndexResponse.IndexResult(indexMetaData.getIndex()))));
+            return null;
+        }).when(indicesClient).close(Mockito.any(), Mockito.any());
+
+        SetOnce<Boolean> actionCompleted = new SetOnce<>();
+
+        step.performAction(indexMetaData, null, null, new AsyncActionStep.Listener() {
+
+            @Override
+            public void onResponse(boolean complete) {
+                actionCompleted.set(complete);
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                throw new AssertionError("Unexpected method call", e);
+            }
+        });
+
+        assertEquals(true, actionCompleted.get());
+        Mockito.verify(client, Mockito.only()).admin();
+        Mockito.verify(adminClient, Mockito.only()).indices();
+        Mockito.verify(indicesClient, Mockito.only()).close(Mockito.any(), Mockito.any());
+    }
+
+
+    public void testPerformActionFailure() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10)).settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
+
+        CloseIndexStep step = createRandomInstance();
+        Exception exception = new RuntimeException();
+        AdminClient adminClient = Mockito.mock(AdminClient.class);
+        IndicesAdminClient indicesClient = Mockito.mock(IndicesAdminClient.class);
+
+        Mockito.when(client.admin()).thenReturn(adminClient);
+        Mockito.when(adminClient.indices()).thenReturn(indicesClient);
+
+        Mockito.doAnswer((Answer<Void>) invocation -> {
+            CloseIndexRequest request = (CloseIndexRequest) invocation.getArguments()[0];
+            @SuppressWarnings("unchecked")
+            ActionListener<CloseIndexResponse> listener = (ActionListener<CloseIndexResponse>) invocation.getArguments()[1];
+            assertThat(request.indices(), equalTo(new String[]{indexMetaData.getIndex().getName()}));
+            listener.onFailure(exception);
+            return null;
+        }).when(indicesClient).close(Mockito.any(), Mockito.any());
+
+        SetOnce<Boolean> exceptionThrown = new SetOnce<>();
+
+        step.performAction(indexMetaData, null, null, new AsyncActionStep.Listener() {
+
+            @Override
+            public void onResponse(boolean complete) {
+                throw new AssertionError("Unexpected method call");
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                assertSame(exception, e);
+                exceptionThrown.set(true);
+            }
+        });
+
+        assertEquals(true, exceptionThrown.get());
+        Mockito.verify(client, Mockito.only()).admin();
+        Mockito.verify(adminClient, Mockito.only()).indices();
+        Mockito.verify(indicesClient, Mockito.only()).close(Mockito.any(), Mockito.any());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 92fe40a08dfcc..c12f6e7459bd2 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -13,6 +13,8 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.index.codec.CodecService;
+import org.elasticsearch.index.engine.EngineConfig;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 
 import java.io.IOException;
@@ -33,14 +35,20 @@ protected ForceMergeAction createTestInstance() {
     }
 
     static ForceMergeAction randomInstance() {
-        return new ForceMergeAction(randomIntBetween(1, 100));
+        return new ForceMergeAction(randomIntBetween(1, 100), randomBoolean());
     }
 
     @Override
     protected ForceMergeAction mutateInstance(ForceMergeAction instance) {
         int maxNumSegments = instance.getMaxNumSegments();
-        maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
-        return new ForceMergeAction(maxNumSegments);
+        boolean bestCompression = instance.isBestCompression();
+        if(randomBoolean()) {
+            maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
+        }
+        else {
+            bestCompression = !bestCompression;
+        }
+        return new ForceMergeAction(maxNumSegments, bestCompression);
     }
 
     @Override
@@ -48,21 +56,7 @@ protected Reader<ForceMergeAction> instanceReader() {
         return ForceMergeAction::new;
     }
 
-    public void testMissingMaxNumSegments() throws IOException {
-        BytesReference emptyObject = BytesReference.bytes(JsonXContent.contentBuilder().startObject().endObject());
-        XContentParser parser = XContentHelper.createParser(null, DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
-            emptyObject, XContentType.JSON);
-        Exception e = expectThrows(IllegalArgumentException.class, () -> ForceMergeAction.parse(parser));
-        assertThat(e.getMessage(), equalTo("Required [max_num_segments]"));
-    }
-
-    public void testInvalidNegativeSegmentNumber() {
-        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0)));
-        assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
-    }
-
-    public void testToSteps() {
-        ForceMergeAction instance = createTestInstance();
+    private void assertNonBestCompression(ForceMergeAction instance) {
         String phase = randomAlphaOfLength(5);
         StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
         List<Step> steps = instance.toSteps(null, phase, nextStepKey);
@@ -79,4 +73,51 @@ public void testToSteps() {
         assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
         assertThat(thirdStep.getNextStepKey(), equalTo(nextStepKey));
     }
+
+    private void assertBestCompression(ForceMergeAction instance) {
+        String phase = randomAlphaOfLength(5);
+        StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
+        List<Step> steps = instance.toSteps(null, phase, nextStepKey);
+        assertNotNull(steps);
+        assertEquals(5, steps.size());
+        CloseIndexStep firstStep = (CloseIndexStep) steps.get(0);
+        UpdateSettingsStep secondStep = (UpdateSettingsStep) steps.get(1);
+        OpenIndexStep thirdStep = (OpenIndexStep) steps.get(2);
+        WaitForIndexGreenStep fourthStep = (WaitForIndexGreenStep) steps.get(3);
+        ForceMergeStep fifthStep = (ForceMergeStep) steps.get(4);
+        assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
+        assertThat(firstStep.getNextStepKey(), equalTo(secondStep.getKey()));
+        assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
+        assertThat(secondStep.getSettings().get(EngineConfig.INDEX_CODEC_SETTING.getKey()), equalTo(CodecService.BEST_COMPRESSION_CODEC));
+        assertThat(secondStep.getNextStepKey(), equalTo(thirdStep.getKey()));
+        assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
+        assertThat(thirdStep.getNextStepKey(), equalTo(fourthStep));
+        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexGreenStep.NAME)));
+        assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
+        assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
+        assertThat(fifthStep.getNextStepKey(), equalTo(nextStepKey));
+    }
+
+    public void testMissingMaxNumSegments() throws IOException {
+        BytesReference emptyObject = BytesReference.bytes(JsonXContent.contentBuilder().startObject().endObject());
+        XContentParser parser = XContentHelper.createParser(null, DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
+            emptyObject, XContentType.JSON);
+        Exception e = expectThrows(IllegalArgumentException.class, () -> ForceMergeAction.parse(parser));
+        assertThat(e.getMessage(), equalTo("Required [max_num_segments, best_compression]"));
+    }
+
+    public void testInvalidNegativeSegmentNumber() {
+        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0), false));
+        assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
+    }
+
+    public void testToSteps() {
+        ForceMergeAction instance = createTestInstance();
+        if (instance.isBestCompression()) {
+            assertBestCompression(instance);
+        }
+        else {
+            assertNonBestCompression(instance);
+        }
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
new file mode 100644
index 0000000000000..164d5f7fe4c3c
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
@@ -0,0 +1,158 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+
+package org.elasticsearch.xpack.core.ilm;
+
+import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
+import org.elasticsearch.action.admin.indices.open.OpenIndexResponse;
+import org.elasticsearch.client.AdminClient;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.client.IndicesAdminClient;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.junit.Before;
+import org.mockito.Mockito;
+import org.mockito.stubbing.Answer;
+
+import static org.hamcrest.Matchers.equalTo;
+
+/**
+ * Created by sivagurunathanvelayutham on Dec, 2019
+ */
+public class OpenIndexStepTest extends AbstractStepTestCase<OpenIndexStep> {
+
+    private Client client;
+
+    @Before
+    public void setup() {
+        client = Mockito.mock(Client.class);
+    }
+
+    @Override
+    protected OpenIndexStep createRandomInstance() {
+        return new OpenIndexStep(randomStepKey(), randomStepKey(), client);
+    }
+
+    @Override
+    protected OpenIndexStep mutateInstance(OpenIndexStep instance) {
+        Step.StepKey key = instance.getKey();
+        Step.StepKey nextKey = instance.getNextStepKey();
+
+        switch (between(0, 1)) {
+            case 0:
+                key = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 1:
+                nextKey = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+
+        return new OpenIndexStep(key, nextKey, client);
+    }
+
+    @Override
+    protected OpenIndexStep copyInstance(OpenIndexStep instance) {
+        return new OpenIndexStep(instance.getKey(), instance.getNextStepKey(), instance.getClient());
+    }
+
+    public void testPerformAction() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10)).settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5))
+            .numberOfReplicas(randomIntBetween(0, 5))
+            .state(IndexMetaData.State.CLOSE)
+            .build();
+
+        OpenIndexStep step = createRandomInstance();
+
+        AdminClient adminClient = Mockito.mock(AdminClient.class);
+        IndicesAdminClient indicesClient = Mockito.mock(IndicesAdminClient.class);
+
+        Mockito.when(client.admin()).thenReturn(adminClient);
+        Mockito.when(adminClient.indices()).thenReturn(indicesClient);
+
+        Mockito.doAnswer((Answer<Void>) invocation -> {
+            OpenIndexRequest request = (OpenIndexRequest) invocation.getArguments()[0];
+            @SuppressWarnings("unchecked")
+            ActionListener<OpenIndexResponse> listener = (ActionListener<OpenIndexResponse>) invocation.getArguments()[1];
+            assertThat(request.indices(), equalTo(new String[]{indexMetaData.getIndex().getName()}));
+            listener.onResponse(new OpenIndexResponse(true, true));
+            return null;
+        }).when(indicesClient).open(Mockito.any(), Mockito.any());
+
+        SetOnce<Boolean> actionCompleted = new SetOnce<>();
+
+        step.performAction(indexMetaData, null, null, new AsyncActionStep.Listener() {
+
+            @Override
+            public void onResponse(boolean complete) {
+                actionCompleted.set(complete);
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                throw new AssertionError("Unexpected method call", e);
+            }
+        });
+
+        assertEquals(true, actionCompleted.get());
+        Mockito.verify(client, Mockito.only()).admin();
+        Mockito.verify(adminClient, Mockito.only()).indices();
+        Mockito.verify(indicesClient, Mockito.only()).open(Mockito.any(), Mockito.any());
+    }
+
+
+    public void testPerformActionFailure() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10)).settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5))
+            .numberOfReplicas(randomIntBetween(0, 5))
+            .state(IndexMetaData.State.CLOSE)
+            .build();
+
+        OpenIndexStep step = createRandomInstance();
+        Exception exception = new RuntimeException();
+        AdminClient adminClient = Mockito.mock(AdminClient.class);
+        IndicesAdminClient indicesClient = Mockito.mock(IndicesAdminClient.class);
+
+        Mockito.when(client.admin()).thenReturn(adminClient);
+        Mockito.when(adminClient.indices()).thenReturn(indicesClient);
+
+        Mockito.doAnswer((Answer<Void>) invocation -> {
+            OpenIndexRequest request = (OpenIndexRequest) invocation.getArguments()[0];
+            @SuppressWarnings("unchecked")
+            ActionListener<OpenIndexResponse> listener = (ActionListener<OpenIndexResponse>) invocation.getArguments()[1];
+            assertThat(request.indices(), equalTo(new String[]{indexMetaData.getIndex().getName()}));
+            listener.onFailure(exception);
+            return null;
+        }).when(indicesClient).open(Mockito.any(), Mockito.any());
+
+        SetOnce<Boolean> exceptionThrown = new SetOnce<>();
+
+        step.performAction(indexMetaData, null, null, new AsyncActionStep.Listener() {
+
+            @Override
+            public void onResponse(boolean complete) {
+                throw new AssertionError("Unexpected method call");
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                assertSame(exception, e);
+                exceptionThrown.set(true);
+            }
+        });
+
+        assertEquals(true, exceptionThrown.get());
+        Mockito.verify(client, Mockito.only()).admin();
+        Mockito.verify(adminClient, Mockito.only()).indices();
+        Mockito.verify(indicesClient, Mockito.only()).open(Mockito.any(), Mockito.any());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index a76a22fcc7821..49bc71c55971f 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -34,7 +34,7 @@ public class TimeseriesLifecycleTypeTests extends ESTestCase {
     private static final AllocateAction TEST_ALLOCATE_ACTION =
         new AllocateAction(2, Collections.singletonMap("node", "node1"),null, null);
     private static final DeleteAction TEST_DELETE_ACTION = new DeleteAction();
-    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1);
+    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, false);
     private static final RolloverAction TEST_ROLLOVER_ACTION = new RolloverAction(new ByteSizeValue(1), null, null);
     private static final ShrinkAction TEST_SHRINK_ACTION = new ShrinkAction(1);
     private static final ReadOnlyAction TEST_READ_ONLY_ACTION = new ReadOnlyAction();
@@ -492,7 +492,7 @@ private ConcurrentMap<String, LifecycleAction> convertActionNamesToActions(Strin
             case DeleteAction.NAME:
                 return new DeleteAction();
             case ForceMergeAction.NAME:
-                return new ForceMergeAction(1);
+                return new ForceMergeAction(1, false);
             case ReadOnlyAction.NAME:
                 return new ReadOnlyAction();
             case RolloverAction.NAME:
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
new file mode 100644
index 0000000000000..ec4f73c2ec592
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
@@ -0,0 +1,155 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.Version;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.routing.IndexRoutingTable;
+import org.elasticsearch.cluster.routing.RoutingTable;
+import org.elasticsearch.cluster.routing.ShardRouting;
+import org.elasticsearch.cluster.routing.ShardRoutingState;
+import org.elasticsearch.cluster.routing.TestShardRouting;
+import org.elasticsearch.xpack.core.ilm.Step.StepKey;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.nullValue;
+import static org.hamcrest.core.IsNull.notNullValue;
+
+public class WaitForIndexGreenStepTest extends AbstractStepTestCase<WaitForIndexGreenStep> {
+
+    @Override
+    protected WaitForIndexGreenStep createRandomInstance() {
+        StepKey stepKey = randomStepKey();
+        StepKey nextStepKey = randomStepKey();
+        return new WaitForIndexGreenStep(stepKey, nextStepKey);
+    }
+
+    @Override
+    protected WaitForIndexGreenStep mutateInstance(WaitForIndexGreenStep instance) {
+        StepKey key = instance.getKey();
+        StepKey nextKey = instance.getNextStepKey();
+
+        if (randomBoolean()) {
+            key = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+        } else {
+            nextKey = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+        }
+
+        return new WaitForIndexGreenStep(key, nextKey);
+    }
+
+    @Override
+    protected WaitForIndexGreenStep copyInstance(WaitForIndexGreenStep instance) {
+        return new WaitForIndexGreenStep(instance.getKey(), instance.getNextStepKey());
+    }
+
+    public void testConditionMet() {
+        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(2)
+            .build();
+
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("test_index", 0, "1", true, ShardRoutingState.STARTED);
+        IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
+            .addShard(shardRouting).build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
+            .build();
+
+        WaitForIndexGreenStep step = createRandomInstance();
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(true));
+        assertThat(result.getInfomationContext(), nullValue());
+    }
+
+    public void testConditionNotMet() {
+        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .build();
+
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("test_index", 0, "1", true, ShardRoutingState.INITIALIZING);
+        IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
+            .addShard(shardRouting).build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
+            .build();
+
+        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(false));
+        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        assertThat(info, notNullValue());
+        assertThat(info.getMessage(), equalTo("index is not green; not all shards are active"));
+    }
+
+    public void testConditionNotMetWithYellow() {
+        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(2)
+            .build();
+
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("test_index", 0, "1", true, ShardRoutingState.STARTED);
+
+        ShardRouting replicaShardRouting =
+            TestShardRouting.newShardRouting("test_index", 0, "2", false, ShardRoutingState.INITIALIZING);
+
+        IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
+            .addShard(shardRouting)
+            .addShard(replicaShardRouting)
+            .build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
+            .build();
+
+        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(false));
+        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        assertThat(info, notNullValue());
+        assertThat(info.getMessage(), equalTo("index is yellow; not all replica shards are active"));
+    }
+
+    public void testConditionNotMetNoIndexRoutingTable() {
+        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().build())
+            .build();
+
+        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(false));
+        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        assertThat(info, notNullValue());
+        assertThat(info.getMessage(), equalTo("index is red; no IndexRoutingTable"));
+    }
+}
+

From 7462a58a76eba1fa41c1fbb760b7071013e14168 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 8 Dec 2019 16:27:19 -0800
Subject: [PATCH 008/686] Checkstyle and License

---
 .../xpack/core/ilm/CloseIndexStep.java        | 24 ++++++++++++++-----
 .../xpack/core/ilm/OpenIndexStep.java         | 21 ++++++++++++----
 .../xpack/core/ilm/WaitForIndexGreenStep.java | 24 ++++++++++++-------
 .../xpack/core/ilm/CloseIndexStepTest.java    | 21 ++++++++++++----
 .../xpack/core/ilm/OpenIndexStepTest.java     | 21 ++++++++++++----
 .../core/ilm/WaitForIndexGreenStepTest.java   | 21 ++++++++++++----
 6 files changed, 98 insertions(+), 34 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index 8f78ce75653e5..1bac9ea91813b 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
@@ -27,7 +38,8 @@ public class CloseIndexStep extends AsyncActionStep {
     }
 
     @Override
-    public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState, ClusterStateObserver observer, Listener listener) {
+    public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState,
+                              ClusterStateObserver observer, Listener listener) {
         if(indexMetaData.getState() == IndexMetaData.State.OPEN) {
             CloseIndexRequest request = new CloseIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index 793db17eb8376..fc9cf75284411 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 package org.elasticsearch.xpack.core.ilm;
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
index f001644da2022..fc602a1a250f7 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
@@ -1,13 +1,23 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 package org.elasticsearch.xpack.core.ilm;
 
-import com.carrotsearch.hppc.cursors.IntObjectCursor;
 import com.carrotsearch.hppc.cursors.ObjectCursor;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.routing.IndexRoutingTable;
@@ -20,9 +30,7 @@
 import org.elasticsearch.index.Index;
 
 import java.io.IOException;
-import java.util.List;
 import java.util.Objects;
-import java.util.stream.Stream;
 
 class WaitForIndexGreenStep extends ClusterStateWaitStep {
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
index 7d7a64edc6336..409180e2118d2 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
index 164d5f7fe4c3c..95d7da6457ce8 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
index ec4f73c2ec592..87c1f19a56e4f 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 
 package org.elasticsearch.xpack.core.ilm;

From 553451325160ba99309fd97f78ef5596a6424a81 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 8 Dec 2019 16:36:06 -0800
Subject: [PATCH 009/686] Removing Comments from file

---
 .../java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java  | 3 ---
 .../org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java   | 3 ---
 .../org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java    | 3 ---
 3 files changed, 9 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index 1bac9ea91813b..53f7e469c3bbe 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -27,9 +27,6 @@
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.xpack.core.ilm.AsyncActionStep;
 
-/**
- * Invokes a Close Index Step on a index.
- */
 public class CloseIndexStep extends AsyncActionStep {
     public static final String NAME = "close-index";
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
index 409180e2118d2..53b2c47d00b69 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
@@ -36,9 +36,6 @@
 
 import static org.hamcrest.Matchers.equalTo;
 
-/**
- * Created by sivagurunathanvelayutham on Dec, 2019
- */
 public class CloseIndexStepTest extends AbstractStepTestCase<CloseIndexStep> {
 
     private Client client;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
index 95d7da6457ce8..558e4ac824a11 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
@@ -34,9 +34,6 @@
 
 import static org.hamcrest.Matchers.equalTo;
 
-/**
- * Created by sivagurunathanvelayutham on Dec, 2019
- */
 public class OpenIndexStepTest extends AbstractStepTestCase<OpenIndexStep> {
 
     private Client client;

From 25e2395eef511287e093c183a3a7540d602df2f9 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Mon, 9 Dec 2019 18:47:27 -0800
Subject: [PATCH 010/686] Added license and renamed files for tests

---
 .../xpack/core/ilm/CloseIndexStep.java        | 19 +++--------------
 .../xpack/core/ilm/OpenIndexStep.java         | 20 ++++--------------
 .../xpack/core/ilm/WaitForIndexGreenStep.java | 20 ++++--------------
 ...StepTest.java => CloseIndexStepTests.java} | 21 ++++---------------
 ...xStepTest.java => OpenIndexStepTests.java} | 21 ++++---------------
 ...t.java => WaitForIndexGreenStepTests.java} | 21 ++++---------------
 .../ilm/TimeSeriesLifecycleActionsIT.java     |  4 ++--
 7 files changed, 25 insertions(+), 101 deletions(-)
 rename x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/{CloseIndexStepTest.java => CloseIndexStepTests.java} (87%)
 rename x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/{OpenIndexStepTest.java => OpenIndexStepTests.java} (87%)
 rename x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/{WaitForIndexGreenStepTest.java => WaitForIndexGreenStepTests.java} (88%)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index 53f7e469c3bbe..f0afab5f604ee 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -1,20 +1,7 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index fc9cf75284411..b032b0761fa44 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -1,21 +1,9 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
+
 package org.elasticsearch.xpack.core.ilm;
 
 import org.elasticsearch.action.ActionListener;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
index fc602a1a250f7..d717a970c66b1 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
@@ -1,21 +1,9 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
+
 package org.elasticsearch.xpack.core.ilm;
 
 import com.carrotsearch.hppc.cursors.ObjectCursor;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTests.java
similarity index 87%
rename from x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
rename to x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTests.java
index 53b2c47d00b69..b0980b284eb73 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTests.java
@@ -1,20 +1,7 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
@@ -36,7 +23,7 @@
 
 import static org.hamcrest.Matchers.equalTo;
 
-public class CloseIndexStepTest extends AbstractStepTestCase<CloseIndexStep> {
+public class CloseIndexStepTests extends AbstractStepTestCase<CloseIndexStep> {
 
     private Client client;
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTests.java
similarity index 87%
rename from x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
rename to x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTests.java
index 558e4ac824a11..812d90dd5c259 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTests.java
@@ -1,20 +1,7 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
@@ -34,7 +21,7 @@
 
 import static org.hamcrest.Matchers.equalTo;
 
-public class OpenIndexStepTest extends AbstractStepTestCase<OpenIndexStep> {
+public class OpenIndexStepTests extends AbstractStepTestCase<OpenIndexStep> {
 
     private Client client;
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
similarity index 88%
rename from x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
rename to x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
index 87c1f19a56e4f..46fba4bcf1770 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
@@ -1,20 +1,7 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
@@ -36,7 +23,7 @@
 import static org.hamcrest.Matchers.nullValue;
 import static org.hamcrest.core.IsNull.notNullValue;
 
-public class WaitForIndexGreenStepTest extends AbstractStepTestCase<WaitForIndexGreenStep> {
+public class WaitForIndexGreenStepTests extends AbstractStepTestCase<WaitForIndexGreenStep> {
 
     @Override
     protected WaitForIndexGreenStep createRandomInstance() {
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 4e160c69efd13..2ee3de617c432 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -411,7 +411,7 @@ public void testForceMergeAction() throws Exception {
         };
         assertThat(numSegments.get(), greaterThan(1));
 
-        createNewSingletonPolicy("warm", new ForceMergeAction(1));
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, false));
         updatePolicy(index, policy);
 
         assertBusy(() -> {
@@ -1007,7 +1007,7 @@ private void createFullPolicy(TimeValue hotTime) throws IOException {
         hotActions.put(RolloverAction.NAME,  new RolloverAction(null, null, 1L));
         Map<String, LifecycleAction> warmActions = new HashMap<>();
         warmActions.put(SetPriorityAction.NAME, new SetPriorityAction(50));
-        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1));
+        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, false));
         warmActions.put(AllocateAction.NAME, new AllocateAction(1, singletonMap("_name", "integTest-1,integTest-2"), null, null));
         warmActions.put(ShrinkAction.NAME, new ShrinkAction(1));
         Map<String, LifecycleAction> coldActions = new HashMap<>();

From 5d0fc47fc6cff9c78c0c867be124c7b1651d3025 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Mon, 16 Dec 2019 20:05:14 -0800
Subject: [PATCH 011/686] Modifying WaitForIndexGreen to WaitForIndexColor
 class

---
 .../xpack/core/ilm/CloseIndexStep.java        |  12 +-
 .../xpack/core/ilm/ForceMergeAction.java      |  49 +++++---
 .../xpack/core/ilm/OpenIndexStep.java         |   9 +-
 ...enStep.java => WaitForIndexColorStep.java} |  74 ++++++++++-
 .../xpack/core/ilm/ForceMergeActionTests.java |  28 +++--
 .../ilm/TimeseriesLifecycleTypeTests.java     |   5 +-
 ...s.java => WaitForIndexColorStepTests.java} | 115 +++++++++++++-----
 7 files changed, 217 insertions(+), 75 deletions(-)
 rename x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/{WaitForIndexGreenStep.java => WaitForIndexColorStep.java} (56%)
 rename x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/{WaitForIndexGreenStepTests.java => WaitForIndexColorStepTests.java} (51%)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index f0afab5f604ee..994ddf2590b58 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -12,7 +12,10 @@
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.ClusterStateObserver;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.xpack.core.ilm.AsyncActionStep;
+
+/**
+ * Invokes a close step on a single index.
+ */
 
 public class CloseIndexStep extends AsyncActionStep {
     public static final String NAME = "close-index";
@@ -24,10 +27,13 @@ public class CloseIndexStep extends AsyncActionStep {
     @Override
     public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState,
                               ClusterStateObserver observer, Listener listener) {
-        if(indexMetaData.getState() == IndexMetaData.State.OPEN) {
+        if (indexMetaData.getState() == IndexMetaData.State.OPEN) {
             CloseIndexRequest request = new CloseIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
-                .close(request, ActionListener.wrap(closeIndexResponse -> listener.onResponse(true), listener::onFailure));
+                .close(request, ActionListener.wrap(closeIndexResponse -> {
+                    assert closeIndexResponse.isAcknowledged() : "close index response is not acknowledged";
+                    listener.onResponse(true);
+                }, listener::onFailure));
         }
         else {
             listener.onResponse(true);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 5d4227a766f58..636f7a83e28c8 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -5,7 +5,10 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
+import org.apache.lucene.codecs.Codec;
+import org.elasticsearch.Version;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
@@ -30,53 +33,61 @@
 public class ForceMergeAction implements LifecycleAction {
     public static final String NAME = "forcemerge";
     public static final ParseField MAX_NUM_SEGMENTS_FIELD = new ParseField("max_num_segments");
-    public static final ParseField BEST_COMPRESSION_FIELD = new ParseField("best_compression");
+    public static final ParseField CODEC = new ParseField("index.codec");
 
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        boolean bestCompression = a[1] != null && (boolean) a[1];
-        return new ForceMergeAction(maxNumSegments, bestCompression);
+        Codec codec = a[1] != null ? Codec.forName((String)a[1]): Codec.getDefault();
+        return new ForceMergeAction(maxNumSegments, codec);
     });
 
     static {
         PARSER.declareInt(ConstructingObjectParser.constructorArg(), MAX_NUM_SEGMENTS_FIELD);
-        PARSER.declareBoolean(ConstructingObjectParser.constructorArg(), BEST_COMPRESSION_FIELD);
+        PARSER.declareInt(ConstructingObjectParser.constructorArg(), CODEC);
     }
 
     private final int maxNumSegments;
-    private final boolean bestCompression;
+    private final Codec codec;
 
     public static ForceMergeAction parse(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    public ForceMergeAction(int maxNumSegments, boolean bestCompression) {
+    public ForceMergeAction(int maxNumSegments, Codec codec) {
         if (maxNumSegments <= 0) {
             throw new IllegalArgumentException("[" + MAX_NUM_SEGMENTS_FIELD.getPreferredName()
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
-        this.bestCompression = bestCompression;
+        this.codec = codec;
     }
 
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
-        this.bestCompression = in.readBoolean();
+        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            this.codec = Codec.forName(in.readString());
+        } else {
+          this.codec = Codec.getDefault();
+        }
     }
 
     public int getMaxNumSegments() {
         return maxNumSegments;
     }
 
-    public boolean isBestCompression() {
-        return bestCompression;
+    public Codec getCodec() {
+        return this.codec;
     }
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
-        out.writeBoolean(bestCompression);
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            out.writeString(codec.getName());
+        } else {
+            out.writeString(Codec.getDefault().getName());
+        }
     }
 
     @Override
@@ -93,7 +104,7 @@ public boolean isSafeAction() {
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
         builder.field(MAX_NUM_SEGMENTS_FIELD.getPreferredName(), maxNumSegments);
-        builder.field(BEST_COMPRESSION_FIELD.getPreferredName(), bestCompression);
+        builder.field(CODEC.getPreferredName(), codec);
         builder.endObject();
         return builder;
     }
@@ -101,25 +112,25 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     @Override
     public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey) {
         Settings readOnlySettings = Settings.builder().put(IndexMetaData.SETTING_BLOCKS_WRITE, true).build();
+        Settings bestCompressionSettings = Settings.builder()
+            .put(EngineConfig.INDEX_CODEC_SETTING.getKey(), CodecService.BEST_COMPRESSION_CODEC).build();
 
         StepKey readOnlyKey = new StepKey(phase, NAME, ReadOnlyAction.NAME);
         StepKey forceMergeKey = new StepKey(phase, NAME, ForceMergeStep.NAME);
         StepKey countKey = new StepKey(phase, NAME, SegmentCountStep.NAME);
 
 
-        if (this.bestCompression) {
+        if (codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
             StepKey closeKey = new StepKey(phase, NAME, CloseIndexStep.NAME);
             StepKey openKey = new StepKey(phase, NAME, OpenIndexStep.NAME);
-            StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexGreenStep.NAME);
+            StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
             StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
-            Settings bestCompressionSettings = Settings.builder()
-                .put(EngineConfig.INDEX_CODEC_SETTING.getKey(), CodecService.BEST_COMPRESSION_CODEC).build();
 
             CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
             UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
                 openKey, client, bestCompressionSettings);
             OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
-            WaitForIndexGreenStep waitForIndexGreenStep = new WaitForIndexGreenStep(waitForGreenIndexKey, forceMergeKey);
+            WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey, forceMergeKey, ClusterHealthStatus.GREEN);
             ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, nextStepKey, client, maxNumSegments);
             return Arrays.asList(closeIndexStep, updateBestCompressionSettings,
                 openIndexStep, waitForIndexGreenStep, forceMergeStep);
@@ -133,7 +144,7 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
 
     @Override
     public int hashCode() {
-        return Objects.hash(maxNumSegments, bestCompression);
+        return Objects.hash(maxNumSegments, codec);
     }
 
     @Override
@@ -146,7 +157,7 @@ public boolean equals(Object obj) {
         }
         ForceMergeAction other = (ForceMergeAction) obj;
         return Objects.equals(maxNumSegments, other.maxNumSegments)
-            && Objects.equals(bestCompression, other.bestCompression);
+            && Objects.equals(codec, other.codec);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index b032b0761fa44..907750e212332 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -13,6 +13,10 @@
 import org.elasticsearch.cluster.ClusterStateObserver;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 
+/**
+ * Invokes a open step on a single index.
+ */
+
 final class OpenIndexStep extends AsyncActionStep {
 
     static final String NAME = "open-index";
@@ -28,7 +32,10 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             OpenIndexRequest request = new OpenIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
                 .open(request,
-                    ActionListener.wrap(closeIndexResponse -> listener.onResponse(true), listener::onFailure));
+                    ActionListener.wrap(openIndexResponse-> {
+                        assert openIndexResponse.isAcknowledged() : "open Index response is not acknowledged";
+                        listener.onResponse(true);
+                    }, listener::onFailure));
 
         } else {
             listener.onResponse(true);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
similarity index 56%
rename from x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
rename to x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
index d717a970c66b1..812ad66323668 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
@@ -8,6 +8,7 @@
 
 import com.carrotsearch.hppc.cursors.ObjectCursor;
 import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.routing.IndexRoutingTable;
 import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
 import org.elasticsearch.cluster.routing.RoutingTable;
@@ -20,28 +21,91 @@
 import java.io.IOException;
 import java.util.Objects;
 
-class WaitForIndexGreenStep extends ClusterStateWaitStep {
+/**
+ * Wait Step for index based on color
+ * */
 
-    static final String NAME = "wait-for-index-green-step";
+class WaitForIndexColorStep extends ClusterStateWaitStep {
 
-    WaitForIndexGreenStep(StepKey key, StepKey nextStepKey) {
+    static final String NAME = "wait-for-index-color-step";
+
+    private final ClusterHealthStatus color;
+
+    WaitForIndexColorStep(StepKey key, StepKey nextStepKey, ClusterHealthStatus color) {
         super(key, nextStepKey);
+        this.color = color;
+    }
+
+    public ClusterHealthStatus getColor() {
+        return this.color;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(super.hashCode(), this.color);
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (obj == null) return false;
+        if (!(obj instanceof WaitForIndexColorStep)) return false;
+        WaitForIndexColorStep other = (WaitForIndexColorStep) obj;
+        return super.equals(obj) && Objects.equals(this.color, other.color);
     }
 
     @Override
     public Result isConditionMet(Index index, ClusterState clusterState) {
         RoutingTable routingTable = clusterState.routingTable();
         IndexRoutingTable indexRoutingTable = routingTable.index(index);
+        Result result;
+        switch (this.color) {
+            case GREEN:
+                result = waitForGreen(indexRoutingTable);
+                break;
+            case YELLOW:
+                result = waitForYellow(indexRoutingTable);
+                break;
+            case RED:
+                result = waitForRed(indexRoutingTable);
+                break;
+            default:
+                result = new Result(false, new Info("No index color match"));
+                break;
+        }
+        return result;
+    }
+
+    private Result waitForRed(IndexRoutingTable indexRoutingTable) {
+        if (indexRoutingTable == null) {
+            return new Result(true, new Info("Index is red"));
+        }
+        return new Result(false, new Info("Index is not red"));
+    }
+
+    private Result waitForYellow(IndexRoutingTable indexRoutingTable) {
+        if (indexRoutingTable == null) {
+            return new Result(false, new Info("index is red; no IndexRoutingTable"));
+        }
+
+        boolean indexIsAtLeastYellow = indexRoutingTable.allPrimaryShardsActive();
+        if (indexIsAtLeastYellow) {
+            return new Result(true, null);
+        } else {
+            return new Result(false, new Info("index is red; not all primary shards are active"));
+        }
+    }
+
+    private Result waitForGreen(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
             return new Result(false, new Info("index is red; no IndexRoutingTable"));
         }
 
         boolean indexIsGreen = false;
-        if(indexRoutingTable.allPrimaryShardsActive()) {
+        if (indexRoutingTable.allPrimaryShardsActive()) {
             boolean replicaIndexIsGreen = false;
             for (ObjectCursor<IndexShardRoutingTable> shardRouting : indexRoutingTable.getShards().values()) {
                 replicaIndexIsGreen = shardRouting.value.replicaShards().stream().allMatch(ShardRouting::active);
-                if(!replicaIndexIsGreen) {
+                if (!replicaIndexIsGreen) {
                     return new Result(false, new Info("index is yellow; not all replica shards are active"));
                 }
             }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index c12f6e7459bd2..4f899f3b74355 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
+import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
@@ -35,20 +36,21 @@ protected ForceMergeAction createTestInstance() {
     }
 
     static ForceMergeAction randomInstance() {
-        return new ForceMergeAction(randomIntBetween(1, 100), randomBoolean());
+        return new ForceMergeAction(randomIntBetween(1, 100), createRandomCompressionSettings());
+    }
+
+    static Codec createRandomCompressionSettings() {
+        if(randomBoolean()) {
+            return Codec.getDefault();
+        }
+        return Codec.forName(CodecService.BEST_COMPRESSION_CODEC);
     }
 
     @Override
     protected ForceMergeAction mutateInstance(ForceMergeAction instance) {
         int maxNumSegments = instance.getMaxNumSegments();
-        boolean bestCompression = instance.isBestCompression();
-        if(randomBoolean()) {
-            maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
-        }
-        else {
-            bestCompression = !bestCompression;
-        }
-        return new ForceMergeAction(maxNumSegments, bestCompression);
+        maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
+        return new ForceMergeAction(maxNumSegments, Codec.getDefault());
     }
 
     @Override
@@ -83,7 +85,7 @@ private void assertBestCompression(ForceMergeAction instance) {
         CloseIndexStep firstStep = (CloseIndexStep) steps.get(0);
         UpdateSettingsStep secondStep = (UpdateSettingsStep) steps.get(1);
         OpenIndexStep thirdStep = (OpenIndexStep) steps.get(2);
-        WaitForIndexGreenStep fourthStep = (WaitForIndexGreenStep) steps.get(3);
+        WaitForIndexColorStep fourthStep = (WaitForIndexColorStep) steps.get(3);
         ForceMergeStep fifthStep = (ForceMergeStep) steps.get(4);
         assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
         assertThat(firstStep.getNextStepKey(), equalTo(secondStep.getKey()));
@@ -92,7 +94,7 @@ private void assertBestCompression(ForceMergeAction instance) {
         assertThat(secondStep.getNextStepKey(), equalTo(thirdStep.getKey()));
         assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
         assertThat(thirdStep.getNextStepKey(), equalTo(fourthStep));
-        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexGreenStep.NAME)));
+        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexColorStep.NAME)));
         assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
         assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
         assertThat(fifthStep.getNextStepKey(), equalTo(nextStepKey));
@@ -107,13 +109,13 @@ public void testMissingMaxNumSegments() throws IOException {
     }
 
     public void testInvalidNegativeSegmentNumber() {
-        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0), false));
+        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0), Codec.getDefault()));
         assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
     }
 
     public void testToSteps() {
         ForceMergeAction instance = createTestInstance();
-        if (instance.isBestCompression()) {
+        if (CodecService.BEST_COMPRESSION_CODEC.equals(instance.getCodec().getName())) {
             assertBestCompression(instance);
         }
         else {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index 49bc71c55971f..1469e40e6682d 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
+import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.test.ESTestCase;
@@ -34,7 +35,7 @@ public class TimeseriesLifecycleTypeTests extends ESTestCase {
     private static final AllocateAction TEST_ALLOCATE_ACTION =
         new AllocateAction(2, Collections.singletonMap("node", "node1"),null, null);
     private static final DeleteAction TEST_DELETE_ACTION = new DeleteAction();
-    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, false);
+    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, Codec.getDefault());
     private static final RolloverAction TEST_ROLLOVER_ACTION = new RolloverAction(new ByteSizeValue(1), null, null);
     private static final ShrinkAction TEST_SHRINK_ACTION = new ShrinkAction(1);
     private static final ReadOnlyAction TEST_READ_ONLY_ACTION = new ReadOnlyAction();
@@ -492,7 +493,7 @@ private ConcurrentMap<String, LifecycleAction> convertActionNamesToActions(Strin
             case DeleteAction.NAME:
                 return new DeleteAction();
             case ForceMergeAction.NAME:
-                return new ForceMergeAction(1, false);
+                return new ForceMergeAction(1, Codec.getDefault());
             case ReadOnlyAction.NAME:
                 return new ReadOnlyAction();
             case RolloverAction.NAME:
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
similarity index 51%
rename from x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
rename to x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
index 46fba4bcf1770..0baa5a830df82 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.routing.IndexRoutingTable;
@@ -23,35 +24,48 @@
 import static org.hamcrest.Matchers.nullValue;
 import static org.hamcrest.core.IsNull.notNullValue;
 
-public class WaitForIndexGreenStepTests extends AbstractStepTestCase<WaitForIndexGreenStep> {
+public class WaitForIndexColorStepTests extends AbstractStepTestCase<WaitForIndexColorStep> {
+
+    private static ClusterHealthStatus randomColor() {
+        String[] colors = new String[]{"green", "yellow", "red"};
+        int randomColor = randomIntBetween(0, colors.length - 1);
+        return ClusterHealthStatus.fromString(colors[randomColor]);
+    }
 
     @Override
-    protected WaitForIndexGreenStep createRandomInstance() {
+    protected WaitForIndexColorStep createRandomInstance() {
         StepKey stepKey = randomStepKey();
         StepKey nextStepKey = randomStepKey();
-        return new WaitForIndexGreenStep(stepKey, nextStepKey);
+        ClusterHealthStatus color = randomColor();
+        return new WaitForIndexColorStep(stepKey, nextStepKey, color);
     }
 
     @Override
-    protected WaitForIndexGreenStep mutateInstance(WaitForIndexGreenStep instance) {
+    protected WaitForIndexColorStep mutateInstance(WaitForIndexColorStep instance) {
         StepKey key = instance.getKey();
         StepKey nextKey = instance.getNextStepKey();
-
-        if (randomBoolean()) {
-            key = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
-        } else {
-            nextKey = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+        ClusterHealthStatus color = instance.getColor();
+
+        switch (between(0, 2)) {
+            case 0:
+                key = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 1:
+                nextKey = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 2:
+                color = randomColor();
         }
 
-        return new WaitForIndexGreenStep(key, nextKey);
+        return new WaitForIndexColorStep(key, nextKey, color);
     }
 
     @Override
-    protected WaitForIndexGreenStep copyInstance(WaitForIndexGreenStep instance) {
-        return new WaitForIndexGreenStep(instance.getKey(), instance.getNextStepKey());
+    protected WaitForIndexColorStep copyInstance(WaitForIndexColorStep instance) {
+        return new WaitForIndexColorStep(instance.getKey(), instance.getNextStepKey(), instance.getColor());
     }
 
-    public void testConditionMet() {
+    public void testConditionMetForGreen() {
         IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
             .settings(settings(Version.CURRENT))
             .numberOfShards(1)
@@ -68,13 +82,13 @@ public void testConditionMet() {
             .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
             .build();
 
-        WaitForIndexGreenStep step = createRandomInstance();
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.GREEN);
         ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
         assertThat(result.isComplete(), is(true));
         assertThat(result.getInfomationContext(), nullValue());
     }
 
-    public void testConditionNotMet() {
+    public void testConditionNotMetForGreen() {
         IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
             .settings(settings(Version.CURRENT))
             .numberOfShards(1)
@@ -91,47 +105,84 @@ public void testConditionNotMet() {
             .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
             .build();
 
-        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.GREEN);
         ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
         assertThat(result.isComplete(), is(false));
-        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
         assertThat(info, notNullValue());
         assertThat(info.getMessage(), equalTo("index is not green; not all shards are active"));
     }
 
-    public void testConditionNotMetWithYellow() {
+    public void testConditionNotMetNoIndexRoutingTable() {
         IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
             .settings(settings(Version.CURRENT))
             .numberOfShards(1)
-            .numberOfReplicas(2)
+            .numberOfReplicas(0)
             .build();
 
-        ShardRouting shardRouting =
-            TestShardRouting.newShardRouting("test_index", 0, "1", true, ShardRoutingState.STARTED);
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().build())
+            .build();
 
-        ShardRouting replicaShardRouting =
-            TestShardRouting.newShardRouting("test_index", 0, "2", false, ShardRoutingState.INITIALIZING);
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.YELLOW);
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(false));
+        WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
+        assertThat(info, notNullValue());
+        assertThat(info.getMessage(), equalTo("index is red; no IndexRoutingTable"));
+    }
+
+    public void testConditionMetForYellow() {
+        IndexMetaData indexMetadata = IndexMetaData.builder("former-follower-index")
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .build();
 
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("index2", 0, "1", true, ShardRoutingState.STARTED);
         IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
-            .addShard(shardRouting)
-            .addShard(replicaShardRouting)
+            .addShard(shardRouting).build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
+            .build();
+
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.YELLOW);
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(true));
+        assertThat(result.getInfomationContext(), nullValue());
+    }
+
+    public void testConditionNotMetForYellow() {
+        IndexMetaData indexMetadata = IndexMetaData.builder("former-follower-index")
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
             .build();
 
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("index2", 0, "1", true, ShardRoutingState.INITIALIZING);
+        IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
+            .addShard(shardRouting).build();
+
         ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
             .metaData(MetaData.builder().put(indexMetadata, true).build())
             .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
             .build();
 
-        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.YELLOW);
         ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
         assertThat(result.isComplete(), is(false));
-        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
         assertThat(info, notNullValue());
-        assertThat(info.getMessage(), equalTo("index is yellow; not all replica shards are active"));
+        assertThat(info.getMessage(), equalTo("index is red; not all primary shards are active"));
     }
 
-    public void testConditionNotMetNoIndexRoutingTable() {
-        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+    public void testConditionNotMetNoIndexRoutingTableForYellow() {
+        IndexMetaData indexMetadata = IndexMetaData.builder("former-follower-index")
             .settings(settings(Version.CURRENT))
             .numberOfShards(1)
             .numberOfReplicas(0)
@@ -142,10 +193,10 @@ public void testConditionNotMetNoIndexRoutingTable() {
             .routingTable(RoutingTable.builder().build())
             .build();
 
-        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.YELLOW);
         ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
         assertThat(result.isComplete(), is(false));
-        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
         assertThat(info, notNullValue());
         assertThat(info.getMessage(), equalTo("index is red; no IndexRoutingTable"));
     }

From 69a633edeb46e97b21c4338ccf2f49d549f7ab52 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Mon, 16 Dec 2019 20:34:58 -0800
Subject: [PATCH 012/686] Precommit check changes

---
 .../org/elasticsearch/xpack/core/ilm/ForceMergeAction.java | 7 ++++---
 .../xpack/core/ilm/ForceMergeActionTests.java              | 3 ++-
 .../xpack/ilm/TimeSeriesLifecycleActionsIT.java            | 5 +++--
 3 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 636f7a83e28c8..ef49d537684a8 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -38,7 +38,7 @@ public class ForceMergeAction implements LifecycleAction {
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        Codec codec = a[1] != null ? Codec.forName((String)a[1]): Codec.getDefault();
+        Codec codec = a[1] != null ? Codec.forName((String) a[1]) : Codec.getDefault();
         return new ForceMergeAction(maxNumSegments, codec);
     });
 
@@ -68,7 +68,7 @@ public ForceMergeAction(StreamInput in) throws IOException {
         if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
             this.codec = Codec.forName(in.readString());
         } else {
-          this.codec = Codec.getDefault();
+            this.codec = Codec.getDefault();
         }
     }
 
@@ -130,7 +130,8 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
             UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
                 openKey, client, bestCompressionSettings);
             OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
-            WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey, forceMergeKey, ClusterHealthStatus.GREEN);
+            WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
+                forceMergeKey, ClusterHealthStatus.GREEN);
             ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, nextStepKey, client, maxNumSegments);
             return Arrays.asList(closeIndexStep, updateBestCompressionSettings,
                 openIndexStep, waitForIndexGreenStep, forceMergeStep);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 4f899f3b74355..ef88e461c0d13 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -109,7 +109,8 @@ public void testMissingMaxNumSegments() throws IOException {
     }
 
     public void testInvalidNegativeSegmentNumber() {
-        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0), Codec.getDefault()));
+        Exception r = expectThrows(IllegalArgumentException.class, () -> new
+            ForceMergeAction(randomIntBetween(-10, 0), Codec.getDefault()));
         assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
     }
 
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 2ee3de617c432..f1de3fe738820 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -10,6 +10,7 @@
 import org.apache.http.entity.StringEntity;
 import org.apache.log4j.LogManager;
 import org.apache.log4j.Logger;
+import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.Response;
 import org.elasticsearch.client.ResponseException;
@@ -411,7 +412,7 @@ public void testForceMergeAction() throws Exception {
         };
         assertThat(numSegments.get(), greaterThan(1));
 
-        createNewSingletonPolicy("warm", new ForceMergeAction(1, false));
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, Codec.getDefault()));
         updatePolicy(index, policy);
 
         assertBusy(() -> {
@@ -1007,7 +1008,7 @@ private void createFullPolicy(TimeValue hotTime) throws IOException {
         hotActions.put(RolloverAction.NAME,  new RolloverAction(null, null, 1L));
         Map<String, LifecycleAction> warmActions = new HashMap<>();
         warmActions.put(SetPriorityAction.NAME, new SetPriorityAction(50));
-        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, false));
+        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, Codec.getDefault()));
         warmActions.put(AllocateAction.NAME, new AllocateAction(1, singletonMap("_name", "integTest-1,integTest-2"), null, null));
         warmActions.put(ShrinkAction.NAME, new ShrinkAction(1));
         Map<String, LifecycleAction> coldActions = new HashMap<>();

From c28a39fcfc03131b81efa0a83b90fec142d4f981 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Tue, 17 Dec 2019 21:26:29 -0800
Subject: [PATCH 013/686] Naming change

---
 .../java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index ef49d537684a8..78417857a7363 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -33,7 +33,7 @@
 public class ForceMergeAction implements LifecycleAction {
     public static final String NAME = "forcemerge";
     public static final ParseField MAX_NUM_SEGMENTS_FIELD = new ParseField("max_num_segments");
-    public static final ParseField CODEC = new ParseField("index.codec");
+    public static final ParseField CODEC = new ParseField("index_codec");
 
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {

From 8b9f86f586cfa76a8df7bea6c56fde28318d46bc Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 18 Dec 2019 23:18:11 -0800
Subject: [PATCH 014/686] Review comments by dakrone

---
 .../xpack/core/ilm/ForceMergeAction.java      | 68 +++++++++++--------
 .../xpack/core/ilm/WaitForIndexColorStep.java | 43 ++++++------
 .../xpack/core/ilm/ForceMergeActionTests.java | 19 ++++--
 .../ilm/TimeseriesLifecycleTypeTests.java     |  2 +-
 4 files changed, 76 insertions(+), 56 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 78417857a7363..6ee7c3eb2df19 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -10,6 +10,7 @@
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -23,7 +24,7 @@
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 
 import java.io.IOException;
-import java.util.Arrays;
+import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
 
@@ -38,13 +39,13 @@ public class ForceMergeAction implements LifecycleAction {
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        Codec codec = a[1] != null ? Codec.forName((String) a[1]) : Codec.getDefault();
+        Codec codec = a[1] != null ? Codec.forName((String) a[1]) : null;
         return new ForceMergeAction(maxNumSegments, codec);
     });
 
     static {
         PARSER.declareInt(ConstructingObjectParser.constructorArg(), MAX_NUM_SEGMENTS_FIELD);
-        PARSER.declareInt(ConstructingObjectParser.constructorArg(), CODEC);
+        PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), CODEC);
     }
 
     private final int maxNumSegments;
@@ -54,21 +55,24 @@ public static ForceMergeAction parse(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    public ForceMergeAction(int maxNumSegments, Codec codec) {
+    public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
         if (maxNumSegments <= 0) {
             throw new IllegalArgumentException("[" + MAX_NUM_SEGMENTS_FIELD.getPreferredName()
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
+        if (codec != null && Codec.forName(codec.getName()) == null) {
+            throw new IllegalArgumentException("Compression type of " + codec.getName() + "does not exist");
+        }
         this.codec = codec;
     }
 
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
         if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
-            this.codec = Codec.forName(in.readString());
+            this.codec = Codec.forName(in.readOptionalString());
         } else {
-            this.codec = Codec.getDefault();
+            this.codec = null;
         }
     }
 
@@ -84,9 +88,9 @@ public Codec getCodec() {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
         if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
-            out.writeString(codec.getName());
+            out.writeOptionalString(codec.getName());
         } else {
-            out.writeString(Codec.getDefault().getName());
+            out.writeString(null);
         }
     }
 
@@ -104,7 +108,9 @@ public boolean isSafeAction() {
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
         builder.field(MAX_NUM_SEGMENTS_FIELD.getPreferredName(), maxNumSegments);
-        builder.field(CODEC.getPreferredName(), codec);
+        if (codec != null) {
+            builder.field(CODEC.getPreferredName(), codec);
+        }
         builder.endObject();
         return builder;
     }
@@ -119,28 +125,34 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         StepKey forceMergeKey = new StepKey(phase, NAME, ForceMergeStep.NAME);
         StepKey countKey = new StepKey(phase, NAME, SegmentCountStep.NAME);
 
-
-        if (codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
-            StepKey closeKey = new StepKey(phase, NAME, CloseIndexStep.NAME);
-            StepKey openKey = new StepKey(phase, NAME, OpenIndexStep.NAME);
-            StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
-            StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
-
-            CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
-            UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
-                openKey, client, bestCompressionSettings);
-            OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
-            WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
-                forceMergeKey, ClusterHealthStatus.GREEN);
-            ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, nextStepKey, client, maxNumSegments);
-            return Arrays.asList(closeIndexStep, updateBestCompressionSettings,
-                openIndexStep, waitForIndexGreenStep, forceMergeStep);
-        }
+        StepKey closeKey = new StepKey(phase, NAME, CloseIndexStep.NAME);
+        StepKey openKey = new StepKey(phase, NAME, OpenIndexStep.NAME);
+        StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
+        StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
 
         UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, forceMergeKey, client, readOnlySettings);
         ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
         SegmentCountStep segmentCountStep = new SegmentCountStep(countKey, nextStepKey, client, maxNumSegments);
-        return Arrays.asList(readOnlyStep, forceMergeStep, segmentCountStep);
+        CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
+        UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
+            openKey, client, bestCompressionSettings);
+        OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
+        WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
+            forceMergeKey, ClusterHealthStatus.GREEN);
+
+        List<Step> mergeSteps = new ArrayList<>();
+        mergeSteps.add(readOnlyStep);
+
+        if (codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
+            mergeSteps.add(closeIndexStep);
+            mergeSteps.add(updateBestCompressionSettings);
+            mergeSteps.add(openIndexStep);
+            mergeSteps.add(waitForIndexGreenStep);
+        }
+
+        mergeSteps.add(forceMergeStep);
+        mergeSteps.add(segmentCountStep);
+        return mergeSteps;
     }
 
     @Override
@@ -158,7 +170,7 @@ public boolean equals(Object obj) {
         }
         ForceMergeAction other = (ForceMergeAction) obj;
         return Objects.equals(maxNumSegments, other.maxNumSegments)
-            && Objects.equals(codec, other.codec);
+            && ((codec == null && other.codec == null) || Objects.equals(codec, other.codec));
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
index 812ad66323668..bfaf6ab5bfcb1 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
@@ -23,7 +23,7 @@
 
 /**
  * Wait Step for index based on color
- * */
+ */
 
 class WaitForIndexColorStep extends ClusterStateWaitStep {
 
@@ -47,8 +47,12 @@ public int hashCode() {
 
     @Override
     public boolean equals(Object obj) {
-        if (obj == null) return false;
-        if (!(obj instanceof WaitForIndexColorStep)) return false;
+        if (obj == null) {
+            return false;
+        }
+        if (obj.getClass() != getClass()) {
+            return false;
+        }
         WaitForIndexColorStep other = (WaitForIndexColorStep) obj;
         return super.equals(obj) && Objects.equals(this.color, other.color);
     }
@@ -69,7 +73,7 @@ public Result isConditionMet(Index index, ClusterState clusterState) {
                 result = waitForRed(indexRoutingTable);
                 break;
             default:
-                result = new Result(false, new Info("No index color match"));
+                result = new Result(false, new Info("no index color match"));
                 break;
         }
         return result;
@@ -77,14 +81,14 @@ public Result isConditionMet(Index index, ClusterState clusterState) {
 
     private Result waitForRed(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
-            return new Result(true, new Info("Index is red"));
+            return new Result(true, new Info("index is red"));
         }
-        return new Result(false, new Info("Index is not red"));
+        return new Result(false, new Info("index is not red"));
     }
 
     private Result waitForYellow(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
-            return new Result(false, new Info("index is red; no IndexRoutingTable"));
+            return new Result(false, new Info("index is red; no indexRoutingTable"));
         }
 
         boolean indexIsAtLeastYellow = indexRoutingTable.allPrimaryShardsActive();
@@ -97,27 +101,20 @@ private Result waitForYellow(IndexRoutingTable indexRoutingTable) {
 
     private Result waitForGreen(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
-            return new Result(false, new Info("index is red; no IndexRoutingTable"));
+            return new Result(false, new Info("index is red; no indexRoutingTable"));
         }
 
-        boolean indexIsGreen = false;
         if (indexRoutingTable.allPrimaryShardsActive()) {
-            boolean replicaIndexIsGreen = false;
             for (ObjectCursor<IndexShardRoutingTable> shardRouting : indexRoutingTable.getShards().values()) {
-                replicaIndexIsGreen = shardRouting.value.replicaShards().stream().allMatch(ShardRouting::active);
-                if (!replicaIndexIsGreen) {
+                boolean replicaIndexIsGreen = shardRouting.value.replicaShards().stream().allMatch(ShardRouting::active);
+                if (replicaIndexIsGreen == false) {
                     return new Result(false, new Info("index is yellow; not all replica shards are active"));
                 }
             }
-            indexIsGreen = replicaIndexIsGreen;
-        }
-
-
-        if (indexIsGreen) {
             return new Result(true, null);
-        } else {
-            return new Result(false, new Info("index is not green; not all shards are active"));
         }
+
+        return new Result(false, new Info("index is not green; not all shards are active"));
     }
 
     static final class Info implements ToXContentObject {
@@ -144,8 +141,12 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
 
         @Override
         public boolean equals(Object o) {
-            if (this == o) return true;
-            if (o == null || getClass() != o.getClass()) return false;
+            if (o == null) {
+                return false;
+            }
+            if (getClass() != o.getClass()) {
+                return false;
+            }
             Info info = (Info) o;
             return Objects.equals(getMessage(), info.getMessage());
         }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index ef88e461c0d13..042c12b9fcb78 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -41,7 +41,7 @@ static ForceMergeAction randomInstance() {
 
     static Codec createRandomCompressionSettings() {
         if(randomBoolean()) {
-            return Codec.getDefault();
+            return null;
         }
         return Codec.forName(CodecService.BEST_COMPRESSION_CODEC);
     }
@@ -50,7 +50,7 @@ static Codec createRandomCompressionSettings() {
     protected ForceMergeAction mutateInstance(ForceMergeAction instance) {
         int maxNumSegments = instance.getMaxNumSegments();
         maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
-        return new ForceMergeAction(maxNumSegments, Codec.getDefault());
+        return new ForceMergeAction(maxNumSegments, createRandomCompressionSettings());
     }
 
     @Override
@@ -81,12 +81,13 @@ private void assertBestCompression(ForceMergeAction instance) {
         StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
         List<Step> steps = instance.toSteps(null, phase, nextStepKey);
         assertNotNull(steps);
-        assertEquals(5, steps.size());
+        assertEquals(6, steps.size());
         CloseIndexStep firstStep = (CloseIndexStep) steps.get(0);
         UpdateSettingsStep secondStep = (UpdateSettingsStep) steps.get(1);
         OpenIndexStep thirdStep = (OpenIndexStep) steps.get(2);
         WaitForIndexColorStep fourthStep = (WaitForIndexColorStep) steps.get(3);
         ForceMergeStep fifthStep = (ForceMergeStep) steps.get(4);
+        SegmentCountStep sixthStep = (SegmentCountStep) steps.get(4);
         assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
         assertThat(firstStep.getNextStepKey(), equalTo(secondStep.getKey()));
         assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
@@ -98,6 +99,8 @@ private void assertBestCompression(ForceMergeAction instance) {
         assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
         assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
         assertThat(fifthStep.getNextStepKey(), equalTo(nextStepKey));
+        assertThat(sixthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
+        assertThat(sixthStep.getNextStepKey(), equalTo(nextStepKey));
     }
 
     public void testMissingMaxNumSegments() throws IOException {
@@ -105,18 +108,22 @@ public void testMissingMaxNumSegments() throws IOException {
         XContentParser parser = XContentHelper.createParser(null, DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
             emptyObject, XContentType.JSON);
         Exception e = expectThrows(IllegalArgumentException.class, () -> ForceMergeAction.parse(parser));
-        assertThat(e.getMessage(), equalTo("Required [max_num_segments, best_compression]"));
+        assertThat(e.getMessage(), equalTo("Required [max_num_segments]"));
     }
 
     public void testInvalidNegativeSegmentNumber() {
         Exception r = expectThrows(IllegalArgumentException.class, () -> new
-            ForceMergeAction(randomIntBetween(-10, 0), Codec.getDefault()));
+            ForceMergeAction(randomIntBetween(-10, 0), null));
         assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
     }
 
+    public void testInvalidCodec() {
+
+    }
+
     public void testToSteps() {
         ForceMergeAction instance = createTestInstance();
-        if (CodecService.BEST_COMPRESSION_CODEC.equals(instance.getCodec().getName())) {
+        if (instance.getCodec() != null && CodecService.BEST_COMPRESSION_CODEC.equals(instance.getCodec().getName())) {
             assertBestCompression(instance);
         }
         else {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index 1469e40e6682d..e1df27f09a44f 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -493,7 +493,7 @@ private ConcurrentMap<String, LifecycleAction> convertActionNamesToActions(Strin
             case DeleteAction.NAME:
                 return new DeleteAction();
             case ForceMergeAction.NAME:
-                return new ForceMergeAction(1, Codec.getDefault());
+                return new ForceMergeAction(1, null);
             case ReadOnlyAction.NAME:
                 return new ReadOnlyAction();
             case RolloverAction.NAME:

From 80b6144d3023a894a29b803c9c738eb0c35dbc1e Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 19 Dec 2019 22:41:19 -0800
Subject: [PATCH 015/686] Adding tests for review

---
 .../xpack/core/ilm/ForceMergeAction.java              |  4 ++--
 .../xpack/core/ilm/ForceMergeActionTests.java         |  4 +++-
 .../xpack/ilm/TimeSeriesLifecycleActionsIT.java       | 11 +++++++++--
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 6ee7c3eb2df19..c3c0288c9b315 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -61,8 +61,8 @@ public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
-        if (codec != null && Codec.forName(codec.getName()) == null) {
-            throw new IllegalArgumentException("Compression type of " + codec.getName() + "does not exist");
+        if (codec != null && CodecService.BEST_COMPRESSION_CODEC.equals(codec.getName()) == false) {
+            throw new IllegalArgumentException("Compression type not found instead " + codec.getName() + " is used.");
         }
         this.codec = codec;
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 042c12b9fcb78..a81a6e1350da6 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -118,7 +118,9 @@ public void testInvalidNegativeSegmentNumber() {
     }
 
     public void testInvalidCodec() {
-
+        Exception r = expectThrows(IllegalArgumentException.class, () -> new
+            ForceMergeAction(randomIntBetween(-10, 0), Codec.forName(CodecService.DEFAULT_CODEC)));
+        assertThat(r.getMessage(), equalTo("Best Compression type not found instead " + CodecService.DEFAULT_CODEC + " is used."));
     }
 
     public void testToSteps() {
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index f1de3fe738820..4fb6c87ad012f 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -24,6 +24,7 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.index.codec.CodecService;
 import org.elasticsearch.test.rest.ESRestTestCase;
 import org.elasticsearch.xpack.core.ilm.AllocateAction;
 import org.elasticsearch.xpack.core.ilm.DeleteAction;
@@ -388,7 +389,7 @@ public void testReadOnly() throws Exception {
     }
 
     @SuppressWarnings("unchecked")
-    public void testForceMergeAction() throws Exception {
+    public void forceMergeActionWithCodec(Codec codec) throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
         for (int i = 0; i < randomIntBetween(2, 10); i++) {
@@ -412,7 +413,7 @@ public void testForceMergeAction() throws Exception {
         };
         assertThat(numSegments.get(), greaterThan(1));
 
-        createNewSingletonPolicy("warm", new ForceMergeAction(1, Codec.getDefault()));
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, codec));
         updatePolicy(index, policy);
 
         assertBusy(() -> {
@@ -424,6 +425,12 @@ public void testForceMergeAction() throws Exception {
         expectThrows(ResponseException.class, this::indexDocument);
     }
 
+    public void testForceMergeAction() throws Exception {
+        forceMergeActionWithCodec(null);
+        forceMergeActionWithCodec(Codec.forName(CodecService.BEST_COMPRESSION_CODEC));
+    }
+
+
     public void testShrinkAction() throws Exception {
         int numShards = 6;
         int divisor = randomFrom(2, 3, 6);

From 0d8138c85aa92a4f142054583433c94cbc918c1d Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 9 Jan 2020 21:40:56 -0800
Subject: [PATCH 016/686] Review comments

---
 .../xpack/core/ilm/CloseIndexStep.java        |  9 +++++++--
 .../xpack/core/ilm/ForceMergeAction.java      | 19 +++++++++++++------
 .../xpack/core/ilm/OpenIndexStep.java         | 11 +++++++++--
 .../xpack/core/ilm/WaitForIndexColorStep.java |  7 ++++++-
 .../xpack/core/ilm/ForceMergeActionTests.java |  2 +-
 .../ilm/TimeseriesLifecycleTypeTests.java     |  3 +--
 .../ilm/TimeSeriesLifecycleActionsIT.java     |  2 +-
 7 files changed, 38 insertions(+), 15 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index 994ddf2590b58..c5bdb620ddcca 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -31,7 +31,9 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             CloseIndexRequest request = new CloseIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
                 .close(request, ActionListener.wrap(closeIndexResponse -> {
-                    assert closeIndexResponse.isAcknowledged() : "close index response is not acknowledged";
+                    if (closeIndexResponse.isAcknowledged() == false) {
+                       new ErrorStep(getKey());
+                    }
                     listener.onResponse(true);
                 }, listener::onFailure));
         }
@@ -40,5 +42,8 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
         }
     }
 
-
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index c3c0288c9b315..502ad7722d105 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -62,7 +62,7 @@ public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
         }
         this.maxNumSegments = maxNumSegments;
         if (codec != null && CodecService.BEST_COMPRESSION_CODEC.equals(codec.getName()) == false) {
-            throw new IllegalArgumentException("Compression type not found instead " + codec.getName() + " is used.");
+            throw new IllegalArgumentException("unknown index codec: [" + codec.getName() + "]");
         }
         this.codec = codec;
     }
@@ -70,7 +70,12 @@ public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
         if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
-            this.codec = Codec.forName(in.readOptionalString());
+            String codecStr = in.readOptionalString();
+            if (codecStr == null) {
+                this.codec = null;
+            } else {
+                this.codec = Codec.forName(codecStr);
+            }
         } else {
             this.codec = null;
         }
@@ -88,9 +93,11 @@ public Codec getCodec() {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
         if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
-            out.writeOptionalString(codec.getName());
-        } else {
-            out.writeString(null);
+            if (codec == null) {
+                out.writeOptionalString(null);
+            } else {
+                out.writeOptionalString(codec.getName());
+            }
         }
     }
 
@@ -170,7 +177,7 @@ public boolean equals(Object obj) {
         }
         ForceMergeAction other = (ForceMergeAction) obj;
         return Objects.equals(maxNumSegments, other.maxNumSegments)
-            && ((codec == null && other.codec == null) || Objects.equals(codec, other.codec));
+            && Objects.equals(codec, other.codec);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index 907750e212332..86e58815712d7 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -32,8 +32,10 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             OpenIndexRequest request = new OpenIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
                 .open(request,
-                    ActionListener.wrap(openIndexResponse-> {
-                        assert openIndexResponse.isAcknowledged() : "open Index response is not acknowledged";
+                    ActionListener.wrap(openIndexResponse -> {
+                        if (openIndexResponse.isAcknowledged() == false) {
+                            new ErrorStep(getKey());
+                        }
                         listener.onResponse(true);
                     }, listener::onFailure));
 
@@ -41,4 +43,9 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             listener.onResponse(true);
         }
     }
+
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
index bfaf6ab5bfcb1..fd02a69999c73 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
@@ -27,7 +27,7 @@
 
 class WaitForIndexColorStep extends ClusterStateWaitStep {
 
-    static final String NAME = "wait-for-index-color-step";
+    static final String NAME = "wait-for-index-color";
 
     private final ClusterHealthStatus color;
 
@@ -79,6 +79,11 @@ public Result isConditionMet(Index index, ClusterState clusterState) {
         return result;
     }
 
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
+
     private Result waitForRed(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
             return new Result(true, new Info("index is red"));
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index a81a6e1350da6..e581237177b17 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -40,7 +40,7 @@ static ForceMergeAction randomInstance() {
     }
 
     static Codec createRandomCompressionSettings() {
-        if(randomBoolean()) {
+        if (randomBoolean()) {
             return null;
         }
         return Codec.forName(CodecService.BEST_COMPRESSION_CODEC);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index e1df27f09a44f..92fb7d224cfe1 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
-import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.test.ESTestCase;
@@ -35,7 +34,7 @@ public class TimeseriesLifecycleTypeTests extends ESTestCase {
     private static final AllocateAction TEST_ALLOCATE_ACTION =
         new AllocateAction(2, Collections.singletonMap("node", "node1"),null, null);
     private static final DeleteAction TEST_DELETE_ACTION = new DeleteAction();
-    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, Codec.getDefault());
+    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, null);
     private static final RolloverAction TEST_ROLLOVER_ACTION = new RolloverAction(new ByteSizeValue(1), null, null);
     private static final ShrinkAction TEST_SHRINK_ACTION = new ShrinkAction(1);
     private static final ReadOnlyAction TEST_READ_ONLY_ACTION = new ReadOnlyAction();
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 4fb6c87ad012f..2705f568b5de4 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1015,7 +1015,7 @@ private void createFullPolicy(TimeValue hotTime) throws IOException {
         hotActions.put(RolloverAction.NAME,  new RolloverAction(null, null, 1L));
         Map<String, LifecycleAction> warmActions = new HashMap<>();
         warmActions.put(SetPriorityAction.NAME, new SetPriorityAction(50));
-        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, Codec.getDefault()));
+        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, null));
         warmActions.put(AllocateAction.NAME, new AllocateAction(1, singletonMap("_name", "integTest-1,integTest-2"), null, null));
         warmActions.put(ShrinkAction.NAME, new ShrinkAction(1));
         Map<String, LifecycleAction> coldActions = new HashMap<>();

From e58c711dba3cf8c287a15f35a26a068844ede6d5 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sat, 18 Jan 2020 11:09:22 -0800
Subject: [PATCH 017/686] Adding Elastic Exception

---
 .../java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java  | 3 ++-
 .../java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java   | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index c5bdb620ddcca..01aa3125706e2 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -6,6 +6,7 @@
 
 package org.elasticsearch.xpack.core.ilm;
 
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.indices.close.CloseIndexRequest;
 import org.elasticsearch.client.Client;
@@ -32,7 +33,7 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             getClient().admin().indices()
                 .close(request, ActionListener.wrap(closeIndexResponse -> {
                     if (closeIndexResponse.isAcknowledged() == false) {
-                       new ErrorStep(getKey());
+                        throw new ElasticsearchException("close index request failed to be acknowledged");
                     }
                     listener.onResponse(true);
                 }, listener::onFailure));
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index 86e58815712d7..56cd50025def3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -6,6 +6,7 @@
 
 package org.elasticsearch.xpack.core.ilm;
 
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
 import org.elasticsearch.client.Client;
@@ -34,7 +35,7 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
                 .open(request,
                     ActionListener.wrap(openIndexResponse -> {
                         if (openIndexResponse.isAcknowledged() == false) {
-                            new ErrorStep(getKey());
+                            throw new ElasticsearchException("open index request failed to be acknowledged");
                         }
                         listener.onResponse(true);
                     }, listener::onFailure));

From 8f7e0aba929d497bc54355e7cc5d146a08b8e0ed Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 19 Jan 2020 23:29:34 -0800
Subject: [PATCH 018/686] Fixing broken tests

---
 .../xpack/ilm/action/TransportPutLifecycleActionTests.java      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java
index f2f67fa281f90..a771ef533c860 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java
@@ -148,7 +148,7 @@ public void testReadStepKeys() {
                 new Step.StepKey("phase", "set_priority", SetPriorityAction.NAME)));
 
         Map<String, LifecycleAction> actions = new HashMap<>();
-        actions.put("forcemerge", new ForceMergeAction(5));
+        actions.put("forcemerge", new ForceMergeAction(5, null));
         actions.put("freeze", new FreezeAction());
         actions.put("allocate", new AllocateAction(1, null, null, null));
         PhaseExecutionInfo pei = new PhaseExecutionInfo("policy", new Phase("wonky", TimeValue.ZERO, actions), 1, 1);

From f7aba603400c52b0fada413fb3c616a88ee1604d Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 29 Nov 2019 09:58:50 +0100
Subject: [PATCH 019/686] Optimize GoogleCloudStorageHttpHandler (#49677)

Removing a lot of needless buffering and array creation
to reduce the significant memory usage of tests using this.
The incoming stream from the `exchange` is already buffered
so there is no point in adding a ton of additional buffers
everywhere.
---
 .../gcs/GoogleCloudStorageHttpHandler.java    | 87 +++++++++++--------
 1 file changed, 49 insertions(+), 38 deletions(-)

diff --git a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
index 5a359ad2c7cc0..ba2a725fed29b 100644
--- a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
+++ b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
@@ -161,7 +161,7 @@ public void handle(final HttpExchange exchange) throws IOException {
                 // Batch https://cloud.google.com/storage/docs/json_api/v1/how-tos/batch
                 final String uri = "/storage/v1/b/" + bucket + "/o/";
                 final StringBuilder batch = new StringBuilder();
-                for (String line : Streams.readAllLines(new BufferedInputStream(wrappedRequest))) {
+                for (String line : Streams.readAllLines(wrappedRequest)) {
                     if (line.length() == 0 || line.startsWith("--") || line.toLowerCase(Locale.ROOT).startsWith("content")) {
                         batch.append(line).append('\n');
                     } else if (line.startsWith("DELETE")) {
@@ -225,8 +225,13 @@ public void handle(final HttpExchange exchange) throws IOException {
                 final int start = getContentRangeStart(range);
                 final int end = getContentRangeEnd(range);
 
-                final ByteArrayOutputStream out = new ByteArrayOutputStream();
-                long bytesRead = Streams.copy(wrappedRequest, out);
+                final ByteArrayOutputStream out = new ByteArrayOutputStream() {
+                    @Override
+                    public byte[] toByteArray() {
+                        return buf;
+                    }
+                };
+                long bytesRead = Streams.copy(wrappedRequest, out, new byte[128]);
                 int length = Math.max(end + 1, limit != null ? limit : 0);
                 if ((int) bytesRead > length) {
                     throw new AssertionError("Requesting more bytes than available for blob");
@@ -266,56 +271,62 @@ private String httpServerUrl(final HttpExchange exchange) {
         return "http://" + InetAddresses.toUriString(address.getAddress()) + ":" + address.getPort();
     }
 
+    private static final Pattern NAME_PATTERN = Pattern.compile("\"name\":\"([^\"]*)\"");
+
     public static Optional<Tuple<String, BytesArray>> parseMultipartRequestBody(final InputStream requestBody) throws IOException {
         Tuple<String, BytesArray> content = null;
         try (BufferedInputStream in = new BufferedInputStream(new GZIPInputStream(requestBody))) {
             String name = null;
             int read;
+            ByteArrayOutputStream out = new ByteArrayOutputStream() {
+                @Override
+                public byte[] toByteArray() {
+                    return buf;
+                }
+            };
             while ((read = in.read()) != -1) {
+                out.reset();
                 boolean markAndContinue = false;
-                try (ByteArrayOutputStream out = new ByteArrayOutputStream()) {
-                    do { // search next consecutive {carriage return, new line} chars and stop
-                        if ((char) read == '\r') {
-                            int next = in.read();
-                            if (next != -1) {
-                                if (next == '\n') {
-                                    break;
-                                }
-                                out.write(read);
-                                out.write(next);
-                                continue;
+                do { // search next consecutive {carriage return, new line} chars and stop
+                    if ((char) read == '\r') {
+                        int next = in.read();
+                        if (next != -1) {
+                            if (next == '\n') {
+                                break;
                             }
-                        }
-                        out.write(read);
-                    } while ((read = in.read()) != -1);
-
-                    final String line = new String(out.toByteArray(), UTF_8);
-                    if (line.length() == 0 || line.equals("\r\n") || line.startsWith("--")
-                        || line.toLowerCase(Locale.ROOT).startsWith("content")) {
-                        markAndContinue = true;
-                    } else if (line.startsWith("{\"bucket\":")) {
-                        markAndContinue = true;
-                        Matcher matcher = Pattern.compile("\"name\":\"([^\"]*)\"").matcher(line);
-                        if (matcher.find()) {
-                            name = matcher.group(1);
+                            out.write(read);
+                            out.write(next);
+                            continue;
                         }
                     }
-                    if (markAndContinue) {
-                        in.mark(Integer.MAX_VALUE);
-                        continue;
+                    out.write(read);
+                } while ((read = in.read()) != -1);
+                final String bucketPrefix = "{\"bucket\":";
+                final String start = new String(out.toByteArray(), 0, Math.min(out.size(), bucketPrefix.length()), UTF_8);
+                if (start.length() == 0 || start.equals("\r\n") || start.startsWith("--")
+                    || start.toLowerCase(Locale.ROOT).startsWith("content")) {
+                    markAndContinue = true;
+                } else if (start.startsWith(bucketPrefix)) {
+                    markAndContinue = true;
+                    final String line = new String(out.toByteArray(), bucketPrefix.length(), out.size() - bucketPrefix.length(), UTF_8);
+                    Matcher matcher = NAME_PATTERN.matcher(line);
+                    if (matcher.find()) {
+                        name = matcher.group(1);
                     }
                 }
+                if (markAndContinue) {
+                    in.mark(Integer.MAX_VALUE);
+                    continue;
+                }
                 if (name != null) {
                     in.reset();
-                    try (ByteArrayOutputStream binary = new ByteArrayOutputStream()) {
-                        while ((read = in.read()) != -1) {
-                            binary.write(read);
-                        }
-                        binary.flush();
-                        byte[] tmp = binary.toByteArray();
-                        // removes the trailing end "\r\n--__END_OF_PART__--\r\n" which is 23 bytes long
-                        content = Tuple.tuple(name, new BytesArray(Arrays.copyOf(tmp, tmp.length - 23)));
+                    out.reset();
+                    while ((read = in.read()) != -1) {
+                        out.write(read);
                     }
+                    // removes the trailing end "\r\n--__END_OF_PART__--\r\n" which is 23 bytes long
+                    content = Tuple.tuple(name, new BytesArray(Arrays.copyOf(out.toByteArray(), out.size() - 23)));
+                    break;
                 }
             }
         }

From 8e9bc76ac5263bfe198a3e7104462d689213dda6 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 29 Nov 2019 10:14:53 +0100
Subject: [PATCH 020/686] Make BlobStoreRepository Aware of ClusterState
 (#49639)

This is a preliminary to #49060.

It does not introduce any substantial behavior change to how the blob store repository
operates. What it does is to add all the infrastructure changes around passing the cluster service to the blob store, associated test changes and a best effort approach to tracking the latest repository generation on all nodes from cluster state updates. This brings a slight improvement to the consistency
by which non-master nodes (or master directly after a failover) will be able to determine the latest repository generation. It does not however do any tricky checks for the situation after a repository operation
(create, delete or cleanup) that could theoretically be used to get even greater accuracy to keep this change simple.
This change does not in any way alter the behavior of the blobstore repository other than adding a better "guess" for the value of the latest repo generation and is mainly intended to isolate the actual logical change to how the
repository operates in #49060
---
 .../repository/url/URLRepositoryPlugin.java   |  6 +--
 .../repositories/url/URLRepository.java       |  6 +--
 .../repositories/url/URLRepositoryTests.java  |  5 +-
 .../repositories/azure/AzureRepository.java   |  6 +--
 .../azure/AzureRepositoryPlugin.java          |  6 +--
 .../azure/AzureRepositorySettingsTests.java   |  5 +-
 .../gcs/GoogleCloudStoragePlugin.java         |  6 +--
 .../gcs/GoogleCloudStorageRepository.java     |  6 +--
 ...eCloudStorageBlobStoreRepositoryTests.java |  7 +--
 .../repositories/hdfs/HdfsPlugin.java         |  6 +--
 .../repositories/hdfs/HdfsRepository.java     |  6 +--
 .../repositories/s3/S3Repository.java         |  6 +--
 .../repositories/s3/S3RepositoryPlugin.java   | 10 ++--
 .../s3/RepositoryCredentialsTests.java        |  6 +--
 .../s3/S3BlobStoreRepositoryTests.java        |  7 +--
 .../repositories/s3/S3RepositoryTests.java    |  5 +-
 .../cluster/RepositoryCleanupInProgress.java  |  9 +++-
 .../cluster/SnapshotDeletionsInProgress.java  | 20 +++++---
 .../cluster/SnapshotsInProgress.java          | 11 +++-
 .../plugins/RepositoryPlugin.java             |  6 +--
 .../repositories/FilterRepository.java        |  6 +++
 .../repositories/RepositoriesModule.java      |  6 +--
 .../repositories/RepositoriesService.java     | 10 +++-
 .../repositories/Repository.java              | 10 ++++
 .../repositories/RepositoryOperation.java     | 35 +++++++++++++
 .../blobstore/BlobStoreRepository.java        | 50 +++++++++++++++++--
 .../repositories/fs/FsRepository.java         |  6 +--
 .../snapshots/SnapshotsService.java           | 10 ++--
 .../repositories/RepositoriesModuleTests.java | 26 +++++-----
 .../RepositoriesServiceTests.java             |  5 ++
 .../BlobStoreRepositoryRestoreTests.java      |  3 +-
 .../blobstore/BlobStoreRepositoryTests.java   |  6 +--
 .../repositories/fs/FsRepositoryTests.java    |  4 +-
 ...etadataLoadingDuringSnapshotRestoreIT.java | 10 ++--
 .../snapshots/SnapshotResiliencyTests.java    | 22 +++-----
 .../MockEventuallyConsistentRepository.java   |  6 +--
 ...ckEventuallyConsistentRepositoryTests.java | 21 +++-----
 .../index/shard/RestoreOnlyRepository.java    |  5 ++
 .../blobstore/BlobStoreTestUtil.java          | 50 +++++++++++++++++++
 .../snapshots/mockstore/MockRepository.java   | 11 ++--
 .../java/org/elasticsearch/xpack/ccr/Ccr.java |  5 +-
 .../xpack/ccr/repository/CcrRepository.java   |  5 ++
 .../elasticsearch/xpack/core/XPackPlugin.java |  2 +-
 .../snapshots/SourceOnlySnapshotIT.java       |  4 +-
 .../SourceOnlySnapshotShardTests.java         |  5 +-
 .../core/LocalStateCompositeXPackPlugin.java  | 14 +++---
 46 files changed, 329 insertions(+), 153 deletions(-)
 create mode 100644 server/src/main/java/org/elasticsearch/repositories/RepositoryOperation.java

diff --git a/modules/repository-url/src/main/java/org/elasticsearch/plugin/repository/url/URLRepositoryPlugin.java b/modules/repository-url/src/main/java/org/elasticsearch/plugin/repository/url/URLRepositoryPlugin.java
index 6e88f0e0deb54..4c3fa615937e7 100644
--- a/modules/repository-url/src/main/java/org/elasticsearch/plugin/repository/url/URLRepositoryPlugin.java
+++ b/modules/repository-url/src/main/java/org/elasticsearch/plugin/repository/url/URLRepositoryPlugin.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.plugin.repository.url;
 
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
@@ -26,7 +27,6 @@
 import org.elasticsearch.plugins.RepositoryPlugin;
 import org.elasticsearch.repositories.Repository;
 import org.elasticsearch.repositories.url.URLRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.Arrays;
 import java.util.Collections;
@@ -46,8 +46,8 @@ public List<Setting<?>> getSettings() {
 
     @Override
     public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                           ThreadPool threadPool) {
+                                                           ClusterService clusterService) {
         return Collections.singletonMap(URLRepository.TYPE,
-            metadata -> new URLRepository(metadata, env, namedXContentRegistry, threadPool));
+            metadata -> new URLRepository(metadata, env, namedXContentRegistry, clusterService));
     }
 }
diff --git a/modules/repository-url/src/main/java/org/elasticsearch/repositories/url/URLRepository.java b/modules/repository-url/src/main/java/org/elasticsearch/repositories/url/URLRepository.java
index 6e759756a7289..8fbe4752dc83c 100644
--- a/modules/repository-url/src/main/java/org/elasticsearch/repositories/url/URLRepository.java
+++ b/modules/repository-url/src/main/java/org/elasticsearch/repositories/url/URLRepository.java
@@ -22,6 +22,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.blobstore.BlobStore;
@@ -33,7 +34,6 @@
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.repositories.RepositoryException;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.net.MalformedURLException;
 import java.net.URISyntaxException;
@@ -81,8 +81,8 @@ public class URLRepository extends BlobStoreRepository {
      * Constructs a read-only URL-based repository
      */
     public URLRepository(RepositoryMetaData metadata, Environment environment,
-                         NamedXContentRegistry namedXContentRegistry, ThreadPool threadPool) {
-        super(metadata, namedXContentRegistry, threadPool, BlobPath.cleanPath());
+                         NamedXContentRegistry namedXContentRegistry, ClusterService clusterService) {
+        super(metadata, namedXContentRegistry, clusterService, BlobPath.cleanPath());
 
         if (URL_SETTING.exists(metadata.settings()) == false && REPOSITORIES_URL_SETTING.exists(environment.settings()) ==  false) {
             throw new RepositoryException(metadata.name(), "missing url");
diff --git a/modules/repository-url/src/test/java/org/elasticsearch/repositories/url/URLRepositoryTests.java b/modules/repository-url/src/test/java/org/elasticsearch/repositories/url/URLRepositoryTests.java
index 96a82ee0b9d24..823571462d243 100644
--- a/modules/repository-url/src/test/java/org/elasticsearch/repositories/url/URLRepositoryTests.java
+++ b/modules/repository-url/src/test/java/org/elasticsearch/repositories/url/URLRepositoryTests.java
@@ -25,8 +25,8 @@
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.TestEnvironment;
 import org.elasticsearch.repositories.RepositoryException;
+import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
 import java.nio.file.Path;
@@ -35,13 +35,12 @@
 import static org.hamcrest.CoreMatchers.is;
 import static org.hamcrest.CoreMatchers.not;
 import static org.hamcrest.CoreMatchers.nullValue;
-import static org.mockito.Mockito.mock;
 
 public class URLRepositoryTests extends ESTestCase {
 
     private URLRepository createRepository(Settings baseSettings, RepositoryMetaData repositoryMetaData) {
         return new URLRepository(repositoryMetaData, TestEnvironment.newEnvironment(baseSettings),
-            new NamedXContentRegistry(Collections.emptyList()), mock(ThreadPool.class)) {
+            new NamedXContentRegistry(Collections.emptyList()), BlobStoreTestUtil.mockClusterService()) {
             @Override
             protected void assertSnapshotOrGenericThread() {
                 // eliminate thread name check as we create repo manually on test/main threads
diff --git a/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureRepository.java b/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureRepository.java
index b5c6ed70ad0d2..7b7a9108c1ef5 100644
--- a/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureRepository.java
+++ b/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureRepository.java
@@ -24,6 +24,7 @@
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.blobstore.BlobStore;
@@ -32,7 +33,6 @@
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.Locale;
 import java.util.function.Function;
@@ -79,8 +79,8 @@ public AzureRepository(
         final RepositoryMetaData metadata,
         final NamedXContentRegistry namedXContentRegistry,
         final AzureStorageService storageService,
-        final ThreadPool threadPool) {
-        super(metadata, namedXContentRegistry, threadPool, buildBasePath(metadata));
+        final ClusterService clusterService) {
+        super(metadata, namedXContentRegistry, clusterService, buildBasePath(metadata));
         this.chunkSize = Repository.CHUNK_SIZE_SETTING.get(metadata.settings());
         this.storageService = storageService;
 
diff --git a/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureRepositoryPlugin.java b/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureRepositoryPlugin.java
index 8815e738f9cdd..d98a7c3cbd717 100644
--- a/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureRepositoryPlugin.java
+++ b/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureRepositoryPlugin.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.repositories.azure;
 
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.settings.SettingsException;
@@ -31,7 +32,6 @@
 import org.elasticsearch.repositories.Repository;
 import org.elasticsearch.threadpool.ExecutorBuilder;
 import org.elasticsearch.threadpool.ScalingExecutorBuilder;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.Arrays;
 import java.util.Collections;
@@ -60,9 +60,9 @@ AzureStorageService createAzureStoreService(final Settings settings) {
 
     @Override
     public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                           ThreadPool threadPool) {
+                                                           ClusterService clusterService) {
         return Collections.singletonMap(AzureRepository.TYPE,
-                (metadata) -> new AzureRepository(metadata, namedXContentRegistry, azureStoreService, threadPool));
+                (metadata) -> new AzureRepository(metadata, namedXContentRegistry, azureStoreService, clusterService));
     }
 
     @Override
diff --git a/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureRepositorySettingsTests.java b/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureRepositorySettingsTests.java
index 341a1d1436deb..6f5373dab98cf 100644
--- a/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureRepositorySettingsTests.java
+++ b/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureRepositorySettingsTests.java
@@ -26,8 +26,8 @@
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
+import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.nullValue;
@@ -42,8 +42,7 @@ private AzureRepository azureRepository(Settings settings) {
             .put(settings)
             .build();
         final AzureRepository azureRepository = new AzureRepository(new RepositoryMetaData("foo", "azure", internalSettings),
-            NamedXContentRegistry.EMPTY, mock(AzureStorageService.class),
-                                           mock(ThreadPool.class));
+            NamedXContentRegistry.EMPTY, mock(AzureStorageService.class), BlobStoreTestUtil.mockClusterService());
         assertThat(azureRepository.getBlobStore(), is(nullValue()));
         return azureRepository;
     }
diff --git a/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStoragePlugin.java b/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStoragePlugin.java
index 70c4dcf3a9889..c4a065270be69 100644
--- a/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStoragePlugin.java
+++ b/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStoragePlugin.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.repositories.gcs;
 
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -27,7 +28,6 @@
 import org.elasticsearch.plugins.ReloadablePlugin;
 import org.elasticsearch.plugins.RepositoryPlugin;
 import org.elasticsearch.repositories.Repository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.Arrays;
 import java.util.Collections;
@@ -52,9 +52,9 @@ protected GoogleCloudStorageService createStorageService() {
 
     @Override
     public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                           ThreadPool threadPool) {
+                                                           ClusterService clusterService) {
         return Collections.singletonMap(GoogleCloudStorageRepository.TYPE,
-            metadata -> new GoogleCloudStorageRepository(metadata, namedXContentRegistry, this.storageService, threadPool));
+            metadata -> new GoogleCloudStorageRepository(metadata, namedXContentRegistry, this.storageService, clusterService));
     }
 
     @Override
diff --git a/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageRepository.java b/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageRepository.java
index 4b17fd6bef3ea..852b147346e06 100644
--- a/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageRepository.java
+++ b/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageRepository.java
@@ -22,6 +22,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.settings.Setting;
@@ -30,7 +31,6 @@
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.repositories.RepositoryException;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.function.Function;
 
@@ -64,8 +64,8 @@ class GoogleCloudStorageRepository extends BlobStoreRepository {
         final RepositoryMetaData metadata,
         final NamedXContentRegistry namedXContentRegistry,
         final GoogleCloudStorageService storageService,
-        final ThreadPool threadPool) {
-        super(metadata, namedXContentRegistry, threadPool, buildBasePath(metadata));
+        final ClusterService clusterService) {
+        super(metadata, namedXContentRegistry, clusterService, buildBasePath(metadata));
         this.storageService = storageService;
 
         this.chunkSize = getSetting(CHUNK_SIZE, metadata);
diff --git a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
index ee0b59eb9d365..7a2c3d780123a 100644
--- a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
+++ b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
@@ -27,6 +27,7 @@
 import fixture.gcs.FakeOAuth2HttpHandler;
 import fixture.gcs.GoogleCloudStorageHttpHandler;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.SuppressForbidden;
 import org.elasticsearch.common.io.Streams;
 import org.elasticsearch.common.settings.MockSecureSettings;
@@ -38,7 +39,6 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.repositories.Repository;
 import org.elasticsearch.repositories.blobstore.ESMockAPIBasedRepositoryIntegTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 import org.threeten.bp.Duration;
 
 import java.io.IOException;
@@ -170,9 +170,10 @@ StorageOptions createStorageOptions(final GoogleCloudStorageClientSettings clien
         }
 
         @Override
-        public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry registry, ThreadPool threadPool) {
+        public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry registry,
+                                                               ClusterService clusterService) {
             return Collections.singletonMap(GoogleCloudStorageRepository.TYPE,
-                metadata -> new GoogleCloudStorageRepository(metadata, registry, this.storageService, threadPool) {
+                metadata -> new GoogleCloudStorageRepository(metadata, registry, this.storageService, clusterService) {
                     @Override
                     protected GoogleCloudStorageBlobStore createBlobStore() {
                         return new GoogleCloudStorageBlobStore("bucket", "test", storageService) {
diff --git a/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsPlugin.java b/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsPlugin.java
index a6dc5fe7db140..1d93aed9cc308 100644
--- a/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsPlugin.java
+++ b/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsPlugin.java
@@ -30,13 +30,13 @@
 import org.apache.hadoop.security.KerberosInfo;
 import org.apache.hadoop.security.SecurityUtil;
 import org.elasticsearch.SpecialPermission;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.SuppressForbidden;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.plugins.RepositoryPlugin;
 import org.elasticsearch.repositories.Repository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 public final class HdfsPlugin extends Plugin implements RepositoryPlugin {
 
@@ -112,7 +112,7 @@ private static Void eagerInit() {
 
     @Override
     public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                           ThreadPool threadPool) {
-        return Collections.singletonMap("hdfs", (metadata) -> new HdfsRepository(metadata, env, namedXContentRegistry, threadPool));
+                                                           ClusterService clusterService) {
+        return Collections.singletonMap("hdfs", (metadata) -> new HdfsRepository(metadata, env, namedXContentRegistry, clusterService));
     }
 }
diff --git a/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsRepository.java b/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsRepository.java
index 72430bcd36631..776c97422e5ee 100644
--- a/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsRepository.java
+++ b/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsRepository.java
@@ -31,6 +31,7 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.SpecialPermission;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.SuppressForbidden;
 import org.elasticsearch.common.blobstore.BlobPath;
@@ -40,7 +41,6 @@
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
 import java.io.UncheckedIOException;
@@ -67,8 +67,8 @@ public final class HdfsRepository extends BlobStoreRepository {
     private static final ByteSizeValue DEFAULT_BUFFER_SIZE = new ByteSizeValue(100, ByteSizeUnit.KB);
 
     public HdfsRepository(RepositoryMetaData metadata, Environment environment,
-                          NamedXContentRegistry namedXContentRegistry, ThreadPool threadPool) {
-        super(metadata, namedXContentRegistry, threadPool, BlobPath.cleanPath());
+                          NamedXContentRegistry namedXContentRegistry, ClusterService clusterService) {
+        super(metadata, namedXContentRegistry, clusterService, BlobPath.cleanPath());
 
         this.environment = environment;
         this.chunkSize = metadata.settings().getAsBytesSize("chunk_size", null);
diff --git a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3Repository.java b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3Repository.java
index af895758723f5..db6968ea71059 100644
--- a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3Repository.java
+++ b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3Repository.java
@@ -22,6 +22,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.blobstore.BlobStore;
@@ -32,7 +33,6 @@
 import org.elasticsearch.monitor.jvm.JvmInfo;
 import org.elasticsearch.repositories.RepositoryException;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.function.Function;
 
@@ -152,8 +152,8 @@ class S3Repository extends BlobStoreRepository {
         final RepositoryMetaData metadata,
         final NamedXContentRegistry namedXContentRegistry,
         final S3Service service,
-        final ThreadPool threadPool) {
-        super(metadata, namedXContentRegistry, threadPool, buildBasePath(metadata));
+        final ClusterService clusterService) {
+        super(metadata, namedXContentRegistry, clusterService, buildBasePath(metadata));
         this.service = service;
 
         // Parse and validate the user's S3 Storage Class setting
diff --git a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3RepositoryPlugin.java b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3RepositoryPlugin.java
index 461eb9e9592cf..0661d40ec804f 100644
--- a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3RepositoryPlugin.java
+++ b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3RepositoryPlugin.java
@@ -22,6 +22,7 @@
 import com.amazonaws.util.json.Jackson;
 import org.elasticsearch.SpecialPermission;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -30,7 +31,6 @@
 import org.elasticsearch.plugins.ReloadablePlugin;
 import org.elasticsearch.plugins.RepositoryPlugin;
 import org.elasticsearch.repositories.Repository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
 import java.security.AccessController;
@@ -79,14 +79,14 @@ public S3RepositoryPlugin(final Settings settings) {
     protected S3Repository createRepository(
         final RepositoryMetaData metadata,
         final NamedXContentRegistry registry,
-        final ThreadPool threadPool) {
-        return new S3Repository(metadata, registry, service, threadPool);
+        final ClusterService clusterService) {
+        return new S3Repository(metadata, registry, service, clusterService);
     }
 
     @Override
     public Map<String, Repository.Factory> getRepositories(final Environment env, final NamedXContentRegistry registry,
-                                                           final ThreadPool threadPool) {
-        return Collections.singletonMap(S3Repository.TYPE, metadata -> createRepository(metadata, registry, threadPool));
+                                                           final ClusterService clusterService) {
+        return Collections.singletonMap(S3Repository.TYPE, metadata -> createRepository(metadata, registry, clusterService));
     }
 
     @Override
diff --git a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/RepositoryCredentialsTests.java b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/RepositoryCredentialsTests.java
index f7d5ba021e25c..45a79af102df4 100644
--- a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/RepositoryCredentialsTests.java
+++ b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/RepositoryCredentialsTests.java
@@ -25,6 +25,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.MockSecureSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -32,7 +33,6 @@
 import org.elasticsearch.plugins.PluginsService;
 import org.elasticsearch.repositories.RepositoriesService;
 import org.elasticsearch.test.ESSingleNodeTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.Collection;
 import java.util.List;
@@ -146,8 +146,8 @@ public ProxyS3RepositoryPlugin(Settings settings) {
 
         @Override
         protected S3Repository createRepository(RepositoryMetaData metadata,
-                                                NamedXContentRegistry registry, ThreadPool threadPool) {
-            return new S3Repository(metadata, registry, service, threadPool) {
+                                                NamedXContentRegistry registry, ClusterService clusterService) {
+            return new S3Repository(metadata, registry, service, clusterService) {
                 @Override
                 protected void assertSnapshotOrGenericThread() {
                     // eliminate thread name check as we create repo manually on test/main threads
diff --git a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreRepositoryTests.java b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreRepositoryTests.java
index 16dd4cdc27e0b..3c26c99f8a528 100644
--- a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreRepositoryTests.java
+++ b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreRepositoryTests.java
@@ -23,6 +23,7 @@
 import com.sun.net.httpserver.HttpHandler;
 import fixture.s3.S3HttpHandler;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.SuppressForbidden;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobPath;
@@ -35,7 +36,6 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.repositories.blobstore.ESMockAPIBasedRepositoryIntegTestCase;
 import org.elasticsearch.snapshots.mockstore.BlobStoreWrapper;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -109,8 +109,9 @@ public List<Setting<?>> getSettings() {
         }
 
         @Override
-        protected S3Repository createRepository(RepositoryMetaData metadata, NamedXContentRegistry registry, ThreadPool threadPool) {
-            return new S3Repository(metadata, registry, service, threadPool) {
+        protected S3Repository createRepository(RepositoryMetaData metadata, NamedXContentRegistry registry,
+                                                ClusterService clusterService) {
+            return new S3Repository(metadata, registry, service, clusterService) {
 
                 @Override
                 public BlobStore blobStore() {
diff --git a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3RepositoryTests.java b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3RepositoryTests.java
index 45177dbebbf48..3466fd89ebbf9 100644
--- a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3RepositoryTests.java
+++ b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3RepositoryTests.java
@@ -26,8 +26,8 @@
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.repositories.RepositoryException;
+import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 import org.hamcrest.Matchers;
 
 import java.util.Map;
@@ -36,7 +36,6 @@
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.nullValue;
-import static org.mockito.Mockito.mock;
 
 public class S3RepositoryTests extends ESTestCase {
 
@@ -120,7 +119,7 @@ public void testDefaultBufferSize() {
     }
 
     private S3Repository createS3Repo(RepositoryMetaData metadata) {
-        return new S3Repository(metadata, NamedXContentRegistry.EMPTY, new DummyS3Service(), mock(ThreadPool.class)) {
+        return new S3Repository(metadata, NamedXContentRegistry.EMPTY, new DummyS3Service(), BlobStoreTestUtil.mockClusterService()) {
             @Override
             protected void assertSnapshotOrGenericThread() {
                 // eliminate thread name check as we create repo manually on test/main threads
diff --git a/server/src/main/java/org/elasticsearch/cluster/RepositoryCleanupInProgress.java b/server/src/main/java/org/elasticsearch/cluster/RepositoryCleanupInProgress.java
index f9be2d326980d..7c43c03ae6d40 100644
--- a/server/src/main/java/org/elasticsearch/cluster/RepositoryCleanupInProgress.java
+++ b/server/src/main/java/org/elasticsearch/cluster/RepositoryCleanupInProgress.java
@@ -24,6 +24,7 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.repositories.RepositoryOperation;
 
 import java.io.IOException;
 import java.util.Arrays;
@@ -94,7 +95,7 @@ public Version getMinimalSupportedVersion() {
         return Version.V_7_4_0;
     }
 
-    public static final class Entry implements Writeable {
+    public static final class Entry implements Writeable, RepositoryOperation {
 
         private final String repository;
 
@@ -110,6 +111,12 @@ public Entry(String repository, long repositoryStateId) {
             this.repositoryStateId = repositoryStateId;
         }
 
+        @Override
+        public long repositoryStateId() {
+            return repositoryStateId;
+        }
+
+        @Override
         public String repository() {
             return repository;
         }
diff --git a/server/src/main/java/org/elasticsearch/cluster/SnapshotDeletionsInProgress.java b/server/src/main/java/org/elasticsearch/cluster/SnapshotDeletionsInProgress.java
index 2ac12d3e93922..9c25c5578f315 100644
--- a/server/src/main/java/org/elasticsearch/cluster/SnapshotDeletionsInProgress.java
+++ b/server/src/main/java/org/elasticsearch/cluster/SnapshotDeletionsInProgress.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.repositories.RepositoryOperation;
 import org.elasticsearch.snapshots.Snapshot;
 
 import java.io.IOException;
@@ -164,7 +165,7 @@ public String toString() {
     /**
      * A class representing a snapshot deletion request entry in the cluster state.
      */
-    public static final class Entry implements Writeable {
+    public static final class Entry implements Writeable, RepositoryOperation {
         private final Snapshot snapshot;
         private final long startTime;
         private final long repositoryStateId;
@@ -195,13 +196,6 @@ public long getStartTime() {
             return startTime;
         }
 
-        /**
-         * The repository state id at the time the snapshot deletion began.
-         */
-        public long getRepositoryStateId() {
-            return repositoryStateId;
-        }
-
         @Override
         public boolean equals(Object o) {
             if (this == o) {
@@ -227,5 +221,15 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeVLong(startTime);
             out.writeLong(repositoryStateId);
         }
+
+        @Override
+        public String repository() {
+            return snapshot.getRepository();
+        }
+
+        @Override
+        public long repositoryStateId() {
+            return repositoryStateId;
+        }
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/cluster/SnapshotsInProgress.java b/server/src/main/java/org/elasticsearch/cluster/SnapshotsInProgress.java
index b40d771c64739..7ddecd8b2fdb3 100644
--- a/server/src/main/java/org/elasticsearch/cluster/SnapshotsInProgress.java
+++ b/server/src/main/java/org/elasticsearch/cluster/SnapshotsInProgress.java
@@ -34,6 +34,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.repositories.IndexId;
+import org.elasticsearch.repositories.RepositoryOperation;
 import org.elasticsearch.snapshots.Snapshot;
 import org.elasticsearch.snapshots.SnapshotsService;
 
@@ -81,7 +82,7 @@ public String toString() {
         return builder.append("]").toString();
     }
 
-    public static class Entry implements ToXContent {
+    public static class Entry implements ToXContent, RepositoryOperation {
         private final State state;
         private final Snapshot snapshot;
         private final boolean includeGlobalState;
@@ -153,6 +154,11 @@ public Entry(Entry entry, ImmutableOpenMap<ShardId, ShardSnapshotStatus> shards)
             this(entry, entry.state, shards, entry.failure);
         }
 
+        @Override
+        public String repository() {
+            return snapshot.getRepository();
+        }
+
         public Snapshot snapshot() {
             return this.snapshot;
         }
@@ -189,7 +195,8 @@ public long startTime() {
             return startTime;
         }
 
-        public long getRepositoryStateId() {
+        @Override
+        public long repositoryStateId() {
             return repositoryStateId;
         }
 
diff --git a/server/src/main/java/org/elasticsearch/plugins/RepositoryPlugin.java b/server/src/main/java/org/elasticsearch/plugins/RepositoryPlugin.java
index ede5c5e3611f9..1ac61b27fd1ae 100644
--- a/server/src/main/java/org/elasticsearch/plugins/RepositoryPlugin.java
+++ b/server/src/main/java/org/elasticsearch/plugins/RepositoryPlugin.java
@@ -22,10 +22,10 @@
 import java.util.Collections;
 import java.util.Map;
 
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.repositories.Repository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 /**
  * An extension point for {@link Plugin} implementations to add custom snapshot repositories.
@@ -41,7 +41,7 @@ public interface RepositoryPlugin {
      * the value is a factory to construct the {@link Repository} interface.
      */
     default Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-            ThreadPool threadPool) {
+                                                            ClusterService clusterService) {
         return Collections.emptyMap();
     }
 
@@ -55,7 +55,7 @@ default Map<String, Repository.Factory> getRepositories(Environment env, NamedXC
      * the value is a factory to construct the {@link Repository} interface.
      */
     default Map<String, Repository.Factory> getInternalRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                                    ThreadPool threadPool) {
+                                                                    ClusterService clusterService) {
         return Collections.emptyMap();
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/repositories/FilterRepository.java b/server/src/main/java/org/elasticsearch/repositories/FilterRepository.java
index 7f4d5ec5c1fda..76645834fb112 100644
--- a/server/src/main/java/org/elasticsearch/repositories/FilterRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/FilterRepository.java
@@ -20,6 +20,7 @@
 
 import org.apache.lucene.index.IndexCommit;
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
@@ -133,6 +134,11 @@ public IndexShardSnapshotStatus getShardSnapshotStatus(SnapshotId snapshotId, In
         return in.getShardSnapshotStatus(snapshotId, indexId, shardId);
     }
 
+    @Override
+    public void updateState(ClusterState state) {
+        in.updateState(state);
+    }
+
     @Override
     public Lifecycle.State lifecycleState() {
         return in.lifecycleState();
diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoriesModule.java b/server/src/main/java/org/elasticsearch/repositories/RepositoriesModule.java
index 783e3ff78fc4d..f87aab460fcbc 100644
--- a/server/src/main/java/org/elasticsearch/repositories/RepositoriesModule.java
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoriesModule.java
@@ -43,10 +43,10 @@ public final class RepositoriesModule {
     public RepositoriesModule(Environment env, List<RepositoryPlugin> repoPlugins, TransportService transportService,
                               ClusterService clusterService, ThreadPool threadPool, NamedXContentRegistry namedXContentRegistry) {
         Map<String, Repository.Factory> factories = new HashMap<>();
-        factories.put(FsRepository.TYPE, metadata -> new FsRepository(metadata, env, namedXContentRegistry, threadPool));
+        factories.put(FsRepository.TYPE, metadata -> new FsRepository(metadata, env, namedXContentRegistry, clusterService));
 
         for (RepositoryPlugin repoPlugin : repoPlugins) {
-            Map<String, Repository.Factory> newRepoTypes = repoPlugin.getRepositories(env, namedXContentRegistry, threadPool);
+            Map<String, Repository.Factory> newRepoTypes = repoPlugin.getRepositories(env, namedXContentRegistry, clusterService);
             for (Map.Entry<String, Repository.Factory> entry : newRepoTypes.entrySet()) {
                 if (factories.put(entry.getKey(), entry.getValue()) != null) {
                     throw new IllegalArgumentException("Repository type [" + entry.getKey() + "] is already registered");
@@ -56,7 +56,7 @@ public RepositoriesModule(Environment env, List<RepositoryPlugin> repoPlugins, T
 
         Map<String, Repository.Factory> internalFactories = new HashMap<>();
         for (RepositoryPlugin repoPlugin : repoPlugins) {
-            Map<String, Repository.Factory> newRepoTypes = repoPlugin.getInternalRepositories(env, namedXContentRegistry, threadPool);
+            Map<String, Repository.Factory> newRepoTypes = repoPlugin.getInternalRepositories(env, namedXContentRegistry, clusterService);
             for (Map.Entry<String, Repository.Factory> entry : newRepoTypes.entrySet()) {
                 if (internalFactories.put(entry.getKey(), entry.getValue()) != null) {
                     throw new IllegalArgumentException("Internal repository type [" + entry.getKey() + "] is already registered");
diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoriesService.java b/server/src/main/java/org/elasticsearch/repositories/RepositoriesService.java
index 20f083dcff0fe..03b283c4aafe5 100644
--- a/server/src/main/java/org/elasticsearch/repositories/RepositoriesService.java
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoriesService.java
@@ -287,8 +287,9 @@ protected void doRun() {
     @Override
     public void applyClusterState(ClusterChangedEvent event) {
         try {
+            final ClusterState state = event.state();
             RepositoriesMetaData oldMetaData = event.previousState().getMetaData().custom(RepositoriesMetaData.TYPE);
-            RepositoriesMetaData newMetaData = event.state().getMetaData().custom(RepositoriesMetaData.TYPE);
+            RepositoriesMetaData newMetaData = state.getMetaData().custom(RepositoriesMetaData.TYPE);
 
             // Check if repositories got changed
             if ((oldMetaData == null && newMetaData == null) || (oldMetaData != null && oldMetaData.equals(newMetaData))) {
@@ -344,6 +345,9 @@ public void applyClusterState(ClusterChangedEvent event) {
                     }
                 }
             }
+            for (Repository repo : builder.values()) {
+                repo.updateState(state);
+            }
             repositories = Collections.unmodifiableMap(builder);
         } catch (Exception ex) {
             logger.warn("failure updating cluster state ", ex);
@@ -411,11 +415,13 @@ private Repository createRepository(RepositoryMetaData repositoryMetaData, Map<S
             throw new RepositoryException(repositoryMetaData.name(),
                 "repository type [" + repositoryMetaData.type() + "] does not exist");
         }
+        Repository repository = null;
         try {
-            Repository repository = factory.create(repositoryMetaData, factories::get);
+            repository = factory.create(repositoryMetaData, factories::get);
             repository.start();
             return repository;
         } catch (Exception e) {
+            IOUtils.closeWhileHandlingException(repository);
             logger.warn(new ParameterizedMessage("failed to create repository [{}][{}]",
                 repositoryMetaData.type(), repositoryMetaData.name()), e);
             throw new RepositoryException(repositoryMetaData.name(), "failed to create repository", e);
diff --git a/server/src/main/java/org/elasticsearch/repositories/Repository.java b/server/src/main/java/org/elasticsearch/repositories/Repository.java
index 800d1b0c19a95..fab0a448007e8 100644
--- a/server/src/main/java/org/elasticsearch/repositories/Repository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/Repository.java
@@ -20,6 +20,7 @@
 
 import org.apache.lucene.index.IndexCommit;
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
@@ -224,4 +225,13 @@ void restoreShard(Store store, SnapshotId snapshotId, IndexId indexId, ShardId s
      * @return snapshot status
      */
     IndexShardSnapshotStatus getShardSnapshotStatus(SnapshotId snapshotId, IndexId indexId, ShardId shardId);
+
+    /**
+     * Update the repository with the incoming cluster state. This method is invoked from {@link RepositoriesService#applyClusterState} and
+     * thus the same semantics as with {@link org.elasticsearch.cluster.ClusterStateApplier#applyClusterState} apply for the
+     * {@link ClusterState} that is passed here.
+     *
+     * @param state new cluster state
+     */
+    void updateState(ClusterState state);
 }
diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoryOperation.java b/server/src/main/java/org/elasticsearch/repositories/RepositoryOperation.java
new file mode 100644
index 0000000000000..4f9c140376c52
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoryOperation.java
@@ -0,0 +1,35 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.repositories;
+
+/**
+ * Coordinates of an operation that modifies a repository, assuming that repository at a specific generation.
+ */
+public interface RepositoryOperation {
+
+    /**
+     * Name of the repository affected.
+     */
+    String repository();
+
+    /**
+     * The repository state id at the time the operation began.
+     */
+    long repositoryStateId();
+}
diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index e2a2d1be4ef07..1e3076b258104 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -35,10 +35,15 @@
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.StepListener;
 import org.elasticsearch.action.support.GroupedActionListener;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.RepositoryCleanupInProgress;
+import org.elasticsearch.cluster.SnapshotDeletionsInProgress;
+import org.elasticsearch.cluster.SnapshotsInProgress;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Numbers;
 import org.elasticsearch.common.Strings;
@@ -89,6 +94,7 @@
 import org.elasticsearch.repositories.RepositoryCleanupResult;
 import org.elasticsearch.repositories.RepositoryData;
 import org.elasticsearch.repositories.RepositoryException;
+import org.elasticsearch.repositories.RepositoryOperation;
 import org.elasticsearch.repositories.RepositoryVerificationException;
 import org.elasticsearch.repositories.ShardGenerations;
 import org.elasticsearch.snapshots.ConcurrentSnapshotExecutionException;
@@ -208,15 +214,15 @@ public abstract class BlobStoreRepository extends AbstractLifecycleComponent imp
     /**
      * Constructs new BlobStoreRepository
      * @param metadata   The metadata for this repository including name and settings
-     * @param threadPool Threadpool to run long running repository manipulations on asynchronously
+     * @param clusterService ClusterService
      */
     protected BlobStoreRepository(
         final RepositoryMetaData metadata,
         final NamedXContentRegistry namedXContentRegistry,
-        final ThreadPool threadPool,
+        final ClusterService clusterService,
         final BlobPath basePath) {
         this.metadata = metadata;
-        this.threadPool = threadPool;
+        this.threadPool = clusterService.getClusterApplierService().threadPool();
         this.compress = COMPRESS_SETTING.get(metadata.settings());
         snapshotRateLimiter = getRateLimiter(metadata.settings(), "max_snapshot_bytes_per_sec", new ByteSizeValue(40, ByteSizeUnit.MB));
         restoreRateLimiter = getRateLimiter(metadata.settings(), "max_restore_bytes_per_sec", new ByteSizeValue(40, ByteSizeUnit.MB));
@@ -244,7 +250,8 @@ protected void doStart() {
     }
 
     @Override
-    protected void doStop() {}
+    protected void doStop() {
+    }
 
     @Override
     protected void doClose() {
@@ -262,6 +269,41 @@ protected void doClose() {
         }
     }
 
+    // Inspects all cluster state elements that contain a hint about what the current repository generation is and updates
+    // #latestKnownRepoGen if a newer than currently known generation is found
+    @Override
+    public void updateState(ClusterState state) {
+        if (readOnly) {
+            // No need to waste cycles, no operations can run against a read-only repository
+            return;
+        }
+        long bestGenerationFromCS = RepositoryData.EMPTY_REPO_GEN;
+        final SnapshotsInProgress snapshotsInProgress = state.custom(SnapshotsInProgress.TYPE);
+        if (snapshotsInProgress != null) {
+            bestGenerationFromCS = bestGeneration(snapshotsInProgress.entries());
+        }
+        final SnapshotDeletionsInProgress deletionsInProgress = state.custom(SnapshotDeletionsInProgress.TYPE);
+        // Don't use generation from the delete task if we already found a generation for an in progress snapshot.
+        // In this case, the generation points at the generation the repo will be in after the snapshot finishes so it may not yet exist
+        if (bestGenerationFromCS == RepositoryData.EMPTY_REPO_GEN && deletionsInProgress != null) {
+            bestGenerationFromCS = bestGeneration(deletionsInProgress.getEntries());
+        }
+        final RepositoryCleanupInProgress cleanupInProgress = state.custom(RepositoryCleanupInProgress.TYPE);
+        if (bestGenerationFromCS == RepositoryData.EMPTY_REPO_GEN && cleanupInProgress != null) {
+            bestGenerationFromCS = bestGeneration(cleanupInProgress.entries());
+        }
+
+        final long finalBestGen = bestGenerationFromCS;
+        latestKnownRepoGen.updateAndGet(known -> Math.max(known, finalBestGen));
+    }
+
+    private long bestGeneration(Collection<? extends RepositoryOperation> operations) {
+        final String repoName = metadata.name();
+        assert operations.size() <= 1 : "Assumed one or no operations but received " + operations;
+        return operations.stream().filter(e -> e.repository().equals(repoName)).mapToLong(RepositoryOperation::repositoryStateId)
+            .max().orElse(RepositoryData.EMPTY_REPO_GEN);
+    }
+
     public ThreadPool threadPool() {
         return threadPool;
     }
diff --git a/server/src/main/java/org/elasticsearch/repositories/fs/FsRepository.java b/server/src/main/java/org/elasticsearch/repositories/fs/FsRepository.java
index 61558e4f42efa..efe095eb9b6c2 100644
--- a/server/src/main/java/org/elasticsearch/repositories/fs/FsRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/fs/FsRepository.java
@@ -22,6 +22,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.blobstore.BlobStore;
 import org.elasticsearch.common.blobstore.fs.FsBlobStore;
@@ -32,7 +33,6 @@
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.repositories.RepositoryException;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.nio.file.Path;
 import java.util.function.Function;
@@ -70,8 +70,8 @@ public class FsRepository extends BlobStoreRepository {
      * Constructs a shared file system repository.
      */
     public FsRepository(RepositoryMetaData metadata, Environment environment, NamedXContentRegistry namedXContentRegistry,
-                        ThreadPool threadPool) {
-        super(metadata, namedXContentRegistry, threadPool, BlobPath.cleanPath());
+                        ClusterService clusterService) {
+        super(metadata, namedXContentRegistry, clusterService, BlobPath.cleanPath());
         this.environment = environment;
         String location = REPOSITORIES_LOCATION_SETTING.get(metadata.settings());
         if (location.isEmpty()) {
diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
index 0ac0204760ea3..c38462e240747 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
@@ -573,7 +573,7 @@ private void cleanupAfterError(Exception exception) {
                             ExceptionsHelper.stackTrace(exception),
                             0,
                             Collections.emptyList(),
-                            snapshot.getRepositoryStateId(),
+                            snapshot.repositoryStateId(),
                             snapshot.includeGlobalState(),
                             metaDataForSnapshot(snapshot, clusterService.state().metaData()),
                             snapshot.userMetadata(),
@@ -782,7 +782,7 @@ private void finalizeSnapshotDeletionFromPreviousMaster(ClusterState state) {
         if (deletionsInProgress != null && deletionsInProgress.hasDeletionsInProgress()) {
             assert deletionsInProgress.getEntries().size() == 1 : "only one in-progress deletion allowed per cluster";
             SnapshotDeletionsInProgress.Entry entry = deletionsInProgress.getEntries().get(0);
-            deleteSnapshotFromRepository(entry.getSnapshot(), null, entry.getRepositoryStateId(),
+            deleteSnapshotFromRepository(entry.getSnapshot(), null, entry.repositoryStateId(),
                 state.nodes().getMinNodeVersion());
         }
     }
@@ -852,7 +852,7 @@ public void onResponse(Void aVoid) {
                             public void onFailure(Exception e) {
                                 logger.warn("failed to clean up abandoned snapshot {} in INIT state", snapshot.snapshot());
                             }
-                        }, updatedSnapshot.getRepositoryStateId(), false);
+                        }, updatedSnapshot.repositoryStateId(), false);
                     }
                     assert updatedSnapshot.shards().size() == snapshot.shards().size()
                         : "Shard count changed during snapshot status update from [" + snapshot + "] to [" + updatedSnapshot + "]";
@@ -1037,7 +1037,7 @@ protected void doRun() {
                     failure,
                     entry.shards().size(),
                     unmodifiableList(shardFailures),
-                    entry.getRepositoryStateId(),
+                    entry.repositoryStateId(),
                     entry.includeGlobalState(),
                     metaDataForSnapshot(entry, metaData),
                     entry.userMetadata(),
@@ -1163,7 +1163,7 @@ public void deleteSnapshot(final String repositoryName, final String snapshotNam
                 if (matchedInProgress.isPresent()) {
                     matchedEntry = matchedInProgress.map(s -> s.snapshot().getSnapshotId());
                     // Derive repository generation if a snapshot is in progress because it will increment the generation when it finishes
-                    repoGenId = matchedInProgress.get().getRepositoryStateId() + 1L;
+                    repoGenId = matchedInProgress.get().repositoryStateId() + 1L;
                 }
             }
             if (matchedEntry.isPresent() == false) {
diff --git a/server/src/test/java/org/elasticsearch/repositories/RepositoriesModuleTests.java b/server/src/test/java/org/elasticsearch/repositories/RepositoriesModuleTests.java
index cd31ce121b245..1fad6f62773af 100644
--- a/server/src/test/java/org/elasticsearch/repositories/RepositoriesModuleTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/RepositoriesModuleTests.java
@@ -44,6 +44,7 @@ public class RepositoriesModuleTests extends ESTestCase {
     private RepositoryPlugin plugin2;
     private Repository.Factory factory;
     private ThreadPool threadPool;
+    private ClusterService clusterService;
 
     @Override
     public void setUp() throws Exception {
@@ -51,6 +52,7 @@ public void setUp() throws Exception {
         environment = mock(Environment.class);
         contentRegistry = mock(NamedXContentRegistry.class);
         threadPool = mock(ThreadPool.class);
+        clusterService = mock(ClusterService.class);
         plugin1 = mock(RepositoryPlugin.class);
         plugin2 = mock(RepositoryPlugin.class);
         factory = mock(Repository.Factory.class);
@@ -60,8 +62,8 @@ public void setUp() throws Exception {
     }
 
     public void testCanRegisterTwoRepositoriesWithDifferentTypes() {
-        when(plugin1.getRepositories(environment, contentRegistry, threadPool)).thenReturn(Collections.singletonMap("type1", factory));
-        when(plugin2.getRepositories(environment, contentRegistry, threadPool)).thenReturn(Collections.singletonMap("type2", factory));
+        when(plugin1.getRepositories(environment, contentRegistry, clusterService)).thenReturn(Collections.singletonMap("type1", factory));
+        when(plugin2.getRepositories(environment, contentRegistry, clusterService)).thenReturn(Collections.singletonMap("type2", factory));
 
         // Would throw
         new RepositoriesModule(
@@ -69,37 +71,37 @@ public void testCanRegisterTwoRepositoriesWithDifferentTypes() {
     }
 
     public void testCannotRegisterTwoRepositoriesWithSameTypes() {
-        when(plugin1.getRepositories(environment, contentRegistry, threadPool)).thenReturn(Collections.singletonMap("type1", factory));
-        when(plugin2.getRepositories(environment, contentRegistry, threadPool)).thenReturn(Collections.singletonMap("type1", factory));
+        when(plugin1.getRepositories(environment, contentRegistry, clusterService)).thenReturn(Collections.singletonMap("type1", factory));
+        when(plugin2.getRepositories(environment, contentRegistry, clusterService)).thenReturn(Collections.singletonMap("type1", factory));
 
         IllegalArgumentException ex = expectThrows(IllegalArgumentException.class,
-            () -> new RepositoriesModule(environment, repoPlugins, mock(TransportService.class), mock(ClusterService.class),
+            () -> new RepositoriesModule(environment, repoPlugins, mock(TransportService.class), clusterService,
                 threadPool, contentRegistry));
 
         assertEquals("Repository type [type1] is already registered", ex.getMessage());
     }
 
     public void testCannotRegisterTwoInternalRepositoriesWithSameTypes() {
-        when(plugin1.getInternalRepositories(environment, contentRegistry, threadPool))
+        when(plugin1.getInternalRepositories(environment, contentRegistry, clusterService))
             .thenReturn(Collections.singletonMap("type1", factory));
-        when(plugin2.getInternalRepositories(environment, contentRegistry, threadPool))
+        when(plugin2.getInternalRepositories(environment, contentRegistry, clusterService))
             .thenReturn(Collections.singletonMap("type1", factory));
 
         IllegalArgumentException ex = expectThrows(IllegalArgumentException.class,
-            () -> new RepositoriesModule(environment, repoPlugins, mock(TransportService.class), mock(ClusterService.class),
+            () -> new RepositoriesModule(environment, repoPlugins, mock(TransportService.class), clusterService,
                 threadPool, contentRegistry));
 
         assertEquals("Internal repository type [type1] is already registered", ex.getMessage());
     }
 
     public void testCannotRegisterNormalAndInternalRepositoriesWithSameTypes() {
-        when(plugin1.getRepositories(environment, contentRegistry, threadPool)).thenReturn(Collections.singletonMap("type1", factory));
-        when(plugin2.getInternalRepositories(environment, contentRegistry, threadPool))
+        when(plugin1.getRepositories(environment, contentRegistry, clusterService)).thenReturn(Collections.singletonMap("type1", factory));
+        when(plugin2.getInternalRepositories(environment, contentRegistry, clusterService))
             .thenReturn(Collections.singletonMap("type1", factory));
 
         IllegalArgumentException ex = expectThrows(IllegalArgumentException.class,
-            () -> new RepositoriesModule(environment, repoPlugins, mock(TransportService.class), mock(ClusterService.class),
-                threadPool, contentRegistry));
+            () -> new RepositoriesModule(environment, repoPlugins, mock(TransportService.class), clusterService, threadPool,
+                contentRegistry));
 
         assertEquals("Internal repository type [type1] is already registered as a non-internal repository", ex.getMessage());
     }
diff --git a/server/src/test/java/org/elasticsearch/repositories/RepositoriesServiceTests.java b/server/src/test/java/org/elasticsearch/repositories/RepositoriesServiceTests.java
index 0893a2568df17..2daa4afe3e149 100644
--- a/server/src/test/java/org/elasticsearch/repositories/RepositoriesServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/RepositoriesServiceTests.java
@@ -22,6 +22,7 @@
 import org.apache.lucene.index.IndexCommit;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.cluster.repositories.put.PutRepositoryRequest;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
@@ -214,6 +215,10 @@ public IndexShardSnapshotStatus getShardSnapshotStatus(SnapshotId snapshotId, In
             return null;
         }
 
+        @Override
+        public void updateState(final ClusterState state) {
+        }
+
         @Override
         public Lifecycle.State lifecycleState() {
             return null;
diff --git a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
index 59a977efe5f5d..b5d99db0a880f 100644
--- a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
@@ -193,7 +193,8 @@ public void testSnapshotWithConflictingName() throws IOException {
     private Repository createRepository() {
         Settings settings = Settings.builder().put("location", randomAlphaOfLength(10)).build();
         RepositoryMetaData repositoryMetaData = new RepositoryMetaData(randomAlphaOfLength(10), FsRepository.TYPE, settings);
-        final FsRepository repository = new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(), threadPool) {
+        final FsRepository repository = new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(),
+                                                         BlobStoreTestUtil.mockClusterService()) {
             @Override
             protected void assertSnapshotOrGenericThread() {
                 // eliminate thread name check as we create repo manually
diff --git a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
index 425ccdfe8ccc2..6d6248c446df1 100644
--- a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
@@ -41,7 +42,6 @@
 import org.elasticsearch.snapshots.SnapshotState;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.ESSingleNodeTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.nio.file.Path;
 import java.util.Arrays;
@@ -71,9 +71,9 @@ public static class FsLikeRepoPlugin extends Plugin implements RepositoryPlugin
 
         @Override
         public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                               ThreadPool threadPool) {
+                                                               ClusterService clusterService) {
             return Collections.singletonMap(REPO_TYPE,
-                (metadata) -> new FsRepository(metadata, env, namedXContentRegistry, threadPool) {
+                (metadata) -> new FsRepository(metadata, env, namedXContentRegistry, clusterService) {
                     @Override
                     protected void assertSnapshotOrGenericThread() {
                         // eliminate thread name check as we access blobStore on test/main threads
diff --git a/server/src/test/java/org/elasticsearch/repositories/fs/FsRepositoryTests.java b/server/src/test/java/org/elasticsearch/repositories/fs/FsRepositoryTests.java
index 5d5dc1d23e639..2b687fbcac228 100644
--- a/server/src/test/java/org/elasticsearch/repositories/fs/FsRepositoryTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/fs/FsRepositoryTests.java
@@ -54,6 +54,7 @@
 import org.elasticsearch.index.store.Store;
 import org.elasticsearch.indices.recovery.RecoveryState;
 import org.elasticsearch.repositories.IndexId;
+import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
 import org.elasticsearch.snapshots.Snapshot;
 import org.elasticsearch.snapshots.SnapshotId;
 import org.elasticsearch.test.DummyShardLock;
@@ -90,7 +91,8 @@ public void testSnapshotAndRestore() throws IOException, InterruptedException {
 
             int numDocs = indexDocs(directory);
             RepositoryMetaData metaData = new RepositoryMetaData("test", "fs", settings);
-            FsRepository repository = new FsRepository(metaData, new Environment(settings, null), NamedXContentRegistry.EMPTY, threadPool);
+            FsRepository repository = new FsRepository(metaData, new Environment(settings, null), NamedXContentRegistry.EMPTY,
+                BlobStoreTestUtil.mockClusterService());
             repository.start();
             final Settings indexSettings = Settings.builder().put(IndexMetaData.SETTING_INDEX_UUID, "myindexUUID").build();
             IndexSettings idxSettings = IndexSettingsModule.newIndexSettings("myindex", indexSettings);
diff --git a/server/src/test/java/org/elasticsearch/snapshots/MetadataLoadingDuringSnapshotRestoreIT.java b/server/src/test/java/org/elasticsearch/snapshots/MetadataLoadingDuringSnapshotRestoreIT.java
index 364d2efe311b9..3d65782d4824d 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/MetadataLoadingDuringSnapshotRestoreIT.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/MetadataLoadingDuringSnapshotRestoreIT.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
@@ -35,7 +36,6 @@
 import org.elasticsearch.repositories.Repository;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.snapshots.mockstore.MockRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
 import java.util.Collection;
@@ -185,8 +185,8 @@ public static class CountingMockRepository extends MockRepository {
 
         public CountingMockRepository(final RepositoryMetaData metadata,
                                       final Environment environment,
-                                      final NamedXContentRegistry namedXContentRegistry, ThreadPool threadPool) {
-            super(metadata, environment, namedXContentRegistry, threadPool);
+                                      final NamedXContentRegistry namedXContentRegistry, ClusterService clusterService) {
+            super(metadata, environment, namedXContentRegistry, clusterService);
         }
 
         @Override
@@ -206,9 +206,9 @@ public IndexMetaData getSnapshotIndexMetaData(SnapshotId snapshotId, IndexId ind
     public static class CountingMockRepositoryPlugin extends MockRepository.Plugin {
         @Override
         public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                               ThreadPool threadPool) {
+                                                               ClusterService clusterService) {
             return Collections.singletonMap("coutingmock",
-                metadata -> new CountingMockRepository(metadata, env, namedXContentRegistry, threadPool));
+                metadata -> new CountingMockRepository(metadata, env, namedXContentRegistry, clusterService));
         }
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
index c4d27ff13fca8..124bf290677bb 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
@@ -1226,23 +1226,15 @@ searchTransportService, new SearchPhaseController(searchService::createReduceCon
             private Repository.Factory getRepoFactory(Environment environment) {
                 // Run half the tests with the eventually consistent repository
                 if (blobStoreContext == null) {
-                    return metaData -> {
-                        final Repository repository = new FsRepository(metaData, environment, xContentRegistry(), threadPool) {
-                            @Override
-                            protected void assertSnapshotOrGenericThread() {
-                                // eliminate thread name check as we create repo in the test thread
-                            }
-                        };
-                        repository.start();
-                        return repository;
+                    return metaData -> new FsRepository(metaData, environment, xContentRegistry(), clusterService) {
+                        @Override
+                        protected void assertSnapshotOrGenericThread() {
+                            // eliminate thread name check as we create repo in the test thread
+                        }
                     };
                 } else {
-                    return metaData -> {
-                        final Repository repository = new MockEventuallyConsistentRepository(
-                            metaData, xContentRegistry(), deterministicTaskQueue.getThreadPool(), blobStoreContext, random());
-                        repository.start();
-                        return repository;
-                    };
+                    return metaData ->
+                        new MockEventuallyConsistentRepository(metaData, xContentRegistry(), clusterService, blobStoreContext, random());
                 }
             }
             public void restart() {
diff --git a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
index 9727dc5f28283..0931ceb494827 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
@@ -21,6 +21,7 @@
 
 import org.apache.lucene.codecs.CodecUtil;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobMetaData;
@@ -37,7 +38,6 @@
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
 import org.elasticsearch.snapshots.SnapshotInfo;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.ByteArrayInputStream;
 import java.io.IOException;
@@ -74,10 +74,10 @@ public class MockEventuallyConsistentRepository extends BlobStoreRepository {
     public MockEventuallyConsistentRepository(
         final RepositoryMetaData metadata,
         final NamedXContentRegistry namedXContentRegistry,
-        final ThreadPool threadPool,
+        final ClusterService clusterService,
         final Context context,
         final Random random) {
-        super(metadata, namedXContentRegistry, threadPool, BlobPath.cleanPath());
+        super(metadata, namedXContentRegistry, clusterService, BlobPath.cleanPath());
         this.context = context;
         this.namedXContentRegistry = namedXContentRegistry;
         this.random = random;
diff --git a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
index 5fdfbe9a93a4d..f1cf314e3158a 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
@@ -18,7 +18,6 @@
  */
 package org.elasticsearch.snapshots.mockstore;
 
-import org.apache.lucene.util.SameThreadExecutorService;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
@@ -27,10 +26,10 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.repositories.ShardGenerations;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
+import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
 import org.elasticsearch.snapshots.SnapshotId;
 import org.elasticsearch.snapshots.SnapshotInfo;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.ByteArrayInputStream;
 import java.io.IOException;
@@ -41,8 +40,6 @@
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.startsWith;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class MockEventuallyConsistentRepositoryTests extends ESTestCase {
 
@@ -50,7 +47,7 @@ public void testReadAfterWriteConsistently() throws IOException {
         MockEventuallyConsistentRepository.Context blobStoreContext = new MockEventuallyConsistentRepository.Context();
         try (BlobStoreRepository repository = new MockEventuallyConsistentRepository(
             new RepositoryMetaData("testRepo", "mockEventuallyConsistent", Settings.EMPTY),
-            xContentRegistry(), mock(ThreadPool.class), blobStoreContext, random())) {
+            xContentRegistry(), BlobStoreTestUtil.mockClusterService(), blobStoreContext, random())) {
             repository.start();
             final BlobContainer blobContainer = repository.blobStore().blobContainer(repository.basePath());
             final String blobName = randomAlphaOfLength(10);
@@ -70,7 +67,7 @@ public void testReadAfterWriteAfterReadThrows() throws IOException {
         MockEventuallyConsistentRepository.Context blobStoreContext = new MockEventuallyConsistentRepository.Context();
         try (BlobStoreRepository repository = new MockEventuallyConsistentRepository(
             new RepositoryMetaData("testRepo", "mockEventuallyConsistent", Settings.EMPTY),
-            xContentRegistry(), mock(ThreadPool.class), blobStoreContext, random())) {
+            xContentRegistry(), BlobStoreTestUtil.mockClusterService(), blobStoreContext, random())) {
             repository.start();
             final BlobContainer blobContainer = repository.blobStore().blobContainer(repository.basePath());
             final String blobName = randomAlphaOfLength(10);
@@ -86,7 +83,7 @@ public void testReadAfterDeleteAfterWriteThrows() throws IOException {
         MockEventuallyConsistentRepository.Context blobStoreContext = new MockEventuallyConsistentRepository.Context();
         try (BlobStoreRepository repository = new MockEventuallyConsistentRepository(
             new RepositoryMetaData("testRepo", "mockEventuallyConsistent", Settings.EMPTY),
-            xContentRegistry(), mock(ThreadPool.class), blobStoreContext, random())) {
+            xContentRegistry(), BlobStoreTestUtil.mockClusterService(), blobStoreContext, random())) {
             repository.start();
             final BlobContainer blobContainer = repository.blobStore().blobContainer(repository.basePath());
             final String blobName = randomAlphaOfLength(10);
@@ -104,7 +101,7 @@ public void testOverwriteRandomBlobFails() throws IOException {
         MockEventuallyConsistentRepository.Context blobStoreContext = new MockEventuallyConsistentRepository.Context();
         try (BlobStoreRepository repository = new MockEventuallyConsistentRepository(
             new RepositoryMetaData("testRepo", "mockEventuallyConsistent", Settings.EMPTY),
-            xContentRegistry(), mock(ThreadPool.class), blobStoreContext, random())) {
+            xContentRegistry(), BlobStoreTestUtil.mockClusterService(), blobStoreContext, random())) {
             repository.start();
             final BlobContainer container = repository.blobStore().blobContainer(repository.basePath());
             final String blobName = randomAlphaOfLength(10);
@@ -121,7 +118,7 @@ public void testOverwriteShardSnapBlobFails() throws IOException {
         MockEventuallyConsistentRepository.Context blobStoreContext = new MockEventuallyConsistentRepository.Context();
         try (BlobStoreRepository repository = new MockEventuallyConsistentRepository(
             new RepositoryMetaData("testRepo", "mockEventuallyConsistent", Settings.EMPTY),
-            xContentRegistry(), mock(ThreadPool.class), blobStoreContext, random())) {
+            xContentRegistry(), BlobStoreTestUtil.mockClusterService(), blobStoreContext, random())) {
             repository.start();
             final BlobContainer container =
                 repository.blobStore().blobContainer(repository.basePath().add("indices").add("someindex").add("0"));
@@ -137,13 +134,9 @@ public void testOverwriteShardSnapBlobFails() throws IOException {
 
     public void testOverwriteSnapshotInfoBlob() {
         MockEventuallyConsistentRepository.Context blobStoreContext = new MockEventuallyConsistentRepository.Context();
-        final ThreadPool threadPool = mock(ThreadPool.class);
-        when(threadPool.executor(ThreadPool.Names.SNAPSHOT)).thenReturn(new SameThreadExecutorService());
-        when(threadPool.info(ThreadPool.Names.SNAPSHOT)).thenReturn(
-            new ThreadPool.Info(ThreadPool.Names.SNAPSHOT, ThreadPool.ThreadPoolType.FIXED, randomIntBetween(1, 10)));
         try (BlobStoreRepository repository = new MockEventuallyConsistentRepository(
             new RepositoryMetaData("testRepo", "mockEventuallyConsistent", Settings.EMPTY),
-            xContentRegistry(), threadPool, blobStoreContext, random())) {
+            xContentRegistry(), BlobStoreTestUtil.mockClusterService(), blobStoreContext, random())) {
             repository.start();
 
             // We create a snap- blob for snapshot "foo" in the first generation
diff --git a/test/framework/src/main/java/org/elasticsearch/index/shard/RestoreOnlyRepository.java b/test/framework/src/main/java/org/elasticsearch/index/shard/RestoreOnlyRepository.java
index 5744504845aa6..f0118d3c0b699 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/shard/RestoreOnlyRepository.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/shard/RestoreOnlyRepository.java
@@ -20,6 +20,7 @@
 
 import org.apache.lucene.index.IndexCommit;
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
@@ -142,4 +143,8 @@ public IndexShardSnapshotStatus getShardSnapshotStatus(SnapshotId snapshotId, In
     @Override
     public void verify(String verificationToken, DiscoveryNode localNode) {
     }
+
+    @Override
+    public void updateState(final ClusterState state) {
+    }
 }
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
index 12b926f93a059..66c49db542dab 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
@@ -18,9 +18,16 @@
  */
 package org.elasticsearch.repositories.blobstore;
 
+import org.apache.lucene.util.SameThreadExecutorService;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.cluster.ClusterChangedEvent;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateApplier;
+import org.elasticsearch.cluster.ClusterStateUpdateTask;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.service.ClusterApplierService;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobMetaData;
@@ -52,9 +59,11 @@
 import java.util.Locale;
 import java.util.Map;
 import java.util.Set;
+import java.util.concurrent.CopyOnWriteArrayList;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.Executor;
 import java.util.concurrent.atomic.AtomicLong;
+import java.util.concurrent.atomic.AtomicReference;
 import java.util.stream.Collectors;
 
 import static org.elasticsearch.test.ESTestCase.randomIntBetween;
@@ -66,6 +75,11 @@
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertThat;
 import static org.junit.Assert.assertTrue;
+import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.anyString;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
 
 public final class BlobStoreTestUtil {
 
@@ -275,4 +289,40 @@ public static void assertBlobsByPrefix(BlobStoreRepository repository, BlobPath
             }
         }
     }
+
+    /**
+     * Creates a mocked {@link ClusterService} for use in {@link BlobStoreRepository} related tests that mocks out all the necessary
+     * functionality to make {@link BlobStoreRepository} work.
+     *
+     * @return Mock ClusterService
+     */
+    public static ClusterService mockClusterService() {
+        final ThreadPool threadPool = mock(ThreadPool.class);
+        when(threadPool.executor(ThreadPool.Names.SNAPSHOT)).thenReturn(new SameThreadExecutorService());
+        when(threadPool.generic()).thenReturn(new SameThreadExecutorService());
+        when(threadPool.info(ThreadPool.Names.SNAPSHOT)).thenReturn(
+            new ThreadPool.Info(ThreadPool.Names.SNAPSHOT, ThreadPool.ThreadPoolType.FIXED, randomIntBetween(1, 10)));
+        final ClusterService clusterService = mock(ClusterService.class);
+        final ClusterApplierService clusterApplierService = mock(ClusterApplierService.class);
+        when(clusterService.getClusterApplierService()).thenReturn(clusterApplierService);
+        final AtomicReference<ClusterState> currentState = new AtomicReference<>(ClusterState.EMPTY_STATE);
+        when(clusterService.state()).then(invocationOnMock -> currentState.get());
+        final List<ClusterStateApplier> appliers = new CopyOnWriteArrayList<>();
+        doAnswer(invocation -> {
+            final ClusterStateUpdateTask task = ((ClusterStateUpdateTask) invocation.getArguments()[1]);
+            final ClusterState current = currentState.get();
+            final ClusterState next = task.execute(current);
+            currentState.set(next);
+            appliers.forEach(applier -> applier.applyClusterState(
+                new ClusterChangedEvent((String) invocation.getArguments()[0], next, current)));
+            task.clusterStateProcessed((String) invocation.getArguments()[0], current, next);
+            return null;
+        }).when(clusterService).submitStateUpdateTask(anyString(), any(ClusterStateUpdateTask.class));
+        doAnswer(invocation -> {
+            appliers.add((ClusterStateApplier) invocation.getArguments()[0]);
+            return null;
+        }).when(clusterService).addStateApplier(any(ClusterStateApplier.class));
+        when(clusterApplierService.threadPool()).thenReturn(threadPool);
+        return clusterService;
+    }
 }
diff --git a/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java b/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
index 9a157e11c7227..218c6f4eecac7 100644
--- a/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
+++ b/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
@@ -25,6 +25,7 @@
 import org.apache.lucene.index.CorruptIndexException;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobMetaData;
 import org.elasticsearch.common.blobstore.BlobPath;
@@ -40,7 +41,6 @@
 import org.elasticsearch.plugins.RepositoryPlugin;
 import org.elasticsearch.repositories.Repository;
 import org.elasticsearch.repositories.fs.FsRepository;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
 import java.io.InputStream;
@@ -71,8 +71,9 @@ public static class Plugin extends org.elasticsearch.plugins.Plugin implements R
 
         @Override
         public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                               ThreadPool threadPool) {
-            return Collections.singletonMap("mock", (metadata) -> new MockRepository(metadata, env, namedXContentRegistry, threadPool));
+                                                               ClusterService clusterService) {
+            return Collections.singletonMap("mock", (metadata) ->
+                new MockRepository(metadata, env, namedXContentRegistry, clusterService));
         }
 
         @Override
@@ -113,8 +114,8 @@ public long getFailureCount() {
     private volatile boolean blocked = false;
 
     public MockRepository(RepositoryMetaData metadata, Environment environment,
-                          NamedXContentRegistry namedXContentRegistry, ThreadPool threadPool) {
-        super(overrideSettings(metadata, environment), environment, namedXContentRegistry, threadPool);
+                          NamedXContentRegistry namedXContentRegistry, ClusterService clusterService) {
+        super(overrideSettings(metadata, environment), environment, namedXContentRegistry, clusterService);
         randomControlIOExceptionRate = metadata.settings().getAsDouble("random_control_io_exception_rate", 0.0);
         randomDataFileIOExceptionRate = metadata.settings().getAsDouble("random_data_file_io_exception_rate", 0.0);
         useLuceneCorruptionException = metadata.settings().getAsBoolean("use_lucene_corruption", false);
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/Ccr.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/Ccr.java
index 9bf15e2ab030c..0fd087a47c44e 100644
--- a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/Ccr.java
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/Ccr.java
@@ -339,9 +339,10 @@ public List<ExecutorBuilder<?>> getExecutorBuilders(Settings settings) {
 
     @Override
     public Map<String, Repository.Factory> getInternalRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                                   ThreadPool threadPool) {
+                                                                   ClusterService clusterService) {
         Repository.Factory repositoryFactory =
-            (metadata) -> new CcrRepository(metadata, client, ccrLicenseChecker, settings, ccrSettings.get(), threadPool);
+            (metadata) -> new CcrRepository(metadata, client, ccrLicenseChecker, settings, ccrSettings.get(),
+                clusterService.getClusterApplierService().threadPool());
         return Collections.singletonMap(CcrRepository.TYPE, repositoryFactory);
     }
 
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/repository/CcrRepository.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/repository/CcrRepository.java
index 820a965e3b134..20c098ee7f82a 100644
--- a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/repository/CcrRepository.java
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/repository/CcrRepository.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.action.support.ThreadedActionListener;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MappingMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
@@ -420,6 +421,10 @@ public IndexShardSnapshotStatus getShardSnapshotStatus(SnapshotId snapshotId, In
         throw new UnsupportedOperationException("Unsupported for repository of type: " + TYPE);
     }
 
+    @Override
+    public void updateState(ClusterState state) {
+    }
+
     private void updateMappings(Client leaderClient, Index leaderIndex, long leaderMappingVersion,
                                 Client followerClient, Index followerIndex) {
         final PlainActionFuture<IndexMetaData> indexMetadataFuture = new PlainActionFuture<>();
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
index 1b20ceae9233e..02fd885b3e350 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
@@ -312,7 +312,7 @@ public static Path resolveConfigFile(Environment env, String name) {
 
     @Override
     public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                           ThreadPool threadPool) {
+                                                           ClusterService clusterService) {
         return Collections.singletonMap("source", SourceOnlySnapshotRepository.newRepositoryFactory());
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
index d6e94fc8ce112..899c300493ab4 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
@@ -16,6 +16,7 @@
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.block.ClusterBlockException;
 import org.elasticsearch.cluster.metadata.MappingMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
@@ -35,7 +36,6 @@
 import org.elasticsearch.search.slice.SliceBuilder;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.test.ESIntegTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
 import org.hamcrest.Matchers;
 
 import java.io.IOException;
@@ -70,7 +70,7 @@ protected boolean addMockInternalEngine() {
     public static final class MyPlugin extends Plugin implements RepositoryPlugin, EnginePlugin {
         @Override
         public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                               ThreadPool threadPool) {
+                                                               ClusterService clusterService) {
             return Collections.singletonMap("source", SourceOnlySnapshotRepository.newRepositoryFactory());
         }
         @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
index f5f8287f2c5c1..03ca8d5cfff28 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
@@ -61,6 +61,7 @@
 import org.elasticsearch.repositories.IndexId;
 import org.elasticsearch.repositories.Repository;
 import org.elasticsearch.repositories.ShardGenerations;
+import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
 import org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase;
 import org.elasticsearch.repositories.fs.FsRepository;
 import org.elasticsearch.threadpool.ThreadPool;
@@ -348,10 +349,10 @@ private Environment createEnvironment() {
     }
 
     /** Create a {@link Repository} with a random name **/
-    private Repository createRepository() throws IOException {
+    private Repository createRepository() {
         Settings settings = Settings.builder().put("location", randomAlphaOfLength(10)).build();
         RepositoryMetaData repositoryMetaData = new RepositoryMetaData(randomAlphaOfLength(10), FsRepository.TYPE, settings);
-        return new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(), threadPool);
+        return new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(), BlobStoreTestUtil.mockClusterService());
     }
 
     private static void runAsSnapshot(ThreadPool pool, Runnable runnable) {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
index 6952342040c5d..accea03f9b68a 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
@@ -406,19 +406,21 @@ public List<PersistentTasksExecutor<?>> getPersistentTasksExecutor(ClusterServic
 
     @Override
     public Map<String, Repository.Factory> getRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                           ThreadPool threadPool) {
-        HashMap<String, Repository.Factory> repositories = new HashMap<>(super.getRepositories(env, namedXContentRegistry, threadPool));
-        filterPlugins(RepositoryPlugin.class).forEach(r -> repositories.putAll(r.getRepositories(env, namedXContentRegistry, threadPool)));
+                                                           ClusterService clusterService) {
+        HashMap<String, Repository.Factory> repositories =
+            new HashMap<>(super.getRepositories(env, namedXContentRegistry, clusterService));
+        filterPlugins(RepositoryPlugin.class).forEach(
+            r -> repositories.putAll(r.getRepositories(env, namedXContentRegistry, clusterService)));
         return repositories;
     }
 
     @Override
     public Map<String, Repository.Factory> getInternalRepositories(Environment env, NamedXContentRegistry namedXContentRegistry,
-                                                                   ThreadPool threadPool) {
+                                                                   ClusterService clusterService) {
         HashMap<String, Repository.Factory> internalRepositories =
-            new HashMap<>(super.getInternalRepositories(env, namedXContentRegistry, threadPool));
+            new HashMap<>(super.getInternalRepositories(env, namedXContentRegistry, clusterService));
         filterPlugins(RepositoryPlugin.class).forEach(r ->
-            internalRepositories.putAll(r.getInternalRepositories(env, namedXContentRegistry, threadPool)));
+            internalRepositories.putAll(r.getInternalRepositories(env, namedXContentRegistry, clusterService)));
         return internalRepositories;
     }
 

From 2a4860dc50f22fdb4261cfb63c361f176e908fa3 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Fri, 29 Nov 2019 11:01:24 +0100
Subject: [PATCH 021/686] Remove obsolete resolving logic from TRA (#49685)

This stems from a time where index requests were directly forwarded to
TransportReplicationAction. Nowadays they are wrapped in a BulkShardRequest, and this logic is
obsolete.

In contrast to prior PR (#49647), this PR also fixes (see b3697cc) a situation where the previous
index expression logic had an interesting side effect. For bulk requests (which had resolveIndex
= false), the reroute phase was waiting for the index to appear in case where it was not present,
and for all other replication requests (resolveIndex = true) it would right away throw an
IndexNotFoundException while resolving the name and exit. With #49647, every replication
request was now waiting for the index to appear, which was problematic when the given index
had just been deleted (e.g. deleting a follower index while it's still receiving requests from the
leader, where these requests would now wait up to a minute for the index to appear). This PR
now adds b3697cc on top of that prior PR to make sure to reestablish some of the prior behavior
where the reroute phase waits for the bulk request for the index to appear. That logic was in
place to ensure that when an index was created and not all nodes had learned about it yet, that
the bulk would not fail somewhere in the reroute phase. This is now only restricted to the
situation where the current node has an older cluster state than the one that coordinated the
bulk request (which checks that the index is present). This also means that when an index is
deleted, we will no longer unnecessarily wait up to the timeout for the index o appear, and
instead fail the request.

Closes #20279
---
 ...TransportVerifyShardBeforeCloseAction.java |  5 +-
 .../flush/TransportShardFlushAction.java      |  5 +-
 .../refresh/TransportShardRefreshAction.java  |  5 +-
 .../action/bulk/BulkShardRequest.java         |  5 ++
 .../action/bulk/TransportBulkAction.java      |  1 +
 .../action/bulk/TransportShardBulkAction.java | 11 +--
 .../TransportResyncReplicationAction.java     |  6 +-
 .../replication/ReplicationRequest.java       |  2 +-
 .../TransportReplicationAction.java           | 89 ++++++++-----------
 .../replication/TransportWriteAction.java     |  6 +-
 .../seqno/GlobalCheckpointSyncAction.java     |  5 +-
 .../RetentionLeaseBackgroundSyncAction.java   |  5 +-
 .../index/seqno/RetentionLeaseSyncAction.java |  5 +-
 ...portVerifyShardBeforeCloseActionTests.java |  3 +-
 .../action/bulk/BulkIntegrationIT.java        | 43 +++++++++
 ...TransportResyncReplicationActionTests.java |  4 +-
 ...tReplicationActionRetryOnClosedNodeIT.java |  5 +-
 .../TransportReplicationActionTests.java      | 33 ++++---
 ...ReplicationAllPermitsAcquisitionTests.java |  3 +-
 .../TransportWriteActionTests.java            |  7 +-
 .../GlobalCheckpointSyncActionTests.java      |  4 +-
 ...tentionLeaseBackgroundSyncActionTests.java | 10 +--
 .../seqno/RetentionLeaseSyncActionTests.java  | 10 +--
 .../indices/cluster/ClusterStateChanges.java  |  2 +-
 .../snapshots/SnapshotResiliencyTests.java    |  7 +-
 .../TransportBulkShardOperationsAction.java   |  5 +-
 .../elasticsearch/xpack/CcrIntegTestCase.java |  2 +-
 27 files changed, 144 insertions(+), 144 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseAction.java
index bbd55e27e61fd..348855b7252a5 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseAction.java
@@ -32,7 +32,6 @@
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
 import org.elasticsearch.cluster.block.ClusterBlock;
 import org.elasticsearch.cluster.block.ClusterBlocks;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -60,8 +59,8 @@ public class TransportVerifyShardBeforeCloseAction extends TransportReplicationA
     public TransportVerifyShardBeforeCloseAction(final Settings settings, final TransportService transportService,
                                                  final ClusterService clusterService, final IndicesService indicesService,
                                                  final ThreadPool threadPool, final ShardStateAction stateAction,
-                                                 final ActionFilters actionFilters, final IndexNameExpressionResolver resolver) {
-        super(settings, NAME, transportService, clusterService, indicesService, threadPool, stateAction, actionFilters, resolver,
+                                                 final ActionFilters actionFilters) {
+        super(settings, NAME, transportService, clusterService, indicesService, threadPool, stateAction, actionFilters,
             ShardRequest::new, ShardRequest::new, ThreadPool.Names.MANAGEMENT);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportShardFlushAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportShardFlushAction.java
index 4b01329e8b4ff..077657cc62dd4 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportShardFlushAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportShardFlushAction.java
@@ -25,7 +25,6 @@
 import org.elasticsearch.action.support.replication.ReplicationResponse;
 import org.elasticsearch.action.support.replication.TransportReplicationAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -46,9 +45,9 @@ public class TransportShardFlushAction
     @Inject
     public TransportShardFlushAction(Settings settings, TransportService transportService, ClusterService clusterService,
                                      IndicesService indicesService, ThreadPool threadPool, ShardStateAction shardStateAction,
-                                     ActionFilters actionFilters, IndexNameExpressionResolver indexNameExpressionResolver) {
+                                     ActionFilters actionFilters) {
         super(settings, NAME, transportService, clusterService, indicesService, threadPool, shardStateAction,
-            actionFilters, indexNameExpressionResolver, ShardFlushRequest::new, ShardFlushRequest::new, ThreadPool.Names.FLUSH);
+            actionFilters, ShardFlushRequest::new, ShardFlushRequest::new, ThreadPool.Names.FLUSH);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/refresh/TransportShardRefreshAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/refresh/TransportShardRefreshAction.java
index dd981aa995992..a0ce70503958c 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/refresh/TransportShardRefreshAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/refresh/TransportShardRefreshAction.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.action.support.replication.ReplicationResponse;
 import org.elasticsearch.action.support.replication.TransportReplicationAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -48,9 +47,9 @@ public class TransportShardRefreshAction
     @Inject
     public TransportShardRefreshAction(Settings settings, TransportService transportService, ClusterService clusterService,
                                        IndicesService indicesService, ThreadPool threadPool, ShardStateAction shardStateAction,
-                                       ActionFilters actionFilters, IndexNameExpressionResolver indexNameExpressionResolver) {
+                                       ActionFilters actionFilters) {
         super(settings, NAME, transportService, clusterService, indicesService, threadPool, shardStateAction, actionFilters,
-                indexNameExpressionResolver, BasicReplicationRequest::new, BasicReplicationRequest::new, ThreadPool.Names.REFRESH);
+                BasicReplicationRequest::new, BasicReplicationRequest::new, ThreadPool.Names.REFRESH);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/BulkShardRequest.java b/server/src/main/java/org/elasticsearch/action/bulk/BulkShardRequest.java
index 29e00c20446bb..0f05f071ad4f3 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/BulkShardRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/BulkShardRequest.java
@@ -118,6 +118,11 @@ public String getDescription() {
         return stringBuilder.toString();
     }
 
+    @Override
+    protected BulkShardRequest routedBasedOnClusterVersion(long routedBasedOnClusterVersion) {
+        return super.routedBasedOnClusterVersion(routedBasedOnClusterVersion);
+    }
+
     @Override
     public void onRetry() {
         for (BulkItemRequest item : items) {
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java b/server/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java
index f21ab304c49ec..6a8912cc1dc82 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java
@@ -486,6 +486,7 @@ protected void doRun() {
                         requests.toArray(new BulkItemRequest[requests.size()]));
                 bulkShardRequest.waitForActiveShards(bulkRequest.waitForActiveShards());
                 bulkShardRequest.timeout(bulkRequest.timeout());
+                bulkShardRequest.routedBasedOnClusterVersion(clusterState.version());
                 if (task != null) {
                     bulkShardRequest.setParentTask(nodeId, task.getId());
                 }
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/TransportShardBulkAction.java b/server/src/main/java/org/elasticsearch/action/bulk/TransportShardBulkAction.java
index c322af9a9d3e5..e709c24bc64c7 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/TransportShardBulkAction.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/TransportShardBulkAction.java
@@ -44,7 +44,6 @@
 import org.elasticsearch.cluster.action.index.MappingUpdatedAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MappingMetaData;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.bytes.BytesReference;
@@ -93,10 +92,9 @@ public class TransportShardBulkAction extends TransportWriteAction<BulkShardRequ
     @Inject
     public TransportShardBulkAction(Settings settings, TransportService transportService, ClusterService clusterService,
                                     IndicesService indicesService, ThreadPool threadPool, ShardStateAction shardStateAction,
-                                    MappingUpdatedAction mappingUpdatedAction, UpdateHelper updateHelper, ActionFilters actionFilters,
-                                    IndexNameExpressionResolver indexNameExpressionResolver) {
+                                    MappingUpdatedAction mappingUpdatedAction, UpdateHelper updateHelper, ActionFilters actionFilters) {
         super(settings, ACTION_NAME, transportService, clusterService, indicesService, threadPool, shardStateAction, actionFilters,
-        indexNameExpressionResolver, BulkShardRequest::new, BulkShardRequest::new, ThreadPool.Names.WRITE, false);
+            BulkShardRequest::new, BulkShardRequest::new, ThreadPool.Names.WRITE, false);
         this.updateHelper = updateHelper;
         this.mappingUpdatedAction = mappingUpdatedAction;
     }
@@ -111,11 +109,6 @@ protected BulkShardResponse newResponseInstance(StreamInput in) throws IOExcepti
         return new BulkShardResponse(in);
     }
 
-    @Override
-    protected boolean resolveIndex() {
-        return false;
-    }
-
     @Override
     protected void shardOperationOnPrimary(BulkShardRequest request, IndexShard primary,
             ActionListener<PrimaryResult<BulkShardRequest, BulkShardResponse>> listener) {
diff --git a/server/src/main/java/org/elasticsearch/action/resync/TransportResyncReplicationAction.java b/server/src/main/java/org/elasticsearch/action/resync/TransportResyncReplicationAction.java
index 095f5e27a62fb..94dde512aa105 100644
--- a/server/src/main/java/org/elasticsearch/action/resync/TransportResyncReplicationAction.java
+++ b/server/src/main/java/org/elasticsearch/action/resync/TransportResyncReplicationAction.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.action.support.replication.TransportWriteAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
@@ -55,10 +54,9 @@ public class TransportResyncReplicationAction extends TransportWriteAction<Resyn
     @Inject
     public TransportResyncReplicationAction(Settings settings, TransportService transportService,
                                             ClusterService clusterService, IndicesService indicesService, ThreadPool threadPool,
-                                            ShardStateAction shardStateAction, ActionFilters actionFilters,
-                                            IndexNameExpressionResolver indexNameExpressionResolver) {
+                                            ShardStateAction shardStateAction, ActionFilters actionFilters) {
         super(settings, ACTION_NAME, transportService, clusterService, indicesService, threadPool, shardStateAction, actionFilters,
-            indexNameExpressionResolver, ResyncReplicationRequest::new, ResyncReplicationRequest::new, ThreadPool.Names.WRITE,
+            ResyncReplicationRequest::new, ResyncReplicationRequest::new, ThreadPool.Names.WRITE,
             true /* we should never reject resync because of thread pool capacity on primary */);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/support/replication/ReplicationRequest.java b/server/src/main/java/org/elasticsearch/action/support/replication/ReplicationRequest.java
index 8a7f4df17be25..c06ea2e8721be 100644
--- a/server/src/main/java/org/elasticsearch/action/support/replication/ReplicationRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/support/replication/ReplicationRequest.java
@@ -169,7 +169,7 @@ public final Request waitForActiveShards(final int waitForActiveShards) {
      * Used to prevent redirect loops, see also {@link TransportReplicationAction.ReroutePhase#doRun()}
      */
     @SuppressWarnings("unchecked")
-    Request routedBasedOnClusterVersion(long routedBasedOnClusterVersion) {
+    protected Request routedBasedOnClusterVersion(long routedBasedOnClusterVersion) {
         this.routedBasedOnClusterVersion = routedBasedOnClusterVersion;
         return (Request) this;
     }
diff --git a/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java b/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
index 1fe2abf6698bd..c72f10b35c372 100644
--- a/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
+++ b/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
@@ -40,10 +40,8 @@
 import org.elasticsearch.cluster.block.ClusterBlockException;
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.routing.AllocationId;
-import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Nullable;
@@ -104,7 +102,6 @@ public abstract class TransportReplicationAction<
     protected final ClusterService clusterService;
     protected final ShardStateAction shardStateAction;
     protected final IndicesService indicesService;
-    protected final IndexNameExpressionResolver indexNameExpressionResolver;
     protected final TransportRequestOptions transportOptions;
     protected final String executor;
 
@@ -117,19 +114,17 @@ public abstract class TransportReplicationAction<
     protected TransportReplicationAction(Settings settings, String actionName, TransportService transportService,
                                          ClusterService clusterService, IndicesService indicesService,
                                          ThreadPool threadPool, ShardStateAction shardStateAction,
-                                         ActionFilters actionFilters,
-                                         IndexNameExpressionResolver indexNameExpressionResolver, Writeable.Reader<Request> requestReader,
+                                         ActionFilters actionFilters, Writeable.Reader<Request> requestReader,
                                          Writeable.Reader<ReplicaRequest> replicaRequestReader, String executor) {
         this(settings, actionName, transportService, clusterService, indicesService, threadPool, shardStateAction, actionFilters,
-                indexNameExpressionResolver, requestReader, replicaRequestReader, executor, false, false);
+                requestReader, replicaRequestReader, executor, false, false);
     }
 
 
     protected TransportReplicationAction(Settings settings, String actionName, TransportService transportService,
                                          ClusterService clusterService, IndicesService indicesService,
                                          ThreadPool threadPool, ShardStateAction shardStateAction,
-                                         ActionFilters actionFilters,
-                                         IndexNameExpressionResolver indexNameExpressionResolver, Writeable.Reader<Request> requestReader,
+                                         ActionFilters actionFilters, Writeable.Reader<Request> requestReader,
                                          Writeable.Reader<ReplicaRequest> replicaRequestReader, String executor,
                                          boolean syncGlobalCheckpointAfterOperation, boolean forceExecutionOnPrimary) {
         super(actionName, actionFilters, transportService.getTaskManager());
@@ -138,7 +133,6 @@ protected TransportReplicationAction(Settings settings, String actionName, Trans
         this.clusterService = clusterService;
         this.indicesService = indicesService;
         this.shardStateAction = shardStateAction;
-        this.indexNameExpressionResolver = indexNameExpressionResolver;
         this.executor = executor;
 
         this.transportPrimaryAction = actionName + "[p]";
@@ -219,21 +213,10 @@ public ClusterBlockLevel indexBlockLevel() {
         return null;
     }
 
-    /**
-     * True if provided index should be resolved when resolving request
-     */
-    protected boolean resolveIndex() {
-        return true;
-    }
-
     protected TransportRequestOptions transportOptions(Settings settings) {
         return TransportRequestOptions.EMPTY;
     }
 
-    private String concreteIndex(final ClusterState state, final ReplicationRequest request) {
-        return resolveIndex() ? indexNameExpressionResolver.concreteSingleIndex(state, request).getName() : request.index();
-    }
-
     private ClusterBlockException blockExceptions(final ClusterState state, final String indexName) {
         ClusterBlockLevel globalBlockLevel = globalBlockLevel();
         if (globalBlockLevel != null) {
@@ -648,8 +631,7 @@ public void onFailure(Exception e) {
         protected void doRun() {
             setPhase(task, "routing");
             final ClusterState state = observer.setAndGetObservedState();
-            final String concreteIndex = concreteIndex(state, request);
-            final ClusterBlockException blockException = blockExceptions(state, concreteIndex);
+            final ClusterBlockException blockException = blockExceptions(state, request.shardId().getIndexName());
             if (blockException != null) {
                 if (blockException.retryable()) {
                     logger.trace("cluster is blocked, scheduling a retry", blockException);
@@ -658,23 +640,47 @@ protected void doRun() {
                     finishAsFailed(blockException);
                 }
             } else {
-                // request does not have a shardId yet, we need to pass the concrete index to resolve shardId
-                final IndexMetaData indexMetaData = state.metaData().index(concreteIndex);
+                final IndexMetaData indexMetaData = state.metaData().index(request.shardId().getIndex());
                 if (indexMetaData == null) {
-                    retry(new IndexNotFoundException(concreteIndex));
-                    return;
+                    // ensure that the cluster state on the node is at least as high as the node that decided that the index was there
+                    if (state.version() < request.routedBasedOnClusterVersion()) {
+                        logger.trace("failed to find index [{}] for request [{}] despite sender thinking it would be here. " +
+                                "Local cluster state version [{}]] is older than on sending node (version [{}]), scheduling a retry...",
+                            request.shardId().getIndex(), request, state.version(), request.routedBasedOnClusterVersion());
+                        retry(new IndexNotFoundException("failed to find index as current cluster state with version [" + state.version() +
+                            "] is stale (expected at least [" + request.routedBasedOnClusterVersion() + "]",
+                            request.shardId().getIndexName()));
+                        return;
+                    } else {
+                        finishAsFailed(new IndexNotFoundException(request.shardId().getIndex()));
+                        return;
+                    }
                 }
+
                 if (indexMetaData.getState() == IndexMetaData.State.CLOSE) {
-                    throw new IndexClosedException(indexMetaData.getIndex());
+                    finishAsFailed(new IndexClosedException(indexMetaData.getIndex()));
+                    return;
                 }
 
-                // resolve all derived request fields, so we can route and apply it
-                resolveRequest(indexMetaData, request);
+                if (request.waitForActiveShards() == ActiveShardCount.DEFAULT) {
+                    // if the wait for active shard count has not been set in the request,
+                    // resolve it from the index settings
+                    request.waitForActiveShards(indexMetaData.getWaitForActiveShards());
+                }
                 assert request.waitForActiveShards() != ActiveShardCount.DEFAULT :
                     "request waitForActiveShards must be set in resolveRequest";
 
-                final ShardRouting primary = primary(state);
-                if (retryIfUnavailable(state, primary)) {
+                final ShardRouting primary = state.getRoutingTable().shardRoutingTable(request.shardId()).primaryShard();
+                if (primary == null || primary.active() == false) {
+                    logger.trace("primary shard [{}] is not yet active, scheduling a retry: action [{}], request [{}], "
+                        + "cluster state version [{}]", request.shardId(), actionName, request, state.version());
+                    retryBecauseUnavailable(request.shardId(), "primary shard is not active");
+                    return;
+                }
+                if (state.nodes().nodeExists(primary.currentNodeId()) == false) {
+                    logger.trace("primary shard [{}] is assigned to an unknown node [{}], scheduling a retry: action [{}], request [{}], "
+                        + "cluster state version [{}]", request.shardId(), primary.currentNodeId(), actionName, request, state.version());
+                    retryBecauseUnavailable(request.shardId(), "primary shard isn't assigned to a known node.");
                     return;
                 }
                 final DiscoveryNode node = state.nodes().get(primary.currentNodeId());
@@ -718,27 +724,6 @@ private void performRemoteAction(ClusterState state, ShardRouting primary, Disco
             performAction(node, actionName, false, request);
         }
 
-        private boolean retryIfUnavailable(ClusterState state, ShardRouting primary) {
-            if (primary == null || primary.active() == false) {
-                logger.trace("primary shard [{}] is not yet active, scheduling a retry: action [{}], request [{}], "
-                    + "cluster state version [{}]", request.shardId(), actionName, request, state.version());
-                retryBecauseUnavailable(request.shardId(), "primary shard is not active");
-                return true;
-            }
-            if (state.nodes().nodeExists(primary.currentNodeId()) == false) {
-                logger.trace("primary shard [{}] is assigned to an unknown node [{}], scheduling a retry: action [{}], request [{}], "
-                    + "cluster state version [{}]", request.shardId(), primary.currentNodeId(), actionName, request, state.version());
-                retryBecauseUnavailable(request.shardId(), "primary shard isn't assigned to a known node.");
-                return true;
-            }
-            return false;
-        }
-
-        private ShardRouting primary(ClusterState state) {
-            IndexShardRoutingTable indexShard = state.getRoutingTable().shardRoutingTable(request.shardId());
-            return indexShard.primaryShard();
-        }
-
         private void performAction(final DiscoveryNode node, final String action, final boolean isPrimaryAction,
                                    final TransportRequest requestToPerform) {
             transportService.sendRequest(node, action, requestToPerform, transportOptions, new TransportResponseHandler<Response>() {
diff --git a/server/src/main/java/org/elasticsearch/action/support/replication/TransportWriteAction.java b/server/src/main/java/org/elasticsearch/action/support/replication/TransportWriteAction.java
index 86e2760c9012d..104d3517815c0 100644
--- a/server/src/main/java/org/elasticsearch/action/support/replication/TransportWriteAction.java
+++ b/server/src/main/java/org/elasticsearch/action/support/replication/TransportWriteAction.java
@@ -28,7 +28,6 @@
 import org.elasticsearch.action.support.WriteResponse;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Nullable;
@@ -61,11 +60,10 @@ public abstract class TransportWriteAction<
 
     protected TransportWriteAction(Settings settings, String actionName, TransportService transportService,
                                    ClusterService clusterService, IndicesService indicesService, ThreadPool threadPool,
-                                   ShardStateAction shardStateAction, ActionFilters actionFilters,
-                                   IndexNameExpressionResolver indexNameExpressionResolver, Writeable.Reader<Request> request,
+                                   ShardStateAction shardStateAction, ActionFilters actionFilters, Writeable.Reader<Request> request,
                                    Writeable.Reader<ReplicaRequest> replicaRequest, String executor, boolean forceExecutionOnPrimary) {
         super(settings, actionName, transportService, clusterService, indicesService, threadPool, shardStateAction, actionFilters,
-              indexNameExpressionResolver, request, replicaRequest, executor, true, forceExecutionOnPrimary);
+              request, replicaRequest, executor, true, forceExecutionOnPrimary);
     }
 
     /** Syncs operation result to the translog or throws a shard not available failure */
diff --git a/server/src/main/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncAction.java b/server/src/main/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncAction.java
index cd79aa9d60e2e..0cdecbf4306dc 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncAction.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncAction.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.action.support.replication.ReplicationResponse;
 import org.elasticsearch.action.support.replication.TransportReplicationAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -61,8 +60,7 @@ public GlobalCheckpointSyncAction(
             final IndicesService indicesService,
             final ThreadPool threadPool,
             final ShardStateAction shardStateAction,
-            final ActionFilters actionFilters,
-            final IndexNameExpressionResolver indexNameExpressionResolver) {
+            final ActionFilters actionFilters) {
         super(
                 settings,
                 ACTION_NAME,
@@ -72,7 +70,6 @@ public GlobalCheckpointSyncAction(
                 threadPool,
                 shardStateAction,
                 actionFilters,
-                indexNameExpressionResolver,
                 Request::new,
                 Request::new,
                 ThreadPool.Names.MANAGEMENT);
diff --git a/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncAction.java b/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncAction.java
index e3d3fed4a5107..1f6dd80a9f82e 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncAction.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncAction.java
@@ -32,7 +32,6 @@
 import org.elasticsearch.action.support.replication.ReplicationTask;
 import org.elasticsearch.action.support.replication.TransportReplicationAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -81,8 +80,7 @@ public RetentionLeaseBackgroundSyncAction(
             final IndicesService indicesService,
             final ThreadPool threadPool,
             final ShardStateAction shardStateAction,
-            final ActionFilters actionFilters,
-            final IndexNameExpressionResolver indexNameExpressionResolver) {
+            final ActionFilters actionFilters) {
         super(
                 settings,
                 ACTION_NAME,
@@ -92,7 +90,6 @@ public RetentionLeaseBackgroundSyncAction(
                 threadPool,
                 shardStateAction,
                 actionFilters,
-                indexNameExpressionResolver,
                 Request::new,
                 Request::new,
                 ThreadPool.Names.MANAGEMENT);
diff --git a/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeaseSyncAction.java b/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeaseSyncAction.java
index b93deccd51474..44da33186983a 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeaseSyncAction.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeaseSyncAction.java
@@ -34,7 +34,6 @@
 import org.elasticsearch.action.support.replication.TransportWriteAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -78,8 +77,7 @@ public RetentionLeaseSyncAction(
             final IndicesService indicesService,
             final ThreadPool threadPool,
             final ShardStateAction shardStateAction,
-            final ActionFilters actionFilters,
-            final IndexNameExpressionResolver indexNameExpressionResolver) {
+            final ActionFilters actionFilters) {
         super(
                 settings,
                 ACTION_NAME,
@@ -89,7 +87,6 @@ public RetentionLeaseSyncAction(
                 threadPool,
                 shardStateAction,
                 actionFilters,
-                indexNameExpressionResolver,
                 RetentionLeaseSyncAction.Request::new,
                 RetentionLeaseSyncAction.Request::new,
                 ThreadPool.Names.MANAGEMENT, false);
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseActionTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseActionTests.java
index 6913b518d2464..ba48eabadcca4 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseActionTests.java
@@ -33,7 +33,6 @@
 import org.elasticsearch.cluster.block.ClusterBlock;
 import org.elasticsearch.cluster.block.ClusterBlocks;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MetaDataIndexStateService;
 import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
 import org.elasticsearch.cluster.routing.ShardRouting;
@@ -119,7 +118,7 @@ public void setUp() throws Exception {
 
         ShardStateAction shardStateAction = new ShardStateAction(clusterService, transportService, null, null, threadPool);
         action = new TransportVerifyShardBeforeCloseAction(Settings.EMPTY, transportService, clusterService, mock(IndicesService.class),
-            mock(ThreadPool.class), shardStateAction, mock(ActionFilters.class), mock(IndexNameExpressionResolver.class));
+            mock(ThreadPool.class), shardStateAction, mock(ActionFilters.class));
     }
 
     @Override
diff --git a/server/src/test/java/org/elasticsearch/action/bulk/BulkIntegrationIT.java b/server/src/test/java/org/elasticsearch/action/bulk/BulkIntegrationIT.java
index bbd3be0b87920..93603ac5b5e27 100644
--- a/server/src/test/java/org/elasticsearch/action/bulk/BulkIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/action/bulk/BulkIntegrationIT.java
@@ -20,13 +20,16 @@
 
 package org.elasticsearch.action.bulk;
 
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.action.admin.indices.alias.Alias;
 import org.elasticsearch.action.admin.indices.mapping.get.GetMappingsResponse;
 import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.action.index.IndexResponse;
 import org.elasticsearch.action.ingest.PutPipelineRequest;
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
+import org.elasticsearch.action.support.replication.ReplicationRequest;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -43,12 +46,19 @@
 import java.util.Collections;
 import java.util.Map;
 import java.util.concurrent.ExecutionException;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.concurrent.atomic.AtomicInteger;
 
+import static org.elasticsearch.action.DocWriteResponse.Result.CREATED;
+import static org.elasticsearch.action.DocWriteResponse.Result.UPDATED;
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
 import static org.elasticsearch.test.StreamsUtils.copyToStringFromClasspath;
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.greaterThanOrEqualTo;
+import static org.hamcrest.Matchers.isOneOf;
 
 public class BulkIntegrationIT extends ESIntegTestCase {
     @Override
@@ -156,4 +166,37 @@ private void createSamplePipeline(String pipelineId) throws IOException, Executi
 
         assertTrue(acknowledgedResponse.isAcknowledged());
     }
+
+    /** This test ensures that index deletion makes indexing fail quickly, not wait on the index that has disappeared */
+    public void testDeleteIndexWhileIndexing() throws Exception {
+        String index = "deleted_while_indexing";
+        createIndex(index);
+        AtomicBoolean stopped = new AtomicBoolean();
+        Thread[] threads = new Thread[between(1, 4)];
+        AtomicInteger docID = new AtomicInteger();
+        for (int i = 0; i < threads.length; i++) {
+            threads[i] = new Thread(() -> {
+                while (stopped.get() == false && docID.get() < 5000) {
+                    String id = Integer.toString(docID.incrementAndGet());
+                    try {
+                        IndexResponse response = client().prepareIndex(index).setId(id)
+                            .setSource(Map.of("f" + randomIntBetween(1, 10), randomNonNegativeLong()), XContentType.JSON).get();
+                        assertThat(response.getResult(), isOneOf(CREATED, UPDATED));
+                        logger.info("--> index id={} seq_no={}", response.getId(), response.getSeqNo());
+                    } catch (ElasticsearchException ignore) {
+                        logger.info("--> fail to index id={}", id);
+                    }
+                }
+            });
+            threads[i].start();
+        }
+        ensureGreen(index);
+        assertBusy(() -> assertThat(docID.get(), greaterThanOrEqualTo(1)));
+        assertAcked(client().admin().indices().prepareDelete(index));
+        stopped.set(true);
+        for (Thread thread : threads) {
+            thread.join(ReplicationRequest.DEFAULT_TIMEOUT.millis() / 2);
+            assertFalse(thread.isAlive());
+        }
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/action/resync/TransportResyncReplicationActionTests.java b/server/src/test/java/org/elasticsearch/action/resync/TransportResyncReplicationActionTests.java
index d54317f114328..752114832bff1 100644
--- a/server/src/test/java/org/elasticsearch/action/resync/TransportResyncReplicationActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/resync/TransportResyncReplicationActionTests.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.cluster.block.ClusterBlocks;
 import org.elasticsearch.cluster.coordination.NoMasterBlockService;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.routing.ShardRoutingState;
@@ -143,9 +142,8 @@ public void testResyncDoesNotBlockOnPrimaryAction() throws Exception {
                 final IndicesService indexServices = mock(IndicesService.class);
                 when(indexServices.indexServiceSafe(eq(index))).thenReturn(indexService);
 
-                final IndexNameExpressionResolver resolver = new IndexNameExpressionResolver();
                 final TransportResyncReplicationAction action = new TransportResyncReplicationAction(Settings.EMPTY, transportService,
-                    clusterService, indexServices, threadPool, shardStateAction, new ActionFilters(new HashSet<>()), resolver);
+                    clusterService, indexServices, threadPool, shardStateAction, new ActionFilters(new HashSet<>()));
 
                 assertThat(action.globalBlockLevel(), nullValue());
                 assertThat(action.indexBlockLevel(), nullValue());
diff --git a/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationActionRetryOnClosedNodeIT.java b/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationActionRetryOnClosedNodeIT.java
index 58564fee58c06..160e37f1e8f77 100644
--- a/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationActionRetryOnClosedNodeIT.java
+++ b/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationActionRetryOnClosedNodeIT.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
@@ -102,9 +101,9 @@ public static class TestAction extends TransportReplicationAction<Request, Reque
         @Inject
         public TestAction(Settings settings, TransportService transportService, ClusterService clusterService,
                           IndicesService indicesService, ThreadPool threadPool, ShardStateAction shardStateAction,
-                          ActionFilters actionFilters, IndexNameExpressionResolver indexNameExpressionResolver) {
+                          ActionFilters actionFilters) {
             super(settings, ACTION_NAME, transportService, clusterService, indicesService, threadPool, shardStateAction, actionFilters,
-                indexNameExpressionResolver, Request::new, Request::new, ThreadPool.Names.GENERIC);
+                Request::new, Request::new, ThreadPool.Names.GENERIC);
         }
 
         @Override
diff --git a/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationActionTests.java b/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationActionTests.java
index 462bec274d78c..396ba1ca2301d 100644
--- a/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationActionTests.java
@@ -40,7 +40,6 @@
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
 import org.elasticsearch.cluster.block.ClusterBlocks;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.cluster.routing.AllocationId;
@@ -235,10 +234,12 @@ public ClusterBlockLevel indexBlockLevel() {
 
         setState(clusterService, ClusterStateCreationUtils.stateWithActivePrimary("index", true, 0));
 
+        ShardId shardId = new ShardId(clusterService.state().metaData().index("index").getIndex(), 0);
+
         {
             setStateWithBlock(clusterService, nonRetryableBlock, globalBlock);
 
-            Request request = globalBlock ? new Request(NO_SHARD_ID) : new Request(NO_SHARD_ID).index("index");
+            Request request = new Request(shardId);
             PlainActionFuture<TestResponse> listener = new PlainActionFuture<>();
             ReplicationTask task = maybeTask();
 
@@ -253,7 +254,7 @@ public ClusterBlockLevel indexBlockLevel() {
         {
             setStateWithBlock(clusterService, retryableBlock, globalBlock);
 
-            Request requestWithTimeout = (globalBlock ? new Request(NO_SHARD_ID) : new Request(NO_SHARD_ID).index("index")).timeout("5ms");
+            Request requestWithTimeout = (globalBlock ? new Request(shardId) : new Request(shardId)).timeout("5ms");
             PlainActionFuture<TestResponse> listener = new PlainActionFuture<>();
             ReplicationTask task = maybeTask();
 
@@ -269,7 +270,7 @@ public ClusterBlockLevel indexBlockLevel() {
         {
             setStateWithBlock(clusterService, retryableBlock, globalBlock);
 
-            Request request = globalBlock ? new Request(NO_SHARD_ID) : new Request(NO_SHARD_ID).index("index");
+            Request request = new Request(shardId);
             PlainActionFuture<TestResponse> listener = new PlainActionFuture<>();
             ReplicationTask task = maybeTask();
 
@@ -487,6 +488,7 @@ public void testUnknownIndexOrShardOnReroute() {
         setState(clusterService, state(index, true,
             randomBoolean() ? ShardRoutingState.INITIALIZING : ShardRoutingState.UNASSIGNED));
         logger.debug("--> using initial state:\n{}", clusterService.state());
+
         Request request = new Request(new ShardId("unknown_index", "_na_", 0)).timeout("1ms");
         PlainActionFuture<TestResponse> listener = new PlainActionFuture<>();
         ReplicationTask task = maybeTask();
@@ -495,7 +497,21 @@ public void testUnknownIndexOrShardOnReroute() {
         reroutePhase.run();
         assertListenerThrows("must throw index not found exception", listener, IndexNotFoundException.class);
         assertPhase(task, "failed");
+        assertFalse(request.isRetrySet.get());
+
+        // try again with a request that is based on a newer cluster state, make sure we waited until that
+        // cluster state for the index to appear
+        request = new Request(new ShardId("unknown_index", "_na_", 0)).timeout("1ms");
+        request.routedBasedOnClusterVersion(clusterService.state().version() + 1);
+        listener = new PlainActionFuture<>();
+        task = maybeTask();
+
+        reroutePhase = action.new ReroutePhase(task, request, listener);
+        reroutePhase.run();
+        assertListenerThrows("must throw index not found exception", listener, IndexNotFoundException.class);
+        assertPhase(task, "failed");
         assertTrue(request.isRetrySet.get());
+
         request = new Request(new ShardId(index, "_na_", 10)).timeout("1ms");
         listener = new PlainActionFuture<>();
         reroutePhase = action.new ReroutePhase(null, request, listener);
@@ -513,7 +529,7 @@ public void testClosedIndexOnReroute() {
             new CloseIndexRequest(index)));
         assertThat(clusterService.state().metaData().indices().get(index).getState(), equalTo(IndexMetaData.State.CLOSE));
         logger.debug("--> using initial state:\n{}", clusterService.state());
-        Request request = new Request(new ShardId("test", "_na_", 0)).timeout("1ms");
+        Request request = new Request(new ShardId(clusterService.state().metaData().indices().get(index).getIndex(), 0)).timeout("1ms");
         PlainActionFuture<TestResponse> listener = new PlainActionFuture<>();
         ReplicationTask task = maybeTask();
 
@@ -1245,7 +1261,7 @@ private class TestAction extends TransportReplicationAction<Request, Request, Te
                    ThreadPool threadPool, IndicesService indicesService) {
             super(settings, actionName, transportService, clusterService, indicesService, threadPool,
                 shardStateAction,
-                new ActionFilters(new HashSet<>()), new IndexNameExpressionResolver(),
+                new ActionFilters(new HashSet<>()),
                 Request::new, Request::new, ThreadPool.Names.SAME);
         }
 
@@ -1267,11 +1283,6 @@ protected ReplicaResult shardOperationOnReplica(Request request, IndexShard repl
             request.processedOnReplicas.incrementAndGet();
             return new ReplicaResult();
         }
-
-        @Override
-        protected boolean resolveIndex() {
-            return false;
-        }
     }
 
     private IndicesService mockIndicesService(ClusterService clusterService) {
diff --git a/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationAllPermitsAcquisitionTests.java b/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationAllPermitsAcquisitionTests.java
index 2560191a706d5..bda6a68030f70 100644
--- a/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationAllPermitsAcquisitionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/replication/TransportReplicationAllPermitsAcquisitionTests.java
@@ -30,7 +30,6 @@
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
 import org.elasticsearch.cluster.block.ClusterBlocks;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.node.DiscoveryNodeRole;
@@ -418,7 +417,7 @@ private abstract class TestAction extends TransportReplicationAction<Request, Re
                    SetOnce<Boolean> executedOnPrimary) {
             super(settings, actionName, transportService, clusterService, mockIndicesService(shardId, executedOnPrimary, primary, replica),
                 threadPool, shardStateAction,
-                new ActionFilters(new HashSet<>()), new IndexNameExpressionResolver(), Request::new, Request::new, ThreadPool.Names.SAME);
+                new ActionFilters(new HashSet<>()), Request::new, Request::new, ThreadPool.Names.SAME);
             this.shardId = Objects.requireNonNull(shardId);
             this.primary = Objects.requireNonNull(primary);
             assertEquals(shardId, primary.shardId());
diff --git a/server/src/test/java/org/elasticsearch/action/support/replication/TransportWriteActionTests.java b/server/src/test/java/org/elasticsearch/action/support/replication/TransportWriteActionTests.java
index e12151595d552..c22613b9c291f 100644
--- a/server/src/test/java/org/elasticsearch/action/support/replication/TransportWriteActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/replication/TransportWriteActionTests.java
@@ -31,7 +31,6 @@
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
 import org.elasticsearch.cluster.routing.RoutingNode;
 import org.elasticsearch.cluster.routing.ShardRouting;
@@ -399,8 +398,7 @@ protected TestAction(boolean withDocumentFailureOnPrimary, boolean withDocumentF
             super(Settings.EMPTY, "internal:test",
                     new TransportService(Settings.EMPTY, mock(Transport.class), null, TransportService.NOOP_TRANSPORT_INTERCEPTOR,
                         x -> null, null, Collections.emptySet()), null, null, null, null,
-                new ActionFilters(new HashSet<>()), new IndexNameExpressionResolver(), TestRequest::new,
-                    TestRequest::new, ThreadPool.Names.SAME, false);
+                new ActionFilters(new HashSet<>()), TestRequest::new, TestRequest::new, ThreadPool.Names.SAME, false);
             this.withDocumentFailureOnPrimary = withDocumentFailureOnPrimary;
             this.withDocumentFailureOnReplica = withDocumentFailureOnReplica;
         }
@@ -409,8 +407,7 @@ protected TestAction(Settings settings, String actionName, TransportService tran
                              ClusterService clusterService, ShardStateAction shardStateAction, ThreadPool threadPool) {
             super(settings, actionName, transportService, clusterService,
                     mockIndicesService(clusterService), threadPool, shardStateAction,
-                    new ActionFilters(new HashSet<>()), new IndexNameExpressionResolver(),
-                    TestRequest::new, TestRequest::new, ThreadPool.Names.SAME, false);
+                    new ActionFilters(new HashSet<>()), TestRequest::new, TestRequest::new, ThreadPool.Names.SAME, false);
             this.withDocumentFailureOnPrimary = false;
             this.withDocumentFailureOnReplica = false;
         }
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncActionTests.java b/server/src/test/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncActionTests.java
index 79b9b231b48d4..8a1dc44a3e3c7 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncActionTests.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncActionTests.java
@@ -20,7 +20,6 @@
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.ActionTestUtils;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.internal.io.IOUtils;
@@ -110,8 +109,7 @@ public void testTranslogSyncAfterGlobalCheckpointSync() throws Exception {
             indicesService,
             threadPool,
             shardStateAction,
-            new ActionFilters(Collections.emptySet()),
-            new IndexNameExpressionResolver());
+            new ActionFilters(Collections.emptySet()));
         final GlobalCheckpointSyncAction.Request primaryRequest = new GlobalCheckpointSyncAction.Request(indexShard.shardId());
         if (randomBoolean()) {
             action.shardOperationOnPrimary(primaryRequest, indexShard, ActionTestUtils.assertNoFailureListener(r -> {}));
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncActionTests.java b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncActionTests.java
index 2be10a80fe793..282170a58e3e3 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncActionTests.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncActionTests.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.action.support.ActionTestUtils;
 import org.elasticsearch.action.support.replication.TransportReplicationAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.internal.io.IOUtils;
@@ -106,8 +105,7 @@ public void testRetentionLeaseBackgroundSyncActionOnPrimary() throws Interrupted
                 indicesService,
                 threadPool,
                 shardStateAction,
-                new ActionFilters(Collections.emptySet()),
-                new IndexNameExpressionResolver());
+                new ActionFilters(Collections.emptySet()));
         final RetentionLeases retentionLeases = mock(RetentionLeases.class);
         final RetentionLeaseBackgroundSyncAction.Request request =
                 new RetentionLeaseBackgroundSyncAction.Request(indexShard.shardId(), retentionLeases);
@@ -144,8 +142,7 @@ public void testRetentionLeaseBackgroundSyncActionOnReplica() throws WriteStateE
                 indicesService,
                 threadPool,
                 shardStateAction,
-                new ActionFilters(Collections.emptySet()),
-                new IndexNameExpressionResolver());
+                new ActionFilters(Collections.emptySet()));
         final RetentionLeases retentionLeases = mock(RetentionLeases.class);
         final RetentionLeaseBackgroundSyncAction.Request request =
                 new RetentionLeaseBackgroundSyncAction.Request(indexShard.shardId(), retentionLeases);
@@ -182,8 +179,7 @@ public void testBlocks() {
                 indicesService,
                 threadPool,
                 shardStateAction,
-                new ActionFilters(Collections.emptySet()),
-                new IndexNameExpressionResolver());
+                new ActionFilters(Collections.emptySet()));
 
         assertNull(action.indexBlockLevel());
     }
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseSyncActionTests.java b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseSyncActionTests.java
index 14dbb1cc5eed8..a63722d93666a 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseSyncActionTests.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseSyncActionTests.java
@@ -22,7 +22,6 @@
 import org.elasticsearch.action.support.ActionTestUtils;
 import org.elasticsearch.action.support.replication.TransportWriteAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.internal.io.IOUtils;
@@ -102,8 +101,7 @@ public void testRetentionLeaseSyncActionOnPrimary() {
                 indicesService,
                 threadPool,
                 shardStateAction,
-                new ActionFilters(Collections.emptySet()),
-                new IndexNameExpressionResolver());
+                new ActionFilters(Collections.emptySet()));
         final RetentionLeases retentionLeases = mock(RetentionLeases.class);
         final RetentionLeaseSyncAction.Request request = new RetentionLeaseSyncAction.Request(indexShard.shardId(), retentionLeases);
         action.shardOperationOnPrimary(request, indexShard,
@@ -139,8 +137,7 @@ public void testRetentionLeaseSyncActionOnReplica() throws WriteStateException {
                 indicesService,
                 threadPool,
                 shardStateAction,
-                new ActionFilters(Collections.emptySet()),
-                new IndexNameExpressionResolver());
+                new ActionFilters(Collections.emptySet()));
         final RetentionLeases retentionLeases = mock(RetentionLeases.class);
         final RetentionLeaseSyncAction.Request request = new RetentionLeaseSyncAction.Request(indexShard.shardId(), retentionLeases);
 
@@ -177,8 +174,7 @@ public void testBlocks() {
                 indicesService,
                 threadPool,
                 shardStateAction,
-                new ActionFilters(Collections.emptySet()),
-                new IndexNameExpressionResolver());
+                new ActionFilters(Collections.emptySet()));
 
         assertNull(action.indexBlockLevel());
     }
diff --git a/server/src/test/java/org/elasticsearch/indices/cluster/ClusterStateChanges.java b/server/src/test/java/org/elasticsearch/indices/cluster/ClusterStateChanges.java
index 3d3ba3b8cf7b1..74b94ad3a16b4 100644
--- a/server/src/test/java/org/elasticsearch/indices/cluster/ClusterStateChanges.java
+++ b/server/src/test/java/org/elasticsearch/indices/cluster/ClusterStateChanges.java
@@ -194,7 +194,7 @@ public IndexMetaData upgradeIndexMetaData(IndexMetaData indexMetaData, Version m
         NodeClient client = new NodeClient(Settings.EMPTY, threadPool);
         Map<ActionType, TransportAction> actions = new HashMap<>();
         actions.put(TransportVerifyShardBeforeCloseAction.TYPE, new TransportVerifyShardBeforeCloseAction(SETTINGS,
-            transportService, clusterService, indicesService, threadPool, null, actionFilters, indexNameExpressionResolver));
+            transportService, clusterService, indicesService, threadPool, null, actionFilters));
         client.initialize(actions, transportService.getTaskManager(), null, null);
 
         MetaDataIndexStateService indexStateService = new MetaDataIndexStateService(clusterService, allocationService,
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
index 124bf290677bb..28d2beb2efcc4 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
@@ -1108,7 +1108,7 @@ public void onFailure(final Exception e) {
                 Map<ActionType, TransportAction> actions = new HashMap<>();
                 actions.put(GlobalCheckpointSyncAction.TYPE,
                     new GlobalCheckpointSyncAction(settings, transportService, clusterService, indicesService,
-                        threadPool, shardStateAction, actionFilters, indexNameExpressionResolver));
+                        threadPool, shardStateAction, actionFilters));
                 final MetaDataMappingService metaDataMappingService = new MetaDataMappingService(clusterService, indicesService);
                 indicesClusterStateService = new IndicesClusterStateService(
                     settings,
@@ -1132,8 +1132,7 @@ public void onFailure(final Exception e) {
                             indicesService,
                             threadPool,
                             shardStateAction,
-                            actionFilters,
-                            indexNameExpressionResolver)),
+                            actionFilters)),
                     RetentionLeaseSyncer.EMPTY,
                     client);
                 final MetaDataCreateIndexService metaDataCreateIndexService = new MetaDataCreateIndexService(settings, clusterService,
@@ -1159,7 +1158,7 @@ allocationService, new AliasValidator(), environment, indexScopedSettings,
                     ));
                 final TransportShardBulkAction transportShardBulkAction = new TransportShardBulkAction(settings, transportService,
                     clusterService, indicesService, threadPool, shardStateAction, mappingUpdatedAction, new UpdateHelper(scriptService),
-                    actionFilters, indexNameExpressionResolver);
+                    actionFilters);
                 actions.put(TransportShardBulkAction.TYPE, transportShardBulkAction);
                 final RestoreService restoreService = new RestoreService(
                     clusterService, repositoriesService, allocationService,
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/bulk/TransportBulkShardOperationsAction.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/bulk/TransportBulkShardOperationsAction.java
index 984e915b175f6..8c4374fac3629 100644
--- a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/bulk/TransportBulkShardOperationsAction.java
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/bulk/TransportBulkShardOperationsAction.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.replication.TransportWriteAction;
 import org.elasticsearch.cluster.action.shard.ShardStateAction;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.inject.Inject;
@@ -44,8 +43,7 @@ public TransportBulkShardOperationsAction(
             final IndicesService indicesService,
             final ThreadPool threadPool,
             final ShardStateAction shardStateAction,
-            final ActionFilters actionFilters,
-            final IndexNameExpressionResolver indexNameExpressionResolver) {
+            final ActionFilters actionFilters) {
         super(
                 settings,
                 BulkShardOperationsAction.NAME,
@@ -55,7 +53,6 @@ public TransportBulkShardOperationsAction(
                 threadPool,
                 shardStateAction,
                 actionFilters,
-                indexNameExpressionResolver,
                 BulkShardOperationsRequest::new,
                 BulkShardOperationsRequest::new,
                 ThreadPool.Names.WRITE, false);
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
index 873bce2a50f57..cc48c080ac8ce 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
@@ -401,7 +401,7 @@ protected void ensureNoCcrTasks() throws Exception {
                     numNodeTasks++;
                 }
             }
-            assertThat(numNodeTasks, equalTo(0));
+            assertThat(listTasksResponse.getTasks().toString(), numNodeTasks, equalTo(0));
         }, 30, TimeUnit.SECONDS);
     }
 

From b7bac252ba10d2747ed775cc7b2e5008026b3859 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Fri, 29 Nov 2019 10:32:57 +0000
Subject: [PATCH 022/686] Fix BWC assertion in GetFieldMappingsResponse
 (#49706)

Closes #49702
---
 .../indices/mapping/get/GetFieldMappingsResponse.java      | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/get/GetFieldMappingsResponse.java b/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/get/GetFieldMappingsResponse.java
index bd4fbc5f82af5..c57ebbb942f68 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/get/GetFieldMappingsResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/get/GetFieldMappingsResponse.java
@@ -36,6 +36,7 @@
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Objects;
@@ -66,7 +67,11 @@ public class GetFieldMappingsResponse extends ActionResponse implements ToXConte
             String index = in.readString();
             if (in.getVersion().before(Version.V_8_0_0)) {
                 int typesSize = in.readVInt();
-                assert typesSize == 1;
+                assert typesSize == 1 || typesSize == 0 : "Expected 0 or 1 types but got " + typesSize;
+                if (typesSize == 0) {
+                    indexMapBuilder.put(index, Collections.emptyMap());
+                    continue;
+                }
                 in.readString(); // type
             }
             int fieldSize = in.readVInt();

From cc54d9306b04cda127bc2f89eb94eeb8c1b1ec9d Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Fri, 29 Nov 2019 11:39:51 +0000
Subject: [PATCH 023/686] New setting to prevent automatically importing
 dangling indices (#49174)

Introduce a new static setting, `gateway.auto_import_dangling_indices`, which prevents dangling indices from being automatically imported. Part of #48366.
---
 .../common/settings/ClusterSettings.java      |  2 +
 .../gateway/DanglingIndicesState.java         | 24 ++++-
 .../gateway/DanglingIndicesStateTests.java    | 71 +++++++++++++-
 .../indices/recovery/DanglingIndicesIT.java   | 95 +++++++++++++++++++
 .../indices/recovery/IndexRecoveryIT.java     |  1 -
 .../test/InternalTestCluster.java             |  2 +-
 6 files changed, 188 insertions(+), 7 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java

diff --git a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
index 4548448719a68..ef40f05a2f261 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
@@ -70,6 +70,7 @@
 import org.elasticsearch.discovery.SettingsBasedSeedHostsProvider;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
+import org.elasticsearch.gateway.DanglingIndicesState;
 import org.elasticsearch.gateway.GatewayService;
 import org.elasticsearch.gateway.IncrementalClusterStateWriter;
 import org.elasticsearch.http.HttpTransportSettings;
@@ -186,6 +187,7 @@ public void apply(Settings value, Settings current, Settings previous) {
             BalancedShardsAllocator.THRESHOLD_SETTING,
             ClusterRebalanceAllocationDecider.CLUSTER_ROUTING_ALLOCATION_ALLOW_REBALANCE_SETTING,
             ConcurrentRebalanceAllocationDecider.CLUSTER_ROUTING_ALLOCATION_CLUSTER_CONCURRENT_REBALANCE_SETTING,
+            DanglingIndicesState.AUTO_IMPORT_DANGLING_INDICES_SETTING,
             EnableAllocationDecider.CLUSTER_ROUTING_ALLOCATION_ENABLE_SETTING,
             EnableAllocationDecider.CLUSTER_ROUTING_REBALANCE_ENABLE_SETTING,
             FilterAllocationDecider.CLUSTER_ROUTING_INCLUDE_GROUP_SETTING,
diff --git a/server/src/main/java/org/elasticsearch/gateway/DanglingIndicesState.java b/server/src/main/java/org/elasticsearch/gateway/DanglingIndicesState.java
index d649c02af4e77..701a85fd90e50 100644
--- a/server/src/main/java/org/elasticsearch/gateway/DanglingIndicesState.java
+++ b/server/src/main/java/org/elasticsearch/gateway/DanglingIndicesState.java
@@ -30,6 +30,7 @@
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
+import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.util.concurrent.ConcurrentCollections;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.Index;
@@ -55,9 +56,17 @@ public class DanglingIndicesState implements ClusterStateListener {
 
     private static final Logger logger = LogManager.getLogger(DanglingIndicesState.class);
 
+    public static final Setting<Boolean> AUTO_IMPORT_DANGLING_INDICES_SETTING = Setting.boolSetting(
+        "gateway.auto_import_dangling_indices",
+        true,
+        Setting.Property.NodeScope,
+        Setting.Property.Deprecated
+    );
+
     private final NodeEnvironment nodeEnv;
     private final MetaStateService metaStateService;
     private final LocalAllocateDangledIndices allocateDangledIndices;
+    private final boolean isAutoImportDanglingIndicesEnabled;
 
     private final Map<Index, IndexMetaData> danglingIndices = ConcurrentCollections.newConcurrentMap();
 
@@ -67,7 +76,18 @@ public DanglingIndicesState(NodeEnvironment nodeEnv, MetaStateService metaStateS
         this.nodeEnv = nodeEnv;
         this.metaStateService = metaStateService;
         this.allocateDangledIndices = allocateDangledIndices;
-        clusterService.addListener(this);
+
+        this.isAutoImportDanglingIndicesEnabled = AUTO_IMPORT_DANGLING_INDICES_SETTING.get(clusterService.getSettings());
+
+        if (this.isAutoImportDanglingIndicesEnabled) {
+            clusterService.addListener(this);
+        } else {
+            logger.warn(AUTO_IMPORT_DANGLING_INDICES_SETTING.getKey() + " is disabled, dangling indices will not be detected or imported");
+        }
+    }
+
+    boolean isAutoImportDanglingIndicesEnabled() {
+        return this.isAutoImportDanglingIndicesEnabled;
     }
 
     /**
@@ -171,7 +191,7 @@ private IndexMetaData stripAliases(IndexMetaData indexMetaData) {
      * Allocates the provided list of the dangled indices by sending them to the master node
      * for allocation.
      */
-    private void allocateDanglingIndices() {
+    void allocateDanglingIndices() {
         if (danglingIndices.isEmpty()) {
             return;
         }
diff --git a/server/src/test/java/org/elasticsearch/gateway/DanglingIndicesStateTests.java b/server/src/test/java/org/elasticsearch/gateway/DanglingIndicesStateTests.java
index e7dfbadeeda78..42c546e192812 100644
--- a/server/src/test/java/org/elasticsearch/gateway/DanglingIndicesStateTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/DanglingIndicesStateTests.java
@@ -35,8 +35,12 @@
 import java.nio.file.StandardCopyOption;
 import java.util.Map;
 
+import static org.elasticsearch.gateway.DanglingIndicesState.AUTO_IMPORT_DANGLING_INDICES_SETTING;
 import static org.hamcrest.Matchers.equalTo;
+import static org.mockito.Matchers.any;
 import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
 
 public class DanglingIndicesStateTests extends ESTestCase {
 
@@ -46,6 +50,13 @@ public class DanglingIndicesStateTests extends ESTestCase {
             .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
             .build();
 
+    // The setting AUTO_IMPORT_DANGLING_INDICES_SETTING is deprecated, so we must disable
+    // warning checks or all the tests will fail.
+    @Override
+    protected boolean enableWarningsCheck() {
+        return false;
+    }
+
     public void testCleanupWhenEmpty() throws Exception {
         try (NodeEnvironment env = newNodeEnvironment()) {
             MetaStateService metaStateService = new MetaStateService(env, xContentRegistry());
@@ -57,11 +68,11 @@ public void testCleanupWhenEmpty() throws Exception {
             assertTrue(danglingState.getDanglingIndices().isEmpty());
         }
     }
+
     public void testDanglingIndicesDiscovery() throws Exception {
         try (NodeEnvironment env = newNodeEnvironment()) {
             MetaStateService metaStateService = new MetaStateService(env, xContentRegistry());
             DanglingIndicesState danglingState = createDanglingIndicesState(env, metaStateService);
-
             assertTrue(danglingState.getDanglingIndices().isEmpty());
             MetaData metaData = MetaData.builder().build();
             final Settings.Builder settings = Settings.builder().put(indexSettings).put(IndexMetaData.SETTING_INDEX_UUID, "test1UUID");
@@ -155,7 +166,6 @@ public void testDanglingIndicesNotImportedWhenTombstonePresent() throws Exceptio
             final IndexGraveyard graveyard = IndexGraveyard.builder().addTombstone(dangledIndex.getIndex()).build();
             final MetaData metaData = MetaData.builder().indexGraveyard(graveyard).build();
             assertThat(danglingState.findNewDanglingIndices(metaData).size(), equalTo(0));
-
         }
     }
 
@@ -181,7 +191,62 @@ public void testDanglingIndicesStripAliases() throws Exception {
         }
     }
 
+    public void testDanglingIndicesAreNotAllocatedWhenDisabled() throws Exception {
+        try (NodeEnvironment env = newNodeEnvironment()) {
+            MetaStateService metaStateService = new MetaStateService(env, xContentRegistry());
+            LocalAllocateDangledIndices localAllocateDangledIndices = mock(LocalAllocateDangledIndices.class);
+
+            final Settings allocateSettings = Settings.builder().put(AUTO_IMPORT_DANGLING_INDICES_SETTING.getKey(), false).build();
+
+            final ClusterService clusterServiceMock = mock(ClusterService.class);
+            when(clusterServiceMock.getSettings()).thenReturn(allocateSettings);
+
+            final DanglingIndicesState danglingIndicesState = new DanglingIndicesState(
+                env,
+                metaStateService,
+                localAllocateDangledIndices,
+                clusterServiceMock
+            );
+
+            assertFalse("Expected dangling imports to be disabled", danglingIndicesState.isAutoImportDanglingIndicesEnabled());
+        }
+    }
+
+    public void testDanglingIndicesAreAllocatedWhenEnabled() throws Exception {
+        try (NodeEnvironment env = newNodeEnvironment()) {
+            MetaStateService metaStateService = new MetaStateService(env, xContentRegistry());
+            LocalAllocateDangledIndices localAllocateDangledIndices = mock(LocalAllocateDangledIndices.class);
+            final Settings allocateSettings = Settings.builder().put(AUTO_IMPORT_DANGLING_INDICES_SETTING.getKey(), true).build();
+
+            final ClusterService clusterServiceMock = mock(ClusterService.class);
+            when(clusterServiceMock.getSettings()).thenReturn(allocateSettings);
+
+            DanglingIndicesState danglingIndicesState = new DanglingIndicesState(
+                env,
+                metaStateService,
+                localAllocateDangledIndices, clusterServiceMock
+            );
+
+            assertTrue("Expected dangling imports to be enabled", danglingIndicesState.isAutoImportDanglingIndicesEnabled());
+
+            final Settings.Builder settings = Settings.builder().put(indexSettings).put(IndexMetaData.SETTING_INDEX_UUID, "test1UUID");
+            IndexMetaData dangledIndex = IndexMetaData.builder("test1").settings(settings).build();
+            metaStateService.writeIndex("test_write", dangledIndex);
+
+            danglingIndicesState.findNewAndAddDanglingIndices(MetaData.builder().build());
+
+            danglingIndicesState.allocateDanglingIndices();
+
+            verify(localAllocateDangledIndices).allocateDangled(any(), any());
+        }
+    }
+
     private DanglingIndicesState createDanglingIndicesState(NodeEnvironment env, MetaStateService metaStateService) {
-        return new DanglingIndicesState(env, metaStateService, null, mock(ClusterService.class));
+        final Settings allocateSettings = Settings.builder().put(AUTO_IMPORT_DANGLING_INDICES_SETTING.getKey(), true).build();
+
+        final ClusterService clusterServiceMock = mock(ClusterService.class);
+        when(clusterServiceMock.getSettings()).thenReturn(allocateSettings);
+
+        return new DanglingIndicesState(env, metaStateService, null, clusterServiceMock);
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java b/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java
new file mode 100644
index 0000000000000..31afef73ad450
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java
@@ -0,0 +1,95 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.indices.recovery;
+
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.test.ESIntegTestCase;
+import org.elasticsearch.test.ESIntegTestCase.ClusterScope;
+import org.elasticsearch.test.InternalTestCluster;
+
+import java.util.concurrent.TimeUnit;
+
+import static org.elasticsearch.cluster.metadata.IndexGraveyard.SETTING_MAX_TOMBSTONES;
+import static org.elasticsearch.gateway.DanglingIndicesState.AUTO_IMPORT_DANGLING_INDICES_SETTING;
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+
+@ClusterScope(numDataNodes = 0, scope = ESIntegTestCase.Scope.TEST)
+public class DanglingIndicesIT extends ESIntegTestCase {
+    private static final String INDEX_NAME = "test-idx-1";
+
+    private Settings buildSettings(boolean importDanglingIndices) {
+        return Settings.builder()
+            // Don't keep any indices in the graveyard, so that when we delete an index,
+            // it's definitely considered to be dangling.
+            .put(SETTING_MAX_TOMBSTONES.getKey(), 0)
+            .put(AUTO_IMPORT_DANGLING_INDICES_SETTING.getKey(), importDanglingIndices)
+            .build();
+    }
+
+    /**
+     * Check that when dangling indices are discovered, then they are recovered into
+     * the cluster, so long as the recovery setting is enabled.
+     */
+    public void testDanglingIndicesAreRecoveredWhenSettingIsEnabled() throws Exception {
+        final Settings settings = buildSettings(true);
+        internalCluster().startNodes(3, settings);
+
+        createIndex(INDEX_NAME, Settings.builder().put("number_of_replicas", 2).build());
+
+        // Restart node, deleting the index in its absence, so that there is a dangling index to recover
+        internalCluster().restartRandomDataNode(new InternalTestCluster.RestartCallback() {
+
+            @Override
+            public Settings onNodeStopped(String nodeName) throws Exception {
+                assertAcked(client().admin().indices().prepareDelete(INDEX_NAME));
+                return super.onNodeStopped(nodeName);
+            }
+        });
+
+        assertBusy(() -> assertTrue("Expected dangling index " + INDEX_NAME + " to be recovered", indexExists(INDEX_NAME)));
+    }
+
+    /**
+     * Check that when dangling indices are discovered, then they are not recovered into
+     * the cluster when the recovery setting is disabled.
+     */
+    public void testDanglingIndicesAreNotRecoveredWhenSettingIsDisabled() throws Exception {
+        internalCluster().startNodes(3, buildSettings(false));
+
+        createIndex(INDEX_NAME, Settings.builder().put("number_of_replicas", 2).build());
+
+        // Restart node, deleting the index in its absence, so that there is a dangling index to recover
+        internalCluster().restartRandomDataNode(new InternalTestCluster.RestartCallback() {
+
+            @Override
+            public Settings onNodeStopped(String nodeName) throws Exception {
+                assertAcked(client().admin().indices().prepareDelete(INDEX_NAME));
+                return super.onNodeStopped(nodeName);
+            }
+        });
+
+        // Since index recovery is async, we can't prove index recovery will never occur, just that it doesn't occur within some reasonable
+        // amount of time
+        assertFalse(
+            "Did not expect dangling index " + INDEX_NAME + " to be recovered",
+            waitUntil(() -> indexExists(INDEX_NAME), 1, TimeUnit.SECONDS)
+        );
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java b/server/src/test/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
index 650afbbc9ba4d..414df8d648c51 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
@@ -142,7 +142,6 @@
 public class IndexRecoveryIT extends ESIntegTestCase {
 
     private static final String INDEX_NAME = "test-idx-1";
-    private static final String INDEX_TYPE = "test-type-1";
     private static final String REPO_NAME = "test-repo-1";
     private static final String SNAP_NAME = "test-snap-1";
 
diff --git a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
index ad88d88d4941f..9b609040379eb 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
@@ -1487,7 +1487,7 @@ public synchronized boolean stopRandomDataNode() throws IOException {
     }
 
     /**
-     * Stops a random node in the cluster that applies to the given filter or non if the non of the nodes applies to the
+     * Stops a random node in the cluster that applies to the given filter. Does nothing if none of the nodes match the
      * filter.
      */
     public synchronized void stopRandomNode(final Predicate<Settings> filter) throws IOException {

From aaed7001aea8fc01a506b09766043d899c42db5d Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 29 Nov 2019 14:20:31 +0200
Subject: [PATCH 024/686] [ML] Add optional source filtering during data frame
 reindexing (#49690)

This adds a `_source` setting under the `source` setting of a data
frame analytics config. The new `_source` is reusing the structure
of a `FetchSourceContext` like `analyzed_fields` does. Specifying
includes and excludes for source allows selecting which fields
will get reindexed and will be available in the destination index.

Closes #49531
---
 .../dataframe/DataFrameAnalyticsSource.java   |  30 +++-
 .../MlClientDocumentationIT.java              |   3 +
 .../DataFrameAnalyticsSourceTests.java        |   9 ++
 .../ml/put-data-frame-analytics.asciidoc      |   1 +
 .../apis/dfanalyticsresources.asciidoc        |  32 ++--
 .../apis/put-dfanalytics.asciidoc             |  53 +++---
 .../action/PutDataFrameAnalyticsAction.java   |  20 +++
 .../dataframe/DataFrameAnalyticsConfig.java   |   2 +-
 .../dataframe/DataFrameAnalyticsSource.java   |  86 +++++++++-
 .../persistence/ElasticsearchMappings.java    |   3 +
 .../ml/job/results/ReservedFieldNames.java    |   1 +
 ...tDataFrameAnalyticsActionRequestTests.java |  44 +++++
 .../DataFrameAnalyticsSourceTests.java        |  73 ++++++++-
 .../ml/qa/ml-with-security/build.gradle       |   1 +
 .../ExplainDataFrameAnalyticsIT.java          |   3 +-
 ...NativeDataFrameAnalyticsIntegTestCase.java |   2 +-
 .../integration/RunDataFrameAnalyticsIT.java  |   6 +-
 ...ransportStartDataFrameAnalyticsAction.java |   2 +-
 .../ml/dataframe/DataFrameAnalyticsIndex.java |   6 +-
 .../dataframe/DataFrameAnalyticsManager.java  |   1 +
 .../xpack/ml/dataframe/MappingsMerger.java    |  26 +--
 .../extractor/ExtractedFieldsDetector.java    |  11 ++
 .../DataFrameAnalyticsIndexTests.java         |   2 +-
 .../ml/dataframe/MappingsMergerTests.java     |  46 +++++-
 .../dataframe/SourceDestValidatorTests.java   |   2 +-
 .../ExtractedFieldsDetectorTests.java         | 153 +++++++++++-------
 .../AnalyticsResultProcessorTests.java        |   2 +-
 .../test/ml/data_frame_analytics_crud.yml     |  28 +++-
 28 files changed, 521 insertions(+), 127 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSource.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSource.java
index 9a6de159bea3e..1f731f4c28aaa 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSource.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSource.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 
 import java.io.IOException;
 import java.util.Arrays;
@@ -44,20 +45,27 @@ public static Builder builder() {
 
     private static final ParseField INDEX = new ParseField("index");
     private static final ParseField QUERY = new ParseField("query");
+    public static final ParseField _SOURCE = new ParseField("_source");
 
     private static ObjectParser<Builder, Void> PARSER = new ObjectParser<>("data_frame_analytics_source", true, Builder::new);
 
     static {
         PARSER.declareStringArray(Builder::setIndex, INDEX);
         PARSER.declareObject(Builder::setQueryConfig, (p, c) -> QueryConfig.fromXContent(p), QUERY);
+        PARSER.declareField(Builder::setSourceFiltering,
+            (p, c) -> FetchSourceContext.fromXContent(p),
+            _SOURCE,
+            ObjectParser.ValueType.OBJECT_ARRAY_BOOLEAN_OR_STRING);
     }
 
     private final String[] index;
     private final QueryConfig queryConfig;
+    private final FetchSourceContext sourceFiltering;
 
-    private DataFrameAnalyticsSource(String[] index, @Nullable QueryConfig queryConfig) {
+    private DataFrameAnalyticsSource(String[] index, @Nullable QueryConfig queryConfig, @Nullable FetchSourceContext sourceFiltering) {
         this.index = Objects.requireNonNull(index);
         this.queryConfig = queryConfig;
+        this.sourceFiltering = sourceFiltering;
     }
 
     public String[] getIndex() {
@@ -68,6 +76,10 @@ public QueryConfig getQueryConfig() {
         return queryConfig;
     }
 
+    public FetchSourceContext getSourceFiltering() {
+        return sourceFiltering;
+    }
+
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
@@ -75,6 +87,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (queryConfig != null) {
             builder.field(QUERY.getPreferredName(), queryConfig.getQuery());
         }
+        if (sourceFiltering != null) {
+            builder.field(_SOURCE.getPreferredName(), sourceFiltering);
+        }
         builder.endObject();
         return builder;
     }
@@ -86,12 +101,13 @@ public boolean equals(Object o) {
 
         DataFrameAnalyticsSource other = (DataFrameAnalyticsSource) o;
         return Arrays.equals(index, other.index)
-            && Objects.equals(queryConfig, other.queryConfig);
+            && Objects.equals(queryConfig, other.queryConfig)
+            && Objects.equals(sourceFiltering, other.sourceFiltering);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(Arrays.asList(index), queryConfig);
+        return Objects.hash(Arrays.asList(index), queryConfig, sourceFiltering);
     }
 
     @Override
@@ -103,6 +119,7 @@ public static class Builder {
 
         private String[] index;
         private QueryConfig queryConfig;
+        private FetchSourceContext sourceFiltering;
 
         private Builder() {}
 
@@ -121,8 +138,13 @@ public Builder setQueryConfig(QueryConfig queryConfig) {
             return this;
         }
 
+        public Builder setSourceFiltering(FetchSourceContext sourceFiltering) {
+            this.sourceFiltering = sourceFiltering;
+            return this;
+        }
+
         public DataFrameAnalyticsSource build() {
-            return new DataFrameAnalyticsSource(index, queryConfig);
+            return new DataFrameAnalyticsSource(index, queryConfig, sourceFiltering);
         }
     }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
index 8c6e134822b60..1d9a151cf8ae3 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
@@ -2939,6 +2939,9 @@ public void testPutDataFrameAnalytics() throws Exception {
             DataFrameAnalyticsSource sourceConfig = DataFrameAnalyticsSource.builder() // <1>
                 .setIndex("put-test-source-index") // <2>
                 .setQueryConfig(queryConfig) // <3>
+                .setSourceFiltering(new FetchSourceContext(true,
+                    new String[] { "included_field_1", "included_field_2" },
+                    new String[] { "excluded_field" })) // <4>
                 .build();
             // end::put-data-frame-analytics-source-config
 
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSourceTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSourceTests.java
index d82e1999f3034..3fae44aad9060 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSourceTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSourceTests.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.test.AbstractXContentTestCase;
 
 import java.io.IOException;
@@ -35,9 +36,17 @@
 public class DataFrameAnalyticsSourceTests extends AbstractXContentTestCase<DataFrameAnalyticsSource> {
 
     public static DataFrameAnalyticsSource randomSourceConfig() {
+        FetchSourceContext sourceFiltering = null;
+        if (randomBoolean()) {
+            sourceFiltering = new FetchSourceContext(true,
+                generateRandomStringArray(10, 10, false, false),
+                generateRandomStringArray(10, 10, false, false));
+        }
+
         return DataFrameAnalyticsSource.builder()
             .setIndex(generateRandomStringArray(10, 10, false, false))
             .setQueryConfig(randomBoolean() ? null : randomQueryConfig())
+            .setSourceFiltering(sourceFiltering)
             .build();
     }
 
diff --git a/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc b/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
index c4e7184de7e04..91a97ad604cee 100644
--- a/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
+++ b/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
@@ -52,6 +52,7 @@ include-tagged::{doc-tests-file}[{api}-source-config]
 <1> Constructing a new DataFrameAnalyticsSource
 <2> The source index
 <3> The query from which to gather the data. If query is not set, a `match_all` query is used by default.
+<4> Source filtering to select which fields will exist in the destination index.
 
 ===== QueryConfig
 
diff --git a/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc b/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
index 62b5b121528a5..e8ee463c66af7 100644
--- a/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
@@ -16,17 +16,18 @@
   <<dfanalytics-types>>.
   
 `analyzed_fields`::
-  (object) You can specify both `includes` and/or `excludes` patterns. If 
-  `analyzed_fields` is not set, only the relevant fields will be included. For 
-  example, all the numeric fields for {oldetection}. For the supported field 
-  types, see <<ml-put-dfanalytics-supported-fields>>.
+  (Optional, object) Specify `includes` and/or `excludes` patterns to select
+  which fields will be included in the analysis. If `analyzed_fields` is not set,
+  only the relevant fields will be included. For example, all the numeric fields
+  for {oldetection}. For the supported field types, see <<ml-put-dfanalytics-supported-fields>>.
+  Also see the <<explain-dfanalytics>> which helps understand field selection.
     
   `includes`:::
-    (array) An array of strings that defines the fields that will be included in 
+    (Optional, array) An array of strings that defines the fields that will be included in 
     the analysis.
       
   `excludes`:::
-    (array) An array of strings that defines the fields that will be excluded 
+    (Optional, array) An array of strings that defines the fields that will be excluded 
     from the analysis.
   
 
@@ -81,8 +82,8 @@ PUT _ml/data_frame/analytics/loganalytics
   that setting. For more information, see <<ml-settings>>.
 
 `source`::
-  (object) The source configuration consisting an `index` and optionally a 
-  `query` object.
+  (object) The configuration of how to source the analysis data. It requires an `index`.
+  Optionally, `query` and `_source` may be specified.
   
   `index`:::
     (Required, string or array) Index or indices on which to perform the 
@@ -96,6 +97,19 @@ PUT _ml/data_frame/analytics/loganalytics
     as this object is passed verbatim to {es}. By default, this property has 
     the following value: `{"match_all": {}}`.
 
+  `_source`:::
+    (Optional, object) Specify `includes` and/or `excludes` patterns to select
+    which fields will be present in the destination. Fields that are excluded
+    cannot be included in the analysis.
+        
+      `includes`::::
+        (array) An array of strings that defines the fields that will be included in 
+        the destination.
+          
+      `excludes`::::
+        (array) An array of strings that defines the fields that will be excluded 
+        from the destination.
+
 [[dfanalytics-types]]
 ==== Analysis objects
 
@@ -277,4 +291,4 @@ improvement. If you override any parameters, then the optimization will
 calculate the value of the remaining parameters accordingly and use the value 
 you provided for the overridden parameter. The number of rounds are reduced 
 respectively. The validation error is estimated in each round by using 4-fold 
-cross validation.
\ No newline at end of file
+cross validation.
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index 159f0cb61a0c4..b4971fffa9c49 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -101,13 +101,13 @@ single number. For example, in case of age ranges, you can model the values as
   <<dfanalytics-types>>.
   
 `analyzed_fields`::
-  (Optional, object) You can specify both `includes` and/or `excludes` patterns. 
-  If `analyzed_fields` is not set, only the relevant fields will be included. 
-  For example, all the numeric fields for {oldetection}. For the supported field 
-  types, see <<ml-put-dfanalytics-supported-fields>>. If you specify fields – 
-  either in `includes` or in `excludes` – that have a data type that is not 
-  supported, an error occurs.
-  
+  (Optional, object) Specify `includes` and/or `excludes` patterns to select
+  which fields will be included in the analysis. If `analyzed_fields` is not set,
+  only the relevant fields will be included. For example, all the numeric fields
+  for {oldetection}. For the supported field types, see <<ml-put-dfanalytics-supported-fields>>.
+  Also see the <<explain-dfanalytics>> which helps understand
+  field selection.
+
   `includes`:::
     (Optional, array) An array of strings that defines the fields that will be 
     included in the analysis.
@@ -142,20 +142,33 @@ single number. For example, in case of age ranges, you can model the values as
   that setting. For more information, see <<ml-settings>>.
   
 `source`::
-  (Required, object) The source configuration, consisting of `index` and 
-  optionally a `query`.
+  (object) The configuration of how to source the analysis data. It requires an `index`.
+  Optionally, `query` and `_source` may be specified.
   
-    `index`:::
-      (Required, string or array) Index or indices on which to perform the 
-      analysis. It can be a single index or index pattern as well as an array of 
-      indices or patterns.
-  
-    `query`:::
-      (Optional, object) The {es} query domain-specific language 
-      (<<query-dsl,DSL>>). This value corresponds to the query object in an {es} 
-      search POST body. All the options that are supported by {es} can be used, 
-      as this object is passed verbatim to {es}. By default, this property has 
-      the following value: `{"match_all": {}}`.
+  `index`:::
+    (Required, string or array) Index or indices on which to perform the 
+    analysis. It can be a single index or index pattern as well as an array of 
+    indices or patterns.
+    
+  `query`:::
+    (Optional, object) The {es} query domain-specific language 
+    (<<query-dsl,DSL>>). This value corresponds to the query object in an {es} 
+    search POST body. All the options that are supported by {es} can be used, 
+    as this object is passed verbatim to {es}. By default, this property has 
+    the following value: `{"match_all": {}}`.
+
+  `_source`:::
+    (Optional, object) Specify `includes` and/or `excludes` patterns to select
+    which fields will be present in the destination. Fields that are excluded
+    cannot be included in the analysis.
+        
+      `includes`::::
+        (array) An array of strings that defines the fields that will be included in 
+        the destination.
+          
+      `excludes`::::
+        (array) An array of strings that defines the fields that will be excluded 
+        from the destination.
 
 `allow_lazy_start`::
   (Optional, boolean) Whether this job should be allowed to start when there
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsAction.java
index 5bce41d8a4ae6..4f4ddc388aed7 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsAction.java
@@ -8,6 +8,7 @@
 import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.action.ActionResponse;
 import org.elasticsearch.action.ActionType;
+import org.elasticsearch.action.ValidateActions;
 import org.elasticsearch.action.support.master.AcknowledgedRequest;
 import org.elasticsearch.action.support.master.MasterNodeOperationRequestBuilder;
 import org.elasticsearch.client.ElasticsearchClient;
@@ -18,6 +19,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsSource;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
 
 import java.io.IOException;
@@ -87,6 +89,24 @@ public DataFrameAnalyticsConfig getConfig() {
 
         @Override
         public ActionRequestValidationException validate() {
+            ActionRequestValidationException error = null;
+            error = checkNoIncludedAnalyzedFieldsAreExcludedBySourceFiltering(config, error);
+            return error;
+        }
+
+        private ActionRequestValidationException checkNoIncludedAnalyzedFieldsAreExcludedBySourceFiltering(
+                DataFrameAnalyticsConfig config, ActionRequestValidationException error) {
+            if (config.getAnalyzedFields() == null) {
+                return null;
+            }
+            for (String analyzedInclude : config.getAnalyzedFields().includes()) {
+                if (config.getSource().isFieldExcluded(analyzedInclude)) {
+                    return ValidateActions.addValidationError("field [" + analyzedInclude + "] is included in ["
+                        + DataFrameAnalyticsConfig.ANALYZED_FIELDS.getPreferredName() + "] but not in ["
+                        + DataFrameAnalyticsConfig.SOURCE.getPreferredName() + "."
+                        + DataFrameAnalyticsSource._SOURCE.getPreferredName() + "]", error);
+                }
+            }
             return null;
         }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
index ac1589fa56fbc..9fd7f8aa86fcb 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
@@ -127,7 +127,7 @@ private static DataFrameAnalysis parseAnalysis(XContentParser parser, boolean ig
     private final Version version;
     private final boolean allowLazyStart;
 
-    public DataFrameAnalyticsConfig(String id, String description, DataFrameAnalyticsSource source, DataFrameAnalyticsDest dest,
+    private DataFrameAnalyticsConfig(String id, String description, DataFrameAnalyticsSource source, DataFrameAnalyticsDest dest,
                                     DataFrameAnalysis analysis, Map<String, String> headers, ByteSizeValue modelMemoryLimit,
                                     FetchSourceContext analyzedFields, Instant createTime, Version version, boolean allowLazyStart) {
         this.id = ExceptionsHelper.requireNonNull(id, ID);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSource.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSource.java
index 5ffa3119413ab..c5e5515deb0b5 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSource.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSource.java
@@ -6,17 +6,21 @@
 package org.elasticsearch.xpack.core.ml.dataframe;
 
 import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.regex.Regex;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 import org.elasticsearch.xpack.core.ml.utils.QueryProvider;
@@ -33,20 +37,29 @@ public class DataFrameAnalyticsSource implements Writeable, ToXContentObject {
 
     public static final ParseField INDEX = new ParseField("index");
     public static final ParseField QUERY = new ParseField("query");
+    public static final ParseField _SOURCE = new ParseField("_source");
 
     public static ConstructingObjectParser<DataFrameAnalyticsSource, Void> createParser(boolean ignoreUnknownFields) {
         ConstructingObjectParser<DataFrameAnalyticsSource, Void> parser = new ConstructingObjectParser<>("data_frame_analytics_source",
-            ignoreUnknownFields, a -> new DataFrameAnalyticsSource(((List<String>) a[0]).toArray(new String[0]), (QueryProvider) a[1]));
+            ignoreUnknownFields, a -> new DataFrameAnalyticsSource(
+                ((List<String>) a[0]).toArray(new String[0]),
+                (QueryProvider) a[1],
+                (FetchSourceContext) a[2]));
         parser.declareStringArray(ConstructingObjectParser.constructorArg(), INDEX);
         parser.declareObject(ConstructingObjectParser.optionalConstructorArg(),
             (p, c) -> QueryProvider.fromXContent(p, ignoreUnknownFields, Messages.DATA_FRAME_ANALYTICS_BAD_QUERY_FORMAT), QUERY);
+        parser.declareField(ConstructingObjectParser.optionalConstructorArg(),
+            (p, c) -> FetchSourceContext.fromXContent(p),
+            _SOURCE,
+            ObjectParser.ValueType.OBJECT_ARRAY_BOOLEAN_OR_STRING);
         return parser;
     }
 
     private final String[] index;
     private final QueryProvider queryProvider;
+    private final FetchSourceContext sourceFiltering;
 
-    public DataFrameAnalyticsSource(String[] index, @Nullable QueryProvider queryProvider) {
+    public DataFrameAnalyticsSource(String[] index, @Nullable QueryProvider queryProvider, @Nullable FetchSourceContext sourceFiltering) {
         this.index = ExceptionsHelper.requireNonNull(index, INDEX);
         if (index.length == 0) {
             throw new IllegalArgumentException("source.index must specify at least one index");
@@ -55,22 +68,36 @@ public DataFrameAnalyticsSource(String[] index, @Nullable QueryProvider queryPro
             throw new IllegalArgumentException("source.index must contain non-null and non-empty strings");
         }
         this.queryProvider = queryProvider == null ? QueryProvider.defaultQuery() : queryProvider;
+        if (sourceFiltering != null && sourceFiltering.fetchSource() == false) {
+            throw new IllegalArgumentException("source._source cannot be disabled");
+        }
+        this.sourceFiltering = sourceFiltering;
     }
 
     public DataFrameAnalyticsSource(StreamInput in) throws IOException {
         index = in.readStringArray();
         queryProvider = QueryProvider.fromStream(in);
+        if (in.getVersion().onOrAfter(Version.CURRENT)) {
+            sourceFiltering = in.readOptionalWriteable(FetchSourceContext::new);
+        } else {
+            sourceFiltering = null;
+        }
     }
 
     public DataFrameAnalyticsSource(DataFrameAnalyticsSource other) {
         this.index = Arrays.copyOf(other.index, other.index.length);
         this.queryProvider = new QueryProvider(other.queryProvider);
+        this.sourceFiltering = other.sourceFiltering == null ? null : new FetchSourceContext(
+            other.sourceFiltering.fetchSource(), other.sourceFiltering.includes(), other.sourceFiltering.excludes());
     }
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeStringArray(index);
         queryProvider.writeTo(out);
+        if (out.getVersion().onOrAfter(Version.CURRENT)) {
+            out.writeOptionalWriteable(sourceFiltering);
+        }
     }
 
     @Override
@@ -78,6 +105,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         builder.startObject();
         builder.array(INDEX.getPreferredName(), index);
         builder.field(QUERY.getPreferredName(), queryProvider.getQuery());
+        if (sourceFiltering != null) {
+            builder.field(_SOURCE.getPreferredName(), sourceFiltering);
+        }
         builder.endObject();
         return builder;
     }
@@ -89,12 +119,13 @@ public boolean equals(Object o) {
 
         DataFrameAnalyticsSource other = (DataFrameAnalyticsSource) o;
         return Arrays.equals(index, other.index)
-            && Objects.equals(queryProvider, other.queryProvider);
+            && Objects.equals(queryProvider, other.queryProvider)
+            && Objects.equals(sourceFiltering, other.sourceFiltering);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(Arrays.asList(index), queryProvider);
+        return Objects.hash(Arrays.asList(index), queryProvider, sourceFiltering);
     }
 
     public String[] getIndex() {
@@ -118,6 +149,10 @@ public QueryBuilder getParsedQuery() {
         return queryProvider.getParsedQuery();
     }
 
+    public FetchSourceContext getSourceFiltering() {
+        return sourceFiltering;
+    }
+
     Exception getQueryParsingException() {
         return queryProvider.getParsingException();
     }
@@ -147,4 +182,47 @@ public List<String> getQueryDeprecations(NamedXContentRegistry namedXContentRegi
     Map<String, Object> getQuery() {
         return queryProvider.getQuery();
     }
+
+    public boolean isFieldExcluded(String path) {
+        if (sourceFiltering == null) {
+            return false;
+        }
+
+        // First we check in the excludes as they are applied last
+        for (String exclude : sourceFiltering.excludes()) {
+            if (pathMatchesSourcePattern(path, exclude)) {
+                return true;
+            }
+        }
+
+        // Now we can check the includes
+
+        // Empty includes means no further exclusions
+        if (sourceFiltering.includes().length == 0) {
+            return false;
+        }
+
+        for (String include : sourceFiltering.includes()) {
+            if (pathMatchesSourcePattern(path, include)) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    private static boolean pathMatchesSourcePattern(String path, String sourcePattern) {
+        if (sourcePattern.equals(path)) {
+            return true;
+        }
+
+        if (Regex.isSimpleMatchPattern(sourcePattern)) {
+            return Regex.simpleMatch(sourcePattern, path);
+        }
+
+        // At this stage sourcePattern is a concrete field name and path is not equal to it.
+        // We should check if path is a nested field of pattern.
+        // Let us take "foo" as an example.
+        // Fields that are "foo.*" should also be matched.
+        return Regex.simpleMatch(sourcePattern + ".*", path);
+    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/persistence/ElasticsearchMappings.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/persistence/ElasticsearchMappings.java
index 95d8194397a54..b9de87ef93de0 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/persistence/ElasticsearchMappings.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/persistence/ElasticsearchMappings.java
@@ -418,6 +418,9 @@ public static void addDataFrameAnalyticsFields(XContentBuilder builder) throws I
                 .startObject(DataFrameAnalyticsSource.QUERY.getPreferredName())
                     .field(ENABLED, false)
                 .endObject()
+                .startObject(DataFrameAnalyticsSource._SOURCE.getPreferredName())
+                    .field(ENABLED, false)
+                .endObject()
             .endObject()
         .endObject()
         .startObject(DataFrameAnalyticsConfig.DEST.getPreferredName())
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ReservedFieldNames.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ReservedFieldNames.java
index e0ae183d17a0f..8eacdcb0e78e4 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ReservedFieldNames.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ReservedFieldNames.java
@@ -303,6 +303,7 @@ public final class ReservedFieldNames {
             DataFrameAnalyticsDest.RESULTS_FIELD.getPreferredName(),
             DataFrameAnalyticsSource.INDEX.getPreferredName(),
             DataFrameAnalyticsSource.QUERY.getPreferredName(),
+            DataFrameAnalyticsSource._SOURCE.getPreferredName(),
             OutlierDetection.NAME.getPreferredName(),
             OutlierDetection.N_NEIGHBORS.getPreferredName(),
             OutlierDetection.METHOD.getPreferredName(),
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsActionRequestTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsActionRequestTests.java
index dbd3db927503c..9d194bc260523 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsActionRequestTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsActionRequestTests.java
@@ -11,16 +11,25 @@
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.action.PutDataFrameAnalyticsAction.Request;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfigTests;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsSource;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.MlDataFrameAnalysisNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.OutlierDetectionTests;
 import org.junit.Before;
 
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.notNullValue;
+import static org.hamcrest.Matchers.nullValue;
+
 public class PutDataFrameAnalyticsActionRequestTests extends AbstractSerializingTestCase<Request> {
 
     private String id;
@@ -65,4 +74,39 @@ protected boolean supportsUnknownFields() {
     protected Request doParseInstance(XContentParser parser) {
         return Request.parseRequest(id, parser);
     }
+
+    public void testValidate_GivenRequestWithIncludedAnalyzedFieldThatIsExcludedInSourceFiltering() {
+        DataFrameAnalyticsSource source = new DataFrameAnalyticsSource(new String[] {"index"}, null,
+            new FetchSourceContext(true, null, new String[] {"excluded"}));
+        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[] {"excluded"}, null);
+        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
+            .setId("foo")
+            .setSource(source)
+            .setAnalysis(OutlierDetectionTests.createRandom())
+            .setAnalyzedFields(analyzedFields)
+            .buildForExplain();
+        Request request = new Request(config);
+
+        Exception e = request.validate();
+
+        assertThat(e, is(notNullValue()));
+        assertThat(e.getMessage(), containsString("field [excluded] is included in [analyzed_fields] but not in [source._source]"));
+    }
+
+    public void testValidate_GivenRequestWithIncludedAnalyzedFieldThatIsIncludedInSourceFiltering() {
+        DataFrameAnalyticsSource source = new DataFrameAnalyticsSource(new String[] {"index"}, null,
+            new FetchSourceContext(true, new String[] {"included"}, null));
+        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[] {"included"}, null);
+        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
+            .setId("foo")
+            .setSource(source)
+            .setAnalysis(OutlierDetectionTests.createRandom())
+            .setAnalyzedFields(analyzedFields)
+            .buildForExplain();
+        Request request = new Request(config);
+
+        Exception e = request.validate();
+
+        assertThat(e, is(nullValue()));
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSourceTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSourceTests.java
index 36c4774baa465..cd58f9c84533c 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSourceTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSourceTests.java
@@ -12,12 +12,18 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.utils.QueryProvider;
 
 import java.io.IOException;
 import java.io.UncheckedIOException;
+import java.util.Arrays;
 import java.util.Collections;
+import java.util.List;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
 
 public class DataFrameAnalyticsSourceTests extends AbstractSerializingTestCase<DataFrameAnalyticsSource> {
 
@@ -46,6 +52,7 @@ protected DataFrameAnalyticsSource createTestInstance() {
     public static DataFrameAnalyticsSource createRandom() {
         String[] index = generateRandomStringArray(10, 10, false, false);
         QueryProvider queryProvider = null;
+        FetchSourceContext sourceFiltering = null;
         if (randomBoolean()) {
             try {
                 queryProvider = QueryProvider.fromParsedQuery(QueryBuilders.termQuery(randomAlphaOfLength(10), randomAlphaOfLength(10)));
@@ -54,11 +61,75 @@ public static DataFrameAnalyticsSource createRandom() {
                 throw new UncheckedIOException(e);
             }
         }
-        return new DataFrameAnalyticsSource(index, queryProvider);
+        if (randomBoolean()) {
+            sourceFiltering = new FetchSourceContext(true,
+                generateRandomStringArray(10, 10, false, false),
+                generateRandomStringArray(10, 10, false, false));
+        }
+        return new DataFrameAnalyticsSource(index, queryProvider, sourceFiltering);
     }
 
     @Override
     protected Writeable.Reader<DataFrameAnalyticsSource> instanceReader() {
         return DataFrameAnalyticsSource::new;
     }
+
+    public void testConstructor_GivenDisabledSource() {
+        IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> new DataFrameAnalyticsSource(
+            new String[] {"index"}, null, new FetchSourceContext(false, null, null)));
+        assertThat(e.getMessage(), equalTo("source._source cannot be disabled"));
+    }
+
+    public void testIsFieldExcluded_GivenNoSourceFiltering() {
+        DataFrameAnalyticsSource source = new DataFrameAnalyticsSource(new String[] { "index" }, null, null);
+        assertThat(source.isFieldExcluded(randomAlphaOfLength(10)), is(false));
+    }
+
+    public void testIsFieldExcluded_GivenSourceFilteringWithNulls() {
+        DataFrameAnalyticsSource source = new DataFrameAnalyticsSource(new String[] { "index" }, null,
+            new FetchSourceContext(true, null, null));
+        assertThat(source.isFieldExcluded(randomAlphaOfLength(10)), is(false));
+    }
+
+    public void testIsFieldExcluded_GivenExcludes() {
+        assertThat(newSourceWithExcludes("foo").isFieldExcluded("bar"), is(false));
+        assertThat(newSourceWithExcludes("foo").isFieldExcluded("foo"), is(true));
+        assertThat(newSourceWithExcludes("foo").isFieldExcluded("foo.bar"), is(true));
+        assertThat(newSourceWithExcludes("foo*").isFieldExcluded("foo"), is(true));
+        assertThat(newSourceWithExcludes("foo*").isFieldExcluded("foobar"), is(true));
+        assertThat(newSourceWithExcludes("foo*").isFieldExcluded("foo.bar"), is(true));
+        assertThat(newSourceWithExcludes("foo*").isFieldExcluded("foo*"), is(true));
+        assertThat(newSourceWithExcludes("foo*").isFieldExcluded("fo*"), is(false));
+    }
+
+    public void testIsFieldExcluded_GivenIncludes() {
+        assertThat(newSourceWithIncludes("foo").isFieldExcluded("bar"), is(true));
+        assertThat(newSourceWithIncludes("foo").isFieldExcluded("foo"), is(false));
+        assertThat(newSourceWithIncludes("foo").isFieldExcluded("foo.bar"), is(false));
+        assertThat(newSourceWithIncludes("foo*").isFieldExcluded("foo"), is(false));
+        assertThat(newSourceWithIncludes("foo*").isFieldExcluded("foobar"), is(false));
+        assertThat(newSourceWithIncludes("foo*").isFieldExcluded("foo.bar"), is(false));
+        assertThat(newSourceWithIncludes("foo*").isFieldExcluded("foo*"), is(false));
+        assertThat(newSourceWithIncludes("foo*").isFieldExcluded("fo*"), is(true));
+    }
+
+    public void testIsFieldExcluded_GivenIncludesAndExcludes() {
+        // Excludes take precedence
+        assertThat(newSourceWithIncludesExcludes(Collections.singletonList("foo"), Collections.singletonList("foo"))
+            .isFieldExcluded("foo"), is(true));
+    }
+
+    private static DataFrameAnalyticsSource newSourceWithIncludes(String... includes) {
+        return newSourceWithIncludesExcludes(Arrays.asList(includes), Collections.emptyList());
+    }
+
+    private static DataFrameAnalyticsSource newSourceWithExcludes(String... excludes) {
+        return newSourceWithIncludesExcludes(Collections.emptyList(), Arrays.asList(excludes));
+    }
+
+    private static DataFrameAnalyticsSource newSourceWithIncludesExcludes(List<String> includes, List<String> excludes) {
+        FetchSourceContext sourceFiltering = new FetchSourceContext(true,
+            includes.toArray(new String[0]), excludes.toArray(new String[0]));
+        return new DataFrameAnalyticsSource(new String[] { "index" } , null, sourceFiltering);
+    }
 }
diff --git a/x-pack/plugin/ml/qa/ml-with-security/build.gradle b/x-pack/plugin/ml/qa/ml-with-security/build.gradle
index 38beb1d1908c1..fe53f1ca39ff5 100644
--- a/x-pack/plugin/ml/qa/ml-with-security/build.gradle
+++ b/x-pack/plugin/ml/qa/ml-with-security/build.gradle
@@ -52,6 +52,7 @@ integTest.runner {
     'ml/data_frame_analytics_crud/Test put config with dest index included in source via alias',
     'ml/data_frame_analytics_crud/Test put config with unknown top level field',
     'ml/data_frame_analytics_crud/Test put config with unknown field in outlier detection analysis',
+    'ml/data_frame_analytics_crud/Test put config given analyzed_fields include field excluded by source',
     'ml/data_frame_analytics_crud/Test put config given missing source',
     'ml/data_frame_analytics_crud/Test put config given source with empty index array',
     'ml/data_frame_analytics_crud/Test put config given source with empty string in index array',
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
index 6796e3b7223d7..540d9f373b7e4 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
@@ -53,7 +53,8 @@ public void testSourceQueryIsApplied() throws IOException {
         DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
             .setId(id)
             .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex },
-                QueryProvider.fromParsedQuery(QueryBuilders.termQuery("categorical", "only-one"))))
+                QueryProvider.fromParsedQuery(QueryBuilders.termQuery("categorical", "only-one")),
+                null))
             .setAnalysis(new Classification("categorical"))
             .buildForExplain();
 
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
index 06c88a9793b23..b3b58a2d4fcbb 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
@@ -164,7 +164,7 @@ protected static DataFrameAnalyticsConfig buildAnalytics(String id, String sourc
                                                              @Nullable String resultsField, DataFrameAnalysis analysis) {
         return new DataFrameAnalyticsConfig.Builder()
             .setId(id)
-            .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex }, null))
+            .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex }, null, null))
             .setDest(new DataFrameAnalyticsDest(destIndex, resultsField))
             .setAnalysis(analysis)
             .build();
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RunDataFrameAnalyticsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RunDataFrameAnalyticsIT.java
index c30fccce2f17a..2628a751bc112 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RunDataFrameAnalyticsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RunDataFrameAnalyticsIT.java
@@ -356,7 +356,7 @@ public void testOutlierDetectionWithMultipleSourceIndices() throws Exception {
         String id = "test_outlier_detection_with_multiple_source_indices";
         DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
             .setId(id)
-            .setSource(new DataFrameAnalyticsSource(sourceIndex, null))
+            .setSource(new DataFrameAnalyticsSource(sourceIndex, null, null))
             .setDest(new DataFrameAnalyticsDest(destIndex, null))
             .setAnalysis(new OutlierDetection.Builder().build())
             .build();
@@ -472,7 +472,7 @@ public void testModelMemoryLimitLowerThanEstimatedMemoryUsage() throws Exception
         ByteSizeValue modelMemoryLimit = new ByteSizeValue(1, ByteSizeUnit.MB);
         DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
             .setId(id)
-            .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex }, null))
+            .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex }, null, null))
             .setDest(new DataFrameAnalyticsDest(sourceIndex + "-results", null))
             .setAnalysis(new OutlierDetection.Builder().build())
             .setModelMemoryLimit(modelMemoryLimit)
@@ -516,7 +516,7 @@ public void testLazyAssignmentWithModelMemoryLimitTooHighForAssignment() throws
         ByteSizeValue modelMemoryLimit = new ByteSizeValue(1, ByteSizeUnit.TB);
         DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
             .setId(id)
-            .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex }, null))
+            .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex }, null, null))
             .setDest(new DataFrameAnalyticsDest(sourceIndex + "-results", null))
             .setAnalysis(new OutlierDetection.Builder().build())
             .setModelMemoryLimit(modelMemoryLimit)
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
index f76014eda1910..65ed0b93aa7b9 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
@@ -237,7 +237,7 @@ private void getStartContext(String id, ActionListener<StartContext> finalListen
         // Step 5. Validate mappings can be merged
         ActionListener<StartContext> toValidateMappingsListener = ActionListener.wrap(
             startContext -> MappingsMerger.mergeMappings(client, startContext.config.getHeaders(),
-                startContext.config.getSource().getIndex(), ActionListener.wrap(
+                startContext.config.getSource(), ActionListener.wrap(
                 mappings -> validateMappingsMergeListener.onResponse(startContext), finalListener::onFailure)),
             finalListener::onFailure
         );
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
index 444b0081cc7bc..a369bc7d0b09a 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
@@ -84,8 +84,6 @@ private static void prepareCreateIndexRequest(Client client, Clock clock, DataFr
                                                          ActionListener<CreateIndexRequest> listener) {
         AtomicReference<Settings> settingsHolder = new AtomicReference<>();
 
-        String[] sourceIndex = config.getSource().getIndex();
-
         ActionListener<ImmutableOpenMap<String, MappingMetaData>> mappingsListener = ActionListener.wrap(
             mappings -> listener.onResponse(createIndexRequest(clock, config, settingsHolder.get(), mappings)),
             listener::onFailure
@@ -94,7 +92,7 @@ private static void prepareCreateIndexRequest(Client client, Clock clock, DataFr
         ActionListener<Settings> settingsListener = ActionListener.wrap(
             settings -> {
                 settingsHolder.set(settings);
-                MappingsMerger.mergeMappings(client, config.getHeaders(), sourceIndex, mappingsListener);
+                MappingsMerger.mergeMappings(client, config.getHeaders(), config.getSource(), mappingsListener);
             },
             listener::onFailure
         );
@@ -105,7 +103,7 @@ private static void prepareCreateIndexRequest(Client client, Clock clock, DataFr
         );
 
         GetSettingsRequest getSettingsRequest = new GetSettingsRequest();
-        getSettingsRequest.indices(sourceIndex);
+        getSettingsRequest.indices(config.getSource().getIndex());
         getSettingsRequest.indicesOptions(IndicesOptions.lenientExpandOpen());
         getSettingsRequest.names(PRESERVED_SETTINGS);
         ClientHelper.executeWithHeadersAsync(config.getHeaders(), ML_ORIGIN, client, GetSettingsAction.INSTANCE,
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
index c53238dc425d7..76fc588027943 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
@@ -179,6 +179,7 @@ private void reindexDataframeAndStartAnalysis(DataFrameAnalyticsTask task, DataF
                 ReindexRequest reindexRequest = new ReindexRequest();
                 reindexRequest.setSourceIndices(config.getSource().getIndex());
                 reindexRequest.setSourceQuery(config.getSource().getParsedQuery());
+                reindexRequest.getSearchRequest().source().fetchSource(config.getSource().getSourceFiltering());
                 reindexRequest.setDestIndex(config.getDest().getIndex());
                 reindexRequest.setScript(new Script("ctx._source." + DataFrameAnalyticsIndex.ID_COPY + " = ctx._id"));
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/MappingsMerger.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/MappingsMerger.java
index c573f193cf01a..056f8239aef8d 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/MappingsMerger.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/MappingsMerger.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.common.collect.ImmutableOpenMap;
 import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.xpack.core.ClientHelper;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsSource;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.util.Collections;
@@ -32,22 +33,22 @@ public final class MappingsMerger {
 
     private MappingsMerger() {}
 
-    public static void mergeMappings(Client client, Map<String, String> headers, String[] index,
+    public static void mergeMappings(Client client, Map<String, String> headers, DataFrameAnalyticsSource source,
                                      ActionListener<ImmutableOpenMap<String, MappingMetaData>> listener) {
         ActionListener<GetMappingsResponse> mappingsListener = ActionListener.wrap(
-            getMappingsResponse -> listener.onResponse(MappingsMerger.mergeMappings(getMappingsResponse)),
+            getMappingsResponse -> listener.onResponse(MappingsMerger.mergeMappings(source, getMappingsResponse)),
             listener::onFailure
         );
 
         GetMappingsRequest getMappingsRequest = new GetMappingsRequest();
-        getMappingsRequest.indices(index);
+        getMappingsRequest.indices(source.getIndex());
         ClientHelper.executeWithHeadersAsync(headers, ML_ORIGIN, client, GetMappingsAction.INSTANCE, getMappingsRequest, mappingsListener);
     }
 
-    static ImmutableOpenMap<String, MappingMetaData> mergeMappings(GetMappingsResponse getMappingsResponse) {
+    static ImmutableOpenMap<String, MappingMetaData> mergeMappings(DataFrameAnalyticsSource source,
+                                                                   GetMappingsResponse getMappingsResponse) {
         ImmutableOpenMap<String, MappingMetaData> indexToMappings = getMappingsResponse.getMappings();
 
-        String type = null;
         Map<String, Object> mergedMappings = new HashMap<>();
 
         Iterator<ObjectObjectCursor<String, MappingMetaData>> iterator = indexToMappings.iterator();
@@ -61,13 +62,16 @@ static ImmutableOpenMap<String, MappingMetaData> mergeMappings(GetMappingsRespon
                     Map<String, Object> fieldMappings = (Map<String, Object>) currentMappings.get("properties");
 
                     for (Map.Entry<String, Object> fieldMapping : fieldMappings.entrySet()) {
-                        if (mergedMappings.containsKey(fieldMapping.getKey())) {
-                            if (mergedMappings.get(fieldMapping.getKey()).equals(fieldMapping.getValue()) == false) {
-                                throw ExceptionsHelper.badRequestException("cannot merge mappings because of differences for field [{}]",
-                                    fieldMapping.getKey());
+                        String field = fieldMapping.getKey();
+                        if (source.isFieldExcluded(field) == false) {
+                            if (mergedMappings.containsKey(field)) {
+                                if (mergedMappings.get(field).equals(fieldMapping.getValue()) == false) {
+                                    throw ExceptionsHelper.badRequestException(
+                                        "cannot merge mappings because of differences for field [{}]", field);
+                                }
+                            } else {
+                                mergedMappings.put(field, fieldMapping.getValue());
                             }
-                        } else {
-                            mergedMappings.put(fieldMapping.getKey(), fieldMapping.getValue());
                         }
                     }
                 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
index 42ea2d1944301..62184e290374d 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
@@ -85,6 +85,7 @@ private Set<String> getIncludedFields(Set<FieldSelection> fieldSelection) {
         fields.removeAll(IGNORE_FIELDS);
         checkResultsFieldIsNotPresent();
         removeFieldsUnderResultsField(fields);
+        applySourceFiltering(fields);
         FetchSourceContext analyzedFields = config.getAnalyzedFields();
 
         // If the user has not explicitly included fields we'll include all compatible fields
@@ -132,6 +133,16 @@ private void checkResultsFieldIsNotPresent() {
         }
     }
 
+    private void applySourceFiltering(Set<String> fields) {
+        Iterator<String> fieldsIterator = fields.iterator();
+        while (fieldsIterator.hasNext()) {
+            String field = fieldsIterator.next();
+            if (config.getSource().isFieldExcluded(field)) {
+                fieldsIterator.remove();
+            }
+        }
+    }
+
     private void addExcludedField(String field, String reason, Set<FieldSelection> fieldSelection) {
         fieldSelection.add(FieldSelection.excluded(field, getMappingTypes(field), reason));
     }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
index 063e1ea337782..950d5997a5a35 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
@@ -58,7 +58,7 @@ public class DataFrameAnalyticsIndexTests extends ESTestCase {
     private static final DataFrameAnalyticsConfig ANALYTICS_CONFIG =
         new DataFrameAnalyticsConfig.Builder()
             .setId(ANALYTICS_ID)
-            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null))
+            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null, null))
             .setDest(new DataFrameAnalyticsDest(DEST_INDEX, null))
             .setAnalysis(new OutlierDetection.Builder().build())
             .build();
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/MappingsMergerTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/MappingsMergerTests.java
index f44e8a9f3e61a..e47b3e6934e80 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/MappingsMergerTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/MappingsMergerTests.java
@@ -10,9 +10,10 @@
 import org.elasticsearch.cluster.metadata.MappingMetaData;
 import org.elasticsearch.common.collect.ImmutableOpenMap;
 import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsSource;
 
-import java.io.IOException;
 import java.util.Map;
 
 import static org.hamcrest.Matchers.containsInAnyOrder;
@@ -21,7 +22,7 @@
 
 public class MappingsMergerTests extends ESTestCase {
 
-    public void testMergeMappings_GivenIndicesWithIdenticalMappings() throws IOException {
+    public void testMergeMappings_GivenIndicesWithIdenticalMappings() {
         Map<String, Object> index1Mappings = Map.of("properties", Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings"));
         MappingMetaData index1MappingMetaData = new MappingMetaData("_doc", index1Mappings);
 
@@ -34,14 +35,14 @@ public void testMergeMappings_GivenIndicesWithIdenticalMappings() throws IOExcep
 
         GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
 
-        ImmutableOpenMap<String, MappingMetaData> mergedMappings = MappingsMerger.mergeMappings(getMappingsResponse);
+        ImmutableOpenMap<String, MappingMetaData> mergedMappings = MappingsMerger.mergeMappings(newSource(), getMappingsResponse);
 
         assertThat(mergedMappings.size(), equalTo(1));
         assertThat(mergedMappings.containsKey("_doc"), is(true));
         assertThat(mergedMappings.valuesIt().next().getSourceAsMap(), equalTo(index1Mappings));
     }
 
-    public void testMergeMappings_GivenFieldWithDifferentMapping() throws IOException {
+    public void testMergeMappings_GivenFieldWithDifferentMapping() {
         Map<String, Object> index1Mappings = Map.of("properties", Map.of("field_1", "field_1_mappings"));
         MappingMetaData index1MappingMetaData = new MappingMetaData("_doc", index1Mappings);
 
@@ -55,12 +56,12 @@ public void testMergeMappings_GivenFieldWithDifferentMapping() throws IOExceptio
         GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
 
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> MappingsMerger.mergeMappings(getMappingsResponse));
+            () -> MappingsMerger.mergeMappings(newSource(), getMappingsResponse));
         assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
         assertThat(e.getMessage(), equalTo("cannot merge mappings because of differences for field [field_1]"));
     }
 
-    public void testMergeMappings_GivenIndicesWithDifferentMappingsButNoConflicts() throws IOException {
+    public void testMergeMappings_GivenIndicesWithDifferentMappingsButNoConflicts() {
         Map<String, Object> index1Mappings = Map.of("properties",
             Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings"));
         MappingMetaData index1MappingMetaData = new MappingMetaData("_doc", index1Mappings);
@@ -75,7 +76,7 @@ public void testMergeMappings_GivenIndicesWithDifferentMappingsButNoConflicts()
 
         GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
 
-        ImmutableOpenMap<String, MappingMetaData> mergedMappings = MappingsMerger.mergeMappings(getMappingsResponse);
+        ImmutableOpenMap<String, MappingMetaData> mergedMappings = MappingsMerger.mergeMappings(newSource(), getMappingsResponse);
 
         assertThat(mergedMappings.size(), equalTo(1));
         assertThat(mergedMappings.containsKey("_doc"), is(true));
@@ -92,4 +93,35 @@ public void testMergeMappings_GivenIndicesWithDifferentMappingsButNoConflicts()
         assertThat(fieldMappings.get("field_2"), equalTo("field_2_mappings"));
         assertThat(fieldMappings.get("field_3"), equalTo("field_3_mappings"));
     }
+
+    public void testMergeMappings_GivenSourceFiltering() {
+        Map<String, Object> indexMappings = Map.of("properties", Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings"));
+        MappingMetaData indexMappingMetaData = new MappingMetaData("_doc", indexMappings);
+
+        ImmutableOpenMap.Builder<String, MappingMetaData> mappings = ImmutableOpenMap.builder();
+        mappings.put("index", indexMappingMetaData);
+
+        GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
+
+        ImmutableOpenMap<String, MappingMetaData> mergedMappings = MappingsMerger.mergeMappings(
+            newSourceWithExcludes("field_1"), getMappingsResponse);
+
+        assertThat(mergedMappings.size(), equalTo(1));
+        assertThat(mergedMappings.containsKey("_doc"), is(true));
+        Map<String, Object> mappingsAsMap = mergedMappings.valuesIt().next().getSourceAsMap();
+        @SuppressWarnings("unchecked")
+        Map<String, Object> fieldMappings = (Map<String, Object>) mappingsAsMap.get("properties");
+
+        assertThat(fieldMappings.size(), equalTo(1));
+        assertThat(fieldMappings.containsKey("field_2"), is(true));
+    }
+
+    private static DataFrameAnalyticsSource newSource() {
+        return new DataFrameAnalyticsSource(new String[] {"index"}, null, null);
+    }
+
+    private static DataFrameAnalyticsSource newSourceWithExcludes(String... excludes) {
+        return new DataFrameAnalyticsSource(new String[] {"index"}, null,
+            new FetchSourceContext(true, null, excludes));
+    }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidatorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidatorTests.java
index c9423aadbe03a..ec8b97942ac0a 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidatorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidatorTests.java
@@ -183,6 +183,6 @@ public void testCheck_GivenDestIndexIsAliasThatIsIncludedInSource() {
     }
 
     private static DataFrameAnalyticsSource createSource(String... index) {
-        return new DataFrameAnalyticsSource(index, null);
+        return new DataFrameAnalyticsSource(index, null, null);
     }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
index 25553627a9e05..f4f25bcfa0636 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
@@ -45,6 +45,9 @@ public class ExtractedFieldsDetectorTests extends ESTestCase {
     private static final String DEST_INDEX = "dest_index";
     private static final String RESULTS_FIELD = "ml";
 
+    private FetchSourceContext sourceFiltering;
+    private FetchSourceContext analyzedFields;
+
     public void testDetect_GivenFloatField() {
         FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
             .addAggregatableField("some_float", "float").build();
@@ -86,8 +89,8 @@ public void testDetect_GivenOutlierDetectionAndNonNumericField() {
             .addAggregatableField("some_keyword", "keyword").build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+        SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No compatible fields could be detected in index [source_index]." +
             " Supported types are [boolean, byte, double, float, half_float, integer, long, scaled_float, short]."));
@@ -99,7 +102,7 @@ public void testDetect_GivenOutlierDetectionAndFieldWithNumericAndNonNumericType
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
             SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No compatible fields could be detected in index [source_index]. " +
             "Supported types are [boolean, byte, double, float, half_float, integer, long, scaled_float, short]."));
@@ -171,7 +174,7 @@ public void testDetect_GivenRegressionAndRequiredFieldMissing() {
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
             SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("required field [foo] is missing; analysis requires fields [foo]"));
     }
@@ -183,11 +186,11 @@ public void testDetect_GivenRegressionAndRequiredFieldExcluded() {
             .addAggregatableField("some_keyword", "keyword")
             .addAggregatableField("foo", "float")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[0], new String[] {"foo"});
+        analyzedFields = new FetchSourceContext(true, new String[0], new String[] {"foo"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("foo", analyzedFields), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("required field [foo] is missing; analysis requires fields [foo]"));
     }
@@ -199,11 +202,11 @@ public void testDetect_GivenRegressionAndRequiredFieldNotIncluded() {
             .addAggregatableField("some_keyword", "keyword")
             .addAggregatableField("foo", "float")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[]  {"some_float", "some_keyword"}, new String[0]);
+        analyzedFields = new FetchSourceContext(true, new String[]  {"some_float", "some_keyword"}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("foo", analyzedFields), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("required field [foo] is missing; analysis requires fields [foo]"));
     }
@@ -213,10 +216,10 @@ public void testDetect_GivenFieldIsBothIncludedAndExcluded() {
             .addAggregatableField("foo", "float")
             .addAggregatableField("bar", "float")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[]  {"foo", "bar"}, new String[] {"foo"});
+        analyzedFields = new FetchSourceContext(true, new String[]  {"foo", "bar"}, new String[] {"foo"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(analyzedFields), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -239,7 +242,7 @@ public void testDetect_GivenRegressionAndRequiredFieldHasInvalidType() {
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
             SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("invalid types [keyword] for required field [foo]; " +
             "expected types are [byte, double, float, half_float, integer, long, scaled_float, short]"));
@@ -255,7 +258,7 @@ public void testDetect_GivenClassificationAndRequiredFieldHasInvalidType() {
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
             SOURCE_INDEX, buildClassificationConfig("some_float"), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("invalid types [float] for required field [some_float]; " +
             "expected types are [boolean, byte, integer, ip, keyword, long, short, text]"));
@@ -270,7 +273,7 @@ public void testDetect_GivenClassificationAndDependentVariableHasInvalidCardinal
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(SOURCE_INDEX,
             buildClassificationConfig("some_keyword"), false, 100, fieldCapabilities, Collections.singletonMap("some_keyword", 3L));
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("Field [some_keyword] must have at most [2] distinct values but there were at least [3]"));
     }
@@ -281,7 +284,7 @@ public void testDetect_GivenIgnoredField() {
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
             SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No compatible fields could be detected in index [source_index]. " +
             "Supported types are [boolean, byte, double, float, half_float, integer, long, scaled_float, short]."));
@@ -291,11 +294,11 @@ public void testDetect_GivenIncludedIgnoredField() {
         FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
             .addAggregatableField("_id", "float")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[]{"_id"}, new String[0]);
+        analyzedFields = new FetchSourceContext(true, new String[]{"_id"}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(analyzedFields), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No field [_id] could be detected"));
     }
@@ -304,11 +307,11 @@ public void testDetect_GivenExcludedFieldIsMissing() {
         FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
             .addAggregatableField("foo", "float")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[]{"*"}, new String[] {"bar"});
+        analyzedFields = new FetchSourceContext(true, new String[]{"*"}, new String[] {"bar"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(analyzedFields), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No field [bar] could be detected"));
     }
@@ -318,10 +321,10 @@ public void testDetect_GivenExcludedFieldIsUnsupported() {
             .addAggregatableField("numeric", "float")
             .addAggregatableField("categorical", "keyword")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, null, new String[] {"categorical"});
+        analyzedFields = new FetchSourceContext(true, null, new String[] {"categorical"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(analyzedFields), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
 
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
@@ -366,11 +369,11 @@ public void testDetect_GivenIncludeWithMissingField() {
             .addAggregatableField("my_field2", "float")
             .build();
 
-        FetchSourceContext desiredFields = new FetchSourceContext(true, new String[]{"your_field1", "my*"}, new String[0]);
+        analyzedFields = new FetchSourceContext(true, new String[]{"your_field1", "my*"}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(desiredFields), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No field [your_field1] could be detected"));
     }
@@ -381,11 +384,11 @@ public void testDetect_GivenExcludeAllValidFields() {
             .addAggregatableField("my_field2", "float")
             .build();
 
-        FetchSourceContext desiredFields = new FetchSourceContext(true, new String[0], new String[]{"my_*"});
+        analyzedFields = new FetchSourceContext(true, new String[0], new String[]{"my_*"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(desiredFields), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
         assertThat(e.getMessage(), equalTo("No compatible fields could be detected in index [source_index]. " +
             "Supported types are [boolean, byte, double, float, half_float, integer, long, scaled_float, short]."));
     }
@@ -397,10 +400,10 @@ public void testDetect_GivenInclusionsAndExclusions() {
             .addAggregatableField("your_field2", "float")
             .build();
 
-        FetchSourceContext desiredFields = new FetchSourceContext(true, new String[]{"your*", "my_*"}, new String[]{"*nope"});
+        analyzedFields = new FetchSourceContext(true, new String[]{"your*", "my_*"}, new String[]{"*nope"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(desiredFields), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
@@ -422,11 +425,11 @@ public void testDetect_GivenIncludedFieldHasUnsupportedType() {
             .addAggregatableField("your_keyword", "keyword")
             .build();
 
-        FetchSourceContext desiredFields = new FetchSourceContext(true, new String[]{"your*", "my_*"}, new String[]{"*nope"});
+        analyzedFields = new FetchSourceContext(true, new String[]{"your*", "my_*"}, new String[]{"*nope"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(desiredFields), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("field [your_keyword] has unsupported type [keyword]. " +
             "Supported types are [boolean, byte, double, float, half_float, integer, long, scaled_float, short]."));
@@ -442,7 +445,7 @@ public void testDetect_GivenIndexContainsResultsField() {
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
             SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("A field that matches the dest.results_field [ml] already exists; " +
             "please set a different results_field"));
@@ -479,11 +482,11 @@ public void testDetect_GivenIncludedResultsField() {
             .addAggregatableField("your_field2", "float")
             .addAggregatableField("your_keyword", "keyword")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[]{RESULTS_FIELD}, new String[0]);
+        analyzedFields = new FetchSourceContext(true, new String[]{RESULTS_FIELD}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(analyzedFields), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("A field that matches the dest.results_field [ml] already exists; " +
             "please set a different results_field"));
@@ -496,11 +499,11 @@ public void testDetect_GivenIncludedResultsFieldAndTaskIsRestarting() {
             .addAggregatableField("your_field2", "float")
             .addAggregatableField("your_keyword", "keyword")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[]{RESULTS_FIELD}, new String[0]);
+        analyzedFields = new FetchSourceContext(true, new String[]{RESULTS_FIELD}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(analyzedFields), true, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> extractedFieldsDetector.detect());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), true, 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No field [ml] could be detected"));
     }
@@ -814,10 +817,10 @@ public void testDetect_GivenMultiFields_AndExplicitlyIncludedFields() {
             .addAggregatableField("field_1.keyword", "keyword")
             .addAggregatableField("field_2", "float")
             .build();
-        FetchSourceContext analyzedFields = new FetchSourceContext(true, new String[] { "field_1", "field_2" }, new String[0]);
+        analyzedFields = new FetchSourceContext(true, new String[] { "field_1", "field_2" }, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("field_2", analyzedFields), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("field_2"), false, 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(2));
@@ -832,38 +835,76 @@ public void testDetect_GivenMultiFields_AndExplicitlyIncludedFields() {
         );
     }
 
-    private static DataFrameAnalyticsConfig buildOutlierDetectionConfig() {
-        return buildOutlierDetectionConfig(null);
+    public void testDetect_GivenSourceFilteringWithIncludes() {
+        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
+            .addAggregatableField("field_11", "float")
+            .addAggregatableField("field_12", "float")
+            .addAggregatableField("field_21", "float")
+            .addAggregatableField("field_22", "float").build();
+
+        sourceFiltering = new FetchSourceContext(true, new String[] {"field_1*"}, null);
+
+        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
+
+        List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
+        assertThat(allFields.size(), equalTo(2));
+        assertThat(allFields.get(0).getName(), equalTo("field_11"));
+        assertThat(allFields.get(1).getName(), equalTo("field_12"));
+
+        assertFieldSelectionContains(fieldExtraction.v2(),
+            FieldSelection.included("field_11", Collections.singleton("float"), false, FieldSelection.FeatureType.NUMERICAL),
+            FieldSelection.included("field_12", Collections.singleton("float"), false, FieldSelection.FeatureType.NUMERICAL));
+    }
+
+    public void testDetect_GivenSourceFilteringWithExcludes() {
+        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
+            .addAggregatableField("field_11", "float")
+            .addAggregatableField("field_12", "float")
+            .addAggregatableField("field_21", "float")
+            .addAggregatableField("field_22", "float").build();
+
+        sourceFiltering = new FetchSourceContext(true, null, new String[] {"field_1*"});
+
+        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
+
+        List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
+        assertThat(allFields.size(), equalTo(2));
+        assertThat(allFields.get(0).getName(), equalTo("field_21"));
+        assertThat(allFields.get(1).getName(), equalTo("field_22"));
+
+        assertFieldSelectionContains(fieldExtraction.v2(),
+            FieldSelection.included("field_21", Collections.singleton("float"), false, FieldSelection.FeatureType.NUMERICAL),
+            FieldSelection.included("field_22", Collections.singleton("float"), false, FieldSelection.FeatureType.NUMERICAL));
     }
 
-    private static DataFrameAnalyticsConfig buildOutlierDetectionConfig(FetchSourceContext analyzedFields) {
+    private DataFrameAnalyticsConfig buildOutlierDetectionConfig() {
         return new DataFrameAnalyticsConfig.Builder()
             .setId("foo")
-            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null))
+            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null, sourceFiltering))
             .setDest(new DataFrameAnalyticsDest(DEST_INDEX, RESULTS_FIELD))
             .setAnalyzedFields(analyzedFields)
             .setAnalysis(new OutlierDetection.Builder().build())
             .build();
     }
 
-    private static DataFrameAnalyticsConfig buildRegressionConfig(String dependentVariable) {
-        return buildRegressionConfig(dependentVariable, null);
-    }
-
-    private static DataFrameAnalyticsConfig buildRegressionConfig(String dependentVariable, FetchSourceContext analyzedFields) {
+    private DataFrameAnalyticsConfig buildRegressionConfig(String dependentVariable) {
         return new DataFrameAnalyticsConfig.Builder()
             .setId("foo")
-            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null))
+            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null, sourceFiltering))
             .setDest(new DataFrameAnalyticsDest(DEST_INDEX, RESULTS_FIELD))
             .setAnalyzedFields(analyzedFields)
             .setAnalysis(new Regression(dependentVariable))
             .build();
     }
 
-    private static DataFrameAnalyticsConfig buildClassificationConfig(String dependentVariable) {
+    private DataFrameAnalyticsConfig buildClassificationConfig(String dependentVariable) {
         return new DataFrameAnalyticsConfig.Builder()
             .setId("foo")
-            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null))
+            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null, sourceFiltering))
             .setDest(new DataFrameAnalyticsDest(DEST_INDEX, RESULTS_FIELD))
             .setAnalysis(new Classification(dependentVariable))
             .build();
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
index 0d2b5aea364eb..b1a2ba226b49f 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
@@ -71,7 +71,7 @@ public void setUpMocks() {
         analyticsConfig = new DataFrameAnalyticsConfig.Builder()
             .setId(JOB_ID)
             .setDescription(JOB_DESCRIPTION)
-            .setSource(new DataFrameAnalyticsSource(new String[] {"my_source"}, null))
+            .setSource(new DataFrameAnalyticsSource(new String[] {"my_source"}, null, null))
             .setDest(new DataFrameAnalyticsDest("my_dest", null))
             .setAnalysis(new Regression("foo"))
             .build();
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
index 6e1828efcd4ba..a1d78b7444057 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
@@ -41,7 +41,8 @@ setup:
           {
             "source": {
               "index": "index-source",
-              "query": {"term" : { "user" : "Kimchy" }}
+              "query": {"term" : { "user" : "Kimchy" }},
+              "_source": [ "obj1.*", "obj2.*" ]
             },
             "dest": {
               "index": "index-dest"
@@ -1852,3 +1853,28 @@ setup:
   }}
   - is_true: create_time
   - is_true: version
+
+---
+"Test put config given analyzed_fields include field excluded by source":
+
+  - do:
+      catch: /field \[excluded\] is included in \[analyzed_fields\] but not in \[source._source\]/
+      ml.put_data_frame_analytics:
+        id: "analyzed_fields-include-field-excluded-by-source"
+        body: >
+          {
+            "source": {
+              "index": "index-source",
+              "query": {"term" : { "user" : "Kimchy" }},
+              "_source": {
+                "excludes": ["excluded"]
+              }
+            },
+            "dest": {
+              "index": "index-dest"
+            },
+            "analysis": {"outlier_detection":{}},
+            "analyzed_fields": {
+              "includes": ["excluded"]
+            }
+          }

From f3b24bd25e24144cadd8a4de69d4955d4b0331b7 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 29 Nov 2019 14:38:06 +0200
Subject: [PATCH 025/686] [ML] Mute data frame analytics BWC tests

Until #49690 is backported to 7.x
---
 .../test/mixed_cluster/90_ml_data_frame_analytics_crud.yml   | 5 +++++
 .../test/old_cluster/90_ml_data_frame_analytics_crud.yml     | 3 +++
 .../upgraded_cluster/90_ml_data_frame_analytics_crud.yml     | 5 +++++
 3 files changed, 13 insertions(+)

diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
index b0cb91c4c0f5c..8082147160718 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,3 +1,8 @@
+setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
+
 ---
 "Get old outlier_detection job":
 
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
index fe160bba15f23..ba2cf40411672 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,4 +1,7 @@
 setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
 
   - do:
       index:
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
index 28ec80c6373a2..462a1fd76c011 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,3 +1,8 @@
+setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
+
 ---
 "Get old cluster outlier_detection job":
 

From b13420436a7aaa64256312c2565249ad8ee7a815 Mon Sep 17 00:00:00 2001
From: Ignacio Vera <ivera@apache.org>
Date: Fri, 29 Nov 2019 15:00:38 +0100
Subject: [PATCH 026/686] Replace usages of XPackPlugin with the
 LocalStateCompositeXPackPlugin (#49714)

---
 .../xpack/analytics/mapper/HistogramFieldMapperTests.java    | 4 ++--
 .../mapper/HistogramPercentileAggregationTests.java          | 5 ++---
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapperTests.java b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapperTests.java
index 8878d86fb2051..055b01186cd61 100644
--- a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapperTests.java
+++ b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapperTests.java
@@ -18,7 +18,7 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.xpack.analytics.AnalyticsPlugin;
-import org.elasticsearch.xpack.core.XPackPlugin;
+import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -502,7 +502,7 @@ public void testNegativeCount() throws Exception {
     protected Collection<Class<? extends Plugin>> getPlugins() {
         List<Class<? extends Plugin>> plugins = new ArrayList<>(super.getPlugins());
         plugins.add(AnalyticsPlugin.class);
-        plugins.add(XPackPlugin.class);
+        plugins.add(LocalStateCompositeXPackPlugin.class);
         return plugins;
     }
 
diff --git a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramPercentileAggregationTests.java b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramPercentileAggregationTests.java
index 9561870f55495..1c826449d4a3f 100644
--- a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramPercentileAggregationTests.java
+++ b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramPercentileAggregationTests.java
@@ -28,7 +28,7 @@
 import org.elasticsearch.search.aggregations.metrics.TDigestState;
 import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.xpack.analytics.AnalyticsPlugin;
-import org.elasticsearch.xpack.core.XPackPlugin;
+import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -225,12 +225,11 @@ public void testTDigestHistogram() throws Exception {
         }
     }
 
-
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
         List<Class<? extends Plugin>> plugins = new ArrayList<>(super.getPlugins());
         plugins.add(AnalyticsPlugin.class);
-        plugins.add(XPackPlugin.class);
+        plugins.add(LocalStateCompositeXPackPlugin.class);
         return plugins;
     }
 

From dde2a06bc726021eb2d10c93bcc400587ccaf03e Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 29 Nov 2019 17:25:45 +0200
Subject: [PATCH 027/686] [ML] Fix DFA source filtering versions and unmute BWC
 tests (#49725)

Relates #49690
---
 .../xpack/core/ml/dataframe/DataFrameAnalyticsSource.java    | 4 ++--
 .../test/mixed_cluster/90_ml_data_frame_analytics_crud.yml   | 5 -----
 .../test/old_cluster/90_ml_data_frame_analytics_crud.yml     | 3 ---
 .../upgraded_cluster/90_ml_data_frame_analytics_crud.yml     | 5 -----
 4 files changed, 2 insertions(+), 15 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSource.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSource.java
index c5e5515deb0b5..42ab45d101aa2 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSource.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsSource.java
@@ -77,7 +77,7 @@ public DataFrameAnalyticsSource(String[] index, @Nullable QueryProvider queryPro
     public DataFrameAnalyticsSource(StreamInput in) throws IOException {
         index = in.readStringArray();
         queryProvider = QueryProvider.fromStream(in);
-        if (in.getVersion().onOrAfter(Version.CURRENT)) {
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
             sourceFiltering = in.readOptionalWriteable(FetchSourceContext::new);
         } else {
             sourceFiltering = null;
@@ -95,7 +95,7 @@ public DataFrameAnalyticsSource(DataFrameAnalyticsSource other) {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeStringArray(index);
         queryProvider.writeTo(out);
-        if (out.getVersion().onOrAfter(Version.CURRENT)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             out.writeOptionalWriteable(sourceFiltering);
         }
     }
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
index 8082147160718..b0cb91c4c0f5c 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,8 +1,3 @@
-setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
-
 ---
 "Get old outlier_detection job":
 
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
index ba2cf40411672..fe160bba15f23 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,7 +1,4 @@
 setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
 
   - do:
       index:
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
index 462a1fd76c011..28ec80c6373a2 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,8 +1,3 @@
-setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
-
 ---
 "Get old cluster outlier_detection job":
 

From d62579cbe7ceef5bd6dcd7af4bc7835bed61d6f2 Mon Sep 17 00:00:00 2001
From: Marios Trivyzas <matriv@gmail.com>
Date: Fri, 29 Nov 2019 17:06:26 +0100
Subject: [PATCH 028/686] SQL: Fix issues with WEEK/ISO_WEEK/DATEDIFF (#49405)

Some extended testing with MS-SQL server and H2 (which agree on
results) revealed bugs in the implementation of WEEK related extraction
and diff functions.

Non-iso WEEK seems to be broken since #48209 because
of the replacement of Calendar and the change in the ISO rules.

ISO_WEEK failed for some edge cases around the January 1st.

DATE_DIFF was previously based on non-iso WEEK extraction which seems
not to be the case.

Fixes: #49376
---
 .../sql/qa/src/main/resources/date.csv-spec   |  8 ++--
 .../main/resources/datetime-interval.csv-spec |  5 +-
 .../qa/src/main/resources/datetime.csv-spec   | 27 +++++++----
 .../function/scalar/datetime/DateDiff.java    | 17 +++----
 .../scalar/datetime/DateTimeProcessor.java    |  7 ++-
 .../datetime/NonIsoDateTimeProcessor.java     |  3 +-
 .../datetime/DateDiffProcessorTests.java      | 44 ++++++++++++++++++
 .../datetime/DateTimeProcessorTests.java      | 46 +++++++++++++++++++
 .../NonIsoDateTimeProcessorTests.java         | 44 ++++++++++++++++++
 9 files changed, 172 insertions(+), 29 deletions(-)

diff --git a/x-pack/plugin/sql/qa/src/main/resources/date.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/date.csv-spec
index 46557c77884e8..828d110556720 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/date.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/date.csv-spec
@@ -85,12 +85,12 @@ YEAR(CAST(birth_date AS DATE)) y,
 birth_date, last_name l FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 
  d:i      | dm:i     | dw:i     | dy:i    | iso_dw:i  | w:i    |iso_w:i | q:i    | y:i    | birth_date:ts        | l:s
-2         |2         |4         |245      |3          |36      |35      |3       |1953    |1953-09-02T00:00:00Z  |Facello
-2         |2         |3         |154      |2          |23      |22      |2       |1964    |1964-06-02T00:00:00Z  |Simmel
+2         |2         |4         |245      |3          |36      |36      |3       |1953    |1953-09-02T00:00:00Z  |Facello
+2         |2         |3         |154      |2          |23      |23      |2       |1964    |1964-06-02T00:00:00Z  |Simmel
 3         |3         |5         |337      |4          |49      |49      |4       |1959    |1959-12-03T00:00:00Z  |Bamford
-1         |1         |7         |121      |6          |18      |18      |2       |1954    |1954-05-01T00:00:00Z  |Koblick
+1         |1         |7         |121      |6          |18      |17      |2       |1954    |1954-05-01T00:00:00Z  |Koblick
 21        |21        |6         |21       |5          |4       |3       |1       |1955    |1955-01-21T00:00:00Z  |Maliniak
-20        |20        |2         |110      |1          |17      |16      |2       |1953    |1953-04-20T00:00:00Z  |Preusig
+20        |20        |2         |110      |1          |17      |17      |2       |1953    |1953-04-20T00:00:00Z  |Preusig
 23        |23        |5         |143      |4          |21      |21      |2       |1957    |1957-05-23T00:00:00Z  |Zielinski
 19        |19        |4         |50       |3          |8       |8       |1       |1958    |1958-02-19T00:00:00Z  |Kalloufi
 19        |19        |7         |110      |6          |16      |16      |2       |1952    |1952-04-19T00:00:00Z  |Peac
diff --git a/x-pack/plugin/sql/qa/src/main/resources/datetime-interval.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/datetime-interval.csv-spec
index 3a01c7e656563..9bb89408923b6 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/datetime-interval.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/datetime-interval.csv-spec
@@ -313,7 +313,7 @@ SELECT birth_date, MAX(hire_date) - INTERVAL 1 YEAR AS f FROM test_emp GROUP BY
 ;
 
 monthOfDatePlusInterval_And_GroupBy
-SELECT WEEK_OF_YEAR(birth_date + INTERVAL 25 YEAR) x, COUNT(*) c FROM test_emp GROUP BY x HAVING c >= 3 ORDER BY c DESC;
+SELECT WEEK_OF_YEAR(birth_date + INTERVAL 25 YEAR) x, COUNT(*) c FROM test_emp GROUP BY x HAVING c >= 3 ORDER BY c DESC, x ASC;
 
       x:i      |       c:l       
 ---------------+---------------
@@ -324,8 +324,7 @@ null           |10
 30             |4              
 40             |4              
 45             |4              
-1              |3              
-8              |3              
+8              |3
 21             |3              
 28             |3              
 32             |3              
diff --git a/x-pack/plugin/sql/qa/src/main/resources/datetime.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/datetime.csv-spec
index df94a0d25c0b4..16550c3e9144e 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/datetime.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/datetime.csv-spec
@@ -110,6 +110,15 @@ SELECT WEEK(birth_date) week, birth_date FROM test_emp ORDER BY WEEK(birth_date)
 44             |1961-11-02T00:00:00.000Z
 ;
 
+weekOfYearVsIsoWeekOfYearEdgeCases
+SELECT ISO_WEEK_OF_YEAR('2005-01-01T00:00:00.000Z'::datetime) AS "isow2005", WEEK('2005-01-01T00:00:00.000Z'::datetime) AS "w2005",
+ISO_WEEK_OF_YEAR('2007-12-31T00:00:00.000Z'::datetime) AS "isow2007", WEEK('2007-12-31T00:00:00.000Z'::datetime) AS "w2007";
+
+   isow2005    |     w2005     |   isow2007    |     w2007
+---------------+---------------+---------------+---------------
+53             |1              |1              |53
+;
+
 weekOfYearWithFilter
 SELECT WEEK(birth_date) week, birth_date FROM test_emp WHERE WEEK(birth_date) > 50 OR WEEK(birth_date) < 4 ORDER BY WEEK(birth_date) DESC, birth_date DESC;
 
@@ -319,7 +328,7 @@ DATEDIFF('milliseconds', '2019-09-04'::date, '2019-09-06'::date) as diff_millis,
 
  diff_year | diff_quarter | diff_month | diff_week | diff_day | diff_hours | diff_min | diff_sec  | diff_millis | diff_mcsec | diff_nsec
 -----------+--------------+------------+-----------+----------+------------+----------+-----------+-------------+------------+----------
-9          | -91          | 269        | -611      | 11683    | -64248     | 1676160  | -14083200 | 172800000   | 0          | 0
+9          | -91          | 269        | -610      | 11683    | -64248     | 1676160  | -14083200 | 172800000   | 0          | 0
 ;
 
 selectDateDiffWithField
@@ -331,13 +340,13 @@ FROM test_emp WHERE emp_no >= 10032 AND emp_no <= 10042 ORDER BY 1;
 
  emp_no  |      birth_date          |       hire_date          |  diff_year | diff_quarter | diff_month | diff_week | diff_day | diff_min  | diff_sec
 ---------+--------------------------+--------------------------+------------+--------------+------------+-----------+----------+-----------+----------
-10032    | 1960-08-09 00:00:00.000Z | 1990-06-20 00:00:00.000Z | 30         | -119         | 358        | -1559     | 10907    | -15706080 | 942364800
-10033    | 1956-11-14 00:00:00.000Z | 1987-03-18 00:00:00.000Z | 31         | -121         | 364        | -1584     | 11081    | -15956640 | 957398400
+10032    | 1960-08-09 00:00:00.000Z | 1990-06-20 00:00:00.000Z | 30         | -119         | 358        | -1558     | 10907    | -15706080 | 942364800
+10033    | 1956-11-14 00:00:00.000Z | 1987-03-18 00:00:00.000Z | 31         | -121         | 364        | -1583     | 11081    | -15956640 | 957398400
 10034    | 1962-12-29 00:00:00.000Z | 1988-09-21 00:00:00.000Z | 26         | -103         | 309        | -1343     | 9398     | -13533120 | 811987200
-10035    | 1953-02-08 00:00:00.000Z | 1988-09-05 00:00:00.000Z | 35         | -142         | 427        | -1857     | 12993    | -18709920 | 1122595200
-10036    | 1959-08-10 00:00:00.000Z | 1992-01-03 00:00:00.000Z | 33         | -130         | 389        | -1691     | 11834    | -17040960 | 1022457600
-10037    | 1963-07-22 00:00:00.000Z | 1990-12-05 00:00:00.000Z | 27         | -109         | 329        | -1429     | 9998     | -14397120 | 863827200
-10038    | 1960-07-20 00:00:00.000Z | 1989-09-20 00:00:00.000Z | 29         | -116         | 350        | -1523     | 10654    | -15341760 | 920505600
+10035    | 1953-02-08 00:00:00.000Z | 1988-09-05 00:00:00.000Z | 35         | -142         | 427        | -1856     | 12993    | -18709920 | 1122595200
+10036    | 1959-08-10 00:00:00.000Z | 1992-01-03 00:00:00.000Z | 33         | -130         | 389        | -1690     | 11834    | -17040960 | 1022457600
+10037    | 1963-07-22 00:00:00.000Z | 1990-12-05 00:00:00.000Z | 27         | -109         | 329        | -1428     | 9998     | -14397120 | 863827200
+10038    | 1960-07-20 00:00:00.000Z | 1989-09-20 00:00:00.000Z | 29         | -116         | 350        | -1522     | 10654    | -15341760 | 920505600
 10039    | 1959-10-01 00:00:00.000Z | 1988-01-19 00:00:00.000Z | 29         | -113         | 339        | -1477     | 10337    | -14885280 | 893116800
 10040    | null                     | 1993-02-14 00:00:00.000Z | null       | null         | null       | null      | null     | null      | null
 10041    | null                     | 1989-11-12 00:00:00.000Z | null       | null         | null       | null      | null     | null      | null
@@ -451,8 +460,8 @@ SELECT count(*) as count, DATE_DIFF('weeks', birth_date, hire_date) diff FROM te
   count  |  diff
 ---------+------
 10       | null
-1        | 1121
-1        | 1124
+1        | 1120
+1        | 1123
 1        | 1168
 1        | 1196
 ;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiff.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiff.java
index 3ccb7f66b5634..b9521cbf1880d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiff.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiff.java
@@ -25,7 +25,8 @@
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isDate;
 import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isString;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NonIsoDateTimeProcessor.NonIsoDateTimeExtractor;
+import static org.elasticsearch.xpack.sql.util.DateUtils.DAY_IN_MILLIS;
+import static org.elasticsearch.xpack.sql.util.DateUtils.UTC;
 
 public class DateDiff extends ThreeArgsDateTimeFunction {
 
@@ -39,15 +40,11 @@ public enum Part implements DateTimeField {
         DAYOFYEAR((start, end) -> safeInt(diffInDays(start, end)), "dy", "y"),
         DAY(DAYOFYEAR::diff, "days", "dd", "d"),
         WEEK((start, end) -> {
-            int extraWeek = NonIsoDateTimeExtractor.WEEK_OF_YEAR.extract(end) -
-                NonIsoDateTimeExtractor.WEEK_OF_YEAR.extract(start) == 0 ? 0 : 1;
-            long diffWeeks = diffInDays(start, end) / 7;
-            if (diffWeeks < 0) {
-                diffWeeks -= extraWeek;
-            } else {
-                diffWeeks += extraWeek;
-            }
-            return safeInt(diffWeeks);
+            long startInDays =  start.toInstant().toEpochMilli() / DAY_IN_MILLIS -
+                    DatePart.Part.WEEKDAY.extract(start.withZoneSameInstant(UTC));
+            long endInDays =  end.toInstant().toEpochMilli() / DAY_IN_MILLIS -
+                    DatePart.Part.WEEKDAY.extract(end.withZoneSameInstant(UTC));
+            return safeInt((endInDays - startInDays) / 7);
         }, "weeks", "wk", "ww"),
         WEEKDAY(DAYOFYEAR::diff,  "weekdays", "dw"),
         HOUR((start, end) -> safeInt(diffInHours(start, end)),  "hours", "hh"),
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeProcessor.java
index d0f7b5d9afc3a..758c1e0cd6f09 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeProcessor.java
@@ -13,6 +13,7 @@
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
 import java.time.temporal.ChronoField;
+import java.time.temporal.WeekFields;
 import java.util.Objects;
 
 public class DateTimeProcessor extends BaseDateTimeProcessor {
@@ -36,7 +37,11 @@ public enum DateTimeExtractor {
         }
 
         public int extract(ZonedDateTime dt) {
-            return dt.get(field);
+            if (field == ChronoField.ALIGNED_WEEK_OF_YEAR) {
+                return dt.get(WeekFields.ISO.weekOfWeekBasedYear());
+            } else {
+                return dt.get(field);
+            }
         }
 
         public int extract(OffsetTime time) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeProcessor.java
index 785a815a45c2a..f6f0f2ba6e135 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeProcessor.java
@@ -10,7 +10,6 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 
 import java.io.IOException;
-import java.time.DayOfWeek;
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
 import java.time.temporal.ChronoField;
@@ -28,7 +27,7 @@ public enum NonIsoDateTimeExtractor {
             return dayOfWeek == 8 ? 1 : dayOfWeek;
         }),
         WEEK_OF_YEAR(zdt -> {
-            return zdt.get(WeekFields.of(DayOfWeek.SUNDAY, 1).weekOfWeekBasedYear());
+            return zdt.get(WeekFields.SUNDAY_START.weekOfYear());
         });
 
         private final Function<ZonedDateTime, Integer> apply;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessorTests.java
index 7753199179346..19d329cc42415 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessorTests.java
@@ -274,6 +274,17 @@ public void testDiffEdgeCases() {
         assertEquals(-350, new DateDiff(Source.EMPTY, l("ww"), dt2, dt1, zoneId)
             .makePipe().asProcessor().process(null));
 
+        dt1 = l(dateTime(1988, 1, 2, 0, 0, 0, 0));
+        dt2 = l(dateTime(1987, 12, 29, 0, 0, 0, 0));
+        assertEquals(0, new DateDiff(Source.EMPTY, l("week"), dt1, dt2, UTC)
+            .makePipe().asProcessor().process(null));
+        assertEquals(0, new DateDiff(Source.EMPTY, l("weeks"), dt2, dt1, UTC)
+            .makePipe().asProcessor().process(null));
+        assertEquals(0, new DateDiff(Source.EMPTY, l("wk"), dt1, dt2, zoneId)
+            .makePipe().asProcessor().process(null));
+        assertEquals(0, new DateDiff(Source.EMPTY, l("ww"), dt2, dt1, zoneId)
+            .makePipe().asProcessor().process(null));
+
         dt1 = l(dateTime(1988, 1, 5, 0, 0, 0, 0));
         dt2 = l(dateTime(1996, 5, 13, 0, 0, 0, 0));
         assertEquals(436, new DateDiff(Source.EMPTY, l("week"), dt1, dt2, UTC)
@@ -285,6 +296,39 @@ public void testDiffEdgeCases() {
         assertEquals(-436, new DateDiff(Source.EMPTY, l("ww"), dt2, dt1, zoneId)
             .makePipe().asProcessor().process(null));
 
+        dt1 = l(dateTime(1999, 8, 20, 0, 0, 0, 0));
+        dt2 = l(dateTime(1974, 3, 17, 0, 0, 0, 0));
+        assertEquals(-1326, new DateDiff(Source.EMPTY, l("week"), dt1, dt2, UTC)
+            .makePipe().asProcessor().process(null));
+        assertEquals(1326, new DateDiff(Source.EMPTY, l("weeks"), dt2, dt1, UTC)
+            .makePipe().asProcessor().process(null));
+        assertEquals(-1326, new DateDiff(Source.EMPTY, l("wk"), dt1, dt2, zoneId)
+            .makePipe().asProcessor().process(null));
+        assertEquals(1326, new DateDiff(Source.EMPTY, l("ww"), dt2, dt1, zoneId)
+            .makePipe().asProcessor().process(null));
+
+        dt1 = l(dateTime(1997, 2, 2, 0, 0, 0, 0));
+        dt2 = l(dateTime(1997, 9, 19, 0, 0, 0, 0));
+        assertEquals(32, new DateDiff(Source.EMPTY, l("week"), dt1, dt2, UTC)
+            .makePipe().asProcessor().process(null));
+        assertEquals(-32, new DateDiff(Source.EMPTY, l("weeks"), dt2, dt1, UTC)
+            .makePipe().asProcessor().process(null));
+        assertEquals(32, new DateDiff(Source.EMPTY, l("wk"), dt1, dt2, zoneId)
+            .makePipe().asProcessor().process(null));
+        assertEquals(-32, new DateDiff(Source.EMPTY, l("ww"), dt2, dt1, zoneId)
+            .makePipe().asProcessor().process(null));
+
+        dt1 = l(dateTime(1980, 11, 7, 0, 0, 0, 0));
+        dt2 = l(dateTime(1979, 4, 1, 0, 0, 0, 0));
+        assertEquals(-83, new DateDiff(Source.EMPTY, l("week"), dt1, dt2, UTC)
+            .makePipe().asProcessor().process(null));
+        assertEquals(83, new DateDiff(Source.EMPTY, l("weeks"), dt2, dt1, UTC)
+            .makePipe().asProcessor().process(null));
+        assertEquals(-83, new DateDiff(Source.EMPTY, l("wk"), dt1, dt2, zoneId)
+            .makePipe().asProcessor().process(null));
+        assertEquals(83, new DateDiff(Source.EMPTY, l("ww"), dt2, dt1, zoneId)
+            .makePipe().asProcessor().process(null));
+
         dt1 = l(dateTime(1997, 9, 19, 0, 0, 0, 0));
         dt2 = l(dateTime(2004, 8, 2, 7, 59, 23, 0));
         assertEquals(60223, new DateDiff(Source.EMPTY, l("hour"), dt1, dt2, UTC)
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeProcessorTests.java
index 2c5a26cc115df..4dac20646cfd2 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeProcessorTests.java
@@ -53,6 +53,29 @@ public void testApply_withTimezoneUTC() {
         assertEquals(1, proc.process(dateTime(0L)));
         assertEquals(2, proc.process(dateTime(2017, 01, 02, 10, 10)));
         assertEquals(31, proc.process(dateTime(2017, 01, 31, 10, 10)));
+
+        // Tested against MS-SQL Server and H2
+        proc = new DateTimeProcessor(DateTimeExtractor.ISO_WEEK_OF_YEAR, UTC);
+        assertEquals(1, proc.process(dateTime(1988, 1, 5, 0, 0, 0, 0)));
+        assertEquals(5, proc.process(dateTime(2001, 2, 4, 0, 0, 0, 0)));
+        assertEquals(6, proc.process(dateTime(1977, 2, 8, 0, 0, 0, 0)));
+        assertEquals(11, proc.process(dateTime(1974, 3, 17, 0, 0, 0, 0)));
+        assertEquals(16, proc.process(dateTime(1977, 4, 20, 0, 0, 0, 0)));
+        assertEquals(16, proc.process(dateTime(1994, 4, 20, 0, 0, 0, 0)));
+        assertEquals(17, proc.process(dateTime(2002, 4, 27, 0, 0, 0, 0)));
+        assertEquals(18, proc.process(dateTime(1974, 5, 3, 0, 0, 0, 0)));
+        assertEquals(22, proc.process(dateTime(1997, 5, 30, 0, 0, 0, 0)));
+        assertEquals(22, proc.process(dateTime(1995, 6, 4, 0, 0, 0, 0)));
+        assertEquals(28, proc.process(dateTime(1972, 7, 12, 0, 0, 0, 0)));
+        assertEquals(30, proc.process(dateTime(1980, 7, 26, 0, 0, 0, 0)));
+        assertEquals(33, proc.process(dateTime(1998, 8, 12, 0, 0, 0, 0)));
+        assertEquals(35, proc.process(dateTime(1995, 9, 3, 0, 0, 0, 0)));
+        assertEquals(37, proc.process(dateTime(1976, 9, 9, 0, 0, 0, 0)));
+        assertEquals(38, proc.process(dateTime(1997, 9, 19, 0, 0, 0, 0)));
+        assertEquals(45, proc.process(dateTime(1980, 11, 7, 0, 0, 0, 0)));
+        assertEquals(53, proc.process(dateTime(2005, 1, 1, 0, 0, 0, 0)));
+        assertEquals(1, proc.process(dateTime(2007, 12, 31, 0, 0, 0, 0)));
+        assertEquals(1, proc.process(dateTime(2019, 12, 31, 20, 22, 33, 987654321)));
     }
 
     public void testApply_withTimezoneOtherThanUTC() {
@@ -62,6 +85,29 @@ public void testApply_withTimezoneOtherThanUTC() {
 
         proc = new DateTimeProcessor(DateTimeExtractor.DAY_OF_MONTH, zoneId);
         assertEquals(1, proc.process(dateTime(2017, 12, 31, 20, 30)));
+
+        // Tested against MS-SQL Server and H2
+        proc = new DateTimeProcessor(DateTimeExtractor.ISO_WEEK_OF_YEAR, UTC);
+        assertEquals(1, proc.process(dateTime(1988, 1, 5, 0, 0, 0, 0)));
+        assertEquals(5, proc.process(dateTime(2001, 2, 4, 0, 0, 0, 0)));
+        assertEquals(6, proc.process(dateTime(1977, 2, 8, 0, 0, 0, 0)));
+        assertEquals(11, proc.process(dateTime(1974, 3, 17, 0, 0, 0, 0)));
+        assertEquals(16, proc.process(dateTime(1977, 4, 20, 0, 0, 0, 0)));
+        assertEquals(16, proc.process(dateTime(1994, 4, 20, 0, 0, 0, 0)));
+        assertEquals(17, proc.process(dateTime(2002, 4, 27, 0, 0, 0, 0)));
+        assertEquals(18, proc.process(dateTime(1974, 5, 3, 0, 0, 0, 0)));
+        assertEquals(22, proc.process(dateTime(1997, 5, 30, 0, 0, 0, 0)));
+        assertEquals(22, proc.process(dateTime(1995, 6, 4, 0, 0, 0, 0)));
+        assertEquals(28, proc.process(dateTime(1972, 7, 12, 0, 0, 0, 0)));
+        assertEquals(30, proc.process(dateTime(1980, 7, 26, 0, 0, 0, 0)));
+        assertEquals(33, proc.process(dateTime(1998, 8, 12, 0, 0, 0, 0)));
+        assertEquals(35, proc.process(dateTime(1995, 9, 3, 0, 0, 0, 0)));
+        assertEquals(37, proc.process(dateTime(1976, 9, 9, 0, 0, 0, 0)));
+        assertEquals(38, proc.process(dateTime(1997, 9, 19, 0, 0, 0, 0)));
+        assertEquals(45, proc.process(dateTime(1980, 11, 7, 0, 0, 0, 0)));
+        assertEquals(53, proc.process(dateTime(2005, 1, 1, 0, 0, 0, 0)));
+        assertEquals(1, proc.process(dateTime(2007, 12, 31, 0, 0, 0, 0)));
+        assertEquals(1, proc.process(dateTime(2019, 12, 31, 20, 22, 33, 987654321)));
     }
 
     public void testFailOnTime() {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeProcessorTests.java
index a1971cecad1d5..907c60709a2da 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeProcessorTests.java
@@ -55,6 +55,28 @@ public void testNonISOWeekOfYearInUTC() {
         assertEquals(17, proc.process(dateTime(766833730000L))); //1994-04-20T09:22:10Z[UTC]
         assertEquals(29, proc.process(dateTime(79780930000L)));  //1972-07-12T09:22:10Z[UTC]
         assertEquals(33, proc.process(dateTime(902913730000L))); //1998-08-12T09:22:10Z[UTC]
+
+        // Tested against MS-SQL Server and H2
+        assertEquals(2, proc.process(dateTime(1988, 1, 5, 0, 0, 0, 0)));
+        assertEquals(6, proc.process(dateTime(2001, 2, 4, 0, 0, 0, 0)));
+        assertEquals(7, proc.process(dateTime(1977, 2, 8, 0, 0, 0, 0)));
+        assertEquals(12, proc.process(dateTime(1974, 3, 17, 0, 0, 0, 0)));
+        assertEquals(17, proc.process(dateTime(1977, 4, 20, 0, 0, 0, 0)));
+        assertEquals(17, proc.process(dateTime(1994, 4, 20, 0, 0, 0, 0)));
+        assertEquals(17, proc.process(dateTime(2002, 4, 27, 0, 0, 0, 0)));
+        assertEquals(18, proc.process(dateTime(1974, 5, 3, 0, 0, 0, 0)));
+        assertEquals(22, proc.process(dateTime(1997, 5, 30, 0, 0, 0, 0)));
+        assertEquals(23, proc.process(dateTime(1995, 6, 4, 0, 0, 0, 0)));
+        assertEquals(29, proc.process(dateTime(1972, 7, 12, 0, 0, 0, 0)));
+        assertEquals(30, proc.process(dateTime(1980, 7, 26, 0, 0, 0, 0)));
+        assertEquals(33, proc.process(dateTime(1998, 8, 12, 0, 0, 0, 0)));
+        assertEquals(36, proc.process(dateTime(1995, 9, 3, 0, 0, 0, 0)));
+        assertEquals(37, proc.process(dateTime(1976, 9, 9, 0, 0, 0, 0)));
+        assertEquals(38, proc.process(dateTime(1997, 9, 19, 0, 0, 0, 0)));
+        assertEquals(45, proc.process(dateTime(1980, 11, 7, 0, 0, 0, 0)));
+        assertEquals(1, proc.process(dateTime(2005, 1, 1, 0, 0, 0, 0)));
+        assertEquals(53, proc.process(dateTime(2007, 12, 31, 0, 0, 0, 0)));
+        assertEquals(53, proc.process(dateTime(2019, 12, 31, 20, 22, 33, 987654321)));
     }
 
     public void testNonISOWeekOfYearInNonUTCTimeZone() {
@@ -68,6 +90,28 @@ public void testNonISOWeekOfYearInNonUTCTimeZone() {
         assertEquals(17, proc.process(dateTime(766833730000L)));
         assertEquals(29, proc.process(dateTime(79780930000L)));
         assertEquals(33, proc.process(dateTime(902913730000L)));
+
+        // Tested against MS-SQL Server and H2
+        assertEquals(2, proc.process(dateTime(1988, 1, 5, 0, 0, 0, 0)));
+        assertEquals(5, proc.process(dateTime(2001, 2, 4, 0, 0, 0, 0)));
+        assertEquals(7, proc.process(dateTime(1977, 2, 8, 0, 0, 0, 0)));
+        assertEquals(11, proc.process(dateTime(1974, 3, 17, 0, 0, 0, 0)));
+        assertEquals(17, proc.process(dateTime(1977, 4, 20, 0, 0, 0, 0)));
+        assertEquals(17, proc.process(dateTime(1994, 4, 20, 0, 0, 0, 0)));
+        assertEquals(17, proc.process(dateTime(2002, 4, 27, 0, 0, 0, 0)));
+        assertEquals(18, proc.process(dateTime(1974, 5, 3, 0, 0, 0, 0)));
+        assertEquals(22, proc.process(dateTime(1997, 5, 30, 0, 0, 0, 0)));
+        assertEquals(22, proc.process(dateTime(1995, 6, 4, 0, 0, 0, 0)));
+        assertEquals(29, proc.process(dateTime(1972, 7, 12, 0, 0, 0, 0)));
+        assertEquals(30, proc.process(dateTime(1980, 7, 26, 0, 0, 0, 0)));
+        assertEquals(33, proc.process(dateTime(1998, 8, 12, 0, 0, 0, 0)));
+        assertEquals(35, proc.process(dateTime(1995, 9, 3, 0, 0, 0, 0)));
+        assertEquals(37, proc.process(dateTime(1976, 9, 9, 0, 0, 0, 0)));
+        assertEquals(38, proc.process(dateTime(1997, 9, 19, 0, 0, 0, 0)));
+        assertEquals(45, proc.process(dateTime(1980, 11, 7, 0, 0, 0, 0)));
+        assertEquals(53, proc.process(dateTime(2005, 1, 1, 0, 0, 0, 0)));
+        assertEquals(53, proc.process(dateTime(2007, 12, 31, 0, 0, 0, 0)));
+        assertEquals(53, proc.process(dateTime(2019, 12, 31, 20, 22, 33, 987654321)));
     }
     
     public void testNonISODayOfWeekInUTC() {

From 9866ca084f38c1c01f15e2f5b2eab552cc8c9f9e Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Fri, 29 Nov 2019 17:46:44 +0100
Subject: [PATCH 029/686] Deprecate sorting in reindex (#49458)

Reindex sort never gave a guarantee about the order of documents being
indexed into the destination, though it could give a sense of locality
of source data.

It prevents us from doing resilient reindex and other optimizations and
it has therefore been deprecated.

Related to #47567
---
 .../documentation/CRUDDocumentationIT.java    |  5 --
 .../high-level/document/reindex.asciidoc      | 10 ----
 docs/reference/docs/reindex.asciidoc          | 42 ++++---------
 .../ilm/ilm-with-existing-indices.asciidoc    |  6 +-
 .../index/reindex/Reindexer.java              |  9 +++
 .../index/reindex/ReindexSingleNodeTests.java | 60 +++++++++++++++++++
 .../rest-api-spec/test/reindex/30_search.yml  |  8 ++-
 .../index/reindex/ReindexRequest.java         |  3 +
 8 files changed, 95 insertions(+), 48 deletions(-)
 create mode 100644 modules/reindex/src/test/java/org/elasticsearch/index/reindex/ReindexSingleNodeTests.java

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CRUDDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CRUDDocumentationIT.java
index 9d88bb2ff222a..b579b81e2eea5 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CRUDDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CRUDDocumentationIT.java
@@ -83,7 +83,6 @@
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
-import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.tasks.TaskId;
 
 import java.util.Collections;
@@ -833,10 +832,6 @@ public void testReindex() throws Exception {
             // tag::reindex-request-pipeline
             request.setDestPipeline("my_pipeline"); // <1>
             // end::reindex-request-pipeline
-            // tag::reindex-request-sort
-            request.addSortField("field1", SortOrder.DESC); // <1>
-            request.addSortField("field2", SortOrder.ASC); // <2>
-            // end::reindex-request-sort
             // tag::reindex-request-script
             request.setScript(
                 new Script(
diff --git a/docs/java-rest/high-level/document/reindex.asciidoc b/docs/java-rest/high-level/document/reindex.asciidoc
index f30b9eef4a41b..c094a5f1ab7eb 100644
--- a/docs/java-rest/high-level/document/reindex.asciidoc
+++ b/docs/java-rest/high-level/document/reindex.asciidoc
@@ -89,16 +89,6 @@ include-tagged::{doc-tests-file}[{api}-request-pipeline]
 --------------------------------------------------
 <1> set pipeline to `my_pipeline`
 
-If you want a particular set of documents from the source index you’ll need to use sort. If possible, prefer a more
-selective query to maxDocs and sort.
-
-["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
-include-tagged::{doc-tests-file}[{api}-request-sort]
---------------------------------------------------
-<1> add descending sort to`field1`
-<2> add ascending sort to `field2`
-
 +{request}+ also supports a `script` that modifies the document. It allows you to
 also change the document's metadata. The following example illustrates that.
 
diff --git a/docs/reference/docs/reindex.asciidoc b/docs/reference/docs/reindex.asciidoc
index 67c54d37f15d4..c5ba1d36743fc 100644
--- a/docs/reference/docs/reindex.asciidoc
+++ b/docs/reference/docs/reindex.asciidoc
@@ -476,9 +476,14 @@ which defaults to a maximum size of 100 MB.
 (Optional, integer) Total number of slices. 
 
 `sort`:::
++
+--
 (Optional, list) A comma-separated list of `<field>:<direction>` pairs to sort by before indexing.
 Use in conjunction with `max_docs` to control what documents are reindexed.
 
+deprecated::[7.6, Sort in reindex is deprecated. Sorting in reindex was never guaranteed to index documents in order and prevents further development of reindex such as resilience and performance improvements. If used in combination with `max_docs`&#44; consider using a query filter instead.]
+--
+
 `_source`:::
 (Optional, string) If `true` reindexes all source fields. 
 Set to a list to reindex select fields. 
@@ -602,8 +607,8 @@ POST _reindex
 --------------------------------------------------
 // TEST[setup:twitter]
 
-[[docs-reindex-select-sort]]
-===== Reindex select documents with sort
+[[docs-reindex-select-max-docs]]
+===== Reindex select documents with `max_docs`
 
 You can limit the number of processed documents by setting `max_docs`. 
 For example, this request copies a single document from `twitter` to
@@ -624,28 +629,6 @@ POST _reindex
 --------------------------------------------------
 // TEST[setup:twitter]
 
-You can use `sort` in conjunction with `max_docs` to select the documents you want to reindex. 
-Sorting makes the scroll less efficient but in some contexts it's worth it. 
-If possible, it's better to use a more selective query instead of `max_docs` and `sort`.
-
-For example, following request copies 10000 documents from `twitter` into `new_twitter`:
-
-[source,console]
---------------------------------------------------
-POST _reindex
-{
-  "max_docs": 10000,
-  "source": {
-    "index": "twitter",
-    "sort": { "date": "desc" }
-  },
-  "dest": {
-    "index": "new_twitter"
-  }
-}
---------------------------------------------------
-// TEST[setup:twitter]
-
 [[docs-reindex-multiple-indices]]
 ===== Reindex from multiple indices
 
@@ -824,11 +807,10 @@ POST _reindex
     "index": "twitter",
     "query": {
       "function_score" : {
-        "query" : { "match_all": {} },
-        "random_score" : {}
+        "random_score" : {},
+        "min_score" : 0.9    <1>
       }
-    },
-    "sort": "_score"    <1>
+    }
   },
   "dest": {
     "index": "random_twitter"
@@ -837,8 +819,8 @@ POST _reindex
 ----------------------------------------------------------------
 // TEST[setup:big_twitter]
 
-<1> `_reindex` defaults to sorting by `_doc` so `random_score` will not have any
-effect unless you override the sort to `_score`.
+<1> You may need to adjust the `min_score` depending on the relative amount of
+data extracted from source.
 
 [[reindex-scripts]]
 ===== Modify documents during reindexing
diff --git a/docs/reference/ilm/ilm-with-existing-indices.asciidoc b/docs/reference/ilm/ilm-with-existing-indices.asciidoc
index cff82df838806..96c1e4589de9a 100644
--- a/docs/reference/ilm/ilm-with-existing-indices.asciidoc
+++ b/docs/reference/ilm/ilm-with-existing-indices.asciidoc
@@ -352,6 +352,10 @@ will mean that all documents in `ilm-mylogs-000001` come before all documents in
 `ilm-mylogs-000002`, and so on. However, if this is not a requirement, omitting
 the sort will allow the data to be reindexed more quickly.
 
+NOTE: Sorting in reindex is deprecated, see
+<<docs-reindex-api-request-body,reindex request body>>. Instead use timestamp
+ranges to partition data in separate reindex runs.
+
 IMPORTANT: If your data uses document IDs generated by means other than
 Elasticsearch's automatic ID generation, you may need to do additional
 processing to ensure that the document IDs don't conflict during the reindex, as
@@ -404,4 +408,4 @@ PUT _cluster/settings
 All of the reindexed data should now be accessible via the alias set up above,
 in this case `mylogs`. Once you have verified that all the data has been
 reindexed and is available in the new indices, the existing indices can be
-safely removed.
\ No newline at end of file
+safely removed.
diff --git a/modules/reindex/src/main/java/org/elasticsearch/index/reindex/Reindexer.java b/modules/reindex/src/main/java/org/elasticsearch/index/reindex/Reindexer.java
index 39879845bdca1..cbe0e8be6572c 100644
--- a/modules/reindex/src/main/java/org/elasticsearch/index/reindex/Reindexer.java
+++ b/modules/reindex/src/main/java/org/elasticsearch/index/reindex/Reindexer.java
@@ -40,6 +40,7 @@
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.lucene.uid.Versions;
 import org.elasticsearch.common.xcontent.DeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -51,6 +52,7 @@
 import org.elasticsearch.index.reindex.remote.RemoteScrollableHitSource;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptService;
+import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
@@ -71,6 +73,9 @@
 public class Reindexer {
 
     private static final Logger logger = LogManager.getLogger(Reindexer.class);
+    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(logger);
+    static final String SORT_DEPRECATED_MESSAGE = "The sort option in reindex is deprecated. " +
+        "Instead consider using query filtering to find the desired subset of data.";
 
     private final ClusterService clusterService;
     private final Client client;
@@ -88,6 +93,10 @@ public class Reindexer {
     }
 
     public void initTask(BulkByScrollTask task, ReindexRequest request, ActionListener<Void> listener) {
+        SearchSourceBuilder searchSource = request.getSearchRequest().source();
+        if (searchSource != null && searchSource.sorts() != null && searchSource.sorts().isEmpty() == false) {
+            deprecationLogger.deprecated(SORT_DEPRECATED_MESSAGE);
+        }
         BulkByScrollParallelizationHelper.initTaskState(task, request, client, listener);
     }
 
diff --git a/modules/reindex/src/test/java/org/elasticsearch/index/reindex/ReindexSingleNodeTests.java b/modules/reindex/src/test/java/org/elasticsearch/index/reindex/ReindexSingleNodeTests.java
new file mode 100644
index 0000000000000..14b68ebdf6c6d
--- /dev/null
+++ b/modules/reindex/src/test/java/org/elasticsearch/index/reindex/ReindexSingleNodeTests.java
@@ -0,0 +1,60 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index.reindex;
+
+import org.elasticsearch.index.query.RangeQueryBuilder;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.search.sort.SortOrder;
+import org.elasticsearch.test.ESSingleNodeTestCase;
+
+import java.util.Arrays;
+import java.util.Collection;
+
+import static org.elasticsearch.index.reindex.ReindexTestCase.matcher;
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertHitCount;
+
+public class ReindexSingleNodeTests extends ESSingleNodeTestCase {
+    @Override
+    protected Collection<Class<? extends Plugin>> getPlugins() {
+        return Arrays.asList(ReindexPlugin.class);
+    }
+
+    public void testDeprecatedSort() {
+        int max = between(2, 20);
+        for (int i = 0; i < max; i++) {
+            client().prepareIndex("source").setId(Integer.toString(i)).setSource("foo", i).get();
+        }
+
+        client().admin().indices().prepareRefresh("source").get();
+        assertHitCount(client().prepareSearch("source").setSize(0).get(), max);
+
+        // Copy a subset of the docs sorted
+        int subsetSize = randomIntBetween(1, max - 1);
+        ReindexRequestBuilder copy = new ReindexRequestBuilder(client(), ReindexAction.INSTANCE)
+            .source("source").destination("dest").refresh(true);
+        copy.maxDocs(subsetSize);
+        copy.request().addSortField("foo", SortOrder.DESC);
+        assertThat(copy.get(), matcher().created(subsetSize));
+
+        assertHitCount(client().prepareSearch("dest").setSize(0).get(), subsetSize);
+        assertHitCount(client().prepareSearch("dest").setQuery(new RangeQueryBuilder("foo").gte(0).lt(max-subsetSize)).get(), 0);
+        assertWarnings(Reindexer.SORT_DEPRECATED_MESSAGE);
+    }
+}
diff --git a/modules/reindex/src/test/resources/rest-api-spec/test/reindex/30_search.yml b/modules/reindex/src/test/resources/rest-api-spec/test/reindex/30_search.yml
index 709b9c0d17340..be2d943431030 100644
--- a/modules/reindex/src/test/resources/rest-api-spec/test/reindex/30_search.yml
+++ b/modules/reindex/src/test/resources/rest-api-spec/test/reindex/30_search.yml
@@ -77,8 +77,9 @@
 ---
 "Sorting and max_docs in body combined":
   - skip:
-      version: " - 7.2.99"
-      reason: "max_docs introduced in 7.3.0"
+      version: " - 7.5.99"
+      reason: "max_docs introduced in 7.3.0, but sort deprecated in 7.6"
+      features: "warnings"
 
   - do:
       index:
@@ -94,6 +95,9 @@
       indices.refresh: {}
 
   - do:
+      warnings:
+        - The sort option in reindex is deprecated. Instead consider using query
+          filtering to find the desired subset of data.
       reindex:
         refresh: true
         body:
diff --git a/server/src/main/java/org/elasticsearch/index/reindex/ReindexRequest.java b/server/src/main/java/org/elasticsearch/index/reindex/ReindexRequest.java
index b4991697b1742..c01edd25b24ab 100644
--- a/server/src/main/java/org/elasticsearch/index/reindex/ReindexRequest.java
+++ b/server/src/main/java/org/elasticsearch/index/reindex/ReindexRequest.java
@@ -176,7 +176,10 @@ public ReindexRequest setSourceQuery(QueryBuilder queryBuilder) {
      *
      * @param name The name of the field to sort by
      * @param order The order in which to sort
+     * @deprecated Specifying a sort field for reindex is deprecated. If using this in combination with maxDocs, consider using a
+     * query filter instead.
      */
+    @Deprecated
     public ReindexRequest addSortField(String name, SortOrder order) {
         this.getSearchRequest().source().sort(name, order);
         return this;

From 828a1a8491c2436c133254eae766de9c774e87da Mon Sep 17 00:00:00 2001
From: Tugberk Ugurlu <tugberk@outlook.com>
Date: Fri, 29 Nov 2019 17:42:02 +0000
Subject: [PATCH 030/686] [Docs] Fix typo in templates.asciidoc (#49726)

---
 docs/reference/indices/templates.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/indices/templates.asciidoc b/docs/reference/indices/templates.asciidoc
index e31b34d05b1b6..db2cc265777b2 100644
--- a/docs/reference/indices/templates.asciidoc
+++ b/docs/reference/indices/templates.asciidoc
@@ -59,7 +59,7 @@ override any settings or mappings specified in an index template.
 
 ===== Comments in index templates
 You can use C-style /* */ block comments in index templates.
-You can includes comments anywhere in the request body,
+You can include comments anywhere in the request body,
 except before the opening curly bracket.
 
 [[getting]]	

From 5d1422ded8fe1418505d14cd0e70430c593ea57c Mon Sep 17 00:00:00 2001
From: Mayya Sharipova <mayya.sharipova@elastic.co>
Date: Fri, 29 Nov 2019 14:32:17 -0500
Subject: [PATCH 031/686] Add bulkScorer to script score query (#46336)

Some queries return bulk scorers that can be significantly faster than
iterating naively over the scorer. By giving script_score a BulkScorer
that would delegate to the wrapped query, we could make it faster in some cases.

Closes #40837
---
 .../search/function/ScriptScoreQuery.java     | 179 ++++++++++++++----
 .../search/query/ScriptScoreQueryIT.java      |  29 +++
 2 files changed, 170 insertions(+), 38 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/lucene/search/function/ScriptScoreQuery.java b/server/src/main/java/org/elasticsearch/common/lucene/search/function/ScriptScoreQuery.java
index 17b5d87e7cb05..d285deff3a289 100644
--- a/server/src/main/java/org/elasticsearch/common/lucene/search/function/ScriptScoreQuery.java
+++ b/server/src/main/java/org/elasticsearch/common/lucene/search/function/ScriptScoreQuery.java
@@ -25,12 +25,17 @@
 import org.apache.lucene.search.BooleanClause;
 import org.apache.lucene.search.DocIdSetIterator;
 import org.apache.lucene.search.Explanation;
-import org.apache.lucene.search.IndexSearcher;
+import org.apache.lucene.search.FilterLeafCollector;
+import org.apache.lucene.search.LeafCollector;
 import org.apache.lucene.search.Query;
+import org.apache.lucene.search.Scorable;
+import org.apache.lucene.search.Weight;
+import org.apache.lucene.search.IndexSearcher;
 import org.apache.lucene.search.QueryVisitor;
 import org.apache.lucene.search.ScoreMode;
 import org.apache.lucene.search.Scorer;
-import org.apache.lucene.search.Weight;
+import org.apache.lucene.search.BulkScorer;
+import org.apache.lucene.util.Bits;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.Version;
 import org.elasticsearch.script.ScoreScript;
@@ -83,6 +88,19 @@ public Weight createWeight(IndexSearcher searcher, ScoreMode scoreMode, float bo
         Weight subQueryWeight = subQuery.createWeight(searcher, subQueryScoreMode, boost);
 
         return new Weight(this){
+            @Override
+            public BulkScorer bulkScorer(LeafReaderContext context) throws IOException {
+                if (minScore == null) {
+                    final BulkScorer subQueryBulkScorer = subQueryWeight.bulkScorer(context);
+                    if (subQueryBulkScorer == null) {
+                        return null;
+                    }
+                    return new ScriptScoreBulkScorer(subQueryBulkScorer, subQueryScoreMode, makeScoreScript(context));
+                } else {
+                    return super.bulkScorer(context);
+                }
+            }
+
             @Override
             public void extractTerms(Set<Term> terms) {
                 subQueryWeight.extractTerms(terms);
@@ -94,8 +112,7 @@ public Scorer scorer(LeafReaderContext context) throws IOException {
                 if (subQueryScorer == null) {
                     return null;
                 }
-                Scorer scriptScorer = makeScriptScorer(subQueryScorer, context, null);
-
+                Scorer scriptScorer = new ScriptScorer(this, makeScoreScript(context), subQueryScorer, subQueryScoreMode, null);
                 if (minScore != null) {
                     scriptScorer = new MinScoreScorer(this, scriptScorer, minScore);
                 }
@@ -109,7 +126,8 @@ public Explanation explain(LeafReaderContext context, int doc) throws IOExceptio
                     return subQueryExplanation;
                 }
                 ExplanationHolder explanationHolder = new ExplanationHolder();
-                Scorer scorer = makeScriptScorer(subQueryWeight.scorer(context), context, explanationHolder);
+                Scorer scorer = new ScriptScorer(this, makeScoreScript(context),
+                    subQueryWeight.scorer(context), subQueryScoreMode, explanationHolder);
                 int newDoc = scorer.iterator().advance(doc);
                 assert doc == newDoc; // subquery should have already matched above
                 float score = scorer.score();
@@ -132,42 +150,13 @@ public Explanation explain(LeafReaderContext context, int doc) throws IOExceptio
                 }
                 return explanation;
             }
-            
-            private Scorer makeScriptScorer(Scorer subQueryScorer, LeafReaderContext context,
-                                            ExplanationHolder explanation) throws IOException {
+
+            private ScoreScript makeScoreScript(LeafReaderContext context) throws IOException {
                 final ScoreScript scoreScript = scriptBuilder.newInstance(context);
-                scoreScript.setScorer(subQueryScorer);
                 scoreScript._setIndexName(indexName);
                 scoreScript._setShard(shardId);
                 scoreScript._setIndexVersion(indexVersion);
-
-                return new Scorer(this) {
-                    @Override
-                    public float score() throws IOException {
-                        int docId = docID();
-                        scoreScript.setDocument(docId);
-                        float score = (float) scoreScript.execute(explanation);
-                        if (score == Float.NEGATIVE_INFINITY || Float.isNaN(score)) {
-                            throw new ElasticsearchException(
-                                "script score query returned an invalid score: " + score + " for doc: " + docId);
-                        }
-                        return score;
-                    }
-                    @Override
-                    public int docID() {
-                        return subQueryScorer.docID();
-                    }
-
-                    @Override
-                    public DocIdSetIterator iterator() {
-                        return subQueryScorer.iterator();
-                    }
-
-                    @Override
-                    public float getMaxScore(int upTo) {
-                        return Float.MAX_VALUE; // TODO: what would be a good upper bound?
-                    }
-                };
+                return scoreScript;
             }
 
             @Override
@@ -187,7 +176,7 @@ public void visit(QueryVisitor visitor) {
     @Override
     public String toString(String field) {
         StringBuilder sb = new StringBuilder();
-        sb.append("script score (").append(subQuery.toString(field)).append(", script: ");
+        sb.append("script_score (").append(subQuery.toString(field)).append(", script: ");
         sb.append("{" + script.toString() + "}");
         return sb.toString();
     }
@@ -209,4 +198,118 @@ public boolean equals(Object o) {
     public int hashCode() {
         return Objects.hash(subQuery, script, minScore, indexName, shardId, indexVersion);
     }
+
+
+    private static class ScriptScorer extends Scorer {
+        private final ScoreScript scoreScript;
+        private final Scorer subQueryScorer;
+        private final ExplanationHolder explanation;
+
+        ScriptScorer(Weight weight, ScoreScript scoreScript, Scorer subQueryScorer,
+                ScoreMode subQueryScoreMode, ExplanationHolder explanation) {
+            super(weight);
+            this.scoreScript = scoreScript;
+            if (subQueryScoreMode == ScoreMode.COMPLETE) {
+                scoreScript.setScorer(subQueryScorer);
+            }
+            this.subQueryScorer = subQueryScorer;
+            this.explanation = explanation;
+        }
+
+        @Override
+        public float score() throws IOException {
+            int docId = docID();
+            scoreScript.setDocument(docId);
+            float score = (float) scoreScript.execute(explanation);
+            if (score == Float.NEGATIVE_INFINITY || Float.isNaN(score)) {
+                throw new ElasticsearchException(
+                    "script_score query returned an invalid score [" + score + "] for doc [" + docId + "].");
+            }
+            return score;
+        }
+        @Override
+        public int docID() {
+            return subQueryScorer.docID();
+        }
+
+        @Override
+        public DocIdSetIterator iterator() {
+            return subQueryScorer.iterator();
+        }
+
+        @Override
+        public float getMaxScore(int upTo) {
+            return Float.MAX_VALUE; // TODO: what would be a good upper bound?
+        }
+
+    }
+
+    private static class ScriptScorable extends Scorable {
+        private final ScoreScript scoreScript;
+        private final Scorable subQueryScorer;
+        private final ExplanationHolder explanation;
+
+        ScriptScorable(ScoreScript scoreScript, Scorable subQueryScorer,
+                ScoreMode subQueryScoreMode, ExplanationHolder explanation) {
+            this.scoreScript = scoreScript;
+            if (subQueryScoreMode == ScoreMode.COMPLETE) {
+                scoreScript.setScorer(subQueryScorer);
+            }
+            this.subQueryScorer = subQueryScorer;
+            this.explanation = explanation;
+        }
+
+        @Override
+        public float score() throws IOException {
+            int docId = docID();
+            scoreScript.setDocument(docId);
+            float score = (float) scoreScript.execute(explanation);
+            if (score == Float.NEGATIVE_INFINITY || Float.isNaN(score)) {
+                throw new ElasticsearchException(
+                    "script_score query returned an invalid score [" + score + "] for doc [" + docId + "].");
+            }
+            return score;
+        }
+        @Override
+        public int docID() {
+            return subQueryScorer.docID();
+        }
+    }
+
+    /**
+     * Use the {@link BulkScorer} of the sub-query,
+     * as it may be significantly faster (e.g. BooleanScorer) than iterating over the scorer
+     */
+    private static class ScriptScoreBulkScorer extends BulkScorer {
+        private final BulkScorer subQueryBulkScorer;
+        private final ScoreMode subQueryScoreMode;
+        private final ScoreScript scoreScript;
+
+        ScriptScoreBulkScorer(BulkScorer subQueryBulkScorer, ScoreMode subQueryScoreMode, ScoreScript scoreScript) {
+            this.subQueryBulkScorer = subQueryBulkScorer;
+            this.subQueryScoreMode = subQueryScoreMode;
+            this.scoreScript = scoreScript;
+        }
+
+        @Override
+        public int score(LeafCollector collector, Bits acceptDocs, int min, int max) throws IOException {
+            return subQueryBulkScorer.score(wrapCollector(collector), acceptDocs, min, max);
+        }
+
+        private LeafCollector wrapCollector(LeafCollector collector) {
+            return new FilterLeafCollector(collector) {
+                @Override
+                public void setScorer(Scorable scorer) throws IOException {
+                    in.setScorer(new ScriptScorable(scoreScript, scorer, subQueryScoreMode, null));
+                }
+            };
+        }
+
+        @Override
+        public long cost() {
+            return subQueryBulkScorer.cost();
+        }
+
+    }
+
 }
diff --git a/server/src/test/java/org/elasticsearch/search/query/ScriptScoreQueryIT.java b/server/src/test/java/org/elasticsearch/search/query/ScriptScoreQueryIT.java
index a6ee658ac5d67..71380ce9fa303 100644
--- a/server/src/test/java/org/elasticsearch/search/query/ScriptScoreQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/ScriptScoreQueryIT.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.fielddata.ScriptDocValues;
+import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.RangeQueryBuilder;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.script.MockScriptPlugin;
@@ -35,6 +36,7 @@
 import java.util.Map;
 import java.util.function.Function;
 
+import static org.elasticsearch.index.query.QueryBuilders.boolQuery;
 import static org.elasticsearch.index.query.QueryBuilders.matchQuery;
 import static org.elasticsearch.index.query.QueryBuilders.scriptScoreQuery;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
@@ -104,6 +106,33 @@ public void testScriptScore() {
         assertOrderedSearchHits(resp, "10", "8", "6");
     }
 
+    public void testScriptScoreBoolQuery() {
+        assertAcked(
+            prepareCreate("test-index").addMapping("_doc", "field1", "type=text", "field2", "type=double")
+        );
+        int docCount = 10;
+        for (int i = 1; i <= docCount; i++) {
+            client().prepareIndex("test-index").setId("" + i)
+                .setSource("field1", "text" + i, "field2", i)
+                .get();
+        }
+        refresh();
+
+        Map<String, Object> params = new HashMap<>();
+        params.put("param1", 0.1);
+        Script script = new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "doc['field2'].value * param1", params);
+        QueryBuilder boolQuery = boolQuery().should(matchQuery("field1", "text1")).should(matchQuery("field1", "text10"));
+        SearchResponse resp = client()
+            .prepareSearch("test-index")
+            .setQuery(scriptScoreQuery(boolQuery, script))
+            .get();
+        assertNoFailures(resp);
+        assertOrderedSearchHits(resp, "10", "1");
+        assertFirstHit(resp, hasScore(1.0f));
+        assertSecondHit(resp, hasScore(0.1f));
+    }
+
+
     // test that when the internal query is rewritten script_score works well
     public void testRewrittenQuery() {
         assertAcked(

From 836f97662f68aa0ae041beb29a2b602c51a87a4e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Mon, 2 Dec 2019 11:21:34 +0100
Subject: [PATCH 032/686] Add note how to run locale sensitive unit test
 (#49491)

Some unit test checking locale sensitive functionality require the
-Djava.locale.providers=SPI,COMPAT flag to be set. When running tests though
gradle we pass this already to the BuildPlugin, but running from the IDE this
might need to be set manually. Adding a note explaining this to the
CONTRIBUTING.md doc and leaving a note in the test comment of
SearchQueryIT.testRangeQueryWithLocaleMapping which is a test we know
that suffers from this issue.
---
 CONTRIBUTING.md                                        |  4 ++++
 .../org/elasticsearch/search/query/SearchQueryIT.java  | 10 ++++++++++
 2 files changed, 14 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 9c4da6a22d985..24d9b4a87c461 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -153,6 +153,10 @@ For IntelliJ, go to
 For Eclipse, go to `Preferences->Java->Installed JREs` and add `-ea` to
 `VM Arguments`.
 
+Some tests related to locale testing also require the flag 
+`-Djava.locale.providers` to be set. Set the VM options/VM arguments for
+IntelliJ or Eclipse like describe above to use 
+`-Djava.locale.providers=SPI,COMPAT`.
 
 ### Java Language Formatting Guidelines
 
diff --git a/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java b/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
index fe24db5161d1c..395302bc4c7bb 100644
--- a/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
@@ -1569,8 +1569,18 @@ public void testRangeQueryWithTimeZone() throws Exception {
         assertThat(searchResponse.getHits().getAt(0).getId(), is("4"));
     }
 
+    /**
+     * Test range with a custom locale, e.g. "de" in this case. Documents here mention the day of week
+     * as "Mi" for "Mittwoch (Wednesday" and "Do" for "Donnerstag (Thursday)" and the month in the query
+     * as "Dez" for "Dezember (December)".
+     * Note: this test currently needs the JVM arg `-Djava.locale.providers=SPI,COMPAT` to be set.
+     * When running with gradle this is done implicitly through the BuildPlugin, but when running from
+     * an IDE this might need to be set manually in the run configuration. See also CONTRIBUTING.md section
+     * on "Configuring IDEs And Running Tests".
+     */
     public void testRangeQueryWithLocaleMapping() throws Exception {
         assumeTrue("need java 9 for testing ",JavaVersion.current().compareTo(JavaVersion.parse("9")) >= 0);
+        assert ("SPI,COMPAT".equals(System.getProperty("java.locale.providers"))) : "`-Djava.locale.providers=SPI,COMPAT` needs to be set";
 
         assertAcked(prepareCreate("test")
             .addMapping("type1", jsonBuilder().startObject().startObject("properties").startObject("date_field")

From fd7b9a9ddd8d1f4e8b71ca281153a964c1c4c308 Mon Sep 17 00:00:00 2001
From: David Turner <david.turner@elastic.co>
Date: Mon, 2 Dec 2019 12:43:18 +0000
Subject: [PATCH 033/686] Drop snapshot instructions for autobootstrap fix
 (#49755)

The "Restore any snapshots as required" step is a trap: it's somewhere between
tricky and impossible to restore multiple clusters into a single one.

Also add a note about configuring discovery during a rolling upgrade to
proscribe any rare cases where you might accidentally autobootstrap during the
upgrade.
---
 docs/reference/modules/discovery/bootstrapping.asciidoc | 4 ----
 docs/reference/upgrade/rolling_upgrade.asciidoc         | 4 +++-
 2 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/docs/reference/modules/discovery/bootstrapping.asciidoc b/docs/reference/modules/discovery/bootstrapping.asciidoc
index ba6cdc7127492..7d1244de2568b 100644
--- a/docs/reference/modules/discovery/bootstrapping.asciidoc
+++ b/docs/reference/modules/discovery/bootstrapping.asciidoc
@@ -138,14 +138,10 @@ clusters together without a risk of data loss. You can tell that you have formed
 separate clusters by checking the cluster UUID reported by `GET /` on each node.
 If you intended to form a single cluster then you should start again:
 
-* Take a <<modules-snapshots,snapshot>> of each of the single-host clusters if
-  you do not want to lose any data that they hold. Note that each cluster must
-  use its own snapshot repository.
 * Shut down all the nodes.
 * Completely wipe each node by deleting the contents of their
   <<data-path,data folders>>.
 * Configure `cluster.initial_master_nodes` as described above.
 * Restart all the nodes and verify that they have formed a single cluster.
-* <<modules-snapshots,Restore>> any snapshots as required.
 
 ==================================================
diff --git a/docs/reference/upgrade/rolling_upgrade.asciidoc b/docs/reference/upgrade/rolling_upgrade.asciidoc
index 348672546eed5..96b3d12fb0264 100644
--- a/docs/reference/upgrade/rolling_upgrade.asciidoc
+++ b/docs/reference/upgrade/rolling_upgrade.asciidoc
@@ -68,7 +68,9 @@ include::set-paths-tip.asciidoc[]
 [[rolling-upgrades-bootstrapping]]
 NOTE: You should leave `cluster.initial_master_nodes` unset while performing a
 rolling upgrade. Each upgraded node is joining an existing cluster so there is
-no need for <<modules-discovery-bootstrap-cluster,cluster bootstrapping>>.
+no need for <<modules-discovery-bootstrap-cluster,cluster bootstrapping>>. You
+must configure <<built-in-hosts-providers,either `discovery.seed_hosts` or
+`discovery.seed_providers`>> on every node.
 --
 
 . *Upgrade any plugins.*

From 72f75393da80270015ad49e434964700a82a83ac Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Mon, 2 Dec 2019 16:03:52 +0200
Subject: [PATCH 034/686] Fix Locate function optional parameter handling
 (#49666)

---
 .../qa/src/main/resources/functions.csv-spec  | 20 +++++++++++++++++++
 .../main/resources/string-functions.sql-spec  |  3 +++
 .../function/scalar/string/Locate.java        |  6 ++++--
 .../string/LocateFunctionPipeTests.java       | 11 +++++-----
 4 files changed, 32 insertions(+), 8 deletions(-)

diff --git a/x-pack/plugin/sql/qa/src/main/resources/functions.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/functions.csv-spec
index 97edeb08ecb32..2fa54c18547fc 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/functions.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/functions.csv-spec
@@ -333,6 +333,26 @@ SELECT LOCATE('a',"first_name") pos, INSERT("first_name",LOCATE('a',"first_name"
 8              |ChirstiAAAn  
 ;
 
+selectLocateWithConditional1
+SELECT CAST(LOCATE('a', CASE WHEN TRUNCATE(salary, 3) > 40000 THEN first_name.keyword ELSE last_name.keyword END) > 0 AS STRING) AS x, COUNT(*) AS c FROM test_emp GROUP BY x ORDER BY c ASC;
+
+      x:s      |       c:l       
+---------------+---------------
+null           |4              
+false          |43             
+true           |53             
+;
+
+selectLocateWithConditional2
+SELECT CAST(LOCATE(CASE WHEN languages > 3 THEN 'a' ELSE 'b' END, CASE WHEN TRUNCATE(salary, 3) > 40000 THEN first_name.keyword ELSE last_name.keyword END, CASE WHEN gender IS NOT NULL THEN 3 ELSE NULL END) > 0 AS STRING) AS x, COUNT(*) AS c FROM test_emp GROUP BY x ORDER BY c DESC;
+
+      x:s      |       c:l       
+---------------+---------------
+false          |80             
+true           |16             
+null           |4              
+;
+
 selectLeft
 SELECT LEFT("first_name",2) f FROM "test_emp" ORDER BY "first_name" LIMIT 10;
 
diff --git a/x-pack/plugin/sql/qa/src/main/resources/string-functions.sql-spec b/x-pack/plugin/sql/qa/src/main/resources/string-functions.sql-spec
index b82d6ef580799..313956cfcb932 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/string-functions.sql-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/string-functions.sql-spec
@@ -253,6 +253,9 @@ SELECT LOCATE('a',"first_name",7) pos, INSERT("first_name",LOCATE('a',"first_nam
 selectLocateAndInsertWithLocateWithConditionAndTwoParameters
 SELECT LOCATE('a',"first_name") pos, INSERT("first_name",LOCATE('a',"first_name"),1,'AAA') inserted FROM "test_emp" WHERE LOCATE('a',"first_name") > 0 ORDER BY "first_name" LIMIT 10;
 
+selectLocateWithConditional
+SELECT LOCATE(CASE WHEN FALSE THEN NULL ELSE 'x' END, "first_name") > 0 AS x, COUNT(*) AS c FROM "test_emp" GROUP BY x ORDER BY c ASC;
+
 selectLeft
 SELECT LEFT("first_name",2) f FROM "test_emp" ORDER BY "first_name" NULLS LAST LIMIT 10;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Locate.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Locate.java
index 806e6fab8e465..9d7f43a3e6c0b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Locate.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Locate.java
@@ -133,10 +133,12 @@ public DataType dataType() {
 
     @Override
     public Expression replaceChildren(List<Expression> newChildren) {
-        if (newChildren.size() != 3) {
+        if (start != null && newChildren.size() != 3) {
             throw new IllegalArgumentException("expected [3] children but received [" + newChildren.size() + "]");
+        } else if (start == null && newChildren.size() != 2) {
+            throw new IllegalArgumentException("expected [2] children but received [" + newChildren.size() + "]");
         }
 
-        return new Locate(source(), newChildren.get(0), newChildren.get(1), newChildren.get(2));
+        return new Locate(source(), newChildren.get(0), newChildren.get(1), start == null ? null : newChildren.get(2));
     }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipeTests.java
index 95c196c732bd0..3795aab2cd18f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipeTests.java
@@ -75,24 +75,23 @@ public void testReplaceChildren() {
         LocateFunctionPipe b = randomInstance();
         Pipe newPattern = pipe(((Expression) randomValueOtherThan(b.pattern(), () -> randomStringLiteral())));
         Pipe newSource = pipe(((Expression) randomValueOtherThan(b.source(), () -> randomStringLiteral())));
-        Pipe newStart;
+        Pipe newStart = b.start() == null ? null : pipe(((Expression) randomValueOtherThan(b.start(), () -> randomIntLiteral())));
         
-        LocateFunctionPipe newB = new LocateFunctionPipe(
-                b.source(), b.expression(), b.pattern(), b.src(), b.start());
-        newStart = pipe(((Expression) randomValueOtherThan(b.start(), () -> randomIntLiteral())));
+        LocateFunctionPipe newB = new LocateFunctionPipe(b.source(), b.expression(), b.pattern(), b.src(), b.start());
         LocateFunctionPipe transformed = null;
         
         // generate all the combinations of possible children modifications and test all of them
         for(int i = 1; i < 4; i++) {
             for(BitSet comb : new Combinations(3, i)) {
+                Pipe tempNewStart = b.start() == null ? b.start() : (comb.get(2) ? newStart : b.start());
                 transformed = (LocateFunctionPipe) newB.replaceChildren(
                         comb.get(0) ? newPattern : b.pattern(),
                         comb.get(1) ? newSource : b.src(),
-                        comb.get(2) ? newStart : b.start());
+                        tempNewStart);
                 
                 assertEquals(transformed.pattern(), comb.get(0) ? newPattern : b.pattern());
                 assertEquals(transformed.src(), comb.get(1) ? newSource : b.src());
-                assertEquals(transformed.start(), comb.get(2) ? newStart : b.start());
+                assertEquals(transformed.start(), tempNewStart);
                 assertEquals(transformed.expression(), b.expression());
                 assertEquals(transformed.source(), b.source());
             }

From 37c8487a84b7fcf7a00142270fdbb5ca82d3ce08 Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Mon, 2 Dec 2019 16:04:28 +0200
Subject: [PATCH 035/686] Fix NULL handling for FLOOR and CEIL math functions
 (#49644)

---
 .../sql/qa/src/main/resources/math.sql-spec    |  6 ++++++
 .../expression/function/scalar/math/Ceil.java  |  6 +++++-
 .../expression/function/scalar/math/Floor.java |  6 +++++-
 .../math/MathFunctionProcessorTests.java       | 18 ++++++++++++++++++
 4 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/sql/qa/src/main/resources/math.sql-spec b/x-pack/plugin/sql/qa/src/main/resources/math.sql-spec
index 96ffa773aabaa..c6adaf9523ad0 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/math.sql-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/math.sql-spec
@@ -17,6 +17,8 @@ SELECT ATAN(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY
 mathCeil
 // H2 returns CEIL as a double despite the value being an integer; we return a long as the other DBs
 SELECT CAST(CEIL(emp_no) AS INT) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
+mathCeilWithNulls
+SELECT CAST(CEIL(languages) AS INT) m FROM "test_emp" ORDER BY emp_no;
 mathCos
 SELECT COS(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathCosh
@@ -31,6 +33,8 @@ mathExpm1
 SELECT EXP(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathFloor
 SELECT CAST(FLOOR(emp_no) AS INT) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
+mathFloorWithNulls
+SELECT CAST(FLOOR(languages) AS INT) m FROM "test_emp" ORDER BY emp_no;
 mathLog
 SELECT LOG(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathLog10
@@ -49,6 +53,8 @@ mathSqrt
 SELECT SQRT(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathTan
 SELECT TAN(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
+mathFloorAndCeilWithNullLiteral
+SELECT CAST(FLOOR(CAST(NULL AS DOUBLE)) AS INT) fnull, CAST(CEIL(CAST(NULL AS LONG)) AS INT) cnull, gender FROM "test_emp" ORDER BY emp_no;
 
 //
 // Combined methods
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Ceil.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Ceil.java
index 556f53918d892..5c9438c677221 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Ceil.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Ceil.java
@@ -33,7 +33,11 @@ protected Ceil replaceChild(Expression newChild) {
 
     @Override
     public Number fold() {
-        return DataTypeConversion.toInteger((double) super.fold(), dataType());
+        Object result = super.fold();
+        if (result == null) {
+            return null;
+        }
+        return DataTypeConversion.toInteger((double) result, dataType());
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Floor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Floor.java
index 03d6606b0e9fd..a77a4e497d31a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Floor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Floor.java
@@ -33,7 +33,11 @@ protected Floor replaceChild(Expression newChild) {
 
     @Override
     public Object fold() {
-        return DataTypeConversion.toInteger((double) super.fold(), dataType());
+        Object result = super.fold();
+        if (result == null) {
+            return null;
+        }
+        return DataTypeConversion.toInteger((double) result, dataType());
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathFunctionProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathFunctionProcessorTests.java
index 9ff32c5a05741..579ca5f056d63 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathFunctionProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathFunctionProcessorTests.java
@@ -55,4 +55,22 @@ public void testRandom() {
         assertNotNull(proc.process(null));
         assertNotNull(proc.process(randomLong()));
     }
+    
+    public void testFloor() {
+        MathProcessor proc = new MathProcessor(MathOperation.FLOOR);
+        assertNull(proc.process(null));
+        assertNotNull(proc.process(randomLong()));
+        assertEquals(3.0, proc.process(3.3));
+        assertEquals(3.0, proc.process(3.9));
+        assertEquals(-13.0, proc.process(-12.1));
+    }
+    
+    public void testCeil() {
+        MathProcessor proc = new MathProcessor(MathOperation.CEIL);
+        assertNull(proc.process(null));
+        assertNotNull(proc.process(randomLong()));
+        assertEquals(4.0, proc.process(3.3));
+        assertEquals(4.0, proc.process(3.9));
+        assertEquals(-12.0, proc.process(-12.1));
+    }
 }

From 5c216357f78cb4c7d2a71eb7edab3a44c63713ec Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Mon, 2 Dec 2019 16:05:05 +0200
Subject: [PATCH 036/686] SQL: handle NULL arithmetic operations with INTERVALs
 (#49633)

---
 .../sql/functions/date-time.asciidoc          |  2 +-
 .../qa/src/main/resources/arithmetic.csv-spec |  9 +++++
 .../main/resources/datetime-interval.csv-spec |  9 +++++
 .../xpack/sql/expression/TypeResolutions.java |  7 ++--
 .../sql/expression/function/scalar/Cast.java  |  3 +-
 .../predicate/conditional/Case.java           |  2 +-
 .../expression/predicate/nulls/IsNotNull.java |  5 +--
 .../expression/predicate/nulls/IsNull.java    |  5 +--
 .../DateTimeArithmeticOperation.java          |  2 +-
 .../predicate/operator/arithmetic/Mul.java    |  6 +--
 .../xpack/sql/querydsl/query/TermsQuery.java  |  3 +-
 .../xpack/sql/type/DataType.java              | 12 ++++++
 .../xpack/sql/type/DataTypeConversion.java    |  4 +-
 .../xpack/sql/type/DataTypes.java             |  4 --
 .../arithmetic/BinaryArithmeticTests.java     | 39 +++++++++++++++++++
 15 files changed, 86 insertions(+), 26 deletions(-)

diff --git a/docs/reference/sql/functions/date-time.asciidoc b/docs/reference/sql/functions/date-time.asciidoc
index c3158244ec265..74a58da8fa358 100644
--- a/docs/reference/sql/functions/date-time.asciidoc
+++ b/docs/reference/sql/functions/date-time.asciidoc
@@ -55,7 +55,7 @@ s|Description
 
 ==== Operators
 
-Basic arithmetic operators (`+`, `-`, etc) support date/time parameters as indicated below:
+Basic arithmetic operators (`+`, `-`, `*`) support date/time parameters as indicated below:
 
 [source, sql]
 --------------------------------------------------
diff --git a/x-pack/plugin/sql/qa/src/main/resources/arithmetic.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/arithmetic.csv-spec
index 9cbf544fd8d56..31b2417932aa4 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/arithmetic.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/arithmetic.csv-spec
@@ -18,3 +18,12 @@ SELECT 5 - 2 x FROM test_emp LIMIT 5;
 3
 ;
 
+
+nullArithmetics
+schema::a:i|b:d|c:s|d:s|e:l|f:i|g:i|h:i|i:i|j:i|k:d
+SELECT null + 2 AS a, null * 1.5 AS b, null + null AS c, null - null AS d, null - 1234567890123 AS e, 123 - null AS f, null / 5 AS g, 5 / null AS h, null % 5 AS i, 5 % null AS j, null + 5.5 - (null * (null * 3)) AS k;
+
+       a       |       b       |       c       |       d       |       e       |       f       |       g       |       h       |       i       |       j       |       k       
+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------
+null           |null           |null           |null           |null           |null           |null           |null           |null           |null           |null           
+;
diff --git a/x-pack/plugin/sql/qa/src/main/resources/datetime-interval.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/datetime-interval.csv-spec
index 9bb89408923b6..785ea8f404dce 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/datetime-interval.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/datetime-interval.csv-spec
@@ -191,6 +191,15 @@ SELECT 4 * -INTERVAL '2' HOURS AS result1, -5 * -INTERVAL '3' HOURS AS result2;
 -0 08:00:00.0  | +0 15:00:00.0
 ;
 
+intervalNullMath
+schema::null_multiply:string|null_sub1:string|null_sub2:string|null_add:string
+SELECT null * INTERVAL '1 23:45' DAY TO MINUTES AS null_multiply, INTERVAL '1' DAY - null AS null_sub1, null - INTERVAL '1' DAY AS null_sub2, INTERVAL 1 DAY + null AS null_add;
+
+  null_multiply  |  null_sub1  |  null_sub2  |  null_add  
+-----------------+-------------+-------------+-------------
+null             |null         |null         |null
+;
+
 intervalAndFieldMultiply
 schema::languages:byte|result:string
 SELECT languages, CAST (languages * INTERVAL '1 10:30' DAY TO MINUTES AS string) AS result FROM test_emp ORDER BY emp_no LIMIT 5;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypeResolutions.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypeResolutions.java
index c465ab1b2deb8..30041ea12224b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypeResolutions.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypeResolutions.java
@@ -5,8 +5,9 @@
  */
 package org.elasticsearch.xpack.sql.expression;
 
+import org.elasticsearch.xpack.sql.expression.Expression.TypeResolution;
+import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
 import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
 import org.elasticsearch.xpack.sql.type.EsField;
 
 import java.util.Locale;
@@ -14,8 +15,6 @@
 import java.util.function.Predicate;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.Expression.TypeResolution;
-import static org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
 import static org.elasticsearch.xpack.sql.expression.Expressions.name;
 import static org.elasticsearch.xpack.sql.type.DataType.BOOLEAN;
 
@@ -119,7 +118,7 @@ public static TypeResolution isType(Expression e,
                                         String operationName,
                                         ParamOrdinal paramOrd,
                                         String... acceptedTypes) {
-        return predicate.test(e.dataType()) || DataTypes.isNull(e.dataType())?
+        return predicate.test(e.dataType()) || e.dataType().isNull() ?
             TypeResolution.TYPE_RESOLVED :
             new TypeResolution(format(null, "{}argument of [{}] must be [{}], found value [{}] type [{}]",
                 paramOrd == null || paramOrd == ParamOrdinal.DEFAULT ? "" : paramOrd.name().toLowerCase(Locale.ROOT) + " ",
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
index fd82d2bb4db23..c3c0da0570903 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
@@ -13,7 +13,6 @@
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
 import org.elasticsearch.xpack.sql.type.DataTypeConversion;
-import org.elasticsearch.xpack.sql.type.DataTypes;
 
 import java.util.Objects;
 
@@ -64,7 +63,7 @@ public Object fold() {
 
     @Override
     public Nullability nullable() {
-        if (DataTypes.isNull(from())) {
+        if (from().isNull()) {
             return Nullability.TRUE;
         }
         return field().nullable();
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Case.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Case.java
index 1354bb27034ac..84f17283e061e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Case.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Case.java
@@ -78,7 +78,7 @@ protected NodeInfo<? extends Expression> info() {
     protected TypeResolution resolveType() {
         DataType expectedResultDataType = null;
         for (IfConditional ifConditional : conditions) {
-            if (DataTypes.isNull(ifConditional.result().dataType()) == false) {
+            if (ifConditional.result().dataType().isNull() == false) {
                 expectedResultDataType = ifConditional.result().dataType();
                 break;
             }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNotNull.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNotNull.java
index f43e12e0b405c..53bf9bcc80504 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNotNull.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNotNull.java
@@ -12,10 +12,9 @@
 import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
 import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
 import org.elasticsearch.xpack.sql.expression.predicate.nulls.CheckNullProcessor.CheckNullOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
 
 public class IsNotNull extends UnaryScalarFunction implements Negatable<UnaryScalarFunction> {
 
@@ -35,7 +34,7 @@ protected IsNotNull replaceChild(Expression newChild) {
 
     @Override
     public Object fold() {
-        return field().fold() != null && !DataTypes.isNull(field().dataType());
+        return field().fold() != null && !field().dataType().isNull();
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNull.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNull.java
index b873f2770c724..c1d98dbe1b5c5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNull.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNull.java
@@ -12,10 +12,9 @@
 import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
 import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
 import org.elasticsearch.xpack.sql.expression.predicate.nulls.CheckNullProcessor.CheckNullOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
 
 public class IsNull extends UnaryScalarFunction implements Negatable<UnaryScalarFunction> {
 
@@ -35,7 +34,7 @@ protected IsNull replaceChild(Expression newChild) {
 
     @Override
     public Object fold() {
-        return field().fold() == null || DataTypes.isNull(field().dataType());
+        return field().fold() == null || field().dataType().isNull();
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java
index b7b559f1b8617..39797a7351627 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java
@@ -56,7 +56,7 @@ protected TypeResolution resolveWithIntervals() {
         DataType l = left().dataType();
         DataType r = right().dataType();
 
-        if (!(r.isDateOrTimeBased() || r.isInterval())|| !(l.isDateOrTimeBased() || l.isInterval())) {
+        if (!(r.isDateOrTimeBased() || r.isInterval() || r.isNull())|| !(l.isDateOrTimeBased() || l.isInterval() || l.isNull())) {
             return new TypeResolution(format(null, "[{}] has arguments with incompatible types [{}] and [{}]", symbol(), l, r));
         }
         return TypeResolution.TYPE_RESOLVED;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mul.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mul.java
index 9c12a24687612..f1e90c2dbd668 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mul.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mul.java
@@ -34,14 +34,14 @@ protected TypeResolution resolveType() {
         DataType r = right().dataType();
 
         // 1. both are numbers
-        if (l.isNumeric() && r.isNumeric()) {
+        if (l.isNullOrNumeric() && r.isNullOrNumeric()) {
             return TypeResolution.TYPE_RESOLVED;
         }
 
-        if (l.isInterval() && r.isInteger()) {
+        if (l.isNullOrInterval() && (r.isInteger() || r.isNull())) {
             dataType = l;
             return TypeResolution.TYPE_RESOLVED;
-        } else if (r.isInterval() && l.isInteger()) {
+        } else if (r.isNullOrInterval() && (l.isInteger() || l.isNull())) {
             dataType = r;
             return TypeResolution.TYPE_RESOLVED;
         }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermsQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermsQuery.java
index 966130cb239ec..9b7f59c011ed5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermsQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermsQuery.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.Foldables;
 import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataTypes;
 
 import java.util.Collections;
 import java.util.LinkedHashSet;
@@ -27,7 +26,7 @@ public class TermsQuery extends LeafQuery {
     public TermsQuery(Source source, String term, List<Expression> values) {
         super(source);
         this.term = term;
-        values.removeIf(e -> DataTypes.isNull(e.dataType()));
+        values.removeIf(e -> e.dataType().isNull());
         if (values.isEmpty()) {
             this.values = Collections.emptySet();
         } else {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataType.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataType.java
index 22f2a596e3515..19fda28f76ffd 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataType.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataType.java
@@ -247,6 +247,18 @@ public boolean isSigned() {
         return isNumeric();
     }
 
+    public boolean isNull() {
+        return this == NULL;
+    }
+
+    public boolean isNullOrNumeric() {
+        return isNull() || isNumeric();
+    }
+
+    public boolean isNullOrInterval() {
+        return isNull() || isInterval();
+    }
+
     public boolean isString() {
         return this == KEYWORD || this == TEXT;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypeConversion.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypeConversion.java
index a9b836da1354d..8e3158c3e6a8a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypeConversion.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypeConversion.java
@@ -45,10 +45,10 @@ public static DataType commonType(DataType left, DataType right) {
         if (left == right) {
             return left;
         }
-        if (DataTypes.isNull(left)) {
+        if (left.isNull()) {
             return right;
         }
-        if (DataTypes.isNull(right)) {
+        if (right.isNull()) {
             return left;
         }
         if (left.isString() && right.isString()) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypes.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypes.java
index 5d4691e70d531..1faf19e1d0996 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypes.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypes.java
@@ -31,10 +31,6 @@ public final class DataTypes {
 
     private DataTypes() {}
 
-    public static boolean isNull(DataType from) {
-        return from == NULL;
-    }
-
     public static boolean isUnsupported(DataType from) {
         return from == UNSUPPORTED;
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java
index 1c4b0697f959e..1b877cb75f377 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java
@@ -227,6 +227,45 @@ public void testMulNumberInterval() {
         Period p = interval.interval();
         assertEquals(Period.ofYears(2).negated(), p);
     }
+    
+    public void testMulNullInterval() {
+        Literal literal = interval(Period.ofMonths(1), INTERVAL_MONTH);
+        Mul result = new Mul(EMPTY, L(null), literal);
+        assertTrue(result.foldable());
+        assertNull(result.fold());
+        assertEquals(INTERVAL_MONTH, result.dataType());
+        
+        result = new Mul(EMPTY, literal, L(null));
+        assertTrue(result.foldable());
+        assertNull(result.fold());
+        assertEquals(INTERVAL_MONTH, result.dataType());
+    }
+
+    public void testAddNullInterval() {
+        Literal literal = interval(Period.ofMonths(1), INTERVAL_MONTH);
+        Add result = new Add(EMPTY, L(null), literal);
+        assertTrue(result.foldable());
+        assertNull(result.fold());
+        assertEquals(INTERVAL_MONTH, result.dataType());
+        
+        result = new Add(EMPTY, literal, L(null));
+        assertTrue(result.foldable());
+        assertNull(result.fold());
+        assertEquals(INTERVAL_MONTH, result.dataType());
+    }
+
+    public void testSubNullInterval() {
+        Literal literal = interval(Period.ofMonths(1), INTERVAL_MONTH);
+        Sub result = new Sub(EMPTY, L(null), literal);
+        assertTrue(result.foldable());
+        assertNull(result.fold());
+        assertEquals(INTERVAL_MONTH, result.dataType());
+        
+        result = new Sub(EMPTY, literal, L(null));
+        assertTrue(result.foldable());
+        assertNull(result.fold());
+        assertEquals(INTERVAL_MONTH, result.dataType());
+    }
 
     @SuppressWarnings("unchecked")
     private static <T> T add(Object l, Object r) {

From f01004f4576a1e030d36e80ee0aa60719e1ab537 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 2 Dec 2019 09:12:21 -0500
Subject: [PATCH 037/686] [DOCS] Explicitly document enrich `target_field`
 includes `match_field` (#49407)

When the enrich processor appends enrich data to an incoming document,
it adds a `target_field` to contain the enrich data.

This `target_field` contains both the `match_field` AND `enrich_fields`
specified in the enrich policy.

Previously, this was reflected in the documented example but not
explicitly stated. This adds several explicit statements to the docs.
---
 docs/reference/ingest/enrich.asciidoc            | 6 +++++-
 docs/reference/ingest/processors/enrich.asciidoc | 2 +-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ingest/enrich.asciidoc b/docs/reference/ingest/enrich.asciidoc
index fbb1276e4bcaa..5a8e0dab3a25a 100644
--- a/docs/reference/ingest/enrich.asciidoc
+++ b/docs/reference/ingest/enrich.asciidoc
@@ -180,7 +180,7 @@ When defining the enrich processor, you must include at least the following:
 * The enrich policy to use.
 * The field used to match incoming documents to the documents in your enrich index.
 * The target field to add to incoming documents. This target field contains the
-enrich fields specified in your enrich policy.
+match and enrich fields specified in your enrich policy.
 
 You also can use the `max_matches` option to set the number of enrich documents
 an incoming document can match. If set to the default of `1`, data is added to
@@ -371,6 +371,8 @@ the pipeline, add an <<enrich-processor,enrich processor>> that includes:
 * The `field` of incoming documents used to match the geo_shape of documents
   from the enrich index.
 * The `target_field` used to store appended enrich data for incoming documents.
+  This field contains the `match_field` and `enrich_fields` specified in your
+  enrich policy.
 * The `shape_relation`, which indicates how the processor matches geo_shapes in
   incoming documents to geo_shapes in documents from the enrich index. See
   <<_spatial_relations>> for valid options and more information.
@@ -526,6 +528,8 @@ the pipeline, add an <<enrich-processor,enrich processor>> that includes:
 * The `field` of incoming documents used to match documents
   from the enrich index.
 * The `target_field` used to store appended enrich data for incoming documents.
+  This field contains the `match_field` and `enrich_fields` specified in your
+  enrich policy.
 
 [source,console]
 ----
diff --git a/docs/reference/ingest/processors/enrich.asciidoc b/docs/reference/ingest/processors/enrich.asciidoc
index f9766261f4b49..fee2cf7974001 100644
--- a/docs/reference/ingest/processors/enrich.asciidoc
+++ b/docs/reference/ingest/processors/enrich.asciidoc
@@ -13,7 +13,7 @@ See <<ingest-enriching-data,enrich data>> section for more information about how
 | Name               | Required  | Default              | Description
 | `policy_name`      | yes       | -                    | The name of the enrich policy to use.
 | `field`            | yes       | -                    | The field in the input document that matches the policies match_field used to retrieve the enrichment data. Supports <<accessing-template-fields,template snippets>>.
-| `target_field`     | yes       | -                    | The field that will be used for the enrichment data. Supports <<accessing-template-fields,template snippets>>.
+| `target_field`     | yes       | -                    | Field added to incoming documents to contain enrich data. This field contains both the `match_field` and `enrich_fields` specified in the <<enrich-policy-definition,enrich policy>>. Supports <<accessing-template-fields,template snippets>>.
 | `ignore_missing`   | no        | false                | If `true` and `field` does not exist, the processor quietly exits without modifying the document
 | `override`         | no        | true                 | If processor will update fields with pre-existing non-null-valued field. When set to `false`, such fields will not be touched.
 | `max_matches`      | no        | 1                    | The maximum number of matched documents to include under the configured target field. The `target_field` will be turned into a json array if `max_matches` is higher than 1, otherwise `target_field` will become a json object. In order to avoid documents getting too large, the maximum allowed value is 128.

From a05bc15db783b5bc6a7da0fc51b8b674d0eed14d Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Mon, 2 Dec 2019 15:17:18 +0100
Subject: [PATCH 038/686] [Transform] Fix possible audit logging disappearance
 after rolling upgrade (#49731)

ensure audit index template is available during a rolling upgrade before a
transform task can write to it.

fixes #49730
---
 .../TransformInternalIndexConstants.java      |   3 +-
 .../persistence/TransformInternalIndex.java   |  78 ++++++++++--
 .../TransformPersistentTasksExecutor.java     |   4 +-
 .../TransformInternalIndexTests.java          | 112 +++++++++++++++++-
 .../80_transform_jobs_crud.yml                |   8 +-
 5 files changed, 188 insertions(+), 17 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/persistence/TransformInternalIndexConstants.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/persistence/TransformInternalIndexConstants.java
index 574499397e9fd..474943f0e8c26 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/persistence/TransformInternalIndexConstants.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/persistence/TransformInternalIndexConstants.java
@@ -32,7 +32,8 @@ public final class TransformInternalIndexConstants {
     public static final String INDEX_NAME_PATTERN_DEPRECATED = ".data-frame-internal-*";
 
     // audit index
-    public static final String AUDIT_TEMPLATE_VERSION = "000001";
+    // gh #49730: upped version of audit index to 000002
+    public static final String AUDIT_TEMPLATE_VERSION = "000002";
     public static final String AUDIT_INDEX_PREFIX = ".transform-notifications-";
     public static final String AUDIT_INDEX_PATTERN = AUDIT_INDEX_PREFIX + "*";
     public static final String AUDIT_INDEX_DEPRECATED = ".data-frame-notifications-1";
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
index bd436bde9aa2d..d0b94bf6e3e52 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
@@ -315,22 +315,39 @@ private static XContentBuilder addMetaInformation(XContentBuilder builder) throw
                 .endObject();
     }
 
-    public static boolean haveLatestVersionedIndexTemplate(ClusterState state) {
-        return state.getMetaData().getTemplates().containsKey(TransformInternalIndexConstants.LATEST_INDEX_VERSIONED_NAME);
-    }
-
     /**
      * This method should be called before any document is indexed that relies on the
-     * existence of the latest index template to create the internal index.  The
-     * reason is that the standard template upgrader only runs when the master node
+     * existence of the latest index templates to create the internal and audit index.
+     * The reason is that the standard template upgrader only runs when the master node
      * is upgraded to the newer version.  If data nodes are upgraded before master
      * nodes and transforms get assigned to those data nodes then without this check
      * the data nodes will index documents into the internal index before the necessary
      * index template is present and this will result in an index with completely
      * dynamic mappings being created (which is very bad).
      */
-    public static void installLatestVersionedIndexTemplateIfRequired(ClusterService clusterService, Client client,
-                                                                     ActionListener<Void> listener) {
+    public static void installLatestIndexTemplatesIfRequired(ClusterService clusterService, Client client, ActionListener<Void> listener) {
+
+        installLatestVersionedIndexTemplateIfRequired(
+            clusterService,
+            client,
+            ActionListener.wrap(r -> { installLatestAuditIndexTemplateIfRequired(clusterService, client, listener); }, listener::onFailure)
+        );
+
+    }
+
+    protected static boolean haveLatestVersionedIndexTemplate(ClusterState state) {
+        return state.getMetaData().getTemplates().containsKey(TransformInternalIndexConstants.LATEST_INDEX_VERSIONED_NAME);
+    }
+
+    protected static boolean haveLatestAuditIndexTemplate(ClusterState state) {
+        return state.getMetaData().getTemplates().containsKey(TransformInternalIndexConstants.AUDIT_INDEX);
+    }
+
+    protected static void installLatestVersionedIndexTemplateIfRequired(
+        ClusterService clusterService,
+        Client client,
+        ActionListener<Void> listener
+    ) {
 
         // The check for existence of the template is against local cluster state, so very cheap
         if (haveLatestVersionedIndexTemplate(clusterService.state())) {
@@ -348,13 +365,52 @@ public static void installLatestVersionedIndexTemplateIfRequired(ClusterService
                 .settings(indexTemplateMetaData.settings())
                 .mapping(SINGLE_MAPPING_NAME, XContentHelper.convertToMap(jsonMappings, true, XContentType.JSON).v2());
             ActionListener<AcknowledgedResponse> innerListener = ActionListener.wrap(r -> listener.onResponse(null), listener::onFailure);
-            executeAsyncWithOrigin(client.threadPool().getThreadContext(), TRANSFORM_ORIGIN, request,
-                innerListener, client.admin().indices()::putTemplate);
+            executeAsyncWithOrigin(
+                client.threadPool().getThreadContext(),
+                TRANSFORM_ORIGIN,
+                request,
+                innerListener,
+                client.admin().indices()::putTemplate
+            );
         } catch (IOException e) {
             listener.onFailure(e);
         }
     }
 
-    private TransformInternalIndex() {
+    protected static void installLatestAuditIndexTemplateIfRequired(
+        ClusterService clusterService,
+        Client client,
+        ActionListener<Void> listener
+    ) {
+
+        // The check for existence of the template is against local cluster state, so very cheap
+        if (haveLatestAuditIndexTemplate(clusterService.state())) {
+            listener.onResponse(null);
+            return;
+        }
+
+        // Installing the template involves communication with the master node, so it's more expensive but much rarer
+        try {
+            IndexTemplateMetaData indexTemplateMetaData = getAuditIndexTemplateMetaData();
+            BytesReference jsonMappings = new BytesArray(indexTemplateMetaData.mappings().get(SINGLE_MAPPING_NAME).uncompressed());
+            PutIndexTemplateRequest request = new PutIndexTemplateRequest(TransformInternalIndexConstants.AUDIT_INDEX).patterns(
+                indexTemplateMetaData.patterns()
+            )
+                .version(indexTemplateMetaData.version())
+                .settings(indexTemplateMetaData.settings())
+                .mapping(SINGLE_MAPPING_NAME, XContentHelper.convertToMap(jsonMappings, true, XContentType.JSON).v2());
+            ActionListener<AcknowledgedResponse> innerListener = ActionListener.wrap(r -> listener.onResponse(null), listener::onFailure);
+            executeAsyncWithOrigin(
+                client.threadPool().getThreadContext(),
+                TRANSFORM_ORIGIN,
+                request,
+                innerListener,
+                client.admin().indices()::putTemplate
+            );
+        } catch (IOException e) {
+            listener.onFailure(e);
+        }
     }
+
+    private TransformInternalIndex() {}
 }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformPersistentTasksExecutor.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformPersistentTasksExecutor.java
index 3c3c7c7e1a3f0..2ed273128c6bd 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformPersistentTasksExecutor.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformPersistentTasksExecutor.java
@@ -271,8 +271,8 @@ protected void nodeOperation(AllocatedPersistentTask task, @Nullable TransformTa
             }
         );
 
-        // <1> Check the internal index template is installed
-        TransformInternalIndex.installLatestVersionedIndexTemplateIfRequired(clusterService, client, templateCheckListener);
+        // <1> Check the index templates are installed
+        TransformInternalIndex.installLatestIndexTemplatesIfRequired(clusterService, client, templateCheckListener);
     }
 
     private static IndexerState currentIndexerState(TransformState previousState) {
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndexTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndexTests.java
index 83f9b36c496ab..b49546d8f11cc 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndexTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndexTests.java
@@ -38,6 +38,7 @@
 public class TransformInternalIndexTests extends ESTestCase {
 
     public static ClusterState STATE_WITH_LATEST_VERSIONED_INDEX_TEMPLATE;
+    public static ClusterState STATE_WITH_LATEST_AUDIT_INDEX_TEMPLATE;
 
     static {
         ImmutableOpenMap.Builder<String, IndexTemplateMetaData> mapBuilder = ImmutableOpenMap.builder();
@@ -51,6 +52,18 @@ public class TransformInternalIndexTests extends ESTestCase {
         ClusterState.Builder csBuilder = ClusterState.builder(ClusterName.DEFAULT);
         csBuilder.metaData(metaBuilder.build());
         STATE_WITH_LATEST_VERSIONED_INDEX_TEMPLATE = csBuilder.build();
+
+        mapBuilder = ImmutableOpenMap.builder();
+        try {
+            mapBuilder.put(TransformInternalIndexConstants.AUDIT_INDEX, TransformInternalIndex.getAuditIndexTemplateMetaData());
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+        metaBuilder = MetaData.builder();
+        metaBuilder.templates(mapBuilder.build());
+        csBuilder = ClusterState.builder(ClusterName.DEFAULT);
+        csBuilder.metaData(metaBuilder.build());
+        STATE_WITH_LATEST_AUDIT_INDEX_TEMPLATE = csBuilder.build();
     }
 
     public void testHaveLatestVersionedIndexTemplate() {
@@ -81,8 +94,7 @@ public void testInstallLatestVersionedIndexTemplateIfRequired_GivenRequired() {
         when(clusterService.state()).thenReturn(ClusterState.EMPTY_STATE);
 
         IndicesAdminClient indicesClient = mock(IndicesAdminClient.class);
-        doAnswer(
-            invocationOnMock -> {
+        doAnswer(invocationOnMock -> {
             @SuppressWarnings("unchecked")
             ActionListener<AcknowledgedResponse> listener = (ActionListener<AcknowledgedResponse>) invocationOnMock.getArguments()[1];
             listener.onResponse(new AcknowledgedResponse(true));
@@ -112,4 +124,100 @@ public void testInstallLatestVersionedIndexTemplateIfRequired_GivenRequired() {
         verify(indicesClient, times(1)).putTemplate(any(), any());
         verifyNoMoreInteractions(indicesClient);
     }
+
+    public void testHaveLatestAuditIndexTemplate() {
+
+        assertTrue(TransformInternalIndex.haveLatestAuditIndexTemplate(STATE_WITH_LATEST_AUDIT_INDEX_TEMPLATE));
+        assertFalse(TransformInternalIndex.haveLatestAuditIndexTemplate(ClusterState.EMPTY_STATE));
+    }
+
+    public void testInstallLatestAuditIndexTemplateIfRequired_GivenNotRequired() {
+
+        ClusterService clusterService = mock(ClusterService.class);
+        when(clusterService.state()).thenReturn(TransformInternalIndexTests.STATE_WITH_LATEST_AUDIT_INDEX_TEMPLATE);
+
+        Client client = mock(Client.class);
+
+        AtomicBoolean gotResponse = new AtomicBoolean(false);
+        ActionListener<Void> testListener = ActionListener.wrap(aVoid -> gotResponse.set(true), e -> fail(e.getMessage()));
+
+        TransformInternalIndex.installLatestAuditIndexTemplateIfRequired(clusterService, client, testListener);
+
+        assertTrue(gotResponse.get());
+        verifyNoMoreInteractions(client);
+    }
+
+    public void testInstallLatestAuditIndexTemplateIfRequired_GivenRequired() {
+
+        ClusterService clusterService = mock(ClusterService.class);
+        when(clusterService.state()).thenReturn(ClusterState.EMPTY_STATE);
+
+        IndicesAdminClient indicesClient = mock(IndicesAdminClient.class);
+        doAnswer(invocationOnMock -> {
+            @SuppressWarnings("unchecked")
+            ActionListener<AcknowledgedResponse> listener = (ActionListener<AcknowledgedResponse>) invocationOnMock.getArguments()[1];
+            listener.onResponse(new AcknowledgedResponse(true));
+            return null;
+        }).when(indicesClient).putTemplate(any(), any());
+
+        AdminClient adminClient = mock(AdminClient.class);
+        when(adminClient.indices()).thenReturn(indicesClient);
+        Client client = mock(Client.class);
+        when(client.admin()).thenReturn(adminClient);
+
+        ThreadPool threadPool = mock(ThreadPool.class);
+        when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
+        when(client.threadPool()).thenReturn(threadPool);
+
+        AtomicBoolean gotResponse = new AtomicBoolean(false);
+        ActionListener<Void> testListener = ActionListener.wrap(aVoid -> gotResponse.set(true), e -> fail(e.getMessage()));
+
+        TransformInternalIndex.installLatestAuditIndexTemplateIfRequired(clusterService, client, testListener);
+
+        assertTrue(gotResponse.get());
+        verify(client, times(1)).threadPool();
+        verify(client, times(1)).admin();
+        verifyNoMoreInteractions(client);
+        verify(adminClient, times(1)).indices();
+        verifyNoMoreInteractions(adminClient);
+        verify(indicesClient, times(1)).putTemplate(any(), any());
+        verifyNoMoreInteractions(indicesClient);
+    }
+
+    public void testInstallLatestIndexTemplateIfRequired_GivenRequired() {
+
+        ClusterService clusterService = mock(ClusterService.class);
+        when(clusterService.state()).thenReturn(ClusterState.EMPTY_STATE);
+
+        IndicesAdminClient indicesClient = mock(IndicesAdminClient.class);
+        doAnswer(invocationOnMock -> {
+            @SuppressWarnings("unchecked")
+            ActionListener<AcknowledgedResponse> listener = (ActionListener<AcknowledgedResponse>) invocationOnMock.getArguments()[1];
+            listener.onResponse(new AcknowledgedResponse(true));
+            return null;
+        }).when(indicesClient).putTemplate(any(), any());
+
+        AdminClient adminClient = mock(AdminClient.class);
+        when(adminClient.indices()).thenReturn(indicesClient);
+        Client client = mock(Client.class);
+        when(client.admin()).thenReturn(adminClient);
+
+        ThreadPool threadPool = mock(ThreadPool.class);
+        when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
+        when(client.threadPool()).thenReturn(threadPool);
+
+        AtomicBoolean gotResponse = new AtomicBoolean(false);
+        ActionListener<Void> testListener = ActionListener.wrap(aVoid -> gotResponse.set(true), e -> fail(e.getMessage()));
+
+        TransformInternalIndex.installLatestIndexTemplatesIfRequired(clusterService, client, testListener);
+
+        assertTrue(gotResponse.get());
+        verify(client, times(2)).threadPool();
+        verify(client, times(2)).admin();
+        verifyNoMoreInteractions(client);
+        verify(adminClient, times(2)).indices();
+        verifyNoMoreInteractions(adminClient);
+        verify(indicesClient, times(2)).putTemplate(any(), any());
+        verifyNoMoreInteractions(indicesClient);
+    }
 }
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/80_transform_jobs_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/80_transform_jobs_crud.yml
index 9aeaf6cdf82ca..d220c0b1a51ab 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/80_transform_jobs_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/80_transform_jobs_crud.yml
@@ -261,7 +261,7 @@ setup:
         transform_id: "mixed-simple-continuous-transform"
 
 ---
-"Test index mappings for latest internal index":
+"Test index mappings for latest internal index and audit index":
   - do:
       transform.put_transform:
         transform_id: "upgraded-simple-transform"
@@ -282,3 +282,9 @@ setup:
         index: .transform-internal-004
   - match: { \.transform-internal-004.mappings.dynamic: "false" }
   - match: { \.transform-internal-004.mappings.properties.id.type: "keyword" }
+  - do:
+      indices.get_mapping:
+        index: .transform-notifications-000002
+  - match: { \.transform-notifications-000002.mappings.dynamic: "false" }
+  - match: { \.transform-notifications-000002.mappings.properties.transform_id.type: "keyword" }
+  - match: { \.transform-notifications-000002.mappings.properties.timestamp.type: "date" }

From 2b7cea85d0e235b17c471dbb4cf02fe7feff12ac Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 2 Dec 2019 09:22:21 -0500
Subject: [PATCH 039/686] [DOCS] Reformat keep types and keep words token
 filter docs (#49604)

* Adds title abbreviations
* Updates the descriptions and adds Lucene links
* Reformats parameter definitions
* Adds analyze and custom analyzer snippets
* Adds explanations of token types to keep types token filter and tokenizer docs
---
 .../keep-types-tokenfilter.asciidoc           | 225 +++++++++++-------
 .../keep-words-tokenfilter.asciidoc           | 166 ++++++++++---
 docs/reference/analysis/tokenizers.asciidoc   |  11 +-
 3 files changed, 283 insertions(+), 119 deletions(-)

diff --git a/docs/reference/analysis/tokenfilters/keep-types-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/keep-types-tokenfilter.asciidoc
index 39b32d15c991f..838c1252835ce 100644
--- a/docs/reference/analysis/tokenfilters/keep-types-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/keep-types-tokenfilter.asciidoc
@@ -1,137 +1,202 @@
 [[analysis-keep-types-tokenfilter]]
-=== Keep Types Token Filter
+=== Keep types token filter
+++++
+<titleabbrev>Keep types</titleabbrev>
+++++
 
-A token filter of type `keep_types` that only keeps tokens with a token type
-contained in a predefined set.
+Keeps or removes tokens of a specific type. For example, you can use this filter
+to change `3 quick foxes` to `quick foxes` by keeping only `<ALPHANUM>`
+(alphanumeric) tokens.
 
+[NOTE]
+.Token types
+====
+Token types are set by the <<analysis-tokenizers,tokenizer>> when converting
+characters to tokens. Token types can vary between tokenizers.
 
-[float]
-=== Options
-[horizontal]
-types:: a list of types to include (default mode) or exclude
-mode:: if set to `include` (default) the specified token types will be kept, 
-if set to `exclude` the specified token types will be removed from the stream
+For example, the <<analysis-standard-tokenizer,`standard`>> tokenizer can
+produce a variety of token types, including `<ALPHANUM>`, `<HANGUL>`, and
+`<NUM>`. Simpler analyzers, like the
+<<analysis-lowercase-tokenizer,`lowercase`>> tokenizer, only produce the `word`
+token type.
 
-[float]
-=== Settings example
+Certain token filters can also add token types. For example, the 
+<<analysis-synonym-tokenfilter,`synonym`>> filter can add the `<SYNONYM>` token
+type.
+====
 
-You can set it up like:
+This filter uses Lucene's
+https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/core/TypeTokenFilter.html[TypeTokenFilter].
+
+[[analysis-keep-types-tokenfilter-analyze-include-ex]]
+==== Include example
+
+The following <<indices-analyze,analyze API>> request uses the `keep_types`
+filter to keep only `<NUM>` (numeric) tokens from `1 quick fox 2 lazy dogs`.
 
 [source,console]
 --------------------------------------------------
-PUT /keep_types_example
+GET _analyze
 {
-    "settings" : {
-        "analysis" : {
-            "analyzer" : {
-                "my_analyzer" : {
-                    "tokenizer" : "standard",
-                    "filter" : ["lowercase", "extract_numbers"]
-                }
-            },
-            "filter" : {
-                "extract_numbers" : {
-                    "type" : "keep_types",
-                    "types" : [ "<NUM>" ]
-                }
-            }
-        }
+  "tokenizer": "standard",
+  "filter": [
+    {
+      "type": "keep_types",
+      "types": [ "<NUM>" ]
     }
+  ],
+  "text": "1 quick fox 2 lazy dogs"
 }
 --------------------------------------------------
 
-And test it like:
+The filter produces the following tokens:
 
-[source,console]
+[source,text]
 --------------------------------------------------
-POST /keep_types_example/_analyze
-{
-  "analyzer" : "my_analyzer",
-  "text" : "this is just 1 a test"
-}
+[ 1, 2 ]
 --------------------------------------------------
-// TEST[continued]
-
-The response will be:
 
+/////////////////////
 [source,console-result]
 --------------------------------------------------
 {
   "tokens": [
     {
       "token": "1",
-      "start_offset": 13,
-      "end_offset": 14,
+      "start_offset": 0,
+      "end_offset": 1,
+      "type": "<NUM>",
+      "position": 0
+    },
+    {
+      "token": "2",
+      "start_offset": 12,
+      "end_offset": 13,
       "type": "<NUM>",
       "position": 3
     }
   ]
 }
 --------------------------------------------------
+/////////////////////
 
-Note how only the `<NUM>` token is in the output.
-
-[discrete]
-=== Exclude mode settings example
+[[analysis-keep-types-tokenfilter-analyze-exclude-ex]]
+==== Exclude example
 
-If the `mode` parameter is set to `exclude` like in the following example:
+The following <<indices-analyze,analyze API>> request uses the `keep_types`
+filter to remove `<NUM>` tokens from `1 quick fox 2 lazy dogs`. Note the `mode`
+parameter is set to `exclude`.
 
 [source,console]
 --------------------------------------------------
-PUT /keep_types_exclude_example
+GET _analyze
 {
-    "settings" : {
-        "analysis" : {
-            "analyzer" : {
-                "my_analyzer" : {
-                    "tokenizer" : "standard",
-                    "filter" : ["lowercase", "remove_numbers"]
-                }
-            },
-            "filter" : {
-                "remove_numbers" : {
-                    "type" : "keep_types",
-                    "mode" : "exclude",
-                    "types" : [ "<NUM>" ]
-                }
-            }
-        }
+  "tokenizer": "standard",
+  "filter": [
+    {
+      "type": "keep_types",
+      "types": [ "<NUM>" ],
+      "mode": "exclude"
     }
+  ],
+  "text": "1 quick fox 2 lazy dogs"
 }
 --------------------------------------------------
 
-And we test it like:
+The filter produces the following tokens:
 
-[source,console]
+[source,text]
 --------------------------------------------------
-POST /keep_types_exclude_example/_analyze
-{
-  "analyzer" : "my_analyzer",
-  "text" : "hello 101 world"
-}
+[ quick, fox, lazy, dogs ]
 --------------------------------------------------
-// TEST[continued]
-
-The response will be:
 
+/////////////////////
 [source,console-result]
 --------------------------------------------------
 {
   "tokens": [
     {
-      "token": "hello",
-      "start_offset": 0,
-      "end_offset": 5,
+      "token": "quick",
+      "start_offset": 2,
+      "end_offset": 7,
       "type": "<ALPHANUM>",
-      "position": 0
-    }, 
+      "position": 1
+    },
     {
-      "token": "world",
-      "start_offset": 10,
-      "end_offset": 15,
+      "token": "fox",
+      "start_offset": 8,
+      "end_offset": 11,
       "type": "<ALPHANUM>",
       "position": 2
+    },
+    {
+      "token": "lazy",
+      "start_offset": 14,
+      "end_offset": 18,
+      "type": "<ALPHANUM>",
+      "position": 4
+    },
+    {
+      "token": "dogs",
+      "start_offset": 19,
+      "end_offset": 23,
+      "type": "<ALPHANUM>",
+      "position": 5
     }
   ]
 }
 --------------------------------------------------
+/////////////////////
+
+[[analysis-keep-types-tokenfilter-configure-parms]]
+==== Configurable parameters
+
+`types`::
+(Required, array of strings)
+List of token types to keep or remove.
+
+`mode`::
+(Optional, string) 
+Indicates whether to keep or remove the specified token types.
+Valid values are:
+
+`include`:::
+(Default) Keep only the specified token types.
+
+`exclude`:::
+Remove the specified token types.
+
+[[analysis-keep-types-tokenfilter-customize]]
+==== Customize and add to an analyzer
+
+To customize the `keep_types` filter, duplicate it to create the basis
+for a new custom token filter. You can modify the filter using its configurable
+parameters.
+
+For example, the following <<indices-create-index,create index API>> request
+uses a custom `keep_types` filter to configure a new
+<<analysis-custom-analyzer,custom analyzer>>. The custom `keep_types` filter
+keeps only `<ALPHANUM>` (alphanumeric) tokens.
+
+[source,console]
+--------------------------------------------------
+PUT keep_types_example
+{
+  "settings": {
+    "analysis": {
+      "analyzer": {
+        "my_analyzer": {
+          "tokenizer": "standard",
+          "filter": [ "extract_alpha" ]
+        }
+      },
+      "filter": {
+        "extract_alpha": {
+          "type": "keep_types",
+          "types": [ "<ALPHANUM>" ]
+        }
+      }
+    }
+  }
+}
+--------------------------------------------------
diff --git a/docs/reference/analysis/tokenfilters/keep-words-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/keep-words-tokenfilter.asciidoc
index 8166c4c2d5bba..a7dc784c3b734 100644
--- a/docs/reference/analysis/tokenfilters/keep-words-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/keep-words-tokenfilter.asciidoc
@@ -1,50 +1,146 @@
 [[analysis-keep-words-tokenfilter]]
-=== Keep Words Token Filter
+=== Keep words token filter
+++++
+<titleabbrev>Keep words</titleabbrev>
+++++
 
-A token filter of type `keep` that only keeps tokens with text contained in a
-predefined set of words. The set of words can be defined in the settings or
-loaded from a text file containing one word per line.
+Keeps only tokens contained in a specified word list.
 
+This filter uses Lucene's
+https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/miscellaneous/KeepWordFilter.html[KeepWordFilter].
 
-[float]
-=== Options
-[horizontal]
-keep_words:: a list of words to keep
-keep_words_path:: a path to a words file
-keep_words_case:: a boolean indicating whether to lower case the words (defaults to `false`)
+[NOTE]
+====
+To remove a list of words from a token stream, use the
+<<analysis-stop-tokenfilter,`stop`>> filter.
+====
 
+[[analysis-keep-words-tokenfilter-analyze-ex]]
+==== Example
 
+The following <<indices-analyze,analyze API>> request uses the `keep` filter to
+keep only the `fox` and `dog` tokens from
+`the quick fox jumps over the lazy dog`.
 
-[float]
-=== Settings example
+[source,console]
+--------------------------------------------------
+GET _analyze
+{
+  "tokenizer": "whitespace",
+  "filter": [
+    {
+      "type": "keep",
+      "keep_words": [ "dog", "elephant", "fox" ]
+    }
+  ],
+  "text": "the quick fox jumps over the lazy dog"
+}
+--------------------------------------------------
+
+The filter produces the following tokens:
+
+[source,text]
+--------------------------------------------------
+[ fox, dog ]
+--------------------------------------------------
+
+/////////////////////
+[source,console-result]
+--------------------------------------------------
+{
+  "tokens": [
+    {
+      "token": "fox",
+      "start_offset": 10,
+      "end_offset": 13,
+      "type": "word",
+      "position": 2
+    },
+    {
+      "token": "dog",
+      "start_offset": 34,
+      "end_offset": 37,
+      "type": "word",
+      "position": 7
+    }
+  ]
+}
+--------------------------------------------------
+/////////////////////
+
+[[analysis-keep-words-tokenfilter-configure-parms]]
+==== Configurable parameters
+
+`keep_words`::
++
+--
+(Required+++*+++, array of strings)
+List of words to keep. Only tokens that match words in this list are included in
+the output.
+
+Either this parameter or `keep_words_path` must be specified.
+--
+
+`keep_words_path`::
++
+--
+(Required+++*+++, array of strings)
+Path to a file that contains a list of words to keep. Only tokens that match
+words in this list are included in the output.
+
+This path must be absolute or relative to the `config` location, and the file
+must be UTF-8 encoded. Each word in the file must be separated by a line break.
+
+Either this parameter or `keep_words` must be specified.
+--
+
+`keep_words_case`::
+(Optional, boolean)
+If `true`, lowercase all keep words. Defaults to `false`.
+
+[[analysis-keep-words-tokenfilter-customize]]
+==== Customize and add to an analyzer
+
+To customize the `keep` filter, duplicate it to create the basis for a new
+custom token filter. You can modify the filter using its configurable
+parameters.
+
+For example, the following <<indices-create-index,create index API>> request
+uses custom `keep` filters to configure two new
+<<analysis-custom-analyzer,custom analyzers>>:
+
+* `standard_keep_word_array`, which uses a custom `keep` filter with an inline
+  array of keep words
+* `standard_keep_word_file`, which uses a customer `keep` filter with a keep
+  words file
 
 [source,console]
 --------------------------------------------------
-PUT /keep_words_example
+PUT keep_words_example
 {
-    "settings" : {
-        "analysis" : {
-            "analyzer" : {
-                "example_1" : {
-                    "tokenizer" : "standard",
-                    "filter" : ["lowercase", "words_till_three"]
-                },
-                "example_2" : {
-                    "tokenizer" : "standard",
-                    "filter" : ["lowercase", "words_in_file"]
-                }
-            },
-            "filter" : {
-                "words_till_three" : {
-                    "type" : "keep",
-                    "keep_words" : [ "one", "two", "three"]
-                },
-                "words_in_file" : {
-                    "type" : "keep",
-                    "keep_words_path" : "analysis/example_word_list.txt"
-                }
-            }
+  "settings": {
+    "analysis": {
+      "analyzer": {
+        "standard_keep_word_array": {
+          "tokenizer": "standard",
+          "filter": [ "keep_word_array" ]
+        },
+        "standard_keep_word_file": {
+          "tokenizer": "standard",
+          "filter": [ "keep_word_file" ]
+        }
+      },
+      "filter": {
+        "keep_word_array": {
+          "type": "keep",
+          "keep_words": [ "one", "two", "three" ]
+        },
+        "keep_word_file": {
+          "type": "keep",
+          "keep_words_path": "analysis/example_word_list.txt"
         }
+      }
     }
+  }
 }
 --------------------------------------------------
diff --git a/docs/reference/analysis/tokenizers.asciidoc b/docs/reference/analysis/tokenizers.asciidoc
index 106f08cdb0cca..f4a8a13aabb0b 100644
--- a/docs/reference/analysis/tokenizers.asciidoc
+++ b/docs/reference/analysis/tokenizers.asciidoc
@@ -7,10 +7,13 @@ instance, a <<analysis-whitespace-tokenizer,`whitespace`>> tokenizer breaks
 text into tokens whenever it sees any whitespace.  It would convert the text
 `"Quick brown fox!"` into the terms `[Quick, brown, fox!]`.
 
-The tokenizer is also responsible for recording the order or _position_ of
-each term (used for phrase and word proximity queries) and the start and end
-_character offsets_ of the original word which the term represents (used for
-highlighting search snippets).
+The tokenizer is also responsible for recording the following:
+
+* Order or _position_ of each term (used for phrase and word proximity queries)
+* Start and end _character offsets_ of the original word which the term
+represents (used for highlighting search snippets).
+* _Token type_, a classification of each term produced, such as `<ALPHANUM>`,
+`<HANGUL>`, or `<NUM>`. Simpler analyzers only produce the `word` token type.
 
 Elasticsearch has a number of built in tokenizers which can be used to build
 <<analysis-custom-analyzer,custom analyzers>>.

From a8b6c2305902bb5500aeae5745386a700220158f Mon Sep 17 00:00:00 2001
From: Ignacio Vera <ivera@apache.org>
Date: Mon, 2 Dec 2019 15:35:33 +0100
Subject: [PATCH 040/686] Add CoreValuesSourceTypeTests for histogram (#49751)

---
 .../aggregations/support/CoreValuesSourceTypeTests.java       | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/support/CoreValuesSourceTypeTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/support/CoreValuesSourceTypeTests.java
index e7e39e7a43b61..5f57a8ee9c12e 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/support/CoreValuesSourceTypeTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/support/CoreValuesSourceTypeTests.java
@@ -38,6 +38,7 @@ public void testValidOrdinals() {
         assertThat(CoreValuesSourceType.BYTES.ordinal(), equalTo(2));
         assertThat(CoreValuesSourceType.GEOPOINT.ordinal(), equalTo(3));
         assertThat(CoreValuesSourceType.RANGE.ordinal(), equalTo(4));
+        assertThat(CoreValuesSourceType.HISTOGRAM.ordinal(), equalTo(5));
     }
 
     @Override
@@ -47,6 +48,7 @@ public void testFromString() {
         assertThat(CoreValuesSourceType.fromString("bytes"), equalTo(CoreValuesSourceType.BYTES));
         assertThat(CoreValuesSourceType.fromString("geopoint"), equalTo(CoreValuesSourceType.GEOPOINT));
         assertThat(CoreValuesSourceType.fromString("range"), equalTo(CoreValuesSourceType.RANGE));
+        assertThat(CoreValuesSourceType.fromString("histogram"), equalTo(CoreValuesSourceType.HISTOGRAM));
         IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
             () -> CoreValuesSourceType.fromString("does_not_exist"));
         assertThat(e.getMessage(),
@@ -61,6 +63,7 @@ public void testReadFrom() throws IOException {
         assertReadFromStream(2, CoreValuesSourceType.BYTES);
         assertReadFromStream(3, CoreValuesSourceType.GEOPOINT);
         assertReadFromStream(4, CoreValuesSourceType.RANGE);
+        assertReadFromStream(5, CoreValuesSourceType.HISTOGRAM);
     }
 
     @Override
@@ -70,5 +73,6 @@ public void testWriteTo() throws IOException {
         assertWriteToStream(CoreValuesSourceType.BYTES, 2);
         assertWriteToStream(CoreValuesSourceType.GEOPOINT, 3);
         assertWriteToStream(CoreValuesSourceType.RANGE, 4);
+        assertWriteToStream(CoreValuesSourceType.HISTOGRAM, 5);
     }
 }

From 876c01f5102c7d7d7efb56d31c14eb780a1da8e5 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 2 Dec 2019 16:42:26 +0100
Subject: [PATCH 041/686] Make Snapshot Metadata Javadocs Clearer (#49697)

We are always using the snapshot name on the shard level,
lets make it crystal clear in the docs.
---
 .../snapshots/blobstore/BlobStoreIndexShardSnapshot.java | 9 ++++++---
 .../index/snapshots/blobstore/SnapshotFiles.java         | 9 +++++++++
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/snapshots/blobstore/BlobStoreIndexShardSnapshot.java b/server/src/main/java/org/elasticsearch/index/snapshots/blobstore/BlobStoreIndexShardSnapshot.java
index e2a2ce4428881..624510bb86f67 100644
--- a/server/src/main/java/org/elasticsearch/index/snapshots/blobstore/BlobStoreIndexShardSnapshot.java
+++ b/server/src/main/java/org/elasticsearch/index/snapshots/blobstore/BlobStoreIndexShardSnapshot.java
@@ -335,6 +335,9 @@ public String toString() {
         }
     }
 
+    /**
+     * Snapshot name
+     */
     private final String snapshot;
 
     private final long indexVersion;
@@ -352,7 +355,7 @@ public String toString() {
     /**
      * Constructs new shard snapshot metadata from snapshot metadata
      *
-     * @param snapshot              snapshot id
+     * @param snapshot              snapshot name
      * @param indexVersion          index version
      * @param indexFiles            list of files in the shard
      * @param startTime             snapshot start time
@@ -377,9 +380,9 @@ public BlobStoreIndexShardSnapshot(String snapshot, long indexVersion, List<File
     }
 
     /**
-     * Returns snapshot id
+     * Returns snapshot name
      *
-     * @return snapshot id
+     * @return snapshot name
      */
     public String snapshot() {
         return snapshot;
diff --git a/server/src/main/java/org/elasticsearch/index/snapshots/blobstore/SnapshotFiles.java b/server/src/main/java/org/elasticsearch/index/snapshots/blobstore/SnapshotFiles.java
index 6466ecbaecbe4..5da7b2b1f8c6b 100644
--- a/server/src/main/java/org/elasticsearch/index/snapshots/blobstore/SnapshotFiles.java
+++ b/server/src/main/java/org/elasticsearch/index/snapshots/blobstore/SnapshotFiles.java
@@ -35,10 +35,19 @@ public class SnapshotFiles {
 
     private Map<String, FileInfo> physicalFiles = null;
 
+    /**
+     * Returns snapshot name
+     *
+     * @return snapshot name
+     */
     public String snapshot() {
         return snapshot;
     }
 
+    /**
+     * @param snapshot   snapshot name
+     * @param indexFiles index files
+     */
     public SnapshotFiles(String snapshot, List<FileInfo> indexFiles ) {
         this.snapshot = snapshot;
         this.indexFiles = indexFiles;

From d741c830fa70c12c018dc52bd153853adba7c8ae Mon Sep 17 00:00:00 2001
From: jimczi <jim.ferenczi@elastic.co>
Date: Mon, 2 Dec 2019 20:15:46 +0100
Subject: [PATCH 042/686] add new version 7.5.1

---
 server/src/main/java/org/elasticsearch/Version.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/Version.java b/server/src/main/java/org/elasticsearch/Version.java
index 9fa0fc9180029..c39502f0b0e3d 100644
--- a/server/src/main/java/org/elasticsearch/Version.java
+++ b/server/src/main/java/org/elasticsearch/Version.java
@@ -69,8 +69,8 @@ public class Version implements Comparable<Version>, ToXContentFragment {
     public static final Version V_7_4_0 = new Version(7040099, org.apache.lucene.util.Version.LUCENE_8_2_0);
     public static final Version V_7_4_1 = new Version(7040199, org.apache.lucene.util.Version.LUCENE_8_2_0);
     public static final Version V_7_4_2 = new Version(7040299, org.apache.lucene.util.Version.LUCENE_8_2_0);
-    public static final Version V_7_4_3 = new Version(7040399, org.apache.lucene.util.Version.LUCENE_8_2_0);
     public static final Version V_7_5_0 = new Version(7050099, org.apache.lucene.util.Version.LUCENE_8_3_0);
+    public static final Version V_7_5_1 = new Version(7050199, org.apache.lucene.util.Version.LUCENE_8_3_0);
     public static final Version V_7_6_0 = new Version(7060099, org.apache.lucene.util.Version.LUCENE_8_4_0);
     public static final Version V_8_0_0 = new Version(8000099, org.apache.lucene.util.Version.LUCENE_8_4_0);
     public static final Version CURRENT = V_8_0_0;

From b44ced920805d07b3ca674d6c7d6d68f78c3327d Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 2 Dec 2019 15:52:13 -0500
Subject: [PATCH 043/686] [DOCS] Document CCR compatibility requirements
 (#49776)

* Creates a prerequisites section in the cross-cluster replication (CCR)
  overview.
* Adds concise definitions for local and remote cluster in a CCR context.
* Documents that the ES version of the local cluster must be the same
  or a newer compatible version as the remote cluster.
---
 docs/reference/ccr/overview.asciidoc            | 13 ++++++++++++-
 docs/reference/modules/remote-clusters.asciidoc |  2 ++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/docs/reference/ccr/overview.asciidoc b/docs/reference/ccr/overview.asciidoc
index 34902d7889299..7ea9fd210f6e9 100644
--- a/docs/reference/ccr/overview.asciidoc
+++ b/docs/reference/ccr/overview.asciidoc
@@ -17,7 +17,18 @@ Replication is pull-based. This means that replication is driven by the
 follower index. This simplifies state management on the leader index and means
 that {ccr} does not interfere with indexing on the leader index.
 
-IMPORTANT: {ccr-cap} requires <<modules-remote-clusters, remote clusters>>.
+In {ccr}, the cluster performing this pull is known as the _local cluster_. The
+cluster being replicated is known as the _remote cluster_.
+
+==== Prerequisites
+
+* {ccr-cap} requires <<modules-remote-clusters, remote clusters>>.
+
+* The {es} version of the local cluster must be **the same as or newer** than
+the remote cluster. If newer, the versions must also be compatible as outlined
+in the following matrix.
+
+include::../modules/remote-clusters.asciidoc[tag=remote-cluster-compatibility-matrix]
 
 ==== Configuring replication
 
diff --git a/docs/reference/modules/remote-clusters.asciidoc b/docs/reference/modules/remote-clusters.asciidoc
index e7e820d71cf67..0d0b24f31e25d 100644
--- a/docs/reference/modules/remote-clusters.asciidoc
+++ b/docs/reference/modules/remote-clusters.asciidoc
@@ -43,6 +43,7 @@ node, while 6.7 can only communicate with 7.0. Version compatibility  is
 symmetric, meaning that if 6.7 can communicate with 7.0, 7.0 can also
 communicate with 6.7. The matrix below summarizes compatibility as described above.
 
+// tag::remote-cluster-compatibility-matrix[]
 [cols="^,^,^,^,^,^,^,^"]
 |====
 | Compatibility | 5.0->5.5 | 5.6 | 6.0->6.6 | 6.7 | 6.8 | 7.0 | 7.1->7.x
@@ -54,6 +55,7 @@ communicate with 6.7. The matrix below summarizes compatibility as described abo
 | 7.0           |    No    | No  |    No    | Yes | Yes | Yes |    Yes
 | 7.1->7.x      |    No    | No  |    No    | No  | Yes | Yes |    Yes
 |====
+// end::remote-cluster-compatibility-matrix[]
 
 - *role*: Dedicated master nodes never get selected.
 - *attributes*: You can tag which nodes should be selected

From 585adfcc6d6f4ce4c267a04ad491deac57e3946f Mon Sep 17 00:00:00 2001
From: Mayya Sharipova <mayya.sharipova@elastic.co>
Date: Mon, 2 Dec 2019 17:00:58 -0500
Subject: [PATCH 044/686] Mute testIndexHasDuplicateData (#49779)

Related to #49703
---
 .../java/org/elasticsearch/search/query/QueryPhaseTests.java     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/server/src/test/java/org/elasticsearch/search/query/QueryPhaseTests.java b/server/src/test/java/org/elasticsearch/search/query/QueryPhaseTests.java
index 2c9fc90c22cab..4c33177e268f9 100644
--- a/server/src/test/java/org/elasticsearch/search/query/QueryPhaseTests.java
+++ b/server/src/test/java/org/elasticsearch/search/query/QueryPhaseTests.java
@@ -703,6 +703,7 @@ public void testNumericLongOrDateSortOptimization() throws Exception {
         dir.close();
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/49703")
     public void testIndexHasDuplicateData() throws IOException {
         int docsCount = 7000;
         int duplIndex = docsCount * 7 / 10;

From 617a9cea50679af866680045859647695ad6f008 Mon Sep 17 00:00:00 2001
From: Mayya Sharipova <mayya.sharipova@elastic.co>
Date: Mon, 2 Dec 2019 17:01:30 -0500
Subject: [PATCH 045/686] Disable sort optimization when index is sorted
 (#49727)

Don't run long sort optimization when index is already
sorted on the same field as the sort query parameter.

Relates to #37043, follow up for  #48804
---
 .../main/java/org/elasticsearch/search/query/QueryPhase.java  | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/server/src/main/java/org/elasticsearch/search/query/QueryPhase.java b/server/src/main/java/org/elasticsearch/search/query/QueryPhase.java
index 7ec6bf3e68313..ba5ae725cab6f 100644
--- a/server/src/main/java/org/elasticsearch/search/query/QueryPhase.java
+++ b/server/src/main/java/org/elasticsearch/search/query/QueryPhase.java
@@ -412,6 +412,10 @@ private static Query tryRewriteLongSort(SearchContext searchContext, IndexReader
         if (searchContext.collapse() != null) return null;
         if (searchContext.trackScores()) return null;
         if (searchContext.aggregations() != null) return null;
+        if (canEarlyTerminate(reader, searchContext.sort())) {
+            // disable this optimization if index sorting matches the query sort since it's already optimized by index searcher
+            return null;
+        }
         Sort sort = searchContext.sort().sort;
         SortField sortField = sort.getSort()[0];
         if (SortField.Type.LONG.equals(IndexSortConfig.getSortFieldType(sortField)) == false) return null;

From 4a126abef2c43cd10c753f43488f0b921147fbb2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Tue, 3 Dec 2019 08:19:33 +0100
Subject: [PATCH 046/686] Make only a part of `stop()` method a critical
 section. (#49756)

---
 .../dataframe/process/AnalyticsProcessManager.java  | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
index 0a2c6440bf0cc..ed9d715b5f78c 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
@@ -93,7 +93,7 @@ public void runJob(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig config,
                        Consumer<Exception> finishHandler) {
         executorServiceForJob.execute(() -> {
             ProcessContext processContext = new ProcessContext(config.getId());
-            synchronized (this) {
+            synchronized (processContextByAllocation) {
                 if (task.isStopping()) {
                     // The task was requested to stop before we created the process context
                     finishHandler.accept(null);
@@ -295,14 +295,17 @@ private void closeProcess(DataFrameAnalyticsTask task) {
             processContext.process.close();
             LOGGER.info("[{}] Closed process", configId);
         } catch (Exception e) {
-            String errorMsg = new ParameterizedMessage("[{}] Error closing data frame analyzer process [{}]"
-                , configId, e.getMessage()).getFormattedMessage();
+            String errorMsg = new ParameterizedMessage(
+                "[{}] Error closing data frame analyzer process [{}]", configId, e.getMessage()).getFormattedMessage();
             processContext.setFailureReason(errorMsg);
         }
     }
 
-    public synchronized void stop(DataFrameAnalyticsTask task) {
-        ProcessContext processContext = processContextByAllocation.get(task.getAllocationId());
+    public void stop(DataFrameAnalyticsTask task) {
+        ProcessContext processContext;
+        synchronized (processContextByAllocation) {
+            processContext = processContextByAllocation.get(task.getAllocationId());
+        }
         if (processContext != null) {
             LOGGER.debug("[{}] Stopping process", task.getParams().getId());
             processContext.stop();

From 7d38dac63e144f25b606d1b7e5a3dcfaba78e00e Mon Sep 17 00:00:00 2001
From: Eric Miers <ejmiers@msn.com>
Date: Tue, 3 Dec 2019 04:31:41 -0500
Subject: [PATCH 047/686] Update CONTRIBUTING.md to require Docker for some
 tasks (#49221)

Updated the contributing guide to reflect that Docker is a necessary
dependency for certain tasks.
---
 CONTRIBUTING.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 24d9b4a87c461..53935ec15feb4 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -115,6 +115,10 @@ We support development in the Eclipse and IntelliJ IDEs.
 For Eclipse, the minimum version that we support is [4.13][eclipse].
 For IntelliJ, the minimum version that we support is [IntelliJ 2017.2][intellij].
 
+[Docker](https://docs.docker.com/install/) is required for building some Elasticsearch artifacts and executing certain test suites. You can run Elasticsearch without building all the artifacts with:
+
+    ./gradlew :run
+
 ### Configuring IDEs And Running Tests
 
 Eclipse users can automatically configure their IDE: `./gradlew eclipse`

From 7733366ce217e4c5c93e7345dad2b476acd4994d Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Tue, 3 Dec 2019 09:43:54 +0000
Subject: [PATCH 048/686] Add healthchecks to distro docker-compose.yml
 (#49710)

If there are environmental reasons why docker-compose can't bring up
containers in the :distribution:docker project, it's not that clear from
the command line output. Add healthchecks to the compose file so that
the cluster's health is explicitly checked.

Also add a note about Docker memory requirements to the testing docs.
---
 TESTING.asciidoc                       |  4 ++
 distribution/docker/docker-compose.yml | 82 +++++++++++++++++---------
 2 files changed, 57 insertions(+), 29 deletions(-)

diff --git a/TESTING.asciidoc b/TESTING.asciidoc
index 438dbe5ba5ce2..41cdc19e87f98 100644
--- a/TESTING.asciidoc
+++ b/TESTING.asciidoc
@@ -263,6 +263,10 @@ If you want to just run the precommit checks:
 
 Some of these checks will require `docker-compose` installed for bringing up
 test fixtures. If it's not present those checks will be skipped automatically.
+The host running Docker (or VM if you're using Docker Desktop) needs 4GB of
+memory or some of the containers will fail to start. You can tell that you
+are short of memory if containers are exiting quickly after starting with
+code 137 (128 + 9, where 9 means SIGKILL).
 
 == Testing the REST layer
 
diff --git a/distribution/docker/docker-compose.yml b/distribution/docker/docker-compose.yml
index acf24cbce28bd..245056382f304 100644
--- a/distribution/docker/docker-compose.yml
+++ b/distribution/docker/docker-compose.yml
@@ -1,12 +1,12 @@
 # Only used for testing the docker images
-version: '3'
+version: '3.7'
 services:
   elasticsearch-default-1:
     image: elasticsearch:test
-    environment:  
-       - node.name=elasticsearch-default-1 
+    environment:
+       - node.name=elasticsearch-default-1
        - cluster.initial_master_nodes=elasticsearch-default-1,elasticsearch-default-2
-       - discovery.seed_hosts=elasticsearch-default-2:9300 
+       - discovery.seed_hosts=elasticsearch-default-2:9300
        - cluster.name=elasticsearch-default
        - bootstrap.memory_lock=true
        - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
@@ -16,20 +16,20 @@ services:
        - cluster.routing.allocation.disk.watermark.high=1b
        - cluster.routing.allocation.disk.watermark.flood_stage=1b
        - script.max_compilations_rate=2048/1m
-       - node.store.allow_mmap=false  
+       - node.store.allow_mmap=false
        - xpack.security.enabled=true
        - xpack.security.transport.ssl.enabled=true
        - xpack.security.http.ssl.enabled=true
        - xpack.security.authc.token.enabled=true
        - xpack.security.audit.enabled=true
-       - xpack.security.authc.realms.file.file1.order=0   
+       - xpack.security.authc.realms.file.file1.order=0
        - xpack.security.authc.realms.native.native1.order=1
        - xpack.security.transport.ssl.keystore.path=/usr/share/elasticsearch/config/testnode.jks
        - xpack.security.http.ssl.keystore.path=/usr/share/elasticsearch/config/testnode.jks
-       - xpack.http.ssl.verification_mode=certificate  
-       - xpack.security.transport.ssl.verification_mode=certificate  
+       - xpack.http.ssl.verification_mode=certificate
+       - xpack.security.transport.ssl.verification_mode=certificate
        - xpack.license.self_generated.type=trial
-    volumes: 
+    volumes:
        - ./build/repo:/tmp/es-repo
        - ./build/certs/testnode.jks:/usr/share/elasticsearch/config/testnode.jks
        - ./build/logs/default-1:/usr/share/elasticsearch/logs
@@ -42,14 +42,20 @@ services:
         hard: -1
       nofile:
         soft: 65536
-        hard: 65536      
+        hard: 65536
     entrypoint: /docker-test-entrypoint.sh
+    healthcheck:
+      start_period: 15s
+      test: ["CMD", "curl", "-f", "-u", "x_pack_rest_user:x-pack-test-password", "-k", "https://localhost:9200"]
+      interval: 10s
+      timeout: 2s
+      retries: 5
   elasticsearch-default-2:
     image: elasticsearch:test
-    environment:  
+    environment:
        - node.name=elasticsearch-default-2
        - cluster.initial_master_nodes=elasticsearch-default-1,elasticsearch-default-2
-       - discovery.seed_hosts=elasticsearch-default-1:9300 
+       - discovery.seed_hosts=elasticsearch-default-1:9300
        - cluster.name=elasticsearch-default
        - bootstrap.memory_lock=true
        - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
@@ -59,20 +65,20 @@ services:
        - cluster.routing.allocation.disk.watermark.high=1b
        - cluster.routing.allocation.disk.watermark.flood_stage=1b
        - script.max_compilations_rate=2048/1m
-       - node.store.allow_mmap=false  
+       - node.store.allow_mmap=false
        - xpack.security.enabled=true
        - xpack.security.transport.ssl.enabled=true
        - xpack.security.http.ssl.enabled=true
        - xpack.security.authc.token.enabled=true
        - xpack.security.audit.enabled=true
-       - xpack.security.authc.realms.file.file1.order=0   
-       - xpack.security.authc.realms.native.native1.order=1  
+       - xpack.security.authc.realms.file.file1.order=0
+       - xpack.security.authc.realms.native.native1.order=1
        - xpack.security.transport.ssl.keystore.path=/usr/share/elasticsearch/config/testnode.jks
        - xpack.security.http.ssl.keystore.path=/usr/share/elasticsearch/config/testnode.jks
-       - xpack.http.ssl.verification_mode=certificate  
-       - xpack.security.transport.ssl.verification_mode=certificate  
+       - xpack.http.ssl.verification_mode=certificate
+       - xpack.security.transport.ssl.verification_mode=certificate
        - xpack.license.self_generated.type=trial
-    volumes: 
+    volumes:
        - ./build/repo:/tmp/es-repo
        - ./build/certs/testnode.jks:/usr/share/elasticsearch/config/testnode.jks
        - ./build/logs/default-2:/usr/share/elasticsearch/logs
@@ -85,14 +91,20 @@ services:
         hard: -1
       nofile:
         soft: 65536
-        hard: 65536            
+        hard: 65536
     entrypoint: /docker-test-entrypoint.sh
+    healthcheck:
+      start_period: 15s
+      test: ["CMD", "curl", "-f", "-u", "x_pack_rest_user:x-pack-test-password", "-k", "https://localhost:9200"]
+      interval: 10s
+      timeout: 2s
+      retries: 5
   elasticsearch-oss-1:
     image: elasticsearch:test
-    environment:  
-       - node.name=elasticsearch-oss-1 
+    environment:
+       - node.name=elasticsearch-oss-1
        - cluster.initial_master_nodes=elasticsearch-oss-1,elasticsearch-oss-2
-       - discovery.seed_hosts=elasticsearch-oss-2:9300 
+       - discovery.seed_hosts=elasticsearch-oss-2:9300
        - cluster.name=elasticsearch-oss
        - bootstrap.memory_lock=true
        - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
@@ -102,8 +114,8 @@ services:
        - cluster.routing.allocation.disk.watermark.high=1b
        - cluster.routing.allocation.disk.watermark.flood_stage=1b
        - script.max_compilations_rate=2048/1m
-       - node.store.allow_mmap=false  
-    volumes: 
+       - node.store.allow_mmap=false
+    volumes:
        - ./build/oss-repo:/tmp/es-repo
        - ./build/logs/oss-1:/usr/share/elasticsearch/logs
     ports:
@@ -114,13 +126,19 @@ services:
         hard: -1
       nofile:
         soft: 65536
-        hard: 65536    
+        hard: 65536
+    healthcheck:
+      start_period: 15s
+      test: ["CMD", "curl", "-f", "http://localhost:9200"]
+      interval: 10s
+      timeout: 2s
+      retries: 5
   elasticsearch-oss-2:
     image: elasticsearch:test
-    environment:  
+    environment:
        - node.name=elasticsearch-oss-2
        - cluster.initial_master_nodes=elasticsearch-oss-1,elasticsearch-oss-2
-       - discovery.seed_hosts=elasticsearch-oss-1:9300 
+       - discovery.seed_hosts=elasticsearch-oss-1:9300
        - cluster.name=elasticsearch-oss
        - bootstrap.memory_lock=true
        - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
@@ -130,8 +148,8 @@ services:
        - cluster.routing.allocation.disk.watermark.high=1b
        - cluster.routing.allocation.disk.watermark.flood_stage=1b
        - script.max_compilations_rate=2048/1m
-       - node.store.allow_mmap=false  
-    volumes: 
+       - node.store.allow_mmap=false
+    volumes:
        - ./build/oss-repo:/tmp/es-repo
        - ./build/logs/oss-2:/usr/share/elasticsearch/logs
     ports:
@@ -140,3 +158,9 @@ services:
       memlock:
         soft: -1
         hard: -1
+    healthcheck:
+      start_period: 15s
+      test: ["CMD", "curl", "-f", "http://localhost:9200"]
+      interval: 10s
+      timeout: 2s
+      retries: 5

From 80d6e78e8a3f49738e1d535a5899d034ed36f2bc Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 3 Dec 2019 11:46:50 +0100
Subject: [PATCH 049/686] Replicate write actions before fsyncing them (#49746)

This commit fixes a number of issues with data replication:

- Local and global checkpoints are not updated after the new operations have been fsynced, but
might capture a state before the fsync. The reason why this probably went undetected for so
long is that AsyncIOProcessor is synchronous if you index one item at a time, and hence working
as intended unless you have a high enough level of concurrent indexing. As we rely in other
places on the assumption that we have an up-to-date local checkpoint in case of synchronous
translog durability, there's a risk for the local and global checkpoints not to be up-to-date after
replication completes, and that this won't be corrected by the periodic global checkpoint sync.
- AsyncIOProcessor also has another "bad" side effect here: if you index one bulk at a time, the
bulk is always first fsynced on the primary before being sent to the replica. Further, if one thread
is tasked by AsyncIOProcessor to drain the processing queue and fsync, other threads can
easily pile more bulk requests on top of that thread. Things are not very fair here, and the thread
might continue doing a lot more fsyncs before returning (as the other threads pile more and
more on top), which blocks it from returning as a replication request (e.g. if this thread is on the
primary, it blocks the replication requests to the replicas from going out, and delaying
checkpoint advancement).

This commit fixes all these issues, and also simplifies the code that coordinates all the after
write actions.
---
 .../replication/ReplicationOperation.java     |  56 +++++++--
 .../TransportReplicationAction.java           | 101 +++++++--------
 .../replication/TransportWriteAction.java     | 118 +++++++-----------
 ...portVerifyShardBeforeCloseActionTests.java |   5 +
 .../ReplicationOperationTests.java            |  11 ++
 .../TransportWriteActionTests.java            |  58 ++-------
 .../index/seqno/GlobalCheckpointSyncIT.java   |  27 ++++
 ...tentionLeaseBackgroundSyncActionTests.java |   2 +-
 .../seqno/RetentionLeaseSyncActionTests.java  |   2 +-
 .../ESIndexLevelReplicationTestCase.java      |  20 ++-
 .../TransportBulkShardOperationsAction.java   |  32 ++---
 .../ShardFollowTaskReplicationTests.java      |  40 +++---
 .../action/bulk/BulkShardOperationsTests.java |   7 +-
 13 files changed, 241 insertions(+), 238 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/support/replication/ReplicationOperation.java b/server/src/main/java/org/elasticsearch/action/support/replication/ReplicationOperation.java
index 8cea44911bbe7..e24a3dbe381c3 100644
--- a/server/src/main/java/org/elasticsearch/action/support/replication/ReplicationOperation.java
+++ b/server/src/main/java/org/elasticsearch/action/support/replication/ReplicationOperation.java
@@ -46,6 +46,7 @@
 import java.util.Locale;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicInteger;
+import java.util.function.LongSupplier;
 
 public class ReplicationOperation<
             Request extends ReplicationRequest<Request>,
@@ -110,8 +111,6 @@ public void execute() throws Exception {
 
     private void handlePrimaryResult(final PrimaryResultT primaryResult) {
         this.primaryResult = primaryResult;
-        primary.updateLocalCheckpointForShard(primary.routingEntry().allocationId().getId(), primary.localCheckpoint());
-        primary.updateGlobalCheckpointForShard(primary.routingEntry().allocationId().getId(), primary.globalCheckpoint());
         final ReplicaRequest replicaRequest = primaryResult.replicaRequest();
         if (replicaRequest != null) {
             if (logger.isTraceEnabled()) {
@@ -134,8 +133,26 @@ private void handlePrimaryResult(final PrimaryResultT primaryResult) {
             markUnavailableShardsAsStale(replicaRequest, replicationGroup);
             performOnReplicas(replicaRequest, globalCheckpoint, maxSeqNoOfUpdatesOrDeletes, replicationGroup);
         }
-        successfulShards.incrementAndGet();  // mark primary as successful
-        decPendingAndFinishIfNeeded();
+        primaryResult.runPostReplicationActions(new ActionListener<>() {
+
+            @Override
+            public void onResponse(Void aVoid) {
+                successfulShards.incrementAndGet();
+                try {
+                    updateCheckPoints(primary.routingEntry(), primary::localCheckpoint, primary::globalCheckpoint);
+                } finally {
+                    decPendingAndFinishIfNeeded();
+                }
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                logger.trace("[{}] op [{}] post replication actions failed for [{}]", primary.routingEntry().shardId(), opType, request);
+                // TODO: fail shard? This will otherwise have the local / global checkpoint info lagging, or possibly have replicas
+                // go out of sync with the primary
+                finishAsFailed(e);
+            }
+        });
     }
 
     private void markUnavailableShardsAsStale(ReplicaRequest replicaRequest, ReplicationGroup replicationGroup) {
@@ -176,16 +193,10 @@ private void performOnReplica(final ShardRouting shard, final ReplicaRequest rep
                 public void onResponse(ReplicaResponse response) {
                     successfulShards.incrementAndGet();
                     try {
-                        primary.updateLocalCheckpointForShard(shard.allocationId().getId(), response.localCheckpoint());
-                        primary.updateGlobalCheckpointForShard(shard.allocationId().getId(), response.globalCheckpoint());
-                    } catch (final AlreadyClosedException e) {
-                        // the index was deleted or this shard was never activated after a relocation; fall through and finish normally
-                    } catch (final Exception e) {
-                        // fail the primary but fall through and let the rest of operation processing complete
-                        final String message = String.format(Locale.ROOT, "primary failed updating local checkpoint for replica %s", shard);
-                        primary.failShard(message, e);
+                        updateCheckPoints(shard, response::localCheckpoint, response::globalCheckpoint);
+                    } finally {
+                        decPendingAndFinishIfNeeded();
                     }
-                    decPendingAndFinishIfNeeded();
                 }
 
                 @Override
@@ -211,6 +222,19 @@ public String toString() {
             });
     }
 
+    private void updateCheckPoints(ShardRouting shard, LongSupplier localCheckpointSupplier, LongSupplier globalCheckpointSupplier) {
+        try {
+            primary.updateLocalCheckpointForShard(shard.allocationId().getId(), localCheckpointSupplier.getAsLong());
+            primary.updateGlobalCheckpointForShard(shard.allocationId().getId(), globalCheckpointSupplier.getAsLong());
+        } catch (final AlreadyClosedException e) {
+            // the index was deleted or this shard was never activated after a relocation; fall through and finish normally
+        } catch (final Exception e) {
+            // fail the primary but fall through and let the rest of operation processing complete
+            final String message = String.format(Locale.ROOT, "primary failed updating local checkpoint for replica %s", shard);
+            primary.failShard(message, e);
+        }
+    }
+
     private void onNoLongerPrimary(Exception failure) {
         final Throwable cause = ExceptionsHelper.unwrapCause(failure);
         final boolean nodeIsClosing = cause instanceof NodeClosedException;
@@ -464,5 +488,11 @@ public interface PrimaryResult<RequestT extends ReplicationRequest<RequestT>> {
         @Nullable RequestT replicaRequest();
 
         void setShardInfo(ReplicationResponse.ShardInfo shardInfo);
+
+        /**
+         * Run actions to be triggered post replication
+         * @param listener calllback that is invoked after post replication actions have completed
+         * */
+        void runPostReplicationActions(ActionListener<Void> listener);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java b/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
index c72f10b35c372..5888ec3f46bf6 100644
--- a/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
+++ b/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
@@ -73,8 +73,6 @@
 import org.elasticsearch.transport.TransportException;
 import org.elasticsearch.transport.TransportRequest;
 import org.elasticsearch.transport.TransportRequestOptions;
-import org.elasticsearch.transport.TransportResponse;
-import org.elasticsearch.transport.TransportResponse.Empty;
 import org.elasticsearch.transport.TransportResponseHandler;
 import org.elasticsearch.transport.TransportService;
 
@@ -346,17 +344,12 @@ public void handleException(TransportException exp) {
                 } else {
                     setPhase(replicationTask, "primary");
 
-                    final ActionListener<Response> referenceClosingListener = ActionListener.wrap(response -> {
-                        primaryShardReference.close(); // release shard operation lock before responding to caller
-                        setPhase(replicationTask, "finished");
-                        onCompletionListener.onResponse(response);
-                    }, e -> handleException(primaryShardReference, e));
+                    final ActionListener<Response> responseListener = ActionListener.wrap(response -> {
+                        adaptResponse(response, primaryShardReference.indexShard);
 
-                    final ActionListener<Response> globalCheckpointSyncingListener = ActionListener.wrap(response -> {
                         if (syncGlobalCheckpointAfterOperation) {
-                            final IndexShard shard = primaryShardReference.indexShard;
                             try {
-                                shard.maybeSyncGlobalCheckpoint("post-operation");
+                                primaryShardReference.indexShard.maybeSyncGlobalCheckpoint("post-operation");
                             } catch (final Exception e) {
                                 // only log non-closed exceptions
                                 if (ExceptionsHelper.unwrap(
@@ -364,15 +357,19 @@ public void handleException(TransportException exp) {
                                     // intentionally swallow, a missed global checkpoint sync should not fail this operation
                                     logger.info(
                                         new ParameterizedMessage(
-                                            "{} failed to execute post-operation global checkpoint sync", shard.shardId()), e);
+                                            "{} failed to execute post-operation global checkpoint sync",
+                                            primaryShardReference.indexShard.shardId()), e);
                                 }
                             }
                         }
-                        referenceClosingListener.onResponse(response);
-                    }, referenceClosingListener::onFailure);
+
+                        primaryShardReference.close(); // release shard operation lock before responding to caller
+                        setPhase(replicationTask, "finished");
+                        onCompletionListener.onResponse(response);
+                    }, e -> handleException(primaryShardReference, e));
 
                     new ReplicationOperation<>(primaryRequest.getRequest(), primaryShardReference,
-                        ActionListener.wrap(result -> result.respond(globalCheckpointSyncingListener), referenceClosingListener::onFailure),
+                        ActionListener.map(responseListener, result -> result.finalResponseIfSuccessful),
                         newReplicasProxy(), logger, actionName, primaryRequest.getPrimaryTerm()).execute();
                 }
             } catch (Exception e) {
@@ -393,10 +390,19 @@ public void onFailure(Exception e) {
 
     }
 
+    // allows subclasses to adapt the response
+    protected void adaptResponse(Response response, IndexShard indexShard) {
+
+    }
+
+    protected ActionListener<Response> wrapResponseActionListener(ActionListener<Response> listener, IndexShard shard) {
+        return listener;
+    }
+
     public static class PrimaryResult<ReplicaRequest extends ReplicationRequest<ReplicaRequest>,
             Response extends ReplicationResponse>
             implements ReplicationOperation.PrimaryResult<ReplicaRequest> {
-        final ReplicaRequest replicaRequest;
+        protected final ReplicaRequest replicaRequest;
         public final Response finalResponseIfSuccessful;
         public final Exception finalFailure;
 
@@ -429,11 +435,12 @@ public void setShardInfo(ReplicationResponse.ShardInfo shardInfo) {
             }
         }
 
-        public void respond(ActionListener<Response> listener) {
-            if (finalResponseIfSuccessful != null) {
-                listener.onResponse(finalResponseIfSuccessful);
-            } else {
+        @Override
+        public void runPostReplicationActions(ActionListener<Void> listener) {
+            if (finalFailure != null) {
                 listener.onFailure(finalFailure);
+            } else {
+                listener.onResponse(null);
             }
         }
     }
@@ -449,11 +456,11 @@ public ReplicaResult() {
             this(null);
         }
 
-        public void respond(ActionListener<TransportResponse.Empty> listener) {
-            if (finalFailure == null) {
-                listener.onResponse(TransportResponse.Empty.INSTANCE);
-            } else {
+        public void runPostReplicaActions(ActionListener<Void> listener) {
+            if (finalFailure != null) {
                 listener.onFailure(finalFailure);
+            } else {
+                listener.onResponse(null);
             }
         }
     }
@@ -503,10 +510,23 @@ public void onResponse(Releasable releasable) {
             try {
                 assert replica.getActiveOperationsCount() != 0 : "must perform shard operation under a permit";
                 final ReplicaResult replicaResult = shardOperationOnReplica(replicaRequest.getRequest(), replica);
-                releasable.close(); // release shard operation lock before responding to caller
-                final TransportReplicationAction.ReplicaResponse response =
-                        new ReplicaResponse(replica.getLocalCheckpoint(), replica.getLastSyncedGlobalCheckpoint());
-                replicaResult.respond(new ResponseListener(response));
+                replicaResult.runPostReplicaActions(
+                    ActionListener.wrap(r -> {
+                        final TransportReplicationAction.ReplicaResponse response =
+                            new ReplicaResponse(replica.getLocalCheckpoint(), replica.getLastSyncedGlobalCheckpoint());
+                        releasable.close(); // release shard operation lock before responding to caller
+                        if (logger.isTraceEnabled()) {
+                            logger.trace("action [{}] completed on shard [{}] for request [{}]", transportReplicaAction,
+                                replicaRequest.getRequest().shardId(),
+                                replicaRequest.getRequest());
+                        }
+                        setPhase(task, "finished");
+                        onCompletionListener.onResponse(response);
+                    }, e -> {
+                        Releasables.closeWhileHandlingException(releasable); // release shard operation lock before responding to caller
+                        this.responseWithFailure(e);
+                    })
+                );
             } catch (final Exception e) {
                 Releasables.closeWhileHandlingException(releasable); // release shard operation lock before responding to caller
                 AsyncReplicaAction.this.onFailure(e);
@@ -564,33 +584,6 @@ protected void doRun() throws Exception {
             acquireReplicaOperationPermit(replica, replicaRequest.getRequest(), this, replicaRequest.getPrimaryTerm(),
                 replicaRequest.getGlobalCheckpoint(), replicaRequest.getMaxSeqNoOfUpdatesOrDeletes());
         }
-
-        /**
-         * Listens for the response on the replica and sends the response back to the primary.
-         */
-        private class ResponseListener implements ActionListener<TransportResponse.Empty> {
-            private final ReplicaResponse replicaResponse;
-
-            ResponseListener(ReplicaResponse replicaResponse) {
-                this.replicaResponse = replicaResponse;
-            }
-
-            @Override
-            public void onResponse(Empty response) {
-                if (logger.isTraceEnabled()) {
-                    logger.trace("action [{}] completed on shard [{}] for request [{}]", transportReplicaAction,
-                        replicaRequest.getRequest().shardId(),
-                        replicaRequest.getRequest());
-                }
-                setPhase(task, "finished");
-                onCompletionListener.onResponse(replicaResponse);
-            }
-
-            @Override
-            public void onFailure(Exception e) {
-                responseWithFailure(e);
-            }
-        }
     }
 
     private IndexShard getIndexShard(final ShardId shardId) {
diff --git a/server/src/main/java/org/elasticsearch/action/support/replication/TransportWriteAction.java b/server/src/main/java/org/elasticsearch/action/support/replication/TransportWriteAction.java
index 104d3517815c0..07f8e96b4e796 100644
--- a/server/src/main/java/org/elasticsearch/action/support/replication/TransportWriteAction.java
+++ b/server/src/main/java/org/elasticsearch/action/support/replication/TransportWriteAction.java
@@ -41,7 +41,6 @@
 import org.elasticsearch.index.translog.Translog.Location;
 import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.threadpool.ThreadPool;
-import org.elasticsearch.transport.TransportResponse;
 import org.elasticsearch.transport.TransportService;
 
 import java.util.concurrent.atomic.AtomicBoolean;
@@ -124,12 +123,10 @@ protected abstract WriteReplicaResult<ReplicaRequest> shardOperationOnReplica(
      * NOTE: public for testing
      */
     public static class WritePrimaryResult<ReplicaRequest extends ReplicatedWriteRequest<ReplicaRequest>,
-            Response extends ReplicationResponse & WriteResponse> extends PrimaryResult<ReplicaRequest, Response>
-            implements RespondingWriteResult {
-        boolean finishedAsyncActions;
+            Response extends ReplicationResponse & WriteResponse> extends PrimaryResult<ReplicaRequest, Response> {
         public final Location location;
         public final IndexShard primary;
-        ActionListener<Response> listener = null;
+        private final Logger logger;
 
         public WritePrimaryResult(ReplicaRequest request, @Nullable Response finalResponse,
                                   @Nullable Location location, @Nullable Exception operationFailure,
@@ -137,104 +134,73 @@ public WritePrimaryResult(ReplicaRequest request, @Nullable Response finalRespon
             super(request, finalResponse, operationFailure);
             this.location = location;
             this.primary = primary;
+            this.logger = logger;
             assert location == null || operationFailure == null
                     : "expected either failure to be null or translog location to be null, " +
                     "but found: [" + location + "] translog location and [" + operationFailure + "] failure";
-            if (operationFailure != null) {
-                this.finishedAsyncActions = true;
+        }
+
+        @Override
+        public void runPostReplicationActions(ActionListener<Void> listener) {
+            if (finalFailure != null) {
+                listener.onFailure(finalFailure);
             } else {
                 /*
-                 * We call this before replication because this might wait for a refresh and that can take a while.
+                 * We call this after replication because this might wait for a refresh and that can take a while.
                  * This way we wait for the refresh in parallel on the primary and on the replica.
                  */
-                new AsyncAfterWriteAction(primary, request, location, this, logger).run();
-            }
-        }
-
-        @Override
-        public synchronized void respond(ActionListener<Response> listener) {
-            this.listener = listener;
-            respondIfPossible(null);
-        }
+                new AsyncAfterWriteAction(primary, replicaRequest, location, new RespondingWriteResult() {
+                    @Override
+                    public void onSuccess(boolean forcedRefresh) {
+                        finalResponseIfSuccessful.setForcedRefresh(forcedRefresh);
+                        listener.onResponse(null);
+                    }
 
-        /**
-         * Respond if the refresh has occurred and the listener is ready. Always called while synchronized on {@code this}.
-         */
-        protected void respondIfPossible(Exception ex) {
-            assert Thread.holdsLock(this);
-            if (finishedAsyncActions && listener != null) {
-                if (ex == null) {
-                    super.respond(listener);
-                } else {
-                    listener.onFailure(ex);
-                }
+                    @Override
+                    public void onFailure(Exception ex) {
+                        listener.onFailure(ex);
+                    }
+                }, logger).run();
             }
         }
-
-        public synchronized void onFailure(Exception exception) {
-            finishedAsyncActions = true;
-            respondIfPossible(exception);
-        }
-
-        @Override
-        public synchronized void onSuccess(boolean forcedRefresh) {
-            finalResponseIfSuccessful.setForcedRefresh(forcedRefresh);
-            finishedAsyncActions = true;
-            respondIfPossible(null);
-        }
     }
 
     /**
      * Result of taking the action on the replica.
      */
-    public static class WriteReplicaResult<ReplicaRequest extends ReplicatedWriteRequest<ReplicaRequest>>
-            extends ReplicaResult implements RespondingWriteResult {
+    public static class WriteReplicaResult<ReplicaRequest extends ReplicatedWriteRequest<ReplicaRequest>> extends ReplicaResult {
         public final Location location;
-        boolean finishedAsyncActions;
-        private ActionListener<TransportResponse.Empty> listener;
+        private final ReplicaRequest request;
+        private final IndexShard replica;
+        private final Logger logger;
 
         public WriteReplicaResult(ReplicaRequest request, @Nullable Location location,
                                   @Nullable Exception operationFailure, IndexShard replica, Logger logger) {
             super(operationFailure);
             this.location = location;
-            if (operationFailure != null) {
-                this.finishedAsyncActions = true;
-            } else {
-                new AsyncAfterWriteAction(replica, request, location, this, logger).run();
-            }
+            this.request = request;
+            this.replica = replica;
+            this.logger = logger;
         }
 
         @Override
-        public synchronized void respond(ActionListener<TransportResponse.Empty> listener) {
-            this.listener = listener;
-            respondIfPossible(null);
-        }
+        public void runPostReplicaActions(ActionListener<Void> listener) {
+            if (finalFailure != null) {
+                listener.onFailure(finalFailure);
+            } else {
+                new AsyncAfterWriteAction(replica, request, location, new RespondingWriteResult() {
+                    @Override
+                    public void onSuccess(boolean forcedRefresh) {
+                        listener.onResponse(null);
+                    }
 
-        /**
-         * Respond if the refresh has occurred and the listener is ready. Always called while synchronized on {@code this}.
-         */
-        protected void respondIfPossible(Exception ex) {
-            assert Thread.holdsLock(this);
-            if (finishedAsyncActions && listener != null) {
-                if (ex == null) {
-                    super.respond(listener);
-                } else {
-                    listener.onFailure(ex);
-                }
+                    @Override
+                    public void onFailure(Exception ex) {
+                        listener.onFailure(ex);
+                    }
+                }, logger).run();
             }
         }
-
-        @Override
-        public synchronized void onFailure(Exception ex) {
-            finishedAsyncActions = true;
-            respondIfPossible(ex);
-        }
-
-        @Override
-        public synchronized void onSuccess(boolean forcedRefresh) {
-            finishedAsyncActions = true;
-            respondIfPossible(null);
-        }
     }
 
     @Override
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseActionTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseActionTests.java
index ba48eabadcca4..3700722a5d634 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/close/TransportVerifyShardBeforeCloseActionTests.java
@@ -348,6 +348,11 @@ public void setShardInfo(ReplicationResponse.ShardInfo shardInfo) {
             this.shardInfo.set(shardInfo);
         }
 
+        @Override
+        public void runPostReplicationActions(ActionListener<Void> listener) {
+            listener.onResponse(null);
+        }
+
         public ReplicationResponse.ShardInfo getShardInfo() {
             return shardInfo.get();
         }
diff --git a/server/src/test/java/org/elasticsearch/action/support/replication/ReplicationOperationTests.java b/server/src/test/java/org/elasticsearch/action/support/replication/ReplicationOperationTests.java
index 3038153a3d537..32051f51fce2f 100644
--- a/server/src/test/java/org/elasticsearch/action/support/replication/ReplicationOperationTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/replication/ReplicationOperationTests.java
@@ -124,6 +124,7 @@ public void testReplication() throws Exception {
         assertThat(request.processedOnReplicas, equalTo(expectedReplicas));
         assertThat(replicasProxy.failedReplicas, equalTo(simulatedFailures.keySet()));
         assertThat(replicasProxy.markedAsStaleCopies, equalTo(staleAllocationIds));
+        assertThat("post replication operations not run on primary", request.runPostReplicationActionsOnPrimary.get(), equalTo(true));
         assertTrue("listener is not marked as done", listener.isDone());
         ShardInfo shardInfo = listener.actionGet().getShardInfo();
         assertThat(shardInfo.getFailed(), equalTo(reportedFailures.size()));
@@ -437,6 +438,7 @@ private Set<ShardRouting> getExpectedReplicas(ShardId shardId, ClusterState stat
 
     public static class Request extends ReplicationRequest<Request> {
         public AtomicBoolean processedOnPrimary = new AtomicBoolean();
+        public AtomicBoolean runPostReplicationActionsOnPrimary = new AtomicBoolean();
         public Set<ShardRouting> processedOnReplicas = ConcurrentCollections.newConcurrentSet();
 
         Request(ShardId shardId) {
@@ -505,6 +507,14 @@ public void setShardInfo(ShardInfo shardInfo) {
                 this.shardInfo = shardInfo;
             }
 
+            @Override
+            public void runPostReplicationActions(ActionListener<Void> listener) {
+                if (request.runPostReplicationActionsOnPrimary.compareAndSet(false, true) == false) {
+                    fail("processed [" + request + "] twice");
+                }
+                listener.onResponse(null);
+            }
+
             public ShardInfo getShardInfo() {
                 return shardInfo;
             }
@@ -597,6 +607,7 @@ public void performOn(
                 final long maxSeqNoOfUpdatesOrDeletes,
                 final ActionListener<ReplicationOperation.ReplicaResponse> listener) {
             assertTrue("replica request processed twice on [" + replica + "]", request.processedOnReplicas.add(replica));
+            assertFalse("primary post replication actions should run after replication", request.runPostReplicationActionsOnPrimary.get());
             if (opFailures.containsKey(replica)) {
                 listener.onFailure(opFailures.get(replica));
             } else {
diff --git a/server/src/test/java/org/elasticsearch/action/support/replication/TransportWriteActionTests.java b/server/src/test/java/org/elasticsearch/action/support/replication/TransportWriteActionTests.java
index c22613b9c291f..441d532652a36 100644
--- a/server/src/test/java/org/elasticsearch/action/support/replication/TransportWriteActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/replication/TransportWriteActionTests.java
@@ -67,9 +67,6 @@
 import java.util.Collections;
 import java.util.HashSet;
 import java.util.Locale;
-import java.util.concurrent.BrokenBarrierException;
-import java.util.concurrent.CountDownLatch;
-import java.util.concurrent.CyclicBarrier;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
@@ -143,7 +140,7 @@ public void testPrimaryNoRefreshCall() throws Exception {
         testAction.shardOperationOnPrimary(request, indexShard,
             ActionTestUtils.assertNoFailureListener(result -> {
                 CapturingActionListener<TestResponse> listener = new CapturingActionListener<>();
-                result.respond(listener);
+                result.runPostReplicationActions(ActionListener.map(listener, ignore -> result.finalResponseIfSuccessful));
                 assertNotNull(listener.response);
                 assertNull(listener.failure);
                 verify(indexShard, never()).refresh(any());
@@ -158,7 +155,7 @@ public void testReplicaNoRefreshCall() throws Exception {
         TransportWriteAction.WriteReplicaResult<TestRequest> result =
                 testAction.shardOperationOnReplica(request, indexShard);
         CapturingActionListener<TransportResponse.Empty> listener = new CapturingActionListener<>();
-        result.respond(listener);
+        result.runPostReplicaActions(ActionListener.map(listener, ignore -> TransportResponse.Empty.INSTANCE));
         assertNotNull(listener.response);
         assertNull(listener.failure);
         verify(indexShard, never()).refresh(any());
@@ -172,7 +169,7 @@ public void testPrimaryImmediateRefresh() throws Exception {
         testAction.shardOperationOnPrimary(request, indexShard,
             ActionTestUtils.assertNoFailureListener(result -> {
                 CapturingActionListener<TestResponse> listener = new CapturingActionListener<>();
-                result.respond(listener);
+                result.runPostReplicationActions(ActionListener.map(listener, ignore -> result.finalResponseIfSuccessful));
                 assertNotNull(listener.response);
                 assertNull(listener.failure);
                 assertTrue(listener.response.forcedRefresh);
@@ -188,7 +185,7 @@ public void testReplicaImmediateRefresh() throws Exception {
         TransportWriteAction.WriteReplicaResult<TestRequest> result =
                 testAction.shardOperationOnReplica(request, indexShard);
         CapturingActionListener<TransportResponse.Empty> listener = new CapturingActionListener<>();
-        result.respond(listener);
+        result.runPostReplicaActions(ActionListener.map(listener, ignore -> TransportResponse.Empty.INSTANCE));
         assertNotNull(listener.response);
         assertNull(listener.failure);
         verify(indexShard).refresh("refresh_flag_index");
@@ -203,7 +200,7 @@ public void testPrimaryWaitForRefresh() throws Exception {
         testAction.shardOperationOnPrimary(request, indexShard,
             ActionTestUtils.assertNoFailureListener(result -> {
                 CapturingActionListener<TestResponse> listener = new CapturingActionListener<>();
-                result.respond(listener);
+                result.runPostReplicationActions(ActionListener.map(listener, ignore -> result.finalResponseIfSuccessful));
                 assertNull(listener.response); // Haven't really responded yet
 
                 @SuppressWarnings({"unchecked", "rawtypes"})
@@ -226,7 +223,7 @@ public void testReplicaWaitForRefresh() throws Exception {
         TestAction testAction = new TestAction();
         TransportWriteAction.WriteReplicaResult<TestRequest> result = testAction.shardOperationOnReplica(request, indexShard);
         CapturingActionListener<TransportResponse.Empty> listener = new CapturingActionListener<>();
-        result.respond(listener);
+        result.runPostReplicaActions(ActionListener.map(listener, ignore -> TransportResponse.Empty.INSTANCE));
         assertNull(listener.response); // Haven't responded yet
         @SuppressWarnings({ "unchecked", "rawtypes" })
         ArgumentCaptor<Consumer<Boolean>> refreshListener = ArgumentCaptor.forClass((Class) Consumer.class);
@@ -244,9 +241,9 @@ public void testDocumentFailureInShardOperationOnPrimary() throws Exception {
         TestRequest request = new TestRequest();
         TestAction testAction = new TestAction(true, true);
         testAction.shardOperationOnPrimary(request, indexShard,
-            ActionTestUtils.assertNoFailureListener(writePrimaryResult -> {
+            ActionTestUtils.assertNoFailureListener(result -> {
                 CapturingActionListener<TestResponse> listener = new CapturingActionListener<>();
-                writePrimaryResult.respond(listener);
+                result.runPostReplicationActions(ActionListener.map(listener, ignore -> result.finalResponseIfSuccessful));
                 assertNull(listener.response);
                 assertNotNull(listener.failure);
             }));
@@ -255,10 +252,10 @@ public void testDocumentFailureInShardOperationOnPrimary() throws Exception {
     public void testDocumentFailureInShardOperationOnReplica() throws Exception {
         TestRequest request = new TestRequest();
         TestAction testAction = new TestAction(randomBoolean(), true);
-        TransportWriteAction.WriteReplicaResult<TestRequest> writeReplicaResult =
+        TransportWriteAction.WriteReplicaResult<TestRequest> result =
                 testAction.shardOperationOnReplica(request, indexShard);
         CapturingActionListener<TransportResponse.Empty> listener = new CapturingActionListener<>();
-        writeReplicaResult.respond(listener);
+        result.runPostReplicaActions(ActionListener.map(listener, ignore -> TransportResponse.Empty.INSTANCE));
         assertNull(listener.response);
         assertNotNull(listener.failure);
     }
@@ -350,41 +347,6 @@ public void testReplicaProxy() throws InterruptedException, ExecutionException {
         }
     }
 
-    public void testConcurrentWriteReplicaResultCompletion() throws InterruptedException {
-        IndexShard replica = mock(IndexShard.class);
-        when(replica.getTranslogDurability()).thenReturn(Translog.Durability.ASYNC);
-        TestRequest request = new TestRequest();
-        request.setRefreshPolicy(RefreshPolicy.WAIT_UNTIL);
-        TransportWriteAction.WriteReplicaResult<TestRequest> replicaResult = new TransportWriteAction.WriteReplicaResult<>(
-            request, new Translog.Location(0, 0, 0), null, replica, logger);
-        CyclicBarrier barrier = new CyclicBarrier(2);
-        Runnable waitForBarrier = () -> {
-            try {
-                barrier.await();
-            } catch (InterruptedException | BrokenBarrierException e) {
-                throw new AssertionError(e);
-            }
-        };
-        CountDownLatch completionLatch = new CountDownLatch(1);
-        threadPool.generic().execute(() -> {
-            waitForBarrier.run();
-            replicaResult.respond(ActionListener.wrap(completionLatch::countDown));
-        });
-        if (randomBoolean()) {
-            threadPool.generic().execute(() -> {
-                waitForBarrier.run();
-                replicaResult.onFailure(null);
-            });
-        } else {
-            threadPool.generic().execute(() -> {
-                waitForBarrier.run();
-                replicaResult.onSuccess(false);
-            });
-        }
-
-        assertTrue(completionLatch.await(30, TimeUnit.SECONDS));
-    }
-
     private class TestAction extends TransportWriteAction<TestRequest, TestRequest, TestResponse> {
 
         private final boolean withDocumentFailureOnPrimary;
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncIT.java b/server/src/test/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncIT.java
index a714870953ae7..ad2520248a670 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncIT.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/GlobalCheckpointSyncIT.java
@@ -259,4 +259,31 @@ public void testPersistGlobalCheckpoint() throws Exception {
             }
         });
     }
+
+    public void testPersistLocalCheckpoint() {
+        internalCluster().ensureAtLeastNumDataNodes(2);
+        Settings.Builder indexSettings = Settings.builder()
+            .put(IndexService.GLOBAL_CHECKPOINT_SYNC_INTERVAL_SETTING.getKey(), "10m")
+            .put(IndexSettings.INDEX_TRANSLOG_DURABILITY_SETTING.getKey(), Translog.Durability.REQUEST)
+            .put("index.number_of_shards", 1)
+            .put("index.number_of_replicas", randomIntBetween(0, 1));
+        prepareCreate("test", indexSettings).get();
+        ensureGreen("test");
+        int numDocs = randomIntBetween(1, 20);
+        logger.info("numDocs {}", numDocs);
+        long maxSeqNo = 0;
+        for (int i = 0; i < numDocs; i++) {
+            maxSeqNo = client().prepareIndex("test").setId(Integer.toString(i)).setSource("{}", XContentType.JSON).get().getSeqNo();
+            logger.info("got {}", maxSeqNo);
+        }
+        for (IndicesService indicesService : internalCluster().getDataNodeInstances(IndicesService.class)) {
+            for (IndexService indexService : indicesService) {
+                for (IndexShard shard : indexService) {
+                    final SeqNoStats seqNoStats = shard.seqNoStats();
+                    assertThat(maxSeqNo, equalTo(seqNoStats.getMaxSeqNo()));
+                    assertThat(seqNoStats.getLocalCheckpoint(), equalTo(seqNoStats.getMaxSeqNo()));;
+                }
+            }
+        }
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncActionTests.java b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncActionTests.java
index 282170a58e3e3..faccbc7ff482f 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncActionTests.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseBackgroundSyncActionTests.java
@@ -154,7 +154,7 @@ public void testRetentionLeaseBackgroundSyncActionOnReplica() throws WriteStateE
         verify(indexShard).persistRetentionLeases();
         // the result should indicate success
         final AtomicBoolean success = new AtomicBoolean();
-        result.respond(ActionListener.wrap(r -> success.set(true), e -> fail(e.toString())));
+        result.runPostReplicaActions(ActionListener.wrap(r -> success.set(true), e -> fail(e.toString())));
         assertTrue(success.get());
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseSyncActionTests.java b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseSyncActionTests.java
index a63722d93666a..1999873464ddd 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseSyncActionTests.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseSyncActionTests.java
@@ -149,7 +149,7 @@ public void testRetentionLeaseSyncActionOnReplica() throws WriteStateException {
         verify(indexShard).persistRetentionLeases();
         // the result should indicate success
         final AtomicBoolean success = new AtomicBoolean();
-        result.respond(ActionListener.wrap(r -> success.set(true), e -> fail(e.toString())));
+        result.runPostReplicaActions(ActionListener.wrap(r -> success.set(true), e -> fail(e.toString())));
         assertTrue(success.get());
     }
 
diff --git a/test/framework/src/main/java/org/elasticsearch/index/replication/ESIndexLevelReplicationTestCase.java b/test/framework/src/main/java/org/elasticsearch/index/replication/ESIndexLevelReplicationTestCase.java
index 62f624335c864..c067c0717dcce 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/replication/ESIndexLevelReplicationTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/replication/ESIndexLevelReplicationTestCase.java
@@ -601,14 +601,23 @@ protected ReplicationAction(Request request, ActionListener<Response> listener,
         public void execute() {
             try {
                 new ReplicationOperation<>(request, new PrimaryRef(),
-                    ActionListener.wrap(result -> result.respond(listener), listener::onFailure), new ReplicasRef(), logger, opType,
-                    primaryTerm).execute();
+                    ActionListener.map(listener, result -> {
+                        adaptResponse(result.finalResponse, getPrimaryShard());
+                        return result.finalResponse;
+                    }),
+                    new ReplicasRef(), logger, opType, primaryTerm)
+                    .execute();
             } catch (Exception e) {
                 listener.onFailure(e);
             }
         }
 
-        IndexShard getPrimaryShard() {
+        // to be overridden by subclasses
+        protected void adaptResponse(Response response, IndexShard indexShard) {
+
+        }
+
+        protected IndexShard getPrimaryShard() {
             return replicationTargets.primary;
         }
 
@@ -731,8 +740,9 @@ public void setShardInfo(ReplicationResponse.ShardInfo shardInfo) {
                 finalResponse.setShardInfo(shardInfo);
             }
 
-            public void respond(ActionListener<Response> listener) {
-                listener.onResponse(finalResponse);
+            @Override
+            public void runPostReplicationActions(ActionListener<Void> listener) {
+                listener.onResponse(null);
             }
         }
 
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/bulk/TransportBulkShardOperationsAction.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/bulk/TransportBulkShardOperationsAction.java
index 8c4374fac3629..48f41ef527de1 100644
--- a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/bulk/TransportBulkShardOperationsAction.java
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/bulk/TransportBulkShardOperationsAction.java
@@ -102,7 +102,7 @@ public static Translog.Operation rewriteOperationWithPrimaryTerm(Translog.Operat
     }
 
     // public for testing purposes only
-    public static CcrWritePrimaryResult shardOperationOnPrimary(
+    public static WritePrimaryResult<BulkShardOperationsRequest, BulkShardOperationsResponse> shardOperationOnPrimary(
             final ShardId shardId,
             final String historyUUID,
             final List<Translog.Operation> sourceOperations,
@@ -154,7 +154,7 @@ public static CcrWritePrimaryResult shardOperationOnPrimary(
         }
         final BulkShardOperationsRequest replicaRequest = new BulkShardOperationsRequest(
             shardId, historyUUID, appliedOperations, maxSeqNoOfUpdatesOrDeletes);
-        return new CcrWritePrimaryResult(replicaRequest, location, primary, logger);
+        return new WritePrimaryResult<>(replicaRequest, new BulkShardOperationsResponse(), location, null, primary, logger);
     }
 
     @Override
@@ -190,26 +190,16 @@ protected BulkShardOperationsResponse newResponseInstance(StreamInput in) throws
         return new BulkShardOperationsResponse(in);
     }
 
-    /**
-     * Custom write result to include global checkpoint after ops have been replicated.
-     */
-    static final class CcrWritePrimaryResult extends WritePrimaryResult<BulkShardOperationsRequest, BulkShardOperationsResponse> {
-        CcrWritePrimaryResult(BulkShardOperationsRequest request, Translog.Location location, IndexShard primary, Logger logger) {
-            super(request, new BulkShardOperationsResponse(), location, null, primary, logger);
-        }
-
-        @Override
-        public synchronized void respond(ActionListener<BulkShardOperationsResponse> listener) {
-            final ActionListener<BulkShardOperationsResponse> wrappedListener = ActionListener.wrap(response -> {
-                final SeqNoStats seqNoStats = primary.seqNoStats();
-                // return a fresh global checkpoint after the operations have been replicated for the shard follow task
-                response.setGlobalCheckpoint(seqNoStats.getGlobalCheckpoint());
-                response.setMaxSeqNo(seqNoStats.getMaxSeqNo());
-                listener.onResponse(response);
-            }, listener::onFailure);
-            super.respond(wrappedListener);
-        }
+    @Override
+    protected void adaptResponse(BulkShardOperationsResponse response, IndexShard indexShard) {
+        adaptBulkShardOperationsResponse(response, indexShard);
+    }
 
+    public static void adaptBulkShardOperationsResponse(BulkShardOperationsResponse response, IndexShard indexShard) {
+        final SeqNoStats seqNoStats = indexShard.seqNoStats();
+        // return a fresh global checkpoint after the operations have been replicated for the shard follow task
+        response.setGlobalCheckpoint(seqNoStats.getGlobalCheckpoint());
+        response.setMaxSeqNo(seqNoStats.getMaxSeqNo());
     }
 
 }
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardFollowTaskReplicationTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardFollowTaskReplicationTests.java
index 3fdf16a67946f..aebf4129c1afb 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardFollowTaskReplicationTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardFollowTaskReplicationTests.java
@@ -18,6 +18,7 @@
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.action.support.replication.ReplicationResponse;
 import org.elasticsearch.action.support.replication.TransportWriteAction;
+import org.elasticsearch.action.support.replication.TransportWriteActionTestHelper;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.routing.RecoverySource;
@@ -67,6 +68,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.concurrent.ExecutionException;
 import java.util.concurrent.Future;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.BiConsumer;
@@ -668,26 +670,32 @@ class CcrAction extends ReplicationAction<BulkShardOperationsRequest, BulkShardO
 
         @Override
         protected void performOnPrimary(IndexShard primary, BulkShardOperationsRequest request, ActionListener<PrimaryResult> listener) {
-            ActionListener.completeWith(listener, () -> {
-                final PlainActionFuture<Releasable> permitFuture = new PlainActionFuture<>();
-                primary.acquirePrimaryOperationPermit(permitFuture, ThreadPool.Names.SAME, request);
-                final TransportWriteAction.WritePrimaryResult<BulkShardOperationsRequest, BulkShardOperationsResponse> ccrResult;
-                try (Releasable ignored = permitFuture.get()) {
-                    ccrResult = TransportBulkShardOperationsAction.shardOperationOnPrimary(primary.shardId(), request.getHistoryUUID(),
-                        request.getOperations(), request.getMaxSeqNoOfUpdatesOrDeletes(), primary, logger);
-                }
-                return new PrimaryResult(ccrResult.replicaRequest(), ccrResult.finalResponseIfSuccessful) {
-                    @Override
-                    public void respond(ActionListener<BulkShardOperationsResponse> listener) {
-                        ccrResult.respond(listener);
-                    }
-                };
-            });
+            final PlainActionFuture<Releasable> permitFuture = new PlainActionFuture<>();
+            primary.acquirePrimaryOperationPermit(permitFuture, ThreadPool.Names.SAME, request);
+            final TransportWriteAction.WritePrimaryResult<BulkShardOperationsRequest, BulkShardOperationsResponse> ccrResult;
+            try (Releasable ignored = permitFuture.get()) {
+                ccrResult = TransportBulkShardOperationsAction.shardOperationOnPrimary(primary.shardId(), request.getHistoryUUID(),
+                    request.getOperations(), request.getMaxSeqNoOfUpdatesOrDeletes(), primary, logger);
+                TransportWriteActionTestHelper.performPostWriteActions(primary, request, ccrResult.location, logger);
+            } catch (InterruptedException | ExecutionException | IOException e) {
+                throw new AssertionError(e);
+            }
+            listener.onResponse(new PrimaryResult(ccrResult.replicaRequest(), ccrResult.finalResponseIfSuccessful));
+        }
+
+        @Override
+        protected void adaptResponse(BulkShardOperationsResponse response, IndexShard indexShard) {
+            TransportBulkShardOperationsAction.adaptBulkShardOperationsResponse(response, indexShard);
         }
 
         @Override
         protected void performOnReplica(BulkShardOperationsRequest request, IndexShard replica) throws Exception {
-            TransportBulkShardOperationsAction.shardOperationOnReplica(request, replica, logger);
+            try (Releasable ignored = PlainActionFuture.get(f -> replica.acquireReplicaOperationPermit(
+                getPrimaryShard().getPendingPrimaryTerm(), getPrimaryShard().getLastKnownGlobalCheckpoint(),
+                getPrimaryShard().getMaxSeqNoOfUpdatesOrDeletes(), f, ThreadPool.Names.SAME, request))) {
+                Translog.Location location = TransportBulkShardOperationsAction.shardOperationOnReplica(request, replica, logger).location;
+                TransportWriteActionTestHelper.performPostWriteActions(replica, request, location, logger);
+            }
         }
     }
 
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
index 850efa9a74b68..b14403406dd66 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
@@ -33,7 +33,6 @@
 import static java.util.Collections.emptySet;
 import static org.elasticsearch.xpack.ccr.action.bulk.TransportBulkShardOperationsAction.rewriteOperationWithPrimaryTerm;
 import static org.hamcrest.Matchers.equalTo;
-import static org.elasticsearch.xpack.ccr.action.bulk.TransportBulkShardOperationsAction.CcrWritePrimaryResult;
 
 public class BulkShardOperationsTests extends IndexShardTestCase {
 
@@ -124,7 +123,8 @@ public void testPrimaryResultIncludeOnlyAppliedOperations() throws Exception {
         Randomness.shuffle(firstBulk);
         Randomness.shuffle(secondBulk);
         oldPrimary.advanceMaxSeqNoOfUpdatesOrDeletes(seqno);
-        final CcrWritePrimaryResult fullResult = TransportBulkShardOperationsAction.shardOperationOnPrimary(oldPrimary.shardId(),
+        final TransportWriteAction.WritePrimaryResult<BulkShardOperationsRequest, BulkShardOperationsResponse> fullResult =
+            TransportBulkShardOperationsAction.shardOperationOnPrimary(oldPrimary.shardId(),
             oldPrimary.getHistoryUUID(), firstBulk, seqno, oldPrimary, logger);
         assertThat(fullResult.replicaRequest().getOperations(),
             equalTo(firstBulk.stream().map(op -> rewriteOperationWithPrimaryTerm(op, oldPrimaryTerm)).collect(Collectors.toList())));
@@ -138,7 +138,8 @@ public void testPrimaryResultIncludeOnlyAppliedOperations() throws Exception {
         // The second bulk includes some operations from the first bulk which were processed already;
         // only a subset of these operations will be included the result but with the old primary term.
         final List<Translog.Operation> existingOps = randomSubsetOf(firstBulk);
-        final CcrWritePrimaryResult partialResult = TransportBulkShardOperationsAction.shardOperationOnPrimary(newPrimary.shardId(),
+        final TransportWriteAction.WritePrimaryResult<BulkShardOperationsRequest, BulkShardOperationsResponse> partialResult =
+            TransportBulkShardOperationsAction.shardOperationOnPrimary(newPrimary.shardId(),
             newPrimary.getHistoryUUID(), Stream.concat(secondBulk.stream(), existingOps.stream()).collect(Collectors.toList()),
             seqno, newPrimary, logger);
         final long newPrimaryTerm = newPrimary.getOperationPrimaryTerm();

From 7b22f12288f66968e37adcc191e800524a9f0d0c Mon Sep 17 00:00:00 2001
From: Alexander Reelsen <alexander@reelsen.net>
Date: Tue, 3 Dec 2019 11:47:27 +0100
Subject: [PATCH 050/686] Docs: Fix & test more grok processor documentation
 (#49447)

The documentation contained a small error, as bytes and duration was not
properly converted to a number and thus remained a string.

The documentation is now also properly tested by providing a full blown
simulate pipeline example.
---
 .../reference/ingest/processors/grok.asciidoc | 69 ++++++++++---------
 1 file changed, 37 insertions(+), 32 deletions(-)

diff --git a/docs/reference/ingest/processors/grok.asciidoc b/docs/reference/ingest/processors/grok.asciidoc
index c1f2ae9645a38..c710bffde95b3 100644
--- a/docs/reference/ingest/processors/grok.asciidoc
+++ b/docs/reference/ingest/processors/grok.asciidoc
@@ -68,53 +68,58 @@ include::common-options.asciidoc[]
 Here is an example of using the provided patterns to extract out and name structured fields from a string field in
 a document.
 
-[source,js]
---------------------------------------------------
-{
-  "message": "55.3.244.1 GET /index.html 15824 0.043"
-}
---------------------------------------------------
-// NOTCONSOLE
-
-The pattern for this could be:
-
-[source,txt]
---------------------------------------------------
-%{IP:client} %{WORD:method} %{URIPATHPARAM:request} %{NUMBER:bytes} %{NUMBER:duration}
---------------------------------------------------
-
-Here is an example pipeline for processing the above document by using Grok:
-
-[source,js]
+[source,console]
 --------------------------------------------------
+POST _ingest/pipeline/_simulate
 {
-  "description" : "...",
-  "processors": [
+  "pipeline": {
+    "description" : "...",
+    "processors": [
+      {
+        "grok": {
+          "field": "message",
+          "patterns": ["%{IP:client} %{WORD:method} %{URIPATHPARAM:request} %{NUMBER:bytes:int} %{NUMBER:duration:double}"]
+        }
+      }
+    ]
+  },
+  "docs":[
     {
-      "grok": {
-        "field": "message",
-        "patterns": ["%{IP:client} %{WORD:method} %{URIPATHPARAM:request} %{NUMBER:bytes} %{NUMBER:duration}"]
+      "_source": {
+        "message": "55.3.244.1 GET /index.html 15824 0.043"
       }
     }
   ]
 }
 --------------------------------------------------
-// NOTCONSOLE
 
 This pipeline will insert these named captures as new fields within the document, like so:
 
-[source,js]
+[source,console-result]
 --------------------------------------------------
 {
-  "message": "55.3.244.1 GET /index.html 15824 0.043",
-  "client": "55.3.244.1",
-  "method": "GET",
-  "request": "/index.html",
-  "bytes": 15824,
-  "duration": "0.043"
+  "docs": [
+    {
+      "doc": {
+        "_index": "_index",
+        "_id": "_id",
+        "_source" : {
+          "duration" : 0.043,
+          "request" : "/index.html",
+          "method" : "GET",
+          "bytes" : 15824,
+          "client" : "55.3.244.1",
+          "message" : "55.3.244.1 GET /index.html 15824 0.043"
+        },
+        "_ingest": {
+          "timestamp": "2016-11-08T19:43:03.850+0000"
+        }
+      }
+    }
+  ]
 }
 --------------------------------------------------
-// NOTCONSOLE
+// TESTRESPONSE[s/2016-11-08T19:43:03.850\+0000/$body.docs.0.doc._ingest.timestamp/]
 
 [[custom-patterns]]
 ==== Custom Patterns

From 1d75b5a7c70b3549dc5d9e2612f4a3556504c06a Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Tue, 3 Dec 2019 10:56:48 +0000
Subject: [PATCH 051/686] Migrate some of the Docker tests from old repository
 (#49079)

Reimplement a number of the tests from elastic/elasticsearch-docker.

There is also one Docker image fix here, which is that two of the provided
config files had different file permissions to the rest. I've fixed this
with another RUN chmod while building the image, and adjusted the
corresponding packaging test.
---
 distribution/docker/src/docker/Dockerfile     |   1 +
 .../src/docker/bin/docker-entrypoint.sh       |   3 +-
 qa/os/build.gradle                            |   4 +
 .../packaging/test/DockerTests.java           | 301 +++++++++++++++---
 .../elasticsearch/packaging/util/Docker.java  | 128 +++++---
 5 files changed, 334 insertions(+), 103 deletions(-)

diff --git a/distribution/docker/src/docker/Dockerfile b/distribution/docker/src/docker/Dockerfile
index 0b36b29d8e22a..3a42a3e717185 100644
--- a/distribution/docker/src/docker/Dockerfile
+++ b/distribution/docker/src/docker/Dockerfile
@@ -33,6 +33,7 @@ RUN grep ES_DISTRIBUTION_TYPE=tar /usr/share/elasticsearch/bin/elasticsearch-env
 RUN mkdir -p config data logs
 RUN chmod 0775 config data logs
 COPY config/elasticsearch.yml config/log4j2.properties config/
+RUN chmod 0660 config/elasticsearch.yml config/log4j2.properties
 
 ################################################################################
 # Build stage 1 (the actual elasticsearch image):
diff --git a/distribution/docker/src/docker/bin/docker-entrypoint.sh b/distribution/docker/src/docker/bin/docker-entrypoint.sh
index d95c451dead9d..cd418a5415ddc 100644
--- a/distribution/docker/src/docker/bin/docker-entrypoint.sh
+++ b/distribution/docker/src/docker/bin/docker-entrypoint.sh
@@ -85,8 +85,7 @@ declare -a es_opts
 while IFS='=' read -r envvar_key envvar_value
 do
   # Elasticsearch settings need to have at least two dot separated lowercase
-  # words, e.g. `cluster.name`, except for `processors` which we handle
-  # specially
+  # words, e.g. `cluster.name`
   if [[ "$envvar_key" =~ ^[a-z0-9_]+\.[a-z0-9_]+ ]]; then
     if [[ ! -z $envvar_value ]]; then
       es_opt="-E${envvar_key}=${envvar_value}"
diff --git a/qa/os/build.gradle b/qa/os/build.gradle
index 31d1bc85357f0..fc91e77606219 100644
--- a/qa/os/build.gradle
+++ b/qa/os/build.gradle
@@ -36,6 +36,10 @@ dependencies {
   compile "commons-logging:commons-logging:${versions.commonslogging}"
 
   compile project(':libs:elasticsearch-core')
+
+  testCompile "com.fasterxml.jackson.core:jackson-annotations:${versions.jackson}"
+  testCompile "com.fasterxml.jackson.core:jackson-core:${versions.jackson}"
+  testCompile "com.fasterxml.jackson.core:jackson-databind:${versions.jackson}"
 }
 
 forbiddenApisTest {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
index e75bfc8ad38df..163199d833ae1 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
@@ -19,10 +19,12 @@
 
 package org.elasticsearch.packaging.test;
 
+import com.fasterxml.jackson.databind.JsonNode;
 import org.apache.http.client.fluent.Request;
 import org.elasticsearch.packaging.util.Distribution;
 import org.elasticsearch.packaging.util.Docker.DockerShell;
 import org.elasticsearch.packaging.util.Installation;
+import org.elasticsearch.packaging.util.Platforms;
 import org.elasticsearch.packaging.util.ServerUtils;
 import org.elasticsearch.packaging.util.Shell.Result;
 import org.junit.After;
@@ -33,13 +35,20 @@
 import java.io.IOException;
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
+import java.util.Set;
+import java.util.stream.Collectors;
 
 import static java.nio.file.attribute.PosixFilePermissions.fromString;
 import static org.elasticsearch.packaging.util.Docker.assertPermissionsAndOwnership;
 import static org.elasticsearch.packaging.util.Docker.copyFromContainer;
 import static org.elasticsearch.packaging.util.Docker.ensureImageIsLoaded;
 import static org.elasticsearch.packaging.util.Docker.existsInContainer;
+import static org.elasticsearch.packaging.util.Docker.getContainerLogs;
+import static org.elasticsearch.packaging.util.Docker.getImageLabels;
+import static org.elasticsearch.packaging.util.Docker.getJson;
 import static org.elasticsearch.packaging.util.Docker.mkDirWithPrivilegeEscalation;
 import static org.elasticsearch.packaging.util.Docker.removeContainer;
 import static org.elasticsearch.packaging.util.Docker.rmDirWithPrivilegeEscalation;
@@ -54,10 +63,16 @@
 import static org.elasticsearch.packaging.util.FileUtils.getTempDir;
 import static org.elasticsearch.packaging.util.FileUtils.rm;
 import static org.elasticsearch.packaging.util.ServerUtils.makeRequest;
-import static org.hamcrest.CoreMatchers.containsString;
-import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.Matchers.arrayWithSize;
+import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.emptyString;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.greaterThanOrEqualTo;
+import static org.hamcrest.Matchers.hasKey;
+import static org.hamcrest.Matchers.hasSize;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.nullValue;
 import static org.junit.Assume.assumeTrue;
 
 public class DockerTests extends PackagingTestCase {
@@ -92,14 +107,28 @@ public void teardownTest() {
     /**
      * Checks that the Docker image can be run, and that it passes various checks.
      */
-    public void test10Install() {
+    public void test010Install() {
         verifyContainerInstallation(installation, distribution());
     }
 
+    /**
+     * Check that the /_xpack API endpoint's presence is correct for the type of distribution being tested.
+     */
+    public void test011PresenceOfXpack() throws Exception {
+        waitForElasticsearch(installation);
+        final int statusCode = Request.Get("http://localhost:9200/_xpack").execute().returnResponse().getStatusLine().getStatusCode();
+
+        if (distribution.isOSS()) {
+            assertThat(statusCode, greaterThanOrEqualTo(400));
+        } else {
+            assertThat(statusCode, equalTo(200));
+        }
+    }
+
     /**
      * Checks that no plugins are initially active.
      */
-    public void test20PluginsListWithNoPlugins() {
+    public void test020PluginsListWithNoPlugins() {
         final Installation.Executables bin = installation.executables();
         final Result r = sh.run(bin.elasticsearchPlugin + " list");
 
@@ -109,7 +138,7 @@ public void test20PluginsListWithNoPlugins() {
     /**
      * Check that a keystore can be manually created using the provided CLI tool.
      */
-    public void test40CreateKeystoreManually() throws InterruptedException {
+    public void test040CreateKeystoreManually() throws InterruptedException {
         final Installation.Executables bin = installation.executables();
 
         final Path keystorePath = installation.config("elasticsearch.keystore");
@@ -125,22 +154,10 @@ public void test40CreateKeystoreManually() throws InterruptedException {
         assertThat(r.stdout, containsString("keystore.seed"));
     }
 
-    /**
-     * Send some basic index, count and delete requests, in order to check that the installation
-     * is minimally functional.
-     */
-    public void test50BasicApiTests() throws Exception {
-        waitForElasticsearch(installation);
-
-        assertTrue(existsInContainer(installation.logs.resolve("gc.log")));
-
-        ServerUtils.runElasticsearchTests();
-    }
-
     /**
      * Check that the default keystore is automatically created
      */
-    public void test60AutoCreateKeystore() throws Exception {
+    public void test041AutoCreateKeystore() throws Exception {
         final Path keystorePath = installation.config("elasticsearch.keystore");
 
         waitForPathToExist(keystorePath);
@@ -152,10 +169,41 @@ public void test60AutoCreateKeystore() throws Exception {
         assertThat(result.stdout, containsString("keystore.seed"));
     }
 
+    /**
+     * Check that the JDK's cacerts file is a symlink to the copy provided by the operating system.
+     */
+    public void test042JavaUsesTheOsProvidedKeystore() {
+        final String path = sh.run("realpath jdk/lib/security/cacerts").stdout;
+
+        assertThat(path, equalTo("/etc/pki/ca-trust/extracted/java/cacerts"));
+    }
+
+    /**
+     * Checks that there are Amazon trusted certificates in the cacaerts keystore.
+     */
+    public void test043AmazonCaCertsAreInTheKeystore() {
+        final boolean matches = sh.run("jdk/bin/keytool -cacerts -storepass changeit -list | grep trustedCertEntry").stdout.lines()
+            .anyMatch(line -> line.contains("amazonrootca"));
+
+        assertTrue("Expected Amazon trusted cert in cacerts", matches);
+    }
+
+    /**
+     * Send some basic index, count and delete requests, in order to check that the installation
+     * is minimally functional.
+     */
+    public void test050BasicApiTests() throws Exception {
+        waitForElasticsearch(installation);
+
+        assertTrue(existsInContainer(installation.logs.resolve("gc.log")));
+
+        ServerUtils.runElasticsearchTests();
+    }
+
     /**
      * Check that the default config can be overridden using a bind mount, and that env vars are respected
      */
-    public void test70BindMountCustomPathConfAndJvmOptions() throws Exception {
+    public void test070BindMountCustomPathConfAndJvmOptions() throws Exception {
         copyFromContainer(installation.config("elasticsearch.yml"), tempDir.resolve("elasticsearch.yml"));
         copyFromContainer(installation.config("log4j2.properties"), tempDir.resolve("log4j2.properties"));
 
@@ -174,37 +222,49 @@ public void test70BindMountCustomPathConfAndJvmOptions() throws Exception {
 
         waitForElasticsearch(installation);
 
-        final String nodesResponse = makeRequest(Request.Get("http://localhost:9200/_nodes"));
-        assertThat(nodesResponse, containsString("\"heap_init_in_bytes\":536870912"));
-        assertThat(nodesResponse, containsString("\"using_compressed_ordinary_object_pointers\":\"false\""));
+        final JsonNode nodes = getJson("_nodes").get("nodes");
+        final String nodeId = nodes.fieldNames().next();
+
+        final int heapSize = nodes.at("/" + nodeId + "/jvm/mem/heap_init_in_bytes").intValue();
+        final boolean usingCompressedPointers = nodes.at("/" + nodeId + "/jvm/using_compressed_ordinary_object_pointers").asBoolean();
+
+        logger.warn(nodes.at("/" + nodeId + "/jvm/mem/heap_init_in_bytes"));
+
+        assertThat("heap_init_in_bytes", heapSize, equalTo(536870912));
+        assertThat("using_compressed_ordinary_object_pointers", usingCompressedPointers, equalTo(false));
     }
 
     /**
-     * Check that the default config can be overridden using a bind mount, and that env vars are respected
+     * Check that the default config can be overridden using a bind mount, and that env vars are respected.
      */
-    public void test71BindMountCustomPathWithDifferentUID() throws Exception {
-        final Path tempEsDataDir = tempDir.resolve("esDataDir");
-        // Make the local directory and contents accessible when bind-mounted
-        mkDirWithPrivilegeEscalation(tempEsDataDir, 1500, 0);
+    public void test071BindMountCustomPathWithDifferentUID() throws Exception {
+        Platforms.onLinux(() -> {
+            final Path tempEsDataDir = tempDir.resolve("esDataDir");
+            // Make the local directory and contents accessible when bind-mounted
+            mkDirWithPrivilegeEscalation(tempEsDataDir, 1500, 0);
 
-        // Restart the container
-        final Map<Path, Path> volumes = Map.of(tempEsDataDir.toAbsolutePath(), installation.data);
+            // Restart the container
+            final Map<Path, Path> volumes = Map.of(tempEsDataDir.toAbsolutePath(), installation.data);
 
-        runContainer(distribution(), volumes, null);
+            runContainer(distribution(), volumes, null);
 
-        waitForElasticsearch(installation);
+            waitForElasticsearch(installation);
 
-        final String nodesResponse = makeRequest(Request.Get("http://localhost:9200/_nodes"));
+            final JsonNode nodes = getJson("_nodes");
 
-        assertThat(nodesResponse, containsString("\"_nodes\":{\"total\":1,\"successful\":1,\"failed\":0}"));
-        rmDirWithPrivilegeEscalation(tempEsDataDir);
+            assertThat(nodes.at("/_nodes/total").intValue(), equalTo(1));
+            assertThat(nodes.at("/_nodes/successful").intValue(), equalTo(1));
+            assertThat(nodes.at("/_nodes/failed").intValue(), equalTo(0));
+
+            rmDirWithPrivilegeEscalation(tempEsDataDir);
+        });
     }
 
     /**
      * Check that environment variables can be populated by setting variables with the suffix "_FILE",
      * which point to files that hold the required values.
      */
-    public void test80SetEnvironmentVariablesUsingFiles() throws Exception {
+    public void test080SetEnvironmentVariablesUsingFiles() throws Exception {
         final String optionsFilename = "esJavaOpts.txt";
 
         // ES_JAVA_OPTS_FILE
@@ -231,7 +291,7 @@ public void test80SetEnvironmentVariablesUsingFiles() throws Exception {
     /**
      * Check that the elastic user's password can be configured via a file and the ELASTIC_PASSWORD_FILE environment variable.
      */
-    public void test81ConfigurePasswordThroughEnvironmentVariableFile() throws Exception {
+    public void test081ConfigurePasswordThroughEnvironmentVariableFile() throws Exception {
         // Test relies on configuring security
         assumeTrue(distribution.isDefault());
 
@@ -241,14 +301,13 @@ public void test81ConfigurePasswordThroughEnvironmentVariableFile() throws Excep
         // ELASTIC_PASSWORD_FILE
         Files.writeString(tempDir.resolve(passwordFilename), xpackPassword + "\n");
 
-        Map<String, String> envVars = Map
-            .of(
-                "ELASTIC_PASSWORD_FILE",
-                "/run/secrets/" + passwordFilename,
-                // Enable security so that we can test that the password has been used
-                "xpack.security.enabled",
-                "true"
-            );
+        Map<String, String> envVars = Map.of(
+            "ELASTIC_PASSWORD_FILE",
+            "/run/secrets/" + passwordFilename,
+            // Enable security so that we can test that the password has been used
+            "xpack.security.enabled",
+            "true"
+        );
 
         // File permissions need to be secured in order for the ES wrapper to accept
         // them for populating env var values
@@ -278,15 +337,17 @@ public void test81ConfigurePasswordThroughEnvironmentVariableFile() throws Excep
     /**
      * Check that environment variables cannot be used with _FILE environment variables.
      */
-    public void test81CannotUseEnvVarsAndFiles() throws Exception {
+    public void test081CannotUseEnvVarsAndFiles() throws Exception {
         final String optionsFilename = "esJavaOpts.txt";
 
         // ES_JAVA_OPTS_FILE
         Files.writeString(tempDir.resolve(optionsFilename), "-XX:-UseCompressedOops\n");
 
         Map<String, String> envVars = Map.of(
-            "ES_JAVA_OPTS", "-XX:+UseCompressedOops",
-            "ES_JAVA_OPTS_FILE", "/run/secrets/" + optionsFilename
+            "ES_JAVA_OPTS",
+            "-XX:+UseCompressedOops",
+            "ES_JAVA_OPTS_FILE",
+            "/run/secrets/" + optionsFilename
         );
 
         // File permissions need to be secured in order for the ES wrapper to accept
@@ -307,7 +368,7 @@ public void test81CannotUseEnvVarsAndFiles() throws Exception {
      * Check that when populating environment variables by setting variables with the suffix "_FILE",
      * the files' permissions are checked.
      */
-    public void test82EnvironmentVariablesUsingFilesHaveCorrectPermissions() throws Exception {
+    public void test082EnvironmentVariablesUsingFilesHaveCorrectPermissions() throws Exception {
         final String optionsFilename = "esJavaOpts.txt";
 
         // ES_JAVA_OPTS_FILE
@@ -333,7 +394,7 @@ public void test82EnvironmentVariablesUsingFilesHaveCorrectPermissions() throws
      * Check whether the elasticsearch-certutil tool has been shipped correctly,
      * and if present then it can execute.
      */
-    public void test90SecurityCliPackaging() {
+    public void test090SecurityCliPackaging() {
         final Installation.Executables bin = installation.executables();
 
         final Path securityCli = installation.lib.resolve("tools").resolve("security-cli");
@@ -356,7 +417,7 @@ public void test90SecurityCliPackaging() {
     /**
      * Check that the elasticsearch-shard tool is shipped in the Docker image and is executable.
      */
-    public void test91ElasticsearchShardCliPackaging() {
+    public void test091ElasticsearchShardCliPackaging() {
         final Installation.Executables bin = installation.executables();
 
         final Result result = sh.run(bin.elasticsearchShard + " -h");
@@ -366,10 +427,146 @@ public void test91ElasticsearchShardCliPackaging() {
     /**
      * Check that the elasticsearch-node tool is shipped in the Docker image and is executable.
      */
-    public void test92ElasticsearchNodeCliPackaging() {
+    public void test092ElasticsearchNodeCliPackaging() {
         final Installation.Executables bin = installation.executables();
 
         final Result result = sh.run(bin.elasticsearchNode + " -h");
-        assertThat(result.stdout, containsString("A CLI tool to do unsafe cluster and index manipulations on current node"));
+        assertThat(
+            "Failed to find expected message about the elasticsearch-node CLI tool",
+            result.stdout,
+            containsString("A CLI tool to do unsafe cluster and index manipulations on current node")
+        );
+    }
+
+    /**
+     * Check that no core dumps have been accidentally included in the Docker image.
+     */
+    public void test100NoCoreFilesInImage() {
+        assertFalse("Unexpected core dump found in Docker image", existsInContainer("/core*"));
+    }
+
+    /**
+     * Check that there are no files with a GID other than 0.
+     */
+    public void test101AllFilesAreGroupZero() {
+        final String findResults = sh.run("find . -not -gid 0").stdout;
+
+        assertThat("Found some files whose GID != 0", findResults, is(emptyString()));
+    }
+
+    /**
+     * Check that the Docker image has the expected "Label Schema" labels.
+     * @see <a href="http://label-schema.org/">Label Schema website</a>
+     */
+    public void test110OrgLabelSchemaLabels() throws Exception {
+        final Map<String, String> labels = getImageLabels(distribution);
+
+        final Map<String, String> staticLabels = new HashMap<>();
+        staticLabels.put("name", "Elasticsearch");
+        staticLabels.put("schema-version", "1.0");
+        staticLabels.put("url", "https://www.elastic.co/products/elasticsearch");
+        staticLabels.put("usage", "https://www.elastic.co/guide/en/elasticsearch/reference/index.html");
+        staticLabels.put("vcs-url", "https://github.com/elastic/elasticsearch");
+        staticLabels.put("vendor", "Elastic");
+
+        if (distribution.isOSS()) {
+            staticLabels.put("license", "Apache-2.0");
+        } else {
+            staticLabels.put("license", "Elastic-License");
+        }
+
+        // TODO: we should check the actual version value
+        final Set<String> dynamicLabels = Set.of("build-date", "vcs-ref", "version");
+
+        final String prefix = "org.label-schema";
+
+        staticLabels.forEach((suffix, value) -> {
+            String key = prefix + "." + suffix;
+            assertThat(labels, hasKey(key));
+            assertThat(labels.get(key), equalTo(value));
+        });
+
+        dynamicLabels.forEach(label -> {
+            String key = prefix + "." + label;
+            assertThat(labels, hasKey(key));
+        });
+    }
+
+    /**
+     * Check that the Docker image has the expected "Open Containers Annotations" labels.
+     * @see <a href="https://github.com/opencontainers/image-spec/blob/master/annotations.md">Open Containers Annotations</a>
+     */
+    public void test110OrgOpencontainersLabels() throws Exception {
+        final Map<String, String> labels = getImageLabels(distribution);
+
+        final Map<String, String> staticLabels = new HashMap<>();
+        staticLabels.put("title", "Elasticsearch");
+        staticLabels.put("url", "https://www.elastic.co/products/elasticsearch");
+        staticLabels.put("documentation", "https://www.elastic.co/guide/en/elasticsearch/reference/index.html");
+        staticLabels.put("source", "https://github.com/elastic/elasticsearch");
+        staticLabels.put("vendor", "Elastic");
+
+        if (distribution.isOSS()) {
+            staticLabels.put("licenses", "Apache-2.0");
+        } else {
+            staticLabels.put("licenses", "Elastic-License");
+        }
+
+        // TODO: we should check the actual version value
+        final Set<String> dynamicLabels = Set.of("created", "revision", "version");
+
+        final String prefix = "org.opencontainers.image";
+
+        staticLabels.forEach((suffix, value) -> {
+            String key = prefix + "." + suffix;
+            assertThat(labels, hasKey(key));
+            assertThat(labels.get(key), equalTo(value));
+        });
+
+        dynamicLabels.forEach(label -> {
+            String key = prefix + "." + label;
+            assertThat(labels, hasKey(key));
+        });
+    }
+
+    /**
+     * Check that the container logs contain the expected content for Elasticsearch itself.
+     */
+    public void test120DockerLogsIncludeElasticsearchLogs() throws Exception {
+        waitForElasticsearch(installation);
+        final Result containerLogs = getContainerLogs();
+
+        assertThat("Container logs don't contain abbreviated class names", containerLogs.stdout, containsString("o.e.n.Node"));
+        assertThat("Container logs don't contain INFO level messages", containerLogs.stdout, containsString("INFO"));
+    }
+
+    /**
+     * Check that the Java process running inside the container has the expect PID, UID and username.
+     */
+    public void test130JavaHasCorrectPidAndOwnership() {
+        final List<String> processes = sh.run("ps -o pid,uid,user -C java").stdout.lines().skip(1).collect(Collectors.toList());
+
+        assertThat("Expected a single java process", processes, hasSize(1));
+
+        final String[] fields = processes.get(0).trim().split("\\s+");
+
+        assertThat(fields, arrayWithSize(3));
+        assertThat("Incorrect PID", fields[0], equalTo("1"));
+        assertThat("Incorrect UID", fields[1], equalTo("1000"));
+        assertThat("Incorrect username", fields[2], equalTo("elasticsearch"));
+    }
+
+    public void test140CgroupOsStatsAreAvailable() throws Exception {
+        waitForElasticsearch(installation);
+
+        final JsonNode nodes = getJson("_nodes/stats/os").get("nodes");
+
+        final String nodeId = nodes.fieldNames().next();
+
+        final JsonNode cgroupStats = nodes.at("/" + nodeId + "/os/cgroup");
+        assertFalse("Couldn't find /nodes/{nodeId}/os/cgroup in API response", cgroupStats.isMissingNode());
+
+        assertThat("Failed to find [cpu] in node OS cgroup stats", cgroupStats.get("cpu"), not(nullValue()));
+        assertThat("Failed to find [cpuacct] in node OS cgroup stats", cgroupStats.get("cpuacct"), not(nullValue()));
     }
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
index 8d5b7ce12c72f..95e5b586627c6 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
@@ -19,15 +19,20 @@
 
 package org.elasticsearch.packaging.util;
 
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
+import org.apache.http.client.fluent.Request;
 import org.elasticsearch.common.CheckedRunnable;
 
+import java.io.IOException;
 import java.nio.file.Path;
 import java.nio.file.Paths;
 import java.nio.file.attribute.PosixFileAttributes;
 import java.nio.file.attribute.PosixFilePermission;
 import java.util.ArrayList;
+import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
@@ -40,6 +45,7 @@
 import static org.elasticsearch.packaging.util.FileMatcher.p770;
 import static org.elasticsearch.packaging.util.FileMatcher.p775;
 import static org.elasticsearch.packaging.util.FileUtils.getCurrentVersion;
+import static org.elasticsearch.packaging.util.ServerUtils.makeRequest;
 import static org.hamcrest.CoreMatchers.containsString;
 import static org.hamcrest.MatcherAssert.assertThat;
 import static org.hamcrest.Matchers.equalTo;
@@ -120,7 +126,7 @@ public static Shell.Result runContainerExpectingFailure(
 
         waitForElasticsearchToExit();
 
-        return sh.run("docker logs " + containerId);
+        return getContainerLogs();
     }
 
     private static void executeDockerRun(Distribution distribution, Map<Path, Path> volumes, Map<String, String> envVars) {
@@ -171,7 +177,7 @@ private static void waitForElasticsearchToStart() {
                 // Give the container a chance to crash out
                 Thread.sleep(1000);
 
-                psOutput = dockerShell.run("ps ax").stdout;
+                psOutput = dockerShell.run("ps -w ax").stdout;
 
                 if (psOutput.contains("/usr/share/elasticsearch/jdk/bin/java")) {
                     isElasticsearchRunning = true;
@@ -183,7 +189,7 @@ private static void waitForElasticsearchToStart() {
         } while (attempt++ < 5);
 
         if (isElasticsearchRunning == false) {
-            final Shell.Result dockerLogs = sh.run("docker logs " + containerId);
+            final Shell.Result dockerLogs = getContainerLogs();
             fail(
                 "Elasticsearch container did not start successfully.\n\nps output:\n"
                     + psOutput
@@ -217,7 +223,7 @@ private static void waitForElasticsearchToExit() {
         } while (attempt++ < 5);
 
         if (isElasticsearchRunning) {
-            final Shell.Result dockerLogs = sh.run("docker logs " + containerId);
+            final Shell.Result dockerLogs = getContainerLogs();
             fail("Elasticsearch container did exit.\n\nStdout:\n" + dockerLogs.stdout + "\n\nStderr:\n" + dockerLogs.stderr);
         }
     }
@@ -278,6 +284,13 @@ protected String[] getScriptCommand(String script) {
      * Checks whether a path exists in the Docker container.
      */
     public static boolean existsInContainer(Path path) {
+        return existsInContainer(path.toString());
+    }
+
+    /**
+     * Checks whether a path exists in the Docker container.
+     */
+    public static boolean existsInContainer(String path) {
         logger.debug("Checking whether file " + path + " exists in container");
         final Shell.Result result = dockerShell.runIgnoreExitCode("test -e " + path);
 
@@ -333,9 +346,9 @@ public static void mkDirWithPrivilegeEscalation(Path localPath, int uid, int gid
 
         final PosixFileAttributes dirAttributes = FileUtils.getPosixFileAttributes(localPath);
         final Map<String, Integer> numericPathOwnership = FileUtils.getNumericUnixPathOwnership(localPath);
-        assertEquals(localPath + " has wrong uid", numericPathOwnership.get("uid").intValue(), uid);
-        assertEquals(localPath + " has wrong gid", numericPathOwnership.get("gid").intValue(), gid);
-        assertEquals(localPath + " has wrong permissions", dirAttributes.permissions(), p770);
+        assertThat(localPath + " has wrong uid", numericPathOwnership.get("uid"), equalTo(uid));
+        assertThat(localPath + " has wrong gid", numericPathOwnership.get("gid"), equalTo(gid));
+        assertThat(localPath + " has wrong permissions", dirAttributes.permissions(), equalTo(p770));
     }
 
     /**
@@ -414,63 +427,47 @@ private static void verifyOssInstallation(Installation es) {
 
         Stream.of(es.plugins, es.modules).forEach(dir -> assertPermissionsAndOwnership(dir, p755));
 
-        // FIXME these files should all have the same permissions
-        Stream
-            .of(
-                "elasticsearch.keystore",
-                // "elasticsearch.yml",
-                "jvm.options"
-                // "log4j2.properties"
-            )
+        Stream.of("elasticsearch.keystore", "elasticsearch.yml", "jvm.options", "log4j2.properties")
             .forEach(configFile -> assertPermissionsAndOwnership(es.config(configFile), p660));
 
-        Stream
-            .of("elasticsearch.yml", "log4j2.properties")
-            .forEach(configFile -> assertPermissionsAndOwnership(es.config(configFile), p644));
-
         assertThat(dockerShell.run(es.bin("elasticsearch-keystore") + " list").stdout, containsString("keystore.seed"));
 
         Stream.of(es.bin, es.lib).forEach(dir -> assertPermissionsAndOwnership(dir, p755));
 
-        Stream
-            .of(
-                "elasticsearch",
-                "elasticsearch-cli",
-                "elasticsearch-env",
-                "elasticsearch-enve",
-                "elasticsearch-keystore",
-                "elasticsearch-node",
-                "elasticsearch-plugin",
-                "elasticsearch-shard"
-            )
-            .forEach(executable -> assertPermissionsAndOwnership(es.bin(executable), p755));
+        Stream.of(
+            "elasticsearch",
+            "elasticsearch-cli",
+            "elasticsearch-env",
+            "elasticsearch-enve",
+            "elasticsearch-keystore",
+            "elasticsearch-node",
+            "elasticsearch-plugin",
+            "elasticsearch-shard"
+        ).forEach(executable -> assertPermissionsAndOwnership(es.bin(executable), p755));
 
         Stream.of("LICENSE.txt", "NOTICE.txt", "README.textile").forEach(doc -> assertPermissionsAndOwnership(es.home.resolve(doc), p644));
     }
 
     private static void verifyDefaultInstallation(Installation es) {
-        Stream
-            .of(
-                "elasticsearch-certgen",
-                "elasticsearch-certutil",
-                "elasticsearch-croneval",
-                "elasticsearch-saml-metadata",
-                "elasticsearch-setup-passwords",
-                "elasticsearch-sql-cli",
-                "elasticsearch-syskeygen",
-                "elasticsearch-users",
-                "x-pack-env",
-                "x-pack-security-env",
-                "x-pack-watcher-env"
-            )
-            .forEach(executable -> assertPermissionsAndOwnership(es.bin(executable), p755));
+        Stream.of(
+            "elasticsearch-certgen",
+            "elasticsearch-certutil",
+            "elasticsearch-croneval",
+            "elasticsearch-saml-metadata",
+            "elasticsearch-setup-passwords",
+            "elasticsearch-sql-cli",
+            "elasticsearch-syskeygen",
+            "elasticsearch-users",
+            "x-pack-env",
+            "x-pack-security-env",
+            "x-pack-watcher-env"
+        ).forEach(executable -> assertPermissionsAndOwnership(es.bin(executable), p755));
 
         // at this time we only install the current version of archive distributions, but if that changes we'll need to pass
         // the version through here
         assertPermissionsAndOwnership(es.bin("elasticsearch-sql-cli-" + getCurrentVersion() + ".jar"), p755);
 
-        Stream
-            .of("role_mapping.yml", "roles.yml", "users", "users_roles")
+        Stream.of("role_mapping.yml", "roles.yml", "users", "users_roles")
             .forEach(configFile -> assertPermissionsAndOwnership(es.config(configFile), p660));
     }
 
@@ -483,13 +480,46 @@ public static void waitForElasticsearch(String status, String index, Installatio
         withLogging(() -> ServerUtils.waitForElasticsearch(status, index, installation, username, password));
     }
 
+    /**
+     * Runs the provided closure, and captures logging information if an exception is thrown.
+     * @param r the closure to run
+     * @throws Exception any exception encountered while running the closure are propagated.
+     */
     private static <E extends Exception> void withLogging(CheckedRunnable<E> r) throws Exception {
         try {
             r.run();
         } catch (Exception e) {
-            final Shell.Result logs = sh.run("docker logs " + containerId);
+            final Shell.Result logs = getContainerLogs();
             logger.warn("Elasticsearch container failed to start.\n\nStdout:\n" + logs.stdout + "\n\nStderr:\n" + logs.stderr);
             throw e;
         }
     }
+
+    public static JsonNode getJson(String path) throws IOException {
+        final String pluginsResponse = makeRequest(Request.Get("http://localhost:9200/" + path));
+
+        ObjectMapper mapper = new ObjectMapper();
+
+        return mapper.readTree(pluginsResponse);
+    }
+
+    public static Map<String, String> getImageLabels(Distribution distribution) throws Exception {
+        // The format below extracts the .Config.Labels value, and prints it as json. Without the json
+        // modifier, a stringified Go map is printed instead, which isn't helpful.
+        String labelsJson = sh.run("docker inspect -f '{{json .Config.Labels}}' " + distribution.flavor.name + ":test").stdout;
+
+        ObjectMapper mapper = new ObjectMapper();
+
+        final JsonNode jsonNode = mapper.readTree(labelsJson);
+
+        Map<String, String> labels = new HashMap<>();
+
+        jsonNode.fieldNames().forEachRemaining(field -> labels.put(field, jsonNode.get(field).asText()));
+
+        return labels;
+    }
+
+    public static Shell.Result getContainerLogs() {
+        return sh.run("docker logs " + containerId);
+    }
 }

From 2aa8c89ca9c59dd904d100685d4a3f8224008df3 Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Tue, 3 Dec 2019 12:41:32 +0000
Subject: [PATCH 052/686] Silence lint warnings in server project - part 2
 (#49728)

Part of #40366. Silence a number of lint warnings in the :server
project, which arise when re-enabling suppressed warnings in
server/build.gradle.
---
 .../search/grouping/CollapseTopFieldDocs.java   |  2 ++
 .../admin/indices/rollover/RolloverInfo.java    |  1 +
 .../action/explain/ExplainResponse.java         | 10 ++++++++--
 .../support/broadcast/BroadcastResponse.java    |  1 +
 .../termvectors/MultiTermVectorsRequest.java    |  1 +
 .../elasticsearch/client/node/NodeClient.java   |  2 ++
 .../elasticsearch/cluster/DiffableUtils.java    | 13 +++++++++----
 .../cluster/metadata/MetaData.java              |  1 +
 .../cluster/routing/RoutingTable.java           |  1 +
 .../common/collect/ImmutableOpenIntMap.java     |  5 +++--
 .../common/collect/ImmutableOpenMap.java        |  5 +++--
 .../common/xcontent/XContentHelper.java         | 17 ++++++++---------
 .../elasticsearch/index/mapper/TypeParsers.java |  3 ++-
 .../org/elasticsearch/plugins/SearchPlugin.java |  1 +
 .../AbstractPipelineAggregationBuilder.java     |  3 ++-
 .../search/builder/SearchSourceBuilder.java     |  4 ++++
 .../search/fetch/StoredFieldsContext.java       |  1 +
 .../search/internal/ContextIndexSearcher.java   |  1 +
 .../search/slice/SliceBuilder.java              |  1 +
 .../elasticsearch/search/suggest/Suggest.java   |  2 +-
 .../search/suggest/SuggestionSearchContext.java |  1 +
 .../transport/TransportMessageListener.java     |  1 +
 22 files changed, 55 insertions(+), 22 deletions(-)

diff --git a/server/src/main/java/org/apache/lucene/search/grouping/CollapseTopFieldDocs.java b/server/src/main/java/org/apache/lucene/search/grouping/CollapseTopFieldDocs.java
index 4dba67abdeb9a..93d9d11a63a06 100644
--- a/server/src/main/java/org/apache/lucene/search/grouping/CollapseTopFieldDocs.java
+++ b/server/src/main/java/org/apache/lucene/search/grouping/CollapseTopFieldDocs.java
@@ -103,6 +103,7 @@ static boolean tieBreakLessThan(ShardRef first, ScoreDoc firstDoc, ShardRef seco
         }
     }
 
+    @SuppressWarnings("rawtypes")
     private static class MergeSortQueue extends PriorityQueue<ShardRef> {
         // These are really FieldDoc instances:
         final ScoreDoc[][] shardHits;
@@ -137,6 +138,7 @@ private static class MergeSortQueue extends PriorityQueue<ShardRef> {
 
         // Returns true if first is < second
         @Override
+        @SuppressWarnings({"rawtypes", "unchecked"})
         public boolean lessThan(ShardRef first, ShardRef second) {
             assert first != second;
             final FieldDoc firstFD = (FieldDoc) shardHits[first.shardIndex][first.hitIndex];
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverInfo.java b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverInfo.java
index af593481e8a6d..edb8e3b16e7f4 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverInfo.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverInfo.java
@@ -62,6 +62,7 @@ public RolloverInfo(String alias, List<Condition<?>> metConditions, long time) {
         this.time = time;
     }
 
+    @SuppressWarnings("unchecked")
     public RolloverInfo(StreamInput in) throws IOException {
         this.alias = in.readString();
         this.time = in.readVLong();
diff --git a/server/src/main/java/org/elasticsearch/action/explain/ExplainResponse.java b/server/src/main/java/org/elasticsearch/action/explain/ExplainResponse.java
index 6f85ab2a5dac0..ca398554c50c0 100644
--- a/server/src/main/java/org/elasticsearch/action/explain/ExplainResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/explain/ExplainResponse.java
@@ -154,6 +154,13 @@ public void writeTo(StreamOutput out) throws IOException {
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), _INDEX);
         PARSER.declareString(ConstructingObjectParser.constructorArg(), _ID);
+        final ConstructingObjectParser<Explanation, Boolean> explanationParser = getExplanationsParser();
+        PARSER.declareObject(ConstructingObjectParser.optionalConstructorArg(), explanationParser, EXPLANATION);
+        PARSER.declareObject(ConstructingObjectParser.optionalConstructorArg(), (p, c) -> GetResult.fromXContentEmbedded(p), GET);
+    }
+
+    @SuppressWarnings("unchecked")
+    private static ConstructingObjectParser<Explanation, Boolean> getExplanationsParser() {
         final ConstructingObjectParser<Explanation, Boolean> explanationParser = new ConstructingObjectParser<>("explanation", true,
             arg -> {
                 if ((float) arg[0] > 0) {
@@ -165,8 +172,7 @@ public void writeTo(StreamOutput out) throws IOException {
         explanationParser.declareFloat(ConstructingObjectParser.constructorArg(), VALUE);
         explanationParser.declareString(ConstructingObjectParser.constructorArg(), DESCRIPTION);
         explanationParser.declareObjectArray(ConstructingObjectParser.constructorArg(), explanationParser, DETAILS);
-        PARSER.declareObject(ConstructingObjectParser.optionalConstructorArg(), explanationParser, EXPLANATION);
-        PARSER.declareObject(ConstructingObjectParser.optionalConstructorArg(), (p, c) -> GetResult.fromXContentEmbedded(p), GET);
+        return explanationParser;
     }
 
     public static ExplainResponse fromXContent(XContentParser parser, boolean exists) {
diff --git a/server/src/main/java/org/elasticsearch/action/support/broadcast/BroadcastResponse.java b/server/src/main/java/org/elasticsearch/action/support/broadcast/BroadcastResponse.java
index 9f5474c916d74..e2c8a92f0ae8a 100644
--- a/server/src/main/java/org/elasticsearch/action/support/broadcast/BroadcastResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/support/broadcast/BroadcastResponse.java
@@ -55,6 +55,7 @@ public class BroadcastResponse extends ActionResponse implements ToXContentObjec
     private int failedShards;
     private DefaultShardOperationFailedException[] shardFailures = EMPTY;
 
+    @SuppressWarnings("unchecked")
     protected static <T extends BroadcastResponse> void declareBroadcastFields(ConstructingObjectParser<T, Void> PARSER) {
         ConstructingObjectParser<BroadcastResponse, Void> shardsParser = new ConstructingObjectParser<>("_shards", true,
             arg -> new BroadcastResponse((int) arg[0], (int) arg[1], (int) arg[2], (List<DefaultShardOperationFailedException>) arg[3]));
diff --git a/server/src/main/java/org/elasticsearch/action/termvectors/MultiTermVectorsRequest.java b/server/src/main/java/org/elasticsearch/action/termvectors/MultiTermVectorsRequest.java
index 954e540e913a9..056947484a0f5 100644
--- a/server/src/main/java/org/elasticsearch/action/termvectors/MultiTermVectorsRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/termvectors/MultiTermVectorsRequest.java
@@ -165,6 +165,7 @@ public int size() {
     }
 
     @Override
+    @SuppressWarnings("unchecked")
     public MultiTermVectorsRequest realtime(boolean realtime) {
         for (TermVectorsRequest request : requests) {
             request.realtime(realtime);
diff --git a/server/src/main/java/org/elasticsearch/client/node/NodeClient.java b/server/src/main/java/org/elasticsearch/client/node/NodeClient.java
index f28beb847bfb6..40bbf81534b58 100644
--- a/server/src/main/java/org/elasticsearch/client/node/NodeClient.java
+++ b/server/src/main/java/org/elasticsearch/client/node/NodeClient.java
@@ -48,6 +48,7 @@
  */
 public class NodeClient extends AbstractClient {
 
+    @SuppressWarnings("rawtypes")
     private Map<ActionType, TransportAction> actions;
 
     private TaskManager taskManager;
@@ -63,6 +64,7 @@ public NodeClient(Settings settings, ThreadPool threadPool) {
         super(settings, threadPool);
     }
 
+    @SuppressWarnings("rawtypes")
     public void initialize(Map<ActionType, TransportAction> actions, TaskManager taskManager, Supplier<String> localNodeId,
                            RemoteClusterService remoteClusterService) {
         this.actions = actions;
diff --git a/server/src/main/java/org/elasticsearch/cluster/DiffableUtils.java b/server/src/main/java/org/elasticsearch/cluster/DiffableUtils.java
index 112856f7490d0..65f52112cf6ce 100644
--- a/server/src/main/java/org/elasticsearch/cluster/DiffableUtils.java
+++ b/server/src/main/java/org/elasticsearch/cluster/DiffableUtils.java
@@ -609,18 +609,20 @@ default boolean supportsVersion(V value, Version version) {
      * @param <V> type of map values
      */
     public abstract static class DiffableValueSerializer<K, V extends Diffable<V>> implements ValueSerializer<K, V> {
+        @SuppressWarnings("rawtypes")
         private static final DiffableValueSerializer WRITE_ONLY_INSTANCE = new DiffableValueSerializer() {
             @Override
-            public Object read(StreamInput in, Object key) throws IOException {
+            public Object read(StreamInput in, Object key) {
                 throw new UnsupportedOperationException();
             }
 
             @Override
-            public Diff<Object> readDiff(StreamInput in, Object key) throws IOException {
+            public Diff<Object> readDiff(StreamInput in, Object key) {
                 throw new UnsupportedOperationException();
             }
         };
 
+        @SuppressWarnings("unchecked")
         private static <K, V extends Diffable<V>> DiffableValueSerializer<K, V> getWriteOnlyInstance() {
             return WRITE_ONLY_INSTANCE;
         }
@@ -640,6 +642,7 @@ public void write(V value, StreamOutput out) throws IOException {
             value.writeTo(out);
         }
 
+        @Override
         public void writeDiff(Diff<V> value, StreamOutput out) throws IOException {
             value.writeTo(out);
         }
@@ -663,12 +666,12 @@ public Diff<V> diff(V value, V beforePart) {
         }
 
         @Override
-        public void writeDiff(Diff<V> value, StreamOutput out) throws IOException {
+        public void writeDiff(Diff<V> value, StreamOutput out) {
             throw new UnsupportedOperationException();
         }
 
         @Override
-        public Diff<V> readDiff(StreamInput in, K key) throws IOException {
+        public Diff<V> readDiff(StreamInput in, K key) {
             throw new UnsupportedOperationException();
         }
     }
@@ -703,9 +706,11 @@ public Diff<V> readDiff(StreamInput in, K key) throws IOException {
      *
      * @param <K> type of map key
      */
+    @SuppressWarnings("rawtypes")
     public static class StringSetValueSerializer<K> extends NonDiffableValueSerializer<K, Set<String>> {
         private static final StringSetValueSerializer INSTANCE = new StringSetValueSerializer();
 
+        @SuppressWarnings("unchecked")
         public static <K> StringSetValueSerializer<K> getInstance() {
             return INSTANCE;
         }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
index a6ad4e2d19cb7..ce67e5b72f1d1 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
@@ -642,6 +642,7 @@ public IndexGraveyard indexGraveyard() {
         return custom(IndexGraveyard.TYPE);
     }
 
+    @SuppressWarnings("unchecked")
     public <T extends Custom> T custom(String type) {
         return (T) customs.get(type);
     }
diff --git a/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java b/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
index 3a49577563929..df5e32f9f1708 100644
--- a/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
+++ b/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
@@ -410,6 +410,7 @@ public Builder(RoutingTable routingTable) {
             }
         }
 
+        @SuppressWarnings("unchecked")
         public Builder updateNodes(long version, RoutingNodes routingNodes) {
             // this is being called without pre initializing the routing table, so we must copy over the version as well
             this.version = version;
diff --git a/server/src/main/java/org/elasticsearch/common/collect/ImmutableOpenIntMap.java b/server/src/main/java/org/elasticsearch/common/collect/ImmutableOpenIntMap.java
index cb4457ce24b9b..74ee39db1f967 100644
--- a/server/src/main/java/org/elasticsearch/common/collect/ImmutableOpenIntMap.java
+++ b/server/src/main/java/org/elasticsearch/common/collect/ImmutableOpenIntMap.java
@@ -174,6 +174,7 @@ public String toString() {
     }
 
     @Override
+    @SuppressWarnings("rawtypes")
     public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
@@ -190,7 +191,7 @@ public int hashCode() {
         return map.hashCode();
     }
 
-    @SuppressWarnings("unchecked")
+    @SuppressWarnings({"rawtypes", "unchecked"})
     private static final ImmutableOpenIntMap EMPTY = new ImmutableOpenIntMap(new IntObjectHashMap());
 
     @SuppressWarnings("unchecked")
@@ -214,8 +215,8 @@ public static class Builder<VType> implements IntObjectMap<VType> {
 
         private IntObjectHashMap<VType> map;
 
+        @SuppressWarnings("unchecked")
         public Builder() {
-            //noinspection unchecked
             this(EMPTY);
         }
 
diff --git a/server/src/main/java/org/elasticsearch/common/collect/ImmutableOpenMap.java b/server/src/main/java/org/elasticsearch/common/collect/ImmutableOpenMap.java
index 85178283dfabf..5c16e66a1d953 100644
--- a/server/src/main/java/org/elasticsearch/common/collect/ImmutableOpenMap.java
+++ b/server/src/main/java/org/elasticsearch/common/collect/ImmutableOpenMap.java
@@ -176,6 +176,7 @@ public String toString() {
     }
 
     @Override
+    @SuppressWarnings("rawtypes")
     public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
@@ -192,7 +193,7 @@ public int hashCode() {
         return map.hashCode();
     }
 
-    @SuppressWarnings("unchecked")
+    @SuppressWarnings({"unchecked", "rawtypes"})
     private static final ImmutableOpenMap EMPTY = new ImmutableOpenMap(new ObjectObjectHashMap());
 
     @SuppressWarnings("unchecked")
@@ -224,8 +225,8 @@ public static <KType, VType> Builder<KType, VType> builder(ImmutableOpenMap<KTyp
     public static class Builder<KType, VType> implements ObjectObjectMap<KType, VType> {
         private ObjectObjectHashMap<KType, VType> map;
 
+        @SuppressWarnings("unchecked")
         public Builder() {
-            //noinspection unchecked
             this(EMPTY);
         }
 
diff --git a/server/src/main/java/org/elasticsearch/common/xcontent/XContentHelper.java b/server/src/main/java/org/elasticsearch/common/xcontent/XContentHelper.java
index cc3158b631660..4015be991a4b2 100644
--- a/server/src/main/java/org/elasticsearch/common/xcontent/XContentHelper.java
+++ b/server/src/main/java/org/elasticsearch/common/xcontent/XContentHelper.java
@@ -250,10 +250,9 @@ public static void mergeDefaults(Map<String, Object> content, Map<String, Object
                 if (content.get(defaultEntry.getKey()) instanceof Map && defaultEntry.getValue() instanceof Map) {
                     mergeDefaults((Map<String, Object>) content.get(defaultEntry.getKey()), (Map<String, Object>) defaultEntry.getValue());
                 } else if (content.get(defaultEntry.getKey()) instanceof List && defaultEntry.getValue() instanceof List) {
-                    List defaultList = (List) defaultEntry.getValue();
-                    List contentList = (List) content.get(defaultEntry.getKey());
+                    List<Object> defaultList = (List<Object>) defaultEntry.getValue();
+                    List<Object> contentList = (List<Object>) content.get(defaultEntry.getKey());
 
-                    List mergedList = new ArrayList();
                     if (allListValuesAreMapsOfOne(defaultList) && allListValuesAreMapsOfOne(contentList)) {
                         // all are in the form of [ {"key1" : {}}, {"key2" : {}} ], merge based on keys
                         Map<String, Map<String, Object>> processed = new LinkedHashMap<>();
@@ -272,26 +271,26 @@ public static void mergeDefaults(Map<String, Object> content, Map<String, Object
                                 processed.put(entry.getKey(), map);
                             }
                         }
-                        for (Map<String, Object> map : processed.values()) {
-                            mergedList.add(map);
-                        }
+
+                        content.put(defaultEntry.getKey(), new ArrayList<>(processed.values()));
                     } else {
                         // if both are lists, simply combine them, first the defaults, then the content
                         // just make sure not to add the same value twice
-                        mergedList.addAll(defaultList);
+                        List<Object> mergedList = new ArrayList<>(defaultList);
+
                         for (Object o : contentList) {
                             if (!mergedList.contains(o)) {
                                 mergedList.add(o);
                             }
                         }
+                        content.put(defaultEntry.getKey(), mergedList);
                     }
-                    content.put(defaultEntry.getKey(), mergedList);
                 }
             }
         }
     }
 
-    private static boolean allListValuesAreMapsOfOne(List list) {
+    private static boolean allListValuesAreMapsOfOne(List<Object> list) {
         for (Object o : list) {
             if (!(o instanceof Map)) {
                 return false;
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/TypeParsers.java b/server/src/main/java/org/elasticsearch/index/mapper/TypeParsers.java
index 0e4f0510b0614..cabadedcd7f20 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/TypeParsers.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/TypeParsers.java
@@ -152,6 +152,7 @@ public static void parseNorms(FieldMapper.Builder builder, String fieldName, Obj
      * Parse text field attributes. In addition to {@link #parseField common attributes}
      * this will parse analysis and term-vectors related settings.
      */
+    @SuppressWarnings("unchecked")
     public static void parseTextField(FieldMapper.Builder builder, String name, Map<String, Object> fieldNode,
                                       Mapper.TypeParser.ParserContext parserContext) {
         parseField(builder, name, fieldNode, parserContext);
@@ -217,7 +218,7 @@ public static void parseField(FieldMapper.Builder builder, String name, Map<Stri
         }
     }
 
-    @SuppressWarnings("unchecked")
+    @SuppressWarnings({"rawtypes", "unchecked"})
     public static boolean parseMultiField(FieldMapper.Builder builder, String name, Mapper.TypeParser.ParserContext parserContext,
                                           String propName, Object propNode) {
         if (propName.equals("fields")) {
diff --git a/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java b/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
index c1152cf015b12..9cd3f391a2bd5 100644
--- a/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
+++ b/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
@@ -194,6 +194,7 @@ private void setSuggestionReader(Writeable.Reader<? extends Suggest.Suggestion<?
         /**
          * Returns the reader used to read the {@link Suggest.Suggestion} generated by this suggester
          */
+        @SuppressWarnings("rawtypes")
         public Writeable.Reader<? extends Suggest.Suggestion> getSuggestionReader() {
             return this.suggestionReader;
         }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/AbstractPipelineAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/AbstractPipelineAggregationBuilder.java
index fa2f8c8090bcd..35eab881bb643 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/AbstractPipelineAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/AbstractPipelineAggregationBuilder.java
@@ -105,7 +105,7 @@ public final PipelineAggregator create() {
     public void doValidate(AggregatorFactory parent, Collection<AggregationBuilder> factories,
             Collection<PipelineAggregationBuilder> pipelineAggregatorFactories) {
     }
-    
+
     /**
      * Validates pipeline aggregations that need sequentially ordered data.
      */
@@ -175,6 +175,7 @@ public int hashCode() {
     }
 
     @Override
+    @SuppressWarnings("unchecked")
     public boolean equals(Object obj) {
         if (this == obj) return true;
         if (obj == null || getClass() != obj.getClass()) return false;
diff --git a/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
index bb3dd945db95a..857bc235a40ff 100644
--- a/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
@@ -177,6 +177,7 @@ public static HighlightBuilder highlight() {
 
     private SuggestBuilder suggestBuilder;
 
+    @SuppressWarnings("rawtypes")
     private List<RescorerBuilder> rescoreBuilders;
 
     private List<IndexBoost> indexBoosts = new ArrayList<>();
@@ -692,6 +693,7 @@ public boolean profile() {
     /**
      * Gets the bytes representing the rescore builders for this request.
      */
+    @SuppressWarnings("rawtypes")
     public List<RescorerBuilder> rescores() {
         return rescoreBuilders;
     }
@@ -921,6 +923,7 @@ public boolean isSuggestOnly() {
      * infinitely.
      */
     @Override
+    @SuppressWarnings({"unchecked", "rawtypes"})
     public SearchSourceBuilder rewrite(QueryRewriteContext context) throws IOException {
         assert (this.equals(shallowCopy(queryBuilder, postQueryBuilder, aggregations, sliceBuilder, sorts, rescoreBuilders,
             highlightBuilder)));
@@ -964,6 +967,7 @@ public SearchSourceBuilder copyWithNewSlice(SliceBuilder slice) {
      * Create a shallow copy of this source replaced {@link #queryBuilder}, {@link #postQueryBuilder}, and {@link #sliceBuilder}. Used by
      * {@link #rewrite(QueryRewriteContext)} and {@link #copyWithNewSlice(SliceBuilder)}.
      */
+    @SuppressWarnings("rawtypes")
     private SearchSourceBuilder shallowCopy(QueryBuilder queryBuilder, QueryBuilder postQueryBuilder,
                                             AggregatorFactories.Builder aggregations, SliceBuilder slice, List<SortBuilder<?>> sorts,
                                             List<RescorerBuilder> rescoreBuilders, HighlightBuilder highlightBuilder) {
diff --git a/server/src/main/java/org/elasticsearch/search/fetch/StoredFieldsContext.java b/server/src/main/java/org/elasticsearch/search/fetch/StoredFieldsContext.java
index 9ac90806aa4c7..be72cac298f86 100644
--- a/server/src/main/java/org/elasticsearch/search/fetch/StoredFieldsContext.java
+++ b/server/src/main/java/org/elasticsearch/search/fetch/StoredFieldsContext.java
@@ -64,6 +64,7 @@ public StoredFieldsContext(StoredFieldsContext other) {
         }
     }
 
+    @SuppressWarnings("unchecked")
     public StoredFieldsContext(StreamInput in) throws IOException {
         this.fetchFields = in.readBoolean();
         if (fetchFields) {
diff --git a/server/src/main/java/org/elasticsearch/search/internal/ContextIndexSearcher.java b/server/src/main/java/org/elasticsearch/search/internal/ContextIndexSearcher.java
index 85a0010fd58f9..8959280ad21a1 100644
--- a/server/src/main/java/org/elasticsearch/search/internal/ContextIndexSearcher.java
+++ b/server/src/main/java/org/elasticsearch/search/internal/ContextIndexSearcher.java
@@ -145,6 +145,7 @@ private void checkCancelled() {
         }
     }
 
+    @SuppressWarnings({"unchecked", "rawtypes"})
     public void search(List<LeafReaderContext> leaves, Weight weight, CollectorManager manager,
             QuerySearchResult result, DocValueFormat[] formats, TotalHits totalHits) throws IOException {
         final List<Collector> collectors = new ArrayList<>(leaves.size());
diff --git a/server/src/main/java/org/elasticsearch/search/slice/SliceBuilder.java b/server/src/main/java/org/elasticsearch/search/slice/SliceBuilder.java
index 21995c663b66c..fe940ff94fdff 100644
--- a/server/src/main/java/org/elasticsearch/search/slice/SliceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/slice/SliceBuilder.java
@@ -204,6 +204,7 @@ public int hashCode() {
      *
      * @param context Additional information needed to build the query
      */
+    @SuppressWarnings("rawtypes")
     public Query toFilter(ClusterService clusterService, ShardSearchRequest request, QueryShardContext context) {
         final MappedFieldType type = context.fieldMapper(field);
         if (type == null) {
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/Suggest.java b/server/src/main/java/org/elasticsearch/search/suggest/Suggest.java
index 0d7e32e83dd1f..9b8d814a7b9f5 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/Suggest.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/Suggest.java
@@ -190,7 +190,7 @@ public static List<Suggestion<? extends Entry<? extends Option>>> reduce(Map<Str
     /**
      * @return only suggestions of type <code>suggestionType</code> contained in this {@link Suggest} instance
      */
-    @SuppressWarnings("unchecked")
+    @SuppressWarnings({"rawtypes", "unchecked"})
     public <T extends Suggestion> List<T> filter(Class<T> suggestionType) {
          return suggestions.stream()
             .filter(suggestion -> suggestion.getClass() == suggestionType)
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/SuggestionSearchContext.java b/server/src/main/java/org/elasticsearch/search/suggest/SuggestionSearchContext.java
index 165f70ba3c0c6..59a39967c31a9 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/SuggestionSearchContext.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/SuggestionSearchContext.java
@@ -78,6 +78,7 @@ public void setRegex(BytesRef regex) {
             this.regex = regex;
         }
 
+        @SuppressWarnings("unchecked")
         public Suggester<SuggestionContext> getSuggester() {
             return ((Suggester<SuggestionContext>) suggester);
         }
diff --git a/server/src/main/java/org/elasticsearch/transport/TransportMessageListener.java b/server/src/main/java/org/elasticsearch/transport/TransportMessageListener.java
index 62ff3d8fa4302..c9d72a43f8690 100644
--- a/server/src/main/java/org/elasticsearch/transport/TransportMessageListener.java
+++ b/server/src/main/java/org/elasticsearch/transport/TransportMessageListener.java
@@ -64,5 +64,6 @@ default void onRequestSent(DiscoveryNode node, long requestId, String action, Tr
      * @param requestId the request id for this reponse
      * @param context the response context or null if the context was already processed ie. due to a timeout.
      */
+    @SuppressWarnings("rawtypes")
     default void onResponseReceived(long requestId, Transport.ResponseContext context) {}
 }

From cd900888d12ca22aecac1d8b673fd92b951eb230 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Tue, 3 Dec 2019 15:04:14 +0100
Subject: [PATCH 053/686] A few cleanups in evaluation tests (#49791)

---
 .../client/MachineLearningIT.java             | 54 +++++++----
 .../ml/EvaluateDataFrameResponseTests.java    | 54 +++++++----
 .../AccuracyMetricResultTests.java            | 14 ++-
 .../classification/ClassificationTests.java   |  5 +-
 ...classConfusionMatrixMetricResultTests.java |  8 +-
 .../AucRocMetricAucRocPointTests.java         |  3 +-
 .../AucRocMetricResultTests.java              |  7 +-
 ...usionMatrixMetricConfusionMatrixTests.java |  3 +-
 .../ConfusionMatrixMetricResultTests.java     |  7 +-
 .../PrecisionMetricResultTests.java           |  5 +-
 .../RecallMetricResultTests.java              |  5 +-
 .../evaluation/MockAggregations.java          | 96 +++++++++++++++++++
 .../classification/AccuracyTests.java         | 41 +++-----
 .../classification/ClassificationTests.java   |  5 +-
 .../MulticlassConfusionMatrixTests.java       | 57 ++---------
 .../regression/MeanSquaredErrorTests.java     | 17 +---
 .../evaluation/regression/RSquaredTests.java  | 55 ++++-------
 .../ConfusionMatrixTests.java                 | 27 ++----
 .../softclassification/PrecisionTests.java    | 27 ++----
 .../softclassification/RecallTests.java       | 27 ++----
 20 files changed, 276 insertions(+), 241 deletions(-)
 rename client/rest-high-level/src/test/java/org/elasticsearch/client/ml/{ => dataframe/evaluation/softclassification}/AucRocMetricAucRocPointTests.java (92%)
 rename client/rest-high-level/src/test/java/org/elasticsearch/client/ml/{ => dataframe/evaluation/softclassification}/AucRocMetricResultTests.java (88%)
 rename client/rest-high-level/src/test/java/org/elasticsearch/client/ml/{ => dataframe/evaluation/softclassification}/ConfusionMatrixMetricConfusionMatrixTests.java (92%)
 rename client/rest-high-level/src/test/java/org/elasticsearch/client/ml/{ => dataframe/evaluation/softclassification}/ConfusionMatrixMetricResultTests.java (87%)
 rename client/rest-high-level/src/test/java/org/elasticsearch/client/ml/{ => dataframe/evaluation/softclassification}/PrecisionMetricResultTests.java (91%)
 rename client/rest-high-level/src/test/java/org/elasticsearch/client/ml/{ => dataframe/evaluation/softclassification}/RecallMetricResultTests.java (91%)
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/MockAggregations.java

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index 74c7ce0a6cda0..6ed3734831aa2 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -33,9 +33,6 @@
 import org.elasticsearch.client.indices.GetIndexRequest;
 import org.elasticsearch.client.ml.CloseJobRequest;
 import org.elasticsearch.client.ml.CloseJobResponse;
-import org.elasticsearch.client.ml.DeleteTrainedModelRequest;
-import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsRequest;
-import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsResponse;
 import org.elasticsearch.client.ml.DeleteCalendarEventRequest;
 import org.elasticsearch.client.ml.DeleteCalendarJobRequest;
 import org.elasticsearch.client.ml.DeleteCalendarRequest;
@@ -48,8 +45,11 @@
 import org.elasticsearch.client.ml.DeleteJobRequest;
 import org.elasticsearch.client.ml.DeleteJobResponse;
 import org.elasticsearch.client.ml.DeleteModelSnapshotRequest;
+import org.elasticsearch.client.ml.DeleteTrainedModelRequest;
 import org.elasticsearch.client.ml.EvaluateDataFrameRequest;
 import org.elasticsearch.client.ml.EvaluateDataFrameResponse;
+import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsRequest;
+import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsResponse;
 import org.elasticsearch.client.ml.FindFileStructureRequest;
 import org.elasticsearch.client.ml.FindFileStructureResponse;
 import org.elasticsearch.client.ml.FlushJobRequest;
@@ -135,8 +135,6 @@
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.Classification;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetric;
-import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetric.ActualClass;
-import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetric.PredictedClass;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.RSquaredMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.Regression;
@@ -1822,9 +1820,12 @@ public void testEvaluateDataFrame_Classification() throws IOException {
                 accuracyResult.getActualClasses(),
                 equalTo(
                     List.of(
-                        new AccuracyMetric.ActualClass("cat", 5, 0.6),  // 3 out of 5 examples labeled as "cat" were classified correctly
-                        new AccuracyMetric.ActualClass("dog", 4, 0.75),  // 3 out of 4 examples labeled as "dog" were classified correctly
-                        new AccuracyMetric.ActualClass("ant", 1, 0.0))));  // no examples labeled as "ant" were classified correctly
+                        // 3 out of 5 examples labeled as "cat" were classified correctly
+                        new AccuracyMetric.ActualClass("cat", 5, 0.6),
+                        // 3 out of 4 examples labeled as "dog" were classified correctly
+                        new AccuracyMetric.ActualClass("dog", 4, 0.75),
+                        // no examples labeled as "ant" were classified correctly
+                        new AccuracyMetric.ActualClass("ant", 1, 0.0))));
             assertThat(accuracyResult.getOverallAccuracy(), equalTo(0.6));  // 6 out of 10 examples were classified correctly
         }
         {  // No size provided for MulticlassConfusionMatrixMetric, default used instead
@@ -1846,20 +1847,29 @@ public void testEvaluateDataFrame_Classification() throws IOException {
                 mcmResult.getConfusionMatrix(),
                 equalTo(
                     List.of(
-                        new ActualClass(
+                        new MulticlassConfusionMatrixMetric.ActualClass(
                             "ant",
                             1L,
-                            List.of(new PredictedClass("ant", 0L), new PredictedClass("cat", 1L), new PredictedClass("dog", 0L)),
+                            List.of(
+                                new MulticlassConfusionMatrixMetric.PredictedClass("ant", 0L),
+                                new MulticlassConfusionMatrixMetric.PredictedClass("cat", 1L),
+                                new MulticlassConfusionMatrixMetric.PredictedClass("dog", 0L)),
                             0L),
-                        new ActualClass(
+                        new MulticlassConfusionMatrixMetric.ActualClass(
                             "cat",
                             5L,
-                            List.of(new PredictedClass("ant", 0L), new PredictedClass("cat", 3L), new PredictedClass("dog", 1L)),
+                            List.of(
+                                new MulticlassConfusionMatrixMetric.PredictedClass("ant", 0L),
+                                new MulticlassConfusionMatrixMetric.PredictedClass("cat", 3L),
+                                new MulticlassConfusionMatrixMetric.PredictedClass("dog", 1L)),
                             1L),
-                        new ActualClass(
+                        new MulticlassConfusionMatrixMetric.ActualClass(
                             "dog",
                             4L,
-                            List.of(new PredictedClass("ant", 0L), new PredictedClass("cat", 1L), new PredictedClass("dog", 3L)),
+                            List.of(
+                                new MulticlassConfusionMatrixMetric.PredictedClass("ant", 0L),
+                                new MulticlassConfusionMatrixMetric.PredictedClass("cat", 1L),
+                                new MulticlassConfusionMatrixMetric.PredictedClass("dog", 3L)),
                             0L))));
             assertThat(mcmResult.getOtherActualClassCount(), equalTo(0L));
         }
@@ -1882,8 +1892,20 @@ public void testEvaluateDataFrame_Classification() throws IOException {
                 mcmResult.getConfusionMatrix(),
                 equalTo(
                     List.of(
-                        new ActualClass("cat", 5L, List.of(new PredictedClass("cat", 3L), new PredictedClass("dog", 1L)), 1L),
-                        new ActualClass("dog", 4L, List.of(new PredictedClass("cat", 1L), new PredictedClass("dog", 3L)), 0L)
+                        new MulticlassConfusionMatrixMetric.ActualClass(
+                            "cat",
+                            5L,
+                            List.of(
+                                new MulticlassConfusionMatrixMetric.PredictedClass("cat", 3L),
+                                new MulticlassConfusionMatrixMetric.PredictedClass("dog", 1L)),
+                            1L),
+                        new MulticlassConfusionMatrixMetric.ActualClass(
+                            "dog",
+                            4L,
+                            List.of(
+                                new MulticlassConfusionMatrixMetric.PredictedClass("cat", 1L),
+                                new MulticlassConfusionMatrixMetric.PredictedClass("dog", 3L)),
+                            0L)
                     )));
             assertThat(mcmResult.getOtherActualClassCount(), equalTo(1L));
         }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/EvaluateDataFrameResponseTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/EvaluateDataFrameResponseTests.java
index 70740a3268f10..f6b7459b1043b 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/EvaluateDataFrameResponseTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/EvaluateDataFrameResponseTests.java
@@ -20,36 +20,56 @@
 
 import org.elasticsearch.client.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetricResultTests;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.Classification;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetricResultTests;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetricResultTests;
+import org.elasticsearch.client.ml.dataframe.evaluation.regression.RSquaredMetricResultTests;
+import org.elasticsearch.client.ml.dataframe.evaluation.regression.Regression;
+import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.AucRocMetricResultTests;
+import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.BinarySoftClassification;
+import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetricResultTests;
+import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.PrecisionMetricResultTests;
+import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.RecallMetricResultTests;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.test.AbstractXContentTestCase;
 
 import java.io.IOException;
-import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.List;
 import java.util.function.Predicate;
 
 public class EvaluateDataFrameResponseTests extends AbstractXContentTestCase<EvaluateDataFrameResponse> {
 
     public static EvaluateDataFrameResponse randomResponse() {
-        List<EvaluationMetric.Result> metrics = new ArrayList<>();
-        if (randomBoolean()) {
-            metrics.add(AucRocMetricResultTests.randomResult());
+        String evaluationName = randomFrom(BinarySoftClassification.NAME, Classification.NAME, Regression.NAME);
+        List<EvaluationMetric.Result> metrics;
+        switch (evaluationName) {
+            case BinarySoftClassification.NAME:
+                metrics = randomSubsetOf(
+                    Arrays.asList(
+                        AucRocMetricResultTests.randomResult(),
+                        PrecisionMetricResultTests.randomResult(),
+                        RecallMetricResultTests.randomResult(),
+                        ConfusionMatrixMetricResultTests.randomResult()));
+                break;
+            case Regression.NAME:
+                metrics = randomSubsetOf(
+                    Arrays.asList(
+                        MeanSquaredErrorMetricResultTests.randomResult(),
+                        RSquaredMetricResultTests.randomResult()));
+                break;
+            case Classification.NAME:
+                metrics = randomSubsetOf(
+                    Arrays.asList(
+                        AccuracyMetricResultTests.randomResult(),
+                        MulticlassConfusionMatrixMetricResultTests.randomResult()));
+                break;
+            default:
+                throw new AssertionError("Please add missing \"case\" variant to the \"switch\" statement");
         }
-        if (randomBoolean()) {
-            metrics.add(PrecisionMetricResultTests.randomResult());
-        }
-        if (randomBoolean()) {
-            metrics.add(RecallMetricResultTests.randomResult());
-        }
-        if (randomBoolean()) {
-            metrics.add(ConfusionMatrixMetricResultTests.randomResult());
-        }
-        if (randomBoolean()) {
-            metrics.add(MeanSquaredErrorMetricResultTests.randomResult());
-        }
-        return new EvaluateDataFrameResponse(randomAlphaOfLength(5), metrics);
+        return new EvaluateDataFrameResponse(evaluationName, metrics);
     }
 
     @Override
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetricResultTests.java
index 4e6557b4f58bf..df48ef3123dd1 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetricResultTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetricResultTests.java
@@ -31,15 +31,14 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
-public class AccuracyMetricResultTests extends AbstractXContentTestCase<AccuracyMetric.Result> {
+public class AccuracyMetricResultTests extends AbstractXContentTestCase<Result> {
 
     @Override
     protected NamedXContentRegistry xContentRegistry() {
         return new NamedXContentRegistry(new MlEvaluationNamedXContentProvider().getNamedXContentParsers());
     }
 
-    @Override
-    protected AccuracyMetric.Result createTestInstance() {
+    public static Result randomResult() {
         int numClasses = randomIntBetween(2, 100);
         List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
         List<ActualClass> actualClasses = new ArrayList<>(numClasses);
@@ -52,8 +51,13 @@ protected AccuracyMetric.Result createTestInstance() {
     }
 
     @Override
-    protected AccuracyMetric.Result doParseInstance(XContentParser parser) throws IOException {
-        return AccuracyMetric.Result.fromXContent(parser);
+    protected Result createTestInstance() {
+        return randomResult();
+    }
+
+    @Override
+    protected Result doParseInstance(XContentParser parser) throws IOException {
+        return Result.fromXContent(parser);
     }
 
     @Override
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/ClassificationTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/ClassificationTests.java
index 491c74fc2e0ea..acb6f21cb8209 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/ClassificationTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/ClassificationTests.java
@@ -38,7 +38,10 @@ protected NamedXContentRegistry xContentRegistry() {
 
     static Classification createRandom() {
         List<EvaluationMetric> metrics =
-            randomSubsetOf(Arrays.asList(AccuracyMetricTests.createRandom(), MulticlassConfusionMatrixMetricTests.createRandom()));
+            randomSubsetOf(
+                Arrays.asList(
+                    AccuracyMetricTests.createRandom(),
+                    MulticlassConfusionMatrixMetricTests.createRandom()));
         return new Classification(randomAlphaOfLength(10), randomAlphaOfLength(10), metrics.isEmpty() ? null : metrics);
     }
 
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixMetricResultTests.java
index 55b74eb94ea21..b08b10f320301 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixMetricResultTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixMetricResultTests.java
@@ -40,8 +40,7 @@ protected NamedXContentRegistry xContentRegistry() {
         return new NamedXContentRegistry(new MlEvaluationNamedXContentProvider().getNamedXContentParsers());
     }
 
-    @Override
-    protected Result createTestInstance() {
+    public static Result randomResult() {
         int numClasses = randomIntBetween(2, 100);
         List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
         List<ActualClass> actualClasses = new ArrayList<>(numClasses);
@@ -60,6 +59,11 @@ protected Result createTestInstance() {
         return new Result(actualClasses, randomBoolean() ? randomNonNegativeLong() : null);
     }
 
+    @Override
+    protected Result createTestInstance() {
+        return randomResult();
+    }
+
     @Override
     protected Result doParseInstance(XContentParser parser) throws IOException {
         return Result.fromXContent(parser);
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/AucRocMetricAucRocPointTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/AucRocMetricAucRocPointTests.java
similarity index 92%
rename from client/rest-high-level/src/test/java/org/elasticsearch/client/ml/AucRocMetricAucRocPointTests.java
rename to client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/AucRocMetricAucRocPointTests.java
index 825adcd2060f8..93f2b25a7346f 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/AucRocMetricAucRocPointTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/AucRocMetricAucRocPointTests.java
@@ -16,9 +16,8 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-package org.elasticsearch.client.ml;
+package org.elasticsearch.client.ml.dataframe.evaluation.softclassification;
 
-import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.AucRocMetric;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.test.AbstractXContentTestCase;
 
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/AucRocMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/AucRocMetricResultTests.java
similarity index 88%
rename from client/rest-high-level/src/test/java/org/elasticsearch/client/ml/AucRocMetricResultTests.java
rename to client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/AucRocMetricResultTests.java
index 9ea7689d60f32..bd8fc8e790e81 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/AucRocMetricResultTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/AucRocMetricResultTests.java
@@ -16,9 +16,8 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-package org.elasticsearch.client.ml;
+package org.elasticsearch.client.ml.dataframe.evaluation.softclassification;
 
-import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.AucRocMetric;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.test.AbstractXContentTestCase;
 
@@ -27,11 +26,11 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
-import static org.elasticsearch.client.ml.AucRocMetricAucRocPointTests.randomPoint;
+import static org.elasticsearch.client.ml.dataframe.evaluation.softclassification.AucRocMetricAucRocPointTests.randomPoint;
 
 public class AucRocMetricResultTests extends AbstractXContentTestCase<AucRocMetric.Result> {
 
-    static AucRocMetric.Result randomResult() {
+    public static AucRocMetric.Result randomResult() {
         return new AucRocMetric.Result(
             randomDouble(),
             Stream
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/ConfusionMatrixMetricConfusionMatrixTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/ConfusionMatrixMetricConfusionMatrixTests.java
similarity index 92%
rename from client/rest-high-level/src/test/java/org/elasticsearch/client/ml/ConfusionMatrixMetricConfusionMatrixTests.java
rename to client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/ConfusionMatrixMetricConfusionMatrixTests.java
index b54bcd53fc4a1..39897112f38d8 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/ConfusionMatrixMetricConfusionMatrixTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/ConfusionMatrixMetricConfusionMatrixTests.java
@@ -16,9 +16,8 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-package org.elasticsearch.client.ml;
+package org.elasticsearch.client.ml.dataframe.evaluation.softclassification;
 
-import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetric;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.test.AbstractXContentTestCase;
 
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/ConfusionMatrixMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/ConfusionMatrixMetricResultTests.java
similarity index 87%
rename from client/rest-high-level/src/test/java/org/elasticsearch/client/ml/ConfusionMatrixMetricResultTests.java
rename to client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/ConfusionMatrixMetricResultTests.java
index c4b299a96b536..42819e077d8cc 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/ConfusionMatrixMetricResultTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/ConfusionMatrixMetricResultTests.java
@@ -16,9 +16,8 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-package org.elasticsearch.client.ml;
+package org.elasticsearch.client.ml.dataframe.evaluation.softclassification;
 
-import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetric;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.test.AbstractXContentTestCase;
 
@@ -27,11 +26,11 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
-import static org.elasticsearch.client.ml.ConfusionMatrixMetricConfusionMatrixTests.randomConfusionMatrix;
+import static org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetricConfusionMatrixTests.randomConfusionMatrix;
 
 public class ConfusionMatrixMetricResultTests extends AbstractXContentTestCase<ConfusionMatrixMetric.Result> {
 
-    static ConfusionMatrixMetric.Result randomResult() {
+    public static ConfusionMatrixMetric.Result randomResult() {
         return new ConfusionMatrixMetric.Result(
             Stream
                 .generate(() -> randomConfusionMatrix())
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PrecisionMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/PrecisionMetricResultTests.java
similarity index 91%
rename from client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PrecisionMetricResultTests.java
rename to client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/PrecisionMetricResultTests.java
index 607adacebb827..7ece003ef22e0 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PrecisionMetricResultTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/PrecisionMetricResultTests.java
@@ -16,9 +16,8 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-package org.elasticsearch.client.ml;
+package org.elasticsearch.client.ml.dataframe.evaluation.softclassification;
 
-import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.PrecisionMetric;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.test.AbstractXContentTestCase;
 
@@ -29,7 +28,7 @@
 
 public class PrecisionMetricResultTests extends AbstractXContentTestCase<PrecisionMetric.Result> {
 
-    static PrecisionMetric.Result randomResult() {
+    public static PrecisionMetric.Result randomResult() {
         return new PrecisionMetric.Result(
             Stream
                 .generate(() -> randomDouble())
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/RecallMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/RecallMetricResultTests.java
similarity index 91%
rename from client/rest-high-level/src/test/java/org/elasticsearch/client/ml/RecallMetricResultTests.java
rename to client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/RecallMetricResultTests.java
index 138875007e30d..85d9b38075e21 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/RecallMetricResultTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/RecallMetricResultTests.java
@@ -16,9 +16,8 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-package org.elasticsearch.client.ml;
+package org.elasticsearch.client.ml.dataframe.evaluation.softclassification;
 
-import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.RecallMetric;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.test.AbstractXContentTestCase;
 
@@ -29,7 +28,7 @@
 
 public class RecallMetricResultTests extends AbstractXContentTestCase<RecallMetric.Result> {
 
-    static RecallMetric.Result randomResult() {
+    public static RecallMetric.Result randomResult() {
         return new RecallMetric.Result(
             Stream
                 .generate(() -> randomDouble())
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/MockAggregations.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/MockAggregations.java
new file mode 100644
index 0000000000000..d5919930cb818
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/MockAggregations.java
@@ -0,0 +1,96 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.evaluation;
+
+import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.bucket.filter.Filter;
+import org.elasticsearch.search.aggregations.bucket.filter.Filters;
+import org.elasticsearch.search.aggregations.bucket.terms.Terms;
+import org.elasticsearch.search.aggregations.metrics.Cardinality;
+import org.elasticsearch.search.aggregations.metrics.ExtendedStats;
+import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
+
+import java.util.Collections;
+import java.util.List;
+
+import static org.mockito.Mockito.doReturn;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+public final class MockAggregations {
+
+    public static Terms mockTerms(String name) {
+        return mockTerms(name, Collections.emptyList(), 0);
+    }
+
+    public static Terms mockTerms(String name, List<Terms.Bucket> buckets, long sumOfOtherDocCounts) {
+        Terms agg = mock(Terms.class);
+        when(agg.getName()).thenReturn(name);
+        doReturn(buckets).when(agg).getBuckets();
+        when(agg.getSumOfOtherDocCounts()).thenReturn(sumOfOtherDocCounts);
+        return agg;
+    }
+
+    public static Terms.Bucket mockTermsBucket(String key, Aggregations subAggs) {
+        Terms.Bucket bucket = mock(Terms.Bucket.class);
+        when(bucket.getKeyAsString()).thenReturn(key);
+        when(bucket.getAggregations()).thenReturn(subAggs);
+        return bucket;
+    }
+
+    public static Filters mockFilters(String name) {
+        return mockFilters(name, Collections.emptyList());
+    }
+
+    public static Filters mockFilters(String name, List<Filters.Bucket> buckets) {
+        Filters agg = mock(Filters.class);
+        when(agg.getName()).thenReturn(name);
+        doReturn(buckets).when(agg).getBuckets();
+        return agg;
+    }
+
+    public static Filters.Bucket mockFiltersBucket(String key, long docCount, Aggregations subAggs) {
+        Filters.Bucket bucket = mockFiltersBucket(key, docCount);
+        when(bucket.getAggregations()).thenReturn(subAggs);
+        return bucket;
+    }
+
+    public static Filters.Bucket mockFiltersBucket(String key, long docCount) {
+        Filters.Bucket bucket = mock(Filters.Bucket.class);
+        when(bucket.getKeyAsString()).thenReturn(key);
+        when(bucket.getDocCount()).thenReturn(docCount);
+        return bucket;
+    }
+
+    public static Filter mockFilter(String name, long docCount) {
+        Filter agg = mock(Filter.class);
+        when(agg.getName()).thenReturn(name);
+        when(agg.getDocCount()).thenReturn(docCount);
+        return agg;
+    }
+
+    public static NumericMetricsAggregation.SingleValue mockSingleValue(String name, double value) {
+        NumericMetricsAggregation.SingleValue agg = mock(NumericMetricsAggregation.SingleValue.class);
+        when(agg.getName()).thenReturn(name);
+        when(agg.value()).thenReturn(value);
+        return agg;
+    }
+
+    public static Cardinality mockCardinality(String name, long value) {
+        Cardinality agg = mock(Cardinality.class);
+        when(agg.getName()).thenReturn(name);
+        when(agg.getValue()).thenReturn(value);
+        return agg;
+    }
+
+    public static ExtendedStats mockExtendedStats(String name, double variance, long count) {
+        ExtendedStats agg = mock(ExtendedStats.class);
+        when(agg.getName()).thenReturn(name);
+        when(agg.getVariance()).thenReturn(variance);
+        when(agg.getCount()).thenReturn(count);
+        return agg;
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyTests.java
index 4a784400c3b65..1809f0e735125 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyTests.java
@@ -8,17 +8,15 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.Aggregations;
-import org.elasticsearch.search.aggregations.bucket.terms.Terms;
-import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 
 import java.io.IOException;
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockSingleValue;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTerms;
 import static org.hamcrest.Matchers.equalTo;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class AccuracyTests extends AbstractSerializingTestCase<Accuracy> {
 
@@ -48,9 +46,9 @@ public static Accuracy createRandom() {
 
     public void testProcess() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createTermsAgg("classification_classes"),
-            createSingleMetricAgg("classification_overall_accuracy", 0.8123),
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+            mockTerms("classification_classes"),
+            mockSingleValue("classification_overall_accuracy", 0.8123),
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
         ));
 
         Accuracy accuracy = new Accuracy();
@@ -62,16 +60,16 @@ public void testProcess() {
     public void testProcess_GivenMissingAgg() {
         {
             Aggregations aggs = new Aggregations(Arrays.asList(
-                createTermsAgg("classification_classes"),
-                createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+                mockTerms("classification_classes"),
+                mockSingleValue("some_other_single_metric_agg", 0.2377)
             ));
             Accuracy accuracy = new Accuracy();
             expectThrows(NullPointerException.class, () -> accuracy.process(aggs));
         }
         {
             Aggregations aggs = new Aggregations(Arrays.asList(
-                createSingleMetricAgg("classification_overall_accuracy", 0.8123),
-                createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+                mockSingleValue("classification_overall_accuracy", 0.8123),
+                mockSingleValue("some_other_single_metric_agg", 0.2377)
             ));
             Accuracy accuracy = new Accuracy();
             expectThrows(NullPointerException.class, () -> accuracy.process(aggs));
@@ -81,32 +79,19 @@ public void testProcess_GivenMissingAgg() {
     public void testProcess_GivenAggOfWrongType() {
         {
             Aggregations aggs = new Aggregations(Arrays.asList(
-                createTermsAgg("classification_classes"),
-                createTermsAgg("classification_overall_accuracy")
+                mockTerms("classification_classes"),
+                mockTerms("classification_overall_accuracy")
             ));
             Accuracy accuracy = new Accuracy();
             expectThrows(ClassCastException.class, () -> accuracy.process(aggs));
         }
         {
             Aggregations aggs = new Aggregations(Arrays.asList(
-                createSingleMetricAgg("classification_classes", 1.0),
-                createSingleMetricAgg("classification_overall_accuracy", 0.8123)
+                mockSingleValue("classification_classes", 1.0),
+                mockSingleValue("classification_overall_accuracy", 0.8123)
             ));
             Accuracy accuracy = new Accuracy();
             expectThrows(ClassCastException.class, () -> accuracy.process(aggs));
         }
     }
-
-    private static NumericMetricsAggregation.SingleValue createSingleMetricAgg(String name, double value) {
-        NumericMetricsAggregation.SingleValue agg = mock(NumericMetricsAggregation.SingleValue.class);
-        when(agg.getName()).thenReturn(name);
-        when(agg.value()).thenReturn(value);
-        return agg;
-    }
-
-    private static Terms createTermsAgg(String name) {
-        Terms agg = mock(Terms.class);
-        when(agg.getName()).thenReturn(name);
-        return agg;
-    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationTests.java
index 5dfe61768f7d9..23c2effb37fe9 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationTests.java
@@ -52,7 +52,10 @@ protected NamedXContentRegistry xContentRegistry() {
 
     public static Classification createRandom() {
         List<ClassificationMetric> metrics =
-            randomSubsetOf(Arrays.asList(AccuracyTests.createRandom(), MulticlassConfusionMatrixTests.createRandom()));
+            randomSubsetOf(
+                Arrays.asList(
+                    AccuracyTests.createRandom(),
+                    MulticlassConfusionMatrixTests.createRandom()));
         return new Classification(randomAlphaOfLength(10), randomAlphaOfLength(10), metrics.isEmpty() ? null : metrics);
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
index 0b4f724549e1a..a04e47ff26e65 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
@@ -10,24 +10,23 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.Aggregations;
-import org.elasticsearch.search.aggregations.bucket.filter.Filters;
-import org.elasticsearch.search.aggregations.bucket.terms.Terms;
-import org.elasticsearch.search.aggregations.metrics.Cardinality;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.ActualClass;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.PredictedClass;
 
 import java.io.IOException;
 import java.util.List;
-import java.util.Optional;
 
+import static org.elasticsearch.test.hamcrest.OptionalMatchers.isEmpty;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockCardinality;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFilters;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFiltersBucket;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTerms;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTermsBucket;
 import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
-import static org.mockito.Mockito.doReturn;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class MulticlassConfusionMatrixTests extends AbstractSerializingTestCase<MulticlassConfusionMatrix> {
 
@@ -75,7 +74,7 @@ public void testAggs() {
         MulticlassConfusionMatrix confusionMatrix = new MulticlassConfusionMatrix();
         List<AggregationBuilder> aggs = confusionMatrix.aggs("act", "pred");
         assertThat(aggs, is(not(empty())));
-        assertThat(confusionMatrix.getResult(), equalTo(Optional.empty()));
+        assertThat(confusionMatrix.getResult(), isEmpty());
     }
 
     public void testEvaluate() {
@@ -157,46 +156,4 @@ public void testEvaluate_OtherClassesCountGreaterThanZero() {
                     new ActualClass("cat", 85, List.of(new PredictedClass("cat", 30L), new PredictedClass("dog", 40L)), 15))));
         assertThat(result.getOtherActualClassCount(), equalTo(3L));
     }
-
-    private static Terms mockTerms(String name, List<Terms.Bucket> buckets, long sumOfOtherDocCounts) {
-        Terms aggregation = mock(Terms.class);
-        when(aggregation.getName()).thenReturn(name);
-        doReturn(buckets).when(aggregation).getBuckets();
-        when(aggregation.getSumOfOtherDocCounts()).thenReturn(sumOfOtherDocCounts);
-        return aggregation;
-    }
-
-    private static Terms.Bucket mockTermsBucket(String key, Aggregations subAggs) {
-        Terms.Bucket bucket = mock(Terms.Bucket.class);
-        when(bucket.getKeyAsString()).thenReturn(key);
-        when(bucket.getAggregations()).thenReturn(subAggs);
-        return bucket;
-    }
-
-    private static Filters mockFilters(String name, List<Filters.Bucket> buckets) {
-        Filters aggregation = mock(Filters.class);
-        when(aggregation.getName()).thenReturn(name);
-        doReturn(buckets).when(aggregation).getBuckets();
-        return aggregation;
-    }
-
-    private static Filters.Bucket mockFiltersBucket(String key, long docCount, Aggregations subAggs) {
-        Filters.Bucket bucket = mockFiltersBucket(key, docCount);
-        when(bucket.getAggregations()).thenReturn(subAggs);
-        return bucket;
-    }
-
-    private static Filters.Bucket mockFiltersBucket(String key, long docCount) {
-        Filters.Bucket bucket = mock(Filters.Bucket.class);
-        when(bucket.getKeyAsString()).thenReturn(key);
-        when(bucket.getDocCount()).thenReturn(docCount);
-        return bucket;
-    }
-
-    private static Cardinality mockCardinality(String name, long value) {
-        Cardinality aggregation = mock(Cardinality.class);
-        when(aggregation.getName()).thenReturn(name);
-        when(aggregation.getValue()).thenReturn(value);
-        return aggregation;
-    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/MeanSquaredErrorTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/MeanSquaredErrorTests.java
index 2516b2fea94a5..5679655c16555 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/MeanSquaredErrorTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/MeanSquaredErrorTests.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.Aggregations;
-import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 
@@ -17,9 +16,8 @@
 import java.util.Arrays;
 import java.util.Collections;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockSingleValue;
 import static org.hamcrest.Matchers.equalTo;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class MeanSquaredErrorTests extends AbstractSerializingTestCase<MeanSquaredError> {
 
@@ -44,8 +42,8 @@ public static MeanSquaredError createRandom() {
 
     public void testEvaluate() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createSingleMetricAgg("regression_mean_squared_error", 0.8123),
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+            mockSingleValue("regression_mean_squared_error", 0.8123),
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
         ));
 
         MeanSquaredError mse = new MeanSquaredError();
@@ -58,7 +56,7 @@ public void testEvaluate() {
 
     public void testEvaluate_GivenMissingAggs() {
         Aggregations aggs = new Aggregations(Collections.singletonList(
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
         ));
 
         MeanSquaredError mse = new MeanSquaredError();
@@ -67,11 +65,4 @@ public void testEvaluate_GivenMissingAggs() {
         EvaluationMetricResult result = mse.getResult().get();
         assertThat(result, equalTo(new MeanSquaredError.Result(0.0)));
     }
-
-    private static NumericMetricsAggregation.SingleValue createSingleMetricAgg(String name, double value) {
-        NumericMetricsAggregation.SingleValue agg = mock(NumericMetricsAggregation.SingleValue.class);
-        when(agg.getName()).thenReturn(name);
-        when(agg.value()).thenReturn(value);
-        return agg;
-    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RSquaredTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RSquaredTests.java
index 8c637c9cf179a..bd31ae08e2d2d 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RSquaredTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RSquaredTests.java
@@ -9,8 +9,6 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.Aggregations;
-import org.elasticsearch.search.aggregations.metrics.ExtendedStats;
-import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 
@@ -18,9 +16,9 @@
 import java.util.Arrays;
 import java.util.Collections;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockExtendedStats;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockSingleValue;
 import static org.hamcrest.Matchers.equalTo;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class RSquaredTests extends AbstractSerializingTestCase<RSquared> {
 
@@ -45,10 +43,10 @@ public static RSquared createRandom() {
 
     public void testEvaluate() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createSingleMetricAgg("residual_sum_of_squares", 10_111),
-            createExtendedStatsAgg("extended_stats_actual", 155.23, 1000),
-            createExtendedStatsAgg("some_other_extended_stats",99.1, 10_000),
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+            mockSingleValue("residual_sum_of_squares", 10_111),
+            mockExtendedStats("extended_stats_actual", 155.23, 1000),
+            mockExtendedStats("some_other_extended_stats",99.1, 10_000),
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
         ));
 
         RSquared rSquared = new RSquared();
@@ -61,10 +59,10 @@ public void testEvaluate() {
 
     public void testEvaluateWithZeroCount() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createSingleMetricAgg("residual_sum_of_squares", 0),
-            createExtendedStatsAgg("extended_stats_actual", 0.0, 0),
-            createExtendedStatsAgg("some_other_extended_stats",99.1, 10_000),
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+            mockSingleValue("residual_sum_of_squares", 0),
+            mockExtendedStats("extended_stats_actual", 0.0, 0),
+            mockExtendedStats("some_other_extended_stats",99.1, 10_000),
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
         ));
 
         RSquared rSquared = new RSquared();
@@ -76,10 +74,10 @@ public void testEvaluateWithZeroCount() {
 
     public void testEvaluateWithSingleCountZeroVariance() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createSingleMetricAgg("residual_sum_of_squares", 1),
-            createExtendedStatsAgg("extended_stats_actual", 0.0, 1),
-            createExtendedStatsAgg("some_other_extended_stats",99.1, 10_000),
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+            mockSingleValue("residual_sum_of_squares", 1),
+            mockExtendedStats("extended_stats_actual", 0.0, 1),
+            mockExtendedStats("some_other_extended_stats",99.1, 10_000),
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
         ));
 
         RSquared rSquared = new RSquared();
@@ -91,7 +89,7 @@ public void testEvaluateWithSingleCountZeroVariance() {
 
     public void testEvaluate_GivenMissingAggs() {
         Aggregations aggs = new Aggregations(Collections.singletonList(
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377)
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
         ));
 
         RSquared rSquared = new RSquared();
@@ -103,8 +101,8 @@ public void testEvaluate_GivenMissingAggs() {
 
     public void testEvaluate_GivenMissingExtendedStatsAgg() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377),
-            createSingleMetricAgg("residual_sum_of_squares", 0.2377)
+            mockSingleValue("some_other_single_metric_agg", 0.2377),
+            mockSingleValue("residual_sum_of_squares", 0.2377)
         ));
 
         RSquared rSquared = new RSquared();
@@ -116,8 +114,8 @@ public void testEvaluate_GivenMissingExtendedStatsAgg() {
 
     public void testEvaluate_GivenMissingResidualSumOfSquaresAgg() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createSingleMetricAgg("some_other_single_metric_agg", 0.2377),
-            createExtendedStatsAgg("extended_stats_actual",100, 50)
+            mockSingleValue("some_other_single_metric_agg", 0.2377),
+            mockExtendedStats("extended_stats_actual",100, 50)
         ));
 
         RSquared rSquared = new RSquared();
@@ -126,19 +124,4 @@ public void testEvaluate_GivenMissingResidualSumOfSquaresAgg() {
         EvaluationMetricResult result = rSquared.getResult().get();
         assertThat(result, equalTo(new RSquared.Result(0.0)));
     }
-
-    private static NumericMetricsAggregation.SingleValue createSingleMetricAgg(String name, double value) {
-        NumericMetricsAggregation.SingleValue agg = mock(NumericMetricsAggregation.SingleValue.class);
-        when(agg.getName()).thenReturn(name);
-        when(agg.value()).thenReturn(value);
-        return agg;
-    }
-
-    private static ExtendedStats createExtendedStatsAgg(String name, double variance, long count) {
-        ExtendedStats agg = mock(ExtendedStats.class);
-        when(agg.getName()).thenReturn(name);
-        when(agg.getVariance()).thenReturn(variance);
-        when(agg.getCount()).thenReturn(count);
-        return agg;
-    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ConfusionMatrixTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ConfusionMatrixTests.java
index cf54131af137e..84194bd0bac09 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ConfusionMatrixTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ConfusionMatrixTests.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.Aggregations;
-import org.elasticsearch.search.aggregations.bucket.filter.Filter;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 
@@ -18,9 +17,8 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFilter;
 import static org.hamcrest.Matchers.equalTo;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class ConfusionMatrixTests extends AbstractSerializingTestCase<ConfusionMatrix> {
 
@@ -50,14 +48,14 @@ public static ConfusionMatrix createRandom() {
 
     public void testEvaluate() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createFilterAgg("confusion_matrix_at_0.25_TP", 1L),
-            createFilterAgg("confusion_matrix_at_0.25_FP", 2L),
-            createFilterAgg("confusion_matrix_at_0.25_TN", 3L),
-            createFilterAgg("confusion_matrix_at_0.25_FN", 4L),
-            createFilterAgg("confusion_matrix_at_0.5_TP", 5L),
-            createFilterAgg("confusion_matrix_at_0.5_FP", 6L),
-            createFilterAgg("confusion_matrix_at_0.5_TN", 7L),
-            createFilterAgg("confusion_matrix_at_0.5_FN", 8L)
+            mockFilter("confusion_matrix_at_0.25_TP", 1L),
+            mockFilter("confusion_matrix_at_0.25_FP", 2L),
+            mockFilter("confusion_matrix_at_0.25_TN", 3L),
+            mockFilter("confusion_matrix_at_0.25_FN", 4L),
+            mockFilter("confusion_matrix_at_0.5_TP", 5L),
+            mockFilter("confusion_matrix_at_0.5_FP", 6L),
+            mockFilter("confusion_matrix_at_0.5_TN", 7L),
+            mockFilter("confusion_matrix_at_0.5_FN", 8L)
         ));
 
         ConfusionMatrix confusionMatrix = new ConfusionMatrix(Arrays.asList(0.25, 0.5));
@@ -66,11 +64,4 @@ public void testEvaluate() {
         String expected = "{\"0.25\":{\"tp\":1,\"fp\":2,\"tn\":3,\"fn\":4},\"0.5\":{\"tp\":5,\"fp\":6,\"tn\":7,\"fn\":8}}";
         assertThat(Strings.toString(result), equalTo(expected));
     }
-
-    private static Filter createFilterAgg(String name, long docCount) {
-        Filter agg = mock(Filter.class);
-        when(agg.getName()).thenReturn(name);
-        when(agg.getDocCount()).thenReturn(docCount);
-        return agg;
-    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/PrecisionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/PrecisionTests.java
index 58f2864fd0747..faf7c9ac0e7f2 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/PrecisionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/PrecisionTests.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.Aggregations;
-import org.elasticsearch.search.aggregations.bucket.filter.Filter;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 
@@ -18,9 +17,8 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFilter;
 import static org.hamcrest.Matchers.equalTo;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class PrecisionTests extends AbstractSerializingTestCase<Precision> {
 
@@ -50,12 +48,12 @@ public static Precision createRandom() {
 
     public void testEvaluate() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createFilterAgg("precision_at_0.25_TP", 1L),
-            createFilterAgg("precision_at_0.25_FP", 4L),
-            createFilterAgg("precision_at_0.5_TP", 3L),
-            createFilterAgg("precision_at_0.5_FP", 1L),
-            createFilterAgg("precision_at_0.75_TP", 5L),
-            createFilterAgg("precision_at_0.75_FP", 0L)
+            mockFilter("precision_at_0.25_TP", 1L),
+            mockFilter("precision_at_0.25_FP", 4L),
+            mockFilter("precision_at_0.5_TP", 3L),
+            mockFilter("precision_at_0.5_FP", 1L),
+            mockFilter("precision_at_0.75_TP", 5L),
+            mockFilter("precision_at_0.75_FP", 0L)
         ));
 
         Precision precision = new Precision(Arrays.asList(0.25, 0.5, 0.75));
@@ -67,8 +65,8 @@ public void testEvaluate() {
 
     public void testEvaluate_GivenZeroTpAndFp() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createFilterAgg("precision_at_1.0_TP", 0L),
-            createFilterAgg("precision_at_1.0_FP", 0L)
+            mockFilter("precision_at_1.0_TP", 0L),
+            mockFilter("precision_at_1.0_FP", 0L)
         ));
 
         Precision precision = new Precision(Arrays.asList(1.0));
@@ -77,11 +75,4 @@ public void testEvaluate_GivenZeroTpAndFp() {
         String expected = "{\"1.0\":0.0}";
         assertThat(Strings.toString(result), equalTo(expected));
     }
-
-    private static Filter createFilterAgg(String name, long docCount) {
-        Filter agg = mock(Filter.class);
-        when(agg.getName()).thenReturn(name);
-        when(agg.getDocCount()).thenReturn(docCount);
-        return agg;
-    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/RecallTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/RecallTests.java
index 009805425cd88..343d19059551c 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/RecallTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/RecallTests.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.Aggregations;
-import org.elasticsearch.search.aggregations.bucket.filter.Filter;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 
@@ -18,9 +17,8 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFilter;
 import static org.hamcrest.Matchers.equalTo;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class RecallTests extends AbstractSerializingTestCase<Recall> {
 
@@ -50,12 +48,12 @@ public static Recall createRandom() {
 
     public void testEvaluate() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createFilterAgg("recall_at_0.25_TP", 1L),
-            createFilterAgg("recall_at_0.25_FN", 4L),
-            createFilterAgg("recall_at_0.5_TP", 3L),
-            createFilterAgg("recall_at_0.5_FN", 1L),
-            createFilterAgg("recall_at_0.75_TP", 5L),
-            createFilterAgg("recall_at_0.75_FN", 0L)
+            mockFilter("recall_at_0.25_TP", 1L),
+            mockFilter("recall_at_0.25_FN", 4L),
+            mockFilter("recall_at_0.5_TP", 3L),
+            mockFilter("recall_at_0.5_FN", 1L),
+            mockFilter("recall_at_0.75_TP", 5L),
+            mockFilter("recall_at_0.75_FN", 0L)
         ));
 
         Recall recall = new Recall(Arrays.asList(0.25, 0.5, 0.75));
@@ -67,8 +65,8 @@ public void testEvaluate() {
 
     public void testEvaluate_GivenZeroTpAndFp() {
         Aggregations aggs = new Aggregations(Arrays.asList(
-            createFilterAgg("recall_at_1.0_TP", 0L),
-            createFilterAgg("recall_at_1.0_FN", 0L)
+            mockFilter("recall_at_1.0_TP", 0L),
+            mockFilter("recall_at_1.0_FN", 0L)
         ));
 
         Recall recall = new Recall(Arrays.asList(1.0));
@@ -77,11 +75,4 @@ public void testEvaluate_GivenZeroTpAndFp() {
         String expected = "{\"1.0\":0.0}";
         assertThat(Strings.toString(result), equalTo(expected));
     }
-
-    private static Filter createFilterAgg(String name, long docCount) {
-        Filter agg = mock(Filter.class);
-        when(agg.getName()).thenReturn(name);
-        when(agg.getDocCount()).thenReturn(docCount);
-        return agg;
-    }
 }

From 3afe18226944b1a39cc6d09ffb5a51c36ef321dd Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Tue, 3 Dec 2019 09:34:03 -0700
Subject: [PATCH 054/686] Ensure remote strategy settings can be updated
 (#49772)

This is related to #49067. As part of this work a new sniff number of
node connections setting, a simple addresses setting, and a simple
number of sockets setting have been added. This commit ensures that
these settings are properly hooked up to support dynamic updates.
---
 .../transport/SimpleConnectionStrategy.java   | 17 +++++-
 .../transport/SniffConnectionStrategy.java    |  4 +-
 .../SimpleConnectionStrategyTests.java        | 54 +++++++++++++++++++
 .../SniffConnectionStrategyTests.java         | 10 +++-
 4 files changed, 82 insertions(+), 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
index 839a1d19285b7..890cdaf25387b 100644
--- a/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
@@ -32,7 +32,9 @@
 import org.elasticsearch.common.util.concurrent.CountDown;
 
 import java.util.Collections;
+import java.util.HashSet;
 import java.util.List;
+import java.util.Set;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.concurrent.atomic.AtomicLong;
 import java.util.concurrent.atomic.AtomicReference;
@@ -74,6 +76,7 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
 
     private final int maxNumConnections;
     private final AtomicLong counter = new AtomicLong(0);
+    private final List<String> configuredAddresses;
     private final List<Supplier<TransportAddress>> addresses;
     private final AtomicReference<ClusterName> remoteClusterName = new AtomicReference<>();
     private final ConnectionProfile profile;
@@ -100,6 +103,7 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
                              int maxNumConnections, List<String> configuredAddresses, List<Supplier<TransportAddress>> addresses) {
         super(clusterAlias, transportService, connectionManager);
         this.maxNumConnections = maxNumConnections;
+        this.configuredAddresses = configuredAddresses;
         assert addresses.isEmpty() == false : "Cannot use simple connection strategy with no configured addresses";
         this.addresses = addresses;
         // TODO: Move into the ConnectionManager
@@ -134,7 +138,9 @@ protected boolean shouldOpenMoreConnections() {
 
     @Override
     protected boolean strategyMustBeRebuilt(Settings newSettings) {
-        return false;
+        List<String> addresses = REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).get(newSettings);
+        int numOfSockets = REMOTE_SOCKET_CONNECTIONS.getConcreteSettingForNamespace(clusterAlias).get(newSettings);
+        return numOfSockets != maxNumConnections || addressesChanged(configuredAddresses, addresses);
     }
 
     @Override
@@ -223,4 +229,13 @@ private TransportAddress nextAddress(List<TransportAddress> resolvedAddresses) {
     private static TransportAddress resolveAddress(String address) {
         return new TransportAddress(parseSeedAddress(address));
     }
+
+    private boolean addressesChanged(final List<String> oldAddresses, final List<String> newAddresses) {
+        if (oldAddresses.size() != newAddresses.size()) {
+            return true;
+        }
+        Set<String> oldSeeds = new HashSet<>(oldAddresses);
+        Set<String> newSeeds = new HashSet<>(newAddresses);
+        return oldSeeds.equals(newSeeds) == false;
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index ee56629ebf0aa..9ec0f4afe9997 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -202,7 +202,9 @@ protected boolean shouldOpenMoreConnections() {
     protected boolean strategyMustBeRebuilt(Settings newSettings) {
         String proxy = REMOTE_CLUSTERS_PROXY.getConcreteSettingForNamespace(clusterAlias).get(newSettings);
         List<String> addresses = REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace(clusterAlias).get(newSettings);
-        return seedsChanged(configuredSeedNodes, addresses) || proxyChanged(proxyAddress, proxy);
+        int nodeConnections = REMOTE_NODE_CONNECTIONS.getConcreteSettingForNamespace(clusterAlias).get(newSettings);
+        return nodeConnections != maxNumRemoteConnections  || seedsChanged(configuredSeedNodes, addresses) ||
+            proxyChanged(proxyAddress, proxy);
     }
 
     @Override
diff --git a/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java
index 35a6b7a6758ac..4144cc856bd3a 100644
--- a/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.settings.AbstractScopedSettings;
 import org.elasticsearch.common.settings.ClusterSettings;
@@ -303,6 +304,59 @@ numOfConnections,  addresses(address), Collections.singletonList(addressSupplier
         }
     }
 
+    public void testSimpleStrategyWillNeedToBeRebuiltIfNumOfSocketsOrAddressesChange() {
+        try (MockTransportService transport1 = startTransport("node1", Version.CURRENT);
+             MockTransportService transport2 = startTransport("node2", Version.CURRENT)) {
+            TransportAddress address1 = transport1.boundAddress().publishAddress();
+            TransportAddress address2 = transport2.boundAddress().publishAddress();
+
+            try (MockTransportService localService = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool)) {
+                localService.start();
+                localService.acceptIncomingRequests();
+
+                ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
+                int numOfConnections = randomIntBetween(4, 8);
+                try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
+                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                         numOfConnections, addresses(address1, address2))) {
+                    PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
+                    strategy.connect(connectFuture);
+                    connectFuture.actionGet();
+
+                    assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
+                    assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
+                    assertEquals(numOfConnections, connectionManager.size());
+                    assertTrue(strategy.assertNoRunningConnections());
+
+                    Setting<?> modeSetting = RemoteConnectionStrategy.REMOTE_CONNECTION_MODE
+                        .getConcreteSettingForNamespace("cluster-alias");
+                    Setting<?> addressesSetting = SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES
+                        .getConcreteSettingForNamespace("cluster-alias");
+                    Setting<?> socketConnections = SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS
+                        .getConcreteSettingForNamespace("cluster-alias");
+
+                    Settings noChange = Settings.builder()
+                        .put(modeSetting.getKey(), "simple")
+                        .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1, address2).toArray()))
+                        .put(socketConnections.getKey(), numOfConnections)
+                        .build();
+                    assertFalse(strategy.shouldRebuildConnection(noChange));
+                    Settings addressesChanged = Settings.builder()
+                        .put(modeSetting.getKey(), "simple")
+                        .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1).toArray()))
+                        .build();
+                    assertTrue(strategy.shouldRebuildConnection(addressesChanged));
+                    Settings socketsChanged = Settings.builder()
+                        .put(modeSetting.getKey(), "simple")
+                        .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1, address2).toArray()))
+                        .put(socketConnections.getKey(), numOfConnections + 1)
+                        .build();
+                    assertTrue(strategy.shouldRebuildConnection(socketsChanged));
+                }
+            }
+        }
+    }
+
     public void testModeSettingsCannotBeUsedWhenInDifferentMode() {
         List<Tuple<Setting.AffixSetting<?>, String>> restrictedSettings = Arrays.asList(
             new Tuple<>(SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES, "192.168.0.1:8080"),
diff --git a/server/src/test/java/org/elasticsearch/transport/SniffConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/SniffConnectionStrategyTests.java
index 721055a9c20f7..30f30723c19a8 100644
--- a/server/src/test/java/org/elasticsearch/transport/SniffConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/SniffConnectionStrategyTests.java
@@ -487,7 +487,7 @@ public void testConfiguredProxyAddressModeWillReplaceNodeAddress() {
         }
     }
 
-    public void testSniffStrategyWillNeedToBeRebuiltIfSeedsOrProxyChange() {
+    public void testSniffStrategyWillNeedToBeRebuiltIfNumOfConnectionsOrSeedsOrProxyChange() {
         List<DiscoveryNode> knownNodes = new CopyOnWriteArrayList<>();
         try (MockTransportService seedTransport = startTransport("seed_node", knownNodes, Version.CURRENT);
              MockTransportService discoverableTransport = startTransport("discoverable_node", knownNodes, Version.CURRENT)) {
@@ -516,9 +516,12 @@ public void testSniffStrategyWillNeedToBeRebuiltIfSeedsOrProxyChange() {
 
                     Setting<?> seedSetting = SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace("cluster-alias");
                     Setting<?> proxySetting = SniffConnectionStrategy.REMOTE_CLUSTERS_PROXY.getConcreteSettingForNamespace("cluster-alias");
+                    Setting<?> numConnections = SniffConnectionStrategy.REMOTE_NODE_CONNECTIONS
+                        .getConcreteSettingForNamespace("cluster-alias");
 
                     Settings noChange = Settings.builder()
                         .put(seedSetting.getKey(), Strings.arrayToCommaDelimitedString(seedNodes(seedNode).toArray()))
+                        .put(numConnections.getKey(), 3)
                         .build();
                     assertFalse(strategy.shouldRebuildConnection(noChange));
                     Settings seedsChanged = Settings.builder()
@@ -530,6 +533,11 @@ public void testSniffStrategyWillNeedToBeRebuiltIfSeedsOrProxyChange() {
                         .put(proxySetting.getKey(), "proxy_address:9300")
                         .build();
                     assertTrue(strategy.shouldRebuildConnection(proxyChanged));
+                    Settings connectionsChanged = Settings.builder()
+                        .put(seedSetting.getKey(), Strings.arrayToCommaDelimitedString(seedNodes(seedNode).toArray()))
+                        .put(numConnections.getKey(), 4)
+                        .build();
+                    assertTrue(strategy.shouldRebuildConnection(connectionsChanged));
                 }
             }
         }

From a0bc15245388e8d9ebb5fbaba87b0182141f32c4 Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Tue, 3 Dec 2019 14:20:32 -0500
Subject: [PATCH 055/686] Extend systemd timeout during startup (#49784)

When we are notifying systemd that we are fully started up, it can be
that we do not notify systemd before its default timeout of sixty
seconds elapses (e.g., if we are upgrading on-disk metadata). In this
case, we need to notify systemd to extend this timeout so that we are
not abruptly terminated. We do this by repeatedly sending
EXTEND_TIMEOUT_USEC to extend the timeout by thirty seconds; we do this
every fifteen seconds. This will prevent systemd from abruptly
terminating us during a long startup. We cancel the scheduled execution
of this notification after we have successfully started up.
---
 .../elasticsearch/systemd/SystemdPlugin.java  | 57 +++++++++++++++++-
 .../systemd/SystemdPluginTests.java           | 58 +++++++++++++++----
 2 files changed, 100 insertions(+), 15 deletions(-)

diff --git a/modules/systemd/src/main/java/org/elasticsearch/systemd/SystemdPlugin.java b/modules/systemd/src/main/java/org/elasticsearch/systemd/SystemdPlugin.java
index 56a5cee808f23..cdc6ba2e31b06 100644
--- a/modules/systemd/src/main/java/org/elasticsearch/systemd/SystemdPlugin.java
+++ b/modules/systemd/src/main/java/org/elasticsearch/systemd/SystemdPlugin.java
@@ -22,8 +22,22 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.Build;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.plugins.ClusterPlugin;
 import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.script.ScriptService;
+import org.elasticsearch.threadpool.Scheduler;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.watcher.ResourceWatcherService;
+
+import java.util.Collection;
+import java.util.List;
 
 public class SystemdPlugin extends Plugin implements ClusterPlugin {
 
@@ -62,8 +76,44 @@ public SystemdPlugin() {
         enabled = Boolean.TRUE.toString().equals(esSDNotify);
     }
 
+    Scheduler.Cancellable extender;
+
+    @Override
+    public Collection<Object> createComponents(
+        final Client client,
+        final ClusterService clusterService,
+        final ThreadPool threadPool,
+        final ResourceWatcherService resourceWatcherService,
+        final ScriptService scriptService,
+        final NamedXContentRegistry xContentRegistry,
+        final Environment environment,
+        final NodeEnvironment nodeEnvironment,
+        final NamedWriteableRegistry namedWriteableRegistry) {
+        if (enabled) {
+            /*
+             * Since we have set the service type to notify, by default systemd will wait up to sixty seconds for the process to send the
+             * READY=1 status via sd_notify. Since our startup can take longer than that (e.g., if we are upgrading on-disk metadata) then
+             * we need to repeatedly notify systemd that we are still starting up by sending EXTEND_TIMEOUT_USEC with an extension to the
+             * timeout. Therefore, every fifteen seconds we send systemd a message via sd_notify to extend the timeout by thirty seconds.
+             * We will cancel this scheduled task after we successfully notify systemd that we are ready.
+             */
+            extender = threadPool.scheduleWithFixedDelay(
+                () -> {
+                    final int rc = sd_notify(0, "EXTEND_TIMEOUT_USEC=30000000");
+                    if (rc < 0) {
+                        logger.warn("extending startup timeout via sd_notify failed with [{}]", rc);
+                    }
+                },
+                TimeValue.timeValueSeconds(15),
+                ThreadPool.Names.SAME);
+        }
+        return List.of();
+    }
+
     int sd_notify(@SuppressWarnings("SameParameterValue") final int unset_environment, final String state) {
-        return Libsystemd.sd_notify(unset_environment, state);
+        final int rc = Libsystemd.sd_notify(unset_environment, state);
+        logger.trace("sd_notify({}, {}) returned [{}]", unset_environment, state, rc);
+        return rc;
     }
 
     @Override
@@ -72,11 +122,13 @@ public void onNodeStarted() {
             return;
         }
         final int rc = sd_notify(0, "READY=1");
-        logger.trace("sd_notify returned [{}]", rc);
         if (rc < 0) {
             // treat failure to notify systemd of readiness as a startup failure
             throw new RuntimeException("sd_notify returned error [" + rc + "]");
         }
+        assert extender != null;
+        final boolean cancelled = extender.cancel();
+        assert cancelled;
     }
 
     @Override
@@ -85,7 +137,6 @@ public void close() {
             return;
         }
         final int rc = sd_notify(0, "STOPPING=1");
-        logger.trace("sd_notify returned [{}]", rc);
         if (rc < 0) {
             // do not treat failure to notify systemd of stopping as a failure
             logger.warn("sd_notify returned error [{}]", rc);
diff --git a/modules/systemd/src/test/java/org/elasticsearch/systemd/SystemdPluginTests.java b/modules/systemd/src/test/java/org/elasticsearch/systemd/SystemdPluginTests.java
index 85f1446e4b0ac..13bfe5328f75c 100644
--- a/modules/systemd/src/test/java/org/elasticsearch/systemd/SystemdPluginTests.java
+++ b/modules/systemd/src/test/java/org/elasticsearch/systemd/SystemdPluginTests.java
@@ -21,20 +21,28 @@
 
 import org.elasticsearch.Build;
 import org.elasticsearch.common.CheckedConsumer;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.hamcrest.OptionalMatchers;
+import org.elasticsearch.threadpool.Scheduler;
+import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
 import java.util.Optional;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.concurrent.atomic.AtomicReference;
-import java.util.function.Consumer;
+import java.util.function.BiConsumer;
 
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasToString;
 import static org.hamcrest.Matchers.instanceOf;
+import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
 
 public class SystemdPluginTests extends ESTestCase {
 
@@ -42,24 +50,41 @@ public class SystemdPluginTests extends ESTestCase {
     private Build.Type randomNonPackageBuildType =
         randomValueOtherThanMany(t -> t == Build.Type.DEB || t == Build.Type.RPM, () -> randomFrom(Build.Type.values()));
 
+    final Scheduler.Cancellable extender = mock(Scheduler.Cancellable.class);
+    final ThreadPool threadPool = mock(ThreadPool.class);
+
+    {
+        when(extender.cancel()).thenReturn(true);
+        when(threadPool.scheduleWithFixedDelay(any(Runnable.class), eq(TimeValue.timeValueSeconds(15)), eq(ThreadPool.Names.SAME)))
+            .thenReturn(extender);
+    }
+
     public void testIsEnabled() {
         final SystemdPlugin plugin = new SystemdPlugin(false, randomPackageBuildType, Boolean.TRUE.toString());
+        plugin.createComponents(null, null, threadPool, null, null, null, null, null, null);
         assertTrue(plugin.isEnabled());
+        assertNotNull(plugin.extender);
     }
 
     public void testIsNotPackageDistribution() {
         final SystemdPlugin plugin = new SystemdPlugin(false, randomNonPackageBuildType, Boolean.TRUE.toString());
+        plugin.createComponents(null, null, threadPool, null, null, null, null, null, null);
         assertFalse(plugin.isEnabled());
+        assertNull(plugin.extender);
     }
 
     public void testIsImplicitlyNotEnabled() {
         final SystemdPlugin plugin = new SystemdPlugin(false, randomPackageBuildType, null);
+        plugin.createComponents(null, null, threadPool, null, null, null, null, null, null);
         assertFalse(plugin.isEnabled());
+        assertNull(plugin.extender);
     }
 
     public void testIsExplicitlyNotEnabled() {
         final SystemdPlugin plugin = new SystemdPlugin(false, randomPackageBuildType, Boolean.FALSE.toString());
+        plugin.createComponents(null, null, threadPool, null, null, null, null, null, null);
         assertFalse(plugin.isEnabled());
+        assertNull(plugin.extender);
     }
 
     public void testInvalid() {
@@ -75,7 +100,10 @@ public void testOnNodeStartedSuccess() {
         runTestOnNodeStarted(
             Boolean.TRUE.toString(),
             randomIntBetween(0, Integer.MAX_VALUE),
-            maybe -> assertThat(maybe, OptionalMatchers.isEmpty()));
+            (maybe, plugin) -> {
+                assertThat(maybe, OptionalMatchers.isEmpty());
+                verify(plugin.extender).cancel();
+            });
     }
 
     public void testOnNodeStartedFailure() {
@@ -83,7 +111,7 @@ public void testOnNodeStartedFailure() {
         runTestOnNodeStarted(
             Boolean.TRUE.toString(),
             rc,
-            maybe -> {
+            (maybe, plugin) -> {
                 assertThat(maybe, OptionalMatchers.isPresent());
                 // noinspection OptionalGetWithoutIsPresent
                 assertThat(maybe.get(), instanceOf(RuntimeException.class));
@@ -95,13 +123,13 @@ public void testOnNodeStartedNotEnabled() {
         runTestOnNodeStarted(
             Boolean.FALSE.toString(),
             randomInt(),
-            maybe -> assertThat(maybe, OptionalMatchers.isEmpty()));
+            (maybe, plugin) -> assertThat(maybe, OptionalMatchers.isEmpty()));
     }
 
     private void runTestOnNodeStarted(
         final String esSDNotify,
         final int rc,
-        final Consumer<Optional<Exception>> assertions) {
+        final BiConsumer<Optional<Exception>, SystemdPlugin> assertions) {
         runTest(esSDNotify, rc, assertions, SystemdPlugin::onNodeStarted, "READY=1");
     }
 
@@ -109,34 +137,34 @@ public void testCloseSuccess() {
         runTestClose(
             Boolean.TRUE.toString(),
             randomIntBetween(1, Integer.MAX_VALUE),
-            maybe -> assertThat(maybe, OptionalMatchers.isEmpty()));
+            (maybe, plugin) -> assertThat(maybe, OptionalMatchers.isEmpty()));
     }
 
     public void testCloseFailure() {
         runTestClose(
             Boolean.TRUE.toString(),
             randomIntBetween(Integer.MIN_VALUE, -1),
-            maybe -> assertThat(maybe, OptionalMatchers.isEmpty()));
+            (maybe, plugin) -> assertThat(maybe, OptionalMatchers.isEmpty()));
     }
 
     public void testCloseNotEnabled() {
         runTestClose(
             Boolean.FALSE.toString(),
             randomInt(),
-            maybe -> assertThat(maybe, OptionalMatchers.isEmpty()));
+            (maybe, plugin) -> assertThat(maybe, OptionalMatchers.isEmpty()));
     }
 
     private void runTestClose(
         final String esSDNotify,
         final int rc,
-        final Consumer<Optional<Exception>> assertions) {
+        final BiConsumer<Optional<Exception>, SystemdPlugin> assertions) {
         runTest(esSDNotify, rc, assertions, SystemdPlugin::close, "STOPPING=1");
     }
 
     private void runTest(
         final String esSDNotify,
         final int rc,
-        final Consumer<Optional<Exception>> assertions,
+        final BiConsumer<Optional<Exception>, SystemdPlugin> assertions,
         final CheckedConsumer<SystemdPlugin, IOException> invocation,
         final String expectedState) {
         final AtomicBoolean invoked = new AtomicBoolean();
@@ -153,16 +181,22 @@ int sd_notify(final int unset_environment, final String state) {
             }
 
         };
+        plugin.createComponents(null, null, threadPool, null, null, null, null, null, null);
+        if (Boolean.TRUE.toString().equals(esSDNotify)) {
+            assertNotNull(plugin.extender);
+        } else {
+            assertNull(plugin.extender);
+        }
 
         boolean success = false;
         try {
             invocation.accept(plugin);
             success = true;
         } catch (final Exception e) {
-            assertions.accept(Optional.of(e));
+            assertions.accept(Optional.of(e), plugin);
         }
         if (success) {
-            assertions.accept(Optional.empty());
+            assertions.accept(Optional.empty(), plugin);
         }
         if (Boolean.TRUE.toString().equals(esSDNotify)) {
             assertTrue(invoked.get());

From f73bc2d307cea851b407a0e8310d58321df53266 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 3 Dec 2019 22:44:20 +0100
Subject: [PATCH 056/686] Stop Copying Every Http Request in Message Handler
 (#44564)

* Copying the request is not necessary here. We can simply release it once the response has been generated and a lot of `Unpooled` allocations that way
* Relates #32228
   * I think the issue that preventet that PR  that PR from being merged was solved by #39634 that moved the bulk index marker search to ByteBuf bulk access so the composite buffer shouldn't require many additional bounds checks  (I'd argue the bounds checks we add, we save when copying the composite buffer)
* I couldn't neccessarily reproduce much of a speedup from this change, but I could reproduce a very measureable reduction in GC time with e.g. Rally's PMC (4g heap node and bulk requests of size 5k saw a reduction in young GC time by ~10% for me)
---
 .../http/netty4/Netty4HttpRequest.java        | 53 +++++++++++++++----
 .../http/netty4/Netty4HttpRequestHandler.java | 41 ++++++--------
 .../http/nio/NioHttpRequest.java              |  9 ++++
 .../http/DefaultRestChannel.java              |  3 +-
 .../org/elasticsearch/http/HttpRequest.java   | 12 +++++
 .../elasticsearch/rest/RestController.java    |  4 ++
 .../org/elasticsearch/rest/RestHandler.java   | 12 +++++
 .../org/elasticsearch/rest/RestRequest.java   | 12 ++++-
 .../rest/action/document/RestBulkAction.java  |  5 ++
 .../rest/action/search/RestSearchAction.java  |  5 ++
 .../http/DefaultRestChannelTests.java         |  9 ++++
 .../rest/RestControllerTests.java             |  9 ++++
 .../test/rest/FakeRestRequest.java            |  9 ++++
 .../security/rest/SecurityRestFilter.java     |  5 ++
 14 files changed, 151 insertions(+), 37 deletions(-)

diff --git a/modules/transport-netty4/src/main/java/org/elasticsearch/http/netty4/Netty4HttpRequest.java b/modules/transport-netty4/src/main/java/org/elasticsearch/http/netty4/Netty4HttpRequest.java
index ffabe5cbbe224..e0ad3007c98a9 100644
--- a/modules/transport-netty4/src/main/java/org/elasticsearch/http/netty4/Netty4HttpRequest.java
+++ b/modules/transport-netty4/src/main/java/org/elasticsearch/http/netty4/Netty4HttpRequest.java
@@ -19,6 +19,8 @@
 
 package org.elasticsearch.http.netty4;
 
+import io.netty.buffer.ByteBuf;
+import io.netty.buffer.Unpooled;
 import io.netty.handler.codec.http.DefaultFullHttpRequest;
 import io.netty.handler.codec.http.DefaultHttpHeaders;
 import io.netty.handler.codec.http.FullHttpRequest;
@@ -28,7 +30,6 @@
 import io.netty.handler.codec.http.cookie.Cookie;
 import io.netty.handler.codec.http.cookie.ServerCookieDecoder;
 import io.netty.handler.codec.http.cookie.ServerCookieEncoder;
-import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.http.HttpRequest;
 import org.elasticsearch.rest.RestRequest;
@@ -41,23 +42,30 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.stream.Collectors;
 
 public class Netty4HttpRequest implements HttpRequest {
-    private final FullHttpRequest request;
-    private final BytesReference content;
     private final HttpHeadersMap headers;
     private final int sequence;
+    private final AtomicBoolean released;
+    private final FullHttpRequest request;
+    private final boolean pooled;
+    private final BytesReference content;
 
     Netty4HttpRequest(FullHttpRequest request, int sequence) {
+        this(request, new HttpHeadersMap(request.headers()), sequence, new AtomicBoolean(false), true,
+            Netty4Utils.toBytesReference(request.content()));
+    }
+
+    private Netty4HttpRequest(FullHttpRequest request, HttpHeadersMap headers, int sequence, AtomicBoolean released, boolean pooled,
+                              BytesReference content) {
         this.request = request;
-        headers = new HttpHeadersMap(request.headers());
         this.sequence = sequence;
-        if (request.content().isReadable()) {
-            this.content = Netty4Utils.toBytesReference(request.content());
-        } else {
-            this.content = BytesArray.EMPTY;
-        }
+        this.headers = headers;
+        this.content = content;
+        this.pooled = pooled;
+        this.released = released;
     }
 
     @Override
@@ -105,9 +113,33 @@ public String uri() {
 
     @Override
     public BytesReference content() {
+        assert released.get() == false;
         return content;
     }
 
+    @Override
+    public void release() {
+        if (pooled && released.compareAndSet(false, true)) {
+            request.release();
+        }
+    }
+
+    @Override
+    public HttpRequest releaseAndCopy() {
+        assert released.get() == false;
+        if (pooled == false) {
+            return this;
+        }
+        try {
+            final ByteBuf copiedContent = Unpooled.copiedBuffer(request.content());
+            return new Netty4HttpRequest(
+                new DefaultFullHttpRequest(request.protocolVersion(), request.method(), request.uri(), copiedContent, request.headers(),
+                    request.trailingHeaders()),
+                headers, sequence, new AtomicBoolean(false), false, Netty4Utils.toBytesReference(copiedContent));
+        } finally {
+            release();
+        }
+    }
 
     @Override
     public final Map<String, List<String>> getHeaders() {
@@ -147,7 +179,8 @@ public HttpRequest removeHeader(String header) {
         trailingHeaders.remove(header);
         FullHttpRequest requestWithoutHeader = new DefaultFullHttpRequest(request.protocolVersion(), request.method(), request.uri(),
             request.content(), headersWithoutContentTypeHeader, trailingHeaders);
-        return new Netty4HttpRequest(requestWithoutHeader, sequence);
+        return new Netty4HttpRequest(requestWithoutHeader, new HttpHeadersMap(requestWithoutHeader.headers()), sequence, released,
+            pooled, content);
     }
 
     @Override
diff --git a/modules/transport-netty4/src/main/java/org/elasticsearch/http/netty4/Netty4HttpRequestHandler.java b/modules/transport-netty4/src/main/java/org/elasticsearch/http/netty4/Netty4HttpRequestHandler.java
index ad6d84dfcb499..7e7f45ef92e2e 100644
--- a/modules/transport-netty4/src/main/java/org/elasticsearch/http/netty4/Netty4HttpRequestHandler.java
+++ b/modules/transport-netty4/src/main/java/org/elasticsearch/http/netty4/Netty4HttpRequestHandler.java
@@ -19,11 +19,9 @@
 
 package org.elasticsearch.http.netty4;
 
-import io.netty.buffer.Unpooled;
 import io.netty.channel.ChannelHandler;
 import io.netty.channel.ChannelHandlerContext;
 import io.netty.channel.SimpleChannelInboundHandler;
-import io.netty.handler.codec.http.DefaultFullHttpRequest;
 import io.netty.handler.codec.http.FullHttpRequest;
 import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.http.HttpPipelinedRequest;
@@ -41,32 +39,25 @@ class Netty4HttpRequestHandler extends SimpleChannelInboundHandler<HttpPipelined
     protected void channelRead0(ChannelHandlerContext ctx, HttpPipelinedRequest<FullHttpRequest> msg) {
         Netty4HttpChannel channel = ctx.channel().attr(Netty4HttpServerTransport.HTTP_CHANNEL_KEY).get();
         FullHttpRequest request = msg.getRequest();
-        final FullHttpRequest copiedRequest;
+        boolean success = false;
+        Netty4HttpRequest httpRequest = new Netty4HttpRequest(request, msg.getSequence());
         try {
-            copiedRequest =
-                new DefaultFullHttpRequest(
-                    request.protocolVersion(),
-                    request.method(),
-                    request.uri(),
-                    Unpooled.copiedBuffer(request.content()),
-                    request.headers(),
-                    request.trailingHeaders());
-        } finally {
-            // As we have copied the buffer, we can release the request
-            request.release();
-        }
-        Netty4HttpRequest httpRequest = new Netty4HttpRequest(copiedRequest, msg.getSequence());
-
-        if (request.decoderResult().isFailure()) {
-            Throwable cause = request.decoderResult().cause();
-            if (cause instanceof Error) {
-                ExceptionsHelper.maybeDieOnAnotherThread(cause);
-                serverTransport.incomingRequestError(httpRequest, channel, new Exception(cause));
+            if (request.decoderResult().isFailure()) {
+                Throwable cause = request.decoderResult().cause();
+                if (cause instanceof Error) {
+                    ExceptionsHelper.maybeDieOnAnotherThread(cause);
+                    serverTransport.incomingRequestError(httpRequest, channel, new Exception(cause));
+                } else {
+                    serverTransport.incomingRequestError(httpRequest, channel, (Exception) cause);
+                }
             } else {
-                serverTransport.incomingRequestError(httpRequest, channel, (Exception) cause);
+                serverTransport.incomingRequest(httpRequest, channel);
+            }
+            success = true;
+        } finally {
+            if (success == false) {
+                httpRequest.release();
             }
-        } else {
-            serverTransport.incomingRequest(httpRequest, channel);
         }
     }
 
diff --git a/plugins/transport-nio/src/main/java/org/elasticsearch/http/nio/NioHttpRequest.java b/plugins/transport-nio/src/main/java/org/elasticsearch/http/nio/NioHttpRequest.java
index 08937593f3ba6..8e17d37699cdd 100644
--- a/plugins/transport-nio/src/main/java/org/elasticsearch/http/nio/NioHttpRequest.java
+++ b/plugins/transport-nio/src/main/java/org/elasticsearch/http/nio/NioHttpRequest.java
@@ -108,6 +108,15 @@ public BytesReference content() {
         return content;
     }
 
+    @Override
+    public void release() {
+        // NioHttpRequest works from copied unpooled bytes no need to release anything
+    }
+
+    @Override
+    public HttpRequest releaseAndCopy() {
+        return this;
+    }
 
     @Override
     public final Map<String, List<String>> getHeaders() {
diff --git a/server/src/main/java/org/elasticsearch/http/DefaultRestChannel.java b/server/src/main/java/org/elasticsearch/http/DefaultRestChannel.java
index 098a01410897c..98f578bb3412c 100644
--- a/server/src/main/java/org/elasticsearch/http/DefaultRestChannel.java
+++ b/server/src/main/java/org/elasticsearch/http/DefaultRestChannel.java
@@ -77,7 +77,8 @@ protected BytesStreamOutput newBytesOutput() {
 
     @Override
     public void sendResponse(RestResponse restResponse) {
-        final ArrayList<Releasable> toClose = new ArrayList<>(3);
+        final ArrayList<Releasable> toClose = new ArrayList<>(4);
+        toClose.add(httpRequest::release);
         if (isCloseConnection()) {
             toClose.add(() -> CloseableChannel.closeChannel(httpChannel));
         }
diff --git a/server/src/main/java/org/elasticsearch/http/HttpRequest.java b/server/src/main/java/org/elasticsearch/http/HttpRequest.java
index 02a3a58d1702d..4d67078fe571a 100644
--- a/server/src/main/java/org/elasticsearch/http/HttpRequest.java
+++ b/server/src/main/java/org/elasticsearch/http/HttpRequest.java
@@ -68,4 +68,16 @@ enum HttpVersion {
      */
     HttpResponse createResponse(RestStatus status, BytesReference content);
 
+    /**
+     * Release any resources associated with this request. Implementations should be idempotent. The behavior of {@link #content()}
+     * after this method has been invoked is undefined and implementation specific.
+     */
+    void release();
+
+    /**
+     * If this instances uses any pooled resources, creates a copy of this instance that does not use any pooled resources and releases
+     * any resources associated with this instance. If the instance does not use any shared resources, returns itself.
+     * @return a safe unpooled http request
+     */
+    HttpRequest releaseAndCopy();
 }
diff --git a/server/src/main/java/org/elasticsearch/rest/RestController.java b/server/src/main/java/org/elasticsearch/rest/RestController.java
index 1c174c89df608..aa39ccdc4659c 100644
--- a/server/src/main/java/org/elasticsearch/rest/RestController.java
+++ b/server/src/main/java/org/elasticsearch/rest/RestController.java
@@ -218,6 +218,10 @@ private void dispatchRequest(RestRequest request, RestChannel channel, RestHandl
             }
             // iff we could reserve bytes for the request we need to send the response also over this channel
             responseChannel = new ResourceHandlingHttpChannel(channel, circuitBreakerService, contentLength);
+            // TODO: Count requests double in the circuit breaker if they need copying?
+            if (handler.allowsUnsafeBuffers() == false) {
+                request.ensureSafeBuffers();
+            }
             handler.handleRequest(request, responseChannel, client);
         } catch (Exception e) {
             responseChannel.sendResponse(new BytesRestResponse(responseChannel, e));
diff --git a/server/src/main/java/org/elasticsearch/rest/RestHandler.java b/server/src/main/java/org/elasticsearch/rest/RestHandler.java
index 1ebc7a7fd1bd2..605dd41078a54 100644
--- a/server/src/main/java/org/elasticsearch/rest/RestHandler.java
+++ b/server/src/main/java/org/elasticsearch/rest/RestHandler.java
@@ -47,4 +47,16 @@ default boolean canTripCircuitBreaker() {
     default boolean supportsContentStream() {
         return false;
     }
+
+    /**
+     * Indicates if the RestHandler supports working with pooled buffers. If the request handler will not escape the return
+     * {@link RestRequest#content()} or any buffers extracted from it then there is no need to make a copies of any pooled buffers in the
+     * {@link RestRequest} instance before passing a request to this handler. If this instance does not support pooled/unsafe buffers
+     * {@link RestRequest#ensureSafeBuffers()} should be called on any request before passing it to {@link #handleRequest}.
+     *
+     * @return true iff the handler supports requests that make use of pooled buffers
+     */
+    default boolean allowsUnsafeBuffers() {
+        return false;
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/rest/RestRequest.java b/server/src/main/java/org/elasticsearch/rest/RestRequest.java
index 23e72d0c1f1d5..4a8fb44fc4299 100644
--- a/server/src/main/java/org/elasticsearch/rest/RestRequest.java
+++ b/server/src/main/java/org/elasticsearch/rest/RestRequest.java
@@ -64,9 +64,10 @@ public class RestRequest implements ToXContent.Params {
     private final String rawPath;
     private final Set<String> consumedParams = new HashSet<>();
     private final SetOnce<XContentType> xContentType = new SetOnce<>();
-    private final HttpRequest httpRequest;
     private final HttpChannel httpChannel;
 
+    private HttpRequest httpRequest;
+
     private boolean contentConsumed = false;
 
     public boolean isContentConsumed() {
@@ -97,6 +98,15 @@ protected RestRequest(RestRequest restRequest) {
             restRequest.getHttpRequest(), restRequest.getHttpChannel());
     }
 
+    /**
+     * Invoke {@link HttpRequest#releaseAndCopy()} on the http request in this instance and replace a pooled http request
+     * with an unpooled copy. This is supposed to be used before passing requests to {@link RestHandler} instances that can not safely
+     * handle http requests that use pooled buffers as determined by {@link RestHandler#allowsUnsafeBuffers()}.
+     */
+    void ensureSafeBuffers() {
+        httpRequest = httpRequest.releaseAndCopy();
+    }
+
     /**
      * Creates a new REST request. This method will throw {@link BadParameterException} if the path cannot be
      * decoded
diff --git a/server/src/main/java/org/elasticsearch/rest/action/document/RestBulkAction.java b/server/src/main/java/org/elasticsearch/rest/action/document/RestBulkAction.java
index 43cd684bd47a7..db925cd663ff9 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/document/RestBulkAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/document/RestBulkAction.java
@@ -86,4 +86,9 @@ public RestChannelConsumer prepareRequest(final RestRequest request, final NodeC
     public boolean supportsContentStream() {
         return true;
     }
+
+    @Override
+    public boolean allowsUnsafeBuffers() {
+        return true;
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java b/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
index c68c31473d1bc..11dc9f89de532 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
@@ -310,4 +310,9 @@ public static void checkRestTotalHits(RestRequest restRequest, SearchRequest sea
     protected Set<String> responseParams() {
         return RESPONSE_PARAMS;
     }
+
+    @Override
+    public boolean allowsUnsafeBuffers() {
+        return true;
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/http/DefaultRestChannelTests.java b/server/src/test/java/org/elasticsearch/http/DefaultRestChannelTests.java
index 85670e893b970..d671b81a09bc9 100644
--- a/server/src/test/java/org/elasticsearch/http/DefaultRestChannelTests.java
+++ b/server/src/test/java/org/elasticsearch/http/DefaultRestChannelTests.java
@@ -460,6 +460,15 @@ public HttpRequest removeHeader(String header) {
         public HttpResponse createResponse(RestStatus status, BytesReference content) {
             return new TestResponse(status, content);
         }
+
+        @Override
+        public void release() {
+        }
+
+        @Override
+        public HttpRequest releaseAndCopy() {
+            return this;
+        }
     }
 
     private static class TestResponse implements HttpResponse {
diff --git a/server/src/test/java/org/elasticsearch/rest/RestControllerTests.java b/server/src/test/java/org/elasticsearch/rest/RestControllerTests.java
index eb3d76bc82ae2..8413864d2ea26 100644
--- a/server/src/test/java/org/elasticsearch/rest/RestControllerTests.java
+++ b/server/src/test/java/org/elasticsearch/rest/RestControllerTests.java
@@ -608,6 +608,15 @@ public HttpRequest removeHeader(String header) {
             public HttpResponse createResponse(RestStatus status, BytesReference content) {
                 return null;
             }
+
+            @Override
+            public void release() {
+            }
+
+            @Override
+            public HttpRequest releaseAndCopy() {
+                return this;
+            }
         }, null);
 
         final AssertingChannel channel = new AssertingChannel(request, true, RestStatus.METHOD_NOT_ALLOWED);
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/FakeRestRequest.java b/test/framework/src/main/java/org/elasticsearch/test/rest/FakeRestRequest.java
index a659d6af5c6aa..2f2f5fb76bfe7 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/FakeRestRequest.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/FakeRestRequest.java
@@ -113,6 +113,15 @@ public boolean containsHeader(String name) {
                 }
             };
         }
+
+        @Override
+        public void release() {
+        }
+
+        @Override
+        public HttpRequest releaseAndCopy() {
+            return this;
+        }
     }
 
     private static class FakeHttpChannel implements HttpChannel {
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/SecurityRestFilter.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/SecurityRestFilter.java
index df678f9c63ba4..4131d1e735883 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/SecurityRestFilter.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/SecurityRestFilter.java
@@ -86,6 +86,11 @@ public boolean supportsContentStream() {
         return restHandler.supportsContentStream();
     }
 
+    @Override
+    public boolean allowsUnsafeBuffers() {
+        return restHandler.allowsUnsafeBuffers();
+    }
+
     private RestRequest maybeWrapRestRequest(RestRequest restRequest) throws IOException {
         if (restHandler instanceof RestRequestFilter) {
             return ((RestRequestFilter)restHandler).getFilteredRequest(restRequest);

From a3a8831ef3f054dc7c6e36ec503feda24b18fb85 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Tue, 3 Dec 2019 16:13:56 -0800
Subject: [PATCH 057/686] Update CI BWC versions

---
 .ci/bwcVersions | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/bwcVersions b/.ci/bwcVersions
index 621d2e0b489dc..52b778bf11235 100644
--- a/.ci/bwcVersions
+++ b/.ci/bwcVersions
@@ -11,7 +11,7 @@ BWC_VERSION:
   - "7.4.0"
   - "7.4.1"
   - "7.4.2"
-  - "7.4.3"
   - "7.5.0"
+  - "7.5.1"
   - "7.6.0"
   - "8.0.0"

From f4368c3f9d04f2e643987dca3f148923fac065ea Mon Sep 17 00:00:00 2001
From: Stuart Tettemer <stu@elastic.co>
Date: Tue, 3 Dec 2019 18:55:48 -0700
Subject: [PATCH 058/686] Scripting: add available languages & contexts API
 (#49652)

Adds `GET /_script_language` to support Kibana dynamic scripting
language selection.

Response contains whether `inline` and/or `stored` scripts are
enabled as determined by the `script.allowed_types` settings.

For each scripting language registered, such as `painless`,
`expression`, `mustache` or custom, available contexts for the language
are included as determined by the `script.allowed_contexts` setting.

Response format:
```
{
  "types_allowed": [
    "inline",
    "stored"
  ],
  "language_contexts": [
    {
      "language": "expression",
      "contexts": [
        "aggregation_selector",
        "aggs"
        ...
      ]
    },
    {
      "language": "painless",
      "contexts": [
        "aggregation_selector",
        "aggs",
        "aggs_combine",
        ...
      ]
    }
...
  ]
}
```

Fixes: #49463
---
 .../client/RestHighLevelClientTests.java      |   1 +
 .../expression/ExpressionScriptEngine.java    |  89 +++++----
 .../script/mustache/MustacheScriptEngine.java |   6 +
 .../painless/PainlessScriptEngine.java        |   5 +
 .../expertscript/ExpertScriptPlugin.java      |   6 +
 .../api/get_script_languages.json             |  19 ++
 .../test/scripts/25_get_script_languages.yml  |   9 +
 .../elasticsearch/action/ActionModule.java    |   5 +
 .../GetScriptLanguageAction.java              |  31 ++++
 .../GetScriptLanguageRequest.java             |  42 +++++
 .../GetScriptLanguageResponse.java            |  78 ++++++++
 .../TransportGetScriptLanguageAction.java     |  43 +++++
 .../cluster/RestGetScriptLanguageAction.java  |  51 ++++++
 .../elasticsearch/script/ScriptEngine.java    |   6 +
 .../script/ScriptLanguagesInfo.java           | 170 ++++++++++++++++++
 .../elasticsearch/script/ScriptService.java   |  22 +++
 .../GetScriptLanguageResponseTests.java       | 136 ++++++++++++++
 .../script/ScriptLanguagesInfoTests.java      | 134 ++++++++++++++
 .../functionscore/ExplainableScriptIT.java    |   6 +
 .../search/suggest/SuggestSearchIT.java       |   6 +
 .../script/MockScriptEngine.java              |  30 ++++
 21 files changed, 858 insertions(+), 37 deletions(-)
 create mode 100644 rest-api-spec/src/main/resources/rest-api-spec/api/get_script_languages.json
 create mode 100644 rest-api-spec/src/main/resources/rest-api-spec/test/scripts/25_get_script_languages.yml
 create mode 100644 server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageAction.java
 create mode 100644 server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageRequest.java
 create mode 100644 server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageResponse.java
 create mode 100644 server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/TransportGetScriptLanguageAction.java
 create mode 100644 server/src/main/java/org/elasticsearch/rest/action/admin/cluster/RestGetScriptLanguageAction.java
 create mode 100644 server/src/main/java/org/elasticsearch/script/ScriptLanguagesInfo.java
 create mode 100644 server/src/test/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageResponseTests.java
 create mode 100644 server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
index 598ccce0f33e0..3135239530199 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
@@ -765,6 +765,7 @@ public void testApiNamingConventions() throws Exception {
             "cluster.remote_info",
             "create",
             "get_script_context",
+            "get_script_languages",
             "get_source",
             "indices.exists_type",
             "indices.get_upgrade",
diff --git a/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java b/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
index afe507279027d..3df42b53cbb34 100644
--- a/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
+++ b/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
@@ -55,6 +55,8 @@
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
+import java.util.function.Function;
 
 /**
  * Provides the infrastructure for Lucene expressions as a scripting language for Elasticsearch.
@@ -65,6 +67,41 @@ public class ExpressionScriptEngine implements ScriptEngine {
 
     public static final String NAME = "expression";
 
+    private static Map<ScriptContext<?>, Function<Expression,Object>> contexts = Map.of(
+        BucketAggregationScript.CONTEXT,
+            ExpressionScriptEngine::newBucketAggregationScriptFactory,
+
+        BucketAggregationSelectorScript.CONTEXT,
+            (Expression expr) -> {
+                BucketAggregationScript.Factory factory = newBucketAggregationScriptFactory(expr);
+                BucketAggregationSelectorScript.Factory wrappedFactory = parameters -> new BucketAggregationSelectorScript(parameters) {
+                    @Override
+                    public boolean execute() {
+                        return factory.newInstance(getParams()).execute().doubleValue() == 1.0;
+                    }
+                };
+                return wrappedFactory;
+            },
+
+        FilterScript.CONTEXT,
+            (Expression expr) -> (FilterScript.Factory) (p, lookup) -> newFilterScript(expr, lookup, p),
+
+        ScoreScript.CONTEXT,
+            (Expression expr) -> (ScoreScript.Factory) (p, lookup) -> newScoreScript(expr, lookup, p),
+
+        TermsSetQueryScript.CONTEXT,
+            (Expression expr) -> (TermsSetQueryScript.Factory) (p, lookup) -> newTermsSetQueryScript(expr, lookup, p),
+
+        AggregationScript.CONTEXT,
+            (Expression expr) -> (AggregationScript.Factory) (p, lookup) -> newAggregationScript(expr, lookup, p),
+
+        NumberSortScript.CONTEXT,
+            (Expression expr) -> (NumberSortScript.Factory) (p, lookup) -> newSortScript(expr, lookup, p),
+
+        FieldScript.CONTEXT,
+            (Expression expr) -> (FieldScript.Factory) (p, lookup) -> newFieldScript(expr, lookup, p)
+    );
+
     @Override
     public String getType() {
         return NAME;
@@ -102,37 +139,15 @@ protected Class<?> loadClass(String name, boolean resolve) throws ClassNotFoundE
                 }
             }
         });
-        if (context.instanceClazz.equals(BucketAggregationScript.class)) {
-            return context.factoryClazz.cast(newBucketAggregationScriptFactory(expr));
-        } else if (context.instanceClazz.equals(BucketAggregationSelectorScript.class)) {
-            BucketAggregationScript.Factory factory = newBucketAggregationScriptFactory(expr);
-            BucketAggregationSelectorScript.Factory wrappedFactory = parameters -> new BucketAggregationSelectorScript(parameters) {
-                @Override
-                public boolean execute() {
-                    return factory.newInstance(getParams()).execute().doubleValue() == 1.0;
-                }
-            };
-            return context.factoryClazz.cast(wrappedFactory);
-        } else if (context.instanceClazz.equals(FilterScript.class)) {
-            FilterScript.Factory factory = (p, lookup) -> newFilterScript(expr, lookup, p);
-            return context.factoryClazz.cast(factory);
-        } else if (context.instanceClazz.equals(ScoreScript.class)) {
-            ScoreScript.Factory factory = (p, lookup) -> newScoreScript(expr, lookup, p);
-            return context.factoryClazz.cast(factory);
-        } else if (context.instanceClazz.equals(TermsSetQueryScript.class)) {
-            TermsSetQueryScript.Factory factory = (p, lookup) -> newTermsSetQueryScript(expr, lookup, p);
-            return context.factoryClazz.cast(factory);
-        } else if (context.instanceClazz.equals(AggregationScript.class)) {
-            AggregationScript.Factory factory = (p, lookup) -> newAggregationScript(expr, lookup, p);
-            return context.factoryClazz.cast(factory);
-        } else if (context.instanceClazz.equals(NumberSortScript.class)) {
-            NumberSortScript.Factory factory = (p, lookup) -> newSortScript(expr, lookup, p);
-            return context.factoryClazz.cast(factory);
-        } else if (context.instanceClazz.equals(FieldScript.class)) {
-            FieldScript.Factory factory = (p, lookup) -> newFieldScript(expr, lookup, p);
-            return context.factoryClazz.cast(factory);
+        if (contexts.containsKey(context) == false) {
+            throw new IllegalArgumentException("expression engine does not know how to handle script context [" + context.name + "]");
         }
-        throw new IllegalArgumentException("expression engine does not know how to handle script context [" + context.name + "]");
+        return context.factoryClazz.cast(contexts.get(context).apply(expr));
+    }
+
+    @Override
+    public Set<ScriptContext<?>> getSupportedContexts() {
+        return contexts.keySet();
     }
 
     private static BucketAggregationScript.Factory newBucketAggregationScriptFactory(Expression expr) {
@@ -166,7 +181,7 @@ public Double execute() {
         };
     }
 
-    private NumberSortScript.LeafFactory newSortScript(Expression expr, SearchLookup lookup, @Nullable Map<String, Object> vars) {
+    private static NumberSortScript.LeafFactory newSortScript(Expression expr, SearchLookup lookup, @Nullable Map<String, Object> vars) {
         // NOTE: if we need to do anything complicated with bindings in the future, we can just extend Bindings,
         // instead of complicating SimpleBindings (which should stay simple)
         SimpleBindings bindings = new SimpleBindings();
@@ -193,7 +208,7 @@ private NumberSortScript.LeafFactory newSortScript(Expression expr, SearchLookup
         return new ExpressionNumberSortScript(expr, bindings, needsScores);
     }
 
-    private TermsSetQueryScript.LeafFactory newTermsSetQueryScript(Expression expr, SearchLookup lookup,
+    private static TermsSetQueryScript.LeafFactory newTermsSetQueryScript(Expression expr, SearchLookup lookup,
         @Nullable Map<String, Object> vars) {
         // NOTE: if we need to do anything complicated with bindings in the future, we can just extend Bindings,
         // instead of complicating SimpleBindings (which should stay simple)
@@ -216,7 +231,7 @@ private TermsSetQueryScript.LeafFactory newTermsSetQueryScript(Expression expr,
         return new ExpressionTermSetQueryScript(expr, bindings);
     }
 
-    private AggregationScript.LeafFactory newAggregationScript(Expression expr, SearchLookup lookup,
+    private static AggregationScript.LeafFactory newAggregationScript(Expression expr, SearchLookup lookup,
         @Nullable Map<String, Object> vars) {
         // NOTE: if we need to do anything complicated with bindings in the future, we can just extend Bindings,
         // instead of complicating SimpleBindings (which should stay simple)
@@ -252,7 +267,7 @@ private AggregationScript.LeafFactory newAggregationScript(Expression expr, Sear
         return new ExpressionAggregationScript(expr, bindings, needsScores, specialValue);
     }
 
-    private FieldScript.LeafFactory newFieldScript(Expression expr, SearchLookup lookup, @Nullable Map<String, Object> vars) {
+    private static FieldScript.LeafFactory newFieldScript(Expression expr, SearchLookup lookup, @Nullable Map<String, Object> vars) {
         SimpleBindings bindings = new SimpleBindings();
         for (String variable : expr.variables) {
             try {
@@ -273,7 +288,7 @@ private FieldScript.LeafFactory newFieldScript(Expression expr, SearchLookup loo
      * This is a hack for filter scripts, which must return booleans instead of doubles as expression do.
      * See https://github.com/elastic/elasticsearch/issues/26429.
      */
-    private FilterScript.LeafFactory newFilterScript(Expression expr, SearchLookup lookup, @Nullable Map<String, Object> vars) {
+    private static FilterScript.LeafFactory newFilterScript(Expression expr, SearchLookup lookup, @Nullable Map<String, Object> vars) {
         ScoreScript.LeafFactory searchLeafFactory = newScoreScript(expr, lookup, vars);
         return ctx -> {
             ScoreScript script = searchLeafFactory.newInstance(ctx);
@@ -290,7 +305,7 @@ public void setDocument(int docid) {
         };
     }
 
-    private ScoreScript.LeafFactory newScoreScript(Expression expr, SearchLookup lookup, @Nullable Map<String, Object> vars) {
+    private static ScoreScript.LeafFactory newScoreScript(Expression expr, SearchLookup lookup, @Nullable Map<String, Object> vars) {
         // NOTE: if we need to do anything complicated with bindings in the future, we can just extend Bindings,
         // instead of complicating SimpleBindings (which should stay simple)
         SimpleBindings bindings = new SimpleBindings();
@@ -327,7 +342,7 @@ private ScoreScript.LeafFactory newScoreScript(Expression expr, SearchLookup loo
     /**
      * converts a ParseException at compile-time or link-time to a ScriptException
      */
-    private ScriptException convertToScriptException(String message, String source, String portion, Throwable cause) {
+    private static ScriptException convertToScriptException(String message, String source, String portion, Throwable cause) {
         List<String> stack = new ArrayList<>();
         stack.add(portion);
         StringBuilder pointer = new StringBuilder();
diff --git a/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java b/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
index ca28d12a7bda5..f453905089fdd 100644
--- a/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
+++ b/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
@@ -41,6 +41,7 @@
 import java.security.PrivilegedAction;
 import java.util.Collections;
 import java.util.Map;
+import java.util.Set;
 
 /**
  * Main entry point handling template registration, compilation and
@@ -79,6 +80,11 @@ public <T> T compile(String templateName, String templateSource, ScriptContext<T
 
     }
 
+    @Override
+    public Set<ScriptContext<?>> getSupportedContexts() {
+        return Set.of(TemplateScript.CONTEXT);
+    }
+
     private CustomMustacheFactory createMustacheFactory(Map<String, String> options) {
         if (options == null || options.isEmpty() || options.containsKey(Script.CONTENT_TYPE_OPTION) == false) {
             return new CustomMustacheFactory();
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
index 11bfbe3b40fc6..7f64e992bc122 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
@@ -146,6 +146,11 @@ public Loader run() {
         }
     }
 
+    @Override
+    public Set<ScriptContext<?>> getSupportedContexts() {
+        return contextsToCompilers.keySet();
+    }
+
     /**
      * Generates a stateful factory class that will return script instances.  Acts as a middle man between
      * the {@link ScriptContext#factoryClazz} and the {@link ScriptContext#instanceClazz} when used so that
diff --git a/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java b/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
index 0b65084dee466..5259d32a2837b 100644
--- a/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
+++ b/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
@@ -35,6 +35,7 @@
 import java.io.UncheckedIOException;
 import java.util.Collection;
 import java.util.Map;
+import java.util.Set;
 
 /**
  * An example script plugin that adds a {@link ScriptEngine} implementing expert scoring.
@@ -76,6 +77,11 @@ public void close() {
             // optionally close resources
         }
 
+        @Override
+        public Set<ScriptContext<?>> getSupportedContexts() {
+            return Set.of(ScoreScript.CONTEXT);
+        }
+
         private static class PureDfLeafFactory implements LeafFactory {
             private final Map<String, Object> params;
             private final SearchLookup lookup;
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/get_script_languages.json b/rest-api-spec/src/main/resources/rest-api-spec/api/get_script_languages.json
new file mode 100644
index 0000000000000..5a45392d9ee11
--- /dev/null
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/get_script_languages.json
@@ -0,0 +1,19 @@
+{
+  "get_script_languages":{
+    "documentation":{
+      "description":"Returns available script types, languages and contexts"
+    },
+    "stability":"experimental",
+    "url":{
+      "paths":[
+        {
+          "path":"/_script_language",
+          "methods":[
+            "GET"
+          ]
+        }
+      ]
+    },
+    "params":{}
+  }
+}
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/scripts/25_get_script_languages.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/scripts/25_get_script_languages.yml
new file mode 100644
index 0000000000000..f4d764324e2dd
--- /dev/null
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/scripts/25_get_script_languages.yml
@@ -0,0 +1,9 @@
+"Action to get script languages":
+  - skip:
+      version: " - 7.6.0"
+      reason: "get_script_languages introduced in 7.6.0"
+  - do:
+      get_script_languages: {}
+
+  - match: { types_allowed.0: "inline" }
+  - match: { types_allowed.1: "stored" }
diff --git a/server/src/main/java/org/elasticsearch/action/ActionModule.java b/server/src/main/java/org/elasticsearch/action/ActionModule.java
index 10dcf6943f867..3d60a1fb698d2 100644
--- a/server/src/main/java/org/elasticsearch/action/ActionModule.java
+++ b/server/src/main/java/org/elasticsearch/action/ActionModule.java
@@ -80,10 +80,12 @@
 import org.elasticsearch.action.admin.cluster.stats.TransportClusterStatsAction;
 import org.elasticsearch.action.admin.cluster.storedscripts.DeleteStoredScriptAction;
 import org.elasticsearch.action.admin.cluster.storedscripts.GetScriptContextAction;
+import org.elasticsearch.action.admin.cluster.storedscripts.GetScriptLanguageAction;
 import org.elasticsearch.action.admin.cluster.storedscripts.GetStoredScriptAction;
 import org.elasticsearch.action.admin.cluster.storedscripts.PutStoredScriptAction;
 import org.elasticsearch.action.admin.cluster.storedscripts.TransportDeleteStoredScriptAction;
 import org.elasticsearch.action.admin.cluster.storedscripts.TransportGetScriptContextAction;
+import org.elasticsearch.action.admin.cluster.storedscripts.TransportGetScriptLanguageAction;
 import org.elasticsearch.action.admin.cluster.storedscripts.TransportGetStoredScriptAction;
 import org.elasticsearch.action.admin.cluster.storedscripts.TransportPutStoredScriptAction;
 import org.elasticsearch.action.admin.cluster.tasks.PendingClusterTasksAction;
@@ -249,6 +251,7 @@
 import org.elasticsearch.rest.action.admin.cluster.RestDeleteStoredScriptAction;
 import org.elasticsearch.rest.action.admin.cluster.RestGetRepositoriesAction;
 import org.elasticsearch.rest.action.admin.cluster.RestGetScriptContextAction;
+import org.elasticsearch.rest.action.admin.cluster.RestGetScriptLanguageAction;
 import org.elasticsearch.rest.action.admin.cluster.RestGetSnapshotsAction;
 import org.elasticsearch.rest.action.admin.cluster.RestGetStoredScriptAction;
 import org.elasticsearch.rest.action.admin.cluster.RestGetTaskAction;
@@ -522,6 +525,7 @@ public <Request extends ActionRequest, Response extends ActionResponse> void reg
         actions.register(GetStoredScriptAction.INSTANCE, TransportGetStoredScriptAction.class);
         actions.register(DeleteStoredScriptAction.INSTANCE, TransportDeleteStoredScriptAction.class);
         actions.register(GetScriptContextAction.INSTANCE, TransportGetScriptContextAction.class);
+        actions.register(GetScriptLanguageAction.INSTANCE, TransportGetScriptLanguageAction.class);
 
         actions.register(FieldCapabilitiesAction.INSTANCE, TransportFieldCapabilitiesAction.class);
         actions.register(TransportFieldCapabilitiesIndexAction.TYPE, TransportFieldCapabilitiesIndexAction.class);
@@ -662,6 +666,7 @@ public void initRestHandlers(Supplier<DiscoveryNodes> nodesInCluster) {
         registerHandler.accept(new RestPutStoredScriptAction(restController));
         registerHandler.accept(new RestDeleteStoredScriptAction(restController));
         registerHandler.accept(new RestGetScriptContextAction(restController));
+        registerHandler.accept(new RestGetScriptLanguageAction(restController));
 
         registerHandler.accept(new RestFieldCapabilitiesAction(restController));
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageAction.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageAction.java
new file mode 100644
index 0000000000000..d4c6ae2de052c
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageAction.java
@@ -0,0 +1,31 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.action.admin.cluster.storedscripts;
+
+import org.elasticsearch.action.ActionType;
+
+public class GetScriptLanguageAction extends ActionType<GetScriptLanguageResponse> {
+    public static final GetScriptLanguageAction INSTANCE = new GetScriptLanguageAction();
+    public static final String NAME = "cluster:admin/script_language/get";
+
+    private GetScriptLanguageAction() {
+        super(NAME, GetScriptLanguageResponse::new);
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageRequest.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageRequest.java
new file mode 100644
index 0000000000000..c5433be2febfa
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageRequest.java
@@ -0,0 +1,42 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.action.admin.cluster.storedscripts;
+
+import org.elasticsearch.action.ActionRequest;
+import org.elasticsearch.action.ActionRequestValidationException;
+import org.elasticsearch.common.io.stream.StreamInput;
+
+import java.io.IOException;
+
+public class GetScriptLanguageRequest extends ActionRequest {
+    public GetScriptLanguageRequest() {
+        super();
+    }
+
+    GetScriptLanguageRequest(StreamInput in) throws IOException {
+        super(in);
+    }
+
+    @Override
+    public ActionRequestValidationException validate() { return null; }
+
+    @Override
+    public String toString() { return "get script languages"; }
+}
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageResponse.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageResponse.java
new file mode 100644
index 0000000000000..7d8ea7654c4d4
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageResponse.java
@@ -0,0 +1,78 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.action.admin.cluster.storedscripts;
+
+import org.elasticsearch.action.ActionResponse;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.StatusToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.script.ScriptLanguagesInfo;
+
+import java.io.IOException;
+import java.util.Objects;
+
+public class GetScriptLanguageResponse extends ActionResponse implements StatusToXContentObject, Writeable {
+    public final ScriptLanguagesInfo info;
+
+    GetScriptLanguageResponse(ScriptLanguagesInfo info) {
+        this.info = info;
+    }
+
+    GetScriptLanguageResponse(StreamInput in) throws IOException {
+        super(in);
+        info = new ScriptLanguagesInfo(in);
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        info.writeTo(out);
+    }
+
+    @Override
+    public RestStatus status() {
+        return RestStatus.OK;
+    }
+
+    public static GetScriptLanguageResponse fromXContent(XContentParser parser) throws IOException {
+        return new GetScriptLanguageResponse(ScriptLanguagesInfo.fromXContent(parser));
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o)
+            return true;
+        if (o == null || getClass() != o.getClass())
+            return false;
+        GetScriptLanguageResponse that = (GetScriptLanguageResponse) o;
+        return info.equals(that.info);
+    }
+
+    @Override
+    public int hashCode() { return Objects.hash(info); }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        return info.toXContent(builder, params);
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/TransportGetScriptLanguageAction.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/TransportGetScriptLanguageAction.java
new file mode 100644
index 0000000000000..96f07de533c25
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/storedscripts/TransportGetScriptLanguageAction.java
@@ -0,0 +1,43 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.action.admin.cluster.storedscripts;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.action.support.HandledTransportAction;
+import org.elasticsearch.common.inject.Inject;
+import org.elasticsearch.script.ScriptService;
+import org.elasticsearch.tasks.Task;
+import org.elasticsearch.transport.TransportService;
+
+public class TransportGetScriptLanguageAction extends HandledTransportAction<GetScriptLanguageRequest, GetScriptLanguageResponse> {
+    private final ScriptService scriptService;
+
+    @Inject
+    public TransportGetScriptLanguageAction(TransportService transportService, ActionFilters actionFilters, ScriptService scriptService) {
+        super(GetScriptLanguageAction.NAME, transportService, actionFilters, GetScriptLanguageRequest::new);
+        this.scriptService = scriptService;
+    }
+
+    @Override
+    protected void doExecute(Task task, GetScriptLanguageRequest request, ActionListener<GetScriptLanguageResponse> listener) {
+        listener.onResponse(new GetScriptLanguageResponse(scriptService.getScriptLanguages()));
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/rest/action/admin/cluster/RestGetScriptLanguageAction.java b/server/src/main/java/org/elasticsearch/rest/action/admin/cluster/RestGetScriptLanguageAction.java
new file mode 100644
index 0000000000000..c9246b910cf4f
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/rest/action/admin/cluster/RestGetScriptLanguageAction.java
@@ -0,0 +1,51 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.rest.action.admin.cluster;
+
+import org.elasticsearch.action.admin.cluster.storedscripts.GetScriptLanguageAction;
+import org.elasticsearch.action.admin.cluster.storedscripts.GetScriptLanguageRequest;
+import org.elasticsearch.client.node.NodeClient;
+import org.elasticsearch.common.inject.Inject;
+import org.elasticsearch.rest.BaseRestHandler;
+import org.elasticsearch.rest.RestController;
+import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.rest.action.RestToXContentListener;
+
+import java.io.IOException;
+
+import static org.elasticsearch.rest.RestRequest.Method.GET;
+
+public class RestGetScriptLanguageAction extends BaseRestHandler {
+    @Inject
+    public RestGetScriptLanguageAction(RestController controller) {
+        controller.registerHandler(GET, "/_script_language", this);
+    }
+
+    @Override public String getName() {
+        return "script_language_action";
+    }
+
+    @Override protected RestChannelConsumer prepareRequest(RestRequest request, NodeClient client) throws IOException {
+        return channel -> client.execute(GetScriptLanguageAction.INSTANCE,
+            new GetScriptLanguageRequest(),
+            new RestToXContentListener<>(channel));
+    }
+
+}
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptEngine.java b/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
index bd32cce0b3781..9ace06d701d14 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
@@ -22,6 +22,7 @@
 import java.io.Closeable;
 import java.io.IOException;
 import java.util.Map;
+import java.util.Set;
 
 /**
  * A script language implementation.
@@ -45,4 +46,9 @@ public interface ScriptEngine extends Closeable {
 
     @Override
     default void close() throws IOException {}
+
+    /**
+     * Script contexts supported by this engine.
+     */
+    Set<ScriptContext<?>> getSupportedContexts();
 }
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptLanguagesInfo.java b/server/src/main/java/org/elasticsearch/script/ScriptLanguagesInfo.java
new file mode 100644
index 0000000000000..d8bfb4f499fe5
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/script/ScriptLanguagesInfo.java
@@ -0,0 +1,170 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.script;
+
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
+/**
+ * The allowable types, languages and their corresponding contexts.  When serialized there is a top level <code>types_allowed</code> list,
+ * meant to reflect the setting <code>script.allowed_types</code> with the allowed types (eg <code>inline</code>, <code>stored</code>).
+ *
+ * The top-level <code>language_contexts</code> list of objects have the <code>language</code> (eg. <code>painless</code>,
+ * <code>mustache</code>) and a list of <code>contexts</code> available for the language.  It is the responsibility of the caller to ensure
+ * these contexts are filtered by the <code>script.allowed_contexts</code> setting.
+ *
+ * The json serialization of the object has the form:
+ * <code>
+ *     {
+ *   "types_allowed": [
+ *     "inline",
+ *     "stored"
+ *   ],
+ *   "language_contexts": [
+ *     {
+ *       "language": "expression",
+ *       "contexts": [
+ *         "aggregation_selector",
+ *         "aggs"
+ *         ...
+ *       ]
+ *     },
+ *     {
+ *       "language": "painless",
+ *       "contexts": [
+ *         "aggregation_selector",
+ *         "aggs",
+ *         "aggs_combine",
+ *         ...
+ *       ]
+ *     }
+ * ...
+ *   ]
+ * }
+ * </code>
+ */
+public class ScriptLanguagesInfo implements ToXContentObject, Writeable {
+    private static final ParseField TYPES_ALLOWED = new ParseField("types_allowed");
+    private static final ParseField LANGUAGE_CONTEXTS = new ParseField("language_contexts");
+    private static final ParseField LANGUAGE = new ParseField("language");
+    private static final ParseField CONTEXTS = new ParseField("contexts");
+
+    public final Set<String> typesAllowed;
+    public final Map<String,Set<String>> languageContexts;
+
+    public ScriptLanguagesInfo(Set<String> typesAllowed, Map<String,Set<String>> languageContexts) {
+        this.typesAllowed = typesAllowed != null ? Set.copyOf(typesAllowed): Collections.emptySet();
+        this.languageContexts = languageContexts != null ? Map.copyOf(languageContexts): Collections.emptyMap();
+    }
+
+    public ScriptLanguagesInfo(StreamInput in) throws IOException {
+        typesAllowed = in.readSet(StreamInput::readString);
+        languageContexts = in.readMap(StreamInput::readString, sin -> sin.readSet(StreamInput::readString));
+    }
+
+    @SuppressWarnings("unchecked")
+    public static ConstructingObjectParser<ScriptLanguagesInfo,Void> PARSER =
+        new ConstructingObjectParser<>("script_languages_info", true,
+            (a) -> new ScriptLanguagesInfo(
+                new HashSet<>((List<String>)a[0]),
+                ((List<Tuple<String,Set<String>>>)a[1]).stream().collect(Collectors.toMap(Tuple::v1, Tuple::v2))
+            )
+        );
+
+    @SuppressWarnings("unchecked")
+    private static ConstructingObjectParser<Tuple<String,Set<String>>,Void> LANGUAGE_CONTEXT_PARSER =
+        new ConstructingObjectParser<>("language_contexts", true,
+            (m, name) -> new Tuple<>((String)m[0], Set.copyOf((List<String>)m[1]))
+        );
+
+    static {
+        PARSER.declareStringArray(constructorArg(), TYPES_ALLOWED);
+        PARSER.declareObjectArray(constructorArg(), LANGUAGE_CONTEXT_PARSER, LANGUAGE_CONTEXTS);
+        LANGUAGE_CONTEXT_PARSER.declareString(constructorArg(), LANGUAGE);
+        LANGUAGE_CONTEXT_PARSER.declareStringArray(constructorArg(), CONTEXTS);
+    }
+
+    public static ScriptLanguagesInfo fromXContent(XContentParser parser) throws IOException {
+        return PARSER.parse(parser, null);
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeStringCollection(typesAllowed);
+        out.writeMap(languageContexts, StreamOutput::writeString, StreamOutput::writeStringCollection);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o)
+            return true;
+        if (o == null || getClass() != o.getClass())
+            return false;
+        ScriptLanguagesInfo that = (ScriptLanguagesInfo) o;
+        return Objects.equals(typesAllowed, that.typesAllowed) &&
+            Objects.equals(languageContexts, that.languageContexts);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(typesAllowed, languageContexts);
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject().startArray(TYPES_ALLOWED.getPreferredName());
+        for (String type: typesAllowed.stream().sorted().collect(Collectors.toList())) {
+            builder.value(type);
+        }
+
+        builder.endArray().startArray(LANGUAGE_CONTEXTS.getPreferredName());
+        List<Map.Entry<String,Set<String>>> languagesByName = languageContexts.entrySet().stream().sorted(
+            Map.Entry.comparingByKey()
+        ).collect(Collectors.toList());
+
+        for (Map.Entry<String,Set<String>> languageContext: languagesByName) {
+            builder.startObject().field(LANGUAGE.getPreferredName(), languageContext.getKey()).startArray(CONTEXTS.getPreferredName());
+            for (String context: languageContext.getValue().stream().sorted().collect(Collectors.toList())) {
+                builder.value(context);
+            }
+            builder.endArray().endObject();
+        }
+
+        return builder.endArray().endObject();
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptService.java b/server/src/main/java/org/elasticsearch/script/ScriptService.java
index 799515256d302..a1788ee74a163 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptService.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptService.java
@@ -52,12 +52,14 @@
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
 import java.util.Collections;
+import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 import java.util.Set;
 import java.util.function.Function;
+import java.util.stream.Collectors;
 
 public class ScriptService implements Closeable, ClusterStateApplier {
 
@@ -546,6 +548,26 @@ public Set<ScriptContextInfo> getContextInfos() {
         return infos;
     }
 
+    public ScriptLanguagesInfo getScriptLanguages() {
+        Set<String> types = typesAllowed;
+        if (types == null) {
+            types = new HashSet<>();
+            for (ScriptType type: ScriptType.values()) {
+                types.add(type.getName());
+            }
+        }
+
+        final Set<String> contexts = contextsAllowed != null ? contextsAllowed : this.contexts.keySet();
+        Map<String,Set<String>> languageContexts = new HashMap<>();
+        engines.forEach(
+            (key, value) -> languageContexts.put(
+                key,
+                value.getSupportedContexts().stream().map(c -> c.name).filter(contexts::contains).collect(Collectors.toSet())
+            )
+        );
+        return new ScriptLanguagesInfo(types, languageContexts);
+    }
+
     public ScriptStats stats() {
         return scriptMetrics.stats();
     }
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageResponseTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageResponseTests.java
new file mode 100644
index 0000000000000..f330cb36b7296
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/storedscripts/GetScriptLanguageResponseTests.java
@@ -0,0 +1,136 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.action.admin.cluster.storedscripts;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.script.ScriptLanguagesInfo;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+public class GetScriptLanguageResponseTests extends AbstractSerializingTestCase<GetScriptLanguageResponse> {
+    private static int MAX_VALUES = 4;
+    private static final int MIN_LENGTH = 1;
+    private static final int MAX_LENGTH = 16;
+
+    @Override
+    protected GetScriptLanguageResponse createTestInstance() {
+        if (randomBoolean()) {
+            return new GetScriptLanguageResponse(
+                new ScriptLanguagesInfo(Collections.emptySet(), Collections.emptyMap())
+            );
+        }
+        return new GetScriptLanguageResponse(randomInstance());
+    }
+
+    @Override
+    protected GetScriptLanguageResponse doParseInstance(XContentParser parser) throws IOException {
+        return GetScriptLanguageResponse.fromXContent(parser);
+    }
+
+    @Override
+    protected Writeable.Reader<GetScriptLanguageResponse> instanceReader() {  return GetScriptLanguageResponse::new; }
+
+    @Override
+    protected GetScriptLanguageResponse mutateInstance(GetScriptLanguageResponse instance) throws IOException {
+        switch (randomInt(2)) {
+            case 0:
+                // mutate typesAllowed
+                return new GetScriptLanguageResponse(
+                    new ScriptLanguagesInfo(mutateStringSet(instance.info.typesAllowed), instance.info.languageContexts)
+                );
+            case 1:
+                // Add language
+                String language = randomValueOtherThanMany(
+                    instance.info.languageContexts::containsKey,
+                    () -> randomAlphaOfLengthBetween(MIN_LENGTH, MAX_LENGTH)
+                );
+                Map<String,Set<String>> languageContexts = new HashMap<>();
+                instance.info.languageContexts.forEach(languageContexts::put);
+                languageContexts.put(language, randomStringSet(randomIntBetween(1, MAX_VALUES)));
+                return new GetScriptLanguageResponse(new ScriptLanguagesInfo(instance.info.typesAllowed, languageContexts));
+            default:
+                // Mutate languageContexts
+                Map<String,Set<String>> lc = new HashMap<>();
+                if (instance.info.languageContexts.size() == 0) {
+                    lc.put(randomAlphaOfLengthBetween(MIN_LENGTH, MAX_LENGTH), randomStringSet(randomIntBetween(1, MAX_VALUES)));
+                } else {
+                    int toModify = randomInt(instance.info.languageContexts.size()-1);
+                    List<String> keys = new ArrayList<>(instance.info.languageContexts.keySet());
+                    for (int i=0; i<keys.size(); i++) {
+                        String key = keys.get(i);
+                        Set<String> value = instance.info.languageContexts.get(keys.get(i));
+                        if (i == toModify) {
+                            value = mutateStringSet(instance.info.languageContexts.get(keys.get(i)));
+                        }
+                        lc.put(key, value);
+                    }
+                }
+                return new GetScriptLanguageResponse(new ScriptLanguagesInfo(instance.info.typesAllowed, lc));
+        }
+    }
+
+    private static ScriptLanguagesInfo randomInstance() {
+        Map<String,Set<String>> contexts = new HashMap<>();
+        for (String context: randomStringSet(randomIntBetween(1, MAX_VALUES))) {
+            contexts.put(context, randomStringSet(randomIntBetween(1, MAX_VALUES)));
+        }
+        return new ScriptLanguagesInfo(randomStringSet(randomInt(MAX_VALUES)), contexts);
+    }
+
+    private static Set<String> randomStringSet(int numInstances) {
+        Set<String> rand = new HashSet<>(numInstances);
+        for (int i = 0; i < numInstances; i++) {
+            rand.add(randomValueOtherThanMany(rand::contains, () -> randomAlphaOfLengthBetween(MIN_LENGTH, MAX_LENGTH)));
+        }
+        return rand;
+    }
+
+    private static Set<String> mutateStringSet(Set<String> strings) {
+        if (strings.isEmpty()) {
+            return Set.of(randomAlphaOfLengthBetween(MIN_LENGTH, MAX_LENGTH));
+        }
+
+        if (randomBoolean()) {
+            Set<String> updated = new HashSet<>(strings);
+            updated.add(randomValueOtherThanMany(updated::contains, () -> randomAlphaOfLengthBetween(MIN_LENGTH, MAX_LENGTH)));
+            return updated;
+        } else {
+            List<String> sorted = strings.stream().sorted().collect(Collectors.toList());
+            int toRemove = randomInt(sorted.size() - 1);
+            Set<String> updated = new HashSet<>();
+            for (int i = 0; i < sorted.size(); i++) {
+                if (i != toRemove) {
+                    updated.add(sorted.get(i));
+                }
+            }
+            return updated;
+        }
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java b/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java
new file mode 100644
index 0000000000000..38139103ed2ab
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java
@@ -0,0 +1,134 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.script;
+
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.test.ESTestCase;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+public class ScriptLanguagesInfoTests extends ESTestCase {
+    public void testEmptyTypesAllowedReturnsAllTypes() {
+        ScriptService ss = getMockScriptService(Settings.EMPTY);
+        ScriptLanguagesInfo info = ss.getScriptLanguages();
+        ScriptType[] types = ScriptType.values();
+        assertEquals(types.length, info.typesAllowed.size());
+        for(ScriptType type: types) {
+            assertTrue("[" + type.getName() + "] is allowed", info.typesAllowed.contains(type.getName()));
+        }
+    }
+
+    public void testSingleTypesAllowedReturnsThatType() {
+        for (ScriptType type: ScriptType.values()) {
+            ScriptService ss = getMockScriptService(
+                Settings.builder().put("script.allowed_types", type.getName()).build()
+            );
+            ScriptLanguagesInfo info = ss.getScriptLanguages();
+            assertEquals(1, info.typesAllowed.size());
+            assertTrue("[" + type.getName() + "] is allowed", info.typesAllowed.contains(type.getName()));
+        }
+    }
+
+    public void testBothTypesAllowedReturnsBothTypes() {
+        List<String> types = Arrays.stream(ScriptType.values()).map(ScriptType::getName).collect(Collectors.toList());
+        Settings.Builder settings = Settings.builder().putList("script.allowed_types", types);
+        ScriptService ss = getMockScriptService(settings.build());
+        ScriptLanguagesInfo info = ss.getScriptLanguages();
+        assertEquals(types.size(), info.typesAllowed.size());
+        for(String type: types) {
+            assertTrue("[" + type + "] is allowed", info.typesAllowed.contains(type));
+        }
+    }
+
+    private ScriptService getMockScriptService(Settings settings) {
+        MockScriptEngine scriptEngine = new MockScriptEngine(MockScriptEngine.NAME,
+            Collections.singletonMap("test_script", script -> 1),
+            Collections.emptyMap());
+        Map<String, ScriptEngine> engines = Collections.singletonMap(scriptEngine.getType(), scriptEngine);
+
+        return new ScriptService(settings, engines, ScriptModule.CORE_CONTEXTS);
+    }
+
+
+    public interface MiscContext {
+        void execute();
+        Object newInstance();
+    }
+
+    public void testOnlyScriptEngineContextsReturned() {
+        MockScriptEngine scriptEngine = new MockScriptEngine(MockScriptEngine.NAME,
+            Collections.singletonMap("test_script", script -> 1),
+            Collections.emptyMap());
+        Map<String, ScriptEngine> engines = Collections.singletonMap(scriptEngine.getType(), scriptEngine);
+
+        Map<String, ScriptContext<?>> mockContexts =  scriptEngine.getSupportedContexts().stream().collect(Collectors.toMap(
+            c -> c.name,
+            Function.identity()
+        ));
+        String miscContext = "misc_context";
+        assertFalse(mockContexts.containsKey(miscContext));
+
+        Map<String, ScriptContext<?>> mockAndMiscContexts = new HashMap<>(mockContexts);
+        mockAndMiscContexts.put(miscContext, new ScriptContext<>(miscContext, MiscContext.class));
+
+        ScriptService ss = new ScriptService(Settings.EMPTY, engines, mockAndMiscContexts);
+        ScriptLanguagesInfo info = ss.getScriptLanguages();
+
+        assertTrue(info.languageContexts.containsKey(MockScriptEngine.NAME));
+        assertEquals(1, info.languageContexts.size());
+        assertEquals(mockContexts.keySet(), info.languageContexts.get(MockScriptEngine.NAME));
+    }
+
+    public void testContextsAllowedSettingRespected() {
+        MockScriptEngine scriptEngine = new MockScriptEngine(MockScriptEngine.NAME,
+            Collections.singletonMap("test_script", script -> 1),
+            Collections.emptyMap());
+        Map<String, ScriptEngine> engines = Collections.singletonMap(scriptEngine.getType(), scriptEngine);
+        Map<String, ScriptContext<?>> mockContexts =  scriptEngine.getSupportedContexts().stream().collect(Collectors.toMap(
+            c -> c.name,
+            Function.identity()
+        ));
+
+        List<String> allContexts = new ArrayList<>(mockContexts.keySet());
+        List<String> allowed = allContexts.subList(0, allContexts.size()/2);
+        String miscContext = "misc_context";
+        allowed.add(miscContext);
+        // check that allowing more than available doesn't pollute the returned contexts
+        Settings.Builder settings = Settings.builder().putList("script.allowed_contexts", allowed);
+
+        Map<String, ScriptContext<?>> mockAndMiscContexts = new HashMap<>(mockContexts);
+        mockAndMiscContexts.put(miscContext, new ScriptContext<>(miscContext, MiscContext.class));
+
+        ScriptService ss = new ScriptService(settings.build(), engines, mockAndMiscContexts);
+        ScriptLanguagesInfo info = ss.getScriptLanguages();
+
+        assertTrue(info.languageContexts.containsKey(MockScriptEngine.NAME));
+        assertEquals(1, info.languageContexts.size());
+        assertEquals(new HashSet<>(allContexts.subList(0, allContexts.size()/2)), info.languageContexts.get(MockScriptEngine.NAME));
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java b/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
index 7bcc3e58cc2aa..e6bbcf5dd57d0 100644
--- a/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
+++ b/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
@@ -50,6 +50,7 @@
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 import java.util.concurrent.ExecutionException;
 
 import static org.elasticsearch.client.Requests.searchRequest;
@@ -90,6 +91,11 @@ public ScoreScript newInstance(LeafReaderContext ctx) throws IOException {
                     };
                     return context.factoryClazz.cast(factory);
                 }
+
+                @Override
+                public Set<ScriptContext<?>> getSupportedContexts() {
+                    return Set.of(ScoreScript.CONTEXT);
+                }
             };
         }
     }
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
index f242eb8c18506..9495bc444265e 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
@@ -55,6 +55,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Map.Entry;
+import java.util.Set;
 import java.util.concurrent.ExecutionException;
 
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_REPLICAS;
@@ -1155,6 +1156,11 @@ public String execute() {
             };
             return context.factoryClazz.cast(factory);
         }
+
+        @Override
+        public Set<ScriptContext<?>> getSupportedContexts() {
+            return Set.of(TemplateScript.CONTEXT);
+        }
     }
 
     public void testPhraseSuggesterCollate() throws InterruptedException, ExecutionException, IOException {
diff --git a/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java b/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
index e16060a0c6786..e278fbad85aff 100644
--- a/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
+++ b/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
@@ -35,6 +35,7 @@
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 import java.util.function.Function;
 
 import static java.util.Collections.emptyMap;
@@ -304,6 +305,35 @@ public double execute(Map<String, Object> params1, double[] values) {
         throw new IllegalArgumentException("mock script engine does not know how to handle context [" + context.name + "]");
     }
 
+    @Override
+    public Set<ScriptContext<?>> getSupportedContexts() {
+        // TODO(stu): make part of `compile()`
+        return Set.of(
+            FieldScript.CONTEXT,
+            TermsSetQueryScript.CONTEXT,
+            NumberSortScript.CONTEXT,
+            StringSortScript.CONTEXT,
+            IngestScript.CONTEXT,
+            AggregationScript.CONTEXT,
+            IngestConditionalScript.CONTEXT,
+            UpdateScript.CONTEXT,
+            BucketAggregationScript.CONTEXT,
+            BucketAggregationSelectorScript.CONTEXT,
+            SignificantTermsHeuristicScoreScript.CONTEXT,
+            TemplateScript.CONTEXT,
+            FilterScript.CONTEXT,
+            SimilarityScript.CONTEXT,
+            SimilarityWeightScript.CONTEXT,
+            MovingFunctionScript.CONTEXT,
+            ScoreScript.CONTEXT,
+            ScriptedMetricAggContexts.InitScript.CONTEXT,
+            ScriptedMetricAggContexts.MapScript.CONTEXT,
+            ScriptedMetricAggContexts.CombineScript.CONTEXT,
+            ScriptedMetricAggContexts.ReduceScript.CONTEXT,
+            IntervalFilterScript.CONTEXT
+        );
+    }
+
     private Map<String, Object> createVars(Map<String, Object> params) {
         Map<String, Object> vars = new HashMap<>();
         vars.put("params", params);

From cf952e7e9e26a1cbe34e37c2f4926259a47177b2 Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Wed, 4 Dec 2019 07:07:09 +0100
Subject: [PATCH 059/686] [Transform] automatic deletion of old checkpoints
 (#49496)

add automatic deletion of old checkpoints based on count and time
---
 .../transforms/TransformCheckpoint.java       |  2 +-
 .../IndexBasedTransformConfigManager.java     | 76 +++++++++++++---
 .../persistence/TransformConfigManager.java   | 12 +++
 .../persistence/TransformInternalIndex.java   | 76 ++++++++--------
 .../transforms/TransformIndexer.java          | 61 ++++++++++++-
 .../InMemoryTransformConfigManager.java       | 10 +++
 .../TransformConfigManagerTests.java          | 90 +++++++++++++++++++
 7 files changed, 279 insertions(+), 48 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpoint.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpoint.java
index 3e2dd844c362f..8431abc886d85 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpoint.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpoint.java
@@ -50,7 +50,7 @@ public class TransformCheckpoint implements Writeable, ToXContentObject {
     // checkpoint of the indexes (sequence id's)
     public static final ParseField INDICES = new ParseField("indices");
 
-    private static final String NAME = "data_frame_transform_checkpoint";
+    public static final String NAME = "data_frame_transform_checkpoint";
 
     private static final ConstructingObjectParser<TransformCheckpoint, Void> STRICT_PARSER = createParser(false);
     private static final ConstructingObjectParser<TransformCheckpoint, Void> LENIENT_PARSER = createParser(true);
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/IndexBasedTransformConfigManager.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/IndexBasedTransformConfigManager.java
index 5b747e9de01e1..e3345aa6a2d83 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/IndexBasedTransformConfigManager.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/IndexBasedTransformConfigManager.java
@@ -39,6 +39,7 @@
 import org.elasticsearch.index.query.BoolQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.index.reindex.AbstractBulkByScrollRequest;
 import org.elasticsearch.index.reindex.BulkByScrollResponse;
 import org.elasticsearch.index.reindex.DeleteByQueryAction;
 import org.elasticsearch.index.reindex.DeleteByQueryRequest;
@@ -63,6 +64,7 @@
 import java.util.List;
 import java.util.Set;
 
+import static org.elasticsearch.index.mapper.MapperService.SINGLE_MAPPING_NAME;
 import static org.elasticsearch.xpack.core.ClientHelper.TRANSFORM_ORIGIN;
 import static org.elasticsearch.xpack.core.ClientHelper.executeAsyncWithOrigin;
 
@@ -146,16 +148,18 @@ public void updateTransformConfiguration(
 
     @Override
     public void deleteOldTransformConfigurations(String transformId, ActionListener<Boolean> listener) {
-        DeleteByQueryRequest deleteByQueryRequest = new DeleteByQueryRequest(
+        DeleteByQueryRequest deleteByQueryRequest = createDeleteByQueryRequest();
+        deleteByQueryRequest.indices(
             TransformInternalIndexConstants.INDEX_NAME_PATTERN,
             TransformInternalIndexConstants.INDEX_NAME_PATTERN_DEPRECATED
-        ).setQuery(
+        );
+        deleteByQueryRequest.setQuery(
             QueryBuilders.constantScoreQuery(
                 QueryBuilders.boolQuery()
                     .mustNot(QueryBuilders.termQuery("_index", TransformInternalIndexConstants.LATEST_INDEX_NAME))
                     .filter(QueryBuilders.termQuery("_id", TransformConfig.documentId(transformId)))
             )
-        ).setIndicesOptions(IndicesOptions.lenientExpandOpen());
+        );
 
         executeAsyncWithOrigin(
             client,
@@ -177,17 +181,18 @@ public void deleteOldTransformConfigurations(String transformId, ActionListener<
 
     @Override
     public void deleteOldTransformStoredDocuments(String transformId, ActionListener<Boolean> listener) {
-        DeleteByQueryRequest deleteByQueryRequest = new DeleteByQueryRequest(
+        DeleteByQueryRequest deleteByQueryRequest = createDeleteByQueryRequest();
+        deleteByQueryRequest.indices(
             TransformInternalIndexConstants.INDEX_NAME_PATTERN,
             TransformInternalIndexConstants.INDEX_NAME_PATTERN_DEPRECATED
-        ).setQuery(
+        );
+        deleteByQueryRequest.setQuery(
             QueryBuilders.constantScoreQuery(
                 QueryBuilders.boolQuery()
                     .mustNot(QueryBuilders.termQuery("_index", TransformInternalIndexConstants.LATEST_INDEX_NAME))
                     .filter(QueryBuilders.termQuery("_id", TransformStoredDoc.documentId(transformId)))
             )
-        ).setIndicesOptions(IndicesOptions.lenientExpandOpen());
-
+        );
         executeAsyncWithOrigin(
             client,
             TRANSFORM_ORIGIN,
@@ -206,6 +211,41 @@ public void deleteOldTransformStoredDocuments(String transformId, ActionListener
         );
     }
 
+    @Override
+    public void deleteOldCheckpoints(String transformId, long deleteCheckpointsBelow, long deleteOlderThan, ActionListener<Long> listener) {
+        DeleteByQueryRequest deleteByQueryRequest = createDeleteByQueryRequest();
+        deleteByQueryRequest.indices(
+            TransformInternalIndexConstants.INDEX_NAME_PATTERN,
+            TransformInternalIndexConstants.INDEX_NAME_PATTERN_DEPRECATED
+        );
+        deleteByQueryRequest.setQuery(
+            QueryBuilders.boolQuery()
+                .filter(QueryBuilders.termQuery(TransformField.ID.getPreferredName(), transformId))
+                .filter(QueryBuilders.termQuery(TransformField.INDEX_DOC_TYPE.getPreferredName(), TransformCheckpoint.NAME))
+                .filter(QueryBuilders.rangeQuery(TransformCheckpoint.CHECKPOINT.getPreferredName()).lt(deleteCheckpointsBelow))
+                .filter(
+                    QueryBuilders.rangeQuery(TransformField.TIMESTAMP_MILLIS.getPreferredName()).lt(deleteOlderThan).format("epoch_millis")
+                )
+        );
+        logger.debug("Deleting old checkpoints using {}", deleteByQueryRequest.getSearchRequest());
+        executeAsyncWithOrigin(
+            client,
+            TRANSFORM_ORIGIN,
+            DeleteByQueryAction.INSTANCE,
+            deleteByQueryRequest,
+            ActionListener.wrap(response -> {
+                if ((response.getBulkFailures().isEmpty() && response.getSearchFailures().isEmpty()) == false) {
+                    Tuple<RestStatus, Throwable> statusAndReason = getStatusAndReason(response);
+                    listener.onFailure(
+                        new ElasticsearchStatusException(statusAndReason.v2().getMessage(), statusAndReason.v1(), statusAndReason.v2())
+                    );
+                    return;
+                }
+                listener.onResponse(response.getDeleted());
+            }, listener::onFailure)
+        );
+    }
+
     private void putTransformConfiguration(
         TransformConfig transformConfig,
         DocWriteRequest.OpType optType,
@@ -419,9 +459,7 @@ public void expandTransformIds(
 
     @Override
     public void deleteTransform(String transformId, ActionListener<Boolean> listener) {
-        DeleteByQueryRequest request = new DeleteByQueryRequest().setAbortOnVersionConflict(false); // since these documents are not
-                                                                                                    // updated, a conflict just means it was
-                                                                                                    // deleted previously
+        DeleteByQueryRequest request = createDeleteByQueryRequest();
 
         request.indices(TransformInternalIndexConstants.INDEX_NAME_PATTERN, TransformInternalIndexConstants.INDEX_NAME_PATTERN_DEPRECATED);
         QueryBuilder query = QueryBuilders.termQuery(TransformField.ID.getPreferredName(), transformId);
@@ -675,4 +713,22 @@ private static Tuple<RestStatus, Throwable> getStatusAndReason(final BulkByScrol
         }
         return new Tuple<>(status, reason);
     }
+
+    /**
+     * Create DBQ request with good defaults
+     *
+     * @return new DeleteByQueryRequest with some defaults set
+     */
+    private static DeleteByQueryRequest createDeleteByQueryRequest() {
+
+        DeleteByQueryRequest deleteByQuery = new DeleteByQueryRequest();
+
+        deleteByQuery.setAbortOnVersionConflict(false)
+            .setSlices(AbstractBulkByScrollRequest.AUTO_SLICES)
+            .setIndicesOptions(IndicesOptions.lenientExpandOpen());
+
+        // disable scoring by using index order
+        deleteByQuery.getSearchRequest().source().sort(SINGLE_MAPPING_NAME);
+        return deleteByQuery;
+    }
 }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManager.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManager.java
index 4d512166b1d16..61c639964e963 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManager.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManager.java
@@ -72,6 +72,18 @@ void updateTransformConfiguration(
      */
     void deleteOldTransformStoredDocuments(String transformId, ActionListener<Boolean> listener);
 
+    /**
+     * This deletes stored checkpoint documents for the given transformId, based on number and age.
+     *
+     * Both criteria MUST apply for the deletion to happen.
+     *
+     * @param transformId The transform ID referenced by the documents
+     * @param deleteCheckpointsBelow checkpoints lower than this to delete
+     * @param deleteOlderThan checkpoints older than this to delete
+     * @param listener listener to alert on completion, returning number of deleted checkpoints
+     */
+    void deleteOldCheckpoints(String transformId, long deleteCheckpointsBelow, long deleteOlderThan, ActionListener<Long> listener);
+
     /**
      * Get a stored checkpoint, requires the transform id as well as the checkpoint id
      *
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
index d0b94bf6e3e52..2951ade8f47fb 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.xpack.core.transform.TransformField;
 import org.elasticsearch.xpack.core.transform.transforms.DestConfig;
 import org.elasticsearch.xpack.core.transform.transforms.SourceConfig;
+import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpoint;
 import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerStats;
 import org.elasticsearch.xpack.core.transform.transforms.TransformProgress;
 import org.elasticsearch.xpack.core.transform.transforms.TransformState;
@@ -54,8 +55,9 @@ public final class TransformInternalIndex {
      *                  progress::docs_processed, progress::docs_indexed,
      *                  stats::exponential_avg_checkpoint_duration_ms, stats::exponential_avg_documents_indexed,
      *                  stats::exponential_avg_documents_processed
-     *
+     * version 3 (7.5): rename to .transform-internal-xxx
      * version 4 (7.6): state::should_stop_at_checkpoint
+     *                  checkpoint::checkpoint
      */
 
     // constants for mappings
@@ -77,14 +79,16 @@ public final class TransformInternalIndex {
 
     public static IndexTemplateMetaData getIndexTemplateMetaData() throws IOException {
         IndexTemplateMetaData transformTemplate = IndexTemplateMetaData.builder(TransformInternalIndexConstants.LATEST_INDEX_VERSIONED_NAME)
-                .patterns(Collections.singletonList(TransformInternalIndexConstants.LATEST_INDEX_VERSIONED_NAME))
-                .version(Version.CURRENT.id)
-                .settings(Settings.builder()
-                        // the configurations are expected to be small
-                        .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-                        .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-1"))
-                .putMapping(MapperService.SINGLE_MAPPING_NAME, Strings.toString(mappings()))
-                .build();
+            .patterns(Collections.singletonList(TransformInternalIndexConstants.LATEST_INDEX_VERSIONED_NAME))
+            .version(Version.CURRENT.id)
+            .settings(
+                Settings.builder()
+                    // the configurations are expected to be small
+                    .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                    .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-1")
+            )
+            .putMapping(MapperService.SINGLE_MAPPING_NAME, Strings.toString(mappings()))
+            .build();
         return transformTemplate;
     }
 
@@ -92,10 +96,12 @@ public static IndexTemplateMetaData getAuditIndexTemplateMetaData() throws IOExc
         IndexTemplateMetaData transformTemplate = IndexTemplateMetaData.builder(TransformInternalIndexConstants.AUDIT_INDEX)
             .patterns(Collections.singletonList(TransformInternalIndexConstants.AUDIT_INDEX_PREFIX + "*"))
             .version(Version.CURRENT.id)
-            .settings(Settings.builder()
-                // the audits are expected to be small
-                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-                .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-1"))
+            .settings(
+                Settings.builder()
+                    // the audits are expected to be small
+                    .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                    .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-1")
+            )
             .putMapping(MapperService.SINGLE_MAPPING_NAME, Strings.toString(auditMappings()))
             .putAlias(AliasMetaData.builder(TransformInternalIndexConstants.AUDIT_INDEX_READ_ALIAS))
             .build();
@@ -107,26 +113,27 @@ private static XContentBuilder auditMappings() throws IOException {
         builder.startObject(SINGLE_MAPPING_NAME);
         addMetaInformation(builder);
         builder.field(DYNAMIC, "false");
-        builder.startObject(PROPERTIES)
-            .startObject(TRANSFORM_ID)
-            .field(TYPE, KEYWORD)
-            .endObject()
-            .startObject(AbstractAuditMessage.LEVEL.getPreferredName())
-            .field(TYPE, KEYWORD)
-            .endObject()
-            .startObject(AbstractAuditMessage.MESSAGE.getPreferredName())
-            .field(TYPE, TEXT)
-            .startObject(FIELDS)
-            .startObject(RAW)
-            .field(TYPE, KEYWORD)
-            .endObject()
-            .endObject()
+        builder
+            .startObject(PROPERTIES)
+                .startObject(TRANSFORM_ID)
+                    .field(TYPE, KEYWORD)
+                .endObject()
+                .startObject(AbstractAuditMessage.LEVEL.getPreferredName())
+                    .field(TYPE, KEYWORD)
+                .endObject()
+                .startObject(AbstractAuditMessage.MESSAGE.getPreferredName())
+                    .field(TYPE, TEXT)
+                .startObject(FIELDS)
+                    .startObject(RAW)
+                        .field(TYPE, KEYWORD)
+                    .endObject()
+                .endObject()
             .endObject()
             .startObject(AbstractAuditMessage.TIMESTAMP.getPreferredName())
-            .field(TYPE, DATE)
+                .field(TYPE, DATE)
             .endObject()
             .startObject(AbstractAuditMessage.NODE_NAME.getPreferredName())
-            .field(TYPE, KEYWORD)
+                .field(TYPE, KEYWORD)
             .endObject()
             .endObject()
             .endObject()
@@ -167,7 +174,6 @@ public static XContentBuilder mappings(XContentBuilder builder) throws IOExcepti
         return builder;
     }
 
-
     private static XContentBuilder addTransformStoredDocMappings(XContentBuilder builder) throws IOException {
         return builder
             .startObject(TransformStoredDoc.STATE_FIELD.getPreferredName())
@@ -254,9 +260,6 @@ private static XContentBuilder addTransformStoredDocMappings(XContentBuilder bui
                     .endObject()
                 .endObject()
             .endObject();
-            // This is obsolete and can be removed for future versions of the index, but is left here as a warning/reminder that
-            // we cannot declare this field differently in version 1 of the internal index as it would cause a mapping clash
-            // .startObject("checkpointing").field(ENABLED, false).endObject();
     }
 
     public static XContentBuilder addTransformsConfigMappings(XContentBuilder builder) throws IOException {
@@ -299,6 +302,9 @@ private static XContentBuilder addTransformCheckpointMappings(XContentBuilder bu
             .endObject()
             .startObject(TransformField.TIME_UPPER_BOUND_MILLIS.getPreferredName())
                 .field(TYPE, DATE)
+            .endObject()
+            .startObject(TransformCheckpoint.CHECKPOINT.getPreferredName())
+                .field(TYPE, LONG)
             .endObject();
     }
 
@@ -310,9 +316,7 @@ private static XContentBuilder addTransformCheckpointMappings(XContentBuilder bu
      * @throws IOException On write error
      */
     private static XContentBuilder addMetaInformation(XContentBuilder builder) throws IOException {
-        return builder.startObject("_meta")
-                    .field("version", Version.CURRENT)
-                .endObject();
+        return builder.startObject("_meta").field("version", Version.CURRENT).endObject();
     }
 
     /**
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformIndexer.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformIndexer.java
index 01c2b8c4329b1..0848fc21217e5 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformIndexer.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformIndexer.java
@@ -79,8 +79,14 @@ private enum RunState {
 
     public static final int MINIMUM_PAGE_SIZE = 10;
     public static final String COMPOSITE_AGGREGATION_NAME = "_transform";
+
     private static final Logger logger = LogManager.getLogger(TransformIndexer.class);
 
+    // constant for checkpoint retention, static for now
+    private static final long NUMBER_OF_CHECKPOINTS_TO_KEEP = 10;
+    private static final long RETENTION_OF_CHECKPOINTS_MS = 864000000L; // 10 days
+    private static final long CHECKPOINT_CLEANUP_INTERVAL = 100L; // every 100 checkpoints
+
     protected final TransformConfigManager transformsConfigManager;
     private final CheckpointProvider checkpointProvider;
     private final TransformProgressGatherer progressGatherer;
@@ -111,6 +117,8 @@ private enum RunState {
     private volatile Map<String, Set<String>> changedBuckets;
     private volatile Map<String, Object> changedBucketsAfterKey;
 
+    private volatile long lastCheckpointCleanup = 0L;
+
     public TransformIndexer(
         Executor executor,
         TransformConfigManager transformsConfigManager,
@@ -375,7 +383,13 @@ protected void onFinish(ActionListener<Void> listener) {
             if (context.shouldStopAtCheckpoint()) {
                 stop();
             }
-            listener.onResponse(null);
+
+            if (checkpoint - lastCheckpointCleanup > CHECKPOINT_CLEANUP_INTERVAL) {
+                // delete old checkpoints, on a failure we keep going
+                cleanupOldCheckpoints(listener);
+            } else {
+                listener.onResponse(null);
+            }
         } catch (Exception e) {
             listener.onFailure(e);
         }
@@ -492,6 +506,44 @@ synchronized void handleFailure(Exception e) {
         }
     }
 
+    /**
+     * Cleanup old checkpoints
+     *
+     * @param listener listener to call after done
+     */
+    private void cleanupOldCheckpoints(ActionListener<Void> listener) {
+        long now = getTime();
+        long checkpointLowerBound = context.getCheckpoint() - NUMBER_OF_CHECKPOINTS_TO_KEEP;
+        long lowerBoundEpochMs = now - RETENTION_OF_CHECKPOINTS_MS;
+
+        if (checkpointLowerBound > 0 && lowerBoundEpochMs > 0) {
+            transformsConfigManager.deleteOldCheckpoints(
+                transformConfig.getId(),
+                checkpointLowerBound,
+                lowerBoundEpochMs,
+                ActionListener.wrap(deletes -> {
+                    logger.debug("[{}] deleted [{}] outdated checkpoints", getJobId(), deletes);
+                    listener.onResponse(null);
+                    lastCheckpointCleanup = context.getCheckpoint();
+                }, e -> {
+                    logger.warn(
+                        new ParameterizedMessage("[{}] failed to cleanup old checkpoints, retrying after next checkpoint", getJobId()),
+                        e
+                    );
+                    auditor.warning(
+                        getJobId(),
+                        "Failed to cleanup old checkpoints, retrying after next checkpoint. Exception: " + e.getMessage()
+                    );
+
+                    listener.onResponse(null);
+                })
+            );
+        } else {
+            logger.debug("[{}] checked for outdated checkpoints", getJobId());
+            listener.onResponse(null);
+        }
+    }
+
     private void sourceHasChanged(ActionListener<Boolean> hasChangedListener) {
         checkpointProvider.sourceHasChanged(getLastCheckpoint(), ActionListener.wrap(hasChanged -> {
             logger.trace("[{}] change detected [{}].", getJobId(), hasChanged);
@@ -788,6 +840,13 @@ protected void failIndexer(String failureMessage) {
         context.markAsFailed(failureMessage);
     }
 
+    /*
+     * Get the current time, abstracted for the purpose of testing
+     */
+    long getTime() {
+        return System.currentTimeMillis();
+    }
+
     /**
      * Indicates if an audit message should be written when onFinish is called for the given checkpoint
      * We audit the first checkpoint, and then every 10 checkpoints until completedCheckpoint == 99
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/InMemoryTransformConfigManager.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/InMemoryTransformConfigManager.java
index 3b084c01a8a46..c52e8dea8fde2 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/InMemoryTransformConfigManager.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/InMemoryTransformConfigManager.java
@@ -81,6 +81,16 @@ public void deleteOldTransformStoredDocuments(String transformId, ActionListener
         listener.onResponse(true);
     }
 
+    @Override
+    public void deleteOldCheckpoints(String transformId, long deleteCheckpointsBelow, long deleteOlderThan, ActionListener<Long> listener) {
+        List<TransformCheckpoint> checkpointsById = checkpoints.get(transformId);
+        int sizeBeforeDelete = checkpointsById.size();
+        if (checkpointsById != null) {
+            checkpointsById.removeIf(cp -> { return cp.getCheckpoint() < deleteCheckpointsBelow && cp.getTimestamp() < deleteOlderThan; });
+        }
+        listener.onResponse(Long.valueOf(sizeBeforeDelete - checkpointsById.size()));
+    }
+
     @Override
     public void getTransformCheckpoint(String transformId, long checkpoint, ActionListener<TransformCheckpoint> resultListener) {
         List<TransformCheckpoint> checkpointsById = checkpoints.get(transformId);
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManagerTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManagerTests.java
index c3248a56afe92..818941bac5837 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManagerTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManagerTests.java
@@ -425,4 +425,94 @@ public void testDeleteOldTransformStoredDocuments() throws Exception {
             is(true)
         );
     }
+
+    public void testDeleteOldCheckpoints() throws InterruptedException {
+        String transformId = randomAlphaOfLengthBetween(1, 10);
+        long timestamp = System.currentTimeMillis() - randomLongBetween(20000, 40000);
+
+        // create some other docs to check they are not getting accidentally deleted
+        TransformStoredDoc storedDocs = TransformStoredDocTests.randomTransformStoredDoc(transformId);
+        SeqNoPrimaryTermAndIndex firstIndex = new SeqNoPrimaryTermAndIndex(0, 1, TransformInternalIndexConstants.LATEST_INDEX_NAME);
+        assertAsync(listener -> transformConfigManager.putOrUpdateTransformStoredDoc(storedDocs, null, listener), firstIndex, null, null);
+
+        TransformConfig transformConfig = TransformConfigTests.randomTransformConfig(transformId);
+        assertAsync(listener -> transformConfigManager.putTransformConfiguration(transformConfig, listener), true, null, null);
+
+        // create 100 checkpoints
+        for (int i = 1; i <= 100; i++) {
+            TransformCheckpoint checkpoint = new TransformCheckpoint(
+                transformId,
+                timestamp + i * 200,
+                i,
+                Collections.emptyMap(),
+                timestamp - 100 + i * 200
+            );
+            assertAsync(listener -> transformConfigManager.putTransformCheckpoint(checkpoint, listener), true, null, null);
+        }
+
+        // read a random checkpoint
+        int randomCheckpoint = randomIntBetween(1, 100);
+        TransformCheckpoint checkpointExpected = new TransformCheckpoint(
+            transformId,
+            timestamp + randomCheckpoint * 200,
+            randomCheckpoint,
+            Collections.emptyMap(),
+            timestamp - 100 + randomCheckpoint * 200
+        );
+
+        assertAsync(
+            listener -> transformConfigManager.getTransformCheckpoint(transformId, randomCheckpoint, listener),
+            checkpointExpected,
+            null,
+            null
+        );
+
+        // test delete based on checkpoint number (time would allow more)
+        assertAsync(
+            listener -> transformConfigManager.deleteOldCheckpoints(transformId, 11L, timestamp + 1 + 20L * 200, listener),
+            10L,
+            null,
+            null
+        );
+
+        // test delete based on time (checkpoint number would allow more)
+        assertAsync(
+            listener -> transformConfigManager.deleteOldCheckpoints(transformId, 30L, timestamp + 1 + 20L * 200, listener),
+            10L,
+            null,
+            null
+        );
+
+        // zero delete
+        assertAsync(
+            listener -> transformConfigManager.deleteOldCheckpoints(transformId, 30L, timestamp + 1 + 20L * 200, listener),
+            0L,
+            null,
+            null
+        );
+
+        // delete the rest
+        assertAsync(
+            listener -> transformConfigManager.deleteOldCheckpoints(transformId, 101L, timestamp + 1 + 100L * 200, listener),
+            80L,
+            null,
+            null
+        );
+
+        // test that the other docs are still there
+        assertAsync(
+            listener -> transformConfigManager.getTransformStoredDoc(transformId, listener),
+            Tuple.tuple(storedDocs, firstIndex),
+            null,
+            null
+        );
+
+        assertAsync(
+            listener -> transformConfigManager.getTransformConfiguration(transformConfig.getId(), listener),
+            transformConfig,
+            null,
+            null
+        );
+
+    }
 }

From 03bf4fc09f77ba065d576ae4d6f63a9c9a816608 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Wed, 4 Dec 2019 08:47:40 +0000
Subject: [PATCH 060/686] Fixes a bug in interval filter serialization (#49793)

There is a possible NPE in IntervalFilter xcontent serialization when scripts are
used, and `equals` and `hashCode` are also incorrectly implemented for script
filters.  This commit fixes both.
---
 .../index/query/IntervalsSourceProvider.java       | 14 +++++++++-----
 .../index/query/IntervalQueryBuilderTests.java     |  7 ++++++-
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
index 81cc1524549a8..97093f0c92fc9 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
@@ -749,12 +749,13 @@ public boolean equals(Object o) {
             if (o == null || getClass() != o.getClass()) return false;
             IntervalFilter that = (IntervalFilter) o;
             return Objects.equals(type, that.type) &&
+                Objects.equals(script, that.script) &&
                 Objects.equals(filter, that.filter);
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(type, filter);
+            return Objects.hash(type, filter, script);
         }
 
         @Override
@@ -773,10 +774,13 @@ public void writeTo(StreamOutput out) throws IOException {
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
             builder.startObject();
-            builder.field(type);
-            builder.startObject();
-            filter.toXContent(builder, params);
-            builder.endObject();
+            if (filter != null) {
+                builder.startObject(type);
+                filter.toXContent(builder, params);
+                builder.endObject();
+            } else {
+                builder.field(Script.SCRIPT_PARSE_FIELD.getPreferredName(), script);
+            }
             builder.endObject();
             return builder;
         }
diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index da1da5ce54b69..c5cfca0b7fe9f 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptService;
+import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.test.AbstractQueryTestCase;
 
 import java.io.IOException;
@@ -114,7 +115,11 @@ private IntervalsSourceProvider createRandomSource(int depth) {
 
     private IntervalsSourceProvider.IntervalFilter createRandomFilter(int depth) {
         if (depth < 3 && randomInt(20) > 18) {
-            return new IntervalsSourceProvider.IntervalFilter(createRandomSource(depth + 1), randomFrom(filters));
+            if (randomBoolean()) {
+                return new IntervalsSourceProvider.IntervalFilter(createRandomSource(depth + 1), randomFrom(filters));
+            }
+            return new IntervalsSourceProvider.IntervalFilter(
+                new Script(ScriptType.INLINE, "mockscript", "1", Collections.emptyMap()));
         }
         return null;
     }

From ad604760da73a7f256653e607175149e38c15ab5 Mon Sep 17 00:00:00 2001
From: Ignacio Vera <ivera@apache.org>
Date: Wed, 4 Dec 2019 10:58:44 +0100
Subject: [PATCH 061/686] Add reusable HistogramValue object   (#49799)

Adds a reusable implementation of HistogramValue so we do not create
an object per document.
---
 .../mapper/HistogramFieldMapper.java          | 107 ++++++++++--------
 1 file changed, 58 insertions(+), 49 deletions(-)

diff --git a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapper.java b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapper.java
index 6ef920bd33fa3..b22f6eb0573df 100644
--- a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapper.java
+++ b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapper.java
@@ -18,11 +18,11 @@
 import org.apache.lucene.search.DocValuesFieldExistsQuery;
 import org.apache.lucene.search.Query;
 import org.apache.lucene.search.SortField;
+import org.apache.lucene.store.ByteArrayDataInput;
+import org.apache.lucene.store.ByteBuffersDataOutput;
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.Explicit;
 import org.elasticsearch.common.ParseField;
-import org.elasticsearch.common.io.stream.ByteBufferStreamInput;
-import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
@@ -49,7 +49,6 @@
 import org.elasticsearch.search.MultiValueMode;
 
 import java.io.IOException;
-import java.nio.ByteBuffer;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
@@ -202,7 +201,9 @@ public AtomicHistogramFieldData load(LeafReaderContext context) {
                                 public HistogramValues getHistogramValues() throws IOException {
                                     try {
                                         final BinaryDocValues values = DocValues.getBinary(context.reader(), fieldName);
+                                        final InternalHistogramValue value = new InternalHistogramValue();
                                         return new HistogramValues() {
+
                                             @Override
                                             public boolean advanceExact(int doc) throws IOException {
                                                 return values.advanceExact(doc);
@@ -211,7 +212,8 @@ public boolean advanceExact(int doc) throws IOException {
                                             @Override
                                             public HistogramValue histogram() throws IOException {
                                                 try {
-                                                    return getHistogramValue(values.binaryValue());
+                                                    value.reset(values.binaryValue());
+                                                    return value;
                                                 } catch (IOException e) {
                                                     throw new IOException("Cannot load doc value", e);
                                                 }
@@ -220,7 +222,6 @@ public HistogramValue histogram() throws IOException {
                                     } catch (IOException e) {
                                         throw new IOException("Cannot load doc values", e);
                                     }
-
                                 }
 
                                 @Override
@@ -259,44 +260,6 @@ public SortField sortField(Object missingValue, MultiValueMode sortMode,
                         }
                     };
                 }
-
-                private HistogramValue getHistogramValue(final BytesRef bytesRef) throws IOException {
-                    final ByteBufferStreamInput streamInput = new ByteBufferStreamInput(
-                        ByteBuffer.wrap(bytesRef.bytes, bytesRef.offset, bytesRef.length));
-                    return new HistogramValue() {
-                        double value;
-                        int count;
-                        boolean isExhausted;
-
-                        @Override
-                        public boolean next() throws IOException {
-                            if (streamInput.available() > 0) {
-                                count = streamInput.readVInt();
-                                value = streamInput.readDouble();
-                                return true;
-                            }
-                            isExhausted = true;
-                            return false;
-                        }
-
-                        @Override
-                        public double value() {
-                            if (isExhausted) {
-                                throw new IllegalArgumentException("histogram already exhausted");
-                            }
-                            return value;
-                        }
-
-                        @Override
-                        public int count() {
-                            if (isExhausted) {
-                                throw new IllegalArgumentException("histogram already exhausted");
-                            }
-                            return count;
-                        }
-                    };
-                }
-
             };
         }
 
@@ -395,7 +358,7 @@ public void parse(ParseContext context) throws IOException {
                     "[" + COUNTS_FIELD.getPreferredName() +"] but got [" + values.size() + " != " + counts.size() +"]");
             }
             if (fieldType().hasDocValues()) {
-                BytesStreamOutput streamOutput = new BytesStreamOutput();
+                ByteBuffersDataOutput dataOutput = new ByteBuffersDataOutput();
                 for (int i = 0; i < values.size(); i++) {
                     int count = counts.get(i);
                     if (count < 0) {
@@ -403,13 +366,12 @@ public void parse(ParseContext context) throws IOException {
                             + name() + "], ["+ COUNTS_FIELD + "] elements must be >= 0 but got " + counts.get(i));
                     } else if (count > 0) {
                         // we do not add elements with count == 0
-                        streamOutput.writeVInt(count);
-                        streamOutput.writeDouble(values.get(i));
+                        dataOutput.writeVInt(count);
+                        dataOutput.writeLong(Double.doubleToRawLongBits(values.get(i)));
                     }
                 }
-
-                Field field = new BinaryDocValuesField(simpleName(), streamOutput.bytes().toBytesRef());
-                streamOutput.close();
+                BytesRef docValue = new BytesRef(dataOutput.toArrayCopy(), 0, Math.toIntExact(dataOutput.size()));
+                Field field = new BinaryDocValuesField(simpleName(), docValue);
                 if (context.doc().getByKey(fieldType().name()) != null) {
                     throw new IllegalArgumentException("Field [" + name() + "] of type [" + typeName() +
                         "] doesn't not support indexing multiple values for the same field in the same document");
@@ -439,4 +401,51 @@ protected void doXContentBody(XContentBuilder builder, boolean includeDefaults,
             builder.field(Names.IGNORE_MALFORMED, ignoreMalformed.value());
         }
     }
+
+    /** re-usable {@link HistogramValue} implementation */
+    private static class InternalHistogramValue extends HistogramValue {
+        double value;
+        int count;
+        boolean isExhausted;
+        ByteArrayDataInput dataInput;
+
+        InternalHistogramValue() {
+            dataInput = new ByteArrayDataInput();
+        }
+
+        /** reset the value for the histogram */
+        void reset(BytesRef bytesRef) {
+            dataInput.reset(bytesRef.bytes, bytesRef.offset, bytesRef.length);
+            isExhausted = false;
+            value = 0;
+            count = 0;
+        }
+
+        @Override
+        public boolean next() {
+            if (dataInput.eof() == false) {
+                count = dataInput.readVInt();
+                value = Double.longBitsToDouble(dataInput.readLong());
+                return true;
+            }
+            isExhausted = true;
+            return false;
+        }
+
+        @Override
+        public double value() {
+            if (isExhausted) {
+                throw new IllegalArgumentException("histogram already exhausted");
+            }
+            return value;
+        }
+
+        @Override
+        public int count() {
+            if (isExhausted) {
+                throw new IllegalArgumentException("histogram already exhausted");
+            }
+            return count;
+        }
+    }
 }

From 9912f982ecaaec5d5ee3920e0064328fe7d7d573 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Wed, 4 Dec 2019 11:13:32 +0100
Subject: [PATCH 062/686] Fix invalid break iterator highlighting on keyword
 field (#49566)

By default the unified highlighter splits the input into passages using
a sentence break iterator. However we don't check if the field is tokenized
or not so `keyword` field also applies the break iterator even though they can
only match on the entire content. This means that by default we'll split the
content of a `keyword` field on sentence break if the requested number of fragments
is set to a value different than 0 (default to 5). This commit changes this behavior
to ignore the break iterator on non-tokenized fields (keyword) in order to always
highlight the entire values. The number of requested fragments control the number of
matched values are returned but the boundary_scanner_type is now ignored.
Note that this is the behavior in 6x but some refactoring of the Lucene's highlighter
exposed this bug in Elasticsearch 7x.
---
 .../highlight/UnifiedHighlighter.java         |  8 +++--
 .../highlight/HighlighterSearchIT.java        | 29 +++++++++++++++++++
 2 files changed, 34 insertions(+), 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/search/fetch/subphase/highlight/UnifiedHighlighter.java b/server/src/main/java/org/elasticsearch/search/fetch/subphase/highlight/UnifiedHighlighter.java
index e02e628418569..81f700920f827 100644
--- a/server/src/main/java/org/elasticsearch/search/fetch/subphase/highlight/UnifiedHighlighter.java
+++ b/server/src/main/java/org/elasticsearch/search/fetch/subphase/highlight/UnifiedHighlighter.java
@@ -67,7 +67,7 @@ public HighlightField highlight(HighlighterContext highlighterContext) {
         final int maxAnalyzedOffset = context.getIndexSettings().getHighlightMaxAnalyzedOffset();
 
         List<Snippet> snippets = new ArrayList<>();
-        int numberOfFragments;
+        int numberOfFragments = field.fieldOptions().numberOfFragments();
         try {
 
             final Analyzer analyzer = getAnalyzer(context.getMapperService().documentMapper(), hitContext);
@@ -89,14 +89,16 @@ public HighlightField highlight(HighlighterContext highlighterContext) {
                         "This maximum can be set by changing the [" + IndexSettings.MAX_ANALYZED_OFFSET_SETTING.getKey() +
                         "] index level setting. " + "For large texts, indexing with offsets or term vectors is recommended!");
             }
-            if (field.fieldOptions().numberOfFragments() == 0) {
+            if (numberOfFragments == 0
+                    // non-tokenized fields should not use any break iterator (ignore boundaryScannerType)
+                    || fieldType.tokenized() == false) {
                 // we use a control char to separate values, which is the only char that the custom break iterator
                 // breaks the text on, so we don't lose the distinction between the different values of a field and we
                 // get back a snippet per value
                 CustomSeparatorBreakIterator breakIterator = new CustomSeparatorBreakIterator(MULTIVAL_SEP_CHAR);
                 highlighter = new CustomUnifiedHighlighter(searcher, analyzer, offsetSource, passageFormatter,
                     field.fieldOptions().boundaryScannerLocale(), breakIterator, fieldValue, field.fieldOptions().noMatchSize());
-                numberOfFragments = fieldValues.size(); // we are highlighting the whole content, one snippet per value
+                numberOfFragments = numberOfFragments == 0 ? fieldValues.size() : numberOfFragments;
             } else {
                 //using paragraph separator we make sure that each field value holds a discrete passage for highlighting
                 BreakIterator bi = getBreakIterator(field);
diff --git a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
index 40ac220ec4853..539f9d1977a6c 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
@@ -120,6 +120,35 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
         return Arrays.asList(InternalSettingsPlugin.class, MockKeywordPlugin.class, MockAnalysisPlugin.class);
     }
 
+    public void testHighlightingWithKeywordIgnoreBoundaryScanner() throws IOException {
+        XContentBuilder mappings = jsonBuilder();
+        mappings.startObject();
+        mappings.startObject("type")
+            .startObject("properties")
+                .startObject("tags")
+                    .field("type", "keyword")
+                .endObject()
+            .endObject().endObject();
+        mappings.endObject();
+        assertAcked(prepareCreate("test")
+            .addMapping("type", mappings));
+        client().prepareIndex("test").setId("1")
+            .setSource(jsonBuilder().startObject().array("tags", "foo bar", "foo bar", "foo bar", "foo baz").endObject())
+            .get();
+        client().prepareIndex("test").setId("2")
+            .setSource(jsonBuilder().startObject().array("tags", "foo baz", "foo baz", "foo baz", "foo bar").endObject())
+            .get();
+        refresh();
+
+        for (BoundaryScannerType scanner : BoundaryScannerType.values()) {
+            SearchResponse search = client().prepareSearch().setQuery(matchQuery("tags", "foo bar"))
+                .highlighter(new HighlightBuilder().field(new Field("tags")).numOfFragments(2).boundaryScannerType(scanner)).get();
+            assertHighlight(search, 0, "tags", 0, 2, equalTo("<em>foo bar</em>"));
+            assertHighlight(search, 0, "tags", 1, 2, equalTo("<em>foo bar</em>"));
+            assertHighlight(search, 1, "tags", 0, 1, equalTo("<em>foo bar</em>"));
+        }
+    }
+
     public void testHighlightingWithStoredKeyword() throws IOException {
         XContentBuilder mappings = jsonBuilder();
         mappings.startObject();

From b3a6f47e2734fdde91c1ede0e1bf1ead68186c80 Mon Sep 17 00:00:00 2001
From: jimczi <jim.ferenczi@elastic.co>
Date: Wed, 4 Dec 2019 12:21:02 +0100
Subject: [PATCH 063/686] #49566 Fix non-deterministic sort order in
 testHighlightingWithKeywordIgnoreBoundaryScanner

---
 .../highlight/HighlighterSearchIT.java        | 20 ++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
index 539f9d1977a6c..68077456a6c5f 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
@@ -57,6 +57,7 @@
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.search.fetch.subphase.highlight.HighlightBuilder.BoundaryScannerType;
 import org.elasticsearch.search.fetch.subphase.highlight.HighlightBuilder.Field;
+import org.elasticsearch.search.sort.SortBuilders;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.InternalSettingsPlugin;
@@ -128,20 +129,33 @@ public void testHighlightingWithKeywordIgnoreBoundaryScanner() throws IOExceptio
                 .startObject("tags")
                     .field("type", "keyword")
                 .endObject()
+                .startObject("sort")
+                    .field("type", "long")
+                .endObject()
             .endObject().endObject();
         mappings.endObject();
         assertAcked(prepareCreate("test")
             .addMapping("type", mappings));
         client().prepareIndex("test").setId("1")
-            .setSource(jsonBuilder().startObject().array("tags", "foo bar", "foo bar", "foo bar", "foo baz").endObject())
+            .setSource(jsonBuilder()
+                .startObject()
+                    .array("tags", "foo bar", "foo bar", "foo bar", "foo baz")
+                    .field("sort", 1)
+                .endObject())
             .get();
         client().prepareIndex("test").setId("2")
-            .setSource(jsonBuilder().startObject().array("tags", "foo baz", "foo baz", "foo baz", "foo bar").endObject())
+            .setSource(jsonBuilder()
+                .startObject()
+                    .array("tags", "foo baz", "foo baz", "foo baz", "foo bar")
+                    .field("sort", 2)
+                .endObject())
             .get();
         refresh();
 
         for (BoundaryScannerType scanner : BoundaryScannerType.values()) {
-            SearchResponse search = client().prepareSearch().setQuery(matchQuery("tags", "foo bar"))
+            SearchResponse search = client().prepareSearch()
+                .addSort(SortBuilders.fieldSort("sort"))
+                .setQuery(matchQuery("tags", "foo bar"))
                 .highlighter(new HighlightBuilder().field(new Field("tags")).numOfFragments(2).boundaryScannerType(scanner)).get();
             assertHighlight(search, 0, "tags", 0, 2, equalTo("<em>foo bar</em>"));
             assertHighlight(search, 0, "tags", 1, 2, equalTo("<em>foo bar</em>"));

From b3e3e189e671ded771ebdd5a237dd07814654331 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Wed, 4 Dec 2019 11:32:32 +0000
Subject: [PATCH 064/686] Improve coverage of equals/hashCode tests for
 IntervalQueryBuilder (#49820)

By default, AbstractQueryTestCase only changes name and boost in its mutateInstance
method, used when checking equals and hashcode implementations. This commit adds
a mutateInstance method to InveralQueryBuilderTests that will check hashcode and
equality when the field or intervals source are changed.
---
 .../index/query/IntervalQueryBuilder.java             |  8 ++++++++
 .../index/query/IntervalQueryBuilderTests.java        | 11 +++++++++++
 2 files changed, 19 insertions(+)

diff --git a/server/src/main/java/org/elasticsearch/index/query/IntervalQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/IntervalQueryBuilder.java
index 4813adfc4d3db..7e94b5da69143 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IntervalQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IntervalQueryBuilder.java
@@ -55,6 +55,14 @@ public IntervalQueryBuilder(StreamInput in) throws IOException {
         this.sourceProvider = in.readNamedWriteable(IntervalsSourceProvider.class);
     }
 
+    public String getField() {
+        return field;
+    }
+
+    public IntervalsSourceProvider getSourceProvider() {
+        return sourceProvider;
+    }
+
     @Override
     protected void doWriteTo(StreamOutput out) throws IOException {
         out.writeString(field);
diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index c5cfca0b7fe9f..5fd91848a7064 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -143,6 +143,17 @@ protected void doAssertLuceneQuery(IntervalQueryBuilder queryBuilder, Query quer
         assertThat(query, instanceOf(IntervalQuery.class));
     }
 
+    @Override
+    public IntervalQueryBuilder mutateInstance(IntervalQueryBuilder instance) throws IOException {
+        if (randomBoolean()) {
+            return super.mutateInstance(instance); // just change name/boost
+        }
+        if (randomBoolean()) {
+            return new IntervalQueryBuilder(STRING_FIELD_NAME_2, instance.getSourceProvider());
+        }
+        return new IntervalQueryBuilder(STRING_FIELD_NAME, createRandomSource(0));
+    }
+
     public void testMatchInterval() throws IOException {
 
         String json = "{ \"intervals\" : " +

From 2a5e48030c140f367af9300b3f7beb58f1172a8b Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Wed, 4 Dec 2019 13:01:06 +0100
Subject: [PATCH 065/686] Use Cluster State to Track Repository Generation
 (#49729)

Step on the road to #49060.

This commit adds the logic to keep track of a repository's generation
across repository operations. See changes to package level Javadoc for the concrete changes in the distributed state machine.

It updates the write side of new repository generations to be fully consistent via the cluster state. With this change, no `index-N` will be overwritten for the same repository ever. So eventual consistency issues around conflicting updates to the same `index-N` are not a possibility any longer.

With this change the read side will still use listing of repository contents instead of relying solely on the cluster state contents.
The logic for that will be introduced in #49060. This retains the ability to externally delete the contents of a repository and continue using it afterwards for the time being. In #49060 the use of listing to determine the repository generation will be removed in all cases (except for full-cluster restart) as the last step in this effort.
---
 .../get/GetRepositoriesResponse.java          |   3 +-
 .../metadata/RepositoriesMetaData.java        |  78 +++++++-
 .../cluster/metadata/RepositoryMetaData.java  |  85 ++++++++-
 .../repositories/RepositoriesService.java     |   7 +-
 .../repositories/RepositoryData.java          |   6 +
 .../blobstore/BlobStoreRepository.java        | 171 ++++++++++++++----
 .../repositories/blobstore/package-info.java  |  46 ++++-
 .../repositories/fs/FsRepository.java         |   2 +-
 .../BlobStoreRepositoryRestoreTests.java      |   2 +-
 .../blobstore/BlobStoreRepositoryTests.java   |  19 +-
 .../DedicatedClusterSnapshotRestoreIT.java    |   7 +-
 ...epositoriesMetaDataSerializationTests.java |   5 +-
 .../SharedClusterSnapshotRestoreIT.java       |   5 +-
 .../MockEventuallyConsistentRepository.java   |  10 +-
 ...ckEventuallyConsistentRepositoryTests.java |   9 +-
 .../blobstore/BlobStoreTestUtil.java          |  25 ++-
 .../snapshots/mockstore/MockRepository.java   |   8 +
 .../SourceOnlySnapshotShardTests.java         |   3 +-
 18 files changed, 412 insertions(+), 79 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/repositories/get/GetRepositoriesResponse.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/repositories/get/GetRepositoriesResponse.java
index 69ade6d8fe0b0..7512e5a4f3b3e 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/repositories/get/GetRepositoriesResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/repositories/get/GetRepositoriesResponse.java
@@ -30,6 +30,7 @@
 
 import java.io.IOException;
 import java.util.List;
+import java.util.Map;
 
 import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
 
@@ -66,7 +67,7 @@ public void writeTo(StreamOutput out) throws IOException {
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
-        repositories.toXContent(builder, params);
+        repositories.toXContent(builder, new DelegatingMapParams(Map.of(RepositoriesMetaData.HIDE_GENERATIONS_PARAM, "true"), params));
         builder.endObject();
         return builder;
     }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoriesMetaData.java b/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoriesMetaData.java
index 4f182b6ca381e..a28850a9b47ce 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoriesMetaData.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoriesMetaData.java
@@ -24,12 +24,15 @@
 import org.elasticsearch.cluster.AbstractNamedDiffable;
 import org.elasticsearch.cluster.NamedDiff;
 import org.elasticsearch.cluster.metadata.MetaData.Custom;
+import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.repositories.RepositoryData;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -44,6 +47,12 @@ public class RepositoriesMetaData extends AbstractNamedDiffable<Custom> implemen
 
     public static final String TYPE = "repositories";
 
+    /**
+     * Serialization parameter used to hide the {@link RepositoryMetaData#generation()} and {@link RepositoryMetaData#pendingGeneration()}
+     * in {@link org.elasticsearch.action.admin.cluster.repositories.get.GetRepositoriesResponse}.
+     */
+    public static final String HIDE_GENERATIONS_PARAM = "hide_generations";
+
     private final List<RepositoryMetaData> repositories;
 
     /**
@@ -55,6 +64,30 @@ public RepositoriesMetaData(List<RepositoryMetaData> repositories) {
         this.repositories = Collections.unmodifiableList(repositories);
     }
 
+    /**
+     * Creates a new instance that has the given repository moved to the given {@code safeGeneration} and {@code pendingGeneration}.
+     *
+     * @param repoName          repository name
+     * @param safeGeneration    new safe generation
+     * @param pendingGeneration new pending generation
+     * @return new instance with updated generations
+     */
+    public RepositoriesMetaData withUpdatedGeneration(String repoName, long safeGeneration, long pendingGeneration) {
+        int indexOfRepo = -1;
+        for (int i = 0; i < repositories.size(); i++) {
+            if (repositories.get(i).name().equals(repoName)) {
+                indexOfRepo = i;
+                break;
+            }
+        }
+        if (indexOfRepo < 0) {
+            throw new IllegalArgumentException("Unknown repository [" + repoName + "]");
+        }
+        final List<RepositoryMetaData> updatedRepos = new ArrayList<>(repositories);
+        updatedRepos.set(indexOfRepo, new RepositoryMetaData(repositories.get(indexOfRepo), safeGeneration, pendingGeneration));
+        return new RepositoriesMetaData(updatedRepos);
+    }
+
     /**
      * Returns list of currently registered repositories
      *
@@ -87,7 +120,29 @@ public boolean equals(Object o) {
         RepositoriesMetaData that = (RepositoriesMetaData) o;
 
         return repositories.equals(that.repositories);
+    }
 
+    /**
+     * Checks if this instance and the given instance share the same repositories by checking that this instances' repositories and the
+     * repositories in {@code other} are equal or only differ in their values of {@link RepositoryMetaData#generation()} and
+     * {@link RepositoryMetaData#pendingGeneration()}.
+     *
+     * @param other other repositories metadata
+     * @return {@code true} iff both instances contain the same repositories apart from differences in generations
+     */
+    public boolean equalsIgnoreGenerations(@Nullable RepositoriesMetaData other) {
+        if (other == null) {
+            return false;
+        }
+        if (other.repositories.size() != repositories.size()) {
+            return false;
+        }
+        for (int i = 0; i < repositories.size(); i++) {
+            if (repositories.get(i).equalsIgnoreGenerations(other.repositories.get(i)) == false) {
+                return false;
+            }
+        }
+        return true;
     }
 
     @Override
@@ -142,6 +197,8 @@ public static RepositoriesMetaData fromXContent(XContentParser parser) throws IO
                 }
                 String type = null;
                 Settings settings = Settings.EMPTY;
+                long generation = RepositoryData.UNKNOWN_REPO_GEN;
+                long pendingGeneration = RepositoryData.EMPTY_REPO_GEN;
                 while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
                     if (token == XContentParser.Token.FIELD_NAME) {
                         String currentFieldName = parser.currentName();
@@ -155,6 +212,16 @@ public static RepositoriesMetaData fromXContent(XContentParser parser) throws IO
                                 throw new ElasticsearchParseException("failed to parse repository [{}], incompatible params", name);
                             }
                             settings = Settings.fromXContent(parser);
+                        } else if ("generation".equals(currentFieldName)) {
+                            if (parser.nextToken() != XContentParser.Token.VALUE_NUMBER) {
+                                throw new ElasticsearchParseException("failed to parse repository [{}], unknown type", name);
+                            }
+                            generation = parser.longValue();
+                        } else if ("pending_generation".equals(currentFieldName)) {
+                            if (parser.nextToken() != XContentParser.Token.VALUE_NUMBER) {
+                                throw new ElasticsearchParseException("failed to parse repository [{}], unknown type", name);
+                            }
+                            pendingGeneration = parser.longValue();
                         } else {
                             throw new ElasticsearchParseException("failed to parse repository [{}], unknown field [{}]",
                                 name, currentFieldName);
@@ -166,7 +233,7 @@ public static RepositoriesMetaData fromXContent(XContentParser parser) throws IO
                 if (type == null) {
                     throw new ElasticsearchParseException("failed to parse repository [{}], missing repository type", name);
                 }
-                repository.add(new RepositoryMetaData(name, type, settings));
+                repository.add(new RepositoryMetaData(name, type, settings, generation, pendingGeneration));
             } else {
                 throw new ElasticsearchParseException("failed to parse repositories");
             }
@@ -204,6 +271,15 @@ public static void toXContent(RepositoryMetaData repository, XContentBuilder bui
         repository.settings().toXContent(builder, params);
         builder.endObject();
 
+        if (params.paramAsBoolean(HIDE_GENERATIONS_PARAM, false) == false) {
+            builder.field("generation", repository.generation());
+            builder.field("pending_generation", repository.pendingGeneration());
+        }
         builder.endObject();
     }
+
+    @Override
+    public String toString() {
+        return Strings.toString(this);
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoryMetaData.java b/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoryMetaData.java
index 847db915b8bce..c210c32a9a529 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoryMetaData.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoryMetaData.java
@@ -18,20 +18,36 @@
  */
 package org.elasticsearch.cluster.metadata;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.repositories.RepositoryData;
 
 import java.io.IOException;
+import java.util.Objects;
 
 /**
  * Metadata about registered repository
  */
 public class RepositoryMetaData {
+
+    public static final Version REPO_GEN_IN_CS_VERSION = Version.V_8_0_0;
+
     private final String name;
     private final String type;
     private final Settings settings;
 
+    /**
+     * Safe repository generation.
+     */
+    private final long generation;
+
+    /**
+     * Pending repository generation.
+     */
+    private final long pendingGeneration;
+
     /**
      * Constructs new repository metadata
      *
@@ -40,9 +56,21 @@ public class RepositoryMetaData {
      * @param settings repository settings
      */
     public RepositoryMetaData(String name, String type, Settings settings) {
+        this(name, type, settings, RepositoryData.UNKNOWN_REPO_GEN, RepositoryData.EMPTY_REPO_GEN);
+    }
+
+    public RepositoryMetaData(RepositoryMetaData metaData, long generation, long pendingGeneration) {
+        this(metaData.name, metaData.type, metaData.settings, generation, pendingGeneration);
+    }
+
+    public RepositoryMetaData(String name, String type, Settings settings, long generation, long pendingGeneration) {
         this.name = name;
         this.type = type;
         this.settings = settings;
+        this.generation = generation;
+        this.pendingGeneration = pendingGeneration;
+        assert generation <= pendingGeneration :
+            "Pending generation [" + pendingGeneration + "] must be greater or equal to generation [" + generation + "]";
     }
 
     /**
@@ -72,11 +100,41 @@ public Settings settings() {
         return this.settings;
     }
 
+    /**
+     * Returns the safe repository generation. {@link RepositoryData} for this generation is assumed to exist in the repository.
+     * All operations on the repository must be based on the {@link RepositoryData} at this generation.
+     * See package level documentation for the blob store based repositories {@link org.elasticsearch.repositories.blobstore} for details
+     * on how this value is used during snapshots.
+     * @return safe repository generation
+     */
+    public long generation() {
+        return generation;
+    }
+
+    /**
+     * Returns the pending repository generation. {@link RepositoryData} for this generation and all generations down to the safe
+     * generation {@link #generation} may exist in the repository and should not be reused for writing new {@link RepositoryData} to the
+     * repository.
+     * See package level documentation for the blob store based repositories {@link org.elasticsearch.repositories.blobstore} for details
+     * on how this value is used during snapshots.
+     *
+     * @return highest pending repository generation
+     */
+    public long pendingGeneration() {
+        return pendingGeneration;
+    }
 
     public RepositoryMetaData(StreamInput in) throws IOException {
         name = in.readString();
         type = in.readString();
         settings = Settings.readSettingsFromStream(in);
+        if (in.getVersion().onOrAfter(REPO_GEN_IN_CS_VERSION)) {
+            generation = in.readLong();
+            pendingGeneration = in.readLong();
+        } else {
+            generation = RepositoryData.UNKNOWN_REPO_GEN;
+            pendingGeneration = RepositoryData.EMPTY_REPO_GEN;
+        }
     }
 
     /**
@@ -88,6 +146,20 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeString(name);
         out.writeString(type);
         Settings.writeSettingsToStream(settings, out);
+        if (out.getVersion().onOrAfter(REPO_GEN_IN_CS_VERSION)) {
+            out.writeLong(generation);
+            out.writeLong(pendingGeneration);
+        }
+    }
+
+    /**
+     * Checks if this instance is equal to the other instance in all fields other than {@link #generation} and {@link #pendingGeneration}.
+     *
+     * @param other other repository metadata
+     * @return {@code true} if both instances equal in all fields but the generation fields
+     */
+    public boolean equalsIgnoreGenerations(RepositoryMetaData other) {
+        return name.equals(other.name) && type.equals(other.type()) && settings.equals(other.settings());
     }
 
     @Override
@@ -99,15 +171,18 @@ public boolean equals(Object o) {
 
         if (!name.equals(that.name)) return false;
         if (!type.equals(that.type)) return false;
+        if (generation != that.generation) return false;
+        if (pendingGeneration != that.pendingGeneration) return false;
         return settings.equals(that.settings);
-
     }
 
     @Override
     public int hashCode() {
-        int result = name.hashCode();
-        result = 31 * result + type.hashCode();
-        result = 31 * result + settings.hashCode();
-        return result;
+        return Objects.hash(name, type, settings, generation, pendingGeneration);
+    }
+
+    @Override
+    public String toString() {
+        return "RepositoryMetaData{" + name + "}{" + type + "}{" + settings + "}{" + generation + "}{" + pendingGeneration + "}";
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoriesService.java b/server/src/main/java/org/elasticsearch/repositories/RepositoriesService.java
index 03b283c4aafe5..c2796d27aa956 100644
--- a/server/src/main/java/org/elasticsearch/repositories/RepositoriesService.java
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoriesService.java
@@ -150,7 +150,7 @@ public ClusterState execute(ClusterState currentState) {
 
                         for (RepositoryMetaData repositoryMetaData : repositories.repositories()) {
                             if (repositoryMetaData.name().equals(newRepositoryMetaData.name())) {
-                                if (newRepositoryMetaData.equals(repositoryMetaData)) {
+                                if (newRepositoryMetaData.equalsIgnoreGenerations(repositoryMetaData)) {
                                     // Previous version is the same as this one no update is needed.
                                     return currentState;
                                 }
@@ -292,7 +292,10 @@ public void applyClusterState(ClusterChangedEvent event) {
             RepositoriesMetaData newMetaData = state.getMetaData().custom(RepositoriesMetaData.TYPE);
 
             // Check if repositories got changed
-            if ((oldMetaData == null && newMetaData == null) || (oldMetaData != null && oldMetaData.equals(newMetaData))) {
+            if ((oldMetaData == null && newMetaData == null) || (oldMetaData != null && oldMetaData.equalsIgnoreGenerations(newMetaData))) {
+                for (Repository repo : repositories.values()) {
+                    repo.updateState(state);
+                }
                 return;
             }
 
diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
index 20dcdc2371805..357268fa051e0 100644
--- a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
@@ -52,6 +52,12 @@ public final class RepositoryData {
      * The generation value indicating the repository has no index generational files.
      */
     public static final long EMPTY_REPO_GEN = -1L;
+
+    /**
+     * The generation value indicating that the repository generation is unknown.
+     */
+    public static final long UNKNOWN_REPO_GEN = -2L;
+
     /**
      * An instance initialized for an empty repository.
      */
diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index 1e3076b258104..ba670c2d6f01d 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -36,11 +36,13 @@
 import org.elasticsearch.action.StepListener;
 import org.elasticsearch.action.support.GroupedActionListener;
 import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateUpdateTask;
 import org.elasticsearch.cluster.RepositoryCleanupInProgress;
 import org.elasticsearch.cluster.SnapshotDeletionsInProgress;
 import org.elasticsearch.cluster.SnapshotsInProgress;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.metadata.RepositoriesMetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.service.ClusterService;
@@ -124,6 +126,7 @@
 import java.util.concurrent.atomic.AtomicLong;
 import java.util.function.Consumer;
 import java.util.stream.Collectors;
+import java.util.stream.LongStream;
 import java.util.stream.Stream;
 
 import static org.elasticsearch.index.snapshots.blobstore.BlobStoreIndexShardSnapshot.FileInfo.canonicalName;
@@ -140,7 +143,7 @@
 public abstract class BlobStoreRepository extends AbstractLifecycleComponent implements Repository {
     private static final Logger logger = LogManager.getLogger(BlobStoreRepository.class);
 
-    protected final RepositoryMetaData metadata;
+    protected volatile RepositoryMetaData metadata;
 
     protected final ThreadPool threadPool;
 
@@ -211,6 +214,8 @@ public abstract class BlobStoreRepository extends AbstractLifecycleComponent imp
 
     private final BlobPath basePath;
 
+    private final ClusterService clusterService;
+
     /**
      * Constructs new BlobStoreRepository
      * @param metadata   The metadata for this repository including name and settings
@@ -223,6 +228,7 @@ protected BlobStoreRepository(
         final BlobPath basePath) {
         this.metadata = metadata;
         this.threadPool = clusterService.getClusterApplierService().threadPool();
+        this.clusterService = clusterService;
         this.compress = COMPRESS_SETTING.get(metadata.settings());
         snapshotRateLimiter = getRateLimiter(metadata.settings(), "max_snapshot_bytes_per_sec", new ByteSizeValue(40, ByteSizeUnit.MB));
         restoreRateLimiter = getRateLimiter(metadata.settings(), "max_restore_bytes_per_sec", new ByteSizeValue(40, ByteSizeUnit.MB));
@@ -293,7 +299,8 @@ public void updateState(ClusterState state) {
             bestGenerationFromCS = bestGeneration(cleanupInProgress.entries());
         }
 
-        final long finalBestGen = bestGenerationFromCS;
+        metadata = getRepoMetaData(state);
+        final long finalBestGen = Math.max(bestGenerationFromCS, metadata.generation());
         latestKnownRepoGen.updateAndGet(known -> Math.max(known, finalBestGen));
     }
 
@@ -975,8 +982,7 @@ public void endVerification(String seed) {
 
     // Tracks the latest known repository generation in a best-effort way to detect inconsistent listing of root level index-N blobs
     // and concurrent modifications.
-    // Protected for use in MockEventuallyConsistentRepository
-    protected final AtomicLong latestKnownRepoGen = new AtomicLong(RepositoryData.EMPTY_REPO_GEN);
+    private final AtomicLong latestKnownRepoGen = new AtomicLong(RepositoryData.EMPTY_REPO_GEN);
 
     @Override
     public void getRepositoryData(ActionListener<RepositoryData> listener) {
@@ -1042,38 +1048,92 @@ public boolean isReadOnly() {
     }
 
     /**
+     * Writing a new index generation is a three step process.
+     * First, the {@link RepositoryMetaData} entry for this repository is set into a pending state by incrementing its
+     * pending generation {@code P} while its safe generation {@code N} remains unchanged.
+     * Second, the updated {@link RepositoryData} is written to generation {@code P + 1}.
+     * Lastly, the {@link RepositoryMetaData} entry for this repository is updated to the new generation {@code P + 1} and thus
+     * pending and safe generation are set to the same value marking the end of the update of the repository data.
+     *
      * @param repositoryData RepositoryData to write
      * @param expectedGen    expected repository generation at the start of the operation
      * @param writeShardGens whether to write {@link ShardGenerations} to the new {@link RepositoryData} blob
      * @param listener       completion listener
      */
     protected void writeIndexGen(RepositoryData repositoryData, long expectedGen, boolean writeShardGens, ActionListener<Void> listener) {
-        ActionListener.completeWith(listener, () -> {
-            assert isReadOnly() == false; // can not write to a read only repository
-            final long currentGen = repositoryData.getGenId();
-            if (currentGen != expectedGen) {
-                // the index file was updated by a concurrent operation, so we were operating on stale
-                // repository data
-                throw new RepositoryException(metadata.name(),
-                    "concurrent modification of the index-N file, expected current generation [" + expectedGen +
-                        "], actual current generation [" + currentGen + "] - possibly due to simultaneous snapshot deletion requests");
-            }
-            final long newGen = currentGen + 1;
+        assert isReadOnly() == false; // can not write to a read only repository
+        final long currentGen = repositoryData.getGenId();
+        if (currentGen != expectedGen) {
+            // the index file was updated by a concurrent operation, so we were operating on stale
+            // repository data
+            listener.onFailure(new RepositoryException(metadata.name(),
+                "concurrent modification of the index-N file, expected current generation [" + expectedGen +
+                    "], actual current generation [" + currentGen + "]"));
+            return;
+        }
+
+        // Step 1: Set repository generation state to the next possible pending generation
+        final StepListener<Long> setPendingStep = new StepListener<>();
+        clusterService.submitStateUpdateTask("set pending repository generation [" + metadata.name() + "][" + expectedGen + "]",
+            new ClusterStateUpdateTask() {
+
+                private long newGen;
+
+                @Override
+                public ClusterState execute(ClusterState currentState) {
+                    final RepositoryMetaData meta = getRepoMetaData(currentState);
+                    final String repoName = metadata.name();
+                    final long genInState = meta.generation();
+                    // TODO: Remove all usages of this variable, instead initialize the generation when loading RepositoryData
+                    final boolean uninitializedMeta = meta.generation() == RepositoryData.UNKNOWN_REPO_GEN;
+                    if (uninitializedMeta == false && meta.pendingGeneration() != genInState) {
+                        logger.info("Trying to write new repository data over unfinished write, repo [{}] is at " +
+                            "safe generation [{}] and pending generation [{}]", meta.name(), genInState, meta.pendingGeneration());
+                    }
+                    assert expectedGen == RepositoryData.EMPTY_REPO_GEN || RepositoryData.UNKNOWN_REPO_GEN == meta.generation()
+                        || expectedGen == meta.generation() :
+                        "Expected non-empty generation [" + expectedGen + "] does not match generation tracked in [" + meta + "]";
+                    // If we run into the empty repo generation for the expected gen, the repo is assumed to have been cleared of
+                    // all contents by an external process so we reset the safe generation to the empty generation.
+                    final long safeGeneration = expectedGen == RepositoryData.EMPTY_REPO_GEN ? RepositoryData.EMPTY_REPO_GEN
+                        : (uninitializedMeta ? expectedGen : genInState);
+                    // Regardless of whether or not the safe generation has been reset, the pending generation always increments so that
+                    // even if a repository has been manually cleared of all contents we will never reuse the same repository generation.
+                    // This is motivated by the consistency behavior the S3 based blob repository implementation has to support which does
+                    // not offer any consistency guarantees when it comes to overwriting the same blob name with different content.
+                    newGen = uninitializedMeta ? expectedGen + 1: metadata.pendingGeneration() + 1;
+                    assert newGen > latestKnownRepoGen.get() : "Attempted new generation [" + newGen +
+                        "] must be larger than latest known generation [" + latestKnownRepoGen.get() + "]";
+                    return ClusterState.builder(currentState).metaData(MetaData.builder(currentState.getMetaData())
+                        .putCustom(RepositoriesMetaData.TYPE,
+                            currentState.metaData().<RepositoriesMetaData>custom(RepositoriesMetaData.TYPE).withUpdatedGeneration(
+                                repoName, safeGeneration, newGen)).build()).build();
+                }
+
+                @Override
+                public void onFailure(String source, Exception e) {
+                    listener.onFailure(
+                        new RepositoryException(metadata.name(), "Failed to execute cluster state update [" + source + "]", e));
+                }
+
+                @Override
+                public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
+                    setPendingStep.onResponse(newGen);
+                }
+            });
+
+        // Step 2: Write new index-N blob to repository and update index.latest
+        setPendingStep.whenComplete(newGen -> threadPool().executor(ThreadPool.Names.SNAPSHOT).execute(ActionRunnable.wrap(listener, l -> {
             if (latestKnownRepoGen.get() >= newGen) {
                 throw new IllegalArgumentException(
-                    "Tried writing generation [" + newGen + "] but repository is at least at generation [" + newGen + "] already");
+                    "Tried writing generation [" + newGen + "] but repository is at least at generation [" + latestKnownRepoGen.get()
+                        + "] already");
             }
             // write the index file
             final String indexBlob = INDEX_FILE_PREFIX + Long.toString(newGen);
             logger.debug("Repository [{}] writing new index generational blob [{}]", metadata.name(), indexBlob);
             writeAtomic(indexBlob,
                 BytesReference.bytes(repositoryData.snapshotsToXContent(XContentFactory.jsonBuilder(), writeShardGens)), true);
-            final long latestKnownGen = latestKnownRepoGen.updateAndGet(known -> Math.max(known, newGen));
-            if (newGen < latestKnownGen) {
-                // Don't mess up the index.latest blob
-                throw new IllegalStateException(
-                    "Wrote generation [" + newGen + "] but latest known repo gen concurrently changed to [" + latestKnownGen + "]");
-            }
             // write the current generation to the index-latest file
             final BytesReference genBytes;
             try (BytesStreamOutput bStream = new BytesStreamOutput()) {
@@ -1081,18 +1141,63 @@ protected void writeIndexGen(RepositoryData repositoryData, long expectedGen, bo
                 genBytes = bStream.bytes();
             }
             logger.debug("Repository [{}] updating index.latest with generation [{}]", metadata.name(), newGen);
+
             writeAtomic(INDEX_LATEST_BLOB, genBytes, false);
-            // delete the N-2 index file if it exists, keep the previous one around as a backup
-            if (newGen - 2 >= 0) {
-                final String oldSnapshotIndexFile = INDEX_FILE_PREFIX + Long.toString(newGen - 2);
-                try {
-                    blobContainer().deleteBlobIgnoringIfNotExists(oldSnapshotIndexFile);
-                } catch (IOException e) {
-                    logger.warn("Failed to clean up old index blob [{}]", oldSnapshotIndexFile);
-                }
-            }
-            return null;
-        });
+
+            // Step 3: Update CS to reflect new repository generation.
+            clusterService.submitStateUpdateTask("set safe repository generation [" + metadata.name() + "][" + newGen + "]",
+                new ClusterStateUpdateTask() {
+                    @Override
+                    public ClusterState execute(ClusterState currentState) {
+                        final RepositoryMetaData meta = getRepoMetaData(currentState);
+                        if (meta.generation() != expectedGen) {
+                            throw new IllegalStateException("Tried to update repo generation to [" + newGen
+                                + "] but saw unexpected generation in state [" + meta + "]");
+                        }
+                        if (meta.pendingGeneration() != newGen) {
+                            throw new IllegalStateException(
+                                "Tried to update from unexpected pending repo generation [" + meta.pendingGeneration() +
+                                    "] after write to generation [" + newGen + "]");
+                        }
+                        return ClusterState.builder(currentState).metaData(MetaData.builder(currentState.getMetaData())
+                            .putCustom(RepositoriesMetaData.TYPE,
+                                currentState.metaData().<RepositoriesMetaData>custom(RepositoriesMetaData.TYPE).withUpdatedGeneration(
+                                    metadata.name(), newGen, newGen)).build()).build();
+                    }
+
+                    @Override
+                    public void onFailure(String source, Exception e) {
+                        l.onFailure(
+                            new RepositoryException(metadata.name(), "Failed to execute cluster state update [" + source + "]", e));
+                    }
+
+                    @Override
+                    public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
+                        threadPool.executor(ThreadPool.Names.SNAPSHOT).execute(ActionRunnable.run(l, () -> {
+                            // Delete all now outdated index files up to 1000 blobs back from the new generation.
+                            // If there are more than 1000 dangling index-N cleanup functionality on repo delete will take care of them.
+                            // Deleting one older than the current expectedGen is done for BwC reasons as older versions used to keep
+                            // two index-N blobs around.
+                            final List<String> oldIndexN = LongStream.range(
+                                Math.max(Math.max(expectedGen - 1, 0), newGen - 1000), newGen)
+                                .mapToObj(gen -> INDEX_FILE_PREFIX + gen)
+                                .collect(Collectors.toList());
+                            try {
+                                blobContainer().deleteBlobsIgnoringIfNotExists(oldIndexN);
+                            } catch (IOException e) {
+                                logger.warn("Failed to clean up old index blobs {}", oldIndexN);
+                            }
+                        }));
+                    }
+                });
+        })), listener::onFailure);
+    }
+
+    private RepositoryMetaData getRepoMetaData(ClusterState state) {
+        final RepositoryMetaData metaData =
+            state.getMetaData().<RepositoriesMetaData>custom(RepositoriesMetaData.TYPE).repository(metadata.name());
+        assert metaData != null;
+        return metaData;
     }
 
     /**
diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/package-info.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/package-info.java
index d4f3329d354b4..5e5fe84103250 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/package-info.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/package-info.java
@@ -96,6 +96,9 @@
  * <ol>
  * <li>The blobstore repository stores the {@code RepositoryData} in blobs named with incrementing suffix {@code N} at {@code /index-N}
  * directly under the repository's root.</li>
+ * <li>For each {@link org.elasticsearch.repositories.blobstore.BlobStoreRepository} an entry of type
+ * {@link org.elasticsearch.cluster.metadata.RepositoryMetaData} exists in the cluster state. It tracks the current valid
+ * generation {@code N} as well as the latest generation that a write was attempted for.</li>
  * <li>The blobstore also stores the most recent {@code N} as a 64bit long in the blob {@code /index.latest} directly under the
  * repository's root.</li>
  * </ol>
@@ -116,6 +119,38 @@
  * </ol>
  * </li>
  * </ol>
+ *
+ * <h2>Writing Updated RepositoryData to the Repository</h2>
+ *
+ * <p>Writing an updated {@link org.elasticsearch.repositories.RepositoryData} to a blob store repository is an operation that uses
+ * the cluster state to ensure that a specific {@code index-N} blob is never accidentally overwritten in a master failover scenario.
+ * The specific steps to writing a new {@code index-N} blob and thus making changes from a snapshot-create or delete operation visible
+ * to read operations on the repository are as follows and all run on the master node:</p>
+ *
+ * <ol>
+ * <li>Write an updated value of {@link org.elasticsearch.cluster.metadata.RepositoryMetaData} for the repository that has the same
+ * {@link org.elasticsearch.cluster.metadata.RepositoryMetaData#generation()} as the existing entry and has a value of
+ * {@link org.elasticsearch.cluster.metadata.RepositoryMetaData#pendingGeneration()} one greater than the {@code pendingGeneration} of the
+ * existing entry.</li>
+ * <li>On the same master node, after the cluster state has been updated in the first step, write the new {@code index-N} blob and
+ * also update the contents of the {@code index.latest} blob. Note that updating the index.latest blob is done on a best effort
+ * basis and that there is a chance for a stuck master-node to overwrite the contents of the {@code index.latest} blob after a newer
+ * {@code index-N} has been written by another master node. This is acceptable since the contents of {@code index.latest} are not used
+ * during normal operation of the repository and must only be correct for purposes of mounting the contents of a
+ * {@link org.elasticsearch.repositories.blobstore.BlobStoreRepository} as a read-only url repository.</li>
+ * <li>After the write has finished, set the value of {@code RepositoriesState.State#generation} to the value used for
+ * {@code RepositoriesState.State#pendingGeneration} so that the new entry for the state of the repository has {@code generation} and
+ * {@code pendingGeneration} set to the same value to signalize a clean repository state with no potentially failed writes newer than the
+ * last valid {@code index-N} blob in the repository.</li>
+ * </ol>
+ *
+ * <p>If either of the last two steps in the above fails or master fails over to a new node at any point, then a subsequent operation
+ * trying to write a new {@code index-N} blob will never use the same value of {@code N} used by a previous attempt. It will always start
+ * over at the first of the above three steps, incrementing the {@code pendingGeneration} generation before attempting a write, thus
+ * ensuring no overwriting of a {@code index-N} blob ever to occur. The use of the cluster state to track the latest repository generation
+ * {@code N} and ensuring no overwriting of {@code index-N} blobs to ever occur allows the blob store repository to properly function even
+ * on blob stores with neither a consistent list operation nor an atomic "write but not overwrite" operation.</p>
+ *
  * <h2>Creating a Snapshot</h2>
  *
  * <p>Creating a snapshot in the repository happens in the two steps described in detail below.</p>
@@ -160,11 +195,7 @@
  * {@code /indices/${index-snapshot-uuid}/meta-${snapshot-uuid}.dat}</li>
  * <li>Write the {@link org.elasticsearch.snapshots.SnapshotInfo} blob for the given snapshot to the key {@code /snap-${snapshot-uuid}.dat}
  * directly under the repository root.</li>
- * <li>Write an updated {@code RepositoryData} blob to the key {@code /index-${N+1}} using the {@code N} determined when initializing the
- * snapshot in the first step. When doing this, the implementation checks that the blob for generation {@code N + 1} has not yet been
- * written to prevent concurrent updates to the repository. If the blob for {@code N + 1} already exists the execution of finalization
- * stops under the assumption that a master failover occurred and the snapshot has already been finalized by the new master.</li>
- * <li>Write the updated {@code /index.latest} blob containing the new repository generation {@code N + 1}.</li>
+ * <li>Write an updated {@code RepositoryData} blob containing the new snapshot.</li>
  * </ol>
  *
  * <h2>Deleting a Snapshot</h2>
@@ -189,9 +220,8 @@
  * blob so that it can be deleted at the end of the snapshot delete process.</li>
  * </ol>
  * </li>
- * <li>Write an updated {@code RepositoryData} blob with the deleted snapshot removed to key {@code /index-${N+1}} directly under the
- * repository root and the repository generations that were changed in the affected shards adjusted.</li>
- * <li>Write an updated {@code index.latest} blob containing {@code N + 1}.</li>
+ * <li>Write an updated {@code RepositoryData} blob with the deleted snapshot removed and containing the updated repository generations
+ * that changed for the shards affected by the delete.</li>
  * <li>Delete the global {@code MetaData} blob {@code meta-${snapshot-uuid}.dat} stored directly under the repository root for the snapshot
  * as well as the {@code SnapshotInfo} blob at {@code /snap-${snapshot-uuid}.dat}.</li>
  * <li>Delete all unreferenced blobs previously collected when updating the shard directories. Also, remove any index folders or blobs
diff --git a/server/src/main/java/org/elasticsearch/repositories/fs/FsRepository.java b/server/src/main/java/org/elasticsearch/repositories/fs/FsRepository.java
index efe095eb9b6c2..9d69dea97f020 100644
--- a/server/src/main/java/org/elasticsearch/repositories/fs/FsRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/fs/FsRepository.java
@@ -103,7 +103,7 @@ public FsRepository(RepositoryMetaData metadata, Environment environment, NamedX
 
     @Override
     protected BlobStore createBlobStore() throws Exception {
-        final String location = REPOSITORIES_LOCATION_SETTING.get(metadata.settings());
+        final String location = REPOSITORIES_LOCATION_SETTING.get(getMetadata().settings());
         final Path locationFile = environment.resolveRepoFile(location);
         return new FsBlobStore(environment.settings(), locationFile, isReadOnly());
     }
diff --git a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
index b5d99db0a880f..432091b81e1ec 100644
--- a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
@@ -194,7 +194,7 @@ private Repository createRepository() {
         Settings settings = Settings.builder().put("location", randomAlphaOfLength(10)).build();
         RepositoryMetaData repositoryMetaData = new RepositoryMetaData(randomAlphaOfLength(10), FsRepository.TYPE, settings);
         final FsRepository repository = new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(),
-                                                         BlobStoreTestUtil.mockClusterService()) {
+                                                         BlobStoreTestUtil.mockClusterService(repositoryMetaData)) {
             @Override
             protected void assertSnapshotOrGenericThread() {
                 // eliminate thread name check as we create repo manually
diff --git a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
index 6d6248c446df1..13102182cd7b0 100644
--- a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
@@ -137,7 +137,7 @@ public void testRetrieveSnapshots() throws Exception {
 
     public void testReadAndWriteSnapshotsThroughIndexFile() throws Exception {
         final BlobStoreRepository repository = setupRepo();
-
+        final long pendingGeneration = repository.metadata.pendingGeneration();
         // write to and read from a index file with no entries
         assertThat(ESBlobStoreRepositoryIntegTestCase.getRepositoryData(repository).getSnapshotIds().size(), equalTo(0));
         final RepositoryData emptyData = RepositoryData.EMPTY;
@@ -146,7 +146,7 @@ public void testReadAndWriteSnapshotsThroughIndexFile() throws Exception {
         assertEquals(repoData, emptyData);
         assertEquals(repoData.getIndices().size(), 0);
         assertEquals(repoData.getSnapshotIds().size(), 0);
-        assertEquals(0L, repoData.getGenId());
+        assertEquals(pendingGeneration + 1L, repoData.getGenId());
 
         // write to and read from an index file with snapshots but no indices
         repoData = addRandomSnapshotsToRepoData(repoData, false);
@@ -163,27 +163,30 @@ public void testIndexGenerationalFiles() throws Exception {
         final BlobStoreRepository repository = setupRepo();
         assertEquals(ESBlobStoreRepositoryIntegTestCase.getRepositoryData(repository), RepositoryData.EMPTY);
 
+        final long pendingGeneration = repository.metadata.pendingGeneration();
+
         // write to index generational file
         RepositoryData repositoryData = generateRandomRepoData();
         writeIndexGen(repository, repositoryData, RepositoryData.EMPTY_REPO_GEN);
         assertThat(ESBlobStoreRepositoryIntegTestCase.getRepositoryData(repository), equalTo(repositoryData));
-        assertThat(repository.latestIndexBlobId(), equalTo(0L));
-        assertThat(repository.readSnapshotIndexLatestBlob(), equalTo(0L));
+        final long expectedGeneration = pendingGeneration + 1L;
+        assertThat(repository.latestIndexBlobId(), equalTo(expectedGeneration));
+        assertThat(repository.readSnapshotIndexLatestBlob(), equalTo(expectedGeneration));
 
         // adding more and writing to a new index generational file
         repositoryData = addRandomSnapshotsToRepoData(ESBlobStoreRepositoryIntegTestCase.getRepositoryData(repository), true);
         writeIndexGen(repository, repositoryData, repositoryData.getGenId());
         assertEquals(ESBlobStoreRepositoryIntegTestCase.getRepositoryData(repository), repositoryData);
-        assertThat(repository.latestIndexBlobId(), equalTo(1L));
-        assertThat(repository.readSnapshotIndexLatestBlob(), equalTo(1L));
+        assertThat(repository.latestIndexBlobId(), equalTo(expectedGeneration + 1L));
+        assertThat(repository.readSnapshotIndexLatestBlob(), equalTo(expectedGeneration + 1L));
 
         // removing a snapshot and writing to a new index generational file
         repositoryData = ESBlobStoreRepositoryIntegTestCase.getRepositoryData(repository).removeSnapshot(
             repositoryData.getSnapshotIds().iterator().next(), ShardGenerations.EMPTY);
         writeIndexGen(repository, repositoryData, repositoryData.getGenId());
         assertEquals(ESBlobStoreRepositoryIntegTestCase.getRepositoryData(repository), repositoryData);
-        assertThat(repository.latestIndexBlobId(), equalTo(2L));
-        assertThat(repository.readSnapshotIndexLatestBlob(), equalTo(2L));
+        assertThat(repository.latestIndexBlobId(), equalTo(expectedGeneration + 2L));
+        assertThat(repository.readSnapshotIndexLatestBlob(), equalTo(expectedGeneration + 2L));
     }
 
     public void testRepositoryDataConcurrentModificationNotAllowed() {
diff --git a/server/src/test/java/org/elasticsearch/snapshots/DedicatedClusterSnapshotRestoreIT.java b/server/src/test/java/org/elasticsearch/snapshots/DedicatedClusterSnapshotRestoreIT.java
index a11fb9d13bc04..ab5aebe853b9e 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/DedicatedClusterSnapshotRestoreIT.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/DedicatedClusterSnapshotRestoreIT.java
@@ -497,11 +497,10 @@ public void testSnapshotWithStuckNode() throws Exception {
         logger.info("--> Go through a loop of creating and deleting a snapshot to trigger repository cleanup");
         client().admin().cluster().prepareCleanupRepository("test-repo").get();
 
-        // Subtract four files that will remain in the repository:
+        // Expect two files to remain in the repository:
         //   (1) index-(N+1)
-        //   (2) index-N (because we keep the previous version) and
-        //   (3) index-latest
-        assertFileCount(repo, 3);
+        //   (2) index-latest
+        assertFileCount(repo, 2);
         logger.info("--> done");
     }
 
diff --git a/server/src/test/java/org/elasticsearch/snapshots/RepositoriesMetaDataSerializationTests.java b/server/src/test/java/org/elasticsearch/snapshots/RepositoriesMetaDataSerializationTests.java
index 17ae1def2359c..c7c97077fe9b2 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/RepositoriesMetaDataSerializationTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/RepositoriesMetaDataSerializationTests.java
@@ -42,7 +42,10 @@ protected Custom createTestInstance() {
         int numberOfRepositories = randomInt(10);
         List<RepositoryMetaData> entries = new ArrayList<>();
         for (int i = 0; i < numberOfRepositories; i++) {
-            entries.add(new RepositoryMetaData(randomAlphaOfLength(10), randomAlphaOfLength(10), randomSettings()));
+            // divide by 2 to not overflow when adding to this number for the pending generation below
+            final long generation = randomNonNegativeLong() / 2L;
+            entries.add(new RepositoryMetaData(randomAlphaOfLength(10), randomAlphaOfLength(10), randomSettings(), generation,
+                generation + randomLongBetween(0, generation)));
         }
         entries.sort(Comparator.comparing(RepositoryMetaData::name));
         return new RepositoriesMetaData(entries);
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java b/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
index 0ec69bdaa0424..e31ad37296093 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
@@ -1321,9 +1321,8 @@ public void testDeleteSnapshot() throws Exception {
 
         logger.info("--> delete the last snapshot");
         client.admin().cluster().prepareDeleteSnapshot("test-repo", lastSnapshot).get();
-        logger.info("--> make sure that number of files is back to what it was when the first snapshot was made, " +
-                    "plus one because one backup index-N file should remain");
-        assertFileCount(repo, numberOfFiles[0] + 1);
+        logger.info("--> make sure that number of files is back to what it was when the first snapshot was made");
+        assertFileCount(repo, numberOfFiles[0]);
     }
 
     public void testGetSnapshotsNoRepos() {
diff --git a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
index 0931ceb494827..880008a96b90b 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
@@ -282,13 +282,13 @@ public Map<String, BlobMetaData> listBlobsByPrefix(String blobNamePrefix) {
                         .collect(Collectors.toList())));
             }
 
-            // Randomly filter out the latest /index-N blob from a listing to test that tracking of it in latestKnownRepoGen
-            // overrides an inconsistent listing
+            // Randomly filter out the index-N blobs from a listing to test that tracking of it in latestKnownRepoGen and the cluster state
+            // ensures consistent repository operations
             private Map<String, BlobMetaData> maybeMissLatestIndexN(Map<String, BlobMetaData> listing) {
-                // Only filter out latest index-N at the repo root and only as long as we're not in a forced consistent state
-                if (path.parent() == null && context.consistent == false && random.nextBoolean()) {
+                // Randomly filter out index-N blobs at the repo root to proof that we don't need them to be consistently listed
+                if (path.parent() == null && context.consistent == false) {
                     final Map<String, BlobMetaData> filtered = new HashMap<>(listing);
-                    filtered.remove(BlobStoreRepository.INDEX_FILE_PREFIX + latestKnownRepoGen.get());
+                    filtered.keySet().removeIf(b -> b.startsWith(BlobStoreRepository.INDEX_FILE_PREFIX) && random.nextBoolean());
                     return Map.copyOf(filtered);
                 }
                 return listing;
diff --git a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
index f1cf314e3158a..e4e6d99c6e6f0 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.settings.Settings;
@@ -134,9 +135,11 @@ public void testOverwriteShardSnapBlobFails() throws IOException {
 
     public void testOverwriteSnapshotInfoBlob() {
         MockEventuallyConsistentRepository.Context blobStoreContext = new MockEventuallyConsistentRepository.Context();
-        try (BlobStoreRepository repository = new MockEventuallyConsistentRepository(
-            new RepositoryMetaData("testRepo", "mockEventuallyConsistent", Settings.EMPTY),
-            xContentRegistry(), BlobStoreTestUtil.mockClusterService(), blobStoreContext, random())) {
+        final RepositoryMetaData metaData = new RepositoryMetaData("testRepo", "mockEventuallyConsistent", Settings.EMPTY);
+        final ClusterService clusterService = BlobStoreTestUtil.mockClusterService(metaData);
+        try (BlobStoreRepository repository =
+                 new MockEventuallyConsistentRepository(metaData, xContentRegistry(), clusterService, blobStoreContext, random())) {
+            clusterService.addStateApplier(event -> repository.updateState(event.state()));
             repository.start();
 
             // We create a snap- blob for snapshot "foo" in the first generation
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
index 66c49db542dab..12130a1dd330a 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
@@ -26,6 +26,9 @@
 import org.elasticsearch.cluster.ClusterStateApplier;
 import org.elasticsearch.cluster.ClusterStateUpdateTask;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.metadata.RepositoriesMetaData;
+import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.cluster.service.ClusterApplierService;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
@@ -292,11 +295,29 @@ public static void assertBlobsByPrefix(BlobStoreRepository repository, BlobPath
 
     /**
      * Creates a mocked {@link ClusterService} for use in {@link BlobStoreRepository} related tests that mocks out all the necessary
-     * functionality to make {@link BlobStoreRepository} work.
+     * functionality to make {@link BlobStoreRepository} work. Initializes the cluster state as {@link ClusterState#EMPTY_STATE}.
      *
      * @return Mock ClusterService
      */
     public static ClusterService mockClusterService() {
+        return mockClusterService(ClusterState.EMPTY_STATE);
+    }
+
+    /**
+     * Creates a mocked {@link ClusterService} for use in {@link BlobStoreRepository} related tests that mocks out all the necessary
+     * functionality to make {@link BlobStoreRepository} work. Initializes the cluster state with a {@link RepositoriesMetaData} instance
+     * that contains the given {@code metadata}.
+     *
+     * @param metaData RepositoryMetaData to initialize the cluster state with
+     * @return Mock ClusterService
+     */
+    public static ClusterService mockClusterService(RepositoryMetaData metaData) {
+        return mockClusterService(ClusterState.builder(ClusterState.EMPTY_STATE).metaData(
+            MetaData.builder().putCustom(RepositoriesMetaData.TYPE,
+                new RepositoriesMetaData(Collections.singletonList(metaData))).build()).build());
+    }
+
+    private static ClusterService mockClusterService(ClusterState initialState) {
         final ThreadPool threadPool = mock(ThreadPool.class);
         when(threadPool.executor(ThreadPool.Names.SNAPSHOT)).thenReturn(new SameThreadExecutorService());
         when(threadPool.generic()).thenReturn(new SameThreadExecutorService());
@@ -305,7 +326,7 @@ public static ClusterService mockClusterService() {
         final ClusterService clusterService = mock(ClusterService.class);
         final ClusterApplierService clusterApplierService = mock(ClusterApplierService.class);
         when(clusterService.getClusterApplierService()).thenReturn(clusterApplierService);
-        final AtomicReference<ClusterState> currentState = new AtomicReference<>(ClusterState.EMPTY_STATE);
+        final AtomicReference<ClusterState> currentState = new AtomicReference<>(initialState);
         when(clusterService.state()).then(invocationOnMock -> currentState.get());
         final List<ClusterStateApplier> appliers = new CopyOnWriteArrayList<>();
         doAnswer(invocation -> {
diff --git a/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java b/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
index 218c6f4eecac7..6c05cc625f5cb 100644
--- a/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
+++ b/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
@@ -100,6 +100,8 @@ public long getFailureCount() {
 
     private final String randomPrefix;
 
+    private final Environment env;
+
     private volatile boolean blockOnControlFiles;
 
     private volatile boolean blockOnDataFiles;
@@ -125,9 +127,15 @@ public MockRepository(RepositoryMetaData metadata, Environment environment,
         blockAndFailOnWriteSnapFile = metadata.settings().getAsBoolean("block_on_snap", false);
         randomPrefix = metadata.settings().get("random", "default");
         waitAfterUnblock = metadata.settings().getAsLong("wait_after_unblock", 0L);
+        env = environment;
         logger.info("starting mock repository with random prefix {}", randomPrefix);
     }
 
+    @Override
+    public RepositoryMetaData getMetadata() {
+        return overrideSettings(super.getMetadata(), env);
+    }
+
     private static RepositoryMetaData overrideSettings(RepositoryMetaData metadata, Environment environment) {
         // TODO: use another method of testing not being able to read the test file written by the master...
         // this is super duper hacky
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
index 03ca8d5cfff28..dba66e0b1b1db 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
@@ -352,7 +352,8 @@ private Environment createEnvironment() {
     private Repository createRepository() {
         Settings settings = Settings.builder().put("location", randomAlphaOfLength(10)).build();
         RepositoryMetaData repositoryMetaData = new RepositoryMetaData(randomAlphaOfLength(10), FsRepository.TYPE, settings);
-        return new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(), BlobStoreTestUtil.mockClusterService());
+        return new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(),
+            BlobStoreTestUtil.mockClusterService(repositoryMetaData));
     }
 
     private static void runAsSnapshot(ThreadPool pool, Runnable runnable) {

From b1f4a8578bfb09917e2c9fb4fa085650421a8162 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Wed, 4 Dec 2019 12:16:36 +0000
Subject: [PATCH 066/686] [CI] Interval queries cannot be cached if they use
 scripts (#49824)

#49793 added test coverage for interval queries that contain script filters, but did
not adjust testCacheability(), which how fails occasionally when given a random
interval source containing a script. This commit overrides testCacheability() to
explicitly sources with and without script filters.

Fixes #49821
---
 .../query/IntervalQueryBuilderTests.java      | 44 +++++++++++++------
 1 file changed, 31 insertions(+), 13 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index 5fd91848a7064..7375b5951948f 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -52,7 +52,7 @@ public class IntervalQueryBuilderTests extends AbstractQueryTestCase<IntervalQue
 
     @Override
     protected IntervalQueryBuilder doCreateTestQueryBuilder() {
-        return new IntervalQueryBuilder(STRING_FIELD_NAME, createRandomSource(0));
+        return new IntervalQueryBuilder(STRING_FIELD_NAME, createRandomSource(0, true));
     }
 
     private static final String[] filters = new String[]{
@@ -84,9 +84,9 @@ protected void initializeAdditionalMappings(MapperService mapperService) throws
             new CompressedXContent(Strings.toString(mapping)), MapperService.MergeReason.MAPPING_UPDATE);
     }
 
-    private IntervalsSourceProvider createRandomSource(int depth) {
+    private IntervalsSourceProvider createRandomSource(int depth, boolean useScripts) {
         if (depth > 3) {
-            return createRandomMatch(depth + 1);
+            return createRandomMatch(depth + 1, useScripts);
         }
         switch (randomInt(20)) {
             case 0:
@@ -94,29 +94,29 @@ private IntervalsSourceProvider createRandomSource(int depth) {
                 int orCount = randomInt(4) + 1;
                 List<IntervalsSourceProvider> orSources = new ArrayList<>();
                 for (int i = 0; i < orCount; i++) {
-                    orSources.add(createRandomSource(depth + 1));
+                    orSources.add(createRandomSource(depth + 1, useScripts));
                 }
-                return new IntervalsSourceProvider.Disjunction(orSources, createRandomFilter(depth + 1));
+                return new IntervalsSourceProvider.Disjunction(orSources, createRandomFilter(depth + 1, useScripts));
             case 2:
             case 3:
                 int count = randomInt(5) + 1;
                 List<IntervalsSourceProvider> subSources = new ArrayList<>();
                 for (int i = 0; i < count; i++) {
-                    subSources.add(createRandomSource(depth + 1));
+                    subSources.add(createRandomSource(depth + 1, useScripts));
                 }
                 boolean ordered = randomBoolean();
                 int maxGaps = randomInt(5) - 1;
-                IntervalsSourceProvider.IntervalFilter filter = createRandomFilter(depth + 1);
+                IntervalsSourceProvider.IntervalFilter filter = createRandomFilter(depth + 1, useScripts);
                 return new IntervalsSourceProvider.Combine(subSources, ordered, maxGaps, filter);
             default:
-                return createRandomMatch(depth + 1);
+                return createRandomMatch(depth + 1, useScripts);
         }
     }
 
-    private IntervalsSourceProvider.IntervalFilter createRandomFilter(int depth) {
+    private IntervalsSourceProvider.IntervalFilter createRandomFilter(int depth, boolean useScripts) {
         if (depth < 3 && randomInt(20) > 18) {
-            if (randomBoolean()) {
-                return new IntervalsSourceProvider.IntervalFilter(createRandomSource(depth + 1), randomFrom(filters));
+            if (useScripts == false || randomBoolean()) {
+                return new IntervalsSourceProvider.IntervalFilter(createRandomSource(depth + 1, false), randomFrom(filters));
             }
             return new IntervalsSourceProvider.IntervalFilter(
                 new Script(ScriptType.INLINE, "mockscript", "1", Collections.emptyMap()));
@@ -124,7 +124,7 @@ private IntervalsSourceProvider.IntervalFilter createRandomFilter(int depth) {
         return null;
     }
 
-    private IntervalsSourceProvider createRandomMatch(int depth) {
+    private IntervalsSourceProvider createRandomMatch(int depth, boolean useScripts) {
         String useField = rarely() ? MASKED_FIELD : null;
         int wordCount = randomInt(4) + 1;
         List<String> words = new ArrayList<>();
@@ -135,7 +135,25 @@ private IntervalsSourceProvider createRandomMatch(int depth) {
         boolean mOrdered = randomBoolean();
         int maxMGaps = randomInt(5) - 1;
         String analyzer = randomFrom("simple", "keyword", "whitespace");
-        return new IntervalsSourceProvider.Match(text, maxMGaps, mOrdered, analyzer, createRandomFilter(depth + 1), useField);
+        return new IntervalsSourceProvider.Match(text, maxMGaps, mOrdered, analyzer, createRandomFilter(depth + 1, useScripts), useField);
+    }
+
+    @Override
+    public void testCacheability() throws IOException {
+        IntervalQueryBuilder queryBuilder = new IntervalQueryBuilder(STRING_FIELD_NAME, createRandomSource(0, false));
+        QueryShardContext context = createShardContext();
+        QueryBuilder rewriteQuery = rewriteQuery(queryBuilder, new QueryShardContext(context));
+        assertNotNull(rewriteQuery.toQuery(context));
+        assertTrue("query should be cacheable: " + queryBuilder.toString(), context.isCacheable());
+
+        IntervalsSourceProvider.IntervalFilter scriptFilter = new IntervalsSourceProvider.IntervalFilter(
+            new Script(ScriptType.INLINE, "mockscript", "1", Collections.emptyMap())
+        );
+        IntervalsSourceProvider source = new IntervalsSourceProvider.Match("text", 0, true, "simple", scriptFilter, null);
+        queryBuilder = new IntervalQueryBuilder(STRING_FIELD_NAME, source);
+        rewriteQuery = rewriteQuery(queryBuilder, new QueryShardContext(context));
+        assertNotNull(rewriteQuery.toQuery(context));
+        assertFalse("query with scripts should not be cacheable: " + queryBuilder.toString(), context.isCacheable());
     }
 
     @Override

From 88baca32ead1407734532f7c70db9a953da30d77 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Wed, 4 Dec 2019 12:19:21 +0000
Subject: [PATCH 067/686] Fix merge conflict

---
 .../elasticsearch/index/query/IntervalQueryBuilderTests.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index 7375b5951948f..7b004db65da50 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -169,7 +169,7 @@ public IntervalQueryBuilder mutateInstance(IntervalQueryBuilder instance) throws
         if (randomBoolean()) {
             return new IntervalQueryBuilder(STRING_FIELD_NAME_2, instance.getSourceProvider());
         }
-        return new IntervalQueryBuilder(STRING_FIELD_NAME, createRandomSource(0));
+        return new IntervalQueryBuilder(STRING_FIELD_NAME, createRandomSource(0, true));
     }
 
     public void testMatchInterval() throws IOException {

From b44803fadbeae9332eb5af6a707f9dac47bf4180 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Wed, 4 Dec 2019 13:49:43 +0100
Subject: [PATCH 068/686] Add SecureSM support for newer IDEA versions (#49747)

IntelliJ IDEA moved their JUnit runner to a different package. While this does not break running
tests in IDEA, it leads to an ugly exception being thrown at the end of the tests:

Exception in thread "main" java.lang.SecurityException: java.lang.System#exit(0) calls are not
allowed
	at org.elasticsearch.secure_sm.SecureSM$2.run(SecureSM.java:248)
	at org.elasticsearch.secure_sm.SecureSM$2.run(SecureSM.java:215)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:310)
	at org.elasticsearch.secure_sm.SecureSM.innerCheckExit(SecureSM.java:215)
	at org.elasticsearch.secure_sm.SecureSM.checkExit(SecureSM.java:206)
	at java.base/java.lang.Runtime.exit(Runtime.java:111)
	at java.base/java.lang.System.exit(System.java:1781)
	at com.intellij.rt.junit.JUnitStarter.main(JUnitStarter.java:59)

This commit adds support for newer IDEA versions in SecureSM.
---
 .../org/elasticsearch/secure_sm/SecureSM.java | 38 ++++++++++---------
 1 file changed, 20 insertions(+), 18 deletions(-)

diff --git a/libs/secure-sm/src/main/java/org/elasticsearch/secure_sm/SecureSM.java b/libs/secure-sm/src/main/java/org/elasticsearch/secure_sm/SecureSM.java
index 812643d2835e0..bddb111f45bb6 100644
--- a/libs/secure-sm/src/main/java/org/elasticsearch/secure_sm/SecureSM.java
+++ b/libs/secure-sm/src/main/java/org/elasticsearch/secure_sm/SecureSM.java
@@ -46,16 +46,16 @@
  * <ul>
  *   <li>{@code modifyThread} and {@code modifyThreadGroup} are required for any thread access
  *       checks: with these permissions, access is granted as long as the thread group is
- *       the same or an ancestor ({@code sourceGroup.parentOf(targetGroup) == true}). 
+ *       the same or an ancestor ({@code sourceGroup.parentOf(targetGroup) == true}).
  *   <li>code without these permissions can do very little, except to interrupt itself. It may
  *       not even create new threads.
- *   <li>very special cases (like test runners) that have {@link ThreadPermission} can violate 
+ *   <li>very special cases (like test runners) that have {@link ThreadPermission} can violate
  *       threadgroup security rules.
  * </ul>
  * <p>
  * If java security debugging ({@code java.security.debug}) is enabled, and this SecurityManager
  * is installed, it will emit additional debugging information when threadgroup access checks fail.
- *  
+ *
  * @see SecurityManager#checkAccess(Thread)
  * @see SecurityManager#checkAccess(ThreadGroup)
  * @see <a href="http://cs.oswego.edu/pipermail/concurrency-interest/2009-August/006508.html">
@@ -105,8 +105,10 @@ public static SecureSM createTestSecureSM() {
         "com\\.carrotsearch\\.ant\\.tasks\\.junit4\\.slave\\..*",
         // eclipse test runner
         "org\\.eclipse.jdt\\.internal\\.junit\\.runner\\..*",
-        // intellij test runner
-        "com\\.intellij\\.rt\\.execution\\.junit\\..*"
+        // intellij test runner (before IDEA version 2019.3)
+        "com\\.intellij\\.rt\\.execution\\.junit\\..*",
+        // intellij test runner (since IDEA version 2019.3)
+        "com\\.intellij\\.rt\\.junit\\..*"
     };
 
     // java.security.debug support
@@ -122,7 +124,7 @@ public Boolean run() {
             }
         }
     });
-    
+
     @Override
     @SuppressForbidden(reason = "java.security.debug messages go to standard error")
     public void checkAccess(Thread t) {
@@ -137,7 +139,7 @@ public void checkAccess(Thread t) {
             throw e;
         }
     }
-    
+
     @Override
     @SuppressForbidden(reason = "java.security.debug messages go to standard error")
     public void checkAccess(ThreadGroup g) {
@@ -157,7 +159,7 @@ private void debugThreadGroups(final ThreadGroup caller, final ThreadGroup targe
         System.err.println("access: caller group=" + caller);
         System.err.println("access: target group=" + target);
     }
-    
+
     // thread permission logic
 
     private static final Permission MODIFY_THREAD_PERMISSION = new RuntimePermission("modifyThread");
@@ -168,31 +170,31 @@ protected void checkThreadAccess(Thread t) {
 
         // first, check if we can modify threads at all.
         checkPermission(MODIFY_THREAD_PERMISSION);
-        
+
         // check the threadgroup, if its our thread group or an ancestor, its fine.
         final ThreadGroup source = Thread.currentThread().getThreadGroup();
         final ThreadGroup target = t.getThreadGroup();
-        
+
         if (target == null) {
             return;    // its a dead thread, do nothing.
         } else if (source.parentOf(target) == false) {
             checkPermission(MODIFY_ARBITRARY_THREAD_PERMISSION);
         }
     }
-    
+
     private static final Permission MODIFY_THREADGROUP_PERMISSION = new RuntimePermission("modifyThreadGroup");
     private static final Permission MODIFY_ARBITRARY_THREADGROUP_PERMISSION = new ThreadPermission("modifyArbitraryThreadGroup");
-    
+
     protected void checkThreadGroupAccess(ThreadGroup g) {
         Objects.requireNonNull(g);
 
         // first, check if we can modify thread groups at all.
         checkPermission(MODIFY_THREADGROUP_PERMISSION);
-        
+
         // check the threadgroup, if its our thread group or an ancestor, its fine.
         final ThreadGroup source = Thread.currentThread().getThreadGroup();
         final ThreadGroup target = g;
-        
+
         if (source == null) {
             return; // we are a dead thread, do nothing
         } else if (source.parentOf(target) == false) {
@@ -205,7 +207,7 @@ protected void checkThreadGroupAccess(ThreadGroup g) {
     public void checkExit(int status) {
         innerCheckExit(status);
     }
-    
+
     /**
      * The "Uwe Schindler" algorithm.
      *
@@ -227,7 +229,7 @@ public Void run() {
                         exitMethodHit = className + '#' + methodName + '(' + status + ')';
                         continue;
                     }
-                    
+
                     if (exitMethodHit != null) {
                         if (classesThatCanExit == null) {
                             break;
@@ -240,7 +242,7 @@ public Void run() {
                         break;
                     }
                 }
-                
+
                 if (exitMethodHit == null) {
                     // should never happen, only if JVM hides stack trace - replace by generic:
                     exitMethodHit = "JVM exit method";
@@ -248,7 +250,7 @@ public Void run() {
                 throw new SecurityException(exitMethodHit + " calls are not allowed");
             }
         });
-        
+
         // we passed the stack check, delegate to super, so default policy can still deny permission:
         super.checkExit(status);
     }

From cf7c77b527c39a602564340a3fb9cfe21018e45a Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Wed, 4 Dec 2019 15:54:56 +0100
Subject: [PATCH 069/686] Stop Allocating Buffers in CopyBytesSocketChannel
 (#49825)

The way things currently work, we read up to 1M from the channel
and then potentially force all of it into the `ByteBuf` passed
by Netty. Since that `ByteBuf` tends to by default be `64k` in size,
large reads will force the buffer to grow, completely circumventing
the logic of `allocHandle`.

This seems like it could break
`io.netty.channel.RecvByteBufAllocator.Handle#continueReading`
since that method for the fixed-size allocator does check
whether the last read was equal to the attempted read size.
So if we set `64k` because that's what the buffer size is,
then wirte `1M` to the buffer we will stop reading on the IO loop,
even though the channel may still have bytes that we can read right away.

More imporatantly though, this can lead to running OOM quite easily
under IO pressure as we are forcing the heap buffers passed to the read
to `reallocate`.

Closes #49699
---
 .../org/elasticsearch/transport/CopyBytesSocketChannel.java  | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/modules/transport-netty4/src/main/java/org/elasticsearch/transport/CopyBytesSocketChannel.java b/modules/transport-netty4/src/main/java/org/elasticsearch/transport/CopyBytesSocketChannel.java
index 60e63ba786536..711dcc095b517 100644
--- a/modules/transport-netty4/src/main/java/org/elasticsearch/transport/CopyBytesSocketChannel.java
+++ b/modules/transport-netty4/src/main/java/org/elasticsearch/transport/CopyBytesSocketChannel.java
@@ -119,8 +119,9 @@ protected void doWrite(ChannelOutboundBuffer in) throws Exception {
     @Override
     protected int doReadBytes(ByteBuf byteBuf) throws Exception {
         final RecvByteBufAllocator.Handle allocHandle = unsafe().recvBufAllocHandle();
-        allocHandle.attemptedBytesRead(byteBuf.writableBytes());
-        ByteBuffer ioBuffer = getIoBuffer();
+        int writeableBytes = Math.min(byteBuf.writableBytes(), MAX_BYTES_PER_WRITE);
+        allocHandle.attemptedBytesRead(writeableBytes);
+        ByteBuffer ioBuffer = getIoBuffer().limit(writeableBytes);
         int bytesRead = readFromSocketChannel(javaChannel(), ioBuffer);
         ioBuffer.flip();
         if (bytesRead > 0) {

From 42dc5a77c26bcbc7dc2c7771617a1e3face19f3f Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 4 Dec 2019 09:58:19 -0500
Subject: [PATCH 070/686] [DOCS] Reformat length token filter docs (#49805)

* Adds a title abbreviation
* Updates the description and adds a Lucene link
* Reformats the parameters section
* Adds analyze, custom analyzer, and custom filter snippets

Relates to #44726.
---
 .../tokenfilters/length-tokenfilter.asciidoc  | 176 ++++++++++++++++--
 1 file changed, 165 insertions(+), 11 deletions(-)

diff --git a/docs/reference/analysis/tokenfilters/length-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/length-tokenfilter.asciidoc
index e53a198df5570..4bbe60e52be26 100644
--- a/docs/reference/analysis/tokenfilters/length-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/length-tokenfilter.asciidoc
@@ -1,16 +1,170 @@
 [[analysis-length-tokenfilter]]
-=== Length Token Filter
+=== Length token filter
+++++
+<titleabbrev>Length</titleabbrev>
+++++
 
-A token filter of type `length` that removes words that are too long or
-too short for the stream.
+Removes tokens shorter or longer than specified character lengths.
+For example, you can use the `length` filter to exclude tokens shorter than 2
+characters and tokens longer than 5 characters.
 
-The following are settings that can be set for a `length` token filter
-type:
+This filter uses Lucene's
+https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/miscellaneous/LengthFilter.html[LengthFilter].
 
-[cols="<,<",options="header",]
-|===========================================================
-|Setting |Description
-|`min` |The minimum number. Defaults to `0`.
-|`max` |The maximum number. Defaults to `Integer.MAX_VALUE`, which is `2^31-1` or 2147483647.
-|===========================================================
+[TIP]
+====
+The `length` filter removes entire tokens. If you'd prefer to shorten tokens to
+a specific length, use the <<analysis-truncate-tokenfilter,`truncate`>> filter.
+====
 
+[[analysis-length-tokenfilter-analyze-ex]]
+==== Example
+
+The following <<indices-analyze,analyze API>> request uses the `length`
+filter to remove tokens longer than 4 characters:
+
+[source,console]
+--------------------------------------------------
+GET _analyze
+{
+  "tokenizer": "whitespace",
+  "filter": [
+    {
+      "type": "length",
+      "min": 0,
+      "max": 4
+    }
+  ],
+  "text": "the quick brown fox jumps over the lazy dog"
+}
+--------------------------------------------------
+
+The filter produces the following tokens:
+
+[source,text]
+--------------------------------------------------
+[ the, fox, over, the, lazy, dog ]
+--------------------------------------------------
+
+/////////////////////
+[source,console-result]
+--------------------------------------------------
+{
+  "tokens": [
+    {
+      "token": "the",
+      "start_offset": 0,
+      "end_offset": 3,
+      "type": "word",
+      "position": 0
+    },
+    {
+      "token": "fox",
+      "start_offset": 16,
+      "end_offset": 19,
+      "type": "word",
+      "position": 3
+    },
+    {
+      "token": "over",
+      "start_offset": 26,
+      "end_offset": 30,
+      "type": "word",
+      "position": 5
+    },
+    {
+      "token": "the",
+      "start_offset": 31,
+      "end_offset": 34,
+      "type": "word",
+      "position": 6
+    },
+    {
+      "token": "lazy",
+      "start_offset": 35,
+      "end_offset": 39,
+      "type": "word",
+      "position": 7
+    },
+    {
+      "token": "dog",
+      "start_offset": 40,
+      "end_offset": 43,
+      "type": "word",
+      "position": 8
+    }
+  ]
+}
+--------------------------------------------------
+/////////////////////
+
+[[analysis-length-tokenfilter-analyzer-ex]]
+==== Add to an analyzer
+
+The following <<indices-create-index,create index API>> request uses the
+`length` filter to configure a new 
+<<analysis-custom-analyzer,custom analyzer>>.
+
+[source,console]
+--------------------------------------------------
+PUT length_example
+{
+  "settings": {
+    "analysis": {
+      "analyzer": {
+        "standard_length": {
+          "tokenizer": "standard",
+          "filter": [ "length" ]
+        }
+      }
+    }
+  }
+}
+--------------------------------------------------
+
+[[analysis-length-tokenfilter-configure-parms]]
+==== Configurable parameters
+
+`min`::
+(Optional, integer)
+Minimum character length of a token. Shorter tokens are excluded from the
+output. Defaults to `0`.
+
+`max`::
+(Optional, integer)
+Maximum character length of a token. Longer tokens are excluded from the output.
+Defaults to `Integer.MAX_VALUE`, which is `2^31-1` or `2147483647`.
+
+[[analysis-length-tokenfilter-customize]]
+==== Customize
+
+To customize the `length` filter, duplicate it to create the basis
+for a new custom token filter. You can modify the filter using its configurable
+parameters.
+
+For example, the following request creates a custom `length` filter that removes
+tokens shorter than 2 characters and tokens longer than 10 characters:
+
+[source,console]
+--------------------------------------------------
+PUT length_custom_example
+{
+  "settings": {
+    "analysis": {
+      "analyzer": {
+        "whitespace_length_2_to_10_char": {
+          "tokenizer": "whitespace",
+          "filter": [ "length_2_to_10_char" ]
+        }
+      },
+      "filter": {
+        "length_2_to_10_char": {
+          "type": "length",
+          "min": 2,
+          "max": 10
+        }
+      }
+    }
+  }
+}
+--------------------------------------------------

From 8a65b6d08795bf58dddddd47e23caf03144baf12 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Wed, 4 Dec 2019 17:22:15 +0200
Subject: [PATCH 071/686] [ML][HLRC] DF analytics setVersion and setCreateTime
 should not be public (#49826)

`version` and `create_time` are assigned from the action itself and thus should not
be able to be set from the client.
---
 .../client/ml/dataframe/DataFrameAnalyticsConfig.java         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsConfig.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsConfig.java
index d4684bde70769..0c3f98b9a46ad 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsConfig.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsConfig.java
@@ -283,12 +283,12 @@ public Builder setModelMemoryLimit(ByteSizeValue modelMemoryLimit) {
             return this;
         }
 
-        public Builder setCreateTime(Instant createTime) {
+        Builder setCreateTime(Instant createTime) {
             this.createTime = createTime;
             return this;
         }
 
-        public Builder setVersion(Version version) {
+        Builder setVersion(Version version) {
             this.version = version;
             return this;
         }

From 8f8e0e638e7a8f487d38b05558c89f750e3b0cd7 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Wed, 4 Dec 2019 16:50:15 +0100
Subject: [PATCH 072/686] Fix concurrent issue in SearchPhaseController
 (#49829)

The list used by the search progress listener can be nullified
by another thread that reports a query result. This change replaces
the usage of this list with a new array that is synchronously modified.

Closes #49778
---
 .../action/search/SearchPhaseController.java             | 6 +++++-
 .../action/search/SearchProgressListener.java            | 9 +++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/action/search/SearchPhaseController.java b/server/src/main/java/org/elasticsearch/action/search/SearchPhaseController.java
index b3562cc002b5b..0bd7afa7f61c2 100644
--- a/server/src/main/java/org/elasticsearch/action/search/SearchPhaseController.java
+++ b/server/src/main/java/org/elasticsearch/action/search/SearchPhaseController.java
@@ -39,6 +39,7 @@
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.search.SearchHits;
 import org.elasticsearch.search.SearchPhaseResult;
+import org.elasticsearch.search.SearchShardTarget;
 import org.elasticsearch.search.aggregations.InternalAggregation;
 import org.elasticsearch.search.aggregations.InternalAggregation.ReduceContext;
 import org.elasticsearch.search.aggregations.InternalAggregations;
@@ -564,6 +565,7 @@ public InternalSearchResponse buildResponse(SearchHits hits) {
      * iff the buffer is exhausted.
      */
     static final class QueryPhaseResultConsumer extends ArraySearchPhaseResults<SearchPhaseResult> {
+        private final SearchShardTarget[] processedShards;
         private final InternalAggregations[] aggsBuffer;
         private final TopDocs[] topDocsBuffer;
         private final boolean hasAggs;
@@ -600,6 +602,7 @@ private QueryPhaseResultConsumer(SearchProgressListener progressListener, Search
             }
             this.controller = controller;
             this.progressListener = progressListener;
+            this.processedShards = new SearchShardTarget[expectedResultSize];
             // no need to buffer anything if we have less expected results. in this case we don't consume any results ahead of time.
             this.aggsBuffer = new InternalAggregations[hasAggs ? bufferSize : 0];
             this.topDocsBuffer = new TopDocs[hasTopDocs ? bufferSize : 0];
@@ -636,7 +639,7 @@ private synchronized void consumeInternal(QuerySearchResult querySearchResult) {
                 numReducePhases++;
                 index = 1;
                 if (hasAggs) {
-                    progressListener.notifyPartialReduce(progressListener.searchShards(results.asList()),
+                    progressListener.notifyPartialReduce(progressListener.searchShards(processedShards),
                         topDocsStats.getTotalHits(), aggsBuffer[0], numReducePhases);
                 }
             }
@@ -650,6 +653,7 @@ private synchronized void consumeInternal(QuerySearchResult querySearchResult) {
                 setShardIndex(topDocs.topDocs, querySearchResult.getShardIndex());
                 topDocsBuffer[i] = topDocs.topDocs;
             }
+            processedShards[querySearchResult.getShardIndex()] = querySearchResult.getSearchShardTarget();
         }
 
         private synchronized List<InternalAggregations> getRemainingAggs() {
diff --git a/server/src/main/java/org/elasticsearch/action/search/SearchProgressListener.java b/server/src/main/java/org/elasticsearch/action/search/SearchProgressListener.java
index c5b3d35159491..87146719a0f52 100644
--- a/server/src/main/java/org/elasticsearch/action/search/SearchProgressListener.java
+++ b/server/src/main/java/org/elasticsearch/action/search/SearchProgressListener.java
@@ -25,8 +25,10 @@
 import org.apache.lucene.search.TotalHits;
 import org.elasticsearch.cluster.routing.GroupShardsIterator;
 import org.elasticsearch.search.SearchPhaseResult;
+import org.elasticsearch.search.SearchShardTarget;
 import org.elasticsearch.search.aggregations.InternalAggregations;
 
+import java.util.Arrays;
 import java.util.List;
 import java.util.Objects;
 import java.util.stream.Collectors;
@@ -169,6 +171,13 @@ final List<SearchShard> searchShards(List<? extends SearchPhaseResult> results)
             .collect(Collectors.toUnmodifiableList());
     }
 
+    final List<SearchShard> searchShards(SearchShardTarget[] results) {
+        return Arrays.stream(results)
+            .filter(Objects::nonNull)
+            .map(e -> new SearchShard(e.getClusterAlias(), e.getShardId()))
+            .collect(Collectors.toUnmodifiableList());
+    }
+
     final List<SearchShard> searchShards(GroupShardsIterator<SearchShardIterator> its) {
         return StreamSupport.stream(its.spliterator(), false)
             .map(e -> new SearchShard(e.getClusterAlias(), e.shardId()))

From e013b1fc71577249aded2ce97cf01f0a3a04ddcb Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 4 Dec 2019 12:44:13 -0500
Subject: [PATCH 073/686] [DOCS] Document `minimum_should_match` defaults for
 `bool` query (#48865)

Adds documentation for the `minimum_should_match` parameter to the `bool` query docs. Includes docs for the default values:

- `1` if the `bool` query includes at least one `should` clause and no `must` or `filter` clauses
- `0` otherwise
---
 docs/reference/query-dsl/bool-query.asciidoc | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/reference/query-dsl/bool-query.asciidoc b/docs/reference/query-dsl/bool-query.asciidoc
index 2d84ff057415d..6594c982c44b7 100644
--- a/docs/reference/query-dsl/bool-query.asciidoc
+++ b/docs/reference/query-dsl/bool-query.asciidoc
@@ -60,6 +60,19 @@ POST _search
 }
 --------------------------------------------------
 
+[[bool-min-should-match]]
+==== Using `minimum_should_match`
+
+You can use the `minimum_should_match` parameter to specify the number or
+percentage of `should` clauses returned documents _must_ match.
+
+If the `bool` query includes at least one `should` clause and no `must` or
+`filter` clauses, the default value is `1`.
+Otherwise, the default value is `0`.
+
+For other valid values, see the
+<<query-dsl-minimum-should-match, `minimum_should_match` parameter>>.
+
 [[score-bool-filter]]
 ==== Scoring with `bool.filter`
 

From ba453c7ecef02ce30c6e34b41e51165de6675f2e Mon Sep 17 00:00:00 2001
From: zacharymorn <zacharymorn@gmail.com>
Date: Wed, 4 Dec 2019 11:32:01 -0800
Subject: [PATCH 074/686] Support es7 node http publish_address format (#49279)

Add parsing support to node http publish_address format cname/ip:port.
---
 .../sniff/ElasticsearchNodesSniffer.java      | 18 +++++++++--
 .../ElasticsearchNodesSnifferParseTests.java  | 22 ++++++++++++++
 .../es6_nodes_publication_address_format.json | 30 +++++++++++++++++++
 .../es7_nodes_publication_address_format.json | 30 +++++++++++++++++++
 4 files changed, 97 insertions(+), 3 deletions(-)
 create mode 100644 client/sniffer/src/test/resources/es6_nodes_publication_address_format.json
 create mode 100644 client/sniffer/src/test/resources/es7_nodes_publication_address_format.json

diff --git a/client/sniffer/src/main/java/org/elasticsearch/client/sniff/ElasticsearchNodesSniffer.java b/client/sniffer/src/main/java/org/elasticsearch/client/sniff/ElasticsearchNodesSniffer.java
index 5c947f5625ba0..e7f055bfe0101 100644
--- a/client/sniffer/src/main/java/org/elasticsearch/client/sniff/ElasticsearchNodesSniffer.java
+++ b/client/sniffer/src/main/java/org/elasticsearch/client/sniff/ElasticsearchNodesSniffer.java
@@ -164,9 +164,21 @@ private static Node readNode(String nodeId, JsonParser parser, Scheme scheme) th
                 if ("http".equals(fieldName)) {
                     while (parser.nextToken() != JsonToken.END_OBJECT) {
                         if (parser.getCurrentToken() == JsonToken.VALUE_STRING && "publish_address".equals(parser.getCurrentName())) {
-                            URI publishAddressAsURI = URI.create(scheme + "://" + parser.getValueAsString());
-                            publishedHost = new HttpHost(publishAddressAsURI.getHost(), publishAddressAsURI.getPort(),
-                                    publishAddressAsURI.getScheme());
+                            String address = parser.getValueAsString();
+                            String host;
+                            URI publishAddressAsURI;
+
+                            // ES7 cname/ip:port format
+                            if(address.contains("/")) {
+                                String[] cnameAndURI = address.split("/", 2);
+                                publishAddressAsURI = URI.create(scheme + "://" + cnameAndURI[1]);
+                                host = cnameAndURI[0];
+                            }
+                            else {
+                                publishAddressAsURI = URI.create(scheme + "://" + address);
+                                host = publishAddressAsURI.getHost();
+                            }
+                            publishedHost = new HttpHost(host, publishAddressAsURI.getPort(), publishAddressAsURI.getScheme());
                         } else if (parser.currentToken() == JsonToken.START_ARRAY && "bound_address".equals(parser.getCurrentName())) {
                             while (parser.nextToken() != JsonToken.END_ARRAY) {
                                 URI boundAddressAsURI = URI.create(scheme + "://" + parser.getValueAsString());
diff --git a/client/sniffer/src/test/java/org/elasticsearch/client/sniff/ElasticsearchNodesSnifferParseTests.java b/client/sniffer/src/test/java/org/elasticsearch/client/sniff/ElasticsearchNodesSnifferParseTests.java
index edc7330c13074..6a017e32728f2 100644
--- a/client/sniffer/src/test/java/org/elasticsearch/client/sniff/ElasticsearchNodesSnifferParseTests.java
+++ b/client/sniffer/src/test/java/org/elasticsearch/client/sniff/ElasticsearchNodesSnifferParseTests.java
@@ -107,6 +107,28 @@ public void test6x() throws IOException {
                 node(9207, "c2", "6.0.0", false, false, true));
     }
 
+    public void testParsingPublishAddressWithPreES7Format() throws IOException {
+        InputStream in = Thread.currentThread().getContextClassLoader().getResourceAsStream("es6_nodes_publication_address_format.json");
+
+        HttpEntity entity = new InputStreamEntity(in, ContentType.APPLICATION_JSON);
+        List<Node> nodes = ElasticsearchNodesSniffer.readHosts(entity, Scheme.HTTP, new JsonFactory());
+
+        assertEquals("127.0.0.1", nodes.get(0).getHost().getHostName());
+        assertEquals(9200, nodes.get(0).getHost().getPort());
+        assertEquals("http", nodes.get(0).getHost().getSchemeName());
+    }
+
+    public void testParsingPublishAddressWithES7Format() throws IOException {
+        InputStream in = Thread.currentThread().getContextClassLoader().getResourceAsStream("es7_nodes_publication_address_format.json");
+
+        HttpEntity entity = new InputStreamEntity(in, ContentType.APPLICATION_JSON);
+        List<Node> nodes = ElasticsearchNodesSniffer.readHosts(entity, Scheme.HTTP, new JsonFactory());
+
+        assertEquals("elastic.test", nodes.get(0).getHost().getHostName());
+        assertEquals(9200, nodes.get(0).getHost().getPort());
+        assertEquals("http", nodes.get(0).getHost().getSchemeName());
+    }
+
     private Node node(int port, String name, String version, boolean master, boolean data, boolean ingest) {
         HttpHost host = new HttpHost("127.0.0.1", port);
         Set<HttpHost> boundHosts = new HashSet<>(2);
diff --git a/client/sniffer/src/test/resources/es6_nodes_publication_address_format.json b/client/sniffer/src/test/resources/es6_nodes_publication_address_format.json
new file mode 100644
index 0000000000000..7ded043b81129
--- /dev/null
+++ b/client/sniffer/src/test/resources/es6_nodes_publication_address_format.json
@@ -0,0 +1,30 @@
+{
+  "_nodes": {
+    "total": 8,
+    "successful": 8,
+    "failed": 0
+  },
+  "cluster_name": "elasticsearch",
+  "nodes": {
+    "ikXK_skVTfWkhONhldnbkw": {
+      "name": "m1",
+      "transport_address": "127.0.0.1:9300",
+      "host": "127.0.0.1",
+      "ip": "127.0.0.1",
+      "version": "6.0.0",
+      "build_hash": "8f0685b",
+      "roles": [
+        "master",
+        "ingest"
+      ],
+      "attributes": { },
+      "http": {
+        "bound_address": [
+          "127.0.0.1:9200"
+        ],
+        "publish_address": "127.0.0.1:9200",
+        "max_content_length_in_bytes": 104857600
+      }
+    }
+  }
+}
diff --git a/client/sniffer/src/test/resources/es7_nodes_publication_address_format.json b/client/sniffer/src/test/resources/es7_nodes_publication_address_format.json
new file mode 100644
index 0000000000000..295bf3cbd2365
--- /dev/null
+++ b/client/sniffer/src/test/resources/es7_nodes_publication_address_format.json
@@ -0,0 +1,30 @@
+{
+  "_nodes": {
+    "total": 8,
+    "successful": 8,
+    "failed": 0
+  },
+  "cluster_name": "elasticsearch",
+  "nodes": {
+    "ikXK_skVTfWkhONhldnbkw": {
+      "name": "m1",
+      "transport_address": "127.0.0.1:9300",
+      "host": "127.0.0.1",
+      "ip": "127.0.0.1",
+      "version": "6.0.0",
+      "build_hash": "8f0685b",
+      "roles": [
+        "master",
+        "ingest"
+      ],
+      "attributes": { },
+      "http": {
+        "bound_address": [
+            "elastic.test:9200"
+        ],
+        "publish_address": "elastic.test/127.0.0.1:9200",
+        "max_content_length_in_bytes": 104857600
+      }
+    }
+  }
+}

From acaaea25d0e7f38cbe33528b1ac195f4f207d716 Mon Sep 17 00:00:00 2001
From: Jack Conradson <osjdconrad@gmail.com>
Date: Wed, 4 Dec 2019 11:43:55 -0800
Subject: [PATCH 075/686] Remove extraneous pass (#49797)

This removes the storeSettings pass where nodes in the AST could store
information they needed out of CompilerSettings for use during later
passes. CompilerSettings is part of ScriptRoot which is available during the
analysis pass making the storeSettings pass redundant.
---
 .../org/elasticsearch/painless/Compiler.java  |  6 ++----
 .../elasticsearch/painless/node/ANode.java    |  6 ------
 .../painless/node/EAssignment.java            | 10 ----------
 .../elasticsearch/painless/node/EBinary.java  |  7 -------
 .../elasticsearch/painless/node/EBool.java    |  7 -------
 .../elasticsearch/painless/node/EBoolean.java |  6 ------
 .../painless/node/ECallLocal.java             |  8 --------
 .../painless/node/ECapturingFunctionRef.java  |  6 ------
 .../elasticsearch/painless/node/ECast.java    |  6 ------
 .../elasticsearch/painless/node/EComp.java    |  7 -------
 .../painless/node/EConditional.java           |  8 --------
 .../painless/node/EConstant.java              |  6 ------
 .../elasticsearch/painless/node/EDecimal.java |  6 ------
 .../elasticsearch/painless/node/EElvis.java   |  7 -------
 .../painless/node/EExplicit.java              |  6 ------
 .../painless/node/EFunctionRef.java           |  6 ------
 .../painless/node/EInstanceof.java            |  6 ------
 .../elasticsearch/painless/node/ELambda.java  | 15 +-------------
 .../painless/node/EListInit.java              |  8 --------
 .../elasticsearch/painless/node/EMapInit.java | 12 -----------
 .../painless/node/ENewArray.java              |  8 --------
 .../painless/node/ENewArrayFunctionRef.java   | 11 +---------
 .../elasticsearch/painless/node/ENewObj.java  |  8 --------
 .../elasticsearch/painless/node/ENull.java    |  6 ------
 .../elasticsearch/painless/node/ENumeric.java |  6 ------
 .../elasticsearch/painless/node/ERegex.java   | 10 +---------
 .../elasticsearch/painless/node/EStatic.java  |  6 ------
 .../elasticsearch/painless/node/EString.java  |  6 ------
 .../elasticsearch/painless/node/EUnary.java   |  6 ------
 .../painless/node/EVariable.java              |  6 ------
 .../elasticsearch/painless/node/PBrace.java   |  7 -------
 .../painless/node/PCallInvoke.java            | 10 ----------
 .../elasticsearch/painless/node/PField.java   |  6 ------
 .../painless/node/PSubArrayLength.java        |  6 ------
 .../painless/node/PSubBrace.java              |  6 ------
 .../painless/node/PSubCallInvoke.java         |  6 ------
 .../painless/node/PSubDefArray.java           |  6 ------
 .../painless/node/PSubDefCall.java            |  6 ------
 .../painless/node/PSubDefField.java           |  6 ------
 .../painless/node/PSubField.java              |  6 ------
 .../painless/node/PSubListShortcut.java       |  6 ------
 .../painless/node/PSubMapShortcut.java        |  6 ------
 .../painless/node/PSubNullSafeCallInvoke.java |  6 ------
 .../painless/node/PSubNullSafeField.java      |  6 ------
 .../painless/node/PSubShortcut.java           |  6 ------
 .../elasticsearch/painless/node/SBlock.java   |  8 --------
 .../elasticsearch/painless/node/SBreak.java   |  6 ------
 .../elasticsearch/painless/node/SCatch.java   |  8 --------
 .../elasticsearch/painless/node/SClass.java   | 16 ++-------------
 .../painless/node/SContinue.java              |  6 ------
 .../painless/node/SDeclBlock.java             |  8 --------
 .../painless/node/SDeclaration.java           |  8 --------
 .../org/elasticsearch/painless/node/SDo.java  | 10 ----------
 .../elasticsearch/painless/node/SEach.java    | 10 ----------
 .../painless/node/SExpression.java            |  6 ------
 .../elasticsearch/painless/node/SField.java   |  6 ------
 .../org/elasticsearch/painless/node/SFor.java | 20 -------------------
 .../painless/node/SFunction.java              |  9 ++-------
 .../org/elasticsearch/painless/node/SIf.java  | 10 ----------
 .../elasticsearch/painless/node/SIfElse.java  | 14 -------------
 .../elasticsearch/painless/node/SReturn.java  |  8 --------
 .../painless/node/SSubEachArray.java          |  6 ------
 .../painless/node/SSubEachIterable.java       |  6 ------
 .../elasticsearch/painless/node/SThrow.java   |  6 ------
 .../org/elasticsearch/painless/node/STry.java | 12 -----------
 .../elasticsearch/painless/node/SWhile.java   | 10 ----------
 66 files changed, 9 insertions(+), 501 deletions(-)

diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/Compiler.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/Compiler.java
index c9cfad69cea2c..f6de8be896cb3 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/Compiler.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/Compiler.java
@@ -211,8 +211,7 @@ Constructor<?> compile(Loader loader, Set<String> extractedVariables, String nam
         ScriptClassInfo scriptClassInfo = new ScriptClassInfo(painlessLookup, scriptClass);
         SClass root = Walker.buildPainlessTree(scriptClassInfo, name, source, settings, painlessLookup, null);
         root.extractVariables(extractedVariables);
-        root.storeSettings(settings);
-        root.analyze(painlessLookup);
+        root.analyze(painlessLookup, settings);
         Map<String, Object> statics = root.write();
 
         try {
@@ -244,8 +243,7 @@ byte[] compile(String name, String source, CompilerSettings settings, Printer de
         SClass root = Walker.buildPainlessTree(scriptClassInfo, name, source, settings, painlessLookup,
                 debugStream);
         root.extractVariables(new HashSet<>());
-        root.storeSettings(settings);
-        root.analyze(painlessLookup);
+        root.analyze(painlessLookup, settings);
         root.write();
 
         return root.getBytes();
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ANode.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ANode.java
index ca821cf05f806..d6cc2f3c18508 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ANode.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ANode.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -56,11 +55,6 @@ public abstract class ANode {
         this.location = Objects.requireNonNull(location);
     }
 
-    /**
-     * Store settings required for future compiler passes.
-     */
-    abstract void storeSettings(CompilerSettings settings);
-
     /**
      * Adds all variable names referenced to the variable set.
      * <p>
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EAssignment.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EAssignment.java
index 655b511471dd0..c6fcc9820420e 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EAssignment.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EAssignment.java
@@ -22,7 +22,6 @@
 
 import org.elasticsearch.painless.AnalyzerCaster;
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -65,15 +64,6 @@ public EAssignment(Location location, AExpression lhs, AExpression rhs, boolean
         this.operation = operation;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        lhs.storeSettings(settings);
-
-        if (rhs != null) {
-            rhs.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         lhs.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBinary.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBinary.java
index 55f4a4deca4c2..7f67f16fb3b3c 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBinary.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBinary.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.painless.AnalyzerCaster;
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -60,12 +59,6 @@ public EBinary(Location location, Operation operation, AExpression left, AExpres
         this.right = Objects.requireNonNull(right);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        left.storeSettings(settings);
-        right.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         left.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBool.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBool.java
index 3012ab46617b1..c46242ff28aac 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBool.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBool.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -50,12 +49,6 @@ public EBool(Location location, Operation operation, AExpression left, AExpressi
         this.right = Objects.requireNonNull(right);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        left.storeSettings(settings);
-        right.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         left.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBoolean.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBoolean.java
index 42a3f3c46f6b4..e1c4fd05745f9 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBoolean.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EBoolean.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -40,11 +39,6 @@ public EBoolean(Location location, boolean constant) {
         this.constant = constant;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // Do nothing.
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECallLocal.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECallLocal.java
index b791589d1f836..e386f94d01b69 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECallLocal.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECallLocal.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -64,13 +63,6 @@ public ECallLocal(Location location, String name, List<AExpression> arguments) {
         this.arguments = Objects.requireNonNull(arguments);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        for (AExpression argument : arguments) {
-            argument.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         for (AExpression argument : arguments) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECapturingFunctionRef.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECapturingFunctionRef.java
index 50487e41a6b7b..00f2283472e49 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECapturingFunctionRef.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECapturingFunctionRef.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.FunctionRef;
 import org.elasticsearch.painless.Globals;
@@ -55,11 +54,6 @@ public ECapturingFunctionRef(Location location, String variable, String call) {
         this.call = Objects.requireNonNull(call);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // Do nothing.
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         variables.add(variable);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECast.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECast.java
index 2f9df0a5bec25..d33f37fb6049b 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECast.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECast.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -47,11 +46,6 @@ final class ECast extends AExpression {
         this.cast = Objects.requireNonNull(cast);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EComp.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EComp.java
index 79597ac0752ae..9ec21874234a0 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EComp.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EComp.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.painless.AnalyzerCaster;
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -59,12 +58,6 @@ public EComp(Location location, Operation operation, AExpression left, AExpressi
         this.right = Objects.requireNonNull(right);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        left.storeSettings(settings);
-        right.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         left.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EConditional.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EConditional.java
index c7c12a56e5c3f..c8263b587bb44 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EConditional.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EConditional.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.painless.AnalyzerCaster;
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -50,13 +49,6 @@ public EConditional(Location location, AExpression condition, AExpression left,
         this.right = Objects.requireNonNull(right);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        condition.storeSettings(settings);
-        left.storeSettings(settings);
-        right.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         condition.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EConstant.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EConstant.java
index 0a7de352f41a3..8698635359b9a 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EConstant.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EConstant.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -41,11 +40,6 @@ final class EConstant extends AExpression {
         this.constant = constant;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw new IllegalStateException("illegal tree structure");
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw new IllegalStateException("Illegal tree structure.");
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EDecimal.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EDecimal.java
index 19e788b0c48e6..faacb3cdc0282 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EDecimal.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EDecimal.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -43,11 +42,6 @@ public EDecimal(Location location, String value) {
         this.value = Objects.requireNonNull(value);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // Do nothing.
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EElvis.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EElvis.java
index 3ea6d56d959de..d5e494ffa3098 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EElvis.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EElvis.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.painless.AnalyzerCaster;
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -48,12 +47,6 @@ public EElvis(Location location, AExpression lhs, AExpression rhs) {
         this.rhs = requireNonNull(rhs);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        lhs.storeSettings(settings);
-        rhs.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         lhs.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EExplicit.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EExplicit.java
index a83d1ddcd705d..b092aef87de42 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EExplicit.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EExplicit.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -45,11 +44,6 @@ public EExplicit(Location location, String type, AExpression child) {
         this.child = Objects.requireNonNull(child);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        child.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         child.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EFunctionRef.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EFunctionRef.java
index 48cd251102cd7..97b496a5985f9 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EFunctionRef.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EFunctionRef.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.FunctionRef;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -49,11 +48,6 @@ public EFunctionRef(Location location, String type, String call) {
         this.call = Objects.requireNonNull(call);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // do nothing
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // do nothing
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EInstanceof.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EInstanceof.java
index 4e03f59be5e60..88dc36b497cb4 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EInstanceof.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EInstanceof.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -50,11 +49,6 @@ public EInstanceof(Location location, AExpression expression, String type) {
         this.type = Objects.requireNonNull(type);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        expression.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         expression.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ELambda.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ELambda.java
index 7bd027c149c95..120bbdd744797 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ELambda.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ELambda.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.FunctionRef;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -68,8 +67,6 @@ public final class ELambda extends AExpression implements ILambda {
     private final List<String> paramNameStrs;
     private final List<AStatement> statements;
 
-    private CompilerSettings settings;
-
     // extracted variables required to determine captures
     private final Set<String> extractedVariables;
     // desugared synthetic method (lambda body)
@@ -92,15 +89,6 @@ public ELambda(Location location,
         this.extractedVariables = new HashSet<>();
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        for (AStatement statement : statements) {
-            statement.storeSettings(settings);
-        }
-
-        this.settings = settings;
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         for (AStatement statement : statements) {
@@ -180,10 +168,9 @@ void analyze(ScriptRoot scriptRoot, Locals locals) {
         desugared = new SFunction(
                 location, PainlessLookupUtility.typeToCanonicalTypeName(returnType), name, paramTypes, paramNames,
                 new SBlock(location, statements), true);
-        desugared.storeSettings(settings);
         desugared.generateSignature(scriptRoot.getPainlessLookup());
         desugared.analyze(scriptRoot, Locals.newLambdaScope(locals.getProgramScope(), desugared.name, returnType,
-                                                desugared.parameters, captures.size(), settings.getMaxLoopCounter()));
+                desugared.parameters, captures.size(), scriptRoot.getCompilerSettings().getMaxLoopCounter()));
         scriptRoot.getFunctionTable().addFunction(desugared.name, desugared.returnType, desugared.typeParameters, true);
         scriptRoot.getClassNode().addFunction(desugared);
 
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EListInit.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EListInit.java
index 75c1e10bb683b..b0ad7a1a10112 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EListInit.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EListInit.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -53,13 +52,6 @@ public EListInit(Location location, List<AExpression> values) {
         this.values = values;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        for (AExpression value : values) {
-            value.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         for (AExpression value : values) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EMapInit.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EMapInit.java
index 8107f96c77aa4..6b2c1861bf39d 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EMapInit.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EMapInit.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -55,17 +54,6 @@ public EMapInit(Location location, List<AExpression> keys, List<AExpression> val
         this.values = values;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        for (AExpression key : keys) {
-            key.storeSettings(settings);
-        }
-
-        for (AExpression value : values) {
-            value.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         for (AExpression key : keys) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewArray.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewArray.java
index dbf506f6de5c3..03ec8a57fc02d 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewArray.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewArray.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -48,13 +47,6 @@ public ENewArray(Location location, String type, List<AExpression> arguments, bo
         this.initialize = initialize;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        for (AExpression argument : arguments) {
-            argument.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         for (AExpression argument : arguments) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewArrayFunctionRef.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewArrayFunctionRef.java
index b85e93c19dabd..f496dec4321a9 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewArrayFunctionRef.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewArrayFunctionRef.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.FunctionRef;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -40,8 +39,6 @@
 public final class ENewArrayFunctionRef extends AExpression implements ILambda {
     private final String type;
 
-    private CompilerSettings settings;
-
     private SFunction function;
     private FunctionRef ref;
     private String defPointer;
@@ -52,11 +49,6 @@ public ENewArrayFunctionRef(Location location, String type) {
         this.type = Objects.requireNonNull(type);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        this.settings = settings;
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // do nothing
@@ -69,11 +61,10 @@ void analyze(ScriptRoot scriptRoot, Locals locals) {
                 location, type, scriptRoot.getNextSyntheticName("newarray"),
                 Collections.singletonList("int"), Collections.singletonList("size"),
                 new SBlock(location, Collections.singletonList(code)), true);
-        function.storeSettings(settings);
         function.generateSignature(scriptRoot.getPainlessLookup());
         function.extractVariables(null);
         function.analyze(scriptRoot, Locals.newLambdaScope(locals.getProgramScope(), function.name, function.returnType,
-                function.parameters, 0, settings.getMaxLoopCounter()));
+                function.parameters, 0, scriptRoot.getCompilerSettings().getMaxLoopCounter()));
         scriptRoot.getFunctionTable().addFunction(function.name, function.returnType, function.typeParameters, true);
         scriptRoot.getClassNode().addFunction(function);
 
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewObj.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewObj.java
index 73d3c38addb74..5f17cd9696473 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewObj.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewObj.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -54,13 +53,6 @@ public ENewObj(Location location, String type, List<AExpression> arguments) {
         this.arguments = Objects.requireNonNull(arguments);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        for (AExpression argument : arguments) {
-            argument.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         for (AExpression argument : arguments) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENull.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENull.java
index 0cd33ea900b4b..7520700885f9e 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENull.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENull.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -40,11 +39,6 @@ public ENull(Location location) {
         super(location);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // do nothing
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENumeric.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENumeric.java
index 1e7dfb9276a20..4778670979c69 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENumeric.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENumeric.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -45,11 +44,6 @@ public ENumeric(Location location, String value, int radix) {
         this.radix = radix;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // do nothing
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ERegex.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ERegex.java
index 7ac10be445f1e..9b2b48748c826 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ERegex.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ERegex.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Constant;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -43,8 +42,6 @@ public final class ERegex extends AExpression {
     private final int flags;
     private Constant constant;
 
-    private CompilerSettings settings;
-
     public ERegex(Location location, String pattern, String flagsString) {
         super(location);
 
@@ -59,11 +56,6 @@ public ERegex(Location location, String pattern, String flagsString) {
         this.flags = flags;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        this.settings = settings;
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
@@ -71,7 +63,7 @@ void extractVariables(Set<String> variables) {
 
     @Override
     void analyze(ScriptRoot scriptRoot, Locals locals) {
-        if (false == settings.areRegexesEnabled()) {
+        if (false == scriptRoot.getCompilerSettings().areRegexesEnabled()) {
             throw createError(new IllegalStateException("Regexes are disabled. Set [script.painless.regex.enabled] to [true] "
                     + "in elasticsearch.yaml to allow them. Be careful though, regexes break out of Painless's protection against deep "
                     + "recursion and long loops."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EStatic.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EStatic.java
index 9bc387137e35c..d1d50a5d590eb 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EStatic.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EStatic.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -43,11 +42,6 @@ public EStatic(Location location, String type) {
         this.type = Objects.requireNonNull(type);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // do nothing
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EString.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EString.java
index 71802bd371b75..79120549de165 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EString.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EString.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -41,11 +40,6 @@ public EString(Location location, String string) {
         this.constant = Objects.requireNonNull(string);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // do nothing
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EUnary.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EUnary.java
index 6e9698e172e0b..186c11aa70f47 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EUnary.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EUnary.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.painless.AnalyzerCaster;
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -56,11 +55,6 @@ public EUnary(Location location, Operation operation, AExpression child) {
         this.child = Objects.requireNonNull(child);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        child.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         child.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EVariable.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EVariable.java
index ad474b56c2e37..b19be1d67c228 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EVariable.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/EVariable.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Locals.Variable;
@@ -47,11 +46,6 @@ public EVariable(Location location, String name) {
         this.name = Objects.requireNonNull(name);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // do nothing
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         variables.add(name);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PBrace.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PBrace.java
index cc18088f3fe5c..f029337a3d7e3 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PBrace.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PBrace.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -49,12 +48,6 @@ public PBrace(Location location, AExpression prefix, AExpression index) {
         this.index = Objects.requireNonNull(index);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        prefix.storeSettings(settings);
-        index.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         prefix.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PCallInvoke.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PCallInvoke.java
index 92e119d37e5d9..47bd54c288640 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PCallInvoke.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PCallInvoke.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -54,15 +53,6 @@ public PCallInvoke(Location location, AExpression prefix, String name, boolean n
         this.arguments = Objects.requireNonNull(arguments);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        prefix.storeSettings(settings);
-
-        for (AExpression argument : arguments) {
-            argument.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         prefix.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PField.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PField.java
index b38ce3edb553b..a5486524585b6 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PField.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PField.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -55,11 +54,6 @@ public PField(Location location, AExpression prefix, boolean nullSafe, String va
         this.value = Objects.requireNonNull(value);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        prefix.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         prefix.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubArrayLength.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubArrayLength.java
index 52ad98ae23968..07f5e690e2373 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubArrayLength.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubArrayLength.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -45,11 +44,6 @@ final class PSubArrayLength extends AStoreable {
         this.value = Objects.requireNonNull(value);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubBrace.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubBrace.java
index 6a15556f79977..a793c55f81b6c 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubBrace.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubBrace.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -45,11 +44,6 @@ final class PSubBrace extends AStoreable {
         this.index = Objects.requireNonNull(index);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("illegal tree structure"));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubCallInvoke.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubCallInvoke.java
index a2afc502a8e0a..34ff18ffec338 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubCallInvoke.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubCallInvoke.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -49,11 +48,6 @@ final class PSubCallInvoke extends AExpression {
         this.arguments = Objects.requireNonNull(arguments);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefArray.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefArray.java
index 64f713d1e8713..8ac360b200237 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefArray.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefArray.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -46,11 +45,6 @@ final class PSubDefArray extends AStoreable {
         this.index = Objects.requireNonNull(index);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefCall.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefCall.java
index b148f4c70630f..795ce7d566a49 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefCall.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefCall.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -55,11 +54,6 @@ final class PSubDefCall extends AExpression {
         this.arguments = Objects.requireNonNull(arguments);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefField.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefField.java
index 2f8e5035cbde0..441762a0c58cf 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefField.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubDefField.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -46,11 +45,6 @@ final class PSubDefField extends AStoreable {
         this.value = Objects.requireNonNull(value);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubField.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubField.java
index 371e36beab46e..b6d683edcee4e 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubField.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubField.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -47,11 +46,6 @@ final class PSubField extends AStoreable {
         this.field = Objects.requireNonNull(field);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubListShortcut.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubListShortcut.java
index e9bdbc437eb01..9471ea8c56d64 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubListShortcut.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubListShortcut.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -51,11 +50,6 @@ final class PSubListShortcut extends AStoreable {
         this.index = Objects.requireNonNull(index);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubMapShortcut.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubMapShortcut.java
index fb537572f6314..1558d4ce94bb3 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubMapShortcut.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubMapShortcut.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -50,11 +49,6 @@ final class PSubMapShortcut extends AStoreable {
         this.index = Objects.requireNonNull(index);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubNullSafeCallInvoke.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubNullSafeCallInvoke.java
index 8d02a90415095..7ce2a6a8cd889 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubNullSafeCallInvoke.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubNullSafeCallInvoke.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -46,11 +45,6 @@ public PSubNullSafeCallInvoke(Location location, AExpression guarded) {
         this.guarded = requireNonNull(guarded);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("illegal tree structure"));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubNullSafeField.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubNullSafeField.java
index 80dbca86d0ad8..bc9a7ac3f96b4 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubNullSafeField.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubNullSafeField.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -41,11 +40,6 @@ public PSubNullSafeField(Location location, AStoreable guarded) {
         this.guarded = guarded;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("illegal tree structure"));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubShortcut.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubShortcut.java
index 214ee7f429643..181a04aa02b1a 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubShortcut.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PSubShortcut.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -49,11 +48,6 @@ final class PSubShortcut extends AStoreable {
         this.setter = setter;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SBlock.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SBlock.java
index 992e23d9acf1b..effa818280668 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SBlock.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SBlock.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -46,13 +45,6 @@ public SBlock(Location location, List<AStatement> statements) {
         this.statements = Collections.unmodifiableList(statements);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        for (AStatement statement : statements) {
-            statement.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         for (AStatement statement : statements) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SBreak.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SBreak.java
index fb8522ab8f978..cc49ac7561bff 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SBreak.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SBreak.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -38,11 +37,6 @@ public SBreak(Location location) {
         super(location);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // do nothing
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SCatch.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SCatch.java
index 04842110e55ed..ae5e421afa18b 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SCatch.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SCatch.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Locals.Variable;
@@ -56,13 +55,6 @@ public SCatch(Location location, String type, String name, SBlock block) {
         this.block = block;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        if (block != null) {
-            block.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         variables.add(name);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SClass.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SClass.java
index 9099dc175a507..356f56d7cf491 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SClass.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SClass.java
@@ -117,19 +117,6 @@ void addField(SField field) {
         fields.add(field);
     }
 
-    @Override
-    public void storeSettings(CompilerSettings settings) {
-        for (SFunction function : functions) {
-            function.storeSettings(settings);
-        }
-
-        for (AStatement statement : statements) {
-            statement.storeSettings(settings);
-        }
-
-        this.settings = settings;
-    }
-
     @Override
     public void extractVariables(Set<String> variables) {
         for (SFunction function : functions) {
@@ -143,7 +130,8 @@ public void extractVariables(Set<String> variables) {
         extractedVariables.addAll(variables);
     }
 
-    public void analyze(PainlessLookup painlessLookup) {
+    public void analyze(PainlessLookup painlessLookup, CompilerSettings settings) {
+        this.settings = settings;
         table = new ScriptRoot(painlessLookup, settings, scriptClassInfo, this);
 
         for (SFunction function : functions) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SContinue.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SContinue.java
index 54e6d5c04e27f..2a9ea5319b6a4 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SContinue.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SContinue.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -38,11 +37,6 @@ public SContinue(Location location) {
         super(location);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        // do nothing
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // Do nothing.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclBlock.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclBlock.java
index c4b695747780d..220c9ec3d012c 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclBlock.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclBlock.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -46,13 +45,6 @@ public SDeclBlock(Location location, List<SDeclaration> declarations) {
         this.declarations = Collections.unmodifiableList(declarations);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        for (SDeclaration declaration: declarations) {
-            declaration.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         for (SDeclaration declaration : declarations) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
index c6876d6ad9aff..de42c43db4ee7 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Locals.Variable;
@@ -51,13 +50,6 @@ public SDeclaration(Location location, String type, String name, AExpression exp
         this.expression = expression;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        if (expression != null) {
-            expression.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         variables.add(name);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDo.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDo.java
index 298c29b72d9ce..a6c9c2eb30c24 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDo.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDo.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -49,15 +48,6 @@ public SDo(Location location, SBlock block, AExpression condition) {
         this.block = block;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        condition.storeSettings(settings);
-
-        if (block != null) {
-            block.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         condition.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SEach.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SEach.java
index 5fa25e2db08d0..65377aaa6e59d 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SEach.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SEach.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Locals.Variable;
@@ -54,15 +53,6 @@ public SEach(Location location, String type, String name, AExpression expression
         this.block = block;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        expression.storeSettings(settings);
-
-        if (block != null) {
-            block.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         variables.add(name);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SExpression.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SExpression.java
index 69526210f75e1..3057cd689b07f 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SExpression.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SExpression.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -43,11 +42,6 @@ public SExpression(Location location, AExpression expression) {
         this.expression = Objects.requireNonNull(expression);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        expression.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         expression.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SField.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SField.java
index f12e5797cb21c..569ca608b4502 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SField.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SField.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -65,11 +64,6 @@ public Object getInstance() {
         return instance;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new UnsupportedOperationException("unexpected node"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new UnsupportedOperationException("unexpected node"));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFor.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFor.java
index eabe03e5f1ec5..93ba16a41e1ce 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFor.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFor.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -55,25 +54,6 @@ public SFor(Location location, ANode initializer, AExpression condition, AExpres
         this.block = block;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        if (initializer != null) {
-            initializer.storeSettings(settings);
-        }
-
-        if (condition != null) {
-            condition.storeSettings(settings);
-        }
-
-        if (afterthought != null) {
-            afterthought.storeSettings(settings);
-        }
-
-        if (block != null) {
-            block.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         if (initializer != null) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFunction.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFunction.java
index 4bf6fbcd4342f..bc50268ef363d 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFunction.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFunction.java
@@ -78,13 +78,6 @@ public SFunction(Location location, String rtnType, String name,
         this.synthetic = synthetic;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        block.storeSettings(settings);
-
-        this.settings = settings;
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         // we reset the list for function scope
@@ -128,6 +121,8 @@ void generateSignature(PainlessLookup painlessLookup) {
 
     @Override
     void analyze(ScriptRoot scriptRoot, Locals locals) {
+        this.settings = scriptRoot.getCompilerSettings();
+
         if (block.statements.isEmpty()) {
             throw createError(new IllegalArgumentException("Cannot generate an empty function [" + name + "]."));
         }
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SIf.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SIf.java
index 32e1142a7f6fd..1f4350297dc3a 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SIf.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SIf.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -47,15 +46,6 @@ public SIf(Location location, AExpression condition, SBlock ifblock) {
         this.ifblock = ifblock;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        condition.storeSettings(settings);
-
-        if (ifblock != null) {
-            ifblock.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         condition.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SIfElse.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SIfElse.java
index c0b6193d5c4c9..85c23977fa5a0 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SIfElse.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SIfElse.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -52,19 +51,6 @@ public SIfElse(Location location, AExpression condition, SBlock ifblock, SBlock
         this.elseblock = elseblock;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        condition.storeSettings(settings);
-
-        if (ifblock != null) {
-            ifblock.storeSettings(settings);
-        }
-
-        if (elseblock != null) {
-            elseblock.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         condition.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SReturn.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SReturn.java
index 88bb4ff5ea84f..cfc1dd1e6da9b 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SReturn.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SReturn.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -43,13 +42,6 @@ public SReturn(Location location, AExpression expression) {
         this.expression = expression;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        if (expression != null) {
-            expression.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         if (expression != null) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SSubEachArray.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SSubEachArray.java
index 9fe6c06dada1d..c0ce95ea68adb 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SSubEachArray.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SSubEachArray.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.painless.AnalyzerCaster;
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Locals.Variable;
@@ -57,11 +56,6 @@ final class SSubEachArray extends AStatement {
         this.block = block;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SSubEachIterable.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SSubEachIterable.java
index db02a7e4c751f..b6b97503555b1 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SSubEachIterable.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SSubEachIterable.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.painless.AnalyzerCaster;
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.DefBootstrap;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
@@ -66,11 +65,6 @@ final class SSubEachIterable extends AStatement {
         this.block = block;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        throw createError(new IllegalStateException("illegal tree structure"));
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         throw createError(new IllegalStateException("Illegal tree structure."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SThrow.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SThrow.java
index e8184ccf84bde..a8309c7f7f8a7 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SThrow.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SThrow.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -43,11 +42,6 @@ public SThrow(Location location, AExpression expression) {
         this.expression = Objects.requireNonNull(expression);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        expression.storeSettings(settings);
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         expression.extractVariables(variables);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/STry.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/STry.java
index 0923666cac3a3..67b038158cbc1 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/STry.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/STry.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -49,17 +48,6 @@ public STry(Location location, SBlock block, List<SCatch> catches) {
         this.catches = Collections.unmodifiableList(catches);
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        if (block != null) {
-            block.storeSettings(settings);
-        }
-
-        for (SCatch ctch : catches) {
-            ctch.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         if (block != null) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SWhile.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SWhile.java
index 85121e2a0ff90..ab1f29fad4a5d 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SWhile.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SWhile.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Location;
@@ -49,15 +48,6 @@ public SWhile(Location location, AExpression condition, SBlock block) {
         this.block = block;
     }
 
-    @Override
-    void storeSettings(CompilerSettings settings) {
-        condition.storeSettings(settings);
-
-        if (block != null) {
-            block.storeSettings(settings);
-        }
-    }
-
     @Override
     void extractVariables(Set<String> variables) {
         condition.extractVariables(variables);

From 68adad7f9f8a46b5229c0624c4aca9d588ebd995 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Wed, 4 Dec 2019 11:56:37 -0800
Subject: [PATCH 076/686] Fix task input for docker build (#49814)

The docker build task depends on the docker context being built, but it
was not explicitly setup as an input. This commit adds the task as an
input to the docker build.

relates #49613
---
 distribution/docker/build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/distribution/docker/build.gradle b/distribution/docker/build.gradle
index da940f17b0f98..690299061c839 100644
--- a/distribution/docker/build.gradle
+++ b/distribution/docker/build.gradle
@@ -151,7 +151,7 @@ check.dependsOn integTest
 
 void addBuildDockerImage(final boolean oss, final boolean ubi) {
   final Task buildDockerImageTask = task(taskName("build", oss, ubi, "DockerImage"), type: LoggedExec) {
-    dependsOn taskName("copy", oss, ubi, "DockerContext")
+    inputs.files(tasks.named(taskName("copy", oss, ubi, "DockerContext")))
     List<String> tags
     if (oss) {
       tags = [

From 64769cc6bfd08e1ae053c2a45b6c09bc41629a66 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 5 Dec 2019 09:57:01 +0100
Subject: [PATCH 077/686] [DOCS] Fixes typo in the ML anomaly detection time
 functions docs. (#49834)

---
 docs/reference/ml/anomaly-detection/functions/time.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/ml/anomaly-detection/functions/time.asciidoc b/docs/reference/ml/anomaly-detection/functions/time.asciidoc
index 422b4e995ec73..22cab11151d1a 100644
--- a/docs/reference/ml/anomaly-detection/functions/time.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions/time.asciidoc
@@ -27,7 +27,7 @@ are not affected by the bucket span, but a shorter bucket span enables quicker
 alerting on unusual events.
 * Unusual events are flagged based on the previous pattern of the data, not on
 what we might think of as unusual based on human experience. So, if events
-typically occur between 3 a.m. and 5 a.m., and event occurring at 3 p.m. is be
+typically occur between 3 a.m. and 5 a.m., an event occurring at 3 p.m. is 
 flagged as unusual.
 * When Daylight Saving Time starts or stops, regular events can be flagged as
 anomalous. This situation occurs because the actual time of the event (as

From d2f37aae06294ef90291af81b0838e575cf8e141 Mon Sep 17 00:00:00 2001
From: markharwood <markharwood@gmail.com>
Date: Thu, 5 Dec 2019 12:13:53 +0000
Subject: [PATCH 078/686] Remove serialisation of adjust_pure_negative default
 value -  (#49543)

Closes #49530
---
 .../resources/rest-api-spec/test/search_shards/10_basic.yml   | 1 -
 .../java/org/elasticsearch/index/query/BoolQueryBuilder.java  | 4 +++-
 .../org/elasticsearch/index/query/BoolQueryBuilderTests.java  | 1 -
 .../elasticsearch/index/query/NestedQueryBuilderTests.java    | 1 -
 4 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search_shards/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search_shards/10_basic.yml
index 653979073b707..c89873f2b2c6f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search_shards/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search_shards/10_basic.yml
@@ -69,7 +69,6 @@
   - gte: { indices.test_index.filter.bool.should.0.term.field.boost: 1.0 }
   - lte: { indices.test_index.filter.bool.should.1.term.field.boost: 1.0 }
   - gte: { indices.test_index.filter.bool.should.1.term.field.boost: 1.0 }
-  - match: { indices.test_index.filter.bool.adjust_pure_negative: true}
   - lte: { indices.test_index.filter.bool.boost: 1.0 }
   - gte: { indices.test_index.filter.bool.boost: 1.0 }
 
diff --git a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
index 5dd7903141ddb..cbc3710779649 100644
--- a/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/BoolQueryBuilder.java
@@ -250,7 +250,9 @@ protected void doXContent(XContentBuilder builder, Params params) throws IOExcep
         doXArrayContent(FILTER, filterClauses, builder, params);
         doXArrayContent(MUST_NOT, mustNotClauses, builder, params);
         doXArrayContent(SHOULD, shouldClauses, builder, params);
-        builder.field(ADJUST_PURE_NEGATIVE.getPreferredName(), adjustPureNegative);
+        if (adjustPureNegative != ADJUST_PURE_NEGATIVE_DEFAULT) {
+            builder.field(ADJUST_PURE_NEGATIVE.getPreferredName(), adjustPureNegative);
+        }
         if (minimumShouldMatch != null) {
             builder.field(MINIMUM_SHOULD_MATCH.getPreferredName(), minimumShouldMatch);
         }
diff --git a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
index 1a1609fe7c50e..4678e244193ca 100644
--- a/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/BoolQueryBuilderTests.java
@@ -263,7 +263,6 @@ public void testFromJson() throws IOException {
                 "      }" +
                 "    }" +
                 "  } ]," +
-                "  \"adjust_pure_negative\" : true," +
                 "  \"minimum_should_match\" : \"23\"," +
                 "  \"boost\" : 42.0" +
                 "}" +
diff --git a/server/src/test/java/org/elasticsearch/index/query/NestedQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/NestedQueryBuilderTests.java
index 08cf8eedb94d3..e2d4c4b4a0ac3 100644
--- a/server/src/test/java/org/elasticsearch/index/query/NestedQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/NestedQueryBuilderTests.java
@@ -166,7 +166,6 @@ public void testFromJson() throws IOException {
                 "            }\n" +
                 "          }\n" +
                 "        } ],\n" +
-                "        \"adjust_pure_negative\" : true,\n" +
                 "        \"boost\" : 1.0\n" +
                 "      }\n" +
                 "    },\n" +

From 4cd3f9e7d171d1e2f6b5461bfa974cd1c5864540 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 5 Dec 2019 14:15:19 +0100
Subject: [PATCH 079/686] [DOCS] Adds an example of preprocessing actions to
 the PUT DFA API docs (#49831)

---
 .../apis/put-dfanalytics.asciidoc             | 95 ++++++++++++++++---
 1 file changed, 84 insertions(+), 11 deletions(-)

diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index b4971fffa9c49..ddc8f35f280e6 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -102,11 +102,11 @@ single number. For example, in case of age ranges, you can model the values as
   
 `analyzed_fields`::
   (Optional, object) Specify `includes` and/or `excludes` patterns to select
-  which fields will be included in the analysis. If `analyzed_fields` is not set,
-  only the relevant fields will be included. For example, all the numeric fields
-  for {oldetection}. For the supported field types, see <<ml-put-dfanalytics-supported-fields>>.
-  Also see the <<explain-dfanalytics>> which helps understand
-  field selection.
+  which fields will be included in the analysis. If `analyzed_fields` is not 
+  set, only the relevant fields will be included. For example, all the numeric 
+  fields for {oldetection}. For the supported field types, see 
+  <<ml-put-dfanalytics-supported-fields>>. Also see the <<explain-dfanalytics>> 
+  which helps understand field selection.
 
   `includes`:::
     (Optional, array) An array of strings that defines the fields that will be 
@@ -142,8 +142,8 @@ single number. For example, in case of age ranges, you can model the values as
   that setting. For more information, see <<ml-settings>>.
   
 `source`::
-  (object) The configuration of how to source the analysis data. It requires an `index`.
-  Optionally, `query` and `_source` may be specified.
+  (object) The configuration of how to source the analysis data. It requires an 
+  `index`. Optionally, `query` and `_source` may be specified.
   
   `index`:::
     (Required, string or array) Index or indices on which to perform the 
@@ -163,12 +163,12 @@ single number. For example, in case of age ranges, you can model the values as
     cannot be included in the analysis.
         
       `includes`::::
-        (array) An array of strings that defines the fields that will be included in 
-        the destination.
+        (array) An array of strings that defines the fields that will be 
+        included in the destination.
           
       `excludes`::::
-        (array) An array of strings that defines the fields that will be excluded 
-        from the destination.
+        (array) An array of strings that defines the fields that will be 
+        excluded from the destination.
 
 `allow_lazy_start`::
   (Optional, boolean) Whether this job should be allowed to start when there
@@ -187,6 +187,79 @@ single number. For example, in case of age ranges, you can model the values as
 ==== {api-examples-title}
 
 
+[[ml-put-dfanalytics-example-preprocess]]
+===== Preprocessing actions example
+
+The following example shows how to limit the scope of the analysis to certain 
+fields, specify excluded fields in the destination index, and use a query to 
+filter your data before analysis.
+
+[source,console]
+--------------------------------------------------
+PUT _ml/data_frame/analytics/model-flight-delays-pre
+{
+  "source": {
+    "index": [
+      "kibana_sample_data_flights" <1>
+    ],
+    "query": { <2>
+      "range": {
+        "DistanceKilometers": { 
+          "gt": 0
+        }
+      }
+    },
+    "_source": { <3>
+      "includes": [],
+      "excludes": [
+        "FlightDelay",
+        "FlightDelayType"
+      ]
+    }
+  },
+  "dest": { <4>
+    "index": "df-flight-delays",
+    "results_field": "ml-results"
+  },
+  "analysis": {
+  "regression": {
+    "dependent_variable": "FlightDelayMin",
+    "training_percent": 90
+    }
+  },
+  "analyzed_fields": { <5>
+    "includes": [],
+    "excludes": [   
+      "FlightNum"
+    ]
+  },
+  "model_memory_limit": "100mb"
+}
+--------------------------------------------------
+// TEST[skip:setup kibana sample data]
+
+<1> The source index to analyze.
+<2> This query filters out entire documents that will not be present in the 
+destination index.
+<3> The `_source` object defines fields in the dataset that will be included or 
+excluded in the destination index. In this case, `includes` does not specify any 
+fields, so the default behavior takes place: all the fields of the source index 
+will included except the ones that are explicitly specified in `excludes`.
+<4> Defines the destination index that contains the results of the analysis and 
+the fields of the source index specified in the `_source` object. Also defines 
+the name of the `results_field`.
+<5> Specifies fields to be included in or excluded from the analysis. This does 
+not affect whether the fields will be present in the destination index, only 
+affects whether they are used in the analysis.
+
+In this example, we can see that all the fields of the source index are included 
+in the destination index except `FlightDelay` and `FlightDelayType` because 
+these are defined as excluded fields by the `excludes` parameter of the 
+`_source` object. The `FlightNum` field is included in the destination index, 
+however it is not included in the analysis because it is explicitly specified as 
+excluded field by the `excludes` parameter of the `analyzed_fields` object.
+
+
 [[ml-put-dfanalytics-example-od]]
 ===== {oldetection-cap} example
 

From 91ad03015a5050c58d20272a600ad9ad51b02053 Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Thu, 5 Dec 2019 10:49:09 -0700
Subject: [PATCH 080/686] Add int indicating size of transport header (#48884)

Currently we do not know the size of the transport header (map of
request response headers, features array, and action name). This means
that we must read the entire transport message to dependably act on the
headers. This commit adds an int indicating the size of the transport
headers. With this addition we can act upon the headers prior to reading
the entire message.
---
 .../transport/InboundMessage.java             | 62 ++++++++++---------
 .../transport/OutboundMessage.java            | 31 +++++++---
 .../elasticsearch/transport/TcpHeader.java    | 33 ++++++++--
 .../transport/TransportLogger.java            | 28 ++++-----
 .../transport/InboundMessageTests.java        | 10 +--
 .../transport/TransportLoggerTests.java       | 28 +++------
 6 files changed, 108 insertions(+), 84 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/transport/InboundMessage.java b/server/src/main/java/org/elasticsearch/transport/InboundMessage.java
index 681e6144ed05b..7aa0b1b6368f7 100644
--- a/server/src/main/java/org/elasticsearch/transport/InboundMessage.java
+++ b/server/src/main/java/org/elasticsearch/transport/InboundMessage.java
@@ -19,9 +19,7 @@
 package org.elasticsearch.transport;
 
 import org.elasticsearch.Version;
-import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.compress.Compressor;
 import org.elasticsearch.common.compress.CompressorFactory;
 import org.elasticsearch.common.io.stream.NamedWriteableAwareStreamInput;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
@@ -58,10 +56,6 @@ static class Reader {
         }
 
         InboundMessage deserialize(BytesReference reference) throws IOException {
-            int messageLengthBytes = reference.length();
-            final int totalMessageSize = messageLengthBytes + TcpHeader.MARKER_BYTES_SIZE + TcpHeader.MESSAGE_LENGTH_SIZE;
-            // we have additional bytes to read, outside of the header
-            boolean hasMessageBytesToRead = (totalMessageSize - TcpHeader.HEADER_SIZE) > 0;
             StreamInput streamInput = reference.streamInput();
             boolean success = false;
             try (ThreadContext.StoredContext existing = threadContext.stashContext()) {
@@ -70,23 +64,13 @@ InboundMessage deserialize(BytesReference reference) throws IOException {
                 Version remoteVersion = Version.fromId(streamInput.readInt());
                 final boolean isHandshake = TransportStatus.isHandshake(status);
                 ensureVersionCompatibility(remoteVersion, version, isHandshake);
-                if (TransportStatus.isCompress(status) && hasMessageBytesToRead && streamInput.available() > 0) {
-                    Compressor compressor = getCompressor(reference);
-                    if (compressor == null) {
-                        int maxToRead = Math.min(reference.length(), 10);
-                        StringBuilder sb = new StringBuilder("stream marked as compressed, but no compressor found, first [")
-                            .append(maxToRead).append("] content bytes out of [").append(reference.length())
-                            .append("] readable bytes with message size [").append(messageLengthBytes).append("] ").append("] are [");
-                        for (int i = 0; i < maxToRead; i++) {
-                            sb.append(reference.get(i)).append(",");
-                        }
-                        sb.append("]");
-                        throw new IllegalStateException(sb.toString());
-                    }
-                    streamInput = compressor.streamInput(streamInput);
+
+                if (remoteVersion.onOrAfter(TcpHeader.VERSION_WITH_HEADER_SIZE)) {
+                    // Consume the variable header size
+                    streamInput.readInt();
+                } else {
+                    streamInput = decompressingStream(status, remoteVersion, streamInput);
                 }
-                streamInput = new NamedWriteableAwareStreamInput(streamInput, namedWriteableRegistry);
-                streamInput.setVersion(remoteVersion);
 
                 threadContext.readHeaders(streamInput);
 
@@ -97,8 +81,17 @@ InboundMessage deserialize(BytesReference reference) throws IOException {
                         streamInput.readStringArray();
                     }
                     final String action = streamInput.readString();
+
+                    if (remoteVersion.onOrAfter(TcpHeader.VERSION_WITH_HEADER_SIZE)) {
+                        streamInput = decompressingStream(status, remoteVersion, streamInput);
+                    }
+                    streamInput = namedWriteableStream(streamInput, remoteVersion);
                     message = new Request(threadContext, remoteVersion, status, requestId, action, streamInput);
                 } else {
+                    if (remoteVersion.onOrAfter(TcpHeader.VERSION_WITH_HEADER_SIZE)) {
+                        streamInput = decompressingStream(status, remoteVersion, streamInput);
+                    }
+                    streamInput = namedWriteableStream(streamInput, remoteVersion);
                     message = new Response(threadContext, remoteVersion, status, requestId, streamInput);
                 }
                 success = true;
@@ -109,13 +102,26 @@ InboundMessage deserialize(BytesReference reference) throws IOException {
                 }
             }
         }
-    }
 
-    @Nullable
-    static Compressor getCompressor(BytesReference message) {
-        final int offset = TcpHeader.REQUEST_ID_SIZE + TcpHeader.STATUS_SIZE + TcpHeader.VERSION_ID_SIZE;
-        return CompressorFactory.COMPRESSOR.isCompressed(message.slice(offset, message.length() - offset))
-            ? CompressorFactory.COMPRESSOR : null;
+        static StreamInput decompressingStream(byte status, Version remoteVersion, StreamInput streamInput) throws IOException {
+            if (TransportStatus.isCompress(status) && streamInput.available() > 0) {
+                try {
+                    StreamInput decompressor = CompressorFactory.COMPRESSOR.streamInput(streamInput);
+                    decompressor.setVersion(remoteVersion);
+                    return decompressor;
+                } catch (IllegalArgumentException e) {
+                    throw new IllegalStateException("stream marked as compressed, but is missing deflate header");
+                }
+            } else {
+                return streamInput;
+            }
+        }
+
+        private StreamInput namedWriteableStream(StreamInput delegate, Version remoteVersion) {
+            NamedWriteableAwareStreamInput streamInput = new NamedWriteableAwareStreamInput(delegate, namedWriteableRegistry);
+            streamInput.setVersion(remoteVersion);
+            return streamInput;
+        }
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/transport/OutboundMessage.java b/server/src/main/java/org/elasticsearch/transport/OutboundMessage.java
index 7653ff6b59b90..16ba7a15a539c 100644
--- a/server/src/main/java/org/elasticsearch/transport/OutboundMessage.java
+++ b/server/src/main/java/org/elasticsearch/transport/OutboundMessage.java
@@ -24,6 +24,7 @@
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.bytes.CompositeBytesReference;
 import org.elasticsearch.common.io.stream.BytesStreamOutput;
+import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 
@@ -41,20 +42,36 @@ abstract class OutboundMessage extends NetworkMessage {
     BytesReference serialize(BytesStreamOutput bytesStream) throws IOException {
         storedContext.restore();
         bytesStream.setVersion(version);
-        bytesStream.skip(TcpHeader.HEADER_SIZE);
+        bytesStream.skip(TcpHeader.headerSize(version));
 
         // The compressible bytes stream will not close the underlying bytes stream
         BytesReference reference;
+        int variableHeaderLength = -1;
+        final long preHeaderPosition = bytesStream.position();
+
+        if (version.onOrAfter(TcpHeader.VERSION_WITH_HEADER_SIZE)) {
+            writeVariableHeader(bytesStream);
+            variableHeaderLength = Math.toIntExact(bytesStream.position() - preHeaderPosition);
+        }
+
         try (CompressibleBytesOutputStream stream = new CompressibleBytesOutputStream(bytesStream, TransportStatus.isCompress(status))) {
             stream.setVersion(version);
-            threadContext.writeTo(stream);
+            if (variableHeaderLength == -1) {
+                writeVariableHeader(stream);
+            }
             reference = writeMessage(stream);
         }
+
         bytesStream.seek(0);
-        TcpHeader.writeHeader(bytesStream, requestId, status, version, reference.length() - TcpHeader.HEADER_SIZE);
+        final int contentSize = reference.length() - TcpHeader.headerSize(version);
+        TcpHeader.writeHeader(bytesStream, requestId, status, version, contentSize, variableHeaderLength);
         return reference;
     }
 
+    protected void writeVariableHeader(StreamOutput stream) throws IOException {
+        threadContext.writeTo(stream);
+    }
+
     protected BytesReference writeMessage(CompressibleBytesOutputStream stream) throws IOException {
         final BytesReference zeroCopyBuffer;
         if (message instanceof BytesTransportRequest) {
@@ -92,13 +109,13 @@ static class Request extends OutboundMessage {
         }
 
         @Override
-        protected BytesReference writeMessage(CompressibleBytesOutputStream out) throws IOException {
+        protected void writeVariableHeader(StreamOutput stream) throws IOException {
+            super.writeVariableHeader(stream);
             if (version.before(Version.V_8_0_0)) {
                 // empty features array
-                out.writeStringArray(Strings.EMPTY_ARRAY);
+                stream.writeStringArray(Strings.EMPTY_ARRAY);
             }
-            out.writeString(action);
-            return super.writeMessage(out);
+            stream.writeString(action);
         }
 
         private static byte setStatus(boolean compress, boolean isHandshake, Writeable message) {
diff --git a/server/src/main/java/org/elasticsearch/transport/TcpHeader.java b/server/src/main/java/org/elasticsearch/transport/TcpHeader.java
index d18f62f60ee45..dfa79d240e470 100644
--- a/server/src/main/java/org/elasticsearch/transport/TcpHeader.java
+++ b/server/src/main/java/org/elasticsearch/transport/TcpHeader.java
@@ -25,7 +25,11 @@
 import java.io.IOException;
 
 public class TcpHeader {
-    public static final int MARKER_BYTES_SIZE = 2 * 1;
+
+    // TODO: Change to 7.6 after backport
+    public static final Version VERSION_WITH_HEADER_SIZE = Version.V_8_0_0;
+
+    public static final int MARKER_BYTES_SIZE = 2;
 
     public static final int MESSAGE_LENGTH_SIZE = 4;
 
@@ -35,15 +39,36 @@ public class TcpHeader {
 
     public static final int VERSION_ID_SIZE = 4;
 
-    public static final int HEADER_SIZE = MARKER_BYTES_SIZE + MESSAGE_LENGTH_SIZE + REQUEST_ID_SIZE + STATUS_SIZE + VERSION_ID_SIZE;
+    public static final int VARIABLE_HEADER_SIZE = 4;
+
+    private static final int PRE_76_HEADER_SIZE = MARKER_BYTES_SIZE + MESSAGE_LENGTH_SIZE + REQUEST_ID_SIZE + STATUS_SIZE + VERSION_ID_SIZE;
+
+    private static final int HEADER_SIZE = PRE_76_HEADER_SIZE + VARIABLE_HEADER_SIZE;
+
+    public static int headerSize(Version version) {
+        if (version.onOrAfter(VERSION_WITH_HEADER_SIZE)) {
+            return HEADER_SIZE;
+        } else {
+            return PRE_76_HEADER_SIZE;
+        }
+    }
 
-    public static void writeHeader(StreamOutput output, long requestId, byte status, Version version, int messageSize) throws IOException {
+    public static void writeHeader(StreamOutput output, long requestId, byte status, Version version, int contentSize,
+                                   int variableHeaderSize) throws IOException {
         output.writeByte((byte)'E');
         output.writeByte((byte)'S');
         // write the size, the size indicates the remaining message size, not including the size int
-        output.writeInt(messageSize + REQUEST_ID_SIZE + STATUS_SIZE + VERSION_ID_SIZE);
+        if (version.onOrAfter(VERSION_WITH_HEADER_SIZE)) {
+            output.writeInt(contentSize + REQUEST_ID_SIZE + STATUS_SIZE + VERSION_ID_SIZE + VARIABLE_HEADER_SIZE);
+        } else {
+            output.writeInt(contentSize + REQUEST_ID_SIZE + STATUS_SIZE + VERSION_ID_SIZE);
+        }
         output.writeLong(requestId);
         output.writeByte(status);
         output.writeInt(version.id);
+        if (version.onOrAfter(VERSION_WITH_HEADER_SIZE)) {
+            assert variableHeaderSize != -1 : "Variable header size not set";
+            output.writeInt(variableHeaderSize);
+        }
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/transport/TransportLogger.java b/server/src/main/java/org/elasticsearch/transport/TransportLogger.java
index 09f22da595635..310819969b718 100644
--- a/server/src/main/java/org/elasticsearch/transport/TransportLogger.java
+++ b/server/src/main/java/org/elasticsearch/transport/TransportLogger.java
@@ -22,8 +22,6 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.Version;
 import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.compress.Compressor;
-import org.elasticsearch.common.compress.NotCompressedException;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.core.internal.io.IOUtils;
@@ -77,26 +75,24 @@ private static String format(TcpChannel channel, BytesReference message, String
                 final byte status = streamInput.readByte();
                 final boolean isRequest = TransportStatus.isRequest(status);
                 final String type = isRequest ? "request" : "response";
-                final String version = Version.fromId(streamInput.readInt()).toString();
+                Version version = Version.fromId(streamInput.readInt());
                 sb.append(" [length: ").append(messageLengthWithHeader);
                 sb.append(", request id: ").append(requestId);
                 sb.append(", type: ").append(type);
                 sb.append(", version: ").append(version);
 
-                if (isRequest) {
-                    if (TransportStatus.isCompress(status)) {
-                        Compressor compressor;
-                        compressor = InboundMessage.getCompressor(message);
-                        if (compressor == null) {
-                            throw new IllegalStateException(new NotCompressedException());
-                        }
-                        streamInput = compressor.streamInput(streamInput);
-                    }
+                if (version.onOrAfter(TcpHeader.VERSION_WITH_HEADER_SIZE)) {
+                    sb.append(", header size: ").append(streamInput.readInt()).append('B');
+                } else {
+                    streamInput = InboundMessage.Reader.decompressingStream(status, version, streamInput);
+                }
+
+                // read and discard headers
+                ThreadContext.readHeadersFromStream(streamInput);
 
-                    // read and discard headers
-                    ThreadContext.readHeadersFromStream(streamInput);
-                    if (streamInput.getVersion().before(Version.V_8_0_0)) {
-                        // discard the features
+                if (isRequest) {
+                    if (version.before(Version.V_8_0_0)) {
+                        // discard features
                         streamInput.readStringArray();
                     }
                     sb.append(", action: ").append(streamInput.readString());
diff --git a/server/src/test/java/org/elasticsearch/transport/InboundMessageTests.java b/server/src/test/java/org/elasticsearch/transport/InboundMessageTests.java
index aa5233c77651d..e699c54ae0ca3 100644
--- a/server/src/test/java/org/elasticsearch/transport/InboundMessageTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/InboundMessageTests.java
@@ -32,9 +32,7 @@
 import org.hamcrest.Matchers;
 
 import java.io.IOException;
-import java.util.Arrays;
 import java.util.Collections;
-import java.util.HashSet;
 
 public class InboundMessageTests extends ESTestCase {
 
@@ -42,7 +40,6 @@ public class InboundMessageTests extends ESTestCase {
     private final NamedWriteableRegistry registry = new NamedWriteableRegistry(Collections.emptyList());
 
     public void testReadRequest() throws IOException {
-        String[] features = {"feature1", "feature2"};
         String value = randomAlphaOfLength(10);
         Message message = new Message(value);
         String action = randomAlphaOfLength(10);
@@ -81,7 +78,6 @@ public void testReadRequest() throws IOException {
     }
 
     public void testReadResponse() throws IOException {
-        HashSet<String> features = new HashSet<>(Arrays.asList("feature1", "feature2"));
         String value = randomAlphaOfLength(10);
         Message message = new Message(value);
         long requestId = randomLong();
@@ -118,7 +114,6 @@ public void testReadResponse() throws IOException {
     }
 
     public void testReadErrorResponse() throws IOException {
-        HashSet<String> features = new HashSet<>(Arrays.asList("feature1", "feature2"));
         RemoteTransportException exception = new RemoteTransportException("error", new IOException());
         long requestId = randomLong();
         boolean isHandshake = randomBoolean();
@@ -190,18 +185,17 @@ public void testThrowOnNotCompressed() throws Exception {
             reference = request.serialize(streamOutput);
         }
         final byte[] serialized = BytesReference.toBytes(reference);
-        final int statusPosition = TcpHeader.HEADER_SIZE - TcpHeader.VERSION_ID_SIZE - 1;
+        final int statusPosition = TcpHeader.headerSize(Version.CURRENT) - TcpHeader.VERSION_ID_SIZE - TcpHeader.VARIABLE_HEADER_SIZE - 1;
         // force status byte to signal compressed on the otherwise uncompressed message
         serialized[statusPosition] = TransportStatus.setCompress(serialized[statusPosition]);
         reference = new BytesArray(serialized);
         InboundMessage.Reader reader = new InboundMessage.Reader(Version.CURRENT, registry, threadContext);
         BytesReference sliced = reference.slice(6, reference.length() - 6);
         final IllegalStateException iste = expectThrows(IllegalStateException.class, () -> reader.deserialize(sliced));
-        assertThat(iste.getMessage(), Matchers.startsWith("stream marked as compressed, but no compressor found,"));
+        assertThat(iste.getMessage(), Matchers.equalTo("stream marked as compressed, but is missing deflate header"));
     }
 
     private void testVersionIncompatibility(Version version, Version currentVersion, boolean isHandshake) throws IOException {
-        String[] features = {};
         String value = randomAlphaOfLength(10);
         Message message = new Message(value);
         String action = randomAlphaOfLength(10);
diff --git a/server/src/test/java/org/elasticsearch/transport/TransportLoggerTests.java b/server/src/test/java/org/elasticsearch/transport/TransportLoggerTests.java
index 1d62e3d9ab663..9309f115aef76 100644
--- a/server/src/test/java/org/elasticsearch/transport/TransportLoggerTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/TransportLoggerTests.java
@@ -24,7 +24,6 @@
 import org.elasticsearch.action.admin.cluster.stats.ClusterStatsAction;
 import org.elasticsearch.action.admin.cluster.stats.ClusterStatsRequest;
 import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.bytes.CompositeBytesReference;
 import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.logging.Loggers;
 import org.elasticsearch.common.settings.Settings;
@@ -61,6 +60,7 @@ public void testLoggingHandler() throws IOException {
                 ", request id: \\d+" +
                 ", type: request" +
                 ", version: .*" +
+                ", header size: \\d+B" +
                 ", action: cluster:monitor/stats]" +
                 " WRITE: \\d+B";
         final MockLogAppender.LoggingExpectation writeExpectation =
@@ -72,6 +72,7 @@ public void testLoggingHandler() throws IOException {
                 ", request id: \\d+" +
                 ", type: request" +
                 ", version: .*" +
+                ", header size: \\d+B" +
                 ", action: cluster:monitor/stats]" +
                 " READ: \\d+B";
 
@@ -88,26 +89,11 @@ public void testLoggingHandler() throws IOException {
     }
 
     private BytesReference buildRequest() throws IOException {
-        try (BytesStreamOutput messageOutput = new BytesStreamOutput()) {
-            messageOutput.setVersion(Version.CURRENT);
-            ThreadContext context = new ThreadContext(Settings.EMPTY);
-            context.writeTo(messageOutput);
-            messageOutput.writeString(ClusterStatsAction.NAME);
-            new ClusterStatsRequest().writeTo(messageOutput);
-            BytesReference messageBody = messageOutput.bytes();
-            final BytesReference header = buildHeader(randomInt(30), messageBody.length());
-            return new CompositeBytesReference(header, messageBody);
-        }
-    }
-
-    private BytesReference buildHeader(long requestId, int length) throws IOException {
-        try (BytesStreamOutput headerOutput = new BytesStreamOutput(TcpHeader.HEADER_SIZE)) {
-            headerOutput.setVersion(Version.CURRENT);
-            TcpHeader.writeHeader(headerOutput, requestId, TransportStatus.setRequest((byte) 0), Version.CURRENT, length);
-            final BytesReference bytes = headerOutput.bytes();
-            assert bytes.length() == TcpHeader.HEADER_SIZE : "header size mismatch expected: " + TcpHeader.HEADER_SIZE + " but was: "
-                + bytes.length();
-            return bytes;
+        boolean compress = randomBoolean();
+        try (BytesStreamOutput bytesStreamOutput = new BytesStreamOutput()) {
+            OutboundMessage.Request request = new OutboundMessage.Request(new ThreadContext(Settings.EMPTY), new ClusterStatsRequest(),
+                Version.CURRENT, ClusterStatsAction.NAME, randomInt(30), false, compress);
+            return request.serialize(bytesStreamOutput);
         }
     }
 }

From 3ffd4369162c68efac55582d83cfb7282390d069 Mon Sep 17 00:00:00 2001
From: Orhan Toy <toyorhan@gmail.com>
Date: Thu, 5 Dec 2019 20:24:22 +0100
Subject: [PATCH 081/686] [DOCS] Minor typo fixes in reindex.asciidoc (#49863)

---
 docs/reference/docs/reindex.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/docs/reindex.asciidoc b/docs/reference/docs/reindex.asciidoc
index c5ba1d36743fc..ae7f3f1939896 100644
--- a/docs/reference/docs/reindex.asciidoc
+++ b/docs/reference/docs/reindex.asciidoc
@@ -549,7 +549,7 @@ the reindex returned a `noop` value for `ctx.op`.
 
 `version_conflicts`::
 
-{integer)The number of version conflicts that reindex hit.
+(integer) The number of version conflicts that reindex hits.
 
 `retries`::
 

From ca77ebfa7a0bf8c8a57c2ad759fab5dc821a6a59 Mon Sep 17 00:00:00 2001
From: Jack Conradson <osjdconrad@gmail.com>
Date: Thu, 5 Dec 2019 12:08:23 -0800
Subject: [PATCH 082/686] Minor Painless Clean Up (#49844)

This cleans up two minor things.
- Cleans up style of == false
- Pulls maxLoopCounter into a member variable instead of accessing
CompilerSettings multiple times in the SFunction node
---
 .../java/org/elasticsearch/painless/node/ERegex.java  |  2 +-
 .../org/elasticsearch/painless/node/SFunction.java    | 11 +++++------
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ERegex.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ERegex.java
index 9b2b48748c826..210894e86fa4c 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ERegex.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ERegex.java
@@ -63,7 +63,7 @@ void extractVariables(Set<String> variables) {
 
     @Override
     void analyze(ScriptRoot scriptRoot, Locals locals) {
-        if (false == scriptRoot.getCompilerSettings().areRegexesEnabled()) {
+        if (scriptRoot.getCompilerSettings().areRegexesEnabled() == false) {
             throw createError(new IllegalStateException("Regexes are disabled. Set [script.painless.regex.enabled] to [true] "
                     + "in elasticsearch.yaml to allow them. Be careful though, regexes break out of Painless's protection against deep "
                     + "recursion and long loops."));
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFunction.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFunction.java
index bc50268ef363d..75122903ef12f 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFunction.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SFunction.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.painless.node;
 
 import org.elasticsearch.painless.ClassWriter;
-import org.elasticsearch.painless.CompilerSettings;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
 import org.elasticsearch.painless.Locals.Parameter;
@@ -54,7 +53,7 @@ public final class SFunction extends AStatement {
     private final SBlock block;
     public final boolean synthetic;
 
-    private CompilerSettings settings;
+    private int maxLoopCounter;
 
     Class<?> returnType;
     List<Class<?>> typeParameters;
@@ -121,7 +120,7 @@ void generateSignature(PainlessLookup painlessLookup) {
 
     @Override
     void analyze(ScriptRoot scriptRoot, Locals locals) {
-        this.settings = scriptRoot.getCompilerSettings();
+        maxLoopCounter = scriptRoot.getCompilerSettings().getMaxLoopCounter();
 
         if (block.statements.isEmpty()) {
             throw createError(new IllegalArgumentException("Cannot generate an empty function [" + name + "]."));
@@ -137,7 +136,7 @@ void analyze(ScriptRoot scriptRoot, Locals locals) {
             throw createError(new IllegalArgumentException("Not all paths provide a return value for method [" + name + "]."));
         }
 
-        if (settings.getMaxLoopCounter() > 0) {
+        if (maxLoopCounter > 0) {
             loop = locals.getVariable(null, Locals.LOOP);
         }
     }
@@ -156,10 +155,10 @@ void write(ClassWriter classWriter, Globals globals) {
 
     @Override
     void write(ClassWriter classWriter, MethodWriter methodWriter, Globals globals) {
-        if (settings.getMaxLoopCounter() > 0) {
+        if (maxLoopCounter > 0) {
             // if there is infinite loop protection, we do this once:
             // int #loop = settings.getMaxLoopCounter()
-            methodWriter.push(settings.getMaxLoopCounter());
+            methodWriter.push(maxLoopCounter);
             methodWriter.visitVarInsn(Opcodes.ISTORE, loop.getSlot());
         }
 

From f95a56cc1fc718d349f4c5674eda77e4a4caa348 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Thu, 5 Dec 2019 13:03:06 -0800
Subject: [PATCH 083/686] Fix external integ test zip dep to expect a zip
 (#49813)

When external plugin authors use build-tools, their integ tests depend
on the integ-test-zip artifact. However, this dependency was broken in
7.5.0 by accidentally removing the `@zip` qualifier on the maven
dependency, which works around the fact the pom for the integ-test-zip
claims the artifact is a pom instead of zip packaging. This commit
restores the workaround of using `@zip` until the pom can be fixed.

closes #49787
---
 .../org/elasticsearch/gradle/DistributionDownloadPlugin.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
index c26576b2a1914..88cfb80a5a2d7 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
@@ -212,7 +212,7 @@ private Object dependencyNotation(Project project, ElasticsearchDistribution dis
         }
 
         if (distribution.getType() == Type.INTEG_TEST_ZIP) {
-            return "org.elasticsearch.distribution.integ-test-zip:elasticsearch:" + distribution.getVersion();
+            return "org.elasticsearch.distribution.integ-test-zip:elasticsearch:" + distribution.getVersion() + "@zip";
         }
 
 

From 6a67e55e8fd021d41ba8f63f92f15751cd2572b5 Mon Sep 17 00:00:00 2001
From: Zachary Tong <polyfractal@elastic.co>
Date: Thu, 5 Dec 2019 16:11:27 -0500
Subject: [PATCH 084/686] Decouple pipeline reductions from final agg reduction
 (#45796)

Historically only two things happened in the final reduction:
empty buckets were filled, and pipeline aggs were reduced (since it
was the final reduction, this was safe).  Usage of the final reduction
is growing however.  Auto-date-histo might need to perform
many reductions on final-reduce to merge down buckets, CCS
may need to side-step the final reduction if sending to a
different cluster, etc

Having pipelines generate their output in the final reduce was
convenient, but is becoming increasingly difficult to manage
as the rest of the agg framework advances.

This commit decouples pipeline aggs from the final reduction by
introducing a new "top level" reduce, which should be called
at the beginning of the reduce cycle (e.g. from the SearchPhaseController).
This will only reduce pipeline aggs on the final reduce after
the non-pipeline agg tree has been fully reduced.

By separating pipeline reduction into their own set of methods,
aggregations are free to use the final reduction for whatever
purpose without worrying about generating pipeline results
which are non-reducible
---
 .../matrix/stats/InternalMatrixStats.java     |  2 +-
 .../action/search/SearchPhaseController.java  |  4 +-
 .../action/search/SearchResponseMerger.java   |  2 +-
 .../aggregations/InternalAggregation.java     | 24 +++++----
 .../aggregations/InternalAggregations.java    | 47 ++++++++++++++---
 .../InternalMultiBucketAggregation.java       | 27 +++++++++-
 .../InternalSingleBucketAggregation.java      |  2 +-
 .../adjacency/InternalAdjacencyMatrix.java    |  2 +-
 .../bucket/composite/InternalComposite.java   |  2 +-
 .../bucket/filter/InternalFilters.java        |  2 +-
 .../bucket/geogrid/InternalGeoGrid.java       |  2 +-
 .../histogram/InternalAutoDateHistogram.java  |  2 +-
 .../histogram/InternalDateHistogram.java      |  2 +-
 .../bucket/histogram/InternalHistogram.java   |  2 +-
 .../bucket/range/InternalBinaryRange.java     |  2 +-
 .../bucket/range/InternalRange.java           |  2 +-
 .../bucket/sampler/UnmappedSampler.java       |  2 +-
 ...balOrdinalsSignificantTermsAggregator.java |  2 +-
 .../significant/InternalSignificantTerms.java |  5 +-
 .../significant/SignificantLongTerms.java     | 11 ++--
 .../SignificantLongTermsAggregator.java       |  2 +-
 .../significant/SignificantStringTerms.java   | 13 ++---
 .../SignificantStringTermsAggregator.java     |  2 +-
 .../SignificantTextAggregator.java            |  2 +-
 .../significant/UnmappedSignificantTerms.java |  2 +-
 .../bucket/terms/DoubleTerms.java             |  6 +--
 .../bucket/terms/InternalMappedRareTerms.java |  2 +-
 .../bucket/terms/InternalRareTerms.java       |  2 +-
 .../bucket/terms/InternalTerms.java           |  2 +-
 .../aggregations/bucket/terms/LongTerms.java  |  6 +--
 .../bucket/terms/UnmappedRareTerms.java       |  2 +-
 .../bucket/terms/UnmappedTerms.java           |  2 +-
 .../AbstractInternalHDRPercentiles.java       |  2 +-
 .../AbstractInternalTDigestPercentiles.java   |  2 +-
 .../aggregations/metrics/InternalAvg.java     |  2 +-
 .../metrics/InternalCardinality.java          |  2 +-
 .../metrics/InternalExtendedStats.java        |  4 +-
 .../metrics/InternalGeoBounds.java            |  2 +-
 .../metrics/InternalGeoCentroid.java          |  2 +-
 .../aggregations/metrics/InternalMax.java     |  2 +-
 .../InternalMedianAbsoluteDeviation.java      |  2 +-
 .../aggregations/metrics/InternalMin.java     |  2 +-
 .../metrics/InternalScriptedMetric.java       |  2 +-
 .../aggregations/metrics/InternalStats.java   |  2 +-
 .../aggregations/metrics/InternalSum.java     |  2 +-
 .../aggregations/metrics/InternalTopHits.java |  2 +-
 .../metrics/InternalValueCount.java           |  2 +-
 .../metrics/InternalWeightedAvg.java          |  2 +-
 .../pipeline/InternalBucketMetricValue.java   |  2 +-
 .../pipeline/InternalExtendedStatsBucket.java |  2 +-
 .../pipeline/InternalPercentilesBucket.java   |  2 +-
 .../pipeline/InternalSimpleValue.java         |  2 +-
 .../pipeline/InternalStatsBucket.java         |  2 +-
 .../InternalAggregationsTests.java            |  6 +--
 .../AutoDateHistogramAggregatorTests.java     | 52 ++++++++++++++++++-
 .../InternalAutoDateHistogramTests.java       |  1 -
 .../histogram/InternalHistogramTests.java     |  2 +-
 .../SignificanceHeuristicTests.java           | 10 ++--
 .../SignificantLongTermsTests.java            |  4 +-
 .../SignificantStringTermsTests.java          |  4 +-
 .../bucket/terms/TermsAggregatorTests.java    |  2 +-
 .../metrics/InternalAvgTests.java             |  4 +-
 .../metrics/InternalExtendedStatsTests.java   |  2 +-
 .../metrics/InternalStatsTests.java           |  2 +-
 .../metrics/InternalSumTests.java             |  2 +-
 .../pipeline/AvgBucketAggregatorTests.java    |  2 +-
 .../aggregations/AggregatorTestCase.java      |  9 +++-
 .../InternalSimpleLongValue.java              |  2 +-
 .../stringstats/InternalStringStats.java      |  2 +-
 .../RollupResponseTranslationTests.java       |  2 +-
 .../extractor/TestMultiValueAggregation.java  |  2 +-
 .../extractor/TestSingleValueAggregation.java |  2 +-
 72 files changed, 223 insertions(+), 122 deletions(-)

diff --git a/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/InternalMatrixStats.java b/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/InternalMatrixStats.java
index c70ddea7e3b22..5fda5af7418a3 100644
--- a/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/InternalMatrixStats.java
+++ b/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/InternalMatrixStats.java
@@ -233,7 +233,7 @@ public Object getProperty(List<String> path) {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         // merge stats across all shards
         List<InternalAggregation> aggs = new ArrayList<>(aggregations);
         aggs.removeIf(p -> ((InternalMatrixStats)p).stats == null);
diff --git a/server/src/main/java/org/elasticsearch/action/search/SearchPhaseController.java b/server/src/main/java/org/elasticsearch/action/search/SearchPhaseController.java
index 0bd7afa7f61c2..27b5c9cf3b2a8 100644
--- a/server/src/main/java/org/elasticsearch/action/search/SearchPhaseController.java
+++ b/server/src/main/java/org/elasticsearch/action/search/SearchPhaseController.java
@@ -487,7 +487,7 @@ private ReducedQueryPhase reducedQueryPhase(Collection<? extends SearchPhaseResu
         }
         ReduceContext reduceContext = reduceContextFunction.apply(performFinalReduce);
         final InternalAggregations aggregations = aggregationsList.isEmpty() ? null :
-            InternalAggregations.reduce(aggregationsList, reduceContext);
+            InternalAggregations.topLevelReduce(aggregationsList, reduceContext);
         final SearchProfileShardResults shardResults = profileResults.isEmpty() ? null : new SearchProfileShardResults(profileResults);
         final SortedTopDocs sortedTopDocs = sortDocs(isScrollRequest, queryResults, bufferedTopDocs, topDocsStats, from, size,
             reducedCompletionSuggestions);
@@ -625,7 +625,7 @@ private synchronized void consumeInternal(QuerySearchResult querySearchResult) {
             if (index == bufferSize) {
                 if (hasAggs) {
                     ReduceContext reduceContext = controller.reduceContextFunction.apply(false);
-                    InternalAggregations reducedAggs = InternalAggregations.reduce(Arrays.asList(aggsBuffer), reduceContext);
+                    InternalAggregations reducedAggs = InternalAggregations.topLevelReduce(Arrays.asList(aggsBuffer), reduceContext);
                     Arrays.fill(aggsBuffer, null);
                     aggsBuffer[0] = reducedAggs;
                 }
diff --git a/server/src/main/java/org/elasticsearch/action/search/SearchResponseMerger.java b/server/src/main/java/org/elasticsearch/action/search/SearchResponseMerger.java
index 53afda5984183..16092434ab17b 100644
--- a/server/src/main/java/org/elasticsearch/action/search/SearchResponseMerger.java
+++ b/server/src/main/java/org/elasticsearch/action/search/SearchResponseMerger.java
@@ -196,7 +196,7 @@ SearchResponse getMergedResponse(Clusters clusters) {
         SearchHits mergedSearchHits = topDocsToSearchHits(topDocs, topDocsStats);
         setSuggestShardIndex(shards, groupedSuggestions);
         Suggest suggest = groupedSuggestions.isEmpty() ? null : new Suggest(Suggest.reduce(groupedSuggestions));
-        InternalAggregations reducedAggs = InternalAggregations.reduce(aggs, reduceContextFunction.apply(true));
+        InternalAggregations reducedAggs = InternalAggregations.topLevelReduce(aggs, reduceContextFunction.apply(true));
         ShardSearchFailure[] shardFailures = failures.toArray(ShardSearchFailure.EMPTY_ARRAY);
         SearchProfileShardResults profileShardResults = profileResults.isEmpty() ? null : new SearchProfileShardResults(profileResults);
         //make failures ordering consistent between ordinary search and CCS by looking at the shard they come from
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/InternalAggregation.java b/server/src/main/java/org/elasticsearch/search/aggregations/InternalAggregation.java
index 4b929c692edcd..a7fe4635183eb 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/InternalAggregation.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/InternalAggregation.java
@@ -126,23 +126,25 @@ public String getName() {
         return name;
     }
 
+    /**
+     * Creates the output from all pipeline aggs that this aggregation is associated with.  Should only
+     * be called after all aggregations have been fully reduced
+     */
+    public InternalAggregation reducePipelines(InternalAggregation reducedAggs, ReduceContext reduceContext) {
+        assert reduceContext.isFinalReduce();
+        for (PipelineAggregator pipelineAggregator : pipelineAggregators) {
+            reducedAggs = pipelineAggregator.reduce(reducedAggs, reduceContext);
+        }
+        return reducedAggs;
+    }
+
     /**
      * Reduces the given aggregations to a single one and returns it. In <b>most</b> cases, the assumption will be the all given
      * aggregations are of the same type (the same type as this aggregation). For best efficiency, when implementing,
      * try reusing an existing instance (typically the first in the given list) to save on redundant object
      * construction.
      */
-    public final InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
-        InternalAggregation aggResult = doReduce(aggregations, reduceContext);
-        if (reduceContext.isFinalReduce()) {
-            for (PipelineAggregator pipelineAggregator : pipelineAggregators) {
-                aggResult = pipelineAggregator.reduce(aggResult, reduceContext);
-            }
-        }
-        return aggResult;
-    }
-
-    public abstract InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext);
+    public abstract InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext);
 
     /**
      * Return true if this aggregation is mapped, and can lead a reduction.  If this agg returns
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/InternalAggregations.java b/server/src/main/java/org/elasticsearch/search/aggregations/InternalAggregations.java
index e1597c5c8c063..b4fdd74a10b85 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/InternalAggregations.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/InternalAggregations.java
@@ -33,6 +33,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
+import java.util.stream.Collectors;
 
 /**
  * An internal implementation of {@link Aggregations}.
@@ -91,10 +92,47 @@ public List<SiblingPipelineAggregator> getTopLevelPipelineAggregators() {
         return topLevelPipelineAggregators;
     }
 
+    @SuppressWarnings("unchecked")
+    private List<InternalAggregation> getInternalAggregations() {
+        return (List<InternalAggregation>) aggregations;
+    }
+
+    /**
+     * Begin the reduction process.  This should be the entry point for the "first" reduction, e.g. called by
+     * SearchPhaseController or anywhere else that wants to initiate a reduction.  It _should not_ be called
+     * as an intermediate reduction step (e.g. in the middle of an aggregation tree).
+     *
+     * This method first reduces the aggregations, and if it is the final reduce, then reduce the pipeline
+     * aggregations (both embedded parent/sibling as well as top-level sibling pipelines)
+     */
+    public static InternalAggregations topLevelReduce(List<InternalAggregations> aggregationsList, ReduceContext context) {
+        InternalAggregations reduced = reduce(aggregationsList, context);
+        if (reduced == null) {
+            return null;
+        }
+
+        if (context.isFinalReduce()) {
+            List<InternalAggregation> reducedInternalAggs = reduced.getInternalAggregations();
+            reducedInternalAggs = reducedInternalAggs.stream()
+                .map(agg -> agg.reducePipelines(agg, context))
+                .collect(Collectors.toList());
+
+            List<SiblingPipelineAggregator> topLevelPipelineAggregators = aggregationsList.get(0).getTopLevelPipelineAggregators();
+            for (SiblingPipelineAggregator pipelineAggregator : topLevelPipelineAggregators) {
+                InternalAggregation newAgg
+                    = pipelineAggregator.doReduce(new InternalAggregations(reducedInternalAggs), context);
+                reducedInternalAggs.add(newAgg);
+            }
+            return new InternalAggregations(reducedInternalAggs);
+        }
+        return reduced;
+    }
+
     /**
      * Reduces the given list of aggregations as well as the top-level pipeline aggregators extracted from the first
      * {@link InternalAggregations} object found in the list.
-     * Note that top-level pipeline aggregators are reduced only as part of the final reduction phase, otherwise they are left untouched.
+     * Note that pipeline aggregations _are not_ reduced by this method.  Pipelines are handled
+     * separately by {@link InternalAggregations#topLevelReduce(List, ReduceContext)}
      */
     public static InternalAggregations reduce(List<InternalAggregations> aggregationsList, ReduceContext context) {
         if (aggregationsList.isEmpty()) {
@@ -123,13 +161,6 @@ public static InternalAggregations reduce(List<InternalAggregations> aggregation
             reducedAggregations.add(first.reduce(aggregations, context));
         }
 
-        if (context.isFinalReduce()) {
-            for (SiblingPipelineAggregator pipelineAggregator : topLevelPipelineAggregators) {
-                InternalAggregation newAgg = pipelineAggregator.doReduce(new InternalAggregations(reducedAggregations), context);
-                reducedAggregations.add(newAgg);
-            }
-            return new InternalAggregations(reducedAggregations);
-        }
         return new InternalAggregations(reducedAggregations, topLevelPipelineAggregators);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/InternalMultiBucketAggregation.java b/server/src/main/java/org/elasticsearch/search/aggregations/InternalMultiBucketAggregation.java
index 41b1a9aef6230..cfad39166e70d 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/InternalMultiBucketAggregation.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/InternalMultiBucketAggregation.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
 
 import java.io.IOException;
+import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
 
@@ -73,7 +74,7 @@ protected InternalMultiBucketAggregation(StreamInput in) throws IOException {
     protected abstract B reduceBucket(List<B> buckets, ReduceContext context);
 
     @Override
-    public abstract List<? extends InternalBucket> getBuckets();
+    public abstract List<B> getBuckets();
 
     @Override
     public Object getProperty(List<String> path) {
@@ -141,6 +142,30 @@ public static int countInnerBucket(Aggregation agg) {
         return size;
     }
 
+    /**
+     * Unlike {@link InternalAggregation#reducePipelines(InternalAggregation, ReduceContext)}, a multi-bucket
+     * agg needs to first reduce the buckets (and their parent pipelines) before allowing sibling pipelines
+     * to materialize
+     */
+    @Override
+    public final InternalAggregation reducePipelines(InternalAggregation reducedAggs, ReduceContext reduceContext) {
+        assert reduceContext.isFinalReduce();
+        List<B> materializedBuckets = reducePipelineBuckets(reduceContext);
+        return super.reducePipelines(create(materializedBuckets), reduceContext);
+    }
+
+    private List<B> reducePipelineBuckets(ReduceContext reduceContext) {
+        List<B> reducedBuckets = new ArrayList<>();
+        for (B bucket : getBuckets()) {
+            List<InternalAggregation> aggs = new ArrayList<>();
+            for (Aggregation agg : bucket.getAggregations()) {
+                aggs.add(((InternalAggregation)agg).reducePipelines((InternalAggregation)agg, reduceContext));
+            }
+            reducedBuckets.add(createBucket(new InternalAggregations(aggs), bucket));
+        }
+        return reducedBuckets;
+    }
+
     public abstract static class InternalBucket implements Bucket, Writeable {
 
         public Object getProperty(String containingAggName, List<String> path) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/InternalSingleBucketAggregation.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/InternalSingleBucketAggregation.java
index cf5ddc54884d0..0a34e7a92b8f1 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/InternalSingleBucketAggregation.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/InternalSingleBucketAggregation.java
@@ -97,7 +97,7 @@ public InternalSingleBucketAggregation create(InternalAggregations subAggregatio
     protected abstract InternalSingleBucketAggregation newAggregation(String name, long docCount, InternalAggregations subAggregations);
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         long docCount = 0L;
         List<InternalAggregations> subAggregationsList = new ArrayList<>(aggregations.size());
         for (InternalAggregation aggregation : aggregations) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/adjacency/InternalAdjacencyMatrix.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/adjacency/InternalAdjacencyMatrix.java
index 57c7d703cbdf6..78181e3a3366a 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/adjacency/InternalAdjacencyMatrix.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/adjacency/InternalAdjacencyMatrix.java
@@ -181,7 +181,7 @@ public InternalBucket getBucketByKey(String key) {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         Map<String, List<InternalBucket>> bucketsMap = new HashMap<>();
         for (InternalAggregation aggregation : aggregations) {
             InternalAdjacencyMatrix filters = (InternalAdjacencyMatrix) aggregation;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
index e11db15acecad..243ae557bfa2c 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
@@ -143,7 +143,7 @@ int[] getReverseMuls() {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         PriorityQueue<BucketIterator> pq = new PriorityQueue<>(aggregations.size());
         for (InternalAggregation agg : aggregations) {
             InternalComposite sortedAgg = (InternalComposite) agg;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/filter/InternalFilters.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/filter/InternalFilters.java
index 271d1c54d5898..d99da0187f74b 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/filter/InternalFilters.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/filter/InternalFilters.java
@@ -189,7 +189,7 @@ public InternalBucket getBucketByKey(String key) {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         List<List<InternalBucket>> bucketsList = null;
         for (InternalAggregation aggregation : aggregations) {
             InternalFilters filters = (InternalFilters) aggregation;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/InternalGeoGrid.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/InternalGeoGrid.java
index 61c06a062cc05..1760fc19728c4 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/InternalGeoGrid.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/InternalGeoGrid.java
@@ -81,7 +81,7 @@ public List<InternalGeoGridBucket> getBuckets() {
     }
 
     @Override
-    public InternalGeoGrid doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalGeoGrid reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         LongObjectPagedHashMap<List<InternalGeoGridBucket>> buckets = null;
         for (InternalAggregation aggregation : aggregations) {
             InternalGeoGrid grid = (InternalGeoGrid) aggregation;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalAutoDateHistogram.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalAutoDateHistogram.java
index c776d764637dd..0d81188c8ca0e 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalAutoDateHistogram.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalAutoDateHistogram.java
@@ -498,7 +498,7 @@ static int getAppropriateRounding(long minKey, long maxKey, int roundingIdx,
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         BucketReduceResult reducedBucketsResult = reduceBuckets(aggregations, reduceContext);
 
         if (reduceContext.isFinalReduce()) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalDateHistogram.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalDateHistogram.java
index 1e79b60ca7976..1f1775ede7535 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalDateHistogram.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalDateHistogram.java
@@ -448,7 +448,7 @@ private void addEmptyBuckets(List<Bucket> list, ReduceContext reduceContext) {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         List<Bucket> reducedBuckets = reduceBuckets(aggregations, reduceContext);
         if (reduceContext.isFinalReduce()) {
             if (minDocCount == 0) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalHistogram.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalHistogram.java
index f4f7db5cd64a2..bc20534c5251b 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalHistogram.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalHistogram.java
@@ -421,7 +421,7 @@ private void addEmptyBuckets(List<Bucket> list, ReduceContext reduceContext) {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         List<Bucket> reducedBuckets = reduceBuckets(aggregations, reduceContext);
         if (reduceContext.isFinalReduce()) {
             if (minDocCount == 0) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/InternalBinaryRange.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/InternalBinaryRange.java
index 04252c0a25a50..21d0f2fdab5ca 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/InternalBinaryRange.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/InternalBinaryRange.java
@@ -230,7 +230,7 @@ public Bucket createBucket(InternalAggregations aggregations, Bucket prototype)
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         reduceContext.consumeBucketsAndMaybeBreak(buckets.size());
         long[] docCounts = new long[buckets.size()];
         InternalAggregations[][] aggs = new InternalAggregations[buckets.size()][];
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/InternalRange.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/InternalRange.java
index 399dc04e44f5f..a77b70a480850 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/InternalRange.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/InternalRange.java
@@ -288,7 +288,7 @@ public B createBucket(InternalAggregations aggregations, B prototype) {
 
     @SuppressWarnings("unchecked")
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         reduceContext.consumeBucketsAndMaybeBreak(ranges.size());
         List<B>[] rangeList = new List[ranges.size()];
         for (int i = 0; i < rangeList.length; ++i) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/sampler/UnmappedSampler.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/sampler/UnmappedSampler.java
index 5f5f557ffd561..6f1a4cc6a4aad 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/sampler/UnmappedSampler.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/sampler/UnmappedSampler.java
@@ -49,7 +49,7 @@ public String getWriteableName() {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         return new UnmappedSampler(name, pipelineAggregators(), metaData);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/GlobalOrdinalsSignificantTermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/GlobalOrdinalsSignificantTermsAggregator.java
index d641a2773e615..47926760d3ba9 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/GlobalOrdinalsSignificantTermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/GlobalOrdinalsSignificantTermsAggregator.java
@@ -126,7 +126,7 @@ public SignificantStringTerms buildAggregation(long owningBucketOrdinal) throws
             }
 
             if (spare == null) {
-                spare = new SignificantStringTerms.Bucket(new BytesRef(), 0, 0, 0, 0, null, format);
+                spare = new SignificantStringTerms.Bucket(new BytesRef(), 0, 0, 0, 0, null, format, 0);
             }
             spare.bucketOrd = bucketOrd;
             copy(lookupGlobalOrd.apply(globalOrd), spare.termBytes);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/InternalSignificantTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/InternalSignificantTerms.java
index 49c2718baaf26..789ced9cd035e 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/InternalSignificantTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/InternalSignificantTerms.java
@@ -105,6 +105,9 @@ public long getSubsetSize() {
             return subsetSize;
         }
 
+        // TODO we should refactor to remove this, since buckets should be immutable after they are generated.
+        // This can lead to confusing bugs if the bucket is re-created (via createBucket() or similar) without
+        // the score
         void updateScore(SignificanceHeuristic significanceHeuristic) {
             score = significanceHeuristic.getScore(subsetDf, subsetSize, supersetDf, supersetSize);
         }
@@ -191,7 +194,7 @@ protected final void doWriteTo(StreamOutput out) throws IOException {
     public abstract List<B> getBuckets();
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         long globalSubsetSize = 0;
         long globalSupersetSize = 0;
         // Compute the overall result set size and the corpus size using the
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTerms.java
index 582346f529a8a..d9f4ac7e1f10f 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTerms.java
@@ -42,14 +42,9 @@ static class Bucket extends InternalSignificantTerms.Bucket<Bucket> {
         long term;
 
         Bucket(long subsetDf, long subsetSize, long supersetDf, long supersetSize, long term, InternalAggregations aggregations,
-                DocValueFormat format) {
+                DocValueFormat format, double score) {
             super(subsetDf, subsetSize, supersetDf, supersetSize, aggregations, format);
             this.term = term;
-        }
-
-        Bucket(long subsetDf, long subsetSize, long supersetDf, long supersetSize, long term, InternalAggregations aggregations,
-                double score) {
-            this(subsetDf, subsetSize, supersetDf, supersetSize, term, aggregations, null);
             this.score = score;
         }
 
@@ -134,7 +129,7 @@ public SignificantLongTerms create(List<SignificantLongTerms.Bucket> buckets) {
     @Override
     public Bucket createBucket(InternalAggregations aggregations, SignificantLongTerms.Bucket prototype) {
         return new Bucket(prototype.subsetDf, prototype.subsetSize, prototype.supersetDf, prototype.supersetSize, prototype.term,
-                aggregations, prototype.format);
+                aggregations, prototype.format, prototype.score);
     }
 
     @Override
@@ -151,6 +146,6 @@ protected Bucket[] createBucketsArray(int size) {
     @Override
     Bucket createBucket(long subsetDf, long subsetSize, long supersetDf, long supersetSize,
                         InternalAggregations aggregations, SignificantLongTerms.Bucket prototype) {
-        return new Bucket(subsetDf, subsetSize, supersetDf, supersetSize, prototype.term, aggregations, format);
+        return new Bucket(subsetDf, subsetSize, supersetDf, supersetSize, prototype.term, aggregations, format, prototype.score);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTermsAggregator.java
index 2fcba9f09bf7e..8684acb600a2f 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTermsAggregator.java
@@ -88,7 +88,7 @@ public SignificantLongTerms buildAggregation(long owningBucketOrdinal) throws IO
                 continue;
             }
             if (spare == null) {
-                spare = new SignificantLongTerms.Bucket(0, 0, 0, 0, 0, null, format);
+                spare = new SignificantLongTerms.Bucket(0, 0, 0, 0, 0, null, format, 0);
             }
             spare.term = bucketOrds.get(i);
             spare.subsetDf = docCount;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTerms.java
index 6c7da48a56092..cb79e52238399 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTerms.java
@@ -43,9 +43,10 @@ public static class Bucket extends InternalSignificantTerms.Bucket<Bucket> {
         BytesRef termBytes;
 
         public Bucket(BytesRef term, long subsetDf, long subsetSize, long supersetDf, long supersetSize, InternalAggregations aggregations,
-                DocValueFormat format) {
+                DocValueFormat format, double score) {
             super(subsetDf, subsetSize, supersetDf, supersetSize, aggregations, format);
             this.termBytes = term;
+            this.score = score;
         }
 
         /**
@@ -69,12 +70,6 @@ public void writeTo(StreamOutput out) throws IOException {
             aggregations.writeTo(out);
         }
 
-        public Bucket(BytesRef term, long subsetDf, long subsetSize, long supersetDf, long supersetSize,
-                InternalAggregations aggregations, double score, DocValueFormat format) {
-            this(term, subsetDf, subsetSize, supersetDf, supersetSize, aggregations, format);
-            this.score = score;
-        }
-
         @Override
         public Number getKeyAsNumber() {
             // this method is needed for scripted numeric aggregations
@@ -139,7 +134,7 @@ public SignificantStringTerms create(List<SignificantStringTerms.Bucket> buckets
     @Override
     public Bucket createBucket(InternalAggregations aggregations, SignificantStringTerms.Bucket prototype) {
         return new Bucket(prototype.termBytes, prototype.subsetDf, prototype.subsetSize, prototype.supersetDf, prototype.supersetSize,
-                aggregations, prototype.format);
+                aggregations, prototype.format, prototype.score);
     }
 
     @Override
@@ -156,6 +151,6 @@ protected Bucket[] createBucketsArray(int size) {
     @Override
     Bucket createBucket(long subsetDf, long subsetSize, long supersetDf, long supersetSize,
                         InternalAggregations aggregations, SignificantStringTerms.Bucket prototype) {
-        return new Bucket(prototype.termBytes, subsetDf, subsetSize, supersetDf, supersetSize, aggregations, format);
+        return new Bucket(prototype.termBytes, subsetDf, subsetSize, supersetDf, supersetSize, aggregations, format, prototype.score);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTermsAggregator.java
index 91ade2e42f740..ed4c96f19add7 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTermsAggregator.java
@@ -91,7 +91,7 @@ public SignificantStringTerms buildAggregation(long owningBucketOrdinal) throws
             }
 
             if (spare == null) {
-                spare = new SignificantStringTerms.Bucket(new BytesRef(), 0, 0, 0, 0, null, format);
+                spare = new SignificantStringTerms.Bucket(new BytesRef(), 0, 0, 0, 0, null, format, 0);
             }
 
             bucketOrds.get(i, spare.termBytes);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTextAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTextAggregator.java
index 7f62813278b64..170b0e1fd81c5 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTextAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTextAggregator.java
@@ -201,7 +201,7 @@ public SignificantStringTerms buildAggregation(long owningBucketOrdinal) throws
             }
 
             if (spare == null) {
-                spare = new SignificantStringTerms.Bucket(new BytesRef(), 0, 0, 0, 0, null, format);
+                spare = new SignificantStringTerms.Bucket(new BytesRef(), 0, 0, 0, 0, null, format, 0);
             }
 
             bucketOrds.get(i, spare.termBytes);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/UnmappedSignificantTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/UnmappedSignificantTerms.java
index d9e3c85de3a60..3b88fb0d3e460 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/UnmappedSignificantTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/UnmappedSignificantTerms.java
@@ -105,7 +105,7 @@ Bucket createBucket(long subsetDf, long subsetSize, long supersetDf, long supers
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         return new UnmappedSignificantTerms(name, requiredSize, minDocCount, pipelineAggregators(), metaData);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/DoubleTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/DoubleTerms.java
index 8bc0e83c8d6a6..9672136cf5bea 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/DoubleTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/DoubleTerms.java
@@ -144,7 +144,7 @@ protected Bucket[] createBucketsArray(int size) {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         boolean promoteToDouble = false;
         for (InternalAggregation agg : aggregations) {
             if (agg instanceof LongTerms && ((LongTerms) agg).format == DocValueFormat.RAW) {
@@ -157,7 +157,7 @@ public InternalAggregation doReduce(List<InternalAggregation> aggregations, Redu
             }
         }
         if (promoteToDouble == false) {
-            return super.doReduce(aggregations, reduceContext);
+            return super.reduce(aggregations, reduceContext);
         }
         List<InternalAggregation> newAggs = new ArrayList<>(aggregations.size());
         for (InternalAggregation agg : aggregations) {
@@ -168,7 +168,7 @@ public InternalAggregation doReduce(List<InternalAggregation> aggregations, Redu
                 newAggs.add(agg);
             }
         }
-        return newAggs.get(0).doReduce(newAggs, reduceContext);
+        return newAggs.get(0).reduce(newAggs, reduceContext);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalMappedRareTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalMappedRareTerms.java
index 7711946226470..bc8e8198984ef 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalMappedRareTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalMappedRareTerms.java
@@ -87,7 +87,7 @@ protected void writeTermTypeInfoTo(StreamOutput out) throws IOException {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         Map<Object, List<B>> buckets = new HashMap<>();
         InternalRareTerms<A, B> referenceTerms = null;
         SetBackedScalingCuckooFilter filter = null;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalRareTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalRareTerms.java
index ae9f8e27ec6ae..dee3424621cd6 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalRareTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalRareTerms.java
@@ -154,7 +154,7 @@ protected final void doWriteTo(StreamOutput out) throws IOException {
     public abstract B getBucketByKey(String term);
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException();
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalTerms.java
index 3eefc9bee0100..8f45749a36304 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalTerms.java
@@ -192,7 +192,7 @@ protected final void doWriteTo(StreamOutput out) throws IOException {
     public abstract B getBucketByKey(String term);
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         Map<Object, List<B>> buckets = new HashMap<>();
         long sumDocCountError = 0;
         long otherDocCount = 0;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/LongTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/LongTerms.java
index 6a0fcde1fa053..90ebe7af36abe 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/LongTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/LongTerms.java
@@ -144,13 +144,13 @@ protected Bucket[] createBucketsArray(int size) {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         for (InternalAggregation agg : aggregations) {
             if (agg instanceof DoubleTerms) {
-                return agg.doReduce(aggregations, reduceContext);
+                return agg.reduce(aggregations, reduceContext);
             }
         }
-        return super.doReduce(aggregations, reduceContext);
+        return super.reduce(aggregations, reduceContext);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/UnmappedRareTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/UnmappedRareTerms.java
index c4a019e6fe9b2..58dac3ece2b24 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/UnmappedRareTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/UnmappedRareTerms.java
@@ -93,7 +93,7 @@ protected UnmappedRareTerms createWithFilter(String name, List<UnmappedRareTerms
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         return new UnmappedRareTerms(name, pipelineAggregators(), metaData);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/UnmappedTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/UnmappedTerms.java
index 8096366f6d655..2a1baff9ded4d 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/UnmappedTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/UnmappedTerms.java
@@ -99,7 +99,7 @@ protected UnmappedTerms create(String name, List<Bucket> buckets, long docCountE
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         return new UnmappedTerms(name, order, requiredSize, minDocCount, pipelineAggregators(), metaData);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractInternalHDRPercentiles.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractInternalHDRPercentiles.java
index d8e043ee9b5e9..692ea1761fe3c 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractInternalHDRPercentiles.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractInternalHDRPercentiles.java
@@ -103,7 +103,7 @@ DoubleHistogram getState() {
     }
 
     @Override
-    public AbstractInternalHDRPercentiles doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public AbstractInternalHDRPercentiles reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         DoubleHistogram merged = null;
         for (InternalAggregation aggregation : aggregations) {
             final AbstractInternalHDRPercentiles percentiles = (AbstractInternalHDRPercentiles) aggregation;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractInternalTDigestPercentiles.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractInternalTDigestPercentiles.java
index ca03e2aa2b1c9..f691a438d0d07 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractInternalTDigestPercentiles.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractInternalTDigestPercentiles.java
@@ -87,7 +87,7 @@ TDigestState getState() {
     }
 
     @Override
-    public AbstractInternalTDigestPercentiles doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public AbstractInternalTDigestPercentiles reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         TDigestState merged = null;
         for (InternalAggregation aggregation : aggregations) {
             final AbstractInternalTDigestPercentiles percentiles = (AbstractInternalTDigestPercentiles) aggregation;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalAvg.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalAvg.java
index 3e3b2ae03ea0d..199f3a7ccc872 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalAvg.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalAvg.java
@@ -87,7 +87,7 @@ public String getWriteableName() {
     }
 
     @Override
-    public InternalAvg doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAvg reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         CompensatedSum kahanSummation = new CompensatedSum(0, 0);
         long count = 0;
         // Compute the sum of double values with Kahan summation algorithm which is more
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalCardinality.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalCardinality.java
index c3132a299042e..bc2c4d88c4679 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalCardinality.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalCardinality.java
@@ -85,7 +85,7 @@ public HyperLogLogPlusPlus getCounts() {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         InternalCardinality reduced = null;
         for (InternalAggregation aggregation : aggregations) {
             final InternalCardinality cardinality = (InternalCardinality) aggregation;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalExtendedStats.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalExtendedStats.java
index 3fe2e75576aa4..5385960579451 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalExtendedStats.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalExtendedStats.java
@@ -140,7 +140,7 @@ public String getStdDeviationBoundAsString(Bounds bound) {
     }
 
     @Override
-    public InternalExtendedStats doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalExtendedStats reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         double sumOfSqrs = 0;
         double compensationOfSqrs = 0;
         for (InternalAggregation aggregation : aggregations) {
@@ -158,7 +158,7 @@ public InternalExtendedStats doReduce(List<InternalAggregation> aggregations, Re
                 sumOfSqrs = newSumOfSqrs;
             }
         }
-        final InternalStats stats = super.doReduce(aggregations, reduceContext);
+        final InternalStats stats = super.reduce(aggregations, reduceContext);
         return new InternalExtendedStats(name, stats.getCount(), stats.getSum(), stats.getMin(), stats.getMax(), sumOfSqrs, sigma,
             format, pipelineAggregators(), getMetaData());
     }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBounds.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBounds.java
index 4d48e4ab8966b..91007ab2f8fff 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBounds.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBounds.java
@@ -93,7 +93,7 @@ public String getWriteableName() {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         double top = Double.NEGATIVE_INFINITY;
         double bottom = Double.POSITIVE_INFINITY;
         double posLeft = Double.POSITIVE_INFINITY;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoCentroid.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoCentroid.java
index 2172d15259b85..24493273aa534 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoCentroid.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoCentroid.java
@@ -114,7 +114,7 @@ public long count() {
     }
 
     @Override
-    public InternalGeoCentroid doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalGeoCentroid reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         double lonSum = Double.NaN;
         double latSum = Double.NaN;
         int totalCount = 0;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMax.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMax.java
index 9a8458c85a690..6abb0d3a51dd8 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMax.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMax.java
@@ -71,7 +71,7 @@ public double getValue() {
     }
 
     @Override
-    public InternalMax doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalMax reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         double max = Double.NEGATIVE_INFINITY;
         for (InternalAggregation aggregation : aggregations) {
             max = Math.max(max, ((InternalMax) aggregation).max);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMedianAbsoluteDeviation.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMedianAbsoluteDeviation.java
index 871f387638dc3..b228c95c0dc3b 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMedianAbsoluteDeviation.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMedianAbsoluteDeviation.java
@@ -80,7 +80,7 @@ protected void doWriteTo(StreamOutput out) throws IOException {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         final TDigestState valueMerged = new TDigestState(valuesSketch.compression());
         for (InternalAggregation aggregation : aggregations) {
             final InternalMedianAbsoluteDeviation madAggregation = (InternalMedianAbsoluteDeviation) aggregation;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMin.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMin.java
index f68d5a46860bc..6912f55ecafdc 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMin.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalMin.java
@@ -71,7 +71,7 @@ public double getValue() {
     }
 
     @Override
-    public InternalMin doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalMin reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         double min = Double.POSITIVE_INFINITY;
         for (InternalAggregation aggregation : aggregations) {
             min = Math.min(min, ((InternalMin) aggregation).min);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalScriptedMetric.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalScriptedMetric.java
index ce051a1691b55..e6113f3763cdf 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalScriptedMetric.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalScriptedMetric.java
@@ -85,7 +85,7 @@ List<Object> getAggregation() {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         List<Object> aggregationObjects = new ArrayList<>();
         for (InternalAggregation aggregation : aggregations) {
             InternalScriptedMetric mapReduceAggregation = (InternalScriptedMetric) aggregation;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalStats.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalStats.java
index adb879999a410..661457e1c1f3d 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalStats.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalStats.java
@@ -145,7 +145,7 @@ public double value(String name) {
     }
 
     @Override
-    public InternalStats doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalStats reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         long count = 0;
         double min = Double.POSITIVE_INFINITY;
         double max = Double.NEGATIVE_INFINITY;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalSum.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalSum.java
index 6e6315eded101..5778edb4da19a 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalSum.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalSum.java
@@ -71,7 +71,7 @@ public double getValue() {
     }
 
     @Override
-    public InternalSum doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalSum reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         // Compute the sum of double values with Kahan summation algorithm which is more
         // accurate than naive summation.
         CompensatedSum kahanSummation = new CompensatedSum(0, 0);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalTopHits.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalTopHits.java
index 348e98302d2bc..4f922bd39d947 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalTopHits.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalTopHits.java
@@ -99,7 +99,7 @@ int getSize() {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         final SearchHits[] shardHits = new SearchHits[aggregations.size()];
         final int from;
         final int size;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalValueCount.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalValueCount.java
index 32ee8bd36d120..0c942e1afbcaf 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalValueCount.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalValueCount.java
@@ -70,7 +70,7 @@ public double value() {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         long valueCount = 0;
         for (InternalAggregation aggregation : aggregations) {
             valueCount += ((InternalValueCount) aggregation).value;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalWeightedAvg.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalWeightedAvg.java
index 4b3523b03ac3d..e4c79f7f8996f 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalWeightedAvg.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalWeightedAvg.java
@@ -87,7 +87,7 @@ public String getWriteableName() {
     }
 
     @Override
-    public InternalWeightedAvg doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalWeightedAvg reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         CompensatedSum sumCompensation = new CompensatedSum(0, 0);
         CompensatedSum weightCompensation = new CompensatedSum(0, 0);
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalBucketMetricValue.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalBucketMetricValue.java
index 1acdb54080693..84b4c3b305a41 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalBucketMetricValue.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalBucketMetricValue.java
@@ -85,7 +85,7 @@ DocValueFormat formatter() {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException("Not supported");
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalExtendedStatsBucket.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalExtendedStatsBucket.java
index b0b78eb012042..d1f60fe30e511 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalExtendedStatsBucket.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalExtendedStatsBucket.java
@@ -48,7 +48,7 @@ public String getWriteableName() {
     }
 
     @Override
-    public InternalExtendedStats doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalExtendedStats reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException("Not supported");
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalPercentilesBucket.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalPercentilesBucket.java
index 77493f66d643e..38eaae87c012f 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalPercentilesBucket.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalPercentilesBucket.java
@@ -119,7 +119,7 @@ public double value(String name) {
     }
 
     @Override
-    public InternalMax doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalMax reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException("Not supported");
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalSimpleValue.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalSimpleValue.java
index 4f7b51b6e3b38..29c25b117467f 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalSimpleValue.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalSimpleValue.java
@@ -76,7 +76,7 @@ DocValueFormat formatter() {
     }
 
     @Override
-    public InternalSimpleValue doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalSimpleValue reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException("Not supported");
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalStatsBucket.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalStatsBucket.java
index 51d3cfc060f73..c8beef459b8c8 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalStatsBucket.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/InternalStatsBucket.java
@@ -47,7 +47,7 @@ public String getWriteableName() {
     }
 
     @Override
-    public InternalStats doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalStats reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException("Not supported");
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/InternalAggregationsTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/InternalAggregationsTests.java
index cf6a9f6d838ee..7236b354ef92b 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/InternalAggregationsTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/InternalAggregationsTests.java
@@ -62,7 +62,7 @@ public void testNonFinalReduceTopLevelPipelineAggs()  {
         List<InternalAggregations> aggs = Collections.singletonList(new InternalAggregations(Collections.singletonList(terms),
             topLevelPipelineAggs));
         InternalAggregation.ReduceContext reduceContext = new InternalAggregation.ReduceContext(null, null, false);
-        InternalAggregations reducedAggs = InternalAggregations.reduce(aggs, reduceContext);
+        InternalAggregations reducedAggs = InternalAggregations.topLevelReduce(aggs, reduceContext);
         assertEquals(1, reducedAggs.getTopLevelPipelineAggregators().size());
         assertEquals(1, reducedAggs.aggregations.size());
     }
@@ -78,11 +78,11 @@ public void testFinalReduceTopLevelPipelineAggs()  {
         if (randomBoolean()) {
             InternalAggregations aggs = new InternalAggregations(Collections.singletonList(terms),
                 Collections.singletonList(siblingPipelineAggregator));
-            reducedAggs = InternalAggregations.reduce(Collections.singletonList(aggs), reduceContext);
+            reducedAggs = InternalAggregations.topLevelReduce(Collections.singletonList(aggs), reduceContext);
         } else {
             InternalAggregations aggs = new InternalAggregations(Collections.singletonList(terms),
                 Collections.singletonList(siblingPipelineAggregator));
-            reducedAggs = InternalAggregations.reduce(Collections.singletonList(aggs), reduceContext);
+            reducedAggs = InternalAggregations.topLevelReduce(Collections.singletonList(aggs), reduceContext);
         }
         assertEquals(0, reducedAggs.getTopLevelPipelineAggregators().size());
         assertEquals(2, reducedAggs.aggregations.size());
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/AutoDateHistogramAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/AutoDateHistogramAggregatorTests.java
index 9293b33e22f43..c6bb10fa6c947 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/AutoDateHistogramAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/AutoDateHistogramAggregatorTests.java
@@ -36,10 +36,15 @@
 import org.elasticsearch.common.time.DateFormatter;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.mapper.DateFieldMapper;
+import org.elasticsearch.index.mapper.MappedFieldType;
+import org.elasticsearch.index.mapper.NumberFieldMapper;
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.AggregatorTestCase;
 import org.elasticsearch.search.aggregations.MultiBucketConsumerService;
+import org.elasticsearch.search.aggregations.metrics.InternalMax;
 import org.elasticsearch.search.aggregations.metrics.InternalStats;
+import org.elasticsearch.search.aggregations.pipeline.DerivativePipelineAggregationBuilder;
+import org.elasticsearch.search.aggregations.pipeline.InternalSimpleValue;
 import org.elasticsearch.search.aggregations.support.AggregationInspectionHelper;
 import org.hamcrest.Matchers;
 import org.junit.Assert;
@@ -58,9 +63,12 @@
 import java.util.function.Consumer;
 import java.util.stream.Collectors;
 
+import static org.hamcrest.Matchers.equalTo;
+
 public class AutoDateHistogramAggregatorTests extends AggregatorTestCase {
     private static final String DATE_FIELD = "date";
     private static final String INSTANT_FIELD = "instant";
+    private static final String NUMERIC_FIELD = "numeric";
 
     private static final List<ZonedDateTime> DATES_WITH_TIME = Arrays.asList(
         ZonedDateTime.of(2010, 3, 12, 1, 7, 45, 0, ZoneOffset.UTC),
@@ -718,6 +726,35 @@ public void testIntervalSecond() throws IOException {
         );
     }
 
+    public void testWithPipelineReductions() throws IOException {
+        testSearchAndReduceCase(DEFAULT_QUERY, DATES_WITH_TIME,
+            aggregation -> aggregation.setNumBuckets(1).field(DATE_FIELD)
+                .subAggregation(AggregationBuilders.histogram("histo").field(NUMERIC_FIELD).interval(1)
+                    .subAggregation(AggregationBuilders.max("max").field(NUMERIC_FIELD))
+                    .subAggregation(new DerivativePipelineAggregationBuilder("deriv", "max"))),
+            histogram -> {
+                assertTrue(AggregationInspectionHelper.hasValue(histogram));
+                final List<? extends Histogram.Bucket> buckets = histogram.getBuckets();
+                assertEquals(1, buckets.size());
+
+                Histogram.Bucket bucket = buckets.get(0);
+                assertEquals("2010-01-01T00:00:00.000Z", bucket.getKeyAsString());
+                assertEquals(10, bucket.getDocCount());
+                assertThat(bucket.getAggregations().asList().size(), equalTo(1));
+                InternalHistogram histo = (InternalHistogram) bucket.getAggregations().asList().get(0);
+                assertThat(histo.getBuckets().size(), equalTo(10));
+                for (int i = 0; i < 10; i++) {
+                    assertThat(histo.getBuckets().get(i).key, equalTo((double)i));
+                    assertThat(((InternalMax)histo.getBuckets().get(i).aggregations.get("max")).getValue(), equalTo((double)i));
+                    if (i > 0) {
+                        assertThat(((InternalSimpleValue)histo.getBuckets().get(i).aggregations.get("deriv")).getValue(), equalTo(1.0));
+                    }
+                }
+
+
+            });
+    }
+
     private void testSearchCase(final Query query, final List<ZonedDateTime> dataset,
                                 final Consumer<AutoDateHistogramAggregationBuilder> configure,
                                 final Consumer<InternalAutoDateHistogram> verify) throws IOException {
@@ -757,6 +794,7 @@ private void executeTestCase(final boolean reduced, final Query query, final Lis
         try (Directory directory = newDirectory()) {
             try (RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory)) {
                 final Document document = new Document();
+                int i = 0;
                 for (final ZonedDateTime date : dataset) {
                     if (frequently()) {
                         indexWriter.commit();
@@ -765,8 +803,10 @@ private void executeTestCase(final boolean reduced, final Query query, final Lis
                     final long instant = date.toInstant().toEpochMilli();
                     document.add(new SortedNumericDocValuesField(DATE_FIELD, instant));
                     document.add(new LongPoint(INSTANT_FIELD, instant));
+                    document.add(new SortedNumericDocValuesField(NUMERIC_FIELD, i));
                     indexWriter.addDocument(document);
                     document.clear();
+                    i += 1;
                 }
             }
 
@@ -783,11 +823,19 @@ private void executeTestCase(final boolean reduced, final Query query, final Lis
                 fieldType.setHasDocValues(true);
                 fieldType.setName(aggregationBuilder.field());
 
+                MappedFieldType instantFieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.LONG);
+                instantFieldType.setName(INSTANT_FIELD);
+                instantFieldType.setHasDocValues(true);
+
+                MappedFieldType numericFieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.LONG);
+                numericFieldType.setName(NUMERIC_FIELD);
+                numericFieldType.setHasDocValues(true);
+
                 final InternalAutoDateHistogram histogram;
                 if (reduced) {
-                    histogram = searchAndReduce(indexSearcher, query, aggregationBuilder, fieldType);
+                    histogram = searchAndReduce(indexSearcher, query, aggregationBuilder, fieldType, instantFieldType, numericFieldType);
                 } else {
-                    histogram = search(indexSearcher, query, aggregationBuilder, fieldType);
+                    histogram = search(indexSearcher, query, aggregationBuilder, fieldType, instantFieldType, numericFieldType);
                 }
                 verify.accept(histogram);
             }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalAutoDateHistogramTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalAutoDateHistogramTests.java
index fa4bce9a4e959..4ada5e349de1f 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalAutoDateHistogramTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalAutoDateHistogramTests.java
@@ -108,7 +108,6 @@ public void testGetAppropriateRoundingUsesCorrectIntervals() {
         assertThat(result, equalTo(2));
     }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/39497")
     public void testReduceRandom() {
         super.testReduceRandom();
     }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalHistogramTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalHistogramTests.java
index fb9f6dd29c73f..5b8264b9e71ea 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalHistogramTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalHistogramTests.java
@@ -109,7 +109,7 @@ public void testHandlesNaN() {
         newBuckets.add(new InternalHistogram.Bucket(Double.NaN, b.docCount, keyed, b.format, b.aggregations));
         
         InternalHistogram newHistogram = histogram.create(newBuckets);
-        newHistogram.doReduce(Arrays.asList(newHistogram, histogram2), new InternalAggregation.ReduceContext(null, null, false));
+        newHistogram.reduce(Arrays.asList(newHistogram, histogram2), new InternalAggregation.ReduceContext(null, null, false));
     }
 
     @Override
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificanceHeuristicTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificanceHeuristicTests.java
index 49de4eb821115..6afc5e94e3029 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificanceHeuristicTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificanceHeuristicTests.java
@@ -126,12 +126,12 @@ public void testStreamResponse() throws Exception {
     InternalMappedSignificantTerms<?, ?> getRandomSignificantTerms(SignificanceHeuristic heuristic) {
         if (randomBoolean()) {
             SignificantLongTerms.Bucket bucket = new SignificantLongTerms.Bucket(1, 2, 3, 4, 123, InternalAggregations.EMPTY,
-                    DocValueFormat.RAW);
+                    DocValueFormat.RAW, randomDoubleBetween(0, 100, true));
             return new SignificantLongTerms("some_name", 1, 1, emptyList(), null, DocValueFormat.RAW, 10, 20, heuristic,
                     singletonList(bucket));
         } else {
             SignificantStringTerms.Bucket bucket = new SignificantStringTerms.Bucket(new BytesRef("someterm"), 1, 2, 3, 4,
-                    InternalAggregations.EMPTY, DocValueFormat.RAW);
+                    InternalAggregations.EMPTY, DocValueFormat.RAW, randomDoubleBetween(0, 100, true));
             return new SignificantStringTerms("some_name", 1, 1, emptyList(), null, DocValueFormat.RAW, 10, 20, heuristic,
                     singletonList(bucket));
         }
@@ -149,7 +149,7 @@ public static SignificanceHeuristic getRandomSignificanceheuristic() {
     public void testReduce() {
         List<InternalAggregation> aggs = createInternalAggregations();
         InternalAggregation.ReduceContext context = new InternalAggregation.ReduceContext(null, null, true);
-        SignificantTerms reducedAgg = (SignificantTerms) aggs.get(0).doReduce(aggs, context);
+        SignificantTerms reducedAgg = (SignificantTerms) aggs.get(0).reduce(aggs, context);
         assertThat(reducedAgg.getBuckets().size(), equalTo(2));
         assertThat(reducedAgg.getBuckets().get(0).getSubsetDf(), equalTo(8L));
         assertThat(reducedAgg.getBuckets().get(0).getSubsetSize(), equalTo(16L));
@@ -196,7 +196,7 @@ SignificantStringTerms createAggregation(SignificanceHeuristic significanceHeuri
         @Override
         SignificantStringTerms.Bucket createBucket(long subsetDF, long subsetSize, long supersetDF, long supersetSize, long label) {
             return new SignificantStringTerms.Bucket(new BytesRef(Long.toString(label).getBytes(StandardCharsets.UTF_8)), subsetDF,
-                    subsetSize, supersetDF, supersetSize, InternalAggregations.EMPTY, DocValueFormat.RAW);
+                    subsetSize, supersetDF, supersetSize, InternalAggregations.EMPTY, DocValueFormat.RAW, 0);
         }
     }
     private class LongTestAggFactory extends TestAggFactory<SignificantLongTerms, SignificantLongTerms.Bucket> {
@@ -210,7 +210,7 @@ SignificantLongTerms createAggregation(SignificanceHeuristic significanceHeurist
         @Override
         SignificantLongTerms.Bucket createBucket(long subsetDF, long subsetSize, long supersetDF, long supersetSize, long label) {
             return new SignificantLongTerms.Bucket(subsetDF, subsetSize, supersetDF, supersetSize, label, InternalAggregations.EMPTY,
-                    DocValueFormat.RAW);
+                    DocValueFormat.RAW, 0);
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTermsTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTermsTests.java
index 755cb6e85292d..3a9684d305114 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTermsTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantLongTermsTests.java
@@ -58,7 +58,7 @@ protected InternalSignificantTerms createTestInstance(String name,
         for (int i = 0; i < numBuckets; ++i) {
             long term = randomValueOtherThanMany(l -> terms.add(l) == false, random()::nextLong);
             SignificantLongTerms.Bucket bucket = new SignificantLongTerms.Bucket(subsetDfs[i], subsetSize, 
-                    supersetDfs[i], supersetSize, term, aggs, format);
+                    supersetDfs[i], supersetSize, term, aggs, format, 0);
             bucket.updateScore(significanceHeuristic);
             buckets.add(bucket);
         }
@@ -109,7 +109,7 @@ protected Class<? extends ParsedMultiBucketAggregation> implementationClass() {
             case 5:
                 buckets = new ArrayList<>(buckets);
                 buckets.add(new SignificantLongTerms.Bucket(randomLong(), randomNonNegativeLong(), randomNonNegativeLong(),
-                        randomNonNegativeLong(), randomNonNegativeLong(), InternalAggregations.EMPTY, format));
+                        randomNonNegativeLong(), randomNonNegativeLong(), InternalAggregations.EMPTY, format, 0));
                 break;
             case 8:
                 if (metaData == null) {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTermsTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTermsTests.java
index 2255373fd346d..d230b681cbe68 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTermsTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantStringTermsTests.java
@@ -51,7 +51,7 @@ protected InternalSignificantTerms createTestInstance(String name,
         for (int i = 0; i < numBuckets; ++i) {
             BytesRef term = randomValueOtherThanMany(b -> terms.add(b) == false, () -> new BytesRef(randomAlphaOfLength(10)));
             SignificantStringTerms.Bucket bucket = new SignificantStringTerms.Bucket(term, subsetDfs[i], subsetSize, 
-                    supersetDfs[i], supersetSize, aggs, format);
+                    supersetDfs[i], supersetSize, aggs, format, 0);
             bucket.updateScore(significanceHeuristic);
             buckets.add(bucket);
         }
@@ -103,7 +103,7 @@ protected Class<? extends ParsedMultiBucketAggregation> implementationClass() {
                 buckets = new ArrayList<>(buckets);
                 buckets.add(new SignificantStringTerms.Bucket(new BytesRef(randomAlphaOfLengthBetween(1, 10)),
                         randomNonNegativeLong(), randomNonNegativeLong(), randomNonNegativeLong(), randomNonNegativeLong(),
-                        InternalAggregations.EMPTY, format));
+                        InternalAggregations.EMPTY, format, 0));
                 break;
             case 8:
                 if (metaData == null) {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregatorTests.java
index 727c3ea3a87ae..611e7d916c9c9 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregatorTests.java
@@ -1073,7 +1073,7 @@ public void testMixLongAndDouble() throws Exception {
                 new InternalAggregation.ReduceContext(new MockBigArrays(new MockPageCacheRecycler(Settings.EMPTY),
                     new NoneCircuitBreakerService()), null, true);
             for (InternalAggregation internalAgg : aggs) {
-                InternalAggregation mergedAggs = internalAgg.doReduce(aggs, ctx);
+                InternalAggregation mergedAggs = internalAgg.reduce(aggs, ctx);
                 assertTrue(mergedAggs instanceof DoubleTerms);
                 long expected = numLongs + numDoubles;
                 List<? extends Terms.Bucket> buckets = ((DoubleTerms) mergedAggs).getBuckets();
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalAvgTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalAvgTests.java
index 10ae10a9af1c0..5582af4ced64f 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalAvgTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalAvgTests.java
@@ -23,8 +23,6 @@
 import org.elasticsearch.search.DocValueFormat;
 import org.elasticsearch.search.aggregations.InternalAggregation;
 import org.elasticsearch.search.aggregations.ParsedAggregation;
-import org.elasticsearch.search.aggregations.metrics.InternalAvg;
-import org.elasticsearch.search.aggregations.metrics.ParsedAvg;
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
 import org.elasticsearch.test.InternalAggregationTestCase;
 
@@ -95,7 +93,7 @@ private void verifyAvgOfDoubles(double[] values, double expected, double delta)
             aggregations.add(new InternalAvg("dummy1", value, 1, null, null, null));
         }
         InternalAvg internalAvg = new InternalAvg("dummy2", 0, 0, null, null, null);
-        InternalAvg reduced = internalAvg.doReduce(aggregations, null);
+        InternalAvg reduced = internalAvg.reduce(aggregations, null);
         assertEquals(expected, reduced.getValue(), delta);
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalExtendedStatsTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalExtendedStatsTests.java
index 3c5201bfa8aa9..2f53902bb537a 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalExtendedStatsTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalExtendedStatsTests.java
@@ -225,7 +225,7 @@ private void verifySumOfSqrsOfDoubles(double[] values, double expectedSumOfSqrs,
             aggregations.add(new InternalExtendedStats("dummy1", 1, 0.0, 0.0, 0.0, sumOfSqrs, sigma, null, null, null));
         }
         InternalExtendedStats stats = new InternalExtendedStats("dummy", 1, 0.0, 0.0, 0.0, 0.0, sigma, null, null, null);
-        InternalExtendedStats reduced = stats.doReduce(aggregations, null);
+        InternalExtendedStats reduced = stats.reduce(aggregations, null);
         assertEquals(expectedSumOfSqrs, reduced.getSumOfSquares(), delta);
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalStatsTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalStatsTests.java
index 8198d6c2e81a3..e4a56c0c5b84a 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalStatsTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalStatsTests.java
@@ -114,7 +114,7 @@ private void verifyStatsOfDoubles(double[] values, double expectedSum, double ex
             aggregations.add(new InternalStats("dummy1", 1, value, value, value, null, null, null));
         }
         InternalStats internalStats = new InternalStats("dummy2", 0, 0.0, 2.0, 0.0, null, null, null);
-        InternalStats reduced = internalStats.doReduce(aggregations, null);
+        InternalStats reduced = internalStats.reduce(aggregations, null);
         assertEquals("dummy2", reduced.getName());
         assertEquals(values.length, reduced.getCount());
         assertEquals(expectedSum, reduced.getSum(), delta);
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalSumTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalSumTests.java
index 4f44be7d50833..0fca0d43bd6f1 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalSumTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalSumTests.java
@@ -87,7 +87,7 @@ private void verifySummationOfDoubles(double[] values, double expected, double d
             aggregations.add(new InternalSum("dummy1", value, null, null, null));
         }
         InternalSum internalSum = new InternalSum("dummy", 0, null, null, null);
-        InternalSum reduced = internalSum.doReduce(aggregations, null);
+        InternalSum reduced = internalSum.reduce(aggregations, null);
         assertEquals(expected, reduced.value(), delta);
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/AvgBucketAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/AvgBucketAggregatorTests.java
index afea0f13bd7db..b8e9f1444dd6a 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/AvgBucketAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/AvgBucketAggregatorTests.java
@@ -77,7 +77,7 @@ public class AvgBucketAggregatorTests extends AggregatorTestCase {
      * it is fixed.
      *
      * Note: we have this test inside of the `avg_bucket` package so that we can get access to the package-private
-     * `doReduce()` needed for testing this
+     * `reduce()` needed for testing this
      */
     public void testSameAggNames() throws IOException {
         Query query = new MatchAllDocsQuery();
diff --git a/test/framework/src/main/java/org/elasticsearch/search/aggregations/AggregatorTestCase.java b/test/framework/src/main/java/org/elasticsearch/search/aggregations/AggregatorTestCase.java
index 199f9b055393c..221030cd8d157 100644
--- a/test/framework/src/main/java/org/elasticsearch/search/aggregations/AggregatorTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/search/aggregations/AggregatorTestCase.java
@@ -387,7 +387,7 @@ protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduc
                 InternalAggregation.ReduceContext context =
                     new InternalAggregation.ReduceContext(root.context().bigArrays(), getMockScriptService(),
                         reduceBucketConsumer, false);
-                A reduced = (A) aggs.get(0).doReduce(toReduce, context);
+                A reduced = (A) aggs.get(0).reduce(toReduce, context);
                 doAssertReducedMultiBucketConsumer(reduced, reduceBucketConsumer);
                 aggs = new ArrayList<>(aggs.subList(r, toReduceSize));
                 aggs.add(reduced);
@@ -398,7 +398,12 @@ protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduc
                 new InternalAggregation.ReduceContext(root.context().bigArrays(), getMockScriptService(), reduceBucketConsumer, true);
 
             @SuppressWarnings("unchecked")
-            A internalAgg = (A) aggs.get(0).doReduce(aggs, context);
+            A internalAgg = (A) aggs.get(0).reduce(aggs, context);
+
+            // materialize any parent pipelines
+            internalAgg = (A) internalAgg.reducePipelines(internalAgg, context);
+
+            // materialize any sibling pipelines at top level
             if (internalAgg.pipelineAggregators().size() > 0) {
                 for (PipelineAggregator pipelineAggregator : internalAgg.pipelineAggregators()) {
                     internalAgg = (A) pipelineAggregator.reduce(internalAgg, context);
diff --git a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/cumulativecardinality/InternalSimpleLongValue.java b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/cumulativecardinality/InternalSimpleLongValue.java
index e8db75edad5d9..a6b8aad699824 100644
--- a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/cumulativecardinality/InternalSimpleLongValue.java
+++ b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/cumulativecardinality/InternalSimpleLongValue.java
@@ -64,7 +64,7 @@ DocValueFormat formatter() {
     }
 
     @Override
-    public InternalSimpleLongValue doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalSimpleLongValue reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException("Not supported");
     }
 
diff --git a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/stringstats/InternalStringStats.java b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/stringstats/InternalStringStats.java
index 88cb505615cf7..007fbcea9024a 100644
--- a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/stringstats/InternalStringStats.java
+++ b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/stringstats/InternalStringStats.java
@@ -182,7 +182,7 @@ public Object value(String name) {
     }
 
     @Override
-    public InternalStringStats doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalStringStats reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         long count = 0;
         long totalLength = 0;
         int minLength = Integer.MAX_VALUE;
diff --git a/x-pack/plugin/rollup/src/test/java/org/elasticsearch/xpack/rollup/RollupResponseTranslationTests.java b/x-pack/plugin/rollup/src/test/java/org/elasticsearch/xpack/rollup/RollupResponseTranslationTests.java
index 25fe2f51b2f22..91953295bd523 100644
--- a/x-pack/plugin/rollup/src/test/java/org/elasticsearch/xpack/rollup/RollupResponseTranslationTests.java
+++ b/x-pack/plugin/rollup/src/test/java/org/elasticsearch/xpack/rollup/RollupResponseTranslationTests.java
@@ -610,7 +610,7 @@ public void testDateHistoWithGap() throws IOException {
         ScriptService scriptService = mock(ScriptService.class);
         InternalAggregation.ReduceContext context = new InternalAggregation.ReduceContext(bigArrays, scriptService, true);
 
-        InternalAggregation reduced = ((InternalDateHistogram)unrolled).doReduce(Collections.singletonList(unrolled), context);
+        InternalAggregation reduced = ((InternalDateHistogram)unrolled).reduce(Collections.singletonList(unrolled), context);
         assertThat(reduced.toString(), equalTo("{\"histo\":{\"buckets\":[{\"key_as_string\":\"1970-01-01T00:00:00.100Z\",\"key\":100," +
                 "\"doc_count\":1},{\"key_as_string\":\"1970-01-01T00:00:00.200Z\",\"key\":200,\"doc_count\":1}," +
                 "{\"key_as_string\":\"1970-01-01T00:00:00.300Z\",\"key\":300,\"doc_count\":0,\"histo._count\":{\"value\":0.0}}," +
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TestMultiValueAggregation.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TestMultiValueAggregation.java
index 7a24a5515b527..8061ce31ef832 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TestMultiValueAggregation.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TestMultiValueAggregation.java
@@ -42,7 +42,7 @@ protected void doWriteTo(StreamOutput out) throws IOException {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException();
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TestSingleValueAggregation.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TestSingleValueAggregation.java
index 08f4edda3cbf6..56183414aa0ac 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TestSingleValueAggregation.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TestSingleValueAggregation.java
@@ -37,7 +37,7 @@ protected void doWriteTo(StreamOutput out) throws IOException {
     }
 
     @Override
-    public InternalAggregation doReduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
+    public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         throw new UnsupportedOperationException();
     }
 

From 65114f7b6e6c335a3504cc6163e3e538534ff43c Mon Sep 17 00:00:00 2001
From: Orhan Toy <toyorhan@gmail.com>
Date: Thu, 5 Dec 2019 22:33:36 +0100
Subject: [PATCH 085/686] Consistent case in CLI option descriptions (#49635)

This commit improves the casing of messages in the CLI help descriptions.
---
 libs/cli/src/main/java/org/elasticsearch/cli/Command.java   | 6 +++---
 .../java/org/elasticsearch/bootstrap/Elasticsearch.java     | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/libs/cli/src/main/java/org/elasticsearch/cli/Command.java b/libs/cli/src/main/java/org/elasticsearch/cli/Command.java
index 2a270153f474c..9ce77604a5014 100644
--- a/libs/cli/src/main/java/org/elasticsearch/cli/Command.java
+++ b/libs/cli/src/main/java/org/elasticsearch/cli/Command.java
@@ -43,10 +43,10 @@ public abstract class Command implements Closeable {
     /** The option parser for this command. */
     protected final OptionParser parser = new OptionParser();
 
-    private final OptionSpec<Void> helpOption = parser.acceptsAll(Arrays.asList("h", "help"), "show help").forHelp();
-    private final OptionSpec<Void> silentOption = parser.acceptsAll(Arrays.asList("s", "silent"), "show minimal output");
+    private final OptionSpec<Void> helpOption = parser.acceptsAll(Arrays.asList("h", "help"), "Show help").forHelp();
+    private final OptionSpec<Void> silentOption = parser.acceptsAll(Arrays.asList("s", "silent"), "Show minimal output");
     private final OptionSpec<Void> verboseOption =
-        parser.acceptsAll(Arrays.asList("v", "verbose"), "show verbose output").availableUnless(silentOption);
+        parser.acceptsAll(Arrays.asList("v", "verbose"), "Show verbose output").availableUnless(silentOption);
 
     /**
      * Construct the command with the specified command description and runnable to execute before main is invoked.
diff --git a/server/src/main/java/org/elasticsearch/bootstrap/Elasticsearch.java b/server/src/main/java/org/elasticsearch/bootstrap/Elasticsearch.java
index 3513a967763f5..83cdf533e03a7 100644
--- a/server/src/main/java/org/elasticsearch/bootstrap/Elasticsearch.java
+++ b/server/src/main/java/org/elasticsearch/bootstrap/Elasticsearch.java
@@ -52,9 +52,9 @@ class Elasticsearch extends EnvironmentAwareCommand {
 
     // visible for testing
     Elasticsearch() {
-        super("starts elasticsearch", () -> {}); // we configure logging later so we override the base class from configuring logging
+        super("Starts Elasticsearch", () -> {}); // we configure logging later so we override the base class from configuring logging
         versionOption = parser.acceptsAll(Arrays.asList("V", "version"),
-            "Prints elasticsearch version information and exits");
+            "Prints Elasticsearch version information and exits");
         daemonizeOption = parser.acceptsAll(Arrays.asList("d", "daemonize"),
             "Starts Elasticsearch in the background")
             .availableUnless(versionOption);

From 47435981f56aa32b813d0d9cf2714458e309a792 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Thu, 5 Dec 2019 16:31:07 -0800
Subject: [PATCH 086/686] Move BuildParams class to 'minimumRuntime' source set
  (#49890)

Move BuildParams class to 'minimumRuntime' source set to retain compatibility
with build-tools for builds using a Java 8 runtime.

Closes #49766
---
 .../java/org/elasticsearch/gradle/info/BuildParams.java       | 4 +++-
 .../java/org/elasticsearch/gradle/info/JavaHome.java          | 0
 2 files changed, 3 insertions(+), 1 deletion(-)
 rename buildSrc/src/{main => minimumRuntime}/java/org/elasticsearch/gradle/info/BuildParams.java (97%)
 rename buildSrc/src/{main => minimumRuntime}/java/org/elasticsearch/gradle/info/JavaHome.java (100%)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/info/BuildParams.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
similarity index 97%
rename from buildSrc/src/main/java/org/elasticsearch/gradle/info/BuildParams.java
rename to buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
index 6400e4975ad51..9fba20c7db77c 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/info/BuildParams.java
+++ b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
@@ -84,7 +84,6 @@ public static JavaVersion getRuntimeJavaVersion() {
         return value(runtimeJavaVersion);
     }
 
-    @ExecutionTime
     public static Boolean isInFipsJvm() {
         return value(inFipsJvm);
     }
@@ -155,6 +154,9 @@ public void reset() {
                 .filter(f -> Modifier.isStatic(f.getModifiers()))
                 .forEach(f -> {
                     try {
+                        // Since we are mutating private static fields from a public static inner class we need to suppress
+                        // accessibility controls here.
+                        f.setAccessible(true);
                         f.set(null, null);
                     } catch (IllegalAccessException e) {
                         throw new RuntimeException(e);
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/info/JavaHome.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/JavaHome.java
similarity index 100%
rename from buildSrc/src/main/java/org/elasticsearch/gradle/info/JavaHome.java
rename to buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/JavaHome.java

From 38f7d8b3b58b73ea36ded800f1c4888b04be1d4d Mon Sep 17 00:00:00 2001
From: Jack Conradson <osjdconrad@gmail.com>
Date: Thu, 5 Dec 2019 16:57:45 -0800
Subject: [PATCH 087/686] Add nodes to handle types (#49785)

This PR adds 3 nodes to handle types defined by a front-end creating a
Painless AST. These types are decided with data immutability in mind -
hence the reason for more than a single node.
---
 .../elasticsearch/painless/antlr/Walker.java  |   4 +-
 .../painless/node/DResolvedType.java          |  81 ++++++++++++++
 .../elasticsearch/painless/node/DType.java    |  46 ++++++++
 .../painless/node/DUnresolvedType.java        |  61 +++++++++++
 .../painless/node/SDeclaration.java           |  14 +--
 .../painless/node/NodeToStringTests.java      | 101 +++++++++---------
 6 files changed, 247 insertions(+), 60 deletions(-)
 create mode 100644 modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DResolvedType.java
 create mode 100644 modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DType.java
 create mode 100644 modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DUnresolvedType.java

diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/antlr/Walker.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/antlr/Walker.java
index 84f44c832d365..53c98f7589ef3 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/antlr/Walker.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/antlr/Walker.java
@@ -109,6 +109,7 @@
 import org.elasticsearch.painless.node.AExpression;
 import org.elasticsearch.painless.node.ANode;
 import org.elasticsearch.painless.node.AStatement;
+import org.elasticsearch.painless.node.DUnresolvedType;
 import org.elasticsearch.painless.node.EAssignment;
 import org.elasticsearch.painless.node.EBinary;
 import org.elasticsearch.painless.node.EBool;
@@ -478,8 +479,9 @@ public ANode visitDeclaration(DeclarationContext ctx) {
         for (DeclvarContext declvar : ctx.declvar()) {
             String name = declvar.ID().getText();
             AExpression expression = declvar.expression() == null ? null : (AExpression)visit(declvar.expression());
+            DUnresolvedType unresolvedType = new DUnresolvedType(location(declvar), type);
 
-            declarations.add(new SDeclaration(location(declvar), type, name, expression));
+            declarations.add(new SDeclaration(location(declvar), unresolvedType, name, expression));
         }
 
         return new SDeclBlock(location(ctx), declarations);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DResolvedType.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DResolvedType.java
new file mode 100644
index 0000000000000..223b39068673d
--- /dev/null
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DResolvedType.java
@@ -0,0 +1,81 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.painless.node;
+
+import org.elasticsearch.painless.Location;
+import org.elasticsearch.painless.lookup.PainlessLookup;
+import org.elasticsearch.painless.lookup.PainlessLookupUtility;
+
+import java.util.Objects;
+
+/**
+ * Represents a Painless type as a {@link Class}. This may still
+ * require resolution to ensure the type in the {@link PainlessLookup}.
+ */
+public class DResolvedType extends DType {
+
+    protected final Class<?> type;
+
+    /**
+     * If set to {@code true} ensures the type is in the {@link PainlessLookup}.
+     * If set to {@code false} assumes the type is valid.
+     */
+    protected final boolean checkInLookup;
+
+    public DResolvedType(Location location, Class<?> type) {
+        this(location, type, true);
+    }
+
+    public DResolvedType(Location location, Class<?> type, boolean checkInLookup) {
+        super(location);
+        this.type = Objects.requireNonNull(type);
+        this.checkInLookup = checkInLookup;
+    }
+
+    /**
+     * If {@link #checkInLookup} is {@code true} checks if the type is in the
+     * {@link PainlessLookup}, otherwise returns {@code this}.
+     * @throws IllegalArgumentException if both checking the type is in the {@link PainlessLookup}
+     * and the type cannot be resolved from the {@link PainlessLookup}
+     * @return a {@link DResolvedType} where the resolved Painless type is retrievable
+     */
+    @Override
+    public DResolvedType resolveType(PainlessLookup painlessLookup) {
+        if (checkInLookup == false) {
+            return this;
+        }
+
+        if (painlessLookup.getClasses().contains(type) == false) {
+            throw location.createError(new IllegalArgumentException(
+                    "cannot resolve type [" + PainlessLookupUtility.typeToCanonicalTypeName(type) + "]"));
+        }
+
+        return new DResolvedType(location, type, false);
+    }
+
+    public Class<?> getType() {
+        return type;
+    }
+
+    @Override
+    public String toString() {
+        return " (DResolvedType [" + PainlessLookupUtility.typeToCanonicalTypeName(type) + "])";
+    }
+}
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DType.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DType.java
new file mode 100644
index 0000000000000..5470739170651
--- /dev/null
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DType.java
@@ -0,0 +1,46 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.painless.node;
+
+import org.elasticsearch.painless.Location;
+import org.elasticsearch.painless.lookup.PainlessLookup;
+
+import java.util.Objects;
+
+/**
+ * Represents an abstract Painless type. {@link DType} nodes must be
+ * resolved using {@link #resolveType(PainlessLookup)} to retrieve the
+ * actual Painless type. {@link DType} exists as a base class so consumers
+ * may have either a {@link DUnresolvedType} representing a Painless
+ * canonical type name or a {@link DResolvedType} representing a Painless
+ * type as the Painless AST is constructed. This allows Painless types already
+ * resolved at the time of Painless AST construction to not be forced to
+ * convert back to a Painless canonical type name and then re-resolved.
+ */
+public abstract class DType {
+
+    protected final Location location;
+
+    public DType(Location location) {
+        this.location = Objects.requireNonNull(location);
+    }
+
+    public abstract DResolvedType resolveType(PainlessLookup painlessLookup);
+}
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DUnresolvedType.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DUnresolvedType.java
new file mode 100644
index 0000000000000..8e21507fdaa05
--- /dev/null
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DUnresolvedType.java
@@ -0,0 +1,61 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.painless.node;
+
+import org.elasticsearch.painless.Location;
+import org.elasticsearch.painless.lookup.PainlessLookup;
+
+import java.util.Objects;
+
+/**
+ * Represents a canonical Painless type name as a {@link String}
+ * that requires resolution.
+ */
+public class DUnresolvedType extends DType {
+
+    protected final String typeName;
+
+    public DUnresolvedType(Location location, String typeName) {
+        super(location);
+        this.typeName = Objects.requireNonNull(typeName);
+    }
+
+    /**
+     * Resolves the canonical Painless type name to a Painless type.
+     * @throws IllegalArgumentException if the type cannot be resolved from the {@link PainlessLookup}
+     * @return a {@link DResolvedType} where the resolved Painless type is retrievable
+     */
+    @Override
+    public DResolvedType resolveType(PainlessLookup painlessLookup) {
+        Class<?> type = painlessLookup.canonicalTypeNameToType(typeName);
+
+        if (type == null) {
+            throw location.createError(new IllegalArgumentException("cannot resolve type [" + typeName + "]"));
+        }
+
+        return new DResolvedType(location, type);
+    }
+
+    @Override
+    public String toString() {
+        return "(DUnresolvedType [" + typeName + "])";
+    }
+}
+ 
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
index de42c43db4ee7..e5d8f1e881174 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
@@ -36,13 +36,13 @@
  */
 public final class SDeclaration extends AStatement {
 
-    private final String type;
+    private final DType type;
     private final String name;
     private AExpression expression;
 
     private Variable variable = null;
 
-    public SDeclaration(Location location, String type, String name, AExpression expression) {
+    public SDeclaration(Location location, DType type, String name, AExpression expression) {
         super(location);
 
         this.type = Objects.requireNonNull(type);
@@ -61,19 +61,15 @@ void extractVariables(Set<String> variables) {
 
     @Override
     void analyze(ScriptRoot scriptRoot, Locals locals) {
-        Class<?> clazz = scriptRoot.getPainlessLookup().canonicalTypeNameToType(this.type);
-
-        if (clazz == null) {
-            throw createError(new IllegalArgumentException("Not a type [" + this.type + "]."));
-        }
+        DResolvedType resolvedType = type.resolveType(scriptRoot.getPainlessLookup());
 
         if (expression != null) {
-            expression.expected = clazz;
+            expression.expected = resolvedType.getType();
             expression.analyze(scriptRoot, locals);
             expression = expression.cast(scriptRoot, locals);
         }
 
-        variable = locals.addVariable(location, clazz, name, false);
+        variable = locals.addVariable(location, resolvedType.getType(), name, false);
     }
 
     @Override
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/node/NodeToStringTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/node/NodeToStringTests.java
index d2832dfdfd5ec..562b6e1e5e90c 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/node/NodeToStringTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/node/NodeToStringTests.java
@@ -54,7 +54,7 @@ public class NodeToStringTests extends ESTestCase {
     public void testEAssignment() {
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration def i))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) i))\n"
               + "  (SExpression (EAssignment (EVariable i) = (ENumeric 2)))\n"
               + "  (SReturn (EVariable i)))",
                 "def i;\n"
@@ -63,7 +63,7 @@ public void testEAssignment() {
         for (String operator : new String[] {"+", "-", "*", "/", "%", "&", "^", "|", "<<", ">>", ">>>"}) {
             assertToString(
                     "(SClass\n"
-                  + "  (SDeclBlock (SDeclaration def i (ENumeric 1)))\n"
+                  + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) i (ENumeric 1)))\n"
                   + "  (SExpression (EAssignment (EVariable i) " + operator + "= (ENumeric 2)))\n"
                   + "  (SReturn (EVariable i)))",
                     "def i = 1;\n"
@@ -73,31 +73,31 @@ public void testEAssignment() {
         // Compound
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration def i))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) i))\n"
               + "  (SReturn (EAssignment (EVariable i) = (ENumeric 2))))",
                 "def i;\n"
               + "return i = 2");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration def i))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) i))\n"
               + "  (SReturn (EAssignment (EVariable i) ++ post)))",
                 "def i;\n"
               + "return i++");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration def i))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) i))\n"
               + "  (SReturn (EAssignment (EVariable i) ++ pre)))",
                 "def i;\n"
               + "return ++i");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration def i))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) i))\n"
               + "  (SReturn (EAssignment (EVariable i) -- post)))",
                 "def i;\n"
               + "return i--");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration def i))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) i))\n"
               + "  (SReturn (EAssignment (EVariable i) -- pre)))",
                 "def i;\n"
               + "return --i");
@@ -153,7 +153,8 @@ public void testECallLocal() {
     public void testECapturingFunctionRef() {
         assertToString(
                   "(SClass\n"
-                + "  (SDeclBlock (SDeclaration Integer x (PCallInvoke (EStatic Integer) valueOf (Args (ENumeric 5)))))\n"
+                + "  (SDeclBlock (SDeclaration (DUnresolvedType [Integer]) x "
+                + "(PCallInvoke (EStatic Integer) valueOf (Args (ENumeric 5)))))\n"
                 + "  (SReturn (PCallInvoke (PCallInvoke (EStatic Optional) empty) orElseGet (Args (ECapturingFunctionRef x toString)))))",
                   "Integer x = Integer.valueOf(5);\n"
                 + "return Optional.empty().orElseGet(x::toString)");
@@ -349,7 +350,7 @@ public void testEVariable() {
         assertToString("(SClass (SReturn (EVariable params)))", "return params");
         assertToString(
                   "(SClass\n"
-                + "  (SDeclBlock (SDeclaration def a (ENumeric 1)))\n"
+                + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) a (ENumeric 1)))\n"
                 + "  (SReturn (EVariable a)))",
                   "def a = 1;\n"
                 + "return a");
@@ -373,13 +374,13 @@ public void testPField() {
         assertToString("(SClass (SReturn (PField nullSafe (EVariable params) a)))", "return params?.a");
         assertToString(
                   "(SClass\n"
-                + "  (SDeclBlock (SDeclaration int[] a (ENewArray int[] dims (Args (ENumeric 10)))))\n"
+                + "  (SDeclBlock (SDeclaration (DUnresolvedType [int[]]) a (ENewArray int[] dims (Args (ENumeric 10)))))\n"
                 + "  (SReturn (PField (EVariable a) length)))",
                   "int[] a = new int[10];\n"
                 + "return a.length");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration org.elasticsearch.painless.FeatureTestObject a"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [org.elasticsearch.painless.FeatureTestObject]) a"
               + " (ENewObj org.elasticsearch.painless.FeatureTestObject)))\n"
               + "  (SExpression (EAssignment (PField (EVariable a) x) = (ENumeric 10)))\n"
               + "  (SReturn (PField (EVariable a) x)))",
@@ -511,13 +512,13 @@ public void testPSubShortcut() {
     public void testSBreak() {
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration int itr (ENumeric 2)))\n"
-              + "  (SDeclBlock (SDeclaration int a (ENumeric 1)))\n"
-              + "  (SDeclBlock (SDeclaration int b (ENumeric 1)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) itr (ENumeric 2)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) a (ENumeric 1)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) b (ENumeric 1)))\n"
               + "  (SDo (EComp (EVariable b) < (ENumeric 1000)) (SBlock\n"
               + "    (SExpression (EAssignment (EVariable itr) ++ post))\n"
               + "    (SIf (EComp (EVariable itr) > (ENumeric 10000)) (SBlock (SBreak)))\n"
-              + "    (SDeclBlock (SDeclaration int tmp (EVariable a)))\n"
+              + "    (SDeclBlock (SDeclaration (DUnresolvedType [int]) tmp (EVariable a)))\n"
               + "    (SExpression (EAssignment (EVariable a) = (EVariable b)))\n"
               + "    (SExpression (EAssignment (EVariable b) = (EBinary (EVariable tmp) + (EVariable b))))))\n"
               + "  (SReturn (EVariable b)))",
@@ -539,13 +540,13 @@ public void testSBreak() {
     public void testSContinue() {
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration int itr (ENumeric 2)))\n"
-              + "  (SDeclBlock (SDeclaration int a (ENumeric 1)))\n"
-              + "  (SDeclBlock (SDeclaration int b (ENumeric 1)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) itr (ENumeric 2)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) a (ENumeric 1)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) b (ENumeric 1)))\n"
               + "  (SDo (EComp (EVariable b) < (ENumeric 1000)) (SBlock\n"
               + "    (SExpression (EAssignment (EVariable itr) ++ post))\n"
               + "    (SIf (EComp (EVariable itr) < (ENumeric 10000)) (SBlock (SContinue)))\n"
-              + "    (SDeclBlock (SDeclaration int tmp (EVariable a)))\n"
+              + "    (SDeclBlock (SDeclaration (DUnresolvedType [int]) tmp (EVariable a)))\n"
               + "    (SExpression (EAssignment (EVariable a) = (EVariable b)))\n"
               + "    (SExpression (EAssignment (EVariable b) = (EBinary (EVariable tmp) + (EVariable b))))))\n"
               + "  (SReturn (EVariable b)))",
@@ -567,7 +568,7 @@ public void testSContinue() {
     public void testSDeclBlock() {
         assertToString(
                   "(SClass\n"
-                + "  (SDeclBlock (SDeclaration def a))\n"
+                + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) a))\n"
                 + "  (SExpression (EAssignment (EVariable a) = (ENumeric 10)))\n"
                 + "  (SReturn (EVariable a)))",
                   "def a;\n"
@@ -575,34 +576,34 @@ public void testSDeclBlock() {
                 + "return a");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration def a (ENumeric 10)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [def]) a (ENumeric 10)))\n"
               + "  (SReturn (EVariable a)))",
                 "def a = 10;\n"
               + "return a");
         assertToString(
                 "(SClass\n"
               + "  (SDeclBlock\n"
-              + "    (SDeclaration def a)\n"
-              + "    (SDeclaration def b)\n"
-              + "    (SDeclaration def c))\n"
+              + "    (SDeclaration (DUnresolvedType [def]) a)\n"
+              + "    (SDeclaration (DUnresolvedType [def]) b)\n"
+              + "    (SDeclaration (DUnresolvedType [def]) c))\n"
               + "  (SReturn (EVariable a)))",
                 "def a, b, c;\n"
               + "return a");
         assertToString(
                 "(SClass\n"
               + "  (SDeclBlock\n"
-              + "    (SDeclaration def a (ENumeric 10))\n"
-              + "    (SDeclaration def b (ENumeric 20))\n"
-              + "    (SDeclaration def c (ENumeric 100)))\n"
+              + "    (SDeclaration (DUnresolvedType [def]) a (ENumeric 10))\n"
+              + "    (SDeclaration (DUnresolvedType [def]) b (ENumeric 20))\n"
+              + "    (SDeclaration (DUnresolvedType [def]) c (ENumeric 100)))\n"
               + "  (SReturn (EVariable a)))",
                 "def a = 10, b = 20, c = 100;\n"
               + "return a");
         assertToString(
                 "(SClass\n"
               + "  (SDeclBlock\n"
-              + "    (SDeclaration def a (ENumeric 10))\n"
-              + "    (SDeclaration def b)\n"
-              + "    (SDeclaration def c (ENumeric 100)))\n"
+              + "    (SDeclaration (DUnresolvedType [def]) a (ENumeric 10))\n"
+              + "    (SDeclaration (DUnresolvedType [def]) b)\n"
+              + "    (SDeclaration (DUnresolvedType [def]) c (ENumeric 100)))\n"
               + "  (SReturn (EVariable a)))",
                 "def a = 10, b, c = 100;\n"
               + "return a");
@@ -610,9 +611,9 @@ public void testSDeclBlock() {
                 "(SClass\n"
               + "  (SIf (PField (EVariable params) a) (SBlock\n"
               + "    (SDeclBlock\n"
-              + "      (SDeclaration def a (ENumeric 10))\n"
-              + "      (SDeclaration def b)\n"
-              + "      (SDeclaration def c (ENumeric 100)))\n"
+              + "      (SDeclaration (DUnresolvedType [def]) a (ENumeric 10))\n"
+              + "      (SDeclaration (DUnresolvedType [def]) b)\n"
+              + "      (SDeclaration (DUnresolvedType [def]) c (ENumeric 100)))\n"
               + "    (SReturn (EVariable a))))\n"
               + "  (SReturn (EBoolean false)))",
                 "if (params.a) {"
@@ -625,12 +626,12 @@ public void testSDeclBlock() {
     public void testSDo() {
         assertToString(
                   "(SClass\n"
-                + "  (SDeclBlock (SDeclaration int itr (ENumeric 2)))\n"
-                + "  (SDeclBlock (SDeclaration int a (ENumeric 1)))\n"
-                + "  (SDeclBlock (SDeclaration int b (ENumeric 1)))\n"
+                + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) itr (ENumeric 2)))\n"
+                + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) a (ENumeric 1)))\n"
+                + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) b (ENumeric 1)))\n"
                 + "  (SDo (EComp (EVariable b) < (ENumeric 1000)) (SBlock\n"
                 + "    (SExpression (EAssignment (EVariable itr) ++ post))\n"
-                + "    (SDeclBlock (SDeclaration int tmp (EVariable a)))\n"
+                + "    (SDeclBlock (SDeclaration (DUnresolvedType [int]) tmp (EVariable a)))\n"
                 + "    (SExpression (EAssignment (EVariable a) = (EVariable b)))\n"
                 + "    (SExpression (EAssignment (EVariable b) = (EBinary (EVariable tmp) + (EVariable b))))))\n"
                 + "  (SReturn (EVariable b)))",
@@ -649,7 +650,7 @@ public void testSDo() {
     public void testSEach() {
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration int l (ENumeric 0)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) l (ENumeric 0)))\n"
               + "  (SEach String s (EListInit (EString 'cat') (EString 'dog') (EString 'chicken')) (SBlock "
                   + "(SExpression (EAssignment (EVariable l) += (PCallInvoke (EVariable s) length)))))\n"
               + "  (SReturn (EVariable l)))",
@@ -660,9 +661,9 @@ public void testSEach() {
                 + "return l");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration int l (ENumeric 0)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) l (ENumeric 0)))\n"
               + "  (SEach String s (EListInit (EString 'cat') (EString 'dog') (EString 'chicken')) (SBlock\n"
-              + "    (SDeclBlock (SDeclaration String s2 (EBinary (EString 'dire ') + (EVariable s))))\n"
+              + "    (SDeclBlock (SDeclaration (DUnresolvedType [String]) s2 (EBinary (EString 'dire ') + (EVariable s))))\n"
               + "    (SExpression (EAssignment (EVariable l) += (PCallInvoke (EVariable s2) length)))))\n"
               + "  (SReturn (EVariable l)))",
                 "int l = 0;\n"
@@ -676,9 +677,9 @@ public void testSEach() {
     public void testSFor() {
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration int sum (ENumeric 0)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) sum (ENumeric 0)))\n"
               + "  (SFor\n"
-              + "    (SDeclBlock (SDeclaration int i (ENumeric 0)))\n"
+              + "    (SDeclBlock (SDeclaration (DUnresolvedType [int]) i (ENumeric 0)))\n"
               + "    (EComp (EVariable i) < (ENumeric 1000))\n"
               + "    (EAssignment (EVariable i) ++ post)\n"
               + "    (SBlock (SExpression (EAssignment (EVariable sum) += (EVariable i)))))\n"
@@ -690,13 +691,13 @@ public void testSFor() {
                 + "return sum");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration int sum (ENumeric 0)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) sum (ENumeric 0)))\n"
               + "  (SFor\n"
-              + "    (SDeclBlock (SDeclaration int i (ENumeric 0)))\n"
+              + "    (SDeclBlock (SDeclaration (DUnresolvedType [int]) i (ENumeric 0)))\n"
               + "    (EComp (EVariable i) < (ENumeric 1000))\n"
               + "    (EAssignment (EVariable i) ++ post)\n"
               + "    (SBlock (SFor\n"
-              + "      (SDeclBlock (SDeclaration int j (ENumeric 0)))\n"
+              + "      (SDeclBlock (SDeclaration (DUnresolvedType [int]) j (ENumeric 0)))\n"
               + "      (EComp (EVariable j) < (ENumeric 1000))\n"
               + "      (EAssignment (EVariable j) ++ post)\n"
               + "      (SBlock (SExpression (EAssignment (EVariable sum) += (EBinary (EVariable i) * (EVariable j))))))))\n"
@@ -740,7 +741,7 @@ public void testSIfElse() {
                 + "}");
         assertToString(
                 "(SClass\n"
-              + "  (SDeclBlock (SDeclaration int i (ENumeric 0)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) i (ENumeric 0)))\n"
               + "  (SIfElse (PField (EVariable param) a)\n"
               + "    (SBlock (SIfElse (PField (EVariable param) b)\n"
               + "      (SBlock (SReturn (EBoolean true)))\n"
@@ -789,7 +790,7 @@ public void testSThrow() {
     public void testSWhile() {
         assertToString(
                   "(SClass\n"
-                + "  (SDeclBlock (SDeclaration int i (ENumeric 0)))\n"
+                + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) i (ENumeric 0)))\n"
                 + "  (SWhile (EComp (EVariable i) < (ENumeric 10)) (SBlock (SExpression (EAssignment (EVariable i) ++ post))))\n"
                 + "  (SReturn (EVariable i)))",
                   "int i = 0;\n"
@@ -822,7 +823,7 @@ public void testSFunction() {
                 "(SClass\n"
               + "  (SFunction def a (Args (Pair int i) (Pair int j))\n"
               + "    (SIf (EComp (EVariable i) < (EVariable j)) (SBlock (SReturn (EBoolean true))))\n"
-              + "    (SDeclBlock (SDeclaration int k (EBinary (EVariable i) + (EVariable j))))\n"
+              + "    (SDeclBlock (SDeclaration (DUnresolvedType [int]) k (EBinary (EVariable i) + (EVariable j))))\n"
               + "    (SReturn (EVariable k)))\n"
               + "  (SReturn (EBoolean true)))",
                 "def a(int i, int j) {\n"
@@ -860,7 +861,7 @@ public void testSTryAndSCatch() {
                 + "}");
         assertToString(
                 "(SClass (STry (SBlock\n"
-              + "  (SDeclBlock (SDeclaration int i (ENumeric 1)))\n"
+              + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) i (ENumeric 1)))\n"
               + "  (SReturn (ENumeric 1)))\n"
               + "  (SCatch Exception e (SBlock (SReturn (ENumeric 2))))))",
                 "try {\n"
@@ -872,7 +873,7 @@ public void testSTryAndSCatch() {
         assertToString(
                 "(SClass (STry (SBlock (SReturn (ENumeric 1)))\n"
               + "  (SCatch Exception e (SBlock\n"
-              + "    (SDeclBlock (SDeclaration int i (ENumeric 1)))\n"
+              + "    (SDeclBlock (SDeclaration (DUnresolvedType [int]) i (ENumeric 1)))\n"
               + "    (SReturn (ENumeric 2))))))",
                 "try {\n"
               + "  return 1\n"

From 6061b81fc44b27b14f9a1be9fe1843bbe4162096 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Thu, 5 Dec 2019 17:26:35 -0800
Subject: [PATCH 088/686] Dump wildfly log on start failure (#49892)

When testing wildfly with Elasticsearch, we currently dump the wildfly
log if the test fails. However, when starting wildfly we may fail to
find the port number wildfly started on, and fail with no output. This
change dumps the wildflog log when failing to find the http or
management ports.

relates #49374
---
 qa/wildfly/build.gradle | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/qa/wildfly/build.gradle b/qa/wildfly/build.gradle
index 9fe5656c326d3..4c62d69f180a8 100644
--- a/qa/wildfly/build.gradle
+++ b/qa/wildfly/build.gradle
@@ -163,8 +163,10 @@ task startWildfly {
         }
       }
 
-      assert httpPort > 0
-      assert managementPort > 0
+      if (httpPort == 0 || managementPort == 0) {
+        String portType = httpPort == 0 ? "http" : "management"
+        throw new GradleException("Failed to find ${portType} port in wildfly log")
+      }
     }
   }
 }
@@ -188,6 +190,10 @@ if (!Os.isFamily(Os.FAMILY_WINDOWS)) {
   final TaskExecutionAdapter logDumpListener = new TaskExecutionAdapter() {
     @Override
     void afterExecute(final Task task, final TaskState state) {
+      if (task != startWildfly && task != integTestRunner) {
+        // we might have been called from a parallel, unrelated task
+        return
+      }
       if (state.failure != null) {
         final File logFile = new File(wildflyInstall, "standalone/log/server.log")
         println("\nWildfly server log (from ${logFile}):")
@@ -204,12 +210,18 @@ if (!Os.isFamily(Os.FAMILY_WINDOWS)) {
       }
     }
   }
+  startWildfly.doFirst {
+    project.gradle.addListener(logDumpListener)
+  }
   integTestRunner.doFirst {
     project.gradle.addListener(logDumpListener)
   }
   integTestRunner.doLast {
     project.gradle.removeListener(logDumpListener)
   }
+  startWildfly.doLast {
+    project.gradle.removeListener(logDumpListener)
+  }
   integTestRunner.finalizedBy(stopWildfly)
 } else {
   integTest.enabled = false

From ac1c8df3094d8f4b248d1ab3c97f0f7e337e1ccc Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Fri, 6 Dec 2019 08:18:13 +0100
Subject: [PATCH 089/686] Reindex sort deprecation warning take 2 (#49855)

Moved the deprecation warning to ReindexValidator to ensure it runs
early and works with resilient reindex. Also check that the warning
is reported back for wait_for_completion=false.

Follow-up to #49458
---
 .../index/reindex/ReindexValidator.java       | 12 +++++++
 .../index/reindex/Reindexer.java              |  9 -----
 .../index/reindex/ReindexSingleNodeTests.java |  2 +-
 .../rest-api-spec/test/reindex/30_search.yml  | 35 +++++++++++++++++++
 4 files changed, 48 insertions(+), 10 deletions(-)

diff --git a/modules/reindex/src/main/java/org/elasticsearch/index/reindex/ReindexValidator.java b/modules/reindex/src/main/java/org/elasticsearch/index/reindex/ReindexValidator.java
index 717ba2f0b263a..fffd79e861ade 100644
--- a/modules/reindex/src/main/java/org/elasticsearch/index/reindex/ReindexValidator.java
+++ b/modules/reindex/src/main/java/org/elasticsearch/index/reindex/ReindexValidator.java
@@ -19,6 +19,8 @@
 
 package org.elasticsearch.index.reindex;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.apache.lucene.util.automaton.Automata;
 import org.apache.lucene.util.automaton.Automaton;
 import org.apache.lucene.util.automaton.CharacterRunAutomaton;
@@ -32,12 +34,18 @@
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.regex.Regex;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.search.builder.SearchSourceBuilder;
 
 import java.util.List;
 
 class ReindexValidator {
+    private static final Logger logger = LogManager.getLogger(ReindexValidator.class);
+    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(logger);
+    static final String SORT_DEPRECATED_MESSAGE = "The sort option in reindex is deprecated. " +
+        "Instead consider using query filtering to find the desired subset of data.";
 
     private final CharacterRunAutomaton remoteWhitelist;
     private final ClusterService clusterService;
@@ -57,6 +65,10 @@ void initialValidation(ReindexRequest request) {
         ClusterState state = clusterService.state();
         validateAgainstAliases(request.getSearchRequest(), request.getDestination(), request.getRemoteInfo(), resolver, autoCreateIndex,
             state);
+        SearchSourceBuilder searchSource = request.getSearchRequest().source();
+        if (searchSource != null && searchSource.sorts() != null && searchSource.sorts().isEmpty() == false) {
+            deprecationLogger.deprecated(SORT_DEPRECATED_MESSAGE);
+        }
     }
 
     static void checkRemoteWhitelist(CharacterRunAutomaton whitelist, RemoteInfo remoteInfo) {
diff --git a/modules/reindex/src/main/java/org/elasticsearch/index/reindex/Reindexer.java b/modules/reindex/src/main/java/org/elasticsearch/index/reindex/Reindexer.java
index cbe0e8be6572c..39879845bdca1 100644
--- a/modules/reindex/src/main/java/org/elasticsearch/index/reindex/Reindexer.java
+++ b/modules/reindex/src/main/java/org/elasticsearch/index/reindex/Reindexer.java
@@ -40,7 +40,6 @@
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.lucene.uid.Versions;
 import org.elasticsearch.common.xcontent.DeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -52,7 +51,6 @@
 import org.elasticsearch.index.reindex.remote.RemoteScrollableHitSource;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptService;
-import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
@@ -73,9 +71,6 @@
 public class Reindexer {
 
     private static final Logger logger = LogManager.getLogger(Reindexer.class);
-    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(logger);
-    static final String SORT_DEPRECATED_MESSAGE = "The sort option in reindex is deprecated. " +
-        "Instead consider using query filtering to find the desired subset of data.";
 
     private final ClusterService clusterService;
     private final Client client;
@@ -93,10 +88,6 @@ public class Reindexer {
     }
 
     public void initTask(BulkByScrollTask task, ReindexRequest request, ActionListener<Void> listener) {
-        SearchSourceBuilder searchSource = request.getSearchRequest().source();
-        if (searchSource != null && searchSource.sorts() != null && searchSource.sorts().isEmpty() == false) {
-            deprecationLogger.deprecated(SORT_DEPRECATED_MESSAGE);
-        }
         BulkByScrollParallelizationHelper.initTaskState(task, request, client, listener);
     }
 
diff --git a/modules/reindex/src/test/java/org/elasticsearch/index/reindex/ReindexSingleNodeTests.java b/modules/reindex/src/test/java/org/elasticsearch/index/reindex/ReindexSingleNodeTests.java
index 14b68ebdf6c6d..118e13fd4f5bf 100644
--- a/modules/reindex/src/test/java/org/elasticsearch/index/reindex/ReindexSingleNodeTests.java
+++ b/modules/reindex/src/test/java/org/elasticsearch/index/reindex/ReindexSingleNodeTests.java
@@ -55,6 +55,6 @@ public void testDeprecatedSort() {
 
         assertHitCount(client().prepareSearch("dest").setSize(0).get(), subsetSize);
         assertHitCount(client().prepareSearch("dest").setQuery(new RangeQueryBuilder("foo").gte(0).lt(max-subsetSize)).get(), 0);
-        assertWarnings(Reindexer.SORT_DEPRECATED_MESSAGE);
+        assertWarnings(ReindexValidator.SORT_DEPRECATED_MESSAGE);
     }
 }
diff --git a/modules/reindex/src/test/resources/rest-api-spec/test/reindex/30_search.yml b/modules/reindex/src/test/resources/rest-api-spec/test/reindex/30_search.yml
index be2d943431030..d021848216517 100644
--- a/modules/reindex/src/test/resources/rest-api-spec/test/reindex/30_search.yml
+++ b/modules/reindex/src/test/resources/rest-api-spec/test/reindex/30_search.yml
@@ -121,6 +121,41 @@
         q: order:1
   - match: { hits.total: 1 }
 
+---
+"Sorting deprecated wait_for_completion false":
+  - skip:
+      version: " - 7.5.99"
+      reason: "sort deprecated in 7.6"
+      features: "warnings"
+
+  - do:
+      index:
+        index:  test
+        id:     1
+        body:   { "order": 1 }
+  - do:
+      indices.refresh: {}
+
+  - do:
+      warnings:
+        - The sort option in reindex is deprecated. Instead consider using query
+          filtering to find the desired subset of data.
+      reindex:
+        refresh: true
+        wait_for_completion: false
+        body:
+          source:
+            index: test
+            sort: order
+          dest:
+            index: target
+  - set: {task: task}
+
+  - do:
+      tasks.get:
+        wait_for_completion: true
+        task_id: $task
+
 ---
 "max_docs in URL":
   - skip:

From f5973005dced30ca86bc70a78cee2318f428a6ba Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Fri, 6 Dec 2019 08:19:21 +0100
Subject: [PATCH 090/686] [Transform][DOCS]rewrite client ip example to use
 continuous transform (#49822)

adapt the transform example for suspicious client ips to use continuous transform
---
 docs/reference/transform/examples.asciidoc | 143 ++++++++++++---------
 1 file changed, 83 insertions(+), 60 deletions(-)

diff --git a/docs/reference/transform/examples.asciidoc b/docs/reference/transform/examples.asciidoc
index 19dd9bbf505d8..f88bff4ce9634 100644
--- a/docs/reference/transform/examples.asciidoc
+++ b/docs/reference/transform/examples.asciidoc
@@ -54,18 +54,18 @@ POST _transform/_preview
 ----------------------------------
 // TEST[skip:setup kibana sample data]
 
-<1> This is the destination index for the {dataframe}. It is ignored by 
+<1> This is the destination index for the {transform}. It is ignored by
 `_preview`.
-<2> Two `group_by` fields have been selected. This means the {dataframe} will 
-contain a unique row per `user` and `customer_id` combination. Within this 
-dataset both these fields are unique. By including both in the {dataframe} it 
+<2> Two `group_by` fields have been selected. This means the {transform} will
+contain a unique row per `user` and `customer_id` combination. Within this
+dataset both these fields are unique. By including both in the {transform} it
 gives more context to the final results.
 
 NOTE: In the example above, condensed JSON formatting has been used for easier 
 readability of the pivot object.
 
-The preview {transforms} API enables you to see the layout of the 
-{dataframe} in advance, populated with some sample values. For example:
+The preview {transforms} API enables you to see the layout of the
+{transform} in advance, populated with some sample values. For example:
 
 [source,js]
 ----------------------------------
@@ -86,7 +86,7 @@ The preview {transforms} API enables you to see the layout of the
 ----------------------------------
 // NOTCONSOLE
 
-This {dataframe} makes it easier to answer questions such as:
+This {transform} makes it easier to answer questions such as:
 
 * Which customers spend the most?
 
@@ -154,7 +154,7 @@ POST _transform/_preview
 // TEST[skip:setup kibana sample data]
 
 <1> Filter the source data to select only flights that were not cancelled.
-<2> This is the destination index for the {dataframe}. It is ignored by 
+<2> This is the destination index for the {transform}. It is ignored by
 `_preview`.
 <3> The data is grouped by the `Carrier` field which contains the airline name.
 <4> This `bucket_script` performs calculations on the results that are returned 
@@ -181,7 +181,7 @@ carrier:
 ----------------------------------
 // NOTCONSOLE
 
-This {dataframe} makes it easier to answer questions such as:
+This {transform} makes it easier to answer questions such as:
 
 * Which air carrier has the most delays as a percentage of flight time?
 
@@ -207,21 +207,20 @@ entity is `clientip`.
 
 [source,console]
 ----------------------------------
-POST _transform/_preview
+PUT _transform/suspicious_client_ips
 {
   "source": {
-    "index": "kibana_sample_data_logs",
-    "query": { <1>
-      "range" : {
-        "timestamp" : {
-          "gte" : "now-30d/d"
-        }
-      }
-    }
+    "index": "kibana_sample_data_logs"
   },
-  "dest" : { <2>
+  "dest" : { <1>
     "index" : "sample_weblogs_by_clientip"
-  },  
+  },
+  "sync" : { <2>
+    "time": {
+      "field": "timestamp",
+      "delay": "60s"
+    }
+  },
   "pivot": {
     "group_by": {  <3>
       "clientip": { "terms": { "field": "clientip" } }
@@ -275,58 +274,82 @@ POST _transform/_preview
 ----------------------------------
 // TEST[skip:setup kibana sample data]
 
-<1> This range query limits the {transform} to documents that are within the 
-last 30 days at the point in time the {transform} checkpoint is processed. For 
-batch {transforms} this occurs once.
-<2> This is the destination index for the {dataframe}. It is ignored by 
-`_preview`.
-<3> The data is grouped by the `clientip` field. 
-<4> This `scripted_metric` performs a distributed operation on the web log data 
+<1> This is the destination index for the {transform}.
+<2> Configures the {transform} to run continuously. It uses the `timestamp` field
+to synchronize the source and destination indices. The worst case
+ingestion delay is 60 seconds.
+<3> The data is grouped by the `clientip` field.
+<4> This `scripted_metric` performs a distributed operation on the web log data
 to count specific types of HTTP responses (error, success, and other).
-<5> This `bucket_script` calculates the duration of the `clientip` access based 
+<5> This `bucket_script` calculates the duration of the `clientip` access based
 on the results of the aggregation.
 
-The preview shows you that the new index would contain data like this for each 
-client IP:
+After you create the {transform}, you must start it:
+
+[source,console]
+----------------------------------
+POST _transform/suspicious_client_ips/_start
+----------------------------------
+// TEST[skip:setup kibana sample data]
+
+Shortly thereafter, the first results should be available in the destination
+index:
+
+[source,console]
+----------------------------------
+GET sample_weblogs_by_clientip/_search
+----------------------------------
+// TEST[skip:setup kibana sample data]
+
+The search result shows you data like this for each client IP:
 
 [source,js]
 ----------------------------------
-{
-  "preview" : [
-    {
-      "geo" : {
-        "src_dc" : 12.0,
-        "dest_dc" : 9.0
-      },
-      "clientip" : "0.72.176.46",
-      "agent_dc" : 3.0,
-      "responses" : {
-        "total" : 14.0,
-        "counts" : {
-          "other" : 0,
-          "success" : 14,
-          "error" : 0
+    "hits" : [
+      {
+        "_index" : "sample_weblogs_by_clientip",
+        "_id" : "MOeHH_cUL5urmartKj-b5UQAAAAAAAAA",
+        "_score" : 1.0,
+        "_source" : {
+          "geo" : {
+            "src_dc" : 2.0,
+            "dest_dc" : 2.0
+          },
+          "clientip" : "0.72.176.46",
+          "agent_dc" : 2.0,
+          "bytes_sum" : 4422.0,
+          "responses" : {
+            "total" : 2.0,
+            "counts" : {
+              "other" : 0,
+              "success" : 2,
+              "error" : 0
+            }
+          },
+          "url_dc" : 2.0,
+          "timestamp" : {
+            "duration_ms" : 5.2191698E8,
+            "min" : "2019-11-25T07:51:57.333Z",
+            "max" : "2019-12-01T08:50:34.313Z"
+          }
         }
-      },
-      "bytes_sum" : 74808.0,
-      "timestamp" : {
-        "duration_ms" : 4.919943239E9,
-        "min" : "2019-06-17T07:51:57.333Z",
-        "max" : "2019-08-13T06:31:00.572Z"
-      },
-      "url_dc" : 11.0
-    },
-    ...
-  }
-----------------------------------  
+      }
+    ]
+----------------------------------
 // NOTCONSOLE
 
-This {dataframe} makes it easier to answer questions such as:
+NOTE: Like other Kibana sample data sets, the web log sample dataset contains
+timestamps relative to when you installed it, including timestamps in the future.
+The {ctransform} will pick up the data points once they are in the past. If you 
+installed the web log sample dataset some time ago, you can uninstall and 
+reinstall it and the timestamps will change.
+
+This {transform} makes it easier to answer questions such as:
 
 * Which client IPs are transferring the most amounts of data?
 
 * Which client IPs are interacting with a high number of different URLs?
-  
+
 * Which client IPs have high error rates?
-  
+
 * Which client IPs are interacting with a high number of destination countries?

From e89bc3a1a968acb26d8e640cb44c84b50e559251 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Fri, 6 Dec 2019 10:23:01 +0100
Subject: [PATCH 091/686] [DOCS] Fixes attribute in transforms overview.
 (#49898)

---
 docs/reference/transform/overview.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/transform/overview.asciidoc b/docs/reference/transform/overview.asciidoc
index 50930b00c5cb3..07c17f778abaf 100644
--- a/docs/reference/transform/overview.asciidoc
+++ b/docs/reference/transform/overview.asciidoc
@@ -39,7 +39,7 @@ The {transform} performs a composite aggregation that paginates through all the
 data defined by the source index query. The output of the aggregation is stored 
 in a destination index. Each time the {transform} queries the source index, it 
 creates a _checkpoint_. You can decide whether you want the {transform} to run 
-once (batch {transform}) or continuously ({transform}). A batch {transform} is a 
+once (batch {transform}) or continuously ({ctransform}). A batch {transform} is a 
 single operation that has a single checkpoint. {ctransforms-cap} continually 
 increment and process checkpoints as new source data is ingested.
 

From ffdb27b42d9d5609306b05266350d16e94ab96ef Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 6 Dec 2019 10:28:02 +0100
Subject: [PATCH 092/686] Cleanup Old index-N Blobs in Repository Cleanup
 (#49862)

* Cleanup Old index-N Blobs in Repository Cleanup

Repository cleanup didn't deal with old index-N, this change adds
cleaning up all old index-N found in the repository.

* add test
---
 .../blobstore/BlobStoreRepository.java        |  3 ++
 .../BlobStoreRepositoryCleanupIT.java         | 40 +++++++++++++++++++
 2 files changed, 43 insertions(+)

diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index ba670c2d6f01d..838bede23bf54 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -731,6 +731,9 @@ private List<String> staleRootBlobs(RepositoryData repositoryData, Set<String> r
                         return false;
                     }
                     return allSnapshotIds.contains(foundUUID) == false;
+                } else if (blob.startsWith(INDEX_FILE_PREFIX)) {
+                    // TODO: Include the current generation here once we remove keeping index-(N-1) around from #writeIndexGen
+                    return repositoryData.getGenId() > Long.parseLong(blob.substring(INDEX_FILE_PREFIX.length()));
                 }
                 return false;
             }
diff --git a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryCleanupIT.java b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryCleanupIT.java
index 7ee49e53e2658..fd195123fc0a9 100644
--- a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryCleanupIT.java
+++ b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryCleanupIT.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.repositories.blobstore;
 
 import org.elasticsearch.action.ActionRunnable;
+import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.RepositoryCleanupInProgress;
 import org.elasticsearch.common.settings.Settings;
@@ -26,13 +27,16 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.repositories.RepositoriesService;
 import org.elasticsearch.snapshots.AbstractSnapshotIntegTestCase;
+import org.elasticsearch.snapshots.SnapshotState;
 import org.elasticsearch.test.ESIntegTestCase;
 
 import java.io.ByteArrayInputStream;
+import java.util.concurrent.ExecutionException;
 import java.util.concurrent.TimeUnit;
 
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertThrows;
+import static org.hamcrest.Matchers.is;
 
 @ESIntegTestCase.ClusterScope(scope = ESIntegTestCase.Scope.TEST, numDataNodes = 0)
 public class BlobStoreRepositoryCleanupIT extends AbstractSnapshotIntegTestCase {
@@ -107,4 +111,40 @@ private String startBlockedCleanup(String repoName) throws Exception {
         waitForBlock(masterNode, repoName, TimeValue.timeValueSeconds(60));
         return masterNode;
     }
+
+    public void testCleanupOldIndexN() throws ExecutionException, InterruptedException {
+        internalCluster().startNodes(Settings.EMPTY);
+
+        final String repoName = "test-repo";
+        logger.info("-->  creating repository");
+        assertAcked(client().admin().cluster().preparePutRepository(repoName).setType("fs").setSettings(Settings.builder()
+            .put("location", randomRepoPath())
+            .put("compress", randomBoolean())
+            .put("chunk_size", randomIntBetween(100, 1000), ByteSizeUnit.BYTES)));
+
+        logger.info("--> create three snapshots");
+        for (int i = 0; i < 3; ++i) {
+            CreateSnapshotResponse createSnapshotResponse = client().admin().cluster().prepareCreateSnapshot(repoName, "test-snap-" + i)
+                .setWaitForCompletion(true).get();
+            assertThat(createSnapshotResponse.getSnapshotInfo().state(), is(SnapshotState.SUCCESS));
+        }
+
+        final RepositoriesService service = internalCluster().getInstance(RepositoriesService.class, internalCluster().getMasterName());
+        final BlobStoreRepository repository = (BlobStoreRepository) service.repository(repoName);
+
+        logger.info("--> write two outdated index-N blobs");
+        for (int i = 0; i < 2; ++i) {
+            final PlainActionFuture<Void> createOldIndexNFuture = PlainActionFuture.newFuture();
+            final int generation = i;
+            repository.threadPool().generic().execute(ActionRunnable.run(createOldIndexNFuture, () -> repository.blobStore()
+                .blobContainer(repository.basePath()).writeBlob(BlobStoreRepository.INDEX_FILE_PREFIX + generation,
+                    new ByteArrayInputStream(new byte[1]), 1, true)));
+            createOldIndexNFuture.get();
+        }
+
+        logger.info("--> cleanup repository");
+        client().admin().cluster().prepareCleanupRepository(repoName).get();
+
+        BlobStoreTestUtil.assertConsistency(repository, repository.threadPool().generic());
+    }
 }

From b7ffb2b52a478fbadaa792cca3b5967c940134da Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Fri, 6 Dec 2019 13:24:22 +0100
Subject: [PATCH 093/686] [DOCS] Fixes classification evaluation example
 response. (#49905)

---
 .../ml/df-analytics/apis/evaluate-dfanalytics.asciidoc    | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
index 0b855ef731fad..4576f465a7604 100644
--- a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
@@ -78,6 +78,8 @@ Available evaluation types:
 [[ml-evaluate-dfanalytics-example]]
 ==== {api-examples-title}
 
+
+[[ml-evaluate-binary-soft-class-example]]
 ===== Binary soft classification
 
 [source,console]
@@ -139,6 +141,7 @@ The API returns the following results:
 ----
 
 
+[[ml-evaluate-regression-example]]
 ===== {regression-cap}
 
 [source,console]
@@ -252,6 +255,7 @@ performance. This is required in order to evaluate results.
 calculated by the {reganalysis}.
 
 
+[[ml-evaluate-classification-example]]
 ===== {classification-cap}
 
 
@@ -311,14 +315,14 @@ The API returns the following result:
             "predicted_classes" : [
               {
                 "predicted_class" : "dog",
-                "count" : 11
+                "count" : 7
               },
               {
                 "predicted_class" : "cat",
                 "count" : 4
               }
             ],
-            "other_predicted_class_doc_count" : 4
+            "other_predicted_class_doc_count" : 0
           }
         ],
         "other_actual_class_count" : 0

From a16ebafc0a91c6c21379d8fa058a380f4edddf00 Mon Sep 17 00:00:00 2001
From: cachedout <mike.place@elastic.co>
Date: Fri, 6 Dec 2019 12:28:20 +0000
Subject: [PATCH 094/686] APM system_user (#47668)

* Add test for APM beats index perms

* Grant monitoring index privs to apm_system user

* Review feedback

* Fix compilation problem
---
 .../security/authz/store/ReservedRolesStore.java  |  7 ++++++-
 .../authz/store/ReservedRolesStoreTests.java      | 15 ++++++++++++++-
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
index ed80944a3764e..7e06bbf64d999 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
@@ -148,7 +148,12 @@ private static Map<String, RoleDescriptor> initializeReservedRoles() {
                         },
                     null, MetadataUtils.DEFAULT_RESERVED_METADATA))
                 .put(UsernamesField.APM_ROLE, new RoleDescriptor(UsernamesField.APM_ROLE,
-                        new String[] { "monitor", MonitoringBulkAction.NAME}, null, null, MetadataUtils.DEFAULT_RESERVED_METADATA))
+                        new String[] { "monitor", MonitoringBulkAction.NAME},
+                        new RoleDescriptor.IndicesPrivileges[]{
+                            RoleDescriptor.IndicesPrivileges.builder()
+                                .indices(".monitoring-beats-*").privileges("create_index", "create_doc").build()
+                        },
+                    null, MetadataUtils.DEFAULT_RESERVED_METADATA))
                 .put("apm_user", new RoleDescriptor("apm_user",
                     null, new RoleDescriptor.IndicesPrivileges[] {
                         RoleDescriptor.IndicesPrivileges.builder().indices("apm-*")
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
index 97fd4172b4ce6..533962efd5a31 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
@@ -892,7 +892,7 @@ public void testBeatsSystemRole() {
 
 
         final String index = ".monitoring-beats-" + randomIntBetween(0, 5);;
-        logger.info("index name [{}]", index);
+        logger.info("beats monitoring index name [{}]", index);
         assertThat(beatsSystemRole.indices().allowedIndicesMatcher(IndexAction.NAME).test("foo"), is(false));
         assertThat(beatsSystemRole.indices().allowedIndicesMatcher(IndexAction.NAME).test(".reporting"), is(false));
         assertThat(beatsSystemRole.indices().allowedIndicesMatcher("indices:foo").test(randomAlphaOfLengthBetween(8, 24)),
@@ -930,7 +930,20 @@ public void testAPMSystemRole() {
         assertThat(APMSystemRole.indices().allowedIndicesMatcher("indices:foo").test(randomAlphaOfLengthBetween(8, 24)),
                 is(false));
 
+        final String index = ".monitoring-beats-" + randomIntBetween(10, 15);
+        logger.info("APM beats monitoring index name [{}]", index);
+
+        assertThat(APMSystemRole.indices().allowedIndicesMatcher(CreateIndexAction.NAME).test(index), is(true));
+        assertThat(APMSystemRole.indices().allowedIndicesMatcher("indices:data/write/index:op_type/create").test(index), is(true));
+        assertThat(APMSystemRole.indices().allowedIndicesMatcher(DeleteAction.NAME).test(index), is(false));
+        assertThat(APMSystemRole.indices().allowedIndicesMatcher(BulkAction.NAME).test(index), is(true));
+
+        assertThat(APMSystemRole.indices().allowedIndicesMatcher("indices:data/write/index:op_type/index").test(index), is(false));
+        assertThat(APMSystemRole.indices().allowedIndicesMatcher(
+            "indices:data/write/index:op_type/" + randomAlphaOfLengthBetween(3,5)).test(index), is(false));
+
         assertNoAccessAllowed(APMSystemRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+
     }
 
     public void testAPMUserRole() {

From f149a4ce8860a66f9aca412d5adbc0533381af74 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Fri, 6 Dec 2019 13:31:10 +0100
Subject: [PATCH 095/686] Log whole analytics stats when the state assertion
 fails (#49906)

---
 .../ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
index b3b58a2d4fcbb..0b9e2c19961d8 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
@@ -174,7 +174,7 @@ protected void assertIsStopped(String id) {
         GetDataFrameAnalyticsStatsAction.Response.Stats stats = getAnalyticsStats(id);
         assertThat(stats.getId(), equalTo(id));
         assertThat(stats.getFailureReason(), is(nullValue()));
-        assertThat(stats.getState(), equalTo(DataFrameAnalyticsState.STOPPED));
+        assertThat("Stats were: " + Strings.toString(stats), stats.getState(), equalTo(DataFrameAnalyticsState.STOPPED));
     }
 
     protected void assertProgress(String id, int reindexing, int loadingData, int analyzing, int writingResults) {

From f63dc8e8081910a1bdf44363c306aa7e6e72f0f9 Mon Sep 17 00:00:00 2001
From: Alexander Reelsen <alexander@reelsen.net>
Date: Fri, 6 Dec 2019 14:33:02 +0100
Subject: [PATCH 096/686] Add tests for ingesting CBOR data attachments
 (#49715)

Our docs specifically mention that CBOR is supported when ingesting attachments. However this is not tested anywhere.

This adds a test, that uses specifically CBOR format in its IndexRequest and another one that behaves like CBOR in the ingest attachment unit tests.
---
 .../attachment/AttachmentProcessorTests.java  | 11 +++++--
 .../ingest/IngestServiceTests.java            | 33 +++++++++++++++++++
 2 files changed, 41 insertions(+), 3 deletions(-)

diff --git a/plugins/ingest-attachment/src/test/java/org/elasticsearch/ingest/attachment/AttachmentProcessorTests.java b/plugins/ingest-attachment/src/test/java/org/elasticsearch/ingest/attachment/AttachmentProcessorTests.java
index 5658eb567177b..11f96a51b10ae 100644
--- a/plugins/ingest-attachment/src/test/java/org/elasticsearch/ingest/attachment/AttachmentProcessorTests.java
+++ b/plugins/ingest-attachment/src/test/java/org/elasticsearch/ingest/attachment/AttachmentProcessorTests.java
@@ -284,7 +284,7 @@ private Map<String, Object> parseDocument(String file, AttachmentProcessor proce
     private Map<String, Object> parseDocument(String file, AttachmentProcessor processor, Map<String, Object> optionalFields)
         throws Exception {
         Map<String, Object> document = new HashMap<>();
-        document.put("source_field", getAsBase64(file));
+        document.put("source_field", getAsBinaryOrBase64(file));
         document.putAll(optionalFields);
 
         IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random(), document);
@@ -335,11 +335,16 @@ public void testIndexedChars() throws Exception {
         assertThat(attachmentData.get("content_length"), is(56L));
     }
 
-    private String getAsBase64(String filename) throws Exception {
+    private Object getAsBinaryOrBase64(String filename) throws Exception {
         String path = "/org/elasticsearch/ingest/attachment/test/sample-files/" + filename;
         try (InputStream is = AttachmentProcessorTests.class.getResourceAsStream(path)) {
             byte bytes[] = IOUtils.toByteArray(is);
-            return Base64.getEncoder().encodeToString(bytes);
+            // behave like CBOR from time to time
+            if (rarely()) {
+                return bytes;
+            } else {
+                return Base64.getEncoder().encodeToString(bytes);
+            }
         }
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/ingest/IngestServiceTests.java b/server/src/test/java/org/elasticsearch/ingest/IngestServiceTests.java
index 5400956d076c3..7890d30f6c4e3 100644
--- a/server/src/test/java/org/elasticsearch/ingest/IngestServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/ingest/IngestServiceTests.java
@@ -46,7 +46,9 @@
 import org.elasticsearch.common.logging.Loggers;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.EsExecutors;
+import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.common.xcontent.cbor.CborXContent;
 import org.elasticsearch.index.VersionType;
 import org.elasticsearch.plugins.IngestPlugin;
 import org.elasticsearch.script.MockScriptEngine;
@@ -61,6 +63,7 @@
 import org.mockito.ArgumentMatcher;
 import org.mockito.invocation.InvocationOnMock;
 
+import java.nio.charset.StandardCharsets;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.Comparator;
@@ -70,6 +73,7 @@
 import java.util.Objects;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.atomic.AtomicInteger;
+import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.BiConsumer;
 import java.util.function.Consumer;
 import java.util.function.IntConsumer;
@@ -1202,6 +1206,35 @@ public Map<String, Processor.Factory> getProcessors(Processor.Parameters paramet
         assertThat(counter.get(), equalTo(2));
     }
 
+    public void testCBORParsing() throws Exception {
+        AtomicReference<Object> reference = new AtomicReference<>();
+        Consumer<IngestDocument> executor = doc -> reference.set(doc.getFieldValueAsBytes("data"));
+        final IngestService ingestService = createWithProcessors(Collections.singletonMap("foo",
+            (factories, tag, config) -> new FakeProcessor("foo", tag, executor)));
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name")).build();
+        ClusterState previousClusterState = clusterState;
+        PutPipelineRequest putRequest = new PutPipelineRequest("_id",
+            new BytesArray("{\"processors\": [{\"foo\" : {}}]}"), XContentType.JSON);
+        clusterState = IngestService.innerPut(putRequest, clusterState);
+        ingestService.applyClusterState(new ClusterChangedEvent("", clusterState, previousClusterState));
+        assertThat(ingestService.getPipeline("_id"), notNullValue());
+
+        try (XContentBuilder builder = CborXContent.contentBuilder()) {
+            builder.startObject();
+            builder.field("data", "This is my data".getBytes(StandardCharsets.UTF_8));
+            builder.endObject();
+
+            IndexRequest indexRequest =
+                new IndexRequest("_index").id("_doc-id").source(builder).setPipeline("_id").setFinalPipeline("_none");
+
+            ingestService.executeBulkRequest(1, Collections.singletonList(indexRequest),
+                (integer, e) -> {}, (thread, e) -> {}, indexReq -> {});
+        }
+
+        assertThat(reference.get(), is(instanceOf(byte[].class)));
+    }
+
     private IngestDocument eqIndexTypeId(final Map<String, Object> source) {
         return argThat(new IngestDocumentMatcher("_index", "_type", "_id", -3L, VersionType.INTERNAL, source));
     }

From ab9baeffc40e4098898abbb4e8212b32eb0ddb40 Mon Sep 17 00:00:00 2001
From: Ioannis Kakavas <ioannis@elastic.co>
Date: Fri, 6 Dec 2019 15:57:00 +0200
Subject: [PATCH 097/686] Always return 401 for not valid tokens (#49736)

Return a 401 in all cases when a request is submitted with an
access token that we can't consume. Before this change, we would
throw a 500 when a request came in with an access token that we
had generated but was then invalidated/expired and deleted from
the tokens index.

Resolves: #38866
---
 .../xpack/security/authc/TokenService.java    |  8 ++--
 .../security/authc/TokenAuthIntegTests.java   | 43 ++++++++++++++++++-
 .../security/authc/TokenServiceTests.java     | 40 ++++++++++++++++-
 3 files changed, 86 insertions(+), 5 deletions(-)

diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
index 689a6db034130..42d582997d827 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
@@ -421,7 +421,7 @@ private void getUserTokenFromId(String userTokenId, Version tokenVersion, Action
         } else {
             final GetRequest getRequest = client.prepareGet(tokensIndex.aliasName(),
                     getTokenDocumentId(userTokenId)).request();
-            final Consumer<Exception> onFailure = ex -> listener.onFailure(traceLog("decode token", userTokenId, ex));
+            final Consumer<Exception> onFailure = ex -> listener.onFailure(traceLog("get token from id", userTokenId, ex));
             tokensIndex.checkIndexVersionThenExecute(
                 ex -> listener.onFailure(traceLog("prepare tokens index [" + tokensIndex.aliasName() +"]", userTokenId, ex)),
                 () -> executeAsyncWithOrigin(client.threadPool().getThreadContext(), SECURITY_ORIGIN, getRequest,
@@ -441,8 +441,10 @@ private void getUserTokenFromId(String userTokenId, Version tokenVersion, Action
                                     listener.onResponse(UserToken.fromSourceMap(userTokenSource));
                                 }
                             } else {
-                                onFailure.accept(
-                                    new IllegalStateException("token document is missing and must be present"));
+                                // The chances of a random token string decoding to something that we can read is minimal, so
+                                // we assume that this was a token we have created but is now expired/revoked and deleted
+                                logger.trace("The access token [{}] is expired and already deleted", userTokenId);
+                                listener.onResponse(null);
                             }
                         }, e -> {
                             // if the index or the shard is not there / available we assume that
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
index 98f09ef631e90..d56365a21a403 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
@@ -7,6 +7,7 @@
 
 import org.apache.directory.api.util.Strings;
 import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.admin.cluster.state.ClusterStateResponse;
 import org.elasticsearch.action.admin.indices.refresh.RefreshRequest;
 import org.elasticsearch.action.search.SearchRequest;
@@ -23,6 +24,7 @@
 import org.elasticsearch.client.security.InvalidateTokenRequest;
 import org.elasticsearch.client.security.InvalidateTokenResponse;
 import org.elasticsearch.cluster.ack.ClusterStateUpdateResponse;
+import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -171,6 +173,7 @@ public void testExpiredTokensDeletedAfterExpiration() throws Exception {
                     restClient.security().invalidateToken(new InvalidateTokenRequest("fooobar", null, null, null),
                         SECURITY_REQUEST_OPTIONS));
                 assertThat(e.getMessage(), containsString("token malformed"));
+                assertThat(e.status(), equalTo(RestStatus.UNAUTHORIZED));
             }
             restClient.indices().refresh(new RefreshRequest(RestrictedIndicesNames.SECURITY_TOKENS_ALIAS), SECURITY_REQUEST_OPTIONS);
             SearchResponse searchResponse = restClient.search(new SearchRequest(RestrictedIndicesNames.SECURITY_TOKENS_ALIAS)
@@ -455,7 +458,36 @@ public void testClientCredentialsGrant() throws Exception {
 
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
             () -> restClient.security().authenticate(tokenAuthOptions));
-        assertEquals(RestStatus.UNAUTHORIZED, e.status());
+        assertThat(e.status(), equalTo(RestStatus.UNAUTHORIZED));
+    }
+
+    public void testAuthenticateWithWrongToken() throws Exception {
+        final RestHighLevelClient restClient = new TestRestHighLevelClient();
+        CreateTokenResponse response = restClient.security().createToken(CreateTokenRequest.passwordGrant(
+            SecuritySettingsSource.TEST_USER_NAME, SecuritySettingsSourceField.TEST_PASSWORD.toCharArray()), SECURITY_REQUEST_OPTIONS);
+        assertNotNull(response.getRefreshToken());
+        // First check that the correct access token works by getting cluster health with token
+        assertNoTimeout(client()
+            .filterWithHeader(Collections.singletonMap("Authorization", "Bearer " + response.getAccessToken()))
+            .admin().cluster().prepareHealth().get());
+        // Now attempt to authenticate with an invalid access token string
+        RequestOptions wrongAuthOptions =
+            RequestOptions.DEFAULT.toBuilder().addHeader("Authorization", "Bearer " + randomAlphaOfLengthBetween(0, 128)).build();
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
+            () -> restClient.security().authenticate(wrongAuthOptions));
+        assertThat(e.status(), equalTo(RestStatus.UNAUTHORIZED));
+        // Now attempt to authenticate with an invalid access token with valid structure (pre 7.2)
+        RequestOptions wrongAuthOptionsPre72 =
+            RequestOptions.DEFAULT.toBuilder().addHeader("Authorization", "Bearer " + generateAccessToken(Version.V_7_1_0)).build();
+        ElasticsearchStatusException e1 = expectThrows(ElasticsearchStatusException.class,
+            () -> restClient.security().authenticate(wrongAuthOptionsPre72));
+        assertThat(e1.status(), equalTo(RestStatus.UNAUTHORIZED));
+        // Now attempt to authenticate with an invalid access token with valid structure (after 7.2)
+        RequestOptions wrongAuthOptionsAfter72 =
+            RequestOptions.DEFAULT.toBuilder().addHeader("Authorization", "Bearer " + generateAccessToken(Version.V_7_4_0)).build();
+        ElasticsearchStatusException e2 = expectThrows(ElasticsearchStatusException.class,
+            () -> restClient.security().authenticate(wrongAuthOptionsAfter72));
+        assertThat(e2.status(), equalTo(RestStatus.UNAUTHORIZED));
     }
 
     @Before
@@ -476,4 +508,13 @@ public void testMetadataIsNotSentToClient() {
         ClusterStateResponse clusterStateResponse = client().admin().cluster().prepareState().setCustoms(true).get();
         assertFalse(clusterStateResponse.getState().customs().containsKey(TokenMetaData.TYPE));
     }
+
+    private String generateAccessToken(Version version) throws Exception {
+        TokenService tokenService = internalCluster().getInstance(TokenService.class);
+        String accessTokenString = UUIDs.randomBase64UUID();
+        if (version.onOrAfter(TokenService.VERSION_ACCESS_TOKENS_AS_UUIDS)) {
+            accessTokenString = TokenService.hashTokenString(accessTokenString);
+        }
+        return tokenService.prependVersionAndEncodeAccessToken(version, accessTokenString);
+    }
 }
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
index e8585d9c6cb97..f17bdc980bcaf 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
@@ -598,7 +598,7 @@ public void testMalformedToken() throws Exception {
         final int numBytes = randomIntBetween(1, TokenService.MINIMUM_BYTES + 32);
         final byte[] randomBytes = new byte[numBytes];
         random().nextBytes(randomBytes);
-        TokenService tokenService = createTokenService(Settings.EMPTY, systemUTC());
+        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
 
         ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
         storeTokenHeader(requestContext, Base64.getEncoder().encodeToString(randomBytes));
@@ -610,6 +610,36 @@ public void testMalformedToken() throws Exception {
         }
     }
 
+    public void testNotValidPre72Tokens() throws Exception {
+        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+        // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
+        Authentication authentication = new Authentication(new User("joe", "admin"), new RealmRef("native_realm", "native", "node1"), null);
+        mockGetTokenFromId(tokenService, UUIDs.randomBase64UUID(), authentication, false);
+        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
+        storeTokenHeader(requestContext, generateAccessToken(tokenService, Version.V_7_1_0));
+
+        try (ThreadContext.StoredContext ignore = requestContext.newStoredContext(true)) {
+            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
+            tokenService.getAndValidateToken(requestContext, future);
+            assertNull(future.get());
+        }
+    }
+
+    public void testNotValidAfter72Tokens() throws Exception {
+        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+        // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
+        Authentication authentication = new Authentication(new User("joe", "admin"), new RealmRef("native_realm", "native", "node1"), null);
+        mockGetTokenFromId(tokenService, UUIDs.randomBase64UUID(), authentication, false);
+        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
+        storeTokenHeader(requestContext, generateAccessToken(tokenService, randomFrom(Version.V_7_2_0, Version.V_7_3_2)));
+
+        try (ThreadContext.StoredContext ignore = requestContext.newStoredContext(true)) {
+            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
+            tokenService.getAndValidateToken(requestContext, future);
+            assertNull(future.get());
+        }
+    }
+
     public void testIndexNotAvailable() throws Exception {
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
         Authentication authentication = new Authentication(new User("joe", "admin"), new RealmRef("native_realm", "native", "node1"), null);
@@ -821,4 +851,12 @@ private DiscoveryNode addAnotherDataNodeWithVersion(ClusterService clusterServic
         return anotherDataNode;
     }
 
+    private String generateAccessToken(TokenService tokenService, Version version) throws Exception {
+        String accessTokenString = UUIDs.randomBase64UUID();
+        if (version.onOrAfter(TokenService.VERSION_ACCESS_TOKENS_AS_UUIDS)) {
+            accessTokenString = TokenService.hashTokenString(accessTokenString);
+        }
+        return tokenService.prependVersionAndEncodeAccessToken(version, accessTokenString);
+    }
+
 }

From e80752eeb044593c71907317307206d7282dd205 Mon Sep 17 00:00:00 2001
From: Costin Leau <costin@users.noreply.github.com>
Date: Fri, 6 Dec 2019 18:09:56 +0200
Subject: [PATCH 098/686] Refactor usage of NamedExpression (#49693)

To recap, Attributes form the properties of a derived table.
Each LogicalPlan has Attributes as output since each one can be part of a
query and as such its result are sent to its consumer.
This change essentially removes the name id comparison so any changes
applied to existing expressions should work as long as the said expressions
are semantically equivalent.
This change enforces the hashCode and equals which has the side-effect
of using hashCode as identifiers for each expression.
By removing any property from an Attribute, the various components need
to look the original source for comparison which, while annoying, should
prevent a reference from getting out of sync with its source due to
optimizations.

Essentially going forward there are only 3 types of NamedExpressions:

Alias - user define (implicit or explicit) name
FieldAttribute - field backed by Elasticsearch
ReferenceAttribute - a reference to another source acting as an
Attribute. Typically the Attribute of an Alias.

* Remove the usage of NamedExpression as basis for all Expressions.
Instead, restrict their use only for named context, such as projections
by using Aliasing instead.
* Remove different types of Attributes and allow only FieldAttribute,
UnresolvedAttribute and ReferenceAttribute. To avoid issues with
rewrites, resolve the references inside the QueryContainer so the
information always stays on the source.
* Side-effect, simplify the rules as the state for InnerAggs doesn't have
to be contained anymore.
* Improve ResolveMissingRef rule to handle references to named
non-singular expression tree against the same expression used up the
tree.
---
 .../sql/qa/single_node/CliExplainIT.java      |   24 +-
 .../xpack/sql/qa/rest/RestSqlTestCase.java    |   60 +-
 .../sql/qa/src/main/resources/agg.csv-spec    |   24 +-
 .../sql/qa/src/main/resources/math.csv-spec   |    4 +-
 .../xpack/sql/analysis/analyzer/Analyzer.java |  215 ++-
 .../xpack/sql/analysis/analyzer/Verifier.java |  114 +-
 .../xpack/sql/execution/search/Querier.java   |    9 +-
 .../xpack/sql/expression/Alias.java           |   36 +-
 .../xpack/sql/expression/Attribute.java       |   56 +-
 .../xpack/sql/expression/AttributeMap.java    |   12 +-
 .../xpack/sql/expression/Exists.java          |    2 +-
 .../xpack/sql/expression/Expression.java      |    9 +-
 .../xpack/sql/expression/Expressions.java     |   69 +-
 .../xpack/sql/expression/FieldAttribute.java  |   10 +-
 .../xpack/sql/expression/Literal.java         |   69 +-
 .../sql/expression/LiteralAttribute.java      |   49 -
 .../{ExpressionId.java => NameId.java}        |   14 +-
 .../xpack/sql/expression/NamedExpression.java |   36 +-
 .../xpack/sql/expression/Order.java           |    2 +-
 .../sql/expression/ReferenceAttribute.java    |   41 +
 .../xpack/sql/expression/ScalarSubquery.java  |    2 +-
 .../sql/expression/SubQueryExpression.java    |    8 +-
 .../xpack/sql/expression/TypedAttribute.java  |    2 +-
 .../xpack/sql/expression/UnresolvedAlias.java |   13 +-
 .../sql/expression/UnresolvedAttribute.java   |   17 +-
 .../expression/UnresolvedNamedExpression.java |   10 +-
 .../xpack/sql/expression/UnresolvedStar.java  |   11 +-
 .../sql/expression/function/Function.java     |   71 +-
 .../function/FunctionAttribute.java           |   39 -
 .../sql/expression/function/Functions.java    |   15 -
 .../xpack/sql/expression/function/Score.java  |    8 +-
 .../expression/function/ScoreAttribute.java   |   58 -
 .../function/UnresolvedFunction.java          |   17 +-
 .../function/aggregate/AggregateFunction.java |   37 +-
 .../aggregate/AggregateFunctionAttribute.java |   94 --
 .../expression/function/aggregate/Count.java  |   43 +-
 .../function/aggregate/InnerAggregate.java    |   34 +-
 .../function/grouping/GroupingFunction.java   |   13 +-
 .../grouping/GroupingFunctionAttribute.java   |   56 -
 .../function/scalar/ScalarFunction.java       |   11 -
 .../scalar/ScalarFunctionAttribute.java       |   95 --
 .../function/scalar/UnaryScalarFunction.java  |    7 +-
 .../scalar/datetime/BaseDateTimeFunction.java |   10 +-
 .../function/scalar/geo/StWkttosql.java       |    2 +-
 .../expression/function/scalar/math/E.java    |    2 +-
 .../expression/function/scalar/math/Pi.java   |    2 +-
 .../function/scalar/string/Concat.java        |    4 +-
 .../xpack/sql/expression/gen/script/Agg.java  |   38 +-
 .../sql/expression/gen/script/Grouping.java   |    8 +-
 .../expression/gen/script/ParamsBuilder.java  |    8 +-
 .../expression/gen/script/ScriptWeaver.java   |   44 +-
 .../expression/predicate/BinaryPredicate.java |    5 +
 .../xpack/sql/expression/predicate/Range.java |   26 -
 .../predicate/conditional/IfConditional.java  |   27 +-
 .../predicate/operator/comparison/In.java     |    2 +-
 .../xpack/sql/optimizer/Optimizer.java        | 1194 +++++++----------
 .../xpack/sql/parser/ExpressionBuilder.java   |    7 +-
 .../xpack/sql/plan/logical/Pivot.java         |  119 +-
 .../xpack/sql/plan/logical/SubQueryAlias.java |    9 +-
 .../xpack/sql/planner/QueryFolder.java        |  436 ++++--
 .../xpack/sql/planner/QueryTranslator.java    |  360 +----
 .../xpack/sql/querydsl/agg/Aggs.java          |   15 +-
 .../sql/querydsl/container/AggregateSort.java |   46 +
 .../querydsl/container/QueryContainer.java    |  174 +--
 .../elasticsearch/xpack/sql/tree/Node.java    |   30 +-
 .../analyzer/VerifierErrorMessagesTests.java  |    6 +-
 .../search/SourceGeneratorTests.java          |   13 +-
 .../sql/expression/AttributeMapTests.java     |    4 +-
 .../sql/expression/ExpressionIdTests.java     |    4 +-
 .../xpack/sql/expression/LiteralTests.java    |    2 +-
 .../expression/UnresolvedAttributeTests.java  |    4 +-
 .../scalar/DatabaseFunctionTests.java         |    8 +-
 .../function/scalar/UserFunctionTests.java    |   14 +-
 .../predicate/conditional/CaseTests.java      |    6 +-
 .../predicate/conditional/IifTests.java       |    4 -
 .../xpack/sql/optimizer/OptimizerTests.java   |  175 ++-
 .../xpack/sql/parser/ExpressionTests.java     |   12 +-
 .../xpack/sql/parser/SqlParserTests.java      |   32 +-
 .../xpack/sql/planner/QueryFolderTests.java   |   94 +-
 .../sql/planner/QueryTranslatorTests.java     |   53 +-
 .../container/QueryContainerTests.java        |    9 +-
 81 files changed, 1946 insertions(+), 2578 deletions(-)
 delete mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/LiteralAttribute.java
 rename x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/{ExpressionId.java => NameId.java} (77%)
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ReferenceAttribute.java
 delete mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionAttribute.java
 delete mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/ScoreAttribute.java
 delete mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunctionAttribute.java
 delete mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunctionAttribute.java
 delete mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunctionAttribute.java
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AggregateSort.java

diff --git a/x-pack/plugin/sql/qa/single-node/src/test/java/org/elasticsearch/xpack/sql/qa/single_node/CliExplainIT.java b/x-pack/plugin/sql/qa/single-node/src/test/java/org/elasticsearch/xpack/sql/qa/single_node/CliExplainIT.java
index af52e50348c1b..c7069f18e0265 100644
--- a/x-pack/plugin/sql/qa/single-node/src/test/java/org/elasticsearch/xpack/sql/qa/single_node/CliExplainIT.java
+++ b/x-pack/plugin/sql/qa/single-node/src/test/java/org/elasticsearch/xpack/sql/qa/single_node/CliExplainIT.java
@@ -19,19 +19,19 @@ public void testExplainBasic() throws IOException {
         assertThat(command("EXPLAIN (PLAN PARSED) SELECT * FROM test"), containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
         assertThat(readLine(), startsWith("With[{}]"));
-        assertThat(readLine(), startsWith("\\_Project[[?*]]"));
+        assertThat(readLine(), startsWith("\\_Project[[?* AS ?]]"));
         assertThat(readLine(), startsWith("  \\_UnresolvedRelation[test]"));
         assertEquals("", readLine());
 
         assertThat(command("EXPLAIN " + (randomBoolean() ? "" : "(PLAN ANALYZED) ") + "SELECT * FROM test"), containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
-        assertThat(readLine(), startsWith("Project[[test_field{f}#"));
+        assertThat(readLine(), startsWith("Project[[test.test_field{f}#"));
         assertThat(readLine(), startsWith("\\_EsRelation[test][test_field{f}#"));
         assertEquals("", readLine());
 
         assertThat(command("EXPLAIN (PLAN OPTIMIZED) SELECT * FROM test"), containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
-        assertThat(readLine(), startsWith("Project[[test_field{f}#"));
+        assertThat(readLine(), startsWith("Project[[test.test_field{f}#"));
         assertThat(readLine(), startsWith("\\_EsRelation[test][test_field{f}#"));
         assertEquals("", readLine());
 
@@ -63,23 +63,23 @@ public void testExplainWithWhere() throws IOException {
         assertThat(command("EXPLAIN (PLAN PARSED) SELECT * FROM test WHERE i = 2"), containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
         assertThat(readLine(), startsWith("With[{}]"));
-        assertThat(readLine(), startsWith("\\_Project[[?*]]"));
-        assertThat(readLine(), startsWith("  \\_Filter[Equals[?i,2"));
+        assertThat(readLine(), startsWith("\\_Project[[?* AS ?]]"));
+        assertThat(readLine(), startsWith("  \\_Filter[?i == 2[INTEGER]]"));
         assertThat(readLine(), startsWith("    \\_UnresolvedRelation[test]"));
         assertEquals("", readLine());
 
         assertThat(command("EXPLAIN " + (randomBoolean() ? "" : "(PLAN ANALYZED) ") + "SELECT * FROM test WHERE i = 2"),
                 containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
-        assertThat(readLine(), startsWith("Project[[i{f}#"));
-        assertThat(readLine(), startsWith("\\_Filter[Equals[i"));
+        assertThat(readLine(), startsWith("Project[[test.i{f}#"));
+        assertThat(readLine(), startsWith("\\_Filter[test.i{f}#"));
         assertThat(readLine(), startsWith("  \\_EsRelation[test][i{f}#"));
         assertEquals("", readLine());
 
         assertThat(command("EXPLAIN (PLAN OPTIMIZED) SELECT * FROM test WHERE i = 2"), containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
-        assertThat(readLine(), startsWith("Project[[i{f}#"));
-        assertThat(readLine(), startsWith("\\_Filter[Equals[i"));
+        assertThat(readLine(), startsWith("Project[[test.i{f}#"));
+        assertThat(readLine(), startsWith("\\_Filter[test.i{f}"));
         assertThat(readLine(), startsWith("  \\_EsRelation[test][i{f}#"));
         assertEquals("", readLine());
 
@@ -119,20 +119,20 @@ public void testExplainWithCount() throws IOException {
         assertThat(command("EXPLAIN (PLAN PARSED) SELECT COUNT(*) FROM test"), containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
         assertThat(readLine(), startsWith("With[{}]"));
-        assertThat(readLine(), startsWith("\\_Project[[?COUNT[?*]]]"));
+        assertThat(readLine(), startsWith("\\_Project[[?COUNT[?*] AS ?]]"));
         assertThat(readLine(), startsWith("  \\_UnresolvedRelation[test]"));
         assertEquals("", readLine());
 
         assertThat(command("EXPLAIN " + (randomBoolean() ? "" : "(PLAN ANALYZED) ") + "SELECT COUNT(*) FROM test"),
                 containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
-        assertThat(readLine(), startsWith("Aggregate[[],[Count[*=1"));
+        assertThat(readLine(), startsWith("Aggregate[[],[COUNT(*)"));
         assertThat(readLine(), startsWith("\\_EsRelation[test][i{f}#"));
         assertEquals("", readLine());
 
         assertThat(command("EXPLAIN (PLAN OPTIMIZED) SELECT COUNT(*) FROM test"), containsString("plan"));
         assertThat(readLine(), startsWith("----------"));
-        assertThat(readLine(), startsWith("Aggregate[[],[Count[*=1"));
+        assertThat(readLine(), startsWith("Aggregate[[],[COUNT(*)"));
         assertThat(readLine(), startsWith("\\_EsRelation[test][i{f}#"));
         assertEquals("", readLine());
 
diff --git a/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java b/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
index a313ddc771bf9..3215c6b35efdf 100644
--- a/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
+++ b/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
@@ -422,36 +422,36 @@ public void testPrettyPrintingEnabled() throws IOException {
         boolean columnar = randomBoolean();
         String expected = "";
         if (columnar) {
-            expected = "{\n" + 
-                    "  \"columns\" : [\n" + 
-                    "    {\n" + 
-                    "      \"name\" : \"test1\",\n" + 
-                    "      \"type\" : \"text\"\n" + 
-                    "    }\n" + 
-                    "  ],\n" + 
-                    "  \"values\" : [\n" + 
-                    "    [\n" + 
-                    "      \"test1\",\n" + 
-                    "      \"test2\"\n" + 
-                    "    ]\n" + 
-                    "  ]\n" + 
+            expected = "{\n" +
+                    "  \"columns\" : [\n" +
+                    "    {\n" +
+                    "      \"name\" : \"test1\",\n" +
+                    "      \"type\" : \"text\"\n" +
+                    "    }\n" +
+                    "  ],\n" +
+                    "  \"values\" : [\n" +
+                    "    [\n" +
+                    "      \"test1\",\n" +
+                    "      \"test2\"\n" +
+                    "    ]\n" +
+                    "  ]\n" +
                     "}\n";
         } else {
-            expected = "{\n" + 
-                    "  \"columns\" : [\n" + 
-                    "    {\n" + 
-                    "      \"name\" : \"test1\",\n" + 
-                    "      \"type\" : \"text\"\n" + 
-                    "    }\n" + 
-                    "  ],\n" + 
-                    "  \"rows\" : [\n" + 
-                    "    [\n" + 
-                    "      \"test1\"\n" + 
-                    "    ],\n" + 
-                    "    [\n" + 
-                    "      \"test2\"\n" + 
-                    "    ]\n" + 
-                    "  ]\n" + 
+            expected = "{\n" +
+                    "  \"columns\" : [\n" +
+                    "    {\n" +
+                    "      \"name\" : \"test1\",\n" +
+                    "      \"type\" : \"text\"\n" +
+                    "    }\n" +
+                    "  ],\n" +
+                    "  \"rows\" : [\n" +
+                    "    [\n" +
+                    "      \"test1\"\n" +
+                    "    ],\n" +
+                    "    [\n" +
+                    "      \"test2\"\n" +
+                    "    ]\n" +
+                    "  ]\n" +
                     "}\n";
         }
         executeAndAssertPrettyPrinting(expected, "true", columnar);
@@ -638,14 +638,14 @@ public void testTranslateQueryWithGroupByAndHaving() throws IOException {
         Map<String, Object> aggregations2 = (Map<String, Object>) groupby.get("aggregations");
         assertEquals(2, aggregations2.size());
 
-        List<Integer> aggKeys = new ArrayList<>(2);
+        List<String> aggKeys = new ArrayList<>(2);
         String aggFilterKey = null;
         for (Map.Entry<String, Object> entry : aggregations2.entrySet()) {
             String key = entry.getKey();
             if (key.startsWith("having")) {
                 aggFilterKey = key;
             } else {
-                aggKeys.add(Integer.valueOf(key));
+                aggKeys.add(key);
                 @SuppressWarnings("unchecked")
                 Map<String, Object> aggr = (Map<String, Object>) entry.getValue();
                 assertEquals(1, aggr.size());
diff --git a/x-pack/plugin/sql/qa/src/main/resources/agg.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/agg.csv-spec
index 182b6c2c76f39..ed1ae60b14c85 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/agg.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/agg.csv-spec
@@ -604,9 +604,31 @@ SELECT COUNT(ALL first_name) all_names, COUNT(*) c FROM test_emp;
 
    all_names   |       c
 ---------------+---------------
-90             |100
+90             |100 
 ;
 
+countDistinctAndLiteral
+schema::ln:l|ccc:l
+SELECT COUNT(last_name) ln, COUNT(*) ccc FROM test_emp GROUP BY gender HAVING ln>5 AND ccc>5;
+
+      ln       |     ccc     
+---------------+-------------
+10             |10           
+33             |33
+57             |57                
+;
+
+countSmallCountTypesWithHaving
+schema::ln:l|dln:l|fn:l|dfn:l|ccc:l
+SELECT COUNT(last_name) ln, COUNT(distinct last_name) dln, COUNT(first_name) fn, COUNT(distinct first_name) dfn, COUNT(*) ccc FROM test_emp GROUP BY gender HAVING dln>5 AND ln>32 AND dfn>1 AND fn>1 AND ccc>5;
+
+      ln       |     dln     |      fn       |     dfn    |      ccc
+---------------+-------------+---------------+------------+-------------
+33             |32           |32             |32          |33
+57             |54           |48             |48          |57
+;
+
+
 countAllCountTypesWithHaving
 schema::ln:l|dln:l|fn:l|dfn:l|ccc:l
 SELECT COUNT(last_name) ln, COUNT(distinct last_name) dln, COUNT(first_name) fn, COUNT(distinct first_name) dfn, COUNT(*) ccc FROM test_emp GROUP BY gender HAVING dln>5 AND ln>32 AND dfn>1 AND fn>1 AND ccc>5;
diff --git a/x-pack/plugin/sql/qa/src/main/resources/math.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/math.csv-spec
index 372614dcb0052..a333de34987c1 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/math.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/math.csv-spec
@@ -64,8 +64,8 @@ SELECT TRUNC(salary, 2) TRUNCATED, salary FROM test_emp GROUP BY TRUNCATED, sala
 truncateWithAsciiAndOrderBy
 SELECT TRUNCATE(ASCII(LEFT(first_name,1)), -1) AS initial, first_name, ASCII(LEFT(first_name, 1)) FROM test_emp ORDER BY ASCII(LEFT(first_name, 1)) DESC LIMIT 15;
 
-    initial    |  first_name   |ASCII(LEFT(first_name,1))
----------------+---------------+-------------------------
+    initial    |  first_name   |ASCII(LEFT(first_name, 1))
+---------------+---------------+--------------------------
 90             |Zvonko         |90                       
 90             |Zhongwei       |90                       
 80             |Yongqiao       |89                       
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
index c790626c5fbcb..030d059ccfbd2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
@@ -19,6 +19,7 @@
 import org.elasticsearch.xpack.sql.expression.Foldables;
 import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.Order;
+import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
 import org.elasticsearch.xpack.sql.expression.SubQueryExpression;
 import org.elasticsearch.xpack.sql.expression.UnresolvedAlias;
 import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
@@ -28,10 +29,8 @@
 import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
 import org.elasticsearch.xpack.sql.expression.function.Functions;
 import org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
 import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.ArithmeticOperation;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RegexMatch;
 import org.elasticsearch.xpack.sql.plan.TableIdentifier;
 import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
 import org.elasticsearch.xpack.sql.plan.logical.EsRelation;
@@ -66,7 +65,7 @@
 import java.util.Map;
 import java.util.Objects;
 import java.util.Set;
-import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 import static java.util.Collections.emptyList;
 import static java.util.Collections.singletonList;
@@ -329,12 +328,13 @@ else if (plan instanceof Aggregate) {
                     return new Aggregate(a.source(), a.child(), a.groupings(),
                             expandProjections(a.aggregates(), a.child()));
                 }
-                // if the grouping is unresolved but the aggs are, use the latter to resolve the former
+                // if the grouping is unresolved but the aggs are, use the former to resolve the latter
                 // solves the case of queries declaring an alias in SELECT and referring to it in GROUP BY
+                // e.g. SELECT x AS a ... GROUP BY a
                 if (!a.expressionsResolved() && Resolvables.resolved(a.aggregates())) {
                     List<Expression> groupings = a.groupings();
                     List<Expression> newGroupings = new ArrayList<>();
-                    AttributeMap<Expression> resolved = Expressions.asAttributeMap(a.aggregates());
+                    AttributeMap<Expression> resolved = Expressions.aliases(a.aggregates());
                     boolean changed = false;
                     for (Expression grouping : groupings) {
                         if (grouping instanceof UnresolvedAttribute) {
@@ -363,9 +363,10 @@ else if (plan instanceof Join) {
             else if (plan instanceof OrderBy) {
                 OrderBy o = (OrderBy) plan;
                 if (!o.resolved()) {
-                    List<Order> resolvedOrder = o.order().stream()
-                            .map(or -> resolveExpression(or, o.child()))
-                            .collect(toList());
+                    List<Order> resolvedOrder = new ArrayList<>(o.order().size());
+                    for (Order order : o.order()) {
+                        resolvedOrder.add(resolveExpression(order, o.child()));
+                    }
                     return new OrderBy(o.source(), o.child(), resolvedOrder);
                 }
             }
@@ -606,19 +607,53 @@ protected LogicalPlan rule(LogicalPlan plan) {
 
             if (plan instanceof OrderBy && !plan.resolved() && plan.childrenResolved()) {
                 OrderBy o = (OrderBy) plan;
-                List<Order> maybeResolved = o.order().stream()
-                        .map(or -> tryResolveExpression(or, o.child()))
-                        .collect(toList());
-
+                LogicalPlan child = o.child();
+                List<Order> maybeResolved = new ArrayList<>();
+                for (Order or : o.order()) {
+                    maybeResolved.add(or.resolved() ? or : tryResolveExpression(or, child));
+                }
+                
+                Stream<Order> referencesStream = maybeResolved.stream()
+                        .filter(Expression::resolved);
+
+                // if there are any references in the output
+                // try and resolve them to the source in order to compare the source expressions
+                // e.g. ORDER BY a + 1
+                //      \ SELECT a + 1
+                // a + 1 in SELECT is actually Alias("a + 1", a + 1) and translates to ReferenceAttribute
+                // in the output. However it won't match the unnamed a + 1 despite being the same expression
+                // so explicitly compare the source
+                
+                // if there's a match, remove the item from the reference stream
+                if (Expressions.hasReferenceAttribute(child.outputSet())) {
+                    final Map<Attribute, Expression> collectRefs = new LinkedHashMap<>();
+
+                    // collect aliases
+                    child.forEachUp(p -> p.forEachExpressionsUp(e -> {
+                        if (e instanceof Alias) {
+                            Alias a = (Alias) e;
+                            collectRefs.put(a.toAttribute(), a.child());
+                        }
+                    }));
+
+                    referencesStream = referencesStream.filter(r -> {
+                        for (Attribute attr : child.outputSet()) {
+                            if (attr instanceof ReferenceAttribute) {
+                                Expression source = collectRefs.getOrDefault(attr, attr);
+                                // found a match, no need to resolve it further
+                                // so filter it out
+                                if (source.equals(r.child())) {
+                                    return false;
+                                }
+                            }
+                        }
+                        return true;
+                    });
+                }
 
-                Set<Expression> resolvedRefs = maybeResolved.stream()
-                    .filter(Expression::resolved)
-                    .collect(Collectors.toSet());
+                AttributeSet resolvedRefs = Expressions.references(referencesStream.collect(toList()));
 
-                AttributeSet missing = Expressions.filterReferences(
-                    resolvedRefs,
-                    o.child().outputSet()
-                );
+                AttributeSet missing = resolvedRefs.subtract(child.outputSet());
 
                 if (!missing.isEmpty()) {
                     // Add missing attributes but project them away afterwards
@@ -650,6 +685,7 @@ protected LogicalPlan rule(LogicalPlan plan) {
             if (plan instanceof Filter && !plan.resolved() && plan.childrenResolved()) {
                 Filter f = (Filter) plan;
                 Expression maybeResolved = tryResolveExpression(f.condition(), f.child());
+
                 AttributeSet resolvedRefs = new AttributeSet(maybeResolved.references().stream()
                         .filter(Expression::resolved)
                         .collect(toList()));
@@ -708,9 +744,11 @@ private static LogicalPlan propagateMissing(LogicalPlan plan, AttributeSet missi
             if (plan instanceof Aggregate) {
                 Aggregate a = (Aggregate) plan;
                 // missing attributes can only be grouping expressions
+                // however take into account aliased groups
+                // SELECT x AS i ... GROUP BY i
                 for (Attribute m : missing) {
-                    // but we don't can't add an agg if the group is missing
-                    if (!Expressions.anyMatch(a.groupings(), m::semanticEquals)) {
+                    // but we can't add an agg if the group is missing
+                    if (!Expressions.match(a.groupings(), m::semanticEquals)) {
                         if (m instanceof Attribute) {
                             // pass failure information to help the verifier
                             m = new UnresolvedAttribute(m.source(), m.name(), m.qualifier(), null, null,
@@ -758,7 +796,7 @@ private static UnresolvedAttribute resolveMetadataToMessage(UnresolvedAttribute
     // SELECT int AS i FROM t WHERE i > 10
     //
     // As such, identify all project and aggregates that have a Filter child
-    // and look at any resoled aliases that match and replace them.
+    // and look at any resolved aliases that match and replace them.
     private class ResolveFilterRefs extends AnalyzeRule<LogicalPlan> {
 
         @Override
@@ -815,49 +853,10 @@ private Expression replaceAliases(Expression condition, List<? extends NamedExpr
         }
     }
 
-    // to avoid creating duplicate functions
-    // this rule does two iterations
-    // 1. collect all functions
-    // 2. search unresolved functions and first try resolving them from already 'seen' functions
     private class ResolveFunctions extends AnalyzeRule<LogicalPlan> {
 
         @Override
         protected LogicalPlan rule(LogicalPlan plan) {
-            Map<String, List<Function>> seen = new LinkedHashMap<>();
-            // collect (and replace duplicates)
-            LogicalPlan p = plan.transformExpressionsUp(e -> collectResolvedAndReplace(e, seen));
-            // resolve based on seen
-            return resolve(p, seen);
-        }
-
-        private Expression collectResolvedAndReplace(Expression e, Map<String, List<Function>> seen) {
-            if (e instanceof Function && e.resolved()) {
-                Function f = (Function) e;
-                String fName = f.functionName();
-                // the function is resolved and its name normalized already
-                List<Function> list = getList(seen, fName);
-                for (Function seenFunction : list) {
-                    if (seenFunction != f && f.arguments().equals(seenFunction.arguments())) {
-                        // TODO: we should move to always compare the functions directly
-                        // Special check for COUNT: an already seen COUNT function will be returned only if its DISTINCT property
-                        // matches the one from the unresolved function to be checked.
-                        // Same for LIKE/RLIKE: the equals function also compares the pattern of LIKE/RLIKE
-                        if (seenFunction instanceof Count || seenFunction instanceof RegexMatch) {
-                            if (seenFunction.equals(f)){
-                                return seenFunction;
-                            }
-                        } else {
-                            return seenFunction;
-                        }
-                    }
-                }
-                list.add(f);
-            }
-
-            return e;
-        }
-
-        protected LogicalPlan resolve(LogicalPlan plan, Map<String, List<Function>> seen) {
             return plan.transformExpressionsUp(e -> {
                 if (e instanceof UnresolvedFunction) {
                     UnresolvedFunction uf = (UnresolvedFunction) e;
@@ -880,48 +879,17 @@ protected LogicalPlan resolve(LogicalPlan plan, Map<String, List<Function>> seen
                     }
 
                     String functionName = functionRegistry.resolveAlias(name);
-
-                    List<Function> list = getList(seen, functionName);
-                    // first try to resolve from seen functions
-                    if (!list.isEmpty()) {
-                        for (Function seenFunction : list) {
-                            if (uf.arguments().equals(seenFunction.arguments())) {
-                                // Special check for COUNT: an already seen COUNT function will be returned only if its DISTINCT property
-                                // matches the one from the unresolved function to be checked.
-                                if (seenFunction instanceof Count) {
-                                    if (uf.sameAs((Count) seenFunction)) {
-                                        return seenFunction;
-                                    }
-                                } else {
-                                    return seenFunction;
-                                }
-                            }
-                        }
-                    }
-
-                    // not seen before, use the registry
-                    if (!functionRegistry.functionExists(functionName)) {
+                    if (functionRegistry.functionExists(functionName) == false) {
                         return uf.missing(functionName, functionRegistry.listFunctions());
                     }
                     // TODO: look into Generator for significant terms, etc..
                     FunctionDefinition def = functionRegistry.resolveFunction(functionName);
                     Function f = uf.buildResolved(configuration, def);
-
-                    list.add(f);
                     return f;
                 }
                 return e;
             });
         }
-
-        private List<Function> getList(Map<String, List<Function>> seen, String name) {
-            List<Function> list = seen.get(name);
-            if (list == null) {
-                list = new ArrayList<>();
-                seen.put(name, list);
-            }
-            return list;
-        }
     }
 
     private static class ResolveAliases extends AnalyzeRule<LogicalPlan> {
@@ -1103,11 +1071,12 @@ private Set<NamedExpression> findMissingAggregate(Aggregate target, Expression f
             Set<NamedExpression> missing = new LinkedHashSet<>();
 
             for (Expression filterAgg : from.collect(Functions::isAggregate)) {
-                if (!Expressions.anyMatch(target.aggregates(),
-                        a -> {
-                            Attribute attr = Expressions.attribute(a);
-                            return attr != null && attr.semanticEquals(Expressions.attribute(filterAgg));
-                        })) {
+                if (Expressions.anyMatch(target.aggregates(), a -> {
+                    if (a instanceof Alias) {
+                        a = ((Alias) a).child();
+                    }
+                    return a.equals(filterAgg);
+                }) == false) {
                     missing.add(Expressions.wrapAsNamed(filterAgg));
                 }
             }
@@ -1135,10 +1104,10 @@ protected LogicalPlan rule(OrderBy ob) {
             List<Order> orders = ob.order();
 
             // 1. collect aggs inside an order by
-            List<NamedExpression> aggs = new ArrayList<>();
+            List<Expression> aggs = new ArrayList<>();
             for (Order order : orders) {
                 if (Functions.isAggregate(order.child())) {
-                    aggs.add(Expressions.wrapAsNamed(order.child()));
+                    aggs.add(order.child());
                 }
             }
             if (aggs.isEmpty()) {
@@ -1154,9 +1123,14 @@ protected LogicalPlan rule(OrderBy ob) {
 
                     List<NamedExpression> missing = new ArrayList<>();
 
-                    for (NamedExpression orderedAgg : aggs) {
-                        if (Expressions.anyMatch(a.aggregates(), e -> Expressions.equalsAsAttribute(e, orderedAgg)) == false) {
-                            missing.add(orderedAgg);
+                    for (Expression orderedAgg : aggs) {
+                        if (Expressions.anyMatch(a.aggregates(), e -> {
+                            if (e instanceof Alias) {
+                                e = ((Alias) e).child();
+                            }
+                            return e.equals(orderedAgg);
+                        }) == false) {
+                            missing.add(Expressions.wrapAsNamed(orderedAgg));
                         }
                     }
                     // agg already contains all aggs
@@ -1176,39 +1150,6 @@ protected LogicalPlan rule(OrderBy ob) {
         }
     }
 
-    private class PruneDuplicateFunctions extends AnalyzeRule<LogicalPlan> {
-
-        @Override
-        protected boolean skipResolved() {
-            return false;
-        }
-
-        @Override
-        public LogicalPlan rule(LogicalPlan plan) {
-            List<Function> seen = new ArrayList<>();
-            LogicalPlan p = plan.transformExpressionsUp(e -> rule(e, seen));
-            return p;
-        }
-
-        private Expression rule(Expression e, List<Function> seen) {
-            if (e instanceof Function) {
-                Function f = (Function) e;
-                for (Function seenFunction : seen) {
-                    if (seenFunction != f && functionsEquals(f, seenFunction)) {
-                        return seenFunction;
-                    }
-                }
-                seen.add(f);
-            }
-
-            return e;
-        }
-
-        private boolean functionsEquals(Function f, Function seenFunction) {
-            return f.sourceText().equals(seenFunction.sourceText()) && f.arguments().equals(seenFunction.arguments());
-        }
-    }
-
     private class ImplicitCasting extends AnalyzeRule<LogicalPlan> {
 
         @Override
@@ -1282,7 +1223,7 @@ protected LogicalPlan rule(LogicalPlan plan) {
 
             if (plan instanceof Aggregate) {
                 Aggregate a = (Aggregate) plan;
-                // aliases inside GROUP BY are irellevant so remove all of them
+                // aliases inside GROUP BY are irrelevant so remove all of them
                 // however aggregations are important (ultimately a projection)
                 return new Aggregate(a.source(), a.child(), cleanAllAliases(a.groupings()), cleanChildrenAliases(a.aggregates()));
             }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Verifier.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Verifier.java
index 3f5caa064a2ed..34def1238d00f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Verifier.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Verifier.java
@@ -8,6 +8,7 @@
 import org.elasticsearch.xpack.sql.capabilities.Unresolvable;
 import org.elasticsearch.xpack.sql.expression.Alias;
 import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.sql.expression.AttributeMap;
 import org.elasticsearch.xpack.sql.expression.AttributeSet;
 import org.elasticsearch.xpack.sql.expression.Exists;
 import org.elasticsearch.xpack.sql.expression.Expression;
@@ -15,18 +16,16 @@
 import org.elasticsearch.xpack.sql.expression.FieldAttribute;
 import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.NamedExpression;
+import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
 import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
 import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.FunctionAttribute;
 import org.elasticsearch.xpack.sql.expression.function.Functions;
 import org.elasticsearch.xpack.sql.expression.function.Score;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunctionAttribute;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Max;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Min;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
 import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunctionAttribute;
 import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
 import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
 import org.elasticsearch.xpack.sql.plan.logical.Distinct;
@@ -215,8 +214,19 @@ Collection<Failure> verify(LogicalPlan plan) {
         // if there are no (major) unresolved failures, do more in-depth analysis
 
         if (failures.isEmpty()) {
-            // collect Function to better reason about encountered attributes
-            Map<String, Function> resolvedFunctions = Functions.collectFunctions(plan);
+            final Map<Attribute, Expression> collectRefs = new LinkedHashMap<>();
+
+            // collect Attribute sources
+            // only Aliases are interesting since these are the only ones that hide expressions
+            // FieldAttribute for example are self replicating.
+            plan.forEachUp(p -> p.forEachExpressionsUp(e -> {
+                if (e instanceof Alias) {
+                    Alias a = (Alias) e;
+                    collectRefs.put(a.toAttribute(), a.child());
+                }
+            }));
+
+            AttributeMap<Expression> attributeRefs = new AttributeMap<>(collectRefs);
 
             // for filtering out duplicated errors
             final Set<LogicalPlan> groupingFailures = new LinkedHashSet<>();
@@ -234,17 +244,17 @@ Collection<Failure> verify(LogicalPlan plan) {
                 Set<Failure> localFailures = new LinkedHashSet<>();
 
                 checkGroupingFunctionInGroupBy(p, localFailures);
-                checkFilterOnAggs(p, localFailures);
-                checkFilterOnGrouping(p, localFailures);
+                checkFilterOnAggs(p, localFailures, attributeRefs);
+                checkFilterOnGrouping(p, localFailures, attributeRefs);
 
-                if (!groupingFailures.contains(p)) {
-                    checkGroupBy(p, localFailures, resolvedFunctions, groupingFailures);
+                if (groupingFailures.contains(p) == false) {
+                    checkGroupBy(p, localFailures, attributeRefs, groupingFailures);
                 }
 
                 checkForScoreInsideFunctions(p, localFailures);
                 checkNestedUsedInGroupByOrHaving(p, localFailures);
                 checkForGeoFunctionsOnDocValues(p, localFailures);
-                checkPivot(p, localFailures);
+                checkPivot(p, localFailures, attributeRefs);
 
                 // everything checks out
                 // mark the plan as analyzed
@@ -297,17 +307,18 @@ Collection<Failure> verify(LogicalPlan plan) {
      * 2a. HAVING also requires an Aggregate function
      * 3. composite agg (used for GROUP BY) allows ordering only on the group keys
      */
-    private static boolean checkGroupBy(LogicalPlan p, Set<Failure> localFailures,
-            Map<String, Function> resolvedFunctions, Set<LogicalPlan> groupingFailures) {
+    private static boolean checkGroupBy(LogicalPlan p, Set<Failure> localFailures, AttributeMap<Expression> attributeRefs,
+            Set<LogicalPlan> groupingFailures) {
         return checkGroupByInexactField(p, localFailures)
-                && checkGroupByAgg(p, localFailures, resolvedFunctions)
-                && checkGroupByOrder(p, localFailures, groupingFailures)
-                && checkGroupByHaving(p, localFailures, groupingFailures, resolvedFunctions)
+                && checkGroupByAgg(p, localFailures, attributeRefs)
+                && checkGroupByOrder(p, localFailures, groupingFailures, attributeRefs)
+                && checkGroupByHaving(p, localFailures, groupingFailures, attributeRefs)
                 && checkGroupByTime(p, localFailures);
     }
 
     // check whether an orderBy failed or if it occurs on a non-key
-    private static boolean checkGroupByOrder(LogicalPlan p, Set<Failure> localFailures, Set<LogicalPlan> groupingFailures) {
+    private static boolean checkGroupByOrder(LogicalPlan p, Set<Failure> localFailures, Set<LogicalPlan> groupingFailures,
+            AttributeMap<Expression> attributeRefs) {
         if (p instanceof OrderBy) {
             OrderBy o = (OrderBy) p;
             LogicalPlan child = o.child();
@@ -328,7 +339,7 @@ private static boolean checkGroupByOrder(LogicalPlan p, Set<Failure> localFailur
                     Expression e = oe.child();
 
                     // aggregates are allowed
-                    if (Functions.isAggregate(e) || e instanceof AggregateFunctionAttribute) {
+                    if (Functions.isAggregate(attributeRefs.getOrDefault(e, e))) {
                         return;
                     }
 
@@ -375,7 +386,7 @@ private static boolean checkGroupByOrder(LogicalPlan p, Set<Failure> localFailur
     }
 
     private static boolean checkGroupByHaving(LogicalPlan p, Set<Failure> localFailures,
-            Set<LogicalPlan> groupingFailures, Map<String, Function> functions) {
+            Set<LogicalPlan> groupingFailures, AttributeMap<Expression> attributeRefs) {
         if (p instanceof Filter) {
             Filter f = (Filter) p;
             if (f.child() instanceof Aggregate) {
@@ -385,7 +396,7 @@ private static boolean checkGroupByHaving(LogicalPlan p, Set<Failure> localFailu
                 Set<Expression> unsupported = new LinkedHashSet<>();
                 Expression condition = f.condition();
                 // variation of checkGroupMatch customized for HAVING, which requires just aggregations
-                condition.collectFirstChildren(c -> checkGroupByHavingHasOnlyAggs(c, missing, unsupported, functions));
+                condition.collectFirstChildren(c -> checkGroupByHavingHasOnlyAggs(c, missing, unsupported, attributeRefs));
 
                 if (!missing.isEmpty()) {
                     String plural = missing.size() > 1 ? "s" : StringUtils.EMPTY;
@@ -411,17 +422,11 @@ private static boolean checkGroupByHaving(LogicalPlan p, Set<Failure> localFailu
 
 
     private static boolean checkGroupByHavingHasOnlyAggs(Expression e, Set<Expression> missing,
-                                                         Set<Expression> unsupported, Map<String, Function> functions) {
+            Set<Expression> unsupported, AttributeMap<Expression> attributeRefs) {
 
         // resolve FunctionAttribute to backing functions
-        if (e instanceof FunctionAttribute) {
-            FunctionAttribute fa = (FunctionAttribute) e;
-            Function function = functions.get(fa.functionId());
-            // TODO: this should be handled by a different rule
-            if (function == null) {
-                return false;
-            }
-            e = function;
+        if (e instanceof ReferenceAttribute) {
+            e = attributeRefs.get(e);
         }
 
         // scalar functions can be a binary tree
@@ -432,7 +437,7 @@ private static boolean checkGroupByHavingHasOnlyAggs(Expression e, Set<Expressio
 
             // unwrap function to find the base
             for (Expression arg : sf.arguments()) {
-                arg.collectFirstChildren(c -> checkGroupByHavingHasOnlyAggs(c, missing, unsupported, functions));
+                arg.collectFirstChildren(c -> checkGroupByHavingHasOnlyAggs(c, missing, unsupported, attributeRefs));
             }
             return true;
 
@@ -449,7 +454,7 @@ private static boolean checkGroupByHavingHasOnlyAggs(Expression e, Set<Expressio
                 // Min & Max on a Keyword field will be translated to First & Last respectively
                 unsupported.add(e);
                 return true;
-        }
+            }
         }
 
         // skip literals / foldable
@@ -482,22 +487,26 @@ private static boolean onlyExactFields(List<Expression> expressions, Set<Failure
         Holder<Boolean> onlyExact = new Holder<>(Boolean.TRUE);
 
         expressions.forEach(e -> e.forEachUp(c -> {
-            EsField.Exact exact = c.getExactInfo();
-            if (exact.hasExact() == false) {
+                EsField.Exact exact = c.getExactInfo();
+                if (exact.hasExact() == false) {
                 localFailures.add(fail(c, "Field [{}] of data type [{}] cannot be used for grouping; {}", c.sourceText(),
                         c.dataType().typeName, exact.errorMsg()));
                 onlyExact.set(Boolean.FALSE);
-            }
-        }, FieldAttribute.class));
+                }
+            }, FieldAttribute.class));
 
         return onlyExact.get();
     }
 
-    private static boolean onlyRawFields(Iterable<? extends Expression> expressions, Set<Failure> localFailures) {
+    private static boolean onlyRawFields(Iterable<? extends Expression> expressions, Set<Failure> localFailures,
+            AttributeMap<Expression> attributeRefs) {
         Holder<Boolean> onlyExact = new Holder<>(Boolean.TRUE);
 
         expressions.forEach(e -> e.forEachDown(c -> {
-            if (c instanceof Function || c instanceof FunctionAttribute) {
+            if (c instanceof ReferenceAttribute) {
+                c = attributeRefs.getOrDefault(c, c);
+            }
+            if (c instanceof Function) {
                 localFailures.add(fail(c, "No functions allowed (yet); encountered [{}]", c.sourceText()));
                 onlyExact.set(Boolean.FALSE);
             }
@@ -522,7 +531,7 @@ private static boolean checkGroupByTime(LogicalPlan p, Set<Failure> localFailure
     }
 
     // check whether plain columns specified in an agg are mentioned in the group-by
-    private static boolean checkGroupByAgg(LogicalPlan p, Set<Failure> localFailures, Map<String, Function> functions) {
+    private static boolean checkGroupByAgg(LogicalPlan p, Set<Failure> localFailures, AttributeMap<Expression> attributeRefs) {
         if (p instanceof Aggregate) {
             Aggregate a = (Aggregate) p;
 
@@ -566,7 +575,7 @@ private static boolean checkGroupByAgg(LogicalPlan p, Set<Failure> localFailures
 
             Map<Expression, Node<?>> missing = new LinkedHashMap<>();
             a.aggregates().forEach(ne ->
-                ne.collectFirstChildren(c -> checkGroupMatch(c, ne, a.groupings(), missing, functions)));
+                ne.collectFirstChildren(c -> checkGroupMatch(c, ne, a.groupings(), missing, attributeRefs)));
 
             if (!missing.isEmpty()) {
                 String plural = missing.size() > 1 ? "s" : StringUtils.EMPTY;
@@ -581,23 +590,16 @@ private static boolean checkGroupByAgg(LogicalPlan p, Set<Failure> localFailures
     }
 
     private static boolean checkGroupMatch(Expression e, Node<?> source, List<Expression> groupings,
-            Map<Expression, Node<?>> missing, Map<String, Function> functions) {
+            Map<Expression, Node<?>> missing, AttributeMap<Expression> attributeRefs) {
 
         // 1:1 match
         if (Expressions.match(groupings, e::semanticEquals)) {
             return true;
         }
 
-
         // resolve FunctionAttribute to backing functions
-        if (e instanceof FunctionAttribute) {
-            FunctionAttribute fa = (FunctionAttribute) e;
-            Function function = functions.get(fa.functionId());
-            // TODO: this should be handled by a different rule
-            if (function == null) {
-                return false;
-            }
-            e = function;
+        if (e instanceof ReferenceAttribute) {
+            e = attributeRefs.get(e);
         }
 
         // scalar functions can be a binary tree
@@ -613,7 +615,7 @@ private static boolean checkGroupMatch(Expression e, Node<?> source, List<Expres
 
             // unwrap function to find the base
             for (Expression arg : sf.arguments()) {
-                arg.collectFirstChildren(c -> checkGroupMatch(c, source, groupings, missing, functions));
+                arg.collectFirstChildren(c -> checkGroupMatch(c, source, groupings, missing, attributeRefs));
             }
 
             return true;
@@ -658,7 +660,7 @@ else if (p instanceof Aggregate) {
             Aggregate a = (Aggregate) p;
             a.aggregates().forEach(agg -> agg.forEachDown(e -> {
                 if (a.groupings().size() == 0
-                        || Expressions.anyMatch(a.groupings(), g -> g instanceof Function && e.functionEquals((Function) g)) == false) {
+                        || Expressions.anyMatch(a.groupings(), g -> g instanceof Function && e.equals(g)) == false) {
                     localFailures.add(fail(e, "[{}] needs to be part of the grouping", Expressions.name(e)));
                 }
                 else {
@@ -681,12 +683,12 @@ private static void checkGroupingFunctionTarget(GroupingFunction f, Set<Failure>
         });
     }
 
-    private static void checkFilterOnAggs(LogicalPlan p, Set<Failure> localFailures) {
+    private static void checkFilterOnAggs(LogicalPlan p, Set<Failure> localFailures, AttributeMap<Expression> attributeRefs) {
         if (p instanceof Filter) {
             Filter filter = (Filter) p;
             if ((filter.child() instanceof Aggregate) == false) {
                 filter.condition().forEachDown(e -> {
-                    if (Functions.isAggregate(e) || e instanceof AggregateFunctionAttribute) {
+                    if (Functions.isAggregate(attributeRefs.getOrDefault(e, e)) == true) {
                         localFailures.add(
                                 fail(e, "Cannot use WHERE filtering on aggregate function [{}], use HAVING instead", Expressions.name(e)));
                     }
@@ -696,11 +698,11 @@ private static void checkFilterOnAggs(LogicalPlan p, Set<Failure> localFailures)
     }
 
 
-    private static void checkFilterOnGrouping(LogicalPlan p, Set<Failure> localFailures) {
+    private static void checkFilterOnGrouping(LogicalPlan p, Set<Failure> localFailures, AttributeMap<Expression> attributeRefs) {
         if (p instanceof Filter) {
             Filter filter = (Filter) p;
             filter.condition().forEachDown(e -> {
-                if (Functions.isGrouping(e) || e instanceof GroupingFunctionAttribute) {
+                if (Functions.isGrouping(attributeRefs.getOrDefault(e, e))) {
                     localFailures
                             .add(fail(e, "Cannot filter on grouping function [{}], use its argument instead", Expressions.name(e)));
                 }
@@ -787,11 +789,11 @@ private static void checkForGeoFunctionsOnDocValues(LogicalPlan p, Set<Failure>
         }, FieldAttribute.class)), OrderBy.class);
     }
 
-    private static void checkPivot(LogicalPlan p, Set<Failure> localFailures) {
+    private static void checkPivot(LogicalPlan p, Set<Failure> localFailures, AttributeMap<Expression> attributeRefs) {
         p.forEachDown(pv -> {
             // check only exact fields are used inside PIVOTing
             if (onlyExactFields(combine(pv.groupingSet(), pv.column()), localFailures) == false
-                    || onlyRawFields(pv.groupingSet(), localFailures) == false) {
+                    || onlyRawFields(pv.groupingSet(), localFailures, attributeRefs) == false) {
                 // if that is not the case, no need to do further validation since the declaration is fundamentally wrong
                 return;
             }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
index 6b8bf7ab6df96..d8cf81b539427 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
@@ -39,7 +39,6 @@
 import org.elasticsearch.xpack.sql.execution.search.extractor.PivotExtractor;
 import org.elasticsearch.xpack.sql.execution.search.extractor.TopHitsAggExtractor;
 import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggExtractorInput;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggPathInput;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.HitExtractorInput;
@@ -378,11 +377,11 @@ abstract static class BaseAggActionListener extends BaseActionListener {
 
         protected List<BucketExtractor> initBucketExtractors(SearchResponse response) {
             // create response extractors for the first time
-            List<Tuple<FieldExtraction, ExpressionId>> refs = query.fields();
+            List<Tuple<FieldExtraction, String>> refs = query.fields();
 
             List<BucketExtractor> exts = new ArrayList<>(refs.size());
             ConstantExtractor totalCount = new ConstantExtractor(response.getHits().getTotalHits().value);
-            for (Tuple<FieldExtraction, ExpressionId> ref : refs) {
+            for (Tuple<FieldExtraction, String> ref : refs) {
                 exts.add(createExtractor(ref.v1(), totalCount));
             }
             return exts;
@@ -448,10 +447,10 @@ static class ScrollActionListener extends BaseActionListener {
         @Override
         protected void handleResponse(SearchResponse response, ActionListener<Page> listener) {
             // create response extractors for the first time
-            List<Tuple<FieldExtraction, ExpressionId>> refs = query.fields();
+            List<Tuple<FieldExtraction, String>> refs = query.fields();
 
             List<HitExtractor> exts = new ArrayList<>(refs.size());
-            for (Tuple<FieldExtraction, ExpressionId> ref : refs) {
+            for (Tuple<FieldExtraction, String> ref : refs) {
                 exts.add(createExtractor(ref.v1()));
             }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Alias.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Alias.java
index 4ebc030c281d2..ef8611b49690f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Alias.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Alias.java
@@ -5,14 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
 
-import java.util.Collections;
 import java.util.List;
 
 import static java.util.Collections.singletonList;
@@ -44,11 +40,11 @@ public Alias(Source source, String name, String qualifier, Expression child) {
         this(source, name, qualifier, child, null);
     }
 
-    public Alias(Source source, String name, String qualifier, Expression child, ExpressionId id) {
+    public Alias(Source source, String name, String qualifier, Expression child, NameId id) {
         this(source, name, qualifier, child, id, false);
     }
 
-    public Alias(Source source, String name, String qualifier, Expression child, ExpressionId id, boolean synthetic) {
+    public Alias(Source source, String name, String qualifier, Expression child, NameId id, boolean synthetic) {
         super(source, name, singletonList(child), id, synthetic);
         this.child = child;
         this.qualifier = qualifier;
@@ -92,35 +88,13 @@ public DataType dataType() {
     @Override
     public Attribute toAttribute() {
         if (lazyAttribute == null) {
-            lazyAttribute = createAttribute();
+            lazyAttribute = resolved() == true ?
+                new ReferenceAttribute(source(), name(), dataType(), qualifier, nullable(), id(), synthetic()) :
+                new UnresolvedAttribute(source(), name(), qualifier);
         }
         return lazyAttribute;
     }
 
-    @Override
-    public ScriptTemplate asScript() {
-        throw new SqlIllegalArgumentException("Encountered a bug; an alias should never be scripted");
-    }
-
-    private Attribute createAttribute() {
-        if (resolved()) {
-            Expression c = child();
-
-            Attribute attr = Expressions.attribute(c);
-            if (attr != null) {
-                return attr.clone(source(), name(), child.dataType(), qualifier, child.nullable(), id(), synthetic());
-            }
-            else {
-                // TODO: WE need to fix this fake Field
-                return new FieldAttribute(source(), null, name(),
-                        new EsField(name(), child.dataType(), Collections.emptyMap(), true),
-                        qualifier, child.nullable(), id(), synthetic());
-            }
-        }
-
-        return new UnresolvedAttribute(source(), name(), qualifier);
-    }
-
     @Override
     public String toString() {
         return child + " AS " + name() + "#" + id();
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Attribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Attribute.java
index 9f6b54badaf20..bda8287115e0f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Attribute.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Attribute.java
@@ -5,9 +5,6 @@
  */
 package org.elasticsearch.xpack.sql.expression;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
 
@@ -17,24 +14,16 @@
 import static java.util.Collections.emptyList;
 
 /**
- * {@link Expression}s that can be materialized and represent the result columns sent to the client.
- * Typically are converted into constants, functions or Elasticsearch order-bys,
- * aggregations, or queries. They can also be extracted from the result of a search.
- *
+ * {@link Expression}s that can be materialized and describe properties of the derived table.
+ * In other words, an attribute represent a column in the results of a query.
+ * 
  * In the statement {@code SELECT ABS(foo), A, B+C FROM ...} the three named
  * expressions {@code ABS(foo), A, B+C} get converted to attributes and the user can
  * only see Attributes.
  *
- * In the statement {@code SELECT foo FROM TABLE WHERE foo > 10 + 1} both {@code foo} and
- * {@code 10 + 1} are named expressions, the first due to the SELECT, the second due to being a function.
- * However since {@code 10 + 1} is used for filtering it doesn't appear appear in the result set
- * (derived table) and as such it is never translated to an attribute.
- * "foo" on the other hand is since it's a column in the result set.
- *
- * Another example {@code SELECT foo FROM ... WHERE bar > 10 +1} {@code foo} gets
- * converted into an Attribute, bar does not. That's because {@code bar} is used for
- * filtering alone but it's not part of the projection meaning the user doesn't
- * need it in the derived table.
+ * In the statement {@code SELECT foo FROM TABLE WHERE foo > 10 + 1} only {@code foo} inside the SELECT
+ * is a named expression (an {@code Alias} will be created automatically for it).
+ * The rest are not as they are not part of the projection and thus are not part of the derived table.
  */
 public abstract class Attribute extends NamedExpression {
 
@@ -45,15 +34,15 @@ public abstract class Attribute extends NamedExpression {
     // can the attr be null - typically used in JOINs
     private final Nullability nullability;
 
-    public Attribute(Source source, String name, String qualifier, ExpressionId id) {
+    public Attribute(Source source, String name, String qualifier, NameId id) {
         this(source, name, qualifier, Nullability.TRUE, id);
     }
 
-    public Attribute(Source source, String name, String qualifier, Nullability nullability, ExpressionId id) {
+    public Attribute(Source source, String name, String qualifier, Nullability nullability, NameId id) {
         this(source, name, qualifier, nullability, id, false);
     }
 
-    public Attribute(Source source, String name, String qualifier, Nullability nullability, ExpressionId id, boolean synthetic) {
+    public Attribute(Source source, String name, String qualifier, Nullability nullability, NameId id, boolean synthetic) {
         super(source, name, emptyList(), id, synthetic);
         this.qualifier = qualifier;
         this.nullability = nullability;
@@ -64,11 +53,6 @@ public final Expression replaceChildren(List<Expression> newChildren) {
         throw new UnsupportedOperationException("this type of node doesn't have any children to replace");
     }
 
-    @Override
-    public ScriptTemplate asScript() {
-        throw new SqlIllegalArgumentException("Encountered a bug - an attribute should never be scripted");
-    }
-
     public String qualifier() {
         return qualifier;
     }
@@ -105,16 +89,16 @@ public Attribute withNullability(Nullability nullability) {
                 synthetic());
     }
 
-    public Attribute withDataType(DataType type) {
-        return Objects.equals(dataType(), type) ? this : clone(source(), name(), type, qualifier(), nullable(), id(), synthetic());
+    public Attribute withId(NameId id) {
+        return clone(source(), name(), dataType(), qualifier(), nullable(), id, synthetic());
     }
 
-    public Attribute withId(ExpressionId id) {
-        return clone(source(), name(), dataType(), qualifier(), nullable(), id, synthetic());
+    public Attribute withDataType(DataType type) {
+        return Objects.equals(dataType(), type) ? this : clone(source(), name(), type, qualifier(), nullable(), id(), synthetic());
     }
 
     protected abstract Attribute clone(Source source, String name, DataType type, String qualifier, Nullability nullability,
-            ExpressionId id, boolean synthetic);
+            NameId id, boolean synthetic);
 
     @Override
     public Attribute toAttribute() {
@@ -126,11 +110,6 @@ public int semanticHash() {
         return id().hashCode();
     }
 
-    @Override
-    protected NodeInfo<? extends Expression> info() {
-        return null;
-    }
-
     @Override
     public boolean semanticEquals(Expression other) {
         return other instanceof Attribute ? id().equals(((Attribute) other).id()) : false;
@@ -154,7 +133,12 @@ public boolean equals(Object obj) {
 
     @Override
     public String toString() {
-        return name() + "{" + label() + "}" + "#" + id();
+        return qualifiedName() + "{" + label() + "}" + "#" + id();
+    }
+
+    @Override
+    public String nodeString() {
+        return toString();
     }
 
     protected abstract String label();
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeMap.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeMap.java
index bb8d373f98bfd..b513671a21d37 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeMap.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeMap.java
@@ -32,14 +32,14 @@ static class AttributeWrapper {
 
         @Override
         public int hashCode() {
-            return attr.hashCode();
+            return attr.semanticHash();
         }
 
         @Override
         public boolean equals(Object obj) {
             if (obj instanceof AttributeWrapper) {
                 AttributeWrapper aw = (AttributeWrapper) obj;
-                return attr.equals(aw.attr);
+                return attr.semanticEquals(aw.attr);
             }
 
             return false;
@@ -63,7 +63,7 @@ private abstract static class UnwrappingSet<W, U> extends AbstractSet<U> {
 
         @Override
         public Iterator<U> iterator() {
-            return new Iterator<U>() {
+            return new Iterator<>() {
                 final Iterator<W> i = set.iterator();
 
                 @Override
@@ -300,7 +300,7 @@ public void clear() {
     @Override
     public Set<Attribute> keySet() {
         if (keySet == null) {
-            keySet = new UnwrappingSet<AttributeWrapper, Attribute>(delegate.keySet()) {
+            keySet = new UnwrappingSet<>(delegate.keySet()) {
                 @Override
                 protected Attribute unwrap(AttributeWrapper next) {
                     return next.attr;
@@ -321,10 +321,10 @@ public Collection<E> values() {
     @Override
     public Set<Entry<Attribute, E>> entrySet() {
         if (entrySet == null) {
-            entrySet = new UnwrappingSet<Entry<AttributeWrapper, E>, Entry<Attribute, E>>(delegate.entrySet()) {
+            entrySet = new UnwrappingSet<>(delegate.entrySet()) {
                 @Override
                 protected Entry<Attribute, E> unwrap(final Entry<AttributeWrapper, E> next) {
-                    return new Entry<Attribute, E>() {
+                    return new Entry<>() {
                         @Override
                         public Attribute getKey() {
                             return next.getKey().attr;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Exists.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Exists.java
index 2363b52316c2f..d481d8e115fd3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Exists.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Exists.java
@@ -16,7 +16,7 @@ public Exists(Source source, LogicalPlan query) {
         this(source, query, null);
     }
 
-    public Exists(Source source, LogicalPlan query, ExpressionId id) {
+    public Exists(Source source, LogicalPlan query, NameId id) {
         super(source, query, id);
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java
index 2dde7e5f97d61..e2e3f99ca8790 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java
@@ -128,6 +128,11 @@ public boolean resolved() {
 
     @Override
     public String toString() {
-        return nodeName() + "[" + propertiesToString(false) + "]";
+        return sourceText();
     }
-}
+
+    @Override
+    public String propertiesToString(boolean skipIfChild) {
+        return super.propertiesToString(false);
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expressions.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expressions.java
index 3e5450f01ac30..92703f4768f70 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expressions.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expressions.java
@@ -6,17 +6,21 @@
 package org.elasticsearch.xpack.sql.expression;
 
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.sql.expression.function.Function;
+import org.elasticsearch.xpack.sql.expression.gen.pipeline.AttributeInput;
+import org.elasticsearch.xpack.sql.expression.gen.pipeline.ConstantInput;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
 import org.elasticsearch.xpack.sql.type.DataType;
 import org.elasticsearch.xpack.sql.type.DataTypes;
 
 import java.util.ArrayList;
 import java.util.Collection;
+import java.util.LinkedHashMap;
 import java.util.LinkedHashSet;
 import java.util.List;
+import java.util.Map;
 import java.util.Set;
 import java.util.function.Predicate;
-import java.util.stream.Collectors;
 
 import static java.util.Collections.emptyList;
 import static java.util.Collections.emptyMap;
@@ -103,33 +107,8 @@ public static AttributeSet references(List<? extends Expression> exps) {
         return set;
     }
 
-    public static AttributeSet filterReferences(Set<? extends Expression> exps, AttributeSet excluded) {
-        AttributeSet ret = new AttributeSet();
-        while (exps.size() > 0) {
-
-            Set<Expression> filteredExps = new LinkedHashSet<>();
-            for (Expression exp : exps) {
-                Expression attr = Expressions.attribute(exp);
-                if (attr == null || (excluded.contains(attr) == false)) {
-                    filteredExps.add(exp);
-                }
-            }
-
-            ret.addAll(new AttributeSet(
-                filteredExps.stream().filter(c->c.children().isEmpty())
-                .flatMap(exp->exp.references().stream())
-                .collect(Collectors.toSet())
-            ));
-
-            exps = filteredExps.stream()
-                .flatMap((Expression exp)->exp.children().stream())
-                .collect(Collectors.toSet());
-        }
-        return ret;
-    }
-
     public static String name(Expression e) {
-        return e instanceof NamedExpression ? ((NamedExpression) e).name() : e.nodeName();
+        return e instanceof NamedExpression ? ((NamedExpression) e).name() : e.sourceText();
     }
 
     public static boolean isNull(Expression e) {
@@ -149,9 +128,6 @@ public static Attribute attribute(Expression e) {
         if (e instanceof NamedExpression) {
             return ((NamedExpression) e).toAttribute();
         }
-        if (e != null && e.foldable()) {
-            return Literal.of(e).toAttribute();
-        }
         return null;
     }
 
@@ -163,6 +139,25 @@ public static boolean equalsAsAttribute(Expression left, Expression right) {
         return true;
     }
 
+    public static AttributeMap<Expression> aliases(List<? extends NamedExpression> named) {
+        Map<Attribute, Expression> aliasMap = new LinkedHashMap<>();
+        for (NamedExpression ne : named) {
+            if (ne instanceof Alias) {
+                aliasMap.put(ne.toAttribute(), ((Alias) ne).child());
+            }
+        }
+        return new AttributeMap<>(aliasMap);
+    }
+
+    public static boolean hasReferenceAttribute(Collection<Attribute> output) {
+        for (Attribute attribute : output) {
+            if (attribute instanceof ReferenceAttribute) {
+                return true;
+            }
+        }
+        return false;
+    }
+
     public static List<Attribute> onlyPrimitiveFieldAttributes(Collection<Attribute> attributes) {
         List<Attribute> filtered = new ArrayList<>();
         // add only primitives
@@ -188,8 +183,14 @@ public static List<Attribute> onlyPrimitiveFieldAttributes(Collection<Attribute>
     }
 
     public static Pipe pipe(Expression e) {
+        if (e.foldable()) {
+            return new ConstantInput(e.source(), e, e.fold());
+        }
         if (e instanceof NamedExpression) {
-            return ((NamedExpression) e).asPipe();
+            return new AttributeInput(e.source(), e, ((NamedExpression) e).toAttribute());
+        }
+        if (e instanceof Function) {
+            return ((Function) e).asPipe();
         }
         throw new SqlIllegalArgumentException("Cannot create pipe for {}", e);
     }
@@ -201,4 +202,8 @@ public static List<Pipe> pipe(List<Expression> expressions) {
         }
         return pipes;
     }
-}
+
+    public static String id(Expression e) {
+        return Integer.toHexString(e.hashCode());
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/FieldAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/FieldAttribute.java
index 625a679898a93..f802c9a940dd1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/FieldAttribute.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/FieldAttribute.java
@@ -36,14 +36,14 @@ public FieldAttribute(Source source, String name, EsField field) {
     public FieldAttribute(Source source, FieldAttribute parent, String name, EsField field) {
         this(source, parent, name, field, null, Nullability.TRUE, null, false);
     }
-    
+
     public FieldAttribute(Source source, FieldAttribute parent, String name, EsField field, String qualifier, Nullability nullability,
-            ExpressionId id, boolean synthetic) {
+            NameId id, boolean synthetic) {
         this(source, parent, name, field.getDataType(), field, qualifier, nullability, id, synthetic);
     }
 
     public FieldAttribute(Source source, FieldAttribute parent, String name, DataType type, EsField field, String qualifier,
-                          Nullability nullability, ExpressionId id, boolean synthetic) {
+                          Nullability nullability, NameId id, boolean synthetic) {
         super(source, name, type, qualifier, nullability, id, synthetic);
         this.path = parent != null ? parent.name() : StringUtils.EMPTY;
         this.parent = parent;
@@ -103,8 +103,8 @@ private FieldAttribute innerField(EsField type) {
     }
 
     @Override
-    protected Attribute clone(Source source, String name, DataType type, String qualifier,
-            Nullability nullability, ExpressionId id, boolean synthetic) {
+    protected Attribute clone(Source source, String name, DataType type, String qualifier, Nullability nullability, NameId id, 
+            boolean synthetic) {
         FieldAttribute qualifiedParent = parent != null ? (FieldAttribute) parent.withQualifier(qualifier) : null;
         return new FieldAttribute(source, qualifiedParent, name, field, qualifier, nullability, id, synthetic);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Literal.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Literal.java
index b22483bda3655..315b1bb308eb7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Literal.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Literal.java
@@ -6,23 +6,18 @@
 package org.elasticsearch.xpack.sql.expression;
 
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.script.Params;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
 import org.elasticsearch.xpack.sql.type.DataTypeConversion;
 import org.elasticsearch.xpack.sql.type.DataTypes;
 
-import java.util.List;
 import java.util.Objects;
 
-import static java.util.Collections.emptyList;
-
 /**
  * SQL Literal or constant.
  */
-public class Literal extends NamedExpression {
+public class Literal extends LeafExpression {
 
     public static final Literal TRUE = Literal.of(Source.EMPTY, Boolean.TRUE);
     public static final Literal FALSE = Literal.of(Source.EMPTY, Boolean.FALSE);
@@ -32,11 +27,7 @@ public class Literal extends NamedExpression {
     private final DataType dataType;
 
     public Literal(Source source, Object value, DataType dataType) {
-        this(source, null, value, dataType);
-    }
-
-    public Literal(Source source, String name, Object value, DataType dataType) {
-        super(source, name == null ? source.text() : name, emptyList(), null);
+        super(source);
         this.dataType = dataType;
         this.value = DataTypeConversion.convert(value, dataType);
     }
@@ -75,32 +66,6 @@ public Object fold() {
         return value;
     }
 
-    @Override
-    public Attribute toAttribute() {
-        return new LiteralAttribute(source(), name(), dataType, null, nullable(), id(), false, this);
-    }
-
-    @Override
-    public ScriptTemplate asScript() {
-        return new ScriptTemplate(String.valueOf(value), Params.EMPTY, dataType);
-    }
-
-    @Override
-    public Expression replaceChildren(List<Expression> newChildren) {
-        throw new UnsupportedOperationException("this type of node doesn't have any children to replace");
-    }
-
-    @Override
-    public AttributeSet references() {
-        return AttributeSet.EMPTY;
-    }
-
-    @Override
-    protected Expression canonicalize() {
-        String s = String.valueOf(value);
-        return name().equals(s) ? this : Literal.of(source(), value);
-    }
-
     @Override
     public int hashCode() {
         return Objects.hash(value, dataType);
@@ -116,14 +81,17 @@ public boolean equals(Object obj) {
         }
 
         Literal other = (Literal) obj;
-        return Objects.equals(value, other.value)
-                && Objects.equals(dataType, other.dataType);
+        return Objects.equals(value, other.value) && Objects.equals(dataType, other.dataType);
     }
 
     @Override
     public String toString() {
-        String s = String.valueOf(value);
-        return name().equals(s) ? s : name() + "=" + value;
+        return String.valueOf(value);
+    }
+
+    @Override
+    public String nodeString() {
+        return toString() + "[" + dataType + "]";
     }
 
     /**
@@ -141,31 +109,18 @@ public static Literal of(Source source, Object value) {
      * Throws an exception if the expression is not foldable.
      */
     public static Literal of(Expression foldable) {
-        return of((String) null, foldable);
-    }
-
-    public static Literal of(String name, Expression foldable) {
         if (!foldable.foldable()) {
             throw new SqlIllegalArgumentException("Foldable expression required for Literal creation; received unfoldable " + foldable);
         }
 
         if (foldable instanceof Literal) {
-            Literal l = (Literal) foldable;
-            if (name == null || l.name().equals(name)) {
-                return l;
-            }
+            return (Literal) foldable;
         }
 
-        Object fold = foldable.fold();
-
-        if (name == null) {
-            name = foldable instanceof NamedExpression ? ((NamedExpression) foldable).name() : String.valueOf(fold);
-        }
-        return new Literal(foldable.source(), name, fold, foldable.dataType());
+        return new Literal(foldable.source(), foldable.fold(), foldable.dataType());
     }
 
     public static Literal of(Expression source, Object value) {
-        String name = source instanceof NamedExpression ? ((NamedExpression) source).name() : String.valueOf(value);
-        return new Literal(source.source(), name, value, source.dataType());
+        return new Literal(source.source(), value, source.dataType());
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/LiteralAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/LiteralAttribute.java
deleted file mode 100644
index 506f3f8a0732d..0000000000000
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/LiteralAttribute.java
+++ /dev/null
@@ -1,49 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.sql.expression;
-
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-
-public class LiteralAttribute extends TypedAttribute {
-
-    private final Literal literal;
-
-    public LiteralAttribute(Source source, String name, DataType dataType, String qualifier, Nullability nullability, ExpressionId id,
-                            boolean synthetic, Literal literal) {
-        super(source, name, dataType, qualifier, nullability, id, synthetic);
-        this.literal = literal;
-    }
-
-    @Override
-    protected NodeInfo<LiteralAttribute> info() {
-        return NodeInfo.create(this, LiteralAttribute::new,
-                name(), dataType(), qualifier(), nullable(), id(), synthetic(), literal);
-    }
-
-    @Override
-    protected LiteralAttribute clone(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
-                                     ExpressionId id, boolean synthetic) {
-        return new LiteralAttribute(source, name, dataType, qualifier, nullability, id, synthetic, literal);
-    }
-
-    @Override
-    protected String label() {
-        return "c";
-    }
-
-    @Override
-    public Pipe asPipe() {
-        return literal.asPipe();
-    }
-    
-    @Override
-    public Object fold() {
-        return literal.fold();
-    }
-}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ExpressionId.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NameId.java
similarity index 77%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ExpressionId.java
rename to x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NameId.java
index cbc622a615cba..bc74a506d77af 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ExpressionId.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NameId.java
@@ -9,23 +9,23 @@
 import java.util.concurrent.atomic.AtomicLong;
 
 /**
- * Unique identifier for an expression.
+ * Unique identifier for a named expression.
  * <p>
  * We use an {@link AtomicLong} to guarantee that they are unique
- * and that they produce reproduceable values when run in subsequent
- * tests. They don't produce reproduceable values in production, but
+ * and that create reproducible values when run in subsequent
+ * tests. They don't produce reproducible values in production, but
  * you rarely debug with them in production and commonly do so in
  * tests.
  */
-public class ExpressionId {
+public class NameId {
     private static final AtomicLong COUNTER = new AtomicLong();
     private final long id;
 
-    public ExpressionId() {
+    public NameId() {
         this.id = COUNTER.incrementAndGet();
     }
 
-    public ExpressionId(long id) {
+    public NameId(long id) {
         this.id = id;
     }
 
@@ -42,7 +42,7 @@ public boolean equals(Object obj) {
         if (obj == null || obj.getClass() != getClass()) {
             return false;
         }
-        ExpressionId other = (ExpressionId) obj;
+        NameId other = (NameId) obj;
         return id == other.id;
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NamedExpression.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NamedExpression.java
index e586621a7ddb3..633e230393049 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NamedExpression.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NamedExpression.java
@@ -5,10 +5,6 @@
  */
 package org.elasticsearch.xpack.sql.expression;
 
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AttributeInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.ConstantInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.List;
@@ -21,19 +17,18 @@
 public abstract class NamedExpression extends Expression {
 
     private final String name;
-    private final ExpressionId id;
+    private final NameId id;
     private final boolean synthetic;
-    private Pipe lazyPipe = null;
 
 
-    public NamedExpression(Source source, String name, List<Expression> children, ExpressionId id) {
+    public NamedExpression(Source source, String name, List<Expression> children, NameId id) {
         this(source, name, children, id, false);
     }
 
-    public NamedExpression(Source source, String name, List<Expression> children, ExpressionId id, boolean synthetic) {
+    public NamedExpression(Source source, String name, List<Expression> children, NameId id, boolean synthetic) {
         super(source, children);
         this.name = name;
-        this.id = id == null ? new ExpressionId() : id;
+        this.id = id == null ? new NameId() : id;
         this.synthetic = synthetic;
     }
 
@@ -41,7 +36,7 @@ public String name() {
         return name;
     }
 
-    public ExpressionId id() {
+    public NameId id() {
         return id;
     }
 
@@ -51,20 +46,6 @@ public boolean synthetic() {
 
     public abstract Attribute toAttribute();
 
-    public Pipe asPipe() {
-        if (lazyPipe == null) {
-            lazyPipe = foldable() ? new ConstantInput(source(), this, fold()) : makePipe();
-        }
-
-        return lazyPipe;
-    }
-
-    protected Pipe makePipe() {
-        return new AttributeInput(source(), this, toAttribute());
-    }
-
-    public abstract ScriptTemplate asScript();
-
     @Override
     public int hashCode() {
         return Objects.hash(super.hashCode(), name, synthetic);
@@ -95,4 +76,9 @@ public boolean equals(Object obj) {
     public String toString() {
         return super.toString() + "#" + id();
     }
-}
+
+    @Override
+    public String nodeString() {
+        return name();
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Order.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Order.java
index 267a8827d8cd6..3642ac94d8e79 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Order.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Order.java
@@ -101,4 +101,4 @@ public boolean equals(Object obj) {
                 && Objects.equals(nulls, other.nulls)
                 && Objects.equals(child, other.child);
     }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ReferenceAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ReferenceAttribute.java
new file mode 100644
index 0000000000000..03330bc1148f5
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ReferenceAttribute.java
@@ -0,0 +1,41 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.sql.expression;
+
+import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.sql.type.DataType;
+
+/**
+ * Attribute based on a reference to an expression.
+ */
+public class ReferenceAttribute extends TypedAttribute {
+
+    public ReferenceAttribute(Source source, String name, DataType dataType) {
+        this(source, name, dataType, null, Nullability.FALSE, null, false);
+    }
+
+    public ReferenceAttribute(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
+            NameId id, boolean synthetic) {
+        super(source, name, dataType, qualifier, nullability, id, synthetic);
+    }
+
+    @Override
+    protected Attribute clone(Source source, String name, DataType dataType, String qualifier, Nullability nullability, NameId id, 
+            boolean synthetic) {
+        return new ReferenceAttribute(source, name, dataType, qualifier, nullability, id, synthetic);
+    }
+
+    @Override
+    protected NodeInfo<ReferenceAttribute> info() {
+        return NodeInfo.create(this, ReferenceAttribute::new, name(), dataType(), qualifier(), nullable(), id(), synthetic());
+    }
+
+    @Override
+    protected String label() {
+        return "r";
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ScalarSubquery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ScalarSubquery.java
index 84693cdc79dfc..cba61814e8f51 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ScalarSubquery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ScalarSubquery.java
@@ -16,7 +16,7 @@ public ScalarSubquery(Source source, LogicalPlan query) {
         this(source, query, null);
     }
 
-    public ScalarSubquery(Source source, LogicalPlan query, ExpressionId id) {
+    public ScalarSubquery(Source source, LogicalPlan query, NameId id) {
         super(source, query, id);
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/SubQueryExpression.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/SubQueryExpression.java
index 17ec60b6e6935..250e5de721846 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/SubQueryExpression.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/SubQueryExpression.java
@@ -15,16 +15,16 @@
 public abstract class SubQueryExpression extends Expression {
 
     private final LogicalPlan query;
-    private final ExpressionId id;
+    private final NameId id;
 
     public SubQueryExpression(Source source, LogicalPlan query) {
         this(source, query, null);
     }
 
-    public SubQueryExpression(Source source, LogicalPlan query, ExpressionId id) {
+    public SubQueryExpression(Source source, LogicalPlan query, NameId id) {
         super(source, Collections.emptyList());
         this.query = query;
-        this.id = id == null ? new ExpressionId() : id;
+        this.id = id == null ? new NameId() : id;
     }
 
     @Override
@@ -36,7 +36,7 @@ public LogicalPlan query() {
         return query;
     }
 
-    public ExpressionId id() {
+    public NameId id() {
         return id;
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypedAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypedAttribute.java
index 414ff330bda8f..98f91d4dca158 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypedAttribute.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypedAttribute.java
@@ -15,7 +15,7 @@ public abstract class TypedAttribute extends Attribute {
     private final DataType dataType;
 
     protected TypedAttribute(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
-            ExpressionId id, boolean synthetic) {
+            NameId id, boolean synthetic) {
         super(source, name, qualifier, nullability, id, synthetic);
         this.dataType = dataType;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAlias.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAlias.java
index 178c4d896959f..67bbee18b392e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAlias.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAlias.java
@@ -6,14 +6,14 @@
 package org.elasticsearch.xpack.sql.expression;
 
 import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.sql.tree.Source;
+
+import java.util.List;
 import java.util.Objects;
 
 import static java.util.Collections.singletonList;
 
-import java.util.List;
-
 public class UnresolvedAlias extends UnresolvedNamedExpression {
 
     private final Expression child;
@@ -72,4 +72,9 @@ public boolean equals(Object obj) {
     public String toString() {
         return child + " AS ?";
     }
-}
+
+    @Override
+    public String nodeString() {
+        return toString();
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttribute.java
index add7f702e04d8..34b8eca1c3551 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttribute.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttribute.java
@@ -13,11 +13,8 @@
 import org.elasticsearch.xpack.sql.util.CollectionUtils;
 
 import java.util.List;
-import java.util.Locale;
 import java.util.Objects;
 
-import static java.lang.String.format;
-
 // unfortunately we can't use UnresolvedNamedExpression
 public class UnresolvedAttribute extends Attribute implements Unresolvable {
 
@@ -37,7 +34,7 @@ public UnresolvedAttribute(Source source, String name, String qualifier, String
         this(source, name, qualifier, null, unresolvedMessage, null);
     }
 
-    public UnresolvedAttribute(Source source, String name, String qualifier, ExpressionId id, String unresolvedMessage,
+    public UnresolvedAttribute(Source source, String name, String qualifier, NameId id, String unresolvedMessage,
             Object resolutionMetadata) {
         super(source, name, qualifier, id);
         this.customMessage = unresolvedMessage != null;
@@ -66,7 +63,7 @@ public boolean resolved() {
 
     @Override
     protected Attribute clone(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
-                              ExpressionId id, boolean synthetic) {
+                              NameId id, boolean synthetic) {
         return this;
     }
 
@@ -79,11 +76,6 @@ public DataType dataType() {
         throw new UnresolvedException("dataType", this);
     }
 
-    @Override
-    public String nodeString() {
-        return format(Locale.ROOT, "unknown column '%s'", name());
-    }
-
     @Override
     public String toString() {
         return UNRESOLVED_PREFIX + qualifiedName();
@@ -94,6 +86,11 @@ protected String label() {
         return UNRESOLVED_PREFIX;
     }
 
+    @Override
+    public String nodeString() {
+        return toString();
+    }
+
     @Override
     public String unresolvedMessage() {
         return unresolvedMsg;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedNamedExpression.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedNamedExpression.java
index 4d68d32f37434..5e27180541dfa 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedNamedExpression.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedNamedExpression.java
@@ -7,7 +7,6 @@
 
 import org.elasticsearch.xpack.sql.capabilities.Unresolvable;
 import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
 
@@ -16,7 +15,7 @@
 abstract class UnresolvedNamedExpression extends NamedExpression implements Unresolvable {
 
     UnresolvedNamedExpression(Source source, List<Expression> children) {
-        super(source, "<unresolved>", children, new ExpressionId());
+        super(source, "<unresolved>", children, new NameId());
     }
 
     @Override
@@ -30,7 +29,7 @@ public String name() {
     }
 
     @Override
-    public ExpressionId id() {
+    public NameId id() {
         throw new UnresolvedException("id", this);
     }
 
@@ -43,9 +42,4 @@ public DataType dataType() {
     public Attribute toAttribute() {
         throw new UnresolvedException("attribute", this);
     }
-
-    @Override
-    public ScriptTemplate asScript() {
-        throw new UnresolvedException("script", this);
-    }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedStar.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedStar.java
index 4b5a6dfa53758..0f38a12d7963a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedStar.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedStar.java
@@ -6,14 +6,14 @@
 package org.elasticsearch.xpack.sql.expression;
 
 import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.sql.tree.Source;
+
+import java.util.List;
 import java.util.Objects;
 
 import static java.util.Collections.emptyList;
 
-import java.util.List;
-
 public class UnresolvedStar extends UnresolvedNamedExpression {
 
     // typically used for nested fields or inner/dotted fields
@@ -74,6 +74,11 @@ public String unresolvedMessage() {
         return "Cannot determine columns for [" + message() + "]";
     }
 
+    @Override
+    public String nodeString() {
+        return toString();
+    }
+
     @Override
     public String toString() {
         return UNRESOLVED_PREFIX + message();
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Function.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Function.java
index 7724e81525b6e..47e160df57853 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Function.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Function.java
@@ -6,42 +6,39 @@
 package org.elasticsearch.xpack.sql.expression.function;
 
 import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
 import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.Nullability;
+import org.elasticsearch.xpack.sql.expression.gen.pipeline.ConstantInput;
+import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.util.List;
+import java.util.Locale;
+import java.util.Objects;
+import java.util.StringJoiner;
 
 /**
  * Any SQL expression with parentheses, like {@code MAX()}, or {@code ABS()}. A
  * function is always a {@code NamedExpression}.
  */
-public abstract class Function extends NamedExpression {
+public abstract class Function extends Expression {
 
-    private final String functionName, name;
+    private final String functionName = getClass().getSimpleName().toUpperCase(Locale.ROOT);
 
-    protected Function(Source source, List<Expression> children) {
-        this(source, children, null, false);
-    }
+    private Pipe lazyPipe = null;
 
     // TODO: Functions supporting distinct should add a dedicated constructor Location, List<Expression>, boolean
-    protected Function(Source source, List<Expression> children, ExpressionId id, boolean synthetic) {
-        // cannot detect name yet so override the name
-        super(source, null, children, id, synthetic);
-        functionName = StringUtils.camelCaseToUnderscore(getClass().getSimpleName());
-        name = source.text();
+    protected Function(Source source, List<Expression> children) {
+        super(source, children);
     }
 
     public final List<Expression> arguments() {
         return children();
     }
 
-    @Override
-    public String name() {
-        return name;
+    public String functionName() {
+        return functionName;
     }
 
     @Override
@@ -49,16 +46,44 @@ public Nullability nullable() {
         return Expressions.nullable(children());
     }
 
-    public String functionName() {
-        return functionName;
+    @Override
+    public int hashCode() {
+        return Objects.hash(getClass(), children());
     }
 
-    // TODO: ExpressionId might be converted into an Int which could make the String an int as well
-    public String functionId() {
-        return id().toString();
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) {
+            return true;
+        }
+
+        if (obj == null || getClass() != obj.getClass()) {
+            return false;
+        }
+
+        Function other = (Function) obj;
+        return Objects.equals(children(), other.children());
+    }
+
+    public Pipe asPipe() {
+        if (lazyPipe == null) {
+            lazyPipe = foldable() ? new ConstantInput(source(), this, fold()) : makePipe();
+        }
+        return lazyPipe;
     }
 
-    public boolean functionEquals(Function f) {
-        return f != null && getClass() == f.getClass() && arguments().equals(f.arguments());
+    protected Pipe makePipe() {
+        throw new UnsupportedOperationException();
     }
+
+    @Override
+    public String nodeString() {
+        StringJoiner sj = new StringJoiner(",", functionName() + "(", ")");
+        for (Expression ex : arguments()) {
+            sj.add(ex.nodeString());
+        }
+        return sj.toString();
+    }
+
+    public abstract ScriptTemplate asScript();
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionAttribute.java
deleted file mode 100644
index 962fb010c4820..0000000000000
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionAttribute.java
+++ /dev/null
@@ -1,39 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.sql.expression.function;
-
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.TypedAttribute;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-
-import java.util.Objects;
-
-public abstract class FunctionAttribute extends TypedAttribute {
-
-    private final String functionId;
-
-    protected FunctionAttribute(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
-                                ExpressionId id, boolean synthetic, String functionId) {
-        super(source, name, dataType, qualifier, nullability, id, synthetic);
-        this.functionId = functionId;
-    }
-
-    public String functionId() {
-        return functionId;
-    }
-
-    @Override
-    public int hashCode() {
-        return Objects.hash(super.hashCode());
-    }
-
-    @Override
-    public boolean equals(Object obj) {
-        return super.equals(obj);
-    }
-}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Functions.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Functions.java
index 46ca0ea91b430..47ca821f4b5b4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Functions.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Functions.java
@@ -8,10 +8,6 @@
 import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
-import org.elasticsearch.xpack.sql.plan.QueryPlan;
-
-import java.util.LinkedHashMap;
-import java.util.Map;
 
 public abstract class Functions {
 
@@ -22,15 +18,4 @@ public static boolean isAggregate(Expression e) {
     public static boolean isGrouping(Expression e) {
         return e instanceof GroupingFunction;
     }
-
-    public static Map<String, Function> collectFunctions(QueryPlan<?> plan) {
-        Map<String, Function> resolvedFunctions = new LinkedHashMap<>();
-        plan.forEachExpressionsDown(e -> {
-            if (e.resolved() && e instanceof Function) {
-                Function f = (Function) e;
-                resolvedFunctions.put(f.functionId(), f);
-            }
-        });
-        return resolvedFunctions;
-    }
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Score.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Score.java
index 23363ff6cbddd..d5cee6449807d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Score.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Score.java
@@ -6,12 +6,11 @@
 package org.elasticsearch.xpack.sql.expression.function;
 
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Attribute;
 import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
 import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.List;
@@ -43,11 +42,6 @@ public DataType dataType() {
         return DataType.FLOAT;
     }
 
-    @Override
-    public Attribute toAttribute() {
-        return new ScoreAttribute(source());
-    }
-
     @Override
     public boolean equals(Object obj) {
         if (obj == null || obj.getClass() != getClass()) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/ScoreAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/ScoreAttribute.java
deleted file mode 100644
index 7d93db3d862f0..0000000000000
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/ScoreAttribute.java
+++ /dev/null
@@ -1,58 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.sql.expression.function;
-
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.ScorePipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-
-import static org.elasticsearch.xpack.sql.expression.Nullability.FALSE;
-
-/**
- * {@link Attribute} that represents Elasticsearch's {@code _score}.
- */
-public class ScoreAttribute extends FunctionAttribute {
-    /**
-     * Constructor for normal use.
-     */
-    public ScoreAttribute(Source source) {
-        this(source, "SCORE()", DataType.FLOAT, null, FALSE, null, false);
-    }
-
-    /**
-     * Constructor for {@link #clone()}
-     */
-    private ScoreAttribute(Source source, String name, DataType dataType, String qualifier, Nullability nullability, ExpressionId id,
-                           boolean synthetic) {
-        super(source, name, dataType, qualifier, nullability, id, synthetic, "SCORE");
-    }
-
-    @Override
-    protected NodeInfo<ScoreAttribute> info() {
-        return NodeInfo.create(this);
-    }
-
-    @Override
-    protected Attribute clone(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
-                              ExpressionId id, boolean synthetic) {
-        return new ScoreAttribute(source, name, dataType, qualifier, nullability, id, synthetic);
-    }
-
-    @Override
-    protected Pipe makePipe() {
-        return new ScorePipe(source(), this);
-    }
-
-    @Override
-    protected String label() {
-        return "SCORE";
-    }
-}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunction.java
index 85afc25c5c6cb..920d030ddfd99 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunction.java
@@ -7,7 +7,6 @@
 
 import org.elasticsearch.xpack.sql.capabilities.Unresolvable;
 import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.expression.Attribute;
 import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.Nullability;
@@ -113,16 +112,10 @@ public boolean resolved() {
         return false;
     }
 
-    @Override
     public String name() {
         return name;
     }
 
-    @Override
-    public String functionName() {
-        return name;
-    }
-
     ResolutionType resolutionType() {
         return resolutionType;
     }
@@ -149,11 +142,6 @@ public Nullability nullable() {
         throw new UnresolvedException("nullable", this);
     }
 
-    @Override
-    public Attribute toAttribute() {
-        throw new UnresolvedException("attribute", this);
-    }
-
     @Override
     public ScriptTemplate asScript() {
         throw new UnresolvedException("script", this);
@@ -169,6 +157,11 @@ public String toString() {
         return UNRESOLVED_PREFIX + name + children();
     }
 
+    @Override
+    public String nodeString() {
+        return toString();
+    }
+
     @Override
     public boolean equals(Object obj) {
         if (obj == null || obj.getClass() != getClass()) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunction.java
index 59b4f345a4a61..91ac02dc83785 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunction.java
@@ -30,8 +30,6 @@ public abstract class AggregateFunction extends Function {
     private final Expression field;
     private final List<? extends Expression> parameters;
 
-    private AggregateFunctionAttribute lazyAttribute;
-
     protected AggregateFunction(Source source, Expression field) {
         this(source, field, emptyList());
     }
@@ -51,18 +49,14 @@ public List<? extends Expression> parameters() {
     }
 
     @Override
-    public AggregateFunctionAttribute toAttribute() {
-        if (lazyAttribute == null) {
-            // this is highly correlated with QueryFolder$FoldAggregate#addFunction (regarding the function name within the querydsl)
-            lazyAttribute = new AggregateFunctionAttribute(source(), name(), dataType(), id(), functionId());
-        }
-        return lazyAttribute;
+    protected TypeResolution resolveType() {
+        return TypeResolutions.isExact(field, sourceText(), Expressions.ParamOrdinal.DEFAULT);
     }
 
     @Override
     protected Pipe makePipe() {
         // unresolved AggNameInput (should always get replaced by the folder)
-        return new AggNameInput(source(), this, name());
+        return new AggNameInput(source(), this, sourceText());
     }
 
     @Override
@@ -71,22 +65,19 @@ public ScriptTemplate asScript() {
     }
 
     @Override
-    public boolean equals(Object obj) {
-        if (false == super.equals(obj)) {
-            return false;
-        }
-        AggregateFunction other = (AggregateFunction) obj;
-        return Objects.equals(other.field(), field())
-            && Objects.equals(other.parameters(), parameters());
-    }
-
-    @Override
-    protected TypeResolution resolveType() {
-        return TypeResolutions.isExact(field, sourceText(), Expressions.ParamOrdinal.DEFAULT);
+    public int hashCode() {
+        // NB: the hashcode is currently used for key generation so
+        // to avoid clashes between aggs with the same arguments, add the class name as variation
+        return Objects.hash(getClass(), children());
     }
 
     @Override
-    public int hashCode() {
-        return Objects.hash(field(), parameters());
+    public boolean equals(Object obj) {
+        if (super.equals(obj) == true) {
+            AggregateFunction other = (AggregateFunction) obj;
+            return Objects.equals(other.field(), field())
+                    && Objects.equals(other.parameters(), parameters());
+        }
+        return false;
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunctionAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunctionAttribute.java
deleted file mode 100644
index 463a277a8fa74..0000000000000
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunctionAttribute.java
+++ /dev/null
@@ -1,94 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.sql.expression.function.aggregate;
-
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.FunctionAttribute;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-
-import java.util.Objects;
-
-public class AggregateFunctionAttribute extends FunctionAttribute {
-
-    // used when dealing with a inner agg (avg -> stats) to keep track of
-    // packed id
-    // used since the functionId points to the compoundAgg
-    private final ExpressionId innerId;
-    private final String propertyPath;
-
-    AggregateFunctionAttribute(Source source, String name, DataType dataType, ExpressionId id, String functionId) {
-        this(source, name, dataType, null, Nullability.FALSE, id, false, functionId, null, null);
-    }
-
-    AggregateFunctionAttribute(Source source, String name, DataType dataType, ExpressionId id, String functionId, ExpressionId innerId,
-            String propertyPath) {
-        this(source, name, dataType, null, Nullability.FALSE, id, false, functionId, innerId, propertyPath);
-    }
-
-    public AggregateFunctionAttribute(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
-            ExpressionId id, boolean synthetic, String functionId, ExpressionId innerId, String propertyPath) {
-        super(source, name, dataType, qualifier, nullability, id, synthetic, functionId);
-        this.innerId = innerId;
-        this.propertyPath = propertyPath;
-    }
-
-    @Override
-    protected NodeInfo<AggregateFunctionAttribute> info() {
-        return NodeInfo.create(this, AggregateFunctionAttribute::new, name(), dataType(), qualifier(), nullable(), id(), synthetic(),
-                functionId(), innerId, propertyPath);
-    }
-
-    public ExpressionId innerId() {
-        return innerId != null ? innerId : id();
-    }
-
-    public String propertyPath() {
-        return propertyPath;
-    }
-
-    @Override
-    protected Expression canonicalize() {
-        return new AggregateFunctionAttribute(source(), "<none>", dataType(), null, Nullability.TRUE, id(), false, "<none>", null, null);
-    }
-
-    @Override
-    protected Attribute clone(Source source, String name, DataType dataType, String qualifier, Nullability nullability, ExpressionId id, 
-            boolean synthetic) {
-        // this is highly correlated with QueryFolder$FoldAggregate#addFunction (regarding the function name within the querydsl)
-        // that is the functionId is actually derived from the expression id to easily track it across contexts
-        return new AggregateFunctionAttribute(source, name, dataType, qualifier, nullability, id, synthetic, functionId(), innerId,
-                propertyPath);
-    }
-
-    public AggregateFunctionAttribute withFunctionId(String functionId, String propertyPath) {
-        return new AggregateFunctionAttribute(source(), name(), dataType(), qualifier(), nullable(), id(), synthetic(), functionId, innerId,
-                propertyPath);
-    }
-
-    @Override
-    public int hashCode() {
-        return Objects.hash(super.hashCode(), propertyPath);
-    }
-
-    @Override
-    public boolean equals(Object obj) {
-        if (super.equals(obj)) {
-            AggregateFunctionAttribute other = (AggregateFunctionAttribute) obj;
-            return Objects.equals(propertyPath, other.propertyPath);
-        }
-        return false;
-    }
-
-    @Override
-    protected String label() {
-        return "a->" + innerId();
-    }
-}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Count.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Count.java
index 1da2eeb0277ad..951144f5b2eb6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Count.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Count.java
@@ -6,8 +6,6 @@
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
 import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
@@ -52,45 +50,16 @@ public DataType dataType() {
     }
 
     @Override
-    public String functionId() {
-        String functionId = id().toString();
-        // if count works against a given expression, use its id (to identify the group)
-        // in case of COUNT DISTINCT don't use the expression id to avoid possible duplicate IDs when COUNT and COUNT DISTINCT is used
-        // in the same query
-        if (!distinct() && field() instanceof NamedExpression) {
-            functionId = ((NamedExpression) field()).id().toString();
-        }
-        return functionId;
+    public int hashCode() {
+        return Objects.hash(super.hashCode(), distinct());
     }
 
-    @Override
-    public AggregateFunctionAttribute toAttribute() {
-        // COUNT(*) gets its value from the parent aggregation on which _count is called
-        if (field() instanceof Literal) {
-            return new AggregateFunctionAttribute(source(), name(), dataType(), id(), functionId(), id(), "_count");
-        }
-        // COUNT(column) gets its value from a sibling aggregation (an exists filter agg) by calling its id and then _count on it
-        if (!distinct()) {
-            return new AggregateFunctionAttribute(source(), name(), dataType(), id(), functionId(), id(), functionId() + "._count");
-        }
-        return super.toAttribute();
-    }
-    
     @Override
     public boolean equals(Object obj) {
-        if (this == obj) {
-            return true;
+        if (super.equals(obj) == true) {
+            Count other = (Count) obj;
+            return Objects.equals(other.distinct(), distinct());
         }
-        if (obj == null || obj.getClass() != getClass()) {
-            return false;
-        }
-        Count other = (Count) obj;
-        return Objects.equals(other.distinct(), distinct())
-            && Objects.equals(field(), other.field());
-    }
-
-    @Override
-    public int hashCode() {
-        return Objects.hash(super.hashCode(), distinct());
+        return false;
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/InnerAggregate.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/InnerAggregate.java
index 6e35fa5a7ac72..c9d18b83c156d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/InnerAggregate.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/InnerAggregate.java
@@ -6,12 +6,12 @@
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
 import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.Function;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.List;
+import java.util.Objects;
 
 public class InnerAggregate extends AggregateFunction {
 
@@ -69,38 +69,28 @@ public DataType dataType() {
     }
 
     @Override
-    public String functionId() {
-        return outer.id().toString();
+    public String functionName() {
+        return inner.functionName();
     }
 
     @Override
-    public AggregateFunctionAttribute toAttribute() {
-        // this is highly correlated with QueryFolder$FoldAggregate#addFunction (regarding the function name within the querydsl)
-        return new AggregateFunctionAttribute(source(), name(), dataType(), outer.id(), functionId(),
-                inner.id(), aggMetricValue(functionId(), innerName));
-    }
-
-    private static String aggMetricValue(String aggPath, String valueName) {
-        // handle aggPath inconsistency (for percentiles and percentileRanks) percentile[99.9] (valid) vs percentile.99.9 (invalid)
-        return aggPath + "[" + valueName + "]";
+    public int hashCode() {
+        return Objects.hash(inner, outer, innerKey);
     }
 
     @Override
-    public boolean functionEquals(Function f) {
-        if (super.equals(f)) {
-            InnerAggregate other = (InnerAggregate) f;
-            return inner.equals(other.inner) && outer.equals(other.outer);
+    public boolean equals(Object obj) {
+        if (super.equals(obj) == true) {
+            InnerAggregate other = (InnerAggregate) obj;
+            return Objects.equals(inner, other.inner)
+                    && Objects.equals(outer, other.outer)
+                    && Objects.equals(innerKey, other.innerKey);
         }
         return false;
     }
 
-    @Override
-    public String name() {
-        return inner.name();
-    }
-
     @Override
     public String toString() {
-        return nodeName() + "[" + outer + ">" + inner.nodeName() + "#" + inner.id() + "]";
+        return nodeName() + "[" + outer + ">" + inner.nodeName() + "]";
     }
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunction.java
index b8a6bb4054095..327c4ef382db0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunction.java
@@ -28,8 +28,6 @@ public abstract class GroupingFunction extends Function {
     private final Expression field;
     private final List<Expression> parameters;
 
-    private GroupingFunctionAttribute lazyAttribute;
-
     protected GroupingFunction(Source source, Expression field) {
         this(source, field, emptyList());
     }
@@ -48,19 +46,10 @@ public List<Expression> parameters() {
         return parameters;
     }
 
-    @Override
-    public GroupingFunctionAttribute toAttribute() {
-        if (lazyAttribute == null) {
-            // this is highly correlated with QueryFolder$FoldAggregate#addAggFunction (regarding the function name within the querydsl)
-            lazyAttribute = new GroupingFunctionAttribute(source(), name(), dataType(), id(), functionId());
-        }
-        return lazyAttribute;
-    }
-
     @Override
     protected Pipe makePipe() {
         // unresolved AggNameInput (should always get replaced by the folder)
-        return new AggNameInput(source(), this, name());
+        return new AggNameInput(source(), this, sourceText());
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunctionAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunctionAttribute.java
deleted file mode 100644
index 2fed4cf30608b..0000000000000
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunctionAttribute.java
+++ /dev/null
@@ -1,56 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.sql.expression.function.grouping;
-
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.FunctionAttribute;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-
-public class GroupingFunctionAttribute extends FunctionAttribute {
-
-    GroupingFunctionAttribute(Source source, String name, DataType dataType, ExpressionId id, String functionId) {
-        this(source, name, dataType, null, Nullability.FALSE, id, false, functionId);
-    }
-
-    public GroupingFunctionAttribute(Source source, String name, DataType dataType, String qualifier,
-                                     Nullability nullability, ExpressionId id, boolean synthetic, String functionId) {
-        super(source, name, dataType, qualifier, nullability, id, synthetic, functionId);
-    }
-
-    @Override
-    protected NodeInfo<GroupingFunctionAttribute> info() {
-        return NodeInfo.create(this, GroupingFunctionAttribute::new,
-                name(), dataType(), qualifier(), nullable(), id(), synthetic(), functionId());
-    }
-
-    @Override
-    protected Expression canonicalize() {
-        return new GroupingFunctionAttribute(source(), "<none>", dataType(), null, Nullability.TRUE, id(), false, "<none>");
-    }
-
-    @Override
-    protected Attribute clone(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
-                              ExpressionId id, boolean synthetic) {
-        // this is highly correlated with QueryFolder$FoldAggregate#addFunction (regarding the function name within the querydsl)
-        // that is the functionId is actually derived from the expression id to easily track it across contexts
-        return new GroupingFunctionAttribute(source, name, dataType, qualifier, nullability, id, synthetic, functionId());
-    }
-
-    public GroupingFunctionAttribute withFunctionId(String functionId, String propertyPath) {
-        return new GroupingFunctionAttribute(source(), name(), dataType(), qualifier(), nullable(),
-                id(), synthetic(), functionId);
-    }
-
-    @Override
-    protected String label() {
-        return "g->" + functionId();
-    }
-}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunction.java
index d836030a3ae40..b764b4b0a6ac8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunction.java
@@ -22,8 +22,6 @@
  */
 public abstract class ScalarFunction extends Function implements ScriptWeaver {
 
-    private ScalarFunctionAttribute lazyAttribute = null;
-
     protected ScalarFunction(Source source) {
         super(source, emptyList());
     }
@@ -32,15 +30,6 @@ protected ScalarFunction(Source source, List<Expression> fields) {
         super(source, fields);
     }
 
-    @Override
-    public final ScalarFunctionAttribute toAttribute() {
-        if (lazyAttribute == null) {
-            lazyAttribute = new ScalarFunctionAttribute(source(), name(), dataType(), id(), functionId(), asScript(), orderBy(),
-                asPipe());
-        }
-        return lazyAttribute;
-    }
-
     // used if the function is monotonic and thus does not have to be computed for ordering purposes
     // null means the script needs to be used; expression means the field/expression to be used instead
     public Expression orderBy() {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunctionAttribute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunctionAttribute.java
deleted file mode 100644
index 67324ba466ca5..0000000000000
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunctionAttribute.java
+++ /dev/null
@@ -1,95 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.sql.expression.function.scalar;
-
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.FunctionAttribute;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-
-import java.util.Objects;
-
-public class ScalarFunctionAttribute extends FunctionAttribute {
-
-    private final ScriptTemplate script;
-    private final Expression orderBy;
-    private final Pipe pipe;
-
-    ScalarFunctionAttribute(Source source, String name, DataType dataType, ExpressionId id,
-            String functionId, ScriptTemplate script, Expression orderBy, Pipe processorDef) {
-        this(source, name, dataType, null, Nullability.TRUE, id, false, functionId, script, orderBy, processorDef);
-    }
-
-    public ScalarFunctionAttribute(Source source, String name, DataType dataType, String qualifier,
-                                   Nullability nullability, ExpressionId id, boolean synthetic, String functionId, ScriptTemplate script,
-                                   Expression orderBy, Pipe pipe) {
-        super(source, name, dataType, qualifier, nullability, id, synthetic, functionId);
-
-        this.script = script;
-        this.orderBy = orderBy;
-        this.pipe = pipe;
-    }
-
-    @Override
-    protected NodeInfo<ScalarFunctionAttribute> info() {
-        return NodeInfo.create(this, ScalarFunctionAttribute::new,
-            name(), dataType(), qualifier(), nullable(), id(), synthetic(),
-            functionId(), script, orderBy, pipe);
-    }
-
-    public ScriptTemplate script() {
-        return script;
-    }
-
-    public Expression orderBy() {
-        return orderBy;
-    }
-
-    @Override
-    public Pipe asPipe() {
-        return pipe;
-    }
-
-    @Override
-    protected Expression canonicalize() {
-        return new ScalarFunctionAttribute(source(), "<none>", dataType(), null, Nullability.TRUE, id(), false,
-                functionId(), script, orderBy, pipe);
-    }
-
-    @Override
-    protected Attribute clone(Source source, String name, DataType dataType, String qualifier, Nullability nullability,
-                              ExpressionId id, boolean synthetic) {
-        return new ScalarFunctionAttribute(source, name, dataType, qualifier, nullability,
-            id, synthetic, functionId(), script, orderBy, pipe);
-    }
-
-    @Override
-    public int hashCode() {
-        return Objects.hash(super.hashCode(), script(), pipe, orderBy);
-    }
-
-    @Override
-    public boolean equals(Object obj) {
-        if (super.equals(obj)) {
-            ScalarFunctionAttribute other = (ScalarFunctionAttribute) obj;
-            return Objects.equals(script, other.script())
-                    && Objects.equals(pipe, other.asPipe())
-                    && Objects.equals(orderBy, other.orderBy());
-        }
-        return false;
-    }
-
-    @Override
-    protected String label() {
-        return "s->" + functionId();
-    }
-}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/UnaryScalarFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/UnaryScalarFunction.java
index 9a5f85e943124..d10d18b83a1dd 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/UnaryScalarFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/UnaryScalarFunction.java
@@ -57,8 +57,13 @@ public boolean foldable() {
         return field.foldable();
     }
 
+    @Override
+    public Object fold() {
+        return makeProcessor().process(field().fold());
+    }
+
     @Override
     public ScriptTemplate asScript() {
         return asScript(field);
     }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeFunction.java
index bda86183fff02..0cce7521a2992 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeFunction.java
@@ -52,6 +52,11 @@ public Object fold() {
         return makeProcessor().process(field().fold());
     }
 
+    @Override
+    public int hashCode() {
+        return Objects.hash(getClass(), field(), zoneId());
+    }
+
     @Override
     public boolean equals(Object obj) {
         if (obj == null || obj.getClass() != getClass()) {
@@ -61,9 +66,4 @@ public boolean equals(Object obj) {
         return Objects.equals(other.field(), field())
             && Objects.equals(other.zoneId(), zoneId());
     }
-
-    @Override
-    public int hashCode() {
-        return Objects.hash(field(), zoneId());
-    }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosql.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosql.java
index 3ebae55dec4f0..04006d4a28b51 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosql.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosql.java
@@ -36,7 +36,7 @@ protected TypeResolution resolveType() {
         if (field().dataType().isString()) {
             return TypeResolution.TYPE_RESOLVED;
         }
-        return isString(field(), functionName(), Expressions.ParamOrdinal.DEFAULT);
+        return isString(field(), sourceText(), Expressions.ParamOrdinal.DEFAULT);
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/E.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/E.java
index 265b96984b581..b1b731fe91be9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/E.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/E.java
@@ -20,7 +20,7 @@ public class E extends MathFunction {
     private static final ScriptTemplate TEMPLATE = new ScriptTemplate("Math.E", Params.EMPTY, DataType.DOUBLE);
 
     public E(Source source) {
-        super(source, new Literal(source, "E", Math.E, DataType.DOUBLE));
+        super(source, new Literal(source, Math.E, DataType.DOUBLE));
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Pi.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Pi.java
index 7fb966c3201a3..79492bac3c12e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Pi.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Pi.java
@@ -20,7 +20,7 @@ public class Pi extends MathFunction {
     private static final ScriptTemplate TEMPLATE = new ScriptTemplate("Math.PI", Params.EMPTY, DataType.DOUBLE);
 
     public Pi(Source source) {
-        super(source, new Literal(source, "PI", Math.PI, DataType.DOUBLE));
+        super(source, new Literal(source, Math.PI, DataType.DOUBLE));
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Concat.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Concat.java
index 4e461d919a93a..15602bc53c880 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Concat.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Concat.java
@@ -38,12 +38,12 @@ protected TypeResolution resolveType() {
             return new TypeResolution("Unresolved children");
         }
 
-        TypeResolution resolution = isStringAndExact(left(), functionName(), ParamOrdinal.FIRST);
+        TypeResolution resolution = isStringAndExact(left(), sourceText(), ParamOrdinal.FIRST);
         if (resolution.unresolved()) {
             return resolution;
         }
 
-        return isStringAndExact(right(), functionName(), ParamOrdinal.SECOND);
+        return isStringAndExact(right(), sourceText(), ParamOrdinal.SECOND);
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Agg.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Agg.java
index 55bba71306250..ad4ff617cce49 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Agg.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Agg.java
@@ -5,20 +5,48 @@
  */
 package org.elasticsearch.xpack.sql.expression.gen.script;
 
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunctionAttribute;
+import org.elasticsearch.xpack.sql.expression.Expressions;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
 
-class Agg extends Param<AggregateFunctionAttribute> {
+class Agg extends Param<AggregateFunction> {
 
-    Agg(AggregateFunctionAttribute aggRef) {
+    private static final String COUNT_PATH = "_count";
+
+    Agg(AggregateFunction aggRef) {
         super(aggRef);
     }
 
     String aggName() {
-        return value().functionId();
+        return Expressions.id(value());
     }
 
     public String aggProperty() {
-        return value().propertyPath();
+        AggregateFunction agg = value();
+
+        if (agg instanceof InnerAggregate) {
+            InnerAggregate inner = (InnerAggregate) agg;
+            return Expressions.id(inner.outer()) + "." + inner.innerName();
+        }
+        // Count needs special handling since in most cases it is not a dedicated aggregation
+        else if (agg instanceof Count) {
+            Count c = (Count) agg;
+            // for literals get the last count
+            if (c.field().foldable() == true) {
+                return COUNT_PATH;
+            }
+            // when dealing with fields, check whether there's a single-metric (distinct -> cardinality)
+            // or a bucket (non-distinct - filter agg)
+            else {
+                if (c.distinct() == true) {
+                    return Expressions.id(c);
+                } else {
+                    return Expressions.id(c) + "." + COUNT_PATH;
+                }
+            }
+        }
+        return null;
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Grouping.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Grouping.java
index e11f82a842ee0..f34e1c8798f9e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Grouping.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Grouping.java
@@ -5,16 +5,16 @@
  */
 package org.elasticsearch.xpack.sql.expression.gen.script;
 
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunctionAttribute;
+import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
 
-class Grouping extends Param<GroupingFunctionAttribute> {
+class Grouping extends Param<GroupingFunction> {
 
-    Grouping(GroupingFunctionAttribute groupRef) {
+    Grouping(GroupingFunction groupRef) {
         super(groupRef);
     }
 
     String groupName() {
-        return value().functionId();
+        return Integer.toHexString(value().hashCode());
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ParamsBuilder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ParamsBuilder.java
index 25e92103cccf5..2e13682b70e7a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ParamsBuilder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ParamsBuilder.java
@@ -5,8 +5,8 @@
  */
 package org.elasticsearch.xpack.sql.expression.gen.script;
 
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunctionAttribute;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunctionAttribute;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -24,12 +24,12 @@ public ParamsBuilder variable(Object value) {
         return this;
     }
 
-    public ParamsBuilder agg(AggregateFunctionAttribute agg) {
+    public ParamsBuilder agg(AggregateFunction agg) {
         params.add(new Agg(agg));
         return this;
     }
 
-    public ParamsBuilder grouping(GroupingFunctionAttribute grouping) {
+    public ParamsBuilder grouping(GroupingFunction grouping) {
         params.add(new Grouping(grouping));
         return this;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptWeaver.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptWeaver.java
index 223e22b2a33ba..e468a2801ce6c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptWeaver.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptWeaver.java
@@ -7,14 +7,12 @@
 package org.elasticsearch.xpack.sql.expression.gen.script;
 
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Attribute;
 import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
 import org.elasticsearch.xpack.sql.expression.FieldAttribute;
 import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunctionAttribute;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunctionAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunctionAttribute;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
 import org.elasticsearch.xpack.sql.expression.literal.IntervalDayTime;
 import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
@@ -36,20 +34,20 @@ default ScriptTemplate asScript(Expression exp) {
             return scriptWithFoldable(exp);
         }
 
-        Attribute attr = Expressions.attribute(exp);
-        if (attr != null) {
-            if (attr instanceof ScalarFunctionAttribute) {
-                return scriptWithScalar((ScalarFunctionAttribute) attr);
-            }
-            if (attr instanceof AggregateFunctionAttribute) {
-                return scriptWithAggregate((AggregateFunctionAttribute) attr);
-            }
-            if (attr instanceof GroupingFunctionAttribute) {
-                return scriptWithGrouping((GroupingFunctionAttribute) attr);
-            }
-            if (attr instanceof FieldAttribute) {
-                return scriptWithField((FieldAttribute) attr);
-            }
+        if (exp instanceof ScalarFunction) {
+            return scriptWithScalar((ScalarFunction) exp);
+        }
+
+        if (exp instanceof AggregateFunction) {
+            return scriptWithAggregate((AggregateFunction) exp);
+        }
+
+        if (exp instanceof GroupingFunction) {
+            return scriptWithGrouping((GroupingFunction) exp);
+        }
+
+        if (exp instanceof FieldAttribute) {
+            return scriptWithField((FieldAttribute) exp);
         }
         throw new SqlIllegalArgumentException("Cannot evaluate script for expression {}", exp);
     }
@@ -108,14 +106,14 @@ default ScriptTemplate scriptWithFoldable(Expression foldable) {
                 dataType());
     }
 
-    default ScriptTemplate scriptWithScalar(ScalarFunctionAttribute scalar) {
-        ScriptTemplate nested = scalar.script();
+    default ScriptTemplate scriptWithScalar(ScalarFunction scalar) {
+        ScriptTemplate nested = scalar.asScript();
         return new ScriptTemplate(processScript(nested.template()),
                 paramsBuilder().script(nested.params()).build(),
                 dataType());
     }
 
-    default ScriptTemplate scriptWithAggregate(AggregateFunctionAttribute aggregate) {
+    default ScriptTemplate scriptWithAggregate(AggregateFunction aggregate) {
         String template = "{}";
         if (aggregate.dataType().isDateBased()) {
             template = "{sql}.asDateTime({})";
@@ -125,7 +123,7 @@ default ScriptTemplate scriptWithAggregate(AggregateFunctionAttribute aggregate)
                 dataType());
     }
 
-    default ScriptTemplate scriptWithGrouping(GroupingFunctionAttribute grouping) {
+    default ScriptTemplate scriptWithGrouping(GroupingFunction grouping) {
         String template = "{}";
         if (grouping.dataType().isDateBased()) {
             template = "{sql}.asDateTime({})";
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryPredicate.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryPredicate.java
index eb7265dc29bc8..8705f9c58e578 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryPredicate.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryPredicate.java
@@ -68,4 +68,9 @@ public String symbol() {
     public F function() {
         return function;
     }
+
+    @Override
+    public String nodeString() {
+        return left().nodeString() + " " + symbol() + " " + right().nodeString();
+    }
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Range.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Range.java
index aa1a3a32e5541..8405b0b436ad4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Range.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Range.java
@@ -7,7 +7,6 @@
 
 import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.Nullability;
 import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
@@ -180,29 +179,4 @@ public boolean equals(Object obj) {
                 && Objects.equals(lower, other.lower)
                 && Objects.equals(upper, other.upper);
     }
-
-    private static String name(Expression value, Expression lower, Expression upper, boolean includeLower, boolean includeUpper) {
-        StringBuilder sb = new StringBuilder();
-        sb.append(Expressions.name(lower));
-        if (!(lower instanceof Literal)) {
-            sb.insert(0, "(");
-            sb.append(")");
-        }
-        sb.append(includeLower ? " <= " : " < ");
-        int pos = sb.length();
-        sb.append(Expressions.name(value));
-        if (!(value instanceof Literal)) {
-            sb.insert(pos, "(");
-            sb.append(")");
-        }
-        sb.append(includeUpper ? " <= " : " < ");
-        pos = sb.length();
-        sb.append(Expressions.name(upper));
-        if (!(upper instanceof Literal)) {
-            sb.insert(pos, "(");
-            sb.append(")");
-        }
-
-        return sb.toString();
-    }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfConditional.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfConditional.java
index 298f7d67329b2..96d40f094a168 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfConditional.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfConditional.java
@@ -69,24 +69,17 @@ protected TypeResolution resolveType() {
     }
 
     @Override
-    public boolean equals(Object o) {
-        if (this == o) {
-            return true;
-        }
-        if (o == null || getClass() != o.getClass()) {
-            return false;
-        }
-        if (!super.equals(o)) {
-            return false;
-        }
-
-        IfConditional that = (IfConditional) o;
-        return Objects.equals(condition, that.condition) &&
-            Objects.equals(result, that.result);
+    public int hashCode() {
+        return Objects.hash(condition, result);
     }
 
     @Override
-    public int hashCode() {
-        return Objects.hash(condition, result);
+    public boolean equals(Object o) {
+        if (super.equals(o) == true) {
+            IfConditional that = (IfConditional) o;
+            return Objects.equals(condition, that.condition) 
+                    && Objects.equals(result, that.result);
+        }
+        return false;
     }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/In.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/In.java
index 342407c21b32f..4be6d76b8c8f9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/In.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/In.java
@@ -119,7 +119,7 @@ protected TypeResolution resolveType() {
             if (ex.foldable() == false) {
                 return new TypeResolution(format(null, "Comparisons against variables are not (currently) supported; offender [{}] in [{}]",
                     Expressions.name(ex),
-                    name()));
+                    sourceText()));
             }
         }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
index a8145962e15a7..0d7d9acc343d0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
@@ -11,7 +11,6 @@
 import org.elasticsearch.xpack.sql.expression.Attribute;
 import org.elasticsearch.xpack.sql.expression.AttributeMap;
 import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
 import org.elasticsearch.xpack.sql.expression.ExpressionSet;
 import org.elasticsearch.xpack.sql.expression.Expressions;
 import org.elasticsearch.xpack.sql.expression.FieldAttribute;
@@ -19,12 +18,10 @@
 import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.Nullability;
 import org.elasticsearch.xpack.sql.expression.Order;
+import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
 import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
 import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.FunctionAttribute;
-import org.elasticsearch.xpack.sql.expression.function.Functions;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunctionAttribute;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.ExtendedStats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.ExtendedStatsEnclosed;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.First;
@@ -41,8 +38,6 @@
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Stats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunctionAttribute;
 import org.elasticsearch.xpack.sql.expression.predicate.BinaryOperator;
 import org.elasticsearch.xpack.sql.expression.predicate.BinaryPredicate;
 import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
@@ -52,7 +47,6 @@
 import org.elasticsearch.xpack.sql.expression.predicate.conditional.Case;
 import org.elasticsearch.xpack.sql.expression.predicate.conditional.Coalesce;
 import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfConditional;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.FullTextPredicate;
 import org.elasticsearch.xpack.sql.expression.predicate.logical.And;
 import org.elasticsearch.xpack.sql.expression.predicate.logical.Not;
 import org.elasticsearch.xpack.sql.expression.predicate.logical.Or;
@@ -127,8 +121,10 @@ protected Iterable<RuleExecutor<LogicalPlan>.Batch> batches() {
         Batch pivot = new Batch("Pivot Rewrite", Limiter.ONCE,
                 new RewritePivot());
 
+        Batch refs = new Batch("Replace References", Limiter.ONCE,
+                new ReplaceReferenceAttributeWithSource());
+
         Batch operators = new Batch("Operator Optimization",
-                new PruneDuplicatesInGroupBy(),
                 // combining
                 new CombineProjections(),
                 // folding
@@ -145,20 +141,18 @@ protected Iterable<RuleExecutor<LogicalPlan>.Batch> batches() {
                 new PropagateEquals(),
                 new CombineBinaryComparisons(),
                 // prune/elimination
+                new PruneLiteralsInGroupBy(),
+                new PruneDuplicatesInGroupBy(),
                 new PruneFilters(),
-                new PruneOrderBy(),
+                new PruneOrderByForImplicitGrouping(),
+                new PruneLiteralsInOrderBy(),
                 new PruneOrderByNestedFields(),
                 new PruneCast(),
                 // order by alignment of the aggs
                 new SortAggregateOnOrderBy()
-                // requires changes in the folding
-                // since the exact same function, with the same ID can appear in multiple places
-                // see https://github.com/elastic/x-pack-elasticsearch/issues/3527
-                //new PruneDuplicateFunctions()
                 );
 
         Batch aggregate = new Batch("Aggregation Rewrite",
-                //new ReplaceDuplicateAggsWithReferences(),
                 new ReplaceMinMaxWithTopHits(),
                 new ReplaceAggsWithMatrixStats(),
                 new ReplaceAggsWithExtendedStats(),
@@ -172,12 +166,11 @@ protected Iterable<RuleExecutor<LogicalPlan>.Batch> batches() {
                 new SkipQueryOnLimitZero(),
                 new SkipQueryIfFoldingProjection()
                 );
-        //new BalanceBooleanTrees());
         Batch label = new Batch("Set as Optimized", Limiter.ONCE,
                 CleanAliases.INSTANCE,
                 new SetAsOptimized());
 
-        return Arrays.asList(pivot, operators, aggregate, local, label);
+        return Arrays.asList(pivot, refs, operators, aggregate, local, label);
     }
 
     static class RewritePivot extends OptimizerRule<Pivot> {
@@ -189,17 +182,9 @@ protected LogicalPlan rule(Pivot plan) {
             for (NamedExpression namedExpression : plan.values()) {
                 // everything should have resolved to an alias
                 if (namedExpression instanceof Alias) {
-                    rawValues.add(((Alias) namedExpression).child());
-                }
-                // TODO: this should be removed when refactoring NamedExpression
-                else if (namedExpression instanceof Literal) {
-                    rawValues.add(namedExpression);
+                    rawValues.add(Literal.of(((Alias) namedExpression).child()));
                 }
-                // TODO: NamedExpression refactoring should remove this
-                else if (namedExpression.foldable()) {
-                    rawValues.add(Literal.of(namedExpression.name(), namedExpression));
-                }
-                // TODO: same as above
+                // fallback - should not happen
                 else {
                     UnresolvedAttribute attr = new UnresolvedAttribute(namedExpression.source(), namedExpression.name(), null,
                             "Unexpected alias");
@@ -208,589 +193,92 @@ else if (namedExpression.foldable()) {
             }
             Filter filter = new Filter(plan.source(), plan.child(), new In(plan.source(), plan.column(), rawValues));
             // 2. preserve the PIVOT
-            return new Pivot(plan.source(), filter, plan.column(), plan.values(), plan.aggregates());
-        }
-    }
-
-    static class PruneDuplicatesInGroupBy extends OptimizerRule<Aggregate> {
-
-        @Override
-        protected LogicalPlan rule(Aggregate agg) {
-            List<Expression> groupings = agg.groupings();
-            if (groupings.isEmpty()) {
-                return agg;
-            }
-            ExpressionSet<Expression> unique = new ExpressionSet<>(groupings);
-            if (unique.size() != groupings.size()) {
-                return new Aggregate(agg.source(), agg.child(), new ArrayList<>(unique), agg.aggregates());
-            }
-            return agg;
-        }
-    }
-
-    static class ReplaceDuplicateAggsWithReferences extends OptimizerRule<Aggregate> {
-
-        @Override
-        protected LogicalPlan rule(Aggregate agg) {
-            List<? extends NamedExpression> aggs = agg.aggregates();
-
-            Map<Expression, NamedExpression> unique = new HashMap<>();
-            Map<NamedExpression, Expression> reverse = new HashMap<>();
-
-            // find duplicates by looking at the function and canonical form
-            for (NamedExpression ne : aggs) {
-                if (ne instanceof Alias) {
-                    Alias a = (Alias) ne;
-                    unique.putIfAbsent(a.child(), a);
-                    reverse.putIfAbsent(ne, a.child());
-                }
-                else {
-                    unique.putIfAbsent(ne.canonical(), ne);
-                    reverse.putIfAbsent(ne, ne.canonical());
-                }
-            }
-
-            if (unique.size() != aggs.size()) {
-                List<NamedExpression> newAggs = new ArrayList<>(aggs.size());
-                for (NamedExpression ne : aggs) {
-                    newAggs.add(unique.get(reverse.get(ne)));
-                }
-                return new Aggregate(agg.source(), agg.child(), agg.groupings(), newAggs);
-            }
-
-            return agg;
-        }
-    }
-
-    static class ReplaceAggsWithMatrixStats extends Rule<LogicalPlan, LogicalPlan> {
-
-        @Override
-        public LogicalPlan apply(LogicalPlan p) {
-            Map<Expression, MatrixStats> seen = new LinkedHashMap<>();
-            Map<String, AggregateFunctionAttribute> promotedFunctionIds = new LinkedHashMap<>();
-
-            p = p.transformExpressionsUp(e -> rule(e, seen, promotedFunctionIds));
-
-            // nothing found
-            if (seen.isEmpty()) {
-                return p;
-            }
-
-            return ReplaceAggsWithStats.updateAggAttributes(p, promotedFunctionIds);
-        }
-
-        @Override
-        protected LogicalPlan rule(LogicalPlan e) {
-            return e;
-        }
-
-        protected Expression rule(Expression e, Map<Expression, MatrixStats> seen, Map<String, AggregateFunctionAttribute> promotedIds) {
-            if (e instanceof MatrixStatsEnclosed) {
-                AggregateFunction f = (AggregateFunction) e;
-
-                Expression argument = f.field();
-                MatrixStats matrixStats = seen.get(argument);
-
-                if (matrixStats == null) {
-                    matrixStats = new MatrixStats(f.source(), argument);
-                    seen.put(argument, matrixStats);
-                }
-
-                InnerAggregate ia = new InnerAggregate(f.source(), f, matrixStats, argument);
-                promotedIds.putIfAbsent(f.functionId(), ia.toAttribute());
-                return ia;
-            }
-
-            return e;
+            return new Pivot(plan.source(), filter, plan.column(), plan.values(), plan.aggregates(), plan.groupings());
         }
     }
 
-    static class ReplaceAggsWithExtendedStats extends Rule<LogicalPlan, LogicalPlan> {
-
-        @Override
-        public LogicalPlan apply(LogicalPlan p) {
-            Map<String, AggregateFunctionAttribute> promotedFunctionIds = new LinkedHashMap<>();
-            Map<Expression, ExtendedStats> seen = new LinkedHashMap<>();
-            p = p.transformExpressionsUp(e -> rule(e, seen, promotedFunctionIds));
-
-            // nothing found
-            if (seen.isEmpty()) {
-                return p;
-            }
-
-            // update old agg attributes
-            return ReplaceAggsWithStats.updateAggAttributes(p, promotedFunctionIds);
-        }
-
-        @Override
-        protected LogicalPlan rule(LogicalPlan e) {
-            return e;
-        }
-
-        protected Expression rule(Expression e, Map<Expression, ExtendedStats> seen,
-                Map<String, AggregateFunctionAttribute> promotedIds) {
-            if (e instanceof ExtendedStatsEnclosed) {
-                AggregateFunction f = (AggregateFunction) e;
-
-                Expression argument = f.field();
-                ExtendedStats extendedStats = seen.get(argument);
-
-                if (extendedStats == null) {
-                    extendedStats = new ExtendedStats(f.source(), argument);
-                    seen.put(argument, extendedStats);
-                }
-
-                InnerAggregate ia = new InnerAggregate(f, extendedStats);
-                promotedIds.putIfAbsent(f.functionId(), ia.toAttribute());
-                return ia;
-            }
-
-            return e;
-        }
-    }
-
-    static class ReplaceAggsWithStats extends Rule<LogicalPlan, LogicalPlan> {
-
-        private static class Match {
-            final Stats stats;
-            private final Set<Class<? extends AggregateFunction>> functionTypes = new LinkedHashSet<>();
-            private Map<Class<? extends AggregateFunction>, InnerAggregate> innerAggs = null;
-
-            Match(Stats stats) {
-                this.stats = stats;
-            }
-
-            @Override
-            public String toString() {
-                return stats.toString();
-            }
-
-            public void add(Class<? extends AggregateFunction> aggType) {
-                functionTypes.add(aggType);
-            }
-
-            // if the stat has at least two different functions for it, promote it as stat
-            // also keep the promoted function around for reuse
-            public AggregateFunction maybePromote(AggregateFunction agg) {
-                if (functionTypes.size() > 1) {
-                    if (innerAggs == null) {
-                        innerAggs = new LinkedHashMap<>();
-                    }
-                    return innerAggs.computeIfAbsent(agg.getClass(), k -> new InnerAggregate(agg, stats));
-                }
-                return agg;
-            }
-        }
+    //
+    // Replace any reference attribute with its source, if it does not affect the result.
+    // This avoid ulterior look-ups between attributes and its source across nodes, which is
+    // problematic when doing script translation.
+    //
+    static class ReplaceReferenceAttributeWithSource extends OptimizerBasicRule {
 
         @Override
-        public LogicalPlan apply(LogicalPlan p) {
-            Map<Expression, Match> potentialPromotions = new LinkedHashMap<>();
-
-            p.forEachExpressionsUp(e -> collect(e, potentialPromotions));
-
-            // no promotions found - skip
-            if (potentialPromotions.isEmpty()) {
-                return p;
-            }
-
-            // start promotion
-
-            // old functionId to new function attribute
-            Map<String, AggregateFunctionAttribute> promotedFunctionIds = new LinkedHashMap<>();
-
-            // 1. promote aggs to InnerAggs
-            p = p.transformExpressionsUp(e -> promote(e, potentialPromotions, promotedFunctionIds));
-
-            // 2. update the old agg attrs to the promoted agg functions
-            return updateAggAttributes(p, promotedFunctionIds);
-        }
-
-        @Override
-        protected LogicalPlan rule(LogicalPlan e) {
-            return e;
-        }
-
-        private Expression collect(Expression e, Map<Expression, Match> seen) {
-            if (Stats.isTypeCompatible(e)) {
-                AggregateFunction f = (AggregateFunction) e;
-
-                Expression argument = f.field();
-                Match match = seen.get(argument);
-
-                if (match == null) {
-                    match = new Match(new Stats(new Source(f.sourceLocation(), "STATS(" + Expressions.name(argument) + ")"), argument));
-                    seen.put(argument, match);
-                }
-                match.add(f.getClass());
-            }
-
-            return e;
-        }
-
-        private static Expression promote(Expression e, Map<Expression, Match> seen, Map<String, AggregateFunctionAttribute> attrs) {
-            if (Stats.isTypeCompatible(e)) {
-                AggregateFunction f = (AggregateFunction) e;
-
-                Expression argument = f.field();
-                Match match = seen.get(argument);
-
-                if (match != null) {
-                    AggregateFunction inner = match.maybePromote(f);
-                    if (inner != f) {
-                        attrs.putIfAbsent(f.functionId(), inner.toAttribute());
-                    }
-                    return inner;
-                }
-            }
-            return e;
-        }
-
-        static LogicalPlan updateAggAttributes(LogicalPlan p, Map<String, AggregateFunctionAttribute> promotedFunctionIds) {
-            // 1. update old agg function attributes
-            p = p.transformExpressionsUp(e -> updateAggFunctionAttrs(e, promotedFunctionIds));
-
-            // 2. update all scalar function consumers of the promoted aggs
-            // since they contain the old ids in scrips and processorDefinitions that need regenerating
-
-            // 2a. collect ScalarFunctions that unwrapped refer to any of the updated aggregates
-            // 2b. replace any of the old ScalarFunction attributes
-
-            final Set<String> newAggIds = new LinkedHashSet<>(promotedFunctionIds.size());
-
-            for (AggregateFunctionAttribute afa : promotedFunctionIds.values()) {
-                newAggIds.add(afa.functionId());
-            }
-
-            final Map<String, ScalarFunctionAttribute> updatedScalarAttrs = new LinkedHashMap<>();
-            final Map<ExpressionId, ScalarFunctionAttribute> updatedScalarAliases = new LinkedHashMap<>();
-
-            p = p.transformExpressionsUp(e -> {
-
-                // replace scalar attributes of the old replaced functions
-                if (e instanceof ScalarFunctionAttribute) {
-                    ScalarFunctionAttribute sfa = (ScalarFunctionAttribute) e;
-                    // check aliases
-                    sfa = updatedScalarAttrs.getOrDefault(sfa.functionId(), sfa);
-                    // check scalars
-                    sfa = updatedScalarAliases.getOrDefault(sfa.id(), sfa);
-                    return sfa;
-                }
+        public LogicalPlan apply(LogicalPlan plan) {
+            final Map<Attribute, Expression> collectRefs = new LinkedHashMap<>();
 
-                // unwrap aliases as they 'hide' functions under their own attributes
+            // collect aliases
+            plan.forEachUp(p -> p.forEachExpressionsUp(e -> {
                 if (e instanceof Alias) {
-                    Attribute att = Expressions.attribute(e);
-                    if (att instanceof ScalarFunctionAttribute) {
-                        ScalarFunctionAttribute sfa = (ScalarFunctionAttribute) att;
-                        // the underlying function has been updated
-                        // thus record the alias as well
-                        if (updatedScalarAttrs.containsKey(sfa.functionId())) {
-                            updatedScalarAliases.put(sfa.id(), sfa);
-                        }
-                    }
+                    Alias a = (Alias) e;
+                    collectRefs.put(a.toAttribute(), a.child());
                 }
+            }));
 
-                else if (e instanceof ScalarFunction && false == Expressions.anyMatch(e.children(), c -> c instanceof FullTextPredicate)) {
-                    ScalarFunction sf = (ScalarFunction) e;
-
-                    // if it's a unseen function check if the function children/arguments refers to any of the promoted aggs
-                    if (newAggIds.isEmpty() == false && !updatedScalarAttrs.containsKey(sf.functionId()) && e.anyMatch(c -> {
-                        Attribute a = Expressions.attribute(c);
-                        if (a instanceof FunctionAttribute) {
-                            return newAggIds.contains(((FunctionAttribute) a).functionId());
+            plan = plan.transformUp(p -> {
+                // non attribute defining plans get their references removed
+                if ((p instanceof Pivot || p instanceof Aggregate || p instanceof Project) == false || p.children().isEmpty()) {
+                    p = p.transformExpressionsOnly(e -> {
+                        if (e instanceof ReferenceAttribute) {
+                            e = collectRefs.getOrDefault(e, e);
                         }
-                        return false;
-                    })) {
-                        // if so, record its attribute
-                        updatedScalarAttrs.put(sf.functionId(), sf.toAttribute());
-                    }
-                }
-
-                return e;
-            });
-
-            return p;
-        }
-
-
-        private static Expression updateAggFunctionAttrs(Expression e, Map<String, AggregateFunctionAttribute> promotedIds) {
-            if (e instanceof AggregateFunctionAttribute) {
-                AggregateFunctionAttribute ae = (AggregateFunctionAttribute) e;
-                AggregateFunctionAttribute promoted = promotedIds.get(ae.functionId());
-                if (promoted != null) {
-                    return ae.withFunctionId(promoted.functionId(), promoted.propertyPath());
-                }
-            }
-            return e;
-        }
-    }
-
-    static class PromoteStatsToExtendedStats extends Rule<LogicalPlan, LogicalPlan> {
-
-        @Override
-        public LogicalPlan apply(LogicalPlan p) {
-            Map<Expression, ExtendedStats> seen = new LinkedHashMap<>();
-
-            // count the extended stats
-            p.forEachExpressionsUp(e -> count(e, seen));
-            // then if there's a match, replace the stat inside the InnerAgg
-            return p.transformExpressionsUp(e -> promote(e, seen));
-        }
-
-        @Override
-        protected LogicalPlan rule(LogicalPlan e) {
-            return e;
-        }
-
-        private void count(Expression e, Map<Expression, ExtendedStats> seen) {
-            if (e instanceof InnerAggregate) {
-                InnerAggregate ia = (InnerAggregate) e;
-                if (ia.outer() instanceof ExtendedStats) {
-                    ExtendedStats extStats = (ExtendedStats) ia.outer();
-                    seen.putIfAbsent(extStats.field(), extStats);
-                }
-            }
-        }
-
-        protected Expression promote(Expression e, Map<Expression, ExtendedStats> seen) {
-            if (e instanceof InnerAggregate) {
-                InnerAggregate ia = (InnerAggregate) e;
-                if (ia.outer() instanceof Stats) {
-                    Stats stats = (Stats) ia.outer();
-                    ExtendedStats ext = seen.get(stats.field());
-                    if (ext != null && stats.field().equals(ext.field())) {
-                        return new InnerAggregate(ia.inner(), ext);
-                    }
+                        return e;
+                    });
                 }
-            }
-
-            return e;
-        }
-    }
-
-    static class ReplaceAggsWithPercentiles extends Rule<LogicalPlan, LogicalPlan> {
-
-        @Override
-        public LogicalPlan apply(LogicalPlan p) {
-            // percentile per field/expression
-            Map<Expression, Set<Expression>> percentsPerField = new LinkedHashMap<>();
-
-            // count gather the percents for each field
-            p.forEachExpressionsUp(e -> count(e, percentsPerField));
-
-            Map<Expression, Percentiles> percentilesPerField = new LinkedHashMap<>();
-            // create a Percentile agg for each field (and its associated percents)
-            percentsPerField.forEach((k, v) -> {
-                percentilesPerField.put(k, new Percentiles(v.iterator().next().source(), k, new ArrayList<>(v)));
+                return p;
             });
 
-            // now replace the agg with pointer to the main ones
-            Map<String, AggregateFunctionAttribute> promotedFunctionIds = new LinkedHashMap<>();
-            p = p.transformExpressionsUp(e -> rule(e, percentilesPerField, promotedFunctionIds));
-            // finally update all the function references as well
-            return p.transformExpressionsDown(e -> ReplaceAggsWithStats.updateAggFunctionAttrs(e, promotedFunctionIds));
-        }
-
-        private void count(Expression e, Map<Expression, Set<Expression>> percentsPerField) {
-            if (e instanceof Percentile) {
-                Percentile p = (Percentile) e;
-                Expression field = p.field();
-                Set<Expression> percentiles = percentsPerField.get(field);
-
-                if (percentiles == null) {
-                    percentiles = new LinkedHashSet<>();
-                    percentsPerField.put(field, percentiles);
-                }
-
-                percentiles.add(p.percent());
-            }
-        }
-
-        protected Expression rule(Expression e, Map<Expression, Percentiles> percentilesPerField,
-                Map<String, AggregateFunctionAttribute> promotedIds) {
-            if (e instanceof Percentile) {
-                Percentile p = (Percentile) e;
-                Percentiles percentiles = percentilesPerField.get(p.field());
-
-                InnerAggregate ia = new InnerAggregate(p, percentiles);
-                promotedIds.putIfAbsent(p.functionId(), ia.toAttribute());
-                return ia;
-            }
-
-            return e;
-        }
-
-        @Override
-        protected LogicalPlan rule(LogicalPlan e) {
-            return e;
+            return plan;
         }
     }
 
-    static class ReplaceAggsWithPercentileRanks extends Rule<LogicalPlan, LogicalPlan> {
+    static class PruneLiteralsInGroupBy extends OptimizerRule<Aggregate> {
 
         @Override
-        public LogicalPlan apply(LogicalPlan p) {
-            // percentile per field/expression
-            Map<Expression, Set<Expression>> valuesPerField = new LinkedHashMap<>();
-
-            // count gather the percents for each field
-            p.forEachExpressionsUp(e -> count(e, valuesPerField));
-
-            Map<Expression, PercentileRanks> ranksPerField = new LinkedHashMap<>();
-            // create a PercentileRanks agg for each field (and its associated values)
-            valuesPerField.forEach((k, v) -> {
-                ranksPerField.put(k, new PercentileRanks(v.iterator().next().source(), k, new ArrayList<>(v)));
-            });
-
-            // now replace the agg with pointer to the main ones
-            Map<String, AggregateFunctionAttribute> promotedFunctionIds = new LinkedHashMap<>();
-            p = p.transformExpressionsUp(e -> rule(e, ranksPerField, promotedFunctionIds));
-            // finally update all the function references as well
-            return p.transformExpressionsDown(e -> ReplaceAggsWithStats.updateAggFunctionAttrs(e, promotedFunctionIds));
-        }
-
-        private void count(Expression e, Map<Expression, Set<Expression>> ranksPerField) {
-            if (e instanceof PercentileRank) {
-                PercentileRank p = (PercentileRank) e;
-                Expression field = p.field();
-                Set<Expression> percentiles = ranksPerField.get(field);
+        protected LogicalPlan rule(Aggregate agg) {
+            List<Expression> groupings = agg.groupings();
+            List<Expression> prunedGroupings = new ArrayList<>();
 
-                if (percentiles == null) {
-                    percentiles = new LinkedHashSet<>();
-                    ranksPerField.put(field, percentiles);
+            for (Expression g : groupings) {
+                if (g.foldable()) {
+                    prunedGroupings.add(g);
                 }
-
-                percentiles.add(p.value());
             }
-        }
-
-        protected Expression rule(Expression e, Map<Expression, PercentileRanks> ranksPerField,
-                Map<String, AggregateFunctionAttribute> promotedIds) {
-            if (e instanceof PercentileRank) {
-                PercentileRank p = (PercentileRank) e;
-                PercentileRanks ranks = ranksPerField.get(p.field());
 
-                InnerAggregate ia = new InnerAggregate(p, ranks);
-                promotedIds.putIfAbsent(p.functionId(), ia.toAttribute());
-                return ia;
+            // everything was eliminated, the grouping
+            if (prunedGroupings.size() > 0) {
+                List<Expression> newGroupings = new ArrayList<>(groupings);
+                newGroupings.removeAll(prunedGroupings);
+                return new Aggregate(agg.source(), agg.child(), newGroupings, agg.aggregates());
             }
 
-            return e;
-        }
-
-        @Override
-        protected LogicalPlan rule(LogicalPlan e) {
-            return e;
-        }
-    }
-
-    static class ReplaceMinMaxWithTopHits extends OptimizerRule<LogicalPlan> {
-
-        @Override
-        protected LogicalPlan rule(LogicalPlan plan) {
-            Map<ExpressionId, TopHits> seen = new HashMap<>();
-            return plan.transformExpressionsDown(e -> {
-                if (e instanceof Min) {
-                    Min min = (Min) e;
-                    if (min.field().dataType().isString()) {
-                        TopHits topHits = seen.get(min.id());
-                        if (topHits != null) {
-                            return topHits;
-                        }
-                        topHits = new First(min.source(), min.field(), null);
-                        seen.put(min.id(), topHits);
-                        return topHits;
-                    }
-                }
-                if (e instanceof Max) {
-                    Max max = (Max) e;
-                    if (max.field().dataType().isString()) {
-                        TopHits topHits = seen.get(max.id());
-                        if (topHits != null) {
-                            return topHits;
-                        }
-                        topHits = new Last(max.source(), max.field(), null);
-                        seen.put(max.id(), topHits);
-                        return topHits;
-                    }
-                }
-                return e;
-            });
+            return agg;
         }
     }
 
-    static class PruneFilters extends OptimizerRule<Filter> {
+    static class PruneDuplicatesInGroupBy extends OptimizerRule<Aggregate> {
 
         @Override
-        protected LogicalPlan rule(Filter filter) {
-            Expression condition = filter.condition().transformUp(PruneFilters::foldBinaryLogic);
-
-            if (condition instanceof Literal) {
-                if (TRUE.equals(condition)) {
-                    return filter.child();
-                }
-                if (FALSE.equals(condition) || Expressions.isNull(condition)) {
-                    return new LocalRelation(filter.source(), new EmptyExecutable(filter.output()));
-                }
-            }
-
-            if (!condition.equals(filter.condition())) {
-                return new Filter(filter.source(), filter.child(), condition);
-            }
-            return filter;
-        }
-
-        private static Expression foldBinaryLogic(Expression expression) {
-            if (expression instanceof Or) {
-                Or or = (Or) expression;
-                boolean nullLeft = Expressions.isNull(or.left());
-                boolean nullRight = Expressions.isNull(or.right());
-                if (nullLeft && nullRight) {
-                    return Literal.NULL;
-                }
-                if (nullLeft) {
-                    return or.right();
-                }
-                if (nullRight) {
-                    return or.left();
-                }
-            }
-            if (expression instanceof And) {
-                And and = (And) expression;
-                if (Expressions.isNull(and.left()) || Expressions.isNull(and.right())) {
-                    return Literal.NULL;
-                }
+        protected LogicalPlan rule(Aggregate agg) {
+            List<Expression> groupings = agg.groupings();
+            if (groupings.isEmpty()) {
+                return agg;
             }
-            return expression;
-        }
-    }
-
-    static class ReplaceAliasesInHaving extends OptimizerRule<Filter> {
-
-        @Override
-        protected LogicalPlan rule(Filter filter) {
-            if (filter.child() instanceof Aggregate) {
-                Expression cond = filter.condition();
-                // resolve attributes to their actual
-                Expression newCondition = cond.transformDown(a -> {
-
-                    return a;
-                }, AggregateFunctionAttribute.class);
-
-                if (newCondition != cond) {
-                    return new Filter(filter.source(), filter.child(), newCondition);
-                }
+            ExpressionSet<Expression> unique = new ExpressionSet<>(groupings);
+            if (unique.size() != groupings.size()) {
+                return new Aggregate(agg.source(), agg.child(), new ArrayList<>(unique), agg.aggregates());
             }
-            return filter;
+            return agg;
         }
     }
 
     static class PruneOrderByNestedFields extends OptimizerRule<Project> {
 
-        private void findNested(Expression exp, Map<String, Function> functions, Consumer<FieldAttribute> onFind) {
+        private void findNested(Expression exp, AttributeMap<Function> functions, Consumer<FieldAttribute> onFind) {
             exp.forEachUp(e -> {
-                if (e instanceof FunctionAttribute) {
-                    FunctionAttribute sfa = (FunctionAttribute) e;
-                    Function f = functions.get(sfa.functionId());
+                if (e instanceof ReferenceAttribute) {
+                    Function f = functions.get(e);
                     if (f != null) {
                         findNested(f, functions, onFind);
                     }
@@ -810,8 +298,22 @@ protected LogicalPlan rule(Project project) {
             if (project.child() instanceof OrderBy) {
                 OrderBy ob = (OrderBy) project.child();
 
-                // resolve function aliases (that are hiding the target)
-                Map<String, Function> functions = Functions.collectFunctions(project);
+                // resolve function references (that maybe hiding the target)
+                final Map<Attribute, Function> collectRefs = new LinkedHashMap<>();
+
+                // collect Attribute sources
+                // only Aliases are interesting since these are the only ones that hide expressions
+                // FieldAttribute for example are self replicating.
+                project.forEachUp(p -> p.forEachExpressionsUp(e -> {
+                    if (e instanceof Alias) {
+                        Alias a = (Alias) e;
+                        if (a.child() instanceof Function) {
+                            collectRefs.put(a.toAttribute(), (Function) a.child());
+                        }
+                    }
+                }));
+
+                AttributeMap<Function> functions = new AttributeMap<>(collectRefs);
 
                 // track the direct parents
                 Map<String, Order> nestedOrders = new LinkedHashMap<>();
@@ -870,7 +372,33 @@ protected LogicalPlan rule(Project project) {
         }
     }
 
-    static class PruneOrderBy extends OptimizerRule<OrderBy> {
+    static class PruneLiteralsInOrderBy extends OptimizerRule<OrderBy> {
+
+        @Override
+        protected LogicalPlan rule(OrderBy ob) {
+            List<Order> prunedOrders = new ArrayList<>();
+
+            for (Order o : ob.order()) {
+                if (o.child().foldable()) {
+                    prunedOrders.add(o);
+                }
+            }
+
+            // everything was eliminated, the order isn't needed anymore
+            if (prunedOrders.size() == ob.order().size()) {
+                return ob.child();
+            }
+            if (prunedOrders.size() > 0) {
+                List<Order> newOrders = new ArrayList<>(ob.order());
+                newOrders.removeAll(prunedOrders);
+                return new OrderBy(ob.source(), ob.child(), newOrders);
+            }
+
+            return ob;
+        }
+    }
+    
+    static class PruneOrderByForImplicitGrouping extends OptimizerRule<OrderBy> {
 
         @Override
         protected LogicalPlan rule(OrderBy ob) {
@@ -905,12 +433,10 @@ static class SortAggregateOnOrderBy extends OptimizerRule<OrderBy> {
         protected LogicalPlan rule(OrderBy ob) {
             List<Order> order = ob.order();
 
-            // remove constants and put the items in reverse order so the iteration happens back to front
+            // put the items in reverse order so the iteration happens back to front
             List<Order> nonConstant = new LinkedList<>();
-            for (Order o : order) {
-                if (o.child().foldable() == false) {
-                    nonConstant.add(0, o);
-                }
+            for (int i = order.size() - 1; i >= 0; i--) {
+                nonConstant.add(order.get(i));
             }
 
             Holder<Boolean> foundAggregate = new Holder<>(Boolean.FALSE);
@@ -940,13 +466,13 @@ protected LogicalPlan rule(OrderBy ob) {
                                     if ((equalsAsAttribute(child, group)
                                             && (equalsAsAttribute(alias, fieldToOrder) || equalsAsAttribute(child, fieldToOrder)))
                                         || (equalsAsAttribute(alias, group)
-                                                && (equalsAsAttribute(alias, fieldToOrder) || equalsAsAttribute(child, fieldToOrder)))) {
+                                            && (equalsAsAttribute(alias, fieldToOrder) || equalsAsAttribute(child, fieldToOrder)))) {
                                         isMatching.set(Boolean.TRUE);
                                     }
                                 }
                             });
                         }
-                        
+
                         if (isMatching.get() == true) {
                             // move grouping in front
                             groupings.remove(group);
@@ -985,75 +511,18 @@ public LogicalPlan apply(LogicalPlan plan) {
 
         @Override
         protected LogicalPlan rule(LogicalPlan plan) {
-            final Map<Attribute, Attribute> replacedCast = new LinkedHashMap<>();
-
             // eliminate redundant casts
             LogicalPlan transformed = plan.transformExpressionsUp(e -> {
-                if (e instanceof Cast) {
-                    Cast c = (Cast) e;
-
-                    if (c.from() == c.to()) {
-                        Expression argument = c.field();
-                        Alias as = new Alias(c.source(), c.sourceText(), argument);
-                        replacedCast.put(c.toAttribute(), as.toAttribute());
-
-                        return as;
-                    }
-                }
-                return e;
-            });
-
-            // replace attributes from previous removed Casts
-            if (!replacedCast.isEmpty()) {
-                return transformed.transformUp(p -> {
-                    List<Attribute> newProjections = new ArrayList<>();
-
-                    boolean changed = false;
-                    for (NamedExpression ne : p.projections()) {
-                        Attribute found = replacedCast.get(ne.toAttribute());
-                        if (found != null) {
-                            changed = true;
-                            newProjections.add(found);
-                        }
-                        else {
-                            newProjections.add(ne.toAttribute());
-                        }
-                    }
-
-                    return changed ? new Project(p.source(), p.child(), newProjections) : p;
-
-                }, Project.class);
-            }
-            return transformed;
-        }
-    }
-
-    static class PruneDuplicateFunctions extends Rule<LogicalPlan, LogicalPlan> {
-
-        @Override
-        public LogicalPlan apply(LogicalPlan p) {
-            List<Function> seen = new ArrayList<>();
-            return p.transformExpressionsUp(e -> rule(e, seen));
-        }
-
-        @Override
-        protected LogicalPlan rule(LogicalPlan e) {
-            return e;
-        }
-
-        protected Expression rule(Expression exp, List<Function> seen) {
-            Expression e = exp;
-            if (e instanceof Function) {
-                Function f = (Function) e;
-                for (Function seenFunction : seen) {
-                    if (seenFunction != f && f.functionEquals(seenFunction)) {
-                        return seenFunction;
+                if (e instanceof Cast) {
+                    Cast c = (Cast) e;
+                    if (c.from() == c.to()) {
+                        return c.field();
                     }
                 }
-                seen.add(f);
-            }
+                return e;
+            });
 
-            return exp;
+            return transformed;
         }
     }
 
@@ -1203,12 +672,12 @@ static class FoldNull extends OptimizerExpressionRule {
         protected Expression rule(Expression e) {
             if (e instanceof IsNotNull) {
                 if (((IsNotNull) e).field().nullable() == Nullability.FALSE) {
-                    return new Literal(e.source(), Expressions.name(e), Boolean.TRUE, DataType.BOOLEAN);
+                    return new Literal(e.source(), Boolean.TRUE, DataType.BOOLEAN);
                 }
 
             } else if (e instanceof IsNull) {
                 if (((IsNull) e).field().nullable() == Nullability.FALSE) {
-                    return new Literal(e.source(), Expressions.name(e), Boolean.FALSE, DataType.BOOLEAN);
+                    return new Literal(e.source(), Boolean.FALSE, DataType.BOOLEAN);
                 }
 
             } else if (e instanceof In) {
@@ -1220,8 +689,8 @@ protected Expression rule(Expression e) {
             } else if (e instanceof Alias == false
                     && e.nullable() == Nullability.TRUE
                     && Expressions.anyMatch(e.children(), Expressions::isNull)) {
-                return Literal.of(e, null);
-            }
+                    return Literal.of(e, null);
+                }
 
             return e;
         }
@@ -1235,7 +704,7 @@ static class ConstantFolding extends OptimizerExpressionRule {
 
         @Override
         protected Expression rule(Expression e) {
-            return e.foldable() ? Literal.of(e) : e;
+            return e.foldable() && (e instanceof Literal == false) ? Literal.of(e) : e;
         }
     }
 
@@ -1408,6 +877,7 @@ private Expression simplifyAndOr(BinaryPredicate<?, ?, ?, ?> bc) {
             return bc;
         }
 
+        @SuppressWarnings("rawtypes")
         private Expression simplifyNot(Not n) {
             Expression c = n.field();
 
@@ -1666,14 +1136,14 @@ private Expression combine(And and) {
                         // </<= AND >/>=
                         else if ((other instanceof GreaterThan || other instanceof GreaterThanOrEqual)
                                 && (main instanceof LessThan || main instanceof LessThanOrEqual)) {
-                            bcs.remove(j);
-                            bcs.remove(i);
+                                    bcs.remove(j);
+                                    bcs.remove(i);
 
                             ranges.add(new Range(and.source(), main.left(),
                                     other.right(), other instanceof GreaterThanOrEqual,
                                     main.right(), main instanceof LessThanOrEqual));
 
-                            changed = true;
+                                    changed = true;
                         }
                     }
                 }
@@ -1745,16 +1215,16 @@ private static boolean findExistingRange(Range main, List<Range> ranges, boolean
                             lowerEq = comp == 0 && main.includeLower() == other.includeLower();
                             // AND
                             if (conjunctive) {
-                                        // (2 < a < 3) AND (1 < a < 3) -> (1 < a < 3)
+                                // (2 < a < 3) AND (1 < a < 3) -> (1 < a < 3)
                                 lower = comp > 0 ||
-                                        // (2 < a < 3) AND (2 < a <= 3) -> (2 < a < 3)
+                                // (2 < a < 3) AND (2 < a <= 3) -> (2 < a < 3)
                                         (comp == 0 && !main.includeLower() && other.includeLower());
                             }
                             // OR
                             else {
-                                        // (1 < a < 3) OR (2 < a < 3) -> (1 < a < 3)
+                                // (1 < a < 3) OR (2 < a < 3) -> (1 < a < 3)
                                 lower = comp < 0 ||
-                                        // (2 <= a < 3) OR (2 < a < 3) -> (2 <= a < 3)
+                                // (2 <= a < 3) OR (2 < a < 3) -> (2 <= a < 3)
                                         (comp == 0 && main.includeLower() && !other.includeLower()) || lowerEq;
                             }
                         }
@@ -1771,16 +1241,16 @@ private static boolean findExistingRange(Range main, List<Range> ranges, boolean
 
                             // AND
                             if (conjunctive) {
-                                        // (1 < a < 2) AND (1 < a < 3) -> (1 < a < 2)
+                                // (1 < a < 2) AND (1 < a < 3) -> (1 < a < 2)
                                 upper = comp < 0 ||
-                                        // (1 < a < 2) AND (1 < a <= 2) -> (1 < a < 2)
+                                // (1 < a < 2) AND (1 < a <= 2) -> (1 < a < 2)
                                         (comp == 0 && !main.includeUpper() && other.includeUpper());
                             }
                             // OR
                             else {
-                                        // (1 < a < 3) OR (1 < a < 2) -> (1 < a < 3)
+                                // (1 < a < 3) OR (1 < a < 2) -> (1 < a < 3)
                                 upper = comp > 0 ||
-                                        // (1 < a <= 3) OR (1 < a < 3) -> (2 < a < 3)
+                                // (1 < a <= 3) OR (1 < a < 3) -> (2 < a < 3)
                                         (comp == 0 && main.includeUpper() && !other.includeUpper()) || upperEq;
                             }
                         }
@@ -1839,7 +1309,7 @@ private boolean findConjunctiveComparisonInRange(BinaryComparison main, List<Ran
                             if (comp != null) {
                                 // 2 < a AND (2 <= a < 3) -> 2 < a < 3
                                 boolean lowerEq = comp == 0 && other.includeLower() && main instanceof GreaterThan;
-                                 // 2 < a AND (1 < a < 3) -> 2 < a < 3
+                                // 2 < a AND (1 < a < 3) -> 2 < a < 3
                                 boolean lower = comp > 0 || lowerEq;
 
                                 if (lower) {
@@ -1904,18 +1374,18 @@ private static boolean findExistingComparison(BinaryComparison main, List<Binary
                         Integer compare = BinaryComparison.compare(value, other.right().fold());
 
                         if (compare != null) {
-                                 // AND
+                            // AND
                             if ((conjunctive &&
-                                  // a > 3 AND a > 2 -> a > 3
-                                  (compare > 0 ||
-                                  // a > 2 AND a >= 2 -> a > 2
-                                  (compare == 0 && main instanceof GreaterThan && other instanceof GreaterThanOrEqual)))
-                                ||
-                                // OR
-                                (!conjunctive &&
-                                  // a > 2 OR a > 3 -> a > 2
-                                  (compare < 0 ||
-                                  // a >= 2 OR a > 2 -> a >= 2
+                            // a > 3 AND a > 2 -> a > 3
+                                    (compare > 0 ||
+                                    // a > 2 AND a >= 2 -> a > 2
+                                            (compare == 0 && main instanceof GreaterThan && other instanceof GreaterThanOrEqual)))
+                                    ||
+                                    // OR
+                                    (!conjunctive &&
+                                    // a > 2 OR a > 3 -> a > 2
+                                            (compare < 0 ||
+                                            // a >= 2 OR a > 2 -> a >= 2
                                   (compare == 0 && main instanceof GreaterThanOrEqual && other instanceof GreaterThan)))) {
                                 bcs.remove(i);
                                 bcs.add(i, main);
@@ -1931,40 +1401,365 @@ private static boolean findExistingComparison(BinaryComparison main, List<Binary
                 else if ((other instanceof LessThan || other instanceof LessThanOrEqual) &&
                         (main instanceof LessThan || main instanceof LessThanOrEqual)) {
 
-                    if (main.left().semanticEquals(other.left())) {
-                        Integer compare = BinaryComparison.compare(value, other.right().fold());
+                            if (main.left().semanticEquals(other.left())) {
+                                Integer compare = BinaryComparison.compare(value, other.right().fold());
 
-                        if (compare != null) {
-                                 // AND
-                            if ((conjunctive &&
-                                  // a < 2 AND a < 3 -> a < 2
-                                  (compare < 0 ||
-                                  // a < 2 AND a <= 2 -> a < 2
+                                if (compare != null) {
+                                    // AND
+                                    if ((conjunctive &&
+                                    // a < 2 AND a < 3 -> a < 2
+                                    (compare < 0 ||
+                                    // a < 2 AND a <= 2 -> a < 2
                                   (compare == 0 && main instanceof LessThan && other instanceof LessThanOrEqual)))
                                 ||
-                                // OR
-                                (!conjunctive &&
-                                  // a < 2 OR a < 3 -> a < 3
-                                  (compare > 0 ||
-                                  // a <= 2 OR a < 2 -> a <= 2
-                                  (compare == 0 && main instanceof LessThanOrEqual && other instanceof LessThan)))) {
-                                bcs.remove(i);
-                                bcs.add(i, main);
+                                    // OR
+                                    (!conjunctive &&
+                                    // a < 2 OR a < 3 -> a < 3
+                                    (compare > 0 ||
+                                    // a <= 2 OR a < 2 -> a <= 2
+                                    (compare == 0 && main instanceof LessThanOrEqual && other instanceof LessThan)))) {
+                                        bcs.remove(i);
+                                        bcs.add(i, main);
 
+                                    }
+                                    // found a match
+                                    return true;
+                                }
+
+                                return false;
                             }
-                            // found a match
-                            return true;
                         }
+            }
 
-                        return false;
+            return false;
+        }
+    }
+
+
+    static class ReplaceAggsWithMatrixStats extends OptimizerBasicRule {
+
+        @Override
+        public LogicalPlan apply(LogicalPlan p) {
+            // minimal reuse of the same matrix stat object
+            final Map<Expression, MatrixStats> seen = new LinkedHashMap<>();
+
+            return p.transformExpressionsUp(e -> {
+                if (e instanceof MatrixStatsEnclosed) {
+                    AggregateFunction f = (AggregateFunction) e;
+
+                    Expression argument = f.field();
+                    MatrixStats matrixStats = seen.get(argument);
+
+                    if (matrixStats == null) {
+                        Source source = new Source(f.sourceLocation(), "MATRIX(" + argument.sourceText() + ")");
+                        matrixStats = new MatrixStats(source, argument);
+                        seen.put(argument, matrixStats);
+                    }
+
+                    InnerAggregate ia = new InnerAggregate(f.source(), f, matrixStats, argument);
+                    return ia;
+                }
+
+                return e;
+            });
+        }
+    }
+
+    static class ReplaceAggsWithExtendedStats extends OptimizerBasicRule {
+
+        @Override
+        public LogicalPlan apply(LogicalPlan p) {
+            // minimal reuse of the same matrix stat object
+            final Map<Expression, ExtendedStats> seen = new LinkedHashMap<>();
+
+            return p.transformExpressionsUp(e -> {
+                if (e instanceof ExtendedStatsEnclosed) {
+                    AggregateFunction f = (AggregateFunction) e;
+
+                    Expression argument = f.field();
+                    ExtendedStats extendedStats = seen.get(argument);
+
+                    if (extendedStats == null) {
+                        Source source = new Source(f.sourceLocation(), "EXT_STATS(" + argument.sourceText() + ")");
+                        extendedStats = new ExtendedStats(source, argument);
+                        seen.put(argument, extendedStats);
+                    }
+
+                    InnerAggregate ia = new InnerAggregate(f, extendedStats);
+                    return ia;
+                }
+
+                return e;
+            });
+        }
+    }
+
+    static class ReplaceAggsWithStats extends OptimizerBasicRule {
+
+        private static class Match {
+            final Stats stats;
+            private final Set<Class<? extends AggregateFunction>> functionTypes = new LinkedHashSet<>();
+            private Map<Class<? extends AggregateFunction>, InnerAggregate> innerAggs = null;
+
+            Match(Stats stats) {
+                this.stats = stats;
+            }
+
+            @Override
+            public String toString() {
+                return stats.toString();
+            }
+
+            public void add(Class<? extends AggregateFunction> aggType) {
+                functionTypes.add(aggType);
+            }
+
+            // if the stat has at least two different functions for it, promote it as stat
+            // also keep the promoted function around for reuse
+            public AggregateFunction maybePromote(AggregateFunction agg) {
+                if (functionTypes.size() > 1) {
+                    if (innerAggs == null) {
+                        innerAggs = new LinkedHashMap<>();
                     }
+                    return innerAggs.computeIfAbsent(agg.getClass(), k -> new InnerAggregate(agg, stats));
                 }
+                return agg;
             }
+        }
 
-            return false;
+        @Override
+        public LogicalPlan apply(LogicalPlan p) {
+            // 1. first check whether there are at least 2 aggs for the same fields so that there can be a promotion
+            final Map<Expression, Match> potentialPromotions = new LinkedHashMap<>();
+
+            p.forEachExpressionsUp(e -> {
+                if (Stats.isTypeCompatible(e)) {
+                    AggregateFunction f = (AggregateFunction) e;
+
+                    Expression argument = f.field();
+                    Match match = potentialPromotions.get(argument);
+
+                    if (match == null) {
+                        Source source = new Source(f.sourceLocation(), "STATS(" + argument.sourceText() + ")");
+                        match = new Match(new Stats(source, argument));
+                        potentialPromotions.put(argument, match);
+                    }
+                    match.add(f.getClass());
+                }
+            });
+
+            // no promotions found - skip
+            if (potentialPromotions.isEmpty()) {
+                return p;
+            }
+
+            // start promotion
+
+            // 2. promote aggs to InnerAggs
+            return p.transformExpressionsUp(e -> {
+                if (Stats.isTypeCompatible(e)) {
+                    AggregateFunction f = (AggregateFunction) e;
+
+                    Expression argument = f.field();
+                    Match match = potentialPromotions.get(argument);
+
+                    if (match != null) {
+                        return match.maybePromote(f);
+                    }
+                }
+                return e;
+            });
+        }
+    }
+
+    static class PromoteStatsToExtendedStats extends OptimizerBasicRule {
+
+        @Override
+        public LogicalPlan apply(LogicalPlan p) {
+            final Map<Expression, ExtendedStats> seen = new LinkedHashMap<>();
+
+            // count the extended stats
+            p.forEachExpressionsUp(e -> {
+                if (e instanceof InnerAggregate) {
+                    InnerAggregate ia = (InnerAggregate) e;
+                    if (ia.outer() instanceof ExtendedStats) {
+                        ExtendedStats extStats = (ExtendedStats) ia.outer();
+                        seen.putIfAbsent(extStats.field(), extStats);
+                    }
+                }
+            });
+
+            // then if there's a match, replace the stat inside the InnerAgg
+            return p.transformExpressionsUp(e -> {
+                if (e instanceof InnerAggregate) {
+                    InnerAggregate ia = (InnerAggregate) e;
+                    if (ia.outer() instanceof Stats) {
+                        Stats stats = (Stats) ia.outer();
+                        ExtendedStats ext = seen.get(stats.field());
+                        if (ext != null && stats.field().equals(ext.field())) {
+                            return new InnerAggregate(ia.inner(), ext);
+                        }
+                    }
+                }
+
+                return e;
+            });
+        }
+    }
+
+    static class ReplaceAggsWithPercentiles extends OptimizerBasicRule {
+
+        @Override
+        public LogicalPlan apply(LogicalPlan p) {
+            // percentile per field/expression
+            Map<Expression, Set<Expression>> percentsPerField = new LinkedHashMap<>();
+
+            // count gather the percents for each field
+            p.forEachExpressionsUp(e -> {
+                if (e instanceof Percentile) {
+                    Percentile per = (Percentile) e;
+                    Expression field = per.field();
+                    Set<Expression> percentiles = percentsPerField.get(field);
+
+                    if (percentiles == null) {
+                        percentiles = new LinkedHashSet<>();
+                        percentsPerField.put(field, percentiles);
+                    }
+
+                    percentiles.add(per.percent());
+                }
+            });
+
+            Map<Expression, Percentiles> percentilesPerField = new LinkedHashMap<>();
+            // create a Percentile agg for each field (and its associated percents)
+            percentsPerField.forEach((k, v) -> {
+                percentilesPerField.put(k, new Percentiles(v.iterator().next().source(), k, new ArrayList<>(v)));
+            });
+
+            return p.transformExpressionsUp(e -> {
+                if (e instanceof Percentile) {
+                    Percentile per = (Percentile) e;
+                    Percentiles percentiles = percentilesPerField.get(per.field());
+                    return new InnerAggregate(per, percentiles);
+                }
+
+                return e;
+            });
+        }
+    }
+
+    static class ReplaceAggsWithPercentileRanks extends OptimizerBasicRule {
+
+        @Override
+        public LogicalPlan apply(LogicalPlan p) {
+            // percentile per field/expression
+            final Map<Expression, Set<Expression>> percentPerField = new LinkedHashMap<>();
+
+            // count gather the percents for each field
+            p.forEachExpressionsUp(e -> {
+                if (e instanceof PercentileRank) {
+                    PercentileRank per = (PercentileRank) e;
+                    Expression field = per.field();
+                    Set<Expression> percentiles = percentPerField.get(field);
+
+                    if (percentiles == null) {
+                        percentiles = new LinkedHashSet<>();
+                        percentPerField.put(field, percentiles);
+                    }
+
+                    percentiles.add(per.value());
+                }
+            });
+
+            Map<Expression, PercentileRanks> ranksPerField = new LinkedHashMap<>();
+            // create a PercentileRanks agg for each field (and its associated values)
+            percentPerField.forEach((k, v) -> {
+                ranksPerField.put(k, new PercentileRanks(v.iterator().next().source(), k, new ArrayList<>(v)));
+            });
+
+            return p.transformExpressionsUp(e -> {
+                if (e instanceof PercentileRank) {
+                    PercentileRank per = (PercentileRank) e;
+                    PercentileRanks ranks = ranksPerField.get(per.field());
+                    return new InnerAggregate(per, ranks);
+                }
+
+                return e;
+            });
+        }
+    }
+
+    static class ReplaceMinMaxWithTopHits extends OptimizerRule<LogicalPlan> {
+
+        @Override
+        protected LogicalPlan rule(LogicalPlan plan) {
+            Map<Expression, TopHits> mins = new HashMap<>();
+            Map<Expression, TopHits> maxs = new HashMap<>();
+            return plan.transformExpressionsDown(e -> {
+                if (e instanceof Min) {
+                    Min min = (Min) e;
+                    if (min.field().dataType().isString()) {
+                        return mins.computeIfAbsent(min.field(), k -> new First(min.source(), k, null));
+                    }
+                }
+                if (e instanceof Max) {
+                    Max max = (Max) e;
+                    if (max.field().dataType().isString()) {
+                        return maxs.computeIfAbsent(max.field(), k -> new Last(max.source(), k, null));
+                    }
+                }
+                return e;
+            });
+        }
+    }
+
+    static class PruneFilters extends OptimizerRule<Filter> {
+
+        @Override
+        protected LogicalPlan rule(Filter filter) {
+            Expression condition = filter.condition().transformUp(PruneFilters::foldBinaryLogic);
+
+            if (condition instanceof Literal) {
+                if (TRUE.equals(condition)) {
+                    return filter.child();
+                }
+                if (FALSE.equals(condition) || Expressions.isNull(condition)) {
+                    return new LocalRelation(filter.source(), new EmptyExecutable(filter.output()));
+                }
+            }
+
+            if (!condition.equals(filter.condition())) {
+                return new Filter(filter.source(), filter.child(), condition);
+            }
+            return filter;
+        }
+
+        private static Expression foldBinaryLogic(Expression expression) {
+            if (expression instanceof Or) {
+                Or or = (Or) expression;
+                boolean nullLeft = Expressions.isNull(or.left());
+                boolean nullRight = Expressions.isNull(or.right());
+                if (nullLeft && nullRight) {
+                    return Literal.NULL;
+                }
+                if (nullLeft) {
+                    return or.right();
+                }
+                if (nullRight) {
+                    return or.left();
+                }
+            }
+            if (expression instanceof And) {
+                And and = (And) expression;
+                if (Expressions.isNull(and.left()) || Expressions.isNull(and.right())) {
+                    return Literal.NULL;
+                }
+            }
+            return expression;
         }
     }
 
+
     static class SkipQueryOnLimitZero extends OptimizerRule<Limit> {
         @Override
         protected LogicalPlan rule(Limit limit) {
@@ -2104,6 +1899,17 @@ protected LogicalPlan rule(LogicalPlan plan) {
         protected abstract Expression rule(Expression e);
     }
 
+    abstract static class OptimizerBasicRule extends Rule<LogicalPlan, LogicalPlan> {
+
+        @Override
+        public abstract LogicalPlan apply(LogicalPlan plan);
+
+        @Override
+        protected LogicalPlan rule(LogicalPlan plan) {
+            return plan;
+        }
+    }
+
     enum TransformDirection {
         UP, DOWN
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ExpressionBuilder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ExpressionBuilder.java
index 5a1e09f602a48..524d4e8b75a8e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ExpressionBuilder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ExpressionBuilder.java
@@ -20,6 +20,7 @@
 import org.elasticsearch.xpack.sql.expression.Order;
 import org.elasticsearch.xpack.sql.expression.Order.NullsPosition;
 import org.elasticsearch.xpack.sql.expression.ScalarSubquery;
+import org.elasticsearch.xpack.sql.expression.UnresolvedAlias;
 import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
 import org.elasticsearch.xpack.sql.expression.UnresolvedStar;
 import org.elasticsearch.xpack.sql.expression.function.Function;
@@ -157,10 +158,8 @@ public Expression visitSingleExpression(SingleExpressionContext ctx) {
     public Expression visitSelectExpression(SelectExpressionContext ctx) {
         Expression exp = expression(ctx.expression());
         String alias = visitIdentifier(ctx.identifier());
-        if (alias != null) {
-            exp = new Alias(source(ctx), alias, exp);
-        }
-        return exp;
+        Source source = source(ctx);
+        return alias != null ? new Alias(source, alias, exp) : new UnresolvedAlias(source, exp);
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Pivot.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Pivot.java
index fe06e1bb01869..35447ecb40510 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Pivot.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Pivot.java
@@ -6,21 +6,25 @@
 
 package org.elasticsearch.xpack.sql.plan.logical;
 
+import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.capabilities.Resolvables;
+import org.elasticsearch.xpack.sql.expression.Alias;
 import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.sql.expression.AttributeMap;
 import org.elasticsearch.xpack.sql.expression.AttributeSet;
 import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
 import org.elasticsearch.xpack.sql.expression.Expressions;
+import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.function.Function;
 import org.elasticsearch.xpack.sql.tree.NodeInfo;
 import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.ArrayList;
+import java.util.LinkedHashMap;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
-import java.util.stream.Collectors;
 
 import static java.util.Collections.singletonList;
 
@@ -29,49 +33,48 @@ public class Pivot extends UnaryPlan {
     private final Expression column;
     private final List<NamedExpression> values;
     private final List<NamedExpression> aggregates;
+    private final List<Attribute> grouping;
     // derived properties
     private AttributeSet groupingSet;
     private AttributeSet valueOutput;
     private List<Attribute> output;
+    private AttributeMap<Expression> aliases;
 
     public Pivot(Source source, LogicalPlan child, Expression column, List<NamedExpression> values, List<NamedExpression> aggregates) {
+        this(source, child, column, values, aggregates, null);
+    }
+    
+    public Pivot(Source source, LogicalPlan child, Expression column, List<NamedExpression> values, List<NamedExpression> aggregates,
+            List<Attribute> grouping) {
         super(source, child);
         this.column = column;
         this.values = values;
         this.aggregates = aggregates;
-    }
-
-    private static Expression withQualifierNull(Expression e) {
-        if (e instanceof Attribute) {
-            Attribute fa = (Attribute) e;
-            return fa.withQualifier(null);
+        
+        // resolve the grouping set ASAP so it doesn't get re-resolved after analysis (since the aliasing information has been removed)
+        if (grouping == null && expressionsResolved()) {
+            AttributeSet columnSet = Expressions.references(singletonList(column));
+            // grouping can happen only on "primitive" fields, thus exclude multi-fields or nested docs
+            // the verifier enforces this rule so it does not catch folks by surprise
+            grouping = new ArrayList<>(new AttributeSet(Expressions.onlyPrimitiveFieldAttributes(child().output()))
+                    // make sure to have the column as the last entry (helps with translation) so substract it
+                    .subtract(columnSet)
+                    .subtract(Expressions.references(aggregates))
+                    .combine(columnSet));
         }
-        return e;
+
+        this.grouping = grouping;
+        this.groupingSet = grouping != null ? new AttributeSet(grouping) : null;
     }
 
     @Override
     protected NodeInfo<Pivot> info() {
-        return NodeInfo.create(this, Pivot::new, child(), column, values, aggregates);
+        return NodeInfo.create(this, Pivot::new, child(), column, values, aggregates, grouping);
     }
 
     @Override
     protected Pivot replaceChild(LogicalPlan newChild) {
-        Expression newColumn = column;
-        List<NamedExpression> newAggregates = aggregates;
-
-        if (newChild instanceof EsRelation) {
-            // when changing from a SubQueryAlias to EsRelation
-            // the qualifier of the column and aggregates needs
-            // to be changed to null like the attributes of EsRelation
-            // otherwise they don't equal and aren't removed
-            // when calculating the groupingSet
-            newColumn = column.transformUp(Pivot::withQualifierNull);
-            newAggregates = aggregates.stream().map((NamedExpression aggregate) ->
-                (NamedExpression) aggregate.transformUp(Pivot::withQualifierNull)
-            ).collect(Collectors.toUnmodifiableList());
-        }
-
-        return new Pivot(source(), newChild, newColumn, values, newAggregates);
+        return new Pivot(source(), newChild, column, values, aggregates, grouping);
     }
 
     public Expression column() {
@@ -86,38 +89,39 @@ public List<NamedExpression> aggregates() {
         return aggregates;
     }
     
+    public List<Attribute> groupings() {
+        return grouping;
+    }
+    
     public AttributeSet groupingSet() {
         if (groupingSet == null) {
-            AttributeSet columnSet = Expressions.references(singletonList(column));
-            // grouping can happen only on "primitive" fields, thus exclude multi-fields or nested docs
-            // the verifier enforces this rule so it does not catch folks by surprise
-            groupingSet = new AttributeSet(Expressions.onlyPrimitiveFieldAttributes(child().output()))
-                    // make sure to have the column as the last entry (helps with translation)
-                    .subtract(columnSet)
-                    .subtract(Expressions.references(aggregates))
-                    .combine(columnSet);
+            throw new SqlIllegalArgumentException("Cannot determine grouping in unresolved PIVOT");
         }
         return groupingSet;
     }
 
-    public AttributeSet valuesOutput() {
-        // TODO: the generated id is a hack since it can clash with other potentially generated ids
+    private AttributeSet valuesOutput() {
         if (valueOutput == null) {
             List<Attribute> out = new ArrayList<>(aggregates.size() * values.size());
             if (aggregates.size() == 1) {
                 NamedExpression agg = aggregates.get(0);
                 for (NamedExpression value : values) {
-                    ExpressionId id = value.id();
-                    out.add(value.toAttribute().withDataType(agg.dataType()).withId(id));
+                    out.add(value.toAttribute().withDataType(agg.dataType()));
                 }
             }
             // for multiple args, concat the function and the value
             else {
                 for (NamedExpression agg : aggregates) {
-                    String name = agg instanceof Function ? ((Function) agg).functionName() : agg.name();
+                    String name = agg.name();
+                    if (agg instanceof Alias) {
+                        Alias a = (Alias) agg;
+                        if (a.child() instanceof Function) {
+                            name = ((Function) a.child()).functionName();
+                        }
+                    }
+                    //FIXME: the value attributes are reused and thus will clash - new ids need to be created
                     for (NamedExpression value : values) {
-                        ExpressionId id = value.id();
-                        out.add(value.toAttribute().withName(value.name() + "_" + name).withDataType(agg.dataType()).withId(id));
+                        out.add(value.toAttribute().withName(value.name() + "_" + name).withDataType(agg.dataType()));
                     }
                 }
             }
@@ -126,6 +130,29 @@ public AttributeSet valuesOutput() {
         return valueOutput;
     }
     
+    public AttributeMap<Literal> valuesToLiterals() {
+        AttributeSet outValues = valuesOutput();
+        Map<Attribute, Literal> valuesMap = new LinkedHashMap<>();
+
+        int index = 0;
+        // for each attribute, associate its value
+        // take into account while iterating that attributes are a multiplication of actual values
+        for (Attribute attribute : outValues) {
+            NamedExpression namedExpression = values.get(index % values.size());
+            index++;
+            // everything should have resolved to an alias
+            if (namedExpression instanceof Alias) {
+                valuesMap.put(attribute, Literal.of(((Alias) namedExpression).child()));
+            }
+            // fallback - verifier should prevent this
+            else {
+                throw new SqlIllegalArgumentException("Unexpected alias", namedExpression);
+            }
+        }
+
+        return new AttributeMap<>(valuesMap);
+    }
+
     @Override
     public List<Attribute> output() {
         if (output == null) {
@@ -137,6 +164,14 @@ public List<Attribute> output() {
         return output;
     }
 
+    // Since pivot creates its own columns (and thus aliases)
+    // remember the backing expressions inside a dedicated aliases map
+    public AttributeMap<Expression> aliases() {
+        // make sure to initialize all expressions
+        output();
+        return aliases;
+    }
+
     @Override
     public boolean expressionsResolved() {
         return column.resolved() && Resolvables.resolved(values) && Resolvables.resolved(aggregates);
@@ -163,4 +198,4 @@ public boolean equals(Object obj) {
                 && Objects.equals(aggregates, other.aggregates)
                 && Objects.equals(child(), other.child());
     }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/SubQueryAlias.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/SubQueryAlias.java
index 980cd0a849a52..dd8fa5bec430e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/SubQueryAlias.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/SubQueryAlias.java
@@ -17,6 +17,7 @@
 public class SubQueryAlias extends UnaryPlan {
 
     private final String alias;
+    private List<Attribute> output;
 
     public SubQueryAlias(Source source, LogicalPlan child, String alias) {
         super(source, child);
@@ -39,11 +40,13 @@ public String alias() {
 
     @Override
     public List<Attribute> output() {
-        return (alias == null ? child().output() :
+        if (output == null) {
+            output = alias == null ? child().output() :
                 child().output().stream()
                 .map(e -> e.withQualifier(alias))
-                .collect(toList())
-                );
+                .collect(toList()); 
+        }
+        return output;
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryFolder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryFolder.java
index 8dc9b5b595add..72e4ca380fd33 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryFolder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryFolder.java
@@ -12,29 +12,34 @@
 import org.elasticsearch.xpack.sql.expression.Alias;
 import org.elasticsearch.xpack.sql.expression.Attribute;
 import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.AttributeSet;
 import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
 import org.elasticsearch.xpack.sql.expression.Expressions;
+import org.elasticsearch.xpack.sql.expression.FieldAttribute;
 import org.elasticsearch.xpack.sql.expression.Foldables;
+import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.Order;
+import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
 import org.elasticsearch.xpack.sql.expression.function.Function;
 import org.elasticsearch.xpack.sql.expression.function.Functions;
-import org.elasticsearch.xpack.sql.expression.function.ScoreAttribute;
+import org.elasticsearch.xpack.sql.expression.function.Score;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.CompoundNumericAggregate;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
 import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.sql.expression.function.grouping.Histogram;
 import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunctionAttribute;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeHistogramFunction;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.Year;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggPathInput;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.UnaryPipe;
 import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
+import org.elasticsearch.xpack.sql.expression.literal.Intervals;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
 import org.elasticsearch.xpack.sql.plan.physical.AggregateExec;
 import org.elasticsearch.xpack.sql.plan.physical.EsQueryExec;
@@ -45,12 +50,15 @@
 import org.elasticsearch.xpack.sql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.sql.plan.physical.PivotExec;
 import org.elasticsearch.xpack.sql.plan.physical.ProjectExec;
-import org.elasticsearch.xpack.sql.planner.QueryTranslator.GroupingContext;
 import org.elasticsearch.xpack.sql.planner.QueryTranslator.QueryTranslation;
 import org.elasticsearch.xpack.sql.querydsl.agg.AggFilter;
 import org.elasticsearch.xpack.sql.querydsl.agg.Aggs;
+import org.elasticsearch.xpack.sql.querydsl.agg.GroupByDateHistogram;
 import org.elasticsearch.xpack.sql.querydsl.agg.GroupByKey;
+import org.elasticsearch.xpack.sql.querydsl.agg.GroupByNumericHistogram;
+import org.elasticsearch.xpack.sql.querydsl.agg.GroupByValue;
 import org.elasticsearch.xpack.sql.querydsl.agg.LeafAgg;
+import org.elasticsearch.xpack.sql.querydsl.container.AggregateSort;
 import org.elasticsearch.xpack.sql.querydsl.container.AttributeSort;
 import org.elasticsearch.xpack.sql.querydsl.container.ComputedRef;
 import org.elasticsearch.xpack.sql.querydsl.container.GlobalCountRef;
@@ -69,18 +77,21 @@
 import org.elasticsearch.xpack.sql.rule.RuleExecutor;
 import org.elasticsearch.xpack.sql.session.EmptyExecutable;
 import org.elasticsearch.xpack.sql.util.Check;
+import org.elasticsearch.xpack.sql.util.DateUtils;
 
+import java.time.Period;
 import java.util.ArrayList;
 import java.util.Arrays;
-import java.util.HashMap;
 import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.Map.Entry;
 import java.util.concurrent.atomic.AtomicReference;
 
 import static org.elasticsearch.xpack.sql.planner.QueryTranslator.and;
 import static org.elasticsearch.xpack.sql.planner.QueryTranslator.toAgg;
 import static org.elasticsearch.xpack.sql.planner.QueryTranslator.toQuery;
+import static org.elasticsearch.xpack.sql.type.DataType.DATE;
 import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
 
 /**
@@ -123,38 +134,26 @@ protected PhysicalPlan rule(ProjectExec project) {
                 EsQueryExec exec = (EsQueryExec) project.child();
                 QueryContainer queryC = exec.queryContainer();
 
-                Map<ExpressionId, Attribute> aliases = new LinkedHashMap<>(queryC.aliases());
+                Map<Attribute, Expression> aliases = new LinkedHashMap<>(queryC.aliases());
                 Map<Attribute, Pipe> processors = new LinkedHashMap<>(queryC.scalarFunctions());
 
                 for (NamedExpression pj : project.projections()) {
                     if (pj instanceof Alias) {
-                        Attribute aliasAttr = pj.toAttribute();
+                        Attribute attr = pj.toAttribute();
                         Expression e = ((Alias) pj).child();
 
-                        if (e instanceof NamedExpression) {
-                            Attribute attr = ((NamedExpression) e).toAttribute();
-                            aliases.put(aliasAttr.id(), attr);
-                            // add placeholder for each scalar function
-                            if (e instanceof ScalarFunction) {
-                                processors.put(attr, Expressions.pipe(e));
-                            }
-                        } else {
-                            processors.put(aliasAttr, Expressions.pipe(e));
-                        }
-                    }
-                    else {
-                        // for named expressions nothing is recorded as these are resolved last
-                        // otherwise 'intermediate' projects might pollute the
-                        // output
-                        if (pj instanceof ScalarFunction) {
-                            ScalarFunction f = (ScalarFunction) pj;
-                            processors.put(f.toAttribute(), Expressions.pipe(f));
+                        // track all aliases (to determine their reference later on)
+                        aliases.put(attr, e);
+
+                        // track scalar pipelines
+                        if (e instanceof ScalarFunction) {
+                            processors.put(attr, ((ScalarFunction) e).asPipe());
                         }
                     }
                 }
 
                 QueryContainer clone = new QueryContainer(queryC.query(), queryC.aggs(), queryC.fields(),
-                        new HashMap<>(aliases),
+                        new AttributeMap<>(aliases),
                         queryC.pseudoFunctions(),
                         new AttributeMap<>(processors),
                         queryC.sort(),
@@ -214,7 +213,176 @@ private Aggs addPipelineAggs(QueryContainer qContainer, QueryTranslation qt, Fil
         }
     }
 
-    private static class FoldAggregate extends FoldingRule<AggregateExec> {
+    // TODO: remove exceptions from the Folder
+    static class FoldAggregate extends FoldingRule<AggregateExec> {
+
+        static class GroupingContext {
+            final Map<Integer, GroupByKey> groupMap;
+            final GroupByKey tail;
+
+            GroupingContext(Map<Integer, GroupByKey> groupMap) {
+                this.groupMap = groupMap;
+
+                GroupByKey lastAgg = null;
+                for (Entry<Integer, GroupByKey> entry : groupMap.entrySet()) {
+                    lastAgg = entry.getValue();
+                }
+
+                tail = lastAgg;
+            }
+
+            GroupByKey groupFor(Expression exp) {
+                Integer hash = null;
+                if (Functions.isAggregate(exp)) {
+                    AggregateFunction f = (AggregateFunction) exp;
+                    // if there's at least one agg in the tree
+                    if (groupMap.isEmpty() == false) {
+                        GroupByKey matchingGroup = null;
+                        // group found - finding the dedicated agg
+                        // TODO: when dealing with expressions inside Aggregation, make sure to extract the field
+                        hash = Integer.valueOf(f.field().hashCode());
+                        matchingGroup = groupMap.get(hash);
+                        // return matching group or the tail (last group)
+                        return matchingGroup != null ? matchingGroup : tail;
+                    } else {
+                        return null;
+                    }
+                }
+
+                hash = Integer.valueOf(exp.hashCode());
+                return groupMap.get(hash);
+            }
+
+            @Override
+            public String toString() {
+                return groupMap.toString();
+            }
+        }
+
+        /**
+         * Creates the list of GroupBy keys
+         */
+        static GroupingContext groupBy(List<? extends Expression> groupings) {
+            if (groupings.isEmpty() == true) {
+                return null;
+            }
+
+            Map<Integer, GroupByKey> aggMap = new LinkedHashMap<>();
+
+            for (Expression exp : groupings) {
+                GroupByKey key = null;
+
+                Integer hash = Integer.valueOf(exp.hashCode());
+                String aggId = Expressions.id(exp);
+
+                // change analyzed to non non-analyzed attributes
+                if (exp instanceof FieldAttribute) {
+                    FieldAttribute field = (FieldAttribute) exp;
+                    field = field.exactAttribute();
+                    key = new GroupByValue(aggId, field.name());
+                }
+
+                // handle functions
+                else if (exp instanceof Function) {
+                    // dates are handled differently because of date histograms
+                    if (exp instanceof DateTimeHistogramFunction) {
+                        DateTimeHistogramFunction dthf = (DateTimeHistogramFunction) exp;
+
+                        Expression field = dthf.field();
+                        if (field instanceof FieldAttribute) {
+                            if (dthf.calendarInterval() != null) {
+                                key = new GroupByDateHistogram(aggId, QueryTranslator.nameOf(exp), dthf.calendarInterval(), dthf.zoneId());
+                            } else {
+                                key = new GroupByDateHistogram(aggId, QueryTranslator.nameOf(exp), dthf.fixedInterval(), dthf.zoneId());
+                            }
+                        }
+                        // use scripting for functions
+                        else if (field instanceof Function) {
+                            ScriptTemplate script = ((Function) field).asScript();
+                            if (dthf.calendarInterval() != null) {
+                                key = new GroupByDateHistogram(aggId, script, dthf.calendarInterval(), dthf.zoneId());
+                            } else {
+                                key = new GroupByDateHistogram(aggId, script, dthf.fixedInterval(), dthf.zoneId());
+                            }
+                        }
+                    }
+                    // all other scalar functions become a script
+                    else if (exp instanceof ScalarFunction) {
+                        ScalarFunction sf = (ScalarFunction) exp;
+                        key = new GroupByValue(aggId, sf.asScript());
+                    }
+                    // histogram
+                    else if (exp instanceof GroupingFunction) {
+                        if (exp instanceof Histogram) {
+                            Histogram h = (Histogram) exp;
+                            Expression field = h.field();
+
+                            // date histogram
+                            if (h.dataType().isDateBased()) {
+                                Object value = h.interval().value();
+                                // interval of exactly 1 year
+                                if (value instanceof IntervalYearMonth
+                                        && ((IntervalYearMonth) value).interval().equals(Period.ofYears(1))) {
+                                    String calendarInterval = Year.YEAR_INTERVAL;
+
+                                    // When the histogram is `INTERVAL '1' YEAR`, the interval used in the ES date_histogram will be
+                                    // a calendar_interval with value "1y". All other intervals will be fixed_intervals expressed in ms.
+                                    if (field instanceof FieldAttribute) {
+                                        key = new GroupByDateHistogram(aggId, QueryTranslator.nameOf(field), calendarInterval, h.zoneId());
+                                    } else if (field instanceof Function) {
+                                        key = new GroupByDateHistogram(aggId, ((Function) field).asScript(), calendarInterval, h.zoneId());
+                                    }
+                                }
+                                // typical interval
+                                else {
+                                    long intervalAsMillis = Intervals.inMillis(h.interval());
+
+                                    // When the histogram in SQL is applied on DATE type instead of DATETIME, the interval
+                                    // specified is truncated to the multiple of a day. If the interval specified is less
+                                    // than 1 day, then the interval used will be `INTERVAL '1' DAY`.
+                                    if (h.dataType() == DATE) {
+                                        intervalAsMillis = DateUtils.minDayInterval(intervalAsMillis);
+                                    }
+
+                                    if (field instanceof FieldAttribute) {
+                                        key = new GroupByDateHistogram(aggId, QueryTranslator.nameOf(field), intervalAsMillis, h.zoneId());
+                                    } else if (field instanceof Function) {
+                                        key = new GroupByDateHistogram(aggId, ((Function) field).asScript(), intervalAsMillis, h.zoneId());
+                                    }
+                                }
+                            }
+                            // numeric histogram
+                            else {
+                                if (field instanceof FieldAttribute) {
+                                    key = new GroupByNumericHistogram(aggId, QueryTranslator.nameOf(field),
+                                            Foldables.doubleValueOf(h.interval()));
+                                } else if (field instanceof Function) {
+                                    key = new GroupByNumericHistogram(aggId, ((Function) field).asScript(),
+                                            Foldables.doubleValueOf(h.interval()));
+                                }
+                            }
+                            if (key == null) {
+                                throw new SqlIllegalArgumentException("Unsupported histogram field {}", field);
+                            }
+                        } else {
+                            throw new SqlIllegalArgumentException("Unsupproted grouping function {}", exp);
+                        }
+                    }
+                    // bumped into into an invalid function (which should be caught by the verifier)
+                    else {
+                        throw new SqlIllegalArgumentException("Cannot GROUP BY function {}", exp);
+                    }
+                }
+                // catch corner-case
+                else {
+                    throw new SqlIllegalArgumentException("Cannot GROUP BY {}", exp);
+                }
+
+                aggMap.put(hash, key);
+            }
+            return new GroupingContext(aggMap);
+        }
+
         @Override
         protected PhysicalPlan rule(AggregateExec a) {
             if (a.child() instanceof EsQueryExec) {
@@ -225,46 +393,71 @@ protected PhysicalPlan rule(AggregateExec a) {
         }
         
         static EsQueryExec fold(AggregateExec a, EsQueryExec exec) {
-            // build the group aggregation
-            // and also collect info about it (since the group columns might be used inside the select)
+            
+            QueryContainer queryC = exec.queryContainer();
+            
+            // track aliases defined in the SELECT and used inside GROUP BY
+            // SELECT x AS a ... GROUP BY a
+            Map<Attribute, Expression> aliasMap = new LinkedHashMap<>();
+            for (NamedExpression ne : a.aggregates()) {
+                if (ne instanceof Alias) {
+                    aliasMap.put(ne.toAttribute(), ((Alias) ne).child());
+                }
+            }
+            
+            if (aliasMap.isEmpty() == false) {
+                Map<Attribute, Expression> newAliases = new LinkedHashMap<>(queryC.aliases());
+                newAliases.putAll(aliasMap);
+                queryC = queryC.withAliases(new AttributeMap<>(newAliases));
+            }
 
-            GroupingContext groupingContext = QueryTranslator.groupBy(a.groupings());
+            // build the group aggregation
+            // NB: any reference in grouping is already "optimized" by its source so there's no need to look for aliases
+            GroupingContext groupingContext = groupBy(a.groupings());
 
-            QueryContainer queryC = exec.queryContainer();
             if (groupingContext != null) {
                 queryC = queryC.addGroups(groupingContext.groupMap.values());
             }
 
-            Map<ExpressionId, Attribute> aliases = new LinkedHashMap<>();
             // tracker for compound aggs seen in a group
             Map<CompoundNumericAggregate, String> compoundAggMap = new LinkedHashMap<>();
 
             // followed by actual aggregates
             for (NamedExpression ne : a.aggregates()) {
 
-                // unwrap alias - it can be
-                // - an attribute (since we support aliases inside group-by)
-                //   SELECT emp_no ... GROUP BY emp_no
+                // unwrap alias (since we support aliases declared inside SELECTs to be used by the GROUP BY)
+                // An alias can point to :
+                // - field
+                //   SELECT emp_no AS e ... GROUP BY e
+                // - a function
                 //   SELECT YEAR(hire_date) ... GROUP BY YEAR(hire_date)
 
-                // - an agg function (typically)
+                // - an agg function over the grouped field
                 //   SELECT COUNT(*), AVG(salary) ... GROUP BY salary;
 
-                // - a scalar function, which can be applied on an attribute or aggregate and can require one or multiple inputs
+                // - a scalar function, which can be applied on a column or aggregate and can require one or multiple inputs
 
                 //   SELECT SIN(emp_no) ... GROUP BY emp_no
                 //   SELECT CAST(YEAR(hire_date)) ... GROUP BY YEAR(hire_date)
                 //   SELECT CAST(AVG(salary)) ... GROUP BY salary
                 //   SELECT AVG(salary) + SIN(MIN(salary)) ... GROUP BY salary
 
-                if (ne instanceof Alias || ne instanceof Function) {
-                    Alias as = ne instanceof Alias ? (Alias) ne : null;
-                    Expression child = as != null ? as.child() : ne;
+                Expression target = ne;
 
-                    // record aliases in case they are later referred in the tree
-                    if (as != null && as.child() instanceof NamedExpression) {
-                        aliases.put(as.toAttribute().id(), ((NamedExpression) as.child()).toAttribute());
-                    }
+                // unwrap aliases since it's the children we are interested in
+                if (ne instanceof Alias) {
+                    target = ((Alias) ne).child();
+                }
+
+                String id = Expressions.id(target);
+
+                // literal
+                if (target.foldable()) {
+                    queryC = queryC.addColumn(ne.toAttribute());
+                }
+
+                // look at functions
+                else if (target instanceof Function) {
 
                     //
                     // look first for scalar functions which might wrap the actual grouped target
@@ -273,12 +466,14 @@ static EsQueryExec fold(AggregateExec a, EsQueryExec exec) {
                     // ABS(YEAR(field)) GROUP BY YEAR(field) or
                     // ABS(AVG(salary)) ... GROUP BY salary
                     // )
-                    if (child instanceof ScalarFunction) {
-                        ScalarFunction f = (ScalarFunction) child;
+
+                    if (target instanceof ScalarFunction) {
+                        ScalarFunction f = (ScalarFunction) target;
                         Pipe proc = f.asPipe();
 
                         final AtomicReference<QueryContainer> qC = new AtomicReference<>(queryC);
 
+                        // traverse the pipe to find the mandatory grouping expression
                         proc = proc.transformUp(p -> {
                             // bail out if the def is resolved
                             if (p.resolved()) {
@@ -295,6 +490,7 @@ static EsQueryExec fold(AggregateExec a, EsQueryExec exec) {
                             } else {
                                 // a scalar function can be used only if has already been mentioned for grouping
                                 // (otherwise it is the opposite of grouping)
+                                // normally this case should be caught by the Verifier
                                 if (exp instanceof ScalarFunction) {
                                     throw new FoldingException(exp,
                                             "Scalar function " + exp.toString() + " can be used only if included already in grouping");
@@ -332,77 +528,71 @@ static EsQueryExec fold(AggregateExec a, EsQueryExec exec) {
                             return p;
                         });
 
-                        if (!proc.resolved()) {
-                            throw new FoldingException(child, "Cannot find grouping for '{}'", Expressions.name(child));
+                        if (proc.resolved() == false) {
+                            throw new FoldingException(target, "Cannot find grouping for '{}'", Expressions.name(target));
                         }
 
                         // add the computed column
-                        queryC = qC.get().addColumn(new ComputedRef(proc), f.toAttribute());
-
-                        // TODO: is this needed?
-                        // redirect the alias to the scalar group id (changing the id altogether doesn't work it is
-                        // already used in the aggpath)
-                        //aliases.put(as.toAttribute(), sf.toAttribute());
+                        queryC = qC.get().addColumn(new ComputedRef(proc), id);
                     }
+
                     // apply the same logic above (for function inputs) to non-scalar functions with small variations:
                     //  instead of adding things as input, add them as full blown column
                     else {
                         GroupByKey matchingGroup = null;
                         if (groupingContext != null) {
                             // is there a group (aggregation) for this expression ?
-                            matchingGroup = groupingContext.groupFor(child);
+                            matchingGroup = groupingContext.groupFor(target);
                         }
                         // attributes can only refer to declared groups
-                        if (child instanceof Attribute) {
-                            Check.notNull(matchingGroup, "Cannot find group [{}]", Expressions.name(child));
-                            queryC = queryC.addColumn(new GroupByRef(matchingGroup.id(), null, child.dataType().isDateBased()),
-                                    ((Attribute) child));
+                        if (target instanceof Attribute) {
+                            Check.notNull(matchingGroup, "Cannot find group [{}]", Expressions.name(target));
+                            queryC = queryC.addColumn(new GroupByRef(matchingGroup.id(), null, target.dataType().isDateBased()), id);
                         }
                         // handle histogram
-                        else if (child instanceof GroupingFunction) {
-                            queryC = queryC.addColumn(new GroupByRef(matchingGroup.id(), null, child.dataType().isDateBased()),
-                                    ((GroupingFunction) child).toAttribute());
+                        else if (target instanceof GroupingFunction) {
+                            queryC = queryC.addColumn(new GroupByRef(matchingGroup.id(), null, target.dataType().isDateBased()), id);
+                        }
+                        // handle literal
+                        else if (target.foldable()) {
+                            queryC = queryC.addColumn(ne.toAttribute());
                         }
-                            else if (child.foldable()) {
-                                queryC = queryC.addColumn(ne.toAttribute());
-                            }
                         // fallback to regular agg functions
                         else {
                             // the only thing left is agg function
-                            Check.isTrue(Functions.isAggregate(child), "Expected aggregate function inside alias; got [{}]",
-                                    child.nodeString());
-                            AggregateFunction af = (AggregateFunction) child;
+                            Check.isTrue(Functions.isAggregate(target), "Expected aggregate function inside alias; got [{}]",
+                                    target.nodeString());
+                            AggregateFunction af = (AggregateFunction) target;
                             Tuple<QueryContainer, AggPathInput> withAgg = addAggFunction(matchingGroup, af, compoundAggMap, queryC);
                             // make sure to add the inner id (to handle compound aggs)
-                            queryC = withAgg.v1().addColumn(withAgg.v2().context(), af.toAttribute());
+                            queryC = withAgg.v1().addColumn(withAgg.v2().context(), id);
                         }
                     }
-                    // not an Alias or Function means it's an Attribute so apply the same logic as above
-                } else {
+
+                }
+                // not a Function or literal, means its has to be a field or field expression
+                else {
                     GroupByKey matchingGroup = null;
                     if (groupingContext != null) {
-                        matchingGroup = groupingContext.groupFor(ne);
+                        matchingGroup = groupingContext.groupFor(target);
                         Check.notNull(matchingGroup, "Cannot find group [{}]", Expressions.name(ne));
 
-                        queryC = queryC.addColumn(new GroupByRef(matchingGroup.id(), null, ne.dataType().isDateBased()), ne.toAttribute());
+                        queryC = queryC.addColumn(new GroupByRef(matchingGroup.id(), null, ne.dataType().isDateBased()), id);
                     }
-                        else if (ne.foldable()) {
-                            queryC = queryC.addColumn(ne.toAttribute());
-                        }
+                    // fallback
+                    else {
+                        throw new SqlIllegalArgumentException("Cannot fold aggregate {}", ne);
                     }
                 }
-
-            if (!aliases.isEmpty()) {
-                Map<ExpressionId, Attribute> newAliases = new LinkedHashMap<>(queryC.aliases());
-                newAliases.putAll(aliases);
-                queryC = queryC.withAliases(new HashMap<>(newAliases));
             }
+
             return new EsQueryExec(exec.source(), exec.index(), a.output(), queryC);
         }
 
         private static Tuple<QueryContainer, AggPathInput> addAggFunction(GroupByKey groupingAgg, AggregateFunction f,
                 Map<CompoundNumericAggregate, String> compoundAggMap, QueryContainer queryC) {
-            String functionId = f.functionId();
+
+            String functionId = Expressions.id(f);
             // handle count as a special case agg
             if (f instanceof Count) {
                 Count c = (Count) f;
@@ -422,7 +612,7 @@ private static Tuple<QueryContainer, AggPathInput> addAggFunction(GroupByKey gro
                     pseudoFunctions.put(functionId, groupingAgg);
                     return new Tuple<>(queryC.withPseudoFunctions(pseudoFunctions), new AggPathInput(f, ref));
                 // COUNT(<field_name>)
-                } else if (!c.distinct()) {
+                } else if (c.distinct() == false) {
                     LeafAgg leafAgg = toAgg(functionId, f);
                     AggPathInput a = new AggPathInput(f, new MetricAggRef(leafAgg.id(), "doc_count", "_count", false));
                     queryC = queryC.with(queryC.aggs().addAgg(leafAgg));
@@ -440,7 +630,7 @@ private static Tuple<QueryContainer, AggPathInput> addAggFunction(GroupByKey gro
 
                 // the compound agg hasn't been seen before so initialize it
                 if (cAggPath == null) {
-                    LeafAgg leafAgg = toAgg(outer.functionId(), outer);
+                    LeafAgg leafAgg = toAgg(Expressions.id(outer), outer);
                     cAggPath = leafAgg.id();
                     compoundAggMap.put(outer, cAggPath);
                     // add the agg (without any reference)
@@ -480,37 +670,60 @@ protected PhysicalPlan rule(OrderExec plan) {
                     Missing missing = Missing.from(order.nullsPosition());
 
                     // check whether sorting is on an group (and thus nested agg) or field
-                    Attribute attr = ((NamedExpression) order.child()).toAttribute();
-                    // check whether there's an alias (occurs with scalar functions which are not named)
-                    attr = qContainer.aliases().getOrDefault(attr.id(), attr);
-                    GroupByKey group = qContainer.findGroupForAgg(attr);
+                    Expression orderExpression = order.child();
+
+                    // if it's a reference, get the target expression
+                    if (orderExpression instanceof ReferenceAttribute) {
+                        orderExpression = qContainer.aliases().get(orderExpression);
+                    }
+                    String lookup = Expressions.id(orderExpression);
+                    GroupByKey group = qContainer.findGroupForAgg(lookup);
 
                     // TODO: might need to validate whether the target field or group actually exist
                     if (group != null && group != Aggs.IMPLICIT_GROUP_KEY) {
-                        qContainer = qContainer.updateGroup(group.with(direction));
+                        // check whether the lookup matches a group
+                        if (group.id().equals(lookup)) {
+                            qContainer = qContainer.updateGroup(group.with(direction));
+                        }
+                        // else it's a leafAgg
+                        else {
+                            qContainer = qContainer.updateGroup(group.with(direction));
+                        }
                     }
                     else {
                         // scalar functions typically require script ordering
-                        if (attr instanceof ScalarFunctionAttribute) {
-                            ScalarFunctionAttribute sfa = (ScalarFunctionAttribute) attr;
+                        if (orderExpression instanceof ScalarFunction) {
+                            ScalarFunction sf = (ScalarFunction) orderExpression;
                             // is there an expression to order by?
-                            if (sfa.orderBy() != null) {
-                                if (sfa.orderBy() instanceof NamedExpression) {
-                                    Attribute at = ((NamedExpression) sfa.orderBy()).toAttribute();
-                                    at = qContainer.aliases().getOrDefault(at.id(), at);
-                                    qContainer = qContainer.addSort(new AttributeSort(at, direction, missing));
-                                } else if (!sfa.orderBy().foldable()) {
+                            if (sf.orderBy() != null) {
+                                Expression orderBy = sf.orderBy();
+                                if (orderBy instanceof NamedExpression) {
+                                    orderBy = qContainer.aliases().getOrDefault(orderBy, orderBy);
+                                    qContainer = qContainer
+                                            .addSort(new AttributeSort(((NamedExpression) orderBy).toAttribute(), direction, missing));
+                                } else if (orderBy.foldable() == false) {
                                     // ignore constant
-                                    throw new PlanningException("does not know how to order by expression {}", sfa.orderBy());
+                                    throw new PlanningException("does not know how to order by expression {}", orderBy);
                                 }
                             } else {
                                 // nope, use scripted sorting
-                                qContainer = qContainer.addSort(new ScriptSort(sfa.script(), direction, missing));
+                                qContainer = qContainer.addSort(new ScriptSort(sf.asScript(), direction, missing));
                             }
-                        } else if (attr instanceof ScoreAttribute) {
+                        }
+                        // score
+                        else if (orderExpression instanceof Score) {
                             qContainer = qContainer.addSort(new ScoreSort(direction, missing));
+                        }
+                        // field
+                        else if (orderExpression instanceof FieldAttribute) {
+                            qContainer = qContainer.addSort(new AttributeSort((FieldAttribute) orderExpression, direction, missing));
+                        }
+                        // agg function
+                        else if (orderExpression instanceof AggregateFunction) {
+                            qContainer = qContainer.addSort(new AggregateSort((AggregateFunction) orderExpression, direction, missing));
                         } else {
-                            qContainer = qContainer.addSort(new AttributeSort(attr, direction, missing));
+                            // unknown
+                            throw new SqlIllegalArgumentException("unsupported sorting expression {}", orderExpression);
                         }
                     }
                 }
@@ -573,21 +786,22 @@ protected PhysicalPlan rule(PivotExec plan) {
                 // due to the Pivot structure - the column is the last entry in the grouping set
                 QueryContainer query = fold.queryContainer();
 
-                List<Tuple<FieldExtraction, ExpressionId>> fields = new ArrayList<>(query.fields());
+                List<Tuple<FieldExtraction, String>> fields = new ArrayList<>(query.fields());
                 int startingIndex = fields.size() - p.aggregates().size() - 1;
                 // pivot grouping
-                Tuple<FieldExtraction, ExpressionId> groupTuple = fields.remove(startingIndex);
-                AttributeSet valuesOutput = plan.pivot().valuesOutput();
+                Tuple<FieldExtraction, String> groupTuple = fields.remove(startingIndex);
+                AttributeMap<Literal> values = p.valuesToLiterals();
 
                 for (int i = startingIndex; i < fields.size(); i++) {
-                    Tuple<FieldExtraction, ExpressionId> tuple = fields.remove(i);
-                    for (Attribute attribute : valuesOutput) {
-                        fields.add(new Tuple<>(new PivotColumnRef(groupTuple.v1(), tuple.v1(), attribute.fold()), attribute.id()));
+                    Tuple<FieldExtraction, String> tuple = fields.remove(i);
+                    for (Map.Entry<Attribute, Literal> entry : values.entrySet()) {
+                        fields.add(new Tuple<>(
+                                new PivotColumnRef(groupTuple.v1(), tuple.v1(), entry.getValue().value()), Expressions.id(entry.getKey())));
                     }
-                    i += valuesOutput.size();
+                    i += values.size();
                 }
 
-                return fold.with(new QueryContainer(query.query(), query.aggs(), 
+                return fold.with(new QueryContainer(query.query(), query.aggs(),
                         fields,
                         query.aliases(),
                         query.pseudoFunctions(),
@@ -596,7 +810,7 @@ protected PhysicalPlan rule(PivotExec plan) {
                         query.limit(),
                         query.shouldTrackHits(),
                         query.shouldIncludeFrozen(),
-                        valuesOutput.size()));
+                        values.size()));
             }
             return plan;
         }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryTranslator.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryTranslator.java
index 4fbcc76ff8220..149999a880214 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryTranslator.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryTranslator.java
@@ -10,15 +10,12 @@
 import org.elasticsearch.geometry.Point;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Attribute;
 import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.Expressions;
 import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Foldables;
 import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.Functions;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Avg;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.CompoundNumericAggregate;
@@ -35,17 +32,11 @@
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Stats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Sum;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
-import org.elasticsearch.xpack.sql.expression.function.grouping.Histogram;
 import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeHistogramFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.Year;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StDistance;
 import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
-import org.elasticsearch.xpack.sql.expression.literal.Intervals;
 import org.elasticsearch.xpack.sql.expression.predicate.Range;
 import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MatchQueryPredicate;
 import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MultiMatchQueryPredicate;
@@ -74,10 +65,6 @@
 import org.elasticsearch.xpack.sql.querydsl.agg.CardinalityAgg;
 import org.elasticsearch.xpack.sql.querydsl.agg.ExtendedStatsAgg;
 import org.elasticsearch.xpack.sql.querydsl.agg.FilterExistsAgg;
-import org.elasticsearch.xpack.sql.querydsl.agg.GroupByDateHistogram;
-import org.elasticsearch.xpack.sql.querydsl.agg.GroupByKey;
-import org.elasticsearch.xpack.sql.querydsl.agg.GroupByNumericHistogram;
-import org.elasticsearch.xpack.sql.querydsl.agg.GroupByValue;
 import org.elasticsearch.xpack.sql.querydsl.agg.LeafAgg;
 import org.elasticsearch.xpack.sql.querydsl.agg.MatrixStatsAgg;
 import org.elasticsearch.xpack.sql.querydsl.agg.MaxAgg;
@@ -106,25 +93,20 @@
 import org.elasticsearch.xpack.sql.querydsl.query.WildcardQuery;
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.util.Check;
-import org.elasticsearch.xpack.sql.util.DateUtils;
 import org.elasticsearch.xpack.sql.util.Holder;
 import org.elasticsearch.xpack.sql.util.ReflectionUtils;
 
 import java.time.OffsetTime;
-import java.time.Period;
 import java.time.ZonedDateTime;
 import java.time.temporal.TemporalAccessor;
 import java.util.Arrays;
-import java.util.LinkedHashMap;
 import java.util.List;
-import java.util.Map;
-import java.util.Map.Entry;
 import java.util.function.Supplier;
 
 import static java.util.Collections.singletonList;
+import static org.elasticsearch.xpack.sql.expression.Expressions.id;
 import static org.elasticsearch.xpack.sql.expression.Foldables.doubleValuesOf;
 import static org.elasticsearch.xpack.sql.expression.Foldables.valueOf;
-import static org.elasticsearch.xpack.sql.type.DataType.DATE;
 
 final class QueryTranslator {
 
@@ -208,174 +190,6 @@ static LeafAgg toAgg(String id, Function f) {
         throw new SqlIllegalArgumentException("Don't know how to translate {} {}", f.nodeName(), f);
     }
 
-    static class GroupingContext {
-        final Map<NamedExpression, GroupByKey> groupMap;
-        final GroupByKey tail;
-
-        GroupingContext(Map<NamedExpression, GroupByKey> groupMap) {
-            this.groupMap = groupMap;
-
-            GroupByKey lastAgg = null;
-            for (Entry<NamedExpression, GroupByKey> entry : groupMap.entrySet()) {
-                lastAgg = entry.getValue();
-            }
-
-            tail = lastAgg;
-        }
-
-        GroupByKey groupFor(Expression exp) {
-            if (Functions.isAggregate(exp)) {
-                AggregateFunction f = (AggregateFunction) exp;
-                // if there's at least one agg in the tree
-                if (!groupMap.isEmpty()) {
-                    GroupByKey matchingGroup = null;
-                    // group found - finding the dedicated agg
-                    if (f.field() instanceof NamedExpression) {
-                        matchingGroup = groupMap.get(f.field());
-                    }
-                    // return matching group or the tail (last group)
-                    return matchingGroup != null ? matchingGroup : tail;
-                }
-                else {
-                    return null;
-                }
-            }
-            if (exp instanceof NamedExpression) {
-                return groupMap.get(exp);
-            }
-            throw new SqlIllegalArgumentException("Don't know how to find group for expression {}", exp);
-        }
-
-        @Override
-        public String toString() {
-            return groupMap.toString();
-        }
-    }
-
-    /**
-     * Creates the list of GroupBy keys
-     */
-    static GroupingContext groupBy(List<? extends Expression> groupings) {
-        if (groupings.isEmpty()) {
-            return null;
-        }
-
-        Map<NamedExpression, GroupByKey> aggMap = new LinkedHashMap<>();
-
-        for (Expression exp : groupings) {
-            GroupByKey key = null;
-            NamedExpression id;
-            String aggId;
-
-            if (exp instanceof NamedExpression) {
-                NamedExpression ne = (NamedExpression) exp;
-
-                id = ne;
-                aggId = ne.id().toString();
-
-                // change analyzed to non non-analyzed attributes
-                if (exp instanceof FieldAttribute) {
-                    ne = ((FieldAttribute) exp).exactAttribute();
-                }
-
-                // handle functions differently
-                if (exp instanceof Function) {
-                    // dates are handled differently because of date histograms
-                    if (exp instanceof DateTimeHistogramFunction) {
-                        DateTimeHistogramFunction dthf = (DateTimeHistogramFunction) exp;
-                        Expression field = dthf.field();
-                        if (field instanceof FieldAttribute) {
-                            if (dthf.calendarInterval() != null) {
-                                key = new GroupByDateHistogram(aggId, nameOf(field), dthf.calendarInterval(), dthf.zoneId());
-                            } else {
-                                key = new GroupByDateHistogram(aggId, nameOf(field), dthf.fixedInterval(), dthf.zoneId());
-                            }
-                        } else if (field instanceof Function) {
-                            ScriptTemplate script = ((Function) field).asScript();
-                            if (dthf.calendarInterval() != null) {
-                                key = new GroupByDateHistogram(aggId, script, dthf.calendarInterval(), dthf.zoneId());
-                            } else {
-                                key = new GroupByDateHistogram(aggId, script, dthf.fixedInterval(), dthf.zoneId());
-                            }
-                        }
-                    }
-                    // all other scalar functions become a script
-                    else if (exp instanceof ScalarFunction) {
-                        ScalarFunction sf = (ScalarFunction) exp;
-                        key = new GroupByValue(aggId, sf.asScript());
-                    }
-                    // histogram
-                    else if (exp instanceof GroupingFunction) {
-                        if (exp instanceof Histogram) {
-                            Histogram h = (Histogram) exp;
-                            Expression field = h.field();
-
-                            // date histogram
-                            if (h.dataType().isDateBased()) {
-                                Object value = h.interval().value();
-                                if (value instanceof IntervalYearMonth
-                                        && ((IntervalYearMonth) value).interval().equals(Period.of(1, 0, 0))) {
-                                    String calendarInterval = Year.YEAR_INTERVAL;
-                                    
-                                    // When the histogram is `INTERVAL '1' YEAR`, the interval used in the ES date_histogram will be
-                                    // a calendar_interval with value "1y". All other intervals will be fixed_intervals expressed in ms.
-                                    if (field instanceof FieldAttribute) {
-                                        key = new GroupByDateHistogram(aggId, nameOf(field), calendarInterval, h.zoneId());
-                                    } else if (field instanceof Function) {
-                                        key = new GroupByDateHistogram(aggId, ((Function) field).asScript(), calendarInterval, h.zoneId());
-                                    }
-                                } else {
-                                    long intervalAsMillis = Intervals.inMillis(h.interval());
-    
-                                    // When the histogram in SQL is applied on DATE type instead of DATETIME, the interval
-                                    // specified is truncated to the multiple of a day. If the interval specified is less
-                                    // than 1 day, then the interval used will be `INTERVAL '1' DAY`.
-                                    if (h.dataType() == DATE) {
-                                        intervalAsMillis = DateUtils.minDayInterval(intervalAsMillis);
-                                    }
-    
-                                    if (field instanceof FieldAttribute) {
-                                        key = new GroupByDateHistogram(aggId, nameOf(field), intervalAsMillis, h.zoneId());
-                                    } else if (field instanceof Function) {
-                                        key = new GroupByDateHistogram(aggId, ((Function) field).asScript(), intervalAsMillis, h.zoneId());
-                                    }
-                                }
-                            }
-                            // numeric histogram
-                            else {
-                                if (field instanceof FieldAttribute) {
-                                    key = new GroupByNumericHistogram(aggId, nameOf(field), Foldables.doubleValueOf(h.interval()));
-                                } else if (field instanceof Function) {
-                                    key = new GroupByNumericHistogram(aggId, ((Function) field).asScript(),
-                                            Foldables.doubleValueOf(h.interval()));
-                                }
-                            }
-                            if (key == null) {
-                                throw new SqlIllegalArgumentException("Unsupported histogram field {}", field);
-                            }
-                        }
-                        else {
-                            throw new SqlIllegalArgumentException("Unsupproted grouping function {}", exp);
-                        }
-                    }
-                    // bumped into into an invalid function (which should be caught by the verifier)
-                    else {
-                        throw new SqlIllegalArgumentException("Cannot GROUP BY function {}", exp);
-                    }
-                }
-                else {
-                    key = new GroupByValue(aggId, ne.name());
-                }
-            }
-            else {
-                throw new SqlIllegalArgumentException("Don't know how to group on {}", exp.nodeString());
-            }
-
-            aggMap.put(id, key);
-        }
-        return new GroupingContext(aggMap);
-    }
-
     static QueryTranslation and(Source source, QueryTranslation left, QueryTranslation right) {
         Check.isTrue(left != null || right != null, "Both expressions are null");
         if (left == null) {
@@ -464,17 +278,9 @@ static String nameOf(Expression e) {
         if (e instanceof NamedExpression) {
             return ((NamedExpression) e).name();
         }
-        if (e instanceof Literal) {
-            return String.valueOf(e.fold());
-        }
-        throw new SqlIllegalArgumentException("Cannot determine name for {}", e);
-    }
-
-    static String idOf(Expression e) {
-        if (e instanceof NamedExpression) {
-            return ((NamedExpression) e).id().toString();
+        else {
+            return e.sourceText();
         }
-        throw new SqlIllegalArgumentException("Cannot determine id for {}", e);
     }
 
     static String dateFormat(Expression e) {
@@ -525,7 +331,7 @@ protected QueryTranslation asQuery(RegexMatch e, boolean onAggs) {
             if (e.field() instanceof FieldAttribute) {
                 targetFieldName = nameOf(((FieldAttribute) e.field()).exactAttribute());
             } else {
-                throw new SqlIllegalArgumentException("Scalar function [{}] not allowed (yet) as argument for " + e.functionName(),
+                throw new SqlIllegalArgumentException("Scalar function [{}] not allowed (yet) as argument for " + e.sourceText(),
                         Expressions.name(e.field()));
             }
 
@@ -590,7 +396,7 @@ protected QueryTranslation asQuery(Not not, boolean onAggs) {
             AggFilter aggFilter = null;
 
             if (onAggs) {
-                aggFilter = new AggFilter(not.id().toString(), not.asScript());
+                aggFilter = new AggFilter(id(not), not.asScript());
             } else {
                 Expression e = not.field();
                 Query wrappedQuery = toQuery(not.field(), false).query;
@@ -616,7 +422,7 @@ protected QueryTranslation asQuery(IsNotNull isNotNull, boolean onAggs) {
             AggFilter aggFilter = null;
 
             if (onAggs) {
-                aggFilter = new AggFilter(isNotNull.id().toString(), isNotNull.asScript());
+                aggFilter = new AggFilter(id(isNotNull), isNotNull.asScript());
             } else {
                 Query q = null;
                 if (isNotNull.field() instanceof FieldAttribute) {
@@ -640,7 +446,7 @@ protected QueryTranslation asQuery(IsNull isNull, boolean onAggs) {
             AggFilter aggFilter = null;
 
             if (onAggs) {
-                aggFilter = new AggFilter(isNull.id().toString(), isNull.asScript());
+                aggFilter = new AggFilter(id(isNull), isNull.asScript());
             } else {
                 Query q = null;
                 if (isNull.field() instanceof FieldAttribute) {
@@ -667,30 +473,18 @@ protected QueryTranslation asQuery(BinaryComparison bc, boolean onAggs) {
                     bc.right().sourceLocation().getLineNumber(), bc.right().sourceLocation().getColumnNumber(),
                     Expressions.name(bc.right()), bc.symbol());
 
-            if (bc.left() instanceof NamedExpression) {
-                NamedExpression ne = (NamedExpression) bc.left();
-
-                Query query = null;
-                AggFilter aggFilter = null;
+            Query query = null;
+            AggFilter aggFilter = null;
 
-                Attribute at = ne.toAttribute();
-                //
-                // Agg context means HAVING -> PipelineAggs
-                //
-                if (onAggs) {
-                    aggFilter = new AggFilter(at.id().toString(), bc.asScript());
-                }
-                else {
-                    query = handleQuery(bc, ne, () -> translateQuery(bc));
-                }
-                return new QueryTranslation(query, aggFilter);
-            }
             //
-            // if the code gets here it's a bug
+            // Agg context means HAVING -> PipelineAggs
             //
-            else {
-                throw new SqlIllegalArgumentException("No idea how to translate " + bc.left());
+            if (onAggs) {
+                aggFilter = new AggFilter(id(bc.left()), bc.asScript());
+            } else {
+                query = handleQuery(bc, bc.left(), () -> translateQuery(bc));
             }
+            return new QueryTranslation(query, aggFilter);
         }
 
         private static Query translateQuery(BinaryComparison bc) {
@@ -778,39 +572,28 @@ static class InComparisons extends ExpressionTranslator<In> {
         @Override
         protected QueryTranslation asQuery(In in, boolean onAggs) {
 
-            if (in.value() instanceof NamedExpression) {
-                NamedExpression ne = (NamedExpression) in.value();
-
-                Query query = null;
-                AggFilter aggFilter = null;
+            Query query = null;
+            AggFilter aggFilter = null;
 
-                Attribute at = ne.toAttribute();
-                //
-                // Agg context means HAVING -> PipelineAggs
-                //
-                if (onAggs) {
-                    aggFilter = new AggFilter(at.id().toString(), in.asScript());
-                }
-                else {
-                    Query q = null;
-                    if (in.value() instanceof FieldAttribute) {
-                        FieldAttribute fa = (FieldAttribute) in.value();
-                        // equality should always be against an exact match (which is important for strings)
-                        q = new TermsQuery(in.source(), fa.exactAttribute().name(), in.list());
-                    } else {
-                        q = new ScriptQuery(in.source(), in.asScript());
-                    }
-                    Query qu = q;
-                    query = handleQuery(in, ne, () -> qu);
-                }
-                return new QueryTranslation(query, aggFilter);
-            }
             //
-            // if the code gets here it's a bug
+            // Agg context means HAVING -> PipelineAggs
             //
+            if (onAggs) {
+                aggFilter = new AggFilter(id(in.value()), in.asScript());
+            }
             else {
-                throw new SqlIllegalArgumentException("No idea how to translate " + in.value());
+                Query q = null;
+                if (in.value() instanceof FieldAttribute) {
+                    FieldAttribute fa = (FieldAttribute) in.value();
+                    // equality should always be against an exact match (which is important for strings)
+                    q = new TermsQuery(in.source(), fa.exactAttribute().name(), in.list());
+                } else {
+                    q = new ScriptQuery(in.source(), in.asScript());
+                }
+                Query qu = q;
+                query = handleQuery(in, in.value(), () -> qu);
             }
+            return new QueryTranslation(query, aggFilter);
         }
     }
 
@@ -820,53 +603,48 @@ static class Ranges extends ExpressionTranslator<Range> {
         protected QueryTranslation asQuery(Range r, boolean onAggs) {
             Expression e = r.value();
 
-            if (e instanceof NamedExpression) {
-                Query query = null;
-                AggFilter aggFilter = null;
+            Query query = null;
+            AggFilter aggFilter = null;
 
-                //
-                // Agg context means HAVING -> PipelineAggs
-                //
-                Attribute at = ((NamedExpression) e).toAttribute();
+            //
+            // Agg context means HAVING -> PipelineAggs
+            //
+            if (onAggs) {
+                aggFilter = new AggFilter(id(e), r.asScript());
+            } else {
 
-                if (onAggs) {
-                    aggFilter = new AggFilter(at.id().toString(), r.asScript());
-                } else {
-                    Holder<Object> lower = new Holder<>(valueOf(r.lower()));
-                    Holder<Object> upper = new Holder<>(valueOf(r.upper()));
-                    Holder<String> format = new Holder<>(dateFormat(r.value()));
-
-                    // for a date constant comparison, we need to use a format for the date, to make sure that the format is the same
-                    // no matter the timezone provided by the user
-                    if (format.get() == null) {
-                        DateFormatter formatter = null;
-                        if (lower.get() instanceof ZonedDateTime || upper.get() instanceof ZonedDateTime) {
-                            formatter = DateFormatter.forPattern(DATE_FORMAT);
-                        } else if (lower.get() instanceof OffsetTime || upper.get() instanceof OffsetTime) {
-                            formatter = DateFormatter.forPattern(TIME_FORMAT);
+                Holder<Object> lower = new Holder<>(valueOf(r.lower()));
+                Holder<Object> upper = new Holder<>(valueOf(r.upper()));
+                Holder<String> format = new Holder<>(dateFormat(r.value()));
+
+                // for a date constant comparison, we need to use a format for the date, to make sure that the format is the same
+                // no matter the timezone provided by the user
+                if (format.get() == null) {
+                    DateFormatter formatter = null;
+                    if (lower.get() instanceof ZonedDateTime || upper.get() instanceof ZonedDateTime) {
+                        formatter = DateFormatter.forPattern(DATE_FORMAT);
+                    } else if (lower.get() instanceof OffsetTime || upper.get() instanceof OffsetTime) {
+                        formatter = DateFormatter.forPattern(TIME_FORMAT);
+                    }
+                    if (formatter != null) {
+                        // RangeQueryBuilder accepts an Object as its parameter, but it will call .toString() on the ZonedDateTime
+                        // instance which can have a slightly different format depending on the ZoneId used to create the ZonedDateTime
+                        // Since RangeQueryBuilder can handle date as String as well, we'll format it as String and provide the format.
+                        if (lower.get() instanceof ZonedDateTime || lower.get() instanceof OffsetTime) {
+                            lower.set(formatter.format((TemporalAccessor) lower.get()));
                         }
-                        if (formatter != null) {
-                            // RangeQueryBuilder accepts an Object as its parameter, but it will call .toString() on the ZonedDateTime
-                            // instance which can have a slightly different format depending on the ZoneId used to create the ZonedDateTime
-                            // Since RangeQueryBuilder can handle date as String as well, we'll format it as String and provide the format.
-                            if (lower.get() instanceof ZonedDateTime || lower.get() instanceof OffsetTime) {
-                                lower.set(formatter.format((TemporalAccessor) lower.get()));
-                            }
-                            if (upper.get() instanceof ZonedDateTime || upper.get() instanceof OffsetTime) {
-                                upper.set(formatter.format((TemporalAccessor) upper.get()));
-                            }
-                            format.set(formatter.pattern());
+                        if (upper.get() instanceof ZonedDateTime || upper.get() instanceof OffsetTime) {
+                            upper.set(formatter.format((TemporalAccessor) upper.get()));
                         }
+                        format.set(formatter.pattern());
                     }
-                    
-                    query = handleQuery(r, r.value(),
-                        () -> new RangeQuery(r.source(), nameOf(r.value()), lower.get(), r.includeLower(),
-                            upper.get(), r.includeUpper(), format.get()));
                 }
-                return new QueryTranslation(query, aggFilter);
-            } else {
-                throw new SqlIllegalArgumentException("No idea how to translate " + e);
+
+                query = handleQuery(r, r.value(),
+                        () -> new RangeQuery(r.source(), nameOf(r.value()), lower.get(), r.includeLower(), upper.get(), r.includeUpper(),
+                                format.get()));
             }
+            return new QueryTranslation(query, aggFilter);
         }
     }
 
@@ -880,7 +658,7 @@ protected QueryTranslation asQuery(ScalarFunction f, boolean onAggs) {
             AggFilter aggFilter = null;
 
             if (onAggs) {
-                aggFilter = new AggFilter(f.id().toString(), script);
+                aggFilter = new AggFilter(id(f), script);
             } else {
                 query = handleQuery(f, f, () -> new ScriptQuery(f.source(), script));
             }
@@ -1086,4 +864,4 @@ protected static Query wrapIfNested(Query query, Expression exp) {
             return query;
         }
     }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/Aggs.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/Aggs.java
index 632eb729936fd..94f854c29f0b8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/Aggs.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/Aggs.java
@@ -10,8 +10,6 @@
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeValuesSourceBuilder;
 import org.elasticsearch.search.aggregations.bucket.filter.FiltersAggregationBuilder;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunctionAttribute;
 import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Direction;
 import org.elasticsearch.xpack.sql.util.StringUtils;
@@ -123,23 +121,16 @@ public Aggs addAgg(PipelineAgg pipelineAgg) {
         return new Aggs(groups, simpleAggs, combine(pipelineAggs, pipelineAgg));
     }
 
-    public GroupByKey findGroupForAgg(Attribute attr) {
-        String id = attr.id().toString();
+    public GroupByKey findGroupForAgg(String groupOrAggId) {
         for (GroupByKey group : this.groups) {
-            if (id.equals(group.id())) {
+            if (groupOrAggId.equals(group.id())) {
                 return group;
             }
-            if (attr instanceof ScalarFunctionAttribute) {
-                ScalarFunctionAttribute sfa = (ScalarFunctionAttribute) attr;
-                if (group.script() != null && group.script().equals(sfa.script())) {
-                    return group;
-                }
-            }
         }
 
         // maybe it's the default group agg ?
         for (Agg agg : simpleAggs) {
-            if (id.equals(agg.id())) {
+            if (groupOrAggId.equals(agg.id())) {
                 return IMPLICIT_GROUP_KEY;
             }
         }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AggregateSort.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AggregateSort.java
new file mode 100644
index 0000000000000..966f5c5079664
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AggregateSort.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.sql.querydsl.container;
+
+import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
+
+import java.util.Objects;
+
+public class AggregateSort extends Sort {
+
+    private final AggregateFunction agg;
+
+    public AggregateSort(AggregateFunction agg, Direction direction, Missing missing) {
+        super(direction, missing);
+        this.agg = agg;
+    }
+
+    public AggregateFunction agg() {
+        return agg;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(agg, direction(), missing());
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) {
+            return true;
+        }
+        
+        if (obj == null || getClass() != obj.getClass()) {
+            return false;
+        }
+        
+        AggregateSort other = (AggregateSort) obj;
+        return Objects.equals(direction(), other.direction())
+                && Objects.equals(missing(), other.missing())
+                && Objects.equals(agg, other.agg);
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainer.java
index 3dd1a2ac10834..2e388f94af3e5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainer.java
@@ -16,13 +16,15 @@
 import org.elasticsearch.xpack.sql.execution.search.SourceGenerator;
 import org.elasticsearch.xpack.sql.expression.Attribute;
 import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
+import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.sql.expression.Expressions;
 import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.LiteralAttribute;
-import org.elasticsearch.xpack.sql.expression.function.ScoreAttribute;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunctionAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunctionAttribute;
+import org.elasticsearch.xpack.sql.expression.function.Score;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.sql.expression.gen.pipeline.ConstantInput;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.sql.expression.gen.pipeline.ScorePipe;
 import org.elasticsearch.xpack.sql.querydsl.agg.Aggs;
 import org.elasticsearch.xpack.sql.querydsl.agg.GroupByKey;
 import org.elasticsearch.xpack.sql.querydsl.agg.LeafAgg;
@@ -38,7 +40,6 @@
 import java.util.ArrayList;
 import java.util.BitSet;
 import java.util.Collection;
-import java.util.Collections;
 import java.util.Comparator;
 import java.util.LinkedHashMap;
 import java.util.LinkedHashSet;
@@ -67,11 +68,11 @@ public class QueryContainer {
     // for example in case of grouping or custom sorting, the response has extra columns
     // that is filtered before getting to the client
 
-    // the list contains both the field extraction and the id of its associated attribute (for custom sorting)
-    private final List<Tuple<FieldExtraction, ExpressionId>> fields;
+    // the list contains both the field extraction and its id (for custom sorting)
+    private final List<Tuple<FieldExtraction, String>> fields;
 
-    // aliases (maps an alias to its actual resolved attribute)
-    private final Map<ExpressionId, Attribute> aliases;
+    // aliases found in the tree
+    private final AttributeMap<Expression> aliases;
 
     // pseudo functions (like count) - that are 'extracted' from other aggs
     private final Map<String, GroupByKey> pseudoFunctions;
@@ -90,6 +91,9 @@ public class QueryContainer {
     // computed
     private Boolean aggsOnly;
     private Boolean customSort;
+    // associate Attributes with aliased FieldAttributes (since they map directly to ES fields)
+    private Map<Attribute, FieldAttribute> fieldAlias;
+
 
     public QueryContainer() {
         this(null, null, null, null, null, null, null, -1, false, false, -1);
@@ -97,9 +101,8 @@ public QueryContainer() {
 
     public QueryContainer(Query query,
             Aggs aggs,
-            List<Tuple<FieldExtraction,
-            ExpressionId>> fields,
-            Map<ExpressionId, Attribute> aliases,
+            List<Tuple<FieldExtraction, String>> fields,
+            AttributeMap<Expression> aliases,
             Map<String, GroupByKey> pseudoFunctions,
             AttributeMap<Pipe> scalarFunctions,
             Set<Sort> sort,
@@ -110,7 +113,7 @@ public QueryContainer(Query query,
         this.query = query;
         this.aggs = aggs == null ? Aggs.EMPTY : aggs;
         this.fields = fields == null || fields.isEmpty() ? emptyList() : fields;
-        this.aliases = aliases == null || aliases.isEmpty() ? Collections.emptyMap() : aliases;
+        this.aliases = aliases == null || aliases.isEmpty() ? AttributeMap.emptyAttributeMap() : aliases;
         this.pseudoFunctions = pseudoFunctions == null || pseudoFunctions.isEmpty() ? emptyMap() : pseudoFunctions;
         this.scalarFunctions = scalarFunctions == null || scalarFunctions.isEmpty() ? AttributeMap.emptyAttributeMap() : scalarFunctions;
         this.sort = sort == null || sort.isEmpty() ? emptySet() : sort;
@@ -136,31 +139,30 @@ public List<Tuple<Integer, Comparator>> sortingColumns() {
         for (Sort s : sort) {
             Tuple<Integer, Comparator> tuple = new Tuple<>(Integer.valueOf(-1), null);
             
-            if (s instanceof AttributeSort) {
-                AttributeSort as = (AttributeSort) s;
+            if (s instanceof AggregateSort) {
+                AggregateSort as = (AggregateSort) s;
                 // find the relevant column of each aggregate function
-                if (as.attribute() instanceof AggregateFunctionAttribute) {
-                    aggSort = true;
-                    AggregateFunctionAttribute afa = (AggregateFunctionAttribute) as.attribute();
-                    afa = (AggregateFunctionAttribute) aliases.getOrDefault(afa.innerId(), afa);
-                    int atIndex = -1;
-                    for (int i = 0; i < fields.size(); i++) {
-                        Tuple<FieldExtraction, ExpressionId> field = fields.get(i);
-                        if (field.v2().equals(afa.innerId())) {
-                            atIndex = i;
-                            break;
-                        }
-                    }
+                AggregateFunction af = as.agg();
 
-                    if (atIndex == -1) {
-                        throw new SqlIllegalArgumentException("Cannot find backing column for ordering aggregation [{}]", afa.name());
-                    }
-                    // assemble a comparator for it
-                    Comparator comp = s.direction() == Sort.Direction.ASC ? Comparator.naturalOrder() : Comparator.reverseOrder();
-                    comp = s.missing() == Sort.Missing.FIRST ? Comparator.nullsFirst(comp) : Comparator.nullsLast(comp);
+                aggSort = true;
+                int atIndex = -1;
+                String id = Expressions.id(af);
 
-                    tuple = new Tuple<>(Integer.valueOf(atIndex), comp);
+                for (int i = 0; i < fields.size(); i++) {
+                    Tuple<FieldExtraction, String> field = fields.get(i);
+                    if (field.v2().equals(id)) {
+                        atIndex = i;
+                        break;
+                    }
+                }
+                if (atIndex == -1) {
+                    throw new SqlIllegalArgumentException("Cannot find backing column for ordering aggregation [{}]", s);
                 }
+                // assemble a comparator for it
+                Comparator comp = s.direction() == Sort.Direction.ASC ? Comparator.naturalOrder() : Comparator.reverseOrder();
+                comp = s.missing() == Sort.Missing.FIRST ? Comparator.nullsFirst(comp) : Comparator.nullsLast(comp);
+
+                tuple = new Tuple<>(Integer.valueOf(atIndex), comp);
             }
             sortingColumns.add(tuple);
         }
@@ -179,19 +181,20 @@ public List<Tuple<Integer, Comparator>> sortingColumns() {
      */
     public BitSet columnMask(List<Attribute> columns) {
         BitSet mask = new BitSet(fields.size());
+        aliasName(columns.get(0));
+
         for (Attribute column : columns) {
-            Attribute alias = aliases.get(column.id());
+            Expression expression = aliases.getOrDefault(column, column);
+
             // find the column index
+            String id = Expressions.id(expression);
             int index = -1;
 
-            ExpressionId id = column instanceof AggregateFunctionAttribute ? ((AggregateFunctionAttribute) column).innerId() : column.id();
-            ExpressionId aliasId = alias != null ? (alias instanceof AggregateFunctionAttribute ? ((AggregateFunctionAttribute) alias)
-                    .innerId() : alias.id()) : null;
             for (int i = 0; i < fields.size(); i++) {
-                Tuple<FieldExtraction, ExpressionId> tuple = fields.get(i);
+                Tuple<FieldExtraction, String> tuple = fields.get(i);
                 // if the index is already set there is a collision,
                 // so continue searching for the other tuple with the same id
-                if (mask.get(i)==false && (tuple.v2().equals(id) || (aliasId != null && tuple.v2().equals(aliasId)))) {
+                if (mask.get(i) == false && tuple.v2().equals(id)) {
                     index = i;
                     break;
                 }
@@ -214,11 +217,11 @@ public Aggs aggs() {
         return aggs;
     }
 
-    public List<Tuple<FieldExtraction, ExpressionId>> fields() {
+    public List<Tuple<FieldExtraction, String>> fields() {
         return fields;
     }
 
-    public Map<ExpressionId, Attribute> aliases() {
+    public AttributeMap<Expression> aliases() {
         return aliases;
     }
 
@@ -267,12 +270,7 @@ public QueryContainer with(Query q) {
                 minPageSize);
     }
 
-    public QueryContainer withFields(List<Tuple<FieldExtraction, ExpressionId>> f) {
-        return new QueryContainer(query, aggs, f, aliases, pseudoFunctions, scalarFunctions, sort, limit, trackHits, includeFrozen,
-                minPageSize);
-    }
-
-    public QueryContainer withAliases(Map<ExpressionId, Attribute> a) {
+    public QueryContainer withAliases(AttributeMap<Expression> a) {
         return new QueryContainer(query, aggs, fields, a, pseudoFunctions, scalarFunctions, sort, limit, trackHits, includeFrozen,
                 minPageSize);
     }
@@ -313,7 +311,16 @@ public QueryContainer addSort(Sort sortable) {
     }
 
     private String aliasName(Attribute attr) {
-        return aliases.getOrDefault(attr.id(), attr).name();
+        if (fieldAlias == null) {
+            fieldAlias = new LinkedHashMap<>();
+            for (Map.Entry<Attribute, Expression> entry : aliases.entrySet()) {
+                if (entry.getValue() instanceof FieldAttribute) {
+                    fieldAlias.put(entry.getKey(), (FieldAttribute) entry.getValue());
+                }
+            }
+        }
+        FieldAttribute fa = fieldAlias.get(attr);
+        return fa != null ? fa.name() : attr.name();
     }
 
     //
@@ -397,17 +404,8 @@ static Query rewriteToContainNestedField(@Nullable Query query, Source source, S
     }
 
     // replace function/operators's input with references
-    private Tuple<QueryContainer, FieldExtraction> resolvedTreeComputingRef(ScalarFunctionAttribute ta) {
-        Attribute attribute = aliases.getOrDefault(ta.id(), ta);
-        Pipe proc = scalarFunctions.get(attribute);
-
-        // check the attribute itself
-        if (proc == null) {
-            if (attribute instanceof ScalarFunctionAttribute) {
-                ta = (ScalarFunctionAttribute) attribute;
-            }
-            proc = ta.asPipe();
-        }
+    private Tuple<QueryContainer, FieldExtraction> resolvedTreeComputingRef(ScalarFunction function, Attribute attr) {
+        Pipe proc = scalarFunctions.computeIfAbsent(attr, v -> function.asPipe());
 
         // find the processor inputs (Attributes) and convert them into references
         // no need to promote them to the top since the container doesn't have to be aware
@@ -420,8 +418,7 @@ private QueryAttributeResolver(QueryContainer container) {
 
             @Override
             public FieldExtraction resolve(Attribute attribute) {
-                Attribute attr = aliases.getOrDefault(attribute.id(), attribute);
-                Tuple<QueryContainer, FieldExtraction> ref = container.toReference(attr);
+                Tuple<QueryContainer, FieldExtraction> ref = container.asFieldExtraction(attribute);
                 container = ref.v1();
                 return ref.v2();
             }
@@ -430,42 +427,55 @@ public FieldExtraction resolve(Attribute attribute) {
         proc = proc.resolveAttributes(resolver);
         QueryContainer qContainer = resolver.container;
 
-        // update proc
-        Map<Attribute, Pipe> procs = new LinkedHashMap<>(qContainer.scalarFunctions());
-        procs.put(attribute, proc);
-        qContainer = qContainer.withScalarProcessors(new AttributeMap<>(procs));
+        // update proc (if needed)
+        if (qContainer.scalarFunctions().size() != scalarFunctions.size()) {
+            Map<Attribute, Pipe> procs = new LinkedHashMap<>(qContainer.scalarFunctions());
+            procs.put(attr, proc);
+            qContainer = qContainer.withScalarProcessors(new AttributeMap<>(procs));
+        }
+
         return new Tuple<>(qContainer, new ComputedRef(proc));
     }
 
     public QueryContainer addColumn(Attribute attr) {
-        Tuple<QueryContainer, FieldExtraction> tuple = toReference(attr);
-        return tuple.v1().addColumn(tuple.v2(), attr);
+        Expression expression = aliases.getOrDefault(attr, attr);
+        Tuple<QueryContainer, FieldExtraction> tuple = asFieldExtraction(attr);
+        return tuple.v1().addColumn(tuple.v2(), Expressions.id(expression));
     }
 
-    private Tuple<QueryContainer, FieldExtraction> toReference(Attribute attr) {
-        if (attr instanceof FieldAttribute) {
-            FieldAttribute fa = (FieldAttribute) attr;
+    private Tuple<QueryContainer, FieldExtraction> asFieldExtraction(Attribute attr) {
+        // resolve it Expression
+        Expression expression = aliases.getOrDefault(attr, attr);
+
+        if (expression instanceof FieldAttribute) {
+            FieldAttribute fa = (FieldAttribute) expression;
             if (fa.isNested()) {
                 return nestedHitFieldRef(fa);
             } else {
                 return new Tuple<>(this, topHitFieldRef(fa));
             }
         }
-        if (attr instanceof ScalarFunctionAttribute) {
-            return resolvedTreeComputingRef((ScalarFunctionAttribute) attr);
+
+        if (expression == null) {
+            throw new SqlIllegalArgumentException("Unknown output attribute {}", attr);
+        }
+
+        if (expression.foldable()) {
+            return new Tuple<>(this, new ComputedRef(new ConstantInput(expression.source(), expression, expression.fold())));
         }
-        if (attr instanceof LiteralAttribute) {
-            return new Tuple<>(this, new ComputedRef(((LiteralAttribute) attr).asPipe()));
+
+        if (expression instanceof Score) {
+            return new Tuple<>(this, new ComputedRef(new ScorePipe(expression.source(), expression)));
         }
-        if (attr instanceof ScoreAttribute) {
-            return new Tuple<>(this, new ComputedRef(((ScoreAttribute) attr).asPipe()));
+
+        if (expression instanceof ScalarFunction) {
+            return resolvedTreeComputingRef((ScalarFunction) expression, attr);
         }
 
         throw new SqlIllegalArgumentException("Unknown output attribute {}", attr);
     }
 
-    public QueryContainer addColumn(FieldExtraction ref, Attribute attr) {
-        ExpressionId id = attr instanceof AggregateFunctionAttribute ? ((AggregateFunctionAttribute) attr).innerId() : attr.id();
+    public QueryContainer addColumn(FieldExtraction ref, String id) {
         return new QueryContainer(query, aggs, combine(fields, new Tuple<>(ref, id)), aliases, pseudoFunctions,
                 scalarFunctions,
                 sort, limit, trackHits, includeFrozen, minPageSize);
@@ -487,8 +497,8 @@ public QueryContainer addGroups(Collection<GroupByKey> values) {
         return with(aggs.addGroups(values));
     }
 
-    public GroupByKey findGroupForAgg(Attribute attr) {
-        return aggs.findGroupForAgg(attr);
+    public GroupByKey findGroupForAgg(String aggId) {
+        return aggs.findGroupForAgg(aggId);
     }
 
     public QueryContainer updateGroup(GroupByKey group) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Node.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Node.java
index 2e40244a41589..0d686fc5cf16a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Node.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Node.java
@@ -9,6 +9,7 @@
 
 import java.util.ArrayList;
 import java.util.BitSet;
+import java.util.Iterator;
 import java.util.List;
 import java.util.Objects;
 import java.util.function.Consumer;
@@ -378,7 +379,10 @@ public String propertiesToString(boolean skipIfChild) {
                 if (needsComma) {
                     sb.append(",");
                 }
-                String stringValue = Objects.toString(prop);
+                
+                String stringValue = toString(prop);
+                
+                //: Objects.toString(prop);
                 if (maxWidth + stringValue.length() > TO_STRING_MAX_WIDTH) {
                     int cutoff = Math.max(0, TO_STRING_MAX_WIDTH - maxWidth);
                     sb.append(stringValue.substring(0, cutoff));
@@ -395,4 +399,28 @@ public String propertiesToString(boolean skipIfChild) {
 
         return sb.toString();
     }
+
+    private String toString(Object obj) {
+        StringBuilder sb = new StringBuilder();
+        toString(sb, obj);
+        return sb.toString();
+    }
+
+    private void toString(StringBuilder sb, Object obj) {
+        if (obj instanceof Iterable) {
+            sb.append("[");
+            for (Iterator<?> it = ((Iterable<?>) obj).iterator(); it.hasNext();) {
+                Object o = it.next();
+                toString(sb, o);
+                if (it.hasNext() == true) {
+                    sb.append(", ");
+                }
+            }
+            sb.append("]");
+        } else if (obj instanceof Node<?>) {
+            sb.append(((Node<?>) obj).nodeString());
+        } else {
+            sb.append(Objects.toString(obj));
+        }
+    }
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
index 04e58d9fc874c..08c2548a41ba3 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
@@ -437,7 +437,7 @@ public void testGroupByOrderByScalarOverNonGrouped() {
     }
 
     public void testGroupByOrderByFieldFromGroupByFunction() {
-        assertEquals("1:54: Cannot use non-grouped column [int], expected [ABS(int)]",
+        assertEquals("1:54: Cannot order by non-grouped column [int], expected [ABS(int)]",
                 error("SELECT ABS(int) FROM test GROUP BY ABS(int) ORDER BY int"));
     }
 
@@ -613,9 +613,9 @@ public void testInvalidTypeForBooleanFunction_WithOneArg() {
     }
 
     public void testInvalidTypeForStringFunction_WithTwoArgs() {
-        assertEquals("1:8: first argument of [CONCAT] must be [string], found value [1] type [integer]",
+        assertEquals("1:8: first argument of [CONCAT(1, 'bar')] must be [string], found value [1] type [integer]",
             error("SELECT CONCAT(1, 'bar')"));
-        assertEquals("1:8: second argument of [CONCAT] must be [string], found value [2] type [integer]",
+        assertEquals("1:8: second argument of [CONCAT('foo', 2)] must be [string], found value [2] type [integer]",
             error("SELECT CONCAT('foo', 2)"));
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SourceGeneratorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SourceGeneratorTests.java
index fce24758a3b4d..7efbea74241e0 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SourceGeneratorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SourceGeneratorTests.java
@@ -14,7 +14,11 @@
 import org.elasticsearch.search.sort.FieldSortBuilder;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.sql.expression.AttributeMap;
+import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.FieldAttribute;
+import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
 import org.elasticsearch.xpack.sql.expression.function.Score;
 import org.elasticsearch.xpack.sql.querydsl.agg.AvgAgg;
 import org.elasticsearch.xpack.sql.querydsl.agg.GroupByValue;
@@ -27,6 +31,9 @@
 import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.type.KeywordEsField;
 
+import java.util.LinkedHashMap;
+import java.util.Map;
+
 import static java.util.Collections.singletonList;
 import static org.elasticsearch.index.query.QueryBuilders.boolQuery;
 import static org.elasticsearch.index.query.QueryBuilders.matchQuery;
@@ -79,7 +86,11 @@ public void testSortNoneSpecified() {
     }
 
     public void testSelectScoreForcesTrackingScore() {
-        QueryContainer container = new QueryContainer().addColumn(new Score(Source.EMPTY).toAttribute());
+        Score score = new Score(Source.EMPTY);
+        ReferenceAttribute attr = new ReferenceAttribute(score.source(), "score", score.dataType());
+        Map<Attribute, Expression> alias = new LinkedHashMap<>();
+        alias.put(attr, score);
+        QueryContainer container = new QueryContainer().withAliases(new AttributeMap<>(alias)).addColumn(attr);
         SearchSourceBuilder sourceBuilder = SourceGenerator.sourceBuilder(container, null, randomIntBetween(1, 10));
         assertTrue(sourceBuilder.trackScores());
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/AttributeMapTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/AttributeMapTests.java
index f2a6045124e4b..ee977687d902d 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/AttributeMapTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/AttributeMapTests.java
@@ -55,7 +55,7 @@ public void testMapConstructor() {
 
         Attribute one = m.keySet().iterator().next();
         assertThat(m.containsKey(one), is(true));
-        assertThat(m.containsKey(a("one")), is(true));
+        assertThat(m.containsKey(a("one")), is(false));
         assertThat(m.containsValue("one"), is(true));
         assertThat(m.containsValue("on"), is(false));
         assertThat(m.attributeNames(), contains("one", "two", "three"));
@@ -74,7 +74,7 @@ public void testSingleItemConstructor() {
         assertThat(m.isEmpty(), is(false));
 
         assertThat(m.containsKey(one), is(true));
-        assertThat(m.containsKey(a("one")), is(true));
+        assertThat(m.containsKey(a("one")), is(false));
         assertThat(m.containsValue("one"), is(true));
         assertThat(m.containsValue("on"), is(false));
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ExpressionIdTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ExpressionIdTests.java
index 3efa228f7ccea..dfbe34104342b 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ExpressionIdTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ExpressionIdTests.java
@@ -10,11 +10,11 @@
 
 public class ExpressionIdTests extends ESTestCase {
     /**
-     * Each {@link ExpressionId} should be unique. Technically
+     * Each {@link NameId} should be unique. Technically
      * you can roll the {@link AtomicLong} that backs them but
      * that is not going to happen within a single query.
      */
     public void testUnique() {
-        assertNotEquals(new ExpressionId(), new ExpressionId());
+        assertNotEquals(new NameId(), new NameId());
     }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/LiteralTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/LiteralTests.java
index 2d36cb1e1e56c..cd5e736c47c40 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/LiteralTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/LiteralTests.java
@@ -61,7 +61,7 @@ protected Literal randomInstance() {
 
     @Override
     protected Literal copy(Literal instance) {
-        return new Literal(instance.source(), instance.name(), instance.value(), instance.dataType());
+        return new Literal(instance.source(), instance.value(), instance.dataType());
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttributeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttributeTests.java
index 4deca1d1f6362..a40e7661dc03d 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttributeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttributeTests.java
@@ -18,7 +18,7 @@ public static UnresolvedAttribute randomUnresolvedAttribute() {
         Source source = SourceTests.randomSource();
         String name = randomAlphaOfLength(5);
         String qualifier = randomQualifier();
-        ExpressionId id = randomBoolean() ? null : new ExpressionId();
+        NameId id = randomBoolean() ? null : new NameId();
         String unresolvedMessage = randomUnresolvedMessage();
         Object resolutionMetadata = new Object();
         return new UnresolvedAttribute(source, name, qualifier, id, unresolvedMessage, resolutionMetadata);
@@ -82,7 +82,7 @@ public void testTransform() {
                 a.unresolvedMessage(), a.resolutionMetadata()),
             a.transformPropertiesOnly(v -> Objects.equals(v, a.qualifier()) ? newQualifier : v, Object.class));
 
-        ExpressionId newId = new ExpressionId();
+        NameId newId = new NameId();
         assertEquals(new UnresolvedAttribute(a.source(), a.name(), a.qualifier(), newId,
                 a.unresolvedMessage(), a.resolutionMetadata()),
             a.transformPropertiesOnly(v -> Objects.equals(v, a.id()) ? newId : v, Object.class));
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/DatabaseFunctionTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/DatabaseFunctionTests.java
index 0156d8fdfb59a..8ad04d83c4c45 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/DatabaseFunctionTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/DatabaseFunctionTests.java
@@ -11,6 +11,8 @@
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
 import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
 import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
+import org.elasticsearch.xpack.sql.expression.Alias;
+import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.plan.logical.Project;
@@ -38,7 +40,9 @@ null, clusterName, randomBoolean(), randomBoolean()),
         );
         
         Project result = (Project) analyzer.analyze(parser.createStatement("SELECT DATABASE()"), true);
-        assertTrue(result.projections().get(0) instanceof Database);
-        assertEquals(clusterName, ((Database) result.projections().get(0)).fold());
+        NamedExpression ne = result.projections().get(0);
+        assertTrue(ne instanceof Alias);
+        assertTrue(((Alias) ne).child() instanceof Database);
+        assertEquals(clusterName, ((Database) ((Alias) ne).child()).fold());
     }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/UserFunctionTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/UserFunctionTests.java
index f8b3ed1976450..a6e8d83a336f7 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/UserFunctionTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/UserFunctionTests.java
@@ -11,6 +11,8 @@
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
 import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
 import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
+import org.elasticsearch.xpack.sql.expression.Alias;
+import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.plan.logical.Project;
@@ -28,9 +30,9 @@ public void testNoUsernameFunctionOutput() {
         EsIndex test = new EsIndex("test", TypesTests.loadMapping("mapping-basic.json", true));
         Analyzer analyzer = new Analyzer(
                 new Configuration(DateUtils.UTC, Protocol.FETCH_SIZE, Protocol.REQUEST_TIMEOUT,
-                                  Protocol.PAGE_TIMEOUT, null, 
-                                  randomFrom(Mode.values()), randomAlphaOfLength(10), 
-                                  null, randomAlphaOfLengthBetween(1, 15), 
+                                  Protocol.PAGE_TIMEOUT, null,
+                                  randomFrom(Mode.values()), randomAlphaOfLength(10),
+                                  null, randomAlphaOfLengthBetween(1, 15),
                                   randomBoolean(), randomBoolean()),
                 new FunctionRegistry(),
                 IndexResolution.valid(test),
@@ -38,7 +40,9 @@ null, randomAlphaOfLengthBetween(1, 15),
         );
         
         Project result = (Project) analyzer.analyze(parser.createStatement("SELECT USER()"), true);
-        assertTrue(result.projections().get(0) instanceof User);
-        assertNull(((User) result.projections().get(0)).fold());
+        NamedExpression ne = result.projections().get(0);
+        assertTrue(ne instanceof Alias);
+        assertTrue(((Alias) ne).child() instanceof User);
+        assertNull(((User) ((Alias) ne).child()).fold());
     }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseTests.java
index 00004598f5c97..899da8049b915 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseTests.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.sql.expression.predicate.conditional;
 
 import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.sql.expression.Expression.TypeResolution;
 import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils;
 import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
@@ -21,7 +22,6 @@
 import java.util.List;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.Expression.TypeResolution;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
 import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
@@ -69,10 +69,6 @@ public void testTransform() {
         Source newSource = randomValueOtherThan(c.source(), SourceTests::randomSource);
         assertEquals(new Case(c.source(), c.children()),
             c.transformPropertiesOnly(p -> Objects.equals(p, c.source()) ? newSource: p, Object.class));
-
-        String newName = randomValueOtherThan(c.name(), () -> randomAlphaOfLength(5));
-        assertEquals(new Case(c.source(), c.children()),
-            c.transformPropertiesOnly(p -> Objects.equals(p, c.name()) ? newName : p, Object.class));
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IifTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IifTests.java
index a07663b188d25..6b468fcb8fbf2 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IifTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IifTests.java
@@ -62,10 +62,6 @@ public void testTransform() {
         Source newSource = randomValueOtherThan(iif.source(), SourceTests::randomSource);
         assertEquals(new Iif(iif.source(), iif.conditions().get(0).condition(), iif.conditions().get(0).result(), iif.elseResult()),
             iif.transformPropertiesOnly(p -> Objects.equals(p, iif.source()) ? newSource: p, Object.class));
-
-        String newName = randomValueOtherThan(iif.name(), () -> randomAlphaOfLength(5));
-        assertEquals(new Iif(iif.source(), iif.conditions().get(0).condition(), iif.conditions().get(0).result(), iif.elseResult()),
-            iif.transformPropertiesOnly(p -> Objects.equals(p, iif.name()) ? newName : p, Object.class));
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
index 8efb687428945..c81b376c0a534 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
@@ -22,7 +22,6 @@
 import org.elasticsearch.xpack.sql.expression.function.Function;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Avg;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.ExtendedStats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.First;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
@@ -101,11 +100,11 @@
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.ConstantFolding;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.FoldNull;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.PropagateEquals;
-import org.elasticsearch.xpack.sql.optimizer.Optimizer.PruneDuplicateFunctions;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.ReplaceAggsWithExtendedStats;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.ReplaceAggsWithStats;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.ReplaceFoldableAttributes;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.ReplaceMinMaxWithTopHits;
+import org.elasticsearch.xpack.sql.optimizer.Optimizer.ReplaceReferenceAttributeWithSource;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.RewritePivot;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.SimplifyCase;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.SimplifyConditional;
@@ -144,7 +143,7 @@
 import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
 import static org.elasticsearch.xpack.sql.util.DateUtils.UTC;
 import static org.hamcrest.Matchers.contains;
-import static org.hamcrest.Matchers.startsWith;
+import static org.hamcrest.Matchers.is;
 
 public class OptimizerTests extends ESTestCase {
 
@@ -210,6 +209,10 @@ private static Literal L(Object value) {
         return of(EMPTY, value);
     }
 
+    private static Alias a(String name, Expression e) {
+        return new Alias(e.source(), name, e);
+    }
+
     private static FieldAttribute getFieldAttribute() {
         return getFieldAttribute("a");
     }
@@ -225,20 +228,6 @@ public void testPruneSubqueryAliases() {
         assertEquals(result, s);
     }
 
-    public void testDuplicateFunctions() {
-        AggregateFunction f1 = new Count(EMPTY, TRUE, false);
-        AggregateFunction f2 = new Count(EMPTY, TRUE, false);
-
-        assertTrue(f1.functionEquals(f2));
-
-        Project p = new Project(EMPTY, FROM(), Arrays.asList(f1, f2));
-        LogicalPlan result = new PruneDuplicateFunctions().apply(p);
-        assertTrue(result instanceof Project);
-        List<? extends NamedExpression> projections = ((Project) result).projections();
-        assertEquals(2, projections.size());
-        assertEquals(projections.get(0), projections.get(1));
-    }
-
     public void testCombineProjections() {
         // a
         Alias a = new Alias(EMPTY, "a", FIVE);
@@ -338,17 +327,17 @@ public void testConstantFoldingBinaryLogic() {
     }
 
     public void testConstantFoldingBinaryLogic_WithNullHandling() {
-        assertEquals(NULL, new ConstantFolding().rule(new And(EMPTY, NULL, TRUE)).canonical());
-        assertEquals(NULL, new ConstantFolding().rule(new And(EMPTY, TRUE, NULL)).canonical());
+        assertEquals(Nullability.TRUE, new ConstantFolding().rule(new And(EMPTY, NULL, TRUE)).canonical().nullable());
+        assertEquals(Nullability.TRUE, new ConstantFolding().rule(new And(EMPTY, TRUE, NULL)).canonical().nullable());
         assertEquals(FALSE, new ConstantFolding().rule(new And(EMPTY, NULL, FALSE)).canonical());
         assertEquals(FALSE, new ConstantFolding().rule(new And(EMPTY, FALSE, NULL)).canonical());
-        assertEquals(NULL, new ConstantFolding().rule(new And(EMPTY, NULL, NULL)).canonical());
+        assertEquals(Nullability.TRUE, new ConstantFolding().rule(new And(EMPTY, NULL, NULL)).canonical().nullable());
 
         assertEquals(TRUE, new ConstantFolding().rule(new Or(EMPTY, NULL, TRUE)).canonical());
         assertEquals(TRUE, new ConstantFolding().rule(new Or(EMPTY, TRUE, NULL)).canonical());
-        assertEquals(NULL, new ConstantFolding().rule(new Or(EMPTY, NULL, FALSE)).canonical());
-        assertEquals(NULL, new ConstantFolding().rule(new Or(EMPTY, FALSE, NULL)).canonical());
-        assertEquals(NULL, new ConstantFolding().rule(new Or(EMPTY, NULL, NULL)).canonical());
+        assertEquals(Nullability.TRUE, new ConstantFolding().rule(new Or(EMPTY, NULL, FALSE)).canonical().nullable());
+        assertEquals(Nullability.TRUE, new ConstantFolding().rule(new Or(EMPTY, FALSE, NULL)).canonical().nullable());
+        assertEquals(Nullability.TRUE, new ConstantFolding().rule(new Or(EMPTY, NULL, NULL)).canonical().nullable());
     }
 
     public void testConstantFoldingRange() {
@@ -393,13 +382,15 @@ public void testConstantFoldingIn() {
     }
 
     public void testConstantFoldingIn_LeftValueNotFoldable() {
-        Project p = new Project(EMPTY, FROM(), Collections.singletonList(
-        new In(EMPTY, getFieldAttribute(),
-            Arrays.asList(ONE, TWO, ONE, THREE, new Sub(EMPTY, THREE, ONE), ONE, FOUR, new Abs(EMPTY, new Sub(EMPTY, TWO, FIVE))))));
+        In in = new In(EMPTY, getFieldAttribute(),
+                Arrays.asList(ONE, TWO, ONE, THREE, new Sub(EMPTY, THREE, ONE), ONE, FOUR, new Abs(EMPTY, new Sub(EMPTY, TWO, FIVE))));
+        Alias as = new Alias(in.source(), in.sourceText(), in);
+        Project p = new Project(EMPTY, FROM(), Collections.singletonList(as));
         p = (Project) new ConstantFolding().apply(p);
         assertEquals(1, p.projections().size());
-        In in = (In) p.projections().get(0);
-        assertThat(Foldables.valuesOf(in.list(), DataType.INTEGER), contains(1 ,2 ,3 ,4));
+        Alias a = (Alias) p.projections().get(0);
+        In i = (In) a.child();
+        assertThat(Foldables.valuesOf(i.list(), DataType.INTEGER), contains(1 ,2 ,3 ,4));
     }
 
     public void testConstantFoldingIn_RightValueIsNull() {
@@ -672,47 +663,12 @@ public void testSimplifyCaseConditionsFoldWhenFalse() {
             new IfConditional(EMPTY, new GreaterThan(EMPTY, getFieldAttribute(), ONE), Literal.of(EMPTY, "foo2")),
             Literal.of(EMPTY, "default")));
         assertFalse(c.foldable());
-
         Expression e = new SimplifyCase().rule(c);
         assertEquals(Case.class, e.getClass());
         c = (Case) e;
         assertEquals(2, c.conditions().size());
-        assertThat(c.conditions().get(0).condition().toString(), startsWith("Equals[a{f}#"));
-        assertThat(c.conditions().get(1).condition().toString(), startsWith("GreaterThan[a{f}#"));
-        assertFalse(c.foldable());
-        assertEquals(TypeResolution.TYPE_RESOLVED, c.typeResolved());
-    }
-
-    public void testSimplifyCaseConditionsFoldWhenTrue() {
-        // CASE WHEN a = 1 THEN 'foo1'
-        //      WHEN 1 = 1 THEN 'bar1'
-        //      WHEN 2 = 1 THEN 'bar2'
-        //      WHEN a > 1 THEN 'foo2'
-        // ELSE 'default'
-        // END
-        //
-        // ==>
-        //
-        // CASE WHEN a = 1 THEN 'foo1'
-        //      WHEN 1 = 1 THEN 'bar1'
-        // ELSE 'default'
-        // END
-
-        Case c = new Case(EMPTY, Arrays.asList(
-            new IfConditional(EMPTY, new Equals(EMPTY, getFieldAttribute(), ONE), Literal.of(EMPTY, "foo1")),
-            new IfConditional(EMPTY, new Equals(EMPTY, ONE, ONE), Literal.of(EMPTY, "bar1")),
-            new IfConditional(EMPTY, new Equals(EMPTY, TWO, ONE), Literal.of(EMPTY, "bar2")),
-            new IfConditional(EMPTY, new GreaterThan(EMPTY, getFieldAttribute(), ONE), Literal.of(EMPTY, "foo2")),
-            Literal.of(EMPTY, "default")));
-        assertFalse(c.foldable());
-
-        SimplifyCase rule = new SimplifyCase();
-        Expression e = rule.rule(c);
-        assertEquals(Case.class, e.getClass());
-        c = (Case) e;
-        assertEquals(2, c.conditions().size());
-        assertThat(c.conditions().get(0).condition().toString(), startsWith("Equals[a{f}#"));
-        assertThat(c.conditions().get(1).condition().toString(), startsWith("Equals[=1,=1]#"));
+        assertThat(c.conditions().get(0).condition().getClass(), is(Equals.class));
+        assertThat(c.conditions().get(1).condition().getClass(), is(GreaterThan.class));
         assertFalse(c.foldable());
         assertEquals(TypeResolution.TYPE_RESOLVED, c.typeResolved());
     }
@@ -738,7 +694,7 @@ public void testSimplifyCaseConditionsFoldCompletely_FoldableElse() {
         assertEquals(Case.class, e.getClass());
         c = (Case) e;
         assertEquals(1, c.conditions().size());
-        assertThat(c.conditions().get(0).condition().toString(), startsWith("Equals[=1,=1]#"));
+        assertThat(c.conditions().get(0).condition().nodeString(), is("1[INTEGER] == 1[INTEGER]"));
         assertTrue(c.foldable());
         assertEquals("foo2", c.fold());
         assertEquals(TypeResolution.TYPE_RESOLVED, c.typeResolved());
@@ -822,7 +778,7 @@ public void testSimplifyIif_ConditionFalse_NonFoldableResult() {
         assertFalse(iif.foldable());
         assertEquals("myField", Expressions.name(iif.elseResult()));
     }
-
+    
     //
     // Logical simplifications
     //
@@ -854,13 +810,11 @@ public void testNullEqualsWithNullLiteralBecomesIsNull() {
         assertEquals(IsNull.class, e.getClass());
         IsNull isNull = (IsNull) e;
         assertEquals(source, isNull.source());
-        assertEquals("IS_NULL(a)", isNull.name());
 
         e = bcSimpl.rule(swapLiteralsToRight.rule(new NullEquals(source, NULL, fa)));
         assertEquals(IsNull.class, e.getClass());
         isNull = (IsNull) e;
         assertEquals(source, isNull.source());
-        assertEquals("IS_NULL(a)", isNull.name());
     }
 
     public void testLiteralsOnTheRight() {
@@ -1500,7 +1454,8 @@ public void testTranslateMinToFirst() {
         Min min1 =  new Min(EMPTY, new FieldAttribute(EMPTY, "str", new EsField("str", DataType.KEYWORD, emptyMap(), true)));
         Min min2 =  new Min(EMPTY, getFieldAttribute());
 
-        OrderBy plan = new OrderBy(EMPTY, new Aggregate(EMPTY, FROM(), emptyList(), Arrays.asList(min1, min2)),
+        OrderBy plan = new OrderBy(EMPTY, new Aggregate(EMPTY, FROM(), emptyList(),
+                Arrays.asList(a("min1", min1), a("min2", min2))),
             Arrays.asList(
                 new Order(EMPTY, min1, OrderDirection.ASC, Order.NullsPosition.LAST),
                 new Order(EMPTY, min2, OrderDirection.ASC, Order.NullsPosition.LAST)));
@@ -1515,16 +1470,17 @@ public void testTranslateMinToFirst() {
         assertTrue(((OrderBy) result).child() instanceof Aggregate);
         List<? extends NamedExpression> aggregates = ((Aggregate) ((OrderBy) result).child()).aggregates();
         assertEquals(2, aggregates.size());
-        assertEquals(First.class, aggregates.get(0).getClass());
-        assertSame(first, aggregates.get(0));
-        assertEquals(min2, aggregates.get(1));
+        assertEquals(Alias.class, aggregates.get(0).getClass());
+        assertEquals(Alias.class, aggregates.get(1).getClass());
+        assertSame(first, ((Alias) aggregates.get(0)).child());
+        assertEquals(min2, ((Alias) aggregates.get(1)).child());
     }
 
     public void testTranslateMaxToLast() {
         Max max1 =  new Max(EMPTY, new FieldAttribute(EMPTY, "str", new EsField("str", DataType.KEYWORD, emptyMap(), true)));
         Max max2 =  new Max(EMPTY, getFieldAttribute());
 
-        OrderBy plan = new OrderBy(EMPTY, new Aggregate(EMPTY, FROM(), emptyList(), Arrays.asList(max1, max2)),
+        OrderBy plan = new OrderBy(EMPTY, new Aggregate(EMPTY, FROM(), emptyList(), Arrays.asList(a("max1", max1), a("max2", max2))),
             Arrays.asList(
                 new Order(EMPTY, max1, OrderDirection.ASC, Order.NullsPosition.LAST),
                 new Order(EMPTY, max2, OrderDirection.ASC, Order.NullsPosition.LAST)));
@@ -1538,9 +1494,10 @@ public void testTranslateMaxToLast() {
         assertTrue(((OrderBy) result).child() instanceof Aggregate);
         List<? extends NamedExpression> aggregates = ((Aggregate) ((OrderBy) result).child()).aggregates();
         assertEquals(2, aggregates.size());
-        assertEquals(Last.class, aggregates.get(0).getClass());
-        assertSame(last, aggregates.get(0));
-        assertEquals(max2, aggregates.get(1));
+        assertEquals(Alias.class, aggregates.get(0).getClass());
+        assertEquals(Alias.class, aggregates.get(1).getClass());
+        assertSame(last, ((Alias) aggregates.get(0)).child());
+        assertEquals(max2, ((Alias) aggregates.get(1)).child());
     }
 
     public void testSortAggregateOnOrderByWithTwoFields() {
@@ -1551,12 +1508,12 @@ public void testSortAggregateOnOrderByWithTwoFields() {
         Alias secondAlias = new Alias(EMPTY, "second_alias", secondField);
         Order firstOrderBy = new Order(EMPTY, firstField, OrderDirection.ASC, Order.NullsPosition.LAST);
         Order secondOrderBy = new Order(EMPTY, secondField, OrderDirection.ASC, Order.NullsPosition.LAST);
-
+        
         OrderBy orderByPlan = new OrderBy(EMPTY,
                 new Aggregate(EMPTY, FROM(), Arrays.asList(secondField, firstField), Arrays.asList(secondAlias, firstAlias)),
                 Arrays.asList(firstOrderBy, secondOrderBy));
         LogicalPlan result = new SortAggregateOnOrderBy().apply(orderByPlan);
-
+        
         assertTrue(result instanceof OrderBy);
         List<Order> order = ((OrderBy) result).order();
         assertEquals(2, order.size());
@@ -1564,7 +1521,7 @@ public void testSortAggregateOnOrderByWithTwoFields() {
         assertTrue(order.get(1).child() instanceof FieldAttribute);
         assertEquals("first_field", ((FieldAttribute) order.get(0).child()).name());
         assertEquals("second_field", ((FieldAttribute) order.get(1).child()).name());
-
+        
         assertTrue(((OrderBy) result).child() instanceof Aggregate);
         Aggregate agg = (Aggregate) ((OrderBy) result).child();
         List<?> groupings = agg.groupings();
@@ -1583,12 +1540,12 @@ public void testSortAggregateOnOrderByOnlyAliases() {
         Alias secondAlias = new Alias(EMPTY, "second_alias", secondField);
         Order firstOrderBy = new Order(EMPTY, firstAlias, OrderDirection.ASC, Order.NullsPosition.LAST);
         Order secondOrderBy = new Order(EMPTY, secondAlias, OrderDirection.ASC, Order.NullsPosition.LAST);
-
+        
         OrderBy orderByPlan = new OrderBy(EMPTY,
                 new Aggregate(EMPTY, FROM(), Arrays.asList(secondAlias, firstAlias), Arrays.asList(secondAlias, firstAlias)),
                 Arrays.asList(firstOrderBy, secondOrderBy));
         LogicalPlan result = new SortAggregateOnOrderBy().apply(orderByPlan);
-
+        
         assertTrue(result instanceof OrderBy);
         List<Order> order = ((OrderBy) result).order();
         assertEquals(2, order.size());
@@ -1596,7 +1553,7 @@ public void testSortAggregateOnOrderByOnlyAliases() {
         assertTrue(order.get(1).child() instanceof Alias);
         assertEquals("first_alias", ((Alias) order.get(0).child()).name());
         assertEquals("second_alias", ((Alias) order.get(1).child()).name());
-
+        
         assertTrue(((OrderBy) result).child() instanceof Aggregate);
         Aggregate agg = (Aggregate) ((OrderBy) result).child();
         List<?> groupings = agg.groupings();
@@ -1611,7 +1568,7 @@ public void testPivotRewrite() {
         FieldAttribute column = getFieldAttribute("pivot");
         FieldAttribute number = getFieldAttribute("number");
         List<NamedExpression> values = Arrays.asList(new Alias(EMPTY, "ONE", L(1)), new Alias(EMPTY, "TWO", L(2)));
-        List<NamedExpression> aggs = Arrays.asList(new Avg(EMPTY, number));
+        List<NamedExpression> aggs = Arrays.asList(new Alias(EMPTY, "AVG", new Avg(EMPTY, number)));
         Pivot pivot = new Pivot(EMPTY, new EsRelation(EMPTY, new EsIndex("table", emptyMap()), false), column, values, aggs);
 
         LogicalPlan result = new RewritePivot().apply(pivot);
@@ -1657,8 +1614,8 @@ public void testAggregatesPromoteToStats_WithFullTextPredicatesConditions() {
         }
         AggregateFunction firstAggregate = randomFrom(aggregates);
         AggregateFunction secondAggregate = randomValueOtherThan(firstAggregate, () -> randomFrom(aggregates));
-        Aggregate aggregatePlan = new Aggregate(EMPTY, filter, Collections.singletonList(matchField),
-                Arrays.asList(firstAggregate, secondAggregate));
+        Aggregate aggregatePlan = new Aggregate(EMPTY, filter, singletonList(matchField),
+                Arrays.asList(new Alias(EMPTY, "first", firstAggregate), new Alias(EMPTY, "second", secondAggregate)));
         LogicalPlan result;
         if (isSimpleStats) {
             result = new ReplaceAggsWithStats().apply(aggregatePlan);
@@ -1669,11 +1626,17 @@ public void testAggregatesPromoteToStats_WithFullTextPredicatesConditions() {
         assertTrue(result instanceof Aggregate);
         Aggregate resultAgg = (Aggregate) result;
         assertEquals(2, resultAgg.aggregates().size());
-        assertTrue(resultAgg.aggregates().get(0) instanceof InnerAggregate);
-        assertTrue(resultAgg.aggregates().get(1) instanceof InnerAggregate);
 
-        InnerAggregate resultFirstAgg = (InnerAggregate) resultAgg.aggregates().get(0);
-        InnerAggregate resultSecondAgg = (InnerAggregate) resultAgg.aggregates().get(1);
+        NamedExpression one = resultAgg.aggregates().get(0);
+        assertTrue(one instanceof Alias);
+        assertTrue(((Alias) one).child() instanceof InnerAggregate);
+
+        NamedExpression two = resultAgg.aggregates().get(1);
+        assertTrue(two instanceof Alias);
+        assertTrue(((Alias) two).child() instanceof InnerAggregate);
+
+        InnerAggregate resultFirstAgg = (InnerAggregate) ((Alias) one).child();
+        InnerAggregate resultSecondAgg = (InnerAggregate) ((Alias) two).child();
         assertEquals(resultFirstAgg.inner(), firstAggregate);
         assertEquals(resultSecondAgg.inner(), secondAggregate);
         if (isSimpleStats) {
@@ -1691,4 +1654,34 @@ public void testAggregatesPromoteToStats_WithFullTextPredicatesConditions() {
         assertTrue(resultAgg.child() instanceof Filter);
         assertEquals(resultAgg.child(), filter);
     }
-}
+
+    public void testReplaceAttributesWithTarget() {
+        FieldAttribute a = getFieldAttribute("a");
+        FieldAttribute b = getFieldAttribute("b");
+        
+        Alias aAlias = new Alias(EMPTY, "aAlias", a);
+        Alias bAlias = new Alias(EMPTY, "bAlias", b);
+        
+        Project p = new Project(EMPTY, FROM(), Arrays.asList(aAlias, bAlias));
+        Filter f = new Filter(EMPTY, p,
+                new And(EMPTY, new GreaterThan(EMPTY, aAlias.toAttribute(), L(1)), new GreaterThan(EMPTY, bAlias.toAttribute(), L(2))));
+        
+        ReplaceReferenceAttributeWithSource rule = new ReplaceReferenceAttributeWithSource();
+        Expression condition = f.condition();
+        assertTrue(condition instanceof And);
+        And and = (And) condition;
+        assertTrue(and.left() instanceof GreaterThan);
+        GreaterThan gt = (GreaterThan) and.left();
+        assertEquals(aAlias.toAttribute(), gt.left());
+
+        LogicalPlan plan = rule.apply(f);
+
+        Filter filter = (Filter) plan;
+        condition = filter.condition();
+        assertTrue(condition instanceof And);
+        and = (And) condition;
+        assertTrue(and.left() instanceof GreaterThan);
+        gt = (GreaterThan) and.left();
+        assertEquals(a, gt.left());
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/ExpressionTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/ExpressionTests.java
index c9fb153f57e02..8d25901650b65 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/ExpressionTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/ExpressionTests.java
@@ -493,8 +493,8 @@ public void testCaseWithoutOperand() {
         assertEquals(3, c.conditions().size());
         IfConditional ifc = c.conditions().get(0);
         assertEquals("WHEN a = 1 THEN 'one'", ifc.sourceText());
-        assertThat(ifc.condition().toString(), startsWith("Equals[?a,1]#"));
-        assertEquals("'one'=one", ifc.result().toString());
+        assertThat(ifc.condition().toString(), startsWith("a = 1"));
+        assertEquals("one", ifc.result().toString());
         assertEquals(Literal.NULL, c.elseResult());
 
         expr = parser.createExpression(
@@ -508,7 +508,7 @@ public void testCaseWithoutOperand() {
         assertEquals(2, c.conditions().size());
         ifc = c.conditions().get(0);
         assertEquals("WHEN a = 1 THEN 'one'", ifc.sourceText());
-        assertEquals("'many'=many", c.elseResult().toString());
+        assertEquals("many", c.elseResult().toString());
     }
 
     public void testCaseWithOperand() {
@@ -523,8 +523,8 @@ public void testCaseWithOperand() {
         assertEquals(3, c.conditions().size());
         IfConditional ifc = c.conditions().get(0);
         assertEquals("WHEN 1 THEN 'one'", ifc.sourceText());
-        assertThat(ifc.condition().toString(), startsWith("Equals[?a,1]#"));
-        assertEquals("'one'=one", ifc.result().toString());
+        assertThat(ifc.condition().toString(), startsWith("WHEN 1 THEN 'one'"));
+        assertEquals("one", ifc.result().toString());
         assertEquals(Literal.NULL, c.elseResult());
 
         expr = parser.createExpression(
@@ -537,6 +537,6 @@ public void testCaseWithOperand() {
         assertEquals(2, c.conditions().size());
         ifc = c.conditions().get(0);
         assertEquals("WHEN 1 THEN 'one'", ifc.sourceText());
-        assertEquals("'many'=many", c.elseResult().toString());
+        assertEquals("many", c.elseResult().toString());
     }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/SqlParserTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/SqlParserTests.java
index ca31e32b2edc3..1dc9567016ec5 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/SqlParserTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/SqlParserTests.java
@@ -12,14 +12,12 @@
 import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.NamedExpression;
 import org.elasticsearch.xpack.sql.expression.Order;
+import org.elasticsearch.xpack.sql.expression.UnresolvedAlias;
 import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
-import org.elasticsearch.xpack.sql.expression.UnresolvedStar;
 import org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
 import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MatchQueryPredicate;
 import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MultiMatchQueryPredicate;
 import org.elasticsearch.xpack.sql.expression.predicate.fulltext.StringQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Add;
 import org.elasticsearch.xpack.sql.plan.logical.Filter;
 import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
@@ -40,7 +38,7 @@
 public class SqlParserTests extends ESTestCase {
 
     public void testSelectStar() {
-        singleProjection(project(parseStatement("SELECT * FROM foo")), UnresolvedStar.class);
+        singleProjection(project(parseStatement("SELECT * FROM foo")), UnresolvedAlias.class);
     }
 
     private <T> T singleProjection(Project project, Class<T> type) {
@@ -69,42 +67,44 @@ public void testEscapeSingleAndDoubleQuotes() {
     }
 
     public void testSelectField() {
-        UnresolvedAttribute a = singleProjection(project(parseStatement("SELECT bar FROM foo")), UnresolvedAttribute.class);
-        assertEquals("bar", a.name());
+        UnresolvedAlias a = singleProjection(project(parseStatement("SELECT bar FROM foo")), UnresolvedAlias.class);
+        assertEquals("bar", a.sourceText());
     }
 
     public void testSelectScore() {
-        UnresolvedFunction f = singleProjection(project(parseStatement("SELECT SCORE() FROM foo")), UnresolvedFunction.class);
+        UnresolvedAlias f = singleProjection(project(parseStatement("SELECT SCORE() FROM foo")), UnresolvedAlias.class);
         assertEquals("SCORE()", f.sourceText());
     }
 
     public void testSelectCast() {
-        Cast f = singleProjection(project(parseStatement("SELECT CAST(POWER(languages, 2) AS DOUBLE) FROM foo")), Cast.class);
+        UnresolvedAlias f = singleProjection(project(parseStatement("SELECT CAST(POWER(languages, 2) AS DOUBLE) FROM foo")),
+                UnresolvedAlias.class);
         assertEquals("CAST(POWER(languages, 2) AS DOUBLE)", f.sourceText());
     }
 
     public void testSelectCastOperator() {
-        Cast f = singleProjection(project(parseStatement("SELECT POWER(languages, 2)::DOUBLE FROM foo")), Cast.class);
+        UnresolvedAlias f = singleProjection(project(parseStatement("SELECT POWER(languages, 2)::DOUBLE FROM foo")), UnresolvedAlias.class);
         assertEquals("POWER(languages, 2)::DOUBLE", f.sourceText());
     }
 
     public void testSelectCastWithSQLOperator() {
-        Cast f = singleProjection(project(parseStatement("SELECT CONVERT(POWER(languages, 2), SQL_DOUBLE) FROM foo")), Cast.class);
+        UnresolvedAlias f = singleProjection(project(parseStatement("SELECT CONVERT(POWER(languages, 2), SQL_DOUBLE) FROM foo")),
+                UnresolvedAlias.class);
         assertEquals("CONVERT(POWER(languages, 2), SQL_DOUBLE)", f.sourceText());
     }
 
     public void testSelectCastToEsType() {
-        Cast f = singleProjection(project(parseStatement("SELECT CAST('0.' AS SCALED_FLOAT)")), Cast.class);
+        UnresolvedAlias f = singleProjection(project(parseStatement("SELECT CAST('0.' AS SCALED_FLOAT)")), UnresolvedAlias.class);
         assertEquals("CAST('0.' AS SCALED_FLOAT)", f.sourceText());
     }
 
     public void testSelectAddWithParanthesis() {
-        Add f = singleProjection(project(parseStatement("SELECT (1 +  2)")), Add.class);
-        assertEquals("1 +  2", f.sourceText());
+        UnresolvedAlias f = singleProjection(project(parseStatement("SELECT (1 +  2)")), UnresolvedAlias.class);
+        assertEquals("(1 +  2)", f.sourceText());
     }
 
     public void testSelectRightFunction() {
-        UnresolvedFunction f = singleProjection(project(parseStatement("SELECT RIGHT()")), UnresolvedFunction.class);
+        UnresolvedAlias f = singleProjection(project(parseStatement("SELECT RIGHT()")), UnresolvedAlias.class);
         assertEquals("RIGHT()", f.sourceText());
     }
 
@@ -124,8 +124,8 @@ public void testsSelectNonReservedKeywords() {
 
         for (int i = 0; i < project.projections().size(); i++) {
             NamedExpression ne = project.projections().get(i);
-            assertEquals(UnresolvedAttribute.class, ne.getClass());
-            assertEquals(reserved[i], ne.name());
+            assertEquals(UnresolvedAlias.class, ne.getClass());
+            assertEquals(reserved[i], ne.sourceText());
         }
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryFolderTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryFolderTests.java
index 11f6cc949de44..18afb92b27361 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryFolderTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryFolderTests.java
@@ -12,8 +12,8 @@
 import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
 import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
 import org.elasticsearch.xpack.sql.expression.Expressions;
+import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
 import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunctionAttribute;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.plan.physical.EsQueryExec;
@@ -70,7 +70,7 @@ public void testFoldingToLocalExecWithProject() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecWithProjectAndLimit() {
@@ -80,7 +80,7 @@ public void testFoldingToLocalExecWithProjectAndLimit() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecWithProjectAndOrderBy() {
@@ -90,7 +90,7 @@ public void testFoldingToLocalExecWithProjectAndOrderBy() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecWithProjectAndOrderByAndLimit() {
@@ -100,7 +100,7 @@ public void testFoldingToLocalExecWithProjectAndOrderByAndLimit() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testLocalExecWithPrunedFilterWithFunction() {
@@ -110,7 +110,7 @@ public void testLocalExecWithPrunedFilterWithFunction() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("E(){c}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("E(){r}#"));
     }
 
     public void testLocalExecWithPrunedFilterWithFunctionAndAggregation() {
@@ -120,7 +120,7 @@ public void testLocalExecWithPrunedFilterWithFunctionAndAggregation() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("E(){c}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("E(){r}#"));
     }
 
     public void testFoldingToLocalExecWithAggregationAndLimit() {
@@ -130,7 +130,7 @@ public void testFoldingToLocalExecWithAggregationAndLimit() {
         assertEquals(SingletonExecutable.class, le.executable().getClass());
         SingletonExecutable ee = (SingletonExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("'foo'{c}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("'foo'{r}#"));
     }
 
     public void testFoldingToLocalExecWithAggregationAndOrderBy() {
@@ -140,7 +140,7 @@ public void testFoldingToLocalExecWithAggregationAndOrderBy() {
         assertEquals(SingletonExecutable.class, le.executable().getClass());
         SingletonExecutable ee = (SingletonExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("'foo'{c}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("'foo'{r}#"));
     }
 
     public void testFoldingToLocalExecWithAggregationAndOrderByAndLimit() {
@@ -150,7 +150,7 @@ public void testFoldingToLocalExecWithAggregationAndOrderByAndLimit() {
         assertEquals(SingletonExecutable.class, le.executable().getClass());
         SingletonExecutable ee = (SingletonExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("'foo'{c}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("'foo'{r}#"));
     }
 
     public void testLocalExecWithoutFromClause() {
@@ -160,9 +160,9 @@ public void testLocalExecWithoutFromClause() {
         assertEquals(SingletonExecutable.class, le.executable().getClass());
         SingletonExecutable ee = (SingletonExecutable) le.executable();
         assertEquals(3, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("E(){c}#"));
-        assertThat(ee.output().get(1).toString(), startsWith("'foo'{c}#"));
-        assertThat(ee.output().get(2).toString(), startsWith("abs(10){c}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("E(){r}#"));
+        assertThat(ee.output().get(1).toString(), startsWith("'foo'{r}#"));
+        assertThat(ee.output().get(2).toString(), startsWith("abs(10){r}#"));
     }
 
     public void testLocalExecWithoutFromClauseWithPrunedFilter() {
@@ -172,7 +172,7 @@ public void testLocalExecWithoutFromClauseWithPrunedFilter() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("E(){c}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("E(){r}#"));
     }
 
     public void testFoldingOfIsNull() {
@@ -180,7 +180,7 @@ public void testFoldingOfIsNull() {
         assertEquals(LocalExec.class, p.getClass());
         LocalExec ee = (LocalExec) p;
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecBooleanAndNull_WhereClause() {
@@ -190,7 +190,7 @@ public void testFoldingToLocalExecBooleanAndNull_WhereClause() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecBooleanAndNull_HavingClause() {
@@ -200,8 +200,8 @@ public void testFoldingToLocalExecBooleanAndNull_HavingClause() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
-        assertThat(ee.output().get(1).toString(), startsWith("max(int){a->"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
+        assertThat(ee.output().get(1).toString(), startsWith("max(int){r}"));
     }
 
     public void testFoldingBooleanOrNull_WhereClause() {
@@ -211,7 +211,7 @@ public void testFoldingBooleanOrNull_WhereClause() {
         assertEquals("{\"range\":{\"int\":{\"from\":10,\"to\":null,\"include_lower\":false,\"include_upper\":false,\"boost\":1.0}}}",
             ee.queryContainer().query().asBuilder().toString().replaceAll("\\s+", ""));
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingBooleanOrNull_HavingClause() {
@@ -222,8 +222,8 @@ public void testFoldingBooleanOrNull_HavingClause() {
             "\"script\":{\"source\":\"InternalSqlScriptUtils.nullSafeFilter(InternalSqlScriptUtils.gt(params.a0,params.v0))\"," +
             "\"lang\":\"painless\",\"params\":{\"v0\":10}},"));
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
-        assertThat(ee.output().get(1).toString(), startsWith("max(int){a->"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
+        assertThat(ee.output().get(1).toString(), startsWith("max(int){r}"));
     }
 
     public void testFoldingOfIsNotNull() {
@@ -231,7 +231,7 @@ public void testFoldingOfIsNotNull() {
         assertEquals(EsQueryExec.class, p.getClass());
         EsQueryExec ee = (EsQueryExec) p;
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecWithNullFilter() {
@@ -241,7 +241,7 @@ public void testFoldingToLocalExecWithNullFilter() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecWithProject_FoldableIn() {
@@ -251,7 +251,7 @@ public void testFoldingToLocalExecWithProject_FoldableIn() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecWithProject_WithOrderAndLimit() {
@@ -261,7 +261,7 @@ public void testFoldingToLocalExecWithProject_WithOrderAndLimit() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingToLocalExecWithProjectWithGroupBy_WithOrderAndLimit() {
@@ -271,8 +271,8 @@ public void testFoldingToLocalExecWithProjectWithGroupBy_WithOrderAndLimit() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
-        assertThat(ee.output().get(1).toString(), startsWith("max(int){a->"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
+        assertThat(ee.output().get(1).toString(), startsWith("max(int){r}"));
     }
 
     public void testFoldingToLocalExecWithProjectWithGroupBy_WithHaving_WithOrderAndLimit() {
@@ -282,8 +282,8 @@ public void testFoldingToLocalExecWithProjectWithGroupBy_WithHaving_WithOrderAnd
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
-        assertThat(ee.output().get(1).toString(), startsWith("max(int){a->"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
+        assertThat(ee.output().get(1).toString(), startsWith("max(int){r}"));
     }
 
     public void testGroupKeyTypes_Boolean() {
@@ -296,8 +296,8 @@ public void testGroupKeyTypes_Boolean() {
                 "\"lang\":\"painless\",\"params\":{\"v0\":\"int\",\"v1\":10}},\"missing_bucket\":true," +
                 "\"value_type\":\"boolean\",\"order\":\"asc\"}}}]}}}"));
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("count(*){a->"));
-        assertThat(ee.output().get(1).toString(), startsWith("a{s->"));
+        assertThat(ee.output().get(0).toString(), startsWith("count(*){r}"));
+        assertThat(ee.output().get(1).toString(), startsWith("a{r}"));
     }
 
     public void testGroupKeyTypes_Integer() {
@@ -310,8 +310,8 @@ public void testGroupKeyTypes_Integer() {
                 "\"lang\":\"painless\",\"params\":{\"v0\":\"int\",\"v1\":10}},\"missing_bucket\":true," +
                 "\"value_type\":\"long\",\"order\":\"asc\"}}}]}}}"));
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("count(*){a->"));
-        assertThat(ee.output().get(1).toString(), startsWith("a{s->"));
+        assertThat(ee.output().get(0).toString(), startsWith("count(*){r}"));
+        assertThat(ee.output().get(1).toString(), startsWith("a{r}"));
     }
 
     public void testGroupKeyTypes_Rational() {
@@ -324,8 +324,8 @@ public void testGroupKeyTypes_Rational() {
                 "\"lang\":\"painless\",\"params\":{\"v0\":\"int\"}},\"missing_bucket\":true," +
                 "\"value_type\":\"double\",\"order\":\"asc\"}}}]}}}"));
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("count(*){a->"));
-        assertThat(ee.output().get(1).toString(), startsWith("a{s->"));
+        assertThat(ee.output().get(0).toString(), startsWith("count(*){r}"));
+        assertThat(ee.output().get(1).toString(), startsWith("a{r}"));
     }
 
     public void testGroupKeyTypes_String() {
@@ -338,8 +338,8 @@ public void testGroupKeyTypes_String() {
                 "\"lang\":\"painless\",\"params\":{\"v0\":\"keyword\"}},\"missing_bucket\":true," +
                 "\"value_type\":\"string\",\"order\":\"asc\"}}}]}}}"));
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("count(*){a->"));
-        assertThat(ee.output().get(1).toString(), startsWith("a{s->"));
+        assertThat(ee.output().get(0).toString(), startsWith("count(*){r}#"));
+        assertThat(ee.output().get(1).toString(), startsWith("a{r}"));
     }
 
     public void testGroupKeyTypes_IP() {
@@ -352,8 +352,8 @@ public void testGroupKeyTypes_IP() {
                     "\"lang\":\"painless\",\"params\":{\"v0\":\"keyword\",\"v1\":\"IP\"}}," +
                     "\"missing_bucket\":true,\"value_type\":\"ip\",\"order\":\"asc\"}}}]}}}"));
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("count(*){a->"));
-        assertThat(ee.output().get(1).toString(), startsWith("a{s->"));
+        assertThat(ee.output().get(0).toString(), startsWith("count(*){r}#"));
+        assertThat(ee.output().get(1).toString(), startsWith("a{r}"));
     }
 
     public void testGroupKeyTypes_DateTime() {
@@ -367,8 +367,8 @@ public void testGroupKeyTypes_DateTime() {
                 "\"v0\":\"date\",\"v1\":\"P1Y2M\",\"v2\":\"INTERVAL_YEAR_TO_MONTH\"}},\"missing_bucket\":true," +
                 "\"value_type\":\"long\",\"order\":\"asc\"}}}]}}}"));
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("count(*){a->"));
-        assertThat(ee.output().get(1).toString(), startsWith("a{s->"));
+        assertThat(ee.output().get(0).toString(), startsWith("count(*){r}#"));
+        assertThat(ee.output().get(1).toString(), startsWith("a{r}"));
     }
 
     public void testConcatIsNotFoldedForNull() {
@@ -378,7 +378,7 @@ public void testConcatIsNotFoldedForNull() {
         assertEquals(EmptyExecutable.class, le.executable().getClass());
         EmptyExecutable ee = (EmptyExecutable) le.executable();
         assertEquals(1, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("keyword{f}#"));
+        assertThat(ee.output().get(0).toString(), startsWith("test.keyword{f}#"));
     }
 
     public void testFoldingOfPercentileSecondArgument() {
@@ -386,9 +386,8 @@ public void testFoldingOfPercentileSecondArgument() {
         assertEquals(EsQueryExec.class, p.getClass());
         EsQueryExec ee = (EsQueryExec) p;
         assertEquals(1, ee.output().size());
-        assertEquals(AggregateFunctionAttribute.class, ee.output().get(0).getClass());
-        AggregateFunctionAttribute afa = (AggregateFunctionAttribute) ee.output().get(0);
-        assertThat(afa.propertyPath(), endsWith("[3.0]"));
+        assertEquals(ReferenceAttribute.class, ee.output().get(0).getClass());
+        assertTrue(ee.toString().contains("3.0"));
     }
 
     public void testFoldingOfPercentileRankSecondArgument() {
@@ -396,9 +395,8 @@ public void testFoldingOfPercentileRankSecondArgument() {
         assertEquals(EsQueryExec.class, p.getClass());
         EsQueryExec ee = (EsQueryExec) p;
         assertEquals(1, ee.output().size());
-        assertEquals(AggregateFunctionAttribute.class, ee.output().get(0).getClass());
-        AggregateFunctionAttribute afa = (AggregateFunctionAttribute) ee.output().get(0);
-        assertThat(afa.propertyPath(), endsWith("[3.0]"));
+        assertEquals(ReferenceAttribute.class, ee.output().get(0).getClass());
+        assertTrue(ee.toString().contains("3.0"));
     }
 
     public void testFoldingOfPivot() {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
index 36722e6e1d0f5..41da90ad3164f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
@@ -18,6 +18,7 @@
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
 import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
 import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
+import org.elasticsearch.xpack.sql.expression.Alias;
 import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.FieldAttribute;
 import org.elasticsearch.xpack.sql.expression.Literal;
@@ -36,6 +37,7 @@
 import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.plan.physical.EsQueryExec;
 import org.elasticsearch.xpack.sql.plan.physical.PhysicalPlan;
+import org.elasticsearch.xpack.sql.planner.QueryFolder.FoldAggregate.GroupingContext;
 import org.elasticsearch.xpack.sql.planner.QueryTranslator.QueryTranslation;
 import org.elasticsearch.xpack.sql.querydsl.agg.AggFilter;
 import org.elasticsearch.xpack.sql.querydsl.agg.GroupByDateHistogram;
@@ -437,7 +439,7 @@ public void testLikeConstructsNotSupported() {
         assertTrue(p instanceof Filter);
         Expression condition = ((Filter) p).condition();
         SqlIllegalArgumentException ex = expectThrows(SqlIllegalArgumentException.class, () -> QueryTranslator.toQuery(condition, false));
-        assertEquals("Scalar function [LTRIM(keyword)] not allowed (yet) as argument for LIKE", ex.getMessage());
+        assertEquals("Scalar function [LTRIM(keyword)] not allowed (yet) as argument for LTRIM(keyword) like '%a%'", ex.getMessage());
     }
 
     public void testRLikeConstructsNotSupported() {
@@ -447,7 +449,7 @@ public void testRLikeConstructsNotSupported() {
         assertTrue(p instanceof Filter);
         Expression condition = ((Filter) p).condition();
         SqlIllegalArgumentException ex = expectThrows(SqlIllegalArgumentException.class, () -> QueryTranslator.toQuery(condition, false));
-        assertEquals("Scalar function [LTRIM(keyword)] not allowed (yet) as argument for RLIKE", ex.getMessage());
+        assertEquals("Scalar function [LTRIM(keyword)] not allowed (yet) as argument for LTRIM(keyword) RLIKE '.*a.*'", ex.getMessage());
     }
 
     public void testDifferentLikeAndNotLikePatterns() {
@@ -592,7 +594,7 @@ public void testTranslateIsNullExpression_HavingClause_Painless() {
         AggFilter aggFilter = translation.aggFilter;
         assertEquals("InternalSqlScriptUtils.nullSafeFilter(InternalSqlScriptUtils.isNull(params.a0))",
             aggFilter.scriptTemplate().toString());
-        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int){a->"));
+        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int)"));
     }
 
     public void testTranslateIsNotNullExpression_HavingClause_Painless() {
@@ -605,7 +607,7 @@ public void testTranslateIsNotNullExpression_HavingClause_Painless() {
         AggFilter aggFilter = translation.aggFilter;
         assertEquals("InternalSqlScriptUtils.nullSafeFilter(InternalSqlScriptUtils.isNotNull(params.a0))",
             aggFilter.scriptTemplate().toString());
-        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int){a->"));
+        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int)"));
     }
 
     public void testTranslateInExpression_WhereClause() {
@@ -676,7 +678,7 @@ public void testTranslateInExpression_HavingClause_Painless() {
         AggFilter aggFilter = translation.aggFilter;
         assertEquals("InternalSqlScriptUtils.nullSafeFilter(InternalSqlScriptUtils.in(params.a0, params.v0))",
             aggFilter.scriptTemplate().toString());
-        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int){a->"));
+        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int)"));
         assertThat(aggFilter.scriptTemplate().params().toString(), endsWith(", {v=[10, 20]}]"));
     }
 
@@ -690,7 +692,7 @@ public void testTranslateInExpression_HavingClause_PainlessOneArg() {
         AggFilter aggFilter = translation.aggFilter;
         assertEquals("InternalSqlScriptUtils.nullSafeFilter(InternalSqlScriptUtils.in(params.a0, params.v0))",
             aggFilter.scriptTemplate().toString());
-        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int){a->"));
+        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int)"));
         assertThat(aggFilter.scriptTemplate().params().toString(), endsWith(", {v=[10]}]"));
 
     }
@@ -705,7 +707,7 @@ public void testTranslateInExpression_HavingClause_PainlessAndNullHandling() {
         AggFilter aggFilter = translation.aggFilter;
         assertEquals("InternalSqlScriptUtils.nullSafeFilter(InternalSqlScriptUtils.in(params.a0, params.v0))",
             aggFilter.scriptTemplate().toString());
-        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int){a->"));
+        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int)"));
         assertThat(aggFilter.scriptTemplate().params().toString(), endsWith(", {v=[10, null, 20, 30]}]"));
     }
 
@@ -724,7 +726,7 @@ public void testTranslateMathFunction_HavingClause_Painless() {
         assertEquals("InternalSqlScriptUtils.nullSafeFilter(InternalSqlScriptUtils.gt(InternalSqlScriptUtils." +
                 operation.name().toLowerCase(Locale.ROOT) + "(params.a0),params.v0))",
             aggFilter.scriptTemplate().toString());
-        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int){a->"));
+        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=max(int)"));
         assertThat(aggFilter.scriptTemplate().params().toString(), endsWith(", {v=10}]"));
     }
 
@@ -735,12 +737,12 @@ public void testTranslateRoundWithOneParameter() {
         assertEquals(1, ((Aggregate) p).groupings().size());
         assertEquals(1, ((Aggregate) p).aggregates().size());
         assertTrue(((Aggregate) p).groupings().get(0) instanceof Round);
-        assertTrue(((Aggregate) p).aggregates().get(0) instanceof Round);
+        assertTrue(((Alias) (((Aggregate) p).aggregates().get(0))).child() instanceof Round);
 
         Round groupingRound = (Round) ((Aggregate) p).groupings().get(0);
         assertEquals(1, groupingRound.children().size());
 
-        QueryTranslator.GroupingContext groupingContext = QueryTranslator.groupBy(((Aggregate) p).groupings());
+        GroupingContext groupingContext = QueryFolder.FoldAggregate.groupBy(((Aggregate) p).groupings());
         assertNotNull(groupingContext);
         ScriptTemplate scriptTemplate = groupingContext.tail.script();
         assertEquals("InternalSqlScriptUtils.round(InternalSqlScriptUtils.dateTimeChrono(InternalSqlScriptUtils.docValue(doc,params.v0), "
@@ -756,14 +758,15 @@ public void testTranslateRoundWithTwoParameters() {
         assertEquals(1, ((Aggregate) p).groupings().size());
         assertEquals(1, ((Aggregate) p).aggregates().size());
         assertTrue(((Aggregate) p).groupings().get(0) instanceof Round);
-        assertTrue(((Aggregate) p).aggregates().get(0) instanceof Round);
+        assertTrue(((Aggregate) p).aggregates().get(0) instanceof Alias);
+        assertTrue(((Alias) (((Aggregate) p).aggregates().get(0))).child() instanceof Round);
 
         Round groupingRound = (Round) ((Aggregate) p).groupings().get(0);
         assertEquals(2, groupingRound.children().size());
         assertTrue(groupingRound.children().get(1) instanceof Literal);
         assertEquals(-2, ((Literal) groupingRound.children().get(1)).value());
 
-        QueryTranslator.GroupingContext groupingContext = QueryTranslator.groupBy(((Aggregate) p).groupings());
+        GroupingContext groupingContext = QueryFolder.FoldAggregate.groupBy(((Aggregate) p).groupings());
         assertNotNull(groupingContext);
         ScriptTemplate scriptTemplate = groupingContext.tail.script();
         assertEquals("InternalSqlScriptUtils.round(InternalSqlScriptUtils.dateTimeChrono(InternalSqlScriptUtils.docValue(doc,params.v0), "
@@ -783,7 +786,7 @@ public void testGroupByAndHavingWithFunctionOnTopOfAggregation() {
         assertEquals("InternalSqlScriptUtils.nullSafeFilter(InternalSqlScriptUtils.gt(InternalSqlScriptUtils.abs" +
                 "(params.a0),params.v0))",
             aggFilter.scriptTemplate().toString());
-        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=MAX(int){a->"));
+        assertThat(aggFilter.scriptTemplate().params().toString(), startsWith("[{a=MAX(int)"));
         assertThat(aggFilter.scriptTemplate().params().toString(), endsWith(", {v=10}]"));
     }
 
@@ -895,7 +898,7 @@ public void testTranslateCoalesce_GroupBy_Painless() {
         assertTrue(p instanceof Aggregate);
         Expression condition = ((Aggregate) p).groupings().get(0);
         assertFalse(condition.foldable());
-        QueryTranslator.GroupingContext groupingContext = QueryTranslator.groupBy(((Aggregate) p).groupings());
+        GroupingContext groupingContext = QueryFolder.FoldAggregate.groupBy(((Aggregate) p).groupings());
         assertNotNull(groupingContext);
         ScriptTemplate scriptTemplate = groupingContext.tail.script();
         assertEquals("InternalSqlScriptUtils.coalesce([InternalSqlScriptUtils.docValue(doc,params.v0),params.v1])",
@@ -908,7 +911,7 @@ public void testTranslateNullIf_GroupBy_Painless() {
         assertTrue(p instanceof Aggregate);
         Expression condition = ((Aggregate) p).groupings().get(0);
         assertFalse(condition.foldable());
-        QueryTranslator.GroupingContext groupingContext = QueryTranslator.groupBy(((Aggregate) p).groupings());
+        GroupingContext groupingContext = QueryFolder.FoldAggregate.groupBy(((Aggregate) p).groupings());
         assertNotNull(groupingContext);
         ScriptTemplate scriptTemplate = groupingContext.tail.script();
         assertEquals("InternalSqlScriptUtils.nullif(InternalSqlScriptUtils.docValue(doc,params.v0),params.v1)",
@@ -921,7 +924,7 @@ public void testTranslateCase_GroupBy_Painless() {
         assertTrue(p instanceof Aggregate);
         Expression condition = ((Aggregate) p).groupings().get(0);
         assertFalse(condition.foldable());
-        QueryTranslator.GroupingContext groupingContext = QueryTranslator.groupBy(((Aggregate) p).groupings());
+        GroupingContext groupingContext = QueryFolder.FoldAggregate.groupBy(((Aggregate) p).groupings());
         assertNotNull(groupingContext);
         ScriptTemplate scriptTemplate = groupingContext.tail.script();
         assertEquals("InternalSqlScriptUtils.caseFunction([InternalSqlScriptUtils.gt(InternalSqlScriptUtils.docValue(" + "" +
@@ -936,7 +939,7 @@ public void testTranslateIif_GroupBy_Painless() {
         assertTrue(p instanceof Aggregate);
         Expression condition = ((Aggregate) p).groupings().get(0);
         assertFalse(condition.foldable());
-        QueryTranslator.GroupingContext groupingContext = QueryTranslator.groupBy(((Aggregate) p).groupings());
+        GroupingContext groupingContext = QueryFolder.FoldAggregate.groupBy(((Aggregate) p).groupings());
         assertNotNull(groupingContext);
         ScriptTemplate scriptTemplate = groupingContext.tail.script();
         assertEquals("InternalSqlScriptUtils.caseFunction([InternalSqlScriptUtils.gt("  +
@@ -1066,8 +1069,8 @@ public void testCountAndCountDistinctFolding() {
         assertEquals(EsQueryExec.class, p.getClass());
         EsQueryExec ee = (EsQueryExec) p;
         assertEquals(2, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("dkey{a->"));
-        assertThat(ee.output().get(1).toString(), startsWith("key{a->"));
+        assertThat(ee.output().get(0).toString(), startsWith("dkey{r}"));
+        assertThat(ee.output().get(1).toString(), startsWith("key{r}"));
 
         Collection<AggregationBuilder> subAggs = ee.queryContainer().aggs().asAggBuilder().getSubAggregations();
         assertEquals(2, subAggs.size());
@@ -1092,12 +1095,12 @@ public void testAllCountVariantsWithHavingGenerateCorrectAggregations() {
         assertEquals(EsQueryExec.class, p.getClass());
         EsQueryExec ee = (EsQueryExec) p;
         assertEquals(6, ee.output().size());
-        assertThat(ee.output().get(0).toString(), startsWith("AVG(int){a->"));
-        assertThat(ee.output().get(1).toString(), startsWith("ln{a->"));
-        assertThat(ee.output().get(2).toString(), startsWith("dln{a->"));
-        assertThat(ee.output().get(3).toString(), startsWith("fn{a->"));
-        assertThat(ee.output().get(4).toString(), startsWith("dfn{a->"));
-        assertThat(ee.output().get(5).toString(), startsWith("ccc{a->"));
+        assertThat(ee.output().get(0).toString(), startsWith("AVG(int){r}"));
+        assertThat(ee.output().get(1).toString(), startsWith("ln{r}"));
+        assertThat(ee.output().get(2).toString(), startsWith("dln{r}"));
+        assertThat(ee.output().get(3).toString(), startsWith("fn{r}"));
+        assertThat(ee.output().get(4).toString(), startsWith("dfn{r}"));
+        assertThat(ee.output().get(5).toString(), startsWith("ccc{r}"));
 
         Collection<AggregationBuilder> subAggs = ee.queryContainer().aggs().asAggBuilder().getSubAggregations();
         assertEquals(5, subAggs.size());
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainerTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainerTests.java
index a23dc8a3f2784..432be5fea4a8f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainerTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainerTests.java
@@ -8,7 +8,8 @@
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.sql.expression.Alias;
 import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.ExpressionId;
+import org.elasticsearch.xpack.sql.expression.AttributeMap;
+import org.elasticsearch.xpack.sql.expression.Expression;
 import org.elasticsearch.xpack.sql.expression.FieldAttribute;
 import org.elasticsearch.xpack.sql.querydsl.query.BoolQuery;
 import org.elasticsearch.xpack.sql.querydsl.query.MatchAll;
@@ -81,11 +82,11 @@ public void testColumnMaskShouldDuplicateSameAttributes() {
         Attribute fourth = new FieldAttribute(Source.EMPTY, "fourth", esField);
         Alias firstAliased = new Alias(Source.EMPTY, "firstAliased", first);
 
-        Map<ExpressionId,Attribute> aliasesMap = new LinkedHashMap<>();
-        aliasesMap.put(firstAliased.id(), first);
+        Map<Attribute, Expression> aliasesMap = new LinkedHashMap<>();
+        aliasesMap.put(firstAliased.toAttribute(), first);
 
         QueryContainer queryContainer = new QueryContainer()
-            .withAliases(aliasesMap)
+            .withAliases(new AttributeMap<>(aliasesMap))
             .addColumn(third)
             .addColumn(first)
             .addColumn(fourth)

From 22433e91c85ce2d20a5836f2af9dcc1d609aee70 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 6 Dec 2019 17:43:25 +0100
Subject: [PATCH 099/686] Fix TimedRunnable Executing onAfter Twice (#49910)

If we have a nested `AbstractRunnable` inside of `TimedRunnable`
it's executed twice on `run` (once when its own `run` method is invoked and once when
the `onAfter` in the `TimedRunnable` is executed).
Simply removing the `onAfter` override in `TimedRunnable` makes sure that the `onAfter`
is only called once by the `run` on the nested `AbstractRunnable` itself.
Same was done for `onFailure` as it was double-triggering as well on exceptions in the inner `onFailure`.
---
 .../common/util/concurrent/TimedRunnable.java | 13 +----
 .../util/concurrent/TimedRunnableTests.java   | 55 ++++++++++++++++---
 2 files changed, 47 insertions(+), 21 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/util/concurrent/TimedRunnable.java b/server/src/main/java/org/elasticsearch/common/util/concurrent/TimedRunnable.java
index f2de68453a6c2..075556e730134 100644
--- a/server/src/main/java/org/elasticsearch/common/util/concurrent/TimedRunnable.java
+++ b/server/src/main/java/org/elasticsearch/common/util/concurrent/TimedRunnable.java
@@ -57,21 +57,10 @@ public void onRejection(final Exception e) {
         }
     }
 
-    @Override
-    public void onAfter() {
-        if (original instanceof AbstractRunnable) {
-            ((AbstractRunnable) original).onAfter();
-        }
-    }
-
     @Override
     public void onFailure(final Exception e) {
         this.failedOrRejected = true;
-        if (original instanceof AbstractRunnable) {
-            ((AbstractRunnable) original).onFailure(e);
-        } else {
-            ExceptionsHelper.reThrowIfNotNull(e);
-        }
+        ExceptionsHelper.reThrowIfNotNull(e);
     }
 
     @Override
diff --git a/server/src/test/java/org/elasticsearch/common/util/concurrent/TimedRunnableTests.java b/server/src/test/java/org/elasticsearch/common/util/concurrent/TimedRunnableTests.java
index 9cd84617273ea..8725a4734cb19 100644
--- a/server/src/test/java/org/elasticsearch/common/util/concurrent/TimedRunnableTests.java
+++ b/server/src/test/java/org/elasticsearch/common/util/concurrent/TimedRunnableTests.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.common.util.concurrent;
 
+import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.test.ESTestCase;
 
 import java.util.concurrent.RejectedExecutionException;
@@ -33,7 +34,6 @@ public void testTimedRunnableDelegatesToAbstractRunnable() {
         final boolean isForceExecution = randomBoolean();
         final AtomicBoolean onAfter = new AtomicBoolean();
         final AtomicReference<Exception> onRejection = new AtomicReference<>();
-        final AtomicReference<Exception> onFailure = new AtomicReference<>();
         final AtomicBoolean doRun = new AtomicBoolean();
 
         final AbstractRunnable runnable = new AbstractRunnable() {
@@ -54,7 +54,6 @@ public void onRejection(final Exception e) {
 
             @Override
             public void onFailure(final Exception e) {
-                onFailure.set(e);
             }
 
             @Override
@@ -67,19 +66,13 @@ protected void doRun() throws Exception {
 
         assertThat(timedRunnable.isForceExecution(), equalTo(isForceExecution));
 
-        timedRunnable.onAfter();
-        assertTrue(onAfter.get());
-
         final Exception rejection = new RejectedExecutionException();
         timedRunnable.onRejection(rejection);
         assertThat(onRejection.get(), equalTo(rejection));
 
-        final Exception failure = new Exception();
-        timedRunnable.onFailure(failure);
-        assertThat(onFailure.get(), equalTo(failure));
-
         timedRunnable.run();
         assertTrue(doRun.get());
+        assertTrue(onAfter.get());
     }
 
     public void testTimedRunnableDelegatesRunInFailureCase() {
@@ -144,4 +137,48 @@ public void testTimedRunnableRethrowsRejectionWhenNotAbstractRunnable() {
         assertSame(exception, thrown);
     }
 
+    public void testTimedRunnableExecutesNestedOnAfterOnce() {
+        final AtomicBoolean afterRan = new AtomicBoolean(false);
+        new TimedRunnable(new AbstractRunnable() {
+
+            @Override
+            public void onFailure(final Exception e) {
+            }
+
+            @Override
+            protected void doRun() {
+            }
+
+            @Override
+            public void onAfter() {
+                if (afterRan.compareAndSet(false, true) == false) {
+                    fail("onAfter should have only been called once");
+                }
+            }
+        }).run();
+        assertTrue(afterRan.get());
+    }
+
+    public void testNestedOnFailureTriggersOnlyOnce() {
+        final Exception expectedException = new RuntimeException();
+        final AtomicBoolean onFailureRan = new AtomicBoolean(false);
+        RuntimeException thrown = expectThrows(RuntimeException.class, () -> new TimedRunnable(new AbstractRunnable() {
+
+            @Override
+            public void onFailure(Exception e) {
+                if (onFailureRan.compareAndSet(false, true) == false) {
+                    fail("onFailure should have only been called once");
+                }
+                ExceptionsHelper.reThrowIfNotNull(e);
+            }
+
+            @Override
+            protected void doRun() throws Exception {
+                throw expectedException;
+            }
+
+        }).run());
+        assertTrue(onFailureRan.get());
+        assertSame(thrown, expectedException);
+    }
 }

From 0665944cc424377e9d694f2931d8305293f33580 Mon Sep 17 00:00:00 2001
From: David Roberts <dave.roberts@elastic.co>
Date: Fri, 6 Dec 2019 17:04:09 +0000
Subject: [PATCH 100/686] [TEST] Mute
 ConnectionManagerTests.testConcurrentConnectsAndDisconnects

Due to https://github.com/elastic/elasticsearch/issues/49903
---
 .../java/org/elasticsearch/transport/ConnectionManagerTests.java | 1 +
 1 file changed, 1 insertion(+)

diff --git a/server/src/test/java/org/elasticsearch/transport/ConnectionManagerTests.java b/server/src/test/java/org/elasticsearch/transport/ConnectionManagerTests.java
index f34d39ae7252a..37c0d92612fdc 100644
--- a/server/src/test/java/org/elasticsearch/transport/ConnectionManagerTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/ConnectionManagerTests.java
@@ -124,6 +124,7 @@ public void onNodeDisconnected(DiscoveryNode node, Transport.Connection connecti
         assertEquals(1, nodeDisconnectedCount.get());
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/49903")
     public void testConcurrentConnectsAndDisconnects() throws BrokenBarrierException, InterruptedException {
         DiscoveryNode node = new DiscoveryNode("", new TransportAddress(InetAddress.getLoopbackAddress(), 0), Version.CURRENT);
         Transport.Connection connection = new TestConnect(node);

From 8d82517795c03f36288cd9ae226063d1860adaaf Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Fri, 6 Dec 2019 11:34:25 -0700
Subject: [PATCH 101/686] Refactor IndexLifecycleRunner to split state
 modification (#49891)

This commit refactors the `IndexLifecycleRunner` to split out and
consolidate the number of methods that change state from within ILM. It
adds a new class `IndexLifecycleTransition` that contains a number of
static methods used to modify ILM's state. These methods all return new
cluster states rather than making changes themselves (they can be
thought of as helpers for modifying ILM state).

Rather than having multiple ways to move an index to a particular step
(like `moveClusterStateToStep`, `moveClusterStateToNextStep`,
`moveClusterStateToPreviouslyFailedStep`, etc (there are others)) this
now consolidates those into three with (hopefully) useful names:

- `moveClusterStateToStep`
- `moveClusterStateToErrorStep`
- `moveClusterStateToPreviouslyFailedStep`

In the move, I was also able to consolidate duplicate or redundant
arguments to these functions. Prior to this commit there were many calls
that provided duplicate information (both `IndexMetaData` and
`LifecycleExecutionState` for example) where the duplicate argument
could be derived from a previous argument with no problems.

With this split, `IndexLifecycleRunner` now contains the methods used to
actually run steps as well as the methods that kick off cluster state
updates for state transitions. `IndexLifecycleTransition` contains only
the helpers for constructing new states from given scenarios.

This also adds Javadocs to all methods in both `IndexLifecycleRunner`
and `IndexLifecycleTransition` (this accounts for almost all of the
increase in code lines for this commit). It also makes all methods be as
restrictive in visibility, to limit the scope of where they are used.

This refactoring is part of work towards capturing actions and
transitions that ILM makes, by consolidating and simplifying the places
we make state changes, it will make adding operation auditing easier.
---
 .../core/ilm/LifecycleExecutionState.java     |  32 +
 .../ilm/LifecycleExecutionStateTests.java     |  63 ++
 .../test/ilm/40_explain_lifecycle.yml         |  12 +-
 .../xpack/ilm/ExecuteStepsUpdateTask.java     |  14 +-
 .../xpack/ilm/IndexLifecycleRunner.java       | 406 ++------
 .../xpack/ilm/IndexLifecycleService.java      |  32 +-
 .../xpack/ilm/IndexLifecycleTransition.java   | 342 +++++++
 .../xpack/ilm/MoveToErrorStepUpdateTask.java  |   5 +-
 .../xpack/ilm/MoveToNextStepUpdateTask.java   |   9 +-
 .../xpack/ilm/SetStepInfoUpdateTask.java      |   4 +-
 .../ilm/action/TransportMoveToStepAction.java |   2 +-
 ...sportRemoveIndexLifecyclePolicyAction.java |   4 +-
 .../ilm/ExecuteStepsUpdateTaskTests.java      |  12 +-
 .../xpack/ilm/IndexLifecycleRunnerTests.java  | 911 ++----------------
 .../ilm/IndexLifecycleTransitionTests.java    | 784 +++++++++++++++
 .../ilm/MoveToErrorStepUpdateTaskTests.java   |   2 +-
 .../ilm/MoveToNextStepUpdateTaskTests.java    |  33 +-
 .../xpack/ilm/SetStepInfoUpdateTaskTests.java |   2 +-
 18 files changed, 1446 insertions(+), 1223 deletions(-)
 create mode 100644 x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransition.java
 create mode 100644 x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransitionTests.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecycleExecutionState.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecycleExecutionState.java
index abc0bd7731b5f..304982381803e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecycleExecutionState.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecycleExecutionState.java
@@ -8,6 +8,8 @@
 
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.Strings;
 
 import java.util.Collections;
 import java.util.HashMap;
@@ -78,6 +80,31 @@ public static LifecycleExecutionState fromIndexMetadata(IndexMetaData indexMetaD
         return fromCustomMetadata(customData);
     }
 
+    /**
+     * Retrieves the current {@link Step.StepKey} from the lifecycle state. Note that
+     * it is illegal for the step to be set with the phase and/or action unset,
+     * or for the step to be unset with the phase and/or action set. All three
+     * settings must be either present or missing.
+     *
+     * @param lifecycleState the index custom data to extract the {@link Step.StepKey} from.
+     */
+    @Nullable
+    public static Step.StepKey getCurrentStepKey(LifecycleExecutionState lifecycleState) {
+        Objects.requireNonNull(lifecycleState, "cannot determine current step key as lifecycle state is null");
+        String currentPhase = lifecycleState.getPhase();
+        String currentAction = lifecycleState.getAction();
+        String currentStep = lifecycleState.getStep();
+        if (Strings.isNullOrEmpty(currentStep)) {
+            assert Strings.isNullOrEmpty(currentPhase) : "Current phase is not empty: " + currentPhase;
+            assert Strings.isNullOrEmpty(currentAction) : "Current action is not empty: " + currentAction;
+            return null;
+        } else {
+            assert Strings.isNullOrEmpty(currentPhase) == false;
+            assert Strings.isNullOrEmpty(currentAction) == false;
+            return new Step.StepKey(currentPhase, currentAction, currentStep);
+        }
+    }
+
     public static Builder builder() {
         return new Builder();
     }
@@ -278,6 +305,11 @@ public int hashCode() {
             getStepInfo(), getPhaseDefinition(), getLifecycleDate(), getPhaseTime(), getActionTime(), getStepTime());
     }
 
+    @Override
+    public String toString() {
+        return asMap().toString();
+    }
+
     public static class Builder {
         private String phase;
         private String action;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecycleExecutionStateTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecycleExecutionStateTests.java
index e6e9d5ead0fb1..7a7782fb389ca 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecycleExecutionStateTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecycleExecutionStateTests.java
@@ -71,6 +71,69 @@ public void testEqualsAndHashcode() {
             LifecycleExecutionStateTests::mutate);
     }
 
+    public void testGetCurrentStepKey() {
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        Step.StepKey stepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState.build());
+        assertNull(stepKey);
+
+        String phase = randomAlphaOfLength(20);
+        String action = randomAlphaOfLength(20);
+        String step = randomAlphaOfLength(20);
+        LifecycleExecutionState.Builder lifecycleState2 = LifecycleExecutionState.builder();
+        lifecycleState2.setPhase(phase);
+        lifecycleState2.setAction(action);
+        lifecycleState2.setStep(step);
+        stepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState2.build());
+        assertNotNull(stepKey);
+        assertEquals(phase, stepKey.getPhase());
+        assertEquals(action, stepKey.getAction());
+        assertEquals(step, stepKey.getName());
+
+        phase = randomAlphaOfLength(20);
+        action = randomAlphaOfLength(20);
+        step = null;
+        LifecycleExecutionState.Builder lifecycleState3 = LifecycleExecutionState.builder();
+        lifecycleState3.setPhase(phase);
+        lifecycleState3.setAction(action);
+        lifecycleState3.setStep(step);
+        AssertionError error3 = expectThrows(AssertionError.class,
+            () -> LifecycleExecutionState.getCurrentStepKey(lifecycleState3.build()));
+        assertEquals("Current phase is not empty: " + phase, error3.getMessage());
+
+        phase = null;
+        action = randomAlphaOfLength(20);
+        step = null;
+        LifecycleExecutionState.Builder lifecycleState4 = LifecycleExecutionState.builder();
+        lifecycleState4.setPhase(phase);
+        lifecycleState4.setAction(action);
+        lifecycleState4.setStep(step);
+        AssertionError error4 = expectThrows(AssertionError.class,
+            () -> LifecycleExecutionState.getCurrentStepKey(lifecycleState4.build()));
+        assertEquals("Current action is not empty: " + action, error4.getMessage());
+
+        phase = null;
+        action = randomAlphaOfLength(20);
+        step = randomAlphaOfLength(20);
+        LifecycleExecutionState.Builder lifecycleState5 = LifecycleExecutionState.builder();
+        lifecycleState5.setPhase(phase);
+        lifecycleState5.setAction(action);
+        lifecycleState5.setStep(step);
+        AssertionError error5 = expectThrows(AssertionError.class,
+            () -> LifecycleExecutionState.getCurrentStepKey(lifecycleState5.build()));
+        assertNull(error5.getMessage());
+
+        phase = null;
+        action = null;
+        step = randomAlphaOfLength(20);
+        LifecycleExecutionState.Builder lifecycleState6 = LifecycleExecutionState.builder();
+        lifecycleState6.setPhase(phase);
+        lifecycleState6.setAction(action);
+        lifecycleState6.setStep(step);
+        AssertionError error6 = expectThrows(AssertionError.class,
+            () -> LifecycleExecutionState.getCurrentStepKey(lifecycleState6.build()));
+        assertNull(error6.getMessage());
+    }
+
     private static LifecycleExecutionState mutate(LifecycleExecutionState toMutate) {
         LifecycleExecutionState.Builder newState = LifecycleExecutionState.builder(toMutate);
         boolean changed = false;
diff --git a/x-pack/plugin/ilm/qa/rest/src/test/resources/rest-api-spec/test/ilm/40_explain_lifecycle.yml b/x-pack/plugin/ilm/qa/rest/src/test/resources/rest-api-spec/test/ilm/40_explain_lifecycle.yml
index c91f98fb18bd2..fc9b187923267 100644
--- a/x-pack/plugin/ilm/qa/rest/src/test/resources/rest-api-spec/test/ilm/40_explain_lifecycle.yml
+++ b/x-pack/plugin/ilm/qa/rest/src/test/resources/rest-api-spec/test/ilm/40_explain_lifecycle.yml
@@ -115,9 +115,9 @@ teardown:
   - match: { indices.my_index.step: "complete" }
   - is_true: indices.my_index.phase_time_millis
   - is_true: indices.my_index.age
+  - is_true: indices.my_index.phase_execution
   - is_false: indices.my_index.failed_step
   - is_false: indices.my_index.step_info
-  - is_false: indices.my_index.phase_execution
 
   - is_false: indices.my_index2
   - is_false: indices.another_index
@@ -139,9 +139,9 @@ teardown:
   - match: { indices.my_index.step: "complete" }
   - is_true: indices.my_index.phase_time_millis
   - is_true: indices.my_index.age
+  - is_true: indices.my_index.phase_execution
   - is_false: indices.my_index.failed_step
   - is_false: indices.my_index.step_info
-  - is_false: indices.my_index.phase_execution
 
   - is_true: indices.my_index2.managed
   - match: { indices.my_index2.index: "my_index2" }
@@ -151,9 +151,9 @@ teardown:
   - match: { indices.my_index2.step: "complete" }
   - is_true: indices.my_index2.phase_time_millis
   - is_true: indices.my_index2.age
+  - is_true: indices.my_index2.phase_execution
   - is_false: indices.my_index2.failed_step
   - is_false: indices.my_index2.step_info
-  - is_false: indices.my_index2.phase_execution
 
   - is_false: indices.another_index
   - is_false: indices.unmanaged_index
@@ -178,9 +178,9 @@ teardown:
   - match: { indices.my_index.step: "complete" }
   - is_true: indices.my_index.phase_time_millis
   - is_true: indices.my_index.age
+  - is_true: indices.my_index.phase_execution
   - is_false: indices.my_index.failed_step
   - is_false: indices.my_index.step_info
-  - is_false: indices.my_index.phase_execution
 
   - is_true: indices.my_index2.managed
   - match: { indices.my_index2.index: "my_index2" }
@@ -190,9 +190,9 @@ teardown:
   - match: { indices.my_index2.step: "complete" }
   - is_true: indices.my_index2.phase_time_millis
   - is_true: indices.my_index2.age
+  - is_true: indices.my_index2.phase_execution
   - is_false: indices.my_index2.failed_step
   - is_false: indices.my_index2.step_info
-  - is_false: indices.my_index2.phase_execution
 
   - is_true: indices.another_index.managed
   - match: { indices.another_index.index: "another_index" }
@@ -202,9 +202,9 @@ teardown:
   - match: { indices.another_index.step: "complete" }
   - is_true: indices.another_index.phase_time_millis
   - is_true: indices.another_index.age
+  - is_true: indices.another_index.phase_execution
   - is_false: indices.another_index.failed_step
   - is_false: indices.another_index.step_info
-  - is_false: indices.another_index.phase_execution
 
   - match: { indices.unmanaged_index.index: "unmanaged_index" }
   - is_false: indices.unmanaged_index.managed
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTask.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTask.java
index 9b269b0695473..46364f7cb4021 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTask.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTask.java
@@ -16,7 +16,6 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.xpack.core.ilm.ClusterStateActionStep;
 import org.elasticsearch.xpack.core.ilm.ClusterStateWaitStep;
-import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
 import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
 
@@ -78,8 +77,7 @@ public ClusterState execute(final ClusterState currentState) throws IOException
             // This index doesn't exist any more, there's nothing to execute currently
             return currentState;
         }
-        Step registeredCurrentStep = IndexLifecycleRunner.getCurrentStep(policyStepsRegistry, policy, indexMetaData,
-            LifecycleExecutionState.fromIndexMetadata(indexMetaData));
+        Step registeredCurrentStep = IndexLifecycleRunner.getCurrentStep(policyStepsRegistry, policy, indexMetaData);
         if (currentStep.equals(registeredCurrentStep)) {
             ClusterState state = currentState;
             // We can do cluster state steps all together until we
@@ -103,8 +101,8 @@ public ClusterState execute(final ClusterState currentState) throws IOException
                         return state;
                     } else {
                         logger.trace("[{}] moving cluster state to next step [{}]", index.getName(), nextStepKey);
-                        state = IndexLifecycleRunner.moveClusterStateToNextStep(index, state, currentStep.getKey(),
-                            nextStepKey, nowSupplier, false);
+                        state = IndexLifecycleTransition.moveClusterStateToStep(index, state, nextStepKey, nowSupplier,
+                            policyStepsRegistry, false);
                     }
                 } else {
                     // set here to make sure that the clusterProcessed knows to execute the
@@ -130,8 +128,8 @@ public ClusterState execute(final ClusterState currentState) throws IOException
                         if (currentStep.getNextStepKey() == null) {
                             return state;
                         } else {
-                            state = IndexLifecycleRunner.moveClusterStateToNextStep(index, state, currentStep.getKey(),
-                                currentStep.getNextStepKey(), nowSupplier, false);
+                            state = IndexLifecycleTransition.moveClusterStateToStep(index, state,
+                                currentStep.getNextStepKey(), nowSupplier, policyStepsRegistry,false);
                         }
                     } else {
                         logger.trace("[{}] condition not met ({}) [{}], returning existing state",
@@ -145,7 +143,7 @@ public ClusterState execute(final ClusterState currentState) throws IOException
                         if (stepInfo == null) {
                             return state;
                         } else {
-                            return IndexLifecycleRunner.addStepInfoToClusterState(index, state, stepInfo);
+                            return IndexLifecycleTransition.addStepInfoToClusterState(index, state, stepInfo);
                         }
                     }
                 }
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
index 6ee59368ae7a5..5d64c35498a3d 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
@@ -8,22 +8,13 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
-import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.action.support.TransportAction;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.ClusterStateObserver;
 import org.elasticsearch.cluster.ClusterStateUpdateTask;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.service.ClusterService;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.ToXContentObject;
-import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.ilm.AsyncActionStep;
@@ -31,46 +22,45 @@
 import org.elasticsearch.xpack.core.ilm.ClusterStateActionStep;
 import org.elasticsearch.xpack.core.ilm.ClusterStateWaitStep;
 import org.elasticsearch.xpack.core.ilm.ErrorStep;
-import org.elasticsearch.xpack.core.ilm.IndexLifecycleMetadata;
-import org.elasticsearch.xpack.core.ilm.InitializePolicyContextStep;
 import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
-import org.elasticsearch.xpack.core.ilm.LifecyclePolicyMetadata;
-import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
-import org.elasticsearch.xpack.core.ilm.Phase;
 import org.elasticsearch.xpack.core.ilm.PhaseCompleteStep;
-import org.elasticsearch.xpack.core.ilm.PhaseExecutionInfo;
-import org.elasticsearch.xpack.core.ilm.RolloverAction;
 import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
 
-import java.io.IOException;
-import java.util.Collections;
-import java.util.List;
-import java.util.function.BiFunction;
 import java.util.function.LongSupplier;
 
-import static org.elasticsearch.ElasticsearchException.REST_EXCEPTION_SKIP_STACK_TRACE;
-import static org.elasticsearch.xpack.core.ilm.LifecycleExecutionState.ILM_CUSTOM_METADATA_KEY;
 import static org.elasticsearch.xpack.core.ilm.LifecycleSettings.LIFECYCLE_ORIGINATION_DATE;
 
-public class IndexLifecycleRunner {
+class IndexLifecycleRunner {
     private static final Logger logger = LogManager.getLogger(IndexLifecycleRunner.class);
-    private static final ToXContent.Params STACKTRACE_PARAMS =
-        new ToXContent.MapParams(Collections.singletonMap(REST_EXCEPTION_SKIP_STACK_TRACE, "false"));
     private final ThreadPool threadPool;
     private PolicyStepsRegistry stepRegistry;
     private ClusterService clusterService;
     private LongSupplier nowSupplier;
 
-    public IndexLifecycleRunner(PolicyStepsRegistry stepRegistry, ClusterService clusterService,
-                                ThreadPool threadPool, LongSupplier nowSupplier) {
+    IndexLifecycleRunner(PolicyStepsRegistry stepRegistry, ClusterService clusterService,
+                         ThreadPool threadPool, LongSupplier nowSupplier) {
         this.stepRegistry = stepRegistry;
         this.clusterService = clusterService;
         this.nowSupplier = nowSupplier;
         this.threadPool = threadPool;
     }
 
+    /**
+     * Retrieve the index's current step.
+     */
+    static Step getCurrentStep(PolicyStepsRegistry stepRegistry, String policy, IndexMetaData indexMetaData) {
+        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
+        StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
+        logger.trace("[{}] retrieved current step key: {}", indexMetaData.getIndex().getName(), currentStepKey);
+        if (currentStepKey == null) {
+            return stepRegistry.getFirstStep(policy);
+        } else {
+            return stepRegistry.getStep(indexMetaData, currentStepKey);
+        }
+    }
+
     /**
      * Return true or false depending on whether the index is ready to be in {@code phase}
      */
@@ -101,12 +91,12 @@ boolean isReadyToTransitionToThisPhase(final String policy, final IndexMetaData
      * Run the current step, only if it is an asynchronous wait step. These
      * wait criteria are checked periodically from the ILM scheduler
      */
-    public void runPeriodicStep(String policy, IndexMetaData indexMetaData) {
+    void runPeriodicStep(String policy, IndexMetaData indexMetaData) {
         String index = indexMetaData.getIndex().getName();
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
         final Step currentStep;
         try {
-            currentStep = getCurrentStep(stepRegistry, policy, indexMetaData, lifecycleState);
+            currentStep = getCurrentStep(stepRegistry, policy, indexMetaData);
         } catch (Exception e) {
             markPolicyRetrievalError(policy, indexMetaData.getIndex(), lifecycleState, e);
             return;
@@ -118,7 +108,7 @@ public void runPeriodicStep(String policy, IndexMetaData indexMetaData) {
                 return;
             } else {
                 logger.error("current step [{}] for index [{}] with policy [{}] is not recognized",
-                    getCurrentStepKey(lifecycleState), index, policy);
+                    LifecycleExecutionState.getCurrentStepKey(lifecycleState), index, policy);
                 return;
             }
         }
@@ -163,6 +153,11 @@ public void onFailure(Exception e) {
         }
     }
 
+    /**
+     * Given the policy and index metadata for an index, this moves the index's
+     * execution state to the previously failed step, incrementing the retry
+     * counter.
+     */
     void onErrorMaybeRetryFailedStep(String policy, IndexMetaData indexMetaData) {
         String index = indexMetaData.getIndex().getName();
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
@@ -181,7 +176,8 @@ void onErrorMaybeRetryFailedStep(String policy, IndexMetaData indexMetaData) {
             clusterService.submitStateUpdateTask("ilm-retry-failed-step", new ClusterStateUpdateTask() {
                 @Override
                 public ClusterState execute(ClusterState currentState) {
-                    return moveClusterStateToPreviouslyFailedStep(currentState, index, true);
+                    return IndexLifecycleTransition.moveClusterStateToPreviouslyFailedStep(currentState, index,
+                        nowSupplier, stepRegistry, true);
                 }
 
                 @Override
@@ -198,19 +194,19 @@ public void onFailure(String source, Exception e) {
     /**
      * If the current step (matching the expected step key) is an asynchronous action step, run it
      */
-    public void maybeRunAsyncAction(ClusterState currentState, IndexMetaData indexMetaData, String policy, StepKey expectedStepKey) {
+    void maybeRunAsyncAction(ClusterState currentState, IndexMetaData indexMetaData, String policy, StepKey expectedStepKey) {
         String index = indexMetaData.getIndex().getName();
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
         final Step currentStep;
         try {
-            currentStep = getCurrentStep(stepRegistry, policy, indexMetaData, lifecycleState);
+            currentStep = getCurrentStep(stepRegistry, policy, indexMetaData);
         } catch (Exception e) {
             markPolicyRetrievalError(policy, indexMetaData.getIndex(), lifecycleState, e);
             return;
         }
         if (currentStep == null) {
             logger.warn("current step [{}] for index [{}] with policy [{}] is not recognized",
-                getCurrentStepKey(lifecycleState), index, policy);
+                LifecycleExecutionState.getCurrentStepKey(lifecycleState), index, policy);
             return;
         }
 
@@ -247,12 +243,12 @@ public void onFailure(Exception e) {
      * Run the current step that either waits for index age, or updates/waits-on cluster state.
      * Invoked after the cluster state has been changed
      */
-    public void runPolicyAfterStateChange(String policy, IndexMetaData indexMetaData) {
+    void runPolicyAfterStateChange(String policy, IndexMetaData indexMetaData) {
         String index = indexMetaData.getIndex().getName();
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
         final Step currentStep;
         try {
-            currentStep = getCurrentStep(stepRegistry, policy, indexMetaData, lifecycleState);
+            currentStep = getCurrentStep(stepRegistry, policy, indexMetaData);
         } catch (Exception e) {
             markPolicyRetrievalError(policy, indexMetaData.getIndex(), lifecycleState, e);
             return;
@@ -263,7 +259,7 @@ public void runPolicyAfterStateChange(String policy, IndexMetaData indexMetaData
                 return;
             } else {
                 logger.error("current step [{}] for index [{}] with policy [{}] is not recognized",
-                    getCurrentStepKey(lifecycleState), index, policy);
+                    LifecycleExecutionState.getCurrentStepKey(lifecycleState), index, policy);
                 return;
             }
         }
@@ -293,336 +289,58 @@ public void runPolicyAfterStateChange(String policy, IndexMetaData indexMetaData
     }
 
     /**
-     * Retrieves the current {@link StepKey} from the index settings. Note that
-     * it is illegal for the step to be set with the phase and/or action unset,
-     * or for the step to be unset with the phase and/or action set. All three
-     * settings must be either present or missing.
-     *
-     * @param lifecycleState the index custom data to extract the {@link StepKey} from.
-     */
-    public static StepKey getCurrentStepKey(LifecycleExecutionState lifecycleState) {
-        String currentPhase = lifecycleState.getPhase();
-        String currentAction = lifecycleState.getAction();
-        String currentStep = lifecycleState.getStep();
-        if (Strings.isNullOrEmpty(currentStep)) {
-            assert Strings.isNullOrEmpty(currentPhase) : "Current phase is not empty: " + currentPhase;
-            assert Strings.isNullOrEmpty(currentAction) : "Current action is not empty: " + currentAction;
-            return null;
-        } else {
-            assert Strings.isNullOrEmpty(currentPhase) == false;
-            assert Strings.isNullOrEmpty(currentAction) == false;
-            return new StepKey(currentPhase, currentAction, currentStep);
-        }
-    }
-
-    static Step getCurrentStep(PolicyStepsRegistry stepRegistry, String policy, IndexMetaData indexMetaData,
-                               LifecycleExecutionState lifecycleState) {
-        StepKey currentStepKey = getCurrentStepKey(lifecycleState);
-        logger.trace("[{}] retrieved current step key: {}", indexMetaData.getIndex().getName(), currentStepKey);
-        if (currentStepKey == null) {
-            return stepRegistry.getFirstStep(policy);
-        } else {
-            return stepRegistry.getStep(indexMetaData, currentStepKey);
-        }
-    }
-
-    /**
-     * This method is intended for handling moving to different steps from {@link TransportAction} executions.
-     * For this reason, it is reasonable to throw {@link IllegalArgumentException} when state is not as expected.
-     *
-     * @param indexName      The index whose step is to change
-     * @param currentState   The current {@link ClusterState}
-     * @param currentStepKey The current {@link StepKey} found for the index in the current cluster state
-     * @param nextStepKey    The next step to move the index into
-     * @param nowSupplier    The current-time supplier for updating when steps changed
-     * @param stepRegistry   The steps registry to check a step-key's existence in the index's current policy
-     * @return The updated cluster state where the index moved to <code>nextStepKey</code>
-     */
-    static ClusterState moveClusterStateToStep(String indexName, ClusterState currentState, StepKey currentStepKey,
-                                               StepKey nextStepKey, LongSupplier nowSupplier,
-                                               PolicyStepsRegistry stepRegistry) {
-        IndexMetaData idxMeta = currentState.getMetaData().index(indexName);
-        validateTransition(idxMeta, currentStepKey, nextStepKey, stepRegistry);
-
-        Settings indexSettings = idxMeta.getSettings();
-        String policy = LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexSettings);
-        logger.info("moving index [{}] from [{}] to [{}] in policy [{}]",
-            indexName, currentStepKey, nextStepKey, policy);
-
-        return IndexLifecycleRunner.moveClusterStateToNextStep(idxMeta.getIndex(), currentState, currentStepKey,
-            nextStepKey, nowSupplier, true);
-    }
-
-    static void validateTransition(IndexMetaData idxMeta, StepKey currentStepKey, StepKey nextStepKey, PolicyStepsRegistry stepRegistry) {
-        String indexName = idxMeta.getIndex().getName();
-        Settings indexSettings = idxMeta.getSettings();
-        String indexPolicySetting = LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexSettings);
-
-        // policy could be updated in-between execution
-        if (Strings.isNullOrEmpty(indexPolicySetting)) {
-            throw new IllegalArgumentException("index [" + indexName + "] is not associated with an Index Lifecycle Policy");
-        }
-
-        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
-        if (currentStepKey.equals(IndexLifecycleRunner.getCurrentStepKey(lifecycleState)) == false) {
-            throw new IllegalArgumentException("index [" + indexName + "] is not on current step [" + currentStepKey + "]");
-        }
-
-        if (stepRegistry.stepExists(indexPolicySetting, nextStepKey) == false) {
-            throw new IllegalArgumentException("step [" + nextStepKey + "] for index [" + idxMeta.getIndex().getName() +
-                "] with policy [" + indexPolicySetting + "] does not exist");
-        }
-    }
-
-    static ClusterState moveClusterStateToNextStep(Index index, ClusterState clusterState, StepKey currentStep, StepKey nextStep,
-                                                   LongSupplier nowSupplier, boolean forcePhaseDefinitionRefresh) {
-        IndexMetaData idxMeta = clusterState.getMetaData().index(index);
-        IndexLifecycleMetadata ilmMeta = clusterState.metaData().custom(IndexLifecycleMetadata.TYPE);
-        LifecyclePolicyMetadata policyMetadata = ilmMeta.getPolicyMetadatas()
-            .get(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(idxMeta.getSettings()));
-        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
-        LifecycleExecutionState newLifecycleState = moveExecutionStateToNextStep(policyMetadata,
-            lifecycleState, currentStep, nextStep, nowSupplier, forcePhaseDefinitionRefresh);
-        ClusterState.Builder newClusterStateBuilder = newClusterStateWithLifecycleState(index, clusterState, newLifecycleState);
-
-        return newClusterStateBuilder.build();
-    }
-
-    static ClusterState moveClusterStateToErrorStep(Index index, ClusterState clusterState, StepKey currentStep, Exception cause,
-                                                    LongSupplier nowSupplier,
-                                                    BiFunction<IndexMetaData, StepKey, Step> stepLookupFunction) throws IOException {
-        IndexMetaData idxMeta = clusterState.getMetaData().index(index);
-        IndexLifecycleMetadata ilmMeta = clusterState.metaData().custom(IndexLifecycleMetadata.TYPE);
-        LifecyclePolicyMetadata policyMetadata = ilmMeta.getPolicyMetadatas()
-            .get(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(idxMeta.getSettings()));
-        XContentBuilder causeXContentBuilder = JsonXContent.contentBuilder();
-        causeXContentBuilder.startObject();
-        ElasticsearchException.generateThrowableXContent(causeXContentBuilder, STACKTRACE_PARAMS, cause);
-        causeXContentBuilder.endObject();
-        LifecycleExecutionState currentState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
-        LifecycleExecutionState nextStepState = moveExecutionStateToNextStep(policyMetadata, currentState, currentStep,
-            new StepKey(currentStep.getPhase(), currentStep.getAction(), ErrorStep.NAME), nowSupplier, false);
-        LifecycleExecutionState.Builder failedState = LifecycleExecutionState.builder(nextStepState);
-        failedState.setFailedStep(currentStep.getName());
-        failedState.setStepInfo(BytesReference.bytes(causeXContentBuilder).utf8ToString());
-        Step failedStep = stepLookupFunction.apply(idxMeta, currentStep);
-        if (failedStep != null) {
-            // as an initial step we'll mark the failed step as auto retryable without actually looking at the cause to determine
-            // if the error is transient/recoverable from
-            failedState.setIsAutoRetryableError(failedStep.isRetryable());
-            // maintain the retry count of the failed step as it will be cleared after a successful execution
-            failedState.setFailedStepRetryCount(currentState.getFailedStepRetryCount());
-        } else {
-            logger.warn("failed step [{}] for index [{}] is not part of policy [{}] anymore, or it is invalid",
-                currentStep.getName(), index, policyMetadata.getName());
-        }
-
-        ClusterState.Builder newClusterStateBuilder = newClusterStateWithLifecycleState(index, clusterState, failedState.build());
-        return newClusterStateBuilder.build();
-    }
-
-    ClusterState moveClusterStateToPreviouslyFailedStep(ClusterState currentState, String index, boolean isAutomaticRetry) {
-        ClusterState newState;
-        IndexMetaData indexMetaData = currentState.metaData().index(index);
-        if (indexMetaData == null) {
-            throw new IllegalArgumentException("index [" + index + "] does not exist");
-        }
-        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
-        StepKey currentStepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
-        String failedStep = lifecycleState.getFailedStep();
-        if (currentStepKey != null && ErrorStep.NAME.equals(currentStepKey.getName()) && Strings.isNullOrEmpty(failedStep) == false) {
-            StepKey nextStepKey = new StepKey(currentStepKey.getPhase(), currentStepKey.getAction(), failedStep);
-            validateTransition(indexMetaData, currentStepKey, nextStepKey, stepRegistry);
-            IndexLifecycleMetadata ilmMeta = currentState.metaData().custom(IndexLifecycleMetadata.TYPE);
-
-            LifecyclePolicyMetadata policyMetadata = ilmMeta.getPolicyMetadatas()
-                .get(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexMetaData.getSettings()));
-            LifecycleExecutionState nextStepState = moveExecutionStateToNextStep(policyMetadata,
-                lifecycleState, currentStepKey, nextStepKey, nowSupplier, true);
-            LifecycleExecutionState.Builder retryStepState = LifecycleExecutionState.builder(nextStepState);
-            retryStepState.setIsAutoRetryableError(lifecycleState.isAutoRetryableError());
-            Integer currentRetryCount = lifecycleState.getFailedStepRetryCount();
-            if (isAutomaticRetry) {
-                retryStepState.setFailedStepRetryCount(currentRetryCount == null ? 1 : ++currentRetryCount);
-            } else {
-                // manual retries don't update the retry count
-                retryStepState.setFailedStepRetryCount(lifecycleState.getFailedStepRetryCount());
-            }
-            newState = newClusterStateWithLifecycleState(indexMetaData.getIndex(), currentState, retryStepState.build()).build();
-        } else {
-            throw new IllegalArgumentException("cannot retry an action for an index ["
-                + index + "] that has not encountered an error when running a Lifecycle Policy");
-        }
-        return newState;
-    }
-
-    ClusterState moveClusterStateToPreviouslyFailedStep(ClusterState currentState, String[] indices) {
-        ClusterState newState = currentState;
-        for (String index : indices) {
-            newState = moveClusterStateToPreviouslyFailedStep(newState, index, false);
-        }
-        return newState;
-    }
-
-    private static LifecycleExecutionState moveExecutionStateToNextStep(LifecyclePolicyMetadata policyMetadata,
-                                                                        LifecycleExecutionState existingState,
-                                                                        StepKey currentStep, StepKey nextStep,
-                                                                        LongSupplier nowSupplier,
-                                                                        boolean forcePhaseDefinitionRefresh) {
-        long nowAsMillis = nowSupplier.getAsLong();
-        LifecycleExecutionState.Builder updatedState = LifecycleExecutionState.builder(existingState);
-        updatedState.setPhase(nextStep.getPhase());
-        updatedState.setAction(nextStep.getAction());
-        updatedState.setStep(nextStep.getName());
-        updatedState.setStepTime(nowAsMillis);
-
-        // clear any step info or error-related settings from the current step
-        updatedState.setFailedStep(null);
-        updatedState.setStepInfo(null);
-        updatedState.setIsAutoRetryableError(null);
-        updatedState.setFailedStepRetryCount(null);
-
-        if (currentStep.getPhase().equals(nextStep.getPhase()) == false || forcePhaseDefinitionRefresh) {
-            final String newPhaseDefinition;
-            final Phase nextPhase;
-            if ("new".equals(nextStep.getPhase()) || TerminalPolicyStep.KEY.equals(nextStep)) {
-                nextPhase = null;
-            } else {
-                nextPhase = policyMetadata.getPolicy().getPhases().get(nextStep.getPhase());
-            }
-            PhaseExecutionInfo phaseExecutionInfo = new PhaseExecutionInfo(policyMetadata.getName(), nextPhase,
-                policyMetadata.getVersion(), policyMetadata.getModifiedDate());
-            newPhaseDefinition = Strings.toString(phaseExecutionInfo, false, false);
-            updatedState.setPhaseDefinition(newPhaseDefinition);
-            updatedState.setPhaseTime(nowAsMillis);
-        } else if (currentStep.getPhase().equals(InitializePolicyContextStep.INITIALIZATION_PHASE)) {
-            // The "new" phase is the initialization phase, usually the phase
-            // time would be set on phase transition, but since there is no
-            // transition into the "new" phase, we set it any time in the "new"
-            // phase
-            updatedState.setPhaseTime(nowAsMillis);
-        }
-
-        if (currentStep.getAction().equals(nextStep.getAction()) == false) {
-            updatedState.setActionTime(nowAsMillis);
-        }
-        return updatedState.build();
-    }
-
-    static ClusterState.Builder newClusterStateWithLifecycleState(Index index, ClusterState clusterState,
-                                                                  LifecycleExecutionState lifecycleState) {
-        ClusterState.Builder newClusterStateBuilder = ClusterState.builder(clusterState);
-        newClusterStateBuilder.metaData(MetaData.builder(clusterState.getMetaData())
-            .put(IndexMetaData.builder(clusterState.getMetaData().index(index))
-                .putCustom(ILM_CUSTOM_METADATA_KEY, lifecycleState.asMap())));
-        return newClusterStateBuilder;
-    }
-
-    /**
-     * Conditionally updates cluster state with new step info. The new cluster state is only
-     * built if the step info has changed, otherwise the same old <code>clusterState</code> is
-     * returned
-     *
-     * @param index        the index to modify
-     * @param clusterState the cluster state to modify
-     * @param stepInfo     the new step info to update
-     * @return Updated cluster state with <code>stepInfo</code> if changed, otherwise the same cluster state
-     * if no changes to step info exist
-     * @throws IOException if parsing step info fails
+     * Move the index to the given {@code newStepKey}, always checks to ensure that the index's
+     * current step matches the {@code currentStepKey} prior to changing the state.
      */
-    static ClusterState addStepInfoToClusterState(Index index, ClusterState clusterState, ToXContentObject stepInfo) throws IOException {
-        IndexMetaData indexMetaData = clusterState.getMetaData().index(index);
-        if (indexMetaData == null) {
-            // This index doesn't exist anymore, we can't do anything
-            return clusterState;
-        }
-        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
-        final String stepInfoString;
-        try (XContentBuilder infoXContentBuilder = JsonXContent.contentBuilder()) {
-            stepInfo.toXContent(infoXContentBuilder, ToXContent.EMPTY_PARAMS);
-            stepInfoString = BytesReference.bytes(infoXContentBuilder).utf8ToString();
-        }
-        if (stepInfoString.equals(lifecycleState.getStepInfo())) {
-            return clusterState;
-        }
-        LifecycleExecutionState.Builder newState = LifecycleExecutionState.builder(lifecycleState);
-        newState.setStepInfo(stepInfoString);
-        ClusterState.Builder newClusterStateBuilder = newClusterStateWithLifecycleState(index, clusterState, newState.build());
-        return newClusterStateBuilder.build();
-    }
-
-    private void moveToStep(Index index, String policy, StepKey currentStepKey, StepKey nextStepKey) {
-        logger.debug("[{}] moving to step [{}] {} -> {}", index.getName(), policy, currentStepKey, nextStepKey);
+    private void moveToStep(Index index, String policy, Step.StepKey currentStepKey, Step.StepKey newStepKey) {
+        logger.debug("[{}] moving to step [{}] {} -> {}", index.getName(), policy, currentStepKey, newStepKey);
         clusterService.submitStateUpdateTask("ilm-move-to-step",
-            new MoveToNextStepUpdateTask(index, policy, currentStepKey, nextStepKey, nowSupplier, clusterState ->
+            new MoveToNextStepUpdateTask(index, policy, currentStepKey, newStepKey, nowSupplier, stepRegistry, clusterState ->
             {
                 IndexMetaData indexMetaData = clusterState.metaData().index(index);
-                if (nextStepKey != null && nextStepKey != TerminalPolicyStep.KEY && indexMetaData != null) {
-                    maybeRunAsyncAction(clusterState, indexMetaData, policy, nextStepKey);
+                if (newStepKey != null && newStepKey != TerminalPolicyStep.KEY && indexMetaData != null) {
+                    maybeRunAsyncAction(clusterState, indexMetaData, policy, newStepKey);
                 }
             }));
     }
 
-    private void moveToErrorStep(Index index, String policy, StepKey currentStepKey, Exception e) {
+    /**
+     * Move the index to the ERROR step.
+     */
+    private void moveToErrorStep(Index index, String policy, Step.StepKey currentStepKey, Exception e) {
         logger.error(new ParameterizedMessage("policy [{}] for index [{}] failed on step [{}]. Moving to ERROR step",
-                policy, index.getName(), currentStepKey), e);
+            policy, index.getName(), currentStepKey), e);
         clusterService.submitStateUpdateTask("ilm-move-to-error-step",
             new MoveToErrorStepUpdateTask(index, policy, currentStepKey, e, nowSupplier, stepRegistry::getStep));
     }
 
-    private void setStepInfo(Index index, String policy, StepKey currentStepKey, ToXContentObject stepInfo) {
+    /**
+     * Set step info for the given index inside of its {@link LifecycleExecutionState} without
+     * changing other execution state.
+     */
+    private void setStepInfo(Index index, String policy, Step.StepKey currentStepKey, ToXContentObject stepInfo) {
         clusterService.submitStateUpdateTask("ilm-set-step-info", new SetStepInfoUpdateTask(index, policy, currentStepKey, stepInfo));
     }
 
-    public static ClusterState removePolicyForIndexes(final Index[] indices, ClusterState currentState, List<String> failedIndexes) {
-        MetaData.Builder newMetadata = MetaData.builder(currentState.getMetaData());
-        boolean clusterStateChanged = false;
-        for (Index index : indices) {
-            IndexMetaData indexMetadata = currentState.getMetaData().index(index);
-            if (indexMetadata == null) {
-                // Index doesn't exist so fail it
-                failedIndexes.add(index.getName());
-            } else {
-                IndexMetaData.Builder newIdxMetadata = IndexLifecycleRunner.removePolicyForIndex(indexMetadata);
-                if (newIdxMetadata != null) {
-                    newMetadata.put(newIdxMetadata);
-                    clusterStateChanged = true;
-                }
-            }
-        }
-        if (clusterStateChanged) {
-            ClusterState.Builder newClusterState = ClusterState.builder(currentState);
-            newClusterState.metaData(newMetadata);
-            return newClusterState.build();
-        } else {
-            return currentState;
-        }
-    }
-
-    private static IndexMetaData.Builder removePolicyForIndex(IndexMetaData indexMetadata) {
-        Settings idxSettings = indexMetadata.getSettings();
-        Settings.Builder newSettings = Settings.builder().put(idxSettings);
-        boolean notChanged = true;
-
-        notChanged &= Strings.isNullOrEmpty(newSettings.remove(LifecycleSettings.LIFECYCLE_NAME_SETTING.getKey()));
-        notChanged &= Strings.isNullOrEmpty(newSettings.remove(LifecycleSettings.LIFECYCLE_INDEXING_COMPLETE_SETTING.getKey()));
-        notChanged &= Strings.isNullOrEmpty(newSettings.remove(RolloverAction.LIFECYCLE_ROLLOVER_ALIAS_SETTING.getKey()));
-        long newSettingsVersion = notChanged ? indexMetadata.getSettingsVersion() : 1 + indexMetadata.getSettingsVersion();
-
-        IndexMetaData.Builder builder = IndexMetaData.builder(indexMetadata);
-        builder.removeCustom(ILM_CUSTOM_METADATA_KEY);
-        return builder.settings(newSettings).settingsVersion(newSettingsVersion);
-    }
-
+    /**
+     * Mark the index with step info explaining that the policy doesn't exist.
+     */
     private void markPolicyDoesNotExist(String policyName, Index index, LifecycleExecutionState executionState) {
         markPolicyRetrievalError(policyName, index, executionState,
             new IllegalArgumentException("policy [" + policyName + "] does not exist"));
     }
 
+    /**
+     * Mark the index with step info for a given error encountered while retrieving policy
+     * information. This is opposed to lifecycle execution errors, which would cause a transition to
+     * the ERROR step, however, the policy may be unparseable in which case there is no way to move
+     * to the ERROR step, so this is the best effort at capturing the error retrieving the policy.
+     */
     private void markPolicyRetrievalError(String policyName, Index index, LifecycleExecutionState executionState, Exception e) {
         logger.debug(
             new ParameterizedMessage("unable to retrieve policy [{}] for index [{}], recording this in step_info for this index",
-            policyName, index.getName()), e);
-        setStepInfo(index, policyName, getCurrentStepKey(executionState), new SetStepInfoUpdateTask.ExceptionWrapper(e));
+                policyName, index.getName()), e);
+        setStepInfo(index, policyName, LifecycleExecutionState.getCurrentStepKey(executionState),
+            new SetStepInfoUpdateTask.ExceptionWrapper(e));
     }
 }
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleService.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleService.java
index 9deac0322e2a3..f116f9de08743 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleService.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleService.java
@@ -87,13 +87,33 @@ public void maybeRunAsyncAction(ClusterState clusterState, IndexMetaData indexMe
         lifecycleRunner.maybeRunAsyncAction(clusterState, indexMetaData, policyName, nextStepKey);
     }
 
-    public ClusterState moveClusterStateToStep(ClusterState currentState, String indexName, StepKey currentStepKey, StepKey nextStepKey) {
-        return IndexLifecycleRunner.moveClusterStateToStep(indexName, currentState, currentStepKey, nextStepKey,
-            nowSupplier, policyRegistry);
+    /**
+     * Move the cluster state to an arbitrary step for the provided index.
+     *
+     * In order to avoid a check-then-set race condition, the current step key
+     * is required in order to validate that the index is currently on the
+     * provided step. If it is not, an {@link IllegalArgumentException} is
+     * thrown.
+     * @throws IllegalArgumentException if the step movement cannot be validated
+     */
+    public ClusterState moveClusterStateToStep(ClusterState currentState, Index index, StepKey currentStepKey, StepKey newStepKey) {
+        // We manually validate here, because any API must correctly specify the current step key
+        // when moving to an arbitrary step key (to avoid race conditions between the
+        // check-and-set). moveClusterStateToStep also does its own validation, but doesn't take
+        // the user-input for the current step (which is why we validate here for a passed in step)
+        IndexLifecycleTransition.validateTransition(currentState.getMetaData().index(index),
+            currentStepKey, newStepKey, policyRegistry);
+        return IndexLifecycleTransition.moveClusterStateToStep(index, currentState, newStepKey,
+            nowSupplier, policyRegistry, true);
     }
 
     public ClusterState moveClusterStateToPreviouslyFailedStep(ClusterState currentState, String[] indices) {
-        return lifecycleRunner.moveClusterStateToPreviouslyFailedStep(currentState, indices);
+        ClusterState newState = currentState;
+        for (String index : indices) {
+            newState = IndexLifecycleTransition.moveClusterStateToPreviouslyFailedStep(newState, index,
+                nowSupplier, policyRegistry, false);
+        }
+        return newState;
     }
 
     @Override
@@ -118,7 +138,7 @@ public void onMaster() {
                 String policyName = LifecycleSettings.LIFECYCLE_NAME_SETTING.get(idxMeta.getSettings());
                 if (Strings.isNullOrEmpty(policyName) == false) {
                     final LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
-                    StepKey stepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+                    StepKey stepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
 
                     try {
                         if (OperationMode.STOPPING == currentMode) {
@@ -279,7 +299,7 @@ void triggerPolicies(ClusterState clusterState, boolean fromClusterStateChange)
             String policyName = LifecycleSettings.LIFECYCLE_NAME_SETTING.get(idxMeta.getSettings());
             if (Strings.isNullOrEmpty(policyName) == false) {
                 final LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
-                StepKey stepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+                StepKey stepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
 
                 try {
                     if (OperationMode.STOPPING == currentMode) {
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransition.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransition.java
new file mode 100644
index 0000000000000..816186882927c
--- /dev/null
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransition.java
@@ -0,0 +1,342 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ilm;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.action.support.TransportAction;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.xpack.core.ilm.ErrorStep;
+import org.elasticsearch.xpack.core.ilm.IndexLifecycleMetadata;
+import org.elasticsearch.xpack.core.ilm.InitializePolicyContextStep;
+import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
+import org.elasticsearch.xpack.core.ilm.LifecyclePolicyMetadata;
+import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
+import org.elasticsearch.xpack.core.ilm.Phase;
+import org.elasticsearch.xpack.core.ilm.PhaseExecutionInfo;
+import org.elasticsearch.xpack.core.ilm.RolloverAction;
+import org.elasticsearch.xpack.core.ilm.Step;
+import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+import java.util.function.BiFunction;
+import java.util.function.LongSupplier;
+
+import static org.elasticsearch.ElasticsearchException.REST_EXCEPTION_SKIP_STACK_TRACE;
+import static org.elasticsearch.xpack.core.ilm.LifecycleExecutionState.ILM_CUSTOM_METADATA_KEY;
+
+/**
+ * The {@link IndexLifecycleTransition} class handles cluster state transitions
+ * related to ILM operations. These operations are all at the index level
+ * (inside of {@link IndexMetaData}) for the index in question.
+ *
+ * Each method is static and only changes a given state, no actions are
+ * performed by methods in this class.
+ */
+public final class IndexLifecycleTransition {
+    private static final Logger logger = LogManager.getLogger(IndexLifecycleTransition.class);
+    private static final ToXContent.Params STACKTRACE_PARAMS =
+        new ToXContent.MapParams(Collections.singletonMap(REST_EXCEPTION_SKIP_STACK_TRACE, "false"));
+
+    /**
+     * Validates that the given transition from {@code currentStepKey} to {@code newStepKey} can be accomplished
+     * @throws IllegalArgumentException when the transition is not valid
+     */
+    public static void validateTransition(IndexMetaData idxMeta, Step.StepKey currentStepKey,
+                                          Step.StepKey newStepKey, PolicyStepsRegistry stepRegistry) {
+        String indexName = idxMeta.getIndex().getName();
+        Settings indexSettings = idxMeta.getSettings();
+        String indexPolicySetting = LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexSettings);
+
+        // policy could be updated in-between execution
+        if (Strings.isNullOrEmpty(indexPolicySetting)) {
+            throw new IllegalArgumentException("index [" + indexName + "] is not associated with an Index Lifecycle Policy");
+        }
+
+        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
+        if (currentStepKey != null && currentStepKey.equals(LifecycleExecutionState.getCurrentStepKey(lifecycleState)) == false) {
+            throw new IllegalArgumentException("index [" + indexName + "] is not on current step [" + currentStepKey + "]");
+        }
+
+        if (stepRegistry.stepExists(indexPolicySetting, newStepKey) == false) {
+            throw new IllegalArgumentException("step [" + newStepKey + "] for index [" + idxMeta.getIndex().getName() +
+                "] with policy [" + indexPolicySetting + "] does not exist");
+        }
+    }
+
+    /**
+     * This method is intended for handling moving to different steps from {@link TransportAction} executions.
+     * For this reason, it is reasonable to throw {@link IllegalArgumentException} when state is not as expected.
+     *
+     * @param index          The index whose step is to change
+     * @param state          The current {@link ClusterState}
+     * @param newStepKey     The new step to move the index into
+     * @param nowSupplier    The current-time supplier for updating when steps changed
+     * @param stepRegistry   The steps registry to check a step-key's existence in the index's current policy
+     * @param forcePhaseDefinitionRefresh Whether to force the phase JSON to be reread or not
+     * @return The updated cluster state where the index moved to <code>newStepKey</code>
+     */
+    static ClusterState moveClusterStateToStep(Index index, ClusterState state, Step.StepKey newStepKey, LongSupplier nowSupplier,
+                                               PolicyStepsRegistry stepRegistry, boolean forcePhaseDefinitionRefresh) {
+        IndexMetaData idxMeta = state.getMetaData().index(index);
+        Step.StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(LifecycleExecutionState.fromIndexMetadata(idxMeta));
+        validateTransition(idxMeta, currentStepKey, newStepKey, stepRegistry);
+
+        Settings indexSettings = idxMeta.getSettings();
+        String policy = LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexSettings);
+        logger.info("moving index [{}] from [{}] to [{}] in policy [{}]", index.getName(), currentStepKey, newStepKey, policy);
+
+        IndexLifecycleMetadata ilmMeta = state.metaData().custom(IndexLifecycleMetadata.TYPE);
+        LifecyclePolicyMetadata policyMetadata = ilmMeta.getPolicyMetadatas()
+            .get(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(idxMeta.getSettings()));
+        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
+        LifecycleExecutionState newLifecycleState = updateExecutionStateToStep(policyMetadata,
+            lifecycleState, newStepKey, nowSupplier, forcePhaseDefinitionRefresh);
+        ClusterState.Builder newClusterStateBuilder = newClusterStateWithLifecycleState(index, state, newLifecycleState);
+
+        return newClusterStateBuilder.build();
+    }
+
+    /**
+     * Moves the given index into the ERROR step. The ERROR step will have the same phase and
+     * action, but use the {@link ErrorStep#NAME} as the name in the lifecycle execution state.
+     */
+    static ClusterState moveClusterStateToErrorStep(Index index, ClusterState clusterState, Exception cause, LongSupplier nowSupplier,
+                                                    BiFunction<IndexMetaData, Step.StepKey, Step> stepLookupFunction) throws IOException {
+        IndexMetaData idxMeta = clusterState.getMetaData().index(index);
+        IndexLifecycleMetadata ilmMeta = clusterState.metaData().custom(IndexLifecycleMetadata.TYPE);
+        LifecyclePolicyMetadata policyMetadata = ilmMeta.getPolicyMetadatas()
+            .get(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(idxMeta.getSettings()));
+        XContentBuilder causeXContentBuilder = JsonXContent.contentBuilder();
+        causeXContentBuilder.startObject();
+        ElasticsearchException.generateThrowableXContent(causeXContentBuilder, STACKTRACE_PARAMS, cause);
+        causeXContentBuilder.endObject();
+        LifecycleExecutionState currentState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
+        Step.StepKey currentStep = Objects.requireNonNull(LifecycleExecutionState.getCurrentStepKey(currentState),
+            "unable to move to an error step where there is no current step, state: " + currentState);
+        LifecycleExecutionState nextStepState = updateExecutionStateToStep(policyMetadata, currentState,
+            new Step.StepKey(currentStep.getPhase(), currentStep.getAction(), ErrorStep.NAME), nowSupplier, false);
+
+        LifecycleExecutionState.Builder failedState = LifecycleExecutionState.builder(nextStepState);
+        failedState.setFailedStep(currentStep.getName());
+        failedState.setStepInfo(BytesReference.bytes(causeXContentBuilder).utf8ToString());
+        Step failedStep = stepLookupFunction.apply(idxMeta, currentStep);
+
+        if (failedStep != null) {
+            // as an initial step we'll mark the failed step as auto retryable without actually looking at the cause to determine
+            // if the error is transient/recoverable from
+            failedState.setIsAutoRetryableError(failedStep.isRetryable());
+            // maintain the retry count of the failed step as it will be cleared after a successful execution
+            failedState.setFailedStepRetryCount(currentState.getFailedStepRetryCount());
+        } else {
+            logger.warn("failed step [{}] for index [{}] is not part of policy [{}] anymore, or it is invalid",
+                currentStep.getName(), index, policyMetadata.getName());
+        }
+
+        ClusterState.Builder newClusterStateBuilder = newClusterStateWithLifecycleState(index, clusterState, failedState.build());
+        return newClusterStateBuilder.build();
+    }
+
+    /**
+     * Move the given index's execution state back to a step that had previously failed. If this is
+     * an automatic retry ({@code isAutomaticRetry}), the retry count is incremented.
+     */
+    static ClusterState moveClusterStateToPreviouslyFailedStep(ClusterState currentState, String index, LongSupplier nowSupplier,
+                                                               PolicyStepsRegistry stepRegistry, boolean isAutomaticRetry) {
+        ClusterState newState;
+        IndexMetaData indexMetaData = currentState.metaData().index(index);
+        if (indexMetaData == null) {
+            throw new IllegalArgumentException("index [" + index + "] does not exist");
+        }
+        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
+        Step.StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
+        String failedStep = lifecycleState.getFailedStep();
+        if (currentStepKey != null && ErrorStep.NAME.equals(currentStepKey.getName()) && Strings.isNullOrEmpty(failedStep) == false) {
+            Step.StepKey nextStepKey = new Step.StepKey(currentStepKey.getPhase(), currentStepKey.getAction(), failedStep);
+            IndexLifecycleTransition.validateTransition(indexMetaData, currentStepKey, nextStepKey, stepRegistry);
+            IndexLifecycleMetadata ilmMeta = currentState.metaData().custom(IndexLifecycleMetadata.TYPE);
+
+            LifecyclePolicyMetadata policyMetadata = ilmMeta.getPolicyMetadatas()
+                .get(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexMetaData.getSettings()));
+            LifecycleExecutionState nextStepState = IndexLifecycleTransition.updateExecutionStateToStep(policyMetadata,
+                lifecycleState, nextStepKey, nowSupplier, true);
+            LifecycleExecutionState.Builder retryStepState = LifecycleExecutionState.builder(nextStepState);
+            retryStepState.setIsAutoRetryableError(lifecycleState.isAutoRetryableError());
+            Integer currentRetryCount = lifecycleState.getFailedStepRetryCount();
+            if (isAutomaticRetry) {
+                retryStepState.setFailedStepRetryCount(currentRetryCount == null ? 1 : ++currentRetryCount);
+            } else {
+                // manual retries don't update the retry count
+                retryStepState.setFailedStepRetryCount(lifecycleState.getFailedStepRetryCount());
+            }
+            newState = IndexLifecycleTransition.newClusterStateWithLifecycleState(indexMetaData.getIndex(),
+                currentState, retryStepState.build()).build();
+        } else {
+            throw new IllegalArgumentException("cannot retry an action for an index ["
+                + index + "] that has not encountered an error when running a Lifecycle Policy");
+        }
+        return newState;
+    }
+
+    /**
+     * Given the existing execution state for an index, this updates pieces of the state with new
+     * timings and optionally the phase JSON (when transitioning to a different phase).
+     */
+    private static LifecycleExecutionState updateExecutionStateToStep(LifecyclePolicyMetadata policyMetadata,
+                                                                      LifecycleExecutionState existingState,
+                                                                      Step.StepKey newStep,
+                                                                      LongSupplier nowSupplier,
+                                                                      boolean forcePhaseDefinitionRefresh) {
+        Step.StepKey currentStep = LifecycleExecutionState.getCurrentStepKey(existingState);
+        long nowAsMillis = nowSupplier.getAsLong();
+        LifecycleExecutionState.Builder updatedState = LifecycleExecutionState.builder(existingState);
+        updatedState.setPhase(newStep.getPhase());
+        updatedState.setAction(newStep.getAction());
+        updatedState.setStep(newStep.getName());
+        updatedState.setStepTime(nowAsMillis);
+
+        // clear any step info or error-related settings from the current step
+        updatedState.setFailedStep(null);
+        updatedState.setStepInfo(null);
+        updatedState.setIsAutoRetryableError(null);
+        updatedState.setFailedStepRetryCount(null);
+
+        if (currentStep == null ||
+                currentStep.getPhase().equals(newStep.getPhase()) == false ||
+                forcePhaseDefinitionRefresh) {
+            final String newPhaseDefinition;
+            final Phase nextPhase;
+            if ("new".equals(newStep.getPhase()) || TerminalPolicyStep.KEY.equals(newStep)) {
+                nextPhase = null;
+            } else {
+                nextPhase = policyMetadata.getPolicy().getPhases().get(newStep.getPhase());
+            }
+            PhaseExecutionInfo phaseExecutionInfo = new PhaseExecutionInfo(policyMetadata.getName(), nextPhase,
+                policyMetadata.getVersion(), policyMetadata.getModifiedDate());
+            newPhaseDefinition = Strings.toString(phaseExecutionInfo, false, false);
+            updatedState.setPhaseDefinition(newPhaseDefinition);
+            updatedState.setPhaseTime(nowAsMillis);
+        } else if (currentStep.getPhase().equals(InitializePolicyContextStep.INITIALIZATION_PHASE)) {
+            // The "new" phase is the initialization phase, usually the phase
+            // time would be set on phase transition, but since there is no
+            // transition into the "new" phase, we set it any time in the "new"
+            // phase
+            updatedState.setPhaseTime(nowAsMillis);
+        }
+
+        if (currentStep == null || currentStep.getAction().equals(newStep.getAction()) == false) {
+            updatedState.setActionTime(nowAsMillis);
+        }
+        return updatedState.build();
+    }
+
+    /**
+     * Given a cluster state and lifecycle state, return a new state using the new lifecycle state for the given index.
+     */
+    private static ClusterState.Builder newClusterStateWithLifecycleState(Index index, ClusterState clusterState,
+                                                                          LifecycleExecutionState lifecycleState) {
+        ClusterState.Builder newClusterStateBuilder = ClusterState.builder(clusterState);
+        newClusterStateBuilder.metaData(MetaData.builder(clusterState.getMetaData())
+            .put(IndexMetaData.builder(clusterState.getMetaData().index(index))
+                .putCustom(ILM_CUSTOM_METADATA_KEY, lifecycleState.asMap())));
+        return newClusterStateBuilder;
+    }
+
+    /**
+     * Conditionally updates cluster state with new step info. The new cluster state is only
+     * built if the step info has changed, otherwise the same old <code>clusterState</code> is
+     * returned
+     *
+     * @param index        the index to modify
+     * @param clusterState the cluster state to modify
+     * @param stepInfo     the new step info to update
+     * @return Updated cluster state with <code>stepInfo</code> if changed, otherwise the same cluster state
+     * if no changes to step info exist
+     * @throws IOException if parsing step info fails
+     */
+    static ClusterState addStepInfoToClusterState(Index index, ClusterState clusterState, ToXContentObject stepInfo) throws IOException {
+        IndexMetaData indexMetaData = clusterState.getMetaData().index(index);
+        if (indexMetaData == null) {
+            // This index doesn't exist anymore, we can't do anything
+            return clusterState;
+        }
+        LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
+        final String stepInfoString;
+        try (XContentBuilder infoXContentBuilder = JsonXContent.contentBuilder()) {
+            stepInfo.toXContent(infoXContentBuilder, ToXContent.EMPTY_PARAMS);
+            stepInfoString = BytesReference.bytes(infoXContentBuilder).utf8ToString();
+        }
+        if (stepInfoString.equals(lifecycleState.getStepInfo())) {
+            return clusterState;
+        }
+        LifecycleExecutionState.Builder newState = LifecycleExecutionState.builder(lifecycleState);
+        newState.setStepInfo(stepInfoString);
+        ClusterState.Builder newClusterStateBuilder = newClusterStateWithLifecycleState(index, clusterState, newState.build());
+        return newClusterStateBuilder.build();
+    }
+
+    /**
+     * Remove the ILM policy from the given indices, this removes the lifecycle setting as well as
+     * any lifecycle execution state that may be present in the index metadata
+     */
+    public static ClusterState removePolicyForIndexes(final Index[] indices, ClusterState currentState, List<String> failedIndexes) {
+        MetaData.Builder newMetadata = MetaData.builder(currentState.getMetaData());
+        boolean clusterStateChanged = false;
+        for (Index index : indices) {
+            IndexMetaData indexMetadata = currentState.getMetaData().index(index);
+            if (indexMetadata == null) {
+                // Index doesn't exist so fail it
+                failedIndexes.add(index.getName());
+            } else {
+                IndexMetaData.Builder newIdxMetadata = removePolicyForIndex(indexMetadata);
+                if (newIdxMetadata != null) {
+                    newMetadata.put(newIdxMetadata);
+                    clusterStateChanged = true;
+                }
+            }
+        }
+        if (clusterStateChanged) {
+            ClusterState.Builder newClusterState = ClusterState.builder(currentState);
+            newClusterState.metaData(newMetadata);
+            return newClusterState.build();
+        } else {
+            return currentState;
+        }
+    }
+
+    /**
+     * Remove ILM-related metadata from an index's {@link IndexMetaData}
+     */
+    private static IndexMetaData.Builder removePolicyForIndex(IndexMetaData indexMetadata) {
+        Settings idxSettings = indexMetadata.getSettings();
+        Settings.Builder newSettings = Settings.builder().put(idxSettings);
+        boolean notChanged = true;
+
+        notChanged &= Strings.isNullOrEmpty(newSettings.remove(LifecycleSettings.LIFECYCLE_NAME_SETTING.getKey()));
+        notChanged &= Strings.isNullOrEmpty(newSettings.remove(LifecycleSettings.LIFECYCLE_INDEXING_COMPLETE_SETTING.getKey()));
+        notChanged &= Strings.isNullOrEmpty(newSettings.remove(RolloverAction.LIFECYCLE_ROLLOVER_ALIAS_SETTING.getKey()));
+        long newSettingsVersion = notChanged ? indexMetadata.getSettingsVersion() : 1 + indexMetadata.getSettingsVersion();
+
+        IndexMetaData.Builder builder = IndexMetaData.builder(indexMetadata);
+        builder.removeCustom(ILM_CUSTOM_METADATA_KEY);
+        return builder.settings(newSettings).settingsVersion(newSettingsVersion);
+    }
+}
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTask.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTask.java
index 12a5714372521..1b80e070c5552 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTask.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTask.java
@@ -63,9 +63,8 @@ public ClusterState execute(ClusterState currentState) throws IOException {
         Settings indexSettings = idxMeta.getSettings();
         LifecycleExecutionState indexILMData = LifecycleExecutionState.fromIndexMetadata(idxMeta);
         if (policy.equals(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexSettings))
-            && currentStepKey.equals(IndexLifecycleRunner.getCurrentStepKey(indexILMData))) {
-            return IndexLifecycleRunner.moveClusterStateToErrorStep(index, currentState, currentStepKey, cause, nowSupplier,
-                stepLookupFunction);
+            && currentStepKey.equals(LifecycleExecutionState.getCurrentStepKey(indexILMData))) {
+            return IndexLifecycleTransition.moveClusterStateToErrorStep(index, currentState, cause, nowSupplier, stepLookupFunction);
         } else {
             // either the policy has changed or the step is now
             // not the same as when we submitted the update task. In
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToNextStepUpdateTask.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToNextStepUpdateTask.java
index c433a04002a5c..9fae96c2f5ff1 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToNextStepUpdateTask.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToNextStepUpdateTask.java
@@ -28,15 +28,18 @@ public class MoveToNextStepUpdateTask extends ClusterStateUpdateTask {
     private final Step.StepKey currentStepKey;
     private final Step.StepKey nextStepKey;
     private final LongSupplier nowSupplier;
+    private final PolicyStepsRegistry stepRegistry;
     private final Consumer<ClusterState> stateChangeConsumer;
 
     public MoveToNextStepUpdateTask(Index index, String policy, Step.StepKey currentStepKey, Step.StepKey nextStepKey,
-                                    LongSupplier nowSupplier, Consumer<ClusterState> stateChangeConsumer) {
+                                    LongSupplier nowSupplier, PolicyStepsRegistry stepRegistry,
+                                    Consumer<ClusterState> stateChangeConsumer) {
         this.index = index;
         this.policy = policy;
         this.currentStepKey = currentStepKey;
         this.nextStepKey = nextStepKey;
         this.nowSupplier = nowSupplier;
+        this.stepRegistry = stepRegistry;
         this.stateChangeConsumer = stateChangeConsumer;
     }
 
@@ -66,9 +69,9 @@ public ClusterState execute(ClusterState currentState) {
         Settings indexSettings = indexMetaData.getSettings();
         LifecycleExecutionState indexILMData = LifecycleExecutionState.fromIndexMetadata(currentState.getMetaData().index(index));
         if (policy.equals(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexSettings))
-            && currentStepKey.equals(IndexLifecycleRunner.getCurrentStepKey(indexILMData))) {
+            && currentStepKey.equals(LifecycleExecutionState.getCurrentStepKey(indexILMData))) {
             logger.trace("moving [{}] to next step ({})", index.getName(), nextStepKey);
-            return IndexLifecycleRunner.moveClusterStateToNextStep(index, currentState, currentStepKey, nextStepKey, nowSupplier, false);
+            return IndexLifecycleTransition.moveClusterStateToStep(index, currentState, nextStepKey, nowSupplier, stepRegistry, false);
         } else {
             // either the policy has changed or the step is now
             // not the same as when we submitted the update task. In
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/SetStepInfoUpdateTask.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/SetStepInfoUpdateTask.java
index 2e1845ebe2c1a..20d11a098e8b9 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/SetStepInfoUpdateTask.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/SetStepInfoUpdateTask.java
@@ -60,8 +60,8 @@ public ClusterState execute(ClusterState currentState) throws IOException {
         Settings indexSettings = idxMeta.getSettings();
         LifecycleExecutionState indexILMData = LifecycleExecutionState.fromIndexMetadata(idxMeta);
         if (policy.equals(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexSettings))
-                && Objects.equals(currentStepKey, IndexLifecycleRunner.getCurrentStepKey(indexILMData))) {
-            return IndexLifecycleRunner.addStepInfoToClusterState(index, currentState, stepInfo);
+                && Objects.equals(currentStepKey, LifecycleExecutionState.getCurrentStepKey(indexILMData))) {
+            return IndexLifecycleTransition.addStepInfoToClusterState(index, currentState, stepInfo);
         } else {
             // either the policy has changed or the step is now
             // not the same as when we submitted the update task. In
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportMoveToStepAction.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportMoveToStepAction.java
index 9958fba2b90d0..9e0e68cd1e267 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportMoveToStepAction.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportMoveToStepAction.java
@@ -64,7 +64,7 @@ protected void masterOperation(Task task, Request request, ClusterState state, A
             new AckedClusterStateUpdateTask<Response>(request, listener) {
                 @Override
                 public ClusterState execute(ClusterState currentState) {
-                    return indexLifecycleService.moveClusterStateToStep(currentState, request.getIndex(), request.getCurrentStepKey(),
+                    return indexLifecycleService.moveClusterStateToStep(currentState, indexMetaData.getIndex(), request.getCurrentStepKey(),
                         request.getNextStepKey());
                 }
 
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportRemoveIndexLifecyclePolicyAction.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportRemoveIndexLifecyclePolicyAction.java
index 335710660ed6f..45be96b5528e6 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportRemoveIndexLifecyclePolicyAction.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportRemoveIndexLifecyclePolicyAction.java
@@ -24,7 +24,7 @@
 import org.elasticsearch.xpack.core.ilm.action.RemoveIndexLifecyclePolicyAction;
 import org.elasticsearch.xpack.core.ilm.action.RemoveIndexLifecyclePolicyAction.Request;
 import org.elasticsearch.xpack.core.ilm.action.RemoveIndexLifecyclePolicyAction.Response;
-import org.elasticsearch.xpack.ilm.IndexLifecycleRunner;
+import org.elasticsearch.xpack.ilm.IndexLifecycleTransition;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -65,7 +65,7 @@ protected void masterOperation(Task task, Request request, ClusterState state, A
 
                     @Override
                     public ClusterState execute(ClusterState currentState) throws Exception {
-                        return IndexLifecycleRunner.removePolicyForIndexes(indices, currentState, failedIndexes);
+                        return IndexLifecycleTransition.removePolicyForIndexes(indices, currentState, failedIndexes);
                     }
 
                     @Override
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTaskTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTaskTests.java
index 9a22bc59fda75..8678c0d1a13cc 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTaskTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTaskTests.java
@@ -158,7 +158,7 @@ public void testSuccessThenFailureUnsetNextKey() throws IOException {
         ExecuteStepsUpdateTask task = new ExecuteStepsUpdateTask(mixedPolicyName, index, startStep, policyStepsRegistry, null, () -> now);
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey currentStepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(currentStepKey, equalTo(secondStepKey));
         assertThat(firstStep.getExecuteCount(), equalTo(1L));
         assertThat(secondStep.getExecuteCount(), equalTo(1L));
@@ -175,7 +175,7 @@ public void testExecuteUntilFirstNonClusterStateStep() throws IOException {
         ExecuteStepsUpdateTask task = new ExecuteStepsUpdateTask(mixedPolicyName, index, startStep, policyStepsRegistry, null, () -> now);
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey currentStepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(currentStepKey, equalTo(thirdStepKey));
         assertThat(firstStep.getExecuteCount(), equalTo(0L));
         assertThat(secondStep.getExecuteCount(), equalTo(1L));
@@ -214,7 +214,7 @@ public void testExecuteIncompleteWaitStepNoInfo() throws IOException {
         ExecuteStepsUpdateTask task = new ExecuteStepsUpdateTask(mixedPolicyName, index, startStep, policyStepsRegistry, null, () -> now);
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey currentStepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(currentStepKey, equalTo(secondStepKey));
         assertThat(firstStep.getExecuteCount(), equalTo(0L));
         assertThat(secondStep.getExecuteCount(), equalTo(1L));
@@ -233,7 +233,7 @@ public void testExecuteIncompleteWaitStepWithInfo() throws IOException {
         ExecuteStepsUpdateTask task = new ExecuteStepsUpdateTask(mixedPolicyName, index, startStep, policyStepsRegistry, null, () -> now);
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey currentStepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(currentStepKey, equalTo(secondStepKey));
         assertThat(firstStep.getExecuteCount(), equalTo(0L));
         assertThat(secondStep.getExecuteCount(), equalTo(1L));
@@ -264,7 +264,7 @@ public void testClusterActionStepThrowsException() throws IOException {
         ExecuteStepsUpdateTask task = new ExecuteStepsUpdateTask(mixedPolicyName, index, startStep, policyStepsRegistry, null, () -> now);
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey currentStepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(currentStepKey, equalTo(new StepKey(firstStepKey.getPhase(), firstStepKey.getAction(), ErrorStep.NAME)));
         assertThat(firstStep.getExecuteCount(), equalTo(1L));
         assertThat(secondStep.getExecuteCount(), equalTo(0L));
@@ -284,7 +284,7 @@ public void testClusterWaitStepThrowsException() throws IOException {
         ExecuteStepsUpdateTask task = new ExecuteStepsUpdateTask(mixedPolicyName, index, startStep, policyStepsRegistry, null, () -> now);
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey currentStepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(currentStepKey, equalTo(new StepKey(firstStepKey.getPhase(), firstStepKey.getAction(), ErrorStep.NAME)));
         assertThat(firstStep.getExecuteCount(), equalTo(1L));
         assertThat(secondStep.getExecuteCount(), equalTo(1L));
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
index 20d1a0aed726a..2580e2970e521 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
@@ -5,7 +5,8 @@
  */
 package org.elasticsearch.xpack.ilm;
 
-import org.elasticsearch.ElasticsearchException;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.Version;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.ClusterName;
@@ -19,7 +20,6 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.settings.Settings.Builder;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.ToXContent;
@@ -32,7 +32,6 @@
 import org.elasticsearch.test.client.NoOpClient;
 import org.elasticsearch.threadpool.TestThreadPool;
 import org.elasticsearch.threadpool.ThreadPool;
-import org.elasticsearch.xpack.core.ilm.AbstractStepTestCase;
 import org.elasticsearch.xpack.core.ilm.AsyncActionStep;
 import org.elasticsearch.xpack.core.ilm.AsyncWaitStep;
 import org.elasticsearch.xpack.core.ilm.ClusterStateActionStep;
@@ -63,6 +62,7 @@
 
 import java.io.IOException;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
@@ -75,8 +75,6 @@
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicLong;
 import java.util.function.BiFunction;
-import java.util.function.Function;
-import java.util.stream.Collectors;
 
 import static java.util.stream.Collectors.toList;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.awaitLatch;
@@ -85,7 +83,6 @@
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
-import static org.hamcrest.Matchers.nullValue;
 import static org.mockito.Matchers.any;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.times;
@@ -112,55 +109,6 @@ public void shutdown() {
         threadPool.shutdownNow();
     }
 
-    /** A real policy steps registry where getStep can be overridden so that JSON doesn't have to be parsed */
-    private class MockPolicyStepsRegistry extends PolicyStepsRegistry {
-        private BiFunction<IndexMetaData, StepKey, Step> fn = null;
-
-        MockPolicyStepsRegistry(SortedMap<String, LifecyclePolicyMetadata> lifecyclePolicyMap, Map<String, Step> firstStepMap,
-                                Map<String, Map<StepKey, Step>> stepMap, NamedXContentRegistry xContentRegistry, Client client) {
-            super(lifecyclePolicyMap, firstStepMap, stepMap, xContentRegistry, client);
-        }
-
-        public void setResolver(BiFunction<IndexMetaData, StepKey, Step> fn) {
-            this.fn = fn;
-        }
-
-        @Override
-        public Step getStep(IndexMetaData indexMetaData, StepKey stepKey) {
-            if (fn == null) {
-                logger.info("--> retrieving step {}", stepKey);
-                return super.getStep(indexMetaData, stepKey);
-            } else {
-                logger.info("--> returning mock step");
-                return fn.apply(indexMetaData, stepKey);
-            }
-        }
-    }
-
-    private MockPolicyStepsRegistry createOneStepPolicyStepRegistry(String policyName, Step step) {
-        return createOneStepPolicyStepRegistry(policyName, step, "test");
-    }
-
-    private MockPolicyStepsRegistry createOneStepPolicyStepRegistry(String policyName, Step step, String indexName) {
-        LifecyclePolicy policy = new LifecyclePolicy(policyName, new HashMap<>());
-        SortedMap<String, LifecyclePolicyMetadata> lifecyclePolicyMap = new TreeMap<>();
-        lifecyclePolicyMap.put(policyName, new LifecyclePolicyMetadata(policy, new HashMap<>(), 1, 1));
-        Map<String, Step> firstStepMap = new HashMap<>();
-        firstStepMap.put(policyName, step);
-        Map<String, Map<StepKey, Step>> stepMap = new HashMap<>();
-        Map<StepKey, Step> policySteps = new HashMap<>();
-        policySteps.put(step.getKey(), step);
-        stepMap.put(policyName, policySteps);
-        Map<Index, List<Step>> indexSteps = new HashMap<>();
-        List<Step> steps = new ArrayList<>();
-        steps.add(step);
-        Index index = new Index(indexName, indexName + "uuid");
-        indexSteps.put(index, steps);
-        Client client = mock(Client.class);
-        when(client.settings()).thenReturn(Settings.EMPTY);
-        return new MockPolicyStepsRegistry(lifecyclePolicyMap, firstStepMap, stepMap, REGISTRY, client);
-    }
-
     public void testRunPolicyTerminalPolicyStep() {
         String policyName = "async_action_policy";
         TerminalPolicyStep step = TerminalPolicyStep.INSTANCE;
@@ -295,7 +243,7 @@ public void testRunStateChangePolicyWithNextStep() throws Exception {
         StepKey nextStepKey = new StepKey("phase", "action", "next_cluster_state_action_step");
         MockClusterStateActionStep step = new MockClusterStateActionStep(stepKey, nextStepKey);
         MockClusterStateActionStep nextStep = new MockClusterStateActionStep(nextStepKey, null);
-        MockPolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
+        MockPolicyStepsRegistry stepRegistry = createMultiStepPolicyStepRegistry(policyName, Arrays.asList(step, nextStep));
         stepRegistry.setResolver((i, k) -> {
             if (stepKey.equals(k)) {
                 return step;
@@ -481,7 +429,7 @@ public void testRunStateChangePolicyWithAsyncActionNextStep() throws Exception {
         StepKey nextStepKey = new StepKey("phase", "action", "async_action_step");
         MockClusterStateActionStep step = new MockClusterStateActionStep(stepKey, nextStepKey);
         MockAsyncActionStep nextStep = new MockAsyncActionStep(nextStepKey, null);
-        MockPolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
+        MockPolicyStepsRegistry stepRegistry = createMultiStepPolicyStepRegistry(policyName, Arrays.asList(step, nextStep));
         stepRegistry.setResolver((i, k) -> {
             if (stepKey.equals(k)) {
                 return step;
@@ -696,65 +644,6 @@ public void testRunPolicyThatDoesntExist() {
         Mockito.verifyNoMoreInteractions(clusterService);
     }
 
-    public void testGetCurrentStepKey() {
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        StepKey stepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState.build());
-        assertNull(stepKey);
-
-        String phase = randomAlphaOfLength(20);
-        String action = randomAlphaOfLength(20);
-        String step = randomAlphaOfLength(20);
-        LifecycleExecutionState.Builder lifecycleState2 = LifecycleExecutionState.builder();
-        lifecycleState2.setPhase(phase);
-        lifecycleState2.setAction(action);
-        lifecycleState2.setStep(step);
-        stepKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState2.build());
-        assertNotNull(stepKey);
-        assertEquals(phase, stepKey.getPhase());
-        assertEquals(action, stepKey.getAction());
-        assertEquals(step, stepKey.getName());
-
-        phase = randomAlphaOfLength(20);
-        action = randomAlphaOfLength(20);
-        step = null;
-        LifecycleExecutionState.Builder lifecycleState3 = LifecycleExecutionState.builder();
-        lifecycleState3.setPhase(phase);
-        lifecycleState3.setAction(action);
-        lifecycleState3.setStep(step);
-        AssertionError error3 = expectThrows(AssertionError.class, () -> IndexLifecycleRunner.getCurrentStepKey(lifecycleState3.build()));
-        assertEquals("Current phase is not empty: " + phase, error3.getMessage());
-
-        phase = null;
-        action = randomAlphaOfLength(20);
-        step = null;
-        LifecycleExecutionState.Builder lifecycleState4 = LifecycleExecutionState.builder();
-        lifecycleState4.setPhase(phase);
-        lifecycleState4.setAction(action);
-        lifecycleState4.setStep(step);
-        AssertionError error4 = expectThrows(AssertionError.class, () -> IndexLifecycleRunner.getCurrentStepKey(lifecycleState4.build()));
-        assertEquals("Current action is not empty: " + action, error4.getMessage());
-
-        phase = null;
-        action = randomAlphaOfLength(20);
-        step = randomAlphaOfLength(20);
-        LifecycleExecutionState.Builder lifecycleState5 = LifecycleExecutionState.builder();
-        lifecycleState5.setPhase(phase);
-        lifecycleState5.setAction(action);
-        lifecycleState5.setStep(step);
-        AssertionError error5 = expectThrows(AssertionError.class, () -> IndexLifecycleRunner.getCurrentStepKey(lifecycleState5.build()));
-        assertEquals(null, error5.getMessage());
-
-        phase = null;
-        action = null;
-        step = randomAlphaOfLength(20);
-        LifecycleExecutionState.Builder lifecycleState6 = LifecycleExecutionState.builder();
-        lifecycleState6.setPhase(phase);
-        lifecycleState6.setAction(action);
-        lifecycleState6.setStep(step);
-        AssertionError error6 = expectThrows(AssertionError.class, () -> IndexLifecycleRunner.getCurrentStepKey(lifecycleState6.build()));
-        assertEquals(null, error6.getMessage());
-    }
-
     public void testGetCurrentStep() {
         String policyName = "policy";
         StepKey firstStepKey = new StepKey("phase_1", "action_1", "step_1");
@@ -796,561 +685,18 @@ public void testGetCurrentStep() {
         PolicyStepsRegistry registry = new PolicyStepsRegistry(metas, firstStepMap, stepMap, REGISTRY, client);
 
         // First step is retrieved because there are no settings for the index
-        Step stepFromNoSettings = IndexLifecycleRunner.getCurrentStep(registry, policy.getName(), indexMetaData,
-            LifecycleExecutionState.builder().build());
+        IndexMetaData indexMetaDataWithNoKey = IndexMetaData.builder(index.getName())
+            .settings(indexSettings)
+            .putCustom(ILM_CUSTOM_METADATA_KEY, LifecycleExecutionState.builder().build().asMap())
+            .build();
+        Step stepFromNoSettings = IndexLifecycleRunner.getCurrentStep(registry, policy.getName(), indexMetaDataWithNoKey);
         assertEquals(firstStep, stepFromNoSettings);
 
         // The step that was written into the metadata is retrieved
-        Step currentStep = IndexLifecycleRunner.getCurrentStep(registry, policy.getName(), indexMetaData, lifecycleState.build());
+        Step currentStep = IndexLifecycleRunner.getCurrentStep(registry, policy.getName(), indexMetaData);
         assertEquals(step.getKey(), currentStep.getKey());
     }
 
-    public void testMoveClusterStateToNextStep() {
-        String indexName = "my_index";
-        LifecyclePolicy policy = randomValueOtherThanMany(p -> p.getPhases().size() == 0,
-            () -> LifecyclePolicyTests.randomTestLifecyclePolicy("policy"));
-        Phase nextPhase = policy.getPhases().values().stream().findFirst().get();
-        List<LifecyclePolicyMetadata> policyMetadatas = Collections.singletonList(
-            new LifecyclePolicyMetadata(policy, Collections.emptyMap(), randomNonNegativeLong(), randomNonNegativeLong()));
-        StepKey currentStep = new StepKey("current_phase", "current_action", "current_step");
-        StepKey nextStep = new StepKey(nextPhase.getName(), "next_action", "next_step");
-        long now = randomNonNegativeLong();
-
-        // test going from null lifecycle settings to next step
-        ClusterState clusterState = buildClusterState(indexName,
-            Settings.builder()
-                .put(LifecycleSettings.LIFECYCLE_NAME, policy.getName()), LifecycleExecutionState.builder().build(), policyMetadatas);
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        ClusterState newClusterState = IndexLifecycleRunner.moveClusterStateToNextStep(index, clusterState, currentStep, nextStep,
-                () -> now, false);
-        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
-
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        // test going from set currentStep settings to nextStep
-        Builder indexSettingsBuilder = Settings.builder()
-            .put(LifecycleSettings.LIFECYCLE_NAME, policy.getName());
-        if (randomBoolean()) {
-            lifecycleState.setStepInfo(randomAlphaOfLength(20));
-        }
-
-        clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
-        index = clusterState.metaData().index(indexName).getIndex();
-        newClusterState = IndexLifecycleRunner.moveClusterStateToNextStep(index, clusterState, currentStep, nextStep, () -> now, false);
-        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
-    }
-
-    public void testMoveClusterStateToNextStepSamePhase() {
-        String indexName = "my_index";
-        StepKey currentStep = new StepKey("current_phase", "current_action", "current_step");
-        StepKey nextStep = new StepKey("current_phase", "next_action", "next_step");
-        long now = randomNonNegativeLong();
-
-        ClusterState clusterState = buildClusterState(indexName, Settings.builder(), LifecycleExecutionState.builder().build(),
-            Collections.emptyList());
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        ClusterState newClusterState = IndexLifecycleRunner.moveClusterStateToNextStep(index, clusterState, currentStep, nextStep,
-                () -> now, false);
-        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
-
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        if (randomBoolean()) {
-            lifecycleState.setStepInfo(randomAlphaOfLength(20));
-        }
-
-        clusterState = buildClusterState(indexName, Settings.builder(), lifecycleState.build(), Collections.emptyList());
-        index = clusterState.metaData().index(indexName).getIndex();
-        newClusterState = IndexLifecycleRunner.moveClusterStateToNextStep(index, clusterState, currentStep, nextStep, () -> now, false);
-        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
-    }
-
-    public void testMoveClusterStateToNextStepSameAction() {
-        String indexName = "my_index";
-        StepKey currentStep = new StepKey("current_phase", "current_action", "current_step");
-        StepKey nextStep = new StepKey("current_phase", "current_action", "next_step");
-        long now = randomNonNegativeLong();
-
-        ClusterState clusterState = buildClusterState(indexName, Settings.builder(), LifecycleExecutionState.builder().build(),
-            Collections.emptyList());
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        ClusterState newClusterState = IndexLifecycleRunner.moveClusterStateToNextStep(index, clusterState, currentStep, nextStep,
-                () -> now, false);
-        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
-
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        if (randomBoolean()) {
-            lifecycleState.setStepInfo(randomAlphaOfLength(20));
-        }
-        clusterState = buildClusterState(indexName, Settings.builder(), lifecycleState.build(), Collections.emptyList());
-        index = clusterState.metaData().index(indexName).getIndex();
-        newClusterState = IndexLifecycleRunner.moveClusterStateToNextStep(index, clusterState, currentStep, nextStep, () -> now, false);
-        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
-    }
-
-    public void testSuccessfulValidatedMoveClusterStateToNextStep() {
-        String indexName = "my_index";
-        String policyName = "my_policy";
-        LifecyclePolicy policy = randomValueOtherThanMany(p -> p.getPhases().size() == 0,
-            () -> LifecyclePolicyTests.randomTestLifecyclePolicy(policyName));
-        Phase nextPhase = policy.getPhases().values().stream().findFirst().get();
-        List<LifecyclePolicyMetadata> policyMetadatas = Collections.singletonList(
-            new LifecyclePolicyMetadata(policy, Collections.emptyMap(), randomNonNegativeLong(), randomNonNegativeLong()));
-        StepKey currentStepKey = new StepKey("current_phase", "current_action", "current_step");
-        StepKey nextStepKey = new StepKey(nextPhase.getName(), "next_action", "next_step");
-        long now = randomNonNegativeLong();
-        Step step = new MockStep(nextStepKey, nextStepKey);
-        PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step, indexName);
-
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStepKey.getPhase());
-        lifecycleState.setAction(currentStepKey.getAction());
-        lifecycleState.setStep(currentStepKey.getName());
-
-        Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, policyName);
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        ClusterState newClusterState = IndexLifecycleRunner.moveClusterStateToStep(indexName, clusterState, currentStepKey,
-            nextStepKey, () -> now, stepRegistry);
-        assertClusterStateOnNextStep(clusterState, index, currentStepKey, nextStepKey, newClusterState, now);
-    }
-
-    public void testValidatedMoveClusterStateToNextStepWithoutPolicy() {
-        String indexName = "my_index";
-        String policyName = "policy";
-        StepKey currentStepKey = new StepKey("current_phase", "current_action", "current_step");
-        StepKey nextStepKey = new StepKey("next_phase", "next_action", "next_step");
-        long now = randomNonNegativeLong();
-        Step step = new MockStep(nextStepKey, nextStepKey);
-        PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
-
-        Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, randomBoolean() ? "" : null);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStepKey.getPhase());
-        lifecycleState.setAction(currentStepKey.getAction());
-        lifecycleState.setStep(currentStepKey.getName());
-
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
-        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
-            () -> IndexLifecycleRunner.moveClusterStateToStep(indexName, clusterState, currentStepKey,
-                nextStepKey, () -> now, stepRegistry));
-        assertThat(exception.getMessage(), equalTo("index [my_index] is not associated with an Index Lifecycle Policy"));
-    }
-
-    public void testValidatedMoveClusterStateToNextStepInvalidCurrentStep() {
-        String indexName = "my_index";
-        String policyName = "my_policy";
-        StepKey currentStepKey = new StepKey("current_phase", "current_action", "current_step");
-        StepKey notCurrentStepKey = new StepKey("not_current_phase", "not_current_action", "not_current_step");
-        StepKey nextStepKey = new StepKey("next_phase", "next_action", "next_step");
-        long now = randomNonNegativeLong();
-        Step step = new MockStep(nextStepKey, nextStepKey);
-        PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
-
-        Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, policyName);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStepKey.getPhase());
-        lifecycleState.setAction(currentStepKey.getAction());
-        lifecycleState.setStep(currentStepKey.getName());
-
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
-        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
-            () -> IndexLifecycleRunner.moveClusterStateToStep(indexName, clusterState, notCurrentStepKey,
-                nextStepKey, () -> now, stepRegistry));
-        assertThat(exception.getMessage(), equalTo("index [my_index] is not on current step " +
-            "[{\"phase\":\"not_current_phase\",\"action\":\"not_current_action\",\"name\":\"not_current_step\"}]"));
-    }
-
-    public void testValidatedMoveClusterStateToNextStepInvalidNextStep() {
-        String indexName = "my_index";
-        String policyName = "my_policy";
-        StepKey currentStepKey = new StepKey("current_phase", "current_action", "current_step");
-        StepKey nextStepKey = new StepKey("next_phase", "next_action", "next_step");
-        long now = randomNonNegativeLong();
-        Step step = new MockStep(currentStepKey, nextStepKey);
-        PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
-
-        Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, policyName);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStepKey.getPhase());
-        lifecycleState.setAction(currentStepKey.getAction());
-        lifecycleState.setStep(currentStepKey.getName());
-
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
-        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
-            () -> IndexLifecycleRunner.moveClusterStateToStep(indexName, clusterState, currentStepKey,
-                nextStepKey, () -> now, stepRegistry));
-        assertThat(exception.getMessage(),
-            equalTo("step [{\"phase\":\"next_phase\",\"action\":\"next_action\",\"name\":\"next_step\"}] " +
-                "for index [my_index] with policy [my_policy] does not exist"));
-    }
-
-    public void testMoveClusterStateToErrorStep() throws IOException {
-        String indexName = "my_index";
-        StepKey currentStep = new StepKey("current_phase", "current_action", "current_step");
-        StepKey nextStepKey = new StepKey("next_phase", "next_action", "next_step");
-        long now = randomNonNegativeLong();
-        Exception cause = new ElasticsearchException("THIS IS AN EXPECTED CAUSE");
-
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        ClusterState clusterState = buildClusterState(indexName, Settings.builder(), lifecycleState.build(), Collections.emptyList());
-        Index index = clusterState.metaData().index(indexName).getIndex();
-
-        ClusterState newClusterState = IndexLifecycleRunner.moveClusterStateToErrorStep(index, clusterState, currentStep, cause, () -> now,
-            (idxMeta, stepKey) -> new MockStep(stepKey, nextStepKey));
-        assertClusterStateOnErrorStep(clusterState, index, currentStep, newClusterState, now,
-            "{\"type\":\"exception\",\"reason\":\"THIS IS AN EXPECTED CAUSE\"");
-
-        cause = new IllegalArgumentException("non elasticsearch-exception");
-        newClusterState = IndexLifecycleRunner.moveClusterStateToErrorStep(index, clusterState, currentStep, cause, () -> now,
-            (idxMeta, stepKey) -> new MockStep(stepKey, nextStepKey));
-        assertClusterStateOnErrorStep(clusterState, index, currentStep, newClusterState, now,
-            "{\"type\":\"illegal_argument_exception\",\"reason\":\"non elasticsearch-exception\",\"stack_trace\":\"");
-    }
-
-    public void testMoveClusterStateToFailedStep() {
-        String indexName = "my_index";
-        String[] indices = new String[] { indexName };
-        String policyName = "my_policy";
-        long now = randomNonNegativeLong();
-        StepKey failedStepKey = new StepKey("current_phase", MockAction.NAME, "current_step");
-        StepKey errorStepKey = new StepKey(failedStepKey.getPhase(), failedStepKey.getAction(), ErrorStep.NAME);
-        Step step = new MockStep(failedStepKey, null);
-        LifecyclePolicy policy = createPolicy(policyName, failedStepKey, null);
-        LifecyclePolicyMetadata policyMetadata = new LifecyclePolicyMetadata(policy, Collections.emptyMap(),
-            randomNonNegativeLong(), randomNonNegativeLong());
-
-        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, step, indexName);
-        Settings.Builder indexSettingsBuilder = Settings.builder()
-                .put(LifecycleSettings.LIFECYCLE_NAME, policyName);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(errorStepKey.getPhase());
-        lifecycleState.setPhaseTime(now);
-        lifecycleState.setAction(errorStepKey.getAction());
-        lifecycleState.setActionTime(now);
-        lifecycleState.setStep(errorStepKey.getName());
-        lifecycleState.setStepTime(now);
-        lifecycleState.setFailedStep(failedStepKey.getName());
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(),
-            Collections.singletonList(policyMetadata));
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(policyRegistry, null, threadPool, () -> now);
-        ClusterState nextClusterState = runner.moveClusterStateToPreviouslyFailedStep(clusterState, indices);
-        IndexLifecycleRunnerTests.assertClusterStateOnNextStep(clusterState, index, errorStepKey, failedStepKey,
-            nextClusterState, now);
-        LifecycleExecutionState executionState = LifecycleExecutionState.fromIndexMetadata(nextClusterState.metaData().index(indexName));
-        assertThat("manual move to failed step should not count as a retry", executionState.getFailedStepRetryCount(), is(nullValue()));
-    }
-
-    public void testMoveClusterStateToFailedStepWithUnknownStep() {
-        String indexName = "my_index";
-        String[] indices = new String[] { indexName };
-        String policyName = "my_policy";
-        long now = randomNonNegativeLong();
-        StepKey failedStepKey = new StepKey("current_phase", MockAction.NAME, "current_step");
-        StepKey errorStepKey = new StepKey(failedStepKey.getPhase(), failedStepKey.getAction(), ErrorStep.NAME);
-
-        StepKey registeredStepKey = new StepKey(randomFrom(failedStepKey.getPhase(), "other"),
-            MockAction.NAME, "different_step");
-        Step step = new MockStep(registeredStepKey, null);
-        LifecyclePolicy policy = createPolicy(policyName, failedStepKey, null);
-        LifecyclePolicyMetadata policyMetadata = new LifecyclePolicyMetadata(policy, Collections.emptyMap(),
-            randomNonNegativeLong(), randomNonNegativeLong());
-
-        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, step, indexName);
-        Settings.Builder indexSettingsBuilder = Settings.builder()
-            .put(LifecycleSettings.LIFECYCLE_NAME, policyName);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(errorStepKey.getPhase());
-        lifecycleState.setPhaseTime(now);
-        lifecycleState.setAction(errorStepKey.getAction());
-        lifecycleState.setActionTime(now);
-        lifecycleState.setStep(errorStepKey.getName());
-        lifecycleState.setStepTime(now);
-        lifecycleState.setFailedStep(failedStepKey.getName());
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(),
-            Collections.singletonList(policyMetadata));
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(policyRegistry, null, threadPool, () -> now);
-        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
-            () -> runner.moveClusterStateToPreviouslyFailedStep(clusterState, indices));
-        assertThat(exception.getMessage(), equalTo("step [" + failedStepKey
-            + "] for index [my_index] with policy [my_policy] does not exist"));
-    }
-
-    public void testMoveClusterStateToFailedStepIndexNotFound() {
-        String existingIndexName = "my_index";
-        String invalidIndexName = "does_not_exist";
-        ClusterState clusterState = buildClusterState(existingIndexName, Settings.builder(), LifecycleExecutionState.builder().build(),
-            Collections.emptyList());
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(null, null, threadPool, () -> 0L);
-        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
-            () -> runner.moveClusterStateToPreviouslyFailedStep(clusterState, new String[] { invalidIndexName }));
-        assertThat(exception.getMessage(), equalTo("index [" + invalidIndexName + "] does not exist"));
-    }
-
-    public void testMoveClusterStateToFailedStepInvalidPolicySetting() {
-        String indexName = "my_index";
-        String[] indices = new String[] { indexName };
-        String policyName = "my_policy";
-        long now = randomNonNegativeLong();
-        StepKey failedStepKey = new StepKey("current_phase", "current_action", "current_step");
-        StepKey errorStepKey = new StepKey(failedStepKey.getPhase(), failedStepKey.getAction(), ErrorStep.NAME);
-        Step step = new MockStep(failedStepKey, null);
-        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, step);
-        Settings.Builder indexSettingsBuilder = Settings.builder()
-            .put(LifecycleSettings.LIFECYCLE_NAME, (String) null);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(errorStepKey.getPhase());
-        lifecycleState.setAction(errorStepKey.getAction());
-        lifecycleState.setStep(errorStepKey.getName());
-        lifecycleState.setFailedStep(failedStepKey.getName());
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(policyRegistry, null, threadPool, () -> now);
-        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
-            () -> runner.moveClusterStateToPreviouslyFailedStep(clusterState, indices));
-        assertThat(exception.getMessage(), equalTo("index [" + indexName + "] is not associated with an Index Lifecycle Policy"));
-    }
-
-    public void testMoveClusterStateToFailedNotOnError() {
-        String indexName = "my_index";
-        String[] indices = new String[] { indexName };
-        String policyName = "my_policy";
-        long now = randomNonNegativeLong();
-        StepKey failedStepKey = new StepKey("current_phase", "current_action", "current_step");
-        Step step = new MockStep(failedStepKey, null);
-        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, step);
-        Settings.Builder indexSettingsBuilder = Settings.builder()
-            .put(LifecycleSettings.LIFECYCLE_NAME, (String) null);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(failedStepKey.getPhase());
-        lifecycleState.setAction(failedStepKey.getAction());
-        lifecycleState.setStep(failedStepKey.getName());
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(policyRegistry, null, threadPool, () -> now);
-        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
-            () -> runner.moveClusterStateToPreviouslyFailedStep(clusterState, indices));
-        assertThat(exception.getMessage(), equalTo("cannot retry an action for an index [" + indices[0]
-            + "] that has not encountered an error when running a Lifecycle Policy"));
-    }
-
-    public void testMoveClusterStateToPreviouslyFailedStepAsAutomaticRetry() {
-        String indexName = "my_index";
-        String policyName = "my_policy";
-        long now = randomNonNegativeLong();
-        StepKey failedStepKey = new StepKey("current_phase", MockAction.NAME, "current_step");
-        StepKey errorStepKey = new StepKey(failedStepKey.getPhase(), failedStepKey.getAction(), ErrorStep.NAME);
-        Step retryableStep = new RetryableMockStep(failedStepKey, null);
-        LifecyclePolicy policy = createPolicy(policyName, failedStepKey, null);
-        LifecyclePolicyMetadata policyMetadata = new LifecyclePolicyMetadata(policy, Collections.emptyMap(),
-            randomNonNegativeLong(), randomNonNegativeLong());
-
-        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, retryableStep, indexName);
-        Settings.Builder indexSettingsBuilder = Settings.builder()
-                .put(LifecycleSettings.LIFECYCLE_NAME, policyName);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(errorStepKey.getPhase());
-        lifecycleState.setPhaseTime(now);
-        lifecycleState.setAction(errorStepKey.getAction());
-        lifecycleState.setActionTime(now);
-        lifecycleState.setStep(errorStepKey.getName());
-        lifecycleState.setStepTime(now);
-        lifecycleState.setFailedStep(failedStepKey.getName());
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(),
-            Collections.singletonList(policyMetadata));
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(policyRegistry, null, threadPool, () -> now);
-        ClusterState nextClusterState = runner.moveClusterStateToPreviouslyFailedStep(clusterState, indexName, true);
-        IndexLifecycleRunnerTests.assertClusterStateOnNextStep(clusterState, index, errorStepKey, failedStepKey,
-            nextClusterState, now);
-        LifecycleExecutionState executionState = LifecycleExecutionState.fromIndexMetadata(nextClusterState.metaData().index(indexName));
-        assertThat(executionState.getFailedStepRetryCount(), is(1));
-    }
-
-    public void testAddStepInfoToClusterState() throws IOException {
-        String indexName = "my_index";
-        StepKey currentStep = new StepKey("current_phase", "current_action", "current_step");
-        RandomStepInfo stepInfo = new RandomStepInfo(() -> randomAlphaOfLength(10));
-
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        ClusterState clusterState = buildClusterState(indexName, Settings.builder(), lifecycleState.build(), Collections.emptyList());
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        ClusterState newClusterState = IndexLifecycleRunner.addStepInfoToClusterState(index, clusterState, stepInfo);
-        assertClusterStateStepInfo(clusterState, index, currentStep, newClusterState, stepInfo);
-        ClusterState runAgainClusterState = IndexLifecycleRunner.addStepInfoToClusterState(index, newClusterState, stepInfo);
-        assertSame(newClusterState, runAgainClusterState);
-    }
-
-    private ClusterState buildClusterState(String indexName, Settings.Builder indexSettingsBuilder,
-                                           LifecycleExecutionState lifecycleState,
-                                           List<LifecyclePolicyMetadata> lifecyclePolicyMetadatas) {
-        Settings indexSettings = indexSettingsBuilder.put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0).put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT).build();
-        IndexMetaData indexMetadata = IndexMetaData.builder(indexName)
-            .settings(indexSettings)
-            .putCustom(ILM_CUSTOM_METADATA_KEY, lifecycleState.asMap())
-            .build();
-
-        Map<String, LifecyclePolicyMetadata> lifecyclePolicyMetadatasMap = lifecyclePolicyMetadatas.stream()
-                .collect(Collectors.toMap(LifecyclePolicyMetadata::getName, Function.identity()));
-        IndexLifecycleMetadata indexLifecycleMetadata = new IndexLifecycleMetadata(lifecyclePolicyMetadatasMap, OperationMode.RUNNING);
-
-        MetaData metadata = MetaData.builder().put(indexMetadata, true).putCustom(IndexLifecycleMetadata.TYPE, indexLifecycleMetadata)
-                .build();
-        return ClusterState.builder(new ClusterName("my_cluster")).metaData(metadata).build();
-    }
-
-    private static LifecyclePolicy createPolicy(String policyName, StepKey safeStep, StepKey unsafeStep) {
-        Map<String, Phase> phases = new HashMap<>();
-        if (safeStep != null) {
-            assert MockAction.NAME.equals(safeStep.getAction()) : "The safe action needs to be MockAction.NAME";
-            assert unsafeStep == null
-                    || safeStep.getPhase().equals(unsafeStep.getPhase()) == false : "safe and unsafe actions must be in different phases";
-            Map<String, LifecycleAction> actions = new HashMap<>();
-            List<Step> steps = Collections.singletonList(new MockStep(safeStep, null));
-            MockAction safeAction = new MockAction(steps, true);
-            actions.put(safeAction.getWriteableName(), safeAction);
-            Phase phase = new Phase(safeStep.getPhase(), TimeValue.timeValueMillis(0), actions);
-            phases.put(phase.getName(), phase);
-        }
-        if (unsafeStep != null) {
-            assert MockAction.NAME.equals(unsafeStep.getAction()) : "The unsafe action needs to be MockAction.NAME";
-            Map<String, LifecycleAction> actions = new HashMap<>();
-            List<Step> steps = Collections.singletonList(new MockStep(unsafeStep, null));
-            MockAction unsafeAction = new MockAction(steps, false);
-            actions.put(unsafeAction.getWriteableName(), unsafeAction);
-            Phase phase = new Phase(unsafeStep.getPhase(), TimeValue.timeValueMillis(0), actions);
-            phases.put(phase.getName(), phase);
-        }
-        return newTestLifecyclePolicy(policyName, phases);
-    }
-
-    public void testRemovePolicyForIndex() {
-        String indexName = randomAlphaOfLength(10);
-        String oldPolicyName = "old_policy";
-        StepKey currentStep = new StepKey(randomAlphaOfLength(10), MockAction.NAME, randomAlphaOfLength(10));
-        LifecyclePolicy oldPolicy = createPolicy(oldPolicyName, currentStep, null);
-        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, oldPolicyName);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        List<LifecyclePolicyMetadata> policyMetadatas = new ArrayList<>();
-        policyMetadatas.add(new LifecyclePolicyMetadata(oldPolicy, Collections.emptyMap(),
-            randomNonNegativeLong(), randomNonNegativeLong()));
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        Index[] indices = new Index[] { index };
-        List<String> failedIndexes = new ArrayList<>();
-
-        ClusterState newClusterState = IndexLifecycleRunner.removePolicyForIndexes(indices, clusterState, failedIndexes);
-
-        assertTrue(failedIndexes.isEmpty());
-        assertIndexNotManagedByILM(newClusterState, index);
-    }
-
-    public void testRemovePolicyForIndexNoCurrentPolicy() {
-        String indexName = randomAlphaOfLength(10);
-        Settings.Builder indexSettingsBuilder = Settings.builder();
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, LifecycleExecutionState.builder().build(),
-            Collections.emptyList());
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        Index[] indices = new Index[] { index };
-        List<String> failedIndexes = new ArrayList<>();
-
-        ClusterState newClusterState = IndexLifecycleRunner.removePolicyForIndexes(indices, clusterState, failedIndexes);
-
-        assertTrue(failedIndexes.isEmpty());
-        assertIndexNotManagedByILM(newClusterState, index);
-    }
-
-    public void testRemovePolicyForIndexIndexDoesntExist() {
-        String indexName = randomAlphaOfLength(10);
-        String oldPolicyName = "old_policy";
-        LifecyclePolicy oldPolicy = newTestLifecyclePolicy(oldPolicyName, Collections.emptyMap());
-        StepKey currentStep = AbstractStepTestCase.randomStepKey();
-        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, oldPolicyName);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        List<LifecyclePolicyMetadata> policyMetadatas = new ArrayList<>();
-        policyMetadatas.add(new LifecyclePolicyMetadata(oldPolicy, Collections.emptyMap(),
-            randomNonNegativeLong(), randomNonNegativeLong()));
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
-        Index index = new Index("doesnt_exist", "im_not_here");
-        Index[] indices = new Index[] { index };
-        List<String> failedIndexes = new ArrayList<>();
-
-        ClusterState newClusterState = IndexLifecycleRunner.removePolicyForIndexes(indices, clusterState, failedIndexes);
-
-        assertEquals(1, failedIndexes.size());
-        assertEquals("doesnt_exist", failedIndexes.get(0));
-        assertSame(clusterState, newClusterState);
-    }
-
-    public void testRemovePolicyForIndexIndexInUnsafe() {
-        String indexName = randomAlphaOfLength(10);
-        String oldPolicyName = "old_policy";
-        StepKey currentStep = new StepKey(randomAlphaOfLength(10), MockAction.NAME, randomAlphaOfLength(10));
-        LifecyclePolicy oldPolicy = createPolicy(oldPolicyName, null, currentStep);
-        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, oldPolicyName);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        List<LifecyclePolicyMetadata> policyMetadatas = new ArrayList<>();
-        policyMetadatas.add(new LifecyclePolicyMetadata(oldPolicy, Collections.emptyMap(),
-            randomNonNegativeLong(), randomNonNegativeLong()));
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        Index[] indices = new Index[] { index };
-        List<String> failedIndexes = new ArrayList<>();
-
-        ClusterState newClusterState = IndexLifecycleRunner.removePolicyForIndexes(indices, clusterState, failedIndexes);
-
-        assertTrue(failedIndexes.isEmpty());
-        assertIndexNotManagedByILM(newClusterState, index);
-    }
-
-    public void testRemovePolicyWithIndexingComplete() {
-        String indexName = randomAlphaOfLength(10);
-        String oldPolicyName = "old_policy";
-        StepKey currentStep = new StepKey(randomAlphaOfLength(10), MockAction.NAME, randomAlphaOfLength(10));
-        LifecyclePolicy oldPolicy = createPolicy(oldPolicyName, null, currentStep);
-        Settings.Builder indexSettingsBuilder = Settings.builder()
-            .put(LifecycleSettings.LIFECYCLE_NAME, oldPolicyName)
-            .put(LifecycleSettings.LIFECYCLE_INDEXING_COMPLETE, true);
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase(currentStep.getPhase());
-        lifecycleState.setAction(currentStep.getAction());
-        lifecycleState.setStep(currentStep.getName());
-        List<LifecyclePolicyMetadata> policyMetadatas = new ArrayList<>();
-        policyMetadatas.add(new LifecyclePolicyMetadata(oldPolicy, Collections.emptyMap(),
-            randomNonNegativeLong(), randomNonNegativeLong()));
-        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
-        Index index = clusterState.metaData().index(indexName).getIndex();
-        Index[] indices = new Index[] { index };
-        List<String> failedIndexes = new ArrayList<>();
-
-        ClusterState newClusterState = IndexLifecycleRunner.removePolicyForIndexes(indices, clusterState, failedIndexes);
-
-        assertTrue(failedIndexes.isEmpty());
-        assertIndexNotManagedByILM(newClusterState, index);
-    }
-
     public void testIsReadyToTransition() {
         String policyName = "async_action_policy";
         StepKey stepKey = new StepKey("phase", MockAction.NAME, MockAction.NAME);
@@ -1405,120 +751,29 @@ public void testIsReadyToTransition() {
             runner.isReadyToTransitionToThisPhase(policyName, indexMetaData, "phase"));
     }
 
-   public void testValidateTransitionThrowsExceptionForMissingIndexPolicy() {
-       IndexMetaData indexMetaData = IndexMetaData.builder("index").settings(settings(Version.CURRENT))
-           .numberOfShards(randomIntBetween(1, 5))
-           .numberOfReplicas(randomIntBetween(0, 5))
-           .build();
-
-       StepKey currentStepKey = new StepKey("hot", "action", "firstStep");
-       StepKey nextStepKey = new StepKey("hot", "action", "secondStep");
-       Step currentStep = new MockStep(currentStepKey, nextStepKey);
-       MockPolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry("policy", currentStep);
-
-       expectThrows(IllegalArgumentException.class,
-           () -> IndexLifecycleRunner.validateTransition(indexMetaData, currentStepKey, nextStepKey, policyRegistry));
-   }
-
-   public void testValidateTransitionThrowsExceptionIfTheCurrentStepIsIncorrect() {
-       LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-       lifecycleState.setPhase("hot");
-       lifecycleState.setAction("action");
-       lifecycleState.setStep("another_step");
-       String policy = "policy";
-       IndexMetaData indexMetaData = buildIndexMetadata(policy, lifecycleState);
-
-       StepKey currentStepKey = new StepKey("hot", "action", "firstStep");
-       StepKey nextStepKey = new StepKey("hot", "action", "secondStep");
-       Step currentStep = new MockStep(currentStepKey, nextStepKey);
-       MockPolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policy, currentStep);
-
-       expectThrows(IllegalArgumentException.class,
-           () -> IndexLifecycleRunner.validateTransition(indexMetaData, currentStepKey, nextStepKey, policyRegistry));
-   }
-
-   public void testValidateTransitionThrowsExceptionIfNextStepDoesNotExist() {
-       LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-       lifecycleState.setPhase("hot");
-       lifecycleState.setAction("action");
-       lifecycleState.setStep("firstStep");
-       String policy = "policy";
-       IndexMetaData indexMetaData = buildIndexMetadata(policy, lifecycleState);
-
-       StepKey currentStepKey = new StepKey("hot", "action", "firstStep");
-       StepKey nextStepKey = new StepKey("hot", "action", "secondStep");
-       Step currentStep = new MockStep(currentStepKey, nextStepKey);
-       MockPolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policy, currentStep);
-
-       expectThrows(IllegalArgumentException.class,
-           () -> IndexLifecycleRunner.validateTransition(indexMetaData, currentStepKey, nextStepKey, policyRegistry));
-   }
-
-    public void testValidateValidTransition() {
-        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
-        lifecycleState.setPhase("hot");
-        lifecycleState.setAction("action");
-        lifecycleState.setStep("firstStep");
-        String policy = "policy";
-        IndexMetaData indexMetaData = buildIndexMetadata(policy, lifecycleState);
-
-        StepKey currentStepKey = new StepKey("hot", "action", "firstStep");
-        StepKey nextStepKey = new StepKey("hot", "action", "secondStep");
-        Step finalStep = new MockStep(nextStepKey, new StepKey("hot", "action", "completed"));
-        MockPolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policy, finalStep);
-
-        try {
-            IndexLifecycleRunner.validateTransition(indexMetaData, currentStepKey, nextStepKey, policyRegistry);
-        } catch (Exception e) {
-            logger.error(e);
-            fail("validateTransition should not throw exception on valid transitions");
-        }
-    }
-
-    public static void assertIndexNotManagedByILM(ClusterState clusterState, Index index) {
-        MetaData metadata = clusterState.metaData();
-        assertNotNull(metadata);
-        IndexMetaData indexMetadata = metadata.getIndexSafe(index);
-        assertNotNull(indexMetadata);
-        Settings indexSettings = indexMetadata.getSettings();
-        assertNotNull(indexSettings);
-        assertFalse(LifecycleSettings.LIFECYCLE_NAME_SETTING.exists(indexSettings));
-        assertFalse(RolloverAction.LIFECYCLE_ROLLOVER_ALIAS_SETTING.exists(indexSettings));
-        assertFalse(LifecycleSettings.LIFECYCLE_INDEXING_COMPLETE_SETTING.exists(indexSettings));
-    }
-
-    public static void assertClusterStateOnPolicy(ClusterState oldClusterState, Index index, String expectedPolicy, StepKey previousStep,
-            StepKey expectedStep, ClusterState newClusterState, long now) {
-        assertNotSame(oldClusterState, newClusterState);
-        MetaData newMetadata = newClusterState.metaData();
-        assertNotSame(oldClusterState.metaData(), newMetadata);
-        IndexMetaData newIndexMetadata = newMetadata.getIndexSafe(index);
-        assertNotSame(oldClusterState.metaData().index(index), newIndexMetadata);
-        LifecycleExecutionState newLifecycleState = LifecycleExecutionState
-            .fromIndexMetadata(newClusterState.metaData().index(index));
-        LifecycleExecutionState oldLifecycleState = LifecycleExecutionState
-            .fromIndexMetadata(oldClusterState.metaData().index(index));
-        assertNotSame(oldLifecycleState, newLifecycleState);
-        assertEquals(expectedStep.getPhase(), newLifecycleState.getPhase());
-        assertEquals(expectedStep.getAction(), newLifecycleState.getAction());
-        assertEquals(expectedStep.getName(), newLifecycleState.getStep());
-        if (Objects.equals(previousStep.getPhase(), expectedStep.getPhase())) {
-            assertEquals(oldLifecycleState.getPhase(), newLifecycleState.getPhase());
-        } else {
-            assertEquals(now, newLifecycleState.getPhaseTime().longValue());
-        }
-        if (Objects.equals(previousStep.getAction(), expectedStep.getAction())) {
-            assertEquals(oldLifecycleState.getActionTime(), newLifecycleState.getActionTime());
-        } else {
-            assertEquals(now, newLifecycleState.getActionTime().longValue());
+    private static LifecyclePolicy createPolicy(String policyName, StepKey safeStep, StepKey unsafeStep) {
+        Map<String, Phase> phases = new HashMap<>();
+        if (safeStep != null) {
+            assert MockAction.NAME.equals(safeStep.getAction()) : "The safe action needs to be MockAction.NAME";
+            assert unsafeStep == null
+                || safeStep.getPhase().equals(unsafeStep.getPhase()) == false : "safe and unsafe actions must be in different phases";
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            List<Step> steps = Collections.singletonList(new MockStep(safeStep, null));
+            MockAction safeAction = new MockAction(steps, true);
+            actions.put(safeAction.getWriteableName(), safeAction);
+            Phase phase = new Phase(safeStep.getPhase(), TimeValue.timeValueMillis(0), actions);
+            phases.put(phase.getName(), phase);
         }
-        if (Objects.equals(previousStep.getName(), expectedStep.getName())) {
-            assertEquals(oldLifecycleState.getStepTime(), newLifecycleState.getStepTime());
-        } else {
-            assertEquals(now, newLifecycleState.getStepTime().longValue());
+        if (unsafeStep != null) {
+            assert MockAction.NAME.equals(unsafeStep.getAction()) : "The unsafe action needs to be MockAction.NAME";
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            List<Step> steps = Collections.singletonList(new MockStep(unsafeStep, null));
+            MockAction unsafeAction = new MockAction(steps, false);
+            actions.put(unsafeAction.getWriteableName(), unsafeAction);
+            Phase phase = new Phase(unsafeStep.getPhase(), TimeValue.timeValueMillis(0), actions);
+            phases.put(phase.getName(), phase);
         }
-        assertEquals(null, newLifecycleState.getFailedStep());
-        assertEquals(null, newLifecycleState.getStepInfo());
+        return newTestLifecyclePolicy(policyName, phases);
     }
 
     public static void assertClusterStateOnNextStep(ClusterState oldClusterState, Index index, StepKey currentStep, StepKey nextStep,
@@ -1551,61 +806,6 @@ public static void assertClusterStateOnNextStep(ClusterState oldClusterState, In
         assertEquals(null, newLifecycleState.getStepInfo());
     }
 
-    private IndexMetaData buildIndexMetadata(String policy, LifecycleExecutionState.Builder lifecycleState) {
-        return IndexMetaData.builder("index")
-            .settings(settings(Version.CURRENT).put(LifecycleSettings.LIFECYCLE_NAME, policy))
-            .numberOfShards(randomIntBetween(1, 5))
-            .numberOfReplicas(randomIntBetween(0, 5))
-            .putCustom(ILM_CUSTOM_METADATA_KEY, lifecycleState.build().asMap())
-            .build();
-    }
-
-    private void assertClusterStateOnErrorStep(ClusterState oldClusterState, Index index, StepKey currentStep,
-                                               ClusterState newClusterState, long now, String expectedCauseValue) throws IOException {
-        assertNotSame(oldClusterState, newClusterState);
-        MetaData newMetadata = newClusterState.metaData();
-        assertNotSame(oldClusterState.metaData(), newMetadata);
-        IndexMetaData newIndexMetadata = newMetadata.getIndexSafe(index);
-        assertNotSame(oldClusterState.metaData().index(index), newIndexMetadata);
-        LifecycleExecutionState newLifecycleState = LifecycleExecutionState
-            .fromIndexMetadata(newClusterState.metaData().index(index));
-        LifecycleExecutionState oldLifecycleState = LifecycleExecutionState
-            .fromIndexMetadata(oldClusterState.metaData().index(index));
-        assertNotSame(oldLifecycleState, newLifecycleState);
-        assertEquals(currentStep.getPhase(), newLifecycleState.getPhase());
-        assertEquals(currentStep.getAction(), newLifecycleState.getAction());
-        assertEquals(ErrorStep.NAME, newLifecycleState.getStep());
-        assertEquals(currentStep.getName(), newLifecycleState.getFailedStep());
-        assertThat(newLifecycleState.getStepInfo(), containsString(expectedCauseValue));
-        assertEquals(oldLifecycleState.getPhaseTime(), newLifecycleState.getPhaseTime());
-        assertEquals(oldLifecycleState.getActionTime(), newLifecycleState.getActionTime());
-        assertEquals(now, newLifecycleState.getStepTime().longValue());
-    }
-
-    private void assertClusterStateStepInfo(ClusterState oldClusterState, Index index, StepKey currentStep, ClusterState newClusterState,
-            ToXContentObject stepInfo) throws IOException {
-        XContentBuilder stepInfoXContentBuilder = JsonXContent.contentBuilder();
-        stepInfo.toXContent(stepInfoXContentBuilder, ToXContent.EMPTY_PARAMS);
-        String expectedstepInfoValue = BytesReference.bytes(stepInfoXContentBuilder).utf8ToString();
-        assertNotSame(oldClusterState, newClusterState);
-        MetaData newMetadata = newClusterState.metaData();
-        assertNotSame(oldClusterState.metaData(), newMetadata);
-        IndexMetaData newIndexMetadata = newMetadata.getIndexSafe(index);
-        assertNotSame(oldClusterState.metaData().index(index), newIndexMetadata);
-        LifecycleExecutionState newLifecycleState = LifecycleExecutionState
-            .fromIndexMetadata(newClusterState.metaData().index(index));
-        LifecycleExecutionState oldLifecycleState = LifecycleExecutionState
-            .fromIndexMetadata(oldClusterState.metaData().index(index));
-        assertNotSame(oldLifecycleState, newLifecycleState);
-        assertEquals(currentStep.getPhase(), newLifecycleState.getPhase());
-        assertEquals(currentStep.getAction(), newLifecycleState.getAction());
-        assertEquals(currentStep.getName(), newLifecycleState.getStep());
-        assertEquals(expectedstepInfoValue, newLifecycleState.getStepInfo());
-        assertEquals(oldLifecycleState.getPhaseTime(), newLifecycleState.getPhaseTime());
-        assertEquals(oldLifecycleState.getActionTime(), newLifecycleState.getActionTime());
-        assertEquals(newLifecycleState.getStepTime(), newLifecycleState.getStepTime());
-    }
-
     static class MockAsyncActionStep extends AsyncActionStep {
 
         private Exception exception;
@@ -1830,7 +1030,7 @@ public boolean matches(Object argument) {
 
     }
 
-    private static final class RetryableMockStep extends MockStep {
+    static final class RetryableMockStep extends MockStep {
 
         RetryableMockStep(StepKey stepKey, StepKey nextStepKey) {
             super(stepKey, nextStepKey);
@@ -1841,4 +1041,49 @@ public boolean isRetryable() {
             return true;
         }
     }
+
+    /** A real policy steps registry where getStep can be overridden so that JSON doesn't have to be parsed */
+    public static class MockPolicyStepsRegistry extends PolicyStepsRegistry {
+        private BiFunction<IndexMetaData, StepKey, Step> fn = null;
+        private static Logger logger = LogManager.getLogger(MockPolicyStepsRegistry.class);
+
+        MockPolicyStepsRegistry(SortedMap<String, LifecyclePolicyMetadata> lifecyclePolicyMap, Map<String, Step> firstStepMap,
+                                Map<String, Map<StepKey, Step>> stepMap, NamedXContentRegistry xContentRegistry, Client client) {
+            super(lifecyclePolicyMap, firstStepMap, stepMap, xContentRegistry, client);
+        }
+
+        public void setResolver(BiFunction<IndexMetaData, StepKey, Step> fn) {
+            this.fn = fn;
+        }
+
+        @Override
+        public Step getStep(IndexMetaData indexMetaData, StepKey stepKey) {
+            if (fn == null) {
+                logger.info("--> retrieving step {}", stepKey);
+                return super.getStep(indexMetaData, stepKey);
+            } else {
+                logger.info("--> returning mock step");
+                return fn.apply(indexMetaData, stepKey);
+            }
+        }
+    }
+
+    public static MockPolicyStepsRegistry createOneStepPolicyStepRegistry(String policyName, Step step) {
+        return createMultiStepPolicyStepRegistry(policyName, Collections.singletonList(step));
+    }
+
+    public static MockPolicyStepsRegistry createMultiStepPolicyStepRegistry(String policyName, List<Step> steps) {
+        LifecyclePolicy policy = new LifecyclePolicy(policyName, new HashMap<>());
+        SortedMap<String, LifecyclePolicyMetadata> lifecyclePolicyMap = new TreeMap<>();
+        lifecyclePolicyMap.put(policyName, new LifecyclePolicyMetadata(policy, new HashMap<>(), 1, 1));
+        Map<String, Step> firstStepMap = new HashMap<>();
+        firstStepMap.put(policyName, steps.get(0));
+        Map<String, Map<StepKey, Step>> stepMap = new HashMap<>();
+        Map<StepKey, Step> policySteps = new HashMap<>();
+        steps.forEach(step -> policySteps.put(step.getKey(), step));
+        stepMap.put(policyName, policySteps);
+        Client client = mock(Client.class);
+        when(client.settings()).thenReturn(Settings.EMPTY);
+        return new MockPolicyStepsRegistry(lifecyclePolicyMap, firstStepMap, stepMap, REGISTRY, client);
+    }
 }
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransitionTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransitionTests.java
new file mode 100644
index 0000000000000..a882bc913832d
--- /dev/null
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransitionTests.java
@@ -0,0 +1,784 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ilm;
+
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.Version;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ilm.AbstractStepTestCase;
+import org.elasticsearch.xpack.core.ilm.ErrorStep;
+import org.elasticsearch.xpack.core.ilm.IndexLifecycleMetadata;
+import org.elasticsearch.xpack.core.ilm.LifecycleAction;
+import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
+import org.elasticsearch.xpack.core.ilm.LifecyclePolicy;
+import org.elasticsearch.xpack.core.ilm.LifecyclePolicyMetadata;
+import org.elasticsearch.xpack.core.ilm.LifecyclePolicyTests;
+import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
+import org.elasticsearch.xpack.core.ilm.MockAction;
+import org.elasticsearch.xpack.core.ilm.MockStep;
+import org.elasticsearch.xpack.core.ilm.OperationMode;
+import org.elasticsearch.xpack.core.ilm.Phase;
+import org.elasticsearch.xpack.core.ilm.RolloverAction;
+import org.elasticsearch.xpack.core.ilm.Step;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+import static org.elasticsearch.xpack.core.ilm.LifecycleExecutionState.ILM_CUSTOM_METADATA_KEY;
+import static org.elasticsearch.xpack.core.ilm.LifecyclePolicyTestsUtils.newTestLifecyclePolicy;
+import static org.elasticsearch.xpack.ilm.IndexLifecycleRunnerTests.createOneStepPolicyStepRegistry;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.nullValue;
+
+public class IndexLifecycleTransitionTests extends ESTestCase {
+
+    public void testMoveClusterStateToNextStep() {
+        String indexName = "my_index";
+        LifecyclePolicy policy = randomValueOtherThanMany(p -> p.getPhases().size() == 0,
+            () -> LifecyclePolicyTests.randomTestLifecyclePolicy("policy"));
+        Phase nextPhase = policy.getPhases().values().stream()
+            .findFirst().orElseThrow(() -> new AssertionError("expected next phase to be present"));
+        List<LifecyclePolicyMetadata> policyMetadatas = Collections.singletonList(
+            new LifecyclePolicyMetadata(policy, Collections.emptyMap(), randomNonNegativeLong(), randomNonNegativeLong()));
+        Step.StepKey currentStep = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step.StepKey nextStep = new Step.StepKey(nextPhase.getName(), "next_action", "next_step");
+        long now = randomNonNegativeLong();
+
+        // test going from null lifecycle settings to next step
+        ClusterState clusterState = buildClusterState(indexName,
+            Settings.builder()
+                .put(LifecycleSettings.LIFECYCLE_NAME, policy.getName()), LifecycleExecutionState.builder().build(), policyMetadatas);
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        PolicyStepsRegistry stepsRegistry = createOneStepPolicyStepRegistry(policy.getName(),
+            new MockStep(nextStep, nextStep));
+        ClusterState newClusterState = IndexLifecycleTransition.moveClusterStateToStep(index, clusterState, nextStep,
+            () -> now, stepsRegistry, false);
+        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
+
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        // test going from set currentStep settings to nextStep
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, policy.getName());
+        if (randomBoolean()) {
+            lifecycleState.setStepInfo(randomAlphaOfLength(20));
+        }
+
+        clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
+        index = clusterState.metaData().index(indexName).getIndex();
+        newClusterState = IndexLifecycleTransition.moveClusterStateToStep(index, clusterState,
+            nextStep, () -> now, stepsRegistry, false);
+        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
+    }
+
+    public void testMoveClusterStateToNextStepSamePhase() {
+        String indexName = "my_index";
+        LifecyclePolicy policy = randomValueOtherThanMany(p -> p.getPhases().size() == 0,
+            () -> LifecyclePolicyTests.randomTestLifecyclePolicy("policy"));
+        List<LifecyclePolicyMetadata> policyMetadatas = Collections.singletonList(
+            new LifecyclePolicyMetadata(policy, Collections.emptyMap(), randomNonNegativeLong(), randomNonNegativeLong()));
+        Step.StepKey currentStep = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step.StepKey nextStep = new Step.StepKey("current_phase", "next_action", "next_step");
+        long now = randomNonNegativeLong();
+
+        ClusterState clusterState = buildClusterState(indexName,
+            Settings.builder()
+                .put(LifecycleSettings.LIFECYCLE_NAME, policy.getName()),
+            LifecycleExecutionState.builder()
+                .setPhase(currentStep.getPhase())
+                .setAction(currentStep.getAction())
+                .setStep(currentStep.getName())
+                .build(), policyMetadatas);
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        PolicyStepsRegistry stepsRegistry = createOneStepPolicyStepRegistry(policy.getName(),
+            new MockStep(nextStep, nextStep));
+        ClusterState newClusterState = IndexLifecycleTransition.moveClusterStateToStep(index, clusterState, nextStep,
+            () -> now, stepsRegistry, false);
+        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
+
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        if (randomBoolean()) {
+            lifecycleState.setStepInfo(randomAlphaOfLength(20));
+        }
+
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, policy.getName());
+
+        clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
+        index = clusterState.metaData().index(indexName).getIndex();
+        newClusterState = IndexLifecycleTransition.moveClusterStateToStep(index, clusterState, nextStep,
+            () -> now, stepsRegistry, false);
+        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
+    }
+
+    public void testMoveClusterStateToNextStepSameAction() {
+        String indexName = "my_index";
+        LifecyclePolicy policy = randomValueOtherThanMany(p -> p.getPhases().size() == 0,
+            () -> LifecyclePolicyTests.randomTestLifecyclePolicy("policy"));
+        List<LifecyclePolicyMetadata> policyMetadatas = Collections.singletonList(
+            new LifecyclePolicyMetadata(policy, Collections.emptyMap(), randomNonNegativeLong(), randomNonNegativeLong()));
+        Step.StepKey currentStep = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step.StepKey nextStep = new Step.StepKey("current_phase", "current_action", "next_step");
+        long now = randomNonNegativeLong();
+
+        ClusterState clusterState = buildClusterState(indexName,
+            Settings.builder()
+                .put(LifecycleSettings.LIFECYCLE_NAME, policy.getName()),
+            LifecycleExecutionState.builder()
+                .setPhase(currentStep.getPhase())
+                .setAction(currentStep.getAction())
+                .setStep(currentStep.getName())
+                .build(), policyMetadatas);
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        PolicyStepsRegistry stepsRegistry = createOneStepPolicyStepRegistry(policy.getName(),
+            new MockStep(nextStep, nextStep));
+        ClusterState newClusterState = IndexLifecycleTransition.moveClusterStateToStep(index, clusterState, nextStep,
+            () -> now, stepsRegistry, false);
+        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
+
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        if (randomBoolean()) {
+            lifecycleState.setStepInfo(randomAlphaOfLength(20));
+        }
+
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, policy.getName());
+
+        clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
+        index = clusterState.metaData().index(indexName).getIndex();
+        newClusterState = IndexLifecycleTransition.moveClusterStateToStep(index, clusterState, nextStep,
+            () -> now, stepsRegistry, false);
+        assertClusterStateOnNextStep(clusterState, index, currentStep, nextStep, newClusterState, now);
+    }
+
+    public void testSuccessfulValidatedMoveClusterStateToNextStep() {
+        String indexName = "my_index";
+        String policyName = "my_policy";
+        LifecyclePolicy policy = randomValueOtherThanMany(p -> p.getPhases().size() == 0,
+            () -> LifecyclePolicyTests.randomTestLifecyclePolicy(policyName));
+        Phase nextPhase = policy.getPhases().values().stream()
+            .findFirst().orElseThrow(() -> new AssertionError("expected next phase to be present"));
+        List<LifecyclePolicyMetadata> policyMetadatas = Collections.singletonList(
+            new LifecyclePolicyMetadata(policy, Collections.emptyMap(), randomNonNegativeLong(), randomNonNegativeLong()));
+        Step.StepKey currentStepKey = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step.StepKey nextStepKey = new Step.StepKey(nextPhase.getName(), "next_action", "next_step");
+        long now = randomNonNegativeLong();
+        Step step = new MockStep(nextStepKey, nextStepKey);
+        PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
+
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStepKey.getPhase());
+        lifecycleState.setAction(currentStepKey.getAction());
+        lifecycleState.setStep(currentStepKey.getName());
+
+        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, policyName);
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        ClusterState newClusterState = IndexLifecycleTransition.moveClusterStateToStep(index, clusterState,
+            nextStepKey, () -> now, stepRegistry, true);
+        assertClusterStateOnNextStep(clusterState, index, currentStepKey, nextStepKey, newClusterState, now);
+    }
+
+    public void testValidatedMoveClusterStateToNextStepWithoutPolicy() {
+        String indexName = "my_index";
+        String policyName = "policy";
+        Step.StepKey currentStepKey = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step.StepKey nextStepKey = new Step.StepKey("next_phase", "next_action", "next_step");
+        long now = randomNonNegativeLong();
+        Step step = new MockStep(nextStepKey, nextStepKey);
+        PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
+
+        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, randomBoolean() ? "" : null);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStepKey.getPhase());
+        lifecycleState.setAction(currentStepKey.getAction());
+        lifecycleState.setStep(currentStepKey.getName());
+
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.moveClusterStateToStep(index, clusterState, nextStepKey, () -> now, stepRegistry, true));
+        assertThat(exception.getMessage(), equalTo("index [my_index] is not associated with an Index Lifecycle Policy"));
+    }
+
+    public void testValidatedMoveClusterStateToNextStepInvalidNextStep() {
+        String indexName = "my_index";
+        String policyName = "my_policy";
+        Step.StepKey currentStepKey = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step.StepKey nextStepKey = new Step.StepKey("next_phase", "next_action", "next_step");
+        long now = randomNonNegativeLong();
+        Step step = new MockStep(currentStepKey, nextStepKey);
+        PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
+
+        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, policyName);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStepKey.getPhase());
+        lifecycleState.setAction(currentStepKey.getAction());
+        lifecycleState.setStep(currentStepKey.getName());
+
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.moveClusterStateToStep(index, clusterState, nextStepKey, () -> now, stepRegistry, true));
+        assertThat(exception.getMessage(),
+            equalTo("step [{\"phase\":\"next_phase\",\"action\":\"next_action\",\"name\":\"next_step\"}] " +
+                "for index [my_index] with policy [my_policy] does not exist"));
+    }
+
+    public void testMoveClusterStateToErrorStep() throws IOException {
+        String indexName = "my_index";
+        Step.StepKey currentStep = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step.StepKey nextStepKey = new Step.StepKey("next_phase", "next_action", "next_step");
+        long now = randomNonNegativeLong();
+        Exception cause = new ElasticsearchException("THIS IS AN EXPECTED CAUSE");
+
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        ClusterState clusterState = buildClusterState(indexName, Settings.builder(), lifecycleState.build(), Collections.emptyList());
+        Index index = clusterState.metaData().index(indexName).getIndex();
+
+        ClusterState newClusterState = IndexLifecycleTransition.moveClusterStateToErrorStep(index, clusterState, cause,
+            () -> now, (idxMeta, stepKey) -> new MockStep(stepKey, nextStepKey));
+        assertClusterStateOnErrorStep(clusterState, index, currentStep, newClusterState, now,
+            "{\"type\":\"exception\",\"reason\":\"THIS IS AN EXPECTED CAUSE\"");
+
+        cause = new IllegalArgumentException("non elasticsearch-exception");
+        newClusterState = IndexLifecycleTransition.moveClusterStateToErrorStep(index, clusterState, cause, () -> now,
+            (idxMeta, stepKey) -> new MockStep(stepKey, nextStepKey));
+        assertClusterStateOnErrorStep(clusterState, index, currentStep, newClusterState, now,
+            "{\"type\":\"illegal_argument_exception\",\"reason\":\"non elasticsearch-exception\",\"stack_trace\":\"");
+    }
+
+    public void testAddStepInfoToClusterState() throws IOException {
+        String indexName = "my_index";
+        Step.StepKey currentStep = new Step.StepKey("current_phase", "current_action", "current_step");
+        RandomStepInfo stepInfo = new RandomStepInfo(() -> randomAlphaOfLength(10));
+
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        ClusterState clusterState = buildClusterState(indexName, Settings.builder(), lifecycleState.build(), Collections.emptyList());
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        ClusterState newClusterState = IndexLifecycleTransition.addStepInfoToClusterState(index, clusterState, stepInfo);
+        assertClusterStateStepInfo(clusterState, index, currentStep, newClusterState, stepInfo);
+        ClusterState runAgainClusterState = IndexLifecycleTransition.addStepInfoToClusterState(index, newClusterState, stepInfo);
+        assertSame(newClusterState, runAgainClusterState);
+    }
+
+
+    public void testRemovePolicyForIndex() {
+        String indexName = randomAlphaOfLength(10);
+        String oldPolicyName = "old_policy";
+        Step.StepKey currentStep = new Step.StepKey(randomAlphaOfLength(10), MockAction.NAME, randomAlphaOfLength(10));
+        LifecyclePolicy oldPolicy = createPolicy(oldPolicyName, currentStep, null);
+        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, oldPolicyName);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        List<LifecyclePolicyMetadata> policyMetadatas = new ArrayList<>();
+        policyMetadatas.add(new LifecyclePolicyMetadata(oldPolicy, Collections.emptyMap(),
+            randomNonNegativeLong(), randomNonNegativeLong()));
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        Index[] indices = new Index[] { index };
+        List<String> failedIndexes = new ArrayList<>();
+
+        ClusterState newClusterState = IndexLifecycleTransition.removePolicyForIndexes(indices, clusterState, failedIndexes);
+
+        assertTrue(failedIndexes.isEmpty());
+        assertIndexNotManagedByILM(newClusterState, index);
+    }
+
+    public void testRemovePolicyForIndexNoCurrentPolicy() {
+        String indexName = randomAlphaOfLength(10);
+        Settings.Builder indexSettingsBuilder = Settings.builder();
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, LifecycleExecutionState.builder().build(),
+            Collections.emptyList());
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        Index[] indices = new Index[] { index };
+        List<String> failedIndexes = new ArrayList<>();
+
+        ClusterState newClusterState = IndexLifecycleTransition.removePolicyForIndexes(indices, clusterState, failedIndexes);
+
+        assertTrue(failedIndexes.isEmpty());
+        assertIndexNotManagedByILM(newClusterState, index);
+    }
+
+    public void testRemovePolicyForIndexIndexDoesntExist() {
+        String indexName = randomAlphaOfLength(10);
+        String oldPolicyName = "old_policy";
+        LifecyclePolicy oldPolicy = newTestLifecyclePolicy(oldPolicyName, Collections.emptyMap());
+        Step.StepKey currentStep = AbstractStepTestCase.randomStepKey();
+        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, oldPolicyName);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        List<LifecyclePolicyMetadata> policyMetadatas = new ArrayList<>();
+        policyMetadatas.add(new LifecyclePolicyMetadata(oldPolicy, Collections.emptyMap(),
+            randomNonNegativeLong(), randomNonNegativeLong()));
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
+        Index index = new Index("doesnt_exist", "im_not_here");
+        Index[] indices = new Index[] { index };
+        List<String> failedIndexes = new ArrayList<>();
+
+        ClusterState newClusterState = IndexLifecycleTransition.removePolicyForIndexes(indices, clusterState, failedIndexes);
+
+        assertEquals(1, failedIndexes.size());
+        assertEquals("doesnt_exist", failedIndexes.get(0));
+        assertSame(clusterState, newClusterState);
+    }
+
+    public void testRemovePolicyForIndexIndexInUnsafe() {
+        String indexName = randomAlphaOfLength(10);
+        String oldPolicyName = "old_policy";
+        Step.StepKey currentStep = new Step.StepKey(randomAlphaOfLength(10), MockAction.NAME, randomAlphaOfLength(10));
+        LifecyclePolicy oldPolicy = createPolicy(oldPolicyName, null, currentStep);
+        Settings.Builder indexSettingsBuilder = Settings.builder().put(LifecycleSettings.LIFECYCLE_NAME, oldPolicyName);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        List<LifecyclePolicyMetadata> policyMetadatas = new ArrayList<>();
+        policyMetadatas.add(new LifecyclePolicyMetadata(oldPolicy, Collections.emptyMap(),
+            randomNonNegativeLong(), randomNonNegativeLong()));
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        Index[] indices = new Index[] { index };
+        List<String> failedIndexes = new ArrayList<>();
+
+        ClusterState newClusterState = IndexLifecycleTransition.removePolicyForIndexes(indices, clusterState, failedIndexes);
+
+        assertTrue(failedIndexes.isEmpty());
+        assertIndexNotManagedByILM(newClusterState, index);
+    }
+
+    public void testRemovePolicyWithIndexingComplete() {
+        String indexName = randomAlphaOfLength(10);
+        String oldPolicyName = "old_policy";
+        Step.StepKey currentStep = new Step.StepKey(randomAlphaOfLength(10), MockAction.NAME, randomAlphaOfLength(10));
+        LifecyclePolicy oldPolicy = createPolicy(oldPolicyName, null, currentStep);
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, oldPolicyName)
+            .put(LifecycleSettings.LIFECYCLE_INDEXING_COMPLETE, true);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(currentStep.getPhase());
+        lifecycleState.setAction(currentStep.getAction());
+        lifecycleState.setStep(currentStep.getName());
+        List<LifecyclePolicyMetadata> policyMetadatas = new ArrayList<>();
+        policyMetadatas.add(new LifecyclePolicyMetadata(oldPolicy, Collections.emptyMap(),
+            randomNonNegativeLong(), randomNonNegativeLong()));
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), policyMetadatas);
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        Index[] indices = new Index[] { index };
+        List<String> failedIndexes = new ArrayList<>();
+
+        ClusterState newClusterState = IndexLifecycleTransition.removePolicyForIndexes(indices, clusterState, failedIndexes);
+
+        assertTrue(failedIndexes.isEmpty());
+        assertIndexNotManagedByILM(newClusterState, index);
+    }
+
+    public void testValidateTransitionThrowsExceptionForMissingIndexPolicy() {
+        IndexMetaData indexMetaData = IndexMetaData.builder("index").settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5))
+            .numberOfReplicas(randomIntBetween(0, 5))
+            .build();
+
+        Step.StepKey currentStepKey = new Step.StepKey("hot", "action", "firstStep");
+        Step.StepKey nextStepKey = new Step.StepKey("hot", "action", "secondStep");
+        Step currentStep = new MockStep(currentStepKey, nextStepKey);
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry("policy", currentStep);
+
+        expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.validateTransition(indexMetaData, currentStepKey, nextStepKey, policyRegistry));
+    }
+
+    public void testValidateTransitionThrowsExceptionIfTheCurrentStepIsIncorrect() {
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase("hot");
+        lifecycleState.setAction("action");
+        lifecycleState.setStep("another_step");
+        String policy = "policy";
+        IndexMetaData indexMetaData = buildIndexMetadata(policy, lifecycleState);
+
+        Step.StepKey currentStepKey = new Step.StepKey("hot", "action", "firstStep");
+        Step.StepKey nextStepKey = new Step.StepKey("hot", "action", "secondStep");
+        Step currentStep = new MockStep(currentStepKey, nextStepKey);
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policy, currentStep);
+
+        expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.validateTransition(indexMetaData, currentStepKey, nextStepKey, policyRegistry));
+    }
+
+    public void testValidateTransitionThrowsExceptionIfNextStepDoesNotExist() {
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase("hot");
+        lifecycleState.setAction("action");
+        lifecycleState.setStep("firstStep");
+        String policy = "policy";
+        IndexMetaData indexMetaData = buildIndexMetadata(policy, lifecycleState);
+
+        Step.StepKey currentStepKey = new Step.StepKey("hot", "action", "firstStep");
+        Step.StepKey nextStepKey = new Step.StepKey("hot", "action", "secondStep");
+        Step currentStep = new MockStep(currentStepKey, nextStepKey);
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policy, currentStep);
+
+        expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.validateTransition(indexMetaData, currentStepKey, nextStepKey, policyRegistry));
+    }
+
+    public void testValidateValidTransition() {
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase("hot");
+        lifecycleState.setAction("action");
+        lifecycleState.setStep("firstStep");
+        String policy = "policy";
+        IndexMetaData indexMetaData = buildIndexMetadata(policy, lifecycleState);
+
+        Step.StepKey currentStepKey = new Step.StepKey("hot", "action", "firstStep");
+        Step.StepKey nextStepKey = new Step.StepKey("hot", "action", "secondStep");
+        Step finalStep = new MockStep(nextStepKey, new Step.StepKey("hot", "action", "completed"));
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policy, finalStep);
+
+        try {
+            IndexLifecycleTransition.validateTransition(indexMetaData, currentStepKey, nextStepKey, policyRegistry);
+        } catch (Exception e) {
+            logger.error(e);
+            fail("validateTransition should not throw exception on valid transitions");
+        }
+    }
+
+    public void testMoveClusterStateToFailedStep() {
+        String indexName = "my_index";
+        String policyName = "my_policy";
+        long now = randomNonNegativeLong();
+        Step.StepKey failedStepKey = new Step.StepKey("current_phase", MockAction.NAME, "current_step");
+        Step.StepKey errorStepKey = new Step.StepKey(failedStepKey.getPhase(), failedStepKey.getAction(), ErrorStep.NAME);
+        Step step = new MockStep(failedStepKey, null);
+        LifecyclePolicy policy = createPolicy(policyName, failedStepKey, null);
+        LifecyclePolicyMetadata policyMetadata = new LifecyclePolicyMetadata(policy, Collections.emptyMap(),
+            randomNonNegativeLong(), randomNonNegativeLong());
+
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, step);
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, policyName);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(errorStepKey.getPhase());
+        lifecycleState.setPhaseTime(now);
+        lifecycleState.setAction(errorStepKey.getAction());
+        lifecycleState.setActionTime(now);
+        lifecycleState.setStep(errorStepKey.getName());
+        lifecycleState.setStepTime(now);
+        lifecycleState.setFailedStep(failedStepKey.getName());
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(),
+            Collections.singletonList(policyMetadata));
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        ClusterState nextClusterState = IndexLifecycleTransition.moveClusterStateToPreviouslyFailedStep(clusterState,
+            indexName, () -> now, policyRegistry, false);
+        IndexLifecycleRunnerTests.assertClusterStateOnNextStep(clusterState, index, errorStepKey, failedStepKey,
+            nextClusterState, now);
+        LifecycleExecutionState executionState = LifecycleExecutionState.fromIndexMetadata(nextClusterState.metaData().index(indexName));
+        assertThat("manual move to failed step should not count as a retry", executionState.getFailedStepRetryCount(), is(nullValue()));
+    }
+
+    public void testMoveClusterStateToFailedStepWithUnknownStep() {
+        String indexName = "my_index";
+        String policyName = "my_policy";
+        long now = randomNonNegativeLong();
+        Step.StepKey failedStepKey = new Step.StepKey("current_phase", MockAction.NAME, "current_step");
+        Step.StepKey errorStepKey = new Step.StepKey(failedStepKey.getPhase(), failedStepKey.getAction(), ErrorStep.NAME);
+
+        Step.StepKey registeredStepKey = new Step.StepKey(randomFrom(failedStepKey.getPhase(), "other"),
+            MockAction.NAME, "different_step");
+        Step step = new MockStep(registeredStepKey, null);
+        LifecyclePolicy policy = createPolicy(policyName, failedStepKey, null);
+        LifecyclePolicyMetadata policyMetadata = new LifecyclePolicyMetadata(policy, Collections.emptyMap(),
+            randomNonNegativeLong(), randomNonNegativeLong());
+
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, step);
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, policyName);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(errorStepKey.getPhase());
+        lifecycleState.setPhaseTime(now);
+        lifecycleState.setAction(errorStepKey.getAction());
+        lifecycleState.setActionTime(now);
+        lifecycleState.setStep(errorStepKey.getName());
+        lifecycleState.setStepTime(now);
+        lifecycleState.setFailedStep(failedStepKey.getName());
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(),
+            Collections.singletonList(policyMetadata));
+        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.moveClusterStateToPreviouslyFailedStep(clusterState,
+                indexName, () -> now, policyRegistry, false));
+        assertThat(exception.getMessage(), equalTo("step [" + failedStepKey
+            + "] for index [my_index] with policy [my_policy] does not exist"));
+    }
+
+    public void testMoveClusterStateToFailedStepIndexNotFound() {
+        String existingIndexName = "my_index";
+        String invalidIndexName = "does_not_exist";
+        ClusterState clusterState = buildClusterState(existingIndexName, Settings.builder(), LifecycleExecutionState.builder().build(),
+            Collections.emptyList());
+        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.moveClusterStateToPreviouslyFailedStep(clusterState,
+                invalidIndexName, () -> 0L, null, false));
+        assertThat(exception.getMessage(), equalTo("index [" + invalidIndexName + "] does not exist"));
+    }
+
+    public void testMoveClusterStateToFailedStepInvalidPolicySetting() {
+        String indexName = "my_index";
+        String policyName = "my_policy";
+        long now = randomNonNegativeLong();
+        Step.StepKey failedStepKey = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step.StepKey errorStepKey = new Step.StepKey(failedStepKey.getPhase(), failedStepKey.getAction(), ErrorStep.NAME);
+        Step step = new MockStep(failedStepKey, null);
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, step);
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, (String) null);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(errorStepKey.getPhase());
+        lifecycleState.setAction(errorStepKey.getAction());
+        lifecycleState.setStep(errorStepKey.getName());
+        lifecycleState.setFailedStep(failedStepKey.getName());
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
+        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.moveClusterStateToPreviouslyFailedStep(clusterState,
+                indexName, () -> now, policyRegistry, false));
+        assertThat(exception.getMessage(), equalTo("index [" + indexName + "] is not associated with an Index Lifecycle Policy"));
+    }
+
+    public void testMoveClusterStateToFailedNotOnError() {
+        String indexName = "my_index";
+        String policyName = "my_policy";
+        long now = randomNonNegativeLong();
+        Step.StepKey failedStepKey = new Step.StepKey("current_phase", "current_action", "current_step");
+        Step step = new MockStep(failedStepKey, null);
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, step);
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, (String) null);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(failedStepKey.getPhase());
+        lifecycleState.setAction(failedStepKey.getAction());
+        lifecycleState.setStep(failedStepKey.getName());
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(), Collections.emptyList());
+        IllegalArgumentException exception = expectThrows(IllegalArgumentException.class,
+            () -> IndexLifecycleTransition.moveClusterStateToPreviouslyFailedStep(clusterState,
+                indexName, () -> now, policyRegistry, false));
+        assertThat(exception.getMessage(), equalTo("cannot retry an action for an index [" + indexName
+            + "] that has not encountered an error when running a Lifecycle Policy"));
+    }
+
+    public void testMoveClusterStateToPreviouslyFailedStepAsAutomaticRetry() {
+        String indexName = "my_index";
+        String policyName = "my_policy";
+        long now = randomNonNegativeLong();
+        Step.StepKey failedStepKey = new Step.StepKey("current_phase", MockAction.NAME, "current_step");
+        Step.StepKey errorStepKey = new Step.StepKey(failedStepKey.getPhase(), failedStepKey.getAction(), ErrorStep.NAME);
+        Step retryableStep = new IndexLifecycleRunnerTests.RetryableMockStep(failedStepKey, null);
+        LifecyclePolicy policy = createPolicy(policyName, failedStepKey, null);
+        LifecyclePolicyMetadata policyMetadata = new LifecyclePolicyMetadata(policy, Collections.emptyMap(),
+            randomNonNegativeLong(), randomNonNegativeLong());
+
+        PolicyStepsRegistry policyRegistry = createOneStepPolicyStepRegistry(policyName, retryableStep);
+        Settings.Builder indexSettingsBuilder = Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_NAME, policyName);
+        LifecycleExecutionState.Builder lifecycleState = LifecycleExecutionState.builder();
+        lifecycleState.setPhase(errorStepKey.getPhase());
+        lifecycleState.setPhaseTime(now);
+        lifecycleState.setAction(errorStepKey.getAction());
+        lifecycleState.setActionTime(now);
+        lifecycleState.setStep(errorStepKey.getName());
+        lifecycleState.setStepTime(now);
+        lifecycleState.setFailedStep(failedStepKey.getName());
+        ClusterState clusterState = buildClusterState(indexName, indexSettingsBuilder, lifecycleState.build(),
+            Collections.singletonList(policyMetadata));
+        Index index = clusterState.metaData().index(indexName).getIndex();
+        ClusterState nextClusterState = IndexLifecycleTransition.moveClusterStateToPreviouslyFailedStep(clusterState,
+            indexName, () -> now, policyRegistry, true);
+        IndexLifecycleRunnerTests.assertClusterStateOnNextStep(clusterState, index, errorStepKey, failedStepKey,
+            nextClusterState, now);
+        LifecycleExecutionState executionState = LifecycleExecutionState.fromIndexMetadata(nextClusterState.metaData().index(indexName));
+        assertThat(executionState.getFailedStepRetryCount(), is(1));
+    }
+
+    private static LifecyclePolicy createPolicy(String policyName, Step.StepKey safeStep, Step.StepKey unsafeStep) {
+        Map<String, Phase> phases = new HashMap<>();
+        if (safeStep != null) {
+            assert MockAction.NAME.equals(safeStep.getAction()) : "The safe action needs to be MockAction.NAME";
+            assert unsafeStep == null
+                || safeStep.getPhase().equals(unsafeStep.getPhase()) == false : "safe and unsafe actions must be in different phases";
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            List<Step> steps = Collections.singletonList(new MockStep(safeStep, null));
+            MockAction safeAction = new MockAction(steps, true);
+            actions.put(safeAction.getWriteableName(), safeAction);
+            Phase phase = new Phase(safeStep.getPhase(), TimeValue.timeValueMillis(0), actions);
+            phases.put(phase.getName(), phase);
+        }
+        if (unsafeStep != null) {
+            assert MockAction.NAME.equals(unsafeStep.getAction()) : "The unsafe action needs to be MockAction.NAME";
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            List<Step> steps = Collections.singletonList(new MockStep(unsafeStep, null));
+            MockAction unsafeAction = new MockAction(steps, false);
+            actions.put(unsafeAction.getWriteableName(), unsafeAction);
+            Phase phase = new Phase(unsafeStep.getPhase(), TimeValue.timeValueMillis(0), actions);
+            phases.put(phase.getName(), phase);
+        }
+        return newTestLifecyclePolicy(policyName, phases);
+    }
+
+    private ClusterState buildClusterState(String indexName, Settings.Builder indexSettingsBuilder,
+                                           LifecycleExecutionState lifecycleState,
+                                           List<LifecyclePolicyMetadata> lifecyclePolicyMetadatas) {
+        Settings indexSettings = indexSettingsBuilder.put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0).put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT).build();
+        IndexMetaData indexMetadata = IndexMetaData.builder(indexName)
+            .settings(indexSettings)
+            .putCustom(ILM_CUSTOM_METADATA_KEY, lifecycleState.asMap())
+            .build();
+
+        Map<String, LifecyclePolicyMetadata> lifecyclePolicyMetadatasMap = lifecyclePolicyMetadatas.stream()
+            .collect(Collectors.toMap(LifecyclePolicyMetadata::getName, Function.identity()));
+        IndexLifecycleMetadata indexLifecycleMetadata = new IndexLifecycleMetadata(lifecyclePolicyMetadatasMap, OperationMode.RUNNING);
+
+        MetaData metadata = MetaData.builder().put(indexMetadata, true).putCustom(IndexLifecycleMetadata.TYPE, indexLifecycleMetadata)
+            .build();
+        return ClusterState.builder(new ClusterName("my_cluster")).metaData(metadata).build();
+    }
+
+    public static void assertIndexNotManagedByILM(ClusterState clusterState, Index index) {
+        MetaData metadata = clusterState.metaData();
+        assertNotNull(metadata);
+        IndexMetaData indexMetadata = metadata.getIndexSafe(index);
+        assertNotNull(indexMetadata);
+        Settings indexSettings = indexMetadata.getSettings();
+        assertNotNull(indexSettings);
+        assertFalse(LifecycleSettings.LIFECYCLE_NAME_SETTING.exists(indexSettings));
+        assertFalse(RolloverAction.LIFECYCLE_ROLLOVER_ALIAS_SETTING.exists(indexSettings));
+        assertFalse(LifecycleSettings.LIFECYCLE_INDEXING_COMPLETE_SETTING.exists(indexSettings));
+    }
+
+    public static void assertClusterStateOnNextStep(ClusterState oldClusterState, Index index, Step.StepKey currentStep,
+                                                    Step.StepKey nextStep, ClusterState newClusterState, long now) {
+        assertNotSame(oldClusterState, newClusterState);
+        MetaData newMetadata = newClusterState.metaData();
+        assertNotSame(oldClusterState.metaData(), newMetadata);
+        IndexMetaData newIndexMetadata = newMetadata.getIndexSafe(index);
+        assertNotSame(oldClusterState.metaData().index(index), newIndexMetadata);
+        LifecycleExecutionState newLifecycleState = LifecycleExecutionState
+            .fromIndexMetadata(newClusterState.metaData().index(index));
+        LifecycleExecutionState oldLifecycleState = LifecycleExecutionState
+            .fromIndexMetadata(oldClusterState.metaData().index(index));
+        assertNotSame(oldLifecycleState, newLifecycleState);
+        assertEquals(nextStep.getPhase(), newLifecycleState.getPhase());
+        assertEquals(nextStep.getAction(), newLifecycleState.getAction());
+        assertEquals(nextStep.getName(), newLifecycleState.getStep());
+        if (currentStep.getPhase().equals(nextStep.getPhase())) {
+            assertEquals("expected phase times to be the same but they were different",
+                oldLifecycleState.getPhaseTime(), newLifecycleState.getPhaseTime());
+        } else {
+            assertEquals(now, newLifecycleState.getPhaseTime().longValue());
+        }
+        if (currentStep.getAction().equals(nextStep.getAction())) {
+            assertEquals("expected action times to be the same but they were different",
+                oldLifecycleState.getActionTime(), newLifecycleState.getActionTime());
+        } else {
+            assertEquals(now, newLifecycleState.getActionTime().longValue());
+        }
+        assertEquals(now, newLifecycleState.getStepTime().longValue());
+        assertEquals(null, newLifecycleState.getFailedStep());
+        assertEquals(null, newLifecycleState.getStepInfo());
+    }
+
+    private IndexMetaData buildIndexMetadata(String policy, LifecycleExecutionState.Builder lifecycleState) {
+        return IndexMetaData.builder("index")
+            .settings(settings(Version.CURRENT).put(LifecycleSettings.LIFECYCLE_NAME, policy))
+            .numberOfShards(randomIntBetween(1, 5))
+            .numberOfReplicas(randomIntBetween(0, 5))
+            .putCustom(ILM_CUSTOM_METADATA_KEY, lifecycleState.build().asMap())
+            .build();
+    }
+
+    private void assertClusterStateOnErrorStep(ClusterState oldClusterState, Index index, Step.StepKey currentStep,
+                                               ClusterState newClusterState, long now, String expectedCauseValue) {
+        assertNotSame(oldClusterState, newClusterState);
+        MetaData newMetadata = newClusterState.metaData();
+        assertNotSame(oldClusterState.metaData(), newMetadata);
+        IndexMetaData newIndexMetadata = newMetadata.getIndexSafe(index);
+        assertNotSame(oldClusterState.metaData().index(index), newIndexMetadata);
+        LifecycleExecutionState newLifecycleState = LifecycleExecutionState
+            .fromIndexMetadata(newClusterState.metaData().index(index));
+        LifecycleExecutionState oldLifecycleState = LifecycleExecutionState
+            .fromIndexMetadata(oldClusterState.metaData().index(index));
+        assertNotSame(oldLifecycleState, newLifecycleState);
+        assertEquals(currentStep.getPhase(), newLifecycleState.getPhase());
+        assertEquals(currentStep.getAction(), newLifecycleState.getAction());
+        assertEquals(ErrorStep.NAME, newLifecycleState.getStep());
+        assertEquals(currentStep.getName(), newLifecycleState.getFailedStep());
+        assertThat(newLifecycleState.getStepInfo(), containsString(expectedCauseValue));
+        assertEquals(oldLifecycleState.getPhaseTime(), newLifecycleState.getPhaseTime());
+        assertEquals(oldLifecycleState.getActionTime(), newLifecycleState.getActionTime());
+        assertEquals(now, newLifecycleState.getStepTime().longValue());
+    }
+
+    private void assertClusterStateStepInfo(ClusterState oldClusterState, Index index, Step.StepKey currentStep,
+                                            ClusterState newClusterState, ToXContentObject stepInfo) throws IOException {
+        XContentBuilder stepInfoXContentBuilder = JsonXContent.contentBuilder();
+        stepInfo.toXContent(stepInfoXContentBuilder, ToXContent.EMPTY_PARAMS);
+        String expectedstepInfoValue = BytesReference.bytes(stepInfoXContentBuilder).utf8ToString();
+        assertNotSame(oldClusterState, newClusterState);
+        MetaData newMetadata = newClusterState.metaData();
+        assertNotSame(oldClusterState.metaData(), newMetadata);
+        IndexMetaData newIndexMetadata = newMetadata.getIndexSafe(index);
+        assertNotSame(oldClusterState.metaData().index(index), newIndexMetadata);
+        LifecycleExecutionState newLifecycleState = LifecycleExecutionState
+            .fromIndexMetadata(newClusterState.metaData().index(index));
+        LifecycleExecutionState oldLifecycleState = LifecycleExecutionState
+            .fromIndexMetadata(oldClusterState.metaData().index(index));
+        assertNotSame(oldLifecycleState, newLifecycleState);
+        assertEquals(currentStep.getPhase(), newLifecycleState.getPhase());
+        assertEquals(currentStep.getAction(), newLifecycleState.getAction());
+        assertEquals(currentStep.getName(), newLifecycleState.getStep());
+        assertEquals(expectedstepInfoValue, newLifecycleState.getStepInfo());
+        assertEquals(oldLifecycleState.getPhaseTime(), newLifecycleState.getPhaseTime());
+        assertEquals(oldLifecycleState.getActionTime(), newLifecycleState.getActionTime());
+        assertEquals(newLifecycleState.getStepTime(), newLifecycleState.getStepTime());
+    }
+}
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTaskTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTaskTests.java
index 299e4abf3058c..fa2a626b0f9bc 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTaskTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTaskTests.java
@@ -78,7 +78,7 @@ public void testExecuteSuccessfullyMoved() throws IOException {
             (idxMeta, stepKey) -> new MockStep(stepKey, nextStepKey));
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey actualKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey actualKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(actualKey, equalTo(new StepKey(currentStepKey.getPhase(), currentStepKey.getAction(), ErrorStep.NAME)));
         assertThat(lifecycleState.getFailedStep(), equalTo(currentStepKey.getName()));
         assertThat(lifecycleState.getPhaseTime(), nullValue());
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToNextStepUpdateTaskTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToNextStepUpdateTaskTests.java
index 0f8438685b39c..13b3c9eeb1c26 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToNextStepUpdateTaskTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToNextStepUpdateTaskTests.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.core.ilm.IndexLifecycleMetadata;
@@ -71,10 +72,10 @@ public void testExecuteSuccessfullyMoved() {
 
         AtomicBoolean changed = new AtomicBoolean(false);
         MoveToNextStepUpdateTask task = new MoveToNextStepUpdateTask(index, policy, currentStepKey, nextStepKey,
-            () -> now, state -> changed.set(true));
+            () -> now, new AlwaysExistingStepRegistry(), state -> changed.set(true));
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey actualKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey actualKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(actualKey, equalTo(nextStepKey));
         assertThat(lifecycleState.getPhaseTime(), equalTo(now));
         assertThat(lifecycleState.getActionTime(), equalTo(now));
@@ -88,7 +89,8 @@ public void testExecuteDifferentCurrentStep() {
         StepKey notCurrentStepKey = new StepKey("not-current", "not-current", "not-current");
         long now = randomNonNegativeLong();
         setStateToKey(notCurrentStepKey, now);
-        MoveToNextStepUpdateTask task = new MoveToNextStepUpdateTask(index, policy, currentStepKey, null, () -> now, null);
+        MoveToNextStepUpdateTask task = new MoveToNextStepUpdateTask(index, policy, currentStepKey, null,
+            () -> now, new AlwaysExistingStepRegistry(), null);
         ClusterState newState = task.execute(clusterState);
         assertSame(newState, clusterState);
     }
@@ -98,7 +100,8 @@ public void testExecuteDifferentPolicy() {
         long now = randomNonNegativeLong();
         setStateToKey(currentStepKey, now);
         setStatePolicy("not-" + policy);
-        MoveToNextStepUpdateTask task = new MoveToNextStepUpdateTask(index, policy, currentStepKey, null, () -> now, null);
+        MoveToNextStepUpdateTask task = new MoveToNextStepUpdateTask(index, policy, currentStepKey, null, () -> now,
+            new AlwaysExistingStepRegistry(), null);
         ClusterState newState = task.execute(clusterState);
         assertSame(newState, clusterState);
     }
@@ -113,10 +116,10 @@ public void testExecuteSuccessfulMoveWithInvalidNextStep() {
 
         SetOnce<Boolean> changed = new SetOnce<>();
         MoveToNextStepUpdateTask task = new MoveToNextStepUpdateTask(index, policy, currentStepKey,
-            invalidNextStep, () -> now, s -> changed.set(true));
+            invalidNextStep, () -> now, new AlwaysExistingStepRegistry(), s -> changed.set(true));
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey actualKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey actualKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(actualKey, equalTo(invalidNextStep));
         assertThat(lifecycleState.getPhaseTime(), equalTo(now));
         assertThat(lifecycleState.getActionTime(), equalTo(now));
@@ -132,7 +135,8 @@ public void testOnFailure() {
 
         setStateToKey(currentStepKey, now);
 
-        MoveToNextStepUpdateTask task = new MoveToNextStepUpdateTask(index, policy, currentStepKey, nextStepKey, () -> now, state -> {});
+        MoveToNextStepUpdateTask task = new MoveToNextStepUpdateTask(index, policy, currentStepKey, nextStepKey, () -> now,
+            new AlwaysExistingStepRegistry(), state -> {});
         Exception expectedException = new RuntimeException();
         ElasticsearchException exception = expectThrows(ElasticsearchException.class,
                 () -> task.onFailure(randomAlphaOfLength(10), expectedException));
@@ -141,6 +145,21 @@ public void testOnFailure() {
         assertSame(expectedException, exception.getCause());
     }
 
+    /**
+     * Fake policy steps registry that will always pass validation that the step exists
+     */
+    private static class AlwaysExistingStepRegistry extends PolicyStepsRegistry {
+
+        AlwaysExistingStepRegistry() {
+            super(new NamedXContentRegistry(Collections.emptyList()), null);
+        }
+
+        @Override
+        public boolean stepExists(String policy, StepKey stepKey) {
+            return true;
+        }
+    }
+
     private void setStatePolicy(String policy) {
         clusterState = ClusterState.builder(clusterState)
             .metaData(MetaData.builder(clusterState.metaData())
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/SetStepInfoUpdateTaskTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/SetStepInfoUpdateTaskTests.java
index 6224937f8dec2..d9924a2960aae 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/SetStepInfoUpdateTaskTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/SetStepInfoUpdateTaskTests.java
@@ -61,7 +61,7 @@ public void testExecuteSuccessfullySet() throws IOException {
         SetStepInfoUpdateTask task = new SetStepInfoUpdateTask(index, policy, currentStepKey, stepInfo);
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
-        StepKey actualKey = IndexLifecycleRunner.getCurrentStepKey(lifecycleState);
+        StepKey actualKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
         assertThat(actualKey, equalTo(currentStepKey));
         assertThat(lifecycleState.getPhaseTime(), nullValue());
         assertThat(lifecycleState.getActionTime(), nullValue());

From 261b57c176927532f961104b70629653afe1f3b0 Mon Sep 17 00:00:00 2001
From: Rafael Acevedo <raa7@cin.ufpe.br>
Date: Fri, 6 Dec 2019 15:38:15 -0300
Subject: [PATCH 102/686] Update jackson-databind to 2.8.11.4 (#49347)

---
 buildSrc/version.properties                                     | 1 +
 modules/ingest-geoip/build.gradle                               | 2 +-
 .../ingest-geoip/licenses/jackson-databind-2.8.11.3.jar.sha1    | 1 -
 .../ingest-geoip/licenses/jackson-databind-2.8.11.4.jar.sha1    | 1 +
 plugins/discovery-ec2/build.gradle                              | 2 +-
 .../discovery-ec2/licenses/jackson-databind-2.8.11.3.jar.sha1   | 1 -
 .../discovery-ec2/licenses/jackson-databind-2.8.11.4.jar.sha1   | 1 +
 plugins/repository-s3/build.gradle                              | 2 +-
 .../repository-s3/licenses/jackson-databind-2.8.11.3.jar.sha1   | 1 -
 .../repository-s3/licenses/jackson-databind-2.8.11.4.jar.sha1   | 1 +
 x-pack/snapshot-tool/build.gradle                               | 2 +-
 .../snapshot-tool/licenses/jackson-databind-2.8.11.3.jar.sha1   | 1 -
 .../snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1   | 1 +
 13 files changed, 9 insertions(+), 8 deletions(-)
 delete mode 100644 modules/ingest-geoip/licenses/jackson-databind-2.8.11.3.jar.sha1
 create mode 100644 modules/ingest-geoip/licenses/jackson-databind-2.8.11.4.jar.sha1
 delete mode 100644 plugins/discovery-ec2/licenses/jackson-databind-2.8.11.3.jar.sha1
 create mode 100644 plugins/discovery-ec2/licenses/jackson-databind-2.8.11.4.jar.sha1
 delete mode 100644 plugins/repository-s3/licenses/jackson-databind-2.8.11.3.jar.sha1
 create mode 100644 plugins/repository-s3/licenses/jackson-databind-2.8.11.4.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.3.jar.sha1
 create mode 100644 x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1

diff --git a/buildSrc/version.properties b/buildSrc/version.properties
index 12387d6a08440..6c7d6798a65c6 100644
--- a/buildSrc/version.properties
+++ b/buildSrc/version.properties
@@ -11,6 +11,7 @@ jts               = 1.15.0
 # you should also inspect that version to see if it can be advanced along with
 # the com.maxmind.geoip2:geoip2 dependency
 jackson           = 2.8.11
+jacksondatabind   = 2.8.11.4
 snakeyaml         = 1.17
 icu4j             = 62.1
 supercsv          = 2.4.0
diff --git a/modules/ingest-geoip/build.gradle b/modules/ingest-geoip/build.gradle
index b99bb66ee8dba..6b49c26c41570 100644
--- a/modules/ingest-geoip/build.gradle
+++ b/modules/ingest-geoip/build.gradle
@@ -29,7 +29,7 @@ dependencies {
   compile('com.maxmind.geoip2:geoip2:2.9.0')
   // geoip2 dependencies:
   compile("com.fasterxml.jackson.core:jackson-annotations:${versions.jackson}")
-  compile("com.fasterxml.jackson.core:jackson-databind:2.8.11.3")
+  compile("com.fasterxml.jackson.core:jackson-databind:${versions.jacksondatabind}")
   compile('com.maxmind.db:maxmind-db:1.2.2')
 
   testCompile 'org.elasticsearch:geolite2-databases:20191119'
diff --git a/modules/ingest-geoip/licenses/jackson-databind-2.8.11.3.jar.sha1 b/modules/ingest-geoip/licenses/jackson-databind-2.8.11.3.jar.sha1
deleted file mode 100644
index 253a1361931c3..0000000000000
--- a/modules/ingest-geoip/licenses/jackson-databind-2.8.11.3.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-844df5aba5a1a56e00905b165b12bb34116ee858
\ No newline at end of file
diff --git a/modules/ingest-geoip/licenses/jackson-databind-2.8.11.4.jar.sha1 b/modules/ingest-geoip/licenses/jackson-databind-2.8.11.4.jar.sha1
new file mode 100644
index 0000000000000..5203969bcf5c0
--- /dev/null
+++ b/modules/ingest-geoip/licenses/jackson-databind-2.8.11.4.jar.sha1
@@ -0,0 +1 @@
+596d6923ff4cf7ea72ded3ac32903b9c618ce9f1
\ No newline at end of file
diff --git a/plugins/discovery-ec2/build.gradle b/plugins/discovery-ec2/build.gradle
index 6824353e475e2..64b38a6cac74d 100644
--- a/plugins/discovery-ec2/build.gradle
+++ b/plugins/discovery-ec2/build.gradle
@@ -34,7 +34,7 @@ dependencies {
   compile "commons-logging:commons-logging:${versions.commonslogging}"
   compile "org.apache.logging.log4j:log4j-1.2-api:${versions.log4j}"
   compile "commons-codec:commons-codec:${versions.commonscodec}"
-  compile 'com.fasterxml.jackson.core:jackson-databind:2.8.11.3'
+  compile "com.fasterxml.jackson.core:jackson-databind:${versions.jacksondatabind}"
   compile "com.fasterxml.jackson.core:jackson-annotations:${versions.jackson}"
 }
 
diff --git a/plugins/discovery-ec2/licenses/jackson-databind-2.8.11.3.jar.sha1 b/plugins/discovery-ec2/licenses/jackson-databind-2.8.11.3.jar.sha1
deleted file mode 100644
index 253a1361931c3..0000000000000
--- a/plugins/discovery-ec2/licenses/jackson-databind-2.8.11.3.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-844df5aba5a1a56e00905b165b12bb34116ee858
\ No newline at end of file
diff --git a/plugins/discovery-ec2/licenses/jackson-databind-2.8.11.4.jar.sha1 b/plugins/discovery-ec2/licenses/jackson-databind-2.8.11.4.jar.sha1
new file mode 100644
index 0000000000000..5203969bcf5c0
--- /dev/null
+++ b/plugins/discovery-ec2/licenses/jackson-databind-2.8.11.4.jar.sha1
@@ -0,0 +1 @@
+596d6923ff4cf7ea72ded3ac32903b9c618ce9f1
\ No newline at end of file
diff --git a/plugins/repository-s3/build.gradle b/plugins/repository-s3/build.gradle
index 73ce5c2316c3b..e26fa43188b44 100644
--- a/plugins/repository-s3/build.gradle
+++ b/plugins/repository-s3/build.gradle
@@ -43,7 +43,7 @@ dependencies {
   compile "org.apache.logging.log4j:log4j-1.2-api:${versions.log4j}"
   compile "commons-codec:commons-codec:${versions.commonscodec}"
   compile "com.fasterxml.jackson.core:jackson-core:${versions.jackson}"
-  compile 'com.fasterxml.jackson.core:jackson-databind:2.8.11.3'
+  compile "com.fasterxml.jackson.core:jackson-databind:${versions.jacksondatabind}"
   compile "com.fasterxml.jackson.core:jackson-annotations:${versions.jackson}"
   compile "com.fasterxml.jackson.dataformat:jackson-dataformat-cbor:${versions.jackson}"
   compile "joda-time:joda-time:${versions.joda}"
diff --git a/plugins/repository-s3/licenses/jackson-databind-2.8.11.3.jar.sha1 b/plugins/repository-s3/licenses/jackson-databind-2.8.11.3.jar.sha1
deleted file mode 100644
index 253a1361931c3..0000000000000
--- a/plugins/repository-s3/licenses/jackson-databind-2.8.11.3.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-844df5aba5a1a56e00905b165b12bb34116ee858
\ No newline at end of file
diff --git a/plugins/repository-s3/licenses/jackson-databind-2.8.11.4.jar.sha1 b/plugins/repository-s3/licenses/jackson-databind-2.8.11.4.jar.sha1
new file mode 100644
index 0000000000000..5203969bcf5c0
--- /dev/null
+++ b/plugins/repository-s3/licenses/jackson-databind-2.8.11.4.jar.sha1
@@ -0,0 +1 @@
+596d6923ff4cf7ea72ded3ac32903b9c618ce9f1
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/build.gradle b/x-pack/snapshot-tool/build.gradle
index 917062d54126e..5717dfd9cf230 100644
--- a/x-pack/snapshot-tool/build.gradle
+++ b/x-pack/snapshot-tool/build.gradle
@@ -23,7 +23,7 @@ dependencies {
   compile "commons-codec:commons-codec:${versions.commonscodec}"
   compile "org.apache.logging.log4j:log4j-1.2-api:${versions.log4j}"
   compile "com.fasterxml.jackson.core:jackson-core:${versions.jackson}"
-  compile 'com.fasterxml.jackson.core:jackson-databind:2.8.11.3'
+  compile "com.fasterxml.jackson.core:jackson-databind:${versions.jacksondatabind}"
   compile "com.fasterxml.jackson.core:jackson-annotations:${versions.jackson}"
 
   // GCS dependencies
diff --git a/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.3.jar.sha1 b/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.3.jar.sha1
deleted file mode 100644
index 253a1361931c3..0000000000000
--- a/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.3.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-844df5aba5a1a56e00905b165b12bb34116ee858
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1 b/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1
new file mode 100644
index 0000000000000..5203969bcf5c0
--- /dev/null
+++ b/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1
@@ -0,0 +1 @@
+596d6923ff4cf7ea72ded3ac32903b9c618ce9f1
\ No newline at end of file

From f2b233cd8fa1d69b87685044dd007ea64f4b5880 Mon Sep 17 00:00:00 2001
From: Stuart Tettemer <stu@elastic.co>
Date: Fri, 6 Dec 2019 13:09:44 -0700
Subject: [PATCH 103/686] Scripting: Groundwork for caching script results
 (#49895)

In order to cache script results in the query shard cache, we need to
check if scripts are deterministic.  This change adds a default method
to the script factories, `isResultDeterministic() -> false` which is
used by the `QueryShardContext`.

Script results were never cached and that does not change here.  Future
changes will implement this method based on whether the results of the
scripts are deterministic or not and therefore cacheable.

Refs: #49466
---
 .../common/AnalysisPredicateScript.java       |  3 +-
 .../PredicateTokenScriptFilterTests.java      |  3 +-
 .../ScriptedConditionTokenFilterTests.java    |  3 +-
 .../expression/ExpressionScriptEngine.java    |  8 ++-
 .../script/mustache/MustacheScriptEngine.java |  8 ++-
 .../painless/PainlessScriptEngine.java        | 27 +++++++---
 .../action/PainlessExecuteAction.java         |  3 +-
 .../painless/BaseClassTests.java              | 53 ++++++++++---------
 .../painless/BasicStatementTests.java         |  3 +-
 .../elasticsearch/painless/BindingsTests.java |  3 +-
 .../elasticsearch/painless/FactoryTests.java  |  7 +--
 .../expertscript/ExpertScriptPlugin.java      | 47 ++++++++++++----
 .../index/query/InnerHitContextBuilder.java   |  2 +-
 .../index/query/IntervalFilterScript.java     |  3 +-
 .../index/query/IntervalsSourceProvider.java  |  2 +-
 .../index/query/QueryShardContext.java        | 14 +++--
 .../index/query/ScriptQueryBuilder.java       |  2 +-
 .../index/query/TermsSetQueryBuilder.java     |  4 +-
 .../ScriptScoreFunctionBuilder.java           |  2 +-
 .../ScriptScoreQueryBuilder.java              |  2 +-
 .../script/AggregationScript.java             |  2 +-
 .../script/BucketAggregationScript.java       |  2 +-
 .../BucketAggregationSelectorScript.java      |  2 +-
 .../org/elasticsearch/script/FieldScript.java |  2 +-
 .../elasticsearch/script/FilterScript.java    |  2 +-
 .../script/IngestConditionalScript.java       |  2 +-
 .../elasticsearch/script/IngestScript.java    |  2 +-
 .../script/NumberSortScript.java              |  2 +-
 .../org/elasticsearch/script/ScoreScript.java |  2 +-
 .../elasticsearch/script/ScriptContext.java   |  2 +-
 .../elasticsearch/script/ScriptEngine.java    |  7 ++-
 .../elasticsearch/script/ScriptFactory.java   | 28 ++++++++++
 .../elasticsearch/script/ScriptService.java   |  2 +-
 .../script/ScriptedMetricAggContexts.java     |  8 +--
 .../SignificantTermsHeuristicScoreScript.java |  2 +-
 .../script/SimilarityScript.java              |  4 +-
 .../script/SimilarityWeightScript.java        |  2 +-
 .../script/StringSortScript.java              |  2 +-
 .../elasticsearch/script/TemplateScript.java  |  2 +-
 .../script/TermsSetQueryScript.java           |  2 +-
 .../elasticsearch/script/UpdateScript.java    |  2 +-
 .../heuristics/ScriptHeuristic.java           |  2 +-
 .../ScriptedMetricAggregationBuilder.java     |  6 +--
 .../metrics/TopHitsAggregationBuilder.java    |  2 +-
 .../pipeline/MovingFunctionScript.java        |  3 +-
 .../support/ValuesSourceConfig.java           |  2 +-
 .../search/sort/ScriptSortBuilder.java        |  4 +-
 .../phrase/PhraseSuggestionBuilder.java       |  2 +-
 .../query/IntervalQueryBuilderTests.java      |  3 +-
 .../script/ScriptContextTests.java            | 12 ++---
 .../script/ScriptLanguagesInfoTests.java      |  2 +-
 .../functionscore/ExplainableScriptIT.java    |  8 ++-
 .../search/suggest/SuggestSearchIT.java       |  8 ++-
 .../ingest/TestTemplateService.java           |  3 +-
 .../script/MockScriptEngine.java              |  2 +-
 .../script/MockMustacheScriptEngine.java      |  2 +-
 .../test/MockPainlessScriptEngine.java        |  3 +-
 .../condition/WatcherConditionScript.java     |  3 +-
 .../script/WatcherTransformScript.java        |  3 +-
 59 files changed, 236 insertions(+), 114 deletions(-)
 create mode 100644 server/src/main/java/org/elasticsearch/script/ScriptFactory.java

diff --git a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/AnalysisPredicateScript.java b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/AnalysisPredicateScript.java
index 5d8c491efc585..f14bd9ded9cc1 100644
--- a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/AnalysisPredicateScript.java
+++ b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/AnalysisPredicateScript.java
@@ -27,6 +27,7 @@
 import org.apache.lucene.analysis.tokenattributes.TypeAttribute;
 import org.apache.lucene.util.AttributeSource;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 
 /**
  * A predicate based on the current token in a TokenStream
@@ -107,7 +108,7 @@ public boolean isKeyword() {
      */
     public abstract boolean execute(Token token);
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         AnalysisPredicateScript newInstance();
     }
 
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PredicateTokenScriptFilterTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PredicateTokenScriptFilterTests.java
index 84ba5e5d3373c..9e61a59237348 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PredicateTokenScriptFilterTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PredicateTokenScriptFilterTests.java
@@ -30,6 +30,7 @@
 import org.elasticsearch.indices.analysis.AnalysisModule;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.test.ESTokenStreamTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
@@ -63,7 +64,7 @@ public boolean execute(Token token) {
         @SuppressWarnings("unchecked")
         ScriptService scriptService = new ScriptService(indexSettings, Collections.emptyMap(), Collections.emptyMap()){
             @Override
-            public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+            public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
                 assertEquals(context, AnalysisPredicateScript.CONTEXT);
                 assertEquals(new Script("my_script"), script);
                 return (FactoryType) factory;
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/ScriptedConditionTokenFilterTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/ScriptedConditionTokenFilterTests.java
index 58226ac169bc3..d2bbc780c8747 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/ScriptedConditionTokenFilterTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/ScriptedConditionTokenFilterTests.java
@@ -30,6 +30,7 @@
 import org.elasticsearch.indices.analysis.AnalysisModule;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.test.ESTokenStreamTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
@@ -63,7 +64,7 @@ public boolean execute(Token token) {
         @SuppressWarnings("unchecked")
         ScriptService scriptService = new ScriptService(indexSettings, Collections.emptyMap(), Collections.emptyMap()){
             @Override
-            public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+            public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
                 assertEquals(context, AnalysisPredicateScript.CONTEXT);
                 assertEquals(new Script("token.getPosition() > 1"), script);
                 return (FactoryType) factory;
diff --git a/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java b/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
index 3df42b53cbb34..ead6d733b10de 100644
--- a/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
+++ b/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
@@ -44,6 +44,7 @@
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
 import org.elasticsearch.script.ScriptException;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.TermsSetQueryScript;
 import org.elasticsearch.search.lookup.SearchLookup;
 
@@ -108,7 +109,12 @@ public String getType() {
     }
 
     @Override
-    public <T> T compile(String scriptName, String scriptSource, ScriptContext<T> context, Map<String, String> params) {
+    public <T extends ScriptFactory> T compile(
+        String scriptName,
+        String scriptSource,
+        ScriptContext<T> context,
+        Map<String, String> params
+    ) {
         // classloader created here
         final SecurityManager sm = System.getSecurityManager();
         SpecialPermission.check();
diff --git a/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java b/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
index f453905089fdd..f14dd35d339fd 100644
--- a/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
+++ b/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
 import org.elasticsearch.script.ScriptException;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.TemplateScript;
 
 import java.io.Reader;
@@ -64,7 +65,12 @@ public final class MustacheScriptEngine implements ScriptEngine {
      * @return a compiled template object for later execution.
      * */
     @Override
-    public <T> T compile(String templateName, String templateSource, ScriptContext<T> context, Map<String, String> options) {
+    public <T extends ScriptFactory> T compile(
+        String templateName,
+        String templateSource,
+        ScriptContext<T> context,
+        Map<String, String> options
+    ) {
         if (context.instanceClazz.equals(TemplateScript.class) == false) {
             throw new IllegalArgumentException("mustache engine does not know how to handle context [" + context.name + "]");
         }
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
index 7f64e992bc122..91448a4a3788e 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
 import org.elasticsearch.script.ScriptException;
+import org.elasticsearch.script.ScriptFactory;
 import org.objectweb.asm.ClassWriter;
 import org.objectweb.asm.Opcodes;
 import org.objectweb.asm.Type;
@@ -66,7 +67,7 @@ public final class PainlessScriptEngine implements ScriptEngine {
      */
     private static final AccessControlContext COMPILATION_CONTEXT;
 
-    /**
+    /*
      * Setup the allowed permissions.
      */
     static {
@@ -122,7 +123,12 @@ public String getType() {
     }
 
     @Override
-    public <T> T compile(String scriptName, String scriptSource, ScriptContext<T> context, Map<String, String> params) {
+    public <T extends ScriptFactory> T compile(
+        String scriptName,
+        String scriptSource,
+        ScriptContext<T> context,
+        Map<String, String> params
+    ) {
         Compiler compiler = contextsToCompilers.get(context);
 
         // Check we ourselves are not being called by unprivileged code.
@@ -162,12 +168,16 @@ public Set<ScriptContext<?>> getSupportedContexts() {
      * @param <T> The factory class.
      * @return A factory class that will return script instances.
      */
-    private <T> Type generateStatefulFactory(Loader loader, ScriptContext<T> context, Set<String> extractedVariables) {
+    private <T extends ScriptFactory> Type generateStatefulFactory(
+        Loader loader,
+        ScriptContext<T> context,
+        Set<String> extractedVariables
+    ) {
         int classFrames = ClassWriter.COMPUTE_FRAMES | ClassWriter.COMPUTE_MAXS;
         int classAccess = Opcodes.ACC_PUBLIC | Opcodes.ACC_SUPER | Opcodes.ACC_FINAL;
         String interfaceBase = Type.getType(context.statefulFactoryClazz).getInternalName();
         String className = interfaceBase + "$StatefulFactory";
-        String classInterfaces[] = new String[] { interfaceBase };
+        String[] classInterfaces = new String[] { interfaceBase };
 
         ClassWriter writer = new ClassWriter(classFrames);
         writer.visit(WriterConstants.CLASS_VERSION, classAccess, className, null, OBJECT_TYPE.getInternalName(), classInterfaces);
@@ -263,12 +273,17 @@ private <T> Type generateStatefulFactory(Loader loader, ScriptContext<T> context
      * @param <T> The factory class.
      * @return A factory class that will return script instances.
      */
-    private <T> T generateFactory(Loader loader, ScriptContext<T> context, Set<String> extractedVariables, Type classType) {
+    private <T extends ScriptFactory> T generateFactory(
+        Loader loader,
+        ScriptContext<T> context,
+        Set<String> extractedVariables,
+        Type classType
+    ) {
         int classFrames = ClassWriter.COMPUTE_FRAMES | ClassWriter.COMPUTE_MAXS;
         int classAccess = Opcodes.ACC_PUBLIC | Opcodes.ACC_SUPER| Opcodes.ACC_FINAL;
         String interfaceBase = Type.getType(context.factoryClazz).getInternalName();
         String className = interfaceBase + "$Factory";
-        String classInterfaces[] = new String[] { interfaceBase };
+        String[] classInterfaces = new String[] { interfaceBase };
 
         ClassWriter writer = new ClassWriter(classFrames);
         writer.visit(WriterConstants.CLASS_VERSION, classAccess, className, null, OBJECT_TYPE.getInternalName(), classInterfaces);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/action/PainlessExecuteAction.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/action/PainlessExecuteAction.java
index b6bb1a842640d..e38d87e69ccb3 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/action/PainlessExecuteAction.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/action/PainlessExecuteAction.java
@@ -75,6 +75,7 @@
 import org.elasticsearch.script.ScoreScript;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.threadpool.ThreadPool;
@@ -415,7 +416,7 @@ public Map<String, Object> getParams() {
 
         public abstract Object execute();
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
 
             PainlessTestScript newInstance(Map<String, Object> params);
 
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BaseClassTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BaseClassTests.java
index ae96c8b3b7944..96790301139f3 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BaseClassTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BaseClassTests.java
@@ -21,6 +21,7 @@
 
 import org.elasticsearch.painless.spi.Whitelist;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 
 import java.util.Collections;
 import java.util.HashMap;
@@ -65,7 +66,7 @@ protected Map<ScriptContext<?>, List<Whitelist>> scriptContexts() {
 
     public abstract static class Gets {
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             Gets newInstance(String testString, int testInt, Map<String, Object> params);
         }
 
@@ -111,7 +112,7 @@ public void testGets() throws Exception {
     }
 
     public abstract static class NoArgs {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             NoArgs newInstance();
         }
 
@@ -137,7 +138,7 @@ public void testNoArgs() throws Exception {
     }
 
     public abstract static class OneArg {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             OneArg newInstance();
         }
 
@@ -154,7 +155,7 @@ public void testOneArg() throws Exception {
     }
 
     public abstract static class ArrayArg {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             ArrayArg newInstance();
         }
 
@@ -171,7 +172,7 @@ public void testArrayArg() throws Exception {
     }
 
     public abstract static class PrimitiveArrayArg {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             PrimitiveArrayArg newInstance();
         }
 
@@ -188,7 +189,7 @@ public void testPrimitiveArrayArg() throws Exception {
     }
 
     public abstract static class DefArrayArg {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             DefArrayArg newInstance();
         }
 
@@ -212,7 +213,7 @@ public void testDefArrayArg()throws Exception {
     }
 
     public abstract static class ManyArgs {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             ManyArgs newInstance();
         }
 
@@ -251,7 +252,7 @@ public void testManyArgs() throws Exception {
     }
 
     public abstract static class VarArgs {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             VarArgs newInstance();
         }
 
@@ -267,7 +268,7 @@ public void testVarArgs() throws Exception {
     }
 
     public abstract static class DefaultMethods {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             DefaultMethods newInstance();
         }
 
@@ -301,7 +302,7 @@ public void testDefaultMethods() throws Exception {
     }
 
     public abstract static class ReturnsVoid {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             ReturnsVoid newInstance();
         }
 
@@ -325,7 +326,7 @@ public void testReturnsVoid() throws Exception {
     }
 
     public abstract static class ReturnsPrimitiveBoolean {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             ReturnsPrimitiveBoolean newInstance();
         }
 
@@ -391,20 +392,20 @@ public void testReturnsPrimitiveBoolean() throws Exception {
     }
 
     public abstract static class ReturnsPrimitiveInt {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             ReturnsPrimitiveInt newInstance();
         }
 
         public static final ScriptContext<Factory> CONTEXT = new ScriptContext<>("returnsprimitiveint", Factory.class);
-        
+
         public static final String[] PARAMETERS = new String[] {};
         public abstract int execute();
     }
     public void testReturnsPrimitiveInt() throws Exception {
-        assertEquals(1, 
+        assertEquals(1,
                 scriptEngine.compile("testReturnsPrimitiveInt0", "1", ReturnsPrimitiveInt.CONTEXT, emptyMap())
                         .newInstance().execute());
-        assertEquals(1, 
+        assertEquals(1,
                 scriptEngine.compile("testReturnsPrimitiveInt1", "(int) 1L", ReturnsPrimitiveInt.CONTEXT, emptyMap())
                         .newInstance().execute());
         assertEquals(1, scriptEngine.compile("testReturnsPrimitiveInt2", "(int) 1.1d", ReturnsPrimitiveInt.CONTEXT, emptyMap())
@@ -455,12 +456,12 @@ public void testReturnsPrimitiveInt() throws Exception {
     }
 
     public abstract static class ReturnsPrimitiveFloat {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             ReturnsPrimitiveFloat newInstance();
         }
 
         public static final ScriptContext<Factory> CONTEXT = new ScriptContext<>("returnsprimitivefloat", Factory.class);
-        
+
         public static final String[] PARAMETERS = new String[] {};
         public abstract float execute();
     }
@@ -504,12 +505,12 @@ public void testReturnsPrimitiveFloat() throws Exception {
     }
 
    public abstract static class ReturnsPrimitiveDouble {
-       public interface Factory {
+       public interface Factory extends ScriptFactory {
            ReturnsPrimitiveDouble newInstance();
        }
 
        public static final ScriptContext<Factory> CONTEXT = new ScriptContext<>("returnsprimitivedouble", Factory.class);
-        
+
         public static final String[] PARAMETERS = new String[] {};
         public abstract double execute();
     }
@@ -567,7 +568,7 @@ public void testReturnsPrimitiveDouble() throws Exception {
     }
 
     public abstract static class NoArgsConstant {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             NoArgsConstant newInstance();
         }
 
@@ -584,7 +585,7 @@ public void testNoArgsConstant() {
     }
 
     public abstract static class WrongArgsConstant {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             WrongArgsConstant newInstance();
         }
 
@@ -602,7 +603,7 @@ public void testWrongArgsConstant() {
     }
 
     public abstract static class WrongLengthOfArgConstant {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             WrongLengthOfArgConstant newInstance();
         }
 
@@ -619,7 +620,7 @@ public void testWrongLengthOfArgConstant() {
     }
 
     public abstract static class UnknownArgType {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             UnknownArgType newInstance();
         }
 
@@ -636,7 +637,7 @@ public void testUnknownArgType() {
     }
 
     public abstract static class UnknownReturnType {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             UnknownReturnType newInstance();
         }
 
@@ -653,7 +654,7 @@ public void testUnknownReturnType() {
     }
 
     public abstract static class UnknownArgTypeInArray {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             UnknownArgTypeInArray newInstance();
         }
 
@@ -670,7 +671,7 @@ public void testUnknownArgTypeInArray() {
     }
 
     public abstract static class TwoExecuteMethods {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             TwoExecuteMethods newInstance();
         }
 
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BasicStatementTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BasicStatementTests.java
index e4d1db2243b82..72fc01dbf2ce6 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BasicStatementTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BasicStatementTests.java
@@ -2,6 +2,7 @@
 
 import org.elasticsearch.painless.spi.Whitelist;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 
 import java.util.ArrayList;
 import java.util.Collections;
@@ -260,7 +261,7 @@ public void testReturnStatement() {
     }
 
     public abstract static class OneArg {
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             OneArg newInstance();
         }
 
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BindingsTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BindingsTests.java
index 171880abd7907..d165e0ef76d81 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BindingsTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BindingsTests.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.painless.spi.WhitelistInstanceBinding;
 import org.elasticsearch.painless.spi.WhitelistLoader;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 
 import java.util.ArrayList;
 import java.util.Collections;
@@ -89,7 +90,7 @@ public abstract static class BindingsTestScript {
         public static final String[] PARAMETERS = { "test", "bound" };
         public int getTestValue() {return 7;}
         public abstract int execute(int test, int bound);
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             BindingsTestScript newInstance();
         }
         public static final ScriptContext<Factory> CONTEXT = new ScriptContext<>("bindings_test", Factory.class);
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
index 556ef8dd3c6d3..1d3fd829d2512 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
@@ -21,6 +21,7 @@
 
 import org.elasticsearch.painless.spi.Whitelist;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.TemplateScript;
 
 import java.util.Collections;
@@ -84,7 +85,7 @@ public interface StatefulFactory {
             boolean needsD();
         }
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             StatefulFactory newFactory(int x, int y);
 
             boolean needsTest();
@@ -137,7 +138,7 @@ public Map<String, Object> getParams() {
         public static final String[] PARAMETERS = new String[] {"test"};
         public abstract Object execute(int test);
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             FactoryTestScript newInstance(Map<String, Object> params);
 
             boolean needsTest();
@@ -165,7 +166,7 @@ public abstract static class EmptyTestScript {
         public static final String[] PARAMETERS = {};
         public abstract Object execute();
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             EmptyTestScript newInstance();
         }
 
diff --git a/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java b/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
index 5259d32a2837b..5846f000f5e2d 100644
--- a/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
+++ b/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.script.ScoreScript.LeafFactory;
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.search.lookup.SearchLookup;
 
 import java.io.IOException;
@@ -38,16 +39,21 @@
 import java.util.Set;
 
 /**
- * An example script plugin that adds a {@link ScriptEngine} implementing expert scoring.
+ * An example script plugin that adds a {@link ScriptEngine}
+ * implementing expert scoring.
  */
 public class ExpertScriptPlugin extends Plugin implements ScriptPlugin {
 
     @Override
-    public ScriptEngine getScriptEngine(Settings settings, Collection<ScriptContext<?>> contexts) {
+    public ScriptEngine getScriptEngine(
+        Settings settings,
+        Collection<ScriptContext<?>> contexts
+    ) {
         return new MyExpertScriptEngine();
     }
 
-    /** An example {@link ScriptEngine} that uses Lucene segment details to implement pure document frequency scoring. */
+    /** An example {@link ScriptEngine} that uses Lucene segment details to
+     *  implement pure document frequency scoring. */
     // tag::expert_engine
     private static class MyExpertScriptEngine implements ScriptEngine {
         @Override
@@ -56,8 +62,12 @@ public String getType() {
         }
 
         @Override
-        public <T> T compile(String scriptName, String scriptSource,
-                ScriptContext<T> context, Map<String, String> params) {
+        public <T extends ScriptFactory> T compile(
+            String scriptName,
+            String scriptSource,
+            ScriptContext<T> context,
+            Map<String, String> params
+        ) {
             if (context.equals(ScoreScript.CONTEXT) == false) {
                 throw new IllegalArgumentException(getType()
                         + " scripts cannot be used for context ["
@@ -65,7 +75,7 @@ public <T> T compile(String scriptName, String scriptSource,
             }
             // we use the script "source" as the script identifier
             if ("pure_df".equals(scriptSource)) {
-                ScoreScript.Factory factory = PureDfLeafFactory::new;
+                ScoreScript.Factory factory = new PureDfFactory();
                 return context.factoryClazz.cast(factory);
             }
             throw new IllegalArgumentException("Unknown script name "
@@ -82,6 +92,23 @@ public Set<ScriptContext<?>> getSupportedContexts() {
             return Set.of(ScoreScript.CONTEXT);
         }
 
+        private static class PureDfFactory implements ScoreScript.Factory {
+            @Override
+            public boolean isResultDeterministic() {
+                // PureDfLeafFactory only uses deterministic APIs, this
+                // implies the results are cacheable.
+                return true;
+            }
+
+            @Override
+            public LeafFactory newFactory(
+                Map<String, Object> params,
+                SearchLookup lookup
+            ) {
+                return new PureDfLeafFactory(params, lookup);
+            }
+        }
+
         private static class PureDfLeafFactory implements LeafFactory {
             private final Map<String, Object> params;
             private final SearchLookup lookup;
@@ -121,7 +148,9 @@ public ScoreScript newInstance(LeafReaderContext context)
                      */
                     return new ScoreScript(params, lookup, context) {
                         @Override
-                        public double execute(ExplanationHolder explanation) {
+                        public double execute(
+                            ExplanationHolder explanation
+                        ) {
                             return 0.0d;
                         }
                     };
@@ -147,8 +176,8 @@ public void setDocument(int docid) {
                     public double execute(ExplanationHolder explanation) {
                         if (postings.docID() != currentDocid) {
                             /*
-                             * advance moved past the current doc, so this doc
-                             * has no occurrences of the term
+                             * advance moved past the current doc, so this
+                             * doc has no occurrences of the term
                              */
                             return 0.0d;
                         }
diff --git a/server/src/main/java/org/elasticsearch/index/query/InnerHitContextBuilder.java b/server/src/main/java/org/elasticsearch/index/query/InnerHitContextBuilder.java
index 23cb8ab955370..845a3539e9e85 100644
--- a/server/src/main/java/org/elasticsearch/index/query/InnerHitContextBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/InnerHitContextBuilder.java
@@ -93,7 +93,7 @@ protected void setupInnerHitsContext(QueryShardContext queryShardContext,
         if (innerHitBuilder.getScriptFields() != null) {
             for (SearchSourceBuilder.ScriptField field : innerHitBuilder.getScriptFields()) {
                 QueryShardContext innerContext = innerHitsContext.getQueryShardContext();
-                FieldScript.Factory factory = innerContext.getScriptService().compile(field.script(), FieldScript.CONTEXT);
+                FieldScript.Factory factory = innerContext.compile(field.script(), FieldScript.CONTEXT);
                 FieldScript.LeafFactory fieldScript = factory.newFactory(field.script().getParams(), innerHitsContext.lookup());
                 innerHitsContext.scriptFields().add(new org.elasticsearch.search.fetch.subphase.ScriptFieldsContext.ScriptField(
                     field.fieldName(), fieldScript, field.ignoreFailure()));
diff --git a/server/src/main/java/org/elasticsearch/index/query/IntervalFilterScript.java b/server/src/main/java/org/elasticsearch/index/query/IntervalFilterScript.java
index 1f86179dca73c..2d0fc99258c4d 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IntervalFilterScript.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IntervalFilterScript.java
@@ -21,6 +21,7 @@
 
 import org.apache.lucene.queries.intervals.IntervalIterator;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 
 /**
  * Base class for scripts used as interval filters, see {@link IntervalsSourceProvider.IntervalFilter}
@@ -50,7 +51,7 @@ public int getGaps() {
 
     public abstract boolean execute(Interval interval);
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         IntervalFilterScript newInstance();
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
index 97093f0c92fc9..167266e0892fd 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
@@ -717,7 +717,7 @@ public IntervalFilter(StreamInput in) throws IOException {
 
         public IntervalsSource filter(IntervalsSource input, QueryShardContext context, MappedFieldType fieldType) throws IOException {
             if (script != null) {
-                IntervalFilterScript ifs = context.getScriptService().compile(script, IntervalFilterScript.CONTEXT).newInstance();
+                IntervalFilterScript ifs = context.compile(script, IntervalFilterScript.CONTEXT).newInstance();
                 return new ScriptFilterSource(input, script.getIdOrCode(), ifs);
             }
             IntervalsSource filterSource = filter.getSource(context, fieldType);
diff --git a/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java b/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
index c599fbcb4274e..88a8351790c0a 100644
--- a/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
+++ b/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
@@ -52,6 +52,9 @@
 import org.elasticsearch.index.mapper.TypeFieldMapper;
 import org.elasticsearch.index.query.support.NestedScope;
 import org.elasticsearch.index.similarity.SimilarityService;
+import org.elasticsearch.script.Script;
+import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.search.lookup.SearchLookup;
 import org.elasticsearch.transport.RemoteClusterAware;
@@ -319,10 +322,13 @@ public Index index() {
         return indexSettings.getIndex();
     }
 
-    /** Return the script service to allow compiling scripts. */
-    public final ScriptService getScriptService() {
-        failIfFrozen();
-        return scriptService;
+    /** Compile script using script service */
+    public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+        FactoryType factory = scriptService.compile(script, context);
+        if (factory.isResultDeterministic() == false) {
+            failIfFrozen();
+        }
+        return factory;
     }
 
     /**
diff --git a/server/src/main/java/org/elasticsearch/index/query/ScriptQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/ScriptQueryBuilder.java
index 8a3666afb9d12..e9b18bd0aa1f1 100644
--- a/server/src/main/java/org/elasticsearch/index/query/ScriptQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/ScriptQueryBuilder.java
@@ -130,7 +130,7 @@ public static ScriptQueryBuilder fromXContent(XContentParser parser) throws IOEx
 
     @Override
     protected Query doToQuery(QueryShardContext context) throws IOException {
-        FilterScript.Factory factory = context.getScriptService().compile(script, FilterScript.CONTEXT);
+        FilterScript.Factory factory = context.compile(script, FilterScript.CONTEXT);
         FilterScript.LeafFactory filterScript = factory.newFactory(script.getParams(), context.lookup());
         return new ScriptQuery(script, filterScript);
     }
diff --git a/server/src/main/java/org/elasticsearch/index/query/TermsSetQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/TermsSetQueryBuilder.java
index 1e151896df046..ac2526d34325a 100644
--- a/server/src/main/java/org/elasticsearch/index/query/TermsSetQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/TermsSetQueryBuilder.java
@@ -40,6 +40,7 @@
 import org.elasticsearch.index.fielddata.IndexNumericFieldData;
 import org.elasticsearch.index.mapper.MappedFieldType;
 import org.elasticsearch.script.Script;
+import org.elasticsearch.script.TermsSetQueryScript;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -47,7 +48,6 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
-import org.elasticsearch.script.TermsSetQueryScript;
 
 public final class TermsSetQueryBuilder extends AbstractQueryBuilder<TermsSetQueryBuilder> {
 
@@ -262,7 +262,7 @@ private LongValuesSource createValuesSource(QueryShardContext context) {
             IndexNumericFieldData fieldData = context.getForField(msmFieldType);
             longValuesSource = new FieldValuesSource(fieldData);
         } else if (minimumShouldMatchScript != null) {
-            TermsSetQueryScript.Factory factory = context.getScriptService().compile(minimumShouldMatchScript,
+            TermsSetQueryScript.Factory factory = context.compile(minimumShouldMatchScript,
                 TermsSetQueryScript.CONTEXT);
             Map<String, Object> params = new HashMap<>();
             params.putAll(minimumShouldMatchScript.getParams());
diff --git a/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreFunctionBuilder.java b/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreFunctionBuilder.java
index 8fc2d4ff6b1a4..3d5326d5f3da0 100644
--- a/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreFunctionBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreFunctionBuilder.java
@@ -92,7 +92,7 @@ protected int doHashCode() {
     @Override
     protected ScoreFunction doToFunction(QueryShardContext context) {
         try {
-            ScoreScript.Factory factory = context.getScriptService().compile(script, ScoreScript.CONTEXT);
+            ScoreScript.Factory factory = context.compile(script, ScoreScript.CONTEXT);
             ScoreScript.LeafFactory searchScript = factory.newFactory(script.getParams(), context.lookup());
             return new ScriptScoreFunction(script, searchScript,
                 context.index().getName(), context.getShardId(), context.indexVersionCreated());
diff --git a/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreQueryBuilder.java
index 59086f163a17f..e55c6d318777a 100644
--- a/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreQueryBuilder.java
@@ -170,7 +170,7 @@ protected int doHashCode() {
 
     @Override
     protected Query doToQuery(QueryShardContext context) throws IOException {
-        ScoreScript.Factory factory = context.getScriptService().compile(script, ScoreScript.CONTEXT);
+        ScoreScript.Factory factory = context.compile(script, ScoreScript.CONTEXT);
         ScoreScript.LeafFactory scoreScriptFactory = factory.newFactory(script.getParams(), context.lookup());
         Query query = this.query.toQuery(context);
         return new ScriptScoreQuery(query, script, scoreScriptFactory, minScore,
diff --git a/server/src/main/java/org/elasticsearch/script/AggregationScript.java b/server/src/main/java/org/elasticsearch/script/AggregationScript.java
index d6ef2e7b14be2..4d264445d25f0 100644
--- a/server/src/main/java/org/elasticsearch/script/AggregationScript.java
+++ b/server/src/main/java/org/elasticsearch/script/AggregationScript.java
@@ -150,7 +150,7 @@ public interface LeafFactory {
     /**
      * A factory to construct stateful {@link AggregationScript} factories for a specific index.
      */
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/BucketAggregationScript.java b/server/src/main/java/org/elasticsearch/script/BucketAggregationScript.java
index 76ff776353ef2..897134173537a 100644
--- a/server/src/main/java/org/elasticsearch/script/BucketAggregationScript.java
+++ b/server/src/main/java/org/elasticsearch/script/BucketAggregationScript.java
@@ -48,7 +48,7 @@ public Map<String, Object> getParams() {
 
     public abstract Number execute();
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         BucketAggregationScript newInstance(Map<String, Object> params);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/BucketAggregationSelectorScript.java b/server/src/main/java/org/elasticsearch/script/BucketAggregationSelectorScript.java
index a8e2fad7cdcda..3c765439223d2 100644
--- a/server/src/main/java/org/elasticsearch/script/BucketAggregationSelectorScript.java
+++ b/server/src/main/java/org/elasticsearch/script/BucketAggregationSelectorScript.java
@@ -48,7 +48,7 @@ public Map<String, Object> getParams() {
 
     public abstract boolean execute();
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         BucketAggregationSelectorScript newInstance(Map<String, Object> params);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/FieldScript.java b/server/src/main/java/org/elasticsearch/script/FieldScript.java
index 806c5b92cb9e3..06666368d5ade 100644
--- a/server/src/main/java/org/elasticsearch/script/FieldScript.java
+++ b/server/src/main/java/org/elasticsearch/script/FieldScript.java
@@ -87,7 +87,7 @@ public interface LeafFactory {
         FieldScript newInstance(LeafReaderContext ctx) throws IOException;
     }
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/script/FilterScript.java b/server/src/main/java/org/elasticsearch/script/FilterScript.java
index 500ab99c6a56b..166a2b59ffa3f 100644
--- a/server/src/main/java/org/elasticsearch/script/FilterScript.java
+++ b/server/src/main/java/org/elasticsearch/script/FilterScript.java
@@ -70,7 +70,7 @@ public interface LeafFactory {
     }
 
     /** A factory to construct stateful {@link FilterScript} factories for a specific index. */
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/script/IngestConditionalScript.java b/server/src/main/java/org/elasticsearch/script/IngestConditionalScript.java
index 27ce29b95dc50..44d87cfe6aba2 100644
--- a/server/src/main/java/org/elasticsearch/script/IngestConditionalScript.java
+++ b/server/src/main/java/org/elasticsearch/script/IngestConditionalScript.java
@@ -45,7 +45,7 @@ public Map<String, Object> getParams() {
 
     public abstract boolean execute(Map<String, Object> ctx);
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         IngestConditionalScript newInstance(Map<String, Object> params);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/IngestScript.java b/server/src/main/java/org/elasticsearch/script/IngestScript.java
index f357394ed31f0..7104ed7d9b0d2 100644
--- a/server/src/main/java/org/elasticsearch/script/IngestScript.java
+++ b/server/src/main/java/org/elasticsearch/script/IngestScript.java
@@ -46,7 +46,7 @@ public Map<String, Object> getParams() {
 
     public abstract void execute(Map<String, Object> ctx);
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         IngestScript newInstance(Map<String, Object> params);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/NumberSortScript.java b/server/src/main/java/org/elasticsearch/script/NumberSortScript.java
index d0b3fdbed363e..f1eb118b8bdd5 100644
--- a/server/src/main/java/org/elasticsearch/script/NumberSortScript.java
+++ b/server/src/main/java/org/elasticsearch/script/NumberSortScript.java
@@ -54,7 +54,7 @@ public interface LeafFactory {
     /**
      * A factory to construct stateful {@link NumberSortScript} factories for a specific index.
      */
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/ScoreScript.java b/server/src/main/java/org/elasticsearch/script/ScoreScript.java
index 7c2c09d17afe7..9f535e898b00c 100644
--- a/server/src/main/java/org/elasticsearch/script/ScoreScript.java
+++ b/server/src/main/java/org/elasticsearch/script/ScoreScript.java
@@ -229,7 +229,7 @@ public interface LeafFactory {
     }
 
     /** A factory to construct stateful {@link ScoreScript} factories for a specific index. */
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
 
         ScoreScript.LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup);
 
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptContext.java b/server/src/main/java/org/elasticsearch/script/ScriptContext.java
index 081a26d1e511a..4e927da09d118 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptContext.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptContext.java
@@ -54,7 +54,7 @@
  * If the variable name starts with an underscore, for example, {@code _score}, the needs method would
  * be {@code boolean needs_score()}.
  */
-public final class ScriptContext<FactoryType> {
+public final class ScriptContext<FactoryType extends ScriptFactory> {
 
     /** A unique identifier for this context. */
     public final String name;
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptEngine.java b/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
index 9ace06d701d14..4c38ae5c6e19c 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
@@ -42,7 +42,12 @@ public interface ScriptEngine extends Closeable {
      * @param params compile-time parameters (such as flags to the compiler)
      * @return A compiled script of the FactoryType from {@link ScriptContext}
      */
-    <FactoryType> FactoryType compile(String name, String code, ScriptContext<FactoryType> context, Map<String, String> params);
+    <FactoryType extends ScriptFactory> FactoryType compile(
+        String name,
+        String code,
+        ScriptContext<FactoryType> context,
+        Map<String, String> params
+    );
 
     @Override
     default void close() throws IOException {}
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptFactory.java b/server/src/main/java/org/elasticsearch/script/ScriptFactory.java
new file mode 100644
index 0000000000000..d05e4f77c6449
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/script/ScriptFactory.java
@@ -0,0 +1,28 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.script;
+
+/**
+ * Contains utility methods for compiled scripts without impacting concrete script signatures
+ */
+public interface ScriptFactory {
+    /** Returns {@code true} if the result of the script will be deterministic, {@code false} otherwise. */
+    default boolean isResultDeterministic() { return false; }
+}
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptService.java b/server/src/main/java/org/elasticsearch/script/ScriptService.java
index a1788ee74a163..77375838e7f16 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptService.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptService.java
@@ -284,7 +284,7 @@ void setMaxCompilationRate(Tuple<Integer, TimeValue> newRate) {
      *
      * @return a compiled script which may be used to construct instances of a script for the given context
      */
-    public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+    public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
         Objects.requireNonNull(script);
         Objects.requireNonNull(context);
 
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptedMetricAggContexts.java b/server/src/main/java/org/elasticsearch/script/ScriptedMetricAggContexts.java
index 53c1aa3da1bd4..782c4251c4c84 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptedMetricAggContexts.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptedMetricAggContexts.java
@@ -52,7 +52,7 @@ public Object getState() {
 
         public abstract void execute();
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             InitScript newInstance(Map<String, Object> params, Map<String, Object> state);
         }
 
@@ -129,7 +129,7 @@ public interface LeafFactory {
             MapScript newInstance(LeafReaderContext ctx);
         }
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             LeafFactory newFactory(Map<String, Object> params, Map<String, Object> state, SearchLookup lookup);
         }
 
@@ -156,7 +156,7 @@ public Map<String, Object> getState() {
 
         public abstract Object execute();
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             CombineScript newInstance(Map<String, Object> params, Map<String, Object> state);
         }
 
@@ -183,7 +183,7 @@ public List<Object> getStates() {
 
         public abstract Object execute();
 
-        public interface Factory {
+        public interface Factory extends ScriptFactory {
             ReduceScript newInstance(Map<String, Object> params, List<Object> states);
         }
 
diff --git a/server/src/main/java/org/elasticsearch/script/SignificantTermsHeuristicScoreScript.java b/server/src/main/java/org/elasticsearch/script/SignificantTermsHeuristicScoreScript.java
index 0296bc36ce107..b1a280783a70d 100644
--- a/server/src/main/java/org/elasticsearch/script/SignificantTermsHeuristicScoreScript.java
+++ b/server/src/main/java/org/elasticsearch/script/SignificantTermsHeuristicScoreScript.java
@@ -32,7 +32,7 @@ public abstract class SignificantTermsHeuristicScoreScript {
 
     public abstract double execute(Map<String, Object> params);
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         SignificantTermsHeuristicScoreScript newInstance();
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/SimilarityScript.java b/server/src/main/java/org/elasticsearch/script/SimilarityScript.java
index 4aeb4063959b3..c3efb55a6031e 100644
--- a/server/src/main/java/org/elasticsearch/script/SimilarityScript.java
+++ b/server/src/main/java/org/elasticsearch/script/SimilarityScript.java
@@ -22,7 +22,7 @@
 import org.elasticsearch.index.similarity.ScriptedSimilarity;
 
 /** A script that is used to build {@link ScriptedSimilarity} instances. */
-public abstract class SimilarityScript  {
+public abstract class SimilarityScript {
 
     /** Compute the score.
      * @param weight weight computed by the {@link SimilarityWeightScript} if any, or 1.
@@ -34,7 +34,7 @@ public abstract class SimilarityScript  {
     public abstract double execute(double weight, ScriptedSimilarity.Query query,
             ScriptedSimilarity.Field field, ScriptedSimilarity.Term term, ScriptedSimilarity.Doc doc);
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         SimilarityScript newInstance();
     }
 
diff --git a/server/src/main/java/org/elasticsearch/script/SimilarityWeightScript.java b/server/src/main/java/org/elasticsearch/script/SimilarityWeightScript.java
index 04bbc3cccf40a..2797da64a0e25 100644
--- a/server/src/main/java/org/elasticsearch/script/SimilarityWeightScript.java
+++ b/server/src/main/java/org/elasticsearch/script/SimilarityWeightScript.java
@@ -32,7 +32,7 @@ public abstract class SimilarityWeightScript  {
     public abstract double execute(ScriptedSimilarity.Query query, ScriptedSimilarity.Field field,
             ScriptedSimilarity.Term term);
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         SimilarityWeightScript newInstance();
     }
 
diff --git a/server/src/main/java/org/elasticsearch/script/StringSortScript.java b/server/src/main/java/org/elasticsearch/script/StringSortScript.java
index 1c6c47dd21552..8c459fceed64d 100644
--- a/server/src/main/java/org/elasticsearch/script/StringSortScript.java
+++ b/server/src/main/java/org/elasticsearch/script/StringSortScript.java
@@ -45,7 +45,7 @@ public interface LeafFactory {
     /**
      * A factory to construct stateful {@link StringSortScript} factories for a specific index.
      */
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/TemplateScript.java b/server/src/main/java/org/elasticsearch/script/TemplateScript.java
index c053cf2b509d0..f7cf4590387d8 100644
--- a/server/src/main/java/org/elasticsearch/script/TemplateScript.java
+++ b/server/src/main/java/org/elasticsearch/script/TemplateScript.java
@@ -41,7 +41,7 @@ public Map<String, Object> getParams() {
     /** Run a template and return the resulting string, encoded in utf8 bytes. */
     public abstract String execute();
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         TemplateScript newInstance(Map<String, Object> params);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/script/TermsSetQueryScript.java b/server/src/main/java/org/elasticsearch/script/TermsSetQueryScript.java
index b3d29ff50f278..7fcf56c5473cc 100644
--- a/server/src/main/java/org/elasticsearch/script/TermsSetQueryScript.java
+++ b/server/src/main/java/org/elasticsearch/script/TermsSetQueryScript.java
@@ -103,7 +103,7 @@ public interface LeafFactory {
     /**
      * A factory to construct stateful {@link TermsSetQueryScript} factories for a specific index.
      */
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/UpdateScript.java b/server/src/main/java/org/elasticsearch/script/UpdateScript.java
index ae0827ff83934..5dd08d5b602dd 100644
--- a/server/src/main/java/org/elasticsearch/script/UpdateScript.java
+++ b/server/src/main/java/org/elasticsearch/script/UpdateScript.java
@@ -58,7 +58,7 @@ public Map<String, Object> getCtx() {
 
     public abstract void execute();
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         UpdateScript newInstance(Map<String, Object> params, Map<String, Object> ctx);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ScriptHeuristic.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ScriptHeuristic.java
index 50ef203880d94..e90df2ed33a0b 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ScriptHeuristic.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ScriptHeuristic.java
@@ -101,7 +101,7 @@ public SignificanceHeuristic rewrite(InternalAggregation.ReduceContext context)
 
     @Override
     public SignificanceHeuristic rewrite(QueryShardContext queryShardContext) {
-        SignificantTermsHeuristicScoreScript.Factory compiledScript = queryShardContext.getScriptService().compile(script,
+        SignificantTermsHeuristicScoreScript.Factory compiledScript = queryShardContext.compile(script,
                 SignificantTermsHeuristicScoreScript.CONTEXT);
         return new ExecutableScriptHeuristic(script, compiledScript.newInstance());
     }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricAggregationBuilder.java
index e650a968036cc..accee6fcb5250 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricAggregationBuilder.java
@@ -209,14 +209,14 @@ protected ScriptedMetricAggregatorFactory doBuild(QueryShardContext queryShardCo
         ScriptedMetricAggContexts.InitScript.Factory compiledInitScript;
         Map<String, Object> initScriptParams;
         if (initScript != null) {
-            compiledInitScript = queryShardContext.getScriptService().compile(initScript, ScriptedMetricAggContexts.InitScript.CONTEXT);
+            compiledInitScript = queryShardContext.compile(initScript, ScriptedMetricAggContexts.InitScript.CONTEXT);
             initScriptParams = initScript.getParams();
         } else {
             compiledInitScript = (p, a) -> null;
             initScriptParams = Collections.emptyMap();
         }
 
-        ScriptedMetricAggContexts.MapScript.Factory compiledMapScript = queryShardContext.getScriptService().compile(mapScript,
+        ScriptedMetricAggContexts.MapScript.Factory compiledMapScript = queryShardContext.compile(mapScript,
             ScriptedMetricAggContexts.MapScript.CONTEXT);
         Map<String, Object> mapScriptParams = mapScript.getParams();
 
@@ -224,7 +224,7 @@ protected ScriptedMetricAggregatorFactory doBuild(QueryShardContext queryShardCo
         ScriptedMetricAggContexts.CombineScript.Factory compiledCombineScript;
         Map<String, Object> combineScriptParams;
 
-        compiledCombineScript = queryShardContext.getScriptService().compile(combineScript,
+        compiledCombineScript = queryShardContext.compile(combineScript,
             ScriptedMetricAggContexts.CombineScript.CONTEXT);
         combineScriptParams = combineScript.getParams();
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/TopHitsAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/TopHitsAggregationBuilder.java
index f41027a291e26..a4b7fc2048c7b 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/TopHitsAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/TopHitsAggregationBuilder.java
@@ -587,7 +587,7 @@ protected TopHitsAggregatorFactory doBuild(QueryShardContext queryShardContext,
         List<ScriptFieldsContext.ScriptField> fields = new ArrayList<>();
         if (scriptFields != null) {
             for (ScriptField field : scriptFields) {
-                FieldScript.Factory factory = queryShardContext.getScriptService().compile(field.script(), FieldScript.CONTEXT);
+                FieldScript.Factory factory = queryShardContext.compile(field.script(), FieldScript.CONTEXT);
                 FieldScript.LeafFactory searchScript = factory.newFactory(field.script().getParams(), queryShardContext.lookup());
                 fields.add(new org.elasticsearch.search.fetch.subphase.ScriptFieldsContext.ScriptField(
                     field.fieldName(), searchScript, field.ignoreFailure()));
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/MovingFunctionScript.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/MovingFunctionScript.java
index 79e1f740729ce..8dae73138b272 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/MovingFunctionScript.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/MovingFunctionScript.java
@@ -20,6 +20,7 @@
 package org.elasticsearch.search.aggregations.pipeline;
 
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 
 import java.util.Map;
 
@@ -35,7 +36,7 @@ public abstract class MovingFunctionScript {
      */
     public abstract double execute(Map<String, Object> params, double[] values);
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         MovingFunctionScript newInstance();
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/support/ValuesSourceConfig.java b/server/src/main/java/org/elasticsearch/search/aggregations/support/ValuesSourceConfig.java
index 4919b5bc9f9ad..ba599827b88af 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/support/ValuesSourceConfig.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/support/ValuesSourceConfig.java
@@ -138,7 +138,7 @@ private static AggregationScript.LeafFactory createScript(Script script, QuerySh
         if (script == null) {
             return null;
         } else {
-            AggregationScript.Factory factory = context.getScriptService().compile(script, AggregationScript.CONTEXT);
+            AggregationScript.Factory factory = context.compile(script, AggregationScript.CONTEXT);
             return factory.newFactory(script.getParams(), context.lookup());
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/search/sort/ScriptSortBuilder.java b/server/src/main/java/org/elasticsearch/search/sort/ScriptSortBuilder.java
index d3fa3bb0a1fe9..6cf33830b0453 100644
--- a/server/src/main/java/org/elasticsearch/search/sort/ScriptSortBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/sort/ScriptSortBuilder.java
@@ -250,7 +250,7 @@ public SortFieldAndFormat build(QueryShardContext context) throws IOException {
         final IndexFieldData.XFieldComparatorSource fieldComparatorSource;
         switch (type) {
             case STRING:
-                final StringSortScript.Factory factory = context.getScriptService().compile(script, StringSortScript.CONTEXT);
+                final StringSortScript.Factory factory = context.compile(script, StringSortScript.CONTEXT);
                 final StringSortScript.LeafFactory searchScript = factory.newFactory(script.getParams(), context.lookup());
                 fieldComparatorSource = new BytesRefFieldComparatorSource(null, null, valueMode, nested) {
                     StringSortScript leafScript;
@@ -279,7 +279,7 @@ protected void setScorer(Scorable scorer) {
                 };
                 break;
             case NUMBER:
-                final NumberSortScript.Factory numberSortFactory = context.getScriptService().compile(script, NumberSortScript.CONTEXT);
+                final NumberSortScript.Factory numberSortFactory = context.compile(script, NumberSortScript.CONTEXT);
                 final NumberSortScript.LeafFactory numberSortScript = numberSortFactory.newFactory(script.getParams(), context.lookup());
                 fieldComparatorSource = new DoubleValuesComparatorSource(null, Double.MAX_VALUE, valueMode, nested) {
                     NumberSortScript leafScript;
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/phrase/PhraseSuggestionBuilder.java b/server/src/main/java/org/elasticsearch/search/suggest/phrase/PhraseSuggestionBuilder.java
index 5b66badc733e0..7bbcc0d6c5405 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/phrase/PhraseSuggestionBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/phrase/PhraseSuggestionBuilder.java
@@ -634,7 +634,7 @@ public SuggestionContext build(QueryShardContext context) throws IOException {
         }
 
         if (this.collateQuery != null) {
-            TemplateScript.Factory scriptFactory = context.getScriptService().compile(this.collateQuery, TemplateScript.CONTEXT);
+            TemplateScript.Factory scriptFactory = context.compile(this.collateQuery, TemplateScript.CONTEXT);
             suggestionContext.setCollateQueryScript(scriptFactory);
             if (this.collateParams != null) {
                 suggestionContext.setCollateScriptParams(this.collateParams);
diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index 7b004db65da50..ed28a06500d5a 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.test.AbstractQueryTestCase;
@@ -396,7 +397,7 @@ public boolean execute(Interval interval) {
         ScriptService scriptService = new ScriptService(Settings.EMPTY, Collections.emptyMap(), Collections.emptyMap()){
             @Override
             @SuppressWarnings("unchecked")
-            public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+            public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
                 assertEquals(IntervalFilterScript.CONTEXT, context);
                 assertEquals(new Script("interval.start > 3"), script);
                 return (FactoryType) factory;
diff --git a/server/src/test/java/org/elasticsearch/script/ScriptContextTests.java b/server/src/test/java/org/elasticsearch/script/ScriptContextTests.java
index 157b0969ae813..dc77fb0126262 100644
--- a/server/src/test/java/org/elasticsearch/script/ScriptContextTests.java
+++ b/server/src/test/java/org/elasticsearch/script/ScriptContextTests.java
@@ -23,28 +23,28 @@
 
 public class ScriptContextTests extends ESTestCase {
 
-    public interface TwoNewInstance {
+    public interface TwoNewInstance extends ScriptFactory {
         String newInstance(int foo, int bar);
         String newInstance(int foo);
 
-        interface StatefulFactory {
+        interface StatefulFactory extends ScriptFactory {
             TwoNewInstance newFactory();
         }
     }
 
-    public interface TwoNewFactory {
+    public interface TwoNewFactory extends ScriptFactory {
         String newFactory(int foo, int bar);
         String newFactory(int foo);
     }
 
-    public interface MissingNewInstance {
+    public interface MissingNewInstance extends ScriptFactory {
         String typoNewInstanceMethod(int foo);
     }
 
     public interface DummyScript {
         int execute(int foo);
 
-        interface Factory {
+        interface Factory extends ScriptFactory {
             DummyScript newInstance();
         }
     }
@@ -54,7 +54,7 @@ public interface DummyStatefulScript {
         interface StatefulFactory {
             DummyStatefulScript newInstance();
         }
-        interface Factory {
+        interface Factory extends ScriptFactory {
             StatefulFactory newFactory();
         }
     }
diff --git a/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java b/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java
index 38139103ed2ab..6e720b480934b 100644
--- a/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java
+++ b/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java
@@ -75,7 +75,7 @@ private ScriptService getMockScriptService(Settings settings) {
     }
 
 
-    public interface MiscContext {
+    public interface MiscContext extends ScriptFactory {
         void execute();
         Object newInstance();
     }
diff --git a/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java b/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
index e6bbcf5dd57d0..2e61882256b77 100644
--- a/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
+++ b/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
@@ -34,6 +34,7 @@
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.search.SearchHits;
@@ -75,7 +76,12 @@ public String getType() {
                 }
 
                 @Override
-                public <T> T compile(String scriptName, String scriptSource, ScriptContext<T> context, Map<String, String> params) {
+                public <T extends ScriptFactory> T compile(
+                    String scriptName,
+                    String scriptSource,
+                    ScriptContext<T> context,
+                    Map<String, String> params
+                ) {
                     assert scriptSource.equals("explainable_script");
                     assert context == ScoreScript.CONTEXT;
                     ScoreScript.Factory factory = (params1, lookup) -> new ScoreScript.LeafFactory() {
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
index 9495bc444265e..5434f05c9aa00 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
@@ -34,6 +34,7 @@
 import org.elasticsearch.plugins.ScriptPlugin;
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.TemplateScript;
 import org.elasticsearch.search.suggest.phrase.DirectCandidateGeneratorBuilder;
 import org.elasticsearch.search.suggest.phrase.Laplace;
@@ -1137,7 +1138,12 @@ public String getType() {
         }
 
         @Override
-        public <T> T compile(String scriptName, String scriptSource, ScriptContext<T> context, Map<String, String> params) {
+        public <T extends ScriptFactory> T compile(
+            String scriptName,
+            String scriptSource,
+            ScriptContext<T> context,
+            Map<String, String> params
+        ) {
             if (context.instanceClazz != TemplateScript.class) {
                 throw new UnsupportedOperationException();
             }
diff --git a/test/framework/src/main/java/org/elasticsearch/ingest/TestTemplateService.java b/test/framework/src/main/java/org/elasticsearch/ingest/TestTemplateService.java
index 5bbf39d8fdc17..b5fcb2a37d7e3 100644
--- a/test/framework/src/main/java/org/elasticsearch/ingest/TestTemplateService.java
+++ b/test/framework/src/main/java/org/elasticsearch/ingest/TestTemplateService.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.script.MockScriptEngine;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.script.TemplateScript;
 
@@ -48,7 +49,7 @@ private TestTemplateService(boolean compilationException) {
     }
 
     @Override
-    public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+    public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
         if (this.compilationException) {
             throw new RuntimeException("could not compile script");
         } else {
diff --git a/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java b/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
index e278fbad85aff..84aad77377a30 100644
--- a/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
+++ b/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
@@ -82,7 +82,7 @@ public String getType() {
     }
 
     @Override
-    public <T> T compile(String name, String source, ScriptContext<T> context, Map<String, String> params) {
+    public <T extends ScriptFactory> T compile(String name, String source, ScriptContext<T> context, Map<String, String> params) {
         // Scripts are always resolved using the script's source. For inline scripts, it's easy because they don't have names and the
         // source is always provided. For stored and file scripts, the source of the script must match the key of a predefined script.
         Function<Map<String, Object>, Object> script = scripts.get(source);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/script/MockMustacheScriptEngine.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/script/MockMustacheScriptEngine.java
index 4f9b125a9fd6b..16a95f0accdac 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/script/MockMustacheScriptEngine.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/script/MockMustacheScriptEngine.java
@@ -39,7 +39,7 @@ public String getType() {
     }
 
     @Override
-    public <T> T compile(String name, String script, ScriptContext<T> context, Map<String, String> params) {
+    public <T extends ScriptFactory> T compile(String name, String script, ScriptContext<T> context, Map<String, String> params) {
         if (script.contains("{{") && script.contains("}}")) {
             throw new IllegalArgumentException("Fix your test to not rely on mustache");
         }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/monitoring/test/MockPainlessScriptEngine.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/monitoring/test/MockPainlessScriptEngine.java
index 2052cebe1d0e9..254542f355e5d 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/monitoring/test/MockPainlessScriptEngine.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/monitoring/test/MockPainlessScriptEngine.java
@@ -11,6 +11,7 @@
 import org.elasticsearch.script.ScoreScript;
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
+import org.elasticsearch.script.ScriptFactory;
 
 import java.util.Collection;
 import java.util.Collections;
@@ -42,7 +43,7 @@ public String getType() {
     }
 
     @Override
-    public <T> T compile(String name, String script, ScriptContext<T> context, Map<String, String> options) {
+    public <T extends ScriptFactory> T compile(String name, String script, ScriptContext<T> context, Map<String, String> options) {
         if (context.instanceClazz.equals(ScoreScript.class)) {
             return context.factoryClazz.cast(new MockScoreScript(p -> 0.0));
         }
diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/condition/WatcherConditionScript.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/condition/WatcherConditionScript.java
index 1a5c8718bbd45..f5376aa424692 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/condition/WatcherConditionScript.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/condition/WatcherConditionScript.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.watcher.condition;
 
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.xpack.core.watcher.execution.WatchExecutionContext;
 import org.elasticsearch.xpack.watcher.support.Variables;
 
@@ -37,7 +38,7 @@ public Map<String, Object> getCtx() {
         return ctx;
     }
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         WatcherConditionScript newInstance(Map<String, Object> params, WatchExecutionContext watcherContext);
     }
 
diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/transform/script/WatcherTransformScript.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/transform/script/WatcherTransformScript.java
index 57ee1e9f35c5d..3ef1f87cd608c 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/transform/script/WatcherTransformScript.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/transform/script/WatcherTransformScript.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.watcher.transform.script;
 
 import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.xpack.core.watcher.execution.WatchExecutionContext;
 import org.elasticsearch.xpack.core.watcher.watch.Payload;
 import org.elasticsearch.xpack.watcher.support.Variables;
@@ -38,7 +39,7 @@ public Map<String, Object> getCtx() {
         return ctx;
     }
 
-    public interface Factory {
+    public interface Factory extends ScriptFactory {
         WatcherTransformScript newInstance(Map<String, Object> params, WatchExecutionContext watcherContext, Payload payload);
     }
 

From 59d99b58aae32c509e11717b14c661cdfe52a727 Mon Sep 17 00:00:00 2001
From: Przemko Robakowski <przemko.robakowski@elastic.co>
Date: Fri, 6 Dec 2019 21:57:06 +0100
Subject: [PATCH 104/686] Allow list of IPs in geoip ingest processor (#49573)

* Allow list of IPs in geoip ingest processor

This change lets you use array of IPs in addition to string in geoip processor source field.
It will set array containing geoip data for each element in source, unless first_only parameter
option is enabled, then only first found will be returned.

Closes #46193
---
 .../ingest/processors/geoip.asciidoc          |   1 +
 .../ingest/geoip/GeoIpProcessor.java          |  79 ++++++++----
 .../ingest/geoip/GeoIpProcessorTests.java     | 114 ++++++++++++++++--
 .../test/ingest_geoip/20_geoip_processor.yml  |  81 +++++++++++++
 4 files changed, 241 insertions(+), 34 deletions(-)

diff --git a/docs/reference/ingest/processors/geoip.asciidoc b/docs/reference/ingest/processors/geoip.asciidoc
index 58cc32d629760..84e8ed2c41a8a 100644
--- a/docs/reference/ingest/processors/geoip.asciidoc
+++ b/docs/reference/ingest/processors/geoip.asciidoc
@@ -25,6 +25,7 @@ uncompressed. The `ingest-geoip` config directory is located at `$ES_CONFIG/inge
 | `database_file`        | no        | GeoLite2-City.mmdb                                                                 | The database filename in the geoip config directory. The ingest-geoip module ships with the GeoLite2-City.mmdb, GeoLite2-Country.mmdb and GeoLite2-ASN.mmdb files.
 | `properties`           | no        | [`continent_name`, `country_iso_code`, `region_iso_code`, `region_name`, `city_name`, `location`] *   | Controls what properties are added to the `target_field` based on the geoip lookup.
 | `ignore_missing`       | no        | `false`                                                                            | If `true` and `field` does not exist, the processor quietly exits without modifying the document
+| `first_only`           | no        | `true`                                                                             | If `true` only first found geoip data will be returned, even if `field` contains array
 |======
 
 *Depends on what is available in `database_file`:
diff --git a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/GeoIpProcessor.java b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/GeoIpProcessor.java
index 5c82c68d93032..41300f71093a0 100644
--- a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/GeoIpProcessor.java
+++ b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/GeoIpProcessor.java
@@ -41,6 +41,7 @@
 import java.net.InetAddress;
 import java.security.AccessController;
 import java.security.PrivilegedAction;
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.EnumSet;
@@ -68,6 +69,7 @@ public final class GeoIpProcessor extends AbstractProcessor {
     private final Set<Property> properties;
     private final boolean ignoreMissing;
     private final GeoIpCache cache;
+    private final boolean firstOnly;
 
     /**
      * Construct a geo-IP processor.
@@ -79,15 +81,17 @@ public final class GeoIpProcessor extends AbstractProcessor {
      * @param properties    the properties; ideally this is lazily-loaded once on first use
      * @param ignoreMissing true if documents with a missing value for the field should be ignored
      * @param cache         a geo-IP cache
+     * @param firstOnly     true if only first result should be returned in case of array
      */
     GeoIpProcessor(
-            final String tag,
-            final String field,
-            final DatabaseReaderLazyLoader lazyLoader,
-            final String targetField,
-            final Set<Property> properties,
-            final boolean ignoreMissing,
-            final GeoIpCache cache) {
+        final String tag,
+        final String field,
+        final DatabaseReaderLazyLoader lazyLoader,
+        final String targetField,
+        final Set<Property> properties,
+        final boolean ignoreMissing,
+        final GeoIpCache cache,
+        boolean firstOnly) {
         super(tag);
         this.field = field;
         this.targetField = targetField;
@@ -95,6 +99,7 @@ public final class GeoIpProcessor extends AbstractProcessor {
         this.properties = properties;
         this.ignoreMissing = ignoreMissing;
         this.cache = cache;
+        this.firstOnly = firstOnly;
     }
 
     boolean isIgnoreMissing() {
@@ -103,7 +108,7 @@ boolean isIgnoreMissing() {
 
     @Override
     public IngestDocument execute(IngestDocument ingestDocument) throws IOException {
-        String ip = ingestDocument.getFieldValue(field, String.class, ignoreMissing);
+        Object ip = ingestDocument.getFieldValue(field, Object.class, ignoreMissing);
 
         if (ip == null && ignoreMissing) {
             return ingestDocument;
@@ -111,11 +116,43 @@ public IngestDocument execute(IngestDocument ingestDocument) throws IOException
             throw new IllegalArgumentException("field [" + field + "] is null, cannot extract geoip information.");
         }
 
-        final InetAddress ipAddress = InetAddresses.forString(ip);
+        if (ip instanceof String) {
+            Map<String, Object> geoData = getGeoData((String) ip);
+            if (geoData.isEmpty() == false) {
+                ingestDocument.setFieldValue(targetField, geoData);
+            }
+        } else if (ip instanceof List) {
+            boolean match = false;
+            List<Map<String, Object>> geoDataList = new ArrayList<>(((List) ip).size());
+            for (Object ipAddr : (List) ip) {
+                if (ipAddr instanceof String == false) {
+                    throw new IllegalArgumentException("array in field [" + field + "] should only contain strings");
+                }
+                Map<String, Object> geoData = getGeoData((String) ipAddr);
+                if (geoData.isEmpty()) {
+                    geoDataList.add(null);
+                    continue;
+                }
+                if (firstOnly) {
+                    ingestDocument.setFieldValue(targetField, geoData);
+                    return ingestDocument;
+                }
+                match = true;
+                geoDataList.add(geoData);
+            }
+            if (match) {
+                ingestDocument.setFieldValue(targetField, geoDataList);
+            }
+        } else {
+            throw new IllegalArgumentException("field [" + field + "] should contain only string or array of strings");
+        }
+        return ingestDocument;
+    }
 
-        Map<String, Object> geoData;
+    private Map<String, Object> getGeoData(String ip) throws IOException {
         String databaseType = lazyLoader.getDatabaseType();
-
+        final InetAddress ipAddress = InetAddresses.forString(ip);
+        Map<String, Object> geoData;
         if (databaseType.endsWith(CITY_DB_SUFFIX)) {
             try {
                 geoData = retrieveCityGeoData(ipAddress);
@@ -136,12 +173,9 @@ public IngestDocument execute(IngestDocument ingestDocument) throws IOException
             }
         } else {
             throw new ElasticsearchParseException("Unsupported database type [" + lazyLoader.getDatabaseType()
-                    + "]", new IllegalStateException());
-        }
-        if (geoData.isEmpty() == false) {
-            ingestDocument.setFieldValue(targetField, geoData);
+                + "]", new IllegalStateException());
         }
-        return ingestDocument;
+        return geoData;
     }
 
     @Override
@@ -360,14 +394,15 @@ public Factory(Map<String, DatabaseReaderLazyLoader> databaseReaders, GeoIpCache
 
         @Override
         public GeoIpProcessor create(
-                final Map<String, Processor.Factory> registry,
-                final String processorTag,
-                final Map<String, Object> config) throws IOException {
+            final Map<String, Processor.Factory> registry,
+            final String processorTag,
+            final Map<String, Object> config) throws IOException {
             String ipField = readStringProperty(TYPE, processorTag, config, "field");
             String targetField = readStringProperty(TYPE, processorTag, config, "target_field", "geoip");
             String databaseFile = readStringProperty(TYPE, processorTag, config, "database_file", "GeoLite2-City.mmdb");
             List<String> propertyNames = readOptionalList(TYPE, processorTag, config, "properties");
             boolean ignoreMissing = readBooleanProperty(TYPE, processorTag, config, "ignore_missing", false);
+            boolean firstOnly = readBooleanProperty(TYPE, processorTag, config, "first_only", true);
 
             DatabaseReaderLazyLoader lazyLoader = databaseReaders.get(databaseFile);
             if (lazyLoader == null) {
@@ -397,11 +432,11 @@ public GeoIpProcessor create(
                     properties = DEFAULT_ASN_PROPERTIES;
                 } else {
                     throw newConfigurationException(TYPE, processorTag, "database_file", "Unsupported database type ["
-                            + databaseType + "]");
+                        + databaseType + "]");
                 }
             }
 
-            return new GeoIpProcessor(processorTag, ipField, lazyLoader, targetField, properties, ignoreMissing, cache);
+            return new GeoIpProcessor(processorTag, ipField, lazyLoader, targetField, properties, ignoreMissing, cache, firstOnly);
         }
     }
 
@@ -460,7 +495,7 @@ public static Property parseProperty(String databaseType, String value) {
                 return property;
             } catch (IllegalArgumentException e) {
                 throw new IllegalArgumentException("illegal property value [" + value + "]. valid values are " +
-                        Arrays.toString(validProperties.toArray()));
+                    Arrays.toString(validProperties.toArray()));
             }
         }
     }
diff --git a/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/GeoIpProcessorTests.java b/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/GeoIpProcessorTests.java
index b136fbae0376a..f0e9b30ae69ca 100644
--- a/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/GeoIpProcessorTests.java
+++ b/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/GeoIpProcessorTests.java
@@ -29,9 +29,11 @@
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.EnumSet;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.function.Supplier;
 
@@ -39,13 +41,14 @@
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.nullValue;
 
 public class GeoIpProcessorTests extends ESTestCase {
 
     public void testCity() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
 
         Map<String, Object> document = new HashMap<>();
         document.put("source_field", "8.8.8.8");
@@ -70,7 +73,7 @@ public void testCity() throws Exception {
     public void testNullValueWithIgnoreMissing() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), true,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
         IngestDocument originalIngestDocument = RandomDocumentPicks.randomIngestDocument(random(),
             Collections.singletonMap("source_field", null));
         IngestDocument ingestDocument = new IngestDocument(originalIngestDocument);
@@ -81,7 +84,7 @@ public void testNullValueWithIgnoreMissing() throws Exception {
     public void testNonExistentWithIgnoreMissing() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), true,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
         IngestDocument originalIngestDocument = RandomDocumentPicks.randomIngestDocument(random(), Collections.emptyMap());
         IngestDocument ingestDocument = new IngestDocument(originalIngestDocument);
         processor.execute(ingestDocument);
@@ -91,7 +94,7 @@ public void testNonExistentWithIgnoreMissing() throws Exception {
     public void testNullWithoutIgnoreMissing() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
         IngestDocument originalIngestDocument = RandomDocumentPicks.randomIngestDocument(random(),
             Collections.singletonMap("source_field", null));
         IngestDocument ingestDocument = new IngestDocument(originalIngestDocument);
@@ -102,7 +105,7 @@ public void testNullWithoutIgnoreMissing() throws Exception {
     public void testNonExistentWithoutIgnoreMissing() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-            new GeoIpCache(1000));
+            new GeoIpCache(1000), false);
         IngestDocument originalIngestDocument = RandomDocumentPicks.randomIngestDocument(random(), Collections.emptyMap());
         IngestDocument ingestDocument = new IngestDocument(originalIngestDocument);
         Exception exception = expectThrows(Exception.class, () -> processor.execute(ingestDocument));
@@ -112,7 +115,7 @@ public void testNonExistentWithoutIgnoreMissing() throws Exception {
     public void testCity_withIpV6() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
 
         String address = "2602:306:33d3:8000::3257:9652";
         Map<String, Object> document = new HashMap<>();
@@ -141,7 +144,7 @@ public void testCity_withIpV6() throws Exception {
     public void testCityWithMissingLocation() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
 
         Map<String, Object> document = new HashMap<>();
         document.put("source_field", "80.231.5.0");
@@ -158,7 +161,7 @@ public void testCityWithMissingLocation() throws Exception {
     public void testCountry() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-Country.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
 
         Map<String, Object> document = new HashMap<>();
         document.put("source_field", "82.170.213.79");
@@ -178,7 +181,7 @@ public void testCountry() throws Exception {
     public void testCountryWithMissingLocation() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-Country.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
 
         Map<String, Object> document = new HashMap<>();
         document.put("source_field", "80.231.5.0");
@@ -196,7 +199,7 @@ public void testAsn() throws Exception {
         String ip = "82.171.64.0";
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-ASN.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
 
         Map<String, Object> document = new HashMap<>();
         document.put("source_field", ip);
@@ -215,7 +218,7 @@ public void testAsn() throws Exception {
     public void testAddressIsNotInTheDatabase() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
 
         Map<String, Object> document = new HashMap<>();
         document.put("source_field", "127.0.0.1");
@@ -228,7 +231,7 @@ public void testAddressIsNotInTheDatabase() throws Exception {
     public void testInvalid() throws Exception {
         GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
                 loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
-                new GeoIpCache(1000));
+                new GeoIpCache(1000), false);
 
         Map<String, Object> document = new HashMap<>();
         document.put("source_field", "www.google.com");
@@ -237,6 +240,93 @@ public void testInvalid() throws Exception {
         assertThat(e.getMessage(), containsString("not an IP string literal"));
     }
 
+    public void testListAllValid() throws Exception {
+        GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
+            loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
+            new GeoIpCache(1000), false);
+
+        Map<String, Object> document = new HashMap<>();
+        document.put("source_field", Arrays.asList("8.8.8.8", "82.171.64.0"));
+        IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random(), document);
+        processor.execute(ingestDocument);
+
+        @SuppressWarnings("unchecked")
+        List<Map<String, Object>> geoData = (List<Map<String, Object>>) ingestDocument.getSourceAndMetadata().get("target_field");
+
+        Map<String, Object> location = new HashMap<>();
+        location.put("lat", 37.751d);
+        location.put("lon", -97.822d);
+        assertThat(geoData.get(0).get("location"), equalTo(location));
+
+        assertThat(geoData.get(1).get("city_name"), equalTo("Hoensbroek"));
+    }
+
+    public void testListPartiallyValid() throws Exception {
+        GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
+            loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
+            new GeoIpCache(1000), false);
+
+        Map<String, Object> document = new HashMap<>();
+        document.put("source_field", Arrays.asList("8.8.8.8", "127.0.0.1"));
+        IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random(), document);
+        processor.execute(ingestDocument);
+
+        @SuppressWarnings("unchecked")
+        List<Map<String, Object>> geoData = (List<Map<String, Object>>) ingestDocument.getSourceAndMetadata().get("target_field");
+
+        Map<String, Object> location = new HashMap<>();
+        location.put("lat", 37.751d);
+        location.put("lon", -97.822d);
+        assertThat(geoData.get(0).get("location"), equalTo(location));
+
+        assertThat(geoData.get(1), nullValue());
+    }
+
+    public void testListNoMatches() throws Exception {
+        GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
+            loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
+            new GeoIpCache(1000), false);
+
+        Map<String, Object> document = new HashMap<>();
+        document.put("source_field", Arrays.asList("127.0.0.1", "127.0.0.1"));
+        IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random(), document);
+        processor.execute(ingestDocument);
+
+        assertFalse(ingestDocument.hasField("target_field"));
+    }
+
+    public void testListFirstOnly() throws Exception {
+        GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
+            loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
+            new GeoIpCache(1000), true);
+
+        Map<String, Object> document = new HashMap<>();
+        document.put("source_field", Arrays.asList("8.8.8.8", "127.0.0.1"));
+        IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random(), document);
+        processor.execute(ingestDocument);
+
+        @SuppressWarnings("unchecked")
+        Map<String, Object> geoData = (Map<String, Object>) ingestDocument.getSourceAndMetadata().get("target_field");
+
+        Map<String, Object> location = new HashMap<>();
+        location.put("lat", 37.751d);
+        location.put("lon", -97.822d);
+        assertThat(geoData.get("location"), equalTo(location));
+    }
+
+    public void testListFirstOnlyNoMatches() throws Exception {
+        GeoIpProcessor processor = new GeoIpProcessor(randomAlphaOfLength(10), "source_field",
+            loader("/GeoLite2-City.mmdb"), "target_field", EnumSet.allOf(GeoIpProcessor.Property.class), false,
+            new GeoIpCache(1000), true);
+
+        Map<String, Object> document = new HashMap<>();
+        document.put("source_field", Arrays.asList("127.0.0.1", "127.0.0.2"));
+        IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random(), document);
+        processor.execute(ingestDocument);
+
+        assertThat(ingestDocument.getSourceAndMetadata().containsKey("target_field"), is(false));
+    }
+
     private DatabaseReaderLazyLoader loader(final String path) {
         final Supplier<InputStream> databaseInputStreamSupplier = () -> GeoIpProcessor.class.getResourceAsStream(path);
         final CheckedSupplier<DatabaseReader, IOException> loader =
diff --git a/modules/ingest-geoip/src/test/resources/rest-api-spec/test/ingest_geoip/20_geoip_processor.yml b/modules/ingest-geoip/src/test/resources/rest-api-spec/test/ingest_geoip/20_geoip_processor.yml
index 27ab1f4e8747d..f6bdce0532ace 100644
--- a/modules/ingest-geoip/src/test/resources/rest-api-spec/test/ingest_geoip/20_geoip_processor.yml
+++ b/modules/ingest-geoip/src/test/resources/rest-api-spec/test/ingest_geoip/20_geoip_processor.yml
@@ -37,6 +37,87 @@
   - match: { _source.geoip.region_name: "Minnesota" }
   - match: { _source.geoip.continent_name: "North America" }
 
+---
+"Test geoip processor with list":
+  - do:
+      ingest.put_pipeline:
+        id: "my_pipeline"
+        body:  >
+          {
+            "description": "_description",
+            "processors": [
+              {
+                "geoip" : {
+                  "field" : "field1",
+                  "first_only" : false
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      index:
+        index: test
+        id: 1
+        pipeline: "my_pipeline"
+        body: {field1: ["128.101.101.101", "127.0.0.1"]}
+
+  - do:
+      get:
+        index: test
+        id: 1
+  - match: { _source.field1: ["128.101.101.101", "127.0.0.1"] }
+  - length: { _source.geoip: 2 }
+  - length: { _source.geoip.0: 6 }
+  - match: { _source.geoip.0.city_name: "Minneapolis" }
+  - match: { _source.geoip.0.country_iso_code: "US" }
+  - match: { _source.geoip.0.location.lon: -93.2548 }
+  - match: { _source.geoip.0.location.lat: 44.9399 }
+  - match: { _source.geoip.0.region_iso_code: "US-MN" }
+  - match: { _source.geoip.0.region_name: "Minnesota" }
+  - match: { _source.geoip.0.continent_name: "North America" }
+  - match: { _source.geoip.1: null }
+
+---
+"Test geoip processor with lists, first only":
+  - do:
+      ingest.put_pipeline:
+        id: "my_pipeline"
+        body:  >
+          {
+            "description": "_description",
+            "processors": [
+              {
+                "geoip" : {
+                  "field" : "field1"
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      index:
+        index: test
+        id: 1
+        pipeline: "my_pipeline"
+        body: {field1: ["127.0.0.1", "128.101.101.101", "128.101.101.101"]}
+
+  - do:
+      get:
+        index: test
+        id: 1
+  - match: { _source.field1: ["127.0.0.1", "128.101.101.101", "128.101.101.101"] }
+  - length: { _source.geoip: 6 }
+  - match: { _source.geoip.city_name: "Minneapolis" }
+  - match: { _source.geoip.country_iso_code: "US" }
+  - match: { _source.geoip.location.lon: -93.2548 }
+  - match: { _source.geoip.location.lat: 44.9399 }
+  - match: { _source.geoip.region_iso_code: "US-MN" }
+  - match: { _source.geoip.region_name: "Minnesota" }
+  - match: { _source.geoip.continent_name: "North America" }
+
 ---
 "Test geoip processor with fields":
   - do:

From 29c8a6d21d88dae367cb42d5de4ffa29fe0a0267 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Fri, 6 Dec 2019 14:44:20 -0800
Subject: [PATCH 105/686] Upgrade to Gradle 6.0 (#49211)

This upgrade required a few significant changes. Firstly, the build
scan plugin has been renamed, and changed to be a Settings plugin rather
than a project plugin so the declaration of this has moved to our
settings.gradle file. Second, we were using a rather old version of the
Nebula ospackage plugin for building deb and rpm packages, the migration
to the latest version required some updates to get things working as
expected as we had some workarounds in place that are no longer
applicable with the latest bug fixes.
---
 .ci/java-versions.properties                  |   3 +-
 build.gradle                                  |   1 -
 buildSrc/build.gradle                         |   2 +-
 .../src/main/resources/minimumGradleVersion   |   2 +-
 .../src/testKit/thirdPartyAudit/build.gradle  |   3 ++
 distribution/packages/build.gradle            |  22 ++++++-------
 gradle/build-complete.gradle                  |   2 ++
 gradle/wrapper/gradle-wrapper.jar             | Bin 55616 -> 58702 bytes
 gradle/wrapper/gradle-wrapper.properties      |   4 +--
 gradlew                                       |  29 ++++++++----------
 settings.gradle                               |   4 +++
 11 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/.ci/java-versions.properties b/.ci/java-versions.properties
index a63e17527daee..1c1e813553670 100644
--- a/.ci/java-versions.properties
+++ b/.ci/java-versions.properties
@@ -8,4 +8,5 @@ ES_BUILD_JAVA=openjdk12
 ES_RUNTIME_JAVA=openjdk11
 GRADLE_TASK=build
 
-
+# Workaround for https://github.com/gradle/gradle/issues/11426
+OPENSHIFT_IP=0.0.0.0
diff --git a/build.gradle b/build.gradle
index d38c4aa3da790..df1641dcc9efe 100644
--- a/build.gradle
+++ b/build.gradle
@@ -32,7 +32,6 @@ import org.gradle.util.GradleVersion
 import static org.elasticsearch.gradle.tool.Boilerplate.maybeConfigure
 
 plugins {
-  id 'com.gradle.build-scan' version '2.4.2'
   id 'lifecycle-base'
   id 'elasticsearch.global-build-info'
   id "com.diffplug.gradle.spotless" version "3.24.2" apply false
diff --git a/buildSrc/build.gradle b/buildSrc/build.gradle
index de883187547fd..2d28c79e80248 100644
--- a/buildSrc/build.gradle
+++ b/buildSrc/build.gradle
@@ -29,7 +29,7 @@ group = 'org.elasticsearch.gradle'
 
 String minimumGradleVersion = file('src/main/resources/minimumGradleVersion').text.trim()
 if (GradleVersion.current() < GradleVersion.version(minimumGradleVersion)) {
-  throw new GradleException("Gradle ${minimumGradleVersion}+ is required to build elasticsearch")
+   throw new GradleException("Gradle ${minimumGradleVersion}+ is required to build elasticsearch")
 }
 
 if (project == rootProject) {
diff --git a/buildSrc/src/main/resources/minimumGradleVersion b/buildSrc/src/main/resources/minimumGradleVersion
index 2a06a418a7736..6d54bbd77512d 100644
--- a/buildSrc/src/main/resources/minimumGradleVersion
+++ b/buildSrc/src/main/resources/minimumGradleVersion
@@ -1 +1 @@
-5.6.4
\ No newline at end of file
+6.0.1
\ No newline at end of file
diff --git a/buildSrc/src/testKit/thirdPartyAudit/build.gradle b/buildSrc/src/testKit/thirdPartyAudit/build.gradle
index 253d3f0acc1c9..629460c2627c1 100644
--- a/buildSrc/src/testKit/thirdPartyAudit/build.gradle
+++ b/buildSrc/src/testKit/thirdPartyAudit/build.gradle
@@ -16,6 +16,9 @@ repositories {
   maven {
     name = "local-test"
     url = file("sample_jars/build/testrepo")
+    metadataSources {
+      artifact()
+    }
   }
   jcenter()
 }
diff --git a/distribution/packages/build.gradle b/distribution/packages/build.gradle
index 695654bca34b6..99de6773c0f92 100644
--- a/distribution/packages/build.gradle
+++ b/distribution/packages/build.gradle
@@ -51,16 +51,8 @@ import java.util.regex.Pattern
  *    dpkg -c path/to/elasticsearch.deb
  */
 
-buildscript {
-  repositories {
-    maven {
-      name "gradle-plugins"
-      url "https://plugins.gradle.org/m2/"
-    }
-  }
-  dependencies {
-    classpath 'com.netflix.nebula:gradle-ospackage-plugin:4.7.1'
-  }
+plugins {
+  id "nebula.ospackage-base" version "8.0.3"
 }
 
 void addProcessFilesTask(String type, boolean oss, boolean jdk) {
@@ -115,10 +107,12 @@ Closure commonPackageConfig(String type, boolean oss, boolean jdk) {
     arch(type == 'deb' ? 'amd64' : 'X86_64')
     // Follow elasticsearch's file naming convention
     String jdkString = jdk ? "" : "no-jdk-"
-    archiveName "${packageName}-${project.version}-${jdkString}${archString}.${type}"
-
     String prefix = "${oss ? 'oss-' : ''}${jdk ? '' : 'no-jdk-'}${type}"
     destinationDir = file("${prefix}/build/distributions")
+
+    // SystemPackagingTask overrides default archive task convention mappings, but doesn't provide a setter so we have to override the convention mapping itself
+    conventionMapping.archiveFile = { objects.fileProperty().fileValue(file("${destinationDir}/${packageName}-${project.version}-${jdkString}${archString}.${type}")) }
+
     String packagingFiles = "build/packaging/${oss ? 'oss-' : ''}${jdk ? '' : 'no-jdk-'}${type}"
 
     String scripts = "${packagingFiles}/scripts"
@@ -157,7 +151,9 @@ Closure commonPackageConfig(String type, boolean oss, boolean jdk) {
       eachFile { FileCopyDetails fcp ->
         String[] segments = fcp.relativePath.segments
         for (int i = segments.length - 2; i > 2; --i) {
-          directory('/' + segments[0..i].join('/'), 0755)
+          if (type == 'rpm') {
+            directory('/' + segments[0..i].join('/'), 0755)
+          }
           if (segments[-2] == 'bin' || segments[-1] == 'jspawnhelper') {
             fcp.mode = 0755
           } else {
diff --git a/gradle/build-complete.gradle b/gradle/build-complete.gradle
index 3ce58d19f537a..32c7bc4b068d1 100644
--- a/gradle/build-complete.gradle
+++ b/gradle/build-complete.gradle
@@ -38,6 +38,8 @@ if (buildNumber) {
         fileset(dir: "${gradle.gradleUserHomeDir}/daemon/${gradle.gradleVersion}", followsymlinks: false) {
           include(name: "**/daemon-${ProcessHandle.current().pid()}*.log")
         }
+
+        fileset(dir: "${gradle.gradleUserHomeDir}/workers", followsymlinks: false)
       }
     } catch (Exception e) {
       logger.lifecycle("Failed to archive additional logs", e)
diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar
index 5c2d1cf016b3885f6930543d57b744ea8c220a1a..cc4fdc293d0e50b0ad9b65c16e7ddd1db2f6025b 100644
GIT binary patch
delta 16535
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
U#ULQK|Neget<zCj{4eSM0|LcRF8}}l

delta 13615
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
O=|=?tu^Rs0)%hQKQa~60

diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index c71beb8ee5f9c..ba9078ad2addb 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.0.1-all.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionSha256Sum=abc10bcedb58806e8654210f96031db541bcd2d6fc3161e81cb0572d6a15e821
+distributionSha256Sum=6f6cfdbb12a577c3845522a1c7fbfe1295ea05d87edabedd4e23fd2bf02b88b1
diff --git a/gradlew b/gradlew
index 83f2acfdc319a..2fe81a7d95e4f 100755
--- a/gradlew
+++ b/gradlew
@@ -154,19 +154,19 @@ if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
         else
             eval `echo args$i`="\"$arg\""
         fi
-        i=$((i+1))
+        i=`expr $i + 1`
     done
     case $i in
-        (0) set -- ;;
-        (1) set -- "$args0" ;;
-        (2) set -- "$args0" "$args1" ;;
-        (3) set -- "$args0" "$args1" "$args2" ;;
-        (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
-        (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
-        (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
-        (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
-        (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
-        (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+        0) set -- ;;
+        1) set -- "$args0" ;;
+        2) set -- "$args0" "$args1" ;;
+        3) set -- "$args0" "$args1" "$args2" ;;
+        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
     esac
 fi
 
@@ -175,14 +175,9 @@ save () {
     for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
     echo " "
 }
-APP_ARGS=$(save "$@")
+APP_ARGS=`save "$@"`
 
 # Collect all arguments for the java command, following the shell quoting and substitution rules
 eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
 
-# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
-if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
-  cd "$(dirname "$0")"
-fi
-
 exec "$JAVACMD" "$@"
diff --git a/settings.gradle b/settings.gradle
index 22ee902e3558d..d92f5584a27a9 100644
--- a/settings.gradle
+++ b/settings.gradle
@@ -1,3 +1,7 @@
+plugins {
+  id "com.gradle.enterprise" version "3.0"
+}
+
 String dirName = rootProject.projectDir.name
 rootProject.name = dirName
 

From df6c251569835943059cb190e483600eadb5cc98 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Fri, 6 Dec 2019 15:32:07 -0800
Subject: [PATCH 106/686] [DOCS] Move anomaly detection job resource
 definitions into APIs (#49700)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: István Zoltán Szabó <istvan.szabo@elastic.co>
---
 .../client/ml/job/config/Detector.java        |   6 +-
 docs/build.gradle                             |   1 +
 .../anomaly-detection/apis/close-job.asciidoc |  18 +-
 .../apis/datafeedresource.asciidoc            |   2 +-
 .../apis/delete-job.asciidoc                  |   3 +-
 .../anomaly-detection/apis/flush-job.asciidoc |   3 +-
 .../anomaly-detection/apis/forecast.asciidoc  |   5 +-
 .../apis/get-bucket.asciidoc                  |   3 +-
 .../apis/get-category.asciidoc                |   3 +-
 .../apis/get-influencer.asciidoc              |   3 +-
 .../apis/get-job-stats.asciidoc               |  23 +-
 .../anomaly-detection/apis/get-job.asciidoc   | 173 +++--
 .../apis/get-overall-buckets.asciidoc         |   9 +-
 .../apis/get-record.asciidoc                  |   3 +-
 .../apis/get-snapshot.asciidoc                |   3 +-
 .../apis/jobresource.asciidoc                 | 561 ----------------
 .../anomaly-detection/apis/open-job.asciidoc  |   3 +-
 .../anomaly-detection/apis/post-data.asciidoc |   3 +-
 .../apis/put-calendar-job.asciidoc            |   4 +-
 .../apis/put-datafeed.asciidoc                |   7 +-
 .../apis/put-filter.asciidoc                  |   2 +-
 .../anomaly-detection/apis/put-job.asciidoc   |  66 +-
 .../apis/revert-snapshot.asciidoc             |   3 +-
 .../apis/update-datafeed.asciidoc             |   7 +-
 .../apis/update-job.asciidoc                  | 114 ++--
 .../apis/update-snapshot.asciidoc             |   3 +-
 .../apis/validate-detector.asciidoc           |   3 +-
 .../apis/validate-job.asciidoc                |   2 +-
 .../ml/anomaly-detection/categories.asciidoc  |  52 +-
 .../ml/anomaly-detection/functions.asciidoc   |   3 +-
 .../functions/count.asciidoc                  |  12 +-
 .../anomaly-detection/functions/geo.asciidoc  |   4 +-
 .../anomaly-detection/functions/info.asciidoc |   4 +-
 .../functions/metric.asciidoc                 |  22 +-
 .../anomaly-detection/functions/rare.asciidoc |   8 +-
 .../anomaly-detection/functions/sum.asciidoc  |   8 +-
 .../anomaly-detection/functions/time.asciidoc |   8 +-
 .../apis/delete-dfanalytics.asciidoc          |   3 +-
 .../apis/explain-dfanalytics.asciidoc         |   6 +-
 .../apis/get-dfanalytics-stats.asciidoc       |  19 +-
 .../apis/put-dfanalytics.asciidoc             |   7 +-
 .../apis/start-dfanalytics.asciidoc           |   5 +-
 .../apis/stop-dfanalytics.asciidoc            |   5 +-
 docs/reference/ml/ml-shared.asciidoc          | 621 +++++++++++++++++-
 docs/reference/redirects.asciidoc             |   9 +
 docs/reference/rest-api/defs.asciidoc         |   2 -
 docs/reference/settings/ml-settings.asciidoc  |   2 +-
 47 files changed, 1007 insertions(+), 829 deletions(-)
 delete mode 100644 docs/reference/ml/anomaly-detection/apis/jobresource.asciidoc

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/job/config/Detector.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/job/config/Detector.java
index 44fc18032d29b..48a04d1225126 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/job/config/Detector.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/job/config/Detector.java
@@ -34,9 +34,9 @@
 /**
  * Defines the fields and functions used in the analysis. A combination of <code>field_name</code>,
  * <code>by_field_name</code> and <code>over_field_name</code> can be used depending on the specific
- * function chosen. For more information see
- * <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-job-resource.html#ml-detectorconfig">configuring
- * detectors</a> and <a href="https://www.elastic.co/guide/en/elastic-stack-overview/current/ml-functions.html">detector functions</a>.
+ * function chosen. For more information see the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-put-job.html">create anomaly detection
+ * jobs API</a> and <a href="https://www.elastic.co/guide/en/elastic-stack-overview/current/ml-functions.html">detector functions</a>.
  */
 public class Detector implements ToXContentObject {
 
diff --git a/docs/build.gradle b/docs/build.gradle
index f7c0fc7e080b1..a39c7e0d9f3bd 100644
--- a/docs/build.gradle
+++ b/docs/build.gradle
@@ -29,6 +29,7 @@ buildRestTests.expectedUnconvertedCandidates = [
   'reference/ml/anomaly-detection/apis/get-category.asciidoc',
   'reference/ml/anomaly-detection/apis/get-influencer.asciidoc',
   'reference/ml/anomaly-detection/apis/get-job-stats.asciidoc',
+  'reference/ml/anomaly-detection/apis/get-job.asciidoc',
   'reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc',
   'reference/ml/anomaly-detection/apis/get-record.asciidoc',
   'reference/ml/anomaly-detection/apis/get-snapshot.asciidoc',
diff --git a/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
index bdbbc88a50173..7f9fd0489ab77 100644
--- a/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
@@ -60,25 +60,15 @@ results the job might have recently produced or might produce in the future.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}. It can be a job
-  identifier, a group name, or a wildcard expression.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-wildcard]
 
 [[ml-close-job-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_jobs`::
-  (Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no jobs that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches.
-
-The default value is `true`, which returns an empty `jobs` array 
-when there are no matches and the subset of results when there are partial 
-matches. If this parameter is `false`, the request returns a `404` status code
-when there are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 
 `force`::
   (Optional, boolean) Use to close a failed job, or to forcefully close a job
diff --git a/docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc
index 389c9d704eacd..864e71e35bdbe 100644
--- a/docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc
@@ -50,7 +50,7 @@ A {dfeed} resource has the following properties:
 `script_fields`::
   (object) Specifies scripts that evaluate custom expressions and returns
   script fields to the {dfeed}.
-  The <<ml-detectorconfig,detector configuration objects>> in a job can contain
+  The detector configuration objects in a job can contain
   functions that use these script fields.
   For more information, see
   {stack-ov}/ml-configuring-transform.html[Transforming Data With Script Fields].
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
index 096939184ea25..0c04ec468bbbf 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
@@ -39,7 +39,8 @@ separated list.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-delete-job-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
index 7afef6eabde4c..f6e81a3b26131 100644
--- a/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
@@ -37,7 +37,8 @@ opened again before analyzing further data.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-(string) Required. Identifier for the job.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-flush-job-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
index 3bfc8b51b4532..0ec17ea9bd25e 100644
--- a/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
@@ -29,7 +29,7 @@ See {stack-ov}/ml-overview.html#ml-forecasting[Forecasting the future].
 ===============================
 
 * If you use an `over_field_name` property in your job, you cannot create a
-forecast. For more information about this property, see <<ml-job-resource>>.
+forecast. For more information about this property, see <<ml-put-job>>.
 * The job must be open when you create a forecast. Otherwise, an error occurs.
 ===============================
 
@@ -37,7 +37,8 @@ forecast. For more information about this property, see <<ml-job-resource>>.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the job.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-forecast-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
index 91c473ebec915..027de1385e83f 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
@@ -36,7 +36,8 @@ bucket.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<timestamp>`::
   (Optional, string) The timestamp of a single bucket result. If you do not
diff --git a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
index 1f7955873451c..3280b79534f50 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
@@ -35,7 +35,8 @@ For more information about categories, see
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<category_id>`::
   (Optional, long) Identifier for the category. If you do not specify this
diff --git a/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
index a2da47720c9ea..2165d8ef9f7f9 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
@@ -27,7 +27,8 @@ privileges. See <<security-privileges>> and
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-get-influencer-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
index 9c7bcc6e7b398..99928e43ca5f3 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
@@ -40,26 +40,15 @@ IMPORTANT: This API returns a maximum of 10,000 jobs.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Optional, string) An identifier for the {anomaly-job}. It can be a
-  job identifier, a group name, or a wildcard expression. If you do not specify
-  one of these options, the API returns statistics for all {anomaly-jobs}.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-default]
 
 [[ml-get-job-stats-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_jobs`::
-  (Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no jobs that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches.
-
-The default value is `true`, which returns an empty `jobs` array 
-when there are no matches and the subset of results when there are partial 
-matches. If this parameter is `false`, the request returns a `404` status code
-when there are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 
 [[ml-get-job-stats-results]]
 ==== {api-response-body-title}
@@ -67,8 +56,8 @@ when there are no matches or only partial matches.
 The API returns the following information:
 
 `jobs`::
-  (array) An array of {anomaly-job} statistics objects.
-  For more information, see <<ml-jobstats>>.
+(array) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=jobs-stats-anomaly-detection]
 
 [[ml-get-job-stats-response-codes]]
 ==== {api-response-codes-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
index a816bcd3e1ddc..7aeafde9ee884 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
@@ -40,35 +40,101 @@ IMPORTANT: This API returns a maximum of 10,000 jobs.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Optional, string) Identifier for the {anomaly-job}. It can be a job
-  identifier, a group name, or a wildcard expression. If you do not specify one
-  of these options, the API returns information for all {anomaly-jobs}.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-default]
 
 [[ml-get-job-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_jobs`::
-  (Optional, boolean) Specifies what to do when the request:
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
+
+
+[[ml-get-job-results]]
+==== {api-response-body-title}
+
+The API returns an array of {anomaly-job} resources, which have the following
+properties:
+
+`allow_lazy_open`::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
+
+[[get-analysisconfig]]`analysis_config`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-config]
+
+[[get-analysislimits]]`analysis_limits`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-limits]
+
+`background_persist_interval`::
+(time units)
+include::{docdir}/ml/ml-shared.asciidoc[tag=background-persist-interval]
+
+`create_time`::
+(string) The time the job was created. For example, `1491007356077`. This
+property is informational; you cannot change its value.
+
+[[get-customsettings]]`custom_settings`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-settings]
+
+[[get-datadescription]]`data_description`:: 
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=data-description]
+
+`description`::
+(string) An optional description of the job.
+  
+`finished_time`::
+(string) If the job closed or failed, this is the time the job finished,
+otherwise it is `null`. This property is informational; you cannot change its
+value.
+
+`groups`::
+(array of strings)
+include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
+
+`job_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-define]
 +
 --
-* Contains wildcard expressions and there are no jobs that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches.
-
-The default value is `true`, which returns an empty `jobs` array 
-when there are no matches and the subset of results when there are partial 
-matches. If this parameter is `false`, the request returns a `404` status code
-when there are no matches or only partial matches.
+This property is informational; you cannot change the identifier for existing
+jobs.
 --
 
-[[ml-get-job-results]]
-==== {api-response-body-title}
+`job_type`::
+(string) Reserved for future use, currently set to `anomaly_detector`.
 
-The API returns the following information:
+`job_version`::
+(string) The version of {es} that existed on the node when the job was created.
 
-`jobs`::
-  (array) An array of {anomaly-job} resources.
-  For more information, see <<ml-job-resource>>.
+[[get-modelplotconfig]]`model_plot_config`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config]
+
+`model_snapshot_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-id]
++
+--
+This property is informational; you cannot change its value. 
+--
+
+`model_snapshot_retention_days`::
+(long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
+
+`renormalization_window_days`::
+(long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=renormalization-window-days]
+
+`results_index_name`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=results-index-name]
 
 [[ml-get-job-response-codes]]
 ==== {api-response-codes-title}
@@ -80,53 +146,68 @@ The API returns the following information:
 [[ml-get-job-example]]
 ==== {api-examples-title}
 
-The following example gets configuration information for the `total-requests` job:
+//The following example gets configuration information for the `total-requests` job:
 
 [source,console]
 --------------------------------------------------
-GET _ml/anomaly_detectors/total-requests
+GET _ml/anomaly_detectors/high_sum_total_sales
 --------------------------------------------------
-// TEST[skip:setup:server_metrics_job]
+// TEST[skip:Kibana sample data]
 
 The API returns the following results:
 
-[source,console-result]
+[source,js]
 ----
 {
   "count": 1,
   "jobs": [
     {
-      "job_id": "total-requests",
-      "job_type": "anomaly_detector",
-      "job_version": "7.0.0-alpha1",
-      "description": "Total sum of requests",
-      "create_time": 1517011406091,
-      "analysis_config": {
-        "bucket_span": "10m",
-        "detectors": [
+      "job_id" : "high_sum_total_sales",
+      "job_type" : "anomaly_detector",
+      "job_version" : "8.0.0",
+      "groups" : [
+        "kibana_sample_data",
+        "kibana_sample_ecommerce"
+      ],
+      "description" : "Find customers spending an unusually high amount in an hour",
+      "create_time" : 1575402224732,
+      "finished_time" : 1575402238311,
+      "analysis_config" : {
+        "bucket_span" : "1h",
+        "detectors" : [
           {
-            "detector_description": "Sum of total",
-            "function": "sum",
-            "field_name": "total",
-            "detector_index": 0
+            "detector_description" : "High total sales",
+            "function" : "high_sum",
+            "field_name" : "taxful_total_price",
+            "over_field_name" : "customer_full_name.keyword",
+            "detector_index" : 0
           }
         ],
-        "influencers": [ ]
+        "influencers" : [
+          "customer_full_name.keyword",
+          "category.keyword"
+        ]
+      },
+      "analysis_limits" : {
+        "model_memory_limit" : "10mb",
+        "categorization_examples_limit" : 4
+      },
+      "data_description" : {
+        "time_field" : "order_date",
+        "time_format" : "epoch_ms"
       },
-      "analysis_limits": {
-        "model_memory_limit": "1024mb",
-        "categorization_examples_limit": 4
+      "model_plot_config" : {
+        "enabled" : true
       },
-      "data_description": {
-        "time_field": "timestamp",
-        "time_format": "epoch_ms"
+      "model_snapshot_retention_days" : 1,
+      "custom_settings" : {
+        "created_by" : "ml-module-sample",
+        ...
       },
-      "model_snapshot_retention_days": 1,
-      "results_index_name": "shared",
-      "allow_lazy_open": false
+      "model_snapshot_id" : "1575402237",
+      "results_index_name" : "shared",
+      "allow_lazy_open" : false
     }
   ]
 }
 ----
-// TESTRESPONSE[s/"7.0.0-alpha1"/$body.$_path/]
-// TESTRESPONSE[s/1517011406091/$body.$_path/]
diff --git a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
index 43a7de51d9899..62acd7902b9ff 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
@@ -54,17 +54,14 @@ a span equal to the jobs' largest bucket span.
 [[ml-get-overall-buckets-path-parms]]
 ==== {api-path-parms-title}
 
-`<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}. It can be a job
-  identifier, a group name, a comma-separated list of jobs or groups, or a
-  wildcard expression.
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-wildcard-list]
 
 [[ml-get-overall-buckets-request-body]]
 ==== {api-request-body-title}
 
 `allow_no_jobs`::
-  (Optional, boolean) If `false` and the `job_id` does not match any
-  {anomaly-jobs}, an error occurs. The default value is `true`.
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 
 `bucket_span`::
   (Optional, string) The span of the overall buckets. Must be greater or equal
diff --git a/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
index a850524872c0a..b5bbb15580e19 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
@@ -26,7 +26,8 @@ privileges. See <<security-privileges>> and <<built-in-roles>>.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-get-record-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
index 04d09b50d3313..94b67f6f98b9d 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
@@ -26,7 +26,8 @@ Retrieves information about model snapshots.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
   (Optional, string) Identifier for the model snapshot. If you do not specify
diff --git a/docs/reference/ml/anomaly-detection/apis/jobresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/jobresource.asciidoc
deleted file mode 100644
index 3699e73ca51c3..0000000000000
--- a/docs/reference/ml/anomaly-detection/apis/jobresource.asciidoc
+++ /dev/null
@@ -1,561 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-job-resource]]
-=== Job resources
-
-A job resource has the following properties:
-
-`analysis_config`::
-  (object) The analysis configuration, which specifies how to analyze the data.
-  See <<ml-analysisconfig, analysis configuration objects>>.
-
-`analysis_limits`::
-  (object) Defines approximate limits on the memory resource requirements for the job.
-  See <<ml-apilimits,analysis limits>>.
-
-`background_persist_interval`::
-  (time units) Advanced configuration option.
-  The time between each periodic persistence of the model.
-  The default value is a randomized value between 3 to 4 hours, which avoids
-  all jobs persisting at exactly the same time. The smallest allowed value is
-  1 hour.
-+
---
-TIP: For very large models (several GB), persistence could take 10-20 minutes,
-so do not set the `background_persist_interval` value too low.
-
---
-
-`create_time`::
-  (string) The time the job was created. For example, `1491007356077`. This
-  property is informational; you cannot change its value.
-
-`custom_settings`::
-  (object) Advanced configuration option. Contains custom meta data about the
-  job. For example, it can contain custom URL information as shown in
-  {stack-ov}/ml-configuring-url.html[Adding Custom URLs to Machine Learning Results].
-
-`data_description`::
-  (object) Describes the data format and how APIs parse timestamp fields.
-  See <<ml-datadescription,data description objects>>.
-
-`description`::
-  (string) An optional description of the job.
-
-`finished_time`::
-  (string) If the job closed or failed, this is the time the job finished,
-  otherwise it is `null`. This property is informational; you cannot change its
-  value.
-
-`groups`::
-  (array of strings) A list of job groups.  A job can belong to no groups or
-  many. For example, `["group1", "group2"]`.
-
-`job_id`::
-  (string) The unique identifier for the job. This identifier can contain
-  lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It
-  must start and end with alphanumeric characters. This property is
-  informational; you cannot change the identifier for existing jobs.
-
-`job_type`::
-  (string) Reserved for future use, currently set to `anomaly_detector`.
-
-`job_version`::
- (string) The version of {es} that existed on the node when the job was created.
-
-`model_plot_config`::
-  (object) Configuration properties for storing additional model information.
-  See <<ml-apimodelplotconfig, model plot configuration>>.
-
-`model_snapshot_id`::
-  (string) A numerical character string that uniquely identifies the model
-  snapshot. For example, `1491007364`. This property is informational; you
-  cannot change its value. For more information about model snapshots, see
-  <<ml-snapshot-resource>>.
-
-`model_snapshot_retention_days`::
-  (long) The time in days that model snapshots are retained for the job.
-  Older snapshots are deleted. The default value is `1`, which means snapshots
-  are retained for one day (twenty-four hours).
-
-`renormalization_window_days`::
-  (long) Advanced configuration option.
-  The period over which adjustments to the score are applied, as new data is seen.
-  The default value is the longer of 30 days or 100 `bucket_spans`.
-
-`results_index_name`::
-  (string) The name of the index in which to store the {ml} results.
-  The default value is `shared`,
-  which corresponds to the index name `.ml-anomalies-shared`
-
-`results_retention_days`::
-  (long) Advanced configuration option.
-  The number of days for which job results are retained.
-  Once per day at 00:30 (server time), results older than this period are
-  deleted from Elasticsearch. The default value is null, which means results
-  are retained.
-
-`allow_lazy_open`::
-  (boolean) Advanced configuration option.
-  Whether this job should be allowed to open when there is insufficient
-  {ml} node capacity for it to be immediately assigned to a node.
-  The default is `false`, which means that the <<ml-open-job>>
-  will return an error if a {ml} node with capacity to run the
-  job cannot immediately be found. (However, this is also subject to
-  the cluster-wide `xpack.ml.max_lazy_ml_nodes` setting - see
-  <<advanced-ml-settings>>.) If this option is set to `true` then
-  the <<ml-open-job>> will not return an error, and the job will
-  wait in the `opening` state until sufficient {ml} node capacity
-  is available.
-
-[[ml-analysisconfig]]
-==== Analysis Configuration Objects
-
-An analysis configuration object has the following properties:
-
-`bucket_span`::
-  (time units) The size of the interval that the analysis is aggregated into,
-  typically between `5m` and `1h`. The default value is `5m`. For more 
-  information about time units, see <<time-units,Common options>>.
-
-`categorization_field_name`::
-  (string) If this property is specified, the values of the specified field will
-  be categorized. The resulting categories must be used in a detector by setting
-  `by_field_name`, `over_field_name`, or `partition_field_name` to the keyword
-  `mlcategory`. For more information, see
-  {stack-ov}/ml-configuring-categories.html[Categorizing Log Messages].
-
-`categorization_filters`::
-  (array of strings) If `categorization_field_name` is specified,
-  you can also define optional filters. This property expects an array of
-  regular expressions. The expressions are used to filter out matching sequences
-  from the categorization field values. You can use this functionality to fine
-  tune the categorization by excluding sequences from consideration when
-  categories are defined. For example, you can exclude SQL statements that
-  appear in your log files. For more information, see
-  {stack-ov}/ml-configuring-categories.html[Categorizing Log Messages].
-  This property cannot be used at the same time as `categorization_analyzer`.
-  If you only want to define simple regular expression filters that are applied
-  prior to tokenization, setting this property is the easiest method.
-  If you also want to customize the tokenizer or post-tokenization filtering,
-  use the `categorization_analyzer` property instead and include the filters as
-  `pattern_replace` character filters. The effect is exactly the same.
-
-`categorization_analyzer`::
-  (object or string) If `categorization_field_name` is specified, you can also
-  define the analyzer that is used to interpret the categorization field. This
-  property cannot be used at the same time as `categorization_filters`. See
-  <<ml-categorizationanalyzer,categorization analyzer>>.
-
-`detectors`::
-  (array) An array of detector configuration objects,
-  which describe the anomaly detectors that are used in the job.
-  See <<ml-detectorconfig,detector configuration objects>>. +
-+
---
-NOTE: If the `detectors` array does not contain at least one detector,
-no analysis can occur and an error is returned.
-
---
-
-`influencers`::
-  (array of strings) A comma separated list of influencer field names.
-  Typically these can be the by, over, or partition fields that are used in the
-  detector configuration. You might also want to use a field name that is not
-  specifically named in a detector, but is available as part of the input data.
-  When you use multiple detectors, the use of influencers is recommended as it
-  aggregates results for each influencer entity.
-
-`latency`::
-  (time units) The size of the window in which to expect data that is out of
-  time order. The default value is 0 (no latency). If you specify a non-zero
-  value, it must be greater than or equal to one second. For more information
-  about time units, see <<time-units,Common options>>.
-+
---
-NOTE: Latency is only applicable when you send data by using
-the <<ml-post-data,post data>> API.
-
---
-
-`multivariate_by_fields`::
-  (boolean) This functionality is reserved for internal use. It is not supported
-  for use in customer environments and is not subject to the support SLA of
-  official GA features.
-+
---
-If set to `true`, the analysis will automatically find correlations
-between metrics for a given `by` field value and report anomalies when those
-correlations cease to hold. For example, suppose CPU and memory usage on host A
-is usually highly correlated with the same metrics on host B. Perhaps this
-correlation occurs because they are running a load-balanced application.
-If you enable this property, then anomalies will be reported when, for example,
-CPU usage on host A is high and the value of CPU usage on host B is low.
-That is to say, you'll see an anomaly when the CPU of host A is unusual given
-the CPU of host B.
-
-NOTE: To use the `multivariate_by_fields` property, you must also specify
-`by_field_name` in your detector.
-
---
-
-`summary_count_field_name`::
-  (string) If this property is specified, the data that is fed to the job is
-  expected to be pre-summarized. This property value is the name of the field
-  that contains the count of raw data points that have been summarized. The same
-  `summary_count_field_name` applies to all detectors in the job.
-+
---
-
-NOTE: The `summary_count_field_name` property cannot be used with the `metric`
-function.
-
---
-
-After you create a job, you cannot change the analysis configuration object; all
-the properties are informational.
-
-[float]
-[[ml-detectorconfig]]
-==== Detector Configuration Objects
-
-Detector configuration objects specify which data fields a job analyzes.
-They also specify which analytical functions are used.
-You can specify multiple detectors for a job.
-Each detector has the following properties:
-
-`by_field_name`::
-  (string) The field used to split the data.
-  In particular, this property is used for analyzing the splits with respect to their own history.
-  It is used for finding unusual values in the context of the split.
-
-`detector_description`::
-  (string) A description of the detector. For example, `Low event rate`.
-
-`detector_index`::
-  (integer) A unique identifier for the detector. This identifier is based on
-  the order of the detectors in the `analysis_config`, starting at zero. You can
-  use this identifier when you want to update a specific detector.
-
-`exclude_frequent`::
-  (string) Contains one of the following values: `all`, `none`, `by`, or `over`.
-  If set, frequent entities are excluded from influencing the anomaly results.
-  Entities can be considered frequent over time or frequent in a population.
-  If you are working with both over and by fields, then you can set `exclude_frequent`
-  to `all` for both fields, or to `by` or `over` for those specific fields.
-
-`field_name`::
-  (string) The field that the detector uses in the function. If you use an event rate
-  function such as `count` or `rare`, do not specify this field. +
-+
---
-NOTE: The `field_name` cannot contain double quotes or backslashes.
-
---
-
-`function`::
-  (string) The analysis function that is used. 
-  For example, `count`, `rare`, `mean`, `min`, `max`, and `sum`. For more
-  information, see {stack-ov}/ml-functions.html[Function Reference].
-
-`over_field_name`::
-  (string) The field used to split the data.
-  In particular, this property is used for analyzing the splits with respect to
-  the history of all splits. It is used for finding unusual values in the
-  population of all splits. For more information, see
-  {stack-ov}/ml-configuring-pop.html[Performing population analysis].
-
-`partition_field_name`::
-  (string) The field used to segment the analysis.
-  When you use this property, you have completely independent baselines for each value of this field.
-
-`use_null`::
-  (boolean) Defines whether a new series is used as the null series
-  when there is no value for the by or partition fields. The default value is `false`.
-
-`custom_rules`::
-  (array) An array of custom rule objects, which enable customizing how the detector works.
-  For example, a rule may dictate to the detector conditions under which results should be skipped.
-  For more information see <<ml-detector-custom-rule,detector custom rule objects>>. +
-+
---
-IMPORTANT: Field names are case sensitive, for example a field named 'Bytes'
-is different from one named 'bytes'.
-
---
-
-After you create a job, the only properties you can change in the detector
-configuration object are the `detector_description` and the `custom_rules`;
-all other properties are informational.
-
-[float]
-[[ml-datadescription]]
-==== Data Description Objects
-
-The data description defines the format of the input data when you send data to
-the job by using the <<ml-post-data,post data>> API. Note that when configure
-a {dfeed}, these properties are automatically set.
-
-When data is received via the <<ml-post-data,post data>> API, it is not stored
-in {es}. Only the results for anomaly detection are retained.
-
-A data description object has the following properties:
-
-`format`::
-  (string) Only `JSON` format is supported at this time.
-
-`time_field`::
-  (string) The name of the field that contains the timestamp.
-  The default value is `time`.
-
-`time_format`::
-  (string) The time format, which can be `epoch`, `epoch_ms`, or a custom pattern.
-  The default value is `epoch`, which refers to UNIX or Epoch time (the number of seconds
-  since 1 Jan 1970).
-  The value `epoch_ms` indicates that time is measured in milliseconds since the epoch.
-  The `epoch` and `epoch_ms` time formats accept either integer or real values. +
-+
---
-NOTE: Custom patterns must conform to the Java `DateTimeFormatter` class.
-When you use date-time formatting patterns, it is recommended that you provide
-the full date, time and time zone. For example: `yyyy-MM-dd'T'HH:mm:ssX`.
-If the pattern that you specify is not sufficient to produce a complete timestamp,
-job creation fails.
-
---
-
-[float]
-[[ml-categorizationanalyzer]]
-==== Categorization Analyzer
-
-The categorization analyzer specifies how the `categorization_field` is
-interpreted by the categorization process. The syntax is very similar to that
-used to define the `analyzer` in the <<indices-analyze,Analyze endpoint>>.
-
-The `categorization_analyzer` field can be specified either as a string or as
-an object.
-
-If it is a string it must refer to a <<analysis-analyzers,built-in analyzer>> or
-one added by another plugin.
-
-If it is an object it has the following properties:
-
-`char_filter`::
-  (array of strings or objects) One or more
-  <<analysis-charfilters,character filters>>. In addition to the built-in
-  character filters, other plugins can provide more character filters. This
-  property is optional. If it is not specified, no character filters are applied
-  prior to categorization. If you are customizing some other aspect of the
-  analyzer and you need to achieve the equivalent of `categorization_filters`
-  (which are not permitted when some other aspect of the analyzer is customized),
-  add them here as
-  <<analysis-pattern-replace-charfilter,pattern replace character filters>>.
-
-`tokenizer`::
-  (string or object) The name or definition of the
-  <<analysis-tokenizers,tokenizer>> to use after character filters are applied.
-  This property is compulsory if `categorization_analyzer` is specified as an
-  object. Machine learning provides a tokenizer called `ml_classic` that
-  tokenizes in the same way as the non-customizable tokenizer in older versions
-  of the product. If you want to use that tokenizer but change the character or
-  token filters, specify `"tokenizer": "ml_classic"` in your
-  `categorization_analyzer`.
-
-`filter`::
-  (array of strings or objects) One or more
-  <<analysis-tokenfilters,token filters>>. In addition to the built-in token
-  filters, other plugins can provide more token filters. This property is
-  optional. If it is not specified, no token filters are applied prior to
-  categorization.
-
-If you omit the `categorization_analyzer`, the following default values are used:
-
-[source,console]
---------------------------------------------------
-POST _ml/anomaly_detectors/_validate
-{
-  "analysis_config" : {
-    "categorization_analyzer" : {
-      "tokenizer" : "ml_classic",
-      "filter" : [
-        { "type" : "stop", "stopwords": [
-          "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday",
-          "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun",
-          "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December",
-          "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
-          "GMT", "UTC"
-        ] }
-      ]
-    },
-    "categorization_field_name": "message",
-    "detectors" :[{
-      "function":"count",
-      "by_field_name": "mlcategory"
-    }]
-  },
-  "data_description" : {
-  }
-}
---------------------------------------------------
-
-If you specify any part of the `categorization_analyzer`, however, any omitted
-sub-properties are _not_ set to default values.
-
-If you are categorizing non-English messages in a language where words are
-separated by spaces, you might get better results if you change the day or month
-words in the stop token filter to the appropriate words in your language. If you
-are categorizing messages in a language where words are not separated by spaces,
-you must use a different tokenizer as well in order to get sensible
-categorization results.
-
-It is important to be aware that analyzing for categorization of machine
-generated log messages is a little different from tokenizing for search.
-Features that work well for search, such as stemming, synonym substitution, and
-lowercasing are likely to make the results of categorization worse. However, in
-order for drill down from {ml} results to work correctly, the tokens that the
-categorization analyzer produces must be similar to those produced by the search
-analyzer. If they are sufficiently similar, when you search for the tokens that
-the categorization analyzer produces then you find the original document that
-the categorization field value came from.
-
-For more information, see
-{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
-
-[float]
-[[ml-detector-custom-rule]]
-==== Detector Custom Rule
-
-{stack-ov}/ml-rules.html[Custom rules] enable you to customize the way detectors 
-operate. 
-
-A custom rule has the following properties:
-
-`actions`::
-  (array) The set of actions to be triggered when the rule applies.
-  If more than one action is specified the effects of all actions are combined.
-  The available actions include: +
-  `skip_result`::: The result will not be created. This is the default value.
-  Unless you also specify `skip_model_update`, the model will be updated as
-  usual with the corresponding series value.
-  `skip_model_update`::: The value for that series will not be used to update
-  the model. Unless you also specify `skip_result`, the results will be created
-  as usual. This action is suitable when certain values are expected to be
-  consistently anomalous and they affect the model in a way that negatively
-  impacts the rest of the results.
-  
-`scope`::
-  (object) An optional scope of series where the rule applies. By default, the 
-  scope includes all series. Scoping is allowed for any of the fields that are 
-  also specified in `by_field_name`, `over_field_name`, or `partition_field_name`.
-  To add a scope for a field, add the field name as a key in the scope object and
-  set its value to an object with the following properties:  
-`filter_id`:::
-  (string) The id of the filter to be used.
-
-`filter_type`:::
-  (string) Either `include` (the rule applies for values in the filter)
-  or `exclude` (the rule applies for values not in the filter). Defaults
-  to `include`.    
-
-`conditions`::
-  (array) An optional array of numeric conditions when the rule applies.
-  Multiple conditions are combined together with a logical `AND`.
-+
---
-NOTE: If your detector uses `lat_long`, `metric`, `rare`, or `freq_rare` 
-functions, you can only specify `conditions` that apply to `time`.
-
-  
-A condition has the following properties: 
-
-`applies_to`:::
-    (string) Specifies the result property to which the condition applies.
-    The available options are `actual`, `typical`, `diff_from_typical`, `time`.
-`operator`:::
-    (string) Specifies the condition operator. The available options are
-    `gt` (greater than), `gte` (greater than or equals), `lt` (less than) and `lte` (less than or equals).
-`value`:::
-    (double) The value that is compared against the `applies_to` field using the `operator`.
---
-
-A rule is required to either have a non-empty scope or at least one condition.
-For more examples see 
-{stack-ov}/ml-configuring-detector-custom-rules.html[Configuring Detector Custom Rules].
-
-[float]
-[[ml-apilimits]]
-==== Analysis Limits
-
-Limits can be applied for the resources required to hold the mathematical models in memory.
-These limits are approximate and can be set per job. They do not control the
-memory used by other processes, for example the Elasticsearch Java processes.
-If necessary, you can increase the limits after the job is created.
-
-The `analysis_limits` object has the following properties:
-
-`categorization_examples_limit`::
-  (long) The maximum number of examples stored per category in memory and
-  in the results data store. The default value is 4.  If you increase this value,
-  more examples are available, however it requires that you have more storage available.
-  If you set this value to `0`, no examples are stored. +
-+
---
-NOTE: The `categorization_examples_limit` only applies to analysis that uses categorization.
-For more information, see
-{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
-
---
-
-`model_memory_limit`::
-  (long or string) The approximate maximum amount of memory resources that are
-  required for analytical processing. Once this limit is approached, data pruning
-  becomes more aggressive. Upon exceeding this limit, new entities are not
-  modeled. The default value for jobs created in version 6.1 and later is `1024mb`.
-  This value will need to be increased for jobs that are expected to analyze high
-  cardinality fields, but the default is set to a relatively small size to ensure
-  that high resource usage is a conscious decision. The default value for jobs
-  created in versions earlier than 6.1 is `4096mb`.
-+
---
-If you specify a number instead of a string, the units are assumed to be MiB.
-Specifying a string is recommended for clarity. If you specify a byte size unit
-of `b` or `kb` and the number does not equate to a discrete number of megabytes,
-it is rounded down to the closest MiB. The minimum valid value is 1 MiB. If you
-specify a value less than 1 MiB, an error occurs. For more information about
-supported byte size units, see <<byte-units,Common options>>.
-
-If your `elasticsearch.yml` file contains an `xpack.ml.max_model_memory_limit`
-setting, an error occurs when you try to create jobs that have
-`model_memory_limit` values greater than that setting. For more information,
-see <<ml-settings>>.
---
-
-[float]
-[[ml-apimodelplotconfig]]
-==== Model Plot Config
-
-This advanced configuration option stores model information along with the
-results. It provides a more detailed view into anomaly detection.
-
-WARNING: If you enable model plot it can add considerable overhead to the performance
-of the system; it is not feasible for jobs with many entities.
-
-Model plot provides a simplified and indicative view of the model and its bounds.
-It does not display complex features such as multivariate correlations or multimodal data.
-As such, anomalies may occasionally be reported which cannot be seen in the model plot.
-
-Model plot config can be configured when the job is created or updated later. It must be
-disabled if performance issues are experienced.
-
-The `model_plot_config` object has the following properties:
-
-`enabled`::
-  (boolean) If true, enables calculation and storage of the model bounds for
-  each entity that is being analyzed. By default, this is not enabled.
-
-`terms`::
-  experimental[] (string) Limits data collection to this comma separated list of 
-  partition or by field values. If terms are not specified or it is an empty 
-  string, no filtering is applied. For example, "CPU,NetworkIn,DiskWrites". 
-  Wildcards are not supported. Only the specified `terms` can be viewed when 
-  using the Single Metric Viewer.
diff --git a/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
index 5914ec502f104..3651834480f10 100644
--- a/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
@@ -37,7 +37,8 @@ data is received.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-open-job-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
index a1e2120728acd..cfd3d4ca67fdc 100644
--- a/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
@@ -53,7 +53,8 @@ or a comma-separated list.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-		(Required, string) Identifier for the job.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-post-data-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
index 7ba652b60a192..767a3d3d5bae5 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
@@ -27,8 +27,8 @@ Adds an {anomaly-job} to a calendar.
   (Required, string) Identifier for the calendar.
 
 `<job_id>`::
-  (Required, string) An identifier for the {anomaly-jobs}. It can be a job
-  identifier, a group name, or a comma-separated list of jobs or groups.
+(Required, string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-list]
 
 [[ml-put-calendar-job-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
index 899f8cfe5cd96..ca3b9d61ba7a1 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
@@ -97,10 +97,9 @@ not be set to `false` on any ML node.
 
 `script_fields`::
   (Optional, object) Specifies scripts that evaluate custom expressions and
-  returns script fields to the {dfeed}. The
-  <<ml-detectorconfig,detector configuration objects>> in a job can contain
-  functions that use these script fields. For more information, see
-  <<request-body-search-script-fields,Script fields>>.
+  returns script fields to the {dfeed}. The detector configuration objects in a
+  job can contain functions that use these script fields. For more information,
+  see <<request-body-search-script-fields,Script fields>>.
 
 `scroll_size`::
   (Optional, unsigned integer) The `size` parameter that is used in {es}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
index 12fadac25d6d9..3ff63bf927757 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
@@ -25,7 +25,7 @@ Instantiates a filter.
 
 A {stack-ov}/ml-rules.html[filter] contains a list of strings. 
 It can be used by one or more jobs. Specifically, filters are referenced in 
-the `custom_rules` property of <<ml-detectorconfig,detector configuration objects>>. 
+the `custom_rules` property of detector configuration objects. 
 
 [[ml-put-filter-path-parms]]
 ==== {api-path-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
index 69230160d2715..15f4ae3466968 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
@@ -32,64 +32,62 @@ a job directly to the `.ml-config` index using the {es} index API. If {es}
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the job. This identifier can contain
-  lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It
-  must start and end with alphanumeric characters.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-define]
 
 [[ml-put-job-request-body]]
 ==== {api-request-body-title}
 
-`analysis_config`::
-  (Required, object) The analysis configuration, which specifies how to analyze
-  the data. See <<ml-analysisconfig, analysis configuration objects>>.
+`allow_lazy_open`::
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
 
-`analysis_limits`::
-  (Optional, object) Specifies runtime limits for the job. See
-  <<ml-apilimits,analysis limits>>.
+[[put-analysisconfig]]`analysis_config`::
+(Required, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-config]
+
+[[put-analysislimits]]`analysis_limits`::
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-limits]
 
 `background_persist_interval`::
-  (Optional, <<time-units, time units>>) Advanced configuration option. The time 
-  between each periodic persistence of the model. See <<ml-job-resource>>.
+(Optional, <<time-units, time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=background-persist-interval]
 
-`custom_settings`::
-  (Optional, object) Advanced configuration option. Contains custom meta data
-  about the job. See <<ml-job-resource>>.
+[[put-customsettings]]`custom_settings`::
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-settings]
 
-`data_description`::
-  (Required, object) Describes the format of the input data. This object is
-  required, but it can be empty (`{}`). See
-    <<ml-datadescription,data description objects>>.
+[[put-datadescription]]`data_description`::
+(Required, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=data-description]
 
 `description`::
   (Optional, string) A description of the job.
 
 `groups`::
-  (Optional, array of strings) A list of job groups. See <<ml-job-resource>>.
+(Optional, array of strings)
+include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
 
 `model_plot_config`::
-  (Optional, object) Advanced configuration option. Specifies to store model 
-  information along with the results. This adds overhead to the performance of
-  the system and is not feasible for jobs with many entities, see
-  <<ml-apimodelplotconfig>>.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config]
 
 `model_snapshot_retention_days`::
-  (Optional, long) The time in days that model snapshots are retained for the
-  job. Older snapshots are deleted. The default value is `1`, which means
-  snapshots are retained for one day (twenty-four hours). 
+(Optional, long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
 
 `renormalization_window_days`::
-  (Optional, long) Advanced configuration option. The period over which
-  adjustments to the score are applied, as new data is seen. See
-  <<ml-job-resource>>.
+(Optional, long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=renormalization-window-days]
 
 `results_index_name`::
-  (Optional, string) A text string that affects the name of the {ml} results
-  index. The default value is `shared`, which generates an index named
-  `.ml-anomalies-shared`. 
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=results-index-name]
 
 `results_retention_days`::
-  (Optional, long) Advanced configuration option. The number of days for which
-  job results are retained. See <<ml-job-resource>>.
+(Optional, long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=results-retention-days]
 
 [[ml-put-job-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
index f04db39e25eb8..d8cfc091b810f 100644
--- a/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
@@ -36,7 +36,8 @@ Friday or a critical system failure.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the job.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
   (Required, string) Identifier for the model snapshot.
diff --git a/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
index 732f23202b1bf..d201d6cd093b2 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
@@ -92,10 +92,9 @@ parallel and close one when you are satisfied with the results of the other job.
 
 `script_fields`::
   (Optional, object) Specifies scripts that evaluate custom expressions and
-  returns script fields to the {dfeed}. The
-  <<ml-detectorconfig,detector configuration objects>> in a job can contain
-  functions that use these script fields. For more information, see
-  <<request-body-search-script-fields,Script fields>>.
+  returns script fields to the {dfeed}. The detector configuration objects in a
+  job can contain functions that use these script fields. For more information,
+  see <<request-body-search-script-fields,Script fields>>.
 
 `scroll_size`::
   (Optional, unsigned integer) The `size` parameter that is used in {es}
diff --git a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
index 2af969dc993f1..09e6e03e57d5f 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
@@ -25,72 +25,94 @@ Updates certain properties of an {anomaly-job}.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-update-job-request-body]]
 ==== {api-request-body-title}
 
 The following properties can be updated after the job is created:
 
-[cols="<,<,<",options="header",]
-|=======================================================================
-|Name |Description |Requires Restart
-
-|`analysis_limits.model_memory_limit` |The approximate maximum amount of
-memory resources required for analytical processing. See <<ml-apilimits>>. You 
-can update the `analysis_limits` only while the job is closed. The 
-`model_memory_limit` property value cannot be decreased below the current usage. 
-| Yes  
-
-|`background_persist_interval` |Advanced configuration option. The time between
-each periodic persistence of the model. See <<ml-job-resource>>. | Yes
-
-|`custom_settings` |Contains custom meta data about the job. | No
-
-|`description` |A description of the job. See <<ml-job-resource>>. | No
-
-|`detectors` |An array of detector update objects. | No
-
-|`detector_index` |The identifier of the detector to update (integer).| No
+`allow_lazy_open`::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
++
+--
+NOTE: If the job is open when you make the update, you must stop the {dfeed},
+close the job, then reopen the job and restart the {dfeed} for the changes to take effect.
 
-|`detectors.description` |The new description for the detector.| No
+--
 
-|`detectors.custom_rules` |The new list of <<ml-detector-custom-rule, rules>> 
-for the detector. | No
+`detectors`::
+`custom_rules`:::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
+`description`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
+`detector_index`:::
+(integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+
+[[update-analysislimits]]`analysis_limits`::
+`model_memory_limit`:::
+(long or string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
++
+--
+NOTE: You can update the `analysis_limits` only while the job is closed. The 
+`model_memory_limit` property value cannot be decreased below the current usage.
+ 
+TIP: If the `memory_status` property in the
+<<ml-snapshot-stats,`model_size_stats` object>> has a value of `hard_limit`,
+this means that it was unable to process some data. You might want to re-run
+the job with an increased `model_memory_limit`.
 
-|`groups` |A list of job groups. See <<ml-job-resource>>. | No
+--
 
-|`model_plot_config.enabled` |If true, enables calculation and storage of the
-model bounds for each entity that is being analyzed.
-See <<ml-apimodelplotconfig>>. | No
+`background_persist_interval`::
+(<<time-units,time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=background-persist-interval]
++
+--
+NOTE: If the job is open when you make the update, you must stop the {dfeed},
+close the job, then reopen the job and restart the {dfeed} for the changes to take effect.
 
-|`model_snapshot_retention_days` |The time in days that model snapshots are
-retained for the job. See <<ml-job-resource>>. | No
+--
 
-|`renormalization_window_days` |Advanced configuration option. The period over
-which adjustments to the score are applied, as new data is seen.
-See <<ml-job-resource>>. | Yes
+[[update-customsettings]]`custom_settings`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-settings]
 
-|`results_retention_days` |Advanced configuration option. The number of days
-for which job results are retained. See <<ml-job-resource>>. | No
+`description`::
+(string) A description of the job.
 
-|`allow_lazy_open` |Advanced configuration option. Whether to allow the job to be
-opened when no {ml} node has sufficient capacity. See <<ml-job-resource>>. | Yes
+`groups`::
+(array of strings)
+include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
 
-|=======================================================================
+`model_plot_config`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config]
 
-For those properties that have `Requires Restart` set to `Yes` in this table,
-if the job is open when you make the update, you must stop the data feed, close
-the job, then reopen the job and restart the data feed for the changes to take
-effect.
+`model_snapshot_retention_days`::
+(long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
 
-[NOTE]
+`renormalization_window_days`::
+(long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=renormalization-window-days]
++
 --
-* If the `memory_status` property in the `model_size_stats` object has a value
-of `hard_limit`, this means that it was unable to process some data. You might
-want to re-run this job with an increased `model_memory_limit`.
+NOTE: If the job is open when you make the update, you must stop the {dfeed},
+close the job, then reopen the job and restart the {dfeed} for the changes to take effect.
+
 --
 
+`results_retention_days`::
+(long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=results-retention-days]
+
 
 [[ml-update-job-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
index 1eb3e78e69ef4..10f7228fd9b2a 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
@@ -25,7 +25,8 @@ Updates certain properties of a snapshot.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the {anomaly-job}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
   (Required, string) Identifier for the model snapshot.
diff --git a/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
index 74f7e717a0633..41d7e1e479c1c 100644
--- a/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
@@ -29,8 +29,7 @@ before you create an {anomaly-job}.
 [[ml-valid-detector-request-body]]
 ==== {api-request-body-title}
 
-For a list of the properties that you can specify in the body of this API,
-see <<ml-detectorconfig,detector configuration objects>>.
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector]
 
 [[ml-valid-detector-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
index 8b094d36b2742..a741242922d20 100644
--- a/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
@@ -30,7 +30,7 @@ create the job.
 ==== {api-request-body-title}
 
 For a list of the properties that you can specify in the body of this API,
-see <<ml-job-resource>>.
+see <<ml-put-job-request-body>>.
 
 [[ml-valid-job-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/categories.asciidoc b/docs/reference/ml/anomaly-detection/categories.asciidoc
index a5e4d05541617..79c349509156b 100644
--- a/docs/reference/ml/anomaly-detection/categories.asciidoc
+++ b/docs/reference/ml/anomaly-detection/categories.asciidoc
@@ -144,7 +144,39 @@ language.
 The optional `categorization_analyzer` property allows even greater customization
 of how categorization interprets the categorization field value. It can refer to
 a built-in {es} analyzer or a combination of zero or more character filters,
-a tokenizer, and zero or more token filters.
+a tokenizer, and zero or more token filters. If you omit the
+`categorization_analyzer`, the following default values are used:
+
+[source,console]
+--------------------------------------------------
+POST _ml/anomaly_detectors/_validate
+{
+  "analysis_config" : {
+    "categorization_analyzer" : {
+      "tokenizer" : "ml_classic",
+      "filter" : [
+        { "type" : "stop", "stopwords": [
+          "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday",
+          "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun",
+          "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December",
+          "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
+          "GMT", "UTC"
+        ] }
+      ]
+    },
+    "categorization_field_name": "message",
+    "detectors" :[{
+      "function":"count",
+      "by_field_name": "mlcategory"
+    }]
+  },
+  "data_description" : {
+  }
+}
+--------------------------------------------------
+
+If you specify any part of the `categorization_analyzer`, however, any omitted
+sub-properties are _not_ set to default values.
 
 The `ml_classic` tokenizer and the day and month stopword filter are more or less
 equivalent to the following analyzer, which is defined using only built-in {es}
@@ -208,8 +240,22 @@ difference in behavior is that this custom analyzer does not include accented
 letters in tokens whereas the `ml_classic` tokenizer does, although that could
 be fixed by using more complex regular expressions.
 
-For more information about the `categorization_analyzer` property, see
-{ref}/ml-job-resource.html#ml-categorizationanalyzer[Categorization analyzer].
+If you are categorizing non-English messages in a language where words are
+separated by spaces, you might get better results if you change the day or month
+words in the stop token filter to the appropriate words in your language. If you
+are categorizing messages in a language where words are not separated by spaces,
+you must use a different tokenizer as well in order to get sensible
+categorization results.
+
+It is important to be aware that analyzing for categorization of machine
+generated log messages is a little different from tokenizing for search.
+Features that work well for search, such as stemming, synonym substitution, and
+lowercasing are likely to make the results of categorization worse. However, in
+order for drill down from {ml} results to work correctly, the tokens that the
+categorization analyzer produces must be similar to those produced by the search
+analyzer. If they are sufficiently similar, when you search for the tokens that
+the categorization analyzer produces then you find the original document that
+the categorization field value came from.
 
 NOTE: To add the `categorization_analyzer` property in {kib}, you must use the
 **Edit JSON** tab and copy the `categorization_analyzer` object from one of the
diff --git a/docs/reference/ml/anomaly-detection/functions.asciidoc b/docs/reference/ml/anomaly-detection/functions.asciidoc
index d821a3ff4c023..a5e8d35af26bf 100644
--- a/docs/reference/ml/anomaly-detection/functions.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions.asciidoc
@@ -7,8 +7,7 @@ flexible ways to analyze data for anomalies.
 
 When you create {anomaly-jobs}, you specify one or more detectors, which define
 the type of analysis that needs to be done. If you are creating your job by
-using {ml} APIs, you specify the functions in
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+using {ml} APIs, you specify the functions in detector configuration objects.
 If you are creating your job in {kib}, you specify the functions differently
 depending on whether you are creating single metric, multi-metric, or advanced
 jobs.
diff --git a/docs/reference/ml/anomaly-detection/functions/count.asciidoc b/docs/reference/ml/anomaly-detection/functions/count.asciidoc
index fe81fc5f59620..9310bf4fa0703 100644
--- a/docs/reference/ml/anomaly-detection/functions/count.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions/count.asciidoc
@@ -39,8 +39,8 @@ These functions support the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties,
-see {ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 1: Analyzing events with the count function
 [source,console]
@@ -164,8 +164,8 @@ These functions support the following properties:
 * `by_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties,
-see {ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 For example, if you have the following number of events per bucket:
 
@@ -233,8 +233,8 @@ These functions support the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties,
-see {ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 6: Analyzing users with the distinct_count function
 [source,console]
diff --git a/docs/reference/ml/anomaly-detection/functions/geo.asciidoc b/docs/reference/ml/anomaly-detection/functions/geo.asciidoc
index 20b8e6816ef7e..5eba44645f159 100644
--- a/docs/reference/ml/anomaly-detection/functions/geo.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions/geo.asciidoc
@@ -25,8 +25,8 @@ This function supports the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties,
-see {ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 1: Analyzing transactions with the lat_long function
 [source,console]
diff --git a/docs/reference/ml/anomaly-detection/functions/info.asciidoc b/docs/reference/ml/anomaly-detection/functions/info.asciidoc
index 18eb6d9f4e987..61913e539ce0b 100644
--- a/docs/reference/ml/anomaly-detection/functions/info.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions/info.asciidoc
@@ -28,8 +28,8 @@ These functions support the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 1: Analyzing subdomain strings with the info_content function
 [source,js]
diff --git a/docs/reference/ml/anomaly-detection/functions/metric.asciidoc b/docs/reference/ml/anomaly-detection/functions/metric.asciidoc
index cb44b61849a22..9ae29cf8a50d1 100644
--- a/docs/reference/ml/anomaly-detection/functions/metric.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions/metric.asciidoc
@@ -34,8 +34,8 @@ This function supports the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 1: Analyzing minimum transactions with the min function
 [source,js]
@@ -69,8 +69,8 @@ This function supports the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 2: Analyzing maximum response times with the max function
 [source,js]
@@ -132,7 +132,7 @@ These functions support the following properties:
 * `partition_field_name` (optional)
 
 For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 4: Analyzing response times with the median function
 [source,js]
@@ -169,8 +169,8 @@ These functions support the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 5: Analyzing response times with the mean function
 [source,js]
@@ -237,8 +237,8 @@ This function supports the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 8: Analyzing response times with the metric function
 [source,js]
@@ -274,8 +274,8 @@ These functions support the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 9: Analyzing response times with the varp function
 [source,js]
diff --git a/docs/reference/ml/anomaly-detection/functions/rare.asciidoc b/docs/reference/ml/anomaly-detection/functions/rare.asciidoc
index 94931191a267b..f56b0fb8d076f 100644
--- a/docs/reference/ml/anomaly-detection/functions/rare.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions/rare.asciidoc
@@ -46,8 +46,8 @@ This function supports the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 1: Analyzing status codes with the rare function
 [source,js]
@@ -105,8 +105,8 @@ This function supports the following properties:
 * `over_field_name` (required)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 3: Analyzing URI values in a population with the freq_rare function
 [source,js]
diff --git a/docs/reference/ml/anomaly-detection/functions/sum.asciidoc b/docs/reference/ml/anomaly-detection/functions/sum.asciidoc
index 260fc3f726c53..387769c80f333 100644
--- a/docs/reference/ml/anomaly-detection/functions/sum.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions/sum.asciidoc
@@ -35,8 +35,8 @@ These functions support the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 1: Analyzing total expenses with the sum function
 [source,js]
@@ -91,8 +91,8 @@ These functions support the following properties:
 * `by_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 NOTE: Population analysis (that is to say, use of the `over_field_name` property)
 is not applicable for this function.
diff --git a/docs/reference/ml/anomaly-detection/functions/time.asciidoc b/docs/reference/ml/anomaly-detection/functions/time.asciidoc
index 22cab11151d1a..cdf11cba4470d 100644
--- a/docs/reference/ml/anomaly-detection/functions/time.asciidoc
+++ b/docs/reference/ml/anomaly-detection/functions/time.asciidoc
@@ -53,8 +53,8 @@ This function supports the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 1: Analyzing events with the time_of_day function
 [source,js]
@@ -84,8 +84,8 @@ This function supports the following properties:
 * `over_field_name` (optional)
 * `partition_field_name` (optional)
 
-For more information about those properties, see
-{ref}/ml-job-resource.html#ml-detectorconfig[Detector configuration objects].
+For more information about those properties, see the
+{ref}/ml-put-job.html#ml-put-job-request-body[create {anomaly-jobs} API].
 
 .Example 2: Analyzing events with the time_of_week function
 [source,js]
diff --git a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
index 7816931161bb4..3f27c91fd016f 100644
--- a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
@@ -26,7 +26,8 @@ information, see <<security-privileges>> and <<built-in-roles>>.
 ==== {api-path-parms-title}
 
 `<data_frame_analytics_id>`::
-  (Required, string) Identifier for the {dfanalytics-job} you want to delete.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
 
 [[ml-delete-dfanalytics-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
index c9ee565e9b2c5..fb867b53ce165 100644
--- a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
@@ -43,10 +43,8 @@ about either an existing {dfanalytics-job} or one that has not been created yet.
 ==== {api-path-parms-title}
 
 `<data_frame_analytics_id>`::
-  (Optional, string) A numerical character string that uniquely identifies the existing
-  {dfanalytics-job} to explain. This identifier can contain lowercase alphanumeric
-  characters (a-z and 0-9), hyphens, and underscores. It must start and end with
-  alphanumeric characters.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
 
 [[ml-explain-dfanalytics-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
index ab065e2622da6..dcdb66689936f 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
@@ -36,27 +36,16 @@ information, see <<security-privileges>> and <<built-in-roles>>.
 ==== {api-path-parms-title}
 
 `<data_frame_analytics_id>`::
-  (Optional, string)Identifier for the {dfanalytics-job}. If you do not specify
-  one of these options, the API returns information for the first hundred
-  {dfanalytics-jobs}.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-default]
 
 
 [[ml-get-dfanalytics-stats-query-params]]
 ==== {api-query-parms-title}
 
 `allow_no_match`::
-  (Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no {dfanalytics-jobs} that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
-
-The default value is `true`, which returns an empty `data_frame_analytics` array 
-when there are no matches and the subset of results when there are partial 
-matches. If this parameter is `false`, the request returns a `404` status code 
-when there are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 
 `from`::
   (Optional, integer) Skips the specified number of {dfanalytics-jobs}. The
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index ddc8f35f280e6..5b0987e41c4bc 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -86,11 +86,8 @@ single number. For example, in case of age ranges, you can model the values as
 ==== {api-path-parms-title}
 
 `<data_frame_analytics_id>`::
-  (Required, string) A numerical character string that uniquely identifies the 
-  {dfanalytics-job}. This identifier can contain lowercase alphanumeric
-  characters (a-z and 0-9), hyphens, and underscores. It must start and end with
-  alphanumeric characters.
-
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
 
 [[ml-put-dfanalytics-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
index 9ffbfc3d9c23e..ba8b4169034a4 100644
--- a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
@@ -29,9 +29,8 @@ more information, see <<security-privileges>> and <<built-in-roles>>.
 ==== {api-path-parms-title}
 
 `<data_frame_analytics_id>`::
-  (Required, string) Identifier for the {dfanalytics-job}. This identifier can
-  contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and
-  underscores. It must start and end with alphanumeric characters.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
 
 [[ml-start-dfanalytics-query-params]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
index 8c9f705062cb6..ce3a932f1b07d 100644
--- a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
@@ -42,9 +42,8 @@ stop all {dfanalytics-job} by using _all or by specifying * as the
 ==== {api-path-parms-title}
 
 `<data_frame_analytics_id>`::
-  (Required, string) Identifier for the {dfanalytics-job}. This identifier can
-  contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and
-  underscores. It must start and end with alphanumeric characters.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
   
 [[ml-stop-dfanalytics-query-params]]
 ==== {api-query-parms-title}  
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index cac244d7135cf..11e062796afa6 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -1,3 +1,306 @@
+tag::allow-lazy-open[]
+Advanced configuration option. Specifies whether this job can open when there is 
+insufficient {ml} node capacity for it to be immediately assigned to a node. The
+default value is `false`; if a {ml} node with capacity to run the job cannot immediately be found, the <<ml-open-job,open {anomaly-jobs} API>> returns an
+error. However, this is also subject to the cluster-wide 
+`xpack.ml.max_lazy_ml_nodes` setting; see <<advanced-ml-settings>>. If this
+option is set to `true`, the <<ml-open-job,open {anomaly-jobs} API>> does not
+return an error and the job waits in the `opening` state until sufficient {ml}
+node capacity is available.
+end::allow-lazy-open[]
+
+tag::allow-no-jobs[]
+Specifies what to do when the request:
++
+--
+* Contains wildcard expressions and there are no jobs that match.
+* Contains the `_all` string or no identifiers and there are no matches.
+* Contains wildcard expressions and there are only partial matches.
+
+The default value is `true`, which returns an empty `jobs` array 
+when there are no matches and the subset of results when there are partial 
+matches. If this parameter is `false`, the request returns a `404` status code
+when there are no matches or only partial matches.
+--
+end::allow-no-jobs[]
+
+tag::allow-no-match[]
+ Specifies what to do when the request:
++
+--
+* Contains wildcard expressions and there are no {dfanalytics-jobs} that match.
+* Contains the `_all` string or no identifiers and there are no matches.
+* Contains wildcard expressions and there are only partial matches. 
+
+The default value is `true`, which returns an empty `data_frame_analytics` array 
+when there are no matches and the subset of results when there are partial 
+matches. If this parameter is `false`, the request returns a `404` status code 
+when there are no matches or only partial matches.
+--
+end::allow-no-match[]
+
+tag::analysis-config[]
+The analysis configuration, which specifies how to analyze the data.
+After you create a job, you cannot change the analysis configuration; all
+the properties are informational. An analysis configuration object has the following properties:
+
+`bucket_span`:::
+(<<time-units,time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span]
+
+`categorization_field_name`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-field-name]
+
+`categorization_filters`:::
+(array of strings)
+include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-filters]
+
+`categorization_analyzer`:::
+(object or string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-analyzer]
+
+`detectors`:::
+(array) An array of detector configuration objects. Detector configuration
+objects specify which data fields a job analyzes. They also specify which
+analytical functions are used. You can specify multiple detectors for a job. 
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector]
++
+--
+NOTE: If the `detectors` array does not contain at least one detector,
+no analysis can occur and an error is returned.
+
+--
+
+`influencers`:::
+(array of strings)
+include::{docdir}/ml/ml-shared.asciidoc[tag=influencers]
+
+`latency`:::
+(time units)
+include::{docdir}/ml/ml-shared.asciidoc[tag=latency]
+
+`multivariate_by_fields`:::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=multivariate-by-fields]
+
+`summary_count_field_name`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=summary-count-field-name]
+
+end::analysis-config[]
+
+tag::analysis-limits[]
+Limits can be applied for the resources required to hold the mathematical models
+in memory. These limits are approximate and can be set per job. They do not
+control the memory used by other processes, for example the {es} Java
+processes. If necessary, you can increase the limits after the job is created.
+The `analysis_limits` object has the following properties:
+
+`categorization_examples_limit`:::
+(long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-examples-limit]
+
+`model_memory_limit`:::
+(long or string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
+end::analysis-limits[]
+
+tag::background-persist-interval[]
+Advanced configuration option. The time between each periodic persistence of the 
+model. The default value is a randomized value between 3 to 4 hours, which
+avoids all jobs persisting at exactly the same time. The smallest allowed value
+is 1 hour.
++
+--
+TIP: For very large models (several GB), persistence could take 10-20 minutes,
+so do not set the `background_persist_interval` value too low.
+
+--
+end::background-persist-interval[]
+
+tag::bucket-span[]
+The size of the interval that the analysis is aggregated into, typically between
+`5m` and `1h`. The default value is `5m`. For more information about time units,
+see <<time-units>>.
+end::bucket-span[]
+
+tag::by-field-name[]
+The field used to split the data. In particular, this property is used for 
+analyzing the splits with respect to their own history. It is used for finding 
+unusual values in the context of the split.
+end::by-field-name[]
+
+tag::categorization-analyzer[]
+If `categorization_field_name` is specified, you can also define the analyzer
+that is used to interpret the categorization field. This property cannot be used
+at the same time as `categorization_filters`. The categorization analyzer
+specifies how the `categorization_field` is interpreted by the categorization
+process. The syntax is very similar to that used to define the `analyzer` in the
+<<indices-analyze,Analyze endpoint>>. For more information, see
+{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
++
+--
+The `categorization_analyzer` field can be specified either as a string or as an
+object. If it is a string it must refer to a
+<<analysis-analyzers,built-in analyzer>> or one added by another plugin. If it
+is an object it has the following properties:
+--
+
+`char_filter`::::
+(array of strings or objects)
+include::{docdir}/ml/ml-shared.asciidoc[tag=char-filter]
+
+`tokenizer`::::
+(string or object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=tokenizer]
+
+`filter`::::
+(array of strings or objects)
+include::{docdir}/ml/ml-shared.asciidoc[tag=filter]
+end::categorization-analyzer[]
+
+tag::categorization-examples-limit[]
+The maximum number of examples stored per category in memory and in the results
+data store. The default value is 4.  If you increase this value, more examples
+are available, however it requires that you have more storage available. If you
+set this value to `0`, no examples are stored.
++
+--
+NOTE: The `categorization_examples_limit` only applies to analysis that uses
+categorization. For more information, see
+{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
+
+--
+end::categorization-examples-limit[]
+
+tag::categorization-field-name[]
+If this property is specified, the values of the specified field will be 
+categorized. The resulting categories must be used in a detector by setting
+`by_field_name`, `over_field_name`, or `partition_field_name` to the keyword
+`mlcategory`. For more information, see
+{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
+end::categorization-field-name[]
+
+tag::categorization-filters[]
+If `categorization_field_name` is specified, you can also define optional
+filters. This property expects an array of regular expressions. The expressions
+are used to filter out matching sequences from the categorization field values.
+You can use this functionality to fine tune the categorization by excluding sequences from consideration when categories are defined. For example, you can exclude SQL statements that appear in your log files. For more information, see
+{stack-ov}/ml-configuring-categories.html[Categorizing log messages]. This
+property cannot be used at the same time as `categorization_analyzer`. If you
+only want to define simple regular expression filters that are applied prior to 
+tokenization, setting this property is the easiest method. If you also want to 
+customize the tokenizer or post-tokenization filtering, use the 
+`categorization_analyzer` property instead and include the filters as
+`pattern_replace` character filters. The effect is exactly the same.
+end::categorization-filters[]
+
+tag::char-filter[]
+One or more <<analysis-charfilters,character filters>>. In addition to the
+built-in character filters, other plugins can provide more character filters.
+This property is optional. If it is not specified, no character filters are 
+applied prior to categorization. If you are customizing some other aspect of the
+analyzer and you need to achieve the equivalent of `categorization_filters`
+(which are not permitted when some other aspect of the analyzer is customized),
+add them here as
+<<analysis-pattern-replace-charfilter,pattern replace character filters>>.
+end::char-filter[]
+
+tag::custom-rules[]
+An array of custom rule objects, which enable you to customize the way detectors
+operate. For example, a rule may dictate to the detector conditions under which
+results should be skipped. For more examples, see 
+{stack-ov}/ml-configuring-detector-custom-rules.html[Configuring detector custom rules].
+A custom rule has the following properties:
++
+--
+`actions`::
+(array) The set of actions to be triggered when the rule applies. If
+more than one action is specified the effects of all actions are combined. The
+available actions include:
+
+* `skip_result`: The result will not be created. This is the default value.
+Unless you also specify `skip_model_update`, the model will be updated as usual
+with the corresponding series value.
+* `skip_model_update`: The value for that series will not be used to update the
+model. Unless you also specify `skip_result`, the results will be created as
+usual. This action is suitable when certain values are expected to be
+consistently anomalous and they affect the model in a way that negatively
+impacts the rest of the results.
+
+`scope`::
+(object) An optional scope of series where the rule applies. A rule must either
+have a non-empty scope or at least one condition. By default, the scope includes
+all series. Scoping is allowed for any of the fields that are also specified in
+`by_field_name`, `over_field_name`, or `partition_field_name`. To add a scope
+for a field, add the field name as a key in the scope object and set its value
+to an object with the following properties:
+
+`filter_id`:::
+(string) The id of the filter to be used.
+
+`filter_type`:::
+(string) Either `include` (the rule applies for values in the filter) or
+`exclude` (the rule applies for values not in the filter). Defaults to `include`.
+
+`conditions`::
+(array) An optional array of numeric conditions when the rule applies. A rule
+must either have a non-empty scope or at least one condition. Multiple
+conditions are combined together with a logical `AND`. A condition has the
+following properties: 
+
+`applies_to`:::
+(string) Specifies the result property to which the condition applies. The
+available options are `actual`, `typical`, `diff_from_typical`, `time`.
+
+`operator`:::
+(string) Specifies the condition operator. The available options are `gt`
+(greater than), `gte` (greater than or equals), `lt` (less than) and `lte` (less
+than or equals).
+
+`value`:::
+(double) The value that is compared against the `applies_to` field using the
+`operator`.
+--
++
+--
+NOTE: If your detector uses `lat_long`, `metric`, `rare`, or `freq_rare`
+functions, you can only specify `conditions` that apply to `time`.
+
+--
+end::custom-rules[]
+
+tag::custom-settings[]
+Advanced configuration option. Contains custom meta data about the job. For
+example, it can contain custom URL information as shown in
+{stack-ov}/ml-configuring-url.html[Adding custom URLs to {ml} results].
+end::custom-settings[]
+
+tag::data-description[]
+The data description defines the format of the input data when you send data to
+the job by using the <<ml-post-data,post data>> API. Note that when configure
+a {dfeed}, these properties are automatically set.
++
+--
+When data is received via the <<ml-post-data,post data>> API, it is not stored
+in {es}. Only the results for {anomaly-detect} are retained.
+
+A data description object has the following properties:
+
+`format`:::
+  (string) Only `JSON` format is supported at this time.
+
+`time_field`:::
+  (string) The name of the field that contains the timestamp.
+  The default value is `time`.
+
+`time_format`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=time-format]
+--
+end::data-description[]
+
 tag::dependent_variable[]
 `dependent_variable`::
 (Required, string) Defines which field of the document is to be predicted. 
@@ -7,6 +310,70 @@ that document will not be used for training, but a prediction with the trained
 model will be generated for it. It is also known as continuous target variable.
 end::dependent_variable[]
 
+tag::detector-description[]
+A description of the detector. For example, `Low event rate`.
+end::detector-description[]
+
+tag::detector-field-name[]
+The field that the detector uses in the function. If you use an event rate 
+function such as `count` or `rare`, do not specify this field.
++
+--
+NOTE: The `field_name` cannot contain double quotes or backslashes.
+
+--
+end::detector-field-name[]
+
+tag::detector-index[]
+A unique identifier for the detector. This identifier is based on the order of 
+the detectors in the `analysis_config`, starting at zero. You can use this 
+identifier when you want to update a specific detector.
+end::detector-index[]
+
+tag::detector[]
+A detector has the following properties:
+
+`by_field_name`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=by-field-name]
+
+`custom_rules`::::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
+
+`detector_description`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
+
+`detector_index`::::
+(integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+
+`exclude_frequent`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-frequent]
+
+`field_name`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-field-name]
+
+`function`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=function]
+
+`over_field_name`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=over-field-name]
+
+`partition_field_name`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=partition-field-name]
+
+`use_null`::::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=use-null]
+
+end::detector[]
 
 tag::eta[]
 `eta`::
@@ -17,6 +384,13 @@ https://en.wikipedia.org/wiki/Gradient_boosting#Shrinkage[this wiki article]
 about shrinkage.
 end::eta[]
 
+tag::exclude-frequent[]
+Contains one of the following values: `all`, `none`, `by`, or `over`. If set, 
+frequent entities are excluded from influencing the anomaly results. Entities
+can be considered frequent over time or frequent in a population. If you are 
+working with both over and by fields, then you can set `exclude_frequent` to 
+`all` for both fields, or to `by` or `over` for those specific fields.
+end::exclude-frequent[]
 
 tag::feature_bag_fraction[]
 `feature_bag_fraction`::
@@ -24,6 +398,18 @@ tag::feature_bag_fraction[]
 selecting a random bag for each candidate split. 
 end::feature_bag_fraction[]
 
+tag::filter[]
+One or more <<analysis-tokenfilters,token filters>>. In addition to the built-in 
+token filters, other plugins can provide more token filters. This property is
+optional. If it is not specified, no token filters are applied prior to
+categorization.
+end::filter[]
+
+tag::function[]
+The analysis function that is used. For example, `count`, `rare`, `mean`, `min`, 
+`max`, and `sum`. For more information, see
+{stack-ov}/ml-functions.html[Function reference].
+end::function[]
 
 tag::gamma[]
 `gamma`::
@@ -34,8 +420,67 @@ prefer smaller trees. The smaller this parameter the larger individual trees
 will be and the longer train will take.
 end::gamma[]
 
+tag::groups[]
+A list of job groups. A job can belong to no groups or many.
+end::groups[]
+
+tag::influencers[]
+A comma separated list of influencer field names. Typically these can be the by, 
+over, or partition fields that are used in the detector configuration. You might 
+also want to use a field name that is not specifically named in a detector, but 
+is available as part of the input data. When you use multiple detectors, the use 
+of influencers is recommended as it aggregates results for each influencer entity.
+end::influencers[]
+
+tag::job-id-anomaly-detection[]
+Identifier for the {anomaly-job}.
+end::job-id-anomaly-detection[]
+
+tag::job-id-data-frame-analytics[]
+Identifier for the {dfanalytics-job}.
+end::job-id-data-frame-analytics[]
+
+tag::job-id-anomaly-detection-default[]
+Identifier for the {anomaly-job}. It can be a job identifier, a group name, or a wildcard expression. If you do not specify one of these options, the API returns information for all {anomaly-jobs}.
+end::job-id-anomaly-detection-default[]
+
+tag::job-id-data-frame-analytics-default[]
+Identifier for the {dfanalytics-job}. If you do not specify this option, the API
+returns information for the first hundred {dfanalytics-jobs}.
+end::job-id-data-frame-analytics-default[]
+
+tag::job-id-anomaly-detection-list[]
+An identifier for the {anomaly-jobs}. It can be a job
+identifier, a group name, or a comma-separated list of jobs or groups.
+end::job-id-anomaly-detection-list[]
+
+tag::job-id-anomaly-detection-wildcard[]
+Identifier for the {anomaly-job}. It can be a job identifier, a group name, or a wildcard expression.
+end::job-id-anomaly-detection-wildcard[]
+
+tag::job-id-anomaly-detection-wildcard-list[]
+Identifier for the {anomaly-job}. It can be a job identifier, a group name, a
+comma-separated list of jobs or groups, or a wildcard expression.
+end::job-id-anomaly-detection-wildcard-list[]
+
+tag::job-id-anomaly-detection-define[]
+Identifier for the {anomaly-job}. This identifier can contain lowercase alphanumeric
+characters (a-z and 0-9), hyphens, and underscores. It must start and end with
+alphanumeric characters.
+end::job-id-anomaly-detection-define[]
+
+tag::job-id-data-frame-analytics-define[]
+Identifier for the {dfanalytics-job}. This identifier can contain lowercase 
+alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start
+and end with alphanumeric characters.
+end::job-id-data-frame-analytics-define[]
 
-tag::lambda[] 
+tag::jobs-stats-anomaly-detection[]
+An array of {anomaly-job} statistics objects.
+For more information, see <<ml-jobstats>>.
+end::jobs-stats-anomaly-detection[]
+
+tag::lambda[]
 `lambda`::
 (Optional, double) Regularization parameter to prevent overfitting on the 
 training dataset. Multiplies an L2 regularisation term which applies to leaf 
@@ -46,6 +491,16 @@ relevant relationships between the features and the {depvar}. The smaller this
 parameter the larger individual trees will be and the longer train will take.
 end::lambda[]
 
+tag::latency[]
+The size of the window in which to expect data that is out of time order. The 
+default value is 0 (no latency). If you specify a non-zero value, it must be greater than or equal to one second. For more information about time units, see <<time-units>>.
++
+--
+NOTE: Latency is only applicable when you send data by using
+the <<ml-post-data,post data>> API.
+
+--
+end::latency[]
 
 tag::maximum_number_trees[]
 `maximum_number_trees`::
@@ -53,6 +508,106 @@ tag::maximum_number_trees[]
 to contain. The maximum value is 2000.
 end::maximum_number_trees[]
 
+tag::model-memory-limit[]
+The approximate maximum amount of memory resources that are required for 
+analytical processing. Once this limit is approached, data pruning becomes
+more aggressive. Upon exceeding this limit, new entities are not modeled. The 
+default value for jobs created in version 6.1 and later is `1024mb`.
+This value will need to be increased for jobs that are expected to analyze high
+cardinality fields, but the default is set to a relatively small size to ensure
+that high resource usage is a conscious decision. The default value for jobs
+created in versions earlier than 6.1 is `4096mb`.
++
+--
+If you specify a number instead of a string, the units are assumed to be MiB.
+Specifying a string is recommended for clarity. If you specify a byte size unit
+of `b` or `kb` and the number does not equate to a discrete number of megabytes,
+it is rounded down to the closest MiB. The minimum valid value is 1 MiB. If you
+specify a value less than 1 MiB, an error occurs. For more information about
+supported byte size units, see <<byte-units>>.
+
+If your `elasticsearch.yml` file contains an `xpack.ml.max_model_memory_limit`
+setting, an error occurs when you try to create jobs that have
+`model_memory_limit` values greater than that setting. For more information,
+see <<ml-settings>>.
+--
+end::model-memory-limit[]
+
+tag::model-plot-config[]
+This advanced configuration option stores model information along with the
+results. It provides a more detailed view into {anomaly-detect}.
++
+--
+WARNING: If you enable model plot it can add considerable overhead to the performance
+of the system; it is not feasible for jobs with many entities.
+
+Model plot provides a simplified and indicative view of the model and its bounds.
+It does not display complex features such as multivariate correlations or multimodal data.
+As such, anomalies may occasionally be reported which cannot be seen in the model plot.
+
+Model plot config can be configured when the job is created or updated later. It must be
+disabled if performance issues are experienced.
+
+The `model_plot_config` object has the following properties:
+
+`enabled`:::
+(boolean) If true, enables calculation and storage of the model bounds for
+each entity that is being analyzed. By default, this is not enabled.
+
+`terms`:::
+experimental[] (string) Limits data collection to this comma separated list of 
+partition or by field values. If terms are not specified or it is an empty 
+string, no filtering is applied. For example, "CPU,NetworkIn,DiskWrites". 
+Wildcards are not supported. Only the specified `terms` can be viewed when 
+using the Single Metric Viewer.
+--
+end::model-plot-config[]
+
+tag::model-snapshot-id[]
+A numerical character string that uniquely identifies the model snapshot. For 
+example, `1491007364`. For more information about model snapshots, see
+<<ml-snapshot-resource>>.
+end::model-snapshot-id[]
+
+tag::model-snapshot-retention-days[]
+The time in days that model snapshots are retained for the job. Older snapshots
+are deleted. The default value is `1`, which means snapshots are retained for
+one day (twenty-four hours).
+end::model-snapshot-retention-days[]
+
+tag::multivariate-by-fields[]
+This functionality is reserved for internal use. It is not supported for use in 
+customer environments and is not subject to the support SLA of official GA 
+features.
++
+--
+If set to `true`, the analysis will automatically find correlations between 
+metrics for a given `by` field value and report anomalies when those
+correlations cease to hold. For example, suppose CPU and memory usage on host A
+is usually highly correlated with the same metrics on host B. Perhaps this
+correlation occurs because they are running a load-balanced application.
+If you enable this property, then anomalies will be reported when, for example,
+CPU usage on host A is high and the value of CPU usage on host B is low. That
+is to say, you'll see an anomaly when the CPU of host A is unusual given
+the CPU of host B.
+
+NOTE: To use the `multivariate_by_fields` property, you must also specify
+`by_field_name` in your detector.
+
+--
+end::multivariate-by-fields[]
+
+tag::over-field-name[]
+The field used to split the data. In particular, this property is used for 
+analyzing the splits with respect to the history of all splits. It is used for 
+finding unusual values in the population of all splits. For more information,
+see {stack-ov}/ml-configuring-pop.html[Performing population analysis].
+end::over-field-name[]
+
+tag::partition-field-name[]
+The field used to segment the analysis. When you use this property, you have 
+completely independent baselines for each value of this field.
+end::partition-field-name[]
 
 tag::prediction_field_name[]
 `prediction_field_name`::
@@ -60,6 +615,63 @@ tag::prediction_field_name[]
 Defaults to `<dependent_variable>_prediction`.
 end::prediction_field_name[]
 
+tag::renormalization-window-days[]
+Advanced configuration option. The period over which adjustments to the score
+are applied, as new data is seen. The default value is the longer of 30 days or
+100 `bucket_spans`.
+end::renormalization-window-days[]
+
+tag::results-index-name[]
+A text string that affects the name of the {ml} results index. The default value
+is `shared`, which generates an index named `.ml-anomalies-shared`. 
+end::results-index-name[]
+
+tag::results-retention-days[]
+Advanced configuration option. The number of days for which job results are 
+retained. Once per day at 00:30 (server time), results older than this period
+are deleted from {es}. The default value is null, which means results are
+retained.
+end::results-retention-days[]
+
+tag::summary-count-field-name[]
+If this property is specified, the data that is fed to the job is expected to be
+pre-summarized. This property value is the name of the field that contains the 
+count of raw data points that have been summarized. The same 
+`summary_count_field_name` applies to all detectors in the job.
++
+--
+NOTE: The `summary_count_field_name` property cannot be used with the `metric`
+function.
+
+--
+end::summary-count-field-name[]
+
+tag::time-format[]
+The time format, which can be `epoch`, `epoch_ms`, or a custom pattern. The
+default value is `epoch`, which refers to UNIX or Epoch time (the number of 
+seconds since 1 Jan 1970). The value `epoch_ms` indicates that time is measured 
+in milliseconds since the epoch. The `epoch` and `epoch_ms` time formats accept 
+either integer or real values. +
++
+--
+NOTE: Custom patterns must conform to the Java `DateTimeFormatter` class.
+When you use date-time formatting patterns, it is recommended that you provide
+the full date, time and time zone. For example: `yyyy-MM-dd'T'HH:mm:ssX`.
+If the pattern that you specify is not sufficient to produce a complete timestamp,
+job creation fails.
+
+--
+end::time-format[]
+
+tag::tokenizer[]
+The name or definition of the <<analysis-tokenizers,tokenizer>> to use after 
+character filters are applied. This property is compulsory if 
+`categorization_analyzer` is specified as an object. Machine learning provides a
+tokenizer called `ml_classic` that tokenizes in the same way as the
+non-customizable tokenizer in older versions of the product. If you want to use 
+that tokenizer but change the character or token filters, specify
+`"tokenizer": "ml_classic"` in your `categorization_analyzer`.
+end::tokenizer[]
 
 tag::training_percent[]
 `training_percent`::
@@ -67,4 +679,9 @@ tag::training_percent[]
 be used for training. Documents that are ignored by the analysis (for example 
 those that contain arrays) won’t be included in the calculation for used 
 percentage. Defaults to `100`.
-end::training_percent[]
\ No newline at end of file
+end::training_percent[]
+
+tag::use-null[]
+Defines whether a new series is used as the null series when there is no value 
+for the by or partition fields. The default value is `false`.
+end::use-null[]
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 2ea8f6029849d..26694e9aa05ab 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -1046,3 +1046,12 @@ See <<elasticsearch-security>>.
 === Rollup job configuration
 
 See <<rollup-put-job-api-request-body>>.
+
+[role="exclude",id="ml-job-resource"]
+=== Job resources
+
+This page was deleted.
+[[ml-analysisconfig]]
+See the details in
+[[ml-apimodelplotconfig]]
+<<ml-put-job>>, <<ml-update-job>>, and <<ml-get-job>>.
\ No newline at end of file
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index 75e496903f59d..ec1a5a0e4154f 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -9,7 +9,6 @@ These resource definitions are used in APIs related to {ml-features} and
 * <<ml-datafeed-counts,{dfeed-cap} counts>>
 * <<ml-dfanalytics-resources,{dfanalytics-cap}>>
 * <<ml-evaluate-dfanalytics-resources,Evaluate {dfanalytics}>>
-* <<ml-job-resource,{anomaly-jobs-cap}>>
 * <<ml-jobstats,{anomaly-jobs-cap} statistics>>
 * <<ml-snapshot-resource,{anomaly-detect-cap} model snapshots>>
 * <<ml-results-resource,{anomaly-detect-cap} results>>
@@ -19,7 +18,6 @@ These resource definitions are used in APIs related to {ml-features} and
 include::{es-repo-dir}/ml/anomaly-detection/apis/datafeedresource.asciidoc[]
 include::{es-repo-dir}/ml/df-analytics/apis/dfanalyticsresources.asciidoc[]
 include::{es-repo-dir}/ml/df-analytics/apis/evaluateresources.asciidoc[]
-include::{es-repo-dir}/ml/anomaly-detection/apis/jobresource.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/jobcounts.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/snapshotresource.asciidoc[]
 include::{xes-repo-dir}/rest-api/security/role-mapping-resources.asciidoc[]
diff --git a/docs/reference/settings/ml-settings.asciidoc b/docs/reference/settings/ml-settings.asciidoc
index 52d0d8eb28b24..8829a328f7955 100644
--- a/docs/reference/settings/ml-settings.asciidoc
+++ b/docs/reference/settings/ml-settings.asciidoc
@@ -81,7 +81,7 @@ The maximum `model_memory_limit` property value that can be set for any job on
 this node. If you try to create a job with a `model_memory_limit` property value
 that is greater than this setting value, an error occurs. Existing jobs are not
 affected when you update this setting. For more information about the
-`model_memory_limit` property, see <<ml-apilimits>>.
+`model_memory_limit` property, see <<put-analysislimits>>.
 
 `xpack.ml.max_open_jobs` (<<cluster-update-settings,Dynamic>>)::
 The maximum number of jobs that can run simultaneously on a node. Defaults to

From 71373d048c8a595c9b093d0a41e8c67c2f8d72d1 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Fri, 6 Dec 2019 15:54:30 -0800
Subject: [PATCH 107/686] Disable repo configuration for rpm based systems
 (#49893)

This commit changes the recommended repository file for rpm based
systems to be disabled by default. This is a safer practice so upgrades
of the system do no accidentally upgrade elasticsearch itself.

closes #30660
---
 docs/reference/setup/install/rpm.asciidoc | 23 ++++++++++++++++-------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/docs/reference/setup/install/rpm.asciidoc b/docs/reference/setup/install/rpm.asciidoc
index 4108756286eed..c6239bc576054 100644
--- a/docs/reference/setup/install/rpm.asciidoc
+++ b/docs/reference/setup/install/rpm.asciidoc
@@ -48,12 +48,12 @@ ifeval::["{release-state}"=="released"]
 
 ["source","sh",subs="attributes,callouts"]
 --------------------------------------------------
-[elasticsearch-{major-version}]
+[elasticsearch]
 name=Elasticsearch repository for {major-version} packages
 baseurl=https://artifacts.elastic.co/packages/{major-version}/yum
 gpgcheck=1
 gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
-enabled=1
+enabled=0
 autorefresh=1
 type=rpm-md
 --------------------------------------------------
@@ -64,12 +64,12 @@ ifeval::["{release-state}"=="prerelease"]
 
 ["source","sh",subs="attributes,callouts"]
 --------------------------------------------------
-[elasticsearch-{major-version}]
+[elasticsearch]
 name=Elasticsearch repository for {major-version} packages
 baseurl=https://artifacts.elastic.co/packages/{major-version}-prerelease/yum
 gpgcheck=1
 gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
-enabled=1
+enabled=0
 autorefresh=1
 type=rpm-md
 --------------------------------------------------
@@ -80,14 +80,23 @@ And your repository is ready for use. You can now install Elasticsearch with one
 
 [source,sh]
 --------------------------------------------------
-sudo yum install elasticsearch <1>
-sudo dnf install elasticsearch <2>
-sudo zypper install elasticsearch <3>
+sudo yum install --enablerepo=elasticsearch elasticsearch <1>
+sudo dnf install --enablerepo=elasticsearch elasticsearch <2>
+sudo zypper modifyrepo --enable elasticsearch && \
+  sudo zypper install elasticsearch; \
+  sudo zypper modifyrepo --disable elasticsearch <3>
 --------------------------------------------------
 <1> Use `yum` on CentOS and older Red Hat based distributions.
 <2> Use `dnf` on Fedora and other newer Red Hat distributions.
 <3> Use `zypper` on OpenSUSE based distributions
 
+[NOTE]
+==================================================
+
+The configured repository is disabled by default. This eliminates the possibility of accidentally
+upgrading `elasticsearch` when upgrading the rest of the system. Each install or upgrade command
+must explicitly enable the repository as indicated in the sample commands above.
+
 endif::[]
 
 ifeval::["{release-state}"!="unreleased"]

From 3c36cd987a8b2627279adcfc06108d560a90f6b9 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Fri, 6 Dec 2019 17:43:12 -0800
Subject: [PATCH 108/686] Fix incorrect use of multiline NOTE in rpm docs
 (#49962)

This was a copy/paste error from #49893. This commit converts the NOTE
to use inline style instead of one needing closing linebreak.
---
 docs/reference/setup/install/rpm.asciidoc | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/docs/reference/setup/install/rpm.asciidoc b/docs/reference/setup/install/rpm.asciidoc
index c6239bc576054..f1601f95b1773 100644
--- a/docs/reference/setup/install/rpm.asciidoc
+++ b/docs/reference/setup/install/rpm.asciidoc
@@ -90,10 +90,7 @@ sudo zypper modifyrepo --enable elasticsearch && \
 <2> Use `dnf` on Fedora and other newer Red Hat distributions.
 <3> Use `zypper` on OpenSUSE based distributions
 
-[NOTE]
-==================================================
-
-The configured repository is disabled by default. This eliminates the possibility of accidentally
+NOTE: The configured repository is disabled by default. This eliminates the possibility of accidentally
 upgrading `elasticsearch` when upgrading the rest of the system. Each install or upgrade command
 must explicitly enable the repository as indicated in the sample commands above.
 

From beda30fdd28cfd857f9f97845eddb98f8993467a Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Sun, 8 Dec 2019 14:14:16 +0100
Subject: [PATCH 109/686] Cleanup some in o.e.transport (#49901)

Cleaning up some obvious compile warnings and dead code.
---
 .../transport/ConnectionProfile.java          |  8 -------
 .../transport/InboundHandler.java             | 22 +++++++++----------
 .../transport/RemoteClusterService.java       |  2 --
 .../elasticsearch/transport/TcpTransport.java | 15 -------------
 .../transport/TransportRequestOptions.java    |  4 ----
 5 files changed, 11 insertions(+), 40 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/transport/ConnectionProfile.java b/server/src/main/java/org/elasticsearch/transport/ConnectionProfile.java
index 66db091557f48..cd392fbfcbdc5 100644
--- a/server/src/main/java/org/elasticsearch/transport/ConnectionProfile.java
+++ b/server/src/main/java/org/elasticsearch/transport/ConnectionProfile.java
@@ -93,14 +93,6 @@ public static ConnectionProfile buildDefaultConnectionProfile(Settings settings)
         return builder.build();
     }
 
-    /**
-     * Builds a connection profile that is dedicated to a single channel type. Use this
-     * when opening single use connections
-     */
-    public static ConnectionProfile buildSingleChannelProfile(TransportRequestOptions.Type channelType) {
-        return buildSingleChannelProfile(channelType, null, null, null, null);
-    }
-
     /**
      * Builds a connection profile that is dedicated to a single channel type. Allows passing connection and
      * handshake timeouts and compression settings.
diff --git a/server/src/main/java/org/elasticsearch/transport/InboundHandler.java b/server/src/main/java/org/elasticsearch/transport/InboundHandler.java
index cb7a14b56970c..f89ee423daf9f 100644
--- a/server/src/main/java/org/elasticsearch/transport/InboundHandler.java
+++ b/server/src/main/java/org/elasticsearch/transport/InboundHandler.java
@@ -72,8 +72,9 @@ synchronized <Request extends TransportRequest> void registerRequestHandler(Requ
         requestHandlers = Maps.copyMapWithAddedEntry(requestHandlers, reg.getAction(), reg);
     }
 
-    final RequestHandlerRegistry<? extends TransportRequest> getRequestHandler(String action) {
-        return requestHandlers.get(action);
+    @SuppressWarnings("unchecked")
+    final <T extends TransportRequest> RequestHandlerRegistry<T> getRequestHandler(String action) {
+        return (RequestHandlerRegistry<T>) requestHandlers.get(action);
     }
 
     final Transport.ResponseHandlers getResponseHandlers() {
@@ -148,7 +149,7 @@ private void messageReceived(BytesReference reference, TcpChannel channel) throw
         }
     }
 
-    private void handleRequest(TcpChannel channel, InboundMessage.Request message, int messageLengthBytes) {
+    private <T extends TransportRequest> void handleRequest(TcpChannel channel, InboundMessage.Request message, int messageLengthBytes) {
         final String action = message.getActionName();
         final long requestId = message.getRequestId();
         final StreamInput stream = message.getStreamInput();
@@ -159,7 +160,7 @@ private void handleRequest(TcpChannel channel, InboundMessage.Request message, i
             if (message.isHandshake()) {
                 handshaker.handleHandshake(version, channel, requestId, stream);
             } else {
-                final RequestHandlerRegistry reg = getRequestHandler(action);
+                final RequestHandlerRegistry<T> reg = getRequestHandler(action);
                 if (reg == null) {
                     throw new ActionNotFoundTransportException(action);
                 }
@@ -171,7 +172,7 @@ private void handleRequest(TcpChannel channel, InboundMessage.Request message, i
                 }
                 transportChannel = new TcpTransportChannel(outboundHandler, channel, action, requestId, version,
                     circuitBreakerService, messageLengthBytes, message.isCompress());
-                final TransportRequest request = reg.newRequest(stream);
+                final T request = reg.newRequest(stream);
                 request.remoteAddress(new TransportAddress(channel.getRemoteAddress()));
                 // in case we throw an exception, i.e. when the limit is hit, we don't want to verify
                 final int nextByte = stream.read();
@@ -180,7 +181,7 @@ private void handleRequest(TcpChannel channel, InboundMessage.Request message, i
                     throw new IllegalStateException("Message not fully read (request) for requestId [" + requestId + "], action [" + action
                         + "], available [" + stream.available() + "]; resetting");
                 }
-                threadPool.executor(reg.getExecutor()).execute(new RequestHandler(reg, request, transportChannel));
+                threadPool.executor(reg.getExecutor()).execute(new RequestHandler<>(reg, request, transportChannel));
             }
         } catch (Exception e) {
             // the circuit breaker tripped
@@ -245,18 +246,17 @@ private void handleException(final TransportResponseHandler<?> handler, Throwabl
         });
     }
 
-    private static class RequestHandler extends AbstractRunnable {
-        private final RequestHandlerRegistry reg;
-        private final TransportRequest request;
+    private static class RequestHandler<T extends TransportRequest> extends AbstractRunnable {
+        private final RequestHandlerRegistry<T> reg;
+        private final T request;
         private final TransportChannel transportChannel;
 
-        RequestHandler(RequestHandlerRegistry<?> reg, TransportRequest request, TransportChannel transportChannel) {
+        RequestHandler(RequestHandlerRegistry<T> reg, T request, TransportChannel transportChannel) {
             this.reg = reg;
             this.request = request;
             this.transportChannel = transportChannel;
         }
 
-        @SuppressWarnings({"unchecked"})
         @Override
         protected void doRun() throws Exception {
             reg.processMessageReceived(request, transportChannel);
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteClusterService.java b/server/src/main/java/org/elasticsearch/transport/RemoteClusterService.java
index 2bfe3980ed8d3..f398100049a8f 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteClusterService.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteClusterService.java
@@ -62,8 +62,6 @@ public final class RemoteClusterService extends RemoteClusterAware implements Cl
 
     private static final Logger logger = LogManager.getLogger(RemoteClusterService.class);
 
-    private static final ActionListener<Void> noopListener = ActionListener.wrap((x) -> {}, (x) -> {});
-
     /**
      * The initial connect timeout for remote cluster connections
      */
diff --git a/server/src/main/java/org/elasticsearch/transport/TcpTransport.java b/server/src/main/java/org/elasticsearch/transport/TcpTransport.java
index 0d8917f12f263..7b3ba6d2c9acc 100644
--- a/server/src/main/java/org/elasticsearch/transport/TcpTransport.java
+++ b/server/src/main/java/org/elasticsearch/transport/TcpTransport.java
@@ -29,7 +29,6 @@
 import org.elasticsearch.action.support.ThreadedActionListener;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.node.DiscoveryNode;
-import org.elasticsearch.common.Booleans;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.breaker.CircuitBreaker;
 import org.elasticsearch.common.bytes.BytesArray;
@@ -77,7 +76,6 @@
 import java.util.Map;
 import java.util.Objects;
 import java.util.Set;
-import java.util.TreeSet;
 import java.util.concurrent.ConcurrentMap;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
@@ -136,19 +134,6 @@ public TcpTransport(Settings settings, Version version, ThreadPool threadPool, P
         this.pageCacheRecycler = pageCacheRecycler;
         this.networkService = networkService;
         String nodeName = Node.NODE_NAME_SETTING.get(settings);
-        final Settings defaultFeatures = TransportSettings.DEFAULT_FEATURES_SETTING.get(settings);
-        String[] features;
-        if (defaultFeatures == null) {
-            features = new String[0];
-        } else {
-            defaultFeatures.names().forEach(key -> {
-                if (Booleans.parseBoolean(defaultFeatures.get(key)) == false) {
-                    throw new IllegalArgumentException("feature settings must have default [true] value");
-                }
-            });
-            // use a sorted set to present the features in a consistent order
-            features = new TreeSet<>(defaultFeatures.names()).toArray(new String[defaultFeatures.names().size()]);
-        }
         BigArrays bigArrays = new BigArrays(pageCacheRecycler, circuitBreakerService, CircuitBreaker.IN_FLIGHT_REQUESTS);
 
         this.outboundHandler = new OutboundHandler(nodeName, version, threadPool, bigArrays);
diff --git a/server/src/main/java/org/elasticsearch/transport/TransportRequestOptions.java b/server/src/main/java/org/elasticsearch/transport/TransportRequestOptions.java
index 7ea992f547f6e..59d5a59498a62 100644
--- a/server/src/main/java/org/elasticsearch/transport/TransportRequestOptions.java
+++ b/server/src/main/java/org/elasticsearch/transport/TransportRequestOptions.java
@@ -53,10 +53,6 @@ public static Builder builder() {
         return new Builder();
     }
 
-    public static Builder builder(TransportRequestOptions options) {
-        return new Builder().withTimeout(options.timeout).withType(options.type());
-    }
-
     public static class Builder {
         private TimeValue timeout;
         private Type type = Type.REG;

From 2c54f94f3558f2f9e9bb23da289575ab981d2b97 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 8 Dec 2019 14:52:32 -0800
Subject: [PATCH 110/686] Adding best compression inital commit

---
 .../xpack/core/ilm/CloseIndexStep.java        |  42 +++++
 .../xpack/core/ilm/ForceMergeAction.java      |  42 ++++-
 .../xpack/core/ilm/OpenIndexStep.java         |  38 +++++
 .../xpack/core/ilm/WaitForIndexGreenStep.java |  98 +++++++++++
 .../xpack/core/ilm/CloseIndexStepTest.java    | 155 +++++++++++++++++
 .../xpack/core/ilm/ForceMergeActionTests.java |  77 +++++++--
 .../xpack/core/ilm/OpenIndexStepTest.java     | 158 ++++++++++++++++++
 .../ilm/TimeseriesLifecycleTypeTests.java     |   4 +-
 .../core/ilm/WaitForIndexGreenStepTest.java   | 155 +++++++++++++++++
 9 files changed, 745 insertions(+), 24 deletions(-)
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
new file mode 100644
index 0000000000000..8f78ce75653e5
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.close.CloseIndexRequest;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateObserver;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.xpack.core.ilm.AsyncActionStep;
+
+/**
+ * Invokes a Close Index Step on a index.
+ */
+public class CloseIndexStep extends AsyncActionStep {
+    public static final String NAME = "close-index";
+
+    CloseIndexStep(StepKey key, StepKey nextStepKey, Client client) {
+        super(key, nextStepKey, client);
+    }
+
+    @Override
+    public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState, ClusterStateObserver observer, Listener listener) {
+        if(indexMetaData.getState() == IndexMetaData.State.OPEN) {
+            CloseIndexRequest request = new CloseIndexRequest(indexMetaData.getIndex().getName());
+            getClient().admin().indices()
+                .close(request, ActionListener.wrap(closeIndexResponse -> listener.onResponse(true), listener::onFailure));
+        }
+        else {
+            listener.onResponse(true);
+        }
+    }
+
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index eb5f2b61017a1..5d4227a766f58 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -15,6 +15,8 @@
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.index.codec.CodecService;
+import org.elasticsearch.index.engine.EngineConfig;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 
 import java.io.IOException;
@@ -28,42 +30,53 @@
 public class ForceMergeAction implements LifecycleAction {
     public static final String NAME = "forcemerge";
     public static final ParseField MAX_NUM_SEGMENTS_FIELD = new ParseField("max_num_segments");
+    public static final ParseField BEST_COMPRESSION_FIELD = new ParseField("best_compression");
 
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        return new ForceMergeAction(maxNumSegments);
+        boolean bestCompression = a[1] != null && (boolean) a[1];
+        return new ForceMergeAction(maxNumSegments, bestCompression);
     });
 
     static {
         PARSER.declareInt(ConstructingObjectParser.constructorArg(), MAX_NUM_SEGMENTS_FIELD);
+        PARSER.declareBoolean(ConstructingObjectParser.constructorArg(), BEST_COMPRESSION_FIELD);
     }
 
     private final int maxNumSegments;
+    private final boolean bestCompression;
 
     public static ForceMergeAction parse(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    public ForceMergeAction(int maxNumSegments) {
+    public ForceMergeAction(int maxNumSegments, boolean bestCompression) {
         if (maxNumSegments <= 0) {
             throw new IllegalArgumentException("[" + MAX_NUM_SEGMENTS_FIELD.getPreferredName()
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
+        this.bestCompression = bestCompression;
     }
 
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
+        this.bestCompression = in.readBoolean();
     }
 
     public int getMaxNumSegments() {
         return maxNumSegments;
     }
 
+    public boolean isBestCompression() {
+        return bestCompression;
+    }
+
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
+        out.writeBoolean(bestCompression);
     }
 
     @Override
@@ -80,6 +93,7 @@ public boolean isSafeAction() {
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
         builder.field(MAX_NUM_SEGMENTS_FIELD.getPreferredName(), maxNumSegments);
+        builder.field(BEST_COMPRESSION_FIELD.getPreferredName(), bestCompression);
         builder.endObject();
         return builder;
     }
@@ -92,6 +106,25 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         StepKey forceMergeKey = new StepKey(phase, NAME, ForceMergeStep.NAME);
         StepKey countKey = new StepKey(phase, NAME, SegmentCountStep.NAME);
 
+
+        if (this.bestCompression) {
+            StepKey closeKey = new StepKey(phase, NAME, CloseIndexStep.NAME);
+            StepKey openKey = new StepKey(phase, NAME, OpenIndexStep.NAME);
+            StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexGreenStep.NAME);
+            StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
+            Settings bestCompressionSettings = Settings.builder()
+                .put(EngineConfig.INDEX_CODEC_SETTING.getKey(), CodecService.BEST_COMPRESSION_CODEC).build();
+
+            CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
+            UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
+                openKey, client, bestCompressionSettings);
+            OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
+            WaitForIndexGreenStep waitForIndexGreenStep = new WaitForIndexGreenStep(waitForGreenIndexKey, forceMergeKey);
+            ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, nextStepKey, client, maxNumSegments);
+            return Arrays.asList(closeIndexStep, updateBestCompressionSettings,
+                openIndexStep, waitForIndexGreenStep, forceMergeStep);
+        }
+
         UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, forceMergeKey, client, readOnlySettings);
         ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
         SegmentCountStep segmentCountStep = new SegmentCountStep(countKey, nextStepKey, client, maxNumSegments);
@@ -100,7 +133,7 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
 
     @Override
     public int hashCode() {
-        return Objects.hash(maxNumSegments);
+        return Objects.hash(maxNumSegments, bestCompression);
     }
 
     @Override
@@ -112,7 +145,8 @@ public boolean equals(Object obj) {
             return false;
         }
         ForceMergeAction other = (ForceMergeAction) obj;
-        return Objects.equals(maxNumSegments, other.maxNumSegments);
+        return Objects.equals(maxNumSegments, other.maxNumSegments)
+            && Objects.equals(bestCompression, other.bestCompression);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
new file mode 100644
index 0000000000000..793db17eb8376
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateObserver;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+
+final class OpenIndexStep extends AsyncActionStep {
+
+    static final String NAME = "open-index";
+
+    OpenIndexStep(StepKey key, StepKey nextStepKey, Client client) {
+        super(key, nextStepKey, client);
+    }
+
+    @Override
+    public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState,
+                              ClusterStateObserver observer, Listener listener) {
+        if (indexMetaData.getState() == IndexMetaData.State.CLOSE) {
+            OpenIndexRequest request = new OpenIndexRequest(indexMetaData.getIndex().getName());
+            getClient().admin().indices()
+                .open(request,
+                    ActionListener.wrap(closeIndexResponse -> listener.onResponse(true), listener::onFailure));
+
+        } else {
+            listener.onResponse(true);
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
new file mode 100644
index 0000000000000..f001644da2022
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
@@ -0,0 +1,98 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+package org.elasticsearch.xpack.core.ilm;
+
+import com.carrotsearch.hppc.cursors.IntObjectCursor;
+import com.carrotsearch.hppc.cursors.ObjectCursor;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.routing.IndexRoutingTable;
+import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
+import org.elasticsearch.cluster.routing.RoutingTable;
+import org.elasticsearch.cluster.routing.ShardRouting;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.index.Index;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Objects;
+import java.util.stream.Stream;
+
+class WaitForIndexGreenStep extends ClusterStateWaitStep {
+
+    static final String NAME = "wait-for-index-green-step";
+
+    WaitForIndexGreenStep(StepKey key, StepKey nextStepKey) {
+        super(key, nextStepKey);
+    }
+
+    @Override
+    public Result isConditionMet(Index index, ClusterState clusterState) {
+        RoutingTable routingTable = clusterState.routingTable();
+        IndexRoutingTable indexRoutingTable = routingTable.index(index);
+        if (indexRoutingTable == null) {
+            return new Result(false, new Info("index is red; no IndexRoutingTable"));
+        }
+
+        boolean indexIsGreen = false;
+        if(indexRoutingTable.allPrimaryShardsActive()) {
+            boolean replicaIndexIsGreen = false;
+            for (ObjectCursor<IndexShardRoutingTable> shardRouting : indexRoutingTable.getShards().values()) {
+                replicaIndexIsGreen = shardRouting.value.replicaShards().stream().allMatch(ShardRouting::active);
+                if(!replicaIndexIsGreen) {
+                    return new Result(false, new Info("index is yellow; not all replica shards are active"));
+                }
+            }
+            indexIsGreen = replicaIndexIsGreen;
+        }
+
+
+        if (indexIsGreen) {
+            return new Result(true, null);
+        } else {
+            return new Result(false, new Info("index is not green; not all shards are active"));
+        }
+    }
+
+    static final class Info implements ToXContentObject {
+
+        static final ParseField MESSAGE_FIELD = new ParseField("message");
+
+        private final String message;
+
+        Info(String message) {
+            this.message = message;
+        }
+
+        String getMessage() {
+            return message;
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(MESSAGE_FIELD.getPreferredName(), message);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Info info = (Info) o;
+            return Objects.equals(getMessage(), info.getMessage());
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(getMessage());
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
new file mode 100644
index 0000000000000..7d7a64edc6336
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
@@ -0,0 +1,155 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+
+package org.elasticsearch.xpack.core.ilm;
+
+import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.close.CloseIndexRequest;
+import org.elasticsearch.action.admin.indices.close.CloseIndexResponse;
+import org.elasticsearch.client.AdminClient;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.client.IndicesAdminClient;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.junit.Before;
+import org.mockito.Mockito;
+import org.mockito.stubbing.Answer;
+
+import java.util.Collections;
+
+import static org.hamcrest.Matchers.equalTo;
+
+/**
+ * Created by sivagurunathanvelayutham on Dec, 2019
+ */
+public class CloseIndexStepTest extends AbstractStepTestCase<CloseIndexStep> {
+
+    private Client client;
+
+    @Before
+    public void setup() {
+        client = Mockito.mock(Client.class);
+    }
+
+    @Override
+    protected CloseIndexStep createRandomInstance() {
+        return new CloseIndexStep(randomStepKey(), randomStepKey(), client);
+    }
+
+    @Override
+    protected CloseIndexStep mutateInstance(CloseIndexStep instance) {
+        Step.StepKey key = instance.getKey();
+        Step.StepKey nextKey = instance.getNextStepKey();
+
+        switch (between(0, 1)) {
+            case 0:
+                key = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 1:
+                nextKey = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+
+        return new CloseIndexStep(key, nextKey, client);
+    }
+
+    @Override
+    protected CloseIndexStep copyInstance(CloseIndexStep instance) {
+        return new CloseIndexStep(instance.getKey(), instance.getNextStepKey(), instance.getClient());
+    }
+
+    public void testPerformAction() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10)).settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
+
+        CloseIndexStep step = createRandomInstance();
+
+        AdminClient adminClient = Mockito.mock(AdminClient.class);
+        IndicesAdminClient indicesClient = Mockito.mock(IndicesAdminClient.class);
+
+        Mockito.when(client.admin()).thenReturn(adminClient);
+        Mockito.when(adminClient.indices()).thenReturn(indicesClient);
+
+        Mockito.doAnswer((Answer<Void>) invocation -> {
+            CloseIndexRequest request = (CloseIndexRequest) invocation.getArguments()[0];
+            @SuppressWarnings("unchecked")
+            ActionListener<CloseIndexResponse> listener = (ActionListener<CloseIndexResponse>) invocation.getArguments()[1];
+            assertThat(request.indices(), equalTo(new String[]{indexMetaData.getIndex().getName()}));
+            listener.onResponse(new CloseIndexResponse(true, true,
+                Collections.singletonList(new CloseIndexResponse.IndexResult(indexMetaData.getIndex()))));
+            return null;
+        }).when(indicesClient).close(Mockito.any(), Mockito.any());
+
+        SetOnce<Boolean> actionCompleted = new SetOnce<>();
+
+        step.performAction(indexMetaData, null, null, new AsyncActionStep.Listener() {
+
+            @Override
+            public void onResponse(boolean complete) {
+                actionCompleted.set(complete);
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                throw new AssertionError("Unexpected method call", e);
+            }
+        });
+
+        assertEquals(true, actionCompleted.get());
+        Mockito.verify(client, Mockito.only()).admin();
+        Mockito.verify(adminClient, Mockito.only()).indices();
+        Mockito.verify(indicesClient, Mockito.only()).close(Mockito.any(), Mockito.any());
+    }
+
+
+    public void testPerformActionFailure() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10)).settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
+
+        CloseIndexStep step = createRandomInstance();
+        Exception exception = new RuntimeException();
+        AdminClient adminClient = Mockito.mock(AdminClient.class);
+        IndicesAdminClient indicesClient = Mockito.mock(IndicesAdminClient.class);
+
+        Mockito.when(client.admin()).thenReturn(adminClient);
+        Mockito.when(adminClient.indices()).thenReturn(indicesClient);
+
+        Mockito.doAnswer((Answer<Void>) invocation -> {
+            CloseIndexRequest request = (CloseIndexRequest) invocation.getArguments()[0];
+            @SuppressWarnings("unchecked")
+            ActionListener<CloseIndexResponse> listener = (ActionListener<CloseIndexResponse>) invocation.getArguments()[1];
+            assertThat(request.indices(), equalTo(new String[]{indexMetaData.getIndex().getName()}));
+            listener.onFailure(exception);
+            return null;
+        }).when(indicesClient).close(Mockito.any(), Mockito.any());
+
+        SetOnce<Boolean> exceptionThrown = new SetOnce<>();
+
+        step.performAction(indexMetaData, null, null, new AsyncActionStep.Listener() {
+
+            @Override
+            public void onResponse(boolean complete) {
+                throw new AssertionError("Unexpected method call");
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                assertSame(exception, e);
+                exceptionThrown.set(true);
+            }
+        });
+
+        assertEquals(true, exceptionThrown.get());
+        Mockito.verify(client, Mockito.only()).admin();
+        Mockito.verify(adminClient, Mockito.only()).indices();
+        Mockito.verify(indicesClient, Mockito.only()).close(Mockito.any(), Mockito.any());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 92fe40a08dfcc..c12f6e7459bd2 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -13,6 +13,8 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.index.codec.CodecService;
+import org.elasticsearch.index.engine.EngineConfig;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 
 import java.io.IOException;
@@ -33,14 +35,20 @@ protected ForceMergeAction createTestInstance() {
     }
 
     static ForceMergeAction randomInstance() {
-        return new ForceMergeAction(randomIntBetween(1, 100));
+        return new ForceMergeAction(randomIntBetween(1, 100), randomBoolean());
     }
 
     @Override
     protected ForceMergeAction mutateInstance(ForceMergeAction instance) {
         int maxNumSegments = instance.getMaxNumSegments();
-        maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
-        return new ForceMergeAction(maxNumSegments);
+        boolean bestCompression = instance.isBestCompression();
+        if(randomBoolean()) {
+            maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
+        }
+        else {
+            bestCompression = !bestCompression;
+        }
+        return new ForceMergeAction(maxNumSegments, bestCompression);
     }
 
     @Override
@@ -48,21 +56,7 @@ protected Reader<ForceMergeAction> instanceReader() {
         return ForceMergeAction::new;
     }
 
-    public void testMissingMaxNumSegments() throws IOException {
-        BytesReference emptyObject = BytesReference.bytes(JsonXContent.contentBuilder().startObject().endObject());
-        XContentParser parser = XContentHelper.createParser(null, DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
-            emptyObject, XContentType.JSON);
-        Exception e = expectThrows(IllegalArgumentException.class, () -> ForceMergeAction.parse(parser));
-        assertThat(e.getMessage(), equalTo("Required [max_num_segments]"));
-    }
-
-    public void testInvalidNegativeSegmentNumber() {
-        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0)));
-        assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
-    }
-
-    public void testToSteps() {
-        ForceMergeAction instance = createTestInstance();
+    private void assertNonBestCompression(ForceMergeAction instance) {
         String phase = randomAlphaOfLength(5);
         StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
         List<Step> steps = instance.toSteps(null, phase, nextStepKey);
@@ -79,4 +73,51 @@ public void testToSteps() {
         assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
         assertThat(thirdStep.getNextStepKey(), equalTo(nextStepKey));
     }
+
+    private void assertBestCompression(ForceMergeAction instance) {
+        String phase = randomAlphaOfLength(5);
+        StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
+        List<Step> steps = instance.toSteps(null, phase, nextStepKey);
+        assertNotNull(steps);
+        assertEquals(5, steps.size());
+        CloseIndexStep firstStep = (CloseIndexStep) steps.get(0);
+        UpdateSettingsStep secondStep = (UpdateSettingsStep) steps.get(1);
+        OpenIndexStep thirdStep = (OpenIndexStep) steps.get(2);
+        WaitForIndexGreenStep fourthStep = (WaitForIndexGreenStep) steps.get(3);
+        ForceMergeStep fifthStep = (ForceMergeStep) steps.get(4);
+        assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
+        assertThat(firstStep.getNextStepKey(), equalTo(secondStep.getKey()));
+        assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
+        assertThat(secondStep.getSettings().get(EngineConfig.INDEX_CODEC_SETTING.getKey()), equalTo(CodecService.BEST_COMPRESSION_CODEC));
+        assertThat(secondStep.getNextStepKey(), equalTo(thirdStep.getKey()));
+        assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
+        assertThat(thirdStep.getNextStepKey(), equalTo(fourthStep));
+        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexGreenStep.NAME)));
+        assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
+        assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
+        assertThat(fifthStep.getNextStepKey(), equalTo(nextStepKey));
+    }
+
+    public void testMissingMaxNumSegments() throws IOException {
+        BytesReference emptyObject = BytesReference.bytes(JsonXContent.contentBuilder().startObject().endObject());
+        XContentParser parser = XContentHelper.createParser(null, DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
+            emptyObject, XContentType.JSON);
+        Exception e = expectThrows(IllegalArgumentException.class, () -> ForceMergeAction.parse(parser));
+        assertThat(e.getMessage(), equalTo("Required [max_num_segments, best_compression]"));
+    }
+
+    public void testInvalidNegativeSegmentNumber() {
+        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0), false));
+        assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
+    }
+
+    public void testToSteps() {
+        ForceMergeAction instance = createTestInstance();
+        if (instance.isBestCompression()) {
+            assertBestCompression(instance);
+        }
+        else {
+            assertNonBestCompression(instance);
+        }
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
new file mode 100644
index 0000000000000..164d5f7fe4c3c
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
@@ -0,0 +1,158 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+
+package org.elasticsearch.xpack.core.ilm;
+
+import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
+import org.elasticsearch.action.admin.indices.open.OpenIndexResponse;
+import org.elasticsearch.client.AdminClient;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.client.IndicesAdminClient;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.junit.Before;
+import org.mockito.Mockito;
+import org.mockito.stubbing.Answer;
+
+import static org.hamcrest.Matchers.equalTo;
+
+/**
+ * Created by sivagurunathanvelayutham on Dec, 2019
+ */
+public class OpenIndexStepTest extends AbstractStepTestCase<OpenIndexStep> {
+
+    private Client client;
+
+    @Before
+    public void setup() {
+        client = Mockito.mock(Client.class);
+    }
+
+    @Override
+    protected OpenIndexStep createRandomInstance() {
+        return new OpenIndexStep(randomStepKey(), randomStepKey(), client);
+    }
+
+    @Override
+    protected OpenIndexStep mutateInstance(OpenIndexStep instance) {
+        Step.StepKey key = instance.getKey();
+        Step.StepKey nextKey = instance.getNextStepKey();
+
+        switch (between(0, 1)) {
+            case 0:
+                key = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 1:
+                nextKey = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+
+        return new OpenIndexStep(key, nextKey, client);
+    }
+
+    @Override
+    protected OpenIndexStep copyInstance(OpenIndexStep instance) {
+        return new OpenIndexStep(instance.getKey(), instance.getNextStepKey(), instance.getClient());
+    }
+
+    public void testPerformAction() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10)).settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5))
+            .numberOfReplicas(randomIntBetween(0, 5))
+            .state(IndexMetaData.State.CLOSE)
+            .build();
+
+        OpenIndexStep step = createRandomInstance();
+
+        AdminClient adminClient = Mockito.mock(AdminClient.class);
+        IndicesAdminClient indicesClient = Mockito.mock(IndicesAdminClient.class);
+
+        Mockito.when(client.admin()).thenReturn(adminClient);
+        Mockito.when(adminClient.indices()).thenReturn(indicesClient);
+
+        Mockito.doAnswer((Answer<Void>) invocation -> {
+            OpenIndexRequest request = (OpenIndexRequest) invocation.getArguments()[0];
+            @SuppressWarnings("unchecked")
+            ActionListener<OpenIndexResponse> listener = (ActionListener<OpenIndexResponse>) invocation.getArguments()[1];
+            assertThat(request.indices(), equalTo(new String[]{indexMetaData.getIndex().getName()}));
+            listener.onResponse(new OpenIndexResponse(true, true));
+            return null;
+        }).when(indicesClient).open(Mockito.any(), Mockito.any());
+
+        SetOnce<Boolean> actionCompleted = new SetOnce<>();
+
+        step.performAction(indexMetaData, null, null, new AsyncActionStep.Listener() {
+
+            @Override
+            public void onResponse(boolean complete) {
+                actionCompleted.set(complete);
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                throw new AssertionError("Unexpected method call", e);
+            }
+        });
+
+        assertEquals(true, actionCompleted.get());
+        Mockito.verify(client, Mockito.only()).admin();
+        Mockito.verify(adminClient, Mockito.only()).indices();
+        Mockito.verify(indicesClient, Mockito.only()).open(Mockito.any(), Mockito.any());
+    }
+
+
+    public void testPerformActionFailure() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10)).settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5))
+            .numberOfReplicas(randomIntBetween(0, 5))
+            .state(IndexMetaData.State.CLOSE)
+            .build();
+
+        OpenIndexStep step = createRandomInstance();
+        Exception exception = new RuntimeException();
+        AdminClient adminClient = Mockito.mock(AdminClient.class);
+        IndicesAdminClient indicesClient = Mockito.mock(IndicesAdminClient.class);
+
+        Mockito.when(client.admin()).thenReturn(adminClient);
+        Mockito.when(adminClient.indices()).thenReturn(indicesClient);
+
+        Mockito.doAnswer((Answer<Void>) invocation -> {
+            OpenIndexRequest request = (OpenIndexRequest) invocation.getArguments()[0];
+            @SuppressWarnings("unchecked")
+            ActionListener<OpenIndexResponse> listener = (ActionListener<OpenIndexResponse>) invocation.getArguments()[1];
+            assertThat(request.indices(), equalTo(new String[]{indexMetaData.getIndex().getName()}));
+            listener.onFailure(exception);
+            return null;
+        }).when(indicesClient).open(Mockito.any(), Mockito.any());
+
+        SetOnce<Boolean> exceptionThrown = new SetOnce<>();
+
+        step.performAction(indexMetaData, null, null, new AsyncActionStep.Listener() {
+
+            @Override
+            public void onResponse(boolean complete) {
+                throw new AssertionError("Unexpected method call");
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                assertSame(exception, e);
+                exceptionThrown.set(true);
+            }
+        });
+
+        assertEquals(true, exceptionThrown.get());
+        Mockito.verify(client, Mockito.only()).admin();
+        Mockito.verify(adminClient, Mockito.only()).indices();
+        Mockito.verify(indicesClient, Mockito.only()).open(Mockito.any(), Mockito.any());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index a76a22fcc7821..49bc71c55971f 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -34,7 +34,7 @@ public class TimeseriesLifecycleTypeTests extends ESTestCase {
     private static final AllocateAction TEST_ALLOCATE_ACTION =
         new AllocateAction(2, Collections.singletonMap("node", "node1"),null, null);
     private static final DeleteAction TEST_DELETE_ACTION = new DeleteAction();
-    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1);
+    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, false);
     private static final RolloverAction TEST_ROLLOVER_ACTION = new RolloverAction(new ByteSizeValue(1), null, null);
     private static final ShrinkAction TEST_SHRINK_ACTION = new ShrinkAction(1);
     private static final ReadOnlyAction TEST_READ_ONLY_ACTION = new ReadOnlyAction();
@@ -492,7 +492,7 @@ private ConcurrentMap<String, LifecycleAction> convertActionNamesToActions(Strin
             case DeleteAction.NAME:
                 return new DeleteAction();
             case ForceMergeAction.NAME:
-                return new ForceMergeAction(1);
+                return new ForceMergeAction(1, false);
             case ReadOnlyAction.NAME:
                 return new ReadOnlyAction();
             case RolloverAction.NAME:
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
new file mode 100644
index 0000000000000..ec4f73c2ec592
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
@@ -0,0 +1,155 @@
+/*
+ * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+ * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
+ * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
+ * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
+ * Vestibulum commodo. Ut rhoncus gravida arcu.
+ */
+
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.Version;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.routing.IndexRoutingTable;
+import org.elasticsearch.cluster.routing.RoutingTable;
+import org.elasticsearch.cluster.routing.ShardRouting;
+import org.elasticsearch.cluster.routing.ShardRoutingState;
+import org.elasticsearch.cluster.routing.TestShardRouting;
+import org.elasticsearch.xpack.core.ilm.Step.StepKey;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.nullValue;
+import static org.hamcrest.core.IsNull.notNullValue;
+
+public class WaitForIndexGreenStepTest extends AbstractStepTestCase<WaitForIndexGreenStep> {
+
+    @Override
+    protected WaitForIndexGreenStep createRandomInstance() {
+        StepKey stepKey = randomStepKey();
+        StepKey nextStepKey = randomStepKey();
+        return new WaitForIndexGreenStep(stepKey, nextStepKey);
+    }
+
+    @Override
+    protected WaitForIndexGreenStep mutateInstance(WaitForIndexGreenStep instance) {
+        StepKey key = instance.getKey();
+        StepKey nextKey = instance.getNextStepKey();
+
+        if (randomBoolean()) {
+            key = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+        } else {
+            nextKey = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+        }
+
+        return new WaitForIndexGreenStep(key, nextKey);
+    }
+
+    @Override
+    protected WaitForIndexGreenStep copyInstance(WaitForIndexGreenStep instance) {
+        return new WaitForIndexGreenStep(instance.getKey(), instance.getNextStepKey());
+    }
+
+    public void testConditionMet() {
+        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(2)
+            .build();
+
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("test_index", 0, "1", true, ShardRoutingState.STARTED);
+        IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
+            .addShard(shardRouting).build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
+            .build();
+
+        WaitForIndexGreenStep step = createRandomInstance();
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(true));
+        assertThat(result.getInfomationContext(), nullValue());
+    }
+
+    public void testConditionNotMet() {
+        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .build();
+
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("test_index", 0, "1", true, ShardRoutingState.INITIALIZING);
+        IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
+            .addShard(shardRouting).build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
+            .build();
+
+        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(false));
+        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        assertThat(info, notNullValue());
+        assertThat(info.getMessage(), equalTo("index is not green; not all shards are active"));
+    }
+
+    public void testConditionNotMetWithYellow() {
+        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(2)
+            .build();
+
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("test_index", 0, "1", true, ShardRoutingState.STARTED);
+
+        ShardRouting replicaShardRouting =
+            TestShardRouting.newShardRouting("test_index", 0, "2", false, ShardRoutingState.INITIALIZING);
+
+        IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
+            .addShard(shardRouting)
+            .addShard(replicaShardRouting)
+            .build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
+            .build();
+
+        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(false));
+        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        assertThat(info, notNullValue());
+        assertThat(info.getMessage(), equalTo("index is yellow; not all replica shards are active"));
+    }
+
+    public void testConditionNotMetNoIndexRoutingTable() {
+        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().build())
+            .build();
+
+        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(false));
+        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        assertThat(info, notNullValue());
+        assertThat(info.getMessage(), equalTo("index is red; no IndexRoutingTable"));
+    }
+}
+

From b7c35b04cfde15e5ad7af718a8633687e6e3d7a4 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 8 Dec 2019 16:27:19 -0800
Subject: [PATCH 111/686] Checkstyle and License

---
 .../xpack/core/ilm/CloseIndexStep.java        | 24 ++++++++++++++-----
 .../xpack/core/ilm/OpenIndexStep.java         | 21 ++++++++++++----
 .../xpack/core/ilm/WaitForIndexGreenStep.java | 24 ++++++++++++-------
 .../xpack/core/ilm/CloseIndexStepTest.java    | 21 ++++++++++++----
 .../xpack/core/ilm/OpenIndexStepTest.java     | 21 ++++++++++++----
 .../core/ilm/WaitForIndexGreenStepTest.java   | 21 ++++++++++++----
 6 files changed, 98 insertions(+), 34 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index 8f78ce75653e5..1bac9ea91813b 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
@@ -27,7 +38,8 @@ public class CloseIndexStep extends AsyncActionStep {
     }
 
     @Override
-    public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState, ClusterStateObserver observer, Listener listener) {
+    public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState,
+                              ClusterStateObserver observer, Listener listener) {
         if(indexMetaData.getState() == IndexMetaData.State.OPEN) {
             CloseIndexRequest request = new CloseIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index 793db17eb8376..fc9cf75284411 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 package org.elasticsearch.xpack.core.ilm;
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
index f001644da2022..fc602a1a250f7 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
@@ -1,13 +1,23 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 package org.elasticsearch.xpack.core.ilm;
 
-import com.carrotsearch.hppc.cursors.IntObjectCursor;
 import com.carrotsearch.hppc.cursors.ObjectCursor;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.routing.IndexRoutingTable;
@@ -20,9 +30,7 @@
 import org.elasticsearch.index.Index;
 
 import java.io.IOException;
-import java.util.List;
 import java.util.Objects;
-import java.util.stream.Stream;
 
 class WaitForIndexGreenStep extends ClusterStateWaitStep {
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
index 7d7a64edc6336..409180e2118d2 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
index 164d5f7fe4c3c..95d7da6457ce8 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
index ec4f73c2ec592..87c1f19a56e4f 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
@@ -1,9 +1,20 @@
 /*
- * Copyright (c) 2019. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
- * Morbi non lorem porttitor neque feugiat blandit. Ut vitae ipsum eget quam lacinia accumsan.
- * Etiam sed turpis ac ipsum condimentum fringilla. Maecenas magna.
- * Proin dapibus sapien vel ante. Aliquam erat volutpat. Pellentesque sagittis ligula eget metus.
- * Vestibulum commodo. Ut rhoncus gravida arcu.
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
  */
 
 package org.elasticsearch.xpack.core.ilm;

From c8e054393bf5e5d0672367a986216d9ba60dcc99 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 8 Dec 2019 16:36:06 -0800
Subject: [PATCH 112/686] Removing Comments from file

---
 .../java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java  | 3 ---
 .../org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java   | 3 ---
 .../org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java    | 3 ---
 3 files changed, 9 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index 1bac9ea91813b..53f7e469c3bbe 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -27,9 +27,6 @@
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.xpack.core.ilm.AsyncActionStep;
 
-/**
- * Invokes a Close Index Step on a index.
- */
 public class CloseIndexStep extends AsyncActionStep {
     public static final String NAME = "close-index";
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
index 409180e2118d2..53b2c47d00b69 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
@@ -36,9 +36,6 @@
 
 import static org.hamcrest.Matchers.equalTo;
 
-/**
- * Created by sivagurunathanvelayutham on Dec, 2019
- */
 public class CloseIndexStepTest extends AbstractStepTestCase<CloseIndexStep> {
 
     private Client client;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
index 95d7da6457ce8..558e4ac824a11 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
@@ -34,9 +34,6 @@
 
 import static org.hamcrest.Matchers.equalTo;
 
-/**
- * Created by sivagurunathanvelayutham on Dec, 2019
- */
 public class OpenIndexStepTest extends AbstractStepTestCase<OpenIndexStep> {
 
     private Client client;

From 67884b31e2d2799afbed7e052848c1ee78ba8def Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Mon, 9 Dec 2019 08:27:41 +0100
Subject: [PATCH 113/686] Randomly run CCR tests with _source disabled (#49922)

Makes sure that CCR also properly works with _source disabled.

Changes one exception in LuceneChangesSnapshot as the case of missing _recovery_source
because of a missing lease was not properly properly bubbled up to CCR (testIndexFallBehind
was failing).
---
 .../index/engine/LuceneChangesSnapshot.java         |  2 +-
 .../org/elasticsearch/xpack/CcrIntegTestCase.java   | 13 +++++++++++++
 .../elasticsearch/xpack/ccr/CcrRepositoryIT.java    |  6 ++++--
 .../xpack/ccr/CcrRetentionLeaseIT.java              |  6 ++++--
 .../elasticsearch/xpack/ccr/IndexFollowingIT.java   |  6 ++++--
 5 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/engine/LuceneChangesSnapshot.java b/server/src/main/java/org/elasticsearch/index/engine/LuceneChangesSnapshot.java
index 78b6587eeac0f..7ae37965a2ffd 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/LuceneChangesSnapshot.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/LuceneChangesSnapshot.java
@@ -255,7 +255,7 @@ private Translog.Operation readDocAsOp(int docIndex) throws IOException {
                     // TODO: Callers should ask for the range that source should be retained. Thus we should always
                     // check for the existence source once we make peer-recovery to send ops after the local checkpoint.
                     if (requiredFullRange) {
-                        throw new IllegalStateException("source not found for seqno=" + seqNo +
+                        throw new MissingHistoryOperationsException("source not found for seqno=" + seqNo +
                             " from_seqno=" + fromSeqNo + " to_seqno=" + toSeqNo);
                     } else {
                         skippedOperations++;
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
index cc48c080ac8ce..fbd537ed18d98 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
@@ -405,6 +405,14 @@ protected void ensureNoCcrTasks() throws Exception {
         }, 30, TimeUnit.SECONDS);
     }
 
+
+    @Before
+    public void setupSourceEnabledOrDisabled() {
+        sourceEnabled = randomBoolean();
+    }
+
+    protected boolean sourceEnabled;
+
     protected String getIndexSettings(final int numberOfShards, final int numberOfReplicas,
                                     final Map<String, String> additionalIndexSettings) throws IOException {
         final String settings;
@@ -435,6 +443,11 @@ protected String getIndexSettings(final int numberOfShards, final int numberOfRe
                             builder.endObject();
                         }
                         builder.endObject();
+                        if (sourceEnabled == false) {
+                            builder.startObject("_source");
+                            builder.field("enabled", false);
+                            builder.endObject();
+                        }
                     }
                     builder.endObject();
                 }
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRepositoryIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRepositoryIT.java
index 1bedab2134adc..a8f393073a745 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRepositoryIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRepositoryIT.java
@@ -446,8 +446,10 @@ public void testFollowerMappingIsUpdated() throws IOException {
     private void assertExpectedDocument(String followerIndex, final int value) {
         final GetResponse getResponse = followerClient().prepareGet(followerIndex, Integer.toString(value)).get();
         assertTrue("Doc with id [" + value + "] is missing", getResponse.isExists());
-        assertTrue((getResponse.getSource().containsKey("f")));
-        assertThat(getResponse.getSource().get("f"), equalTo(value));
+        if (sourceEnabled) {
+            assertTrue((getResponse.getSource().containsKey("f")));
+            assertThat(getResponse.getSource().get("f"), equalTo(value));
+        }
     }
 
 }
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRetentionLeaseIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRetentionLeaseIT.java
index b7ebb4dddad92..b74ca1dbc985a 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRetentionLeaseIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRetentionLeaseIT.java
@@ -1075,8 +1075,10 @@ private String getRetentionLeaseId(String followerIndex, String followerUUID, St
     private void assertExpectedDocument(final String followerIndex, final int value) {
         final GetResponse getResponse = followerClient().prepareGet(followerIndex, Integer.toString(value)).get();
         assertTrue("doc with id [" + value + "] is missing", getResponse.isExists());
-        assertTrue((getResponse.getSource().containsKey("f")));
-        assertThat(getResponse.getSource().get("f"), equalTo(value));
+        if (sourceEnabled) {
+            assertTrue((getResponse.getSource().containsKey("f")));
+            assertThat(getResponse.getSource().get("f"), equalTo(value));
+        }
     }
 
 }
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
index b23dbbc68c315..7bede18aea08d 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
@@ -1519,8 +1519,10 @@ private CheckedRunnable<Exception> assertExpectedDocumentRunnable(final int key,
         return () -> {
             final GetResponse getResponse = followerClient().prepareGet("index2", Integer.toString(key)).get();
             assertTrue("Doc with id [" + key + "] is missing", getResponse.isExists());
-            assertTrue((getResponse.getSource().containsKey("f")));
-            assertThat(getResponse.getSource().get("f"), equalTo(value));
+            if (sourceEnabled) {
+                assertTrue((getResponse.getSource().containsKey("f")));
+                assertThat(getResponse.getSource().get("f"), equalTo(value));
+            }
         };
     }
 

From f80aa2e47b3ba766ff69ed2d7fd701a440c81b3d Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Mon, 9 Dec 2019 08:28:23 +0100
Subject: [PATCH 114/686] Properly fake corrupted translog (#49918)

The fake translog corruption in the test sometimes generates invalid translog files where some
assertions do not hold (e.g. minSeqNo <= maxSeqNo or minTranslogGen <= translogGen)

Closes #49909
---
 .../index/translog/TestTranslog.java          | 20 ++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/translog/TestTranslog.java b/server/src/test/java/org/elasticsearch/index/translog/TestTranslog.java
index f80d0db880057..d78a731674258 100644
--- a/server/src/test/java/org/elasticsearch/index/translog/TestTranslog.java
+++ b/server/src/test/java/org/elasticsearch/index/translog/TestTranslog.java
@@ -92,11 +92,21 @@ static void corruptRandomTranslogFile(Logger logger, Random random, Path translo
                 // if we crashed while rolling a generation then we might have copied `translog.ckp` to its numbered generation file but
                 // have not yet written a new `translog.ckp`. During recovery we must also verify that this file is intact, so it's ok to
                 // corrupt this file too (either by writing the wrong information, correctly formatted, or by properly corrupting it)
-                final Checkpoint checkpointCopy = LuceneTestCase.usually(random) ? checkpoint
-                        : new Checkpoint(checkpoint.offset + random.nextInt(2), checkpoint.numOps + random.nextInt(2),
-                            checkpoint.generation + random.nextInt(2), checkpoint.minSeqNo + random.nextInt(2),
-                            checkpoint.maxSeqNo + random.nextInt(2), checkpoint.globalCheckpoint + random.nextInt(2),
-                            checkpoint.minTranslogGeneration + random.nextInt(2), checkpoint.trimmedAboveSeqNo + random.nextInt(2));
+                final Checkpoint checkpointCopy;
+                if (LuceneTestCase.usually(random)) {
+                    checkpointCopy = checkpoint;
+                } else {
+                    long newTranslogGeneration = checkpoint.generation + random.nextInt(2);
+                    long newMinTranslogGeneration = Math.min(newTranslogGeneration, checkpoint.minTranslogGeneration + random.nextInt(2));
+                    long newMaxSeqNo = checkpoint.maxSeqNo + random.nextInt(2);
+                    long newMinSeqNo = Math.min(newMaxSeqNo, checkpoint.minSeqNo + random.nextInt(2));
+                    long newTrimmedAboveSeqNo = Math.min(newMaxSeqNo, checkpoint.trimmedAboveSeqNo + random.nextInt(2));
+
+                    checkpointCopy = new Checkpoint(checkpoint.offset + random.nextInt(2), checkpoint.numOps + random.nextInt(2),
+                        newTranslogGeneration, newMinSeqNo,
+                        newMaxSeqNo, checkpoint.globalCheckpoint + random.nextInt(2),
+                        newMinTranslogGeneration, newTrimmedAboveSeqNo);
+                }
                 Checkpoint.write(FileChannel::open, unnecessaryCheckpointCopyPath, checkpointCopy,
                     StandardOpenOption.WRITE, StandardOpenOption.CREATE_NEW);
 

From 835a1616824ab8db969abddd6168cdc8a5705642 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 9 Dec 2019 09:02:38 +0100
Subject: [PATCH 115/686] Disable BwC Tests for #49976 (#49977)

Disabling BwC tests so #49976 can be merged.
---
 build.gradle | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/build.gradle b/build.gradle
index df1641dcc9efe..d67acb4a37dfa 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = true
-final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = false
+final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/49976" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")

From 3cb037c12d02bf54b05bf448a2a18fb0471c985c Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Mon, 9 Dec 2019 11:02:16 +0200
Subject: [PATCH 116/686] [ML] Update expected mem estimate in explain API
 integ test (#49924)

Work in progress in the c++ side is increasing memory estimates
a bit and this test fails. At the time of this commit the mem
estimate when there is no source query is a about 2Mb. So I
am relaxing the test to assert memory estimate is less than 1Mb
instead of 500Kb.
---
 .../xpack/ml/integration/ExplainDataFrameAnalyticsIT.java       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
index 540d9f373b7e4..ba00e49456f5f 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
@@ -60,6 +60,6 @@ public void testSourceQueryIsApplied() throws IOException {
 
         ExplainDataFrameAnalyticsAction.Response explainResponse = explainDataFrame(config);
 
-        assertThat(explainResponse.getMemoryEstimation().getExpectedMemoryWithoutDisk().getKb(), lessThanOrEqualTo(500L));
+        assertThat(explainResponse.getMemoryEstimation().getExpectedMemoryWithoutDisk().getKb(), lessThanOrEqualTo(1024L));
     }
 }

From afdc6c82d24b7d978134debab6a6ce40f8cb1ea1 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 9 Dec 2019 11:18:39 +0100
Subject: [PATCH 117/686] Reenable BwC Tests After #49976 (#49978)

With #49976 merged we can reenable BwC tests.
---
 build.gradle                                                  | 4 ++--
 .../elasticsearch/cluster/metadata/RepositoryMetaData.java    | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/build.gradle b/build.gradle
index d67acb4a37dfa..df1641dcc9efe 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = false
-final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/49976" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = true
+final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoryMetaData.java b/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoryMetaData.java
index c210c32a9a529..c57f702805504 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoryMetaData.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/RepositoryMetaData.java
@@ -32,7 +32,7 @@
  */
 public class RepositoryMetaData {
 
-    public static final Version REPO_GEN_IN_CS_VERSION = Version.V_8_0_0;
+    public static final Version REPO_GEN_IN_CS_VERSION = Version.V_7_6_0;
 
     private final String name;
     private final String type;

From a470b6e5d49d27ad816cb9e57b44d5baa9e773ce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Mon, 9 Dec 2019 13:21:58 +0100
Subject: [PATCH 118/686] Pass `prediction_field_type` to C++ analytics process
 (#49861)

---
 .../ml/dataframe/analyses/Classification.java | 29 +++++-
 .../dataframe/analyses/DataFrameAnalysis.java |  3 +-
 .../dataframe/analyses/OutlierDetection.java  |  2 +-
 .../ml/dataframe/analyses/Regression.java     |  2 +-
 .../analyses/ClassificationTests.java         | 37 ++++++++
 .../analyses/OutlierDetectionTests.java       |  4 +-
 .../dataframe/analyses/RegressionTests.java   |  7 ++
 .../ml/dataframe/analyses/TypesTests.java     | 21 +++++
 .../ClassificationEvaluationIT.java           | 86 ++++++++++++++----
 .../ml/integration/ClassificationIT.java      | 90 +++++++++++--------
 .../DataFrameDataExtractorFactory.java        |  4 +
 .../extractor/ExtractedFieldsDetector.java    | 14 ++-
 .../process/AnalyticsProcessConfig.java       | 19 +++-
 .../process/AnalyticsProcessManager.java      | 19 +++-
 .../MemoryUsageEstimationProcessManager.java  |  3 +-
 .../xpack/ml/extractor/ExtractedFields.java   |  4 +-
 .../ExtractedFieldsDetectorTests.java         | 86 ++++++++----------
 .../process/AnalyticsProcessManagerTests.java |  2 +
 .../AnalyticsResultProcessorTests.java        |  4 +-
 ...oryUsageEstimationProcessManagerTests.java |  2 +
 .../ml/extractor/ExtractedFieldsTests.java    |  2 +-
 21 files changed, 313 insertions(+), 127 deletions(-)
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/TypesTests.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
index b075a7606c87c..b4b258ea161fa 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
@@ -65,6 +65,12 @@ public static Classification fromXContent(XContentParser parser, boolean ignoreU
         Stream.of(Types.categorical(), Types.discreteNumerical(), Types.bool())
             .flatMap(Set::stream)
             .collect(Collectors.toUnmodifiableSet());
+    /**
+     * Name of the parameter passed down to C++.
+     * This parameter is used to decide which JSON data type from {string, int, bool} to use when writing the prediction.
+     */
+    private static final String PREDICTION_FIELD_TYPE = "prediction_field_type";
+
     /**
      * As long as we only support binary classification it makes sense to always report both classes with their probabilities.
      * This way the user can see if the prediction was made with confidence they need.
@@ -152,7 +158,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     }
 
     @Override
-    public Map<String, Object> getParams() {
+    public Map<String, Object> getParams(Map<String, Set<String>> extractedFields) {
         Map<String, Object> params = new HashMap<>();
         params.put(DEPENDENT_VARIABLE.getPreferredName(), dependentVariable);
         params.putAll(boostedTreeParams.getParams());
@@ -160,9 +166,30 @@ public Map<String, Object> getParams() {
         if (predictionFieldName != null) {
             params.put(PREDICTION_FIELD_NAME.getPreferredName(), predictionFieldName);
         }
+        String predictionFieldType = getPredictionFieldType(extractedFields.get(dependentVariable));
+        if (predictionFieldType != null) {
+            params.put(PREDICTION_FIELD_TYPE, predictionFieldType);
+        }
         return params;
     }
 
+    private static String getPredictionFieldType(Set<String> dependentVariableTypes) {
+        if (dependentVariableTypes == null) {
+            return null;
+        }
+        if (Types.categorical().containsAll(dependentVariableTypes)) {
+            return "string";
+        }
+        if (Types.bool().containsAll(dependentVariableTypes)) {
+            return "bool";
+        }
+        if (Types.discreteNumerical().containsAll(dependentVariableTypes)) {
+            // C++ process uses int64_t type, so it is safe for the dependent variable to use long numbers.
+            return "int";
+        }
+        return null;
+    }
+
     @Override
     public boolean supportsCategoricalFields() {
         return true;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/DataFrameAnalysis.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/DataFrameAnalysis.java
index 0ca32cde4021c..d0af0a452a474 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/DataFrameAnalysis.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/DataFrameAnalysis.java
@@ -16,8 +16,9 @@ public interface DataFrameAnalysis extends ToXContentObject, NamedWriteable {
 
     /**
      * @return The analysis parameters as a map
+     * @param extractedFields map of (name, types) for all the extracted fields
      */
-    Map<String, Object> getParams();
+    Map<String, Object> getParams(Map<String, Set<String>> extractedFields);
 
     /**
      * @return {@code true} if this analysis supports fields with categorical values (i.e. text, keyword, ip)
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetection.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetection.java
index d4cefe884b53b..70b3cfb9fe246 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetection.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetection.java
@@ -192,7 +192,7 @@ public int hashCode() {
     }
 
     @Override
-    public Map<String, Object> getParams() {
+    public Map<String, Object> getParams(Map<String, Set<String>> extractedFields) {
         Map<String, Object> params = new HashMap<>();
         if (nNeighbors != null) {
             params.put(N_NEIGHBORS.getPreferredName(), nNeighbors);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
index 6fa163dd65ca0..01388f01d807c 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
@@ -124,7 +124,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     }
 
     @Override
-    public Map<String, Object> getParams() {
+    public Map<String, Object> getParams(Map<String, Set<String>> extractedFields) {
         Map<String, Object> params = new HashMap<>();
         params.put(DEPENDENT_VARIABLE.getPreferredName(), dependentVariable);
         params.putAll(boostedTreeParams.getParams());
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
index 8306d08af7979..61d6b4dfe3f7a 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
@@ -8,9 +8,14 @@
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.index.mapper.BooleanFieldMapper;
+import org.elasticsearch.index.mapper.KeywordFieldMapper;
+import org.elasticsearch.index.mapper.NumberFieldMapper;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 
 import java.io.IOException;
+import java.util.Map;
+import java.util.Set;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
@@ -115,6 +120,38 @@ public void testGetTrainingPercent() {
         assertThat(classification.getTrainingPercent(), equalTo(100.0));
     }
 
+    public void testGetParams() {
+        Map<String, Set<String>> extractedFields =
+            Map.of(
+                "foo", Set.of(BooleanFieldMapper.CONTENT_TYPE),
+                "bar", Set.of(NumberFieldMapper.NumberType.LONG.typeName()),
+                "baz", Set.of(KeywordFieldMapper.CONTENT_TYPE));
+        assertThat(
+            new Classification("foo").getParams(extractedFields),
+            equalTo(
+                Map.of(
+                    "dependent_variable", "foo",
+                    "num_top_classes", 2,
+                    "prediction_field_name", "foo_prediction",
+                    "prediction_field_type", "bool")));
+        assertThat(
+            new Classification("bar").getParams(extractedFields),
+            equalTo(
+                Map.of(
+                    "dependent_variable", "bar",
+                    "num_top_classes", 2,
+                    "prediction_field_name", "bar_prediction",
+                    "prediction_field_type", "int")));
+        assertThat(
+            new Classification("baz").getParams(extractedFields),
+            equalTo(
+                Map.of(
+                    "dependent_variable", "baz",
+                    "num_top_classes", 2,
+                    "prediction_field_name", "baz_prediction",
+                    "prediction_field_type", "string")));
+    }
+
     public void testFieldCardinalityLimitsIsNonNull() {
         assertThat(createTestInstance().getFieldCardinalityLimits(), is(not(nullValue())));
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetectionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetectionTests.java
index b11817145174e..c35b9a3bad1af 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetectionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetectionTests.java
@@ -51,7 +51,7 @@ protected Writeable.Reader<OutlierDetection> instanceReader() {
 
     public void testGetParams_GivenDefaults() {
         OutlierDetection outlierDetection = new OutlierDetection.Builder().build();
-        Map<String, Object> params = outlierDetection.getParams();
+        Map<String, Object> params = outlierDetection.getParams(null);
         assertThat(params.size(), equalTo(3));
         assertThat(params.containsKey("compute_feature_influence"), is(true));
         assertThat(params.get("compute_feature_influence"), is(true));
@@ -71,7 +71,7 @@ public void testGetParams_GivenExplicitValues() {
             .setStandardizationEnabled(false)
             .build();
 
-        Map<String, Object> params = outlierDetection.getParams();
+        Map<String, Object> params = outlierDetection.getParams(null);
 
         assertThat(params.size(), equalTo(6));
         assertThat(params.get(OutlierDetection.N_NEIGHBORS.getPreferredName()), equalTo(42));
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
index 089f29e53cb5a..f3d5312280e88 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
@@ -11,6 +11,7 @@
 import org.elasticsearch.test.AbstractSerializingTestCase;
 
 import java.io.IOException;
+import java.util.Map;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
@@ -83,6 +84,12 @@ public void testGetTrainingPercent() {
         assertThat(regression.getTrainingPercent(), equalTo(100.0));
     }
 
+    public void testGetParams() {
+        assertThat(
+            new Regression("foo").getParams(null),
+            equalTo(Map.of("dependent_variable", "foo", "prediction_field_name", "foo_prediction")));
+    }
+
     public void testFieldCardinalityLimitsIsNonNull() {
         assertThat(createTestInstance().getFieldCardinalityLimits(), is(not(nullValue())));
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/TypesTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/TypesTests.java
new file mode 100644
index 0000000000000..beac3bcae9426
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/TypesTests.java
@@ -0,0 +1,21 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.analyses;
+
+import org.elasticsearch.common.util.set.Sets;
+import org.elasticsearch.test.ESTestCase;
+
+import static org.hamcrest.Matchers.empty;
+
+public class TypesTests extends ESTestCase {
+
+    public void testTypes() {
+        assertThat(Sets.intersection(Types.bool(), Types.categorical()), empty());
+        assertThat(Sets.intersection(Types.categorical(), Types.numerical()), empty());
+        assertThat(Sets.intersection(Types.numerical(), Types.bool()), empty());
+        assertThat(Sets.difference(Types.discreteNumerical(), Types.numerical()), empty());
+    }
+}
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
index cb7ef69b5569e..6fd7e289fc231 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
@@ -27,8 +27,12 @@ public class ClassificationEvaluationIT extends MlNativeDataFrameAnalyticsIntegT
 
     private static final String ANIMALS_DATA_INDEX = "test-evaluate-animals-index";
 
-    private static final String ACTUAL_CLASS_FIELD = "actual_class_field";
-    private static final String PREDICTED_CLASS_FIELD = "predicted_class_field";
+    private static final String ANIMAL_NAME_FIELD = "animal_name";
+    private static final String ANIMAL_NAME_PREDICTION_FIELD = "animal_name_prediction";
+    private static final String NO_LEGS_FIELD = "no_legs";
+    private static final String NO_LEGS_PREDICTION_FIELD = "no_legs_prediction";
+    private static final String IS_PREDATOR_FIELD = "predator";
+    private static final String IS_PREDATOR_PREDICTION_FIELD = "predator_prediction";
 
     @Before
     public void setup() {
@@ -40,9 +44,9 @@ public void cleanup() {
         cleanUp();
     }
 
-    public void testEvaluate_MulticlassClassification_DefaultMetrics() {
+    public void testEvaluate_DefaultMetrics() {
         EvaluateDataFrameAction.Response evaluateDataFrameResponse =
-            evaluateDataFrame(ANIMALS_DATA_INDEX, new Classification(ACTUAL_CLASS_FIELD, PREDICTED_CLASS_FIELD, null));
+            evaluateDataFrame(ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, null));
 
         assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
         assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
@@ -51,9 +55,10 @@ public void testEvaluate_MulticlassClassification_DefaultMetrics() {
             equalTo(MulticlassConfusionMatrix.NAME.getPreferredName()));
     }
 
-    public void testEvaluate_MulticlassClassification_Accuracy() {
+    public void testEvaluate_Accuracy_KeywordField() {
         EvaluateDataFrameAction.Response evaluateDataFrameResponse =
-            evaluateDataFrame(ANIMALS_DATA_INDEX, new Classification(ACTUAL_CLASS_FIELD, PREDICTED_CLASS_FIELD, List.of(new Accuracy())));
+            evaluateDataFrame(
+                ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Accuracy())));
 
         assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
         assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
@@ -72,11 +77,50 @@ public void testEvaluate_MulticlassClassification_Accuracy() {
         assertThat(accuracyResult.getOverallAccuracy(), equalTo(5.0 / 75));
     }
 
-    public void testEvaluate_MulticlassClassification_AccuracyAndConfusionMatrixMetricWithDefaultSize() {
+    public void testEvaluate_Accuracy_IntegerField() {
+        EvaluateDataFrameAction.Response evaluateDataFrameResponse =
+            evaluateDataFrame(
+                ANIMALS_DATA_INDEX, new Classification(NO_LEGS_FIELD, NO_LEGS_PREDICTION_FIELD, List.of(new Accuracy())));
+
+        assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
+        assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
+
+        Accuracy.Result accuracyResult = (Accuracy.Result) evaluateDataFrameResponse.getMetrics().get(0);
+        assertThat(accuracyResult.getMetricName(), equalTo(Accuracy.NAME.getPreferredName()));
+        assertThat(
+            accuracyResult.getActualClasses(),
+            equalTo(List.of(
+                new Accuracy.ActualClass("1", 15, 1.0 / 15),
+                new Accuracy.ActualClass("2", 15, 2.0 / 15),
+                new Accuracy.ActualClass("3", 15, 3.0 / 15),
+                new Accuracy.ActualClass("4", 15, 4.0 / 15),
+                new Accuracy.ActualClass("5", 15, 5.0 / 15))));
+        assertThat(accuracyResult.getOverallAccuracy(), equalTo(15.0 / 75));
+    }
+
+    public void testEvaluate_Accuracy_BooleanField() {
+        EvaluateDataFrameAction.Response evaluateDataFrameResponse =
+            evaluateDataFrame(
+                ANIMALS_DATA_INDEX, new Classification(IS_PREDATOR_FIELD, IS_PREDATOR_PREDICTION_FIELD, List.of(new Accuracy())));
+
+        assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
+        assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
+
+        Accuracy.Result accuracyResult = (Accuracy.Result) evaluateDataFrameResponse.getMetrics().get(0);
+        assertThat(accuracyResult.getMetricName(), equalTo(Accuracy.NAME.getPreferredName()));
+        assertThat(
+            accuracyResult.getActualClasses(),
+            equalTo(List.of(
+                new Accuracy.ActualClass("true", 45, 27.0 / 45),
+                new Accuracy.ActualClass("false", 30, 18.0 / 30))));
+        assertThat(accuracyResult.getOverallAccuracy(), equalTo(45.0 / 75));
+    }
+
+    public void testEvaluate_ConfusionMatrixMetricWithDefaultSize() {
         EvaluateDataFrameAction.Response evaluateDataFrameResponse =
             evaluateDataFrame(
                 ANIMALS_DATA_INDEX,
-                new Classification(ACTUAL_CLASS_FIELD, PREDICTED_CLASS_FIELD, List.of(new MulticlassConfusionMatrix())));
+                new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new MulticlassConfusionMatrix())));
 
         assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
         assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
@@ -135,11 +179,11 @@ public void testEvaluate_MulticlassClassification_AccuracyAndConfusionMatrixMetr
         assertThat(confusionMatrixResult.getOtherActualClassCount(), equalTo(0L));
     }
 
-    public void testEvaluate_MulticlassClassification_ConfusionMatrixMetricWithUserProvidedSize() {
+    public void testEvaluate_ConfusionMatrixMetricWithUserProvidedSize() {
         EvaluateDataFrameAction.Response evaluateDataFrameResponse =
             evaluateDataFrame(
                 ANIMALS_DATA_INDEX,
-                new Classification(ACTUAL_CLASS_FIELD, PREDICTED_CLASS_FIELD, List.of(new MulticlassConfusionMatrix(3))));
+                new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new MulticlassConfusionMatrix(3))));
 
         assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
         assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
@@ -166,20 +210,30 @@ public void testEvaluate_MulticlassClassification_ConfusionMatrixMetricWithUserP
 
     private static void indexAnimalsData(String indexName) {
         client().admin().indices().prepareCreate(indexName)
-            .addMapping("_doc", ACTUAL_CLASS_FIELD, "type=keyword", PREDICTED_CLASS_FIELD, "type=keyword")
+            .addMapping("_doc",
+                ANIMAL_NAME_FIELD, "type=keyword",
+                ANIMAL_NAME_PREDICTION_FIELD, "type=keyword",
+                NO_LEGS_FIELD, "type=integer",
+                NO_LEGS_PREDICTION_FIELD, "type=integer",
+                IS_PREDATOR_FIELD, "type=boolean",
+                IS_PREDATOR_PREDICTION_FIELD, "type=boolean")
             .get();
 
-        List<String> classNames = List.of("dog", "cat", "mouse", "ant", "fox");
+        List<String> animalNames = List.of("dog", "cat", "mouse", "ant", "fox");
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk()
             .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
-        for (int i = 0; i < classNames.size(); i++) {
-            for (int j = 0; j < classNames.size(); j++) {
+        for (int i = 0; i < animalNames.size(); i++) {
+            for (int j = 0; j < animalNames.size(); j++) {
                 for (int k = 0; k < j + 1; k++) {
                     bulkRequestBuilder.add(
                         new IndexRequest(indexName)
                             .source(
-                                ACTUAL_CLASS_FIELD, classNames.get(i),
-                                PREDICTED_CLASS_FIELD, classNames.get((i + j) % classNames.size())));
+                                ANIMAL_NAME_FIELD, animalNames.get(i),
+                                ANIMAL_NAME_PREDICTION_FIELD, animalNames.get((i + j) % animalNames.size()),
+                                NO_LEGS_FIELD, i + 1,
+                                NO_LEGS_PREDICTION_FIELD, j + 1,
+                                IS_PREDATOR_FIELD, i % 2 == 0,
+                                IS_PREDATOR_PREDICTION_FIELD, (i + j) % 2 == 0));
                 }
             }
         }
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index d354cf4cd4ba7..1d3f6bf4f2e75 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -20,9 +20,8 @@
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParamsTests;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.ActualClass;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.PredictedClass;
 import org.junit.After;
 
 import java.util.ArrayList;
@@ -30,7 +29,6 @@
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
-import java.util.function.Function;
 
 import static java.util.stream.Collectors.toList;
 import static org.hamcrest.Matchers.allOf;
@@ -88,7 +86,7 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
             assertThat((String) resultsObject.get("keyword-field_prediction"), is(in(KEYWORD_FIELD_VALUES)));
             assertThat(resultsObject.containsKey("is_training"), is(true));
             assertThat(resultsObject.get("is_training"), is(destDoc.containsKey(KEYWORD_FIELD)));
-            assertTopClasses(resultsObject, 2, KEYWORD_FIELD, KEYWORD_FIELD_VALUES, String::valueOf);
+            assertTopClasses(resultsObject, 2, KEYWORD_FIELD, KEYWORD_FIELD_VALUES);
         }
 
         assertProgress(jobId, 100, 100, 100, 100);
@@ -102,7 +100,7 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
             "Creating destination index [" + destIndex + "]",
             "Finished reindexing to destination index [" + destIndex + "]",
             "Finished analysis");
-        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml.keyword-field_prediction");
+        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml.keyword-field_prediction.keyword");
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsHundred() throws Exception {
@@ -128,7 +126,7 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsHundred() throws Excepti
             assertThat((String) resultsObject.get("keyword-field_prediction"), is(in(KEYWORD_FIELD_VALUES)));
             assertThat(resultsObject.containsKey("is_training"), is(true));
             assertThat(resultsObject.get("is_training"), is(true));
-            assertTopClasses(resultsObject, 2, KEYWORD_FIELD, KEYWORD_FIELD_VALUES, String::valueOf);
+            assertTopClasses(resultsObject, 2, KEYWORD_FIELD, KEYWORD_FIELD_VALUES);
         }
 
         assertProgress(jobId, 100, 100, 100, 100);
@@ -142,11 +140,11 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsHundred() throws Excepti
             "Creating destination index [" + destIndex + "]",
             "Finished reindexing to destination index [" + destIndex + "]",
             "Finished analysis");
-        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml.keyword-field_prediction");
+        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml.keyword-field_prediction.keyword");
     }
 
     public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-            String jobId, String dependentVariable, List<T> dependentVariableValues, Function<String, T> parser) throws Exception {
+            String jobId, String dependentVariable, List<T> dependentVariableValues) throws Exception {
         initialize(jobId);
         String predictedClassField = dependentVariable + "_prediction";
         indexData(sourceIndex, 300, 0, dependentVariable);
@@ -175,9 +173,10 @@ public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
         for (SearchHit hit : sourceData.getHits()) {
             Map<String, Object> resultsObject = getMlResultsObjectFromDestDoc(getDestDoc(config, hit));
             assertThat(resultsObject.containsKey(predictedClassField), is(true));
-            T predictedClassValue = parser.apply((String) resultsObject.get(predictedClassField));
+            @SuppressWarnings("unchecked")
+            T predictedClassValue = (T) resultsObject.get(predictedClassField);
             assertThat(predictedClassValue, is(in(dependentVariableValues)));
-            assertTopClasses(resultsObject, numTopClasses, dependentVariable, dependentVariableValues, parser);
+            assertTopClasses(resultsObject, numTopClasses, dependentVariable, dependentVariableValues);
 
             assertThat(resultsObject.containsKey("is_training"), is(true));
             // Let's just assert there's both training and non-training results
@@ -201,33 +200,32 @@ public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
             "Creating destination index [" + destIndex + "]",
             "Finished reindexing to destination index [" + destIndex + "]",
             "Finished analysis");
-        assertEvaluation(
-            dependentVariable,
-            dependentVariableValues.stream().map(String::valueOf).collect(toList()),
-            "ml." + predictedClassField);
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableIsKeyword() throws Exception {
         testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-            "classification_training_percent_is_50_keyword", KEYWORD_FIELD, KEYWORD_FIELD_VALUES, String::valueOf);
+            "classification_training_percent_is_50_keyword", KEYWORD_FIELD, KEYWORD_FIELD_VALUES);
+        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml.keyword-field_prediction.keyword");
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableIsInteger() throws Exception {
         testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-            "classification_training_percent_is_50_integer", DISCRETE_NUMERICAL_FIELD, DISCRETE_NUMERICAL_FIELD_VALUES, Integer::valueOf);
+            "classification_training_percent_is_50_integer", DISCRETE_NUMERICAL_FIELD, DISCRETE_NUMERICAL_FIELD_VALUES);
+        assertEvaluation(DISCRETE_NUMERICAL_FIELD, DISCRETE_NUMERICAL_FIELD_VALUES, "ml.discrete-numerical-field_prediction");
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableIsDouble() throws Exception {
         ElasticsearchStatusException e = expectThrows(
             ElasticsearchStatusException.class,
             () -> testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-                "classification_training_percent_is_50_double", NUMERICAL_FIELD, NUMERICAL_FIELD_VALUES, Double::valueOf));
+                "classification_training_percent_is_50_double", NUMERICAL_FIELD, NUMERICAL_FIELD_VALUES));
         assertThat(e.getMessage(), startsWith("invalid types [double] for required field [numerical-field];"));
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableIsBoolean() throws Exception {
         testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-            "classification_training_percent_is_50_boolean", BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES, Boolean::valueOf);
+            "classification_training_percent_is_50_boolean", BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES);
+        assertEvaluation(BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES, "ml.boolean-field_prediction");
     }
 
     public void testDependentVariableCardinalityTooHighError() {
@@ -317,25 +315,24 @@ private static Map<String, Object> getMlResultsObjectFromDestDoc(Map<String, Obj
         return resultsObject;
     }
 
+    @SuppressWarnings("unchecked")
     private static <T> void assertTopClasses(
             Map<String, Object> resultsObject,
             int numTopClasses,
             String dependentVariable,
-            List<T> dependentVariableValues,
-            Function<String, T> parser) {
+            List<T> dependentVariableValues) {
         assertThat(resultsObject.containsKey("top_classes"), is(true));
-        @SuppressWarnings("unchecked")
         List<Map<String, Object>> topClasses = (List<Map<String, Object>>) resultsObject.get("top_classes");
         assertThat(topClasses, hasSize(numTopClasses));
-        List<String> classNames = new ArrayList<>(topClasses.size());
+        List<T> classNames = new ArrayList<>(topClasses.size());
         List<Double> classProbabilities = new ArrayList<>(topClasses.size());
         for (Map<String, Object> topClass : topClasses) {
             assertThat(topClass, allOf(hasKey("class_name"), hasKey("class_probability")));
-            classNames.add((String) topClass.get("class_name"));
+            classNames.add((T) topClass.get("class_name"));
             classProbabilities.add((Double) topClass.get("class_probability"));
         }
         // Assert that all the predicted class names come from the set of dependent variable values.
-        classNames.forEach(className -> assertThat(parser.apply(className), is(in(dependentVariableValues))));
+        classNames.forEach(className -> assertThat(className, is(in(dependentVariableValues))));
         // Assert that the first class listed in top classes is the same as the predicted class.
         assertThat(classNames.get(0), equalTo(resultsObject.get(dependentVariable + "_prediction")));
         // Assert that all the class probabilities lie within [0, 1] interval.
@@ -344,25 +341,44 @@ private static <T> void assertTopClasses(
         assertThat(Ordering.natural().reverse().isOrdered(classProbabilities), is(true));
     }
 
-    private void assertEvaluation(String dependentVariable, List<String> dependentVariableValues, String predictedClassField) {
+    private <T> void assertEvaluation(String dependentVariable, List<T> dependentVariableValues, String predictedClassField) {
+        List<String> dependentVariableValuesAsStrings = dependentVariableValues.stream().map(String::valueOf).collect(toList());
         EvaluateDataFrameAction.Response evaluateDataFrameResponse =
             evaluateDataFrame(
                 destIndex,
                 new org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Classification(
-                    dependentVariable, predictedClassField, null));
+                    dependentVariable, predictedClassField, Arrays.asList(new Accuracy(), new MulticlassConfusionMatrix())));
         assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
-        assertThat(evaluateDataFrameResponse.getMetrics().size(), equalTo(1));
-        MulticlassConfusionMatrix.Result confusionMatrixResult =
-            (MulticlassConfusionMatrix.Result) evaluateDataFrameResponse.getMetrics().get(0);
-        assertThat(confusionMatrixResult.getMetricName(), equalTo(MulticlassConfusionMatrix.NAME.getPreferredName()));
-        List<ActualClass> actualClasses = confusionMatrixResult.getConfusionMatrix();
-        assertThat(actualClasses.stream().map(ActualClass::getActualClass).collect(toList()), equalTo(dependentVariableValues));
-        for (ActualClass actualClass : actualClasses) {
-            assertThat(actualClass.getOtherPredictedClassDocCount(), equalTo(0L));
+        assertThat(evaluateDataFrameResponse.getMetrics().size(), equalTo(2));
+
+        {   // Accuracy
+            Accuracy.Result accuracyResult = (Accuracy.Result) evaluateDataFrameResponse.getMetrics().get(0);
+            assertThat(accuracyResult.getMetricName(), equalTo(Accuracy.NAME.getPreferredName()));
+            List<Accuracy.ActualClass> actualClasses = accuracyResult.getActualClasses();
+            assertThat(
+                actualClasses.stream().map(Accuracy.ActualClass::getActualClass).collect(toList()),
+                equalTo(dependentVariableValuesAsStrings));
+            actualClasses.forEach(
+                actualClass -> assertThat(actualClass.getAccuracy(), allOf(greaterThanOrEqualTo(0.0), lessThanOrEqualTo(1.0))));
+        }
+
+        {   // MulticlassConfusionMatrix
+            MulticlassConfusionMatrix.Result confusionMatrixResult =
+                (MulticlassConfusionMatrix.Result) evaluateDataFrameResponse.getMetrics().get(1);
+            assertThat(confusionMatrixResult.getMetricName(), equalTo(MulticlassConfusionMatrix.NAME.getPreferredName()));
+            List<MulticlassConfusionMatrix.ActualClass> actualClasses = confusionMatrixResult.getConfusionMatrix();
             assertThat(
-                actualClass.getPredictedClasses().stream().map(PredictedClass::getPredictedClass).collect(toList()),
-                equalTo(dependentVariableValues));
+                actualClasses.stream().map(MulticlassConfusionMatrix.ActualClass::getActualClass).collect(toList()),
+                equalTo(dependentVariableValuesAsStrings));
+            for (MulticlassConfusionMatrix.ActualClass actualClass : actualClasses) {
+                assertThat(actualClass.getOtherPredictedClassDocCount(), equalTo(0L));
+                assertThat(
+                    actualClass.getPredictedClasses().stream()
+                        .map(MulticlassConfusionMatrix.PredictedClass::getPredictedClass)
+                        .collect(toList()),
+                    equalTo(dependentVariableValuesAsStrings));
+            }
+            assertThat(confusionMatrixResult.getOtherActualClassCount(), equalTo(0L));
         }
-        assertThat(confusionMatrixResult.getOtherActualClassCount(), equalTo(0L));
     }
 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractorFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractorFactory.java
index 1c060f178644d..c7d27805c3b4e 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractorFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractorFactory.java
@@ -56,6 +56,10 @@ public DataFrameDataExtractor newExtractor(boolean includeSource) {
         return new DataFrameDataExtractor(client, context);
     }
 
+    public ExtractedFields getExtractedFields() {
+        return extractedFields;
+    }
+
     private QueryBuilder createQuery() {
         BoolQueryBuilder query = QueryBuilders.boolQuery();
         query.filter(sourceQuery);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
index 62184e290374d..a98d2cb40543b 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
@@ -379,14 +379,12 @@ private ExtractedFields fetchBooleanFieldsAsIntegers(ExtractedFields extractedFi
         List<ExtractedField> adjusted = new ArrayList<>(extractedFields.getAllFields().size());
         for (ExtractedField field : extractedFields.getAllFields()) {
             if (isBoolean(field.getTypes())) {
-                if (config.getAnalysis().getAllowedCategoricalTypes(field.getName()).contains(BooleanFieldMapper.CONTENT_TYPE)) {
-                    // We convert boolean field to string if it is a categorical dependent variable
-                    adjusted.add(ExtractedFields.applyBooleanMapping(field, Boolean.TRUE.toString(), Boolean.FALSE.toString()));
-                } else {
-                    // We convert boolean fields to integers with values 0, 1 as this is the preferred
-                    // way to consume such features in the analytics process.
-                    adjusted.add(ExtractedFields.applyBooleanMapping(field, 1, 0));
-                }
+                // We convert boolean fields to integers with values 0, 1 as this is the preferred
+                // way to consume such features in the analytics process regardless of:
+                //  - analysis type
+                //  - whether or not the field is categorical
+                //  - whether or not the field is a dependent variable
+                adjusted.add(ExtractedFields.applyBooleanMapping(field));
             } else {
                 adjusted.add(field);
             }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessConfig.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessConfig.java
index 9a172d158e512..714f63091801f 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessConfig.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessConfig.java
@@ -9,11 +9,15 @@
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.DataFrameAnalysis;
+import org.elasticsearch.xpack.ml.extractor.ExtractedField;
+import org.elasticsearch.xpack.ml.extractor.ExtractedFields;
 
 import java.io.IOException;
 import java.util.Objects;
 import java.util.Set;
 
+import static java.util.stream.Collectors.toMap;
+
 public class AnalyticsProcessConfig implements ToXContentObject {
 
     private static final String JOB_ID = "job_id";
@@ -33,9 +37,10 @@ public class AnalyticsProcessConfig implements ToXContentObject {
     private final String resultsField;
     private final Set<String> categoricalFields;
     private final DataFrameAnalysis analysis;
+    private final ExtractedFields extractedFields;
 
     public AnalyticsProcessConfig(String jobId, long rows, int cols, ByteSizeValue memoryLimit, int threads, String resultsField,
-                                  Set<String> categoricalFields, DataFrameAnalysis analysis) {
+                                  Set<String> categoricalFields, DataFrameAnalysis analysis, ExtractedFields extractedFields) {
         this.jobId = Objects.requireNonNull(jobId);
         this.rows = rows;
         this.cols = cols;
@@ -44,6 +49,7 @@ public AnalyticsProcessConfig(String jobId, long rows, int cols, ByteSizeValue m
         this.resultsField = Objects.requireNonNull(resultsField);
         this.categoricalFields = Objects.requireNonNull(categoricalFields);
         this.analysis = Objects.requireNonNull(analysis);
+        this.extractedFields = Objects.requireNonNull(extractedFields);
     }
 
     public String jobId() {
@@ -68,7 +74,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         builder.field(THREADS, threads);
         builder.field(RESULTS_FIELD, resultsField);
         builder.field(CATEGORICAL_FIELDS, categoricalFields);
-        builder.field(ANALYSIS, new DataFrameAnalysisWrapper(analysis));
+        builder.field(ANALYSIS, new DataFrameAnalysisWrapper(analysis, extractedFields));
         builder.endObject();
         return builder;
     }
@@ -76,16 +82,21 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     private static class DataFrameAnalysisWrapper implements ToXContentObject {
 
         private final DataFrameAnalysis analysis;
+        private final ExtractedFields extractedFields;
 
-        private DataFrameAnalysisWrapper(DataFrameAnalysis analysis) {
+        private DataFrameAnalysisWrapper(DataFrameAnalysis analysis, ExtractedFields extractedFields) {
             this.analysis = analysis;
+            this.extractedFields = extractedFields;
         }
 
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
             builder.startObject();
             builder.field("name", analysis.getWriteableName());
-            builder.field("parameters", analysis.getParams());
+            builder.field(
+                "parameters",
+                analysis.getParams(
+                    extractedFields.getAllFields().stream().collect(toMap(ExtractedField::getName, ExtractedField::getTypes))));
             builder.endObject();
             return builder;
         }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
index ed9d715b5f78c..815d8478a5275 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
@@ -33,6 +33,7 @@
 import org.elasticsearch.xpack.ml.dataframe.process.customprocessing.CustomProcessor;
 import org.elasticsearch.xpack.ml.dataframe.process.customprocessing.CustomProcessorFactory;
 import org.elasticsearch.xpack.ml.dataframe.process.results.AnalyticsResult;
+import org.elasticsearch.xpack.ml.extractor.ExtractedFields;
 import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelProvider;
 import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
 
@@ -373,7 +374,8 @@ synchronized boolean startProcess(DataFrameDataExtractorFactory dataExtractorFac
             }
 
             dataExtractor = dataExtractorFactory.newExtractor(false);
-            AnalyticsProcessConfig analyticsProcessConfig = createProcessConfig(config, dataExtractor);
+            AnalyticsProcessConfig analyticsProcessConfig =
+                createProcessConfig(config, dataExtractor, dataExtractorFactory.getExtractedFields());
             LOGGER.trace("[{}] creating analytics process with config [{}]", config.getId(), Strings.toString(analyticsProcessConfig));
             // If we have no rows, that means there is no data so no point in starting the native process
             // just finish the task
@@ -389,11 +391,20 @@ synchronized boolean startProcess(DataFrameDataExtractorFactory dataExtractorFac
             return true;
         }
 
-        private AnalyticsProcessConfig createProcessConfig(DataFrameAnalyticsConfig config, DataFrameDataExtractor dataExtractor) {
+        private AnalyticsProcessConfig createProcessConfig(
+                DataFrameAnalyticsConfig config, DataFrameDataExtractor dataExtractor, ExtractedFields extractedFields) {
             DataFrameDataExtractor.DataSummary dataSummary = dataExtractor.collectDataSummary();
             Set<String> categoricalFields = dataExtractor.getCategoricalFields(config.getAnalysis());
-            AnalyticsProcessConfig processConfig = new AnalyticsProcessConfig(config.getId(), dataSummary.rows, dataSummary.cols,
-                config.getModelMemoryLimit(), 1, config.getDest().getResultsField(), categoricalFields, config.getAnalysis());
+            AnalyticsProcessConfig processConfig = new AnalyticsProcessConfig(
+                config.getId(),
+                dataSummary.rows,
+                dataSummary.cols,
+                config.getModelMemoryLimit(),
+                1,
+                config.getDest().getResultsField(),
+                categoricalFields,
+                config.getAnalysis(),
+                extractedFields);
             return processConfig;
         }
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/MemoryUsageEstimationProcessManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/MemoryUsageEstimationProcessManager.java
index 6740f8d4d34ca..a6223ec8b8863 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/MemoryUsageEstimationProcessManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/MemoryUsageEstimationProcessManager.java
@@ -79,7 +79,8 @@ private MemoryUsageEstimationResult runJob(String jobId,
                 1,
                 "",
                 categoricalFields,
-                config.getAnalysis());
+                config.getAnalysis(),
+                dataExtractorFactory.getExtractedFields());
         AnalyticsProcess<MemoryUsageEstimationResult> process =
             processFactory.createAnalyticsProcess(
                 config,
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/extractor/ExtractedFields.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/extractor/ExtractedFields.java
index 9fe079b745c10..347d353664dfa 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/extractor/ExtractedFields.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/extractor/ExtractedFields.java
@@ -62,8 +62,8 @@ public static TimeField newTimeField(String name, ExtractedField.Method method)
         return new TimeField(name, method);
     }
 
-    public static <T> ExtractedField applyBooleanMapping(ExtractedField field, T trueValue, T falseValue) {
-        return new BooleanMapper<>(field, trueValue, falseValue);
+    public static ExtractedField applyBooleanMapping(ExtractedField field) {
+        return new BooleanMapper<>(field, 1, 0);
     }
 
     public static class ExtractionMethodDetector {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
index f4f25bcfa0636..9c55b2a9ac956 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
@@ -36,6 +36,7 @@
 import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.hasSize;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
@@ -57,7 +58,7 @@ public void testDetect_GivenFloatField() {
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(1));
+        assertThat(allFields, hasSize(1));
         assertThat(allFields.get(0).getName(), equalTo("some_float"));
         assertThat(allFields.get(0).getMethod(), equalTo(ExtractedField.Method.DOC_VALUE));
 
@@ -75,7 +76,7 @@ public void testDetect_GivenNumericFieldWithMultipleTypes() {
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(1));
+        assertThat(allFields, hasSize(1));
         assertThat(allFields.get(0).getName(), equalTo("some_number"));
         assertThat(allFields.get(0).getMethod(), equalTo(ExtractedField.Method.DOC_VALUE));
 
@@ -121,7 +122,7 @@ public void testDetect_GivenOutlierDetectionAndMultipleFields() {
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(3));
+        assertThat(allFields, hasSize(3));
         assertThat(allFields.stream().map(ExtractedField::getName).collect(Collectors.toSet()),
             containsInAnyOrder("some_float", "some_long", "some_boolean"));
         assertThat(allFields.stream().map(ExtractedField::getMethod).collect(Collectors.toSet()),
@@ -150,7 +151,7 @@ public void testDetect_GivenRegressionAndMultipleFields() {
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(5));
+        assertThat(allFields, hasSize(5));
         assertThat(allFields.stream().map(ExtractedField::getName).collect(Collectors.toList()),
             containsInAnyOrder("foo", "some_float", "some_keyword", "some_long", "some_boolean"));
         assertThat(allFields.stream().map(ExtractedField::getMethod).collect(Collectors.toSet()),
@@ -223,7 +224,7 @@ public void testDetect_GivenFieldIsBothIncludedAndExcluded() {
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(1));
+        assertThat(allFields, hasSize(1));
         assertThat(allFields.stream().map(ExtractedField::getName).collect(Collectors.toList()), contains("bar"));
 
         assertFieldSelectionContains(fieldExtraction.v2(),
@@ -329,7 +330,7 @@ public void testDetect_GivenExcludedFieldIsUnsupported() {
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(1));
+        assertThat(allFields, hasSize(1));
         assertThat(allFields.get(0).getName(), equalTo("numeric"));
 
         assertFieldSelectionContains(fieldExtraction.v2(),
@@ -565,23 +566,24 @@ public void testDetect_GivenMoreFieldsThanDocValuesLimit() {
             contains(equalTo(ExtractedField.Method.SOURCE)));
     }
 
-    public void testDetect_GivenBooleanField_BooleanMappedAsInteger() {
+    private void testDetect_GivenBooleanField(DataFrameAnalyticsConfig config, boolean isRequired, FieldSelection.FeatureType featureType) {
         FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
             .addAggregatableField("some_boolean", "boolean")
+            .addAggregatableField("some_integer", "integer")
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, config, false, 100, fieldCapabilities, config.getAnalysis().getFieldCardinalityLimits());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(1));
+        assertThat(allFields, hasSize(2));
         ExtractedField booleanField = allFields.get(0);
         assertThat(booleanField.getTypes(), contains("boolean"));
         assertThat(booleanField.getMethod(), equalTo(ExtractedField.Method.DOC_VALUE));
 
-        assertFieldSelectionContains(fieldExtraction.v2(),
-            FieldSelection.included("some_boolean", Collections.singleton("boolean"), false, FieldSelection.FeatureType.NUMERICAL)
+        assertFieldSelectionContains(fieldExtraction.v2().subList(0, 1),
+            FieldSelection.included("some_boolean", Collections.singleton("boolean"), isRequired, featureType)
         );
 
         SearchHit hit = new SearchHitBuilder(42).addField("some_boolean", true).build();
@@ -594,34 +596,24 @@ public void testDetect_GivenBooleanField_BooleanMappedAsInteger() {
         assertThat(booleanField.value(hit), arrayContaining(0, 1, 0));
     }
 
-    public void testDetect_GivenBooleanField_BooleanMappedAsString() {
-        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
-            .addAggregatableField("some_boolean", "boolean")
-            .build();
-
-        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildClassificationConfig("some_boolean"), false, 100, fieldCapabilities,
-            Collections.singletonMap("some_boolean", 2L));
-        Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
-
-        List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(1));
-        ExtractedField booleanField = allFields.get(0);
-        assertThat(booleanField.getTypes(), contains("boolean"));
-        assertThat(booleanField.getMethod(), equalTo(ExtractedField.Method.DOC_VALUE));
-
-        assertFieldSelectionContains(fieldExtraction.v2(),
-            FieldSelection.included("some_boolean", Collections.singleton("boolean"), true, FieldSelection.FeatureType.CATEGORICAL)
-        );
+    public void testDetect_GivenBooleanField_OutlierDetection() {
+        // some_boolean is a non-required, numerical feature in outlier detection analysis
+        testDetect_GivenBooleanField(buildOutlierDetectionConfig(), false, FieldSelection.FeatureType.NUMERICAL);
+    }
 
-        SearchHit hit = new SearchHitBuilder(42).addField("some_boolean", true).build();
-        assertThat(booleanField.value(hit), arrayContaining("true"));
+    public void testDetect_GivenBooleanField_Regression() {
+        // some_boolean is a non-required, numerical feature in regression analysis
+        testDetect_GivenBooleanField(buildRegressionConfig("some_integer"), false, FieldSelection.FeatureType.NUMERICAL);
+    }
 
-        hit = new SearchHitBuilder(42).addField("some_boolean", false).build();
-        assertThat(booleanField.value(hit), arrayContaining("false"));
+    public void testDetect_GivenBooleanField_Classification_BooleanIsFeature() {
+        // some_boolean is a non-required, numerical feature in classification analysis
+        testDetect_GivenBooleanField(buildClassificationConfig("some_integer"), false, FieldSelection.FeatureType.NUMERICAL);
+    }
 
-        hit = new SearchHitBuilder(42).addField("some_boolean", Arrays.asList(false, true, false)).build();
-        assertThat(booleanField.value(hit), arrayContaining("false", "true", "false"));
+    public void testDetect_GivenBooleanField_Classification_BooleanIsDependentVariable() {
+        // some_boolean is a required, categorical dependent variable in classification analysis
+        testDetect_GivenBooleanField(buildClassificationConfig("some_boolean"), true, FieldSelection.FeatureType.CATEGORICAL);
     }
 
     public void testDetect_GivenMultiFields() {
@@ -640,7 +632,7 @@ public void testDetect_GivenMultiFields() {
             SOURCE_INDEX, buildRegressionConfig("a_float"), true, 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
-        assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(5));
+        assertThat(fieldExtraction.v1().getAllFields(), hasSize(5));
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
             .collect(Collectors.toList());
         assertThat(extractedFieldNames, contains("a_float", "keyword_1", "text_1.keyword", "text_2.keyword", "text_without_keyword"));
@@ -671,7 +663,7 @@ public void testDetect_GivenMultiFieldAndParentIsRequired() {
             SOURCE_INDEX, buildClassificationConfig("field_1"), true, 100, fieldCapabilities, Collections.singletonMap("field_1", 2L));
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
-        assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(2));
+        assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
             .collect(Collectors.toList());
         assertThat(extractedFieldNames, contains("field_1", "field_2"));
@@ -696,7 +688,7 @@ SOURCE_INDEX, buildClassificationConfig("field_1.keyword"), true, 100, fieldCapa
             Collections.singletonMap("field_1.keyword", 2L));
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
-        assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(2));
+        assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
             .collect(Collectors.toList());
         assertThat(extractedFieldNames, contains("field_1.keyword", "field_2"));
@@ -722,7 +714,7 @@ public void testDetect_GivenSeveralMultiFields_ShouldPickFirstSorted() {
             SOURCE_INDEX, buildRegressionConfig("field_2"), true, 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
-        assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(2));
+        assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
             .collect(Collectors.toList());
         assertThat(extractedFieldNames, contains("field_1.keyword_1", "field_2"));
@@ -748,7 +740,7 @@ public void testDetect_GivenMultiFields_OverDocValueLimit() {
             SOURCE_INDEX, buildRegressionConfig("field_2"), true, 0, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
-        assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(2));
+        assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
             .collect(Collectors.toList());
         assertThat(extractedFieldNames, contains("field_1", "field_2"));
@@ -773,7 +765,7 @@ public void testDetect_GivenParentAndMultiFieldBothAggregatable() {
             SOURCE_INDEX, buildRegressionConfig("field_2.double"), true, 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
-        assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(2));
+        assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
             .collect(Collectors.toList());
         assertThat(extractedFieldNames, contains("field_1", "field_2.double"));
@@ -798,7 +790,7 @@ public void testDetect_GivenParentAndMultiFieldNoneAggregatable() {
             SOURCE_INDEX, buildRegressionConfig("field_2"), true, 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
-        assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(2));
+        assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
             .collect(Collectors.toList());
         assertThat(extractedFieldNames, contains("field_1", "field_2"));
@@ -823,7 +815,7 @@ public void testDetect_GivenMultiFields_AndExplicitlyIncludedFields() {
             SOURCE_INDEX, buildRegressionConfig("field_2"), false, 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
-        assertThat(fieldExtraction.v1().getAllFields().size(), equalTo(2));
+        assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
             .collect(Collectors.toList());
         assertThat(extractedFieldNames, contains("field_1", "field_2"));
@@ -849,7 +841,7 @@ public void testDetect_GivenSourceFilteringWithIncludes() {
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(2));
+        assertThat(allFields, hasSize(2));
         assertThat(allFields.get(0).getName(), equalTo("field_11"));
         assertThat(allFields.get(1).getName(), equalTo("field_12"));
 
@@ -872,7 +864,7 @@ public void testDetect_GivenSourceFilteringWithExcludes() {
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
-        assertThat(allFields.size(), equalTo(2));
+        assertThat(allFields, hasSize(2));
         assertThat(allFields.get(0).getName(), equalTo("field_21"));
         assertThat(allFields.get(1).getName(), equalTo("field_22"));
 
@@ -914,7 +906,7 @@ private DataFrameAnalyticsConfig buildClassificationConfig(String dependentVaria
      * We assert each field individually to get useful error messages in case of failure
      */
     private static void assertFieldSelectionContains(List<FieldSelection> actual, FieldSelection... expected) {
-        assertThat(actual.size(), equalTo(expected.length));
+        assertThat(actual, hasSize(expected.length));
         for (int i = 0; i < expected.length; i++) {
             assertThat("i = " + i, actual.get(i).getName(), equalTo(expected[i].getName()));
             assertThat("i = " + i, actual.get(i).getMappingTypes(), equalTo(expected[i].getMappingTypes()));
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManagerTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManagerTests.java
index d86f0397319bb..4a0d5fa7f36df 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManagerTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManagerTests.java
@@ -18,6 +18,7 @@
 import org.elasticsearch.xpack.ml.dataframe.extractor.DataFrameDataExtractor;
 import org.elasticsearch.xpack.ml.dataframe.extractor.DataFrameDataExtractorFactory;
 import org.elasticsearch.xpack.ml.dataframe.process.results.AnalyticsResult;
+import org.elasticsearch.xpack.ml.extractor.ExtractedFields;
 import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelProvider;
 import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
 import org.junit.Before;
@@ -95,6 +96,7 @@ public void setUpMocks() {
         when(dataExtractor.collectDataSummary()).thenReturn(new DataFrameDataExtractor.DataSummary(NUM_ROWS, NUM_COLS));
         dataExtractorFactory = mock(DataFrameDataExtractorFactory.class);
         when(dataExtractorFactory.newExtractor(anyBoolean())).thenReturn(dataExtractor);
+        when(dataExtractorFactory.getExtractedFields()).thenReturn(mock(ExtractedFields.class));
         finishHandler = mock(Consumer.class);
 
         exceptionCaptor = ArgumentCaptor.forClass(Exception.class);
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
index b1a2ba226b49f..15bd32da3c320 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask.ProgressTracker;
 import org.elasticsearch.xpack.ml.dataframe.process.results.AnalyticsResult;
 import org.elasticsearch.xpack.ml.dataframe.process.results.RowResults;
+import org.elasticsearch.xpack.ml.extractor.ExtractedFields;
 import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelProvider;
 import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
 import org.junit.Before;
@@ -219,7 +220,8 @@ private void givenProcessResults(List<AnalyticsResult> results) {
 
     private void givenDataFrameRows(int rows) {
         AnalyticsProcessConfig config = new AnalyticsProcessConfig(
-            "job_id", rows, 1, ByteSizeValue.ZERO, 1, "ml", Collections.emptySet(), mock(DataFrameAnalysis.class));
+            "job_id", rows, 1, ByteSizeValue.ZERO, 1, "ml", Collections.emptySet(), mock(DataFrameAnalysis.class),
+            mock(ExtractedFields.class));
         when(process.getConfig()).thenReturn(config);
     }
 
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/MemoryUsageEstimationProcessManagerTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/MemoryUsageEstimationProcessManagerTests.java
index 5dc015d86e715..b2898667d036e 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/MemoryUsageEstimationProcessManagerTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/MemoryUsageEstimationProcessManagerTests.java
@@ -18,6 +18,7 @@
 import org.elasticsearch.xpack.ml.dataframe.extractor.DataFrameDataExtractor;
 import org.elasticsearch.xpack.ml.dataframe.extractor.DataFrameDataExtractorFactory;
 import org.elasticsearch.xpack.ml.dataframe.process.results.MemoryUsageEstimationResult;
+import org.elasticsearch.xpack.ml.extractor.ExtractedFields;
 import org.junit.Before;
 import org.mockito.ArgumentCaptor;
 import org.mockito.InOrder;
@@ -70,6 +71,7 @@ public void setUpMocks() {
         when(dataExtractor.collectDataSummary()).thenReturn(new DataFrameDataExtractor.DataSummary(NUM_ROWS, NUM_COLS));
         dataExtractorFactory = mock(DataFrameDataExtractorFactory.class);
         when(dataExtractorFactory.newExtractor(anyBoolean())).thenReturn(dataExtractor);
+        when(dataExtractorFactory.getExtractedFields()).thenReturn(mock(ExtractedFields.class));
         dataFrameAnalyticsConfig = DataFrameAnalyticsConfigTests.createRandom(CONFIG_ID);
         listener = mock(ActionListener.class);
         resultCaptor = ArgumentCaptor.forClass(MemoryUsageEstimationResult.class);
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/extractor/ExtractedFieldsTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/extractor/ExtractedFieldsTests.java
index 9613d14fb5f00..5ac983e7d505b 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/extractor/ExtractedFieldsTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/extractor/ExtractedFieldsTests.java
@@ -101,7 +101,7 @@ public void testBuildGivenMultiFields() {
     public void testApplyBooleanMapping() {
         DocValueField aBool = new DocValueField("a_bool", Collections.singleton("boolean"));
 
-        ExtractedField mapped = ExtractedFields.applyBooleanMapping(aBool, 1, 0);
+        ExtractedField mapped = ExtractedFields.applyBooleanMapping(aBool);
 
         SearchHit hitTrue = new SearchHitBuilder(42).addField("a_bool", true).build();
         SearchHit hitFalse = new SearchHitBuilder(42).addField("a_bool", false).build();

From dde9e5980d3d3eb9dedab8117f5945ab146dbfbb Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Mon, 9 Dec 2019 07:28:08 -0500
Subject: [PATCH 119/686] [ML][Inference] adjust so target_field always has
 inference result and optionally allow new top classes field in the
 classification config (#49923)

---
 .../ClassificationInferenceResults.java       | 14 +++---
 .../inference/results/InferenceResults.java   |  3 +-
 .../results/RawInferenceResults.java          |  3 +-
 .../results/RegressionInferenceResults.java   |  3 +-
 .../trainedmodel/ClassificationConfig.java    | 24 ++++++++--
 .../ClassificationInferenceResultsTests.java  | 11 +++--
 .../RegressionInferenceResultsTests.java      |  3 +-
 .../ClassificationConfigTests.java            | 15 ++++---
 .../ml/integration/InferenceIngestIT.java     | 16 +------
 .../inference/ingest/InferenceProcessor.java  | 10 ++---
 .../ingest/InferenceProcessorTests.java       | 44 ++++++++++++++++---
 .../integration/ModelInferenceActionIT.java   |  6 +--
 12 files changed, 102 insertions(+), 50 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
index 662585bedf51d..4df54e3fa9eca 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
@@ -12,6 +12,8 @@
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.ingest.IngestDocument;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.io.IOException;
@@ -90,13 +92,15 @@ public String valueAsString() {
     }
 
     @Override
-    public void writeResult(IngestDocument document, String resultField) {
+    public void writeResult(IngestDocument document, String resultField, InferenceConfig config) {
+        assert config instanceof ClassificationConfig;
+        ClassificationConfig classificationConfig = (ClassificationConfig)config;
         ExceptionsHelper.requireNonNull(document, "document");
         ExceptionsHelper.requireNonNull(resultField, "resultField");
-        if (topClasses.isEmpty()) {
-            document.setFieldValue(resultField, valueAsString());
-        } else {
-            document.setFieldValue(resultField, topClasses.stream().map(TopClassEntry::asValueMap).collect(Collectors.toList()));
+        document.setFieldValue(resultField, valueAsString());
+        if (topClasses.isEmpty() == false) {
+            document.setFieldValue(classificationConfig.getTopClassesResultsField(),
+                topClasses.stream().map(TopClassEntry::asValueMap).collect(Collectors.toList()));
         }
     }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/InferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/InferenceResults.java
index 00744f6982f46..357fdcda386df 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/InferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/InferenceResults.java
@@ -7,10 +7,11 @@
 
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.ingest.IngestDocument;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
 import org.elasticsearch.xpack.core.ml.utils.NamedXContentObject;
 
 public interface InferenceResults extends NamedXContentObject, NamedWriteable {
 
-    void writeResult(IngestDocument document, String resultField);
+    void writeResult(IngestDocument document, String resultField, InferenceConfig config);
 
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RawInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RawInferenceResults.java
index 884d66032b564..bb72483fe4878 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RawInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RawInferenceResults.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.ingest.IngestDocument;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
 
 import java.io.IOException;
 import java.util.Objects;
@@ -49,7 +50,7 @@ public int hashCode() {
     }
 
     @Override
-    public void writeResult(IngestDocument document, String resultField) {
+    public void writeResult(IngestDocument document, String resultField, InferenceConfig config) {
         throw new UnsupportedOperationException("[raw] does not support writing inference results");
     }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResults.java
index e186489b91dab..0fb931cd4a251 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResults.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.ingest.IngestDocument;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.io.IOException;
@@ -50,7 +51,7 @@ public int hashCode() {
     }
 
     @Override
-    public void writeResult(IngestDocument document, String resultField) {
+    public void writeResult(IngestDocument document, String resultField, InferenceConfig config) {
         ExceptionsHelper.requireNonNull(document, "document");
         ExceptionsHelper.requireNonNull(resultField, "resultField");
         document.setFieldValue(resultField, value());
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfig.java
index f7da41eda7bd6..3923ef9313190 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfig.java
@@ -21,37 +21,52 @@ public class ClassificationConfig implements InferenceConfig {
 
     public static final String NAME = "classification";
 
+    public static final String DEFAULT_TOP_CLASSES_RESULT_FIELD = "top_classes";
     public static final ParseField  NUM_TOP_CLASSES = new ParseField("num_top_classes");
+    public static final ParseField  TOP_CLASSES_RESULT_FIELD = new ParseField("top_classes_result_field");
     private static final Version MIN_SUPPORTED_VERSION = Version.V_7_6_0;
 
-    public static ClassificationConfig EMPTY_PARAMS = new ClassificationConfig(0);
+    public static ClassificationConfig EMPTY_PARAMS = new ClassificationConfig(0, DEFAULT_TOP_CLASSES_RESULT_FIELD);
 
     private final int numTopClasses;
+    private final String topClassesResultsField;
 
     public static ClassificationConfig fromMap(Map<String, Object> map) {
         Map<String, Object> options = new HashMap<>(map);
         Integer numTopClasses = (Integer)options.remove(NUM_TOP_CLASSES.getPreferredName());
+        String topClassesResultsField = (String)options.remove(TOP_CLASSES_RESULT_FIELD.getPreferredName());
         if (options.isEmpty() == false) {
             throw ExceptionsHelper.badRequestException("Unrecognized fields {}.", options.keySet());
         }
-        return new ClassificationConfig(numTopClasses);
+        return new ClassificationConfig(numTopClasses, topClassesResultsField);
     }
 
     public ClassificationConfig(Integer numTopClasses) {
+        this(numTopClasses, null);
+    }
+
+    public ClassificationConfig(Integer numTopClasses, String topClassesResultsField) {
         this.numTopClasses = numTopClasses == null ? 0 : numTopClasses;
+        this.topClassesResultsField = topClassesResultsField == null ? DEFAULT_TOP_CLASSES_RESULT_FIELD : topClassesResultsField;
     }
 
     public ClassificationConfig(StreamInput in) throws IOException {
         this.numTopClasses = in.readInt();
+        this.topClassesResultsField = in.readString();
     }
 
     public int getNumTopClasses() {
         return numTopClasses;
     }
 
+    public String getTopClassesResultsField() {
+        return topClassesResultsField;
+    }
+
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeInt(numTopClasses);
+        out.writeString(topClassesResultsField);
     }
 
     @Override
@@ -59,12 +74,12 @@ public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
         ClassificationConfig that = (ClassificationConfig) o;
-        return Objects.equals(numTopClasses, that.numTopClasses);
+        return Objects.equals(numTopClasses, that.numTopClasses) && Objects.equals(topClassesResultsField, that.topClassesResultsField);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(numTopClasses);
+        return Objects.hash(numTopClasses, topClassesResultsField);
     }
 
     @Override
@@ -73,6 +88,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (numTopClasses != 0) {
             builder.field(NUM_TOP_CLASSES.getPreferredName(), numTopClasses);
         }
+        builder.field(TOP_CLASSES_RESULT_FIELD.getPreferredName(), topClassesResultsField);
         builder.endObject();
         return builder;
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResultsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResultsTests.java
index ba90fece02f2a..cc37e253806b0 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResultsTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResultsTests.java
@@ -8,6 +8,7 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.ingest.IngestDocument;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
 
 import java.util.Arrays;
 import java.util.Collections;
@@ -37,7 +38,7 @@ private static ClassificationInferenceResults.TopClassEntry createRandomClassEnt
     public void testWriteResultsWithClassificationLabel() {
         ClassificationInferenceResults result = new ClassificationInferenceResults(1.0, "foo", Collections.emptyList());
         IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
-        result.writeResult(document, "result_field");
+        result.writeResult(document, "result_field", ClassificationConfig.EMPTY_PARAMS);
 
         assertThat(document.getFieldValue("result_field", String.class), equalTo("foo"));
     }
@@ -45,7 +46,7 @@ public void testWriteResultsWithClassificationLabel() {
     public void testWriteResultsWithoutClassificationLabel() {
         ClassificationInferenceResults result = new ClassificationInferenceResults(1.0, null, Collections.emptyList());
         IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
-        result.writeResult(document, "result_field");
+        result.writeResult(document, "result_field", ClassificationConfig.EMPTY_PARAMS);
 
         assertThat(document.getFieldValue("result_field", String.class), equalTo("1.0"));
     }
@@ -60,15 +61,17 @@ public void testWriteResultsWithTopClasses() {
             "foo",
             entries);
         IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
-        result.writeResult(document, "result_field");
+        result.writeResult(document, "result_field", new ClassificationConfig(3, "bar"));
 
-        List<?> list = document.getFieldValue("result_field", List.class);
+        List<?> list = document.getFieldValue("bar", List.class);
         assertThat(list.size(), equalTo(3));
 
         for(int i = 0; i < 3; i++) {
             Map<String, Object> map = (Map<String, Object>)list.get(i);
             assertThat(map, equalTo(entries.get(i).asValueMap()));
         }
+
+        assertThat(document.getFieldValue("result_field", String.class), equalTo("foo"));
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResultsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResultsTests.java
index 4f2d5926c84dc..5c26fea0c06f5 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResultsTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResultsTests.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.ingest.IngestDocument;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.inference.results.RegressionInferenceResults;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
 
 import java.util.HashMap;
 
@@ -24,7 +25,7 @@ public static RegressionInferenceResults createRandomResults() {
     public void testWriteResults() {
         RegressionInferenceResults result = new RegressionInferenceResults(0.3);
         IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
-        result.writeResult(document, "result_field");
+        result.writeResult(document, "result_field", new RegressionConfig());
 
         assertThat(document.getFieldValue("result_field", Double.class), equalTo(0.3));
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfigTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfigTests.java
index 808aaf960f4e1..aff29d9bf8b74 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfigTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfigTests.java
@@ -10,22 +10,27 @@
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
 
 import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
 
 import static org.hamcrest.Matchers.equalTo;
 
 public class ClassificationConfigTests extends AbstractWireSerializingTestCase<ClassificationConfig> {
 
     public static ClassificationConfig randomClassificationConfig() {
-        return new ClassificationConfig(randomBoolean() ? null : randomIntBetween(-1, 10));
+        return new ClassificationConfig(randomBoolean() ? null : randomIntBetween(-1, 10),
+            randomBoolean() ? null : randomAlphaOfLength(10));
     }
 
     public void testFromMap() {
-        ClassificationConfig expected = new ClassificationConfig(0);
+        ClassificationConfig expected = ClassificationConfig.EMPTY_PARAMS;
         assertThat(ClassificationConfig.fromMap(Collections.emptyMap()), equalTo(expected));
 
-        expected = new ClassificationConfig(3);
-        assertThat(ClassificationConfig.fromMap(Collections.singletonMap(ClassificationConfig.NUM_TOP_CLASSES.getPreferredName(), 3)),
-            equalTo(expected));
+        expected = new ClassificationConfig(3, "foo");
+        Map<String, Object> configMap = new HashMap<>();
+        configMap.put(ClassificationConfig.NUM_TOP_CLASSES.getPreferredName(), 3);
+        configMap.put(ClassificationConfig.TOP_CLASSES_RESULT_FIELD.getPreferredName(), "foo");
+        assertThat(ClassificationConfig.fromMap(configMap), equalTo(expected));
     }
 
     public void testFromMapWithUnknownField() {
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
index c28c0a275d43c..315010282a4f4 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
@@ -147,20 +147,8 @@ public void testSimulate() {
             "      {\n" +
             "        \"inference\": {\n" +
             "          \"target_field\": \"result_class\",\n" +
-            "          \"inference_config\": {\"classification\":{}},\n" +
-            "          \"model_id\": \"test_classification\",\n" +
-            "          \"field_mappings\": {\n" +
-            "            \"col1\": \"col1\",\n" +
-            "            \"col2\": \"col2\",\n" +
-            "            \"col3\": \"col3\",\n" +
-            "            \"col4\": \"col4\"\n" +
-            "          }\n" +
-            "        }\n" +
-            "      },\n" +
-            "      {\n" +
-            "        \"inference\": {\n" +
-            "          \"target_field\": \"result_class_prob\",\n" +
-            "          \"inference_config\": {\"classification\": {\"num_top_classes\":2}},\n" +
+            "          \"inference_config\": {\"classification\": " +
+            "                {\"num_top_classes\":2, \"top_classes_result_field\": \"result_class_prob\"}},\n" +
             "          \"model_id\": \"test_classification\",\n" +
             "          \"field_mappings\": {\n" +
             "            \"col1\": \"col1\",\n" +
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
index a39588fbcfe58..0450cd4aa966b 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
@@ -35,7 +35,6 @@
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 import org.elasticsearch.xpack.ml.notifications.InferenceAuditor;
 
-import java.io.IOException;
 import java.util.Arrays;
 import java.util.HashMap;
 import java.util.Map;
@@ -154,7 +153,7 @@ void mutateDocument(InternalInferModelAction.Response response, IngestDocument i
         if (response.getInferenceResults().isEmpty()) {
             throw new ElasticsearchStatusException("Unexpected empty inference response", RestStatus.INTERNAL_SERVER_ERROR);
         }
-        response.getInferenceResults().get(0).writeResult(ingestDocument, this.targetField);
+        response.getInferenceResults().get(0).writeResult(ingestDocument, this.targetField, inferenceConfig);
         if (includeModelMetadata) {
             ingestDocument.setFieldValue(modelInfoField + "." + MODEL_ID, modelId);
         }
@@ -227,8 +226,7 @@ int numInferenceProcessors() {
         }
 
         @Override
-        public InferenceProcessor create(Map<String, Processor.Factory> processorFactories, String tag, Map<String, Object> config)
-            throws Exception {
+        public InferenceProcessor create(Map<String, Processor.Factory> processorFactories, String tag, Map<String, Object> config) {
 
             if (this.maxIngestProcessors <= currentInferenceProcessors) {
                 throw new ElasticsearchStatusException("Max number of inference processors reached, total inference processors [{}]. " +
@@ -267,7 +265,7 @@ void setMaxIngestProcessors(int maxIngestProcessors) {
             this.maxIngestProcessors = maxIngestProcessors;
         }
 
-        InferenceConfig inferenceConfigFromMap(Map<String, Object> inferenceConfig) throws IOException {
+        InferenceConfig inferenceConfigFromMap(Map<String, Object> inferenceConfig) {
             ExceptionsHelper.requireNonNull(inferenceConfig, INFERENCE_CONFIG);
 
             if (inferenceConfig.size() != 1) {
@@ -284,7 +282,7 @@ InferenceConfig inferenceConfigFromMap(Map<String, Object> inferenceConfig) thro
             Map<String, Object> valueMap = (Map<String, Object>)value;
 
             if (inferenceConfig.containsKey(ClassificationConfig.NAME)) {
-                checkSupportedVersion(new ClassificationConfig(0));
+                checkSupportedVersion(ClassificationConfig.EMPTY_PARAMS);
                 return ClassificationConfig.fromMap(valueMap);
             } else if (inferenceConfig.containsKey(RegressionConfig.NAME)) {
                 checkSupportedVersion(new RegressionConfig());
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
index fc8bbbb684aeb..b9132d5e2534f 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
@@ -51,7 +51,7 @@ public void testMutateDocumentWithClassification() {
             "my_processor",
             targetField,
             "classification_model",
-            new ClassificationConfig(0),
+            ClassificationConfig.EMPTY_PARAMS,
             Collections.emptyMap(),
             "ml.my_processor",
             true);
@@ -78,7 +78,7 @@ public void testMutateDocumentClassificationTopNClasses() {
             "my_processor",
             targetField,
             "classification_model",
-            new ClassificationConfig(2),
+            new ClassificationConfig(2, null),
             Collections.emptyMap(),
             "ml.my_processor",
             true);
@@ -96,10 +96,44 @@ public void testMutateDocumentClassificationTopNClasses() {
             true);
         inferenceProcessor.mutateDocument(response, document);
 
-        assertThat((List<Map<?,?>>)document.getFieldValue(targetField, List.class),
+        assertThat((List<Map<?,?>>)document.getFieldValue(ClassificationConfig.DEFAULT_TOP_CLASSES_RESULT_FIELD, List.class),
             contains(classes.stream().map(ClassificationInferenceResults.TopClassEntry::asValueMap).toArray(Map[]::new)));
         assertThat(document.getFieldValue("ml", Map.class),
             equalTo(Collections.singletonMap("my_processor", Collections.singletonMap("model_id", "classification_model"))));
+        assertThat(document.getFieldValue(targetField, String.class), equalTo("foo"));
+    }
+
+    @SuppressWarnings("unchecked")
+    public void testMutateDocumentClassificationTopNClassesWithSpecificField() {
+        String targetField = "classification_value_probabilities";
+        InferenceProcessor inferenceProcessor = new InferenceProcessor(client,
+            auditor,
+            "my_processor",
+            targetField,
+            "classification_model",
+            new ClassificationConfig(2, "my_top_classes"),
+            Collections.emptyMap(),
+            "ml.my_processor",
+            true);
+
+        Map<String, Object> source = new HashMap<>();
+        Map<String, Object> ingestMetadata = new HashMap<>();
+        IngestDocument document = new IngestDocument(source, ingestMetadata);
+
+        List<ClassificationInferenceResults.TopClassEntry> classes = new ArrayList<>(2);
+        classes.add(new ClassificationInferenceResults.TopClassEntry("foo", 0.6));
+        classes.add(new ClassificationInferenceResults.TopClassEntry("bar", 0.4));
+
+        InternalInferModelAction.Response response = new InternalInferModelAction.Response(
+            Collections.singletonList(new ClassificationInferenceResults(1.0, "foo", classes)),
+            true);
+        inferenceProcessor.mutateDocument(response, document);
+
+        assertThat((List<Map<?,?>>)document.getFieldValue("my_top_classes", List.class),
+            contains(classes.stream().map(ClassificationInferenceResults.TopClassEntry::asValueMap).toArray(Map[]::new)));
+        assertThat(document.getFieldValue("ml", Map.class),
+            equalTo(Collections.singletonMap("my_processor", Collections.singletonMap("model_id", "classification_model"))));
+        assertThat(document.getFieldValue(targetField, String.class), equalTo("foo"));
     }
 
     public void testMutateDocumentRegression() {
@@ -194,7 +228,7 @@ public void testGenerateRequestWithEmptyMapping() {
             "my_processor",
             "my_field",
             modelId,
-            new ClassificationConfig(topNClasses),
+            new ClassificationConfig(topNClasses, null),
             Collections.emptyMap(),
             "ml.my_processor",
             false);
@@ -225,7 +259,7 @@ public void testGenerateWithMapping() {
             "my_processor",
             "my_field",
             modelId,
-            new ClassificationConfig(topNClasses),
+            new ClassificationConfig(topNClasses, null),
             fieldMapping,
             "ml.my_processor",
             false);
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
index dee5253f5046c..66327d31c8178 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
@@ -131,7 +131,7 @@ public void testInferModels() throws Exception {
 
 
         // Test classification
-        request = new InternalInferModelAction.Request(modelId2, toInfer, new ClassificationConfig(0), true);
+        request = new InternalInferModelAction.Request(modelId2, toInfer, ClassificationConfig.EMPTY_PARAMS, true);
         response = client().execute(InternalInferModelAction.INSTANCE, request).actionGet();
         assertThat(response.getInferenceResults()
                 .stream()
@@ -140,7 +140,7 @@ public void testInferModels() throws Exception {
             contains("not_to_be", "to_be"));
 
         // Get top classes
-        request = new InternalInferModelAction.Request(modelId2, toInfer, new ClassificationConfig(2), true);
+        request = new InternalInferModelAction.Request(modelId2, toInfer, new ClassificationConfig(2, null), true);
         response = client().execute(InternalInferModelAction.INSTANCE, request).actionGet();
 
         ClassificationInferenceResults classificationInferenceResults =
@@ -159,7 +159,7 @@ public void testInferModels() throws Exception {
             greaterThan(classificationInferenceResults.getTopClasses().get(1).getProbability()));
 
         // Test that top classes restrict the number returned
-        request = new InternalInferModelAction.Request(modelId2, toInfer2, new ClassificationConfig(1), true);
+        request = new InternalInferModelAction.Request(modelId2, toInfer2, new ClassificationConfig(1, null), true);
         response = client().execute(InternalInferModelAction.INSTANCE, request).actionGet();
 
         classificationInferenceResults = (ClassificationInferenceResults)response.getInferenceResults().get(0);

From 64b50443cb8cc39f0424e109f1c92a7d453791f2 Mon Sep 17 00:00:00 2001
From: Vishnu Chilamakuru <vishnu.chilamakuru@gmail.com>
Date: Mon, 9 Dec 2019 19:09:05 +0530
Subject: [PATCH 120/686] Add Validation for maxQueryTerms to be greater than 0
 for MoreLikeThisQuery (#49966)

Adds validation for maxQueryTerms to be greater than 0 for MoreLikeThisQuery
and MoreLikeThisQueryBuilder.

Closes #49927
---
 .../common/lucene/search/MoreLikeThisQuery.java      |  3 +++
 .../index/query/MoreLikeThisQueryBuilder.java        |  3 +++
 .../search/morelikethis/MoreLikeThisQueryTests.java  | 12 ++++++++++++
 .../index/query/MoreLikeThisQueryBuilderTests.java   | 12 +++++++++++-
 4 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/common/lucene/search/MoreLikeThisQuery.java b/server/src/main/java/org/elasticsearch/common/lucene/search/MoreLikeThisQuery.java
index 394b8bbe65d38..23764a18a3e1c 100644
--- a/server/src/main/java/org/elasticsearch/common/lucene/search/MoreLikeThisQuery.java
+++ b/server/src/main/java/org/elasticsearch/common/lucene/search/MoreLikeThisQuery.java
@@ -308,6 +308,9 @@ public int getMaxQueryTerms() {
     }
 
     public void setMaxQueryTerms(int maxQueryTerms) {
+        if (maxQueryTerms <= 0) {
+            throw new IllegalArgumentException("requires 'maxQueryTerms' to be greater than 0");
+        }
         this.maxQueryTerms = maxQueryTerms;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/query/MoreLikeThisQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/MoreLikeThisQueryBuilder.java
index 597d81215c3a3..4e94b9e6327a7 100644
--- a/server/src/main/java/org/elasticsearch/index/query/MoreLikeThisQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/MoreLikeThisQueryBuilder.java
@@ -577,6 +577,9 @@ public Item[] unlikeItems() {
      * Defaults to {@code 25}.
      */
     public MoreLikeThisQueryBuilder maxQueryTerms(int maxQueryTerms) {
+        if (maxQueryTerms <= 0) {
+            throw new IllegalArgumentException("requires 'maxQueryTerms' to be greater than 0");
+        }
         this.maxQueryTerms = maxQueryTerms;
         return this;
     }
diff --git a/server/src/test/java/org/elasticsearch/common/lucene/search/morelikethis/MoreLikeThisQueryTests.java b/server/src/test/java/org/elasticsearch/common/lucene/search/morelikethis/MoreLikeThisQueryTests.java
index fb09ceb839c37..337c61243baa3 100644
--- a/server/src/test/java/org/elasticsearch/common/lucene/search/morelikethis/MoreLikeThisQueryTests.java
+++ b/server/src/test/java/org/elasticsearch/common/lucene/search/morelikethis/MoreLikeThisQueryTests.java
@@ -33,6 +33,7 @@
 import org.elasticsearch.common.lucene.search.MoreLikeThisQuery;
 import org.elasticsearch.test.ESTestCase;
 
+import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 
 public class MoreLikeThisQueryTests extends ESTestCase {
@@ -64,4 +65,15 @@ public void testSimple() throws Exception {
         reader.close();
         indexWriter.close();
     }
+
+    public void testValidateMaxQueryTerms() {
+        IllegalArgumentException e1 = expectThrows(IllegalArgumentException.class,
+            () ->  new MoreLikeThisQuery("lucene", new String[]{"text"}, Lucene.STANDARD_ANALYZER).setMaxQueryTerms(0));
+        assertThat(e1.getMessage(), containsString("requires 'maxQueryTerms' to be greater than 0"));
+
+        IllegalArgumentException e2 = expectThrows(IllegalArgumentException.class,
+            () -> new MoreLikeThisQuery("lucene", new String[]{"text"}, Lucene.STANDARD_ANALYZER).setMaxQueryTerms(-3));
+        assertThat(e2.getMessage(), containsString("requires 'maxQueryTerms' to be greater than 0"));
+    }
+
 }
diff --git a/server/src/test/java/org/elasticsearch/index/query/MoreLikeThisQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/MoreLikeThisQueryBuilderTests.java
index 8099f9243466f..8a9ced02fb920 100644
--- a/server/src/test/java/org/elasticsearch/index/query/MoreLikeThisQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/MoreLikeThisQueryBuilderTests.java
@@ -163,7 +163,7 @@ protected MoreLikeThisQueryBuilder doCreateTestQueryBuilder() {
             queryBuilder.unlike(randomUnlikeItems);
         }
         if (randomBoolean()) {
-            queryBuilder.maxQueryTerms(randomInt(25));
+            queryBuilder.maxQueryTerms(randomIntBetween(1, 25));
         }
         if (randomBoolean()) {
             queryBuilder.minTermFreq(randomInt(5));
@@ -340,6 +340,16 @@ public void testMoreLikeThisBuilder() throws Exception {
         assertThat(mltQuery.getMaxQueryTerms(), equalTo(12));
     }
 
+    public void testValidateMaxQueryTerms() {
+        IllegalArgumentException e1 = expectThrows(IllegalArgumentException.class,
+            () -> new MoreLikeThisQueryBuilder(new String[]{"name.first", "name.last"}, new String[]{"something"}, null).maxQueryTerms(0));
+        assertThat(e1.getMessage(), containsString("requires 'maxQueryTerms' to be greater than 0"));
+
+        IllegalArgumentException e2 = expectThrows(IllegalArgumentException.class,
+            () -> new MoreLikeThisQueryBuilder(new String[]{"name.first", "name.last"}, new String[]{"something"}, null).maxQueryTerms(-3));
+        assertThat(e2.getMessage(), containsString("requires 'maxQueryTerms' to be greater than 0"));
+    }
+
     public void testItemSerialization() throws IOException {
         Item expectedItem = generateRandomItem();
         BytesStreamOutput output = new BytesStreamOutput();

From fbe676acbcefd40f855e9965cd43120a407abd33 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 9 Dec 2019 08:39:17 -0500
Subject: [PATCH 121/686] [DOCS] Correct inline shape snippets in shape query
 docs (#49921)

In the shape query docs, the index mapping snippet uses the "geometry"
shape field mapping. However, the doc index snippet uses the "location"
property.

This changes the "location" property to "geometry". It also adds a
comment containing the search result snippet. This should prevent
similar issues in the future.
---
 docs/reference/query-dsl/shape-query.asciidoc | 45 ++++++++++++++++++-
 1 file changed, 43 insertions(+), 2 deletions(-)

diff --git a/docs/reference/query-dsl/shape-query.asciidoc b/docs/reference/query-dsl/shape-query.asciidoc
index 6a1c7380976f2..a9850c3bf6814 100644
--- a/docs/reference/query-dsl/shape-query.asciidoc
+++ b/docs/reference/query-dsl/shape-query.asciidoc
@@ -37,10 +37,10 @@ PUT /example
     }
 }
 
-POST /example/_doc?refresh
+PUT /example/_doc/1?refresh=wait_for
 {
     "name": "Lucky Landing",
-    "location": {
+    "geometry": {
         "type": "point",
         "coordinates": [1355.400544, 5255.530286]
     }
@@ -69,6 +69,47 @@ GET /example/_search
 }
 --------------------------------------------------
 
+////
+[source,console-result]
+--------------------------------------------------
+{
+  "took": 3,
+  "timed_out": false,
+  "_shards": {
+    "total": 1,
+    "successful": 1,
+    "skipped": 0,
+    "failed": 0
+  },
+  "hits": {
+    "total": {
+      "value": 1,
+      "relation": "eq"
+    },
+    "max_score": 0.0,
+    "hits": [
+      {
+        "_index": "example",
+        "_id": "1",
+        "_score": 0.0,
+        "_source": {
+          "name": "Lucky Landing",
+          "geometry": {
+            "type": "point",
+            "coordinates": [
+              1355.400544,
+              5255.530286
+            ]
+          }
+        }
+      }
+    ]
+  }
+}
+--------------------------------------------------
+// TESTRESPONSE[s/"took": 3/"took": $body.took/]
+////
+
 ==== Pre-Indexed Shape
 
 The Query also supports using a shape which has already been indexed in

From b9f5fa15fb7da6d7da24a6ead67fbd2adf5795da Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Mon, 9 Dec 2019 08:50:27 -0500
Subject: [PATCH 122/686] [ML] Use query in cardinality check (#49939)

When checking the cardinality of a field, the query should be take into account. The user might know about some bad data in their index and want to filter down to the target_field values they care about.
---
 .../ml/integration/ClassificationIT.java      | 25 ++++++++++++++++++-
 ...NativeDataFrameAnalyticsIntegTestCase.java | 12 +++++++--
 .../ExtractedFieldsDetectorFactory.java       |  2 +-
 3 files changed, 35 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 1d3f6bf4f2e75..f5db9ae690a96 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -15,6 +15,8 @@
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.WriteRequest;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
@@ -228,7 +230,7 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableI
         assertEvaluation(BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES, "ml.boolean-field_prediction");
     }
 
-    public void testDependentVariableCardinalityTooHighError() {
+    public void testDependentVariableCardinalityTooHighError() throws Exception {
         initialize("cardinality_too_high");
         indexData(sourceIndex, 6, 5, KEYWORD_FIELD);
         // Index one more document with a class different than the two already used.
@@ -246,6 +248,27 @@ public void testDependentVariableCardinalityTooHighError() {
         assertThat(e.getMessage(), equalTo("Field [keyword-field] must have at most [2] distinct values but there were at least [3]"));
     }
 
+    public void testDependentVariableCardinalityTooHighButWithQueryMakesItWithinRange() throws Exception {
+        initialize("cardinality_too_high_with_query");
+        indexData(sourceIndex, 6, 5, KEYWORD_FIELD);
+        // Index one more document with a class different than the two already used.
+        client().execute(IndexAction.INSTANCE, new IndexRequest(sourceIndex)
+            .source(KEYWORD_FIELD, "fox")
+            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE))
+            .actionGet();
+        QueryBuilder query = QueryBuilders.boolQuery().filter(QueryBuilders.termsQuery(KEYWORD_FIELD, KEYWORD_FIELD_VALUES));
+
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(KEYWORD_FIELD), query);
+        registerAnalytics(config);
+        putAnalytics(config);
+
+        // Should not throw
+        startAnalytics(jobId);
+        waitUntilAnalyticsIsStopped(jobId);
+
+        assertProgress(jobId, 100, 100, 100, 100);
+    }
+
     private void initialize(String jobId) {
         this.jobId = jobId;
         this.sourceIndex = jobId + "_source_index";
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
index 0b9e2c19961d8..29ef54d3f7524 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
@@ -16,6 +16,7 @@
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.xpack.core.ml.action.DeleteDataFrameAnalyticsAction;
@@ -37,6 +38,7 @@
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.elasticsearch.xpack.core.ml.notifications.AuditorField;
 import org.elasticsearch.xpack.core.ml.utils.PhaseProgress;
+import org.elasticsearch.xpack.core.ml.utils.QueryProvider;
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask;
 import org.hamcrest.Matcher;
 import org.hamcrest.Matchers;
@@ -161,10 +163,16 @@ protected EvaluateDataFrameAction.Response evaluateDataFrame(String index, Evalu
     }
 
     protected static DataFrameAnalyticsConfig buildAnalytics(String id, String sourceIndex, String destIndex,
-                                                             @Nullable String resultsField, DataFrameAnalysis analysis) {
+                                                             @Nullable String resultsField, DataFrameAnalysis analysis) throws Exception {
+        return buildAnalytics(id, sourceIndex, destIndex, resultsField, analysis, QueryBuilders.matchAllQuery());
+    }
+
+    protected static DataFrameAnalyticsConfig buildAnalytics(String id, String sourceIndex, String destIndex,
+                                                             @Nullable String resultsField, DataFrameAnalysis analysis,
+                                                             QueryBuilder queryBuilder) throws Exception {
         return new DataFrameAnalyticsConfig.Builder()
             .setId(id)
-            .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex }, null, null))
+            .setSource(new DataFrameAnalyticsSource(new String[] { sourceIndex }, QueryProvider.fromParsedQuery(queryBuilder), null))
             .setDest(new DataFrameAnalyticsDest(destIndex, resultsField))
             .setAnalysis(analysis)
             .build();
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
index ea37bdf393aeb..8e6ad7a614b09 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
@@ -109,7 +109,7 @@ private void getCardinalitiesForFieldsWithLimit(String[] index, DataFrameAnalyti
             listener::onFailure
         );
 
-        SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder().size(0);
+        SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder().size(0).query(config.getSource().getParsedQuery());
         for (Map.Entry<String, Long> entry : fieldCardinalityLimits.entrySet()) {
             String fieldName = entry.getKey();
             Long limit = entry.getValue();

From 79befab477aa3b9500ebfc998d5be0db5b2b64a1 Mon Sep 17 00:00:00 2001
From: Marios Trivyzas <matriv@gmail.com>
Date: Mon, 9 Dec 2019 15:34:23 +0100
Subject: [PATCH 123/686] SQL: [Tests] Unmute Pivot from NodeSublassTests
 (#49925)

The `testReplaceChildren()` has been fixed for Pivot as part
of #49693.

Reverting: #49045
---
 .../elasticsearch/xpack/sql/tree/NodeSubclassTests.java    | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeSubclassTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeSubclassTests.java
index f27c65fbc7c56..d3a4870c24857 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeSubclassTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeSubclassTests.java
@@ -28,19 +28,17 @@
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
 import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
 import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Iif;
 import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfConditional;
 import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfNull;
+import org.elasticsearch.xpack.sql.expression.predicate.conditional.Iif;
 import org.elasticsearch.xpack.sql.expression.predicate.fulltext.FullTextPredicate;
 import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.In;
 import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.InPipe;
 import org.elasticsearch.xpack.sql.expression.predicate.regex.Like;
 import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
-import org.elasticsearch.xpack.sql.plan.logical.Pivot;
 import org.elasticsearch.xpack.sql.tree.NodeTests.ChildrenAreAProperty;
 import org.elasticsearch.xpack.sql.tree.NodeTests.Dummy;
 import org.elasticsearch.xpack.sql.tree.NodeTests.NoChildren;
-import org.junit.Assume;
 import org.mockito.exceptions.base.MockitoException;
 
 import java.io.IOException;
@@ -166,9 +164,6 @@ public void testTransform() throws Exception {
      * Test {@link Node#replaceChildren} implementation on {@link #subclass}.
      */
     public void testReplaceChildren() throws Exception {
-        // TODO: Provide a proper fix for: https://github.com/elastic/elasticsearch/issues/48900
-        Assume.assumeFalse(subclass.equals(Pivot.class));
-
         Constructor<T> ctor = longestCtor(subclass);
         Object[] nodeCtorArgs = ctorArgs(ctor);
         T node = ctor.newInstance(nodeCtorArgs);

From e716e61cbde963d678c66b25a8ce59facf447b82 Mon Sep 17 00:00:00 2001
From: sabi0 <2sabio@gmail.com>
Date: Mon, 9 Dec 2019 16:16:45 +0100
Subject: [PATCH 124/686] [DOCS] Fix description typo and correct
 capitalization for IngestGeoIpPlugin docs (#49241)

---
 modules/ingest-geoip/build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/modules/ingest-geoip/build.gradle b/modules/ingest-geoip/build.gradle
index 6b49c26c41570..ce9dc7d574c12 100644
--- a/modules/ingest-geoip/build.gradle
+++ b/modules/ingest-geoip/build.gradle
@@ -20,7 +20,7 @@
 import org.apache.tools.ant.taskdefs.condition.Os
 
 esplugin {
-  description 'Ingest processor that uses looksup geo data based on ip adresses using the Maxmind geo database'
+  description 'Ingest processor that uses lookup geo data based on IP adresses using the MaxMind geo database'
   classname 'org.elasticsearch.ingest.geoip.IngestGeoIpPlugin'
 }
 

From 5aeff9357cb6e5c870a0afcff0083ddadb876de7 Mon Sep 17 00:00:00 2001
From: Artur Carvalho <arturbelico@gmail.com>
Date: Mon, 9 Dec 2019 16:24:03 +0100
Subject: [PATCH 125/686] [Docs] Fix typo in getting-started.asciidoc (#49985)

---
 docs/reference/getting-started.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/getting-started.asciidoc b/docs/reference/getting-started.asciidoc
index ad67dcc0e6eb8..3de052001cbee 100755
--- a/docs/reference/getting-started.asciidoc
+++ b/docs/reference/getting-started.asciidoc
@@ -283,7 +283,7 @@ If you have a lot of documents to index, you can submit them in batches with
 the {ref}/docs-bulk.html[bulk API]. Using bulk to batch document
 operations is significantly faster than submitting requests individually as it minimizes network roundtrips. 
 
-The optimal batch size depends a number of factors: the document size and complexity, the indexing and search load, and the resources available to your cluster. A good place to start is with batches of 1,000 to 5,000 documents
+The optimal batch size depends on a number of factors: the document size and complexity, the indexing and search load, and the resources available to your cluster. A good place to start is with batches of 1,000 to 5,000 documents
 and a total payload between 5MB and 15MB. From there, you can experiment
 to find the sweet spot.
 

From b69e1d6a97163c96fa46f116240cb320828a3c58 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 9 Dec 2019 11:04:20 -0500
Subject: [PATCH 126/686] [DOCS] Correct `for in` example in Painless docs
 (#49991)

Adds a needed `def` keyword to the `for in` example in the Painless docs.
---
 docs/painless/painless-lang-spec/painless-statements.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/painless/painless-lang-spec/painless-statements.asciidoc b/docs/painless/painless-lang-spec/painless-statements.asciidoc
index b9aceed9cf097..ece2686838149 100644
--- a/docs/painless/painless-lang-spec/painless-statements.asciidoc
+++ b/docs/painless/painless-lang-spec/painless-statements.asciidoc
@@ -25,7 +25,7 @@ Painless also supports the `for in` syntax from Groovy:
 
 [source,painless]
 ---------------------------------------------------------
-for (item : list) {
+for (def item : list) {
   ...
 }
 ---------------------------------------------------------

From a29fe9579465736bbb1a3066244e33ada8cd205e Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Mon, 9 Dec 2019 12:39:26 -0500
Subject: [PATCH 127/686] Enable dependent settings values to be validated
 (#49942)

Today settings can declare dependencies on another setting. This
declaration is implemented so that if the declared setting is not set
when the declaring setting is, settings validation fails. Yet, in some
cases we want not only that the setting is set, but that it also has a
specific value. For example, with the monitoring exporter settings, if
xpack.monitoring.exporters.my_exporter.host is set, we not only want
that xpack.monitoring.exporters.my_exporter.type is set, but that it is
also set to local. This commit extends the settings infrastructure so
that this declaration is possible. The use of this in the monitoring
exporter settings will be implemented in a follow-up.
---
 .../azure/AzureStorageSettings.java           | 21 +++---
 .../settings/AbstractScopedSettings.java      | 12 ++--
 .../common/settings/Setting.java              | 65 ++++++++++++++++---
 .../transport/RemoteClusterService.java       |  6 +-
 .../transport/SniffConnectionStrategy.java    |  2 +-
 .../common/settings/ScopedSettingsTests.java  | 55 ++++++++++++++--
 .../indices/settings/UpdateSettingsIT.java    |  4 +-
 .../core/security/authc/RealmSettings.java    |  4 +-
 8 files changed, 137 insertions(+), 32 deletions(-)

diff --git a/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureStorageSettings.java b/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureStorageSettings.java
index 5162f1a223699..380eef87c4172 100644
--- a/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureStorageSettings.java
+++ b/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureStorageSettings.java
@@ -62,29 +62,34 @@ final class AzureStorageSettings {
     public static final AffixSetting<Integer> MAX_RETRIES_SETTING =
         Setting.affixKeySetting(AZURE_CLIENT_PREFIX_KEY, "max_retries",
             (key) -> Setting.intSetting(key, RetryPolicy.DEFAULT_CLIENT_RETRY_COUNT, Setting.Property.NodeScope),
-            ACCOUNT_SETTING, KEY_SETTING);
+            () -> ACCOUNT_SETTING, () -> KEY_SETTING);
     /**
      * Azure endpoint suffix. Default to core.windows.net (CloudStorageAccount.DEFAULT_DNS).
      */
     public static final AffixSetting<String> ENDPOINT_SUFFIX_SETTING = Setting.affixKeySetting(AZURE_CLIENT_PREFIX_KEY, "endpoint_suffix",
-        key -> Setting.simpleString(key, Property.NodeScope), ACCOUNT_SETTING, KEY_SETTING);
+        key -> Setting.simpleString(key, Property.NodeScope), () -> ACCOUNT_SETTING, () -> KEY_SETTING);
 
     public static final AffixSetting<TimeValue> TIMEOUT_SETTING = Setting.affixKeySetting(AZURE_CLIENT_PREFIX_KEY, "timeout",
-        (key) -> Setting.timeSetting(key, TimeValue.timeValueMinutes(-1), Property.NodeScope), ACCOUNT_SETTING, KEY_SETTING);
+        (key) -> Setting.timeSetting(key, TimeValue.timeValueMinutes(-1), Property.NodeScope), () -> ACCOUNT_SETTING, () -> KEY_SETTING);
 
     /** The type of the proxy to connect to azure through. Can be direct (no proxy, default), http or socks */
     public static final AffixSetting<Proxy.Type> PROXY_TYPE_SETTING = Setting.affixKeySetting(AZURE_CLIENT_PREFIX_KEY, "proxy.type",
         (key) -> new Setting<>(key, "direct", s -> Proxy.Type.valueOf(s.toUpperCase(Locale.ROOT)), Property.NodeScope)
-        , ACCOUNT_SETTING, KEY_SETTING);
+        , () -> ACCOUNT_SETTING, () -> KEY_SETTING);
 
     /** The host name of a proxy to connect to azure through. */
     public static final AffixSetting<String> PROXY_HOST_SETTING = Setting.affixKeySetting(AZURE_CLIENT_PREFIX_KEY, "proxy.host",
-        (key) -> Setting.simpleString(key, Property.NodeScope), KEY_SETTING, ACCOUNT_SETTING, PROXY_TYPE_SETTING);
+        (key) -> Setting.simpleString(key, Property.NodeScope), () -> KEY_SETTING, () -> ACCOUNT_SETTING, () -> PROXY_TYPE_SETTING);
 
     /** The port of a proxy to connect to azure through. */
-    public static final Setting<Integer> PROXY_PORT_SETTING = Setting.affixKeySetting(AZURE_CLIENT_PREFIX_KEY, "proxy.port",
-        (key) -> Setting.intSetting(key, 0, 0, 65535, Setting.Property.NodeScope), ACCOUNT_SETTING, KEY_SETTING, PROXY_TYPE_SETTING,
-        PROXY_HOST_SETTING);
+    public static final Setting<Integer> PROXY_PORT_SETTING = Setting.affixKeySetting(
+        AZURE_CLIENT_PREFIX_KEY,
+        "proxy.port",
+        (key) -> Setting.intSetting(key, 0, 0, 65535, Setting.Property.NodeScope),
+        () -> ACCOUNT_SETTING,
+        () -> KEY_SETTING,
+        () -> PROXY_TYPE_SETTING,
+        () -> PROXY_HOST_SETTING);
 
     private final String account;
     private final String connectString;
diff --git a/server/src/main/java/org/elasticsearch/common/settings/AbstractScopedSettings.java b/server/src/main/java/org/elasticsearch/common/settings/AbstractScopedSettings.java
index 1cbdc29bb1654..81b3b92844d6b 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/AbstractScopedSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/AbstractScopedSettings.java
@@ -530,20 +530,24 @@ void validate(
             }
             throw new IllegalArgumentException(msg);
         } else  {
-            Set<Setting<?>> settingsDependencies = setting.getSettingsDependencies(key);
+            Set<Setting.SettingDependency> settingsDependencies = setting.getSettingsDependencies(key);
             if (setting.hasComplexMatcher()) {
                 setting = setting.getConcreteSetting(key);
             }
             if (validateDependencies && settingsDependencies.isEmpty() == false) {
-                for (final Setting<?> settingDependency : settingsDependencies) {
-                    if (settingDependency.existsOrFallbackExists(settings) == false) {
+                for (final Setting.SettingDependency settingDependency : settingsDependencies) {
+                    final Setting<?> dependency = settingDependency.getSetting();
+                    // validate the dependent setting is set
+                    if (dependency.existsOrFallbackExists(settings) == false) {
                         final String message = String.format(
                                 Locale.ROOT,
                                 "missing required setting [%s] for setting [%s]",
-                                settingDependency.getKey(),
+                                dependency.getKey(),
                                 setting.getKey());
                         throw new IllegalArgumentException(message);
                     }
+                    // validate the dependent setting value
+                    settingDependency.validate(setting.getKey(), setting.get(settings), dependency.get(settings));
                 }
             }
             // the only time that validateInternalOrPrivateIndex should be true is if this call is coming via the update settings API
diff --git a/server/src/main/java/org/elasticsearch/common/settings/Setting.java b/server/src/main/java/org/elasticsearch/common/settings/Setting.java
index 2e6bfdc635cd2..bbfe56ffcda97 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/Setting.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/Setting.java
@@ -564,11 +564,37 @@ public Setting<T> getConcreteSetting(String key) {
         return this;
     }
 
+    /**
+     * Allows a setting to declare a dependency on another setting being set. Optionally, a setting can validate the value of the dependent
+     * setting.
+     */
+    public interface SettingDependency {
+
+        /**
+         * The setting to declare a dependency on.
+         *
+         * @return the setting
+         */
+        Setting getSetting();
+
+        /**
+         * Validates the dependent setting value.
+         *
+         * @param key        the key for this setting
+         * @param value      the value of this setting
+         * @param dependency the value of the dependent setting
+         */
+        default void validate(String key, Object value, Object dependency) {
+
+        }
+
+    }
+
     /**
      * Returns a set of settings that are required at validation time. Unless all of the dependencies are present in the settings
      * object validation of setting must fail.
      */
-    public Set<Setting<?>> getSettingsDependencies(String key) {
+    public Set<SettingDependency> getSettingsDependencies(final String key) {
         return Collections.emptySet();
     }
 
@@ -671,13 +697,23 @@ public String toString() {
         };
     }
 
+    /**
+     * Allows an affix setting to declare a dependency on another affix setting.
+     */
+    public interface AffixSettingDependency extends SettingDependency {
+
+        @Override
+        AffixSetting getSetting();
+
+    }
+
     public static class AffixSetting<T> extends Setting<T> {
         private final AffixKey key;
         private final BiFunction<String, String, Setting<T>> delegateFactory;
-        private final Set<AffixSetting> dependencies;
+        private final Set<AffixSettingDependency> dependencies;
 
         public AffixSetting(AffixKey key, Setting<T> delegate, BiFunction<String, String, Setting<T>> delegateFactory,
-                            AffixSetting... dependencies) {
+                            AffixSettingDependency... dependencies) {
             super(key, delegate.defaultValue, delegate.parser, delegate.properties.toArray(new Property[0]));
             this.key = key;
             this.delegateFactory = delegateFactory;
@@ -693,12 +729,25 @@ private Stream<String> matchStream(Settings settings) {
         }
 
         @Override
-        public Set<Setting<?>> getSettingsDependencies(String settingsKey) {
+        public Set<SettingDependency> getSettingsDependencies(String settingsKey) {
             if (dependencies.isEmpty()) {
                 return Collections.emptySet();
             } else {
                 String namespace = key.getNamespace(settingsKey);
-                return dependencies.stream().map(s -> (Setting<?>)s.getConcreteSettingForNamespace(namespace)).collect(Collectors.toSet());
+                return dependencies.stream()
+                    .map(s ->
+                        new SettingDependency() {
+                            @Override
+                            public Setting<Object> getSetting() {
+                                return s.getSetting().getConcreteSettingForNamespace(namespace);
+                            }
+
+                            @Override
+                            public void validate(final String key, final Object value, final Object dependency) {
+                                s.validate(key, value, dependency);
+                            };
+                        })
+                    .collect(Collectors.toSet());
             }
         }
 
@@ -1635,19 +1684,19 @@ public static <T> AffixSetting<T> prefixKeySetting(String prefix, Function<Strin
      * out of the box unless {@link #getConcreteSetting(String)} is used to pull the updater.
      */
     public static <T> AffixSetting<T> affixKeySetting(String prefix, String suffix, Function<String, Setting<T>> delegateFactory,
-                                                      AffixSetting... dependencies) {
+                                                      AffixSettingDependency... dependencies) {
         BiFunction<String, String, Setting<T>> delegateFactoryWithNamespace = (ns, k) -> delegateFactory.apply(k);
         return affixKeySetting(new AffixKey(prefix, suffix), delegateFactoryWithNamespace, dependencies);
     }
 
     public static <T> AffixSetting<T> affixKeySetting(String prefix, String suffix, BiFunction<String, String, Setting<T>> delegateFactory,
-                                                      AffixSetting... dependencies) {
+                                                      AffixSettingDependency... dependencies) {
         Setting<T> delegate = delegateFactory.apply("_na_", "_na_");
         return new AffixSetting<>(new AffixKey(prefix, suffix), delegate, delegateFactory, dependencies);
     }
 
     private static <T> AffixSetting<T> affixKeySetting(AffixKey key, BiFunction<String, String, Setting<T>> delegateFactory,
-                                                       AffixSetting... dependencies) {
+                                                       AffixSettingDependency... dependencies) {
         Setting<T> delegate = delegateFactory.apply("_na_", "_na_");
         return new AffixSetting<>(key, delegate, delegateFactory, dependencies);
     }
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteClusterService.java b/server/src/main/java/org/elasticsearch/transport/RemoteClusterService.java
index f398100049a8f..779d4deacd45a 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteClusterService.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteClusterService.java
@@ -100,19 +100,19 @@ public final class RemoteClusterService extends RemoteClusterAware implements Cl
                 false,
                 Setting.Property.Dynamic,
                 Setting.Property.NodeScope),
-            SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS);
+            () -> SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS);
 
     public static final Setting.AffixSetting<TimeValue> REMOTE_CLUSTER_PING_SCHEDULE = Setting.affixKeySetting(
         "cluster.remote.",
         "transport.ping_schedule",
         key -> timeSetting(key, TransportSettings.PING_SCHEDULE, Setting.Property.Dynamic, Setting.Property.NodeScope),
-        SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS);
+        () -> SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS);
 
     public static final Setting.AffixSetting<Boolean> REMOTE_CLUSTER_COMPRESS = Setting.affixKeySetting(
         "cluster.remote.",
         "transport.compress",
         key -> boolSetting(key, TransportSettings.TRANSPORT_COMPRESS, Setting.Property.Dynamic, Setting.Property.NodeScope),
-        SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS);
+        () -> SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS);
 
     private final TransportService transportService;
     private final Map<String, RemoteClusterConnection> remoteClusters = ConcurrentCollections.newConcurrentMap();
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index 9ec0f4afe9997..cfed1d01c47e3 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -116,7 +116,7 @@ public class SniffConnectionStrategy extends RemoteConnectionStrategy {
             }),
             Setting.Property.Dynamic,
             Setting.Property.NodeScope),
-        REMOTE_CLUSTER_SEEDS);
+        () -> REMOTE_CLUSTER_SEEDS);
 
     /**
      * The maximum number of connections that will be established to a remote cluster. For instance if there is only a single
diff --git a/server/src/test/java/org/elasticsearch/common/settings/ScopedSettingsTests.java b/server/src/test/java/org/elasticsearch/common/settings/ScopedSettingsTests.java
index 6c0f6b0751a65..f653ddd59b7f8 100644
--- a/server/src/test/java/org/elasticsearch/common/settings/ScopedSettingsTests.java
+++ b/server/src/test/java/org/elasticsearch/common/settings/ScopedSettingsTests.java
@@ -179,9 +179,9 @@ public void testDependentSettings() {
         Setting.AffixSetting<String> stringSetting = Setting.affixKeySetting("foo.", "name",
             (k) -> Setting.simpleString(k, Property.Dynamic, Property.NodeScope));
         Setting.AffixSetting<Integer> intSetting = Setting.affixKeySetting("foo.", "bar",
-            (k) ->  Setting.intSetting(k, 1, Property.Dynamic, Property.NodeScope), stringSetting);
+            (k) ->  Setting.intSetting(k, 1, Property.Dynamic, Property.NodeScope), () -> stringSetting);
 
-        AbstractScopedSettings service = new ClusterSettings(Settings.EMPTY,new HashSet<>(Arrays.asList(intSetting, stringSetting)));
+        AbstractScopedSettings service = new ClusterSettings(Settings.EMPTY, new HashSet<>(Arrays.asList(intSetting, stringSetting)));
 
         IllegalArgumentException iae = expectThrows(IllegalArgumentException.class,
             () -> service.validate(Settings.builder().put("foo.test.bar", 7).build(), true));
@@ -195,6 +195,50 @@ public void testDependentSettings() {
         service.validate(Settings.builder().put("foo.test.bar", 7).build(), false);
     }
 
+    public void testDependentSettingsValidate() {
+        Setting.AffixSetting<String> stringSetting = Setting.affixKeySetting(
+            "foo.",
+            "name",
+            (k) -> Setting.simpleString(k, Property.Dynamic, Property.NodeScope));
+        Setting.AffixSetting<Integer> intSetting = Setting.affixKeySetting(
+            "foo.",
+            "bar",
+            (k) -> Setting.intSetting(k, 1, Property.Dynamic, Property.NodeScope),
+            new Setting.AffixSettingDependency() {
+
+                @Override
+                public Setting.AffixSetting getSetting() {
+                    return stringSetting;
+                }
+
+                @Override
+                public void validate(final String key, final Object value, final Object dependency) {
+                    if ("valid".equals(dependency) == false) {
+                        throw new SettingsException("[" + key + "] is set but [name] is [" + dependency + "]");
+                    }
+                }
+            });
+
+        AbstractScopedSettings service = new ClusterSettings(Settings.EMPTY, new HashSet<>(Arrays.asList(intSetting, stringSetting)));
+
+        SettingsException iae = expectThrows(
+            SettingsException.class,
+            () -> service.validate(Settings.builder().put("foo.test.bar", 7).put("foo.test.name", "invalid").build(), true));
+        assertEquals("[foo.test.bar] is set but [name] is [invalid]", iae.getMessage());
+
+        service.validate(Settings.builder()
+                .put("foo.test.bar", 7)
+                .put("foo.test.name", "valid")
+                .build(),
+            true);
+
+        service.validate(Settings.builder()
+            .put("foo.test.bar", 7)
+            .put("foo.test.name", "invalid")
+            .build(),
+            false);
+    }
+
     public void testDependentSettingsWithFallback() {
         Setting.AffixSetting<String> nameFallbackSetting =
                 Setting.affixKeySetting("fallback.", "name", k -> Setting.simpleString(k, Property.Dynamic, Property.NodeScope));
@@ -208,8 +252,11 @@ public void testDependentSettingsWithFallback() {
                                 : nameFallbackSetting.getConcreteSetting(k.replaceAll("^foo", "fallback")),
                         Property.Dynamic,
                         Property.NodeScope));
-        Setting.AffixSetting<Integer> barSetting =
-                Setting.affixKeySetting("foo.", "bar", k -> Setting.intSetting(k, 1, Property.Dynamic, Property.NodeScope), nameSetting);
+        Setting.AffixSetting<Integer> barSetting = Setting.affixKeySetting(
+            "foo.",
+            "bar",
+            k -> Setting.intSetting(k, 1, Property.Dynamic, Property.NodeScope),
+            () -> nameSetting);
 
         final AbstractScopedSettings service =
                 new ClusterSettings(Settings.EMPTY,new HashSet<>(Arrays.asList(nameFallbackSetting, nameSetting, barSetting)));
diff --git a/server/src/test/java/org/elasticsearch/indices/settings/UpdateSettingsIT.java b/server/src/test/java/org/elasticsearch/indices/settings/UpdateSettingsIT.java
index e897c33ffd569..3d063ac3690bb 100644
--- a/server/src/test/java/org/elasticsearch/indices/settings/UpdateSettingsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/settings/UpdateSettingsIT.java
@@ -93,12 +93,12 @@ public static class DummySettingPlugin extends Plugin {
         public static final Setting.AffixSetting<String> DUMMY_ACCOUNT_USER = Setting.affixKeySetting("index.acc.", "user",
             k -> Setting.simpleString(k, Setting.Property.IndexScope, Setting.Property.Dynamic));
         public static final Setting<String> DUMMY_ACCOUNT_PW = Setting.affixKeySetting("index.acc.", "pw",
-            k -> Setting.simpleString(k, Setting.Property.IndexScope, Setting.Property.Dynamic), DUMMY_ACCOUNT_USER);
+            k -> Setting.simpleString(k, Setting.Property.IndexScope, Setting.Property.Dynamic), () -> DUMMY_ACCOUNT_USER);
 
         public static final Setting.AffixSetting<String> DUMMY_ACCOUNT_USER_CLUSTER = Setting.affixKeySetting("cluster.acc.", "user",
             k -> Setting.simpleString(k, Setting.Property.NodeScope, Setting.Property.Dynamic));
         public static final Setting<String> DUMMY_ACCOUNT_PW_CLUSTER = Setting.affixKeySetting("cluster.acc.", "pw",
-            k -> Setting.simpleString(k, Setting.Property.NodeScope, Setting.Property.Dynamic), DUMMY_ACCOUNT_USER_CLUSTER);
+            k -> Setting.simpleString(k, Setting.Property.NodeScope, Setting.Property.Dynamic), () -> DUMMY_ACCOUNT_USER_CLUSTER);
 
         @Override
         public void onIndexModule(IndexModule indexModule) {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/RealmSettings.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/RealmSettings.java
index fda2cf614c8bd..8b4b7fa8848b2 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/RealmSettings.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/RealmSettings.java
@@ -20,7 +20,7 @@
 
 /**
  * Provides a number of utility methods for interacting with {@link Settings} and {@link Setting} inside a {@link Realm}.
- * Settings for realms use an {@link Setting#affixKeySetting(String, String, Function, Setting.AffixSetting[]) affix} style,
+ * Settings for realms use an {@link Setting#affixKeySetting(String, String, Function, Setting.AffixSettingDependency[]) affix} style,
  * where the <em>type</em> of the realm is part of the prefix, and name of the realm is the variable portion
  * (That is to set the order in a file realm named "file1", then full setting key would be
  * {@code xpack.security.authc.realms.file.file1.order}.
@@ -74,7 +74,7 @@ public static Setting.AffixSetting<SecureString> secureString(String realmType,
      * The {@code Function} takes the <em>realm-type</em> as an argument.
      * @param suffix The suffix of the setting (everything following the realm name in the affix setting)
      * @param delegateFactory A factory to produce the concrete setting.
-     *                       See {@link Setting#affixKeySetting(String, String, Function, Setting.AffixSetting[])}
+     *                       See {@link Setting#affixKeySetting(String, String, Function, Setting.AffixSettingDependency[])}
      */
     public static <T> Function<String, Setting.AffixSetting<T>> affixSetting(String suffix, Function<String, Setting<T>> delegateFactory) {
         return realmType -> Setting.affixKeySetting(realmSettingPrefix(realmType), suffix, delegateFactory);

From 64bfd27d6874a0ea611a95f28b8f3d3b156cbafb Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Mon, 9 Dec 2019 09:57:29 -0800
Subject: [PATCH 128/686] Remove leftover debug log message (#49957)

This was leftover from debugging #49204.
---
 .../src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy b/buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy
index 85e58cf5ff3c7..05ea77720e123 100644
--- a/buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy
+++ b/buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy
@@ -257,7 +257,6 @@ class BuildPlugin implements Plugin<Project> {
                 rootProject.gradle.taskGraph.whenReady { TaskExecutionGraph taskGraph ->
                     List<String> messages = []
                     Map<Integer, List<Task>> requiredJavaVersions = (Map<Integer, List<Task>>) extraProperties.get('requiredJavaVersions')
-                    task.logger.warn(requiredJavaVersions.toString())
                     for (Map.Entry<Integer, List<Task>> entry : requiredJavaVersions) {
                         if (BuildParams.javaVersions.any { it.version == entry.key }) {
                             continue

From 0033ac104c3a5390dc821747ee0c05277142329a Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Mon, 9 Dec 2019 09:58:44 -0800
Subject: [PATCH 129/686] Make testclusters registry extension name unique
 (#49956)

The testclusters registory is a singleton extension element added to the
root project which tracks which test clusters are used throughout the
multi project. But having the same name as the extension used to
configure test clusters within each subprojects breaks using a single
project for an external plugin. This commit renames the registry
extension to make it unique.

closes #49787
---
 .../gradle/testclusters/TestClustersPlugin.java              | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersPlugin.java
index da10235a9d9a2..a96f8913e8208 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersPlugin.java
@@ -38,6 +38,7 @@ public class TestClustersPlugin implements Plugin<Project> {
 
     private static final String LIST_TASK_NAME = "listTestClusters";
     public static final String EXTENSION_NAME = "testClusters";
+    private static final String REGISTRY_EXTENSION_NAME = "testClustersRegistry";
 
     private static final Logger logger =  Logging.getLogger(TestClustersPlugin.class);
 
@@ -56,9 +57,9 @@ public void apply(Project project) {
         // provide a task to be able to list defined clusters.
         createListClustersTask(project, container);
 
-        if (project.getRootProject().getExtensions().findByName("testClusters") == null) {
+        if (project.getRootProject().getExtensions().findByName(REGISTRY_EXTENSION_NAME) == null) {
             TestClustersRegistry registry = project.getRootProject().getExtensions()
-                .create("testClusters", TestClustersRegistry.class);
+                .create(REGISTRY_EXTENSION_NAME, TestClustersRegistry.class);
 
             // When we know what tasks will run, we claim the clusters of those task to differentiate between clusters
             // that are defined in the build script and the ones that will actually be used in this invocation of gradle

From 2c353ff81b75c98d23c85c2e05b44445f5868692 Mon Sep 17 00:00:00 2001
From: shiwenjie12 <656336863@qq.com>
Date: Tue, 10 Dec 2019 02:02:55 +0800
Subject: [PATCH 130/686] Modify notes (#48331)

Modify notes
---
 .../action/search/SearchExecutionStatsCollector.java            | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/action/search/SearchExecutionStatsCollector.java b/server/src/main/java/org/elasticsearch/action/search/SearchExecutionStatsCollector.java
index 0ffad5aa4065b..b284a2204a767 100644
--- a/server/src/main/java/org/elasticsearch/action/search/SearchExecutionStatsCollector.java
+++ b/server/src/main/java/org/elasticsearch/action/search/SearchExecutionStatsCollector.java
@@ -31,7 +31,7 @@
 /**
  * A wrapper of search action listeners (search results) that unwraps the query
  * result to get the piggybacked queue size and service time EWMA, adding those
- * values to the coordinating nodes' {@code ResponseCollectorService}.
+ * values to the coordinating nodes' {@link ResponseCollectorService}.
  */
 public final class SearchExecutionStatsCollector implements ActionListener<SearchPhaseResult> {
 

From 0fe731787bf5a6eb2686f9a902ce6fffad8b25f2 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 9 Dec 2019 13:16:16 -0500
Subject: [PATCH 131/686] [DOCS] Skip synced flush docs tests (#49986)

The current snippets in the synced flush docs can cause conflicts with
other background syncs, such as the global checkpoint sync or retention
lease sync, in the docs tests.

This skips tests for those snippets to avoid conflicts.
---
 docs/reference/indices/synced-flush.asciidoc | 26 +++++++++-----------
 1 file changed, 11 insertions(+), 15 deletions(-)

diff --git a/docs/reference/indices/synced-flush.asciidoc b/docs/reference/indices/synced-flush.asciidoc
index 99c5dd4beeadd..cb2c40793091a 100644
--- a/docs/reference/indices/synced-flush.asciidoc
+++ b/docs/reference/indices/synced-flush.asciidoc
@@ -10,7 +10,7 @@ Performs a synced flush on one or more indices.
 --------------------------------------------------
 POST /twitter/_flush/synced
 --------------------------------------------------
-// TEST[setup:twitter]
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
 
 
 [[synced-flush-api-request]]
@@ -80,7 +80,7 @@ section of the shard stats returned by the <<indices-stats,indices stats>> API:
 --------------------------------------------------
 GET /twitter/_stats?filter_path=**.commit&level=shards <1>
 --------------------------------------------------
-// TEST[s/^/PUT twitter\nPOST twitter\/_flush\/synced\n/]
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
 
 <1> `filter_path` is used to reduce the verbosity of the response, but is entirely optional
 
@@ -116,10 +116,7 @@ The API returns the following response:
    }
 }
 --------------------------------------------------
-// TESTRESPONSE[s/"id" : "3M3zkw2GHMo2Y4h4\/KFKCg=="/"id": $body.indices.twitter.shards.0.0.commit.id/]
-// TESTRESPONSE[s/"translog_uuid" : "hnOG3xFcTDeoI_kvvvOdNA"/"translog_uuid": $body.indices.twitter.shards.0.0.commit.user_data.translog_uuid/]
-// TESTRESPONSE[s/"history_uuid" : "XP7KDJGiS1a2fHYiFL5TXQ"/"history_uuid": $body.indices.twitter.shards.0.0.commit.user_data.history_uuid/]
-// TESTRESPONSE[s/"sync_id" : "AVvFY-071siAOuFGEO9P"/"sync_id": $body.indices.twitter.shards.0.0.commit.user_data.sync_id/]
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
 <1> the `sync id` marker
 
 NOTE: The `sync_id` marker is removed as soon as the shard is flushed again, and
@@ -172,7 +169,7 @@ A replica shard failed to sync-flush.
 ----
 POST /kimchy/_flush/synced
 ----
-// TEST[s/^/PUT kimchy\n/]
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
 
 
 [[synced-flush-api-multi-ex]]
@@ -182,8 +179,7 @@ POST /kimchy/_flush/synced
 --------------------------------------------------
 POST /kimchy,elasticsearch/_flush/synced
 --------------------------------------------------
-// TEST[s/^/PUT elasticsearch\n/]
-// TEST[continued]
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
 
 
 [[synced-flush-api-all-ex]]
@@ -193,7 +189,7 @@ POST /kimchy,elasticsearch/_flush/synced
 --------------------------------------------------
 POST /_flush/synced
 --------------------------------------------------
-// TEST[setup:twitter]
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
 
 The response contains details about how many shards were successfully
 sync-flushed and information about any failure.
@@ -217,12 +213,12 @@ successfully sync-flushed:
    }
 }
 --------------------------------------------------
-// TESTRESPONSE[s/"successful": 2/"successful": 1/]
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
 
 The following response indicates one shard group failed
 due to pending operations:
 
-[source,js]
+[source,console-result]
 --------------------------------------------------
 {
    "_shards": {
@@ -243,13 +239,13 @@ due to pending operations:
    }
 }
 --------------------------------------------------
-// NOTCONSOLE
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
 
 Sometimes the failures are specific to a shard replica. The copies that failed
 will not be eligible for fast recovery but those that succeeded still will be.
 This case is reported as follows:
 
-[source,js]
+[source,console-result]
 --------------------------------------------------
 {
    "_shards": {
@@ -278,4 +274,4 @@ This case is reported as follows:
    }
 }
 --------------------------------------------------
-// NOTCONSOLE
+// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]

From adf64a2af919a54b45564856d06af9e8cb55fcb2 Mon Sep 17 00:00:00 2001
From: William Brafford <william.brafford@elastic.co>
Date: Mon, 9 Dec 2019 16:17:00 -0500
Subject: [PATCH 132/686] Refactor utility code in qa:os: tests (#49945)

This refactor bridges some gaps between a long-running feature branch (#49268) and the master branch.

First of all, this PR gives our PackagingTestCase class some methods to start and stop Elasticsearch that will switch on packaging type and delegate to the appropriate utility class for deb/RPM packages, archive installations, and Docker. These methods should be very useful as we continue group tests by function rather than by package or platform type.

Second, the password-protected keystore tests have a particular need to read the output of Elasticsearch startup commands. In order to make this easer to do, some commands now return Shell.Result objects so that tests can check over output to the shell. To that end, there's also an assertElasticsearchFailure method that will handle checking for startup failures for the various distribution types.

There is an update to the Powershell startup script for archives that asynchronously redirects the output of the Powershell process to files that we can read for errors.

Finally, we use the ES_STARTUP_SLEEP_TIME environment variable to make sure that our startup commands wait long enough before exiting for errors to make it to the standard output and error streams.
---
 .../packaging/test/ArchiveTests.java          |  30 ++--
 .../packaging/test/PackageTests.java          |  53 ++++---
 .../packaging/test/PackagingTestCase.java     | 134 ++++++++++++++----
 .../packaging/util/Archives.java              | 134 +++++++++++-------
 .../elasticsearch/packaging/util/Docker.java  |   2 +-
 .../packaging/util/Packages.java              |  32 ++---
 .../elasticsearch/packaging/util/Shell.java   |   1 +
 7 files changed, 238 insertions(+), 148 deletions(-)

diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/ArchiveTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/ArchiveTests.java
index 37fd4448974af..d427124d7fecd 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/ArchiveTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/ArchiveTests.java
@@ -138,7 +138,7 @@ public void test50StartAndStop() throws Exception {
         rm(installation.config("elasticsearch.keystore"));
 
         try {
-            Archives.runElasticsearch(installation, sh);
+            startElasticsearch();
         } catch (Exception e ){
             if (Files.exists(installation.home.resolve("elasticsearch.pid"))) {
                 String pid = FileUtils.slurp(installation.home.resolve("elasticsearch.pid")).trim();
@@ -151,7 +151,7 @@ public void test50StartAndStop() throws Exception {
         assertTrue("gc logs exist", Files.exists(installation.logs.resolve("gc.log")));
         ServerUtils.runElasticsearchTests();
 
-        Archives.stopElasticsearch(installation);
+        stopElasticsearch();
     }
 
     public void test51JavaHomeOverride() throws Exception {
@@ -164,9 +164,9 @@ public void test51JavaHomeOverride() throws Exception {
             sh.getEnv().put("JAVA_HOME", systemJavaHome1);
         });
 
-        Archives.runElasticsearch(installation, sh);
+        startElasticsearch();
         ServerUtils.runElasticsearchTests();
-        Archives.stopElasticsearch(installation);
+        stopElasticsearch();
 
         String systemJavaHome1 = sh.getEnv().get("JAVA_HOME");
         assertThat(FileUtils.slurpAllLogs(installation.logs, "elasticsearch.log", "*.log.gz"),
@@ -188,9 +188,9 @@ public void test52BundledJdkRemoved() throws Exception {
                 sh.getEnv().put("JAVA_HOME", systemJavaHome1);
             });
 
-            Archives.runElasticsearch(installation, sh);
+            startElasticsearch();
             ServerUtils.runElasticsearchTests();
-            Archives.stopElasticsearch(installation);
+            stopElasticsearch();
 
             String systemJavaHome1 = sh.getEnv().get("JAVA_HOME");
             assertThat(FileUtils.slurpAllLogs(installation.logs, "elasticsearch.log", "*.log.gz"),
@@ -211,9 +211,9 @@ public void test53JavaHomeWithSpecialCharacters() throws Exception {
                 sh.getEnv().put("JAVA_HOME", "C:\\Program Files (x86)\\java");
 
                 //verify ES can start, stop and run plugin list
-                Archives.runElasticsearch(installation, sh);
+                startElasticsearch();
 
-                Archives.stopElasticsearch(installation);
+                stopElasticsearch();
 
                 String pluginListCommand = installation.bin + "/elasticsearch-plugin list";
                 Result result = sh.run(pluginListCommand);
@@ -237,9 +237,9 @@ public void test53JavaHomeWithSpecialCharacters() throws Exception {
                 sh.getEnv().put("JAVA_HOME", testJavaHome);
 
                 //verify ES can start, stop and run plugin list
-                Archives.runElasticsearch(installation, sh);
+                startElasticsearch();
 
-                Archives.stopElasticsearch(installation);
+                stopElasticsearch();
 
                 String pluginListCommand = installation.bin + "/elasticsearch-plugin list";
                 Result result = sh.run(pluginListCommand);
@@ -284,13 +284,12 @@ public void test70CustomPathConfAndJvmOptions() throws Exception {
                 "-Dlog4j2.disable.jmx=true\n";
             append(tempConf.resolve("jvm.options"), jvmOptions);
 
-            final Shell sh = newShell();
             sh.chown(tempConf);
 
             sh.getEnv().put("ES_PATH_CONF", tempConf.toString());
             sh.getEnv().put("ES_JAVA_OPTS", "-XX:-UseCompressedOops");
 
-            Archives.runElasticsearch(installation, sh);
+            startElasticsearch();
 
             final String nodesResponse = makeRequest(Request.Get("http://localhost:9200/_nodes"));
             assertThat(nodesResponse, containsString("\"heap_init_in_bytes\":536870912"));
@@ -318,17 +317,16 @@ public void test80RelativePathConf() throws Exception {
 
             append(tempConf.resolve("elasticsearch.yml"), "node.name: relative");
 
-            final Shell sh = newShell();
             sh.chown(temp);
 
             sh.setWorkingDirectory(temp);
             sh.getEnv().put("ES_PATH_CONF", "config");
-            Archives.runElasticsearch(installation, sh);
+            startElasticsearch();
 
             final String nodesResponse = makeRequest(Request.Get("http://localhost:9200/_nodes"));
             assertThat(nodesResponse, containsString("\"name\":\"relative\""));
 
-            Archives.stopElasticsearch(installation);
+            stopElasticsearch();
 
         } finally {
             rm(tempConf);
@@ -393,7 +391,7 @@ public void test93ElasticsearchNodeCustomDataPathAndNotEsHomeWorkDir() throws Ex
 
         sh.setWorkingDirectory(getTempDir());
 
-        Archives.runElasticsearch(installation, sh);
+        startElasticsearch();
         Archives.stopElasticsearch(installation);
 
         Result result = sh.run("echo y | " + installation.executables().elasticsearchNode + " unsafe-bootstrap");
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackageTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackageTests.java
index 155048be8a630..c992b02b1c522 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackageTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackageTests.java
@@ -50,9 +50,6 @@
 import static org.elasticsearch.packaging.util.Packages.installPackage;
 import static org.elasticsearch.packaging.util.Packages.remove;
 import static org.elasticsearch.packaging.util.Packages.restartElasticsearch;
-import static org.elasticsearch.packaging.util.Packages.startElasticsearch;
-import static org.elasticsearch.packaging.util.Packages.startElasticsearchIgnoringFailure;
-import static org.elasticsearch.packaging.util.Packages.stopElasticsearch;
 import static org.elasticsearch.packaging.util.Packages.verifyPackageInstallation;
 import static org.elasticsearch.packaging.util.Platforms.getOsRelease;
 import static org.elasticsearch.packaging.util.Platforms.isSystemd;
@@ -101,9 +98,9 @@ private void assertRunsWithJavaHome() throws Exception {
         try {
             Files.write(installation.envFile, ("JAVA_HOME=" + systemJavaHome + "\n").getBytes(StandardCharsets.UTF_8),
                 StandardOpenOption.APPEND);
-            startElasticsearch(sh, installation);
+            startElasticsearch();
             runElasticsearchTests();
-            stopElasticsearch(sh);
+            stopElasticsearch();
         } finally {
             Files.write(installation.envFile, originalEnvFile);
         }
@@ -129,9 +126,9 @@ public void test33RunsIfJavaNotOnPath() throws Exception {
         }
 
         try {
-            startElasticsearch(sh, installation);
+            startElasticsearch();
             runElasticsearchTests();
-            stopElasticsearch(sh);
+            stopElasticsearch();
         } finally {
             if (Files.exists(Paths.get(backupPath))) {
                 sh.run("sudo mv " + backupPath + " /usr/bin/java");
@@ -153,7 +150,7 @@ public void test42BundledJdkRemoved() throws Exception {
 
     public void test40StartServer() throws Exception {
         String start = sh.runIgnoreExitCode("date ").stdout.trim();
-        startElasticsearch(sh, installation);
+        startElasticsearch();
 
         String journalEntries = sh.runIgnoreExitCode("journalctl _SYSTEMD_UNIT=elasticsearch.service " +
             "--since \"" + start + "\" --output cat | wc -l").stdout.trim();
@@ -218,7 +215,7 @@ public void test50Remove() throws Exception {
     }
 
     public void test60Reinstall() throws Exception {
-        installation = installPackage(distribution());
+        install();
         assertInstalled(distribution());
         verifyPackageInstallation(installation, distribution(), sh);
 
@@ -228,13 +225,13 @@ public void test60Reinstall() throws Exception {
 
     public void test70RestartServer() throws Exception {
         try {
-            installation = installPackage(distribution());
+            install();
             assertInstalled(distribution());
 
-            startElasticsearch(sh, installation);
+            startElasticsearch();
             restartElasticsearch(sh, installation);
             runElasticsearchTests();
-            stopElasticsearch(sh);
+            stopElasticsearch();
         } finally {
             cleanup();
         }
@@ -243,22 +240,22 @@ public void test70RestartServer() throws Exception {
 
     public void test72TestRuntimeDirectory() throws Exception {
         try {
-            installation = installPackage(distribution());
+            install();
             FileUtils.rm(installation.pidDir);
-            startElasticsearch(sh, installation);
+            startElasticsearch();
             assertPathsExist(installation.pidDir);
-            stopElasticsearch(sh);
+            stopElasticsearch();
         } finally {
             cleanup();
         }
     }
 
     public void test73gcLogsExist() throws Exception {
-        installation = installPackage(distribution());
-        startElasticsearch(sh, installation);
+        install();
+        startElasticsearch();
         // it can be gc.log or gc.log.0.current
         assertThat(installation.logs, fileWithGlobExist("gc.log*"));
-        stopElasticsearch(sh);
+        stopElasticsearch();
     }
 
     // TEST CASES FOR SYSTEMD ONLY
@@ -277,26 +274,26 @@ public void test80DeletePID_DIRandRestart() throws Exception {
 
         sh.run("systemd-tmpfiles --create");
 
-        startElasticsearch(sh, installation);
+        startElasticsearch();
 
         final Path pidFile = installation.pidDir.resolve("elasticsearch.pid");
 
         assertTrue(Files.exists(pidFile));
 
-        stopElasticsearch(sh);
+        stopElasticsearch();
     }
 
     public void test81CustomPathConfAndJvmOptions() throws Exception {
         withCustomConfig(tempConf -> {
             append(installation.envFile, "ES_JAVA_OPTS=-XX:-UseCompressedOops");
 
-            startElasticsearch(sh, installation);
+            startElasticsearch();
 
             final String nodesResponse = makeRequest(Request.Get("http://localhost:9200/_nodes"));
             assertThat(nodesResponse, containsString("\"heap_init_in_bytes\":536870912"));
             assertThat(nodesResponse, containsString("\"using_compressed_ordinary_object_pointers\":\"false\""));
 
-            stopElasticsearch(sh);
+            stopElasticsearch();
         });
     }
 
@@ -306,7 +303,7 @@ public void test82SystemdMask() throws Exception {
 
             sh.run("systemctl mask systemd-sysctl.service");
 
-            installation = installPackage(distribution());
+            install();
 
             sh.run("systemctl unmask systemd-sysctl.service");
         } finally {
@@ -318,9 +315,9 @@ public void test83serviceFileSetsLimits() throws Exception {
         // Limits are changed on systemd platforms only
         assumeTrue(isSystemd());
 
-        installation = installPackage(distribution());
+        install();
 
-        startElasticsearch(sh, installation);
+        startElasticsearch();
 
         final Path pidFile = installation.pidDir.resolve("elasticsearch.pid");
         assertTrue(Files.exists(pidFile));
@@ -337,7 +334,7 @@ public void test83serviceFileSetsLimits() throws Exception {
         String maxAddressSpace = sh.run("cat /proc/%s/limits | grep \"Max address space\" | awk '{ print $4 }'", pid).stdout.trim();
         assertThat(maxAddressSpace, equalTo("unlimited"));
 
-        stopElasticsearch(sh);
+        stopElasticsearch();
     }
 
     public void test90DoNotCloseStderrWhenQuiet() throws Exception {
@@ -347,7 +344,7 @@ public void test90DoNotCloseStderrWhenQuiet() throws Exception {
 
             // Make sure we don't pick up the journal entries for previous ES instances.
             clearJournal(sh);
-            startElasticsearchIgnoringFailure(sh);
+            runElasticsearchStartCommand();
 
             final Result logs = sh.run("journalctl -u elasticsearch.service");
 
@@ -365,7 +362,7 @@ private void withCustomConfig(CustomConfigConsumer pathConsumer) throws Exceptio
 
         assertPathsExist(installation.envFile);
 
-        stopElasticsearch(sh);
+        stopElasticsearch();
 
         // The custom config directory is not under /tmp or /var/tmp because
         // systemd's private temp directory functionally means different
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
index cb95408b2a5bf..f797d8d49684a 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
@@ -48,6 +48,8 @@
 import java.nio.file.Paths;
 
 import static org.elasticsearch.packaging.util.Cleanup.cleanEverything;
+import static org.hamcrest.CoreMatchers.containsString;
+import static org.hamcrest.CoreMatchers.equalTo;
 import static org.junit.Assume.assumeFalse;
 import static org.junit.Assume.assumeTrue;
 
@@ -139,6 +141,9 @@ protected static void install() throws Exception {
             case DOCKER:
                 installation = Docker.runContainer(distribution);
                 Docker.verifyContainerInstallation(installation, distribution);
+                break;
+            default:
+                throw new IllegalStateException("Unknown Elasticsearch packaging type.");
         }
     }
 
@@ -147,19 +152,7 @@ protected static void install() throws Exception {
      */
     protected void assertWhileRunning(Platforms.PlatformAction assertions) throws Exception {
         try {
-            switch (distribution.packaging) {
-                case TAR:
-                case ZIP:
-                    Archives.runElasticsearch(installation, sh);
-                    break;
-                case DEB:
-                case RPM:
-                    Packages.startElasticsearch(sh, installation);
-                    break;
-                case DOCKER:
-                    // nothing, "installing" docker image is running it
-            }
-
+            awaitElasticsearchStartup(runElasticsearchStartCommand());
         } catch (Exception e ){
             if (Files.exists(installation.home.resolve("elasticsearch.pid"))) {
                 String pid = FileUtils.slurp(installation.home.resolve("elasticsearch.pid")).trim();
@@ -180,7 +173,46 @@ protected void assertWhileRunning(Platforms.PlatformAction assertions) throws Ex
                 FileUtils.slurpAllLogs(installation.logs, "elasticsearch.log", "*.log.gz"));
             throw e;
         }
+        stopElasticsearch();
+    }
+
+    protected static Shell newShell() throws Exception {
+        Shell sh = new Shell();
+        if (distribution().hasJdk == false) {
+            Platforms.onLinux(() -> {
+                sh.getEnv().put("JAVA_HOME", systemJavaHome);
+            });
+            Platforms.onWindows(() -> {
+                sh.getEnv().put("JAVA_HOME", systemJavaHome);
+            });
+        }
+        return sh;
+    }
 
+    /**
+     * Run the command to start Elasticsearch, but don't wait or test for success.
+     * This method is useful for testing failure conditions in startup. To await success,
+     * use {@link #startElasticsearch()}.
+     * @return Shell results of the startup command.
+     * @throws Exception when command fails immediately.
+     */
+    public Shell.Result runElasticsearchStartCommand() throws Exception {
+        switch (distribution.packaging) {
+            case TAR:
+            case ZIP:
+                return Archives.runElasticsearchStartCommand(installation, sh);
+            case DEB:
+            case RPM:
+                return Packages.runElasticsearchStartCommand(sh);
+            case DOCKER:
+                // nothing, "installing" docker image is running it
+                return Shell.NO_OP;
+            default:
+                throw new IllegalStateException("Unknown Elasticsearch packaging type.");
+        }
+    }
+
+    public void stopElasticsearch() throws Exception {
         switch (distribution.packaging) {
             case TAR:
             case ZIP:
@@ -191,20 +223,74 @@ protected void assertWhileRunning(Platforms.PlatformAction assertions) throws Ex
                 Packages.stopElasticsearch(sh);
                 break;
             case DOCKER:
-                // nothing, removing container is handled externally
+                // nothing, "installing" docker image is running it
+                break;
+            default:
+                throw new IllegalStateException("Unknown Elasticsearch packaging type.");
         }
     }
 
-    protected static Shell newShell() throws Exception {
-        Shell sh = new Shell();
-        if (distribution().hasJdk == false) {
-            Platforms.onLinux(() -> {
-                sh.getEnv().put("JAVA_HOME", systemJavaHome);
-            });
-            Platforms.onWindows(() -> {
-                sh.getEnv().put("JAVA_HOME", systemJavaHome);
-            });
+    public void awaitElasticsearchStartup(Shell.Result result) throws Exception {
+        assertThat("Startup command should succeed", result.exitCode, equalTo(0));
+        switch (distribution.packaging) {
+            case TAR:
+            case ZIP:
+                Archives.assertElasticsearchStarted(installation);
+                break;
+            case DEB:
+            case RPM:
+                Packages.assertElasticsearchStarted(sh, installation);
+                break;
+            case DOCKER:
+                Docker.waitForElasticsearchToStart();
+                break;
+            default:
+                throw new IllegalStateException("Unknown Elasticsearch packaging type.");
+        }
+    }
+
+    /**
+     * Start Elasticsearch and wait until it's up and running. If you just want to run
+     * the start command, use {@link #runElasticsearchStartCommand()}.
+     * @throws Exception if Elasticsearch can't start
+     */
+    public void startElasticsearch() throws Exception {
+        awaitElasticsearchStartup(runElasticsearchStartCommand());
+    }
+
+    public void assertElasticsearchFailure(Shell.Result result, String expectedMessage) {
+
+        if (Files.exists(installation.logs.resolve("elasticsearch.log"))) {
+
+            // If log file exists, then we have bootstrapped our logging and the
+            // error should be in the logs
+            assertTrue("log file exists", Files.exists(installation.logs.resolve("elasticsearch.log")));
+            String logfile = FileUtils.slurp(installation.logs.resolve("elasticsearch.log"));
+            assertThat(logfile, containsString(expectedMessage));
+
+        } else if (distribution().isPackage() && Platforms.isSystemd()) {
+
+            // For systemd, retrieve the error from journalctl
+            assertThat(result.stderr, containsString("Job for elasticsearch.service failed"));
+            Shell.Result error = sh.run("journalctl --boot --unit elasticsearch.service");
+            assertThat(error.stdout, containsString(expectedMessage));
+
+        } else if (Platforms.WINDOWS == true) {
+
+            // In Windows, we have written our stdout and stderr to files in order to run
+            // in the background
+            String wrapperPid = result.stdout.trim();
+            sh.runIgnoreExitCode("Wait-Process -Timeout " + Archives.ES_STARTUP_SLEEP_TIME_SECONDS + " -Id " + wrapperPid);
+            sh.runIgnoreExitCode("Get-EventSubscriber | " +
+                "where {($_.EventName -eq 'OutputDataReceived' -Or $_.EventName -eq 'ErrorDataReceived' |" +
+                "Unregister-EventSubscriber -Force");
+            assertThat(FileUtils.slurp(Archives.getPowershellErrorPath(installation)), containsString(expectedMessage));
+
+        } else {
+
+            // Otherwise, error should be on shell stderr
+            assertThat(result.stderr, containsString(expectedMessage));
+
         }
-        return sh;
     }
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
index 4303ca3bb6dd1..1ec62d20a050d 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
@@ -43,7 +43,7 @@
 import static org.elasticsearch.packaging.util.FileUtils.slurp;
 import static org.elasticsearch.packaging.util.Platforms.isDPKG;
 import static org.hamcrest.MatcherAssert.assertThat;
-import static org.hamcrest.Matchers.isEmptyOrNullString;
+import static org.hamcrest.Matchers.emptyOrNullString;
 import static org.hamcrest.collection.IsCollectionWithSize.hasSize;
 import static org.hamcrest.collection.IsEmptyCollection.empty;
 import static org.hamcrest.core.Is.is;
@@ -63,6 +63,10 @@ public class Archives {
         ? System.getenv("username")
         : "elasticsearch";
 
+    /** This is an arbitrarily chosen value that gives Elasticsearch time to log Bootstrap
+     *  errors to the console if they occur before the logging framework is initialized. */
+    public static final String ES_STARTUP_SLEEP_TIME_SECONDS = "10";
+
     public static Installation installArchive(Distribution distribution) throws Exception {
         return installArchive(distribution, getDefaultArchiveInstallPath(), getCurrentVersion());
     }
@@ -242,89 +246,109 @@ private static void verifyDefaultInstallation(Installation es, Distribution dist
         ).forEach(configFile -> assertThat(es.config(configFile), file(File, owner, owner, p660)));
     }
 
-    public static void runElasticsearch(Installation installation, Shell sh) throws Exception {
+    public static Shell.Result runElasticsearchStartCommand(Installation installation, Shell sh) {
         final Path pidFile = installation.home.resolve("elasticsearch.pid");
 
         assertFalse("Pid file doesn't exist when starting Elasticsearch", Files.exists(pidFile));
 
         final Installation.Executables bin = installation.executables();
 
-        Platforms.onLinux(() -> {
+        if (Platforms.WINDOWS == false) {
             // If jayatana is installed then we try to use it. Elasticsearch should ignore it even when we try.
             // If it doesn't ignore it then Elasticsearch will fail to start because of security errors.
             // This line is attempting to emulate the on login behavior of /usr/share/upstart/sessions/jayatana.conf
             if (Files.exists(Paths.get("/usr/share/java/jayatanaag.jar"))) {
                 sh.getEnv().put("JAVA_TOOL_OPTIONS", "-javaagent:/usr/share/java/jayatanaag.jar");
             }
-            sh.run("sudo -E -u " + ARCHIVE_OWNER + " " +
-                bin.elasticsearch + " -d -p " + installation.home.resolve("elasticsearch.pid"));
-        });
 
-        Platforms.onWindows(() -> {
-            // this starts the server in the background. the -d flag is unsupported on windows
-            if (System.getenv("username").equals("vagrant")) {
-                // these tests run as Administrator in vagrant.
-                // we don't want to run the server as Administrator, so we provide the current user's
-                // username and password to the process which has the effect of starting it not as Administrator.
-                sh.run(
-                    "$password = ConvertTo-SecureString 'vagrant' -AsPlainText -Force; " +
-                        "$processInfo = New-Object System.Diagnostics.ProcessStartInfo; " +
-                        "$processInfo.FileName = '" + bin.elasticsearch + "'; " +
-                        "$processInfo.Arguments = '-p " + installation.home.resolve("elasticsearch.pid") + "'; " +
-                        "$processInfo.Username = 'vagrant'; " +
-                        "$processInfo.Password = $password; " +
-                        "$processInfo.RedirectStandardOutput = $true; " +
-                        "$processInfo.RedirectStandardError = $true; " +
-                        sh.env.entrySet().stream()
-                            .map(entry -> "$processInfo.Environment.Add('" + entry.getKey() + "', '" + entry.getValue() + "'); ")
-                            .collect(joining()) +
-                        "$processInfo.UseShellExecute = $false; " +
-                        "$process = New-Object System.Diagnostics.Process; " +
-                        "$process.StartInfo = $processInfo; " +
-                        "$process.Start() | Out-Null; " +
-                        "$process.Id;"
-                );
-            } else {
-                sh.run(
-                        "$processInfo = New-Object System.Diagnostics.ProcessStartInfo; " +
-                        "$processInfo.FileName = '" + bin.elasticsearch + "'; " +
-                        "$processInfo.Arguments = '-p " + installation.home.resolve("elasticsearch.pid") + "'; " +
-                        "$processInfo.RedirectStandardOutput = $true; " +
-                        "$processInfo.RedirectStandardError = $true; " +
-                        sh.env.entrySet().stream()
-                            .map(entry -> "$processInfo.Environment.Add('" + entry.getKey() + "', '" + entry.getValue() + "'); ")
-                            .collect(joining()) +
-                        "$processInfo.UseShellExecute = $false; " +
-                        "$process = New-Object System.Diagnostics.Process; " +
-                        "$process.StartInfo = $processInfo; " +
-                        "$process.Start() | Out-Null; " +
-                        "$process.Id;"
-                );
-            }
-        });
+            // We need to give Elasticsearch enough time to print failures to stderr before exiting
+            sh.getEnv().put("ES_STARTUP_SLEEP_TIME", ES_STARTUP_SLEEP_TIME_SECONDS);
+            return sh.runIgnoreExitCode("sudo -E -u " + ARCHIVE_OWNER + " " + bin.elasticsearch + " -d -p " + pidFile);
+        }
+        final Path stdout = getPowershellOutputPath(installation);
+        final Path stderr = getPowershellErrorPath(installation);
+
+        String powerShellProcessUserSetup;
+        if (System.getenv("username").equals("vagrant")) {
+            // the tests will run as Administrator in vagrant.
+            // we don't want to run the server as Administrator, so we provide the current user's
+            // username and password to the process which has the effect of starting it not as Administrator.
+            powerShellProcessUserSetup =
+                "$password = ConvertTo-SecureString 'vagrant' -AsPlainText -Force; " +
+                "$processInfo.Username = 'vagrant'; " +
+                "$processInfo.Password = $password; ";
+        } else {
+            powerShellProcessUserSetup = "";
+        }
+
+        // this starts the server in the background. the -d flag is unsupported on windows
+        return sh.run(
+            "$processInfo = New-Object System.Diagnostics.ProcessStartInfo; " +
+                "$processInfo.FileName = '" + bin.elasticsearch + "'; " +
+                "$processInfo.Arguments = '-p " + installation.home.resolve("elasticsearch.pid") + "'; " +
+                powerShellProcessUserSetup +
+                "$processInfo.RedirectStandardOutput = $true; " +
+                "$processInfo.RedirectStandardError = $true; " +
+                "$processInfo.RedirectStandardInput = $true; " +
+                sh.env.entrySet().stream()
+                    .map(entry -> "$processInfo.Environment.Add('" + entry.getKey() + "', '" + entry.getValue() + "'); ")
+                    .collect(joining()) +
+                "$processInfo.UseShellExecute = $false; " +
+                "$process = New-Object System.Diagnostics.Process; " +
+                "$process.StartInfo = $processInfo; " +
+
+                // set up some asynchronous output handlers
+                "$outScript = { $EventArgs.Data | Out-File -Encoding UTF8 -Append '" + stdout + "' }; " +
+                "$errScript = { $EventArgs.Data | Out-File -Encoding UTF8 -Append '" + stderr + "' }; " +
+                "$stdOutEvent = Register-ObjectEvent -InputObject $process " +
+                "-Action $outScript -EventName 'OutputDataReceived'; " +
+                "$stdErrEvent = Register-ObjectEvent -InputObject $process " +
+                "-Action $errScript -EventName 'ErrorDataReceived'; " +
+
+                "$process.Start() | Out-Null; " +
+                "$process.BeginOutputReadLine(); " +
+                "$process.BeginErrorReadLine(); " +
+                "Wait-Process -Timeout " + ES_STARTUP_SLEEP_TIME_SECONDS + " -Id $process.Id; " +
+                "$process.Id;"
+            );
+    }
 
+    public static void assertElasticsearchStarted(Installation installation) throws Exception {
+        final Path pidFile = installation.home.resolve("elasticsearch.pid");
         ServerUtils.waitForElasticsearch(installation);
 
         assertTrue("Starting Elasticsearch produced a pid file at " + pidFile, Files.exists(pidFile));
         String pid = slurp(pidFile).trim();
-        assertThat(pid, not(isEmptyOrNullString()));
-
-        Platforms.onLinux(() -> sh.run("ps " + pid));
-        Platforms.onWindows(() -> sh.run("Get-Process -Id " + pid));
+        assertThat(pid, is(not(emptyOrNullString())));
     }
 
     public static void stopElasticsearch(Installation installation) throws Exception {
         Path pidFile = installation.home.resolve("elasticsearch.pid");
-        assertTrue(Files.exists(pidFile));
+        assertTrue("pid file should exist", Files.exists(pidFile));
         String pid = slurp(pidFile).trim();
-        assertThat(pid, not(isEmptyOrNullString()));
+        assertThat(pid, is(not(emptyOrNullString())));
 
         final Shell sh = new Shell();
         Platforms.onLinux(() -> sh.run("kill -SIGTERM " + pid + "; tail --pid=" + pid + " -f /dev/null"));
-        Platforms.onWindows(() -> sh.run("Get-Process -Id " + pid + " | Stop-Process -Force; Wait-Process -Id " + pid));
+        Platforms.onWindows(() -> {
+            sh.run("Get-Process -Id " + pid + " | Stop-Process -Force; Wait-Process -Id " + pid);
+
+            // Clear the asynchronous event handlers
+            sh.runIgnoreExitCode("Get-EventSubscriber | " +
+                "where {($_.EventName -eq 'OutputDataReceived' -Or $_.EventName -eq 'ErrorDataReceived' |" +
+                "Unregister-EventSubscriber -Force");
+        });
         if (Files.exists(pidFile)) {
             Files.delete(pidFile);
         }
     }
 
+    public static Path getPowershellErrorPath(Installation installation) {
+        return installation.logs.resolve("output.err");
+    }
+
+    private static Path getPowershellOutputPath(Installation installation) {
+        return installation.logs.resolve("output.out");
+    }
+
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
index 95e5b586627c6..91b010957011b 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
@@ -166,7 +166,7 @@ private static void executeDockerRun(Distribution distribution, Map<Path, Path>
      * Waits for the Elasticsearch process to start executing in the container.
      * This is called every time a container is started.
      */
-    private static void waitForElasticsearchToStart() {
+    public static void waitForElasticsearchToStart() {
         boolean isElasticsearchRunning = false;
         int attempt = 0;
 
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
index 723625f1bb8bc..a96c7d1b6707a 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
@@ -268,32 +268,17 @@ private static void verifyDefaultInstallation(Installation es) {
         ).forEach(configFile -> assertThat(es.config(configFile), file(File, "root", "elasticsearch", p660)));
     }
 
-    public static void startElasticsearch(Shell sh, Installation installation) throws IOException {
+    /**
+     * Starts Elasticsearch, without checking that startup is successful.
+     */
+    public static Shell.Result runElasticsearchStartCommand(Shell sh) throws IOException {
         if (isSystemd()) {
             sh.run("systemctl daemon-reload");
             sh.run("systemctl enable elasticsearch.service");
             sh.run("systemctl is-enabled elasticsearch.service");
-            sh.run("systemctl start elasticsearch.service");
-        } else {
-            sh.run("service elasticsearch start");
-        }
-
-        assertElasticsearchStarted(sh, installation);
-    }
-
-    /**
-     * Starts Elasticsearch, without checking that startup is successful. To also check
-     * that Elasticsearch has started, call {@link #startElasticsearch(Shell, Installation)}.
-     */
-    public static void startElasticsearchIgnoringFailure(Shell sh) {
-        if (isSystemd()) {
-            sh.runIgnoreExitCode("systemctl daemon-reload");
-            sh.runIgnoreExitCode("systemctl enable elasticsearch.service");
-            sh.runIgnoreExitCode("systemctl is-enabled elasticsearch.service");
-            sh.runIgnoreExitCode("systemctl start elasticsearch.service");
-        } else {
-            sh.runIgnoreExitCode("service elasticsearch start");
+            return sh.runIgnoreExitCode("systemctl start elasticsearch.service");
         }
+        return sh.runIgnoreExitCode("service elasticsearch start");
     }
 
     /**
@@ -321,7 +306,7 @@ public static void clearJournal(Shell sh) {
         }
     }
 
-    private static void assertElasticsearchStarted(Shell sh, Installation installation) throws IOException {
+    public static void assertElasticsearchStarted(Shell sh, Installation installation) throws IOException {
         waitForElasticsearch(installation);
 
         if (isSystemd()) {
@@ -346,7 +331,6 @@ public static void restartElasticsearch(Shell sh, Installation installation) thr
         } else {
             sh.run("service elasticsearch restart");
         }
-
-        waitForElasticsearch(installation);
+        assertElasticsearchStarted(sh, installation);
     }
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
index 55488522797c1..bbcbcd1b1d498 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
@@ -43,6 +43,7 @@
 public class Shell {
 
     public static final int TAIL_WHEN_TOO_MUCH_OUTPUT = 1000;
+    public static final Result NO_OP = new Shell.Result(0, "","");
     protected final Logger logger =  LogManager.getLogger(getClass());
 
     final Map<String, String> env = new HashMap<>();

From 1f8c96a6a1437613fa7c62c7a5548e38ac299a76 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Mon, 9 Dec 2019 18:47:27 -0800
Subject: [PATCH 133/686] Added license and renamed files for tests

---
 .../xpack/core/ilm/CloseIndexStep.java        | 19 +++--------------
 .../xpack/core/ilm/OpenIndexStep.java         | 20 ++++--------------
 .../xpack/core/ilm/WaitForIndexGreenStep.java | 20 ++++--------------
 ...StepTest.java => CloseIndexStepTests.java} | 21 ++++---------------
 ...xStepTest.java => OpenIndexStepTests.java} | 21 ++++---------------
 ...t.java => WaitForIndexGreenStepTests.java} | 21 ++++---------------
 .../ilm/TimeSeriesLifecycleActionsIT.java     |  4 ++--
 7 files changed, 25 insertions(+), 101 deletions(-)
 rename x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/{CloseIndexStepTest.java => CloseIndexStepTests.java} (87%)
 rename x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/{OpenIndexStepTest.java => OpenIndexStepTests.java} (87%)
 rename x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/{WaitForIndexGreenStepTest.java => WaitForIndexGreenStepTests.java} (88%)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index 53f7e469c3bbe..f0afab5f604ee 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -1,20 +1,7 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index fc9cf75284411..b032b0761fa44 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -1,21 +1,9 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
+
 package org.elasticsearch.xpack.core.ilm;
 
 import org.elasticsearch.action.ActionListener;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
index fc602a1a250f7..d717a970c66b1 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
@@ -1,21 +1,9 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
+
 package org.elasticsearch.xpack.core.ilm;
 
 import com.carrotsearch.hppc.cursors.ObjectCursor;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTests.java
similarity index 87%
rename from x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
rename to x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTests.java
index 53b2c47d00b69..b0980b284eb73 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/CloseIndexStepTests.java
@@ -1,20 +1,7 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
@@ -36,7 +23,7 @@
 
 import static org.hamcrest.Matchers.equalTo;
 
-public class CloseIndexStepTest extends AbstractStepTestCase<CloseIndexStep> {
+public class CloseIndexStepTests extends AbstractStepTestCase<CloseIndexStep> {
 
     private Client client;
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTests.java
similarity index 87%
rename from x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
rename to x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTests.java
index 558e4ac824a11..812d90dd5c259 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/OpenIndexStepTests.java
@@ -1,20 +1,7 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
@@ -34,7 +21,7 @@
 
 import static org.hamcrest.Matchers.equalTo;
 
-public class OpenIndexStepTest extends AbstractStepTestCase<OpenIndexStep> {
+public class OpenIndexStepTests extends AbstractStepTestCase<OpenIndexStep> {
 
     private Client client;
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
similarity index 88%
rename from x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
rename to x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
index 87c1f19a56e4f..46fba4bcf1770 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTest.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
@@ -1,20 +1,7 @@
 /*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
  */
 
 package org.elasticsearch.xpack.core.ilm;
@@ -36,7 +23,7 @@
 import static org.hamcrest.Matchers.nullValue;
 import static org.hamcrest.core.IsNull.notNullValue;
 
-public class WaitForIndexGreenStepTest extends AbstractStepTestCase<WaitForIndexGreenStep> {
+public class WaitForIndexGreenStepTests extends AbstractStepTestCase<WaitForIndexGreenStep> {
 
     @Override
     protected WaitForIndexGreenStep createRandomInstance() {
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 4e160c69efd13..2ee3de617c432 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -411,7 +411,7 @@ public void testForceMergeAction() throws Exception {
         };
         assertThat(numSegments.get(), greaterThan(1));
 
-        createNewSingletonPolicy("warm", new ForceMergeAction(1));
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, false));
         updatePolicy(index, policy);
 
         assertBusy(() -> {
@@ -1007,7 +1007,7 @@ private void createFullPolicy(TimeValue hotTime) throws IOException {
         hotActions.put(RolloverAction.NAME,  new RolloverAction(null, null, 1L));
         Map<String, LifecycleAction> warmActions = new HashMap<>();
         warmActions.put(SetPriorityAction.NAME, new SetPriorityAction(50));
-        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1));
+        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, false));
         warmActions.put(AllocateAction.NAME, new AllocateAction(1, singletonMap("_name", "integTest-1,integTest-2"), null, null));
         warmActions.put(ShrinkAction.NAME, new ShrinkAction(1));
         Map<String, LifecycleAction> coldActions = new HashMap<>();

From d12c7cb4700cfa8167f98d4ff7d1dbceeed8542c Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Tue, 10 Dec 2019 16:46:07 +1100
Subject: [PATCH 134/686] Add setting to restrict license types (#49418)

This adds a new "xpack.license.upload.types" setting that restricts
which license types may be uploaded to a cluster.

By default all types are allowed (excluding basic, which can only be
generated and never uploaded).
This setting does not restrict APIs that generate licenses such as the
start trial API.

This setting is not documented as it is intended to be set by
orchestrators and not end users.
---
 .../org/elasticsearch/license/License.java    |  49 ++++--
 .../elasticsearch/license/LicenseService.java |  49 +++++-
 .../license/OperationModeFileWatcher.java     |   2 +-
 .../license/RemoteClusterLicenseChecker.java  |   6 +-
 .../xpack/core/XPackClientPlugin.java         |   1 +
 .../core/ml/inference/TrainedModelConfig.java |   4 +-
 .../license/LicenseFIPSTests.java             |  10 ++
 .../license/LicenseOperationModeTests.java    |   6 +-
 .../LicenseOperationModeUpdateTests.java      |   2 +-
 .../license/LicenseServiceTests.java          | 164 ++++++++++++++++++
 10 files changed, 273 insertions(+), 20 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/License.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/License.java
index 6731518f5b534..004c9ff987764 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/License.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/License.java
@@ -63,7 +63,23 @@ public static LicenseType parse(String type) throws IllegalArgumentException {
         /**
          * Backward compatible license type parsing for older license models
          */
-        public static LicenseType resolve(String name) {
+        public static LicenseType resolve(License license) {
+            if (license.version == VERSION_START) {
+                // in 1.x: the acceptable values for 'subscription_type': none | dev | silver | gold | platinum
+                return resolve(license.subscriptionType);
+            } else {
+                // in 2.x: the acceptable values for 'type': trial | basic | silver | dev | gold | platinum
+                // in 5.x: the acceptable values for 'type': trial | basic | standard | dev | gold | platinum
+                // in 6.x: the acceptable values for 'type': trial | basic | standard | dev | gold | platinum
+                // in 7.x: the acceptable values for 'type': trial | basic | standard | dev | gold | platinum | enterprise
+                return resolve(license.type);
+            }
+        }
+
+        /**
+         * Backward compatible license type parsing for older license models
+         */
+        static LicenseType resolve(String name) {
             switch (name.toLowerCase(Locale.ROOT)) {
                 case "missing":
                     return null;
@@ -165,8 +181,12 @@ public static int compare(OperationMode opMode1, OperationMode opMode2) {
             return Integer.compare(opMode1.id, opMode2.id);
         }
 
-        public static OperationMode resolve(String typeName) {
-            LicenseType type = LicenseType.resolve(typeName);
+        /**
+         * Determine the operating mode for a license type
+         * @see LicenseType#resolve(License)
+         * @see #parse(String)
+         */
+        public static OperationMode resolve(LicenseType type) {
             if (type == null) {
                 return MISSING;
             }
@@ -187,6 +207,21 @@ public static OperationMode resolve(String typeName) {
             }
         }
 
+        /**
+         * Parses an {@code OperatingMode} from a String.
+         * The string must name an operating mode, and not a licensing level (that is, it cannot parse old style license levels
+         * such as "dev" or "silver").
+         * @see #description()
+         */
+        public static OperationMode parse(String mode) {
+            try {
+                return OperationMode.valueOf(mode.toUpperCase(Locale.ROOT));
+            } catch (IllegalArgumentException e) {
+                throw new IllegalArgumentException("unrecognised license operating mode [ " + mode + "], supported modes are ["
+                    + Stream.of(values()).map(OperationMode::description).collect(Collectors.joining(",")) + "]");
+            }
+        }
+
         public String description() {
             return name().toLowerCase(Locale.ROOT);
         }
@@ -212,13 +247,7 @@ private License(int version, String uid, String issuer, String issuedTo, long is
         }
         this.maxNodes = maxNodes;
         this.startDate = startDate;
-        if (version == VERSION_START) {
-            // in 1.x: the acceptable values for 'subscription_type': none | dev | silver | gold | platinum
-            this.operationMode = OperationMode.resolve(subscriptionType);
-        } else {
-            // in 2.x: the acceptable values for 'type': trial | basic | silver | dev | gold | platinum
-            this.operationMode = OperationMode.resolve(type);
-        }
+        this.operationMode = OperationMode.resolve(LicenseType.resolve(this));
         validate();
     }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
index f16cb2fbe3932..af34d31c14422 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
@@ -47,6 +47,7 @@
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 /**
  * Service responsible for managing {@link LicensesMetaData}.
@@ -64,6 +65,12 @@ public class LicenseService extends AbstractLifecycleComponent implements Cluste
         return SelfGeneratedLicense.validateSelfGeneratedType(type);
     }, Setting.Property.NodeScope);
 
+    static final List<License.LicenseType> ALLOWABLE_UPLOAD_TYPES = getAllowableUploadTypes();
+
+    public static final Setting<List<License.LicenseType>> ALLOWED_LICENSE_TYPES_SETTING = Setting.listSetting("xpack.license.upload.types",
+        ALLOWABLE_UPLOAD_TYPES.stream().map(License.LicenseType::getTypeName).collect(Collectors.toUnmodifiableList()),
+        License.LicenseType::parse, LicenseService::validateUploadTypesSetting, Setting.Property.NodeScope);
+
     // pkg private for tests
     static final TimeValue NON_BASIC_SELF_GENERATED_LICENSE_DURATION = TimeValue.timeValueHours(30 * 24);
 
@@ -104,6 +111,12 @@ public class LicenseService extends AbstractLifecycleComponent implements Cluste
      */
     private List<ExpirationCallback> expirationCallbacks = new ArrayList<>();
 
+    /**
+     * Which license types are permitted to be uploaded to the cluster
+     * @see #ALLOWED_LICENSE_TYPES_SETTING
+     */
+    private final List<License.LicenseType> allowedLicenseTypes;
+
     /**
      * Max number of nodes licensed by generated trial license
      */
@@ -123,6 +136,7 @@ public LicenseService(Settings settings, ClusterService clusterService, Clock cl
         this.clock = clock;
         this.scheduler = new SchedulerEngine(settings, clock);
         this.licenseState = licenseState;
+        this.allowedLicenseTypes = ALLOWED_LICENSE_TYPES_SETTING.get(settings);
         this.operationModeFileWatcher = new OperationModeFileWatcher(resourceWatcherService,
             XPackPlugin.resolveConfigFile(env, "license_mode"), logger,
             () -> updateLicenseState(getLicensesMetaData()));
@@ -196,8 +210,20 @@ public void registerLicense(final PutLicenseRequest request, final ActionListene
         final long now = clock.millis();
         if (!LicenseVerifier.verifyLicense(newLicense) || newLicense.issueDate() > now || newLicense.startDate() > now) {
             listener.onResponse(new PutLicenseResponse(true, LicensesStatus.INVALID));
-        } else if (newLicense.type().equals(License.LicenseType.BASIC.getTypeName())) {
+            return;
+        }
+        final License.LicenseType licenseType;
+        try {
+            licenseType = License.LicenseType.resolve(newLicense);
+        } catch (Exception e) {
+            listener.onFailure(e);
+            return;
+        }
+        if (licenseType == License.LicenseType.BASIC) {
             listener.onFailure(new IllegalArgumentException("Registering basic licenses is not allowed."));
+        } else if (isAllowedLicenseType(licenseType) == false) {
+            listener.onFailure(new IllegalArgumentException(
+                "Registering [" + licenseType.getTypeName() + "] licenses is not allowed on this cluster"));
         } else if (newLicense.expiryDate() < now) {
             listener.onResponse(new PutLicenseResponse(true, LicensesStatus.EXPIRED));
         } else {
@@ -272,6 +298,11 @@ private static boolean licenseIsCompatible(License license, Version version) {
         }
     }
 
+    private boolean isAllowedLicenseType(License.LicenseType type) {
+        logger.debug("Checking license [{}] against allowed license types: {}", type, allowedLicenseTypes);
+        return allowedLicenseTypes.contains(type);
+    }
+
     public static Map<String, String[]> getAckMessages(License newLicense, License currentLicense) {
         Map<String, String[]> acknowledgeMessages = new HashMap<>();
         if (!License.isAutoGeneratedLicense(currentLicense.signature()) // current license is not auto-generated
@@ -574,4 +605,20 @@ private static boolean isProductionMode(Settings settings, DiscoveryNode localNo
     private static boolean isBoundToLoopback(DiscoveryNode localNode) {
         return localNode.getAddress().address().getAddress().isLoopbackAddress();
     }
+
+    private static List<License.LicenseType> getAllowableUploadTypes() {
+        return Stream.of(License.LicenseType.values())
+            .filter(t -> t != License.LicenseType.BASIC)
+            .collect(Collectors.toUnmodifiableList());
+    }
+
+    private static void validateUploadTypesSetting(List<License.LicenseType> value) {
+        if (ALLOWABLE_UPLOAD_TYPES.containsAll(value) == false) {
+            throw new IllegalArgumentException("Invalid value [" +
+                value.stream().map(License.LicenseType::getTypeName).collect(Collectors.joining(",")) +
+                "] for " + ALLOWED_LICENSE_TYPES_SETTING.getKey() + ", allowed values are [" +
+                ALLOWABLE_UPLOAD_TYPES.stream().map(License.LicenseType::getTypeName).collect(Collectors.joining(",")) +
+                "]");
+        }
+    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/OperationModeFileWatcher.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/OperationModeFileWatcher.java
index b8e6446b9f49f..ee08b9f7330cf 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/OperationModeFileWatcher.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/OperationModeFileWatcher.java
@@ -106,7 +106,7 @@ private synchronized void onChange(Path file) {
                     // this UTF-8 conversion is much pickier than java String
                     final String operationMode = new BytesRef(content).utf8ToString();
                     try {
-                        newOperationMode = OperationMode.resolve(operationMode);
+                        newOperationMode = OperationMode.parse(operationMode);
                     } catch (IllegalArgumentException e) {
                         logger.error(
                                 (Supplier<?>) () -> new ParameterizedMessage(
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RemoteClusterLicenseChecker.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RemoteClusterLicenseChecker.java
index 7d5a3b5e9a53d..5de1186767f4b 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RemoteClusterLicenseChecker.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RemoteClusterLicenseChecker.java
@@ -138,7 +138,7 @@ public RemoteClusterLicenseChecker(final Client client, final Predicate<License.
     }
 
     public static boolean isLicensePlatinumOrTrial(final XPackInfoResponse.LicenseInfo licenseInfo) {
-        final License.OperationMode mode = License.OperationMode.resolve(licenseInfo.getMode());
+        final License.OperationMode mode = License.OperationMode.parse(licenseInfo.getMode());
         return mode == License.OperationMode.PLATINUM || mode == License.OperationMode.TRIAL;
     }
 
@@ -168,7 +168,7 @@ public void onResponse(final XPackInfoResponse xPackInfoResponse) {
                     return;
                 }
                 if ((licenseInfo.getStatus() == LicenseStatus.ACTIVE) == false
-                        || predicate.test(License.OperationMode.resolve(licenseInfo.getMode())) == false) {
+                        || predicate.test(License.OperationMode.parse(licenseInfo.getMode())) == false) {
                     listener.onResponse(LicenseCheck.failure(new RemoteClusterLicenseInfo(clusterAlias.get(), licenseInfo)));
                     return;
                 }
@@ -282,7 +282,7 @@ public static String buildErrorMessage(
             final String message = String.format(
                     Locale.ROOT,
                     "the license mode [%s] on cluster [%s] does not enable [%s]",
-                    License.OperationMode.resolve(remoteClusterLicenseInfo.licenseInfo().getMode()),
+                    License.OperationMode.parse(remoteClusterLicenseInfo.licenseInfo().getMode()),
                     remoteClusterLicenseInfo.clusterAlias(),
                     feature);
             error.append(message);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
index cd8064e4c1350..9128f75a0937b 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
@@ -267,6 +267,7 @@ public List<Setting<?>> getSettings() {
         settings.addAll(XPackSettings.getAllSettings());
 
         settings.add(LicenseService.SELF_GENERATED_LICENSE_TYPE);
+        settings.add(LicenseService.ALLOWED_LICENSE_TYPES_SETTING);
 
         // we add the `xpack.version` setting to all internal indices
         settings.add(Setting.simpleString("index.xpack.version", Setting.Property.IndexScope));
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
index 21e145546f8b7..343a520d9b5d3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
@@ -138,7 +138,7 @@ public static TrainedModelConfig.Builder fromXContent(XContentParser parser, boo
             throw new IllegalArgumentException("[" + ESTIMATED_OPERATIONS.getPreferredName() + "] must be greater than or equal to 0");
         }
         this.estimatedOperations = estimatedOperations;
-        this.licenseLevel = License.OperationMode.resolve(ExceptionsHelper.requireNonNull(licenseLevel, LICENSE_LEVEL));
+        this.licenseLevel = License.OperationMode.parse(ExceptionsHelper.requireNonNull(licenseLevel, LICENSE_LEVEL));
     }
 
     public TrainedModelConfig(StreamInput in) throws IOException {
@@ -153,7 +153,7 @@ public TrainedModelConfig(StreamInput in) throws IOException {
         input = new TrainedModelInput(in);
         estimatedHeapMemory = in.readVLong();
         estimatedOperations = in.readVLong();
-        licenseLevel = License.OperationMode.resolve(in.readString());
+        licenseLevel = License.OperationMode.parse(in.readString());
     }
 
     public String getModelId() {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseFIPSTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseFIPSTests.java
index c432a207fcb70..eb357661d50ca 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseFIPSTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseFIPSTests.java
@@ -34,6 +34,11 @@ public void testFIPSCheckWithAllowedLicense() throws Exception {
         licenseService.start();
         PlainActionFuture<PutLicenseResponse> responseFuture = new PlainActionFuture<>();
         licenseService.registerLicense(request, responseFuture);
+        if (responseFuture.isDone()) {
+            // If the future is done, it means request/license validation failed.
+            // In which case, this `actionGet` should throw a more useful exception than the verify below.
+            responseFuture.actionGet();
+        }
         verify(clusterService).submitStateUpdateTask(any(String.class), any(ClusterStateUpdateTask.class));
     }
 
@@ -67,6 +72,11 @@ public void testFIPSCheckWithoutAllowedLicense() throws Exception {
         setInitialState(null, licenseState, settings);
         licenseService.start();
         licenseService.registerLicense(request, responseFuture);
+        if (responseFuture.isDone()) {
+            // If the future is done, it means request/license validation failed.
+            // In which case, this `actionGet` should throw a more useful exception than the verify below.
+            responseFuture.actionGet();
+        }
         verify(clusterService).submitStateUpdateTask(any(String.class), any(ClusterStateUpdateTask.class));
     }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeTests.java
index 648f48ff2ea13..a1fbfbe6c6a41 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeTests.java
@@ -57,7 +57,8 @@ public void testResolveUnknown() {
 
         for (String type : types) {
             try {
-                OperationMode.resolve(type);
+                final License.LicenseType licenseType = License.LicenseType.resolve(type);
+                OperationMode.resolve(licenseType);
 
                 fail(String.format(Locale.ROOT, "[%s] should not be recognized as an operation mode", type));
             }
@@ -69,7 +70,8 @@ public void testResolveUnknown() {
 
     private static void assertResolve(OperationMode expected, String... types) {
         for (String type : types) {
-            assertThat(OperationMode.resolve(type), equalTo(expected));
+            License.LicenseType licenseType = License.LicenseType.resolve(type);
+            assertThat(OperationMode.resolve(licenseType), equalTo(expected));
         }
     }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeUpdateTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeUpdateTests.java
index a69331287918b..20df885261fed 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeUpdateTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeUpdateTests.java
@@ -34,7 +34,7 @@ public void init() throws Exception {
     }
 
     public void testLicenseOperationModeUpdate() throws Exception {
-        String type = randomFrom("trial", "basic", "standard", "gold", "platinum");
+        License.LicenseType type = randomFrom(License.LicenseType.values());
         License license = License.builder()
                 .uid("id")
                 .expiryDate(0)
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseServiceTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseServiceTests.java
index 750b3d67c5f62..b1b22f15c259f 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseServiceTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseServiceTests.java
@@ -6,12 +6,47 @@
 package org.elasticsearch.license;
 
 
+import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.cluster.AckedClusterStateUpdateTask;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateUpdateTask;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentFactory;
+import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.env.TestEnvironment;
+import org.elasticsearch.license.licensor.LicenseSigner;
+import org.elasticsearch.protocol.xpack.license.LicensesStatus;
+import org.elasticsearch.protocol.xpack.license.PutLicenseResponse;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.TestMatchers;
+import org.elasticsearch.watcher.ResourceWatcherService;
+import org.mockito.ArgumentCaptor;
+import org.mockito.Mockito;
 
+import java.io.IOException;
+import java.nio.file.Path;
+import java.time.Clock;
 import java.time.LocalDate;
 import java.time.ZoneOffset;
+import java.util.List;
+import java.util.UUID;
+import java.util.concurrent.TimeUnit;
+import java.util.function.Consumer;
+import java.util.stream.Collectors;
 
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.startsWith;
+import static org.mockito.Matchers.any;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
 
 /**
  * Due to changes in JDK9 where locale data is used from CLDR, the licence message will differ in jdk 8 and jdk9+
@@ -30,4 +65,133 @@ public void testLogExpirationWarning() {
             assertThat(message, startsWith("License [will expire] on [Thursday, November 15, 2018].\n"));
         }
     }
+
+    /**
+     * Tests loading a license when {@link LicenseService#ALLOWED_LICENSE_TYPES_SETTING} is on its default value (all license types)
+     */
+    public void testRegisterLicenseWithoutTypeRestrictions() throws Exception {
+        assertRegisterValidLicense(Settings.EMPTY,
+            randomValueOtherThan(License.LicenseType.BASIC, () -> randomFrom(License.LicenseType.values())));
+    }
+
+    /**
+     * Tests loading a license when {@link LicenseService#ALLOWED_LICENSE_TYPES_SETTING} is set,
+     * and the uploaded license type matches
+     */
+    public void testSuccessfullyRegisterLicenseMatchingTypeRestrictions() throws Exception {
+        final List<License.LicenseType> allowed = randomSubsetOf(
+            randomIntBetween(1, LicenseService.ALLOWABLE_UPLOAD_TYPES.size() - 1), LicenseService.ALLOWABLE_UPLOAD_TYPES);
+        final List<String> allowedNames = allowed.stream().map(License.LicenseType::getTypeName).collect(Collectors.toUnmodifiableList());
+        final Settings settings = Settings.builder()
+            .putList("xpack.license.upload.types", allowedNames)
+            .build();
+        assertRegisterValidLicense(settings, randomFrom(allowed));
+    }
+
+    /**
+     * Tests loading a license when {@link LicenseService#ALLOWED_LICENSE_TYPES_SETTING} is set,
+     * and the uploaded license type does not match
+     */
+    public void testFailToRegisterLicenseNotMatchingTypeRestrictions() throws Exception {
+        final List<License.LicenseType> allowed = randomSubsetOf(
+            randomIntBetween(1, LicenseService.ALLOWABLE_UPLOAD_TYPES.size() - 2), LicenseService.ALLOWABLE_UPLOAD_TYPES);
+        final List<String> allowedNames = allowed.stream().map(License.LicenseType::getTypeName).collect(Collectors.toUnmodifiableList());
+        final Settings settings = Settings.builder()
+            .putList("xpack.license.upload.types", allowedNames)
+            .build();
+        final License.LicenseType notAllowed = randomValueOtherThanMany(
+            test -> allowed.contains(test),
+            () -> randomFrom(LicenseService.ALLOWABLE_UPLOAD_TYPES));
+        assertRegisterDisallowedLicenseType(settings, notAllowed);
+    }
+
+    private void assertRegisterValidLicense(Settings baseSettings, License.LicenseType licenseType) throws IOException {
+        tryRegisterLicense(baseSettings, licenseType,
+            future -> assertThat(future.actionGet().status(), equalTo(LicensesStatus.VALID)));
+    }
+
+    private void assertRegisterDisallowedLicenseType(Settings baseSettings, License.LicenseType licenseType) throws IOException {
+        tryRegisterLicense(baseSettings, licenseType, future -> {
+            final IllegalArgumentException exception = expectThrows(IllegalArgumentException.class, future::actionGet);
+            assertThat(exception, TestMatchers.throwableWithMessage(
+                "Registering [" + licenseType.getTypeName() + "] licenses is not allowed on " + "this cluster"));
+        });
+    }
+
+    private void tryRegisterLicense(Settings baseSettings, License.LicenseType licenseType,
+                                    Consumer<PlainActionFuture<PutLicenseResponse>> assertion) throws IOException {
+        final Settings settings = Settings.builder()
+            .put(baseSettings)
+            .put("path.home", createTempDir())
+            .put("discovery.type", "single-node") // So we skip TLS checks
+            .build();
+
+        final ClusterState clusterState = Mockito.mock(ClusterState.class);
+        Mockito.when(clusterState.metaData()).thenReturn(MetaData.EMPTY_META_DATA);
+
+        final ClusterService clusterService = Mockito.mock(ClusterService.class);
+        Mockito.when(clusterService.state()).thenReturn(clusterState);
+
+        final Clock clock = randomBoolean() ? Clock.systemUTC() : Clock.systemDefaultZone();
+        final Environment env = TestEnvironment.newEnvironment(settings);
+        final ResourceWatcherService resourceWatcherService = Mockito.mock(ResourceWatcherService.class);
+        final XPackLicenseState licenseState = Mockito.mock(XPackLicenseState.class);
+        final LicenseService service = new LicenseService(settings, clusterService, clock, env, resourceWatcherService, licenseState);
+
+        final PutLicenseRequest request = new PutLicenseRequest();
+        request.license(spec(licenseType, TimeValue.timeValueDays(randomLongBetween(1, 1000))), XContentType.JSON);
+        final PlainActionFuture<PutLicenseResponse> future = new PlainActionFuture<>();
+        service.registerLicense(request, future);
+
+        if (future.isDone()) {
+            // If validation failed, the future might be done without calling the updater task.
+            assertion.accept(future);
+        } else {
+            ArgumentCaptor<ClusterStateUpdateTask> taskCaptor = ArgumentCaptor.forClass(ClusterStateUpdateTask.class);
+            verify(clusterService, times(1)).submitStateUpdateTask(any(), taskCaptor.capture());
+
+            final ClusterStateUpdateTask task = taskCaptor.getValue();
+            assertThat(task, instanceOf(AckedClusterStateUpdateTask.class));
+            ((AckedClusterStateUpdateTask) task).onAllNodesAcked(null);
+
+            assertion.accept(future);
+        }
+    }
+
+    private BytesReference spec(License.LicenseType type, TimeValue expires) throws IOException {
+        final License signed = sign(buildLicense(type, expires));
+        return toSpec(signed);
+    }
+
+    private BytesReference toSpec(License license) throws IOException {
+        XContentBuilder builder = XContentFactory.contentBuilder(XContentType.JSON);
+        builder.startObject();
+        builder.startObject("license");
+        license.toInnerXContent(builder, ToXContent.EMPTY_PARAMS);
+        builder.endObject();
+        builder.endObject();
+        builder.flush();
+        return BytesReference.bytes(builder);
+    }
+
+    private License sign(License license) throws IOException {
+        final Path publicKey = getDataPath("/public.key");
+        final Path privateKey = getDataPath("/private.key");
+        final LicenseSigner signer = new LicenseSigner(privateKey, publicKey);
+
+        return signer.sign(license);
+    }
+
+    private License buildLicense(License.LicenseType type, TimeValue expires) {
+        return License.builder()
+            .uid(new UUID(randomLong(), randomLong()).toString())
+            .type(type)
+            .expiryDate(System.currentTimeMillis() + expires.millis())
+            .issuer(randomAlphaOfLengthBetween(5, 60))
+            .issuedTo(randomAlphaOfLengthBetween(5, 60))
+            .issueDate(System.currentTimeMillis() - TimeUnit.MINUTES.toMillis(randomLongBetween(1, 5000)))
+            .maxNodes(randomIntBetween(1, 500))
+            .signature(null)
+            .build();
+    }
 }

From 71a0500d27e4dd3a87fc98e996869d491aecfcae Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Tue, 10 Dec 2019 10:22:53 +0200
Subject: [PATCH 135/686] [ML] Introduce randomize_seed setting for regression
 and classification (#49990)

This adds a new `randomize_seed` for regression and classification.
When not explicitly set, the seed is randomly generated. One can
reuse the seed in a similar job in order to ensure the same docs
are picked for training.
---
 .../client/ml/dataframe/Classification.java   | 27 +++++-
 .../client/ml/dataframe/Regression.java       | 29 +++++--
 .../client/MachineLearningIT.java             |  2 +
 .../MlClientDocumentationIT.java              |  4 +-
 .../ml/dataframe/ClassificationTests.java     |  1 +
 .../ml/put-data-frame-analytics.asciidoc      |  4 +-
 .../apis/dfanalyticsresources.asciidoc        |  4 +
 .../apis/put-dfanalytics.asciidoc             |  4 +-
 docs/reference/ml/ml-shared.asciidoc          |  9 ++
 .../dataframe/DataFrameAnalyticsConfig.java   |  3 +-
 .../dataframe/analyses/BoostedTreeParams.java |  4 +-
 .../ml/dataframe/analyses/Classification.java | 41 +++++++--
 .../ml/dataframe/analyses/Regression.java     | 41 +++++++--
 .../DataFrameAnalyticsConfigTests.java        | 47 ++++++++++-
 .../analyses/ClassificationTests.java         | 84 +++++++++++++++----
 .../dataframe/analyses/RegressionTests.java   | 71 ++++++++++++++--
 .../ml/integration/ClassificationIT.java      | 50 +++++++++--
 ...NativeDataFrameAnalyticsIntegTestCase.java | 22 +++++
 .../xpack/ml/integration/RegressionIT.java    | 41 ++++++++-
 .../TransportPutDataFrameAnalyticsAction.java | 12 +--
 .../CustomProcessorFactory.java               |  4 +-
 .../DatasetSplittingCustomProcessor.java      |  6 +-
 .../DatasetSplittingCustomProcessorTests.java | 10 ++-
 .../test/ml/data_frame_analytics_crud.yml     | 16 ++--
 24 files changed, 460 insertions(+), 76 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Classification.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Classification.java
index d4e7bce5ec442..9d384e6d86786 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Classification.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Classification.java
@@ -49,6 +49,7 @@ public static Builder builder(String dependentVariable) {
     static final ParseField PREDICTION_FIELD_NAME = new ParseField("prediction_field_name");
     static final ParseField TRAINING_PERCENT = new ParseField("training_percent");
     static final ParseField NUM_TOP_CLASSES = new ParseField("num_top_classes");
+    static final ParseField RANDOMIZE_SEED = new ParseField("randomize_seed");
 
     private static final ConstructingObjectParser<Classification, Void> PARSER =
         new ConstructingObjectParser<>(
@@ -63,7 +64,8 @@ public static Builder builder(String dependentVariable) {
                 (Double) a[5],
                 (String) a[6],
                 (Double) a[7],
-                (Integer) a[8]));
+                (Integer) a[8],
+                (Long) a[9]));
 
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), DEPENDENT_VARIABLE);
@@ -75,6 +77,7 @@ public static Builder builder(String dependentVariable) {
         PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), PREDICTION_FIELD_NAME);
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), TRAINING_PERCENT);
         PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), NUM_TOP_CLASSES);
+        PARSER.declareLong(ConstructingObjectParser.optionalConstructorArg(), RANDOMIZE_SEED);
     }
 
     private final String dependentVariable;
@@ -86,10 +89,11 @@ public static Builder builder(String dependentVariable) {
     private final String predictionFieldName;
     private final Double trainingPercent;
     private final Integer numTopClasses;
+    private final Long randomizeSeed;
 
     private Classification(String dependentVariable, @Nullable Double lambda, @Nullable Double gamma, @Nullable Double eta,
                            @Nullable Integer maximumNumberTrees, @Nullable Double featureBagFraction, @Nullable String predictionFieldName,
-                           @Nullable Double trainingPercent, @Nullable Integer numTopClasses) {
+                           @Nullable Double trainingPercent, @Nullable Integer numTopClasses, @Nullable Long randomizeSeed) {
         this.dependentVariable = Objects.requireNonNull(dependentVariable);
         this.lambda = lambda;
         this.gamma = gamma;
@@ -99,6 +103,7 @@ private Classification(String dependentVariable, @Nullable Double lambda, @Nulla
         this.predictionFieldName = predictionFieldName;
         this.trainingPercent = trainingPercent;
         this.numTopClasses = numTopClasses;
+        this.randomizeSeed = randomizeSeed;
     }
 
     @Override
@@ -138,6 +143,10 @@ public Double getTrainingPercent() {
         return trainingPercent;
     }
 
+    public Long getRandomizeSeed() {
+        return randomizeSeed;
+    }
+
     public Integer getNumTopClasses() {
         return numTopClasses;
     }
@@ -167,6 +176,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (trainingPercent != null) {
             builder.field(TRAINING_PERCENT.getPreferredName(), trainingPercent);
         }
+        if (randomizeSeed != null) {
+            builder.field(RANDOMIZE_SEED.getPreferredName(), randomizeSeed);
+        }
         if (numTopClasses != null) {
             builder.field(NUM_TOP_CLASSES.getPreferredName(), numTopClasses);
         }
@@ -177,7 +189,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     @Override
     public int hashCode() {
         return Objects.hash(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, predictionFieldName,
-            trainingPercent, numTopClasses);
+            trainingPercent, randomizeSeed, numTopClasses);
     }
 
     @Override
@@ -193,6 +205,7 @@ public boolean equals(Object o) {
             && Objects.equals(featureBagFraction, that.featureBagFraction)
             && Objects.equals(predictionFieldName, that.predictionFieldName)
             && Objects.equals(trainingPercent, that.trainingPercent)
+            && Objects.equals(randomizeSeed, that.randomizeSeed)
             && Objects.equals(numTopClasses, that.numTopClasses);
     }
 
@@ -211,6 +224,7 @@ public static class Builder {
         private String predictionFieldName;
         private Double trainingPercent;
         private Integer numTopClasses;
+        private Long randomizeSeed;
 
         private Builder(String dependentVariable) {
             this.dependentVariable = Objects.requireNonNull(dependentVariable);
@@ -251,6 +265,11 @@ public Builder setTrainingPercent(Double trainingPercent) {
             return this;
         }
 
+        public Builder setRandomizeSeed(Long randomizeSeed) {
+            this.randomizeSeed = randomizeSeed;
+            return this;
+        }
+
         public Builder setNumTopClasses(Integer numTopClasses) {
             this.numTopClasses = numTopClasses;
             return this;
@@ -258,7 +277,7 @@ public Builder setNumTopClasses(Integer numTopClasses) {
 
         public Classification build() {
             return new Classification(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, predictionFieldName,
-                trainingPercent, numTopClasses);
+                trainingPercent, numTopClasses, randomizeSeed);
         }
     }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Regression.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Regression.java
index 3c1edece6fc16..fa55ee40b27fb 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Regression.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Regression.java
@@ -48,6 +48,7 @@ public static Builder builder(String dependentVariable) {
     static final ParseField FEATURE_BAG_FRACTION = new ParseField("feature_bag_fraction");
     static final ParseField PREDICTION_FIELD_NAME = new ParseField("prediction_field_name");
     static final ParseField TRAINING_PERCENT = new ParseField("training_percent");
+    static final ParseField RANDOMIZE_SEED = new ParseField("randomize_seed");
 
     private static final ConstructingObjectParser<Regression, Void> PARSER =
         new ConstructingObjectParser<>(
@@ -61,7 +62,8 @@ public static Builder builder(String dependentVariable) {
                 (Integer) a[4],
                 (Double) a[5],
                 (String) a[6],
-                (Double) a[7]));
+                (Double) a[7],
+                (Long) a[8]));
 
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), DEPENDENT_VARIABLE);
@@ -72,6 +74,7 @@ public static Builder builder(String dependentVariable) {
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), FEATURE_BAG_FRACTION);
         PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), PREDICTION_FIELD_NAME);
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), TRAINING_PERCENT);
+        PARSER.declareLong(ConstructingObjectParser.optionalConstructorArg(), RANDOMIZE_SEED);
     }
 
     private final String dependentVariable;
@@ -82,10 +85,11 @@ public static Builder builder(String dependentVariable) {
     private final Double featureBagFraction;
     private final String predictionFieldName;
     private final Double trainingPercent;
+    private final Long randomizeSeed;
 
     private Regression(String dependentVariable,  @Nullable Double lambda, @Nullable Double gamma, @Nullable Double eta,
                        @Nullable Integer maximumNumberTrees, @Nullable Double featureBagFraction, @Nullable String predictionFieldName,
-                       @Nullable Double trainingPercent) {
+                       @Nullable Double trainingPercent, @Nullable Long randomizeSeed) {
         this.dependentVariable = Objects.requireNonNull(dependentVariable);
         this.lambda = lambda;
         this.gamma = gamma;
@@ -94,6 +98,7 @@ private Regression(String dependentVariable,  @Nullable Double lambda, @Nullable
         this.featureBagFraction = featureBagFraction;
         this.predictionFieldName = predictionFieldName;
         this.trainingPercent = trainingPercent;
+        this.randomizeSeed = randomizeSeed;
     }
 
     @Override
@@ -133,6 +138,10 @@ public Double getTrainingPercent() {
         return trainingPercent;
     }
 
+    public Long getRandomizeSeed() {
+        return randomizeSeed;
+    }
+
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
@@ -158,6 +167,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (trainingPercent != null) {
             builder.field(TRAINING_PERCENT.getPreferredName(), trainingPercent);
         }
+        if (randomizeSeed != null) {
+            builder.field(RANDOMIZE_SEED.getPreferredName(), randomizeSeed);
+        }
         builder.endObject();
         return builder;
     }
@@ -165,7 +177,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     @Override
     public int hashCode() {
         return Objects.hash(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, predictionFieldName,
-            trainingPercent);
+            trainingPercent, randomizeSeed);
     }
 
     @Override
@@ -180,7 +192,8 @@ public boolean equals(Object o) {
             && Objects.equals(maximumNumberTrees, that.maximumNumberTrees)
             && Objects.equals(featureBagFraction, that.featureBagFraction)
             && Objects.equals(predictionFieldName, that.predictionFieldName)
-            && Objects.equals(trainingPercent, that.trainingPercent);
+            && Objects.equals(trainingPercent, that.trainingPercent)
+            && Objects.equals(randomizeSeed, that.randomizeSeed);
     }
 
     @Override
@@ -197,6 +210,7 @@ public static class Builder {
         private Double featureBagFraction;
         private String predictionFieldName;
         private Double trainingPercent;
+        private Long randomizeSeed;
 
         private Builder(String dependentVariable) {
             this.dependentVariable = Objects.requireNonNull(dependentVariable);
@@ -237,9 +251,14 @@ public Builder setTrainingPercent(Double trainingPercent) {
             return this;
         }
 
+        public Builder setRandomizeSeed(Long randomizeSeed) {
+            this.randomizeSeed = randomizeSeed;
+            return this;
+        }
+
         public Regression build() {
             return new Regression(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, predictionFieldName,
-                trainingPercent);
+                trainingPercent, randomizeSeed);
         }
     }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index 6ed3734831aa2..29e69c5095cbd 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -1291,6 +1291,7 @@ public void testPutDataFrameAnalyticsConfig_GivenRegression() throws Exception {
             .setAnalysis(org.elasticsearch.client.ml.dataframe.Regression.builder("my_dependent_variable")
                 .setPredictionFieldName("my_dependent_variable_prediction")
                 .setTrainingPercent(80.0)
+                .setRandomizeSeed(42L)
                 .build())
             .setDescription("this is a regression")
             .build();
@@ -1326,6 +1327,7 @@ public void testPutDataFrameAnalyticsConfig_GivenClassification() throws Excepti
             .setAnalysis(org.elasticsearch.client.ml.dataframe.Classification.builder("my_dependent_variable")
                 .setPredictionFieldName("my_dependent_variable_prediction")
                 .setTrainingPercent(80.0)
+                .setRandomizeSeed(42L)
                 .setNumTopClasses(1)
                 .build())
             .setDescription("this is a classification")
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
index 1d9a151cf8ae3..13185e221633b 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
@@ -2975,7 +2975,8 @@ public void testPutDataFrameAnalytics() throws Exception {
                 .setFeatureBagFraction(0.4) // <6>
                 .setPredictionFieldName("my_prediction_field_name") // <7>
                 .setTrainingPercent(50.0) // <8>
-                .setNumTopClasses(1) // <9>
+                .setRandomizeSeed(1234L) // <9>
+                .setNumTopClasses(1) // <10>
                 .build();
             // end::put-data-frame-analytics-classification
 
@@ -2988,6 +2989,7 @@ public void testPutDataFrameAnalytics() throws Exception {
                 .setFeatureBagFraction(0.4) // <6>
                 .setPredictionFieldName("my_prediction_field_name") // <7>
                 .setTrainingPercent(50.0) // <8>
+                .setRandomizeSeed(1234L) // <9>
                 .build();
             // end::put-data-frame-analytics-regression
 
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/ClassificationTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/ClassificationTests.java
index 98f060cc8534a..5ef8fdaef5a27 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/ClassificationTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/ClassificationTests.java
@@ -34,6 +34,7 @@ public static Classification randomClassification() {
             .setFeatureBagFraction(randomBoolean() ? null : randomDoubleBetween(0.0, 1.0, false))
             .setPredictionFieldName(randomBoolean() ? null : randomAlphaOfLength(10))
             .setTrainingPercent(randomBoolean() ? null : randomDoubleBetween(1.0, 100.0, true))
+            .setRandomizeSeed(randomBoolean() ? null : randomLong())
             .setNumTopClasses(randomBoolean() ? null : randomIntBetween(0, 10))
             .build();
     }
diff --git a/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc b/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
index 91a97ad604cee..2152eff5c0850 100644
--- a/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
+++ b/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
@@ -119,7 +119,8 @@ include-tagged::{doc-tests-file}[{api}-classification]
 <6> The fraction of features which will be used when selecting a random bag for each candidate split. A double in (0, 1].
 <7> The name of the prediction field in the results object.
 <8> The percentage of training-eligible rows to be used in training. Defaults to 100%.
-<9> The number of top classes to be reported in the results. Defaults to 2.
+<9> The seed to be used by the random generator that picks which rows are used in training.
+<10> The number of top classes to be reported in the results. Defaults to 2.
 
 ===== Regression
 
@@ -138,6 +139,7 @@ include-tagged::{doc-tests-file}[{api}-regression]
 <6> The fraction of features which will be used when selecting a random bag for each candidate split. A double in (0, 1].
 <7> The name of the prediction field in the results object.
 <8> The percentage of training-eligible rows to be used in training. Defaults to 100%.
+<9> The seed to be used by the random generator that picks which rows are used in training.
 
 ==== Analyzed fields
 
diff --git a/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc b/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
index e8ee463c66af7..111953b8321ab 100644
--- a/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
@@ -204,6 +204,8 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=prediction_field_name]
 
 include::{docdir}/ml/ml-shared.asciidoc[tag=training_percent]
 
+include::{docdir}/ml/ml-shared.asciidoc[tag=randomize_seed]
+
 
 [float]
 [[regression-resources-advanced]]
@@ -252,6 +254,8 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=prediction_field_name]
 
 include::{docdir}/ml/ml-shared.asciidoc[tag=training_percent]
 
+include::{docdir}/ml/ml-shared.asciidoc[tag=randomize_seed]
+
 
 [float]
 [[classification-resources-advanced]]
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index 5b0987e41c4bc..123eb6633e37b 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -397,7 +397,8 @@ PUT _ml/data_frame/analytics/student_performance_mathematics_0.3
    {
      "regression": {
        "dependent_variable": "G3",
-       "training_percent": 70  <1>
+       "training_percent": 70,  <1>
+       "randomize_seed": 19673948271  <2>
      }
    }
 }
@@ -406,6 +407,7 @@ PUT _ml/data_frame/analytics/student_performance_mathematics_0.3
 
 <1> The `training_percent` defines the percentage of the data set that will be used 
 for training the model.
+<2> The `randomize_seed` is the seed used to randomly pick which data is used for training.
 
 
 [[ml-put-dfanalytics-example-c]]
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 11e062796afa6..bea970078d06b 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -681,6 +681,15 @@ those that contain arrays) won’t be included in the calculation for used
 percentage. Defaults to `100`.
 end::training_percent[]
 
+tag::randomize_seed[]
+`randomize_seed`::
+(Optional, long) Defines the seed to the random generator that is used to pick
+which documents will be used for training. By default it is randomly generated.
+Set it to a specific value to ensure the same documents are used for training
+assuming other related parameters (e.g. `source`, `analyzed_fields`, etc.) are the same.
+end::randomize_seed[]
+
+
 tag::use-null[]
 Defines whether a new series is used as the null series when there is no value 
 for the by or partition fields. The default value is `false`.
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
index 9fd7f8aa86fcb..1142b5411fb0c 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
@@ -225,7 +225,8 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         builder.field(DEST.getPreferredName(), dest);
 
         builder.startObject(ANALYSIS.getPreferredName());
-        builder.field(analysis.getWriteableName(), analysis);
+        builder.field(analysis.getWriteableName(), analysis,
+            new MapParams(Collections.singletonMap(VERSION.getPreferredName(), version == null ? null : version.toString())));
         builder.endObject();
 
         if (params.paramAsBoolean(ToXContentParams.FOR_INTERNAL_STORAGE, false)) {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
index ed3cff7d73c0c..0f06b08444f53 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
@@ -49,7 +49,7 @@ static void declareFields(AbstractObjectParser<?, Void> parser) {
     private final Integer maximumNumberTrees;
     private final Double featureBagFraction;
 
-    BoostedTreeParams(@Nullable Double lambda,
+    public BoostedTreeParams(@Nullable Double lambda,
                       @Nullable Double gamma,
                       @Nullable Double eta,
                       @Nullable Integer maximumNumberTrees,
@@ -76,7 +76,7 @@ static void declareFields(AbstractObjectParser<?, Void> parser) {
         this.featureBagFraction = featureBagFraction;
     }
 
-    BoostedTreeParams() {
+    public BoostedTreeParams() {
         this(null, null, null, null, null);
     }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
index b4b258ea161fa..cd96b815fc11e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
@@ -5,8 +5,10 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.analyses;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
@@ -35,6 +37,7 @@ public class Classification implements DataFrameAnalysis {
     public static final ParseField PREDICTION_FIELD_NAME = new ParseField("prediction_field_name");
     public static final ParseField NUM_TOP_CLASSES = new ParseField("num_top_classes");
     public static final ParseField TRAINING_PERCENT = new ParseField("training_percent");
+    public static final ParseField RANDOMIZE_SEED = new ParseField("randomize_seed");
 
     private static final ConstructingObjectParser<Classification, Void> LENIENT_PARSER = createParser(true);
     private static final ConstructingObjectParser<Classification, Void> STRICT_PARSER = createParser(false);
@@ -48,12 +51,14 @@ private static ConstructingObjectParser<Classification, Void> createParser(boole
                 new BoostedTreeParams((Double) a[1], (Double) a[2], (Double) a[3], (Integer) a[4], (Double) a[5]),
                 (String) a[6],
                 (Integer) a[7],
-                (Double) a[8]));
+                (Double) a[8],
+                (Long) a[9]));
         parser.declareString(constructorArg(), DEPENDENT_VARIABLE);
         BoostedTreeParams.declareFields(parser);
         parser.declareString(optionalConstructorArg(), PREDICTION_FIELD_NAME);
         parser.declareInt(optionalConstructorArg(), NUM_TOP_CLASSES);
         parser.declareDouble(optionalConstructorArg(), TRAINING_PERCENT);
+        parser.declareLong(optionalConstructorArg(), RANDOMIZE_SEED);
         return parser;
     }
 
@@ -82,12 +87,14 @@ public static Classification fromXContent(XContentParser parser, boolean ignoreU
     private final String predictionFieldName;
     private final int numTopClasses;
     private final double trainingPercent;
+    private final long randomizeSeed;
 
     public Classification(String dependentVariable,
                           BoostedTreeParams boostedTreeParams,
                           @Nullable String predictionFieldName,
                           @Nullable Integer numTopClasses,
-                          @Nullable Double trainingPercent) {
+                          @Nullable Double trainingPercent,
+                          @Nullable Long randomizeSeed) {
         if (numTopClasses != null && (numTopClasses < 0 || numTopClasses > 1000)) {
             throw ExceptionsHelper.badRequestException("[{}] must be an integer in [0, 1000]", NUM_TOP_CLASSES.getPreferredName());
         }
@@ -99,10 +106,11 @@ public Classification(String dependentVariable,
         this.predictionFieldName = predictionFieldName == null ? dependentVariable + "_prediction" : predictionFieldName;
         this.numTopClasses = numTopClasses == null ? DEFAULT_NUM_TOP_CLASSES : numTopClasses;
         this.trainingPercent = trainingPercent == null ? 100.0 : trainingPercent;
+        this.randomizeSeed = randomizeSeed == null ? Randomness.get().nextLong() : randomizeSeed;
     }
 
     public Classification(String dependentVariable) {
-        this(dependentVariable, new BoostedTreeParams(), null, null, null);
+        this(dependentVariable, new BoostedTreeParams(), null, null, null, null);
     }
 
     public Classification(StreamInput in) throws IOException {
@@ -111,12 +119,21 @@ public Classification(StreamInput in) throws IOException {
         predictionFieldName = in.readOptionalString();
         numTopClasses = in.readOptionalVInt();
         trainingPercent = in.readDouble();
+        if (in.getVersion().onOrAfter(Version.CURRENT)) {
+            randomizeSeed = in.readOptionalLong();
+        } else {
+            randomizeSeed = Randomness.get().nextLong();
+        }
     }
 
     public String getDependentVariable() {
         return dependentVariable;
     }
 
+    public BoostedTreeParams getBoostedTreeParams() {
+        return boostedTreeParams;
+    }
+
     public String getPredictionFieldName() {
         return predictionFieldName;
     }
@@ -129,6 +146,11 @@ public double getTrainingPercent() {
         return trainingPercent;
     }
 
+    @Nullable
+    public Long getRandomizeSeed() {
+        return randomizeSeed;
+    }
+
     @Override
     public String getWriteableName() {
         return NAME.getPreferredName();
@@ -141,10 +163,15 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeOptionalString(predictionFieldName);
         out.writeOptionalVInt(numTopClasses);
         out.writeDouble(trainingPercent);
+        if (out.getVersion().onOrAfter(Version.CURRENT)) {
+            out.writeOptionalLong(randomizeSeed);
+        }
     }
 
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        Version version = Version.fromString(params.param("version", Version.CURRENT.toString()));
+
         builder.startObject();
         builder.field(DEPENDENT_VARIABLE.getPreferredName(), dependentVariable);
         boostedTreeParams.toXContent(builder, params);
@@ -153,6 +180,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             builder.field(PREDICTION_FIELD_NAME.getPreferredName(), predictionFieldName);
         }
         builder.field(TRAINING_PERCENT.getPreferredName(), trainingPercent);
+        if (version.onOrAfter(Version.CURRENT)) {
+            builder.field(RANDOMIZE_SEED.getPreferredName(), randomizeSeed);
+        }
         builder.endObject();
         return builder;
     }
@@ -238,11 +268,12 @@ public boolean equals(Object o) {
             && Objects.equals(boostedTreeParams, that.boostedTreeParams)
             && Objects.equals(predictionFieldName, that.predictionFieldName)
             && Objects.equals(numTopClasses, that.numTopClasses)
-            && trainingPercent == that.trainingPercent;
+            && trainingPercent == that.trainingPercent
+            && randomizeSeed == that.randomizeSeed;
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(dependentVariable, boostedTreeParams, predictionFieldName, numTopClasses, trainingPercent);
+        return Objects.hash(dependentVariable, boostedTreeParams, predictionFieldName, numTopClasses, trainingPercent, randomizeSeed);
     }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
index 01388f01d807c..dd8f6a91272c2 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
@@ -5,8 +5,10 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.analyses;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
@@ -32,6 +34,7 @@ public class Regression implements DataFrameAnalysis {
     public static final ParseField DEPENDENT_VARIABLE = new ParseField("dependent_variable");
     public static final ParseField PREDICTION_FIELD_NAME = new ParseField("prediction_field_name");
     public static final ParseField TRAINING_PERCENT = new ParseField("training_percent");
+    public static final ParseField RANDOMIZE_SEED = new ParseField("randomize_seed");
 
     private static final ConstructingObjectParser<Regression, Void> LENIENT_PARSER = createParser(true);
     private static final ConstructingObjectParser<Regression, Void> STRICT_PARSER = createParser(false);
@@ -44,11 +47,13 @@ private static ConstructingObjectParser<Regression, Void> createParser(boolean l
                 (String) a[0],
                 new BoostedTreeParams((Double) a[1], (Double) a[2], (Double) a[3], (Integer) a[4], (Double) a[5]),
                 (String) a[6],
-                (Double) a[7]));
+                (Double) a[7],
+                (Long) a[8]));
         parser.declareString(constructorArg(), DEPENDENT_VARIABLE);
         BoostedTreeParams.declareFields(parser);
         parser.declareString(optionalConstructorArg(), PREDICTION_FIELD_NAME);
         parser.declareDouble(optionalConstructorArg(), TRAINING_PERCENT);
+        parser.declareLong(optionalConstructorArg(), RANDOMIZE_SEED);
         return parser;
     }
 
@@ -60,11 +65,13 @@ public static Regression fromXContent(XContentParser parser, boolean ignoreUnkno
     private final BoostedTreeParams boostedTreeParams;
     private final String predictionFieldName;
     private final double trainingPercent;
+    private final long randomizeSeed;
 
     public Regression(String dependentVariable,
                       BoostedTreeParams boostedTreeParams,
                       @Nullable String predictionFieldName,
-                      @Nullable Double trainingPercent) {
+                      @Nullable Double trainingPercent,
+                      @Nullable Long randomizeSeed) {
         if (trainingPercent != null && (trainingPercent < 1.0 || trainingPercent > 100.0)) {
             throw ExceptionsHelper.badRequestException("[{}] must be a double in [1, 100]", TRAINING_PERCENT.getPreferredName());
         }
@@ -72,10 +79,11 @@ public Regression(String dependentVariable,
         this.boostedTreeParams = ExceptionsHelper.requireNonNull(boostedTreeParams, BoostedTreeParams.NAME);
         this.predictionFieldName = predictionFieldName == null ? dependentVariable + "_prediction" : predictionFieldName;
         this.trainingPercent = trainingPercent == null ? 100.0 : trainingPercent;
+        this.randomizeSeed = randomizeSeed == null ? Randomness.get().nextLong() : randomizeSeed;
     }
 
     public Regression(String dependentVariable) {
-        this(dependentVariable, new BoostedTreeParams(), null, null);
+        this(dependentVariable, new BoostedTreeParams(), null, null, null);
     }
 
     public Regression(StreamInput in) throws IOException {
@@ -83,12 +91,21 @@ public Regression(StreamInput in) throws IOException {
         boostedTreeParams = new BoostedTreeParams(in);
         predictionFieldName = in.readOptionalString();
         trainingPercent = in.readDouble();
+        if (in.getVersion().onOrAfter(Version.CURRENT)) {
+            randomizeSeed = in.readOptionalLong();
+        } else {
+            randomizeSeed = Randomness.get().nextLong();
+        }
     }
 
     public String getDependentVariable() {
         return dependentVariable;
     }
 
+    public BoostedTreeParams getBoostedTreeParams() {
+        return boostedTreeParams;
+    }
+
     public String getPredictionFieldName() {
         return predictionFieldName;
     }
@@ -97,6 +114,11 @@ public double getTrainingPercent() {
         return trainingPercent;
     }
 
+    @Nullable
+    public Long getRandomizeSeed() {
+        return randomizeSeed;
+    }
+
     @Override
     public String getWriteableName() {
         return NAME.getPreferredName();
@@ -108,10 +130,15 @@ public void writeTo(StreamOutput out) throws IOException {
         boostedTreeParams.writeTo(out);
         out.writeOptionalString(predictionFieldName);
         out.writeDouble(trainingPercent);
+        if (out.getVersion().onOrAfter(Version.CURRENT)) {
+            out.writeOptionalLong(randomizeSeed);
+        }
     }
 
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        Version version = Version.fromString(params.param("version", Version.CURRENT.toString()));
+
         builder.startObject();
         builder.field(DEPENDENT_VARIABLE.getPreferredName(), dependentVariable);
         boostedTreeParams.toXContent(builder, params);
@@ -119,6 +146,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             builder.field(PREDICTION_FIELD_NAME.getPreferredName(), predictionFieldName);
         }
         builder.field(TRAINING_PERCENT.getPreferredName(), trainingPercent);
+        if (version.onOrAfter(Version.CURRENT)) {
+            builder.field(RANDOMIZE_SEED.getPreferredName(), randomizeSeed);
+        }
         builder.endObject();
         return builder;
     }
@@ -177,11 +207,12 @@ public boolean equals(Object o) {
         return Objects.equals(dependentVariable, that.dependentVariable)
             && Objects.equals(boostedTreeParams, that.boostedTreeParams)
             && Objects.equals(predictionFieldName, that.predictionFieldName)
-            && trainingPercent == that.trainingPercent;
+            && trainingPercent == that.trainingPercent
+            && randomizeSeed == randomizeSeed;
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(dependentVariable, boostedTreeParams, predictionFieldName, trainingPercent);
+        return Objects.hash(dependentVariable, boostedTreeParams, predictionFieldName, trainingPercent, randomizeSeed);
     }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
index d6b2c077388e3..880bea8884658 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.Version;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -20,17 +21,20 @@
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentParseException;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.query.MatchAllQueryBuilder;
 import org.elasticsearch.search.SearchModule;
 import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.MlDataFrameAnalysisNamedXContentProvider;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.OutlierDetectionTests;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
 import org.elasticsearch.xpack.core.ml.utils.ToXContentParams;
 import org.junit.Before;
 
@@ -42,10 +46,13 @@
 import java.util.List;
 import java.util.Map;
 
-import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasEntry;
 import static org.hamcrest.Matchers.hasSize;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.startsWith;
 
 public class DataFrameAnalyticsConfigTests extends AbstractSerializingTestCase<DataFrameAnalyticsConfig> {
@@ -339,6 +346,44 @@ public void testPreventVersionInjection() throws IOException {
         }
     }
 
+    public void testToXContent_GivenAnalysisWithRandomizeSeedAndVersionIsCurrent() throws IOException {
+        Regression regression = new Regression("foo");
+        assertThat(regression.getRandomizeSeed(), is(notNullValue()));
+
+        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
+            .setVersion(Version.CURRENT)
+            .setId("test_config")
+            .setSource(new DataFrameAnalyticsSource(new String[] {"source_index"}, null, null))
+            .setDest(new DataFrameAnalyticsDest("dest_index", null))
+            .setAnalysis(regression)
+            .build();
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            config.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            String json = Strings.toString(builder);
+            assertThat(json, containsString("randomize_seed"));
+        }
+    }
+
+    public void testToXContent_GivenAnalysisWithRandomizeSeedAndVersionIsBeforeItWasIntroduced() throws IOException {
+        Regression regression = new Regression("foo");
+        assertThat(regression.getRandomizeSeed(), is(notNullValue()));
+
+        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
+            .setVersion(Version.V_7_5_0)
+            .setId("test_config")
+            .setSource(new DataFrameAnalyticsSource(new String[] {"source_index"}, null, null))
+            .setDest(new DataFrameAnalyticsDest("dest_index", null))
+            .setAnalysis(regression)
+            .build();
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            config.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            String json = Strings.toString(builder);
+            assertThat(json, not(containsString("randomize_seed")));
+        }
+    }
+
     private static void assertTooSmall(ElasticsearchStatusException e) {
         assertThat(e.getMessage(), startsWith("model_memory_limit must be at least 1kb."));
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
index 61d6b4dfe3f7a..8308ef8dad289 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
@@ -6,20 +6,28 @@
 package org.elasticsearch.xpack.core.ml.dataframe.analyses;
 
 import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.Version;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.mapper.BooleanFieldMapper;
 import org.elasticsearch.index.mapper.KeywordFieldMapper;
 import org.elasticsearch.index.mapper.NumberFieldMapper;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 
 import java.io.IOException;
+import java.util.Collections;
 import java.util.Map;
 import java.util.Set;
 
+import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.nullValue;
 
 public class ClassificationTests extends AbstractSerializingTestCase<Classification> {
@@ -42,7 +50,9 @@ public static Classification createRandom() {
         String predictionFieldName = randomBoolean() ? null : randomAlphaOfLength(10);
         Integer numTopClasses = randomBoolean() ? null : randomIntBetween(0, 1000);
         Double trainingPercent = randomBoolean() ? null : randomDoubleBetween(1.0, 100.0, true);
-        return new Classification(dependentVariableName, boostedTreeParams, predictionFieldName, numTopClasses, trainingPercent);
+        Long randomizeSeed = randomBoolean() ? null : randomLong();
+        return new Classification(dependentVariableName, boostedTreeParams, predictionFieldName, numTopClasses, trainingPercent,
+            randomizeSeed);
     }
 
     @Override
@@ -52,71 +62,71 @@ protected Writeable.Reader<Classification> instanceReader() {
 
     public void testConstructor_GivenTrainingPercentIsLessThanOne() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 0.999));
+            () -> new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 0.999, randomLong()));
 
         assertThat(e.getMessage(), equalTo("[training_percent] must be a double in [1, 100]"));
     }
 
     public void testConstructor_GivenTrainingPercentIsGreaterThan100() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 100.0001));
+            () -> new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 100.0001, randomLong()));
 
         assertThat(e.getMessage(), equalTo("[training_percent] must be a double in [1, 100]"));
     }
 
     public void testConstructor_GivenNumTopClassesIsLessThanZero() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new Classification("foo", BOOSTED_TREE_PARAMS, "result", -1, 1.0));
+            () -> new Classification("foo", BOOSTED_TREE_PARAMS, "result", -1, 1.0, randomLong()));
 
         assertThat(e.getMessage(), equalTo("[num_top_classes] must be an integer in [0, 1000]"));
     }
 
     public void testConstructor_GivenNumTopClassesIsGreaterThan1000() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new Classification("foo", BOOSTED_TREE_PARAMS, "result", 1001, 1.0));
+            () -> new Classification("foo", BOOSTED_TREE_PARAMS, "result", 1001, 1.0, randomLong()));
 
         assertThat(e.getMessage(), equalTo("[num_top_classes] must be an integer in [0, 1000]"));
     }
 
     public void testGetPredictionFieldName() {
-        Classification classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 50.0);
+        Classification classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 50.0, randomLong());
         assertThat(classification.getPredictionFieldName(), equalTo("result"));
 
-        classification = new Classification("foo", BOOSTED_TREE_PARAMS, null, 3, 50.0);
+        classification = new Classification("foo", BOOSTED_TREE_PARAMS, null, 3, 50.0, randomLong());
         assertThat(classification.getPredictionFieldName(), equalTo("foo_prediction"));
     }
 
     public void testGetNumTopClasses() {
-        Classification classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 7, 1.0);
+        Classification classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 7, 1.0, randomLong());
         assertThat(classification.getNumTopClasses(), equalTo(7));
 
         // Boundary condition: num_top_classes == 0
-        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 0, 1.0);
+        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 0, 1.0, randomLong());
         assertThat(classification.getNumTopClasses(), equalTo(0));
 
         // Boundary condition: num_top_classes == 1000
-        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 1000, 1.0);
+        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 1000, 1.0, randomLong());
         assertThat(classification.getNumTopClasses(), equalTo(1000));
 
         // num_top_classes == null, default applied
-        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", null, 1.0);
+        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", null, 1.0, randomLong());
         assertThat(classification.getNumTopClasses(), equalTo(2));
     }
 
     public void testGetTrainingPercent() {
-        Classification classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 50.0);
+        Classification classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 50.0, randomLong());
         assertThat(classification.getTrainingPercent(), equalTo(50.0));
 
         // Boundary condition: training_percent == 1.0
-        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 1.0);
+        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 1.0, randomLong());
         assertThat(classification.getTrainingPercent(), equalTo(1.0));
 
         // Boundary condition: training_percent == 100.0
-        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 100.0);
+        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, 100.0, randomLong());
         assertThat(classification.getTrainingPercent(), equalTo(100.0));
 
         // training_percent == null, default applied
-        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, null);
+        classification = new Classification("foo", BOOSTED_TREE_PARAMS, "result", 3, null, randomLong());
         assertThat(classification.getTrainingPercent(), equalTo(100.0));
     }
 
@@ -155,4 +165,48 @@ public void testGetParams() {
     public void testFieldCardinalityLimitsIsNonNull() {
         assertThat(createTestInstance().getFieldCardinalityLimits(), is(not(nullValue())));
     }
+
+    public void testToXContent_GivenVersionBeforeRandomizeSeedWasIntroduced() throws IOException {
+        Classification classification = createRandom();
+        assertThat(classification.getRandomizeSeed(), is(notNullValue()));
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            classification.toXContent(builder, new ToXContent.MapParams(Collections.singletonMap("version", "7.5.0")));
+            String json = Strings.toString(builder);
+            assertThat(json, not(containsString("randomize_seed")));
+        }
+    }
+
+    public void testToXContent_GivenVersionAfterRandomizeSeedWasIntroduced() throws IOException {
+        Classification classification = createRandom();
+        assertThat(classification.getRandomizeSeed(), is(notNullValue()));
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            classification.toXContent(builder, new ToXContent.MapParams(Collections.singletonMap("version", Version.CURRENT.toString())));
+            String json = Strings.toString(builder);
+            assertThat(json, containsString("randomize_seed"));
+        }
+    }
+
+    public void testToXContent_GivenVersionIsNull() throws IOException {
+        Classification classification = createRandom();
+        assertThat(classification.getRandomizeSeed(), is(notNullValue()));
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            classification.toXContent(builder, new ToXContent.MapParams(Collections.singletonMap("version", null)));
+            String json = Strings.toString(builder);
+            assertThat(json, containsString("randomize_seed"));
+        }
+    }
+
+    public void testToXContent_GivenEmptyParams() throws IOException {
+        Classification classification = createRandom();
+        assertThat(classification.getRandomizeSeed(), is(notNullValue()));
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            classification.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            String json = Strings.toString(builder);
+            assertThat(json, containsString("randomize_seed"));
+        }
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
index f3d5312280e88..58e19f6ef6a2a 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
@@ -6,16 +6,24 @@
 package org.elasticsearch.xpack.core.ml.dataframe.analyses;
 
 import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.Version;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 
 import java.io.IOException;
+import java.util.Collections;
 import java.util.Map;
 
+import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.nullValue;
 
 public class RegressionTests extends AbstractSerializingTestCase<Regression> {
@@ -37,7 +45,8 @@ public static Regression createRandom() {
         BoostedTreeParams boostedTreeParams = BoostedTreeParamsTests.createRandom();
         String predictionFieldName = randomBoolean() ? null : randomAlphaOfLength(10);
         Double trainingPercent = randomBoolean() ? null : randomDoubleBetween(1.0, 100.0, true);
-        return new Regression(dependentVariableName, boostedTreeParams, predictionFieldName, trainingPercent);
+        Long randomizeSeed = randomBoolean() ? null : randomLong();
+        return new Regression(dependentVariableName, boostedTreeParams, predictionFieldName, trainingPercent, randomizeSeed);
     }
 
     @Override
@@ -47,40 +56,40 @@ protected Writeable.Reader<Regression> instanceReader() {
 
     public void testConstructor_GivenTrainingPercentIsLessThanOne() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new Regression("foo", BOOSTED_TREE_PARAMS, "result", 0.999));
+            () -> new Regression("foo", BOOSTED_TREE_PARAMS, "result", 0.999, randomLong()));
 
         assertThat(e.getMessage(), equalTo("[training_percent] must be a double in [1, 100]"));
     }
 
     public void testConstructor_GivenTrainingPercentIsGreaterThan100() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new Regression("foo", BOOSTED_TREE_PARAMS, "result", 100.0001));
+            () -> new Regression("foo", BOOSTED_TREE_PARAMS, "result", 100.0001, randomLong()));
 
         assertThat(e.getMessage(), equalTo("[training_percent] must be a double in [1, 100]"));
     }
 
     public void testGetPredictionFieldName() {
-        Regression regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", 50.0);
+        Regression regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", 50.0, randomLong());
         assertThat(regression.getPredictionFieldName(), equalTo("result"));
 
-        regression = new Regression("foo", BOOSTED_TREE_PARAMS, null, 50.0);
+        regression = new Regression("foo", BOOSTED_TREE_PARAMS, null, 50.0, randomLong());
         assertThat(regression.getPredictionFieldName(), equalTo("foo_prediction"));
     }
 
     public void testGetTrainingPercent() {
-        Regression regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", 50.0);
+        Regression regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", 50.0, randomLong());
         assertThat(regression.getTrainingPercent(), equalTo(50.0));
 
         // Boundary condition: training_percent == 1.0
-        regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", 1.0);
+        regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", 1.0, randomLong());
         assertThat(regression.getTrainingPercent(), equalTo(1.0));
 
         // Boundary condition: training_percent == 100.0
-        regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", 100.0);
+        regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", 100.0, randomLong());
         assertThat(regression.getTrainingPercent(), equalTo(100.0));
 
         // training_percent == null, default applied
-        regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", null);
+        regression = new Regression("foo", BOOSTED_TREE_PARAMS, "result", null, randomLong());
         assertThat(regression.getTrainingPercent(), equalTo(100.0));
     }
 
@@ -100,4 +109,48 @@ public void testGetStateDocId() {
         String randomId = randomAlphaOfLength(10);
         assertThat(regression.getStateDocId(randomId), equalTo(randomId + "_regression_state#1"));
     }
+
+    public void testToXContent_GivenVersionBeforeRandomizeSeedWasIntroduced() throws IOException {
+        Regression regression = createRandom();
+        assertThat(regression.getRandomizeSeed(), is(notNullValue()));
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            regression.toXContent(builder, new ToXContent.MapParams(Collections.singletonMap("version", "7.5.0")));
+            String json = Strings.toString(builder);
+            assertThat(json, not(containsString("randomize_seed")));
+        }
+    }
+
+    public void testToXContent_GivenVersionAfterRandomizeSeedWasIntroduced() throws IOException {
+        Regression regression = createRandom();
+        assertThat(regression.getRandomizeSeed(), is(notNullValue()));
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            regression.toXContent(builder, new ToXContent.MapParams(Collections.singletonMap("version", Version.CURRENT.toString())));
+            String json = Strings.toString(builder);
+            assertThat(json, containsString("randomize_seed"));
+        }
+    }
+
+    public void testToXContent_GivenVersionIsNull() throws IOException {
+        Regression regression = createRandom();
+        assertThat(regression.getRandomizeSeed(), is(notNullValue()));
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            regression.toXContent(builder, new ToXContent.MapParams(Collections.singletonMap("version", null)));
+            String json = Strings.toString(builder);
+            assertThat(json, containsString("randomize_seed"));
+        }
+    }
+
+    public void testToXContent_GivenEmptyParams() throws IOException {
+        Regression regression = createRandom();
+        assertThat(regression.getRandomizeSeed(), is(notNullValue()));
+
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            regression.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            String json = Strings.toString(builder);
+            assertThat(json, containsString("randomize_seed"));
+        }
+    }
 }
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index f5db9ae690a96..e7c0ccd0e0554 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -20,6 +20,7 @@
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParams;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParamsTests;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy;
@@ -31,6 +32,7 @@
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 
 import static java.util.stream.Collectors.toList;
 import static org.hamcrest.Matchers.allOf;
@@ -158,7 +160,7 @@ public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
                 sourceIndex,
                 destIndex,
                 null,
-                new Classification(dependentVariable, BoostedTreeParamsTests.createRandom(), null, numTopClasses, 50.0));
+                new Classification(dependentVariable, BoostedTreeParamsTests.createRandom(), null, numTopClasses, 50.0, null));
         registerAnalytics(config);
         putAnalytics(config);
 
@@ -269,6 +271,44 @@ public void testDependentVariableCardinalityTooHighButWithQueryMakesItWithinRang
         assertProgress(jobId, 100, 100, 100, 100);
     }
 
+    public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exception {
+        String sourceIndex = "classification_two_jobs_with_same_randomize_seed_source";
+        String dependentVariable = KEYWORD_FIELD;
+        indexData(sourceIndex, 10, 0, dependentVariable);
+
+        String firstJobId = "classification_two_jobs_with_same_randomize_seed_1";
+        String firstJobDestIndex = firstJobId + "_dest";
+
+        BoostedTreeParams boostedTreeParams = new BoostedTreeParams(1.0, 1.0, 1.0, 1, 1.0);
+
+        DataFrameAnalyticsConfig firstJob = buildAnalytics(firstJobId, sourceIndex, firstJobDestIndex, null,
+            new Classification(dependentVariable, boostedTreeParams, null, 1, 50.0, null));
+        registerAnalytics(firstJob);
+        putAnalytics(firstJob);
+
+        String secondJobId = "classification_two_jobs_with_same_randomize_seed_2";
+        String secondJobDestIndex = secondJobId + "_dest";
+
+        long randomizeSeed = ((Classification) firstJob.getAnalysis()).getRandomizeSeed();
+        DataFrameAnalyticsConfig secondJob = buildAnalytics(secondJobId, sourceIndex, secondJobDestIndex, null,
+            new Classification(dependentVariable, boostedTreeParams, null, 1, 50.0, randomizeSeed));
+
+        registerAnalytics(secondJob);
+        putAnalytics(secondJob);
+
+        // Let's run both jobs in parallel and wait until they are finished
+        startAnalytics(firstJobId);
+        startAnalytics(secondJobId);
+        waitUntilAnalyticsIsStopped(firstJobId);
+        waitUntilAnalyticsIsStopped(secondJobId);
+
+        // Now we compare they both used the same training rows
+        Set<String> firstRunTrainingRowsIds = getTrainingRowsIds(firstJobDestIndex);
+        Set<String> secondRunTrainingRowsIds = getTrainingRowsIds(secondJobDestIndex);
+
+        assertThat(secondRunTrainingRowsIds, equalTo(firstRunTrainingRowsIds));
+    }
+
     private void initialize(String jobId) {
         this.jobId = jobId;
         this.sourceIndex = jobId + "_source_index";
@@ -340,10 +380,10 @@ private static Map<String, Object> getMlResultsObjectFromDestDoc(Map<String, Obj
 
     @SuppressWarnings("unchecked")
     private static <T> void assertTopClasses(
-            Map<String, Object> resultsObject,
-            int numTopClasses,
-            String dependentVariable,
-            List<T> dependentVariableValues) {
+        Map<String, Object> resultsObject,
+    int numTopClasses,
+    String dependentVariable,
+    List<T> dependentVariableValues) {
         assertThat(resultsObject.containsKey("top_classes"), is(true));
         List<Map<String, Object>> topClasses = (List<Map<String, Object>>) resultsObject.get("top_classes");
         assertThat(topClasses, hasSize(numTopClasses));
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
index 29ef54d3f7524..99223247d7305 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
@@ -18,6 +18,7 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.xpack.core.ml.action.DeleteDataFrameAnalyticsAction;
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction;
@@ -45,7 +46,10 @@
 
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.HashSet;
 import java.util.List;
+import java.util.Map;
+import java.util.Set;
 import java.util.concurrent.TimeUnit;
 import java.util.stream.Collectors;
 
@@ -252,4 +256,22 @@ private static List<String> fetchAllAuditMessages(String dataFrameAnalyticsId) {
             .map(hit -> (String) hit.getSourceAsMap().get("message"))
             .collect(Collectors.toList());
     }
+
+    protected static Set<String> getTrainingRowsIds(String index) {
+        Set<String> trainingRowsIds = new HashSet<>();
+        SearchResponse hits = client().prepareSearch(index).get();
+        for (SearchHit hit : hits.getHits()) {
+            Map<String, Object> sourceAsMap = hit.getSourceAsMap();
+            assertThat(sourceAsMap.containsKey("ml"), is(true));
+            @SuppressWarnings("unchecked")
+            Map<String, Object> resultsObject = (Map<String, Object>) sourceAsMap.get("ml");
+
+            assertThat(resultsObject.containsKey("is_training"), is(true));
+            if (Boolean.TRUE.equals(resultsObject.get("is_training"))) {
+                trainingRowsIds.add(hit.getId());
+            }
+        }
+        assertThat(trainingRowsIds.isEmpty(), is(false));
+        return trainingRowsIds;
+    }
 }
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
index 71ea840c53ea8..84d408daacc61 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
@@ -16,6 +16,7 @@
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsState;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParams;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParamsTests;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
@@ -25,6 +26,7 @@
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 
 import static org.hamcrest.Matchers.anyOf;
 import static org.hamcrest.Matchers.equalTo;
@@ -139,7 +141,7 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty() throws Exception
                 sourceIndex,
                 destIndex,
                 null,
-                new Regression(DEPENDENT_VARIABLE_FIELD, BoostedTreeParamsTests.createRandom(), null, 50.0));
+                new Regression(DEPENDENT_VARIABLE_FIELD, BoostedTreeParamsTests.createRandom(), null, 50.0, null));
         registerAnalytics(config);
         putAnalytics(config);
 
@@ -235,6 +237,43 @@ public void testStopAndRestart() throws Exception {
         assertInferenceModelPersisted(jobId);
     }
 
+    public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exception {
+        String sourceIndex = "regression_two_jobs_with_same_randomize_seed_source";
+        indexData(sourceIndex, 10, 0);
+
+        String firstJobId = "regression_two_jobs_with_same_randomize_seed_1";
+        String firstJobDestIndex = firstJobId + "_dest";
+
+        BoostedTreeParams boostedTreeParams = new BoostedTreeParams(1.0, 1.0, 1.0, 1, 1.0);
+
+        DataFrameAnalyticsConfig firstJob = buildAnalytics(firstJobId, sourceIndex, firstJobDestIndex, null,
+            new Regression(DEPENDENT_VARIABLE_FIELD, boostedTreeParams, null, 50.0, null));
+        registerAnalytics(firstJob);
+        putAnalytics(firstJob);
+
+        String secondJobId = "regression_two_jobs_with_same_randomize_seed_2";
+        String secondJobDestIndex = secondJobId + "_dest";
+
+        long randomizeSeed = ((Regression) firstJob.getAnalysis()).getRandomizeSeed();
+        DataFrameAnalyticsConfig secondJob = buildAnalytics(secondJobId, sourceIndex, secondJobDestIndex, null,
+            new Regression(DEPENDENT_VARIABLE_FIELD, boostedTreeParams, null, 50.0, randomizeSeed));
+
+        registerAnalytics(secondJob);
+        putAnalytics(secondJob);
+
+        // Let's run both jobs in parallel and wait until they are finished
+        startAnalytics(firstJobId);
+        startAnalytics(secondJobId);
+        waitUntilAnalyticsIsStopped(firstJobId);
+        waitUntilAnalyticsIsStopped(secondJobId);
+
+        // Now we compare they both used the same training rows
+        Set<String> firstRunTrainingRowsIds = getTrainingRowsIds(firstJobDestIndex);
+        Set<String> secondRunTrainingRowsIds = getTrainingRowsIds(secondJobDestIndex);
+
+        assertThat(secondRunTrainingRowsIds, equalTo(firstRunTrainingRowsIds));
+    }
+
     private void initialize(String jobId) {
         this.jobId = jobId;
         this.sourceIndex = jobId + "_source_index";
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutDataFrameAnalyticsAction.java
index 2884cd331779e..1cbed7ed76613 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutDataFrameAnalyticsAction.java
@@ -111,7 +111,7 @@ protected ClusterBlockException checkBlock(PutDataFrameAnalyticsAction.Request r
     protected void masterOperation(Task task, PutDataFrameAnalyticsAction.Request request, ClusterState state,
                                    ActionListener<PutDataFrameAnalyticsAction.Response> listener) {
         validateConfig(request.getConfig());
-        DataFrameAnalyticsConfig memoryCappedConfig =
+        DataFrameAnalyticsConfig preparedForPutConfig =
             new DataFrameAnalyticsConfig.Builder(request.getConfig(), maxModelMemoryLimit)
                 .setCreateTime(Instant.now())
                 .setVersion(Version.CURRENT)
@@ -120,11 +120,11 @@ protected void masterOperation(Task task, PutDataFrameAnalyticsAction.Request re
         if (licenseState.isAuthAllowed()) {
             final String username = securityContext.getUser().principal();
             RoleDescriptor.IndicesPrivileges sourceIndexPrivileges = RoleDescriptor.IndicesPrivileges.builder()
-                .indices(memoryCappedConfig.getSource().getIndex())
+                .indices(preparedForPutConfig.getSource().getIndex())
                 .privileges("read")
                 .build();
             RoleDescriptor.IndicesPrivileges destIndexPrivileges = RoleDescriptor.IndicesPrivileges.builder()
-                .indices(memoryCappedConfig.getDest().getIndex())
+                .indices(preparedForPutConfig.getDest().getIndex())
                 .privileges("read", "index", "create_index")
                 .build();
 
@@ -135,16 +135,16 @@ protected void masterOperation(Task task, PutDataFrameAnalyticsAction.Request re
             privRequest.indexPrivileges(sourceIndexPrivileges, destIndexPrivileges);
 
             ActionListener<HasPrivilegesResponse> privResponseListener = ActionListener.wrap(
-                r -> handlePrivsResponse(username, memoryCappedConfig, r, listener),
+                r -> handlePrivsResponse(username, preparedForPutConfig, r, listener),
                 listener::onFailure);
 
             client.execute(HasPrivilegesAction.INSTANCE, privRequest, privResponseListener);
         } else {
             updateDocMappingAndPutConfig(
-                memoryCappedConfig,
+                preparedForPutConfig,
                 threadPool.getThreadContext().getHeaders(),
                 ActionListener.wrap(
-                    indexResponse -> listener.onResponse(new PutDataFrameAnalyticsAction.Response(memoryCappedConfig)),
+                    indexResponse -> listener.onResponse(new PutDataFrameAnalyticsAction.Response(preparedForPutConfig)),
                     listener::onFailure
                 ));
         }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/CustomProcessorFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/CustomProcessorFactory.java
index fd52a3fd8da58..77f0b127a2638 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/CustomProcessorFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/CustomProcessorFactory.java
@@ -24,12 +24,12 @@ public CustomProcessor create(DataFrameAnalysis analysis) {
         if (analysis instanceof Regression) {
             Regression regression = (Regression) analysis;
             return new DatasetSplittingCustomProcessor(
-                fieldNames, regression.getDependentVariable(), regression.getTrainingPercent());
+                fieldNames, regression.getDependentVariable(), regression.getTrainingPercent(), regression.getRandomizeSeed());
         }
         if (analysis instanceof Classification) {
             Classification classification = (Classification) analysis;
             return new DatasetSplittingCustomProcessor(
-                fieldNames, classification.getDependentVariable(), classification.getTrainingPercent());
+                fieldNames, classification.getDependentVariable(), classification.getTrainingPercent(), classification.getRandomizeSeed());
         }
         return row -> {};
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/DatasetSplittingCustomProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/DatasetSplittingCustomProcessor.java
index ed42cf5198854..bf6284aa7a5c8 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/DatasetSplittingCustomProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/DatasetSplittingCustomProcessor.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.ml.dataframe.process.customprocessing;
 
-import org.elasticsearch.common.Randomness;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.util.List;
@@ -23,12 +22,13 @@ class DatasetSplittingCustomProcessor implements CustomProcessor {
 
     private final int dependentVariableIndex;
     private final double trainingPercent;
-    private final Random random = Randomness.get();
+    private final Random random;
     private boolean isFirstRow = true;
 
-    DatasetSplittingCustomProcessor(List<String> fieldNames, String dependentVariable, double trainingPercent) {
+    DatasetSplittingCustomProcessor(List<String> fieldNames, String dependentVariable, double trainingPercent, long randomizeSeed) {
         this.dependentVariableIndex = findDependentVariableIndex(fieldNames, dependentVariable);
         this.trainingPercent = trainingPercent;
+        this.random = new Random(randomizeSeed);
     }
 
     private static int findDependentVariableIndex(List<String> fieldNames, String dependentVariable) {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/DatasetSplittingCustomProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/DatasetSplittingCustomProcessorTests.java
index d5973f8782461..d18adc3dcdb48 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/DatasetSplittingCustomProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/customprocessing/DatasetSplittingCustomProcessorTests.java
@@ -24,6 +24,7 @@ public class DatasetSplittingCustomProcessorTests extends ESTestCase {
     private List<String> fields;
     private int dependentVariableIndex;
     private String dependentVariable;
+    private long randomizeSeed;
 
     @Before
     public void setUpTests() {
@@ -34,10 +35,11 @@ public void setUpTests() {
         }
         dependentVariableIndex = randomIntBetween(0, fieldCount - 1);
         dependentVariable = fields.get(dependentVariableIndex);
+        randomizeSeed = randomLong();
     }
 
     public void testProcess_GivenRowsWithoutDependentVariableValue() {
-        CustomProcessor customProcessor = new DatasetSplittingCustomProcessor(fields, dependentVariable, 50.0);
+        CustomProcessor customProcessor = new DatasetSplittingCustomProcessor(fields, dependentVariable, 50.0, randomizeSeed);
 
         for (int i = 0; i < 100; i++) {
             String[] row = new String[fields.size()];
@@ -55,7 +57,7 @@ public void testProcess_GivenRowsWithoutDependentVariableValue() {
     }
 
     public void testProcess_GivenRowsWithDependentVariableValue_AndTrainingPercentIsHundred() {
-        CustomProcessor customProcessor = new DatasetSplittingCustomProcessor(fields, dependentVariable, 100.0);
+        CustomProcessor customProcessor = new DatasetSplittingCustomProcessor(fields, dependentVariable, 100.0, randomizeSeed);
 
         for (int i = 0; i < 100; i++) {
             String[] row = new String[fields.size()];
@@ -75,7 +77,7 @@ public void testProcess_GivenRowsWithDependentVariableValue_AndTrainingPercentIs
     public void testProcess_GivenRowsWithDependentVariableValue_AndTrainingPercentIsRandom() {
         double trainingPercent = randomDoubleBetween(1.0, 100.0, true);
         double trainingFraction = trainingPercent / 100;
-        CustomProcessor customProcessor = new DatasetSplittingCustomProcessor(fields, dependentVariable, trainingPercent);
+        CustomProcessor customProcessor = new DatasetSplittingCustomProcessor(fields, dependentVariable, trainingPercent, randomizeSeed);
 
         int runCount = 20;
         int rowsCount = 1000;
@@ -121,7 +123,7 @@ public void testProcess_GivenRowsWithDependentVariableValue_AndTrainingPercentIs
     }
 
     public void testProcess_ShouldHaveAtLeastOneTrainingRow() {
-        CustomProcessor customProcessor = new DatasetSplittingCustomProcessor(fields, dependentVariable, 1.0);
+        CustomProcessor customProcessor = new DatasetSplittingCustomProcessor(fields, dependentVariable, 1.0, randomizeSeed);
 
         // We have some non-training rows and then a training row to check
         // we maintain the first training row and not just the first row
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
index a1d78b7444057..4335a50382a94 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
@@ -1456,7 +1456,8 @@ setup:
                 "eta": 0.5,
                 "maximum_number_trees": 400,
                 "feature_bag_fraction": 0.3,
-                "training_percent": 60.3
+                "training_percent": 60.3,
+                "randomize_seed": 42
               }
             }
           }
@@ -1472,7 +1473,8 @@ setup:
       "maximum_number_trees": 400,
       "feature_bag_fraction": 0.3,
       "prediction_field_name": "foo_prediction",
-      "training_percent": 60.3
+      "training_percent": 60.3,
+      "randomize_seed": 42
     }
   }}
   - is_true: create_time
@@ -1796,7 +1798,8 @@ setup:
                 "eta": 0.5,
                 "maximum_number_trees": 400,
                 "feature_bag_fraction": 0.3,
-                "training_percent": 60.3
+                "training_percent": 60.3,
+                "randomize_seed": 24
               }
             }
           }
@@ -1813,6 +1816,7 @@ setup:
       "feature_bag_fraction": 0.3,
       "prediction_field_name": "foo_prediction",
       "training_percent": 60.3,
+      "randomize_seed": 24,
       "num_top_classes": 2
     }
   }}
@@ -1836,7 +1840,8 @@ setup:
             },
             "analysis": {
               "regression": {
-                "dependent_variable": "foo"
+                "dependent_variable": "foo",
+                "randomize_seed": 42
               }
             }
           }
@@ -1848,7 +1853,8 @@ setup:
     "regression":{
       "dependent_variable": "foo",
       "prediction_field_name": "foo_prediction",
-      "training_percent": 100.0
+      "training_percent": 100.0,
+      "randomize_seed": 42
     }
   }}
   - is_true: create_time

From b48df75bfc1dee09b7ba642ccd35401da6391c96 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 29 Nov 2019 14:38:06 +0200
Subject: [PATCH 136/686] [ML] Mute data frame analytics BWC tests

Until #49990 is backported to 7.x
---
 .../test/mixed_cluster/90_ml_data_frame_analytics_crud.yml   | 5 +++++
 .../test/old_cluster/90_ml_data_frame_analytics_crud.yml     | 3 +++
 .../upgraded_cluster/90_ml_data_frame_analytics_crud.yml     | 5 +++++
 3 files changed, 13 insertions(+)

diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
index b0cb91c4c0f5c..8082147160718 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,3 +1,8 @@
+setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
+
 ---
 "Get old outlier_detection job":
 
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
index fe160bba15f23..ba2cf40411672 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,4 +1,7 @@
 setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
 
   - do:
       index:
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
index 28ec80c6373a2..462a1fd76c011 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,3 +1,8 @@
+setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
+
 ---
 "Get old cluster outlier_detection job":
 

From f1234f25ab13d8b2aac48da3b123a2fcbcaeb939 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 10 Dec 2019 09:45:27 +0100
Subject: [PATCH 137/686] Make elasticsearch-node tools custom metadata-aware
 (#48390)

The elasticsearch-node tools allow manipulating the on-disk cluster state. The tool is currently
unaware of plugins and will therefore drop custom metadata from the cluster state once the
state is written out again (as it skips over the custom metadata that it can't read). This commit
preserves unknown customs when editing on-disk metadata through the elasticsearch-node
command-line tools.
---
 .../testclusters/ElasticsearchNode.java       | 12 +--
 .../common/xcontent/XContentBuilder.java      | 19 +++--
 .../cli/EnvironmentAwareCommand.java          | 13 ++-
 .../ElasticsearchNodeCommand.java             |  9 +--
 .../UnsafeBootstrapMasterCommand.java         |  3 +-
 .../cluster/metadata/IndexMetaData.java       |  3 -
 .../cluster/metadata/MetaData.java            | 81 +++++++++++++++----
 .../env/NodeRepurposeCommand.java             |  5 +-
 .../env/OverrideNodeVersionCommand.java       |  3 +-
 .../cluster/metadata/MetaDataTests.java       |  2 +-
 .../metadata/ToAndFromJsonMetaDataTests.java  |  2 +-
 .../gateway/MetaDataStateFormatTests.java     | 51 ++++++++++--
 .../LicensesMetaDataSerializationTests.java   |  2 +-
 .../WatcherMetaDataSerializationTests.java    |  2 +-
 14 files changed, 153 insertions(+), 54 deletions(-)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
index de8e02ed0c7de..2f258733e7575 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
@@ -424,7 +424,7 @@ public synchronized void start() {
 
         if (plugins.isEmpty() == false) {
             logToProcessStdout("Installing " + plugins.size() + " plugins");
-            plugins.forEach(plugin -> runElaticsearchBinScript(
+            plugins.forEach(plugin -> runElasticsearchBinScript(
                 "elasticsearch-plugin",
                 "install", "--batch", plugin.toString())
             );
@@ -432,7 +432,7 @@ public synchronized void start() {
 
         if (getVersion().before("6.3.0") && testDistribution == TestDistribution.DEFAULT) {
             LOGGER.info("emulating the {} flavor for {} by installing x-pack", testDistribution, getVersion());
-            runElaticsearchBinScript(
+            runElasticsearchBinScript(
                 "elasticsearch-plugin",
                 "install", "--batch", "x-pack"
             );
@@ -440,7 +440,7 @@ public synchronized void start() {
 
         if (keystoreSettings.isEmpty() == false || keystoreFiles.isEmpty() == false) {
             logToProcessStdout("Adding " + keystoreSettings.size() + " keystore settings and " + keystoreFiles.size() + " keystore files");
-            runElaticsearchBinScript("elasticsearch-keystore", "create");
+            runElasticsearchBinScript("elasticsearch-keystore", "create");
 
             keystoreSettings.forEach((key, value) ->
                 runElasticsearchBinScriptWithInput(value.toString(), "elasticsearch-keystore", "add", "-x", key)
@@ -452,7 +452,7 @@ public synchronized void start() {
                 if (file.exists() == false) {
                     throw new TestClustersException("supplied keystore file " + file + " does not exist, require for " + this);
                 }
-                runElaticsearchBinScript("elasticsearch-keystore", "add-file", entry.getKey(), file.getAbsolutePath());
+                runElasticsearchBinScript("elasticsearch-keystore", "add-file", entry.getKey(), file.getAbsolutePath());
             }
         }
 
@@ -467,7 +467,7 @@ public synchronized void start() {
         if (credentials.isEmpty() == false) {
             logToProcessStdout("Setting up " + credentials.size() + " users");
 
-            credentials.forEach(paramMap -> runElaticsearchBinScript(
+            credentials.forEach(paramMap -> runElasticsearchBinScript(
                 getVersion().onOrAfter("6.3.0") ? "elasticsearch-users" : "x-pack/users",
                 paramMap.entrySet().stream()
                     .flatMap(entry -> Stream.of(entry.getKey(), entry.getValue()))
@@ -663,7 +663,7 @@ private void runElasticsearchBinScriptWithInput(String input, String tool, Strin
         }
     }
 
-    private void runElaticsearchBinScript(String tool, String... args) {
+    private void runElasticsearchBinScript(String tool, String... args) {
         runElasticsearchBinScriptWithInput("", tool, args);
     }
 
diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentBuilder.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentBuilder.java
index 51a4f86a0d3b2..20fde0891b6f8 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentBuilder.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentBuilder.java
@@ -819,7 +819,7 @@ private void unknownValue(Object value, boolean ensureNoSelfReferences) throws I
         } else if (value instanceof Map) {
             @SuppressWarnings("unchecked")
             final Map<String, ?> valueMap = (Map<String, ?>) value;
-            map(valueMap, ensureNoSelfReferences);
+            map(valueMap, ensureNoSelfReferences, true);
         } else if (value instanceof Iterable) {
             value((Iterable<?>) value, ensureNoSelfReferences);
         } else if (value instanceof Object[]) {
@@ -867,10 +867,15 @@ public XContentBuilder field(String name, Map<String, Object> values) throws IOE
     }
 
     public XContentBuilder map(Map<String, ?> values) throws IOException {
-        return map(values, true);
+        return map(values, true, true);
     }
 
-    private XContentBuilder map(Map<String, ?> values, boolean ensureNoSelfReferences) throws IOException {
+    /** writes a map without the start object and end object headers */
+    public XContentBuilder mapContents(Map<String, ?> values) throws IOException {
+        return map(values, true, false);
+    }
+
+    private XContentBuilder map(Map<String, ?> values, boolean ensureNoSelfReferences, boolean writeStartAndEndHeaders) throws IOException {
         if (values == null) {
             return nullValue();
         }
@@ -881,13 +886,17 @@ private XContentBuilder map(Map<String, ?> values, boolean ensureNoSelfReference
             ensureNoSelfReferences(values);
         }
 
-        startObject();
+        if (writeStartAndEndHeaders) {
+            startObject();
+        }
         for (Map.Entry<String, ?> value : values.entrySet()) {
             field(value.getKey());
             // pass ensureNoSelfReferences=false as we already performed the check at a higher level
             unknownValue(value.getValue(), false);
         }
-        endObject();
+        if (writeStartAndEndHeaders) {
+            endObject();
+        }
         return this;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/cli/EnvironmentAwareCommand.java b/server/src/main/java/org/elasticsearch/cli/EnvironmentAwareCommand.java
index 6fc3349c76233..1d3a31f0a72d9 100644
--- a/server/src/main/java/org/elasticsearch/cli/EnvironmentAwareCommand.java
+++ b/server/src/main/java/org/elasticsearch/cli/EnvironmentAwareCommand.java
@@ -88,14 +88,19 @@ protected void execute(Terminal terminal, OptionSet options) throws Exception {
 
     /** Create an {@link Environment} for the command to use. Overrideable for tests. */
     protected Environment createEnv(final Map<String, String> settings) throws UserException {
+        return createEnv(Settings.EMPTY, settings);
+    }
+
+    /** Create an {@link Environment} for the command to use. Overrideable for tests. */
+    protected final Environment createEnv(final Settings baseSettings, final Map<String, String> settings) throws UserException {
         final String esPathConf = System.getProperty("es.path.conf");
         if (esPathConf == null) {
             throw new UserException(ExitCodes.CONFIG, "the system property [es.path.conf] must be set");
         }
-        return InternalSettingsPreparer.prepareEnvironment(Settings.EMPTY, settings,
-                getConfigPath(esPathConf),
-                // HOSTNAME is set by elasticsearch-env and elasticsearch-env.bat so it is always available
-                () -> System.getenv("HOSTNAME"));
+        return InternalSettingsPreparer.prepareEnvironment(baseSettings, settings,
+            getConfigPath(esPathConf),
+            // HOSTNAME is set by elasticsearch-env and elasticsearch-env.bat so it is always available
+            () -> System.getenv("HOSTNAME"));
     }
 
     @SuppressForbidden(reason = "need path to construct environment")
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
index a65934c767769..800269520e366 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.cli.EnvironmentAwareCommand;
 import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.cluster.ClusterModule;
 import org.elasticsearch.cluster.metadata.Manifest;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.common.collect.Tuple;
@@ -42,7 +41,6 @@
 
 public abstract class ElasticsearchNodeCommand extends EnvironmentAwareCommand {
     private static final Logger logger = LogManager.getLogger(ElasticsearchNodeCommand.class);
-    protected final NamedXContentRegistry namedXContentRegistry;
     protected static final String DELIMITER = "------------------------------------------------------------------------\n";
 
     static final String STOP_WARNING_MSG =
@@ -61,7 +59,6 @@ public abstract class ElasticsearchNodeCommand extends EnvironmentAwareCommand {
 
     public ElasticsearchNodeCommand(String description) {
         super(description);
-        namedXContentRegistry = new NamedXContentRegistry(ClusterModule.getNamedXWriteables());
     }
 
     protected void processNodePaths(Terminal terminal, OptionSet options, Environment env) throws IOException {
@@ -80,7 +77,7 @@ protected void processNodePaths(Terminal terminal, OptionSet options, Environmen
 
     protected Tuple<Manifest, MetaData> loadMetaData(Terminal terminal, Path[] dataPaths) throws IOException {
         terminal.println(Terminal.Verbosity.VERBOSE, "Loading manifest file");
-        final Manifest manifest = Manifest.FORMAT.loadLatestState(logger, namedXContentRegistry, dataPaths);
+        final Manifest manifest = Manifest.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, dataPaths);
 
         if (manifest == null) {
             throw new ElasticsearchException(NO_MANIFEST_FILE_FOUND_MSG);
@@ -89,8 +86,8 @@ protected Tuple<Manifest, MetaData> loadMetaData(Terminal terminal, Path[] dataP
             throw new ElasticsearchException(GLOBAL_GENERATION_MISSING_MSG);
         }
         terminal.println(Terminal.Verbosity.VERBOSE, "Loading global metadata file");
-        final MetaData metaData = MetaData.FORMAT.loadGeneration(logger, namedXContentRegistry, manifest.getGlobalGeneration(),
-                dataPaths);
+        final MetaData metaData = MetaData.FORMAT_PRESERVE_CUSTOMS.loadGeneration(
+            logger, NamedXContentRegistry.EMPTY, manifest.getGlobalGeneration(), dataPaths);
         if (metaData == null) {
             throw new ElasticsearchException(NO_GLOBAL_METADATA_MSG + " [generation = " + manifest.getGlobalGeneration() + "]");
         }
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
index c15e832142eaf..05bc0116c13c6 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeMetaData;
 import org.elasticsearch.node.Node;
@@ -84,7 +85,7 @@ protected boolean validateBeforeLock(Terminal terminal, Environment env) {
 
     protected void processNodePaths(Terminal terminal, Path[] dataPaths, Environment env) throws IOException {
         terminal.println(Terminal.Verbosity.VERBOSE, "Loading node metadata");
-        final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry, dataPaths);
+        final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, dataPaths);
         if (nodeMetaData == null) {
             throw new ElasticsearchException(NO_NODE_METADATA_FOUND_MSG);
         }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/IndexMetaData.java b/server/src/main/java/org/elasticsearch/cluster/metadata/IndexMetaData.java
index d8fd88696e9f6..f8e1b48c6dd83 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/IndexMetaData.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/IndexMetaData.java
@@ -45,7 +45,6 @@
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Setting.Property;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.ToXContentFragment;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -1421,8 +1420,6 @@ public void toXContent(XContentBuilder builder, IndexMetaData state) throws IOEx
 
         @Override
         public IndexMetaData fromXContent(XContentParser parser) throws IOException {
-            assert parser.getXContentRegistry() != NamedXContentRegistry.EMPTY
-                    : "loading index metadata requires a working named xcontent registry";
             return Builder.fromXContent(parser);
         }
     };
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
index ce67e5b72f1d1..482d57bed54b5 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
@@ -755,7 +755,7 @@ public static Diff<MetaData> readDiffFrom(StreamInput in) throws IOException {
     }
 
     public static MetaData fromXContent(XContentParser parser) throws IOException {
-        return Builder.fromXContent(parser);
+        return Builder.fromXContent(parser, false);
     }
 
     @Override
@@ -1277,7 +1277,7 @@ public static void toXContent(MetaData metaData, XContentBuilder builder, ToXCon
             builder.endObject();
         }
 
-        public static MetaData fromXContent(XContentParser parser) throws IOException {
+        public static MetaData fromXContent(XContentParser parser, boolean preserveUnknownCustoms) throws IOException {
             Builder builder = new Builder();
 
             // we might get here after the meta-data element, or on a fresh parser
@@ -1327,8 +1327,13 @@ public static MetaData fromXContent(XContentParser parser) throws IOException {
                             Custom custom = parser.namedObject(Custom.class, currentFieldName, null);
                             builder.putCustom(custom.getWriteableName(), custom);
                         } catch (NamedObjectNotFoundException ex) {
-                            logger.warn("Skipping unknown custom object with type {}", currentFieldName);
-                            parser.skipChildren();
+                            if (preserveUnknownCustoms) {
+                                logger.warn("Adding unknown custom object with type {}", currentFieldName);
+                                builder.putCustom(currentFieldName, new UnknownGatewayOnlyCustom(parser.mapOrdered()));
+                            } else {
+                                logger.warn("Skipping unknown custom object with type {}", currentFieldName);
+                                parser.skipChildren();
+                            }
                         }
                     }
                 } else if (token.isValue()) {
@@ -1349,6 +1354,45 @@ public static MetaData fromXContent(XContentParser parser) throws IOException {
         }
     }
 
+    public static class UnknownGatewayOnlyCustom implements Custom {
+
+        private final Map<String, Object> contents;
+
+        UnknownGatewayOnlyCustom(Map<String, Object> contents) {
+            this.contents = contents;
+        }
+
+        @Override
+        public EnumSet<XContentContext> context() {
+            return EnumSet.of(MetaData.XContentContext.API, MetaData.XContentContext.GATEWAY);
+        }
+
+        @Override
+        public Diff<Custom> diff(Custom previousState) {
+            throw new UnsupportedOperationException();
+        }
+
+        @Override
+        public String getWriteableName() {
+            throw new UnsupportedOperationException();
+        }
+
+        @Override
+        public Version getMinimalSupportedVersion() {
+            throw new UnsupportedOperationException();
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            throw new UnsupportedOperationException();
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            return builder.mapContents(contents);
+        }
+    }
+
     private static final ToXContent.Params FORMAT_PARAMS;
     static {
         Map<String, String> params = new HashMap<>(2);
@@ -1360,16 +1404,25 @@ public static MetaData fromXContent(XContentParser parser) throws IOException {
     /**
      * State format for {@link MetaData} to write to and load from disk
      */
-    public static final MetaDataStateFormat<MetaData> FORMAT = new MetaDataStateFormat<MetaData>(GLOBAL_STATE_FILE_PREFIX) {
+    public static final MetaDataStateFormat<MetaData> FORMAT = createMetaDataStateFormat(false);
 
-        @Override
-        public void toXContent(XContentBuilder builder, MetaData state) throws IOException {
-            Builder.toXContent(state, builder, FORMAT_PARAMS);
-        }
+    /**
+     * Special state format for {@link MetaData} to write to and load from disk, preserving unknown customs
+     */
+    public static final MetaDataStateFormat<MetaData> FORMAT_PRESERVE_CUSTOMS = createMetaDataStateFormat(true);
 
-        @Override
-        public MetaData fromXContent(XContentParser parser) throws IOException {
-            return Builder.fromXContent(parser);
-        }
-    };
+    private static MetaDataStateFormat<MetaData> createMetaDataStateFormat(boolean preserveUnknownCustoms) {
+        return new MetaDataStateFormat<MetaData>(GLOBAL_STATE_FILE_PREFIX) {
+
+            @Override
+            public void toXContent(XContentBuilder builder, MetaData state) throws IOException {
+                Builder.toXContent(state, builder, FORMAT_PARAMS);
+            }
+
+            @Override
+            public MetaData fromXContent(XContentParser parser) throws IOException {
+                return Builder.fromXContent(parser, preserveUnknownCustoms);
+            }
+        };
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java b/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
index 20b5552dfa8f8..25b4f79866eaa 100644
--- a/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
+++ b/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.cluster.metadata.Manifest;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.gateway.WriteStateException;
 
@@ -165,7 +166,7 @@ private String toIndexName(NodeEnvironment.NodePath[] nodePaths, String uuid) {
             indexPaths[i] = nodePaths[i].resolve(uuid);
         }
         try {
-            IndexMetaData metaData = IndexMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry, indexPaths);
+            IndexMetaData metaData = IndexMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, indexPaths);
             return metaData.getIndex().getName();
         } catch (Exception e) {
             return "no name for uuid: " + uuid + ": " + e;
@@ -194,7 +195,7 @@ private void rewriteManifest(Terminal terminal, Manifest manifest, Path[] dataPa
 
     private Manifest loadManifest(Terminal terminal, Path[] dataPaths) throws IOException {
         terminal.println(Terminal.Verbosity.VERBOSE, "Loading manifest");
-        final Manifest manifest = Manifest.FORMAT.loadLatestState(logger, namedXContentRegistry, dataPaths);
+        final Manifest manifest = Manifest.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, dataPaths);
 
         if (manifest == null) {
             terminal.println(Terminal.Verbosity.SILENT, PRE_V7_MESSAGE);
diff --git a/server/src/main/java/org/elasticsearch/env/OverrideNodeVersionCommand.java b/server/src/main/java/org/elasticsearch/env/OverrideNodeVersionCommand.java
index 34c7e9599e07f..f50bdf081ef85 100644
--- a/server/src/main/java/org/elasticsearch/env/OverrideNodeVersionCommand.java
+++ b/server/src/main/java/org/elasticsearch/env/OverrideNodeVersionCommand.java
@@ -25,6 +25,7 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.cli.Terminal;
 import org.elasticsearch.cluster.coordination.ElasticsearchNodeCommand;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 
 import java.io.IOException;
 import java.nio.file.Path;
@@ -74,7 +75,7 @@ public OverrideNodeVersionCommand() {
     protected void processNodePaths(Terminal terminal, Path[] dataPaths, Environment env) throws IOException {
         final Path[] nodePaths = Arrays.stream(toNodePaths(dataPaths)).map(p -> p.path).toArray(Path[]::new);
         final NodeMetaData nodeMetaData
-            = new NodeMetaData.NodeMetaDataStateFormat(true).loadLatestState(logger, namedXContentRegistry, nodePaths);
+            = new NodeMetaData.NodeMetaDataStateFormat(true).loadLatestState(logger, NamedXContentRegistry.EMPTY, nodePaths);
         if (nodeMetaData == null) {
             throw new ElasticsearchException(NO_METADATA_MESSAGE);
         }
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataTests.java
index 36a78119c7665..7d2b10beb3279 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataTests.java
@@ -365,7 +365,7 @@ public void testUnknownFieldClusterMetaData() throws IOException {
                 .endObject()
             .endObject());
         try (XContentParser parser = createParser(JsonXContent.jsonXContent, metadata)) {
-            MetaData.Builder.fromXContent(parser);
+            MetaData.Builder.fromXContent(parser, randomBoolean());
             fail();
         } catch (IllegalArgumentException e) {
             assertEquals("Unexpected field [random]", e.getMessage());
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/ToAndFromJsonMetaDataTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/ToAndFromJsonMetaDataTests.java
index e2d0fcf5188a6..0338a64b6fe7e 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/ToAndFromJsonMetaDataTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/ToAndFromJsonMetaDataTests.java
@@ -140,7 +140,7 @@ public void testSimpleJsonFromAndTo() throws IOException {
 
         String metaDataSource = MetaData.Builder.toXContent(metaData);
 
-        MetaData parsedMetaData = MetaData.Builder.fromXContent(createParser(JsonXContent.jsonXContent, metaDataSource));
+        MetaData parsedMetaData = MetaData.Builder.fromXContent(createParser(JsonXContent.jsonXContent, metaDataSource), false);
 
         IndexMetaData indexMetaData = parsedMetaData.index("test1");
         assertThat(indexMetaData.primaryTerm(0), equalTo(1L));
diff --git a/server/src/test/java/org/elasticsearch/gateway/MetaDataStateFormatTests.java b/server/src/test/java/org/elasticsearch/gateway/MetaDataStateFormatTests.java
index 40f3bd8a01623..c7dab0dc4d4a0 100644
--- a/server/src/test/java/org/elasticsearch/gateway/MetaDataStateFormatTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/MetaDataStateFormatTests.java
@@ -61,6 +61,8 @@
 import java.util.stream.StreamSupport;
 
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.hasSize;
+import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.notNullValue;
@@ -80,7 +82,7 @@ public void toXContent(XContentBuilder builder, MetaData state) {
 
             @Override
             public MetaData fromXContent(XContentParser parser) throws IOException {
-                return MetaData.Builder.fromXContent(parser);
+                return MetaData.Builder.fromXContent(parser, false);
             }
         };
         Path tmp = createTempDir();
@@ -233,7 +235,23 @@ public static void corruptFile(Path fileToCorrupt, Logger logger) throws IOExcep
         }
     }
 
-    public void testLoadState() throws IOException {
+    public void testLoadStateWithoutMissingCustoms() throws IOException {
+        runLoadStateTest(false, false);
+    }
+
+    public void testLoadStateWithoutMissingCustomsButPreserved() throws IOException {
+        runLoadStateTest(false, true);
+    }
+
+    public void testLoadStateWithMissingCustomsButPreserved() throws IOException {
+        runLoadStateTest(true, true);
+    }
+
+    public void testLoadStateWithMissingCustomsAndNotPreserved() throws IOException {
+        runLoadStateTest(true, false);
+    }
+
+    private void runLoadStateTest(boolean hasMissingCustoms, boolean preserveUnknownCustoms) throws IOException {
         final Path[] dirs = new Path[randomIntBetween(1, 5)];
         int numStates = randomIntBetween(1, 5);
         List<MetaData> meta = new ArrayList<>();
@@ -241,7 +259,7 @@ public void testLoadState() throws IOException {
             meta.add(randomMeta());
         }
         Set<Path> corruptedFiles = new HashSet<>();
-        MetaDataStateFormat<MetaData> format = metaDataFormat();
+        MetaDataStateFormat<MetaData> format = metaDataFormat(preserveUnknownCustoms);
         for (int i = 0; i < dirs.length; i++) {
             dirs[i] = createTempDir();
             Files.createDirectories(dirs[i].resolve(MetaDataStateFormat.STATE_DIR_NAME));
@@ -258,11 +276,12 @@ public void testLoadState() throws IOException {
         }
         List<Path> dirList = Arrays.asList(dirs);
         Collections.shuffle(dirList, random());
-        MetaData loadedMetaData = format.loadLatestState(logger, xContentRegistry(), dirList.toArray(new Path[0]));
+        MetaData loadedMetaData = format.loadLatestState(logger, hasMissingCustoms ?
+            NamedXContentRegistry.EMPTY : xContentRegistry(), dirList.toArray(new Path[0]));
         MetaData latestMetaData = meta.get(numStates-1);
         assertThat(loadedMetaData.clusterUUID(), not(equalTo("_na_")));
         assertThat(loadedMetaData.clusterUUID(), equalTo(latestMetaData.clusterUUID()));
-        ImmutableOpenMap<String,IndexMetaData> indices = loadedMetaData.indices();
+        ImmutableOpenMap<String, IndexMetaData> indices = loadedMetaData.indices();
         assertThat(indices.size(), equalTo(latestMetaData.indices().size()));
         for (IndexMetaData original : latestMetaData) {
             IndexMetaData deserialized = indices.get(original.getIndex().getName());
@@ -275,7 +294,23 @@ public void testLoadState() throws IOException {
         }
 
         // make sure the index tombstones are the same too
-        assertThat(loadedMetaData.indexGraveyard(), equalTo(latestMetaData.indexGraveyard()));
+        if (hasMissingCustoms) {
+            if (preserveUnknownCustoms) {
+                assertNotNull(loadedMetaData.custom(IndexGraveyard.TYPE));
+                assertThat(loadedMetaData.custom(IndexGraveyard.TYPE), instanceOf(MetaData.UnknownGatewayOnlyCustom.class));
+
+                // check that we reserialize unknown metadata correctly again
+                final Path tempdir = createTempDir();
+                metaDataFormat(randomBoolean()).write(loadedMetaData, tempdir);
+                final MetaData reloadedMetaData = metaDataFormat(randomBoolean()).loadLatestState(logger, xContentRegistry(), tempdir);
+                assertThat(reloadedMetaData.indexGraveyard(), equalTo(latestMetaData.indexGraveyard()));
+            } else {
+                assertNotNull(loadedMetaData.indexGraveyard());
+                assertThat(loadedMetaData.indexGraveyard().getTombstones(), hasSize(0));
+            }
+        }  else {
+            assertThat(loadedMetaData.indexGraveyard(), equalTo(latestMetaData.indexGraveyard()));
+        }
 
         // now corrupt all the latest ones and make sure we fail to load the state
         for (int i = 0; i < dirs.length; i++) {
@@ -419,7 +454,7 @@ public void testFailRandomlyAndReadAnyState() throws IOException {
         writeAndReadStateSuccessfully(format, paths);
     }
 
-    private static MetaDataStateFormat<MetaData> metaDataFormat() {
+    private static MetaDataStateFormat<MetaData> metaDataFormat(boolean preserveUnknownCustoms) {
         return new MetaDataStateFormat<MetaData>(MetaData.GLOBAL_STATE_FILE_PREFIX) {
             @Override
             public void toXContent(XContentBuilder builder, MetaData state) throws IOException {
@@ -428,7 +463,7 @@ public void toXContent(XContentBuilder builder, MetaData state) throws IOExcepti
 
             @Override
             public MetaData fromXContent(XContentParser parser) throws IOException {
-                return MetaData.Builder.fromXContent(parser);
+                return MetaData.Builder.fromXContent(parser, preserveUnknownCustoms);
             }
         };
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicensesMetaDataSerializationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicensesMetaDataSerializationTests.java
index d7799959f6cce..084d965a6e74b 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicensesMetaDataSerializationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicensesMetaDataSerializationTests.java
@@ -80,7 +80,7 @@ public void testLicenseMetadataParsingDoesNotSwallowOtherMetaData() throws Excep
         builder = metaDataBuilder.build().toXContent(builder, params);
         builder.endObject();
         // deserialize metadata again
-        MetaData metaData = MetaData.Builder.fromXContent(createParser(builder));
+        MetaData metaData = MetaData.Builder.fromXContent(createParser(builder), randomBoolean());
         // check that custom metadata still present
         assertThat(metaData.custom(licensesMetaData.getWriteableName()), notNullValue());
         assertThat(metaData.custom(repositoriesMetaData.getWriteableName()), notNullValue());
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/WatcherMetaDataSerializationTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/WatcherMetaDataSerializationTests.java
index 0556b8535e428..75e5bc1073e69 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/WatcherMetaDataSerializationTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/WatcherMetaDataSerializationTests.java
@@ -64,7 +64,7 @@ public void testWatcherMetadataParsingDoesNotSwallowOtherMetaData() throws Excep
         builder = metaDataBuilder.build().toXContent(builder, params);
         builder.endObject();
         // deserialize metadata again
-        MetaData metaData = MetaData.Builder.fromXContent(createParser(builder));
+        MetaData metaData = MetaData.Builder.fromXContent(createParser(builder), randomBoolean());
         // check that custom metadata still present
         assertThat(metaData.custom(watcherMetaData.getWriteableName()), notNullValue());
         assertThat(metaData.custom(repositoriesMetaData.getWriteableName()), notNullValue());

From a6a28a765847cc5889792c7c484e721401d0acc3 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 10 Dec 2019 11:04:30 +0100
Subject: [PATCH 138/686] Improve Snapshot Finalization Ex. Handling (#49995)

* Improve Snapshot Finalization Ex. Handling

Like in #49989 we can get into a situation where the setting of
the repository generation (during snapshot finalization) in the cluster
state fails due to master failing over.
In this case we should not try to execute the next cluster state update
that will remove the snapshot from the cluster state.

Closes #49989
---
 .../elasticsearch/snapshots/SnapshotsService.java  | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
index c38462e240747..a48f893dfd408 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.ClusterStateApplier;
 import org.elasticsearch.cluster.ClusterStateUpdateTask;
+import org.elasticsearch.cluster.NotMasterException;
 import org.elasticsearch.cluster.RepositoryCleanupInProgress;
 import org.elasticsearch.cluster.RestoreInProgress;
 import org.elasticsearch.cluster.SnapshotDeletionsInProgress;
@@ -42,6 +43,7 @@
 import org.elasticsearch.cluster.SnapshotsInProgress.ShardSnapshotStatus;
 import org.elasticsearch.cluster.SnapshotsInProgress.ShardState;
 import org.elasticsearch.cluster.SnapshotsInProgress.State;
+import org.elasticsearch.cluster.coordination.FailedToCommitClusterStateException;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MetaData;
@@ -1051,8 +1053,16 @@ protected void doRun() {
             @Override
             public void onFailure(final Exception e) {
                 Snapshot snapshot = entry.snapshot();
-                logger.warn(() -> new ParameterizedMessage("[{}] failed to finalize snapshot", snapshot), e);
-                removeSnapshotFromClusterState(snapshot, null, e);
+                if (ExceptionsHelper.unwrap(e, NotMasterException.class, FailedToCommitClusterStateException.class) != null) {
+                    // Failure due to not being master any more, don't try to remove snapshot from cluster state the next master
+                    // will try ending this snapshot again
+                    logger.debug(() -> new ParameterizedMessage(
+                        "[{}] failed to update cluster state during snapshot finalization", snapshot), e);
+                    endingSnapshots.remove(snapshot);
+                } else {
+                    logger.warn(() -> new ParameterizedMessage("[{}] failed to finalize snapshot", snapshot), e);
+                    removeSnapshotFromClusterState(snapshot, null, e);
+                }
             }
         });
     }

From e699f1aefab73a7a339e04a01b90a63a2ec9731d Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Tue, 10 Dec 2019 10:44:31 +0000
Subject: [PATCH 139/686] Fix query analyzer logic for mixed conjunctions of
 terms and ranges (#49803)

When the query analyzer examines a conjunction containing both terms and ranges,
it should only include ranges in the minimum_should_match calculation if there are no
other range queries on that same field within the conjunction. This is because we cannot
build a selection query over disjoint ranges on the same field, and it is not easy to check
if two range queries have an overlap.

The current logic to calculate this just sets minimum_should_match to 1 or 0, dependent
on whether or not the current range is over a field that has already been seen. However, this
can be incorrect in the case that there are terms in the same match group which adjust the
minimum_should_match downwards. Instead, the logic should be changed to match the
terms extraction, whereby we adjust minimum_should_match downwards if we have already
seen a range field.

Fixes #49684
---
 .../percolator/QueryAnalyzer.java             |  66 +++++----
 .../percolator/QueryAnalyzerTests.java        | 132 ++++++++++++++++++
 2 files changed, 168 insertions(+), 30 deletions(-)

diff --git a/modules/percolator/src/main/java/org/elasticsearch/percolator/QueryAnalyzer.java b/modules/percolator/src/main/java/org/elasticsearch/percolator/QueryAnalyzer.java
index 362c8870f652d..f08600cdfd0e9 100644
--- a/modules/percolator/src/main/java/org/elasticsearch/percolator/QueryAnalyzer.java
+++ b/modules/percolator/src/main/java/org/elasticsearch/percolator/QueryAnalyzer.java
@@ -232,7 +232,7 @@ private static Result handleConjunction(List<Result> conjunctionsWithUnknowns) {
         List<Result> conjunctions = conjunctionsWithUnknowns.stream().filter(r -> r.isUnknown() == false).collect(Collectors.toList());
         if (conjunctions.isEmpty()) {
             if (conjunctionsWithUnknowns.isEmpty()) {
-                throw new IllegalArgumentException("Must have at least on conjunction sub result");
+                throw new IllegalArgumentException("Must have at least one conjunction sub result");
             }
             return conjunctionsWithUnknowns.get(0); // all conjunctions are unknown, so just return the first one
         }
@@ -247,47 +247,53 @@ private static Result handleConjunction(List<Result> conjunctionsWithUnknowns) {
         int msm = 0;
         boolean verified = conjunctionsWithUnknowns.size() == conjunctions.size();
         boolean matchAllDocs = true;
-        boolean hasDuplicateTerms = false;
         Set<QueryExtraction> extractions = new HashSet<>();
         Set<String> seenRangeFields = new HashSet<>();
         for (Result result : conjunctions) {
-            // In case that there are duplicate query extractions we need to be careful with
-            // incrementing msm,
-            // because that could lead to valid matches not becoming candidate matches:
-            // query: (field:val1 AND field:val2) AND (field:val2 AND field:val3)
-            // doc: field: val1 val2 val3
-            // So lets be protective and decrease the msm:
+
             int resultMsm = result.minimumShouldMatch;
             for (QueryExtraction queryExtraction : result.extractions) {
                 if (queryExtraction.range != null) {
                     // In case of range queries each extraction does not simply increment the
-                    // minimum_should_match
-                    // for that percolator query like for a term based extraction, so that can lead
-                    // to more false
-                    // positives for percolator queries with range queries than term based queries.
-                    // The is because the way number fields are extracted from the document to be
-                    // percolated.
-                    // Per field a single range is extracted and if a percolator query has two or
-                    // more range queries
-                    // on the same field, then the minimum should match can be higher than clauses
-                    // in the CoveringQuery.
-                    // Therefore right now the minimum should match is incremented once per number
-                    // field when processing
-                    // the percolator query at index time.
-                    if (seenRangeFields.add(queryExtraction.range.fieldName)) {
-                        resultMsm = 1;
-                    } else {
-                        resultMsm = 0;
+                    // minimum_should_match for that percolator query like for a term based extraction,
+                    // so that can lead to more false positives for percolator queries with range queries
+                    // than term based queries.
+                    // This is because the way number fields are extracted from the document to be
+                    // percolated.  Per field a single range is extracted and if a percolator query has two or
+                    // more range queries on the same field, then the minimum should match can be higher than clauses
+                    // in the CoveringQuery. Therefore right now the minimum should match is only incremented once per
+                    // number field when processing the percolator query at index time.
+                    // For multiple ranges within a single extraction (ie from an existing conjunction or disjunction)
+                    // then this will already have been taken care of, so we only check against fieldnames from
+                    // previously processed extractions, and don't add to the seenRangeFields list until all
+                    // extractions from this result are processed
+                    if (seenRangeFields.contains(queryExtraction.range.fieldName)) {
+                        resultMsm = Math.max(0, resultMsm - 1);
+                        verified = false;
                     }
                 }
-
-                if (extractions.contains(queryExtraction)) {
-                    resultMsm = Math.max(0, resultMsm - 1);
-                    verified = false;
+                else {
+                    // In case that there are duplicate term query extractions we need to be careful with
+                    // incrementing msm, because that could lead to valid matches not becoming candidate matches:
+                    // query: (field:val1 AND field:val2) AND (field:val2 AND field:val3)
+                    // doc: field: val1 val2 val3
+                    // So lets be protective and decrease the msm:
+                    if (extractions.contains(queryExtraction)) {
+                        resultMsm = Math.max(0, resultMsm - 1);
+                        verified = false;
+                    }
                 }
             }
             msm += resultMsm;
 
+            // add range fields from this Result to the seenRangeFields set so that minimumShouldMatch is correctly
+            // calculated for subsequent Results
+            result.extractions.stream()
+                .map(e -> e.range)
+                .filter(Objects::nonNull)
+                .map(e -> e.fieldName)
+                .forEach(seenRangeFields::add);
+
             if (result.verified == false
                 // If some inner extractions are optional, the result can't be verified
                 || result.minimumShouldMatch < result.extractions.size()) {
@@ -299,7 +305,7 @@ private static Result handleConjunction(List<Result> conjunctionsWithUnknowns) {
         if (matchAllDocs) {
             return new Result(matchAllDocs, verified);
         } else {
-            return new Result(verified, extractions, hasDuplicateTerms ? 1 : msm);
+            return new Result(verified, extractions, msm);
         }
     }
 
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/QueryAnalyzerTests.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/QueryAnalyzerTests.java
index 91c815c40322e..1c00d0555b41a 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/QueryAnalyzerTests.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/QueryAnalyzerTests.java
@@ -78,6 +78,7 @@
 import static org.elasticsearch.percolator.QueryAnalyzer.analyze;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
+import static org.hamcrest.collection.IsCollectionWithSize.hasSize;
 
 public class QueryAnalyzerTests extends ESTestCase {
 
@@ -1208,4 +1209,135 @@ public void testIntervalQueries() {
         assertTermsEqual(result.extractions, new Term("field", "a"));
     }
 
+    public void testCombinedRangeAndTermWithMinimumShouldMatch() {
+
+        Query disj = new BooleanQuery.Builder()
+            .add(IntPoint.newRangeQuery("i", 0, 10), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v1")), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v1")), Occur.SHOULD)
+            .setMinimumNumberShouldMatch(2)
+            .build();
+
+        Result r = analyze(disj, Version.CURRENT);
+        assertThat(r.minimumShouldMatch, equalTo(1));
+        assertThat(r.extractions, hasSize(2));
+        assertFalse(r.matchAllDocs);
+        assertFalse(r.verified);
+
+        Query q = new BooleanQuery.Builder()
+            .add(IntPoint.newRangeQuery("i", 0, 10), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v1")), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v1")), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v1")), Occur.FILTER)
+            .setMinimumNumberShouldMatch(2)
+            .build();
+
+        Result result = analyze(q, Version.CURRENT);
+        assertThat(result.minimumShouldMatch, equalTo(1));
+        assertThat(result.extractions.size(), equalTo(2));
+        assertFalse(result.verified);
+        assertFalse(result.matchAllDocs);
+
+        q = new BooleanQuery.Builder()
+            .add(q, Occur.MUST)
+            .add(q, Occur.MUST)
+            .build();
+
+        result = analyze(q, Version.CURRENT);
+        assertThat(result.minimumShouldMatch, equalTo(1));
+        assertThat(result.extractions.size(), equalTo(2));
+        assertFalse(result.verified);
+        assertFalse(result.matchAllDocs);
+
+        Query q2 = new BooleanQuery.Builder()
+            .add(new TermQuery(new Term("f", "v1")), Occur.FILTER)
+            .add(IntPoint.newRangeQuery("i", 15, 20), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v2")), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v2")), Occur.MUST)
+            .setMinimumNumberShouldMatch(1)
+            .build();
+
+        result = analyze(q2, Version.CURRENT);
+        assertThat(result.minimumShouldMatch, equalTo(2));
+        assertThat(result.extractions, hasSize(3));
+        assertFalse(result.verified);
+        assertFalse(result.matchAllDocs);
+
+        // multiple range queries on different fields
+        Query q3 = new BooleanQuery.Builder()
+            .add(IntPoint.newRangeQuery("i", 15, 20), Occur.SHOULD)
+            .add(IntPoint.newRangeQuery("i2", 15, 20), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v1")), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v2")), Occur.MUST)
+            .setMinimumNumberShouldMatch(1)
+            .build();
+        result = analyze(q3, Version.CURRENT);
+        assertThat(result.minimumShouldMatch, equalTo(2));
+        assertThat(result.extractions, hasSize(4));
+        assertFalse(result.verified);
+        assertFalse(result.matchAllDocs);
+
+        // multiple disjoint range queries on the same field
+        Query q4 = new BooleanQuery.Builder()
+            .add(IntPoint.newRangeQuery("i", 15, 20), Occur.SHOULD)
+            .add(IntPoint.newRangeQuery("i", 25, 30), Occur.SHOULD)
+            .add(IntPoint.newRangeQuery("i", 35, 40), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v1")), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v2")), Occur.MUST)
+            .setMinimumNumberShouldMatch(1)
+            .build();
+        result = analyze(q4, Version.CURRENT);
+        assertThat(result.minimumShouldMatch, equalTo(2));
+        assertThat(result.extractions, hasSize(5));
+        assertFalse(result.verified);
+        assertFalse(result.matchAllDocs);
+
+        // multiple conjunction range queries on the same field
+        Query q5 = new BooleanQuery.Builder()
+            .add(new BooleanQuery.Builder()
+                .add(IntPoint.newRangeQuery("i", 15, 20), Occur.MUST)
+                .add(IntPoint.newRangeQuery("i", 25, 30), Occur.MUST)
+                .build(), Occur.MUST)
+            .add(IntPoint.newRangeQuery("i", 35, 40), Occur.MUST)
+            .add(new TermQuery(new Term("f", "v2")), Occur.MUST)
+            .build();
+        result = analyze(q5, Version.CURRENT);
+        assertThat(result.minimumShouldMatch, equalTo(2));
+        assertThat(result.extractions, hasSize(4));
+        assertFalse(result.verified);
+        assertFalse(result.matchAllDocs);
+
+        // multiple conjunction range queries on different fields
+        Query q6 = new BooleanQuery.Builder()
+            .add(new BooleanQuery.Builder()
+                .add(IntPoint.newRangeQuery("i", 15, 20), Occur.MUST)
+                .add(IntPoint.newRangeQuery("i2", 25, 30), Occur.MUST)
+                .build(), Occur.MUST)
+            .add(IntPoint.newRangeQuery("i", 35, 40), Occur.MUST)
+            .add(new TermQuery(new Term("f", "v2")), Occur.MUST)
+            .build();
+        result = analyze(q6, Version.CURRENT);
+        assertThat(result.minimumShouldMatch, equalTo(3));
+        assertThat(result.extractions, hasSize(4));
+        assertFalse(result.verified);
+        assertFalse(result.matchAllDocs);
+
+        // mixed term and range conjunctions
+        Query q7 = new BooleanQuery.Builder()
+            .add(new BooleanQuery.Builder()
+                .add(IntPoint.newRangeQuery("i", 1, 2), Occur.MUST)
+                .add(new TermQuery(new Term("f", "1")), Occur.MUST)
+                .build(), Occur.MUST)
+            .add(new BooleanQuery.Builder()
+                .add(IntPoint.newRangeQuery("i", 1, 2), Occur.MUST)
+                .add(new TermQuery(new Term("f", "2")), Occur.MUST)
+                .build(), Occur.MUST)
+            .build();
+        result = analyze(q7, Version.CURRENT);
+        assertThat(result.minimumShouldMatch, equalTo(3));
+        assertThat(result.extractions, hasSize(3));
+        assertFalse(result.verified);
+        assertFalse(result.matchAllDocs);
+    }
+
 }

From 40910251843b7dd72c33ea878b2c2f784552095f Mon Sep 17 00:00:00 2001
From: Przemyslaw Gomulka <przemyslaw.gomulka@elastic.co>
Date: Tue, 10 Dec 2019 14:22:10 +0100
Subject: [PATCH 140/686] Allow skipping ranges of versions (#50014)

Multiple version ranges are allowed to be used in section skip in yml
tests. This is useful when a bugfix was backported to latest versions
and all previous releases contain a wire breaking bug.
examples:
6.1.0 - 6.3.0, 6.6.0 - 6.7.9, 7.0 -
- 7.2, 8.0.0 -
---
 .../search/180_locale_dependent_mapping.yml   |  3 -
 .../test/rest/yaml/section/DoSection.java     |  7 ++-
 .../test/rest/yaml/section/SkipSection.java   | 58 ++++++++++---------
 .../test/rest/yaml/section/VersionRange.java  | 49 ++++++++++++++++
 .../rest/yaml/section/SkipSectionTests.java   | 21 +++++++
 5 files changed, 104 insertions(+), 34 deletions(-)
 create mode 100644 test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/VersionRange.java

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search/180_locale_dependent_mapping.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search/180_locale_dependent_mapping.yml
index e9ba863675dfa..c4815304e0799 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search/180_locale_dependent_mapping.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search/180_locale_dependent_mapping.yml
@@ -1,8 +1,5 @@
 ---
 "Test Index and Search locale dependent mappings / dates":
-  - skip:
-      version: " - 6.1.99"
-      reason: JDK9 only supports this with a special sysproperty added in 6.2.0
   - do:
       indices.create:
           index: test_index
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/DoSection.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/DoSection.java
index ce94adf73bcd3..1b588f554fa53 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/DoSection.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/DoSection.java
@@ -422,7 +422,7 @@ private static NodeSelector parseVersionSelector(XContentParser parser) throws I
         if (false == parser.currentToken().isValue()) {
             throw new XContentParseException(parser.getTokenLocation(), "expected [version] to be a value");
         }
-        Version[] range = SkipSection.parseVersionRange(parser.text());
+        List<VersionRange> skipVersionRanges = SkipSection.parseVersionRanges(parser.text());
         return new NodeSelector() {
             @Override
             public void select(Iterable<Node> nodes) {
@@ -433,7 +433,8 @@ public void select(Iterable<Node> nodes) {
                                 + node);
                     }
                     Version version = Version.fromString(node.getVersion());
-                    if (false == (version.onOrAfter(range[0]) && version.onOrBefore(range[1]))) {
+                    boolean skip = skipVersionRanges.stream().anyMatch(v -> v.contains(version));
+                    if (false == skip) {
                         itr.remove();
                     }
                 }
@@ -441,7 +442,7 @@ public void select(Iterable<Node> nodes) {
 
             @Override
             public String toString() {
-                return "version between [" + range[0] + "] and [" + range[1] + "]";
+                return "version ranges "+skipVersionRanges;
             }
         };
     }
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/SkipSection.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/SkipSection.java
index e487f8e74da3b..81eb470892010 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/SkipSection.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/SkipSection.java
@@ -27,6 +27,7 @@
 
 import java.io.IOException;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.List;
 
 /**
@@ -98,33 +99,30 @@ public static SkipSection parse(XContentParser parser) throws IOException {
 
     public static final SkipSection EMPTY = new SkipSection();
 
-    private final Version lowerVersion;
-    private final Version upperVersion;
+    private final List<VersionRange> versionRanges;
     private final List<String> features;
     private final String reason;
 
     private SkipSection() {
-        this.lowerVersion = null;
-        this.upperVersion = null;
+        this.versionRanges = new ArrayList<>();
         this.features = new ArrayList<>();
         this.reason = null;
     }
 
     public SkipSection(String versionRange, List<String> features, String reason) {
         assert features != null;
-        Version[] versions = parseVersionRange(versionRange);
-        this.lowerVersion = versions[0];
-        this.upperVersion = versions[1];
+        this.versionRanges = parseVersionRanges(versionRange);
+        assert versionRanges.isEmpty() == false;
         this.features = features;
         this.reason = reason;
     }
 
     public Version getLowerVersion() {
-        return lowerVersion;
+        return versionRanges.get(0).getLower();
     }
 
     public Version getUpperVersion() {
-        return upperVersion;
+        return versionRanges.get(versionRanges.size() - 1).getUpper();
     }
 
     public List<String> getFeatures() {
@@ -139,10 +137,8 @@ public boolean skip(Version currentVersion) {
         if (isEmpty()) {
             return false;
         }
-        boolean skip = lowerVersion != null && upperVersion != null && currentVersion.onOrAfter(lowerVersion)
-            && currentVersion.onOrBefore(upperVersion);
-        skip |= Features.areAllSupported(features) == false;
-        return skip;
+        boolean skip = versionRanges.stream().anyMatch(range -> range.contains(currentVersion));
+        return skip || Features.areAllSupported(features) == false;
     }
 
     public boolean isVersionCheck() {
@@ -153,24 +149,30 @@ public boolean isEmpty() {
         return EMPTY.equals(this);
     }
 
-    static Version[] parseVersionRange(String versionRange) {
-        if (versionRange == null) {
-            return new Version[] { null, null };
+    static List<VersionRange> parseVersionRanges(String rawRanges) {
+        if (rawRanges == null) {
+            return Collections.singletonList(new VersionRange(null, null));
         }
-        if (versionRange.trim().equals("all")) {
-            return new Version[]{VersionUtils.getFirstVersion(), Version.CURRENT};
-        }
-        String[] skipVersions = versionRange.split("-");
-        if (skipVersions.length > 2) {
-            throw new IllegalArgumentException("version range malformed: " + versionRange);
+        if (rawRanges.trim().equals("all")) {
+            return Collections.singletonList(new VersionRange(VersionUtils.getFirstVersion(), Version.CURRENT));
         }
+        String[] ranges = rawRanges.split(",");
+        List<VersionRange> versionRanges = new ArrayList<>();
+        for (String rawRange : ranges) {
+            String[] skipVersions = rawRange.split("-", -1);
+            if (skipVersions.length > 2) {
+                throw new IllegalArgumentException("version range malformed: " + rawRanges);
+            }
 
-        String lower = skipVersions[0].trim();
-        String upper = skipVersions[1].trim();
-        return new Version[] {
-            lower.isEmpty() ? VersionUtils.getFirstVersion() : Version.fromString(lower),
-            upper.isEmpty() ? Version.CURRENT : Version.fromString(upper)
-        };
+            String lower = skipVersions[0].trim();
+            String upper = skipVersions[1].trim();
+            VersionRange versionRange = new VersionRange(
+                lower.isEmpty() ? VersionUtils.getFirstVersion() : Version.fromString(lower),
+                upper.isEmpty() ? Version.CURRENT : Version.fromString(upper)
+            );
+            versionRanges.add(versionRange);
+        }
+        return versionRanges;
     }
 
     public String getSkipMessage(String description) {
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/VersionRange.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/VersionRange.java
new file mode 100644
index 0000000000000..f1b1df2a1a167
--- /dev/null
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/section/VersionRange.java
@@ -0,0 +1,49 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.test.rest.yaml.section;
+
+import org.elasticsearch.Version;
+
+public class VersionRange {
+    private final Version lower;
+    private final Version upper;
+
+    public VersionRange(Version lower, Version upper) {
+        this.lower = lower;
+        this.upper = upper;
+    }
+
+    public Version getLower() {
+        return lower;
+    }
+
+    public Version getUpper() {
+        return upper;
+    }
+
+    public boolean contains(Version currentVersion) {
+        return lower != null && upper != null && currentVersion.onOrAfter(lower)
+            && currentVersion.onOrBefore(upper);
+    }
+
+    @Override
+    public String toString() {
+        return "[" + lower + " - " + upper + "]";
+    }
+}
diff --git a/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/section/SkipSectionTests.java b/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/section/SkipSectionTests.java
index e92ef2ce13576..45273912f1d5b 100644
--- a/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/section/SkipSectionTests.java
+++ b/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/section/SkipSectionTests.java
@@ -33,6 +33,27 @@
 
 public class SkipSectionTests extends AbstractClientYamlTestFragmentParserTestCase {
 
+    public void testSkipMultiRange() {
+        SkipSection section = new SkipSection("6.0.0 - 6.1.0, 7.1.0 - 7.5.0",
+             Collections.emptyList() , "foobar");
+
+        assertFalse(section.skip(Version.CURRENT));
+        assertFalse(section.skip(Version.fromString("6.2.0")));
+        assertFalse(section.skip(Version.fromString("7.0.0")));
+        assertFalse(section.skip(Version.fromString("7.6.0")));
+
+        assertTrue(section.skip(Version.fromString("6.0.0")));
+        assertTrue(section.skip(Version.fromString("6.1.0")));
+        assertTrue(section.skip(Version.fromString("7.1.0")));
+        assertTrue(section.skip(Version.fromString("7.5.0")));
+
+        section = new SkipSection("-  7.1.0, 7.2.0 - 7.5.0, 8.0.0 -",
+            Collections.emptyList() , "foobar");
+        assertTrue(section.skip(Version.fromString("7.0.0")));
+        assertTrue(section.skip(Version.fromString("7.3.0")));
+        assertTrue(section.skip(Version.fromString("8.0.0")));
+    }
+
     public void testSkip() {
         SkipSection section = new SkipSection("6.0.0 - 6.1.0",
                 randomBoolean() ? Collections.emptyList() : Collections.singletonList("warnings"), "foobar");

From b362d15b38d0fd7cae676e03cb8ea1b7c1cd9373 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Tue, 10 Dec 2019 09:30:04 -0500
Subject: [PATCH 141/686] [DOCS] Remove shadow replica reference (#50029)

Removes a reference to shadow replicas from the cat shards API docs
and a comment in cluster/routing/UnassignedInfo.java.

Shadow replicas were removed with #23906.
---
 docs/reference/cat/shards.asciidoc                              | 2 +-
 .../java/org/elasticsearch/cluster/routing/UnassignedInfo.java  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/cat/shards.asciidoc b/docs/reference/cat/shards.asciidoc
index 61b1c869f0429..b26472812f514 100644
--- a/docs/reference/cat/shards.asciidoc
+++ b/docs/reference/cat/shards.asciidoc
@@ -257,7 +257,7 @@ Reason the shard is unassigned. Returned values are:
 * `NEW_INDEX_RESTORED`: Unassigned as a result of restoring into a new index.
 * `NODE_LEFT`: Unassigned as a result of the node hosting it leaving the cluster.
 * `REALLOCATED_REPLICA`: A better replica location is identified and causes the existing replica allocation to be cancelled.
-* `REINITIALIZED`: When a shard moves from started back to initializing, for example, with shadow replicas.
+* `REINITIALIZED`: When a shard moves from started back to initializing.
 * `REPLICA_ADDED`: Unassigned as a result of explicit addition of a replica.
 * `REROUTE_CANCELLED`: Unassigned as a result of explicit cancel reroute command.
 
diff --git a/server/src/main/java/org/elasticsearch/cluster/routing/UnassignedInfo.java b/server/src/main/java/org/elasticsearch/cluster/routing/UnassignedInfo.java
index 42b3fde5e0c95..9c862c7a00052 100644
--- a/server/src/main/java/org/elasticsearch/cluster/routing/UnassignedInfo.java
+++ b/server/src/main/java/org/elasticsearch/cluster/routing/UnassignedInfo.java
@@ -104,7 +104,7 @@ public enum Reason {
          */
         REROUTE_CANCELLED,
         /**
-         * When a shard moves from started back to initializing, for example, during shadow replica
+         * When a shard moves from started back to initializing.
          */
         REINITIALIZED,
         /**

From 7f49890706254ed5391b58cb782ea1453bb5fe33 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Tue, 10 Dec 2019 08:03:43 -0800
Subject: [PATCH 142/686] [DOCS] Removes realm type security setting (#50001)

---
 docs/reference/settings/security-settings.asciidoc | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/reference/settings/security-settings.asciidoc b/docs/reference/settings/security-settings.asciidoc
index 6fb5084b94a97..e5fc39ea9036a 100644
--- a/docs/reference/settings/security-settings.asciidoc
+++ b/docs/reference/settings/security-settings.asciidoc
@@ -188,7 +188,7 @@ namespace in `elasticsearch.yml`. For example:
 ----------------------------------------
 xpack.security.authc.realms:
 
-    native.realm1:
+    native.realm1: <1>
         order: 0
         ...
 
@@ -201,6 +201,9 @@ xpack.security.authc.realms:
         ...
     ...
 ----------------------------------------
+<1> Specifies the type of realm (for example, `native`, `ldap`,
+`active_directory`, `pki`, `file`, `kerberos`, `saml`) and the realm name. This
+information is required.
 
 The valid settings vary depending on the realm type. For more
 information, see <<setting-up-authentication>>.
@@ -209,9 +212,6 @@ information, see <<setting-up-authentication>>.
 [[ref-realm-settings]]
 ===== Settings valid for all realms
 
-`type`::
-The type of the realm: `native`, `ldap`, `active_directory`, `pki`, or `file`. Required.
-
 `order`::
 The priority of the realm within the realm chain. Realms with a lower order are
 consulted first. Although not required, use of this setting is strongly

From 5e2341f7baff1fd56ff38c81792d9c0045032599 Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Tue, 10 Dec 2019 17:09:36 +0100
Subject: [PATCH 143/686] Upgrade to lucene 8.4.0-snapshot-662c455. (#50016)

Lucene 8.4 is about to be released so we should check it doesn't cause problems
with Elasticsearch.
---
 buildSrc/version.properties                      |  2 +-
 .../reference/mapping/params/normalizer.asciidoc |  6 +++---
 docs/reference/search/explain.asciidoc           |  8 ++++----
 docs/reference/search/request-body.asciidoc      |  4 ++--
 .../search/request/highlighting.asciidoc         |  8 ++++----
 .../reference/search/request/inner-hits.asciidoc |  8 ++++----
 docs/reference/search/search.asciidoc            |  4 ++--
 docs/reference/search/uri-request.asciidoc       |  4 ++--
 ...e-expressions-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...pressions-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...analyzers-icu-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...yzers-icu-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...zers-kuromoji-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...-kuromoji-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...nalyzers-nori-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...zers-nori-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...zers-phonetic-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...-phonetic-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...yzers-smartcn-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...s-smartcn-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...yzers-stempel-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...s-stempel-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...rs-morfologik-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...orfologik-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...lyzers-common-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...rs-common-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...ckward-codecs-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...rd-codecs-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 .../lucene-core-8.4.0-snapshot-662c455.jar.sha1  |  1 +
 ...cene-core-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...cene-grouping-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...-grouping-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...e-highlighter-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...ghlighter-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 .../lucene-join-8.4.0-snapshot-662c455.jar.sha1  |  1 +
 ...cene-join-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...lucene-memory-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...ne-memory-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 .../lucene-misc-8.4.0-snapshot-662c455.jar.sha1  |  1 +
 ...cene-misc-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...ucene-queries-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...e-queries-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...e-queryparser-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...eryparser-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...ucene-sandbox-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...e-sandbox-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...ucene-spatial-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...e-spatial-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...patial-extras-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...al-extras-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...ene-spatial3d-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...spatial3d-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 ...ucene-suggest-8.4.0-snapshot-662c455.jar.sha1 |  1 +
 ...e-suggest-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 .../uhighlight/CustomUnifiedHighlighter.java     |  3 +--
 .../org/elasticsearch/common/lucene/Lucene.java  |  2 +-
 .../elasticsearch/index/codec/CodecService.java  |  6 +++---
 .../codec/PerFieldMappingPostingFormatCodec.java |  4 ++--
 .../index/mapper/CompletionFieldMapper.java      |  4 ++--
 .../elasticsearch/indices/IndicesQueryCache.java |  6 +++---
 .../elasticsearch/index/codec/CodecTests.java    | 16 ++++++++--------
 .../lucene-core-8.4.0-snapshot-662c455.jar.sha1  |  1 +
 ...cene-core-8.4.0-snapshot-e648d601efb.jar.sha1 |  1 -
 63 files changed, 66 insertions(+), 67 deletions(-)
 create mode 100644 modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-analyzers-common-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-backward-codecs-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-core-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-grouping-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-highlighter-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-join-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-memory-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-misc-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-queries-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-queryparser-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-sandbox-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial-extras-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial3d-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 server/licenses/lucene-suggest-8.4.0-snapshot-e648d601efb.jar.sha1
 create mode 100644 x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
 delete mode 100644 x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-e648d601efb.jar.sha1

diff --git a/buildSrc/version.properties b/buildSrc/version.properties
index 6c7d6798a65c6..ad486276f082e 100644
--- a/buildSrc/version.properties
+++ b/buildSrc/version.properties
@@ -1,5 +1,5 @@
 elasticsearch     = 8.0.0
-lucene            = 8.4.0-snapshot-e648d601efb
+lucene            = 8.4.0-snapshot-662c455
 
 bundled_jdk_vendor = adoptopenjdk
 bundled_jdk = 13.0.1+9
diff --git a/docs/reference/mapping/params/normalizer.asciidoc b/docs/reference/mapping/params/normalizer.asciidoc
index 1e7e6870c3024..b218d311c7201 100644
--- a/docs/reference/mapping/params/normalizer.asciidoc
+++ b/docs/reference/mapping/params/normalizer.asciidoc
@@ -90,12 +90,12 @@ both index and query time.
         "value": 2,
         "relation": "eq"
     },
-    "max_score": 0.47000363,
+    "max_score": 0.4700036,
     "hits": [
       {
         "_index": "index",
         "_id": "1",
-        "_score": 0.47000363,
+        "_score": 0.4700036,
         "_source": {
           "foo": "BÀR"
         }
@@ -103,7 +103,7 @@ both index and query time.
       {
         "_index": "index",
         "_id": "2",
-        "_score": 0.47000363,
+        "_score": 0.4700036,
         "_source": {
           "foo": "bar"
         }
diff --git a/docs/reference/search/explain.asciidoc b/docs/reference/search/explain.asciidoc
index a9d431e702284..91654f32adcc8 100644
--- a/docs/reference/search/explain.asciidoc
+++ b/docs/reference/search/explain.asciidoc
@@ -106,12 +106,12 @@ The API returns the following response:
    "_id":"0",
    "matched":true,
    "explanation":{
-      "value":1.6943597,
+      "value":1.6943598,
       "description":"weight(message:elasticsearch in 0) [PerFieldSimilarity], result of:",
       "details":[
          {
-            "value":1.6943597,
-            "description":"score(freq=1.0), product of:",
+            "value":1.6943598,
+            "description":"score(freq=1.0), computed as boost * idf * tf from:",
             "details":[
                {
                   "value":2.2,
@@ -135,7 +135,7 @@ The API returns the following response:
                   ]
                },
                {
-                  "value":0.5555555,
+                  "value":0.5555556,
                   "description":"tf, computed as freq / (freq + k1 * (1 - b + b * dl / avgdl)) from:",
                   "details":[
                      {
diff --git a/docs/reference/search/request-body.asciidoc b/docs/reference/search/request-body.asciidoc
index d236a83c8eacd..c3a9fe71e16b8 100644
--- a/docs/reference/search/request-body.asciidoc
+++ b/docs/reference/search/request-body.asciidoc
@@ -118,12 +118,12 @@ The API returns the following response:
             "value": 1,
             "relation": "eq"
         },
-        "max_score": 1.3862944,
+        "max_score": 1.3862942,
         "hits" : [
             {
                 "_index" : "twitter",
                 "_id" : "0",
-                "_score": 1.3862944,
+                "_score": 1.3862942,
                 "_source" : {
                     "user" : "kimchy",
                     "message": "trying out Elasticsearch",
diff --git a/docs/reference/search/request/highlighting.asciidoc b/docs/reference/search/request/highlighting.asciidoc
index e8171d43b17f1..cb9b84ad3378f 100644
--- a/docs/reference/search/request/highlighting.asciidoc
+++ b/docs/reference/search/request/highlighting.asciidoc
@@ -840,12 +840,12 @@ Response:
             "value": 1,
             "relation": "eq"
         },
-        "max_score": 1.601195,
+        "max_score": 1.6011951,
         "hits": [
             {
                 "_index": "twitter",
                 "_id": "1",
-                "_score": 1.601195,
+                "_score": 1.6011951,
                 "_source": {
                     "user": "test",
                     "message": "some message with the number 1",
@@ -897,12 +897,12 @@ Response:
             "value": 1,
             "relation": "eq"
         },
-        "max_score": 1.601195,
+        "max_score": 1.6011951,
         "hits": [
             {
                 "_index": "twitter",
                 "_id": "1",
-                "_score": 1.601195,
+                "_score": 1.6011951,
                 "_source": {
                     "user": "test",
                     "message": "some message with the number 1",
diff --git a/docs/reference/search/request/inner-hits.asciidoc b/docs/reference/search/request/inner-hits.asciidoc
index b356c2cfc2d7c..53ae303e484a8 100644
--- a/docs/reference/search/request/inner-hits.asciidoc
+++ b/docs/reference/search/request/inner-hits.asciidoc
@@ -379,12 +379,12 @@ Which would look like:
         "value": 1,
         "relation": "eq"
     },
-    "max_score": 0.6931472,
+    "max_score": 0.6931471,
     "hits": [
       {
         "_index": "test",
         "_id": "1",
-        "_score": 0.6931472,
+        "_score": 0.6931471,
         "_source": ...,
         "inner_hits": {
           "comments.votes": { <1>
@@ -393,7 +393,7 @@ Which would look like:
                   "value": 1,
                   "relation": "eq"
               },
-              "max_score": 0.6931472,
+              "max_score": 0.6931471,
               "hits": [
                 {
                   "_index": "test",
@@ -406,7 +406,7 @@ Which would look like:
                       "offset": 0
                     }
                   },
-                  "_score": 0.6931472,
+                  "_score": 0.6931471,
                   "_source": {
                     "value": 1,
                     "voter": "kimchy"
diff --git a/docs/reference/search/search.asciidoc b/docs/reference/search/search.asciidoc
index 85c97f6c74d5a..ccec2345a0e5f 100644
--- a/docs/reference/search/search.asciidoc
+++ b/docs/reference/search/search.asciidoc
@@ -360,12 +360,12 @@ The API returns the following response:
       "value" : 1,
       "relation" : "eq"
     },
-    "max_score" : 1.3862944,
+    "max_score" : 1.3862942,
     "hits" : [
       {
         "_index" : "twitter",
         "_id" : "0",
-        "_score" : 1.3862944,
+        "_score" : 1.3862942,
         "_source" : {
           "date" : "2009-11-15T14:12:12",
           "likes" : 0,
diff --git a/docs/reference/search/uri-request.asciidoc b/docs/reference/search/uri-request.asciidoc
index ff234f415a3d0..695c4a6ada111 100644
--- a/docs/reference/search/uri-request.asciidoc
+++ b/docs/reference/search/uri-request.asciidoc
@@ -134,12 +134,12 @@ The API returns the following response:
             "value": 1,
             "relation": "eq"
         },
-        "max_score": 1.3862944,
+        "max_score": 1.3862942,
         "hits" : [
             {
                 "_index" : "twitter",
                 "_id" : "0",
-                "_score": 1.3862944,
+                "_score": 1.3862942,
                 "_source" : {
                     "user" : "kimchy",
                     "date" : "2009-11-15T14:12:12",
diff --git a/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1 b/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..1c4c5ce2b62db
--- /dev/null
+++ b/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+4041db9db7c394584571b45812734732912ef8e2
\ No newline at end of file
diff --git a/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-e648d601efb.jar.sha1 b/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 7a75661f63f65..0000000000000
--- a/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-43b9178f582373f4fcee61837404c0cc8636043e
\ No newline at end of file
diff --git a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..0fc96bc500eff
--- /dev/null
+++ b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+d5bddd6b7660439e29bbce26ded283931c756d75
\ No newline at end of file
diff --git a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-e648d601efb.jar.sha1 b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 2765cfafb0520..0000000000000
--- a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-8ee342fa6e6306e56b583251639a661250fada46
\ No newline at end of file
diff --git a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..388bc9748b7f0
--- /dev/null
+++ b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+4303858c346c51bbbc68c32eb25f7f372b09331c
\ No newline at end of file
diff --git a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-e648d601efb.jar.sha1 b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index f653bf5c3b5dc..0000000000000
--- a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-7e31f2a38d1434eb50781efc65b0e028f08d7821
\ No newline at end of file
diff --git a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..07ff7fd907a22
--- /dev/null
+++ b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+b1a9182ed1b92a121c1587fe9710aa7a41f3f77a
\ No newline at end of file
diff --git a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-e648d601efb.jar.sha1 b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 2c3ee0313a9c7..0000000000000
--- a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-9079d81a8ea2c7190ef09ca06a987d1cab2fdf17
\ No newline at end of file
diff --git a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..95e603ec18882
--- /dev/null
+++ b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+4df747b25286baecf5e790bf76bc40038c059691
\ No newline at end of file
diff --git a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-e648d601efb.jar.sha1 b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 5de2626b6ad2e..0000000000000
--- a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-f253f59d4e8bb6e55eb307b011ddb81ba0ebab92
\ No newline at end of file
diff --git a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..4eaf91f308397
--- /dev/null
+++ b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+88d3f8f9134b95884f3b80280b09aa2513b71297
\ No newline at end of file
diff --git a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-e648d601efb.jar.sha1 b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index fcb579806bfeb..0000000000000
--- a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-36547378493e6e84f63dc744df8d414cb2add1a4
\ No newline at end of file
diff --git a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..e28b8d87cd559
--- /dev/null
+++ b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+9ddccf575ee03a1329c8d1eb2e4ee7a6e3f3f56f
\ No newline at end of file
diff --git a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-e648d601efb.jar.sha1 b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index d26f99ab24e7b..0000000000000
--- a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-8b15a376efa7d4289b697144f34a819a9f8772f1
\ No newline at end of file
diff --git a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..1b8ec8c5831cb
--- /dev/null
+++ b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+e115e562a42c12a3292fb138607855c1fdfb0772
\ No newline at end of file
diff --git a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-e648d601efb.jar.sha1 b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 43a7650c70d7a..0000000000000
--- a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-d1bc4170e6981ca9af71d7a4ce46a3feb2f7b613
\ No newline at end of file
diff --git a/server/licenses/lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..d6f8049f7b1e1
--- /dev/null
+++ b/server/licenses/lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+061fb94ab616492721f8868dcaec3fbc989733be
\ No newline at end of file
diff --git a/server/licenses/lucene-analyzers-common-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-analyzers-common-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index c2ec1128c1741..0000000000000
--- a/server/licenses/lucene-analyzers-common-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-1cb225781b19e758d216987e363b77fa4b041174
\ No newline at end of file
diff --git a/server/licenses/lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..243c4420beabe
--- /dev/null
+++ b/server/licenses/lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+503f3d516889a99e1c0e2dbdba7bf9cc9900c54c
\ No newline at end of file
diff --git a/server/licenses/lucene-backward-codecs-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-backward-codecs-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index b6486fb3eeba7..0000000000000
--- a/server/licenses/lucene-backward-codecs-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-cbbf849e24ef0cc61312579acf6d6c5b72c99cf5
\ No newline at end of file
diff --git a/server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..d1657fccc5ee2
--- /dev/null
+++ b/server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+8ca36adea0a904ec725d57f509a62652a53ecff8
\ No newline at end of file
diff --git a/server/licenses/lucene-core-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-core-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 4b736046f3ade..0000000000000
--- a/server/licenses/lucene-core-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-aa74590851b6fcf536976f75448be52f6ca18a4a
\ No newline at end of file
diff --git a/server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..f1f0684d9b389
--- /dev/null
+++ b/server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+f176fdcf8fc574f4cb1c549aaa4da0301afd34ba
\ No newline at end of file
diff --git a/server/licenses/lucene-grouping-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-grouping-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 97a3c7b927b87..0000000000000
--- a/server/licenses/lucene-grouping-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-1bd113010c183168d79fbc10a6b590fdacc3fa35
\ No newline at end of file
diff --git a/server/licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..a9ad6fb95cb8b
--- /dev/null
+++ b/server/licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+db5ea7b647309e5d29fa92bcbb6b11286d11436d
\ No newline at end of file
diff --git a/server/licenses/lucene-highlighter-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-highlighter-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index f2dd654d8d64c..0000000000000
--- a/server/licenses/lucene-highlighter-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-4e44a435e14d12113ca9193182a302677fda155e
\ No newline at end of file
diff --git a/server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..6ef1d079f63f1
--- /dev/null
+++ b/server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+36329bc2ea6a5640d4128206221456656de7bbe2
\ No newline at end of file
diff --git a/server/licenses/lucene-join-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-join-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 9e8d72cc13fcf..0000000000000
--- a/server/licenses/lucene-join-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-eb8eacd015ef81ef2055ada357a92c9751308ef1
\ No newline at end of file
diff --git a/server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..eeb424851022e
--- /dev/null
+++ b/server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+083f492781b3d2c1d470bd1439c875ebf74a14eb
\ No newline at end of file
diff --git a/server/licenses/lucene-memory-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-memory-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index e6048ffd91225..0000000000000
--- a/server/licenses/lucene-memory-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-4dc565203bb1eab0222c52215891e207e7032209
\ No newline at end of file
diff --git a/server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..6f5d479c76d64
--- /dev/null
+++ b/server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+9cd5ea7bc08d93053ca993bd6fc1c9cd0a1b91fd
\ No newline at end of file
diff --git a/server/licenses/lucene-misc-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-misc-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 480dcc632907f..0000000000000
--- a/server/licenses/lucene-misc-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-ef596e6d2a7ac9c7dfc6196dad75dc719c81ce85
\ No newline at end of file
diff --git a/server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..30733a5a57764
--- /dev/null
+++ b/server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+89e39f65d1c42b5849ccf3a8e6cc9b3b277c08a6
\ No newline at end of file
diff --git a/server/licenses/lucene-queries-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-queries-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 2524672e062b1..0000000000000
--- a/server/licenses/lucene-queries-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-b0c963e68dd71444f09336258c8f63425514426a
\ No newline at end of file
diff --git a/server/licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..98b065176a418
--- /dev/null
+++ b/server/licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+651f6a0075ee30b814c8b56020d95155424c0e67
\ No newline at end of file
diff --git a/server/licenses/lucene-queryparser-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-queryparser-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 4ab7a7fe6f644..0000000000000
--- a/server/licenses/lucene-queryparser-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-bfab3e9b0467662a8ff969da215dc4a999b73076
\ No newline at end of file
diff --git a/server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..484ce6b5c00f0
--- /dev/null
+++ b/server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+935968488cc2bbcd3ced9c254f690e7c90447d9e
\ No newline at end of file
diff --git a/server/licenses/lucene-sandbox-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-sandbox-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 9361e9252f212..0000000000000
--- a/server/licenses/lucene-sandbox-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-dadfc90e4cd032f8a4db5cc1e0bdddecea635edb
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..1bb42417cb147
--- /dev/null
+++ b/server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+0bbdd0002d8d87e54b5caff6c77a1627bf449d38
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-spatial-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index ce5a13ec8d6be..0000000000000
--- a/server/licenses/lucene-spatial-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-e72dd79d30781e4d05bc8397ae61d0b51d7ad522
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..2bdbd889b4454
--- /dev/null
+++ b/server/licenses/lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+255b547571dcec118ff1a0560bb16e259f96b76a
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-extras-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-spatial-extras-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 4530b17e84e25..0000000000000
--- a/server/licenses/lucene-spatial-extras-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-e6b6dbd0526287f25d98d7fe354d5e290c875b8a
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..e7036243119a9
--- /dev/null
+++ b/server/licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+739af6d9876f6aa7f2a3d46fa3f236a5d6ee3653
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial3d-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-spatial3d-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index a96977cf1340f..0000000000000
--- a/server/licenses/lucene-spatial3d-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-6351edfc6dde2aefd8f6d8ef33ae5a6e08f88321
\ No newline at end of file
diff --git a/server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..72c92c101b050
--- /dev/null
+++ b/server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+20fa11a541a7ca3a50caa443a9abf0276b1194ea
\ No newline at end of file
diff --git a/server/licenses/lucene-suggest-8.4.0-snapshot-e648d601efb.jar.sha1 b/server/licenses/lucene-suggest-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 090cf9ee734ca..0000000000000
--- a/server/licenses/lucene-suggest-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-921dd4ab493b9d70a0b1bf7b0fe8a6790b7e8036
\ No newline at end of file
diff --git a/server/src/main/java/org/apache/lucene/search/uhighlight/CustomUnifiedHighlighter.java b/server/src/main/java/org/apache/lucene/search/uhighlight/CustomUnifiedHighlighter.java
index 2d35de522b5f0..db79122fa3da7 100644
--- a/server/src/main/java/org/apache/lucene/search/uhighlight/CustomUnifiedHighlighter.java
+++ b/server/src/main/java/org/apache/lucene/search/uhighlight/CustomUnifiedHighlighter.java
@@ -31,7 +31,6 @@
 import org.apache.lucene.search.spans.SpanQuery;
 import org.apache.lucene.search.spans.SpanTermQuery;
 import org.apache.lucene.util.BytesRef;
-import org.apache.lucene.util.automaton.CharacterRunAutomaton;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.lucene.search.MultiPhrasePrefixQuery;
 
@@ -136,7 +135,7 @@ protected FieldHighlighter getFieldHighlighter(String field, Query query, Set<Te
         BytesRef[] terms = filterExtractedTerms(fieldMatcher, allTerms);
         Set<HighlightFlag> highlightFlags = getFlags(field);
         PhraseHelper phraseHelper = getPhraseHelper(field, query, highlightFlags);
-        CharacterRunAutomaton[] automata = getAutomata(field, query, highlightFlags);
+        LabelledCharArrayMatcher[] automata = getAutomata(field, query, highlightFlags);
         UHComponents components = new UHComponents(field, fieldMatcher, query, terms, phraseHelper, automata, false , highlightFlags);
         OffsetSource offsetSource = getOptimizedOffsetSource(components);
         BreakIterator breakIterator = new SplittingBreakIterator(getBreakIterator(field),
diff --git a/server/src/main/java/org/elasticsearch/common/lucene/Lucene.java b/server/src/main/java/org/elasticsearch/common/lucene/Lucene.java
index fcab160108b29..ce00c7755205f 100644
--- a/server/src/main/java/org/elasticsearch/common/lucene/Lucene.java
+++ b/server/src/main/java/org/elasticsearch/common/lucene/Lucene.java
@@ -107,7 +107,7 @@
 public class Lucene {
     public static final String LATEST_DOC_VALUES_FORMAT = "Lucene70";
     public static final String LATEST_POSTINGS_FORMAT = "Lucene50";
-    public static final String LATEST_CODEC = "Lucene80";
+    public static final String LATEST_CODEC = "Lucene84";
 
     static {
         Deprecated annotation = PostingsFormat.forName(LATEST_POSTINGS_FORMAT).getClass().getAnnotation(Deprecated.class);
diff --git a/server/src/main/java/org/elasticsearch/index/codec/CodecService.java b/server/src/main/java/org/elasticsearch/index/codec/CodecService.java
index 485c40d5d9bbd..0b1c96a6911d9 100644
--- a/server/src/main/java/org/elasticsearch/index/codec/CodecService.java
+++ b/server/src/main/java/org/elasticsearch/index/codec/CodecService.java
@@ -22,7 +22,7 @@
 import org.apache.logging.log4j.Logger;
 import org.apache.lucene.codecs.Codec;
 import org.apache.lucene.codecs.lucene50.Lucene50StoredFieldsFormat.Mode;
-import org.apache.lucene.codecs.lucene80.Lucene80Codec;
+import org.apache.lucene.codecs.lucene84.Lucene84Codec;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.index.mapper.MapperService;
 
@@ -47,8 +47,8 @@ public class CodecService {
     public CodecService(@Nullable MapperService mapperService, Logger logger) {
         final var codecs = new HashMap<String, Codec>();
         if (mapperService == null) {
-            codecs.put(DEFAULT_CODEC, new Lucene80Codec());
-            codecs.put(BEST_COMPRESSION_CODEC, new Lucene80Codec(Mode.BEST_COMPRESSION));
+            codecs.put(DEFAULT_CODEC, new Lucene84Codec());
+            codecs.put(BEST_COMPRESSION_CODEC, new Lucene84Codec(Mode.BEST_COMPRESSION));
         } else {
             codecs.put(DEFAULT_CODEC,
                     new PerFieldMappingPostingFormatCodec(Mode.BEST_SPEED, mapperService, logger));
diff --git a/server/src/main/java/org/elasticsearch/index/codec/PerFieldMappingPostingFormatCodec.java b/server/src/main/java/org/elasticsearch/index/codec/PerFieldMappingPostingFormatCodec.java
index 4a154abd8eadd..ccaa873af2790 100644
--- a/server/src/main/java/org/elasticsearch/index/codec/PerFieldMappingPostingFormatCodec.java
+++ b/server/src/main/java/org/elasticsearch/index/codec/PerFieldMappingPostingFormatCodec.java
@@ -23,7 +23,7 @@
 import org.apache.lucene.codecs.Codec;
 import org.apache.lucene.codecs.PostingsFormat;
 import org.apache.lucene.codecs.lucene50.Lucene50StoredFieldsFormat;
-import org.apache.lucene.codecs.lucene80.Lucene80Codec;
+import org.apache.lucene.codecs.lucene84.Lucene84Codec;
 import org.elasticsearch.common.lucene.Lucene;
 import org.elasticsearch.index.mapper.CompletionFieldMapper;
 import org.elasticsearch.index.mapper.MappedFieldType;
@@ -37,7 +37,7 @@
  * per index in real time via the mapping API. If no specific postings format is
  * configured for a specific field the default postings format is used.
  */
-public class PerFieldMappingPostingFormatCodec extends Lucene80Codec {
+public class PerFieldMappingPostingFormatCodec extends Lucene84Codec {
     private final Logger logger;
     private final MapperService mapperService;
 
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/CompletionFieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/CompletionFieldMapper.java
index 5fd06633bcfc8..5f6b71d6522c2 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/CompletionFieldMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/CompletionFieldMapper.java
@@ -24,7 +24,7 @@
 import org.apache.lucene.index.Term;
 import org.apache.lucene.search.Query;
 import org.apache.lucene.search.TermQuery;
-import org.apache.lucene.search.suggest.document.Completion50PostingsFormat;
+import org.apache.lucene.search.suggest.document.Completion84PostingsFormat;
 import org.apache.lucene.search.suggest.document.CompletionAnalyzer;
 import org.apache.lucene.search.suggest.document.CompletionQuery;
 import org.apache.lucene.search.suggest.document.FuzzyCompletionQuery;
@@ -265,7 +265,7 @@ public boolean preservePositionIncrements() {
          */
         public static synchronized PostingsFormat postingsFormat() {
             if (postingsFormat == null) {
-                postingsFormat = new Completion50PostingsFormat();
+                postingsFormat = new Completion84PostingsFormat();
             }
             return postingsFormat;
         }
diff --git a/server/src/main/java/org/elasticsearch/indices/IndicesQueryCache.java b/server/src/main/java/org/elasticsearch/indices/IndicesQueryCache.java
index dc054f8b51d3e..9183b1a826563 100644
--- a/server/src/main/java/org/elasticsearch/indices/IndicesQueryCache.java
+++ b/server/src/main/java/org/elasticsearch/indices/IndicesQueryCache.java
@@ -80,7 +80,7 @@ public IndicesQueryCache(Settings settings) {
         logger.debug("using [node] query cache with size [{}] max filter count [{}]",
                 size, count);
         if (INDICES_QUERIES_CACHE_ALL_SEGMENTS_SETTING.get(settings)) {
-            cache = new ElasticsearchLRUQueryCache(count, size.getBytes(), context -> true);
+            cache = new ElasticsearchLRUQueryCache(count, size.getBytes(), context -> true, 1f);
         } else {
             cache = new ElasticsearchLRUQueryCache(count, size.getBytes());
         }
@@ -250,8 +250,8 @@ public void onClose(ShardId shardId) {
 
     private class ElasticsearchLRUQueryCache extends LRUQueryCache {
 
-        ElasticsearchLRUQueryCache(int maxSize, long maxRamBytesUsed, Predicate<LeafReaderContext> leavesToCache) {
-            super(maxSize, maxRamBytesUsed, leavesToCache);
+        ElasticsearchLRUQueryCache(int maxSize, long maxRamBytesUsed, Predicate<LeafReaderContext> leavesToCache, float skipFactor) {
+            super(maxSize, maxRamBytesUsed, leavesToCache, skipFactor);
         }
 
         ElasticsearchLRUQueryCache(int maxSize, long maxRamBytesUsed) {
diff --git a/server/src/test/java/org/elasticsearch/index/codec/CodecTests.java b/server/src/test/java/org/elasticsearch/index/codec/CodecTests.java
index fa775a84c72ad..dc5b8031a6c50 100644
--- a/server/src/test/java/org/elasticsearch/index/codec/CodecTests.java
+++ b/server/src/test/java/org/elasticsearch/index/codec/CodecTests.java
@@ -19,11 +19,16 @@
 
 package org.elasticsearch.index.codec;
 
+import static org.hamcrest.Matchers.instanceOf;
+
+import java.io.IOException;
+import java.util.Collections;
+
 import org.apache.logging.log4j.LogManager;
 import org.apache.lucene.codecs.Codec;
 import org.apache.lucene.codecs.lucene50.Lucene50StoredFieldsFormat;
 import org.apache.lucene.codecs.lucene50.Lucene50StoredFieldsFormat.Mode;
-import org.apache.lucene.codecs.lucene80.Lucene80Codec;
+import org.apache.lucene.codecs.lucene84.Lucene84Codec;
 import org.apache.lucene.document.Document;
 import org.apache.lucene.index.DirectoryReader;
 import org.apache.lucene.index.IndexWriter;
@@ -42,19 +47,14 @@
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
 
-import java.io.IOException;
-import java.util.Collections;
-
-import static org.hamcrest.Matchers.instanceOf;
-
 @SuppressCodecs("*") // we test against default codec so never get a random one here!
 public class CodecTests extends ESTestCase {
 
     public void testResolveDefaultCodecs() throws Exception {
         CodecService codecService = createCodecService();
         assertThat(codecService.codec("default"), instanceOf(PerFieldMappingPostingFormatCodec.class));
-        assertThat(codecService.codec("default"), instanceOf(Lucene80Codec.class));
-        assertThat(codecService.codec("Lucene80"), instanceOf(Lucene80Codec.class));
+        assertThat(codecService.codec("default"), instanceOf(Lucene84Codec.class));
+        assertThat(codecService.codec("Lucene84"), instanceOf(Lucene84Codec.class));
     }
 
     public void testDefault() throws Exception {
diff --git a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1 b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
new file mode 100644
index 0000000000000..d1657fccc5ee2
--- /dev/null
+++ b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
@@ -0,0 +1 @@
+8ca36adea0a904ec725d57f509a62652a53ecff8
\ No newline at end of file
diff --git a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-e648d601efb.jar.sha1 b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-e648d601efb.jar.sha1
deleted file mode 100644
index 4b736046f3ade..0000000000000
--- a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-e648d601efb.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-aa74590851b6fcf536976f75448be52f6ca18a4a
\ No newline at end of file

From d6603c26d5a6d11ca1f39a5af988659e192522ff Mon Sep 17 00:00:00 2001
From: Peter Johnson <wiz@wiz.co.nz>
Date: Tue, 10 Dec 2019 17:32:42 +0100
Subject: [PATCH 144/686] =?UTF-8?q?[Docs]=C2=A0Fix=20typo=20in=20function-?=
 =?UTF-8?q?score-query.asciidoc=20(#50030)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/reference/query-dsl/function-score-query.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/query-dsl/function-score-query.asciidoc b/docs/reference/query-dsl/function-score-query.asciidoc
index 371ba5e638145..c4924ebd36727 100644
--- a/docs/reference/query-dsl/function-score-query.asciidoc
+++ b/docs/reference/query-dsl/function-score-query.asciidoc
@@ -415,7 +415,7 @@ GET /_search
 
 `offset`::
     If an `offset` is defined, the decay function will only compute the
-    decay function for documents with a distance greater that the defined
+    decay function for documents with a distance greater than the defined
     `offset`. The default is 0.
 
 `decay`::

From 91e4f61b4267cbcd8a73db315b5269308c8e5948 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Tue, 10 Dec 2019 14:18:33 -0500
Subject: [PATCH 145/686] muting test UUIDTests.testCompression (#50050)

---
 server/src/test/java/org/elasticsearch/common/UUIDTests.java | 1 +
 1 file changed, 1 insertion(+)

diff --git a/server/src/test/java/org/elasticsearch/common/UUIDTests.java b/server/src/test/java/org/elasticsearch/common/UUIDTests.java
index dcc440acbcd1a..1d23570064fe5 100644
--- a/server/src/test/java/org/elasticsearch/common/UUIDTests.java
+++ b/server/src/test/java/org/elasticsearch/common/UUIDTests.java
@@ -116,6 +116,7 @@ public void testUUIDThreaded(UUIDGenerator uuidSource) {
         assertEquals(count*uuids, globalSet.size());
     }
 
+    @AwaitsFix(bugUrl="https://github.com/elastic/elasticsearch/issues/50048")
     public void testCompression() throws Exception {
         Logger logger = LogManager.getLogger(UUIDTests.class);
         // Low number so that the test runs quickly, but the results are more interesting with larger numbers

From cd828cc85922ab30137605f1a0c2183f51451bb4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Patryk=20Krawaczy=C5=84ski?=
 <nfsec@users.noreply.github.com>
Date: Tue, 10 Dec 2019 20:23:14 +0100
Subject: [PATCH 146/686] [DOCS] Document `index.queries.cache.enabled` as a
 static setting (#49886)

---
 docs/reference/modules/indices/query_cache.asciidoc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/reference/modules/indices/query_cache.asciidoc b/docs/reference/modules/indices/query_cache.asciidoc
index aaa1ab1742841..b61c2a6eee046 100644
--- a/docs/reference/modules/indices/query_cache.asciidoc
+++ b/docs/reference/modules/indices/query_cache.asciidoc
@@ -18,7 +18,8 @@ the cluster:
     either a percentage value, like `5%`, or an exact value, like `512mb`.
 
 The following setting is an _index_ setting that can be configured on a
-per-index basis:
+per-index basis. Can only be set at index creation time or on a
+<<indices-open-close,closed index>>:
 
 `index.queries.cache.enabled`::
 

From 48769be5bb46ff0400c78e1da06c2f5ea35d1791 Mon Sep 17 00:00:00 2001
From: Jack Conradson <osjdconrad@gmail.com>
Date: Tue, 10 Dec 2019 12:55:06 -0800
Subject: [PATCH 147/686] Update Painless AST Catch Node (#50044)

This makes two changes to the catch node:

1. Use SDeclaration to replace independent variable usage.
2. Use a DType to set a "minimum" exception type - this allows us to require
users to continue using Exception as "minimum" type for catch blocks, but
for us to internally catch Error/Throwable. This is a required step to
removing custom try/catch blocks from SClass.
---
 .../elasticsearch/painless/antlr/Walker.java  |  8 +++-
 .../painless/node/DResolvedType.java          |  2 +-
 .../elasticsearch/painless/node/SCatch.java   | 38 +++++++++----------
 .../painless/node/SDeclaration.java           |  2 +-
 .../painless/node/NodeToStringTests.java      | 14 ++++---
 5 files changed, 36 insertions(+), 28 deletions(-)

diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/antlr/Walker.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/antlr/Walker.java
index 53c98f7589ef3..9b4c52dad77b8 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/antlr/Walker.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/antlr/Walker.java
@@ -109,6 +109,7 @@
 import org.elasticsearch.painless.node.AExpression;
 import org.elasticsearch.painless.node.ANode;
 import org.elasticsearch.painless.node.AStatement;
+import org.elasticsearch.painless.node.DResolvedType;
 import org.elasticsearch.painless.node.DUnresolvedType;
 import org.elasticsearch.painless.node.EAssignment;
 import org.elasticsearch.painless.node.EBinary;
@@ -232,6 +233,10 @@ private Location location(ParserRuleContext ctx) {
         return new Location(sourceName, ctx.getStart().getStartIndex());
     }
 
+    private Location location(TerminalNode tn) {
+        return new Location(sourceName, tn.getSymbol().getStartIndex());
+    }
+
     @Override
     public ANode visitSource(SourceContext ctx) {
         List<SFunction> functions = new ArrayList<>();
@@ -503,7 +508,8 @@ public ANode visitTrap(TrapContext ctx) {
         String name = ctx.ID().getText();
         SBlock block = (SBlock)visit(ctx.block());
 
-        return new SCatch(location(ctx), type, name, block);
+        return new SCatch(location(ctx), new DResolvedType(location(ctx), Exception.class),
+                new SDeclaration(location(ctx.TYPE()), new DUnresolvedType(location(ctx.TYPE()), type), name, null), block);
     }
 
     @Override
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DResolvedType.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DResolvedType.java
index 223b39068673d..c1917944f260e 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DResolvedType.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/DResolvedType.java
@@ -76,6 +76,6 @@ public Class<?> getType() {
 
     @Override
     public String toString() {
-        return " (DResolvedType [" + PainlessLookupUtility.typeToCanonicalTypeName(type) + "])";
+        return "(DResolvedType [" + PainlessLookupUtility.typeToCanonicalTypeName(type) + "])";
     }
 }
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SCatch.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SCatch.java
index ae5e421afa18b..9fc6dc29fe217 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SCatch.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SCatch.java
@@ -22,10 +22,10 @@
 import org.elasticsearch.painless.ClassWriter;
 import org.elasticsearch.painless.Globals;
 import org.elasticsearch.painless.Locals;
-import org.elasticsearch.painless.Locals.Variable;
 import org.elasticsearch.painless.Location;
 import org.elasticsearch.painless.MethodWriter;
 import org.elasticsearch.painless.ScriptRoot;
+import org.elasticsearch.painless.lookup.PainlessLookupUtility;
 import org.objectweb.asm.Label;
 import org.objectweb.asm.Opcodes;
 
@@ -37,27 +37,25 @@
  */
 public final class SCatch extends AStatement {
 
-    private final String type;
-    private final String name;
+    private final DType baseException;
+    private final SDeclaration declaration;
     private final SBlock block;
 
-    private Variable variable = null;
-
     Label begin = null;
     Label end = null;
     Label exception = null;
 
-    public SCatch(Location location, String type, String name, SBlock block) {
+    public SCatch(Location location, DType baseException, SDeclaration declaration, SBlock block) {
         super(location);
 
-        this.type = Objects.requireNonNull(type);
-        this.name = Objects.requireNonNull(name);
+        this.baseException = Objects.requireNonNull(baseException);
+        this.declaration = Objects.requireNonNull(declaration);
         this.block = block;
     }
 
     @Override
     void extractVariables(Set<String> variables) {
-        variables.add(name);
+        declaration.extractVariables(variables);
 
         if (block != null) {
             block.extractVariables(variables);
@@ -66,18 +64,17 @@ void extractVariables(Set<String> variables) {
 
     @Override
     void analyze(ScriptRoot scriptRoot, Locals locals) {
-        Class<?> clazz = scriptRoot.getPainlessLookup().canonicalTypeNameToType(this.type);
+        declaration.analyze(scriptRoot, locals);
 
-        if (clazz == null) {
-            throw createError(new IllegalArgumentException("Not a type [" + this.type + "]."));
-        }
+        Class<?> baseType = baseException.resolveType(scriptRoot.getPainlessLookup()).getType();
+        Class<?> type = declaration.variable.clazz;
 
-        if (!Exception.class.isAssignableFrom(clazz)) {
-            throw createError(new ClassCastException("Not an exception type [" + this.type + "]."));
+        if (baseType.isAssignableFrom(type) == false) {
+            throw createError(new ClassCastException(
+                    "cannot cast from [" + PainlessLookupUtility.typeToCanonicalTypeName(type) + "] " +
+                    "to [" + PainlessLookupUtility.typeToCanonicalTypeName(baseType) + "]"));
         }
 
-        variable = locals.addVariable(location, clazz, name, true);
-
         if (block != null) {
             block.lastSource = lastSource;
             block.inLoop = inLoop;
@@ -100,7 +97,8 @@ void write(ClassWriter classWriter, MethodWriter methodWriter, Globals globals)
         Label jump = new Label();
 
         methodWriter.mark(jump);
-        methodWriter.visitVarInsn(MethodWriter.getType(variable.clazz).getOpcode(Opcodes.ISTORE), variable.getSlot());
+        methodWriter.visitVarInsn(
+                MethodWriter.getType(declaration.variable.clazz).getOpcode(Opcodes.ISTORE), declaration.variable.getSlot());
 
         if (block != null) {
             block.continu = continu;
@@ -108,7 +106,7 @@ void write(ClassWriter classWriter, MethodWriter methodWriter, Globals globals)
             block.write(classWriter, methodWriter, globals);
         }
 
-        methodWriter.visitTryCatchBlock(begin, end, jump, MethodWriter.getType(variable.clazz).getInternalName());
+        methodWriter.visitTryCatchBlock(begin, end, jump, MethodWriter.getType(declaration.variable.clazz).getInternalName());
 
         if (exception != null && (block == null || !block.allEscape)) {
             methodWriter.goTo(exception);
@@ -117,6 +115,6 @@ void write(ClassWriter classWriter, MethodWriter methodWriter, Globals globals)
 
     @Override
     public String toString() {
-        return singleLineToString(type, name, block);
+        return singleLineToString(baseException, declaration, block);
     }
 }
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
index e5d8f1e881174..bcc2036aaffd4 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SDeclaration.java
@@ -40,7 +40,7 @@ public final class SDeclaration extends AStatement {
     private final String name;
     private AExpression expression;
 
-    private Variable variable = null;
+    Variable variable = null;
 
     public SDeclaration(Location location, DType type, String name, AExpression expression) {
         super(location);
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/node/NodeToStringTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/node/NodeToStringTests.java
index 562b6e1e5e90c..60310ab0c4cd3 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/node/NodeToStringTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/node/NodeToStringTests.java
@@ -853,7 +853,8 @@ public void testSFunction() {
     public void testSTryAndSCatch() {
         assertToString(
                   "(SClass (STry (SBlock (SReturn (ENumeric 1)))\n"
-                + "  (SCatch Exception e (SBlock (SReturn (ENumeric 2))))))",
+                + "  (SCatch (DResolvedType [java.lang.Exception]) (SDeclaration (DUnresolvedType [Exception]) e) " +
+                          "(SBlock (SReturn (ENumeric 2))))))",
                   "try {\n"
                 + "  return 1\n"
                 + "} catch (Exception e) {\n"
@@ -863,7 +864,8 @@ public void testSTryAndSCatch() {
                 "(SClass (STry (SBlock\n"
               + "  (SDeclBlock (SDeclaration (DUnresolvedType [int]) i (ENumeric 1)))\n"
               + "  (SReturn (ENumeric 1)))\n"
-              + "  (SCatch Exception e (SBlock (SReturn (ENumeric 2))))))",
+              + "  (SCatch (DResolvedType [java.lang.Exception]) (SDeclaration (DUnresolvedType [Exception]) e) " +
+                        "(SBlock (SReturn (ENumeric 2))))))",
                 "try {\n"
               + "  int i = 1;"
               + "  return 1\n"
@@ -872,7 +874,7 @@ public void testSTryAndSCatch() {
               + "}");
         assertToString(
                 "(SClass (STry (SBlock (SReturn (ENumeric 1)))\n"
-              + "  (SCatch Exception e (SBlock\n"
+              + "  (SCatch (DResolvedType [java.lang.Exception]) (SDeclaration (DUnresolvedType [Exception]) e) (SBlock\n"
               + "    (SDeclBlock (SDeclaration (DUnresolvedType [int]) i (ENumeric 1)))\n"
               + "    (SReturn (ENumeric 2))))))",
                 "try {\n"
@@ -883,8 +885,10 @@ public void testSTryAndSCatch() {
               + "}");
         assertToString(
                 "(SClass (STry (SBlock (SReturn (ENumeric 1)))\n"
-              + "  (SCatch NullPointerException e (SBlock (SReturn (ENumeric 2))))\n"
-              + "  (SCatch Exception e (SBlock (SReturn (ENumeric 3))))))",
+              + "  (SCatch (DResolvedType [java.lang.Exception]) (SDeclaration (DUnresolvedType [NullPointerException]) e) " +
+                        "(SBlock (SReturn (ENumeric 2))))\n"
+              + "  (SCatch (DResolvedType [java.lang.Exception]) (SDeclaration (DUnresolvedType [Exception]) e) " +
+                        "(SBlock (SReturn (ENumeric 3))))))",
                 "try {\n"
               + "  return 1\n"
               + "} catch (NullPointerException e) {\n"

From b24d5b4f08a8644db60cc1d6015ef45b4e207d47 Mon Sep 17 00:00:00 2001
From: Stuart Cam <stuart.cam@elastic.co>
Date: Wed, 11 Dec 2019 13:23:00 +1100
Subject: [PATCH 148/686] Add the REST API specifications for SLM Status /
 Start / Stop endpoints. (#49759)

Was originally missed in PR #47710
---
 .../rest-api-spec/api/slm.get_status.json     | 19 +++++++++++++++++++
 .../rest-api-spec/api/slm.start.json          | 19 +++++++++++++++++++
 .../resources/rest-api-spec/api/slm.stop.json | 19 +++++++++++++++++++
 3 files changed, 57 insertions(+)
 create mode 100644 x-pack/plugin/src/test/resources/rest-api-spec/api/slm.get_status.json
 create mode 100644 x-pack/plugin/src/test/resources/rest-api-spec/api/slm.start.json
 create mode 100644 x-pack/plugin/src/test/resources/rest-api-spec/api/slm.stop.json

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.get_status.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.get_status.json
new file mode 100644
index 0000000000000..163ad5558c3d9
--- /dev/null
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.get_status.json
@@ -0,0 +1,19 @@
+{
+  "slm.get_status":{
+    "documentation":{
+      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/slm-get-status.html"
+    },
+    "stability":"stable",
+    "url":{
+      "paths":[
+        {
+          "path":"/_slm/status",
+          "methods":[
+            "GET"
+          ]
+        }
+      ]
+    },
+    "params":{}
+  }
+}
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.start.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.start.json
new file mode 100644
index 0000000000000..21ae3d5097862
--- /dev/null
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.start.json
@@ -0,0 +1,19 @@
+{
+  "slm.start":{
+    "documentation":{
+      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/slm-start.html"
+    },
+    "stability":"stable",
+    "url":{
+      "paths":[
+        {
+          "path":"/_slm/start",
+          "methods":[
+            "POST"
+          ]
+        }
+      ]
+    },
+    "params":{}
+  }
+}
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.stop.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.stop.json
new file mode 100644
index 0000000000000..63b74ab9c2f7e
--- /dev/null
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/slm.stop.json
@@ -0,0 +1,19 @@
+{
+  "slm.stop":{
+    "documentation":{
+      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/slm-stop.html"
+    },
+    "stability":"stable",
+    "url":{
+      "paths":[
+        {
+          "path":"/_slm/stop",
+          "methods":[
+            "POST"
+          ]
+        }
+      ]
+    },
+    "params":{}
+  }
+}

From d8d90b62a7aadd69c6cfbfd03d184a8b3fd1d526 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Wed, 11 Dec 2019 08:50:17 +0100
Subject: [PATCH 149/686] A few improvements to AnalyticsProcessManager class
 that make the code more readable. (#50026)

---
 .../dataframe/DataFrameAnalyticsManager.java  |  10 +-
 .../process/AnalyticsProcessManager.java      | 150 +++++++++---------
 .../process/AnalyticsProcessManagerTests.java |  96 ++++++-----
 3 files changed, 134 insertions(+), 122 deletions(-)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
index 76fc588027943..8e89113be7eba 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
@@ -233,15 +233,7 @@ private void startAnalytics(DataFrameAnalyticsTask task, DataFrameAnalyticsConfi
                 DataFrameAnalyticsTaskState analyzingState = new DataFrameAnalyticsTaskState(DataFrameAnalyticsState.ANALYZING,
                     task.getAllocationId(), null);
                 task.updatePersistentTaskState(analyzingState, ActionListener.wrap(
-                    updatedTask -> processManager.runJob(task, config, dataExtractorFactory,
-                        error -> {
-                            if (error != null) {
-                                task.updateState(DataFrameAnalyticsState.FAILED, error.getMessage());
-                            } else {
-                                auditor.info(config.getId(), Messages.DATA_FRAME_ANALYTICS_AUDIT_FINISHED_ANALYSIS);
-                                task.markAsCompleted();
-                            }
-                        }),
+                    updatedTask -> processManager.runJob(task, config, dataExtractorFactory),
                     error -> {
                         if (ExceptionsHelper.unwrapCause(error) instanceof ResourceNotFoundException) {
                             // Task has stopped
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
index 815d8478a5275..ce981ad17a98a 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
@@ -8,6 +8,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.action.admin.indices.refresh.RefreshAction;
 import org.elasticsearch.action.admin.indices.refresh.RefreshRequest;
 import org.elasticsearch.action.search.SearchResponse;
@@ -90,19 +91,19 @@ public AnalyticsProcessManager(Client client,
         this.trainedModelProvider = Objects.requireNonNull(trainedModelProvider);
     }
 
-    public void runJob(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig config, DataFrameDataExtractorFactory dataExtractorFactory,
-                       Consumer<Exception> finishHandler) {
+    public void runJob(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig config, DataFrameDataExtractorFactory dataExtractorFactory) {
         executorServiceForJob.execute(() -> {
-            ProcessContext processContext = new ProcessContext(config.getId());
+            ProcessContext processContext = new ProcessContext(config);
             synchronized (processContextByAllocation) {
                 if (task.isStopping()) {
                     // The task was requested to stop before we created the process context
-                    finishHandler.accept(null);
+                    auditor.info(config.getId(), Messages.DATA_FRAME_ANALYTICS_AUDIT_FINISHED_ANALYSIS);
+                    task.markAsCompleted();
                     return;
                 }
                 if (processContextByAllocation.putIfAbsent(task.getAllocationId(), processContext) != null) {
-                    finishHandler.accept(
-                        ExceptionsHelper.serverError("[" + config.getId() + "] Could not create process as one already exists"));
+                    task.updateState(
+                        DataFrameAnalyticsState.FAILED, "[" + config.getId() + "] Could not create process as one already exists");
                     return;
                 }
             }
@@ -113,13 +114,13 @@ public void runJob(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig config,
             // Fetch existing model state (if any)
             BytesReference state = getModelState(config);
 
-            if (processContext.startProcess(dataExtractorFactory, config, task, state)) {
-                executorServiceForProcess.execute(() -> processResults(processContext));
-                executorServiceForProcess.execute(() -> processData(task, config, processContext.dataExtractor,
-                    processContext.process, processContext.resultProcessor, finishHandler, state));
+            if (processContext.startProcess(dataExtractorFactory, task, state)) {
+                executorServiceForProcess.execute(() -> processContext.resultProcessor.get().process(processContext.process.get()));
+                executorServiceForProcess.execute(() -> processData(task, processContext, state));
             } else {
                 processContextByAllocation.remove(task.getAllocationId());
-                finishHandler.accept(null);
+                auditor.info(config.getId(), Messages.DATA_FRAME_ANALYTICS_AUDIT_FINISHED_ANALYSIS);
+                task.markAsCompleted();
             }
         });
     }
@@ -140,26 +141,18 @@ private BytesReference getModelState(DataFrameAnalyticsConfig config) {
         }
     }
 
-    private void processResults(ProcessContext processContext) {
+    private void processData(DataFrameAnalyticsTask task, ProcessContext processContext, BytesReference state) {
+        DataFrameAnalyticsConfig config = processContext.config;
+        DataFrameDataExtractor dataExtractor = processContext.dataExtractor.get();
+        AnalyticsProcess<AnalyticsResult> process = processContext.process.get();
+        AnalyticsResultProcessor resultProcessor = processContext.resultProcessor.get();
         try {
-            processContext.resultProcessor.process(processContext.process);
-        } catch (Exception e) {
-            processContext.setFailureReason(e.getMessage());
-        }
-    }
-
-    private void processData(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig config, DataFrameDataExtractor dataExtractor,
-                             AnalyticsProcess<AnalyticsResult> process, AnalyticsResultProcessor resultProcessor,
-                             Consumer<Exception> finishHandler, BytesReference state) {
-
-        try {
-            ProcessContext processContext = processContextByAllocation.get(task.getAllocationId());
             writeHeaderRecord(dataExtractor, process);
             writeDataRows(dataExtractor, process, config.getAnalysis(), task.getProgressTracker());
             process.writeEndOfDataMessage();
             process.flushStream();
 
-            restoreState(config, state, process, finishHandler);
+            restoreState(task, config, state, process);
 
             LOGGER.info("[{}] Waiting for result processor to complete", config.getId());
             resultProcessor.awaitForCompletion();
@@ -168,26 +161,34 @@ private void processData(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig c
             refreshDest(config);
             LOGGER.info("[{}] Result processor has completed", config.getId());
         } catch (Exception e) {
-            if (task.isStopping() == false) {
-                String errorMsg = new ParameterizedMessage("[{}] Error while processing data [{}]", config.getId(), e.getMessage())
-                    .getFormattedMessage();
+            if (task.isStopping()) {
+                // Errors during task stopping are expected but we still want to log them just in case.
+                String errorMsg =
+                    new ParameterizedMessage(
+                        "[{}] Error while processing data [{}]; task is stopping", config.getId(), e.getMessage()).getFormattedMessage();
+                LOGGER.debug(errorMsg, e);
+            } else {
+                String errorMsg =
+                    new ParameterizedMessage("[{}] Error while processing data [{}]", config.getId(), e.getMessage()).getFormattedMessage();
                 LOGGER.error(errorMsg, e);
-                processContextByAllocation.get(task.getAllocationId()).setFailureReason(errorMsg);
+                processContext.setFailureReason(errorMsg);
             }
         } finally {
             closeProcess(task);
 
-            ProcessContext processContext = processContextByAllocation.remove(task.getAllocationId());
+            processContextByAllocation.remove(task.getAllocationId());
             LOGGER.debug("Removed process context for task [{}]; [{}] processes still running", config.getId(),
                 processContextByAllocation.size());
 
             if (processContext.getFailureReason() == null) {
                 // This results in marking the persistent task as complete
                 LOGGER.info("[{}] Marking task completed", config.getId());
-                finishHandler.accept(null);
+                auditor.info(config.getId(), Messages.DATA_FRAME_ANALYTICS_AUDIT_FINISHED_ANALYSIS);
+                task.markAsCompleted();
             } else {
                 LOGGER.error("[{}] Marking task failed; {}", config.getId(), processContext.getFailureReason());
                 task.updateState(DataFrameAnalyticsState.FAILED, processContext.getFailureReason());
+                // Note: We are not marking the task as failed here as we want the user to be able to inspect the failure reason.
             }
         }
     }
@@ -239,8 +240,8 @@ private void writeHeaderRecord(DataFrameDataExtractor dataExtractor, AnalyticsPr
         process.writeRecord(headerRecord);
     }
 
-    private void restoreState(DataFrameAnalyticsConfig config, @Nullable BytesReference state, AnalyticsProcess<AnalyticsResult> process,
-                              Consumer<Exception> failureHandler) {
+    private void restoreState(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig config, @Nullable BytesReference state,
+                              AnalyticsProcess<AnalyticsResult> process) {
         if (config.getAnalysis().persistsState() == false) {
             LOGGER.debug("[{}] Analysis does not support state", config.getId());
             return;
@@ -258,7 +259,7 @@ private void restoreState(DataFrameAnalyticsConfig config, @Nullable BytesRefere
             process.restoreState(state);
         } catch (Exception e) {
             LOGGER.error(new ParameterizedMessage("[{}] Failed to restore state", process.getConfig().jobId()), e);
-            failureHandler.accept(ExceptionsHelper.serverError("Failed to restore state", e));
+            task.updateState(DataFrameAnalyticsState.FAILED, "Failed to restore state: " + e.getMessage());
         }
     }
 
@@ -293,9 +294,10 @@ private void closeProcess(DataFrameAnalyticsTask task) {
 
         ProcessContext processContext = processContextByAllocation.get(task.getAllocationId());
         try {
-            processContext.process.close();
+            processContext.process.get().close();
             LOGGER.info("[{}] Closed process", configId);
         } catch (Exception e) {
+            LOGGER.error("[" + configId + "] Error closing data frame analyzer process", e);
             String errorMsg = new ParameterizedMessage(
                 "[{}] Error closing data frame analyzer process [{}]", configId, e.getMessage()).getFormattedMessage();
             processContext.setFailureReason(errorMsg);
@@ -323,42 +325,41 @@ int getProcessContextCount() {
 
     class ProcessContext {
 
-        private final String id;
-        private volatile AnalyticsProcess<AnalyticsResult> process;
-        private volatile DataFrameDataExtractor dataExtractor;
-        private volatile AnalyticsResultProcessor resultProcessor;
-        private volatile boolean processKilled;
-        private volatile String failureReason;
+        private final DataFrameAnalyticsConfig config;
+        private final SetOnce<AnalyticsProcess<AnalyticsResult>> process = new SetOnce<>();
+        private final SetOnce<DataFrameDataExtractor> dataExtractor = new SetOnce<>();
+        private final SetOnce<AnalyticsResultProcessor> resultProcessor = new SetOnce<>();
+        private final SetOnce<String> failureReason = new SetOnce<>();
 
-        ProcessContext(String id) {
-            this.id = Objects.requireNonNull(id);
+        ProcessContext(DataFrameAnalyticsConfig config) {
+            this.config = Objects.requireNonNull(config);
         }
 
-        synchronized String getFailureReason() {
-            return failureReason;
+        String getFailureReason() {
+            return failureReason.get();
         }
 
-        synchronized void setFailureReason(String failureReason) {
-            // Only set the new reason if there isn't one already as we want to keep the first reason
-            if (this.failureReason == null && failureReason != null) {
-                this.failureReason = failureReason;
+        void setFailureReason(String failureReason) {
+            if (failureReason == null) {
+                return;
             }
+            // Only set the new reason if there isn't one already as we want to keep the first reason (most likely the root cause).
+            this.failureReason.trySet(failureReason);
         }
 
         synchronized void stop() {
-            LOGGER.debug("[{}] Stopping process", id);
-            processKilled = true;
-            if (dataExtractor != null) {
-                dataExtractor.cancel();
+            LOGGER.debug("[{}] Stopping process", config.getId());
+            if (dataExtractor.get() != null) {
+                dataExtractor.get().cancel();
             }
-            if (resultProcessor != null) {
-                resultProcessor.cancel();
+            if (resultProcessor.get() != null) {
+                resultProcessor.get().cancel();
             }
-            if (process != null) {
+            if (process.get() != null) {
                 try {
-                    process.kill();
+                    process.get().kill();
                 } catch (IOException e) {
-                    LOGGER.error(new ParameterizedMessage("[{}] Failed to kill process", id), e);
+                    LOGGER.error(new ParameterizedMessage("[{}] Failed to kill process", config.getId()), e);
                 }
             }
         }
@@ -366,16 +367,17 @@ synchronized void stop() {
         /**
          * @return {@code true} if the process was started or {@code false} if it was not because it was stopped in the meantime
          */
-        synchronized boolean startProcess(DataFrameDataExtractorFactory dataExtractorFactory, DataFrameAnalyticsConfig config,
-                                          DataFrameAnalyticsTask task, @Nullable BytesReference state) {
-            if (processKilled) {
+        synchronized boolean startProcess(DataFrameDataExtractorFactory dataExtractorFactory,
+                                          DataFrameAnalyticsTask task,
+                                          @Nullable BytesReference state) {
+            if (task.isStopping()) {
                 // The job was stopped before we started the process so no need to start it
                 return false;
             }
 
-            dataExtractor = dataExtractorFactory.newExtractor(false);
+            dataExtractor.set(dataExtractorFactory.newExtractor(false));
             AnalyticsProcessConfig analyticsProcessConfig =
-                createProcessConfig(config, dataExtractor, dataExtractorFactory.getExtractedFields());
+                createProcessConfig(dataExtractor.get(), dataExtractorFactory.getExtractedFields());
             LOGGER.trace("[{}] creating analytics process with config [{}]", config.getId(), Strings.toString(analyticsProcessConfig));
             // If we have no rows, that means there is no data so no point in starting the native process
             // just finish the task
@@ -383,19 +385,16 @@ synchronized boolean startProcess(DataFrameDataExtractorFactory dataExtractorFac
                 LOGGER.info("[{}] no data found to analyze. Will not start analytics native process.", config.getId());
                 return false;
             }
-            process = createProcess(task, config, analyticsProcessConfig, state);
-            DataFrameRowsJoiner dataFrameRowsJoiner = new DataFrameRowsJoiner(config.getId(), client,
-                dataExtractorFactory.newExtractor(true));
-            resultProcessor = new AnalyticsResultProcessor(
-                config, dataFrameRowsJoiner, task.getProgressTracker(), trainedModelProvider, auditor, dataExtractor.getFieldNames());
+            process.set(createProcess(task, config, analyticsProcessConfig, state));
+            resultProcessor.set(createResultProcessor(task, dataExtractorFactory));
             return true;
         }
 
-        private AnalyticsProcessConfig createProcessConfig(
-                DataFrameAnalyticsConfig config, DataFrameDataExtractor dataExtractor, ExtractedFields extractedFields) {
+        private AnalyticsProcessConfig createProcessConfig(DataFrameDataExtractor dataExtractor,
+                                                           ExtractedFields extractedFields) {
             DataFrameDataExtractor.DataSummary dataSummary = dataExtractor.collectDataSummary();
             Set<String> categoricalFields = dataExtractor.getCategoricalFields(config.getAnalysis());
-            AnalyticsProcessConfig processConfig = new AnalyticsProcessConfig(
+            return new AnalyticsProcessConfig(
                 config.getId(),
                 dataSummary.rows,
                 dataSummary.cols,
@@ -405,7 +404,14 @@ private AnalyticsProcessConfig createProcessConfig(
                 categoricalFields,
                 config.getAnalysis(),
                 extractedFields);
-            return processConfig;
+        }
+
+        private AnalyticsResultProcessor createResultProcessor(DataFrameAnalyticsTask task,
+                                                               DataFrameDataExtractorFactory dataExtractorFactory) {
+            DataFrameRowsJoiner dataFrameRowsJoiner =
+                new DataFrameRowsJoiner(config.getId(), client, dataExtractorFactory.newExtractor(true));
+            return new AnalyticsResultProcessor(
+                config, dataFrameRowsJoiner, task.getProgressTracker(), trainedModelProvider, auditor, dataExtractor.get().getFieldNames());
         }
     }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManagerTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManagerTests.java
index 4a0d5fa7f36df..915d6c29efb4d 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManagerTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManagerTests.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfigTests;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsState;
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask;
 import org.elasticsearch.xpack.ml.dataframe.extractor.DataFrameDataExtractor;
 import org.elasticsearch.xpack.ml.dataframe.extractor.DataFrameDataExtractorFactory;
@@ -22,12 +23,10 @@
 import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelProvider;
 import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
 import org.junit.Before;
-import org.mockito.ArgumentCaptor;
 import org.mockito.InOrder;
 
 import java.util.List;
 import java.util.concurrent.ExecutorService;
-import java.util.function.Consumer;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
@@ -37,7 +36,6 @@
 import static org.mockito.Mockito.inOrder;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.times;
-import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.verifyNoMoreInteractions;
 import static org.mockito.Mockito.when;
 
@@ -66,8 +64,6 @@ public class AnalyticsProcessManagerTests extends ESTestCase {
     private DataFrameAnalyticsConfig dataFrameAnalyticsConfig;
     private DataFrameDataExtractorFactory dataExtractorFactory;
     private DataFrameDataExtractor dataExtractor;
-    private Consumer<Exception> finishHandler;
-    private ArgumentCaptor<Exception> exceptionCaptor;
     private AnalyticsProcessManager processManager;
 
     @SuppressWarnings("unchecked")
@@ -97,9 +93,6 @@ public void setUpMocks() {
         dataExtractorFactory = mock(DataFrameDataExtractorFactory.class);
         when(dataExtractorFactory.newExtractor(anyBoolean())).thenReturn(dataExtractor);
         when(dataExtractorFactory.getExtractedFields()).thenReturn(mock(ExtractedFields.class));
-        finishHandler = mock(Consumer.class);
-
-        exceptionCaptor = ArgumentCaptor.forClass(Exception.class);
 
         processManager = new AnalyticsProcessManager(
             client, executorServiceForJob, executorServiceForProcess, processFactory, auditor, trainedModelProvider);
@@ -108,54 +101,68 @@ public void setUpMocks() {
     public void testRunJob_TaskIsStopping() {
         when(task.isStopping()).thenReturn(true);
 
-        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory, finishHandler);
+        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory);
         assertThat(processManager.getProcessContextCount(), equalTo(0));
 
-        verify(finishHandler).accept(null);
-        verifyNoMoreInteractions(finishHandler);
+        InOrder inOrder = inOrder(task);
+        inOrder.verify(task).isStopping();
+        inOrder.verify(task).markAsCompleted();
+        verifyNoMoreInteractions(task);
     }
 
     public void testRunJob_ProcessContextAlreadyExists() {
-        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory, finishHandler);
+        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory);
         assertThat(processManager.getProcessContextCount(), equalTo(1));
-        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory, finishHandler);
+        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory);
         assertThat(processManager.getProcessContextCount(), equalTo(1));
 
-        verify(finishHandler).accept(exceptionCaptor.capture());
-        verifyNoMoreInteractions(finishHandler);
-
-        Exception e = exceptionCaptor.getValue();
-        assertThat(e.getMessage(), equalTo("[config-id] Could not create process as one already exists"));
+        InOrder inOrder = inOrder(task);
+        inOrder.verify(task).isStopping();
+        inOrder.verify(task).getAllocationId();
+        inOrder.verify(task).isStopping();
+        inOrder.verify(task).getProgressTracker();
+        inOrder.verify(task).isStopping();
+        inOrder.verify(task).getAllocationId();
+        inOrder.verify(task).updateState(DataFrameAnalyticsState.FAILED, "[config-id] Could not create process as one already exists");
+        verifyNoMoreInteractions(task);
     }
 
     public void testRunJob_EmptyDataFrame() {
         when(dataExtractor.collectDataSummary()).thenReturn(new DataFrameDataExtractor.DataSummary(0, NUM_COLS));
 
-        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory, finishHandler);
+        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory);
         assertThat(processManager.getProcessContextCount(), equalTo(0));  // Make sure the process context did not leak
 
-        InOrder inOrder = inOrder(dataExtractor, executorServiceForProcess, process, finishHandler);
+        InOrder inOrder = inOrder(dataExtractor, executorServiceForProcess, process, task);
+        inOrder.verify(task).isStopping();
+        inOrder.verify(task).getAllocationId();
+        inOrder.verify(task).isStopping();
         inOrder.verify(dataExtractor).collectDataSummary();
         inOrder.verify(dataExtractor).getCategoricalFields(dataFrameAnalyticsConfig.getAnalysis());
-        inOrder.verify(finishHandler).accept(null);
-        verifyNoMoreInteractions(dataExtractor, executorServiceForProcess, process, finishHandler);
+        inOrder.verify(task).getAllocationId();
+        inOrder.verify(task).markAsCompleted();
+        verifyNoMoreInteractions(dataExtractor, executorServiceForProcess, process, task);
     }
 
     public void testRunJob_Ok() {
-        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory, finishHandler);
+        processManager.runJob(task, dataFrameAnalyticsConfig, dataExtractorFactory);
         assertThat(processManager.getProcessContextCount(), equalTo(1));
 
-        InOrder inOrder = inOrder(dataExtractor, executorServiceForProcess, process, finishHandler);
+        InOrder inOrder = inOrder(dataExtractor, executorServiceForProcess, process, task);
+        inOrder.verify(task).isStopping();
+        inOrder.verify(task).getAllocationId();
+        inOrder.verify(task).isStopping();
         inOrder.verify(dataExtractor).collectDataSummary();
         inOrder.verify(dataExtractor).getCategoricalFields(dataFrameAnalyticsConfig.getAnalysis());
         inOrder.verify(process).isProcessAlive();
+        inOrder.verify(task).getProgressTracker();
         inOrder.verify(dataExtractor).getFieldNames();
         inOrder.verify(executorServiceForProcess, times(2)).execute(any());  // 'processData' and 'processResults' threads
-        verifyNoMoreInteractions(dataExtractor, executorServiceForProcess, process, finishHandler);
+        verifyNoMoreInteractions(dataExtractor, executorServiceForProcess, process, task);
     }
 
     public void testProcessContext_GetSetFailureReason() {
-        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(CONFIG_ID);
+        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(dataFrameAnalyticsConfig);
         assertThat(processContext.getFailureReason(), is(nullValue()));
 
         processContext.setFailureReason("reason1");
@@ -167,50 +174,57 @@ public void testProcessContext_GetSetFailureReason() {
         processContext.setFailureReason("reason2");
         assertThat(processContext.getFailureReason(), equalTo("reason1"));
 
-        verifyNoMoreInteractions(dataExtractor, process, finishHandler);
+        verifyNoMoreInteractions(dataExtractor, process, task);
     }
 
-    public void testProcessContext_StartProcess_ProcessAlreadyKilled() {
-        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(CONFIG_ID);
+    public void testProcessContext_StartProcess_TaskAlreadyStopped() {
+        when(task.isStopping()).thenReturn(true);
+
+        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(dataFrameAnalyticsConfig);
         processContext.stop();
-        assertThat(processContext.startProcess(dataExtractorFactory, dataFrameAnalyticsConfig, task, null), is(false));
+        assertThat(processContext.startProcess(dataExtractorFactory, task, null), is(false));
 
-        verifyNoMoreInteractions(dataExtractor, process, finishHandler);
+        InOrder inOrder = inOrder(dataExtractor, process, task);
+        inOrder.verify(task).isStopping();
+        verifyNoMoreInteractions(dataExtractor, process, task);
     }
 
     public void testProcessContext_StartProcess_EmptyDataFrame() {
         when(dataExtractor.collectDataSummary()).thenReturn(new DataFrameDataExtractor.DataSummary(0, NUM_COLS));
 
-        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(CONFIG_ID);
-        assertThat(processContext.startProcess(dataExtractorFactory, dataFrameAnalyticsConfig, task, null), is(false));
+        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(dataFrameAnalyticsConfig);
+        assertThat(processContext.startProcess(dataExtractorFactory, task, null), is(false));
 
-        InOrder inOrder = inOrder(dataExtractor, process, finishHandler);
+        InOrder inOrder = inOrder(dataExtractor, process, task);
+        inOrder.verify(task).isStopping();
         inOrder.verify(dataExtractor).collectDataSummary();
         inOrder.verify(dataExtractor).getCategoricalFields(dataFrameAnalyticsConfig.getAnalysis());
-        verifyNoMoreInteractions(dataExtractor, process, finishHandler);
+        verifyNoMoreInteractions(dataExtractor, process, task);
     }
 
     public void testProcessContext_StartAndStop() throws Exception {
-        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(CONFIG_ID);
-        assertThat(processContext.startProcess(dataExtractorFactory, dataFrameAnalyticsConfig, task, null), is(true));
+        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(dataFrameAnalyticsConfig);
+        assertThat(processContext.startProcess(dataExtractorFactory, task, null), is(true));
         processContext.stop();
 
-        InOrder inOrder = inOrder(dataExtractor, process, finishHandler);
+        InOrder inOrder = inOrder(dataExtractor, process, task);
         // startProcess
+        inOrder.verify(task).isStopping();
         inOrder.verify(dataExtractor).collectDataSummary();
         inOrder.verify(dataExtractor).getCategoricalFields(dataFrameAnalyticsConfig.getAnalysis());
         inOrder.verify(process).isProcessAlive();
+        inOrder.verify(task).getProgressTracker();
         inOrder.verify(dataExtractor).getFieldNames();
         // stop
         inOrder.verify(dataExtractor).cancel();
         inOrder.verify(process).kill();
-        verifyNoMoreInteractions(dataExtractor, process, finishHandler);
+        verifyNoMoreInteractions(dataExtractor, process, task);
     }
 
     public void testProcessContext_Stop() {
-        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(CONFIG_ID);
+        AnalyticsProcessManager.ProcessContext processContext = processManager.new ProcessContext(dataFrameAnalyticsConfig);
         processContext.stop();
 
-        verifyNoMoreInteractions(dataExtractor, process, finishHandler);
+        verifyNoMoreInteractions(dataExtractor, process, task);
     }
 }

From 813ed0c67778e4762173f5e898e22fcd94b76073 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Wed, 11 Dec 2019 10:00:41 +0200
Subject: [PATCH 150/686] [ml] Fix randomize_seed versions and unmute BWC tests
 (#50027)

... now that #49990 has been backported.

Relates #49990
---
 .../xpack/core/ml/dataframe/analyses/Classification.java    | 6 +++---
 .../xpack/core/ml/dataframe/analyses/Regression.java        | 6 +++---
 .../test/mixed_cluster/90_ml_data_frame_analytics_crud.yml  | 6 +-----
 .../test/old_cluster/90_ml_data_frame_analytics_crud.yml    | 3 ---
 .../upgraded_cluster/90_ml_data_frame_analytics_crud.yml    | 6 +-----
 5 files changed, 8 insertions(+), 19 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
index cd96b815fc11e..ed4cb1fe18f8e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
@@ -119,7 +119,7 @@ public Classification(StreamInput in) throws IOException {
         predictionFieldName = in.readOptionalString();
         numTopClasses = in.readOptionalVInt();
         trainingPercent = in.readDouble();
-        if (in.getVersion().onOrAfter(Version.CURRENT)) {
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
             randomizeSeed = in.readOptionalLong();
         } else {
             randomizeSeed = Randomness.get().nextLong();
@@ -163,7 +163,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeOptionalString(predictionFieldName);
         out.writeOptionalVInt(numTopClasses);
         out.writeDouble(trainingPercent);
-        if (out.getVersion().onOrAfter(Version.CURRENT)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             out.writeOptionalLong(randomizeSeed);
         }
     }
@@ -180,7 +180,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             builder.field(PREDICTION_FIELD_NAME.getPreferredName(), predictionFieldName);
         }
         builder.field(TRAINING_PERCENT.getPreferredName(), trainingPercent);
-        if (version.onOrAfter(Version.CURRENT)) {
+        if (version.onOrAfter(Version.V_7_6_0)) {
             builder.field(RANDOMIZE_SEED.getPreferredName(), randomizeSeed);
         }
         builder.endObject();
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
index dd8f6a91272c2..8fffcd0f573da 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
@@ -91,7 +91,7 @@ public Regression(StreamInput in) throws IOException {
         boostedTreeParams = new BoostedTreeParams(in);
         predictionFieldName = in.readOptionalString();
         trainingPercent = in.readDouble();
-        if (in.getVersion().onOrAfter(Version.CURRENT)) {
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
             randomizeSeed = in.readOptionalLong();
         } else {
             randomizeSeed = Randomness.get().nextLong();
@@ -130,7 +130,7 @@ public void writeTo(StreamOutput out) throws IOException {
         boostedTreeParams.writeTo(out);
         out.writeOptionalString(predictionFieldName);
         out.writeDouble(trainingPercent);
-        if (out.getVersion().onOrAfter(Version.CURRENT)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             out.writeOptionalLong(randomizeSeed);
         }
     }
@@ -146,7 +146,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             builder.field(PREDICTION_FIELD_NAME.getPreferredName(), predictionFieldName);
         }
         builder.field(TRAINING_PERCENT.getPreferredName(), trainingPercent);
-        if (version.onOrAfter(Version.CURRENT)) {
+        if (version.onOrAfter(Version.V_7_6_0)) {
             builder.field(RANDOMIZE_SEED.getPreferredName(), randomizeSeed);
         }
         builder.endObject();
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
index 8082147160718..7780691b2bbbd 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,8 +1,3 @@
-setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
-
 ---
 "Get old outlier_detection job":
 
@@ -65,6 +60,7 @@ setup:
   - match: { data_frame_analytics.0.dest.index: "old_cluster_regression_job_results" }
   - match: { data_frame_analytics.0.analysis.regression.dependent_variable: "foo" }
   - match: { data_frame_analytics.0.analysis.regression.training_percent: 100.0 }
+  - is_true: data_frame_analytics.0.analysis.regression.randomize_seed
 
 ---
 "Get old regression job stats":
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
index ba2cf40411672..fe160bba15f23 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,7 +1,4 @@
 setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
 
   - do:
       index:
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
index 462a1fd76c011..14438883f0da1 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,8 +1,3 @@
-setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/49690"
-
 ---
 "Get old cluster outlier_detection job":
 
@@ -45,6 +40,7 @@ setup:
   - match: { data_frame_analytics.0.dest.index: "old_cluster_regression_job_results" }
   - match: { data_frame_analytics.0.analysis.regression.dependent_variable: "foo" }
   - match: { data_frame_analytics.0.analysis.regression.training_percent: 100.0 }
+  - is_true: data_frame_analytics.0.analysis.regression.randomize_seed
 
 ---
 "Get old cluster regression job stats":

From 1dd2584a9eb817e4a6df772c5d6af11cde69113d Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Wed, 11 Dec 2019 15:14:33 +0200
Subject: [PATCH 151/686] [ML] Avoid classification integ test training on
 single class (#50072)

The `ClassificationIT.testTwoJobsWithSameRandomizeSeedUseSameTrainingSet`
test was previously set up to just have 10 rows. With `training_percent`
of 50%, only 5 rows will be used for training. There is a good chance that
all 5 rows will be of one class which results to failure.

This commit increases the rows to 100. Now 50 rows should be used for training
and the chance of failure should be very small.
---
 .../elasticsearch/xpack/ml/integration/ClassificationIT.java | 5 ++++-
 .../integration/MlNativeDataFrameAnalyticsIntegTestCase.java | 2 +-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index e7c0ccd0e0554..0e49043fcfbe5 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -274,7 +274,10 @@ public void testDependentVariableCardinalityTooHighButWithQueryMakesItWithinRang
     public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exception {
         String sourceIndex = "classification_two_jobs_with_same_randomize_seed_source";
         String dependentVariable = KEYWORD_FIELD;
-        indexData(sourceIndex, 10, 0, dependentVariable);
+
+        // We use 100 rows as we can't set this too low. If too low it is possible
+        // we only train with rows of one of the two classes which leads to a failure.
+        indexData(sourceIndex, 100, 0, dependentVariable);
 
         String firstJobId = "classification_two_jobs_with_same_randomize_seed_1";
         String firstJobDestIndex = firstJobId + "_dest";
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
index 99223247d7305..8ff82c28b36e0 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
@@ -259,7 +259,7 @@ private static List<String> fetchAllAuditMessages(String dataFrameAnalyticsId) {
 
     protected static Set<String> getTrainingRowsIds(String index) {
         Set<String> trainingRowsIds = new HashSet<>();
-        SearchResponse hits = client().prepareSearch(index).get();
+        SearchResponse hits = client().prepareSearch(index).setSize(10000).get();
         for (SearchHit hit : hits.getHits()) {
             Map<String, Object> sourceAsMap = hit.getSourceAsMap();
             assertThat(sourceAsMap.containsKey("ml"), is(true));

From 3da8cf03484e9993df4aeb94b2d8cfaf1a8b02cb Mon Sep 17 00:00:00 2001
From: Przemko Robakowski <przemko.robakowski@elastic.co>
Date: Wed, 11 Dec 2019 14:52:04 +0100
Subject: [PATCH 152/686] CSV ingest processor (#49509)

* CSV Processor for Ingest

This change adds new ingest processor that breaks line from CSV file into separate fields.
By default it conforms to RFC 4180 but can be tweaked.

Closes #49113
---
 docs/reference/ingest/ingest-node.asciidoc    |   1 +
 docs/reference/ingest/processors/csv.asciidoc |  33 +++
 .../ingest/common/CsvParser.java              | 206 ++++++++++++++++
 .../ingest/common/CsvProcessor.java           | 108 +++++++++
 .../ingest/common/IngestCommonPlugin.java     |   3 +-
 .../ingest/common/CsvProcessorTests.java      | 221 ++++++++++++++++++
 .../rest-api-spec/test/ingest/250_csv.yml     | 164 +++++++++++++
 7 files changed, 735 insertions(+), 1 deletion(-)
 create mode 100644 docs/reference/ingest/processors/csv.asciidoc
 create mode 100644 modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/CsvParser.java
 create mode 100644 modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/CsvProcessor.java
 create mode 100644 modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/CsvProcessorTests.java
 create mode 100644 modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/250_csv.yml

diff --git a/docs/reference/ingest/ingest-node.asciidoc b/docs/reference/ingest/ingest-node.asciidoc
index 0da0fd19e16ef..596bda67d3ed8 100644
--- a/docs/reference/ingest/ingest-node.asciidoc
+++ b/docs/reference/ingest/ingest-node.asciidoc
@@ -825,6 +825,7 @@ include::processors/append.asciidoc[]
 include::processors/bytes.asciidoc[]
 include::processors/circle.asciidoc[]
 include::processors/convert.asciidoc[]
+include::processors/csv.asciidoc[]
 include::processors/date.asciidoc[]
 include::processors/date-index-name.asciidoc[]
 include::processors/dissect.asciidoc[]
diff --git a/docs/reference/ingest/processors/csv.asciidoc b/docs/reference/ingest/processors/csv.asciidoc
new file mode 100644
index 0000000000000..c589c9eb4361c
--- /dev/null
+++ b/docs/reference/ingest/processors/csv.asciidoc
@@ -0,0 +1,33 @@
+[[csv-processor]]
+=== CSV Processor
+Extracts fields from CSV line out of a single text field within a document. Any empty field in CSV will be skipped.
+
+[[csv-options]]
+.CSV Options
+[options="header"]
+|======
+| Name              | Required  | Default  | Description
+| `field`           | yes       | -        | The field to extract data from
+| `target_fields`   | yes       | -        | The array of fields to assign extracted values to
+| `separator`       | no        | ,        | Separator used in CSV, has to be single character string
+| `quote`           | no        | "        | Quote used in CSV, has to be single character string
+| `ignore_missing`  | no        | `true`   | If `true` and `field` does not exist, the processor quietly exits without modifying the document
+| `trim`            | no        | `false`  | Trim whitespaces in unquoted fields
+include::common-options.asciidoc[]
+|======
+
+[source,js]
+--------------------------------------------------
+{
+  "csv": {
+    "field": "my_field",
+    "target_fields": ["field1, field2"],
+  }
+}
+--------------------------------------------------
+// NOTCONSOLE
+
+If the `trim` option is enabled then any whitespace in the beginning and in the end of each unquoted field will be trimmed.
+For example with configuration above, a value of `A, B` will result in field `field2`
+having value `{nbsp}B` (with space at the beginning). If `trim` is enabled `A, B` will result in field `field2`
+having value `B` (no whitespace). Quoted fields will be left untouched.
diff --git a/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/CsvParser.java b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/CsvParser.java
new file mode 100644
index 0000000000000..077d12684e9a1
--- /dev/null
+++ b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/CsvParser.java
@@ -0,0 +1,206 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.ingest.common;
+
+import org.elasticsearch.ingest.IngestDocument;
+
+final class CsvParser {
+
+    private static final char LF = '\n';
+    private static final char CR = '\r';
+    private static final char SPACE = ' ';
+    private static final char TAB = '\t';
+
+    private enum State {
+        START, UNQUOTED, QUOTED, QUOTED_END
+    }
+
+    private final char quote;
+    private final char separator;
+    private final boolean trim;
+    private final String[] headers;
+    private final IngestDocument ingestDocument;
+    private final StringBuilder builder = new StringBuilder();
+    private State state = State.START;
+    private String line;
+    private int currentHeader = 0;
+    private int startIndex = 0;
+    private int length;
+    private int currentIndex;
+
+    CsvParser(IngestDocument ingestDocument, char quote, char separator, boolean trim, String[] headers) {
+        this.ingestDocument = ingestDocument;
+        this.quote = quote;
+        this.separator = separator;
+        this.trim = trim;
+        this.headers = headers;
+    }
+
+    void process(String line) {
+        this.line = line;
+        length = line.length();
+        for (currentIndex = 0; currentIndex < length; currentIndex++) {
+            switch (state) {
+                case START:
+                    if (processStart()) {
+                        return;
+                    }
+                    break;
+                case UNQUOTED:
+                    if (processUnquoted()) {
+                        return;
+                    }
+                    break;
+                case QUOTED:
+                    processQuoted();
+                    break;
+                case QUOTED_END:
+                    if (processQuotedEnd()) {
+                        return;
+                    }
+                    break;
+            }
+        }
+
+        //we've reached end of string, we need to handle last field
+        switch (state) {
+            case UNQUOTED:
+                setField(length);
+                break;
+            case QUOTED_END:
+                setField(length - 1);
+                break;
+            case QUOTED:
+                throw new IllegalArgumentException("Unmatched quote");
+        }
+    }
+
+    private boolean processStart() {
+        for (; currentIndex < length; currentIndex++) {
+            char c = currentChar();
+            if (c == quote) {
+                state = State.QUOTED;
+                builder.setLength(0);
+                startIndex = currentIndex + 1;
+                return false;
+            } else if (c == separator) {
+                startIndex++;
+                if (nextHeader()) {
+                    return true;
+                }
+            } else if (isWhitespace(c)) {
+                if (trim) {
+                    startIndex++;
+                }
+            } else {
+                state = State.UNQUOTED;
+                builder.setLength(0);
+                return false;
+            }
+        }
+        return true;
+    }
+
+    private boolean processUnquoted() {
+        int spaceCount = 0;
+        for (; currentIndex < length; currentIndex++) {
+            char c = currentChar();
+            if (c == LF || c == CR || c == quote) {
+                throw new IllegalArgumentException("Illegal character inside unquoted field at " + currentIndex);
+            } else if (trim && isWhitespace(c)) {
+                spaceCount++;
+            } else if (c == separator) {
+                state = State.START;
+                if (setField(currentIndex - spaceCount)) {
+                    return true;
+                }
+                startIndex = currentIndex + 1;
+                return false;
+            } else {
+                spaceCount = 0;
+            }
+        }
+        return false;
+    }
+
+    private void processQuoted() {
+        for (; currentIndex < length; currentIndex++) {
+            if (currentChar() == quote) {
+                state = State.QUOTED_END;
+                break;
+            }
+        }
+    }
+
+    private boolean processQuotedEnd() {
+        char c = currentChar();
+        if (c == quote) {
+            builder.append(line, startIndex, currentIndex - 1).append(quote);
+            startIndex = currentIndex + 1;
+            state = State.QUOTED;
+            return false;
+        }
+        boolean shouldSetField = true;
+        for (; currentIndex < length; currentIndex++) {
+            c = currentChar();
+            if (isWhitespace(c)) {
+                if (shouldSetField) {
+                    if (setField(currentIndex - 1)) {
+                        return true;
+                    }
+                    shouldSetField = false;
+                }
+            } else if (c == separator) {
+                if (shouldSetField && setField(currentIndex - 1)) {
+                    return true;
+                }
+                startIndex = currentIndex + 1;
+                state = State.START;
+                return false;
+            } else {
+                throw new IllegalArgumentException("character '" + c + "' after quoted field at " + currentIndex);
+            }
+        }
+        return true;
+    }
+
+    private char currentChar() {
+        return line.charAt(currentIndex);
+    }
+
+    private boolean isWhitespace(char c) {
+        return c == SPACE || c == TAB;
+    }
+
+    private boolean setField(int endIndex) {
+        if (builder.length() == 0) {
+            ingestDocument.setFieldValue(headers[currentHeader], line.substring(startIndex, endIndex));
+        } else {
+            builder.append(line, startIndex, endIndex);
+            ingestDocument.setFieldValue(headers[currentHeader], builder.toString());
+        }
+        return nextHeader();
+    }
+
+    private boolean nextHeader() {
+        currentHeader++;
+        return currentHeader == headers.length;
+    }
+}
diff --git a/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/CsvProcessor.java b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/CsvProcessor.java
new file mode 100644
index 0000000000000..66d10cc239e46
--- /dev/null
+++ b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/CsvProcessor.java
@@ -0,0 +1,108 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.ingest.common;
+
+import org.elasticsearch.ingest.AbstractProcessor;
+import org.elasticsearch.ingest.ConfigurationUtils;
+import org.elasticsearch.ingest.IngestDocument;
+
+import java.util.List;
+import java.util.Map;
+
+import static org.elasticsearch.ingest.ConfigurationUtils.newConfigurationException;
+
+/**
+ * A processor that breaks line from CSV file into separate fields.
+ * If there's more fields requested than there is in the CSV, extra field will not be present in the document after processing.
+ * In the same way this processor will skip any field that is empty in CSV.
+ *
+ * By default it uses rules according to <a href="https://tools.ietf.org/html/rfc4180">RCF 4180</a> with one exception: whitespaces are
+ * allowed before or after quoted field. Processor can be tweaked with following parameters:
+ *
+ * quote: set custom quote character (defaults to ")
+ * separator: set custom separator (defaults to ,)
+ * trim: trim leading and trailing whitespaces in unquoted fields
+ */
+public final class CsvProcessor extends AbstractProcessor {
+
+    public static final String TYPE = "csv";
+
+    private final String field;
+    private final String[] headers;
+    private final boolean trim;
+    private final char quote;
+    private final char separator;
+    private final boolean ignoreMissing;
+
+    CsvProcessor(String tag, String field, String[] headers, boolean trim, char separator, char quote, boolean ignoreMissing) {
+        super(tag);
+        this.field = field;
+        this.headers = headers;
+        this.trim = trim;
+        this.quote = quote;
+        this.separator = separator;
+        this.ignoreMissing = ignoreMissing;
+    }
+
+    @Override
+    public IngestDocument execute(IngestDocument ingestDocument) {
+        if (headers.length == 0) {
+            return ingestDocument;
+        }
+
+        String line = ingestDocument.getFieldValue(field, String.class, ignoreMissing);
+        if (line == null && ignoreMissing == false) {
+            return ingestDocument;
+        } else if (line == null) {
+            throw new IllegalArgumentException("field [" + field + "] is null, cannot process it.");
+        }
+        new CsvParser(ingestDocument, quote, separator, trim, headers).process(line);
+        return ingestDocument;
+    }
+
+    @Override
+    public String getType() {
+        return TYPE;
+    }
+
+    public static final class Factory implements org.elasticsearch.ingest.Processor.Factory {
+        @Override
+        public CsvProcessor create(Map<String, org.elasticsearch.ingest.Processor.Factory> registry, String processorTag,
+                                   Map<String, Object> config) {
+            String field = ConfigurationUtils.readStringProperty(TYPE, processorTag, config, "field");
+            String quote = ConfigurationUtils.readStringProperty(TYPE, processorTag, config, "quote", "\"");
+            if (quote.length() != 1) {
+                throw newConfigurationException(TYPE, processorTag, "quote", "quote has to be single character like \" or '");
+            }
+            String separator = ConfigurationUtils.readStringProperty(TYPE, processorTag, config, "separator", ",");
+            if (separator.length() != 1) {
+                throw newConfigurationException(TYPE, processorTag, "separator", "separator has to be single character like , or ;");
+            }
+            boolean trim = ConfigurationUtils.readBooleanProperty(TYPE, processorTag, config, "trim", false);
+            boolean ignoreMissing = ConfigurationUtils.readBooleanProperty(TYPE, processorTag, config, "ignore_missing", false);
+            List<String> targetFields = ConfigurationUtils.readList(TYPE, processorTag, config, "target_fields");
+            if (targetFields.isEmpty()) {
+                throw newConfigurationException(TYPE, processorTag, "target_fields", "target fields list can't be empty");
+            }
+            return new CsvProcessor(processorTag, field, targetFields.toArray(String[]::new), trim, separator.charAt(0), quote.charAt(0),
+                ignoreMissing);
+        }
+    }
+}
diff --git a/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/IngestCommonPlugin.java b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/IngestCommonPlugin.java
index 4f99c850e5bd3..b37e5d13e4602 100644
--- a/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/IngestCommonPlugin.java
+++ b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/IngestCommonPlugin.java
@@ -88,7 +88,8 @@ public Map<String, Processor.Factory> getProcessors(Processor.Parameters paramet
                 entry(PipelineProcessor.TYPE, new PipelineProcessor.Factory(parameters.ingestService)),
                 entry(DissectProcessor.TYPE, new DissectProcessor.Factory()),
                 entry(DropProcessor.TYPE, new DropProcessor.Factory()),
-                entry(HtmlStripProcessor.TYPE, new HtmlStripProcessor.Factory()));
+                entry(HtmlStripProcessor.TYPE, new HtmlStripProcessor.Factory()),
+                entry(CsvProcessor.TYPE, new CsvProcessor.Factory()));
     }
 
     @Override
diff --git a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/CsvProcessorTests.java b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/CsvProcessorTests.java
new file mode 100644
index 0000000000000..87da73cce129d
--- /dev/null
+++ b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/CsvProcessorTests.java
@@ -0,0 +1,221 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.ingest.common;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+import org.elasticsearch.ingest.IngestDocument;
+import org.elasticsearch.ingest.RandomDocumentPicks;
+import org.elasticsearch.test.ESTestCase;
+import org.junit.Before;
+
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+public class CsvProcessorTests extends ESTestCase {
+
+    private static final Character[] SEPARATORS = new Character[]{',', ';', '|', '.'};
+    private final String quote;
+    private char separator;
+
+
+    public CsvProcessorTests(@Name("quote") String quote) {
+        this.quote = quote;
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() {
+        return Arrays.asList(new Object[]{"'"}, new Object[]{"\""}, new Object[]{""});
+    }
+
+    @Before
+    public void setup() {
+        separator = randomFrom(SEPARATORS);
+    }
+
+    public void testExactNumberOfFields() throws Exception {
+        int numItems = randomIntBetween(2, 10);
+        Map<String, String> items = new LinkedHashMap<>();
+        for (int i = 0; i < numItems; i++) {
+            items.put(randomAlphaOfLengthBetween(5, 10), randomAlphaOfLengthBetween(5, 10));
+        }
+        String[] headers = items.keySet().toArray(new String[numItems]);
+        String csv = items.values().stream().map(v -> quote + v + quote).collect(Collectors.joining(separator + ""));
+
+        IngestDocument ingestDocument = processDocument(headers, csv);
+
+        items.forEach((key, value) -> assertEquals(value, ingestDocument.getFieldValue(key, String.class)));
+    }
+
+    public void testLessFieldsThanHeaders() throws Exception {
+        int numItems = randomIntBetween(4, 10);
+        Map<String, String> items = new LinkedHashMap<>();
+        for (int i = 0; i < numItems; i++) {
+            items.put(randomAlphaOfLengthBetween(5, 10), randomAlphaOfLengthBetween(5, 10));
+        }
+        String[] headers = items.keySet().toArray(new String[numItems]);
+        String csv = items.values().stream().map(v -> quote + v + quote).limit(3).collect(Collectors.joining(separator + ""));
+
+        IngestDocument ingestDocument = processDocument(headers, csv);
+
+        items.keySet().stream().skip(3).forEach(key -> assertFalse(ingestDocument.hasField(key)));
+        items.entrySet().stream().limit(3).forEach(e -> assertEquals(e.getValue(), ingestDocument.getFieldValue(e.getKey(), String.class)));
+    }
+
+    public void testLessHeadersThanFields() throws Exception {
+        int numItems = randomIntBetween(5, 10);
+        Map<String, String> items = new LinkedHashMap<>();
+        for (int i = 0; i < numItems; i++) {
+            items.put(randomAlphaOfLengthBetween(5, 10), randomAlphaOfLengthBetween(5, 10));
+        }
+        String[] headers = items.keySet().stream().limit(3).toArray(String[]::new);
+        String csv = items.values().stream().map(v -> quote + v + quote).collect(Collectors.joining(separator + ""));
+
+        IngestDocument ingestDocument = processDocument(headers, csv);
+
+        items.entrySet().stream().limit(3).forEach(e -> assertEquals(e.getValue(), ingestDocument.getFieldValue(e.getKey(), String.class)));
+    }
+
+    public void testSingleField() throws Exception {
+        String[] headers = new String[]{randomAlphaOfLengthBetween(5, 10)};
+        String value = randomAlphaOfLengthBetween(5, 10);
+        String csv = quote + value + quote;
+
+        IngestDocument ingestDocument = processDocument(headers, csv);
+
+        assertEquals(value, ingestDocument.getFieldValue(headers[0], String.class));
+    }
+
+    public void testEscapedQuote() throws Exception {
+        int numItems = randomIntBetween(2, 10);
+        Map<String, String> items = new LinkedHashMap<>();
+        for (int i = 0; i < numItems; i++) {
+            items.put(randomAlphaOfLengthBetween(5, 10), randomAlphaOfLengthBetween(5, 10) + quote + quote + randomAlphaOfLengthBetween(5
+                , 10) + quote + quote);
+        }
+        String[] headers = items.keySet().toArray(new String[numItems]);
+        String csv = items.values().stream().map(v -> quote + v + quote).collect(Collectors.joining(separator + ""));
+
+        IngestDocument ingestDocument = processDocument(headers, csv);
+
+        items.forEach((key, value) -> assertEquals(value.replace(quote + quote, quote), ingestDocument.getFieldValue(key, String.class)));
+    }
+
+    public void testQuotedStrings() throws Exception {
+        assumeFalse("quote needed", quote.isEmpty());
+        int numItems = randomIntBetween(2, 10);
+        Map<String, String> items = new LinkedHashMap<>();
+        for (int i = 0; i < numItems; i++) {
+            items.put(randomAlphaOfLengthBetween(5, 10),
+                separator + randomAlphaOfLengthBetween(5, 10) + separator + "\n\r" + randomAlphaOfLengthBetween(5, 10));
+        }
+        String[] headers = items.keySet().toArray(new String[numItems]);
+        String csv = items.values().stream().map(v -> quote + v + quote).collect(Collectors.joining(separator + ""));
+
+        IngestDocument ingestDocument = processDocument(headers, csv);
+
+        items.forEach((key, value) -> assertEquals(value.replace(quote + quote, quote), ingestDocument.getFieldValue(key,
+            String.class)));
+    }
+
+    public void testEmptyFields() throws Exception {
+        int numItems = randomIntBetween(5, 10);
+        Map<String, String> items = new LinkedHashMap<>();
+        for (int i = 0; i < numItems; i++) {
+            items.put(randomAlphaOfLengthBetween(5, 10), randomAlphaOfLengthBetween(5, 10));
+        }
+        String[] headers = items.keySet().toArray(new String[numItems]);
+        String csv =
+            items.values().stream().map(v -> quote + v + quote).limit(numItems - 1).skip(3).collect(Collectors.joining(separator + ""));
+
+        IngestDocument ingestDocument = processDocument(headers,
+            "" + separator + "" + separator + "" + separator + csv + separator + separator +
+                "abc");
+
+        items.keySet().stream().limit(3).forEach(key -> assertFalse(ingestDocument.hasField(key)));
+        items.entrySet().stream().limit(numItems - 1).skip(3).forEach(e -> assertEquals(e.getValue(),
+            ingestDocument.getFieldValue(e.getKey(), String.class)));
+        items.keySet().stream().skip(numItems - 1).forEach(key -> assertFalse(ingestDocument.hasField(key)));
+    }
+
+    public void testWrongStings() throws Exception {
+        assumeTrue("single run only", quote.isEmpty());
+        expectThrows(IllegalArgumentException.class, () -> processDocument(new String[]{"a"}, "abc\"abc"));
+        expectThrows(IllegalArgumentException.class, () -> processDocument(new String[]{"a"}, "\"abc\"asd"));
+        expectThrows(IllegalArgumentException.class, () -> processDocument(new String[]{"a"}, "\"abcasd"));
+        expectThrows(IllegalArgumentException.class, () -> processDocument(new String[]{"a"}, "abc\nabc"));
+        expectThrows(IllegalArgumentException.class, () -> processDocument(new String[]{"a"}, "abc\rabc"));
+    }
+
+    public void testQuotedWhitespaces() throws Exception {
+        assumeFalse("quote needed", quote.isEmpty());
+        IngestDocument document = processDocument(new String[]{"a", "b", "c", "d"},
+            "  abc   " + separator + " def" + separator + "ghi  " + separator + " " + quote + "  ooo  " + quote);
+        assertEquals("abc", document.getFieldValue("a", String.class));
+        assertEquals("def", document.getFieldValue("b", String.class));
+        assertEquals("ghi", document.getFieldValue("c", String.class));
+        assertEquals("  ooo  ", document.getFieldValue("d", String.class));
+    }
+
+    public void testUntrimmed() throws Exception {
+        assumeFalse("quote needed", quote.isEmpty());
+        IngestDocument document = processDocument(new String[]{"a", "b", "c", "d", "e", "f"},
+            "  abc   " + separator + " def" + separator + "ghi  " + separator + "   "
+                + quote + "ooo" + quote + "    " + separator + "  " + quote + "jjj" + quote + "   ", false);
+        assertEquals("  abc   ", document.getFieldValue("a", String.class));
+        assertEquals(" def", document.getFieldValue("b", String.class));
+        assertEquals("ghi  ", document.getFieldValue("c", String.class));
+        assertEquals("ooo", document.getFieldValue("d", String.class));
+        assertEquals("jjj", document.getFieldValue("e", String.class));
+        assertFalse(document.hasField("f"));
+    }
+
+    public void testEmptyHeaders() throws Exception {
+        assumeTrue("single run only", quote.isEmpty());
+        IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random());
+        String fieldName = RandomDocumentPicks.addRandomField(random(), ingestDocument, "abc,abc");
+        HashMap<String, Object> metadata = new HashMap<>(ingestDocument.getSourceAndMetadata());
+
+        CsvProcessor processor = new CsvProcessor(randomAlphaOfLength(5), fieldName, new String[0], false, ',', '"', false);
+
+        processor.execute(ingestDocument);
+
+        assertEquals(metadata, ingestDocument.getSourceAndMetadata());
+    }
+
+    private IngestDocument processDocument(String[] headers, String csv) throws Exception {
+        return processDocument(headers, csv, true);
+    }
+
+    private IngestDocument processDocument(String[] headers, String csv, boolean trim) throws Exception {
+        IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random());
+
+        String fieldName = RandomDocumentPicks.addRandomField(random(), ingestDocument, csv);
+        char quoteChar = quote.isEmpty() ? '"' : quote.charAt(0);
+        CsvProcessor processor = new CsvProcessor(randomAlphaOfLength(5), fieldName, headers, trim, separator, quoteChar, false);
+
+        processor.execute(ingestDocument);
+
+        return ingestDocument;
+    }
+}
diff --git a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/250_csv.yml b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/250_csv.yml
new file mode 100644
index 0000000000000..a38805fb1fec3
--- /dev/null
+++ b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/250_csv.yml
@@ -0,0 +1,164 @@
+---
+teardown:
+  - do:
+      ingest.delete_pipeline:
+        id: "my_pipeline"
+        ignore: 404
+
+---
+"Test CSV Processor defaults":
+  - do:
+      ingest.put_pipeline:
+        id: "my_pipeline"
+        body:  >
+          {
+            "description": "_description",
+            "processors": [
+              {
+                "csv": {
+                  "field": "value",
+                  "target_fields":["a","b","c"]
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      index:
+        index: test
+        id: 1
+        pipeline: "my_pipeline"
+        body: >
+          {
+            "value": "aa,bb,cc"
+          }
+
+  - do:
+      get:
+        index: test
+        id: 1
+  - match: { _source.a: "aa" }
+  - match: { _source.b: "bb" }
+  - match: { _source.c: "cc" }
+
+---
+"Test CSV Processor quote and separator":
+  - do:
+      ingest.put_pipeline:
+        id: "my_pipeline"
+        body:  >
+          {
+            "description": "_description",
+            "processors": [
+              {
+                "csv": {
+                  "field": "value",
+                  "target_fields":["a","b","c","d","e"],
+                  "quote": "'",
+                  "separator": ";"
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      index:
+        index: test
+        id: 1
+        pipeline: "my_pipeline"
+        body: >
+          {
+            "value": "'aa';'b;b';'cc';d,d;'ee''ee'"
+          }
+
+  - do:
+      get:
+        index: test
+        id: 1
+  - match: { _source.a: "aa" }
+  - match: { _source.b: "b;b" }
+  - match: { _source.c: "cc" }
+  - match: { _source.d: "d,d" }
+  - match: { _source.e: "ee'ee" }
+
+---
+"Test CSV Processor trim":
+  - do:
+      ingest.put_pipeline:
+        id: "my_pipeline"
+        body:  >
+          {
+            "description": "_description",
+            "processors": [
+              {
+                "csv": {
+                  "field": "value",
+                  "target_fields":["a","b","c"],
+                  "trim": true,
+                  "quote": "'"
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      index:
+        index: test
+        id: 1
+        pipeline: "my_pipeline"
+        body: >
+          {
+            "value": "    aa,  bb  ,    'cc'"
+          }
+
+  - do:
+      get:
+        index: test
+        id: 1
+  - match: { _source.a: "aa" }
+  - match: { _source.b: "bb" }
+  - match: { _source.c: "cc" }
+
+---
+"Test CSV Processor trim log":
+  - do:
+      ingest.put_pipeline:
+        id: "my_pipeline"
+        body:  >
+          {
+            "description": "_description",
+            "processors": [
+              {
+                "csv": {
+                  "field": "value",
+                  "target_fields":["date","level","server","id","msg"],
+                  "trim": true,
+                  "separator": "|"
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      index:
+        index: test
+        id: 1
+        pipeline: "my_pipeline"
+        body: >
+          {
+            "value": "2018-01-06 16:56:14.295748|INFO    |VirtualServer |1  |listening on 0.0.0.0:9987, :::9987"
+          }
+
+  - do:
+      get:
+        index: test
+        id: 1
+  - match: { _source.date: "2018-01-06 16:56:14.295748" }
+  - match: { _source.level: "INFO" }
+  - match: { _source.server: "VirtualServer" }
+  - match: { _source.id: "1" }
+  - match: { _source.msg: "listening on 0.0.0.0:9987, :::9987" }

From d43bfc1e7fa3b491868c4a0b25dfff544f786b04 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Wed, 11 Dec 2019 16:45:44 +0100
Subject: [PATCH 153/686] Fix GCS Mock Batch Delete Behavior (#50034)

Batch deletes get a response for every delete request, not just those that actually hit an existing blob.
The fact that we only responded for existing blobs leads to a degenerate response that throws a parse exception if a batch delete only contains non-existant blobs.
---
 .../GoogleCloudStorageBlobStoreRepositoryTests.java | 13 +++++++++++++
 .../fixture/gcs/GoogleCloudStorageHttpHandler.java  |  7 +++----
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
index 7a2c3d780123a..d8926b25e2c49 100644
--- a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
+++ b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
@@ -26,6 +26,8 @@
 import com.sun.net.httpserver.HttpHandler;
 import fixture.gcs.FakeOAuth2HttpHandler;
 import fixture.gcs.GoogleCloudStorageHttpHandler;
+import org.elasticsearch.action.ActionRunnable;
+import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.SuppressForbidden;
@@ -37,7 +39,9 @@
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.repositories.RepositoriesService;
 import org.elasticsearch.repositories.Repository;
+import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
 import org.elasticsearch.repositories.blobstore.ESMockAPIBasedRepositoryIntegTestCase;
 import org.threeten.bp.Duration;
 
@@ -101,6 +105,15 @@ protected Settings nodeSettings(int nodeOrdinal) {
         return settings.build();
     }
 
+    public void testDeleteSingleItem() {
+        final String repoName = createRepository(randomName());
+        final RepositoriesService repositoriesService = internalCluster().getMasterNodeInstance(RepositoriesService.class);
+        final BlobStoreRepository repository = (BlobStoreRepository) repositoriesService.repository(repoName);
+        PlainActionFuture.get(f -> repository.threadPool().generic().execute(ActionRunnable.run(f, () ->
+            repository.blobStore().blobContainer(repository.basePath()).deleteBlobsIgnoringIfNotExists(Collections.singletonList("foo"))
+        )));
+    }
+
     public void testChunkSize() {
         // default chunk size
         RepositoryMetaData repositoryMetaData = new RepositoryMetaData("repo", GoogleCloudStorageRepository.TYPE, Settings.EMPTY);
diff --git a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
index ba2a725fed29b..a374a745909a5 100644
--- a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
+++ b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
@@ -167,10 +167,9 @@ public void handle(final HttpExchange exchange) throws IOException {
                     } else if (line.startsWith("DELETE")) {
                         final String name = line.substring(line.indexOf(uri) + uri.length(), line.lastIndexOf(" HTTP"));
                         if (Strings.hasText(name)) {
-                            if (blobs.entrySet().removeIf(blob -> blob.getKey().equals(URLDecoder.decode(name, UTF_8)))) {
-                                batch.append("HTTP/1.1 204 NO_CONTENT").append('\n');
-                                batch.append('\n');
-                            }
+                            blobs.remove(URLDecoder.decode(name, UTF_8));
+                            batch.append("HTTP/1.1 204 NO_CONTENT").append('\n');
+                            batch.append('\n');
                         }
                     }
                 }

From dfe30135e997a0afa5f212724fe42e90a83ee4c3 Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Wed, 11 Dec 2019 17:18:51 +0100
Subject: [PATCH 154/686] Log attachment generation failures (#50080)

Watcher logs when actions fail in ActionWrapper, but failures to
generate an email attachment are not logged and we thus only know the
type of the exception and not where/how it occurred.
---
 .../xpack/watcher/actions/email/ExecutableEmailAction.java    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/actions/email/ExecutableEmailAction.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/actions/email/ExecutableEmailAction.java
index fcc4eb0e9422b..1f8e87cad1f95 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/actions/email/ExecutableEmailAction.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/actions/email/ExecutableEmailAction.java
@@ -6,6 +6,8 @@
 package org.elasticsearch.xpack.watcher.actions.email;
 
 import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.apache.logging.log4j.util.Supplier;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.xpack.core.watcher.actions.Action;
 import org.elasticsearch.xpack.core.watcher.actions.ExecutableAction;
@@ -57,6 +59,8 @@ public Action.Result execute(String actionId, WatchExecutionContext ctx, Payload
                     Attachment attachment = parser.toAttachment(ctx, payload, emailAttachment);
                     attachments.put(attachment.id(), attachment);
                 } catch (ElasticsearchException | IOException e) {
+                    logger().error(
+                        (Supplier<?>) () -> new ParameterizedMessage("failed to execute action [{}/{}]", ctx.watch().id(), actionId), e);
                     return new EmailAction.Result.FailureWithException(action.type(), e);
                 }
             }

From c5850ad5bef8908037086124a14138c59e0e776e Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Wed, 11 Dec 2019 09:50:41 -0800
Subject: [PATCH 155/686] [DOCS] Move datafeed resource definitions into APIs
 (#50005)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: István Zoltán Szabó <istvan.szabo@elastic.co>
---
 .../apis/datafeedresource.asciidoc            | 161 ------------------
 .../apis/delete-datafeed.asciidoc             |   7 +-
 .../apis/get-datafeed-stats.asciidoc          | 109 +++++++-----
 .../apis/get-datafeed.asciidoc                | 117 +++++++++----
 .../apis/preview-datafeed.asciidoc            |  39 +++--
 .../apis/put-datafeed.asciidoc                |  66 +++----
 .../apis/start-datafeed.asciidoc              |   3 +-
 .../apis/stop-datafeed.asciidoc               |  18 +-
 .../apis/update-datafeed.asciidoc             |  83 ++++-----
 .../delayed-data-detection.asciidoc           |  20 +--
 docs/reference/ml/ml-shared.asciidoc          | 153 +++++++++++++++++
 docs/reference/redirects.asciidoc             |  13 +-
 docs/reference/rest-api/defs.asciidoc         |   3 -
 13 files changed, 415 insertions(+), 377 deletions(-)
 delete mode 100644 docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc

diff --git a/docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc
deleted file mode 100644
index 864e71e35bdbe..0000000000000
--- a/docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc
+++ /dev/null
@@ -1,161 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-datafeed-resource]]
-=== {dfeed-cap} resources
-
-A {dfeed} resource has the following properties:
-
-`aggregations`::
-  (object) If set, the {dfeed} performs aggregation searches.
-  Support for aggregations is limited and should only be used with
-  low cardinality data. For more information, see
-  {stack-ov}/ml-configuring-aggregation.html[Aggregating Data for Faster Performance].
-
-`chunking_config`::
-  (object) Specifies how data searches are split into time chunks.
-  See <<ml-datafeed-chunking-config>>.
-  For example: `{"mode": "manual", "time_span": "3h"}`
-
-`datafeed_id`::
- (string) A numerical character string that uniquely identifies the {dfeed}.
- This property is informational; you cannot change the identifier for existing
- {dfeeds}.
-
-`frequency`::
-  (time units) The interval at which scheduled queries are made while the
-  {dfeed} runs in real time. The default value is either the bucket span for short
-  bucket spans, or, for longer bucket spans, a sensible fraction of the bucket
-  span. For example: `150s`.
-
-`indices`::
-  (array) An array of index names. For example: `["it_ops_metrics"]`
-
-`job_id`::
- (string) The unique identifier for the job to which the {dfeed} sends data.
-
-`query`::
-  (object) The {es} query domain-specific language (DSL). This value
-  corresponds to the query object in an {es} search POST body. All the
-  options that are supported by {es} can be used, as this object is
-  passed verbatim to {es}. By default, this property has the following
-  value: `{"match_all": {"boost": 1}}`.
-
-`query_delay`::
-  (time units) The number of seconds behind real time that data is queried. For
-  example, if data from 10:04 a.m. might not be searchable in {es} until
-  10:06 a.m., set this property to 120 seconds. The default value is randomly
-  selected between `60s` and `120s`. This randomness improves the query
-  performance when there are multiple jobs running on the same node.
-
-`script_fields`::
-  (object) Specifies scripts that evaluate custom expressions and returns
-  script fields to the {dfeed}.
-  The detector configuration objects in a job can contain
-  functions that use these script fields.
-  For more information, see
-  {stack-ov}/ml-configuring-transform.html[Transforming Data With Script Fields].
-
-`scroll_size`::
-  (unsigned integer) The `size` parameter that is used in {es} searches.
-  The default value is `1000`.
-
-`delayed_data_check_config`::
-  (object) Specifies whether the data feed checks for missing data and 
-  the size of the window. For example:
-  `{"enabled": true, "check_window": "1h"}` See
-  <<ml-datafeed-delayed-data-check-config>>.
-
-`max_empty_searches`::
-  (integer) If a real-time {dfeed} has never seen any data (including during
-  any initial training period) then it will automatically stop itself and
-  close its associated job after this many real-time searches that return no
-  documents. In other words, it will stop after `frequency` times
-  `max_empty_searches` of real-time operation. If not set
-  then a {dfeed} with no end time that sees no data will remain started until
-  it is explicitly stopped. By default this setting is not set.
-
-[[ml-datafeed-chunking-config]]
-==== Chunking configuration objects
-
-{dfeeds-cap} might be required to search over long time periods, for several months
-or years. This search is split into time chunks in order to ensure the load
-on {es} is managed. Chunking configuration controls how the size of these time
-chunks are calculated and is an advanced configuration option.
-
-A chunking configuration object has the following properties:
-
-`mode`::
-  There are three available modes: +
-  `auto`::: The chunk size will be dynamically calculated. This is the default
-  and recommended value.
-  `manual`::: Chunking will be applied according to the specified `time_span`.
-  `off`::: No chunking will be applied.
-
-`time_span`::
-  (time units) The time span that each search will be querying.
-  This setting is only applicable when the mode is set to `manual`.
-  For example: `3h`.
-
-[[ml-datafeed-delayed-data-check-config]]
-==== Delayed data check configuration objects
-
-The {dfeed} can optionally search over indices that have already been read in
-an effort to determine whether any data has subsequently been added to the index.
-If missing data is found, it is a good indication that the `query_delay` option
-is set too low and the data is being indexed after the {dfeed} has passed that
-moment in time. See 
-{stack-ov}/ml-delayed-data-detection.html[Working with delayed data].
-
-This check runs only on real-time {dfeeds}.
-
-The configuration object has the following properties:
-
-`enabled`::
-  (boolean) Specifies whether the {dfeed} periodically checks for delayed data.
-  Defaults to `true`.
-
-`check_window`::
-  (time units) The window of time that is searched for late data. This window of
-  time ends with the latest finalized bucket. It defaults to `null`, which
-  causes an appropriate `check_window` to be calculated when the real-time
-  {dfeed} runs. In particular, the default `check_window` span calculation is
-  based on the maximum of `2h` or `8 * bucket_span`.
-
-[float]
-[[ml-datafeed-counts]]
-==== {dfeed-cap} counts
-
-The get {dfeed} statistics API provides information about the operational
-progress of a {dfeed}. All of these properties are informational; you cannot
-update their values:
-
-`assignment_explanation`::
-  (string) For started {dfeeds} only, contains messages relating to the
-  selection of a node.
-
-`datafeed_id`::
- (string) A numerical character string that uniquely identifies the {dfeed}.
-
-`node`::
-  (object) The node upon which the {dfeed} is started. The {dfeed} and job will
-  be on the same node.
-  `id`::: The unique identifier of the node. For example,
-  "0-o0tOoRTwKFZifatTWKNw".
-  `name`::: The node name. For example, `0-o0tOo`.
-  `ephemeral_id`::: The node ephemeral ID.
-  `transport_address`::: The host and port where transport HTTP connections are
-  accepted. For example, `127.0.0.1:9300`.
-  `attributes`::: For example, `{"ml.machine_memory": "17179869184"}`.
-
-`state`::
-  (string) The status of the {dfeed}, which can be one of the following values: +
-  `started`::: The {dfeed} is actively receiving data.
-  `stopped`::: The {dfeed} is stopped and will not receive data until it is
-  re-started.
-
-`timing_stats`::
-  (object) An object that provides statistical information about timing aspect of this datafeed. +
-  `job_id`::: A numerical character string that uniquely identifies the job.
-  `search_count`::: Number of searches performed by this datafeed.
-  `total_search_time_ms`::: Total time the datafeed spent searching in milliseconds.
-
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
index 21b4eb75bef04..d933afe4f9a42 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
@@ -28,14 +28,15 @@ can delete it.
 ==== {api-path-parms-title}
 
 `<feed_id>`::
-  (Required, string) Identifier for the {dfeed}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [[ml-delete-datafeed-query-parms]]
 ==== {api-query-parms-title}
 
 `force`::
-  (Optional, boolean) Use to forcefully delete a started {dfeed}; this method is
-  quicker than stopping and deleting the {dfeed}.
+(Optional, boolean) Use to forcefully delete a started {dfeed}; this method is
+quicker than stopping and deleting the {dfeed}.
 
 [[ml-delete-datafeed-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
index bd126a651e26b..feccd52364f48 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
@@ -45,36 +45,61 @@ IMPORTANT: This API returns a maximum of 10,000 {dfeeds}.
 ==== {api-path-parms-title}
 
 `<feed_id>`::
-  (Optional, string) Identifier for the {dfeed}. It can be a {dfeed} identifier
-  or a wildcard expression. If you do not specify one of these options, the API
-  returns statistics for all {dfeeds}.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
+If you do not specify one of these options, the API returns information about
+all {dfeeds}.
 
 [[ml-get-datafeed-stats-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_datafeeds`::
-  (Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no {datafeeds} that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
-
-The default value is `true`, which returns an empty `datafeeds` array when
-there are no matches and the subset of results when there are partial matches.
-If this parameter is `false`, the request returns a `404` status code when there
-are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
 
 
 [[ml-get-datafeed-stats-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of {dfeed} count objects. All of these properties are
+informational; you cannot update their values.
+
+`assignment_explanation`::
+(string) For started {dfeeds} only, contains messages relating to the selection of a node.
+
+`datafeed_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
+
+`node`::
+(object) For started {dfeeds} only, the node upon which the {dfeed} is started. The {dfeed} and job will be on the same node.
+`id`::: The unique identifier of the node. For example, "0-o0tOoRTwKFZifatTWKNw".
+`name`::: The node name. For example, `0-o0tOo`.
+`ephemeral_id`::: The node ephemeral ID.
+`transport_address`::: The host and port where transport HTTP connections are
+accepted. For example, `127.0.0.1:9300`.
+`attributes`::: For example, `{"ml.machine_memory": "17179869184"}`.
+
+`state`::
+(string) The status of the {dfeed}, which can be one of the following values:
++
+--
+* `started`: The {dfeed} is actively receiving data.
+* `stopped`: The {dfeed} is stopped and will not receive data until it is
+re-started.
+--
+
+`timing_stats`::
+(object) An object that provides statistical information about timing aspect of
+this {dfeed}.
+//average_search_time_per_bucket_ms
+//bucket_count
+//exponential_average_search_time_per_hour_ms
+`job_id`:::
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+`search_count`::: Number of searches performed by this {dfeed}.
+`total_search_time_ms`::: Total time the {dfeed} spent searching in milliseconds.
 
-`datafeeds`::
-  (array) An array of {dfeed} count objects.
-  For more information, see <<ml-datafeed-counts>>.
 
 [[ml-get-datafeed-stats-response-codes]]
 ==== {api-response-codes-title}
@@ -86,46 +111,46 @@ The API returns the following information:
 [[ml-get-datafeed-stats-example]]
 ==== {api-examples-title}
 
-The following example gets usage information for the
-`datafeed-total-requests` {dfeed}:
-
 [source,console]
 --------------------------------------------------
-GET _ml/datafeeds/datafeed-total-requests/_stats
+GET _ml/datafeeds/datafeed-high_sum_total_sales/_stats
 --------------------------------------------------
-// TEST[skip:setup:server_metrics_startdf]
+// TEST[skip:Kibana sample data started datafeed]
 
 The API returns the following results:
 
 [source,console-result]
 ----
 {
-  "count": 1,
-  "datafeeds": [
+  "count" : 1,
+  "datafeeds" : [
     {
-      "datafeed_id": "datafeed-total-requests",
-      "state": "started",
-      "node": {
-        "id": "2spCyo1pRi2Ajo-j-_dnPX",
-        "name": "node-0",
-        "ephemeral_id": "hoXMLZB0RWKfR9UPPUCxXX",
-        "transport_address": "127.0.0.1:9300",
-        "attributes": {
-          "ml.machine_memory": "17179869184",
-          "ml.max_open_jobs": "20"
+      "datafeed_id" : "datafeed-high_sum_total_sales",
+      "state" : "started",
+      "node" : {
+        "id" : "7bmMXyWCRs-TuPfGJJ_yMw",
+        "name" : "node-0",
+        "ephemeral_id" : "hoXMLZB0RWKfR9UPPUCxXX",
+        "transport_address" : "127.0.0.1:9300",
+        "attributes" : {
+          "ml.machine_memory" : "17179869184",
+          "ml.max_open_jobs" : "20"
         }
       },
-      "assignment_explanation": "",
-      "timing_stats": {
-        "job_id": "job-total-requests",
-        "search_count": 20,
-        "total_search_time_ms": 120.5
+      "assignment_explanation" : "",
+      "timing_stats" : {
+        "job_id" : "high_sum_total_sales",
+        "search_count" : 7,
+        "bucket_count" : 743,
+        "total_search_time_ms" : 134.0,
+        "average_search_time_per_bucket_ms" : 0.180349932705249,
+        "exponential_average_search_time_per_hour_ms" : 11.514712961628677
       }
     }
   ]
 }
 ----
-// TESTRESPONSE[s/"2spCyo1pRi2Ajo-j-_dnPX"/$body.$_path/]
+// TESTRESPONSE[s/"7bmMXyWCRs-TuPfGJJ_yMw"/$body.$_path/]
 // TESTRESPONSE[s/"node-0"/$body.$_path/]
 // TESTRESPONSE[s/"hoXMLZB0RWKfR9UPPUCxXX"/$body.$_path/]
 // TESTRESPONSE[s/"127.0.0.1:9300"/$body.$_path/]
diff --git a/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
index 3330ae7b821dc..11aca1edd95e1 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
@@ -42,35 +42,71 @@ IMPORTANT: This API returns a maximum of 10,000 {dfeeds}.
 ==== {api-path-parms-title}
 
 `<feed_id>`::
-  (Optional, string) Identifier for the {dfeed}. It can be a {dfeed} identifier
-  or a wildcard expression. If you do not specify one of these options, the API
-  returns information about all {dfeeds}.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
+If you do not specify one of these options, the API returns information about
+all {dfeeds}.
 
 [[ml-get-datafeed-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_datafeeds`::
-  (Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no {datafeeds} that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
-
-The default value is `true`, which returns an empty `datafeeds` array when
-there are no matches and the subset of results when there are partial matches.
-If this parameter is `false`, the request returns a `404` status code when there
-are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
 
 [[ml-get-datafeed-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of {dfeed} resources, which have the following
+properties:
 
-`datafeeds`::
-  (array) An array of {dfeed} objects.
-  For more information, see <<ml-datafeed-resource>>.
+`aggregations`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=aggregations]
+
+`chunking_config`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=chunking-config]
+
+`datafeed_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
+
+`delayed_data_check_config`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
+
+`frequency`::
+(<<time-units,time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=frequency]
+
+`indices`::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=indices]
+
+`job_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-datafeed]
+
+`max_empty_searches`::
+(integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=max-empty-searches]
+
+`query`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=query]
+
+`query_delay`::
+(<<time-units,time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=query-delay]
+
+`script_fields`::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=script-fields]
+
+`scroll_size`::
+(unsigned integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
 
 [[ml-get-datafeed-response-codes]]
 ==== {api-response-codes-title}
@@ -83,39 +119,48 @@ The API returns the following information:
 ==== {api-examples-title}
 
 The following example gets configuration information for the
-`datafeed-total-requests` {dfeed}:
+`datafeed-high_sum_total_sales` {dfeed}:
 
 [source,console]
 --------------------------------------------------
-GET _ml/datafeeds/datafeed-total-requests
+GET _ml/datafeeds/datafeed-high_sum_total_sales
 --------------------------------------------------
-// TEST[skip:setup:server_metrics_datafeed]
+// TEST[skip:kibana sample data]
 
 The API returns the following results:
 
 [source,console-result]
 ----
 {
-  "count": 1,
-  "datafeeds": [
+  "count" : 1,
+  "datafeeds" : [
     {
-      "datafeed_id": "datafeed-total-requests",
-      "job_id": "total-requests",
-      "query_delay": "83474ms",
-      "indices": [
-        "server-metrics"
+      "datafeed_id" : "datafeed-high_sum_total_sales",
+      "job_id" : "high_sum_total_sales",
+      "query_delay" : "93169ms",
+      "indices" : [
+        "kibana_sample_data_ecommerce"
       ],
-      "query": {
-        "match_all": {
-          "boost": 1.0
+      "query" : {
+        "bool" : {
+          "filter" : [
+            {
+              "term" : {
+                "_index" : "kibana_sample_data_ecommerce"
+              }
+            }
+          ]
         }
       },
-      "scroll_size": 1000,
-      "chunking_config": {
-        "mode": "auto"
+      "scroll_size" : 1000,
+      "chunking_config" : {
+        "mode" : "auto"
+      },
+      "delayed_data_check_config" : {
+        "enabled" : true
       }
     }
   ]
 }
 ----
-// TESTRESPONSE[s/"query.boost": "1.0"/"query.boost": $body.query.boost/]
+// TESTRESPONSE[s/"query.boost": "93169ms"/"query.boost": $body.query.boost/]
diff --git a/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc
index c3afca8b03c62..6220d8a1de242 100644
--- a/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc
@@ -41,18 +41,17 @@ it to ensure it is returning the expected data.
 ==== {api-path-parms-title}
 
 `<datafeed_id>`::
-  (Required, string) Identifier for the {dfeed}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [[ml-preview-datafeed-example]]
 ==== {api-examples-title}
 
-The following example obtains a preview of the `datafeed-farequote` {dfeed}:
-
 [source,console]
 --------------------------------------------------
-GET _ml/datafeeds/datafeed-farequote/_preview
+GET _ml/datafeeds/datafeed-high_sum_total_sales/_preview
 --------------------------------------------------
-// TEST[skip:setup:farequote_datafeed]
+// TEST[skip:set up Kibana sample data]
 
 The data that is returned for this example is as follows:
 
@@ -60,22 +59,28 @@ The data that is returned for this example is as follows:
 ----
 [
   {
-    "time": 1454803200000,
-    "airline": "JZA",
-    "doc_count": 5,
-    "responsetime": 990.4628295898438
+    "order_date" : 1574294659000,
+    "category.keyword" : "Men's Clothing",
+    "customer_full_name.keyword" : "Sultan Al Benson",
+    "taxful_total_price" : 35.96875
   },
   {
-    "time": 1454803200000,
-    "airline": "JBU",
-    "doc_count": 23,
-    "responsetime": 877.5927124023438
+    "order_date" : 1574294918000,
+    "category.keyword" : [
+      "Women's Accessories",
+      "Women's Clothing"
+    ],
+    "customer_full_name.keyword" : "Pia Webb",
+    "taxful_total_price" : 83.0
   },
   {
-    "time": 1454803200000,
-    "airline": "KLM",
-    "doc_count": 42,
-    "responsetime": 1355.481201171875
+    "order_date" : 1574295782000,
+    "category.keyword" : [
+      "Women's Accessories",
+      "Women's Shoes"
+    ],
+    "customer_full_name.keyword" : "Brigitte Graham",
+    "taxful_total_price" : 72.0
   }
 ]
 ----
diff --git a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
index ca3b9d61ba7a1..cb3765a86c97e 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
@@ -43,70 +43,52 @@ those same roles.
 ==== {api-path-parms-title}
 
 `<feed_id>`::
-  (Required, string) A numerical character string that uniquely identifies the
-  {dfeed}. This identifier can contain lowercase alphanumeric characters (a-z
-  and 0-9), hyphens, and underscores. It must start and end with alphanumeric
-  characters.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [[ml-put-datafeed-request-body]]
 ==== {api-request-body-title}
 
 `aggregations`::
-  (Optional, object) If set, the {dfeed} performs aggregation searches. For more
-  information, see <<ml-datafeed-resource>>.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=aggregations]
 
 `chunking_config`::
-  (Optional, object) Specifies how data searches are split into time chunks. See
-  <<ml-datafeed-chunking-config>>.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=chunking-config]
 
 `delayed_data_check_config`::
-  (Optional, object) Specifies whether the data feed checks for missing data and 
-  the size of the window. See <<ml-datafeed-delayed-data-check-config>>.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
 
 `frequency`::
-  (Optional, <<time-units, time units>>) The interval at which scheduled queries 
-  are made while the {dfeed} runs in real time. The default value is either the 
-  bucket span for short bucket spans, or, for longer bucket spans, a sensible 
-  fraction of the bucket span. For example: `150s`.
+(Optional, <<time-units, time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=frequency]
 
 `indices`::
-  (Required, array) An array of index names. Wildcards are supported. For
-  example: `["it_ops_metrics", "server*"]`.
-+
---
-NOTE: If any indices are in remote clusters then `cluster.remote.connect` must
-not be set to `false` on any ML node.
---
+(Required, array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=indices]
 
-`job_id`::
- (Required, string) A numerical character string that uniquely identifies the
- {anomaly-job}.
 
+`job_id`::
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+ 
 `query`::
-  (Optional, object) The {es} query domain-specific language (DSL). This value
-  corresponds to the query object in an {es} search POST body. All the options
-  that are supported by {Es} can be used, as this object is passed verbatim to
-  {es}. By default, this property has the following value:
-  `{"match_all": {"boost": 1}}`.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=query]
 
 `query_delay`::
-  (Optional, <<time-units, time units>>) The number of seconds behind real time 
-  that data is queried. For example, if data from 10:04 a.m. might not be 
-  searchable in {es} until 10:06 a.m., set this property to 120 seconds. The 
-  default value is `60s`.
+(Optional, <<time-units, time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=query-delay]
 
 `script_fields`::
-  (Optional, object) Specifies scripts that evaluate custom expressions and
-  returns script fields to the {dfeed}. The detector configuration objects in a
-  job can contain functions that use these script fields. For more information,
-  see <<request-body-search-script-fields,Script fields>>.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=script-fields]
 
 `scroll_size`::
-  (Optional, unsigned integer) The `size` parameter that is used in {es}
-  searches. The default value is `1000`.
-
-For more information about these properties,
-see <<ml-datafeed-resource>>.
+(Optional, unsigned integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
 
 [[ml-put-datafeed-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
index 7faba863774dc..dd3e6bbdfff54 100644
--- a/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
@@ -74,7 +74,8 @@ creation/update and runs the query using those same roles.
 ==== {api-path-parms-title}
 
 `<feed_id>`::
-  (Required, string) Identifier for the {dfeed}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [[ml-start-datafeed-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
index cde9f16c384af..f115d8657f7ec 100644
--- a/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
@@ -40,25 +40,15 @@ comma-separated list of {dfeeds} or a wildcard expression. You can close all
 ==== {api-path-parms-title}
 
 `<feed_id>`::
-  (Required, string) Identifier for the {dfeed}. It can be a {dfeed} identifier
-  or a wildcard expression.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
 
 [[ml-stop-datafeed-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_datafeeds`::
-  (Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no {datafeeds} that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
-
-The default value is `true`, which returns an empty `datafeeds` array when
-there are no matches and the subset of results when there are partial matches.
-If this parameter is `false`, the request returns a `404` status code when there
-are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
 
 [[ml-stop-datafeed-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
index d201d6cd093b2..1336f71fcff77 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
@@ -39,7 +39,8 @@ using those same roles.
 ==== {api-path-parms-title}
 
 `<feed_id>`::
-  (Required, string) Identifier for the {dfeed}.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [[ml-update-datafeed-request-body]]
 ==== {api-request-body-title}
@@ -47,70 +48,58 @@ using those same roles.
 The following properties can be updated after the {dfeed} is created:
 
 `aggregations`::
-  (Optional, object) If set, the {dfeed} performs aggregation searches. For more
-  information, see <<ml-datafeed-resource>>.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=aggregations]
 
 `chunking_config`::
-  (Optional, object) Specifies how data searches are split into time chunks. See
-  <<ml-datafeed-chunking-config>>.
-  
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=chunking-config]
+
 `delayed_data_check_config`::
-  (Optional, object) Specifies whether the data feed checks for missing data and 
-  the size of the window. See <<ml-datafeed-delayed-data-check-config>>.  
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
 
 `frequency`::
-  (Optional, <<time-units, time units>>) The interval at which scheduled queries 
-  are made while the {dfeed} runs in real time. The default value is either the 
-  bucket span for short bucket spans, or, for longer bucket spans, a sensible 
-  fraction of the bucket span. For example: `150s`.
+(Optional, <<time-units, time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=frequency]
 
 `indices`::
-  (Optional, array) An array of index names. Wildcards are supported. For
-  example: `["it_ops_metrics", "server*"]`.
+(Optional, array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=indices]
+
+`max_empty_searches`::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=max-empty-searches]
++
+--
+The special value `-1` unsets this setting.
+--
 
 `query`::
-  (Optional, object) The {es} query domain-specific language (DSL). This value
-  corresponds to the query object in an {es} search POST body. All the options
-  that are supported by {es} can be used, as this object is passed verbatim to
-  {es}. By default, this property has the following value:
-  `{"match_all": {"boost": 1}}`.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=query]
 +
 --
-WARNING: If you change the query, then the analyzed data will also be changed, 
-therefore the required time to learn might be long and the understandability of 
-the results is unpredictable.
-If you want to make significant changes to the source data, we would recommend 
-you clone it and create a second job containing the amendments. Let both run in 
-parallel and close one when you are satisfied with the results of the other job.
+WARNING: If you change the query, the analyzed data is also changed. Therefore,
+the required time to learn might be long and the understandability of the
+results is unpredictable. If you want to make significant changes to the source
+data, we would recommend you clone it and create a second job containing the
+amendments. Let both run in parallel and close one when you are satisfied with
+the results of the other job.
+
 --
 
 `query_delay`::
-  (Optional, <<time-units, time units>>) The number of seconds behind real-time 
-  that data is queried. For example, if data from 10:04 a.m. might not be 
-  searchable in {es} until 10:06 a.m., set this property to 120 seconds. The 
-  default value is `60s`.
+(Optional, <<time-units, time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=query-delay]
 
 `script_fields`::
-  (Optional, object) Specifies scripts that evaluate custom expressions and
-  returns script fields to the {dfeed}. The detector configuration objects in a
-  job can contain functions that use these script fields. For more information,
-  see <<request-body-search-script-fields,Script fields>>.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=script-fields]
 
 `scroll_size`::
-  (Optional, unsigned integer) The `size` parameter that is used in {es}
-  searches. The default value is `1000`.
-
-`max_empty_searches`::
-  (Optional, integer) If a real-time {dfeed} has never seen any data (including
-  during any initial training period) then it will automatically stop itself
-  and close its associated job after this many real-time searches that return
-  no documents. In other words, it will stop after `frequency` times
-  `max_empty_searches` of real-time operation. If not set
-  then a {dfeed} with no end time that sees no data will remain started until
-  it is explicitly stopped. The special value `-1` unsets this setting.
-
-For more information about these properties, see <<ml-datafeed-resource>>.
-
+(Optional, unsigned integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
 
 [[ml-update-datafeed-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/delayed-data-detection.asciidoc b/docs/reference/ml/anomaly-detection/delayed-data-detection.asciidoc
index 625f839a86834..53f1756a4ec92 100644
--- a/docs/reference/ml/anomaly-detection/delayed-data-detection.asciidoc
+++ b/docs/reference/ml/anomaly-detection/delayed-data-detection.asciidoc
@@ -5,14 +5,15 @@
 Delayed data are documents that are indexed late. That is to say, it is data
 related to a time that the {dfeed} has already processed.
 
-When you create a datafeed, you can specify a
-{ref}/ml-datafeed-resource.html[`query_delay`] setting. This setting enables the
-datafeed to wait for some time past real-time, which means any "late" data in
-this period is fully indexed before the datafeed tries to gather it. However, if
-the setting is set too low, the datafeed may query for data before it has been
-indexed and consequently miss that document. Conversely, if it is set too high,
-analysis drifts farther away from real-time. The balance that is struck depends
-upon each use case and the environmental factors of the cluster.
+When you create a {dfeed}, you can specify a
+{ref}/ml-put-datafeed.html#ml-put-datafeed-request-body[`query_delay`] setting.
+This setting enables the {dfeed} to wait for some time past real-time, which
+means any "late" data in this period is fully indexed before the {dfeed} tries
+to gather it. However, if the setting is set too low, the {dfeed} may query for
+data before it has been indexed and consequently miss that document. Conversely,
+if it is set too high, analysis drifts farther away from real-time. The balance
+that is struck depends upon each use case and the environmental factors of the
+cluster.
 
 ==== Why worry about delayed data?
 
@@ -28,8 +29,7 @@ recorded so that you can determine a next course of action.
 
 ==== How do we detect delayed data?
 
-In addition to the `query_delay` field, there is a
-{ref}/ml-datafeed-resource.html#ml-datafeed-delayed-data-check-config[delayed data check config],
+In addition to the `query_delay` field, there is a delayed data check config,
 which enables you to configure the datafeed to look in the past for delayed data.
 Every 15 minutes or every `check_window`, whichever is smaller, the datafeed
 triggers a document search over the configured indices. This search looks over a
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index bea970078d06b..f277e6ab2e4ad 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -1,3 +1,10 @@
+tag::aggregations[]
+If set, the {dfeed} performs aggregation searches. Support for aggregations is
+limited and should only be used with low cardinality data. For more information,
+see
+{stack-ov}/ml-configuring-aggregation.html[Aggregating data for faster performance].
+end::aggregations[]
+
 tag::allow-lazy-open[]
 Advanced configuration option. Specifies whether this job can open when there is 
 insufficient {ml} node capacity for it to be immediately assigned to a node. The
@@ -9,6 +16,21 @@ return an error and the job waits in the `opening` state until sufficient {ml}
 node capacity is available.
 end::allow-lazy-open[]
 
+tag::allow-no-datafeeds[]
+Specifies what to do when the request:
++
+--
+* Contains wildcard expressions and there are no {dfeeds} that match.
+* Contains the `_all` string or no identifiers and there are no matches.
+* Contains wildcard expressions and there are only partial matches. 
+
+The default value is `true`, which returns an empty `datafeeds` array when
+there are no matches and the subset of results when there are partial matches.
+If this parameter is `false`, the request returns a `404` status code when there
+are no matches or only partial matches.
+--
+end::allow-no-datafeeds[]
+
 tag::allow-no-jobs[]
 Specifies what to do when the request:
 +
@@ -207,6 +229,22 @@ add them here as
 <<analysis-pattern-replace-charfilter,pattern replace character filters>>.
 end::char-filter[]
 
+tag::chunking-config[]
+{dfeeds-cap} might be required to search over long time periods, for several months
+or years. This search is split into time chunks in order to ensure the load
+on {es} is managed. Chunking configuration controls how the size of these time
+chunks are calculated and is an advanced configuration option.
+A chunking configuration object has the following properties:
+
+`mode`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=mode]
+
+`time_span`:::
+(<<time-units,time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=time-span]
+end::chunking-config[]
+
 tag::custom-rules[]
 An array of custom rule objects, which enable you to customize the way detectors
 operate. For example, a rule may dictate to the detector conditions under which
@@ -301,6 +339,47 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=time-format]
 --
 end::data-description[]
 
+tag::datafeed-id[]
+A numerical character string that uniquely identifies the
+{dfeed}. This identifier can contain lowercase alphanumeric characters (a-z
+and 0-9), hyphens, and underscores. It must start and end with alphanumeric
+characters.
+end::datafeed-id[]
+
+tag::datafeed-id-wildcard[]
+Identifier for the {dfeed}. It can be a {dfeed} identifier or a wildcard
+expression.
+end::datafeed-id-wildcard[]
+
+tag::delayed-data-check-config[]
+Specifies whether the {dfeed} checks for missing data and the size of the
+window. For example: `{"enabled": true, "check_window": "1h"}`.
++
+--
+The {dfeed} can optionally search over indices that have already been read in
+an effort to determine whether any data has subsequently been added to the index.
+If missing data is found, it is a good indication that the `query_delay` option
+is set too low and the data is being indexed after the {dfeed} has passed that
+moment in time. See 
+{stack-ov}/ml-delayed-data-detection.html[Working with delayed data].
+
+This check runs only on real-time {dfeeds}.
+
+The configuration object has the following properties:
+
+`enabled`::
+(boolean) Specifies whether the {dfeed} periodically checks for delayed data.
+Defaults to `true`.
+
+`check_window`::
+(<<time-units,time units>>) The window of time that is searched for late data.
+This window of time ends with the latest finalized bucket. It defaults to
+`null`, which causes an appropriate `check_window` to be calculated when the
+real-time {dfeed} runs. In particular, the default `check_window` span
+calculation is based on the maximum of `2h` or `8 * bucket_span`.
+--
+end::delayed-data-check-config[]
+
 tag::dependent_variable[]
 `dependent_variable`::
 (Required, string) Defines which field of the document is to be predicted. 
@@ -405,6 +484,13 @@ optional. If it is not specified, no token filters are applied prior to
 categorization.
 end::filter[]
 
+tag::frequency[]
+The interval at which scheduled queries are made while the {dfeed} runs in real
+time. The default value is either the bucket span for short bucket spans, or,
+for longer bucket spans, a sensible fraction of the bucket span. For example:
+`150s`.
+end::frequency[]
+
 tag::function[]
 The analysis function that is used. For example, `count`, `rare`, `mean`, `min`, 
 `max`, and `sum`. For more information, see
@@ -424,6 +510,17 @@ tag::groups[]
 A list of job groups. A job can belong to no groups or many.
 end::groups[]
 
+tag::indices[]
+An array of index names. Wildcards are supported. For example:
+`["it_ops_metrics", "server*"]`.
++
+--
+NOTE: If any indices are in remote clusters then `cluster.remote.connect` must
+not be set to `false` on any {ml} nodes.
+
+--
+end::indices[]
+
 tag::influencers[]
 A comma separated list of influencer field names. Typically these can be the by, 
 over, or partition fields that are used in the detector configuration. You might 
@@ -475,6 +572,10 @@ alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start
 and end with alphanumeric characters.
 end::job-id-data-frame-analytics-define[]
 
+tag::job-id-datafeed[]
+The unique identifier for the job to which the {dfeed} sends data.
+end::job-id-datafeed[]
+
 tag::jobs-stats-anomaly-detection[]
 An array of {anomaly-job} statistics objects.
 For more information, see <<ml-jobstats>>.
@@ -502,12 +603,32 @@ the <<ml-post-data,post data>> API.
 --
 end::latency[]
 
+tag::max-empty-searches[]
+If a real-time {dfeed} has never seen any data (including during any initial
+training period) then it will automatically stop itself and close its associated
+job after this many real-time searches that return no documents. In other words,
+it will stop after `frequency` times `max_empty_searches` of real-time operation.
+If not set then a {dfeed} with no end time that sees no data will remain started
+until it is explicitly stopped. By default this setting is not set.
+end::max-empty-searches[]
+
 tag::maximum_number_trees[]
 `maximum_number_trees`::
 (Optional, integer) Defines the maximum number of trees the forest is allowed 
 to contain. The maximum value is 2000.
 end::maximum_number_trees[]
 
+tag::mode[]
+There are three available modes: 
++
+--
+* `auto`: The chunk size is dynamically calculated. This is the default and
+recommended value.
+* `manual`: Chunking is applied according to the specified `time_span`.
+* `off`: No chunking is applied.
+--
+end::mode[]
+
 tag::model-memory-limit[]
 The approximate maximum amount of memory resources that are required for 
 analytical processing. Once this limit is approached, data pruning becomes
@@ -615,6 +736,21 @@ tag::prediction_field_name[]
 Defaults to `<dependent_variable>_prediction`.
 end::prediction_field_name[]
 
+tag::query[]
+The {es} query domain-specific language (DSL). This value corresponds to the
+query object in an {es} search POST body. All the options that are supported by
+{es} can be used, as this object is passed verbatim to {es}. By default, this
+property has the following value: `{"match_all": {"boost": 1}}`.
+end::query[]
+
+tag::query-delay[]
+The number of seconds behind real time that data is queried. For example, if
+data from 10:04 a.m. might not be searchable in {es} until 10:06 a.m., set this
+property to 120 seconds. The default value is randomly selected between `60s`
+and `120s`. This randomness improves the query performance when there are
+multiple jobs running on the same node.
+end::query-delay[]
+
 tag::renormalization-window-days[]
 Advanced configuration option. The period over which adjustments to the score
 are applied, as new data is seen. The default value is the longer of 30 days or
@@ -633,6 +769,18 @@ are deleted from {es}. The default value is null, which means results are
 retained.
 end::results-retention-days[]
 
+tag::script-fields[]
+Specifies scripts that evaluate custom expressions and returns script fields to
+the {dfeed}. The detector configuration objects in a job can contain functions
+that use these script fields. For more information, see
+{stack-ov}/ml-configuring-transform.html[Transforming data with script fields]
+and <<request-body-search-script-fields,Script fields>>.
+end::script-fields[]
+
+tag::scroll-size[]
+The `size` parameter that is used in {es} searches. The default value is `1000`.
+end::scroll-size[]
+
 tag::summary-count-field-name[]
 If this property is specified, the data that is fed to the job is expected to be
 pre-summarized. This property value is the name of the field that contains the 
@@ -663,6 +811,11 @@ job creation fails.
 --
 end::time-format[]
 
+tag::time-span[]
+The time span that each search will be querying. This setting is only applicable
+when the mode is set to `manual`. For example: `3h`.
+end::time-span[]
+
 tag::tokenizer[]
 The name or definition of the <<analysis-tokenizers,tokenizer>> to use after 
 character filters are applied. This property is compulsory if 
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 26694e9aa05ab..afc10a4493b17 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -1054,4 +1054,15 @@ This page was deleted.
 [[ml-analysisconfig]]
 See the details in
 [[ml-apimodelplotconfig]]
-<<ml-put-job>>, <<ml-update-job>>, and <<ml-get-job>>.
\ No newline at end of file
+<<ml-put-job>>, <<ml-update-job>>, and <<ml-get-job>>.
+
+[role="exclude",id="ml-datafeed-resource"]
+=== {dfeed-cap} resources
+
+This page was deleted.
+[[ml-datafeed-chunking-config]]
+See the details in <<ml-put-datafeed>>, <<ml-update-datafeed>>, 
+[[ml-datafeed-delayed-data-check-config]]
+<<ml-get-datafeed>>, 
+[[ml-datafeed-counts]]
+<<ml-get-datafeed-stats>>.
\ No newline at end of file
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index ec1a5a0e4154f..8bdf35e62f11b 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -5,8 +5,6 @@
 These resource definitions are used in APIs related to {ml-features} and
 {security-features} and in {kib} advanced {ml} job configuration options.
 
-* <<ml-datafeed-resource,{dfeeds-cap}>>
-* <<ml-datafeed-counts,{dfeed-cap} counts>>
 * <<ml-dfanalytics-resources,{dfanalytics-cap}>>
 * <<ml-evaluate-dfanalytics-resources,Evaluate {dfanalytics}>>
 * <<ml-jobstats,{anomaly-jobs-cap} statistics>>
@@ -15,7 +13,6 @@ These resource definitions are used in APIs related to {ml-features} and
 * <<role-mapping-resources,Role mappings>>
 * <<transform-resource,{transforms-cap}>>
 
-include::{es-repo-dir}/ml/anomaly-detection/apis/datafeedresource.asciidoc[]
 include::{es-repo-dir}/ml/df-analytics/apis/dfanalyticsresources.asciidoc[]
 include::{es-repo-dir}/ml/df-analytics/apis/evaluateresources.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/jobcounts.asciidoc[]

From 31fe7000a9b700c6112da65165a497ed5351d78b Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 11 Dec 2019 11:04:26 -0800
Subject: [PATCH 156/686] Fix exception message for boolean BuildParams
 properties (#50094)

---
 .../java/org/elasticsearch/gradle/info/BuildParams.java         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
index 9fba20c7db77c..19748de1b96f1 100644
--- a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
+++ b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
@@ -137,7 +137,7 @@ private static <T> T value(T object) {
     }
 
     private static String propertyName(String methodName) {
-        String propertyName = methodName.substring("get".length());
+        String propertyName = methodName.startsWith("is") ? methodName.substring("is".length()) : methodName.substring("get".length());
         return propertyName.substring(0, 1).toLowerCase() + propertyName.substring(1);
     }
 

From d87de8e7251b9c26afab5c9b57e0be40b48c45a6 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Wed, 11 Dec 2019 11:17:15 -0800
Subject: [PATCH 157/686] [DOCS] Move job count resource definitions into API
 (#50057)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Przemysław Witek <przemyslaw.witek@elastic.co>
Co-Authored-By: David Roberts <dave.roberts@elastic.co>
Co-Authored-By: Ed Savage <32410745+edsavage@users.noreply.github.com>
---
 .../apis/get-job-stats.asciidoc               | 396 ++++++++++++++++--
 .../anomaly-detection/apis/jobcounts.asciidoc | 260 ------------
 .../anomaly-detection/apis/post-data.asciidoc |   8 +-
 docs/reference/ml/ml-shared.asciidoc          |   5 -
 docs/reference/redirects.asciidoc             |  18 +-
 docs/reference/rest-api/defs.asciidoc         |   2 -
 6 files changed, 371 insertions(+), 318 deletions(-)
 delete mode 100644 docs/reference/ml/anomaly-detection/apis/jobcounts.asciidoc

diff --git a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
index 99928e43ca5f3..4ef7704fe9fd0 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
@@ -53,11 +53,274 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 [[ml-get-job-stats-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns the following information about the operational progress of a
+job:
 
-`jobs`::
-(array) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=jobs-stats-anomaly-detection]
+`assignment_explanation`::
+(string) For open jobs only, contains messages relating to the selection
+of a node to run the job.
+
+[[datacounts]]`data_counts`::
+(object) An object that describes the quantity of input to the job and any
+related error counts. The `data_count` values are cumulative for the lifetime of
+a job. If a model snapshot is reverted or old results are deleted, the job
+counts are not reset.
+
+`bucket_count`:::
+(long) The number of bucket results produced by the job.
+
+`earliest_record_timestamp`:::
+(date) The timestamp of the earliest chronologically input document.
+
+`empty_bucket_count`:::
+(long) The number of buckets which did not contain any data. If your data
+contains many empty buckets, consider increasing your `bucket_span` or using
+functions that are tolerant to gaps in data such as `mean`, `non_null_sum` or
+`non_zero_count`.
+
+`input_bytes`:::
+(long) The number of bytes of input data posted to the job.
+
+`input_field_count`:::
+(long) The total number of fields in input documents posted to the job. This
+count includes fields that are not used in the analysis. However, be aware that
+if you are using a {dfeed}, it extracts only the required fields from the
+documents it retrieves before posting them to the job.
+
+`input_record_count`:::
+(long) The number of input documents posted to the job.
+
+`invalid_date_count`:::
+(long) The number of input documents with either a missing date field or a date
+that could not be parsed.
+
+`job_id`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`last_data_time`:::
+(date) The timestamp at which data was last analyzed, according to server time.
+
+`latest_empty_bucket_timestamp`:::
+(date) The timestamp of the last bucket that did not contain any data.
+
+`latest_record_timestamp`:::
+(date) The timestamp of the latest chronologically input document.
+
+`latest_sparse_bucket_timestamp`:::
+(date) The timestamp of the last bucket that was considered sparse.
+
+`missing_field_count`:::
+(long) The number of input documents that are missing a field that the job is
+configured to analyze. Input documents with missing fields are still processed
+because it is possible that not all fields are missing. The value of
+`processed_record_count` includes this count.
++
+--
+NOTE: If you are using {dfeeds} or posting data to the job in JSON format, a
+high `missing_field_count` is often not an indication of data issues. It is not
+necessarily a cause for concern.
+
+--
+
+`out_of_order_timestamp_count`:::
+(long) The number of input documents that are out of time sequence and outside
+of the latency window. This information is applicable only when you provide data
+to the job by using the <<ml-post-data,post data API>>. These out of order
+documents are  discarded, since jobs require time series data to be in ascending
+chronological order.
+
+`processed_field_count`:::
+(long) The total number of fields in all the documents that have been processed
+by the job. Only fields that are specified in the detector configuration object
+contribute to this count. The timestamp is not included in this count.
+
+`processed_record_count`:::
+(long) The number of input documents that have been processed by the job. This
+value includes documents with missing fields, since they are nonetheless
+analyzed. If you use {dfeeds} and have aggregations in your search query, the
+`processed_record_count` will be the number of aggregation results processed,
+not the number of {es} documents.
+
+`sparse_bucket_count`:::
+(long) The number of buckets that contained few data points compared to the
+expected number of data points. If your data contains many sparse buckets,
+consider using a longer `bucket_span`.
+
+[[forecastsstats]]`forecasts_stats`::
+(object) An object that provides statistical information about forecasts
+of this job. It has the following properties:
++
+--
+NOTE: Unless there is at least one forecast, `memory_bytes`, `records`,
+`processing_time_ms` and `status` properties are omitted.
+
+--
+
+`forecasted_jobs`:::
+(long) The number of jobs that have at least one forecast.
+
+`memory_bytes`:::
+(object) Statistics about the memory usage: minimum, maximum, average and total.
+
+`records`:::
+(object) Statistics about the number of forecast records: minimum, maximum,
+saverage and total.
+
+`processing_time_ms`:::
+(object) Statistics about the forecast runtime in milliseconds: minimum, maximum,
+average and total.
+
+`status`:::
+(object) Counts per forecast status. For example: `{"finished" : 2}`. 
+
+`total`:::
+(long) The number of forecasts currently available for this model.
+
+`job_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+[[modelsizestats]]`model_size_stats`::
+(object) An object that provides information about the size and contents of the
+model. It has the following properties:
+ 
+`bucket_allocation_failures_count`:::
+(long) The number of buckets for which new entities in incoming data were not
+processed due to insufficient model memory. This situation is also signified
+by a `hard_limit: memory_status` property value.
+
+`job_id`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`log_time`:::
+(date) The timestamp of the `model_size_stats` according to server time.
+
+`memory_status`:::
+(string) The status of the mathematical models. This property can have one of
+the following values:
++
+--
+* `ok`: The models stayed below the configured value.
+* `soft_limit`: The models used more than 60% of the configured memory limit
+and older unused models will be pruned to free up space.
+* `hard_limit`: The models used more space than the configured memory limit.
+As a result, not all incoming data was processed.
+--
+
+`model_bytes`:::
+(long) The number of bytes of memory used by the models. This is the maximum
+value since the last time the model was persisted. If the job is closed,
+this value indicates the latest size.
+
+`model_bytes_exceeded`:::
+ (long) The number of bytes over the high limit for memory usage at the last
+ allocation failure.
+
+`model_bytes_memory_limit`:::
+(long) The upper limit for memory usage, checked on increasing values.
+
+`result_type`:::
+(string) For internal use. The type of result.
+
+`total_by_field_count`:::
+(long) The number of `by` field values that were analyzed by the models.
++
+--
+NOTE: The `by` field values are counted separately for each detector and
+partition.
+
+--
+
+`total_over_field_count`:::
+(long) The number of `over` field values that were analyzed by the models.
++
+--
+NOTE: The `over` field values are counted separately for each detector and
+partition.
+
+--
+
+`total_partition_field_count`:::
+(long) The number of `partition` field values that were analyzed by the models.
+
+`timestamp`:::
+(date) The timestamp of the `model_size_stats` according to the timestamp of the
+data.
+
+[[stats-node]]`node`::
+(object) Contains properties for the node that runs the job. This information is
+available only for open jobs.
+
+`attributes`:::
+(object) Lists node attributes. For example,
+`{"ml.machine_memory": "17179869184", "ml.max_open_jobs" : "20"}`.
+  
+`ephemeral_id`:::
+(string) The ephemeral ID of the node.
+
+`id`:::
+(string) The unique identifier of the node.
+
+`name`:::
+(string) The node name.
+
+`transport_address`:::
+(string) The host and port where transport HTTP connections are accepted.
+
+`open_time`::
+(string) For open jobs only, the elapsed time for which the job has been open.
+For example, `28746386s`.
+
+`state`::
+(string) The status of the job, which can be one of the following values:
++
+--
+* `closed`: The job finished successfully with its model state persisted. The
+job must be opened before it can accept further data.
+* `closing`: The job close action is in progress and has not yet completed. A
+closing job cannot accept further data.
+* `failed`: The job did not finish successfully due to an error. This situation
+can occur due to invalid input data, a fatal error occurring during the analysis,
+or an external interaction such as the process being killed by the Linux out of
+memory (OOM) killer. If the job had irrevocably failed, it must be force closed
+and then deleted. If the {dfeed} can be corrected, the job can be closed and
+then re-opened.
+* `opened`: The job is available to receive and process data.
+* `opening`: The job open action is in progress and has not yet completed.
+--
+
+[[timingstats]]`timing_stats`::
+(object) An object that provides statistical information about timing aspect of
+this job. It has the following properties:
+
+`average_bucket_processing_time_ms`:::
+(double) Average of all bucket processing times in milliseconds.
+
+`bucket_count`:::
+(long) The number of buckets processed.
+
+`exponential_average_bucket_processing_time_ms`:::
+(double) Exponential moving average of all bucket processing times in
+milliseconds.
+
+`exponential_average_bucket_processing_time_per_hour_ms`:::
+(double) Exponentially-weighted moving average of bucket processing times
+calculated in a 1 hour time window.
+
+`job_id`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`maximum_bucket_processing_time_ms`:::
+(double) Maximum among all bucket processing times in milliseconds.
+
+`minimum_bucket_processing_time_ms`:::
+(double) Minimum among all bucket processing times in milliseconds.
+
+`total_bucket_processing_time_ms`:::
+(double) Sum of all bucket processing times in milliseconds.
 
 [[ml-get-job-stats-response-codes]]
 ==== {api-response-codes-title}
@@ -69,59 +332,100 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=jobs-stats-anomaly-detection]
 [[ml-get-job-stats-example]]
 ==== {api-examples-title}
 
-The following example gets usage information for the `farequote` job:
-
 [source,console]
 --------------------------------------------------
-GET _ml/anomaly_detectors/farequote/_stats
+GET _ml/anomaly_detectors/low_request_rate/_stats
 --------------------------------------------------
-// TEST[skip:todo]
+// TEST[skip:Kibana sample data]
 
 The API returns the following results:
 [source,js]
 ----
 {
-  "count": 1,
-  "jobs": [
+  "count" : 1,
+  "jobs" : [
     {
-      "job_id": "farequote",
-      "data_counts": {
-        "job_id": "farequote",
-        "processed_record_count": 86275,
-        "processed_field_count": 172550,
-        "input_bytes": 6744714,
-        "input_field_count": 172550,
-        "invalid_date_count": 0,
-        "missing_field_count": 0,
-        "out_of_order_timestamp_count": 0,
-        "empty_bucket_count": 0,
-        "sparse_bucket_count": 15,
-        "bucket_count": 1528,
-        "earliest_record_timestamp": 1454803200000,
-        "latest_record_timestamp": 1455235196000,
-        "last_data_time": 1491948163685,
-        "latest_sparse_bucket_timestamp": 1455174900000,
-        "input_record_count": 86275
+      "job_id" : "low_request_rate",
+      "data_counts" : {
+        "job_id" : "low_request_rate",
+        "processed_record_count" : 1216,
+        "processed_field_count" : 1216,
+        "input_bytes" : 51678,
+        "input_field_count" : 1216,
+        "invalid_date_count" : 0,
+        "missing_field_count" : 0,
+        "out_of_order_timestamp_count" : 0,
+        "empty_bucket_count" : 242,
+        "sparse_bucket_count" : 0,
+        "bucket_count" : 1457,
+        "earliest_record_timestamp" : 1575172659612,
+        "latest_record_timestamp" : 1580417369440,
+        "last_data_time" : 1576017595046,
+        "latest_empty_bucket_timestamp" : 1580356800000,
+        "input_record_count" : 1216
+      },
+      "model_size_stats" : {
+        "job_id" : "low_request_rate",
+        "result_type" : "model_size_stats",
+        "model_bytes" : 41480,
+        "model_bytes_exceeded" : 0,
+        "model_bytes_memory_limit" : 10485760,
+        "total_by_field_count" : 3,
+        "total_over_field_count" : 0,
+        "total_partition_field_count" : 2,
+        "bucket_allocation_failures_count" : 0,
+        "memory_status" : "ok",
+        "log_time" : 1576017596000,
+        "timestamp" : 1580410800000
+      },
+      "forecasts_stats" : {
+        "total" : 1,
+        "forecasted_jobs" : 1,
+        "memory_bytes" : {
+          "total" : 9179.0,
+          "min" : 9179.0,
+          "avg" : 9179.0,
+          "max" : 9179.0
+        },
+        "records" : {
+          "total" : 168.0,
+          "min" : 168.0,
+          "avg" : 168.0,
+          "max" : 168.0
+        },
+        "processing_time_ms" : {
+          "total" : 40.0,
+          "min" : 40.0,
+          "avg" : 40.0,
+          "max" : 40.0
+        },
+        "status" : {
+          "finished" : 1
+        }
       },
-      "model_size_stats": {
-        "job_id": "farequote",
-        "result_type": "model_size_stats",
-        "model_bytes": 387594,
-        "total_by_field_count": 21,
-        "total_over_field_count": 0,
-        "total_partition_field_count": 20,
-        "bucket_allocation_failures_count": 0,
-        "memory_status": "ok",
-        "log_time": 1491948163000,
-        "timestamp": 1455234600000
+      "state" : "opened",
+      "node" : {
+        "id" : "7bmMXyWCRs-TuPfGJJ_yMw",
+        "name" : "node-0",
+        "ephemeral_id" : "hoXMLZB0RWKfR9UPPUCxXX",
+        "transport_address" : "127.0.0.1:9300",
+        "attributes" : {
+          "ml.machine_memory" : "17179869184",
+          "xpack.installed" : "true",
+          "ml.max_open_jobs" : "20"
+        }
       },
-      "state": "closed",
-      "timing_stats": {
-        "job_id": "farequote",
-        "minimum_bucket_processing_time_ms": 0.0,
-        "maximum_bucket_processing_time_ms": 15.0,
-        "average_bucket_processing_time_ms": 8.75,
-        "exponential_average_bucket_processing_time_ms": 6.1435899
+      "assignment_explanation" : "",
+      "open_time" : "13s",
+      "timing_stats" : {
+        "job_id" : "low_request_rate",
+        "bucket_count" : 1457,
+        "total_bucket_processing_time_ms" : 1094.000000000001,
+        "minimum_bucket_processing_time_ms" : 0.0,
+        "maximum_bucket_processing_time_ms" : 48.0,
+        "average_bucket_processing_time_ms" : 0.75085792724777,
+        "exponential_average_bucket_processing_time_ms" : 0.5571716855800993,
+        "exponential_average_bucket_processing_time_per_hour_ms" : 15.0
       }
     }
   ]
diff --git a/docs/reference/ml/anomaly-detection/apis/jobcounts.asciidoc b/docs/reference/ml/anomaly-detection/apis/jobcounts.asciidoc
deleted file mode 100644
index 9f205d6f614bf..0000000000000
--- a/docs/reference/ml/anomaly-detection/apis/jobcounts.asciidoc
+++ /dev/null
@@ -1,260 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-jobstats]]
-=== Job statistics
-
-The get job statistics API provides information about the operational
-progress of a job.
-
-`assignment_explanation`::
-  (string) For open jobs only, contains messages relating to the selection
-  of a node to run the job.
-
-`data_counts`::
-  (object) An object that describes the number of records processed and
-  any related error counts. See <<ml-datacounts,data counts objects>>.
-
-`job_id`::
-  (string) A unique identifier for the job.
-
-`model_size_stats`::
-  (object) An object that provides information about the size and contents of the model.
-  See <<ml-modelsizestats,model size stats objects>>.
-
-`forecasts_stats`::
-  (object) An object that provides statistical information about forecasts
-  of this job. See <<ml-forecastsstats, forecasts stats objects>>.
-
-`timing_stats`::
-  (object) An object that provides statistical information about timing aspect
-  of this job. See <<ml-timingstats, timing stats objects>>.
-
-`node`::
-  (object) For open jobs only, contains information about the node where the
-  job runs. See <<ml-stats-node,node object>>.
-
-`open_time`::
-  (string) For open jobs only, the elapsed time for which the job has been open.
-  For example, `28746386s`.
-
-`state`::
-  (string) The status of the job, which can be one of the following values:
-
-  `opened`::: The job is available to receive and process data.
-  `closed`::: The job finished successfully with its model state persisted.
-  The job must be opened before it can accept further data.
-  `closing`::: The job close action is in progress and has not yet completed.
-  A closing job cannot accept further data.
-  `failed`::: The job did not finish successfully due to an error.
-  This situation can occur due to invalid input data.
-  If the job had irrevocably failed, it must be force closed and then deleted.
-  If the {dfeed} can be corrected, the job can be closed and then re-opened.
-  `opening`::: The job open action is in progress and has not yet completed.
-
-[float]
-[[ml-datacounts]]
-==== Data Counts Objects
-
-The `data_counts` object describes the number of records processed
-and any related error counts.
-
-The `data_count` values are cumulative for the lifetime of a job. If a model snapshot is reverted
-or old results are deleted, the job counts are not reset.
-
-`bucket_count`::
-  (long) The number of bucket results produced by the job.
-
-`earliest_record_timestamp`::
-  (date) The timestamp of the earliest chronologically input document.
-
-`empty_bucket_count`::
-  (long) The number of buckets which did not contain any data. If your data contains many
-  empty buckets, consider increasing your `bucket_span` or using functions that are tolerant
-  to gaps in data such as `mean`, `non_null_sum` or `non_zero_count`.
-
-`input_bytes`::
-  (long) The number of raw bytes read by the job.
-
-`input_field_count`::
-  (long) The total number of record fields read by the job. This count includes
-  fields that are not used in the analysis.
-
-`input_record_count`::
-  (long) The number of data records read by the job.
-
-`invalid_date_count`::
-  (long) The number of records with either a missing date field or a date that could not be parsed.
-
-`job_id`::
-  (string) A unique identifier for the job.
-
-`last_data_time`::
-  (date) The timestamp at which data was last analyzed, according to server time.
-
-`latest_empty_bucket_timestamp`::
-  (date) The timestamp of the last bucket that did not contain any data.
-
-`latest_record_timestamp`::
-  (date) The timestamp of the latest chronologically input document.
-
-`latest_sparse_bucket_timestamp`::
-  (date) The timestamp of the last bucket that was considered sparse.
-
-`missing_field_count`::
-  (long) The number of records that are missing a field that the job is
-  configured to analyze. Records with missing fields are still processed because
-  it is possible that not all fields are missing. The value of
-  `processed_record_count` includes this count. +
-
-NOTE: If you are using {dfeeds} or posting data to the job in JSON format, a
-high `missing_field_count` is often not an indication of data issues. It is not
-necessarily a cause for concern.
-
-`out_of_order_timestamp_count`::
-  (long) The number of records that are out of time sequence and
-  outside of the latency window. This information is applicable only when
-  you provide data to the job by using the <<ml-post-data,post data API>>.
-  These out of order records are discarded, since jobs require time series data
-  to be in ascending chronological order.
-
-`processed_field_count`::
-  (long) The total number of fields in all the records that have been processed
-  by the job. Only fields that are specified in the detector configuration
-  object contribute to this count. The time stamp is not included in this count.
-
-`processed_record_count`::
-  (long) The number of records that have been processed by the job.
-  This value includes records with missing fields, since they are nonetheless
-  analyzed. +
-  If you use {dfeeds} and have aggregations in your search query,
-  the `processed_record_count` will be the number of aggregated records
-  processed, not the number of {es} documents.
-
-`sparse_bucket_count`::
-  (long) The number of buckets that contained few data points compared to the
-  expected number of data points. If your data contains many sparse buckets,
-  consider using a longer `bucket_span`.
-
-[float]
-[[ml-modelsizestats]]
-==== Model Size Stats Objects
-
-The `model_size_stats` object has the following properties:
-
-`bucket_allocation_failures_count`::
-  (long) The number of buckets for which new entities in incoming data were not
-  processed due to insufficient model memory. This situation is also signified
-  by a `hard_limit: memory_status` property value.
-
-`job_id`::
-  (string) A numerical character string that uniquely identifies the job.
-
-`log_time`::
-  (date) The timestamp of the `model_size_stats` according to server time.
-
-`memory_status`::
-  (string) The status of the mathematical models.
-  This property can have one of the following values:
-  `ok`::: The models stayed below the configured value.
-  `soft_limit`::: The models used more than 60% of the configured memory limit
-  and older unused models will be pruned to free up space.
-  `hard_limit`::: The models used more space than the configured memory limit.
-  As a result, not all incoming data was processed.
-
-`model_bytes`::
-  (long) The number of bytes of memory used by the models. This is the maximum
-  value since the last time the model was persisted. If the job is closed,
-  this value indicates the latest size.
-
-`result_type`::
-  (string) For internal use. The type of result.
-
-`total_by_field_count`::
-  (long) The number of `by` field values that were analyzed by the models.+
-
-NOTE: The `by` field values are counted separately for each detector and partition.
-
-`total_over_field_count`::
-  (long) The number of `over` field values that were analyzed by the models.+
-
-NOTE: The `over` field values are counted separately for each detector and partition.
-
-`total_partition_field_count`::
-  (long) The number of `partition` field values that were analyzed by the models.
-
-`timestamp`::
-  (date) The timestamp of the `model_size_stats` according to the timestamp of the data.
-
-[float]
-[[ml-forecastsstats]]
-==== Forecasts Stats Objects
-
-The `forecasts_stats` object shows statistics about forecasts. It has the following properties:
-
-`total`::
-  (long) The number of forecasts currently available for this model.
-
-`forecasted_jobs`::
-  (long) The number of jobs that have at least one forecast.
-
-`memory_bytes`::
-  (object) Statistics about the memory usage: minimum, maximum, average and total.
-
-`records`::
-  (object) Statistics about the number of forecast records: minimum, maximum, average and total.
-
-`processing_time_ms`::
-  (object) Statistics about the forecast runtime in milliseconds: minimum, maximum, average and total.
-
-`status`::
-  (object) Counts per forecast status, for example: {"finished" : 2}. 
-
-NOTE: `memory_bytes`, `records`, `processing_time_ms` and `status` require at least 1 forecast, otherwise
-these fields are omitted.
-
-[float]
-[[ml-timingstats]]
-==== Timing Stats Objects
-
-The `timing_stats` object shows timing-related statistics about the job's progress. It has the following properties:
-
-`job_id`::
-  (string) A numerical character string that uniquely identifies the job.
-
-`bucket_count`::
-  (long) The number of buckets processed.
-
-`minimum_bucket_processing_time_ms`::
-  (double) Minimum among all bucket processing times in milliseconds.
-
-`maximum_bucket_processing_time_ms`::
-  (double) Maximum among all bucket processing times in milliseconds.
-
-`average_bucket_processing_time_ms`::
-  (double) Average of all bucket processing times in milliseconds.
-
-`exponential_average_bucket_processing_time_ms`::
-  (double) Exponential moving average of all bucket processing times in milliseconds.
-
-
-[float]
-[[ml-stats-node]]
-==== Node Objects
-
-The `node` objects contains properties for the node that runs the job.
-This information is available only for open jobs.
-
-`id`::
-  (string) The unique identifier of the node.
-
-`name`::
-  (string) The node name.
-
-`ephemeral_id`::
-  (string) The ephemeral id of the node.
-
-`transport_address`::
-  (string) The host and port where transport HTTP connections are accepted.
-
-`attributes`::
-  (object) For example, {"ml.machine_memory": "17179869184"}.
diff --git a/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
index cfd3d4ca67fdc..d4fa82b217f64 100644
--- a/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
@@ -37,10 +37,10 @@ and upload each one separately in sequential time order. When running in
 real time, it is generally recommended that you perform many small uploads,
 rather than queueing data to upload larger files.
 
-When uploading data, check the <<ml-datacounts,job data counts>> for progress.
-The following records will not be processed:
+When uploading data, check the job data counts for progress.
+The following documents will not be processed:
 
-* Records not in chronological order and outside the latency window
+* Documents not in chronological order and outside the latency window
 * Records with an invalid timestamp
 
 //TBD link to Working with Out of Order timeseries concept doc
@@ -109,4 +109,4 @@ the job. For example:
 }
 ----
 
-For more information about these properties, see <<ml-jobstats,Job Stats>>.
+For more information about these properties, see <<ml-get-job-stats-results>>.
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index f277e6ab2e4ad..65fd370dda9ad 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -576,11 +576,6 @@ tag::job-id-datafeed[]
 The unique identifier for the job to which the {dfeed} sends data.
 end::job-id-datafeed[]
 
-tag::jobs-stats-anomaly-detection[]
-An array of {anomaly-job} statistics objects.
-For more information, see <<ml-jobstats>>.
-end::jobs-stats-anomaly-detection[]
-
 tag::lambda[]
 `lambda`::
 (Optional, double) Regularization parameter to prevent overfitting on the 
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index afc10a4493b17..858e128944742 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -1065,4 +1065,20 @@ See the details in <<ml-put-datafeed>>, <<ml-update-datafeed>>,
 [[ml-datafeed-delayed-data-check-config]]
 <<ml-get-datafeed>>, 
 [[ml-datafeed-counts]]
-<<ml-get-datafeed-stats>>.
\ No newline at end of file
+<<ml-get-datafeed-stats>>.
+
+[role="exclude",id="ml-jobstats"]
+=== Job statistics
+
+This
+[[ml-datacounts]]
+page
+[[ml-modelsizestats]]
+was
+[[ml-forecastsstats]]
+deleted.
+[[ml-timingstats]]
+See
+[[ml-stats-node]]
+the details in <<ml-get-job-stats>>.
+
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index 8bdf35e62f11b..0ef152e917f8e 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -7,7 +7,6 @@ These resource definitions are used in APIs related to {ml-features} and
 
 * <<ml-dfanalytics-resources,{dfanalytics-cap}>>
 * <<ml-evaluate-dfanalytics-resources,Evaluate {dfanalytics}>>
-* <<ml-jobstats,{anomaly-jobs-cap} statistics>>
 * <<ml-snapshot-resource,{anomaly-detect-cap} model snapshots>>
 * <<ml-results-resource,{anomaly-detect-cap} results>>
 * <<role-mapping-resources,Role mappings>>
@@ -15,7 +14,6 @@ These resource definitions are used in APIs related to {ml-features} and
 
 include::{es-repo-dir}/ml/df-analytics/apis/dfanalyticsresources.asciidoc[]
 include::{es-repo-dir}/ml/df-analytics/apis/evaluateresources.asciidoc[]
-include::{es-repo-dir}/ml/anomaly-detection/apis/jobcounts.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/snapshotresource.asciidoc[]
 include::{xes-repo-dir}/rest-api/security/role-mapping-resources.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/resultsresource.asciidoc[]

From 2a5e0752d53d505284ff416a511c8991f95b1456 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 11 Dec 2019 13:01:54 -0800
Subject: [PATCH 158/686] Fall back to Java 13 APIs for forbidden API checks
 when using JDK 14 (#50095)

Closes #50041
---
 .../gradle/precommit/PrecommitTasks.groovy           | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/buildSrc/src/main/groovy/org/elasticsearch/gradle/precommit/PrecommitTasks.groovy b/buildSrc/src/main/groovy/org/elasticsearch/gradle/precommit/PrecommitTasks.groovy
index 8bc47407b1754..52f98330ee50d 100644
--- a/buildSrc/src/main/groovy/org/elasticsearch/gradle/precommit/PrecommitTasks.groovy
+++ b/buildSrc/src/main/groovy/org/elasticsearch/gradle/precommit/PrecommitTasks.groovy
@@ -24,6 +24,7 @@ import de.thetaphi.forbiddenapis.gradle.ForbiddenApisPlugin
 import org.elasticsearch.gradle.ExportElasticsearchBuildResourcesTask
 import org.elasticsearch.gradle.VersionProperties
 import org.elasticsearch.gradle.info.BuildParams
+import org.gradle.api.JavaVersion
 import org.gradle.api.Project
 import org.gradle.api.artifacts.Configuration
 import org.gradle.api.plugins.JavaBasePlugin
@@ -145,16 +146,13 @@ class PrecommitTasks {
             doFirst {
                 // we need to defer this configuration since we don't know the runtime java version until execution time
                 targetCompatibility = BuildParams.runtimeJavaVersion.majorVersion
-                /*
-                TODO: Reenable once Gradle supports Java 13 or later!
                 if (BuildParams.runtimeJavaVersion > JavaVersion.VERSION_13) {
-                    project.logger.info(
-                            "Forbidden APIs does not support java version past 13. Will use the signatures from 13 for ",
-                            BuildParams.runtimeJavaVersion`
+                    project.logger.warn(
+                            "Forbidden APIs does not support Java versions past 13. Will use the signatures from 13 for {}.",
+                            BuildParams.runtimeJavaVersion
                     )
-                    targetCompatibility = JavaVersion.VERSION_13.getMajorVersion()
+                    targetCompatibility = JavaVersion.VERSION_13.majorVersion
                 }
-                */
             }
             bundledSignatures = [
                     "jdk-unsafe", "jdk-deprecated", "jdk-non-portable", "jdk-system-out"

From f32d05db250efb6d45859d84cc06af9727589fce Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Wed, 11 Dec 2019 16:02:31 -0500
Subject: [PATCH 159/686] Require JDK 13 for compilation (#50004)

We have a long history of advancing the required compiler to the newest
JDK. JDK 13 has been with us for awhile, but we were blocked from
upgrading since Gradle was not compatible with JDK 13. With the
advancement in our project to Gradle 6 which supports JDK 13, we can now
advance our minimum compiler version. This commit updates the minimum
compiler version to JDK 13.
---
 .ci/build.sh                                              | 2 +-
 .ci/java-versions.properties                              | 2 +-
 .ci/matrix-build-javas.yml                                | 2 +-
 .ci/matrix-runtime-javas.yml                              | 3 ---
 .ci/packer_cache.sh                                       | 1 +
 CONTRIBUTING.md                                           | 8 ++++----
 .../org/elasticsearch/gradle/test/DistroTestPlugin.java   | 2 +-
 buildSrc/src/main/resources/minimumCompilerVersion        | 2 +-
 8 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/.ci/build.sh b/.ci/build.sh
index 6dfc06a0912fb..b86acfd8cef1d 100755
--- a/.ci/build.sh
+++ b/.ci/build.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 
-JAVA_HOME=${JAVA_HOME:-$HOME/.java/openjdk12}
+JAVA_HOME=${JAVA_HOME:-$HOME/.java/openjdk13}
 RUNTIME_JAVA_HOME=${RUNTIME_JAVA_HOME:-$HOME/.java/openjdk11}
 
 JAVA7_HOME=$HOME/.java/java7
diff --git a/.ci/java-versions.properties b/.ci/java-versions.properties
index 1c1e813553670..f5c4978113ba3 100644
--- a/.ci/java-versions.properties
+++ b/.ci/java-versions.properties
@@ -4,7 +4,7 @@
 # build and test Elasticsearch for this branch. Valid Java versions
 # are 'java' or 'openjdk' followed by the major release number.
 
-ES_BUILD_JAVA=openjdk12
+ES_BUILD_JAVA=openjdk13
 ES_RUNTIME_JAVA=openjdk11
 GRADLE_TASK=build
 
diff --git a/.ci/matrix-build-javas.yml b/.ci/matrix-build-javas.yml
index 202fd60edea4c..49b904f2c32ac 100644
--- a/.ci/matrix-build-javas.yml
+++ b/.ci/matrix-build-javas.yml
@@ -6,4 +6,4 @@
 # or 'openjdk' followed by the major release number.
 
 ES_BUILD_JAVA:
-  - openjdk12
+  - openjdk13
diff --git a/.ci/matrix-runtime-javas.yml b/.ci/matrix-runtime-javas.yml
index 29e3c95004fdc..9e2422d950931 100644
--- a/.ci/matrix-runtime-javas.yml
+++ b/.ci/matrix-runtime-javas.yml
@@ -7,11 +7,8 @@
 
 ES_RUNTIME_JAVA:
   - java11
-  - java12
-  - openjdk12
   - openjdk13
   - openjdk14
   - zulu11
-  - zulu12
   - corretto11
   - adoptopenjdk11
diff --git a/.ci/packer_cache.sh b/.ci/packer_cache.sh
index adc4f80d4960d..759a3aae9aeb6 100755
--- a/.ci/packer_cache.sh
+++ b/.ci/packer_cache.sh
@@ -21,5 +21,6 @@ export JAVA_HOME="${HOME}"/.java/${ES_BUILD_JAVA}
 export JAVA8_HOME="${HOME}"/.java/java8
 export JAVA11_HOME="${HOME}"/.java/java11
 export JAVA12_HOME="${HOME}"/.java/openjdk12
+export JAVA13_HOME="${HOME}"/.java/openjdk13
 ./gradlew --parallel clean --scan -Porg.elasticsearch.acceptScanTOS=true -s resolveAllDependencies
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 53935ec15feb4..ed96a2449568a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -92,16 +92,16 @@ Contributing to the Elasticsearch codebase
 
 **Repository:** [https://github.com/elastic/elasticsearch](https://github.com/elastic/elasticsearch)
 
-JDK 12 is required to build Elasticsearch. You must have a JDK 12 installation
+JDK 13 is required to build Elasticsearch. You must have a JDK 13 installation
 with the environment variable `JAVA_HOME` referencing the path to Java home for
-your JDK 12 installation. By default, tests use the same runtime as `JAVA_HOME`.
+your JDK 13 installation. By default, tests use the same runtime as `JAVA_HOME`.
 However, since Elasticsearch supports JDK 11, the build supports compiling with
-JDK 12 and testing on a JDK 11 runtime; to do this, set `RUNTIME_JAVA_HOME`
+JDK 13 and testing on a JDK 11 runtime; to do this, set `RUNTIME_JAVA_HOME`
 pointing to the Java home of a JDK 11 installation. Note that this mechanism can
 be used to test against other JDKs as well, this is not only limited to JDK 11.
 
 > Note: It is also required to have `JAVA8_HOME`, `JAVA9_HOME`, `JAVA10_HOME`
-and `JAVA11_HOME` available so that the tests can pass.
+and `JAVA11_HOME`, and `JAVA12_HOME` available so that the tests can pass.
 
 > Warning: do not use `sdkman` for Java installations which do not have proper
 `jrunscript` for jdk distributions.
diff --git a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java b/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
index 45a1fc0266b65..e8294ce738b7f 100644
--- a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
+++ b/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
@@ -75,7 +75,7 @@ public class DistroTestPlugin implements Plugin<Project> {
 
     private static final String SYSTEM_JDK_VERSION = "11.0.2+9";
     private static final String SYSTEM_JDK_VENDOR = "openjdk";
-    private static final String GRADLE_JDK_VERSION = "12.0.1+12@69cfe15208a647278a19ef0990eea691";
+    private static final String GRADLE_JDK_VERSION = "13.0.1+9@cec27d702aa74d5a8630c65ae61e4305";
     private static final String GRADLE_JDK_VENDOR = "openjdk";
 
     // all distributions used by distro tests. this is temporary until tests are per distribution
diff --git a/buildSrc/src/main/resources/minimumCompilerVersion b/buildSrc/src/main/resources/minimumCompilerVersion
index 3cacc0b93c9c9..b1bd38b62a080 100644
--- a/buildSrc/src/main/resources/minimumCompilerVersion
+++ b/buildSrc/src/main/resources/minimumCompilerVersion
@@ -1 +1 @@
-12
\ No newline at end of file
+13

From 034aafd59c381ab55e1473818fe925059fbbf042 Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Wed, 11 Dec 2019 22:12:56 +0100
Subject: [PATCH 160/686] Address UUIDTests#testCompression failures. (#50093)

Those were due to codec randomization.

Closes #50048
---
 .../src/test/java/org/elasticsearch/common/UUIDTests.java  | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/common/UUIDTests.java b/server/src/test/java/org/elasticsearch/common/UUIDTests.java
index 1d23570064fe5..5f7dea14946e6 100644
--- a/server/src/test/java/org/elasticsearch/common/UUIDTests.java
+++ b/server/src/test/java/org/elasticsearch/common/UUIDTests.java
@@ -22,6 +22,7 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.apache.lucene.codecs.Codec;
 import org.apache.lucene.document.Document;
 import org.apache.lucene.document.Field.Store;
 import org.apache.lucene.document.StringField;
@@ -29,6 +30,8 @@
 import org.apache.lucene.index.IndexWriterConfig;
 import org.apache.lucene.index.SerialMergeScheduler;
 import org.apache.lucene.store.Directory;
+import org.apache.lucene.util.TestUtil;
+import org.elasticsearch.common.lucene.Lucene;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.test.ESTestCase;
@@ -116,7 +119,6 @@ public void testUUIDThreaded(UUIDGenerator uuidSource) {
         assertEquals(count*uuids, globalSet.size());
     }
 
-    @AwaitsFix(bugUrl="https://github.com/elastic/elasticsearch/issues/50048")
     public void testCompression() throws Exception {
         Logger logger = LogManager.getLogger(UUIDTests.class);
         // Low number so that the test runs quickly, but the results are more interesting with larger numbers
@@ -135,7 +137,7 @@ private static double testCompression(int numDocs, int numDocsPerSecond, int num
             random().nextBytes(macAddresses[i]);
         }
         UUIDGenerator generator = new TimeBasedUUIDGenerator() {
-            double currentTimeMillis = System.currentTimeMillis();
+            double currentTimeMillis = TestUtil.nextLong(random(), 0L, 10000000000L);
 
             @Override
             protected long currentTimeMillis() {
@@ -152,6 +154,7 @@ protected byte[] macAddress() {
         // the quality of this test
         Directory dir = newFSDirectory(createTempDir());
         IndexWriterConfig config = new IndexWriterConfig()
+                .setCodec(Codec.forName(Lucene.LATEST_CODEC))
                 .setMergeScheduler(new SerialMergeScheduler()); // for reproducibility
         IndexWriter w = new IndexWriter(dir, config);
         Document doc = new Document();

From e283e71f57ab06799805dfe61f0222291a03b674 Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Wed, 11 Dec 2019 23:53:03 +0200
Subject: [PATCH 161/686] Have COUNT DISTINCT return 0 instead of NULL for no
 documents matching. (#50037)

---
 .../sql/qa/src/main/resources/agg.csv-spec    | 23 +++++++++++++++++++
 .../search/extractor/MetricAggExtractor.java  |  4 ----
 2 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/sql/qa/src/main/resources/agg.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/agg.csv-spec
index ed1ae60b14c85..2c1e1126ee1da 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/agg.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/agg.csv-spec
@@ -657,6 +657,29 @@ SELECT COUNT(first_name)=COUNT(DISTINCT first_name) AS areEqual, COUNT(first_nam
 true           |90             |90
 ;
 
+aggCountWithNull
+schema::COUNT(NULL):l|COUNT(*):l|COUNT(DISTINCT languages):l|languages:bt
+SELECT COUNT(NULL), COUNT(*), COUNT(DISTINCT languages), languages FROM test_emp GROUP BY languages ORDER BY languages DESC;
+
+  COUNT(NULL)  |   COUNT(*)    |COUNT(DISTINCT languages)|   languages   
+---------------+---------------+-------------------------+---------------
+null           |21             |1                        |5              
+null           |18             |1                        |4              
+null           |17             |1                        |3              
+null           |19             |1                        |2              
+null           |15             |1                        |1              
+null           |10             |0                        |null          
+;
+
+aggCountZeroDocuments
+schema::COUNT(NULL):l|COUNT(*):l|COUNT(DISTINCT languages):l
+SELECT COUNT(NULL), COUNT(*), COUNT(DISTINCT languages) FROM test_emp WHERE languages > 100;
+
+  COUNT(NULL)  |   COUNT(*)    |COUNT(DISTINCT languages)
+---------------+---------------+-------------------------
+null           |0              |0
+;
+
 aggCountAllEquality
 schema::areEqual:b|afn:l
 SELECT COUNT(first_name)=COUNT(ALL first_name) AS areEqual, COUNT(ALL first_name) afn FROM test_emp;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractor.java
index 07309c3582200..007c7a26c4966 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractor.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.search.aggregations.bucket.filter.InternalFilter;
 import org.elasticsearch.search.aggregations.matrix.stats.InternalMatrixStats;
 import org.elasticsearch.search.aggregations.metrics.InternalAvg;
-import org.elasticsearch.search.aggregations.metrics.InternalCardinality;
 import org.elasticsearch.search.aggregations.metrics.InternalMax;
 import org.elasticsearch.search.aggregations.metrics.InternalMin;
 import org.elasticsearch.search.aggregations.metrics.InternalNumericMetricsAggregation;
@@ -149,9 +148,6 @@ private static boolean containsValues(InternalAggregation agg) {
         if (agg instanceof InternalAvg) {
             return hasValue((InternalAvg) agg);
         }
-        if (agg instanceof InternalCardinality) {
-            return hasValue((InternalCardinality) agg);
-        }
         if (agg instanceof InternalSum) {
             return hasValue((InternalSum) agg);
         }

From ba16c070ab77fa893aeffd92fae5e9e0ee3f71c5 Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Wed, 11 Dec 2019 16:24:31 -0700
Subject: [PATCH 162/686] Update TcpHeader version constant for backport
 (#50086)

In 7.6 we are adding a int indicating how long the Elasticsearch
variable header is. This commit modifies the version constant indicating
when this int is supported to reflect the fact that this int is
available on 7.6.
---
 .../java/org/elasticsearch/transport/TcpHeader.java  |  5 ++---
 .../transport/AbstractSimpleTransportTestCase.java   | 12 ++++++------
 2 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/transport/TcpHeader.java b/server/src/main/java/org/elasticsearch/transport/TcpHeader.java
index dfa79d240e470..10feeec5ec550 100644
--- a/server/src/main/java/org/elasticsearch/transport/TcpHeader.java
+++ b/server/src/main/java/org/elasticsearch/transport/TcpHeader.java
@@ -25,9 +25,8 @@
 import java.io.IOException;
 
 public class TcpHeader {
-
-    // TODO: Change to 7.6 after backport
-    public static final Version VERSION_WITH_HEADER_SIZE = Version.V_8_0_0;
+    
+    public static final Version VERSION_WITH_HEADER_SIZE = Version.V_7_6_0;
 
     public static final int MARKER_BYTES_SIZE = 2;
 
diff --git a/test/framework/src/main/java/org/elasticsearch/transport/AbstractSimpleTransportTestCase.java b/test/framework/src/main/java/org/elasticsearch/transport/AbstractSimpleTransportTestCase.java
index 4dddb0af9b4c4..109a725672098 100644
--- a/test/framework/src/main/java/org/elasticsearch/transport/AbstractSimpleTransportTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/transport/AbstractSimpleTransportTestCase.java
@@ -2368,15 +2368,15 @@ public String executor() {
                 assertEquals(1, transportStats.getRxCount());
                 assertEquals(2, transportStats.getTxCount());
                 assertEquals(138, transportStats.getRxSize().getBytes());
-                assertEquals(107, transportStats.getTxSize().getBytes());
+                assertEquals(111, transportStats.getTxSize().getBytes());
             });
             sendResponseLatch.countDown();
             responseLatch.await();
             stats = serviceC.transport.getStats(); // response has been received
             assertEquals(2, stats.getRxCount());
             assertEquals(2, stats.getTxCount());
-            assertEquals(159, stats.getRxSize().getBytes());
-            assertEquals(107, stats.getTxSize().getBytes());
+            assertEquals(163, stats.getRxSize().getBytes());
+            assertEquals(111, stats.getTxSize().getBytes());
         } finally {
             serviceC.close();
         }
@@ -2483,7 +2483,7 @@ public String executor() {
                 assertEquals(1, transportStats.getRxCount());
                 assertEquals(2, transportStats.getTxCount());
                 assertEquals(138, transportStats.getRxSize().getBytes());
-                assertEquals(107, transportStats.getTxSize().getBytes());
+                assertEquals(111, transportStats.getTxSize().getBytes());
             });
             sendResponseLatch.countDown();
             responseLatch.await();
@@ -2497,8 +2497,8 @@ public String executor() {
             String failedMessage = "Unexpected read bytes size. The transport exception that was received=" + exception;
             // 49 bytes are the non-exception message bytes that have been received. It should include the initial
             // handshake message and the header, version, etc bytes in the exception message.
-            assertEquals(failedMessage, 162 + streamOutput.bytes().length(), stats.getRxSize().getBytes());
-            assertEquals(107, stats.getTxSize().getBytes());
+            assertEquals(failedMessage, 166 + streamOutput.bytes().length(), stats.getRxSize().getBytes());
+            assertEquals(111, stats.getTxSize().getBytes());
         } finally {
             serviceC.close();
         }

From c440f782e385caf68be6d1768d67be51e0946609 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 11 Dec 2019 15:39:06 -0800
Subject: [PATCH 163/686] Allow individual projects to override test heapdump
 setting (#50096)

This commit goes from using a JvmArgumentProvider to using the normal
Test task APIs for passing the `HeapDumpOnOutOfMemoryError` JVM
argument. This makes it simpler for subprojects, such as lang-painless
to override this setting if necessary.

Closes #49117
---
 .../main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy  | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy b/buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy
index 05ea77720e123..2f7c3af5da3d7 100644
--- a/buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy
+++ b/buildSrc/src/main/groovy/org/elasticsearch/gradle/BuildPlugin.groovy
@@ -672,9 +672,10 @@ class BuildPlugin implements Plugin<Project> {
 
                 test.jvmArgs "-Xmx${System.getProperty('tests.heap.size', '512m')}",
                         "-Xms${System.getProperty('tests.heap.size', '512m')}",
-                        '--illegal-access=warn'
+                        '--illegal-access=warn',
+                        '-XX:+HeapDumpOnOutOfMemoryError'
 
-                test.jvmArgumentProviders.add({ ['-XX:+HeapDumpOnOutOfMemoryError', "-XX:HeapDumpPath=$heapdumpDir"] } as CommandLineArgumentProvider)
+                test.jvmArgumentProviders.add({ ["-XX:HeapDumpPath=$heapdumpDir"] } as CommandLineArgumentProvider)
 
                 if (System.getProperty('tests.jvm.argline')) {
                     test.jvmArgs System.getProperty('tests.jvm.argline').split(" ")

From 235f336fffc379282994f7749aea0d72fe7a886b Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Wed, 11 Dec 2019 16:08:47 -0800
Subject: [PATCH 164/686] Simplify running tools in packaging tests (#49665)

Running tools requires a shell. This should be the shell setup by the
base packaging tests, but currently tests must pass in their own shell.
This commit begins to make running tools easier by eliminating the shell
argument, instead keeping the shell as part of the Installation (which
can eventually be passed through from the test itself on installation).
The variable names for each tool are also simplified.
---
 .../packaging/test/ArchiveTests.java          | 37 ++++++++--------
 .../packaging/test/DebPreservationTests.java  |  4 +-
 .../packaging/test/DockerTests.java           | 16 +++----
 .../packaging/test/PackageTests.java          |  3 +-
 .../packaging/test/PackagingTestCase.java     | 42 +++++++++----------
 .../packaging/test/PasswordToolsTests.java    |  6 +--
 .../packaging/test/RpmPreservationTests.java  | 10 ++---
 .../packaging/test/SqlCliTests.java           |  2 +-
 .../packaging/test/WindowsServiceTests.java   |  2 +-
 .../packaging/util/Archives.java              | 10 ++---
 .../elasticsearch/packaging/util/Docker.java  |  2 +-
 .../packaging/util/Installation.java          | 37 +++++++++-------
 .../packaging/util/Packages.java              |  5 +--
 .../elasticsearch/packaging/util/Shell.java   |  9 ++++
 14 files changed, 95 insertions(+), 90 deletions(-)

diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/ArchiveTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/ArchiveTests.java
index d427124d7fecd..9691636f5ccda 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/ArchiveTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/ArchiveTests.java
@@ -25,7 +25,6 @@
 import org.elasticsearch.packaging.util.Installation;
 import org.elasticsearch.packaging.util.Platforms;
 import org.elasticsearch.packaging.util.ServerUtils;
-import org.elasticsearch.packaging.util.Shell;
 import org.elasticsearch.packaging.util.Shell.Result;
 import org.junit.BeforeClass;
 
@@ -63,13 +62,13 @@ public static void filterDistros() {
     }
 
     public void test10Install() throws Exception {
-        installation = installArchive(distribution());
+        installation = installArchive(sh, distribution());
         verifyArchiveInstallation(installation, distribution());
     }
 
     public void test20PluginsListWithNoPlugins() throws Exception {
         final Installation.Executables bin = installation.executables();
-        final Result r = bin.elasticsearchPlugin.run(sh, "list");
+        final Result r = bin.pluginTool.run("list");
 
         assertThat(r.stdout, isEmptyString());
     }
@@ -109,26 +108,26 @@ public void test31BadJavaHome() throws Exception {
     public void test40CreateKeystoreManually() throws Exception {
         final Installation.Executables bin = installation.executables();
 
-        Platforms.onLinux(() -> sh.run("sudo -u " + ARCHIVE_OWNER + " " + bin.elasticsearchKeystore + " create"));
+        Platforms.onLinux(() -> sh.run("sudo -u " + ARCHIVE_OWNER + " " + bin.keystoreTool + " create"));
 
         // this is a hack around the fact that we can't run a command in the same session as the same user but not as administrator.
         // the keystore ends up being owned by the Administrators group, so we manually set it to be owned by the vagrant user here.
         // from the server's perspective the permissions aren't really different, this is just to reflect what we'd expect in the tests.
         // when we run these commands as a role user we won't have to do this
         Platforms.onWindows(() -> {
-            sh.run(bin.elasticsearchKeystore + " create");
+            sh.run(bin.keystoreTool + " create");
             sh.chown(installation.config("elasticsearch.keystore"));
         });
 
         assertThat(installation.config("elasticsearch.keystore"), file(File, ARCHIVE_OWNER, ARCHIVE_OWNER, p660));
 
         Platforms.onLinux(() -> {
-            final Result r = sh.run("sudo -u " + ARCHIVE_OWNER + " " + bin.elasticsearchKeystore + " list");
+            final Result r = sh.run("sudo -u " + ARCHIVE_OWNER + " " + bin.keystoreTool + " list");
             assertThat(r.stdout, containsString("keystore.seed"));
         });
 
         Platforms.onWindows(() -> {
-            final Result r = sh.run(bin.elasticsearchKeystore + " list");
+            final Result r = sh.run(bin.keystoreTool + " list");
             assertThat(r.stdout, containsString("keystore.seed"));
         });
     }
@@ -202,7 +201,6 @@ public void test52BundledJdkRemoved() throws Exception {
 
     public void test53JavaHomeWithSpecialCharacters() throws Exception {
         Platforms.onWindows(() -> {
-            final Shell sh = new Shell();
             String javaPath = "C:\\Program Files (x86)\\java";
             try {
                 // once windows 2012 is no longer supported and powershell 5.0 is always available we can change this command
@@ -228,7 +226,6 @@ public void test53JavaHomeWithSpecialCharacters() throws Exception {
         });
 
         Platforms.onLinux(() -> {
-            final Shell sh = newShell();
             // Create temporary directory with a space and link to real java home
             String testJavaHome = Paths.get("/tmp", "java home").toString();
             try {
@@ -256,12 +253,12 @@ public void test60AutoCreateKeystore() throws Exception {
 
         final Installation.Executables bin = installation.executables();
         Platforms.onLinux(() -> {
-            final Result result = sh.run("sudo -u " + ARCHIVE_OWNER + " " + bin.elasticsearchKeystore + " list");
+            final Result result = sh.run("sudo -u " + ARCHIVE_OWNER + " " + bin.keystoreTool + " list");
             assertThat(result.stdout, containsString("keystore.seed"));
         });
 
         Platforms.onWindows(() -> {
-            final Result result = sh.run(bin.elasticsearchKeystore + " list");
+            final Result result = sh.run(bin.keystoreTool + " list");
             assertThat(result.stdout, containsString("keystore.seed"));
         });
     }
@@ -339,11 +336,11 @@ public void test90SecurityCliPackaging() throws Exception {
         if (distribution().isDefault()) {
             assertTrue(Files.exists(installation.lib.resolve("tools").resolve("security-cli")));
             final Platforms.PlatformAction action = () -> {
-                Result result = sh.run(bin.elasticsearchCertutil + " --help");
+                Result result = sh.run(bin.certutilTool + " --help");
                 assertThat(result.stdout, containsString("Simplifies certificate creation for use with the Elastic Stack"));
 
                 // Ensure that the exit code from the java command is passed back up through the shell script
-                result = sh.runIgnoreExitCode(bin.elasticsearchCertutil + " invalid-command");
+                result = sh.runIgnoreExitCode(bin.certutilTool + " invalid-command");
                 assertThat(result.exitCode, is(not(0)));
                 assertThat(result.stderr, containsString("Unknown command [invalid-command]"));
             };
@@ -358,7 +355,7 @@ public void test91ElasticsearchShardCliPackaging() throws Exception {
         final Installation.Executables bin = installation.executables();
 
         Platforms.PlatformAction action = () -> {
-            final Result result = sh.run(bin.elasticsearchShard + " -h");
+            final Result result = sh.run(bin.shardTool + " -h");
             assertThat(result.stdout, containsString("A CLI tool to remove corrupted parts of unrecoverable shards"));
         };
 
@@ -373,7 +370,7 @@ public void test92ElasticsearchNodeCliPackaging() throws Exception {
         final Installation.Executables bin = installation.executables();
 
         Platforms.PlatformAction action = () -> {
-            final Result result = sh.run(bin.elasticsearchNode + " -h");
+            final Result result = sh.run(bin.nodeTool + " -h");
             assertThat(result.stdout,
                     containsString("A CLI tool to do unsafe cluster and index manipulations on current node"));
         };
@@ -394,7 +391,7 @@ public void test93ElasticsearchNodeCustomDataPathAndNotEsHomeWorkDir() throws Ex
         startElasticsearch();
         Archives.stopElasticsearch(installation);
 
-        Result result = sh.run("echo y | " + installation.executables().elasticsearchNode + " unsafe-bootstrap");
+        Result result = sh.run("echo y | " + installation.executables().nodeTool + " unsafe-bootstrap");
         assertThat(result.stdout, containsString("Master node was successfully bootstrapped"));
     }
 
@@ -404,16 +401,16 @@ public void test94ElasticsearchNodeExecuteCliNotEsHomeWorkDir() throws Exception
         sh.setWorkingDirectory(getTempDir());
 
         Platforms.PlatformAction action = () -> {
-            Result result = sh.run(bin.elasticsearchCertutil+ " -h");
+            Result result = sh.run(bin.certutilTool + " -h");
             assertThat(result.stdout,
                 containsString("Simplifies certificate creation for use with the Elastic Stack"));
-            result = sh.run(bin.elasticsearchSyskeygen+ " -h");
+            result = sh.run(bin.syskeygenTool + " -h");
             assertThat(result.stdout,
                 containsString("system key tool"));
-            result = sh.run(bin.elasticsearchSetupPasswords+ " -h");
+            result = sh.run(bin.setupPasswordsTool + " -h");
             assertThat(result.stdout,
                 containsString("Sets the passwords for reserved users"));
-            result = sh.run(bin.elasticsearchUsers+ " -h");
+            result = sh.run(bin.usersTool + " -h");
             assertThat(result.stdout,
                 containsString("Manages elasticsearch file users"));
         };
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/DebPreservationTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/DebPreservationTests.java
index ea4f5565a98a8..4ff08ad47acf6 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/DebPreservationTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/DebPreservationTests.java
@@ -47,9 +47,9 @@ public static void filterDistros() {
 
     public void test10Install() throws Exception {
         assertRemoved(distribution());
-        installation = installPackage(distribution());
+        installation = installPackage(sh, distribution());
         assertInstalled(distribution());
-        verifyPackageInstallation(installation, distribution(), newShell());
+        verifyPackageInstallation(installation, distribution(), sh);
     }
 
     public void test20Remove() throws Exception {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
index 163199d833ae1..c8575902721c0 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
@@ -130,7 +130,7 @@ public void test011PresenceOfXpack() throws Exception {
      */
     public void test020PluginsListWithNoPlugins() {
         final Installation.Executables bin = installation.executables();
-        final Result r = sh.run(bin.elasticsearchPlugin + " list");
+        final Result r = sh.run(bin.pluginTool + " list");
 
         assertThat("Expected no plugins to be listed", r.stdout, emptyString());
     }
@@ -148,9 +148,9 @@ public void test040CreateKeystoreManually() throws InterruptedException {
         // Move the auto-created one out of the way, or else the CLI prompts asks us to confirm
         sh.run("mv " + keystorePath + " " + keystorePath + ".bak");
 
-        sh.run(bin.elasticsearchKeystore + " create");
+        sh.run(bin.keystoreTool + " create");
 
-        final Result r = sh.run(bin.elasticsearchKeystore + " list");
+        final Result r = sh.run(bin.keystoreTool + " list");
         assertThat(r.stdout, containsString("keystore.seed"));
     }
 
@@ -165,7 +165,7 @@ public void test041AutoCreateKeystore() throws Exception {
         assertPermissionsAndOwnership(keystorePath, p660);
 
         final Installation.Executables bin = installation.executables();
-        final Result result = sh.run(bin.elasticsearchKeystore + " list");
+        final Result result = sh.run(bin.keystoreTool + " list");
         assertThat(result.stdout, containsString("keystore.seed"));
     }
 
@@ -402,11 +402,11 @@ public void test090SecurityCliPackaging() {
         if (distribution().isDefault()) {
             assertTrue(existsInContainer(securityCli));
 
-            Result result = sh.run(bin.elasticsearchCertutil + " --help");
+            Result result = sh.run(bin.certutilTool + " --help");
             assertThat(result.stdout, containsString("Simplifies certificate creation for use with the Elastic Stack"));
 
             // Ensure that the exit code from the java command is passed back up through the shell script
-            result = sh.runIgnoreExitCode(bin.elasticsearchCertutil + " invalid-command");
+            result = sh.runIgnoreExitCode(bin.certutilTool + " invalid-command");
             assertThat(result.isSuccess(), is(false));
             assertThat(result.stdout, containsString("Unknown command [invalid-command]"));
         } else {
@@ -420,7 +420,7 @@ public void test090SecurityCliPackaging() {
     public void test091ElasticsearchShardCliPackaging() {
         final Installation.Executables bin = installation.executables();
 
-        final Result result = sh.run(bin.elasticsearchShard + " -h");
+        final Result result = sh.run(bin.shardTool + " -h");
         assertThat(result.stdout, containsString("A CLI tool to remove corrupted parts of unrecoverable shards"));
     }
 
@@ -430,7 +430,7 @@ public void test091ElasticsearchShardCliPackaging() {
     public void test092ElasticsearchNodeCliPackaging() {
         final Installation.Executables bin = installation.executables();
 
-        final Result result = sh.run(bin.elasticsearchNode + " -h");
+        final Result result = sh.run(bin.nodeTool + " -h");
         assertThat(
             "Failed to find expected message about the elasticsearch-node CLI tool",
             result.stdout,
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackageTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackageTests.java
index c992b02b1c522..b53878459ef6d 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackageTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackageTests.java
@@ -72,7 +72,7 @@ public static void filterDistros() {
 
     public void test10InstallPackage() throws Exception {
         assertRemoved(distribution());
-        installation = installPackage(distribution());
+        installation = installPackage(sh, distribution());
         assertInstalled(distribution());
         verifyPackageInstallation(installation, distribution(), sh);
     }
@@ -302,7 +302,6 @@ public void test82SystemdMask() throws Exception {
             assumeTrue(isSystemd());
 
             sh.run("systemctl mask systemd-sysctl.service");
-
             install();
 
             sh.run("systemctl unmask systemd-sysctl.service");
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
index f797d8d49684a..da3f55daae035 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
@@ -37,7 +37,6 @@
 import org.junit.Assert;
 import org.junit.Before;
 import org.junit.BeforeClass;
-import org.junit.ClassRule;
 import org.junit.Rule;
 import org.junit.rules.TestName;
 import org.junit.rules.TestWatcher;
@@ -89,8 +88,8 @@ public abstract class PackagingTestCase extends Assert {
 
     private static boolean failed;
 
-    @ClassRule
-    public static final TestWatcher testFailureRule = new TestWatcher() {
+    @Rule
+    public final TestWatcher testFailureRule = new TestWatcher() {
         @Override
         protected void failed(Throwable e, Description description) {
             failed = true;
@@ -98,7 +97,7 @@ protected void failed(Throwable e, Description description) {
     };
 
     // a shell to run system commands with
-    protected Shell sh;
+    protected static Shell sh;
 
     @Rule
     public final TestName testNameRule = new TestName();
@@ -114,11 +113,24 @@ public static void cleanup() throws Exception {
         cleanEverything();
     }
 
+    @BeforeClass
+    public static void createShell() throws Exception {
+        sh = new Shell();
+    }
+
     @Before
     public void setup() throws Exception {
         assumeFalse(failed); // skip rest of tests once one fails
 
-        sh = newShell();
+        sh.reset();
+        if (distribution().hasJdk == false) {
+            Platforms.onLinux(() -> {
+                sh.getEnv().put("JAVA_HOME", systemJavaHome);
+            });
+            Platforms.onWindows(() -> {
+                sh.getEnv().put("JAVA_HOME", systemJavaHome);
+            });
+        }
     }
 
     /** The {@link Distribution} that should be tested in this case */
@@ -130,13 +142,13 @@ protected static void install() throws Exception {
         switch (distribution.packaging) {
             case TAR:
             case ZIP:
-                installation = Archives.installArchive(distribution);
+                installation = Archives.installArchive(sh, distribution);
                 Archives.verifyArchiveInstallation(installation, distribution);
                 break;
             case DEB:
             case RPM:
-                installation = Packages.installPackage(distribution);
-                Packages.verifyPackageInstallation(installation, distribution, newShell());
+                installation = Packages.installPackage(sh, distribution);
+                Packages.verifyPackageInstallation(installation, distribution, sh);
                 break;
             case DOCKER:
                 installation = Docker.runContainer(distribution);
@@ -176,19 +188,6 @@ protected void assertWhileRunning(Platforms.PlatformAction assertions) throws Ex
         stopElasticsearch();
     }
 
-    protected static Shell newShell() throws Exception {
-        Shell sh = new Shell();
-        if (distribution().hasJdk == false) {
-            Platforms.onLinux(() -> {
-                sh.getEnv().put("JAVA_HOME", systemJavaHome);
-            });
-            Platforms.onWindows(() -> {
-                sh.getEnv().put("JAVA_HOME", systemJavaHome);
-            });
-        }
-        return sh;
-    }
-
     /**
      * Run the command to start Elasticsearch, but don't wait or test for success.
      * This method is useful for testing failure conditions in startup. To await success,
@@ -290,7 +289,6 @@ public void assertElasticsearchFailure(Shell.Result result, String expectedMessa
 
             // Otherwise, error should be on shell stderr
             assertThat(result.stderr, containsString(expectedMessage));
-
         }
     }
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/PasswordToolsTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/PasswordToolsTests.java
index 9082b19f0bd49..b08b3bfe52987 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/PasswordToolsTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/PasswordToolsTests.java
@@ -59,7 +59,7 @@ public void test010Install() throws Exception {
 
     public void test20GeneratePasswords() throws Exception {
         assertWhileRunning(() -> {
-            Shell.Result result = installation.executables().elasticsearchSetupPasswords.run(sh, "auto --batch", null);
+            Shell.Result result = installation.executables().setupPasswordsTool.run("auto --batch", null);
             Map<String, String> userpasses = parseUsersAndPasswords(result.stdout);
             for (Map.Entry<String, String> userpass : userpasses.entrySet()) {
                 String response = ServerUtils.makeRequest(Request.Get("http://localhost:9200"), userpass.getKey(), userpass.getValue());
@@ -106,7 +106,7 @@ public void test30AddBootstrapPassword() throws Exception {
             });
         }
 
-        installation.executables().elasticsearchKeystore.run(sh, "add --stdin bootstrap.password", BOOTSTRAP_PASSWORD);
+        installation.executables().keystoreTool.run("add --stdin bootstrap.password", BOOTSTRAP_PASSWORD);
 
         assertWhileRunning(() -> {
             String response = ServerUtils.makeRequest(
@@ -119,7 +119,7 @@ public void test30AddBootstrapPassword() throws Exception {
     public void test40GeneratePasswordsBootstrapAlreadySet() throws Exception {
         assertWhileRunning(() -> {
 
-            Shell.Result result = installation.executables().elasticsearchSetupPasswords.run(sh, "auto --batch", null);
+            Shell.Result result = installation.executables().setupPasswordsTool.run("auto --batch", null);
             Map<String, String> userpasses = parseUsersAndPasswords(result.stdout);
             assertThat(userpasses, hasKey("elastic"));
             for (Map.Entry<String, String> userpass : userpasses.entrySet()) {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/RpmPreservationTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/RpmPreservationTests.java
index 0509b1d244b1a..4448e02bd0692 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/RpmPreservationTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/RpmPreservationTests.java
@@ -50,9 +50,9 @@ public static void filterDistros() {
 
     public void test10Install() throws Exception {
         assertRemoved(distribution());
-        installation = installPackage(distribution());
+        installation = installPackage(sh, distribution());
         assertInstalled(distribution());
-        verifyPackageInstallation(installation, distribution(), newShell());
+        verifyPackageInstallation(installation, distribution(), sh);
     }
 
     public void test20Remove() throws Exception {
@@ -71,11 +71,11 @@ public void test20Remove() throws Exception {
     public void test30PreserveConfig() throws Exception {
         final Shell sh = new Shell();
 
-        installation = installPackage(distribution());
+        installation = installPackage(sh, distribution());
         assertInstalled(distribution());
-        verifyPackageInstallation(installation, distribution(), newShell());
+        verifyPackageInstallation(installation, distribution(), sh);
 
-        sh.run("echo foobar | " + installation.executables().elasticsearchKeystore + " add --stdin foo.bar");
+        sh.run("echo foobar | " + installation.executables().keystoreTool + " add --stdin foo.bar");
         Stream.of(
             "elasticsearch.yml",
             "jvm.options",
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/SqlCliTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/SqlCliTests.java
index 62a00aab59d22..afcc7dd0b0919 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/SqlCliTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/SqlCliTests.java
@@ -38,7 +38,7 @@ public void test010Install() throws Exception {
     }
 
     public void test020Help() throws Exception {
-        Shell.Result result = installation.executables().elasticsearchSqlCli.run(sh, "--help");
+        Shell.Result result = installation.executables().sqlCli.run("--help");
         assertThat(result.stdout, containsString("Elasticsearch SQL CLI"));
     }
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/WindowsServiceTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/WindowsServiceTests.java
index 506a7313cb17c..5f4fac5f5352c 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/WindowsServiceTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/WindowsServiceTests.java
@@ -96,7 +96,7 @@ private void assertExit(Result result, String script, int exitCode) {
     }
 
     public void test10InstallArchive() throws Exception {
-        installation = installArchive(distribution());
+        installation = installArchive(sh, distribution());
         verifyArchiveInstallation(installation, distribution());
         serviceScript = installation.bin("elasticsearch-service.bat").toString();
     }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
index 1ec62d20a050d..28234bd118701 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
@@ -67,13 +67,11 @@ public class Archives {
      *  errors to the console if they occur before the logging framework is initialized. */
     public static final String ES_STARTUP_SLEEP_TIME_SECONDS = "10";
 
-    public static Installation installArchive(Distribution distribution) throws Exception {
-        return installArchive(distribution, getDefaultArchiveInstallPath(), getCurrentVersion());
+    public static Installation installArchive(Shell sh, Distribution distribution) throws Exception {
+        return installArchive(sh, distribution, getDefaultArchiveInstallPath(), getCurrentVersion());
     }
 
-    public static Installation installArchive(Distribution distribution, Path fullInstallPath, String version) throws Exception {
-        final Shell sh = new Shell();
-
+    public static Installation installArchive(Shell sh, Distribution distribution, Path fullInstallPath, String version) throws Exception {
         final Path distributionFile = getDistributionFile(distribution);
         final Path baseInstallPath = fullInstallPath.getParent();
         final Path extractedPath = baseInstallPath.resolve("elasticsearch-" + version);
@@ -115,7 +113,7 @@ public static Installation installArchive(Distribution distribution, Path fullIn
 
         sh.chown(fullInstallPath);
 
-        return Installation.ofArchive(distribution, fullInstallPath);
+        return Installation.ofArchive(sh, distribution, fullInstallPath);
     }
 
     private static void setupArchiveUsersLinux(Path installPath) {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
index 91b010957011b..245806363c6ab 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
@@ -105,7 +105,7 @@ public static Installation runContainer(Distribution distribution, Map<Path, Pat
 
         waitForElasticsearchToStart();
 
-        return Installation.ofContainer(distribution);
+        return Installation.ofContainer(dockerShell, distribution);
     }
 
     /**
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
index 1f3da0b12663f..a237da3ea1962 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
@@ -32,6 +32,7 @@ public class Installation {
         ? System.getenv("username")
         : "elasticsearch";
 
+    private final Shell sh;
     public final Distribution distribution;
     public final Path home;
     public final Path bin; // this isn't a first-class installation feature but we include it for convenience
@@ -45,8 +46,9 @@ public class Installation {
     public final Path pidDir;
     public final Path envFile;
 
-    private Installation(Distribution distribution, Path home, Path config, Path data, Path logs,
+    private Installation(Shell sh, Distribution distribution, Path home, Path config, Path data, Path logs,
                          Path plugins, Path modules, Path pidDir, Path envFile) {
+        this.sh = sh;
         this.distribution = distribution;
         this.home = home;
         this.bin = home.resolve("bin");
@@ -61,8 +63,9 @@ private Installation(Distribution distribution, Path home, Path config, Path dat
         this.envFile = envFile;
     }
 
-    public static Installation ofArchive(Distribution distribution, Path home) {
+    public static Installation ofArchive(Shell sh, Distribution distribution, Path home) {
         return new Installation(
+            sh,
             distribution,
             home,
             home.resolve("config"),
@@ -75,13 +78,14 @@ public static Installation ofArchive(Distribution distribution, Path home) {
         );
     }
 
-    public static Installation ofPackage(Distribution distribution) {
+    public static Installation ofPackage(Shell sh, Distribution distribution) {
 
         final Path envFile = (distribution.packaging == Distribution.Packaging.RPM)
             ? Paths.get("/etc/sysconfig/elasticsearch")
             : Paths.get("/etc/default/elasticsearch");
 
         return new Installation(
+            sh,
             distribution,
             Paths.get("/usr/share/elasticsearch"),
             Paths.get("/etc/elasticsearch"),
@@ -94,9 +98,10 @@ public static Installation ofPackage(Distribution distribution) {
         );
     }
 
-    public static Installation ofContainer(Distribution distribution) {
+    public static Installation ofContainer(Shell sh, Distribution distribution) {
         String root = "/usr/share/elasticsearch";
         return new Installation(
+            sh,
             distribution,
             Paths.get(root),
             Paths.get(root + "/config"),
@@ -136,11 +141,11 @@ public String toString() {
             return path.toString();
         }
 
-        public Shell.Result run(Shell sh, String args) {
-            return run(sh, args, null);
+        public Shell.Result run(String args) {
+            return run(args, null);
         }
 
-        public Shell.Result run(Shell sh, String args, String input) {
+        public Shell.Result run(String args, String input) {
             String command = path + " " + args;
             if (distribution.isArchive() && distribution.platform != Distribution.Platform.WINDOWS) {
                 command = "sudo -E -u " + ARCHIVE_OWNER + " " + command;
@@ -155,14 +160,14 @@ public Shell.Result run(Shell sh, String args, String input) {
     public class Executables {
 
         public final Executable elasticsearch = new Executable("elasticsearch");
-        public final Executable elasticsearchPlugin = new Executable("elasticsearch-plugin");
-        public final Executable elasticsearchKeystore = new Executable("elasticsearch-keystore");
-        public final Executable elasticsearchCertutil = new Executable("elasticsearch-certutil");
-        public final Executable elasticsearchShard = new Executable("elasticsearch-shard");
-        public final Executable elasticsearchNode = new Executable("elasticsearch-node");
-        public final Executable elasticsearchSetupPasswords = new Executable("elasticsearch-setup-passwords");
-        public final Executable elasticsearchSqlCli= new Executable("elasticsearch-sql-cli");
-        public final Executable elasticsearchSyskeygen = new Executable("elasticsearch-syskeygen");
-        public final Executable elasticsearchUsers = new Executable("elasticsearch-users");
+        public final Executable pluginTool = new Executable("elasticsearch-plugin");
+        public final Executable keystoreTool = new Executable("elasticsearch-keystore");
+        public final Executable certutilTool = new Executable("elasticsearch-certutil");
+        public final Executable shardTool = new Executable("elasticsearch-shard");
+        public final Executable nodeTool = new Executable("elasticsearch-node");
+        public final Executable setupPasswordsTool = new Executable("elasticsearch-setup-passwords");
+        public final Executable sqlCli = new Executable("elasticsearch-sql-cli");
+        public final Executable syskeygenTool = new Executable("elasticsearch-syskeygen");
+        public final Executable usersTool = new Executable("elasticsearch-users");
     }
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
index a96c7d1b6707a..19521e6b919d0 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
@@ -95,8 +95,7 @@ public static Result packageStatus(Distribution distribution) {
         return result;
     }
 
-    public static Installation installPackage(Distribution distribution) throws IOException {
-        Shell sh = new Shell();
+    public static Installation installPackage(Shell sh, Distribution distribution) throws IOException {
         String systemJavaHome = sh.run("echo $SYSTEM_JAVA_HOME").stdout.trim();
         if (distribution.hasJdk == false) {
             sh.getEnv().put("JAVA_HOME", systemJavaHome);
@@ -106,7 +105,7 @@ public static Installation installPackage(Distribution distribution) throws IOEx
             throw new RuntimeException("Installing distribution " + distribution + " failed: " + result);
         }
 
-        Installation installation = Installation.ofPackage(distribution);
+        Installation installation = Installation.ofPackage(sh, distribution);
 
         if (distribution.hasJdk == false) {
             Files.write(installation.envFile, ("JAVA_HOME=" + systemJavaHome + "\n").getBytes(StandardCharsets.UTF_8),
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
index bbcbcd1b1d498..e0fae3d095578 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
@@ -53,6 +53,14 @@ public Shell() {
         this.workingDirectory = null;
     }
 
+    /**
+     * Reset the shell to its newly created state.
+     */
+    public void reset() {
+        env.clear();
+        workingDirectory = null;
+    }
+
     public Map<String, String> getEnv() {
         return env;
     }
@@ -112,6 +120,7 @@ private static String[] powershellCommand(String script) {
     }
 
     private Result runScript(String[] command) {
+        logger.warn("Running command with env: " + env);
         Result result = runScriptIgnoreExitCode(command);
         if (result.isSuccess() == false) {
             throw new RuntimeException("Command was not successful: [" + String.join(" ", command) + "]\n   result: " + result.toString());

From 8513af80c2d237d71d641155990492bbd313e76f Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Thu, 12 Dec 2019 11:57:32 +1100
Subject: [PATCH 165/686] Remove reserved roles for code search (#50068)

The "code_user" and "code_admin" reserved roles existed to support
code search which is no longer included in Kibana.

The "kibana_system" role included privileges to read/write from the
code search indices, but no longer needs that access.

Resolves: #49842
---
 .../SecurityDocumentationIT.java              |  4 +-
 .../authz/store/ReservedRolesStore.java       | 13 ----
 .../authz/store/ReservedRolesStoreTests.java  | 60 +------------------
 3 files changed, 4 insertions(+), 73 deletions(-)

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/SecurityDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/SecurityDocumentationIT.java
index 372be2c2d08a5..ec2043d3da296 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/SecurityDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/SecurityDocumentationIT.java
@@ -694,8 +694,8 @@ public void testGetRoles() throws Exception {
 
             List<Role> roles = response.getRoles();
             assertNotNull(response);
-            // 29 system roles plus the three we created
-            assertThat(roles.size(), equalTo(33));
+            // 28 system roles plus the three we created
+            assertThat(roles.size(), equalTo(28 + 3));
         }
 
         {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
index 7e06bbf64d999..d9db50678c160 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
@@ -122,9 +122,6 @@ private static Map<String, RoleDescriptor> initializeReservedRoles() {
                                         .indices(".monitoring-*").privileges("read", "read_cross_cluster").build(),
                                 RoleDescriptor.IndicesPrivileges.builder()
                                         .indices(".management-beats").privileges("create_index", "read", "write").build(),
-                                // .code_internal-* is for Code's internal worker queue index creation.
-                                RoleDescriptor.IndicesPrivileges.builder()
-                                        .indices(".code-*", ".code_internal-*").privileges("all").build(),
                                 // .apm-* is for APM's agent configuration index creation
                                 RoleDescriptor.IndicesPrivileges.builder()
                                         .indices(".apm-agent-configuration").privileges("all").build(),
@@ -253,16 +250,6 @@ private static Map<String, RoleDescriptor> initializeReservedRoles() {
                         null, null, MetadataUtils.DEFAULT_RESERVED_METADATA))
                 .put("rollup_admin", new RoleDescriptor("rollup_admin", new String[] { "manage_rollup" },
                         null, null, MetadataUtils.DEFAULT_RESERVED_METADATA))
-                .put("code_admin", new RoleDescriptor("code_admin", new String[] {},
-                    new RoleDescriptor.IndicesPrivileges[] {
-                        RoleDescriptor.IndicesPrivileges.builder()
-                            .indices(".code-*").privileges("all").build()
-                    }, null, MetadataUtils.DEFAULT_RESERVED_METADATA))
-                .put("code_user", new RoleDescriptor("code_user", new String[] {},
-                    new RoleDescriptor.IndicesPrivileges[] {
-                        RoleDescriptor.IndicesPrivileges.builder()
-                            .indices(".code-*").privileges("read").build()
-                    }, null, MetadataUtils.DEFAULT_RESERVED_METADATA))
                 .put("snapshot_user", new RoleDescriptor("snapshot_user", new String[] { "create_snapshot", GetRepositoriesAction.NAME },
                         new RoleDescriptor.IndicesPrivileges[] { RoleDescriptor.IndicesPrivileges.builder()
                                 .indices("*")
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
index 533962efd5a31..b2d32e871e15b 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
@@ -200,8 +200,8 @@ public void testIsReserved() {
         assertThat(ReservedRolesStore.isReserved(RemoteMonitoringUser.COLLECTION_ROLE_NAME), is(true));
         assertThat(ReservedRolesStore.isReserved(RemoteMonitoringUser.INDEXING_ROLE_NAME), is(true));
         assertThat(ReservedRolesStore.isReserved("snapshot_user"), is(true));
-        assertThat(ReservedRolesStore.isReserved("code_admin"), is(true));
-        assertThat(ReservedRolesStore.isReserved("code_user"), is(true));
+        assertThat(ReservedRolesStore.isReserved("code_admin"), is(false));
+        assertThat(ReservedRolesStore.isReserved("code_user"), is(false));
     }
 
     public void testSnapshotUserRole() {
@@ -1383,60 +1383,4 @@ public void testLogstashAdminRole() {
         assertThat(logstashAdminRole.indices().allowedIndicesMatcher(MultiSearchAction.NAME).test(index), is(true));
         assertThat(logstashAdminRole.indices().allowedIndicesMatcher(UpdateSettingsAction.NAME).test(index), is(true));
     }
-
-    public void testCodeAdminRole() {
-        RoleDescriptor roleDescriptor = new ReservedRolesStore().roleDescriptor("code_admin");
-        assertNotNull(roleDescriptor);
-        assertThat(roleDescriptor.getMetadata(), hasEntry("_reserved", true));
-
-        Role codeAdminRole = Role.builder(roleDescriptor, null).build();
-
-        assertThat(codeAdminRole.cluster().check(DelegatePkiAuthenticationAction.NAME, mock(TransportRequest.class),
-            mock(Authentication.class)), is(false));
-
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(IndexAction.NAME).test("foo"), is(false));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(IndexAction.NAME).test(".reporting"), is(false));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(IndexAction.NAME).test(".code-"), is(true));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher("indices:foo").test(randomAlphaOfLengthBetween(8, 24)),
-            is(false));
-
-        final String index = ".code-" + randomIntBetween(0, 5);
-
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(DeleteAction.NAME).test(index), is(true));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(DeleteIndexAction.NAME).test(index), is(true));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(CreateIndexAction.NAME).test(index), is(true));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(IndexAction.NAME).test(index), is(true));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(GetAction.NAME).test(index), is(true));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(SearchAction.NAME).test(index), is(true));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(MultiSearchAction.NAME).test(index), is(true));
-        assertThat(codeAdminRole.indices().allowedIndicesMatcher(UpdateSettingsAction.NAME).test(index), is(true));
-    }
-
-    public void testCodeUserRole() {
-        RoleDescriptor roleDescriptor = new ReservedRolesStore().roleDescriptor("code_user");
-        assertNotNull(roleDescriptor);
-        assertThat(roleDescriptor.getMetadata(), hasEntry("_reserved", true));
-
-        Role codeUserRole = Role.builder(roleDescriptor, null).build();
-
-        assertThat(codeUserRole.cluster().check(DelegatePkiAuthenticationAction.NAME, mock(TransportRequest.class),
-            mock(Authentication.class)), is(false));
-
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(SearchAction.NAME).test("foo"), is(false));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(SearchAction.NAME).test(".reporting"), is(false));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(SearchAction.NAME).test(".code-"), is(true));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher("indices:foo").test(randomAlphaOfLengthBetween(8, 24)),
-            is(false));
-
-        final String index = ".code-" + randomIntBetween(0, 5);
-
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(DeleteAction.NAME).test(index), is(false));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(DeleteIndexAction.NAME).test(index), is(false));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(CreateIndexAction.NAME).test(index), is(false));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(IndexAction.NAME).test(index), is(false));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(GetAction.NAME).test(index), is(true));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(SearchAction.NAME).test(index), is(true));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(MultiSearchAction.NAME).test(index), is(true));
-        assertThat(codeUserRole.indices().allowedIndicesMatcher(UpdateSettingsAction.NAME).test(index), is(false));
-    }
 }

From 19dc69222efb334c89dde12c79a62d5b81b3eb9b Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Thu, 12 Dec 2019 14:37:59 +1100
Subject: [PATCH 166/686] Support "accept_enterprise" param in get license
 (#50067)

In 7.6 (#49474) we added an "accept_enterprise" parameter to the
GET _license endpoint.

This commit adds the same parameter to 8.0, except that
(a) it is deprecated
(b) the only acceptable value is "true"

This change also updates the license service to recognise 7.6 as a
supported cluster version for the enterprise license type.
---
 .../elasticsearch/license/LicenseService.java |  2 +-
 .../license/RestGetLicenseAction.java         | 16 ++++++
 .../rest-api-spec/api/license.get.json        |  5 ++
 .../test/license/30_enterprise_license.yml    | 50 +++++++++++++++++++
 4 files changed, 72 insertions(+), 1 deletion(-)
 create mode 100644 x-pack/plugin/src/test/resources/rest-api-spec/test/license/30_enterprise_license.yml

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
index af34d31c14422..8168445f8c3ad 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
@@ -292,7 +292,7 @@ public ClusterState execute(ClusterState currentState) throws Exception {
 
     private static boolean licenseIsCompatible(License license, Version version) {
         if (License.LicenseType.ENTERPRISE.getTypeName().equalsIgnoreCase(license.type())) {
-            return version.onOrAfter(Version.V_8_0_0);
+            return version.onOrAfter(Version.V_7_6_0);
         } else {
             return true;
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RestGetLicenseAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RestGetLicenseAction.java
index 1aa3ccb0eab43..99ef7e4ec2c82 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RestGetLicenseAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RestGetLicenseAction.java
@@ -6,7 +6,9 @@
 
 package org.elasticsearch.license;
 
+import org.apache.logging.log4j.LogManager;
 import org.elasticsearch.client.node.NodeClient;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.protocol.xpack.license.GetLicenseRequest;
@@ -27,6 +29,8 @@
 
 public class RestGetLicenseAction extends BaseRestHandler {
 
+    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(LogManager.getLogger(RestGetLicenseAction.class));
+
     RestGetLicenseAction(RestController controller) {
         controller.registerHandler(GET, "/_license", this);
     }
@@ -47,6 +51,18 @@ public RestChannelConsumer prepareRequest(final RestRequest request, final NodeC
         final Map<String, String> overrideParams = new HashMap<>(2);
         overrideParams.put(License.REST_VIEW_MODE, "true");
         overrideParams.put(License.LICENSE_VERSION_MODE, String.valueOf(License.VERSION_CURRENT));
+
+        // In 7.x, there was an opt-in flag to show "enterprise" licenses. In 8.0 the flag is deprecated and can only be true
+        // TODO Remove this from 9.0
+        if (request.hasParam("accept_enterprise")) {
+            deprecationLogger.deprecatedAndMaybeLog("get_license_accept_enterprise",
+                "Including [accept_enterprise] in get license requests is deprecated." +
+                    " The parameter will be removed in the next major version");
+            if (request.paramAsBoolean("accept_enterprise", true) == false) {
+                throw new IllegalArgumentException("The [accept_enterprise] parameters may not be false");
+            }
+        }
+
         final ToXContent.Params params = new ToXContent.DelegatingMapParams(overrideParams, request);
         GetLicenseRequest getLicenseRequest = new GetLicenseRequest();
         getLicenseRequest.local(request.paramAsBoolean("local", getLicenseRequest.local()));
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get.json
index 0e917208c1bbf..f3fc15845e9bd 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get.json
@@ -18,6 +18,11 @@
       "local":{
         "type":"boolean",
         "description":"Return local information, do not retrieve the state from master node (default: false)"
+      },
+      "accept_enterprise":{
+        "type":"boolean",
+        "deprecated":true,
+        "description":"Supported for backwards compatibility with 7.x. If this param is used it must be set to true"
       }
     }
   }
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/license/30_enterprise_license.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/license/30_enterprise_license.yml
new file mode 100644
index 0000000000000..5f4582c747b5b
--- /dev/null
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/license/30_enterprise_license.yml
@@ -0,0 +1,50 @@
+---
+teardown:
+  - do:
+      license.post:
+        acknowledge: true
+        body: |
+          {"licenses":[{"uid":"3aa62ffe-36e1-4fad-bfdc-9dff8301eb22","type":"trial","issue_date_in_millis":1523456691721,"expiry_date_in_millis":1838816691721,"max_nodes":5,"issued_to":"customer","issuer":"elasticsearch","signature":"AAAABAAAAA2kWNcuc+DT0lrlmYZKAAAAIAo5/x6hrsGh1GqqrJmy4qgmEC7gK0U4zQ6q5ZEMhm4jAAABAEn6fG9y2VxKBu2T3D5hffh56kzOQODCOdhr0y2d17ZSIJMZRqO7ZywPCWNS1aR33GhfIHkTER0ysML0xMH/gXavhyRvMBndJj0UBKzuwpTawSlnxYtcqN8mSBIvJC7Ki+uJ1SpAILC2ZP9fnkRlqwXqBlTwfYn7xnZgu9DKrOWru/ipTPObo7jcePl8VTK6nWFen7/hCFDQTUFZ0jQvd+nq7A1PAcHGNxGfdbMVmAXCXgGWkRfT3clo9/vadgo+isNyh1sPq9mN7gwsvBAKtA1FrpH2EXYYbfOsSpBvUmhYMgErLg1k3/CbS0pCWLKOaX1xTMayosdZOjagU3auZXY=","start_date_in_millis":-1}]}
+---
+"Installing enterprise license":
+  - skip:
+      features: warnings
+
+  ## current license version
+  - do:
+      license.post:
+        acknowledge: true
+        body: |
+          {"license":{"uid":"6e57906b-a8d1-4c1f-acb7-73a16edc3934","type":"enterprise","issue_date_in_millis":1523456691721,"expiry_date_in_millis":1838816691721,"max_nodes":50,"issued_to":"rest-test","issuer":"elasticsearch","signature":"AAAABAAAAA03e8BZRVXaCV4CpPGRAAAAIAo5/x6hrsGh1GqqrJmy4qgmEC7gK0U4zQ6q5ZEMhm4jAAABAAZNhjABV6PRfa7P7sJgn70XCGoKtAVT75yU13JvKBd/UjD4TPhuZcztqZ/tcLEPxm/TSvGlogWmnw/Rw8xs8jMpBpKsJ+LOXjHhDdvXb2y7JJhCH8nlSEblMDRXysNvWpKe60Z/hb7hS4JynEUt0EBb6ji7BL42O07PNll1EGmkfsHazfs46iV91BG1VxXksI78XgWSaA0F/h7tvrNW9PTgsUaLo06InlQ8jA1dal90AoXp+MVDOHWQjVFZzUnO87/7lEb+VXt0IwchaW17ahihJqkCtGvKpWFwpuhx9xiFvkySN/g5LIVjYCvgBkiWExQ9p0Zzg3VoSlMBnVy0BWo=","start_date_in_millis":-1}}
+
+  - match: { license_status:  "valid" }
+
+  - do:
+      license.get: {}
+
+  ## a license object has 11 attributes
+  - length: { license: 11 }
+
+  ## In 8.0, the enterprise license is always reports truthfully
+  - match: { license.type: "enterprise" }
+
+  - do:
+      warnings:
+        - "Including [accept_enterprise] in get license requests is deprecated. The parameter will be removed in the next major version"
+      license.get:
+        accept_enterprise: "true"
+
+  ## a license object has 11 attributes
+  - length: { license: 11 }
+
+  ## Always returns real type
+  - match: { license.type: "enterprise" }
+
+  ## "false" is rejected
+  - do:
+      catch: bad_request
+      warnings:
+        - "Including [accept_enterprise] in get license requests is deprecated. The parameter will be removed in the next major version"
+      license.get:
+        accept_enterprise: "false"
+

From 2f70c960d30858f6d94866096eae4235b8762c8c Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Wed, 11 Dec 2019 21:30:56 -0800
Subject: [PATCH 167/686] Ensure meta and document field maps are never null in
 GetResult (#50112)

This commit ensures deseriable a GetResult from StreamInput does not
leave metaFields and documentFields null. This could cause an NPE in
situations where upsert response for a document that did not exist is
passed back to a node that forwarded the upsert request.

closes #48215
---
 .../org/elasticsearch/index/get/GetResult.java  | 17 +++++++----------
 .../elasticsearch/index/get/GetResultTests.java | 13 +++++++++++++
 2 files changed, 20 insertions(+), 10 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/get/GetResult.java b/server/src/main/java/org/elasticsearch/index/get/GetResult.java
index f64aa03b9c487..949cc1969e7ae 100644
--- a/server/src/main/java/org/elasticsearch/index/get/GetResult.java
+++ b/server/src/main/java/org/elasticsearch/index/get/GetResult.java
@@ -65,8 +65,8 @@ public class GetResult implements Writeable, Iterable<DocumentField>, ToXContent
     private long seqNo;
     private long primaryTerm;
     private boolean exists;
-    private Map<String, DocumentField> documentFields;
-    private Map<String, DocumentField> metaFields;
+    private final Map<String, DocumentField> documentFields;
+    private final Map<String, DocumentField> metaFields;
     private Map<String, Object> sourceAsMap;
     private BytesReference source;
     private byte[] sourceAsBytes;
@@ -95,6 +95,9 @@ public GetResult(StreamInput in) throws IOException {
                 metaFields = new HashMap<>();
                 splitFieldsByMetadata(fields, documentFields, metaFields);
             }
+        } else {
+            metaFields = Collections.emptyMap();
+            documentFields = Collections.emptyMap();
         }
     }
 
@@ -111,14 +114,8 @@ public GetResult(String index, String id, long seqNo, long primaryTerm, long ver
         this.version = version;
         this.exists = exists;
         this.source = source;
-        this.documentFields = documentFields;
-        if (this.documentFields == null) {
-            this.documentFields = emptyMap();
-        }
-        this.metaFields = metaFields;
-        if (this.metaFields == null) {
-            this.metaFields = emptyMap();
-        }
+        this.documentFields = documentFields == null ? emptyMap() : documentFields;
+        this.metaFields = metaFields == null ? emptyMap() : metaFields;
     }
 
     /**
diff --git a/server/src/test/java/org/elasticsearch/index/get/GetResultTests.java b/server/src/test/java/org/elasticsearch/index/get/GetResultTests.java
index 92cf49ac6f487..4bca0952685ef 100644
--- a/server/src/test/java/org/elasticsearch/index/get/GetResultTests.java
+++ b/server/src/test/java/org/elasticsearch/index/get/GetResultTests.java
@@ -24,6 +24,7 @@
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.document.DocumentField;
+import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentParser;
@@ -138,6 +139,18 @@ public void testToXContentEmbeddedNotFound() throws IOException {
         assertEquals("{\"found\":false}", originalBytes.utf8ToString());
     }
 
+    public void testSerializationNotFound() throws IOException {
+        // serializes and deserializes with streamable, then prints back to xcontent
+        GetResult getResult = new GetResult("index", "id", UNASSIGNED_SEQ_NO, 0, 1, false, null, null, null);
+
+        BytesStreamOutput out = new BytesStreamOutput();
+        getResult.writeTo(out);
+        getResult = new GetResult(out.bytes().streamInput());
+
+        BytesReference originalBytes = toXContentEmbedded(getResult, XContentType.JSON, false);
+        assertEquals("{\"found\":false}", originalBytes.utf8ToString());
+    }
+
     public void testGetSourceAsBytes() {
         XContentType xContentType = randomFrom(XContentType.values());
         Tuple<GetResult, GetResult> tuple = randomGetResult(xContentType);

From b1be6375947ff20dc76a7de4e66d6a0bcc1c7554 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 12 Dec 2019 10:12:03 +0100
Subject: [PATCH 168/686] Remove Unused Single Delete in BlobStoreRepository
 (#50024)

* Remove Unused Single Delete in BlobStoreRepository

There are no more production uses of the non-bulk delete or the delete that throws
on missing so this commit removes both these methods.
Only the bulk delete logic remains. Where the bulk delete was derived from single deletes,
the single delete code was inlined into the bulk delete method.
Where single delete was used in tests it was replaced by bulk deleting.
---
 .../blobstore/url/URLBlobContainer.java       |  3 +-
 .../azure/AzureBlobContainer.java             | 29 +++++-------
 .../gcs/GoogleCloudStorageBlobContainer.java  |  5 --
 .../gcs/GoogleCloudStorageBlobStore.java      | 14 ------
 .../repositories/hdfs/HdfsBlobContainer.java  | 33 ++++++++-----
 .../repositories/s3/S3BlobContainer.java      | 15 ------
 .../s3/S3BlobStoreContainerTests.java         |  5 --
 .../common/blobstore/BlobContainer.java       | 46 +------------------
 .../common/blobstore/fs/FsBlobContainer.java  | 31 ++++---------
 .../blobstore/BlobStoreRepository.java        |  4 +-
 .../blobstore/ChecksumBlobStoreFormat.java    |  7 ---
 .../snapshots/SnapshotCreationException.java  |  4 --
 .../MockEventuallyConsistentRepository.java   |  6 ++-
 ...ckEventuallyConsistentRepositoryTests.java |  2 +-
 .../ESBlobStoreContainerTestCase.java         | 31 +------------
 .../mockstore/BlobContainerWrapper.java       | 10 ++--
 .../snapshots/mockstore/MockRepository.java   | 18 ++------
 17 files changed, 63 insertions(+), 200 deletions(-)

diff --git a/modules/repository-url/src/main/java/org/elasticsearch/common/blobstore/url/URLBlobContainer.java b/modules/repository-url/src/main/java/org/elasticsearch/common/blobstore/url/URLBlobContainer.java
index 7a74078894c92..35174557f1e9d 100644
--- a/modules/repository-url/src/main/java/org/elasticsearch/common/blobstore/url/URLBlobContainer.java
+++ b/modules/repository-url/src/main/java/org/elasticsearch/common/blobstore/url/URLBlobContainer.java
@@ -35,6 +35,7 @@
 import java.security.AccessController;
 import java.security.PrivilegedActionException;
 import java.security.PrivilegedExceptionAction;
+import java.util.List;
 import java.util.Map;
 
 /**
@@ -93,7 +94,7 @@ public Map<String, BlobMetaData> listBlobsByPrefix(String blobNamePrefix) throws
      * This operation is not supported by URLBlobContainer
      */
     @Override
-    public void deleteBlob(String blobName) throws IOException {
+    public void deleteBlobsIgnoringIfNotExists(List<String> blobNames) {
         throw new UnsupportedOperationException("URL repository is read only");
     }
 
diff --git a/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureBlobContainer.java b/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureBlobContainer.java
index 15afaada84c83..2093139e115a3 100644
--- a/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureBlobContainer.java
+++ b/plugins/repository-azure/src/main/java/org/elasticsearch/repositories/azure/AzureBlobContainer.java
@@ -109,22 +109,6 @@ public void writeBlobAtomic(String blobName, InputStream inputStream, long blobS
         writeBlob(blobName, inputStream, blobSize, failIfAlreadyExists);
     }
 
-    @Override
-    public void deleteBlob(String blobName) throws IOException {
-        logger.trace("deleteBlob({})", blobName);
-
-        try {
-            blobStore.deleteBlob(buildKey(blobName));
-        } catch (StorageException e) {
-            if (e.getHttpStatusCode() == HttpURLConnection.HTTP_NOT_FOUND) {
-                throw new NoSuchFileException(e.getMessage());
-            }
-            throw new IOException(e);
-        } catch (URISyntaxException e) {
-            throw new IOException(e);
-        }
-    }
-
     @Override
     public DeleteResult delete() throws IOException {
         try {
@@ -146,7 +130,18 @@ public void deleteBlobsIgnoringIfNotExists(List<String> blobNames) throws IOExce
             // Executing deletes in parallel since Azure SDK 8 is using blocking IO while Azure does not provide a bulk delete API endpoint
             // TODO: Upgrade to newer non-blocking Azure SDK 11 and execute delete requests in parallel that way.
             for (String blobName : blobNames) {
-                executor.execute(ActionRunnable.run(listener, () -> deleteBlobIgnoringIfNotExists(blobName)));
+                executor.execute(ActionRunnable.run(listener, () -> {
+                    logger.trace("deleteBlob({})", blobName);
+                    try {
+                        blobStore.deleteBlob(buildKey(blobName));
+                    } catch (StorageException e) {
+                        if (e.getHttpStatusCode() != HttpURLConnection.HTTP_NOT_FOUND) {
+                            throw new IOException(e);
+                        }
+                    } catch (URISyntaxException e) {
+                        throw new IOException(e);
+                    }
+                }));
             }
         }
         try {
diff --git a/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainer.java b/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainer.java
index da22750242722..7a386dd1b395e 100644
--- a/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainer.java
+++ b/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainer.java
@@ -72,11 +72,6 @@ public void writeBlobAtomic(String blobName, InputStream inputStream, long blobS
         writeBlob(blobName, inputStream, blobSize, failIfAlreadyExists);
     }
 
-    @Override
-    public void deleteBlob(String blobName) throws IOException {
-        blobStore.deleteBlob(buildKey(blobName));
-    }
-
     @Override
     public DeleteResult delete() throws IOException {
         return blobStore.deleteDirectory(path().buildAsString());
diff --git a/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStore.java b/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStore.java
index f4ce144127cda..bdabce295399d 100644
--- a/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStore.java
+++ b/plugins/repository-gcs/src/main/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStore.java
@@ -314,19 +314,6 @@ private void writeBlobMultipart(BlobInfo blobInfo, InputStream inputStream, long
         }
     }
 
-    /**
-     * Deletes the blob from the specific bucket
-     *
-     * @param blobName name of the blob
-     */
-    void deleteBlob(String blobName) throws IOException {
-        final BlobId blobId = BlobId.of(bucketName, blobName);
-        final boolean deleted = SocketAccess.doPrivilegedIOException(() -> client().delete(blobId));
-        if (deleted == false) {
-            throw new NoSuchFileException("Blob [" + blobName + "] does not exist");
-        }
-    }
-
     /**
      * Deletes the given path and all its children.
      *
@@ -403,5 +390,4 @@ private static String buildKey(String keyPath, String s) {
         assert s != null;
         return keyPath + s;
     }
-
 }
diff --git a/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsBlobContainer.java b/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsBlobContainer.java
index 304906464dcad..832c9db7dbfcb 100644
--- a/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsBlobContainer.java
+++ b/plugins/repository-hdfs/src/main/java/org/elasticsearch/repositories/hdfs/HdfsBlobContainer.java
@@ -43,6 +43,7 @@
 import java.util.Collections;
 import java.util.EnumSet;
 import java.util.LinkedHashMap;
+import java.util.List;
 import java.util.Map;
 
 final class HdfsBlobContainer extends AbstractBlobContainer {
@@ -59,17 +60,6 @@ final class HdfsBlobContainer extends AbstractBlobContainer {
         this.bufferSize = bufferSize;
     }
 
-    @Override
-    public void deleteBlob(String blobName) throws IOException {
-        try {
-            if (store.execute(fileContext -> fileContext.delete(new Path(path, blobName), true)) == false) {
-                throw new NoSuchFileException("Blob [" + blobName + "] does not exist");
-            }
-        } catch (FileNotFoundException fnfe) {
-            throw new NoSuchFileException("[" + blobName + "] blob not found");
-        }
-    }
-
     // TODO: See if we can get precise result reporting.
     private static final DeleteResult DELETE_RESULT = new DeleteResult(1L, 0L);
 
@@ -79,6 +69,27 @@ public DeleteResult delete() throws IOException {
         return DELETE_RESULT;
     }
 
+    @Override
+    public void deleteBlobsIgnoringIfNotExists(final List<String> blobNames) throws IOException {
+        IOException ioe = null;
+        for (String blobName : blobNames) {
+            try {
+                store.execute(fileContext -> fileContext.delete(new Path(path, blobName), true));
+            } catch (final FileNotFoundException ignored) {
+                // This exception is ignored
+            } catch (IOException e) {
+                if (ioe == null) {
+                    ioe = e;
+                } else {
+                    ioe.addSuppressed(e);
+                }
+            }
+        }
+        if (ioe != null) {
+            throw ioe;
+        }
+    }
+
     @Override
     public InputStream readBlob(String blobName) throws IOException {
         // FSDataInputStream does buffering internally
diff --git a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3BlobContainer.java b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3BlobContainer.java
index f73bc7c8732cb..6afb81da5e02c 100644
--- a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3BlobContainer.java
+++ b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3BlobContainer.java
@@ -107,11 +107,6 @@ public void writeBlobAtomic(String blobName, InputStream inputStream, long blobS
         writeBlob(blobName, inputStream, blobSize, failIfAlreadyExists);
     }
 
-    @Override
-    public void deleteBlob(String blobName) throws IOException {
-        deleteBlobIgnoringIfNotExists(blobName);
-    }
-
     @Override
     public DeleteResult delete() throws IOException {
         final AtomicLong deletedBlobs = new AtomicLong();
@@ -215,16 +210,6 @@ private static DeleteObjectsRequest bulkDelete(String bucket, List<String> blobs
         return new DeleteObjectsRequest(bucket).withKeys(blobs.toArray(Strings.EMPTY_ARRAY)).withQuiet(true);
     }
 
-    @Override
-    public void deleteBlobIgnoringIfNotExists(String blobName) throws IOException {
-        try (AmazonS3Reference clientReference = blobStore.clientReference()) {
-            // There is no way to know if an non-versioned object existed before the deletion
-            SocketAccess.doPrivilegedVoid(() -> clientReference.client().deleteObject(blobStore.bucket(), buildKey(blobName)));
-        } catch (final AmazonClientException e) {
-            throw new IOException("Exception when deleting blob [" + blobName + "]", e);
-        }
-    }
-
     @Override
     public Map<String, BlobMetaData> listBlobsByPrefix(@Nullable String blobNamePrefix) throws IOException {
         try (AmazonS3Reference clientReference = blobStore.clientReference()) {
diff --git a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreContainerTests.java b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreContainerTests.java
index 367ed06dc6551..95f51091555c2 100644
--- a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreContainerTests.java
+++ b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreContainerTests.java
@@ -71,11 +71,6 @@ protected BlobStore newBlobStore() {
         return randomMockS3BlobStore();
     }
 
-    @Override
-    public void testDeleteBlob() {
-        assumeFalse("not implemented because of S3's weak consistency model", true);
-    }
-
     @Override
     public void testVerifyOverwriteFails() {
         assumeFalse("not implemented because of S3's weak consistency model", true);
diff --git a/server/src/main/java/org/elasticsearch/common/blobstore/BlobContainer.java b/server/src/main/java/org/elasticsearch/common/blobstore/BlobContainer.java
index 83de4aba8e629..8ef9badd112f6 100644
--- a/server/src/main/java/org/elasticsearch/common/blobstore/BlobContainer.java
+++ b/server/src/main/java/org/elasticsearch/common/blobstore/BlobContainer.java
@@ -89,17 +89,6 @@ public interface BlobContainer {
      */
     void writeBlobAtomic(String blobName, InputStream inputStream, long blobSize, boolean failIfAlreadyExists) throws IOException;
 
-    /**
-     * Deletes the blob with the given name, if the blob exists. If the blob does not exist,
-     * this method may throw a {@link NoSuchFileException} if the underlying implementation supports an existence check before delete.
-     *
-     * @param   blobName
-     *          The name of the blob to delete.
-     * @throws  NoSuchFileException if the blob does not exist
-     * @throws  IOException if the blob exists but could not be deleted.
-     */
-    void deleteBlob(String blobName) throws IOException;
-
     /**
      * Deletes this container and all its contents from the repository.
      *
@@ -109,44 +98,13 @@ public interface BlobContainer {
     DeleteResult delete() throws IOException;
 
     /**
-     * Deletes the blobs with given names. Unlike {@link #deleteBlob(String)} this method will not throw an exception
+     * Deletes the blobs with given names. This method will not throw an exception
      * when one or multiple of the given blobs don't exist and simply ignore this case.
      *
      * @param   blobNames  The names of the blob to delete.
      * @throws  IOException if a subset of blob exists but could not be deleted.
      */
-    default void deleteBlobsIgnoringIfNotExists(List<String> blobNames) throws IOException {
-        IOException ioe = null;
-        for (String blobName : blobNames) {
-            try {
-                deleteBlobIgnoringIfNotExists(blobName);
-            } catch (IOException e) {
-                if (ioe == null) {
-                    ioe = e;
-                } else {
-                    ioe.addSuppressed(e);
-                }
-            }
-        }
-        if (ioe != null) {
-            throw ioe;
-        }
-    }
-
-    /**
-     * Deletes a blob with giving name, ignoring if the blob does not exist.
-     *
-     * @param   blobName
-     *          The name of the blob to delete.
-     * @throws  IOException if the blob exists but could not be deleted.
-     */
-    default void deleteBlobIgnoringIfNotExists(String blobName) throws IOException {
-        try {
-            deleteBlob(blobName);
-        } catch (final NoSuchFileException ignored) {
-            // This exception is ignored
-        }
-    }
+    void deleteBlobsIgnoringIfNotExists(List<String> blobNames) throws IOException;
 
     /**
      * Lists all blobs in the container.
diff --git a/server/src/main/java/org/elasticsearch/common/blobstore/fs/FsBlobContainer.java b/server/src/main/java/org/elasticsearch/common/blobstore/fs/FsBlobContainer.java
index d3a9731b2f656..b95cf62bcc316 100644
--- a/server/src/main/java/org/elasticsearch/common/blobstore/fs/FsBlobContainer.java
+++ b/server/src/main/java/org/elasticsearch/common/blobstore/fs/FsBlobContainer.java
@@ -44,7 +44,9 @@
 import java.nio.file.StandardCopyOption;
 import java.nio.file.StandardOpenOption;
 import java.nio.file.attribute.BasicFileAttributes;
+import java.util.Collections;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.concurrent.atomic.AtomicLong;
 
@@ -112,24 +114,6 @@ public Map<String, BlobMetaData> listBlobsByPrefix(String blobNamePrefix) throws
         return unmodifiableMap(builder);
     }
 
-    @Override
-    public void deleteBlob(String blobName) throws IOException {
-        Path blobPath = path.resolve(blobName);
-        if (Files.isDirectory(blobPath)) {
-            // delete directory recursively as long as it is empty (only contains empty directories),
-            // which is the reason we aren't deleting any files, only the directories on the post-visit
-            Files.walkFileTree(blobPath, new SimpleFileVisitor<>() {
-                @Override
-                public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
-                    Files.delete(dir);
-                    return FileVisitResult.CONTINUE;
-                }
-            });
-        } else {
-            Files.delete(blobPath);
-        }
-    }
-
     @Override
     public DeleteResult delete() throws IOException {
         final AtomicLong filesDeleted = new AtomicLong(0L);
@@ -153,6 +137,11 @@ public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IO
         return new DeleteResult(filesDeleted.get(), bytesDeleted.get());
     }
 
+    @Override
+    public void deleteBlobsIgnoringIfNotExists(List<String> blobNames) throws IOException {
+        IOUtils.rm(blobNames.stream().map(path::resolve).toArray(Path[]::new));
+    }
+
     @Override
     public InputStream readBlob(String name) throws IOException {
         final Path resolvedPath = path.resolve(name);
@@ -166,7 +155,7 @@ public InputStream readBlob(String name) throws IOException {
     @Override
     public void writeBlob(String blobName, InputStream inputStream, long blobSize, boolean failIfAlreadyExists) throws IOException {
         if (failIfAlreadyExists == false) {
-            deleteBlobIgnoringIfNotExists(blobName);
+            deleteBlobsIgnoringIfNotExists(Collections.singletonList(blobName));
         }
         final Path file = path.resolve(blobName);
         try (OutputStream outputStream = Files.newOutputStream(file, StandardOpenOption.CREATE_NEW)) {
@@ -189,7 +178,7 @@ public void writeBlobAtomic(final String blobName, final InputStream inputStream
             moveBlobAtomic(tempBlob, blobName, failIfAlreadyExists);
         } catch (IOException ex) {
             try {
-                deleteBlobIgnoringIfNotExists(tempBlob);
+                deleteBlobsIgnoringIfNotExists(Collections.singletonList(tempBlob));
             } catch (IOException e) {
                 ex.addSuppressed(e);
             }
@@ -209,7 +198,7 @@ public void moveBlobAtomic(final String sourceBlobName, final String targetBlobN
             if (failIfAlreadyExists) {
                 throw new FileAlreadyExistsException("blob [" + targetBlobPath + "] already exists, cannot overwrite");
             } else {
-                deleteBlobIgnoringIfNotExists(targetBlobName);
+                deleteBlobsIgnoringIfNotExists(Collections.singletonList(targetBlobName));
             }
         }
         Files.move(sourceBlobPath, targetBlobPath, StandardCopyOption.ATOMIC_MOVE);
diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index 838bede23bf54..448f71087f91b 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -974,9 +974,7 @@ public void endVerification(String seed) {
         if (isReadOnly() == false) {
             try {
                 final String testPrefix = testBlobPrefix(seed);
-                final BlobContainer container = blobStore().blobContainer(basePath().add(testPrefix));
-                container.deleteBlobsIgnoringIfNotExists(List.copyOf(container.listBlobs().keySet()));
-                blobStore().blobContainer(basePath()).deleteBlobIgnoringIfNotExists(testPrefix);
+                blobStore().blobContainer(basePath().add(testPrefix)).delete();
             } catch (IOException exp) {
                 throw new RepositoryVerificationException(metadata.name(), "cannot delete test data at " + basePath(), exp);
             }
diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/ChecksumBlobStoreFormat.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/ChecksumBlobStoreFormat.java
index 4d8a25ca8d50d..030bd6946cd3b 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/ChecksumBlobStoreFormat.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/ChecksumBlobStoreFormat.java
@@ -114,13 +114,6 @@ public T read(BlobContainer blobContainer, String name) throws IOException {
         return readBlob(blobContainer, blobName);
     }
 
-    /**
-     * Deletes obj in the blob container
-     */
-    public void delete(BlobContainer blobContainer, String name) throws IOException {
-        blobContainer.deleteBlob(blobName(name));
-    }
-
     public String blobName(String name) {
         return String.format(Locale.ROOT, blobNameFormat, name);
     }
diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotCreationException.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotCreationException.java
index b21ec99019cf6..4a80782575bdb 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotCreationException.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotCreationException.java
@@ -28,10 +28,6 @@
  */
 public class SnapshotCreationException extends SnapshotException {
 
-    public SnapshotCreationException(final String repositoryName, final SnapshotId snapshotId, final Throwable cause) {
-        super(repositoryName, snapshotId, "failed to create snapshot", cause);
-    }
-
     public SnapshotCreationException(StreamInput in) throws IOException {
         super(in);
     }
diff --git a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
index 880008a96b90b..c6f2c1ee16fbf 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepository.java
@@ -220,10 +220,12 @@ private List<BlobStoreAction> relevantActions(String blobPath) {
             }
 
             @Override
-            public void deleteBlob(String blobName) {
+            public void deleteBlobsIgnoringIfNotExists(List<String> blobNames) {
                 ensureNotClosed();
                 synchronized (context.actions) {
-                    context.actions.add(new BlobStoreAction(Operation.DELETE, path.buildAsString() + blobName));
+                    for (String blobName : blobNames) {
+                        context.actions.add(new BlobStoreAction(Operation.DELETE, path.buildAsString() + blobName));
+                    }
                 }
             }
 
diff --git a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
index e4e6d99c6e6f0..47e2626a3b7f3 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
@@ -91,7 +91,7 @@ public void testReadAfterDeleteAfterWriteThrows() throws IOException {
             final int lengthWritten = randomIntBetween(1, 100);
             final byte[] blobData = randomByteArrayOfLength(lengthWritten);
             blobContainer.writeBlob(blobName, new ByteArrayInputStream(blobData), lengthWritten, true);
-            blobContainer.deleteBlob(blobName);
+            blobContainer.deleteBlobsIgnoringIfNotExists(Collections.singletonList(blobName));
             assertThrowsOnInconsistentRead(blobContainer, blobName);
             blobStoreContext.forceConsistent();
             expectThrows(NoSuchFileException.class, () -> blobContainer.readBlob(blobName));
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/ESBlobStoreContainerTestCase.java b/test/framework/src/main/java/org/elasticsearch/repositories/ESBlobStoreContainerTestCase.java
index 2b273c1e6a784..3aa65cf392c3d 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/ESBlobStoreContainerTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/ESBlobStoreContainerTestCase.java
@@ -33,6 +33,7 @@
 import java.nio.file.FileAlreadyExistsException;
 import java.nio.file.NoSuchFileException;
 import java.util.Arrays;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -120,22 +121,6 @@ public void testList() throws IOException {
         }
     }
 
-    public void testDeleteBlob() throws IOException {
-        try (BlobStore store = newBlobStore()) {
-            final String blobName = "foobar";
-            final BlobContainer container = store.blobContainer(new BlobPath());
-            expectThrows(NoSuchFileException.class, () -> container.deleteBlob(blobName));
-
-            byte[] data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
-            final BytesArray bytesArray = new BytesArray(data);
-            writeBlob(container, blobName, bytesArray, randomBoolean());
-            container.deleteBlob(blobName); // should not raise
-
-            // blob deleted, so should raise again
-            expectThrows(NoSuchFileException.class, () -> container.deleteBlob(blobName));
-        }
-    }
-
     public void testDeleteBlobs() throws IOException {
         try (BlobStore store = newBlobStore()) {
             final List<String> blobNames = Arrays.asList("foobar", "barfoo");
@@ -153,18 +138,6 @@ public void testDeleteBlobs() throws IOException {
         }
     }
 
-    public void testDeleteBlobIgnoringIfNotExists() throws IOException {
-        try (BlobStore store = newBlobStore()) {
-            BlobPath blobPath = new BlobPath();
-            if (randomBoolean()) {
-                blobPath = blobPath.add(randomAlphaOfLengthBetween(1, 10));
-            }
-
-            final BlobContainer container = store.blobContainer(blobPath);
-            container.deleteBlobIgnoringIfNotExists("does_not_exist");
-        }
-    }
-
     public void testVerifyOverwriteFails() throws IOException {
         try (BlobStore store = newBlobStore()) {
             final String blobName = "foobar";
@@ -174,7 +147,7 @@ public void testVerifyOverwriteFails() throws IOException {
             writeBlob(container, blobName, bytesArray, true);
             // should not be able to overwrite existing blob
             expectThrows(FileAlreadyExistsException.class, () -> writeBlob(container, blobName, bytesArray, true));
-            container.deleteBlob(blobName);
+            container.deleteBlobsIgnoringIfNotExists(Collections.singletonList(blobName));
             writeBlob(container, blobName, bytesArray, true); // after deleting the previous blob, we should be able to write to it again
         }
     }
diff --git a/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/BlobContainerWrapper.java b/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/BlobContainerWrapper.java
index c38ddb45ab853..8aafc16b2ccbb 100644
--- a/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/BlobContainerWrapper.java
+++ b/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/BlobContainerWrapper.java
@@ -25,6 +25,7 @@
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.util.List;
 import java.util.Map;
 
 public class BlobContainerWrapper implements BlobContainer {
@@ -55,19 +56,14 @@ public void writeBlobAtomic(final String blobName, final InputStream inputStream
         delegate.writeBlobAtomic(blobName, inputStream, blobSize, failIfAlreadyExists);
     }
 
-    @Override
-    public void deleteBlob(String blobName) throws IOException {
-        delegate.deleteBlob(blobName);
-    }
-
     @Override
     public DeleteResult delete() throws IOException {
         return delegate.delete();
     }
 
     @Override
-    public void deleteBlobIgnoringIfNotExists(final String blobName) throws IOException {
-        delegate.deleteBlobIgnoringIfNotExists(blobName);
+    public void deleteBlobsIgnoringIfNotExists(List<String> blobNames) throws IOException {
+        delegate.deleteBlobsIgnoringIfNotExists(blobNames);
     }
 
     @Override
diff --git a/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java b/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
index 6c05cc625f5cb..7b21c878599e9 100644
--- a/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
+++ b/test/framework/src/main/java/org/elasticsearch/snapshots/mockstore/MockRepository.java
@@ -312,18 +312,6 @@ public InputStream readBlob(String name) throws IOException {
                 return super.readBlob(name);
             }
 
-            @Override
-            public void deleteBlob(String blobName) throws IOException {
-                maybeIOExceptionOrBlock(blobName);
-                super.deleteBlob(blobName);
-            }
-
-            @Override
-            public void deleteBlobIgnoringIfNotExists(String blobName) throws IOException {
-                maybeIOExceptionOrBlock(blobName);
-                super.deleteBlobIgnoringIfNotExists(blobName);
-            }
-
             @Override
             public DeleteResult delete() throws IOException {
                 DeleteResult deleteResult = DeleteResult.ZERO;
@@ -334,10 +322,12 @@ public DeleteResult delete() throws IOException {
                 long deleteBlobCount = blobs.size();
                 long deleteByteCount = 0L;
                 for (String blob : blobs.values().stream().map(BlobMetaData::name).collect(Collectors.toList())) {
-                    deleteBlobIgnoringIfNotExists(blob);
+                    maybeIOExceptionOrBlock(blob);
+                    deleteBlobsIgnoringIfNotExists(Collections.singletonList(blob));
                     deleteByteCount += blobs.get(blob).length();
                 }
-                blobStore().blobContainer(path().parent()).deleteBlob(path().toArray()[path().toArray().length - 1]);
+                blobStore().blobContainer(path().parent()).deleteBlobsIgnoringIfNotExists(
+                    List.of(path().toArray()[path().toArray().length - 1]));
                 return deleteResult.add(deleteBlobCount, deleteByteCount);
             }
 

From e09045ef0b6f104533fe11f3b1643ac0f86132b1 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 12 Dec 2019 10:31:53 +0100
Subject: [PATCH 169/686] Better Logging GCS Blobstore Mock (#50102)

* Better Logging GCS Blobstore Mock

Two things:
1. We should just throw a descriptive assertion error and figure out why we're not reading a multi-part instead of
returning a `400` and failing the tests that way here since we can't reproduce these 400s locally.
2. We were missing logging the exception on a cleanup delete failure that coincides with the `400` issue in tests.

Relates #49429
---
 .../repositories/blobstore/BlobStoreRepository.java            | 2 +-
 .../main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java   | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index 448f71087f91b..b56a22e99845b 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -1186,7 +1186,7 @@ public void clusterStateProcessed(String source, ClusterState oldState, ClusterS
                             try {
                                 blobContainer().deleteBlobsIgnoringIfNotExists(oldIndexN);
                             } catch (IOException e) {
-                                logger.warn("Failed to clean up old index blobs {}", oldIndexN);
+                                logger.warn(() -> new ParameterizedMessage("Failed to clean up old index blobs {}", oldIndexN), e);
                             }
                         }));
                     }
diff --git a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
index a374a745909a5..967c884104c96 100644
--- a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
+++ b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
@@ -189,7 +189,8 @@ public void handle(final HttpExchange exchange) throws IOException {
                     exchange.sendResponseHeaders(RestStatus.OK.getStatus(), response.length);
                     exchange.getResponseBody().write(response);
                 } else {
-                    exchange.sendResponseHeaders(RestStatus.BAD_REQUEST.getStatus(), -1);
+                    throw new AssertionError("Could not read multi-part request to [" + request + "] with headers ["
+                        + new HashMap<>(exchange.getRequestHeaders()) + "]");
                 }
 
             } else if (Regex.simpleMatch("POST /upload/storage/v1/b/" + bucket + "/*uploadType=resumable*", request)) {

From 6578d032accc4bee2fb78e514cfc816c1b827a9e Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 12 Dec 2019 10:52:57 +0100
Subject: [PATCH 170/686] Disable LongGCDisruptionTests on JDK11+12 (#50097)

See discussion in #50047 (comment).
There are reproducible issues with Thread#suspend in Jdk11 and Jdk12 for me locally
and we have one failure for each on CI.
Jdk8 and Jdk13 are stable though on CI and in my testing so I'd selectively disable
this test here to keep the coverage. We aren't using suspend in production code so the
JDK bug behind this does not affect us.

Closes #50047
---
 .../elasticsearch/test/disruption/LongGCDisruptionTests.java   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/test/framework/src/test/java/org/elasticsearch/test/disruption/LongGCDisruptionTests.java b/test/framework/src/test/java/org/elasticsearch/test/disruption/LongGCDisruptionTests.java
index 7e27ffaab3e52..2021c1d7fab08 100644
--- a/test/framework/src/test/java/org/elasticsearch/test/disruption/LongGCDisruptionTests.java
+++ b/test/framework/src/test/java/org/elasticsearch/test/disruption/LongGCDisruptionTests.java
@@ -18,6 +18,7 @@
  */
 package org.elasticsearch.test.disruption;
 
+import org.elasticsearch.bootstrap.JavaVersion;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.test.ESTestCase;
 
@@ -114,6 +115,8 @@ protected long getSuspendingTimeoutInMillis() {
      * but does keep retrying until all threads can be safely paused
      */
     public void testNotBlockingUnsafeStackTraces() throws Exception {
+        assumeFalse("https://github.com/elastic/elasticsearch/issues/50047",
+            JavaVersion.current().equals(JavaVersion.parse("11")) || JavaVersion.current().equals(JavaVersion.parse("12")));
         final String nodeName = "test_node";
         LongGCDisruption disruption = new LongGCDisruption(random(), nodeName) {
             @Override

From 6c0f663620d1c0fb3b46347c977e05cc6763d864 Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Thu, 12 Dec 2019 10:57:31 +0100
Subject: [PATCH 171/686] Remove information about the latest
 PostingsFormat/DocValuesFormat. (#50118)

This information is outdated and unused.
---
 .../java/org/elasticsearch/common/lucene/Lucene.java  | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/lucene/Lucene.java b/server/src/main/java/org/elasticsearch/common/lucene/Lucene.java
index ce00c7755205f..ef2816777094a 100644
--- a/server/src/main/java/org/elasticsearch/common/lucene/Lucene.java
+++ b/server/src/main/java/org/elasticsearch/common/lucene/Lucene.java
@@ -24,8 +24,6 @@
 import org.apache.lucene.analysis.core.KeywordAnalyzer;
 import org.apache.lucene.analysis.standard.StandardAnalyzer;
 import org.apache.lucene.codecs.CodecUtil;
-import org.apache.lucene.codecs.DocValuesFormat;
-import org.apache.lucene.codecs.PostingsFormat;
 import org.apache.lucene.document.LatLonDocValuesField;
 import org.apache.lucene.document.NumericDocValuesField;
 import org.apache.lucene.index.BinaryDocValues;
@@ -105,17 +103,8 @@
 import java.util.Map;
 
 public class Lucene {
-    public static final String LATEST_DOC_VALUES_FORMAT = "Lucene70";
-    public static final String LATEST_POSTINGS_FORMAT = "Lucene50";
     public static final String LATEST_CODEC = "Lucene84";
 
-    static {
-        Deprecated annotation = PostingsFormat.forName(LATEST_POSTINGS_FORMAT).getClass().getAnnotation(Deprecated.class);
-        assert annotation == null : "PostingsFromat " + LATEST_POSTINGS_FORMAT + " is deprecated" ;
-        annotation = DocValuesFormat.forName(LATEST_DOC_VALUES_FORMAT).getClass().getAnnotation(Deprecated.class);
-        assert annotation == null : "DocValuesFormat " + LATEST_DOC_VALUES_FORMAT + " is deprecated" ;
-    }
-
     public static final String SOFT_DELETES_FIELD = "__soft_deletes";
 
     public static final NamedAnalyzer STANDARD_ANALYZER = new NamedAnalyzer("_standard", AnalyzerScope.GLOBAL, new StandardAnalyzer());

From 5b5f1f0e16651c016c9bd34123886d0275d9d300 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 12 Dec 2019 10:59:37 +0100
Subject: [PATCH 172/686] [DOCS] Moves data frame analytics job resource
 definitions into APIs (#50021)

---
 .../apis/analysisobjects.asciidoc             | 216 ++++++++++
 .../apis/delete-dfanalytics.asciidoc          |   4 +
 .../apis/dfanalyticsresources.asciidoc        | 298 -------------
 .../apis/evaluate-dfanalytics.asciidoc        | 111 ++++-
 .../apis/evaluateresources.asciidoc           | 128 ------
 .../apis/explain-dfanalytics.asciidoc         |  54 +--
 .../apis/get-dfanalytics-stats.asciidoc       |  29 +-
 .../apis/get-dfanalytics.asciidoc             |  53 +--
 .../ml/df-analytics/apis/index.asciidoc       |   2 +
 .../apis/put-dfanalytics.asciidoc             | 117 ++----
 .../apis/start-dfanalytics.asciidoc           |   4 +-
 .../apis/stop-dfanalytics.asciidoc            |  10 +-
 docs/reference/ml/ml-shared.asciidoc          | 392 +++++++++++++++---
 docs/reference/rest-api/defs.asciidoc         |   8 +-
 14 files changed, 764 insertions(+), 662 deletions(-)
 create mode 100644 docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc
 delete mode 100644 docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
 delete mode 100644 docs/reference/ml/df-analytics/apis/evaluateresources.asciidoc

diff --git a/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc b/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc
new file mode 100644
index 0000000000000..035601fe71409
--- /dev/null
+++ b/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc
@@ -0,0 +1,216 @@
+[role="xpack"]
+[testenv="platinum"]
+[[ml-dfa-analysis-objects]]
+=== Analysis configuration objects
+
+{dfanalytics-cap} resources contain `analysis` objects. For example, when you
+create a {dfanalytics-job}, you must define the type of analysis it performs. 
+This page lists all the available parameters that you can use in the `analysis` 
+object grouped by {dfanalytics} types.
+
+
+[discrete]
+[[oldetection-resources]]
+==== {oldetection-cap} configuration objects
+
+An `outlier_detection` configuration object has the following properties:
+
+`compute_feature_influence`::
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=compute-feature-influence]
+  
+`feature_influence_threshold`:: 
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=feature-influence-threshold]
+
+`method`::
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=method]
+  
+`n_neighbors`::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=n-neighbors]
+  
+`outlier_fraction`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=outlier-fraction]
+  
+`standardization_enabled`::
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=standardization-enabled]
+
+
+[discrete]
+[[reganalysis-resources]]
+==== {regression-cap} configuration objects
+
+[source,console]
+--------------------------------------------------
+PUT _ml/data_frame/analytics/house_price_regression_analysis
+{
+  "source": {
+    "index": "houses_sold_last_10_yrs" <1>
+  },
+  "dest": {
+    "index": "house_price_predictions" <2>
+  },
+  "analysis": 
+    {
+      "regression": { <3>
+        "dependent_variable": "price" <4>
+      }
+    }
+}
+--------------------------------------------------
+// TEST[skip:TBD]
+
+<1> Training data is taken from source index `houses_sold_last_10_yrs`.
+<2> Analysis results will be output to destination index 
+`house_price_predictions`.
+<3> The regression analysis configuration object.
+<4> Regression analysis will use field `price` to train on. As no other 
+parameters have been specified it will train on 100% of eligible data, store its 
+prediction in destination index field `price_prediction` and use in-built 
+hyperparameter optimization to give minimum validation errors.
+
+
+[float]
+[[regression-resources-standard]]
+===== Standard parameters
+
+`dependent_variable`::
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
++
+--
+The data type of the field must be numeric.
+--
+
+`prediction_field_name`::
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
+
+`training_percent`::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
+
+`randomize_seed`::
+(Optional, long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
+
+
+[float]
+[[regression-resources-advanced]]
+===== Advanced parameters
+
+Advanced parameters are for fine-tuning {reganalysis}. They are set 
+automatically by <<ml-hyperparam-optimization,hyperparameter optimization>> 
+to give minimum validation error. It is highly recommended to use the default 
+values unless you fully understand the function of these parameters. If these 
+parameters are not supplied, their values are automatically tuned to give 
+minimum validation error.
+
+`eta`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
+
+`feature_bag_fraction`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
+
+`maximum_number_trees`::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=maximum-number-trees]
+
+`gamma`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
+
+`lambda`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
+
+
+[discrete]
+[[classanalysis-resources]]
+==== {classification-cap} configuration objects 
+ 
+ 
+[float]
+[[classification-resources-standard]]
+===== Standard parameters
+ 
+`dependent_variable`::
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
++
+--
+The data type of the field must be numeric or boolean.
+--
+  
+`num_top_classes`::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=num-top-classes]
+ 
+`prediction_field_name`::
+(Optional, string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
+
+`training_percent`::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
+
+`randomize_seed`::
+(Optional, long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
+
+
+[float]
+[[classification-resources-advanced]]
+===== Advanced parameters
+
+Advanced parameters are for fine-tuning {classanalysis}. They are set 
+automatically by <<ml-hyperparam-optimization,hyperparameter optimization>> 
+to give minimum validation error. It is highly recommended to use the default 
+values unless you fully understand the function of these parameters. If these 
+parameters are not supplied, their values are automatically tuned to give 
+minimum validation error.
+
+`eta`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
+
+`feature_bag_fraction`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
+
+`maximum_number_trees`::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=maximum-number-trees]
+
+`gamma`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
+
+`lambda`::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
+
+[discrete]
+[[ml-hyperparam-optimization]]
+==== Hyperparameter optimization
+
+If you don't supply {regression} or {classification} parameters, hyperparameter 
+optimization will be performed by default to set a value for the undefined 
+parameters. The starting point is calculated for data dependent parameters by 
+examining the loss on the training data. Subject to the size constraint, this 
+operation provides an upper bound on the improvement in validation loss.
+
+A fixed number of rounds is used for optimization which depends on the number of 
+parameters being optimized. The optimization starts with random search, then 
+Bayesian optimization is performed that is targeting maximum expected 
+improvement. If you override any parameters, then the optimization will 
+calculate the value of the remaining parameters accordingly and use the value 
+you provided for the overridden parameter. The number of rounds are reduced 
+respectively. The validation error is estimated in each round by using 4-fold 
+cross validation.
diff --git a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
index 3f27c91fd016f..8d80e3bba8783 100644
--- a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
@@ -11,17 +11,20 @@ Deletes an existing {dfanalytics-job}.
 
 experimental[]
 
+
 [[ml-delete-dfanalytics-request]]
 ==== {api-request-title}
 
 `DELETE _ml/data_frame/analytics/<data_frame_analytics_id>`
 
+
 [[ml-delete-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
 * You must have `machine_learning_admin` built-in role to use this API. For more 
 information, see <<security-privileges>> and <<built-in-roles>>.
 
+
 [[ml-delete-dfanalytics-path-params]]
 ==== {api-path-parms-title}
 
@@ -29,6 +32,7 @@ information, see <<security-privileges>> and <<built-in-roles>>.
 (Required, string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
 
+
 [[ml-delete-dfanalytics-example]]
 ==== {api-examples-title}
 
diff --git a/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc b/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
deleted file mode 100644
index 111953b8321ab..0000000000000
--- a/docs/reference/ml/df-analytics/apis/dfanalyticsresources.asciidoc
+++ /dev/null
@@ -1,298 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-dfanalytics-resources]]
-=== {dfanalytics-cap} job resources
-
-{dfanalytics-cap} resources relate to APIs such as <<put-dfanalytics>> and
-<<get-dfanalytics>>.	
-
-[discrete]	
-[[ml-dfanalytics-properties]]	
-==== {api-definitions-title}
-
-`analysis`::
-  (object) The type of analysis that is performed on the `source`. For example: 
-  `outlier_detection` or `regression`. For more information, see 
-  <<dfanalytics-types>>.
-  
-`analyzed_fields`::
-  (Optional, object) Specify `includes` and/or `excludes` patterns to select
-  which fields will be included in the analysis. If `analyzed_fields` is not set,
-  only the relevant fields will be included. For example, all the numeric fields
-  for {oldetection}. For the supported field types, see <<ml-put-dfanalytics-supported-fields>>.
-  Also see the <<explain-dfanalytics>> which helps understand field selection.
-    
-  `includes`:::
-    (Optional, array) An array of strings that defines the fields that will be included in 
-    the analysis.
-      
-  `excludes`:::
-    (Optional, array) An array of strings that defines the fields that will be excluded 
-    from the analysis.
-  
-
-[source,console]
---------------------------------------------------
-PUT _ml/data_frame/analytics/loganalytics
-{
-  "source": {
-    "index": "logdata"
-  },
-  "dest": {
-    "index": "logdata_out"
-  },
-  "analysis": {
-    "outlier_detection": {
-    }
-  },
-  "analyzed_fields": {
-        "includes": [ "request.bytes", "response.counts.error" ],
-        "excludes": [ "source.geo" ]
-  }
-}
---------------------------------------------------
-// TEST[setup:setup_logdata]
-
-`description`::
-  (Optional, string) A description of the job.
-
-`dest`::
-  (object) The destination configuration of the analysis.
-  
-  `index`:::
-    (Required, string) Defines the _destination index_ to store the results of 
-    the {dfanalytics-job}.
-  
-  `results_field`:::
-    (Optional, string) Defines the name of the field in which to store the 
-    results of the analysis. Default to `ml`.
-
-`id`::
-  (string) The unique identifier for the {dfanalytics-job}. This identifier can 
-  contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and 
-  underscores. It must start and end with alphanumeric characters. This property 
-  is informational; you cannot change the identifier for existing jobs.
-  
-`model_memory_limit`::
-  (string) The approximate maximum amount of memory resources that are 
-  permitted for analytical processing. The default value for {dfanalytics-jobs} 
-  is `1gb`. If your `elasticsearch.yml` file contains an 
-  `xpack.ml.max_model_memory_limit` setting, an error occurs when you try to 
-  create {dfanalytics-jobs} that have `model_memory_limit` values greater than 
-  that setting. For more information, see <<ml-settings>>.
-
-`source`::
-  (object) The configuration of how to source the analysis data. It requires an `index`.
-  Optionally, `query` and `_source` may be specified.
-  
-  `index`:::
-    (Required, string or array) Index or indices on which to perform the 
-    analysis. It can be a single index or index pattern as well as an array of 
-    indices or patterns.
-    
-  `query`:::
-    (Optional, object) The {es} query domain-specific language 
-    (<<query-dsl,DSL>>). This value corresponds to the query object in an {es} 
-    search POST body. All the options that are supported by {es} can be used, 
-    as this object is passed verbatim to {es}. By default, this property has 
-    the following value: `{"match_all": {}}`.
-
-  `_source`:::
-    (Optional, object) Specify `includes` and/or `excludes` patterns to select
-    which fields will be present in the destination. Fields that are excluded
-    cannot be included in the analysis.
-        
-      `includes`::::
-        (array) An array of strings that defines the fields that will be included in 
-        the destination.
-          
-      `excludes`::::
-        (array) An array of strings that defines the fields that will be excluded 
-        from the destination.
-
-[[dfanalytics-types]]
-==== Analysis objects
-
-{dfanalytics-cap} resources contain `analysis` objects. For example, when you
-create a {dfanalytics-job}, you must define the type of analysis it performs.
-
-[discrete]
-[[oldetection-resources]]
-==== {oldetection-cap} configuration objects 
-
-An `outlier_detection` configuration object has the following properties:
-
-`compute_feature_influence`::
-  (boolean) If `true`, the feature influence calculation is enabled. Defaults to 
-  `true`.
-  
-`feature_influence_threshold`:: 
-  (double) The minimum {olscore} that a document needs to have in order to 
-  calculate its {fiscore}. Value range: 0-1 (`0.1` by default).
-
-`method`::
-  (string) Sets the method that {oldetection} uses. If the method is not set 
-  {oldetection} uses an ensemble of different methods and normalises and 
-  combines their individual {olscores} to obtain the overall {olscore}. We 
-  recommend to use the ensemble method. Available methods are `lof`, `ldof`, 
-  `distance_kth_nn`, `distance_knn`.
-  
-  `n_neighbors`::
-  (integer) Defines the value for how many nearest neighbors each method of 
-  {oldetection} will use to calculate its {olscore}. When the value is not set, 
-  different values will be used for different ensemble members. This helps 
-  improve diversity in the ensemble. Therefore, only override this if you are 
-  confident that the value you choose is appropriate for the data set.
-  
-`outlier_fraction`::
-  (double) Sets the proportion of the data set that is assumed to be outlying prior to 
-  {oldetection}. For example, 0.05 means it is assumed that 5% of values are real outliers 
-  and 95% are inliers.
-  
-`standardization_enabled`::
-  (boolean) If `true`, then the following operation is performed on the columns 
-  before computing outlier scores: (x_i - mean(x_i)) / sd(x_i). Defaults to 
-  `true`. For more information, see 
-  https://en.wikipedia.org/wiki/Feature_scaling#Standardization_(Z-score_Normalization)[this wiki page about standardization].
-
-
-[discrete]
-[[regression-resources]]
-==== {regression-cap} configuration objects
-
-[source,console]
---------------------------------------------------
-PUT _ml/data_frame/analytics/house_price_regression_analysis
-{
-  "source": {
-    "index": "houses_sold_last_10_yrs" <1>
-  },
-  "dest": {
-    "index": "house_price_predictions" <2>
-  },
-  "analysis": 
-    {
-      "regression": { <3>
-        "dependent_variable": "price" <4>
-      }
-    }
-}
---------------------------------------------------
-// TEST[skip:TBD]
-
-<1> Training data is taken from source index `houses_sold_last_10_yrs`.
-<2> Analysis results will be output to destination index 
-`house_price_predictions`.
-<3> The regression analysis configuration object.
-<4> Regression analysis will use field `price` to train on. As no other 
-parameters have been specified it will train on 100% of eligible data, store its 
-prediction in destination index field `price_prediction` and use in-built 
-hyperparameter optimization to give minimum validation errors.
-
-
-[float]
-[[regression-resources-standard]]
-===== Standard parameters
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=dependent_variable]
-+
---
-The data type of the field must be numeric.
---
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=prediction_field_name]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=training_percent]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=randomize_seed]
-
-
-[float]
-[[regression-resources-advanced]]
-===== Advanced parameters
-
-Advanced parameters are for fine-tuning {reganalysis}. They are set 
-automatically by <<ml-hyperparameter-optimization,hyperparameter optimization>> 
-to give minimum validation error. It is highly recommended to use the default 
-values unless you fully understand the function of these parameters. If these 
-parameters are not supplied, their values are automatically tuned to give 
-minimum validation error.
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature_bag_fraction]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=maximum_number_trees]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
-
-
-[discrete]
-[[classification-resources]]
-==== {classification-cap} configuration objects 
- 
- 
-[float]
-[[classification-resources-standard]]
-===== Standard parameters
- 
-include::{docdir}/ml/ml-shared.asciidoc[tag=dependent_variable]
-+
---
-The data type of the field must be numeric or boolean.
---
-  
-`num_top_classes`::
-  (Optional, integer) Defines the number of categories for which the predicted 
-  probabilities are reported. It must be non-negative. If it is greater than the 
-  total number of categories (in the {version} version of the {stack}, it's two) 
-  to predict then we will report all category probabilities. Defaults to 2.
- 
-include::{docdir}/ml/ml-shared.asciidoc[tag=prediction_field_name]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=training_percent]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=randomize_seed]
-
-
-[float]
-[[classification-resources-advanced]]
-===== Advanced parameters
-
-Advanced parameters are for fine-tuning {classanalysis}. They are set 
-automatically by <<ml-hyperparameter-optimization,hyperparameter optimization>> 
-to give minimum validation error. It is highly recommended to use the default 
-values unless you fully understand the function of these parameters. If these 
-parameters are not supplied, their values are automatically tuned to give 
-minimum validation error.
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature_bag_fraction]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=maximum_number_trees]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
-
-include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
-
-
-[[ml-hyperparameter-optimization]]
-===== Hyperparameter optimization
-
-If you don't supply {regression} or {classification} parameters, hyperparameter 
-optimization will be performed by default to set a value for the undefined 
-parameters. The starting point is calculated for data dependent parameters by 
-examining the loss on the training data. Subject to the size constraint, this 
-operation provides an upper bound on the improvement in validation loss.
-
-A fixed number of rounds is used for optimization which depends on the number of 
-parameters being optimized. The optimization starts with random search, then 
-Bayesian optimization is performed that is targeting maximum expected 
-improvement. If you override any parameters, then the optimization will 
-calculate the value of the remaining parameters accordingly and use the value 
-you provided for the overridden parameter. The number of rounds are reduced 
-respectively. The validation error is estimated in each round by using 4-fold 
-cross validation.
diff --git a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
index 4576f465a7604..bcba82992d154 100644
--- a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
@@ -12,6 +12,7 @@ Evaluates the {dfanalytics} for an annotated index.
 
 experimental[]
 
+
 [[ml-evaluate-dfanalytics-request]]
 ==== {api-request-title}
 
@@ -37,26 +38,113 @@ result field to be present.
 [[ml-evaluate-dfanalytics-request-body]]
 ==== {api-request-body-title}
 
-`index`::
-  (Required, object) Defines the `index` in which the evaluation will be
-  performed.
-
-`query`::
-  (Optional, object) A query clause that retrieves a subset of data from the 
-  source index. See <<query-dsl>>.
-
 `evaluation`::
-  (Required, object) Defines the type of evaluation you want to perform. See 
-  <<ml-evaluate-dfanalytics-resources>>.
+(Required, object) Defines the type of evaluation you want to perform. The 
+value of this object can be different depending on the type of evaluation you 
+want to perform. See <<ml-evaluate-dfanalytics-resources>>.
 +
 --
 Available evaluation types:
-
 * `binary_soft_classification`
 * `regression`
 * `classification`
 --
 
+`index`::
+(Required, object) Defines the `index` in which the evaluation will be
+performed.
+
+`query`::
+(Optional, object) A query clause that retrieves a subset of data from the 
+source index. See <<query-dsl>>.
+
+[[ml-evaluate-dfanalytics-resources]]
+==== {dfanalytics-cap} evaluation resources
+
+[[binary-sc-resources]]
+===== Binary soft classification configuration objects
+
+Binary soft classification evaluates the results of an analysis which outputs 
+the probability that each document belongs to a certain class. For example, in 
+the context of {oldetection}, the analysis outputs the probability whether each 
+document is an outlier.
+
+`actual_field`::
+  (Required, string) The field of the `index` which contains the `ground truth`. 
+  The data type of this field can be boolean or integer. If the data type is 
+  integer, the value has to be either `0` (false) or `1` (true).
+
+`predicted_probability_field`::
+  (Required, string) The field of the `index` that defines the probability of 
+  whether the item belongs to the class in question or not. It's the field that 
+  contains the results of the analysis.
+
+`metrics`::
+  (Optional, object) Specifies the metrics that are used for the evaluation. 
+  Available metrics:
+  
+  `auc_roc`::
+    (Optional, object) The AUC ROC (area under the curve of the receiver 
+    operating characteristic) score and optionally the curve. Default value is 
+    {"includes_curve": false}.
+    
+  `precision`::
+    (Optional, object) Set the different thresholds of the {olscore} at where 
+    the metric is calculated. Default value is {"at": [0.25, 0.50, 0.75]}.
+  
+  `recall`::
+    (Optional, object) Set the different thresholds of the {olscore} at where 
+    the metric is calculated. Default value is {"at": [0.25, 0.50, 0.75]}.
+  
+  `confusion_matrix`::
+    (Optional, object) Set the different thresholds of the {olscore} at where 
+    the metrics (`tp` - true positive, `fp` - false positive, `tn` - true 
+    negative, `fn` - false negative) are calculated. Default value is 
+    {"at": [0.25, 0.50, 0.75]}.
+
+    
+[[regression-evaluation-resources]]
+===== {regression-cap} evaluation objects
+
+{regression-cap} evaluation evaluates the results of a {regression} analysis 
+which outputs a prediction of values.
+
+`actual_field`::
+  (Required, string) The field of the `index` which contains the `ground truth`. 
+  The data type of this field must be numerical.
+  
+`predicted_field`::
+  (Required, string) The field in the `index` that contains the predicted value, 
+  in other words the results of the {regression} analysis.
+  
+`metrics`::
+  (Required, object) Specifies the metrics that are used for the evaluation. 
+  Available metrics are `r_squared` and `mean_squared_error`.
+  
+  
+[[classification-evaluation-resources]]
+==== {classification-cap} evaluation objects
+
+{classification-cap} evaluation evaluates the results of a {classanalysis} which 
+outputs a prediction that identifies to which of the classes each document 
+belongs.
+
+`actual_field`::
+  (Required, string) The field of the `index` which contains the ground truth. 
+  The data type of this field must be keyword.
+  
+`metrics`::
+  (Required, object) Specifies the metrics that are used for the evaluation. 
+  Available metric is `multiclass_confusion_matrix`.
+  
+`predicted_field`::
+  (Required, string) The field in the `index` that contains the predicted value, 
+  in other words the results of the {classanalysis}. The data type of this field 
+  is string. You need to add `.keyword` to the predicted field name (the name 
+  you put in the {classanalysis} object as `prediction_field_name` or the 
+  default value of the same field if you didn't specified explicitly). For 
+  example, `predicted_field` : `ml.animal_class_prediction.keyword`.
+
 
 ////
 [[ml-evaluate-dfanalytics-results]]
@@ -75,6 +163,7 @@ Available evaluation types:
 `recall`::: TBD
 ////
 
+
 [[ml-evaluate-dfanalytics-example]]
 ==== {api-examples-title}
 
diff --git a/docs/reference/ml/df-analytics/apis/evaluateresources.asciidoc b/docs/reference/ml/df-analytics/apis/evaluateresources.asciidoc
deleted file mode 100644
index a9f7d654c2756..0000000000000
--- a/docs/reference/ml/df-analytics/apis/evaluateresources.asciidoc
+++ /dev/null
@@ -1,128 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-evaluate-dfanalytics-resources]]
-=== {dfanalytics-cap} evaluation resources
-
-Evaluation configuration objects relate to the <<evaluate-dfanalytics>>.
-
-[discrete]
-[[ml-evaluate-dfanalytics-properties]]
-==== {api-definitions-title}
-
-`evaluation`::
-  (object) Defines the type of evaluation you want to perform. The value of this 
-  object can be different depending on the type of evaluation you want to 
-  perform.
-+
---
-Available evaluation types:
-* `binary_soft_classification`
-* `regression`
-* `classification`
---
-  
-`query`::
-  (object) A query clause that retrieves a subset of data from the source index. 
-  See <<query-dsl>>. The evaluation only applies to those documents of the index 
-  that match the query.
-
-
-[[binary-sc-resources]]
-==== Binary soft classification configuration objects
-
-Binary soft classification evaluates the results of an analysis which outputs 
-the probability that each document belongs to a certain class. For 
-example, in the context of outlier detection, the analysis outputs the 
-probability whether each document is an outlier.
-
-[discrete]
-[[binary-sc-resources-properties]]
-===== {api-definitions-title}
-
-`actual_field`::
-  (string) The field of the `index` which contains the `ground truth`. 
-  The data type of this field can be boolean or integer. If the data type is 
-  integer, the value has to be either `0` (false) or `1` (true).
-
-`predicted_probability_field`::
-  (string) The field of the `index` that defines the probability of 
-  whether the item belongs to the class in question or not. It's the field that 
-  contains the results of the analysis.
-
-`metrics`::
-  (object) Specifies the metrics that are used for the evaluation. 
-  Available metrics:
-  
-  `auc_roc`::
-    (object) The AUC ROC (area under the curve of the receiver operating 
-    characteristic) score and optionally the curve.
-    Default value is {"includes_curve": false}.
-    
-  `precision`::
-    (object) Set the different thresholds of the {olscore} at where the metric 
-    is calculated.
-    Default value is {"at": [0.25, 0.50, 0.75]}.
-  
-  `recall`::
-    (object) Set the different thresholds of the {olscore} at where the metric 
-    is calculated.
-    Default value is {"at": [0.25, 0.50, 0.75]}.
-  
-  `confusion_matrix`::
-    (object) Set the different thresholds of the {olscore} at where the metrics 
-    (`tp` - true positive, `fp` - false positive, `tn` - true negative, `fn` - 
-    false negative) are calculated.
-    Default value is {"at": [0.25, 0.50, 0.75]}.
-
-    
-[[regression-evaluation-resources]]
-==== {regression-cap} evaluation objects
-
-{regression-cap} evaluation evaluates the results of a {regression} analysis 
-which outputs a prediction of values.
-
-
-[discrete]
-[[regression-evaluation-resources-properties]]
-===== {api-definitions-title}
-
-`actual_field`::
-  (string) The field of the `index` which contains the `ground truth`. The data 
-  type of this field must be numerical.
-  
-`predicted_field`::
-  (string) The field in the `index` that contains the predicted value, 
-  in other words the results of the {regression} analysis.
-  
-`metrics`::
-  (object) Specifies the metrics that are used for the evaluation. Available 
-  metrics are `r_squared` and `mean_squared_error`.
-  
-  
-[[classification-evaluation-resources]]
-==== {classification-cap} evaluation objects
-
-{classification-cap} evaluation evaluates the results of a {classanalysis} which 
-outputs a prediction that identifies to which of the classes each document 
-belongs.
-
-
-[discrete]
-[[classification-evaluation-resources-properties]]
-===== {api-definitions-title}
-
-`actual_field`::
-  (string) The field of the `index` which contains the ground truth. The data 
-  type of this field must be keyword.
-  
-`metrics`::
-  (object) Specifies the metrics that are used for the evaluation. Available 
-  metric is `multiclass_confusion_matrix`.
-  
-`predicted_field`::
-  (string) The field in the `index` that contains the predicted value, in other 
-  words the results of the {classanalysis}. The data type of this field is 
-  string. You need to add `.keyword` to the predicted field name (the name you 
-  put in the {classanalysis} object as `prediction_field_name` or the default 
-  value of the same field if you didn't specified explicitly). For example, 
-  `predicted_field` : `ml.animal_class_prediction.keyword`.
\ No newline at end of file
diff --git a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
index fb867b53ce165..980e2aa7d3fbb 100644
--- a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
@@ -12,6 +12,7 @@ Explains a {dataframe-analytics-config}.
 
 experimental[]
 
+
 [[ml-explain-dfanalytics-request]]
 ==== {api-request-title}
 
@@ -23,22 +24,28 @@ experimental[]
 
 `POST _ml/data_frame/analytics/<data_frame_analytics_id>/_explain`
 
+
 [[ml-explain-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
 * You must have `monitor_ml` privilege to use this API. For more
 information, see <<security-privileges>> and <<built-in-roles>>.
 
+
 [[ml-explain-dfanalytics-desc]]
 ==== {api-description-title}
 
-This API provides explanations for a {dataframe-analytics-config} that either exists already or one that has not been created yet.
+This API provides explanations for a {dataframe-analytics-config} that either 
+exists already or one that has not been created yet.
 The following explanations are provided:
 
-* which fields are included or not in the analysis and why
-* how much memory is estimated to be required. The estimate can be used when deciding the appropriate value for `model_memory_limit` setting later on.
+* which fields are included or not in the analysis and why,
+* how much memory is estimated to be required. The estimate can be used when 
+  deciding the appropriate value for `model_memory_limit` setting later on,
+
 about either an existing {dfanalytics-job} or one that has not been created yet.
 
+
 [[ml-explain-dfanalytics-path-params]]
 ==== {api-path-parms-title}
 
@@ -46,13 +53,14 @@ about either an existing {dfanalytics-job} or one that has not been created yet.
 (Optional, string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
 
+
 [[ml-explain-dfanalytics-request-body]]
 ==== {api-request-body-title}
 
 `data_frame_analytics_config`::
-  (Optional, object) Intended configuration of {dfanalytics-job}. For more information, see
-  <<ml-dfanalytics-resources>>.
-  Note that `id` and `dest` don't need to be provided in the context of this API.
+  (Optional, object) Intended configuration of {dfanalytics-job}. Note that `id` 
+  and `dest` don't need to be provided in the context of this API.
+
 
 [[ml-explain-dfanalytics-results]]
 ==== {api-response-body-title}
@@ -60,38 +68,13 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
 The API returns a response that contains the following:
 
 `field_selection`::
-  (array) An array of objects that explain selection for each field, sorted by the field names.
-   Each object in the array has the following properties:
-
-  `name`:::
-    (string) The field name.
-
-  `mapping_types`:::
-    (string) The mapping types of the field.
-
-  `is_included`:::
-    (boolean) Whether the field is selected to be included in the analysis.
-
-  `is_required`:::
-    (boolean) Whether the field is required.
-
-  `feature_type`:::
-    (string) The feature type of this field for the analysis. May be `categorical` or `numerical`.
-
-  `reason`:::
-    (string) The reason a field is not selected to be included in the analysis.
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=field-selection]
 
 `memory_estimation`::
-  (object) An object containing the memory estimates. The object has the following properties:
-
-  `expected_memory_without_disk`:::
-    (string) Estimated memory usage under the assumption that the whole {dfanalytics} should happen in memory
-    (i.e. without overflowing to disk).
+(object) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=memory-estimation]
 
-  `expected_memory_with_disk`:::
-    (string) Estimated memory usage under the assumption that overflowing to disk is allowed during {dfanalytics}.
-    `expected_memory_with_disk` is usually smaller than `expected_memory_without_disk` as using disk allows to
-    limit the main memory needed to perform {dfanalytics}.
 
 [[ml-explain-dfanalytics-example]]
 ==== {api-examples-title}
@@ -114,6 +97,7 @@ POST _ml/data_frame/analytics/_explain
 --------------------------------------------------
 // TEST[skip:TBD]
 
+
 The API returns the following results:
 
 [source,console-result]
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
index dcdb66689936f..91c022e9b64b1 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
@@ -48,12 +48,12 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-default]
 include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 
 `from`::
-  (Optional, integer) Skips the specified number of {dfanalytics-jobs}. The
-  default value is `0`.
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=from]
 
 `size`::
-  (Optional, integer) Specifies the maximum number of {dfanalytics-jobs} to
-  obtain. The default value is `100`.
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=size]
 
 
 [[ml-get-dfanalytics-stats-response-body]]
@@ -62,25 +62,8 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 The API returns the following information:
 
 `data_frame_analytics`::
-  (array) An array of statistics objects for {dfanalytics-jobs}, which are
-  sorted by the `id` value in ascending order.
-  
-  `id`::
-    (string) The unique identifier of the {dfanalytics-job}.
-    
-  `state`::
-    (string) Current state of the {dfanalytics-job}.
-    
-  `progress`::
-    (array) The progress report of the {dfanalytics-job} by phase.
-    
-    `phase`::
-      (string) Defines the phase of the {dfanalytics-job}. Possible phases: 
-      `reindexing`, `loading_data`, `analyzing`, and `writing_results`.
-      
-    `progress_percent`::
-      (integer) The progress that the {dfanalytics-job} has made expressed in 
-      percentage.
+(array) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=data-frame-analytics-stats]
 
 
 [[ml-get-dfanalytics-stats-response-codes]]
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
index fda6039f88cf3..816135fb62263 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
@@ -11,6 +11,7 @@ Retrieves configuration information for {dfanalytics-jobs}.
 
 experimental[]
 
+
 [[ml-get-dfanalytics-request]]
 ==== {api-request-title}
 
@@ -22,11 +23,13 @@ experimental[]
 
 `GET _ml/data_frame/analytics/_all`
 
+
 [[ml-get-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `monitor_ml` privilege to use this API. For more 
-information, see <<security-privileges>> and <<built-in-roles>>.
+* You must have `monitor_ml` privilege to use this API. For more information, 
+see <<security-privileges>> and <<built-in-roles>>.
+
 
 [[ml-get-dfanalytics-desc]]
 ==== {api-description-title}
@@ -34,47 +37,44 @@ information, see <<security-privileges>> and <<built-in-roles>>.
 You can get information for multiple {dfanalytics-jobs} in a single API request 
 by using a comma-separated list of {dfanalytics-jobs} or a wildcard expression.
 
+
 [[ml-get-dfanalytics-path-params]]
 ==== {api-path-parms-title}
 
 `<data_frame_analytics_id>`::
-  (Optional, string) Identifier for the {dfanalytics-job}. If you do not specify
-  one of these options, the API returns information for the first hundred
-  {dfanalytics-jobs}. You can get information for all {dfanalytics-jobs} by 
-  using _all, by specifying `*` as the `<data_frame_analytics_id>`, or by 
-  omitting the `<data_frame_analytics_id>`.
+(Optional, string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-default]
++
+--
+You can get information for all {dfanalytics-jobs} by using _all, by specifying 
+`*` as the `<data_frame_analytics_id>`, or by omitting the 
+`<data_frame_analytics_id>`.
+--
+
 
 [[ml-get-dfanalytics-query-params]]
 ==== {api-query-parms-title}
 
 `allow_no_match`::
-  (Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no {dfanalytics-jobs} that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
-
-The default value is `true`, which returns an empty `data_frame_analytics` array 
-when there are no matches and the subset of results when there are partial 
-matches. If this parameter is `false`, the request returns a `404` status code 
-when there are no matches or only partial matches.
---
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 
 `from`::
-  (Optional, integer) Skips the specified number of {dfanalytics-jobs}. The
-  default value is `0`.
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=from]
 
 `size`::
-  (Optional, integer) Specifies the maximum number of {dfanalytics-jobs} to 
-  obtain. The default value is `100`.
-  
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=size]
+
+
 [[ml-get-dfanalytics-results]]
 ==== {api-response-body-title}
 
 `data_frame_analytics`::
-  (array) An array of {dfanalytics-job} resources. For more information, see
-  <<ml-dfanalytics-resources>>.
+(array) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=data-frame-analytics]
+
 
 [[ml-get-dfanalytics-response-codes]]
 ==== {api-response-codes-title}
@@ -83,6 +83,7 @@ when there are no matches or only partial matches.
   If `allow_no_match` is `false`, this code indicates that there are no
   resources that match the request or only partial matches for the request.
 
+
 [[ml-get-dfanalytics-example]]
 ==== {api-examples-title}
 
diff --git a/docs/reference/ml/df-analytics/apis/index.asciidoc b/docs/reference/ml/df-analytics/apis/index.asciidoc
index 6bf63e7ddb8c0..bebd6d3aae820 100644
--- a/docs/reference/ml/df-analytics/apis/index.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/index.asciidoc
@@ -14,6 +14,8 @@ You can use the following APIs to perform {ml} {dfanalytics} activities.
 * <<evaluate-dfanalytics,Evaluate {dfanalytics}>>
 * <<explain-dfanalytics,Explain {dfanalytics}>>
 
+For the `analysis` object resources, check <<ml-dfa-analysis-objects>>.
+
 See also <<ml-apis>>.
 
 //CREATE
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index 123eb6633e37b..d549e6824002e 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -93,91 +93,55 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
 ==== {api-request-body-title}
 
 `analysis`::
-  (Required, object) Defines the type of {dfanalytics} you want to perform on 
-  your source index. For example: `outlier_detection`. See 
-  <<dfanalytics-types>>.
+(Required, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=analysis]
   
 `analyzed_fields`::
-  (Optional, object) Specify `includes` and/or `excludes` patterns to select
-  which fields will be included in the analysis. If `analyzed_fields` is not 
-  set, only the relevant fields will be included. For example, all the numeric 
-  fields for {oldetection}. For the supported field types, see 
-  <<ml-put-dfanalytics-supported-fields>>. Also see the <<explain-dfanalytics>> 
-  which helps understand field selection.
-
-  `includes`:::
-    (Optional, array) An array of strings that defines the fields that will be 
-    included in the analysis.
-    
-  `excludes`:::
-    (Optional, array) An array of strings that defines the fields that will be 
-    excluded from the analysis. You do not need to add fields with unsupported 
-    data types to `excludes`, these fields are excluded from the analysis 
-    automatically.
+(Optional, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=analyzed-fields]
+
+[source,console]
+--------------------------------------------------
+PUT _ml/data_frame/analytics/loganalytics
+{
+  "source": {
+    "index": "logdata"
+  },
+  "dest": {
+    "index": "logdata_out"
+  },
+  "analysis": {
+    "outlier_detection": {
+    }
+  },
+  "analyzed_fields": {
+        "includes": [ "request.bytes", "response.counts.error" ],
+        "excludes": [ "source.geo" ]
+  }
+}
+--------------------------------------------------
+// TEST[setup:setup_logdata]
+
 
 `description`::
-  (Optional, string) A description of the job.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=description-dfa]
 
 `dest`::
-  (Required, object) The destination configuration, consisting of `index` and 
-  optionally `results_field` (`ml` by default).
-  
-    `index`:::
-      (Required, string) Defines the _destination index_ to store the results of 
-      the {dfanalytics-job}.
-    
-    `results_field`:::
-      (Optional, string) Defines the name of the field in which to store the 
-      results of the analysis. Default to `ml`.
+(Required, object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=dest]
   
 `model_memory_limit`::
-  (Optional, string) The approximate maximum amount of memory resources that are 
-  permitted for analytical processing. The default value for {dfanalytics-jobs} 
-  is `1gb`. If your `elasticsearch.yml` file contains an 
-  `xpack.ml.max_model_memory_limit` setting, an error occurs when you try to 
-  create {dfanalytics-jobs} that have `model_memory_limit` values greater than 
-  that setting. For more information, see <<ml-settings>>.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit-dfa]
   
 `source`::
-  (object) The configuration of how to source the analysis data. It requires an 
-  `index`. Optionally, `query` and `_source` may be specified.
-  
-  `index`:::
-    (Required, string or array) Index or indices on which to perform the 
-    analysis. It can be a single index or index pattern as well as an array of 
-    indices or patterns.
-    
-  `query`:::
-    (Optional, object) The {es} query domain-specific language 
-    (<<query-dsl,DSL>>). This value corresponds to the query object in an {es} 
-    search POST body. All the options that are supported by {es} can be used, 
-    as this object is passed verbatim to {es}. By default, this property has 
-    the following value: `{"match_all": {}}`.
-
-  `_source`:::
-    (Optional, object) Specify `includes` and/or `excludes` patterns to select
-    which fields will be present in the destination. Fields that are excluded
-    cannot be included in the analysis.
-        
-      `includes`::::
-        (array) An array of strings that defines the fields that will be 
-        included in the destination.
-          
-      `excludes`::::
-        (array) An array of strings that defines the fields that will be 
-        excluded from the destination.
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=source-put-dfa]
 
 `allow_lazy_start`::
-  (Optional, boolean) Whether this job should be allowed to start when there
-  is insufficient {ml} node capacity for it to be immediately assigned to a node.
-  The default is `false`, which means that the <<start-dfanalytics>>
-  will return an error if a {ml} node with capacity to run the
-  job cannot immediately be found. (However, this is also subject to
-  the cluster-wide `xpack.ml.max_lazy_ml_nodes` setting - see
-  <<advanced-ml-settings>>.) If this option is set to `true` then
-  the <<start-dfanalytics>> will not return an error, and the job will
-  wait in the `starting` state until sufficient {ml} node capacity
-  is available.
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-start]
 
 
 [[ml-put-dfanalytics-example]]
@@ -405,9 +369,10 @@ PUT _ml/data_frame/analytics/student_performance_mathematics_0.3
 --------------------------------------------------
 // TEST[skip:TBD]
 
-<1> The `training_percent` defines the percentage of the data set that will be used 
-for training the model.
-<2> The `randomize_seed` is the seed used to randomly pick which data is used for training.
+<1> The `training_percent` defines the percentage of the data set that will be 
+used for training the model.
+<2> The `randomize_seed` is the seed used to randomly pick which data is used 
+for training.
 
 
 [[ml-put-dfanalytics-example-c]]
diff --git a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
index ba8b4169034a4..6e1fd7ffe1a44 100644
--- a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
@@ -36,8 +36,8 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
 ==== {api-query-parms-title}
 
 `timeout`::
-  (Optional, time) Controls the amount of time to wait until the
-  {dfanalytics-job} starts. The default value is 20 seconds.
+(Optional, <<time-units,time units>>) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=timeout-start]
 
 [[ml-start-dfanalytics-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
index ce3a932f1b07d..7ea707b9d1b7f 100644
--- a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
@@ -49,16 +49,16 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
 ==== {api-query-parms-title}  
   
 `allow_no_match`::
-  (Optional, boolean) If `false` and the `data_frame_analytics_id` does not
-  match any {dfanalytics-job} an error will be returned. The default value is
-  `true`.
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
+
 
 `force`::
   (Optional, boolean) If true, the {dfanalytics-job} is stopped forcefully.
   
 `timeout`::
-  (Optional, time) Controls the amount of time to wait until the
-  {dfanalytics-job} stops. The default value is 20 seconds.
+(Optional, <<time-units,time units>>) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=timeout-stop]
 
 
 [[ml-stop-dfanalytics-example]]
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 65fd370dda9ad..c13b4e903b91e 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -8,7 +8,8 @@ end::aggregations[]
 tag::allow-lazy-open[]
 Advanced configuration option. Specifies whether this job can open when there is 
 insufficient {ml} node capacity for it to be immediately assigned to a node. The
-default value is `false`; if a {ml} node with capacity to run the job cannot immediately be found, the <<ml-open-job,open {anomaly-jobs} API>> returns an
+default value is `false`; if a {ml} node with capacity to run the job cannot 
+immediately be found, the <<ml-open-job,open {anomaly-jobs} API>> returns an 
 error. However, this is also subject to the cluster-wide 
 `xpack.ml.max_lazy_ml_nodes` setting; see <<advanced-ml-settings>>. If this
 option is set to `true`, the <<ml-open-job,open {anomaly-jobs} API>> does not
@@ -16,6 +17,18 @@ return an error and the job waits in the `opening` state until sufficient {ml}
 node capacity is available.
 end::allow-lazy-open[]
 
+
+tag::allow-lazy-start[]
+Whether this job should be allowed to start when there is insufficient {ml} node 
+capacity for it to be immediately assigned to a node. The default is `false`, 
+which means that the <<start-dfanalytics>> will return an error if a {ml} node 
+with capacity to run the job cannot immediately be found. (However, this is also 
+subject to the cluster-wide `xpack.ml.max_lazy_ml_nodes` setting - see 
+<<advanced-ml-settings>>.) If this option is set to `true` then the 
+<<start-dfanalytics>> will not return an error, and the job will wait in the 
+`starting` state until sufficient {ml} node capacity is available.
+end::allow-lazy-start[]
+
 tag::allow-no-datafeeds[]
 Specifies what to do when the request:
 +
@@ -61,10 +74,16 @@ when there are no matches or only partial matches.
 --
 end::allow-no-match[]
 
+tag::analysis[]
+Defines the type of {dfanalytics} you want to perform on your source index. For 
+example: `outlier_detection`. See <<ml-dfa-analysis-objects>>.
+end::analysis[]
+
 tag::analysis-config[]
 The analysis configuration, which specifies how to analyze the data.
 After you create a job, you cannot change the analysis configuration; all
-the properties are informational. An analysis configuration object has the following properties:
+the properties are informational. An analysis configuration object has the 
+following properties:
 
 `bucket_span`:::
 (<<time-units,time units>>)
@@ -128,6 +147,25 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-examples-limit]
 include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
 end::analysis-limits[]
 
+tag::analyzed-fields[]
+Specify `includes` and/or `excludes` patterns to select which fields will be 
+included in the analysis. If `analyzed_fields` is not set, only the relevant 
+fields will be included. For example, all the numeric fields for {oldetection}. 
+For the supported field types, see <<ml-put-dfanalytics-supported-fields>>. Also 
+see the <<explain-dfanalytics>> which helps understand field selection.
+
+`includes`:::
+  (Optional, array) An array of strings that defines the fields that will be 
+  included in the analysis.
+  
+`excludes`:::
+  (Optional, array) An array of strings that defines the fields that will be 
+  excluded from the analysis. You do not need to add fields with unsupported 
+  data types to `excludes`, these fields are excluded from the analysis 
+  automatically.
+end::analyzed-fields[]
+
+
 tag::background-persist-interval[]
 Advanced configuration option. The time between each periodic persistence of the 
 model. The default value is a randomized value between 3 to 4 hours, which
@@ -208,7 +246,9 @@ tag::categorization-filters[]
 If `categorization_field_name` is specified, you can also define optional
 filters. This property expects an array of regular expressions. The expressions
 are used to filter out matching sequences from the categorization field values.
-You can use this functionality to fine tune the categorization by excluding sequences from consideration when categories are defined. For example, you can exclude SQL statements that appear in your log files. For more information, see
+You can use this functionality to fine tune the categorization by excluding 
+sequences from consideration when categories are defined. For example, you can 
+exclude SQL statements that appear in your log files. For more information, see 
 {stack-ov}/ml-configuring-categories.html[Categorizing log messages]. This
 property cannot be used at the same time as `categorization_analyzer`. If you
 only want to define simple regular expression filters that are applied prior to 
@@ -229,6 +269,11 @@ add them here as
 <<analysis-pattern-replace-charfilter,pattern replace character filters>>.
 end::char-filter[]
 
+
+tag::compute-feature-influence[]
+If `true`, the feature influence calculation is enabled. Defaults to `true`.
+end::compute-feature-influence[]
+
 tag::chunking-config[]
 {dfeeds-cap} might be required to search over long time periods, for several months
 or years. This search is split into time chunks in order to ensure the load
@@ -280,7 +325,8 @@ to an object with the following properties:
 
 `filter_type`:::
 (string) Either `include` (the rule applies for values in the filter) or
-`exclude` (the rule applies for values not in the filter). Defaults to `include`.
+`exclude` (the rule applies for values not in the filter). Defaults to 
+`include`.
 
 `conditions`::
 (array) An optional array of numeric conditions when the rule applies. A rule
@@ -339,6 +385,92 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=time-format]
 --
 end::data-description[]
 
+tag::data-frame-analytics[]
+An array of {dfanalytics-job} resources, which are sorted by the `id` value in 
+ascending order.
+
+`id`:::
+(string) The unique identifier of the {dfanalytics-job}.
+
+`source`:::
+(object) The configuration of how the analysis data is sourced. It has an 
+`index` parameter and optionally a `query` and a `_source`.
+  
+`index`::::
+(array) Index or indices on which to perform the analysis. It can be a single 
+index or index pattern as well as an array of indices or patterns.
+    
+`query`::::
+(object) The query that has been specified for the {dfanalytics-job}. The {es} 
+query domain-specific language (<<query-dsl,DSL>>). This value corresponds to 
+the query object in an {es} search POST body. By default, this property has the 
+following value: `{"match_all": {}}`.
+
+`_source`::::
+(object) Contains the specified `includes` and/or `excludes` patterns that 
+select which fields are present in the destination. Fields that are excluded 
+cannot be included in the analysis.
+        
+`includes`:::::
+(array) An array of strings that defines the fields that are included in the 
+destination.
+          
+`excludes`:::::
+(array) An array of strings that defines the fields that are excluded from the 
+destination.
+
+`dest`:::
+(string) The destination configuration of the analysis.
+
+`index`::::
+(string) The _destination index_ that stores the results of the 
+{dfanalytics-job}.
+
+`results_field`::::
+(string) The name of the field that stores the results of the analysis. Defaults 
+to `ml`.
+
+`analysis`:::
+(object) The type of analysis that is performed on the `source`.
+
+`analyzed_fields`:::
+(object) Contains `includes` and/or `excludes` patterns that select which fields 
+are included in the analysis.
+    
+`includes`::::
+(Optional, array) An array of strings that defines the fields that are included 
+in the analysis.
+      
+`excludes`::::
+(Optional, array) An array of strings that defines the fields that are excluded 
+from the analysis.
+
+`model_memory_limit`:::
+(string) The `model_memory_limit` that has been set to the {dfanalytics-job}.
+end::data-frame-analytics[]
+
+tag::data-frame-analytics-stats[]
+An array of statistics objects for {dfanalytics-jobs}, which are
+sorted by the `id` value in ascending order.
+
+`id`:::
+(string) The unique identifier of the {dfanalytics-job}.
+  
+`state`:::
+(string) Current state of the {dfanalytics-job}.
+  
+`progress`:::
+(array) The progress report of the {dfanalytics-job} by phase.
+  
+`phase`:::
+(string) Defines the phase of the {dfanalytics-job}. Possible phases: 
+`reindexing`, `loading_data`, `analyzing`, and `writing_results`.
+    
+`progress_percent`:::
+(integer) The progress that the {dfanalytics-job} has made expressed in 
+percentage.
+end::data-frame-analytics-stats[]
+
 tag::datafeed-id[]
 A numerical character string that uniquely identifies the
 {dfeed}. This identifier can contain lowercase alphanumeric characters (a-z
@@ -380,14 +512,30 @@ calculation is based on the maximum of `2h` or `8 * bucket_span`.
 --
 end::delayed-data-check-config[]
 
-tag::dependent_variable[]
-`dependent_variable`::
-(Required, string) Defines which field of the document is to be predicted. 
+tag::dependent-variable[]
+Defines which field of the document is to be predicted.
 This parameter is supplied by field name and must match one of the fields in 
 the index being used to train. If this field is missing from a document, then 
 that document will not be used for training, but a prediction with the trained 
 model will be generated for it. It is also known as continuous target variable.
-end::dependent_variable[]
+end::dependent-variable[]
+
+tag::description-dfa[]
+A description of the job.
+end::description-dfa[]
+
+tag::dest[]
+The destination configuration, consisting of `index` and 
+optionally `results_field` (`ml` by default).
+
+  `index`:::
+    (Required, string) Defines the _destination index_ to store the results of 
+    the {dfanalytics-job}.
+  
+  `results_field`:::
+    (Optional, string) Defines the name of the field in which to store the 
+    results of the analysis. Default to `ml`.
+end::dest[]
 
 tag::detector-description[]
 A description of the detector. For example, `Low event rate`.
@@ -455,8 +603,7 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=use-null]
 end::detector[]
 
 tag::eta[]
-`eta`::
-(Optional, double) The shrinkage applied to the weights. Smaller values result 
+The shrinkage applied to the weights. Smaller values result 
 in larger forests which have better generalization error. However, the smaller 
 the value the longer the training will take. For more information, see 
 https://en.wikipedia.org/wiki/Gradient_boosting#Shrinkage[this wiki article] 
@@ -471,11 +618,39 @@ working with both over and by fields, then you can set `exclude_frequent` to
 `all` for both fields, or to `by` or `over` for those specific fields.
 end::exclude-frequent[]
 
-tag::feature_bag_fraction[]
-`feature_bag_fraction`::
-(Optional, double) Defines the fraction of features that will be used when 
+tag::feature-bag-fraction[]
+Defines the fraction of features that will be used when 
 selecting a random bag for each candidate split. 
-end::feature_bag_fraction[]
+end::feature-bag-fraction[]
+
+tag::feature-influence-threshold[]
+The minimum {olscore} that a document needs to have in order to calculate its 
+{fiscore}. Value range: 0-1 (`0.1` by default).
+end::feature-influence-threshold[]
+
+tag::field-selection[]
+An array of objects that explain selection for each field, sorted by 
+the field names. Each object in the array has the following properties:
+
+`name`:::
+(string) The field name.
+
+`mapping_types`:::
+(string) The mapping types of the field.
+
+`is_included`:::
+(boolean) Whether the field is selected to be included in the analysis.
+
+`is_required`:::
+(boolean) Whether the field is required.
+
+`feature_type`:::
+(string) The feature type of this field for the analysis. May be `categorical` 
+or `numerical`.
+
+`reason`:::
+(string) The reason a field is not selected to be included in the analysis.
+end::field-selection[]
 
 tag::filter[]
 One or more <<analysis-tokenfilters,token filters>>. In addition to the built-in 
@@ -491,6 +666,10 @@ for longer bucket spans, a sensible fraction of the bucket span. For example:
 `150s`.
 end::frequency[]
 
+tag::from[]
+Skips the specified number of {dfanalytics-jobs}. The default value is `0`.
+end::from[]
+
 tag::function[]
 The analysis function that is used. For example, `count`, `rare`, `mean`, `min`, 
 `max`, and `sum`. For more information, see
@@ -498,8 +677,7 @@ The analysis function that is used. For example, `count`, `rare`, `mean`, `min`,
 end::function[]
 
 tag::gamma[]
-`gamma`::
-(Optional, double) Regularization parameter to prevent overfitting on the 
+Regularization parameter to prevent overfitting on the 
 training dataset. Multiplies a linear penalty associated with the size of 
 individual trees in the forest. The higher the value the more training will 
 prefer smaller trees. The smaller this parameter the larger individual trees 
@@ -538,7 +716,9 @@ Identifier for the {dfanalytics-job}.
 end::job-id-data-frame-analytics[]
 
 tag::job-id-anomaly-detection-default[]
-Identifier for the {anomaly-job}. It can be a job identifier, a group name, or a wildcard expression. If you do not specify one of these options, the API returns information for all {anomaly-jobs}.
+Identifier for the {anomaly-job}. It can be a job identifier, a group name, or a 
+wildcard expression. If you do not specify one of these options, the API returns 
+information for all {anomaly-jobs}.
 end::job-id-anomaly-detection-default[]
 
 tag::job-id-data-frame-analytics-default[]
@@ -552,7 +732,8 @@ identifier, a group name, or a comma-separated list of jobs or groups.
 end::job-id-anomaly-detection-list[]
 
 tag::job-id-anomaly-detection-wildcard[]
-Identifier for the {anomaly-job}. It can be a job identifier, a group name, or a wildcard expression.
+Identifier for the {anomaly-job}. It can be a job identifier, a group name, or a 
+wildcard expression.
 end::job-id-anomaly-detection-wildcard[]
 
 tag::job-id-anomaly-detection-wildcard-list[]
@@ -561,9 +742,9 @@ comma-separated list of jobs or groups, or a wildcard expression.
 end::job-id-anomaly-detection-wildcard-list[]
 
 tag::job-id-anomaly-detection-define[]
-Identifier for the {anomaly-job}. This identifier can contain lowercase alphanumeric
-characters (a-z and 0-9), hyphens, and underscores. It must start and end with
-alphanumeric characters.
+Identifier for the {anomaly-job}. This identifier can contain lowercase 
+alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start 
+and end with alphanumeric characters.
 end::job-id-anomaly-detection-define[]
 
 tag::job-id-data-frame-analytics-define[]
@@ -577,8 +758,7 @@ The unique identifier for the job to which the {dfeed} sends data.
 end::job-id-datafeed[]
 
 tag::lambda[]
-`lambda`::
-(Optional, double) Regularization parameter to prevent overfitting on the 
+Regularization parameter to prevent overfitting on the 
 training dataset. Multiplies an L2 regularisation term which applies to leaf 
 weights of the individual trees in the forest. The higher the value the more 
 training will attempt to keep leaf weights small. This makes the prediction  
@@ -589,7 +769,9 @@ end::lambda[]
 
 tag::latency[]
 The size of the window in which to expect data that is out of time order. The 
-default value is 0 (no latency). If you specify a non-zero value, it must be greater than or equal to one second. For more information about time units, see <<time-units>>.
+default value is 0 (no latency). If you specify a non-zero value, it must be 
+greater than or equal to one second. For more information about time units, see 
+<<time-units>>.
 +
 --
 NOTE: Latency is only applicable when you send data by using
@@ -607,11 +789,33 @@ If not set then a {dfeed} with no end time that sees no data will remain started
 until it is explicitly stopped. By default this setting is not set.
 end::max-empty-searches[]
 
-tag::maximum_number_trees[]
-`maximum_number_trees`::
-(Optional, integer) Defines the maximum number of trees the forest is allowed 
+tag::maximum-number-trees[]
+Defines the maximum number of trees the forest is allowed 
 to contain. The maximum value is 2000.
-end::maximum_number_trees[]
+end::maximum-number-trees[]
+
+tag::memory-estimation[]
+An object containing the memory estimates. The object has the 
+following properties:
+
+`expected_memory_without_disk`:::
+(string) Estimated memory usage under the assumption that the whole 
+{dfanalytics} should happen in memory (i.e. without overflowing to disk).
+
+`expected_memory_with_disk`:::
+(string) Estimated memory usage under the assumption that overflowing to disk is 
+allowed during {dfanalytics}. `expected_memory_with_disk` is usually smaller 
+than `expected_memory_without_disk` as using disk allows to limit the main 
+memory needed to perform {dfanalytics}.
+end::memory-estimation[]
+
+tag::method[]
+Sets the method that {oldetection} uses. If the method is not set {oldetection} 
+uses an ensemble of different methods and normalises and combines their 
+individual {olscores} to obtain the overall {olscore}. We recommend to use the 
+ensemble method. Available methods are `lof`, `ldof`, `distance_kth_nn`, 
+`distance_knn`.
+end::method[]
 
 tag::mode[]
 There are three available modes: 
@@ -649,20 +853,30 @@ see <<ml-settings>>.
 --
 end::model-memory-limit[]
 
+tag::model-memory-limit-dfa[]
+The approximate maximum amount of memory resources that are permitted for 
+analytical processing. The default value for {dfanalytics-jobs} is `1gb`. If 
+your `elasticsearch.yml` file contains an `xpack.ml.max_model_memory_limit` 
+setting, an error occurs when you try to create {dfanalytics-jobs} that have 
+`model_memory_limit` values greater than that setting. For more information, see 
+<<ml-settings>>.
+end::model-memory-limit-dfa[]
+
 tag::model-plot-config[]
 This advanced configuration option stores model information along with the
 results. It provides a more detailed view into {anomaly-detect}.
 +
 --
-WARNING: If you enable model plot it can add considerable overhead to the performance
-of the system; it is not feasible for jobs with many entities.
+WARNING: If you enable model plot it can add considerable overhead to the 
+performance of the system; it is not feasible for jobs with many entities.
 
-Model plot provides a simplified and indicative view of the model and its bounds.
-It does not display complex features such as multivariate correlations or multimodal data.
-As such, anomalies may occasionally be reported which cannot be seen in the model plot.
+Model plot provides a simplified and indicative view of the model and its 
+bounds. It does not display complex features such as multivariate correlations 
+or multimodal data. As such, anomalies may occasionally be reported which cannot 
+be seen in the model plot.
 
-Model plot config can be configured when the job is created or updated later. It must be
-disabled if performance issues are experienced.
+Model plot config can be configured when the job is created or updated later. It 
+must be disabled if performance issues are experienced.
 
 The `model_plot_config` object has the following properties:
 
@@ -713,6 +927,21 @@ NOTE: To use the `multivariate_by_fields` property, you must also specify
 --
 end::multivariate-by-fields[]
 
+tag::n-neighbors[]
+Defines the value for how many nearest neighbors each method of 
+{oldetection} will use to calculate its {olscore}. When the value is not set, 
+different values will be used for different ensemble members. This helps 
+improve diversity in the ensemble. Therefore, only override this if you are 
+confident that the value you choose is appropriate for the data set.
+end::n-neighbors[]
+
+tag::num-top-classes[]
+Defines the number of categories for which the predicted 
+probabilities are reported. It must be non-negative. If it is greater than the 
+total number of categories (in the {version} version of the {stack}, it's two) 
+to predict then we will report all category probabilities. Defaults to 2.
+end::num-top-classes[]
+
 tag::over-field-name[]
 The field used to split the data. In particular, this property is used for 
 analyzing the splits with respect to the history of all splits. It is used for 
@@ -720,16 +949,29 @@ finding unusual values in the population of all splits. For more information,
 see {stack-ov}/ml-configuring-pop.html[Performing population analysis].
 end::over-field-name[]
 
+tag::outlier-fraction[]
+Sets the proportion of the data set that is assumed to be outlying prior to 
+{oldetection}. For example, 0.05 means it is assumed that 5% of values are real 
+outliers and 95% are inliers.
+end::outlier-fraction[]
+
 tag::partition-field-name[]
 The field used to segment the analysis. When you use this property, you have 
 completely independent baselines for each value of this field.
 end::partition-field-name[]
 
-tag::prediction_field_name[]
-`prediction_field_name`::
-(Optional, string) Defines the name of the prediction field in the results. 
+tag::prediction-field-name[]
+Defines the name of the prediction field in the results. 
 Defaults to `<dependent_variable>_prediction`.
-end::prediction_field_name[]
+end::prediction-field-name[]
+
+tag::randomize-seed[]
+Defines the seed to the random generator that is used to pick which documents 
+will be used for training. By default it is randomly generated. Set it to a 
+specific value to ensure the same documents are used for training assuming other 
+related parameters (for example, `source`, `analyzed_fields`, etc.) are the 
+same.
+end::randomize-seed[]
 
 tag::query[]
 The {es} query domain-specific language (DSL). This value corresponds to the
@@ -776,6 +1018,48 @@ tag::scroll-size[]
 The `size` parameter that is used in {es} searches. The default value is `1000`.
 end::scroll-size[]
 
+tag::size[]
+Specifies the maximum number of {dfanalytics-jobs} to obtain. The default value 
+is `100`.
+end::size[]
+
+tag::source-put-dfa[]
+The configuration of how to source the analysis data. It requires an 
+`index`. Optionally, `query` and `_source` may be specified.
+
+`index`:::
+  (Required, string or array) Index or indices on which to perform the 
+  analysis. It can be a single index or index pattern as well as an array of 
+  indices or patterns.
+  
+`query`:::
+  (Optional, object) The {es} query domain-specific language 
+  (<<query-dsl,DSL>>). This value corresponds to the query object in an {es} 
+  search POST body. All the options that are supported by {es} can be used, 
+  as this object is passed verbatim to {es}. By default, this property has 
+  the following value: `{"match_all": {}}`.
+
+`_source`:::
+  (Optional, object) Specify `includes` and/or `excludes` patterns to select
+  which fields will be present in the destination. Fields that are excluded
+  cannot be included in the analysis.
+      
+    `includes`::::
+      (array) An array of strings that defines the fields that will be 
+      included in the destination.
+        
+    `excludes`::::
+      (array) An array of strings that defines the fields that will be 
+      excluded from the destination.
+end::source-put-dfa[]
+
+tag::standardization-enabled[]
+If `true`, then the following operation is performed on the columns before 
+computing outlier scores: (x_i - mean(x_i)) / sd(x_i). Defaults to `true`. For 
+more information, see 
+https://en.wikipedia.org/wiki/Feature_scaling#Standardization_(Z-score_Normalization)[this wiki page about standardization].
+end::standardization-enabled[]
+
 tag::summary-count-field-name[]
 If this property is specified, the data that is fed to the job is expected to be
 pre-summarized. This property value is the name of the field that contains the 
@@ -789,6 +1073,16 @@ function.
 --
 end::summary-count-field-name[]
 
+tag::timeout-start[]
+Controls the amount of time to wait until the {dfanalytics-job} starts. Defaults 
+to 20 seconds.
+end::timeout-start[]
+
+tag::timeout-stop[]
+Controls the amount of time to wait until the {dfanalytics-job} stops. Defaults 
+to 20 seconds.
+end::timeout-stop[]
+
 tag::time-format[]
 The time format, which can be `epoch`, `epoch_ms`, or a custom pattern. The
 default value is `epoch`, which refers to UNIX or Epoch time (the number of 
@@ -800,8 +1094,8 @@ either integer or real values. +
 NOTE: Custom patterns must conform to the Java `DateTimeFormatter` class.
 When you use date-time formatting patterns, it is recommended that you provide
 the full date, time and time zone. For example: `yyyy-MM-dd'T'HH:mm:ssX`.
-If the pattern that you specify is not sufficient to produce a complete timestamp,
-job creation fails.
+If the pattern that you specify is not sufficient to produce a complete 
+timestamp, job creation fails.
 
 --
 end::time-format[]
@@ -821,22 +1115,12 @@ that tokenizer but change the character or token filters, specify
 `"tokenizer": "ml_classic"` in your `categorization_analyzer`.
 end::tokenizer[]
 
-tag::training_percent[]
-`training_percent`::
-(Optional, integer) Defines what percentage of the eligible documents that will 
+tag::training-percent[]
+Defines what percentage of the eligible documents that will 
 be used for training. Documents that are ignored by the analysis (for example 
 those that contain arrays) won’t be included in the calculation for used 
 percentage. Defaults to `100`.
-end::training_percent[]
-
-tag::randomize_seed[]
-`randomize_seed`::
-(Optional, long) Defines the seed to the random generator that is used to pick
-which documents will be used for training. By default it is randomly generated.
-Set it to a specific value to ensure the same documents are used for training
-assuming other related parameters (e.g. `source`, `analyzed_fields`, etc.) are the same.
-end::randomize_seed[]
-
+end::training-percent[]
 
 tag::use-null[]
 Defines whether a new series is used as the null series when there is no value 
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index 0ef152e917f8e..312a889707110 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -5,15 +5,15 @@
 These resource definitions are used in APIs related to {ml-features} and
 {security-features} and in {kib} advanced {ml} job configuration options.
 
-* <<ml-dfanalytics-resources,{dfanalytics-cap}>>
-* <<ml-evaluate-dfanalytics-resources,Evaluate {dfanalytics}>>
+
+* <<ml-dfa-analysis-objects>>
 * <<ml-snapshot-resource,{anomaly-detect-cap} model snapshots>>
 * <<ml-results-resource,{anomaly-detect-cap} results>>
 * <<role-mapping-resources,Role mappings>>
 * <<transform-resource,{transforms-cap}>>
 
-include::{es-repo-dir}/ml/df-analytics/apis/dfanalyticsresources.asciidoc[]
-include::{es-repo-dir}/ml/df-analytics/apis/evaluateresources.asciidoc[]
+
+include::{es-repo-dir}/ml/df-analytics/apis/analysisobjects.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/snapshotresource.asciidoc[]
 include::{xes-repo-dir}/rest-api/security/role-mapping-resources.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/resultsresource.asciidoc[]

From cc4af53b053c99fd6c1a66d341e57fe2d0efb2a4 Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Thu, 12 Dec 2019 11:03:59 +0000
Subject: [PATCH 173/686] Enable trace logging in failing ml
 NetworkDisruptionIT

https://github.com/elastic/elasticsearch/issues/49908
---
 .../xpack/ml/integration/NetworkDisruptionIT.java              | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java
index 8a257baa3d628..379daba7c45ea 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.disruption.NetworkDisruption;
+import org.elasticsearch.test.junit.annotations.TestLogging;
 import org.elasticsearch.test.transport.MockTransportService;
 import org.elasticsearch.xpack.core.ml.action.CloseJobAction;
 import org.elasticsearch.xpack.core.ml.action.OpenJobAction;
@@ -38,6 +39,8 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
         return plugins;
     }
 
+    @TestLogging(value = "org.elasticsearch.persistent.PersistentTasksClusterService:trace",
+            reason = "https://github.com/elastic/elasticsearch/issues/49908")
     public void testJobRelocation() throws Exception {
         internalCluster().ensureAtLeastNumDataNodes(5);
         ensureStableCluster(5);

From 745ef3e3cde9d5f3bae482d75ce53b09b7a4fe8f Mon Sep 17 00:00:00 2001
From: Ignacio Vera <ivera@apache.org>
Date: Thu, 12 Dec 2019 12:17:44 +0100
Subject: [PATCH 174/686] upgrade to lucene 8.4.0-snapshot-08b8d116f8f (#50129)

---
 buildSrc/version.properties                                     | 2 +-
 .../lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1      | 1 +
 .../licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1 | 1 -
 .../lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1    | 1 +
 .../lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1        | 1 -
 ...ucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 .../lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1   | 1 -
 .../lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1   | 1 +
 .../lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1       | 1 -
 ...ucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 .../lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1   | 1 -
 ...lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 .../lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1    | 1 -
 ...lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 .../lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1    | 1 -
 ...ene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 .../lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1 | 1 -
 .../lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 .../lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1     | 1 -
 .../lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1  | 1 +
 .../lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1      | 1 -
 server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1     | 1 -
 .../lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1         | 1 +
 server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1 | 1 -
 .../lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1      | 1 +
 .../licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1 | 1 -
 server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1     | 1 -
 .../licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1  | 1 +
 server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1   | 1 -
 server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1     | 1 -
 .../licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1  | 1 -
 .../lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1      | 1 +
 .../licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1 | 1 -
 .../licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1  | 1 -
 .../licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1  | 1 -
 .../lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1   | 1 +
 .../lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1       | 1 -
 .../lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1        | 1 +
 .../licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1   | 1 -
 .../licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 +
 server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1  | 1 -
 .../licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1    | 1 +
 .../licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1        | 1 -
 49 files changed, 25 insertions(+), 25 deletions(-)
 create mode 100644 modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 server/licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1
 create mode 100644 x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
 delete mode 100644 x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1

diff --git a/buildSrc/version.properties b/buildSrc/version.properties
index ad486276f082e..c7e957939fc55 100644
--- a/buildSrc/version.properties
+++ b/buildSrc/version.properties
@@ -1,5 +1,5 @@
 elasticsearch     = 8.0.0
-lucene            = 8.4.0-snapshot-662c455
+lucene            = 8.4.0-snapshot-08b8d116f8f
 
 bundled_jdk_vendor = adoptopenjdk
 bundled_jdk = 13.0.1+9
diff --git a/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..0f2b32ad7ef61
--- /dev/null
+++ b/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+a02eaef7b91b383f7ca43f4a33726bd089c0a36e
\ No newline at end of file
diff --git a/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1 b/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 1c4c5ce2b62db..0000000000000
--- a/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-4041db9db7c394584571b45812734732912ef8e2
\ No newline at end of file
diff --git a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..058b07b9dba7d
--- /dev/null
+++ b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+7c7054c935661dde19afeb0b9c7b8bda65c0dafe
\ No newline at end of file
diff --git a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 0fc96bc500eff..0000000000000
--- a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-d5bddd6b7660439e29bbce26ded283931c756d75
\ No newline at end of file
diff --git a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..decd6216aeece
--- /dev/null
+++ b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+4dc8d6f78242fc384fd03a2a2e93d1737b0d3c11
\ No newline at end of file
diff --git a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 388bc9748b7f0..0000000000000
--- a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-4303858c346c51bbbc68c32eb25f7f372b09331c
\ No newline at end of file
diff --git a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..3c34ab4664b7c
--- /dev/null
+++ b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+40baaa81cb2b986d086b0ebc648415da84c15552
\ No newline at end of file
diff --git a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 07ff7fd907a22..0000000000000
--- a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-b1a9182ed1b92a121c1587fe9710aa7a41f3f77a
\ No newline at end of file
diff --git a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..623f9f1aefd26
--- /dev/null
+++ b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+8739dcdb8ca9fdebb93f6e696626119d30d5cb58
\ No newline at end of file
diff --git a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 95e603ec18882..0000000000000
--- a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-4df747b25286baecf5e790bf76bc40038c059691
\ No newline at end of file
diff --git a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..4b4d838d03fbf
--- /dev/null
+++ b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+74a27bf3c523156fadc0159cd1311388505d6cae
\ No newline at end of file
diff --git a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 4eaf91f308397..0000000000000
--- a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-88d3f8f9134b95884f3b80280b09aa2513b71297
\ No newline at end of file
diff --git a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..f5510f6f731ee
--- /dev/null
+++ b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+374d411635868394719f4d328a26dbc6a9b0eded
\ No newline at end of file
diff --git a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index e28b8d87cd559..0000000000000
--- a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-9ddccf575ee03a1329c8d1eb2e4ee7a6e3f3f56f
\ No newline at end of file
diff --git a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..5c9510b012765
--- /dev/null
+++ b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+1cf79c772b6cfecc80137bcde48b7a5432ee5028
\ No newline at end of file
diff --git a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1 b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 1b8ec8c5831cb..0000000000000
--- a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-e115e562a42c12a3292fb138607855c1fdfb0772
\ No newline at end of file
diff --git a/server/licenses/lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..03841938296d2
--- /dev/null
+++ b/server/licenses/lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+dc14a70f44c2597e237f37f096d6b8c2db8cd335
\ No newline at end of file
diff --git a/server/licenses/lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index d6f8049f7b1e1..0000000000000
--- a/server/licenses/lucene-analyzers-common-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-061fb94ab616492721f8868dcaec3fbc989733be
\ No newline at end of file
diff --git a/server/licenses/lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..76fbf985dc8c8
--- /dev/null
+++ b/server/licenses/lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+535e6d650fe66ef8df9fd03ad48170f6c0e7c4cf
\ No newline at end of file
diff --git a/server/licenses/lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 243c4420beabe..0000000000000
--- a/server/licenses/lucene-backward-codecs-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-503f3d516889a99e1c0e2dbdba7bf9cc9900c54c
\ No newline at end of file
diff --git a/server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..cb9ce3f8db761
--- /dev/null
+++ b/server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+2d20a2d0f96f4337665b3043e627df6ce83ed41c
\ No newline at end of file
diff --git a/server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index d1657fccc5ee2..0000000000000
--- a/server/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-8ca36adea0a904ec725d57f509a62652a53ecff8
\ No newline at end of file
diff --git a/server/licenses/lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..10b0df8788174
--- /dev/null
+++ b/server/licenses/lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+cb9218eb5a5c9ef84377f9533e8a2d13c55ed71b
\ No newline at end of file
diff --git a/server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index f1f0684d9b389..0000000000000
--- a/server/licenses/lucene-grouping-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-f176fdcf8fc574f4cb1c549aaa4da0301afd34ba
\ No newline at end of file
diff --git a/server/licenses/lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..9ae147d34b61a
--- /dev/null
+++ b/server/licenses/lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+0cbb63e519f3e0acf7bdbc6dcd6c2bc4bb003b70
\ No newline at end of file
diff --git a/server/licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index a9ad6fb95cb8b..0000000000000
--- a/server/licenses/lucene-highlighter-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-db5ea7b647309e5d29fa92bcbb6b11286d11436d
\ No newline at end of file
diff --git a/server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..59cb050fe465f
--- /dev/null
+++ b/server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+0f843b878752449f345d6fd5048f62b1c0688fca
\ No newline at end of file
diff --git a/server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 6ef1d079f63f1..0000000000000
--- a/server/licenses/lucene-join-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-36329bc2ea6a5640d4128206221456656de7bbe2
\ No newline at end of file
diff --git a/server/licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..78951b539c098
--- /dev/null
+++ b/server/licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+e5583564c96d24d7293574efbd5d55d5e5d55f58
\ No newline at end of file
diff --git a/server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index eeb424851022e..0000000000000
--- a/server/licenses/lucene-memory-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-083f492781b3d2c1d470bd1439c875ebf74a14eb
\ No newline at end of file
diff --git a/server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..86a36ef22e4b5
--- /dev/null
+++ b/server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+1a20042a3c79e86b0c95f7bc19bdb835e4fba74e
\ No newline at end of file
diff --git a/server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 6f5d479c76d64..0000000000000
--- a/server/licenses/lucene-misc-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-9cd5ea7bc08d93053ca993bd6fc1c9cd0a1b91fd
\ No newline at end of file
diff --git a/server/licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..8e7766918327b
--- /dev/null
+++ b/server/licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+60f1ba706bde727fcbb333e8bc52d0cf53daa776
\ No newline at end of file
diff --git a/server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 30733a5a57764..0000000000000
--- a/server/licenses/lucene-queries-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-89e39f65d1c42b5849ccf3a8e6cc9b3b277c08a6
\ No newline at end of file
diff --git a/server/licenses/lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..eec0b037dfebd
--- /dev/null
+++ b/server/licenses/lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+a99fbcf01d2ee081b04ed7e173c71bcc1f2c4a83
\ No newline at end of file
diff --git a/server/licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 98b065176a418..0000000000000
--- a/server/licenses/lucene-queryparser-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-651f6a0075ee30b814c8b56020d95155424c0e67
\ No newline at end of file
diff --git a/server/licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..66881bedef5da
--- /dev/null
+++ b/server/licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+613057333e965ada682126b7e97d8d7fb6ab7db8
\ No newline at end of file
diff --git a/server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 484ce6b5c00f0..0000000000000
--- a/server/licenses/lucene-sandbox-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-935968488cc2bbcd3ced9c254f690e7c90447d9e
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..6b7f37fa76630
--- /dev/null
+++ b/server/licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+2727fc11cb9d503388a8fb09159de8db17772de9
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 1bb42417cb147..0000000000000
--- a/server/licenses/lucene-spatial-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-0bbdd0002d8d87e54b5caff6c77a1627bf449d38
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..4c480aff42ae6
--- /dev/null
+++ b/server/licenses/lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+7bd96ac0db2bf246e8a5636409201fa1ca1619fe
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 2bdbd889b4454..0000000000000
--- a/server/licenses/lucene-spatial-extras-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-255b547571dcec118ff1a0560bb16e259f96b76a
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..1bb87cc3f586c
--- /dev/null
+++ b/server/licenses/lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+f4c57666b25335ff797c76932563b3f4e33f138d
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index e7036243119a9..0000000000000
--- a/server/licenses/lucene-spatial3d-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-739af6d9876f6aa7f2a3d46fa3f236a5d6ee3653
\ No newline at end of file
diff --git a/server/licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..31d4b678e0536
--- /dev/null
+++ b/server/licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+2351b9abaa5fed697217853db44c038070660b75
\ No newline at end of file
diff --git a/server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1 b/server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index 72c92c101b050..0000000000000
--- a/server/licenses/lucene-suggest-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-20fa11a541a7ca3a50caa443a9abf0276b1194ea
\ No newline at end of file
diff --git a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
new file mode 100644
index 0000000000000..cb9ce3f8db761
--- /dev/null
+++ b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
@@ -0,0 +1 @@
+2d20a2d0f96f4337665b3043e627df6ce83ed41c
\ No newline at end of file
diff --git a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1 b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
deleted file mode 100644
index d1657fccc5ee2..0000000000000
--- a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-662c455.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-8ca36adea0a904ec725d57f509a62652a53ecff8
\ No newline at end of file

From ba6b50249978f5ab92a824f6be5c81c1e8bac935 Mon Sep 17 00:00:00 2001
From: Martijn Laarman <Mpdreamz@gmail.com>
Date: Thu, 12 Dec 2019 13:12:04 +0100
Subject: [PATCH 175/686] cat.indices.json bytes enum not exhaustive (#49369)

Missing several valid options that other cat API's do define
---
 .../main/resources/rest-api-spec/api/cat.indices.json    | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
index 60a98412c31b3..68194bc652b29 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
@@ -38,8 +38,15 @@
         "options":[
           "b",
           "k",
+          "kb",
           "m",
-          "g"
+          "mb",
+          "g",
+          "gb",
+          "t",
+          "tb",
+          "p",
+          "pb"
         ]
       },
       "local":{

From 09f1903c832bea47fd7de85d493884aaa535fc9a Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 12 Dec 2019 13:16:32 +0100
Subject: [PATCH 176/686] Remove Unused Delete Endpoint from GCS Mock (#50128)

Follow up to #50024: we're not using the single-delete any more so no need to have a mock endpoint for it
---
 .../fixture/gcs/GoogleCloudStorageHttpHandler.java  | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
index 967c884104c96..1b4c6b4caacb9 100644
--- a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
+++ b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
@@ -43,7 +43,6 @@
 import java.util.Arrays;
 import java.util.HashMap;
 import java.util.HashSet;
-import java.util.Iterator;
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
@@ -145,18 +144,6 @@ public void handle(final HttpExchange exchange) throws IOException {
                     exchange.sendResponseHeaders(RestStatus.NOT_FOUND.getStatus(), -1);
                 }
 
-            } else if (Regex.simpleMatch("DELETE /storage/v1/b/" + bucket + "/o/*", request)) {
-                // Delete Object https://cloud.google.com/storage/docs/json_api/v1/objects/delete
-                int deletions = 0;
-                for (Iterator<Map.Entry<String, BytesReference>> iterator = blobs.entrySet().iterator(); iterator.hasNext(); ) {
-                    Map.Entry<String, BytesReference> blob = iterator.next();
-                    if (blob.getKey().equals(exchange.getRequestURI().toString())) {
-                        iterator.remove();
-                        deletions++;
-                    }
-                }
-                exchange.sendResponseHeaders((deletions > 0 ? RestStatus.OK : RestStatus.NO_CONTENT).getStatus(), -1);
-
             } else if (Regex.simpleMatch("POST /batch/storage/v1", request)) {
                 // Batch https://cloud.google.com/storage/docs/json_api/v1/how-tos/batch
                 final String uri = "/storage/v1/b/" + bucket + "/o/";

From 8d9190682430bad03cf3e042b67a25f727b7d30b Mon Sep 17 00:00:00 2001
From: Tomas Della Vedova <delvedor@users.noreply.github.com>
Date: Thu, 12 Dec 2019 13:56:16 +0100
Subject: [PATCH 177/686] Added type definitions in rest-api-spec (#47089)

* Added type definitions in rest-api-spec

* Addressed comments
---
 rest-api-spec/README.markdown | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/rest-api-spec/README.markdown b/rest-api-spec/README.markdown
index 8092546fd5a30..9bbef355b3bd6 100644
--- a/rest-api-spec/README.markdown
+++ b/rest-api-spec/README.markdown
@@ -67,6 +67,23 @@ If an API is stable but it response should be treated as an arbitrary map of key
 }
 ```
 
+## Type definition
+In the documentation, you will find the `type` field, which documents which type every parameter will accept.
+
+#### Querystring parameters
+| Type  | Description  |
+|---|---|
+| `list`  | An array of strings *(represented as a comma separated list in the querystring)* |
+| `date` | A string representing a date formatted in ISO8601 or a number representing milliseconds since the epoch *(used only in ML)*   |
+| `time` | A numeric or string value representing duration |
+| `string` | A string value  |
+| `enum` | A set of named constants *(a single value should be sent in the querystring)*  |
+| `int` | A signed 32-bit integer with a minimum value of -2<sup>31</sup> and a maximum value of 2<sup>31</sup>-1.  |
+| `double` | A [double-precision 64-bit IEEE 754](https://en.wikipedia.org/wiki/Floating-point_arithmetic) floating point number, restricted to finite values.  |
+| `long` | A signed 64-bit integer with a minimum value of -2<sup>63</sup> and a maximum value of 2<sup>63</sup>-1. *(Note: the max safe integer for JSON is 2<sup>53</sup>-1)* |
+| `number` | Alias for `double`. *(deprecated, a more specific type should be used)*  |
+| `boolean` | Boolean fields accept JSON true and false values  |
+
 ## Backwards compatibility
 
 The specification follows the same backward compatibility guarantees as Elasticsearch.

From 9008cf3b5da756c131daf8ff16a14c1495f510a4 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 12 Dec 2019 08:38:48 -0500
Subject: [PATCH 178/686] [DOCS] Correct percentile rank agg example response
 (#50052)

The example snippets in the percentile rank agg docs use a test dataset
named `latency`, which is generated from docs/gradle.build.

At some point the dataset and example snippets were updated, but the
text surrounding the snippets was not. This means the text and the
example snippets shown no longer match up.

This corrects that by changing the snippets using /TESTRESPONSE magic comments.
---
 .../metrics/percentile-rank-aggregation.asciidoc     | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/reference/aggregations/metrics/percentile-rank-aggregation.asciidoc b/docs/reference/aggregations/metrics/percentile-rank-aggregation.asciidoc
index d0765ea026846..71bc5ceee555d 100644
--- a/docs/reference/aggregations/metrics/percentile-rank-aggregation.asciidoc
+++ b/docs/reference/aggregations/metrics/percentile-rank-aggregation.asciidoc
@@ -51,14 +51,16 @@ The response will look like this:
    "aggregations": {
       "load_time_ranks": {
          "values" : {
-            "500.0": 55.00000000000001,
-            "600.0": 64.0
+            "500.0": 90.01,
+            "600.0": 100.0
          }
       }
    }
 }
 --------------------------------------------------
 // TESTRESPONSE[s/\.\.\./"took": $body.took,"timed_out": false,"_shards": $body._shards,"hits": $body.hits,/]
+// TESTRESPONSE[s/"500.0": 90.01/"500.0": 55.00000000000001/]
+// TESTRESPONSE[s/"600.0": 100.0/"600.0": 64.0/]
 
 From this information you can determine you are hitting the 99% load time target but not quite
 hitting the 95% load time target
@@ -97,11 +99,11 @@ Response:
             "values": [
                 {
                     "key": 500.0,
-                    "value": 55.00000000000001
+                    "value": 90.01
                 },
                 {
                     "key": 600.0,
-                    "value": 64.0
+                    "value": 100.0
                 }
             ]
         }
@@ -109,6 +111,8 @@ Response:
 }
 --------------------------------------------------
 // TESTRESPONSE[s/\.\.\./"took": $body.took,"timed_out": false,"_shards": $body._shards,"hits": $body.hits,/]
+// TESTRESPONSE[s/"value": 90.01/"value": 55.00000000000001/]
+// TESTRESPONSE[s/"value": 100.0/"value": 64.0/]
 
 
 ==== Script

From 2f6a6b118956628f002da188ea0decb90487ce76 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Thu, 12 Dec 2019 09:03:33 -0500
Subject: [PATCH 179/686] [ML] Add graceful retry for anomaly detector result
 indexing failures (#49508)

All results indexing now retry the amount of times configured in `xpack.ml.persist_results_max_retries`. The retries are done in a semi-random, exponential backoff.
---
 .../ml/integration/BulkFailureRetryIT.java    | 214 ++++++++++++++++++
 .../xpack/ml/MachineLearning.java             |  11 +-
 .../TransportRevertModelSnapshotAction.java   |   2 +-
 .../persistence/JobDataCountsPersister.java   |  51 ++++-
 .../job/persistence/JobResultsPersister.java  |  82 ++++---
 .../ml/job/process/DataCountsReporter.java    |   5 +-
 .../output/AutodetectResultProcessor.java     |  29 ++-
 .../writer/CsvDataToProcessWriter.java        |   8 +-
 .../writer/JsonDataToProcessWriter.java       |  11 +-
 .../persistence/ResultsPersisterService.java  | 173 ++++++++++++++
 .../AutodetectResultProcessorIT.java          |  24 +-
 .../ml/integration/EstablishedMemUsageIT.java |  31 ++-
 .../ml/integration/JobResultsProviderIT.java  |  62 ++---
 .../persistence/JobResultsPersisterTests.java | 112 +++++----
 .../job/process/DataCountsReporterTests.java  |  21 +-
 .../AutodetectCommunicatorTests.java          |   7 +-
 .../AutodetectProcessManagerTests.java        |   8 +-
 .../AutodetectResultProcessorTests.java       |  91 ++++----
 .../writer/CsvDataToProcessWriterTests.java   |  20 +-
 .../writer/JsonDataToProcessWriterTests.java  |  18 +-
 .../ResultsPersisterServiceTests.java         | 203 +++++++++++++++++
 21 files changed, 960 insertions(+), 223 deletions(-)
 create mode 100644 x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/BulkFailureRetryIT.java
 create mode 100644 x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterService.java
 create mode 100644 x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterServiceTests.java

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/BulkFailureRetryIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/BulkFailureRetryIT.java
new file mode 100644
index 0000000000000..6dcf306b04a39
--- /dev/null
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/BulkFailureRetryIT.java
@@ -0,0 +1,214 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.integration;
+
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.bulk.BulkItemResponse;
+import org.elasticsearch.action.bulk.BulkRequestBuilder;
+import org.elasticsearch.action.bulk.BulkResponse;
+import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.action.support.WriteRequest;
+import org.elasticsearch.action.support.master.AcknowledgedResponse;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.xpack.core.action.util.PageParams;
+import org.elasticsearch.xpack.core.ml.action.GetBucketsAction;
+import org.elasticsearch.xpack.core.ml.datafeed.DatafeedConfig;
+import org.elasticsearch.xpack.core.ml.job.config.AnalysisConfig;
+import org.elasticsearch.xpack.core.ml.job.config.DataDescription;
+import org.elasticsearch.xpack.core.ml.job.config.Detector;
+import org.elasticsearch.xpack.core.ml.job.config.Job;
+import org.elasticsearch.xpack.core.ml.job.results.Bucket;
+import org.elasticsearch.xpack.core.ml.job.results.Result;
+import org.junit.After;
+import org.junit.Before;
+
+import java.time.Duration;
+import java.util.Collections;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.atomic.AtomicReference;
+import java.util.function.Consumer;
+
+import static org.elasticsearch.xpack.ml.support.BaseMlIntegTestCase.createDatafeedBuilder;
+import static org.hamcrest.Matchers.greaterThan;
+
+public class BulkFailureRetryIT extends MlNativeAutodetectIntegTestCase {
+
+    private final String index = "bulk-failure-retry";
+    private long now = System.currentTimeMillis();
+    private static long DAY = Duration.ofDays(1).toMillis();
+    private final String jobId = "bulk-failure-retry-job";
+    private final String resultsIndex = ".ml-anomalies-custom-bulk-failure-retry-job";
+
+    @Before
+    public void putPastDataIntoIndex() {
+        client().admin().indices().prepareCreate(index)
+            .addMapping("type", "time", "type=date", "value", "type=long")
+            .get();
+        long twoDaysAgo = now - DAY * 2;
+        long threeDaysAgo = now - DAY * 3;
+        writeData(logger, index, 250, threeDaysAgo, twoDaysAgo);
+    }
+
+    @After
+    public void cleanUpTest() {
+        client().admin()
+            .cluster()
+            .prepareUpdateSettings()
+            .setTransientSettings(Settings.builder()
+                .putNull("xpack.ml.persist_results_max_retries")
+                .putNull("logger.org.elasticsearch.xpack.ml.datafeed.DatafeedJob")
+                .putNull("logger.org.elasticsearch.xpack.ml.job.persistence.JobResultsPersister")
+                .putNull("logger.org.elasticsearch.xpack.ml.job.process.autodetect.output")
+                .build()).get();
+        cleanUp();
+    }
+
+    private void ensureAnomaliesWrite() throws InterruptedException {
+        Settings settings = Settings.builder().put(IndexMetaData.INDEX_READ_ONLY_SETTING.getKey(), false).build();
+        AtomicReference<AcknowledgedResponse> acknowledgedResponseHolder = new AtomicReference<>();
+        AtomicReference<Exception> exceptionHolder = new AtomicReference<>();
+        blockingCall(
+            listener -> client().admin().indices().prepareUpdateSettings(resultsIndex).setSettings(settings).execute(listener),
+            acknowledgedResponseHolder,
+            exceptionHolder);
+        if (exceptionHolder.get() != null) {
+            fail("FAILED TO MARK ["+ resultsIndex + "] as read-write again" + exceptionHolder.get());
+        }
+    }
+
+    private void setAnomaliesReadOnlyBlock() throws InterruptedException {
+        Settings settings = Settings.builder().put(IndexMetaData.INDEX_READ_ONLY_SETTING.getKey(), true).build();
+        AtomicReference<AcknowledgedResponse> acknowledgedResponseHolder = new AtomicReference<>();
+        AtomicReference<Exception> exceptionHolder = new AtomicReference<>();
+        blockingCall(
+            listener -> client().admin().indices().prepareUpdateSettings(resultsIndex).setSettings(settings).execute(listener),
+            acknowledgedResponseHolder,
+            exceptionHolder);
+        if (exceptionHolder.get() != null) {
+            fail("FAILED TO MARK ["+ resultsIndex + "] as read-ONLY: " + exceptionHolder.get());
+        }
+    }
+
+    public void testBulkFailureRetries() throws Exception {
+        Job.Builder job = createJob(jobId, TimeValue.timeValueMinutes(5), "count", null);
+        job.setResultsIndexName(jobId);
+
+        DatafeedConfig.Builder datafeedConfigBuilder =
+            createDatafeedBuilder(job.getId() + "-datafeed", job.getId(), Collections.singletonList(index));
+        DatafeedConfig datafeedConfig = datafeedConfigBuilder.build();
+        registerJob(job);
+        putJob(job);
+        openJob(job.getId());
+        registerDatafeed(datafeedConfig);
+        putDatafeed(datafeedConfig);
+        long twoDaysAgo = now - 2 * DAY;
+        startDatafeed(datafeedConfig.getId(), 0L, twoDaysAgo);
+        waitUntilJobIsClosed(jobId);
+
+        // Get the job stats
+        Bucket initialLatestBucket = getLatestFinalizedBucket(jobId);
+        assertThat(initialLatestBucket.getEpoch(), greaterThan(0L));
+
+        client().admin()
+            .cluster()
+            .prepareUpdateSettings()
+            .setTransientSettings(Settings.builder()
+                .put("logger.org.elasticsearch.xpack.ml.datafeed.DatafeedJob", "TRACE")
+                .put("logger.org.elasticsearch.xpack.ml.job.persistence.JobResultsPersister", "TRACE")
+                .put("logger.org.elasticsearch.xpack.ml.job.process.autodetect.output", "TRACE")
+                .put("xpack.ml.persist_results_max_retries", "15")
+                .build()).get();
+
+        setAnomaliesReadOnlyBlock();
+
+        int moreDocs = 1_000;
+        writeData(logger, index, moreDocs, twoDaysAgo, now);
+
+        openJob(job.getId());
+        startDatafeed(datafeedConfig.getId(), twoDaysAgo, now);
+
+        ensureAnomaliesWrite();
+        waitUntilJobIsClosed(jobId);
+
+        Bucket newLatestBucket = getLatestFinalizedBucket(jobId);
+        assertThat(newLatestBucket.getEpoch(), greaterThan(initialLatestBucket.getEpoch()));
+    }
+
+    private Job.Builder createJob(String id, TimeValue bucketSpan, String function, String field) {
+        return createJob(id, bucketSpan, function, field, null);
+    }
+
+    private Job.Builder createJob(String id, TimeValue bucketSpan, String function, String field, String summaryCountField) {
+        DataDescription.Builder dataDescription = new DataDescription.Builder();
+        dataDescription.setFormat(DataDescription.DataFormat.XCONTENT);
+        dataDescription.setTimeField("time");
+        dataDescription.setTimeFormat(DataDescription.EPOCH_MS);
+
+        Detector.Builder d = new Detector.Builder(function, field);
+        AnalysisConfig.Builder analysisConfig = new AnalysisConfig.Builder(Collections.singletonList(d.build()))
+            .setBucketSpan(bucketSpan)
+            .setSummaryCountFieldName(summaryCountField);
+
+        return new Job.Builder().setId(id).setAnalysisConfig(analysisConfig).setDataDescription(dataDescription);
+    }
+
+    private void writeData(Logger logger, String index, long numDocs, long start, long end) {
+        int maxDelta = (int) (end - start - 1);
+        BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
+        for (int i = 0; i < numDocs; i++) {
+            IndexRequest indexRequest = new IndexRequest(index);
+            long timestamp = start + randomIntBetween(0, maxDelta);
+            assert timestamp >= start && timestamp < end;
+            indexRequest.source("time", timestamp, "value", i);
+            bulkRequestBuilder.add(indexRequest);
+        }
+        BulkResponse bulkResponse = bulkRequestBuilder
+            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
+            .get();
+        if (bulkResponse.hasFailures()) {
+            int failures = 0;
+            for (BulkItemResponse itemResponse : bulkResponse) {
+                if (itemResponse.isFailed()) {
+                    failures++;
+                    logger.error("Item response failure [{}]", itemResponse.getFailureMessage());
+                }
+            }
+            fail("Bulk response contained " + failures + " failures");
+        }
+        logger.info("Indexed [{}] documents", numDocs);
+    }
+
+    private Bucket getLatestFinalizedBucket(String jobId) {
+        GetBucketsAction.Request getBucketsRequest = new GetBucketsAction.Request(jobId);
+        getBucketsRequest.setExcludeInterim(true);
+        getBucketsRequest.setSort(Result.TIMESTAMP.getPreferredName());
+        getBucketsRequest.setDescending(true);
+        getBucketsRequest.setPageParams(new PageParams(0, 1));
+        return getBuckets(getBucketsRequest).get(0);
+    }
+
+    private <T> void blockingCall(Consumer<ActionListener<T>> function,
+                                  AtomicReference<T> response,
+                                  AtomicReference<Exception> error) throws InterruptedException {
+        CountDownLatch latch = new CountDownLatch(1);
+        ActionListener<T> listener = ActionListener.wrap(
+            r -> {
+                response.set(r);
+                latch.countDown();
+            },
+            e -> {
+                error.set(e);
+                latch.countDown();
+            }
+        );
+
+        function.accept(listener);
+        latch.await();
+    }
+}
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
index 76442812ef256..a7b21bbd721ad 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
@@ -298,6 +298,7 @@
 import org.elasticsearch.xpack.ml.rest.results.RestGetRecordsAction;
 import org.elasticsearch.xpack.ml.rest.validate.RestValidateDetectorAction;
 import org.elasticsearch.xpack.ml.rest.validate.RestValidateJobConfigAction;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 
 import java.io.IOException;
 import java.math.BigInteger;
@@ -446,7 +447,8 @@ public List<Setting<?>> getSettings() {
                 MlConfigMigrationEligibilityCheck.ENABLE_CONFIG_MIGRATION,
                 InferenceProcessor.MAX_INFERENCE_PROCESSORS,
                 ModelLoadingService.INFERENCE_MODEL_CACHE_SIZE,
-                ModelLoadingService.INFERENCE_MODEL_CACHE_TTL
+                ModelLoadingService.INFERENCE_MODEL_CACHE_TTL,
+                ResultsPersisterService.PERSIST_RESULTS_MAX_RETRIES
             );
     }
 
@@ -520,9 +522,12 @@ public Collection<Object> createComponents(Client client, ClusterService cluster
         DataFrameAnalyticsAuditor dataFrameAnalyticsAuditor = new DataFrameAnalyticsAuditor(client, clusterService.getNodeName());
         InferenceAuditor inferenceAuditor = new InferenceAuditor(client, clusterService.getNodeName());
         this.dataFrameAnalyticsAuditor.set(dataFrameAnalyticsAuditor);
+        ResultsPersisterService resultsPersisterService = new ResultsPersisterService(client, clusterService, settings);
         JobResultsProvider jobResultsProvider = new JobResultsProvider(client, settings);
-        JobResultsPersister jobResultsPersister = new JobResultsPersister(client);
-        JobDataCountsPersister jobDataCountsPersister = new JobDataCountsPersister(client);
+        JobResultsPersister jobResultsPersister = new JobResultsPersister(client, resultsPersisterService, anomalyDetectionAuditor);
+        JobDataCountsPersister jobDataCountsPersister = new JobDataCountsPersister(client,
+            resultsPersisterService,
+            anomalyDetectionAuditor);
         JobConfigProvider jobConfigProvider = new JobConfigProvider(client, xContentRegistry);
         DatafeedConfigProvider datafeedConfigProvider = new DatafeedConfigProvider(client, xContentRegistry);
         UpdateJobProcessNotifier notifier = new UpdateJobProcessNotifier(client, clusterService, threadPool);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportRevertModelSnapshotAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportRevertModelSnapshotAction.java
index 7b394b580044f..0406f7b9e3370 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportRevertModelSnapshotAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportRevertModelSnapshotAction.java
@@ -171,7 +171,7 @@ private ActionListener<RevertModelSnapshotAction.Response> wrapRevertDataCountsL
         return ActionListener.wrap(response -> {
             jobResultsProvider.dataCounts(jobId, counts -> {
                 counts.setLatestRecordTimeStamp(modelSnapshot.getLatestRecordTimeStamp());
-                jobDataCountsPersister.persistDataCounts(jobId, counts, new ActionListener<Boolean>() {
+                jobDataCountsPersister.persistDataCountsAsync(jobId, counts, new ActionListener<Boolean>() {
                     @Override
                     public void onResponse(Boolean aBoolean) {
                         listener.onResponse(response);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobDataCountsPersister.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobDataCountsPersister.java
index 9866e3f56af19..4925d2c2ac035 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobDataCountsPersister.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobDataCountsPersister.java
@@ -8,16 +8,19 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
-import org.apache.logging.log4j.util.Supplier;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.index.IndexAction;
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.index.IndexResponse;
+import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.DataCounts;
+import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 
 import java.io.IOException;
 
@@ -33,30 +36,60 @@ public class JobDataCountsPersister {
 
     private static final Logger logger = LogManager.getLogger(JobDataCountsPersister.class);
 
+    private final ResultsPersisterService resultsPersisterService;
     private final Client client;
+    private final AnomalyDetectionAuditor auditor;
 
-    public JobDataCountsPersister(Client client) {
+    public JobDataCountsPersister(Client client, ResultsPersisterService resultsPersisterService, AnomalyDetectionAuditor auditor) {
+        this.resultsPersisterService = resultsPersisterService;
         this.client = client;
+        this.auditor = auditor;
     }
 
-    private XContentBuilder serialiseCounts(DataCounts counts) throws IOException {
+    private static XContentBuilder serialiseCounts(DataCounts counts) throws IOException {
         XContentBuilder builder = jsonBuilder();
         return counts.toXContent(builder, ToXContent.EMPTY_PARAMS);
     }
 
     /**
      * Update the job's data counts stats and figures.
+     * NOTE: This call is synchronous and pauses the calling thread.
+     * @param jobId Job to update
+     * @param counts The counts
+     */
+    public void persistDataCounts(String jobId, DataCounts counts) {
+        try {
+            resultsPersisterService.indexWithRetry(jobId,
+                AnomalyDetectorsIndex.resultsWriteAlias(jobId),
+                counts,
+                ToXContent.EMPTY_PARAMS,
+                WriteRequest.RefreshPolicy.NONE,
+                DataCounts.documentId(jobId),
+                () -> true,
+                (msg) -> auditor.warning(jobId, "Job data_counts " + msg));
+        } catch (IOException ioe) {
+            logger.error(() -> new ParameterizedMessage("[{}] Failed writing data_counts stats", jobId), ioe);
+        } catch (Exception ex) {
+            logger.error(() -> new ParameterizedMessage("[{}] Failed persisting data_counts stats", jobId), ex);
+        }
+    }
+
+    /**
+     * The same as {@link JobDataCountsPersister#persistDataCounts(String, DataCounts)} but done Asynchronously.
      *
+     * Two differences are:
+     *  - The listener is notified on persistence failure
+     *  - If the persistence fails, it is not automatically retried
      * @param jobId Job to update
      * @param counts The counts
      * @param listener ActionType response listener
      */
-    public void persistDataCounts(String jobId, DataCounts counts, ActionListener<Boolean> listener) {
+    public void persistDataCountsAsync(String jobId, DataCounts counts, ActionListener<Boolean> listener) {
         try (XContentBuilder content = serialiseCounts(counts)) {
             final IndexRequest request = new IndexRequest(AnomalyDetectorsIndex.resultsWriteAlias(jobId))
-                    .id(DataCounts.documentId(jobId))
-                    .source(content);
-            executeAsyncWithOrigin(client, ML_ORIGIN, IndexAction.INSTANCE, request, new ActionListener<IndexResponse>() {
+                .id(DataCounts.documentId(jobId))
+                .source(content);
+            executeAsyncWithOrigin(client, ML_ORIGIN, IndexAction.INSTANCE, request, new ActionListener<>() {
                 @Override
                 public void onResponse(IndexResponse indexResponse) {
                     listener.onResponse(true);
@@ -68,7 +101,9 @@ public void onFailure(Exception e) {
                 }
             });
         } catch (IOException ioe) {
-            logger.warn((Supplier<?>)() -> new ParameterizedMessage("[{}] Error serialising DataCounts stats", jobId), ioe);
+            String msg = new ParameterizedMessage("[{}] Failed writing data_counts stats", jobId).getFormattedMessage();
+            logger.error(msg, ioe);
+            listener.onFailure(ExceptionsHelper.serverError(msg, ioe));
         }
     }
 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsPersister.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsPersister.java
index 783706259a17b..b9a3fbaa570bb 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsPersister.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsPersister.java
@@ -8,16 +8,16 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
-import org.elasticsearch.action.ActionFuture;
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.DocWriteRequest;
 import org.elasticsearch.action.DocWriteResponse.Result;
 import org.elasticsearch.action.admin.indices.refresh.RefreshRequest;
+import org.elasticsearch.action.bulk.BulkItemResponse;
 import org.elasticsearch.action.bulk.BulkRequest;
 import org.elasticsearch.action.bulk.BulkResponse;
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.index.IndexResponse;
 import org.elasticsearch.action.support.IndicesOptions;
-import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
@@ -39,11 +39,14 @@
 import org.elasticsearch.xpack.core.ml.job.results.Influencer;
 import org.elasticsearch.xpack.core.ml.job.results.ModelPlot;
 import org.elasticsearch.xpack.core.ml.utils.ToXContentParams;
+import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 
 import java.io.IOException;
 import java.util.Collections;
 import java.util.List;
 import java.util.Objects;
+import java.util.function.Supplier;
 
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
 import static org.elasticsearch.xpack.core.ClientHelper.ML_ORIGIN;
@@ -70,24 +73,34 @@ public class JobResultsPersister {
     private static final Logger logger = LogManager.getLogger(JobResultsPersister.class);
 
     private final Client client;
+    private final ResultsPersisterService resultsPersisterService;
+    private final AnomalyDetectionAuditor auditor;
 
-    public JobResultsPersister(Client client) {
+    public JobResultsPersister(Client client,
+                               ResultsPersisterService resultsPersisterService,
+                               AnomalyDetectionAuditor auditor) {
         this.client = client;
+        this.resultsPersisterService = resultsPersisterService;
+        this.auditor = auditor;
     }
 
-    public Builder bulkPersisterBuilder(String jobId) {
-        return new Builder(jobId);
+    public Builder bulkPersisterBuilder(String jobId, Supplier<Boolean> shouldRetry) {
+        return new Builder(jobId, resultsPersisterService, shouldRetry);
     }
 
     public class Builder {
         private BulkRequest bulkRequest;
         private final String jobId;
         private final String indexName;
+        private final Supplier<Boolean> shouldRetry;
+        private final ResultsPersisterService resultsPersisterService;
 
-        private Builder(String jobId) {
+        private Builder(String jobId, ResultsPersisterService resultsPersisterService, Supplier<Boolean> shouldRetry) {
             this.jobId = Objects.requireNonNull(jobId);
             indexName = AnomalyDetectorsIndex.resultsWriteAlias(jobId);
             bulkRequest = new BulkRequest();
+            this.shouldRetry = shouldRetry;
+            this.resultsPersisterService = resultsPersisterService;
         }
 
         /**
@@ -213,14 +226,9 @@ public void executeRequest() {
                 return;
             }
             logger.trace("[{}] ES API CALL: bulk request with {} actions", jobId, bulkRequest.numberOfActions());
-
-            try (ThreadContext.StoredContext ignore = client.threadPool().getThreadContext().stashWithOrigin(ML_ORIGIN)) {
-                BulkResponse addRecordsResponse = client.bulk(bulkRequest).actionGet();
-                if (addRecordsResponse.hasFailures()) {
-                    logger.error("[{}] Bulk index of results has errors: {}", jobId, addRecordsResponse.buildFailureMessage());
-                }
-            }
-
+            resultsPersisterService.bulkIndexWithRetry(bulkRequest, jobId, shouldRetry, (msg) -> {
+                auditor.warning(jobId, "Bulk indexing of results failed " + msg);
+            });
             bulkRequest = new BulkRequest();
         }
 
@@ -235,10 +243,10 @@ BulkRequest getBulkRequest() {
      *
      * @param category The category to be persisted
      */
-    public void persistCategoryDefinition(CategoryDefinition category) {
+    public void persistCategoryDefinition(CategoryDefinition category, Supplier<Boolean> shouldRetry) {
         Persistable persistable = new Persistable(category.getJobId(), category, category.getId());
 
-        persistable.persist(AnomalyDetectorsIndex.resultsWriteAlias(category.getJobId())).actionGet();
+        persistable.persist(AnomalyDetectorsIndex.resultsWriteAlias(category.getJobId()), shouldRetry);
         // Don't commit as we expect masses of these updates and they're not
         // read again by this process
     }
@@ -246,9 +254,9 @@ public void persistCategoryDefinition(CategoryDefinition category) {
     /**
      * Persist the quantiles (blocking)
      */
-    public void persistQuantiles(Quantiles quantiles) {
+    public void persistQuantiles(Quantiles quantiles, Supplier<Boolean> shouldRetry) {
         Persistable persistable = new Persistable(quantiles.getJobId(), quantiles, Quantiles.documentId(quantiles.getJobId()));
-        persistable.persist(AnomalyDetectorsIndex.jobStateIndexWriteAlias()).actionGet();
+        persistable.persist(AnomalyDetectorsIndex.jobStateIndexWriteAlias(), shouldRetry);
     }
 
     /**
@@ -263,20 +271,22 @@ public void persistQuantiles(Quantiles quantiles, WriteRequest.RefreshPolicy ref
     /**
      * Persist a model snapshot description
      */
-    public IndexResponse persistModelSnapshot(ModelSnapshot modelSnapshot, WriteRequest.RefreshPolicy refreshPolicy) {
+    public BulkResponse persistModelSnapshot(ModelSnapshot modelSnapshot,
+                                             WriteRequest.RefreshPolicy refreshPolicy,
+                                             Supplier<Boolean> shouldRetry) {
         Persistable persistable = new Persistable(modelSnapshot.getJobId(), modelSnapshot, ModelSnapshot.documentId(modelSnapshot));
         persistable.setRefreshPolicy(refreshPolicy);
-        return persistable.persist(AnomalyDetectorsIndex.resultsWriteAlias(modelSnapshot.getJobId())).actionGet();
+        return persistable.persist(AnomalyDetectorsIndex.resultsWriteAlias(modelSnapshot.getJobId()), shouldRetry);
     }
 
     /**
      * Persist the memory usage data (blocking)
      */
-    public void persistModelSizeStats(ModelSizeStats modelSizeStats) {
+    public void persistModelSizeStats(ModelSizeStats modelSizeStats, Supplier<Boolean> shouldRetry) {
         String jobId = modelSizeStats.getJobId();
         logger.trace("[{}] Persisting model size stats, for size {}", jobId, modelSizeStats.getModelBytes());
         Persistable persistable = new Persistable(jobId, modelSizeStats, modelSizeStats.getId());
-        persistable.persist(AnomalyDetectorsIndex.resultsWriteAlias(jobId)).actionGet();
+        persistable.persist(AnomalyDetectorsIndex.resultsWriteAlias(jobId), shouldRetry);
     }
 
     /**
@@ -341,7 +351,7 @@ public void commitStateWrites(String jobId) {
      * @param timingStats datafeed timing stats to persist
      * @param refreshPolicy refresh policy to apply
      */
-    public IndexResponse persistDatafeedTimingStats(DatafeedTimingStats timingStats, WriteRequest.RefreshPolicy refreshPolicy) {
+    public BulkResponse persistDatafeedTimingStats(DatafeedTimingStats timingStats, WriteRequest.RefreshPolicy refreshPolicy) {
         String jobId = timingStats.getJobId();
         logger.trace("[{}] Persisting datafeed timing stats", jobId);
         Persistable persistable = new Persistable(
@@ -350,7 +360,7 @@ public IndexResponse persistDatafeedTimingStats(DatafeedTimingStats timingStats,
             new ToXContent.MapParams(Collections.singletonMap(ToXContentParams.FOR_INTERNAL_STORAGE, "true")),
             DatafeedTimingStats.documentId(timingStats.getJobId()));
         persistable.setRefreshPolicy(refreshPolicy);
-        return persistable.persist(AnomalyDetectorsIndex.resultsWriteAlias(jobId)).actionGet();
+        return persistable.persist(AnomalyDetectorsIndex.resultsWriteAlias(jobId), () -> true);
     }
 
     private static XContentBuilder toXContentBuilder(ToXContent obj, ToXContent.Params params) throws IOException {
@@ -383,10 +393,25 @@ void setRefreshPolicy(WriteRequest.RefreshPolicy refreshPolicy) {
             this.refreshPolicy = refreshPolicy;
         }
 
-        ActionFuture<IndexResponse> persist(String indexName) {
-            PlainActionFuture<IndexResponse> actionFuture = PlainActionFuture.newFuture();
-            persist(indexName, actionFuture);
-            return actionFuture;
+        BulkResponse persist(String indexName, Supplier<Boolean> shouldRetry) {
+            logCall(indexName);
+            try {
+                return resultsPersisterService.indexWithRetry(jobId,
+                    indexName,
+                    object,
+                    params,
+                    refreshPolicy,
+                    id,
+                    shouldRetry,
+                    (msg) -> auditor.warning(jobId, id + " " + msg));
+            } catch (IOException e) {
+                logger.error(new ParameterizedMessage("[{}] Error writing [{}]", jobId, (id == null) ? "auto-generated ID" : id), e);
+                IndexResponse.Builder notCreatedResponse = new IndexResponse.Builder();
+                notCreatedResponse.setResult(Result.NOOP);
+                return new BulkResponse(
+                    new BulkItemResponse[]{new BulkItemResponse(0, DocWriteRequest.OpType.INDEX, notCreatedResponse.build())},
+                    0);
+            }
         }
 
         void persist(String indexName, ActionListener<IndexResponse> listener) {
@@ -411,4 +436,5 @@ private void logCall(String indexName) {
             }
         }
     }
+
 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/DataCountsReporter.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/DataCountsReporter.java
index dff118011b147..1d3a42b5fa9b6 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/DataCountsReporter.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/DataCountsReporter.java
@@ -7,7 +7,6 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.DataCounts;
 import org.elasticsearch.xpack.ml.job.persistence.JobDataCountsPersister;
@@ -229,13 +228,13 @@ public long getAnalysedFieldsPerRecord() {
     /**
      * Report the counts now regardless of whether or not we are at a reporting boundary.
      */
-    public void finishReporting(ActionListener<Boolean> listener) {
+    public void finishReporting() {
         Date now = new Date();
         incrementalRecordStats.setLastDataTimeStamp(now);
         totalRecordStats.setLastDataTimeStamp(now);
         diagnostics.flush();
         retrieveDiagnosticsIntermediateResults();
-        dataCountsPersister.persistDataCounts(job.getId(), runningTotalStats(), listener);
+        dataCountsPersister.persistDataCounts(job.getId(), runningTotalStats());
     }
 
     /**
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessor.java
index c9441e9f60c39..422f13926d441 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessor.java
@@ -10,6 +10,7 @@
 import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.DocWriteResponse;
+import org.elasticsearch.action.bulk.BulkResponse;
 import org.elasticsearch.action.index.IndexResponse;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.client.Client;
@@ -109,8 +110,7 @@ public AutodetectResultProcessor(Client client,
     // Visible for testing
     AutodetectResultProcessor(Client client, AnomalyDetectionAuditor auditor, String jobId, Renormalizer renormalizer,
                               JobResultsPersister persister, AutodetectProcess autodetectProcess, ModelSizeStats latestModelSizeStats,
-                              TimingStats timingStats,
-                              FlushListener flushListener) {
+                              TimingStats timingStats, FlushListener flushListener) {
         this.client = Objects.requireNonNull(client);
         this.auditor = Objects.requireNonNull(auditor);
         this.jobId = Objects.requireNonNull(jobId);
@@ -119,7 +119,7 @@ public AutodetectResultProcessor(Client client,
         this.process = Objects.requireNonNull(autodetectProcess);
         this.flushListener = Objects.requireNonNull(flushListener);
         this.latestModelSizeStats = Objects.requireNonNull(latestModelSizeStats);
-        this.bulkResultsPersister = persister.bulkPersisterBuilder(jobId);
+        this.bulkResultsPersister = persister.bulkPersisterBuilder(jobId, this::isAlive);
         this.timingStatsReporter = new TimingStatsReporter(timingStats, bulkResultsPersister);
         this.deleteInterimRequired = true;
     }
@@ -177,10 +177,7 @@ private void readResults() {
                         LOGGER.trace("[{}] Bucket number {} parsed from output", jobId, bucketCount);
                     }
                 } catch (Exception e) {
-                    if (processKilled) {
-                        throw e;
-                    }
-                    if (process.isProcessAliveAfterWaiting() == false) {
+                    if (isAlive() == false) {
                         throw e;
                     }
                     LOGGER.warn(new ParameterizedMessage("[{}] Error processing autodetect result", jobId), e);
@@ -215,7 +212,6 @@ void processResult(AutodetectResult result) {
             // results are also interim
             timingStatsReporter.reportBucket(bucket);
             bulkResultsPersister.persistBucket(bucket).executeRequest();
-
             ++bucketCount;
         }
         List<AnomalyRecord> records = result.getRecords();
@@ -228,7 +224,7 @@ void processResult(AutodetectResult result) {
         }
         CategoryDefinition categoryDefinition = result.getCategoryDefinition();
         if (categoryDefinition != null) {
-            persister.persistCategoryDefinition(categoryDefinition);
+            persister.persistCategoryDefinition(categoryDefinition, this::isAlive);
         }
         ModelPlot modelPlot = result.getModelPlot();
         if (modelPlot != null) {
@@ -264,7 +260,9 @@ void processResult(AutodetectResult result) {
         ModelSnapshot modelSnapshot = result.getModelSnapshot();
         if (modelSnapshot != null) {
             // We need to refresh in order for the snapshot to be available when we try to update the job with it
-            IndexResponse indexResponse = persister.persistModelSnapshot(modelSnapshot, WriteRequest.RefreshPolicy.IMMEDIATE);
+            BulkResponse bulkResponse = persister.persistModelSnapshot(modelSnapshot, WriteRequest.RefreshPolicy.IMMEDIATE, this::isAlive);
+            assert bulkResponse.getItems().length == 1;
+            IndexResponse indexResponse = bulkResponse.getItems()[0].getResponse();
             if (indexResponse.getResult() == DocWriteResponse.Result.CREATED) {
                 updateModelSnapshotOnJob(modelSnapshot);
             }
@@ -272,7 +270,7 @@ void processResult(AutodetectResult result) {
         Quantiles quantiles = result.getQuantiles();
         if (quantiles != null) {
             LOGGER.debug("[{}] Parsed Quantiles with timestamp {}", jobId, quantiles.getTimestamp());
-            persister.persistQuantiles(quantiles);
+            persister.persistQuantiles(quantiles, this::isAlive);
             bulkResultsPersister.executeRequest();
 
             if (processKilled == false && renormalizer.isEnabled()) {
@@ -316,7 +314,7 @@ private void processModelSizeStats(ModelSizeStats modelSizeStats) {
                 modelSizeStats.getTotalOverFieldCount(), modelSizeStats.getTotalPartitionFieldCount(),
                 modelSizeStats.getBucketAllocationFailuresCount(), modelSizeStats.getMemoryStatus());
 
-        persister.persistModelSizeStats(modelSizeStats);
+        persister.persistModelSizeStats(modelSizeStats, this::isAlive);
         notifyModelMemoryStatusChange(modelSizeStats);
         latestModelSizeStats = modelSizeStats;
     }
@@ -435,6 +433,13 @@ boolean isDeleteInterimRequired() {
         return deleteInterimRequired;
     }
 
+    private boolean isAlive() {
+        if (processKilled) {
+            return false;
+        }
+        return process.isProcessAliveAfterWaiting();
+    }
+
     void setDeleteInterimRequired(boolean deleteInterimRequired) {
         this.deleteInterimRequired = deleteInterimRequired;
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/CsvDataToProcessWriter.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/CsvDataToProcessWriter.java
index 887b43d0b5927..efa5f767720c4 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/CsvDataToProcessWriter.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/CsvDataToProcessWriter.java
@@ -7,7 +7,6 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.xpack.ml.job.categorization.CategorizationAnalyzer;
 import org.elasticsearch.xpack.core.ml.job.config.AnalysisConfig;
@@ -128,11 +127,8 @@ public void write(InputStream inputStream, CategorizationAnalyzer categorization
                 transformTimeAndWrite(record, inputFieldCount);
             }
 
-            // This function can throw
-            dataCountsReporter.finishReporting(ActionListener.wrap(
-                    response -> handler.accept(dataCountsReporter.incrementalStats(), null),
-                    e -> handler.accept(null, e)
-            ));
+            dataCountsReporter.finishReporting();
+            handler.accept(dataCountsReporter.incrementalStats(), null);
         }
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/JsonDataToProcessWriter.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/JsonDataToProcessWriter.java
index 92fe2c3b0b50a..59c138cba3758 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/JsonDataToProcessWriter.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/JsonDataToProcessWriter.java
@@ -7,7 +7,6 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentFactory;
@@ -53,7 +52,7 @@ class JsonDataToProcessWriter extends AbstractDataToProcessWriter {
      * the OutputStream. No transformation is applied to the data the timestamp
      * is expected in seconds from the epoch. If any of the fields in
      * <code>analysisFields</code> or the <code>DataDescription</code>s
-     * timeField is missing from the JOSN inputIndex an exception is thrown
+     * timeField is missing from the JSON inputIndex an exception is thrown
      */
     @Override
     public void write(InputStream inputStream, CategorizationAnalyzer categorizationAnalyzer, XContentType xContentType,
@@ -70,12 +69,8 @@ public void write(InputStream inputStream, CategorizationAnalyzer categorization
                     + "] is not supported by JsonDataToProcessWriter");
         }
 
-        // this line can throw and will be propagated
-        dataCountsReporter.finishReporting(
-                ActionListener.wrap(
-                        response -> handler.accept(dataCountsReporter.incrementalStats(), null),
-                        e -> handler.accept(null, e)
-                ));
+        dataCountsReporter.finishReporting();
+        handler.accept(dataCountsReporter.incrementalStats(), null);
     }
 
     private void writeJsonXContent(CategorizationAnalyzer categorizationAnalyzer, InputStream inputStream) throws IOException {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterService.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterService.java
new file mode 100644
index 0000000000000..6aad7d6a4f9b8
--- /dev/null
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterService.java
@@ -0,0 +1,173 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.utils.persistence;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.action.bulk.BulkItemResponse;
+import org.elasticsearch.action.bulk.BulkRequest;
+import org.elasticsearch.action.bulk.BulkResponse;
+import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.action.support.WriteRequest;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.Randomness;
+import org.elasticsearch.common.settings.Setting;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentFactory;
+
+import java.io.IOException;
+import java.time.Duration;
+import java.util.Arrays;
+import java.util.Random;
+import java.util.Set;
+import java.util.function.Consumer;
+import java.util.function.Supplier;
+import java.util.stream.Collectors;
+
+
+import static org.elasticsearch.xpack.core.ClientHelper.ML_ORIGIN;
+
+public class ResultsPersisterService {
+    private static final Logger LOGGER = LogManager.getLogger(ResultsPersisterService.class);
+
+    public static final Setting<Integer> PERSIST_RESULTS_MAX_RETRIES = Setting.intSetting(
+        "xpack.ml.persist_results_max_retries",
+        20,
+        0,
+        50,
+        Setting.Property.Dynamic,
+        Setting.Property.NodeScope);
+    private static final int MAX_RETRY_SLEEP_MILLIS = (int)Duration.ofMinutes(15).toMillis();
+    private static final int MIN_RETRY_SLEEP_MILLIS = 50;
+    // Having an exponent higher than this causes integer overflow
+    private static final int MAX_RETRY_EXPONENT = 24;
+
+    private final Random random = Randomness.get();
+    private final Client client;
+    private volatile int maxFailureRetries;
+
+    public ResultsPersisterService(Client client, ClusterService clusterService, Settings settings) {
+        this.client = client;
+        this.maxFailureRetries = PERSIST_RESULTS_MAX_RETRIES.get(settings);
+        clusterService.getClusterSettings()
+            .addSettingsUpdateConsumer(PERSIST_RESULTS_MAX_RETRIES, this::setMaxFailureRetries);
+    }
+
+    void setMaxFailureRetries(int value) {
+        this.maxFailureRetries = value;
+    }
+
+    public BulkResponse indexWithRetry(String jobId,
+                                       String indexName,
+                                       ToXContent object,
+                                       ToXContent.Params params,
+                                       WriteRequest.RefreshPolicy refreshPolicy,
+                                       String id,
+                                       Supplier<Boolean> shouldRetry,
+                                       Consumer<String> msgHandler) throws IOException {
+        BulkRequest bulkRequest = new BulkRequest().setRefreshPolicy(refreshPolicy);
+        try (XContentBuilder content = object.toXContent(XContentFactory.jsonBuilder(), params)) {
+            bulkRequest.add(new IndexRequest(indexName).id(id).source(content));
+        }
+        return bulkIndexWithRetry(bulkRequest, jobId, shouldRetry, msgHandler);
+    }
+
+    public BulkResponse bulkIndexWithRetry(BulkRequest bulkRequest,
+                                           String jobId,
+                                           Supplier<Boolean> shouldRetry,
+                                           Consumer<String> msgHandler) {
+        int currentMin = MIN_RETRY_SLEEP_MILLIS;
+        int currentMax = MIN_RETRY_SLEEP_MILLIS;
+        int currentAttempt = 0;
+        BulkResponse bulkResponse = null;
+        while(currentAttempt <= maxFailureRetries) {
+            bulkResponse = bulkIndex(bulkRequest);
+            if (bulkResponse.hasFailures() == false) {
+                return bulkResponse;
+            }
+            if (shouldRetry.get() == false) {
+                throw new ElasticsearchException("[{}] failed to index all results. {}", jobId, bulkResponse.buildFailureMessage());
+            }
+            if (currentAttempt > maxFailureRetries) {
+                LOGGER.warn("[{}] failed to index after [{}] attempts. Setting [xpack.ml.persist_results_max_retries] was reduced",
+                    jobId,
+                    currentAttempt);
+                throw new ElasticsearchException("[{}] failed to index all results after [{}] attempts. {}",
+                    jobId,
+                    currentAttempt,
+                    bulkResponse.buildFailureMessage());
+            }
+            currentAttempt++;
+            // Since we exponentially increase, we don't want force randomness to have an excessively long sleep
+            if (currentMax < MAX_RETRY_SLEEP_MILLIS) {
+                currentMin = currentMax;
+            }
+            // Exponential backoff calculation taken from: https://en.wikipedia.org/wiki/Exponential_backoff
+            int uncappedBackoff = ((1 << Math.min(currentAttempt, MAX_RETRY_EXPONENT)) - 1) * (50);
+            currentMax = Math.min(uncappedBackoff, MAX_RETRY_SLEEP_MILLIS);
+            // Its good to have a random window along the exponentially increasing curve
+            // so that not all bulk requests rest for the same amount of time
+            int randBound = 1 + (currentMax - currentMin);
+            int randSleep = currentMin + random.nextInt(randBound);
+            {
+                String msg = new ParameterizedMessage(
+                    "failed to index after [{}] attempts. Will attempt again in [{}].",
+                    currentAttempt,
+                    TimeValue.timeValueMillis(randSleep).getStringRep())
+                    .getFormattedMessage();
+                LOGGER.warn(()-> new ParameterizedMessage("[{}] {}", jobId, msg));
+                msgHandler.accept(msg);
+            }
+            // We should only retry the docs that failed.
+            bulkRequest = buildNewRequestFromFailures(bulkRequest, bulkResponse);
+            try {
+                Thread.sleep(randSleep);
+            } catch (InterruptedException interruptedException) {
+                LOGGER.warn(
+                    new ParameterizedMessage("[{}] failed to index after [{}] attempts due to interruption",
+                        jobId,
+                        currentAttempt),
+                    interruptedException);
+                Thread.currentThread().interrupt();
+            }
+        }
+        String bulkFailureMessage = bulkResponse == null ? "" : bulkResponse.buildFailureMessage();
+        LOGGER.warn("[{}] failed to index after [{}] attempts.", jobId, currentAttempt);
+        throw new ElasticsearchException("[{}] failed to index all results after [{}] attempts. {}",
+            jobId,
+            currentAttempt,
+            bulkFailureMessage);
+    }
+
+    private BulkResponse bulkIndex(BulkRequest bulkRequest) {
+        try (ThreadContext.StoredContext ignore = client.threadPool().getThreadContext().stashWithOrigin(ML_ORIGIN)) {
+            return client.bulk(bulkRequest).actionGet();
+        }
+    }
+
+    private BulkRequest buildNewRequestFromFailures(BulkRequest bulkRequest, BulkResponse bulkResponse) {
+        // If we failed, lets set the bulkRequest to be a collection of the failed requests
+        BulkRequest bulkRequestOfFailures = new BulkRequest();
+        Set<String> failedDocIds = Arrays.stream(bulkResponse.getItems())
+            .filter(BulkItemResponse::isFailed)
+            .map(BulkItemResponse::getId)
+            .collect(Collectors.toSet());
+        bulkRequest.requests().forEach(docWriteRequest -> {
+            if (failedDocIds.contains(docWriteRequest.id())) {
+                bulkRequestOfFailures.add(docWriteRequest);
+            }
+        });
+        return bulkRequestOfFailures;
+    }
+
+}
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/AutodetectResultProcessorIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/AutodetectResultProcessorIT.java
index f6ec2fc9b89f1..a46e83d2488fe 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/AutodetectResultProcessorIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/AutodetectResultProcessorIT.java
@@ -6,13 +6,19 @@
 package org.elasticsearch.xpack.ml.integration;
 
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
+import org.elasticsearch.cluster.routing.OperationRouting;
 import org.elasticsearch.cluster.routing.UnassignedInfo;
+import org.elasticsearch.cluster.service.ClusterApplierService;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.cluster.service.MasterService;
 import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.index.reindex.ReindexPlugin;
 import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.ml.action.DeleteJobAction;
 import org.elasticsearch.xpack.core.ml.action.PutJobAction;
 import org.elasticsearch.xpack.core.action.util.QueryPage;
@@ -33,6 +39,7 @@
 import org.elasticsearch.xpack.core.ml.job.results.ModelPlot;
 import org.elasticsearch.xpack.ml.LocalStateMachineLearning;
 import org.elasticsearch.xpack.ml.MlSingleNodeTestCase;
+import org.elasticsearch.xpack.ml.inference.ingest.InferenceProcessor;
 import org.elasticsearch.xpack.ml.job.persistence.BucketsQueryBuilder;
 import org.elasticsearch.xpack.ml.job.persistence.InfluencersQueryBuilder;
 import org.elasticsearch.xpack.ml.job.persistence.JobResultsPersister;
@@ -46,10 +53,12 @@
 import org.elasticsearch.xpack.ml.job.results.CategoryDefinitionTests;
 import org.elasticsearch.xpack.ml.job.results.ModelPlotTests;
 import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 import org.junit.After;
 import org.junit.Before;
 
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.Date;
@@ -77,6 +86,7 @@ public class AutodetectResultProcessorIT extends MlSingleNodeTestCase {
     private AutodetectResultProcessor resultProcessor;
     private Renormalizer renormalizer;
     private AutodetectProcess process;
+    private ResultsPersisterService resultsPersisterService;
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
@@ -92,12 +102,24 @@ public void createComponents() throws Exception {
         renormalizer = mock(Renormalizer.class);
         process = mock(AutodetectProcess.class);
         capturedUpdateModelSnapshotOnJobRequests = new ArrayList<>();
+        ThreadPool tp = mock(ThreadPool.class);
+        Settings settings = Settings.builder().put("node.name", "InferenceProcessorFactoryTests_node").build();
+        ClusterSettings clusterSettings = new ClusterSettings(settings,
+            new HashSet<>(Arrays.asList(InferenceProcessor.MAX_INFERENCE_PROCESSORS,
+                MasterService.MASTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING,
+                OperationRouting.USE_ADAPTIVE_REPLICA_SELECTION_SETTING,
+                ClusterService.USER_DEFINED_META_DATA,
+                ResultsPersisterService.PERSIST_RESULTS_MAX_RETRIES,
+                ClusterApplierService.CLUSTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING)));
+        ClusterService clusterService = new ClusterService(settings, clusterSettings, tp);
+
+        resultsPersisterService = new ResultsPersisterService(client(), clusterService, settings);
         resultProcessor = new AutodetectResultProcessor(
                 client(),
                 auditor,
                 JOB_ID,
                 renormalizer,
-                new JobResultsPersister(client()),
+                new JobResultsPersister(client(), resultsPersisterService, new AnomalyDetectionAuditor(client(), "test_node")),
                 process,
                 new ModelSizeStats.Builder(JOB_ID).build(),
                 new TimingStats(JOB_ID)) {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/EstablishedMemUsageIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/EstablishedMemUsageIT.java
index a026d5d6c337b..1a7f60cd81d54 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/EstablishedMemUsageIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/EstablishedMemUsageIT.java
@@ -5,22 +5,34 @@
  */
 package org.elasticsearch.xpack.ml.integration;
 
+import org.elasticsearch.cluster.routing.OperationRouting;
+import org.elasticsearch.cluster.service.ClusterApplierService;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.cluster.service.MasterService;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.ml.action.PutJobAction;
 import org.elasticsearch.xpack.core.ml.job.config.AnalysisConfig;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.ModelSizeStats;
 import org.elasticsearch.xpack.core.ml.job.results.Bucket;
+import org.elasticsearch.xpack.ml.inference.ingest.InferenceProcessor;
 import org.elasticsearch.xpack.ml.job.persistence.JobResultsProvider;
 import org.elasticsearch.xpack.ml.job.persistence.JobResultsPersister;
+import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
 import org.elasticsearch.xpack.ml.support.BaseMlIntegTestCase;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 import org.junit.Before;
 
+import java.util.Arrays;
 import java.util.Date;
+import java.util.HashSet;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.atomic.AtomicReference;
 
 import static org.hamcrest.CoreMatchers.equalTo;
+import static org.mockito.Mockito.mock;
 
 public class EstablishedMemUsageIT extends BaseMlIntegTestCase {
 
@@ -32,8 +44,21 @@ public class EstablishedMemUsageIT extends BaseMlIntegTestCase {
     @Before
     public void createComponents() {
         Settings settings = nodeSettings(0);
+        ThreadPool tp = mock(ThreadPool.class);
+        ClusterSettings clusterSettings = new ClusterSettings(settings,
+            new HashSet<>(Arrays.asList(InferenceProcessor.MAX_INFERENCE_PROCESSORS,
+                MasterService.MASTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING,
+                ResultsPersisterService.PERSIST_RESULTS_MAX_RETRIES,
+                OperationRouting.USE_ADAPTIVE_REPLICA_SELECTION_SETTING,
+                ClusterService.USER_DEFINED_META_DATA,
+                ClusterApplierService.CLUSTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING)));
+        ClusterService clusterService = new ClusterService(settings, clusterSettings, tp);
+
+        ResultsPersisterService resultsPersisterService = new ResultsPersisterService(client(), clusterService, settings);
         jobResultsProvider = new JobResultsProvider(client(), settings);
-        jobResultsPersister = new JobResultsPersister(client());
+        jobResultsPersister = new JobResultsPersister(client(),
+            resultsPersisterService,
+            new AnomalyDetectionAuditor(client(), "test_node"));
     }
 
     public void testEstablishedMem_givenNoResults() throws Exception {
@@ -222,7 +247,7 @@ private void initClusterAndJob(String jobId) {
     }
 
     private void createBuckets(String jobId, int count) {
-        JobResultsPersister.Builder builder = jobResultsPersister.bulkPersisterBuilder(jobId);
+        JobResultsPersister.Builder builder = jobResultsPersister.bulkPersisterBuilder(jobId, () -> true);
         for (int i = 1; i <= count; ++i) {
             Bucket bucket = new Bucket(jobId, new Date(bucketSpan * i), bucketSpan);
             builder.persistBucket(bucket);
@@ -235,7 +260,7 @@ private ModelSizeStats createModelSizeStats(String jobId, int bucketNum, long mo
                 .setTimestamp(new Date(bucketSpan * bucketNum))
                 .setLogTime(new Date(bucketSpan * bucketNum + randomIntBetween(1, 1000)))
                 .setModelBytes(modelBytes).build();
-        jobResultsPersister.persistModelSizeStats(modelSizeStats);
+        jobResultsPersister.persistModelSizeStats(modelSizeStats, () -> true);
         return modelSizeStats;
     }
 
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/JobResultsProviderIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/JobResultsProviderIT.java
index bde16f7e9ac07..540ee7b5adfc3 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/JobResultsProviderIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/JobResultsProviderIT.java
@@ -15,14 +15,20 @@
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.cluster.metadata.MappingMetaData;
+import org.elasticsearch.cluster.routing.OperationRouting;
 import org.elasticsearch.cluster.routing.UnassignedInfo;
+import org.elasticsearch.cluster.service.ClusterApplierService;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.cluster.service.MasterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.collect.ImmutableOpenMap;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
+import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.ml.MlMetaIndex;
 import org.elasticsearch.xpack.core.ml.MlMetadata;
 import org.elasticsearch.xpack.core.ml.action.PutJobAction;
@@ -46,12 +52,15 @@
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.Quantiles;
 import org.elasticsearch.xpack.core.ml.utils.ToXContentParams;
 import org.elasticsearch.xpack.ml.MlSingleNodeTestCase;
+import org.elasticsearch.xpack.ml.inference.ingest.InferenceProcessor;
 import org.elasticsearch.xpack.ml.job.persistence.CalendarQueryBuilder;
 import org.elasticsearch.xpack.ml.job.persistence.JobDataCountsPersister;
 import org.elasticsearch.xpack.ml.job.persistence.JobResultsPersister;
 import org.elasticsearch.xpack.ml.job.persistence.JobResultsProvider;
 import org.elasticsearch.xpack.ml.job.persistence.ScheduledEventsQueryBuilder;
 import org.elasticsearch.xpack.ml.job.process.autodetect.params.AutodetectParams;
+import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 import org.junit.Before;
 
 import java.io.IOException;
@@ -73,17 +82,32 @@
 import static org.hamcrest.Matchers.not;
 import static org.hamcrest.collection.IsEmptyCollection.empty;
 import static org.hamcrest.core.Is.is;
+import static org.mockito.Mockito.mock;
 
 
 public class JobResultsProviderIT extends MlSingleNodeTestCase {
 
     private JobResultsProvider jobProvider;
+    private ResultsPersisterService resultsPersisterService;
+    private AnomalyDetectionAuditor auditor;
 
     @Before
     public void createComponents() throws Exception {
         Settings.Builder builder = Settings.builder()
                 .put(UnassignedInfo.INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), TimeValue.timeValueSeconds(1));
         jobProvider = new JobResultsProvider(client(), builder.build());
+        ThreadPool tp = mock(ThreadPool.class);
+        ClusterSettings clusterSettings = new ClusterSettings(builder.build(),
+            new HashSet<>(Arrays.asList(InferenceProcessor.MAX_INFERENCE_PROCESSORS,
+                MasterService.MASTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING,
+                OperationRouting.USE_ADAPTIVE_REPLICA_SELECTION_SETTING,
+                ResultsPersisterService.PERSIST_RESULTS_MAX_RETRIES,
+                ClusterService.USER_DEFINED_META_DATA,
+                ClusterApplierService.CLUSTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING)));
+        ClusterService clusterService = new ClusterService(builder.build(), clusterSettings, tp);
+
+        resultsPersisterService = new ResultsPersisterService(client(), clusterService, builder.build());
+        auditor = new AnomalyDetectionAuditor(client(), "test_node");
         waitForMlTemplates();
     }
 
@@ -574,29 +598,9 @@ private void indexScheduledEvents(List<ScheduledEvent> events) throws IOExceptio
         }
     }
 
-    private void indexDataCounts(DataCounts counts, String jobId) throws Exception {
-        JobDataCountsPersister persister = new JobDataCountsPersister(client());
-
-        AtomicReference<Exception> errorHolder = new AtomicReference<>();
-        CountDownLatch latch = new CountDownLatch(1);
-        persister.persistDataCounts(jobId, counts, new ActionListener<Boolean>() {
-            @Override
-            public void onResponse(Boolean aBoolean) {
-                assertTrue(aBoolean);
-                latch.countDown();
-            }
-
-            @Override
-            public void onFailure(Exception e) {
-                errorHolder.set(e);
-                latch.countDown();
-            }
-        });
-
-        latch.await();
-        if (errorHolder.get() != null) {
-            throw errorHolder.get();
-        }
+    private void indexDataCounts(DataCounts counts, String jobId) {
+        JobDataCountsPersister persister = new JobDataCountsPersister(client(), resultsPersisterService, auditor);
+        persister.persistDataCounts(jobId, counts);
     }
 
     private void indexFilters(List<MlFilter> filters) throws IOException {
@@ -616,18 +620,18 @@ private void indexFilters(List<MlFilter> filters) throws IOException {
     }
 
     private void indexModelSizeStats(ModelSizeStats modelSizeStats) {
-        JobResultsPersister persister = new JobResultsPersister(client());
-        persister.persistModelSizeStats(modelSizeStats);
+        JobResultsPersister persister = new JobResultsPersister(client(), resultsPersisterService, auditor);
+        persister.persistModelSizeStats(modelSizeStats, () -> true);
     }
 
     private void indexModelSnapshot(ModelSnapshot snapshot) {
-        JobResultsPersister persister = new JobResultsPersister(client());
-        persister.persistModelSnapshot(snapshot, WriteRequest.RefreshPolicy.IMMEDIATE);
+        JobResultsPersister persister = new JobResultsPersister(client(), resultsPersisterService, auditor);
+        persister.persistModelSnapshot(snapshot, WriteRequest.RefreshPolicy.IMMEDIATE, () -> true);
     }
 
     private void indexQuantiles(Quantiles quantiles) {
-        JobResultsPersister persister = new JobResultsPersister(client());
-        persister.persistQuantiles(quantiles);
+        JobResultsPersister persister = new JobResultsPersister(client(), resultsPersisterService, auditor);
+        persister.persistQuantiles(quantiles, () -> true);
     }
 
     private void indexCalendars(List<Calendar> calendars) throws IOException {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsPersisterTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsPersisterTests.java
index 09e5cf9ce6331..7bf719878c157 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsPersisterTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsPersisterTests.java
@@ -6,17 +6,19 @@
 package org.elasticsearch.xpack.ml.job.persistence;
 
 import org.elasticsearch.action.ActionFuture;
-import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.bulk.BulkItemResponse;
 import org.elasticsearch.action.bulk.BulkRequest;
 import org.elasticsearch.action.bulk.BulkResponse;
 import org.elasticsearch.action.index.IndexRequest;
-import org.elasticsearch.action.index.IndexResponse;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.routing.OperationRouting;
+import org.elasticsearch.cluster.service.ClusterApplierService;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.cluster.service.MasterService;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
-import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.ml.datafeed.DatafeedTimingStats;
@@ -27,19 +29,23 @@
 import org.elasticsearch.xpack.core.ml.job.results.Influencer;
 import org.elasticsearch.xpack.core.ml.job.results.ModelPlot;
 import org.elasticsearch.xpack.core.ml.utils.ExponentialAverageCalculationContext;
+import org.elasticsearch.xpack.ml.inference.ingest.InferenceProcessor;
+import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 import org.mockito.ArgumentCaptor;
 
-import java.io.IOException;
 import java.time.Instant;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.Date;
+import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.mockito.Matchers.any;
-import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.doNothing;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
@@ -51,7 +57,7 @@ public class JobResultsPersisterTests extends ESTestCase {
 
     private static final String JOB_ID = "foo";
 
-    public void testPersistBucket_OneRecord() throws IOException {
+    public void testPersistBucket_OneRecord() {
         ArgumentCaptor<BulkRequest> captor = ArgumentCaptor.forClass(BulkRequest.class);
         Client client = mockClient(captor);
         Bucket bucket = new Bucket("foo", new Date(), 123456);
@@ -72,8 +78,8 @@ public void testPersistBucket_OneRecord() throws IOException {
         AnomalyRecord record = new AnomalyRecord(JOB_ID, new Date(), 600);
         bucket.setRecords(Collections.singletonList(record));
 
-        JobResultsPersister persister = new JobResultsPersister(client);
-        persister.bulkPersisterBuilder(JOB_ID).persistBucket(bucket).executeRequest();
+        JobResultsPersister persister = new JobResultsPersister(client, buildResultsPersisterService(client), makeAuditor());
+        persister.bulkPersisterBuilder(JOB_ID, () -> true).persistBucket(bucket).executeRequest();
         BulkRequest bulkRequest = captor.getValue();
         assertEquals(2, bulkRequest.numberOfActions());
 
@@ -94,7 +100,7 @@ public void testPersistBucket_OneRecord() throws IOException {
         assertTrue(s.matches(".*raw_anomaly_score.:19\\.19.*"));
     }
 
-    public void testPersistRecords() throws IOException {
+    public void testPersistRecords() {
         ArgumentCaptor<BulkRequest> captor = ArgumentCaptor.forClass(BulkRequest.class);
         Client client = mockClient(captor);
 
@@ -124,8 +130,8 @@ public void testPersistRecords() throws IOException {
         typicals.add(998765.3);
         r1.setTypical(typicals);
 
-        JobResultsPersister persister = new JobResultsPersister(client);
-        persister.bulkPersisterBuilder(JOB_ID).persistRecords(records).executeRequest();
+        JobResultsPersister persister = new JobResultsPersister(client, buildResultsPersisterService(client), makeAuditor());
+        persister.bulkPersisterBuilder(JOB_ID, () -> true).persistRecords(records).executeRequest();
         BulkRequest bulkRequest = captor.getValue();
         assertEquals(1, bulkRequest.numberOfActions());
 
@@ -149,7 +155,7 @@ public void testPersistRecords() throws IOException {
         assertTrue(s.matches(".*over_field_value.:.overValue.*"));
     }
 
-    public void testPersistInfluencers() throws IOException {
+    public void testPersistInfluencers() {
         ArgumentCaptor<BulkRequest> captor = ArgumentCaptor.forClass(BulkRequest.class);
         Client client = mockClient(captor);
 
@@ -160,8 +166,8 @@ public void testPersistInfluencers() throws IOException {
         inf.setProbability(0.4);
         influencers.add(inf);
 
-        JobResultsPersister persister = new JobResultsPersister(client);
-        persister.bulkPersisterBuilder(JOB_ID).persistInfluencers(influencers).executeRequest();
+        JobResultsPersister persister = new JobResultsPersister(client, buildResultsPersisterService(client), makeAuditor());
+        persister.bulkPersisterBuilder(JOB_ID, () -> true).persistInfluencers(influencers).executeRequest();
         BulkRequest bulkRequest = captor.getValue();
         assertEquals(1, bulkRequest.numberOfActions());
 
@@ -176,7 +182,7 @@ public void testPersistInfluencers() throws IOException {
     public void testExecuteRequest_ClearsBulkRequest() {
         ArgumentCaptor<BulkRequest> captor = ArgumentCaptor.forClass(BulkRequest.class);
         Client client = mockClient(captor);
-        JobResultsPersister persister = new JobResultsPersister(client);
+        JobResultsPersister persister = new JobResultsPersister(client, buildResultsPersisterService(client), makeAuditor());
 
         List<Influencer> influencers = new ArrayList<>();
         Influencer inf = new Influencer(JOB_ID, "infName1", "infValue1", new Date(), 600);
@@ -185,7 +191,7 @@ public void testExecuteRequest_ClearsBulkRequest() {
         inf.setProbability(0.4);
         influencers.add(inf);
 
-        JobResultsPersister.Builder builder = persister.bulkPersisterBuilder(JOB_ID);
+        JobResultsPersister.Builder builder = persister.bulkPersisterBuilder(JOB_ID, () -> true);
         builder.persistInfluencers(influencers).executeRequest();
         assertEquals(0, builder.getBulkRequest().numberOfActions());
     }
@@ -193,9 +199,9 @@ public void testExecuteRequest_ClearsBulkRequest() {
     public void testBulkRequestExecutesWhenReachMaxDocs() {
         ArgumentCaptor<BulkRequest> captor = ArgumentCaptor.forClass(BulkRequest.class);
         Client client = mockClient(captor);
-        JobResultsPersister persister = new JobResultsPersister(client);
+        JobResultsPersister persister = new JobResultsPersister(client, buildResultsPersisterService(client), makeAuditor());
 
-        JobResultsPersister.Builder bulkBuilder = persister.bulkPersisterBuilder("foo");
+        JobResultsPersister.Builder bulkBuilder = persister.bulkPersisterBuilder("foo", () -> true);
         ModelPlot modelPlot = new ModelPlot("foo", new Date(), 123456, 0);
         for (int i=0; i<=JobRenormalizedResultsPersister.BULK_LIMIT; i++) {
             bulkBuilder.persistModelPlot(modelPlot);
@@ -210,11 +216,11 @@ public void testPersistTimingStats() {
         ArgumentCaptor<BulkRequest> bulkRequestCaptor = ArgumentCaptor.forClass(BulkRequest.class);
         Client client = mockClient(bulkRequestCaptor);
 
-        JobResultsPersister persister = new JobResultsPersister(client);
+        JobResultsPersister persister = new JobResultsPersister(client, buildResultsPersisterService(client), makeAuditor());
         TimingStats timingStats =
             new TimingStats(
                 "foo", 7, 1.0, 2.0, 1.23, 7.89, new ExponentialAverageCalculationContext(600.0, Instant.ofEpochMilli(123456789), 60.0));
-        persister.bulkPersisterBuilder(JOB_ID).persistTimingStats(timingStats).executeRequest();
+        persister.bulkPersisterBuilder(JOB_ID, () -> true).persistTimingStats(timingStats).executeRequest();
 
         verify(client, times(1)).bulk(bulkRequestCaptor.capture());
         BulkRequest bulkRequest = bulkRequestCaptor.getValue();
@@ -245,28 +251,20 @@ public void testPersistTimingStats() {
     @SuppressWarnings({"unchecked", "rawtypes"})
     public void testPersistDatafeedTimingStats() {
         Client client = mockClient(ArgumentCaptor.forClass(BulkRequest.class));
-        doAnswer(
-            invocationOnMock -> {
-                // Take the listener passed to client::index as 2nd argument
-                ActionListener listener = (ActionListener) invocationOnMock.getArguments()[1];
-                // Handle the response on the listener
-                listener.onResponse(new IndexResponse(new ShardId("test", "test", 0), "test", 0, 0, 0, false));
-                return null;
-            })
-            .when(client).index(any(), any(ActionListener.class));
-
-        JobResultsPersister persister = new JobResultsPersister(client);
+        JobResultsPersister persister = new JobResultsPersister(client, buildResultsPersisterService(client), makeAuditor());
         DatafeedTimingStats timingStats =
             new DatafeedTimingStats(
                 "foo", 6, 66, 666.0, new ExponentialAverageCalculationContext(600.0, Instant.ofEpochMilli(123456789), 60.0));
         persister.persistDatafeedTimingStats(timingStats, WriteRequest.RefreshPolicy.IMMEDIATE);
 
-        ArgumentCaptor<IndexRequest> indexRequestCaptor = ArgumentCaptor.forClass(IndexRequest.class);
-        verify(client, times(1)).index(indexRequestCaptor.capture(), any(ActionListener.class));
-        IndexRequest indexRequest = indexRequestCaptor.getValue();
+        ArgumentCaptor<BulkRequest> indexRequestCaptor = ArgumentCaptor.forClass(BulkRequest.class);
+        verify(client, times(1)).bulk(indexRequestCaptor.capture());
+
+        // Refresh policy is set on the bulk request, not the individual index requests
+        assertThat(indexRequestCaptor.getValue().getRefreshPolicy(), equalTo(WriteRequest.RefreshPolicy.IMMEDIATE));
+        IndexRequest indexRequest = (IndexRequest)indexRequestCaptor.getValue().requests().get(0);
         assertThat(indexRequest.index(), equalTo(".ml-anomalies-.write-foo"));
         assertThat(indexRequest.id(), equalTo("foo_datafeed_timing_stats"));
-        assertThat(indexRequest.getRefreshPolicy(), equalTo(WriteRequest.RefreshPolicy.IMMEDIATE));
         assertThat(
             indexRequest.sourceAsMap(),
             equalTo(
@@ -285,15 +283,51 @@ public void testPersistDatafeedTimingStats() {
         verifyNoMoreInteractions(client);
     }
 
-    @SuppressWarnings({"unchecked"})
     private Client mockClient(ArgumentCaptor<BulkRequest> captor) {
+        return mockClientWithResponse(captor, new BulkResponse(new BulkItemResponse[0], 0L));
+    }
+
+    @SuppressWarnings("unchecked")
+    private Client mockClientWithResponse(ArgumentCaptor<BulkRequest> captor, BulkResponse... responses) {
         Client client = mock(Client.class);
         ThreadPool threadPool = mock(ThreadPool.class);
         when(client.threadPool()).thenReturn(threadPool);
         when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
-        ActionFuture<BulkResponse> future = mock(ActionFuture.class);
-        when(future.actionGet()).thenReturn(new BulkResponse(new BulkItemResponse[0], 0L));
-        when(client.bulk(captor.capture())).thenReturn(future);
+        List<ActionFuture<BulkResponse>> futures = new ArrayList<>(responses.length - 1);
+        ActionFuture<BulkResponse> future1 = makeFuture(responses[0]);
+        for (int i = 1; i < responses.length; i++) {
+            futures.add(makeFuture(responses[i]));
+        }
+        when(client.bulk(captor.capture())).thenReturn(future1, futures.toArray(ActionFuture[]::new));
         return client;
     }
+
+    @SuppressWarnings("unchecked")
+    private static ActionFuture<BulkResponse> makeFuture(BulkResponse response) {
+        ActionFuture<BulkResponse> future = mock(ActionFuture.class);
+        when(future.actionGet()).thenReturn(response);
+        return future;
+    }
+
+    private ResultsPersisterService buildResultsPersisterService(Client client) {
+        ThreadPool tp = mock(ThreadPool.class);
+        ClusterSettings clusterSettings = new ClusterSettings(Settings.EMPTY,
+            new HashSet<>(Arrays.asList(InferenceProcessor.MAX_INFERENCE_PROCESSORS,
+                MasterService.MASTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING,
+                OperationRouting.USE_ADAPTIVE_REPLICA_SELECTION_SETTING,
+                ResultsPersisterService.PERSIST_RESULTS_MAX_RETRIES,
+                ClusterService.USER_DEFINED_META_DATA,
+                ClusterApplierService.CLUSTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING)));
+        ClusterService clusterService = new ClusterService(Settings.EMPTY, clusterSettings, tp);
+
+        return new ResultsPersisterService(client, clusterService, Settings.EMPTY);
+    }
+
+    private AnomalyDetectionAuditor makeAuditor() {
+        AnomalyDetectionAuditor anomalyDetectionAuditor = mock(AnomalyDetectionAuditor.class);
+        doNothing().when(anomalyDetectionAuditor).warning(any(), any());
+        doNothing().when(anomalyDetectionAuditor).info(any(), any());
+        doNothing().when(anomalyDetectionAuditor).error(any(), any());
+        return anomalyDetectionAuditor;
+    }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/DataCountsReporterTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/DataCountsReporterTests.java
index 5415b46019196..e9faff382edb3 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/DataCountsReporterTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/DataCountsReporterTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.ml.job.process;
 
-import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.core.ml.job.config.AnalysisConfig;
@@ -17,7 +16,6 @@
 import org.junit.Before;
 import org.mockito.Mockito;
 
-import java.io.IOException;
 import java.util.Arrays;
 import java.util.Date;
 import java.util.concurrent.TimeUnit;
@@ -26,6 +24,7 @@
 import static org.mockito.Matchers.anyString;
 import static org.mockito.Matchers.eq;
 import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
 
 public class DataCountsReporterTests extends ESTestCase {
@@ -50,14 +49,14 @@ public void setUpMocks() {
         jobDataCountsPersister = Mockito.mock(JobDataCountsPersister.class);
     }
 
-    public void testSimpleConstructor() throws Exception {
+    public void testSimpleConstructor() {
         DataCountsReporter dataCountsReporter = new DataCountsReporter(job, new DataCounts(job.getId()), jobDataCountsPersister);
         DataCounts stats = dataCountsReporter.incrementalStats();
         assertNotNull(stats);
         assertAllCountFieldsEqualZero(stats);
     }
 
-    public void testComplexConstructor() throws Exception {
+    public void testComplexConstructor() {
         DataCounts counts = new DataCounts("foo", 1L, 1L, 2L, 0L, 3L, 4L, 5L, 6L, 7L, 8L,
                 new Date(), new Date(), new Date(), new Date(), new Date());
 
@@ -77,7 +76,7 @@ public void testComplexConstructor() throws Exception {
         assertNull(stats.getEarliestRecordTimeStamp());
     }
 
-    public void testResetIncrementalCounts() throws Exception {
+    public void testResetIncrementalCounts() {
         DataCountsReporter dataCountsReporter = new DataCountsReporter(job, new DataCounts(job.getId()), jobDataCountsPersister);
         DataCounts stats = dataCountsReporter.incrementalStats();
         assertNotNull(stats);
@@ -119,7 +118,7 @@ public void testResetIncrementalCounts() throws Exception {
         assertEquals(602000, dataCountsReporter.runningTotalStats().getLatestRecordTimeStamp().getTime());
 
         // send 'flush' signal
-        dataCountsReporter.finishReporting(ActionListener.wrap(r -> {}, e -> {}));
+        dataCountsReporter.finishReporting();
         assertEquals(2, dataCountsReporter.runningTotalStats().getBucketCount());
         assertEquals(1, dataCountsReporter.runningTotalStats().getEmptyBucketCount());
         assertEquals(0, dataCountsReporter.runningTotalStats().getSparseBucketCount());
@@ -129,7 +128,7 @@ public void testResetIncrementalCounts() throws Exception {
         assertEquals(0, dataCountsReporter.incrementalStats().getSparseBucketCount());
     }
 
-    public void testReportLatestTimeIncrementalStats() throws IOException {
+    public void testReportLatestTimeIncrementalStats() {
         DataCountsReporter dataCountsReporter = new DataCountsReporter(job, new DataCounts(job.getId()), jobDataCountsPersister);
         dataCountsReporter.startNewIncrementalCount();
         dataCountsReporter.reportLatestTimeIncrementalStats(5001L);
@@ -157,7 +156,7 @@ public void testReportRecordsWritten() {
 
         assertEquals(dataCountsReporter.incrementalStats(), dataCountsReporter.runningTotalStats());
 
-        verify(jobDataCountsPersister, never()).persistDataCounts(anyString(), any(DataCounts.class), any());
+        verify(jobDataCountsPersister, never()).persistDataCounts(anyString(), any(DataCounts.class));
     }
 
     public void testReportRecordsWritten_Given9999Records() {
@@ -256,7 +255,7 @@ public void testFinishReporting() {
         dataCountsReporter.reportRecordWritten(5, 2000);
         dataCountsReporter.reportRecordWritten(5, 3000);
         dataCountsReporter.reportMissingField();
-        dataCountsReporter.finishReporting(ActionListener.wrap(r -> {}, e -> {}));
+        dataCountsReporter.finishReporting();
 
         long lastReportedTimeMs = dataCountsReporter.incrementalStats().getLastDataTimeStamp().getTime();
         // check last data time is equal to now give or take a second
@@ -266,11 +265,11 @@ public void testFinishReporting() {
                 dataCountsReporter.runningTotalStats().getLastDataTimeStamp());
 
         dc.setLastDataTimeStamp(dataCountsReporter.incrementalStats().getLastDataTimeStamp());
-        Mockito.verify(jobDataCountsPersister, Mockito.times(1)).persistDataCounts(eq("sr"), eq(dc), any());
+        verify(jobDataCountsPersister, times(1)).persistDataCounts(eq("sr"), eq(dc));
         assertEquals(dc, dataCountsReporter.incrementalStats());
     }
 
-    private void assertAllCountFieldsEqualZero(DataCounts stats) throws Exception {
+    private void assertAllCountFieldsEqualZero(DataCounts stats) {
         assertEquals(0L, stats.getProcessedRecordCount());
         assertEquals(0L, stats.getProcessedFieldCount());
         assertEquals(0L, stats.getInputBytes());
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/AutodetectCommunicatorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/AutodetectCommunicatorTests.java
index 4562779fc292f..e9fbaf4bbb0d5 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/AutodetectCommunicatorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/AutodetectCommunicatorTests.java
@@ -6,7 +6,6 @@
 package org.elasticsearch.xpack.ml.job.process.autodetect;
 
 import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentType;
@@ -55,6 +54,7 @@
 import static org.mockito.Matchers.any;
 import static org.mockito.Matchers.anyString;
 import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.doNothing;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.never;
 import static org.mockito.Mockito.times;
@@ -235,10 +235,7 @@ private AutodetectCommunicator createAutodetectCommunicator(ExecutorService exec
                                                                 AutodetectResultProcessor autodetectResultProcessor,
                                                                 BiConsumer<Exception, Boolean> finishHandler) throws IOException {
         DataCountsReporter dataCountsReporter = mock(DataCountsReporter.class);
-        doAnswer(invocation -> {
-            ((ActionListener<Boolean>) invocation.getArguments()[0]).onResponse(true);
-            return null;
-        }).when(dataCountsReporter).finishReporting(any());
+        doNothing().when(dataCountsReporter).finishReporting();
         return new AutodetectCommunicator(createJobDetails(), environment, autodetectProcess,
                 stateStreamer, dataCountsReporter, autodetectResultProcessor, finishHandler,
                 new NamedXContentRegistry(Collections.emptyList()), executorService);
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/AutodetectProcessManagerTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/AutodetectProcessManagerTests.java
index 72bdf45a96c4a..09a92e57d0432 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/AutodetectProcessManagerTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/AutodetectProcessManagerTests.java
@@ -54,6 +54,7 @@
 import org.elasticsearch.xpack.ml.job.process.normalizer.NormalizerFactory;
 import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
 import org.elasticsearch.xpack.ml.process.NativeStorageProvider;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 import org.junit.Before;
 import org.mockito.ArgumentCaptor;
 
@@ -61,6 +62,7 @@
 import java.io.IOException;
 import java.io.InputStream;
 import java.nio.charset.StandardCharsets;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.Date;
 import java.util.HashSet;
@@ -143,7 +145,7 @@ public void setup() throws Exception {
         jobManager = mock(JobManager.class);
         jobResultsProvider = mock(JobResultsProvider.class);
         jobResultsPersister = mock(JobResultsPersister.class);
-        when(jobResultsPersister.bulkPersisterBuilder(any())).thenReturn(mock(JobResultsPersister.Builder.class));
+        when(jobResultsPersister.bulkPersisterBuilder(any(), any())).thenReturn(mock(JobResultsPersister.Builder.class));
         jobDataCountsPersister = mock(JobDataCountsPersister.class);
         autodetectCommunicator = mock(AutodetectCommunicator.class);
         autodetectFactory = mock(AutodetectProcessFactory.class);
@@ -151,7 +153,9 @@ public void setup() throws Exception {
         auditor = mock(AnomalyDetectionAuditor.class);
         clusterService = mock(ClusterService.class);
         ClusterSettings clusterSettings =
-            new ClusterSettings(Settings.EMPTY, Collections.singleton(MachineLearning.MAX_OPEN_JOBS_PER_NODE));
+            new ClusterSettings(Settings.EMPTY,
+                new HashSet<>(Arrays.asList(MachineLearning.MAX_OPEN_JOBS_PER_NODE,
+                    ResultsPersisterService.PERSIST_RESULTS_MAX_RETRIES)));
         when(clusterService.getClusterSettings()).thenReturn(clusterSettings);
         MetaData metaData = mock(MetaData.class);
         SortedMap<String, AliasOrIndex> aliasOrIndexSortedMap = new TreeMap<>();
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessorTests.java
index 63ca73444b540..2f31015b575c7 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessorTests.java
@@ -8,6 +8,9 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.Version;
+import org.elasticsearch.action.DocWriteRequest;
+import org.elasticsearch.action.bulk.BulkItemResponse;
+import org.elasticsearch.action.bulk.BulkResponse;
 import org.elasticsearch.action.index.IndexResponse;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.client.Client;
@@ -95,7 +98,7 @@ public void setUpMocks() {
         renormalizer = mock(Renormalizer.class);
         persister = mock(JobResultsPersister.class);
         bulkBuilder = mock(JobResultsPersister.Builder.class);
-        when(persister.bulkPersisterBuilder(JOB_ID)).thenReturn(bulkBuilder);
+        when(persister.bulkPersisterBuilder(eq(JOB_ID), any())).thenReturn(bulkBuilder);
         process = mock(AutodetectProcess.class);
         flushListener = mock(FlushListener.class);
         processorUnderTest = new AutodetectResultProcessor(
@@ -125,12 +128,12 @@ public void testProcess() throws TimeoutException {
         assertThat(processorUnderTest.completionLatch.getCount(), is(equalTo(0L)));
 
         verify(renormalizer).waitUntilIdle();
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
         verify(persister).commitResultWrites(JOB_ID);
         verify(persister).commitStateWrites(JOB_ID);
     }
 
-    public void testProcessResult_bucket() {
+    public void testProcessResult_bucket() throws Exception {
         when(bulkBuilder.persistTimingStats(any(TimingStats.class))).thenReturn(bulkBuilder);
         when(bulkBuilder.persistBucket(any(Bucket.class))).thenReturn(bulkBuilder);
         AutodetectResult result = mock(AutodetectResult.class);
@@ -143,11 +146,11 @@ public void testProcessResult_bucket() {
         verify(bulkBuilder).persistTimingStats(any(TimingStats.class));
         verify(bulkBuilder).persistBucket(bucket);
         verify(bulkBuilder).executeRequest();
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
         verify(persister, never()).deleteInterimResults(JOB_ID);
     }
 
-    public void testProcessResult_bucket_deleteInterimRequired() {
+    public void testProcessResult_bucket_deleteInterimRequired() throws Exception {
         when(bulkBuilder.persistTimingStats(any(TimingStats.class))).thenReturn(bulkBuilder);
         when(bulkBuilder.persistBucket(any(Bucket.class))).thenReturn(bulkBuilder);
         AutodetectResult result = mock(AutodetectResult.class);
@@ -160,11 +163,11 @@ public void testProcessResult_bucket_deleteInterimRequired() {
         verify(bulkBuilder).persistTimingStats(any(TimingStats.class));
         verify(bulkBuilder).persistBucket(bucket);
         verify(bulkBuilder).executeRequest();
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
         verify(persister).deleteInterimResults(JOB_ID);
     }
 
-    public void testProcessResult_records() {
+    public void testProcessResult_records() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         List<AnomalyRecord> records =
             Arrays.asList(
@@ -177,10 +180,10 @@ public void testProcessResult_records() {
 
         verify(bulkBuilder).persistRecords(records);
         verify(bulkBuilder, never()).executeRequest();
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
     }
 
-    public void testProcessResult_influencers() {
+    public void testProcessResult_influencers() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         List<Influencer> influencers =
             Arrays.asList(
@@ -193,10 +196,10 @@ public void testProcessResult_influencers() {
 
         verify(bulkBuilder).persistInfluencers(influencers);
         verify(bulkBuilder, never()).executeRequest();
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
     }
 
-    public void testProcessResult_categoryDefinition() {
+    public void testProcessResult_categoryDefinition() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         CategoryDefinition categoryDefinition = mock(CategoryDefinition.class);
         when(result.getCategoryDefinition()).thenReturn(categoryDefinition);
@@ -205,11 +208,11 @@ public void testProcessResult_categoryDefinition() {
         processorUnderTest.processResult(result);
 
         verify(bulkBuilder, never()).executeRequest();
-        verify(persister).persistCategoryDefinition(categoryDefinition);
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).persistCategoryDefinition(eq(categoryDefinition), any());
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
     }
 
-    public void testProcessResult_flushAcknowledgement() {
+    public void testProcessResult_flushAcknowledgement() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         FlushAcknowledgement flushAcknowledgement = mock(FlushAcknowledgement.class);
         when(flushAcknowledgement.getId()).thenReturn(JOB_ID);
@@ -219,13 +222,13 @@ public void testProcessResult_flushAcknowledgement() {
         processorUnderTest.processResult(result);
         assertTrue(processorUnderTest.isDeleteInterimRequired());
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
         verify(flushListener).acknowledgeFlush(flushAcknowledgement, null);
         verify(persister).commitResultWrites(JOB_ID);
         verify(bulkBuilder).executeRequest();
     }
 
-    public void testProcessResult_flushAcknowledgementMustBeProcessedLast() {
+    public void testProcessResult_flushAcknowledgementMustBeProcessedLast() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         FlushAcknowledgement flushAcknowledgement = mock(FlushAcknowledgement.class);
         when(flushAcknowledgement.getId()).thenReturn(JOB_ID);
@@ -238,14 +241,14 @@ public void testProcessResult_flushAcknowledgementMustBeProcessedLast() {
         assertTrue(processorUnderTest.isDeleteInterimRequired());
 
         InOrder inOrder = inOrder(persister, bulkBuilder, flushListener);
-        inOrder.verify(persister).bulkPersisterBuilder(JOB_ID);
-        inOrder.verify(persister).persistCategoryDefinition(categoryDefinition);
+        inOrder.verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        inOrder.verify(persister).persistCategoryDefinition(eq(categoryDefinition), any());
         inOrder.verify(bulkBuilder).executeRequest();
         inOrder.verify(persister).commitResultWrites(JOB_ID);
         inOrder.verify(flushListener).acknowledgeFlush(flushAcknowledgement, null);
     }
 
-    public void testProcessResult_modelPlot() {
+    public void testProcessResult_modelPlot() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         ModelPlot modelPlot = mock(ModelPlot.class);
         when(result.getModelPlot()).thenReturn(modelPlot);
@@ -253,11 +256,11 @@ public void testProcessResult_modelPlot() {
         processorUnderTest.setDeleteInterimRequired(false);
         processorUnderTest.processResult(result);
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
         verify(bulkBuilder).persistModelPlot(modelPlot);
     }
 
-    public void testProcessResult_modelSizeStats() {
+    public void testProcessResult_modelSizeStats() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         ModelSizeStats modelSizeStats = mock(ModelSizeStats.class);
         when(result.getModelSizeStats()).thenReturn(modelSizeStats);
@@ -266,11 +269,11 @@ public void testProcessResult_modelSizeStats() {
         processorUnderTest.processResult(result);
         assertThat(processorUnderTest.modelSizeStats(), is(equalTo(modelSizeStats)));
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
-        verify(persister).persistModelSizeStats(modelSizeStats);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        verify(persister).persistModelSizeStats(eq(modelSizeStats), any());
     }
 
-    public void testProcessResult_modelSizeStatsWithMemoryStatusChanges() {
+    public void testProcessResult_modelSizeStatsWithMemoryStatusChanges() throws Exception {
         TimeValue delay = TimeValue.timeValueSeconds(5);
         // Set up schedule delay time
         when(threadPool.schedule(any(Runnable.class), any(TimeValue.class), anyString()))
@@ -303,29 +306,30 @@ public void testProcessResult_modelSizeStatsWithMemoryStatusChanges() {
         when(result.getModelSizeStats()).thenReturn(modelSizeStats);
         processorUnderTest.processResult(result);
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
-        verify(persister, times(4)).persistModelSizeStats(any(ModelSizeStats.class));
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        verify(persister, times(4)).persistModelSizeStats(any(ModelSizeStats.class), any());
         // We should have only fired two notifications: one for soft_limit and one for hard_limit
         verify(auditor).warning(JOB_ID, Messages.getMessage(Messages.JOB_AUDIT_MEMORY_STATUS_SOFT_LIMIT));
         verify(auditor).error(JOB_ID, Messages.getMessage(Messages.JOB_AUDIT_MEMORY_STATUS_HARD_LIMIT, "512mb", "1kb"));
     }
 
-    public void testProcessResult_modelSnapshot() {
+    public void testProcessResult_modelSnapshot() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         ModelSnapshot modelSnapshot = new ModelSnapshot.Builder(JOB_ID)
             .setSnapshotId("a_snapshot_id")
             .setMinVersion(Version.CURRENT)
             .build();
         when(result.getModelSnapshot()).thenReturn(modelSnapshot);
+        IndexResponse indexResponse = new IndexResponse(new ShardId("ml", "uid", 0), "1", 0L, 0L, 0L, true);
 
-        when(persister.persistModelSnapshot(any(), any()))
-            .thenReturn(new IndexResponse(new ShardId("ml", "uid", 0), "1", 0L, 0L, 0L, true));
+        when(persister.persistModelSnapshot(any(), any(), any()))
+            .thenReturn(new BulkResponse(new BulkItemResponse[]{new BulkItemResponse(0, DocWriteRequest.OpType.INDEX, indexResponse)}, 0));
 
         processorUnderTest.setDeleteInterimRequired(false);
         processorUnderTest.processResult(result);
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
-        verify(persister).persistModelSnapshot(modelSnapshot, WriteRequest.RefreshPolicy.IMMEDIATE);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        verify(persister).persistModelSnapshot(eq(modelSnapshot), eq(WriteRequest.RefreshPolicy.IMMEDIATE), any());
 
         UpdateJobAction.Request expectedJobUpdateRequest = UpdateJobAction.Request.internal(JOB_ID,
                 new JobUpdate.Builder(JOB_ID).setModelSnapshotId("a_snapshot_id").build());
@@ -333,7 +337,7 @@ public void testProcessResult_modelSnapshot() {
         verify(client).execute(same(UpdateJobAction.INSTANCE), eq(expectedJobUpdateRequest), any());
     }
 
-    public void testProcessResult_quantiles_givenRenormalizationIsEnabled() {
+    public void testProcessResult_quantiles_givenRenormalizationIsEnabled() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         Quantiles quantiles = mock(Quantiles.class);
         when(result.getQuantiles()).thenReturn(quantiles);
@@ -342,15 +346,15 @@ public void testProcessResult_quantiles_givenRenormalizationIsEnabled() {
         processorUnderTest.setDeleteInterimRequired(false);
         processorUnderTest.processResult(result);
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
-        verify(persister).persistQuantiles(quantiles);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        verify(persister).persistQuantiles(eq(quantiles), any());
         verify(bulkBuilder).executeRequest();
         verify(persister).commitResultWrites(JOB_ID);
         verify(renormalizer).isEnabled();
         verify(renormalizer).renormalize(quantiles);
     }
 
-    public void testProcessResult_quantiles_givenRenormalizationIsDisabled() {
+    public void testProcessResult_quantiles_givenRenormalizationIsDisabled() throws Exception {
         AutodetectResult result = mock(AutodetectResult.class);
         Quantiles quantiles = mock(Quantiles.class);
         when(result.getQuantiles()).thenReturn(quantiles);
@@ -359,8 +363,8 @@ public void testProcessResult_quantiles_givenRenormalizationIsDisabled() {
         processorUnderTest.setDeleteInterimRequired(false);
         processorUnderTest.processResult(result);
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
-        verify(persister).persistQuantiles(quantiles);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        verify(persister).persistQuantiles(eq(quantiles), any());
         verify(bulkBuilder).executeRequest();
         verify(renormalizer).isEnabled();
     }
@@ -374,7 +378,7 @@ public void testAwaitCompletion() throws TimeoutException {
         assertThat(processorUnderTest.completionLatch.getCount(), is(equalTo(0L)));
         assertThat(processorUnderTest.updateModelSnapshotSemaphore.availablePermits(), is(equalTo(1)));
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
         verify(persister).commitResultWrites(JOB_ID);
         verify(persister).commitStateWrites(JOB_ID);
         verify(renormalizer).waitUntilIdle();
@@ -389,12 +393,12 @@ public void testPersisterThrowingDoesntBlockProcessing() {
         when(process.isProcessAliveAfterWaiting()).thenReturn(true);
         when(process.readAutodetectResults()).thenReturn(Arrays.asList(autodetectResult, autodetectResult).iterator());
 
-        doThrow(new ElasticsearchException("this test throws")).when(persister).persistModelSnapshot(any(), any());
+        doThrow(new ElasticsearchException("this test throws")).when(persister).persistModelSnapshot(any(), any(), any());
 
         processorUnderTest.process();
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
-        verify(persister, times(2)).persistModelSnapshot(any(), eq(WriteRequest.RefreshPolicy.IMMEDIATE));
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        verify(persister, times(2)).persistModelSnapshot(any(), eq(WriteRequest.RefreshPolicy.IMMEDIATE), any());
     }
 
     public void testParsingErrorSetsFailed() throws Exception {
@@ -412,7 +416,7 @@ public void testParsingErrorSetsFailed() throws Exception {
             processorUnderTest.waitForFlushAcknowledgement(JOB_ID, Duration.of(300, ChronoUnit.SECONDS));
         assertThat(flushAcknowledgement, is(nullValue()));
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
     }
 
     public void testKill() throws TimeoutException {
@@ -425,7 +429,7 @@ public void testKill() throws TimeoutException {
         assertThat(processorUnderTest.completionLatch.getCount(), is(equalTo(0L)));
         assertThat(processorUnderTest.updateModelSnapshotSemaphore.availablePermits(), is(equalTo(1)));
 
-        verify(persister).bulkPersisterBuilder(JOB_ID);
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
         verify(persister).commitResultWrites(JOB_ID);
         verify(persister).commitStateWrites(JOB_ID);
         verify(renormalizer, never()).renormalize(any());
@@ -433,4 +437,5 @@ public void testKill() throws TimeoutException {
         verify(renormalizer).waitUntilIdle();
         verify(flushListener).clear();
     }
+
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/CsvDataToProcessWriterTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/CsvDataToProcessWriterTests.java
index cf65eec4f04df..05604d0f876c2 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/CsvDataToProcessWriterTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/CsvDataToProcessWriterTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.ml.job.process.autodetect.writer;
 
-import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.env.Environment;
@@ -42,6 +41,7 @@
 import static org.mockito.Matchers.any;
 import static org.mockito.Matchers.anyLong;
 import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.doNothing;
 import static org.mockito.Mockito.never;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
@@ -106,7 +106,7 @@ public void testWrite_GivenTimeFormatIsEpochAndDataIsValid() throws IOException
         expectedRecords.add(new String[] { "2", "2.0", "" });
         assertWrittenRecordsEqualTo(expectedRecords);
 
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenTimeFormatIsEpochAndCategorization() throws IOException {
@@ -143,7 +143,7 @@ public void testWrite_GivenTimeFormatIsEpochAndCategorization() throws IOExcepti
         }
         assertWrittenRecordsEqualTo(expectedRecords);
 
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenTimeFormatIsEpochAndTimestampsAreOutOfOrder() throws IOException {
@@ -166,7 +166,7 @@ public void testWrite_GivenTimeFormatIsEpochAndTimestampsAreOutOfOrder() throws
 
         verify(dataCountsReporter, times(2)).reportOutOfOrderRecord(2);
         verify(dataCountsReporter, never()).reportLatestTimeIncrementalStats(anyLong());
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenTimeFormatIsEpochAndAllRecordsAreOutOfOrder() throws IOException {
@@ -190,7 +190,7 @@ public void testWrite_GivenTimeFormatIsEpochAndAllRecordsAreOutOfOrder() throws
         verify(dataCountsReporter, times(2)).reportOutOfOrderRecord(2);
         verify(dataCountsReporter, times(2)).reportLatestTimeIncrementalStats(anyLong());
         verify(dataCountsReporter, never()).reportRecordWritten(anyLong(), anyLong());
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenTimeFormatIsEpochAndSomeTimestampsWithinLatencySomeOutOfOrder() throws IOException {
@@ -224,7 +224,7 @@ public void testWrite_GivenTimeFormatIsEpochAndSomeTimestampsWithinLatencySomeOu
 
         verify(dataCountsReporter, times(1)).reportOutOfOrderRecord(2);
         verify(dataCountsReporter, never()).reportLatestTimeIncrementalStats(anyLong());
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_NullByte() throws IOException {
@@ -262,7 +262,7 @@ public void testWrite_NullByte() throws IOException {
         verify(dataCountsReporter, times(1)).reportRecordWritten(2, 3000);
         verify(dataCountsReporter, times(1)).reportRecordWritten(2, 4000);
         verify(dataCountsReporter, times(1)).reportDateParseError(2);
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     @SuppressWarnings("unchecked")
@@ -274,11 +274,7 @@ public void testWrite_EmptyInput() throws IOException {
 
         when(dataCountsReporter.incrementalStats()).thenReturn(new DataCounts("foo"));
 
-        doAnswer(invocation -> {
-            ActionListener<Boolean> listener = (ActionListener<Boolean>) invocation.getArguments()[0];
-            listener.onResponse(true);
-            return null;
-        }).when(dataCountsReporter).finishReporting(any());
+        doNothing().when(dataCountsReporter).finishReporting();
 
         InputStream inputStream = createInputStream("");
         CsvDataToProcessWriter writer = createWriter();
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/JsonDataToProcessWriterTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/JsonDataToProcessWriterTests.java
index f16b388edee6f..89ff28928fdae 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/JsonDataToProcessWriterTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/writer/JsonDataToProcessWriterTests.java
@@ -106,7 +106,7 @@ public void testWrite_GivenTimeFormatIsEpochAndDataIsValid() throws Exception {
         expectedRecords.add(new String[]{"2", "2.0", ""});
         assertWrittenRecordsEqualTo(expectedRecords);
 
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenTimeFormatIsEpochAndCategorization() throws Exception {
@@ -142,7 +142,7 @@ public void testWrite_GivenTimeFormatIsEpochAndCategorization() throws Exception
         }
         assertWrittenRecordsEqualTo(expectedRecords);
 
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenTimeFormatIsEpochAndTimestampsAreOutOfOrder() throws Exception {
@@ -164,7 +164,7 @@ public void testWrite_GivenTimeFormatIsEpochAndTimestampsAreOutOfOrder() throws
 
         verify(dataCountsReporter, times(2)).reportOutOfOrderRecord(2);
         verify(dataCountsReporter, never()).reportLatestTimeIncrementalStats(anyLong());
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenTimeFormatIsEpochAndSomeTimestampsWithinLatencySomeOutOfOrder() throws Exception {
@@ -195,7 +195,7 @@ public void testWrite_GivenTimeFormatIsEpochAndSomeTimestampsWithinLatencySomeOu
 
         verify(dataCountsReporter, times(1)).reportOutOfOrderRecord(2);
         verify(dataCountsReporter, never()).reportLatestTimeIncrementalStats(anyLong());
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenMalformedJsonWithoutNestedLevels() throws Exception {
@@ -223,7 +223,7 @@ public void testWrite_GivenMalformedJsonWithoutNestedLevels() throws Exception {
         assertWrittenRecordsEqualTo(expectedRecords);
 
         verify(dataCountsReporter).reportMissingFields(1);
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenMalformedJsonWithNestedLevels()
@@ -251,7 +251,7 @@ public void testWrite_GivenMalformedJsonWithNestedLevels()
         expectedRecords.add(new String[]{"3", "3.0", ""});
         assertWrittenRecordsEqualTo(expectedRecords);
 
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenMalformedJsonThatNeverRecovers()
@@ -293,7 +293,7 @@ public void testWrite_GivenJsonWithArrayField() throws Exception {
         expectedRecords.add(new String[]{"2", "2.0", ""});
         assertWrittenRecordsEqualTo(expectedRecords);
 
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_GivenJsonWithMissingFields() throws Exception {
@@ -330,7 +330,7 @@ public void testWrite_GivenJsonWithMissingFields() throws Exception {
         verify(dataCountsReporter, times(1)).reportRecordWritten(1, 3000);
         verify(dataCountsReporter, times(1)).reportRecordWritten(1, 4000);
         verify(dataCountsReporter, times(1)).reportDateParseError(0);
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     public void testWrite_Smile() throws Exception {
@@ -367,7 +367,7 @@ public void testWrite_Smile() throws Exception {
         expectedRecords.add(new String[]{"2", "2.0", ""});
         assertWrittenRecordsEqualTo(expectedRecords);
 
-        verify(dataCountsReporter).finishReporting(any());
+        verify(dataCountsReporter).finishReporting();
     }
 
     private static InputStream createInputStream(String input) {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterServiceTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterServiceTests.java
new file mode 100644
index 0000000000000..9d5b922ccb0c6
--- /dev/null
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterServiceTests.java
@@ -0,0 +1,203 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.utils.persistence;
+
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.action.ActionFuture;
+import org.elasticsearch.action.DocWriteRequest;
+import org.elasticsearch.action.bulk.BulkItemResponse;
+import org.elasticsearch.action.bulk.BulkRequest;
+import org.elasticsearch.action.bulk.BulkResponse;
+import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.action.index.IndexResponse;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.routing.OperationRouting;
+import org.elasticsearch.cluster.service.ClusterApplierService;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.cluster.service.MasterService;
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.index.shard.ShardId;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
+import org.elasticsearch.xpack.ml.inference.ingest.InferenceProcessor;
+import org.mockito.ArgumentCaptor;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.List;
+import java.util.concurrent.atomic.AtomicReference;
+import java.util.function.Consumer;
+
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.mockito.Matchers.any;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+public class ResultsPersisterServiceTests extends ESTestCase {
+
+    private final String JOB_ID = "results_persister_test_job";
+    private final Consumer<String> NULL_MSG_HANDLER = (msg) -> {};
+
+    public void testBulkRequestChangeOnFailures() {
+        IndexRequest indexRequestSuccess = new IndexRequest("my-index").id("success").source(Collections.singletonMap("data", "success"));
+        IndexRequest indexRequestFail = new IndexRequest("my-index").id("fail").source(Collections.singletonMap("data", "fail"));
+        BulkItemResponse successItem = new BulkItemResponse(1,
+            DocWriteRequest.OpType.INDEX,
+            new IndexResponse(new ShardId(AnomalyDetectorsIndex.jobResultsIndexPrefix() + "shared", "uuid", 1),
+                indexRequestSuccess.id(),
+                0,
+                0,
+                1,
+                true));
+        BulkItemResponse failureItem = new BulkItemResponse(2,
+            DocWriteRequest.OpType.INDEX,
+            new BulkItemResponse.Failure("my-index", "fail", new Exception("boom")));
+        BulkResponse withFailure = new BulkResponse(new BulkItemResponse[]{ failureItem, successItem }, 0L);
+        Client client = mockClientWithResponse(withFailure, new BulkResponse(new BulkItemResponse[0], 0L));
+
+        BulkRequest bulkRequest = new BulkRequest();
+        bulkRequest.add(indexRequestFail);
+        bulkRequest.add(indexRequestSuccess);
+
+        ResultsPersisterService resultsPersisterService = buildResultsPersisterService(client);
+
+        resultsPersisterService.bulkIndexWithRetry(bulkRequest, JOB_ID, () -> true, NULL_MSG_HANDLER);
+
+        ArgumentCaptor<BulkRequest> captor =  ArgumentCaptor.forClass(BulkRequest.class);
+        verify(client, times(2)).bulk(captor.capture());
+
+        List<BulkRequest> requests = captor.getAllValues();
+
+        assertThat(requests.get(0).numberOfActions(), equalTo(2));
+        assertThat(requests.get(1).numberOfActions(), equalTo(1));
+    }
+
+    public void testBulkRequestDoesNotRetryWhenSupplierIsFalse() {
+        IndexRequest indexRequestSuccess = new IndexRequest("my-index").id("success").source(Collections.singletonMap("data", "success"));
+        IndexRequest indexRequestFail = new IndexRequest("my-index").id("fail").source(Collections.singletonMap("data", "fail"));
+        BulkItemResponse successItem = new BulkItemResponse(1,
+            DocWriteRequest.OpType.INDEX,
+            new IndexResponse(new ShardId(AnomalyDetectorsIndex.jobResultsIndexPrefix() + "shared", "uuid", 1),
+                indexRequestSuccess.id(),
+                0,
+                0,
+                1,
+                true));
+        BulkItemResponse failureItem = new BulkItemResponse(2,
+            DocWriteRequest.OpType.INDEX,
+            new BulkItemResponse.Failure("my-index", "fail", new Exception("boom")));
+        BulkResponse withFailure = new BulkResponse(new BulkItemResponse[]{ failureItem, successItem }, 0L);
+        Client client = mockClientWithResponse(withFailure, new BulkResponse(new BulkItemResponse[0], 0L));
+
+        BulkRequest bulkRequest = new BulkRequest();
+        bulkRequest.add(indexRequestFail);
+        bulkRequest.add(indexRequestSuccess);
+
+        ResultsPersisterService resultsPersisterService = buildResultsPersisterService(client);
+
+        expectThrows(ElasticsearchException.class,
+            () -> resultsPersisterService.bulkIndexWithRetry(bulkRequest, JOB_ID, () -> false, NULL_MSG_HANDLER));
+    }
+
+    public void testBulkRequestRetriesConfiguredAttemptNumber() {
+        IndexRequest indexRequestFail = new IndexRequest("my-index").id("fail").source(Collections.singletonMap("data", "fail"));
+        BulkItemResponse failureItem = new BulkItemResponse(2,
+            DocWriteRequest.OpType.INDEX,
+            new BulkItemResponse.Failure("my-index", "fail", new Exception("boom")));
+        BulkResponse withFailure = new BulkResponse(new BulkItemResponse[]{ failureItem }, 0L);
+        Client client = mockClientWithResponse(withFailure);
+
+        BulkRequest bulkRequest = new BulkRequest();
+        bulkRequest.add(indexRequestFail);
+
+        ResultsPersisterService resultsPersisterService = buildResultsPersisterService(client);
+
+        resultsPersisterService.setMaxFailureRetries(1);
+        expectThrows(ElasticsearchException.class,
+            () -> resultsPersisterService.bulkIndexWithRetry(bulkRequest, JOB_ID, () -> true, NULL_MSG_HANDLER));
+        verify(client, times(2)).bulk(any(BulkRequest.class));
+    }
+
+    public void testBulkRequestRetriesMsgHandlerIsCalled() {
+        IndexRequest indexRequestSuccess = new IndexRequest("my-index").id("success").source(Collections.singletonMap("data", "success"));
+        IndexRequest indexRequestFail = new IndexRequest("my-index").id("fail").source(Collections.singletonMap("data", "fail"));
+        BulkItemResponse successItem = new BulkItemResponse(1,
+            DocWriteRequest.OpType.INDEX,
+            new IndexResponse(new ShardId(AnomalyDetectorsIndex.jobResultsIndexPrefix() + "shared", "uuid", 1),
+                indexRequestSuccess.id(),
+                0,
+                0,
+                1,
+                true));
+        BulkItemResponse failureItem = new BulkItemResponse(2,
+            DocWriteRequest.OpType.INDEX,
+            new BulkItemResponse.Failure("my-index", "fail", new Exception("boom")));
+        BulkResponse withFailure = new BulkResponse(new BulkItemResponse[]{ failureItem, successItem }, 0L);
+        Client client = mockClientWithResponse(withFailure, new BulkResponse(new BulkItemResponse[0], 0L));
+
+        BulkRequest bulkRequest = new BulkRequest();
+        bulkRequest.add(indexRequestFail);
+        bulkRequest.add(indexRequestSuccess);
+
+        ResultsPersisterService resultsPersisterService = buildResultsPersisterService(client);
+        AtomicReference<String> msgHolder = new AtomicReference<>("not_called");
+
+        resultsPersisterService.bulkIndexWithRetry(bulkRequest, JOB_ID, () -> true, msgHolder::set);
+
+        ArgumentCaptor<BulkRequest> captor =  ArgumentCaptor.forClass(BulkRequest.class);
+        verify(client, times(2)).bulk(captor.capture());
+
+        List<BulkRequest> requests = captor.getAllValues();
+
+        assertThat(requests.get(0).numberOfActions(), equalTo(2));
+        assertThat(requests.get(1).numberOfActions(), equalTo(1));
+        assertThat(msgHolder.get(), containsString("failed to index after [1] attempts. Will attempt again in"));
+    }
+
+    @SuppressWarnings("unchecked")
+    private Client mockClientWithResponse(BulkResponse... responses) {
+        Client client = mock(Client.class);
+        ThreadPool threadPool = mock(ThreadPool.class);
+        when(client.threadPool()).thenReturn(threadPool);
+        when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
+        List<ActionFuture<BulkResponse>> futures = new ArrayList<>(responses.length - 1);
+        ActionFuture<BulkResponse> future1 = makeFuture(responses[0]);
+        for (int i = 1; i < responses.length; i++) {
+            futures.add(makeFuture(responses[i]));
+        }
+        when(client.bulk(any(BulkRequest.class))).thenReturn(future1, futures.toArray(ActionFuture[]::new));
+        return client;
+    }
+
+    @SuppressWarnings("unchecked")
+    private static ActionFuture<BulkResponse> makeFuture(BulkResponse response) {
+        ActionFuture<BulkResponse> future = mock(ActionFuture.class);
+        when(future.actionGet()).thenReturn(response);
+        return future;
+    }
+
+    private ResultsPersisterService buildResultsPersisterService(Client client) {
+        ThreadPool tp = mock(ThreadPool.class);
+        ClusterSettings clusterSettings = new ClusterSettings(Settings.EMPTY,
+            new HashSet<>(Arrays.asList(InferenceProcessor.MAX_INFERENCE_PROCESSORS,
+                MasterService.MASTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING,
+                OperationRouting.USE_ADAPTIVE_REPLICA_SELECTION_SETTING,
+                ClusterService.USER_DEFINED_META_DATA,
+                ResultsPersisterService.PERSIST_RESULTS_MAX_RETRIES,
+                ClusterApplierService.CLUSTER_SERVICE_SLOW_TASK_LOGGING_THRESHOLD_SETTING)));
+        ClusterService clusterService = new ClusterService(Settings.EMPTY, clusterSettings, tp);
+
+        return new ResultsPersisterService(client, clusterService, Settings.EMPTY);
+    }
+}

From 2e476de636f4e792110a2fe5bf8083f291f33ca7 Mon Sep 17 00:00:00 2001
From: Zachary Tong <polyfractal@elastic.co>
Date: Thu, 12 Dec 2019 09:06:33 -0500
Subject: [PATCH 180/686] SingleBucket aggs need to reduce their bucket's
 pipelines first (#50103)

When decoupling the pipeline reduction from regular agg reduction,
MultiBucket aggs were modified to reduce their bucket's pipeline
aggs first before reducing the sibling aggs.  This modification
was missed on SingleBucket aggs, meaning any SingleBucket would
fail to reduce any pipeline sub-aggs
---
 .../InternalSingleBucketAggregation.java      | 16 ++++
 .../bucket/nested/NestedAggregatorTests.java  | 86 +++++++++++++++++++
 2 files changed, 102 insertions(+)

diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/InternalSingleBucketAggregation.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/InternalSingleBucketAggregation.java
index 0a34e7a92b8f1..bb0b2ad0a3050 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/InternalSingleBucketAggregation.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/InternalSingleBucketAggregation.java
@@ -109,6 +109,22 @@ public InternalAggregation reduce(List<InternalAggregation> aggregations, Reduce
         return newAggregation(getName(), docCount, aggs);
     }
 
+    /**
+     * Unlike {@link InternalAggregation#reducePipelines(InternalAggregation, ReduceContext)}, a single-bucket
+     * agg needs to first reduce the aggs in it's bucket (and their parent pipelines) before allowing sibling pipelines
+     * to reduce
+     */
+    @Override
+    public final InternalAggregation reducePipelines(InternalAggregation reducedAggs, ReduceContext reduceContext) {
+        assert reduceContext.isFinalReduce();
+        List<InternalAggregation> aggs = new ArrayList<>();
+        for (Aggregation agg : getAggregations().asList()) {
+            aggs.add(((InternalAggregation)agg).reducePipelines((InternalAggregation)agg, reduceContext));
+        }
+        InternalAggregations reducedSubAggs = new InternalAggregations(aggs);
+        return super.reducePipelines(create(reducedSubAggs), reduceContext);
+    }
+
     @Override
     public Object getProperty(List<String> path) {
         if (path.isEmpty()) {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/nested/NestedAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/nested/NestedAggregatorTests.java
index f3c1ea7ca529a..4983575860f86 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/nested/NestedAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/nested/NestedAggregatorTests.java
@@ -39,6 +39,7 @@
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.lucene.search.Queries;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.mapper.IdFieldMapper;
 import org.elasticsearch.index.mapper.KeywordFieldMapper;
 import org.elasticsearch.index.mapper.MappedFieldType;
@@ -47,11 +48,19 @@
 import org.elasticsearch.index.mapper.TypeFieldMapper;
 import org.elasticsearch.index.mapper.Uid;
 import org.elasticsearch.index.query.MatchAllQueryBuilder;
+import org.elasticsearch.script.MockScriptEngine;
+import org.elasticsearch.script.Script;
+import org.elasticsearch.script.ScriptEngine;
+import org.elasticsearch.script.ScriptModule;
+import org.elasticsearch.script.ScriptService;
+import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.search.aggregations.AggregatorTestCase;
 import org.elasticsearch.search.aggregations.BucketOrder;
 import org.elasticsearch.search.aggregations.InternalAggregation;
 import org.elasticsearch.search.aggregations.bucket.filter.Filter;
 import org.elasticsearch.search.aggregations.bucket.filter.FilterAggregationBuilder;
+import org.elasticsearch.search.aggregations.bucket.terms.InternalTerms;
+import org.elasticsearch.search.aggregations.bucket.terms.LongTerms;
 import org.elasticsearch.search.aggregations.bucket.terms.StringTerms;
 import org.elasticsearch.search.aggregations.bucket.terms.Terms;
 import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregationBuilder;
@@ -62,12 +71,16 @@
 import org.elasticsearch.search.aggregations.metrics.Min;
 import org.elasticsearch.search.aggregations.metrics.MinAggregationBuilder;
 import org.elasticsearch.search.aggregations.metrics.SumAggregationBuilder;
+import org.elasticsearch.search.aggregations.pipeline.BucketScriptPipelineAggregationBuilder;
+import org.elasticsearch.search.aggregations.pipeline.InternalSimpleValue;
 import org.elasticsearch.search.aggregations.support.AggregationInspectionHelper;
 import org.elasticsearch.search.aggregations.support.ValueType;
 
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
@@ -86,6 +99,7 @@ public class NestedAggregatorTests extends AggregatorTestCase {
     private static final String NESTED_AGG = "nestedAgg";
     private static final String MAX_AGG_NAME = "maxAgg";
     private static final String SUM_AGG_NAME = "sumAgg";
+    private static final String INVERSE_SCRIPT = "inverse";
 
     private final SeqNoFieldMapper.SequenceIDFields sequenceIDFields = SeqNoFieldMapper.SequenceIDFields.emptySeqID();
 
@@ -99,6 +113,18 @@ protected Map<String, MappedFieldType> getFieldAliases(MappedFieldType... fieldT
             Function.identity()));
     }
 
+    @Override
+    protected ScriptService getMockScriptService() {
+        Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+        scripts.put(INVERSE_SCRIPT, vars -> -((Number) vars.get("_value")).doubleValue());
+        MockScriptEngine scriptEngine = new MockScriptEngine(MockScriptEngine.NAME,
+            scripts,
+            Collections.emptyMap());
+        Map<String, ScriptEngine> engines = Collections.singletonMap(scriptEngine.getType(), scriptEngine);
+
+        return new ScriptService(Settings.EMPTY, engines, ScriptModule.CORE_CONTEXTS);
+    }
+
     public void testNoDocs() throws IOException {
         try (Directory directory = newDirectory()) {
             try (RandomIndexWriter iw = new RandomIndexWriter(random(), directory)) {
@@ -709,6 +735,66 @@ public void testFieldAlias() throws IOException {
         }
     }
 
+    /**
+     * This tests to make sure pipeline aggs embedded under a SingleBucket agg (like nested)
+     * are properly reduced
+     */
+    public void testNestedWithPipeline() throws IOException {
+        int numRootDocs = randomIntBetween(1, 20);
+        int expectedNestedDocs = 0;
+        double expectedMaxValue = Double.NEGATIVE_INFINITY;
+        try (Directory directory = newDirectory()) {
+            try (RandomIndexWriter iw = new RandomIndexWriter(random(), directory)) {
+                for (int i = 0; i < numRootDocs; i++) {
+                    List<Document> documents = new ArrayList<>();
+                    expectedMaxValue = Math.max(expectedMaxValue,
+                        generateMaxDocs(documents, 1, i, NESTED_OBJECT, VALUE_FIELD_NAME));
+                    expectedNestedDocs += 1;
+
+                    Document document = new Document();
+                    document.add(new Field(IdFieldMapper.NAME, Uid.encodeId(Integer.toString(i)), IdFieldMapper.Defaults.FIELD_TYPE));
+                    document.add(new Field(TypeFieldMapper.NAME, "test",
+                        TypeFieldMapper.Defaults.FIELD_TYPE));
+                    document.add(sequenceIDFields.primaryTerm);
+                    documents.add(document);
+                    iw.addDocuments(documents);
+                }
+                iw.commit();
+            }
+            try (IndexReader indexReader = wrap(DirectoryReader.open(directory))) {
+                NestedAggregationBuilder nestedBuilder = new NestedAggregationBuilder(NESTED_AGG, NESTED_OBJECT)
+                    .subAggregation(new TermsAggregationBuilder("terms", ValueType.NUMERIC).field(VALUE_FIELD_NAME)
+                        .subAggregation(new MaxAggregationBuilder(MAX_AGG_NAME).field(VALUE_FIELD_NAME))
+                        .subAggregation(new BucketScriptPipelineAggregationBuilder("bucketscript",
+                            Collections.singletonMap("_value", MAX_AGG_NAME),
+                            new Script(ScriptType.INLINE, MockScriptEngine.NAME, INVERSE_SCRIPT, Collections.emptyMap()))));
+
+                MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.LONG);
+                fieldType.setName(VALUE_FIELD_NAME);
+
+                InternalNested nested = searchAndReduce(newSearcher(indexReader, false, true),
+                    new MatchAllDocsQuery(), nestedBuilder, fieldType);
+
+                assertEquals(expectedNestedDocs, nested.getDocCount());
+                assertEquals(NESTED_AGG, nested.getName());
+                assertEquals(expectedNestedDocs, nested.getDocCount());
+
+                InternalTerms<?, LongTerms.Bucket> terms = (InternalTerms) nested.getProperty("terms");
+                assertNotNull(terms);
+
+                for (LongTerms.Bucket bucket : terms.getBuckets()) {
+                    InternalMax max = (InternalMax) bucket.getAggregations().asMap().get(MAX_AGG_NAME);
+                    InternalSimpleValue bucketScript = (InternalSimpleValue) bucket.getAggregations().asMap().get("bucketscript");
+                    assertNotNull(max);
+                    assertNotNull(bucketScript);
+                    assertEquals(max.getValue(), -bucketScript.getValue(), Double.MIN_VALUE);
+                }
+
+                assertTrue(AggregationInspectionHelper.hasValue(nested));
+            }
+        }
+    }
+
     private double generateMaxDocs(List<Document> documents, int numNestedDocs, int id, String path, String fieldName) {
         return DoubleStream.of(generateDocuments(documents, numNestedDocs, id, path, fieldName))
             .max().orElse(Double.NEGATIVE_INFINITY);

From 4787977e72c3c27ad315bd179842be6893670888 Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Thu, 12 Dec 2019 14:37:34 +0000
Subject: [PATCH 181/686] Add a Javadoc section to CONTRIBUTING.md (#49836)

Introduce a set of contributor guidelines for when Javadoc should be written,
and when it shouldn't.
---
 CONTRIBUTING.md | 112 +++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 102 insertions(+), 10 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index ed96a2449568a..57021e3be565d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -107,7 +107,7 @@ and `JAVA11_HOME`, and `JAVA12_HOME` available so that the tests can pass.
 `jrunscript` for jdk distributions.
 
 Elasticsearch uses the Gradle wrapper for its build. You can execute Gradle
-using the wrapper via the `gradlew` script on Unix systems or `gradlew.bat` 
+using the wrapper via the `gradlew` script on Unix systems or `gradlew.bat`
 script on Windows in the root of the repository. The examples below show the
 usage on Unix.
 
@@ -157,9 +157,9 @@ For IntelliJ, go to
 For Eclipse, go to `Preferences->Java->Installed JREs` and add `-ea` to
 `VM Arguments`.
 
-Some tests related to locale testing also require the flag 
+Some tests related to locale testing also require the flag
 `-Djava.locale.providers` to be set. Set the VM options/VM arguments for
-IntelliJ or Eclipse like describe above to use 
+IntelliJ or Eclipse like describe above to use
 `-Djava.locale.providers=SPI,COMPAT`.
 
 ### Java Language Formatting Guidelines
@@ -168,8 +168,8 @@ Java files in the Elasticsearch codebase are formatted with the Eclipse JDT
 formatter, using the [Spotless
 Gradle](https://github.com/diffplug/spotless/tree/master/plugin-gradle)
 plugin. This plugin is configured on a project-by-project basis, via
-`build.gradle` in the root of the repository. So long as at least one
-project is configured, the formatting check can be run explicitly with:
+`build.gradle` in the root of the repository. The formatting check can be
+run explicitly with:
 
     ./gradlew spotlessJavaCheck
 
@@ -205,7 +205,7 @@ Please follow these formatting guidelines:
   these are intended for use in documentation, so please make it clear what
   you have done, and only do this where the benefit clearly outweighs the
   decrease in consistency.
-* Note that JavaDoc and block comments i.e. `/* ... */` are not formatted,
+* Note that Javadoc and block comments i.e. `/* ... */` are not formatted,
   but line comments i.e `// ...` are.
 * There is an implicit rule that negative boolean expressions should use
   the form `foo == false` instead of `!foo` for better readability of the
@@ -231,15 +231,107 @@ from the command line.
 
 Sometimes Spotless will report a "misbehaving rule which can't make up its
 mind" and will recommend enabling the `paddedCell()` setting. If you
-enabled this settings and run the format check again,
+enabled this setting and run the format check again,
 Spotless will write files to
 `$PROJECT/build/spotless-diagnose-java/` to aid diagnosis. It writes
 different copies of the formatted files, so that you can see how they
 differ and infer what is the problem.
 
-The `paddedCell()` option is disabled for normal operation in order to
-detect any misbehaviour. You can enabled the option from the command line
-by running Gradle with `-Dspotless.paddedcell`.
+The `paddedCell()` option is disabled for normal operation so that any
+misbehaviour is detected, and not just suppressed. You can enabled the
+option from the command line by running Gradle with `-Dspotless.paddedcell`.
+
+### Javadoc
+
+Good Javadoc can help with navigating and understanding code. Elasticsearch
+has some guidelines around when to write Javadoc and when not to, but note
+that we don't want to be overly prescriptive. The intent of these guidelines
+is to be helpful, not to turn writing code into a chore.
+
+#### The short version
+
+   1. Always add Javadoc to new code.
+   2. Add Javadoc to existing code if you can.
+   3. Document the "why", not the "how", unless that's important to the
+      "why".
+   4. Don't document anything trivial or obvious (e.g. getters and
+      setters). In other words, the Javadoc should add some value.
+
+#### The long version
+
+   1. If you add a new Java package, please also add package-level
+      Javadoc that explains what the package is for. This can just be a
+      reference to a more foundational / parent package if appropriate. An
+      example would be a package hierarchy for a new feature or plugin -
+      the package docs could explain the purpose of the feature, any
+      caveats, and possibly some examples of configuration and usage.
+   2. New classes and interfaces must have class-level Javadoc that
+      describes their purpose. There are a lot of classes in the
+      Elasticsearch repository, and it's easier to navigate when you
+      can quickly find out what is the purpose of a class. This doesn't
+      apply to inner classes or interfaces, unless you expect them to be
+      explicitly used outside their parent class.
+   3. New public methods must have Javadoc, because they form part of the
+      contract between the class and its consumers. Similarly, new abstract
+      methods must have Javadoc because they are part of the contract
+      between a class and its subclasses. It's important that contributors
+      know why they need to implement a method, and the Javadoc should make
+      this clear. You don't need to document a method if it's overriding an
+      abstract method (either from an abstract superclass or an interface),
+      unless your implementation is doing something "unexpected" e.g. deviating
+      from the intent of the original method.
+   4. Following on from the above point, please add docs to existing public
+      methods if you are editing them, or to abstract methods if you can.
+   5. Non-public, non-abstract methods don't require Javadoc, but if you feel
+      that adding some would make it easier for other developers to
+      understand the code, or why it's written in a particular way, then please
+      do so.
+   6. Properties don't need to have Javadoc, but please add some if there's
+      something useful to say.
+   7. Javadoc should not go into low-level implementation details unless
+      this is critical to understanding the code e.g. documenting the
+      subtleties of the implementation of a private method. The point here
+      is that implementations will change over time, and the Javadoc is
+      less likely to become out-of-date if it only talks about the what is
+      the purpose of the code, not what it does.
+   8. Examples in Javadoc can be very useful, so feel free to add some if
+      you can reasonably do so i.e. if it takes a whole page of code to set
+      up an example, then Javadoc probably isn't the right place for it.
+      Longer or more elaborate examples are probably better suited
+      to the package docs.
+   9. Test methods are a good place to add Javadoc, because you can use it
+      to succinctly describe e.g. preconditions, actions and expectations
+      of the test, more easily that just using the test name alone. Please
+      consider documenting your tests in this way.
+   10. Sometimes you shouldn't add Javadoc:
+       1. Where it adds no value, for example where a method's
+          implementation is trivial such as with getters and setters, or a
+          method just delegates to another object.
+       2. However, you should still add Javadoc if there are caveats around
+          calling a method that are not immediately obvious from reading the
+          method's implementation in isolation.
+       3. You can omit Javadoc for simple classes, e.g. where they are a
+          simple container for some data. However, please consider whether a
+          reader might still benefit from some additional background, for
+          example about why the class exists at all.
+   11. Not all comments need to be Javadoc. Sometimes it will make more
+       sense to add comments in a method's body, for example due to important
+       implementation decisions or "gotchas". As a general guide, if some
+       information forms part of the contract between a method and its callers,
+       then it should go in the Javadoc, otherwise you might consider using
+       regular comments in the code. Remember as well that Elasticsearch
+       has extensive [user documentation](./docs), and it is not the role
+       of Javadoc to replace that.
+   12. Please still try to make class, method or variable names as
+       descriptive and concise as possible, as opposed to relying solely on
+       Javadoc to describe something.
+   13. Use `@link` and `@see` to add references, either to related
+       resources in the codebase or to relevant external resources.
+   14. If you need help writing Javadoc, just ask!
+
+Finally, use your judgement! Base your decisions on what will help other
+developers - including yourself, when you come back to some code
+3 months in the future, having forgotten how it works.
 
 ### License Headers
 

From b6ffc9f8843c93ab96f7a9cdc8f082edd1f52e85 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 12 Dec 2019 09:39:06 -0500
Subject: [PATCH 182/686] [DOCS] Reformat lowercase token filter docs (#49935)

---
 .../lowercase-tokenfilter.asciidoc            | 134 ++++++++++++++++--
 1 file changed, 122 insertions(+), 12 deletions(-)

diff --git a/docs/reference/analysis/tokenfilters/lowercase-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/lowercase-tokenfilter.asciidoc
index f04cea237fa99..6a1ef08c0b12d 100644
--- a/docs/reference/analysis/tokenfilters/lowercase-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/lowercase-tokenfilter.asciidoc
@@ -1,25 +1,135 @@
 [[analysis-lowercase-tokenfilter]]
-=== Lowercase Token Filter
+=== Lowercase token filter
+++++
+<titleabbrev>Lowercase</titleabbrev>
+++++
 
-A token filter of type `lowercase` that normalizes token text to lower
-case.
+Changes token text to lowercase. For example, you can use the `lowercase` filter
+to change `THE Lazy DoG` to `the lazy dog`.
 
-Lowercase token filter supports Greek, Irish, and Turkish lowercase token
-filters through the `language` parameter. Below is a usage example in a
-custom analyzer
+In addition to a default filter, the `lowercase` token filter provides access to
+Lucene's language-specific lowercase filters for Greek, Irish, and Turkish.
+  
+[[analysis-lowercase-tokenfilter-analyze-ex]]
+==== Example
+
+The following <<indices-analyze,analyze API>> request uses the default
+`lowercase` filter to change the `THE Quick FoX JUMPs` to lowercase:
+
+[source,console]
+--------------------------------------------------
+GET _analyze
+{
+  "tokenizer" : "standard",
+  "filter" : ["lowercase"],
+  "text" : "THE Quick FoX JUMPs"
+}
+--------------------------------------------------
+
+The filter produces the following tokens:
+
+[source,text]
+--------------------------------------------------
+[ the, quick, fox, jumps ]
+--------------------------------------------------
+
+/////////////////////
+[source,console-result]
+--------------------------------------------------
+{
+  "tokens" : [
+    {
+      "token" : "the",
+      "start_offset" : 0,
+      "end_offset" : 3,
+      "type" : "<ALPHANUM>",
+      "position" : 0
+    },
+    {
+      "token" : "quick",
+      "start_offset" : 4,
+      "end_offset" : 9,
+      "type" : "<ALPHANUM>",
+      "position" : 1
+    },
+    {
+      "token" : "fox",
+      "start_offset" : 10,
+      "end_offset" : 13,
+      "type" : "<ALPHANUM>",
+      "position" : 2
+    },
+    {
+      "token" : "jumps",
+      "start_offset" : 14,
+      "end_offset" : 19,
+      "type" : "<ALPHANUM>",
+      "position" : 3
+    }
+  ]
+}
+--------------------------------------------------
+/////////////////////
+
+[[analysis-lowercase-tokenfilter-analyzer-ex]]
+==== Add to an analyzer
+
+The following <<indices-create-index,create index API>> request uses the
+`lowercase` filter to configure a new 
+<<analysis-custom-analyzer,custom analyzer>>.
 
 [source,console]
 --------------------------------------------------
-PUT /lowercase_example
+PUT lowercase_example
+{
+    "settings" : {
+        "analysis" : {
+            "analyzer" : {
+                "whitespace_lowercase" : {
+                    "tokenizer" : "whitespace",
+                    "filter" : ["lowercase"]
+                }
+            }
+        }
+    }
+}
+--------------------------------------------------
+
+[[analysis-lowercase-tokenfilter-configure-parms]]
+==== Configurable parameters
+
+`language`::
++
+--
+(Optional, string)
+Language-specific lowercase token filter to use. Valid values include:
+
+`greek`::: Uses Lucene's https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/el/GreekLowerCaseFilter.html[GreekLowerCaseFilter]
+
+`irish`::: Uses Lucene's http://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/ga/IrishLowerCaseFilter.html[IrishLowerCaseFilter]
+
+`turkish`::: Uses Lucene's https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/tr/TurkishLowerCaseFilter.html[TurkishLowerCaseFilter]
+
+If not specified, defaults to Lucene's https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/core/LowerCaseFilter.html[LowerCaseFilter].
+--
+
+[[analysis-lowercase-tokenfilter-customize]]
+==== Customize
+
+To customize the `lowercase` filter, duplicate it to create the basis
+for a new custom token filter. You can modify the filter using its configurable
+parameters.
+
+For example, the following request creates a custom `lowercase` filter for the
+Greek language:
+
+[source,console]
+--------------------------------------------------
+PUT custom_lowercase_example
 {
   "settings": {
     "analysis": {
       "analyzer": {
-        "standard_lowercase_example": {
-          "type": "custom",
-          "tokenizer": "standard",
-          "filter": ["lowercase"]
-        },
         "greek_lowercase_example": {
           "type": "custom",
           "tokenizer": "standard",

From dbcab441c28d627b8a99d1a13f34b3801d97db7b Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Thu, 12 Dec 2019 10:19:39 -0500
Subject: [PATCH 183/686] [ML][Inference] Simplify inference processor options
 (#50105)

* [ML][Inference] Simplify inference processor options

* addressing pr comments
---
 .../ml/action/InternalInferModelAction.java   |   2 +-
 .../ClassificationInferenceResults.java       |  63 +++-----
 .../inference/results/InferenceResults.java   |   6 +-
 .../results/RawInferenceResults.java          |  13 +-
 .../results/RegressionInferenceResults.java   |  30 ++--
 .../results/SingleValueInferenceResults.java  |  13 --
 .../trainedmodel/ClassificationConfig.java    |  38 +++--
 .../trainedmodel/RegressionConfig.java        |  32 +++-
 .../trainedmodel/ensemble/Ensemble.java       |   5 +-
 .../ml/inference/trainedmodel/tree/Tree.java  |   4 +-
 .../ClassificationInferenceResultsTests.java  |  29 ++--
 .../RegressionInferenceResultsTests.java      |   9 +-
 .../ClassificationConfigTests.java            |   9 +-
 .../trainedmodel/RegressionConfigTests.java   |  11 +-
 .../trainedmodel/ensemble/EnsembleTests.java  |  10 +-
 .../trainedmodel/tree/TreeTests.java          |  12 +-
 .../ml/integration/InferenceIngestIT.java     |  29 ++--
 .../inference/ingest/InferenceProcessor.java  |  35 ++--
 .../MachineLearningLicensingTests.java        |   8 +-
 .../ingest/InferenceProcessorTests.java       | 150 +++++-------------
 .../loadingservice/LocalModelTests.java       |   2 +-
 .../integration/ModelInferenceActionIT.java   |  13 +-
 22 files changed, 226 insertions(+), 297 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/InternalInferModelAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/InternalInferModelAction.java
index 0ff458994719d..556fb2b4f0241 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/InternalInferModelAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/InternalInferModelAction.java
@@ -41,7 +41,7 @@ public static class Request extends ActionRequest {
         private final boolean previouslyLicensed;
 
         public Request(String modelId, boolean previouslyLicensed) {
-            this(modelId, Collections.emptyList(), new RegressionConfig(), previouslyLicensed);
+            this(modelId, Collections.emptyList(), RegressionConfig.EMPTY_PARAMS, previouslyLicensed);
         }
 
         public Request(String modelId,
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
index 4df54e3fa9eca..526b37314b56b 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
@@ -9,8 +9,6 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
-import org.elasticsearch.common.xcontent.ToXContentObject;
-import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.ingest.IngestDocument;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
@@ -27,22 +25,31 @@
 public class ClassificationInferenceResults extends SingleValueInferenceResults {
 
     public static final String NAME = "classification";
-    public static final ParseField CLASSIFICATION_LABEL = new ParseField("classification_label");
-    public static final ParseField TOP_CLASSES = new ParseField("top_classes");
-    
+
+    private final String topNumClassesField;
+    private final String resultsField;
     private final String classificationLabel;
     private final List<TopClassEntry> topClasses;
 
-    public ClassificationInferenceResults(double value, String classificationLabel, List<TopClassEntry> topClasses) {
+    public ClassificationInferenceResults(double value,
+                                          String classificationLabel,
+                                          List<TopClassEntry> topClasses,
+                                          InferenceConfig config) {
         super(value);
+        assert config instanceof ClassificationConfig;
+        ClassificationConfig classificationConfig = (ClassificationConfig)config;
         this.classificationLabel = classificationLabel;
         this.topClasses = topClasses == null ? Collections.emptyList() : Collections.unmodifiableList(topClasses);
+        this.topNumClassesField = classificationConfig.getTopClassesResultsField();
+        this.resultsField = classificationConfig.getResultsField();
     }
 
     public ClassificationInferenceResults(StreamInput in) throws IOException {
         super(in);
         this.classificationLabel = in.readOptionalString();
         this.topClasses = Collections.unmodifiableList(in.readList(TopClassEntry::new));
+        this.topNumClassesField = in.readString();
+        this.resultsField = in.readString();
     }
 
     public String getClassificationLabel() {
@@ -58,17 +65,8 @@ public void writeTo(StreamOutput out) throws IOException {
         super.writeTo(out);
         out.writeOptionalString(classificationLabel);
         out.writeCollection(topClasses);
-    }
-
-    @Override
-    XContentBuilder innerToXContent(XContentBuilder builder, Params params) throws IOException {
-        if (classificationLabel != null) {
-            builder.field(CLASSIFICATION_LABEL.getPreferredName(), classificationLabel);
-        }
-        if (topClasses.isEmpty() == false) {
-            builder.field(TOP_CLASSES.getPreferredName(), topClasses);
-        }
-        return builder;
+        out.writeString(topNumClassesField);
+        out.writeString(resultsField);
     }
 
     @Override
@@ -78,12 +76,14 @@ public boolean equals(Object object) {
         ClassificationInferenceResults that = (ClassificationInferenceResults) object;
         return Objects.equals(value(), that.value()) &&
             Objects.equals(classificationLabel, that.classificationLabel) &&
+            Objects.equals(resultsField, that.resultsField) &&
+            Objects.equals(topNumClassesField, that.topNumClassesField) &&
             Objects.equals(topClasses, that.topClasses);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(value(), classificationLabel, topClasses);
+        return Objects.hash(value(), classificationLabel, topClasses, resultsField, topNumClassesField);
     }
 
     @Override
@@ -92,14 +92,12 @@ public String valueAsString() {
     }
 
     @Override
-    public void writeResult(IngestDocument document, String resultField, InferenceConfig config) {
-        assert config instanceof ClassificationConfig;
-        ClassificationConfig classificationConfig = (ClassificationConfig)config;
+    public void writeResult(IngestDocument document, String parentResultField) {
         ExceptionsHelper.requireNonNull(document, "document");
-        ExceptionsHelper.requireNonNull(resultField, "resultField");
-        document.setFieldValue(resultField, valueAsString());
-        if (topClasses.isEmpty() == false) {
-            document.setFieldValue(classificationConfig.getTopClassesResultsField(),
+        ExceptionsHelper.requireNonNull(parentResultField, "parentResultField");
+        document.setFieldValue(parentResultField + "." + this.resultsField, valueAsString());
+        if (topClasses.size() > 0) {
+            document.setFieldValue(parentResultField + "." + topNumClassesField,
                 topClasses.stream().map(TopClassEntry::asValueMap).collect(Collectors.toList()));
         }
     }
@@ -109,12 +107,8 @@ public String getWriteableName() {
         return NAME;
     }
 
-    @Override
-    public String getName() {
-        return NAME;
-    }
 
-    public static class TopClassEntry implements ToXContentObject, Writeable {
+    public static class TopClassEntry implements Writeable {
 
         public final ParseField CLASSIFICATION = new ParseField("classification");
         public final ParseField PROBABILITY = new ParseField("probability");
@@ -153,15 +147,6 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeDouble(probability);
         }
 
-        @Override
-        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            builder.startObject();
-            builder.field(CLASSIFICATION.getPreferredName(), classification);
-            builder.field(PROBABILITY.getPreferredName(), probability);
-            builder.endObject();
-            return builder;
-        }
-
         @Override
         public boolean equals(Object object) {
             if (object == this) { return true; }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/InferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/InferenceResults.java
index 357fdcda386df..a0fe44a13d1b1 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/InferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/InferenceResults.java
@@ -7,11 +7,9 @@
 
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.ingest.IngestDocument;
-import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
-import org.elasticsearch.xpack.core.ml.utils.NamedXContentObject;
 
-public interface InferenceResults extends NamedXContentObject, NamedWriteable {
+public interface InferenceResults extends NamedWriteable {
 
-    void writeResult(IngestDocument document, String resultField, InferenceConfig config);
+    void writeResult(IngestDocument document, String parentResultField);
 
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RawInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RawInferenceResults.java
index bb72483fe4878..6525908af3acd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RawInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RawInferenceResults.java
@@ -7,9 +7,7 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.ingest.IngestDocument;
-import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
 
 import java.io.IOException;
 import java.util.Objects;
@@ -31,11 +29,6 @@ public void writeTo(StreamOutput out) throws IOException {
         super.writeTo(out);
     }
 
-    @Override
-    XContentBuilder innerToXContent(XContentBuilder builder, Params params) {
-        return builder;
-    }
-
     @Override
     public boolean equals(Object object) {
         if (object == this) { return true; }
@@ -50,7 +43,7 @@ public int hashCode() {
     }
 
     @Override
-    public void writeResult(IngestDocument document, String resultField, InferenceConfig config) {
+    public void writeResult(IngestDocument document, String parentResultField) {
         throw new UnsupportedOperationException("[raw] does not support writing inference results");
     }
 
@@ -59,8 +52,4 @@ public String getWriteableName() {
         return NAME;
     }
 
-    @Override
-    public String getName() {
-        return NAME;
-    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResults.java
index 0fb931cd4a251..8aade6337f5a6 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResults.java
@@ -7,9 +7,9 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.ingest.IngestDocument;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.io.IOException;
@@ -19,22 +19,24 @@ public class RegressionInferenceResults extends SingleValueInferenceResults {
 
     public static final String NAME = "regression";
 
-    public RegressionInferenceResults(double value) {
+    private final String resultsField;
+
+    public RegressionInferenceResults(double value, InferenceConfig config) {
         super(value);
+        assert config instanceof RegressionConfig;
+        RegressionConfig regressionConfig = (RegressionConfig)config;
+        this.resultsField = regressionConfig.getResultsField();
     }
 
     public RegressionInferenceResults(StreamInput in) throws IOException {
         super(in.readDouble());
+        this.resultsField = in.readString();
     }
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         super.writeTo(out);
-    }
-
-    @Override
-    XContentBuilder innerToXContent(XContentBuilder builder, Params params) {
-        return builder;
+        out.writeString(resultsField);
     }
 
     @Override
@@ -42,19 +44,19 @@ public boolean equals(Object object) {
         if (object == this) { return true; }
         if (object == null || getClass() != object.getClass()) { return false; }
         RegressionInferenceResults that = (RegressionInferenceResults) object;
-        return Objects.equals(value(), that.value());
+        return Objects.equals(value(), that.value()) && Objects.equals(this.resultsField, that.resultsField);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(value());
+        return Objects.hash(value(), resultsField);
     }
 
     @Override
-    public void writeResult(IngestDocument document, String resultField, InferenceConfig config) {
+    public void writeResult(IngestDocument document, String parentResultField) {
         ExceptionsHelper.requireNonNull(document, "document");
-        ExceptionsHelper.requireNonNull(resultField, "resultField");
-        document.setFieldValue(resultField, value());
+        ExceptionsHelper.requireNonNull(parentResultField, "parentResultField");
+        document.setFieldValue(parentResultField + "." + this.resultsField, value());
     }
 
     @Override
@@ -62,8 +64,4 @@ public String getWriteableName() {
         return NAME;
     }
 
-    @Override
-    public String getName() {
-        return NAME;
-    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/SingleValueInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/SingleValueInferenceResults.java
index 2905a6679584c..a93f2b0f56b6a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/SingleValueInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/SingleValueInferenceResults.java
@@ -5,17 +5,13 @@
  */
 package org.elasticsearch.xpack.core.ml.inference.results;
 
-import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.xcontent.XContentBuilder;
 
 import java.io.IOException;
 
 public abstract class SingleValueInferenceResults implements InferenceResults {
 
-    public final ParseField VALUE = new ParseField("value");
-
     private final double value;
 
     SingleValueInferenceResults(StreamInput in) throws IOException {
@@ -39,13 +35,4 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeDouble(value);
     }
 
-    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-        builder.startObject();
-        builder.field(VALUE.getPreferredName(), value);
-        innerToXContent(builder, params);
-        builder.endObject();
-        return builder;
-    }
-
-    abstract XContentBuilder innerToXContent(XContentBuilder builder, Params params) throws IOException;
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfig.java
index 3923ef9313190..28e716d569fb1 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfig.java
@@ -21,38 +21,44 @@ public class ClassificationConfig implements InferenceConfig {
 
     public static final String NAME = "classification";
 
-    public static final String DEFAULT_TOP_CLASSES_RESULT_FIELD = "top_classes";
-    public static final ParseField  NUM_TOP_CLASSES = new ParseField("num_top_classes");
-    public static final ParseField  TOP_CLASSES_RESULT_FIELD = new ParseField("top_classes_result_field");
+    public static final String DEFAULT_TOP_CLASSES_RESULTS_FIELD = "top_classes";
+    private static final String DEFAULT_RESULTS_FIELD = "predicted_value";
+    public static final ParseField RESULTS_FIELD = new ParseField("results_field");
+    public static final ParseField NUM_TOP_CLASSES = new ParseField("num_top_classes");
+    public static final ParseField TOP_CLASSES_RESULTS_FIELD = new ParseField("top_classes_results_field");
     private static final Version MIN_SUPPORTED_VERSION = Version.V_7_6_0;
 
-    public static ClassificationConfig EMPTY_PARAMS = new ClassificationConfig(0, DEFAULT_TOP_CLASSES_RESULT_FIELD);
+    public static ClassificationConfig EMPTY_PARAMS = new ClassificationConfig(0, DEFAULT_RESULTS_FIELD, DEFAULT_TOP_CLASSES_RESULTS_FIELD);
 
     private final int numTopClasses;
     private final String topClassesResultsField;
+    private final String resultsField;
 
     public static ClassificationConfig fromMap(Map<String, Object> map) {
         Map<String, Object> options = new HashMap<>(map);
         Integer numTopClasses = (Integer)options.remove(NUM_TOP_CLASSES.getPreferredName());
-        String topClassesResultsField = (String)options.remove(TOP_CLASSES_RESULT_FIELD.getPreferredName());
+        String topClassesResultsField = (String)options.remove(TOP_CLASSES_RESULTS_FIELD.getPreferredName());
+        String resultsField = (String)options.remove(RESULTS_FIELD.getPreferredName());
         if (options.isEmpty() == false) {
             throw ExceptionsHelper.badRequestException("Unrecognized fields {}.", options.keySet());
         }
-        return new ClassificationConfig(numTopClasses, topClassesResultsField);
+        return new ClassificationConfig(numTopClasses, resultsField, topClassesResultsField);
     }
 
     public ClassificationConfig(Integer numTopClasses) {
-        this(numTopClasses, null);
+        this(numTopClasses, null, null);
     }
 
-    public ClassificationConfig(Integer numTopClasses, String topClassesResultsField) {
+    public ClassificationConfig(Integer numTopClasses, String resultsField, String topClassesResultsField) {
         this.numTopClasses = numTopClasses == null ? 0 : numTopClasses;
-        this.topClassesResultsField = topClassesResultsField == null ? DEFAULT_TOP_CLASSES_RESULT_FIELD : topClassesResultsField;
+        this.topClassesResultsField = topClassesResultsField == null ? DEFAULT_TOP_CLASSES_RESULTS_FIELD : topClassesResultsField;
+        this.resultsField = resultsField == null ? DEFAULT_RESULTS_FIELD : resultsField;
     }
 
     public ClassificationConfig(StreamInput in) throws IOException {
         this.numTopClasses = in.readInt();
         this.topClassesResultsField = in.readString();
+        this.resultsField = in.readString();
     }
 
     public int getNumTopClasses() {
@@ -63,10 +69,15 @@ public String getTopClassesResultsField() {
         return topClassesResultsField;
     }
 
+    public String getResultsField() {
+        return resultsField;
+    }
+
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeInt(numTopClasses);
         out.writeString(topClassesResultsField);
+        out.writeString(resultsField);
     }
 
     @Override
@@ -74,12 +85,14 @@ public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
         ClassificationConfig that = (ClassificationConfig) o;
-        return Objects.equals(numTopClasses, that.numTopClasses) && Objects.equals(topClassesResultsField, that.topClassesResultsField);
+        return Objects.equals(numTopClasses, that.numTopClasses) &&
+            Objects.equals(topClassesResultsField, that.topClassesResultsField) &&
+            Objects.equals(resultsField, that.resultsField);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(numTopClasses, topClassesResultsField);
+        return Objects.hash(numTopClasses, topClassesResultsField, resultsField);
     }
 
     @Override
@@ -88,7 +101,8 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (numTopClasses != 0) {
             builder.field(NUM_TOP_CLASSES.getPreferredName(), numTopClasses);
         }
-        builder.field(TOP_CLASSES_RESULT_FIELD.getPreferredName(), topClassesResultsField);
+        builder.field(TOP_CLASSES_RESULTS_FIELD.getPreferredName(), topClassesResultsField);
+        builder.field(RESULTS_FIELD.getPreferredName(), resultsField);
         builder.endObject();
         return builder;
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/RegressionConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/RegressionConfig.java
index 6dd03e87747e7..f42ef20a94337 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/RegressionConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/RegressionConfig.java
@@ -6,12 +6,14 @@
 package org.elasticsearch.xpack.core.ml.inference.trainedmodel;
 
 import org.elasticsearch.Version;
+import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.io.IOException;
+import java.util.HashMap;
 import java.util.Map;
 import java.util.Objects;
 
@@ -19,18 +21,32 @@ public class RegressionConfig implements InferenceConfig {
 
     public static final String NAME = "regression";
     private static final Version MIN_SUPPORTED_VERSION = Version.V_7_6_0;
+    public static final ParseField RESULTS_FIELD = new ParseField("results_field");
+    private static final String DEFAULT_RESULTS_FIELD = "predicted_value";
+
+    public static RegressionConfig EMPTY_PARAMS = new RegressionConfig(DEFAULT_RESULTS_FIELD);
 
     public static RegressionConfig fromMap(Map<String, Object> map) {
-        if (map.isEmpty() == false) {
+        Map<String, Object> options = new HashMap<>(map);
+        String resultsField = (String)options.remove(RESULTS_FIELD.getPreferredName());
+        if (options.isEmpty() == false) {
             throw ExceptionsHelper.badRequestException("Unrecognized fields {}.", map.keySet());
         }
-        return new RegressionConfig();
+        return new RegressionConfig(resultsField);
     }
 
-    public RegressionConfig() {
+    private final String resultsField;
+
+    public RegressionConfig(String resultsField) {
+        this.resultsField = resultsField == null ? DEFAULT_RESULTS_FIELD : resultsField;
     }
 
-    public RegressionConfig(StreamInput in) {
+    public RegressionConfig(StreamInput in) throws IOException {
+        this.resultsField = in.readString();
+    }
+
+    public String getResultsField() {
+        return resultsField;
     }
 
     @Override
@@ -40,6 +56,7 @@ public String getWriteableName() {
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
+        out.writeString(resultsField);
     }
 
     @Override
@@ -50,6 +67,7 @@ public String getName() {
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
+        builder.field(RESULTS_FIELD.getPreferredName(), resultsField);
         builder.endObject();
         return builder;
     }
@@ -58,13 +76,13 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
-
-        return true;
+        RegressionConfig that = (RegressionConfig)o;
+        return Objects.equals(this.resultsField, that.resultsField);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(NAME);
+        return Objects.hash(resultsField);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/Ensemble.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/Ensemble.java
index a59f1a1c245d9..c9bde54c460cd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/Ensemble.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/Ensemble.java
@@ -150,7 +150,7 @@ private InferenceResults buildResults(List<Double> processedInferences, Inferenc
         }
         switch(targetType) {
             case REGRESSION:
-                return new RegressionInferenceResults(outputAggregator.aggregate(processedInferences));
+                return new RegressionInferenceResults(outputAggregator.aggregate(processedInferences), config);
             case CLASSIFICATION:
                 ClassificationConfig classificationConfig = (ClassificationConfig) config;
                 List<ClassificationInferenceResults.TopClassEntry> topClasses = InferenceHelpers.topClasses(
@@ -160,7 +160,8 @@ private InferenceResults buildResults(List<Double> processedInferences, Inferenc
                 double value = outputAggregator.aggregate(processedInferences);
                 return new ClassificationInferenceResults(outputAggregator.aggregate(processedInferences),
                     classificationLabel(value, classificationLabels),
-                    topClasses);
+                    topClasses,
+                    config);
             default:
                 throw new UnsupportedOperationException("unsupported target_type [" + targetType + "] for inference on ensemble model");
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
index 1408b17a0691a..b137c8f28d58e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
@@ -153,9 +153,9 @@ private InferenceResults buildResult(Double value, InferenceConfig config) {
                     classificationProbability(value),
                     classificationLabels,
                     classificationConfig.getNumTopClasses());
-                return new ClassificationInferenceResults(value, classificationLabel(value, classificationLabels), topClasses);
+                return new ClassificationInferenceResults(value, classificationLabel(value, classificationLabels), topClasses, config);
             case REGRESSION:
-                return new RegressionInferenceResults(value);
+                return new RegressionInferenceResults(value, config);
             default:
                 throw new UnsupportedOperationException("unsupported target_type [" + targetType + "] for inference on tree model");
         }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResultsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResultsTests.java
index cc37e253806b0..3ccfb54bd6924 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResultsTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResultsTests.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.ingest.IngestDocument;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfigTests;
 
 import java.util.Arrays;
 import java.util.Collections;
@@ -28,7 +29,8 @@ public static ClassificationInferenceResults createRandomResults() {
             randomBoolean() ? null :
                 Stream.generate(ClassificationInferenceResultsTests::createRandomClassEntry)
                     .limit(randomIntBetween(0, 10))
-                    .collect(Collectors.toList()));
+                    .collect(Collectors.toList()),
+            ClassificationConfigTests.randomClassificationConfig());
     }
 
     private static ClassificationInferenceResults.TopClassEntry createRandomClassEntry() {
@@ -36,19 +38,23 @@ private static ClassificationInferenceResults.TopClassEntry createRandomClassEnt
     }
 
     public void testWriteResultsWithClassificationLabel() {
-        ClassificationInferenceResults result = new ClassificationInferenceResults(1.0, "foo", Collections.emptyList());
+        ClassificationInferenceResults result =
+            new ClassificationInferenceResults(1.0, "foo", Collections.emptyList(), ClassificationConfig.EMPTY_PARAMS);
         IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
-        result.writeResult(document, "result_field", ClassificationConfig.EMPTY_PARAMS);
+        result.writeResult(document, "result_field");
 
-        assertThat(document.getFieldValue("result_field", String.class), equalTo("foo"));
+        assertThat(document.getFieldValue("result_field.predicted_value", String.class), equalTo("foo"));
     }
 
     public void testWriteResultsWithoutClassificationLabel() {
-        ClassificationInferenceResults result = new ClassificationInferenceResults(1.0, null, Collections.emptyList());
+        ClassificationInferenceResults result = new ClassificationInferenceResults(1.0,
+            null,
+            Collections.emptyList(),
+            ClassificationConfig.EMPTY_PARAMS);
         IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
-        result.writeResult(document, "result_field", ClassificationConfig.EMPTY_PARAMS);
+        result.writeResult(document, "result_field");
 
-        assertThat(document.getFieldValue("result_field", String.class), equalTo("1.0"));
+        assertThat(document.getFieldValue("result_field.predicted_value", String.class), equalTo("1.0"));
     }
 
     @SuppressWarnings("unchecked")
@@ -59,11 +65,12 @@ public void testWriteResultsWithTopClasses() {
             new ClassificationInferenceResults.TopClassEntry("baz", 0.1));
         ClassificationInferenceResults result = new ClassificationInferenceResults(1.0,
             "foo",
-            entries);
+            entries,
+            new ClassificationConfig(3, "my_results", "bar"));
         IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
-        result.writeResult(document, "result_field", new ClassificationConfig(3, "bar"));
+        result.writeResult(document, "result_field");
 
-        List<?> list = document.getFieldValue("bar", List.class);
+        List<?> list = document.getFieldValue("result_field.bar", List.class);
         assertThat(list.size(), equalTo(3));
 
         for(int i = 0; i < 3; i++) {
@@ -71,7 +78,7 @@ public void testWriteResultsWithTopClasses() {
             assertThat(map, equalTo(entries.get(i).asValueMap()));
         }
 
-        assertThat(document.getFieldValue("result_field", String.class), equalTo("foo"));
+        assertThat(document.getFieldValue("result_field.my_results", String.class), equalTo("foo"));
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResultsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResultsTests.java
index 5c26fea0c06f5..5414f97e08783 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResultsTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/RegressionInferenceResultsTests.java
@@ -10,6 +10,7 @@
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.inference.results.RegressionInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfigTests;
 
 import java.util.HashMap;
 
@@ -19,15 +20,15 @@
 public class RegressionInferenceResultsTests extends AbstractWireSerializingTestCase<RegressionInferenceResults> {
 
     public static RegressionInferenceResults createRandomResults() {
-        return new RegressionInferenceResults(randomDouble());
+        return new RegressionInferenceResults(randomDouble(), RegressionConfigTests.randomRegressionConfig());
     }
 
     public void testWriteResults() {
-        RegressionInferenceResults result = new RegressionInferenceResults(0.3);
+        RegressionInferenceResults result = new RegressionInferenceResults(0.3, RegressionConfig.EMPTY_PARAMS);
         IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
-        result.writeResult(document, "result_field", new RegressionConfig());
+        result.writeResult(document, "result_field");
 
-        assertThat(document.getFieldValue("result_field", Double.class), equalTo(0.3));
+        assertThat(document.getFieldValue("result_field.predicted_value", Double.class), equalTo(0.3));
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfigTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfigTests.java
index aff29d9bf8b74..bc5a9fd851bb1 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfigTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ClassificationConfigTests.java
@@ -19,17 +19,20 @@ public class ClassificationConfigTests extends AbstractWireSerializingTestCase<C
 
     public static ClassificationConfig randomClassificationConfig() {
         return new ClassificationConfig(randomBoolean() ? null : randomIntBetween(-1, 10),
-            randomBoolean() ? null : randomAlphaOfLength(10));
+            randomBoolean() ? null : randomAlphaOfLength(10),
+            randomBoolean() ? null : randomAlphaOfLength(10)
+            );
     }
 
     public void testFromMap() {
         ClassificationConfig expected = ClassificationConfig.EMPTY_PARAMS;
         assertThat(ClassificationConfig.fromMap(Collections.emptyMap()), equalTo(expected));
 
-        expected = new ClassificationConfig(3, "foo");
+        expected = new ClassificationConfig(3, "foo", "bar");
         Map<String, Object> configMap = new HashMap<>();
         configMap.put(ClassificationConfig.NUM_TOP_CLASSES.getPreferredName(), 3);
-        configMap.put(ClassificationConfig.TOP_CLASSES_RESULT_FIELD.getPreferredName(), "foo");
+        configMap.put(ClassificationConfig.RESULTS_FIELD.getPreferredName(), "foo");
+        configMap.put(ClassificationConfig.TOP_CLASSES_RESULTS_FIELD.getPreferredName(), "bar");
         assertThat(ClassificationConfig.fromMap(configMap), equalTo(expected));
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/RegressionConfigTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/RegressionConfigTests.java
index bdb0e6d03201f..addf24ed8ae61 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/RegressionConfigTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/RegressionConfigTests.java
@@ -10,18 +10,23 @@
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
 
 import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
 
 import static org.hamcrest.Matchers.equalTo;
 
 public class RegressionConfigTests extends AbstractWireSerializingTestCase<RegressionConfig> {
 
     public static RegressionConfig randomRegressionConfig() {
-        return new RegressionConfig();
+        return new RegressionConfig(randomBoolean() ? null : randomAlphaOfLength(10));
     }
 
     public void testFromMap() {
-        RegressionConfig expected = new RegressionConfig();
-        assertThat(RegressionConfig.fromMap(Collections.emptyMap()), equalTo(expected));
+        RegressionConfig expected = new RegressionConfig("foo");
+        Map<String, Object> config = new HashMap<>(){{
+            put(RegressionConfig.RESULTS_FIELD.getPreferredName(), "foo");
+        }};
+        assertThat(RegressionConfig.fromMap(config), equalTo(expected));
     }
 
     public void testFromMapWithUnknownField() {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
index c38591ab6cfc5..13a401117b479 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
@@ -413,12 +413,12 @@ public void testRegressionInference() {
         List<Double> featureVector = Arrays.asList(0.4, 0.0);
         Map<String, Object> featureMap = zipObjMap(featureNames, featureVector);
         assertThat(0.9,
-            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
 
         featureVector = Arrays.asList(2.0, 0.7);
         featureMap = zipObjMap(featureNames, featureVector);
         assertThat(0.5,
-            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
 
         // Test with NO aggregator supplied, verifies default behavior of non-weighted sum
         ensemble = Ensemble.builder()
@@ -430,19 +430,19 @@ public void testRegressionInference() {
         featureVector = Arrays.asList(0.4, 0.0);
         featureMap = zipObjMap(featureNames, featureVector);
         assertThat(1.8,
-            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
 
         featureVector = Arrays.asList(2.0, 0.7);
         featureMap = zipObjMap(featureNames, featureVector);
         assertThat(1.0,
-            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
 
         featureMap = new HashMap<>(2) {{
             put("foo", 0.3);
             put("bar", null);
         }};
         assertThat(1.8,
-            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
     }
 
     public void testOperationsEstimations() {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
index 7f5158706941f..9d682896569bb 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
@@ -118,7 +118,7 @@ public void testInferWithStump() {
         List<Double> featureVector = Arrays.asList(0.6, 0.0);
         Map<String, Object> featureMap = zipObjMap(featureNames, featureVector); // does not really matter as this is a stump
         assertThat(42.0,
-            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
     }
 
     public void testInfer() {
@@ -138,27 +138,27 @@ public void testInfer() {
         List<Double> featureVector = Arrays.asList(0.6, 0.0);
         Map<String, Object> featureMap = zipObjMap(featureNames, featureVector);
         assertThat(0.3,
-            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
 
         // This should hit the left child of the left child of the root node
         // i.e. it takes the path left, left
         featureVector = Arrays.asList(0.3, 0.7);
         featureMap = zipObjMap(featureNames, featureVector);
         assertThat(0.1,
-            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
 
         // This should hit the right child of the left child of the root node
         // i.e. it takes the path left, right
         featureVector = Arrays.asList(0.3, 0.9);
         featureMap = zipObjMap(featureNames, featureVector);
         assertThat(0.2,
-            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
 
         // This should still work if the internal values are strings
         List<String> featureVectorStrings = Arrays.asList("0.3", "0.9");
         featureMap = zipObjMap(featureNames, featureVectorStrings);
         assertThat(0.2,
-            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
 
         // This should handle missing values and take the default_left path
         featureMap = new HashMap<>(2) {{
@@ -166,7 +166,7 @@ public void testInfer() {
             put("bar", null);
         }};
         assertThat(0.1,
-            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, new RegressionConfig())).value(), 0.00001));
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
     }
 
     public void testTreeClassificationProbability() {
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
index 315010282a4f4..05b425363c5d3 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
@@ -127,7 +127,8 @@ public void testPipelineCreationAndDeletion() throws Exception {
                     .size(0)
                     .trackTotalHits(true)
                     .query(QueryBuilders.boolQuery()
-                        .filter(QueryBuilders.existsQuery("regression_value"))))).get().getHits().getTotalHits().value,
+                        .filter(
+                            QueryBuilders.existsQuery("ml.inference.regression.predicted_value"))))).get().getHits().getTotalHits().value,
             equalTo(20L));
 
         assertThat(client().search(new SearchRequest().indices("index_for_inference_test")
@@ -135,7 +136,12 @@ public void testPipelineCreationAndDeletion() throws Exception {
                     .size(0)
                     .trackTotalHits(true)
                     .query(QueryBuilders.boolQuery()
-                        .filter(QueryBuilders.existsQuery("result_class"))))).get().getHits().getTotalHits().value,
+                        .filter(
+                            QueryBuilders.existsQuery("ml.inference.classification.predicted_value")))))
+                .get()
+                .getHits()
+                .getTotalHits()
+                .value,
             equalTo(20L));
 
     }
@@ -146,9 +152,9 @@ public void testSimulate() {
             "    \"processors\": [\n" +
             "      {\n" +
             "        \"inference\": {\n" +
-            "          \"target_field\": \"result_class\",\n" +
+            "          \"target_field\": \"ml.classification\",\n" +
             "          \"inference_config\": {\"classification\": " +
-            "                {\"num_top_classes\":2, \"top_classes_result_field\": \"result_class_prob\"}},\n" +
+            "                {\"num_top_classes\":2, \"top_classes_results_field\": \"result_class_prob\"}},\n" +
             "          \"model_id\": \"test_classification\",\n" +
             "          \"field_mappings\": {\n" +
             "            \"col1\": \"col1\",\n" +
@@ -160,7 +166,7 @@ public void testSimulate() {
             "      },\n" +
             "      {\n" +
             "        \"inference\": {\n" +
-            "          \"target_field\": \"regression_value\",\n" +
+            "          \"target_field\": \"ml.regression\",\n" +
             "          \"model_id\": \"test_regression\",\n" +
             "          \"inference_config\": {\"regression\":{}},\n" +
             "          \"field_mappings\": {\n" +
@@ -186,16 +192,17 @@ public void testSimulate() {
             .prepareSimulatePipeline(new BytesArray(source.getBytes(StandardCharsets.UTF_8)),
                 XContentType.JSON).get();
         SimulateDocumentBaseResult baseResult = (SimulateDocumentBaseResult)response.getResults().get(0);
-        assertThat(baseResult.getIngestDocument().getFieldValue("regression_value", Double.class), equalTo(1.0));
-        assertThat(baseResult.getIngestDocument().getFieldValue("result_class", String.class), equalTo("second"));
-        assertThat(baseResult.getIngestDocument().getFieldValue("result_class_prob", List.class).size(), equalTo(2));
+        assertThat(baseResult.getIngestDocument().getFieldValue("ml.regression.predicted_value", Double.class), equalTo(1.0));
+        assertThat(baseResult.getIngestDocument().getFieldValue("ml.classification.predicted_value", String.class),
+            equalTo("second"));
+        assertThat(baseResult.getIngestDocument().getFieldValue("ml.classification.result_class_prob", List.class).size(),
+            equalTo(2));
 
         String sourceWithMissingModel = "{\n" +
             "  \"pipeline\": {\n" +
             "    \"processors\": [\n" +
             "      {\n" +
             "        \"inference\": {\n" +
-            "          \"target_field\": \"result_class\",\n" +
             "          \"model_id\": \"test_classification_missing\",\n" +
             "          \"inference_config\": {\"classification\":{}},\n" +
             "          \"field_mappings\": {\n" +
@@ -526,8 +533,8 @@ private static String modelDocString(String compressedDefinition, String modelId
         "    \"processors\": [\n" +
         "      {\n" +
         "        \"inference\": {\n" +
-        "          \"target_field\": \"result_class\",\n" +
         "          \"model_id\": \"test_classification\",\n" +
+        "          \"tag\": \"classification\",\n" +
         "          \"inference_config\": {\"classification\": {}},\n" +
         "          \"field_mappings\": {\n" +
         "            \"col1\": \"col1\",\n" +
@@ -542,8 +549,8 @@ private static String modelDocString(String compressedDefinition, String modelId
         "    \"processors\": [\n" +
         "      {\n" +
         "        \"inference\": {\n" +
-        "          \"target_field\": \"regression_value\",\n" +
         "          \"model_id\": \"test_regression\",\n" +
+        "          \"tag\": \"regression\",\n" +
         "          \"inference_config\": {\"regression\": {}},\n" +
         "          \"field_mappings\": {\n" +
         "            \"col1\": \"col1\",\n" +
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
index 0450cd4aa966b..805123cf53cc2 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
@@ -59,17 +59,14 @@ public class InferenceProcessor extends AbstractProcessor {
     public static final String INFERENCE_CONFIG = "inference_config";
     public static final String TARGET_FIELD = "target_field";
     public static final String FIELD_MAPPINGS = "field_mappings";
-    public static final String MODEL_INFO_FIELD = "model_info_field";
-    public static final String INCLUDE_MODEL_METADATA = "include_model_metadata";
+    private static final String DEFAULT_TARGET_FIELD = "ml.inference";
 
     private final Client client;
     private final String modelId;
 
     private final String targetField;
-    private final String modelInfoField;
     private final InferenceConfig inferenceConfig;
     private final Map<String, String> fieldMapping;
-    private final boolean includeModelMetadata;
     private final InferenceAuditor auditor;
     private volatile boolean previouslyLicensed;
     private final AtomicBoolean shouldAudit = new AtomicBoolean(true);
@@ -80,15 +77,11 @@ public InferenceProcessor(Client client,
                               String targetField,
                               String modelId,
                               InferenceConfig inferenceConfig,
-                              Map<String, String> fieldMapping,
-                              String modelInfoField,
-                              boolean includeModelMetadata) {
+                              Map<String, String> fieldMapping) {
         super(tag);
         this.client = ExceptionsHelper.requireNonNull(client, "client");
         this.targetField = ExceptionsHelper.requireNonNull(targetField, TARGET_FIELD);
         this.auditor = ExceptionsHelper.requireNonNull(auditor, "auditor");
-        this.modelInfoField = ExceptionsHelper.requireNonNull(modelInfoField, MODEL_INFO_FIELD);
-        this.includeModelMetadata = includeModelMetadata;
         this.modelId = ExceptionsHelper.requireNonNull(modelId, MODEL_ID);
         this.inferenceConfig = ExceptionsHelper.requireNonNull(inferenceConfig, INFERENCE_CONFIG);
         this.fieldMapping = ExceptionsHelper.requireNonNull(fieldMapping, FIELD_MAPPINGS);
@@ -153,10 +146,8 @@ void mutateDocument(InternalInferModelAction.Response response, IngestDocument i
         if (response.getInferenceResults().isEmpty()) {
             throw new ElasticsearchStatusException("Unexpected empty inference response", RestStatus.INTERNAL_SERVER_ERROR);
         }
-        response.getInferenceResults().get(0).writeResult(ingestDocument, this.targetField, inferenceConfig);
-        if (includeModelMetadata) {
-            ingestDocument.setFieldValue(modelInfoField + "." + MODEL_ID, modelId);
-        }
+        response.getInferenceResults().get(0).writeResult(ingestDocument, this.targetField);
+        ingestDocument.setFieldValue(targetField + "." + MODEL_ID, modelId);
     }
 
     @Override
@@ -237,26 +228,20 @@ public InferenceProcessor create(Map<String, Processor.Factory> processorFactori
                     maxIngestProcessors);
             }
 
-            boolean includeModelMetadata = ConfigurationUtils.readBooleanProperty(TYPE, tag, config, INCLUDE_MODEL_METADATA, true);
             String modelId = ConfigurationUtils.readStringProperty(TYPE, tag, config, MODEL_ID);
-            String targetField = ConfigurationUtils.readStringProperty(TYPE, tag, config, TARGET_FIELD);
+            String defaultTargetField = tag == null ? DEFAULT_TARGET_FIELD : DEFAULT_TARGET_FIELD + "." + tag;
+            // If multiple inference processors are in the same pipeline, it is wise to tag them
+            // The tag will keep default value entries from stepping on each other
+            String targetField = ConfigurationUtils.readStringProperty(TYPE, tag, config, TARGET_FIELD, defaultTargetField);
             Map<String, String> fieldMapping = ConfigurationUtils.readOptionalMap(TYPE, tag, config, FIELD_MAPPINGS);
             InferenceConfig inferenceConfig = inferenceConfigFromMap(ConfigurationUtils.readMap(TYPE, tag, config, INFERENCE_CONFIG));
-            String modelInfoField = ConfigurationUtils.readStringProperty(TYPE, tag, config, MODEL_INFO_FIELD, "ml");
-            // If multiple inference processors are in the same pipeline, it is wise to tag them
-            // The tag will keep metadata entries from stepping on each other
-            if (tag != null) {
-                modelInfoField += "." + tag;
-            }
             return new InferenceProcessor(client,
                 auditor,
                 tag,
                 targetField,
                 modelId,
                 inferenceConfig,
-                fieldMapping,
-                modelInfoField,
-                includeModelMetadata);
+                fieldMapping);
         }
 
         // Package private for testing
@@ -285,7 +270,7 @@ InferenceConfig inferenceConfigFromMap(Map<String, Object> inferenceConfig) {
                 checkSupportedVersion(ClassificationConfig.EMPTY_PARAMS);
                 return ClassificationConfig.fromMap(valueMap);
             } else if (inferenceConfig.containsKey(RegressionConfig.NAME)) {
-                checkSupportedVersion(new RegressionConfig());
+                checkSupportedVersion(RegressionConfig.EMPTY_PARAMS);
                 return RegressionConfig.fromMap(valueMap);
             } else {
                 throw ExceptionsHelper.badRequestException("unrecognized inference configuration type {}. Supported types {}",
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
index 6c2fdee78a917..760a98a3316f1 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
@@ -619,7 +619,7 @@ public void testMachineLearningInferModelRestricted() throws Exception {
         client().execute(InternalInferModelAction.INSTANCE, new InternalInferModelAction.Request(
             modelId,
             Collections.singletonList(Collections.emptyMap()),
-            new RegressionConfig(),
+            RegressionConfig.EMPTY_PARAMS,
             false
         ), inferModelSuccess);
         InternalInferModelAction.Response response = inferModelSuccess.actionGet();
@@ -636,7 +636,7 @@ public void testMachineLearningInferModelRestricted() throws Exception {
             client().execute(InternalInferModelAction.INSTANCE, new InternalInferModelAction.Request(
                 modelId,
                 Collections.singletonList(Collections.emptyMap()),
-                new RegressionConfig(),
+                RegressionConfig.EMPTY_PARAMS,
                 false
             )).actionGet();
         });
@@ -649,7 +649,7 @@ public void testMachineLearningInferModelRestricted() throws Exception {
         client().execute(InternalInferModelAction.INSTANCE, new InternalInferModelAction.Request(
             modelId,
             Collections.singletonList(Collections.emptyMap()),
-            new RegressionConfig(),
+            RegressionConfig.EMPTY_PARAMS,
             true
         ), inferModelSuccess);
         response = inferModelSuccess.actionGet();
@@ -665,7 +665,7 @@ public void testMachineLearningInferModelRestricted() throws Exception {
         client().execute(InternalInferModelAction.INSTANCE, new InternalInferModelAction.Request(
             modelId,
             Collections.singletonList(Collections.emptyMap()),
-            new RegressionConfig(),
+            RegressionConfig.EMPTY_PARAMS,
             false
         ), listener);
         assertThat(listener.actionGet().getInferenceResults(), is(not(empty())));
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
index b9132d5e2534f..55720f73ccb25 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
@@ -45,43 +45,42 @@ public void setUpVariables() {
     }
 
     public void testMutateDocumentWithClassification() {
-        String targetField = "classification_value";
+        String targetField = "ml.my_processor";
         InferenceProcessor inferenceProcessor = new InferenceProcessor(client,
             auditor,
             "my_processor",
             targetField,
             "classification_model",
             ClassificationConfig.EMPTY_PARAMS,
-            Collections.emptyMap(),
-            "ml.my_processor",
-            true);
+            Collections.emptyMap());
 
         Map<String, Object> source = new HashMap<>();
         Map<String, Object> ingestMetadata = new HashMap<>();
         IngestDocument document = new IngestDocument(source, ingestMetadata);
 
         InternalInferModelAction.Response response = new InternalInferModelAction.Response(
-            Collections.singletonList(new ClassificationInferenceResults(1.0, "foo", null)),
+            Collections.singletonList(new ClassificationInferenceResults(1.0,
+                "foo",
+                null,
+                ClassificationConfig.EMPTY_PARAMS)),
             true);
         inferenceProcessor.mutateDocument(response, document);
 
-        assertThat(document.getFieldValue(targetField, String.class), equalTo("foo"));
-        assertThat(document.getFieldValue("ml", Map.class),
-            equalTo(Collections.singletonMap("my_processor", Collections.singletonMap("model_id", "classification_model"))));
+        assertThat(document.getFieldValue(targetField + "." + ClassificationConfig.EMPTY_PARAMS.getResultsField(), String.class),
+            equalTo("foo"));
+        assertThat(document.getFieldValue("ml.my_processor.model_id", String.class), equalTo("classification_model"));
     }
 
     @SuppressWarnings("unchecked")
     public void testMutateDocumentClassificationTopNClasses() {
-        String targetField = "classification_value_probabilities";
+        ClassificationConfig classificationConfig = new ClassificationConfig(2, null, null);
         InferenceProcessor inferenceProcessor = new InferenceProcessor(client,
             auditor,
             "my_processor",
-            targetField,
-            "classification_model",
-            new ClassificationConfig(2, null),
-            Collections.emptyMap(),
             "ml.my_processor",
-            true);
+            "classification_model",
+            classificationConfig,
+            Collections.emptyMap());
 
         Map<String, Object> source = new HashMap<>();
         Map<String, Object> ingestMetadata = new HashMap<>();
@@ -92,29 +91,26 @@ public void testMutateDocumentClassificationTopNClasses() {
         classes.add(new ClassificationInferenceResults.TopClassEntry("bar", 0.4));
 
         InternalInferModelAction.Response response = new InternalInferModelAction.Response(
-            Collections.singletonList(new ClassificationInferenceResults(1.0, "foo", classes)),
+            Collections.singletonList(new ClassificationInferenceResults(1.0, "foo", classes, classificationConfig)),
             true);
         inferenceProcessor.mutateDocument(response, document);
 
-        assertThat((List<Map<?,?>>)document.getFieldValue(ClassificationConfig.DEFAULT_TOP_CLASSES_RESULT_FIELD, List.class),
+        assertThat((List<Map<?,?>>)document.getFieldValue("ml.my_processor.top_classes", List.class),
             contains(classes.stream().map(ClassificationInferenceResults.TopClassEntry::asValueMap).toArray(Map[]::new)));
-        assertThat(document.getFieldValue("ml", Map.class),
-            equalTo(Collections.singletonMap("my_processor", Collections.singletonMap("model_id", "classification_model"))));
-        assertThat(document.getFieldValue(targetField, String.class), equalTo("foo"));
+        assertThat(document.getFieldValue("ml.my_processor.model_id", String.class), equalTo("classification_model"));
+        assertThat(document.getFieldValue("ml.my_processor.predicted_value", String.class), equalTo("foo"));
     }
 
     @SuppressWarnings("unchecked")
     public void testMutateDocumentClassificationTopNClassesWithSpecificField() {
-        String targetField = "classification_value_probabilities";
+        ClassificationConfig classificationConfig = new ClassificationConfig(2, "result", "tops");
         InferenceProcessor inferenceProcessor = new InferenceProcessor(client,
             auditor,
             "my_processor",
-            targetField,
-            "classification_model",
-            new ClassificationConfig(2, "my_top_classes"),
-            Collections.emptyMap(),
             "ml.my_processor",
-            true);
+            "classification_model",
+            classificationConfig,
+            Collections.emptyMap());
 
         Map<String, Object> source = new HashMap<>();
         Map<String, Object> ingestMetadata = new HashMap<>();
@@ -125,98 +121,36 @@ public void testMutateDocumentClassificationTopNClassesWithSpecificField() {
         classes.add(new ClassificationInferenceResults.TopClassEntry("bar", 0.4));
 
         InternalInferModelAction.Response response = new InternalInferModelAction.Response(
-            Collections.singletonList(new ClassificationInferenceResults(1.0, "foo", classes)),
+            Collections.singletonList(new ClassificationInferenceResults(1.0, "foo", classes, classificationConfig)),
             true);
         inferenceProcessor.mutateDocument(response, document);
 
-        assertThat((List<Map<?,?>>)document.getFieldValue("my_top_classes", List.class),
+        assertThat((List<Map<?,?>>)document.getFieldValue("ml.my_processor.tops", List.class),
             contains(classes.stream().map(ClassificationInferenceResults.TopClassEntry::asValueMap).toArray(Map[]::new)));
-        assertThat(document.getFieldValue("ml", Map.class),
-            equalTo(Collections.singletonMap("my_processor", Collections.singletonMap("model_id", "classification_model"))));
-        assertThat(document.getFieldValue(targetField, String.class), equalTo("foo"));
+        assertThat(document.getFieldValue("ml.my_processor.model_id", String.class), equalTo("classification_model"));
+        assertThat(document.getFieldValue("ml.my_processor.result", String.class), equalTo("foo"));
     }
 
     public void testMutateDocumentRegression() {
-        String targetField = "regression_value";
+        RegressionConfig regressionConfig = new RegressionConfig("foo");
         InferenceProcessor inferenceProcessor = new InferenceProcessor(client,
             auditor,
             "my_processor",
-            targetField,
-            "regression_model",
-            new RegressionConfig(),
-            Collections.emptyMap(),
             "ml.my_processor",
-            true);
-
-        Map<String, Object> source = new HashMap<>();
-        Map<String, Object> ingestMetadata = new HashMap<>();
-        IngestDocument document = new IngestDocument(source, ingestMetadata);
-
-        InternalInferModelAction.Response response = new InternalInferModelAction.Response(
-            Collections.singletonList(new RegressionInferenceResults(0.7)), true);
-        inferenceProcessor.mutateDocument(response, document);
-
-        assertThat(document.getFieldValue(targetField, Double.class), equalTo(0.7));
-        assertThat(document.getFieldValue("ml", Map.class),
-            equalTo(Collections.singletonMap("my_processor", Collections.singletonMap("model_id", "regression_model"))));
-    }
-
-    public void testMutateDocumentNoModelMetaData() {
-        String targetField = "regression_value";
-        InferenceProcessor inferenceProcessor = new InferenceProcessor(client,
-            auditor,
-            "my_processor",
-            targetField,
             "regression_model",
-            new RegressionConfig(),
-            Collections.emptyMap(),
-            "ml.my_processor",
-            false);
+            regressionConfig,
+            Collections.emptyMap());
 
         Map<String, Object> source = new HashMap<>();
         Map<String, Object> ingestMetadata = new HashMap<>();
         IngestDocument document = new IngestDocument(source, ingestMetadata);
 
         InternalInferModelAction.Response response = new InternalInferModelAction.Response(
-            Collections.singletonList(new RegressionInferenceResults(0.7)), true);
+            Collections.singletonList(new RegressionInferenceResults(0.7, regressionConfig)), true);
         inferenceProcessor.mutateDocument(response, document);
 
-        assertThat(document.getFieldValue(targetField, Double.class), equalTo(0.7));
-        assertThat(document.hasField("ml"), is(false));
-    }
-
-    public void testMutateDocumentModelMetaDataExistingField() {
-        String targetField = "regression_value";
-        InferenceProcessor inferenceProcessor = new InferenceProcessor(client,
-            auditor,
-            "my_processor",
-            targetField,
-            "regression_model",
-            new RegressionConfig(),
-            Collections.emptyMap(),
-            "ml.my_processor",
-            true);
-
-        //cannot use singleton map as attempting to mutate later
-        Map<String, Object> ml = new HashMap<>(){{
-            put("regression_prediction", 0.55);
-        }};
-        Map<String, Object> source = new HashMap<>(){{
-            put("ml", ml);
-        }};
-        Map<String, Object> ingestMetadata = new HashMap<>();
-        IngestDocument document = new IngestDocument(source, ingestMetadata);
-
-        InternalInferModelAction.Response response = new InternalInferModelAction.Response(
-            Collections.singletonList(new RegressionInferenceResults(0.7)), true);
-        inferenceProcessor.mutateDocument(response, document);
-
-        assertThat(document.getFieldValue(targetField, Double.class), equalTo(0.7));
-        assertThat(document.getFieldValue("ml", Map.class),
-            equalTo(new HashMap<>(){{
-                put("my_processor", Collections.singletonMap("model_id", "regression_model"));
-                put("regression_prediction", 0.55);
-            }}));
+        assertThat(document.getFieldValue("ml.my_processor.foo", Double.class), equalTo(0.7));
+        assertThat(document.getFieldValue("ml.my_processor.model_id", String.class), equalTo("regression_model"));
     }
 
     public void testGenerateRequestWithEmptyMapping() {
@@ -228,10 +162,8 @@ public void testGenerateRequestWithEmptyMapping() {
             "my_processor",
             "my_field",
             modelId,
-            new ClassificationConfig(topNClasses, null),
-            Collections.emptyMap(),
-            "ml.my_processor",
-            false);
+            new ClassificationConfig(topNClasses, null, null),
+            Collections.emptyMap());
 
         Map<String, Object> source = new HashMap<>(){{
             put("value1", 1);
@@ -259,10 +191,8 @@ public void testGenerateWithMapping() {
             "my_processor",
             "my_field",
             modelId,
-            new ClassificationConfig(topNClasses, null),
-            fieldMapping,
-            "ml.my_processor",
-            false);
+            new ClassificationConfig(topNClasses, null, null),
+            fieldMapping);
 
         Map<String, Object> source = new HashMap<>(3){{
             put("value1", 1);
@@ -287,10 +217,8 @@ public void testHandleResponseLicenseChanged() {
             "my_processor",
             targetField,
             "regression_model",
-            new RegressionConfig(),
-            Collections.emptyMap(),
-            "ml.my_processor",
-            true);
+            RegressionConfig.EMPTY_PARAMS,
+            Collections.emptyMap());
 
         Map<String, Object> source = new HashMap<>();
         Map<String, Object> ingestMetadata = new HashMap<>();
@@ -299,7 +227,7 @@ public void testHandleResponseLicenseChanged() {
         assertThat(inferenceProcessor.buildRequest(document).isPreviouslyLicensed(), is(false));
 
         InternalInferModelAction.Response response = new InternalInferModelAction.Response(
-            Collections.singletonList(new RegressionInferenceResults(0.7)), true);
+            Collections.singletonList(new RegressionInferenceResults(0.7, RegressionConfig.EMPTY_PARAMS)), true);
         inferenceProcessor.handleResponse(response, document, (doc, ex) -> {
             assertThat(doc, is(not(nullValue())));
             assertThat(ex, is(nullValue()));
@@ -308,7 +236,7 @@ public void testHandleResponseLicenseChanged() {
         assertThat(inferenceProcessor.buildRequest(document).isPreviouslyLicensed(), is(true));
 
         response = new InternalInferModelAction.Response(
-            Collections.singletonList(new RegressionInferenceResults(0.7)), false);
+            Collections.singletonList(new RegressionInferenceResults(0.7, RegressionConfig.EMPTY_PARAMS)), false);
 
         inferenceProcessor.handleResponse(response, document, (doc, ex) -> {
             assertThat(doc, is(not(nullValue())));
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
index a544680f5496e..41bad95fbb3a6 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
@@ -93,7 +93,7 @@ public void testRegression() throws Exception {
             put("categorical", "dog");
         }};
 
-        SingleValueInferenceResults results = getSingleValue(model, fields, new RegressionConfig());
+        SingleValueInferenceResults results = getSingleValue(model, fields, RegressionConfig.EMPTY_PARAMS);
         assertThat(results.value(), equalTo(1.3));
 
         PlainActionFuture<InferenceResults> failedFuture = new PlainActionFuture<>();
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
index 66327d31c8178..eb1064aebb21c 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
@@ -119,12 +119,15 @@ public void testInferModels() throws Exception {
         }});
 
         // Test regression
-        InternalInferModelAction.Request request = new InternalInferModelAction.Request(modelId1, toInfer, new RegressionConfig(), true);
+        InternalInferModelAction.Request request = new InternalInferModelAction.Request(modelId1,
+            toInfer,
+            RegressionConfig.EMPTY_PARAMS,
+            true);
         InternalInferModelAction.Response response = client().execute(InternalInferModelAction.INSTANCE, request).actionGet();
         assertThat(response.getInferenceResults().stream().map(i -> ((SingleValueInferenceResults)i).value()).collect(Collectors.toList()),
             contains(1.3, 1.25));
 
-        request = new InternalInferModelAction.Request(modelId1, toInfer2, new RegressionConfig(), true);
+        request = new InternalInferModelAction.Request(modelId1, toInfer2, RegressionConfig.EMPTY_PARAMS, true);
         response = client().execute(InternalInferModelAction.INSTANCE, request).actionGet();
         assertThat(response.getInferenceResults().stream().map(i -> ((SingleValueInferenceResults)i).value()).collect(Collectors.toList()),
             contains(1.65, 1.55));
@@ -140,7 +143,7 @@ public void testInferModels() throws Exception {
             contains("not_to_be", "to_be"));
 
         // Get top classes
-        request = new InternalInferModelAction.Request(modelId2, toInfer, new ClassificationConfig(2, null), true);
+        request = new InternalInferModelAction.Request(modelId2, toInfer, new ClassificationConfig(2, null, null), true);
         response = client().execute(InternalInferModelAction.INSTANCE, request).actionGet();
 
         ClassificationInferenceResults classificationInferenceResults =
@@ -159,7 +162,7 @@ public void testInferModels() throws Exception {
             greaterThan(classificationInferenceResults.getTopClasses().get(1).getProbability()));
 
         // Test that top classes restrict the number returned
-        request = new InternalInferModelAction.Request(modelId2, toInfer2, new ClassificationConfig(1, null), true);
+        request = new InternalInferModelAction.Request(modelId2, toInfer2, new ClassificationConfig(1, null, null), true);
         response = client().execute(InternalInferModelAction.INSTANCE, request).actionGet();
 
         classificationInferenceResults = (ClassificationInferenceResults)response.getInferenceResults().get(0);
@@ -172,7 +175,7 @@ public void testInferMissingModel() {
         InternalInferModelAction.Request request = new InternalInferModelAction.Request(
             model,
             Collections.emptyList(),
-            new RegressionConfig(),
+            RegressionConfig.EMPTY_PARAMS,
             true);
         try {
             client().execute(InternalInferModelAction.INSTANCE, request).actionGet();

From 67d3cb78a60dd5f0b46e7b87b8140c8d1e63b80a Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Thu, 12 Dec 2019 17:27:41 +0200
Subject: [PATCH 184/686] [ML] Persist/restore state for DFA classification
 (#50040)

This commit adds state persist/restore for data frame analytics classification jobs.
---
 .../ml/dataframe/analyses/Classification.java  |  4 ++--
 .../analyses/ClassificationTests.java          |  7 +++++++
 .../xpack/ml/integration/ClassificationIT.java |  7 +++++++
 ...lNativeDataFrameAnalyticsIntegTestCase.java |  7 +++++++
 .../xpack/ml/integration/RegressionIT.java     | 18 ++++++------------
 5 files changed, 29 insertions(+), 14 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
index ed4cb1fe18f8e..cbd78b4f3baab 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
@@ -251,12 +251,12 @@ public boolean supportsMissingValues() {
 
     @Override
     public boolean persistsState() {
-        return false;
+        return true;
     }
 
     @Override
     public String getStateDocId(String jobId) {
-        throw new UnsupportedOperationException();
+        return jobId + "_classification_state#1";
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
index 8308ef8dad289..75a7410f181ba 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
@@ -209,4 +209,11 @@ public void testToXContent_GivenEmptyParams() throws IOException {
             assertThat(json, containsString("randomize_seed"));
         }
     }
+
+    public void testGetStateDocId() {
+        Classification classification = createRandom();
+        assertThat(classification.persistsState(), is(true));
+        String randomId = randomAlphaOfLength(10);
+        assertThat(classification.getStateDocId(randomId), equalTo(randomId + "_classification_state#1"));
+    }
 }
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 0e49043fcfbe5..0c486fdeee678 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -95,6 +95,7 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
 
         assertProgress(jobId, 100, 100, 100, 100);
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [classification]",
@@ -135,6 +136,7 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsHundred() throws Excepti
 
         assertProgress(jobId, 100, 100, 100, 100);
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [classification]",
@@ -195,6 +197,7 @@ public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
 
         assertProgress(jobId, 100, 100, 100, 100);
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [classification]",
@@ -447,4 +450,8 @@ private <T> void assertEvaluation(String dependentVariable, List<T> dependentVar
             assertThat(confusionMatrixResult.getOtherActualClassCount(), equalTo(0L));
         }
     }
+
+    protected String stateDocId() {
+        return jobId + "_classification_state#1";
+    }
 }
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
index 8ff82c28b36e0..980f5f4da5ecb 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
@@ -274,4 +274,11 @@ protected static Set<String> getTrainingRowsIds(String index) {
         assertThat(trainingRowsIds.isEmpty(), is(false));
         return trainingRowsIds;
     }
+
+    protected static void assertModelStatePersisted(String stateDocId) {
+        SearchResponse searchResponse = client().prepareSearch(AnomalyDetectorsIndex.jobStateIndexPattern())
+            .setQuery(QueryBuilders.idsQuery().addIds(stateDocId))
+            .get();
+        assertThat(searchResponse.getHits().getHits().length, equalTo(1));
+    }
 }
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
index 84d408daacc61..29480d711f37f 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
@@ -12,14 +12,12 @@
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsState;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParams;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParamsTests;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
-import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.junit.After;
 
 import java.util.Arrays;
@@ -82,7 +80,7 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
 
         assertProgress(jobId, 100, 100, 100, 100);
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
-        assertModelStatePersisted(jobId);
+        assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [regression]",
@@ -119,7 +117,7 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsHundred() throws Excepti
 
         assertProgress(jobId, 100, 100, 100, 100);
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
-        assertModelStatePersisted(jobId);
+        assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [regression]",
@@ -171,7 +169,7 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty() throws Exception
 
         assertProgress(jobId, 100, 100, 100, 100);
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
-        assertModelStatePersisted(jobId);
+        assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [regression]",
@@ -233,7 +231,7 @@ public void testStopAndRestart() throws Exception {
 
         assertProgress(jobId, 100, 100, 100, 100);
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
-        assertModelStatePersisted(jobId);
+        assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
     }
 
@@ -324,11 +322,7 @@ private static Map<String, Object> getMlResultsObjectFromDestDoc(Map<String, Obj
         return resultsObject;
     }
 
-    private static void assertModelStatePersisted(String jobId) {
-        String docId = jobId + "_regression_state#1";
-        SearchResponse searchResponse = client().prepareSearch(AnomalyDetectorsIndex.jobStateIndexPattern())
-            .setQuery(QueryBuilders.idsQuery().addIds(docId))
-            .get();
-        assertThat(searchResponse.getHits().getHits().length, equalTo(1));
+    protected String stateDocId() {
+        return jobId + "_regression_state#1";
     }
 }

From 8102a5292a24d8ac58674f8bddb2dd618d23048b Mon Sep 17 00:00:00 2001
From: David Roberts <dave.roberts@elastic.co>
Date: Thu, 12 Dec 2019 15:33:22 +0000
Subject: [PATCH 185/686] [TEST] Increase timeout for ML internal cluster
 cleanup (#50142)

Closes #48511
---
 .../xpack/ml/support/BaseMlIntegTestCase.java      | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
index 60b524ae0a025..ef226f02cf5a1 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
@@ -313,24 +313,24 @@ public static void deleteAllJobs(Logger logger, Client client) throws Exception
 
         try {
             CloseJobAction.Request closeRequest = new CloseJobAction.Request(MetaData.ALL);
-            closeRequest.setCloseTimeout(TimeValue.timeValueSeconds(30L));
+            // This usually takes a lot less than 90 seconds, but has been observed to be very slow occasionally
+            // in CI and a 90 second timeout will avoid the cost of investigating these intermittent failures.
+            // See https://github.com/elastic/elasticsearch/issues/48511
+            closeRequest.setCloseTimeout(TimeValue.timeValueSeconds(90L));
             logger.info("Closing jobs using [{}]", MetaData.ALL);
-            CloseJobAction.Response response = client.execute(CloseJobAction.INSTANCE, closeRequest)
-                    .get();
+            CloseJobAction.Response response = client.execute(CloseJobAction.INSTANCE, closeRequest).get();
             assertTrue(response.isClosed());
         } catch (Exception e1) {
             try {
                 CloseJobAction.Request closeRequest = new CloseJobAction.Request(MetaData.ALL);
                 closeRequest.setForce(true);
                 closeRequest.setCloseTimeout(TimeValue.timeValueSeconds(30L));
-                CloseJobAction.Response response =
-                        client.execute(CloseJobAction.INSTANCE, closeRequest).get();
+                CloseJobAction.Response response = client.execute(CloseJobAction.INSTANCE, closeRequest).get();
                 assertTrue(response.isClosed());
             } catch (Exception e2) {
                 logger.warn("Force-closing jobs failed.", e2);
             }
-            throw new RuntimeException("Had to resort to force-closing job, something went wrong?",
-                    e1);
+            throw new RuntimeException("Had to resort to force-closing job, something went wrong?", e1);
         }
 
         for (final Job job : jobs.results()) {

From 9e91e49f4fb0a846f5bb671755e822bc59fe87dc Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Thu, 12 Dec 2019 08:20:39 -0800
Subject: [PATCH 186/686] [DOCS] Updates transform screenshots and text
 (#50059)

---
 .../transform/ecommerce-tutorial.asciidoc     |  30 ++++++++++--------
 .../transform/images/dataframe-transforms.jpg | Bin 246311 -> 0 bytes
 .../transform/images/ecommerce-batch.jpg      | Bin 126036 -> 0 bytes
 .../transform/images/ecommerce-continuous.jpg | Bin 198381 -> 0 bytes
 .../transform/images/ecommerce-pivot1.jpg     | Bin 500724 -> 422956 bytes
 .../transform/images/ecommerce-pivot2.jpg     | Bin 571857 -> 493958 bytes
 .../transform/images/manage-transforms.jpg    | Bin 0 -> 196675 bytes
 .../transform/images/ml-dataframepivot.jpg    | Bin 93753 -> 0 bytes
 .../transform/images/pivot-preview.jpg        | Bin 0 -> 140881 bytes
 docs/reference/transform/overview.asciidoc    |   2 +-
 10 files changed, 17 insertions(+), 15 deletions(-)
 delete mode 100644 docs/reference/transform/images/dataframe-transforms.jpg
 delete mode 100644 docs/reference/transform/images/ecommerce-batch.jpg
 delete mode 100644 docs/reference/transform/images/ecommerce-continuous.jpg
 create mode 100644 docs/reference/transform/images/manage-transforms.jpg
 delete mode 100644 docs/reference/transform/images/ml-dataframepivot.jpg
 create mode 100644 docs/reference/transform/images/pivot-preview.jpg

diff --git a/docs/reference/transform/ecommerce-tutorial.asciidoc b/docs/reference/transform/ecommerce-tutorial.asciidoc
index 311dc8b777d5a..6a640f5bc37a3 100644
--- a/docs/reference/transform/ecommerce-tutorial.asciidoc
+++ b/docs/reference/transform/ecommerce-tutorial.asciidoc
@@ -50,7 +50,7 @@ they purchased. Or you might want to take the currencies or geographies into
 consideration. What are the most interesting ways you can transform and
 interpret this data?
 
-Go to *Machine Learning* > *Data Frames* in {kib} and use the
+Go to *Management* > *Elasticsearch* > *Transforms* in {kib} and use the
 wizard to create a {transform}:
 
 [role="screenshot"]
@@ -63,25 +63,25 @@ Let's add some more aggregations to learn more about our customers' orders. For
 example, let's calculate the total sum of their purchases, the maximum number of
 products that they purchased in a single order, and their total number of orders.
 We'll accomplish this by using the
-{ref}/search-aggregations-metrics-sum-aggregation.html[`sum` aggregation] on the
+<<search-aggregations-metrics-sum-aggregation,`sum` aggregation>> on the
 `taxless_total_price` field, the
-{ref}/search-aggregations-metrics-max-aggregation.html[`max` aggregation] on the
+<<search-aggregations-metrics-max-aggregation,`max` aggregation>> on the
 `total_quantity` field, and the
-{ref}/search-aggregations-metrics-cardinality-aggregation.html[`cardinality` aggregation]
+<<search-aggregations-metrics-cardinality-aggregation,`cardinality` aggregation>>
 on the `order_id` field:
 
 [role="screenshot"]
 image::images/ecommerce-pivot2.jpg["Adding multiple aggregations to a {transform} in {kib}"]
 
 TIP: If you're interested in a subset of the data, you can optionally include a
-{ref}/search-request-body.html#request-body-search-query[query] element. In this
+<<request-body-search-query,query>> element. In this
 example, we've filtered the data so that we're only looking at orders with a
 `currency` of `EUR`. Alternatively, we could group the data by that field too.
 If you want to use more complex queries, you can create your {dataframe} from a
 {kibana-ref}/save-open-search.html[saved search].
 
 If you prefer, you can use the
-{ref}/preview-transform.html[preview {transforms} API]:
+<<preview-transform,preview {transforms} API>>:
 
 [source,console]
 --------------------------------------------------
@@ -147,16 +147,13 @@ target index does not exist, it will be created automatically.
 Since this sample data index is unchanging, let's use the default behavior and
 just run the {transform} once.
 
-[role="screenshot"]
-image::images/ecommerce-batch.jpg["Specifying the {transform} options in {kib}"]
-
 If you want to try it out, however, go ahead and click on *Continuous mode*. 
 You must choose a field that the {transform} can use to check which
 entities have changed. In general, it's a good idea to use the ingest timestamp
 field. In this example, however, you can use the `order_date` field.
 
 If you prefer, you can use the
-{ref}/put-transform.html[create {transforms} API]. For
+<<put-transform,create {transforms} API>>. For
 example:
 
 [source,console]
@@ -228,11 +225,11 @@ can stop it.
 You can start, stop, and manage {transforms} in {kib}:
 
 [role="screenshot"]
-image::images/dataframe-transforms.jpg["Managing {transforms} in {kib}"]
+image::images/manage-transforms.jpg["Managing {transforms} in {kib}"]
 
 Alternatively, you can use the
-{ref}/start-transform.html[start {transforms}] and
-{ref}/stop-transform.html[stop {transforms}] APIs. For
+<<start-transform,start {transforms}>> and
+<<stop-transform,stop {transforms}>> APIs. For
 example:
 
 [source,console]
@@ -241,6 +238,11 @@ POST _transform/ecommerce-customer-transform/_start
 --------------------------------------------------
 // TEST[skip:setup kibana sample data]
 
+TIP: If you chose a batch {transform}, it is a single operation that has a
+single checkpoint. You cannot restart it when it's complete. {ctransforms-cap}
+differ in that they continually increment and process checkpoints as new source
+data is ingested.
+
 --
 
 . Explore the data in your new index.
@@ -255,6 +257,6 @@ image::images/ecommerce-results.jpg["Exploring the new index in {kib}"]
 
 TIP: If you do not want to keep the {transform}, you can delete it in
 {kib} or use the
-{ref}/delete-transform.html[delete {transform} API]. When
+<<delete-transform,delete {transform} API>>. When
 you delete a {transform}, its destination index and {kib} index
 patterns remain.
diff --git a/docs/reference/transform/images/dataframe-transforms.jpg b/docs/reference/transform/images/dataframe-transforms.jpg
deleted file mode 100644
index 927678f894d4ba2b411560d60665b6f6e9b71570..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 246311
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
V>i7k~-LkIEcYkdZy2SkdCIAo;Npb)H

diff --git a/docs/reference/transform/images/ecommerce-batch.jpg b/docs/reference/transform/images/ecommerce-batch.jpg
deleted file mode 100644
index bed3fedd4cf01a385df2059ed2e59f1116b6119b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 126036
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

diff --git a/docs/reference/transform/images/ecommerce-continuous.jpg b/docs/reference/transform/images/ecommerce-continuous.jpg
deleted file mode 100644
index f144fc8cb9541bf12150044fea22f2e650302f91..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 198381
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
Yf_5i={$KF){x2Tu{!0d9@Xz`G0Z3PR!2kdN

diff --git a/docs/reference/transform/images/ecommerce-pivot1.jpg b/docs/reference/transform/images/ecommerce-pivot1.jpg
index b55b88b8acfb0f6a3dfc032f35b065a35c30f541..d7ecaa666e89302d0f8dc85a0b719d55e4c2b6e5 100644
GIT binary patch
literal 422956
zcmeFYXIPWn(kL9IsR#%NNR5h!NQnwaHF*>f0RaUm(jp>42oRALAtW|XKtxeNL5NC|
z8l_50q(6#?)KG*FA|Oo?gm6O&=f=JF^X&az=R4=S-XGt0ejJoLlUeJYwPx0=Su?YS
z^?~&<$PTMhmZu<_HbEe#!GDl-I^+*?Eb0mbVq*h22!TMhKsMb)K?Fev>;h2$e<6^~
zFE{@SBlz*9z+dpGjmGtPh~Zg3OeiMA4|8?5uFfHd;R#C{!3_%F&u>`mH@Kr$`Tk%M
zq*QSF#@1(ZzzO{NxX2GnGc)8_d%IJXXUu<3N@T$6>eYbFyCIOkpwMgf7AJPQTyWhj
zG6>lWk%x$a^AYv(4!L^#?AbFLG&lPGru`oecK`3WLwdCT=k5Q|`M-V<z3da>4Klw4
zY`|O&@eTxGECeF-!u#sAPzXe1Cx|zU2)()iZ_HumHE@C;d~pNz{Ra%TL3UpH2Yl~$
zpY!%+V4oKtEbi^+bs2<<Kv?V2zu|rV4gSX*z#bqS3!fmLYbfvC8?rci4RZw*;PboT
zACLb{^S|}{Ux9%EVIa@Hf1u!VdkEUW8vHx}@_y&C*U1f72ZW2fz04gzcpnH4g`=Eo
z{|WQ2hMuqo;r*bh><vRZ9tUAimo}fia_y8O2!nJsU-Jt){VzBz((k-8h?fQNjX{@e
z?f&`hfOm))C`-s*5YPAXvD}ca3Irms8x?AK9)v+U0`O}X`;GqK90aah_Bm+|!df64
zkH%PU%mJh+P#F^Luz}y0&p@P~*~UCK@Spv?tj>ZksMP}FJ^>aR{lT#WxK~5Z{&Nn3
zDnS9Z8{>jw37+%``OPm#M^Giy@BC>H4~{Ds5PI$WKi?I6cm;LJ@}K=n{jQzfz;C=e
zbT#0&j)HR&+I%g{euH;#EFm4QYvvXp4AK-j>l5U-A<qps9OAUe3*rO8KrVq#Z%7b?
z2iXm=hgd*PfS*?(*T9x55ELW;#Q1=%J|M;i{PwRt+P~imfuKP=3KIUiEd+d?{oV5)
zZ~m+AZip|44TAjm-Papprji2*11b4I=0L39Uo>|^%)oD9AkO#yfzChXGW}0F7(qF~
zLxQ^CuZiFp!DE7kf<}<tf(XGs1mS`wL9CIW$zQb3g75r`qmB7YgQNU|PB1v4&+mRt
zAny$zkD(AR@JR=IU?3rXQTPw3JX8of@OR6tYe<xLXA<+@WQ79XME})8`#&UV_rH_5
z(08F9LVe(KQ0UuVG<FLO3w;Cs4T7@yn-|RA?f;bW#!8{U6~+8VzyG=x|LS!d<TT*-
zn}MJdP$17f|HiZSztd>L)$RIwv_8T2?mgSva94sJD*TPzkb=)$TedCame$|cL)1g_
zhx!h^I+T5AR^YKfg+RSPwLp!)XUJ}W4+0GW6oFO&l0fZW{r^`w^w-)$HfFw|R~z%*
z(5`=R`0ug?HCFtDxT3hK_(^f7xSIHxzk2N!mlHoMep*}|Y*GAc-Tv0^-T%%xD3=T1
zX#bMW|9q^Cy@L9S61WDN#6S%|{XOD;=zt?QV-zF;q<IaL_lCX&L9T;+|9$8ElOsVD
z!NY=<|3$kEH+24Aw1v%uPYNH0>=r&KY$SYG*lGj**IpJ@2iuImr}@9n4b+dndi)2c
zKA}F?jq?OzhPitE8p_u%boY@%hYWTf2ai6V-IhV#I$FEE0s?mbZVK6b%_qd?TDZ?;
z9mvMHx$zzZ^2`4BdALco^KV?J4Fq!RCusY={*7}DgFuQxAP_mdzi|gZTPZ_?K;9qq
z4!aiq4|?E1-2s7wT+u!9`}?NtCqVl(y1xDkv|}R45D4$l`a0+J`Z_NQr2h>9`4F)F
z0V26Y@RZ<3flZQ-&61l0BsZ-$L%^eElhCH$KmQ~Q*|b?eP)Jy0%hqk8V26qwkj<L}
z1U3r_2nlUC6q};Kc8H*)kkp>T$AzWOd5P=|-g)HaqgPv0PrPf8vF~E;)4g=<*4AyZ
za=YXe)b^_%&^V~4f7HOx$k^<p`6-LjmR1hu9i5y(_Pj6qT=Dfo`G<stg-2koN8Y{@
z6MOewTzvB5Cr?vSpFK}|ot2%FoA)NaptP*KqO$6JbxmVab4zR6pC3PU_w@GlQwIiz
z=;Ms<6O&Uvre|1-zm}HSE5Pd7249;X0{>tOeEx&8|H2n2giV_T1qB2}Hu&1KIbwrx
zNkO4KhlQn%pA+#4mfm~h=9Zl&9=&?kuvJypo+)$bTGuw&eR^~?)&^_8Is1Rd*scE-
zXMZvFH($fxVel7M|4m>WB=X;U_3zi#M?eQOZG8x`U0@TaOahV+1cc8&0C~Cj#y0Ti
z{l6cOmlEq=e@jH%x-HX`>D;&=1Z0iFnlU?ncy3`rZ<X7aHD_wGBI1@cJ)nOu*)ci8
z_5H63{A)7i9=W-?x*b<E`KWpS#a`j?li`np+QUT_Ke810;&Bx~DoYm$IIlwlzwmAl
z{OpD+XPc@dFxMIN``eoFyO=FsADAi3DEQv3LyQrWum#7&mt$weoLjyE2i@)ru%=7*
z{n=jgs^7tiC%0NL!FL~i)DiudKt*dtFMRjKV)){>SauCaMIfSK9m2FH0s9H_nw(wJ
z@O{;{zEH;{22GETA5$4ZsV(MJKW-Y;VIrF5tsQ%`TBm=~8q<hz70>AL=Y(UzcAtN0
zYyj-f!4M}VXxyeWnpD;Dup4i73Grqfa+|h`EQkLJ-Og2JJszuifIG%grxTKvuwgV2
zfZ9lHC%m4Gy!@H9`qpZ*wNOh%v%{djLiG2eLl2(6aT`GmB^DPi7q`^8l=qZ5MN>$#
z?|gIY|3m3kDXqkcg}E-~Ec*t4;b>xM4E5VwBaRu@vulDS(qwmMD5j$uC~H;F5-ZWF
zdGI(;CcCmDpqO5a4a%I{+-6-nB#~kOzo7U1ap}l91Ua=5(?5b-<`Ej;53@J@Aq3e8
zIV<vj8^wD`7Uj3oM3>hgiHLHEW;+SoLBN@gDo-cuz|vZD?SvC^I!k8yBW06hnp3{I
zcTV~%kYD+F1-)z7qwBtV_nvU4jm4F-CM@zPB~z#|2^B12oOlzb$kL_%q<D=}HgS(L
z$+sDHLIBYk1wF%(i^19Dx}lAQtMcmJwP+6dr+G{i&zD*54D!l6(v>CasDK*$d1E#o
za`vCo{ObdHgTi#N1GJKoC|;O2ngGF@HmEvgN+{2pr*JG>n+mYd4{I;d;+So*IK&(O
zl~HJyzP7V%S5SaHW`{q2PhWZBb-j-L+P+OSLFu^w!G$GEDH)t*zio;rHukstWZRWM
zr4VL+&R9P!x0+vvcx0?CBXw!(kg?Qth!kS%?I^sDtYf|o5jqLTGeyQmZ|6*Viq`_>
zh(;URVTXRMMZv6r!Yq*1?qclROi`JxOo7Y4d)F;>vZktMAqZA+FR`L;PL`@Em6n&M
z8n|536<&rih>k=}h3exgR|!p&S@I$;s;CuQo4=UeSSe~);)Ri?k~?c_9~Q)CX?<?n
z<oL(F<g1X6ZF*|avc*4=XGC7K<YSXsV{)0x<3LDbZTxXkMNvd#e_er9eQP2*G|4w_
zI_S9UP~x0{!)VF=%8FP4<>vY?8A`BPS2#`b@`UyC)(kmrg&H(6q@wzjxT74lDzxiM
zj(uf0tt_WB<M9jbSWeh3nz=>@GHmDb0PHr^&!bwb@7*e{c7PSBctv_zEOjvOVWig8
zm&(Gy4$D>StAJq%&G`;Re$;MZxxQ@<F}+OS?plXf!xn#iLjr#U5`Oryruec7ZR-$d
z)@<@Rgt!aAReP<{K<J!VhX6;8uS2$ok$Btrrt6T#CYN;xV=4L?@)tv79df7KYyh^(
zL#{)FPb27?D%K&dh;2l`1r6omlS-`lxQpP{Pq`N*v<^WOg6sEDguDAFWl0zKwGI&#
z^InG}buE7+bl!*ZrMe_8Ql`L}$?pcq3RC&91Qi0^tBAl_gIB{=S+~KlUH8n%arq>0
z*YATeZw#$NzIHM?xmx;3e1rv6Z5;wXL;$Q$9=io{&<Bot`5v(`b5GAEViW#I-}mQu
z%p6Uo2EFF-#c1*Jd%sux+6FvYxf|_I?=K9@A;n#5Eea`)Z+nvmJ0&9ZRq>T8`5#NZ
zD9ojmdCe7AxQ6A@7W>M_xFjF_nQWf^yE1yG6d{0D+Q{!HC+?Wm-Wf@Lq?KUsbV~T>
zN~QC*H&r!`KP=ED&5j=}FQyp=d8Md*sh99+H?$r)mmgtO;8b7Sv9)y}C0pmoYi?Sd
z>$RFNqn|k{R*y<wz@oyRc)sXLwRAPPkWH=cbvAnWpIZ2T@Hdh5uHQ$M1fz^EE)K-8
zoY|AS>UGE^60ldK0U_&&bv^-5qOx%AyzH>zLzcl4*s!4G4l}dL{^C8C4Qh}#anLc!
zE}TWGd5zDzzKUtC<i77miPCxI`?BQEM+Ew%rbf;7w=Y%}#rgL-7gpBb6(d)t(ZpWZ
zTpnjXPLLN*7RB0)LFXoz>yXm`fw|Hc9^Cxar7;-|SM7Vg(;u$Mdhq^-zJxTE<n~@H
zqF~nbMd>#i&3n6L*@s+*j^D}t{u8v)c6PJN8vDwT)MZ{kI6;Xoh}+G}A<JRQ#wcx=
zyL?3;o!Q<x6tIT8htn8OgllpX?@h*@&Z;kabfdbvBI8)Lf$^#8oKD}uA1fba*w3TU
z5j#V6rzg~e6R4v{Nw2trga!$MPv@{Ie`_%(1pf{CHZP8>f^(;WTZFi>vO?Rr4!J^n
z;JK%(q{LKI?w->^Q|a-n0pMnkEm62)93zNL);4I};WpGJHg%t`=rP)+T+y;T)LCpH
zf9i;hMi`QMh1l--=3Z{PQ%}@7#D*`%CH>^(a89p78X`f`q(MdYD6qiUi~s5=&JwxF
z)n&?!sXS-3y8_?HyL-Z{?RMG}PiO9||4LTETGQtgLL-0XGql53TAYS#A8(r}4AgHa
zUx^6x&20;b@_(vf*lL;gc?fi@-Dp!)G`3rsZ6~<F=aEF@v2Zw&_kuD;w|hV-r?ru8
zX9_dbxl*d^>K?cN&L2p4iIr<2mP6zB_v;ml+I8cOzqzi-7(pXMzcckqVsfVALJDWj
z9%mi=2`zKAk$F%Sf%U4$_>>%v$?yoDo#>jKUh&uQ%}sI!qKBsW(62nu(%ecXG+bGS
z_&|aEVx(BEK5Gxof#uDhC0%?l^#NMe)`-;#!`w4&$!KXB970EOJUq;N=}>VbvULrg
z9*wVZ&8?1B>K|45x|~<qE0%piJnDiPXiu8p4|sCVZ7n0&{Kr)zq(`d`Fs>4fWkz@X
zF{;liA&e!_DwF2snNT-!WgK4Tn|UGn=$hlx*}#g-l{2h}CPZxH$sVgskF?!d(!%;0
zHQW^4J{~I0duQkWC@_>yS`DkuNY(qLUqhgNTn*(UO(WPSUM_wMo=OwOL0KF&mc@R=
zg3>V$wD%EDQJ1pxjtq|s{TaAyBkJD$vs>Bv50*+Cw$x?TShhG2{brha+B*%BxHEaY
zC!vhC#;4E|>N`6KfCiB(r_QzlrQ`=Bod7JyqYYZuA<F9z6h>yy#a}^Wj>Ek6rN@Eg
zSe!yqHGee<G&$Bi4+YJ28|kCcZL=QL+ZR|)#R|ofM0#PO@#zIux=p9Y>nh9|pFHkf
zoV!rUr-+%XTK_^jfOh&BUyr-D{4I+%?*Y1*C|)^v6Hbg$U-p0yUu9D;BRixYGdGLb
zz7~_3K;DHj>B9HyyASU~T^}#ri>~B#6oq{LGZEhs`X+szht8#1a*L`{^@~IK>yUO!
zJTkhT_Jc4+n<p>{>=a%~AO&qVNODYPAeu(dAISSygqZRLiQ~b6<2Gn#W=HHR?Ufrk
z<x%Moy`e}&v!dx9tpAF6eJQ&3n0t&%(4MI4I!A(o!z0l=#O#vJinA-|tid{eB5q3z
z<?**YXFVQI;>wcP61;c%Nx**Eyd#s*Mi9pD{DuuV!F$4W%t0UG`T%9<5Lm0+V<gk@
zK3SlQoNikQ*Q&Qz)DyFj=N>K+exHDjPJMmIN-D`1#VgjU@eH3^K|W5gAzz+b2qc3e
z&Q?yb!2?ckj91H7<&W^U08hth_tqirBHB6!YB(R@Iz6Vkxd4(en(=0Os4B5&SxoAf
ztDPh^It;oU>uDL<F8|%wqunAfG$H(%ZXs0r>Wk|EB}5M~Y09a3yA;sAWK)>nS`6Oh
zZ)LHhPw_I#kwV<#yn=NIS}Zyst%r>Rl*P!eiv29k$N6^6a|4UDjI;b)OR6w?J*MG`
z-Q@^rYyrd0Z`pE5G*D-zkv;Ru%HFxlqP8b!2+=~yX#So`B28sev~lx4xoX*<!TI8v
z)QFJ=oI3g2Hi4Wq@JN(Pl)ITn$g%B~0EvW(q{f$v`quh=mUx4TT)6>P^!(O>79^s2
zUoq#u)RS6*NNQDgb=>z!c(&nPA3gRs%B`lTAWhue`$zP7kq8RYcWIj0G)`!uB_bqn
z$}DfX#eF>(lxqOod^vz6He?=Qb}U6cxI3;a>Tt)#_l=83OOtB;;g0QvG95XeLtH%?
zgnFg_cm_rQBeEIGCN+N$6rs!z+B}PO04Kx)Iq=%YizE1n09O~e!u{F2ayQ%F$7B1P
zCB_j#z;gM`H?Wv}J=tU%s{>rAb9D}qp!;$Q1M^M0^~p2-u(SQ7Gm29m9YL|B!S7hs
z>iY)j|A^KG<$wXV;9D*Vh#8{|n6UNw5M$2~6_lH%LMWyxy{hRBuc*#EYgU8lIb{t*
zF)zt=a|tp_nF3{RLHfRJHuPFY=3G|uDGfx`Qs+T7@I*Sl$8)Kg>Ks%>rfKpw$u2pC
zS5Eyv%!Aq_lniKdw&I7On-G_i5>>X>cXJQ39@Ak7@Wa^KjOD3>&=FW8bi1iOeG4w)
z*cuwH7`^|OD>dk+$jzKvjbeMJgBD0(Xhl&Ill0cpL3{PSz5bq=Kd6aWbt6zcVkdkt
znzV&!Odnwp`Me(#okcS;epLHiFTy7Y*hiRu%9>(F_u}00u->NunsROheHgLBqQJku
zM!%%c$2W(2l$9EzSLhuUw)0gO5&B_IRr1k(pRY+7?5I$wuHN|Y;i|{=L^?IXE5x8Q
zkl;yVnyw(+5o6gjrZaKSgugXxj3nw$fi6RLpeZ}yyD!*;F;~VAO|@vTsBw#UsXj(!
zU2pb-$+aeP&?$(StI%*blioZunukI~MNJO=I15?__Y3APc2CY_q+ST+l1RB374K{<
zF)LwQFyzeXY?~zkM!xJMChe}`_*4>QEDljw6+`fisY-H4AJ0xT{$=4s@6I>D#;=Jv
zkFn!kn&nm8e>AdhC3AmI`9tMDs49D_B=X)p80|t%@ZcG6-qy*e!C`9Nw{-~YJ&((~
zgTRmmDg15vOm$me9m3HAK(~b1KBJ2zw5TXji&8CEl%@sQA-7?VQLIC2+K%_N9*Fbt
z-HY98-IJewo$FeTHl7(i+qG;mYk4x^$?NesaGN7+D6pD|{h5VpTuKRtD8lbTFg+v&
z8EktV8Lq}}p{STb3jpax;x>fue%@=GBj>~@kY)Rxx!RL%RZe-!^n5gC60Oa(C<F>!
z>&X>ede$bQtGT_)CigDgqHb?NIb6Gy99iv_LQ7nzqW!3P`2BI&JONNVhQ~WaAmBLA
z`itn{E+-tX0UDUU_*=R-fmjk7S@}zU3)~Qh*Y<4;PfLn<BBFA@17QQWjjux_Tu`~+
zj&+Y%Gu%3~Uk|DG&9PL~I5Jh`&hxaMHA0c^^9A2PJ~Co@@dti@&~OxF@(r|1jw>TK
z#?NBev9I@4q>DK>M)VsSG<U{~>Q$8Y;0R2HTW?@?O%J_4U=E`%W^%48?AgVd^rq4M
zU6_T?=u4W`e>%AZ+S&Ck4QowpHN)3C6|$@sIdk@?c^+OA1kQuoG?~!gK=2^}YP2S8
zi8eyHY;noVs5+}-g#VmbOP9M*6c|PXZM0<Av7-k(xzh^K6YPw<=^B-kl@v*|%D(=E
zx$;{13Q<MF?{$5!fb!W}J3=D;YU?Q;gkl5XIT8<Vx5z2M>x_cN@)NNfc?YLQ+=V|t
zXpklZA_edrIoe^Oq=d3j|L&6K^y-QGNs^-jv(T-kCa)||YA?QiYs8p3<W2{4??acE
z+N-sr=Dee#Txh?zv`kv^WTr2-gqFuxjb<Z)$veOi%;DSkJw(uo+(!gS3>r5zQ$SNm
zC*2)|vuu(YiQ)tGNi80BZSc*^iP7o^Cg?~tJ!&iR@S{kQetMO42kQ0Rc8s514um;$
zLtVNnl#PF`s0-(`YwK66xuIz%sh#~pPouzC51BWy0&P}r!2k!LEepE{4Uq_6*s!k?
zD9-?VZw)Mouf!GZty6x*ZyRcTS_FLnhm{i>pz@*b7)j#OrGS*^L|2h>tHOh#PKmp)
zOR|~r{W|brX^|+;r-J$Ke-#?AG~Ed5FdIJadPv|eb>GSnyZOibt(}|@?g?HEToHGi
zwbD!)m|~FTJV4(}(SmLQ6T#u$QhLHDGSi(eQENR|lDR@^Y@N<Rmbw01&G}NbB3ALl
zld*5N6!fQFT=%GcQg2K^_D{xD)x2Bv;aF}g52)33FxGH0q6|5w#?j<n1=&f&on^*!
z^d-etKyP+^Q*Rm;9p2iKo23#rE+*IHY207u?3?TP^Ibhl=x%HgclQcvUnC)J;n9T|
zhGqGS?AOG+_EKuq)Y}&|`-a_y*Lb+{xA+bU^BSdLL7EGivbjM{1pX6Ei7@tpD9!Z>
zL3`6}tQq$sU`#fjy%vJX%dHw0!!&sc^w(+n<kN)Sma>FaVo9dEtFE0)yBk*|*>9yR
zSLd4Syxg;3x8O8iD3w|1KMEcTV6;9=`IDc(B`_2To49aRRr6MDs8c!9_cqRwA+Hta
z`#@gbgdqMSwWeptZRE(uop#q{p2x}$?n_i~d{}s3PpNBpEoHW9YDIR*hRv@7%~>7a
zyF3Xn&SRrl5_2>rV;mWaxRP|AY{bik!+^HdQF-7x2Z}T4D_@5w;r^)Z#wlJ$<w?i`
zS<R9A?=S(vaq7a<`?9Zdb9K7o5|Xr!d7~Yu*X{#u?w$>#cc@vlz*UM(6({w|oCQ3=
z#uHo)CgL>h`*XJ3Tnu>5B>;5R>{#dgE7omB8&?{`pw2z_=IrJw_L2`JK;vp!bMgp{
zeYe`1JP)z#0lOwBGnH%1+@FOm)JdmrB@Y%f<)R~xJ@%J9wdjVLi2vev5M`L7x0+FZ
zl$Pf?y&Cqowr{X7f=`@SA;JbWT$>Gb2xPjA1=TWPYy`mLoZ$D;l**H2fy^GZ1%NR1
z)MXhob#B3eu?46p^K}+1_0}PY*op(8r*T$mf@|bBuRN@s3&rDzOVF~PUae??*a;p-
zE+YI%q~$b0ZJLVF99b-hmQBUHCTuuq!+}#FCA<fSvG34WgaQFYli;^eDpuyQSn2G|
z0F4nftgQMWoU$uOy_PvzPns#-7pW3c_zmqT!;}Mq)$8NvJF+Trlse|mSM+*cdkt?M
z1s!s%$RXdpbn^a_<oTfVdBQPRRrINx;<Pd_hKuD?5Rz&w7|vWJj1RbH_h5C|f*>b&
zd@qf8mL!Hd&>tot2K-{!HD*YAc9SKCf!mhEkG*rI+9iIYLM;BP@n^*zSMJV}@_sz>
zEGGnXG5SKE2QF_Ndc8FH!YeE^6I?<a%4Z`|Y0wBEn_{q7y$s_@)$&D&91}u=ZQVHr
z;`UXnC>W!ZrOq3H2e@5*KhB&98xL&BnP<OxJ?;D!l{T40hweCz%C;=Bp%<STAL?md
zQz6mUA!0z%DT8q85tQ^mdP42>3<I&Cw4anhw~k}Da-n@Z{5phJiJ+pRXjM<2TZpg(
zKZfN_dqNXO^;w>jydMVFPPOb)aLZ|ZRoHs}h+|1;2YjYS^`XwzUAq<L8isW9FBI}T
z@6WVyqHOk9t`220bSUDT-rG;TOGK=4><>k+hCSf}EhNn~<>qtdg6A5xqjnx@ePq7V
zU&`=x;t2~SzxU@)I&Le-+V*nO4b4ZD!-3%cs#=T_E&a;$zGPRm*B+_#)#&CYH~4!H
zfdoKPWIm6%!Uj)?TNzw~9>iEaQV`*tB#i&_7uN19FOx5Zvj?Bxw(5hM(EN!K+I8m9
zOitrk&yP}|zCxzotExO@wHRk-dITu5LtT2;Q}jK<*n7+Srj;ODxALLYpQ((MZ?Qud
zk4hU%&ODwNGF`oZsHAdb5Ns|JIfn+FRwR&7#0_9V=Y&{_>^_!wbvC{iA!%yIq%@2g
zG3{<}O=KUvvdiL{k(rbSd;7k`Wqr&ZZD1s1$hN!plmv`Z5v4j6J5sDC&UmSy3XK-$
zNWOR)o(TIR$jJj1wW_m5<BQGb%;9hFTSirRB@}-!Qb}N^z6Dgl-CYR?an5s{Fmkvf
zU3_JH7j!$pM<NzQrwy(}>-?AnC(wDXZc`pM-b1d<nYM#_Sie5!{#yNfQKo_;|7)qV
zRfqDKY6s`s?wJ=EYbLzh@`zvL1#Ec+S#x!mTLnJ>3N{e<#TQlN*zu{9in~pOdkCgI
zO~`|L3~VCc`!i(#1Pjshk)w=Lt4L?xVispij24btN2|MZ|J3WSpeJB&pYFowVSQsU
zQZ$sk|5k#~w<P~JeK6l$Eu3SQGwN4SRXHn*w7H+6X$x*SxirKqvZgJ8-%Vh;A%>;t
z3tSoB=C!0-b>`U?ptK8lF9>MjO~gCs{Fcj1%pHt^T^vG+Yc%dx=QXa&uufFK>>RS7
zL#0te&8djNHD2cPE15gL&IQeXWEn|S*qRb)!Pg#8a@HY*^EoY_7kIt%yr_B;yv|Az
z+iJ^2`O~{^92ePr`_J9?Z*BR$gJ4QEy7X0q2vi=<MUy31dIFaj7j8GM#d*T}vVlA0
zl4cr8ltKNNo}b0P_(kRP;3>nP&n8njaj&$UOT*~Ap(oLk-TY-Zw*5QJ;NZE&f{BcS
z3HUH8<Y=Oe6oH<Rwwig<{R;gbS04Y7R{#Ghp}A>wg5yMJFoP@MJBhM<dH!d-EM_Zq
znEe81+N~nRw1~%D&jk+zyO{Fnm$gx_9XK1-$ozx1I1^MsyRUv#Y#k!kuZ9}Wb&E{!
z&6@TvYr2liWk$qa&y)IIT_x)+Yp|*Dy23gnplxh%raBWL?{p-$!0Xxza)uSuHA78b
z%V~cx4lW@iJmp%!H~=LEJKr;kkeD3Ah<V}j6UW_0)*+>1?_Aa{go}#Wv<B_E->Gab
zLnbMdNIg)Lu!;$A(!ozC__JQr2_uIK8L6>jtfYIn0C>A5_$SbVW-=`La5jvE7@8;<
zj^>Mj=^{FBn`%gLdp4HTVthBg&ZJ-zmGUQ@Qpq)<D;vAf4t`oV+nxPHKYB0o*IkzV
z2YS{cpzLA0KFMNh%H%3V-0R(HSb*)GH)kE0SYwwnj=LP6JV|}q;_Y96>dmt%^_;o|
zFie{)<nN_m=(!<EHBa4b5n7*q&7G1^wvad;;vD+UrQq4;W3ErK<Y6=~X6Uzh`7e)g
zd85cu=Xo>}&F%qoU*UoPwG!)mAmn_qhlxwq@`0=}mcebDjjs}{0PEc1dimNHE&W7O
z_v5gix$jFUrSHpom)dJP;EO|`eK%&<igscpjx{s+guCb8oj>pYm1J2>KRjUd!0Lgn
zh~pcMm5kBligOvpkMd6y?QxQdTX9!!d5)0(zNA}}Qd@YpV8poBUrotYLRv7xUFTpL
zrL0)!K)c0(^LYmx^E4b@_`tGZI!>RuXIPBP%jK1s6ZDFh5*;6xz1Lk$u+md$5nG&g
zIZP&>cvJTXsckEsO}8;@`4W8V$@i=+)p{hOW2!PypX^SSjJ9=saew$^=*bgR4Z{{A
z%f-T>!>*rf`z`%P?{S~@6UNGrWvO@dG28v%djUDl)gKBAiKL(96k)$K+FUwI(W;N@
zR^T$E$eA~2QV3i;ew{QU>$H1xWN`Y>sJol1Ms=Fr9XZnA53F>HVS!=YDaCuHh-Nx-
zC*4i?-mBK@j{b(mj_PyMeJy=?>f7~=pC0?uwmiSlVP$8|{@3_(Zml{hO-@a8mONDP
zD=8u0*u_f!y~E)=XBnp#*YoVeZ2gar3@vC+4zvbZjH1*+7D$6M_HE|EyxLe4O$F=w
zfhNa?y0`%GoF;oeq5@wYNT53>?5}=X)`Pj+tBo@mckv=ucc~}Y$1B=6?e3?_Ij!{n
ziEB4H!4Gcc>c-RE8#6r;J|8*rsrZbxsVnK><UjyJWY_t8r?ebXCz($#f+a(JG`cXE
zhn^bM=9eJr=wN^=(Tvq#ydBUQ-ekKgjy|$|O1s$yn|I(uhAo!P+NS$dwm?lG?pk&0
z)vktLQ5`t?&zRpgtsS7-i<~zHZ*z|W=20xdxJ_Q%a-s=eN<thkY08vg+CJ2$?ZWo7
zj>3B7te9<gxCXh$Ix_0ka!HXb-UbnsDP3ke7e5|7r%K2l`zhIBIBb%a?BmdQws1MX
z$wcOU8+DB=vMF^8Wjs(9bdaPqp`eG#3EN_O?aAw8=YZ8wjqw1=ozmx%tM?B(PIDr6
zojEEeWHHP*{Qlc{UM5sDHhW@AO@&Xiui^1iM*?fjmD?I5;*3{XI%Dz5z|C=F3>*Qd
z7ojOb1QZa+f{Uq8TZbS$%Wfk__xEd;Ydc@)d8P2gDK3AYC}Od8dL^aw(<9Rux!d=S
z6dkopzf}5de@M#I(xK6|$NHbtJg?)`hr04yt?s<r`NlD|^r^+EJbk^Vt|6A?k4>(f
zX(b1y&{@C>5;VD=G=IHx?vq|t;;XrtFKJ;}r;1(CLvIe2&ui9%+zw6%KX$3kq3@sN
z8m77oi+Ks=?3hj#6K&1nrhSV*Dw7WZ$T7?fFps&E+NVlT#*&8}YPz!emG>ubbS?ds
z3g3m~A9|`y`y{+y+$LJwtVupkvbz)QQz%Yvs#byB3xQ%ToI~q0*gny$+1l#aUlaD~
zqxrRJO|s8r?DNhYKC3ckGE<IG?K^dGI+i!tdKr$(bMF41;){B-=JNHetQ?_75~^yJ
zk9{Fy*^U2JSR%0A{m=U<8r|+O7_~Ogq2=ev`=6)$YC@KVXGq+5{p_;oHLe73K*ydM
ze)RS5Z05li<rlg0*Q%S21+7DF)MF?_Ixk#x<C?md7r3fH@RGUd1s-w)DVhx73L%D8
z0p%)py}>#&ps}G81*|Ha_5lIGT_J3lt?WYn0Iy@>OhuScO&atqVZ}$sHHyP*bkDG4
zE4)Y@xgM=-=U*sUHnq!r&@wm>W<K;XExe!Vd5ti^yC6SkG|NNr!g*@El5gK!QO40N
zy=0Gy2kE}r&FPNb@uS^egdefrH0}#FlW)9#uwd-swkbVC3<cP02j27!kQhnxPdOMu
zgEIv~8B!gC#lYd%GRBp{vCctKBUA~m2EdN@<K?)<rDgFm!$`1pU_70J3Ve`Gw_ezW
zGi2sc@^<q-moZloURJ(G*L$DKsPWf0&?=cQQ87|Md0a`3TAsb)t9bPLT0IQY+1};$
zg`Knv8(#o4<hW9#woy4MSDKMDY{AxM5pHvxvuS?t{Y*+6T#u{KA1X#L@0}l|p6#xP
z);vos(W(#?ZAYmnCb&Jj9P2VrsL^pTOTXa$<DX9w>Y_+>{BXn=4W`I7<q;8Mg+!)<
z-GC@N1R&BE;-T;O#d+%Ul1w=VW>vyPFx6PzkcWngy-l}aPF8zIMC8&sQS{EZA>Z4e
zyNuCFHNFGJ4NGn0M?V85H7h*4<d3P9*-d?~Mfyw-Dh`k26ikyQR#rGa3CB~2Ok2AF
z=`rYh0?UBE4K=PUXTw}*Ln=)ty8@}>1}#bVFwtW~(HXfz7cPuq^BUg*i~MNa5BR;c
zU(3_&#G}hjQF@AsObsx>IVf4<u;R(=s_KxBZIAO(CN8MsDO5LZF@|V%i<eCqBN3Pu
z1aU014Zj&+aD4F{Dtb)PJ)CX{Hlh_S2!=)R0c2QJoSw2%<9L(f*Y98P(1!79{awqN
z7ktVV@8I1`Zy#w%Tw-h;(MyY%&6~o^l0SS;MN-$6R+kV8l(A02E-`C%An(1Y*h}P$
zGh#az%5fY<L&XD@kF<yRWC3jrvR;=nzkNJ7?1@BWDu12o-TUAavPx^t+Qg)uI(lp#
zjBgwEE5fOKO5vKz55(B3Gc?xDDz22n<2KM-7i{YMBM5=Q-TWbLYk_;Q{2JOoEabkH
zV0aQI33in7q?TE`K@K|-m}L#|2QdMBa00+1meu&j^h={{V=$3fl><l3fnj!8P6BR9
z^)o|6Cf*qpfr?&-5GGbqmZ(+BQ>)QatW~fQVG@jkZsV14$2MFep-sH9b;w2>(b~yg
z;uXNPa3}ieju&t}0Mgho^>MkIrrT>izis!<n;zZMR~&{E>txhNalGAnCo6CDg-M9!
z-Cin;PIF4%F16rjeY*9?g!St#N=gCEWMRa@a5%h=J6gz>SpLS3<s0*diOkayL(X*d
z2V@Z(n)jCCEun(b1rlE(u^}xgO8sO*F0A@il=XnC;X*)mYO@qPy%-hpY*|_2LfK(|
z<D-RvsC?AQ4o^3;gO{@m%X@voCSU*}b<{05(j$6`0plvXVqN-mq8m(ozCymOPi?k_
z#S^w8eC&qQD(r5K8uWxcq3T7WKj4k2rq}7iwUq6nO<L@0fVT@72=if}<@E*$Wk16t
z6#S|Ev;4H5YtGKW#IP%s6_xYTRko@7CBg=$Cn<$ti#=v*vqho^2xV;QmIYUm$bQ~n
z3OpWjfiw7Wm>XXt#y2hexhB(})V6rJlTLtr=7AU1w~$hVv2?^+aZ3a%mQZFm^%bYc
zyedFB{(-IhE<TQXZ5<-b9q4cGf_?_?AVt}Druw`Mm_QLCG^mj`bI<lrF95-eg;-a6
zfM%9#@c_C5i)n&N!!@w&_RNW%R?`OW@m*YFJr9ddeiO#g%iT>{_N7+o4&gaRt7@xK
z9#PjQ?WazX)fTyfyq7;BRTAhKidM{p*rh~R6L>Sc#IaF7`L*0y)I-yvYpHgN)KHsE
z_fq?=m!&;(TE(v)fabD)SMfYOac``ixua)@*{>#s2v-`$R%A`hKN?#A4lJ}Hw}AJg
zpvMZ{z65HXq1FX6+=huUH9nOI=wK8*BkC*@8COz*+mq{07LPVN+iPl)Kh2z$ynv=I
z0<kkD9pNV0Cq{d}XML)SCJ~-e+JE-C7p%<kqKCsdcL1<VLI?|r(G9mJ>1+>wKYj#S
zrX>E*-R#Ye8oOqq1osb0vUZ~K$cq}en-eU3Ue8nQ?QCmbtvv1R52dUQ<#%QyCqVU2
z8!llPrG|l5z7>cUFyJV1+_{k;NoWAmmt$`uE#@d;`w*o`_bYfJ<AesDinj5}iJm>o
zCE`x_9#`y@DI4bUnt52(KuZ>ydeqo4r&pHx)$b81g&O|VQe<#`xrnF*BZE0!KB7On
zDIyTe<HgQa4)Z2`=QTKbTs>X^VeBV#6Bhy0gO_h*AK*KA#JWwaC`V=r2`$4;7!S0j
zlbViUoSBuW#V+48hmq5Vv8B<{PL!UKth7%1s&1NH-7U1+^W=N&DGAYTC^$9hHbBi=
zU6{bkhHx-0yHCsZ?THIa*|T}L$nUMzwoI3pOOR80C2!n1RJ$4XQV8N~<jd;d2!aO`
zb?z~!URHQ8tb&lm29DEVcZf2GD^oyv)L7u&19Lc&oLT&ya=?VO*RdzG)+heUr(qkG
z#l1S@{x~#R@G8m}bC0Aqdoq5ouI5K-{VDAQLLW(+T0A-(bgBnW0F7?{2sa1JK{kZr
zEOYQ5p<oaX?Dw5#an5iN{ruhhRxqa2!*3<mRCXcgs$i~@C2dCKt0BM5Xk@)h9-VFW
zgr>HVw*Zf`QQg_j{N2bc?k%s2m-#o|xjm`KJ5a0^wK`7;8=M`sbQ@92emq^ZOyNQ`
z-T6d3gg;7r+c}^5%0lh~X2^LA)9Qwia`}h~9vd-fRoG6}cwgGP$4@78B!o_`)lN+a
zlpWW&Tv6LoktFfQWijpYuA|Csa`G0T)MZ+rX*^hRF#XGjIDp}At>@?v8cekChf##m
zb;w<uBRx=+L1>oe@545o?5{%=0}039_Pg5r;WB_V`=c)Tm|SDp(MNeR0_LTa-2r>*
z-ghmHDD*f}dcQpO(K?wsfnJ*Jm9jSH;R*dUo^4~!ZLMD5nndthckLszDg%$Oh(^2|
zzDFKv_V^J^{TSMjD>Azdse;Y&ccrpOcE1o{RtC&<4wbbcN`1Lfsf>twa25Z^*cb*O
zVU2o+4Drj{(;Y-^%l~l{DfttFY?WKXwZ~=ErGJQo#)qa`&d0kCew#Tv+OY4Mo9g+l
zB)#tW2p*;^VjZI0rhb{fKw03|21QZ0l4$l8u)K3Kz5yywCq^fUO@mcO<UN2yBSD&P
z41Chm45Q-QSc<I*%9*v%K5zWJ;61^wfrHxSrmA$e&C|Z#+0&N6N}_}}{?2k%+11$`
z_1E(}T)k|A%w_UAWR@^nF=xUTHRlL&kMcmoMdAavAPW&&Uf3B&l)#CM)8c5G>wMJi
zOOODIam4K<&5mo0oi@Gk3F*;_t&dO(bm-1$zV`*%v~i)Gek~2P7TA(+YkR~az0Y%a
zdA8seGP==fdKJwJ<V6esA^a`r97mvy{T8$*5=b;*$FlW&L>p8DE|0_Wh!q`#^R)(P
znN>c_sRrsI*7(=CjCLFCIh9RRQ_UO?yQ`hS*Msw{qfC>u+iQ*E`;NI1qE?rGEx&(U
zr&3jlu3BCC#rcT~29H`Czn!uz6gJQ~PM8l?j}0xhU?7_@_eV7VB=kNep!lagL5yp}
z6uwP2sARU@zOH8jPem8auJykw1ef_zGHm`<nwE2GXt!4Pwqo@#l{gR3jqs#opVn5K
zjUpha-wCH^Onc0#MbbQ2fpg_H$AU2PiWTM~@c=QNH0dz7rpt2Riy87V_=-3~kXP?%
zgmO7SVw%D%2Me0x5Rx!%2t&3auA;VB^n<4cg=ugHcOZ2x7rP{;ASV9H>9$>BvT(ot
zh!d|XCnFqnfs78d1`Q`SQ2v$^#SN^HTn6o%sWV?f0<akCaAWTP_OM2lqQKiZoE|T$
zTtXNKX?Zk!Z~0!GIs-J{z~rnalY?xw56QDB!6KVnzXhN6aYK)2c9gqhSHBMrRh&fU
zkbc<^p4s`#5KckgB0iArQoySuU(j|c0N$X<Bs7vG0fRBM9WG`Q$_^fVrbc-)qx)I=
zvot<erFF*Pjz_(jO{-XL(pzz+_MHAM_U5@|)qYw8FO*B3O?g_5NP`UzH^89)6x?QK
zK+^=ntAWYlV%*_zi6Kq;@-nH#Qtw$zGEl%5(_~28faxb**xMYDx|Vw9u~|1pEmSNR
zdbfNqM>|9=!_CZ9cag#$=Hm&8jP!2w7aDOH^cLU6Pw5%L?wJ(L=^=OA=#Yr1v&cg`
z(~n>A(8vO--z*z%H1m?%95Pu<M4#J7YGVB}L}ZxXG|qf$_wA@CbN?sQRK5H+>Z5KZ
zqlV7ihw{6hp8kTQm))m*Is&=~RkriW`%Wewbx!Q_P~PGbdU0Fn+kG+@j|)m|`7Zqs
z{U|rx?o>wFMgpMyr-AZmi3w2#XcxfRk_c}O=;bw>#vkE#lDC4o5X?0LEICnCcgpP$
z?1J=hSbUw^n3zBlUjVG2u<~#|$!tv=(@YfabV;6a=nKj#ukKy0HEDU<<#RDfvAH(C
zDMh1N9Xe6UL+0j3Q0-kK!YhbT>_yBX(nL2Mcn4<PG<l_UP>u?rVLx94w}X`m-qiiU
zJqZqt$GL&U_1<mag!1Cf`+BrneBH-w3fU^EZ<(^`^btfOU$bwy^X`x%H`P^ox~9x8
zRW9v}q-S=xHg?GIMuED90rr=sM^N!%B;O+==F_}#`Om6#$VbX5>?;o(_!fqHgjWjR
z<wulRq78M9S#YI6D``Iy*%nhF0huPgy^=6KFJZyjWG&`7+@f%|IUTdpFLG~3!O*Iw
zN(FPd<-W6cz=JI1Z}IPjUQfY2jC?c*33+)-V98{+4F;1!q%MDB*$rUWD!d%TWzu~j
zSZHxSB802iUtu?_%8u!W8{j*J0!eYp(}Ax+FRjIiuiV4eur#<+oZe)2v^IbG+>G@r
zSbT~YV*at2T633$V1>~st2F9}6Csv%6-`R-`B^nRF`P32^w5cbe%=L^#he_=;W$9$
z9OqiR=hc%nJh+xXPVo@df<a7hV4L@m4gKM&{rZGWGkguEJ72W4nk9)w%)QrNhsb#V
z1WuG)J(*nHeKA@4=qLHWzLlq`wUtBM3S`<UFaLWtmFoPuo2OStC`s^M%jP}A>9d*|
zkfjSB5JLR!RJ>d-*%WI)_r1+kWm!8jJ>R`S^W~|g7eHr_W=3WSrxwoCz;C|sgx!;E
zRQ8`P35^noUt60Txumh}H1O$LX9_!LhEE6|B?epjtU*up-Un~ab{Y1DB?$vT0_5?)
zNLq75K^>21$?W2I+Z|AP-C1xn-FIuyzU%HfxGK%zSlgZN^hY0^&pBbhan$5gCZ*+d
zs^`XO4*h7XsyEhKtBKEAOhiO3^t;DJ)K-38+BR<R|K}gaNK7d<gVv5O$?sNZYZR48
zf^TOo#CZb~Ao3zFdk>H^j@g0gvMF*UeaMg)2a{KlT!kbLZC*~+4^J(yCYQ1qz<Vf&
zJ`2>3-fzOucdYGCp;O*4pR>andv$AGm^^6lf=XZw8oNI-pZS-b_vOEH{uq3{KS~P$
zD=m&|xKwt(O{(ydPAJ;gQHO5vkRRUseb7$Q>66CPfEHZM7k@BVDa73-(%;dWch~G_
zlaG;c$-I5yb|<Ljhp+6zFT9=NU+k@()quVsR$9!3a1Me2;}fz5R<w;G%2&X;HIQWh
z-|-RWCi0$ct~#B!nGh2KL^Tb?=6R1NZAVU5$|nCn3>+EKo?{N`9gV0Ac6ULxgm{Go
zV_@Ii#oA20p9H6zd+swxM&EB6{}mvk<fKq(ARYH0SjqNa#=&Q%9>x_1we0%O^ImwE
zYxLwF=*?!>?|4G6Wr**f2lT{*oDoK7wO@U2s^gYWc(>WU(TlmDnF5tCe%RubXZu1~
z;^J7|freJ;J08aIXP;!j(!dh6%eR{-O8gyWbehOCLR=fJ3!1_sa0vG-Kpc}0n?CI4
zDxAnz5T0eL$S_L^W#a-%htJgYnVO7~B>kdX5tSXe0K&GSF2%X~3AGP<XCj_H_tT{)
zFrfRoM1ra16Cb0LgSE}$niKE2`e&{jNg(N<oMN<`B*gC3_o_N8I$e!-tf!@qg(<<W
zKhc7Vr+6q$HJ!Pu`<b~b(kf<~Ay;K@rktqb*~BcXu&Y3kx#)#2=b51lBhSR7fiy5{
zgX7)>t=g?*L=Y6%C%YBOdPGq$CJajViY)Gn-l{yy?i53OrvZcOkjrFq@HT6Jkc`k^
zP*$}~HNcc28}vj9vR;4`Zo1%*z++Ar{sXbB>ITBkE&;L0RE|Yxpj7OnNt4JsftyPn
zz8+t3@^p&OY@zR!9<^4YH|b1VaIPQ!K$K>pb(5rjS`7Pf={%KyjIB6wrm(3~%8+=3
z{v!PzYgNVMj?+0iqsAih?QnHyLYo&a$J$E9-|O`^e`@2ww>b%+`3}V$f?X|bUpvZF
zjK<(9AA*I^566Dt<fPkmGaZow{UkG?yA9OucaLNkI-}E`Dp}_peCFen{iEV&HI_IG
zI|BrA;1}>6h_b0f1ZH8VtpP6l_AAae*r3raW-EgbkEk@5my9}EvZCNwk&km=K1e5F
zN1Gbq3TZzVY@!V7^mC_&?l^V1SQMnb-Rd*)p(4a{e|`(j`UZ3O_Tkl-Gp9Bm{!*5j
zI-w-iw3A_es$$y(_|Xz5EI+a3)XtgwI!FH}IqK)WS`|88H*8Gtc<4a?0&NYRlDYWy
z(5nQ@!B71ry5n4acA=4dv9o@o1L=Owou+Er$9MbaR>6169NltrtiMY@_`OhhZOUZ{
zKui5*IU<f&zQUH68w4|901>QWCd|u-m(eAL2n}fl&9Ke>k)MYM_rlz=d${Kxp@uT!
zVWx6#X4(UbOA?}$eravS76;;KN9bDd?tx>m-uFIXt!GUglUltD(}fxrUp=5}h2hE$
zW!+75*WVT8uK3i|<-wWggQmUkcQ&o2-%4NbEnwpTBUgzD&$h{@N=Jz+HP8>6BJPi?
zxrsKvH@@&-Td}j9q`iNNW=e*u5@7uFIyy>zWbxN2$>oIvvLNpzSVxYyO)IsVukz*i
z;Jb)B_!>ajIBD+VD=vl!OXT{><}eM~RHOiE!4G2*FeCR8cR0bevd2_Y{8n18=1YI4
z6$6DV{qmuldB&^(G{8<;?K2jAKje$v*jA>2sLyk_sQUQlQ^%i80P^<Z+bN0<&oz%9
z8mO}kJXl(MKV=VnxVig<w*~FI*Osq$%Th^c7j^k^p9~!mRa=$JpG`iiYrlJ7%0(;a
zu;a(W@7>396daiYxY9#;*4y5292I0#HF`^*qCPney$DBu>1ug^dYtzT7c4jL!O~?<
z0csrOAuv)lC6-Z}k%Ph#J6&<6J*KE*#UFu$B5oiRuKc5BCGPG$z2b|1n3{N(xO8Nh
zzs|B@hsB0yx2h;#JhUrQq@5-_;i)pk4Kbx2a<_TPDr>aUExd7mytGDMXnUt*Y@?~Z
zzqp-@gM=Y9Y^3^IR=YBGN-ptL%fP~No-QLG_0FEui=)Sr=xXtKH*ylL5{6`c6#&~D
zSrU@A6)6fCe#Ymr6c^vLr{O&~VK|ewKs9G4_{VenJ?{7ciX_Fa0XBb}W6IU70_zM{
zn(c9LCbiiH)(Vw|1u$6bLb~!%58I((hQuvxt=C;kB-wB6!d0(kQ_?a<Cewv;!mbC(
zy`xY1I;b&dQj32w;m(cRI@RXYy3#Y9+sm{(FSrRjbs(|>l>!~D>_6&m?R^?Ka6tWT
zv)7c>&Y4e7H2z!!7_hwbs~E_n)c9Q6Jy`Rq@CBt|o#u8}llSzcUkVRhX5OEUa@@`k
z+H!CwD<rx3Y_URFzK!FPv1m&MO$cWL5IGmQMxgNu#5#jz?62TZoG1Y0940jKfOjkb
zOCa$o!H<||OiF<7oynAD=EYRlB|IJ^R|mfS5uirt{W%xt6~zgbeR^#ot7oDd;MPK)
zOejgFVe{|PZRI}$ckdZi@!UR^4z0Q)`tHZ3h-zgewt64<{wS^K3we)g#)0$c=cgjy
zR?M^#&OK<Dyg-zl;49IwN%s!P@3(HUhIi<0yYK`|btsLOXdW(%Y4R$#@`YHHcu+f}
z7d%AioP7U$TO~a>9GKu7#*+BkbUAV}G-WXA@L*DIBD_da{60b%3G^4B*qar0_le>G
z7%<rc*qvvFS1^W87gZ<+MJqP5Wz#zER3yAp$?-;udp{C5X#S&JoBmU)0YJ7r!A59+
z$A9WQ7f-SA`&l|o2aRM=_A+m=pIm0-Lr1J!u+&D!jO~G2jO_D`{4+>8yBNR73N6^X
z4HaddJC8Pvy;qlMF+KL&d$#5|*~2z8*wE^|)c|lX4E-tPpk#4Oq2~F#Eu%-A{Y}ZY
znWXWBCObea37qh-TMMFsHh-K2Wh^9uA$y=*^H;kfu0!u!ozU3zWr~0wU;QhlPLeLB
zGx{-<A`AErb@#U-6u!;KrTxsh9#V{!JCeY29M$=38<Kp544Y6Ax;>UD`RP3d#@hQp
z>Ri+JrM%}?B%3Dnna|R$#~v-3i3*U_2~$5erfQX`@?_76JA0?Q;!|~?2Rlj^w(G)m
zn^_p?Nh7w&&4c5r2Ul}WUp!=Ad@JW(Q*VQp#({$_MS5Plv;qoj>n%T3p!AK4+dA=@
z+(W!K_^n)B-c7zC76~T6b1`@rz8@@BC2z%v15L1aQ_EcNqNF$_k#ih-WE@?Lq%SlD
znpyK3n3eU+<x3)s#!cGG^Q}2b;GY2POYIC%Zp(Xog{w-OB&#ynu%=AuyyUA+j?GGD
zkBat7l}PL7BV*sO?jM-EUTjRe(CYOIj$sdN?a5QH$NC#&zdEqGT5_Rz^{Cs2>-~xk
zfRyVL*(*jmmM=_g_ory;#3+GLtNOueyoY`AtC-?cH(oMnLEV@_DHyTXAN`1F&_vro
z0spQ?<G~}&As75tqzYUgjGH?-`+-7+UX1~Gucgw#(sXC0HX{Xbr@HD4j^@)lB|QgS
zJueKPYdrG}hL_$XYo4lxdnLxyrwwyqJH|`D9AUnu$oA1ol>gNIcK80<>pRiRQ8%SR
ziNsH=RS%qfPJ9zs9w&2<KGT&{R=j`mWl?r@K?v`G<=xMQ&drgg`gVv;-6EnPJ-`Wb
z(1;Jeo}w!H>>_LF?avaZr2XM18vQv&A>HxkCZ7(aY8f5-#ou<DMI7&JT)0KpUMImc
zXwd*OiQ}00!<>^ibzZt2EG`f&2G)j)Yw=ZQ<Y>cWot{0_9ffEoSNPKiRJI-+mr&bR
zTa~O>i@xqW$yNRHnmY~AQ6|2pp{`wn4&U_!TPXQd<CA2^L7(%}Jfx7**_D2ku)-5z
zy_inh^gBIwvXdg3KTqj@S_~)?N*+%UI5KX#=hORZv6shk7lAAK>hrA7-g;W#w*SH2
zd$u*Tz5Svr%Tk&sy$Deeks3h|1td!m5D=o$YZfYCh!BwuA+Z5cvy`T^h%~8@5|A1p
zlqCpAmm(oSI!HnZ6H?sM|9(!}U*KH(oaYTM;3B!^7;}tqk6*iO3k0lIWZ*fHS$EI!
z(7aJX6(Sx4Vc<y!#*LnAC@Tl_ET88XFcE8;4C}6rmSfzvoM5sjv7C2m+yzw^4ohm1
zDW68NoYP}YHV+Q9H=ti|E}>30m<)YilKO`tRC{o2TT^J(P)hRQPW-XbHdoz$=0l-J
z&hNce_ZFI?j@!<q4(G^9Y^(+yw#!zxEglWE_~>d&ll^*=$Zuis4yI3U5$|A(hR|x3
zm=|zab3lc`XOFlxZ(#0?ty78w@@AKZT3?o`$E?1k82niDv%vg0Qy;bQO~}<ncX1#O
zysRAMmXaTopYK4_5W1*OsQZ4K#$N2{eL_T2kNo2E#w)<u))21D-lC|jb<t2V-64r%
z;(0f$c!j)_QQl05)`=ZstE%aEA9h#6*K$S`<x)cLwoVDU9BOO21g?nAOKw=j-T-Um
z9vo?rwz2oR;iIdhUAl*lU6G|QyFoigvk8Zp-z&aydr$VF;ZXY#75Z{$g<^lz4SW=H
ztLjD_l*S3@Q6251h{%3x>XLsEb!nKm-fJdoVL5*GLFVm+-9E&m8jHk$uTq%tEFYLe
zayzUB_XGq3-tq*&BP9aRV`Yxk^y>RM0&sf3w-wn#9r8FU+ep>Tt_hLnr-uU@W6#(l
zbqTB7t81FNXDiM$?7d(>56&NVdC7GCJS`Pf$&<a?WZA{Y78p^ya#uU`c9Qa0ik+{0
zQTiRNl2pe|sD)~|KDIj{Pnxs!ksQZxJ)ik-w)ZmmDDC3Tp-&ezl}atLmdiBn&EAgo
zeo<7Q`g-}Ir+p^c?$%(jo_=Lk!JZz2z>)_k&C47Qz<U-SO|Hdvp<`S4GBj+gxbKYQ
zc|$qSW}p-``>`UhQ{Oudd)zHDt)t~QP}PMv_8l&qn|{4{Fm|Z$_6zL5Zg2oyM1*<4
zEMsn$_y^;s%^Oo&A4Vs#%~3YYaAQZ7+}t|<&q7JHp~Q{LG#M*ZMoIHK<mX4&s1$~E
z5M{T;EwLxG=kgbZXrcw?N;*?hJ1on;+x8b<NPN%S>RX2Nd;6vWX_%+J@0D?rPTb2D
z81QmdLyk`EGUe8S{weZgI_osBE7G|xK8fvzh}I-ZwI}o1CJ=2sZo%KNQXun03Adv@
z!Ppg{^mV)@J4<JqT`cQA);DeH`kKnnTP(OljqVS+8}16Of3&(oz-x_g&xtm8>_*85
zqmn65>u;z-Che}=DK$RVI+E*FJOis<w0nN{&-b@e-1MN`=Y_hY%yj!9GE8qdhJAQ-
z*|kudR)M7`a3;-3wuh~CHBB~!;n-kTtSp2c^BGJ|86w(QSwV&oF`BaLlnLRX6?>!8
z5!rH<AJNB<{>Fd4A=ZqZyFM|RElld2Yr3FcjIMJwL5GD11#fn~bnScMiTiQG)>g~$
zwff~7r=m~Q*h^NYlzOE2m`A#o6-b*8=b^pz&R(^?<=d%IgR}DZu@IB1>@1zGs*}$Y
zf0d}e)&`xlN$|Y*-i~Z2?yZw|Iwe1~H)G)fh-~ctHS}My3<yuq7)QjlYQttokPlrP
zi5@n@p#>0Rid}s+qrA31GH+aNDUdZ((;Gq2|8f4B%x%l>X0(_W4-Bnn5h@BYx|iX!
z=v?%HMD^>X18{25*&ydqas&19TIBlZK&-p=?WJm7^SWEzIxd7Q%z!2}$uSLDTcm*)
z#%BATa-yN|td$g;35f!+pk~ua`>#z`a+lMVf{K>I-Sh5mxO{h>YCY9(J@KCq#pf^G
z)c(u}j(FGG>|#GyBdlfvmb(@d(*YefqfPr!-9-BhDtvIO9BN&cws~`yq{gm4Nvix%
zSrd&a?P+{-r>?dx&Z+RFqFMM~IDIO^5(lUf)_%)gHNb@&&zqD*Pymde9!JcZ6<%W`
z2OwwFU<VMB0J$^gQq!<bB!m*8+?g)R22(AjPgQ?y!p;7xeuu%4l5CN0VdOh_jsN^Q
zg}Qk5svg;pv|%~agT5Rgnm-wtzCB0I+cvUez&YhyW(e;~Jct^Pcr!-JfAKXEnb5v_
zpxLs2Wf#7phZyu2+tNT?tv~Iu;%uFl-*@H2iy*m6WpgJgq>m=+o%j*l5s(3Cg>&R4
zL2wk5=RFO@4v6w5sa1rvF3{B^MTe~gvDL9(L5ndFMpGT*pz>Gx8NJSs12y{AnQsBY
z)u)@+7*sq)g{b?T?bs9W2QxaB^*K%6%*u4BR7KN4a`;|TPD=}x9QiWq4hbH}g{%Ou
zmVbFEFuDQ`P=s=&LB^P)!c+alw;Ad9+p%$8?bT(nSOYg2WE((i!EBYwtfrgAg4G;I
z3UUsBat&NeZTL<bBJL$e3m}w+c6GY**Ag6uJja@pKvR-10$6Cj4Lq_R-I6=}6IP>B
zYFW@Ulrwti<*Rwg)5|*bM6aI}<$J-KyD0wxi3s!<ahn?q%M=+8VA-O9iwK?o6r93+
z0G=Jf0mai1?904Ps_YNIhEc?FWf0=ln>6w!kco7H{9?F(TZibs6Gzf?$T7+8p_#S=
z<*SA+^mXwSsVc}ZWUc-Udvr~~YOaJt843N9j7uX&zOa1L>_!|ySZR_khYa)Z7zuFT
zk>J1^VY{&k!@QG@*bb2JPtNBUe%%(4SaH_|vfuSGwYJ=pDbAR^!eSzI873YCk?7+4
z@S)~oQ$y3qeP-fG!NqD$`l+XR%0yp1(8Rm6Fw(tyrvXbIr9$5TjUeq4wbI}aX9Q9V
ztrmvxx03}qQFO#azbR8P1}V|tY=V5Zl5>1?+e&rRz;Q&8lthI$)I}TIA5eU9^xBKK
zT%Q#*<f=#YwmuO!o4}aFwGI*(<|>*>Nr&eE;Rs*3?lzr>_;~7swe$(o2Y;p^vri>y
zZ5lMZ|NQsa7>4)qFFqwMj<WwZDNGo2SZija+XFjnS>6cYz}8{VgmM()z|C&a#=sa`
zN-TcN6*@6yf``xTL@3_(wg3556zdu}<8ZPnzUCcU$7Rf<adK~Hla2oY@<?D={4@}J
zC>1gq`tA1e0_!n1)kp!f6TRp0V{S5wDC>!OMkkme_^oxx*U)Vg@hBi@H?kE8>6oy}
z&dzFqG^e+*v?)bbtEK@1huYNXjqcUjks@7<2{?KrC}O2_Wpv&@4&`glg%MX8VHj|w
z41g1Mk1v`1Cr69#kvY?>!}X749KA)}h@9%Vrp)<Lah=71|DMqxUJrp`iGO;5aI7f|
z{HJdW>ZcV0h*W<e$QPntU<EMd%>XDv2%`!1I&FR5k4VGGgjQ(C{^GM}7}j;V-H{A$
zeCa3abb#?fhQEHXDDncCqfMS(oAb|4>sreGtN#-exHJXw2nW2mg%A0=UhobkKgkjS
z+*<a_7(F{Jv`6rF9stJjcx2+&Hyr5PE+H3mZdk^?BmB-V;QM?aRvpLaBv;=-CqAnH
zT8@UAsyIA)rDvvU=yyIf$n&DAk214|1K+&s0=<U)6C7kq+?+QQQ1s@$x{Uk9XN{0w
zaRlwu#En={V0MGkzw-2h4(tUriNKHX1XoZ8I0UP_A@YZvHGU?UZbqSg8)7Li?2;<)
zGK@cE&=_0PqiA2TPvKrgC9gG4Gz=*ZgEJ44b9G<N(HagccL%u*MtM@y+fWR$$_HJd
zd==Z5buV=)hfCI5q88Mi2MWBaI5>^<1<z>~ejV2a1x}zjqEa(i!J?rk)(OCpF1Mz2
z*K-uBB61Yt*phSI$g`md@uFeu#n$*4A;aF!9zyr0O3n(1>Di;#bQ(1@c2JYV@4*i0
z4)C!(ULyenI2mYiEKfSLhbL$WK2Zr1(&~aZ;)FTfJgiZUm3Ik+Sr2XD`HP|g;qfg>
zUv)l%M(?EytPIbbXOA*mT$gSkSzjmQRB~U5f19aIMSm7t9~=FS>5!jWCfkgV7ao$?
zmEb6icq+j;^&pS-go7Fahq1O&ooB`q!*zqcks31hjb;=GmM+W${YSfqW6gVmt}PgG
z4wl;=i<2OG^y6XTh9+!2jx*EY6Fwd%5rjKzMW>4Mz9{G@9A~E0D?eZJt(jz&qud3C
z*VbpNkB+1Cy-JHLL&Rm{Ccc}LBHvQPTsvOfj$1G<h(Ms1d1>pYcU$4eB{GeRJp_`Z
zzt6Nkt8uNGE!wTcE3m_cD$GMHYan5uH-NS-iIHV?HiqQhZ<rqRh0Zbb5}}4y3NkNx
z8_W%H^de}NrnLtqe8M9R&&AC;qarNF_BiX4CH~feLrm`79cmAp^aIE6?O(gazPZw(
z%xxsk<Pb<w?cko3q(25yOjpNR75IU=5+A(=R#C*;RytlD5V2?Uj>YOKe;nR!mhG}-
z91rh$Hb1(K)-9D+b8H&$^DC$xe4toYGT^>Cn)Mx~JXDw&xOld%Bz%0Ahf8<szX-5@
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

literal 500724
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%0A$#eeo2;60Nq7+|_;
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%0A9~TU*&TM<4{Vbq1GR
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
DDzbr*

diff --git a/docs/reference/transform/images/ecommerce-pivot2.jpg b/docs/reference/transform/images/ecommerce-pivot2.jpg
index 9af5a3c46b74003ca256cde2f2487da9c13cdc10..7c27694b55592a6a29e0bd1ea5f587cd4ecfcd20 100644
GIT binary patch
literal 493958
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%0Dw<ogEX!CT6+s?p{oqjm;O0x%(
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

literal 571857
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%0A=w;O{_&KjA*pH%MQC_hV}#I#FiO
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
K3X}ruv3~=TP%M}L

diff --git a/docs/reference/transform/images/manage-transforms.jpg b/docs/reference/transform/images/manage-transforms.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..86fe7a15512acbcaf748aeccbf2520eec7b2edc8
GIT binary patch
literal 196675
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
I_}Ah80r`n(djJ3c

literal 0
HcmV?d00001

diff --git a/docs/reference/transform/images/ml-dataframepivot.jpg b/docs/reference/transform/images/ml-dataframepivot.jpg
deleted file mode 100644
index c0c7946cf4441936837823697af8ae4ccfa876e7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 93753
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

diff --git a/docs/reference/transform/images/pivot-preview.jpg b/docs/reference/transform/images/pivot-preview.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..67b2c79326faad29a9e7d46c965b10064174f48c
GIT binary patch
literal 140881
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
JX7c>M2>==RM!f(4

literal 0
HcmV?d00001

diff --git a/docs/reference/transform/overview.asciidoc b/docs/reference/transform/overview.asciidoc
index 07c17f778abaf..d35f0afbd39a1 100644
--- a/docs/reference/transform/overview.asciidoc
+++ b/docs/reference/transform/overview.asciidoc
@@ -59,7 +59,7 @@ quantity. The result is an entity-centric index that shows the number of sold
 items in every product category in the last year.
 
 [role="screenshot"]
-image::images/ml-dataframepivot.jpg["Example of a data frame pivot in {kib}"]
+image::images/pivot-preview.jpg["Example of a {transform} pivot in {kib}"]
 
 IMPORTANT: The {transform} leaves your source index intact. It
 creates a new index that is dedicated to the transformed data.

From 87919385cedce5b7e1c198d551447cbb6be03fef Mon Sep 17 00:00:00 2001
From: Julie Tibshirani <julie.tibshirani@elastic.co>
Date: Thu, 12 Dec 2019 11:34:24 -0800
Subject: [PATCH 187/686] Reenable the 'continue scroll' cluster upgrade test.

---
 .../resources/rest-api-spec/test/upgraded_cluster/10_basic.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/10_basic.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/10_basic.yml
index ce30d31a993c1..0c5deab19068d 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/10_basic.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/10_basic.yml
@@ -1,8 +1,5 @@
 ---
 "Continue scroll after upgrade":
-  - skip:
-      version: "all"
-      reason: "AwaitsFix https://github.com/elastic/elasticsearch/issues/46529"
   - do:
       get:
         index: scroll_index

From 156bfdb9f74e363a7d36b5bae473d77355215493 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 12 Dec 2019 15:41:20 -0500
Subject: [PATCH 188/686] [DOCS] Document JVM node stats (#49500)

* [DOCS] Document JVM node stats

Documents the `jvm` parameters returned by the `_nodes/stats` API.

Co-Authored-By: James Baiera <james.baiera@gmail.com>
---
 docs/reference/cluster/nodes-stats.asciidoc | 149 +++++++++++++++++++-
 1 file changed, 148 insertions(+), 1 deletion(-)

diff --git a/docs/reference/cluster/nodes-stats.asciidoc b/docs/reference/cluster/nodes-stats.asciidoc
index 145315ac02917..d607c6430d789 100644
--- a/docs/reference/cluster/nodes-stats.asciidoc
+++ b/docs/reference/cluster/nodes-stats.asciidoc
@@ -721,7 +721,6 @@ NOTE: For the cgroup stats to be visible, cgroups must be compiled into the
 kernel, the `cpu` and `cpuacct` cgroup subsystems must be configured and stats 
 must be readable from `/sys/fs/cgroup/cpu` and `/sys/fs/cgroup/cpuacct`.
 
-
 [[cluster-nodes-stats-api-response-body-process]]
 ===== `process` section
 
@@ -747,6 +746,154 @@ must be readable from `/sys/fs/cgroup/cpu` and `/sys/fs/cgroup/cpuacct`.
     Size in bytes of virtual memory that is guaranteed to be available to the 
     running process.
 
+[[cluster-nodes-stats-api-response-body-jvm]]
+===== `jvm` section
+
+`jvm.timestamp`::
+(integer)
+Last time JVM statistics were refreshed.
+
+`jvm.uptime_in_millis`::
+(integer)
+JVM uptime in milliseconds.
+
+`jvm.mem.heap_used_in_bytes`::
+(integer)
+Memory, in bytes, currently in use by the heap.
+
+`jvm.mem.heap_used_percent`::
+(integer)
+Percentage of memory currently in use by the heap.
+
+`jvm.mem.heap_committed_in_bytes`::
+(integer)
+Amount of memory, in bytes, available for use by the heap.
+
+`jvm.mem.heap_max_in_bytes`::
+(integer)
+Maximum amount of memory, in bytes, available for use by the heap.
+
+`jvm.mem.non_heap_used_in_bytes`::
+(integer)
+Non-heap memory used, in bytes.
+
+`jvm.mem.non_heap_committed_in_bytes`::
+(integer)
+Amount of non-heap memory available, in bytes.
+
+`jvm.mem.pools.young.used_in_bytes`::
+(integer)
+Memory, in bytes, used by the young generation heap.
+
+`jvm.mem.pools.young.max_in_bytes`::
+(integer)
+Maximum amount of memory, in bytes, available for use by the young generation
+heap.
+
+`jvm.mem.pools.young.peak_used_in_bytes`::
+(integer)
+Largest amount of memory, in bytes, historically used by the young generation
+heap.
+
+`jvm.mem.pools.young.peak_max_in_bytes`::
+(integer)
+Largest amount of memory, in bytes, historically used by the young generation
+heap.
+
+`jvm.mem.pools.survivor.used_in_bytes`::
+(integer)
+Memory, in bytes, used by the survivor space.
+
+`jvm.mem.pools.survivor.max_in_bytes`::
+(integer)
+Maximum amount of memory, in bytes, available for use by the survivor space.
+
+`jvm.mem.pools.survivor.peak_used_in_bytes`::
+(integer)
+Largest amount of memory, in bytes, historically used by the survivor space.
+
+`jvm.mem.pools.survivor.peak_max_in_bytes`::
+(integer)
+Largest amount of memory, in bytes, historically used by the survivor space.
+
+`jvm.mem.pools.old.used_in_bytes`::
+(integer)
+Memory, in bytes, used by the old generation heap.
+
+`jvm.mem.pools.old.max_in_bytes`::
+(integer)
+Maximum amount of memory, in bytes, available for use by the old generation
+heap.
+
+`jvm.mem.pools.old.peak_used_in_bytes`::
+(integer)
+Largest amount of memory, in bytes, historically used by the old generation
+heap.
+
+`jvm.mem.pools.old.peak_max_in_bytes`::
+(integer)
+Highest memory limit, in bytes, historically available for use by the old
+generation heap.
+
+`jvm.threads.count`::
+(integer)
+Number of active threads in use by JVM.
+
+`jvm.threads.peak_count`::
+(integer)
+Highest number of threads used by JVM.
+
+`jvm.gc.collectors.young.collection_count`::
+(integer)
+Number of JVM garbage collectors that collect young generation objects.
+
+`jvm.gc.collectors.young.collection_time_in_millis`::
+(integer)
+Total time in milliseconds spent by JVM collecting young generation objects.
+
+`jvm.gc.collectors.old.collection_count`::
+(integer)
+Number of JVM garbage collectors that collect old generation objects.
+
+`jvm.gc.collectors.old.collection_time_in_millis`::
+(integer)
+Total time in milliseconds spent by JVM collecting old generation objects.
+
+`jvm.buffer_pools.mapped.count`::
+(integer)
+Number of mapped buffer pools.
+
+`jvm.buffer_pools.mapped.used_in_bytes`::
+(integer)
+Size, in bytes, of mapped buffer pools.
+
+`jvm.buffer_pools.mapped.total_capacity_in_bytes`::
+(integer)
+Total capacity, in bytes, of mapped buffer pools.
+
+`jvm.buffer_pools.direct.count`::
+(integer)
+Number of direct buffer pools.
+
+`jvm.buffer_pools.direct.used_in_bytes`::
+(integer)
+Size, in bytes, of direct buffer pools.
+
+`jvm.buffer_pools.direct.total_capacity_in_bytes`::
+(integer)
+Total capacity, in bytes, of direct buffer pools.
+
+`jvm.classes.current_loaded_count`::
+(integer)
+Number of buffer pool classes currently loaded by JVM.
+
+`jvm.classes.total_loaded_count`::
+(integer)
+Total number of buffer pool classes loaded since the JVM started.
+
+`jvm.classes.total_unloaded_count`::
+(integer)
+Total number of buffer pool classes unloaded since the JVM started.
 
 [[cluster-nodes-stats-api-response-body-ingest]]
 ===== `ingest` section

From 244a8e71b6eb305ec2b27f29b704be4bc5c5ee68 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Thu, 12 Dec 2019 14:52:36 -0800
Subject: [PATCH 189/686] Don't pass OPENSHIFT_IP env variable when building
 old BWC branches (#50153)

This commit tweaks the workaround introduced in #49211 to support
Gradle 6.0. In the workaround, we specifically override the address
the Gradle daemon binds to by passing the desired address via the
OPENSHIFT_IP environment variable. This works fine for builds using
Gradle 6.0, but for older Gradle versions this causes issues with
inter-daemon communication, specifically when we build BWC branches
not on Gradle 6.0. The fix here is to strip that environment variable
out when building the target BWC branch if that branch is on an
older Gradle version.

This is all temporary and will be removed when this bug fix is released
in Gradle 6.1.

Closes #50025
---
 distribution/bwc/build.gradle | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/distribution/bwc/build.gradle b/distribution/bwc/build.gradle
index e96ee75ae4342..dca0d18ac4aee 100644
--- a/distribution/bwc/build.gradle
+++ b/distribution/bwc/build.gradle
@@ -23,6 +23,7 @@ import org.elasticsearch.gradle.Version
 import org.elasticsearch.gradle.BwcVersions
 import org.elasticsearch.gradle.info.BuildParams
 import org.elasticsearch.gradle.info.GlobalBuildInfoPlugin
+import org.gradle.util.GradleVersion
 
 import java.nio.charset.StandardCharsets
 
@@ -161,6 +162,12 @@ bwcVersions.forPreviousUnreleased { BwcVersions.UnreleasedVersionInfo unreleased
         spoolOutput = true
         workingDir = checkoutDir
         doFirst {
+          // TODO: Remove this once we've updated to Gradle 6.1
+          // Workaround for https://github.com/gradle/gradle/issues/11426
+          if (GradleVersion.version(file("${ checkoutDir}/buildSrc/src/main/resources/minimumGradleVersion").text) != GradleVersion.current()) {
+            environment = environment.findAll { key, val -> key != 'OPENSHIFT_IP' }
+          }
+
           // Execution time so that the checkouts are available
           List<String> lines = file("${checkoutDir}/.ci/java-versions.properties").readLines()
           environment(

From 33af9c58e14d44c3cb45a469c6d9c7b07de251a6 Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Thu, 12 Dec 2019 19:17:59 -0500
Subject: [PATCH 190/686] Validate exporter type is HTTP for HTTP exporter
 (#49992)

Today the HTTP exporter settings without the exporter type having been
configured to HTTP. When it is time to initialize the exporter, we can
blow up. Since this initialization happens on the cluster state applier
thread, it is quite problematic that we do not reject settings updates
where the type is not configured to HTTP, but there are HTTP exporter
settings configured. This commit addresses this by validating that the
exporter type is not only set, but is set to HTTP.
---
 .../exporter/http/HttpExporter.java           | 74 +++++++++++++------
 .../exporter/http/HttpExporterSslIT.java      |  2 +
 .../exporter/http/HttpExporterTests.java      | 13 ++--
 3 files changed, 59 insertions(+), 30 deletions(-)

diff --git a/x-pack/plugin/monitoring/src/main/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporter.java b/x-pack/plugin/monitoring/src/main/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporter.java
index dd9041ffd070c..a73cee446c280 100644
--- a/x-pack/plugin/monitoring/src/main/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporter.java
+++ b/x-pack/plugin/monitoring/src/main/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporter.java
@@ -78,6 +78,20 @@ public class HttpExporter extends Exporter {
 
     public static final String TYPE = "http";
 
+    private static Setting.AffixSettingDependency TYPE_DEPENDENCY = new Setting.AffixSettingDependency() {
+        @Override
+        public Setting.AffixSetting getSetting() {
+            return Exporter.TYPE_SETTING;
+        }
+
+        @Override
+        public void validate(final String key, final Object value, final Object dependency) {
+            if (TYPE.equals(dependency) == false) {
+                throw new SettingsException("[" + key + "] is set but type is [" + dependency + "]");
+            }
+        }
+    };
+
     /**
      * A string array representing the Elasticsearch node(s) to communicate with over HTTP(S).
      */
@@ -111,9 +125,6 @@ public void validate(final List<String> hosts, final Map<Setting<?>, Object> set
                                 } else {
                                     throw new SettingsException("host list for [" + key + "] is empty but type is [" + type + "]");
                                 }
-                            } else if ("http".equals(type) == false) {
-                                // the hosts can only be non-empty if the type is "http"
-                                throw new SettingsException("host list for [" + key + "] is set but type is [" + type + "]");
                             }
 
                             boolean httpHostFound = false;
@@ -129,7 +140,7 @@ public void validate(final List<String> hosts, final Map<Setting<?>, Object> set
                                     throw new SettingsException("[" + key + "] invalid host: [" + host + "]", e);
                                 }
 
-                                if ("http".equals(httpHost.getSchemeName())) {
+                                if (TYPE.equals(httpHost.getSchemeName())) {
                                     httpHostFound = true;
                                 } else {
                                     httpsHostFound = true;
@@ -152,26 +163,31 @@ public Iterator<Setting<?>> settings() {
 
                     },
                     Property.Dynamic,
-                    Property.NodeScope));
+                    Property.NodeScope),
+                TYPE_DEPENDENCY);
 
     /**
      * Master timeout associated with bulk requests.
      */
     public static final Setting.AffixSetting<TimeValue> BULK_TIMEOUT_SETTING =
             Setting.affixKeySetting("xpack.monitoring.exporters.","bulk.timeout",
-                    (key) -> Setting.timeSetting(key, TimeValue.MINUS_ONE, Property.Dynamic, Property.NodeScope));
+                    (key) -> Setting.timeSetting(key, TimeValue.MINUS_ONE, Property.Dynamic, Property.NodeScope), TYPE_DEPENDENCY);
     /**
      * Timeout used for initiating a connection.
      */
     public static final Setting.AffixSetting<TimeValue> CONNECTION_TIMEOUT_SETTING =
-            Setting.affixKeySetting("xpack.monitoring.exporters.","connection.timeout",
-                    (key) -> Setting.timeSetting(key, TimeValue.timeValueSeconds(6), Property.Dynamic, Property.NodeScope));
+            Setting.affixKeySetting(
+                "xpack.monitoring.exporters.",
+                "connection.timeout",
+                (key) -> Setting.timeSetting(key, TimeValue.timeValueSeconds(6), Property.Dynamic, Property.NodeScope), TYPE_DEPENDENCY);
     /**
      * Timeout used for reading from the connection.
      */
     public static final Setting.AffixSetting<TimeValue> CONNECTION_READ_TIMEOUT_SETTING =
-            Setting.affixKeySetting("xpack.monitoring.exporters.","connection.read_timeout",
-                    (key) -> Setting.timeSetting(key, TimeValue.timeValueSeconds(60), Property.Dynamic, Property.NodeScope));
+            Setting.affixKeySetting(
+                "xpack.monitoring.exporters.",
+                "connection.read_timeout",
+                (key) -> Setting.timeSetting(key, TimeValue.timeValueSeconds(60), Property.Dynamic, Property.NodeScope), TYPE_DEPENDENCY);
     /**
      * Username for basic auth.
      */
@@ -181,12 +197,12 @@ public Iterator<Setting<?>> settings() {
                         key,
                         new Setting.Validator<String>() {
                             @Override
-                            public void validate(String password) {
+                            public void validate(final String password) {
                                  // no username validation that is independent of other settings
                             }
 
                             @Override
-                            public void validate(String username, Map<Setting<?>, Object> settings) {
+                            public void validate(final String username, final Map<Setting<?>, Object> settings) {
                                 final String namespace =
                                     HttpExporter.AUTH_USERNAME_SETTING.getNamespace(
                                         HttpExporter.AUTH_USERNAME_SETTING.getConcreteSetting(key));
@@ -201,6 +217,11 @@ public void validate(String username, Map<Setting<?>, Object> settings) {
                                             "but [" + AUTH_PASSWORD_SETTING.getConcreteSettingForNamespace(namespace).getKey() + "] is " +
                                             "missing");
                                     }
+                                    final String type =
+                                        (String) settings.get(Exporter.TYPE_SETTING.getConcreteSettingForNamespace(namespace));
+                                    if ("http".equals(type) == false) {
+                                        throw new SettingsException("username for [" + key + "] is set but type is [" + type + "]");
+                                    }
                                 }
                             }
 
@@ -209,7 +230,9 @@ public Iterator<Setting<?>> settings() {
                                 final String namespace =
                                     HttpExporter.AUTH_USERNAME_SETTING.getNamespace(
                                         HttpExporter.AUTH_USERNAME_SETTING.getConcreteSetting(key));
+
                                 final List<Setting<?>> settings = List.of(
+                                    Exporter.TYPE_SETTING.getConcreteSettingForNamespace(namespace),
                                     HttpExporter.AUTH_PASSWORD_SETTING.getConcreteSettingForNamespace(namespace));
                                 return settings.iterator();
                             }
@@ -217,7 +240,8 @@ public Iterator<Setting<?>> settings() {
                         },
                         Property.Dynamic,
                         Property.NodeScope,
-                        Property.Filtered));
+                        Property.Filtered),
+                    TYPE_DEPENDENCY);
     /**
      * Password for basic auth.
      */
@@ -261,15 +285,19 @@ public Iterator<Setting<?>> settings() {
                         },
                         Property.Dynamic,
                         Property.NodeScope,
-                        Property.Filtered));
+                        Property.Filtered),
+                    TYPE_DEPENDENCY);
     /**
      * The SSL settings.
      *
      * @see SSLService
      */
     public static final Setting.AffixSetting<Settings> SSL_SETTING =
-            Setting.affixKeySetting("xpack.monitoring.exporters.","ssl",
-                    (key) -> Setting.groupSetting(key + ".", Property.Dynamic, Property.NodeScope, Property.Filtered));
+            Setting.affixKeySetting(
+                "xpack.monitoring.exporters.",
+                "ssl",
+                (key) -> Setting.groupSetting(key + ".", Property.Dynamic, Property.NodeScope, Property.Filtered),
+                TYPE_DEPENDENCY);
     /**
      * Proxy setting to allow users to send requests to a remote cluster that requires a proxy base path.
      */
@@ -288,13 +316,14 @@ public Iterator<Setting<?>> settings() {
                             }
                         },
                         Property.Dynamic,
-                        Property.NodeScope));
+                        Property.NodeScope),
+                    TYPE_DEPENDENCY);
     /**
      * A boolean setting to enable or disable sniffing for extra connections.
      */
     public static final Setting.AffixSetting<Boolean> SNIFF_ENABLED_SETTING =
             Setting.affixKeySetting("xpack.monitoring.exporters.","sniff.enabled",
-                    (key) -> Setting.boolSetting(key, false, Property.Dynamic, Property.NodeScope));
+                    (key) -> Setting.boolSetting(key, false, Property.Dynamic, Property.NodeScope), TYPE_DEPENDENCY);
     /**
      * A parent setting to header key/value pairs, whose names are user defined.
      */
@@ -316,7 +345,8 @@ public Iterator<Setting<?>> settings() {
                             }
                         },
                         Property.Dynamic,
-                        Property.NodeScope));
+                        Property.NodeScope),
+                    TYPE_DEPENDENCY);
     /**
      * Blacklist of headers that the user is not allowed to set.
      * <p>
@@ -328,19 +358,19 @@ public Iterator<Setting<?>> settings() {
      */
     public static final Setting.AffixSetting<TimeValue> TEMPLATE_CHECK_TIMEOUT_SETTING =
             Setting.affixKeySetting("xpack.monitoring.exporters.","index.template.master_timeout",
-                    (key) -> Setting.timeSetting(key, TimeValue.MINUS_ONE, Property.Dynamic, Property.NodeScope));
+                    (key) -> Setting.timeSetting(key, TimeValue.MINUS_ONE, Property.Dynamic, Property.NodeScope), TYPE_DEPENDENCY);
     /**
      * A boolean setting to enable or disable whether to create placeholders for the old templates.
      */
     public static final Setting.AffixSetting<Boolean> TEMPLATE_CREATE_LEGACY_VERSIONS_SETTING =
             Setting.affixKeySetting("xpack.monitoring.exporters.","index.template.create_legacy_templates",
-                    (key) -> Setting.boolSetting(key, true, Property.Dynamic, Property.NodeScope));
+                    (key) -> Setting.boolSetting(key, true, Property.Dynamic, Property.NodeScope), TYPE_DEPENDENCY);
     /**
      * ES level timeout used when checking and writing pipelines (used to speed up tests)
      */
     public static final Setting.AffixSetting<TimeValue> PIPELINE_CHECK_TIMEOUT_SETTING =
             Setting.affixKeySetting("xpack.monitoring.exporters.","index.pipeline.master_timeout",
-                    (key) -> Setting.timeSetting(key, TimeValue.MINUS_ONE, Property.Dynamic, Property.NodeScope));
+                    (key) -> Setting.timeSetting(key, TimeValue.MINUS_ONE, Property.Dynamic, Property.NodeScope), TYPE_DEPENDENCY);
 
     /**
      * Minimum supported version of the remote monitoring cluster (same major).
diff --git a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterSslIT.java b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterSslIT.java
index 3aa07a58a7666..fb0da753be3b5 100644
--- a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterSslIT.java
+++ b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterSslIT.java
@@ -177,6 +177,8 @@ private Exporter getExporter(String name) {
     private ActionFuture<ClusterUpdateSettingsResponse> setVerificationMode(String name, VerificationMode mode) {
         final ClusterUpdateSettingsRequest updateSettings = new ClusterUpdateSettingsRequest();
         final Settings settings = Settings.builder()
+            .put("xpack.monitoring.exporters." + name + ".type", HttpExporter.TYPE)
+            .put("xpack.monitoring.exporters." + name + ".host", "https://" + webServer.getHostName() + ":" + webServer.getPort())
             .put("xpack.monitoring.exporters." + name + ".ssl.verification_mode", mode.name())
             .build();
         updateSettings.transientSettings(settings);
diff --git a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterTests.java b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterTests.java
index bfa1e16d860b0..a50839ffbadc2 100644
--- a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterTests.java
+++ b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterTests.java
@@ -17,6 +17,7 @@
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.settings.SettingsException;
 import org.elasticsearch.common.unit.TimeValue;
@@ -38,6 +39,7 @@
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
 import java.util.stream.Collectors;
@@ -133,14 +135,9 @@ public void testHostListIsRejectedIfTypeIsNotHttp() {
         final Settings.Builder builder = Settings.builder().put(prefix + ".type", "local");
         builder.putList(prefix + ".host", List.of("https://example.com:443"));
         final Settings settings = builder.build();
-        final IllegalArgumentException e = expectThrows(
-            IllegalArgumentException.class,
-            () -> HttpExporter.HOST_SETTING.getConcreteSetting(prefix + ".host").get(settings));
-        assertThat(
-            e,
-            hasToString(containsString("Failed to parse value [[\"https://example.com:443\"]] for setting [" + prefix + ".host]")));
-        assertThat(e.getCause(), instanceOf(SettingsException.class));
-        assertThat(e.getCause(), hasToString(containsString("host list for [" + prefix + ".host] is set but type is [local]")));
+        final ClusterSettings clusterSettings = new ClusterSettings(settings, Set.of(HttpExporter.HOST_SETTING, Exporter.TYPE_SETTING));
+        final SettingsException e = expectThrows(SettingsException.class, () -> clusterSettings.validate(settings, true));
+        assertThat(e, hasToString(containsString("[" + prefix + ".host] is set but type is [local]")));
     }
 
     public void testInvalidHost() {

From ea1000898f12e3b0808ffd0621b6418701e2cb6a Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Thu, 12 Dec 2019 22:26:35 -0500
Subject: [PATCH 191/686] Respect ES_PATH_CONF on package install (#50158)

We respect ES_PATH_CONF everywhere except package install. This commit
addresses this by respecting ES_PATH_CONF when installing the RPM/Debian
packages.
---
 distribution/packages/src/common/scripts/postinst | 15 +++++++++++----
 distribution/packages/src/common/scripts/postrm   | 12 ++++++++++--
 distribution/packages/src/common/scripts/prerm    | 13 ++++++++++---
 3 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/distribution/packages/src/common/scripts/postinst b/distribution/packages/src/common/scripts/postinst
index b440bb807755c..0c86904ba40e2 100644
--- a/distribution/packages/src/common/scripts/postinst
+++ b/distribution/packages/src/common/scripts/postinst
@@ -8,6 +8,13 @@
 #       $1=0         : indicates a removal
 #       $1=1         : indicates an upgrade
 
+# source the default env file
+if [ -f "${path.env}" ]; then
+    . "${path.env}"
+else
+  ES_PATH_CONF="${path.conf}"
+fi
+
 IS_UPGRADE=false
 
 case "$1" in
@@ -95,11 +102,11 @@ fi
 
 # the equivalent code for rpm is in posttrans
 if [ "$PACKAGE" = "deb" ]; then
-    if [ ! -f /etc/elasticsearch/elasticsearch.keystore ]; then
+    if [ ! -f "${ES_PATH_CONF}"/elasticsearch.keystore ]; then
         /usr/share/elasticsearch/bin/elasticsearch-keystore create
-        chown root:elasticsearch /etc/elasticsearch/elasticsearch.keystore
-        chmod 660 /etc/elasticsearch/elasticsearch.keystore
-        md5sum /etc/elasticsearch/elasticsearch.keystore > /etc/elasticsearch/.elasticsearch.keystore.initial_md5sum
+        chown root:elasticsearch "${ES_PATH_CONF}"/elasticsearch.keystore
+        chmod 660 "${ES_PATH_CONF}"/elasticsearch.keystore
+        md5sum "${ES_PATH_CONF}"/elasticsearch.keystore > "${ES_PATH_CONF}"/.elasticsearch.keystore.initial_md5sum
     else
         /usr/share/elasticsearch/bin/elasticsearch-keystore upgrade
     fi
diff --git a/distribution/packages/src/common/scripts/postrm b/distribution/packages/src/common/scripts/postrm
index c54df43450af4..e0e0bd237a6ba 100644
--- a/distribution/packages/src/common/scripts/postrm
+++ b/distribution/packages/src/common/scripts/postrm
@@ -8,6 +8,14 @@
 #   On RedHat,
 #       $1=0         : indicates a removal
 #       $1=1         : indicates an upgrade
+
+# source the default env file
+if [ -f "${path.env}" ]; then
+    . "${path.env}"
+else
+  ES_PATH_CONF="${path.conf}"
+fi
+
 REMOVE_DIRS=false
 REMOVE_USER_AND_GROUP=false
 
@@ -73,8 +81,8 @@ if [ "$REMOVE_DIRS" = "true" ]; then
     fi
 
     # delete the conf directory if and only if empty
-    if [ -d /etc/elasticsearch ]; then
-        rmdir --ignore-fail-on-non-empty /etc/elasticsearch
+    if [ -d "${ES_PATH_CONF}" ]; then
+        rmdir --ignore-fail-on-non-empty "${ES_PATH_CONF}"
     fi
 
 fi
diff --git a/distribution/packages/src/common/scripts/prerm b/distribution/packages/src/common/scripts/prerm
index f5cf67ca0b662..ff25345963b2d 100644
--- a/distribution/packages/src/common/scripts/prerm
+++ b/distribution/packages/src/common/scripts/prerm
@@ -9,6 +9,13 @@
 #       $1=0         : indicates a removal
 #       $1=1         : indicates an upgrade
 
+# source the default env file
+if [ -f "${path.env}" ]; then
+    . "${path.env}"
+else
+  ES_PATH_CONF="${path.conf}"
+fi
+
 STOP_REQUIRED=false
 REMOVE_SERVICE=false
 
@@ -65,9 +72,9 @@ if [ "$STOP_REQUIRED" = "true" ]; then
     echo " OK"
 fi
 
-if [ -f /etc/elasticsearch/elasticsearch.keystore ]; then
-  if md5sum --status -c /etc/elasticsearch/.elasticsearch.keystore.initial_md5sum; then
-    rm /etc/elasticsearch/elasticsearch.keystore /etc/elasticsearch/.elasticsearch.keystore.initial_md5sum
+if [ -f "${ES_PATH_CONF}"/elasticsearch.keystore ]; then
+  if md5sum --status -c "${ES_PATH_CONF}"/.elasticsearch.keystore.initial_md5sum; then
+    rm "${ES_PATH_CONF}"/elasticsearch.keystore "${ES_PATH_CONF}"/.elasticsearch.keystore.initial_md5sum
   fi
 fi
 

From a3d77da24148b3fd40449278e992bff349f69b36 Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Fri, 13 Dec 2019 08:09:25 +0100
Subject: [PATCH 192/686] [Transform] add actual timeout in message (#50140)

add the timeout to the message if stopping a transform times out
---
 .../xpack/transform/action/TransportStopTransformAction.java  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
index 010cfd1cbb6f2..aaf51396abb87 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
@@ -398,7 +398,9 @@ private void waitForTransformStopped(
                     if (stillRunningTasks.size() > 0) {
                         message.append("Could not stop the transforms ");
                         message.append(stillRunningTasks);
-                        message.append(" as they timed out.");
+                        message.append(" as they timed out [");
+                        message.append(timeout.toString());
+                        message.append("].");
                     }
 
                     listener.onFailure(new ElasticsearchStatusException(message.toString(), RestStatus.REQUEST_TIMEOUT));

From 0f6dfe95362f452bad7480447222ad1cf839c1c9 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Fri, 13 Dec 2019 18:29:31 +1100
Subject: [PATCH 193/686] Skip enterprise license tests in release build
 (#50163)

The release builds use a production license key, and our rest test load
licenses that are signed by the dev license key.

This change adds the new enterprise license Rest tests to the
blacklist on release builds.

Relates: #50067
Resolves: #50151
---
 x-pack/plugin/build.gradle | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/build.gradle b/x-pack/plugin/build.gradle
index 9c012df0c0b69..7663faae7c76d 100644
--- a/x-pack/plugin/build.gradle
+++ b/x-pack/plugin/build.gradle
@@ -69,8 +69,8 @@ integTest.runner {
   if (!snapshot) {
     // these tests attempt to install basic/internal licenses signed against the dev/public.key
     // Since there is no infrastructure in place (anytime soon) to generate licenses using the production
-    // private key, these tests are whitelisted in non-snapshot test runs
-    blacklist.addAll(['xpack/15_basic/*', 'license/20_put_license/*'])
+    // private key, these tests are blacklisted in non-snapshot test runs
+    blacklist.addAll(['xpack/15_basic/*', 'license/20_put_license/*', 'license/30_enterprise_license/*'])
   }
   systemProperty 'tests.rest.blacklist', blacklist.join(',')
   dependsOn copyKeyCerts

From c0d567472369a9658e1fe9fdf5b2fe65365f4f4c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Fri, 13 Dec 2019 09:59:45 +0100
Subject: [PATCH 194/686] Improve DateFieldMapper `ignore_malformed` handling
 (#50090)

A recent change around date parsing (#46675) made it stricter, so we should now also
catch DateTimeExceptions in DateFieldMapper and ignore those when the
`ignore_malformed` option is set.

Closes #50081
---
 .../index/mapper/DateFieldMapper.java            | 11 +++++++++--
 .../index/mapper/DateFieldMapperTests.java       | 16 +++++++++++-----
 2 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/mapper/DateFieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/DateFieldMapper.java
index 7a98d9a286ea8..43762645190e0 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/DateFieldMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/DateFieldMapper.java
@@ -54,6 +54,7 @@
 import org.elasticsearch.search.DocValueFormat;
 
 import java.io.IOException;
+import java.time.DateTimeException;
 import java.time.Instant;
 import java.time.ZoneId;
 import java.time.ZoneOffset;
@@ -77,19 +78,23 @@ public static class Defaults {
 
     public enum Resolution {
         MILLISECONDS(CONTENT_TYPE, NumericType.DATE) {
+            @Override
             public long convert(Instant instant) {
                 return instant.toEpochMilli();
             }
 
+            @Override
             public Instant toInstant(long value) {
                 return Instant.ofEpochMilli(value);
             }
         },
         NANOSECONDS("date_nanos", NumericType.DATE_NANOSECONDS) {
+            @Override
             public long convert(Instant instant) {
                 return toLong(instant);
             }
 
+            @Override
             public Instant toInstant(long value) {
                 return DateUtils.toInstant(value);
             }
@@ -274,7 +279,9 @@ public MappedFieldType clone() {
 
         @Override
         public boolean equals(Object o) {
-            if (!super.equals(o)) return false;
+            if (!super.equals(o)) {
+                return false;
+            }
             DateFieldType that = (DateFieldType) o;
             return Objects.equals(dateTimeFormatter, that.dateTimeFormatter) && Objects.equals(resolution, that.resolution);
         }
@@ -536,7 +543,7 @@ protected void parseCreateField(ParseContext context, List<IndexableField> field
         long timestamp;
         try {
             timestamp = fieldType().parse(dateAsString);
-        } catch (IllegalArgumentException | ElasticsearchParseException e) {
+        } catch (IllegalArgumentException | ElasticsearchParseException | DateTimeException e) {
             if (ignoreMalformed.value()) {
                 context.addIgnoredField(fieldType.name());
                 return;
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
index 4f7fad85326f4..daa70c865133f 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
@@ -159,7 +159,14 @@ public void testStore() throws Exception {
         assertEquals(1457654400000L, storedField.numericValue().longValue());
     }
 
-    public void testIgnoreMalformed() throws Exception {
+    public void testIgnoreMalformed() throws IOException {
+        testIgnoreMalfomedForValue("2016-03-99",
+                "failed to parse date field [2016-03-99] with format [strict_date_optional_time||epoch_millis]");
+        testIgnoreMalfomedForValue("-2147483648",
+                "Invalid value for Year (valid values -999999999 - 999999999): -2147483648");
+    }
+
+    private void testIgnoreMalfomedForValue(String value, String expectedException) throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date").endObject().endObject()
                 .endObject().endObject());
@@ -171,12 +178,11 @@ public void testIgnoreMalformed() throws Exception {
         ThrowingRunnable runnable = () -> mapper.parse(new SourceToParse("test", "1", BytesReference
                 .bytes(XContentFactory.jsonBuilder()
                         .startObject()
-                        .field("field", "2016-03-99")
+                        .field("field", value)
                         .endObject()),
                 XContentType.JSON));
         MapperParsingException e = expectThrows(MapperParsingException.class, runnable);
-        assertThat(e.getCause().getMessage(),
-            containsString("failed to parse date field [2016-03-99] with format [strict_date_optional_time||epoch_millis]"));
+        assertThat(e.getCause().getMessage(), containsString(expectedException));
 
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date")
@@ -188,7 +194,7 @@ public void testIgnoreMalformed() throws Exception {
         ParsedDocument doc = mapper2.parse(new SourceToParse("test", "1", BytesReference
                 .bytes(XContentFactory.jsonBuilder()
                         .startObject()
-                        .field("field", ":1")
+                        .field("field", value)
                         .endObject()),
                 XContentType.JSON));
 

From b4efe1fc3643c00ad5e48c2265d457b84271fd4e Mon Sep 17 00:00:00 2001
From: Ioannis Kakavas <ioannis@elastic.co>
Date: Fri, 13 Dec 2019 11:26:00 +0200
Subject: [PATCH 195/686] Fix testMalformedToken (#50164)

This test was fixed as part of #49736 so that it used a
TokenService mock instance that was enabled, so that token
verification fails because the token is invalid and not because
the token service is not enabled.
When the randomly generated token we send, decodes to being of
version > 7.2 , we need to have mocked a GetResponse for the call
that TokenService#getUserTokenFromId will make, otherwise this
hangs and times out.
---
 .../elasticsearch/xpack/security/authc/TokenServiceTests.java | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
index f17bdc980bcaf..d5411ebb20b19 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
@@ -599,7 +599,9 @@ public void testMalformedToken() throws Exception {
         final byte[] randomBytes = new byte[numBytes];
         random().nextBytes(randomBytes);
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
-
+        // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
+        Authentication authentication = new Authentication(new User("joe", "admin"), new RealmRef("native_realm", "native", "node1"), null);
+        mockGetTokenFromId(tokenService, UUIDs.randomBase64UUID(), authentication, false);
         ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
         storeTokenHeader(requestContext, Base64.getEncoder().encodeToString(randomBytes));
 

From fb03630389858d69e9cde76471f626bc4f9b1dcd Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Fri, 13 Dec 2019 10:30:56 +0000
Subject: [PATCH 196/686] Remove type metadata from ingest documents (#50131)

Referring to the _type field in an Ingest document has been deprecated and effectively
a no-op since 7.x, and we can remove support for it entirely in 8.0

Relates to #41059
---
 .../ingest/common/AppendProcessorTests.java   |  2 +-
 .../ingest/common/SetProcessorTests.java      |  2 +-
 .../ingest/SimulatePipelineRequest.java       |  4 ----
 .../elasticsearch/ingest/IngestDocument.java  |  2 --
 .../SimulatePipelineRequestParsingTests.java  | 24 ++-----------------
 5 files changed, 4 insertions(+), 30 deletions(-)

diff --git a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/AppendProcessorTests.java b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/AppendProcessorTests.java
index 7a48c9ace326d..51b7bf0132bd4 100644
--- a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/AppendProcessorTests.java
+++ b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/AppendProcessorTests.java
@@ -126,7 +126,7 @@ public void testConvertScalarToList() throws Exception {
     public void testAppendMetadataExceptVersion() throws Exception {
         // here any metadata field value becomes a list, which won't make sense in most of the cases,
         // but support for append is streamlined like for set so we test it
-        MetaData randomMetaData = randomFrom(MetaData.INDEX, MetaData.TYPE, MetaData.ID, MetaData.ROUTING);
+        MetaData randomMetaData = randomFrom(MetaData.INDEX, MetaData.ID, MetaData.ROUTING);
         List<String> values = new ArrayList<>();
         Processor appendProcessor;
         if (randomBoolean()) {
diff --git a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/SetProcessorTests.java b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/SetProcessorTests.java
index cf698288268d2..d303501d2ea4e 100644
--- a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/SetProcessorTests.java
+++ b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/SetProcessorTests.java
@@ -101,7 +101,7 @@ public void testSetExistingNullFieldWithOverrideDisabled() throws Exception {
     }
 
     public void testSetMetadataExceptVersion() throws Exception {
-        MetaData randomMetaData = randomFrom(MetaData.INDEX, MetaData.TYPE, MetaData.ID, MetaData.ROUTING);
+        MetaData randomMetaData = randomFrom(MetaData.INDEX, MetaData.ID, MetaData.ROUTING);
         Processor processor = createSetProcessor(randomMetaData.getFieldName(), "_value", true);
         IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random());
         processor.execute(ingestDocument);
diff --git a/server/src/main/java/org/elasticsearch/action/ingest/SimulatePipelineRequest.java b/server/src/main/java/org/elasticsearch/action/ingest/SimulatePipelineRequest.java
index 884e1590d1640..949d32c8fe734 100644
--- a/server/src/main/java/org/elasticsearch/action/ingest/SimulatePipelineRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/ingest/SimulatePipelineRequest.java
@@ -179,10 +179,6 @@ private static List<IngestDocument> parseDocs(Map<String, Object> config) {
                 dataMap, Fields.SOURCE);
             String index = ConfigurationUtils.readStringOrIntProperty(null, null,
                 dataMap, MetaData.INDEX.getFieldName(), "_index");
-            if (dataMap.containsKey(MetaData.TYPE.getFieldName())) {
-                deprecationLogger.deprecatedAndMaybeLog("simulate_pipeline_with_types",
-                    "[types removal] specifying _type in pipeline simulation requests is deprecated");
-            }
             String id = ConfigurationUtils.readStringOrIntProperty(null, null,
                 dataMap, MetaData.ID.getFieldName(), "_id");
             String routing = ConfigurationUtils.readOptionalStringOrIntProperty(null, null,
diff --git a/server/src/main/java/org/elasticsearch/ingest/IngestDocument.java b/server/src/main/java/org/elasticsearch/ingest/IngestDocument.java
index aabb6890a7b29..1f0d2b4757128 100644
--- a/server/src/main/java/org/elasticsearch/ingest/IngestDocument.java
+++ b/server/src/main/java/org/elasticsearch/ingest/IngestDocument.java
@@ -25,7 +25,6 @@
 import org.elasticsearch.index.mapper.IndexFieldMapper;
 import org.elasticsearch.index.mapper.RoutingFieldMapper;
 import org.elasticsearch.index.mapper.SourceFieldMapper;
-import org.elasticsearch.index.mapper.TypeFieldMapper;
 import org.elasticsearch.index.mapper.VersionFieldMapper;
 import org.elasticsearch.script.TemplateScript;
 
@@ -692,7 +691,6 @@ public String toString() {
 
     public enum MetaData {
         INDEX(IndexFieldMapper.NAME),
-        TYPE(TypeFieldMapper.NAME),
         ID(IdFieldMapper.NAME),
         ROUTING(RoutingFieldMapper.NAME),
         VERSION(VersionFieldMapper.NAME),
diff --git a/server/src/test/java/org/elasticsearch/action/ingest/SimulatePipelineRequestParsingTests.java b/server/src/test/java/org/elasticsearch/action/ingest/SimulatePipelineRequestParsingTests.java
index d3965e2cf35c5..a01c1f44a73d9 100644
--- a/server/src/test/java/org/elasticsearch/action/ingest/SimulatePipelineRequestParsingTests.java
+++ b/server/src/test/java/org/elasticsearch/action/ingest/SimulatePipelineRequestParsingTests.java
@@ -43,7 +43,6 @@
 import static org.elasticsearch.ingest.IngestDocument.MetaData.ID;
 import static org.elasticsearch.ingest.IngestDocument.MetaData.INDEX;
 import static org.elasticsearch.ingest.IngestDocument.MetaData.ROUTING;
-import static org.elasticsearch.ingest.IngestDocument.MetaData.TYPE;
 import static org.elasticsearch.ingest.IngestDocument.MetaData.VERSION;
 import static org.elasticsearch.ingest.IngestDocument.MetaData.VERSION_TYPE;
 import static org.hamcrest.Matchers.equalTo;
@@ -109,15 +108,7 @@ public void testParseUsingPipelineStore() throws Exception {
         assertThat(actualRequest.getPipeline().getProcessors().size(), equalTo(1));
     }
 
-    public void testParseWithProvidedPipelineNoType() throws Exception {
-        innerTestParseWithProvidedPipeline(false);
-    }
-
-    public void testParseWithProvidedPipelineWithType() throws Exception {
-        innerTestParseWithProvidedPipeline(true);
-    }
-
-    private void innerTestParseWithProvidedPipeline(boolean useExplicitType) throws Exception {
+    public void innerTestParseWithProvidedPipeline() throws Exception {
         int numDocs = randomIntBetween(1, 10);
 
         Map<String, Object> requestContent = new HashMap<>();
@@ -127,7 +118,7 @@ private void innerTestParseWithProvidedPipeline(boolean useExplicitType) throws
         for (int i = 0; i < numDocs; i++) {
             Map<String, Object> doc = new HashMap<>();
             Map<String, Object> expectedDoc = new HashMap<>();
-            List<IngestDocument.MetaData> fields = Arrays.asList(INDEX, TYPE, ID, ROUTING, VERSION, VERSION_TYPE);
+            List<IngestDocument.MetaData> fields = Arrays.asList(INDEX, ID, ROUTING, VERSION, VERSION_TYPE);
             for(IngestDocument.MetaData field : fields) {
                 if (field == VERSION) {
                     Long value = randomLong();
@@ -139,14 +130,6 @@ private void innerTestParseWithProvidedPipeline(boolean useExplicitType) throws
                     );
                     doc.put(field.getFieldName(), value);
                     expectedDoc.put(field.getFieldName(), value);
-                } else if (field == TYPE) {
-                    if (useExplicitType) {
-                        String value = randomAlphaOfLengthBetween(1, 10);
-                        doc.put(field.getFieldName(), value);
-                        expectedDoc.put(field.getFieldName(), value);
-                    } else {
-                        expectedDoc.put(field.getFieldName(), "_doc");
-                    }
                 } else {
                     if (randomBoolean()) {
                         String value = randomAlphaOfLengthBetween(1, 10);
@@ -213,9 +196,6 @@ private void innerTestParseWithProvidedPipeline(boolean useExplicitType) throws
         assertThat(actualRequest.getPipeline().getId(), equalTo(SIMULATED_PIPELINE_ID));
         assertThat(actualRequest.getPipeline().getDescription(), nullValue());
         assertThat(actualRequest.getPipeline().getProcessors().size(), equalTo(numProcessors));
-        if (useExplicitType) {
-            assertWarnings("[types removal] specifying _type in pipeline simulation requests is deprecated");
-        }
     }
 
     public void testNullPipelineId() {

From da73b00b4119513cd53f9f0d12180e97f52cdaef Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Fri, 13 Dec 2019 08:43:35 -0500
Subject: [PATCH 197/686] [DOCS] Reformat token count limit filter docs
 (#49835)

---
 .../limit-token-count-tokenfilter.asciidoc    | 134 +++++++++++++++---
 1 file changed, 118 insertions(+), 16 deletions(-)

diff --git a/docs/reference/analysis/tokenfilters/limit-token-count-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/limit-token-count-tokenfilter.asciidoc
index 7fe2432ca5473..61e7ec8706d88 100644
--- a/docs/reference/analysis/tokenfilters/limit-token-count-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/limit-token-count-tokenfilter.asciidoc
@@ -1,32 +1,134 @@
 [[analysis-limit-token-count-tokenfilter]]
-=== Limit Token Count Token Filter
+=== Limit token count token filter
+++++
+<titleabbrev>Limit token count</titleabbrev>
+++++
 
-Limits the number of tokens that are indexed per document and field.
+Limits the number of output tokens. The `limit` filter is commonly used to limit
+the size of document field values based on token count.
 
-[cols="<,<",options="header",]
-|=======================================================================
-|Setting |Description
-|`max_token_count` |The maximum number of tokens that should be indexed
-per document and field. The default is `1`
+By default, the `limit` filter keeps only the first token in a stream. For
+example, the filter can change the token stream `[ one, two, three ]` to 
+`[ one ]`.
 
-|`consume_all_tokens` |If set to `true` the filter exhaust the stream
-even if `max_token_count` tokens have been consumed already. The default
-is `false`.
-|=======================================================================
+This filter uses Lucene's
+https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/miscellaneous/LimitTokenCountFilter.html[LimitTokenCountFilter].
 
-Here is an example:
+[TIP]
+====
+ If you want to limit the size of field values based on
+_character length_, use the <<ignore-above,`ignore_above`>> mapping parameter.
+====
+
+[[analysis-limit-token-count-tokenfilter-configure-parms]]
+==== Configurable parameters
+
+`max_token_count`::
+(Optional, integer)
+Maximum number of tokens to keep. Once this limit is reached, any remaining
+tokens are excluded from the output. Defaults to `1`.
+
+`consume_all_tokens`::
+(Optional, boolean)
+If `true`, the `limit` filter exhausts the token stream, even if the
+`max_token_count` has already been reached. Defaults to `false`.
+
+[[analysis-limit-token-count-tokenfilter-analyze-ex]]
+==== Example
+
+The following <<indices-analyze,analyze API>> request uses the `limit`
+filter to keep only the first two tokens in `quick fox jumps over lazy dog`:
+
+[source,console]
+--------------------------------------------------
+GET _analyze
+{
+  "tokenizer": "standard",
+    "filter": [
+    {
+      "type": "limit",
+      "max_token_count": 2
+    }
+  ],
+  "text": "quick fox jumps over lazy dog"
+}
+--------------------------------------------------
+
+The filter produces the following tokens:
+
+[source,text]
+--------------------------------------------------
+[ quick, fox ]
+--------------------------------------------------
+
+/////////////////////
+[source,console-result]
+--------------------------------------------------
+{
+  "tokens": [
+    {
+      "token": "quick",
+      "start_offset": 0,
+      "end_offset": 5,
+      "type": "<ALPHANUM>",
+      "position": 0
+    },
+    {
+      "token": "fox",
+      "start_offset": 6,
+      "end_offset": 9,
+      "type": "<ALPHANUM>",
+      "position": 1
+    }
+  ]
+}
+--------------------------------------------------
+/////////////////////
+
+[[analysis-limit-token-count-tokenfilter-analyzer-ex]]
+==== Add to an analyzer
+
+The following <<indices-create-index,create index API>> request uses the
+`limit` filter to configure a new 
+<<analysis-custom-analyzer,custom analyzer>>.
 
 [source,console]
 --------------------------------------------------
-PUT /limit_example
+PUT limit_example
 {
   "settings": {
     "analysis": {
       "analyzer": {
-        "limit_example": {
-          "type": "custom",
+        "standard_one_token_limit": {
           "tokenizer": "standard",
-          "filter": ["lowercase", "five_token_limit"]
+          "filter": [ "limit" ]
+        }
+      }
+    }
+  }
+}
+--------------------------------------------------
+
+[[analysis-limit-token-count-tokenfilter-customize]]
+==== Customize
+
+To customize the `limit` filter, duplicate it to create the basis
+for a new custom token filter. You can modify the filter using its configurable
+parameters.
+
+For example, the following request creates a custom `limit` filter that keeps
+only the first five tokens of a stream:
+
+[source,console]
+--------------------------------------------------
+PUT custom_limit_example
+{
+  "settings": {
+    "analysis": {
+      "analyzer": {
+        "whitespace_five_token_limit": {
+          "tokenizer": "whitespace",
+          "filter": [ "five_token_limit" ]
         }
       },
       "filter": {

From 9648fbd838f4a0ea95fdbb16656f58411e07fd00 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Fri, 13 Dec 2019 09:10:50 -0500
Subject: [PATCH 198/686] [ML][Inference] Adding a warning_field for warning
 msgs. (#49838)

This adds a new field for the inference processor.

`warning_field` is a place for us to write warnings provided from the inference call. When there are warnings we are not going to write an inference result. The goal of this is to indicate that the data provided was too poor or too different for the model to make an accurate prediction.

The user could optionally include the `warning_field`. When it is not provided, it is assumed no warnings were desired to be written.

The first of these warnings is when ALL of the input fields are missing. If none of the trained fields are present, we don't bother inferencing against the model and instead provide a warning stating that the fields were missing.

Also, this adds checks to not allow duplicated fields during processor creation.
---
 .../results/WarningInferenceResults.java      | 66 +++++++++++++++++++
 .../xpack/core/ml/job/messages/Messages.java  |  1 +
 .../results/WarningInferenceResultsTests.java | 39 +++++++++++
 .../process/AnalyticsResultProcessor.java     | 20 +++++-
 .../inference/ingest/InferenceProcessor.java  | 43 ++++++++++--
 .../inference/loadingservice/LocalModel.java  | 17 ++++-
 .../loadingservice/ModelLoadingService.java   |  6 +-
 .../AnalyticsResultProcessorTests.java        |  2 +-
 .../InferenceProcessorFactoryTests.java       | 23 +++++++
 .../ingest/InferenceProcessorTests.java       | 23 +++++++
 .../loadingservice/LocalModelTests.java       | 36 ++++++++--
 .../ModelLoadingServiceTests.java             |  3 +
 .../integration/ModelInferenceActionIT.java   | 52 ++++++++++++++-
 13 files changed, 315 insertions(+), 16 deletions(-)
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/WarningInferenceResults.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/WarningInferenceResultsTests.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/WarningInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/WarningInferenceResults.java
new file mode 100644
index 0000000000000..a052c2b263d3e
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/WarningInferenceResults.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.results;
+
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.ingest.IngestDocument;
+import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+
+import java.io.IOException;
+import java.util.Objects;
+
+public class WarningInferenceResults implements InferenceResults {
+
+    public static final String NAME = "warning";
+    public static final ParseField WARNING = new ParseField("warning");
+
+    private final String warning;
+
+    public WarningInferenceResults(String warning) {
+        this.warning = warning;
+    }
+
+    public WarningInferenceResults(StreamInput in) throws IOException {
+        this.warning = in.readString();
+    }
+
+    public String getWarning() {
+        return warning;
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeString(warning);
+    }
+
+    @Override
+    public boolean equals(Object object) {
+        if (object == this) { return true; }
+        if (object == null || getClass() != object.getClass()) { return false; }
+        WarningInferenceResults that = (WarningInferenceResults) object;
+        return Objects.equals(warning, that.warning);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(warning);
+    }
+
+    @Override
+    public void writeResult(IngestDocument document, String parentResultField) {
+        ExceptionsHelper.requireNonNull(document, "document");
+        ExceptionsHelper.requireNonNull(parentResultField, "resultField");
+        document.setFieldValue(parentResultField + "." + "warning", warning);
+    }
+
+    @Override
+    public String getWriteableName() {
+        return NAME;
+    }
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
index febe9a8eb42a9..5e7d3ee3318c6 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
@@ -92,6 +92,7 @@ public final class Messages {
     public static final String INFERENCE_FAILED_TO_DESERIALIZE = "Could not deserialize trained model [{0}]";
     public static final String INFERENCE_TO_MANY_DEFINITIONS_REQUESTED =
         "Getting model definition is not supported when getting more than one model";
+    public static final String INFERENCE_WARNING_ALL_FIELDS_MISSING = "Model [{0}] could not be inferred as all fields were missing";
 
     public static final String JOB_AUDIT_DATAFEED_DATA_SEEN_AGAIN = "Datafeed has started retrieving data again";
     public static final String JOB_AUDIT_CREATED = "Job created";
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/WarningInferenceResultsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/WarningInferenceResultsTests.java
new file mode 100644
index 0000000000000..da48a91cdde38
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/results/WarningInferenceResultsTests.java
@@ -0,0 +1,39 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.results;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.ingest.IngestDocument;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+
+import java.util.HashMap;
+
+import static org.hamcrest.Matchers.equalTo;
+
+public class WarningInferenceResultsTests extends AbstractWireSerializingTestCase<WarningInferenceResults> {
+
+    public static WarningInferenceResults createRandomResults() {
+        return new WarningInferenceResults(randomAlphaOfLength(10));
+    }
+
+    public void testWriteResults() {
+        WarningInferenceResults result = new WarningInferenceResults("foo");
+        IngestDocument document = new IngestDocument(new HashMap<>(), new HashMap<>());
+        result.writeResult(document, "result_field");
+
+        assertThat(document.getFieldValue("result_field.warning", String.class), equalTo("foo"));
+    }
+
+    @Override
+    protected WarningInferenceResults createTestInstance() {
+        return createRandomResults();
+    }
+
+    @Override
+    protected Writeable.Reader<WarningInferenceResults> instanceReader() {
+        return WarningInferenceResults::new;
+    }
+}
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessor.java
index b6ac92134723c..00fea87a05b20 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessor.java
@@ -16,6 +16,8 @@
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.license.License;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
@@ -34,6 +36,8 @@
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
 
+import static java.util.stream.Collectors.toList;
+
 public class AnalyticsResultProcessor {
 
     private static final Logger LOGGER = LogManager.getLogger(AnalyticsResultProcessor.class);
@@ -163,6 +167,10 @@ private TrainedModelConfig createTrainedModelConfig(TrainedModelDefinition.Build
         Instant createTime = Instant.now();
         String modelId = analytics.getId() + "-" + createTime.toEpochMilli();
         TrainedModelDefinition definition = inferenceModel.build();
+        String dependentVariable = getDependentVariable();
+        List<String> fieldNamesWithoutDependentVariable = fieldNames.stream()
+            .filter(f -> f.equals(dependentVariable) == false)
+            .collect(toList());
         return TrainedModelConfig.builder()
             .setModelId(modelId)
             .setCreatedBy("data-frame-analytics")
@@ -175,11 +183,21 @@ private TrainedModelConfig createTrainedModelConfig(TrainedModelDefinition.Build
             .setEstimatedHeapMemory(definition.ramBytesUsed())
             .setEstimatedOperations(definition.getTrainedModel().estimatedNumOperations())
             .setParsedDefinition(inferenceModel)
-            .setInput(new TrainedModelInput(fieldNames))
+            .setInput(new TrainedModelInput(fieldNamesWithoutDependentVariable))
             .setLicenseLevel(License.OperationMode.PLATINUM.description())
             .build();
     }
 
+    private String getDependentVariable() {
+        if (analytics.getAnalysis() instanceof Classification) {
+            return ((Classification)analytics.getAnalysis()).getDependentVariable();
+        }
+        if (analytics.getAnalysis() instanceof Regression) {
+            return ((Regression)analytics.getAnalysis()).getDependentVariable();
+        }
+        return null;
+    }
+
     private CountDownLatch storeTrainedModel(TrainedModelConfig trainedModelConfig) {
         CountDownLatch latch = new CountDownLatch(1);
         ActionListener<Boolean> storeListener = ActionListener.wrap(
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
index 805123cf53cc2..19c0054b522bf 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
@@ -28,6 +28,8 @@
 import org.elasticsearch.ingest.Processor;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.xpack.core.ml.action.InternalInferModelAction;
+import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
+import org.elasticsearch.xpack.core.ml.inference.results.WarningInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
@@ -37,7 +39,9 @@
 
 import java.util.Arrays;
 import java.util.HashMap;
+import java.util.HashSet;
 import java.util.Map;
+import java.util.Set;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.BiConsumer;
 import java.util.function.Consumer;
@@ -146,7 +150,12 @@ void mutateDocument(InternalInferModelAction.Response response, IngestDocument i
         if (response.getInferenceResults().isEmpty()) {
             throw new ElasticsearchStatusException("Unexpected empty inference response", RestStatus.INTERNAL_SERVER_ERROR);
         }
-        response.getInferenceResults().get(0).writeResult(ingestDocument, this.targetField);
+        InferenceResults inferenceResults = response.getInferenceResults().get(0);
+        if (inferenceResults instanceof WarningInferenceResults) {
+            inferenceResults.writeResult(ingestDocument, this.targetField);
+        } else {
+            response.getInferenceResults().get(0).writeResult(ingestDocument, this.targetField);
+        }
         ingestDocument.setFieldValue(targetField + "." + MODEL_ID, modelId);
     }
 
@@ -164,6 +173,10 @@ public static final class Factory implements Processor.Factory, Consumer<Cluster
 
         private static final Logger logger = LogManager.getLogger(Factory.class);
 
+        private static final Set<String> RESERVED_ML_FIELD_NAMES = new HashSet<>(Arrays.asList(
+            WarningInferenceResults.WARNING.getPreferredName(),
+            MODEL_ID));
+
         private final Client client;
         private final IngestService ingestService;
         private final InferenceAuditor auditor;
@@ -235,6 +248,7 @@ public InferenceProcessor create(Map<String, Processor.Factory> processorFactori
             String targetField = ConfigurationUtils.readStringProperty(TYPE, tag, config, TARGET_FIELD, defaultTargetField);
             Map<String, String> fieldMapping = ConfigurationUtils.readOptionalMap(TYPE, tag, config, FIELD_MAPPINGS);
             InferenceConfig inferenceConfig = inferenceConfigFromMap(ConfigurationUtils.readMap(TYPE, tag, config, INFERENCE_CONFIG));
+
             return new InferenceProcessor(client,
                 auditor,
                 tag,
@@ -252,7 +266,6 @@ void setMaxIngestProcessors(int maxIngestProcessors) {
 
         InferenceConfig inferenceConfigFromMap(Map<String, Object> inferenceConfig) {
             ExceptionsHelper.requireNonNull(inferenceConfig, INFERENCE_CONFIG);
-
             if (inferenceConfig.size() != 1) {
                 throw ExceptionsHelper.badRequestException("{} must be an object with one inference type mapped to an object.",
                     INFERENCE_CONFIG);
@@ -268,10 +281,14 @@ InferenceConfig inferenceConfigFromMap(Map<String, Object> inferenceConfig) {
 
             if (inferenceConfig.containsKey(ClassificationConfig.NAME)) {
                 checkSupportedVersion(ClassificationConfig.EMPTY_PARAMS);
-                return ClassificationConfig.fromMap(valueMap);
+                ClassificationConfig config = ClassificationConfig.fromMap(valueMap);
+                checkFieldUniqueness(config.getResultsField(), config.getTopClassesResultsField());
+                return config;
             } else if (inferenceConfig.containsKey(RegressionConfig.NAME)) {
                 checkSupportedVersion(RegressionConfig.EMPTY_PARAMS);
-                return RegressionConfig.fromMap(valueMap);
+                RegressionConfig config = RegressionConfig.fromMap(valueMap);
+                checkFieldUniqueness(config.getResultsField());
+                return config;
             } else {
                 throw ExceptionsHelper.badRequestException("unrecognized inference configuration type {}. Supported types {}",
                     inferenceConfig.keySet(),
@@ -279,6 +296,23 @@ InferenceConfig inferenceConfigFromMap(Map<String, Object> inferenceConfig) {
             }
         }
 
+        private static void checkFieldUniqueness(String... fieldNames) {
+            Set<String> duplicatedFieldNames = new HashSet<>();
+            Set<String> currentFieldNames = new HashSet<>(RESERVED_ML_FIELD_NAMES);
+            for(String fieldName : fieldNames) {
+                if (currentFieldNames.contains(fieldName)) {
+                    duplicatedFieldNames.add(fieldName);
+                } else {
+                    currentFieldNames.add(fieldName);
+                }
+            }
+            if (duplicatedFieldNames.isEmpty() == false) {
+                throw ExceptionsHelper.badRequestException("Cannot create processor as configured." +
+                        " More than one field is configured as {}",
+                    duplicatedFieldNames);
+            }
+        }
+
         void checkSupportedVersion(InferenceConfig config) {
             if (config.getMinimalSupportedVersion().after(minNodeVersion)) {
                 throw ExceptionsHelper.badRequestException(Messages.getMessage(Messages.INFERENCE_CONFIG_NOT_SUPPORTED_ON_VERSION,
@@ -287,6 +321,5 @@ void checkSupportedVersion(InferenceConfig config) {
                     minNodeVersion));
             }
         }
-
     }
 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModel.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModel.java
index 403f10dd7d83b..4e62c69336b6a 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModel.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModel.java
@@ -6,23 +6,33 @@
 package org.elasticsearch.xpack.ml.inference.loadingservice;
 
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
+import org.elasticsearch.xpack.core.ml.inference.results.WarningInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
+import org.elasticsearch.xpack.core.ml.job.messages.Messages;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.RegressionInferenceResults;
 
+import java.util.HashSet;
 import java.util.Map;
+import java.util.Set;
+
+import static org.elasticsearch.xpack.core.ml.job.messages.Messages.INFERENCE_WARNING_ALL_FIELDS_MISSING;
 
 public class LocalModel implements Model {
 
     private final TrainedModelDefinition trainedModelDefinition;
     private final String modelId;
+    private final Set<String> fieldNames;
 
-    public LocalModel(String modelId, TrainedModelDefinition trainedModelDefinition) {
+    public LocalModel(String modelId, TrainedModelDefinition trainedModelDefinition, TrainedModelInput input) {
         this.trainedModelDefinition = trainedModelDefinition;
         this.modelId = modelId;
+        this.fieldNames = new HashSet<>(input.getFieldNames());
     }
 
     long ramBytesUsed() {
@@ -51,6 +61,11 @@ public String getResultsType() {
     @Override
     public void infer(Map<String, Object> fields, InferenceConfig config, ActionListener<InferenceResults> listener) {
         try {
+            if (Sets.haveEmptyIntersection(fieldNames, fields.keySet())) {
+                listener.onResponse(new WarningInferenceResults(Messages.getMessage(INFERENCE_WARNING_ALL_FIELDS_MISSING, modelId)));
+                return;
+            }
+
             listener.onResponse(trainedModelDefinition.infer(fields, config));
         } catch (Exception e) {
             listener.onFailure(e);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/ModelLoadingService.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/ModelLoadingService.java
index 2355228f4c366..b5862acfefc27 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/ModelLoadingService.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/ModelLoadingService.java
@@ -141,7 +141,8 @@ public void getModel(String modelId, ActionListener<Model> modelActionListener)
                 trainedModelConfig ->
                     modelActionListener.onResponse(new LocalModel(
                         trainedModelConfig.getModelId(),
-                        trainedModelConfig.ensureParsedDefinition(namedXContentRegistry).getModelDefinition())),
+                        trainedModelConfig.ensureParsedDefinition(namedXContentRegistry).getModelDefinition(),
+                        trainedModelConfig.getInput())),
                 modelActionListener::onFailure
             ));
         } else {
@@ -198,7 +199,8 @@ private void handleLoadSuccess(String modelId, TrainedModelConfig trainedModelCo
         Queue<ActionListener<Model>> listeners;
         LocalModel loadedModel = new LocalModel(
             trainedModelConfig.getModelId(),
-            trainedModelConfig.ensureParsedDefinition(namedXContentRegistry).getModelDefinition());
+            trainedModelConfig.ensureParsedDefinition(namedXContentRegistry).getModelDefinition(),
+            trainedModelConfig.getInput());
         synchronized (loadingListeners) {
             listeners = loadingListeners.remove(modelId);
             // If there is no loadingListener that means the loading was canceled and the listener was already notified as such
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
index 15bd32da3c320..036023eb8c9aa 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
@@ -171,7 +171,7 @@ public void testProcess_GivenInferenceModelIsStoredSuccessfully() {
         assertThat(storedModel.getTags(), contains(JOB_ID));
         assertThat(storedModel.getDescription(), equalTo(JOB_DESCRIPTION));
         assertThat(storedModel.getModelDefinition(), equalTo(inferenceModel.build()));
-        assertThat(storedModel.getInput().getFieldNames(), equalTo(expectedFieldNames));
+        assertThat(storedModel.getInput().getFieldNames(), equalTo(Arrays.asList("bar", "baz")));
         assertThat(storedModel.getEstimatedHeapMemory(), equalTo(inferenceModel.build().ramBytesUsed()));
         assertThat(storedModel.getEstimatedOperations(), equalTo(inferenceModel.build().getTrainedModel().estimatedNumOperations()));
         Map<String, Object> metadata = storedModel.getMetadata();
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorFactoryTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorFactoryTests.java
index 6f5011d0497cd..f7216ab206e85 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorFactoryTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorFactoryTests.java
@@ -238,6 +238,29 @@ public void testCreateProcessor() {
         }
     }
 
+    public void testCreateProcessorWithDuplicateFields() {
+        InferenceProcessor.Factory processorFactory = new InferenceProcessor.Factory(client,
+            clusterService,
+            Settings.EMPTY,
+            ingestService);
+
+        Map<String, Object> regression = new HashMap<>() {{
+            put(InferenceProcessor.FIELD_MAPPINGS, Collections.emptyMap());
+            put(InferenceProcessor.MODEL_ID, "my_model");
+            put(InferenceProcessor.TARGET_FIELD, "ml");
+            put(InferenceProcessor.INFERENCE_CONFIG, Collections.singletonMap(RegressionConfig.NAME,
+                Collections.singletonMap(RegressionConfig.RESULTS_FIELD.getPreferredName(), "warning")));
+        }};
+
+        try {
+            processorFactory.create(Collections.emptyMap(), "my_inference_processor", regression);
+            fail("should not have succeeded creating with duplicate fields");
+        } catch (Exception ex) {
+            assertThat(ex.getMessage(), equalTo("Cannot create processor as configured. " +
+                "More than one field is configured as [warning]"));
+        }
+    }
+
     private static ClusterState buildClusterState(MetaData metaData) {
        return ClusterState.builder(new ClusterName("_name")).metaData(metaData).build();
     }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
index 55720f73ccb25..014c9fad11203 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
@@ -11,6 +11,7 @@
 import org.elasticsearch.xpack.core.ml.action.InternalInferModelAction;
 import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.RegressionInferenceResults;
+import org.elasticsearch.xpack.core.ml.inference.results.WarningInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
 import org.elasticsearch.xpack.ml.notifications.InferenceAuditor;
@@ -253,4 +254,26 @@ public void testHandleResponseLicenseChanged() {
         verify(auditor, times(1)).warning(eq("regression_model"), any(String.class));
     }
 
+    public void testMutateDocumentWithWarningResult() {
+        String targetField = "regression_value";
+        InferenceProcessor inferenceProcessor = new InferenceProcessor(client,
+            auditor,
+            "my_processor",
+            "ml",
+            "regression_model",
+            RegressionConfig.EMPTY_PARAMS,
+            Collections.emptyMap());
+
+        Map<String, Object> source = new HashMap<>();
+        Map<String, Object> ingestMetadata = new HashMap<>();
+        IngestDocument document = new IngestDocument(source, ingestMetadata);
+
+        InternalInferModelAction.Response response = new InternalInferModelAction.Response(
+            Collections.singletonList(new WarningInferenceResults("something broke")), true);
+        inferenceProcessor.mutateDocument(response, document);
+
+        assertThat(document.hasField(targetField), is(false));
+        assertThat(document.hasField("ml.warning"), is(true));
+        assertThat(document.hasField("ml.my_processor"), is(false));
+    }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
index 41bad95fbb3a6..fb82c4ddfaaf5 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
@@ -8,8 +8,10 @@
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.OneHotEncoding;
 import org.elasticsearch.xpack.core.ml.inference.results.SingleValueInferenceResults;
+import org.elasticsearch.xpack.core.ml.inference.results.WarningInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
@@ -22,6 +24,7 @@
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.tree.TreeNode;
 import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
+import org.elasticsearch.xpack.core.ml.job.messages.Messages;
 
 import java.util.Arrays;
 import java.util.HashMap;
@@ -38,12 +41,13 @@ public class LocalModelTests extends ESTestCase {
 
     public void testClassificationInfer() throws Exception {
         String modelId = "classification_model";
+        List<String> inputFields = Arrays.asList("foo", "bar", "categorical");
         TrainedModelDefinition definition = new TrainedModelDefinition.Builder()
             .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotMap())))
             .setTrainedModel(buildClassification(false))
             .build();
 
-        Model model = new LocalModel(modelId, definition);
+        Model model = new LocalModel(modelId, definition, new TrainedModelInput(inputFields));
         Map<String, Object> fields = new HashMap<>() {{
             put("foo", 1.0);
             put("bar", 0.5);
@@ -64,7 +68,7 @@ public void testClassificationInfer() throws Exception {
             .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotMap())))
             .setTrainedModel(buildClassification(true))
             .build();
-        model = new LocalModel(modelId, definition);
+        model = new LocalModel(modelId, definition, new TrainedModelInput(inputFields));
         result = getSingleValue(model, fields, new ClassificationConfig(0));
         assertThat(result.value(), equalTo(0.0));
         assertThat(result.valueAsString(), equalTo("not_to_be"));
@@ -81,11 +85,12 @@ public void testClassificationInfer() throws Exception {
     }
 
     public void testRegression() throws Exception {
+        List<String> inputFields = Arrays.asList("foo", "bar", "categorical");
         TrainedModelDefinition trainedModelDefinition = new TrainedModelDefinition.Builder()
             .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotMap())))
             .setTrainedModel(buildRegression())
             .build();
-        Model model = new LocalModel("regression_model", trainedModelDefinition);
+        Model model = new LocalModel("regression_model", trainedModelDefinition, new TrainedModelInput(inputFields));
 
         Map<String, Object> fields = new HashMap<>() {{
             put("foo", 1.0);
@@ -103,12 +108,35 @@ public void testRegression() throws Exception {
             equalTo("Cannot infer using configuration for [classification] when model target_type is [regression]"));
     }
 
+    public void testAllFieldsMissing() throws Exception {
+        List<String> inputFields = Arrays.asList("foo", "bar", "categorical");
+        TrainedModelDefinition trainedModelDefinition = new TrainedModelDefinition.Builder()
+            .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotMap())))
+            .setTrainedModel(buildRegression())
+            .build();
+        Model model = new LocalModel("regression_model", trainedModelDefinition, new TrainedModelInput(inputFields));
+
+        Map<String, Object> fields = new HashMap<>() {{
+            put("something", 1.0);
+            put("other", 0.5);
+            put("baz", "dog");
+        }};
+
+        WarningInferenceResults results = (WarningInferenceResults)getInferenceResult(model, fields, RegressionConfig.EMPTY_PARAMS);
+        assertThat(results.getWarning(),
+            equalTo(Messages.getMessage(Messages.INFERENCE_WARNING_ALL_FIELDS_MISSING, "regression_model")));
+    }
+
     private static SingleValueInferenceResults getSingleValue(Model model,
                                                               Map<String, Object> fields,
                                                               InferenceConfig config) throws Exception {
+        return (SingleValueInferenceResults)getInferenceResult(model, fields, config);
+    }
+
+    private static InferenceResults getInferenceResult(Model model, Map<String, Object> fields, InferenceConfig config) throws Exception {
         PlainActionFuture<InferenceResults> future = new PlainActionFuture<>();
         model.infer(fields, config, future);
-        return (SingleValueInferenceResults)future.get();
+        return future.get();
     }
 
     private static Map<String, String> oneHotMap() {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/ModelLoadingServiceTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/ModelLoadingServiceTests.java
index 462a9a90527ba..85c34c6f50496 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/ModelLoadingServiceTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/ModelLoadingServiceTests.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
 import org.elasticsearch.xpack.ml.inference.ingest.InferenceProcessor;
 import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelProvider;
@@ -45,6 +46,7 @@
 
 import java.io.IOException;
 import java.net.InetAddress;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
@@ -308,6 +310,7 @@ private void withTrainedModel(String modelId, long size) throws IOException {
         when(definition.ramBytesUsed()).thenReturn(size);
         TrainedModelConfig trainedModelConfig = mock(TrainedModelConfig.class);
         when(trainedModelConfig.getModelDefinition()).thenReturn(definition);
+        when(trainedModelConfig.getInput()).thenReturn(new TrainedModelInput(Arrays.asList("foo", "bar", "baz")));
         doAnswer(invocationOnMock -> {
             @SuppressWarnings("rawtypes")
             ActionListener listener = (ActionListener) invocationOnMock.getArguments()[2];
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
index eb1064aebb21c..6f48ce7d3e745 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
@@ -17,7 +17,9 @@
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinitionTests;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.OneHotEncoding;
+import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.SingleValueInferenceResults;
+import org.elasticsearch.xpack.core.ml.inference.results.WarningInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
@@ -39,6 +41,7 @@
 
 import static org.elasticsearch.xpack.ml.inference.loadingservice.LocalModelTests.buildClassification;
 import static org.elasticsearch.xpack.ml.inference.loadingservice.LocalModelTests.buildRegression;
+import static org.hamcrest.CoreMatchers.instanceOf;
 import static org.hamcrest.CoreMatchers.is;
 import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.equalTo;
@@ -63,7 +66,7 @@ public void testInferModels() throws Exception {
         oneHotEncoding.put("cat", "animal_cat");
         oneHotEncoding.put("dog", "animal_dog");
         TrainedModelConfig config1 = buildTrainedModelConfigBuilder(modelId2)
-            .setInput(new TrainedModelInput(Arrays.asList("field1", "field2")))
+            .setInput(new TrainedModelInput(Arrays.asList("foo", "bar", "categorical")))
             .setParsedDefinition(new TrainedModelDefinition.Builder()
                 .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotEncoding)))
                 .setTrainedModel(buildClassification(true)))
@@ -74,7 +77,7 @@ public void testInferModels() throws Exception {
             .setEstimatedHeapMemory(0)
             .build();
         TrainedModelConfig config2 = buildTrainedModelConfigBuilder(modelId1)
-            .setInput(new TrainedModelInput(Arrays.asList("field1", "field2")))
+            .setInput(new TrainedModelInput(Arrays.asList("foo", "bar", "categorical")))
             .setParsedDefinition(new TrainedModelDefinition.Builder()
                 .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotEncoding)))
                 .setTrainedModel(buildRegression()))
@@ -184,6 +187,51 @@ public void testInferMissingModel() {
         }
     }
 
+    public void testInferMissingFields() throws Exception {
+        String modelId = "test-load-models-regression-missing-fields";
+        Map<String, String> oneHotEncoding = new HashMap<>();
+        oneHotEncoding.put("cat", "animal_cat");
+        oneHotEncoding.put("dog", "animal_dog");
+        TrainedModelConfig config = buildTrainedModelConfigBuilder(modelId)
+            .setInput(new TrainedModelInput(Arrays.asList("field1", "field2")))
+            .setParsedDefinition(new TrainedModelDefinition.Builder()
+                .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotEncoding)))
+                .setTrainedModel(buildRegression()))
+            .setVersion(Version.CURRENT)
+            .setEstimatedOperations(0)
+            .setEstimatedHeapMemory(0)
+            .setCreateTime(Instant.now())
+            .build();
+        AtomicReference<Boolean> putConfigHolder = new AtomicReference<>();
+        AtomicReference<Exception> exceptionHolder = new AtomicReference<>();
+
+        blockingCall(listener -> trainedModelProvider.storeTrainedModel(config, listener), putConfigHolder, exceptionHolder);
+        assertThat(putConfigHolder.get(), is(true));
+        assertThat(exceptionHolder.get(), is(nullValue()));
+
+
+        List<Map<String, Object>> toInferMissingField = new ArrayList<>();
+        toInferMissingField.add(new HashMap<>() {{
+            put("foo", 1.0);
+            put("bar", 0.5);
+        }});
+
+        InternalInferModelAction.Request request = new InternalInferModelAction.Request(
+            modelId,
+            toInferMissingField,
+            RegressionConfig.EMPTY_PARAMS,
+            true);
+        try {
+            InferenceResults result =
+                client().execute(InternalInferModelAction.INSTANCE, request).actionGet().getInferenceResults().get(0);
+            assertThat(result, is(instanceOf(WarningInferenceResults.class)));
+            assertThat(((WarningInferenceResults)result).getWarning(),
+                equalTo(Messages.getMessage(Messages.INFERENCE_WARNING_ALL_FIELDS_MISSING, modelId)));
+        } catch (ElasticsearchException ex) {
+            fail("Should not have thrown. Ex: " + ex.getMessage());
+        }
+    }
+
     private static TrainedModelConfig.Builder buildTrainedModelConfigBuilder(String modelId) {
         return TrainedModelConfig.builder()
             .setCreatedBy("ml_test")

From 358b2e242754c351af60f4756f962d62ef42912b Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 13 Dec 2019 16:11:30 +0200
Subject: [PATCH 199/686] [ML] Fix DFA explain API timeout when source index is
 missing (#50176)

This commit fixes a bug that caused the data frame analytics
_explain API to time out in a multi-node setup when the source
index was missing. When we try to create the extracted fields detector,
we check the index settings. If the index is missing that responds
with a failure that could be wrapped as a remote exception.
While we unwrapped correctly to check if the cause was an
`IndexNotFoundException`, we then proceeded to cast the original
exception instead of the cause.
---
 .../ml/integration/ExplainDataFrameAnalyticsIT.java | 13 +++++++++++++
 .../extractor/ExtractedFieldsDetectorFactory.java   |  5 +++--
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
index ba00e49456f5f..32ee2d28c865e 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.ml.integration;
 
+import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.bulk.BulkRequestBuilder;
 import org.elasticsearch.action.bulk.BulkResponse;
 import org.elasticsearch.action.index.IndexRequest;
@@ -14,14 +15,26 @@
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsSource;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.OutlierDetection;
 import org.elasticsearch.xpack.core.ml.utils.QueryProvider;
 
 import java.io.IOException;
 
+import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.lessThanOrEqualTo;
 
 public class ExplainDataFrameAnalyticsIT extends MlNativeDataFrameAnalyticsIntegTestCase {
 
+    public void testExplain_GivenMissingSourceIndex() {
+        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
+            .setSource(new DataFrameAnalyticsSource(new String[] {"missing_index"}, null, null))
+            .setAnalysis(new OutlierDetection.Builder().build())
+            .buildForExplain();
+
+        ResourceNotFoundException e = expectThrows(ResourceNotFoundException.class, () -> explainDataFrame(config));
+        assertThat(e.getMessage(), equalTo("cannot retrieve data because index [missing_index] does not exist"));
+    }
+
     public void testSourceQueryIsApplied() throws IOException {
         // To test the source query is applied when we extract data,
         // we set up a job where we have a query which excludes all but one document.
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
index 8e6ad7a614b09..c44555921cf38 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
@@ -171,9 +171,10 @@ private void getDocValueFieldsLimit(String[] index, ActionListener<Integer> docV
                 docValueFieldsLimitListener.onResponse(minDocValueFieldsLimit);
             },
             e -> {
-                if (ExceptionsHelper.unwrapCause(e) instanceof IndexNotFoundException) {
+                Throwable cause = ExceptionsHelper.unwrapCause(e);
+                if (cause instanceof IndexNotFoundException) {
                     docValueFieldsLimitListener.onFailure(new ResourceNotFoundException("cannot retrieve data because index "
-                        + ((IndexNotFoundException) e).getIndex() + " does not exist"));
+                        + ((IndexNotFoundException) cause).getIndex() + " does not exist"));
                 } else {
                     docValueFieldsLimitListener.onFailure(e);
                 }

From fdf820d3badebc487170d5d874ea11055fac2373 Mon Sep 17 00:00:00 2001
From: Ioannis Kakavas <ioannis@elastic.co>
Date: Fri, 13 Dec 2019 16:16:54 +0200
Subject: [PATCH 200/686] Replace health calls with authenticate calls (#50073)

In integration tests for API Keys and Tokens, we would use calls
we did with the transport client to the cluster health endpoint
after adding the API key or Token with `filterWithHeader()` in
order to verify that the API Key or Token is valid.
The response would always be successful regardless of the
validity of the Token or API Key since the internal request would
have the `_system` user as a fallback user and the `_system` is
allowed to call the health API. When failing to validate the
token or key, we would fallback to the `_system` user,
see AuthenticationService#handleNullToken

This commit changes our behavior to use the RestClient and call the
authenticate API to verify the validity of tokens and API keys.
---
 .../security/authc/ApiKeyIntegTests.java      | 23 +++++++++++-------
 .../security/authc/TokenAuthIntegTests.java   | 24 +++++++++----------
 2 files changed, 26 insertions(+), 21 deletions(-)

diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ApiKeyIntegTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ApiKeyIntegTests.java
index 09e2114a8f0c4..e15b5d7d3d00d 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ApiKeyIntegTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ApiKeyIntegTests.java
@@ -9,12 +9,14 @@
 import com.google.common.collect.Sets;
 import org.elasticsearch.ElasticsearchSecurityException;
 import org.elasticsearch.action.DocWriteResponse;
-import org.elasticsearch.action.admin.cluster.health.ClusterHealthResponse;
 import org.elasticsearch.action.admin.indices.refresh.RefreshResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.action.update.UpdateResponse;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.client.RequestOptions;
+import org.elasticsearch.client.RestHighLevelClient;
+import org.elasticsearch.client.security.AuthenticateResponse;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
@@ -77,6 +79,11 @@ public Settings nodeSettings(int nodeOrdinal) {
             .build();
     }
 
+    @Override
+    protected boolean addMockHttpTransport() {
+        return false; // need real http
+    }
+
     @Before
     public void waitForSecurityIndexWritable() throws Exception {
         assertSecurityIndexActive();
@@ -125,7 +132,7 @@ private void awaitApiKeysRemoverCompletion() throws Exception {
     }
 
     @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/47958")
-    public void testCreateApiKey() {
+    public void testCreateApiKey() throws Exception{
         final Instant start = Instant.now();
         final RoleDescriptor descriptor = new RoleDescriptor("role", new String[] { "monitor" }, null, null);
         Client client = client().filterWithHeader(Collections.singletonMap("Authorization",
@@ -155,13 +162,11 @@ public void testCreateApiKey() {
         // use the first ApiKey for authorized action
         final String base64ApiKeyKeyValue = Base64.getEncoder().encodeToString(
             (response.getId() + ":" + response.getKey().toString()).getBytes(StandardCharsets.UTF_8));
-        ClusterHealthResponse healthResponse = client()
-            .filterWithHeader(Collections.singletonMap("Authorization", "ApiKey " + base64ApiKeyKeyValue))
-            .admin()
-            .cluster()
-            .prepareHealth()
-            .get();
-        assertFalse(healthResponse.isTimedOut());
+        // Assert that we can authenticate with the API KEY
+        final RestHighLevelClient restClient = new TestRestHighLevelClient();
+        AuthenticateResponse authResponse = restClient.security().authenticate(RequestOptions.DEFAULT.toBuilder().addHeader("Authorization",
+            "ApiKey " + base64ApiKeyKeyValue).build());
+        assertThat(authResponse.getUser().getUsername(), equalTo(SecuritySettingsSource.TEST_SUPERUSER));
 
         // use the first ApiKey for an unauthorized action
         ElasticsearchSecurityException e = expectThrows(ElasticsearchSecurityException.class, () ->
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
index d56365a21a403..8900607efef55 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
@@ -55,7 +55,6 @@
 import java.util.stream.Collectors;
 
 import static org.elasticsearch.test.SecuritySettingsSource.SECURITY_REQUEST_OPTIONS;
-import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertNoTimeout;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 
@@ -256,19 +255,20 @@ public void testRefreshingToken() throws IOException {
         CreateTokenResponse response = restClient.security().createToken(CreateTokenRequest.passwordGrant(
             SecuritySettingsSource.TEST_USER_NAME, SecuritySettingsSourceField.TEST_PASSWORD.toCharArray()), SECURITY_REQUEST_OPTIONS);
         assertNotNull(response.getRefreshToken());
-        // get cluster health with token
-        assertNoTimeout(client()
-                .filterWithHeader(Collections.singletonMap("Authorization", "Bearer " + response.getAccessToken()))
-                .admin().cluster().prepareHealth().get());
-
+        // Assert that we can authenticate with the access token
+        AuthenticateResponse authResponse = restClient.security().authenticate(RequestOptions.DEFAULT.toBuilder().addHeader("Authorization",
+            "Bearer " + response.getAccessToken()).build());
+        assertThat(authResponse.getUser().getUsername(), equalTo(SecuritySettingsSource.TEST_USER_NAME));
         CreateTokenResponse refreshResponse = restClient.security()
             .createToken(CreateTokenRequest.refreshTokenGrant(response.getRefreshToken()), SECURITY_REQUEST_OPTIONS);
         assertNotNull(refreshResponse.getRefreshToken());
         assertNotEquals(refreshResponse.getRefreshToken(), response.getRefreshToken());
         assertNotEquals(refreshResponse.getAccessToken(), response.getAccessToken());
 
-        assertNoTimeout(client().filterWithHeader(Collections.singletonMap("Authorization", "Bearer " + refreshResponse.getAccessToken()))
-                .admin().cluster().prepareHealth().get());
+        // Assert that we can authenticate with the refreshed access token
+        authResponse = restClient.security().authenticate(RequestOptions.DEFAULT.toBuilder().addHeader("Authorization",
+            "Bearer " + refreshResponse.getAccessToken()).build());
+        assertThat(authResponse.getUser().getUsername(), equalTo(SecuritySettingsSource.TEST_USER_NAME));
     }
 
     public void testRefreshingInvalidatedToken() throws IOException {
@@ -466,10 +466,10 @@ public void testAuthenticateWithWrongToken() throws Exception {
         CreateTokenResponse response = restClient.security().createToken(CreateTokenRequest.passwordGrant(
             SecuritySettingsSource.TEST_USER_NAME, SecuritySettingsSourceField.TEST_PASSWORD.toCharArray()), SECURITY_REQUEST_OPTIONS);
         assertNotNull(response.getRefreshToken());
-        // First check that the correct access token works by getting cluster health with token
-        assertNoTimeout(client()
-            .filterWithHeader(Collections.singletonMap("Authorization", "Bearer " + response.getAccessToken()))
-            .admin().cluster().prepareHealth().get());
+        // Assert that we can authenticate with the access token
+        AuthenticateResponse authResponse = restClient.security().authenticate(RequestOptions.DEFAULT.toBuilder().addHeader("Authorization",
+            "Bearer " + response.getAccessToken()).build());
+        assertThat(authResponse.getUser().getUsername(), equalTo(SecuritySettingsSource.TEST_USER_NAME));
         // Now attempt to authenticate with an invalid access token string
         RequestOptions wrongAuthOptions =
             RequestOptions.DEFAULT.toBuilder().addHeader("Authorization", "Bearer " + randomAlphaOfLengthBetween(0, 128)).build();

From 1c2b08347065d4a50591d3fe4b1c5e5b29e08930 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Fri, 13 Dec 2019 09:45:10 -0500
Subject: [PATCH 201/686] [ML] retry bulk indexing of state docs (#50149)

This exchanges the direct use of the `Client` for `ResultsPersisterService`. State doc persistence will now retry. Failures to persist state will still not throw, but will be audited and logged.
---
 .../xpack/ml/MachineLearning.java             | 14 ++++++---
 .../NativeAnalyticsProcessFactory.java        | 19 ++++++++----
 .../NativeAutodetectProcessFactory.java       | 19 ++++++++----
 .../ml/process/IndexingStateProcessor.java    | 28 ++++++++++++-----
 .../NativeAutodetectProcessFactoryTests.java  | 15 +++++++---
 .../process/IndexingStateProcessorTests.java  | 30 ++++++++-----------
 6 files changed, 80 insertions(+), 45 deletions(-)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
index a7b21bbd721ad..5216cf6a267fc 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
@@ -559,11 +559,17 @@ public Collection<Object> createComponents(Client client, ClusterService cluster
                     environment,
                     settings,
                     nativeController,
-                    client,
-                    clusterService);
+                    clusterService,
+                    resultsPersisterService,
+                    anomalyDetectionAuditor);
                 normalizerProcessFactory = new NativeNormalizerProcessFactory(environment, nativeController, clusterService);
-                analyticsProcessFactory = new NativeAnalyticsProcessFactory(environment, client, nativeController, clusterService,
-                    xContentRegistry);
+                analyticsProcessFactory = new NativeAnalyticsProcessFactory(
+                    environment,
+                    nativeController,
+                    clusterService,
+                    xContentRegistry,
+                    resultsPersisterService,
+                    dataFrameAnalyticsAuditor);
                 memoryEstimationProcessFactory =
                     new NativeMemoryUsageEstimationProcessFactory(environment, nativeController, clusterService);
                 mlController = nativeController;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcessFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcessFactory.java
index 1bd02add2f4ce..d2ace11f553ae 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcessFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcessFactory.java
@@ -7,7 +7,6 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.bytes.BytesReference;
@@ -20,10 +19,12 @@
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 import org.elasticsearch.xpack.ml.MachineLearning;
 import org.elasticsearch.xpack.ml.dataframe.process.results.AnalyticsResult;
+import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
 import org.elasticsearch.xpack.ml.process.IndexingStateProcessor;
 import org.elasticsearch.xpack.ml.process.NativeController;
 import org.elasticsearch.xpack.ml.process.ProcessPipes;
 import org.elasticsearch.xpack.ml.utils.NamedPipeHelper;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 
 import java.io.IOException;
 import java.nio.file.Path;
@@ -40,18 +41,24 @@ public class NativeAnalyticsProcessFactory implements AnalyticsProcessFactory<An
 
     private static final NamedPipeHelper NAMED_PIPE_HELPER = new NamedPipeHelper();
 
-    private final Client client;
     private final Environment env;
     private final NativeController nativeController;
     private final NamedXContentRegistry namedXContentRegistry;
+    private final ResultsPersisterService resultsPersisterService;
+    private final DataFrameAnalyticsAuditor auditor;
     private volatile Duration processConnectTimeout;
 
-    public NativeAnalyticsProcessFactory(Environment env, Client client, NativeController nativeController, ClusterService clusterService,
-                                         NamedXContentRegistry namedXContentRegistry) {
+    public NativeAnalyticsProcessFactory(Environment env,
+                                         NativeController nativeController,
+                                         ClusterService clusterService,
+                                         NamedXContentRegistry namedXContentRegistry,
+                                         ResultsPersisterService resultsPersisterService,
+                                         DataFrameAnalyticsAuditor auditor) {
         this.env = Objects.requireNonNull(env);
-        this.client = Objects.requireNonNull(client);
         this.nativeController = Objects.requireNonNull(nativeController);
         this.namedXContentRegistry = Objects.requireNonNull(namedXContentRegistry);
+        this.auditor = auditor;
+        this.resultsPersisterService = resultsPersisterService;
         setProcessConnectTimeout(MachineLearning.PROCESS_CONNECT_TIMEOUT.get(env.settings()));
         clusterService.getClusterSettings().addSettingsUpdateConsumer(MachineLearning.PROCESS_CONNECT_TIMEOUT,
             this::setProcessConnectTimeout);
@@ -96,7 +103,7 @@ public NativeAnalyticsProcess createAnalyticsProcess(DataFrameAnalyticsConfig co
     private void startProcess(DataFrameAnalyticsConfig config, ExecutorService executorService, ProcessPipes processPipes,
                                                 NativeAnalyticsProcess process) {
         if (config.getAnalysis().persistsState()) {
-            IndexingStateProcessor stateProcessor = new IndexingStateProcessor(client, config.getId());
+            IndexingStateProcessor stateProcessor = new IndexingStateProcessor(config.getId(), resultsPersisterService, auditor);
             process.start(executorService, stateProcessor, processPipes.getPersistStream().get());
         } else {
             process.start(executorService);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactory.java
index 1bf8c4c3855ff..2504439a220e7 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactory.java
@@ -7,7 +7,6 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
@@ -20,11 +19,13 @@
 import org.elasticsearch.xpack.ml.MachineLearning;
 import org.elasticsearch.xpack.ml.job.process.autodetect.params.AutodetectParams;
 import org.elasticsearch.xpack.ml.job.results.AutodetectResult;
+import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
 import org.elasticsearch.xpack.ml.process.IndexingStateProcessor;
 import org.elasticsearch.xpack.ml.process.NativeController;
 import org.elasticsearch.xpack.ml.process.ProcessPipes;
 import org.elasticsearch.xpack.ml.process.ProcessResultsParser;
 import org.elasticsearch.xpack.ml.utils.NamedPipeHelper;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 
 import java.io.IOException;
 import java.nio.file.Path;
@@ -40,20 +41,26 @@ public class NativeAutodetectProcessFactory implements AutodetectProcessFactory
     private static final Logger LOGGER = LogManager.getLogger(NativeAutodetectProcessFactory.class);
     private static final NamedPipeHelper NAMED_PIPE_HELPER = new NamedPipeHelper();
 
-    private final Client client;
     private final Environment env;
     private final Settings settings;
     private final NativeController nativeController;
     private final ClusterService clusterService;
+    private final ResultsPersisterService resultsPersisterService;
+    private final AnomalyDetectionAuditor auditor;
     private volatile Duration processConnectTimeout;
 
-    public NativeAutodetectProcessFactory(Environment env, Settings settings, NativeController nativeController, Client client,
-                                          ClusterService clusterService) {
+    public NativeAutodetectProcessFactory(Environment env,
+                                          Settings settings,
+                                          NativeController nativeController,
+                                          ClusterService clusterService,
+                                          ResultsPersisterService resultsPersisterService,
+                                          AnomalyDetectionAuditor auditor) {
         this.env = Objects.requireNonNull(env);
         this.settings = Objects.requireNonNull(settings);
         this.nativeController = Objects.requireNonNull(nativeController);
-        this.client = client;
         this.clusterService = clusterService;
+        this.resultsPersisterService = resultsPersisterService;
+        this.auditor = auditor;
         setProcessConnectTimeout(MachineLearning.PROCESS_CONNECT_TIMEOUT.get(settings));
         clusterService.getClusterSettings().addSettingsUpdateConsumer(MachineLearning.PROCESS_CONNECT_TIMEOUT,
             this::setProcessConnectTimeout);
@@ -78,7 +85,7 @@ public AutodetectProcess createAutodetectProcess(Job job,
         // The extra 1 is the control field
         int numberOfFields = job.allInputFields().size() + (includeTokensField ? 1 : 0) + 1;
 
-        IndexingStateProcessor stateProcessor = new IndexingStateProcessor(client, job.getId());
+        IndexingStateProcessor stateProcessor = new IndexingStateProcessor(job.getId(), resultsPersisterService, auditor);
         ProcessResultsParser<AutodetectResult> resultsParser = new ProcessResultsParser<>(AutodetectResult.PARSER,
             NamedXContentRegistry.EMPTY);
         NativeAutodetectProcess autodetect = new NativeAutodetectProcess(
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/process/IndexingStateProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/process/IndexingStateProcessor.java
index 9bfd22500e02f..b3067dff993a7 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/process/IndexingStateProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/process/IndexingStateProcessor.java
@@ -7,21 +7,22 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.elasticsearch.action.bulk.BulkRequest;
-import org.elasticsearch.client.Client;
 import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.bytes.CompositeBytesReference;
-import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.xpack.core.common.notifications.AbstractAuditMessage;
+import org.elasticsearch.xpack.core.common.notifications.AbstractAuditor;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 
 import java.io.IOException;
 import java.io.InputStream;
 import java.util.ArrayList;
 import java.util.List;
 
-import static org.elasticsearch.xpack.core.ClientHelper.ML_ORIGIN;
 
 /**
  * Reads state documents of a stream, splits them and persists to an index via a bulk request
@@ -32,12 +33,16 @@ public class IndexingStateProcessor implements StateProcessor {
 
     private static final int READ_BUF_SIZE = 8192;
 
-    private final Client client;
     private final String jobId;
+    private final AbstractAuditor<? extends AbstractAuditMessage> auditor;
+    private final ResultsPersisterService resultsPersisterService;
 
-    public IndexingStateProcessor(Client client, String jobId) {
-        this.client = client;
+    public IndexingStateProcessor(String jobId,
+                                  ResultsPersisterService resultsPersisterService,
+                                  AbstractAuditor<? extends AbstractAuditMessage> auditor) {
         this.jobId = jobId;
+        this.resultsPersisterService = resultsPersisterService;
+        this.auditor = auditor;
     }
 
     @Override
@@ -98,8 +103,15 @@ void persist(BytesReference bytes) throws IOException {
         bulkRequest.add(bytes, AnomalyDetectorsIndex.jobStateIndexWriteAlias(), XContentType.JSON);
         if (bulkRequest.numberOfActions() > 0) {
             LOGGER.trace("[{}] Persisting job state document", jobId);
-            try (ThreadContext.StoredContext ignore = client.threadPool().getThreadContext().stashWithOrigin(ML_ORIGIN)) {
-                client.bulk(bulkRequest).actionGet();
+            try {
+                resultsPersisterService.bulkIndexWithRetry(bulkRequest,
+                    jobId,
+                    () -> true,
+                    (msg) -> auditor.warning(jobId, "Bulk indexing of state failed " + msg));
+            } catch (Exception ex) {
+                String msg = "failed indexing updated state docs";
+                LOGGER.error(() -> new ParameterizedMessage("[{}] {}", jobId, msg), ex);
+                auditor.error(jobId, msg + " error: " + ex.getMessage());
             }
         }
     }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactoryTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactoryTests.java
index f486823be7b40..d20533fca15f2 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactoryTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactoryTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.ml.job.process.autodetect;
 
-import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
@@ -16,8 +15,10 @@
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.ml.MachineLearning;
 import org.elasticsearch.xpack.ml.job.process.autodetect.params.AutodetectParams;
+import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
 import org.elasticsearch.xpack.ml.process.NativeController;
 import org.elasticsearch.xpack.ml.process.ProcessPipes;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 
 import java.io.IOException;
 import java.time.Duration;
@@ -41,7 +42,8 @@ public void testSetProcessConnectTimeout() throws IOException {
             .build();
         Environment env = TestEnvironment.newEnvironment(settings);
         NativeController nativeController = mock(NativeController.class);
-        Client client = mock(Client.class);
+        ResultsPersisterService resultsPersisterService = mock(ResultsPersisterService.class);
+        AnomalyDetectionAuditor anomalyDetectionAuditor = mock(AnomalyDetectionAuditor.class);
         ClusterSettings clusterSettings = new ClusterSettings(settings,
             Set.of(MachineLearning.PROCESS_CONNECT_TIMEOUT, AutodetectBuilder.MAX_ANOMALY_RECORDS_SETTING_DYNAMIC));
         ClusterService clusterService = mock(ClusterService.class);
@@ -51,8 +53,13 @@ public void testSetProcessConnectTimeout() throws IOException {
         AutodetectParams autodetectParams = mock(AutodetectParams.class);
         ProcessPipes processPipes = mock(ProcessPipes.class);
 
-        NativeAutodetectProcessFactory nativeAutodetectProcessFactory =
-            new NativeAutodetectProcessFactory(env, settings, nativeController, client, clusterService);
+        NativeAutodetectProcessFactory nativeAutodetectProcessFactory = new NativeAutodetectProcessFactory(
+            env,
+            settings,
+            nativeController,
+            clusterService,
+            resultsPersisterService,
+            anomalyDetectionAuditor);
         nativeAutodetectProcessFactory.setProcessConnectTimeout(TimeValue.timeValueSeconds(timeoutSeconds));
         nativeAutodetectProcessFactory.createNativeProcess(job, autodetectParams, processPipes, Collections.emptyList());
 
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/IndexingStateProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/IndexingStateProcessorTests.java
index f574782746c25..f65649c9ee1cc 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/IndexingStateProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/IndexingStateProcessorTests.java
@@ -6,16 +6,16 @@
 package org.elasticsearch.xpack.ml.process;
 
 import com.carrotsearch.randomizedtesting.annotations.Timeout;
-import org.elasticsearch.action.ActionFuture;
 import org.elasticsearch.action.bulk.BulkRequest;
 import org.elasticsearch.action.bulk.BulkResponse;
-import org.elasticsearch.client.Client;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.mock.orig.Mockito;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
+import org.elasticsearch.xpack.ml.utils.persistence.ResultsPersisterService;
 import org.junit.After;
 import org.junit.Before;
 import org.mockito.ArgumentCaptor;
@@ -54,24 +54,22 @@ public class IndexingStateProcessorTests extends ESTestCase {
     private static final int NUM_LARGE_DOCS = 2;
     private static final int LARGE_DOC_SIZE = 1000000;
 
-    private Client client;
     private IndexingStateProcessor stateProcessor;
+    private ResultsPersisterService resultsPersisterService;
 
     @Before
-    public void initialize() throws IOException {
-        client = mock(Client.class);
-        @SuppressWarnings("unchecked")
-        ActionFuture<BulkResponse> bulkResponseFuture = mock(ActionFuture.class);
-        stateProcessor = spy(new IndexingStateProcessor(client, JOB_ID));
-        when(client.bulk(any(BulkRequest.class))).thenReturn(bulkResponseFuture);
+    public void initialize() {
+        resultsPersisterService = mock(ResultsPersisterService.class);
+        AnomalyDetectionAuditor auditor = mock(AnomalyDetectionAuditor.class);
+        stateProcessor = spy(new IndexingStateProcessor(JOB_ID, resultsPersisterService, auditor));
+        when(resultsPersisterService.bulkIndexWithRetry(any(BulkRequest.class), any(), any(), any())).thenReturn(mock(BulkResponse.class));
         ThreadPool threadPool = mock(ThreadPool.class);
-        when(client.threadPool()).thenReturn(threadPool);
         when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
     }
 
     @After
     public void verifyNoMoreClientInteractions() {
-        Mockito.verifyNoMoreInteractions(client);
+        Mockito.verifyNoMoreInteractions(resultsPersisterService);
     }
 
     public void testStateRead() throws IOException {
@@ -85,8 +83,7 @@ public void testStateRead() throws IOException {
         assertEquals(threeStates[0], capturedBytes.get(0).utf8ToString());
         assertEquals(threeStates[1], capturedBytes.get(1).utf8ToString());
         assertEquals(threeStates[2], capturedBytes.get(2).utf8ToString());
-        verify(client, times(3)).bulk(any(BulkRequest.class));
-        verify(client, times(3)).threadPool();
+        verify(resultsPersisterService, times(3)).bulkIndexWithRetry(any(BulkRequest.class), any(), any(), any());
     }
 
     public void testStateReadGivenConsecutiveZeroBytes() throws IOException {
@@ -96,7 +93,7 @@ public void testStateReadGivenConsecutiveZeroBytes() throws IOException {
         stateProcessor.process(stream);
 
         verify(stateProcessor, never()).persist(any());
-        Mockito.verifyNoMoreInteractions(client);
+        Mockito.verifyNoMoreInteractions(resultsPersisterService);
     }
 
     public void testStateReadGivenConsecutiveSpacesFollowedByZeroByte() throws IOException {
@@ -106,7 +103,7 @@ public void testStateReadGivenConsecutiveSpacesFollowedByZeroByte() throws IOExc
         stateProcessor.process(stream);
 
         verify(stateProcessor, times(1)).persist(any());
-        Mockito.verifyNoMoreInteractions(client);
+        Mockito.verifyNoMoreInteractions(resultsPersisterService);
     }
 
     /**
@@ -128,7 +125,6 @@ public void testLargeStateRead() throws Exception {
         ByteArrayInputStream stream = new ByteArrayInputStream(builder.toString().getBytes(StandardCharsets.UTF_8));
         stateProcessor.process(stream);
         verify(stateProcessor, times(NUM_LARGE_DOCS)).persist(any());
-        verify(client, times(NUM_LARGE_DOCS)).bulk(any(BulkRequest.class));
-        verify(client, times(NUM_LARGE_DOCS)).threadPool();
+        verify(resultsPersisterService, times(NUM_LARGE_DOCS)).bulkIndexWithRetry(any(BulkRequest.class), any(), any(), any());
     }
 }

From b8fe69ca3844766bcfe4ffaa1884b4f95599aa64 Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Fri, 13 Dec 2019 09:16:53 -0700
Subject: [PATCH 202/686] Update remote cluster stats to support simple mode
 (#49961)

Remote cluster stats API currently only returns useful information if
the strategy in use is the SNIFF mode. This PR modifies the API to
provide relevant information if the user is in the SIMPLE mode. This
information is the configured addresses, max socket connections, and
open socket connections.
---
 docs/reference/ccr/getting-started.asciidoc   |   5 +-
 ...l => 15_connection_mode_configuration.yml} |   0
 .../test/multi_cluster/20_info.yml            |  47 +++++++-
 .../transport/RemoteClusterConnection.java    |  20 +---
 .../transport/RemoteConnectionInfo.java       | 109 +++++++++---------
 .../transport/RemoteConnectionStrategy.java   |  28 ++++-
 .../transport/SimpleConnectionStrategy.java   |  84 ++++++++++++++
 .../transport/SniffConnectionStrategy.java    |  81 +++++++++++++
 .../RemoteClusterConnectionTests.java         |  77 ++++++++-----
 .../RemoteConnectionStrategyTests.java        |   5 +
 .../xpack/CcrSingleNodeTestCase.java          |   2 +-
 .../xpack/ccr/RestartIndexFollowingIT.java    |   3 +-
 12 files changed, 344 insertions(+), 117 deletions(-)
 rename qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/{100_connection_mode_configuration.yml => 15_connection_mode_configuration.yml} (100%)

diff --git a/docs/reference/ccr/getting-started.asciidoc b/docs/reference/ccr/getting-started.asciidoc
index 41d013f62f3a7..0793051646cfe 100644
--- a/docs/reference/ccr/getting-started.asciidoc
+++ b/docs/reference/ccr/getting-started.asciidoc
@@ -135,7 +135,8 @@ remote cluster.
     "num_nodes_connected" : 1, <2>
     "max_connections_per_cluster" : 3,
     "initial_connect_timeout" : "30s",
-    "skip_unavailable" : false
+    "skip_unavailable" : false,
+    "mode" : "sniff"
   }
 }
 --------------------------------------------------
@@ -146,7 +147,7 @@ remote cluster.
     alias `leader`
 <2> This shows the number of nodes in the remote cluster the local cluster is
     connected to.
-    
+
 Alternatively, you can manage remote clusters on the
 *Management / Elasticsearch / Remote Clusters* page in {kib}:
 
diff --git a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/100_connection_mode_configuration.yml b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml
similarity index 100%
rename from qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/100_connection_mode_configuration.yml
rename to qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml
diff --git a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
index 59657e2012c8a..761526a7bea60 100644
--- a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
+++ b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
@@ -1,5 +1,5 @@
 ---
-"Fetch remote cluster info for existing cluster":
+"Fetch remote cluster sniff info for existing cluster":
 
   - do:
       cluster.remote_info: {}
@@ -7,6 +7,7 @@
   - match: { my_remote_cluster.num_nodes_connected: 1}
   - match: { my_remote_cluster.max_connections_per_cluster: 1}
   - match: { my_remote_cluster.initial_connect_timeout: "30s" }
+  - match: { my_remote_cluster.mode: "sniff" }
 
 ---
 "Add transient remote cluster based on the preset cluster and check remote info":
@@ -21,9 +22,13 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "sniff"
+            cluster.remote.test_remote_cluster.sniff.node_connections: "2"
+            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
 
-  - match: {transient: {cluster.remote.test_remote_cluster.seeds: $remote_ip}}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "sniff"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.node_connections: "2"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.seeds: $remote_ip}
 
   # we do another search here since this will enforce the connection to be established
   # otherwise the cluster might not have been connected yet.
@@ -45,19 +50,49 @@
   - match: { my_remote_cluster.seeds.0: $remote_ip }
 
   - match: { my_remote_cluster.num_nodes_connected: 1}
-  - match: { test_remote_cluster.num_nodes_connected: 1}
+  - gt:    { test_remote_cluster.num_nodes_connected: 0}
 
   - match: { my_remote_cluster.max_connections_per_cluster: 1}
-  - match: { test_remote_cluster.max_connections_per_cluster: 1}
+  - match: { test_remote_cluster.max_connections_per_cluster: 2}
 
   - match: { my_remote_cluster.initial_connect_timeout: "30s" }
   - match: { test_remote_cluster.initial_connect_timeout: "30s" }
 
+  - match: { my_remote_cluster.mode: "sniff" }
+  - match: { test_remote_cluster.mode: "sniff" }
+
+  - do:
+      cluster.put_settings:
+        flat_settings: true
+        body:
+          transient:
+            cluster.remote.test_remote_cluster.mode: "simple"
+            cluster.remote.test_remote_cluster.sniff.seeds: null
+            cluster.remote.test_remote_cluster.sniff.node_connections: null
+            cluster.remote.test_remote_cluster.simple.socket_connections: "10"
+            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+
+  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "simple"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.socket_connections: "10"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.addresses: $remote_ip}
+
+  - do:
+      cluster.remote_info: {}
+
+  - match: { test_remote_cluster.connected: true }
+  - match: { test_remote_cluster.addresses.0: $remote_ip }
+  - gt:    { test_remote_cluster.num_sockets_connected: 0}
+  - match: { test_remote_cluster.max_socket_connections: 10}
+  - match: { test_remote_cluster.initial_connect_timeout: "30s" }
+  - match: { test_remote_cluster.mode: "simple" }
+
   - do:
       cluster.put_settings:
         body:
           transient:
-            cluster.remote.test_remote_cluster.seeds: null
+            cluster.remote.test_remote_cluster.mode: null
+            cluster.remote.test_remote_cluster.simple.socket_connections: null
+            cluster.remote.test_remote_cluster.simple.addresses: null
 
 ---
 "skip_unavailable is returned as part of _remote/info response":
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteClusterConnection.java b/server/src/main/java/org/elasticsearch/transport/RemoteClusterConnection.java
index 8b89e8f8f8905..ae697bba95b49 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteClusterConnection.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteClusterConnection.java
@@ -34,7 +34,6 @@
 
 import java.io.Closeable;
 import java.io.IOException;
-import java.util.Collections;
 import java.util.function.Function;
 
 /**
@@ -206,24 +205,7 @@ boolean isNodeConnected(final DiscoveryNode node) {
      * Get the information about remote nodes to be rendered on {@code _remote/info} requests.
      */
     public RemoteConnectionInfo getConnectionInfo() {
-        if (connectionStrategy instanceof SniffConnectionStrategy) {
-            SniffConnectionStrategy sniffStrategy = (SniffConnectionStrategy) this.connectionStrategy;
-            return new RemoteConnectionInfo(
-                clusterAlias,
-                sniffStrategy.getSeedNodes(),
-                sniffStrategy.getMaxConnections(),
-                getNumNodesConnected(),
-                initialConnectionTimeout,
-                skipUnavailable);
-        } else {
-            return new RemoteConnectionInfo(
-                clusterAlias,
-                Collections.emptyList(),
-                0,
-                getNumNodesConnected(),
-                initialConnectionTimeout,
-                skipUnavailable);
-        }
+        return new RemoteConnectionInfo(clusterAlias, connectionStrategy.getModeInfo(), initialConnectionTimeout, skipUnavailable);
     }
 
     int getNumNodesConnected() {
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
index 5bdc6f9874330..e721a0b617fd1 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.transport;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -36,63 +37,67 @@
  * {@code _remote/info} requests.
  */
 public final class RemoteConnectionInfo implements ToXContentFragment, Writeable {
-    final List<String> seedNodes;
-    final int connectionsPerCluster;
+
+    final ModeInfo modeInfo;
     final TimeValue initialConnectionTimeout;
-    final int numNodesConnected;
     final String clusterAlias;
     final boolean skipUnavailable;
 
-    RemoteConnectionInfo(String clusterAlias, List<String> seedNodes,
-                         int connectionsPerCluster, int numNodesConnected,
-                         TimeValue initialConnectionTimeout, boolean skipUnavailable) {
+    RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
         this.clusterAlias = clusterAlias;
-        this.seedNodes = seedNodes;
-        this.connectionsPerCluster = connectionsPerCluster;
-        this.numNodesConnected = numNodesConnected;
+        this.modeInfo = modeInfo;
         this.initialConnectionTimeout = initialConnectionTimeout;
         this.skipUnavailable = skipUnavailable;
     }
 
     public RemoteConnectionInfo(StreamInput input) throws IOException {
-        seedNodes = Arrays.asList(input.readStringArray());
-        connectionsPerCluster = input.readVInt();
-        initialConnectionTimeout = input.readTimeValue();
-        numNodesConnected = input.readVInt();
-        clusterAlias = input.readString();
-        skipUnavailable = input.readBoolean();
-    }
-
-    public List<String> getSeedNodes() {
-        return seedNodes;
-    }
-
-    public int getConnectionsPerCluster() {
-        return connectionsPerCluster;
-    }
-
-    public TimeValue getInitialConnectionTimeout() {
-        return initialConnectionTimeout;
+        // TODO: Change to 7.6 after backport
+        if (input.getVersion().onOrAfter(Version.V_8_0_0)) {
+            RemoteConnectionStrategy.ConnectionStrategy mode = input.readEnum(RemoteConnectionStrategy.ConnectionStrategy.class);
+            modeInfo = mode.getReader().read(input);
+            initialConnectionTimeout = input.readTimeValue();
+            clusterAlias = input.readString();
+            skipUnavailable = input.readBoolean();
+        } else {
+            List<String> seedNodes = Arrays.asList(input.readStringArray());
+            int connectionsPerCluster = input.readVInt();
+            initialConnectionTimeout = input.readTimeValue();
+            int numNodesConnected = input.readVInt();
+            clusterAlias = input.readString();
+            skipUnavailable = input.readBoolean();
+            modeInfo = new SniffConnectionStrategy.SniffModeInfo(seedNodes, connectionsPerCluster, numNodesConnected);
+        }
     }
 
-    public int getNumNodesConnected() {
-        return numNodesConnected;
+    public boolean isConnected() {
+        return modeInfo.isConnected();
     }
 
     public String getClusterAlias() {
         return clusterAlias;
     }
 
-    public boolean isSkipUnavailable() {
-        return skipUnavailable;
-    }
-
     @Override
     public void writeTo(StreamOutput out) throws IOException {
-        out.writeStringArray(seedNodes.toArray(new String[0]));
-        out.writeVInt(connectionsPerCluster);
-        out.writeTimeValue(initialConnectionTimeout);
-        out.writeVInt(numNodesConnected);
+        // TODO: Change to 7.6 after backport
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            out.writeEnum(modeInfo.modeType());
+            modeInfo.writeTo(out);
+            out.writeTimeValue(initialConnectionTimeout);
+        } else {
+            if (modeInfo.modeType() == RemoteConnectionStrategy.ConnectionStrategy.SNIFF) {
+                SniffConnectionStrategy.SniffModeInfo sniffInfo = (SniffConnectionStrategy.SniffModeInfo) this.modeInfo;
+                out.writeStringArray(sniffInfo.seedNodes.toArray(new String[0]));
+                out.writeVInt(sniffInfo.maxConnectionsPerCluster);
+                out.writeTimeValue(initialConnectionTimeout);
+                out.writeVInt(sniffInfo.numNodesConnected);
+            } else {
+                out.writeStringArray(new String[0]);
+                out.writeVInt(0);
+                out.writeTimeValue(initialConnectionTimeout);
+                out.writeVInt(0);
+            }
+        }
         out.writeString(clusterAlias);
         out.writeBoolean(skipUnavailable);
     }
@@ -101,14 +106,9 @@ public void writeTo(StreamOutput out) throws IOException {
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject(clusterAlias);
         {
-            builder.startArray("seeds");
-            for (String addr : seedNodes) {
-                builder.value(addr);
-            }
-            builder.endArray();
-            builder.field("connected", numNodesConnected > 0);
-            builder.field("num_nodes_connected", numNodesConnected);
-            builder.field("max_connections_per_cluster", connectionsPerCluster);
+            builder.field("connected", modeInfo.isConnected());
+            builder.field("mode", modeInfo.modeName());
+            modeInfo.toXContent(builder, params);
             builder.field("initial_connect_timeout", initialConnectionTimeout);
             builder.field("skip_unavailable", skipUnavailable);
         }
@@ -121,18 +121,23 @@ public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
         RemoteConnectionInfo that = (RemoteConnectionInfo) o;
-        return connectionsPerCluster == that.connectionsPerCluster &&
-            numNodesConnected == that.numNodesConnected &&
-            Objects.equals(seedNodes, that.seedNodes) &&
+        return skipUnavailable == that.skipUnavailable &&
+            Objects.equals(modeInfo, that.modeInfo) &&
             Objects.equals(initialConnectionTimeout, that.initialConnectionTimeout) &&
-            Objects.equals(clusterAlias, that.clusterAlias) &&
-            skipUnavailable == that.skipUnavailable;
+            Objects.equals(clusterAlias, that.clusterAlias);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(seedNodes, connectionsPerCluster, initialConnectionTimeout,
-                numNodesConnected, clusterAlias, skipUnavailable);
+        return Objects.hash(modeInfo, initialConnectionTimeout, clusterAlias, skipUnavailable);
     }
 
+    public interface ModeInfo extends ToXContentFragment, Writeable {
+
+        boolean isConnected();
+
+        String modeName();
+
+        RemoteConnectionStrategy.ConnectionStrategy modeType();
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
index d8a459a79a56e..3d994f35de224 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.action.support.ContextPreservingActionListener;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
@@ -57,20 +58,39 @@
 public abstract class RemoteConnectionStrategy implements TransportConnectionListener, Closeable {
 
     enum ConnectionStrategy {
-        SNIFF(SniffConnectionStrategy.CHANNELS_PER_CONNECTION, SniffConnectionStrategy::enablementSettings),
-        SIMPLE(SimpleConnectionStrategy.CHANNELS_PER_CONNECTION, SimpleConnectionStrategy::enablementSettings);
+        SNIFF(SniffConnectionStrategy.CHANNELS_PER_CONNECTION, SniffConnectionStrategy::enablementSettings,
+            SniffConnectionStrategy::infoReader) {
+            @Override
+            public String toString() {
+                return "sniff";
+            }
+        },
+        SIMPLE(SimpleConnectionStrategy.CHANNELS_PER_CONNECTION, SimpleConnectionStrategy::enablementSettings,
+            SimpleConnectionStrategy::infoReader) {
+            @Override
+            public String toString() {
+                return "simple";
+            }
+        };
 
         private final int numberOfChannels;
         private final Supplier<Stream<Setting.AffixSetting<?>>> enablementSettings;
+        private final Supplier<Writeable.Reader<RemoteConnectionInfo.ModeInfo>> reader;
 
-        ConnectionStrategy(int numberOfChannels, Supplier<Stream<Setting.AffixSetting<?>>> enablementSettings) {
+        ConnectionStrategy(int numberOfChannels, Supplier<Stream<Setting.AffixSetting<?>>> enablementSettings,
+                           Supplier<Writeable.Reader<RemoteConnectionInfo.ModeInfo>> reader) {
             this.numberOfChannels = numberOfChannels;
             this.enablementSettings = enablementSettings;
+            this.reader = reader;
         }
 
         public int getNumberOfChannels() {
             return numberOfChannels;
         }
+
+        public Writeable.Reader<RemoteConnectionInfo.ModeInfo> getReader() {
+            return reader.get();
+        }
     }
 
     public static final Setting.AffixSetting<ConnectionStrategy> REMOTE_CONNECTION_MODE = Setting.affixKeySetting(
@@ -310,6 +330,8 @@ boolean assertNoRunningConnections() {
 
     protected abstract void connectImpl(ActionListener<Void> listener);
 
+    protected abstract RemoteConnectionInfo.ModeInfo getModeInfo();
+
     private List<ActionListener<Void>> getAndClearListeners() {
         final List<ActionListener<Void>> result;
         synchronized (mutex) {
diff --git a/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
index 890cdaf25387b..0250ff73e4e8c 100644
--- a/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
@@ -26,14 +26,21 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.transport.TransportAddress;
 import org.elasticsearch.common.util.concurrent.CountDown;
+import org.elasticsearch.common.xcontent.XContentBuilder;
 
+import java.io.IOException;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashSet;
 import java.util.List;
+import java.util.Objects;
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.concurrent.atomic.AtomicLong;
@@ -131,6 +138,10 @@ static Stream<Setting.AffixSetting<?>> enablementSettings() {
         return Stream.of(SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES);
     }
 
+    static Writeable.Reader<RemoteConnectionInfo.ModeInfo> infoReader() {
+        return SimpleModeInfo::new;
+    }
+
     @Override
     protected boolean shouldOpenMoreConnections() {
         return connectionManager.size() < maxNumConnections;
@@ -153,6 +164,11 @@ protected void connectImpl(ActionListener<Void> listener) {
         performSimpleConnectionProcess(listener);
     }
 
+    @Override
+    public RemoteConnectionInfo.ModeInfo getModeInfo() {
+        return new SimpleModeInfo(configuredAddresses, maxNumConnections, connectionManager.size());
+    }
+
     private void performSimpleConnectionProcess(ActionListener<Void> listener) {
         openConnections(listener, 1);
     }
@@ -238,4 +254,72 @@ private boolean addressesChanged(final List<String> oldAddresses, final List<Str
         Set<String> newSeeds = new HashSet<>(newAddresses);
         return oldSeeds.equals(newSeeds) == false;
     }
+
+    static class SimpleModeInfo implements RemoteConnectionInfo.ModeInfo {
+
+        private final List<String> addresses;
+        private final int maxSocketConnections;
+        private final int numSocketsConnected;
+
+        SimpleModeInfo(List<String> addresses, int maxSocketConnections, int numSocketsConnected) {
+            this.addresses = addresses;
+            this.maxSocketConnections = maxSocketConnections;
+            this.numSocketsConnected = numSocketsConnected;
+        }
+
+        private SimpleModeInfo(StreamInput input) throws IOException {
+            addresses = Arrays.asList(input.readStringArray());
+            maxSocketConnections = input.readVInt();
+            numSocketsConnected = input.readVInt();
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startArray("addresses");
+            for (String address : addresses) {
+                builder.value(address);
+            }
+            builder.endArray();
+            builder.field("num_sockets_connected", numSocketsConnected);
+            builder.field("max_socket_connections", maxSocketConnections);
+            return builder;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeStringArray(addresses.toArray(new String[0]));
+            out.writeVInt(maxSocketConnections);
+            out.writeVInt(numSocketsConnected);
+        }
+
+        @Override
+        public boolean isConnected() {
+            return numSocketsConnected > 0;
+        }
+
+        @Override
+        public String modeName() {
+            return "simple";
+        }
+
+        @Override
+        public RemoteConnectionStrategy.ConnectionStrategy modeType() {
+            return RemoteConnectionStrategy.ConnectionStrategy.SIMPLE;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            SimpleModeInfo simple = (SimpleModeInfo) o;
+            return maxSocketConnections == simple.maxSocketConnections &&
+                numSocketsConnected == simple.numSocketsConnected &&
+                Objects.equals(addresses, simple.addresses);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(addresses, maxSocketConnections, numSocketsConnected);
+        }
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index cfed1d01c47e3..ad1dc6696b57c 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -36,15 +36,19 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.transport.TransportAddress;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.IOException;
 import java.net.InetSocketAddress;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashSet;
 import java.util.Iterator;
@@ -193,6 +197,10 @@ static Stream<Setting.AffixSetting<?>> enablementSettings() {
         return Stream.of(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS, SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD);
     }
 
+    static Writeable.Reader<RemoteConnectionInfo.ModeInfo> infoReader() {
+        return SniffModeInfo::new;
+    }
+
     @Override
     protected boolean shouldOpenMoreConnections() {
         return connectionManager.size() < maxNumRemoteConnections;
@@ -217,6 +225,11 @@ protected void connectImpl(ActionListener<Void> listener) {
         collectRemoteNodes(seedNodes.iterator(), listener);
     }
 
+    @Override
+    protected RemoteConnectionInfo.ModeInfo getModeInfo() {
+        return new SniffModeInfo(configuredSeedNodes, maxNumRemoteConnections, connectionManager.size());
+    }
+
     private void collectRemoteNodes(Iterator<Supplier<DiscoveryNode>> seedNodes, ActionListener<Void> listener) {
         if (Thread.currentThread().isInterrupted()) {
             listener.onFailure(new InterruptedException("remote connect thread got interrupted"));
@@ -469,4 +482,72 @@ private boolean proxyChanged(String oldProxy, String newProxy) {
 
         return Objects.equals(oldProxy, newProxy) == false;
     }
+
+    static class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
+
+        final List<String> seedNodes;
+        final int maxConnectionsPerCluster;
+        final int numNodesConnected;
+
+        SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
+            this.seedNodes = seedNodes;
+            this.maxConnectionsPerCluster = maxConnectionsPerCluster;
+            this.numNodesConnected = numNodesConnected;
+        }
+
+        private SniffModeInfo(StreamInput input) throws IOException {
+            seedNodes = Arrays.asList(input.readStringArray());
+            maxConnectionsPerCluster = input.readVInt();
+            numNodesConnected = input.readVInt();
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startArray("seeds");
+            for (String address : seedNodes) {
+                builder.value(address);
+            }
+            builder.endArray();
+            builder.field("num_nodes_connected", numNodesConnected);
+            builder.field("max_connections_per_cluster", maxConnectionsPerCluster);
+            return builder;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeStringArray(seedNodes.toArray(new String[0]));
+            out.writeVInt(maxConnectionsPerCluster);
+            out.writeVInt(numNodesConnected);
+        }
+
+        @Override
+        public boolean isConnected() {
+            return numNodesConnected > 0;
+        }
+
+        @Override
+        public String modeName() {
+            return "sniff";
+        }
+
+        @Override
+        public RemoteConnectionStrategy.ConnectionStrategy modeType() {
+            return RemoteConnectionStrategy.ConnectionStrategy.SNIFF;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            SniffModeInfo sniff = (SniffModeInfo) o;
+            return maxConnectionsPerCluster == sniff.maxConnectionsPerCluster &&
+                numNodesConnected == sniff.numNodesConnected &&
+                Objects.equals(seedNodes, sniff.seedNodes);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(seedNodes, maxConnectionsPerCluster, numNodesConnected);
+        }
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
index d74a8daa98d61..934cf81a503ea 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
@@ -324,7 +324,8 @@ public void testGetConnectionInfo() throws Exception {
             List<String> seedNodes = addresses(node3, node1, node2);
             Collections.shuffle(seedNodes, random());
 
-            try (MockTransportService service = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool, null)) {
+            try (MockTransportService service = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT,
+           threadPool, null)) {
                 service.start();
                 service.acceptIncomingRequests();
                 int maxNumConnections = randomIntBetween(1, 5);
@@ -335,9 +336,10 @@ public void testGetConnectionInfo() throws Exception {
                     // test no nodes connected
                     RemoteConnectionInfo remoteConnectionInfo = assertSerialization(connection.getConnectionInfo());
                     assertNotNull(remoteConnectionInfo);
-                    assertEquals(0, remoteConnectionInfo.numNodesConnected);
-                    assertEquals(3, remoteConnectionInfo.seedNodes.size());
-                    assertEquals(maxNumConnections, remoteConnectionInfo.connectionsPerCluster);
+                    SniffConnectionStrategy.SniffModeInfo sniffInfo = (SniffConnectionStrategy.SniffModeInfo) remoteConnectionInfo.modeInfo;
+                    assertEquals(0, sniffInfo.numNodesConnected);
+                    assertEquals(3, sniffInfo.seedNodes.size());
+                    assertEquals(maxNumConnections, sniffInfo.maxConnectionsPerCluster);
                     assertEquals(clusterAlias, remoteConnectionInfo.clusterAlias);
                 }
             }
@@ -345,32 +347,37 @@ public void testGetConnectionInfo() throws Exception {
     }
 
     public void testRemoteConnectionInfo() throws IOException {
+        List<String> remoteAddresses = Collections.singletonList("seed:1");
+
+        RemoteConnectionInfo.ModeInfo modeInfo1;
+        RemoteConnectionInfo.ModeInfo modeInfo2;
+
+        if (randomBoolean()) {
+            modeInfo1 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 4, 4);
+            modeInfo2 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 4, 3);
+        } else {
+            modeInfo1 = new SimpleConnectionStrategy.SimpleModeInfo(remoteAddresses, 18, 18);
+            modeInfo2 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 18, 17);
+        }
+
         RemoteConnectionInfo stats =
-            new RemoteConnectionInfo("test_cluster", Arrays.asList("seed:1"), 4, 3, TimeValue.timeValueMinutes(30), false);
+            new RemoteConnectionInfo("test_cluster", modeInfo1, TimeValue.timeValueMinutes(30), false);
         assertSerialization(stats);
 
         RemoteConnectionInfo stats1 =
-            new RemoteConnectionInfo("test_cluster", Arrays.asList("seed:1"), 4, 4, TimeValue.timeValueMinutes(30), true);
-        assertSerialization(stats1);
-        assertNotEquals(stats, stats1);
-
-        stats1 = new RemoteConnectionInfo("test_cluster_1", Arrays.asList("seed:1"), 4, 3, TimeValue.timeValueMinutes(30), false);
-        assertSerialization(stats1);
-        assertNotEquals(stats, stats1);
-
-        stats1 = new RemoteConnectionInfo("test_cluster", Arrays.asList("seed:15"), 4, 3, TimeValue.timeValueMinutes(30), false);
+            new RemoteConnectionInfo("test_cluster", modeInfo1, TimeValue.timeValueMinutes(30), true);
         assertSerialization(stats1);
         assertNotEquals(stats, stats1);
 
-        stats1 = new RemoteConnectionInfo("test_cluster", Arrays.asList("seed:1"), 4, 3, TimeValue.timeValueMinutes(30), true);
+        stats1 = new RemoteConnectionInfo("test_cluster_1", modeInfo1, TimeValue.timeValueMinutes(30), false);
         assertSerialization(stats1);
         assertNotEquals(stats, stats1);
 
-        stats1 = new RemoteConnectionInfo("test_cluster", Arrays.asList("seed:1"), 4, 3, TimeValue.timeValueMinutes(325), true);
+        stats1 = new RemoteConnectionInfo("test_cluster", modeInfo1, TimeValue.timeValueMinutes(325), false);
         assertSerialization(stats1);
         assertNotEquals(stats, stats1);
 
-        stats1 = new RemoteConnectionInfo("test_cluster", Arrays.asList("seed:1"), 5, 3, TimeValue.timeValueMinutes(30), false);
+        stats1 = new RemoteConnectionInfo("test_cluster", modeInfo2, TimeValue.timeValueMinutes(30), false);
         assertSerialization(stats1);
         assertNotEquals(stats, stats1);
     }
@@ -389,27 +396,33 @@ private static RemoteConnectionInfo assertSerialization(RemoteConnectionInfo inf
     }
 
     public void testRenderConnectionInfoXContent() throws IOException {
-        RemoteConnectionInfo stats =
-            new RemoteConnectionInfo("test_cluster", Arrays.asList("seed:1"), 4, 3, TimeValue.timeValueMinutes(30), true);
+        List<String> remoteAddresses = Arrays.asList("seed:1", "seed:2");
+
+        RemoteConnectionInfo.ModeInfo modeInfo;
+
+        boolean sniff = randomBoolean();
+        if (sniff) {
+            modeInfo = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 3, 2);
+        } else {
+            modeInfo = new SimpleConnectionStrategy.SimpleModeInfo(remoteAddresses, 18, 16);
+        }
+
+        RemoteConnectionInfo stats = new RemoteConnectionInfo("test_cluster", modeInfo, TimeValue.timeValueMinutes(30), true);
         stats = assertSerialization(stats);
         XContentBuilder builder = XContentFactory.jsonBuilder();
         builder.startObject();
         stats.toXContent(builder, null);
         builder.endObject();
-        assertEquals("{\"test_cluster\":{\"seeds\":[\"seed:1\"],\"connected\":true," +
-            "\"num_nodes_connected\":3,\"max_connections_per_cluster\":4,\"initial_connect_timeout\":\"30m\"," +
-            "\"skip_unavailable\":true}}", Strings.toString(builder));
 
-        stats = new RemoteConnectionInfo(
-            "some_other_cluster", Arrays.asList("seed:1", "seed:2"), 2, 0, TimeValue.timeValueSeconds(30), false);
-        stats = assertSerialization(stats);
-        builder = XContentFactory.jsonBuilder();
-        builder.startObject();
-        stats.toXContent(builder, null);
-        builder.endObject();
-        assertEquals("{\"some_other_cluster\":{\"seeds\":[\"seed:1\",\"seed:2\"],"
-            + "\"connected\":false,\"num_nodes_connected\":0,\"max_connections_per_cluster\":2,\"initial_connect_timeout\":\"30s\"," +
-            "\"skip_unavailable\":false}}", Strings.toString(builder));
+        if (sniff) {
+            assertEquals("{\"test_cluster\":{\"connected\":true,\"mode\":\"sniff\",\"seeds\":[\"seed:1\",\"seed:2\"]," +
+                "\"num_nodes_connected\":2,\"max_connections_per_cluster\":3,\"initial_connect_timeout\":\"30m\"," +
+                "\"skip_unavailable\":true}}", Strings.toString(builder));
+        } else {
+            assertEquals("{\"test_cluster\":{\"connected\":true,\"mode\":\"simple\",\"addresses\":[\"seed:1\",\"seed:2\"]," +
+                "\"num_sockets_connected\":16,\"max_socket_connections\":18,\"initial_connect_timeout\":\"30m\"," +
+                "\"skip_unavailable\":true}}", Strings.toString(builder));
+        }
     }
 
     public void testCollectNodes() throws Exception {
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteConnectionStrategyTests.java
index 5ea54c7356b94..2c6fc691ec5bd 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteConnectionStrategyTests.java
@@ -111,5 +111,10 @@ protected boolean shouldOpenMoreConnections() {
         protected void connectImpl(ActionListener<Void> listener) {
 
         }
+
+        @Override
+        protected RemoteConnectionInfo.ModeInfo getModeInfo() {
+            return null;
+        }
     }
 }
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrSingleNodeTestCase.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrSingleNodeTestCase.java
index 3a07ef9aa8852..cbfd078452368 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrSingleNodeTestCase.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrSingleNodeTestCase.java
@@ -69,7 +69,7 @@ public void setupLocalRemote() throws Exception {
 
         List<RemoteConnectionInfo> infos = client().execute(RemoteInfoAction.INSTANCE, new RemoteInfoRequest()).get().getInfos();
         assertThat(infos.size(), equalTo(1));
-        assertThat(infos.get(0).getNumNodesConnected(), equalTo(1));
+        assertTrue(infos.get(0).isConnected());
     }
 
     @Before
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/RestartIndexFollowingIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/RestartIndexFollowingIT.java
index ed3d1abb35770..88370aed0db71 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/RestartIndexFollowingIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/RestartIndexFollowingIT.java
@@ -23,7 +23,6 @@
 import static java.util.Collections.singletonMap;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.greaterThanOrEqualTo;
 
 public class RestartIndexFollowingIT extends CcrIntegTestCase {
 
@@ -96,7 +95,7 @@ private void setupRemoteCluster() throws Exception {
         List<RemoteConnectionInfo> infos =
             followerClient().execute(RemoteInfoAction.INSTANCE, new RemoteInfoRequest()).get().getInfos();
         assertThat(infos.size(), equalTo(1));
-        assertThat(infos.get(0).getNumNodesConnected(), greaterThanOrEqualTo(1));
+        assertTrue(infos.get(0).isConnected());
     }
 
     private void cleanRemoteCluster() throws Exception {

From 0271d2847b965d620e1209377deb829d4f223c8b Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Fri, 13 Dec 2019 12:44:12 -0500
Subject: [PATCH 203/686] [DOCS] Add `index-extra-title-page.html` for direct
 HTML migration (#50189)

---
 docs/reference/index-extra-title-page.html | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 docs/reference/index-extra-title-page.html

diff --git a/docs/reference/index-extra-title-page.html b/docs/reference/index-extra-title-page.html
new file mode 100644
index 0000000000000..69eff59c9e9bd
--- /dev/null
+++ b/docs/reference/index-extra-title-page.html
@@ -0,0 +1,20 @@
+<div class="legalnotice">
+  <p>
+    Welcome to the official documentation for Elasticsearch:
+    the search and analytics engine that powers the Elastic Stack.
+    If you want to learn how to use Elasticsearch to search and analyze your
+    data, you've come to the right place. This guide shows you how to:
+  </p>
+  <div class="itemizedlist">
+    <ul class="itemizedlist" type="disc">
+      <li class="listitem">Install, configure, and administer an Elasticsearch
+      cluster.</li>
+      <li class="listitem">Index your data, optimize your indices, and search
+      with the Elasticsearch query language.
+      </li>
+      <li class="listitem">Discover trends, patterns, and anomalies with
+      aggregations and the machine learning APIs.
+      </li>
+    </ul>
+  </div>
+</div>
\ No newline at end of file

From 26cdf0ad736833106e5d819998b5396eaceb2809 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 13 Dec 2019 13:56:50 -0500
Subject: [PATCH 204/686] Migrate peer recovery from translog to retention
 lease (#49448)

Since 7.4, we switch from translog to Lucene as the source of history
for peer recoveries. However, we reduce the likelihood of
operation-based recoveries when performing a full cluster restart from
pre-7.4 because existing copies do not have PPRL.

To remedy this issue, we fallback using translog in peer recoveries if
the recovering replica does not have a peer recovery retention lease,
and the replication group hasn't fully migrated to PRRL.

Relates #45136
---
 .../upgrades/FullClusterRestartIT.java        | 66 ++++++++++++++
 .../elasticsearch/upgrades/RecoveryIT.java    | 57 +++++++++++-
 .../elasticsearch/index/IndexSettings.java    | 24 +++--
 .../elasticsearch/index/engine/Engine.java    | 24 +++--
 .../index/engine/InternalEngine.java          | 88 +++++++++++--------
 .../index/engine/ReadOnlyEngine.java          | 13 +--
 .../index/seqno/ReplicationTracker.java       |  9 +-
 .../elasticsearch/index/shard/IndexShard.java | 70 ++++++++++++---
 .../index/shard/PrimaryReplicaSyncer.java     |  5 +-
 .../recovery/RecoverySourceHandler.java       | 37 ++++----
 .../indices/recovery/RecoveryTarget.java      |  4 +-
 .../index/IndexSettingsTests.java             |  2 +-
 .../index/engine/InternalEngineTests.java     | 30 ++++---
 .../IndexLevelReplicationTests.java           |  9 +-
 .../RetentionLeasesReplicationTests.java      | 22 +++++
 .../index/seqno/RetentionLeaseIT.java         |  7 +-
 .../shard/PrimaryReplicaSyncerTests.java      |  6 +-
 .../indices/recovery/RecoveryTests.java       |  2 +-
 .../test/rest/ESRestTestCase.java             | 75 ++++++++++++++++
 .../action/bulk/BulkShardOperationsTests.java |  3 +-
 20 files changed, 439 insertions(+), 114 deletions(-)

diff --git a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
index ec961534eb0af..2d367261f8895 100644
--- a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
+++ b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
@@ -34,6 +34,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.seqno.RetentionLeaseUtils;
 import org.elasticsearch.test.NotEqualMessageBuilder;
 import org.elasticsearch.test.rest.ESRestTestCase;
@@ -1168,6 +1169,12 @@ private void indexRandomDocuments(
         }
     }
 
+    private void indexDocument(String id) throws IOException {
+        final Request indexRequest = new Request("POST", "/" + index + "/" + "_doc/" + id);
+        indexRequest.setJsonEntity(Strings.toString(JsonXContent.contentBuilder().startObject().field("f", "v").endObject()));
+        assertOK(client().performRequest(indexRequest));
+    }
+
     private int countOfIndexedRandomDocuments() throws IOException {
         return Integer.parseInt(loadInfoDocument(index + "_count"));
     }
@@ -1248,4 +1255,63 @@ public void testPeerRecoveryRetentionLeases() throws IOException {
             RetentionLeaseUtils.assertAllCopiesHavePeerRecoveryRetentionLeases(client(), index);
         }
     }
+
+    /**
+     * Tests that with or without soft-deletes, we should perform an operation-based recovery if there were some
+     * but not too many uncommitted documents (i.e., less than 10% of committed documents or the extra translog)
+     * before we restart the cluster. This is important when we move from translog based to retention leases based
+     * peer recoveries.
+     */
+    public void testOperationBasedRecovery() throws Exception {
+        if (isRunningAgainstOldCluster()) {
+            createIndex(index, Settings.builder()
+                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1)
+                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
+                .build());
+            ensureGreen(index);
+            int committedDocs = randomIntBetween(100, 200);
+            for (int i = 0; i < committedDocs; i++) {
+                indexDocument(Integer.toString(i));
+                if (rarely()) {
+                    flush(index, randomBoolean());
+                }
+            }
+            flush(index, true);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
+            // less than 10% of the committed docs (see IndexSetting#FILE_BASED_RECOVERY_THRESHOLD_SETTING).
+            int uncommittedDocs = randomIntBetween(0, (int) (committedDocs * 0.1));
+            for (int i = 0; i < uncommittedDocs; i++) {
+                final String id = Integer.toString(randomIntBetween(1, 100));
+                indexDocument(id);
+            }
+        } else {
+            ensureGreen(index);
+            assertNoFileBasedRecovery(index, n -> true);
+        }
+    }
+
+    /**
+     * Verifies that once all shard copies on the new version, we should turn off the translog retention for indices with soft-deletes.
+     */
+    public void testTurnOffTranslogRetentionAfterUpgraded() throws Exception {
+        if (isRunningAgainstOldCluster()) {
+            createIndex(index, Settings.builder()
+                .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 1)
+                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build());
+            ensureGreen(index);
+            int numDocs = randomIntBetween(10, 100);
+            for (int i = 0; i < numDocs; i++) {
+                indexDocument(Integer.toString(randomIntBetween(1, 100)));
+                if (rarely()) {
+                    flush(index, randomBoolean());
+                }
+            }
+        } else {
+            ensureGreen(index);
+            flush(index, true);
+            assertEmptyTranslog(index);
+        }
+    }
 }
diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index 58bff342085ee..cd4a07aab3ec0 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -487,10 +487,10 @@ public void testClosedIndexNoopRecovery() throws Exception {
                 switch (CLUSTER_TYPE) {
                     case OLD: break;
                     case MIXED:
-                        assertNoFileBasedRecovery(indexName, s -> s.startsWith(CLUSTER_NAME + "-0"));
+                        assertNoopRecoveries(indexName, s -> s.startsWith(CLUSTER_NAME + "-0"));
                         break;
                     case UPGRADED:
-                        assertNoFileBasedRecovery(indexName, s -> s.startsWith(CLUSTER_NAME));
+                        assertNoopRecoveries(indexName, s -> s.startsWith(CLUSTER_NAME));
                         break;
                 }
             }
@@ -647,7 +647,7 @@ public void testUpdateDoc() throws Exception {
         }
     }
 
-    private void assertNoFileBasedRecovery(String indexName, Predicate<String> targetNode) throws IOException {
+    private void assertNoopRecoveries(String indexName, Predicate<String> targetNode) throws IOException {
         Map<String, Object> recoveries = entityAsMap(client()
             .performRequest(new Request("GET", indexName + "/_recovery?detailed=true")));
 
@@ -678,4 +678,55 @@ private void assertNoFileBasedRecovery(String indexName, Predicate<String> targe
 
         assertTrue("must find replica", foundReplica);
     }
+
+    /**
+     * Tests that with or without soft-deletes, we should perform an operation-based recovery if there were some
+     * but not too many uncommitted documents (i.e., less than 10% of committed documents or the extra translog)
+     * before we upgrade each node. This is important when we move from translog based to retention leases based
+     * peer recoveries.
+     */
+    public void testOperationBasedRecovery() throws Exception {
+        final String index = "test_operation_based_recovery";
+        if (CLUSTER_TYPE == ClusterType.OLD) {
+            createIndex(index, Settings.builder()
+                .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 2)
+                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean()).build());
+            ensureGreen(index);
+            indexDocs(index, 0, randomIntBetween(100, 200));
+            flush(index, randomBoolean());
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
+            // uncommitted docs must be less than 10% of committed docs (see IndexSetting#FILE_BASED_RECOVERY_THRESHOLD_SETTING).
+            indexDocs(index, randomIntBetween(0, 100), randomIntBetween(0, 3));
+        } else {
+            ensureGreen(index);
+            assertNoFileBasedRecovery(index, nodeName ->
+                   CLUSTER_TYPE == ClusterType.UPGRADED
+                || nodeName.startsWith(CLUSTER_NAME + "-0")
+                || (nodeName.startsWith(CLUSTER_NAME + "-1") && Booleans.parseBoolean(System.getProperty("tests.first_round")) == false));
+            indexDocs(index, randomIntBetween(0, 100), randomIntBetween(0, 3));
+        }
+    }
+
+    /**
+     * Verifies that once all shard copies on the new version, we should turn off the translog retention for indices with soft-deletes.
+     */
+    public void testTurnOffTranslogRetentionAfterUpgraded() throws Exception {
+        final String index = "turn_off_translog_retention";
+        if (CLUSTER_TYPE == ClusterType.OLD) {
+            createIndex(index, Settings.builder()
+                .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), randomIntBetween(0, 2))
+                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build());
+            ensureGreen(index);
+            indexDocs(index, 0, randomIntBetween(100, 200));
+            flush(index, randomBoolean());
+            indexDocs(index, randomIntBetween(0, 100), randomIntBetween(0, 100));
+        }
+        if (CLUSTER_TYPE == ClusterType.UPGRADED) {
+            ensureGreen(index);
+            flush(index, true);
+            assertEmptyTranslog(index);
+        }
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/index/IndexSettings.java b/server/src/main/java/org/elasticsearch/index/IndexSettings.java
index a1994d65c8d73..99076f812b96e 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexSettings.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexSettings.java
@@ -245,21 +245,22 @@ public final class IndexSettings {
      * Controls how long translog files that are no longer needed for persistence reasons
      * will be kept around before being deleted. Keeping more files is useful to increase
      * the chance of ops based recoveries for indices with soft-deletes disabled.
-     * This setting will be ignored if soft-deletes is enabled.
+     * This setting will be ignored if soft-deletes is used in peer recoveries (default in 7.4).
      **/
     public static final Setting<TimeValue> INDEX_TRANSLOG_RETENTION_AGE_SETTING =
         Setting.timeSetting("index.translog.retention.age",
-            settings -> INDEX_SOFT_DELETES_SETTING.get(settings) ? TimeValue.MINUS_ONE : TimeValue.timeValueHours(12), TimeValue.MINUS_ONE,
-            Property.Dynamic, Property.IndexScope);
+            settings -> shouldDisableTranslogRetention(settings) ? TimeValue.MINUS_ONE : TimeValue.timeValueHours(12),
+            TimeValue.MINUS_ONE, Property.Dynamic, Property.IndexScope);
 
     /**
      * Controls how many translog files that are no longer needed for persistence reasons
      * will be kept around before being deleted. Keeping more files is useful to increase
      * the chance of ops based recoveries for indices with soft-deletes disabled.
-     * This setting will be ignored if soft-deletes is enabled.
+     * This setting will be ignored if soft-deletes is used in peer recoveries (default in 7.4).
      **/
     public static final Setting<ByteSizeValue> INDEX_TRANSLOG_RETENTION_SIZE_SETTING =
-        Setting.byteSizeSetting("index.translog.retention.size", settings -> INDEX_SOFT_DELETES_SETTING.get(settings) ? "-1" : "512MB",
+        Setting.byteSizeSetting("index.translog.retention.size",
+            settings -> shouldDisableTranslogRetention(settings) ? "-1" : "512MB",
             Property.Dynamic, Property.IndexScope);
 
     /**
@@ -577,7 +578,7 @@ private void setFlushAfterMergeThresholdSize(ByteSizeValue byteSizeValue) {
     }
 
     private void setTranslogRetentionSize(ByteSizeValue byteSizeValue) {
-        if (softDeleteEnabled && byteSizeValue.getBytes() >= 0) {
+        if (shouldDisableTranslogRetention(settings) && byteSizeValue.getBytes() >= 0) {
             // ignore the translog retention settings if soft-deletes enabled
             this.translogRetentionSize = new ByteSizeValue(-1);
         } else {
@@ -586,7 +587,7 @@ private void setTranslogRetentionSize(ByteSizeValue byteSizeValue) {
     }
 
     private void setTranslogRetentionAge(TimeValue age) {
-        if (softDeleteEnabled && age.millis() >= 0) {
+        if (shouldDisableTranslogRetention(settings) && age.millis() >= 0) {
             // ignore the translog retention settings if soft-deletes enabled
             this.translogRetentionAge = TimeValue.MINUS_ONE;
         } else {
@@ -774,7 +775,7 @@ public TimeValue getRefreshInterval() {
      * Returns the transaction log retention size which controls how much of the translog is kept around to allow for ops based recoveries
      */
     public ByteSizeValue getTranslogRetentionSize() {
-        assert softDeleteEnabled == false || translogRetentionSize.getBytes() == -1L : translogRetentionSize;
+        assert shouldDisableTranslogRetention(settings) == false || translogRetentionSize.getBytes() == -1L : translogRetentionSize;
         return translogRetentionSize;
     }
 
@@ -783,7 +784,7 @@ public ByteSizeValue getTranslogRetentionSize() {
      * around
      */
     public TimeValue getTranslogRetentionAge() {
-        assert softDeleteEnabled == false || translogRetentionAge.millis() == -1L : translogRetentionSize;
+        assert shouldDisableTranslogRetention(settings) == false || translogRetentionAge.millis() == -1L : translogRetentionSize;
         return translogRetentionAge;
     }
 
@@ -795,6 +796,11 @@ public int getTranslogRetentionTotalFiles() {
         return INDEX_TRANSLOG_RETENTION_TOTAL_FILES_SETTING.get(getSettings());
     }
 
+    private static boolean shouldDisableTranslogRetention(Settings settings) {
+        return INDEX_SOFT_DELETES_SETTING.get(settings)
+            && IndexMetaData.SETTING_INDEX_VERSION_CREATED.get(settings).onOrAfter(Version.V_7_4_0);
+    }
+
     /**
      * Returns the generation threshold size. As sequence numbers can cause multiple generations to
      * be preserved for rollback purposes, we want to keep the size of individual generations from
diff --git a/server/src/main/java/org/elasticsearch/index/engine/Engine.java b/server/src/main/java/org/elasticsearch/index/engine/Engine.java
index 75ef4e0d12d77..26ecd4b29f39d 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/Engine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/Engine.java
@@ -66,6 +66,7 @@
 import org.elasticsearch.common.lucene.uid.VersionsAndSeqNoResolver.DocIdAndVersion;
 import org.elasticsearch.common.metrics.CounterMetric;
 import org.elasticsearch.common.regex.Regex;
+import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.util.concurrent.ReleasableLock;
 import org.elasticsearch.index.VersionType;
@@ -729,7 +730,7 @@ public enum SearcherScope {
     /**
      * Acquires a lock on the translog files and Lucene soft-deleted documents to prevent them from being trimmed
      */
-    public abstract Closeable acquireRetentionLock();
+    public abstract Closeable acquireHistoryRetentionLock(HistorySource historySource);
 
     /**
      * Creates a new history snapshot from Lucene for reading operations whose seqno in the requesting seqno range (both inclusive).
@@ -742,19 +743,20 @@ public abstract Translog.Snapshot newChangesSnapshot(String source, MapperServic
      * Creates a new history snapshot for reading operations since {@code startingSeqNo} (inclusive).
      * The returned snapshot can be retrieved from either Lucene index or translog files.
      */
-    public abstract Translog.Snapshot readHistoryOperations(String source,
-                                                                MapperService mapperService, long startingSeqNo) throws IOException;
+    public abstract Translog.Snapshot readHistoryOperations(String reason, HistorySource historySource,
+                                                            MapperService mapperService, long startingSeqNo) throws IOException;
 
     /**
      * Returns the estimated number of history operations whose seq# at least {@code startingSeqNo}(inclusive) in this engine.
      */
-    public abstract int estimateNumberOfHistoryOperations(String source,
-                                                                MapperService mapperService, long startingSeqNo) throws IOException;
+    public abstract int estimateNumberOfHistoryOperations(String reason, HistorySource historySource,
+                                                          MapperService mapperService, long startingSeqNo) throws IOException;
 
     /**
      * Checks if this engine has every operations since  {@code startingSeqNo}(inclusive) in its history (either Lucene or translog)
      */
-    public abstract boolean hasCompleteOperationHistory(String source, MapperService mapperService, long startingSeqNo) throws IOException;
+    public abstract boolean hasCompleteOperationHistory(String reason, HistorySource historySource,
+                                                        MapperService mapperService, long startingSeqNo) throws IOException;
 
     /**
      * Gets the minimum retained sequence number for this engine.
@@ -1795,7 +1797,8 @@ public IndexCommit getIndexCommit() {
         }
     }
 
-    public void onSettingsChanged() {
+    public void onSettingsChanged(TimeValue translogRetentionAge, ByteSizeValue translogRetentionSize, long softDeletesRetentionOps) {
+
     }
 
     /**
@@ -1929,4 +1932,11 @@ public interface TranslogRecoveryRunner {
      * to advance this marker to at least the given sequence number.
      */
     public abstract void advanceMaxSeqNoOfUpdatesOrDeletes(long maxSeqNoOfUpdatesOnPrimary);
+
+    /**
+     * Whether we should read history operations from translog or Lucene index
+     */
+    public enum HistorySource {
+        TRANSLOG, INDEX
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java b/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
index b60c60b89b119..1e445c0b0ac85 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
@@ -68,6 +68,8 @@
 import org.elasticsearch.common.lucene.uid.VersionsAndSeqNoResolver;
 import org.elasticsearch.common.lucene.uid.VersionsAndSeqNoResolver.DocIdAndSeqNo;
 import org.elasticsearch.common.metrics.CounterMetric;
+import org.elasticsearch.common.unit.ByteSizeValue;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
 import org.elasticsearch.common.util.concurrent.KeyedLock;
 import org.elasticsearch.common.util.concurrent.ReleasableLock;
@@ -532,27 +534,31 @@ public void syncTranslog() throws IOException {
      * The returned snapshot can be retrieved from either Lucene index or translog files.
      */
     @Override
-    public Translog.Snapshot readHistoryOperations(String source, MapperService mapperService, long startingSeqNo) throws IOException {
-        if (engineConfig.getIndexSettings().isSoftDeleteEnabled()) {
-            return newChangesSnapshot(source, mapperService, Math.max(0, startingSeqNo), Long.MAX_VALUE, false);
+    public Translog.Snapshot readHistoryOperations(String reason, HistorySource historySource,
+                                                   MapperService mapperService, long startingSeqNo) throws IOException {
+        if (historySource == HistorySource.INDEX) {
+            ensureSoftDeletesEnabled();
+            return newChangesSnapshot(reason, mapperService, Math.max(0, startingSeqNo), Long.MAX_VALUE, false);
+        } else {
+            return getTranslog().newSnapshotFromMinSeqNo(startingSeqNo);
         }
-
-        return getTranslog().newSnapshotFromMinSeqNo(startingSeqNo);
     }
 
     /**
      * Returns the estimated number of history operations whose seq# at least the provided seq# in this engine.
      */
     @Override
-    public int estimateNumberOfHistoryOperations(String source, MapperService mapperService, long startingSeqNo) throws IOException {
-        if (engineConfig.getIndexSettings().isSoftDeleteEnabled()) {
-            try (Translog.Snapshot snapshot = newChangesSnapshot(source, mapperService, Math.max(0, startingSeqNo),
+    public int estimateNumberOfHistoryOperations(String reason, HistorySource historySource,
+                                                 MapperService mapperService, long startingSeqNo) throws IOException {
+        if (historySource == HistorySource.INDEX) {
+            ensureSoftDeletesEnabled();
+            try (Translog.Snapshot snapshot = newChangesSnapshot(reason, mapperService, Math.max(0, startingSeqNo),
                 Long.MAX_VALUE, false)) {
                 return snapshot.totalOperations();
             }
+        } else {
+            return getTranslog().estimateTotalOperationsFromMinSeq(startingSeqNo);
         }
-
-        return getTranslog().estimateTotalOperationsFromMinSeq(startingSeqNo);
     }
 
     @Override
@@ -2479,15 +2485,15 @@ final void ensureCanFlush() {
         }
     }
 
-    public void onSettingsChanged() {
+    @Override
+    public void onSettingsChanged(TimeValue translogRetentionAge, ByteSizeValue translogRetentionSize, long softDeletesRetentionOps) {
         mergeScheduler.refreshConfig();
         // config().isEnableGcDeletes() or config.getGcDeletesInMillis() may have changed:
         maybePruneDeletes();
         final TranslogDeletionPolicy translogDeletionPolicy = translog.getDeletionPolicy();
-        final IndexSettings indexSettings = engineConfig.getIndexSettings();
-        translogDeletionPolicy.setRetentionAgeInMillis(indexSettings.getTranslogRetentionAge().getMillis());
-        translogDeletionPolicy.setRetentionSizeInBytes(indexSettings.getTranslogRetentionSize().getBytes());
-        softDeletesPolicy.setRetentionOperations(indexSettings.getSoftDeleteRetentionOperations());
+        translogDeletionPolicy.setRetentionAgeInMillis(translogRetentionAge.millis());
+        translogDeletionPolicy.setRetentionSizeInBytes(translogRetentionSize.getBytes());
+        softDeletesPolicy.setRetentionOperations(softDeletesRetentionOps);
     }
 
     public MergeStats getMergeStats() {
@@ -2594,12 +2600,17 @@ long getNumDocUpdates() {
         return numDocUpdates.count();
     }
 
+    private void ensureSoftDeletesEnabled() {
+        if (softDeleteEnabled == false) {
+            assert false : "index " + shardId.getIndex() + " does not have soft-deletes enabled";
+            throw new IllegalStateException("index " + shardId.getIndex() + " does not have soft-deletes enabled");
+        }
+    }
+
     @Override
     public Translog.Snapshot newChangesSnapshot(String source, MapperService mapperService,
                                                 long fromSeqNo, long toSeqNo, boolean requiredFullRange) throws IOException {
-        if (softDeleteEnabled == false) {
-            throw new IllegalStateException("accessing changes snapshot requires soft-deletes enabled");
-        }
+        ensureSoftDeletesEnabled();
         ensureOpen();
         refreshIfNeeded(source, toSeqNo);
         Searcher searcher = acquireSearcher(source, SearcherScope.INTERNAL);
@@ -2621,26 +2632,28 @@ public Translog.Snapshot newChangesSnapshot(String source, MapperService mapperS
     }
 
     @Override
-    public boolean hasCompleteOperationHistory(String source, MapperService mapperService, long startingSeqNo) throws IOException {
-        if (engineConfig.getIndexSettings().isSoftDeleteEnabled()) {
+    public boolean hasCompleteOperationHistory(String reason, HistorySource historySource,
+                                               MapperService mapperService, long startingSeqNo) throws IOException {
+        if (historySource == HistorySource.INDEX) {
+            ensureSoftDeletesEnabled();
             return getMinRetainedSeqNo() <= startingSeqNo;
-        }
-
-        final long currentLocalCheckpoint = localCheckpointTracker.getProcessedCheckpoint();
-        // avoid scanning translog if not necessary
-        if (startingSeqNo > currentLocalCheckpoint) {
-            return true;
-        }
-        final LocalCheckpointTracker tracker = new LocalCheckpointTracker(startingSeqNo, startingSeqNo - 1);
-        try (Translog.Snapshot snapshot = getTranslog().newSnapshotFromMinSeqNo(startingSeqNo)) {
-            Translog.Operation operation;
-            while ((operation = snapshot.next()) != null) {
-                if (operation.seqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO) {
-                    tracker.markSeqNoAsProcessed(operation.seqNo());
+        } else {
+            final long currentLocalCheckpoint = localCheckpointTracker.getProcessedCheckpoint();
+            // avoid scanning translog if not necessary
+            if (startingSeqNo > currentLocalCheckpoint) {
+                return true;
+            }
+            final LocalCheckpointTracker tracker = new LocalCheckpointTracker(startingSeqNo, startingSeqNo - 1);
+            try (Translog.Snapshot snapshot = getTranslog().newSnapshotFromMinSeqNo(startingSeqNo)) {
+                Translog.Operation operation;
+                while ((operation = snapshot.next()) != null) {
+                    if (operation.seqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO) {
+                        tracker.markSeqNoAsProcessed(operation.seqNo());
+                    }
                 }
             }
+            return tracker.getProcessedCheckpoint() >= currentLocalCheckpoint;
         }
-        return tracker.getProcessedCheckpoint() >= currentLocalCheckpoint;
     }
 
     /**
@@ -2648,13 +2661,14 @@ public boolean hasCompleteOperationHistory(String source, MapperService mapperSe
      * Operations whose seq# are at least this value should exist in the Lucene index.
      */
     public final long getMinRetainedSeqNo() {
-        assert softDeleteEnabled : Thread.currentThread().getName();
+        ensureSoftDeletesEnabled();
         return softDeletesPolicy.getMinRetainedSeqNo();
     }
 
     @Override
-    public Closeable acquireRetentionLock() {
-        if (softDeleteEnabled) {
+    public Closeable acquireHistoryRetentionLock(HistorySource historySource) {
+        if (historySource == HistorySource.INDEX) {
+            ensureSoftDeletesEnabled();
             return softDeletesPolicy.acquireRetentionLock();
         } else {
             return translog.acquireRetentionLock();
diff --git a/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java b/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
index df3c8e275f3c7..768655cf1c852 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
@@ -307,7 +307,7 @@ public void syncTranslog() {
     }
 
     @Override
-    public Closeable acquireRetentionLock() {
+    public Closeable acquireHistoryRetentionLock(HistorySource historySource) {
         return () -> {};
     }
 
@@ -317,21 +317,24 @@ public Translog.Snapshot newChangesSnapshot(String source, MapperService mapperS
         if (engineConfig.getIndexSettings().isSoftDeleteEnabled() == false) {
             throw new IllegalStateException("accessing changes snapshot requires soft-deletes enabled");
         }
-        return readHistoryOperations(source, mapperService, fromSeqNo);
+        return newEmptySnapshot();
     }
 
     @Override
-    public Translog.Snapshot readHistoryOperations(String source, MapperService mapperService, long startingSeqNo) throws IOException {
+    public Translog.Snapshot readHistoryOperations(String reason, HistorySource historySource,
+                                                   MapperService mapperService, long startingSeqNo) {
         return newEmptySnapshot();
     }
 
     @Override
-    public int estimateNumberOfHistoryOperations(String source, MapperService mapperService, long startingSeqNo) throws IOException {
+    public int estimateNumberOfHistoryOperations(String reason, HistorySource historySource,
+                                                 MapperService mapperService, long startingSeqNo) {
         return 0;
     }
 
     @Override
-    public boolean hasCompleteOperationHistory(String source, MapperService mapperService, long startingSeqNo) throws IOException {
+    public boolean hasCompleteOperationHistory(String reason, HistorySource historySource,
+                                               MapperService mapperService, long startingSeqNo) {
         // we can do operation-based recovery if we don't have to replay any operation.
         return startingSeqNo > seqNoStats.getMaxSeqNo();
     }
diff --git a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
index 1c8599f66cf31..14e78973504bc 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
@@ -895,9 +895,10 @@ public ReplicationTracker(
         this.pendingInSync = new HashSet<>();
         this.routingTable = null;
         this.replicationGroup = null;
-        this.hasAllPeerRecoveryRetentionLeases = indexSettings.getIndexVersionCreated().onOrAfter(Version.V_8_0_0) ||
+        this.hasAllPeerRecoveryRetentionLeases = indexSettings.isSoftDeleteEnabled() &&
+            (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_8_0_0) ||
             (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_4_0) &&
-                indexSettings.getIndexMetaData().getState() == IndexMetaData.State.OPEN);
+             indexSettings.getIndexMetaData().getState() == IndexMetaData.State.OPEN));
         this.fileBasedRecoveryThreshold = IndexSettings.FILE_BASED_RECOVERY_THRESHOLD_SETTING.get(indexSettings.getSettings());
         this.safeCommitInfoSupplier = safeCommitInfoSupplier;
         assert Version.V_EMPTY.equals(indexSettings.getIndexVersionCreated()) == false;
@@ -1348,6 +1349,10 @@ private synchronized void setHasAllPeerRecoveryRetentionLeases() {
         assert invariant();
     }
 
+    public synchronized boolean hasAllPeerRecoveryRetentionLeases() {
+        return hasAllPeerRecoveryRetentionLeases;
+    }
+
     /**
      * Create any required peer-recovery retention leases that do not currently exist because we just did a rolling upgrade from a version
      * prior to {@link Version#V_7_4_0} that does not create peer-recovery retention leases.
diff --git a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
index 8185d8fad5f16..059961e1e5897 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
@@ -67,6 +67,7 @@
 import org.elasticsearch.common.metrics.CounterMetric;
 import org.elasticsearch.common.metrics.MeanMetric;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
@@ -157,6 +158,7 @@
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.EnumSet;
+import java.util.HashSet;
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
@@ -268,6 +270,7 @@ Runnable getGlobalCheckpointSyncer() {
 
     private final AtomicLong lastSearcherAccess = new AtomicLong();
     private final AtomicReference<Translog.Location> pendingRefreshLocation = new AtomicReference<>();
+    private volatile boolean useRetentionLeasesInPeerRecovery;
 
     public IndexShard(
             final ShardRouting shardRouting,
@@ -364,6 +367,7 @@ public boolean shouldCache(Query query) {
         refreshListeners = buildRefreshListeners();
         lastSearcherAccess.set(threadPool.relativeTimeInMillis());
         persistMetadata(path, indexSettings, shardRouting, null, logger);
+        this.useRetentionLeasesInPeerRecovery = replicationTracker.hasAllPeerRecoveryRetentionLeases();
     }
 
     public ThreadPool getThreadPool() {
@@ -600,6 +604,17 @@ public void onFailure(Exception e) {
         if (newRouting.equals(currentRouting) == false) {
             indexEventListener.shardRoutingChanged(this, currentRouting, newRouting);
         }
+
+        if (indexSettings.isSoftDeleteEnabled() && useRetentionLeasesInPeerRecovery == false) {
+            final RetentionLeases retentionLeases = replicationTracker.getRetentionLeases();
+            final Set<ShardRouting> shardRoutings = new HashSet<>(routingTable.getShards());
+            shardRoutings.addAll(routingTable.assignedShards()); // include relocation targets
+            if (shardRoutings.stream().allMatch(
+                shr -> shr.assignedToNode() && retentionLeases.contains(ReplicationTracker.getPeerRecoveryRetentionLeaseId(shr)))) {
+                useRetentionLeasesInPeerRecovery = true;
+                turnOffTranslogRetention();
+            }
+        }
     }
 
     /**
@@ -1877,38 +1892,63 @@ boolean shouldRollTranslogGeneration() {
     public void onSettingsChanged() {
         Engine engineOrNull = getEngineOrNull();
         if (engineOrNull != null) {
-            engineOrNull.onSettingsChanged();
+            final boolean useRetentionLeasesInPeerRecovery = this.useRetentionLeasesInPeerRecovery;
+            engineOrNull.onSettingsChanged(
+                useRetentionLeasesInPeerRecovery ? TimeValue.MINUS_ONE : indexSettings.getTranslogRetentionAge(),
+                useRetentionLeasesInPeerRecovery ? new ByteSizeValue(-1) : indexSettings.getTranslogRetentionSize(),
+                indexSettings.getSoftDeleteRetentionOperations()
+            );
         }
     }
 
+    private void turnOffTranslogRetention() {
+        logger.debug("turn off the translog retention for the replication group {} " +
+            "as it starts using retention leases exclusively in peer recoveries", shardId);
+        // Off to the generic threadPool as pruning the delete tombstones can be expensive.
+        threadPool.generic().execute(new AbstractRunnable() {
+            @Override
+            public void onFailure(Exception e) {
+                if (state != IndexShardState.CLOSED) {
+                    logger.warn("failed to turn off translog retention", e);
+                }
+            }
+
+            @Override
+            protected void doRun() {
+                onSettingsChanged();
+                trimTranslog();
+            }
+        });
+    }
+
     /**
      * Acquires a lock on the translog files and Lucene soft-deleted documents to prevent them from being trimmed
      */
-    public Closeable acquireRetentionLock() {
-        return getEngine().acquireRetentionLock();
+    public Closeable acquireHistoryRetentionLock(Engine.HistorySource source) {
+        return getEngine().acquireHistoryRetentionLock(source);
     }
 
     /**
      * Returns the estimated number of history operations whose seq# at least the provided seq# in this shard.
      */
-    public int estimateNumberOfHistoryOperations(String source, long startingSeqNo) throws IOException {
-        return getEngine().estimateNumberOfHistoryOperations(source, mapperService, startingSeqNo);
+    public int estimateNumberOfHistoryOperations(String reason, Engine.HistorySource source, long startingSeqNo) throws IOException {
+        return getEngine().estimateNumberOfHistoryOperations(reason, source, mapperService, startingSeqNo);
     }
 
     /**
      * Creates a new history snapshot for reading operations since the provided starting seqno (inclusive).
      * The returned snapshot can be retrieved from either Lucene index or translog files.
      */
-    public Translog.Snapshot getHistoryOperations(String source, long startingSeqNo) throws IOException {
-        return getEngine().readHistoryOperations(source, mapperService, startingSeqNo);
+    public Translog.Snapshot getHistoryOperations(String reason, Engine.HistorySource source, long startingSeqNo) throws IOException {
+        return getEngine().readHistoryOperations(reason, source, mapperService, startingSeqNo);
     }
 
     /**
      * Checks if we have a completed history of operations since the given starting seqno (inclusive).
-     * This method should be called after acquiring the retention lock; See {@link #acquireRetentionLock()}
+     * This method should be called after acquiring the retention lock; See {@link #acquireHistoryRetentionLock(Engine.HistorySource)}
      */
-    public boolean hasCompleteHistoryOperations(String source, long startingSeqNo) throws IOException {
-        return getEngine().hasCompleteOperationHistory(source, mapperService, startingSeqNo);
+    public boolean hasCompleteHistoryOperations(String reason, Engine.HistorySource source, long startingSeqNo) throws IOException {
+        return getEngine().hasCompleteOperationHistory(reason, source, mapperService, startingSeqNo);
     }
 
     /**
@@ -2097,9 +2137,9 @@ public RetentionLease addRetentionLease(
         assert assertPrimaryMode();
         verifyNotClosed();
         ensureSoftDeletesEnabled("retention leases");
-        try (Closeable ignore = acquireRetentionLock()) {
+        try (Closeable ignore = acquireHistoryRetentionLock(Engine.HistorySource.INDEX)) {
             final long actualRetainingSequenceNumber =
-                    retainingSequenceNumber == RETAIN_ALL ? getMinRetainedSeqNo() : retainingSequenceNumber;
+                retainingSequenceNumber == RETAIN_ALL ? getMinRetainedSeqNo() : retainingSequenceNumber;
             return replicationTracker.addRetentionLease(id, actualRetainingSequenceNumber, source, listener);
         } catch (final IOException e) {
             throw new AssertionError(e);
@@ -2119,7 +2159,7 @@ public RetentionLease renewRetentionLease(final String id, final long retainingS
         assert assertPrimaryMode();
         verifyNotClosed();
         ensureSoftDeletesEnabled("retention leases");
-        try (Closeable ignore = acquireRetentionLock()) {
+        try (Closeable ignore = acquireHistoryRetentionLock(Engine.HistorySource.INDEX)) {
             final long actualRetainingSequenceNumber =
                     retainingSequenceNumber == RETAIN_ALL ? getMinRetainedSeqNo() : retainingSequenceNumber;
             return replicationTracker.renewRetentionLease(id, actualRetainingSequenceNumber, source);
@@ -2600,6 +2640,10 @@ public List<RetentionLease> getPeerRecoveryRetentionLeases() {
         return replicationTracker.getPeerRecoveryRetentionLeases();
     }
 
+    public boolean useRetentionLeasesInPeerRecovery() {
+        return useRetentionLeasesInPeerRecovery;
+    }
+
     private SafeCommitInfo getSafeCommitInfo() {
         final Engine engine = getEngineOrNull();
         return engine == null ? SafeCommitInfo.EMPTY : engine.getSafeCommitInfo();
diff --git a/server/src/main/java/org/elasticsearch/index/shard/PrimaryReplicaSyncer.java b/server/src/main/java/org/elasticsearch/index/shard/PrimaryReplicaSyncer.java
index f4cd1cdb8115e..710c78a2d294e 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/PrimaryReplicaSyncer.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/PrimaryReplicaSyncer.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.index.engine.Engine;
 import org.elasticsearch.index.seqno.SequenceNumbers;
 import org.elasticsearch.index.translog.Translog;
 import org.elasticsearch.tasks.Task;
@@ -90,7 +91,9 @@ public void resync(final IndexShard indexShard, final ActionListener<ResyncTask>
             // Wrap translog snapshot to make it synchronized as it is accessed by different threads through SnapshotSender.
             // Even though those calls are not concurrent, snapshot.next() uses non-synchronized state and is not multi-thread-compatible
             // Also fail the resync early if the shard is shutting down
-            snapshot = indexShard.getHistoryOperations("resync", startingSeqNo);
+            snapshot = indexShard.getHistoryOperations("resync",
+                indexShard.indexSettings.isSoftDeleteEnabled() ? Engine.HistorySource.INDEX : Engine.HistorySource.TRANSLOG,
+                startingSeqNo);
             final Translog.Snapshot originalSnapshot = snapshot;
             final Translog.Snapshot wrappedSnapshot = new Translog.Snapshot() {
                 @Override
diff --git a/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java b/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
index c372cc4571a7c..285edc329be06 100644
--- a/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
+++ b/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
@@ -169,22 +169,28 @@ public void recoverToTarget(ActionListener<RecoveryResponse> listener) {
                     ReplicationTracker.getPeerRecoveryRetentionLeaseId(targetShardRouting)) : null);
             }, shardId + " validating recovery target ["+ request.targetAllocationId() + "] registered ",
                 shard, cancellableThreads, logger);
-            final Closeable retentionLock = shard.acquireRetentionLock();
+            final Engine.HistorySource historySource;
+            if (shard.useRetentionLeasesInPeerRecovery() || retentionLeaseRef.get() != null) {
+                historySource = Engine.HistorySource.INDEX;
+            } else {
+                historySource = Engine.HistorySource.TRANSLOG;
+            }
+            final Closeable retentionLock = shard.acquireHistoryRetentionLock(historySource);
             resources.add(retentionLock);
             final long startingSeqNo;
             final boolean isSequenceNumberBasedRecovery
                 = request.startingSeqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO
                 && isTargetSameHistory()
-                && shard.hasCompleteHistoryOperations("peer-recovery", request.startingSeqNo())
-                && (softDeletesEnabled == false
-                || (retentionLeaseRef.get() != null && retentionLeaseRef.get().retainingSequenceNumber() <= request.startingSeqNo()));
+                && shard.hasCompleteHistoryOperations("peer-recovery", historySource, request.startingSeqNo())
+                && (historySource == Engine.HistorySource.TRANSLOG ||
+                   (retentionLeaseRef.get() != null && retentionLeaseRef.get().retainingSequenceNumber() <= request.startingSeqNo()));
             // NB check hasCompleteHistoryOperations when computing isSequenceNumberBasedRecovery, even if there is a retention lease,
             // because when doing a rolling upgrade from earlier than 7.4 we may create some leases that are initially unsatisfied. It's
             // possible there are other cases where we cannot satisfy all leases, because that's not a property we currently expect to hold.
             // Also it's pretty cheap when soft deletes are enabled, and it'd be a disaster if we tried a sequence-number-based recovery
             // without having a complete history.
 
-            if (isSequenceNumberBasedRecovery && softDeletesEnabled) {
+            if (isSequenceNumberBasedRecovery && retentionLeaseRef.get() != null) {
                 // all the history we need is retained by an existing retention lease, so we do not need a separate retention lock
                 retentionLock.close();
                 logger.trace("history is retained by {}", retentionLeaseRef.get());
@@ -203,7 +209,11 @@ && isTargetSameHistory()
             if (isSequenceNumberBasedRecovery) {
                 logger.trace("performing sequence numbers based recovery. starting at [{}]", request.startingSeqNo());
                 startingSeqNo = request.startingSeqNo();
-                sendFileStep.onResponse(SendFileResult.EMPTY);
+                if (softDeletesEnabled && retentionLeaseRef.get() == null) {
+                    createRetentionLease(startingSeqNo, ActionListener.map(sendFileStep, ignored -> SendFileResult.EMPTY));
+                } else {
+                    sendFileStep.onResponse(SendFileResult.EMPTY);
+                }
             } else {
                 final Engine.IndexCommitRef safeCommitRef;
                 try {
@@ -229,7 +239,7 @@ && isTargetSameHistory()
                 logger.trace("performing file-based recovery followed by history replay starting at [{}]", startingSeqNo);
 
                 try {
-                    final int estimateNumOps = shard.estimateNumberOfHistoryOperations("peer-recovery", startingSeqNo);
+                    final int estimateNumOps = shard.estimateNumberOfHistoryOperations("peer-recovery", historySource, startingSeqNo);
                     final Releasable releaseStore = acquireStore(shard.store());
                     resources.add(releaseStore);
                     sendFileStep.whenComplete(r -> IOUtils.close(safeCommitRef, releaseStore), e -> {
@@ -282,7 +292,8 @@ && isTargetSameHistory()
             sendFileStep.whenComplete(r -> {
                 assert Transports.assertNotTransportThread(RecoverySourceHandler.this + "[prepareTargetForTranslog]");
                 // For a sequence based recovery, the target can keep its local translog
-                prepareTargetForTranslog(shard.estimateNumberOfHistoryOperations("peer-recovery", startingSeqNo), prepareEngineStep);
+                prepareTargetForTranslog(
+                    shard.estimateNumberOfHistoryOperations("peer-recovery", historySource, startingSeqNo), prepareEngineStep);
             }, onFailure);
 
             prepareEngineStep.whenComplete(prepareEngineTime -> {
@@ -298,14 +309,10 @@ && isTargetSameHistory()
 
                 final long endingSeqNo = shard.seqNoStats().getMaxSeqNo();
                 logger.trace("snapshot translog for recovery; current size is [{}]",
-                    shard.estimateNumberOfHistoryOperations("peer-recovery", startingSeqNo));
-                final Translog.Snapshot phase2Snapshot = shard.getHistoryOperations("peer-recovery", startingSeqNo);
+                    shard.estimateNumberOfHistoryOperations("peer-recovery", historySource, startingSeqNo));
+                final Translog.Snapshot phase2Snapshot = shard.getHistoryOperations("peer-recovery", historySource, startingSeqNo);
                 resources.add(phase2Snapshot);
-
-                if (softDeletesEnabled == false || isSequenceNumberBasedRecovery == false) {
-                    // we can release the retention lock here because the snapshot itself will retain the required operations.
-                    retentionLock.close();
-                }
+                retentionLock.close();
 
                 // we have to capture the max_seen_auto_id_timestamp and the max_seq_no_of_updates to make sure that these values
                 // are at least as high as the corresponding values on the primary when any of these operations were executed on it.
diff --git a/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryTarget.java b/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryTarget.java
index 7e0e5f7cf17c8..04d347d0006b1 100644
--- a/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryTarget.java
+++ b/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryTarget.java
@@ -316,7 +316,9 @@ public void finalizeRecovery(final long globalCheckpoint, final long trimAboveSe
 
     private boolean hasUncommittedOperations() throws IOException {
         long localCheckpointOfCommit = Long.parseLong(indexShard.commitStats().getUserData().get(SequenceNumbers.LOCAL_CHECKPOINT_KEY));
-        return indexShard.estimateNumberOfHistoryOperations("peer-recovery", localCheckpointOfCommit + 1) > 0;
+        return indexShard.estimateNumberOfHistoryOperations("peer-recovery",
+            indexShard.indexSettings().isSoftDeleteEnabled() ? Engine.HistorySource.INDEX : Engine.HistorySource.TRANSLOG,
+            localCheckpointOfCommit + 1) > 0;
     }
 
     @Override
diff --git a/server/src/test/java/org/elasticsearch/index/IndexSettingsTests.java b/server/src/test/java/org/elasticsearch/index/IndexSettingsTests.java
index e64e7f42a9a2e..1a19647ea7f78 100644
--- a/server/src/test/java/org/elasticsearch/index/IndexSettingsTests.java
+++ b/server/src/test/java/org/elasticsearch/index/IndexSettingsTests.java
@@ -549,7 +549,7 @@ public void testSoftDeletesDefaultSetting() {
 
     public void testIgnoreTranslogRetentionSettingsIfSoftDeletesEnabled() {
         Settings.Builder settings = Settings.builder()
-            .put(IndexMetaData.SETTING_VERSION_CREATED, VersionUtils.randomIndexCompatibleVersion(random()));
+            .put(IndexMetaData.SETTING_VERSION_CREATED, VersionUtils.randomVersionBetween(random(), Version.V_7_4_0, Version.CURRENT));
         if (randomBoolean()) {
             settings.put(IndexSettings.INDEX_TRANSLOG_RETENTION_AGE_SETTING.getKey(), randomPositiveTimeValue());
         }
diff --git a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
index dc37022c130fe..c38f426dbfb59 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
@@ -376,7 +376,8 @@ public void testSegmentsWithoutSoftDeletes() throws Exception {
             assertThat(segments.get(1).getDeletedDocs(), equalTo(0));
             assertThat(segments.get(1).isCompound(), equalTo(true));
 
-            engine.onSettingsChanged();
+            engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
+                indexSettings.getSoftDeleteRetentionOperations());
             ParsedDocument doc4 = testParsedDocument("4", null, testDocumentWithTextField(), B_3, null);
             engine.index(indexForDoc(doc4));
             engine.refresh("test");
@@ -1623,7 +1624,8 @@ public void testForceMergeWithSoftDeletesRetention() throws Exception {
             }
             settings.put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), 0);
             indexSettings.updateIndexMetaData(IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
-            engine.onSettingsChanged();
+            engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
+                indexSettings.getSoftDeleteRetentionOperations());
             globalCheckpoint.set(localCheckpoint);
             engine.syncTranslog();
 
@@ -1714,7 +1716,8 @@ public void testForceMergeWithSoftDeletesRetentionAndRecoverySource() throws Exc
             }
             settings.put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), 0);
             indexSettings.updateIndexMetaData(IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
-            engine.onSettingsChanged();
+            engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
+                indexSettings.getSoftDeleteRetentionOperations());
             // If we already merged down to 1 segment, then the next force-merge will be a noop. We need to add an extra segment to make
             // merges happen so we can verify that _recovery_source are pruned. See: https://github.com/elastic/elasticsearch/issues/41628.
             final int numSegments;
@@ -5040,7 +5043,8 @@ public void testShouldPeriodicallyFlush() throws Exception {
             .settings(Settings.builder().put(indexSettings.getSettings())
                 .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(), flushThreshold + "b")).build();
         indexSettings.updateIndexMetaData(indexMetaData);
-        engine.onSettingsChanged();
+        engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
+            indexSettings.getSoftDeleteRetentionOperations());
         assertThat(engine.getTranslog().stats().getUncommittedOperations(), equalTo(numDocs));
         assertThat(engine.shouldPeriodicallyFlush(), equalTo(true));
         engine.flush();
@@ -5088,7 +5092,8 @@ public void testShouldPeriodicallyFlushAfterMerge() throws Exception {
             .settings(Settings.builder().put(indexSettings.getSettings())
                 .put(IndexSettings.INDEX_FLUSH_AFTER_MERGE_THRESHOLD_SIZE_SETTING.getKey(),  "0b")).build();
         indexSettings.updateIndexMetaData(indexMetaData);
-        engine.onSettingsChanged();
+        engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
+            indexSettings.getSoftDeleteRetentionOperations());
         assertThat(engine.getTranslog().stats().getUncommittedOperations(), equalTo(1));
         assertThat(engine.shouldPeriodicallyFlush(), equalTo(false));
         doc = testParsedDocument(Integer.toString(1), null, testDocumentWithTextField(), SOURCE, null);
@@ -5113,7 +5118,8 @@ public void testStressShouldPeriodicallyFlush() throws Exception {
                 .put(IndexSettings.INDEX_TRANSLOG_GENERATION_THRESHOLD_SIZE_SETTING.getKey(), generationThreshold + "b")
                 .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(), flushThreshold + "b")).build();
         indexSettings.updateIndexMetaData(indexMetaData);
-        engine.onSettingsChanged();
+        engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
+            indexSettings.getSoftDeleteRetentionOperations());
         final int numOps = scaledRandomIntBetween(100, 10_000);
         for (int i = 0; i < numOps; i++) {
             final long localCheckPoint = engine.getProcessedLocalCheckpoint();
@@ -5141,7 +5147,8 @@ public void testStressUpdateSameDocWhileGettingIt() throws IOException, Interrup
                     .settings(Settings.builder().put(indexSettings.getSettings())
                         .put(IndexSettings.INDEX_GC_DELETES_SETTING.getKey(), TimeValue.timeValueMillis(1))).build();
                 engine.engineConfig.getIndexSettings().updateIndexMetaData(indexMetaData);
-                engine.onSettingsChanged();
+                engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
+                    indexSettings.getSoftDeleteRetentionOperations());
                 ParsedDocument document = testParsedDocument(Integer.toString(0), null, testDocumentWithTextField(), SOURCE, null);
                 final Engine.Index doc = new Engine.Index(newUid(document), document, UNASSIGNED_SEQ_NO, 0,
                     Versions.MATCH_ANY, VersionType.INTERNAL, Engine.Operation.Origin.PRIMARY, System.nanoTime(),
@@ -5411,7 +5418,8 @@ public void testKeepMinRetainedSeqNoByMergePolicy() throws IOException {
             if (rarely()) {
                 settings.put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), randomLongBetween(0, 10));
                 indexSettings.updateIndexMetaData(IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
-                engine.onSettingsChanged();
+                engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
+                    indexSettings.getSoftDeleteRetentionOperations());
             }
             if (rarely()) {
                 engine.refresh("test");
@@ -5424,7 +5432,7 @@ public void testKeepMinRetainedSeqNoByMergePolicy() throws IOException {
             if (rarely()) {
                 engine.forceMerge(randomBoolean());
             }
-            try (Closeable ignored = engine.acquireRetentionLock()) {
+            try (Closeable ignored = engine.acquireHistoryRetentionLock(Engine.HistorySource.INDEX)) {
                 long minRetainSeqNos = engine.getMinRetainedSeqNo();
                 assertThat(minRetainSeqNos, lessThanOrEqualTo(globalCheckpoint.get() + 1));
                 Long[] expectedOps = existingSeqNos.stream().filter(seqno -> seqno >= minRetainSeqNos).toArray(Long[]::new);
@@ -5705,9 +5713,9 @@ public void testRequireSoftDeletesWhenAccessingChangesSnapshot() throws Exceptio
                 IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(Settings.builder().
                     put(defaultSettings.getSettings()).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false)).build());
             try (InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), newMergePolicy(), null))) {
-                IllegalStateException error = expectThrows(IllegalStateException.class,
+                AssertionError error = expectThrows(AssertionError.class,
                     () -> engine.newChangesSnapshot("test", createMapperService(), 0, randomNonNegativeLong(), randomBoolean()));
-                assertThat(error.getMessage(), equalTo("accessing changes snapshot requires soft-deletes enabled"));
+                assertThat(error.getMessage(), containsString("does not have soft-deletes enabled"));
             }
         }
     }
diff --git a/server/src/test/java/org/elasticsearch/index/replication/IndexLevelReplicationTests.java b/server/src/test/java/org/elasticsearch/index/replication/IndexLevelReplicationTests.java
index 4882b9262d98c..f565459b26eba 100644
--- a/server/src/test/java/org/elasticsearch/index/replication/IndexLevelReplicationTests.java
+++ b/server/src/test/java/org/elasticsearch/index/replication/IndexLevelReplicationTests.java
@@ -470,7 +470,8 @@ public long addDocument(Iterable<? extends IndexableField> doc) throws IOExcepti
                         assertThat(snapshot.totalOperations(), equalTo(0));
                     }
                 }
-                try (Translog.Snapshot snapshot = shard.getHistoryOperations("test", 0)) {
+                try (Translog.Snapshot snapshot = shard.getHistoryOperations(
+                    "test", shard.indexSettings().isSoftDeleteEnabled() ? Engine.HistorySource.INDEX : Engine.HistorySource.TRANSLOG, 0)) {
                     assertThat(snapshot, SnapshotMatchers.containsOperationsInAnyOrder(expectedTranslogOps));
                 }
             }
@@ -488,7 +489,8 @@ public long addDocument(Iterable<? extends IndexableField> doc) throws IOExcepti
                         assertThat(snapshot, SnapshotMatchers.containsOperationsInAnyOrder(Collections.singletonList(noop2)));
                     }
                 }
-                try (Translog.Snapshot snapshot = shard.getHistoryOperations("test", 0)) {
+                try (Translog.Snapshot snapshot = shard.getHistoryOperations(
+                    "test", shard.indexSettings().isSoftDeleteEnabled() ? Engine.HistorySource.INDEX : Engine.HistorySource.TRANSLOG, 0)) {
                     assertThat(snapshot, SnapshotMatchers.containsOperationsInAnyOrder(expectedTranslogOps));
                 }
             }
@@ -585,7 +587,8 @@ public void testSeqNoCollision() throws Exception {
             shards.promoteReplicaToPrimary(replica2).get();
             logger.info("--> Recover replica3 from replica2");
             recoverReplica(replica3, replica2, true);
-            try (Translog.Snapshot snapshot = replica3.getHistoryOperations("test", 0)) {
+            try (Translog.Snapshot snapshot = replica3.getHistoryOperations(
+                "test", replica3.indexSettings().isSoftDeleteEnabled() ? Engine.HistorySource.INDEX : Engine.HistorySource.TRANSLOG, 0)) {
                 assertThat(snapshot.totalOperations(), equalTo(initDocs + 1));
                 final List<Translog.Operation> expectedOps = new ArrayList<>(initOperations);
                 expectedOps.add(op2);
diff --git a/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java b/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
index 75de0bb677296..7ca6c1ef1bf7f 100644
--- a/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
+++ b/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.index.seqno.RetentionLeases;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.shard.ShardId;
+import org.elasticsearch.test.VersionUtils;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -147,6 +148,27 @@ protected void syncRetentionLeases(ShardId shardId, RetentionLeases leases, Acti
         }
     }
 
+    public void testTurnOffTranslogRetentionAfterAllShardStarted() throws Exception {
+        final Settings.Builder settings = Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
+        if (randomBoolean()) {
+            settings.put(IndexMetaData.SETTING_VERSION_CREATED, VersionUtils.randomIndexCompatibleVersion(random()));
+        }
+        try (ReplicationGroup group = createGroup(between(1, 2), settings.build())) {
+            group.startAll();
+            group.indexDocs(randomIntBetween(1, 10));
+            for (IndexShard shard : group) {
+                shard.updateShardState(shard.routingEntry(), shard.getOperationPrimaryTerm(), null, 1L,
+                    group.getPrimary().getReplicationGroup().getInSyncAllocationIds(),
+                    group.getPrimary().getReplicationGroup().getRoutingTable());
+            }
+            group.syncGlobalCheckpoint();
+            group.flush();
+            for (IndexShard shard : group) {
+                assertThat(shard.translogStats().estimatedNumberOfOperations(), equalTo(0));
+            }
+        }
+    }
+
     static final class SyncRetentionLeasesResponse extends ReplicationResponse {
         final RetentionLeaseSyncAction.Request syncRequest;
         SyncRetentionLeasesResponse(RetentionLeaseSyncAction.Request syncRequest) {
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseIT.java b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseIT.java
index a52f816ff6df2..831422f8dad86 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseIT.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseIT.java
@@ -30,6 +30,7 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.index.engine.Engine;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.indices.IndicesService;
@@ -110,7 +111,7 @@ public void testRetentionLeasesSyncedOnAdd() throws Exception {
             final CountDownLatch latch = new CountDownLatch(1);
             final ActionListener<ReplicationResponse> listener = countDownLatchListener(latch);
             // simulate a peer recovery which locks the soft deletes policy on the primary
-            final Closeable retentionLock = randomBoolean() ? primary.acquireRetentionLock() : () -> {};
+            final Closeable retentionLock = randomBoolean() ? primary.acquireHistoryRetentionLock(Engine.HistorySource.INDEX) : () -> {};
             currentRetentionLeases.put(id, primary.addRetentionLease(id, retainingSequenceNumber, source, listener));
             latch.await();
             retentionLock.close();
@@ -160,7 +161,7 @@ public void testRetentionLeaseSyncedOnRemove() throws Exception {
             final CountDownLatch latch = new CountDownLatch(1);
             final ActionListener<ReplicationResponse> listener = countDownLatchListener(latch);
             // simulate a peer recovery which locks the soft deletes policy on the primary
-            final Closeable retentionLock = randomBoolean() ? primary.acquireRetentionLock() : () -> {};
+            final Closeable retentionLock = randomBoolean() ? primary.acquireHistoryRetentionLock(Engine.HistorySource.INDEX) : () -> {};
             currentRetentionLeases.put(id, primary.addRetentionLease(id, retainingSequenceNumber, source, listener));
             latch.await();
             retentionLock.close();
@@ -171,7 +172,7 @@ public void testRetentionLeaseSyncedOnRemove() throws Exception {
             final CountDownLatch latch = new CountDownLatch(1);
             primary.removeRetentionLease(id, countDownLatchListener(latch));
             // simulate a peer recovery which locks the soft deletes policy on the primary
-            final Closeable retentionLock = randomBoolean() ? primary.acquireRetentionLock() : () -> {};
+            final Closeable retentionLock = randomBoolean() ? primary.acquireHistoryRetentionLock(Engine.HistorySource.INDEX) : () -> {};
             currentRetentionLeases.remove(id);
             latch.await();
             retentionLock.close();
diff --git a/server/src/test/java/org/elasticsearch/index/shard/PrimaryReplicaSyncerTests.java b/server/src/test/java/org/elasticsearch/index/shard/PrimaryReplicaSyncerTests.java
index d6cd94cd07aaa..3099795b138d9 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/PrimaryReplicaSyncerTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/PrimaryReplicaSyncerTests.java
@@ -40,6 +40,7 @@
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.VersionType;
+import org.elasticsearch.index.engine.Engine;
 import org.elasticsearch.index.mapper.SourceToParse;
 import org.elasticsearch.index.seqno.SequenceNumbers;
 import org.elasticsearch.index.translog.TestTranslog;
@@ -63,6 +64,7 @@
 import static org.hamcrest.core.IsInstanceOf.instanceOf;
 import static org.mockito.Matchers.anyLong;
 import static org.mockito.Matchers.anyString;
+import static org.mockito.Matchers.eq;
 import static org.mockito.Mockito.doReturn;
 import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.when;
@@ -210,7 +212,9 @@ public void testDoNotSendOperationsWithoutSequenceNumber() throws Exception {
             operations.add(new Translog.Index(
                 Integer.toString(i), randomBoolean() ? SequenceNumbers.UNASSIGNED_SEQ_NO : i, primaryTerm, new byte[]{1}));
         }
-        doReturn(TestTranslog.newSnapshotFromOperations(operations)).when(shard).getHistoryOperations(anyString(), anyLong());
+        Engine.HistorySource source =
+            shard.indexSettings.isSoftDeleteEnabled() ? Engine.HistorySource.INDEX : Engine.HistorySource.TRANSLOG;
+        doReturn(TestTranslog.newSnapshotFromOperations(operations)).when(shard).getHistoryOperations(anyString(), eq(source), anyLong());
         TaskManager taskManager = new TaskManager(Settings.EMPTY, threadPool, Collections.emptySet());
         List<Translog.Operation> sentOperations = new ArrayList<>();
         PrimaryReplicaSyncer.SyncAction syncAction = (request, parentTask, allocationId, primaryTerm, listener) -> {
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/RecoveryTests.java b/server/src/test/java/org/elasticsearch/indices/recovery/RecoveryTests.java
index 35f431e84eb9b..05aebcc459a6e 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/RecoveryTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/RecoveryTests.java
@@ -245,7 +245,7 @@ public void testRecoveryWithOutOfOrderDeleteWithSoftDeletes() throws Exception {
             IndexShard newReplica = shards.addReplicaWithExistingPath(orgPrimary.shardPath(), orgPrimary.routingEntry().currentNodeId());
             shards.recoverReplica(newReplica);
             shards.assertAllEqual(3);
-            try (Translog.Snapshot snapshot = newReplica.getHistoryOperations("test", 0)) {
+            try (Translog.Snapshot snapshot = newReplica.getHistoryOperations("test", Engine.HistorySource.INDEX, 0)) {
                 assertThat(snapshot, SnapshotMatchers.size(6));
             }
         }
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index 965e4ae37fa97..1eb52ac6de769 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -55,6 +55,7 @@
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.snapshots.SnapshotState;
 import org.elasticsearch.test.ESTestCase;
+import org.hamcrest.Matchers;
 import org.junit.After;
 import org.junit.AfterClass;
 import org.junit.Before;
@@ -1062,4 +1063,78 @@ private static boolean isXPackTemplate(String name) {
             return false;
         }
     }
+
+    public void flush(String index, boolean force) throws IOException {
+        logger.info("flushing index {} force={}", index, force);
+        final Request flushRequest = new Request("POST", "/" + index + "/_flush");
+        flushRequest.addParameter("force", Boolean.toString(force));
+        flushRequest.addParameter("wait_if_ongoing", "true");
+        assertOK(client().performRequest(flushRequest));
+    }
+
+    /**
+     * Asserts that replicas on nodes satisfying the {@code targetNode} should have perform operation-based recoveries.
+     */
+    public void assertNoFileBasedRecovery(String indexName, Predicate<String> targetNode) throws IOException {
+        Map<String, Object> recoveries = entityAsMap(client().performRequest(new Request("GET", indexName + "/_recovery?detailed=true")));
+        @SuppressWarnings("unchecked")
+        List<Map<String, ?>> shards = (List<Map<String, ?>>) XContentMapValues.extractValue(indexName + ".shards", recoveries);
+        assertNotNull(shards);
+        boolean foundReplica = false;
+        logger.info("index {} recovery stats {}", indexName, shards);
+        for (Map<String, ?> shard : shards) {
+            if (shard.get("primary") == Boolean.FALSE && targetNode.test((String) XContentMapValues.extractValue("target.name", shard))) {
+                List<?> details = (List<?>) XContentMapValues.extractValue("index.files.details", shard);
+                // once detailed recoveries works, remove this if.
+                if (details == null) {
+                    long totalFiles = ((Number) XContentMapValues.extractValue("index.files.total", shard)).longValue();
+                    long reusedFiles = ((Number) XContentMapValues.extractValue("index.files.reused", shard)).longValue();
+                    logger.info("total [{}] reused [{}]", totalFiles, reusedFiles);
+                    assertThat("must reuse all files, recoveries [" + recoveries + "]", totalFiles, equalTo(reusedFiles));
+                } else {
+                    assertNotNull(details);
+                    assertThat(details, Matchers.empty());
+                }
+                foundReplica = true;
+            }
+        }
+        assertTrue("must find replica", foundReplica);
+    }
+
+    /**
+     * Asserts that we do not retain any extra translog for the given index (i.e., turn off the translog retention)
+     */
+    public void assertEmptyTranslog(String index) throws Exception {
+        Map<String, Object> stats = entityAsMap(client().performRequest(new Request("GET", index + "/_stats?level=shards")));
+        assertThat(XContentMapValues.extractValue("indices." + index + ".total.translog.uncommitted_operations", stats), equalTo(0));
+        assertThat(XContentMapValues.extractValue("indices." + index + ".total.translog.operations", stats), equalTo(0));
+    }
+
+    /**
+     * Peer recovery retention leases are renewed and synced to replicas periodically (every 30 seconds). This ensures
+     * that we have renewed every PRRL to the global checkpoint of the corresponding copy and properly synced to all copies.
+     */
+    public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index) throws Exception {
+        assertBusy(() -> {
+            Map<String, Object> stats = entityAsMap(client().performRequest(new Request("GET", index + "/_stats?level=shards")));
+            @SuppressWarnings("unchecked") Map<String, List<Map<String, ?>>> shards =
+                (Map<String, List<Map<String, ?>>>) XContentMapValues.extractValue("indices." + index + ".shards", stats);
+            for (List<Map<String, ?>> shard : shards.values()) {
+                for (Map<String, ?> copy : shard) {
+                    Integer globalCheckpoint = (Integer) XContentMapValues.extractValue("seq_no.global_checkpoint", copy);
+                    assertNotNull(globalCheckpoint);
+                    @SuppressWarnings("unchecked") List<Map<String, ?>> retentionLeases =
+                        (List<Map<String, ?>>) XContentMapValues.extractValue("retention_leases.leases", copy);
+                    if (retentionLeases == null) {
+                        continue;
+                    }
+                    for (Map<String, ?> retentionLease : retentionLeases) {
+                        if (((String) retentionLease.get("id")).startsWith("peer_recovery/")) {
+                            assertThat(retentionLease.get("retaining_seq_no"), equalTo(globalCheckpoint + 1));
+                        }
+                    }
+                }
+            }
+        }, 60, TimeUnit.SECONDS);
+    }
 }
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
index b14403406dd66..2510a177056d3 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.index.engine.Engine;
 import org.elasticsearch.index.mapper.Uid;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.shard.IndexShardTestCase;
@@ -75,7 +76,7 @@ public void testPrimaryTermFromFollower() throws IOException {
                     operations,
                 numOps - 1, followerPrimary, logger);
 
-        try (Translog.Snapshot snapshot = followerPrimary.getHistoryOperations("test", 0)) {
+        try (Translog.Snapshot snapshot = followerPrimary.getHistoryOperations("test", Engine.HistorySource.INDEX, 0)) {
             assertThat(snapshot.totalOperations(), equalTo(operations.size()));
             Translog.Operation operation;
             while ((operation = snapshot.next()) != null) {

From 059cf8c561d713af9ca03b0fa4cf511a53c293c8 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 13 Dec 2019 17:05:34 -0500
Subject: [PATCH 205/686] Fix testTurnOffTranslogRetentionAfterAllShardStarted

We turn off the translog retention policy asynchronously using
 the generic threadpool; hence, we need to assert busily here

Relates #49448
---
 .../replication/RetentionLeasesReplicationTests.java     | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java b/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
index 7ca6c1ef1bf7f..d6c51c686cca7 100644
--- a/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
+++ b/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
@@ -163,9 +163,12 @@ public void testTurnOffTranslogRetentionAfterAllShardStarted() throws Exception
             }
             group.syncGlobalCheckpoint();
             group.flush();
-            for (IndexShard shard : group) {
-                assertThat(shard.translogStats().estimatedNumberOfOperations(), equalTo(0));
-            }
+            assertBusy(() -> {
+                // we turn off the translog retention policy using the generic threadPool
+                for (IndexShard shard : group) {
+                    assertThat(shard.translogStats().estimatedNumberOfOperations(), equalTo(0));
+                }
+            });
         }
     }
 

From 31906b3f1a9cbaf4c488a85682c367226308b24a Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Sat, 14 Dec 2019 21:14:41 -0500
Subject: [PATCH 206/686] Adjust bwc for #48430

Relates #48430
---
 .../java/org/elasticsearch/index/seqno/ReplicationTracker.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
index 14e78973504bc..8c42784b88f82 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
@@ -896,7 +896,7 @@ public ReplicationTracker(
         this.routingTable = null;
         this.replicationGroup = null;
         this.hasAllPeerRecoveryRetentionLeases = indexSettings.isSoftDeleteEnabled() &&
-            (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_8_0_0) ||
+            (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_6_0) ||
             (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_4_0) &&
              indexSettings.getIndexMetaData().getState() == IndexMetaData.State.OPEN));
         this.fileBasedRecoveryThreshold = IndexSettings.FILE_BASED_RECOVERY_THRESHOLD_SETTING.get(indexSettings.getSettings());

From 8b33f1509e19e203da40e4c5fbc845cb87be0760 Mon Sep 17 00:00:00 2001
From: David Roberts <dave.roberts@elastic.co>
Date: Sun, 15 Dec 2019 21:42:20 +0000
Subject: [PATCH 207/686] Change process kill order for testclusters shutdown
 (#50175)

The testclusters shutdown code was killing child processes
of the ES JVM before the ES JVM.  This causes any running
ML jobs to be recorded as failed, as the ES JVM notices that
they have disconnected from it without being told to stop,
as they would if they crashed.  In many test suites this
doesn't matter because the test cluster will never be
restarted, but in the case of upgrade tests it makes it
impossible to test what happens when an ML job is running
at the time of the upgrade.

This change reverses the order of killing the ES process
tree such that the parent processes are killed before their
children.  A list of children is stored before killing the
parent so that they can subsequently be killed (if they
don't exit by themselves as a side effect of the parent
dying).

Fixes #46262
---
 .../testclusters/ElasticsearchNode.java       | 51 ++++++++++---------
 .../upgrades/MlMappingsUpgradeIT.java         |  1 -
 2 files changed, 28 insertions(+), 24 deletions(-)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
index 2f258733e7575..f43f28190da1a 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
@@ -807,6 +807,7 @@ public synchronized void stop(boolean tailLogs) {
         requireNonNull(esProcess, "Can't stop `" + this + "` as it was not started or already stopped.");
         // Test clusters are not reused, don't spend time on a graceful shutdown
         stopHandle(esProcess.toHandle(), true);
+        reaper.unregister(toString());
         if (tailLogs) {
             logFileContents("Standard output of node", esStdoutFile);
             logFileContents("Standard error of node", esStderrFile);
@@ -831,39 +832,43 @@ public void setNameCustomization(Function<String, String> nameCustomizer) {
     }
 
     private void stopHandle(ProcessHandle processHandle, boolean forcibly) {
-        // Stop all children first, ES could actually be a child when there's some wrapper process like on Windows.
+        // No-op if the process has already exited by itself.
         if (processHandle.isAlive() == false) {
             LOGGER.info("Process was not running when we tried to terminate it.");
             return;
         }
 
-        // Stop all children first, ES could actually be a child when there's some wrapper process like on Windows.
-        processHandle.children().forEach(each -> stopHandle(each, forcibly));
+        // Stop all children last - if the ML processes are killed before the ES JVM then
+        // they'll be recorded as having failed and won't restart when the cluster restarts.
+        // ES could actually be a child when there's some wrapper process like on Windows,
+        // and in that case the ML processes will be grandchildren of the wrapper.
+        List<ProcessHandle> children = processHandle.children().collect(Collectors.toList());
+        try {
+            logProcessInfo(
+                "Terminating elasticsearch process" + (forcibly ? " forcibly " : "gracefully") + ":",
+                processHandle.info()
+            );
 
-        logProcessInfo(
-            "Terminating elasticsearch process" + (forcibly ? " forcibly " : "gracefully") + ":",
-            processHandle.info()
-        );
+            if (forcibly) {
+                processHandle.destroyForcibly();
+            } else {
+                processHandle.destroy();
+                waitForProcessToExit(processHandle);
+                if (processHandle.isAlive() == false) {
+                    return;
+                }
+                LOGGER.info("process did not terminate after {} {}, stopping it forcefully",
+                    ES_DESTROY_TIMEOUT, ES_DESTROY_TIMEOUT_UNIT);
+                processHandle.destroyForcibly();
+            }
 
-        if (forcibly) {
-            processHandle.destroyForcibly();
-        } else {
-            processHandle.destroy();
             waitForProcessToExit(processHandle);
-            if (processHandle.isAlive() == false) {
-                return;
+            if (processHandle.isAlive()) {
+                throw new TestClustersException("Was not able to terminate elasticsearch process for " + this);
             }
-            LOGGER.info("process did not terminate after {} {}, stopping it forcefully",
-                ES_DESTROY_TIMEOUT, ES_DESTROY_TIMEOUT_UNIT);
-            processHandle.destroyForcibly();
-        }
-
-        waitForProcessToExit(processHandle);
-        if (processHandle.isAlive()) {
-            throw new TestClustersException("Was not able to terminate elasticsearch process for " + this);
+        } finally {
+            children.forEach(each -> stopHandle(each, forcibly));
         }
-
-        reaper.unregister(toString());
     }
 
     private void logProcessInfo(String prefix, ProcessHandle.Info info) {
diff --git a/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/MlMappingsUpgradeIT.java b/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/MlMappingsUpgradeIT.java
index 8099812c8ea1b..13ed2dafc5f31 100644
--- a/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/MlMappingsUpgradeIT.java
+++ b/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/MlMappingsUpgradeIT.java
@@ -38,7 +38,6 @@ protected Collection<String> templatesToWaitFor() {
      * The purpose of this test is to ensure that when a job is open through a rolling upgrade we upgrade the results
      * index mappings when it is assigned to an upgraded node even if no other ML endpoint is called after the upgrade
      */
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/46262")
     public void testMappingsUpgrade() throws Exception {
 
         switch (CLUSTER_TYPE) {

From 3e01df9f07ee2470087c9bc2a038e620dbd60af1 Mon Sep 17 00:00:00 2001
From: Ignacio Vera <ivera@apache.org>
Date: Mon, 16 Dec 2019 07:43:42 +0100
Subject: [PATCH 208/686] "CONTAINS" support for BKD-backed geo_shape and shape
 fields (#50141)

Lucene 8.4 added support for "CONTAINS", therefore in this commit those
changes are integrated in Elasticsearch. This commit contains as well a
bug fix when querying with a geometry collection with "DISJOINT" relation.
---
 .../mapping/types/geo-shape.asciidoc          |  5 +-
 docs/reference/mapping/types/shape.asciidoc   |  6 +-
 .../query-dsl/geo-shape-query.asciidoc        |  3 +-
 docs/reference/query-dsl/shape-query.asciidoc |  8 +-
 .../common/geo/ShapeRelation.java             |  1 +
 .../query/VectorGeoShapeQueryProcessor.java   | 29 ++++--
 .../search/geo/GeoShapeQueryTests.java        | 99 ++++++++++++++++++-
 .../index/query/ShapeQueryProcessor.java      | 31 ++++--
 .../xpack/spatial/search/ShapeQueryTests.java | 95 ++++++++++++++++++
 9 files changed, 250 insertions(+), 27 deletions(-)

diff --git a/docs/reference/mapping/types/geo-shape.asciidoc b/docs/reference/mapping/types/geo-shape.asciidoc
index b39bf90609ae9..5ff464da9b995 100644
--- a/docs/reference/mapping/types/geo-shape.asciidoc
+++ b/docs/reference/mapping/types/geo-shape.asciidoc
@@ -142,9 +142,8 @@ The following features are not yet supported with the new indexing approach:
    using a `bool` query with each individual point.
 
 * `CONTAINS` relation query - when using the new default vector indexing strategy, `geo_shape`
-   queries with `relation` defined as `contains` are not yet supported. If this query relation
-   is an absolute necessity, it is recommended to set `strategy` to `quadtree` and use the
-   deprecated PrefixTree strategy indexing approach.
+   queries with `relation` defined as `contains` are supported for indices created with
+   ElasticSearch 7.5.0 or higher.
 
 [[prefix-trees]]
 [float]
diff --git a/docs/reference/mapping/types/shape.asciidoc b/docs/reference/mapping/types/shape.asciidoc
index 9874eb6cba525..3a180690ff44d 100644
--- a/docs/reference/mapping/types/shape.asciidoc
+++ b/docs/reference/mapping/types/shape.asciidoc
@@ -74,8 +74,8 @@ The following features are not yet supported:
    over each individual point. For now, if this is absolutely needed, this can be achieved
    using a `bool` query with each individual point. (Note: this could be very costly)
 
-* `CONTAINS` relation query - `shape` queries with `relation` defined as `contains` are not
-   yet supported.
+* `CONTAINS` relation query - `shape` queries with `relation` defined as `contains` are supported
+   for indices created with ElasticSearch 7.5.0 or higher.
 
 [float]
 ===== Example
@@ -445,4 +445,4 @@ POST /example/_doc
 Due to the complex input structure and index representation of shapes,
 it is not currently possible to sort shapes or retrieve their fields
 directly. The `shape` value is only retrievable through the `_source`
-field.
\ No newline at end of file
+field.
diff --git a/docs/reference/query-dsl/geo-shape-query.asciidoc b/docs/reference/query-dsl/geo-shape-query.asciidoc
index 35b56eb28e357..19a22ee103d91 100644
--- a/docs/reference/query-dsl/geo-shape-query.asciidoc
+++ b/docs/reference/query-dsl/geo-shape-query.asciidoc
@@ -151,8 +151,7 @@ has nothing in common with the query geometry.
 * `WITHIN` - Return all documents whose `geo_shape` field
 is within the query geometry.
 * `CONTAINS` - Return all documents whose `geo_shape` field
-contains the query geometry. Note: this is only supported using the
-`recursive` Prefix Tree Strategy deprecated[6.6]
+contains the query geometry.
 
 [float]
 ==== Ignore Unmapped
diff --git a/docs/reference/query-dsl/shape-query.asciidoc b/docs/reference/query-dsl/shape-query.asciidoc
index a9850c3bf6814..8b58ec40329f7 100644
--- a/docs/reference/query-dsl/shape-query.asciidoc
+++ b/docs/reference/query-dsl/shape-query.asciidoc
@@ -170,12 +170,14 @@ GET /example/_search
 
 The following is a complete list of spatial relation operators available:
 
-* `INTERSECTS` - (default) Return all documents whose `geo_shape` field
+* `INTERSECTS` - (default) Return all documents whose `shape` field
 intersects the query geometry.
-* `DISJOINT` - Return all documents whose `geo_shape` field
+* `DISJOINT` - Return all documents whose `shape` field
 has nothing in common with the query geometry.
-* `WITHIN` - Return all documents whose `geo_shape` field
+* `WITHIN` - Return all documents whose `shape` field
 is within the query geometry.
+* `CONTAINS` - Return all documents whose `shape` field
+contains the query geometry.
 
 [float]
 ==== Ignore Unmapped
diff --git a/server/src/main/java/org/elasticsearch/common/geo/ShapeRelation.java b/server/src/main/java/org/elasticsearch/common/geo/ShapeRelation.java
index 23ba2f3ef6980..ac4481281a1c6 100644
--- a/server/src/main/java/org/elasticsearch/common/geo/ShapeRelation.java
+++ b/server/src/main/java/org/elasticsearch/common/geo/ShapeRelation.java
@@ -69,6 +69,7 @@ public QueryRelation getLuceneRelation() {
             case INTERSECTS: return QueryRelation.INTERSECTS;
             case DISJOINT: return QueryRelation.DISJOINT;
             case WITHIN: return QueryRelation.WITHIN;
+            case CONTAINS: return QueryRelation.CONTAINS;
             default:
                 throw new IllegalArgumentException("ShapeRelation [" + this + "] not supported");
         }
diff --git a/server/src/main/java/org/elasticsearch/index/query/VectorGeoShapeQueryProcessor.java b/server/src/main/java/org/elasticsearch/index/query/VectorGeoShapeQueryProcessor.java
index 2f21037be33b4..adbdf269234f5 100644
--- a/server/src/main/java/org/elasticsearch/index/query/VectorGeoShapeQueryProcessor.java
+++ b/server/src/main/java/org/elasticsearch/index/query/VectorGeoShapeQueryProcessor.java
@@ -20,12 +20,14 @@
 package org.elasticsearch.index.query;
 
 import org.apache.lucene.document.LatLonShape;
+import org.apache.lucene.document.ShapeField;
 import org.apache.lucene.geo.Line;
 import org.apache.lucene.geo.Polygon;
 import org.apache.lucene.search.BooleanClause;
 import org.apache.lucene.search.BooleanQuery;
 import org.apache.lucene.search.MatchNoDocsQuery;
 import org.apache.lucene.search.Query;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.geo.GeoShapeType;
 import org.elasticsearch.common.geo.ShapeRelation;
 import org.elasticsearch.geometry.Circle;
@@ -49,10 +51,10 @@ public class VectorGeoShapeQueryProcessor implements AbstractGeometryFieldMapper
 
     @Override
     public Query process(Geometry shape, String fieldName, ShapeRelation relation, QueryShardContext context) {
-        // CONTAINS queries are not yet supported by VECTOR strategy
-        if (relation == ShapeRelation.CONTAINS) {
+        // CONTAINS queries are not supported by VECTOR strategy for indices created before version 7.5.0 (Lucene 8.3.0)
+        if (relation == ShapeRelation.CONTAINS && context.indexVersionCreated().before(Version.V_7_5_0)) {
             throw new QueryShardException(context,
-                ShapeRelation.CONTAINS + " query relation not supported for Field [" + fieldName + "]");
+                ShapeRelation.CONTAINS + " query relation not supported for Field [" + fieldName + "].");
         }
         // wrap geoQuery as a ConstantScoreQuery
         return getVectorQueryFromShape(shape, fieldName, relation, context);
@@ -95,12 +97,21 @@ public Query visit(GeometryCollection<?> collection) {
         }
 
         private void visit(BooleanQuery.Builder bqb, GeometryCollection<?> collection) {
+            BooleanClause.Occur occur;
+            if (relation == ShapeRelation.CONTAINS || relation == ShapeRelation.DISJOINT) {
+                // all shapes must be disjoint / must be contained in relation to the indexed shape.
+                occur = BooleanClause.Occur.MUST;
+            } else {
+                // at least one shape must intersect / contain the indexed shape.
+                occur = BooleanClause.Occur.SHOULD;
+            }
             for (Geometry shape : collection) {
                 if (shape instanceof MultiPoint) {
-                    // Flatten multipoints
+                    // Flatten multi-points
+                    // We do not support multi-point queries?
                     visit(bqb, (GeometryCollection<?>) shape);
                 } else {
-                    bqb.add(shape.visit(this), BooleanClause.Occur.SHOULD);
+                    bqb.add(shape.visit(this), occur);
                 }
             }
         }
@@ -144,7 +155,13 @@ public Query visit(MultiPolygon multiPolygon) {
         @Override
         public Query visit(Point point) {
             validateIsGeoShapeFieldType();
-            return LatLonShape.newBoxQuery(fieldName, relation.getLuceneRelation(),
+            ShapeField.QueryRelation luceneRelation = relation.getLuceneRelation();
+            if (luceneRelation == ShapeField.QueryRelation.CONTAINS) {
+                // contains and intersects are equivalent but the implementation of
+                // intersects is more efficient.
+                luceneRelation = ShapeField.QueryRelation.INTERSECTS;
+            }
+            return LatLonShape.newBoxQuery(fieldName, luceneRelation,
                 point.getY(), point.getY(), point.getX(), point.getX());
         }
 
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
index 021fd47350789..8ed913242ebda 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
@@ -447,10 +447,30 @@ public void testPointQuery() throws Exception {
     public void testContainsShapeQuery() throws Exception {
         // Create a random geometry collection.
         Rectangle mbr = xRandomRectangle(random(), xRandomPoint(random()), true);
-        GeometryCollectionBuilder gcb = createGeometryCollectionWithin(random(), mbr);
+        boolean usePrefixTrees = randomBoolean();
+        GeometryCollectionBuilder gcb;
+        if (usePrefixTrees) {
+            gcb = createGeometryCollectionWithin(random(), mbr);
+        } else {
+            // vector strategy does not yet support multipoint queries
+            gcb = new GeometryCollectionBuilder();
+            int numShapes = RandomNumbers.randomIntBetween(random(), 1, 4);
+            for (int i = 0; i < numShapes; ++i) {
+                ShapeBuilder shape;
+                do {
+                    shape = RandomShapeGenerator.createShapeWithin(random(), mbr);
+                } while (shape instanceof MultiPointBuilder);
+                gcb.shape(shape);
+            }
+        }
 
-        client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape,tree=quadtree" )
-                .get();
+        if (usePrefixTrees) {
+            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape,tree=quadtree")
+                .execute().actionGet();
+        } else {
+            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape")
+                .execute().actionGet();
+        }
 
         XContentBuilder docSource = gcb.toXContent(jsonBuilder().startObject().field("location"), null).endObject();
         client().prepareIndex("test").setId("1").setSource(docSource).setRefreshPolicy(IMMEDIATE).get();
@@ -727,4 +747,77 @@ public void testEnvelopeSpanningDateline() throws IOException {
         assertNotEquals("1", response.getHits().getAt(0).getId());
         assertNotEquals("1", response.getHits().getAt(1).getId());
     }
+
+    public void testGeometryCollectionRelations() throws IOException {
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject()
+            .startObject("doc")
+            .startObject("properties")
+            .startObject("geo").field("type", "geo_shape").endObject()
+            .endObject()
+            .endObject()
+            .endObject();
+
+        createIndex("test", Settings.builder().put("index.number_of_shards", 1).build(), "doc", mapping);
+
+        EnvelopeBuilder envelopeBuilder = new EnvelopeBuilder(new Coordinate(-10, 10), new Coordinate(10, -10));
+
+        client().index(new IndexRequest("test")
+            .source(jsonBuilder().startObject().field("geo", envelopeBuilder).endObject())
+            .setRefreshPolicy(IMMEDIATE)).actionGet();
+
+        {
+            // A geometry collection that is fully within the indexed shape
+            GeometryCollectionBuilder builder = new GeometryCollectionBuilder();
+            builder.shape(new PointBuilder(1, 2));
+            builder.shape(new PointBuilder(-2, -1));
+            SearchResponse response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.CONTAINS))
+                .get();
+            assertEquals(1, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.INTERSECTS))
+                .get();
+            assertEquals(1, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.DISJOINT))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+        }
+        // A geometry collection that is partially within the indexed shape
+        {
+            GeometryCollectionBuilder builder = new GeometryCollectionBuilder();
+            builder.shape(new PointBuilder(1, 2));
+            builder.shape(new PointBuilder(20, 30));
+            SearchResponse response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.CONTAINS))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.INTERSECTS))
+                .get();
+            assertEquals(1, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.DISJOINT))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+        }
+        {
+            // A geometry collection that is disjoint with the indexed shape
+            GeometryCollectionBuilder builder = new GeometryCollectionBuilder();
+            builder.shape(new PointBuilder(-20, -30));
+            builder.shape(new PointBuilder(20, 30));
+            SearchResponse response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.CONTAINS))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.INTERSECTS))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test")
+                .setQuery(geoShapeQuery("geo", builder.buildGeometry()).relation(ShapeRelation.DISJOINT))
+                .get();
+            assertEquals(1, response.getHits().getTotalHits().value);
+        }
+    }
 }
diff --git a/x-pack/plugin/spatial/src/main/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryProcessor.java b/x-pack/plugin/spatial/src/main/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryProcessor.java
index f95bc7e73d7ca..ee4cb2f5ba3ea 100644
--- a/x-pack/plugin/spatial/src/main/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryProcessor.java
+++ b/x-pack/plugin/spatial/src/main/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryProcessor.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.spatial.index.query;
 
+import org.apache.lucene.document.ShapeField;
 import org.apache.lucene.document.XYShape;
 import org.apache.lucene.geo.XYLine;
 import org.apache.lucene.geo.XYPolygon;
@@ -13,6 +14,7 @@
 import org.apache.lucene.search.ConstantScoreQuery;
 import org.apache.lucene.search.MatchNoDocsQuery;
 import org.apache.lucene.search.Query;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.geo.GeoShapeType;
 import org.elasticsearch.common.geo.ShapeRelation;
 import org.elasticsearch.geometry.Circle;
@@ -38,14 +40,14 @@ public class ShapeQueryProcessor implements AbstractGeometryFieldMapper.QueryPro
 
     @Override
     public Query process(Geometry shape, String fieldName, ShapeRelation relation, QueryShardContext context) {
-        // CONTAINS queries are not yet supported by VECTOR strategy
-        if (relation == ShapeRelation.CONTAINS) {
-            throw new QueryShardException(context,
-                ShapeRelation.CONTAINS + " query relation not supported for Field [" + fieldName + "]");
-        }
         if (shape == null) {
             return new MatchNoDocsQuery();
         }
+        // CONTAINS queries are not supported by VECTOR strategy for indices created before version 7.5.0 (Lucene 8.3.0);
+        if (relation == ShapeRelation.CONTAINS && context.indexVersionCreated().before(Version.V_7_5_0)) {
+            throw new QueryShardException(context,
+                ShapeRelation.CONTAINS + " query relation not supported for Field [" + fieldName + "].");
+        }
         // wrap geometry Query as a ConstantScoreQuery
         return new ConstantScoreQuery(shape.visit(new ShapeVisitor(context, fieldName, relation)));
     }
@@ -76,12 +78,21 @@ public Query visit(GeometryCollection<?> collection) {
         }
 
         private void visit(BooleanQuery.Builder bqb, GeometryCollection<?> collection) {
+            BooleanClause.Occur occur;
+            if (relation == ShapeRelation.CONTAINS || relation == ShapeRelation.DISJOINT) {
+                // all shapes must be disjoint / must be contained in relation to the indexed shape.
+                occur = BooleanClause.Occur.MUST;
+            } else {
+                // at least one shape must intersect / contain the indexed shape.
+                occur = BooleanClause.Occur.SHOULD;
+            }
             for (Geometry shape : collection) {
                 if (shape instanceof MultiPoint) {
                     // Flatten multipoints
+                    // We do not support multi-point queries?
                     visit(bqb, (GeometryCollection<?>) shape);
                 } else {
-                    bqb.add(shape.visit(this), BooleanClause.Occur.SHOULD);
+                    bqb.add(shape.visit(this), occur);
                 }
             }
         }
@@ -128,7 +139,13 @@ private Query visitMultiPolygon(XYPolygon... polygons) {
 
         @Override
         public Query visit(Point point) {
-            return XYShape.newBoxQuery(fieldName, relation.getLuceneRelation(),
+            ShapeField.QueryRelation luceneRelation = relation.getLuceneRelation();
+            if (luceneRelation == ShapeField.QueryRelation.CONTAINS) {
+                // contains and intersects are equivalent but the implementation of
+                // intersects is more efficient.
+                luceneRelation = ShapeField.QueryRelation.INTERSECTS;
+            }
+            return XYShape.newBoxQuery(fieldName, luceneRelation,
                 (float)point.getX(), (float)point.getX(), (float)point.getY(), (float)point.getY());
         }
 
diff --git a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
index 682b377c50355..1d11c54b69e47 100644
--- a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
+++ b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
@@ -6,10 +6,14 @@
 package org.elasticsearch.xpack.spatial.search;
 
 import org.elasticsearch.action.get.GetResponse;
+import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.common.geo.GeoJson;
 import org.elasticsearch.common.geo.ShapeRelation;
 import org.elasticsearch.common.geo.builders.EnvelopeBuilder;
+import org.elasticsearch.common.geo.builders.GeometryCollectionBuilder;
+import org.elasticsearch.common.geo.builders.PointBuilder;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
@@ -25,6 +29,7 @@
 import org.elasticsearch.xpack.spatial.util.ShapeTestUtils;
 import org.locationtech.jts.geom.Coordinate;
 
+import java.io.IOException;
 import java.util.Collection;
 import java.util.Locale;
 
@@ -239,4 +244,94 @@ public void testFieldAlias() {
             .get();
         assertTrue(response.getHits().getTotalHits().value > 0);
     }
+
+    public void testContainsShapeQuery() {
+
+        client().admin().indices().prepareCreate("test_contains").addMapping("type", "location", "type=shape")
+            .execute().actionGet();
+
+        String doc = "{\"location\" : {\"type\":\"envelope\", \"coordinates\":[ [-100.0, 100.0], [100.0, -100.0]]}}";
+        client().prepareIndex("test_contains").setId("1").setSource(doc, XContentType.JSON).setRefreshPolicy(IMMEDIATE).get();
+
+        // index the mbr of the collection
+        EnvelopeBuilder queryShape = new EnvelopeBuilder(new Coordinate(-50, 50), new Coordinate(50, -50));
+        ShapeQueryBuilder queryBuilder = new ShapeQueryBuilder("location", queryShape.buildGeometry()).relation(ShapeRelation.CONTAINS);
+        SearchResponse response = client().prepareSearch("test_contains").setQuery(queryBuilder).get();
+        assertSearchResponse(response);
+
+        assertThat(response.getHits().getTotalHits().value, equalTo(1L));
+    }
+
+    public void testGeometryCollectionRelations() throws IOException {
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject()
+            .startObject("doc")
+            .startObject("properties")
+            .startObject("geometry").field("type", "shape").endObject()
+            .endObject()
+            .endObject()
+            .endObject();
+
+        createIndex("test_collections", Settings.builder().put("index.number_of_shards", 1).build(), "doc", mapping);
+
+        EnvelopeBuilder envelopeBuilder = new EnvelopeBuilder(new Coordinate(-10, 10), new Coordinate(10, -10));
+
+        client().index(new IndexRequest("test_collections")
+            .source(jsonBuilder().startObject().field("geometry", envelopeBuilder).endObject())
+            .setRefreshPolicy(IMMEDIATE)).actionGet();
+
+        {
+            // A geometry collection that is fully within the indexed shape
+            GeometryCollectionBuilder builder = new GeometryCollectionBuilder();
+            builder.shape(new PointBuilder(1, 2));
+            builder.shape(new PointBuilder(-2, -1));
+            SearchResponse response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.CONTAINS))
+                .get();
+            assertEquals(1, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.INTERSECTS))
+                .get();
+            assertEquals(1, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.DISJOINT))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+        }
+        {
+            // A geometry collection that is partially within the indexed shape
+            GeometryCollectionBuilder builder = new GeometryCollectionBuilder();
+            builder.shape(new PointBuilder(1, 2));
+            builder.shape(new PointBuilder(20, 30));
+            SearchResponse response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.CONTAINS))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.INTERSECTS))
+                .get();
+            assertEquals(1, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.DISJOINT))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+        }
+        {
+            // A geometry collection that is disjoint with the indexed shape
+            GeometryCollectionBuilder builder = new GeometryCollectionBuilder();
+            builder.shape(new PointBuilder(-20, -30));
+            builder.shape(new PointBuilder(20, 30));
+            SearchResponse response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.CONTAINS))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.INTERSECTS))
+                .get();
+            assertEquals(0, response.getHits().getTotalHits().value);
+            response = client().prepareSearch("test_collections")
+                .setQuery(new ShapeQueryBuilder("geometry", builder.buildGeometry()).relation(ShapeRelation.DISJOINT))
+                .get();
+            assertEquals(1, response.getHits().getTotalHits().value);
+        }
+    }
 }

From 9114051a2442a21150520cc746c9e8639ea25216 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 16 Dec 2019 10:39:26 +0100
Subject: [PATCH 209/686] Remove BlobContainer Tests against Mocks (#50194)

* Remove BlobContainer Tests against Mocks

Removing all these weird mocks as asked for by #30424.
All these tests are now part of real repository ITs and otherwise left unchanged if they had
independent tests that didn't call the `createBlobStore` method previously.
The HDFS tests also get added coverage as a side-effect because they did not have an implementation
of the abstract repository ITs.

Closes #30424
---
 .../azure/AzureBlobContainerRetriesTests.java |   2 +-
 .../azure/AzureBlobStoreContainerTests.java   |  53 --
 .../azure/AzureStorageServiceMock.java        | 167 -----
 .../cloud/storage/StorageRpcOptionUtils.java  |  43 --
 .../cloud/storage/StorageTestUtils.java       |  37 --
 ...CloudStorageBlobContainerRetriesTests.java |   2 +-
 ...leCloudStorageBlobStoreContainerTests.java |  47 +-
 ...eCloudStorageBlobStoreRepositoryTests.java |  33 +
 .../repositories/gcs/MockStorage.java         | 574 ------------------
 .../hdfs/HdfsBlobStoreContainerTests.java     |  16 +-
 .../hdfs/HdfsBlobStoreRepositoryTests.java    |  55 ++
 .../hdfs/HdfsRepositoryTests.java             |   2 +-
 .../repositories/s3/MockAmazonS3.java         | 169 ------
 .../s3/S3BlobStoreContainerTests.java         |  50 +-
 .../fs/FsBlobStoreContainerTests.java         |  81 ---
 .../fs/FsBlobStoreRepositoryIT.java           |  41 +-
 .../ESBlobStoreContainerTestCase.java         | 213 -------
 .../ESBlobStoreRepositoryIntegTestCase.java   | 172 ++++++
 .../security/authc/TokenServiceTests.java     |   2 +-
 19 files changed, 314 insertions(+), 1445 deletions(-)
 delete mode 100644 plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureBlobStoreContainerTests.java
 delete mode 100644 plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureStorageServiceMock.java
 delete mode 100644 plugins/repository-gcs/src/test/java/com/google/cloud/storage/StorageRpcOptionUtils.java
 delete mode 100644 plugins/repository-gcs/src/test/java/com/google/cloud/storage/StorageTestUtils.java
 delete mode 100644 plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/MockStorage.java
 create mode 100644 plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsBlobStoreRepositoryTests.java
 delete mode 100644 plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/MockAmazonS3.java
 delete mode 100644 server/src/test/java/org/elasticsearch/common/blobstore/fs/FsBlobStoreContainerTests.java
 delete mode 100644 test/framework/src/main/java/org/elasticsearch/repositories/ESBlobStoreContainerTestCase.java

diff --git a/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureBlobContainerRetriesTests.java b/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureBlobContainerRetriesTests.java
index 1c069ca189951..ce3cba065c35b 100644
--- a/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureBlobContainerRetriesTests.java
+++ b/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureBlobContainerRetriesTests.java
@@ -72,13 +72,13 @@
 import java.util.stream.Collectors;
 
 import static java.nio.charset.StandardCharsets.UTF_8;
-import static org.elasticsearch.repositories.ESBlobStoreContainerTestCase.randomBytes;
 import static org.elasticsearch.repositories.azure.AzureRepository.Repository.CONTAINER_SETTING;
 import static org.elasticsearch.repositories.azure.AzureStorageSettings.ACCOUNT_SETTING;
 import static org.elasticsearch.repositories.azure.AzureStorageSettings.ENDPOINT_SUFFIX_SETTING;
 import static org.elasticsearch.repositories.azure.AzureStorageSettings.KEY_SETTING;
 import static org.elasticsearch.repositories.azure.AzureStorageSettings.MAX_RETRIES_SETTING;
 import static org.elasticsearch.repositories.azure.AzureStorageSettings.TIMEOUT_SETTING;
+import static org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase.randomBytes;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
diff --git a/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureBlobStoreContainerTests.java b/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureBlobStoreContainerTests.java
deleted file mode 100644
index 07d0a1e18d3bd..0000000000000
--- a/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureBlobStoreContainerTests.java
+++ /dev/null
@@ -1,53 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.repositories.azure;
-
-import org.elasticsearch.cluster.metadata.RepositoryMetaData;
-import org.elasticsearch.common.blobstore.BlobStore;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.repositories.ESBlobStoreContainerTestCase;
-import org.elasticsearch.threadpool.TestThreadPool;
-import org.elasticsearch.threadpool.ThreadPool;
-
-import java.util.concurrent.TimeUnit;
-
-public class AzureBlobStoreContainerTests extends ESBlobStoreContainerTestCase {
-
-    private ThreadPool threadPool;
-
-    @Override
-    public void setUp() throws Exception {
-        super.setUp();
-        threadPool = new TestThreadPool("AzureBlobStoreTests", AzureRepositoryPlugin.executorBuilder());
-    }
-
-    @Override
-    public void tearDown() throws Exception {
-        super.tearDown();
-        ThreadPool.terminate(threadPool, 10L, TimeUnit.SECONDS);
-    }
-
-    @Override
-    protected BlobStore newBlobStore() {
-        RepositoryMetaData repositoryMetaData = new RepositoryMetaData("azure", "ittest", Settings.EMPTY);
-        AzureStorageServiceMock client = new AzureStorageServiceMock();
-        return new AzureBlobStore(repositoryMetaData, client, threadPool);
-    }
-}
diff --git a/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureStorageServiceMock.java b/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureStorageServiceMock.java
deleted file mode 100644
index 2217b6743fb2e..0000000000000
--- a/plugins/repository-azure/src/test/java/org/elasticsearch/repositories/azure/AzureStorageServiceMock.java
+++ /dev/null
@@ -1,167 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.repositories.azure;
-
-import com.microsoft.azure.storage.OperationContext;
-import com.microsoft.azure.storage.StorageException;
-import com.microsoft.azure.storage.blob.CloudBlobClient;
-import org.elasticsearch.common.blobstore.BlobMetaData;
-import org.elasticsearch.common.blobstore.support.PlainBlobMetaData;
-import org.elasticsearch.common.collect.Tuple;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.core.internal.io.Streams;
-
-import java.io.ByteArrayInputStream;
-import java.io.ByteArrayOutputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.net.SocketPermission;
-import java.nio.file.FileAlreadyExistsException;
-import java.nio.file.NoSuchFileException;
-import java.security.AccessController;
-import java.util.HashMap;
-import java.util.Locale;
-import java.util.Map;
-import java.util.concurrent.ConcurrentHashMap;
-import java.util.function.Supplier;
-
-import static java.util.Collections.emptyMap;
-
-/**
- * In memory storage for unit tests
- */
-public class AzureStorageServiceMock extends AzureStorageService {
-
-    protected final Map<String, ByteArrayOutputStream> blobs = new ConcurrentHashMap<>();
-
-    public AzureStorageServiceMock() {
-        super(Settings.EMPTY);
-    }
-
-    @Override
-    public boolean blobExists(String account, String container, String blob) {
-        return blobs.containsKey(blob);
-    }
-
-    @Override
-    public void deleteBlob(String account, String container, String blob) throws StorageException {
-        if (blobs.remove(blob) == null) {
-            throw new StorageException("BlobNotFound", "[" + blob + "] does not exist.", 404, null, null);
-        }
-    }
-
-    @Override
-    public InputStream getInputStream(String account, String container, String blob) throws IOException {
-        if (!blobExists(account, container, blob)) {
-            throw new NoSuchFileException("missing blob [" + blob + "]");
-        }
-        return AzureStorageService.giveSocketPermissionsToStream(new PermissionRequiringInputStream(blobs.get(blob).toByteArray()));
-    }
-
-    @Override
-    public Map<String, BlobMetaData> listBlobsByPrefix(String account, String container, String keyPath, String prefix) {
-        final var blobsBuilder = new HashMap<String, BlobMetaData>();
-        blobs.forEach((String blobName, ByteArrayOutputStream bos) -> {
-            final String checkBlob;
-            if (keyPath != null && !keyPath.isEmpty()) {
-                // strip off key path from the beginning of the blob name
-                checkBlob = blobName.replace(keyPath, "");
-            } else {
-                checkBlob = blobName;
-            }
-            if (prefix == null || startsWithIgnoreCase(checkBlob, prefix)) {
-                blobsBuilder.put(blobName, new PlainBlobMetaData(checkBlob, bos.size()));
-            }
-        });
-        return Map.copyOf(blobsBuilder);
-    }
-
-    @Override
-    public void writeBlob(String account, String container, String blobName, InputStream inputStream, long blobSize,
-                          boolean failIfAlreadyExists) throws StorageException, FileAlreadyExistsException {
-        if (failIfAlreadyExists && blobs.containsKey(blobName)) {
-            throw new FileAlreadyExistsException(blobName);
-        }
-        try (ByteArrayOutputStream outputStream = new ByteArrayOutputStream()) {
-            blobs.put(blobName, outputStream);
-            Streams.copy(inputStream, outputStream);
-        } catch (IOException e) {
-            throw new StorageException("MOCK", "Error while writing mock stream", e);
-        }
-    }
-
-    /**
-     * Test if the given String starts with the specified prefix,
-     * ignoring upper/lower case.
-     *
-     * @param str    the String to check
-     * @param prefix the prefix to look for
-     * @see java.lang.String#startsWith
-     */
-    private static boolean startsWithIgnoreCase(String str, String prefix) {
-        if (str == null || prefix == null) {
-            return false;
-        }
-        if (str.startsWith(prefix)) {
-            return true;
-        }
-        if (str.length() < prefix.length()) {
-            return false;
-        }
-        String lcStr = str.substring(0, prefix.length()).toLowerCase(Locale.ROOT);
-        String lcPrefix = prefix.toLowerCase(Locale.ROOT);
-        return lcStr.equals(lcPrefix);
-    }
-
-    private static class PermissionRequiringInputStream extends ByteArrayInputStream {
-
-        private PermissionRequiringInputStream(byte[] buf) {
-            super(buf);
-        }
-
-        @Override
-        public synchronized int read() {
-            AccessController.checkPermission(new SocketPermission("*", "connect"));
-            return super.read();
-        }
-
-        @Override
-        public int read(byte[] b) throws IOException {
-            AccessController.checkPermission(new SocketPermission("*", "connect"));
-            return super.read(b);
-        }
-
-        @Override
-        public synchronized int read(byte[] b, int off, int len) {
-            AccessController.checkPermission(new SocketPermission("*", "connect"));
-            return super.read(b, off, len);
-        }
-    }
-
-    @Override
-    public Tuple<CloudBlobClient, Supplier<OperationContext>> client(String clientName) {
-        return null;
-    }
-
-    @Override
-    public Map<String, AzureStorageSettings> refreshAndClearCache(Map<String, AzureStorageSettings> clientsSettings) {
-        return emptyMap();
-    }
-}
diff --git a/plugins/repository-gcs/src/test/java/com/google/cloud/storage/StorageRpcOptionUtils.java b/plugins/repository-gcs/src/test/java/com/google/cloud/storage/StorageRpcOptionUtils.java
deleted file mode 100644
index a08ae2f9f8a8a..0000000000000
--- a/plugins/repository-gcs/src/test/java/com/google/cloud/storage/StorageRpcOptionUtils.java
+++ /dev/null
@@ -1,43 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package com.google.cloud.storage;
-
-import com.google.cloud.storage.spi.v1.StorageRpc;
-
-/**
- * Utility class that exposed Google SDK package protected methods to
- * create specific StorageRpc objects in unit tests.
- */
-public class StorageRpcOptionUtils {
-
-    private StorageRpcOptionUtils(){}
-
-    public static String getPrefix(final Storage.BlobListOption... options) {
-        if (options != null) {
-            for (final Option option : options) {
-                final StorageRpc.Option rpcOption = option.getRpcOption();
-                if (StorageRpc.Option.PREFIX.equals(rpcOption)) {
-                    return (String) option.getValue();
-                }
-            }
-        }
-        return null;
-    }
-}
diff --git a/plugins/repository-gcs/src/test/java/com/google/cloud/storage/StorageTestUtils.java b/plugins/repository-gcs/src/test/java/com/google/cloud/storage/StorageTestUtils.java
deleted file mode 100644
index 68175d7f1be53..0000000000000
--- a/plugins/repository-gcs/src/test/java/com/google/cloud/storage/StorageTestUtils.java
+++ /dev/null
@@ -1,37 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package com.google.cloud.storage;
-
-/**
- * Utility class that exposed Google SDK package protected methods to
- * create buckets and blobs objects in unit tests.
- */
-public class StorageTestUtils {
-
-    private StorageTestUtils(){}
-
-    public static Bucket createBucket(final Storage storage, final String bucketName) {
-        return new Bucket(storage, (BucketInfo.BuilderImpl) BucketInfo.newBuilder(bucketName));
-    }
-
-    public static Blob createBlob(final Storage storage, final String bucketName, final String blobName, final long blobSize) {
-        return new Blob(storage, (BlobInfo.BuilderImpl) BlobInfo.newBuilder(bucketName, blobName).setSize(blobSize));
-    }
-}
diff --git a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainerRetriesTests.java b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainerRetriesTests.java
index 00dbf758422f7..23203e8d4a9e0 100644
--- a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainerRetriesTests.java
+++ b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainerRetriesTests.java
@@ -74,7 +74,7 @@
 import static fixture.gcs.GoogleCloudStorageHttpHandler.getContentRangeStart;
 import static fixture.gcs.GoogleCloudStorageHttpHandler.parseMultipartRequestBody;
 import static java.nio.charset.StandardCharsets.UTF_8;
-import static org.elasticsearch.repositories.ESBlobStoreContainerTestCase.randomBytes;
+import static org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase.randomBytes;
 import static org.elasticsearch.repositories.gcs.GoogleCloudStorageClientSettings.CREDENTIALS_FILE_SETTING;
 import static org.elasticsearch.repositories.gcs.GoogleCloudStorageClientSettings.ENDPOINT_SETTING;
 import static org.elasticsearch.repositories.gcs.GoogleCloudStorageClientSettings.READ_TIMEOUT_SETTING;
diff --git a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreContainerTests.java b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreContainerTests.java
index 311544160ad73..de75e5b825570 100644
--- a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreContainerTests.java
+++ b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreContainerTests.java
@@ -26,20 +26,14 @@
 import com.google.cloud.storage.StorageBatch;
 import com.google.cloud.storage.StorageBatchResult;
 import com.google.cloud.storage.StorageException;
-import org.apache.lucene.util.BytesRef;
-import org.apache.lucene.util.BytesRefBuilder;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.blobstore.BlobStore;
-import org.elasticsearch.common.bytes.BytesArray;
-import org.elasticsearch.repositories.ESBlobStoreContainerTestCase;
+import org.elasticsearch.test.ESTestCase;
 
 import java.io.IOException;
-import java.io.InputStream;
 import java.util.Arrays;
 import java.util.List;
-import java.util.Locale;
-import java.util.concurrent.ConcurrentHashMap;
 
 import static org.hamcrest.Matchers.instanceOf;
 import static org.mockito.Matchers.any;
@@ -51,44 +45,7 @@
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
-public class GoogleCloudStorageBlobStoreContainerTests extends ESBlobStoreContainerTestCase {
-
-    @Override
-    protected BlobStore newBlobStore() {
-        final String bucketName = randomAlphaOfLength(randomIntBetween(1, 10)).toLowerCase(Locale.ROOT);
-        final String clientName = randomAlphaOfLength(randomIntBetween(1, 10)).toLowerCase(Locale.ROOT);
-        final GoogleCloudStorageService storageService = mock(GoogleCloudStorageService.class);
-        try {
-            when(storageService.client(any(String.class))).thenReturn(new MockStorage(bucketName, new ConcurrentHashMap<>(), random()));
-        } catch (final Exception e) {
-            throw new RuntimeException(e);
-        }
-        return new GoogleCloudStorageBlobStore(bucketName, clientName, storageService);
-    }
-
-    public void testWriteReadLarge() throws IOException {
-        try(BlobStore store = newBlobStore()) {
-            final BlobContainer container = store.blobContainer(new BlobPath());
-            byte[] data = randomBytes(GoogleCloudStorageBlobStore.LARGE_BLOB_THRESHOLD_BYTE_SIZE + 1);
-            writeBlob(container, "foobar", new BytesArray(data), randomBoolean());
-            if (randomBoolean()) {
-                // override file, to check if we get latest contents
-                random().nextBytes(data);
-                writeBlob(container, "foobar", new BytesArray(data), false);
-            }
-            try (InputStream stream = container.readBlob("foobar")) {
-                BytesRefBuilder target = new BytesRefBuilder();
-                while (target.length() < data.length) {
-                    byte[] buffer = new byte[scaledRandomIntBetween(1, data.length - target.length())];
-                    int offset = scaledRandomIntBetween(0, buffer.length - 1);
-                    int read = stream.read(buffer, offset, buffer.length - offset);
-                    target.append(new BytesRef(buffer, offset, read));
-                }
-                assertEquals(data.length, target.length());
-                assertArrayEquals(data, Arrays.copyOfRange(target.bytes(), 0, target.length()));
-            }
-        }
-    }
+public class GoogleCloudStorageBlobStoreContainerTests extends ESTestCase {
 
     @SuppressWarnings("unchecked")
     public void testDeleteBlobsIgnoringIfNotExistsThrowsIOException() throws Exception {
diff --git a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
index d8926b25e2c49..0333d96510397 100644
--- a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
+++ b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobStoreRepositoryTests.java
@@ -26,11 +26,17 @@
 import com.sun.net.httpserver.HttpHandler;
 import fixture.gcs.FakeOAuth2HttpHandler;
 import fixture.gcs.GoogleCloudStorageHttpHandler;
+import org.apache.lucene.util.BytesRef;
+import org.apache.lucene.util.BytesRefBuilder;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.SuppressForbidden;
+import org.elasticsearch.common.blobstore.BlobContainer;
+import org.elasticsearch.common.blobstore.BlobPath;
+import org.elasticsearch.common.blobstore.BlobStore;
+import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.io.Streams;
 import org.elasticsearch.common.settings.MockSecureSettings;
 import org.elasticsearch.common.settings.Settings;
@@ -46,6 +52,8 @@
 import org.threeten.bp.Duration;
 
 import java.io.IOException;
+import java.io.InputStream;
+import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.Map;
@@ -152,6 +160,31 @@ public void testChunkSize() {
         assertEquals("failed to parse value [101mb] for setting [chunk_size], must be <= [100mb]", e.getMessage());
     }
 
+    public void testWriteReadLarge() throws IOException {
+        try (BlobStore store = newBlobStore()) {
+            final BlobContainer container = store.blobContainer(new BlobPath());
+            byte[] data = randomBytes(GoogleCloudStorageBlobStore.LARGE_BLOB_THRESHOLD_BYTE_SIZE + 1);
+            writeBlob(container, "foobar", new BytesArray(data), randomBoolean());
+            if (randomBoolean()) {
+                // override file, to check if we get latest contents
+                random().nextBytes(data);
+                writeBlob(container, "foobar", new BytesArray(data), false);
+            }
+            try (InputStream stream = container.readBlob("foobar")) {
+                BytesRefBuilder target = new BytesRefBuilder();
+                while (target.length() < data.length) {
+                    byte[] buffer = new byte[scaledRandomIntBetween(1, data.length - target.length())];
+                    int offset = scaledRandomIntBetween(0, buffer.length - 1);
+                    int read = stream.read(buffer, offset, buffer.length - offset);
+                    target.append(new BytesRef(buffer, offset, read));
+                }
+                assertEquals(data.length, target.length());
+                assertArrayEquals(data, Arrays.copyOfRange(target.bytes(), 0, target.length()));
+            }
+            container.delete();
+        }
+    }
+
     public static class TestGoogleCloudStoragePlugin extends GoogleCloudStoragePlugin {
 
         public TestGoogleCloudStoragePlugin(Settings settings) {
diff --git a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/MockStorage.java b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/MockStorage.java
deleted file mode 100644
index 627bb8de94300..0000000000000
--- a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/MockStorage.java
+++ /dev/null
@@ -1,574 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.repositories.gcs;
-
-import com.google.api.gax.paging.Page;
-import com.google.cloud.BatchResult;
-import com.google.cloud.Policy;
-import com.google.cloud.ReadChannel;
-import com.google.cloud.RestorableState;
-import com.google.cloud.WriteChannel;
-import com.google.cloud.storage.Acl;
-import com.google.cloud.storage.Blob;
-import com.google.cloud.storage.BlobId;
-import com.google.cloud.storage.BlobInfo;
-import com.google.cloud.storage.Bucket;
-import com.google.cloud.storage.BucketInfo;
-import com.google.cloud.storage.CopyWriter;
-import com.google.cloud.storage.ServiceAccount;
-import com.google.cloud.storage.Storage;
-import com.google.cloud.storage.StorageBatch;
-import com.google.cloud.storage.StorageBatchResult;
-import com.google.cloud.storage.StorageException;
-import com.google.cloud.storage.StorageOptions;
-import com.google.cloud.storage.StorageRpcOptionUtils;
-import com.google.cloud.storage.StorageTestUtils;
-import org.elasticsearch.common.util.concurrent.ConcurrentCollections;
-import org.elasticsearch.core.internal.io.IOUtils;
-import org.mockito.stubbing.Answer;
-
-import java.io.ByteArrayInputStream;
-import java.io.ByteArrayOutputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.net.HttpURLConnection;
-import java.net.URL;
-import java.nio.ByteBuffer;
-import java.nio.channels.Channels;
-import java.nio.channels.ReadableByteChannel;
-import java.nio.channels.WritableByteChannel;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Objects;
-import java.util.Random;
-import java.util.Set;
-import java.util.concurrent.ConcurrentMap;
-import java.util.concurrent.TimeUnit;
-import java.util.stream.Collectors;
-import java.util.stream.Stream;
-
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.anyVararg;
-import static org.mockito.Mockito.doAnswer;
-import static org.mockito.Mockito.mock;
-
-/**
- * {@link MockStorage} mocks a {@link Storage} client by storing all the blobs
- * in a given concurrent map.
- */
-class MockStorage implements Storage {
-
-    private final Random random;
-    private final String bucketName;
-    private final ConcurrentMap<String, byte[]> blobs;
-
-    MockStorage(final String bucket, final ConcurrentMap<String, byte[]> blobs, final Random random) {
-        this.random = random;
-        this.bucketName = Objects.requireNonNull(bucket);
-        this.blobs = Objects.requireNonNull(blobs);
-    }
-
-    @Override
-    public Bucket get(String bucket, BucketGetOption... options) {
-        if (bucketName.equals(bucket)) {
-            return StorageTestUtils.createBucket(this, bucketName);
-        } else {
-            return null;
-        }
-    }
-
-    @Override
-    public Bucket lockRetentionPolicy(final BucketInfo bucket, final BucketTargetOption... options) {
-        return null;
-    }
-
-    @Override
-    public Blob get(BlobId blob) {
-        if (bucketName.equals(blob.getBucket())) {
-            final byte[] bytes = blobs.get(blob.getName());
-            if (bytes != null) {
-                return StorageTestUtils.createBlob(this, bucketName, blob.getName(), bytes.length);
-            }
-        }
-        return null;
-    }
-
-    @Override
-    public boolean delete(BlobId blob) {
-        if (bucketName.equals(blob.getBucket()) && blobs.containsKey(blob.getName())) {
-            return blobs.remove(blob.getName()) != null;
-        }
-        return false;
-    }
-
-    @Override
-    public List<Boolean> delete(Iterable<BlobId> blobIds) {
-        final List<Boolean> ans = new ArrayList<>();
-        for (final BlobId blobId : blobIds) {
-            ans.add(delete(blobId));
-        }
-        return ans;
-    }
-
-    @Override
-    public Blob create(BlobInfo blobInfo, byte[] content, BlobTargetOption... options) {
-        if (bucketName.equals(blobInfo.getBucket()) == false) {
-            throw new StorageException(404, "Bucket not found");
-        }
-        if (Stream.of(options).anyMatch(option -> option.equals(BlobTargetOption.doesNotExist()))) {
-            byte[] existingBytes = blobs.putIfAbsent(blobInfo.getName(), content);
-            if (existingBytes != null) {
-                throw new StorageException(412, "Blob already exists");
-            }
-        } else {
-            blobs.put(blobInfo.getName(), content);
-        }
-        return get(BlobId.of(blobInfo.getBucket(), blobInfo.getName()));
-    }
-
-    @Override
-    public Page<Blob> list(String bucket, BlobListOption... options) {
-        if (bucketName.equals(bucket) == false) {
-            throw new StorageException(404, "Bucket not found");
-        }
-        final Storage storage = this;
-        final String prefix = StorageRpcOptionUtils.getPrefix(options);
-
-        return new Page<Blob>() {
-            @Override
-            public boolean hasNextPage() {
-                return false;
-            }
-
-            @Override
-            public String getNextPageToken() {
-                return null;
-            }
-
-            @Override
-            public Page<Blob> getNextPage() {
-                throw new UnsupportedOperationException();
-            }
-
-            @Override
-            public Iterable<Blob> iterateAll() {
-                return blobs.entrySet().stream()
-                    .filter(blob -> ((prefix == null) || blob.getKey().startsWith(prefix)))
-                    .map(blob -> StorageTestUtils.createBlob(storage, bucketName, blob.getKey(), blob.getValue().length))
-                    .collect(Collectors.toList());
-            }
-
-            @Override
-            public Iterable<Blob> getValues() {
-                throw new UnsupportedOperationException();
-            }
-        };
-    }
-
-    @Override
-    public ReadChannel reader(BlobId blob, BlobSourceOption... options) {
-        if (bucketName.equals(blob.getBucket())) {
-            final byte[] bytes = blobs.get(blob.getName());
-
-            final ReadableByteChannel readableByteChannel;
-            if (bytes != null) {
-                readableByteChannel = Channels.newChannel(new ByteArrayInputStream(bytes));
-            } else {
-                readableByteChannel = new ReadableByteChannel() {
-                    @Override
-                    public int read(ByteBuffer dst) throws IOException {
-                        throw new StorageException(404, "Object not found");
-                    }
-
-                    @Override
-                    public boolean isOpen() {
-                        return false;
-                    }
-
-                    @Override
-                    public void close() throws IOException {
-                    }
-                };
-            }
-            return new ReadChannel() {
-                @Override
-                public void close() {
-                    IOUtils.closeWhileHandlingException(readableByteChannel);
-                }
-
-                @Override
-                public void seek(long position) throws IOException {
-                    throw new UnsupportedOperationException();
-                }
-
-                @Override
-                public void setChunkSize(int chunkSize) {
-                    throw new UnsupportedOperationException();
-                }
-
-                @Override
-                public RestorableState<ReadChannel> capture() {
-                    throw new UnsupportedOperationException();
-                }
-
-                @Override
-                public int read(ByteBuffer dst) throws IOException {
-                    return readableByteChannel.read(dst);
-                }
-
-                @Override
-                public boolean isOpen() {
-                    return readableByteChannel.isOpen();
-                }
-            };
-        }
-        return null;
-    }
-
-    private final Set<BlobInfo> simulated410s = ConcurrentCollections.newConcurrentSet();
-
-    @Override
-    public WriteChannel writer(BlobInfo blobInfo, BlobWriteOption... options) {
-        if (bucketName.equals(blobInfo.getBucket())) {
-            final ByteArrayOutputStream output = new ByteArrayOutputStream();
-            return new WriteChannel() {
-
-                private volatile boolean failed;
-
-                final WritableByteChannel writableByteChannel = Channels.newChannel(output);
-
-                @Override
-                public void setChunkSize(int chunkSize) {
-                    throw new UnsupportedOperationException();
-                }
-
-                @Override
-                public RestorableState<WriteChannel> capture() {
-                    throw new UnsupportedOperationException();
-                }
-
-                @Override
-                public int write(ByteBuffer src) throws IOException {
-                    // Only fail a blob once on a 410 error since the error is so unlikely in practice
-                    if (simulated410s.add(blobInfo) && random.nextBoolean()) {
-                        failed = true;
-                        throw new StorageException(HttpURLConnection.HTTP_GONE, "Simulated lost resumeable upload session");
-                    }
-                    return writableByteChannel.write(src);
-                }
-
-                @Override
-                public boolean isOpen() {
-                    return writableByteChannel.isOpen();
-                }
-
-                @Override
-                public void close() {
-                    IOUtils.closeWhileHandlingException(writableByteChannel);
-                    if (failed == false) {
-                        if (Stream.of(options).anyMatch(option -> option.equals(BlobWriteOption.doesNotExist()))) {
-                            byte[] existingBytes = blobs.putIfAbsent(blobInfo.getName(), output.toByteArray());
-                            if (existingBytes != null) {
-                                throw new StorageException(412, "Blob already exists");
-                            }
-                        } else {
-                            blobs.put(blobInfo.getName(), output.toByteArray());
-                        }
-                    }
-                }
-            };
-        }
-        return null;
-    }
-
-    @Override
-    public WriteChannel writer(URL signedURL) {
-        return null;
-    }
-
-    // Everything below this line is not implemented.
-
-    @Override
-    public CopyWriter copy(CopyRequest copyRequest) {
-        return null;
-    }
-
-    @Override
-    public Blob create(BlobInfo blobInfo, byte[] content, int offset, int length, BlobTargetOption... options) {
-        return null;
-    }
-
-    @Override
-    public Bucket create(BucketInfo bucketInfo, BucketTargetOption... options) {
-        return null;
-    }
-
-    @Override
-    public Blob create(BlobInfo blobInfo, BlobTargetOption... options) {
-        return null;
-    }
-
-    @Override
-    public Blob create(BlobInfo blobInfo, InputStream content, BlobWriteOption... options) {
-        return null;
-    }
-
-    @Override
-    public Blob get(String bucket, String blob, BlobGetOption... options) {
-        return null;
-    }
-
-    @Override
-    public Blob get(BlobId blob, BlobGetOption... options) {
-        return null;
-    }
-
-    @Override
-    public Page<Bucket> list(BucketListOption... options) {
-        return null;
-    }
-
-    @Override
-    public Bucket update(BucketInfo bucketInfo, BucketTargetOption... options) {
-        return null;
-    }
-
-    @Override
-    public Blob update(BlobInfo blobInfo, BlobTargetOption... options) {
-        return null;
-    }
-
-    @Override
-    public Blob update(BlobInfo blobInfo) {
-        return null;
-    }
-
-    @Override
-    public boolean delete(String bucket, BucketSourceOption... options) {
-        return false;
-    }
-
-    @Override
-    public boolean delete(String bucket, String blob, BlobSourceOption... options) {
-        return false;
-    }
-
-    @Override
-    public boolean delete(BlobId blob, BlobSourceOption... options) {
-        return false;
-    }
-
-    @Override
-    public Blob compose(ComposeRequest composeRequest) {
-        return null;
-    }
-
-    @Override
-    public byte[] readAllBytes(String bucket, String blob, BlobSourceOption... options) {
-        return new byte[0];
-    }
-
-    @Override
-    public byte[] readAllBytes(BlobId blob, BlobSourceOption... options) {
-        return new byte[0];
-    }
-
-    @Override
-    @SuppressWarnings("unchecked")
-    public StorageBatch batch() {
-        final Answer<?> throwOnMissingMock = invocationOnMock -> {
-            throw new AssertionError("Did not expect call to method [" + invocationOnMock.getMethod().getName() + ']');
-        };
-        final StorageBatch batch = mock(StorageBatch.class, throwOnMissingMock);
-        StorageBatchResult<Boolean> result = mock(StorageBatchResult.class, throwOnMissingMock);
-        doAnswer(answer -> {
-            BatchResult.Callback<Boolean, Exception> callback = (BatchResult.Callback<Boolean, Exception>) answer.getArguments()[0];
-            callback.success(true);
-            return null;
-        }).when(result).notify(any(BatchResult.Callback.class));
-        doAnswer(invocation -> {
-            final BlobId blobId = (BlobId) invocation.getArguments()[0];
-            delete(blobId);
-            return result;
-        }).when(batch).delete(any(BlobId.class), anyVararg());
-        doAnswer(invocation -> null).when(batch).submit();
-        return batch;
-    }
-
-    @Override
-    public ReadChannel reader(String bucket, String blob, BlobSourceOption... options) {
-        return null;
-    }
-
-    @Override
-    public URL signUrl(BlobInfo blobInfo, long duration, TimeUnit unit, SignUrlOption... options) {
-        return null;
-    }
-
-    @Override
-    public List<Blob> get(BlobId... blobIds) {
-        return null;
-    }
-
-    @Override
-    public List<Blob> get(Iterable<BlobId> blobIds) {
-        return null;
-    }
-
-    @Override
-    public List<Blob> update(BlobInfo... blobInfos) {
-        return null;
-    }
-
-    @Override
-    public List<Blob> update(Iterable<BlobInfo> blobInfos) {
-        return null;
-    }
-
-    @Override
-    public List<Boolean> delete(BlobId... blobIds) {
-        return null;
-    }
-
-    @Override
-    public Acl getAcl(String bucket, Acl.Entity entity, BucketSourceOption... options) {
-        return null;
-    }
-
-    @Override
-    public Acl getAcl(String bucket, Acl.Entity entity) {
-        return null;
-    }
-
-    @Override
-    public boolean deleteAcl(String bucket, Acl.Entity entity, BucketSourceOption... options) {
-        return false;
-    }
-
-    @Override
-    public boolean deleteAcl(String bucket, Acl.Entity entity) {
-        return false;
-    }
-
-    @Override
-    public Acl createAcl(String bucket, Acl acl, BucketSourceOption... options) {
-        return null;
-    }
-
-    @Override
-    public Acl createAcl(String bucket, Acl acl) {
-        return null;
-    }
-
-    @Override
-    public Acl updateAcl(String bucket, Acl acl, BucketSourceOption... options) {
-        return null;
-    }
-
-    @Override
-    public Acl updateAcl(String bucket, Acl acl) {
-        return null;
-    }
-
-    @Override
-    public List<Acl> listAcls(String bucket, BucketSourceOption... options) {
-        return null;
-    }
-
-    @Override
-    public List<Acl> listAcls(String bucket) {
-        return null;
-    }
-
-    @Override
-    public Acl getDefaultAcl(String bucket, Acl.Entity entity) {
-        return null;
-    }
-
-    @Override
-    public boolean deleteDefaultAcl(String bucket, Acl.Entity entity) {
-        return false;
-    }
-
-    @Override
-    public Acl createDefaultAcl(String bucket, Acl acl) {
-        return null;
-    }
-
-    @Override
-    public Acl updateDefaultAcl(String bucket, Acl acl) {
-        return null;
-    }
-
-    @Override
-    public List<Acl> listDefaultAcls(String bucket) {
-        return null;
-    }
-
-    @Override
-    public Acl getAcl(BlobId blob, Acl.Entity entity) {
-        return null;
-    }
-
-    @Override
-    public boolean deleteAcl(BlobId blob, Acl.Entity entity) {
-        return false;
-    }
-
-    @Override
-    public Acl createAcl(BlobId blob, Acl acl) {
-        return null;
-    }
-
-    @Override
-    public Acl updateAcl(BlobId blob, Acl acl) {
-        return null;
-    }
-
-    @Override
-    public List<Acl> listAcls(BlobId blob) {
-        return null;
-    }
-
-    @Override
-    public Policy getIamPolicy(String bucket, BucketSourceOption... options) {
-        return null;
-    }
-
-    @Override
-    public Policy setIamPolicy(String bucket, Policy policy, BucketSourceOption... options) {
-        return null;
-    }
-
-    @Override
-    public List<Boolean> testIamPermissions(String bucket, List<String> permissions, BucketSourceOption... options) {
-        return null;
-    }
-
-    @Override
-    public ServiceAccount getServiceAccount(String projectId) {
-        return null;
-    }
-
-    @Override
-    public StorageOptions getOptions() {
-        return null;
-    }
-}
diff --git a/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsBlobStoreContainerTests.java b/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsBlobStoreContainerTests.java
index 83e5c581e065c..b2c71c0031a62 100644
--- a/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsBlobStoreContainerTests.java
+++ b/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsBlobStoreContainerTests.java
@@ -28,13 +28,12 @@
 import org.elasticsearch.common.SuppressForbidden;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobPath;
-import org.elasticsearch.common.blobstore.BlobStore;
 import org.elasticsearch.common.bytes.BytesArray;
-import org.elasticsearch.repositories.ESBlobStoreContainerTestCase;
 import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
+import org.elasticsearch.test.ESTestCase;
 
 import javax.security.auth.Subject;
-import java.io.IOException;
+
 import java.lang.reflect.Constructor;
 import java.lang.reflect.InvocationTargetException;
 import java.net.URI;
@@ -45,13 +44,12 @@
 import java.security.PrivilegedExceptionAction;
 import java.util.Collections;
 
-@ThreadLeakFilters(filters = {HdfsClientThreadLeakFilter.class})
-public class HdfsBlobStoreContainerTests extends ESBlobStoreContainerTestCase {
+import static org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase.randomBytes;
+import static org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase.readBlobFully;
+import static org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase.writeBlob;
 
-    @Override
-    protected BlobStore newBlobStore() throws IOException {
-        return new HdfsBlobStore(createTestContext(), "temp", 1024, false);
-    }
+@ThreadLeakFilters(filters = {HdfsClientThreadLeakFilter.class})
+public class HdfsBlobStoreContainerTests extends ESTestCase {
 
     private FileContext createTestContext() {
         FileContext fileContext;
diff --git a/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsBlobStoreRepositoryTests.java b/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsBlobStoreRepositoryTests.java
new file mode 100644
index 0000000000000..4b4a315da8813
--- /dev/null
+++ b/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsBlobStoreRepositoryTests.java
@@ -0,0 +1,55 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.repositories.hdfs;
+
+import com.carrotsearch.randomizedtesting.annotations.ThreadLeakFilters;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase;
+import org.elasticsearch.test.ESIntegTestCase;
+
+import java.util.Collection;
+import java.util.Collections;
+
+@ThreadLeakFilters(filters = HdfsClientThreadLeakFilter.class)
+// Ony using a single node here since the TestingFs only supports the single-node case
+@ESIntegTestCase.ClusterScope(numDataNodes = 1, supportsDedicatedMasters = false)
+public class HdfsBlobStoreRepositoryTests extends ESBlobStoreRepositoryIntegTestCase {
+
+    @Override
+    protected String repositoryType() {
+        return "hdfs";
+    }
+
+    @Override
+    protected Settings repositorySettings() {
+        assumeFalse("https://github.com/elastic/elasticsearch/issues/31498", HdfsRepositoryTests.isJava11());
+        return Settings.builder()
+            .put("uri", "hdfs:///")
+            .put("conf.fs.AbstractFileSystem.hdfs.impl", TestingFs.class.getName())
+            .put("path", "foo")
+            .put("chunk_size", randomIntBetween(100, 1000) + "k")
+            .put("compress", randomBoolean()).build();
+    }
+
+    @Override
+    protected Collection<Class<? extends Plugin>> nodePlugins() {
+        return Collections.singletonList(HdfsPlugin.class);
+    }
+}
diff --git a/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsRepositoryTests.java b/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsRepositoryTests.java
index 63496c00db843..05c339293ac7c 100644
--- a/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsRepositoryTests.java
+++ b/plugins/repository-hdfs/src/test/java/org/elasticsearch/repositories/hdfs/HdfsRepositoryTests.java
@@ -78,7 +78,7 @@ protected void assertCleanupResponse(CleanupRepositoryResponse response, long by
         }
     }
 
-    private static boolean isJava11() {
+    public static boolean isJava11() {
         return JavaVersion.current().equals(JavaVersion.parse("11"));
     }
 }
diff --git a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/MockAmazonS3.java b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/MockAmazonS3.java
deleted file mode 100644
index 37f5d9b03dbc2..0000000000000
--- a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/MockAmazonS3.java
+++ /dev/null
@@ -1,169 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.repositories.s3;
-
-import com.amazonaws.AmazonClientException;
-import com.amazonaws.SdkClientException;
-import com.amazonaws.services.s3.AbstractAmazonS3;
-import com.amazonaws.services.s3.model.AmazonS3Exception;
-import com.amazonaws.services.s3.model.DeleteObjectRequest;
-import com.amazonaws.services.s3.model.DeleteObjectsRequest;
-import com.amazonaws.services.s3.model.DeleteObjectsResult;
-import com.amazonaws.services.s3.model.GetObjectRequest;
-import com.amazonaws.services.s3.model.ListObjectsRequest;
-import com.amazonaws.services.s3.model.ObjectListing;
-import com.amazonaws.services.s3.model.ObjectMetadata;
-import com.amazonaws.services.s3.model.PutObjectRequest;
-import com.amazonaws.services.s3.model.PutObjectResult;
-import com.amazonaws.services.s3.model.S3Object;
-import com.amazonaws.services.s3.model.S3ObjectInputStream;
-import com.amazonaws.services.s3.model.S3ObjectSummary;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.io.Streams;
-
-import java.io.ByteArrayInputStream;
-import java.io.ByteArrayOutputStream;
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Map;
-import java.util.Objects;
-import java.util.concurrent.ConcurrentMap;
-
-import static org.hamcrest.MatcherAssert.assertThat;
-import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.notNullValue;
-import static org.hamcrest.Matchers.nullValue;
-
-class MockAmazonS3 extends AbstractAmazonS3 {
-
-    private final ConcurrentMap<String, byte[]> blobs;
-    private final String bucket;
-    private final boolean serverSideEncryption;
-    private final String cannedACL;
-    private final String storageClass;
-
-    MockAmazonS3(final ConcurrentMap<String, byte[]> blobs,
-                 final String bucket,
-                 final boolean serverSideEncryption,
-                 final String cannedACL,
-                 final String storageClass) {
-        this.blobs = Objects.requireNonNull(blobs);
-        this.bucket = Objects.requireNonNull(bucket);
-        this.serverSideEncryption = serverSideEncryption;
-        this.cannedACL = cannedACL;
-        this.storageClass = storageClass;
-    }
-
-    @Override
-    public boolean doesObjectExist(final String bucketName, final String objectName) throws SdkClientException {
-        assertThat(bucketName, equalTo(bucket));
-        return blobs.containsKey(objectName);
-    }
-
-    @Override
-    public PutObjectResult putObject(final PutObjectRequest request) throws AmazonClientException {
-        assertThat(request.getBucketName(), equalTo(bucket));
-        assertThat(request.getMetadata().getSSEAlgorithm(), serverSideEncryption ? equalTo("AES256") : nullValue());
-        assertThat(request.getCannedAcl(), notNullValue());
-        assertThat(request.getCannedAcl().toString(), cannedACL != null ? equalTo(cannedACL) : equalTo("private"));
-        assertThat(request.getStorageClass(), storageClass != null ? equalTo(storageClass) : equalTo("STANDARD"));
-
-
-        final String blobName = request.getKey();
-        final ByteArrayOutputStream out = new ByteArrayOutputStream();
-        try {
-            Streams.copy(request.getInputStream(), out);
-            blobs.put(blobName, out.toByteArray());
-        } catch (IOException e) {
-            throw new AmazonClientException(e);
-        }
-        return new PutObjectResult();
-    }
-
-    @Override
-    public S3Object getObject(final GetObjectRequest request) throws AmazonClientException {
-        assertThat(request.getBucketName(), equalTo(bucket));
-
-        final String blobName = request.getKey();
-        final byte[] content = blobs.get(blobName);
-        if (content == null) {
-            AmazonS3Exception exception = new AmazonS3Exception("[" + blobName + "] does not exist.");
-            exception.setStatusCode(404);
-            throw exception;
-        }
-
-        ObjectMetadata metadata = new ObjectMetadata();
-        metadata.setContentLength(content.length);
-
-        S3Object s3Object = new S3Object();
-        s3Object.setObjectContent(new S3ObjectInputStream(new ByteArrayInputStream(content), null, false));
-        s3Object.setKey(blobName);
-        s3Object.setObjectMetadata(metadata);
-
-        return s3Object;
-    }
-
-    @Override
-    public ObjectListing listObjects(final ListObjectsRequest request) throws AmazonClientException {
-        assertThat(request.getBucketName(), equalTo(bucket));
-
-        final ObjectListing listing = new ObjectListing();
-        listing.setBucketName(request.getBucketName());
-        listing.setPrefix(request.getPrefix());
-
-        for (Map.Entry<String, byte[]> blob : blobs.entrySet()) {
-            if (Strings.isEmpty(request.getPrefix()) || blob.getKey().startsWith(request.getPrefix())) {
-                S3ObjectSummary summary = new S3ObjectSummary();
-                summary.setBucketName(request.getBucketName());
-                summary.setKey(blob.getKey());
-                summary.setSize(blob.getValue().length);
-                listing.getObjectSummaries().add(summary);
-            }
-        }
-        return listing;
-    }
-
-    @Override
-    public void deleteObject(final DeleteObjectRequest request) throws AmazonClientException {
-        assertThat(request.getBucketName(), equalTo(bucket));
-        blobs.remove(request.getKey());
-    }
-
-    @Override
-    public void shutdown() {
-        // TODO check close
-    }
-
-    @Override
-    public DeleteObjectsResult deleteObjects(DeleteObjectsRequest request) throws SdkClientException {
-        assertThat(request.getBucketName(), equalTo(bucket));
-
-        final List<DeleteObjectsResult.DeletedObject> deletions = new ArrayList<>();
-        for (DeleteObjectsRequest.KeyVersion key : request.getKeys()) {
-            if (blobs.remove(key.getKey()) != null) {
-                DeleteObjectsResult.DeletedObject deletion = new DeleteObjectsResult.DeletedObject();
-                deletion.setKey(key.getKey());
-                deletions.add(deletion);
-            }
-        }
-        return new DeleteObjectsResult(deletions);
-    }
-}
diff --git a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreContainerTests.java b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreContainerTests.java
index 95f51091555c2..25185c0570724 100644
--- a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreContainerTests.java
+++ b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreContainerTests.java
@@ -34,15 +34,11 @@
 import com.amazonaws.services.s3.model.StorageClass;
 import com.amazonaws.services.s3.model.UploadPartRequest;
 import com.amazonaws.services.s3.model.UploadPartResult;
-import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.common.blobstore.BlobPath;
-import org.elasticsearch.common.blobstore.BlobStore;
 import org.elasticsearch.common.blobstore.BlobStoreException;
 import org.elasticsearch.common.collect.Tuple;
-import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
-import org.elasticsearch.common.unit.ByteSizeValue;
-import org.elasticsearch.repositories.ESBlobStoreContainerTestCase;
+import org.elasticsearch.test.ESTestCase;
 import org.mockito.ArgumentCaptor;
 
 import java.io.ByteArrayInputStream;
@@ -50,8 +46,6 @@
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
-import java.util.Locale;
-import java.util.concurrent.ConcurrentHashMap;
 import java.util.stream.Collectors;
 import java.util.stream.IntStream;
 
@@ -65,16 +59,7 @@
 import static org.mockito.Mockito.when;
 import static org.mockito.Mockito.doAnswer;
 
-public class S3BlobStoreContainerTests extends ESBlobStoreContainerTestCase {
-
-    protected BlobStore newBlobStore() {
-        return randomMockS3BlobStore();
-    }
-
-    @Override
-    public void testVerifyOverwriteFails() {
-        assumeFalse("not implemented because of S3's weak consistency model", true);
-    }
+public class S3BlobStoreContainerTests extends ESTestCase {
 
     public void testExecuteSingleUploadBlobSizeTooLarge() {
         final long blobSize = ByteSizeUnit.GB.toBytes(randomIntBetween(6, 10));
@@ -462,35 +447,4 @@ private static void assertNumberOfMultiparts(final int expectedParts, final long
         assertEquals("Expected number of parts [" + expectedParts + "] but got [" + result.v1() + "]", expectedParts, (long) result.v1());
         assertEquals("Expected remaining [" + expectedRemaining + "] but got [" + result.v2() + "]", expectedRemaining, (long) result.v2());
     }
-
-    /**
-     * Creates a new {@link S3BlobStore} with random settings.
-     * <p>
-     * The blobstore uses a {@link MockAmazonS3} client.
-     */
-    public static S3BlobStore randomMockS3BlobStore() {
-        String bucket = randomAlphaOfLength(randomIntBetween(1, 10)).toLowerCase(Locale.ROOT);
-        ByteSizeValue bufferSize = new ByteSizeValue(randomIntBetween(5, 100), ByteSizeUnit.MB);
-        boolean serverSideEncryption = randomBoolean();
-
-        String cannedACL = null;
-        if (randomBoolean()) {
-            cannedACL = randomFrom(CannedAccessControlList.values()).toString();
-        }
-
-        String storageClass = null;
-        if (randomBoolean()) {
-            storageClass = randomValueOtherThan(StorageClass.Glacier, () -> randomFrom(StorageClass.values())).toString();
-        }
-
-        final AmazonS3 client = new MockAmazonS3(new ConcurrentHashMap<>(), bucket, serverSideEncryption, cannedACL, storageClass);
-        final S3Service service = new S3Service() {
-            @Override
-            public synchronized AmazonS3Reference client(RepositoryMetaData repositoryMetaData) {
-                return new AmazonS3Reference(client);
-            }
-        };
-        return new S3BlobStore(service, bucket, serverSideEncryption, bufferSize, cannedACL, storageClass,
-            new RepositoryMetaData(bucket, "s3", Settings.EMPTY));
-    }
 }
diff --git a/server/src/test/java/org/elasticsearch/common/blobstore/fs/FsBlobStoreContainerTests.java b/server/src/test/java/org/elasticsearch/common/blobstore/fs/FsBlobStoreContainerTests.java
deleted file mode 100644
index 84e7f58cf4935..0000000000000
--- a/server/src/test/java/org/elasticsearch/common/blobstore/fs/FsBlobStoreContainerTests.java
+++ /dev/null
@@ -1,81 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.common.blobstore.fs;
-
-import org.apache.lucene.util.LuceneTestCase;
-import org.elasticsearch.common.blobstore.BlobContainer;
-import org.elasticsearch.common.blobstore.BlobPath;
-import org.elasticsearch.common.blobstore.BlobStore;
-import org.elasticsearch.common.bytes.BytesArray;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.unit.ByteSizeUnit;
-import org.elasticsearch.common.unit.ByteSizeValue;
-import org.elasticsearch.repositories.ESBlobStoreContainerTestCase;
-import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
-
-import java.io.IOException;
-import java.nio.file.Files;
-import java.nio.file.Path;
-
-@LuceneTestCase.SuppressFileSystems("ExtrasFS")
-public class FsBlobStoreContainerTests extends ESBlobStoreContainerTestCase {
-
-    protected BlobStore newBlobStore() throws IOException {
-        final Settings settings;
-        if (randomBoolean()) {
-            settings = Settings.builder().put("buffer_size", new ByteSizeValue(randomIntBetween(1, 100), ByteSizeUnit.KB)).build();
-        } else {
-            settings = Settings.EMPTY;
-        }
-        return new FsBlobStore(settings, createTempDir(), false);
-    }
-
-    public void testReadOnly() throws Exception {
-        Path tempDir = createTempDir();
-        Path path = tempDir.resolve("bar");
-
-        try (FsBlobStore store = new FsBlobStore(Settings.EMPTY, path, true)) {
-            assertFalse(Files.exists(path));
-            BlobPath blobPath = BlobPath.cleanPath().add("foo");
-            store.blobContainer(blobPath);
-            Path storePath = store.path();
-            for (String d : blobPath) {
-                storePath = storePath.resolve(d);
-            }
-            assertFalse(Files.exists(storePath));
-        }
-
-        try (FsBlobStore store = new FsBlobStore(Settings.EMPTY, path, false)) {
-            assertTrue(Files.exists(path));
-            BlobPath blobPath = BlobPath.cleanPath().add("foo");
-            BlobContainer container = store.blobContainer(blobPath);
-            Path storePath = store.path();
-            for (String d : blobPath) {
-                storePath = storePath.resolve(d);
-            }
-            assertTrue(Files.exists(storePath));
-            assertTrue(Files.isDirectory(storePath));
-
-            byte[] data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
-            writeBlob(container, "test", new BytesArray(data));
-            assertArrayEquals(readBlobFully(container, "test", data.length), data);
-            assertTrue(BlobStoreTestUtil.blobExists(container, "test"));
-        }
-    }
-}
diff --git a/server/src/test/java/org/elasticsearch/repositories/fs/FsBlobStoreRepositoryIT.java b/server/src/test/java/org/elasticsearch/repositories/fs/FsBlobStoreRepositoryIT.java
index b79d250eceefd..55eb35500a6cc 100644
--- a/server/src/test/java/org/elasticsearch/repositories/fs/FsBlobStoreRepositoryIT.java
+++ b/server/src/test/java/org/elasticsearch/repositories/fs/FsBlobStoreRepositoryIT.java
@@ -19,17 +19,21 @@
 package org.elasticsearch.repositories.fs;
 
 import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.common.blobstore.BlobContainer;
+import org.elasticsearch.common.blobstore.BlobPath;
+import org.elasticsearch.common.blobstore.fs.FsBlobStore;
+import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
 import org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase;
 
 import java.io.IOException;
 import java.nio.file.Files;
 import java.nio.file.NoSuchFileException;
 import java.nio.file.Path;
-import java.util.concurrent.ExecutionException;
 import java.util.stream.Stream;
 
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
@@ -55,7 +59,7 @@ protected Settings repositorySettings() {
         return settings.build();
     }
 
-    public void testMissingDirectoriesNotCreatedInReadonlyRepository() throws IOException, ExecutionException, InterruptedException {
+    public void testMissingDirectoriesNotCreatedInReadonlyRepository() throws IOException, InterruptedException {
         final String repoName = randomName();
         final Path repoPath = randomRepoPath();
 
@@ -97,4 +101,37 @@ public void testMissingDirectoriesNotCreatedInReadonlyRepository() throws IOExce
 
         assertFalse("deleted path is not recreated in readonly repository", Files.exists(deletedPath));
     }
+
+    public void testReadOnly() throws Exception {
+        Path tempDir = createTempDir();
+        Path path = tempDir.resolve("bar");
+
+        try (FsBlobStore store = new FsBlobStore(Settings.EMPTY, path, true)) {
+            assertFalse(Files.exists(path));
+            BlobPath blobPath = BlobPath.cleanPath().add("foo");
+            store.blobContainer(blobPath);
+            Path storePath = store.path();
+            for (String d : blobPath) {
+                storePath = storePath.resolve(d);
+            }
+            assertFalse(Files.exists(storePath));
+        }
+
+        try (FsBlobStore store = new FsBlobStore(Settings.EMPTY, path, false)) {
+            assertTrue(Files.exists(path));
+            BlobPath blobPath = BlobPath.cleanPath().add("foo");
+            BlobContainer container = store.blobContainer(blobPath);
+            Path storePath = store.path();
+            for (String d : blobPath) {
+                storePath = storePath.resolve(d);
+            }
+            assertTrue(Files.exists(storePath));
+            assertTrue(Files.isDirectory(storePath));
+
+            byte[] data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
+            writeBlob(container, "test", new BytesArray(data));
+            assertArrayEquals(readBlobFully(container, "test", data.length), data);
+            assertTrue(BlobStoreTestUtil.blobExists(container, "test"));
+        }
+    }
 }
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/ESBlobStoreContainerTestCase.java b/test/framework/src/main/java/org/elasticsearch/repositories/ESBlobStoreContainerTestCase.java
deleted file mode 100644
index 3aa65cf392c3d..0000000000000
--- a/test/framework/src/main/java/org/elasticsearch/repositories/ESBlobStoreContainerTestCase.java
+++ /dev/null
@@ -1,213 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.repositories;
-
-import org.apache.lucene.util.BytesRef;
-import org.apache.lucene.util.BytesRefBuilder;
-import org.elasticsearch.common.blobstore.BlobContainer;
-import org.elasticsearch.common.blobstore.BlobMetaData;
-import org.elasticsearch.common.blobstore.BlobPath;
-import org.elasticsearch.common.blobstore.BlobStore;
-import org.elasticsearch.common.bytes.BytesArray;
-import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
-import org.elasticsearch.test.ESTestCase;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.nio.file.FileAlreadyExistsException;
-import java.nio.file.NoSuchFileException;
-import java.util.Arrays;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-import static org.hamcrest.CoreMatchers.equalTo;
-import static org.hamcrest.CoreMatchers.notNullValue;
-
-/**
- * Generic test case for blob store container implementation.
- * These tests check basic blob store functionality.
- */
-public abstract class ESBlobStoreContainerTestCase extends ESTestCase {
-
-    public void testReadNonExistingPath() throws IOException {
-        try(BlobStore store = newBlobStore()) {
-            final BlobContainer container = store.blobContainer(new BlobPath());
-            expectThrows(NoSuchFileException.class, () -> {
-                try (InputStream is = container.readBlob("non-existing")) {
-                    is.read();
-                }
-            });
-        }
-    }
-
-    public void testWriteRead() throws IOException {
-        try(BlobStore store = newBlobStore()) {
-            final BlobContainer container = store.blobContainer(new BlobPath());
-            byte[] data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
-            writeBlob(container, "foobar", new BytesArray(data), randomBoolean());
-            if (randomBoolean()) {
-                // override file, to check if we get latest contents
-                data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
-                writeBlob(container, "foobar", new BytesArray(data), false);
-            }
-            try (InputStream stream = container.readBlob("foobar")) {
-                BytesRefBuilder target = new BytesRefBuilder();
-                while (target.length() < data.length) {
-                    byte[] buffer = new byte[scaledRandomIntBetween(1, data.length - target.length())];
-                    int offset = scaledRandomIntBetween(0, buffer.length - 1);
-                    int read = stream.read(buffer, offset, buffer.length - offset);
-                    target.append(new BytesRef(buffer, offset, read));
-                }
-                assertEquals(data.length, target.length());
-                assertArrayEquals(data, Arrays.copyOfRange(target.bytes(), 0, target.length()));
-            }
-        }
-    }
-
-    public void testList() throws IOException {
-        try(BlobStore store = newBlobStore()) {
-            final BlobContainer container = store.blobContainer(new BlobPath());
-            assertThat(container.listBlobs().size(), equalTo(0));
-            int numberOfFooBlobs = randomIntBetween(0, 10);
-            int numberOfBarBlobs = randomIntBetween(3, 20);
-            Map<String, Long> generatedBlobs = new HashMap<>();
-            for (int i = 0; i < numberOfFooBlobs; i++) {
-                int length = randomIntBetween(10, 100);
-                String name = "foo-" + i + "-";
-                generatedBlobs.put(name, (long) length);
-                writeRandomBlob(container, name, length);
-            }
-            for (int i = 1; i < numberOfBarBlobs; i++) {
-                int length = randomIntBetween(10, 100);
-                String name = "bar-" + i + "-";
-                generatedBlobs.put(name, (long) length);
-                writeRandomBlob(container, name, length);
-            }
-            int length = randomIntBetween(10, 100);
-            String name = "bar-0-";
-            generatedBlobs.put(name, (long) length);
-            writeRandomBlob(container, name, length);
-
-            Map<String, BlobMetaData> blobs = container.listBlobs();
-            assertThat(blobs.size(), equalTo(numberOfFooBlobs + numberOfBarBlobs));
-            for (Map.Entry<String, Long> generated : generatedBlobs.entrySet()) {
-                BlobMetaData blobMetaData = blobs.get(generated.getKey());
-                assertThat(generated.getKey(), blobMetaData, notNullValue());
-                assertThat(blobMetaData.name(), equalTo(generated.getKey()));
-                assertThat(blobMetaData.length(), equalTo(generated.getValue()));
-            }
-
-            assertThat(container.listBlobsByPrefix("foo-").size(), equalTo(numberOfFooBlobs));
-            assertThat(container.listBlobsByPrefix("bar-").size(), equalTo(numberOfBarBlobs));
-            assertThat(container.listBlobsByPrefix("baz-").size(), equalTo(0));
-        }
-    }
-
-    public void testDeleteBlobs() throws IOException {
-        try (BlobStore store = newBlobStore()) {
-            final List<String> blobNames = Arrays.asList("foobar", "barfoo");
-            final BlobContainer container = store.blobContainer(new BlobPath());
-            container.deleteBlobsIgnoringIfNotExists(blobNames); // does not raise when blobs don't exist
-            byte[] data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
-            final BytesArray bytesArray = new BytesArray(data);
-            for (String blobName : blobNames) {
-                writeBlob(container, blobName, bytesArray, randomBoolean());
-            }
-            assertEquals(container.listBlobs().size(), 2);
-            container.deleteBlobsIgnoringIfNotExists(blobNames);
-            assertTrue(container.listBlobs().isEmpty());
-            container.deleteBlobsIgnoringIfNotExists(blobNames); // does not raise when blobs don't exist
-        }
-    }
-
-    public void testVerifyOverwriteFails() throws IOException {
-        try (BlobStore store = newBlobStore()) {
-            final String blobName = "foobar";
-            final BlobContainer container = store.blobContainer(new BlobPath());
-            byte[] data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
-            final BytesArray bytesArray = new BytesArray(data);
-            writeBlob(container, blobName, bytesArray, true);
-            // should not be able to overwrite existing blob
-            expectThrows(FileAlreadyExistsException.class, () -> writeBlob(container, blobName, bytesArray, true));
-            container.deleteBlobsIgnoringIfNotExists(Collections.singletonList(blobName));
-            writeBlob(container, blobName, bytesArray, true); // after deleting the previous blob, we should be able to write to it again
-        }
-    }
-
-    protected void writeBlob(final BlobContainer container, final String blobName, final BytesArray bytesArray,
-                             boolean failIfAlreadyExists) throws IOException {
-        try (InputStream stream = bytesArray.streamInput()) {
-            if (randomBoolean()) {
-                container.writeBlob(blobName, stream, bytesArray.length(), failIfAlreadyExists);
-            } else {
-                container.writeBlobAtomic(blobName, stream, bytesArray.length(), failIfAlreadyExists);
-            }
-        }
-    }
-
-    public void testContainerCreationAndDeletion() throws IOException {
-        try(BlobStore store = newBlobStore()) {
-            final BlobContainer containerFoo = store.blobContainer(new BlobPath().add("foo"));
-            final BlobContainer containerBar = store.blobContainer(new BlobPath().add("bar"));
-            byte[] data1 = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
-            byte[] data2 = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
-            writeBlob(containerFoo, "test", new BytesArray(data1));
-            writeBlob(containerBar, "test", new BytesArray(data2));
-
-            assertArrayEquals(readBlobFully(containerFoo, "test", data1.length), data1);
-            assertArrayEquals(readBlobFully(containerBar, "test", data2.length), data2);
-
-            assertTrue(BlobStoreTestUtil.blobExists(containerFoo, "test"));
-            assertTrue(BlobStoreTestUtil.blobExists(containerBar, "test"));
-        }
-    }
-
-    public static byte[] writeRandomBlob(BlobContainer container, String name, int length) throws IOException {
-        byte[] data = randomBytes(length);
-        writeBlob(container, name, new BytesArray(data));
-        return data;
-    }
-
-    public static byte[] readBlobFully(BlobContainer container, String name, int length) throws IOException {
-        byte[] data = new byte[length];
-        try (InputStream inputStream = container.readBlob(name)) {
-            assertThat(inputStream.read(data), equalTo(length));
-            assertThat(inputStream.read(), equalTo(-1));
-        }
-        return data;
-    }
-
-    public static byte[] randomBytes(int length) {
-        byte[] data = new byte[length];
-        for (int i = 0; i < data.length; i++) {
-            data[i] = (byte) randomInt();
-        }
-        return data;
-    }
-
-    protected static void writeBlob(BlobContainer container, String blobName, BytesArray bytesArray) throws IOException {
-        try (InputStream stream = bytesArray.streamInput()) {
-            container.writeBlob(blobName, stream, bytesArray.length(), true);
-        }
-    }
-
-    protected abstract BlobStore newBlobStore() throws IOException;
-}
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
index ccf3853ebe64b..f2e96603fcc98 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
@@ -18,7 +18,10 @@
  */
 package org.elasticsearch.repositories.blobstore;
 
+import org.apache.lucene.util.BytesRef;
+import org.apache.lucene.util.BytesRefBuilder;
 import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotRequestBuilder;
 import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotResponse;
 import org.elasticsearch.action.admin.cluster.snapshots.restore.RestoreSnapshotRequestBuilder;
@@ -27,7 +30,10 @@
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.blobstore.BlobContainer;
+import org.elasticsearch.common.blobstore.BlobMetaData;
+import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.blobstore.BlobStore;
+import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.repositories.IndexId;
 import org.elasticsearch.repositories.RepositoriesService;
@@ -37,11 +43,17 @@
 import org.elasticsearch.snapshots.SnapshotRestoreException;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.hamcrest.CoreMatchers;
 
+import java.io.IOException;
+import java.io.InputStream;
+import java.nio.file.NoSuchFileException;
 import java.util.Arrays;
+import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Locale;
+import java.util.Map;
 import java.util.Set;
 
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
@@ -92,6 +104,166 @@ protected final String createRepository(final String name, final Settings settin
         return name;
     }
 
+    public void testReadNonExistingPath() throws IOException {
+        try (BlobStore store = newBlobStore()) {
+            final BlobContainer container = store.blobContainer(new BlobPath());
+            expectThrows(NoSuchFileException.class, () -> {
+                try (InputStream is = container.readBlob("non-existing")) {
+                    is.read();
+                }
+            });
+        }
+    }
+
+    public void testWriteRead() throws IOException {
+        try (BlobStore store = newBlobStore()) {
+            final BlobContainer container = store.blobContainer(new BlobPath());
+            byte[] data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
+            writeBlob(container, "foobar", new BytesArray(data), randomBoolean());
+            if (randomBoolean()) {
+                // override file, to check if we get latest contents
+                data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
+                writeBlob(container, "foobar", new BytesArray(data), false);
+            }
+            try (InputStream stream = container.readBlob("foobar")) {
+                BytesRefBuilder target = new BytesRefBuilder();
+                while (target.length() < data.length) {
+                    byte[] buffer = new byte[scaledRandomIntBetween(1, data.length - target.length())];
+                    int offset = scaledRandomIntBetween(0, buffer.length - 1);
+                    int read = stream.read(buffer, offset, buffer.length - offset);
+                    target.append(new BytesRef(buffer, offset, read));
+                }
+                assertEquals(data.length, target.length());
+                assertArrayEquals(data, Arrays.copyOfRange(target.bytes(), 0, target.length()));
+            }
+            container.delete();
+        }
+    }
+
+    public void testList() throws IOException {
+        try (BlobStore store = newBlobStore()) {
+            final BlobContainer container = store.blobContainer(new BlobPath());
+            assertThat(container.listBlobs().size(), CoreMatchers.equalTo(0));
+            int numberOfFooBlobs = randomIntBetween(0, 10);
+            int numberOfBarBlobs = randomIntBetween(3, 20);
+            Map<String, Long> generatedBlobs = new HashMap<>();
+            for (int i = 0; i < numberOfFooBlobs; i++) {
+                int length = randomIntBetween(10, 100);
+                String name = "foo-" + i + "-";
+                generatedBlobs.put(name, (long) length);
+                writeRandomBlob(container, name, length);
+            }
+            for (int i = 1; i < numberOfBarBlobs; i++) {
+                int length = randomIntBetween(10, 100);
+                String name = "bar-" + i + "-";
+                generatedBlobs.put(name, (long) length);
+                writeRandomBlob(container, name, length);
+            }
+            int length = randomIntBetween(10, 100);
+            String name = "bar-0-";
+            generatedBlobs.put(name, (long) length);
+            writeRandomBlob(container, name, length);
+
+            Map<String, BlobMetaData> blobs = container.listBlobs();
+            assertThat(blobs.size(), CoreMatchers.equalTo(numberOfFooBlobs + numberOfBarBlobs));
+            for (Map.Entry<String, Long> generated : generatedBlobs.entrySet()) {
+                BlobMetaData blobMetaData = blobs.get(generated.getKey());
+                assertThat(generated.getKey(), blobMetaData, CoreMatchers.notNullValue());
+                assertThat(blobMetaData.name(), CoreMatchers.equalTo(generated.getKey()));
+                assertThat(blobMetaData.length(), CoreMatchers.equalTo(generated.getValue()));
+            }
+
+            assertThat(container.listBlobsByPrefix("foo-").size(), CoreMatchers.equalTo(numberOfFooBlobs));
+            assertThat(container.listBlobsByPrefix("bar-").size(), CoreMatchers.equalTo(numberOfBarBlobs));
+            assertThat(container.listBlobsByPrefix("baz-").size(), CoreMatchers.equalTo(0));
+            container.delete();
+        }
+    }
+
+    public void testDeleteBlobs() throws IOException {
+        try (BlobStore store = newBlobStore()) {
+            final List<String> blobNames = Arrays.asList("foobar", "barfoo");
+            final BlobContainer container = store.blobContainer(new BlobPath());
+            container.deleteBlobsIgnoringIfNotExists(blobNames); // does not raise when blobs don't exist
+            byte[] data = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
+            final BytesArray bytesArray = new BytesArray(data);
+            for (String blobName : blobNames) {
+                writeBlob(container, blobName, bytesArray, randomBoolean());
+            }
+            assertEquals(container.listBlobs().size(), 2);
+            container.deleteBlobsIgnoringIfNotExists(blobNames);
+            assertTrue(container.listBlobs().isEmpty());
+            container.deleteBlobsIgnoringIfNotExists(blobNames); // does not raise when blobs don't exist
+        }
+    }
+
+    public static void writeBlob(final BlobContainer container, final String blobName, final BytesArray bytesArray,
+        boolean failIfAlreadyExists) throws IOException {
+        try (InputStream stream = bytesArray.streamInput()) {
+            if (randomBoolean()) {
+                container.writeBlob(blobName, stream, bytesArray.length(), failIfAlreadyExists);
+            } else {
+                container.writeBlobAtomic(blobName, stream, bytesArray.length(), failIfAlreadyExists);
+            }
+        }
+    }
+
+    public void testContainerCreationAndDeletion() throws IOException {
+        try (BlobStore store = newBlobStore()) {
+            final BlobContainer containerFoo = store.blobContainer(new BlobPath().add("foo"));
+            final BlobContainer containerBar = store.blobContainer(new BlobPath().add("bar"));
+            byte[] data1 = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
+            byte[] data2 = randomBytes(randomIntBetween(10, scaledRandomIntBetween(1024, 1 << 16)));
+            writeBlob(containerFoo, "test", new BytesArray(data1));
+            writeBlob(containerBar, "test", new BytesArray(data2));
+
+            assertArrayEquals(readBlobFully(containerFoo, "test", data1.length), data1);
+            assertArrayEquals(readBlobFully(containerBar, "test", data2.length), data2);
+
+            assertTrue(BlobStoreTestUtil.blobExists(containerFoo, "test"));
+            assertTrue(BlobStoreTestUtil.blobExists(containerBar, "test"));
+            containerBar.delete();
+            containerFoo.delete();
+        }
+    }
+
+    public static byte[] writeRandomBlob(BlobContainer container, String name, int length) throws IOException {
+        byte[] data = randomBytes(length);
+        writeBlob(container, name, new BytesArray(data));
+        return data;
+    }
+
+    public static byte[] readBlobFully(BlobContainer container, String name, int length) throws IOException {
+        byte[] data = new byte[length];
+        try (InputStream inputStream = container.readBlob(name)) {
+            assertThat(inputStream.read(data), CoreMatchers.equalTo(length));
+            assertThat(inputStream.read(), CoreMatchers.equalTo(-1));
+        }
+        return data;
+    }
+
+    public static byte[] randomBytes(int length) {
+        byte[] data = new byte[length];
+        for (int i = 0; i < data.length; i++) {
+            data[i] = (byte) randomInt();
+        }
+        return data;
+    }
+
+    protected static void writeBlob(BlobContainer container, String blobName, BytesArray bytesArray) throws IOException {
+        try (InputStream stream = bytesArray.streamInput()) {
+            container.writeBlob(blobName, stream, bytesArray.length(), true);
+        }
+    }
+
+    protected BlobStore newBlobStore() {
+        final String repository = createRepository(randomName());
+        final BlobStoreRepository blobStoreRepository =
+            (BlobStoreRepository) internalCluster().getMasterNodeInstance(RepositoriesService.class).repository(repository);
+        return PlainActionFuture.get(
+            f -> blobStoreRepository.threadPool().generic().execute(ActionRunnable.supply(f, blobStoreRepository::blobStore)));
+    }
+
     public void testSnapshotAndRestore() throws Exception {
         final String repoName = createRepository(randomName());
         int indexCount = randomIntBetween(1, 5);
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
index d5411ebb20b19..5d3db0ad4dbc8 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
@@ -76,7 +76,7 @@
 import java.util.Map;
 
 import static java.time.Clock.systemUTC;
-import static org.elasticsearch.repositories.ESBlobStoreContainerTestCase.randomBytes;
+import static org.elasticsearch.repositories.blobstore.ESBlobStoreRepositoryIntegTestCase.randomBytes;
 import static org.elasticsearch.test.ClusterServiceUtils.setState;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;

From 20ba8f834f933b44e1a86ff4e940e0a098c3e1c1 Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Mon, 16 Dec 2019 09:57:18 +0000
Subject: [PATCH 210/686] Refactor environment variable processing for Docker
 (#49612)

Closes #45223.

The current Docker entrypoint script picks up environment variables and
translates them into -E command line arguments. However, since any tool
executes via `docker exec` doesn't run the entrypoint, it results in
a poorer user experience.

Therefore, refactor the env var handling so that the -E options are
generated in `elasticsearch-env`. These have to be appended to any
existing command arguments, since some CLI tools have subcommands and
-E arguments must come after the subcommand.

Also extract the support for `_FILE` env vars into a separate script, so
that it can be called from more than once place (the behaviour is
idempotent).

Finally, add noop -E handling to CronEvalTool for parity, and support
`-E` in MultiCommand before subcommands.
---
 distribution/docker/src/docker/Dockerfile     |  4 +-
 .../src/docker/bin/docker-entrypoint.sh       | 70 ++-----------------
 distribution/src/bin/elasticsearch-env        | 47 +++++++++++++
 .../src/bin/elasticsearch-env-from-file       | 42 +++++++++++
 .../org/elasticsearch/cli/MultiCommand.java   | 26 +++++--
 .../packaging/test/DockerTests.java           | 21 ++++++
 .../elasticsearch/packaging/util/Docker.java  | 14 +++-
 .../elasticsearch/cli/MultiCommandTests.java  | 57 +++++++++++----
 .../configuring-tls-docker.asciidoc           |  4 --
 .../trigger/schedule/tool/CronEvalTool.java   |  4 +-
 10 files changed, 193 insertions(+), 96 deletions(-)
 create mode 100644 distribution/src/bin/elasticsearch-env-from-file

diff --git a/distribution/docker/src/docker/Dockerfile b/distribution/docker/src/docker/Dockerfile
index 3a42a3e717185..0f9087b143e3d 100644
--- a/distribution/docker/src/docker/Dockerfile
+++ b/distribution/docker/src/docker/Dockerfile
@@ -29,7 +29,7 @@ ${source_elasticsearch}
 
 RUN tar zxf /opt/${elasticsearch} --strip-components=1
 RUN grep ES_DISTRIBUTION_TYPE=tar /usr/share/elasticsearch/bin/elasticsearch-env \
-    && sed -ie 's/ES_DISTRIBUTION_TYPE=tar/ES_DISTRIBUTION_TYPE=docker/' /usr/share/elasticsearch/bin/elasticsearch-env
+    && sed -i -e 's/ES_DISTRIBUTION_TYPE=tar/ES_DISTRIBUTION_TYPE=docker/' /usr/share/elasticsearch/bin/elasticsearch-env
 RUN mkdir -p config data logs
 RUN chmod 0775 config data logs
 COPY config/elasticsearch.yml config/log4j2.properties config/
@@ -46,7 +46,7 @@ FROM ${base_image}
 ENV ELASTIC_CONTAINER true
 
 RUN for iter in {1..10}; do ${package_manager} update --setopt=tsflags=nodocs -y && \
-    ${package_manager} install --setopt=tsflags=nodocs -y nc shadow-utils && \
+    ${package_manager} install --setopt=tsflags=nodocs -y nc shadow-utils zip unzip && \
     ${package_manager} clean all && exit_code=0 && break || exit_code=\$? && echo "${package_manager} error: retry \$iter in 10s" && sleep 10; done; \
     (exit \$exit_code)
 
diff --git a/distribution/docker/src/docker/bin/docker-entrypoint.sh b/distribution/docker/src/docker/bin/docker-entrypoint.sh
index cd418a5415ddc..0366060257b2c 100644
--- a/distribution/docker/src/docker/bin/docker-entrypoint.sh
+++ b/distribution/docker/src/docker/bin/docker-entrypoint.sh
@@ -42,71 +42,11 @@ fi
 # contents, and setting an environment variable with the suffix _FILE to
 # point to it. This can be used to provide secrets to a container, without
 # the values being specified explicitly when running the container.
-for VAR_NAME_FILE in $(env | cut -f1 -d= | grep '_FILE$'); do
-  if [[ -n "$VAR_NAME_FILE" ]]; then
-    VAR_NAME="${VAR_NAME_FILE%_FILE}"
-
-    if env | grep "^${VAR_NAME}="; then
-      echo "ERROR: Both $VAR_NAME_FILE and $VAR_NAME are set. These are mutually exclusive." >&2
-      exit 1
-    fi
-
-    if [[ ! -e "${!VAR_NAME_FILE}" ]]; then
-      echo "ERROR: File ${!VAR_NAME_FILE} from $VAR_NAME_FILE does not exist" >&2
-      exit 1
-    fi
-
-    FILE_PERMS="$(stat -c '%a' ${!VAR_NAME_FILE})"
-
-    if [[ "$FILE_PERMS" != "400" && "$FILE_PERMS" != 600 ]]; then
-        echo "ERROR: File ${!VAR_NAME_FILE} from $VAR_NAME_FILE must have file permissions 400 or 600, but actually has: $FILE_PERMS" >&2
-        exit 1
-    fi
-
-    echo "Setting $VAR_NAME from $VAR_NAME_FILE at ${!VAR_NAME_FILE}" >&2
-    export "$VAR_NAME"="$(cat ${!VAR_NAME_FILE})"
-
-    unset VAR_NAME
-    # Unset the suffixed environment variable
-    unset "$VAR_NAME_FILE"
-  fi
-done
-
-# Parse Docker env vars to customize Elasticsearch
-#
-# e.g. Setting the env var cluster.name=testcluster
 #
-# will cause Elasticsearch to be invoked with -Ecluster.name=testcluster
-#
-# see https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html#_setting_default_settings
-
-declare -a es_opts
-
-while IFS='=' read -r envvar_key envvar_value
-do
-  # Elasticsearch settings need to have at least two dot separated lowercase
-  # words, e.g. `cluster.name`
-  if [[ "$envvar_key" =~ ^[a-z0-9_]+\.[a-z0-9_]+ ]]; then
-    if [[ ! -z $envvar_value ]]; then
-      es_opt="-E${envvar_key}=${envvar_value}"
-      es_opts+=("${es_opt}")
-    fi
-  fi
-done < <(env)
-
-# The virtual file /proc/self/cgroup should list the current cgroup
-# membership. For each hierarchy, you can follow the cgroup path from
-# this file to the cgroup filesystem (usually /sys/fs/cgroup/) and
-# introspect the statistics for the cgroup for the given
-# hierarchy. Alas, Docker breaks this by mounting the container
-# statistics at the root while leaving the cgroup paths as the actual
-# paths. Therefore, Elasticsearch provides a mechanism to override
-# reading the cgroup path from /proc/self/cgroup and instead uses the
-# cgroup path defined the JVM system property
-# es.cgroups.hierarchy.override. Therefore, we set this value here so
-# that cgroup statistics are available for the container this process
-# will run in.
-export ES_JAVA_OPTS="-Des.cgroups.hierarchy.override=/ $ES_JAVA_OPTS"
+# This is also sourced in elasticsearch-env, and is only needed here
+# as well because we use ELASTIC_PASSWORD below. Sourcing this script
+# is idempotent.
+source /usr/share/elasticsearch/bin/elasticsearch-env-from-file
 
 if [[ -f bin/elasticsearch-users ]]; then
   # Check for the ELASTIC_PASSWORD environment variable to set the
@@ -130,4 +70,4 @@ if [[ "$(id -u)" == "0" ]]; then
   fi
 fi
 
-run_as_other_user_if_needed /usr/share/elasticsearch/bin/elasticsearch "${es_opts[@]}"
+run_as_other_user_if_needed /usr/share/elasticsearch/bin/elasticsearch
diff --git a/distribution/src/bin/elasticsearch-env b/distribution/src/bin/elasticsearch-env
index 867e19b3edd6b..cbdfbf8facb5c 100644
--- a/distribution/src/bin/elasticsearch-env
+++ b/distribution/src/bin/elasticsearch-env
@@ -86,4 +86,51 @@ ES_DISTRIBUTION_FLAVOR=${es.distribution.flavor}
 ES_DISTRIBUTION_TYPE=${es.distribution.type}
 ES_BUNDLED_JDK=${es.bundled_jdk}
 
+if [[ "$ES_DISTRIBUTION_TYPE" == "docker" ]]; then
+  # Allow environment variables to be set by creating a file with the
+  # contents, and setting an environment variable with the suffix _FILE to
+  # point to it. This can be used to provide secrets to a container, without
+  # the values being specified explicitly when running the container.
+  source "$ES_HOME/bin/elasticsearch-env-from-file"
+
+  # Parse Docker env vars to customize Elasticsearch
+  #
+  # e.g. Setting the env var cluster.name=testcluster
+  #
+  # will cause Elasticsearch to be invoked with -Ecluster.name=testcluster
+  #
+  # see https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html#_setting_default_settings
+
+  declare -a es_arg_array
+
+  while IFS='=' read -r envvar_key envvar_value
+  do
+    # Elasticsearch settings need to have at least two dot separated lowercase
+    # words, e.g. `cluster.name`
+    if [[ "$envvar_key" =~ ^[a-z0-9_]+\.[a-z0-9_]+ ]]; then
+      if [[ ! -z $envvar_value ]]; then
+        es_opt="-E${envvar_key}=${envvar_value}"
+        es_arg_array+=("${es_opt}")
+      fi
+    fi
+  done < <(env)
+
+  # Reset the positional parameters to the es_arg_array values and any existing positional params
+  set -- "$@" "${es_arg_array[@]}"
+
+  # The virtual file /proc/self/cgroup should list the current cgroup
+  # membership. For each hierarchy, you can follow the cgroup path from
+  # this file to the cgroup filesystem (usually /sys/fs/cgroup/) and
+  # introspect the statistics for the cgroup for the given
+  # hierarchy. Alas, Docker breaks this by mounting the container
+  # statistics at the root while leaving the cgroup paths as the actual
+  # paths. Therefore, Elasticsearch provides a mechanism to override
+  # reading the cgroup path from /proc/self/cgroup and instead uses the
+  # cgroup path defined the JVM system property
+  # es.cgroups.hierarchy.override. Therefore, we set this value here so
+  # that cgroup statistics are available for the container this process
+  # will run in.
+  export ES_JAVA_OPTS="-Des.cgroups.hierarchy.override=/ $ES_JAVA_OPTS"
+fi
+
 cd "$ES_HOME"
diff --git a/distribution/src/bin/elasticsearch-env-from-file b/distribution/src/bin/elasticsearch-env-from-file
new file mode 100644
index 0000000000000..fd5326afcc6b7
--- /dev/null
+++ b/distribution/src/bin/elasticsearch-env-from-file
@@ -0,0 +1,42 @@
+#!/bin/bash
+
+set -e -o pipefail
+
+# Allow environment variables to be set by creating a file with the
+# contents, and setting an environment variable with the suffix _FILE to
+# point to it. This can be used to provide secrets to a container, without
+# the values being specified explicitly when running the container.
+#
+# This script is intended to be sourced, not executed, and modifies the
+# environment.
+
+for VAR_NAME_FILE in $(env | cut -f1 -d= | grep '_FILE$'); do
+  if [[ -n "$VAR_NAME_FILE" ]]; then
+    VAR_NAME="${VAR_NAME_FILE%_FILE}"
+
+    if env | grep "^${VAR_NAME}="; then
+      echo "ERROR: Both $VAR_NAME_FILE and $VAR_NAME are set. These are mutually exclusive." >&2
+      exit 1
+    fi
+
+    if [[ ! -e "${!VAR_NAME_FILE}" ]]; then
+      echo "ERROR: File ${!VAR_NAME_FILE} from $VAR_NAME_FILE does not exist" >&2
+      exit 1
+    fi
+
+    FILE_PERMS="$(stat -c '%a' ${!VAR_NAME_FILE})"
+
+    if [[ "$FILE_PERMS" != "400" && "$FILE_PERMS" != 600 ]]; then
+        echo "ERROR: File ${!VAR_NAME_FILE} from $VAR_NAME_FILE must have file permissions 400 or 600, but actually has: $FILE_PERMS" >&2
+        exit 1
+    fi
+
+    echo "Setting $VAR_NAME from $VAR_NAME_FILE at ${!VAR_NAME_FILE}" >&2
+    export "$VAR_NAME"="$(cat ${!VAR_NAME_FILE})"
+
+    unset VAR_NAME
+    # Unset the suffixed environment variable
+    unset "$VAR_NAME_FILE"
+  fi
+done
+
diff --git a/libs/cli/src/main/java/org/elasticsearch/cli/MultiCommand.java b/libs/cli/src/main/java/org/elasticsearch/cli/MultiCommand.java
index bcc75a2d1be12..e33598638a936 100644
--- a/libs/cli/src/main/java/org/elasticsearch/cli/MultiCommand.java
+++ b/libs/cli/src/main/java/org/elasticsearch/cli/MultiCommand.java
@@ -21,11 +21,14 @@
 
 import joptsimple.NonOptionArgumentSpec;
 import joptsimple.OptionSet;
+import joptsimple.OptionSpec;
+import joptsimple.util.KeyValuePair;
 import org.elasticsearch.core.internal.io.IOUtils;
 
 import java.io.IOException;
-import java.util.Arrays;
+import java.util.ArrayList;
 import java.util.LinkedHashMap;
+import java.util.List;
 import java.util.Map;
 
 /**
@@ -36,6 +39,7 @@ public class MultiCommand extends Command {
     protected final Map<String, Command> subcommands = new LinkedHashMap<>();
 
     private final NonOptionArgumentSpec<String> arguments = parser.nonOptions("command");
+    private final OptionSpec<KeyValuePair> settingOption;
 
     /**
      * Construct the multi-command with the specified command description and runnable to execute before main is invoked.
@@ -45,6 +49,7 @@ public class MultiCommand extends Command {
      */
     public MultiCommand(final String description, final Runnable beforeMain) {
         super(description, beforeMain);
+        this.settingOption = parser.accepts("E", "Configure a setting").withRequiredArg().ofType(KeyValuePair.class);
         parser.posixlyCorrect(true);
     }
 
@@ -66,15 +71,24 @@ protected void execute(Terminal terminal, OptionSet options) throws Exception {
         if (subcommands.isEmpty()) {
             throw new IllegalStateException("No subcommands configured");
         }
-        String[] args = arguments.values(options).toArray(new String[0]);
-        if (args.length == 0) {
+
+        // .values(...) returns an unmodifiable list
+        final List<String> args = new ArrayList<>(arguments.values(options));
+        if (args.isEmpty()) {
             throw new UserException(ExitCodes.USAGE, "Missing command");
         }
-        Command subcommand = subcommands.get(args[0]);
+
+        String subcommandName = args.remove(0);
+        Command subcommand = subcommands.get(subcommandName);
         if (subcommand == null) {
-            throw new UserException(ExitCodes.USAGE, "Unknown command [" + args[0] + "]");
+            throw new UserException(ExitCodes.USAGE, "Unknown command [" + subcommandName + "]");
         }
-        subcommand.mainWithoutErrorHandling(Arrays.copyOfRange(args, 1, args.length), terminal);
+
+        for (final KeyValuePair pair : this.settingOption.values(options)) {
+            args.add("-E" + pair);
+        }
+
+        subcommand.mainWithoutErrorHandling(args.toArray(new String[0]), terminal);
     }
 
     @Override
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
index c8575902721c0..a9fa84962490f 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
@@ -390,6 +390,27 @@ public void test082EnvironmentVariablesUsingFilesHaveCorrectPermissions() throws
         );
     }
 
+    /**
+     * Check that environment variables are translated to -E options even for commands invoked under
+     * `docker exec`, where the Docker image's entrypoint is not executed.
+     */
+    public void test83EnvironmentVariablesAreRespectedUnderDockerExec() {
+        // This test relies on a CLI tool attempting to connect to Elasticsearch, and the
+        // tool in question is only in the default distribution.
+        assumeTrue(distribution.isDefault());
+
+        runContainer(distribution(), null, Map.of("http.host", "this.is.not.valid"));
+
+        // This will fail if the env var above is passed as a -E argument
+        final Result result = sh.runIgnoreExitCode("elasticsearch-setup-passwords auto");
+
+        assertFalse("elasticsearch-setup-passwords command should have failed", result.isSuccess());
+        assertThat(
+            result.stdout,
+            containsString("java.net.UnknownHostException: this.is.not.valid: Name or service not known")
+        );
+    }
+
     /**
      * Check whether the elasticsearch-certutil tool has been shipped correctly,
      * and if present then it can execute.
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
index 245806363c6ab..313060cdd3989 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
@@ -46,10 +46,11 @@
 import static org.elasticsearch.packaging.util.FileMatcher.p775;
 import static org.elasticsearch.packaging.util.FileUtils.getCurrentVersion;
 import static org.elasticsearch.packaging.util.ServerUtils.makeRequest;
-import static org.hamcrest.CoreMatchers.containsString;
 import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertTrue;
 import static org.junit.Assert.fail;
 
 /**
@@ -276,7 +277,7 @@ public static class DockerShell extends Shell {
         protected String[] getScriptCommand(String script) {
             assert containerId != null;
 
-            return super.getScriptCommand("docker exec " + "--user elasticsearch:root " + "--tty " + containerId + " " + script);
+            return super.getScriptCommand("docker exec --user elasticsearch:root --tty " + containerId + " " + script);
         }
     }
 
@@ -438,7 +439,6 @@ private static void verifyOssInstallation(Installation es) {
             "elasticsearch",
             "elasticsearch-cli",
             "elasticsearch-env",
-            "elasticsearch-enve",
             "elasticsearch-keystore",
             "elasticsearch-node",
             "elasticsearch-plugin",
@@ -446,6 +446,14 @@ private static void verifyOssInstallation(Installation es) {
         ).forEach(executable -> assertPermissionsAndOwnership(es.bin(executable), p755));
 
         Stream.of("LICENSE.txt", "NOTICE.txt", "README.textile").forEach(doc -> assertPermissionsAndOwnership(es.home.resolve(doc), p644));
+
+        // These are installed to help users who are working with certificates.
+        Stream.of("zip", "unzip").forEach(cliPackage -> {
+            // We could run `yum list installed $pkg` but that causes yum to call out to the network.
+            // rpm does the job just as well.
+            final Shell.Result result = dockerShell.runIgnoreExitCode("rpm -q " + cliPackage);
+            assertTrue(cliPackage + " ought to be installed. " + result, result.isSuccess());
+        });
     }
 
     private static void verifyDefaultInstallation(Installation es) {
diff --git a/server/src/test/java/org/elasticsearch/cli/MultiCommandTests.java b/server/src/test/java/org/elasticsearch/cli/MultiCommandTests.java
index 41fe851ed2561..38c0edaee801e 100644
--- a/server/src/test/java/org/elasticsearch/cli/MultiCommandTests.java
+++ b/server/src/test/java/org/elasticsearch/cli/MultiCommandTests.java
@@ -19,12 +19,17 @@
 
 package org.elasticsearch.cli;
 
+import joptsimple.ArgumentAcceptingOptionSpec;
 import joptsimple.OptionSet;
+import joptsimple.util.KeyValuePair;
 import org.junit.Before;
 
 import java.io.IOException;
+import java.util.List;
 import java.util.concurrent.atomic.AtomicBoolean;
 
+import static org.hamcrest.Matchers.containsString;
+
 public class MultiCommandTests extends CommandTestCase {
 
     static class DummyMultiCommand extends MultiCommand {
@@ -32,8 +37,7 @@ static class DummyMultiCommand extends MultiCommand {
         final AtomicBoolean closed = new AtomicBoolean();
 
         DummyMultiCommand() {
-            super("A dummy multi command", () -> {
-            });
+            super("A dummy multi command", () -> {});
         }
 
         @Override
@@ -75,7 +79,23 @@ public void close() throws IOException {
         }
     }
 
-    DummyMultiCommand multiCommand;
+    static class DummySettingsSubCommand extends DummySubCommand {
+        private final ArgumentAcceptingOptionSpec<KeyValuePair> settingOption;
+
+        DummySettingsSubCommand() {
+            super();
+            this.settingOption = parser.accepts("E", "Configure a setting").withRequiredArg().ofType(KeyValuePair.class);
+        }
+
+        @Override
+        protected void execute(Terminal terminal, OptionSet options) throws Exception {
+            final List<KeyValuePair> values = this.settingOption.values(options);
+            terminal.println("Settings: " + values);
+            super.execute(terminal, options);
+        }
+    }
+
+    private DummyMultiCommand multiCommand;
 
     @Before
     public void setupCommand() {
@@ -87,27 +107,21 @@ protected Command newCommand() {
         return multiCommand;
     }
 
-    public void testNoCommandsConfigured() throws Exception {
-        IllegalStateException e = expectThrows(IllegalStateException.class, () -> {
-            execute();
-        });
+    public void testNoCommandsConfigured() {
+        IllegalStateException e = expectThrows(IllegalStateException.class, this::execute);
         assertEquals("No subcommands configured", e.getMessage());
     }
 
-    public void testUnknownCommand() throws Exception {
+    public void testUnknownCommand() {
         multiCommand.subcommands.put("something", new DummySubCommand());
-        UserException e = expectThrows(UserException.class, () -> {
-            execute("somethingelse");
-        });
+        UserException e = expectThrows(UserException.class, () -> execute("somethingelse"));
         assertEquals(ExitCodes.USAGE, e.exitCode);
         assertEquals("Unknown command [somethingelse]", e.getMessage());
     }
 
-    public void testMissingCommand() throws Exception {
+    public void testMissingCommand() {
         multiCommand.subcommands.put("command1", new DummySubCommand());
-        UserException e = expectThrows(UserException.class, () -> {
-            execute();
-        });
+        UserException e = expectThrows(UserException.class, this::execute);
         assertEquals(ExitCodes.USAGE, e.exitCode);
         assertEquals("Missing command", e.getMessage());
     }
@@ -121,6 +135,19 @@ public void testHelp() throws Exception {
         assertTrue(output, output.contains("command2"));
     }
 
+    /**
+     * Check that if -E arguments are passed to the main command, then they are accepted
+     * and passed on to the subcommand.
+     */
+    public void testSettingsOnMainCommand() throws Exception {
+        multiCommand.subcommands.put("command1", new DummySettingsSubCommand());
+        execute("-Esetting1=value1", "-Esetting2=value2", "command1", "otherArg");
+
+        String output = terminal.getOutput();
+        assertThat(output, containsString("Settings: [setting1=value1, setting2=value2]"));
+        assertThat(output, containsString("Arguments: [otherArg]"));
+    }
+
     public void testSubcommandHelp() throws Exception {
         multiCommand.subcommands.put("command1", new DummySubCommand());
         multiCommand.subcommands.put("command2", new DummySubCommand());
diff --git a/x-pack/docs/en/security/securing-communications/configuring-tls-docker.asciidoc b/x-pack/docs/en/security/securing-communications/configuring-tls-docker.asciidoc
index ec00220ab1d75..ac4cbcc40053a 100644
--- a/x-pack/docs/en/security/securing-communications/configuring-tls-docker.asciidoc
+++ b/x-pack/docs/en/security/securing-communications/configuring-tls-docker.asciidoc
@@ -71,7 +71,6 @@ services:
     image: {docker-image}
     command: >
       bash -c '
-        yum install -y -q -e 0 unzip;
         if [[ ! -f /certs/bundle.zip ]]; then
           bin/elasticsearch-certutil cert --silent --pem --in config/certificates/instances.yml -out /certs/bundle.zip;
           unzip /certs/bundle.zip -d /certs; <1>
@@ -206,9 +205,6 @@ WARNING: Windows users not running PowerShell will need to remove `\` and join l
 ----
 docker exec es01 /bin/bash -c "bin/elasticsearch-setup-passwords \
 auto --batch \
--Expack.security.http.ssl.certificate=certificates/es01/es01.crt \
--Expack.security.http.ssl.certificate_authorities=certificates/ca/ca.crt \
--Expack.security.http.ssl.key=certificates/es01/es01.key \
 --url https://localhost:9200"
 ----
 --
diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
index 28b2a363ceba3..565bae15ea998 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
@@ -44,6 +44,8 @@ public static void main(String[] args) throws Exception {
             "The number of future times this expression will be triggered")
             .withRequiredArg().ofType(Integer.class).defaultsTo(10);
         this.arguments = parser.nonOptions("expression");
+
+        parser.accepts("E", "Unused. Only for compatibility with other CLI tools.").withRequiredArg();
     }
 
     @Override
@@ -56,7 +58,7 @@ protected void execute(Terminal terminal, OptionSet options) throws Exception {
         execute(terminal, args.get(0), count);
     }
 
-    void execute(Terminal terminal, String expression, int count) throws Exception {
+    private void execute(Terminal terminal, String expression, int count) throws Exception {
         Cron.validate(expression);
         terminal.println("Valid!");
 

From a268fdb123c95a087e18c042421278d04d772ee5 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Mon, 16 Dec 2019 10:14:47 +0000
Subject: [PATCH 211/686] [ML] Fix exception when field is not included and
 excluded at the same time (#50192)

Executing the data frame analytics _explain API with a config that contains
a field that is not in the includes list but at the same time is the excludes
list results to trying to remove the field twice from the iterator. That causes
an `IllegalStateException`. This commit fixes this issue and adds a test that
captures the scenario.
---
 .../extractor/ExtractedFieldsDetector.java    |  8 +++----
 .../ExtractedFieldsDetectorTests.java         | 21 +++++++++++++++++++
 2 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
index a98d2cb40543b..6897263ee0638 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
@@ -235,14 +235,14 @@ private void applyIncludesExcludes(Set<String> fields, Set<String> includes, Set
                 if (IGNORE_FIELDS.contains(field)) {
                     throw ExceptionsHelper.badRequestException("field [{}] cannot be analyzed", field);
                 }
+                if (excludes.contains(field)) {
+                    fieldsIterator.remove();
+                    addExcludedField(field, "field in excludes list", fieldSelection);
+                }
             } else {
                 fieldsIterator.remove();
                 addExcludedField(field, "field not in includes list", fieldSelection);
             }
-            if (excludes.contains(field)) {
-                fieldsIterator.remove();
-                addExcludedField(field, "field in excludes list", fieldSelection);
-            }
         }
     }
 
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
index 9c55b2a9ac956..6b882d03f2919 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
@@ -233,6 +233,27 @@ public void testDetect_GivenFieldIsBothIncludedAndExcluded() {
         );
     }
 
+    public void testDetect_GivenFieldIsNotIncludedAndIsExcluded() {
+        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
+            .addAggregatableField("foo", "float")
+            .addAggregatableField("bar", "float")
+            .build();
+        analyzedFields = new FetchSourceContext(true, new String[]  {"foo"}, new String[] {"bar"});
+
+        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
+            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
+
+        List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
+        assertThat(allFields, hasSize(1));
+        assertThat(allFields.stream().map(ExtractedField::getName).collect(Collectors.toList()), contains("foo"));
+
+        assertFieldSelectionContains(fieldExtraction.v2(),
+            FieldSelection.excluded("bar", Collections.singleton("float"), "field not in includes list"),
+            FieldSelection.included("foo", Collections.singleton("float"), false, FieldSelection.FeatureType.NUMERICAL)
+        );
+    }
+
     public void testDetect_GivenRegressionAndRequiredFieldHasInvalidType() {
         FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
             .addAggregatableField("some_float", "float")

From 0ecad262e75f11e772eeeffefe88436f843946af Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Mon, 16 Dec 2019 12:42:42 +0100
Subject: [PATCH 212/686] Disk threshold decider is enabled by default (#50222)

An old comment had survived after the default was flipped.

Relates #6204
---
 .../routing/allocation/decider/DiskThresholdDecider.java    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/cluster/routing/allocation/decider/DiskThresholdDecider.java b/server/src/main/java/org/elasticsearch/cluster/routing/allocation/decider/DiskThresholdDecider.java
index 60634684ed0c8..5584a69a95e48 100644
--- a/server/src/main/java/org/elasticsearch/cluster/routing/allocation/decider/DiskThresholdDecider.java
+++ b/server/src/main/java/org/elasticsearch/cluster/routing/allocation/decider/DiskThresholdDecider.java
@@ -19,8 +19,6 @@
 
 package org.elasticsearch.cluster.routing.allocation.decider;
 
-import java.util.Set;
-
 import com.carrotsearch.hppc.cursors.ObjectCursor;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
@@ -44,6 +42,8 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.shard.ShardId;
 
+import java.util.Set;
+
 import static org.elasticsearch.cluster.routing.allocation.DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_HIGH_DISK_WATERMARK_SETTING;
 import static org.elasticsearch.cluster.routing.allocation.DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_LOW_DISK_WATERMARK_SETTING;
 
@@ -68,7 +68,7 @@
  * exact byte values for free space (like "500mb")
  *
  * <code>cluster.routing.allocation.disk.threshold_enabled</code> is used to
- * enable or disable this decider. It defaults to false (disabled).
+ * enable or disable this decider. It defaults to true (enabled).
  */
 public class DiskThresholdDecider extends AllocationDecider {
 

From 0470eef73af8b9e8962c9e8e07cbc43dd86a243d Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 16 Dec 2019 12:47:31 +0100
Subject: [PATCH 213/686] Fix Index Deletion during Snapshot Finalization
 (#50202)

With #45689 making it so that index metadata is written
after all shards have been snapshotted we can't delete indices
that are part of the upcoming snapshot finalization any longer
and it is not sufficient to check if all shards of an index have been
snapshotted before deciding that it is safe to delete it.
This change forbids deleting any index that is in the process of being
snapshot to avoid issues during snapshot finalization.

Relates #50200 (doesn't fully fix yet because we're not fixing the `partial=true`
snapshot case here
---
 .../snapshots/SnapshotsService.java           | 19 ++------
 .../snapshots/SnapshotResiliencyTests.java    | 45 +++++++++++++++++++
 2 files changed, 49 insertions(+), 15 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
index a48f893dfd408..7c638bc332edc 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
@@ -1521,21 +1521,10 @@ public static Set<Index> snapshottingIndices(final ClusterState currentState, fi
         final Set<Index> indices = new HashSet<>();
         for (final SnapshotsInProgress.Entry entry : snapshots.entries()) {
             if (entry.partial() == false) {
-                if (entry.state() == State.INIT) {
-                    for (IndexId index : entry.indices()) {
-                        IndexMetaData indexMetaData = currentState.metaData().index(index.getName());
-                        if (indexMetaData != null && indicesToCheck.contains(indexMetaData.getIndex())) {
-                            indices.add(indexMetaData.getIndex());
-                        }
-                    }
-                } else {
-                    for (ObjectObjectCursor<ShardId, SnapshotsInProgress.ShardSnapshotStatus> shard : entry.shards()) {
-                        Index index = shard.key.getIndex();
-                        if (indicesToCheck.contains(index)
-                            && shard.value.state().completed() == false
-                            && currentState.getMetaData().index(index) != null) {
-                            indices.add(index);
-                        }
+                for (IndexId index : entry.indices()) {
+                    IndexMetaData indexMetaData = currentState.metaData().index(index.getName());
+                    if (indexMetaData != null && indicesToCheck.contains(indexMetaData.getIndex())) {
+                        indices.add(indexMetaData.getIndex());
                     }
                 }
             }
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
index 28d2beb2efcc4..a0e7e51098681 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
@@ -80,6 +80,7 @@
 import org.elasticsearch.action.support.ActiveShardCount;
 import org.elasticsearch.action.support.AutoCreateIndex;
 import org.elasticsearch.action.support.DestructiveOperations;
+import org.elasticsearch.action.support.GroupedActionListener;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.action.support.TransportAction;
 import org.elasticsearch.action.support.WriteRequest;
@@ -502,6 +503,50 @@ public void testConcurrentSnapshotCreateAndDeleteOther() {
         }
     }
 
+    public void testConcurrentSnapshotDeleteAndDeleteIndex() {
+        setupTestCluster(randomFrom(1, 3, 5), randomIntBetween(2, 10));
+
+        String repoName = "repo";
+        String snapshotName = "snapshot";
+        final String index = "test";
+
+        TestClusterNodes.TestClusterNode masterNode =
+            testClusterNodes.currentMaster(testClusterNodes.nodes.values().iterator().next().clusterService.state());
+
+        final StepListener<Collection<CreateIndexResponse>> createIndicesListener = new StepListener<>();
+
+        continueOrDie(createRepoAndIndex(repoName, index, 1), createIndexResponse -> {
+            // create a few more indices to make it more likely that the subsequent index delete operation happens before snapshot
+            // finalization
+            final int indices = randomIntBetween(5, 20);
+            final GroupedActionListener<CreateIndexResponse> listener = new GroupedActionListener<>(createIndicesListener, indices);
+            for (int i = 0; i < indices; ++i) {
+                client().admin().indices().create(new CreateIndexRequest("index-" + i), listener);
+            }
+        });
+
+        final StepListener<CreateSnapshotResponse> createSnapshotResponseStepListener = new StepListener<>();
+
+        continueOrDie(createIndicesListener, createIndexResponses ->
+            client().admin().cluster().prepareCreateSnapshot(repoName, snapshotName).setWaitForCompletion(false)
+                .execute(createSnapshotResponseStepListener));
+
+        continueOrDie(createSnapshotResponseStepListener,
+            createSnapshotResponse -> client().admin().indices().delete(new DeleteIndexRequest(index), noopListener()));
+
+        deterministicTaskQueue.runAllRunnableTasks();
+
+        SnapshotsInProgress finalSnapshotsInProgress = masterNode.clusterService.state().custom(SnapshotsInProgress.TYPE);
+        assertFalse(finalSnapshotsInProgress.entries().stream().anyMatch(entry -> entry.state().completed() == false));
+        final Repository repository = masterNode.repositoriesService.repository(repoName);
+        Collection<SnapshotId> snapshotIds = getRepositoryData(repository).getSnapshotIds();
+        assertThat(snapshotIds, hasSize(1));
+
+        final SnapshotInfo snapshotInfo = repository.getSnapshotInfo(snapshotIds.iterator().next());
+        assertEquals(SnapshotState.SUCCESS, snapshotInfo.state());
+        assertEquals(0, snapshotInfo.failedShards());
+    }
+
     /**
      * Simulates concurrent restarts of data and master nodes as well as relocating a primary shard, while starting and subsequently
      * deleting a snapshot.

From d274a6ac364565a272b23f140ee183b50a2daef4 Mon Sep 17 00:00:00 2001
From: Andrew Odendaal <andrew@hsmoore.com>
Date: Mon, 16 Dec 2019 13:30:05 +0000
Subject: [PATCH 214/686] =?UTF-8?q?[Docs]=C2=A0Fix=20typo=20in=20README=20?=
 =?UTF-8?q?(#50229)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.textile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.textile b/README.textile
index 985665811adea..2f7b0472c238e 100644
--- a/README.textile
+++ b/README.textile
@@ -191,7 +191,7 @@ h3. Distributed, Highly Available
 
 Let's face it, things will fail....
 
-Elasticsearch is a highly available and distributed search engine. Each index is broken down into shards, and each shard can have one or more replicas. By default, an index is created with 1 shards and 1 replica per shard (1/1). There are many topologies that can be used, including 1/10 (improve search performance), or 20/1 (improve indexing performance, with search executed in a map reduce fashion across shards).
+Elasticsearch is a highly available and distributed search engine. Each index is broken down into shards, and each shard can have one or more replicas. By default, an index is created with 1 shard and 1 replica per shard (1/1). There are many topologies that can be used, including 1/10 (improve search performance), or 20/1 (improve indexing performance, with search executed in a map reduce fashion across shards).
 
 In order to play with the distributed nature of Elasticsearch, simply bring more nodes up and shut down nodes. The system will continue to serve requests (make sure you use the correct http port) with the latest data indexed.
 

From 8fc5a50a63fd97cca783d6dbf7c5a9a647567fe8 Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Mon, 16 Dec 2019 14:25:22 +0000
Subject: [PATCH 215/686] [ML] Remove usage of base action logger in ml actions
 (#50074)

---
 .../xpack/ml/action/TransportCloseJobAction.java     |  4 ++++
 .../TransportDeleteDataFrameAnalyticsAction.java     | 10 +++++-----
 .../ml/action/TransportDeleteExpiredDataAction.java  |  4 ++++
 .../ml/action/TransportDeleteForecastAction.java     |  4 ++++
 .../action/TransportDeleteModelSnapshotAction.java   |  4 ++++
 .../ml/action/TransportDeleteTrainedModelAction.java |  4 ++--
 .../TransportGetDataFrameAnalyticsStatsAction.java   |  8 ++++----
 .../xpack/ml/action/TransportGetJobsStatsAction.java |  4 ++++
 .../ml/action/TransportGetModelSnapshotsAction.java  |  4 ++++
 .../ml/action/TransportGetOverallBucketsAction.java  |  4 ++++
 .../xpack/ml/action/TransportKillProcessAction.java  |  4 ++++
 .../xpack/ml/action/TransportMlInfoAction.java       |  4 ++++
 .../TransportStartDataFrameAnalyticsAction.java      | 12 ++++++------
 .../xpack/ml/action/TransportStopDatafeedAction.java |  4 ++++
 .../action/TransportUpdateModelSnapshotAction.java   |  4 ++++
 15 files changed, 61 insertions(+), 17 deletions(-)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportCloseJobAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportCloseJobAction.java
index bd3f2d205d32a..c79ee507bd9d2 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportCloseJobAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportCloseJobAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
@@ -50,6 +52,8 @@
 public class TransportCloseJobAction extends TransportTasksAction<TransportOpenJobAction.JobTask, CloseJobAction.Request,
         CloseJobAction.Response, CloseJobAction.Response> {
 
+    private static final Logger logger = LogManager.getLogger(TransportCloseJobAction.class);
+
     private final ThreadPool threadPool;
     private final Client client;
     private final ClusterService clusterService;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
index 96f56fab4e234..9d221f9c68f6f 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
@@ -65,7 +65,7 @@
 public class TransportDeleteDataFrameAnalyticsAction
     extends TransportMasterNodeAction<DeleteDataFrameAnalyticsAction.Request, AcknowledgedResponse> {
 
-    private static final Logger LOGGER = LogManager.getLogger(TransportDeleteDataFrameAnalyticsAction.class);
+    private static final Logger logger = LogManager.getLogger(TransportDeleteDataFrameAnalyticsAction.class);
 
     private final Client client;
     private final MlMemoryTracker memoryTracker;
@@ -118,13 +118,13 @@ protected void masterOperation(Task task, DeleteDataFrameAnalyticsAction.Request
         ActionListener<BulkByScrollResponse> deleteStateHandler = ActionListener.wrap(
             bulkByScrollResponse -> {
                 if (bulkByScrollResponse.isTimedOut()) {
-                    LOGGER.warn("[{}] DeleteByQuery for state timed out", id);
+                    logger.warn("[{}] DeleteByQuery for state timed out", id);
                 }
                 if (bulkByScrollResponse.getBulkFailures().isEmpty() == false) {
-                    LOGGER.warn("[{}] {} failures and {} conflicts encountered while runnint DeleteByQuery for state", id,
+                    logger.warn("[{}] {} failures and {} conflicts encountered while runnint DeleteByQuery for state", id,
                         bulkByScrollResponse.getBulkFailures().size(), bulkByScrollResponse.getVersionConflicts());
                     for (BulkItemResponse.Failure failure : bulkByScrollResponse.getBulkFailures()) {
-                        LOGGER.warn("[{}] DBQ failure: {}", id, failure);
+                        logger.warn("[{}] DBQ failure: {}", id, failure);
                     }
                 }
                 deleteConfig(parentTaskClient, id, listener);
@@ -153,7 +153,7 @@ private void deleteConfig(ParentTaskAssigningClient parentTaskClient, String id,
                     return;
                 }
                 assert deleteResponse.getResult() == DocWriteResponse.Result.DELETED;
-                LOGGER.info("[{}] Deleted", id);
+                logger.info("[{}] Deleted", id);
                 auditor.info(id, Messages.DATA_FRAME_ANALYTICS_AUDIT_DELETED);
                 listener.onResponse(new AcknowledgedResponse(true));
             },
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteExpiredDataAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteExpiredDataAction.java
index c799d57d74f6b..bc4bb6e16e53c 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteExpiredDataAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteExpiredDataAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.HandledTransportAction;
@@ -37,6 +39,8 @@
 public class TransportDeleteExpiredDataAction extends HandledTransportAction<DeleteExpiredDataAction.Request,
         DeleteExpiredDataAction.Response> {
 
+    private static final Logger logger = LogManager.getLogger(TransportDeleteExpiredDataAction.class);
+
     // TODO: make configurable in the request
     static final Duration MAX_DURATION = Duration.ofHours(8);
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteForecastAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteForecastAction.java
index 1e5659bd23398..3b5f0b16e2d44 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteForecastAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteForecastAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.ResourceNotFoundException;
@@ -66,6 +68,8 @@
 
 public class TransportDeleteForecastAction extends HandledTransportAction<DeleteForecastAction.Request, AcknowledgedResponse> {
 
+    private static final Logger logger = LogManager.getLogger(TransportDeleteForecastAction.class);
+
     private final Client client;
     private static final int MAX_FORECAST_TO_SEARCH = 10_000;
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteModelSnapshotAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteModelSnapshotAction.java
index 8071adc34a021..97a6c9c8a784a 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteModelSnapshotAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteModelSnapshotAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
@@ -29,6 +31,8 @@
 public class TransportDeleteModelSnapshotAction extends HandledTransportAction<DeleteModelSnapshotAction.Request,
     AcknowledgedResponse> {
 
+    private static final Logger logger = LogManager.getLogger(TransportDeleteModelSnapshotAction.class);
+
     private final Client client;
     private final JobManager jobManager;
     private final JobResultsProvider jobResultsProvider;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteTrainedModelAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteTrainedModelAction.java
index aadcb9dd34708..55d4eba05ecc4 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteTrainedModelAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteTrainedModelAction.java
@@ -47,7 +47,7 @@
 public class TransportDeleteTrainedModelAction
     extends TransportMasterNodeAction<DeleteTrainedModelAction.Request, AcknowledgedResponse> {
 
-    private static final Logger LOGGER = LogManager.getLogger(TransportDeleteTrainedModelAction.class);
+    private static final Logger logger = LogManager.getLogger(TransportDeleteTrainedModelAction.class);
 
     private final TrainedModelProvider trainedModelProvider;
     private final InferenceAuditor auditor;
@@ -120,7 +120,7 @@ private Set<String> getReferencedModelKeys(IngestMetadata ingestMetadata) {
                     .map(InferenceProcessor::getModelId)
                     .forEach(allReferencedModelKeys::add);
             } catch (Exception ex) {
-                LOGGER.warn(new ParameterizedMessage("failed to load pipeline [{}]", pipelineId), ex);
+                logger.warn(new ParameterizedMessage("failed to load pipeline [{}]", pipelineId), ex);
             }
         }
         return allReferencedModelKeys;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetDataFrameAnalyticsStatsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetDataFrameAnalyticsStatsAction.java
index 11bdeb33c8bf8..aadd6041ae642 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetDataFrameAnalyticsStatsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetDataFrameAnalyticsStatsAction.java
@@ -65,7 +65,7 @@ public class TransportGetDataFrameAnalyticsStatsAction
     extends TransportTasksAction<DataFrameAnalyticsTask, GetDataFrameAnalyticsStatsAction.Request,
         GetDataFrameAnalyticsStatsAction.Response, QueryPage<Stats>> {
 
-    private static final Logger LOGGER = LogManager.getLogger(TransportGetDataFrameAnalyticsStatsAction.class);
+    private static final Logger logger = LogManager.getLogger(TransportGetDataFrameAnalyticsStatsAction.class);
 
     private final Client client;
 
@@ -95,7 +95,7 @@ protected GetDataFrameAnalyticsStatsAction.Response newResponse(GetDataFrameAnal
     @Override
     protected void taskOperation(GetDataFrameAnalyticsStatsAction.Request request, DataFrameAnalyticsTask task,
                                  ActionListener<QueryPage<Stats>> listener) {
-        LOGGER.debug("Get stats for running task [{}]", task.getParams().getId());
+        logger.debug("Get stats for running task [{}]", task.getParams().getId());
 
         ActionListener<List<PhaseProgress>> progressListener = ActionListener.wrap(
             progress -> {
@@ -118,7 +118,7 @@ protected void taskOperation(GetDataFrameAnalyticsStatsAction.Request request, D
     @Override
     protected void doExecute(Task task, GetDataFrameAnalyticsStatsAction.Request request,
                              ActionListener<GetDataFrameAnalyticsStatsAction.Response> listener) {
-        LOGGER.debug("Get stats for data frame analytics [{}]", request.getId());
+        logger.debug("Get stats for data frame analytics [{}]", request.getId());
 
         ActionListener<GetDataFrameAnalyticsAction.Response> getResponseListener = ActionListener.wrap(
             getResponse -> {
@@ -221,7 +221,7 @@ private StoredProgress parseStoredProgress(SearchHit hit) {
             StoredProgress storedProgress = StoredProgress.PARSER.apply(parser, null);
             return storedProgress;
         } catch (IOException e) {
-            LOGGER.error(new ParameterizedMessage("failed to parse progress from doc with it [{}]", hit.getId()), e);
+            logger.error(new ParameterizedMessage("failed to parse progress from doc with it [{}]", hit.getId()), e);
             return new StoredProgress(Collections.emptyList());
         }
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetJobsStatsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetJobsStatsAction.java
index 2ad70e996b51f..d11abcba7e51d 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetJobsStatsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetJobsStatsAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.FailedNodeException;
 import org.elasticsearch.action.TaskOperationFailure;
@@ -50,6 +52,8 @@
 public class TransportGetJobsStatsAction extends TransportTasksAction<TransportOpenJobAction.JobTask, GetJobsStatsAction.Request,
         GetJobsStatsAction.Response, QueryPage<JobStats>> {
 
+    private static final Logger logger = LogManager.getLogger(TransportGetJobsStatsAction.class);
+
     private final ClusterService clusterService;
     private final AutodetectProcessManager processManager;
     private final JobResultsProvider jobResultsProvider;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetModelSnapshotsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetModelSnapshotsAction.java
index 007bdf3c37459..43a42501bd0b7 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetModelSnapshotsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetModelSnapshotsAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.HandledTransportAction;
@@ -22,6 +24,8 @@
 public class TransportGetModelSnapshotsAction extends HandledTransportAction<GetModelSnapshotsAction.Request,
         GetModelSnapshotsAction.Response> {
 
+    private static final Logger logger = LogManager.getLogger(TransportGetModelSnapshotsAction.class);
+
     private final JobResultsProvider jobResultsProvider;
     private final JobManager jobManager;
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetOverallBucketsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetOverallBucketsAction.java
index 8ac9390f8065a..f6c972bfff353 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetOverallBucketsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetOverallBucketsAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
@@ -54,6 +56,8 @@
 public class TransportGetOverallBucketsAction extends HandledTransportAction<GetOverallBucketsAction.Request,
         GetOverallBucketsAction.Response> {
 
+    private static final Logger logger = LogManager.getLogger(TransportGetOverallBucketsAction.class);
+
     private static final String EARLIEST_TIME = "earliest_time";
     private static final String LATEST_TIME = "latest_time";
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportKillProcessAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportKillProcessAction.java
index 33cd31256fe64..90719764e94d6 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportKillProcessAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportKillProcessAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.cluster.node.DiscoveryNode;
@@ -24,6 +26,8 @@
 
 public class TransportKillProcessAction extends TransportJobTaskAction<KillProcessAction.Request, KillProcessAction.Response> {
 
+    private static final Logger logger = LogManager.getLogger(TransportKillProcessAction.class);
+
     private final AnomalyDetectionAuditor auditor;
 
     @Inject
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportMlInfoAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportMlInfoAction.java
index 0cef48b9ce456..16d83a4b4f9ee 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportMlInfoAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportMlInfoAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.HandledTransportAction;
@@ -32,6 +34,8 @@
 
 public class TransportMlInfoAction extends HandledTransportAction<MlInfoAction.Request, MlInfoAction.Response> {
 
+    private static final Logger logger = LogManager.getLogger(TransportMlInfoAction.class);
+
     private final ClusterService clusterService;
     private final NamedXContentRegistry xContentRegistry;
     private final Map<String, Object> nativeCodeInfo;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
index 65ed0b93aa7b9..b760f6f02399b 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
@@ -93,7 +93,7 @@
 public class TransportStartDataFrameAnalyticsAction
     extends TransportMasterNodeAction<StartDataFrameAnalyticsAction.Request, AcknowledgedResponse> {
 
-    private static final Logger LOGGER = LogManager.getLogger(TransportStartDataFrameAnalyticsAction.class);
+    private static final Logger logger = LogManager.getLogger(TransportStartDataFrameAnalyticsAction.class);
 
     private final XPackLicenseState licenseState;
     private final Client client;
@@ -254,7 +254,7 @@ private void getStartContext(String id, ActionListener<StartContext> finalListen
                         toValidateMappingsListener.onResponse(startContext);
                         break;
                     case FINISHED:
-                        LOGGER.info("[{}] Job has already finished", startContext.config.getId());
+                        logger.info("[{}] Job has already finished", startContext.config.getId());
                         finalListener.onFailure(ExceptionsHelper.badRequestException(
                             "Cannot start because the job has already finished"));
                         break;
@@ -478,7 +478,7 @@ public void onResponse(PersistentTasksCustomMetaData.PersistentTask<?> task) {
 
                 @Override
                 public void onFailure(Exception e) {
-                    LOGGER.error("[" + persistentTask.getParams().getId() + "] Failed to cancel persistent task that could " +
+                    logger.error("[" + persistentTask.getParams().getId() + "] Failed to cancel persistent task that could " +
                         "not be assigned due to [" + exception.getMessage() + "]", e);
                     listener.onFailure(exception);
                 }
@@ -554,7 +554,7 @@ public PersistentTasksCustomMetaData.Assignment getAssignment(StartDataFrameAnal
             if (unavailableIndices.size() != 0) {
                 String reason = "Not opening data frame analytics job [" + id +
                     "], because not all primary shards are active for the following indices [" + String.join(",", unavailableIndices) + "]";
-                LOGGER.debug(reason);
+                logger.debug(reason);
                 return new PersistentTasksCustomMetaData.Assignment(null, reason);
             }
 
@@ -564,7 +564,7 @@ public PersistentTasksCustomMetaData.Assignment getAssignment(StartDataFrameAnal
                 if (scheduledRefresh) {
                     String reason = "Not opening data frame analytics job [" + id +
                         "] because job memory requirements are stale - refresh requested";
-                    LOGGER.debug(reason);
+                    logger.debug(reason);
                     return new PersistentTasksCustomMetaData.Assignment(null, reason);
                 }
             }
@@ -580,7 +580,7 @@ public PersistentTasksCustomMetaData.Assignment getAssignment(StartDataFrameAnal
         @Override
         protected void nodeOperation(AllocatedPersistentTask task, StartDataFrameAnalyticsAction.TaskParams params,
                                      PersistentTaskState state) {
-            LOGGER.info("[{}] Starting data frame analytics", params.getId());
+            logger.info("[{}] Starting data frame analytics", params.getId());
             DataFrameAnalyticsTaskState analyticsTaskState = (DataFrameAnalyticsTaskState) state;
 
             // If we are "stopping" there is nothing to do
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDatafeedAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDatafeedAction.java
index ba197ea0e546d..d90f175e46b1f 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDatafeedAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDatafeedAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
@@ -45,6 +47,8 @@
 public class TransportStopDatafeedAction extends TransportTasksAction<TransportStartDatafeedAction.DatafeedTask, StopDatafeedAction.Request,
         StopDatafeedAction.Response, StopDatafeedAction.Response> {
 
+    private static final Logger logger = LogManager.getLogger(TransportStopDatafeedAction.class);
+
     private final ThreadPool threadPool;
     private final PersistentTasksService persistentTasksService;
     private final DatafeedConfigProvider datafeedConfigProvider;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportUpdateModelSnapshotAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportUpdateModelSnapshotAction.java
index 986b5426cef9d..186fba1e003c9 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportUpdateModelSnapshotAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportUpdateModelSnapshotAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.action;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.bulk.BulkAction;
@@ -36,6 +38,8 @@
 public class TransportUpdateModelSnapshotAction extends HandledTransportAction<UpdateModelSnapshotAction.Request,
         UpdateModelSnapshotAction.Response> {
 
+    private static final Logger logger = LogManager.getLogger(TransportUpdateModelSnapshotAction.class);
+
     private final JobResultsProvider jobResultsProvider;
     private final Client client;
 

From 13bfbf32b0e8aa9e5499a201dbbacdbaa9f38e8d Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Mon, 16 Dec 2019 14:55:01 +0000
Subject: [PATCH 216/686] [ML] Wait for green after opening job in
 NetworkDisruptionIT (#50232)

Closes #49908
---
 .../elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java
index 379daba7c45ea..325e34fbf46a7 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/NetworkDisruptionIT.java
@@ -48,11 +48,11 @@ public void testJobRelocation() throws Exception {
         Job.Builder job = createJob("relocation-job", new ByteSizeValue(2, ByteSizeUnit.MB));
         PutJobAction.Request putJobRequest = new PutJobAction.Request(job);
         client().execute(PutJobAction.INSTANCE, putJobRequest).actionGet();
-        ensureGreen();
 
         OpenJobAction.Request openJobRequest = new OpenJobAction.Request(job.getId());
         AcknowledgedResponse openJobResponse = client().execute(OpenJobAction.INSTANCE, openJobRequest).actionGet();
         assertTrue(openJobResponse.isAcknowledged());
+        ensureGreen();
 
         // Record which node the job starts off on
         String origJobNode = awaitJobOpenedAndAssigned(job.getId(), null);

From 159dbec488675edb4f60558e5d4631c1c3b1923b Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Mon, 16 Dec 2019 11:08:00 -0500
Subject: [PATCH 217/686] Account trimAboveSeqNo in committed translog
 generation (#50205)

Today we do not consider trimAboveSeqNo when calculating the translog
generation of an index commit. If there is no new indexing after the
primary promotion, then we won't be able to clean up the translog.
---
 .../org/elasticsearch/index/translog/Checkpoint.java  | 11 +++++++++++
 .../org/elasticsearch/index/translog/Translog.java    |  8 ++------
 .../replication/RecoveryDuringReplicationTests.java   |  5 +++++
 3 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/translog/Checkpoint.java b/server/src/main/java/org/elasticsearch/index/translog/Checkpoint.java
index fe20a52f482f3..1e16b9c3a60ae 100644
--- a/server/src/main/java/org/elasticsearch/index/translog/Checkpoint.java
+++ b/server/src/main/java/org/elasticsearch/index/translog/Checkpoint.java
@@ -106,6 +106,17 @@ private void write(DataOutput out) throws IOException {
         out.writeLong(trimmedAboveSeqNo);
     }
 
+    /**
+     * Returns the maximum sequence number of operations in this checkpoint after applying {@link #trimmedAboveSeqNo}.
+     */
+    long maxEffectiveSeqNo() {
+        if (trimmedAboveSeqNo == SequenceNumbers.UNASSIGNED_SEQ_NO) {
+            return maxSeqNo;
+        } else {
+            return Math.min(trimmedAboveSeqNo, maxSeqNo);
+        }
+    }
+
     static Checkpoint emptyTranslogCheckpoint(final long offset, final long generation, final long globalCheckpoint,
                                               long minTranslogGeneration) {
         final long minSeqNo = SequenceNumbers.NO_OPS_PERFORMED;
diff --git a/server/src/main/java/org/elasticsearch/index/translog/Translog.java b/server/src/main/java/org/elasticsearch/index/translog/Translog.java
index e38880797785b..055b9b82fc917 100644
--- a/server/src/main/java/org/elasticsearch/index/translog/Translog.java
+++ b/server/src/main/java/org/elasticsearch/index/translog/Translog.java
@@ -696,11 +696,7 @@ private Stream<? extends BaseTranslogReader> readersAboveMinSeqNo(long minSeqNo)
         assert readLock.isHeldByCurrentThread() || writeLock.isHeldByCurrentThread() :
             "callers of readersAboveMinSeqNo must hold a lock: readLock ["
                 + readLock.isHeldByCurrentThread() + "], writeLock [" + readLock.isHeldByCurrentThread() + "]";
-        return Stream.concat(readers.stream(), Stream.of(current))
-            .filter(reader -> {
-                final long maxSeqNo = reader.getCheckpoint().maxSeqNo;
-                return maxSeqNo == SequenceNumbers.UNASSIGNED_SEQ_NO || maxSeqNo >= minSeqNo;
-            });
+        return Stream.concat(readers.stream(), Stream.of(current)).filter(reader -> minSeqNo <= reader.getCheckpoint().maxEffectiveSeqNo());
     }
 
     /**
@@ -1629,7 +1625,7 @@ public TranslogGeneration getMinGenerationForSeqNo(final long seqNo) {
              */
             long minTranslogFileGeneration = this.currentFileGeneration();
             for (final TranslogReader reader : readers) {
-                if (seqNo <= reader.getCheckpoint().maxSeqNo) {
+                if (seqNo <= reader.getCheckpoint().maxEffectiveSeqNo()) {
                     minTranslogFileGeneration = Math.min(minTranslogFileGeneration, reader.getGeneration());
                 }
             }
diff --git a/server/src/test/java/org/elasticsearch/index/replication/RecoveryDuringReplicationTests.java b/server/src/test/java/org/elasticsearch/index/replication/RecoveryDuringReplicationTests.java
index f6756274642e7..53a96e531585a 100644
--- a/server/src/test/java/org/elasticsearch/index/replication/RecoveryDuringReplicationTests.java
+++ b/server/src/test/java/org/elasticsearch/index/replication/RecoveryDuringReplicationTests.java
@@ -800,6 +800,11 @@ public void testRollbackOnPromotion() throws Exception {
             shards.assertAllEqual(initDocs + inFlightOpsOnNewPrimary + moreDocsAfterRollback);
             done.set(true);
             thread.join();
+
+            for (IndexShard shard : shards) {
+                shard.flush(new FlushRequest().force(true).waitIfOngoing(true));
+                assertThat(shard.translogStats().getUncommittedOperations(), equalTo(0));
+            }
         }
     }
 

From fef3c272ac44c773b21458df74b53fa9b5a0733a Mon Sep 17 00:00:00 2001
From: Zachary Tong <polyfractal@elastic.co>
Date: Mon, 16 Dec 2019 11:14:45 -0500
Subject: [PATCH 218/686] Migrate MinAggregator integration tests to
 AggregatorTestCase (#50053)

Also renames MinTests to MinAggregationBuilderTests
---
 ...s.java => MinAggregationBuilderTests.java} |   2 +-
 .../metrics/MinAggregatorTests.java           | 726 +++++++++++++++---
 .../search/aggregations/metrics/MinIT.java    | 455 -----------
 3 files changed, 606 insertions(+), 577 deletions(-)
 rename server/src/test/java/org/elasticsearch/search/aggregations/metrics/{MinTests.java => MinAggregationBuilderTests.java} (90%)
 delete mode 100644 server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinIT.java

diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregationBuilderTests.java
similarity index 90%
rename from server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinTests.java
rename to server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregationBuilderTests.java
index 549e9916274ae..334921f230296 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregationBuilderTests.java
@@ -19,7 +19,7 @@
 
 package org.elasticsearch.search.aggregations.metrics;
 
-public class MinTests extends AbstractNumericMetricTestCase<MinAggregationBuilder> {
+public class MinAggregationBuilderTests extends AbstractNumericMetricTestCase<MinAggregationBuilder> {
 
     @Override
     protected MinAggregationBuilder doCreateTestAggregatorFactory() {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregatorTests.java
index cfe3c86034f85..922536a76544a 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregatorTests.java
@@ -27,6 +27,7 @@
 import org.apache.lucene.document.LongPoint;
 import org.apache.lucene.document.NumericDocValuesField;
 import org.apache.lucene.document.SortedNumericDocValuesField;
+import org.apache.lucene.document.SortedSetDocValuesField;
 import org.apache.lucene.document.StringField;
 import org.apache.lucene.index.DirectoryReader;
 import org.apache.lucene.index.IndexOptions;
@@ -34,6 +35,7 @@
 import org.apache.lucene.index.IndexWriter;
 import org.apache.lucene.index.IndexWriterConfig;
 import org.apache.lucene.index.LeafReaderContext;
+import org.apache.lucene.index.MultiReader;
 import org.apache.lucene.index.NoMergePolicy;
 import org.apache.lucene.index.RandomIndexWriter;
 import org.apache.lucene.index.Term;
@@ -43,18 +45,46 @@
 import org.apache.lucene.search.Query;
 import org.apache.lucene.search.TermQuery;
 import org.apache.lucene.store.Directory;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.CheckedConsumer;
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.mapper.DateFieldMapper;
+import org.elasticsearch.index.mapper.KeywordFieldMapper;
 import org.elasticsearch.index.mapper.MappedFieldType;
+import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.index.mapper.NumberFieldMapper;
+import org.elasticsearch.index.query.QueryShardContext;
+import org.elasticsearch.indices.breaker.CircuitBreakerService;
+import org.elasticsearch.script.MockScriptEngine;
+import org.elasticsearch.script.Script;
+import org.elasticsearch.script.ScriptEngine;
+import org.elasticsearch.script.ScriptModule;
+import org.elasticsearch.script.ScriptService;
+import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.Aggregator;
 import org.elasticsearch.search.aggregations.AggregatorTestCase;
+import org.elasticsearch.search.aggregations.BucketOrder;
+import org.elasticsearch.search.aggregations.InternalAggregation;
+import org.elasticsearch.search.aggregations.bucket.filter.Filter;
+import org.elasticsearch.search.aggregations.bucket.filter.FilterAggregationBuilder;
+import org.elasticsearch.search.aggregations.bucket.global.GlobalAggregationBuilder;
+import org.elasticsearch.search.aggregations.bucket.global.InternalGlobal;
+import org.elasticsearch.search.aggregations.bucket.histogram.HistogramAggregationBuilder;
+import org.elasticsearch.search.aggregations.bucket.histogram.InternalHistogram;
+import org.elasticsearch.search.aggregations.bucket.terms.InternalTerms;
+import org.elasticsearch.search.aggregations.bucket.terms.LongTerms;
+import org.elasticsearch.search.aggregations.bucket.terms.Terms;
+import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregationBuilder;
 import org.elasticsearch.search.aggregations.support.AggregationInspectionHelper;
 import org.elasticsearch.search.aggregations.support.FieldContext;
+import org.elasticsearch.search.aggregations.support.ValueType;
 import org.elasticsearch.search.aggregations.support.ValuesSource;
 import org.elasticsearch.search.aggregations.support.ValuesSourceConfig;
 import org.elasticsearch.search.internal.SearchContext;
+import org.elasticsearch.search.lookup.LeafDocLookup;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -62,164 +92,589 @@
 import java.util.Collection;
 import java.util.Collections;
 import java.util.Comparator;
+import java.util.HashMap;
 import java.util.List;
+import java.util.Map;
+import java.util.function.BiFunction;
+import java.util.function.Consumer;
 import java.util.function.DoubleConsumer;
 import java.util.function.Function;
 import java.util.function.Supplier;
 
+import static java.util.Collections.singleton;
+import static org.elasticsearch.index.query.QueryBuilders.termQuery;
 import static org.hamcrest.Matchers.equalTo;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
 public class MinAggregatorTests extends AggregatorTestCase {
 
-    public void testMinAggregator_numericDv() throws Exception {
-        Directory directory = newDirectory();
-        RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
-        Document document = new Document();
-        document.add(new NumericDocValuesField("number", 9));
-        document.add(new LongPoint("number", 9));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new NumericDocValuesField("number", 7));
-        document.add(new LongPoint("number", 7));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new NumericDocValuesField("number", 5));
-        document.add(new LongPoint("number", 5));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new NumericDocValuesField("number", 3));
-        document.add(new LongPoint("number", 3));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new NumericDocValuesField("number", 1));
-        document.add(new LongPoint("number", 1));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new NumericDocValuesField("number", -1));
-        document.add(new LongPoint("number", -1));
-        indexWriter.addDocument(document);
-        indexWriter.close();
+    private final String SCRIPT_NAME = "script_name";
+    private QueryShardContext queryShardContext;
+    private final long SCRIPT_VALUE = 19L;
+
+    /** Script to take a field name in params and sum the values of the field. */
+    private static final String SUM_FIELD_PARAMS_SCRIPT = "sum_field_params";
+
+    /** Script to sum the values of a field named {@code values}. */
+    private static final String SUM_VALUES_FIELD_SCRIPT = "sum_values_field";
+
+    /** Script to return the value of a field named {@code value}. */
+    private static final String VALUE_FIELD_SCRIPT = "value_field";
+
+    /** Script to return the {@code _value} provided by aggs framework. */
+    private static final String VALUE_SCRIPT = "_value";
+
+    private static final String INVERT_SCRIPT = "invert";
+
+    @Override
+    protected ScriptService getMockScriptService() {
+        Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+        Function<Map<String, Object>, Integer> getInc = vars -> {
+            if (vars == null || vars.containsKey("inc") == false) {
+                return 0;
+            } else {
+                return ((Number) vars.get("inc")).intValue();
+            }
+        };
+
+        BiFunction<Map<String, Object>, String, Object> sum = (vars, fieldname) -> {
+            int inc = getInc.apply(vars);
+            LeafDocLookup docLookup = (LeafDocLookup) vars.get("doc");
+            List<Long> values = new ArrayList<>();
+            for (Object v : docLookup.get(fieldname)) {
+                values.add(((Number) v).longValue() + inc);
+            }
+            return values;
+        };
+
+        scripts.put(SCRIPT_NAME, script -> SCRIPT_VALUE);
+        scripts.put(SUM_FIELD_PARAMS_SCRIPT, vars -> {
+            String fieldname = (String) vars.get("field");
+            return sum.apply(vars, fieldname);
+        });
+        scripts.put(SUM_VALUES_FIELD_SCRIPT, vars -> sum.apply(vars, "values"));
+        scripts.put(VALUE_FIELD_SCRIPT, vars -> sum.apply(vars, "value"));
+        scripts.put(VALUE_SCRIPT, vars -> {
+            int inc = getInc.apply(vars);
+            return ((Number) vars.get("_value")).doubleValue() + inc;
+        });
+        scripts.put(INVERT_SCRIPT, vars -> -((Number) vars.get("_value")).doubleValue());
+
+        MockScriptEngine scriptEngine = new MockScriptEngine(MockScriptEngine.NAME,
+            scripts,
+            Collections.emptyMap());
+        Map<String, ScriptEngine> engines = Collections.singletonMap(scriptEngine.getType(), scriptEngine);
+
+        return new ScriptService(Settings.EMPTY, engines, ScriptModule.CORE_CONTEXTS);
+    }
+
+    @Override
+    protected QueryShardContext queryShardContextMock(IndexSearcher searcher, MapperService mapperService,
+                                                      IndexSettings indexSettings, CircuitBreakerService circuitBreakerService) {
+         this.queryShardContext = super.queryShardContextMock(searcher, mapperService, indexSettings, circuitBreakerService);
+         return queryShardContext;
+    }
+
+    public void testNoMatchingField() throws IOException {
+        testCase(new MatchAllDocsQuery(), iw -> {
+            iw.addDocument(singleton(new SortedNumericDocValuesField("wrong_number", 7)));
+            iw.addDocument(singleton(new SortedNumericDocValuesField("wrong_number", 3)));
+        }, min -> {
+            assertEquals(Double.POSITIVE_INFINITY, min.getValue(), 0);
+            assertFalse(AggregationInspectionHelper.hasValue(min));
+        });
+    }
+
+    public void testMatchesSortedNumericDocValues() throws IOException {
+        testCase(new MatchAllDocsQuery(), iw -> {
+            iw.addDocument(singleton(new SortedNumericDocValuesField("number", 7)));
+            iw.addDocument(singleton(new SortedNumericDocValuesField("number", 2)));
+            iw.addDocument(singleton(new SortedNumericDocValuesField("number", 3)));
+        }, min -> {
+            assertEquals(2, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        });
+    }
+
+    public void testMatchesNumericDocValues() throws IOException {
+        testCase(new MatchAllDocsQuery(), iw -> {
+            iw.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            iw.addDocument(singleton(new NumericDocValuesField("number", 2)));
+            iw.addDocument(singleton(new NumericDocValuesField("number", 3)));
+        }, min -> {
+            assertEquals(2, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        });
+    }
+
+    public void testSomeMatchesSortedNumericDocValues() throws IOException {
+        testCase(new DocValuesFieldExistsQuery("number"), iw -> {
+            iw.addDocument(singleton(new SortedNumericDocValuesField("number", 7)));
+            iw.addDocument(singleton(new SortedNumericDocValuesField("number2", 2)));
+            iw.addDocument(singleton(new SortedNumericDocValuesField("number", 3)));
+        }, min -> {
+            assertEquals(3, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        });
+    }
+
+    public void testSomeMatchesNumericDocValues() throws IOException {
+        testCase(new DocValuesFieldExistsQuery("number"), iw -> {
+            iw.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            iw.addDocument(singleton(new NumericDocValuesField("number2", 2)));
+            iw.addDocument(singleton(new NumericDocValuesField("number", 3)));
+        }, min -> {
+            assertEquals(3, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        });
+    }
+
+    public void testQueryFiltering() throws IOException {
+        testCase(IntPoint.newRangeQuery("number", 0, 3), iw -> {
+            iw.addDocument(Arrays.asList(new IntPoint("number", 7), new SortedNumericDocValuesField("number", 7)));
+            iw.addDocument(Arrays.asList(new IntPoint("number", 1), new SortedNumericDocValuesField("number", 1)));
+            iw.addDocument(Arrays.asList(new IntPoint("number", 3), new SortedNumericDocValuesField("number", 3)));
+        }, min -> {
+            assertEquals(1, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        });
+    }
 
-        IndexReader indexReader = DirectoryReader.open(directory);
-        IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
+    public void testQueryFiltersAll() throws IOException {
+        testCase(IntPoint.newRangeQuery("number", -1, 0), iw -> {
+            iw.addDocument(Arrays.asList(new IntPoint("number", 7), new SortedNumericDocValuesField("number", 7)));
+            iw.addDocument(Arrays.asList(new IntPoint("number", 1), new SortedNumericDocValuesField("number", 1)));
+            iw.addDocument(Arrays.asList(new IntPoint("number", 3), new SortedNumericDocValuesField("number", 3)));
+        }, min -> {
+            assertEquals(Double.POSITIVE_INFINITY, min.getValue(), 0);
+            assertFalse(AggregationInspectionHelper.hasValue(min));
+        });
+    }
+
+    public void testUnmappedWithMissingField() throws IOException {
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("does_not_exist").missing(0L);
 
-        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("_name").field("number");
-        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.LONG);
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
         fieldType.setName("number");
 
-        testMinCase(indexSearcher, aggregationBuilder, fieldType, min -> assertEquals(-1.0d, min, 0));
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            iw.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            iw.addDocument(singleton(new NumericDocValuesField("number", 1)));
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(0.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        }, fieldType);
+    }
 
-        MinAggregator aggregator = createAggregator(aggregationBuilder, indexSearcher, fieldType);
-        aggregator.preCollection();
-        indexSearcher.search(new MatchAllDocsQuery(), aggregator);
-        aggregator.postCollection();
-        InternalMin result = (InternalMin) aggregator.buildAggregation(0L);
-        assertEquals(-1.0, result.getValue(), 0);
-        assertTrue(AggregationInspectionHelper.hasValue(result));
+    public void testUnsupportedType() {
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("not_a_number");
 
-        indexReader.close();
-        directory.close();
+        MappedFieldType fieldType = new KeywordFieldMapper.KeywordFieldType();
+        fieldType.setName("not_a_number");
+        fieldType.setHasDocValues(true);
+
+        IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
+            () -> testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+                iw.addDocument(singleton(new SortedSetDocValuesField("string", new BytesRef("foo"))));
+            }, (Consumer<InternalMin>) min -> {
+                fail("Should have thrown exception");
+            }, fieldType));
+        assertEquals(e.getMessage(), "Expected numeric type on field [not_a_number], but got [keyword]");
     }
 
-    public void testMinAggregator_sortedNumericDv() throws Exception {
-        Directory directory = newDirectory();
-        RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
-        Document document = new Document();
-        document.add(new SortedNumericDocValuesField("number", 9));
-        document.add(new SortedNumericDocValuesField("number", 7));
-        document.add(new LongPoint("number", 9));
-        document.add(new LongPoint("number", 7));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new SortedNumericDocValuesField("number", 5));
-        document.add(new SortedNumericDocValuesField("number", 3));
-        document.add(new LongPoint("number", 5));
-        document.add(new LongPoint("number", 3));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new SortedNumericDocValuesField("number", 1));
-        document.add(new SortedNumericDocValuesField("number", -1));
-        document.add(new LongPoint("number", 1));
-        document.add(new LongPoint("number", -1));
-        indexWriter.addDocument(document);
-        indexWriter.close();
+    public void testBadMissingField() {
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("number").missing("not_a_number");
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        expectThrows(NumberFormatException.class,
+            () -> testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+                iw.addDocument(singleton(new NumericDocValuesField("number", 7)));
+                iw.addDocument(singleton(new NumericDocValuesField("number", 1)));
+            }, (Consumer<InternalMin>) min -> {
+                fail("Should have thrown exception");
+            }, fieldType));
+    }
 
-        IndexReader indexReader = DirectoryReader.open(directory);
-        IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
+    public void testUnmappedWithBadMissingField() {
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("does_not_exist").missing("not_a_number");
 
-        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("_name").field("number");
-        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.LONG);
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
         fieldType.setName("number");
 
-        MinAggregator aggregator = createAggregator(aggregationBuilder, indexSearcher, fieldType);
-        aggregator.preCollection();
-        indexSearcher.search(new MatchAllDocsQuery(), aggregator);
-        aggregator.postCollection();
-        InternalMin result = (InternalMin) aggregator.buildAggregation(0L);
-        assertEquals(-1.0, result.getValue(), 0);
-        assertTrue(AggregationInspectionHelper.hasValue(result));
+        expectThrows(NumberFormatException.class,
+            () -> testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+                iw.addDocument(singleton(new NumericDocValuesField("number", 7)));
+                iw.addDocument(singleton(new NumericDocValuesField("number", 1)));
+            }, (Consumer<InternalMin>) min -> {
+                fail("Should have thrown exception");
+            }, fieldType));
+    }
 
-        indexReader.close();
-        directory.close();
+    public void testEmptyBucket() throws IOException {
+        HistogramAggregationBuilder histogram = new HistogramAggregationBuilder("histo").field("number").interval(1).minDocCount(0)
+            .subAggregation(new MinAggregationBuilder("min").field("number"));
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        testCase(histogram, new MatchAllDocsQuery(), iw -> {
+            iw.addDocument(singleton(new NumericDocValuesField("number", 1)));
+            iw.addDocument(singleton(new NumericDocValuesField("number", 3)));
+        }, (Consumer<InternalHistogram>) histo -> {
+            assertThat(histo.getBuckets().size(), equalTo(3));
+
+            assertNotNull(histo.getBuckets().get(0).getAggregations().asMap().get("min"));
+            InternalMin min = (InternalMin) histo.getBuckets().get(0).getAggregations().asMap().get("min");
+            assertEquals(1.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+
+            assertNotNull(histo.getBuckets().get(1).getAggregations().asMap().get("min"));
+            min = (InternalMin) histo.getBuckets().get(1).getAggregations().asMap().get("min");
+            assertEquals(Double.POSITIVE_INFINITY, min.getValue(), 0);
+            assertFalse(AggregationInspectionHelper.hasValue(min));
+
+            assertNotNull(histo.getBuckets().get(2).getAggregations().asMap().get("min"));
+            min = (InternalMin) histo.getBuckets().get(2).getAggregations().asMap().get("min");
+            assertEquals(3.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+
+
+        }, fieldType);
     }
 
-    public void testMinAggregator_noValue() throws Exception {
-        Directory directory = newDirectory();
-        RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
-        Document document = new Document();
-        document.add(new SortedNumericDocValuesField("number1", 7));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new SortedNumericDocValuesField("number1", 3));
-        indexWriter.addDocument(document);
-        document = new Document();
-        document.add(new SortedNumericDocValuesField("number1", 1));
-        indexWriter.addDocument(document);
-        indexWriter.close();
+    public void testFormatter() throws IOException {
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("number").format("0000.0");
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
 
-        IndexReader indexReader = DirectoryReader.open(directory);
-        IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            iw.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            iw.addDocument(singleton(new NumericDocValuesField("number", 1)));
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(1.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+            assertEquals("0001.0", min.getValueAsString());
+        }, fieldType);
+    }
 
-        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("_name").field("number2");
-        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.LONG);
-        fieldType.setName("number2");
+    public void testGetProperty() throws IOException {
+        GlobalAggregationBuilder globalBuilder = new GlobalAggregationBuilder("global")
+            .subAggregation(new MinAggregationBuilder("min").field("number"));
 
-        MinAggregator aggregator = createAggregator(aggregationBuilder, indexSearcher, fieldType);
-        aggregator.preCollection();
-        indexSearcher.search(new MatchAllDocsQuery(), aggregator);
-        aggregator.postCollection();
-        InternalMin result = (InternalMin) aggregator.buildAggregation(0L);
-        assertEquals(Double.POSITIVE_INFINITY, result.getValue(), 0);
-        assertFalse(AggregationInspectionHelper.hasValue(result));
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
 
-        indexReader.close();
-        directory.close();
+        testCase(globalBuilder, new MatchAllDocsQuery(), iw -> {
+            iw.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            iw.addDocument(singleton(new NumericDocValuesField("number", 1)));
+        }, (Consumer<InternalGlobal>) global -> {
+            assertEquals(1.0, global.getDocCount(), 2);
+            assertTrue(AggregationInspectionHelper.hasValue(global));
+            assertNotNull(global.getAggregations().asMap().get("min"));
+
+            InternalMin min = (InternalMin) global.getAggregations().asMap().get("min");
+            assertEquals(1.0, min.getValue(), 0);
+            assertThat(global.getProperty("min"), equalTo(min));
+            assertThat(global.getProperty("min.value"), equalTo(1.0));
+            assertThat(min.getProperty("value"), equalTo(1.0));
+        }, fieldType);
     }
 
-    public void testMinAggregator_noDocs() throws Exception {
-        Directory directory = newDirectory();
-        RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
-        indexWriter.close();
+    public void testSingleValuedFieldPartiallyUnmapped() throws IOException {
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("number");
+
+        try (Directory directory = newDirectory();
+             Directory unmappedDirectory = newDirectory()) {
+            RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 2)));
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 3)));
+            indexWriter.close();
+
+
+            RandomIndexWriter unmappedIndexWriter = new RandomIndexWriter(random(), unmappedDirectory);
+            unmappedIndexWriter.close();
 
-        IndexReader indexReader = DirectoryReader.open(directory);
-        IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
+            try (IndexReader indexReader = DirectoryReader.open(directory);
+                 IndexReader unamappedIndexReader = DirectoryReader.open(unmappedDirectory)) {
 
-        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("_name").field("number");
-        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.LONG);
+                MultiReader multiReader = new MultiReader(indexReader, unamappedIndexReader);
+                IndexSearcher indexSearcher = newSearcher(multiReader, true, true);
+
+                InternalMin min = searchAndReduce(indexSearcher, new MatchAllDocsQuery(), aggregationBuilder, fieldType);
+                assertEquals(2.0, min.getValue(), 0);
+                assertTrue(AggregationInspectionHelper.hasValue(min));
+            }
+        }
+    }
+
+    public void testSingleValuedFieldPartiallyUnmappedWithMissing() throws IOException {
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
         fieldType.setName("number");
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("number").missing(-19L);
 
-        MinAggregator aggregator = createAggregator(aggregationBuilder, indexSearcher, fieldType);
-        aggregator.preCollection();
-        indexSearcher.search(new MatchAllDocsQuery(), aggregator);
-        aggregator.postCollection();
-        InternalMin result = (InternalMin) aggregator.buildAggregation(0L);
-        assertEquals(Double.POSITIVE_INFINITY, result.getValue(), 0);
-        assertFalse(AggregationInspectionHelper.hasValue(result));
+        try (Directory directory = newDirectory();
+             Directory unmappedDirectory = newDirectory()) {
+            RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 2)));
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 3)));
+            indexWriter.close();
 
-        indexReader.close();
-        directory.close();
+
+            RandomIndexWriter unmappedIndexWriter = new RandomIndexWriter(random(), unmappedDirectory);
+            unmappedIndexWriter.addDocument(singleton(new NumericDocValuesField("unrelated", 100)));
+            unmappedIndexWriter.close();
+
+            try (IndexReader indexReader = DirectoryReader.open(directory);
+                 IndexReader unamappedIndexReader = DirectoryReader.open(unmappedDirectory)) {
+
+                MultiReader multiReader = new MultiReader(indexReader, unamappedIndexReader);
+                IndexSearcher indexSearcher = newSearcher(multiReader, true, true);
+
+                InternalMin min = searchAndReduce(indexSearcher, new MatchAllDocsQuery(), aggregationBuilder, fieldType);
+                assertEquals(-19.0, min.getValue(), 0);
+                assertTrue(AggregationInspectionHelper.hasValue(min));
+            }
+        }
+    }
+
+    public void testSingleValuedFieldWithValueScript() throws IOException {
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min")
+            .field("number")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, INVERT_SCRIPT, Collections.emptyMap()));
+
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            final int numDocs = 10;
+            for (int i = 0; i < numDocs; i++) {
+                iw.addDocument(singleton(new NumericDocValuesField("number", i + 1)));
+            }
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(-10.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        }, fieldType);
+    }
+
+    public void testSingleValuedFieldWithValueScriptAndMissing() throws IOException {
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min")
+            .field("number")
+            .missing(-100L)
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, INVERT_SCRIPT, Collections.emptyMap()));
+
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            final int numDocs = 10;
+            for (int i = 0; i < numDocs; i++) {
+                iw.addDocument(singleton(new NumericDocValuesField("number", i + 1)));
+            }
+            iw.addDocument(singleton(new NumericDocValuesField("unrelated", 1)));
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(-100.0, min.getValue(), 0); // Note: this comes straight from missing, and is not inverted from script
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        }, fieldType);
+    }
+
+    public void testSingleValuedFieldWithValueScriptAndParams() throws IOException {
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min")
+            .field("number")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, VALUE_SCRIPT, Collections.singletonMap("inc", 5)));
+
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            final int numDocs = 10;
+            for (int i = 0; i < numDocs; i++) {
+                iw.addDocument(singleton(new NumericDocValuesField("number", i + 1)));
+            }
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(6.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        }, fieldType);
+    }
+
+    public void testScript() throws IOException {
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, SCRIPT_NAME, Collections.emptyMap()));
+
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            final int numDocs = 10;
+            for (int i = 0; i < numDocs; i++) {
+                iw.addDocument(singleton(new NumericDocValuesField("number", i + 1)));
+            }
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(19.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        }, fieldType);
+    }
+
+    public void testMultiValuedField() throws IOException {
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("number");
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            final int numDocs = 10;
+            for (int i = 0; i < numDocs; i++) {
+                Document document = new Document();
+                document.add(new SortedNumericDocValuesField("number", i + 2));
+                document.add(new SortedNumericDocValuesField("number", i + 3));
+                iw.addDocument(document);
+            }
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(2.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        }, fieldType);
+    }
+
+    public void testMultiValuedFieldWithScript() throws IOException {
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min")
+            .field("number")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, INVERT_SCRIPT, Collections.emptyMap()));
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            final int numDocs = 10;
+            for (int i = 0; i < numDocs; i++) {
+                Document document = new Document();
+                document.add(new SortedNumericDocValuesField("number", i + 2));
+                document.add(new SortedNumericDocValuesField("number", i + 3));
+                iw.addDocument(document);
+            }
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(-12.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        }, fieldType);
+    }
+
+    public void testMultiValuedFieldWithScriptParams() throws IOException {
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min")
+            .field("number")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, VALUE_SCRIPT, Collections.singletonMap("inc", 5)));
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        testCase(aggregationBuilder, new MatchAllDocsQuery(), iw -> {
+            final int numDocs = 10;
+            for (int i = 0; i < numDocs; i++) {
+                Document document = new Document();
+                document.add(new SortedNumericDocValuesField("number", i + 2));
+                document.add(new SortedNumericDocValuesField("number", i + 3));
+                iw.addDocument(document);
+            }
+        }, (Consumer<InternalMin>) min -> {
+            assertEquals(7.0, min.getValue(), 0);
+            assertTrue(AggregationInspectionHelper.hasValue(min));
+        }, fieldType);
+    }
+
+    public void testOrderByEmptyAggregation() throws IOException {
+        AggregationBuilder termsBuilder = new TermsAggregationBuilder("terms", ValueType.NUMERIC)
+            .field("number")
+            .order(BucketOrder.compound(BucketOrder.aggregation("filter>min", true)))
+            .subAggregation(new FilterAggregationBuilder("filter", termQuery("number", 100))
+                .subAggregation(new MinAggregationBuilder("min").field("number")));
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+
+        int numDocs = 10;
+        testCase(termsBuilder, new MatchAllDocsQuery(), iw -> {
+            for (int i = 0; i < numDocs; i++) {
+                iw.addDocument(singleton(new NumericDocValuesField("number", i + 1)));
+            }
+        }, (Consumer<InternalTerms<?, LongTerms.Bucket>>) terms -> {
+            for (int i = 0; i < numDocs; i++) {
+                List<LongTerms.Bucket> buckets = terms.getBuckets();
+                Terms.Bucket bucket = buckets.get(i);
+                assertNotNull(bucket);
+                assertEquals((long) i + 1, bucket.getKeyAsNumber());
+                assertEquals(1L, bucket.getDocCount());
+
+                Filter filter = bucket.getAggregations().get("filter");
+                assertNotNull(filter);
+                assertEquals(0L, filter.getDocCount());
+
+                InternalMin min = filter.getAggregations().get("min");
+                assertNotNull(min);
+                assertEquals(Double.POSITIVE_INFINITY, min.getValue(), 0);
+                assertFalse(AggregationInspectionHelper.hasValue(min));
+            }
+        }, fieldType);
+    }
+
+    public void testCaching() throws IOException {
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("number");
+
+        try (Directory directory = newDirectory()) {
+            RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 2)));
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 3)));
+            indexWriter.close();
+
+
+            try (IndexReader indexReader = DirectoryReader.open(directory)) {
+                IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
+
+                InternalMin min = searchAndReduce(indexSearcher, new MatchAllDocsQuery(), aggregationBuilder, fieldType);
+                assertEquals(2.0, min.getValue(), 0);
+                assertTrue(AggregationInspectionHelper.hasValue(min));
+
+                assertTrue(queryShardContext.isCacheable());
+            }
+        }
+    }
+
+    public void testNoCachingWithScript() throws IOException {
+
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min")
+            .field("number")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, INVERT_SCRIPT, Collections.emptyMap()));;
+
+        try (Directory directory = newDirectory()) {
+            RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 7)));
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 2)));
+            indexWriter.addDocument(singleton(new NumericDocValuesField("number", 3)));
+            indexWriter.close();
+
+
+            try (IndexReader indexReader = DirectoryReader.open(directory)) {
+                IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
+
+                InternalMin min = searchAndReduce(indexSearcher, new MatchAllDocsQuery(), aggregationBuilder, fieldType);
+                assertEquals(-7.0, min.getValue(), 0);
+                assertTrue(AggregationInspectionHelper.hasValue(min));
+
+                assertFalse(queryShardContext.isCacheable());
+            }
+        }
     }
 
     public void testShortcutIsApplicable() {
@@ -425,4 +880,33 @@ private ValuesSourceConfig<ValuesSource.Numeric> mockDateValuesSourceConfig(Stri
         when(config.fieldContext()).thenReturn(new FieldContext(fieldName, null, ft));
         return config;
     }
+
+    private void testCase(Query query,
+                          CheckedConsumer<RandomIndexWriter, IOException> buildIndex,
+                          Consumer<InternalMin> verify) throws IOException {
+        MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
+        fieldType.setName("number");
+        MinAggregationBuilder aggregationBuilder = new MinAggregationBuilder("min").field("number");
+        testCase(aggregationBuilder, query, buildIndex, verify, fieldType);
+    }
+
+    private <T extends AggregationBuilder, V extends InternalAggregation> void testCase(T aggregationBuilder, Query query,
+                          CheckedConsumer<RandomIndexWriter, IOException> buildIndex,
+                          Consumer<V> verify, MappedFieldType fieldType) throws IOException {
+        try (Directory directory = newDirectory()) {
+            RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
+            buildIndex.accept(indexWriter);
+            indexWriter.close();
+
+            try (IndexReader indexReader = DirectoryReader.open(directory)) {
+                IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
+
+                V agg = searchAndReduce(indexSearcher, query, aggregationBuilder, fieldType);
+                verify.accept(agg);
+
+            }
+        }
+    }
+
+
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinIT.java
deleted file mode 100644
index 11df5e1cc96c6..0000000000000
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinIT.java
+++ /dev/null
@@ -1,455 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.search.aggregations.metrics;
-
-import org.elasticsearch.action.search.SearchResponse;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.plugins.Plugin;
-import org.elasticsearch.script.Script;
-import org.elasticsearch.script.ScriptType;
-import org.elasticsearch.search.aggregations.AggregationTestScriptsPlugin;
-import org.elasticsearch.search.aggregations.Aggregator;
-import org.elasticsearch.search.aggregations.InternalAggregation;
-import org.elasticsearch.search.aggregations.bucket.filter.Filter;
-import org.elasticsearch.search.aggregations.bucket.global.Global;
-import org.elasticsearch.search.aggregations.bucket.histogram.Histogram;
-import org.elasticsearch.search.aggregations.bucket.terms.Terms;
-import org.elasticsearch.search.aggregations.BucketOrder;
-
-import java.util.Collection;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-import static java.util.Collections.emptyMap;
-import static org.elasticsearch.index.query.QueryBuilders.matchAllQuery;
-import static org.elasticsearch.index.query.QueryBuilders.termQuery;
-import static org.elasticsearch.search.aggregations.AggregationBuilders.count;
-import static org.elasticsearch.search.aggregations.AggregationBuilders.filter;
-import static org.elasticsearch.search.aggregations.AggregationBuilders.global;
-import static org.elasticsearch.search.aggregations.AggregationBuilders.histogram;
-import static org.elasticsearch.search.aggregations.AggregationBuilders.min;
-import static org.elasticsearch.search.aggregations.AggregationBuilders.terms;
-import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
-import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertHitCount;
-import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertSearchResponse;
-import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.notNullValue;
-
-public class MinIT extends AbstractNumericTestCase {
-    @Override
-    protected Collection<Class<? extends Plugin>> nodePlugins() {
-        return Collections.singleton(AggregationTestScriptsPlugin.class);
-    }
-
-    @Override
-    public void testEmptyAggregation() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("empty_bucket_idx")
-                .setQuery(matchAllQuery())
-                .addAggregation(histogram("histo").field("value").interval(1L).minDocCount(0).subAggregation(min("min").field("value")))
-                .get();
-
-        assertThat(searchResponse.getHits().getTotalHits().value, equalTo(2L));
-        Histogram histo = searchResponse.getAggregations().get("histo");
-        assertThat(histo, notNullValue());
-        Histogram.Bucket bucket = histo.getBuckets().get(1);
-        assertThat(bucket, notNullValue());
-
-        Min min = bucket.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(Double.POSITIVE_INFINITY));
-    }
-
-    @Override
-    public void testUnmapped() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx_unmapped")
-                .setQuery(matchAllQuery())
-                .addAggregation(min("min").field("value"))
-                .get();
-
-        assertThat(searchResponse.getHits().getTotalHits().value, equalTo(0L));
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(Double.POSITIVE_INFINITY));
-    }
-
-    @Override
-    public void testSingleValuedField() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx")
-                .setQuery(matchAllQuery())
-                .addAggregation(min("min").field("value"))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(1.0));
-    }
-
-    public void testSingleValuedFieldWithFormatter() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx").setQuery(matchAllQuery())
-                .addAggregation(min("min").format("0000.0").field("value")).get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(1.0));
-        assertThat(min.getValueAsString(), equalTo("0001.0"));
-    }
-
-    @Override
-    public void testSingleValuedFieldGetProperty() throws Exception {
-
-        SearchResponse searchResponse = client().prepareSearch("idx").setQuery(matchAllQuery())
-                .addAggregation(global("global").subAggregation(min("min").field("value"))).get();
-
-        assertHitCount(searchResponse, 10);
-
-        Global global = searchResponse.getAggregations().get("global");
-        assertThat(global, notNullValue());
-        assertThat(global.getName(), equalTo("global"));
-        assertThat(global.getDocCount(), equalTo(10L));
-        assertThat(global.getAggregations(), notNullValue());
-        assertThat(global.getAggregations().asMap().size(), equalTo(1));
-
-        Min min = global.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        double expectedMinValue = 1.0;
-        assertThat(min.getValue(), equalTo(expectedMinValue));
-        assertThat((Min) ((InternalAggregation)global).getProperty("min"), equalTo(min));
-        assertThat((double) ((InternalAggregation)global).getProperty("min.value"), equalTo(expectedMinValue));
-        assertThat((double) ((InternalAggregation)min).getProperty("value"), equalTo(expectedMinValue));
-    }
-
-    @Override
-    public void testSingleValuedFieldPartiallyUnmapped() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx", "idx_unmapped")
-                .setQuery(matchAllQuery())
-                .addAggregation(min("min").field("value"))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(1.0));
-    }
-
-    @Override
-    public void testSingleValuedFieldWithValueScript() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx")
-                .setQuery(matchAllQuery())
-                .addAggregation(
-                        min("min")
-                                .field("value")
-                                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(0.0));
-    }
-
-    @Override
-    public void testSingleValuedFieldWithValueScriptWithParams() throws Exception {
-        Map<String, Object> params = new HashMap<>();
-        params.put("dec", 1);
-
-        Script script = new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - dec", params);
-
-        SearchResponse searchResponse = client().prepareSearch("idx")
-                .setQuery(matchAllQuery())
-                .addAggregation(min("min").field("value").script(script))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(0.0));
-    }
-
-    @Override
-    public void testMultiValuedField() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx")
-                .setQuery(matchAllQuery())
-                .addAggregation(min("min").field("values"))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(2.0));
-    }
-
-    @Override
-    public void testMultiValuedFieldWithValueScript() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx")
-                .setQuery(matchAllQuery())
-                .addAggregation(
-                        min("min")
-                                .field("values")
-                                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(1.0));
-    }
-
-    public void testMultiValuedFieldWithValueScriptReverse() throws Exception {
-        // test what happens when values arrive in reverse order since the min
-        // aggregator is optimized to work on sorted values
-        SearchResponse searchResponse = client().prepareSearch("idx").setQuery(matchAllQuery())
-                .addAggregation(
-                        min("min")
-                                .field("values")
-                                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value * -1", emptyMap())))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(-12d));
-    }
-
-    @Override
-    public void testMultiValuedFieldWithValueScriptWithParams() throws Exception {
-        Map<String, Object> params = new HashMap<>();
-        params.put("dec", 1);
-
-        Script script = new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - dec", params);
-
-        SearchResponse searchResponse = client().prepareSearch("idx").setQuery(matchAllQuery())
-                .addAggregation(min("min").field("values").script(script))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(1.0));
-    }
-
-    @Override
-    public void testScriptSingleValued() throws Exception {
-        Script script = new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "doc['value'].value", emptyMap());
-
-        SearchResponse searchResponse = client().prepareSearch("idx").setQuery(matchAllQuery())
-                .addAggregation(min("min").script(script))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(1.0));
-    }
-
-    @Override
-    public void testScriptSingleValuedWithParams() throws Exception {
-        Map<String, Object> params = new HashMap<>();
-        params.put("dec", 1);
-
-        Script script = new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "doc['value'].value - dec", params);
-
-        SearchResponse searchResponse = client().prepareSearch("idx").setQuery(matchAllQuery())
-                .addAggregation(min("min").script(script))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(0.0));
-    }
-
-    @Override
-    public void testScriptMultiValued() throws Exception {
-        Script script = new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "doc['values']", emptyMap());
-        SearchResponse searchResponse = client().prepareSearch("idx").setQuery(matchAllQuery())
-                .addAggregation(min("min").script(script))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(2.0));
-    }
-
-    @Override
-    public void testScriptMultiValuedWithParams() throws Exception {
-        Map<String, Object> params = new HashMap<>();
-        params.put("dec", 1);
-
-        SearchResponse searchResponse = client()
-                .prepareSearch("idx")
-                .setQuery(matchAllQuery())
-                .addAggregation(min("min").script(AggregationTestScriptsPlugin.DECREMENT_ALL_VALUES))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(1.0));
-    }
-
-    @Override
-    public void testOrderByEmptyAggregation() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx").setQuery(matchAllQuery())
-                .addAggregation(terms("terms").field("value").order(BucketOrder.compound(BucketOrder.aggregation("filter>min", true)))
-                        .subAggregation(filter("filter", termQuery("value", 100)).subAggregation(min("min").field("value"))))
-                .get();
-
-        assertHitCount(searchResponse, 10);
-
-        Terms terms = searchResponse.getAggregations().get("terms");
-        assertThat(terms, notNullValue());
-        List<? extends Terms.Bucket> buckets = terms.getBuckets();
-        assertThat(buckets, notNullValue());
-        assertThat(buckets.size(), equalTo(10));
-
-        for (int i = 0; i < 10; i++) {
-            Terms.Bucket bucket = buckets.get(i);
-            assertThat(bucket, notNullValue());
-            assertThat(bucket.getKeyAsNumber(), equalTo((long) i + 1));
-            assertThat(bucket.getDocCount(), equalTo(1L));
-            Filter filter = bucket.getAggregations().get("filter");
-            assertThat(filter, notNullValue());
-            assertThat(filter.getDocCount(), equalTo(0L));
-            Min min = filter.getAggregations().get("min");
-            assertThat(min, notNullValue());
-            assertThat(min.value(), equalTo(Double.POSITIVE_INFINITY));
-
-        }
-    }
-
-    /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
-     */
-    public void testDontCacheScripts() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
-                .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
-                .get());
-        indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
-                client().prepareIndex("cache_test_idx").setId("2").setSource("s", 2));
-
-        // Make sure we are starting with a clear cache
-        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getHitCount(), equalTo(0L));
-        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(0L));
-
-        // Test that a request using a script does not get cached
-        SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
-                min("foo").field("d").script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
-                .get();
-        assertSearchResponse(r);
-
-        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getHitCount(), equalTo(0L));
-        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(0L));
-
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(min("foo").field("d")).get();
-        assertSearchResponse(r);
-
-        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getHitCount(), equalTo(0L));
-        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(1L));
-    }
-
-    public void testEarlyTermination() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx")
-            .setTrackTotalHits(false)
-            .setQuery(matchAllQuery())
-            .addAggregation(min("min").field("values"))
-            .addAggregation(count("count").field("values"))
-            .get();
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(2.0));
-
-        ValueCount count = searchResponse.getAggregations().get("count");
-        assertThat(count.getName(), equalTo("count"));
-        assertThat(count.getValue(), equalTo(20L));
-    }
-
-    public void testNestedEarlyTermination() throws Exception {
-        SearchResponse searchResponse = client().prepareSearch("idx")
-            .setTrackTotalHits(false)
-            .setQuery(matchAllQuery())
-            .addAggregation(min("min").field("values"))
-            .addAggregation(count("count").field("values"))
-            .addAggregation(terms("terms").field("value")
-                .collectMode(Aggregator.SubAggCollectionMode.BREADTH_FIRST)
-                .subAggregation(min("sub_min").field("invalid")))
-            .get();
-
-        Min min = searchResponse.getAggregations().get("min");
-        assertThat(min, notNullValue());
-        assertThat(min.getName(), equalTo("min"));
-        assertThat(min.getValue(), equalTo(2.0));
-
-        ValueCount count = searchResponse.getAggregations().get("count");
-        assertThat(count.getName(), equalTo("count"));
-        assertThat(count.getValue(), equalTo(20L));
-
-        Terms terms = searchResponse.getAggregations().get("terms");
-        assertThat(terms.getBuckets().size(), equalTo(10));
-        for (Terms.Bucket b : terms.getBuckets()) {
-            InternalMin subMin = b.getAggregations().get("sub_min");
-            assertThat(subMin.getValue(), equalTo(Double.POSITIVE_INFINITY));
-        }
-    }
-}

From 49a3e0647483b9f2a8019db5cb7f158d7db2f7a7 Mon Sep 17 00:00:00 2001
From: Julie Tibshirani <julie.tibshirani@elastic.co>
Date: Mon, 16 Dec 2019 10:37:03 -0800
Subject: [PATCH 219/686] Bump the scroll keep-alive time in cluster upgrade
 tests. (#50195)

In the yaml cluster upgrade tests, we start a scroll in a mixed-version cluster,
then attempt to continue the scroll after the upgrade is complete. This test
occasionally fails because the scroll can expire before the cluster is done
upgrading.

The current scroll keep-alive time 5m. This PR bumps it to 10m, which gives a
good buffer since in failing tests the time was only exceeded by ~30 seconds.

Addresses #46529.
---
 .../resources/rest-api-spec/test/mixed_cluster/10_basic.yml     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/10_basic.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/10_basic.yml
index d6daff8c24c31..e8ccd1cf0a2c9 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/10_basic.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/10_basic.yml
@@ -32,7 +32,7 @@
         rest_total_hits_as_int: true
         index: upgraded_scroll
         size: 1
-        scroll: 5m
+        scroll: 10m
         sort: foo
         body:
           query:

From 3784e206d90ee884efcc29923be19e990f640cb7 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Mon, 16 Dec 2019 10:42:30 -0800
Subject: [PATCH 220/686] [DOCS] Moves model snapshot resource definitions into
 APIs (#50157)

Co-Authored-By: Ed Savage <32410745+edsavage@users.noreply.github.com>
---
 .../apis/delete-snapshot.asciidoc             |   6 +-
 .../apis/get-snapshot.asciidoc                | 151 ++++++++++++++----
 .../apis/revert-snapshot.asciidoc             |  57 +++----
 .../apis/snapshotresource.asciidoc            | 104 ------------
 .../apis/update-job.asciidoc                  |   6 +-
 .../apis/update-snapshot.asciidoc             |  13 +-
 docs/reference/ml/ml-shared.asciidoc          |  13 +-
 docs/reference/redirects.asciidoc             |   6 +
 docs/reference/rest-api/defs.asciidoc         |   2 -
 9 files changed, 179 insertions(+), 179 deletions(-)
 delete mode 100644 docs/reference/ml/anomaly-detection/apis/snapshotresource.asciidoc

diff --git a/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
index b06c6a6a9c1ad..90d0303b9aff3 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
@@ -30,10 +30,12 @@ the `model_snapshot_id` in the results from the get jobs API.
 ==== {api-path-parms-title}
 
 `<job_id>`::
-  (Required, string) Identifier for the job.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
-  (Required, string) Identifier for the model snapshot.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 
 [[ml-delete-snapshot-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
index 94b67f6f98b9d..7a7fbfb5a4e75 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
@@ -30,8 +30,13 @@ Retrieves information about model snapshots.
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
-  (Optional, string) Identifier for the model snapshot. If you do not specify
-  this optional parameter, the API returns information about all model snapshots.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
++
+--
+If you do not specify this optional parameter, the API returns information about
+all model snapshots.
+--
 
 [[ml-get-snapshot-request-body]]
 ==== {api-request-body-title}
@@ -58,52 +63,136 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 [[ml-get-snapshot-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of model snapshot objects, which have the following 
+properties:
 
-`model_snapshots`::
-  (array) An array of model snapshot objects. For more information, see
-  <<ml-snapshot-resource>>.
+`description`::
+(string) An optional description of the job.
+
+`job_id`::
+(string) A numerical character string that uniquely identifies the job that
+  the snapshot was created for.
+  
+`latest_record_time_stamp`::
+(date) The timestamp of the latest processed record.
+
+`latest_result_time_stamp`::
+(date) The timestamp of the latest bucket result.
+
+`min_version`::
+(string) The minimum version required to be able to restore the model snapshot.
+
+`model_size_stats`::
+(object) Summary information describing the model.
+
+`model_size_stats`.`bucket_allocation_failures_count`:::
+(long) The number of buckets for which entities were not processed due to memory
+limit constraints.
+
+`model_size_stats`.`job_id`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`model_size_stats`.`log_time`:::
+(date) The timestamp that the `model_size_stats` were recorded, according to
+server-time.
+
+`model_size_stats`.`memory_status`:::
+(string) The status of the memory in relation to its `model_memory_limit`.
+Contains one of the following values.
++
+--
+* `hard_limit`: The internal models require more space that the configured
+memory limit. Some incoming data could not be processed.
+* `ok`: The internal models stayed below the configured value.
+* `soft_limit`: The internal models require more than 60% of the configured
+memory limit and more aggressive pruning will be performed in order to try to
+reclaim space.
+--
+
+`model_size_stats`.`model_bytes`:::
+(long) An approximation of the memory resources required for this analysis.
+
+`model_size_stats`.`model_bytes_exceeded`:::
+(long) The number of bytes over the high limit for memory usage at the last allocation failure.
+
+`model_size_stats`.`model_bytes_memory_limit`:::
+(long) The upper limit for memory usage, checked on increasing values.
+
+`model_size_stats`.`result_type`:::
+(string) Internal. This value is always `model_size_stats`.
+
+`model_size_stats`.`timestamp`:::
+(date) The timestamp that the `model_size_stats` were recorded, according to the
+bucket timestamp of the data.
+
+`model_size_stats`.`total_by_field_count`:::
+(long) The number of _by_ field values analyzed. Note that these are counted
+separately for each detector and partition.
+
+`model_size_stats`.`total_over_field_count`:::
+(long) The number of _over_ field values analyzed. Note that these are counted
+separately for each detector and partition.
+
+`model_size_stats`.`total_partition_field_count`:::
+(long) The number of _partition_ field values analyzed.
+
+`retain`::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=retain]
+
+`snapshot_id`::
+(string) A numerical character string that uniquely identifies the model
+snapshot. For example: "1491852978".
+
+`snapshot_doc_count`::
+(long) For internal use only.
+
+`timestamp`::
+(date) The creation timestamp for the snapshot.
 
 [[ml-get-snapshot-example]]
 ==== {api-examples-title}
 
 [source,console]
 --------------------------------------------------
-GET _ml/anomaly_detectors/farequote/model_snapshots
+GET _ml/anomaly_detectors/high_sum_total_sales/model_snapshots
 {
-  "start": "1491852977000"
+  "start": "1575402236000"
 }
 --------------------------------------------------
-// TEST[skip:todo]
+// TEST[skip:Kibana sample data]
 
 In this example, the API provides a single result:
 [source,js]
 ----
 {
-  "count": 1,
-  "model_snapshots": [
+  "count" : 1,
+  "model_snapshots" : [
     {
-      "job_id": "farequote",
-      "min_version": "6.3.0",
-      "timestamp": 1491948163000,
-      "description": "State persisted due to job close at 2017-04-11T15:02:43-0700",
-      "snapshot_id": "1491948163",
-      "snapshot_doc_count": 1,
-      "model_size_stats": {
-        "job_id": "farequote",
-        "result_type": "model_size_stats",
-        "model_bytes": 387594,
-        "total_by_field_count": 21,
-        "total_over_field_count": 0,
-        "total_partition_field_count": 20,
-        "bucket_allocation_failures_count": 0,
-        "memory_status": "ok",
-        "log_time": 1491948163000,
-        "timestamp": 1455234600000
+      "job_id" : "high_sum_total_sales",
+      "min_version" : "6.4.0",
+      "timestamp" : 1575402237000,
+      "description" : "State persisted due to job close at 2019-12-03T19:43:57+0000",
+      "snapshot_id" : "1575402237",
+      "snapshot_doc_count" : 1,
+      "model_size_stats" : {
+        "job_id" : "high_sum_total_sales",
+        "result_type" : "model_size_stats",
+        "model_bytes" : 1638816,
+        "model_bytes_exceeded" : 0,
+        "model_bytes_memory_limit" : 10485760,
+        "total_by_field_count" : 3,
+        "total_over_field_count" : 3320,
+        "total_partition_field_count" : 2,
+        "bucket_allocation_failures_count" : 0,
+        "memory_status" : "ok",
+        "log_time" : 1575402237000,
+        "timestamp" : 1576965600000
       },
-      "latest_record_time_stamp": 1455235196000,
-      "latest_result_time_stamp": 1455234900000,
-      "retain": false
+      "latest_record_time_stamp" : 1576971072000,
+      "latest_result_time_stamp" : 1576965600000,
+      "retain" : false
     }
   ]
 }
diff --git a/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
index d8cfc091b810f..e119cf2b40a33 100644
--- a/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
@@ -24,7 +24,7 @@ Reverts to a specific snapshot.
 [[ml-revert-snapshot-desc]]
 ==== {api-description-title}
 
-The {ml} feature in {xpack} reacts quickly to anomalous input, learning new
+The {ml-features} react quickly to anomalous input, learning new
 behaviors in data. Highly anomalous input increases the variance in the models
 whilst the system learns whether this is a new step-change in behavior or a
 one-off event. In the case where this anomalous input is known to be a one-off,
@@ -40,7 +40,8 @@ Friday or a critical system failure.
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
-  (Required, string) Identifier for the model snapshot.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 
 [[ml-revert-snapshot-request-body]]
 ==== {api-request-body-title}
@@ -57,13 +58,9 @@ If you want to resend data, then delete the intervening results.
 [[ml-revert-snapshot-example]]
 ==== {api-examples-title}
 
-The following example reverts to the `1491856080` snapshot for the
-`it_ops_new_kpi` job:
-
 [source,console]
 --------------------------------------------------
-POST
-_ml/anomaly_detectors/it_ops_new_kpi/model_snapshots/1491856080/_revert
+POST _ml/anomaly_detectors/high_sum_total_sales/model_snapshots/1575402237/_revert
 {
   "delete_intervening_results": true
 }
@@ -74,28 +71,32 @@ When the operation is complete, you receive the following results:
 [source,js]
 ----
 {
-  "model": {
-    "job_id": "it_ops_new_kpi",
-    "min_version": "6.3.0",
-    "timestamp": 1491856080000,
-    "description": "State persisted due to job close at 2017-04-10T13:28:00-0700",
-    "snapshot_id": "1491856080",
-    "snapshot_doc_count": 1,
-    "model_size_stats": {
-      "job_id": "it_ops_new_kpi",
-      "result_type": "model_size_stats",
-      "model_bytes": 29518,
-      "total_by_field_count": 3,
-      "total_over_field_count": 0,
-      "total_partition_field_count": 2,
-      "bucket_allocation_failures_count": 0,
-      "memory_status": "ok",
-      "log_time": 1491856080000,
-      "timestamp": 1455318000000
+  "model" : {
+    "job_id" : "high_sum_total_sales",
+    "min_version" : "6.4.0",
+    "timestamp" : 1575402237000,
+    "description" : "State persisted due to job close at 2019-12-03T19:43:57+0000",
+    "snapshot_id" : "1575402237",
+    "snapshot_doc_count" : 1,
+    "model_size_stats" : {
+      "job_id" : "high_sum_total_sales",
+      "result_type" : "model_size_stats",
+      "model_bytes" : 1638816,
+      "model_bytes_exceeded" : 0,
+      "model_bytes_memory_limit" : 10485760,
+      "total_by_field_count" : 3,
+      "total_over_field_count" : 3320,
+      "total_partition_field_count" : 2,
+      "bucket_allocation_failures_count" : 0,
+      "memory_status" : "ok",
+      "log_time" : 1575402237000,
+      "timestamp" : 1576965600000
     },
-    "latest_record_time_stamp": 1455318669000,
-    "latest_result_time_stamp": 1455318000000,
-    "retain": false
+    "latest_record_time_stamp" : 1576971072000,
+    "latest_result_time_stamp" : 1576965600000,
+    "retain" : false
   }
 }
 ----
+
+For a description of these properties, see the <<ml-get-snapshot-results,get model snapshots API>>.
diff --git a/docs/reference/ml/anomaly-detection/apis/snapshotresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/snapshotresource.asciidoc
deleted file mode 100644
index 13a26e26e8d70..0000000000000
--- a/docs/reference/ml/anomaly-detection/apis/snapshotresource.asciidoc
+++ /dev/null
@@ -1,104 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-snapshot-resource]]
-=== Model snapshot resources
-
-Model snapshots are saved to an internal index within the Elasticsearch cluster.
-By default, this is occurs approximately every 3 hours to 4 hours and is
-configurable with the `background_persist_interval` property.
-
-By default, model snapshots are retained for one day (twenty-four hours). You
-can change this behavior by updating the `model_snapshot_retention_days` for the
-job. When choosing a new value, consider the following:
-
-* Persistence enables resilience in the event of a system failure.
-* Persistence enables snapshots to be reverted.
-* The time taken to persist a job is proportional to the size of the model in memory.
-
-A model snapshot resource has the following properties:
-
-`description`::
-  (string) An optional description of the job.
-
-`job_id`::
-  (string) A numerical character string that uniquely identifies the job that
-  the snapshot was created for.
-
-`min_version`::
-  (string) The minimum version required to be able to restore the model snapshot.
-
-`latest_record_time_stamp`::
-  (date) The timestamp of the latest processed record.
-
-`latest_result_time_stamp`::
-  (date) The timestamp of the latest bucket result.
-
-`model_size_stats`::
-  (object) Summary information describing the model.
-  See <<ml-snapshot-stats,Model Size Statistics>>.
-
-`retain`::
-  (boolean) If true, this snapshot will not be deleted during automatic cleanup
-  of snapshots older than `model_snapshot_retention_days`.
-  However, this snapshot will be deleted when the job is deleted.
-  The default value is false.
-
-`snapshot_id`::
-  (string) A numerical character string that uniquely identifies the model
-  snapshot. For example: "1491852978".
-
-`snapshot_doc_count`::
-  (long) For internal use only.
-
-`timestamp`::
-  (date) The creation timestamp for the snapshot.
-
-NOTE: All of these properties are informational with the exception of
-`description` and `retain`.
-
-[float]
-[[ml-snapshot-stats]]
-==== Model Size Statistics
-
-The `model_size_stats` object has the following properties:
-
-`bucket_allocation_failures_count`::
-  (long) The number of buckets for which entities were not processed due to
-  memory limit constraints.
-
-`job_id`::
-  (string) A numerical character string that uniquely identifies the job.
-
-`log_time`::
-  (date) The timestamp that the `model_size_stats` were recorded, according to
-  server-time.
-
-`memory_status`::
-  (string) The status of the memory in relation to its `model_memory_limit`.
-  Contains one of the following values.
-  `ok`::: The internal models stayed below the configured value.
-  `soft_limit`::: The internal models require more than 60% of the configured
-  memory limit and more aggressive pruning will
-  be performed in order to try to reclaim space.
-  `hard_limit`::: The internal models require more space that the configured
-  memory limit. Some incoming data could not be processed.
-
-`model_bytes`::
-  (long) An approximation of the memory resources required for this analysis.
-
-`result_type`::
-  (string) Internal. This value is always set to "model_size_stats".
-
-`timestamp`::
-  (date) The timestamp that the `model_size_stats` were recorded, according to the bucket timestamp of the data.
-
-`total_by_field_count`::
-  (long) The number of _by_ field values analyzed. Note that these are counted separately for each detector and partition.
-
-`total_over_field_count`::
-  (long) The number of _over_ field values analyzed. Note that these are counted separately for each detector and partition.
-
-`total_partition_field_count`::
-  (long) The number of _partition_ field values analyzed.
-
-NOTE: All of these properties are informational; you cannot change their values.
diff --git a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
index 09e6e03e57d5f..3a417b6a0fc38 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
@@ -64,9 +64,9 @@ NOTE: You can update the `analysis_limits` only while the job is closed. The
 `model_memory_limit` property value cannot be decreased below the current usage.
  
 TIP: If the `memory_status` property in the
-<<ml-snapshot-stats,`model_size_stats` object>> has a value of `hard_limit`,
-this means that it was unable to process some data. You might want to re-run
-the job with an increased `model_memory_limit`.
+<<ml-get-snapshot-results,`model_size_stats` object>> has a value of `hard_limit`,
+this means that it was unable to process some data. You might want to re-run the
+job with an increased `model_memory_limit`.
 
 --
 
diff --git a/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
index 10f7228fd9b2a..e0220042eccb0 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
@@ -29,7 +29,8 @@ Updates certain properties of a snapshot.
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
-  (Required, string) Identifier for the model snapshot.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 
 [[ml-update-snapshot-request-body]]
 ==== {api-request-body-title}
@@ -37,14 +38,12 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 The following properties can be updated after the model snapshot is created:
 
 `description`::
-  (Optional, string) A description of the model snapshot. For example,
-  "Before black friday".
+(Optional, string) A description of the model snapshot.
 
 `retain`::
-  (Optional, boolean) If true, this snapshot will not be deleted during
-  automatic cleanup of snapshots older than `model_snapshot_retention_days`.
-  Note that this snapshot will still be deleted when the {anomaly-job} is
-  deleted. The default value is false.
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=retain]
+
 
 [[ml-update-snapshot-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index c13b4e903b91e..5b292f24ef515 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -895,8 +895,7 @@ end::model-plot-config[]
 
 tag::model-snapshot-id[]
 A numerical character string that uniquely identifies the model snapshot. For 
-example, `1491007364`. For more information about model snapshots, see
-<<ml-snapshot-resource>>.
+example, `1575402236000 `.
 end::model-snapshot-id[]
 
 tag::model-snapshot-retention-days[]
@@ -1006,6 +1005,12 @@ are deleted from {es}. The default value is null, which means results are
 retained.
 end::results-retention-days[]
 
+tag::retain[]
+If `true`, this snapshot will not be deleted during automatic cleanup of
+snapshots older than `model_snapshot_retention_days`. However, this snapshot
+will be deleted when the job is deleted. The default value is `false`.
+end::retain[]
+
 tag::script-fields[]
 Specifies scripts that evaluate custom expressions and returns script fields to
 the {dfeed}. The detector configuration objects in a job can contain functions
@@ -1023,6 +1028,10 @@ Specifies the maximum number of {dfanalytics-jobs} to obtain. The default value
 is `100`.
 end::size[]
 
+tag::snapshot-id[]
+Identifier for the model snapshot.
+end::snapshot-id[]
+
 tag::source-put-dfa[]
 The configuration of how to source the analysis data. It requires an 
 `index`. Optionally, `query` and `_source` may be specified.
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 858e128944742..69d7765e8a9b0 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -1082,3 +1082,9 @@ See
 [[ml-stats-node]]
 the details in <<ml-get-job-stats>>.
 
+[role="exclude",id="ml-snapshot-resource"]
+=== Model snapshot resources
+
+This page was deleted.
+[[ml-snapshot-stats]]
+See <<ml-update-snapshot>> and <<ml-get-snapshot>>.
\ No newline at end of file
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index 312a889707110..bda7415740d8e 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -7,14 +7,12 @@ These resource definitions are used in APIs related to {ml-features} and
 
 
 * <<ml-dfa-analysis-objects>>
-* <<ml-snapshot-resource,{anomaly-detect-cap} model snapshots>>
 * <<ml-results-resource,{anomaly-detect-cap} results>>
 * <<role-mapping-resources,Role mappings>>
 * <<transform-resource,{transforms-cap}>>
 
 
 include::{es-repo-dir}/ml/df-analytics/apis/analysisobjects.asciidoc[]
-include::{es-repo-dir}/ml/anomaly-detection/apis/snapshotresource.asciidoc[]
 include::{xes-repo-dir}/rest-api/security/role-mapping-resources.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/resultsresource.asciidoc[]
 include::{es-repo-dir}/transform/apis/transformresource.asciidoc[]

From e4d5a4c661b7dc76cc0e6802adc6cf0c35fe80f3 Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Mon, 16 Dec 2019 15:07:38 -0500
Subject: [PATCH 221/686] Respect ES_PATH_CONF during upgrades too (#50246)

A previous commit taught Elasticsearch packages to respect ES_PATH_CONF
during installs. Missed in that commit was respecting ES_PATH_CONF on
upgrades. This commit does that. Additionally, while ES_PATH_CONF is not
currently used in pre-install, this commit adds respect to the preinst
script in case we do in the future.
---
 .../packages/src/common/scripts/posttrans         | 15 +++++++++++----
 distribution/packages/src/common/scripts/preinst  |  7 +++++++
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/distribution/packages/src/common/scripts/posttrans b/distribution/packages/src/common/scripts/posttrans
index fdb9aafba38f6..ab989cf5676fd 100644
--- a/distribution/packages/src/common/scripts/posttrans
+++ b/distribution/packages/src/common/scripts/posttrans
@@ -1,8 +1,15 @@
-if [ ! -f /etc/elasticsearch/elasticsearch.keystore ]; then
+# source the default env file
+if [ -f "${path.env}" ]; then
+    . "${path.env}"
+else
+  ES_PATH_CONF="${path.conf}"
+fi
+
+if [ ! -f "${ES_PATH_CONF}"/elasticsearch.keystore ]; then
     /usr/share/elasticsearch/bin/elasticsearch-keystore create
-    chown root:elasticsearch /etc/elasticsearch/elasticsearch.keystore
-    chmod 660 /etc/elasticsearch/elasticsearch.keystore
-    md5sum /etc/elasticsearch/elasticsearch.keystore > /etc/elasticsearch/.elasticsearch.keystore.initial_md5sum
+    chown root:elasticsearch "${ES_PATH_CONF}"/elasticsearch.keystore
+    chmod 660 "${ES_PATH_CONF}"/elasticsearch.keystore
+    md5sum "${ES_PATH_CONF}"/elasticsearch.keystore > "${ES_PATH_CONF}"/.elasticsearch.keystore.initial_md5sum
 else
     /usr/share/elasticsearch/bin/elasticsearch-keystore upgrade
 fi
diff --git a/distribution/packages/src/common/scripts/preinst b/distribution/packages/src/common/scripts/preinst
index 66e5038a55daa..c3e15b632aaf7 100644
--- a/distribution/packages/src/common/scripts/preinst
+++ b/distribution/packages/src/common/scripts/preinst
@@ -15,6 +15,13 @@ err_exit() {
     exit 1
 }
 
+# source the default env file
+if [ -f "${path.env}" ]; then
+    . "${path.env}"
+else
+  ES_PATH_CONF="${path.conf}"
+fi
+
 case "$1" in
 
     # Debian ####################################################

From 75e01afa0bb7a35907a87e96fd3b25039bfbf52f Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Mon, 16 Dec 2019 21:59:54 +0100
Subject: [PATCH 222/686] Recovery buffer size 16B smaller (#50100)

G1GC will use humongous allocations when an allocation exceeds half the
chosen region size, which is minimum 1MB. By reducing the recovery
buffer size by 16 bytes we ensure that the recovery buffer is never
allocated as a humongous allocation.
---
 .../org/elasticsearch/indices/recovery/RecoverySettings.java   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySettings.java b/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySettings.java
index 3db04dec1d69f..469529bb09ff6 100644
--- a/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySettings.java
+++ b/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySettings.java
@@ -81,7 +81,8 @@ public class RecoverySettings {
             INDICES_RECOVERY_INTERNAL_LONG_ACTION_TIMEOUT_SETTING::get, TimeValue.timeValueSeconds(0),
             Property.Dynamic, Property.NodeScope);
 
-    public static final ByteSizeValue DEFAULT_CHUNK_SIZE = new ByteSizeValue(512, ByteSizeUnit.KB);
+    // choose 512KB-16B to ensure that the resulting byte[] is not a humongous allocation in G1.
+    public static final ByteSizeValue DEFAULT_CHUNK_SIZE = new ByteSizeValue(512 * 1024 - 16, ByteSizeUnit.BYTES);
 
     private volatile ByteSizeValue maxBytesPerSec;
     private volatile int maxConcurrentFileChunks;

From b7b2c7c60a8f5cea93a8d94bcd912ab4592b1fec Mon Sep 17 00:00:00 2001
From: Przemko Robakowski <przemko.robakowski@elastic.co>
Date: Tue, 17 Dec 2019 00:18:05 +0100
Subject: [PATCH 223/686] Fix flakiness in CsvProcessorTests (#50254)

There's flakiness in CsvProcesorTests, where tests fail if random document generator add field that should not be present. This change cleans generated document from these problematic fields.

Closes #50209
---
 .../java/org/elasticsearch/ingest/common/CsvProcessorTests.java  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/CsvProcessorTests.java b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/CsvProcessorTests.java
index 87da73cce129d..45f00a7435033 100644
--- a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/CsvProcessorTests.java
+++ b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/CsvProcessorTests.java
@@ -209,6 +209,7 @@ private IngestDocument processDocument(String[] headers, String csv) throws Exce
 
     private IngestDocument processDocument(String[] headers, String csv, boolean trim) throws Exception {
         IngestDocument ingestDocument = RandomDocumentPicks.randomIngestDocument(random());
+        Arrays.stream(headers).filter(ingestDocument::hasField).forEach(ingestDocument::removeField);
 
         String fieldName = RandomDocumentPicks.addRandomField(random(), ingestDocument, csv);
         char quoteChar = quote.isEmpty() ? '"' : quote.charAt(0);

From c93e9b187f35adbff2bfe6b9708b46c2c782528b Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Mon, 16 Dec 2019 20:05:14 -0800
Subject: [PATCH 224/686] Modifying WaitForIndexGreen to WaitForIndexColor
 class

---
 .../xpack/core/ilm/CloseIndexStep.java        |  12 +-
 .../xpack/core/ilm/ForceMergeAction.java      |  49 +++++---
 .../xpack/core/ilm/OpenIndexStep.java         |   9 +-
 ...enStep.java => WaitForIndexColorStep.java} |  74 ++++++++++-
 .../xpack/core/ilm/ForceMergeActionTests.java |  28 +++--
 .../ilm/TimeseriesLifecycleTypeTests.java     |   5 +-
 ...s.java => WaitForIndexColorStepTests.java} | 115 +++++++++++++-----
 7 files changed, 217 insertions(+), 75 deletions(-)
 rename x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/{WaitForIndexGreenStep.java => WaitForIndexColorStep.java} (56%)
 rename x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/{WaitForIndexGreenStepTests.java => WaitForIndexColorStepTests.java} (51%)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index f0afab5f604ee..994ddf2590b58 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -12,7 +12,10 @@
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.ClusterStateObserver;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.xpack.core.ilm.AsyncActionStep;
+
+/**
+ * Invokes a close step on a single index.
+ */
 
 public class CloseIndexStep extends AsyncActionStep {
     public static final String NAME = "close-index";
@@ -24,10 +27,13 @@ public class CloseIndexStep extends AsyncActionStep {
     @Override
     public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState,
                               ClusterStateObserver observer, Listener listener) {
-        if(indexMetaData.getState() == IndexMetaData.State.OPEN) {
+        if (indexMetaData.getState() == IndexMetaData.State.OPEN) {
             CloseIndexRequest request = new CloseIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
-                .close(request, ActionListener.wrap(closeIndexResponse -> listener.onResponse(true), listener::onFailure));
+                .close(request, ActionListener.wrap(closeIndexResponse -> {
+                    assert closeIndexResponse.isAcknowledged() : "close index response is not acknowledged";
+                    listener.onResponse(true);
+                }, listener::onFailure));
         }
         else {
             listener.onResponse(true);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 5d4227a766f58..636f7a83e28c8 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -5,7 +5,10 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
+import org.apache.lucene.codecs.Codec;
+import org.elasticsearch.Version;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
@@ -30,53 +33,61 @@
 public class ForceMergeAction implements LifecycleAction {
     public static final String NAME = "forcemerge";
     public static final ParseField MAX_NUM_SEGMENTS_FIELD = new ParseField("max_num_segments");
-    public static final ParseField BEST_COMPRESSION_FIELD = new ParseField("best_compression");
+    public static final ParseField CODEC = new ParseField("index.codec");
 
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        boolean bestCompression = a[1] != null && (boolean) a[1];
-        return new ForceMergeAction(maxNumSegments, bestCompression);
+        Codec codec = a[1] != null ? Codec.forName((String)a[1]): Codec.getDefault();
+        return new ForceMergeAction(maxNumSegments, codec);
     });
 
     static {
         PARSER.declareInt(ConstructingObjectParser.constructorArg(), MAX_NUM_SEGMENTS_FIELD);
-        PARSER.declareBoolean(ConstructingObjectParser.constructorArg(), BEST_COMPRESSION_FIELD);
+        PARSER.declareInt(ConstructingObjectParser.constructorArg(), CODEC);
     }
 
     private final int maxNumSegments;
-    private final boolean bestCompression;
+    private final Codec codec;
 
     public static ForceMergeAction parse(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    public ForceMergeAction(int maxNumSegments, boolean bestCompression) {
+    public ForceMergeAction(int maxNumSegments, Codec codec) {
         if (maxNumSegments <= 0) {
             throw new IllegalArgumentException("[" + MAX_NUM_SEGMENTS_FIELD.getPreferredName()
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
-        this.bestCompression = bestCompression;
+        this.codec = codec;
     }
 
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
-        this.bestCompression = in.readBoolean();
+        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            this.codec = Codec.forName(in.readString());
+        } else {
+          this.codec = Codec.getDefault();
+        }
     }
 
     public int getMaxNumSegments() {
         return maxNumSegments;
     }
 
-    public boolean isBestCompression() {
-        return bestCompression;
+    public Codec getCodec() {
+        return this.codec;
     }
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
-        out.writeBoolean(bestCompression);
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            out.writeString(codec.getName());
+        } else {
+            out.writeString(Codec.getDefault().getName());
+        }
     }
 
     @Override
@@ -93,7 +104,7 @@ public boolean isSafeAction() {
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
         builder.field(MAX_NUM_SEGMENTS_FIELD.getPreferredName(), maxNumSegments);
-        builder.field(BEST_COMPRESSION_FIELD.getPreferredName(), bestCompression);
+        builder.field(CODEC.getPreferredName(), codec);
         builder.endObject();
         return builder;
     }
@@ -101,25 +112,25 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     @Override
     public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey) {
         Settings readOnlySettings = Settings.builder().put(IndexMetaData.SETTING_BLOCKS_WRITE, true).build();
+        Settings bestCompressionSettings = Settings.builder()
+            .put(EngineConfig.INDEX_CODEC_SETTING.getKey(), CodecService.BEST_COMPRESSION_CODEC).build();
 
         StepKey readOnlyKey = new StepKey(phase, NAME, ReadOnlyAction.NAME);
         StepKey forceMergeKey = new StepKey(phase, NAME, ForceMergeStep.NAME);
         StepKey countKey = new StepKey(phase, NAME, SegmentCountStep.NAME);
 
 
-        if (this.bestCompression) {
+        if (codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
             StepKey closeKey = new StepKey(phase, NAME, CloseIndexStep.NAME);
             StepKey openKey = new StepKey(phase, NAME, OpenIndexStep.NAME);
-            StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexGreenStep.NAME);
+            StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
             StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
-            Settings bestCompressionSettings = Settings.builder()
-                .put(EngineConfig.INDEX_CODEC_SETTING.getKey(), CodecService.BEST_COMPRESSION_CODEC).build();
 
             CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
             UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
                 openKey, client, bestCompressionSettings);
             OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
-            WaitForIndexGreenStep waitForIndexGreenStep = new WaitForIndexGreenStep(waitForGreenIndexKey, forceMergeKey);
+            WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey, forceMergeKey, ClusterHealthStatus.GREEN);
             ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, nextStepKey, client, maxNumSegments);
             return Arrays.asList(closeIndexStep, updateBestCompressionSettings,
                 openIndexStep, waitForIndexGreenStep, forceMergeStep);
@@ -133,7 +144,7 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
 
     @Override
     public int hashCode() {
-        return Objects.hash(maxNumSegments, bestCompression);
+        return Objects.hash(maxNumSegments, codec);
     }
 
     @Override
@@ -146,7 +157,7 @@ public boolean equals(Object obj) {
         }
         ForceMergeAction other = (ForceMergeAction) obj;
         return Objects.equals(maxNumSegments, other.maxNumSegments)
-            && Objects.equals(bestCompression, other.bestCompression);
+            && Objects.equals(codec, other.codec);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index b032b0761fa44..907750e212332 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -13,6 +13,10 @@
 import org.elasticsearch.cluster.ClusterStateObserver;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 
+/**
+ * Invokes a open step on a single index.
+ */
+
 final class OpenIndexStep extends AsyncActionStep {
 
     static final String NAME = "open-index";
@@ -28,7 +32,10 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             OpenIndexRequest request = new OpenIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
                 .open(request,
-                    ActionListener.wrap(closeIndexResponse -> listener.onResponse(true), listener::onFailure));
+                    ActionListener.wrap(openIndexResponse-> {
+                        assert openIndexResponse.isAcknowledged() : "open Index response is not acknowledged";
+                        listener.onResponse(true);
+                    }, listener::onFailure));
 
         } else {
             listener.onResponse(true);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
similarity index 56%
rename from x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
rename to x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
index d717a970c66b1..812ad66323668 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
@@ -8,6 +8,7 @@
 
 import com.carrotsearch.hppc.cursors.ObjectCursor;
 import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.routing.IndexRoutingTable;
 import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
 import org.elasticsearch.cluster.routing.RoutingTable;
@@ -20,28 +21,91 @@
 import java.io.IOException;
 import java.util.Objects;
 
-class WaitForIndexGreenStep extends ClusterStateWaitStep {
+/**
+ * Wait Step for index based on color
+ * */
 
-    static final String NAME = "wait-for-index-green-step";
+class WaitForIndexColorStep extends ClusterStateWaitStep {
 
-    WaitForIndexGreenStep(StepKey key, StepKey nextStepKey) {
+    static final String NAME = "wait-for-index-color-step";
+
+    private final ClusterHealthStatus color;
+
+    WaitForIndexColorStep(StepKey key, StepKey nextStepKey, ClusterHealthStatus color) {
         super(key, nextStepKey);
+        this.color = color;
+    }
+
+    public ClusterHealthStatus getColor() {
+        return this.color;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(super.hashCode(), this.color);
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (obj == null) return false;
+        if (!(obj instanceof WaitForIndexColorStep)) return false;
+        WaitForIndexColorStep other = (WaitForIndexColorStep) obj;
+        return super.equals(obj) && Objects.equals(this.color, other.color);
     }
 
     @Override
     public Result isConditionMet(Index index, ClusterState clusterState) {
         RoutingTable routingTable = clusterState.routingTable();
         IndexRoutingTable indexRoutingTable = routingTable.index(index);
+        Result result;
+        switch (this.color) {
+            case GREEN:
+                result = waitForGreen(indexRoutingTable);
+                break;
+            case YELLOW:
+                result = waitForYellow(indexRoutingTable);
+                break;
+            case RED:
+                result = waitForRed(indexRoutingTable);
+                break;
+            default:
+                result = new Result(false, new Info("No index color match"));
+                break;
+        }
+        return result;
+    }
+
+    private Result waitForRed(IndexRoutingTable indexRoutingTable) {
+        if (indexRoutingTable == null) {
+            return new Result(true, new Info("Index is red"));
+        }
+        return new Result(false, new Info("Index is not red"));
+    }
+
+    private Result waitForYellow(IndexRoutingTable indexRoutingTable) {
+        if (indexRoutingTable == null) {
+            return new Result(false, new Info("index is red; no IndexRoutingTable"));
+        }
+
+        boolean indexIsAtLeastYellow = indexRoutingTable.allPrimaryShardsActive();
+        if (indexIsAtLeastYellow) {
+            return new Result(true, null);
+        } else {
+            return new Result(false, new Info("index is red; not all primary shards are active"));
+        }
+    }
+
+    private Result waitForGreen(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
             return new Result(false, new Info("index is red; no IndexRoutingTable"));
         }
 
         boolean indexIsGreen = false;
-        if(indexRoutingTable.allPrimaryShardsActive()) {
+        if (indexRoutingTable.allPrimaryShardsActive()) {
             boolean replicaIndexIsGreen = false;
             for (ObjectCursor<IndexShardRoutingTable> shardRouting : indexRoutingTable.getShards().values()) {
                 replicaIndexIsGreen = shardRouting.value.replicaShards().stream().allMatch(ShardRouting::active);
-                if(!replicaIndexIsGreen) {
+                if (!replicaIndexIsGreen) {
                     return new Result(false, new Info("index is yellow; not all replica shards are active"));
                 }
             }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index c12f6e7459bd2..4f899f3b74355 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
+import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
@@ -35,20 +36,21 @@ protected ForceMergeAction createTestInstance() {
     }
 
     static ForceMergeAction randomInstance() {
-        return new ForceMergeAction(randomIntBetween(1, 100), randomBoolean());
+        return new ForceMergeAction(randomIntBetween(1, 100), createRandomCompressionSettings());
+    }
+
+    static Codec createRandomCompressionSettings() {
+        if(randomBoolean()) {
+            return Codec.getDefault();
+        }
+        return Codec.forName(CodecService.BEST_COMPRESSION_CODEC);
     }
 
     @Override
     protected ForceMergeAction mutateInstance(ForceMergeAction instance) {
         int maxNumSegments = instance.getMaxNumSegments();
-        boolean bestCompression = instance.isBestCompression();
-        if(randomBoolean()) {
-            maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
-        }
-        else {
-            bestCompression = !bestCompression;
-        }
-        return new ForceMergeAction(maxNumSegments, bestCompression);
+        maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
+        return new ForceMergeAction(maxNumSegments, Codec.getDefault());
     }
 
     @Override
@@ -83,7 +85,7 @@ private void assertBestCompression(ForceMergeAction instance) {
         CloseIndexStep firstStep = (CloseIndexStep) steps.get(0);
         UpdateSettingsStep secondStep = (UpdateSettingsStep) steps.get(1);
         OpenIndexStep thirdStep = (OpenIndexStep) steps.get(2);
-        WaitForIndexGreenStep fourthStep = (WaitForIndexGreenStep) steps.get(3);
+        WaitForIndexColorStep fourthStep = (WaitForIndexColorStep) steps.get(3);
         ForceMergeStep fifthStep = (ForceMergeStep) steps.get(4);
         assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
         assertThat(firstStep.getNextStepKey(), equalTo(secondStep.getKey()));
@@ -92,7 +94,7 @@ private void assertBestCompression(ForceMergeAction instance) {
         assertThat(secondStep.getNextStepKey(), equalTo(thirdStep.getKey()));
         assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
         assertThat(thirdStep.getNextStepKey(), equalTo(fourthStep));
-        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexGreenStep.NAME)));
+        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexColorStep.NAME)));
         assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
         assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
         assertThat(fifthStep.getNextStepKey(), equalTo(nextStepKey));
@@ -107,13 +109,13 @@ public void testMissingMaxNumSegments() throws IOException {
     }
 
     public void testInvalidNegativeSegmentNumber() {
-        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0), false));
+        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0), Codec.getDefault()));
         assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
     }
 
     public void testToSteps() {
         ForceMergeAction instance = createTestInstance();
-        if (instance.isBestCompression()) {
+        if (CodecService.BEST_COMPRESSION_CODEC.equals(instance.getCodec().getName())) {
             assertBestCompression(instance);
         }
         else {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index 49bc71c55971f..1469e40e6682d 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
+import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.test.ESTestCase;
@@ -34,7 +35,7 @@ public class TimeseriesLifecycleTypeTests extends ESTestCase {
     private static final AllocateAction TEST_ALLOCATE_ACTION =
         new AllocateAction(2, Collections.singletonMap("node", "node1"),null, null);
     private static final DeleteAction TEST_DELETE_ACTION = new DeleteAction();
-    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, false);
+    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, Codec.getDefault());
     private static final RolloverAction TEST_ROLLOVER_ACTION = new RolloverAction(new ByteSizeValue(1), null, null);
     private static final ShrinkAction TEST_SHRINK_ACTION = new ShrinkAction(1);
     private static final ReadOnlyAction TEST_READ_ONLY_ACTION = new ReadOnlyAction();
@@ -492,7 +493,7 @@ private ConcurrentMap<String, LifecycleAction> convertActionNamesToActions(Strin
             case DeleteAction.NAME:
                 return new DeleteAction();
             case ForceMergeAction.NAME:
-                return new ForceMergeAction(1, false);
+                return new ForceMergeAction(1, Codec.getDefault());
             case ReadOnlyAction.NAME:
                 return new ReadOnlyAction();
             case RolloverAction.NAME:
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
similarity index 51%
rename from x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
rename to x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
index 46fba4bcf1770..0baa5a830df82 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexGreenStepTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.routing.IndexRoutingTable;
@@ -23,35 +24,48 @@
 import static org.hamcrest.Matchers.nullValue;
 import static org.hamcrest.core.IsNull.notNullValue;
 
-public class WaitForIndexGreenStepTests extends AbstractStepTestCase<WaitForIndexGreenStep> {
+public class WaitForIndexColorStepTests extends AbstractStepTestCase<WaitForIndexColorStep> {
+
+    private static ClusterHealthStatus randomColor() {
+        String[] colors = new String[]{"green", "yellow", "red"};
+        int randomColor = randomIntBetween(0, colors.length - 1);
+        return ClusterHealthStatus.fromString(colors[randomColor]);
+    }
 
     @Override
-    protected WaitForIndexGreenStep createRandomInstance() {
+    protected WaitForIndexColorStep createRandomInstance() {
         StepKey stepKey = randomStepKey();
         StepKey nextStepKey = randomStepKey();
-        return new WaitForIndexGreenStep(stepKey, nextStepKey);
+        ClusterHealthStatus color = randomColor();
+        return new WaitForIndexColorStep(stepKey, nextStepKey, color);
     }
 
     @Override
-    protected WaitForIndexGreenStep mutateInstance(WaitForIndexGreenStep instance) {
+    protected WaitForIndexColorStep mutateInstance(WaitForIndexColorStep instance) {
         StepKey key = instance.getKey();
         StepKey nextKey = instance.getNextStepKey();
-
-        if (randomBoolean()) {
-            key = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
-        } else {
-            nextKey = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+        ClusterHealthStatus color = instance.getColor();
+
+        switch (between(0, 2)) {
+            case 0:
+                key = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 1:
+                nextKey = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 2:
+                color = randomColor();
         }
 
-        return new WaitForIndexGreenStep(key, nextKey);
+        return new WaitForIndexColorStep(key, nextKey, color);
     }
 
     @Override
-    protected WaitForIndexGreenStep copyInstance(WaitForIndexGreenStep instance) {
-        return new WaitForIndexGreenStep(instance.getKey(), instance.getNextStepKey());
+    protected WaitForIndexColorStep copyInstance(WaitForIndexColorStep instance) {
+        return new WaitForIndexColorStep(instance.getKey(), instance.getNextStepKey(), instance.getColor());
     }
 
-    public void testConditionMet() {
+    public void testConditionMetForGreen() {
         IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
             .settings(settings(Version.CURRENT))
             .numberOfShards(1)
@@ -68,13 +82,13 @@ public void testConditionMet() {
             .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
             .build();
 
-        WaitForIndexGreenStep step = createRandomInstance();
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.GREEN);
         ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
         assertThat(result.isComplete(), is(true));
         assertThat(result.getInfomationContext(), nullValue());
     }
 
-    public void testConditionNotMet() {
+    public void testConditionNotMetForGreen() {
         IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
             .settings(settings(Version.CURRENT))
             .numberOfShards(1)
@@ -91,47 +105,84 @@ public void testConditionNotMet() {
             .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
             .build();
 
-        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.GREEN);
         ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
         assertThat(result.isComplete(), is(false));
-        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
         assertThat(info, notNullValue());
         assertThat(info.getMessage(), equalTo("index is not green; not all shards are active"));
     }
 
-    public void testConditionNotMetWithYellow() {
+    public void testConditionNotMetNoIndexRoutingTable() {
         IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
             .settings(settings(Version.CURRENT))
             .numberOfShards(1)
-            .numberOfReplicas(2)
+            .numberOfReplicas(0)
             .build();
 
-        ShardRouting shardRouting =
-            TestShardRouting.newShardRouting("test_index", 0, "1", true, ShardRoutingState.STARTED);
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().build())
+            .build();
 
-        ShardRouting replicaShardRouting =
-            TestShardRouting.newShardRouting("test_index", 0, "2", false, ShardRoutingState.INITIALIZING);
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.YELLOW);
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(false));
+        WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
+        assertThat(info, notNullValue());
+        assertThat(info.getMessage(), equalTo("index is red; no IndexRoutingTable"));
+    }
+
+    public void testConditionMetForYellow() {
+        IndexMetaData indexMetadata = IndexMetaData.builder("former-follower-index")
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .build();
 
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("index2", 0, "1", true, ShardRoutingState.STARTED);
         IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
-            .addShard(shardRouting)
-            .addShard(replicaShardRouting)
+            .addShard(shardRouting).build();
+
+        ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
+            .metaData(MetaData.builder().put(indexMetadata, true).build())
+            .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
+            .build();
+
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.YELLOW);
+        ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
+        assertThat(result.isComplete(), is(true));
+        assertThat(result.getInfomationContext(), nullValue());
+    }
+
+    public void testConditionNotMetForYellow() {
+        IndexMetaData indexMetadata = IndexMetaData.builder("former-follower-index")
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
             .build();
 
+        ShardRouting shardRouting =
+            TestShardRouting.newShardRouting("index2", 0, "1", true, ShardRoutingState.INITIALIZING);
+        IndexRoutingTable indexRoutingTable = IndexRoutingTable.builder(indexMetadata.getIndex())
+            .addShard(shardRouting).build();
+
         ClusterState clusterState = ClusterState.builder(new ClusterName("_name"))
             .metaData(MetaData.builder().put(indexMetadata, true).build())
             .routingTable(RoutingTable.builder().add(indexRoutingTable).build())
             .build();
 
-        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.YELLOW);
         ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
         assertThat(result.isComplete(), is(false));
-        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
         assertThat(info, notNullValue());
-        assertThat(info.getMessage(), equalTo("index is yellow; not all replica shards are active"));
+        assertThat(info.getMessage(), equalTo("index is red; not all primary shards are active"));
     }
 
-    public void testConditionNotMetNoIndexRoutingTable() {
-        IndexMetaData indexMetadata = IndexMetaData.builder(randomAlphaOfLength(5))
+    public void testConditionNotMetNoIndexRoutingTableForYellow() {
+        IndexMetaData indexMetadata = IndexMetaData.builder("former-follower-index")
             .settings(settings(Version.CURRENT))
             .numberOfShards(1)
             .numberOfReplicas(0)
@@ -142,10 +193,10 @@ public void testConditionNotMetNoIndexRoutingTable() {
             .routingTable(RoutingTable.builder().build())
             .build();
 
-        WaitForIndexGreenStep step = new WaitForIndexGreenStep(randomStepKey(), randomStepKey());
+        WaitForIndexColorStep step = new WaitForIndexColorStep(randomStepKey(), randomStepKey(), ClusterHealthStatus.YELLOW);
         ClusterStateWaitStep.Result result = step.isConditionMet(indexMetadata.getIndex(), clusterState);
         assertThat(result.isComplete(), is(false));
-        WaitForIndexGreenStep.Info info = (WaitForIndexGreenStep.Info) result.getInfomationContext();
+        WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
         assertThat(info, notNullValue());
         assertThat(info.getMessage(), equalTo("index is red; no IndexRoutingTable"));
     }

From 831c078d17fc17c1ea80814e14dc31e810f6c0e9 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Mon, 16 Dec 2019 20:34:58 -0800
Subject: [PATCH 225/686] Precommit check changes

---
 .../org/elasticsearch/xpack/core/ilm/ForceMergeAction.java | 7 ++++---
 .../xpack/core/ilm/ForceMergeActionTests.java              | 3 ++-
 .../xpack/ilm/TimeSeriesLifecycleActionsIT.java            | 5 +++--
 3 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 636f7a83e28c8..ef49d537684a8 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -38,7 +38,7 @@ public class ForceMergeAction implements LifecycleAction {
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        Codec codec = a[1] != null ? Codec.forName((String)a[1]): Codec.getDefault();
+        Codec codec = a[1] != null ? Codec.forName((String) a[1]) : Codec.getDefault();
         return new ForceMergeAction(maxNumSegments, codec);
     });
 
@@ -68,7 +68,7 @@ public ForceMergeAction(StreamInput in) throws IOException {
         if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
             this.codec = Codec.forName(in.readString());
         } else {
-          this.codec = Codec.getDefault();
+            this.codec = Codec.getDefault();
         }
     }
 
@@ -130,7 +130,8 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
             UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
                 openKey, client, bestCompressionSettings);
             OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
-            WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey, forceMergeKey, ClusterHealthStatus.GREEN);
+            WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
+                forceMergeKey, ClusterHealthStatus.GREEN);
             ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, nextStepKey, client, maxNumSegments);
             return Arrays.asList(closeIndexStep, updateBestCompressionSettings,
                 openIndexStep, waitForIndexGreenStep, forceMergeStep);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 4f899f3b74355..ef88e461c0d13 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -109,7 +109,8 @@ public void testMissingMaxNumSegments() throws IOException {
     }
 
     public void testInvalidNegativeSegmentNumber() {
-        Exception r = expectThrows(IllegalArgumentException.class, () -> new ForceMergeAction(randomIntBetween(-10, 0), Codec.getDefault()));
+        Exception r = expectThrows(IllegalArgumentException.class, () -> new
+            ForceMergeAction(randomIntBetween(-10, 0), Codec.getDefault()));
         assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
     }
 
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 2ee3de617c432..f1de3fe738820 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -10,6 +10,7 @@
 import org.apache.http.entity.StringEntity;
 import org.apache.log4j.LogManager;
 import org.apache.log4j.Logger;
+import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.Response;
 import org.elasticsearch.client.ResponseException;
@@ -411,7 +412,7 @@ public void testForceMergeAction() throws Exception {
         };
         assertThat(numSegments.get(), greaterThan(1));
 
-        createNewSingletonPolicy("warm", new ForceMergeAction(1, false));
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, Codec.getDefault()));
         updatePolicy(index, policy);
 
         assertBusy(() -> {
@@ -1007,7 +1008,7 @@ private void createFullPolicy(TimeValue hotTime) throws IOException {
         hotActions.put(RolloverAction.NAME,  new RolloverAction(null, null, 1L));
         Map<String, LifecycleAction> warmActions = new HashMap<>();
         warmActions.put(SetPriorityAction.NAME, new SetPriorityAction(50));
-        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, false));
+        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, Codec.getDefault()));
         warmActions.put(AllocateAction.NAME, new AllocateAction(1, singletonMap("_name", "integTest-1,integTest-2"), null, null));
         warmActions.put(ShrinkAction.NAME, new ShrinkAction(1));
         Map<String, LifecycleAction> coldActions = new HashMap<>();

From b2236bb014d81e21cadd530b0f7fd6285f677806 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 17 Dec 2019 08:54:29 +0100
Subject: [PATCH 226/686] Better Logging S3 Bulk Delete Failures (#50203)

Unfortunately bulk delete exceptions don't show the individual delete
errors when a bulk delete fails when you log them outright so I added this work-around
to get the individual details to get useful logging.
---
 .../elasticsearch/repositories/s3/S3BlobContainer.java   | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3BlobContainer.java b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3BlobContainer.java
index 6afb81da5e02c..9cb118d60086f 100644
--- a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3BlobContainer.java
+++ b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3BlobContainer.java
@@ -32,6 +32,9 @@
 import com.amazonaws.services.s3.model.PutObjectRequest;
 import com.amazonaws.services.s3.model.UploadPartRequest;
 import com.amazonaws.services.s3.model.UploadPartResult;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.common.Nullable;
@@ -61,6 +64,8 @@
 
 class S3BlobContainer extends AbstractBlobContainer {
 
+    private static final Logger logger = LogManager.getLogger(S3BlobContainer.class);
+
     /**
      * Maximum number of deletes in a {@link DeleteObjectsRequest}.
      * @see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html">S3 Documentation</a>.
@@ -189,6 +194,10 @@ private void doDeleteBlobs(List<String> blobNames, boolean relative) throws IOEx
                         outstanding.removeAll(keysInRequest);
                         outstanding.addAll(
                             e.getErrors().stream().map(MultiObjectDeleteException.DeleteError::getKey).collect(Collectors.toSet()));
+                        logger.warn(
+                            () -> new ParameterizedMessage("Failed to delete some blobs {}", e.getErrors()
+                                .stream().map(err -> "[" + err.getKey() + "][" + err.getCode() + "][" + err.getMessage() + "]")
+                                .collect(Collectors.toList())), e);
                         aex = ExceptionsHelper.useOrSuppress(aex, e);
                     } catch (AmazonClientException e) {
                         // The AWS client threw any unexpected exception and did not execute the request at all so we do not

From bebdbdc8cd7f53f41e1400f4fc668c8fafe11d01 Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Tue, 17 Dec 2019 10:00:54 +0200
Subject: [PATCH 227/686] Handle NULL in ResultSet's getDate() method (#50184)

---
 .../xpack/sql/jdbc/JdbcResultSet.java         | 10 ++--
 .../xpack/sql/qa/jdbc/ResultSetTestCase.java  | 52 +++++++++++++++++++
 2 files changed, 58 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/sql/jdbc/src/main/java/org/elasticsearch/xpack/sql/jdbc/JdbcResultSet.java b/x-pack/plugin/sql/jdbc/src/main/java/org/elasticsearch/xpack/sql/jdbc/JdbcResultSet.java
index 6002ef1496890..71d46ad66d942 100644
--- a/x-pack/plugin/sql/jdbc/src/main/java/org/elasticsearch/xpack/sql/jdbc/JdbcResultSet.java
+++ b/x-pack/plugin/sql/jdbc/src/main/java/org/elasticsearch/xpack/sql/jdbc/JdbcResultSet.java
@@ -259,6 +259,11 @@ public Date getDate(String columnLabel) throws SQLException {
     private Long dateTimeAsMillis(int columnIndex) throws SQLException {
         Object val = column(columnIndex);
         EsType type = columnType(columnIndex);
+        
+        if (val == null) {
+            return null;
+        }
+        
         try {
             // TODO: the B6 appendix of the jdbc spec does mention CHAR, VARCHAR, LONGVARCHAR, DATE, TIMESTAMP as supported
             // jdbc types that should be handled by getDate and getTime methods. From all of those we support VARCHAR and
@@ -267,9 +272,6 @@ private Long dateTimeAsMillis(int columnIndex) throws SQLException {
                 // the cursor can return an Integer if the date-since-epoch is small enough, XContentParser (Jackson) will
                 // return the "smallest" data type for numbers when parsing
                 // TODO: this should probably be handled server side
-                if (val == null) {
-                    return null;
-                }
                 return asDateTimeField(val, JdbcDateUtils::dateTimeAsMillisSinceEpoch, Function.identity());
             }
             if (DATE == type) {
@@ -278,7 +280,7 @@ private Long dateTimeAsMillis(int columnIndex) throws SQLException {
             if (TIME == type) {
                 return timeAsMillisSinceEpoch(val.toString());
             }
-            return val == null ? null : (Long) val;
+            return (Long) val;
         } catch (ClassCastException cce) {
             throw new SQLException(
                     format(Locale.ROOT, "Unable to convert value [%.128s] of type [%s] to a Long", val, type.getName()), cce);
diff --git a/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/jdbc/ResultSetTestCase.java b/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/jdbc/ResultSetTestCase.java
index b842193efc904..e59316ed66fac 100644
--- a/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/jdbc/ResultSetTestCase.java
+++ b/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/jdbc/ResultSetTestCase.java
@@ -1275,6 +1275,54 @@ public void testValidGetObjectCalls() throws Exception {
             assertTrue(results.getObject("test_boolean") instanceof Boolean);
         });
     }
+    
+    public void testGettingNullValues() throws Exception {
+        String query = "SELECT CAST(NULL AS BOOLEAN) b, CAST(NULL AS TINYINT) t, CAST(NULL AS SMALLINT) s, CAST(NULL AS INTEGER) i,"
+                + "CAST(NULL AS BIGINT) bi, CAST(NULL AS DOUBLE) d, CAST(NULL AS REAL) r, CAST(NULL AS FLOAT) f, CAST(NULL AS VARCHAR) v,"
+                + "CAST(NULL AS DATE) dt, CAST(NULL AS TIME) tm, CAST(NULL AS TIMESTAMP) ts";
+        doWithQuery(query, (results) -> {
+            results.next();
+            
+            assertNull(results.getObject("b"));
+            assertFalse(results.getBoolean("b"));
+            
+            assertNull(results.getObject("t"));
+            assertEquals(0, results.getByte("t"));
+            
+            assertNull(results.getObject("s"));
+            assertEquals(0, results.getShort("s"));
+            
+            assertNull(results.getObject("i"));
+            assertEquals(0, results.getInt("i"));
+            
+            assertNull(results.getObject("bi"));
+            assertEquals(0, results.getLong("bi"));
+            
+            assertNull(results.getObject("d"));
+            assertEquals(0.0d, results.getDouble("d"), 0d);
+            
+            assertNull(results.getObject("r"));
+            assertEquals(0.0f, results.getFloat("r"), 0f);
+            
+            assertNull(results.getObject("f"));
+            assertEquals(0.0f, results.getFloat("f"), 0f);
+            
+            assertNull(results.getObject("v"));
+            assertNull(results.getString("v"));
+            
+            assertNull(results.getObject("dt"));
+            assertNull(results.getDate("dt"));
+            assertNull(results.getDate("dt", randomCalendar()));
+            
+            assertNull(results.getObject("tm"));
+            assertNull(results.getTime("tm"));
+            assertNull(results.getTime("tm", randomCalendar()));
+            
+            assertNull(results.getObject("ts"));
+            assertNull(results.getTimestamp("ts"));
+            assertNull(results.getTimestamp("ts", randomCalendar()));
+        });
+    }
 
     /*
      * Checks StackOverflowError fix for https://github.com/elastic/elasticsearch/pull/31735
@@ -1841,4 +1889,8 @@ private String asDateString(long millis) {
     private ZoneId getZoneFromOffset(Long randomLongDate) {
         return ZoneId.of(ZoneId.of(timeZoneId).getRules().getOffset(Instant.ofEpochMilli(randomLongDate)).toString());
     }
+    
+    private Calendar randomCalendar() {
+        return Calendar.getInstance(randomTimeZone(), Locale.ROOT);
+    }
 }

From 812d16a80d417c65e957e31b202d45d33c6e7915 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 17 Dec 2019 09:42:02 +0100
Subject: [PATCH 228/686] Fix Index Deletion During Partial Snapshot Create
 (#50234)

* Fix Index Deletion During Partial Snapshot Create

We can simply filter out shard generation updates for indices
that were removed from the cluster state concurrently to fix
index deletes during partial snapshots as that completely removes
any reference to those shards from the snapshot.

Follow up to #50202
Closes #50200
---
 .../repositories/ShardGenerations.java        |  7 +++
 .../snapshots/SnapshotsService.java           | 24 +++++++---
 .../snapshots/SnapshotResiliencyTests.java    | 46 +++++++++++++++++--
 3 files changed, 66 insertions(+), 11 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/repositories/ShardGenerations.java b/server/src/main/java/org/elasticsearch/repositories/ShardGenerations.java
index 6351d5e2f2bf0..8b7f799d0e7c2 100644
--- a/server/src/main/java/org/elasticsearch/repositories/ShardGenerations.java
+++ b/server/src/main/java/org/elasticsearch/repositories/ShardGenerations.java
@@ -54,6 +54,13 @@ private ShardGenerations(Map<IndexId, List<String>> shardGenerations) {
         this.shardGenerations = shardGenerations;
     }
 
+    /**
+     * Returns the total number of shards tracked by this instance.
+     */
+    public int totalShards() {
+        return shardGenerations.values().stream().mapToInt(List::size).sum();
+    }
+
     /**
      * Returns all indices for which shard generations are tracked.
      *
diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
index 7c638bc332edc..cfb2112b4044d 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
@@ -568,16 +568,17 @@ public void onNoLongerMaster() {
         private void cleanupAfterError(Exception exception) {
             threadPool.generic().execute(() -> {
                 if (snapshotCreated) {
+                    final MetaData metaData = clusterService.state().metaData();
                     repositoriesService.repository(snapshot.snapshot().getRepository())
                         .finalizeSnapshot(snapshot.snapshot().getSnapshotId(),
-                            buildGenerations(snapshot),
+                            buildGenerations(snapshot, metaData),
                             snapshot.startTime(),
                             ExceptionsHelper.stackTrace(exception),
                             0,
                             Collections.emptyList(),
                             snapshot.repositoryStateId(),
                             snapshot.includeGlobalState(),
-                            metaDataForSnapshot(snapshot, clusterService.state().metaData()),
+                            metaDataForSnapshot(snapshot, metaData),
                             snapshot.userMetadata(),
                             snapshot.useShardGenerations(),
                             ActionListener.runAfter(ActionListener.wrap(ignored -> {
@@ -593,11 +594,21 @@ private void cleanupAfterError(Exception exception) {
         }
     }
 
-    private static ShardGenerations buildGenerations(SnapshotsInProgress.Entry snapshot) {
+    private static ShardGenerations buildGenerations(SnapshotsInProgress.Entry snapshot, MetaData metaData) {
         ShardGenerations.Builder builder = ShardGenerations.builder();
         final Map<String, IndexId> indexLookup = new HashMap<>();
         snapshot.indices().forEach(idx -> indexLookup.put(idx.getName(), idx));
-        snapshot.shards().forEach(c -> builder.put(indexLookup.get(c.key.getIndexName()), c.key.id(), c.value.generation()));
+        snapshot.shards().forEach(c -> {
+            if (metaData.index(c.key.getIndex()) == null) {
+                assert snapshot.partial() :
+                    "Index [" + c.key.getIndex() + "] was deleted during a snapshot but snapshot was not partial.";
+                return;
+            }
+            final IndexId indexId = indexLookup.get(c.key.getIndexName());
+            if (indexId != null) {
+                builder.put(indexId, c.key.id(), c.value.generation());
+            }
+        });
         return builder.build();
     }
 
@@ -1032,12 +1043,13 @@ protected void doRun() {
                         shardFailures.add(new SnapshotShardFailure(status.nodeId(), shardId, status.reason()));
                     }
                 }
+                final ShardGenerations shardGenerations = buildGenerations(entry, metaData);
                 repository.finalizeSnapshot(
                     snapshot.getSnapshotId(),
-                    buildGenerations(entry),
+                    shardGenerations,
                     entry.startTime(),
                     failure,
-                    entry.shards().size(),
+                    entry.partial() ? shardGenerations.totalShards() : entry.shards().size(),
                     unmodifiableList(shardFailures),
                     entry.repositoryStateId(),
                     entry.includeGlobalState(),
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
index a0e7e51098681..5fd6624d1d128 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
@@ -21,6 +21,7 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
@@ -143,6 +144,7 @@
 import org.elasticsearch.env.TestEnvironment;
 import org.elasticsearch.gateway.MetaStateService;
 import org.elasticsearch.gateway.TransportNodesListGatewayStartedShards;
+import org.elasticsearch.index.Index;
 import org.elasticsearch.index.analysis.AnalysisRegistry;
 import org.elasticsearch.index.seqno.GlobalCheckpointSyncAction;
 import org.elasticsearch.index.seqno.RetentionLeaseSyncer;
@@ -211,6 +213,7 @@
 import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.instanceOf;
+import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.lessThanOrEqualTo;
 import static org.mockito.Mockito.mock;
 
@@ -503,7 +506,7 @@ public void testConcurrentSnapshotCreateAndDeleteOther() {
         }
     }
 
-    public void testConcurrentSnapshotDeleteAndDeleteIndex() {
+    public void testConcurrentSnapshotDeleteAndDeleteIndex() throws IOException {
         setupTestCluster(randomFrom(1, 3, 5), randomIntBetween(2, 10));
 
         String repoName = "repo";
@@ -514,11 +517,13 @@ public void testConcurrentSnapshotDeleteAndDeleteIndex() {
             testClusterNodes.currentMaster(testClusterNodes.nodes.values().iterator().next().clusterService.state());
 
         final StepListener<Collection<CreateIndexResponse>> createIndicesListener = new StepListener<>();
+        final int indices = randomIntBetween(5, 20);
 
+        final SetOnce<Index> firstIndex = new SetOnce<>();
         continueOrDie(createRepoAndIndex(repoName, index, 1), createIndexResponse -> {
+            firstIndex.set(masterNode.clusterService.state().metaData().index(index).getIndex());
             // create a few more indices to make it more likely that the subsequent index delete operation happens before snapshot
             // finalization
-            final int indices = randomIntBetween(5, 20);
             final GroupedActionListener<CreateIndexResponse> listener = new GroupedActionListener<>(createIndicesListener, indices);
             for (int i = 0; i < indices; ++i) {
                 client().admin().indices().create(new CreateIndexRequest("index-" + i), listener);
@@ -527,23 +532,54 @@ public void testConcurrentSnapshotDeleteAndDeleteIndex() {
 
         final StepListener<CreateSnapshotResponse> createSnapshotResponseStepListener = new StepListener<>();
 
+        final boolean partialSnapshot = randomBoolean();
+
         continueOrDie(createIndicesListener, createIndexResponses ->
             client().admin().cluster().prepareCreateSnapshot(repoName, snapshotName).setWaitForCompletion(false)
-                .execute(createSnapshotResponseStepListener));
+                .setPartial(partialSnapshot).execute(createSnapshotResponseStepListener));
 
         continueOrDie(createSnapshotResponseStepListener,
-            createSnapshotResponse -> client().admin().indices().delete(new DeleteIndexRequest(index), noopListener()));
+            createSnapshotResponse -> client().admin().indices().delete(new DeleteIndexRequest(index), new ActionListener<>() {
+                @Override
+                public void onResponse(AcknowledgedResponse acknowledgedResponse) {
+                    if (partialSnapshot) {
+                        // Recreate index by the same name to test that we don't snapshot conflicting metadata in this scenario
+                        client().admin().indices().create(new CreateIndexRequest(index), noopListener());
+                    }
+                }
+
+                @Override
+                public void onFailure(Exception e) {
+                    if (partialSnapshot) {
+                        throw new AssertionError("Delete index should always work during partial snapshots", e);
+                    }
+                }
+            }));
 
         deterministicTaskQueue.runAllRunnableTasks();
 
         SnapshotsInProgress finalSnapshotsInProgress = masterNode.clusterService.state().custom(SnapshotsInProgress.TYPE);
         assertFalse(finalSnapshotsInProgress.entries().stream().anyMatch(entry -> entry.state().completed() == false));
         final Repository repository = masterNode.repositoriesService.repository(repoName);
-        Collection<SnapshotId> snapshotIds = getRepositoryData(repository).getSnapshotIds();
+        final RepositoryData repositoryData = getRepositoryData(repository);
+        Collection<SnapshotId> snapshotIds = repositoryData.getSnapshotIds();
         assertThat(snapshotIds, hasSize(1));
 
         final SnapshotInfo snapshotInfo = repository.getSnapshotInfo(snapshotIds.iterator().next());
         assertEquals(SnapshotState.SUCCESS, snapshotInfo.state());
+        if (partialSnapshot) {
+            // Single shard for each index so we either get all indices or all except for the deleted index
+            assertThat(snapshotInfo.successfulShards(), either(is(indices + 1)).or(is(indices)));
+            if (snapshotInfo.successfulShards() == indices + 1) {
+                final IndexMetaData indexMetaData =
+                    repository.getSnapshotIndexMetaData(snapshotInfo.snapshotId(), repositoryData.resolveIndexId(index));
+                // Make sure we snapshotted the metadata of this index and not the recreated version
+                assertEquals(indexMetaData.getIndex(), firstIndex.get());
+            }
+        } else {
+            // Index delete must be blocked for non-partial snapshots and we get a snapshot for every index
+            assertEquals(snapshotInfo.successfulShards(), indices + 1);
+        }
         assertEquals(0, snapshotInfo.failedShards());
     }
 

From 7f6644ee2b960376263c820ac810452e6754ee32 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 17 Dec 2019 09:45:52 +0100
Subject: [PATCH 229/686] Use ClusterState as Consistency Source for Snapshot
 Repositories (#49060)

Follow up to #49729

This change removes falling back to listing out the repository contents to find the latest `index-N` in write-mounted blob store repositories.
This saves 2-3 list operations on each snapshot create and delete operation. Also it makes all the snapshot status APIs cheaper (and faster) by saving one list operation there as well in many cases.
This removes the resiliency to concurrent modifications of the repository as a result and puts a repository in a `corrupted` state in case loading `RepositoryData` failed from the assumed generation.
---
 .../repositories/RepositoryData.java          |   5 +
 .../blobstore/BlobStoreRepository.java        | 215 ++++++++++++---
 .../BlobStoreRepositoryRestoreTests.java      |   8 +-
 .../CorruptedBlobStoreRepositoryIT.java       | 247 ++++++++++++++++++
 ...ckEventuallyConsistentRepositoryTests.java |   2 +
 .../AbstractThirdPartyRepositoryTestCase.java |   3 +-
 .../blobstore/BlobStoreTestUtil.java          |  10 +-
 .../SourceOnlySnapshotShardTests.java         |   9 +-
 8 files changed, 449 insertions(+), 50 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java

diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
index 357268fa051e0..63e2957aacc78 100644
--- a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
@@ -58,6 +58,11 @@ public final class RepositoryData {
      */
     public static final long UNKNOWN_REPO_GEN = -2L;
 
+    /**
+     * The generation value indicating that the repository generation could not be determined.
+     */
+    public static final long CORRUPTED_REPO_GEN = -3L;
+
     /**
      * An instance initialized for an empty repository.
      */
diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index b56a22e99845b..b9016394ca514 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -31,6 +31,7 @@
 import org.apache.lucene.store.IndexOutput;
 import org.apache.lucene.store.RateLimiter;
 import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.StepListener;
@@ -184,6 +185,14 @@ public abstract class BlobStoreRepository extends AbstractLifecycleComponent imp
      */
     public static final Setting<Boolean> COMPRESS_SETTING = Setting.boolSetting("compress", true, Setting.Property.NodeScope);
 
+    /**
+     * When set to {@code true}, {@link #bestEffortConsistency} will be set to {@code true} and concurrent modifications of the repository
+     * contents will not result in the repository being marked as corrupted.
+     * Note: This setting is intended as a backwards compatibility solution for 7.x and will go away in 8.
+     */
+    public static final Setting<Boolean> ALLOW_CONCURRENT_MODIFICATION =
+        Setting.boolSetting("allow_concurrent_modifications", false, Setting.Property.Deprecated);
+
     private final boolean compress;
 
     private final RateLimiter snapshotRateLimiter;
@@ -216,6 +225,34 @@ public abstract class BlobStoreRepository extends AbstractLifecycleComponent imp
 
     private final ClusterService clusterService;
 
+    /**
+     * Flag that is set to {@code true} if this instance is started with {@link #metadata} that has a higher value for
+     * {@link RepositoryMetaData#pendingGeneration()} than for {@link RepositoryMetaData#generation()} indicating a full cluster restart
+     * potentially accounting for the the last {@code index-N} write in the cluster state.
+     * Note: While it is true that this value could also be set to {@code true} for an instance on a node that is just joining the cluster
+     * during a new {@code index-N} write, this does not present a problem. The node will still load the correct {@link RepositoryData} in
+     * all cases and simply do a redundant listing of the repository contents if it tries to load {@link RepositoryData} and falls back
+     * to {@link #latestIndexBlobId()} to validate the value of {@link RepositoryMetaData#generation()}.
+     */
+    private boolean uncleanStart;
+
+    /**
+     * This flag indicates that the repository can not exclusively rely on the value stored in {@link #latestKnownRepoGen} to determine the
+     * latest repository generation but must inspect its physical contents as well via {@link #latestIndexBlobId()}.
+     * This flag is set in the following situations:
+     * <ul>
+     *     <li>All repositories that are read-only, i.e. for which {@link #isReadOnly()} returns {@code true} because there are no
+     *     guarantees that another cluster is not writing to the repository at the same time</li>
+     *     <li>The node finds itself in a mixed-version cluster containing nodes older than
+     *     {@link RepositoryMetaData#REPO_GEN_IN_CS_VERSION} where the master node does not update the value of
+     *     {@link RepositoryMetaData#generation()} when writing a new {@code index-N} blob</li>
+     *     <li>The value of {@link RepositoryMetaData#generation()} for this repository is {@link RepositoryData#UNKNOWN_REPO_GEN}
+     *     indicating that no consistent repository generation is tracked in the cluster state yet.</li>
+     *     <li>The {@link #uncleanStart} flag is set to {@code true}</li>
+     * </ul>
+     */
+    private volatile boolean bestEffortConsistency;
+
     /**
      * Constructs new BlobStoreRepository
      * @param metadata   The metadata for this repository including name and settings
@@ -249,6 +286,8 @@ protected BlobStoreRepository(
 
     @Override
     protected void doStart() {
+        uncleanStart = metadata.pendingGeneration() > RepositoryData.EMPTY_REPO_GEN &&
+            metadata.generation() != metadata.pendingGeneration();
         ByteSizeValue chunkSize = chunkSize();
         if (chunkSize != null && chunkSize.getBytes() <= 0) {
             throw new IllegalArgumentException("the chunk size cannot be negative: [" + chunkSize + "]");
@@ -279,29 +318,42 @@ protected void doClose() {
     // #latestKnownRepoGen if a newer than currently known generation is found
     @Override
     public void updateState(ClusterState state) {
-        if (readOnly) {
+        metadata = getRepoMetaData(state);
+        uncleanStart = uncleanStart && metadata.generation() != metadata.pendingGeneration();
+        bestEffortConsistency = uncleanStart || isReadOnly()
+            || state.nodes().getMinNodeVersion().before(RepositoryMetaData.REPO_GEN_IN_CS_VERSION)
+            || metadata.generation() == RepositoryData.UNKNOWN_REPO_GEN || ALLOW_CONCURRENT_MODIFICATION.get(metadata.settings());
+        if (isReadOnly()) {
             // No need to waste cycles, no operations can run against a read-only repository
             return;
         }
-        long bestGenerationFromCS = RepositoryData.EMPTY_REPO_GEN;
-        final SnapshotsInProgress snapshotsInProgress = state.custom(SnapshotsInProgress.TYPE);
-        if (snapshotsInProgress != null) {
-            bestGenerationFromCS = bestGeneration(snapshotsInProgress.entries());
-        }
-        final SnapshotDeletionsInProgress deletionsInProgress = state.custom(SnapshotDeletionsInProgress.TYPE);
-        // Don't use generation from the delete task if we already found a generation for an in progress snapshot.
-        // In this case, the generation points at the generation the repo will be in after the snapshot finishes so it may not yet exist
-        if (bestGenerationFromCS == RepositoryData.EMPTY_REPO_GEN && deletionsInProgress != null) {
-            bestGenerationFromCS = bestGeneration(deletionsInProgress.getEntries());
-        }
-        final RepositoryCleanupInProgress cleanupInProgress = state.custom(RepositoryCleanupInProgress.TYPE);
-        if (bestGenerationFromCS == RepositoryData.EMPTY_REPO_GEN && cleanupInProgress != null) {
-            bestGenerationFromCS = bestGeneration(cleanupInProgress.entries());
+        if (bestEffortConsistency) {
+            long bestGenerationFromCS = RepositoryData.EMPTY_REPO_GEN;
+            final SnapshotsInProgress snapshotsInProgress = state.custom(SnapshotsInProgress.TYPE);
+            if (snapshotsInProgress != null) {
+                bestGenerationFromCS = bestGeneration(snapshotsInProgress.entries());
+            }
+            final SnapshotDeletionsInProgress deletionsInProgress = state.custom(SnapshotDeletionsInProgress.TYPE);
+            // Don't use generation from the delete task if we already found a generation for an in progress snapshot.
+            // In this case, the generation points at the generation the repo will be in after the snapshot finishes so it may not yet
+            // exist
+            if (bestGenerationFromCS == RepositoryData.EMPTY_REPO_GEN && deletionsInProgress != null) {
+                bestGenerationFromCS = bestGeneration(deletionsInProgress.getEntries());
+            }
+            final RepositoryCleanupInProgress cleanupInProgress = state.custom(RepositoryCleanupInProgress.TYPE);
+            if (bestGenerationFromCS == RepositoryData.EMPTY_REPO_GEN && cleanupInProgress != null) {
+                bestGenerationFromCS = bestGeneration(cleanupInProgress.entries());
+            }
+            final long finalBestGen = Math.max(bestGenerationFromCS, metadata.generation());
+            latestKnownRepoGen.updateAndGet(known -> Math.max(known, finalBestGen));
+        } else {
+            final long previousBest = latestKnownRepoGen.getAndSet(metadata.generation());
+            if (previousBest != metadata.generation()) {
+                assert metadata.generation() == RepositoryData.CORRUPTED_REPO_GEN || previousBest < metadata.generation() :
+                    "Illegal move from repository generation [" + previousBest + "] to generation [" + metadata.generation() + "]";
+                logger.debug("Updated repository generation from [{}] to [{}]", previousBest, metadata.generation());
+            }
         }
-
-        metadata = getRepoMetaData(state);
-        final long finalBestGen = Math.max(bestGenerationFromCS, metadata.generation());
-        latestKnownRepoGen.updateAndGet(known -> Math.max(known, finalBestGen));
     }
 
     private long bestGeneration(Collection<? extends RepositoryOperation> operations) {
@@ -446,7 +498,12 @@ public void deleteSnapshot(SnapshotId snapshotId, long repositoryStateId, boolea
      */
     private RepositoryData safeRepositoryData(long repositoryStateId, Map<String, BlobMetaData> rootBlobs) {
         final long generation = latestGeneration(rootBlobs.keySet());
-        final long genToLoad = latestKnownRepoGen.updateAndGet(known -> Math.max(known, repositoryStateId));
+        final long genToLoad;
+        if (bestEffortConsistency) {
+            genToLoad = latestKnownRepoGen.updateAndGet(known -> Math.max(known, repositoryStateId));
+        } else {
+            genToLoad = latestKnownRepoGen.get();
+        }
         if (genToLoad > generation) {
             // It's always a possibility to not see the latest index-N in the listing here on an eventually consistent blob store, just
             // debug log it. Any blobs leaked as a result of an inconsistent listing here will be cleaned up in a subsequent cleanup or
@@ -983,36 +1040,106 @@ public void endVerification(String seed) {
 
     // Tracks the latest known repository generation in a best-effort way to detect inconsistent listing of root level index-N blobs
     // and concurrent modifications.
-    private final AtomicLong latestKnownRepoGen = new AtomicLong(RepositoryData.EMPTY_REPO_GEN);
+    private final AtomicLong latestKnownRepoGen = new AtomicLong(RepositoryData.UNKNOWN_REPO_GEN);
 
     @Override
     public void getRepositoryData(ActionListener<RepositoryData> listener) {
-        ActionListener.completeWith(listener, () -> {
-            // Retry loading RepositoryData in a loop in case we run into concurrent modifications of the repository.
-            while (true) {
+        if (latestKnownRepoGen.get() == RepositoryData.CORRUPTED_REPO_GEN) {
+            listener.onFailure(corruptedStateException(null));
+            return;
+        }
+        // Retry loading RepositoryData in a loop in case we run into concurrent modifications of the repository.
+        while (true) {
+            final long genToLoad;
+            if (bestEffortConsistency) {
+                // We're only using #latestKnownRepoGen as a hint in this mode and listing repo contents as a secondary way of trying
+                // to find a higher generation
                 final long generation;
                 try {
                     generation = latestIndexBlobId();
                 } catch (IOException ioe) {
                     throw new RepositoryException(metadata.name(), "Could not determine repository generation from root blobs", ioe);
                 }
-                final long genToLoad = latestKnownRepoGen.updateAndGet(known -> Math.max(known, generation));
+                genToLoad = latestKnownRepoGen.updateAndGet(known -> Math.max(known, generation));
                 if (genToLoad > generation) {
                     logger.info("Determined repository generation [" + generation
                         + "] from repository contents but correct generation must be at least [" + genToLoad + "]");
                 }
-                try {
-                    return getRepositoryData(genToLoad);
-                } catch (RepositoryException e) {
-                    if (genToLoad != latestKnownRepoGen.get()) {
-                        logger.warn("Failed to load repository data generation [" + genToLoad +
-                            "] because a concurrent operation moved the current generation to [" + latestKnownRepoGen.get() + "]", e);
-                        continue;
-                    }
+            } else {
+                // We only rely on the generation tracked in #latestKnownRepoGen which is exclusively updated from the cluster state
+                genToLoad = latestKnownRepoGen.get();
+            }
+            try {
+                listener.onResponse(getRepositoryData(genToLoad));
+                return;
+            } catch (RepositoryException e) {
+                if (genToLoad != latestKnownRepoGen.get()) {
+                    logger.warn("Failed to load repository data generation [" + genToLoad +
+                        "] because a concurrent operation moved the current generation to [" + latestKnownRepoGen.get() + "]", e);
+                    continue;
+                }
+                if (bestEffortConsistency == false && ExceptionsHelper.unwrap(e, NoSuchFileException.class) != null) {
+                    // We did not find the expected index-N even though the cluster state continues to point at the missing value
+                    // of N so we mark this repository as corrupted.
+                    markRepoCorrupted(genToLoad, e,
+                        ActionListener.wrap(v -> listener.onFailure(corruptedStateException(e)), listener::onFailure));
+                    return;
+                } else {
                     throw e;
                 }
             }
-        });
+        }
+    }
+
+    private RepositoryException corruptedStateException(@Nullable Exception cause) {
+        return new RepositoryException(metadata.name(),
+            "Could not read repository data because the contents of the repository do not match its " +
+                "expected state. This is likely the result of either concurrently modifying the contents of the " +
+                "repository by a process other than this cluster or an issue with the repository's underlying" +
+                "storage. The repository has been disabled to prevent corrupting its contents. To re-enable it " +
+                "and continue using it please remove the repository from the cluster and add it again to make " +
+                "the cluster recover the known state of the repository from its physical contents.", cause);
+    }
+
+    /**
+     * Marks the repository as corrupted. This puts the repository in a state where its tracked value for
+     * {@link RepositoryMetaData#pendingGeneration()} is unchanged while its value for {@link RepositoryMetaData#generation()} is set to
+     * {@link RepositoryData#CORRUPTED_REPO_GEN}. In this state, the repository can not be used any longer and must be removed and
+     * recreated after the problem that lead to it being marked as corrupted has been fixed.
+     *
+     * @param corruptedGeneration generation that failed to load because the index file was not found but that should have loaded
+     * @param originalException   exception that lead to the failing to load the {@code index-N} blob
+     * @param listener            listener to invoke once done
+     */
+    private void markRepoCorrupted(long corruptedGeneration, Exception originalException, ActionListener<Void> listener) {
+        assert corruptedGeneration != RepositoryData.UNKNOWN_REPO_GEN;
+        assert bestEffortConsistency == false;
+        clusterService.submitStateUpdateTask("mark repository corrupted [" + metadata.name() + "][" + corruptedGeneration + "]",
+            new ClusterStateUpdateTask() {
+                @Override
+                public ClusterState execute(ClusterState currentState) {
+                    final RepositoriesMetaData state = currentState.metaData().custom(RepositoriesMetaData.TYPE);
+                    final RepositoryMetaData repoState = state.repository(metadata.name());
+                    if (repoState.generation() != corruptedGeneration) {
+                        throw new IllegalStateException("Tried to mark repo generation [" + corruptedGeneration
+                            + "] as corrupted but its state concurrently changed to [" + repoState + "]");
+                    }
+                    return ClusterState.builder(currentState).metaData(MetaData.builder(currentState.metaData()).putCustom(
+                        RepositoriesMetaData.TYPE, state.withUpdatedGeneration(
+                            metadata.name(), RepositoryData.CORRUPTED_REPO_GEN, repoState.pendingGeneration())).build()).build();
+                }
+
+                @Override
+                public void onFailure(String source, Exception e) {
+                    listener.onFailure(new RepositoryException(metadata.name(), "Failed marking repository state as corrupted",
+                        ExceptionsHelper.useOrSuppress(e, originalException)));
+                }
+
+                @Override
+                public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
+                    listener.onResponse(null);
+                }
+            });
     }
 
     private RepositoryData getRepositoryData(long indexGen) {
@@ -1029,11 +1156,13 @@ private RepositoryData getRepositoryData(long indexGen) {
                 return RepositoryData.snapshotsFromXContent(parser, indexGen);
             }
         } catch (IOException ioe) {
-            // If we fail to load the generation we tracked in latestKnownRepoGen we reset it.
-            // This is done as a fail-safe in case a user manually deletes the contents of the repository in which case subsequent
-            // operations must start from the EMPTY_REPO_GEN again
-            if (latestKnownRepoGen.compareAndSet(indexGen, RepositoryData.EMPTY_REPO_GEN)) {
-                logger.warn("Resetting repository generation tracker because we failed to read generation [" + indexGen + "]", ioe);
+            if (bestEffortConsistency) {
+                // If we fail to load the generation we tracked in latestKnownRepoGen we reset it.
+                // This is done as a fail-safe in case a user manually deletes the contents of the repository in which case subsequent
+                // operations must start from the EMPTY_REPO_GEN again
+                if (latestKnownRepoGen.compareAndSet(indexGen, RepositoryData.EMPTY_REPO_GEN)) {
+                    logger.warn("Resetting repository generation tracker because we failed to read generation [" + indexGen + "]", ioe);
+                }
             }
             throw new RepositoryException(metadata.name(), "could not read repository data from index blob", ioe);
         }
@@ -1085,13 +1214,12 @@ public ClusterState execute(ClusterState currentState) {
                     final RepositoryMetaData meta = getRepoMetaData(currentState);
                     final String repoName = metadata.name();
                     final long genInState = meta.generation();
-                    // TODO: Remove all usages of this variable, instead initialize the generation when loading RepositoryData
-                    final boolean uninitializedMeta = meta.generation() == RepositoryData.UNKNOWN_REPO_GEN;
+                    final boolean uninitializedMeta = meta.generation() == RepositoryData.UNKNOWN_REPO_GEN || bestEffortConsistency;
                     if (uninitializedMeta == false && meta.pendingGeneration() != genInState) {
                         logger.info("Trying to write new repository data over unfinished write, repo [{}] is at " +
                             "safe generation [{}] and pending generation [{}]", meta.name(), genInState, meta.pendingGeneration());
                     }
-                    assert expectedGen == RepositoryData.EMPTY_REPO_GEN || RepositoryData.UNKNOWN_REPO_GEN == meta.generation()
+                    assert expectedGen == RepositoryData.EMPTY_REPO_GEN || uninitializedMeta
                         || expectedGen == meta.generation() :
                         "Expected non-empty generation [" + expectedGen + "] does not match generation tracked in [" + meta + "]";
                     // If we run into the empty repo generation for the expected gen, the repo is assumed to have been cleared of
@@ -1102,7 +1230,8 @@ public ClusterState execute(ClusterState currentState) {
                     // even if a repository has been manually cleared of all contents we will never reuse the same repository generation.
                     // This is motivated by the consistency behavior the S3 based blob repository implementation has to support which does
                     // not offer any consistency guarantees when it comes to overwriting the same blob name with different content.
-                    newGen = uninitializedMeta ? expectedGen + 1: metadata.pendingGeneration() + 1;
+                    final long nextPendingGen = metadata.pendingGeneration() + 1;
+                    newGen = uninitializedMeta ? Math.max(expectedGen + 1, nextPendingGen) : nextPendingGen;
                     assert newGen > latestKnownRepoGen.get() : "Attempted new generation [" + newGen +
                         "] must be larger than latest known generation [" + latestKnownRepoGen.get() + "]";
                     return ClusterState.builder(currentState).metaData(MetaData.builder(currentState.getMetaData())
diff --git a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
index 432091b81e1ec..40e17a81be40f 100644
--- a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryRestoreTests.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.cluster.routing.RecoverySource;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.routing.ShardRoutingHelper;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.internal.io.IOUtils;
@@ -193,13 +194,16 @@ public void testSnapshotWithConflictingName() throws IOException {
     private Repository createRepository() {
         Settings settings = Settings.builder().put("location", randomAlphaOfLength(10)).build();
         RepositoryMetaData repositoryMetaData = new RepositoryMetaData(randomAlphaOfLength(10), FsRepository.TYPE, settings);
-        final FsRepository repository = new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(),
-                                                         BlobStoreTestUtil.mockClusterService(repositoryMetaData)) {
+        final ClusterService clusterService = BlobStoreTestUtil.mockClusterService(repositoryMetaData);
+        final FsRepository repository = new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(), clusterService) {
             @Override
             protected void assertSnapshotOrGenericThread() {
                 // eliminate thread name check as we create repo manually
             }
         };
+        clusterService.addStateApplier(event -> repository.updateState(event.state()));
+        // Apply state once to initialize repo properly like RepositoriesService would
+        repository.updateState(clusterService.state());
         repository.start();
         return repository;
     }
diff --git a/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java b/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
new file mode 100644
index 0000000000000..2a860eda3f972
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
@@ -0,0 +1,247 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.snapshots;
+
+import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotResponse;
+import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateUpdateTask;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.metadata.RepositoriesMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.ByteSizeUnit;
+import org.elasticsearch.repositories.RepositoriesService;
+import org.elasticsearch.repositories.Repository;
+import org.elasticsearch.repositories.RepositoryData;
+import org.elasticsearch.repositories.RepositoryException;
+import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
+
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.greaterThan;
+import static org.hamcrest.Matchers.is;
+
+public class CorruptedBlobStoreRepositoryIT extends AbstractSnapshotIntegTestCase {
+
+    public void testConcurrentlyChangeRepositoryContents() throws Exception {
+        Client client = client();
+
+        Path repo = randomRepoPath();
+        final String repoName = "test-repo";
+        logger.info("-->  creating repository at {}", repo.toAbsolutePath());
+        assertAcked(client.admin().cluster().preparePutRepository(repoName)
+            .setType("fs").setSettings(Settings.builder()
+                .put("location", repo)
+                .put("compress", false)
+                .put("chunk_size", randomIntBetween(100, 1000), ByteSizeUnit.BYTES)));
+
+        createIndex("test-idx-1", "test-idx-2");
+        logger.info("--> indexing some data");
+        indexRandom(true,
+            client().prepareIndex("test-idx-1").setSource("foo", "bar"),
+            client().prepareIndex("test-idx-2").setSource("foo", "bar"));
+
+        final String snapshot = "test-snap";
+
+        logger.info("--> creating snapshot");
+        CreateSnapshotResponse createSnapshotResponse = client.admin().cluster().prepareCreateSnapshot(repoName, snapshot)
+            .setWaitForCompletion(true).setIndices("test-idx-*").get();
+        assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(), greaterThan(0));
+        assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(),
+            equalTo(createSnapshotResponse.getSnapshotInfo().totalShards()));
+
+        logger.info("--> move index-N blob to next generation");
+        final RepositoryData repositoryData =
+            getRepositoryData(internalCluster().getMasterNodeInstance(RepositoriesService.class).repository(repoName));
+        Files.move(repo.resolve("index-" + repositoryData.getGenId()), repo.resolve("index-" + (repositoryData.getGenId() + 1)));
+
+        assertRepositoryBlocked(client, repoName, snapshot);
+
+        if (randomBoolean()) {
+            logger.info("--> move index-N blob back to initial generation");
+            Files.move(repo.resolve("index-" + (repositoryData.getGenId() + 1)), repo.resolve("index-" + repositoryData.getGenId()));
+
+            logger.info("--> verify repository remains blocked");
+            assertRepositoryBlocked(client, repoName, snapshot);
+        }
+
+        logger.info("--> remove repository");
+        assertAcked(client.admin().cluster().prepareDeleteRepository(repoName));
+
+        logger.info("--> recreate repository");
+        assertAcked(client.admin().cluster().preparePutRepository(repoName)
+            .setType("fs").setSettings(Settings.builder()
+                .put("location", repo)
+                .put("compress", false)
+                .put("chunk_size", randomIntBetween(100, 1000), ByteSizeUnit.BYTES)));
+
+        logger.info("--> delete snapshot");
+        client.admin().cluster().prepareDeleteSnapshot(repoName, snapshot).get();
+
+        logger.info("--> make sure snapshot doesn't exist");
+        expectThrows(SnapshotMissingException.class, () -> client.admin().cluster().prepareGetSnapshots(repoName)
+            .addSnapshots(snapshot).get().getSnapshots(repoName));
+    }
+
+    public void testConcurrentlyChangeRepositoryContentsInBwCMode() throws Exception {
+        Client client = client();
+
+        Path repo = randomRepoPath();
+        final String repoName = "test-repo";
+        logger.info("-->  creating repository at {}", repo.toAbsolutePath());
+        assertAcked(client.admin().cluster().preparePutRepository(repoName)
+            .setType("fs").setSettings(Settings.builder()
+                .put("location", repo)
+                .put("compress", false)
+                .put(BlobStoreRepository.ALLOW_CONCURRENT_MODIFICATION.getKey(), true)
+                .put("chunk_size", randomIntBetween(100, 1000), ByteSizeUnit.BYTES)));
+
+        createIndex("test-idx-1", "test-idx-2");
+        logger.info("--> indexing some data");
+        indexRandom(true,
+            client().prepareIndex("test-idx-1").setSource("foo", "bar"),
+            client().prepareIndex("test-idx-2").setSource("foo", "bar"));
+
+        final String snapshot = "test-snap";
+
+        logger.info("--> creating snapshot");
+        CreateSnapshotResponse createSnapshotResponse = client.admin().cluster().prepareCreateSnapshot(repoName, snapshot)
+            .setWaitForCompletion(true).setIndices("test-idx-*").get();
+        assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(), greaterThan(0));
+        assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(),
+            equalTo(createSnapshotResponse.getSnapshotInfo().totalShards()));
+
+        final Repository repository = internalCluster().getMasterNodeInstance(RepositoriesService.class).repository(repoName);
+
+        logger.info("--> move index-N blob to next generation");
+        final RepositoryData repositoryData = getRepositoryData(repository);
+        final long beforeMoveGen = repositoryData.getGenId();
+        Files.move(repo.resolve("index-" + beforeMoveGen), repo.resolve("index-" + (beforeMoveGen + 1)));
+
+        logger.info("--> verify index-N blob is found at the new location");
+        assertThat(getRepositoryData(repository).getGenId(), is(beforeMoveGen + 1));
+
+        logger.info("--> delete snapshot");
+        client.admin().cluster().prepareDeleteSnapshot(repoName, snapshot).get();
+
+        logger.info("--> verify index-N blob is found at the expected location");
+        assertThat(getRepositoryData(repository).getGenId(), is(beforeMoveGen + 2));
+
+        logger.info("--> make sure snapshot doesn't exist");
+        expectThrows(SnapshotMissingException.class, () -> client.admin().cluster().prepareGetSnapshots(repoName)
+            .addSnapshots(snapshot).get().getSnapshots(repoName));
+    }
+
+    public void testFindDanglingLatestGeneration() throws Exception {
+        Path repo = randomRepoPath();
+        final String repoName = "test-repo";
+        logger.info("-->  creating repository at {}", repo.toAbsolutePath());
+        assertAcked(client().admin().cluster().preparePutRepository(repoName)
+            .setType("fs").setSettings(Settings.builder()
+                .put("location", repo)
+                .put("compress", false)
+                .put("chunk_size", randomIntBetween(100, 1000), ByteSizeUnit.BYTES)));
+
+        createIndex("test-idx-1", "test-idx-2");
+        logger.info("--> indexing some data");
+        indexRandom(true,
+            client().prepareIndex("test-idx-1").setSource("foo", "bar"),
+            client().prepareIndex("test-idx-2").setSource("foo", "bar"));
+
+        final String snapshot = "test-snap";
+
+        logger.info("--> creating snapshot");
+        CreateSnapshotResponse createSnapshotResponse = client().admin().cluster().prepareCreateSnapshot(repoName, snapshot)
+            .setWaitForCompletion(true).setIndices("test-idx-*").get();
+        assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(), greaterThan(0));
+        assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(),
+            equalTo(createSnapshotResponse.getSnapshotInfo().totalShards()));
+
+        final Repository repository = internalCluster().getCurrentMasterNodeInstance(RepositoriesService.class).repository(repoName);
+
+        logger.info("--> move index-N blob to next generation");
+        final RepositoryData repositoryData = getRepositoryData(repository);
+        final long beforeMoveGen = repositoryData.getGenId();
+        Files.move(repo.resolve("index-" + beforeMoveGen), repo.resolve("index-" + (beforeMoveGen + 1)));
+
+        logger.info("--> set next generation as pending in the cluster state");
+        final PlainActionFuture<Void> csUpdateFuture = PlainActionFuture.newFuture();
+        internalCluster().getCurrentMasterNodeInstance(ClusterService.class).submitStateUpdateTask("set pending generation",
+            new ClusterStateUpdateTask() {
+                @Override
+                public ClusterState execute(ClusterState currentState) {
+                    return ClusterState.builder(currentState).metaData(MetaData.builder(currentState.getMetaData())
+                        .putCustom(RepositoriesMetaData.TYPE,
+                            currentState.metaData().<RepositoriesMetaData>custom(RepositoriesMetaData.TYPE).withUpdatedGeneration(
+                                repository.getMetadata().name(), beforeMoveGen, beforeMoveGen + 1)).build()).build();
+                }
+
+                @Override
+                public void onFailure(String source, Exception e) {
+                    csUpdateFuture.onFailure(e);
+                }
+
+                @Override
+                public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
+                    csUpdateFuture.onResponse(null);
+                }
+            }
+        );
+        csUpdateFuture.get();
+
+        logger.info("--> full cluster restart");
+        internalCluster().fullRestart();
+        ensureGreen();
+
+        Repository repositoryAfterRestart = internalCluster().getCurrentMasterNodeInstance(RepositoriesService.class).repository(repoName);
+
+        logger.info("--> verify index-N blob is found at the new location");
+        assertThat(getRepositoryData(repositoryAfterRestart).getGenId(), is(beforeMoveGen + 1));
+
+        logger.info("--> delete snapshot");
+        client().admin().cluster().prepareDeleteSnapshot(repoName, snapshot).get();
+
+        logger.info("--> verify index-N blob is found at the expected location");
+        assertThat(getRepositoryData(repositoryAfterRestart).getGenId(), is(beforeMoveGen + 2));
+
+        logger.info("--> make sure snapshot doesn't exist");
+        expectThrows(SnapshotMissingException.class, () -> client().admin().cluster().prepareGetSnapshots(repoName)
+            .addSnapshots(snapshot).get().getSnapshots(repoName));
+    }
+
+    private void assertRepositoryBlocked(Client client, String repo, String existingSnapshot) {
+        logger.info("--> try to delete snapshot");
+        final RepositoryException repositoryException3 = expectThrows(RepositoryException.class,
+            () -> client.admin().cluster().prepareDeleteSnapshot(repo, existingSnapshot).execute().actionGet());
+        assertThat(repositoryException3.getMessage(),
+            containsString("Could not read repository data because the contents of the repository do not match its expected state."));
+
+        logger.info("--> try to create snapshot");
+        final RepositoryException repositoryException4 = expectThrows(RepositoryException.class,
+            () -> client.admin().cluster().prepareCreateSnapshot(repo, existingSnapshot).execute().actionGet());
+        assertThat(repositoryException4.getMessage(),
+            containsString("Could not read repository data because the contents of the repository do not match its expected state."));
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
index 47e2626a3b7f3..7443eaded77a7 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/mockstore/MockEventuallyConsistentRepositoryTests.java
@@ -140,6 +140,8 @@ public void testOverwriteSnapshotInfoBlob() {
         try (BlobStoreRepository repository =
                  new MockEventuallyConsistentRepository(metaData, xContentRegistry(), clusterService, blobStoreContext, random())) {
             clusterService.addStateApplier(event -> repository.updateState(event.state()));
+            // Apply state once to initialize repo properly like RepositoriesService would
+            repository.updateState(clusterService.state());
             repository.start();
 
             // We create a snap- blob for snapshot "foo" in the first generation
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/AbstractThirdPartyRepositoryTestCase.java b/test/framework/src/main/java/org/elasticsearch/repositories/AbstractThirdPartyRepositoryTestCase.java
index c6e76ac7174ed..efc0e653edf5c 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/AbstractThirdPartyRepositoryTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/AbstractThirdPartyRepositoryTestCase.java
@@ -76,6 +76,7 @@ public void setUp() throws Exception {
     @Override
     public void tearDown() throws Exception {
         deleteAndAssertEmpty(getRepository().basePath());
+        client().admin().cluster().prepareDeleteRepository("test-repo").get();
         super.tearDown();
     }
 
@@ -169,8 +170,6 @@ protected void assertBlobsByPrefix(BlobPath path, String prefix, Map<String, Blo
     }
 
     public void testCleanup() throws Exception {
-        createRepository("test-repo");
-
         createIndex("test-idx-1");
         createIndex("test-idx-2");
         createIndex("test-idx-3");
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
index 12130a1dd330a..75a2f70cd4f89 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.repositories.blobstore;
 
 import org.apache.lucene.util.SameThreadExecutorService;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.ClusterChangedEvent;
@@ -29,6 +30,8 @@
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoriesMetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
+import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.cluster.service.ClusterApplierService;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
@@ -69,6 +72,7 @@
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.stream.Collectors;
 
+import static org.elasticsearch.test.ESTestCase.buildNewFakeTransportAddress;
 import static org.elasticsearch.test.ESTestCase.randomIntBetween;
 import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.empty;
@@ -326,7 +330,11 @@ private static ClusterService mockClusterService(ClusterState initialState) {
         final ClusterService clusterService = mock(ClusterService.class);
         final ClusterApplierService clusterApplierService = mock(ClusterApplierService.class);
         when(clusterService.getClusterApplierService()).thenReturn(clusterApplierService);
-        final AtomicReference<ClusterState> currentState = new AtomicReference<>(initialState);
+        // Setting local node as master so it may update the repository metadata in the cluster state
+        final DiscoveryNode localNode = new DiscoveryNode("", buildNewFakeTransportAddress(), Version.CURRENT);
+        final AtomicReference<ClusterState> currentState = new AtomicReference<>(
+            ClusterState.builder(initialState).nodes(
+                DiscoveryNodes.builder().add(localNode).masterNodeId(localNode.getId()).localNodeId(localNode.getId()).build()).build());
         when(clusterService.state()).then(invocationOnMock -> currentState.get());
         final List<ClusterStateApplier> appliers = new CopyOnWriteArrayList<>();
         doAnswer(invocation -> {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
index dba66e0b1b1db..bf6512cc531e2 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotShardTests.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.routing.ShardRoutingState;
 import org.elasticsearch.cluster.routing.TestShardRouting;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.lucene.uid.Versions;
@@ -352,8 +353,12 @@ private Environment createEnvironment() {
     private Repository createRepository() {
         Settings settings = Settings.builder().put("location", randomAlphaOfLength(10)).build();
         RepositoryMetaData repositoryMetaData = new RepositoryMetaData(randomAlphaOfLength(10), FsRepository.TYPE, settings);
-        return new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(),
-            BlobStoreTestUtil.mockClusterService(repositoryMetaData));
+        final ClusterService clusterService = BlobStoreTestUtil.mockClusterService(repositoryMetaData);
+        final Repository repository = new FsRepository(repositoryMetaData, createEnvironment(), xContentRegistry(), clusterService);
+        clusterService.addStateApplier(e -> repository.updateState(e.state()));
+        // Apply state once to initialize repo properly like RepositoriesService would
+        repository.updateState(clusterService.state());
+        return repository;
     }
 
     private static void runAsSnapshot(ThreadPool pool, Runnable runnable) {

From f2045ab938bc0f79680978e511a6fa5b574bd5cc Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Tue, 17 Dec 2019 11:26:50 +0100
Subject: [PATCH 230/686] Fix ingest simulate response document order if
 processor executes async (#50244)

If a processor executes asynchronously and the ingest simulate api simulates with
multiple documents then the order of the documents in the response may not match
the order of the documents in the request.

Alexander Reelsen discovered this issue with the enrich processor with the following reproduction:

```
PUT cities/_doc/munich
{"zip":"80331","city":"Munich"}

PUT cities/_doc/berlin
{"zip":"10965","city":"Berlin"}

PUT /_enrich/policy/zip-policy
{
  "match": {
    "indices": "cities",
    "match_field": "zip",
    "enrich_fields": [ "city" ]
  }
}

POST /_enrich/policy/zip-policy/_execute

GET _cat/indices/.enrich-*

POST /_ingest/pipeline/_simulate
{
  "pipeline": {
  "processors" : [
    {
      "enrich" : {
        "policy_name": "zip-policy",
        "field" : "zip",
        "target_field": "city",
        "max_matches": "1"
      }
    }
  ]
  },
  "docs": [
    { "_id": "first", "_source" : { "zip" : "80331" } } ,
    { "_id": "second", "_source" : { "zip" : "50667" } }
  ]
}
```
---
 .../ingest/SimulateExecutionService.java      |  8 ++-
 .../ingest/SimulateExecutionServiceTests.java | 62 +++++++++++++++++++
 .../action/EnrichCoordinatorProxyAction.java  |  5 +-
 3 files changed, 72 insertions(+), 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/ingest/SimulateExecutionService.java b/server/src/main/java/org/elasticsearch/action/ingest/SimulateExecutionService.java
index 79de0d0c2a7fd..09bba6eb0da07 100644
--- a/server/src/main/java/org/elasticsearch/action/ingest/SimulateExecutionService.java
+++ b/server/src/main/java/org/elasticsearch/action/ingest/SimulateExecutionService.java
@@ -67,17 +67,21 @@ void executeDocument(Pipeline pipeline, IngestDocument ingestDocument, boolean v
     public void execute(SimulatePipelineRequest.Parsed request, ActionListener<SimulatePipelineResponse> listener) {
         threadPool.executor(THREAD_POOL_NAME).execute(ActionRunnable.wrap(listener, l -> {
             final AtomicInteger counter = new AtomicInteger();
-            final List<SimulateDocumentResult> responses = new CopyOnWriteArrayList<>();
+            final List<SimulateDocumentResult> responses =
+                new CopyOnWriteArrayList<>(new SimulateDocumentBaseResult[request.getDocuments().size()]);
+            int iter = 0;
             for (IngestDocument ingestDocument : request.getDocuments()) {
+                final int index = iter;
                 executeDocument(request.getPipeline(), ingestDocument, request.isVerbose(), (response, e) -> {
                     if (response != null) {
-                        responses.add(response);
+                        responses.set(index, response);
                     }
                     if (counter.incrementAndGet() == request.getDocuments().size()) {
                         l.onResponse(new SimulatePipelineResponse(request.getPipeline().getId(),
                             request.isVerbose(), responses));
                     }
                 });
+                iter++;
             }
         }));
     }
diff --git a/server/src/test/java/org/elasticsearch/action/ingest/SimulateExecutionServiceTests.java b/server/src/test/java/org/elasticsearch/action/ingest/SimulateExecutionServiceTests.java
index 2ced9d1e23dd2..7276ef2ebada4 100644
--- a/server/src/test/java/org/elasticsearch/action/ingest/SimulateExecutionServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/action/ingest/SimulateExecutionServiceTests.java
@@ -19,6 +19,9 @@
 
 package org.elasticsearch.action.ingest;
 
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.index.VersionType;
+import org.elasticsearch.ingest.AbstractProcessor;
 import org.elasticsearch.ingest.CompoundProcessor;
 import org.elasticsearch.ingest.DropProcessor;
 import org.elasticsearch.ingest.IngestDocument;
@@ -29,17 +32,24 @@
 import org.elasticsearch.ingest.TestProcessor;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.threadpool.TestThreadPool;
+import org.elasticsearch.threadpool.ThreadPool;
 import org.junit.After;
 import org.junit.Before;
 
+import java.util.ArrayList;
 import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicReference;
+import java.util.function.BiConsumer;
 
 import static org.elasticsearch.ingest.IngestDocumentMatcher.assertIngestDocument;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.instanceOf;
+import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.nullValue;
@@ -330,4 +340,56 @@ public void testDropDocumentVerboseExtraProcessor() throws Exception {
         assertThat(verboseResult.getProcessorResults().get(1).getFailure(), nullValue());
     }
 
+    public void testAsyncSimulation() throws Exception {
+        int numDocs = randomIntBetween(1, 64);
+        List<IngestDocument> documents = new ArrayList<>(numDocs);
+        for (int id = 0; id < numDocs; id++) {
+            documents.add(new IngestDocument("_index", Integer.toString(id), null, 0L, VersionType.INTERNAL, new HashMap<>()));
+        }
+        Processor processor1 = new AbstractProcessor(null) {
+
+            @Override
+            public void execute(IngestDocument ingestDocument, BiConsumer<IngestDocument, Exception> handler) {
+                threadPool.executor(ThreadPool.Names.GENERIC).execute(() -> {
+                    ingestDocument.setFieldValue("processed", true);
+                    handler.accept(ingestDocument, null);
+                });
+            }
+
+            @Override
+            public IngestDocument execute(IngestDocument ingestDocument) throws Exception {
+                throw new UnsupportedOperationException();
+            }
+
+            @Override
+            public String getType() {
+                return "none-of-your-business";
+            }
+        };
+        Pipeline pipeline = new Pipeline("_id", "_description", version, new CompoundProcessor(processor1));
+        SimulatePipelineRequest.Parsed request = new SimulatePipelineRequest.Parsed(pipeline, documents, false);
+
+        AtomicReference<SimulatePipelineResponse> responseHolder = new AtomicReference<>();
+        AtomicReference<Exception> errorHolder = new AtomicReference<>();
+        CountDownLatch latch = new CountDownLatch(1);
+        executionService.execute(request, ActionListener.wrap(response -> {
+            responseHolder.set(response);
+            latch.countDown();
+        }, e -> {
+            errorHolder.set(e);
+            latch.countDown();
+        }));
+        latch.await(1, TimeUnit.MINUTES);
+        assertThat(errorHolder.get(), nullValue());
+        SimulatePipelineResponse response = responseHolder.get();
+        assertThat(response, notNullValue());
+        assertThat(response.getResults().size(), equalTo(numDocs));
+
+        for (int id = 0; id < numDocs; id++) {
+            SimulateDocumentBaseResult result = (SimulateDocumentBaseResult) response.getResults().get(id);
+            assertThat(result.getIngestDocument().getMetadata().get(IngestDocument.MetaData.ID), equalTo(Integer.toString(id)));
+            assertThat(result.getIngestDocument().getSourceAndMetadata().get("processed"), is(true));
+        }
+    }
+
 }
diff --git a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/EnrichCoordinatorProxyAction.java b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/EnrichCoordinatorProxyAction.java
index add1a90c21a60..e285c8fef233e 100644
--- a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/EnrichCoordinatorProxyAction.java
+++ b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/EnrichCoordinatorProxyAction.java
@@ -63,7 +63,10 @@ public TransportAction(TransportService transportService, ActionFilters actionFi
 
         @Override
         protected void doExecute(Task task, SearchRequest request, ActionListener<SearchResponse> listener) {
-            assert Thread.currentThread().getName().contains(ThreadPool.Names.WRITE);
+            // Write tp is expected when executing enrich processor from index / bulk api
+            // Management tp is expected when executing enrich processor from ingest simulate api
+            assert Thread.currentThread().getName().contains(ThreadPool.Names.WRITE)
+                || Thread.currentThread().getName().contains(ThreadPool.Names.MANAGEMENT);
             coordinator.schedule(request, listener);
         }
     }

From fe0850738d2e1b46c3abd46df5638dc8a0bdc1d2 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 17 Dec 2019 13:51:51 +0100
Subject: [PATCH 231/686] Simplify InternalTestCluster.fullRestart (#50218)

With node ordinals gone, there's no longer a need for such a complicated full cluster restart
procedure (as we can now uniquely associate nodes to data folders).

Follow-up to #41652
---
 .../test/InternalTestCluster.java             | 38 +++++--------------
 1 file changed, 9 insertions(+), 29 deletions(-)

diff --git a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
index 9b609040379eb..fe9cc9f8449f6 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
@@ -53,6 +53,7 @@
 import org.elasticsearch.cluster.routing.allocation.decider.ThrottlingAllocationDecider;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.breaker.CircuitBreaker;
 import org.elasticsearch.common.component.LifecycleListener;
@@ -1729,50 +1730,29 @@ private void removeExclusions(Set<String> excludedNodeIds) {
     public synchronized void fullRestart(RestartCallback callback) throws Exception {
         int numNodesRestarted = 0;
         final Settings[] newNodeSettings = new Settings[nextNodeId.get()];
-        Map<Set<DiscoveryNodeRole>, List<NodeAndClient>> nodesByRoles = new HashMap<>();
-        Set[] rolesOrderedByOriginalStartupOrder = new Set[nextNodeId.get()];
-        final int nodeCount = nodes.size();
+        final List<NodeAndClient> toStartAndPublish = new ArrayList<>(); // we want to start nodes in one go
         for (NodeAndClient nodeAndClient : nodes.values()) {
             callback.doAfterNodes(numNodesRestarted++, nodeAndClient.nodeClient());
             logger.info("Stopping and resetting node [{}] ", nodeAndClient.name);
             if (activeDisruptionScheme != null) {
                 activeDisruptionScheme.removeFromNode(nodeAndClient.name, this);
             }
-            DiscoveryNode discoveryNode = getInstanceFromNode(ClusterService.class, nodeAndClient.node()).localNode();
             final Settings newSettings = nodeAndClient.closeForRestart(callback);
             newNodeSettings[nodeAndClient.nodeAndClientId()] = newSettings;
-            rolesOrderedByOriginalStartupOrder[nodeAndClient.nodeAndClientId()] = discoveryNode.getRoles();
-            nodesByRoles.computeIfAbsent(discoveryNode.getRoles(), k -> new ArrayList<>()).add(nodeAndClient);
+            toStartAndPublish.add(nodeAndClient);
         }
 
         callback.onAllNodesStopped();
 
-        assert nodesByRoles.values().stream().mapToInt(List::size).sum() == nodeCount;
+        // randomize start up order
+        Randomness.shuffle(toStartAndPublish);
 
-        // randomize start up order, but making sure that:
-        // 1) A data folder that was assigned to a data node will stay so
-        // 2) Data nodes will get the same node lock ordinal range, so custom index paths (where the ordinal is used)
-        //    will still belong to data nodes
-        for (List<NodeAndClient> sameRoleNodes : nodesByRoles.values()) {
-            Collections.shuffle(sameRoleNodes, random);
-        }
-        final List<NodeAndClient> startUpOrder = new ArrayList<>();
-        for (Set roles : rolesOrderedByOriginalStartupOrder) {
-            if (roles == null) {
-                // if some nodes were stopped, we want have a role for that ordinal
-                continue;
-            }
-            final List<NodeAndClient> nodesByRole = nodesByRoles.get(roles);
-            startUpOrder.add(nodesByRole.remove(0));
+        for (NodeAndClient nodeAndClient : toStartAndPublish) {
+            logger.info("recreating node [{}] ", nodeAndClient.name);
+            nodeAndClient.recreateNode(newNodeSettings[nodeAndClient.nodeAndClientId()], () -> rebuildUnicastHostFiles(toStartAndPublish));
         }
-        assert nodesByRoles.values().stream().mapToInt(List::size).sum() == 0;
 
-        for (NodeAndClient nodeAndClient : startUpOrder) {
-            logger.info("creating node [{}] ", nodeAndClient.name);
-            nodeAndClient.recreateNode(newNodeSettings[nodeAndClient.nodeAndClientId()], () -> rebuildUnicastHostFiles(startUpOrder));
-        }
-
-        startAndPublishNodesAndClients(startUpOrder);
+        startAndPublishNodesAndClients(toStartAndPublish);
 
         if (callback.validateClusterForming()) {
             validateClusterFormed();

From 3fd83c1ef5fe9379031f8f5b4d5a6ff4acff1941 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 17 Dec 2019 13:52:39 +0100
Subject: [PATCH 232/686] Omit loading IndexMetaData when inspecting shards
 (#50214)

Loading shard state information during shard allocation sometimes runs into a situation where a
data node does not know yet how to look up the shard on disk if custom data paths are used.
The current implementation loads the index metadata from disk to determine what the custom
data path looks like. This PR removes this dependency, simplifying the lookup.

Relates #48701
---
 .../TransportIndicesShardStoresAction.java    |  31 ++---
 .../elasticsearch/env/NodeEnvironment.java    |  39 +++----
 .../gateway/AsyncShardFetch.java              |  12 +-
 .../gateway/GatewayAllocator.java             |  24 ++--
 ...ransportNodesListGatewayStartedShards.java |  96 +++++++++++-----
 .../org/elasticsearch/index/IndexService.java |   4 +-
 .../elasticsearch/index/IndexSettings.java    |   7 +-
 .../RemoveCorruptedShardDataCommand.java      |   2 +-
 .../elasticsearch/index/shard/ShardPath.java  |  20 ++--
 .../elasticsearch/indices/IndicesService.java |   2 +-
 .../TransportNodesListShardStoreMetaData.java | 107 +++++++++++++-----
 .../env/NodeEnvironmentTests.java             |  19 +---
 .../gateway/AsyncShardFetchTests.java         |   2 +-
 .../gateway/RecoveryFromGatewayIT.java        |   6 +-
 .../index/shard/ShardPathTests.java           |  33 ++----
 .../indices/IndicesServiceTests.java          |   6 +-
 16 files changed, 246 insertions(+), 164 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/shards/TransportIndicesShardStoresAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/shards/TransportIndicesShardStoresAction.java
index 6efb9c8e89bed..f692fb6046850 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/shards/TransportIndicesShardStoresAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/shards/TransportIndicesShardStoresAction.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.health.ClusterShardHealth;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.node.DiscoveryNodes;
@@ -43,6 +44,7 @@
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.collect.ImmutableOpenIntMap;
 import org.elasticsearch.common.collect.ImmutableOpenMap;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.util.concurrent.CountDown;
@@ -100,7 +102,7 @@ protected void masterOperation(Task task, IndicesShardStoresRequest request, Clu
         final RoutingTable routingTables = state.routingTable();
         final RoutingNodes routingNodes = state.getRoutingNodes();
         final String[] concreteIndices = indexNameExpressionResolver.concreteIndexNames(state, request);
-        final Set<ShardId> shardIdsToFetch = new HashSet<>();
+        final Set<Tuple<ShardId, String>> shardsToFetch = new HashSet<>();
 
         logger.trace("using cluster state version [{}] to determine shards", state.version());
         // collect relevant shard ids of the requested indices for fetching store infos
@@ -109,11 +111,12 @@ protected void masterOperation(Task task, IndicesShardStoresRequest request, Clu
             if (indexShardRoutingTables == null) {
                 continue;
             }
+            final String customDataPath = IndexMetaData.INDEX_DATA_PATH_SETTING.get(state.metaData().index(index).getSettings());
             for (IndexShardRoutingTable routing : indexShardRoutingTables) {
                 final int shardId = routing.shardId().id();
                 ClusterShardHealth shardHealth = new ClusterShardHealth(shardId, routing);
                 if (request.shardStatuses().contains(shardHealth.getStatus())) {
-                    shardIdsToFetch.add(routing.shardId());
+                    shardsToFetch.add(Tuple.tuple(routing.shardId(), customDataPath));
                 }
             }
         }
@@ -123,7 +126,7 @@ protected void masterOperation(Task task, IndicesShardStoresRequest request, Clu
         // we could fetch all shard store info from every node once (nNodes requests)
         // we have to implement a TransportNodesAction instead of using TransportNodesListGatewayStartedShards
         // for fetching shard stores info, that operates on a list of shards instead of a single shard
-        new AsyncShardStoresInfoFetches(state.nodes(), routingNodes, shardIdsToFetch, listener).start();
+        new AsyncShardStoresInfoFetches(state.nodes(), routingNodes, shardsToFetch, listener).start();
     }
 
     @Override
@@ -135,46 +138,46 @@ protected ClusterBlockException checkBlock(IndicesShardStoresRequest request, Cl
     private class AsyncShardStoresInfoFetches {
         private final DiscoveryNodes nodes;
         private final RoutingNodes routingNodes;
-        private final Set<ShardId> shardIds;
+        private final Set<Tuple<ShardId, String>> shards;
         private final ActionListener<IndicesShardStoresResponse> listener;
         private CountDown expectedOps;
         private final Queue<InternalAsyncFetch.Response> fetchResponses;
 
-        AsyncShardStoresInfoFetches(DiscoveryNodes nodes, RoutingNodes routingNodes, Set<ShardId> shardIds,
+        AsyncShardStoresInfoFetches(DiscoveryNodes nodes, RoutingNodes routingNodes, Set<Tuple<ShardId, String>> shards,
                                     ActionListener<IndicesShardStoresResponse> listener) {
             this.nodes = nodes;
             this.routingNodes = routingNodes;
-            this.shardIds = shardIds;
+            this.shards = shards;
             this.listener = listener;
             this.fetchResponses = new ConcurrentLinkedQueue<>();
-            this.expectedOps = new CountDown(shardIds.size());
+            this.expectedOps = new CountDown(shards.size());
         }
 
         void start() {
-            if (shardIds.isEmpty()) {
+            if (shards.isEmpty()) {
                 listener.onResponse(new IndicesShardStoresResponse());
             } else {
                 // explicitely type lister, some IDEs (Eclipse) are not able to correctly infer the function type
                 Lister<BaseNodesResponse<NodeGatewayStartedShards>, NodeGatewayStartedShards> lister = this::listStartedShards;
-                for (ShardId shardId : shardIds) {
-                    InternalAsyncFetch fetch = new InternalAsyncFetch(logger, "shard_stores", shardId, lister);
+                for (Tuple<ShardId, String> shard : shards) {
+                    InternalAsyncFetch fetch = new InternalAsyncFetch(logger, "shard_stores", shard.v1(), shard.v2(), lister);
                     fetch.fetchData(nodes, Collections.<String>emptySet());
                 }
             }
         }
 
-        private void listStartedShards(ShardId shardId, DiscoveryNode[] nodes,
+        private void listStartedShards(ShardId shardId, String customDataPath, DiscoveryNode[] nodes,
                                        ActionListener<BaseNodesResponse<NodeGatewayStartedShards>> listener) {
-            var request = new TransportNodesListGatewayStartedShards.Request(shardId, nodes);
+            var request = new TransportNodesListGatewayStartedShards.Request(shardId, customDataPath, nodes);
             client.executeLocally(TransportNodesListGatewayStartedShards.TYPE, request,
                 ActionListener.wrap(listener::onResponse, listener::onFailure));
         }
 
         private class InternalAsyncFetch extends AsyncShardFetch<NodeGatewayStartedShards> {
 
-            InternalAsyncFetch(Logger logger, String type, ShardId shardId,
+            InternalAsyncFetch(Logger logger, String type, ShardId shardId, String customDataPath,
                                Lister<? extends BaseNodesResponse<NodeGatewayStartedShards>, NodeGatewayStartedShards> action) {
-                super(logger, type, shardId, action);
+                super(logger, type, shardId, customDataPath, action);
             }
 
             @Override
diff --git a/server/src/main/java/org/elasticsearch/env/NodeEnvironment.java b/server/src/main/java/org/elasticsearch/env/NodeEnvironment.java
index 160662a63e5b3..ec5b4fe43c8fe 100644
--- a/server/src/main/java/org/elasticsearch/env/NodeEnvironment.java
+++ b/server/src/main/java/org/elasticsearch/env/NodeEnvironment.java
@@ -22,6 +22,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.apache.logging.log4j.util.Strings;
 import org.apache.lucene.index.IndexWriter;
 import org.apache.lucene.index.SegmentInfos;
 import org.apache.lucene.store.Directory;
@@ -610,7 +611,7 @@ public void deleteShardDirectoryUnderLock(ShardLock lock, IndexSettings indexSet
         acquireFSLockForPaths(indexSettings, paths);
         IOUtils.rm(paths);
         if (indexSettings.hasCustomDataPath()) {
-            Path customLocation = resolveCustomLocation(indexSettings, shardId);
+            Path customLocation = resolveCustomLocation(indexSettings.customDataPath(), shardId);
             logger.trace("acquiring lock for {}, custom path: [{}]", shardId, customLocation);
             acquireFSLockForPaths(indexSettings, customLocation);
             logger.trace("deleting custom shard {} directory [{}]", shardId, customLocation);
@@ -687,7 +688,7 @@ public void deleteIndexDirectoryUnderLock(Index index, IndexSettings indexSettin
         logger.trace("deleting index {} directory, paths({}): [{}]", index, indexPaths.length, indexPaths);
         IOUtils.rm(indexPaths);
         if (indexSettings.hasCustomDataPath()) {
-            Path customLocation = resolveIndexCustomLocation(indexSettings);
+            Path customLocation = resolveIndexCustomLocation(indexSettings.customDataPath(), index.getUUID());
             logger.trace("deleting custom index {} directory [{}]", index, customLocation);
             IOUtils.rm(customLocation);
         }
@@ -933,7 +934,7 @@ public Path[] indexPaths(Index index) {
      * returned paths. The returned array may contain paths to non-existing directories.
      *
      * @see IndexSettings#hasCustomDataPath()
-     * @see #resolveCustomLocation(IndexSettings, ShardId)
+     * @see #resolveCustomLocation(String, ShardId)
      *
      */
     public Path[] availableShardPaths(ShardId shardId) {
@@ -1233,17 +1234,12 @@ private static boolean isIndexMetaDataPath(Path path) {
 
     /**
      * Resolve the custom path for a index's shard.
-     * Uses the {@code IndexMetaData.SETTING_DATA_PATH} setting to determine
-     * the root path for the index.
-     *
-     * @param indexSettings settings for the index
      */
-    public static Path resolveBaseCustomLocation(IndexSettings indexSettings, Path sharedDataPath) {
-        String customDataDir = indexSettings.customDataPath();
-        if (customDataDir != null) {
+    public static Path resolveBaseCustomLocation(String customDataPath, Path sharedDataPath) {
+        if (Strings.isNotEmpty(customDataPath)) {
             // This assert is because this should be caught by MetaDataCreateIndexService
             assert sharedDataPath != null;
-            return sharedDataPath.resolve(customDataDir).resolve("0");
+            return sharedDataPath.resolve(customDataPath).resolve("0");
         } else {
             throw new IllegalArgumentException("no custom " + IndexMetaData.SETTING_DATA_PATH + " setting available");
         }
@@ -1254,14 +1250,14 @@ public static Path resolveBaseCustomLocation(IndexSettings indexSettings, Path s
      * Uses the {@code IndexMetaData.SETTING_DATA_PATH} setting to determine
      * the root path for the index.
      *
-     * @param indexSettings settings for the index
+     * @param customDataPath the custom data path
      */
-    private Path resolveIndexCustomLocation(IndexSettings indexSettings) {
-        return resolveIndexCustomLocation(indexSettings, sharedDataPath);
+    private Path resolveIndexCustomLocation(String customDataPath, String indexUUID) {
+        return resolveIndexCustomLocation(customDataPath, indexUUID, sharedDataPath);
     }
 
-    private static Path resolveIndexCustomLocation(IndexSettings indexSettings, Path sharedDataPath) {
-        return resolveBaseCustomLocation(indexSettings, sharedDataPath).resolve(indexSettings.getUUID());
+    private static Path resolveIndexCustomLocation(String customDataPath, String indexUUID, Path sharedDataPath) {
+        return resolveBaseCustomLocation(customDataPath, sharedDataPath).resolve(indexUUID);
     }
 
     /**
@@ -1269,15 +1265,16 @@ private static Path resolveIndexCustomLocation(IndexSettings indexSettings, Path
      * Uses the {@code IndexMetaData.SETTING_DATA_PATH} setting to determine
      * the root path for the index.
      *
-     * @param indexSettings settings for the index
+     * @param customDataPath the custom data path
      * @param shardId shard to resolve the path to
      */
-    public Path resolveCustomLocation(IndexSettings indexSettings, final ShardId shardId) {
-        return resolveCustomLocation(indexSettings, shardId, sharedDataPath);
+    public Path resolveCustomLocation(String customDataPath, final ShardId shardId) {
+        return resolveCustomLocation(customDataPath, shardId, sharedDataPath);
     }
 
-    public static Path resolveCustomLocation(IndexSettings indexSettings, final ShardId shardId, Path sharedDataPath) {
-        return resolveIndexCustomLocation(indexSettings, sharedDataPath).resolve(Integer.toString(shardId.id()));
+    public static Path resolveCustomLocation(String customDataPath, final ShardId shardId, Path sharedDataPath) {
+        return resolveIndexCustomLocation(customDataPath, shardId.getIndex().getUUID(),
+            sharedDataPath).resolve(Integer.toString(shardId.id()));
     }
 
     /**
diff --git a/server/src/main/java/org/elasticsearch/gateway/AsyncShardFetch.java b/server/src/main/java/org/elasticsearch/gateway/AsyncShardFetch.java
index 007357ee54a75..43f7a29cbcb95 100644
--- a/server/src/main/java/org/elasticsearch/gateway/AsyncShardFetch.java
+++ b/server/src/main/java/org/elasticsearch/gateway/AsyncShardFetch.java
@@ -42,6 +42,7 @@
 import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
+import java.util.Objects;
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicLong;
 
@@ -61,22 +62,25 @@ public abstract class AsyncShardFetch<T extends BaseNodeResponse> implements Rel
      * An action that lists the relevant shard data that needs to be fetched.
      */
     public interface Lister<NodesResponse extends BaseNodesResponse<NodeResponse>, NodeResponse extends BaseNodeResponse> {
-        void list(ShardId shardId, DiscoveryNode[] nodes, ActionListener<NodesResponse> listener);
+        void list(ShardId shardId, @Nullable String customDataPath, DiscoveryNode[] nodes, ActionListener<NodesResponse> listener);
     }
 
     protected final Logger logger;
     protected final String type;
     protected final ShardId shardId;
+    protected final String customDataPath;
     private final Lister<BaseNodesResponse<T>, T> action;
     private final Map<String, NodeEntry<T>> cache = new HashMap<>();
     private final Set<String> nodesToIgnore = new HashSet<>();
     private final AtomicLong round = new AtomicLong();
     private boolean closed;
 
-    protected AsyncShardFetch(Logger logger, String type, ShardId shardId, Lister<? extends BaseNodesResponse<T>, T> action) {
+    protected AsyncShardFetch(Logger logger, String type, ShardId shardId, String customDataPath,
+                              Lister<? extends BaseNodesResponse<T>, T> action) {
         this.logger = logger;
         this.type = type;
-        this.shardId = shardId;
+        this.shardId = Objects.requireNonNull(shardId);
+        this.customDataPath = Objects.requireNonNull(customDataPath);
         this.action = (Lister<BaseNodesResponse<T>, T>) action;
     }
 
@@ -285,7 +289,7 @@ private boolean hasAnyNodeFetching(Map<String, NodeEntry<T>> shardCache) {
     // visible for testing
     void asyncFetch(final DiscoveryNode[] nodes, long fetchingRound) {
         logger.trace("{} fetching [{}] from {}", shardId, type, nodes);
-        action.list(shardId, nodes, new ActionListener<BaseNodesResponse<T>>() {
+        action.list(shardId, customDataPath, nodes, new ActionListener<BaseNodesResponse<T>>() {
             @Override
             public void onResponse(BaseNodesResponse<T> response) {
                 processAsyncFetch(response.getNodes(), response.failures(), fetchingRound);
diff --git a/server/src/main/java/org/elasticsearch/gateway/GatewayAllocator.java b/server/src/main/java/org/elasticsearch/gateway/GatewayAllocator.java
index a83e3b4cfd782..a1319bcd59031 100644
--- a/server/src/main/java/org/elasticsearch/gateway/GatewayAllocator.java
+++ b/server/src/main/java/org/elasticsearch/gateway/GatewayAllocator.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.action.support.nodes.BaseNodeResponse;
 import org.elasticsearch.action.support.nodes.BaseNodesResponse;
 import org.elasticsearch.client.node.NodeClient;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.cluster.routing.RerouteService;
@@ -189,8 +190,9 @@ private boolean hasNewNodes(DiscoveryNodes nodes) {
 
     class InternalAsyncFetch<T extends BaseNodeResponse> extends AsyncShardFetch<T> {
 
-        InternalAsyncFetch(Logger logger, String type, ShardId shardId, Lister<? extends BaseNodesResponse<T>, T> action) {
-            super(logger, type, shardId, action);
+        InternalAsyncFetch(Logger logger, String type, ShardId shardId, String customDataPath,
+                           Lister<? extends BaseNodesResponse<T>, T> action) {
+            super(logger, type, shardId, customDataPath, action);
         }
 
         @Override
@@ -217,7 +219,9 @@ protected AsyncShardFetch.FetchResult<NodeGatewayStartedShards> fetchData(ShardR
             Lister<BaseNodesResponse<NodeGatewayStartedShards>, NodeGatewayStartedShards> lister = this::listStartedShards;
             AsyncShardFetch<NodeGatewayStartedShards> fetch =
                 asyncFetchStarted.computeIfAbsent(shard.shardId(),
-                            shardId -> new InternalAsyncFetch<>(logger, "shard_started", shardId, lister));
+                            shardId -> new InternalAsyncFetch<>(logger, "shard_started", shardId,
+                                IndexMetaData.INDEX_DATA_PATH_SETTING.get(allocation.metaData().index(shard.index()).getSettings()),
+                                lister));
             AsyncShardFetch.FetchResult<NodeGatewayStartedShards> shardState =
                     fetch.fetchData(allocation.nodes(), allocation.getIgnoreNodes(shard.shardId()));
 
@@ -227,9 +231,9 @@ protected AsyncShardFetch.FetchResult<NodeGatewayStartedShards> fetchData(ShardR
             return shardState;
         }
 
-        private void listStartedShards(ShardId shardId, DiscoveryNode[] nodes,
+        private void listStartedShards(ShardId shardId, String customDataPath, DiscoveryNode[] nodes,
                                        ActionListener<BaseNodesResponse<NodeGatewayStartedShards>> listener) {
-            var request = new TransportNodesListGatewayStartedShards.Request(shardId, nodes);
+            var request = new TransportNodesListGatewayStartedShards.Request(shardId, customDataPath, nodes);
             client.executeLocally(TransportNodesListGatewayStartedShards.TYPE, request,
                 ActionListener.wrap(listener::onResponse, listener::onFailure));
         }
@@ -244,12 +248,12 @@ class InternalReplicaShardAllocator extends ReplicaShardAllocator {
         }
 
         @Override
-        protected AsyncShardFetch.FetchResult<NodeStoreFilesMetaData>
-                                                                        fetchData(ShardRouting shard, RoutingAllocation allocation) {
+        protected AsyncShardFetch.FetchResult<NodeStoreFilesMetaData> fetchData(ShardRouting shard, RoutingAllocation allocation) {
             // explicitely type lister, some IDEs (Eclipse) are not able to correctly infer the function type
             Lister<BaseNodesResponse<NodeStoreFilesMetaData>, NodeStoreFilesMetaData> lister = this::listStoreFilesMetaData;
             AsyncShardFetch<NodeStoreFilesMetaData> fetch = asyncFetchStore.computeIfAbsent(shard.shardId(),
-                    shardId -> new InternalAsyncFetch<>(logger, "shard_store", shard.shardId(), lister));
+                    shardId -> new InternalAsyncFetch<>(logger, "shard_store", shard.shardId(),
+                        IndexMetaData.INDEX_DATA_PATH_SETTING.get(allocation.metaData().index(shard.index()).getSettings()), lister));
             AsyncShardFetch.FetchResult<NodeStoreFilesMetaData> shardStores =
                     fetch.fetchData(allocation.nodes(), allocation.getIgnoreNodes(shard.shardId()));
             if (shardStores.hasData()) {
@@ -258,9 +262,9 @@ class InternalReplicaShardAllocator extends ReplicaShardAllocator {
             return shardStores;
         }
 
-        private void listStoreFilesMetaData(ShardId shardId, DiscoveryNode[] nodes,
+        private void listStoreFilesMetaData(ShardId shardId, String customDataPath, DiscoveryNode[] nodes,
                                             ActionListener<BaseNodesResponse<NodeStoreFilesMetaData>> listener) {
-            var request = new TransportNodesListShardStoreMetaData.Request(shardId, nodes);
+            var request = new TransportNodesListShardStoreMetaData.Request(shardId, customDataPath, nodes);
             client.executeLocally(TransportNodesListShardStoreMetaData.TYPE, request,
                 ActionListener.wrap(listener::onResponse, listener::onFailure));
         }
diff --git a/server/src/main/java/org/elasticsearch/gateway/TransportNodesListGatewayStartedShards.java b/server/src/main/java/org/elasticsearch/gateway/TransportNodesListGatewayStartedShards.java
index ca68dfc9c1ccc..a99ba6ab2b323 100644
--- a/server/src/main/java/org/elasticsearch/gateway/TransportNodesListGatewayStartedShards.java
+++ b/server/src/main/java/org/elasticsearch/gateway/TransportNodesListGatewayStartedShards.java
@@ -21,6 +21,7 @@
 
 import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionType;
 import org.elasticsearch.action.FailedNodeException;
 import org.elasticsearch.action.support.ActionFilters;
@@ -33,6 +34,7 @@
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
@@ -109,26 +111,24 @@ protected NodeGatewayStartedShards nodeOperation(NodeRequest request, Task task)
             ShardStateMetaData shardStateMetaData = ShardStateMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry,
                 nodeEnv.availableShardPaths(request.shardId));
             if (shardStateMetaData != null) {
-                IndexMetaData metaData = clusterService.state().metaData().index(shardId.getIndex());
-                if (metaData == null) {
-                    // we may send this requests while processing the cluster state that recovered the index
-                    // sometimes the request comes in before the local node processed that cluster state
-                    // in such cases we can load it from disk
-                    metaData = IndexMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry,
-                        nodeEnv.indexPaths(shardId.getIndex()));
-                }
-                if (metaData == null) {
-                    ElasticsearchException e = new ElasticsearchException("failed to find local IndexMetaData");
-                    e.setShard(request.shardId);
-                    throw e;
-                }
-
                 if (indicesService.getShardOrNull(shardId) == null) {
+                    final String customDataPath;
+                    if (request.getCustomDataPath() != null) {
+                        customDataPath = request.getCustomDataPath();
+                    } else {
+                        // TODO: Fallback for BWC with older ES versions. Remove once request.getCustomDataPath() always returns non-null
+                        final IndexMetaData metaData = clusterService.state().metaData().index(shardId.getIndex());
+                        if (metaData != null) {
+                            customDataPath = new IndexSettings(metaData, settings).customDataPath();
+                        } else {
+                            logger.trace("{} node doesn't have meta data for the requests index", shardId);
+                            throw new ElasticsearchException("node doesn't have meta data for index " + shardId.getIndex());
+                        }
+                    }
                     // we don't have an open shard on the store, validate the files on disk are openable
                     ShardPath shardPath = null;
                     try {
-                        IndexSettings indexSettings = new IndexSettings(metaData, settings);
-                        shardPath = ShardPath.loadShardPath(logger, nodeEnv, shardId, indexSettings);
+                        shardPath = ShardPath.loadShardPath(logger, nodeEnv, shardId, customDataPath);
                         if (shardPath == null) {
                             throw new IllegalStateException(shardId + " no shard path found");
                         }
@@ -162,27 +162,47 @@ protected NodeGatewayStartedShards nodeOperation(NodeRequest request, Task task)
 
     public static class Request extends BaseNodesRequest<Request> {
 
-        private ShardId shardId;
+        private final ShardId shardId;
+        @Nullable
+        private final String customDataPath;
 
         public Request(StreamInput in) throws IOException {
             super(in);
             shardId = new ShardId(in);
+            if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+                customDataPath = in.readString();
+            } else {
+                customDataPath = null;
+            }
         }
 
-        public Request(ShardId shardId, DiscoveryNode[] nodes) {
+        public Request(ShardId shardId, String customDataPath, DiscoveryNode[] nodes) {
             super(nodes);
-            this.shardId = shardId;
+            this.shardId = Objects.requireNonNull(shardId);
+            this.customDataPath = Objects.requireNonNull(customDataPath);
         }
 
-
         public ShardId shardId() {
-            return this.shardId;
+            return shardId;
+        }
+
+        /**
+         * Returns the custom data path that is used to look up information for this shard.
+         * Returns an empty string if no custom data path is used for this index.
+         * Returns null if custom data path information is not available (due to BWC).
+         */
+        @Nullable
+        public String getCustomDataPath() {
+            return customDataPath;
         }
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             shardId.writeTo(out);
+            if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+                out.writeString(customDataPath);
+            }
         }
     }
 
@@ -211,33 +231,55 @@ protected void writeNodesTo(StreamOutput out, List<NodeGatewayStartedShards> nod
 
     public static class NodeRequest extends BaseNodeRequest {
 
-        private ShardId shardId;
+        private final ShardId shardId;
+        @Nullable
+        private final String customDataPath;
 
         public NodeRequest(StreamInput in) throws IOException {
             super(in);
             shardId = new ShardId(in);
+            if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+                customDataPath = in.readString();
+            } else {
+                customDataPath = null;
+            }
         }
 
         public NodeRequest(Request request) {
-            this.shardId = request.shardId();
+            this.shardId = Objects.requireNonNull(request.shardId());
+            this.customDataPath = Objects.requireNonNull(request.getCustomDataPath());
         }
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             shardId.writeTo(out);
+            if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+                assert customDataPath != null;
+                out.writeString(customDataPath);
+            }
         }
 
         public ShardId getShardId() {
             return shardId;
         }
+
+        /**
+         * Returns the custom data path that is used to look up information for this shard.
+         * Returns an empty string if no custom data path is used for this index.
+         * Returns null if custom data path information is not available (due to BWC).
+         */
+        @Nullable
+        public String getCustomDataPath() {
+            return customDataPath;
+        }
     }
 
     public static class NodeGatewayStartedShards extends BaseNodeResponse {
 
-        private String allocationId = null;
-        private boolean primary = false;
-        private Exception storeException = null;
+        private final String allocationId;
+        private final boolean primary;
+        private final Exception storeException;
 
         public NodeGatewayStartedShards(StreamInput in) throws IOException {
             super(in);
@@ -245,6 +287,8 @@ public NodeGatewayStartedShards(StreamInput in) throws IOException {
             primary = in.readBoolean();
             if (in.readBoolean()) {
                 storeException = in.readException();
+            } else {
+                storeException = null;
             }
         }
 
diff --git a/server/src/main/java/org/elasticsearch/index/IndexService.java b/server/src/main/java/org/elasticsearch/index/IndexService.java
index 47c3bfb35fee7..481ad3f5a7f6f 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexService.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexService.java
@@ -368,12 +368,12 @@ public synchronized IndexShard createShard(
             eventListener.beforeIndexShardCreated(shardId, indexSettings);
             ShardPath path;
             try {
-                path = ShardPath.loadShardPath(logger, nodeEnv, shardId, this.indexSettings);
+                path = ShardPath.loadShardPath(logger, nodeEnv, shardId, this.indexSettings.customDataPath());
             } catch (IllegalStateException ex) {
                 logger.warn("{} failed to load shard path, trying to remove leftover", shardId);
                 try {
                     ShardPath.deleteLeftoverShardDirectory(logger, nodeEnv, lock, this.indexSettings);
-                    path = ShardPath.loadShardPath(logger, nodeEnv, shardId, this.indexSettings);
+                    path = ShardPath.loadShardPath(logger, nodeEnv, shardId, this.indexSettings.customDataPath());
                 } catch (Exception inner) {
                     ex.addSuppressed(inner);
                     throw ex;
diff --git a/server/src/main/java/org/elasticsearch/index/IndexSettings.java b/server/src/main/java/org/elasticsearch/index/IndexSettings.java
index 99076f812b96e..cce17b8f441e7 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexSettings.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexSettings.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.index;
 
 import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.util.Strings;
 import org.apache.lucene.index.MergePolicy;
 import org.elasticsearch.Version;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
@@ -631,14 +632,14 @@ public String getUUID() {
      * Returns <code>true</code> if the index has a custom data path
      */
     public boolean hasCustomDataPath() {
-        return customDataPath() != null;
+        return Strings.isNotEmpty(customDataPath());
     }
 
     /**
-     * Returns the customDataPath for this index, if configured. <code>null</code> o.w.
+     * Returns the customDataPath for this index, if configured. <code>""</code> o.w.
      */
     public String customDataPath() {
-        return settings.get(IndexMetaData.SETTING_DATA_PATH);
+        return IndexMetaData.INDEX_DATA_PATH_SETTING.get(settings);
     }
 
     /**
diff --git a/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java b/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
index 674124637113f..b7a178972fa72 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
@@ -192,7 +192,7 @@ protected void findAndProcessShardPath(OptionSet options, Environment environmen
                             if (Files.exists(shardPathLocation) == false) {
                                 continue;
                             }
-                            final ShardPath shardPath = ShardPath.loadShardPath(logger, shId, indexSettings,
+                            final ShardPath shardPath = ShardPath.loadShardPath(logger, shId, indexSettings.customDataPath(),
                                 new Path[]{shardPathLocation}, nodePath.path);
                             if (shardPath != null) {
                                 consumer.accept(shardPath);
diff --git a/server/src/main/java/org/elasticsearch/index/shard/ShardPath.java b/server/src/main/java/org/elasticsearch/index/shard/ShardPath.java
index ac865704d51bb..aab86d64ba2b6 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/ShardPath.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/ShardPath.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.index.shard;
 
 import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.util.Strings;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -114,13 +115,13 @@ public boolean isCustomDataPath() {
     /**
      * This method walks through the nodes shard paths to find the data and state path for the given shard. If multiple
      * directories with a valid shard state exist the one with the highest version will be used.
-     * <b>Note:</b> this method resolves custom data locations for the shard.
+     * <b>Note:</b> this method resolves custom data locations for the shard if such a custom data path is provided.
      */
     public static ShardPath loadShardPath(Logger logger, NodeEnvironment env,
-                                                ShardId shardId, IndexSettings indexSettings) throws IOException {
+                                          ShardId shardId, String customDataPath) throws IOException {
         final Path[] paths = env.availableShardPaths(shardId);
         final Path sharedDataPath = env.sharedDataPath();
-        return loadShardPath(logger, shardId, indexSettings, paths, sharedDataPath);
+        return loadShardPath(logger, shardId, customDataPath, paths, sharedDataPath);
     }
 
     /**
@@ -128,9 +129,9 @@ public static ShardPath loadShardPath(Logger logger, NodeEnvironment env,
      * directories with a valid shard state exist the one with the highest version will be used.
      * <b>Note:</b> this method resolves custom data locations for the shard.
      */
-    public static ShardPath loadShardPath(Logger logger, ShardId shardId, IndexSettings indexSettings, Path[] availableShardPaths,
+    public static ShardPath loadShardPath(Logger logger, ShardId shardId, String customDataPath, Path[] availableShardPaths,
                                           Path sharedDataPath) throws IOException {
-        final String indexUUID = indexSettings.getUUID();
+        final String indexUUID = shardId.getIndex().getUUID();
         Path loadedPath = null;
         for (Path path : availableShardPaths) {
             // EMPTY is safe here because we never call namedObject
@@ -156,13 +157,14 @@ public static ShardPath loadShardPath(Logger logger, ShardId shardId, IndexSetti
         } else {
             final Path dataPath;
             final Path statePath = loadedPath;
-            if (indexSettings.hasCustomDataPath()) {
-                dataPath = NodeEnvironment.resolveCustomLocation(indexSettings, shardId, sharedDataPath);
+            final boolean hasCustomDataPath = Strings.isNotEmpty(customDataPath);
+            if (hasCustomDataPath) {
+                dataPath = NodeEnvironment.resolveCustomLocation(customDataPath, shardId, sharedDataPath);
             } else {
                 dataPath = statePath;
             }
             logger.debug("{} loaded data path [{}], state path [{}]", shardId, dataPath, statePath);
-            return new ShardPath(indexSettings.hasCustomDataPath(), dataPath, statePath, shardId);
+            return new ShardPath(hasCustomDataPath, dataPath, statePath, shardId);
         }
     }
 
@@ -195,7 +197,7 @@ public static ShardPath selectNewPathForShard(NodeEnvironment env, ShardId shard
         final Path statePath;
 
         if (indexSettings.hasCustomDataPath()) {
-            dataPath = env.resolveCustomLocation(indexSettings, shardId);
+            dataPath = env.resolveCustomLocation(indexSettings.customDataPath(), shardId);
             statePath = env.nodePaths()[0].resolve(shardId);
         } else {
             BigInteger totFreeSpace = BigInteger.ZERO;
diff --git a/server/src/main/java/org/elasticsearch/indices/IndicesService.java b/server/src/main/java/org/elasticsearch/indices/IndicesService.java
index 4810f9f00e8e5..deba07bc76139 100644
--- a/server/src/main/java/org/elasticsearch/indices/IndicesService.java
+++ b/server/src/main/java/org/elasticsearch/indices/IndicesService.java
@@ -971,7 +971,7 @@ public ShardDeletionCheckResult canDeleteShardContent(ShardId shardId, IndexSett
             } else if (indexSettings.hasCustomDataPath()) {
                 // lets see if it's on a custom path (return false if the shared doesn't exist)
                 // we don't need to delete anything that is not there
-                return Files.exists(nodeEnv.resolveCustomLocation(indexSettings, shardId)) ?
+                return Files.exists(nodeEnv.resolveCustomLocation(indexSettings.customDataPath(), shardId)) ?
                         ShardDeletionCheckResult.FOLDER_FOUND_CAN_DELETE :
                         ShardDeletionCheckResult.NO_FOLDER_FOUND;
             } else {
diff --git a/server/src/main/java/org/elasticsearch/indices/store/TransportNodesListShardStoreMetaData.java b/server/src/main/java/org/elasticsearch/indices/store/TransportNodesListShardStoreMetaData.java
index 97deeefa74da3..1e4ef6781a761 100644
--- a/server/src/main/java/org/elasticsearch/indices/store/TransportNodesListShardStoreMetaData.java
+++ b/server/src/main/java/org/elasticsearch/indices/store/TransportNodesListShardStoreMetaData.java
@@ -34,13 +34,13 @@
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.index.IndexSettings;
@@ -60,6 +60,7 @@
 import java.util.Collections;
 import java.util.Iterator;
 import java.util.List;
+import java.util.Objects;
 import java.util.concurrent.TimeUnit;
 
 public class TransportNodesListShardStoreMetaData extends TransportNodesAction<TransportNodesListShardStoreMetaData.Request,
@@ -73,19 +74,17 @@ public class TransportNodesListShardStoreMetaData extends TransportNodesAction<T
     private final Settings settings;
     private final IndicesService indicesService;
     private final NodeEnvironment nodeEnv;
-    private final NamedXContentRegistry namedXContentRegistry;
 
     @Inject
     public TransportNodesListShardStoreMetaData(Settings settings, ThreadPool threadPool,
                                                 ClusterService clusterService, TransportService transportService,
                                                 IndicesService indicesService, NodeEnvironment nodeEnv,
-                                                ActionFilters actionFilters, NamedXContentRegistry namedXContentRegistry) {
+                                                ActionFilters actionFilters) {
         super(ACTION_NAME, threadPool, clusterService, transportService, actionFilters,
             Request::new, NodeRequest::new, ThreadPool.Names.FETCH_SHARD_STORE, NodeStoreFilesMetaData.class);
         this.settings = settings;
         this.indicesService = indicesService;
         this.nodeEnv = nodeEnv;
-        this.namedXContentRegistry = namedXContentRegistry;
     }
 
     @Override
@@ -107,13 +106,14 @@ protected NodesStoreFilesMetaData newResponse(Request request,
     @Override
     protected NodeStoreFilesMetaData nodeOperation(NodeRequest request, Task task) {
         try {
-            return new NodeStoreFilesMetaData(clusterService.localNode(), listStoreMetaData(request.shardId));
+            return new NodeStoreFilesMetaData(clusterService.localNode(), listStoreMetaData(request));
         } catch (IOException e) {
             throw new ElasticsearchException("Failed to list store metadata for shard [" + request.shardId + "]", e);
         }
     }
 
-    private StoreFilesMetaData listStoreMetaData(ShardId shardId) throws IOException {
+    private StoreFilesMetaData listStoreMetaData(NodeRequest request) throws IOException {
+        final ShardId shardId = request.getShardId();
         logger.trace("listing store meta data for {}", shardId);
         long startTimeNS = System.nanoTime();
         boolean exists = false;
@@ -136,22 +136,24 @@ private StoreFilesMetaData listStoreMetaData(ShardId shardId) throws IOException
                     }
                 }
             }
-            // try and see if we an list unallocated
-            IndexMetaData metaData = clusterService.state().metaData().index(shardId.getIndex());
-            if (metaData == null) {
-                // we may send this requests while processing the cluster state that recovered the index
-                // sometimes the request comes in before the local node processed that cluster state
-                // in such cases we can load it from disk
-                metaData = IndexMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry,
-                    nodeEnv.indexPaths(shardId.getIndex()));
-            }
-            if (metaData == null) {
-                logger.trace("{} node doesn't have meta data for the requests index, responding with empty", shardId);
-                return new StoreFilesMetaData(shardId, Store.MetadataSnapshot.EMPTY, Collections.emptyList());
+            final String customDataPath;
+            if (request.getCustomDataPath() != null) {
+                customDataPath = request.getCustomDataPath();
+            } else {
+                // TODO: Fallback for BWC with older ES versions. Remove this once request.getCustomDataPath() always returns non-null
+                if (indexService != null) {
+                    customDataPath = indexService.getIndexSettings().customDataPath();
+                } else {
+                    IndexMetaData metaData = clusterService.state().metaData().index(shardId.getIndex());
+                    if (metaData != null) {
+                        customDataPath = new IndexSettings(metaData, settings).customDataPath();
+                    } else {
+                        logger.trace("{} node doesn't have meta data for the requests index", shardId);
+                        throw new ElasticsearchException("node doesn't have meta data for index " + shardId.getIndex());
+                    }
+                }
             }
-            final IndexSettings indexSettings = indexService != null ? indexService.getIndexSettings() :
-                new IndexSettings(metaData, settings);
-            final ShardPath shardPath = ShardPath.loadShardPath(logger, nodeEnv, shardId, indexSettings);
+            final ShardPath shardPath = ShardPath.loadShardPath(logger, nodeEnv, shardId, customDataPath);
             if (shardPath == null) {
                 return new StoreFilesMetaData(shardId, Store.MetadataSnapshot.EMPTY, Collections.emptyList());
             }
@@ -259,22 +261,47 @@ public String toString() {
 
     public static class Request extends BaseNodesRequest<Request> {
 
-        private ShardId shardId;
+        private final ShardId shardId;
+        @Nullable
+        private final String customDataPath;
 
         public Request(StreamInput in) throws IOException {
             super(in);
             shardId = new ShardId(in);
+            if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+                customDataPath = in.readString();
+            } else {
+                customDataPath = null;
+            }
         }
 
-        public Request(ShardId shardId, DiscoveryNode[] nodes) {
+        public Request(ShardId shardId, String customDataPath, DiscoveryNode[] nodes) {
             super(nodes);
-            this.shardId = shardId;
+            this.shardId = Objects.requireNonNull(shardId);
+            this.customDataPath = Objects.requireNonNull(customDataPath);
+        }
+
+        public ShardId shardId() {
+            return shardId;
+        }
+
+        /**
+         * Returns the custom data path that is used to look up information for this shard.
+         * Returns an empty string if no custom data path is used for this index.
+         * Returns null if custom data path information is not available (due to BWC).
+         */
+        @Nullable
+        public String getCustomDataPath() {
+            return customDataPath;
         }
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             shardId.writeTo(out);
+            if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+                out.writeString(customDataPath);
+            }
         }
     }
 
@@ -302,21 +329,47 @@ protected void writeNodesTo(StreamOutput out, List<NodeStoreFilesMetaData> nodes
 
     public static class NodeRequest extends BaseNodeRequest {
 
-        private ShardId shardId;
+        private final ShardId shardId;
+        @Nullable
+        private final String customDataPath;
 
         public NodeRequest(StreamInput in) throws IOException {
             super(in);
             shardId = new ShardId(in);
+            if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+                customDataPath = in.readString();
+            } else {
+                customDataPath = null;
+            }
         }
 
-        NodeRequest(TransportNodesListShardStoreMetaData.Request request) {
-            this.shardId = request.shardId;
+        public NodeRequest(Request request) {
+            this.shardId = Objects.requireNonNull(request.shardId());
+            this.customDataPath = Objects.requireNonNull(request.getCustomDataPath());
         }
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             shardId.writeTo(out);
+            if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+                assert customDataPath != null;
+                out.writeString(customDataPath);
+            }
+        }
+
+        public ShardId getShardId() {
+            return shardId;
+        }
+
+        /**
+         * Returns the custom data path that is used to look up information for this shard.
+         * Returns an empty string if no custom data path is used for this index.
+         * Returns null if custom data path information is not available (due to BWC).
+         */
+        @Nullable
+        public String getCustomDataPath() {
+            return customDataPath;
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/env/NodeEnvironmentTests.java b/server/src/test/java/org/elasticsearch/env/NodeEnvironmentTests.java
index 5fddb2ee4c38d..19100343d2b15 100644
--- a/server/src/test/java/org/elasticsearch/env/NodeEnvironmentTests.java
+++ b/server/src/test/java/org/elasticsearch/env/NodeEnvironmentTests.java
@@ -19,14 +19,13 @@
 package org.elasticsearch.env;
 
 import org.apache.lucene.index.SegmentInfos;
-import org.elasticsearch.common.util.set.Sets;
-import org.elasticsearch.core.internal.io.IOUtils;
 import org.apache.lucene.util.LuceneTestCase;
-import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.SuppressForbidden;
 import org.elasticsearch.common.io.PathUtils;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
+import org.elasticsearch.common.util.set.Sets;
+import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.gateway.MetaDataStateFormat;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexSettings;
@@ -357,19 +356,11 @@ public void testCustomDataPaths() throws Exception {
         String[] dataPaths = tmpPaths();
         NodeEnvironment env = newNodeEnvironment(dataPaths, "/tmp", Settings.EMPTY);
 
-        final Settings indexSettings = Settings.builder().put(IndexMetaData.SETTING_INDEX_UUID, "myindexUUID").build();
-        IndexSettings s1 = IndexSettingsModule.newIndexSettings("myindex", indexSettings);
-        IndexSettings s2 = IndexSettingsModule.newIndexSettings("myindex", Settings.builder()
-                .put(indexSettings)
-                .put(IndexMetaData.SETTING_DATA_PATH, "/tmp/foo").build());
         Index index = new Index("myindex", "myindexUUID");
         ShardId sid = new ShardId(index, 0);
 
-        assertFalse("no settings should mean no custom data path", s1.hasCustomDataPath());
-        assertTrue("settings with path_data should have a custom data path", s2.hasCustomDataPath());
-
         assertThat(env.availableShardPaths(sid), equalTo(env.availableShardPaths(sid)));
-        assertThat(env.resolveCustomLocation(s2, sid).toAbsolutePath(),
+        assertThat(env.resolveCustomLocation("/tmp/foo", sid).toAbsolutePath(),
             equalTo(PathUtils.get("/tmp/foo/0/" + index.getUUID() + "/0").toAbsolutePath()));
 
         assertThat("shard paths with a custom data_path should contain only regular paths",
@@ -379,10 +370,8 @@ public void testCustomDataPaths() throws Exception {
         assertThat("index paths uses the regular template",
                 env.indexPaths(index), equalTo(stringsToPaths(dataPaths, "indices/" + index.getUUID())));
 
-        IndexSettings s3 = new IndexSettings(s2.getIndexMetaData(), Settings.builder().build());
-
         assertThat(env.availableShardPaths(sid), equalTo(env.availableShardPaths(sid)));
-        assertThat(env.resolveCustomLocation(s3, sid).toAbsolutePath(),
+        assertThat(env.resolveCustomLocation("/tmp/foo", sid).toAbsolutePath(),
             equalTo(PathUtils.get("/tmp/foo/0/" + index.getUUID() + "/0").toAbsolutePath()));
 
         assertThat("shard paths with a custom data_path should contain only regular paths",
diff --git a/server/src/test/java/org/elasticsearch/gateway/AsyncShardFetchTests.java b/server/src/test/java/org/elasticsearch/gateway/AsyncShardFetchTests.java
index b4ce705735b7c..259c806bea06a 100644
--- a/server/src/test/java/org/elasticsearch/gateway/AsyncShardFetchTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/AsyncShardFetchTests.java
@@ -373,7 +373,7 @@ static class Entry {
         private AtomicInteger reroute = new AtomicInteger();
 
         TestFetch(ThreadPool threadPool) {
-            super(LogManager.getLogger(TestFetch.class), "test", new ShardId("test", "_na_", 1), null);
+            super(LogManager.getLogger(TestFetch.class), "test", new ShardId("test", "_na_", 1), "", null);
             this.threadPool = threadPool;
         }
 
diff --git a/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java b/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
index 126c7eeb21ca7..e3a754f0003db 100644
--- a/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
@@ -542,7 +542,9 @@ public void assertSyncIdsNotNull() {
     public void testStartedShardFoundIfStateNotYetProcessed() throws Exception {
         // nodes may need to report the shards they processed the initial recovered cluster state from the master
         final String nodeName = internalCluster().startNode();
-        assertAcked(prepareCreate("test").setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1)));
+        createIndex("test", Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).build());
+        final String customDataPath = IndexMetaData.INDEX_DATA_PATH_SETTING.get(
+            client().admin().indices().prepareGetSettings("test").get().getIndexToSettings().get("test"));
         final Index index = resolveIndex("test");
         final ShardId shardId = new ShardId(index, 0);
         indexDoc("test", "1");
@@ -579,7 +581,7 @@ public Settings onNodeStopped(String nodeName) throws Exception {
 
         TransportNodesListGatewayStartedShards.NodesGatewayStartedShards response;
         response = ActionTestUtils.executeBlocking(internalCluster().getInstance(TransportNodesListGatewayStartedShards.class),
-            new TransportNodesListGatewayStartedShards.Request(shardId, new DiscoveryNode[]{node}));
+            new TransportNodesListGatewayStartedShards.Request(shardId, customDataPath, new DiscoveryNode[]{node}));
 
         assertThat(response.getNodes(), hasSize(1));
         assertThat(response.getNodes().get(0).allocationId(), notNullValue());
diff --git a/server/src/test/java/org/elasticsearch/index/shard/ShardPathTests.java b/server/src/test/java/org/elasticsearch/index/shard/ShardPathTests.java
index cbaae21476855..721e5435172a3 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/ShardPathTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/ShardPathTests.java
@@ -18,15 +18,12 @@
  */
 package org.elasticsearch.index.shard;
 
-import org.elasticsearch.Version;
-import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.routing.AllocationId;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.test.IndexSettingsModule;
 
 import java.io.IOException;
 import java.nio.file.Path;
@@ -37,16 +34,12 @@
 public class ShardPathTests extends ESTestCase {
     public void testLoadShardPath() throws IOException {
         try (NodeEnvironment env = newNodeEnvironment(Settings.builder().build())) {
-            Settings.Builder builder = Settings.builder().put(IndexMetaData.SETTING_INDEX_UUID, "0xDEADBEEF")
-                    .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT);
-            Settings settings = builder.build();
             ShardId shardId = new ShardId("foo", "0xDEADBEEF", 0);
             Path[] paths = env.availableShardPaths(shardId);
             Path path = randomFrom(paths);
             ShardStateMetaData.FORMAT.writeAndCleanup(
                     new ShardStateMetaData(true, "0xDEADBEEF", AllocationId.newInitializing()), path);
-            ShardPath shardPath =
-                    ShardPath.loadShardPath(logger, env, shardId, IndexSettingsModule.newIndexSettings(shardId.getIndex(), settings));
+            ShardPath shardPath = ShardPath.loadShardPath(logger, env, shardId, "");
             assertEquals(path, shardPath.getDataPath());
             assertEquals("0xDEADBEEF", shardPath.getShardId().getIndex().getUUID());
             assertEquals("foo", shardPath.getShardId().getIndexName());
@@ -58,32 +51,24 @@ public void testLoadShardPath() throws IOException {
     public void testFailLoadShardPathOnMultiState() throws IOException {
         try (NodeEnvironment env = newNodeEnvironment(Settings.builder().build())) {
             final String indexUUID = "0xDEADBEEF";
-            Settings.Builder builder = Settings.builder().put(IndexMetaData.SETTING_INDEX_UUID, indexUUID)
-                    .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT);
-            Settings settings = builder.build();
             ShardId shardId = new ShardId("foo", indexUUID, 0);
             Path[] paths = env.availableShardPaths(shardId);
             assumeTrue("This test tests multi data.path but we only got one", paths.length > 1);
             ShardStateMetaData.FORMAT.writeAndCleanup(
                     new ShardStateMetaData(true, indexUUID, AllocationId.newInitializing()), paths);
-            Exception e = expectThrows(IllegalStateException.class, () ->
-                ShardPath.loadShardPath(logger, env, shardId, IndexSettingsModule.newIndexSettings(shardId.getIndex(), settings)));
+            Exception e = expectThrows(IllegalStateException.class, () -> ShardPath.loadShardPath(logger, env, shardId, ""));
             assertThat(e.getMessage(), containsString("more than one shard state found"));
         }
     }
 
     public void testFailLoadShardPathIndexUUIDMissmatch() throws IOException {
         try (NodeEnvironment env = newNodeEnvironment(Settings.builder().build())) {
-            Settings.Builder builder = Settings.builder().put(IndexMetaData.SETTING_INDEX_UUID, "foobar")
-                    .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT);
-            Settings settings = builder.build();
             ShardId shardId = new ShardId("foo", "foobar", 0);
             Path[] paths = env.availableShardPaths(shardId);
             Path path = randomFrom(paths);
             ShardStateMetaData.FORMAT.writeAndCleanup(
                     new ShardStateMetaData(true, "0xDEADBEEF", AllocationId.newInitializing()), path);
-            Exception e = expectThrows(IllegalStateException.class, () ->
-                ShardPath.loadShardPath(logger, env, shardId, IndexSettingsModule.newIndexSettings(shardId.getIndex(), settings)));
+            Exception e = expectThrows(IllegalStateException.class, () -> ShardPath.loadShardPath(logger, env, shardId, ""));
             assertThat(e.getMessage(), containsString("expected: foobar on shard path"));
         }
     }
@@ -107,22 +92,19 @@ public void testValidCtor() {
 
     public void testGetRootPaths() throws IOException {
         boolean useCustomDataPath = randomBoolean();
-        final Settings indexSettings;
         final Settings nodeSettings;
         final String indexUUID = "0xDEADBEEF";
-        Settings.Builder indexSettingsBuilder = Settings.builder()
-                .put(IndexMetaData.SETTING_INDEX_UUID, indexUUID)
-                .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT);
         final Path customPath;
+        final String customDataPath;
         if (useCustomDataPath) {
             final Path path = createTempDir();
-            indexSettings = indexSettingsBuilder.put(IndexMetaData.SETTING_DATA_PATH, "custom").build();
+            customDataPath = "custom";
             nodeSettings = Settings.builder().put(Environment.PATH_SHARED_DATA_SETTING.getKey(), path.toAbsolutePath().toAbsolutePath())
                     .build();
             customPath = path.resolve("custom").resolve("0");
         } else {
             customPath = null;
-            indexSettings = indexSettingsBuilder.build();
+            customDataPath = "";
             nodeSettings = Settings.EMPTY;
         }
         try (NodeEnvironment env = newNodeEnvironment(nodeSettings)) {
@@ -131,8 +113,7 @@ public void testGetRootPaths() throws IOException {
             Path path = randomFrom(paths);
             ShardStateMetaData.FORMAT.writeAndCleanup(
                     new ShardStateMetaData(true, indexUUID, AllocationId.newInitializing()), path);
-            ShardPath shardPath = ShardPath.loadShardPath(logger, env, shardId,
-                IndexSettingsModule.newIndexSettings(shardId.getIndex(), indexSettings, nodeSettings));
+            ShardPath shardPath = ShardPath.loadShardPath(logger, env, shardId, customDataPath);
             boolean found = false;
             for (Path p : env.nodeDataPaths()) {
                 if (p.equals(shardPath.getRootStatePath())) {
diff --git a/server/src/test/java/org/elasticsearch/indices/IndicesServiceTests.java b/server/src/test/java/org/elasticsearch/indices/IndicesServiceTests.java
index 1ed0538288d6b..bd35f0f1783ca 100644
--- a/server/src/test/java/org/elasticsearch/indices/IndicesServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/IndicesServiceTests.java
@@ -248,7 +248,8 @@ public void testDeleteIndexStore() throws Exception {
         assertHitCount(client().prepareSearch("test").get(), 1);
         IndexMetaData secondMetaData = clusterService.state().metaData().index("test");
         assertAcked(client().admin().indices().prepareClose("test"));
-        ShardPath path = ShardPath.loadShardPath(logger, getNodeEnvironment(), new ShardId(test.index(), 0), test.getIndexSettings());
+        ShardPath path = ShardPath.loadShardPath(logger, getNodeEnvironment(), new ShardId(test.index(), 0),
+            test.getIndexSettings().customDataPath());
         assertTrue(path.exists());
 
         try {
@@ -281,7 +282,8 @@ public void testPendingTasks() throws Exception {
         assertTrue(indexShard.routingEntry().started());
 
         final ShardPath shardPath = indexShard.shardPath();
-        assertEquals(ShardPath.loadShardPath(logger, getNodeEnvironment(), indexShard.shardId(), indexSettings), shardPath);
+        assertEquals(ShardPath.loadShardPath(logger, getNodeEnvironment(), indexShard.shardId(), indexSettings.customDataPath()),
+            shardPath);
 
         final IndicesService indicesService = getIndicesService();
         expectThrows(ShardLockObtainFailedException.class, () ->

From 71b102970d8f5a9f0de11b4905476e700b3663a4 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Tue, 17 Dec 2019 14:02:06 +0100
Subject: [PATCH 233/686] Optimize composite aggregation based on index sorting
 (#48399)

Co-authored-by: Daniel Huang <danielhuang@tencent.com>

This is a spinoff of #48130 that generalizes the proposal to allow early termination with the composite aggregation when leading sources match a prefix or the entire index sort specification.
In such case the composite aggregation can use the index sort natural order to early terminate the collection when it reaches a composite key that is greater than the bottom of the queue.
The optimization is also applicable when a query other than match_all is provided. However the optimization is deactivated for sources that match the index sort in the following cases:
  * Multi-valued source, in such case early termination is not possible.
  * missing_bucket is set to true
---
 .../bucket/composite-aggregation.asciidoc     | 125 +++++++++-
 .../CompositeAggregationBuilder.java          |   3 +-
 .../bucket/composite/CompositeAggregator.java | 197 +++++++++++++---
 .../CompositeValuesCollectorQueue.java        |  60 +++--
 .../CompositeValuesSourceBuilder.java         |   2 +-
 .../CompositeValuesSourceConfig.java          |  14 +-
 .../DateHistogramValuesSourceBuilder.java     |   3 +-
 .../GeoTileGridValuesSourceBuilder.java       |   3 +-
 .../HistogramValuesSourceBuilder.java         |   3 +-
 .../bucket/composite/InternalComposite.java   |  27 ++-
 .../bucket/composite/SortedDocsProducer.java  |   3 +-
 .../composite/TermsValuesSourceBuilder.java   |   2 +-
 .../bucket/terms/TermsAggregationBuilder.java |   5 +
 .../searchafter/SearchAfterBuilder.java       |   3 +-
 .../composite/CompositeAggregatorTests.java   | 222 ++++++++++++++----
 .../CompositeValuesCollectorQueueTests.java   |  73 ++++--
 .../composite/InternalCompositeTests.java     |   4 +-
 .../aggregations/AggregatorTestCase.java      |  44 +++-
 18 files changed, 662 insertions(+), 131 deletions(-)

diff --git a/docs/reference/aggregations/bucket/composite-aggregation.asciidoc b/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
index bcc79fd989aaa..dd9aea6be3e90 100644
--- a/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
+++ b/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
@@ -116,6 +116,7 @@ Example:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -134,6 +135,7 @@ Like the `terms` aggregation it is also possible to use a script to create the v
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -168,6 +170,7 @@ Example:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -186,6 +189,7 @@ The values are built from a numeric field or a script that return numerical valu
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -218,6 +222,7 @@ is specified by date/time expression:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -247,6 +252,7 @@ the format specified with the format parameter:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -289,6 +295,7 @@ For example:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -311,6 +318,7 @@ in the composite buckets.
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -340,6 +348,7 @@ For example:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -366,6 +375,7 @@ It is possible to include them in the response by setting `missing_bucket` to
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -391,7 +401,7 @@ first 10 composite buckets created from the values source.
 The response contains the values for each composite bucket in an array containing the values extracted
 from each value source.
 
-==== After
+==== Pagination
 
 If the number of composite buckets is too high (or unknown) to be returned in a single response
 it is possible to split the retrieval in multiple requests.
@@ -405,6 +415,7 @@ For example:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -470,6 +481,7 @@ round of result can be retrieved with:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
@@ -487,6 +499,116 @@ GET /_search
 
 <1> Should restrict the aggregation to buckets that sort **after** the provided values.
 
+==== Early termination
+
+For optimal performance the <<index-modules-index-sorting,index sort>> should be set on the index so that it matches
+parts or fully the source order in the composite aggregation.
+For instance the following index sort:
+
+[source,console]
+--------------------------------------------------
+PUT twitter
+{
+    "settings" : {
+        "index" : {
+            "sort.field" : ["username", "timestamp"],   <1>
+            "sort.order" : ["asc", "desc"]              <2>
+        }
+    },
+    "mappings": {
+        "properties": {
+            "username": {
+                "type": "keyword",
+                "doc_values": true
+            },
+            "timestamp": {
+                "type": "date"
+            }
+        }
+    }
+}
+--------------------------------------------------
+
+<1> This index is sorted by `username` first then by `timestamp`.
+<2> ... in ascending order for the `username` field and in descending order for the `timestamp` field.
+
+.. could be used to optimize these composite aggregations:
+
+[source,console]
+--------------------------------------------------
+GET /_search
+{
+    "size": 0,
+    "aggs" : {
+        "my_buckets": {
+            "composite" : {
+                "sources" : [
+                    { "user_name": { "terms" : { "field": "user_name" } } }     <1>
+                ]
+            }
+        }
+     }
+}
+--------------------------------------------------
+
+<1> `user_name` is a prefix of the index sort and the order matches (`asc`).
+
+[source,console]
+--------------------------------------------------
+GET /_search
+{
+    "size": 0,
+    "aggs" : {
+        "my_buckets": {
+            "composite" : {
+                "sources" : [
+                    { "user_name": { "terms" : { "field": "user_name" } } }, <1>
+                    { "date": { "date_histogram": { "field": "timestamp", "calendar_interval": "1d", "order": "desc" } } } <2>
+                ]
+            }
+        }
+     }
+}
+--------------------------------------------------
+
+<1> `user_name` is a prefix of the index sort and the order matches (`asc`).
+<2> `timestamp` matches also the prefix and the order matches (`desc`).
+
+In order to optimize the early termination it is advised to set `track_total_hits` in the request
+to `false`. The number of total hits that match the request can be retrieved on the first request
+and it would be costly to compute this number on every page:
+
+[source,console]
+--------------------------------------------------
+GET /_search
+{
+    "size": 0,
+    "track_total_hits": false,
+    "aggs" : {
+        "my_buckets": {
+            "composite" : {
+                "sources" : [
+                    { "user_name": { "terms" : { "field": "user_name" } } },
+                    { "date": { "date_histogram": { "field": "timestamp", "calendar_interval": "1d", "order": "desc" } } }
+                ]
+            }
+        }
+     }
+}
+--------------------------------------------------
+
+Note that the order of the source is important, in the example below switching the `user_name` with the `timestamp`
+would deactivate the sort optimization since this configuration wouldn't match the index sort specification.
+If the order of sources do not matter for your use case you can follow these simple guidelines:
+
+  * Put the fields with the highest cardinality first.
+  * Make sure that the order of the field matches the order of the index sort.
+  * Put multi-valued fields last since they cannot be used for early termination.
+
+WARNING: <<index-modules-index-sorting,index sort>> can slowdown indexing, it is very important to test index sorting
+with your specific use case and dataset to ensure that it matches your requirement. If it doesn't note that `composite`
+aggregations will also try to early terminate on non-sorted indices if the query matches all document (`match_all` query).
+
 ==== Sub-aggregations
 
 Like any `multi-bucket` aggregations the `composite` aggregation can hold sub-aggregations.
@@ -499,6 +621,7 @@ per composite bucket:
 --------------------------------------------------
 GET /_search
 {
+    "size": 0,
     "aggs" : {
         "my_buckets": {
             "composite" : {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilder.java
index b3712e231fded..243d1057bbf4a 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilder.java
@@ -235,7 +235,8 @@ protected AggregatorFactory doBuild(QueryShardContext queryShardContext, Aggrega
         } else {
             afterKey = null;
         }
-        return new CompositeAggregationFactory(name, queryShardContext, parent, subfactoriesBuilder, metaData, size, configs, afterKey);
+        return new CompositeAggregationFactory(name, queryShardContext, parent, subfactoriesBuilder, metaData, size,
+            configs, afterKey);
     }
 
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregator.java
index 4effb22f30cb2..0e01615492939 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregator.java
@@ -20,18 +20,28 @@
 package org.elasticsearch.search.aggregations.bucket.composite;
 
 import org.apache.lucene.index.DirectoryReader;
+import org.apache.lucene.index.DocValues;
 import org.apache.lucene.index.IndexReader;
 import org.apache.lucene.index.LeafReaderContext;
+import org.apache.lucene.index.SortedNumericDocValues;
+import org.apache.lucene.index.SortedSetDocValues;
+import org.apache.lucene.queries.SearchAfterSortedDocQuery;
+import org.apache.lucene.search.BooleanClause;
+import org.apache.lucene.search.BooleanQuery;
 import org.apache.lucene.search.CollectionTerminatedException;
 import org.apache.lucene.search.DocIdSet;
 import org.apache.lucene.search.DocIdSetIterator;
+import org.apache.lucene.search.FieldDoc;
 import org.apache.lucene.search.Query;
 import org.apache.lucene.search.ScoreMode;
 import org.apache.lucene.search.Scorer;
+import org.apache.lucene.search.Sort;
+import org.apache.lucene.search.SortField;
 import org.apache.lucene.search.Weight;
 import org.apache.lucene.util.RoaringDocIdSet;
 import org.elasticsearch.common.lease.Releasables;
 import org.elasticsearch.common.util.BigArrays;
+import org.elasticsearch.index.IndexSortConfig;
 import org.elasticsearch.search.DocValueFormat;
 import org.elasticsearch.search.aggregations.Aggregator;
 import org.elasticsearch.search.aggregations.AggregatorFactories;
@@ -46,6 +56,8 @@
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
 import org.elasticsearch.search.aggregations.support.ValuesSource;
 import org.elasticsearch.search.internal.SearchContext;
+import org.elasticsearch.search.searchafter.SearchAfterBuilder;
+import org.elasticsearch.search.sort.SortAndFormats;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -60,11 +72,12 @@
 
 final class CompositeAggregator extends BucketsAggregator {
     private final int size;
-    private final SortedDocsProducer sortedDocsProducer;
     private final List<String> sourceNames;
     private final int[] reverseMuls;
     private final List<DocValueFormat> formats;
+    private final CompositeKey rawAfterKey;
 
+    private final CompositeValuesSourceConfig[] sourceConfigs;
     private final SingleDimensionValuesSource<?>[] sources;
     private final CompositeValuesCollectorQueue queue;
 
@@ -73,6 +86,8 @@ final class CompositeAggregator extends BucketsAggregator {
     private RoaringDocIdSet.Builder docIdSetBuilder;
     private BucketCollector deferredCollectors;
 
+    private boolean earlyTerminated;
+
     CompositeAggregator(String name, AggregatorFactories factories, SearchContext context, Aggregator parent,
                         List<PipelineAggregator> pipelineAggregators, Map<String, Object> metaData,
                         int size, CompositeValuesSourceConfig[] sourceConfigs, CompositeKey rawAfterKey) throws IOException {
@@ -89,11 +104,12 @@ final class CompositeAggregator extends BucketsAggregator {
                 " to: [" + bucketLimit + "] but was [" + size + "]. This limit can be set by changing the [" + MAX_BUCKET_SETTING.getKey() +
                 "] cluster level setting.", bucketLimit);
         }
+        this.sourceConfigs = sourceConfigs;
         for (int i = 0; i < sourceConfigs.length; i++) {
             this.sources[i] = createValuesSource(context.bigArrays(), context.searcher().getIndexReader(), sourceConfigs[i], size);
         }
         this.queue = new CompositeValuesCollectorQueue(context.bigArrays(), sources, size, rawAfterKey);
-        this.sortedDocsProducer = sources[0].createSortedDocsProducerOrNull(context.searcher().getIndexReader(), context.query());
+        this.rawAfterKey = rawAfterKey;
     }
 
     @Override
@@ -121,7 +137,6 @@ protected void doPostCollection() throws IOException {
     public InternalAggregation buildAggregation(long zeroBucket) throws IOException {
         assert zeroBucket == 0L;
         consumeBucketsAndMaybeBreak(queue.size());
-
         if (deferredCollectors != NO_OP_COLLECTOR) {
             // Replay all documents that contain at least one top bucket (collected during the first pass).
             runDeferredCollections();
@@ -138,13 +153,13 @@ public InternalAggregation buildAggregation(long zeroBucket) throws IOException
         }
         CompositeKey lastBucket = num > 0 ? buckets[num-1].getRawKey() : null;
         return new InternalComposite(name, size, sourceNames, formats, Arrays.asList(buckets), lastBucket, reverseMuls,
-            pipelineAggregators(), metaData());
+            earlyTerminated, pipelineAggregators(), metaData());
     }
 
     @Override
     public InternalAggregation buildEmptyAggregation() {
         return new InternalComposite(name, size, sourceNames, formats, Collections.emptyList(), null, reverseMuls,
-            pipelineAggregators(), metaData());
+            false, pipelineAggregators(), metaData());
     }
 
     private void finishLeaf() {
@@ -156,58 +171,179 @@ private void finishLeaf() {
         }
     }
 
+    /** Return true if the provided field may have multiple values per document in the leaf **/
+    private boolean isMaybeMultivalued(LeafReaderContext context, SortField sortField) throws IOException {
+        SortField.Type type = IndexSortConfig.getSortFieldType(sortField);
+        switch (type) {
+            case STRING:
+                final SortedSetDocValues v1 = context.reader().getSortedSetDocValues(sortField.getField());
+                return v1 != null && DocValues.unwrapSingleton(v1) == null;
+
+            case DOUBLE:
+            case FLOAT:
+            case LONG:
+            case INT:
+                final SortedNumericDocValues v2 = context.reader().getSortedNumericDocValues(sortField.getField());
+                return v2 != null && DocValues.unwrapSingleton(v2) == null;
+
+            default:
+                // we have no clue whether the field is multi-valued or not so we assume it is.
+                return true;
+        }
+    }
+
+    /**
+     * Returns the {@link Sort} prefix that is eligible to index sort
+     * optimization and null if index sort is not applicable.
+     */
+    private Sort buildIndexSortPrefix(LeafReaderContext context) throws IOException {
+        Sort indexSort = context.reader().getMetaData().getSort();
+        if (indexSort == null) {
+            return null;
+        }
+        List<SortField> sortFields = new ArrayList<>();
+        for (int i = 0; i < indexSort.getSort().length; i++) {
+            CompositeValuesSourceConfig sourceConfig = sourceConfigs[i];
+            SingleDimensionValuesSource<?> source = sources[i];
+            SortField indexSortField = indexSort.getSort()[i];
+            if (source.fieldType == null
+                    // TODO: can we handle missing bucket when using index sort optimization ?
+                    || source.missingBucket
+                    || indexSortField.getField().equals(source.fieldType.name()) == false
+                    || isMaybeMultivalued(context, indexSortField)
+                    || sourceConfig.hasScript()) {
+                break;
+            }
+
+            if (indexSortField.getReverse() != (source.reverseMul == -1)) {
+                if (i == 0) {
+                    // the leading index sort matches the leading source field but the order is reversed
+                    // so we don't check the other sources.
+                    return new Sort(indexSortField);
+                }
+                break;
+            }
+            sortFields.add(indexSortField);
+        }
+        return sortFields.isEmpty() ? null : new Sort(sortFields.toArray(new SortField[0]));
+    }
+
+    /**
+     * Return the number of leading sources that match the index sort.
+     *
+     * @param indexSortPrefix The index sort prefix that matches the sources
+     * @return The length of the index sort prefix if the sort order matches
+     *         or -1 if the leading index sort is in the reverse order of the
+     *         leading source. A value of 0 indicates that the index sort is
+     *         not applicable.
+     */
+    private int computeSortPrefixLen(Sort indexSortPrefix) {
+        if (indexSortPrefix == null) {
+            return 0;
+        }
+        if (indexSortPrefix.getSort()[0].getReverse() != (sources[0].reverseMul == -1)) {
+            assert indexSortPrefix.getSort().length == 1;
+            return -1;
+        } else {
+            return indexSortPrefix.getSort().length;
+        }
+    }
+
+    private void processLeafFromQuery(LeafReaderContext ctx, Sort indexSortPrefix) throws IOException {
+        DocValueFormat[] formats = new DocValueFormat[indexSortPrefix.getSort().length];
+        for (int i = 0; i < formats.length; i++) {
+            formats[i] = sources[i].format;
+        }
+        FieldDoc fieldDoc = SearchAfterBuilder.buildFieldDoc(new SortAndFormats(indexSortPrefix, formats),
+            Arrays.copyOfRange(rawAfterKey.values(), 0, formats.length));
+        if (indexSortPrefix.getSort().length < sources.length) {
+            // include all docs that belong to the partial bucket
+            fieldDoc.doc = 0;
+        }
+        BooleanQuery newQuery = new BooleanQuery.Builder()
+            .add(context.query(), BooleanClause.Occur.MUST)
+            .add(new SearchAfterSortedDocQuery(indexSortPrefix, fieldDoc), BooleanClause.Occur.FILTER)
+            .build();
+        Weight weight = context.searcher().createWeight(context.searcher().rewrite(newQuery), ScoreMode.COMPLETE_NO_SCORES, 1f);
+        Scorer scorer = weight.scorer(ctx);
+        if (scorer != null) {
+            DocIdSetIterator docIt = scorer.iterator();
+            final LeafBucketCollector inner = queue.getLeafCollector(ctx,
+                getFirstPassCollector(docIdSetBuilder, indexSortPrefix.getSort().length));
+            inner.setScorer(scorer);
+            while (docIt.nextDoc() != DocIdSetIterator.NO_MORE_DOCS) {
+                inner.collect(docIt.docID());
+            }
+        }
+    }
+
     @Override
     protected LeafBucketCollector getLeafCollector(LeafReaderContext ctx, LeafBucketCollector sub) throws IOException {
         finishLeaf();
+
         boolean fillDocIdSet = deferredCollectors != NO_OP_COLLECTOR;
+
+        Sort indexSortPrefix = buildIndexSortPrefix(ctx);
+        int sortPrefixLen = computeSortPrefixLen(indexSortPrefix);
+
+        SortedDocsProducer sortedDocsProducer = sortPrefixLen == 0  ?
+            sources[0].createSortedDocsProducerOrNull(ctx.reader(), context.query()) : null;
         if (sortedDocsProducer != null) {
-            /*
-              The producer will visit documents sorted by the leading source of the composite definition
-              and terminates when the leading source value is guaranteed to be greater than the lowest
-              composite bucket in the queue.
-             */
+            // Visit documents sorted by the leading source of the composite definition and terminates
+            // when the leading source value is guaranteed to be greater than the lowest composite bucket
+            // in the queue.
             DocIdSet docIdSet = sortedDocsProducer.processLeaf(context.query(), queue, ctx, fillDocIdSet);
             if (fillDocIdSet) {
                 entries.add(new Entry(ctx, docIdSet));
             }
-
-            /*
-              We can bypass search entirely for this segment, all the processing has been done in the previous call.
-              Throwing this exception will terminate the execution of the search for this root aggregation,
-              see {@link org.apache.lucene.search.MultiCollector} for more details on how we handle early termination in aggregations.
-             */
+            // We can bypass search entirely for this segment, the processing is done in the previous call.
+            // Throwing this exception will terminate the execution of the search for this root aggregation,
+            // see {@link MultiCollector} for more details on how we handle early termination in aggregations.
+            earlyTerminated = true;
             throw new CollectionTerminatedException();
         } else {
             if (fillDocIdSet) {
                 currentLeaf = ctx;
                 docIdSetBuilder = new RoaringDocIdSet.Builder(ctx.reader().maxDoc());
             }
-            final LeafBucketCollector inner = queue.getLeafCollector(ctx, getFirstPassCollector(docIdSetBuilder));
-            return new LeafBucketCollector() {
-                @Override
-                public void collect(int doc, long zeroBucket) throws IOException {
-                    assert zeroBucket == 0L;
-                    inner.collect(doc);
-                }
-            };
+            if (rawAfterKey != null && sortPrefixLen > 0) {
+                // We have an after key and index sort is applicable so we jump directly to the doc
+                // that is after the index sort prefix using the rawAfterKey and we start collecting
+                // document from there.
+                processLeafFromQuery(ctx, indexSortPrefix);
+                throw new CollectionTerminatedException();
+            } else {
+                final LeafBucketCollector inner = queue.getLeafCollector(ctx, getFirstPassCollector(docIdSetBuilder, sortPrefixLen));
+                return new LeafBucketCollector() {
+                    @Override
+                    public void collect(int doc, long zeroBucket) throws IOException {
+                        assert zeroBucket == 0L;
+                        inner.collect(doc);
+                    }
+                };
+            }
         }
     }
 
     /**
      * The first pass selects the top composite buckets from all matching documents.
      */
-    private LeafBucketCollector getFirstPassCollector(RoaringDocIdSet.Builder builder) {
+    private LeafBucketCollector getFirstPassCollector(RoaringDocIdSet.Builder builder, int indexSortPrefix) {
         return new LeafBucketCollector() {
             int lastDoc = -1;
 
             @Override
             public void collect(int doc, long bucket) throws IOException {
-                int slot = queue.addIfCompetitive();
-                if (slot != -1) {
-                    if (builder != null && lastDoc != doc) {
-                        builder.add(doc);
-                        lastDoc = doc;
+                try {
+                    if (queue.addIfCompetitive(indexSortPrefix)) {
+                        if (builder != null && lastDoc != doc) {
+                            builder.add(doc);
+                            lastDoc = doc;
+                        }
                     }
+                } catch (CollectionTerminatedException exc) {
+                    earlyTerminated = true;
+                    throw exc;
                 }
             }
         };
@@ -274,7 +410,6 @@ public void collect(int doc, long zeroBucket) throws IOException {
 
     private SingleDimensionValuesSource<?> createValuesSource(BigArrays bigArrays, IndexReader reader,
                                                               CompositeValuesSourceConfig config, int size) {
-
         final int reverseMul = config.reverseMul();
         if (config.valuesSource() instanceof ValuesSource.Bytes.WithOrdinals && reader instanceof DirectoryReader) {
             ValuesSource.Bytes.WithOrdinals vs = (ValuesSource.Bytes.WithOrdinals) config.valuesSource();
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesCollectorQueue.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesCollectorQueue.java
index 58887d9e6a2dc..93511498e2258 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesCollectorQueue.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesCollectorQueue.java
@@ -20,6 +20,7 @@
 package org.elasticsearch.search.aggregations.bucket.composite;
 
 import org.apache.lucene.index.LeafReaderContext;
+import org.apache.lucene.search.CollectionTerminatedException;
 import org.apache.lucene.util.PriorityQueue;
 import org.elasticsearch.common.lease.Releasable;
 import org.elasticsearch.common.lease.Releasables;
@@ -63,6 +64,7 @@ public int hashCode() {
     private final int maxSize;
     private final Map<Slot, Integer> map;
     private final SingleDimensionValuesSource<?>[] arrays;
+
     private IntArray docCounts;
     private boolean afterKeyIsSet = false;
 
@@ -153,7 +155,7 @@ int compare(int slot1, int slot2) {
                 cmp = arrays[i].compare(slot1, slot2);
             }
             if (cmp != 0) {
-                return cmp;
+                return cmp > 0 ? i+1 : -(i+1);
             }
         }
         return 0;
@@ -244,27 +246,57 @@ LeafBucketCollector getLeafCollector(Comparable forceLeadSourceValue,
 
     /**
      * Check if the current candidate should be added in the queue.
-     * @return The target slot of the candidate or -1 is the candidate is not competitive.
+     * @return <code>true</code> if the candidate is competitive (added or already in the queue).
+     */
+    boolean addIfCompetitive() {
+        return addIfCompetitive(0);
+    }
+
+
+    /**
+     * Add or update the current composite key in the queue if the values are competitive.
+     *
+     * @param indexSortSourcePrefix 0 if the index sort is null or doesn't match any of the sources field,
+     *                              a value greater than 0 indicates the prefix len of the sources that match the index sort
+     *                              and a negative value indicates that the index sort match the source field but the order is reversed.
+     * @return <code>true</code> if the candidate is competitive (added or already in the queue).
+     *
+     * @throws CollectionTerminatedException if the current collection can be terminated early due to index sorting.
      */
-    int addIfCompetitive() {
+    boolean addIfCompetitive(int indexSortSourcePrefix) {
         // checks if the candidate key is competitive
         Integer topSlot = compareCurrent();
         if (topSlot != null) {
             // this key is already in the top N, skip it
             docCounts.increment(topSlot, 1);
-            return topSlot;
+            return true;
         }
-        if (afterKeyIsSet && compareCurrentWithAfter() <= 0) {
-            // this key is greater than the top value collected in the previous round, skip it
-            return -1;
+        if (afterKeyIsSet) {
+            int cmp = compareCurrentWithAfter();
+            if (cmp <= 0) {
+                if (indexSortSourcePrefix < 0 && cmp == indexSortSourcePrefix) {
+                    // the leading index sort is in the reverse order of the leading source
+                    // so we can early terminate when we reach a document that is smaller
+                    // than the after key (collected on a previous page).
+                    throw new CollectionTerminatedException();
+                }
+                // key was collected on a previous page, skip it (>= afterKey).
+                return false;
+            }
         }
-        if (size() >= maxSize
-                // the tree map is full, check if the candidate key should be kept
-                && compare(CANDIDATE_SLOT, top()) > 0) {
-            // the candidate key is not competitive, skip it
-            return -1;
+        if (size() >= maxSize) {
+            // the tree map is full, check if the candidate key should be kept
+            int cmp = compare(CANDIDATE_SLOT, top());
+            if (cmp > 0) {
+                if (cmp <= indexSortSourcePrefix) {
+                    // index sort guarantees that there is no key greater or equal than the
+                    // current one in the subsequent documents so we can early terminate.
+                    throw new CollectionTerminatedException();
+                }
+                // the candidate key is not competitive, skip it.
+                return false;
+            }
         }
-
         // the candidate key is competitive
         final int newSlot;
         if (size() >= maxSize) {
@@ -280,7 +312,7 @@ && compare(CANDIDATE_SLOT, top()) > 0) {
         copyCurrent(newSlot);
         map.put(new Slot(newSlot), newSlot);
         add(newSlot);
-        return newSlot;
+        return true;
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesSourceBuilder.java
index 70687cf9efe0c..d113ded687f81 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesSourceBuilder.java
@@ -200,7 +200,7 @@ public ValueType valueType() {
     }
 
     /**
-     * If true an explicit `null bucket will represent documents with missing values.
+     * If <code>true</code> an explicit <code>null</code> bucket will represent documents with missing values.
      */
     @SuppressWarnings("unchecked")
     public AB missingBucket(boolean missingBucket) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesSourceConfig.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesSourceConfig.java
index bf88285c190c8..5c9378d44eff4 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesSourceConfig.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesSourceConfig.java
@@ -33,23 +33,28 @@ class CompositeValuesSourceConfig {
     private final DocValueFormat format;
     private final int reverseMul;
     private final boolean missingBucket;
+    private final boolean hasScript;
 
     /**
      * Creates a new {@link CompositeValuesSourceConfig}.
+     *
      * @param name The name of the source.
      * @param fieldType The field type or null if the source is a script.
      * @param vs The underlying {@link ValuesSource}.
      * @param format The {@link DocValueFormat} of this source.
      * @param order The sort order associated with this source.
+     * @param missingBucket If <code>true</code> an explicit <code>null</code> bucket will represent documents with missing values.
+     * @param hasScript <code>true</code> if the source contains a script that can change the value.
      */
     CompositeValuesSourceConfig(String name, @Nullable MappedFieldType fieldType, ValuesSource vs, DocValueFormat format,
-                                SortOrder order, boolean missingBucket) {
+                                SortOrder order, boolean missingBucket, boolean hasScript) {
         this.name = name;
         this.fieldType = fieldType;
         this.vs = vs;
         this.format = format;
         this.reverseMul = order == SortOrder.ASC ? 1 : -1;
         this.missingBucket = missingBucket;
+        this.hasScript = hasScript;
     }
 
     /**
@@ -88,6 +93,13 @@ boolean missingBucket() {
         return missingBucket;
     }
 
+    /**
+     * Returns true if the source contains a script that can change the value.
+     */
+    boolean hasScript() {
+        return hasScript;
+    }
+
     /**
      * The sort order for the values source (e.g. -1 for descending and 1 for ascending).
      */
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/DateHistogramValuesSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/DateHistogramValuesSourceBuilder.java
index f1c1f5502dfd4..564399d4c2647 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/DateHistogramValuesSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/DateHistogramValuesSourceBuilder.java
@@ -228,7 +228,8 @@ protected CompositeValuesSourceConfig innerBuild(QueryShardContext queryShardCon
             // is specified in the builder.
             final DocValueFormat docValueFormat = format() == null ? DocValueFormat.RAW : config.format();
             final MappedFieldType fieldType = config.fieldContext() != null ? config.fieldContext().fieldType() : null;
-            return new CompositeValuesSourceConfig(name, fieldType, vs, docValueFormat, order(), missingBucket());
+            return new CompositeValuesSourceConfig(name, fieldType, vs, docValueFormat, order(),
+                missingBucket(), config.script() != null);
         } else {
             throw new IllegalArgumentException("invalid source, expected numeric, got " + orig.getClass().getSimpleName());
         }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
index 17a5b3c0e9993..b6f2b2788cd25 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
@@ -113,7 +113,8 @@ protected CompositeValuesSourceConfig innerBuild(QueryShardContext queryShardCon
             // is specified in the builder.
             final MappedFieldType fieldType = config.fieldContext() != null ? config.fieldContext().fieldType() : null;
             CellIdSource cellIdSource = new CellIdSource(geoPoint, precision, GeoTileUtils::longEncode);
-            return new CompositeValuesSourceConfig(name, fieldType, cellIdSource, DocValueFormat.GEOTILE, order(), missingBucket());
+            return new CompositeValuesSourceConfig(name, fieldType, cellIdSource, DocValueFormat.GEOTILE, order(),
+                missingBucket(), script() != null);
         } else {
             throw new IllegalArgumentException("invalid source, expected geo_point, got " + orig.getClass().getSimpleName());
         }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/HistogramValuesSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/HistogramValuesSourceBuilder.java
index daafa6f14418e..aa15d5a6947d9 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/HistogramValuesSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/HistogramValuesSourceBuilder.java
@@ -119,7 +119,8 @@ protected CompositeValuesSourceConfig innerBuild(QueryShardContext queryShardCon
             ValuesSource.Numeric numeric = (ValuesSource.Numeric) orig;
             final HistogramValuesSource vs = new HistogramValuesSource(numeric, interval);
             final MappedFieldType fieldType = config.fieldContext() != null ? config.fieldContext().fieldType() : null;
-            return new CompositeValuesSourceConfig(name, fieldType, vs, config.format(), order(), missingBucket());
+            return new CompositeValuesSourceConfig(name, fieldType, vs, config.format(), order(),
+                missingBucket(), script() != null);
         } else {
             throw new IllegalArgumentException("invalid source, expected numeric, got " + orig.getClass().getSimpleName());
         }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
index 243ae557bfa2c..d3d4c34953216 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
@@ -20,6 +20,7 @@
 package org.elasticsearch.search.aggregations.bucket.composite;
 
 import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -53,8 +54,10 @@ public class InternalComposite
     private final List<String> sourceNames;
     private final List<DocValueFormat> formats;
 
+    private final boolean earlyTerminated;
+
     InternalComposite(String name, int size, List<String> sourceNames, List<DocValueFormat> formats,
-                      List<InternalBucket> buckets, CompositeKey afterKey, int[] reverseMuls,
+                      List<InternalBucket> buckets, CompositeKey afterKey, int[] reverseMuls, boolean earlyTerminated,
                       List<PipelineAggregator> pipelineAggregators, Map<String, Object> metaData) {
         super(name, pipelineAggregators, metaData);
         this.sourceNames = sourceNames;
@@ -63,6 +66,7 @@ public class InternalComposite
         this.afterKey = afterKey;
         this.size = size;
         this.reverseMuls = reverseMuls;
+        this.earlyTerminated = earlyTerminated;
     }
 
     public InternalComposite(StreamInput in) throws IOException {
@@ -75,7 +79,8 @@ public InternalComposite(StreamInput in) throws IOException {
         }
         this.reverseMuls = in.readIntArray();
         this.buckets = in.readList((input) -> new InternalBucket(input, sourceNames, formats, reverseMuls));
-        this.afterKey = in.readBoolean() ? new CompositeKey(in) : null;
+        this.afterKey = in.readOptionalWriteable(CompositeKey::new);
+        this.earlyTerminated = in.getVersion().onOrAfter(Version.V_8_0_0) ? in.readBoolean() : false;
     }
 
     @Override
@@ -87,9 +92,9 @@ protected void doWriteTo(StreamOutput out) throws IOException {
         }
         out.writeIntArray(reverseMuls);
         out.writeList(buckets);
-        out.writeBoolean(afterKey != null);
-        if (afterKey != null) {
-            afterKey.writeTo(out);
+        out.writeOptionalWriteable(afterKey);
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            out.writeBoolean(earlyTerminated);
         }
     }
 
@@ -111,7 +116,7 @@ public InternalComposite create(List<InternalBucket> newBuckets) {
          * to be able to retrieve the next page even if all buckets have been filtered.
          */
         return new InternalComposite(name, size, sourceNames, formats, newBuckets, afterKey,
-            reverseMuls, pipelineAggregators(), getMetaData());
+            reverseMuls, earlyTerminated, pipelineAggregators(), getMetaData());
     }
 
     @Override
@@ -137,6 +142,11 @@ public Map<String, Object> afterKey() {
         return null;
     }
 
+    // Visible for tests
+    boolean isTerminatedEarly() {
+        return earlyTerminated;
+    }
+
     // Visible for tests
     int[] getReverseMuls() {
         return reverseMuls;
@@ -145,8 +155,10 @@ int[] getReverseMuls() {
     @Override
     public InternalAggregation reduce(List<InternalAggregation> aggregations, ReduceContext reduceContext) {
         PriorityQueue<BucketIterator> pq = new PriorityQueue<>(aggregations.size());
+        boolean earlyTerminated = false;
         for (InternalAggregation agg : aggregations) {
             InternalComposite sortedAgg = (InternalComposite) agg;
+            earlyTerminated |= sortedAgg.earlyTerminated;
             BucketIterator it = new BucketIterator(sortedAgg.buckets);
             if (it.next() != null) {
                 pq.add(it);
@@ -178,7 +190,8 @@ public InternalAggregation reduce(List<InternalAggregation> aggregations, Reduce
             result.add(reduceBucket);
         }
         final CompositeKey lastKey = result.size() > 0 ? result.get(result.size()-1).getRawKey() : null;
-        return new InternalComposite(name, size, sourceNames, formats, result, lastKey, reverseMuls, pipelineAggregators(), metaData);
+        return new InternalComposite(name, size, sourceNames, formats, result, lastKey, reverseMuls,
+            earlyTerminated, pipelineAggregators(), metaData);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/SortedDocsProducer.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/SortedDocsProducer.java
index 63530a4eed6ed..01e2c0a3ae5b0 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/SortedDocsProducer.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/SortedDocsProducer.java
@@ -66,8 +66,7 @@ protected boolean processBucket(CompositeValuesCollectorQueue queue, LeafReaderC
             @Override
             public void collect(int doc, long bucket) throws IOException {
                 hasCollected[0] = true;
-                int slot = queue.addIfCompetitive();
-                if (slot != -1) {
+                if (queue.addIfCompetitive()) {
                     topCompositeCollected[0]++;
                     if (adder != null && doc != lastDoc) {
                         if (remainingBits == 0) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/TermsValuesSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/TermsValuesSourceBuilder.java
index 8d02eb4b19d87..cd88a56614ec5 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/TermsValuesSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/TermsValuesSourceBuilder.java
@@ -85,6 +85,6 @@ protected CompositeValuesSourceConfig innerBuild(QueryShardContext queryShardCon
         } else {
             format = config.format();
         }
-        return new CompositeValuesSourceConfig(name, fieldType, vs, format, order(), missingBucket());
+        return new CompositeValuesSourceConfig(name, fieldType, vs, format, order(), missingBucket(), script() != null);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregationBuilder.java
index 228a3ca7ee2b1..b7a01099597b1 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregationBuilder.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.index.query.QueryRewriteContext;
 import org.elasticsearch.index.query.QueryShardContext;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.Aggregator.SubAggCollectionMode;
@@ -385,4 +386,8 @@ public String getType() {
         return NAME;
     }
 
+    @Override
+    protected AggregationBuilder doRewrite(QueryRewriteContext queryShardContext) throws IOException {
+        return super.doRewrite(queryShardContext);
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/searchafter/SearchAfterBuilder.java b/server/src/main/java/org/elasticsearch/search/searchafter/SearchAfterBuilder.java
index 304a639a8981a..6c3ac160bc661 100644
--- a/server/src/main/java/org/elasticsearch/search/searchafter/SearchAfterBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/searchafter/SearchAfterBuilder.java
@@ -184,7 +184,8 @@ private static Object convertValueFromSortType(String fieldName, SortField.Type
                     if (value instanceof Number) {
                         return ((Number) value).longValue();
                     }
-                    return Long.parseLong(value.toString());
+                    return format.parseLong(value.toString(), false,
+                        () -> { throw new IllegalStateException("now() is not allowed in [search_after] key"); });
 
                 case FLOAT:
                     if (value instanceof Number) {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregatorTests.java
index 1520dfde8a116..601154234e792 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregatorTests.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.search.aggregations.bucket.composite;
 
+import org.apache.lucene.analysis.MockAnalyzer;
 import org.apache.lucene.document.Document;
 import org.apache.lucene.document.DoublePoint;
 import org.apache.lucene.document.Field;
@@ -31,17 +32,28 @@
 import org.apache.lucene.document.StringField;
 import org.apache.lucene.index.DirectoryReader;
 import org.apache.lucene.index.IndexReader;
+import org.apache.lucene.index.IndexWriterConfig;
 import org.apache.lucene.index.RandomIndexWriter;
+import org.apache.lucene.index.Term;
 import org.apache.lucene.search.DocValuesFieldExistsQuery;
 import org.apache.lucene.search.IndexSearcher;
 import org.apache.lucene.search.MatchAllDocsQuery;
 import org.apache.lucene.search.Query;
+import org.apache.lucene.search.Sort;
+import org.apache.lucene.search.SortField;
+import org.apache.lucene.search.SortedNumericSortField;
+import org.apache.lucene.search.SortedSetSortField;
+import org.apache.lucene.search.TermQuery;
 import org.apache.lucene.store.Directory;
 import org.apache.lucene.util.BytesRef;
 import org.apache.lucene.util.NumericUtils;
+import org.apache.lucene.util.TestUtil;
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.common.geo.GeoPoint;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.time.DateFormatters;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.mapper.ContentPath;
 import org.elasticsearch.index.mapper.DateFieldMapper;
 import org.elasticsearch.index.mapper.GeoPointFieldMapper;
@@ -63,6 +75,7 @@
 import org.elasticsearch.search.aggregations.metrics.TopHitsAggregationBuilder;
 import org.elasticsearch.search.aggregations.support.ValueType;
 import org.elasticsearch.search.sort.SortOrder;
+import org.elasticsearch.test.IndexSettingsModule;
 import org.junit.After;
 import org.junit.Before;
 
@@ -82,12 +95,13 @@
 import java.util.function.Consumer;
 import java.util.function.Function;
 import java.util.function.Supplier;
+import java.util.stream.Collectors;
 
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.instanceOf;
 
-public class CompositeAggregatorTests extends AggregatorTestCase {
+public class CompositeAggregatorTests  extends AggregatorTestCase {
     private static MappedFieldType[] FIELD_TYPES;
 
     @Override
@@ -109,6 +123,7 @@ public void setUp() throws Exception {
 
         DateFieldMapper.Builder builder = new DateFieldMapper.Builder("date");
         builder.docValues(true);
+        builder.format("yyyy-MM-dd||epoch_millis");
         DateFieldMapper fieldMapper =
             builder.build(new Mapper.BuilderContext(createIndexSettings().getSettings(), new ContentPath(0)));
         FIELD_TYPES[3] = fieldMapper.fieldType();
@@ -419,7 +434,7 @@ public void testWithKeywordMissingAfter() throws Exception {
         );
     }
 
-   public void testWithKeywordDesc() throws Exception {
+    public void testWithKeywordDesc() throws Exception {
         final List<Map<String, List<Object>>> dataset = new ArrayList<>();
         dataset.addAll(
             Arrays.asList(
@@ -485,19 +500,19 @@ public void testMultiValuedWithKeyword() throws Exception {
                 return new CompositeAggregationBuilder("name", Collections.singletonList(terms));
 
             }, (result) -> {
-                    assertEquals(5, result.getBuckets().size());
-                    assertEquals("{keyword=z}", result.afterKey().toString());
-                    assertEquals("{keyword=a}", result.getBuckets().get(0).getKeyAsString());
-                    assertEquals(2L, result.getBuckets().get(0).getDocCount());
-                    assertEquals("{keyword=b}", result.getBuckets().get(1).getKeyAsString());
-                    assertEquals(2L, result.getBuckets().get(1).getDocCount());
-                    assertEquals("{keyword=c}", result.getBuckets().get(2).getKeyAsString());
-                    assertEquals(1L, result.getBuckets().get(2).getDocCount());
-                    assertEquals("{keyword=d}", result.getBuckets().get(3).getKeyAsString());
-                    assertEquals(1L, result.getBuckets().get(3).getDocCount());
-                    assertEquals("{keyword=z}", result.getBuckets().get(4).getKeyAsString());
-                    assertEquals(1L, result.getBuckets().get(4).getDocCount());
-                }
+                assertEquals(5, result.getBuckets().size());
+                assertEquals("{keyword=z}", result.afterKey().toString());
+                assertEquals("{keyword=a}", result.getBuckets().get(0).getKeyAsString());
+                assertEquals(2L, result.getBuckets().get(0).getDocCount());
+                assertEquals("{keyword=b}", result.getBuckets().get(1).getKeyAsString());
+                assertEquals(2L, result.getBuckets().get(1).getDocCount());
+                assertEquals("{keyword=c}", result.getBuckets().get(2).getKeyAsString());
+                assertEquals(1L, result.getBuckets().get(2).getDocCount());
+                assertEquals("{keyword=d}", result.getBuckets().get(3).getKeyAsString());
+                assertEquals(1L, result.getBuckets().get(3).getDocCount());
+                assertEquals("{keyword=z}", result.getBuckets().get(4).getKeyAsString());
+                assertEquals(1L, result.getBuckets().get(4).getDocCount());
+            }
         );
 
         testSearchCase(Arrays.asList(new MatchAllDocsQuery(), new DocValuesFieldExistsQuery("keyword")), dataset,
@@ -589,10 +604,10 @@ public void testWithKeywordAndLong() throws Exception {
         );
         testSearchCase(Arrays.asList(new MatchAllDocsQuery(), new DocValuesFieldExistsQuery("keyword")), dataset,
             () -> new CompositeAggregationBuilder("name",
-                    Arrays.asList(
-                        new TermsValuesSourceBuilder("keyword").field("keyword"),
-                        new TermsValuesSourceBuilder("long").field("long")
-                    )
+                Arrays.asList(
+                    new TermsValuesSourceBuilder("keyword").field("keyword"),
+                    new TermsValuesSourceBuilder("long").field("long")
+                )
             ),
             (result) -> {
                 assertEquals(4, result.getBuckets().size());
@@ -610,11 +625,11 @@ public void testWithKeywordAndLong() throws Exception {
 
         testSearchCase(Arrays.asList(new MatchAllDocsQuery(), new DocValuesFieldExistsQuery("keyword")), dataset,
             () -> new CompositeAggregationBuilder("name",
-                    Arrays.asList(
-                        new TermsValuesSourceBuilder("keyword").field("keyword"),
-                        new TermsValuesSourceBuilder("long").field("long")
-                    )
-                ).aggregateAfter(createAfterKey("keyword", "a", "long", 100L)
+                Arrays.asList(
+                    new TermsValuesSourceBuilder("keyword").field("keyword"),
+                    new TermsValuesSourceBuilder("long").field("long")
+                )
+            ).aggregateAfter(createAfterKey("keyword", "a", "long", 100L)
             ),
             (result) -> {
                 assertEquals(2, result.getBuckets().size());
@@ -942,7 +957,7 @@ public void testMultiValuedWithKeywordLongAndDouble() throws Exception {
                         new TermsValuesSourceBuilder("double").field("double")
                     )
                 ).aggregateAfter(createAfterKey("keyword", "a", "long", 100L, "double", 0.4d))
-            ,(result) -> {
+            , (result) -> {
                 assertEquals(10, result.getBuckets().size());
                 assertEquals("{keyword=z, long=0, double=0.09}", result.afterKey().toString());
                 assertEquals("{keyword=b, long=100, double=0.4}", result.getBuckets().get(0).getKeyAsString());
@@ -1152,8 +1167,9 @@ public void testThatDateHistogramFailsFormatAfter() throws IOException {
                     return new CompositeAggregationBuilder("name", Collections.singletonList(histo))
                         .aggregateAfter(createAfterKey("date", "now"));
                 },
-                (result) -> {}
-        ));
+                (result) -> {
+                }
+            ));
         assertThat(exc.getCause(), instanceOf(IllegalArgumentException.class));
         assertThat(exc.getCause().getMessage(), containsString("now() is not supported in [after] key"));
 
@@ -1167,7 +1183,8 @@ public void testThatDateHistogramFailsFormatAfter() throws IOException {
                     return new CompositeAggregationBuilder("name", Collections.singletonList(histo))
                         .aggregateAfter(createAfterKey("date", "1474329600000"));
                 },
-                (result) -> {}
+                (result) -> {
+                }
             ));
         assertThat(exc.getMessage(), containsString("failed to parse date field [1474329600000]"));
         assertWarnings("[interval] on [date_histogram] is deprecated, use [fixed_interval] or [calendar_interval] in the future.");
@@ -1486,7 +1503,7 @@ public void testWithKeywordAndDateHistogram() throws IOException {
                         new DateHistogramValuesSourceBuilder("date_histo").field("date")
                             .dateHistogramInterval(DateHistogramInterval.days(1))
                     )
-                ).aggregateAfter(createAfterKey("keyword","c", "date_histo", 1474329600000L))
+                ).aggregateAfter(createAfterKey("keyword", "c", "date_histo", 1474329600000L))
             , (result) -> {
                 assertEquals(4, result.getBuckets().size());
                 assertEquals("{keyword=z, date_histo=1474329600000}", result.afterKey().toString());
@@ -1668,7 +1685,7 @@ public void testDuplicateNames() {
             builders.add(new TermsValuesSourceBuilder("duplicate1").field("baz"));
             builders.add(new TermsValuesSourceBuilder("duplicate2").field("bar"));
             builders.add(new TermsValuesSourceBuilder("duplicate2").field("baz"));
-           new CompositeAggregationBuilder("foo", builders);
+            new CompositeAggregationBuilder("foo", builders);
         });
         assertThat(e.getMessage(), equalTo("Composite source names must be unique, found duplicates: [duplicate2, duplicate1]"));
     }
@@ -1705,7 +1722,7 @@ private <T extends Comparable<T>, V extends Comparable<T>> void testRandomTerms(
         List<Map<String, List<Object>>> dataset = new ArrayList<>();
 
         Set<T> valuesSet = new HashSet<>();
-        Map<Comparable<?>, AtomicLong> expectedDocCounts = new HashMap<> ();
+        Map<Comparable<?>, AtomicLong> expectedDocCounts = new HashMap<>();
         for (int i = 0; i < numDocs; i++) {
             int numValues = randomIntBetween(1, 5);
             Set<Object> values = new HashSet<>();
@@ -1725,13 +1742,13 @@ private <T extends Comparable<T>, V extends Comparable<T>> void testRandomTerms(
 
         List<Comparable<T>> seen = new ArrayList<>();
         AtomicBoolean finish = new AtomicBoolean(false);
-        int size = randomIntBetween(1,  expected.size());
+        int size = randomIntBetween(1, expected.size());
         while (finish.get() == false) {
             testSearchCase(Arrays.asList(new MatchAllDocsQuery(), new DocValuesFieldExistsQuery(field)), dataset,
                 () -> {
                     Map<String, Object> afterKey = null;
                     if (seen.size() > 0) {
-                        afterKey = Collections.singletonMap(field, seen.get(seen.size()-1));
+                        afterKey = Collections.singletonMap(field, seen.get(seen.size() - 1));
                     }
                     TermsValuesSourceBuilder source = new TermsValuesSourceBuilder(field).field(field);
                     return new CompositeAggregationBuilder("name", Collections.singletonList(source))
@@ -1838,44 +1855,130 @@ public void testWithGeoPoint() throws Exception {
         );
     }
 
+    public void testEarlyTermination() throws Exception {
+        final List<Map<String, List<Object>>> dataset = new ArrayList<>();
+        dataset.addAll(
+            Arrays.asList(
+                createDocument("keyword", "a", "long", 100L, "foo", "bar"),
+                createDocument("keyword", "c", "long", 100L, "foo", "bar"),
+                createDocument("keyword", "a", "long", 0L, "foo", "bar"),
+                createDocument("keyword", "d", "long", 10L, "foo", "bar"),
+                createDocument("keyword", "b", "long", 10L, "foo", "bar"),
+                createDocument("keyword", "c", "long", 10L, "foo", "bar"),
+                createDocument("keyword", "e", "long", 100L, "foo", "bar"),
+                createDocument("keyword", "e", "long", 10L, "foo", "bar")
+            )
+        );
+
+        executeTestCase(true, false, new TermQuery(new Term("foo", "bar")),
+            dataset,
+            () ->
+                new CompositeAggregationBuilder("name",
+                    Arrays.asList(
+                        new TermsValuesSourceBuilder("keyword").field("keyword"),
+                        new TermsValuesSourceBuilder("long").field("long")
+                    )).aggregateAfter(createAfterKey("keyword", "b", "long", 10L)).size(2),
+            (result) -> {
+                assertEquals(2, result.getBuckets().size());
+                assertEquals("{keyword=c, long=100}", result.afterKey().toString());
+                assertEquals("{keyword=c, long=10}", result.getBuckets().get(0).getKeyAsString());
+                assertEquals(1L, result.getBuckets().get(0).getDocCount());
+                assertEquals("{keyword=c, long=100}", result.getBuckets().get(1).getKeyAsString());
+                assertEquals(1L, result.getBuckets().get(1).getDocCount());
+                assertTrue(result.isTerminatedEarly());
+            }
+        );
+
+        // source field and index sorting config have different order
+        executeTestCase(true, false, new TermQuery(new Term("foo", "bar")),
+            dataset,
+            () ->
+                new CompositeAggregationBuilder("name",
+                    Arrays.asList(
+                        // reverse source order
+                        new TermsValuesSourceBuilder("keyword").field("keyword").order(SortOrder.DESC),
+                        new TermsValuesSourceBuilder("long").field("long").order(SortOrder.DESC)
+                    )
+                ).aggregateAfter(createAfterKey("keyword", "c", "long", 10L)).size(2),
+            (result) -> {
+                assertEquals(2, result.getBuckets().size());
+                assertEquals("{keyword=a, long=100}", result.afterKey().toString());
+                assertEquals("{keyword=b, long=10}", result.getBuckets().get(0).getKeyAsString());
+                assertEquals(1L, result.getBuckets().get(0).getDocCount());
+                assertEquals("{keyword=a, long=100}", result.getBuckets().get(1).getKeyAsString());
+                assertEquals(1L, result.getBuckets().get(1).getDocCount());
+                assertTrue(result.isTerminatedEarly());
+            }
+        );
+    }
+
     private void testSearchCase(List<Query> queries,
                                 List<Map<String, List<Object>>> dataset,
                                 Supplier<CompositeAggregationBuilder> create,
                                 Consumer<InternalComposite> verify) throws IOException {
         for (Query query : queries) {
-            executeTestCase(false, query, dataset, create, verify);
-            executeTestCase(true, query, dataset, create, verify);
+            executeTestCase(false, false, query, dataset, create, verify);
+            executeTestCase(false, true, query, dataset, create, verify);
+            executeTestCase(true, true, query, dataset, create, verify);
         }
     }
 
-    private void executeTestCase(boolean reduced,
+    private void executeTestCase(boolean useIndexSort,
+                                 boolean reduced,
                                  Query query,
                                  List<Map<String, List<Object>>> dataset,
                                  Supplier<CompositeAggregationBuilder> create,
                                  Consumer<InternalComposite> verify) throws IOException {
+        Map<String, MappedFieldType> types =
+            Arrays.stream(FIELD_TYPES).collect(Collectors.toMap(MappedFieldType::name,  Function.identity()));
+        CompositeAggregationBuilder aggregationBuilder = create.get();
+        Sort indexSort = useIndexSort ? buildIndexSort(aggregationBuilder.sources(), types) : null;
+        IndexSettings indexSettings = createIndexSettings(indexSort);
         try (Directory directory = newDirectory()) {
-            try (RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory)) {
+            IndexWriterConfig config = newIndexWriterConfig(random(), new MockAnalyzer(random()));
+            if (indexSort != null) {
+                config.setIndexSort(indexSort);
+                config.setCodec(TestUtil.getDefaultCodec());
+            }
+            try (RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory, config)) {
                 Document document = new Document();
                 for (Map<String, List<Object>> fields : dataset) {
                     addToDocument(document, fields);
                     indexWriter.addDocument(document);
                     document.clear();
                 }
+                if (reduced == false && randomBoolean()) {
+                    indexWriter.forceMerge(1);
+                }
             }
             try (IndexReader indexReader = DirectoryReader.open(directory)) {
                 IndexSearcher indexSearcher = new IndexSearcher(indexReader);
-                CompositeAggregationBuilder aggregationBuilder = create.get();
                 final InternalComposite composite;
                 if (reduced) {
-                    composite = searchAndReduce(indexSearcher, query, aggregationBuilder, FIELD_TYPES);
+                    composite = searchAndReduce(indexSettings, indexSearcher, query, aggregationBuilder, FIELD_TYPES);
                 } else {
-                    composite = search(indexSearcher, query, aggregationBuilder, FIELD_TYPES);
+                    composite = search(indexSettings, indexSearcher, query, aggregationBuilder, FIELD_TYPES);
                 }
                 verify.accept(composite);
             }
         }
     }
 
+    private static IndexSettings createIndexSettings(Sort sort) {
+        Settings.Builder builder = Settings.builder();
+        if (sort != null) {
+            String[] fields = Arrays.stream(sort.getSort())
+                .map(SortField::getField)
+                .toArray(String[]::new);
+            String[] orders = Arrays.stream(sort.getSort())
+                .map((o) -> o.getReverse() ? "desc" : "asc")
+                .toArray(String[]::new);
+            builder.putList("index.sort.field", fields);
+            builder.putList("index.sort.order", orders);
+        }
+        return IndexSettingsModule.newIndexSettings(new Index("_index", "0"), builder.build());
+    }
+
     private void addToDocument(Document doc, Map<String, List<Object>> keys) {
         for (Map.Entry<String, List<Object>> entry : keys.entrySet()) {
             final String name = entry.getKey();
@@ -1935,4 +2038,43 @@ private static Map<String, List<Object>> createDocument(Object... fields) {
     private static long asLong(String dateTime) {
         return DateFormatters.from(DateFieldMapper.DEFAULT_DATE_TIME_FORMATTER.parse(dateTime)).toInstant().toEpochMilli();
     }
+
+    private static Sort buildIndexSort(List<CompositeValuesSourceBuilder<?>> sources, Map<String, MappedFieldType> fieldTypes) {
+        List<SortField> sortFields = new ArrayList<>();
+        for (CompositeValuesSourceBuilder<?> source : sources) {
+            MappedFieldType type = fieldTypes.get(source.field());
+            if (type instanceof KeywordFieldMapper.KeywordFieldType) {
+                sortFields.add(new SortedSetSortField(type.name(), false));
+            } else if (type instanceof DateFieldMapper.DateFieldType) {
+                sortFields.add(new SortedNumericSortField(type.name(), SortField.Type.LONG, false));
+            } else if (type instanceof NumberFieldMapper.NumberFieldType) {
+                boolean comp = false;
+                switch (type.typeName()) {
+                    case "byte":
+                    case "short":
+                    case "integer":
+                        comp = true;
+                        sortFields.add(new SortedNumericSortField(type.name(), SortField.Type.INT, false));
+                        break;
+
+                    case "long":
+                        sortFields.add(new SortedNumericSortField(type.name(), SortField.Type.LONG, false));
+                        break;
+
+                    case "float":
+                    case "double":
+                        comp = true;
+                        sortFields.add(new SortedNumericSortField(type.name(), SortField.Type.DOUBLE, false));
+                        break;
+
+                    default:
+                        break;
+                }
+                if (comp == false) {
+                    break;
+                }
+            }
+        }
+        return sortFields.size() > 0 ? new Sort(sortFields.toArray(new SortField[0])) : null;
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesCollectorQueueTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesCollectorQueueTests.java
index 6516309de965f..ff893314e5988 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesCollectorQueueTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeValuesCollectorQueueTests.java
@@ -29,10 +29,16 @@
 import org.apache.lucene.index.DocValues;
 import org.apache.lucene.index.IndexOptions;
 import org.apache.lucene.index.IndexReader;
+import org.apache.lucene.index.IndexWriterConfig;
 import org.apache.lucene.index.LeafReaderContext;
 import org.apache.lucene.index.RandomIndexWriter;
+import org.apache.lucene.search.CollectionTerminatedException;
 import org.apache.lucene.search.DocIdSet;
 import org.apache.lucene.search.MatchAllDocsQuery;
+import org.apache.lucene.search.Sort;
+import org.apache.lucene.search.SortField;
+import org.apache.lucene.search.SortedNumericSortField;
+import org.apache.lucene.search.SortedSetSortField;
 import org.apache.lucene.store.Directory;
 import org.apache.lucene.util.Bits;
 import org.apache.lucene.util.BytesRef;
@@ -56,6 +62,7 @@
 import static org.elasticsearch.index.mapper.NumberFieldMapper.NumberType.DOUBLE;
 import static org.elasticsearch.index.mapper.NumberFieldMapper.NumberType.LONG;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.greaterThan;
 
 public class CompositeValuesCollectorQueueTests extends AggregatorTestCase {
     static class ClassAndName {
@@ -133,31 +140,47 @@ public void testRandom() throws IOException {
     }
 
     private void testRandomCase(ClassAndName... types) throws IOException {
-        testRandomCase(true, true, types);
-        testRandomCase(true, false, types);
-        testRandomCase(false, true, types);
-        testRandomCase(false, false, types);
+        for (int i = 0; i < types.length; i++) {
+            testRandomCase(true, true, i, types);
+            testRandomCase(true, false, i, types);
+            testRandomCase(false, true, i, types);
+            testRandomCase(false, false, i, types);
+        }
     }
 
-    private void testRandomCase(boolean forceMerge, boolean missingBucket, ClassAndName... types) throws IOException {
+    private void testRandomCase(boolean forceMerge,
+                                boolean missingBucket,
+                                int indexSortSourcePrefix,
+                                ClassAndName... types) throws IOException {
         final BigArrays bigArrays = BigArrays.NON_RECYCLING_INSTANCE;
         int numDocs = randomIntBetween(50, 100);
         List<Comparable<?>[]> possibleValues = new ArrayList<>();
-        for (ClassAndName type : types) {
+        SortField[] indexSortFields = indexSortSourcePrefix == 0 ? null : new SortField[indexSortSourcePrefix];
+        for (int i = 0; i < types.length; i++) {
+            ClassAndName type = types[i];
             final Comparable<?>[] values;
             int numValues = randomIntBetween(1, numDocs * 2);
             values = new Comparable[numValues];
             if (type.clazz == Long.class) {
-                for (int i = 0; i < numValues; i++) {
-                    values[i] = randomLong();
+                if (i < indexSortSourcePrefix) {
+                    indexSortFields[i] = new SortedNumericSortField(type.fieldType.name(), SortField.Type.LONG);
+                }
+                for (int j = 0; j < numValues; j++) {
+                    values[j] = randomLong();
                 }
             } else if (type.clazz == Double.class) {
-                for (int i = 0; i < numValues; i++) {
-                    values[i] = randomDouble();
+                if (i < indexSortSourcePrefix) {
+                    indexSortFields[i] = new SortedNumericSortField(type.fieldType.name(), SortField.Type.DOUBLE);
+                }
+                for (int j = 0; j < numValues; j++) {
+                    values[j] = randomDouble();
                 }
             } else if (type.clazz == BytesRef.class) {
-                for (int i = 0; i < numValues; i++) {
-                    values[i] = new BytesRef(randomAlphaOfLengthBetween(5, 50));
+                if (i < indexSortSourcePrefix) {
+                    indexSortFields[i] = new SortedSetSortField(type.fieldType.name(), false);
+                }
+                for (int j = 0; j < numValues; j++) {
+                    values[j] = new BytesRef(randomAlphaOfLengthBetween(5, 50));
                 }
             } else {
                 assert (false);
@@ -167,13 +190,17 @@ private void testRandomCase(boolean forceMerge, boolean missingBucket, ClassAndN
 
         Set<CompositeKey> keys = new HashSet<>();
         try (Directory directory = newDirectory()) {
+            final IndexWriterConfig writerConfig = newIndexWriterConfig();
+            if (indexSortFields != null) {
+                writerConfig.setIndexSort(new Sort(indexSortFields));
+            }
             try (RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory, new KeywordAnalyzer())) {
                 for (int i = 0; i < numDocs; i++) {
                     Document document = new Document();
                     List<List<Comparable<?>>> docValues = new ArrayList<>();
                     boolean hasAllField = true;
                     for (int j = 0; j < types.length; j++) {
-                        int numValues = randomIntBetween(0, 5);
+                        int numValues = indexSortSourcePrefix-1 >= j ? 1 : randomIntBetween(0, 5);
                         List<Comparable<?>> values = new ArrayList<>();
                         if (numValues == 0) {
                             hasAllField = false;
@@ -212,7 +239,7 @@ private void testRandomCase(boolean forceMerge, boolean missingBucket, ClassAndN
                 }
             }
             IndexReader reader = DirectoryReader.open(directory);
-            int size = randomIntBetween(1, keys.size());
+            int size = keys.size() > 1 ? randomIntBetween(1, keys.size()) : 1;
             SingleDimensionValuesSource<?>[] sources = new SingleDimensionValuesSource[types.length];
             for (int i = 0; i < types.length; i++) {
                 final MappedFieldType fieldType = types[i].fieldType;
@@ -276,21 +303,25 @@ private void testRandomCase(boolean forceMerge, boolean missingBucket, ClassAndN
                         new CompositeValuesCollectorQueue(BigArrays.NON_RECYCLING_INSTANCE, sources, size, last);
                     final SortedDocsProducer docsProducer = sources[0].createSortedDocsProducerOrNull(reader, new MatchAllDocsQuery());
                     for (LeafReaderContext leafReaderContext : reader.leaves()) {
-                        final LeafBucketCollector leafCollector = new LeafBucketCollector() {
-                            @Override
-                            public void collect(int doc, long bucket) throws IOException {
-                                queue.addIfCompetitive();
-                            }
-                        };
                         if (docsProducer != null && withProducer) {
                             assertEquals(DocIdSet.EMPTY,
                                 docsProducer.processLeaf(new MatchAllDocsQuery(), queue, leafReaderContext, false));
                         } else {
+                            final LeafBucketCollector leafCollector = new LeafBucketCollector() {
+                                @Override
+                                public void collect(int doc, long bucket) throws IOException {
+                                    queue.addIfCompetitive(indexSortSourcePrefix);
+                                }
+                            };
                             final LeafBucketCollector queueCollector = queue.getLeafCollector(leafReaderContext, leafCollector);
                             final Bits liveDocs = leafReaderContext.reader().getLiveDocs();
                             for (int i = 0; i < leafReaderContext.reader().maxDoc(); i++) {
                                 if (liveDocs == null || liveDocs.get(i)) {
-                                    queueCollector.collect(i);
+                                    try {
+                                        queueCollector.collect(i);
+                                    } catch (CollectionTerminatedException exc) {
+                                        assertThat(indexSortSourcePrefix, greaterThan(0));
+                                    }
                                 }
                             }
                         }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/InternalCompositeTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/InternalCompositeTests.java
index 98263d2ebb680..4edd694a3ac03 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/InternalCompositeTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/InternalCompositeTests.java
@@ -170,7 +170,7 @@ protected InternalComposite createTestInstance(String name, List<PipelineAggrega
         }
         Collections.sort(buckets, (o1, o2) -> o1.compareKey(o2));
         CompositeKey lastBucket = buckets.size() > 0 ? buckets.get(buckets.size()-1).getRawKey() : null;
-        return new InternalComposite(name, size, sourceNames, formats, buckets, lastBucket, reverseMuls,
+        return new InternalComposite(name, size, sourceNames, formats, buckets, lastBucket, reverseMuls, randomBoolean(),
             Collections.emptyList(), metaData);
     }
 
@@ -207,7 +207,7 @@ protected InternalComposite mutateInstance(InternalComposite instance) throws IO
         }
         CompositeKey lastBucket = buckets.size() > 0 ? buckets.get(buckets.size()-1).getRawKey() : null;
         return new InternalComposite(instance.getName(), instance.getSize(), sourceNames, formats, buckets, lastBucket, reverseMuls,
-            instance.pipelineAggregators(), metaData);
+            randomBoolean(), instance.pipelineAggregators(), metaData);
     }
 
     @Override
diff --git a/test/framework/src/main/java/org/elasticsearch/search/aggregations/AggregatorTestCase.java b/test/framework/src/main/java/org/elasticsearch/search/aggregations/AggregatorTestCase.java
index 221030cd8d157..7c02fb2481f4c 100644
--- a/test/framework/src/main/java/org/elasticsearch/search/aggregations/AggregatorTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/search/aggregations/AggregatorTestCase.java
@@ -306,7 +306,15 @@ protected <A extends InternalAggregation, C extends Aggregator> A search(IndexSe
                                                                              Query query,
                                                                              AggregationBuilder builder,
                                                                              MappedFieldType... fieldTypes) throws IOException {
-        return search(searcher, query, builder, DEFAULT_MAX_BUCKETS, fieldTypes);
+        return search(createIndexSettings(), searcher, query, builder, DEFAULT_MAX_BUCKETS, fieldTypes);
+    }
+
+    protected <A extends InternalAggregation, C extends Aggregator> A search(IndexSettings indexSettings,
+                                                                             IndexSearcher searcher,
+                                                                             Query query,
+                                                                             AggregationBuilder builder,
+                                                                             MappedFieldType... fieldTypes) throws IOException {
+        return search(indexSettings, searcher, query, builder, DEFAULT_MAX_BUCKETS, fieldTypes);
     }
 
     protected <A extends InternalAggregation, C extends Aggregator> A search(IndexSearcher searcher,
@@ -314,8 +322,17 @@ protected <A extends InternalAggregation, C extends Aggregator> A search(IndexSe
                                                                              AggregationBuilder builder,
                                                                              int maxBucket,
                                                                              MappedFieldType... fieldTypes) throws IOException {
+        return search(createIndexSettings(), searcher, query, builder, maxBucket, fieldTypes);
+    }
+
+    protected <A extends InternalAggregation, C extends Aggregator> A search(IndexSettings indexSettings,
+                                                                             IndexSearcher searcher,
+                                                                             Query query,
+                                                                             AggregationBuilder builder,
+                                                                             int maxBucket,
+                                                                             MappedFieldType... fieldTypes) throws IOException {
         MultiBucketConsumer bucketConsumer = new MultiBucketConsumer(maxBucket);
-        C a = createAggregator(query, builder, searcher, bucketConsumer, fieldTypes);
+        C a = createAggregator(query, builder, searcher, indexSettings, bucketConsumer, fieldTypes);
         a.preCollection();
         searcher.search(query, a);
         a.postCollection();
@@ -329,7 +346,23 @@ protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduc
                                                                                       Query query,
                                                                                       AggregationBuilder builder,
                                                                                       MappedFieldType... fieldTypes) throws IOException {
-        return searchAndReduce(searcher, query, builder, DEFAULT_MAX_BUCKETS, fieldTypes);
+        return searchAndReduce(createIndexSettings(), searcher, query, builder, DEFAULT_MAX_BUCKETS, fieldTypes);
+    }
+
+    protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduce(IndexSettings indexSettings,
+                                                                                      IndexSearcher searcher,
+                                                                                      Query query,
+                                                                                      AggregationBuilder builder,
+                                                                                      MappedFieldType... fieldTypes) throws IOException {
+        return searchAndReduce(indexSettings, searcher, query, builder, DEFAULT_MAX_BUCKETS, fieldTypes);
+    }
+
+    protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduce(IndexSearcher searcher,
+                                                                                      Query query,
+                                                                                      AggregationBuilder builder,
+                                                                                      int maxBucket,
+                                                                                      MappedFieldType... fieldTypes) throws IOException {
+        return searchAndReduce(createIndexSettings(), searcher, query, builder, maxBucket, fieldTypes);
     }
 
     /**
@@ -337,7 +370,8 @@ protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduc
      * builds an aggregator for each sub-searcher filtered by the provided {@link Query} and
      * returns the reduced {@link InternalAggregation}.
      */
-    protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduce(IndexSearcher searcher,
+    protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduce(IndexSettings indexSettings,
+                                                                                      IndexSearcher searcher,
                                                                                       Query query,
                                                                                       AggregationBuilder builder,
                                                                                       int maxBucket,
@@ -366,7 +400,7 @@ protected <A extends InternalAggregation, C extends Aggregator> A searchAndReduc
 
         for (ShardSearcher subSearcher : subSearchers) {
             MultiBucketConsumer shardBucketConsumer = new MultiBucketConsumer(maxBucket);
-            C a = createAggregator(query, builder, subSearcher, shardBucketConsumer, fieldTypes);
+            C a = createAggregator(query, builder, subSearcher, indexSettings, shardBucketConsumer, fieldTypes);
             a.preCollection();
             subSearcher.search(weight, a);
             a.postCollection();

From d5235fffe91f7ce1f16b2a1b96934942bdfb1791 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 17 Dec 2019 14:27:06 +0100
Subject: [PATCH 234/686] Adapt BWC after backporting #50214

---
 .../gateway/TransportNodesListGatewayStartedShards.java   | 8 ++++----
 .../store/TransportNodesListShardStoreMetaData.java       | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/gateway/TransportNodesListGatewayStartedShards.java b/server/src/main/java/org/elasticsearch/gateway/TransportNodesListGatewayStartedShards.java
index a99ba6ab2b323..9e655fec8490d 100644
--- a/server/src/main/java/org/elasticsearch/gateway/TransportNodesListGatewayStartedShards.java
+++ b/server/src/main/java/org/elasticsearch/gateway/TransportNodesListGatewayStartedShards.java
@@ -169,7 +169,7 @@ public static class Request extends BaseNodesRequest<Request> {
         public Request(StreamInput in) throws IOException {
             super(in);
             shardId = new ShardId(in);
-            if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
                 customDataPath = in.readString();
             } else {
                 customDataPath = null;
@@ -200,7 +200,7 @@ public String getCustomDataPath() {
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             shardId.writeTo(out);
-            if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
                 out.writeString(customDataPath);
             }
         }
@@ -238,7 +238,7 @@ public static class NodeRequest extends BaseNodeRequest {
         public NodeRequest(StreamInput in) throws IOException {
             super(in);
             shardId = new ShardId(in);
-            if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
                 customDataPath = in.readString();
             } else {
                 customDataPath = null;
@@ -254,7 +254,7 @@ public NodeRequest(Request request) {
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             shardId.writeTo(out);
-            if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
                 assert customDataPath != null;
                 out.writeString(customDataPath);
             }
diff --git a/server/src/main/java/org/elasticsearch/indices/store/TransportNodesListShardStoreMetaData.java b/server/src/main/java/org/elasticsearch/indices/store/TransportNodesListShardStoreMetaData.java
index 1e4ef6781a761..1f00ee1d42ab1 100644
--- a/server/src/main/java/org/elasticsearch/indices/store/TransportNodesListShardStoreMetaData.java
+++ b/server/src/main/java/org/elasticsearch/indices/store/TransportNodesListShardStoreMetaData.java
@@ -268,7 +268,7 @@ public static class Request extends BaseNodesRequest<Request> {
         public Request(StreamInput in) throws IOException {
             super(in);
             shardId = new ShardId(in);
-            if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
                 customDataPath = in.readString();
             } else {
                 customDataPath = null;
@@ -299,7 +299,7 @@ public String getCustomDataPath() {
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             shardId.writeTo(out);
-            if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
                 out.writeString(customDataPath);
             }
         }
@@ -336,7 +336,7 @@ public static class NodeRequest extends BaseNodeRequest {
         public NodeRequest(StreamInput in) throws IOException {
             super(in);
             shardId = new ShardId(in);
-            if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
                 customDataPath = in.readString();
             } else {
                 customDataPath = null;
@@ -352,7 +352,7 @@ public NodeRequest(Request request) {
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             shardId.writeTo(out);
-            if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
                 assert customDataPath != null;
                 out.writeString(customDataPath);
             }

From fecb64d0401acc302a41e807fb92264171782026 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 17 Dec 2019 14:46:43 +0100
Subject: [PATCH 235/686] Fix S3 Repo Tests Incomplete Reads (#50268)

We need to read in a loop here. A single read to a huge byte array will
only read 16k max with the S3 SDK so if the blob we're trying to fully
read is larger we close early and fail the size comparison.
Also, drain streams fully when checking existence to avoid S3 SDK warnings.
---
 .../repositories/blobstore/BlobStoreTestUtil.java           | 6 +++++-
 .../blobstore/ESBlobStoreRepositoryIntegTestCase.java       | 3 ++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
index 75a2f70cd4f89..75f6a660fb13d 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
@@ -96,8 +96,12 @@ public static void assertRepoConsistency(InternalTestCluster testCluster, String
         BlobStoreTestUtil.assertConsistency(repo, repo.threadPool().executor(ThreadPool.Names.GENERIC));
     }
 
+    private static final byte[] SINK = new byte[1024];
+
     public static boolean blobExists(BlobContainer container, String blobName) throws IOException {
-        try (InputStream ignored = container.readBlob(blobName)) {
+        try (InputStream input = container.readBlob(blobName)) {
+            // Drain input stream fully to avoid warnings from SDKs like S3 that don't like closing streams mid-way
+            while (input.read(SINK) >= 0);
             return true;
         } catch (NoSuchFileException e) {
             return false;
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
index f2e96603fcc98..62af8e26da073 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
@@ -34,6 +34,7 @@
 import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.blobstore.BlobStore;
 import org.elasticsearch.common.bytes.BytesArray;
+import org.elasticsearch.common.io.Streams;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.repositories.IndexId;
 import org.elasticsearch.repositories.RepositoriesService;
@@ -236,7 +237,7 @@ public static byte[] writeRandomBlob(BlobContainer container, String name, int l
     public static byte[] readBlobFully(BlobContainer container, String name, int length) throws IOException {
         byte[] data = new byte[length];
         try (InputStream inputStream = container.readBlob(name)) {
-            assertThat(inputStream.read(data), CoreMatchers.equalTo(length));
+            assertThat(Streams.readFully(inputStream, data), CoreMatchers.equalTo(length));
             assertThat(inputStream.read(), CoreMatchers.equalTo(-1));
         }
         return data;

From 8e8cbc1ca76ad5ec3ef5bda6fbee77a224ee4cb2 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Tue, 17 Dec 2019 09:31:07 -0500
Subject: [PATCH 236/686] [DOCS] Add identifier mapping tip to numeric and
 keyword datatype docs (#49933)

Users often mistakenly map numeric IDs to numeric datatypes. However,
this is often slow for the `term` and other term-level queries.

The "Tune for search speed" docs includes advice for mapping numeric
IDs to `keyword` fields. However, this tip is not included in the
`numeric` or `keyword` field datatype doc pages.

This rewords the tip in the "Tune for search speed" docs, relocates it
to the `numeric` field docs, and reuses it using tagged regions.
---
 docs/reference/how-to/search-speed.asciidoc   |  8 +-----
 docs/reference/mapping/types/keyword.asciidoc | 10 ++++++--
 docs/reference/mapping/types/numeric.asciidoc | 25 +++++++++++++++++++
 3 files changed, 34 insertions(+), 9 deletions(-)

diff --git a/docs/reference/how-to/search-speed.asciidoc b/docs/reference/how-to/search-speed.asciidoc
index 91337b0b0a1c8..a275af5fead29 100644
--- a/docs/reference/how-to/search-speed.asciidoc
+++ b/docs/reference/how-to/search-speed.asciidoc
@@ -159,13 +159,7 @@ GET index/_search
 [[map-ids-as-keyword]]
 === Consider mapping identifiers as `keyword`
 
-The fact that some data is numeric does not mean it should always be mapped as a
-<<number,numeric field>>. The way that Elasticsearch indexes numbers optimizes
-for `range` queries while `keyword` fields are better at `term` queries. Typically, 
-fields storing identifiers such as an `ISBN` or any number identifying a record 
-from another database are rarely used in `range` queries or aggregations. This is
-why they might benefit from being mapped as <<keyword,`keyword`>> rather than as 
-`integer` or `long`.
+include::../mapping/types/numeric.asciidoc[tag=map-ids-as-keyword]
 
 [float]
 === Avoid scripts
diff --git a/docs/reference/mapping/types/keyword.asciidoc b/docs/reference/mapping/types/keyword.asciidoc
index e1051754c208e..71419b378faae 100644
--- a/docs/reference/mapping/types/keyword.asciidoc
+++ b/docs/reference/mapping/types/keyword.asciidoc
@@ -4,8 +4,8 @@
 <titleabbrev>Keyword</titleabbrev>
 ++++
 
-A field to index structured content such as email addresses, hostnames, status
-codes, zip codes or tags.
+A field to index structured content such as IDs, email addresses, hostnames,
+status codes, zip codes or tags.
 
 They are typically used for filtering (_Find me all blog posts where
 ++status++ is ++published++_), for sorting, and for aggregations. Keyword
@@ -30,6 +30,12 @@ PUT my_index
 }
 --------------------------------
 
+[TIP]
+.Mapping numeric identifiers
+====
+include::numeric.asciidoc[tag=map-ids-as-keyword]
+====
+
 [[keyword-params]]
 ==== Parameters for keyword fields
 
diff --git a/docs/reference/mapping/types/numeric.asciidoc b/docs/reference/mapping/types/numeric.asciidoc
index 72bc672b8c672..8280945b22777 100644
--- a/docs/reference/mapping/types/numeric.asciidoc
+++ b/docs/reference/mapping/types/numeric.asciidoc
@@ -80,6 +80,31 @@ to help make a decision.
 |`half_float`|+2^-24^+ |+65504+ |+11+ / +3.31+
 |=======================================================================
 
+[TIP]
+.Mapping numeric identifiers
+====
+// tag::map-ids-as-keyword[]
+Not all numeric data should be mapped as a <<number,numeric>> field datatype.
+{es} optimizes numeric fields, such as `integer` or `long`, for
+<<query-dsl-range-query,`range`>> queries. However, <<keyword,`keyword`>> fields
+are better for <<query-dsl-term-query,`term`>> and other
+<<term-level-queries,term-level>> queries.
+
+Identifiers, such as an ISBN or a product ID, are rarely used in `range`
+queries. However, they are often retrieved using term-level queries.
+
+Consider mapping a numeric identifier as a `keyword` if:
+
+* You don't plan to search for the identifier data using 
+  <<query-dsl-range-query,`range`>> queries.
+* Fast retrieval is important. `term` query searches on `keyword` fields are
+  often faster than `term` searches on numeric fields.
+
+If you're unsure which to use, you can use a <<multi-fields,multi-field>> to map
+the data as both a `keyword` _and_ a numeric datatype.
+// end::map-ids-as-keyword[]
+====
+
 [[number-params]]
 ==== Parameters for numeric fields
 

From c46db5b908b38cda3e0d9d557268439420adebd9 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Tue, 17 Dec 2019 15:20:46 +0000
Subject: [PATCH 237/686] [ML] Delete unused data frame analytics state
 (#50243)

This commit adds removal of unused data frame analytics state
from the _delete_expired_data API (and in extend th ML daily
maintenance task). At the moment the potential state docs
include the progress document and state for regression and
classification analyses.
---
 .../dataframe/DataFrameAnalyticsConfig.java   | 10 +++++
 .../ml/dataframe/analyses/Classification.java |  9 ++++-
 .../ml/dataframe/analyses/Regression.java     |  9 ++++-
 .../DataFrameAnalyticsConfigTests.java        |  8 ++++
 .../analyses/ClassificationTests.java         |  5 +++
 .../dataframe/analyses/RegressionTests.java   |  5 +++
 .../ml/integration/ClassificationIT.java      | 34 ++++++++++++++++
 .../ml/integration/DeleteExpiredDataIT.java   |  7 +---
 .../MlNativeAutodetectIntegTestCase.java      |  2 +-
 ...NativeDataFrameAnalyticsIntegTestCase.java |  4 +-
 .../ml/integration/MlNativeIntegTestCase.java | 11 +++++
 .../xpack/ml/integration/RegressionIT.java    | 34 ++++++++++++++++
 ...ansportDeleteDataFrameAnalyticsAction.java |  4 +-
 ...sportGetDataFrameAnalyticsStatsAction.java |  2 +-
 .../ml/dataframe/DataFrameAnalyticsTask.java  |  6 +--
 .../xpack/ml/dataframe/StoredProgress.java    | 14 +++++++
 .../job/persistence/BatchedJobsIterator.java  |  1 +
 .../persistence/BatchedResultsIterator.java   |  1 +
 .../BatchedStateDocIdsIterator.java           |  1 +
 .../job/process/normalizer/ScoresUpdater.java |  2 +-
 .../ml/job/retention/UnusedStateRemover.java  | 32 ++++++++++++++-
 .../persistence/BatchedDocumentsIterator.java |  2 +-
 .../DocIdBatchedDocumentIterator.java         | 40 +++++++++++++++++++
 .../ml/dataframe/StoredProgressTests.java     | 12 ++++++
 .../BatchedDocumentsIteratorTests.java        |  2 +-
 25 files changed, 235 insertions(+), 22 deletions(-)
 rename x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/{job => utils}/persistence/BatchedDocumentsIterator.java (99%)
 create mode 100644 x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/DocIdBatchedDocumentIterator.java
 rename x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/{job => utils}/persistence/BatchedDocumentsIteratorTests.java (99%)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
index 1142b5411fb0c..d8dcd4ee43a66 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfig.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.core.ml.dataframe;
 
 import org.elasticsearch.Version;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -310,6 +311,15 @@ public static String documentId(String id) {
         return TYPE + "-" + id;
     }
 
+    /**
+     * Returns the job id from the doc id. Returns {@code null} if the doc id is invalid.
+     */
+    @Nullable
+    public static String extractJobIdFromDocId(String docId) {
+        String jobId = docId.replaceAll("^" + TYPE +"-", "");
+        return jobId.equals(docId) ? null : jobId;
+    }
+
     public static class Builder {
 
         private String id;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
index cbd78b4f3baab..f3afd387e10b5 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
@@ -39,6 +39,8 @@ public class Classification implements DataFrameAnalysis {
     public static final ParseField TRAINING_PERCENT = new ParseField("training_percent");
     public static final ParseField RANDOMIZE_SEED = new ParseField("randomize_seed");
 
+    private static final String STATE_DOC_ID_SUFFIX = "_classification_state#1";
+
     private static final ConstructingObjectParser<Classification, Void> LENIENT_PARSER = createParser(true);
     private static final ConstructingObjectParser<Classification, Void> STRICT_PARSER = createParser(false);
 
@@ -256,7 +258,12 @@ public boolean persistsState() {
 
     @Override
     public String getStateDocId(String jobId) {
-        return jobId + "_classification_state#1";
+        return jobId + STATE_DOC_ID_SUFFIX;
+    }
+
+    public static String extractJobIdFromStateDoc(String stateDocId) {
+        int suffixIndex = stateDocId.lastIndexOf(STATE_DOC_ID_SUFFIX);
+        return suffixIndex <= 0 ? null : stateDocId.substring(0, suffixIndex);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
index 8fffcd0f573da..27c8a3f2eb7ca 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
@@ -36,6 +36,8 @@ public class Regression implements DataFrameAnalysis {
     public static final ParseField TRAINING_PERCENT = new ParseField("training_percent");
     public static final ParseField RANDOMIZE_SEED = new ParseField("randomize_seed");
 
+    private static final String STATE_DOC_ID_SUFFIX = "_regression_state#1";
+
     private static final ConstructingObjectParser<Regression, Void> LENIENT_PARSER = createParser(true);
     private static final ConstructingObjectParser<Regression, Void> STRICT_PARSER = createParser(false);
 
@@ -196,7 +198,12 @@ public boolean persistsState() {
 
     @Override
     public String getStateDocId(String jobId) {
-        return jobId + "_regression_state#1";
+        return jobId + STATE_DOC_ID_SUFFIX;
+    }
+
+    public static String extractJobIdFromStateDoc(String stateDocId) {
+        int suffixIndex = stateDocId.lastIndexOf(STATE_DOC_ID_SUFFIX);
+        return suffixIndex <= 0 ? null : stateDocId.substring(0, suffixIndex);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
index 880bea8884658..428b63554d8cf 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
@@ -53,6 +53,7 @@
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.notNullValue;
+import static org.hamcrest.Matchers.nullValue;
 import static org.hamcrest.Matchers.startsWith;
 
 public class DataFrameAnalyticsConfigTests extends AbstractSerializingTestCase<DataFrameAnalyticsConfig> {
@@ -384,6 +385,13 @@ public void testToXContent_GivenAnalysisWithRandomizeSeedAndVersionIsBeforeItWas
         }
     }
 
+    public void testExtractJobIdFromDocId() {
+        assertThat(DataFrameAnalyticsConfig.extractJobIdFromDocId("data_frame_analytics_config-foo"), equalTo("foo"));
+        assertThat(DataFrameAnalyticsConfig.extractJobIdFromDocId("data_frame_analytics_config-data_frame_analytics_config-foo"),
+            equalTo("data_frame_analytics_config-foo"));
+        assertThat(DataFrameAnalyticsConfig.extractJobIdFromDocId("foo"), is(nullValue()));
+    }
+
     private static void assertTooSmall(ElasticsearchStatusException e) {
         assertThat(e.getMessage(), startsWith("model_memory_limit must be at least 1kb."));
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
index 75a7410f181ba..533839e40b524 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
@@ -216,4 +216,9 @@ public void testGetStateDocId() {
         String randomId = randomAlphaOfLength(10);
         assertThat(classification.getStateDocId(randomId), equalTo(randomId + "_classification_state#1"));
     }
+
+    public void testExtractJobIdFromStateDoc() {
+        assertThat(Classification.extractJobIdFromStateDoc("foo_bar-1_classification_state#1"), equalTo("foo_bar-1"));
+        assertThat(Classification.extractJobIdFromStateDoc("noop"), is(nullValue()));
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
index 58e19f6ef6a2a..1a1dc79ad2a12 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
@@ -110,6 +110,11 @@ public void testGetStateDocId() {
         assertThat(regression.getStateDocId(randomId), equalTo(randomId + "_regression_state#1"));
     }
 
+    public void testExtractJobIdFromStateDoc() {
+        assertThat(Regression.extractJobIdFromStateDoc("foo_bar-1_regression_state#1"), equalTo("foo_bar-1"));
+        assertThat(Regression.extractJobIdFromStateDoc("noop"), is(nullValue()));
+    }
+
     public void testToXContent_GivenVersionBeforeRandomizeSeedWasIntroduced() throws IOException {
         Regression regression = createRandom();
         assertThat(regression.getRandomizeSeed(), is(notNullValue()));
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 0c486fdeee678..40138b826e462 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -10,6 +10,7 @@
 import org.elasticsearch.action.admin.indices.refresh.RefreshRequest;
 import org.elasticsearch.action.bulk.BulkRequestBuilder;
 import org.elasticsearch.action.bulk.BulkResponse;
+import org.elasticsearch.action.delete.DeleteResponse;
 import org.elasticsearch.action.get.GetResponse;
 import org.elasticsearch.action.index.IndexAction;
 import org.elasticsearch.action.index.IndexRequest;
@@ -17,6 +18,7 @@
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
@@ -315,6 +317,38 @@ public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exceptio
         assertThat(secondRunTrainingRowsIds, equalTo(firstRunTrainingRowsIds));
     }
 
+    public void testDeleteExpiredData_RemovesUnusedState() throws Exception {
+        initialize("classification_delete_expired_data");
+        indexData(sourceIndex, 100, 0, KEYWORD_FIELD);
+
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(KEYWORD_FIELD));
+        registerAnalytics(config);
+        putAnalytics(config);
+        startAnalytics(jobId);
+        waitUntilAnalyticsIsStopped(jobId);
+
+        assertProgress(jobId, 100, 100, 100, 100);
+        assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
+        assertInferenceModelPersisted(jobId);
+
+        // Call _delete_expired_data API and check nothing was deleted
+        assertThat(deleteExpiredData().isDeleted(), is(true));
+        assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
+
+        // Delete the config straight from the config index
+        DeleteResponse deleteResponse = client().prepareDelete(".ml-config", DataFrameAnalyticsConfig.documentId(jobId))
+            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE).execute().actionGet();
+        assertThat(deleteResponse.status(), equalTo(RestStatus.OK));
+
+        // Now calling the _delete_expired_data API should remove unused state
+        assertThat(deleteExpiredData().isDeleted(), is(true));
+
+        SearchResponse stateIndexSearchResponse = client().prepareSearch(".ml-state").execute().actionGet();
+        assertThat(stateIndexSearchResponse.getHits().getTotalHits().value, equalTo(0L));
+    }
+
     private void initialize(String jobId) {
         this.jobId = jobId;
         this.sourceIndex = jobId + "_source_index";
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DeleteExpiredDataIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DeleteExpiredDataIT.java
index 26d168b5267c4..34bd7989f6a7b 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DeleteExpiredDataIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DeleteExpiredDataIT.java
@@ -87,7 +87,7 @@ public void tearDownData() {
         cleanUp();
     }
 
-    public void testDeleteExpiredDataGivenNothingToDelete() throws Exception {
+    public void testDeleteExpiredData_GivenNothingToDelete() throws Exception {
         // Tests that nothing goes wrong when there's nothing to delete
         client().execute(DeleteExpiredDataAction.INSTANCE, new DeleteExpiredDataAction.Request()).get();
     }
@@ -201,10 +201,7 @@ public void testDeleteExpiredData() throws Exception {
         assertThat(indexUnusedStateDocsResponse.get().status(), equalTo(RestStatus.OK));
 
         // Now call the action under test
-        client().execute(DeleteExpiredDataAction.INSTANCE, new DeleteExpiredDataAction.Request()).get();
-
-        // We need to refresh to ensure the deletion is visible
-        client().admin().indices().prepareRefresh("*").get();
+        assertThat(deleteExpiredData().isDeleted(), is(true));
 
         // no-retention job should have kept all data
         assertThat(getBuckets("no-retention").size(), is(greaterThanOrEqualTo(70)));
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeAutodetectIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeAutodetectIntegTestCase.java
index fad76f8b23f80..2d41cf6409700 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeAutodetectIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeAutodetectIntegTestCase.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.search.SearchHits;
 import org.elasticsearch.search.sort.SortBuilders;
 import org.elasticsearch.search.sort.SortOrder;
+import org.elasticsearch.xpack.core.action.util.PageParams;
 import org.elasticsearch.xpack.core.ml.action.CloseJobAction;
 import org.elasticsearch.xpack.core.ml.action.DeleteDatafeedAction;
 import org.elasticsearch.xpack.core.ml.action.DeleteJobAction;
@@ -45,7 +46,6 @@
 import org.elasticsearch.xpack.core.ml.action.StopDatafeedAction;
 import org.elasticsearch.xpack.core.ml.action.UpdateDatafeedAction;
 import org.elasticsearch.xpack.core.ml.action.UpdateJobAction;
-import org.elasticsearch.xpack.core.action.util.PageParams;
 import org.elasticsearch.xpack.core.ml.calendars.Calendar;
 import org.elasticsearch.xpack.core.ml.calendars.ScheduledEvent;
 import org.elasticsearch.xpack.core.ml.datafeed.DatafeedConfig;
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
index 980f5f4da5ecb..a8c96c22c6f18 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeDataFrameAnalyticsIntegTestCase.java
@@ -40,7 +40,7 @@
 import org.elasticsearch.xpack.core.ml.notifications.AuditorField;
 import org.elasticsearch.xpack.core.ml.utils.PhaseProgress;
 import org.elasticsearch.xpack.core.ml.utils.QueryProvider;
-import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask;
+import org.elasticsearch.xpack.ml.dataframe.StoredProgress;
 import org.hamcrest.Matcher;
 import org.hamcrest.Matchers;
 
@@ -205,7 +205,7 @@ protected void assertProgress(String id, int reindexing, int loadingData, int an
     }
 
     protected SearchResponse searchStoredProgress(String jobId) {
-        String docId = DataFrameAnalyticsTask.progressDocId(jobId);
+        String docId = StoredProgress.documentId(jobId);
         return client().prepareSearch(AnomalyDetectorsIndex.jobStateIndexPattern())
             .setQuery(QueryBuilders.idsQuery().addIds(docId))
             .get();
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeIntegTestCase.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeIntegTestCase.java
index b26387d0b3d72..2393ad1023549 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeIntegTestCase.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/MlNativeIntegTestCase.java
@@ -30,6 +30,7 @@
 import org.elasticsearch.xpack.core.ml.MachineLearningField;
 import org.elasticsearch.xpack.core.ml.MlMetadata;
 import org.elasticsearch.xpack.core.ml.MlTasks;
+import org.elasticsearch.xpack.core.ml.action.DeleteExpiredDataAction;
 import org.elasticsearch.xpack.core.ml.action.OpenJobAction;
 import org.elasticsearch.xpack.core.ml.action.StartDataFrameAnalyticsAction;
 import org.elasticsearch.xpack.core.ml.action.StartDatafeedAction;
@@ -142,6 +143,16 @@ private void waitForPendingTasks() {
         }
     }
 
+    protected DeleteExpiredDataAction.Response deleteExpiredData() throws Exception {
+        DeleteExpiredDataAction.Response response = client().execute(DeleteExpiredDataAction.INSTANCE,
+            new DeleteExpiredDataAction.Request()).get();
+
+        // We need to refresh to ensure the deletion is visible
+        client().admin().indices().prepareRefresh("*").get();
+
+        return response;
+    }
+
     @Override
     protected void ensureClusterStateConsistency() throws IOException {
         if (cluster() != null && cluster().size() > 0) {
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
index 29480d711f37f..d9ad6d1e0a32e 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
@@ -7,11 +7,13 @@
 
 import org.elasticsearch.action.bulk.BulkRequestBuilder;
 import org.elasticsearch.action.bulk.BulkResponse;
+import org.elasticsearch.action.delete.DeleteResponse;
 import org.elasticsearch.action.get.GetResponse;
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsState;
@@ -272,6 +274,38 @@ public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exceptio
         assertThat(secondRunTrainingRowsIds, equalTo(firstRunTrainingRowsIds));
     }
 
+    public void testDeleteExpiredData_RemovesUnusedState() throws Exception {
+        initialize("regression_delete_expired_data");
+        indexData(sourceIndex, 100, 0);
+
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Regression(DEPENDENT_VARIABLE_FIELD));
+        registerAnalytics(config);
+        putAnalytics(config);
+        startAnalytics(jobId);
+        waitUntilAnalyticsIsStopped(jobId);
+
+        assertProgress(jobId, 100, 100, 100, 100);
+        assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
+        assertInferenceModelPersisted(jobId);
+
+        // Call _delete_expired_data API and check nothing was deleted
+        assertThat(deleteExpiredData().isDeleted(), is(true));
+        assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
+
+        // Delete the config straight from the config index
+        DeleteResponse deleteResponse = client().prepareDelete(".ml-config", DataFrameAnalyticsConfig.documentId(jobId))
+            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE).execute().actionGet();
+        assertThat(deleteResponse.status(), equalTo(RestStatus.OK));
+
+        // Now calling the _delete_expired_data API should remove unused state
+        assertThat(deleteExpiredData().isDeleted(), is(true));
+
+        SearchResponse stateIndexSearchResponse = client().prepareSearch(".ml-state").execute().actionGet();
+        assertThat(stateIndexSearchResponse.getHits().getTotalHits().value, equalTo(0L));
+    }
+
     private void initialize(String jobId) {
         this.jobId = jobId;
         this.sourceIndex = jobId + "_source_index";
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
index 9d221f9c68f6f..d42cf9684cca9 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
@@ -43,7 +43,7 @@
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
-import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask;
+import org.elasticsearch.xpack.ml.dataframe.StoredProgress;
 import org.elasticsearch.xpack.ml.dataframe.persistence.DataFrameAnalyticsConfigProvider;
 import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
 import org.elasticsearch.xpack.ml.process.MlMemoryTracker;
@@ -165,7 +165,7 @@ private void deleteState(ParentTaskAssigningClient parentTaskClient,
                              DataFrameAnalyticsConfig config,
                              ActionListener<BulkByScrollResponse> listener) {
         List<String> ids = new ArrayList<>();
-        ids.add(DataFrameAnalyticsTask.progressDocId(config.getId()));
+        ids.add(StoredProgress.documentId(config.getId()));
         if (config.getAnalysis().persistsState()) {
             ids.add(config.getAnalysis().getStateDocId(config.getId()));
         }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetDataFrameAnalyticsStatsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetDataFrameAnalyticsStatsAction.java
index aadd6041ae642..4b35b092285e2 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetDataFrameAnalyticsStatsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetDataFrameAnalyticsStatsAction.java
@@ -187,7 +187,7 @@ private void searchStoredProgresses(List<String> configIds, ActionListener<List<
             SearchRequest searchRequest = new SearchRequest(AnomalyDetectorsIndex.jobStateIndexPattern());
             searchRequest.indicesOptions(IndicesOptions.lenientExpandOpen());
             searchRequest.source().size(1);
-            searchRequest.source().query(QueryBuilders.idsQuery().addIds(DataFrameAnalyticsTask.progressDocId(configId)));
+            searchRequest.source().query(QueryBuilders.idsQuery().addIds(StoredProgress.documentId(configId)));
             multiSearchRequest.add(searchRequest);
         }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
index 55f5ef6be5353..df293e6502d22 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
@@ -244,7 +244,7 @@ private void persistProgress(Runnable runnable) {
             statsResponse -> {
                 GetDataFrameAnalyticsStatsAction.Response.Stats stats = statsResponse.getResponse().results().get(0);
                 IndexRequest indexRequest = new IndexRequest(AnomalyDetectorsIndex.jobStateIndexWriteAlias());
-                indexRequest.id(progressDocId(taskParams.getId()));
+                indexRequest.id(StoredProgress.documentId(taskParams.getId()));
                 indexRequest.setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
                 try (XContentBuilder jsonBuilder = JsonXContent.contentBuilder()) {
                     new StoredProgress(stats.getProgress()).toXContent(jsonBuilder, Payload.XContent.EMPTY_PARAMS);
@@ -310,10 +310,6 @@ public static StartingState determineStartingState(String jobId, List<PhaseProgr
         }
     }
 
-    public static String progressDocId(String id) {
-        return "data_frame_analytics-" + id + "-progress";
-    }
-
     public static class ProgressTracker {
 
         public static final String REINDEXING = "reindexing";
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/StoredProgress.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/StoredProgress.java
index 9c08a0b3012e1..cbf3cf6f16a9a 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/StoredProgress.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/StoredProgress.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.ml.dataframe;
 
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.ToXContentObject;
@@ -14,6 +15,8 @@
 import java.io.IOException;
 import java.util.List;
 import java.util.Objects;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
 
 public class StoredProgress implements ToXContentObject {
 
@@ -57,4 +60,15 @@ public boolean equals(Object o) {
     public int hashCode() {
         return Objects.hash(progress);
     }
+
+    public static String documentId(String id) {
+        return "data_frame_analytics-" + id + "-progress";
+    }
+
+    @Nullable
+    public static String extractJobIdFromDocId(String docId) {
+        Pattern pattern = Pattern.compile("^data_frame_analytics-(.*)-progress$");
+        Matcher matcher = pattern.matcher(docId);
+        return matcher.find() ? matcher.group(1) : null;
+    }
 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedJobsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedJobsIterator.java
index e274b720e701f..1b72c1901d9bb 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedJobsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedJobsIterator.java
@@ -16,6 +16,7 @@
 import org.elasticsearch.index.query.TermQueryBuilder;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
+import org.elasticsearch.xpack.ml.utils.persistence.BatchedDocumentsIterator;
 
 import java.io.IOException;
 import java.io.InputStream;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedResultsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedResultsIterator.java
index b5f45bc35c1b1..1c0fdbe08c9c6 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedResultsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedResultsIterator.java
@@ -10,6 +10,7 @@
 import org.elasticsearch.index.query.TermsQueryBuilder;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.elasticsearch.xpack.core.ml.job.results.Result;
+import org.elasticsearch.xpack.ml.utils.persistence.BatchedDocumentsIterator;
 
 public abstract class BatchedResultsIterator<T> extends BatchedDocumentsIterator<Result<T>> {
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedStateDocIdsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedStateDocIdsIterator.java
index 92235570b47b5..65e8b75671151 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedStateDocIdsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedStateDocIdsIterator.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.SearchHit;
+import org.elasticsearch.xpack.ml.utils.persistence.BatchedDocumentsIterator;
 
 /**
  * Iterates through the state doc ids
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/ScoresUpdater.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/ScoresUpdater.java
index 47ab2364db67e..23834f6949355 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/ScoresUpdater.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/ScoresUpdater.java
@@ -12,7 +12,7 @@
 import org.elasticsearch.xpack.core.ml.job.results.Bucket;
 import org.elasticsearch.xpack.core.ml.job.results.Influencer;
 import org.elasticsearch.xpack.core.ml.job.results.Result;
-import org.elasticsearch.xpack.ml.job.persistence.BatchedDocumentsIterator;
+import org.elasticsearch.xpack.ml.utils.persistence.BatchedDocumentsIterator;
 import org.elasticsearch.xpack.ml.job.persistence.JobRenormalizedResultsPersister;
 import org.elasticsearch.xpack.ml.job.persistence.JobResultsProvider;
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/UnusedStateRemover.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/UnusedStateRemover.java
index c603502afd5d6..8a1d30382489f 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/UnusedStateRemover.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/UnusedStateRemover.java
@@ -16,14 +16,19 @@
 import org.elasticsearch.index.reindex.DeleteByQueryAction;
 import org.elasticsearch.index.reindex.DeleteByQueryRequest;
 import org.elasticsearch.xpack.core.ml.MlMetadata;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.elasticsearch.xpack.core.ml.job.persistence.ElasticsearchMappings;
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.CategorizerState;
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.ModelState;
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.Quantiles;
+import org.elasticsearch.xpack.ml.dataframe.StoredProgress;
 import org.elasticsearch.xpack.ml.job.persistence.BatchedJobsIterator;
 import org.elasticsearch.xpack.ml.job.persistence.BatchedStateDocIdsIterator;
+import org.elasticsearch.xpack.ml.utils.persistence.DocIdBatchedDocumentIterator;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -93,6 +98,13 @@ private List<String> findUnusedStateDocIds() {
 
     private Set<String> getJobIds() {
         Set<String> jobIds = new HashSet<>();
+        jobIds.addAll(getAnamalyDetectionJobIds());
+        jobIds.addAll(getDataFrameAnalyticsJobIds());
+        return jobIds;
+    }
+
+    private Set<String> getAnamalyDetectionJobIds() {
+        Set<String> jobIds = new HashSet<>();
 
         // TODO Once at 8.0, we can stop searching for jobs in cluster state
         // and remove cluster service as a member all together.
@@ -106,6 +118,18 @@ private Set<String> getJobIds() {
         return jobIds;
     }
 
+    private Set<String> getDataFrameAnalyticsJobIds() {
+        Set<String> jobIds = new HashSet<>();
+
+        DocIdBatchedDocumentIterator iterator = new DocIdBatchedDocumentIterator(client, AnomalyDetectorsIndex.configIndexName(),
+            QueryBuilders.termQuery(DataFrameAnalyticsConfig.CONFIG_TYPE.getPreferredName(), DataFrameAnalyticsConfig.TYPE));
+        while (iterator.hasNext()) {
+            Deque<String> docIds = iterator.next();
+            docIds.stream().map(DataFrameAnalyticsConfig::extractJobIdFromDocId).filter(Objects::nonNull).forEach(jobIds::add);
+        }
+        return jobIds;
+    }
+
     private void executeDeleteUnusedStateDocs(List<String> unusedDocIds, ActionListener<Boolean> listener) {
         LOGGER.info("Found [{}] unused state documents; attempting to delete",
                 unusedDocIds.size());
@@ -137,7 +161,13 @@ private void executeDeleteUnusedStateDocs(List<String> unusedDocIds, ActionListe
     private static class JobIdExtractor {
 
         private static List<Function<String, String>> extractors = Arrays.asList(
-            ModelState::extractJobId, Quantiles::extractJobId, CategorizerState::extractJobId);
+            ModelState::extractJobId,
+            Quantiles::extractJobId,
+            CategorizerState::extractJobId,
+            Classification::extractJobIdFromStateDoc,
+            Regression::extractJobIdFromStateDoc,
+            StoredProgress::extractJobIdFromDocId
+        );
 
         private static String extractJobId(String docId) {
             String jobId;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedDocumentsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIterator.java
similarity index 99%
rename from x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedDocumentsIterator.java
rename to x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIterator.java
index 4aebbd0743d28..119dcbdb42822 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedDocumentsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIterator.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.ml.job.persistence;
+package org.elasticsearch.xpack.ml.utils.persistence;
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/DocIdBatchedDocumentIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/DocIdBatchedDocumentIterator.java
new file mode 100644
index 0000000000000..55b2cee2ff16d
--- /dev/null
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/DocIdBatchedDocumentIterator.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.utils.persistence;
+
+import org.elasticsearch.client.Client;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.search.SearchHit;
+
+import java.util.Objects;
+
+/**
+ * This is a document iterator that returns just the id of each matched document.
+ */
+public class DocIdBatchedDocumentIterator extends BatchedDocumentsIterator<String> {
+
+    private final QueryBuilder query;
+
+    public DocIdBatchedDocumentIterator(Client client, String index, QueryBuilder query) {
+        super(client, index);
+        this.query = Objects.requireNonNull(query);
+    }
+
+    @Override
+    protected QueryBuilder getQuery() {
+        return query;
+    }
+
+    @Override
+    protected String map(SearchHit hit) {
+        return hit.getId();
+    }
+
+    @Override
+    protected boolean shouldFetchSource() {
+        return false;
+    }
+}
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/StoredProgressTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/StoredProgressTests.java
index 572ca816f81e6..0524fbd37c336 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/StoredProgressTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/StoredProgressTests.java
@@ -13,6 +13,8 @@
 import java.util.ArrayList;
 import java.util.List;
 
+import static org.hamcrest.Matchers.equalTo;
+
 public class StoredProgressTests extends AbstractXContentTestCase<StoredProgress> {
 
     @Override
@@ -34,4 +36,14 @@ protected StoredProgress createTestInstance() {
         }
         return new StoredProgress(progress);
     }
+
+    public void testDocumentId() {
+        assertThat(StoredProgress.documentId("foo"), equalTo("data_frame_analytics-foo-progress"));
+    }
+
+    public void testExtractJobIdFromDocId() {
+        assertThat(StoredProgress.extractJobIdFromDocId("data_frame_analytics-foo-progress"), equalTo("foo"));
+        assertThat(StoredProgress.extractJobIdFromDocId("data_frame_analytics-data_frame_analytics-bar-progress-progress"),
+            equalTo("data_frame_analytics-bar-progress"));
+    }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/BatchedDocumentsIteratorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIteratorTests.java
similarity index 99%
rename from x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/BatchedDocumentsIteratorTests.java
rename to x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIteratorTests.java
index 5b81002d9326c..381ff0612abe2 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/BatchedDocumentsIteratorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIteratorTests.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.ml.job.persistence;
+package org.elasticsearch.xpack.ml.utils.persistence;
 
 import org.apache.lucene.search.TotalHits;
 import org.elasticsearch.action.ActionFuture;

From 6fafb19eee29459347aaaa0c428d96d662a1dbbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Tue, 17 Dec 2019 17:30:17 +0100
Subject: [PATCH 238/686] Pass processConnectTimeout to the method that fetches
 C++ process' PID (#50276)

---
 .../process/AbstractNativeAnalyticsProcess.java   |  5 +++--
 .../dataframe/process/NativeAnalyticsProcess.java |  7 ++++---
 .../process/NativeAnalyticsProcessFactory.java    |  9 +++++----
 .../NativeMemoryUsageEstimationProcess.java       |  5 +++--
 ...NativeMemoryUsageEstimationProcessFactory.java |  3 ++-
 .../autodetect/NativeAutodetectProcess.java       |  6 ++++--
 .../NativeAutodetectProcessFactory.java           |  2 +-
 .../normalizer/NativeNormalizerProcess.java       |  6 ++++--
 .../NativeNormalizerProcessFactory.java           |  2 +-
 .../xpack/ml/process/AbstractNativeProcess.java   | 15 ++++++++-------
 .../autodetect/NativeAutodetectProcessTests.java  | 12 +++++++-----
 .../ml/process/AbstractNativeProcessTests.java    |  3 ++-
 12 files changed, 44 insertions(+), 31 deletions(-)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AbstractNativeAnalyticsProcess.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AbstractNativeAnalyticsProcess.java
index 4dece0cc10266..98925bce1eeba 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AbstractNativeAnalyticsProcess.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AbstractNativeAnalyticsProcess.java
@@ -15,6 +15,7 @@
 import java.io.InputStream;
 import java.io.OutputStream;
 import java.nio.file.Path;
+import java.time.Duration;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Objects;
@@ -28,10 +29,10 @@ abstract class AbstractNativeAnalyticsProcess<Result> extends AbstractNativeProc
     protected AbstractNativeAnalyticsProcess(String name, ConstructingObjectParser<Result, Void> resultParser, String jobId,
                                              NativeController nativeController, InputStream logStream, OutputStream processInStream,
                                              InputStream processOutStream, OutputStream processRestoreStream, int numberOfFields,
-                                             List<Path> filesToDelete, Consumer<String> onProcessCrash,
+                                             List<Path> filesToDelete, Consumer<String> onProcessCrash, Duration processConnectTimeout,
                                              NamedXContentRegistry namedXContentRegistry) {
         super(jobId, nativeController, logStream, processInStream, processOutStream, processRestoreStream, numberOfFields, filesToDelete,
-            onProcessCrash);
+            onProcessCrash, processConnectTimeout);
         this.name = Objects.requireNonNull(name);
         this.resultsParser = new ProcessResultsParser<>(Objects.requireNonNull(resultParser), namedXContentRegistry);
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcess.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcess.java
index 55cf771f305d4..1900d95fa1c93 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcess.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcess.java
@@ -15,6 +15,7 @@
 import java.io.InputStream;
 import java.io.OutputStream;
 import java.nio.file.Path;
+import java.time.Duration;
 import java.util.List;
 import java.util.Objects;
 import java.util.function.Consumer;
@@ -27,10 +28,10 @@ public class NativeAnalyticsProcess extends AbstractNativeAnalyticsProcess<Analy
 
     protected NativeAnalyticsProcess(String jobId, NativeController nativeController, InputStream logStream, OutputStream processInStream,
                                      InputStream processOutStream, OutputStream processRestoreStream, int numberOfFields,
-                                     List<Path> filesToDelete, Consumer<String> onProcessCrash, AnalyticsProcessConfig config,
-                                     NamedXContentRegistry namedXContentRegistry) {
+                                     List<Path> filesToDelete, Consumer<String> onProcessCrash, Duration processConnectTimeout,
+                                     AnalyticsProcessConfig config, NamedXContentRegistry namedXContentRegistry) {
         super(NAME, AnalyticsResult.PARSER, jobId, nativeController, logStream, processInStream, processOutStream, processRestoreStream,
-            numberOfFields, filesToDelete, onProcessCrash, namedXContentRegistry);
+            numberOfFields, filesToDelete, onProcessCrash, processConnectTimeout, namedXContentRegistry);
         this.config = Objects.requireNonNull(config);
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcessFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcessFactory.java
index d2ace11f553ae..5da16ecc8bfe6 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcessFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeAnalyticsProcessFactory.java
@@ -82,10 +82,11 @@ public NativeAnalyticsProcess createAnalyticsProcess(DataFrameAnalyticsConfig co
 
         createNativeProcess(jobId, analyticsProcessConfig, filesToDelete, processPipes);
 
-        NativeAnalyticsProcess analyticsProcess = new NativeAnalyticsProcess(jobId, nativeController, processPipes.getLogStream().get(),
-                processPipes.getProcessInStream().get(), processPipes.getProcessOutStream().get(),
-                processPipes.getRestoreStream().orElse(null), numberOfFields, filesToDelete, onProcessCrash, analyticsProcessConfig,
-                namedXContentRegistry);
+        NativeAnalyticsProcess analyticsProcess =
+            new NativeAnalyticsProcess(
+                jobId, nativeController, processPipes.getLogStream().get(), processPipes.getProcessInStream().get(),
+                processPipes.getProcessOutStream().get(), processPipes.getRestoreStream().orElse(null), numberOfFields, filesToDelete,
+                onProcessCrash, processConnectTimeout, analyticsProcessConfig, namedXContentRegistry);
 
         try {
             startProcess(config, executorService, processPipes, analyticsProcess);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeMemoryUsageEstimationProcess.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeMemoryUsageEstimationProcess.java
index 2d95dacd2719a..43d33066a8890 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeMemoryUsageEstimationProcess.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeMemoryUsageEstimationProcess.java
@@ -13,6 +13,7 @@
 import java.io.InputStream;
 import java.io.OutputStream;
 import java.nio.file.Path;
+import java.time.Duration;
 import java.util.List;
 import java.util.function.Consumer;
 
@@ -23,9 +24,9 @@ public class NativeMemoryUsageEstimationProcess extends AbstractNativeAnalyticsP
     protected NativeMemoryUsageEstimationProcess(String jobId, NativeController nativeController, InputStream logStream,
                                                  OutputStream processInStream, InputStream processOutStream,
                                                  OutputStream processRestoreStream, int numberOfFields, List<Path> filesToDelete,
-                                                 Consumer<String> onProcessCrash) {
+                                                 Consumer<String> onProcessCrash, Duration processConnectTimeout) {
         super(NAME, MemoryUsageEstimationResult.PARSER, jobId, nativeController, logStream, processInStream, processOutStream,
-            processRestoreStream, numberOfFields, filesToDelete, onProcessCrash, NamedXContentRegistry.EMPTY);
+            processRestoreStream, numberOfFields, filesToDelete, onProcessCrash, processConnectTimeout, NamedXContentRegistry.EMPTY);
     }
 
     @Override
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeMemoryUsageEstimationProcessFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeMemoryUsageEstimationProcessFactory.java
index 011a1b5f1d442..f1e8a81f337f0 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeMemoryUsageEstimationProcessFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/NativeMemoryUsageEstimationProcessFactory.java
@@ -76,7 +76,8 @@ public NativeMemoryUsageEstimationProcess createAnalyticsProcess(
             null,
             0,
             filesToDelete,
-            onProcessCrash);
+            onProcessCrash,
+            processConnectTimeout);
 
         try {
             process.start(executorService);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcess.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcess.java
index 8f4d3d428e3d4..55abb78957bf2 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcess.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcess.java
@@ -27,6 +27,7 @@
 import java.io.InputStream;
 import java.io.OutputStream;
 import java.nio.file.Path;
+import java.time.Duration;
 import java.util.Iterator;
 import java.util.List;
 import java.util.function.Consumer;
@@ -44,9 +45,10 @@ class NativeAutodetectProcess extends AbstractNativeProcess implements Autodetec
 
     NativeAutodetectProcess(String jobId, NativeController nativeController, InputStream logStream, OutputStream processInStream,
                             InputStream processOutStream, OutputStream processRestoreStream, int numberOfFields, List<Path> filesToDelete,
-                            ProcessResultsParser<AutodetectResult> resultsParser, Consumer<String> onProcessCrash) {
+                            ProcessResultsParser<AutodetectResult> resultsParser, Consumer<String> onProcessCrash,
+                            Duration processConnectTimeout) {
         super(jobId, nativeController, logStream, processInStream, processOutStream, processRestoreStream, numberOfFields, filesToDelete,
-            onProcessCrash);
+            onProcessCrash, processConnectTimeout);
         this.resultsParser = resultsParser;
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactory.java
index 2504439a220e7..6fd1224270d41 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessFactory.java
@@ -91,7 +91,7 @@ public AutodetectProcess createAutodetectProcess(Job job,
         NativeAutodetectProcess autodetect = new NativeAutodetectProcess(
                 job.getId(), nativeController, processPipes.getLogStream().get(), processPipes.getProcessInStream().get(),
                 processPipes.getProcessOutStream().get(), processPipes.getRestoreStream().orElse(null), numberOfFields,
-                filesToDelete, resultsParser, onProcessCrash);
+                filesToDelete, resultsParser, onProcessCrash, processConnectTimeout);
         try {
             autodetect.start(executorService, stateProcessor, processPipes.getPersistStream().get());
             return autodetect;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/NativeNormalizerProcess.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/NativeNormalizerProcess.java
index 69c500f9d1637..f9e019a55a7e0 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/NativeNormalizerProcess.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/NativeNormalizerProcess.java
@@ -11,6 +11,7 @@
 
 import java.io.InputStream;
 import java.io.OutputStream;
+import java.time.Duration;
 import java.util.Collections;
 
 /**
@@ -21,8 +22,9 @@ class NativeNormalizerProcess extends AbstractNativeProcess implements Normalize
     private static final String NAME = "normalizer";
 
     NativeNormalizerProcess(String jobId, NativeController nativeController, InputStream logStream, OutputStream processInStream,
-                            InputStream processOutStream) {
-        super(jobId, nativeController, logStream, processInStream, processOutStream, null, 0, Collections.emptyList(), (ignore) -> {});
+                            InputStream processOutStream, Duration processConnectTimeout) {
+        super(jobId, nativeController, logStream, processInStream, processOutStream, null, 0, Collections.emptyList(), (ignore) -> {},
+            processConnectTimeout);
     }
 
     @Override
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/NativeNormalizerProcessFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/NativeNormalizerProcessFactory.java
index 0022a44f42fb9..75abd08a5fa89 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/NativeNormalizerProcessFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/normalizer/NativeNormalizerProcessFactory.java
@@ -53,7 +53,7 @@ public NormalizerProcess createNormalizerProcess(String jobId, String quantilesS
         createNativeProcess(jobId, quantilesState, processPipes, bucketSpan);
 
         NativeNormalizerProcess normalizerProcess = new NativeNormalizerProcess(jobId, nativeController, processPipes.getLogStream().get(),
-                processPipes.getProcessInStream().get(), processPipes.getProcessOutStream().get());
+                processPipes.getProcessInStream().get(), processPipes.getProcessOutStream().get(), processConnectTimeout);
 
         try {
             normalizerProcess.start(executorService);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/process/AbstractNativeProcess.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/process/AbstractNativeProcess.java
index db2dad41c6f87..450f5d1288d9c 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/process/AbstractNativeProcess.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/process/AbstractNativeProcess.java
@@ -52,6 +52,7 @@ public abstract class AbstractNativeProcess implements NativeProcess {
     private final int numberOfFields;
     private final List<Path> filesToDelete;
     private final Consumer<String> onProcessCrash;
+    private final Duration processConnectTimeout;
     private volatile Future<?> logTailFuture;
     private volatile Future<?> stateProcessorFuture;
     private volatile boolean processCloseInitiated;
@@ -60,18 +61,19 @@ public abstract class AbstractNativeProcess implements NativeProcess {
 
     protected AbstractNativeProcess(String jobId, NativeController nativeController, InputStream logStream, OutputStream processInStream,
                                     InputStream processOutStream, OutputStream processRestoreStream, int numberOfFields,
-                                    List<Path> filesToDelete, Consumer<String> onProcessCrash) {
+                                    List<Path> filesToDelete, Consumer<String> onProcessCrash, Duration processConnectTimeout) {
         this.jobId = jobId;
         this.nativeController = nativeController;
-        cppLogHandler = new CppLogMessageHandler(jobId, logStream);
+        this.cppLogHandler = new CppLogMessageHandler(jobId, logStream);
         this.processInStream = processInStream != null ? new BufferedOutputStream(processInStream) : null;
         this.processOutStream = processOutStream;
         this.processRestoreStream = processRestoreStream;
         this.recordWriter = new LengthEncodedWriter(this.processInStream);
-        startTime = ZonedDateTime.now();
+        this.startTime = ZonedDateTime.now();
         this.numberOfFields = numberOfFields;
         this.filesToDelete = filesToDelete;
         this.onProcessCrash = Objects.requireNonNull(onProcessCrash);
+        this.processConnectTimeout = Objects.requireNonNull(processConnectTimeout);
     }
 
     public abstract String getName();
@@ -197,10 +199,9 @@ public void kill() throws IOException {
         LOGGER.debug("[{}] Killing {} process", jobId, getName());
         processKilled = true;
         try {
-            // The PID comes via the processes log stream.  We don't wait for it to arrive here,
-            // but if the wait times out it implies the process has only just started, in which
-            // case it should die very quickly when we close its input stream.
-            nativeController.killProcess(cppLogHandler.getPid(Duration.ZERO));
+            // The PID comes via the processes log stream. We do wait here to give the process the time to start up and report its PID.
+            // Without the PID we cannot kill the process.
+            nativeController.killProcess(cppLogHandler.getPid(processConnectTimeout));
 
             // Wait for the process to die before closing processInStream as if the process
             // is still alive when processInStream is closed it may start persisting state
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessTests.java
index 145d80ecdfc6d..903938b82db65 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/NativeAutodetectProcessTests.java
@@ -26,6 +26,7 @@
 import java.io.OutputStream;
 import java.nio.ByteBuffer;
 import java.nio.charset.StandardCharsets;
+import java.time.Duration;
 import java.time.ZonedDateTime;
 import java.time.temporal.ChronoUnit;
 import java.util.Collections;
@@ -63,7 +64,7 @@ public void testProcessStartTime() throws Exception {
         try (NativeAutodetectProcess process = new NativeAutodetectProcess("foo", mock(NativeController.class), logStream,
                 mock(OutputStream.class), outputStream, mock(OutputStream.class),
                 NUMBER_FIELDS, null,
-                new ProcessResultsParser<>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class))) {
+                new ProcessResultsParser<>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class), Duration.ZERO)) {
             process.start(executorService, mock(IndexingStateProcessor.class), mock(InputStream.class));
 
             ZonedDateTime startTime = process.getProcessStartTime();
@@ -86,7 +87,7 @@ public void testWriteRecord() throws IOException {
         ByteArrayOutputStream bos = new ByteArrayOutputStream(1024);
         try (NativeAutodetectProcess process = new NativeAutodetectProcess("foo", mock(NativeController.class), logStream,
                 bos, outputStream, mock(OutputStream.class), NUMBER_FIELDS, Collections.emptyList(),
-                new ProcessResultsParser<>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class))) {
+                new ProcessResultsParser<>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class), Duration.ZERO)) {
             process.start(executorService, mock(IndexingStateProcessor.class), mock(InputStream.class));
 
             process.writeRecord(record);
@@ -121,7 +122,7 @@ public void testFlush() throws IOException {
         ByteArrayOutputStream bos = new ByteArrayOutputStream(AutodetectControlMsgWriter.FLUSH_SPACES_LENGTH + 1024);
         try (NativeAutodetectProcess process = new NativeAutodetectProcess("foo", mock(NativeController.class), logStream,
                 bos, outputStream, mock(OutputStream.class), NUMBER_FIELDS, Collections.emptyList(),
-                new ProcessResultsParser<>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class))) {
+                new ProcessResultsParser<>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class), Duration.ZERO)) {
             process.start(executorService, mock(IndexingStateProcessor.class), mock(InputStream.class));
 
             FlushJobParams params = FlushJobParams.builder().build();
@@ -155,7 +156,8 @@ public void testConsumeAndCloseOutputStream() throws IOException {
 
         try (NativeAutodetectProcess process = new NativeAutodetectProcess("foo", mock(NativeController.class), logStream,
             processInStream, processOutStream, mock(OutputStream.class), NUMBER_FIELDS, Collections.emptyList(),
-            new ProcessResultsParser<AutodetectResult>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class))) {
+            new ProcessResultsParser<AutodetectResult>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class),
+            Duration.ZERO)) {
 
             process.consumeAndCloseOutputStream();
             assertThat(processOutStream.available(), equalTo(0));
@@ -171,7 +173,7 @@ private void testWriteMessage(CheckedConsumer<NativeAutodetectProcess> writeFunc
         ByteArrayOutputStream bos = new ByteArrayOutputStream(1024);
         try (NativeAutodetectProcess process = new NativeAutodetectProcess("foo", mock(NativeController.class), logStream,
                 bos, outputStream, mock(OutputStream.class), NUMBER_FIELDS, Collections.emptyList(),
-                new ProcessResultsParser<>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class))) {
+                new ProcessResultsParser<>(AutodetectResult.PARSER, NamedXContentRegistry.EMPTY), mock(Consumer.class), Duration.ZERO)) {
             process.start(executorService, mock(IndexingStateProcessor.class), mock(InputStream.class));
 
             writeFunction.accept(process);
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/AbstractNativeProcessTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/AbstractNativeProcessTests.java
index 6a442ab089639..5f021a36c05df 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/AbstractNativeProcessTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/AbstractNativeProcessTests.java
@@ -16,6 +16,7 @@
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.OutputStream;
+import java.time.Duration;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.TimeUnit;
@@ -142,7 +143,7 @@ public void testIsReady() throws Exception {
     private class TestNativeProcess extends AbstractNativeProcess {
 
         TestNativeProcess(OutputStream inputStream) {
-            super("foo", nativeController, logStream, inputStream, outputStream, restoreStream, 0, null, onProcessCrash);
+            super("foo", nativeController, logStream, inputStream, outputStream, restoreStream, 0, null, onProcessCrash, Duration.ZERO);
         }
 
         @Override

From aa923ea4bfc0f34e0549924542738589d566fd0a Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Tue, 17 Dec 2019 09:34:47 -0700
Subject: [PATCH 239/686] Send hostname in SNI header in simple remote mode
 (#50247)

Currently an intermediate proxy must route conncctions to the
appropriate remote cluster when using simple mode. This commit offers
a additional mechanism for the proxy to route the connections by
including the hostname in the TLS SNI header.
---
 .../common/settings/ClusterSettings.java      |  1 +
 .../common/settings/Setting.java              |  4 ++
 .../transport/RemoteClusterAware.java         |  3 +-
 .../transport/RemoteConnectionStrategy.java   |  2 +-
 .../transport/SimpleConnectionStrategy.java   | 40 ++++++++++++++++---
 .../transport/SniffConnectionStrategy.java    |  6 +--
 .../SimpleConnectionStrategyTests.java        | 37 ++++++++++++++++-
 7 files changed, 82 insertions(+), 11 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
index ef40f05a2f261..694c1e2bddf64 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
@@ -295,6 +295,7 @@ public void apply(Settings value, Settings current, Settings previous) {
             RemoteConnectionStrategy.REMOTE_CONNECTION_MODE,
             SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES,
             SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS,
+            SimpleConnectionStrategy.INCLUDE_SERVER_NAME,
             SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD,
             SniffConnectionStrategy.REMOTE_CLUSTERS_PROXY,
             SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS,
diff --git a/server/src/main/java/org/elasticsearch/common/settings/Setting.java b/server/src/main/java/org/elasticsearch/common/settings/Setting.java
index bbfe56ffcda97..05329882b7428 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/Setting.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/Setting.java
@@ -1257,6 +1257,10 @@ public static Setting<Boolean> boolSetting(String key, Setting<Boolean> fallback
         return new Setting<>(key, fallbackSetting, b -> parseBoolean(b, key, isFiltered(properties)), properties);
     }
 
+    public static Setting<Boolean> boolSetting(String key, boolean defaultValue, Validator<Boolean> validator, Property... properties) {
+        return new Setting<>(key, Boolean.toString(defaultValue), b -> parseBoolean(b, key, isFiltered(properties)), validator, properties);
+    }
+
     public static Setting<Boolean> boolSetting(String key, Function<Settings, String> defaultValueFn, Property... properties) {
         return new Setting<>(key, defaultValueFn, b -> parseBoolean(b, key, isFiltered(properties)), properties);
     }
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java b/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
index be1ca9a1a2c43..63a9b857f5f7d 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
@@ -111,7 +111,8 @@ public void listenForUpdates(ClusterSettings clusterSettings) {
             SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD,
             SniffConnectionStrategy.REMOTE_NODE_CONNECTIONS,
             SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES,
-            SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS);
+            SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS,
+            SimpleConnectionStrategy.INCLUDE_SERVER_NAME);
         clusterSettings.addAffixGroupUpdateConsumer(remoteClusterSettings, this::validateAndUpdateRemoteCluster);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
index 3d994f35de224..addd68b1c535e 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
@@ -170,7 +170,7 @@ private static <T> Stream<String> getClusterAlias(Settings settings, Setting.Aff
         return allConcreteSettings.map(affixSetting::getNamespace);
     }
 
-    static InetSocketAddress parseSeedAddress(String remoteHost) {
+    static InetSocketAddress parseConfiguredAddress(String remoteHost) {
         final Tuple<String, Integer> hostPort = parseHostPort(remoteHost);
         final String host = hostPort.v1();
         assert hostPort.v2() != null : remoteHost;
diff --git a/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
index 0250ff73e4e8c..9393e4d0cafc0 100644
--- a/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.cluster.node.DiscoveryNodeRole;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -40,6 +41,7 @@
 import java.util.Collections;
 import java.util.HashSet;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicInteger;
@@ -49,6 +51,7 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
+import static org.elasticsearch.common.settings.Setting.boolSetting;
 import static org.elasticsearch.common.settings.Setting.intSetting;
 
 public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
@@ -76,6 +79,15 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
         (ns, key) -> intSetting(key, 18, 1, new StrategyValidator<>(ns, key, ConnectionStrategy.SIMPLE),
             Setting.Property.Dynamic, Setting.Property.NodeScope));
 
+    /**
+     * Whether to include the hostname as a server_name attribute
+     */
+    public static final Setting.AffixSetting<Boolean> INCLUDE_SERVER_NAME = Setting.affixKeySetting(
+        "cluster.remote.",
+        "simple.include_server_name",
+        (ns, key) -> boolSetting(key, false, new StrategyValidator<>(ns, key, ConnectionStrategy.SIMPLE),
+            Setting.Property.Dynamic, Setting.Property.NodeScope));
+
     static final int CHANNELS_PER_CONNECTION = 1;
 
     private static final int MAX_CONNECT_ATTEMPTS_PER_RUN = 3;
@@ -84,6 +96,7 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
     private final int maxNumConnections;
     private final AtomicLong counter = new AtomicLong(0);
     private final List<String> configuredAddresses;
+    private final boolean includeServerName;
     private final List<Supplier<TransportAddress>> addresses;
     private final AtomicReference<ClusterName> remoteClusterName = new AtomicReference<>();
     private final ConnectionProfile profile;
@@ -96,21 +109,31 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
             transportService,
             connectionManager,
             REMOTE_SOCKET_CONNECTIONS.getConcreteSettingForNamespace(clusterAlias).get(settings),
-            REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).get(settings));
+            REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).get(settings),
+            INCLUDE_SERVER_NAME.getConcreteSettingForNamespace(clusterAlias).get(settings));
     }
 
     SimpleConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
                              int maxNumConnections, List<String> configuredAddresses) {
         this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddresses,
             configuredAddresses.stream().map(address ->
-                (Supplier<TransportAddress>) () -> resolveAddress(address)).collect(Collectors.toList()));
+                (Supplier<TransportAddress>) () -> resolveAddress(address)).collect(Collectors.toList()), false);
     }
 
     SimpleConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                             int maxNumConnections, List<String> configuredAddresses, List<Supplier<TransportAddress>> addresses) {
+                             int maxNumConnections, List<String> configuredAddresses, boolean includeServerName) {
+        this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddresses,
+            configuredAddresses.stream().map(address ->
+                (Supplier<TransportAddress>) () -> resolveAddress(address)).collect(Collectors.toList()), includeServerName);
+    }
+
+    SimpleConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
+                             int maxNumConnections, List<String> configuredAddresses, List<Supplier<TransportAddress>> addresses,
+                             boolean includeServerName) {
         super(clusterAlias, transportService, connectionManager);
         this.maxNumConnections = maxNumConnections;
         this.configuredAddresses = configuredAddresses;
+        this.includeServerName = includeServerName;
         assert addresses.isEmpty() == false : "Cannot use simple connection strategy with no configured addresses";
         this.addresses = addresses;
         // TODO: Move into the ConnectionManager
@@ -207,7 +230,14 @@ public void onFailure(Exception e) {
             for (int i = 0; i < remaining; ++i) {
                 TransportAddress address = nextAddress(resolved);
                 String id = clusterAlias + "#" + address;
-                DiscoveryNode node = new DiscoveryNode(id, address, Version.CURRENT.minimumCompatibilityVersion());
+                Map<String, String> attributes;
+                if (includeServerName) {
+                    attributes = Collections.singletonMap("server_name", address.address().getHostString());
+                } else {
+                    attributes = Collections.emptyMap();
+                }
+                DiscoveryNode node = new DiscoveryNode(id, address, attributes, DiscoveryNodeRole.BUILT_IN_ROLES,
+                    Version.CURRENT.minimumCompatibilityVersion());
 
                 connectionManager.connectToNode(node, profile, clusterNameValidator, new ActionListener<>() {
                     @Override
@@ -243,7 +273,7 @@ private TransportAddress nextAddress(List<TransportAddress> resolvedAddresses) {
     }
 
     private static TransportAddress resolveAddress(String address) {
-        return new TransportAddress(parseSeedAddress(address));
+        return new TransportAddress(parseConfiguredAddress(address));
     }
 
     private boolean addressesChanged(final List<String> oldAddresses, final List<String> newAddresses) {
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index ad1dc6696b57c..bb7d6202c59b7 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -425,11 +425,11 @@ public String toString() {
 
     private static DiscoveryNode resolveSeedNode(String clusterAlias, String address, String proxyAddress) {
         if (proxyAddress == null || proxyAddress.isEmpty()) {
-            TransportAddress transportAddress = new TransportAddress(parseSeedAddress(address));
+            TransportAddress transportAddress = new TransportAddress(parseConfiguredAddress(address));
             return new DiscoveryNode(clusterAlias + "#" + transportAddress.toString(), transportAddress,
                 Version.CURRENT.minimumCompatibilityVersion());
         } else {
-            TransportAddress transportAddress = new TransportAddress(parseSeedAddress(proxyAddress));
+            TransportAddress transportAddress = new TransportAddress(parseConfiguredAddress(proxyAddress));
             String hostName = address.substring(0, indexOfPortSeparator(address));
             return new DiscoveryNode("", clusterAlias + "#" + address, UUIDs.randomBase64UUID(), hostName, address,
                 transportAddress, Collections.singletonMap("server_name", hostName), DiscoveryNodeRole.BUILT_IN_ROLES,
@@ -460,7 +460,7 @@ private static DiscoveryNode maybeAddProxyAddress(String proxyAddress, Discovery
             return node;
         } else {
             // resolve proxy address lazy here
-            InetSocketAddress proxyInetAddress = parseSeedAddress(proxyAddress);
+            InetSocketAddress proxyInetAddress = parseConfiguredAddress(proxyAddress);
             return new DiscoveryNode(node.getName(), node.getId(), node.getEphemeralId(), node.getHostName(), node
                 .getHostAddress(), new TransportAddress(proxyInetAddress), node.getAttributes(), node.getRoles(), node.getVersion());
         }
diff --git a/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java
index 4144cc856bd3a..53fe4a04d379c 100644
--- a/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.settings.AbstractScopedSettings;
@@ -35,6 +36,7 @@
 import org.elasticsearch.threadpool.TestThreadPool;
 import org.elasticsearch.threadpool.ThreadPool;
 
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashSet;
@@ -291,7 +293,7 @@ public void testSimpleStrategyWillResolveAddressesEachConnect() throws Exception
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections,  addresses(address), Collections.singletonList(addressSupplier))) {
+                         numOfConnections,  addresses(address), Collections.singletonList(addressSupplier), false)) {
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
                     strategy.connect(connectFuture);
                     connectFuture.actionGet();
@@ -387,6 +389,39 @@ public void testModeSettingsCannotBeUsedWhenInDifferentMode() {
         }
     }
 
+    public void testServerNameAttributes() {
+        Settings bindSettings = Settings.builder().put(TransportSettings.BIND_HOST.getKey(), "localhost").build();
+        try (MockTransportService transport1 = startTransport("node1", Version.CURRENT, bindSettings)) {
+            TransportAddress address1 = transport1.boundAddress().publishAddress();
+
+            try (MockTransportService localService = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool)) {
+                localService.start();
+                localService.acceptIncomingRequests();
+
+                ArrayList<String> addresses = new ArrayList<>();
+                addresses.add("localhost:" + address1.getPort());
+
+                ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
+                int numOfConnections = randomIntBetween(4, 8);
+                try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
+                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                         numOfConnections, addresses, true)) {
+                    assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
+
+                    PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
+                    strategy.connect(connectFuture);
+                    connectFuture.actionGet();
+
+                    assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
+                    assertTrue(strategy.assertNoRunningConnections());
+
+                    DiscoveryNode discoveryNode = connectionManager.getAllConnectedNodes().stream().findFirst().get();
+                    assertEquals("localhost", discoveryNode.getAttributes().get("server_name"));
+                }
+            }
+        }
+    }
+
     private static List<String> addresses(final TransportAddress... addresses) {
         return Arrays.stream(addresses).map(TransportAddress::toString).collect(Collectors.toList());
     }

From 4dd7870eb85a63b8c2035994ce76091ebaec9497 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Tue, 17 Dec 2019 09:01:31 -0800
Subject: [PATCH 240/686] [DOCS] Move transform resource definitions into APIs
 (#50108)

---
 .../bucket/composite-aggregation.asciidoc     |   8 +-
 docs/reference/redirects.asciidoc             |  15 +-
 docs/reference/rest-api/common-parms.asciidoc | 166 +++++++++++++++++-
 docs/reference/rest-api/defs.asciidoc         |   2 -
 .../transform/apis/delete-transform.asciidoc  |   7 +-
 .../apis/get-transform-stats.asciidoc         |  27 +--
 .../transform/apis/get-transform.asciidoc     |  45 +++--
 .../transform/apis/preview-transform.asciidoc |  77 ++++++--
 .../transform/apis/put-transform.asciidoc     |  92 +++++-----
 .../transform/apis/start-transform.asciidoc   |   9 +-
 .../transform/apis/stop-transform.asciidoc    |  27 +--
 .../transform/apis/transformresource.asciidoc | 127 --------------
 .../transform/apis/update-transform.asciidoc  | 112 ++++++------
 13 files changed, 394 insertions(+), 320 deletions(-)
 delete mode 100644 docs/reference/transform/apis/transformresource.asciidoc

diff --git a/docs/reference/aggregations/bucket/composite-aggregation.asciidoc b/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
index dd9aea6be3e90..226d9c2d7ade1 100644
--- a/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
+++ b/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
@@ -1,5 +1,5 @@
 [[search-aggregations-bucket-composite-aggregation]]
-=== Composite Aggregation
+=== Composite aggregation
 
 A multi-bucket aggregation that creates composite buckets from different sources.
 
@@ -105,6 +105,7 @@ The name given to each sources must be unique.
 
 There are three different types of values source:
 
+[[_terms]]
 ===== Terms
 
 The `terms` value source is equivalent to a simple `terms` aggregation.
@@ -157,6 +158,7 @@ GET /_search
 }
 --------------------------------------------------
 
+[[_histogram]]
 ===== Histogram
 
 The `histogram` value source can be applied on numeric values to build fixed size
@@ -212,8 +214,8 @@ GET /_search
 }
 --------------------------------------------------
 
-
-===== Date Histogram
+[[_date_histogram]]
+===== Date histogram
 
 The `date_histogram` is similar to the `histogram` value source except that the interval
 is specified by date/time expression:
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 69d7765e8a9b0..32a30a326bfde 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -898,17 +898,17 @@ See <<transform-resource>>.
 [role="exclude",id="data-frame-transform-dest"]
 === Dest objects
 
-See <<transform-dest>>.
+See <<transform-resource>>.
 
 [role="exclude",id="data-frame-transform-source"]
 ==== Source objects
 
-See <<transform-source>>.
+See <<transform-resource>>.
 
 [role="exclude",id="data-frame-transform-pivot"]
 ==== Pivot objects
 
-See <<transform-pivot>>.
+See <<transform-resource>>.
 
 [role="exclude",id="configuring-monitoring"]
 === Configuring monitoring
@@ -1087,4 +1087,11 @@ the details in <<ml-get-job-stats>>.
 
 This page was deleted.
 [[ml-snapshot-stats]]
-See <<ml-update-snapshot>> and <<ml-get-snapshot>>.
\ No newline at end of file
+See <<ml-update-snapshot>> and <<ml-get-snapshot>>.
+
+[role="exclude",id="transform-resource"]
+=== {transform-cap} resources
+
+This page was deleted.
+See <<put-transform>>, <<preview-transform>>, <<update-transform>>,
+<<get-transform>>.
diff --git a/docs/reference/rest-api/common-parms.asciidoc b/docs/reference/rest-api/common-parms.asciidoc
index 0c9400bbf62f7..36b9791ebfdf0 100644
--- a/docs/reference/rest-api/common-parms.asciidoc
+++ b/docs/reference/rest-api/common-parms.asciidoc
@@ -47,6 +47,42 @@ This parameter also applies to <<indices-aliases,index aliases>>
 that point to a missing or closed index.
 end::allow-no-indices[]
 
+tag::allow-no-match-transforms1[]
+Specifies what to do when the request:
++
+--
+* Contains wildcard expressions and there are no {transforms} that match.
+* Contains the `_all` string or no identifiers and there are no matches.
+* Contains wildcard expressions and there are only partial matches. 
+
+The default value is `true`, which returns an empty `transforms` array when
+there are no matches and the subset of results when there are partial matches.
+
+If this parameter is `false`, the request returns a `404` status code when there
+are no matches or only partial matches.
+--
+end::allow-no-match-transforms1[]
+
+tag::allow-no-match-transforms2[]
+Specifies what to do when the request:
++
+--
+* Contains wildcard expressions and there are no {transforms} that match.
+* Contains the `_all` string or no identifiers and there are no matches.
+* Contains wildcard expressions and there are only partial matches. 
+
+The default value is `true`, which returns a successful acknowledgement message
+when there are no matches. When there are only partial matches, the API stops
+the appropriate {transforms}. For example, if the request contains
+`test-id1*,test-id2*` as the identifiers and there are no {transforms}
+that match `test-id2*`, the API nonetheless stops the {transforms}
+that match `test-id1*`.
+
+If this parameter is `false`, the request returns a `404` status code when there
+are no matches or only partial matches.
+--
+end::allow-no-match-transforms2[]
+
 tag::analyzer[]
 `analyzer`::
 (Optional, string) Analyzer to use for the query string.
@@ -86,6 +122,18 @@ tag::default_operator[]
 Defaults to `OR`.
 end::default_operator[]
 
+tag::dest[]
+The destination for the {transform}.
+end::dest[]
+
+tag::dest-index[]
+The _destination index_ for the {transform}.
+end::dest-index[]
+
+tag::dest-pipeline[]
+The unique identifier for a <<pipeline,pipeline>>.
+end::dest-pipeline[]
+
 tag::detailed[]
 `detailed`::
 (Optional, boolean)
@@ -187,11 +235,22 @@ https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html[HTTP accept header].
 Valid values include JSON, YAML, etc.
 end::http-format[]
 
+tag::frequency[]
+The interval between checks for changes in the source indices when the
+{transform} is running continuously. Also determines the retry interval in the
+event of transient failures while the {transform} is searching or indexing. The
+minimum value is `1s` and the maximum is `1h`. The default value is `1m`.
+end::frequency[]
+
 tag::from[]
 `from`::
 (Optional, integer) Starting document offset. Defaults to `0`.
 end::from[]
 
+tag::from-transforms[]
+Skips the specified number of {transforms}. The default value is `0`.
+end::from-transforms[]
+
 tag::generation[]
 Generation number, such as `0`. {es} increments this generation number
 for each segment written. {es} then uses this number to derive the segment name.
@@ -476,6 +535,12 @@ or use a value of `-1`.
 --
 end::parent-task-id[]
 
+tag::payloads[]
+`payloads`::
+(Optional, boolean) If `true`, the response includes term payloads.
+Defaults to `true`.
+end::payloads[]
+
 tag::pipeline[]
 `pipeline`::
 (Optional, string) ID of the pipeline to use to preprocess incoming documents.
@@ -487,11 +552,52 @@ tag::path-pipeline[]
 used to limit the request.
 end::path-pipeline[]
 
-tag::payloads[]
-`payloads`::
-(Optional, boolean) If `true`, the response includes term payloads.
-Defaults to `true`.
-end::payloads[]
+tag::pivot[]
+The method for transforming the data. These objects define the pivot function
+`group by` fields and the aggregation to reduce the data.
+end::pivot[]
+
+tag::pivot-aggs[]
+Defines how to aggregate the grouped data. The following composite aggregations
+are supported:
++
+--
+* <<search-aggregations-metrics-avg-aggregation,Average>>
+* <<search-aggregations-metrics-weight-avg-aggregation,Weighted average>>
+* <<search-aggregations-metrics-cardinality-aggregation,Cardinality>>
+* <<search-aggregations-metrics-geobounds-aggregation,Geo bounds>>
+* <<search-aggregations-metrics-geocentroid-aggregation,Geo centroid>>
+* <<search-aggregations-metrics-max-aggregation,Max>>
+* <<search-aggregations-metrics-min-aggregation,Min>>
+* <<search-aggregations-metrics-scripted-metric-aggregation,Scripted metric>>
+* <<search-aggregations-metrics-sum-aggregation,Sum>>
+* <<search-aggregations-metrics-valuecount-aggregation,Value count>>
+* <<search-aggregations-pipeline-bucket-script-aggregation,Bucket script>>
+* <<search-aggregations-pipeline-bucket-selector-aggregation,Bucket selector>>
+
+IMPORTANT: {transforms-cap} support a subset of the functionality in
+composite aggregations. See <<transform-limitations>>.
+
+--
+end::pivot-aggs[]
+
+tag::pivot-group-by[]
+Defines how to group the data. More than one grouping can be defined
+  per pivot. The following groupings are supported:
++
+--
+* <<_terms,Terms>>
+* <<_histogram,Histogram>>
+* <<_date_histogram,Date histogram>>
+--
+end::pivot-group-by[]
+
+tag::pivot-max-page-search-size[]
+Defines the initial page size to use for the composite aggregation for each
+checkpoint. If circuit breaker exceptions occur, the page size is dynamically
+adjusted to a lower value. The minimum value is `10` and the maximum is `10,000`.
+The default value is `500`.
+end::pivot-max-page-search-size[]
 
 tag::positions[]
 `positions`::
@@ -618,6 +724,11 @@ Configuration options for the target index.
 See <<index-modules-settings>>.
 end::target-index-settings[]
 
+tag::size-transforms[]
+Specifies the maximum number of {transforms} to obtain. The default value is
+`100`.
+end::size-transforms[]
+
 tag::slices[]
 `slices`::
 (Optional, integer) The number of slices this task should be divided into. 
@@ -647,6 +758,21 @@ tag::source_includes[]
 field.
 end::source_includes[]
 
+tag::source-transforms[]
+The source of the data for the {transform}. 
+end::source-transforms[]
+
+tag::source-index-transforms[]
+The _source indices_ for the {transform}. It can be a single index, an index
+pattern (for example, `"myindex*"`), or an array of indices (for example,
+`["index1", "index2"]`).
+end::source-index-transforms[]
+
+tag::source-query-transforms[]
+A query clause that retrieves a subset of data from the source index. See
+<<query-dsl>>.
+end::source-query-transforms[]
+
 tag::stats[]
 `stats`::
 (Optional, string) Specific `tag` of the request for logging and statistical
@@ -659,6 +785,24 @@ tag::stored_fields[]
 index rather than the document `_source`. Defaults to `false`.
 end::stored_fields[]
 
+tag::sync[]
+Defines the properties {transforms} require to run continuously.
+end::sync[]
+
+tag::sync-time[]
+Specifies that the {transform} uses a time field to synchronize the source and
+destination indices.
+end::sync-time[]
+
+tag::sync-time-field[]
+The date field that is used to identify new documents in the source.
+end::sync-time-field[]
+
+tag::sync-time-delay[]
+The time delay between the current time and the latest input data time. The
+default value is `60s`.
+end::sync-time-delay[]
+
 tag::target-index[]
 `<target-index>`::
 +
@@ -712,6 +856,18 @@ end::master-timeout[]
 
 end::timeoutparms[]
 
+tag::transform-id[]
+Identifier for the {transform}. This identifier can contain lowercase
+alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start
+and end with alphanumeric characters.
+end::transform-id[]
+
+tag::transform-id-wildcard[]
+Identifier for the {transform}. It can be a {transform} identifier or a wildcard
+expression. If you do not specify one of these options, the API returns
+information for all {transforms}.
+end::transform-id-wildcard[]
+
 tag::cat-v[]
 `v`::
 (Optional, boolean) If `true`, the response includes column headings. 
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index bda7415740d8e..137af880c0a9a 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -9,10 +9,8 @@ These resource definitions are used in APIs related to {ml-features} and
 * <<ml-dfa-analysis-objects>>
 * <<ml-results-resource,{anomaly-detect-cap} results>>
 * <<role-mapping-resources,Role mappings>>
-* <<transform-resource,{transforms-cap}>>
 
 
 include::{es-repo-dir}/ml/df-analytics/apis/analysisobjects.asciidoc[]
 include::{xes-repo-dir}/rest-api/security/role-mapping-resources.asciidoc[]
 include::{es-repo-dir}/ml/anomaly-detection/apis/resultsresource.asciidoc[]
-include::{es-repo-dir}/transform/apis/transformresource.asciidoc[]
diff --git a/docs/reference/transform/apis/delete-transform.asciidoc b/docs/reference/transform/apis/delete-transform.asciidoc
index d3d2c2b9b2714..7257d2cbe4e35 100644
--- a/docs/reference/transform/apis/delete-transform.asciidoc
+++ b/docs/reference/transform/apis/delete-transform.asciidoc
@@ -1,11 +1,11 @@
 [role="xpack"]
 [testenv="basic"]
 [[delete-transform]]
-=== Delete {transforms} API
+=== Delete {transform} API
 
 [subs="attributes"]
 ++++
-<titleabbrev>Delete {transforms}</titleabbrev>
+<titleabbrev>Delete {transform}</titleabbrev>
 ++++
 
 Deletes an existing {transform}.
@@ -31,7 +31,8 @@ these privileges. For more information, see <<security-privileges>> and
 ==== {api-path-parms-title}
 
 `<transform_id>`::
-  (Required, string) Identifier for the {transform}.
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[delete-transform-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/transform/apis/get-transform-stats.asciidoc b/docs/reference/transform/apis/get-transform-stats.asciidoc
index 1ac82e32a2a81..2472b03885657 100644
--- a/docs/reference/transform/apis/get-transform-stats.asciidoc
+++ b/docs/reference/transform/apis/get-transform-stats.asciidoc
@@ -50,35 +50,24 @@ specifying `*` as the `<transform_id>`, or by omitting the
 ==== {api-path-parms-title}
 
 `<transform_id>`::
-  (Optional, string) Identifier for the {transform}. It can be a
-  {transform} identifier or a wildcard expression. If you do not
-  specify one of these options, the API returns information for all
-  {transforms}.
+(Optional, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id-wildcard]
   
 
 [[get-transform-stats-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_match`::
-  (Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no {transforms} that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
-
-The default value is `true`, which returns an empty `transforms` array when
-there are no matches and the subset of results when there are partial matches.
-If this parameter is `false`, the request returns a `404` status code when there
-are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms1]
 
 `from`::
-  (Optional, integer) Skips the specified number of {transforms}. The
-  default value is `0`.
+(Optional, integer)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=from-transforms]
 
 `size`::
-  (Optional, integer) Specifies the maximum number of {transforms} to obtain. The default value is `100`.
+(Optional, integer)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=size-transforms]
 
 [[get-transform-stats-response]]
 ==== {api-response-body-title}
diff --git a/docs/reference/transform/apis/get-transform.asciidoc b/docs/reference/transform/apis/get-transform.asciidoc
index 0583b4b63af5a..30b552077c089 100644
--- a/docs/reference/transform/apis/get-transform.asciidoc
+++ b/docs/reference/transform/apis/get-transform.asciidoc
@@ -45,41 +45,38 @@ specifying `*` as the `<transform_id>`, or by omitting the `<transform_id>`.
 ==== {api-path-parms-title}
 
 `<transform_id>`::
-  (Optional, string) Identifier for the {transform}. It can be a
-  {transform} identifier or a wildcard expression. If you do not
-  specify one of these options, the API returns information for all
-  {transforms}.
+(Optional, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id-wildcard]
   
 [[get-transform-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_match`::
-(Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no {transforms} that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
-
-The default value is `true`, which returns an empty `transforms` array when
-there are no matches and the subset of results when there are partial matches.
-If this parameter is `false`, the request returns a `404` status code when there
-are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms1]
 
 `from`::
-  (Optional, integer) Skips the specified number of {transforms}. The
-  default value is `0`.
+(Optional, integer)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=from-transforms]
 
 `size`::
-  (Optional, integer) Specifies the maximum number of {transforms} to obtain. The default value is `100`.
+(Optional, integer)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=size-transforms]
 
 [[get-transform-response]]
 ==== {api-response-body-title}
 
-`transforms`::
-  (array) An array of {transform} resources, which are sorted by the `id` value in
-  ascending order. See <<transform-resource>>.
+The API returns an array of {transform} resources, which are sorted by the `id`
+value in ascending order. For the full list of properties, see
+<<put-transform-request-body,Create {transform} API>>.
+
+`create_time`::
+(string) The time the {transform} was created. For example, `1576094542936`.
+This property is informational; you cannot change its value.
+
+`version`::
+(string) The version of {es} that existed on the node when the {transform} was
+created.
   
 [[get-transform-response-codes]]
 ==== {api-response-codes-title}
@@ -149,7 +146,9 @@ The API returns the following results:
           }
         }
       },
-      "description" : "Maximum priced ecommerce data by customer_id in Asia"
+      "description" : "Maximum priced ecommerce data by customer_id in Asia",
+      "version" : "7.5.0",
+      "create_time" : 1576094542936
     }
   ]
 }
diff --git a/docs/reference/transform/apis/preview-transform.asciidoc b/docs/reference/transform/apis/preview-transform.asciidoc
index 29f5359f03034..2e8e1647c17c0 100644
--- a/docs/reference/transform/apis/preview-transform.asciidoc
+++ b/docs/reference/transform/apis/preview-transform.asciidoc
@@ -1,11 +1,11 @@
 [role="xpack"]
 [testenv="basic"]
 [[preview-transform]]
-=== Preview {transforms} API
+=== Preview {transform} API
 
 [subs="attributes"]
 ++++
-<titleabbrev>Preview {transforms}</titleabbrev>
+<titleabbrev>Preview {transform}</titleabbrev>
 ++++
 
 Previews a {transform}.
@@ -37,24 +37,71 @@ on all the current data in the source index.
 [[preview-transform-request-body]]
 ==== {api-request-body-title}
 
-`source`::
-  (Required, object) The source configuration, which has the following
-  properties:
+
+`description`::
+(Optional, string) Free text description of the {transform}.
+
+`dest`::
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest]
   
-  `index`:::
-    (Required, string or array) The _source indices_ for the
-    {transform}. It can be a single index, an index pattern (for
-    example, `"myindex*"`), or an array of indices (for example,
-    `["index1", "index2"]`).
+`dest`.`index`:::
+(Optional, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-index]
+
+`dest`.`pipeline`:::
+(Optional, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
 
-  `query`:::
-    (Optional, object) A query clause that retrieves a subset of data from the
-    source index. See <<query-dsl>>.
+`frequency`::
+(Optional, <<time-units, time units>>)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=frequency]
 
 `pivot`::
-  (Required, object) Defines the pivot function `group by` fields and the
-  aggregation to reduce the data. See <<transform-pivot>>.
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot]
+
+`pivot`.`aggregations` or `aggs`:::
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-aggs]
+
+`pivot`.`group_by`:::
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-group-by]
+
+`pivot`.`max_page_search_size`:::
+(Optional, integer)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-max-page-search-size]
+
+`source`::
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
+
+`source`.`index`:::
+(Required, string or array)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
+
+`source`.`query`:::
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
+
+`sync`::
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
   
+`sync`.`time`:::
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
+
+`sync`.`time`.`delay`::::
+(Optional, <<time-units, time units>>)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
+    
+`sync`.`time`.`field`::::
+(Optional, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
+
+
 [[preview-transform-response]]
 ==== {api-response-body-title}
 
diff --git a/docs/reference/transform/apis/put-transform.asciidoc b/docs/reference/transform/apis/put-transform.asciidoc
index d40b576ea4cee..dfe11c96f1d93 100644
--- a/docs/reference/transform/apis/put-transform.asciidoc
+++ b/docs/reference/transform/apis/put-transform.asciidoc
@@ -1,11 +1,11 @@
 [role="xpack"]
 [testenv="basic"]
 [[put-transform]]
-=== Create {transforms} API
+=== Create {transform} API
 
 [subs="attributes"]
 ++++
-<titleabbrev>Create {transforms}</titleabbrev>
+<titleabbrev>Create {transform}</titleabbrev>
 ++++
 
 Instantiates a {transform}.
@@ -63,9 +63,8 @@ IMPORTANT:  You must use {kib} or this API to create a {transform}.
 ==== {api-path-parms-title}
 
 `<transform_id>`::
-  (Required, string) Identifier for the {transform}. This identifier
-  can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and
-  underscores. It must start and end with alphanumeric characters.
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[put-transform-query-parms]]
 ==== {api-query-parms-title}
@@ -82,48 +81,64 @@ IMPORTANT:  You must use {kib} or this API to create a {transform}.
   (Optional, string) Free text description of the {transform}.
 
 `dest`::
-  (Required, object) Required. The destination configuration, which has the
-  following properties:
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest]
   
-  `index`:::
-    (Required, string) The _destination index_ for the {transform}.
+`dest`.`index`:::
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-index]
 
-  `pipeline`:::
-    (Optional, string) The unique identifier for a <<pipeline,pipeline>>.
+`dest`.`pipeline`:::
+(Optional, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
 
 `frequency`::
-  (Optional, <<time-units, time units>>) The interval between checks for changes in the source
-  indices when the {transform} is running continuously. Also determines
-  the retry interval in the event of transient failures while the {transform} is
-  searching or indexing. The minimum value is `1s` and the maximum is `1h`. The
-  default value is `1m`.
+(Optional, <<time-units, time units>>)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=frequency]
 
 `pivot`::
-  (Required, object) Defines the pivot function `group by` fields and the aggregation to
-  reduce the data. See <<transform-pivot>>.
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot]
+
+`pivot`.`aggregations` or `aggs`:::
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-aggs]
+
+`pivot`.`group_by`:::
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-group-by]
+
+`pivot`.`max_page_search_size`:::
+(Optional, integer)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-max-page-search-size]
 
 `source`::
-  (Required, object) The source configuration, which has the following
-  properties:
-  
-  `index`:::
-    (Required, string or array) The _source indices_ for the
-    {transform}. It can be a single index, an index pattern (for
-    example, `"myindex*"`), or an array of indices (for example,
-    `["index1", "index2"]`).
-    
-    `query`:::
-      (Optional, object) A query clause that retrieves a subset of data from the
-      source index. See <<query-dsl>>.
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
+
+`source`.`index`:::
+(Required, string or array)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
+
+`source`.`query`:::
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
   
 `sync`::
-  (Optional, object) Defines the properties required to run continuously.
-  `time`:::
-    (Required, object) Specifies that the {transform} uses a time
-    field to synchronize the source and destination indices.
-    `field`::::
-      (Required, string) The date field that is used to identify new documents
-      in the source.
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
+  
+`sync`.`time`:::
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
+
+`sync`.`time`.`delay`::::
+(Optional, <<time-units, time units>>)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
+    
+`sync`.`time`.`field`::::
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
 +
 --
 TIP: In general, it’s a good idea to use a field that contains the
@@ -132,9 +147,6 @@ you might need to set the `delay` such that it accounts for data transmission
 delays.
 
 --
-    `delay`::::
-      (Optional, <<time-units, time units>>) The time delay between the current time and the
-      latest input data time. The default value is `60s`.
 
 [[put-transform-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/transform/apis/start-transform.asciidoc b/docs/reference/transform/apis/start-transform.asciidoc
index 6ce5ae7322a39..6e8ce0fdd4076 100644
--- a/docs/reference/transform/apis/start-transform.asciidoc
+++ b/docs/reference/transform/apis/start-transform.asciidoc
@@ -1,11 +1,11 @@
 [role="xpack"]
 [testenv="basic"]
 [[start-transform]]
-=== Start {transforms} API
+=== Start {transform} API
 
 [subs="attributes"]
 ++++
-<titleabbrev>Start {transforms}</titleabbrev>
+<titleabbrev>Start {transform}</titleabbrev>
 ++++
 
 Starts one or more {transforms}.
@@ -52,9 +52,8 @@ required privileges on the source and destination indices, the
 ==== {api-path-parms-title}
 
 `<transform_id>`::
-  (Required, string) Identifier for the {transform}. This identifier
-  can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and
-  underscores. It must start and end with alphanumeric characters.
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[start-transform-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/transform/apis/stop-transform.asciidoc b/docs/reference/transform/apis/stop-transform.asciidoc
index 03170d30f8728..35251dd491a40 100644
--- a/docs/reference/transform/apis/stop-transform.asciidoc
+++ b/docs/reference/transform/apis/stop-transform.asciidoc
@@ -45,32 +45,15 @@ All {transforms} can be stopped by using `_all` or `*` as the
 ==== {api-path-parms-title}
 
 `<transform_id>`::
-  (Required, string) Identifier for the {transform}. This identifier
-  can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and
-  underscores. It must start and end with alphanumeric characters.
-
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[stop-transform-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_match`::
-(Optional, boolean) Specifies what to do when the request:
-+
---
-* Contains wildcard expressions and there are no {transforms} that match.
-* Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
-
-The default value is `true`, which returns a successful acknowledgement message
-when there are no matches. When there are only partial matches, the API stops
-the appropriate {transforms}. For example, if the request contains
-`test-id1*,test-id2*` as the identifiers and there are no {transforms}
-that match `test-id2*`, the API nonetheless stops the {transforms}
-that match `test-id1*`.
-
-If this parameter is `false`, the request returns a `404` status code when there
-are no matches or only partial matches.
---
+(Optional, boolean)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms2]
 
 `force`::
   (Optional, boolean) Set to `true` to stop a failed {transform} or to 
@@ -92,7 +75,7 @@ are no matches or only partial matches.
 
 `wait_for_checkpoint`::
   (Optional, boolean) If set to `true`, the transform will not completely stop
-  until the current checkpoint is completed. If set to `false`, the transform
+  until the current checkpoint is completed. If set to `false`, the {transform}
   stops as soon as possible. Defaults to `false`.
 
 [[stop-transform-response-codes]]
diff --git a/docs/reference/transform/apis/transformresource.asciidoc b/docs/reference/transform/apis/transformresource.asciidoc
deleted file mode 100644
index 190f827cd8e15..0000000000000
--- a/docs/reference/transform/apis/transformresource.asciidoc
+++ /dev/null
@@ -1,127 +0,0 @@
-[role="xpack"]
-[testenv="basic"]
-[[transform-resource]]
-=== {transform-cap} resources
-
-{transform-cap} resources relate to the <<transform-apis>>.
-
-For more information, see <<transforms>>.
-
-[discrete]
-[[transform-properties]]
-==== {api-definitions-title}
-
-`description`::
-  (string) A description of the {transform}.
-
-`dest`::
-  (object) The destination for the {transform}. See
-  <<transform-dest>>.
-  
-`frequency`::
-  (time units) The interval between checks for changes in the source indices
-  when the {transform} is running continuously. Also determines the
-  retry interval in the event of transient failures while the {transform} is
-  searching or indexing. The minimum value is `1s` and the maximum is `1h`. The
-  default value is `1m`.
-
-`id`::
-  (string) A unique identifier for the {transform}.
-
-`pivot`::
-  (object) The method for transforming the data. See
-  <<transform-pivot>>. 
-
-`source`:: 
-  (object) The source of the data for the {transform}. See
-  <<transform-source>>.
-
-[[transform-dest]]
-==== Dest objects
-
-{transform-cap} resources contain `dest` objects. For example, when
-you create a {transform}, you must define its destination.
-
-[discrete]
-[[transform-dest-properties]]
-===== {api-definitions-title}
-
-`index`:: 
-  (string) The _destination index_ for the {transform}.
-
-`pipeline`::
-  (string) The unique identifier for a <<pipeline,pipeline>>.
-
-[[transform-source]]
-==== Source objects
-
-{transform-cap} resources contain `source` objects. For example, when
-you create a {transform}, you must define its source.
-
-[discrete]
-[[transform-source-properties]]
-===== {api-definitions-title}
-
-`index`::
-  (string or array) The _source indices_ for the {transform}. It can
-  be a single index, an index pattern (for example, `"myindex*"`), or an array
-  of indices (for example, `["index1", "index2"]`).
-
-`query`::
-  (object) A query clause that retrieves a subset of data from the source index.
-  See <<query-dsl>>.
-  
-[[transform-pivot]]
-==== Pivot objects
-
-{transform-cap} resources contain `pivot` objects, which define the
-pivot function `group by` fields and the aggregation to reduce the data.
-
-[discrete]
-[[transform-pivot-properties]]
-===== {api-definitions-title}
-
-`aggregations` or `aggs`::
-  (object) Defines how to aggregate the grouped data. The following composite
-  aggregations are supported:
-+
---
-* {ref}/search-aggregations-metrics-avg-aggregation.html[Average]
-* {ref}/search-aggregations-metrics-weight-avg-aggregation.html[Weighted Average]
-* {ref}/search-aggregations-metrics-cardinality-aggregation.html[Cardinality]
-* {ref}/search-aggregations-metrics-geobounds-aggregation.html[Geo Bounds]
-* {ref}/search-aggregations-metrics-geocentroid-aggregation.html[Geo Centroid]
-* {ref}/search-aggregations-metrics-max-aggregation.html[Max]
-* {ref}/search-aggregations-metrics-min-aggregation.html[Min]
-* {ref}/search-aggregations-metrics-scripted-metric-aggregation.html[Scripted Metric]
-* {ref}/search-aggregations-metrics-sum-aggregation.html[Sum]
-* {ref}/search-aggregations-metrics-valuecount-aggregation.html[Value Count]
-* {ref}/search-aggregations-pipeline-bucket-script-aggregation.html[Bucket Script]
-* {ref}/search-aggregations-pipeline-bucket-selector-aggregation.html[Bucket Selector]
-
-IMPORTANT: {transforms-cap} support a subset of the functionality in
-composite aggregations. See <<transform-limitations>>.
-
---
-
-`group_by`::
-  (object) Defines how to group the data. More than one grouping can be defined
-  per pivot. The following groupings are supported:
-+
---
-* {ref}/search-aggregations-bucket-composite-aggregation.html#_terms[Terms]
-* {ref}/search-aggregations-bucket-composite-aggregation.html#_histogram[Histogram]
-* {ref}/search-aggregations-bucket-composite-aggregation.html#_date_histogram[Date Histogram]
---
-
-`max_page_search_size`::
-  (integer) Defines the initial page size to use for the composite aggregation 
-  for each checkpoint. If circuit breaker exceptions occur, the page size is
-  dynamically adjusted to a lower value. The minimum value is `10` and the
-  maximum is `10,000`. The default value is `500`.
-
-[[transform-example]]
-==== {api-examples-title}
-
-See the
-<<put-transform-example,create {transforms} API examples>>.
diff --git a/docs/reference/transform/apis/update-transform.asciidoc b/docs/reference/transform/apis/update-transform.asciidoc
index e169be2ff94d1..c1d77d2a95001 100644
--- a/docs/reference/transform/apis/update-transform.asciidoc
+++ b/docs/reference/transform/apis/update-transform.asciidoc
@@ -1,14 +1,14 @@
 [role="xpack"]
 [testenv="basic"]
 [[update-transform]]
-=== Update {transforms} API
+=== Update {transform} API
 
 [subs="attributes"]
 ++++
-<titleabbrev>Update {transforms}</titleabbrev>
+<titleabbrev>Update {transform}</titleabbrev>
 ++++
 
-Updates an existing {transform}.
+Updates certain properties of a {transform}.
 
 beta[]
 
@@ -30,29 +30,36 @@ privileges on the destination index. For more information, see
 [[update-transform-desc]]
 ==== {api-description-title}
 
-This API updates an existing {transform}. All settings except description do not
-take effect until after the {transform} starts the next checkpoint. This is
-so there is consistency with the pivoted data in each checkpoint.
+This API updates an existing {transform}. The list of properties that you can
+update is a subset of the list that you can define when you create a {transform}.
 
-IMPORTANT: When {es} {security-features} are enabled, your {transform}
-remembers which roles the user who updated it had at the time of update and
-runs with those privileges.
+When the {transform} is updated, a series of validations occur to ensure its
+success. You can use the `defer_validation` parameter to skip these checks.
 
-IMPORTANT:  You must use {kib} or this API to update a {transform}.
-            Do not update a {transform} directly via
-            `.transform-internal*` indices using the Elasticsearch index API.
-            If {es} {security-features} are enabled, do not give users any
-            privileges on `.transform-internal*` indices. If you used transforms
-            prior 7.5, also do not give users any privileges on
-            `.data-frame-internal*` indices.
+All updated properties except description do not take effect until after the
+{transform} starts the next checkpoint. This is so there is consistency with the
+pivoted data in each checkpoint.
+
+[IMPORTANT]
+====
+
+* When {es} {security-features} are enabled, your {transform} remembers which
+roles the user who updated it had at the time of update and runs with those
+privileges.
+* You must use {kib} or this API to update a {transform}. Do not update a
+{transform} directly via `.transform-internal*` indices using the {es} index API.
+If {es} {security-features} are enabled, do not give users any privileges on
+`.transform-internal*` indices. If you used {transforms} prior 7.5, also do not
+give users any privileges on `.data-frame-internal*` indices.
+
+====
 
 [[update-transform-path-parms]]
 ==== {api-path-parms-title}
 
 `<transform_id>`::
-  (Required, string) Identifier for the {transform}. This identifier
-  can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and
-  underscores. It must start and end with alphanumeric characters.
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[update-transform-query-parms]]
 ==== {api-query-parms-title}
@@ -69,44 +76,48 @@ IMPORTANT:  You must use {kib} or this API to update a {transform}.
   (Optional, string) Free text description of the {transform}.
 
 `dest`::
-  (Optional, object) The destination configuration, which has the
-  following properties:
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest]
   
-  `index`:::
-    (Required, string) The _destination index_ for the {transform}.
+`dest`.`index`:::
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-index]
 
-  `pipeline`:::
-    (Optional, string) The unique identifier for a <<pipeline,pipeline>>.
+`dest`.`pipeline`:::
+(Optional, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
 
 `frequency`::
-  (Optional, <<time-units, time units>>) The interval between checks for changes 
-  in the source indices when the {transform} is running continuously. 
-  Also determines the retry interval in the event of transient failures while 
-  the {transform} is searching or indexing. The minimum value is `1s` 
-  and the maximum is `1h`. The default value is `1m`.
+(Optional, <<time-units, time units>>)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=frequency]
 
 `source`::
-  (Optional, object) The source configuration, which has the following
-  properties:
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
   
-  `index`:::
-    (Required, string or array) The _source indices_ for the
-    {transform}. It can be a single index, an index pattern (for
-    example, `"myindex*"`), or an array of indices (for example,
-    `["index1", "index2"]`).
+`source`.`index`:::
+(Required, string or array)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
     
-    `query`:::
-      (Optional, object) A query clause that retrieves a subset of data from the
-      source index. See <<query-dsl>>.
+`source`.`query`:::
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
   
 `sync`::
-  (Optional, object) Defines the properties required to run continuously.
-  `time`:::
-    (Required, object) Specifies that the {transform} uses a time
-    field to synchronize the source and destination indices.
-    `field`::::
-      (Required, string) The date field that is used to identify new documents
-      in the source.
+(Optional, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
+  
+`sync`.`time`:::
+(Required, object)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
+
+`sync`.`time`.`delay`::::
+(Optional, <<time-units, time units>>)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
+
+`sync`.`time`.`field`::::
+(Required, string)
+include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
 +
 --
 TIP: In general, it’s a good idea to use a field that contains the
@@ -115,9 +126,6 @@ you might need to set the `delay` such that it accounts for data transmission
 delays.
 
 --
-    `delay`::::
-      (Optional, <<time-units, time units>>) The time delay between the current 
-      time and the latest input data time. The default value is `60s`.
 
 [[update-transform-example]]
 ==== {api-examples-title}
@@ -196,9 +204,9 @@ When the {transform} is updated, you receive the updated configuration:
       "delay": "120s"
     }
   },
-  "version": "8.0.0-alpha1",
+  "version": "7.5.0",
   "create_time": 1518808660505
 }
 ----
-// TESTRESPONSE[s/"version": "8.0.0-alpha1"/"version": $body.version/]
+// TESTRESPONSE[s/"version": "7.5.0"/"version": $body.version/]
 // TESTRESPONSE[s/"create_time": 1518808660505/"create_time": $body.create_time/]

From d18176f11863d3a5ef777a9d8cdb7258a8d5a21a Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Tue, 17 Dec 2019 09:52:16 -0800
Subject: [PATCH 241/686] Ensure global buildinfo plugin is applied for distro
 download (#50249)

This commit ensures the global info plugin is applied, which supplies
the isInternal flag used to determine whether distro download looks for
bwcVersions.

relates #50230
---
 .../org/elasticsearch/gradle/DistributionDownloadPlugin.java  | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
index 88cfb80a5a2d7..861d5afcaf65c 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.gradle.ElasticsearchDistribution.Platform;
 import org.elasticsearch.gradle.ElasticsearchDistribution.Type;
 import org.elasticsearch.gradle.info.BuildParams;
+import org.elasticsearch.gradle.info.GlobalBuildInfoPlugin;
 import org.gradle.api.GradleException;
 import org.gradle.api.NamedDomainObjectContainer;
 import org.gradle.api.Plugin;
@@ -66,6 +67,9 @@ public class DistributionDownloadPlugin implements Plugin<Project> {
 
     @Override
     public void apply(Project project) {
+        // this is needed for isInternal
+        project.getRootProject().getPluginManager().apply(GlobalBuildInfoPlugin.class);
+
         distributionsContainer = project.container(ElasticsearchDistribution.class, name -> {
             Configuration fileConfiguration = project.getConfigurations().create("es_distro_file_" + name);
             Configuration extractedConfiguration = project.getConfigurations().create("es_distro_extracted_" + name);

From 922d784dd07b6fc5497d317093493133ad471d0b Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim@adjective.org>
Date: Wed, 18 Dec 2019 10:47:12 +1100
Subject: [PATCH 242/686] Do not load SSLService in plugin contructor (#49667)

XPackPlugin created an SSLService within the plugin contructor.
This has 2 negative consequences:

1. The service may be constructed based on a partial view of settings.
   Other plugins are free to add setting values via the
   additionalSettings() method, but this (necessarily) happens after
   plugins have been constructed.

2. Any exceptions thrown during the plugin construction are handled
   differently than exceptions thrown during "createComponents".
   Since SSL configurations exceptions are relatively common, it is
   far preferable for them to be thrown and handled as part of the
   createComponents flow.

This commit moves the creation of the SSLService to
XPackPlugin.createComponents, and alters the sequence of some other
steps to accommodate this change.

Relates: #44536
---
 .../elasticsearch/xpack/core/XPackPlugin.java | 19 +++++++++----
 .../xpack/core/ssl/SSLService.java            |  8 ++++++
 .../xpack/security/Security.java              | 28 +++++++++++--------
 3 files changed, 39 insertions(+), 16 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
index 02fd885b3e350..9a2d5fd65eb6d 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
@@ -134,10 +134,10 @@ public XPackPlugin(
             final Settings settings,
             final Path configPath) {
         super(settings);
+        // FIXME: The settings might be changed after this (e.g. from "additionalSettings" method in other plugins)
+        // We should only depend on the settings from the Environment object passed to createComponents
         this.settings = settings;
-        Environment env = new Environment(settings, configPath);
 
-        setSslService(new SSLService(settings, env));
         setLicenseState(new XPackLicenseState(settings));
 
         this.licensing = new Licensing(settings);
@@ -154,7 +154,14 @@ protected Clock getClock() {
     protected void setSslService(SSLService sslService) { XPackPlugin.sslService.set(sslService); }
     protected void setLicenseService(LicenseService licenseService) { XPackPlugin.licenseService.set(licenseService); }
     protected void setLicenseState(XPackLicenseState licenseState) { XPackPlugin.licenseState.set(licenseState); }
-    public static SSLService getSharedSslService() { return sslService.get(); }
+
+    public static SSLService getSharedSslService() {
+        final SSLService ssl = XPackPlugin.sslService.get();
+        if (ssl == null) {
+            throw new IllegalStateException("SSL Service is not constructed yet");
+        }
+        return ssl;
+    }
     public static LicenseService getSharedLicenseService() { return licenseService.get(); }
     public static XPackLicenseState getSharedLicenseState() { return licenseState.get(); }
 
@@ -225,14 +232,16 @@ public Collection<Object> createComponents(Client client, ClusterService cluster
                                                NodeEnvironment nodeEnvironment, NamedWriteableRegistry namedWriteableRegistry) {
         List<Object> components = new ArrayList<>();
 
+        final SSLService sslService = new SSLService(environment);
+        setSslService(sslService);
         // just create the reloader as it will pull all of the loaded ssl configurations and start watching them
-        new SSLConfigurationReloader(environment, getSslService(), resourceWatcherService);
+        new SSLConfigurationReloader(environment, sslService, resourceWatcherService);
 
         setLicenseService(new LicenseService(settings, clusterService, getClock(),
                 environment, resourceWatcherService, getLicenseState()));
 
         // It is useful to override these as they are what guice is injecting into actions
-        components.add(getSslService());
+        components.add(sslService);
         components.add(getLicenseService());
         components.add(getLicenseState());
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
index 803f5fb856476..a788090c831d9 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
@@ -122,6 +122,14 @@ public class SSLService {
     private final SetOnce<SSLConfiguration> transportSSLConfiguration = new SetOnce<>();
     private final Environment env;
 
+    /**
+     * Create a new SSLService using the {@code Settings} from {@link Environment#settings()}.
+     * @see #SSLService(Settings, Environment)
+     */
+    public SSLService(Environment environment) {
+        this(environment.settings(), environment);
+    }
+
     /**
      * Create a new SSLService that parses the settings for the ssl contexts that need to be created, creates them, and then caches them
      * for use later
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
index fe8ff8f5903b7..3b24042f47efb 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
@@ -293,7 +293,7 @@ public class Security extends Plugin implements ActionPlugin, IngestPlugin, Netw
     private final SetOnce<SecurityIndexManager> securityIndex = new SetOnce<>();
     private final SetOnce<NioGroupFactory> groupFactory = new SetOnce<>();
     private final SetOnce<DocumentSubsetBitsetCache> dlsBitsetCache = new SetOnce<>();
-    private final List<BootstrapCheck> bootstrapChecks;
+    private final SetOnce<List<BootstrapCheck>> bootstrapChecks = new SetOnce<>();
     private final List<SecurityExtension> securityExtensions = new ArrayList<>();
 
     public Security(Settings settings, final Path configPath) {
@@ -301,24 +301,19 @@ public Security(Settings settings, final Path configPath) {
     }
 
     Security(Settings settings, final Path configPath, List<SecurityExtension> extensions) {
+        // TODO This is wrong. Settings can change after this. We should use the settings from createComponents
         this.settings = settings;
+        // TODO this is wrong, we should only use the environment that is provided to createComponents
         this.env = new Environment(settings, configPath);
         this.enabled = XPackSettings.SECURITY_ENABLED.get(settings);
         if (enabled) {
             runStartupChecks(settings);
             // we load them all here otherwise we can't access secure settings since they are closed once the checks are
             // fetched
-            final List<BootstrapCheck> checks = new ArrayList<>();
-            checks.addAll(Arrays.asList(
-                new ApiKeySSLBootstrapCheck(),
-                new TokenSSLBootstrapCheck(),
-                new PkiRealmBootstrapCheck(getSslService()),
-                new TLSLicenseBootstrapCheck()));
-            checks.addAll(InternalRealms.getBootstrapChecks(settings, env));
-            this.bootstrapChecks = Collections.unmodifiableList(checks);
+
             Automatons.updateConfiguration(settings);
         } else {
-            this.bootstrapChecks = Collections.emptyList();
+            this.bootstrapChecks.set(Collections.emptyList());
         }
         this.securityExtensions.addAll(extensions);
 
@@ -358,6 +353,17 @@ Collection<Object> createComponents(Client client, ThreadPool threadPool, Cluste
             return Collections.singletonList(new SecurityUsageServices(null, null, null, null));
         }
 
+        // We need to construct the checks here while the secure settings are still available.
+        // If we wait until #getBoostrapChecks the secure settings will have been cleared/closed.
+        final List<BootstrapCheck> checks = new ArrayList<>();
+        checks.addAll(Arrays.asList(
+            new ApiKeySSLBootstrapCheck(),
+            new TokenSSLBootstrapCheck(),
+            new PkiRealmBootstrapCheck(getSslService()),
+            new TLSLicenseBootstrapCheck()));
+        checks.addAll(InternalRealms.getBootstrapChecks(settings, env));
+        this.bootstrapChecks.set(Collections.unmodifiableList(checks));
+
         threadContext.set(threadPool.getThreadContext());
         List<Object> components = new ArrayList<>();
         securityContext.set(new SecurityContext(settings, threadPool.getThreadContext()));
@@ -646,7 +652,7 @@ public List<String> getSettingsFilter() {
 
     @Override
     public List<BootstrapCheck> getBootstrapChecks() {
-       return bootstrapChecks;
+       return bootstrapChecks.get();
     }
 
     @Override

From 8db1aced6a76f2e346943858e75c3c234c738f0f Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Tue, 17 Dec 2019 21:26:29 -0800
Subject: [PATCH 243/686] Naming change

---
 .../java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index ef49d537684a8..78417857a7363 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -33,7 +33,7 @@
 public class ForceMergeAction implements LifecycleAction {
     public static final String NAME = "forcemerge";
     public static final ParseField MAX_NUM_SEGMENTS_FIELD = new ParseField("max_num_segments");
-    public static final ParseField CODEC = new ParseField("index.codec");
+    public static final ParseField CODEC = new ParseField("index_codec");
 
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {

From eeda2c7a4c5ae6fac8cf49cbc9cf84e8e72137e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Wed, 18 Dec 2019 09:10:12 +0100
Subject: [PATCH 244/686] [DOCS] Adds GET, GET stats and DELETE inference APIs
 (#50224)

Co-Authored-By: Lisa Cawley <lcawley@elastic.co>
---
 .../delete-inference-trained-model.asciidoc   |  67 +++++++++
 ...get-inference-trained-model-stats.asciidoc | 134 ++++++++++++++++++
 .../apis/get-inference-trained-model.asciidoc |  96 +++++++++++++
 .../ml/df-analytics/apis/index.asciidoc       |  11 ++
 docs/reference/ml/ml-shared.asciidoc          |  15 ++
 5 files changed, 323 insertions(+)
 create mode 100644 docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
 create mode 100644 docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
 create mode 100644 docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc

diff --git a/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc b/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
new file mode 100644
index 0000000000000..f2fd703dd83da
--- /dev/null
+++ b/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
@@ -0,0 +1,67 @@
+[role="xpack"]
+[testenv="basic"]
+[[delete-inference]]
+=== Delete {infer} trained model API
+[subs="attributes"]
+++++
+<titleabbrev>Delete {infer} trained model</titleabbrev>
+++++
+
+Deletes an existing trained {infer} model that is currently not referenced by an 
+ingest pipeline.
+
+experimental[]
+
+
+[[ml-delete-inference-request]]
+==== {api-request-title}
+
+`DELETE _ml/inference/<model_id>`
+
+
+[[ml-delete-inference-prereq]]
+==== {api-prereq-title}
+
+* You must have `machine_learning_admin` built-in role to use this API. For more 
+information, see <<security-privileges>> and <<built-in-roles>>.
+
+
+[[ml-delete-inference-path-params]]
+==== {api-path-parms-title}
+
+`<model_id>`::
+(Optional, string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
+
+
+[[ml-delete-inference-response-codes]]
+==== {api-response-codes-title}
+
+`409`::
+  The code indicates that the trained {infer} model is referenced by an ingest 
+  pipeline and cannot be deleted.
+
+
+[[ml-delete-inference-example]]
+==== {api-examples-title}
+
+The following example deletes the `regression-job-one-1574775307356` trained 
+model:
+
+[source,console]
+--------------------------------------------------
+DELETE _ml/inference/regression-job-one-1574775307356
+--------------------------------------------------
+// TEST[skip:TBD]
+
+The API returns the following result:
+
+
+[source,console-result]
+----
+{
+  "acknowledged" : true
+}
+----
+
+
diff --git a/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
new file mode 100644
index 0000000000000..a31dc071640bc
--- /dev/null
+++ b/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
@@ -0,0 +1,134 @@
+[role="xpack"]
+[testenv="basic"]
+[[get-inference-stats]]
+=== Get {infer} trained model statistics API
+[subs="attributes"]
+++++
+<titleabbrev>Get {infer} trained model stats</titleabbrev>
+++++
+
+Retrieves usage information for trained {infer} models.
+
+experimental[]
+
+
+[[ml-get-inference-stats-request]]
+==== {api-request-title}
+
+`GET _ml/inference/_stats` +
+
+`GET _ml/inference/_all/_stats` +
+
+`GET _ml/inference/<model_id>/_stats` +
+
+`GET _ml/inference/<model_id>,<model_id_2>/_stats` +
+
+`GET _ml/inference/<model_id_pattern*>,<model_id_2>/_stats`
+
+
+[[ml-get-inference-stats-prereq]]
+==== {api-prereq-title}
+
+* You must have `monitor_ml` privilege to use this API. For more information, 
+see <<security-privileges>> and <<built-in-roles>>.
+
+
+[[ml-get-inference-stats-desc]]
+==== {api-description-title}
+
+You can get usage information for multiple trained models in a single API 
+request by using a comma-separated list of model IDs or a wildcard expression.
+
+
+[[ml-get-inference-stats-path-params]]
+==== {api-path-parms-title}
+
+`<model_id>`::
+(Optional, string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
+
+
+[[ml-get-inference-stats-query-params]]
+==== {api-query-parms-title}
+
+`allow_no_match`::
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
+
+`from`::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=from]
+
+`size`::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=size]
+
+
+[[ml-get-inference-stats-response-codes]]
+==== {api-response-codes-title}
+
+`404` (Missing resources)::
+  If `allow_no_match` is `false`, this code indicates that there are no
+  resources that match the request or only partial matches for the request.
+  
+
+[[ml-get-inference-stats-example]]
+==== {api-examples-title}
+
+The following example gets usage information for all the trained models:
+
+[source,console]
+--------------------------------------------------
+GET _ml/inference/_stats
+--------------------------------------------------
+// TEST[skip:TBD]
+
+
+The API returns the following results:
+
+[source,console-result]
+----
+{
+  "count": 2,
+  "trained_model_stats": [
+    {
+      "model_id": "flight-delay-prediction-1574775339910",
+      "pipeline_count": 0
+    },
+    {
+      "model_id": "regression-job-one-1574775307356",
+      "pipeline_count": 1,
+      "ingest": {
+        "total": {
+          "count": 178,
+          "time_in_millis": 8,
+          "current": 0,
+          "failed": 0
+        },
+        "pipelines": {
+          "flight-delay": {
+            "count": 178,
+            "time_in_millis": 8,
+            "current": 0,
+            "failed": 0,
+            "processors": [
+              {
+                "inference": {
+                  "type": "inference",
+                  "stats": {
+                    "count": 178,
+                    "time_in_millis": 7,
+                    "current": 0,
+                    "failed": 0
+                  }
+                }
+              }
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
+----
+// NOTCONSOLE
\ No newline at end of file
diff --git a/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc b/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
new file mode 100644
index 0000000000000..8586962c835cc
--- /dev/null
+++ b/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
@@ -0,0 +1,96 @@
+[role="xpack"]
+[testenv="basic"]
+[[get-inference]]
+=== Get {infer} trained model API
+[subs="attributes"]
+++++
+<titleabbrev>Get {infer} trained model</titleabbrev>
+++++
+
+Retrieves configuration information for a trained {infer} model.
+
+experimental[]
+
+
+[[ml-get-inference-request]]
+==== {api-request-title}
+
+`GET _ml/inference/` +
+
+`GET _ml/inference/<model_id>` +
+
+`GET _ml/inference/_all` +
+
+`GET _ml/inference/<model_id1>,<model_id2>` +
+
+`GET _ml/inference/<model_id_pattern*>`
+
+
+[[ml-get-inference-prereq]]
+==== {api-prereq-title}
+
+* You must have `monitor_ml` privilege to use this API. For more information, 
+see <<security-privileges>> and <<built-in-roles>>.
+
+
+[[ml-get-inference-desc]]
+==== {api-description-title}
+
+You can get information for multiple trained models in a single API request by 
+using a comma-separated list of model IDs or a wildcard expression.
+
+
+[[ml-get-inference-path-params]]
+==== {api-path-parms-title}
+
+`<model_id>`::
+(Optional, string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
+
+
+[[ml-get-inference-query-params]]
+==== {api-query-parms-title}
+
+`allow_no_match`::
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
+
+`decompress_definition`::
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=decompress-definition]
+
+`from`::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=from]
+
+`include_model_definition`::
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=include-model-definition]
+
+`size`::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=size]
+
+
+[[ml-get-inference-response-codes]]
+==== {api-response-codes-title}
+
+`400`::
+  If `include_model_definition` is `true`, this code indicates that more than 
+  one models match the ID pattern.
+
+`404` (Missing resources)::
+  If `allow_no_match` is `false`, this code indicates that there are no
+  resources that match the request or only partial matches for the request.
+  
+
+[[ml-get-inference-example]]
+==== {api-examples-title}
+
+The following example gets configuration information for all the trained models:
+
+[source,console]
+--------------------------------------------------
+GET _ml/inference/
+--------------------------------------------------
+// TEST[skip:TBD]
\ No newline at end of file
diff --git a/docs/reference/ml/df-analytics/apis/index.asciidoc b/docs/reference/ml/df-analytics/apis/index.asciidoc
index bebd6d3aae820..cdad89f9bb4cd 100644
--- a/docs/reference/ml/df-analytics/apis/index.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/index.asciidoc
@@ -16,12 +16,21 @@ You can use the following APIs to perform {ml} {dfanalytics} activities.
 
 For the `analysis` object resources, check <<ml-dfa-analysis-objects>>.
 
+
+You can use the following APIs to perform {infer} operations.
+
+* <<get-inference>>
+* <<get-inference-stats>>
+* <<delete-inference>>
+
+
 See also <<ml-apis>>.
 
 //CREATE
 include::put-dfanalytics.asciidoc[]
 //DELETE
 include::delete-dfanalytics.asciidoc[]
+include::delete-inference-trained-model.asciidoc[]
 //EVALUATE
 include::evaluate-dfanalytics.asciidoc[]
 //ESTIMATE_MEMORY_USAGE
@@ -29,6 +38,8 @@ include::explain-dfanalytics.asciidoc[]
 //GET
 include::get-dfanalytics.asciidoc[]
 include::get-dfanalytics-stats.asciidoc[]
+include::get-inference-trained-model.asciidoc[]
+include::get-inference-trained-model-stats.asciidoc[]
 //SET/START/STOP
 include::start-dfanalytics.asciidoc[]
 include::stop-dfanalytics.asciidoc[]
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 5b292f24ef515..5056281642bae 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -483,6 +483,11 @@ Identifier for the {dfeed}. It can be a {dfeed} identifier or a wildcard
 expression.
 end::datafeed-id-wildcard[]
 
+tag::decompress-definition[]
+Specifies whether the included model definition should be returned as a JSON map (`true`) or 
+in a custom compressed format (`false`). Defaults to `true`.
+end::decompress-definition[]
+
 tag::delayed-data-check-config[]
 Specifies whether the {dfeed} checks for missing data and the size of the
 window. For example: `{"enabled": true, "check_window": "1h"}`.
@@ -688,6 +693,12 @@ tag::groups[]
 A list of job groups. A job can belong to no groups or many.
 end::groups[]
 
+tag::include-model-definition[]
+Specifies if the model definition should be returned in the response. Defaults 
+to `false`. When `true`, only a single model must match the ID patterns 
+provided, otherwise a bad request is returned.
+end::include-model-definition[]
+
 tag::indices[]
 An array of index names. Wildcards are supported. For example:
 `["it_ops_metrics", "server*"]`.
@@ -828,6 +839,10 @@ recommended value.
 --
 end::mode[]
 
+tag::model-id[]
+The unique identifier of the trained {infer} model.
+end::model-id[]
+
 tag::model-memory-limit[]
 The approximate maximum amount of memory resources that are required for 
 analytical processing. Once this limit is approached, data pruning becomes

From d66be06fa9f9e0f024d3daa0101f4cef228c0c6a Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Wed, 18 Dec 2019 10:36:41 +0100
Subject: [PATCH 245/686] Increase timeout on
 FollowIndexSecurityIT.testAutoFollowPatterns (#50282)

This test was causing test failures on slow CI runs.

Closes #50279
---
 .../java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ccr/qa/security/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java b/x-pack/plugin/ccr/qa/security/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java
index 9f41ae758bf94..f8ed48777dacc 100644
--- a/x-pack/plugin/ccr/qa/security/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java
+++ b/x-pack/plugin/ccr/qa/security/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java
@@ -169,7 +169,7 @@ public void testAutoFollowPatterns() throws Exception {
         assertBusy(() -> {
             ensureYellow(allowedIndex);
             verifyDocuments(allowedIndex, 5, "*:*");
-        });
+        }, 30, TimeUnit.SECONDS);
         assertThat(indexExists(disallowedIndex), is(false));
         assertBusy(() -> {
             verifyCcrMonitoring(allowedIndex, allowedIndex);

From afc18c91b9ceefbee76d5fa3d4bce4fe8c712963 Mon Sep 17 00:00:00 2001
From: Andrei Dan <andrei.dan@elastic.co>
Date: Wed, 18 Dec 2019 11:07:53 +0000
Subject: [PATCH 246/686] Extract a create index method that only manipulates
 the ClusterState (#50240)

* Extract IndexCreationTask execute into applyCreateIndexRequest

This is the first step in preparation for separating the index creation into a few
steps that only deal with the cluster state mutation and removing the IndexCreationTask
altogether.

* Split applyCreateIndexRequest

This breaks down the logic in applyCreateIndexRequest into multiple
steps that will hopefully make the service more readable and unit testable.
The service creation process now goes through a few well defined steps,
namely find the templates that possibly match the new index, parse the
requested and template matching mappings, process the index and template
matching settings, validate the wait for active shards request and
create the `IndexService`, update the mappings in the `MapperService` (which
is grouped together with creating the sort order for validation purposes),
validate the requested and templated matching aliases and finally update
the `ClusterState` to reflect the requested changes.

This also removes the `IndexCreationTask` as it was a shallow
indirection and migrates the tests from `IndexCreationTaskTests` to
`MetaDataCreateIndexServiceTests` (making them "real" unit tests
operating on the `ClusterState` rather than mocks).

* Add more unit tests.

* Add IT to verify we cleanup in case of failure
---
 .../metadata/MetaDataCreateIndexService.java  | 765 ++++++++++--------
 .../admin/indices/create/CreateIndexIT.java   |  27 +
 .../MetaDataIndexTemplateServiceTests.java    |  10 +-
 .../metadata/IndexCreationTaskTests.java      | 488 -----------
 .../MetaDataCreateIndexServiceTests.java      | 373 +++++++++
 5 files changed, 826 insertions(+), 837 deletions(-)
 delete mode 100644 server/src/test/java/org/elasticsearch/cluster/metadata/IndexCreationTaskTests.java

diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
index 7a6e71a101737..6a977fdaee368 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
@@ -46,6 +46,7 @@
 import org.elasticsearch.cluster.routing.ShardRoutingState;
 import org.elasticsearch.cluster.routing.allocation.AllocationService;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.UUIDs;
@@ -71,6 +72,7 @@
 import org.elasticsearch.indices.cluster.IndicesClusterStateService.AllocatedIndices.IndexRemovalReason;
 import org.elasticsearch.threadpool.ThreadPool;
 
+import java.io.IOException;
 import java.io.UnsupportedEncodingException;
 import java.nio.file.Path;
 import java.time.Instant;
@@ -85,8 +87,10 @@
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.function.BiFunction;
 import java.util.function.Predicate;
+import java.util.function.Supplier;
 import java.util.stream.IntStream;
 
+import static java.util.stream.Collectors.toList;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_CREATION_DATE;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_INDEX_UUID;
@@ -230,364 +234,414 @@ private void onlyCreateIndex(final CreateIndexClusterStateUpdateRequest request,
         indexScopedSettings.validate(build, true); // we do validate here - index setting must be consistent
         request.settings(build);
         clusterService.submitStateUpdateTask(
-                "create-index [" + request.index() + "], cause [" + request.cause() + "]",
-                new IndexCreationTask(
-                        logger,
-                        allocationService,
-                        request,
-                        listener,
-                        indicesService,
-                        aliasValidator,
-                        xContentRegistry,
-                        settings,
-                        this::validate,
-                        indexScopedSettings));
-    }
-
-    interface IndexValidator {
-        void validate(CreateIndexClusterStateUpdateRequest request, ClusterState state);
-    }
-
-    static class IndexCreationTask extends AckedClusterStateUpdateTask<ClusterStateUpdateResponse> {
-
-        private final IndicesService indicesService;
-        private final AliasValidator aliasValidator;
-        private final NamedXContentRegistry xContentRegistry;
-        private final CreateIndexClusterStateUpdateRequest request;
-        private final Logger logger;
-        private final AllocationService allocationService;
-        private final Settings settings;
-        private final IndexValidator validator;
-        private final IndexScopedSettings indexScopedSettings;
-
-        IndexCreationTask(Logger logger, AllocationService allocationService, CreateIndexClusterStateUpdateRequest request,
-                          ActionListener<ClusterStateUpdateResponse> listener, IndicesService indicesService,
-                          AliasValidator aliasValidator, NamedXContentRegistry xContentRegistry,
-                          Settings settings, IndexValidator validator, IndexScopedSettings indexScopedSettings) {
-            super(Priority.URGENT, request, listener);
-            this.request = request;
-            this.logger = logger;
-            this.allocationService = allocationService;
-            this.indicesService = indicesService;
-            this.aliasValidator = aliasValidator;
-            this.xContentRegistry = xContentRegistry;
-            this.settings = settings;
-            this.validator = validator;
-            this.indexScopedSettings = indexScopedSettings;
-        }
-
-        @Override
-        protected ClusterStateUpdateResponse newResponse(boolean acknowledged) {
-            return new ClusterStateUpdateResponse(acknowledged);
-        }
-
-        @Override
-        public ClusterState execute(ClusterState currentState) throws Exception {
-            logger.trace("executing IndexCreationTask for [{}] against cluster state version [{}]", request, currentState.version());
-            Index createdIndex = null;
-            String removalExtraInfo = null;
-            IndexRemovalReason removalReason = IndexRemovalReason.FAILURE;
-            try {
-                validator.validate(request, currentState);
-
-                for (Alias alias : request.aliases()) {
-                    aliasValidator.validateAlias(alias, request.index(), currentState.metaData());
+            "create-index [" + request.index() + "], cause [" + request.cause() + "]",
+            new AckedClusterStateUpdateTask<>(Priority.URGENT, request, listener) {
+                @Override
+                protected ClusterStateUpdateResponse newResponse(boolean acknowledged) {
+                    return new ClusterStateUpdateResponse(acknowledged);
                 }
 
-                // we only find a template when its an API call (a new index)
-                // find templates, highest order are better matching
-                List<IndexTemplateMetaData> templates =
-                        MetaDataIndexTemplateService.findTemplates(currentState.metaData(), request.index());
-
-                // add the request mapping
-                Map<String, Object> mappings = MapperService.parseMapping(xContentRegistry, request.mappings());
-
-                Map<String, AliasMetaData> templatesAliases = new HashMap<>();
-
-                List<String> templateNames = new ArrayList<>();
-
-                final Index recoverFromIndex = request.recoverFrom();
-
-                if (recoverFromIndex == null) {
-                    // apply templates, merging the mappings into the request mapping if exists
-                    for (IndexTemplateMetaData template : templates) {
-                        templateNames.add(template.getName());
-                        for (ObjectObjectCursor<String, CompressedXContent> cursor : template.mappings()) {
-                            String mappingString = cursor.value.string();
-                            // Templates are wrapped with their _type names, which for pre-8x templates may not
-                            // be _doc.  For now, we unwrap them based on the _type name, and then re-wrap with
-                            // _doc
-                            // TODO in 9x these will all have a _type of _doc so no re-wrapping will be necessary
-                            Map<String, Object> templateMapping = MapperService.parseMapping(xContentRegistry, mappingString);
-                            assert templateMapping.size() == 1 : templateMapping;
-                            assert cursor.key.equals(templateMapping.keySet().iterator().next()) : cursor.key + " != " + templateMapping;
-                            templateMapping = Collections.singletonMap(MapperService.SINGLE_MAPPING_NAME,
-                                templateMapping.values().iterator().next());
-                            if (mappings.isEmpty()) {
-                               mappings = templateMapping;
-                            }
-                            else {
-                                XContentHelper.mergeDefaults(mappings, templateMapping);
-                            }
-                        }
-                        //handle aliases
-                        for (ObjectObjectCursor<String, AliasMetaData> cursor : template.aliases()) {
-                            AliasMetaData aliasMetaData = cursor.value;
-                            //if an alias with same name came with the create index request itself,
-                            // ignore this one taken from the index template
-                            if (request.aliases().contains(new Alias(aliasMetaData.alias()))) {
-                                continue;
-                            }
-                            //if an alias with same name was already processed, ignore this one
-                            if (templatesAliases.containsKey(cursor.key)) {
-                                continue;
-                            }
-
-                            // Allow templatesAliases to be templated by replacing a token with the
-                            // name of the index that we are applying it to
-                            if (aliasMetaData.alias().contains("{index}")) {
-                                String templatedAlias = aliasMetaData.alias().replace("{index}", request.index());
-                                aliasMetaData = AliasMetaData.newAliasMetaData(aliasMetaData, templatedAlias);
-                            }
-
-                            aliasValidator.validateAliasMetaData(aliasMetaData, request.index(), currentState.metaData());
-                            templatesAliases.put(aliasMetaData.alias(), aliasMetaData);
-                        }
-                    }
-                }
-                Settings.Builder indexSettingsBuilder = Settings.builder();
-                if (recoverFromIndex == null) {
-                    // apply templates, here, in reverse order, since first ones are better matching
-                    for (int i = templates.size() - 1; i >= 0; i--) {
-                        indexSettingsBuilder.put(templates.get(i).settings());
-                    }
-                }
-                // now, put the request settings, so they override templates
-                indexSettingsBuilder.put(request.settings());
-                if (indexSettingsBuilder.get(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey()) == null) {
-                    final DiscoveryNodes nodes = currentState.nodes();
-                    final Version createdVersion = Version.min(Version.CURRENT, nodes.getSmallestNonClientNodeVersion());
-                    indexSettingsBuilder.put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), createdVersion);
-                }
-                if (indexSettingsBuilder.get(SETTING_NUMBER_OF_SHARDS) == null) {
-                    indexSettingsBuilder.put(SETTING_NUMBER_OF_SHARDS, settings.getAsInt(SETTING_NUMBER_OF_SHARDS, 1));
-                }
-                if (indexSettingsBuilder.get(SETTING_NUMBER_OF_REPLICAS) == null) {
-                    indexSettingsBuilder.put(SETTING_NUMBER_OF_REPLICAS, settings.getAsInt(SETTING_NUMBER_OF_REPLICAS, 1));
-                }
-                if (settings.get(SETTING_AUTO_EXPAND_REPLICAS) != null && indexSettingsBuilder.get(SETTING_AUTO_EXPAND_REPLICAS) == null) {
-                    indexSettingsBuilder.put(SETTING_AUTO_EXPAND_REPLICAS, settings.get(SETTING_AUTO_EXPAND_REPLICAS));
+                @Override
+                public ClusterState execute(ClusterState currentState) throws Exception {
+                    return applyCreateIndexRequest(currentState, request);
                 }
 
-                if (indexSettingsBuilder.get(SETTING_CREATION_DATE) == null) {
-                    indexSettingsBuilder.put(SETTING_CREATION_DATE, Instant.now().toEpochMilli());
-                }
-                indexSettingsBuilder.put(IndexMetaData.SETTING_INDEX_PROVIDED_NAME, request.getProvidedName());
-                indexSettingsBuilder.put(SETTING_INDEX_UUID, UUIDs.randomBase64UUID());
-                final IndexMetaData.Builder tmpImdBuilder = IndexMetaData.builder(request.index());
-                final Settings idxSettings = indexSettingsBuilder.build();
-                int numTargetShards = IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.get(idxSettings);
-                final int routingNumShards;
-                final Version indexVersionCreated = IndexMetaData.SETTING_INDEX_VERSION_CREATED.get(idxSettings);
-                final IndexMetaData sourceMetaData = recoverFromIndex == null ? null :
-                    currentState.metaData().getIndexSafe(recoverFromIndex);
-                if (sourceMetaData == null || sourceMetaData.getNumberOfShards() == 1) {
-                    // in this case we either have no index to recover from or
-                    // we have a source index with 1 shard and without an explicit split factor
-                    // or one that is valid in that case we can split into whatever and auto-generate a new factor.
-                    if (IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.exists(idxSettings)) {
-                        routingNumShards = IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.get(idxSettings);
+                @Override
+                public void onFailure(String source, Exception e) {
+                    if (e instanceof ResourceAlreadyExistsException) {
+                        logger.trace(() -> new ParameterizedMessage("[{}] failed to create", request.index()), e);
                     } else {
-                        routingNumShards = calculateNumRoutingShards(numTargetShards, indexVersionCreated);
-                    }
-                } else {
-                    assert IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.exists(indexSettingsBuilder.build()) == false
-                        : "index.number_of_routing_shards should not be present on the target index on resize";
-                    routingNumShards = sourceMetaData.getRoutingNumShards();
-                }
-                // remove the setting it's temporary and is only relevant once we create the index
-                indexSettingsBuilder.remove(IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.getKey());
-                tmpImdBuilder.setRoutingNumShards(routingNumShards);
-
-                if (recoverFromIndex != null) {
-                    assert request.resizeType() != null;
-                    prepareResizeIndexSettings(
-                            currentState,
-                            mappings.keySet(),
-                            indexSettingsBuilder,
-                            recoverFromIndex,
-                            request.index(),
-                            request.resizeType(),
-                            request.copySettings(),
-                            indexScopedSettings);
-                }
-                final Settings actualIndexSettings = indexSettingsBuilder.build();
-
-                /*
-                 * We can not check the shard limit until we have applied templates, otherwise we do not know the actual number of shards
-                 * that will be used to create this index.
-                 */
-                checkShardLimit(actualIndexSettings, currentState);
-
-                tmpImdBuilder.settings(actualIndexSettings);
-
-                if (recoverFromIndex != null) {
-                    /*
-                     * We need to arrange that the primary term on all the shards in the shrunken index is at least as large as
-                     * the maximum primary term on all the shards in the source index. This ensures that we have correct
-                     * document-level semantics regarding sequence numbers in the shrunken index.
-                     */
-                    final long primaryTerm =
-                        IntStream
-                            .range(0, sourceMetaData.getNumberOfShards())
-                            .mapToLong(sourceMetaData::primaryTerm)
-                            .max()
-                            .getAsLong();
-                    for (int shardId = 0; shardId < tmpImdBuilder.numberOfShards(); shardId++) {
-                        tmpImdBuilder.primaryTerm(shardId, primaryTerm);
-                    }
-                }
-                // Set up everything, now locally create the index to see that things are ok, and apply
-                final IndexMetaData tmpImd = tmpImdBuilder.build();
-                ActiveShardCount waitForActiveShards = request.waitForActiveShards();
-                if (waitForActiveShards == ActiveShardCount.DEFAULT) {
-                    waitForActiveShards = tmpImd.getWaitForActiveShards();
-                }
-                if (waitForActiveShards.validate(tmpImd.getNumberOfReplicas()) == false) {
-                    throw new IllegalArgumentException("invalid wait_for_active_shards[" + request.waitForActiveShards() +
-                        "]: cannot be greater than number of shard copies [" +
-                        (tmpImd.getNumberOfReplicas() + 1) + "]");
-                }
-                // create the index here (on the master) to validate it can be created, as well as adding the mapping
-                final IndexService indexService = indicesService.createIndex(tmpImd, Collections.emptyList());
-                createdIndex = indexService.index();
-                // now add the mappings
-
-                MapperService mapperService = indexService.mapperService();
-                if (mappings.isEmpty() == false) {
-                    assert mappings.size() == 1 : mappings;
-                    try {
-                        mapperService.merge(MapperService.SINGLE_MAPPING_NAME, mappings, MergeReason.MAPPING_UPDATE);
-                    } catch (Exception e) {
-                        removalExtraInfo = "failed on parsing mappings on index creation";
-                        throw e;
+                        logger.debug(() -> new ParameterizedMessage("[{}] failed to create", request.index()), e);
                     }
+                    super.onFailure(source, e);
                 }
+            });
+    }
 
-                if (request.recoverFrom() == null) {
-                    // now that the mapping is merged we can validate the index sort.
-                    // we cannot validate for index shrinking since the mapping is empty
-                    // at this point. The validation will take place later in the process
-                    // (when all shards are copied in a single place).
-                    indexService.getIndexSortSupplier().get();
-                }
+    /**
+     * Handles the cluster state transition to a version that reflects the {@link CreateIndexClusterStateUpdateRequest}.
+     * All the requested changes are firstly validated before mutating the {@link ClusterState}.
+     */
+    ClusterState applyCreateIndexRequest(ClusterState currentState, CreateIndexClusterStateUpdateRequest request) throws Exception {
+        logger.trace("executing IndexCreationTask for [{}] against cluster state version [{}]", request, currentState.version());
+        Index createdIndex = null;
+        String removalExtraInfo = null;
+        IndexRemovalReason removalReason = IndexRemovalReason.FAILURE;
 
-                // the context is only used for validation so it's fine to pass fake values for the shard id and the current
-                // timestamp
-                final QueryShardContext queryShardContext =
-                    indexService.newQueryShardContext(0, null, () -> 0L, null);
+        validate(request, currentState);
 
-                for (Alias alias : request.aliases()) {
-                    if (Strings.hasLength(alias.filter())) {
-                        aliasValidator.validateAliasFilter(alias.name(), alias.filter(), queryShardContext, xContentRegistry);
-                    }
-                }
-                for (AliasMetaData aliasMetaData : templatesAliases.values()) {
-                    if (aliasMetaData.filter() != null) {
-                        aliasValidator.validateAliasFilter(aliasMetaData.alias(), aliasMetaData.filter().uncompressed(),
-                            queryShardContext, xContentRegistry);
-                    }
-                }
+        final Index recoverFromIndex = request.recoverFrom();
+        final IndexMetaData sourceMetaData = recoverFromIndex == null ? null : currentState.metaData().getIndexSafe(recoverFromIndex);
 
-                // now, update the mappings with the actual source
-                Map<String, MappingMetaData> mappingsMetaData = new HashMap<>();
-                DocumentMapper mapper = mapperService.documentMapper();
-                if (mapper != null) {
-                    MappingMetaData mappingMd = new MappingMetaData(mapper);
-                    mappingsMetaData.put(mapper.type(), mappingMd);
-                }
+        // we only find a template when its an API call (a new index)
+        // find templates, highest order are better matching
+        final List<IndexTemplateMetaData> templates = sourceMetaData == null ?
+            Collections.unmodifiableList(MetaDataIndexTemplateService.findTemplates(currentState.metaData(), request.index())) :
+            List.of();
 
-                final IndexMetaData.Builder indexMetaDataBuilder = IndexMetaData.builder(request.index())
-                    .settings(actualIndexSettings)
-                    .setRoutingNumShards(routingNumShards);
+        final Map<String, Object> mappings = Collections.unmodifiableMap(parseMappings(request.mappings(), templates, xContentRegistry));
 
-                for (int shardId = 0; shardId < tmpImd.getNumberOfShards(); shardId++) {
-                    indexMetaDataBuilder.primaryTerm(shardId, tmpImd.primaryTerm(shardId));
-                }
+        final Settings aggregatedIndexSettings =
+            aggregateIndexSettings(currentState, request, templates, mappings, sourceMetaData, settings, indexScopedSettings);
+        int routingNumShards = getIndexNumberOfRoutingShards(aggregatedIndexSettings, sourceMetaData);
 
-                for (MappingMetaData mappingMd : mappingsMetaData.values()) {
-                    indexMetaDataBuilder.putMapping(mappingMd);
-                }
+        // remove the setting it's temporary and is only relevant once we create the index
+        final Settings.Builder settingsBuilder = Settings.builder().put(aggregatedIndexSettings);
+        settingsBuilder.remove(IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.getKey());
+        final Settings indexSettings = settingsBuilder.build();
 
-                for (AliasMetaData aliasMetaData : templatesAliases.values()) {
-                    indexMetaDataBuilder.putAlias(aliasMetaData);
-                }
-                for (Alias alias : request.aliases()) {
-                    AliasMetaData aliasMetaData = AliasMetaData.builder(alias.name()).filter(alias.filter())
-                        .indexRouting(alias.indexRouting()).searchRouting(alias.searchRouting()).writeIndex(alias.writeIndex()).build();
-                    indexMetaDataBuilder.putAlias(aliasMetaData);
-                }
+        try {
+            final IndexService indexService = validateActiveShardCountAndCreateIndexService(request.index(), request.waitForActiveShards(),
+                indexSettings, routingNumShards, indicesService);
+            // create the index here (on the master) to validate it can be created, as well as adding the mapping
+            createdIndex = indexService.index();
 
-                indexMetaDataBuilder.state(IndexMetaData.State.OPEN);
+            try {
+                updateIndexMappingsAndBuildSortOrder(indexService, mappings, sourceMetaData);
+            } catch (Exception e) {
+                removalExtraInfo = "failed on parsing mappings on index creation";
+                throw e;
+            }
 
-                final IndexMetaData indexMetaData;
-                try {
-                    indexMetaData = indexMetaDataBuilder.build();
-                } catch (Exception e) {
-                    removalExtraInfo = "failed to build index metadata";
-                    throw e;
+            // the context is only used for validation so it's fine to pass fake values for the shard id and the current
+            // timestamp
+            final List<AliasMetaData> aliases = Collections.unmodifiableList(
+                resolveAndValidateAliases(request.index(), request.aliases(), templates, currentState.metaData(), aliasValidator,
+                    xContentRegistry, indexService.newQueryShardContext(0, null, () -> 0L, null))
+            );
+
+            final IndexMetaData indexMetaData;
+            try {
+                indexMetaData = buildIndexMetaData(request.index(), aliases, indexService.mapperService()::documentMapper, indexSettings,
+                    routingNumShards, sourceMetaData);
+            } catch (Exception e) {
+                removalExtraInfo = "failed to build index metadata";
+                throw e;
+            }
+
+            logger.info("[{}] creating index, cause [{}], templates {}, shards [{}]/[{}], mappings {}",
+                request.index(), request.cause(), templates.stream().map(IndexTemplateMetaData::getName).collect(toList()),
+                indexMetaData.getNumberOfShards(), indexMetaData.getNumberOfReplicas(), mappings.keySet());
+
+            indexService.getIndexEventListener().beforeIndexAddedToCluster(indexMetaData.getIndex(),
+                indexMetaData.getSettings());
+            final ClusterState updatedState = clusterStateCreateIndex(currentState, request.blocks(), indexMetaData,
+                allocationService::reroute);
+
+            removalExtraInfo = "cleaning up after validating index on master";
+            removalReason = IndexRemovalReason.NO_LONGER_ASSIGNED;
+            return updatedState;
+        } finally {
+            if (createdIndex != null) {
+                // Index was already partially created - need to clean up
+                indicesService.removeIndex(createdIndex, removalReason, removalExtraInfo);
+            }
+        }
+    }
+
+    /**
+     * Parses the provided mappings json and the inheritable mappings from the templates (if any) into a map.
+     *
+     * The template mappings are applied in the order they are encountered in the list (clients should make sure the lower index, closer
+     * to the head of the list, templates have the highest {@link IndexTemplateMetaData#order()})
+     */
+    static Map<String, Object> parseMappings(String mappingsJson, List<IndexTemplateMetaData> templates,
+                                             NamedXContentRegistry xContentRegistry) throws Exception {
+        Map<String, Object> mappings = MapperService.parseMapping(xContentRegistry, mappingsJson);
+        // apply templates, merging the mappings into the request mapping if exists
+        for (IndexTemplateMetaData template : templates) {
+            for (ObjectObjectCursor<String, CompressedXContent> cursor : template.mappings()) {
+                String mappingString = cursor.value.string();
+                // Templates are wrapped with their _type names, which for pre-8x templates may not
+                // be _doc.  For now, we unwrap them based on the _type name, and then re-wrap with
+                // _doc
+                // TODO in 9x these will all have a _type of _doc so no re-wrapping will be necessary
+                Map<String, Object> templateMapping = MapperService.parseMapping(xContentRegistry, mappingString);
+                assert templateMapping.size() == 1 : templateMapping;
+                assert cursor.key.equals(templateMapping.keySet().iterator().next()) : cursor.key + " != " + templateMapping;
+                templateMapping = Collections.singletonMap(MapperService.SINGLE_MAPPING_NAME,
+                    templateMapping.values().iterator().next());
+                if (mappings.isEmpty()) {
+                    mappings = templateMapping;
+                } else {
+                    XContentHelper.mergeDefaults(mappings, templateMapping);
                 }
+            }
+        }
+        return mappings;
+    }
 
-                indexService.getIndexEventListener().beforeIndexAddedToCluster(indexMetaData.getIndex(),
-                    indexMetaData.getSettings());
+    /**
+     * Validates and creates the settings for the new index based on the explicitly configured settings via the
+     * {@link CreateIndexClusterStateUpdateRequest}, inherited from templates and, if recovering from another index (ie. split, shrink,
+     * clone), the resize settings.
+     *
+     * The template mappings are applied in the order they are encountered in the list (clients should make sure the lower index, closer
+     * to the head of the list, templates have the highest {@link IndexTemplateMetaData#order()})
+     *
+     * @return the aggregated settings for the new index
+     */
+    static Settings aggregateIndexSettings(ClusterState currentState, CreateIndexClusterStateUpdateRequest request,
+                                           List<IndexTemplateMetaData> templates, Map<String, Object> mappings,
+                                           @Nullable IndexMetaData sourceMetaData, Settings settings,
+                                           IndexScopedSettings indexScopedSettings) {
+        Settings.Builder indexSettingsBuilder = Settings.builder();
+        if (sourceMetaData == null) {
+            // apply templates, here, in reverse order, since first ones are better matching
+            for (int i = templates.size() - 1; i >= 0; i--) {
+                indexSettingsBuilder.put(templates.get(i).settings());
+            }
+        }
+        // now, put the request settings, so they override templates
+        indexSettingsBuilder.put(request.settings());
+        if (indexSettingsBuilder.get(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey()) == null) {
+            final DiscoveryNodes nodes = currentState.nodes();
+            final Version createdVersion = Version.min(Version.CURRENT, nodes.getSmallestNonClientNodeVersion());
+            indexSettingsBuilder.put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), createdVersion);
+        }
+        if (indexSettingsBuilder.get(SETTING_NUMBER_OF_SHARDS) == null) {
+            indexSettingsBuilder.put(SETTING_NUMBER_OF_SHARDS, settings.getAsInt(SETTING_NUMBER_OF_SHARDS, 1));
+        }
+        if (indexSettingsBuilder.get(SETTING_NUMBER_OF_REPLICAS) == null) {
+            indexSettingsBuilder.put(SETTING_NUMBER_OF_REPLICAS, settings.getAsInt(SETTING_NUMBER_OF_REPLICAS, 1));
+        }
+        if (settings.get(SETTING_AUTO_EXPAND_REPLICAS) != null && indexSettingsBuilder.get(SETTING_AUTO_EXPAND_REPLICAS) == null) {
+            indexSettingsBuilder.put(SETTING_AUTO_EXPAND_REPLICAS, settings.get(SETTING_AUTO_EXPAND_REPLICAS));
+        }
+
+        if (indexSettingsBuilder.get(SETTING_CREATION_DATE) == null) {
+            indexSettingsBuilder.put(SETTING_CREATION_DATE, Instant.now().toEpochMilli());
+        }
+        indexSettingsBuilder.put(IndexMetaData.SETTING_INDEX_PROVIDED_NAME, request.getProvidedName());
+        indexSettingsBuilder.put(SETTING_INDEX_UUID, UUIDs.randomBase64UUID());
+
+        if (sourceMetaData != null) {
+            assert request.resizeType() != null;
+            prepareResizeIndexSettings(
+                currentState,
+                mappings.keySet(),
+                indexSettingsBuilder,
+                request.recoverFrom(),
+                request.index(),
+                request.resizeType(),
+                request.copySettings(),
+                indexScopedSettings);
+        }
+
+        Settings indexSettings = indexSettingsBuilder.build();
+        /*
+         * We can not check the shard limit until we have applied templates, otherwise we do not know the actual number of shards
+         * that will be used to create this index.
+         */
+        MetaDataCreateIndexService.checkShardLimit(indexSettings, currentState);
+        return indexSettings;
+    }
 
-                MetaData newMetaData = MetaData.builder(currentState.metaData())
-                    .put(indexMetaData, false)
-                    .build();
+    /**
+     * Calculates the number of routing shards based on the configured value in indexSettings or if recovering from another index
+     * it will return the value configured for that index.
+     */
+    static int getIndexNumberOfRoutingShards(Settings indexSettings, @Nullable IndexMetaData sourceMetaData) {
+        final int numTargetShards = IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.get(indexSettings);
+        final Version indexVersionCreated = IndexMetaData.SETTING_INDEX_VERSION_CREATED.get(indexSettings);
+        final int routingNumShards;
+        if (sourceMetaData == null || sourceMetaData.getNumberOfShards() == 1) {
+            // in this case we either have no index to recover from or
+            // we have a source index with 1 shard and without an explicit split factor
+            // or one that is valid in that case we can split into whatever and auto-generate a new factor.
+            if (IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.exists(indexSettings)) {
+                routingNumShards = IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.get(indexSettings);
+            } else {
+                routingNumShards = calculateNumRoutingShards(numTargetShards, indexVersionCreated);
+            }
+        } else {
+            assert IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.exists(indexSettings) == false
+                : "index.number_of_routing_shards should not be present on the target index on resize";
+            routingNumShards = sourceMetaData.getRoutingNumShards();
+        }
+        return routingNumShards;
+    }
 
-                logger.info("[{}] creating index, cause [{}], templates {}, shards [{}]/[{}], mappings {}",
-                    request.index(), request.cause(), templateNames, indexMetaData.getNumberOfShards(),
-                    indexMetaData.getNumberOfReplicas(), mappings.keySet());
+    /**
+     * Validate and resolve the aliases explicitly set for the index, together with the ones inherited from the specified
+     * templates.
+     *
+     * The template mappings are applied in the order they are encountered in the list (clients should make sure the lower index, closer
+     * to the head of the list, templates have the highest {@link IndexTemplateMetaData#order()})
+     *
+     * @return the list of resolved aliases, with the explicitly provided aliases occurring first (having a higher priority) followed by
+     * the ones inherited from the templates
+     */
+    static List<AliasMetaData> resolveAndValidateAliases(String index, Set<Alias> aliases, List<IndexTemplateMetaData> templates,
+                                                         MetaData metaData, AliasValidator aliasValidator,
+                                                         NamedXContentRegistry xContentRegistry, QueryShardContext queryShardContext) {
+        List<AliasMetaData> resolvedAliases = new ArrayList<>();
+        for (Alias alias : aliases) {
+            aliasValidator.validateAlias(alias, index, metaData);
+            if (Strings.hasLength(alias.filter())) {
+                aliasValidator.validateAliasFilter(alias.name(), alias.filter(), queryShardContext, xContentRegistry);
+            }
+            AliasMetaData aliasMetaData = AliasMetaData.builder(alias.name()).filter(alias.filter())
+                .indexRouting(alias.indexRouting()).searchRouting(alias.searchRouting()).writeIndex(alias.writeIndex()).build();
+            resolvedAliases.add(aliasMetaData);
+        }
+
+        Map<String, AliasMetaData> templatesAliases = new HashMap<>();
+        for (IndexTemplateMetaData template : templates) {
+            // handle aliases
+            for (ObjectObjectCursor<String, AliasMetaData> cursor : template.aliases()) {
+                AliasMetaData aliasMetaData = cursor.value;
+                // if an alias with same name came with the create index request itself,
+                // ignore this one taken from the index template
+                if (aliases.contains(new Alias(aliasMetaData.alias()))) {
+                    continue;
+                }
+                // if an alias with same name was already processed, ignore this one
+                if (templatesAliases.containsKey(cursor.key)) {
+                    continue;
+                }
 
-                ClusterBlocks.Builder blocks = ClusterBlocks.builder().blocks(currentState.blocks());
-                if (!request.blocks().isEmpty()) {
-                    for (ClusterBlock block : request.blocks()) {
-                        blocks.addIndexBlock(request.index(), block);
-                    }
+                // Allow templatesAliases to be templated by replacing a token with the
+                // name of the index that we are applying it to
+                if (aliasMetaData.alias().contains("{index}")) {
+                    String templatedAlias = aliasMetaData.alias().replace("{index}", index);
+                    aliasMetaData = AliasMetaData.newAliasMetaData(aliasMetaData, templatedAlias);
                 }
-                blocks.updateBlocks(indexMetaData);
-
-                ClusterState updatedState = ClusterState.builder(currentState).blocks(blocks).metaData(newMetaData).build();
-
-                RoutingTable.Builder routingTableBuilder = RoutingTable.builder(updatedState.routingTable())
-                    .addAsNew(updatedState.metaData().index(request.index()));
-                updatedState = allocationService.reroute(
-                    ClusterState.builder(updatedState).routingTable(routingTableBuilder.build()).build(),
-                    "index [" + request.index() + "] created");
-                removalExtraInfo = "cleaning up after validating index on master";
-                removalReason = IndexRemovalReason.NO_LONGER_ASSIGNED;
-                return updatedState;
-            } finally {
-                if (createdIndex != null) {
-                    // Index was already partially created - need to clean up
-                    indicesService.removeIndex(createdIndex, removalReason, removalExtraInfo);
+
+                aliasValidator.validateAliasMetaData(aliasMetaData, index, metaData);
+                if (aliasMetaData.filter() != null) {
+                    aliasValidator.validateAliasFilter(aliasMetaData.alias(), aliasMetaData.filter().uncompressed(),
+                        queryShardContext, xContentRegistry);
                 }
+                templatesAliases.put(aliasMetaData.alias(), aliasMetaData);
+                resolvedAliases.add((aliasMetaData));
             }
         }
+        return resolvedAliases;
+    }
 
-        protected void checkShardLimit(final Settings settings, final ClusterState clusterState) {
-            MetaDataCreateIndexService.checkShardLimit(settings, clusterState);
+    /**
+     * Creates the index into the cluster state applying the provided blocks. The final cluster state will contain an updated routing
+     * table based on the live nodes.
+     */
+    static ClusterState clusterStateCreateIndex(ClusterState currentState, Set<ClusterBlock> clusterBlocks, IndexMetaData indexMetaData,
+                                                BiFunction<ClusterState, String, ClusterState> rerouteRoutingTable) {
+        MetaData newMetaData = MetaData.builder(currentState.metaData())
+            .put(indexMetaData, false)
+            .build();
+
+        String indexName = indexMetaData.getIndex().getName();
+        ClusterBlocks.Builder blocks = createClusterBlocksBuilder(currentState, indexName, clusterBlocks);
+        blocks.updateBlocks(indexMetaData);
+
+        ClusterState updatedState = ClusterState.builder(currentState).blocks(blocks).metaData(newMetaData).build();
+
+        RoutingTable.Builder routingTableBuilder = RoutingTable.builder(updatedState.routingTable())
+            .addAsNew(updatedState.metaData().index(indexName));
+        updatedState = ClusterState.builder(updatedState).routingTable(routingTableBuilder.build()).build();
+        return rerouteRoutingTable.apply(updatedState, "index [" + indexName + "] created");
+    }
+
+    static IndexMetaData buildIndexMetaData(String indexName, List<AliasMetaData> aliases,
+                                            Supplier<DocumentMapper> documentMapperSupplier, Settings indexSettings, int routingNumShards,
+                                            @Nullable IndexMetaData sourceMetaData) {
+        IndexMetaData.Builder indexMetaDataBuilder = createIndexMetadataBuilder(indexName, sourceMetaData, indexSettings, routingNumShards);
+        // now, update the mappings with the actual source
+        Map<String, MappingMetaData> mappingsMetaData = new HashMap<>();
+        DocumentMapper mapper = documentMapperSupplier.get();
+        if (mapper != null) {
+            MappingMetaData mappingMd = new MappingMetaData(mapper);
+            mappingsMetaData.put(mapper.type(), mappingMd);
         }
 
-        @Override
-        public void onFailure(String source, Exception e) {
-            if (e instanceof ResourceAlreadyExistsException) {
-                logger.trace(() -> new ParameterizedMessage("[{}] failed to create", request.index()), e);
-            } else {
-                logger.debug(() -> new ParameterizedMessage("[{}] failed to create", request.index()), e);
+        for (MappingMetaData mappingMd : mappingsMetaData.values()) {
+            indexMetaDataBuilder.putMapping(mappingMd);
+        }
+
+        // apply the aliases in reverse order as the lower index ones have higher order
+        for (int i = aliases.size() - 1; i >= 0; i--) {
+            indexMetaDataBuilder.putAlias(aliases.get(i));
+        }
+
+        indexMetaDataBuilder.state(IndexMetaData.State.OPEN);
+        return indexMetaDataBuilder.build();
+    }
+
+    /**
+     * Creates an {@link IndexMetaData.Builder} for the provided index and sets a valid primary term for all the shards if a source
+     * index meta data is provided (this represents the case where we're shrinking/splitting an index and the primary term for the newly
+     * created index needs to be gte than the maximum term in the source index).
+     */
+    private static IndexMetaData.Builder createIndexMetadataBuilder(String indexName, @Nullable IndexMetaData sourceMetaData,
+                                                                    Settings indexSettings, int routingNumShards) {
+        final IndexMetaData.Builder builder = IndexMetaData.builder(indexName);
+        builder.setRoutingNumShards(routingNumShards);
+        builder.settings(indexSettings);
+
+        if (sourceMetaData != null) {
+            /*
+             * We need to arrange that the primary term on all the shards in the shrunken index is at least as large as
+             * the maximum primary term on all the shards in the source index. This ensures that we have correct
+             * document-level semantics regarding sequence numbers in the shrunken index.
+             */
+            final long primaryTerm =
+                IntStream
+                    .range(0, sourceMetaData.getNumberOfShards())
+                    .mapToLong(sourceMetaData::primaryTerm)
+                    .max()
+                    .getAsLong();
+            for (int shardId = 0; shardId < builder.numberOfShards(); shardId++) {
+                builder.primaryTerm(shardId, primaryTerm);
+            }
+        }
+        return builder;
+    }
+
+    private static ClusterBlocks.Builder createClusterBlocksBuilder(ClusterState currentState, String index, Set<ClusterBlock> blocks) {
+        ClusterBlocks.Builder blocksBuilder = ClusterBlocks.builder().blocks(currentState.blocks());
+        if (!blocks.isEmpty()) {
+            for (ClusterBlock block : blocks) {
+                blocksBuilder.addIndexBlock(index, block);
             }
-            super.onFailure(source, e);
         }
+        return blocksBuilder;
+    }
+
+    private static void updateIndexMappingsAndBuildSortOrder(IndexService indexService, Map<String, Object> mappings,
+                                                             @Nullable IndexMetaData sourceMetaData) throws IOException {
+        MapperService mapperService = indexService.mapperService();
+        if (!mappings.isEmpty()) {
+            assert mappings.size() == 1 : mappings;
+            mapperService.merge(MapperService.SINGLE_MAPPING_NAME, mappings, MergeReason.MAPPING_UPDATE);
+        }
+
+        if (sourceMetaData == null) {
+            // now that the mapping is merged we can validate the index sort.
+            // we cannot validate for index shrinking since the mapping is empty
+            // at this point. The validation will take place later in the process
+            // (when all shards are copied in a single place).
+            indexService.getIndexSortSupplier().get();
+        }
+    }
+
+    private static IndexService validateActiveShardCountAndCreateIndexService(String indexName, ActiveShardCount waitForActiveShards,
+                                                                              Settings indexSettings, int routingNumShards,
+                                                                              IndicesService indicesService) throws IOException {
+        final IndexMetaData.Builder tmpImdBuilder = IndexMetaData.builder(indexName);
+        tmpImdBuilder.setRoutingNumShards(routingNumShards);
+        tmpImdBuilder.settings(indexSettings);
+
+        // Set up everything, now locally create the index to see that things are ok, and apply
+        IndexMetaData tmpImd = tmpImdBuilder.build();
+        if (waitForActiveShards == ActiveShardCount.DEFAULT) {
+            waitForActiveShards = tmpImd.getWaitForActiveShards();
+        }
+        if (waitForActiveShards.validate(tmpImd.getNumberOfReplicas()) == false) {
+            throw new IllegalArgumentException("invalid wait_for_active_shards[" + waitForActiveShards +
+                "]: cannot be greater than number of shard copies [" +
+                (tmpImd.getNumberOfReplicas() + 1) + "]");
+        }
+        return indicesService.createIndex(tmpImd, Collections.emptyList());
     }
 
     private void validate(CreateIndexClusterStateUpdateRequest request, ClusterState state) {
@@ -596,7 +650,7 @@ private void validate(CreateIndexClusterStateUpdateRequest request, ClusterState
     }
 
     public void validateIndexSettings(String indexName, final Settings settings, final boolean forbidPrivateIndexSettings)
-            throws IndexCreationException {
+        throws IndexCreationException {
         List<String> validationErrors = getIndexSettingsValidationErrors(settings, forbidPrivateIndexSettings);
 
         if (validationErrors.isEmpty() == false) {
@@ -627,24 +681,44 @@ public static void checkShardLimit(final Settings settings, final ClusterState c
     }
 
     List<String> getIndexSettingsValidationErrors(final Settings settings, final boolean forbidPrivateIndexSettings) {
-        String customPath = IndexMetaData.INDEX_DATA_PATH_SETTING.get(settings);
+        List<String> validationErrors = validateIndexCustomPath(settings, env.sharedDataFile());
+        if (forbidPrivateIndexSettings) {
+            validationErrors.addAll(validatePrivateSettingsNotExplicitlySet(settings, indexScopedSettings));
+        }
+        return validationErrors;
+    }
+
+    private static List<String> validatePrivateSettingsNotExplicitlySet(Settings settings, IndexScopedSettings indexScopedSettings) {
         List<String> validationErrors = new ArrayList<>();
-        if (Strings.isEmpty(customPath) == false && env.sharedDataFile() == null) {
-            validationErrors.add("path.shared_data must be set in order to use custom data paths");
-        } else if (Strings.isEmpty(customPath) == false) {
-            Path resolvedPath = PathUtils.get(new Path[]{env.sharedDataFile()}, customPath);
-            if (resolvedPath == null) {
-                validationErrors.add("custom path [" + customPath +
-                                     "] is not a sub-path of path.shared_data [" + env.sharedDataFile() + "]");
+        for (final String key : settings.keySet()) {
+            final Setting<?> setting = indexScopedSettings.get(key);
+            if (setting == null) {
+                assert indexScopedSettings.isPrivateSetting(key);
+            } else if (setting.isPrivateIndex()) {
+                validationErrors.add("private index setting [" + key + "] can not be set explicitly");
             }
         }
-        if (forbidPrivateIndexSettings) {
-            for (final String key : settings.keySet()) {
-                final Setting<?> setting = indexScopedSettings.get(key);
-                if (setting == null) {
-                    assert indexScopedSettings.isPrivateSetting(key);
-                } else if (setting.isPrivateIndex()) {
-                    validationErrors.add("private index setting [" + key + "] can not be set explicitly");
+        return validationErrors;
+    }
+
+    /**
+     * Validates that the configured index data path (if any) is a sub-path of the configured shared data path (if any)
+     *
+     * @param settings the index configured settings
+     * @param sharedDataPath the configured `path.shared_data` (if any)
+     * @return a list containing validaton errors or an empty list if there aren't any errors
+     */
+    private static List<String> validateIndexCustomPath(Settings settings, @Nullable Path sharedDataPath) {
+        String customPath = IndexMetaData.INDEX_DATA_PATH_SETTING.get(settings);
+        List<String> validationErrors = new ArrayList<>();
+        if (!Strings.isEmpty(customPath)) {
+            if (sharedDataPath == null) {
+                validationErrors.add("path.shared_data must be set in order to use custom data paths");
+            } else {
+                Path resolvedPath = PathUtils.get(new Path[]{sharedDataPath}, customPath);
+                if (resolvedPath == null) {
+                    validationErrors.add("custom path [" + customPath +
+                        "] is not a sub-path of path.shared_data [" + sharedDataPath + "]");
                 }
             }
         }
@@ -653,11 +727,12 @@ List<String> getIndexSettingsValidationErrors(final Settings settings, final boo
 
     /**
      * Validates the settings and mappings for shrinking an index.
+     *
      * @return the list of nodes at least one instance of the source index shards are allocated
      */
     static List<String> validateShrinkIndex(ClusterState state, String sourceIndex,
-                                        Set<String> targetIndexMappingsTypes, String targetIndexName,
-                                        Settings targetIndexSettings) {
+                                            Set<String> targetIndexMappingsTypes, String targetIndexName,
+                                            Settings targetIndexSettings) {
         IndexMetaData sourceMetaData = validateResize(state, sourceIndex, targetIndexMappingsTypes, targetIndexName, targetIndexSettings);
         assert IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.exists(targetIndexSettings);
         IndexMetaData.selectShrinkShards(0, sourceMetaData, IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.get(targetIndexSettings));
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexIT.java b/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexIT.java
index 7db4bb36dfa30..8592964c766ed 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexIT.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexIT.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.UnavailableShardsException;
 import org.elasticsearch.action.admin.cluster.state.ClusterStateResponse;
+import org.elasticsearch.action.admin.indices.alias.Alias;
 import org.elasticsearch.action.admin.indices.mapping.get.GetMappingsResponse;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.ActiveShardCount;
@@ -36,8 +37,10 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.index.IndexNotFoundException;
+import org.elasticsearch.index.IndexService;
 import org.elasticsearch.index.mapper.MapperParsingException;
 import org.elasticsearch.index.query.RangeQueryBuilder;
+import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.ESIntegTestCase.ClusterScope;
 import org.elasticsearch.test.ESIntegTestCase.Scope;
@@ -49,10 +52,12 @@
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_WAIT_FOR_ACTIVE_SHARDS;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertBlocked;
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertThrows;
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.greaterThanOrEqualTo;
 import static org.hamcrest.Matchers.lessThanOrEqualTo;
+import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.startsWith;
 import static org.hamcrest.core.IsNull.notNullValue;
 
@@ -287,6 +292,28 @@ public void testRestartIndexCreationAfterFullClusterRestart() throws Exception {
         ensureGreen("test");
     }
 
+    public void testFailureToCreateIndexCleansUpIndicesService() {
+        final int numReplicas = internalCluster().numDataNodes();
+        Settings settings = Settings.builder()
+            .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+            .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), numReplicas)
+            .build();
+        assertAcked(client().admin().indices().prepareCreate("test-idx-1")
+            .setSettings(settings)
+            .addAlias(new Alias("alias1").writeIndex(true))
+            .get());
+
+        assertThrows(client().admin().indices().prepareCreate("test-idx-2")
+                .setSettings(settings)
+                .addAlias(new Alias("alias1").writeIndex(true)),
+            IllegalStateException.class);
+
+        IndicesService indicesService = internalCluster().getInstance(IndicesService.class, internalCluster().getMasterName());
+        for (IndexService indexService : indicesService) {
+            assertThat(indexService.index().getName(), not("test-idx-2"));
+        }
+    }
+
     /**
      * This test ensures that index creation adheres to the {@link IndexMetaData#SETTING_WAIT_FOR_ACTIVE_SHARDS}.
      */
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
index a929ee63c576e..5652f20e8b390 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
@@ -33,6 +33,7 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentFactory;
+import org.elasticsearch.env.Environment;
 import org.elasticsearch.index.mapper.MapperParsingException;
 import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.indices.InvalidIndexTemplateException;
@@ -47,6 +48,7 @@
 import java.util.concurrent.CountDownLatch;
 import java.util.stream.Collectors;
 
+import static org.elasticsearch.common.settings.Settings.builder;
 import static org.hamcrest.CoreMatchers.containsString;
 import static org.hamcrest.CoreMatchers.equalTo;
 import static org.hamcrest.CoreMatchers.instanceOf;
@@ -58,7 +60,7 @@ public void testIndexTemplateInvalidNumberOfShards() {
         PutRequest request = new PutRequest("test", "test_shards");
         request.patterns(Collections.singletonList("test_shards*"));
 
-        request.settings(Settings.builder()
+        request.settings(builder()
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, "0")
             .put("index.shard.check_on_startup", "blargh").build());
 
@@ -75,7 +77,7 @@ public void testIndexTemplateInvalidNumberOfShards() {
     public void testIndexTemplateValidationAccumulatesValidationErrors() {
         PutRequest request = new PutRequest("test", "putTemplate shards");
         request.patterns(Collections.singletonList("_test_shards*"));
-        request.settings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, "0").build());
+        request.settings(builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, "0").build());
 
         List<Throwable> throwables = putTemplate(xContentRegistry(), request);
         assertEquals(throwables.size(), 1);
@@ -156,7 +158,7 @@ private static List<Throwable> putTemplate(NamedXContentRegistry xContentRegistr
                 null,
                 null,
                 null,
-                null,
+                new Environment(builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString()).build(), null),
                 IndexScopedSettings.DEFAULT_SCOPED_SETTINGS,
                 null,
                 xContentRegistry,
@@ -189,7 +191,7 @@ private List<Throwable> putTemplateDetail(PutRequest request) throws Exception {
                 indicesService,
                 null,
                 null,
-                null,
+                new Environment(builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString()).build(), null),
                 null,
                 null,
                 xContentRegistry(),
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/IndexCreationTaskTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/IndexCreationTaskTests.java
deleted file mode 100644
index 29ba48139506c..0000000000000
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/IndexCreationTaskTests.java
+++ /dev/null
@@ -1,488 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.cluster.metadata;
-
-import org.apache.logging.log4j.Logger;
-import org.apache.lucene.search.Sort;
-import org.elasticsearch.Version;
-import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.action.admin.indices.alias.Alias;
-import org.elasticsearch.action.admin.indices.create.CreateIndexClusterStateUpdateRequest;
-import org.elasticsearch.action.admin.indices.shrink.ResizeType;
-import org.elasticsearch.action.support.ActiveShardCount;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.block.ClusterBlock;
-import org.elasticsearch.cluster.block.ClusterBlockLevel;
-import org.elasticsearch.cluster.block.ClusterBlocks;
-import org.elasticsearch.cluster.node.DiscoveryNodes;
-import org.elasticsearch.cluster.routing.IndexRoutingTable;
-import org.elasticsearch.cluster.routing.RoutingTable;
-import org.elasticsearch.cluster.routing.ShardRoutingState;
-import org.elasticsearch.cluster.routing.TestShardRouting;
-import org.elasticsearch.cluster.routing.allocation.AllocationService;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.collect.ImmutableOpenMap;
-import org.elasticsearch.common.compress.CompressedXContent;
-import org.elasticsearch.common.settings.IndexScopedSettings;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.util.set.Sets;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
-import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.index.Index;
-import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.mapper.DocumentMapper;
-import org.elasticsearch.index.mapper.MapperService;
-import org.elasticsearch.index.mapper.RoutingFieldMapper;
-import org.elasticsearch.index.shard.IndexEventListener;
-import org.elasticsearch.indices.IndicesService;
-import org.elasticsearch.indices.InvalidAliasNameException;
-import org.elasticsearch.test.ESTestCase;
-import org.hamcrest.Matchers;
-import org.mockito.ArgumentCaptor;
-import org.mockito.stubbing.Answer;
-
-import java.io.IOException;
-import java.util.Arrays;
-import java.util.Collections;
-import java.util.HashSet;
-import java.util.Map;
-import java.util.Set;
-import java.util.function.Supplier;
-
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
-import static org.elasticsearch.test.hamcrest.CollectionAssertions.hasAllKeys;
-import static org.elasticsearch.test.hamcrest.CollectionAssertions.hasKey;
-import static org.hamcrest.Matchers.containsString;
-import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.not;
-import static org.hamcrest.Matchers.startsWith;
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.anyObject;
-import static org.mockito.Matchers.anyString;
-import static org.mockito.Mockito.anyMap;
-import static org.mockito.Mockito.doThrow;
-import static org.mockito.Mockito.eq;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.times;
-import static org.mockito.Mockito.verify;
-import static org.mockito.Mockito.when;
-
-public class IndexCreationTaskTests extends ESTestCase {
-
-    private final IndicesService indicesService = mock(IndicesService.class);
-    private final AliasValidator aliasValidator = new AliasValidator();
-    private final NamedXContentRegistry xContentRegistry = mock(NamedXContentRegistry.class);
-    private final CreateIndexClusterStateUpdateRequest request = mock(CreateIndexClusterStateUpdateRequest.class);
-    private final Logger logger = mock(Logger.class);
-    private final AllocationService allocationService = mock(AllocationService.class);
-    private final MetaDataCreateIndexService.IndexValidator validator = mock(MetaDataCreateIndexService.IndexValidator.class);
-    private final ActionListener listener = mock(ActionListener.class);
-    private final ClusterState state = mock(ClusterState.class);
-    private final Settings.Builder clusterStateSettings = Settings.builder();
-    private final MapperService mapper = mock(MapperService.class);
-
-    private final ImmutableOpenMap.Builder<String, IndexTemplateMetaData> tplBuilder = ImmutableOpenMap.builder();
-    private final ImmutableOpenMap.Builder<String, MetaData.Custom> customBuilder = ImmutableOpenMap.builder();
-    private final ImmutableOpenMap.Builder<String, IndexMetaData> idxBuilder = ImmutableOpenMap.builder();
-
-    private final Settings.Builder reqSettings = Settings.builder();
-    private final Set<ClusterBlock> reqBlocks = Sets.newHashSet();
-    private final MetaData.Builder currentStateMetaDataBuilder = MetaData.builder();
-    private final ClusterBlocks currentStateBlocks = mock(ClusterBlocks.class);
-    private final RoutingTable.Builder routingTableBuilder = RoutingTable.builder();
-    private final DocumentMapper docMapper = mock(DocumentMapper.class);
-
-    private ActiveShardCount waitForActiveShardsNum = ActiveShardCount.DEFAULT;
-
-    public void setUp() throws Exception {
-        super.setUp();
-        setupIndicesService();
-        setupClusterState();
-        when(request.mappings()).thenReturn("{}");
-    }
-
-    public void testMatchTemplates() throws Exception {
-        tplBuilder.put("template_1", createTemplateMetadata("template_1", "te*"));
-        tplBuilder.put("template_2", createTemplateMetadata("template_2", "tes*"));
-        tplBuilder.put("template_3", createTemplateMetadata("template_3", "zzz*"));
-
-        final ClusterState result = executeTask();
-
-        assertThat(result.metaData().index("test").getAliases(), hasAllKeys("alias_from_template_1", "alias_from_template_2"));
-        assertThat(result.metaData().index("test").getAliases(), not(hasKey("alias_from_template_3")));
-    }
-
-    public void testApplyDataFromTemplate() throws Exception {
-        addMatchingTemplate(builder -> builder
-                .putAlias(AliasMetaData.builder("alias1"))
-                .putMapping("_doc", createMapping())
-                .settings(Settings.builder().put("key1", "value1"))
-        );
-
-        final ClusterState result = executeTask();
-
-        assertThat(result.metaData().index("test").getAliases(), hasKey("alias1"));
-        assertThat(result.metaData().index("test").getSettings().get("key1"), equalTo("value1"));
-        assertThat(getMappingsFromResponse(), Matchers.hasKey("_doc"));
-    }
-
-    public void testApplyDataFromRequest() throws Exception {
-        setupRequestAlias(new Alias("alias1"));
-        setupRequestMapping("type", createMapping());
-        reqSettings.put("key1", "value1");
-
-        final ClusterState result = executeTask();
-
-        assertThat(result.metaData().index("test").getAliases(), hasKey("alias1"));
-        assertThat(result.metaData().index("test").getSettings().get("key1"), equalTo("value1"));
-        assertThat(getMappingsFromResponse(), Matchers.hasKey("_doc"));
-    }
-
-    public void testInvalidAliasName() throws Exception {
-        final String[] invalidAliasNames = new String[] { "-alias1", "+alias2", "_alias3", "a#lias", "al:ias", ".", ".." };
-        setupRequestAlias(new Alias(randomFrom(invalidAliasNames)));
-        expectThrows(InvalidAliasNameException.class, this::executeTask);
-    }
-
-    public void testRequestDataHavePriorityOverTemplateData() throws Exception {
-        final CompressedXContent tplMapping = createMapping("text");
-        final CompressedXContent reqMapping = createMapping("keyword");
-
-        addMatchingTemplate(builder -> builder
-                    .putAlias(AliasMetaData.builder("alias1").searchRouting("fromTpl").build())
-                    .putMapping("_doc", tplMapping)
-                    .settings(Settings.builder().put("key1", "tplValue"))
-        );
-
-        setupRequestAlias(new Alias("alias1").searchRouting("fromReq"));
-        setupRequestMapping("type", reqMapping);
-        reqSettings.put("key1", "reqValue");
-
-        final ClusterState result = executeTask();
-
-        assertThat(result.metaData().index("test").getAliases().get("alias1").getSearchRouting(), equalTo("fromReq"));
-        assertThat(result.metaData().index("test").getSettings().get("key1"), equalTo("reqValue"));
-        assertThat(getMappingsFromResponse().toString(), equalTo("{_doc={properties={field={type=keyword}}}}"));
-    }
-
-    public void testDefaultSettings() throws Exception {
-        final ClusterState result = executeTask();
-
-        assertThat(result.getMetaData().index("test").getSettings().get(SETTING_NUMBER_OF_SHARDS), equalTo("1"));
-    }
-
-    public void testSettingsFromClusterState() throws Exception {
-        clusterStateSettings.put(SETTING_NUMBER_OF_SHARDS, 15);
-
-        final ClusterState result = executeTask();
-
-        assertThat(result.getMetaData().index("test").getSettings().get(SETTING_NUMBER_OF_SHARDS), equalTo("15"));
-    }
-
-    public void testTemplateOrder() throws Exception {
-        addMatchingTemplate(builder -> builder
-            .order(1)
-            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 10))
-            .putAlias(AliasMetaData.builder("alias1").searchRouting("1").build())
-        );
-        addMatchingTemplate(builder -> builder
-            .order(2)
-            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 11))
-            .putAlias(AliasMetaData.builder("alias1").searchRouting("2").build())
-        );
-        addMatchingTemplate(builder -> builder
-            .order(3)
-            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 12))
-            .putAlias(AliasMetaData.builder("alias1").searchRouting("3").build())
-        );
-        final ClusterState result = executeTask();
-
-        assertThat(result.getMetaData().index("test").getSettings().get(SETTING_NUMBER_OF_SHARDS), equalTo("12"));
-        assertThat(result.metaData().index("test").getAliases().get("alias1").getSearchRouting(), equalTo("3"));
-    }
-
-    public void testTemplateOrder2() throws Exception {
-        addMatchingTemplate(builder -> builder
-            .order(3)
-            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 12))
-            .putAlias(AliasMetaData.builder("alias1").searchRouting("3").build())
-        );
-        addMatchingTemplate(builder -> builder
-            .order(2)
-            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 11))
-            .putAlias(AliasMetaData.builder("alias1").searchRouting("2").build())
-        );
-        addMatchingTemplate(builder -> builder
-            .order(1)
-            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 10))
-            .putAlias(AliasMetaData.builder("alias1").searchRouting("1").build())
-        );
-        final ClusterState result = executeTask();
-
-        assertThat(result.getMetaData().index("test").getSettings().get(SETTING_NUMBER_OF_SHARDS), equalTo("12"));
-        assertThat(result.metaData().index("test").getAliases().get("alias1").getSearchRouting(), equalTo("3"));
-    }
-
-    public void testRequestStateOpen() throws Exception {
-        executeTask();
-        verify(allocationService, times(1)).reroute(anyObject(), anyObject());
-    }
-
-    @SuppressWarnings("unchecked")
-    public void testIndexRemovalOnFailure() throws Exception {
-        doThrow(new RuntimeException("oops")).when(mapper).merge(anyString(), anyMap(), anyObject());
-
-        setupRequestMapping("type", createMapping("keyword"));
-        expectThrows(RuntimeException.class, this::executeTask);
-
-        verify(indicesService, times(1)).removeIndex(anyObject(), anyObject(), anyObject());
-    }
-
-    public void testShrinkIndexIgnoresTemplates() throws Exception {
-        final Index source = new Index("source_idx", "aaa111bbb222");
-
-        when(request.recoverFrom()).thenReturn(source);
-        when(request.resizeType()).thenReturn(ResizeType.SHRINK);
-        currentStateMetaDataBuilder.put(createIndexMetaDataBuilder("source_idx", "aaa111bbb222", 2, 2));
-
-        routingTableBuilder.add(createIndexRoutingTableWithStartedShards(source));
-
-        when(currentStateBlocks.indexBlocked(eq(ClusterBlockLevel.WRITE), eq("source_idx"))).thenReturn(true);
-        reqSettings.put(SETTING_NUMBER_OF_SHARDS, 1);
-
-        addMatchingTemplate(builder -> builder
-            .putAlias(AliasMetaData.builder("alias1").searchRouting("fromTpl").build())
-            .putMapping("mapping1", createMapping())
-            .settings(Settings.builder().put("key1", "tplValue"))
-        );
-
-        final ClusterState result = executeTask();
-
-        assertThat(result.metaData().index("test").getAliases(), not(hasKey("alias1")));
-        assertThat(result.metaData().index("test").getCustomData(), not(hasKey("custom1")));
-        assertThat(result.metaData().index("test").getSettings().keySet(), not(Matchers.contains("key1")));
-    }
-
-    public void testValidateWaitForActiveShardsFailure() throws Exception {
-        waitForActiveShardsNum = ActiveShardCount.from(1000);
-
-        IllegalArgumentException e = expectThrows(IllegalArgumentException.class, this::executeTask);
-
-        assertThat(e.getMessage(), containsString("invalid wait_for_active_shards"));
-    }
-
-    public void testWriteIndex() throws Exception {
-        Boolean writeIndex = randomBoolean() ? null : randomBoolean();
-        setupRequestAlias(new Alias("alias1").writeIndex(writeIndex));
-        setupRequestMapping("type", createMapping());
-        reqSettings.put("key1", "value1");
-
-        final ClusterState result = executeTask();
-        assertThat(result.metaData().index("test").getAliases(), hasKey("alias1"));
-        assertThat(result.metaData().index("test").getAliases().get("alias1").writeIndex(), equalTo(writeIndex));
-    }
-
-    public void testWriteIndexValidationException() throws Exception {
-        IndexMetaData existingWriteIndex = IndexMetaData.builder("test2")
-            .settings(settings(Version.CURRENT)).putAlias(AliasMetaData.builder("alias1").writeIndex(true).build())
-            .numberOfShards(1).numberOfReplicas(0).build();
-        idxBuilder.put("test2", existingWriteIndex);
-        setupRequestMapping("type", createMapping());
-        reqSettings.put("key1", "value1");
-        setupRequestAlias(new Alias("alias1").writeIndex(true));
-
-        Exception exception = expectThrows(IllegalStateException.class, () -> executeTask());
-        assertThat(exception.getMessage(), startsWith("alias [alias1] has more than one write index ["));
-    }
-
-    public void testTypedTemplateWithTypelessIndexCreation() throws Exception {
-        addMatchingTemplate(builder -> builder.putMapping("type", "{\"type\": {}}"));
-        setupRequestMapping(MapperService.SINGLE_MAPPING_NAME, new CompressedXContent("{\"_doc\":{}}"));
-        executeTask();
-        assertThat(getMappingsFromResponse(), Matchers.hasKey(MapperService.SINGLE_MAPPING_NAME));
-    }
-
-    public void testTypedTemplate() throws Exception {
-        addMatchingTemplate(builder -> builder.putMapping("type",
-            "{\"type\":{\"properties\":{\"field\":{\"type\":\"keyword\"}}}}"));
-        executeTask();
-        assertThat(getMappingsFromResponse(), Matchers.hasKey("_doc"));
-    }
-
-    public void testTypelessTemplate() throws Exception {
-        addMatchingTemplate(builder -> builder.putMapping(MapperService.SINGLE_MAPPING_NAME, "{\"_doc\": {}}"));
-        executeTask();
-        assertThat(getMappingsFromResponse(), Matchers.hasKey(MapperService.SINGLE_MAPPING_NAME));
-    }
-
-    private IndexRoutingTable createIndexRoutingTableWithStartedShards(Index index) {
-        final IndexRoutingTable idxRoutingTable = mock(IndexRoutingTable.class);
-
-        when(idxRoutingTable.getIndex()).thenReturn(index);
-        when(idxRoutingTable.shardsWithState(eq(ShardRoutingState.STARTED))).thenReturn(Arrays.asList(
-            TestShardRouting.newShardRouting(index.getName(), 0, "1", randomBoolean(), ShardRoutingState.INITIALIZING).moveToStarted(),
-            TestShardRouting.newShardRouting(index.getName(), 0, "1", randomBoolean(), ShardRoutingState.INITIALIZING).moveToStarted()
-
-        ));
-
-        return idxRoutingTable;
-    }
-
-    private IndexMetaData.Builder createIndexMetaDataBuilder(String name, String uuid, int numShards, int numReplicas) {
-        return IndexMetaData
-            .builder(name)
-            .settings(Settings.builder()
-                .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
-                .put(IndexMetaData.SETTING_INDEX_UUID, uuid))
-            .putMapping(new MappingMetaData(docMapper))
-            .numberOfShards(numShards)
-            .numberOfReplicas(numReplicas);
-    }
-
-    private interface MetaDataBuilderConfigurator {
-        void configure(IndexTemplateMetaData.Builder builder) throws IOException;
-    }
-
-    private void addMatchingTemplate(MetaDataBuilderConfigurator configurator) throws IOException {
-        final IndexTemplateMetaData.Builder builder = metaDataBuilder("template1", "te*");
-        configurator.configure(builder);
-
-        tplBuilder.put("template" + builder.hashCode(), builder.build());
-    }
-
-    @SuppressWarnings("unchecked")
-    private Map<String, Map<String, Object>> getMappingsFromResponse() throws IOException {
-        final ArgumentCaptor<Map> argument = ArgumentCaptor.forClass(Map.class);
-        verify(mapper).merge(anyString(), argument.capture(), anyObject());
-        return argument.getValue();
-    }
-
-    private void setupRequestAlias(Alias alias) {
-        when(request.aliases()).thenReturn(new HashSet<>(Collections.singletonList(alias)));
-    }
-
-    private void setupRequestMapping(String mappingKey, CompressedXContent mapping) throws IOException {
-        when(request.mappings()).thenReturn(mapping.string());
-    }
-
-    private CompressedXContent createMapping() throws IOException {
-        return createMapping("text");
-    }
-
-    private CompressedXContent createMapping(String fieldType) throws IOException {
-        final String mapping = Strings.toString(XContentFactory.jsonBuilder()
-            .startObject()
-                .startObject("_doc")
-                    .startObject("properties")
-                        .startObject("field")
-                            .field("type", fieldType)
-                        .endObject()
-                    .endObject()
-                .endObject()
-            .endObject());
-
-        return new CompressedXContent(mapping);
-    }
-
-    private IndexTemplateMetaData.Builder metaDataBuilder(String name, String pattern) {
-        return IndexTemplateMetaData
-            .builder(name)
-            .patterns(Collections.singletonList(pattern));
-    }
-
-    private IndexTemplateMetaData createTemplateMetadata(String name, String pattern) {
-        return IndexTemplateMetaData
-            .builder(name)
-            .patterns(Collections.singletonList(pattern))
-            .putAlias(AliasMetaData.builder("alias_from_" + name).build())
-            .build();
-    }
-
-    @SuppressWarnings("unchecked")
-    private ClusterState executeTask() throws Exception {
-        setupState();
-        setupRequest();
-        final MetaDataCreateIndexService.IndexCreationTask task = new MetaDataCreateIndexService.IndexCreationTask(
-            logger, allocationService, request, listener, indicesService, aliasValidator, xContentRegistry, clusterStateSettings.build(),
-            validator, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS) {
-
-            @Override
-            protected void checkShardLimit(final Settings settings, final ClusterState clusterState) {
-                // we have to make this a no-op since we are not mocking enough for this method to be able to execute
-            }
-
-        };
-        return task.execute(state);
-    }
-
-    private void setupState() {
-        final ImmutableOpenMap.Builder<String, ClusterState.Custom> stateCustomsBuilder = ImmutableOpenMap.builder();
-
-        currentStateMetaDataBuilder
-            .customs(customBuilder.build())
-            .templates(tplBuilder.build())
-            .indices(idxBuilder.build());
-
-        when(state.metaData()).thenReturn(currentStateMetaDataBuilder.build());
-
-        final ImmutableOpenMap.Builder<String, Set<ClusterBlock>> blockIdxBuilder = ImmutableOpenMap.builder();
-
-        when(currentStateBlocks.indices()).thenReturn(blockIdxBuilder.build());
-
-        when(state.blocks()).thenReturn(currentStateBlocks);
-        when(state.customs()).thenReturn(stateCustomsBuilder.build());
-        when(state.routingTable()).thenReturn(routingTableBuilder.build());
-    }
-
-    private void setupRequest() {
-        when(request.settings()).thenReturn(reqSettings.build());
-        when(request.index()).thenReturn("test");
-        when(request.waitForActiveShards()).thenReturn(waitForActiveShardsNum);
-        when(request.blocks()).thenReturn(reqBlocks);
-    }
-
-    private void setupClusterState() {
-        final DiscoveryNodes nodes = mock(DiscoveryNodes.class);
-        when(nodes.getSmallestNonClientNodeVersion()).thenReturn(Version.CURRENT);
-
-        when(state.nodes()).thenReturn(nodes);
-    }
-
-    @SuppressWarnings("unchecked")
-    private void setupIndicesService() throws Exception {
-        final RoutingFieldMapper routingMapper = mock(RoutingFieldMapper.class);
-        when(routingMapper.required()).thenReturn(false);
-
-        when(docMapper.routingFieldMapper()).thenReturn(routingMapper);
-
-        when(mapper.documentMapper()).thenReturn(docMapper);
-
-        final Index index = new Index("target", "tgt1234");
-        final Supplier<Sort> supplier = mock(Supplier.class);
-        final IndexService service = mock(IndexService.class);
-        when(service.index()).thenReturn(index);
-        when(service.mapperService()).thenReturn(mapper);
-        when(service.getIndexSortSupplier()).thenReturn(supplier);
-        when(service.getIndexEventListener()).thenReturn(mock(IndexEventListener.class));
-
-        when(indicesService.createIndex(anyObject(), anyObject())).thenReturn(service);
-        when(allocationService.reroute(any(ClusterState.class), anyString())).thenAnswer(
-            (Answer<ClusterState>) invocationOnMock -> (ClusterState) invocationOnMock.getArguments()[0]);
-    }
-}
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
index 436157ae79b54..e7d35eaeb18ab 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
@@ -19,8 +19,11 @@
 
 package org.elasticsearch.cluster.metadata;
 
+import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.ResourceAlreadyExistsException;
 import org.elasticsearch.Version;
+import org.elasticsearch.action.admin.indices.alias.Alias;
+import org.elasticsearch.action.admin.indices.create.CreateIndexClusterStateUpdateRequest;
 import org.elasticsearch.action.admin.indices.shrink.ResizeType;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
@@ -38,40 +41,90 @@
 import org.elasticsearch.cluster.shards.ClusterShardLimitIT;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.ValidationException;
+import org.elasticsearch.common.collect.ImmutableOpenMap;
+import org.elasticsearch.common.compress.CompressedXContent;
 import org.elasticsearch.common.settings.IndexScopedSettings;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.BigArrays;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentFactory;
+import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexNotFoundException;
+import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.index.mapper.MapperService;
+import org.elasticsearch.index.query.QueryShardContext;
+import org.elasticsearch.indices.InvalidAliasNameException;
 import org.elasticsearch.indices.InvalidIndexNameException;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.VersionUtils;
 import org.elasticsearch.test.gateway.TestGatewayAllocator;
+import org.hamcrest.Matchers;
+import org.junit.Before;
 
+import java.io.IOException;
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.Comparator;
 import java.util.List;
 import java.util.Locale;
+import java.util.Map;
 import java.util.Set;
+import java.util.UUID;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.function.BiFunction;
 import java.util.function.Consumer;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
 import static java.util.Collections.emptyMap;
+import static org.elasticsearch.cluster.metadata.IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING;
+import static org.elasticsearch.cluster.metadata.IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING;
+import static org.elasticsearch.cluster.metadata.IndexMetaData.INDEX_READ_ONLY_BLOCK;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_REPLICAS;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
+import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_READ_ONLY;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_VERSION_CREATED;
+import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.aggregateIndexSettings;
+import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.buildIndexMetaData;
+import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.clusterStateCreateIndex;
+import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.getIndexNumberOfRoutingShards;
+import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.parseMappings;
+import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.resolveAndValidateAliases;
 import static org.elasticsearch.cluster.shards.ClusterShardLimitIT.ShardCounts.forDataNodeCount;
+import static org.elasticsearch.index.IndexSettings.INDEX_SOFT_DELETES_SETTING;
 import static org.elasticsearch.indices.IndicesServiceTests.createClusterForShardLimitTest;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.endsWith;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.hasKey;
 import static org.hamcrest.Matchers.hasToString;
+import static org.hamcrest.Matchers.hasValue;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.nullValue;
+import static org.hamcrest.Matchers.startsWith;
 
 public class MetaDataCreateIndexServiceTests extends ESTestCase {
 
+    private AliasValidator aliasValidator;
+    private CreateIndexClusterStateUpdateRequest request;
+    private QueryShardContext queryShardContext;
+
+    @Before
+    public void setupCreateIndexRequestAndAliasValidator() {
+        aliasValidator = new AliasValidator();
+        request = new CreateIndexClusterStateUpdateRequest("create index", "test", "test");
+        Settings indexSettings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
+            .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1).put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1).build();
+        queryShardContext = new QueryShardContext(0,
+            new IndexSettings(IndexMetaData.builder("test").settings(indexSettings).build(), indexSettings),
+            BigArrays.NON_RECYCLING_INSTANCE, null, null, null, null, null, xContentRegistry(), writableRegistry(),
+            null, null, () -> randomNonNegativeLong(), null, null);
+    }
+
     private ClusterState createClusterState(String name, int numShards, int numReplicas, Settings settings) {
         int numRoutingShards = settings.getAsInt(IndexMetaData.INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.getKey(), numShards);
         MetaData.Builder metaBuilder = MetaData.builder();
@@ -486,4 +539,324 @@ public void testShardLimit() {
         assertThat(e, hasToString(containsString(expectedMessage)));
     }
 
+    public void testParseMappingsAppliesDataFromTemplateAndRequest() throws Exception {
+        IndexTemplateMetaData templateMetaData = addMatchingTemplate(templateBuilder -> {
+            templateBuilder.putAlias(AliasMetaData.builder("alias1"));
+            templateBuilder.putMapping("_doc", createMapping("mapping_from_template", "text"));
+        });
+        request.mappings(createMapping("mapping_from_request", "text").string());
+
+        Map<String, Object> parsedMappings = MetaDataCreateIndexService.parseMappings(request.mappings(), List.of(templateMetaData),
+            NamedXContentRegistry.EMPTY);
+
+        assertThat(parsedMappings, hasKey("_doc"));
+        Map<String, Object> doc = (Map<String, Object>) parsedMappings.get("_doc");
+        assertThat(doc, hasKey("properties"));
+        Map<String, Object> mappingsProperties = (Map<String, Object>) doc.get("properties");
+        assertThat(mappingsProperties, hasKey("mapping_from_request"));
+        assertThat(mappingsProperties, hasKey("mapping_from_template"));
+    }
+
+    public void testAggregateSettingsAppliesSettingsFromTemplatesAndRequest() {
+        IndexTemplateMetaData templateMetaData = addMatchingTemplate(builder -> {
+            builder.settings(Settings.builder().put("template_setting", "value1"));
+        });
+        ImmutableOpenMap.Builder<String, IndexTemplateMetaData> templatesBuilder = ImmutableOpenMap.builder();
+        templatesBuilder.put("template_1", templateMetaData);
+        MetaData metaData = new MetaData.Builder().templates(templatesBuilder.build()).build();
+        ClusterState clusterState = ClusterState.builder(org.elasticsearch.cluster.ClusterName.CLUSTER_NAME_SETTING
+            .getDefault(Settings.EMPTY))
+            .metaData(metaData)
+            .build();
+        request.settings(Settings.builder().put("request_setting", "value2").build());
+
+        Settings aggregatedIndexSettings = aggregateIndexSettings(clusterState, request, List.of(templateMetaData), Map.of(),
+            null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+
+        assertThat(aggregatedIndexSettings.get("template_setting"), equalTo("value1"));
+        assertThat(aggregatedIndexSettings.get("request_setting"), equalTo("value2"));
+    }
+
+    public void testInvalidAliasName() {
+        final String[] invalidAliasNames = new String[] { "-alias1", "+alias2", "_alias3", "a#lias", "al:ias", ".", ".." };
+        String aliasName = randomFrom(invalidAliasNames);
+        request.aliases(Set.of(new Alias(aliasName)));
+
+        expectThrows(InvalidAliasNameException.class, () ->
+            resolveAndValidateAliases(request.index(), request.aliases(), List.of(), MetaData.builder().build(),
+                aliasValidator, xContentRegistry(), queryShardContext)
+        );
+    }
+
+    public void testRequestDataHavePriorityOverTemplateData() throws Exception {
+        CompressedXContent templateMapping = createMapping("test", "text");
+        CompressedXContent reqMapping = createMapping("test", "keyword");
+
+        IndexTemplateMetaData templateMetaData = addMatchingTemplate(builder -> builder
+            .putAlias(AliasMetaData.builder("alias").searchRouting("fromTemplate").build())
+            .putMapping("_doc", templateMapping)
+            .settings(Settings.builder().put("key1", "templateValue"))
+        );
+
+        request.mappings(reqMapping.string());
+        request.aliases(Set.of(new Alias("alias").searchRouting("fromRequest")));
+        request.settings(Settings.builder().put("key1", "requestValue").build());
+
+        Map<String, Object> parsedMappings = MetaDataCreateIndexService.parseMappings(request.mappings(), List.of(templateMetaData),
+            xContentRegistry());
+        List<AliasMetaData> resolvedAliases = resolveAndValidateAliases(request.index(), request.aliases(), List.of(templateMetaData),
+            MetaData.builder().build(), aliasValidator, xContentRegistry(), queryShardContext);
+        Settings aggregatedIndexSettings = aggregateIndexSettings(ClusterState.EMPTY_STATE, request, List.of(templateMetaData), Map.of(),
+            null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+
+        assertThat(resolvedAliases.get(0).getSearchRouting(), equalTo("fromRequest"));
+        assertThat(aggregatedIndexSettings.get("key1"), equalTo("requestValue"));
+        assertThat(parsedMappings, hasKey("_doc"));
+        Map<String, Object> doc = (Map<String, Object>) parsedMappings.get("_doc");
+        assertThat(doc, hasKey("properties"));
+        Map<String, Object> mappingsProperties = (Map<String, Object>) doc.get("properties");
+        assertThat(mappingsProperties, hasKey("test"));
+        assertThat((Map<String, Object>) mappingsProperties.get("test"), hasValue("keyword"));
+    }
+
+    public void testDefaultSettings() {
+        Settings aggregatedIndexSettings = aggregateIndexSettings(ClusterState.EMPTY_STATE, request, List.of(), Map.of(),
+            null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+
+        assertThat(aggregatedIndexSettings.get(SETTING_NUMBER_OF_SHARDS), equalTo("1"));
+    }
+
+    public void testSettingsFromClusterState() {
+        Settings aggregatedIndexSettings = aggregateIndexSettings(ClusterState.EMPTY_STATE, request, List.of(), Map.of(),
+            null, Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 15).build(), IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+
+        assertThat(aggregatedIndexSettings.get(SETTING_NUMBER_OF_SHARDS), equalTo("15"));
+    }
+
+    public void testTemplateOrder() throws Exception {
+        List<IndexTemplateMetaData> templates = new ArrayList<>(3);
+        templates.add(addMatchingTemplate(builder -> builder
+            .order(3)
+            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 12))
+            .putAlias(AliasMetaData.builder("alias1").writeIndex(true).searchRouting("3").build())
+        ));
+        templates.add(addMatchingTemplate(builder -> builder
+            .order(2)
+            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 11))
+            .putAlias(AliasMetaData.builder("alias1").searchRouting("2").build())
+        ));
+        templates.add(addMatchingTemplate(builder -> builder
+            .order(1)
+            .settings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 10))
+            .putAlias(AliasMetaData.builder("alias1").searchRouting("1").build())
+        ));
+        Settings aggregatedIndexSettings = aggregateIndexSettings(ClusterState.EMPTY_STATE, request, templates, Map.of(),
+            null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+        List<AliasMetaData> resolvedAliases = resolveAndValidateAliases(request.index(), request.aliases(), templates,
+            MetaData.builder().build(), aliasValidator, xContentRegistry(), queryShardContext);
+        assertThat(aggregatedIndexSettings.get(SETTING_NUMBER_OF_SHARDS), equalTo("12"));
+        AliasMetaData alias = resolvedAliases.get(0);
+        assertThat(alias.getSearchRouting(), equalTo("3"));
+        assertThat(alias.writeIndex(), is(true));
+    }
+
+    public void testAggregateIndexSettingsIgnoresTemplatesOnCreateFromSourceIndex() throws Exception {
+        CompressedXContent templateMapping = createMapping("test", "text");
+
+        IndexTemplateMetaData templateMetaData = addMatchingTemplate(builder -> builder
+            .putAlias(AliasMetaData.builder("alias").searchRouting("fromTemplate").build())
+            .putMapping("_doc", templateMapping)
+            .settings(Settings.builder().put("templateSetting", "templateValue"))
+        );
+
+        request.settings(Settings.builder().put("requestSetting", "requestValue").build());
+        request.resizeType(ResizeType.SPLIT);
+        request.recoverFrom(new Index("sourceIndex", UUID.randomUUID().toString()));
+        ClusterState clusterState =
+            createClusterState("sourceIndex", 1, 0,
+                Settings.builder().put("index.blocks.write", true).build());
+
+        Settings aggregatedIndexSettings = aggregateIndexSettings(clusterState, request, List.of(templateMetaData), Map.of(),
+            clusterState.metaData().index("sourceIndex"), Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+
+        assertThat(aggregatedIndexSettings.get("templateSetting"), is(nullValue()));
+        assertThat(aggregatedIndexSettings.get("requestSetting"), is("requestValue"));
+    }
+
+    public void testClusterStateCreateIndexThrowsWriteIndexValidationException() throws Exception {
+        IndexMetaData existingWriteIndex = IndexMetaData.builder("test2")
+            .settings(settings(Version.CURRENT)).putAlias(AliasMetaData.builder("alias1").writeIndex(true).build())
+            .numberOfShards(1).numberOfReplicas(0).build();
+        ClusterState currentClusterState =
+            ClusterState.builder(ClusterState.EMPTY_STATE).metaData(MetaData.builder().put(existingWriteIndex, false).build()).build();
+
+        IndexMetaData newIndex = IndexMetaData.builder("test")
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .putAlias(AliasMetaData.builder("alias1").writeIndex(true).build())
+            .build();
+
+        assertThat(
+            expectThrows(IllegalStateException.class,
+                () -> clusterStateCreateIndex(currentClusterState, Set.of(), newIndex, (state, reason) -> state)).getMessage(),
+            startsWith("alias [alias1] has more than one write index [")
+        );
+    }
+
+    public void testClusterStateCreateIndex() {
+        ClusterState currentClusterState =
+            ClusterState.builder(ClusterState.EMPTY_STATE).build();
+
+        IndexMetaData newIndexMetaData = IndexMetaData.builder("test")
+            .settings(settings(Version.CURRENT).put(SETTING_READ_ONLY, true))
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .putAlias(AliasMetaData.builder("alias1").writeIndex(true).build())
+            .build();
+
+        // used as a value container, not for the concurrency and visibility guarantees
+        AtomicBoolean allocationRerouted = new AtomicBoolean(false);
+        BiFunction<ClusterState, String, ClusterState> rerouteRoutingTable = (clusterState, reason) -> {
+            allocationRerouted.compareAndSet(false, true);
+            return clusterState;
+        };
+
+        ClusterState updatedClusterState = clusterStateCreateIndex(currentClusterState, Set.of(INDEX_READ_ONLY_BLOCK), newIndexMetaData,
+            rerouteRoutingTable);
+        assertThat(updatedClusterState.blocks().getIndexBlockWithId("test", INDEX_READ_ONLY_BLOCK.id()), is(INDEX_READ_ONLY_BLOCK));
+        assertThat(updatedClusterState.routingTable().index("test"), is(notNullValue()));
+        assertThat(allocationRerouted.get(), is(true));
+    }
+
+    public void testParseMappingsWithTypedTemplateAndTypelessIndexMapping() throws Exception {
+        IndexTemplateMetaData templateMetaData = addMatchingTemplate(builder -> {
+            try {
+                builder.putMapping("type", "{\"type\": {}}");
+            } catch (IOException e) {
+                ExceptionsHelper.reThrowIfNotNull(e);
+            }
+        });
+
+        Map<String, Object> mappings = parseMappings("{\"_doc\":{}}", List.of(templateMetaData), xContentRegistry());
+        assertThat(mappings, Matchers.hasKey(MapperService.SINGLE_MAPPING_NAME));
+    }
+
+    public void testParseMappingsWithTypedTemplate() throws Exception {
+        IndexTemplateMetaData templateMetaData = addMatchingTemplate(builder -> {
+            try {
+                builder.putMapping("type",
+                    "{\"type\":{\"properties\":{\"field\":{\"type\":\"keyword\"}}}}");
+            } catch (IOException e) {
+                ExceptionsHelper.reThrowIfNotNull(e);
+            }
+        });
+        Map<String, Object> mappings = parseMappings("", List.of(templateMetaData), xContentRegistry());
+        assertThat(mappings, Matchers.hasKey(MapperService.SINGLE_MAPPING_NAME));
+    }
+
+    public void testParseMappingsWithTypelessTemplate() throws Exception {
+        IndexTemplateMetaData templateMetaData = addMatchingTemplate(builder -> {
+            try {
+                builder.putMapping(MapperService.SINGLE_MAPPING_NAME, "{\"_doc\": {}}");
+            } catch (IOException e) {
+                ExceptionsHelper.reThrowIfNotNull(e);
+            }
+        });
+        Map<String, Object> mappings = parseMappings("", List.of(templateMetaData), xContentRegistry());
+        assertThat(mappings, Matchers.hasKey(MapperService.SINGLE_MAPPING_NAME));
+    }
+
+    public void testBuildIndexMetadata() {
+        IndexMetaData sourceIndexMetaData = IndexMetaData.builder("parent")
+            .settings(Settings.builder()
+                .put("index.version.created", Version.CURRENT)
+                .build())
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .primaryTerm(0, 3L)
+            .build();
+
+        Settings indexSettings = Settings.builder()
+            .put("index.version.created", Version.CURRENT)
+            .put(INDEX_SOFT_DELETES_SETTING.getKey(), false)
+            .put(SETTING_NUMBER_OF_REPLICAS, 0)
+            .put(SETTING_NUMBER_OF_SHARDS, 1)
+            .build();
+        List<AliasMetaData> aliases = List.of(AliasMetaData.builder("alias1").build());
+        IndexMetaData indexMetaData = buildIndexMetaData("test", aliases, () -> null, indexSettings, 4, sourceIndexMetaData);
+
+        assertThat(indexMetaData.getSettings().getAsBoolean(INDEX_SOFT_DELETES_SETTING.getKey(), true), is(false));
+        assertThat(indexMetaData.getAliases().size(), is(1));
+        assertThat(indexMetaData.getAliases().keys().iterator().next().value, is("alias1"));
+        assertThat("The source index primary term must be used", indexMetaData.primaryTerm(0), is(3L));
+    }
+
+    public void testGetIndexNumberOfRoutingShardsWithNullSourceIndex() {
+        Settings indexSettings = Settings.builder()
+            .put("index.version.created", Version.CURRENT)
+            .put(INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 3)
+            .build();
+        int targetRoutingNumberOfShards = getIndexNumberOfRoutingShards(indexSettings, null);
+        assertThat("When the target routing number of shards is not specified the expected value is the configured number of shards " +
+            "multiplied by 2 at most ten times (ie. 3 * 2^8)", targetRoutingNumberOfShards, is(768));
+    }
+
+    public void testGetIndexNumberOfRoutingShardsWhenExplicitlyConfigured() {
+        Settings indexSettings = Settings.builder()
+            .put(INDEX_NUMBER_OF_ROUTING_SHARDS_SETTING.getKey(), 9)
+            .put(INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 3)
+            .build();
+        int targetRoutingNumberOfShards = getIndexNumberOfRoutingShards(indexSettings, null);
+        assertThat(targetRoutingNumberOfShards, is(9));
+    }
+
+    public void testGetIndexNumberOfRoutingShardsYieldsSourceNumberOfShards() {
+        Settings indexSettings = Settings.builder()
+            .put(INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 3)
+            .build();
+
+        IndexMetaData sourceIndexMetaData = IndexMetaData.builder("parent")
+            .settings(Settings.builder()
+                .put("index.version.created", Version.CURRENT)
+                .build())
+            .numberOfShards(6)
+            .numberOfReplicas(0)
+            .build();
+
+        int targetRoutingNumberOfShards = getIndexNumberOfRoutingShards(indexSettings, sourceIndexMetaData);
+        assertThat(targetRoutingNumberOfShards, is(6));
+    }
+
+    private IndexTemplateMetaData addMatchingTemplate(Consumer<IndexTemplateMetaData.Builder> configurator) {
+        IndexTemplateMetaData.Builder builder = templateMetaDataBuilder("template1", "te*");
+        configurator.accept(builder);
+        return builder.build();
+    }
+
+    private IndexTemplateMetaData.Builder templateMetaDataBuilder(String name, String pattern) {
+        return IndexTemplateMetaData
+            .builder(name)
+            .patterns(Collections.singletonList(pattern));
+    }
+
+    private CompressedXContent createMapping(String fieldName, String fieldType) {
+        try {
+            final String mapping = Strings.toString(XContentFactory.jsonBuilder()
+                .startObject()
+                .startObject("_doc")
+                .startObject("properties")
+                .startObject(fieldName)
+                .field("type", fieldType)
+                .endObject()
+                .endObject()
+                .endObject()
+                .endObject());
+
+            return new CompressedXContent(mapping);
+        } catch (IOException e) {
+            throw ExceptionsHelper.convertToRuntime(e);
+        }
+    }
+
 }

From 5932d4950d25f0b077c96f235bc07af8a6db1be4 Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Wed, 18 Dec 2019 08:26:57 -0500
Subject: [PATCH 247/686] Always consume the body in has privileges (#50298)

Our REST infrastructure will reject requests that have a body where the
body of the request is never consumed. This ensures that we reject
requests on endpoints that do not support having a body. This requires
cooperation from the REST handlers though, to actually consume the body,
otherwise the REST infrastructure will proceed with rejecting the
request. This commit addresses an issue in the has privileges API where
we would prematurely try to reject a request for not having a username,
before consuming the body. Since the body was not consumed, the REST
infrastructure would instead reject the request as a bad request.
---
 .../action/user/RestHasPrivilegesAction.java  |  6 ++-
 .../user/RestHasPrivilegesActionTests.java    | 46 ++++++++++++++++---
 2 files changed, 45 insertions(+), 7 deletions(-)

diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/user/RestHasPrivilegesAction.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/user/RestHasPrivilegesAction.java
index 975f25a6d2055..3c589e7220aa7 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/user/RestHasPrivilegesAction.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/user/RestHasPrivilegesAction.java
@@ -69,11 +69,15 @@ public String getName() {
 
     @Override
     public RestChannelConsumer innerPrepareRequest(RestRequest request, NodeClient client) throws IOException {
+        /*
+         * Consume the body immediately. This ensures that if there is a body and we later reject the request (e.g., because security is not
+         * enabled) that the REST infrastructure will not reject the request for not having consumed the body.
+         */
+        final Tuple<XContentType, BytesReference> content = request.contentOrSourceParam();
         final String username = getUsername(request);
         if (username == null) {
             return restChannel -> { throw new ElasticsearchSecurityException("there is no authenticated user"); };
         }
-        final Tuple<XContentType, BytesReference> content = request.contentOrSourceParam();
         HasPrivilegesRequestBuilder requestBuilder = new HasPrivilegesRequestBuilder(client).source(username, content.v2(), content.v1());
         return channel -> requestBuilder.execute(new RestBuilderListener<>(channel) {
             @Override
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/rest/action/user/RestHasPrivilegesActionTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/rest/action/user/RestHasPrivilegesActionTests.java
index 3cf985d9cdf9c..d0173479f37d6 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/rest/action/user/RestHasPrivilegesActionTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/rest/action/user/RestHasPrivilegesActionTests.java
@@ -6,9 +6,15 @@
 package org.elasticsearch.xpack.security.rest.action.user;
 
 import org.elasticsearch.client.node.NodeClient;
+import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.license.XPackLicenseState;
+import org.elasticsearch.rest.RestChannel;
 import org.elasticsearch.rest.RestController;
+import org.elasticsearch.rest.RestRequest;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.rest.FakeRestChannel;
@@ -23,17 +29,45 @@
 
 public class RestHasPrivilegesActionTests extends ESTestCase {
 
+    /*
+     * Previously we would reject requests that had a body that did not have a username set on the request. This happened because we did not
+     * consume the body until after checking if there was a username set on the request. If there was not a username set on the request,
+     * then the body would never be consumed. This means that the REST infrastructure would reject the request as not having a consumed body
+     * despite the endpoint supporting having a body. Now, we consume the body before checking if there is a username on the request. This
+     * test ensures that we maintain that behavior.
+     */
+    public void testBodyConsumed() throws Exception {
+        final XPackLicenseState licenseState = mock(XPackLicenseState.class);
+        final RestHasPrivilegesAction action =
+            new RestHasPrivilegesAction(Settings.EMPTY, mock(RestController.class), mock(SecurityContext.class), licenseState);
+        try (XContentBuilder bodyBuilder = JsonXContent.contentBuilder().startObject().endObject()) {
+            final RestRequest request = new FakeRestRequest.Builder(xContentRegistry())
+                .withPath("/_security/user/_has_privileges/")
+                .withContent(new BytesArray(bodyBuilder.toString()), XContentType.JSON)
+                .build();
+            final RestChannel channel = new FakeRestChannel(request, true, 1);
+            action.handleRequest(request, channel, mock(NodeClient.class));
+        }
+    }
+
     public void testBasicLicense() throws Exception {
         final XPackLicenseState licenseState = mock(XPackLicenseState.class);
         final RestHasPrivilegesAction action = new RestHasPrivilegesAction(Settings.EMPTY, mock(RestController.class),
             mock(SecurityContext.class), licenseState);
         when(licenseState.isSecurityAvailable()).thenReturn(false);
-        final FakeRestRequest request = new FakeRestRequest();
-        final FakeRestChannel channel = new FakeRestChannel(request, true, 1);
-        action.handleRequest(request, channel, mock(NodeClient.class));
-        assertThat(channel.capturedResponse(), notNullValue());
-        assertThat(channel.capturedResponse().status(), equalTo(RestStatus.FORBIDDEN));
-        assertThat(channel.capturedResponse().content().utf8ToString(), containsString("current license is non-compliant for [security]"));
+        try (XContentBuilder bodyBuilder = JsonXContent.contentBuilder().startObject().endObject()) {
+            final RestRequest request = new FakeRestRequest.Builder(xContentRegistry())
+                .withPath("/_security/user/_has_privileges/")
+                .withContent(new BytesArray(bodyBuilder.toString()), XContentType.JSON)
+                .build();
+            final FakeRestChannel channel = new FakeRestChannel(request, true, 1);
+            action.handleRequest(request, channel, mock(NodeClient.class));
+            assertThat(channel.capturedResponse(), notNullValue());
+            assertThat(channel.capturedResponse().status(), equalTo(RestStatus.FORBIDDEN));
+            assertThat(
+                channel.capturedResponse().content().utf8ToString(),
+                containsString("current license is non-compliant for [security]"));
+        }
     }
 
 }

From 36dccaaef0f48e5fb14376e45579c531b85dcd2c Mon Sep 17 00:00:00 2001
From: Kevin Woblick <mail@kovah.de>
Date: Wed, 18 Dec 2019 15:03:45 +0100
Subject: [PATCH 248/686] [DOCS]  Add warning about Docker port exposure
 (#50169)

Docker bypasses the Uncomplicated Firewall (UFW) on Linux by editing the `iptables` config directly, which leads to the exposure of port 9200, even if you blocked it via UFW.

This adds a warning along with work-arounds to the docs.

Signed-off-by: Kovah <mail@kovah.de>
---
 docs/reference/setup/install/docker.asciidoc | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/reference/setup/install/docker.asciidoc b/docs/reference/setup/install/docker.asciidoc
index add4792bd10af..537dec2904070 100644
--- a/docs/reference/setup/install/docker.asciidoc
+++ b/docs/reference/setup/install/docker.asciidoc
@@ -87,6 +87,12 @@ endif::[]
 This sample Docker Compose file brings up a three-node {es} cluster.
 Node `es01` listens on `localhost:9200` and `es02` and `es03` talk to `es01` over a Docker network.
 
+Please note that this configuration exposes port 9200 on all network interfaces, and given how 
+Docker manipulates `iptables` on Linux, this means that your {es} cluster is publically accessible, 
+potentially ignoring any firewall settings. If you don't want to expose port 9200 and instead use 
+a reverse proxy, replace `9200:9200` with `127.0.0.1:9200:9200` in the docker-compose.yml file.
+{es} will then only be accessible from the host machine itself.
+
 The  https://docs.docker.com/storage/volumes[Docker named volumes]
 `data01`, `data02`, and `data03` store the node data directories so the data persists across restarts.
 If they don't already exist, `docker-compose` creates them when you bring up the cluster.

From a456e593c24692b79af38df6c8b734659fa2a14f Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Wed, 18 Dec 2019 17:27:38 +0100
Subject: [PATCH 249/686] Add per-field metadata. (#49419)

This PR adds per-field metadata that can be set in the mappings and is later
returned by the field capabilities API. This metadata is completely opaque to
Elasticsearch but may be used by tools that index data in Elasticsearch to
communicate metadata about fields with tools that then search this data. A
typical example that has been requested in the past is the ability to attach
a unit to a numeric field.

In order to not bloat the cluster state, Elasticsearch requires that this
metadata be small:
 - keys can't be longer than 20 chars,
 - values can only be numbers or strings of no more than 50 chars - no inner
   arrays or objects,
 - the metadata can't have more than 5 keys in total.

Given that metadata is opaque to Elasticsearch, field capabilities don't try to
do anything smart when merging metadata about multiple indices, the union of
all field metadatas is returned.

Here is how the meta might look like in mappings:

```json
{
  "properties": {
    "latency": {
      "type": "long",
      "meta": {
        "unit": "ms"
      }
    }
  }
}
```

And then in the field capabilities response:

```json
{
  "latency": {
    "long": {
      "searchable": true,
      "aggreggatable": true,
      "meta": {
        "unit": [ "ms" ]
      }
    }
  }
}
```

When there are no conflicts, values are arrays of size 1, but when there are
conflicts, Elasticsearch includes all unique values in this array, without
giving ways to know which index has which metadata value:

```json
{
  "latency": {
    "long": {
      "searchable": true,
      "aggreggatable": true,
      "meta": {
        "unit": [ "ms", "ns" ]
      }
    }
  }
}
```

Closes #33267
---
 .../org/elasticsearch/client/SearchIT.java    |  6 +-
 docs/reference/mapping/params.asciidoc        | 17 ++--
 docs/reference/mapping/params/meta.asciidoc   | 31 ++++++
 docs/reference/mapping/types/boolean.asciidoc |  3 +
 docs/reference/mapping/types/date.asciidoc    |  4 +
 docs/reference/mapping/types/keyword.asciidoc |  4 +
 docs/reference/mapping/types/numeric.asciidoc |  4 +
 docs/reference/mapping/types/text.asciidoc    |  4 +
 docs/reference/search/field-caps.asciidoc     |  6 ++
 .../mapper/ScaledFloatFieldMapperTests.java   | 31 ++++++
 .../test/field_caps/10_basic.yml              |  1 -
 .../rest-api-spec/test/field_caps/20_meta.yml | 65 ++++++++++++
 .../test/indices.put_mapping/10_basic.yml     | 36 +++++++
 .../action/fieldcaps/FieldCapabilities.java   | 99 +++++++++++++++++--
 .../TransportFieldCapabilitiesAction.java     |  4 +-
 ...TransportFieldCapabilitiesIndexAction.java |  6 +-
 .../index/mapper/FieldMapper.java             | 11 +++
 .../index/mapper/MappedFieldType.java         | 24 ++++-
 .../index/mapper/TypeParsers.java             | 57 ++++++++++-
 .../fieldcaps/FieldCapabilitiesTests.java     | 75 ++++++++++++--
 .../MergedFieldCapabilitiesResponseTests.java |  6 +-
 .../index/mapper/BooleanFieldMapperTests.java | 28 ++++++
 .../index/mapper/DateFieldMapperTests.java    | 28 ++++++
 .../index/mapper/KeywordFieldMapperTests.java | 27 +++++
 .../index/mapper/TextFieldMapperTests.java    | 26 +++++
 .../index/mapper/TypeParsersTests.java        | 92 ++++++++++++++---
 .../search/fieldcaps/FieldCapabilitiesIT.java | 16 +--
 .../AbstractNumericFieldMapperTestCase.java   | 31 ++++++
 .../mapper/HistogramFieldMapper.java          |  2 +
 .../mapper/HistogramFieldMapperTests.java     | 30 ++++++
 .../ExtractedFieldsDetectorTests.java         |  2 +-
 .../analysis/index/IndexResolverTests.java    | 14 ++-
 32 files changed, 721 insertions(+), 69 deletions(-)
 create mode 100644 docs/reference/mapping/params/meta.asciidoc
 create mode 100644 rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/20_meta.yml

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/SearchIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/SearchIT.java
index 9df9623926fc5..1c260d6f91ef7 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/SearchIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/SearchIT.java
@@ -1229,11 +1229,11 @@ public void testFieldCaps() throws IOException {
         assertEquals(2, ratingResponse.size());
 
         FieldCapabilities expectedKeywordCapabilities = new FieldCapabilities(
-            "rating", "keyword", true, true, new String[]{"index2"}, null, null);
+            "rating", "keyword", true, true, new String[]{"index2"}, null, null, Collections.emptyMap());
         assertEquals(expectedKeywordCapabilities, ratingResponse.get("keyword"));
 
         FieldCapabilities expectedLongCapabilities = new FieldCapabilities(
-            "rating", "long", true, true, new String[]{"index1"}, null, null);
+            "rating", "long", true, true, new String[]{"index1"}, null, null, Collections.emptyMap());
         assertEquals(expectedLongCapabilities, ratingResponse.get("long"));
 
         // Check the capabilities for the 'field' field.
@@ -1242,7 +1242,7 @@ public void testFieldCaps() throws IOException {
         assertEquals(1, fieldResponse.size());
 
         FieldCapabilities expectedTextCapabilities = new FieldCapabilities(
-            "field", "text", true, false);
+            "field", "text", true, false, Collections.emptyMap());
         assertEquals(expectedTextCapabilities, fieldResponse.get("text"));
     }
 
diff --git a/docs/reference/mapping/params.asciidoc b/docs/reference/mapping/params.asciidoc
index 51421afb4942e..f4a65aa111df1 100644
--- a/docs/reference/mapping/params.asciidoc
+++ b/docs/reference/mapping/params.asciidoc
@@ -8,15 +8,15 @@ parameters that are used by <<mapping-types,field mappings>>:
 The following mapping parameters are common to some or all field datatypes:
 
 * <<analyzer,`analyzer`>>
-* <<normalizer, `normalizer`>>
 * <<mapping-boost,`boost`>>
 * <<coerce,`coerce`>>
 * <<copy-to,`copy_to`>>
 * <<doc-values,`doc_values`>>
 * <<dynamic,`dynamic`>>
+* <<eager-global-ordinals,`eager_global_ordinals`>>
 * <<enabled,`enabled`>>
 * <<fielddata,`fielddata`>>
-* <<eager-global-ordinals,`eager_global_ordinals`>>
+* <<multi-fields,`fields`>>
 * <<mapping-date-format,`format`>>
 * <<ignore-above,`ignore_above`>>
 * <<ignore-malformed,`ignore_malformed`>>
@@ -24,7 +24,8 @@ The following mapping parameters are common to some or all field datatypes:
 * <<index-phrases,`index_phrases`>>
 * <<index-prefixes,`index_prefixes`>>
 * <<mapping-index,`index`>>
-* <<multi-fields,`fields`>>
+* <<mapping-field-meta,`meta`>>
+* <<normalizer, `normalizer`>>
 * <<norms,`norms`>>
 * <<null-value,`null_value`>>
 * <<position-increment-gap,`position_increment_gap`>>
@@ -37,8 +38,6 @@ The following mapping parameters are common to some or all field datatypes:
 
 include::params/analyzer.asciidoc[]
 
-include::params/normalizer.asciidoc[]
-
 include::params/boost.asciidoc[]
 
 include::params/coerce.asciidoc[]
@@ -49,10 +48,10 @@ include::params/doc-values.asciidoc[]
 
 include::params/dynamic.asciidoc[]
 
-include::params/enabled.asciidoc[]
-
 include::params/eager-global-ordinals.asciidoc[]
 
+include::params/enabled.asciidoc[]
+
 include::params/fielddata.asciidoc[]
 
 include::params/format.asciidoc[]
@@ -69,8 +68,12 @@ include::params/index-phrases.asciidoc[]
 
 include::params/index-prefixes.asciidoc[]
 
+include::params/meta.asciidoc[]
+
 include::params/multi-fields.asciidoc[]
 
+include::params/normalizer.asciidoc[]
+
 include::params/norms.asciidoc[]
 
 include::params/null-value.asciidoc[]
diff --git a/docs/reference/mapping/params/meta.asciidoc b/docs/reference/mapping/params/meta.asciidoc
new file mode 100644
index 0000000000000..52d3ca7ff7cce
--- /dev/null
+++ b/docs/reference/mapping/params/meta.asciidoc
@@ -0,0 +1,31 @@
+[[mapping-field-meta]]
+=== `meta`
+
+Metadata attached to the field. This metadata is opaque to Elasticsearch, it is
+only useful for multiple applications that work on the same indices to share
+meta information about fields such as units
+
+[source,console]
+------------
+PUT my_index
+{
+  "mappings": {
+    "properties": {
+      "latency": {
+        "type": "long",
+        "meta": {
+          "unit": "ms"
+        }
+      }
+    }
+  }
+}
+------------
+// TEST
+
+NOTE: Field metadata enforces at most 5 entries, that keys have a length that
+is less than or equal to 20, and that values are strings whose length is less
+than or equal to 50.
+
+NOTE: Field metadata is updatable by submitting a mapping update. The metadata
+of the update will override the metadata of the existing field.
diff --git a/docs/reference/mapping/types/boolean.asciidoc b/docs/reference/mapping/types/boolean.asciidoc
index 116459d0660e4..ab8011a4c56e4 100644
--- a/docs/reference/mapping/types/boolean.asciidoc
+++ b/docs/reference/mapping/types/boolean.asciidoc
@@ -120,3 +120,6 @@ The following parameters are accepted by `boolean` fields:
     the <<mapping-source-field,`_source`>> field. Accepts `true` or `false`
     (default).
 
+<<mapping-field-meta,`meta`>>::
+
+    Metadata about the field.
diff --git a/docs/reference/mapping/types/date.asciidoc b/docs/reference/mapping/types/date.asciidoc
index 43ede27831b6a..4a9474dcfebf1 100644
--- a/docs/reference/mapping/types/date.asciidoc
+++ b/docs/reference/mapping/types/date.asciidoc
@@ -137,3 +137,7 @@ The following parameters are accepted by `date` fields:
     Whether the field value should be stored and retrievable separately from
     the <<mapping-source-field,`_source`>> field. Accepts `true` or `false`
     (default).
+
+<<mapping-field-meta,`meta`>>::
+
+    Metadata about the field.
diff --git a/docs/reference/mapping/types/keyword.asciidoc b/docs/reference/mapping/types/keyword.asciidoc
index 71419b378faae..e0ee14f99b0d0 100644
--- a/docs/reference/mapping/types/keyword.asciidoc
+++ b/docs/reference/mapping/types/keyword.asciidoc
@@ -115,6 +115,10 @@ The following parameters are accepted by `keyword` fields:
     when building a query for this field.
     Accepts `true` or `false` (default).
 
+<<mapping-field-meta,`meta`>>::
+
+    Metadata about the field.
+
 NOTE: Indexes imported from 2.x do not support `keyword`. Instead they will
 attempt to downgrade `keyword` into `string`. This allows you to merge modern
 mappings with legacy mappings. Long lived indexes will have to be recreated
diff --git a/docs/reference/mapping/types/numeric.asciidoc b/docs/reference/mapping/types/numeric.asciidoc
index 8280945b22777..e99869c7fe275 100644
--- a/docs/reference/mapping/types/numeric.asciidoc
+++ b/docs/reference/mapping/types/numeric.asciidoc
@@ -149,6 +149,10 @@ The following parameters are accepted by numeric types:
     the <<mapping-source-field,`_source`>> field. Accepts `true` or `false`
     (default).
 
+<<mapping-field-meta,`meta`>>::
+
+    Metadata about the field.
+
 [[scaled-float-params]]
 ==== Parameters for `scaled_float`
 
diff --git a/docs/reference/mapping/types/text.asciidoc b/docs/reference/mapping/types/text.asciidoc
index 434d91fd4ec6a..f3bbb257fb85a 100644
--- a/docs/reference/mapping/types/text.asciidoc
+++ b/docs/reference/mapping/types/text.asciidoc
@@ -143,3 +143,7 @@ The following parameters are accepted by `text` fields:
 
     Whether term vectors should be stored for an <<mapping-index,`analyzed`>>
     field. Defaults to `no`.
+
+<<mapping-field-meta,`meta`>>::
+
+    Metadata about the field.
diff --git a/docs/reference/search/field-caps.asciidoc b/docs/reference/search/field-caps.asciidoc
index f94ac492d7814..c6b945c055bf6 100644
--- a/docs/reference/search/field-caps.asciidoc
+++ b/docs/reference/search/field-caps.asciidoc
@@ -78,6 +78,12 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
   The list of indices where this field is not aggregatable, or null if all 
   indices have the same definition for the field.
 
+`meta`::
+  Merged metadata across all indices as a map of string keys to arrays of values.
+  A value length of 1 indicates that all indices had the same value for this key,
+  while a length of 2 or more indicates that not all indices had the same value
+  for this key.
+
 
 [[search-field-caps-api-example]]
 ==== {api-examples-title}
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
index 54236c61b76dc..94ae0cee76bb7 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexService;
+import org.elasticsearch.index.mapper.MapperService.MergeReason;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.test.InternalSettingsPlugin;
@@ -35,6 +36,7 @@
 import java.io.IOException;
 import java.util.Arrays;
 import java.util.Collection;
+import java.util.Collections;
 import java.util.List;
 
 import static org.hamcrest.Matchers.containsString;
@@ -353,4 +355,33 @@ public void testRejectIndexOptions() throws IOException {
         MapperParsingException e = expectThrows(MapperParsingException.class, () -> parser.parse("type", new CompressedXContent(mapping)));
         assertThat(e.getMessage(), containsString("index_options not allowed in field [foo] of type [scaled_float]"));
     }
+
+    public void testMeta() throws Exception {
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "scaled_float")
+                .field("meta", Collections.singletonMap("foo", "bar"))
+                .field("scaling_factor", 10.0)
+                .endObject().endObject().endObject().endObject());
+
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping, mapper.mappingSource().toString());
+
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "scaled_float")
+                .field("scaling_factor", 10.0)
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping2, mapper.mappingSource().toString());
+
+        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "scaled_float")
+                .field("meta", Collections.singletonMap("baz", "quux"))
+                .field("scaling_factor", 10.0)
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping3, mapper.mappingSource().toString());
+    }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/10_basic.yml
index 137512fe432bd..fcc1ba8104c9d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/10_basic.yml
@@ -317,4 +317,3 @@ setup:
   - match: {fields.misc.unmapped.searchable:            false}
   - match: {fields.misc.unmapped.aggregatable:          false}
   - match: {fields.misc.unmapped.indices:               ["test2", "test3"]}
-
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/20_meta.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/20_meta.yml
new file mode 100644
index 0000000000000..c2d565278717a
--- /dev/null
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/20_meta.yml
@@ -0,0 +1,65 @@
+---
+"Merge metadata across multiple indices":
+
+  - skip:
+      version: " - 7.99.99"
+      reason: Metadata support was added in 7.6
+
+  - do:
+        indices.create:
+          index: test1
+          body:
+              mappings:
+                properties:
+                  latency:
+                    type: long
+                    meta:
+                      unit: ms
+                      metric_type: gauge
+
+  - do:
+        indices.create:
+          index: test2
+          body:
+              mappings:
+                properties:
+                  latency:
+                    type: long
+                    meta:
+                      unit: ns
+                      metric_type: gauge
+
+  - do:
+        indices.create:
+          index: test3
+
+  - do:
+      field_caps:
+        index: test3
+        fields: [latency]
+
+  - is_false: fields.latency.long.meta.unit
+
+  - do:
+      field_caps:
+        index: test1
+        fields: [latency]
+
+  - match: {fields.latency.long.meta.unit:              ["ms"]}
+  - match: {fields.latency.long.meta.metric_type:       ["gauge"]}
+
+  - do:
+      field_caps:
+        index: test1,test3
+        fields: [latency]
+
+  - match: {fields.latency.long.meta.unit:              ["ms"]}
+  - match: {fields.latency.long.meta.metric_type:       ["gauge"]}
+
+  - do:
+      field_caps:
+        index: test1,test2,test3
+        fields: [latency]
+
+  - match: {fields.latency.long.meta.unit:              ["ms", "ns"]}
+  - match: {fields.latency.long.meta.metric_type:       ["gauge"]}
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.put_mapping/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.put_mapping/10_basic.yml
index 4b228ac0ecdb0..3a4044c8d71ad 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.put_mapping/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.put_mapping/10_basic.yml
@@ -108,3 +108,39 @@
 
   - match: { error.type: "illegal_argument_exception" }
   - match: { error.reason: "Types cannot be provided in put mapping requests, unless the include_type_name parameter is set to true." }
+
+---
+"Update per-field metadata":
+
+  - skip:
+      version:     " - 7.99.99"
+      reason:      "Per-field meta was introduced in 7.6"
+
+  - do:
+      indices.create:
+        index: test_index
+        body:
+          mappings:
+            properties:
+              foo:
+                type: keyword
+                meta:
+                  bar: baz
+
+  - do:
+      indices.put_mapping:
+        index: test_index
+        body:
+          properties:
+            foo:
+              type: keyword
+              meta:
+                baz: quux
+
+  - do:
+      indices.get_mapping:
+        index: test_index
+
+  - is_false: test_index.mappings.properties.foo.meta.bar
+  - match: { test_index.mappings.properties.foo.meta.baz: "quux" }
+
diff --git a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
index 20f525716a218..15598a2a88a5c 100644
--- a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
+++ b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.action.fieldcaps;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -34,20 +35,33 @@
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.Comparator;
+import java.util.HashMap;
+import java.util.HashSet;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
+import java.util.Set;
+import java.util.function.Function;
 import java.util.stream.Collectors;
 
 /**
  * Describes the capabilities of a field optionally merged across multiple indices.
  */
 public class FieldCapabilities implements Writeable, ToXContentObject {
+
     private static final ParseField TYPE_FIELD = new ParseField("type");
     private static final ParseField SEARCHABLE_FIELD = new ParseField("searchable");
     private static final ParseField AGGREGATABLE_FIELD = new ParseField("aggregatable");
     private static final ParseField INDICES_FIELD = new ParseField("indices");
     private static final ParseField NON_SEARCHABLE_INDICES_FIELD = new ParseField("non_searchable_indices");
     private static final ParseField NON_AGGREGATABLE_INDICES_FIELD = new ParseField("non_aggregatable_indices");
+    private static final ParseField META_FIELD = new ParseField("meta");
+
+    private static Map<String, Set<String>> mapToMapOfSets(Map<String, String> map) {
+        final Function<Map.Entry<String, String>, String> entryValueFunction = Map.Entry::getValue;
+        return map.entrySet().stream().collect(
+                Collectors.toUnmodifiableMap(Map.Entry::getKey, entryValueFunction.andThen(Set::of)));
+    }
 
     private final String name;
     private final String type;
@@ -58,19 +72,23 @@ public class FieldCapabilities implements Writeable, ToXContentObject {
     private final String[] nonSearchableIndices;
     private final String[] nonAggregatableIndices;
 
+    private final Map<String, Set<String>> meta;
+
     /**
-     * Constructor
+     * Constructor for a single index.
      * @param name The name of the field.
      * @param type The type associated with the field.
      * @param isSearchable Whether this field is indexed for search.
      * @param isAggregatable Whether this field can be aggregated on.
+     * @param meta Metadata about the field.
      */
-    public FieldCapabilities(String name, String type, boolean isSearchable, boolean isAggregatable) {
-        this(name, type, isSearchable, isAggregatable, null, null, null);
+    public FieldCapabilities(String name, String type, boolean isSearchable, boolean isAggregatable,
+            Map<String, String> meta) {
+        this(name, type, isSearchable, isAggregatable, null, null, null, mapToMapOfSets(Objects.requireNonNull(meta)));
     }
 
     /**
-     * Constructor
+     * Constructor for a set of indices.
      * @param name The name of the field
      * @param type The type associated with the field.
      * @param isSearchable Whether this field is indexed for search.
@@ -81,12 +99,14 @@ public FieldCapabilities(String name, String type, boolean isSearchable, boolean
      *                             or null if the field is searchable in all indices.
      * @param nonAggregatableIndices The list of indices where this field is not aggregatable,
      *                               or null if the field is aggregatable in all indices.
+     * @param meta Merged metadata across indices.
      */
     public FieldCapabilities(String name, String type,
                       boolean isSearchable, boolean isAggregatable,
                       String[] indices,
                       String[] nonSearchableIndices,
-                      String[] nonAggregatableIndices) {
+                      String[] nonAggregatableIndices,
+                      Map<String, Set<String>> meta) {
         this.name = name;
         this.type = type;
         this.isSearchable = isSearchable;
@@ -94,6 +114,7 @@ public FieldCapabilities(String name, String type,
         this.indices = indices;
         this.nonSearchableIndices = nonSearchableIndices;
         this.nonAggregatableIndices = nonAggregatableIndices;
+        this.meta = Objects.requireNonNull(meta);
     }
 
     public FieldCapabilities(StreamInput in) throws IOException {
@@ -104,6 +125,11 @@ public FieldCapabilities(StreamInput in) throws IOException {
         this.indices = in.readOptionalStringArray();
         this.nonSearchableIndices = in.readOptionalStringArray();
         this.nonAggregatableIndices = in.readOptionalStringArray();
+        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            meta = in.readMap(StreamInput::readString, i -> i.readSet(StreamInput::readString));
+        } else {
+            meta = Collections.emptyMap();
+        }
     }
 
     @Override
@@ -115,6 +141,9 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeOptionalStringArray(indices);
         out.writeOptionalStringArray(nonSearchableIndices);
         out.writeOptionalStringArray(nonAggregatableIndices);
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            out.writeMap(meta, StreamOutput::writeString, (o, set) -> o.writeCollection(set, StreamOutput::writeString));
+        }
     }
 
     @Override
@@ -132,6 +161,17 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (nonAggregatableIndices != null) {
             builder.field(NON_AGGREGATABLE_INDICES_FIELD.getPreferredName(), nonAggregatableIndices);
         }
+        if (meta.isEmpty() == false) {
+            builder.startObject("meta");
+            List<Map.Entry<String, Set<String>>> entries = new ArrayList<>(meta.entrySet());
+            entries.sort(Comparator.comparing(Map.Entry::getKey)); // provide predictable order
+            for (Map.Entry<String, Set<String>> entry : entries) {
+                List<String> values = new ArrayList<>(entry.getValue());
+                values.sort(String::compareTo); // provide predictable order
+                builder.field(entry.getKey(), values);
+            }
+            builder.endObject();
+        }
         builder.endObject();
         return builder;
     }
@@ -150,7 +190,8 @@ public static FieldCapabilities fromXContent(String name, XContentParser parser)
             (boolean) a[2],
             a[3] != null ? ((List<String>) a[3]).toArray(new String[0]) : null,
             a[4] != null ? ((List<String>) a[4]).toArray(new String[0]) : null,
-            a[5] != null ? ((List<String>) a[5]).toArray(new String[0]) : null));
+            a[5] != null ? ((List<String>) a[5]).toArray(new String[0]) : null,
+            a[6] != null ? ((Map<String, Set<String>>) a[6]) : Collections.emptyMap()));
 
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), TYPE_FIELD);
@@ -159,6 +200,8 @@ public static FieldCapabilities fromXContent(String name, XContentParser parser)
         PARSER.declareStringArray(ConstructingObjectParser.optionalConstructorArg(), INDICES_FIELD);
         PARSER.declareStringArray(ConstructingObjectParser.optionalConstructorArg(), NON_SEARCHABLE_INDICES_FIELD);
         PARSER.declareStringArray(ConstructingObjectParser.optionalConstructorArg(), NON_AGGREGATABLE_INDICES_FIELD);
+        PARSER.declareObject(ConstructingObjectParser.optionalConstructorArg(),
+                (parser, context) -> parser.map(HashMap::new, p -> Set.copyOf(p.list())), META_FIELD);
     }
 
     /**
@@ -213,6 +256,13 @@ public String[] nonAggregatableIndices() {
         return nonAggregatableIndices;
     }
 
+    /**
+     * Return merged metadata across indices.
+     */
+    public Map<String, Set<String>> meta() {
+        return meta;
+    }
+
     @Override
     public boolean equals(Object o) {
         if (this == o) return true;
@@ -224,12 +274,13 @@ public boolean equals(Object o) {
             Objects.equals(type, that.type) &&
             Arrays.equals(indices, that.indices) &&
             Arrays.equals(nonSearchableIndices, that.nonSearchableIndices) &&
-            Arrays.equals(nonAggregatableIndices, that.nonAggregatableIndices);
+            Arrays.equals(nonAggregatableIndices, that.nonAggregatableIndices) &&
+            Objects.equals(meta, that.meta);
     }
 
     @Override
     public int hashCode() {
-        int result = Objects.hash(name, type, isSearchable, isAggregatable);
+        int result = Objects.hash(name, type, isSearchable, isAggregatable, meta);
         result = 31 * result + Arrays.hashCode(indices);
         result = 31 * result + Arrays.hashCode(nonSearchableIndices);
         result = 31 * result + Arrays.hashCode(nonAggregatableIndices);
@@ -247,6 +298,7 @@ static class Builder {
         private boolean isSearchable;
         private boolean isAggregatable;
         private List<IndexCaps> indiceList;
+        private Map<String, Set<String>> meta;
 
         Builder(String name, String type) {
             this.name = name;
@@ -254,15 +306,38 @@ static class Builder {
             this.isSearchable = true;
             this.isAggregatable = true;
             this.indiceList = new ArrayList<>();
+            this.meta = new HashMap<>();
         }
 
-        void add(String index, boolean search, boolean agg) {
+        private void add(String index, boolean search, boolean agg) {
             IndexCaps indexCaps = new IndexCaps(index, search, agg);
             indiceList.add(indexCaps);
             this.isSearchable &= search;
             this.isAggregatable &= agg;
         }
 
+        /**
+         * Collect capabilities of an index.
+         */
+        void add(String index, boolean search, boolean agg, Map<String, String> meta) {
+            add(index, search, agg);
+            for (Map.Entry<String, String> entry : meta.entrySet()) {
+                this.meta.computeIfAbsent(entry.getKey(), key -> new HashSet<>())
+                        .add(entry.getValue());
+            }
+        }
+
+        /**
+         * Merge another capabilities instance.
+         */
+        void merge(String index, boolean search, boolean agg, Map<String, Set<String>> meta) {
+            add(index, search, agg);
+            for (Map.Entry<String, Set<String>> entry : meta.entrySet()) {
+                this.meta.computeIfAbsent(entry.getKey(), key -> new HashSet<>())
+                        .addAll(entry.getValue());
+            }
+        }
+
         List<String> getIndices() {
             return indiceList.stream().map(c -> c.name).collect(Collectors.toList());
         }
@@ -305,8 +380,12 @@ FieldCapabilities build(boolean withIndices) {
             } else {
                 nonAggregatableIndices = null;
             }
+            final Function<Map.Entry<String, Set<String>>, Set<String>> entryValueFunction = Map.Entry::getValue;
+            Map<String, Set<String>> immutableMeta = meta.entrySet().stream()
+                    .collect(Collectors.toUnmodifiableMap(
+                            Map.Entry::getKey, entryValueFunction.andThen(Set::copyOf)));
             return new FieldCapabilities(name, type, isSearchable, isAggregatable,
-                indices, nonSearchableIndices, nonAggregatableIndices);
+                indices, nonSearchableIndices, nonAggregatableIndices, immutableMeta);
         }
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/fieldcaps/TransportFieldCapabilitiesAction.java b/server/src/main/java/org/elasticsearch/action/fieldcaps/TransportFieldCapabilitiesAction.java
index 3176d0d31390b..2ddec2c8378c6 100644
--- a/server/src/main/java/org/elasticsearch/action/fieldcaps/TransportFieldCapabilitiesAction.java
+++ b/server/src/main/java/org/elasticsearch/action/fieldcaps/TransportFieldCapabilitiesAction.java
@@ -176,7 +176,7 @@ private void addUnmappedFields(String[] indices, String field, Map<String, Field
             FieldCapabilities.Builder unmapped = new FieldCapabilities.Builder(field, "unmapped");
             typeMap.put("unmapped", unmapped);
             for (String index : unmappedIndices) {
-                unmapped.add(index, false, false);
+                unmapped.add(index, false, false, Collections.emptyMap());
             }
         }
     }
@@ -189,7 +189,7 @@ private void innerMerge(Map<String, Map<String, FieldCapabilities.Builder>> resp
             Map<String, FieldCapabilities.Builder> typeMap = responseMapBuilder.computeIfAbsent(field, f -> new HashMap<>());
             FieldCapabilities.Builder builder = typeMap.computeIfAbsent(fieldCap.getType(),
                 key -> new FieldCapabilities.Builder(field, key));
-            builder.add(indexName, fieldCap.isSearchable(), fieldCap.isAggregatable());
+            builder.merge(indexName, fieldCap.isSearchable(), fieldCap.isAggregatable(), fieldCap.meta());
         }
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/action/fieldcaps/TransportFieldCapabilitiesIndexAction.java b/server/src/main/java/org/elasticsearch/action/fieldcaps/TransportFieldCapabilitiesIndexAction.java
index f391bf82eb944..9b482f60a150c 100644
--- a/server/src/main/java/org/elasticsearch/action/fieldcaps/TransportFieldCapabilitiesIndexAction.java
+++ b/server/src/main/java/org/elasticsearch/action/fieldcaps/TransportFieldCapabilitiesIndexAction.java
@@ -38,6 +38,7 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
 
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Map;
@@ -89,7 +90,8 @@ protected FieldCapabilitiesIndexResponse shardOperation(final FieldCapabilitiesI
             if (ft != null) {
                 if (indicesService.isMetaDataField(mapperService.getIndexSettings().getIndexVersionCreated(), field)
                         || fieldPredicate.test(ft.name())) {
-                    FieldCapabilities fieldCap = new FieldCapabilities(field, ft.typeName(), ft.isSearchable(), ft.isAggregatable());
+                    FieldCapabilities fieldCap = new FieldCapabilities(field, ft.typeName(), ft.isSearchable(), ft.isAggregatable(),
+                            ft.meta());
                     responseMap.put(field, fieldCap);
                 } else {
                     continue;
@@ -107,7 +109,7 @@ protected FieldCapabilitiesIndexResponse shardOperation(final FieldCapabilitiesI
                         // no field type, it must be an object field
                         ObjectMapper mapper = mapperService.getObjectMapper(parentField);
                         String type = mapper.nested().isNested() ? "nested" : "object";
-                        FieldCapabilities fieldCap = new FieldCapabilities(parentField, type, false, false);
+                        FieldCapabilities fieldCap = new FieldCapabilities(parentField, type, false, false, Collections.emptyMap());
                         responseMap.put(parentField, fieldCap);
                     }
                     dotIndex = parentField.lastIndexOf('.');
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/FieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/FieldMapper.java
index 23753b881f20c..57e71ee25ae42 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/FieldMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/FieldMapper.java
@@ -50,6 +50,7 @@
 import java.util.Map;
 import java.util.HashMap;
 import java.util.Objects;
+import java.util.TreeMap;
 import java.util.stream.StreamSupport;
 
 public abstract class FieldMapper extends Mapper implements Cloneable {
@@ -223,6 +224,12 @@ protected void setupFieldType(BuilderContext context) {
                 fieldType.setHasDocValues(defaultDocValues);
             }
         }
+
+        /** Set metadata on this field. */
+        public T meta(Map<String, String> meta) {
+            fieldType.setMeta(meta);
+            return (T) this;
+        }
     }
 
     protected final Version indexCreatedVersion;
@@ -427,6 +434,10 @@ protected void doXContentBody(XContentBuilder builder, boolean includeDefaults,
 
         multiFields.toXContent(builder, params);
         copyTo.toXContent(builder, params);
+
+        if (includeDefaults || fieldType().meta().isEmpty() == false) {
+            builder.field("meta", new TreeMap<>(fieldType().meta())); // ensure consistent order
+        }
     }
 
     protected final void doXContentAnalyzers(XContentBuilder builder, boolean includeDefaults) throws IOException {
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/MappedFieldType.java b/server/src/main/java/org/elasticsearch/index/mapper/MappedFieldType.java
index 82a0239777e30..86dad273e71b0 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/MappedFieldType.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/MappedFieldType.java
@@ -53,7 +53,9 @@
 
 import java.io.IOException;
 import java.time.ZoneId;
+import java.util.Collections;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
 
 /**
@@ -72,6 +74,7 @@ public abstract class MappedFieldType extends FieldType {
     private Object nullValue;
     private String nullValueAsString; // for sending null value to _all field
     private boolean eagerGlobalOrdinals;
+    private Map<String, String> meta;
 
     protected MappedFieldType(MappedFieldType ref) {
         super(ref);
@@ -85,6 +88,7 @@ protected MappedFieldType(MappedFieldType ref) {
         this.nullValue = ref.nullValue();
         this.nullValueAsString = ref.nullValueAsString();
         this.eagerGlobalOrdinals = ref.eagerGlobalOrdinals;
+        this.meta = ref.meta;
     }
 
     public MappedFieldType() {
@@ -94,6 +98,7 @@ public MappedFieldType() {
         setOmitNorms(false);
         setIndexOptions(IndexOptions.DOCS_AND_FREQS_AND_POSITIONS);
         setBoost(1.0f);
+        meta = Collections.emptyMap();
     }
 
     @Override
@@ -126,13 +131,14 @@ public boolean equals(Object o) {
             Objects.equals(eagerGlobalOrdinals, fieldType.eagerGlobalOrdinals) &&
             Objects.equals(nullValue, fieldType.nullValue) &&
             Objects.equals(nullValueAsString, fieldType.nullValueAsString) &&
-            Objects.equals(similarity, fieldType.similarity);
+            Objects.equals(similarity, fieldType.similarity) &&
+            Objects.equals(meta, fieldType.meta);
     }
 
     @Override
     public int hashCode() {
         return Objects.hash(super.hashCode(), name, boost, docValues, indexAnalyzer, searchAnalyzer, searchQuoteAnalyzer,
-            eagerGlobalOrdinals, similarity == null ? null : similarity.name(), nullValue, nullValueAsString);
+            eagerGlobalOrdinals, similarity == null ? null : similarity.name(), nullValue, nullValueAsString, meta);
     }
 
     // TODO: we need to override freeze() and add safety checks that all settings are actually set
@@ -490,4 +496,18 @@ public static Term extractTerm(Query termQuery) {
         return ((TermQuery) termQuery).getTerm();
     }
 
+    /**
+     * Get the metadata associated with this field.
+     */
+    public Map<String, String> meta() {
+        return meta;
+    }
+
+    /**
+     * Associate metadata with this field.
+     */
+    public void setMeta(Map<String, String> meta) {
+        checkIfFrozen();
+        this.meta = Map.copyOf(Objects.requireNonNull(meta));
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/TypeParsers.java b/server/src/main/java/org/elasticsearch/index/mapper/TypeParsers.java
index cabadedcd7f20..4c2fdbdd73725 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/TypeParsers.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/TypeParsers.java
@@ -34,6 +34,8 @@
 import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
+import java.util.function.Function;
+import java.util.stream.Collectors;
 
 import static org.elasticsearch.common.xcontent.support.XContentMapValues.isArray;
 import static org.elasticsearch.common.xcontent.support.XContentMapValues.nodeFloatValue;
@@ -144,7 +146,7 @@ private static void parseAnalyzersAndTermVectors(FieldMapper.Builder builder, St
         }
     }
 
-    public static void parseNorms(FieldMapper.Builder builder, String fieldName, Object propNode) {
+    public static void parseNorms(FieldMapper.Builder<?,?> builder, String fieldName, Object propNode) {
         builder.omitNorms(XContentMapValues.nodeBooleanValue(propNode, fieldName + ".norms") == false);
     }
 
@@ -152,8 +154,7 @@ public static void parseNorms(FieldMapper.Builder builder, String fieldName, Obj
      * Parse text field attributes. In addition to {@link #parseField common attributes}
      * this will parse analysis and term-vectors related settings.
      */
-    @SuppressWarnings("unchecked")
-    public static void parseTextField(FieldMapper.Builder builder, String name, Map<String, Object> fieldNode,
+    public static void parseTextField(FieldMapper.Builder<?,?> builder, String name, Map<String, Object> fieldNode,
                                       Mapper.TypeParser.ParserContext parserContext) {
         parseField(builder, name, fieldNode, parserContext);
         parseAnalyzersAndTermVectors(builder, name, fieldNode, parserContext);
@@ -168,12 +169,58 @@ public static void parseTextField(FieldMapper.Builder builder, String name, Map<
         }
     }
 
+    /**
+     * Parse the {@code meta} key of the mapping.
+     */
+    public static void parseMeta(FieldMapper.Builder<?,?> builder, String name, Map<String, Object> fieldNode) {
+        Object metaObject = fieldNode.remove("meta");
+        if (metaObject == null) {
+            // no meta
+            return;
+        }
+        if (metaObject instanceof Map == false) {
+            throw new MapperParsingException("[meta] must be an object, got " + metaObject.getClass().getSimpleName() +
+                    "[" + metaObject + "] for field [" + name +"]");
+        }
+        @SuppressWarnings("unchecked")
+        Map<String, ?> meta = (Map<String, ?>) metaObject;
+        if (meta.size() > 5) {
+            throw new MapperParsingException("[meta] can't have more than 5 entries, but got " + meta.size() + " on field [" +
+                    name + "]");
+        }
+        for (String key : meta.keySet()) {
+            if (key.codePointCount(0, key.length()) > 20) {
+                throw new MapperParsingException("[meta] keys can't be longer than 20 chars, but got [" + key +
+                        "] for field [" + name + "]");
+            }
+        }
+        for (Object value : meta.values()) {
+            if (value instanceof String) {
+                String sValue = (String) value;
+                if (sValue.codePointCount(0, sValue.length()) > 50) {
+                    throw new MapperParsingException("[meta] values can't be longer than 50 chars, but got [" + value +
+                            "] for field [" + name + "]");
+                }
+            } else if (value == null) {
+                throw new MapperParsingException("[meta] values can't be null (field [" + name + "])");
+            } else {
+                throw new MapperParsingException("[meta] values can only be strings, but got " +
+                        value.getClass().getSimpleName() + "[" + value + "] for field [" + name + "]");
+            }
+        }
+        final Function<Map.Entry<String, ?>, Object> entryValueFunction = Map.Entry::getValue;
+        final Function<Object, String> stringCast = String.class::cast;
+        Map<String, String> checkedMeta = meta.entrySet().stream()
+                .collect(Collectors.toUnmodifiableMap(Map.Entry::getKey, entryValueFunction.andThen(stringCast)));
+        builder.meta(checkedMeta);
+    }
+
     /**
      * Parse common field attributes such as {@code doc_values} or {@code store}.
      */
-    @SuppressWarnings("rawtypes")
-    public static void parseField(FieldMapper.Builder builder, String name, Map<String, Object> fieldNode,
+    public static void parseField(FieldMapper.Builder<?,?> builder, String name, Map<String, Object> fieldNode,
                                   Mapper.TypeParser.ParserContext parserContext) {
+        parseMeta(builder, name, fieldNode);
         for (Iterator<Map.Entry<String, Object>> iterator = fieldNode.entrySet().iterator(); iterator.hasNext();) {
             Map.Entry<String, Object> entry = iterator.next();
             final String propName = entry.getKey();
diff --git a/server/src/test/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesTests.java b/server/src/test/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesTests.java
index deeae3351ec96..6776d66c9df72 100644
--- a/server/src/test/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesTests.java
+++ b/server/src/test/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesTests.java
@@ -25,6 +25,9 @@
 
 import java.io.IOException;
 import java.util.Arrays;
+import java.util.Collections;
+import java.util.Map;
+import java.util.Set;
 
 import static org.hamcrest.Matchers.equalTo;
 
@@ -48,9 +51,9 @@ protected Writeable.Reader<FieldCapabilities> instanceReader() {
 
     public void testBuilder() {
         FieldCapabilities.Builder builder = new FieldCapabilities.Builder("field", "type");
-        builder.add("index1", true, false);
-        builder.add("index2", true, false);
-        builder.add("index3", true, false);
+        builder.add("index1", true, false, Collections.emptyMap());
+        builder.add("index2", true, false, Collections.emptyMap());
+        builder.add("index3", true, false, Collections.emptyMap());
 
         {
             FieldCapabilities cap1 = builder.build(false);
@@ -59,6 +62,7 @@ public void testBuilder() {
             assertNull(cap1.indices());
             assertNull(cap1.nonSearchableIndices());
             assertNull(cap1.nonAggregatableIndices());
+            assertEquals(Collections.emptyMap(), cap1.meta());
 
             FieldCapabilities cap2 = builder.build(true);
             assertThat(cap2.isSearchable(), equalTo(true));
@@ -67,12 +71,13 @@ public void testBuilder() {
             assertThat(cap2.indices(), equalTo(new String[]{"index1", "index2", "index3"}));
             assertNull(cap2.nonSearchableIndices());
             assertNull(cap2.nonAggregatableIndices());
+            assertEquals(Collections.emptyMap(), cap2.meta());
         }
 
         builder = new FieldCapabilities.Builder("field", "type");
-        builder.add("index1", false, true);
-        builder.add("index2", true, false);
-        builder.add("index3", false, false);
+        builder.add("index1", false, true, Collections.emptyMap());
+        builder.add("index2", true, false, Collections.emptyMap());
+        builder.add("index3", false, false, Collections.emptyMap());
         {
             FieldCapabilities cap1 = builder.build(false);
             assertThat(cap1.isSearchable(), equalTo(false));
@@ -80,6 +85,7 @@ public void testBuilder() {
             assertNull(cap1.indices());
             assertThat(cap1.nonSearchableIndices(), equalTo(new String[]{"index1", "index3"}));
             assertThat(cap1.nonAggregatableIndices(), equalTo(new String[]{"index2", "index3"}));
+            assertEquals(Collections.emptyMap(), cap1.meta());
 
             FieldCapabilities cap2 = builder.build(true);
             assertThat(cap2.isSearchable(), equalTo(false));
@@ -88,6 +94,30 @@ public void testBuilder() {
             assertThat(cap2.indices(), equalTo(new String[]{"index1", "index2", "index3"}));
             assertThat(cap2.nonSearchableIndices(), equalTo(new String[]{"index1", "index3"}));
             assertThat(cap2.nonAggregatableIndices(), equalTo(new String[]{"index2", "index3"}));
+            assertEquals(Collections.emptyMap(), cap2.meta());
+        }
+
+        builder = new FieldCapabilities.Builder("field", "type");
+        builder.add("index1", true, true, Collections.emptyMap());
+        builder.add("index2", true, true, Map.of("foo", "bar"));
+        builder.add("index3", true, true, Map.of("foo", "quux"));
+        {
+            FieldCapabilities cap1 = builder.build(false);
+            assertThat(cap1.isSearchable(), equalTo(true));
+            assertThat(cap1.isAggregatable(), equalTo(true));
+            assertNull(cap1.indices());
+            assertNull(cap1.nonSearchableIndices());
+            assertNull(cap1.nonAggregatableIndices());
+            assertEquals(Map.of("foo", Set.of("bar", "quux")), cap1.meta());
+
+            FieldCapabilities cap2 = builder.build(true);
+            assertThat(cap2.isSearchable(), equalTo(true));
+            assertThat(cap2.isAggregatable(), equalTo(true));
+            assertThat(cap2.indices().length, equalTo(3));
+            assertThat(cap2.indices(), equalTo(new String[]{"index1", "index2", "index3"}));
+            assertNull(cap2.nonSearchableIndices());
+            assertNull(cap2.nonAggregatableIndices());
+            assertEquals(Map.of("foo", Set.of("bar", "quux")), cap2.meta());
         }
     }
 
@@ -113,9 +143,23 @@ static FieldCapabilities randomFieldCaps(String fieldName) {
                 nonAggregatableIndices[i] = randomAlphaOfLengthBetween(5, 20);
             }
         }
+
+        Map<String, Set<String>> meta;
+        switch (randomInt(2)) {
+        case 0:
+            meta = Collections.emptyMap();
+            break;
+        case 1:
+            meta = Map.of("foo", Set.of("bar"));
+            break;
+        default:
+            meta = Map.of("foo", Set.of("bar", "baz"));
+            break;
+        }
+
         return new FieldCapabilities(fieldName,
             randomAlphaOfLengthBetween(5, 20), randomBoolean(), randomBoolean(),
-            indices, nonSearchableIndices, nonAggregatableIndices);
+            indices, nonSearchableIndices, nonAggregatableIndices, meta);
     }
 
     @Override
@@ -127,7 +171,8 @@ protected FieldCapabilities mutateInstance(FieldCapabilities instance) {
         String[] indices = instance.indices();
         String[] nonSearchableIndices = instance.nonSearchableIndices();
         String[] nonAggregatableIndices = instance.nonAggregatableIndices();
-        switch (between(0, 6)) {
+        Map<String, Set<String>> meta = instance.meta();
+        switch (between(0, 7)) {
         case 0:
             name += randomAlphaOfLengthBetween(1, 10);
             break;
@@ -169,7 +214,6 @@ protected FieldCapabilities mutateInstance(FieldCapabilities instance) {
             nonSearchableIndices = newNonSearchableIndices;
             break;
         case 6:
-        default:
             String[] newNonAggregatableIndices;
             int startNonAggregatablePos = 0;
             if (nonAggregatableIndices == null) {
@@ -183,7 +227,18 @@ protected FieldCapabilities mutateInstance(FieldCapabilities instance) {
             }
             nonAggregatableIndices = newNonAggregatableIndices;
             break;
+        case 7:
+            Map<String, Set<String>> newMeta;
+            if (meta.isEmpty()) {
+                newMeta = Map.of("foo", Set.of("bar"));
+            } else {
+                newMeta = Collections.emptyMap();
+            }
+            meta = newMeta;
+            break;
+        default:
+            throw new AssertionError();
         }
-        return new FieldCapabilities(name, type, isSearchable, isAggregatable, indices, nonSearchableIndices, nonAggregatableIndices);
+        return new FieldCapabilities(name, type, isSearchable, isAggregatable, indices, nonSearchableIndices, nonAggregatableIndices, meta);
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/action/fieldcaps/MergedFieldCapabilitiesResponseTests.java b/server/src/test/java/org/elasticsearch/action/fieldcaps/MergedFieldCapabilitiesResponseTests.java
index 656dd5458e809..13a634177650c 100644
--- a/server/src/test/java/org/elasticsearch/action/fieldcaps/MergedFieldCapabilitiesResponseTests.java
+++ b/server/src/test/java/org/elasticsearch/action/fieldcaps/MergedFieldCapabilitiesResponseTests.java
@@ -152,19 +152,19 @@ public void testEmptyResponse() throws IOException {
 
     private static FieldCapabilitiesResponse createSimpleResponse() {
         Map<String, FieldCapabilities> titleCapabilities = new HashMap<>();
-        titleCapabilities.put("text", new FieldCapabilities("title", "text", true, false));
+        titleCapabilities.put("text", new FieldCapabilities("title", "text", true, false, Collections.emptyMap()));
 
         Map<String, FieldCapabilities> ratingCapabilities = new HashMap<>();
         ratingCapabilities.put("long", new FieldCapabilities("rating", "long",
             true, false,
             new String[]{"index1", "index2"},
             null,
-            new String[]{"index1"}));
+            new String[]{"index1"}, Collections.emptyMap()));
         ratingCapabilities.put("keyword", new FieldCapabilities("rating", "keyword",
             false, true,
             new String[]{"index3", "index4"},
             new String[]{"index4"},
-            null));
+            null, Collections.emptyMap()));
 
         Map<String, Map<String, FieldCapabilities>> responses = new HashMap<>();
         responses.put("title", titleCapabilities);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
index a6e6d5c79d1e8..1fd3f51ece916 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
@@ -38,6 +38,7 @@
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexService;
+import org.elasticsearch.index.mapper.MapperService.MergeReason;
 import org.elasticsearch.index.mapper.ParseContext.Document;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESSingleNodeTestCase;
@@ -46,6 +47,7 @@
 
 import java.io.IOException;
 import java.util.Collection;
+import java.util.Collections;
 
 import static org.hamcrest.Matchers.containsString;
 
@@ -251,4 +253,30 @@ public void testEmptyName() throws IOException {
         );
         assertThat(e.getMessage(), containsString("name cannot be empty string"));
     }
+
+    public void testMeta() throws Exception {
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "boolean")
+                .field("meta", Collections.singletonMap("foo", "bar"))
+                .endObject().endObject().endObject().endObject());
+
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping, mapper.mappingSource().toString());
+
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "boolean")
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping2, mapper.mappingSource().toString());
+
+        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "boolean")
+                .field("meta", Collections.singletonMap("baz", "quux"))
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping3, mapper.mappingSource().toString());
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
index daa70c865133f..477cf7de8285c 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexService;
+import org.elasticsearch.index.mapper.MapperService.MergeReason;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.test.InternalSettingsPlugin;
@@ -39,6 +40,7 @@
 import java.time.ZoneOffset;
 import java.time.ZonedDateTime;
 import java.util.Collection;
+import java.util.Collections;
 
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.notNullValue;
@@ -415,4 +417,30 @@ public void testIllegalFormatField() throws Exception {
                 () -> parser.parse("type", new CompressedXContent(mapping)));
         assertEquals("Invalid format: [[test_format]]: Unknown pattern letter: t", e.getMessage());
     }
+
+    public void testMeta() throws Exception {
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "date")
+                .field("meta", Collections.singletonMap("foo", "bar"))
+                .endObject().endObject().endObject().endObject());
+
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping, mapper.mappingSource().toString());
+
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "date")
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping2, mapper.mappingSource().toString());
+
+        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "date")
+                .field("meta", Collections.singletonMap("baz", "quux"))
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping3, mapper.mappingSource().toString());
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
index dad4b72cdf380..fd821f1170ce8 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
@@ -46,6 +46,7 @@
 import java.io.IOException;
 import java.util.Arrays;
 import java.util.Collection;
+import java.util.Collections;
 import java.util.List;
 import java.util.Map;
 
@@ -547,4 +548,30 @@ public void testSplitQueriesOnWhitespace() throws IOException {
         assertThat(ft.searchAnalyzer().name(), equalTo("my_lowercase"));
         assertTokenStreamContents(ft.searchAnalyzer().analyzer().tokenStream("", "Hello World"), new String[] {"hello world"});
     }
+
+    public void testMeta() throws Exception {
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "keyword")
+                .field("meta", Collections.singletonMap("foo", "bar"))
+                .endObject().endObject().endObject().endObject());
+
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping, mapper.mappingSource().toString());
+
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "keyword")
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping2, mapper.mappingSource().toString());
+
+        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "keyword")
+                .field("meta", Collections.singletonMap("baz", "quux"))
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping3, mapper.mappingSource().toString());
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
index 5d8d45687b1be..539d8bbdeaf59 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
@@ -1247,4 +1247,30 @@ public void testSimpleMerge() throws IOException {
             assertThat(mapper.mappers().getMapper("b_field"), instanceOf(KeywordFieldMapper.class));
         }
     }
+
+    public void testMeta() throws Exception {
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "text")
+                .field("meta", Collections.singletonMap("foo", "bar"))
+                .endObject().endObject().endObject().endObject());
+
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping, mapper.mappingSource().toString());
+
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "text")
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping2, mapper.mappingSource().toString());
+
+        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "text")
+                .field("meta", Collections.singletonMap("baz", "quux"))
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping3, mapper.mappingSource().toString());
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/TypeParsersTests.java b/server/src/test/java/org/elasticsearch/index/mapper/TypeParsersTests.java
index 8fb30cf8d1c38..1a03cc7ca91b4 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/TypeParsersTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/TypeParsersTests.java
@@ -19,6 +19,20 @@
 
 package org.elasticsearch.index.mapper;
 
+import static org.elasticsearch.index.analysis.AnalysisRegistry.DEFAULT_ANALYZER_NAME;
+import static org.elasticsearch.index.analysis.AnalysisRegistry.DEFAULT_SEARCH_ANALYZER_NAME;
+import static org.elasticsearch.index.analysis.AnalysisRegistry.DEFAULT_SEARCH_QUOTED_ANALYZER_NAME;
+import static org.hamcrest.core.IsEqual.equalTo;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.stream.Collectors;
+import java.util.stream.IntStream;
+
 import org.apache.lucene.analysis.Analyzer;
 import org.apache.lucene.analysis.TokenStream;
 import org.apache.lucene.analysis.standard.StandardAnalyzer;
@@ -40,18 +54,7 @@
 import org.elasticsearch.index.analysis.TokenFilterFactory;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.VersionUtils;
-
-import java.io.IOException;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.Map;
-
-import static org.elasticsearch.index.analysis.AnalysisRegistry.DEFAULT_ANALYZER_NAME;
-import static org.elasticsearch.index.analysis.AnalysisRegistry.DEFAULT_SEARCH_ANALYZER_NAME;
-import static org.elasticsearch.index.analysis.AnalysisRegistry.DEFAULT_SEARCH_QUOTED_ANALYZER_NAME;
-import static org.hamcrest.core.IsEqual.equalTo;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
+import org.hamcrest.Matchers;
 
 public class TypeParsersTests extends ESTestCase {
 
@@ -227,4 +230,69 @@ public TokenStream create(TokenStream tokenStream) {
         return new CustomAnalyzer(null, new CharFilterFactory[0],
                 new TokenFilterFactory[] { tokenFilter  });
     }
+
+    public void testParseMeta() {
+        FieldMapper.Builder<?, ?> builder = new KeywordFieldMapper.Builder("foo");
+        Mapper.TypeParser.ParserContext parserContext = new Mapper.TypeParser.ParserContext(null, null, null, null, null);
+
+        {
+            Map<String, Object> mapping = new HashMap<>(Map.of("meta", 3));
+            MapperParsingException e = expectThrows(MapperParsingException.class,
+                    () -> TypeParsers.parseField(builder, builder.name, mapping, parserContext));
+            assertEquals("[meta] must be an object, got Integer[3] for field [foo]", e.getMessage());
+        }
+
+        {
+            Map<String, Object> mapping = new HashMap<>(Map.of("meta", Map.of("veryloooooooooooongkey", 3L)));
+            MapperParsingException e = expectThrows(MapperParsingException.class,
+                    () -> TypeParsers.parseField(builder, builder.name, mapping, parserContext));
+            assertEquals("[meta] keys can't be longer than 20 chars, but got [veryloooooooooooongkey] for field [foo]",
+                    e.getMessage());
+        }
+
+        {
+            Map<String, Object> mapping = new HashMap<>(Map.of("meta", Map.of(
+                    "foo1", 3L, "foo2", 4L, "foo3", 5L, "foo4", 6L, "foo5", 7L, "foo6", 8L)));
+            MapperParsingException e = expectThrows(MapperParsingException.class,
+                    () -> TypeParsers.parseField(builder, builder.name, mapping, parserContext));
+            assertEquals("[meta] can't have more than 5 entries, but got 6 on field [foo]",
+                    e.getMessage());
+        }
+
+        {
+            Map<String, Object> mapping = new HashMap<>(Map.of("meta", Map.of("foo", Map.of("bar", "baz"))));
+            MapperParsingException e = expectThrows(MapperParsingException.class,
+                    () -> TypeParsers.parseField(builder, builder.name, mapping, parserContext));
+            assertEquals("[meta] values can only be strings, but got Map1[{bar=baz}] for field [foo]",
+                    e.getMessage());
+        }
+
+        {
+            Map<String, Object> mapping = new HashMap<>(Map.of("meta", Map.of("bar", "baz", "foo", 3)));
+            MapperParsingException e = expectThrows(MapperParsingException.class,
+                    () -> TypeParsers.parseField(builder, builder.name, mapping, parserContext));
+            assertEquals("[meta] values can only be strings, but got Integer[3] for field [foo]",
+                    e.getMessage());
+        }
+
+        {
+            Map<String, String> meta = new HashMap<>();
+            meta.put("foo", null);
+            Map<String, Object> mapping = new HashMap<>(Map.of("meta", meta));
+            MapperParsingException e = expectThrows(MapperParsingException.class,
+                    () -> TypeParsers.parseField(builder, builder.name, mapping, parserContext));
+            assertEquals("[meta] values can't be null (field [foo])",
+                    e.getMessage());
+        }
+
+        {
+            String longString = IntStream.range(0, 51)
+                    .mapToObj(Integer::toString)
+                    .collect(Collectors.joining());
+            Map<String, Object> mapping = new HashMap<>(Map.of("meta", Map.of("foo", longString)));
+            MapperParsingException e = expectThrows(MapperParsingException.class,
+                    () -> TypeParsers.parseField(builder, builder.name, mapping, parserContext));
+            assertThat(e.getMessage(), Matchers.startsWith("[meta] values can't be longer than 50 chars"));
+        }
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/fieldcaps/FieldCapabilitiesIT.java b/server/src/test/java/org/elasticsearch/search/fieldcaps/FieldCapabilitiesIT.java
index 7adc447a20736..254447abcf8eb 100644
--- a/server/src/test/java/org/elasticsearch/search/fieldcaps/FieldCapabilitiesIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fieldcaps/FieldCapabilitiesIT.java
@@ -119,12 +119,14 @@ public void testFieldAlias() {
 
         assertTrue(distance.containsKey("double"));
         assertEquals(
-            new FieldCapabilities("distance", "double", true, true, new String[] {"old_index"}, null, null),
+            new FieldCapabilities("distance", "double", true, true, new String[] {"old_index"}, null, null,
+                    Collections.emptyMap()),
             distance.get("double"));
 
         assertTrue(distance.containsKey("text"));
         assertEquals(
-            new FieldCapabilities("distance", "text", true, false, new String[] {"new_index"}, null, null),
+            new FieldCapabilities("distance", "text", true, false, new String[] {"new_index"}, null, null,
+                    Collections.emptyMap()),
             distance.get("text"));
 
         // Check the capabilities for the 'route_length_miles' alias.
@@ -133,7 +135,7 @@ public void testFieldAlias() {
 
         assertTrue(routeLength.containsKey("double"));
         assertEquals(
-            new FieldCapabilities("route_length_miles", "double", true, true),
+            new FieldCapabilities("route_length_miles", "double", true, true, Collections.emptyMap()),
             routeLength.get("double"));
     }
 
@@ -174,12 +176,14 @@ public void testWithUnmapped() {
 
         assertTrue(oldField.containsKey("long"));
         assertEquals(
-            new FieldCapabilities("old_field", "long", true, true, new String[] {"old_index"}, null, null),
+            new FieldCapabilities("old_field", "long", true, true, new String[] {"old_index"}, null, null,
+                    Collections.emptyMap()),
             oldField.get("long"));
 
         assertTrue(oldField.containsKey("unmapped"));
         assertEquals(
-            new FieldCapabilities("old_field", "unmapped", false, false, new String[] {"new_index"}, null, null),
+            new FieldCapabilities("old_field", "unmapped", false, false, new String[] {"new_index"}, null, null,
+                    Collections.emptyMap()),
             oldField.get("unmapped"));
 
         Map<String, FieldCapabilities> newField = response.getField("new_field");
@@ -187,7 +191,7 @@ public void testWithUnmapped() {
 
         assertTrue(newField.containsKey("long"));
         assertEquals(
-            new FieldCapabilities("new_field", "long", true, true),
+            new FieldCapabilities("new_field", "long", true, true, Collections.emptyMap()),
             newField.get("long"));
     }
 
diff --git a/test/framework/src/main/java/org/elasticsearch/index/mapper/AbstractNumericFieldMapperTestCase.java b/test/framework/src/main/java/org/elasticsearch/index/mapper/AbstractNumericFieldMapperTestCase.java
index b732c6b5b42bf..18e3a64648759 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/mapper/AbstractNumericFieldMapperTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/mapper/AbstractNumericFieldMapperTestCase.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.common.compress.CompressedXContent;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.index.IndexService;
+import org.elasticsearch.index.mapper.MapperService.MergeReason;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.test.InternalSettingsPlugin;
@@ -29,6 +30,7 @@
 
 import java.io.IOException;
 import java.util.Collection;
+import java.util.Collections;
 import java.util.Set;
 
 import static org.hamcrest.Matchers.containsString;
@@ -124,4 +126,33 @@ public void testEmptyName() throws IOException {
         }
     }
 
+    public void testMeta() throws Exception {
+        for (String type : TYPES) {
+            IndexService indexService = createIndex("test-" + type);
+            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                    .startObject("properties").startObject("field").field("type", type)
+                    .field("meta", Collections.singletonMap("foo", "bar"))
+                    .endObject().endObject().endObject().endObject());
+
+            DocumentMapper mapper = indexService.mapperService().merge("_doc",
+                    new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+            assertEquals(mapping, mapper.mappingSource().toString());
+
+            String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                    .startObject("properties").startObject("field").field("type", type)
+                    .endObject().endObject().endObject().endObject());
+            mapper = indexService.mapperService().merge("_doc",
+                    new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+            assertEquals(mapping2, mapper.mappingSource().toString());
+
+            String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                    .startObject("properties").startObject("field").field("type", type)
+                    .field("meta", Collections.singletonMap("baz", "quux"))
+                    .endObject().endObject().endObject().endObject());
+            mapper = indexService.mapperService().merge("_doc",
+                    new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+            assertEquals(mapping3, mapper.mappingSource().toString());
+        }
+    }
+
 }
diff --git a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapper.java b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapper.java
index b22f6eb0573df..0e5f9a9225178 100644
--- a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapper.java
+++ b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapper.java
@@ -43,6 +43,7 @@
 import org.elasticsearch.index.mapper.MapperParsingException;
 import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.index.mapper.ParseContext;
+import org.elasticsearch.index.mapper.TypeParsers;
 import org.elasticsearch.index.query.QueryShardContext;
 import org.elasticsearch.index.query.QueryShardException;
 import org.elasticsearch.indices.breaker.CircuitBreakerService;
@@ -124,6 +125,7 @@ public Mapper.Builder<Builder, HistogramFieldMapper> parse(String name,
                                                                    Map<String, Object> node, ParserContext parserContext)
                 throws MapperParsingException {
             Builder builder = new HistogramFieldMapper.Builder(name);
+            TypeParsers.parseMeta(builder, name, node);
             for (Iterator<Map.Entry<String, Object>> iterator = node.entrySet().iterator(); iterator.hasNext();) {
                 Map.Entry<String, Object> entry = iterator.next();
                 String propName = entry.getKey();
diff --git a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapperTests.java b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapperTests.java
index 055b01186cd61..76aa163d7e98e 100644
--- a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapperTests.java
+++ b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramFieldMapperTests.java
@@ -11,10 +11,12 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.index.IndexService;
 import org.elasticsearch.index.mapper.DocumentMapper;
 import org.elasticsearch.index.mapper.MapperParsingException;
 import org.elasticsearch.index.mapper.ParsedDocument;
 import org.elasticsearch.index.mapper.SourceToParse;
+import org.elasticsearch.index.mapper.MapperService.MergeReason;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.xpack.analytics.AnalyticsPlugin;
@@ -22,6 +24,7 @@
 
 import java.util.ArrayList;
 import java.util.Collection;
+import java.util.Collections;
 import java.util.List;
 
 import static org.hamcrest.Matchers.containsString;
@@ -498,6 +501,33 @@ public void testNegativeCount() throws Exception {
         assertThat(e.getCause().getMessage(), containsString("[counts] elements must be >= 0 but got -3"));
     }
 
+    public void testMeta() throws Exception {
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "histogram")
+                .field("meta", Collections.singletonMap("foo", "bar"))
+                .endObject().endObject().endObject().endObject());
+
+        IndexService indexService = createIndex("test");
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping, mapper.mappingSource().toString());
+
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "histogram")
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping2, mapper.mappingSource().toString());
+
+        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+                .startObject("properties").startObject("field").field("type", "histogram")
+                .field("meta", Collections.singletonMap("baz", "quux"))
+                .endObject().endObject().endObject().endObject());
+        mapper = indexService.mapperService().merge("_doc",
+                new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        assertEquals(mapping3, mapper.mappingSource().toString());
+    }
+
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
         List<Class<? extends Plugin>> plugins = new ArrayList<>(super.getPlugins());
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
index 6b882d03f2919..6a273a72b254f 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
@@ -953,7 +953,7 @@ private MockFieldCapsResponseBuilder addNonAggregatableField(String field, Strin
         private MockFieldCapsResponseBuilder addField(String field, boolean isAggregatable, String... types) {
             Map<String, FieldCapabilities> caps = new HashMap<>();
             for (String type : types) {
-                caps.put(type, new FieldCapabilities(field, type, true, isAggregatable));
+                caps.put(type, new FieldCapabilities(field, type, true, isAggregatable, Collections.emptyMap()));
             }
             fieldCaps.put(field, caps);
             return this;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
index d57c090817d10..045f2b8928f33 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -143,8 +144,10 @@ public void testMergeIncompatibleCapabilitiesOfObjectFields() throws Exception {
         addFieldCaps(fieldCaps, fieldName + ".keyword", "keyword", true, true);
 
         Map<String, FieldCapabilities> multi = new HashMap<>();
-        multi.put("long", new FieldCapabilities(fieldName, "long", true, true, new String[] { "one-index" }, null, null));
-        multi.put("text", new FieldCapabilities(fieldName, "text", true, false, new String[] { "another-index" }, null, null));
+        multi.put("long", new FieldCapabilities(fieldName, "long", true, true, new String[] { "one-index" }, null, null,
+                Collections.emptyMap()));
+        multi.put("text", new FieldCapabilities(fieldName, "text", true, false, new String[] { "another-index" }, null, null,
+                Collections.emptyMap()));
         fieldCaps.put(fieldName, multi);
 
 
@@ -214,7 +217,8 @@ public void testMultipleCompatibleIndicesWithDifferentFields() {
 
     public void testIndexWithNoMapping() {
         Map<String, Map<String, FieldCapabilities>> versionFC = singletonMap("_version",
-                singletonMap("_index", new FieldCapabilities("_version", "_version", false, false)));
+                singletonMap("_index", new FieldCapabilities("_version", "_version", false, false,
+                        Collections.emptyMap())));
         assertTrue(IndexResolver.mergedMappings("*", new String[] { "empty" }, versionFC).isValid());
     }
 
@@ -289,7 +293,7 @@ private static class UpdateableFieldCapabilities extends FieldCapabilities {
         List<String> nonAggregatableIndices = new ArrayList<>();
 
         UpdateableFieldCapabilities(String name, String type, boolean isSearchable, boolean isAggregatable) {
-            super(name, type, isSearchable, isAggregatable);
+            super(name, type, isSearchable, isAggregatable, Collections.emptyMap());
         }
 
         @Override
@@ -323,7 +327,7 @@ private static <K, V> void assertEqualsMaps(Map<K, V> left, Map<K, V> right) {
     private void addFieldCaps(Map<String, Map<String, FieldCapabilities>> fieldCaps, String name, String type, boolean isSearchable,
             boolean isAggregatable) {
         Map<String, FieldCapabilities> cap = new HashMap<>();
-        cap.put(name, new FieldCapabilities(name, type, isSearchable, isAggregatable));
+        cap.put(name, new FieldCapabilities(name, type, isSearchable, isAggregatable, Collections.emptyMap()));
         fieldCaps.put(name, cap);
     }
 }

From 0a4416b9ddbccd8acf43f4af82f37aae0109b9dc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Wed, 18 Dec 2019 17:35:35 +0100
Subject: [PATCH 250/686] [Docs] Remove `intervals` filter rule from allowed
 top-level rules (#50320)

The `filter` rule is not allowed on the top-level of the query, so removing it
from the list of allowed rules. Where it can be nested inside other rules, those
rules already mention it.
---
 docs/reference/query-dsl/intervals-query.asciidoc | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/reference/query-dsl/intervals-query.asciidoc b/docs/reference/query-dsl/intervals-query.asciidoc
index 150b4b9616c16..9f9280c80a484 100644
--- a/docs/reference/query-dsl/intervals-query.asciidoc
+++ b/docs/reference/query-dsl/intervals-query.asciidoc
@@ -75,7 +75,6 @@ Valid rules include:
 * <<intervals-wildcard,`wildcard`>>
 * <<intervals-all_of,`all_of`>>
 * <<intervals-any_of,`any_of`>>
-* <<interval_filter,`filter`>>
 --
 
 [[intervals-match]]

From 672c16f17cd7fd65edd44e259c14eb1f77fc601b Mon Sep 17 00:00:00 2001
From: Nikita Glashenko <nikita.glashenko@gmail.com>
Date: Wed, 18 Dec 2019 20:40:45 +0400
Subject: [PATCH 251/686] Add tests for IntervalsSourceProvider.Wildcard and
 Prefix (#50306)

This PR adds unit tests for wire and xContent serialization of `IntervalsSourceProvider.Wildcard`
and `IntervalsSourceProvider.Prefix`.

Relates #50150
---
 .../index/query/IntervalsSourceProvider.java  | 34 +++++++--
 .../PrefixIntervalsSourceProviderTests.java   | 76 +++++++++++++++++++
 .../WildcardIntervalsSourceProviderTests.java | 76 +++++++++++++++++++
 3 files changed, 181 insertions(+), 5 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/index/query/PrefixIntervalsSourceProviderTests.java
 create mode 100644 server/src/test/java/org/elasticsearch/index/query/WildcardIntervalsSourceProviderTests.java

diff --git a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
index 167266e0892fd..4918d7c7c7f3f 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
@@ -87,7 +87,7 @@ public static IntervalsSourceProvider fromXContent(XContentParser parser) throws
                 return Wildcard.fromXContent(parser);
         }
         throw new ParsingException(parser.getTokenLocation(),
-            "Unknown interval type [" + parser.currentName() + "], expecting one of [match, any_of, all_of, prefix]");
+            "Unknown interval type [" + parser.currentName() + "], expecting one of [match, any_of, all_of, prefix, wildcard]");
     }
 
     private static IntervalsSourceProvider parseInnerIntervals(XContentParser parser) throws IOException {
@@ -548,6 +548,18 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         public static Prefix fromXContent(XContentParser parser) throws IOException {
             return PARSER.parse(parser, null);
         }
+
+        String getPrefix() {
+            return prefix;
+        }
+
+        String getAnalyzer() {
+            return analyzer;
+        }
+
+        String getUseField() {
+            return useField;
+        }
     }
 
     public static class Wildcard extends IntervalsSourceProvider {
@@ -613,10 +625,10 @@ public void extractFields(Set<String> fields) {
         public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
-            Prefix prefix = (Prefix) o;
-            return Objects.equals(pattern, prefix.prefix) &&
-                Objects.equals(analyzer, prefix.analyzer) &&
-                Objects.equals(useField, prefix.useField);
+            Wildcard wildcard = (Wildcard) o;
+            return Objects.equals(pattern, wildcard.pattern) &&
+                Objects.equals(analyzer, wildcard.analyzer) &&
+                Objects.equals(useField, wildcard.useField);
         }
 
         @Override
@@ -665,6 +677,18 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         public static Wildcard fromXContent(XContentParser parser) throws IOException {
             return PARSER.parse(parser, null);
         }
+
+        String getPattern() {
+            return pattern;
+        }
+
+        String getAnalyzer() {
+            return analyzer;
+        }
+
+        String getUseField() {
+            return useField;
+        }
     }
 
     static class ScriptFilterSource extends FilteredIntervalsSource {
diff --git a/server/src/test/java/org/elasticsearch/index/query/PrefixIntervalsSourceProviderTests.java b/server/src/test/java/org/elasticsearch/index/query/PrefixIntervalsSourceProviderTests.java
new file mode 100644
index 0000000000000..8f2d950fbff1b
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/query/PrefixIntervalsSourceProviderTests.java
@@ -0,0 +1,76 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+
+import static org.elasticsearch.index.query.IntervalsSourceProvider.Prefix;
+
+public class PrefixIntervalsSourceProviderTests extends AbstractSerializingTestCase<Prefix> {
+
+    @Override
+    protected Prefix createTestInstance() {
+        return new Prefix(
+            randomAlphaOfLength(10),
+            randomBoolean() ? randomAlphaOfLength(10) : null,
+            randomBoolean() ? randomAlphaOfLength(10) : null
+        );
+    }
+
+    @Override
+    protected Prefix mutateInstance(Prefix instance) throws IOException {
+        String prefix = instance.getPrefix();
+        String analyzer = instance.getAnalyzer();
+        String useField = instance.getUseField();
+        switch (between(0, 2)) {
+            case 0:
+                prefix += "a";
+                break;
+            case 1:
+                analyzer = randomAlphaOfLength(5);
+                break;
+            case 2:
+                useField = useField == null ? randomAlphaOfLength(5) : null;
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+        return new Prefix(prefix, analyzer, useField);
+    }
+
+    @Override
+    protected Writeable.Reader<Prefix> instanceReader() {
+        return Prefix::new;
+    }
+
+    @Override
+    protected Prefix doParseInstance(XContentParser parser) throws IOException {
+        if (parser.nextToken() == XContentParser.Token.START_OBJECT) {
+            parser.nextToken();
+        }
+        Prefix prefix = (Prefix) IntervalsSourceProvider.fromXContent(parser);
+        assertEquals(XContentParser.Token.END_OBJECT, parser.nextToken());
+        return prefix;
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/query/WildcardIntervalsSourceProviderTests.java b/server/src/test/java/org/elasticsearch/index/query/WildcardIntervalsSourceProviderTests.java
new file mode 100644
index 0000000000000..7bcf3defeea9c
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/query/WildcardIntervalsSourceProviderTests.java
@@ -0,0 +1,76 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+
+import static org.elasticsearch.index.query.IntervalsSourceProvider.Wildcard;
+
+public class WildcardIntervalsSourceProviderTests extends AbstractSerializingTestCase<Wildcard> {
+
+    @Override
+    protected Wildcard createTestInstance() {
+        return new Wildcard(
+            randomAlphaOfLength(10),
+            randomBoolean() ? randomAlphaOfLength(10) : null,
+            randomBoolean() ? randomAlphaOfLength(10) : null
+        );
+    }
+
+    @Override
+    protected Wildcard mutateInstance(Wildcard instance) throws IOException {
+        String wildcard = instance.getPattern();
+        String analyzer = instance.getAnalyzer();
+        String useField = instance.getUseField();
+        switch (between(0, 2)) {
+            case 0:
+                wildcard += "a";
+                break;
+            case 1:
+                analyzer = randomAlphaOfLength(5);
+                break;
+            case 2:
+                useField = useField == null ? randomAlphaOfLength(5) : null;
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+        return new Wildcard(wildcard, analyzer, useField);
+    }
+
+    @Override
+    protected Writeable.Reader<Wildcard> instanceReader() {
+        return Wildcard::new;
+    }
+
+    @Override
+    protected Wildcard doParseInstance(XContentParser parser) throws IOException {
+        if (parser.nextToken() == XContentParser.Token.START_OBJECT) {
+            parser.nextToken();
+        }
+        Wildcard wildcard = (Wildcard) IntervalsSourceProvider.fromXContent(parser);
+        assertEquals(XContentParser.Token.END_OBJECT, parser.nextToken());
+        return wildcard;
+    }
+}

From 65f7a011fb081b2ad99f074907355f8079875490 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Wed, 18 Dec 2019 16:56:15 +0000
Subject: [PATCH 252/686] [ML] Refresh state index before completing data frame
 analytics job (#50322)

In order to ensure any persisted model state is searchable by the moment
the job reports itself as `stopped`, we need to refresh the state index
before completing.

This should fix the occasional failures we see in #50168 and #50313 where
the model state appears missing.

Closes #50168
Closes #50313
---
 .../dataframe/process/AnalyticsProcessManager.java  | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
index ce981ad17a98a..30ecb71f4c058 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsProcessManager.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.action.admin.indices.refresh.RefreshAction;
 import org.elasticsearch.action.admin.indices.refresh.RefreshRequest;
 import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Strings;
@@ -159,6 +160,7 @@ private void processData(DataFrameAnalyticsTask task, ProcessContext processCont
             processContext.setFailureReason(resultProcessor.getFailure());
 
             refreshDest(config);
+            refreshStateIndex(config.getId());
             LOGGER.info("[{}] Result processor has completed", config.getId());
         } catch (Exception e) {
             if (task.isStopping()) {
@@ -288,6 +290,17 @@ private void refreshDest(DataFrameAnalyticsConfig config) {
             () -> client.execute(RefreshAction.INSTANCE, new RefreshRequest(config.getDest().getIndex())).actionGet());
     }
 
+    private void refreshStateIndex(String jobId) {
+        String indexName = AnomalyDetectorsIndex.jobStateIndexPattern();
+        LOGGER.debug("[{}] Refresh index {}", jobId, indexName);
+
+        RefreshRequest refreshRequest = new RefreshRequest(indexName);
+        refreshRequest.indicesOptions(IndicesOptions.lenientExpandOpen());
+        try (ThreadContext.StoredContext ignore = client.threadPool().getThreadContext().stashWithOrigin(ML_ORIGIN)) {
+            client.admin().indices().refresh(refreshRequest).actionGet();
+        }
+    }
+
     private void closeProcess(DataFrameAnalyticsTask task) {
         String configId = task.getParams().getId();
         LOGGER.info("[{}] Closing process", configId);

From 957d883c5d47c6317de98877b8de4e8989e30843 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 18 Dec 2019 12:17:41 -0500
Subject: [PATCH 253/686] [DOCS] Clarify frozen indices are read-only (#50318)

The freeze index API docs state that frozen indices are blocked for
write operations.

While this implies frozen indices are read-only, it does not explicitly
use the term "read-only", which is found in other docs, such as the
force merge docs.

This adds the "ready-only" term to the freeze index API docs as well
as other clarification.
---
 docs/reference/indices/apis/freeze.asciidoc | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/reference/indices/apis/freeze.asciidoc b/docs/reference/indices/apis/freeze.asciidoc
index bb41de6763e32..e123e93bd30b9 100644
--- a/docs/reference/indices/apis/freeze.asciidoc
+++ b/docs/reference/indices/apis/freeze.asciidoc
@@ -19,9 +19,10 @@ Freezes an index.
 [[freeze-index-api-desc]]
 ==== {api-description-title}
 
-A frozen index has almost no overhead on the cluster (except
-for maintaining its metadata in memory), and is blocked for write operations.
-See <<frozen-indices>> and <<unfreeze-index-api>>.
+A frozen index has almost no overhead on the cluster (except for maintaining its
+metadata in memory) and is read-only. Read-only indices are blocked for write
+operations, such as <<indexing,docs-index_>> or <<indices-forcemerge,force
+merges>>. See <<frozen-indices>> and <<unfreeze-index-api>>.
 
 IMPORTANT: Freezing an index will close the index and reopen it within the same
 API call. This causes primaries to not be allocated for a short amount of time

From 85d69412f043042504ce8ad4888f4ec08fd821d2 Mon Sep 17 00:00:00 2001
From: Stuart Tettemer <stu@elastic.co>
Date: Wed, 18 Dec 2019 10:27:16 -0700
Subject: [PATCH 254/686] Scripting: Cache script results if deterministic
 (#50106)

Cache results from queries that use scripts if they use only
deterministic API calls.  Nondeterministic API calls are marked in the
whitelist with the `@nondeterministic` annotation.  Examples are
`Math.random()` and `new Date()`.

Refs: #49466
---
 build.gradle                                  |   4 +-
 .../NonDeterministicAnnotation.java           |  29 ++
 .../NonDeterministicAnnotationParser.java     |  40 +++
 .../annotation/WhitelistAnnotationParser.java |   3 +-
 .../org/elasticsearch/painless/Compiler.java  |  10 +-
 .../painless/PainlessScriptEngine.java        |  34 ++-
 .../elasticsearch/painless/ScriptRoot.java    |   3 +
 .../painless/lookup/PainlessClassBinding.java |   6 +-
 .../painless/lookup/PainlessConstructor.java  |  11 +-
 .../lookup/PainlessLookupBuilder.java         |  53 ++--
 .../painless/lookup/PainlessMethod.java       |  10 +-
 .../painless/node/ECallLocal.java             |   3 +
 .../painless/node/ECapturingFunctionRef.java  |   2 +-
 .../elasticsearch/painless/node/ECast.java    |   2 +-
 .../elasticsearch/painless/node/ENewObj.java  |   3 +
 .../painless/node/PCallInvoke.java            |   3 +
 .../elasticsearch/painless/node/SClass.java   |   3 +-
 .../elasticsearch/painless/spi/java.lang.txt  |   8 +-
 .../elasticsearch/painless/spi/java.time.txt  |  10 +-
 .../elasticsearch/painless/spi/java.util.txt  |  42 +--
 .../elasticsearch/painless/FactoryTests.java  |  26 ++
 .../index/query/QueryShardContext.java        |   2 +
 .../support/MultiValuesSourceFieldConfig.java |  13 +-
 .../AggregationTestScriptsPlugin.java         |  10 +
 .../aggregations/bucket/DateHistogramIT.java  |  26 +-
 .../aggregations/bucket/DateRangeIT.java      |  26 +-
 .../bucket/DateScriptMocksPlugin.java         |   8 +
 .../aggregations/bucket/DoubleTermsIT.java    |  35 ++-
 .../aggregations/bucket/HistogramIT.java      |  35 ++-
 .../aggregations/bucket/LongTermsIT.java      |  35 ++-
 .../search/aggregations/bucket/RangeIT.java   |  36 ++-
 .../SignificantTermsSignificanceScoreIT.java  |  46 +++-
 .../bucket/terms/StringTermsIT.java           |  37 ++-
 .../metrics/AvgAggregatorTests.java           |  33 ++-
 .../aggregations/metrics/CardinalityIT.java   |  37 ++-
 .../aggregations/metrics/ExtendedStatsIT.java |  27 +-
 .../metrics/HDRPercentileRanksIT.java         |  29 +-
 .../metrics/HDRPercentilesIT.java             |  27 +-
 .../metrics/MaxAggregatorTests.java           |  31 ++-
 .../metrics/MedianAbsoluteDeviationIT.java    |  27 +-
 .../metrics/MetricAggScriptPlugin.java        |  13 +
 .../metrics/MinAggregatorTests.java           |  24 +-
 .../metrics/ScriptedMetricIT.java             |  82 +++++-
 .../search/aggregations/metrics/StatsIT.java  |  26 +-
 .../search/aggregations/metrics/SumIT.java    |  27 +-
 .../metrics/TDigestPercentileRanksIT.java     |  27 +-
 .../metrics/TDigestPercentilesIT.java         |  26 +-
 .../aggregations/metrics/TopHitsIT.java       |  49 +++-
 .../aggregations/metrics/ValueCountIT.java    |  28 +-
 .../script/MockDeterministicScript.java       |  45 ++++
 .../script/MockScriptEngine.java              | 255 +++++++++++-------
 .../script/MockScriptPlugin.java              |   4 +-
 52 files changed, 1076 insertions(+), 355 deletions(-)
 create mode 100644 modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/NonDeterministicAnnotation.java
 create mode 100644 modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/NonDeterministicAnnotationParser.java
 create mode 100644 test/framework/src/main/java/org/elasticsearch/script/MockDeterministicScript.java

diff --git a/build.gradle b/build.gradle
index df1641dcc9efe..6f786b5c3beea 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = true
-final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = false
+final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/50106" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")
diff --git a/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/NonDeterministicAnnotation.java b/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/NonDeterministicAnnotation.java
new file mode 100644
index 0000000000000..9724e42431419
--- /dev/null
+++ b/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/NonDeterministicAnnotation.java
@@ -0,0 +1,29 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.painless.spi.annotation;
+
+public class NonDeterministicAnnotation {
+
+    public static final String NAME = "nondeterministic";
+
+    public static final NonDeterministicAnnotation INSTANCE = new NonDeterministicAnnotation();
+
+    private NonDeterministicAnnotation() {}
+}
diff --git a/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/NonDeterministicAnnotationParser.java b/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/NonDeterministicAnnotationParser.java
new file mode 100644
index 0000000000000..4277cf3b1d699
--- /dev/null
+++ b/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/NonDeterministicAnnotationParser.java
@@ -0,0 +1,40 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.painless.spi.annotation;
+
+import java.util.Map;
+
+public class NonDeterministicAnnotationParser implements WhitelistAnnotationParser {
+
+    public static final NonDeterministicAnnotationParser INSTANCE = new NonDeterministicAnnotationParser();
+
+    private NonDeterministicAnnotationParser() {}
+
+    @Override
+    public Object parse(Map<String, String> arguments) {
+        if (arguments.isEmpty() == false) {
+            throw new IllegalArgumentException(
+                "unexpected parameters for [@" + NonDeterministicAnnotation.NAME + "] annotation, found " + arguments
+            );
+        }
+
+        return NonDeterministicAnnotation.INSTANCE;
+    }
+}
diff --git a/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/WhitelistAnnotationParser.java b/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/WhitelistAnnotationParser.java
index d5dcbab36f34f..ecf1c45c7602f 100644
--- a/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/WhitelistAnnotationParser.java
+++ b/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/annotation/WhitelistAnnotationParser.java
@@ -34,7 +34,8 @@ public interface WhitelistAnnotationParser {
     Map<String, WhitelistAnnotationParser> BASE_ANNOTATION_PARSERS = Collections.unmodifiableMap(
             Stream.of(
                     new AbstractMap.SimpleEntry<>(NoImportAnnotation.NAME, NoImportAnnotationParser.INSTANCE),
-                    new AbstractMap.SimpleEntry<>(DeprecatedAnnotation.NAME, DeprecatedAnnotationParser.INSTANCE)
+                    new AbstractMap.SimpleEntry<>(DeprecatedAnnotation.NAME, DeprecatedAnnotationParser.INSTANCE),
+                    new AbstractMap.SimpleEntry<>(NonDeterministicAnnotation.NAME, NonDeterministicAnnotationParser.INSTANCE)
             ).collect(Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue))
     );
 
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/Compiler.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/Compiler.java
index f6de8be896cb3..174936ec6ff40 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/Compiler.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/Compiler.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.painless.spi.Whitelist;
 import org.objectweb.asm.util.Printer;
 
-import java.lang.reflect.Constructor;
 import java.lang.reflect.Method;
 import java.net.MalformedURLException;
 import java.net.URL;
@@ -205,13 +204,14 @@ private static void addFactoryMethod(Map<String, Class<?>> additionalClasses, Cl
      * @param name The name of the script.
      * @param source The source code for the script.
      * @param settings The CompilerSettings to be used during the compilation.
-     * @return An executable script that implements both a specified interface and is a subclass of {@link PainlessScript}
+     * @return The ScriptRoot used to compile
      */
-    Constructor<?> compile(Loader loader, Set<String> extractedVariables, String name, String source, CompilerSettings settings) {
+    ScriptRoot compile(Loader loader, Set<String> extractedVariables, String name, String source,
+            CompilerSettings settings) {
         ScriptClassInfo scriptClassInfo = new ScriptClassInfo(painlessLookup, scriptClass);
         SClass root = Walker.buildPainlessTree(scriptClassInfo, name, source, settings, painlessLookup, null);
         root.extractVariables(extractedVariables);
-        root.analyze(painlessLookup, settings);
+        ScriptRoot scriptRoot = root.analyze(painlessLookup, settings);
         Map<String, Object> statics = root.write();
 
         try {
@@ -225,7 +225,7 @@ Constructor<?> compile(Loader loader, Set<String> extractedVariables, String nam
                 clazz.getField(statik.getKey()).set(null, statik.getValue());
             }
 
-            return clazz.getConstructors()[0];
+            return scriptRoot;
         } catch (Exception exception) {
             // Catch everything to let the user know this is something caused internally.
             throw new IllegalStateException("An internal error occurred attempting to define the script [" + name + "].", exception);
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
index 91448a4a3788e..45db4428aeced 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
@@ -143,12 +143,13 @@ public Loader run() {
         });
 
         Set<String> extractedVariables = new HashSet<>();
-        compile(contextsToCompilers.get(context), loader, extractedVariables, scriptName, scriptSource, params);
+        ScriptRoot scriptRoot = compile(contextsToCompilers.get(context), loader, extractedVariables, scriptName, scriptSource, params);
 
         if (context.statefulFactoryClazz != null) {
-            return generateFactory(loader, context, extractedVariables, generateStatefulFactory(loader, context, extractedVariables));
+            return generateFactory(loader, context, extractedVariables, generateStatefulFactory(loader, context, extractedVariables),
+                scriptRoot);
         } else {
-            return generateFactory(loader, context, extractedVariables, WriterConstants.CLASS_TYPE);
+            return generateFactory(loader, context, extractedVariables, WriterConstants.CLASS_TYPE, scriptRoot);
         }
     }
 
@@ -270,6 +271,7 @@ private <T extends ScriptFactory> Type generateStatefulFactory(
      * @param context The {@link ScriptContext}'s semantics are used to define the factory class.
      * @param classType The type to be instaniated in the newFactory or newInstance method.  Depends
      *                  on whether a {@link ScriptContext#statefulFactoryClazz} is specified.
+     * @param scriptRoot the {@link ScriptRoot} used to do the compilation
      * @param <T> The factory class.
      * @return A factory class that will return script instances.
      */
@@ -277,7 +279,8 @@ private <T extends ScriptFactory> T generateFactory(
         Loader loader,
         ScriptContext<T> context,
         Set<String> extractedVariables,
-        Type classType
+        Type classType,
+        ScriptRoot scriptRoot
     ) {
         int classFrames = ClassWriter.COMPUTE_FRAMES | ClassWriter.COMPUTE_MAXS;
         int classAccess = Opcodes.ACC_PUBLIC | Opcodes.ACC_SUPER| Opcodes.ACC_FINAL;
@@ -330,8 +333,19 @@ private <T extends ScriptFactory> T generateFactory(
         adapter.endMethod();
 
         writeNeedsMethods(context.factoryClazz, writer, extractedVariables);
-        writer.visitEnd();
 
+        String methodName = "isResultDeterministic";
+        org.objectweb.asm.commons.Method isResultDeterministic = new org.objectweb.asm.commons.Method(methodName,
+            MethodType.methodType(boolean.class).toMethodDescriptorString());
+
+        GeneratorAdapter deterAdapter = new GeneratorAdapter(Opcodes.ASM5, isResultDeterministic,
+            writer.visitMethod(Opcodes.ACC_PUBLIC, methodName, isResultDeterministic.getDescriptor(), null, null));
+        deterAdapter.visitCode();
+        deterAdapter.push(scriptRoot.deterministic);
+        deterAdapter.returnValue();
+        deterAdapter.endMethod();
+
+        writer.visitEnd();
         Class<?> factory = loader.defineFactory(className.replace('/', '.'), writer.toByteArray());
 
         try {
@@ -364,19 +378,17 @@ private void writeNeedsMethods(Class<?> clazz, ClassWriter writer, Set<String> e
         }
     }
 
-    void compile(Compiler compiler, Loader loader, Set<String> extractedVariables,
+    ScriptRoot compile(Compiler compiler, Loader loader, Set<String> extractedVariables,
                  String scriptName, String source, Map<String, String> params) {
         final CompilerSettings compilerSettings = buildCompilerSettings(params);
 
         try {
             // Drop all permissions to actually compile the code itself.
-            AccessController.doPrivileged(new PrivilegedAction<Void>() {
+            return AccessController.doPrivileged(new PrivilegedAction<ScriptRoot>() {
                 @Override
-                public Void run() {
+                public ScriptRoot run() {
                     String name = scriptName == null ? source : scriptName;
-                    compiler.compile(loader, extractedVariables, name, source, compilerSettings);
-
-                    return null;
+                    return compiler.compile(loader, extractedVariables, name, source, compilerSettings);
                 }
             }, COMPILATION_CONTEXT);
             // Note that it is safe to catch any of the following errors since Painless is stateless.
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/ScriptRoot.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/ScriptRoot.java
index 72d5e50a8a6ae..775da59795b94 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/ScriptRoot.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/ScriptRoot.java
@@ -38,6 +38,7 @@ public class ScriptRoot {
 
     protected final FunctionTable functionTable = new FunctionTable();
     protected int syntheticCounter = 0;
+    protected boolean deterministic = true;
 
     public ScriptRoot(PainlessLookup painlessLookup, CompilerSettings compilerSettings, ScriptClassInfo scriptClassInfo, SClass classRoot) {
         this.painlessLookup = Objects.requireNonNull(painlessLookup);
@@ -72,4 +73,6 @@ public FunctionTable getFunctionTable() {
     public String getNextSyntheticName(String prefix) {
         return prefix + "$synthetic$" + syntheticCounter++;
     }
+
+    public void markNonDeterministic(boolean nondeterministic) { this.deterministic &= !nondeterministic; }
 }
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessClassBinding.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessClassBinding.java
index aedbc936bb1d4..971c39d3fe617 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessClassBinding.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessClassBinding.java
@@ -22,6 +22,7 @@
 import java.lang.reflect.Constructor;
 import java.lang.reflect.Method;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
 
 public class PainlessClassBinding {
@@ -31,13 +32,16 @@ public class PainlessClassBinding {
 
     public final Class<?> returnType;
     public final List<Class<?>> typeParameters;
+    public final Map<Class<?>, Object> annotations;
 
-    PainlessClassBinding(Constructor<?> javaConstructor, Method javaMethod, Class<?> returnType, List<Class<?>> typeParameters) {
+    PainlessClassBinding(Constructor<?> javaConstructor, Method javaMethod, Class<?> returnType, List<Class<?>> typeParameters,
+        Map<Class<?>, Object> annotations) {
         this.javaConstructor = javaConstructor;
         this.javaMethod = javaMethod;
 
         this.returnType = returnType;
         this.typeParameters = typeParameters;
+        this.annotations = annotations;
     }
 
     @Override
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessConstructor.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessConstructor.java
index 0f890e88b736b..b9b7a65925c24 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessConstructor.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessConstructor.java
@@ -23,6 +23,7 @@
 import java.lang.invoke.MethodType;
 import java.lang.reflect.Constructor;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
 
 public class PainlessConstructor {
@@ -31,12 +32,15 @@ public class PainlessConstructor {
     public final List<Class<?>> typeParameters;
     public final MethodHandle methodHandle;
     public final MethodType methodType;
+    public final Map<Class<?>, Object> annotations;
 
-    PainlessConstructor(Constructor<?> javaConstructor, List<Class<?>> typeParameters, MethodHandle methodHandle, MethodType methodType) {
+    PainlessConstructor(Constructor<?> javaConstructor, List<Class<?>> typeParameters, MethodHandle methodHandle, MethodType methodType,
+            Map<Class<?>, Object> annotations) {
         this.javaConstructor = javaConstructor;
         this.typeParameters = typeParameters;
         this.methodHandle = methodHandle;
         this.methodType = methodType;
+        this.annotations = annotations;
     }
 
     @Override
@@ -53,11 +57,12 @@ public boolean equals(Object object) {
 
         return Objects.equals(javaConstructor, that.javaConstructor) &&
                 Objects.equals(typeParameters, that.typeParameters) &&
-                Objects.equals(methodType, that.methodType);
+                Objects.equals(methodType, that.methodType) &&
+                Objects.equals(annotations, that.annotations);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(javaConstructor, typeParameters, methodType);
+        return Objects.hash(javaConstructor, typeParameters, methodType, annotations);
     }
 }
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessLookupBuilder.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessLookupBuilder.java
index cad8bcc9a1c34..2e687b481bbc5 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessLookupBuilder.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessLookupBuilder.java
@@ -50,6 +50,7 @@
 import java.security.SecureClassLoader;
 import java.security.cert.Certificate;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -132,7 +133,8 @@ public static PainlessLookup buildFromWhitelists(List<Whitelist> whitelists) {
                     for (WhitelistConstructor whitelistConstructor : whitelistClass.whitelistConstructors) {
                         origin = whitelistConstructor.origin;
                         painlessLookupBuilder.addPainlessConstructor(
-                                targetCanonicalClassName, whitelistConstructor.canonicalTypeNameParameters);
+                                targetCanonicalClassName, whitelistConstructor.canonicalTypeNameParameters,
+                                whitelistConstructor.painlessAnnotations);
                     }
 
                     for (WhitelistMethod whitelistMethod : whitelistClass.whitelistMethods) {
@@ -140,7 +142,7 @@ public static PainlessLookup buildFromWhitelists(List<Whitelist> whitelists) {
                         painlessLookupBuilder.addPainlessMethod(
                                 whitelist.classLoader, targetCanonicalClassName, whitelistMethod.augmentedCanonicalClassName,
                                 whitelistMethod.methodName, whitelistMethod.returnCanonicalTypeName,
-                                whitelistMethod.canonicalTypeNameParameters);
+                                whitelistMethod.canonicalTypeNameParameters, whitelistMethod.painlessAnnotations);
                     }
 
                     for (WhitelistField whitelistField : whitelistClass.whitelistFields) {
@@ -155,14 +157,16 @@ public static PainlessLookup buildFromWhitelists(List<Whitelist> whitelists) {
                     painlessLookupBuilder.addImportedPainlessMethod(
                             whitelist.classLoader, whitelistStatic.augmentedCanonicalClassName,
                             whitelistStatic.methodName, whitelistStatic.returnCanonicalTypeName,
-                            whitelistStatic.canonicalTypeNameParameters);
+                            whitelistStatic.canonicalTypeNameParameters,
+                            whitelistStatic.painlessAnnotations);
                 }
 
                 for (WhitelistClassBinding whitelistClassBinding : whitelist.whitelistClassBindings) {
                     origin = whitelistClassBinding.origin;
                     painlessLookupBuilder.addPainlessClassBinding(
                             whitelist.classLoader, whitelistClassBinding.targetJavaClassName, whitelistClassBinding.methodName,
-                            whitelistClassBinding.returnCanonicalTypeName, whitelistClassBinding.canonicalTypeNameParameters);
+                            whitelistClassBinding.returnCanonicalTypeName, whitelistClassBinding.canonicalTypeNameParameters,
+                            whitelistClassBinding.painlessAnnotations);
                 }
 
                 for (WhitelistInstanceBinding whitelistInstanceBinding : whitelist.whitelistInstanceBindings) {
@@ -313,7 +317,8 @@ public void addPainlessClass(Class<?> clazz, boolean importClassName) {
         }
     }
 
-    public void addPainlessConstructor(String targetCanonicalClassName, List<String> canonicalTypeNameParameters) {
+    public void addPainlessConstructor(String targetCanonicalClassName, List<String> canonicalTypeNameParameters,
+            Map<Class<?>, Object> annotations) {
         Objects.requireNonNull(targetCanonicalClassName);
         Objects.requireNonNull(canonicalTypeNameParameters);
 
@@ -337,10 +342,10 @@ public void addPainlessConstructor(String targetCanonicalClassName, List<String>
             typeParameters.add(typeParameter);
         }
 
-        addPainlessConstructor(targetClass, typeParameters);
+        addPainlessConstructor(targetClass, typeParameters, annotations);
     }
 
-    public void addPainlessConstructor(Class<?> targetClass, List<Class<?>> typeParameters) {
+    public void addPainlessConstructor(Class<?> targetClass, List<Class<?>> typeParameters, Map<Class<?>, Object> annotations) {
         Objects.requireNonNull(targetClass);
         Objects.requireNonNull(typeParameters);
 
@@ -390,7 +395,8 @@ public void addPainlessConstructor(Class<?> targetClass, List<Class<?>> typePara
 
         String painlessConstructorKey = buildPainlessConstructorKey(typeParametersSize);
         PainlessConstructor existingPainlessConstructor = painlessClassBuilder.constructors.get(painlessConstructorKey);
-        PainlessConstructor newPainlessConstructor = new PainlessConstructor(javaConstructor, typeParameters, methodHandle, methodType);
+        PainlessConstructor newPainlessConstructor = new PainlessConstructor(javaConstructor, typeParameters, methodHandle, methodType,
+            annotations);
 
         if (existingPainlessConstructor == null) {
             newPainlessConstructor = painlessConstructorCache.computeIfAbsent(newPainlessConstructor, key -> key);
@@ -403,7 +409,8 @@ public void addPainlessConstructor(Class<?> targetClass, List<Class<?>> typePara
     }
 
     public void addPainlessMethod(ClassLoader classLoader, String targetCanonicalClassName, String augmentedCanonicalClassName,
-            String methodName, String returnCanonicalTypeName, List<String> canonicalTypeNameParameters) {
+            String methodName, String returnCanonicalTypeName, List<String> canonicalTypeNameParameters,
+            Map<Class<?>, Object> annotations) {
 
         Objects.requireNonNull(classLoader);
         Objects.requireNonNull(targetCanonicalClassName);
@@ -449,11 +456,11 @@ public void addPainlessMethod(ClassLoader classLoader, String targetCanonicalCla
                     "[[" + targetCanonicalClassName + "], [" + methodName + "], " + canonicalTypeNameParameters + "]");
         }
 
-        addPainlessMethod(targetClass, augmentedClass, methodName, returnType, typeParameters);
+        addPainlessMethod(targetClass, augmentedClass, methodName, returnType, typeParameters, annotations);
     }
 
     public void addPainlessMethod(Class<?> targetClass, Class<?> augmentedClass,
-            String methodName, Class<?> returnType, List<Class<?>> typeParameters) {
+            String methodName, Class<?> returnType, List<Class<?>> typeParameters, Map<Class<?>, Object> annotations) {
 
         Objects.requireNonNull(targetClass);
         Objects.requireNonNull(methodName);
@@ -562,7 +569,7 @@ public void addPainlessMethod(Class<?> targetClass, Class<?> augmentedClass,
                 painlessClassBuilder.staticMethods.get(painlessMethodKey) :
                 painlessClassBuilder.methods.get(painlessMethodKey);
         PainlessMethod newPainlessMethod =
-                new PainlessMethod(javaMethod, targetClass, returnType, typeParameters, methodHandle, methodType);
+                new PainlessMethod(javaMethod, targetClass, returnType, typeParameters, methodHandle, methodType, annotations);
 
         if (existingPainlessMethod == null) {
             newPainlessMethod = painlessMethodCache.computeIfAbsent(newPainlessMethod, key -> key);
@@ -708,7 +715,8 @@ public void addPainlessField(Class<?> targetClass, String fieldName, Class<?> ty
     }
 
     public void addImportedPainlessMethod(ClassLoader classLoader, String targetJavaClassName,
-            String methodName, String returnCanonicalTypeName, List<String> canonicalTypeNameParameters) {
+            String methodName, String returnCanonicalTypeName, List<String> canonicalTypeNameParameters,
+            Map<Class<?>, Object> annotations) {
 
         Objects.requireNonNull(classLoader);
         Objects.requireNonNull(targetJavaClassName);
@@ -751,10 +759,11 @@ public void addImportedPainlessMethod(ClassLoader classLoader, String targetJava
                     "[[" + targetCanonicalClassName + "], [" + methodName + "], " + canonicalTypeNameParameters + "]");
         }
 
-        addImportedPainlessMethod(targetClass, methodName, returnType, typeParameters);
+        addImportedPainlessMethod(targetClass, methodName, returnType, typeParameters, annotations);
     }
 
-    public void addImportedPainlessMethod(Class<?> targetClass, String methodName, Class<?> returnType, List<Class<?>> typeParameters) {
+    public void addImportedPainlessMethod(Class<?> targetClass, String methodName, Class<?> returnType, List<Class<?>> typeParameters,
+            Map<Class<?>, Object> annotations) {
         Objects.requireNonNull(targetClass);
         Objects.requireNonNull(methodName);
         Objects.requireNonNull(returnType);
@@ -841,7 +850,7 @@ public void addImportedPainlessMethod(Class<?> targetClass, String methodName, C
 
         PainlessMethod existingImportedPainlessMethod = painlessMethodKeysToImportedPainlessMethods.get(painlessMethodKey);
         PainlessMethod newImportedPainlessMethod =
-                new PainlessMethod(javaMethod, targetClass, returnType, typeParameters, methodHandle, methodType);
+                new PainlessMethod(javaMethod, targetClass, returnType, typeParameters, methodHandle, methodType, annotations);
 
         if (existingImportedPainlessMethod == null) {
             newImportedPainlessMethod = painlessMethodCache.computeIfAbsent(newImportedPainlessMethod, key -> key);
@@ -859,7 +868,8 @@ public void addImportedPainlessMethod(Class<?> targetClass, String methodName, C
     }
 
     public void addPainlessClassBinding(ClassLoader classLoader, String targetJavaClassName,
-            String methodName, String returnCanonicalTypeName, List<String> canonicalTypeNameParameters) {
+            String methodName, String returnCanonicalTypeName, List<String> canonicalTypeNameParameters,
+            Map<Class<?>, Object> annotations) {
 
         Objects.requireNonNull(classLoader);
         Objects.requireNonNull(targetJavaClassName);
@@ -896,10 +906,11 @@ public void addPainlessClassBinding(ClassLoader classLoader, String targetJavaCl
                     "[[" + targetCanonicalClassName + "], [" + methodName + "], " + canonicalTypeNameParameters + "]");
         }
 
-        addPainlessClassBinding(targetClass, methodName, returnType, typeParameters);
+        addPainlessClassBinding(targetClass, methodName, returnType, typeParameters, annotations);
     }
 
-    public void addPainlessClassBinding(Class<?> targetClass, String methodName, Class<?> returnType, List<Class<?>> typeParameters) {
+    public void addPainlessClassBinding(Class<?> targetClass, String methodName, Class<?> returnType, List<Class<?>> typeParameters,
+            Map<Class<?>, Object> annotations) {
         Objects.requireNonNull(targetClass);
         Objects.requireNonNull(methodName);
         Objects.requireNonNull(returnType);
@@ -1036,7 +1047,7 @@ public void addPainlessClassBinding(Class<?> targetClass, String methodName, Cla
 
         PainlessClassBinding existingPainlessClassBinding = painlessMethodKeysToPainlessClassBindings.get(painlessMethodKey);
         PainlessClassBinding newPainlessClassBinding =
-                new PainlessClassBinding(javaConstructor, javaMethod, returnType, typeParameters);
+                new PainlessClassBinding(javaConstructor, javaMethod, returnType, typeParameters, annotations);
 
         if (existingPainlessClassBinding == null) {
             newPainlessClassBinding = painlessClassBindingCache.computeIfAbsent(newPainlessClassBinding, key -> key);
@@ -1444,7 +1455,7 @@ public BridgeLoader run() {
                         painlessMethod.javaMethod.getName(), bridgeTypeParameters.toArray(new Class<?>[0]));
                 MethodHandle bridgeHandle = MethodHandles.publicLookup().in(bridgeClass).unreflect(bridgeClass.getMethods()[0]);
                 bridgePainlessMethod = new PainlessMethod(bridgeMethod, bridgeClass,
-                        painlessMethod.returnType, bridgeTypeParameters, bridgeHandle, bridgeMethodType);
+                        painlessMethod.returnType, bridgeTypeParameters, bridgeHandle, bridgeMethodType, Collections.emptyMap());
                 painlessClassBuilder.runtimeMethods.put(painlessMethodKey.intern(), bridgePainlessMethod);
                 painlessBridgeCache.put(painlessMethod, bridgePainlessMethod);
             } catch (Exception exception) {
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessMethod.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessMethod.java
index 358449c36f3e5..6e84f5b28e77e 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessMethod.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/lookup/PainlessMethod.java
@@ -23,6 +23,7 @@
 import java.lang.invoke.MethodType;
 import java.lang.reflect.Method;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
 
 public class PainlessMethod {
@@ -33,9 +34,10 @@ public class PainlessMethod {
     public final List<Class<?>> typeParameters;
     public final MethodHandle methodHandle;
     public final MethodType methodType;
+    public final Map<Class<?>, Object> annotations;
 
     public PainlessMethod(Method javaMethod, Class<?> targetClass, Class<?> returnType, List<Class<?>> typeParameters,
-            MethodHandle methodHandle, MethodType methodType) {
+            MethodHandle methodHandle, MethodType methodType, Map<Class<?>, Object> annotations) {
 
         this.javaMethod = javaMethod;
         this.targetClass = targetClass;
@@ -43,6 +45,7 @@ public PainlessMethod(Method javaMethod, Class<?> targetClass, Class<?> returnTy
         this.typeParameters = List.copyOf(typeParameters);
         this.methodHandle = methodHandle;
         this.methodType = methodType;
+        this.annotations = annotations;
     }
 
     @Override
@@ -61,11 +64,12 @@ public boolean equals(Object object) {
                 Objects.equals(targetClass, that.targetClass) &&
                 Objects.equals(returnType, that.returnType) &&
                 Objects.equals(typeParameters, that.typeParameters) &&
-                Objects.equals(methodType, that.methodType);
+                Objects.equals(methodType, that.methodType) &&
+                Objects.equals(annotations, that.annotations);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(javaMethod, targetClass, returnType, typeParameters, methodType);
+        return Objects.hash(javaMethod, targetClass, returnType, typeParameters, methodType, annotations);
     }
 }
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECallLocal.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECallLocal.java
index e386f94d01b69..b96782f14855f 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECallLocal.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECallLocal.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.painless.lookup.PainlessClassBinding;
 import org.elasticsearch.painless.lookup.PainlessInstanceBinding;
 import org.elasticsearch.painless.lookup.PainlessMethod;
+import org.elasticsearch.painless.spi.annotation.NonDeterministicAnnotation;
 import org.elasticsearch.painless.symbol.FunctionTable;
 import org.objectweb.asm.Label;
 import org.objectweb.asm.Type;
@@ -127,9 +128,11 @@ void analyze(ScriptRoot scriptRoot, Locals locals) {
             typeParameters = new ArrayList<>(localFunction.getTypeParameters());
             actual = localFunction.getReturnType();
         } else if (importedMethod != null) {
+            scriptRoot.markNonDeterministic(importedMethod.annotations.containsKey(NonDeterministicAnnotation.class));
             typeParameters = new ArrayList<>(importedMethod.typeParameters);
             actual = importedMethod.returnType;
         } else if (classBinding != null) {
+            scriptRoot.markNonDeterministic(classBinding.annotations.containsKey(NonDeterministicAnnotation.class));
             typeParameters = new ArrayList<>(classBinding.typeParameters);
             actual = classBinding.returnType;
             bindingName = scriptRoot.getNextSyntheticName("class_binding");
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECapturingFunctionRef.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECapturingFunctionRef.java
index 00f2283472e49..dd76ddc6d0974 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECapturingFunctionRef.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECapturingFunctionRef.java
@@ -37,7 +37,7 @@
 import java.util.Set;
 
 /**
- * Represents a capturing function reference.
+ * Represents a capturing function reference.  For member functions that require a this reference, ie not static.
  */
 public final class ECapturingFunctionRef extends AExpression implements ILambda {
     private final String variable;
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECast.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECast.java
index d33f37fb6049b..0e50368bf7c3b 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECast.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ECast.java
@@ -32,7 +32,7 @@
 import java.util.Set;
 
 /**
- * Represents a cast that is inserted into the tree replacing other casts.  (Internal only.)
+ * Represents a cast that is inserted into the tree replacing other casts.  (Internal only.)  Casts are inserted during semantic checking.
  */
 final class ECast extends AExpression {
 
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewObj.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewObj.java
index 5f17cd9696473..0bc5b751f8831 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewObj.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/ENewObj.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.painless.ScriptRoot;
 import org.elasticsearch.painless.lookup.PainlessConstructor;
 import org.elasticsearch.painless.lookup.PainlessLookupUtility;
+import org.elasticsearch.painless.spi.annotation.NonDeterministicAnnotation;
 import org.objectweb.asm.Type;
 import org.objectweb.asm.commons.Method;
 
@@ -75,6 +76,8 @@ void analyze(ScriptRoot scriptRoot, Locals locals) {
                     "constructor [" + typeToCanonicalTypeName(actual) + ", <init>/" + arguments.size() + "] not found"));
         }
 
+        scriptRoot.markNonDeterministic(constructor.annotations.containsKey(NonDeterministicAnnotation.class));
+
         Class<?>[] types = new Class<?>[constructor.typeParameters.size()];
         constructor.typeParameters.toArray(types);
 
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PCallInvoke.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PCallInvoke.java
index 47bd54c288640..e71f70d632579 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PCallInvoke.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/PCallInvoke.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.painless.ScriptRoot;
 import org.elasticsearch.painless.lookup.PainlessMethod;
 import org.elasticsearch.painless.lookup.def;
+import org.elasticsearch.painless.spi.annotation.NonDeterministicAnnotation;
 
 import java.util.List;
 import java.util.Objects;
@@ -79,6 +80,8 @@ void analyze(ScriptRoot scriptRoot, Locals locals) {
                         "method [" + typeToCanonicalTypeName(prefix.actual) + ", " + name + "/" + arguments.size() + "] not found"));
             }
 
+            scriptRoot.markNonDeterministic(method.annotations.containsKey(NonDeterministicAnnotation.class));
+
             sub = new PSubCallInvoke(location, method, prefix.actual, arguments);
         }
 
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SClass.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SClass.java
index 356f56d7cf491..7145a4a9e33ad 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SClass.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/node/SClass.java
@@ -130,7 +130,7 @@ public void extractVariables(Set<String> variables) {
         extractedVariables.addAll(variables);
     }
 
-    public void analyze(PainlessLookup painlessLookup, CompilerSettings settings) {
+    public ScriptRoot analyze(PainlessLookup painlessLookup, CompilerSettings settings) {
         this.settings = settings;
         table = new ScriptRoot(painlessLookup, settings, scriptClassInfo, this);
 
@@ -148,6 +148,7 @@ public void analyze(PainlessLookup painlessLookup, CompilerSettings settings) {
 
         Locals locals = Locals.newProgramScope();
         analyze(table, locals);
+        return table;
     }
 
     @Override
diff --git a/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.lang.txt b/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.lang.txt
index 63ed6d41c676d..b900f62d7fe98 100644
--- a/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.lang.txt
+++ b/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.lang.txt
@@ -636,7 +636,7 @@ class java.lang.Math {
   double nextDown(double)
   double nextUp(double)
   double pow(double,double)
-  double random()
+  double random() @nondeterministic
   double rint(double)
   long round(double)
   double scalb(double,int)
@@ -729,7 +729,7 @@ class java.lang.StrictMath {
   double nextDown(double)
   double nextUp(double)
   double pow(double,double)
-  double random()
+  double random() @nondeterministic
   double rint(double)
   long round(double)
   double scalb(double,int)
@@ -844,8 +844,8 @@ class java.lang.StringBuilder {
 
 class java.lang.System {
   void arraycopy(Object,int,Object,int,int)
-  long currentTimeMillis()
-  long nanoTime()
+  long currentTimeMillis() @nondeterministic
+  long nanoTime() @nondeterministic
 }
 
 # Thread: skipped
diff --git a/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.time.txt b/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.time.txt
index 0cedc849a6838..38c6e8a4f575e 100644
--- a/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.time.txt
+++ b/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.time.txt
@@ -26,11 +26,11 @@
 
 class java.time.Clock {
   Clock fixed(Instant,ZoneId)
-  ZoneId getZone()
-  Instant instant()
-  long millis()
-  Clock offset(Clock,Duration)
-  Clock tick(Clock,Duration)
+  ZoneId getZone() @nondeterministic
+  Instant instant() @nondeterministic
+  long millis() @nondeterministic
+  Clock offset(Clock,Duration) @nondeterministic
+  Clock tick(Clock,Duration) @nondeterministic
 }
 
 class java.time.Duration {
diff --git a/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.util.txt b/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.util.txt
index e7cc5bb7db463..12da1f679422c 100644
--- a/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.util.txt
+++ b/modules/lang-painless/src/main/resources/org/elasticsearch/painless/spi/java.util.txt
@@ -490,9 +490,9 @@ class java.util.Calendar {
   Map getDisplayNames(int,int,Locale)
   int getFirstDayOfWeek()
   int getGreatestMinimum(int)
-  Calendar getInstance()
-  Calendar getInstance(TimeZone)
-  Calendar getInstance(TimeZone,Locale)
+  Calendar getInstance() @nondeterministic
+  Calendar getInstance(TimeZone) @nondeterministic
+  Calendar getInstance(TimeZone,Locale) @nondeterministic
   int getLeastMaximum(int)
   int getMaximum(int)
   int getMinimalDaysInFirstWeek()
@@ -574,7 +574,7 @@ class java.util.Collections {
   Comparator reverseOrder()
   Comparator reverseOrder(Comparator)
   void rotate(List,int)
-  void shuffle(List)
+  void shuffle(List) @nondeterministic
   void shuffle(List,Random)
   Set singleton(def)
   List singletonList(def)
@@ -605,7 +605,7 @@ class java.util.Currency {
 }
 
 class java.util.Date {
-  ()
+  () @nondeterministic
   (long)
   boolean after(Date)
   boolean before(Date)
@@ -910,22 +910,22 @@ class java.util.PriorityQueue {
 }
 
 class java.util.Random {
-  ()
+  () @nondeterministic
   (long)
-  DoubleStream doubles(long)
-  DoubleStream doubles(long,double,double)
-  IntStream ints(long)
-  IntStream ints(long,int,int)
-  LongStream longs(long)
-  LongStream longs(long,long,long)
-  boolean nextBoolean()
-  void nextBytes(byte[])
-  double nextDouble()
-  float nextFloat()
-  double nextGaussian()
-  int nextInt()
-  int nextInt(int)
-  long nextLong()
+  DoubleStream doubles(long) @nondeterministic
+  DoubleStream doubles(long,double,double) @nondeterministic
+  IntStream ints(long) @nondeterministic
+  IntStream ints(long,int,int) @nondeterministic
+  LongStream longs(long) @nondeterministic
+  LongStream longs(long,long,long) @nondeterministic
+  boolean nextBoolean() @nondeterministic
+  void nextBytes(byte[]) @nondeterministic
+  double nextDouble() @nondeterministic
+  float nextFloat() @nondeterministic
+  double nextGaussian() @nondeterministic
+  int nextInt() @nondeterministic
+  int nextInt(int) @nondeterministic
+  long nextLong() @nondeterministic
   void setSeed(long)
 }
 
@@ -1031,7 +1031,7 @@ class java.util.UUID {
   UUID fromString(String)
   long getLeastSignificantBits()
   long getMostSignificantBits()
-  UUID randomUUID()
+  UUID randomUUID() @nondeterministic
   UUID nameUUIDFromBytes(byte[])
   long node()
   long timestamp()
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
index 1d3fd829d2512..33645e24c0b3c 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
@@ -162,6 +162,32 @@ public void testFactory() {
         assertEquals(false, factory.needsNothing());
     }
 
+    public void testDeterministic() {
+        FactoryTestScript.Factory factory =
+            scriptEngine.compile("deterministic_test", "Integer.parseInt('123')",
+                FactoryTestScript.CONTEXT, Collections.emptyMap());
+        assertTrue(factory.isResultDeterministic());
+        assertEquals(123, factory.newInstance(Collections.emptyMap()).execute(0));
+    }
+
+    public void testNotDeterministic() {
+        FactoryTestScript.Factory factory =
+            scriptEngine.compile("not_deterministic_test", "Math.random()",
+                FactoryTestScript.CONTEXT, Collections.emptyMap());
+        assertFalse(factory.isResultDeterministic());
+        Double d = (Double)factory.newInstance(Collections.emptyMap()).execute(0);
+        assertTrue(d >= 0.0 && d <= 1.0);
+    }
+
+    public void testMixedDeterministicIsNotDeterministic() {
+        FactoryTestScript.Factory factory =
+            scriptEngine.compile("not_deterministic_test", "Integer.parseInt('123') + Math.random()",
+                FactoryTestScript.CONTEXT, Collections.emptyMap());
+        assertFalse(factory.isResultDeterministic());
+        Double d = (Double)factory.newInstance(Collections.emptyMap()).execute(0);
+        assertTrue(d >= 123.0 && d <= 124.0);
+    }
+
     public abstract static class EmptyTestScript {
         public static final String[] PARAMETERS = {};
         public abstract Object execute();
diff --git a/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java b/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
index 88a8351790c0a..56161d8f2fa34 100644
--- a/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
+++ b/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
@@ -325,6 +325,8 @@ public Index index() {
     /** Compile script using script service */
     public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
         FactoryType factory = scriptService.compile(script, context);
+        // TODO(stu): can check `factory instanceof ScriptFactory && ((ScriptFactory) factory).isResultDeterministic() == false`
+        // to avoid being so intrusive
         if (factory.isResultDeterministic() == false) {
             failIfFrozen();
         }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/support/MultiValuesSourceFieldConfig.java b/server/src/main/java/org/elasticsearch/search/aggregations/support/MultiValuesSourceFieldConfig.java
index 54baba9b6b7e5..a7412f10ceccb 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/support/MultiValuesSourceFieldConfig.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/support/MultiValuesSourceFieldConfig.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.search.aggregations.support;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -80,7 +81,11 @@ private MultiValuesSourceFieldConfig(String fieldName, Object missing, Script sc
     }
 
     public MultiValuesSourceFieldConfig(StreamInput in) throws IOException {
-        this.fieldName = in.readString();
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
+            this.fieldName = in.readOptionalString();
+        } else {
+            this.fieldName = in.readString();
+        }
         this.missing = in.readGenericValue();
         this.script = in.readOptionalWriteable(Script::new);
         this.timeZone = in.readOptionalZoneId();
@@ -104,7 +109,11 @@ public String getFieldName() {
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
-        out.writeString(fieldName);
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
+            out.writeOptionalString(fieldName);
+        } else {
+            out.writeString(fieldName);
+        }
         out.writeGenericValue(missing);
         out.writeOptionalWriteable(script);
         out.writeOptionalZoneId(timeZone);
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/AggregationTestScriptsPlugin.java b/server/src/test/java/org/elasticsearch/search/aggregations/AggregationTestScriptsPlugin.java
index 5d71176e79820..873dd89bdcfd1 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/AggregationTestScriptsPlugin.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/AggregationTestScriptsPlugin.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.script.MockScriptPlugin;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptType;
+import org.elasticsearch.test.ESTestCase;
 
 import java.util.HashMap;
 import java.util.Map;
@@ -116,4 +117,13 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
 
         return scripts;
     }
+
+    @Override
+    protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+        Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+        scripts.put("Math.random()", vars -> ESTestCase.randomDouble());
+
+        return scripts;
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
index dbf527aa6811a..0dceff9d0f0d1 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
@@ -1466,10 +1466,10 @@ public void testDSTEndTransition() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=date")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -1484,10 +1484,21 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         Map<String, Object> params = new HashMap<>();
         params.put("fieldname", "d");
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(dateHistogram("histo").field("d")
+            .script(new Script(ScriptType.INLINE, "mockscript", DateScriptMocksPlugin.CURRENT_DATE, params))
+            .dateHistogramInterval(DateHistogramInterval.MONTH)).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getMissCount(), equalTo(0L));
+
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(dateHistogram("histo").field("d")
                 .script(new Script(ScriptType.INLINE, "mockscript", DateScriptMocksPlugin.LONG_PLUS_ONE_MONTH, params))
                 .dateHistogramInterval(DateHistogramInterval.MONTH)).get();
         assertSearchResponse(r);
@@ -1495,10 +1506,9 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(0L));
+                .getMissCount(), equalTo(1L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
+        // Ensure that non-scripted requests are cached as normal
         r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(dateHistogram("histo").field("d").dateHistogramInterval(DateHistogramInterval.MONTH)).get();
         assertSearchResponse(r);
@@ -1506,7 +1516,7 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(1L));
+                .getMissCount(), equalTo(2L));
     }
 
     public void testSingleValuedFieldOrderedBySingleValueSubAggregationAscAndKeyDesc() throws Exception {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateRangeIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateRangeIT.java
index 820ea3786508c..4b6bdf96b891e 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateRangeIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateRangeIT.java
@@ -884,10 +884,10 @@ public void testNoRangesInQuery()  {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "date", "type=date")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -903,11 +903,11 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         Map<String, Object> params = new HashMap<>();
         params.put("fieldname", "date");
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(dateRange("foo").field("date")
-                .script(new Script(ScriptType.INLINE, "mockscript", DateScriptMocksPlugin.DOUBLE_PLUS_ONE_MONTH, params))
+                .script(new Script(ScriptType.INLINE, "mockscript", DateScriptMocksPlugin.CURRENT_DATE, params))
                 .addRange(ZonedDateTime.of(2012, 1, 1, 0, 0, 0, 0, ZoneOffset.UTC),
                     ZonedDateTime.of(2013, 1, 1, 0, 0, 0, 0, ZoneOffset.UTC)))
                 .get();
@@ -918,9 +918,9 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
+        // Test that a request using a deterministic script gets cached
         r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(dateRange("foo").field("date")
+                .script(new Script(ScriptType.INLINE, "mockscript", DateScriptMocksPlugin.DOUBLE_PLUS_ONE_MONTH, params))
                 .addRange(ZonedDateTime.of(2012, 1, 1, 0, 0, 0, 0, ZoneOffset.UTC),
                     ZonedDateTime.of(2013, 1, 1, 0, 0, 0, 0, ZoneOffset.UTC)))
                 .get();
@@ -930,6 +930,18 @@ public void testDontCacheScripts() throws Exception {
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(dateRange("foo").field("date")
+                .addRange(ZonedDateTime.of(2012, 1, 1, 0, 0, 0, 0, ZoneOffset.UTC),
+                    ZonedDateTime.of(2013, 1, 1, 0, 0, 0, 0, ZoneOffset.UTC)))
+                .get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 
     /**
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateScriptMocksPlugin.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateScriptMocksPlugin.java
index 1398961ced8af..07f7adf5e8446 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateScriptMocksPlugin.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateScriptMocksPlugin.java
@@ -38,6 +38,7 @@ public class DateScriptMocksPlugin extends MockScriptPlugin {
     static final String EXTRACT_FIELD = "extract_field";
     static final String DOUBLE_PLUS_ONE_MONTH = "double_date_plus_1_month";
     static final String LONG_PLUS_ONE_MONTH = "long_date_plus_1_month";
+    static final String CURRENT_DATE = "current_date";
 
     @Override
     public Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
@@ -53,4 +54,11 @@ public Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
             new DateTime((long) params.get("_value"), DateTimeZone.UTC).plusMonths(1).getMillis());
         return scripts;
     }
+
+    @Override
+    protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+        Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+        scripts.put(CURRENT_DATE, params -> new DateTime().getMillis());
+        return scripts;
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DoubleTermsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DoubleTermsIT.java
index e99931c62102b..c3a8c9b18d390 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DoubleTermsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DoubleTermsIT.java
@@ -112,6 +112,15 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
 
             return scripts;
         }
+
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+            scripts.put("Math.random()", vars -> DoubleTermsIT.randomDouble());
+
+            return scripts;
+        }
     }
 
     private static final int NUM_DOCS = 5; // TODO: randomize the size?
@@ -917,10 +926,10 @@ public void testOtherDocCount() {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=float")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -933,10 +942,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
                 terms("terms").field("d").script(
-                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value + 1", Collections.emptyMap()))).get();
+                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "Math.random()", Collections.emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
@@ -944,14 +953,24 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
+            terms("terms").field("d").script(
+                new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value + 1", Collections.emptyMap()))).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
         r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(terms("terms").field("d")).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(1L));
+                .getMissCount(), equalTo(2L));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/HistogramIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/HistogramIT.java
index f86aef40834af..f8c5390de54cd 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/HistogramIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/HistogramIT.java
@@ -110,6 +110,15 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
 
             return scripts;
         }
+
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+            scripts.put("Math.random()", vars -> HistogramIT.randomDouble());
+
+            return scripts;
+        }
     }
 
     @Override
@@ -1102,10 +1111,10 @@ public void testDecimalIntervalAndOffset() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=float")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -1118,9 +1127,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(histogram("histo").field("d")
-                .script(new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value + 1", emptyMap())).interval(0.7).offset(0.05)).get();
+                .script(new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "Math.random()", emptyMap())).interval(0.7).offset(0.05))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
@@ -1128,8 +1138,17 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(histogram("histo").field("d")
+                .script(new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value + 1", emptyMap())).interval(0.7).offset(0.05)).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
         r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(histogram("histo").field("d").interval(0.7).offset(0.05))
                 .get();
         assertSearchResponse(r);
@@ -1137,7 +1156,7 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(1L));
+                .getMissCount(), equalTo(2L));
     }
 
     public void testSingleValuedFieldOrderedBySingleValueSubAggregationAscAndKeyDesc() throws Exception {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/LongTermsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/LongTermsIT.java
index 1c0a5de546766..2d5d7d33aefdf 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/LongTermsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/LongTermsIT.java
@@ -99,6 +99,15 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
 
             return scripts;
         }
+
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+            scripts.put("Math.random()", vars -> LongTermsIT.randomDouble());
+
+            return scripts;
+        }
     }
 
     private static final int NUM_DOCS = 5; // TODO randomize the size?
@@ -894,10 +903,10 @@ public void testOtherDocCount() {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -910,10 +919,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
                 terms("terms").field("d").script(
-                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value + 1", Collections.emptyMap()))).get();
+                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "Math.random()", Collections.emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
@@ -921,14 +930,24 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(terms("terms").field("d")).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
+                terms("terms").field("d").script(
+                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value + 1", Collections.emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(terms("terms").field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/RangeIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/RangeIT.java
index f7a1ce30d1ed7..32e8516910ea8 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/RangeIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/RangeIT.java
@@ -92,6 +92,15 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
 
             return scripts;
         }
+
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+            scripts.put("Math.random()", vars -> RangeIT.randomDouble());
+
+            return scripts;
+        }
     }
 
     @Override
@@ -945,10 +954,10 @@ public void testEmptyAggregation() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "i", "type=integer")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -962,12 +971,12 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         Map<String, Object> params = new HashMap<>();
         params.put("fieldname", "date");
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
                 range("foo").field("i").script(
-                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value + 1", Collections.emptyMap())).addRange(0, 10))
+                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "Math.random()", Collections.emptyMap())).addRange(0, 10))
                 .get();
         assertSearchResponse(r);
 
@@ -976,15 +985,26 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(range("foo").field("i").addRange(0, 10)).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
+                range("foo").field("i").script(
+                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value + 1", Collections.emptyMap())).addRange(0, 10))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(range("foo").field("i").addRange(0, 10)).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 
     public void testFieldAlias() {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
index 2f231083c684d..80b67fe850d8d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
@@ -193,6 +193,15 @@ public Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
             return scripts;
         }
 
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+            scripts.put("Math.random()", vars -> SignificantTermsSignificanceScoreIT.randomDouble());
+
+            return scripts;
+        }
+
         private static long longValue(Object value) {
             return ((ScriptHeuristic.LongAccessor) value).longValue();
         }
@@ -678,10 +687,10 @@ public void testReduceFromSeveralShards() throws IOException, ExecutionException
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -694,8 +703,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
-        ScriptHeuristic scriptHeuristic = getScriptSignificanceHeuristic();
+        // Test that a request using a nondeterministic script does not get cached
+        ScriptHeuristic scriptHeuristic = new ScriptHeuristic(
+            new Script(ScriptType.INLINE, "mockscript", "Math.random()", Collections.emptyMap())
+        );
         boolean useSigText = randomBoolean();
         SearchResponse r;
         if (useSigText) {
@@ -712,12 +723,15 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
+        // Test that a request using a deterministic script gets cached
+        scriptHeuristic = getScriptSignificanceHeuristic();
+        useSigText = randomBoolean();
         if (useSigText) {
-            r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(significantText("foo", "s")).get();
+            r = client().prepareSearch("cache_test_idx").setSize(0)
+                    .addAggregation(significantText("foo", "s").significanceHeuristic(scriptHeuristic)).get();
         } else {
-            r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(significantTerms("foo").field("s")).get();
+            r = client().prepareSearch("cache_test_idx").setSize(0)
+                    .addAggregation(significantTerms("foo").field("s").significanceHeuristic(scriptHeuristic)).get();
         }
         assertSearchResponse(r);
 
@@ -725,8 +739,18 @@ public void testDontCacheScripts() throws Exception {
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
-    }
-
 
+        // Ensure that non-scripted requests are cached as normal
+        if (useSigText) {
+            r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(significantText("foo", "s")).get();
+        } else {
+            r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(significantTerms("foo").field("s")).get();
+        }
+        assertSearchResponse(r);
 
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/StringTermsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/StringTermsIT.java
index a748eb95bbf58..dda55c9e8f9df 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/StringTermsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/StringTermsIT.java
@@ -119,6 +119,15 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
 
             return scripts;
         }
+
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+            scripts.put("Math.random()", vars -> StringTermsIT.randomDouble());
+
+            return scripts;
+        }
     }
 
     @Override
@@ -1115,10 +1124,10 @@ public void testOtherDocCount() {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=keyword")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -1131,11 +1140,11 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(
                         terms("terms").field("d").script(
-                            new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "'foo_' + _value", Collections.emptyMap())))
+                            new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "Math.random()", Collections.emptyMap())))
                 .get();
         assertSearchResponse(r);
 
@@ -1144,14 +1153,26 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(terms("terms").field("d")).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(
+                        terms("terms").field("d").script(
+                            new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "'foo_' + _value", Collections.emptyMap())))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(terms("terms").field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/AvgAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/AvgAggregatorTests.java
index 4dfdfd2fd91ca..46f08d786a856 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/AvgAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/AvgAggregatorTests.java
@@ -83,6 +83,9 @@ public class AvgAggregatorTests extends AggregatorTestCase {
     /** Script to return the {@code _value} provided by aggs framework. */
     public static final String VALUE_SCRIPT = "_value";
 
+    /** Script to return a random double */
+    public static final String RANDOM_SCRIPT = "Math.random()";
+
     @Override
     protected ScriptService getMockScriptService() {
         Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
@@ -115,8 +118,12 @@ protected ScriptService getMockScriptService() {
             return ((Number) vars.get("_value")).doubleValue() + inc;
         });
 
+        Map<String, Function<Map<String, Object>, Object>> nonDeterministicScripts = new HashMap<>();
+        nonDeterministicScripts.put(RANDOM_SCRIPT, vars -> AvgAggregatorTests.randomDouble());
+
         MockScriptEngine scriptEngine = new MockScriptEngine(MockScriptEngine.NAME,
             scripts,
+            nonDeterministicScripts,
             Collections.emptyMap());
         Map<String, ScriptEngine> engines = Collections.singletonMap(scriptEngine.getType(), scriptEngine);
 
@@ -638,9 +645,10 @@ public void testCacheAggregation() throws IOException {
     }
 
     /**
-     * Make sure that an aggregation using a script does not get cached.
+     * Make sure that an aggregation using a deterministic script does gets cached while
+     * one using a nondeterministic script does not.
      */
-    public void testDontCacheScripts() throws IOException {
+    public void testScriptCaching() throws IOException {
         Directory directory = newDirectory();
         RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
         final int numDocs = 10;
@@ -675,7 +683,26 @@ public void testDontCacheScripts() throws IOException {
         assertEquals("avg", avg.getName());
         assertTrue(AggregationInspectionHelper.hasValue(avg));
 
-        // Test that an aggregation using a script does not get cached
+        // Test that an aggregation using a deterministic script gets cached
+        assertTrue(aggregator.context().getQueryShardContext().isCacheable());
+
+        aggregationBuilder = new AvgAggregationBuilder("avg")
+            .field("value")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, RANDOM_SCRIPT, Collections.emptyMap()));
+
+        aggregator = createAggregator(aggregationBuilder, indexSearcher, fieldType);
+        aggregator.preCollection();
+        indexSearcher.search(new MatchAllDocsQuery(), aggregator);
+        aggregator.postCollection();
+
+        avg = (InternalAvg) aggregator.buildAggregation(0L);
+
+        assertTrue(avg.getValue() >= 0.0);
+        assertTrue(avg.getValue() <= 1.0);
+        assertEquals("avg", avg.getName());
+        assertTrue(AggregationInspectionHelper.hasValue(avg));
+
+        // Test that an aggregation using a nondeterministic script does not get cached
         assertFalse(aggregator.context().getQueryShardContext().isCacheable());
 
         multiReader.close();
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
index 347ec478e19e0..b290d44a3e85d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
@@ -90,6 +90,15 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
 
             return scripts;
         }
+
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+            scripts.put("Math.random()", vars -> CardinalityIT.randomDouble());
+
+            return scripts;
+        }
     }
 
     @Override
@@ -449,10 +458,10 @@ public void testAsSubAgg() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -465,10 +474,11 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(
-                        cardinality("foo").field("d").script(new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value", emptyMap())))
+                        cardinality("foo").field("d").script(new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "Math.random()",
+                                                                              emptyMap())))
                 .get();
         assertSearchResponse(r);
 
@@ -477,14 +487,25 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(cardinality("foo").field("d")).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(
+                        cardinality("foo").field("d").script(new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "_value", emptyMap())))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(cardinality("foo").field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ExtendedStatsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ExtendedStatsIT.java
index 80a26ee9ebb2f..58967969d54a0 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ExtendedStatsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ExtendedStatsIT.java
@@ -639,10 +639,10 @@ private void checkUpperLowerBounds(ExtendedStats stats, double sigma) {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -655,10 +655,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(extendedStats("foo").field("d")
-                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value + 1", Collections.emptyMap())))
+                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "Math.random()", Collections.emptyMap())))
                 .get();
         assertSearchResponse(r);
 
@@ -667,15 +667,26 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(extendedStats("foo").field("d")).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(extendedStats("foo").field("d")
+                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value + 1", Collections.emptyMap())))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(extendedStats("foo").field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentileRanksIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentileRanksIT.java
index 7b7aef1b90b74..ae578208ae01b 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentileRanksIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentileRanksIT.java
@@ -558,10 +558,10 @@ public void testOrderByEmptyAggregation() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -574,12 +574,12 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client()
                 .prepareSearch("cache_test_idx").setSize(0)
                     .addAggregation(percentileRanks("foo", new double[]{50.0})
                         .method(PercentilesMethod.HDR).field("d")
-                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
+                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "Math.random()", emptyMap())))
                 .get();
         assertSearchResponse(r);
 
@@ -588,8 +588,21 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
+        // Test that a request using a deterministic script gets cached
+        r = client()
+                .prepareSearch("cache_test_idx").setSize(0)
+                    .addAggregation(percentileRanks("foo", new double[]{50.0})
+                        .method(PercentilesMethod.HDR).field("d")
+                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
+                .get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
         r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(percentileRanks("foo", new double[]{50.0}).method(PercentilesMethod.HDR).field("d")).get();
         assertSearchResponse(r);
@@ -597,7 +610,7 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(1L));
+                .getMissCount(), equalTo(2L));
     }
 
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentilesIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentilesIT.java
index 79f8ce4f829a6..05ffe4ddc4638 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentilesIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentilesIT.java
@@ -523,10 +523,10 @@ public void testOrderByEmptyAggregation() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -539,10 +539,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(percentiles("foo").method(PercentilesMethod.HDR).field("d").percentiles(50.0)
-                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
+                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "Math.random()", emptyMap())))
                 .get();
         assertSearchResponse(r);
 
@@ -551,16 +551,27 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
+        // Test that a request using a deterministic script gets cached
         r = client().prepareSearch("cache_test_idx").setSize(0)
-                .addAggregation(percentiles("foo").method(PercentilesMethod.HDR).field("d").percentiles(50.0)).get();
+                .addAggregation(percentiles("foo").method(PercentilesMethod.HDR).field("d").percentiles(50.0)
+                        .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(percentiles("foo").method(PercentilesMethod.HDR).field("d").percentiles(50.0)).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MaxAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MaxAggregatorTests.java
index 739419a534240..598d19795db20 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MaxAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MaxAggregatorTests.java
@@ -110,6 +110,9 @@ public class MaxAggregatorTests extends AggregatorTestCase {
     /** Script to return the {@code _value} provided by aggs framework. */
     public static final String VALUE_SCRIPT = "_value";
 
+    /** Script to return a random double */
+    public static final String RANDOM_SCRIPT = "Math.random()";
+
     @Override
     protected ScriptService getMockScriptService() {
         Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
@@ -143,8 +146,12 @@ protected ScriptService getMockScriptService() {
             return ((Number) vars.get("_value")).doubleValue() + inc;
         });
 
+        Map<String, Function<Map<String, Object>, Object>> nonDeterministicScripts = new HashMap<>();
+        nonDeterministicScripts.put(RANDOM_SCRIPT, vars -> MaxAggregatorTests.randomDouble());
+
         MockScriptEngine scriptEngine = new MockScriptEngine(MockScriptEngine.NAME,
             scripts,
+            nonDeterministicScripts,
             Collections.emptyMap());
         Map<String, ScriptEngine> engines = Collections.singletonMap(scriptEngine.getType(), scriptEngine);
 
@@ -948,9 +955,10 @@ public void testCacheAggregation() throws IOException {
     }
 
     /**
-     * Make sure that an aggregation using a script does not get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws IOException {
+    public void testScriptCaching() throws Exception {
         Directory directory = newDirectory();
         RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
         final int numDocs = 10;
@@ -968,7 +976,6 @@ public void testDontCacheScripts() throws IOException {
         MultiReader multiReader = new MultiReader(indexReader, unamappedIndexReader);
         IndexSearcher indexSearcher = newSearcher(multiReader, true, true);
 
-
         MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
         fieldType.setName("value");
         MaxAggregationBuilder aggregationBuilder = new MaxAggregationBuilder("max")
@@ -987,6 +994,24 @@ public void testDontCacheScripts() throws IOException {
         assertTrue(AggregationInspectionHelper.hasValue(max));
 
         // Test that an aggregation using a script does not get cached
+        assertTrue(aggregator.context().getQueryShardContext().isCacheable());
+        aggregationBuilder = new MaxAggregationBuilder("max")
+            .field("value")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, RANDOM_SCRIPT, Collections.emptyMap()));
+
+        aggregator = createAggregator(aggregationBuilder, indexSearcher, fieldType);
+        aggregator.preCollection();
+        indexSearcher.search(new MatchAllDocsQuery(), aggregator);
+        aggregator.postCollection();
+
+        max = (InternalMax) aggregator.buildAggregation(0L);
+
+        assertTrue(max.getValue() >= 0.0);
+        assertTrue(max.getValue() <= 1.0);
+        assertEquals("max", max.getName());
+        assertTrue(AggregationInspectionHelper.hasValue(max));
+
+        // Test that an aggregation using a nondeterministic script does not get cached
         assertFalse(aggregator.context().getQueryShardContext().isCacheable());
 
         multiReader.close();
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MedianAbsoluteDeviationIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MedianAbsoluteDeviationIT.java
index b40c8ee8acdf3..7345e16c2fc1c 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MedianAbsoluteDeviationIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MedianAbsoluteDeviationIT.java
@@ -556,10 +556,10 @@ public void testOrderByEmptyAggregation() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(
             prepareCreate("cache_test_idx")
                 .addMapping("type", "d", "type=long")
@@ -579,11 +579,11 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
             .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
             .addAggregation(randomBuilder()
                 .field("d")
-                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap()))).get();
+                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "Math.random()", emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
@@ -591,14 +591,25 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
             .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(randomBuilder().field("d")).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+            .addAggregation(randomBuilder()
+                .field("d")
+                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
             .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
             .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(randomBuilder().field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getMissCount(), equalTo(2L));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MetricAggScriptPlugin.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MetricAggScriptPlugin.java
index 362aef62ab23e..6787386862f9a 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MetricAggScriptPlugin.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MetricAggScriptPlugin.java
@@ -28,6 +28,7 @@
 
 import org.elasticsearch.script.MockScriptPlugin;
 import org.elasticsearch.search.lookup.LeafDocLookup;
+import org.elasticsearch.test.ESTestCase;
 
 /**
  * Provides a number of dummy scripts for tests.
@@ -52,6 +53,9 @@ public class MetricAggScriptPlugin extends MockScriptPlugin {
     /** Script to return the {@code _value} provided by aggs framework. */
     public static final String VALUE_SCRIPT = "_value";
 
+    /** Script to return a random double */
+    public static final String RANDOM_SCRIPT = "Math.random()";
+
     @Override
     public String pluginScriptLang() {
         return METRIC_SCRIPT_ENGINE;
@@ -88,4 +92,13 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
         });
         return scripts;
     }
+
+    @Override
+    protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+        Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+        scripts.put("Math.random()", vars -> ESTestCase.randomDouble());
+
+        return scripts;
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregatorTests.java
index 922536a76544a..d6b65dfc62d74 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MinAggregatorTests.java
@@ -127,6 +127,8 @@ public class MinAggregatorTests extends AggregatorTestCase {
 
     private static final String INVERT_SCRIPT = "invert";
 
+    private static final String RANDOM_SCRIPT = "random";
+
     @Override
     protected ScriptService getMockScriptService() {
         Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
@@ -161,8 +163,12 @@ protected ScriptService getMockScriptService() {
         });
         scripts.put(INVERT_SCRIPT, vars -> -((Number) vars.get("_value")).doubleValue());
 
+        Map<String, Function<Map<String, Object>, Object>> nonDeterministicScripts = new HashMap<>();
+        nonDeterministicScripts.put(RANDOM_SCRIPT, vars -> AggregatorTestCase.randomDouble());
+
         MockScriptEngine scriptEngine = new MockScriptEngine(MockScriptEngine.NAME,
             scripts,
+            nonDeterministicScripts,
             Collections.emptyMap());
         Map<String, ScriptEngine> engines = Collections.singletonMap(scriptEngine.getType(), scriptEngine);
 
@@ -649,7 +655,7 @@ public void testCaching() throws IOException {
         }
     }
 
-    public void testNoCachingWithScript() throws IOException {
+    public void testScriptCaching() throws IOException {
 
         MappedFieldType fieldType = new NumberFieldMapper.NumberFieldType(NumberFieldMapper.NumberType.INTEGER);
         fieldType.setName("number");
@@ -657,6 +663,10 @@ public void testNoCachingWithScript() throws IOException {
             .field("number")
             .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, INVERT_SCRIPT, Collections.emptyMap()));;
 
+        MinAggregationBuilder nonDeterministicAggregationBuilder = new MinAggregationBuilder("min")
+            .field("number")
+            .script(new Script(ScriptType.INLINE, MockScriptEngine.NAME, RANDOM_SCRIPT, Collections.emptyMap()));;
+
         try (Directory directory = newDirectory()) {
             RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
             indexWriter.addDocument(singleton(new NumericDocValuesField("number", 7)));
@@ -668,11 +678,19 @@ public void testNoCachingWithScript() throws IOException {
             try (IndexReader indexReader = DirectoryReader.open(directory)) {
                 IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
 
-                InternalMin min = searchAndReduce(indexSearcher, new MatchAllDocsQuery(), aggregationBuilder, fieldType);
-                assertEquals(-7.0, min.getValue(), 0);
+                InternalMin min = searchAndReduce(indexSearcher, new MatchAllDocsQuery(), nonDeterministicAggregationBuilder, fieldType);
+                assertTrue(min.getValue() >= 0.0 && min.getValue() <= 1.0);
                 assertTrue(AggregationInspectionHelper.hasValue(min));
 
                 assertFalse(queryShardContext.isCacheable());
+
+                indexSearcher = newSearcher(indexReader, true, true);
+
+                min = searchAndReduce(indexSearcher, new MatchAllDocsQuery(), aggregationBuilder, fieldType);
+                assertEquals(-7.0, min.getValue(), 0);
+                assertTrue(AggregationInspectionHelper.hasValue(min));
+
+                assertTrue(queryShardContext.isCacheable());
             }
         }
     }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
index 71ceeb1abeb72..406a96e3c34cd 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
@@ -247,6 +247,23 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
             return scripts;
         }
 
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
+
+            scripts.put("state.data = Math.random()", vars ->
+                aggScript(vars, state -> state.put("data", ScriptedMetricIT.randomDouble())));
+
+
+            scripts.put("state['count'] = Math.random() >= 0.5 ? 1 : 0", vars ->
+                aggScript(vars, state -> state.put("count", ScriptedMetricIT.randomDouble() >= 0.5 ? 1 : 0)));
+
+
+            scripts.put("return Math.random()", vars -> ScriptedMetricIT.randomDouble());
+
+            return scripts;
+        }
+
         @SuppressWarnings("unchecked")
         static Map<String, Object> aggScript(Map<String, Object> vars, Consumer<Map<String, Object>> fn) {
             Map<String, Object> aggState = (Map<String, Object>) vars.get("state");
@@ -1015,17 +1032,27 @@ public void testEmptyAggregation() throws Exception {
         assertThat(aggregationResult.get(0), equalTo(0));
     }
 
+
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script gets cached and nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
+        // TODO(stu): add non-determinism in init, agg, combine and reduce, ensure not cached
         Script mapScript = new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "state['count'] = 1", Collections.emptyMap());
         Script combineScript =
             new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "no-op aggregation", Collections.emptyMap());
         Script reduceScript = new Script(ScriptType.INLINE, CustomScriptPlugin.NAME,
             "no-op list aggregation", Collections.emptyMap());
 
+        Script ndInitScript = new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "state.data = Math.random()",
+                                         Collections.emptyMap());
+
+        Script ndMapScript = new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "state['count'] = Math.random() >= 0.5 ? 1 : 0",
+                                        Collections.emptyMap());
+
+        Script ndRandom = new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "return Math.random()",
+                                     Collections.emptyMap());
+
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -1038,15 +1065,58 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a non-deterministic init script causes the result to not be cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
-                .addAggregation(scriptedMetric("foo").mapScript(mapScript).combineScript(combineScript).reduceScript(reduceScript)).get();
+            .addAggregation(scriptedMetric("foo").initScript(ndInitScript).mapScript(mapScript).combineScript(combineScript)
+                            .reduceScript(reduceScript)).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getMissCount(), equalTo(0L));
+
+        // Test that a non-deterministic map script causes the result to not be cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+            .addAggregation(scriptedMetric("foo").mapScript(ndMapScript).combineScript(combineScript).reduceScript(reduceScript))
+            .get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getMissCount(), equalTo(0L));
+
+        // Test that a non-deterministic combine script causes the result to not be cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+            .addAggregation(scriptedMetric("foo").mapScript(mapScript).combineScript(ndRandom).reduceScript(reduceScript)).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getMissCount(), equalTo(0L));
+
+        // NOTE: random reduce scripts don't hit the query shard context (they are done on the coordinator) and so can be cached.
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+            .addAggregation(scriptedMetric("foo").mapScript(mapScript).combineScript(combineScript).reduceScript(ndRandom)).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+            .getMissCount(), equalTo(1L));
+
+        // Test that all deterministic scripts cause the request to be cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(scriptedMetric("foo").mapScript(mapScript).combineScript(combineScript).reduceScript(reduceScript))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
-                .getMissCount(), equalTo(0L));
+                .getMissCount(), equalTo(2L));
     }
 
     public void testConflictingAggAndScriptParams() {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/StatsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/StatsIT.java
index 13c5fd9e3e43b..bc3695edd9f0c 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/StatsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/StatsIT.java
@@ -488,10 +488,10 @@ private void assertShardExecutionState(SearchResponse response, int expectedFail
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -504,10 +504,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
                 stats("foo").field("d").script(
-                    new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value + 1", Collections.emptyMap()))).get();
+                    new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "Math.random()", Collections.emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
@@ -515,14 +515,24 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(stats("foo").field("d")).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(
+                stats("foo").field("d").script(
+                    new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value + 1", Collections.emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(stats("foo").field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/SumIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/SumIT.java
index e9bef29d445be..87883852a615a 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/SumIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/SumIT.java
@@ -47,6 +47,7 @@
 import static org.elasticsearch.search.aggregations.AggregationBuilders.sum;
 import static org.elasticsearch.search.aggregations.AggregationBuilders.terms;
 import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.METRIC_SCRIPT_ENGINE;
+import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.RANDOM_SCRIPT;
 import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.SUM_VALUES_FIELD_SCRIPT;
 import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.VALUE_FIELD_SCRIPT;
 import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.VALUE_SCRIPT;
@@ -374,10 +375,10 @@ public void testOrderByEmptyAggregation() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -390,10 +391,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(sum("foo").field("d").script(
-                    new Script(ScriptType.INLINE, METRIC_SCRIPT_ENGINE, VALUE_SCRIPT, Collections.emptyMap()))).get();
+                    new Script(ScriptType.INLINE, METRIC_SCRIPT_ENGINE, RANDOM_SCRIPT, Collections.emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
@@ -401,15 +402,25 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(sum("foo").field("d")).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(sum("foo").field("d").script(
+                    new Script(ScriptType.INLINE, METRIC_SCRIPT_ENGINE, VALUE_SCRIPT, Collections.emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(sum("foo").field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 
     public void testFieldAlias() {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentileRanksIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentileRanksIT.java
index 5051cee0dbf07..4974378d49010 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentileRanksIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentileRanksIT.java
@@ -484,10 +484,10 @@ public void testOrderByEmptyAggregation() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -500,11 +500,11 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
             .addAggregation(percentileRanks("foo", new double[]{50.0})
                 .field("d")
-                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap()))).get();
+                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "Math.random()", emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
@@ -512,15 +512,26 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(percentileRanks("foo", new double[]{50.0}).field("d")).get();
+        // Test that a request using a deterministic script gets cached
+         r = client().prepareSearch("cache_test_idx").setSize(0)
+            .addAggregation(percentileRanks("foo", new double[]{50.0})
+                .field("d")
+                .script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap()))).get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(percentileRanks("foo", new double[]{50.0}).field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentilesIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentilesIT.java
index e334213f1d2e1..7bd871e63fab4 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentilesIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentilesIT.java
@@ -467,10 +467,10 @@ public void testOrderByEmptyAggregation() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -483,9 +483,9 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(percentiles("foo").field("d")
-                .percentiles(50.0).script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
+                .percentiles(50.0).script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "Math.random()", emptyMap())))
                 .get();
         assertSearchResponse(r);
 
@@ -494,14 +494,24 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(percentiles("foo").field("d").percentiles(50.0)).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(percentiles("foo").field("d")
+                .percentiles(50.0).script(new Script(ScriptType.INLINE, AggregationTestScriptsPlugin.NAME, "_value - 1", emptyMap())))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(percentiles("foo").field("d").percentiles(50.0)).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
index 417328bec4e63..207060d05ce72 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
@@ -107,6 +107,11 @@ public static class CustomScriptPlugin extends MockScriptPlugin {
         protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
             return Collections.singletonMap("5", script -> "5");
         }
+
+        @Override
+        protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() {
+            return Collections.singletonMap("Math.random()", script -> TopHitsIT.randomDouble());
+        }
     }
 
     public static String randomExecutionHint() {
@@ -1086,10 +1091,10 @@ public void testNoStoredFields() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         try {
             assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(
@@ -1107,10 +1112,10 @@ public void testDontCacheScripts() throws Exception {
             assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-            // Test that a request using a script field does not get cached
+            // Test that a request using a nondeterministic script field does not get cached
             SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(topHits("foo").scriptField("bar",
-                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "5", Collections.emptyMap()))).get();
+                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "Math.random()", Collections.emptyMap()))).get();
             assertSearchResponse(r);
 
             assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
@@ -1118,11 +1123,12 @@ public void testDontCacheScripts() throws Exception {
             assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-            // Test that a request using a script sort does not get cached
+            // Test that a request using a nondeterministic script sort does not get cached
             r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(topHits("foo").sort(
                     SortBuilders.scriptSort(
-                        new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "5", Collections.emptyMap()), ScriptSortType.STRING)))
+                        new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "Math.random()", Collections.emptyMap()),
+                                   ScriptSortType.STRING)))
                 .get();
             assertSearchResponse(r);
 
@@ -1131,15 +1137,38 @@ public void testDontCacheScripts() throws Exception {
             assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-            // To make sure that the cache is working test that a request not using
-            // a script is cached
-            r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(topHits("foo")).get();
+            // Test that a request using a deterministic script field does not get cached
+            r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(topHits("foo").scriptField("bar",
+                    new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "5", Collections.emptyMap()))).get();
             assertSearchResponse(r);
 
             assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
             assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+            // Test that a request using a deterministic script sort does not get cached
+            r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(topHits("foo").sort(
+                    SortBuilders.scriptSort(
+                        new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "5", Collections.emptyMap()), ScriptSortType.STRING)))
+                .get();
+            assertSearchResponse(r);
+
+            assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+            assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
+
+            // Ensure that non-scripted requests are cached as normal
+            r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(topHits("foo")).get();
+            assertSearchResponse(r);
+
+            assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+            assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(3L));
         } finally {
             assertAcked(client().admin().indices().prepareDelete("cache_test_idx")); // delete this - if we use tests.iters it would fail
         }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ValueCountIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ValueCountIT.java
index 2976d1310bcf9..642326010a2f8 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ValueCountIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ValueCountIT.java
@@ -43,6 +43,7 @@
 import static org.elasticsearch.search.aggregations.AggregationBuilders.global;
 import static org.elasticsearch.search.aggregations.AggregationBuilders.terms;
 import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.METRIC_SCRIPT_ENGINE;
+import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.RANDOM_SCRIPT;
 import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.SUM_FIELD_PARAMS_SCRIPT;
 import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.SUM_VALUES_FIELD_SCRIPT;
 import static org.elasticsearch.search.aggregations.metrics.MetricAggScriptPlugin.VALUE_FIELD_SCRIPT;
@@ -211,10 +212,10 @@ public void testMultiValuedScriptWithParams() throws Exception {
     }
 
     /**
-     * Make sure that a request using a script does not get cached and a request
-     * not using a script does get cached.
+     * Make sure that a request using a deterministic script or not using a script get cached.
+     * Ensure requests using nondeterministic scripts do not get cached.
      */
-    public void testDontCacheScripts() throws Exception {
+    public void testScriptCaching() throws Exception {
         assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
@@ -227,10 +228,10 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // Test that a request using a script does not get cached
+        // Test that a request using a nondeterministic script does not get cached
         SearchResponse r = client().prepareSearch("cache_test_idx").setSize(0)
                 .addAggregation(count("foo").field("d").script(
-                    new Script(ScriptType.INLINE, METRIC_SCRIPT_ENGINE, VALUE_FIELD_SCRIPT, Collections.emptyMap())))
+                    new Script(ScriptType.INLINE, METRIC_SCRIPT_ENGINE, RANDOM_SCRIPT, Collections.emptyMap())))
                 .get();
         assertSearchResponse(r);
 
@@ -239,15 +240,26 @@ public void testDontCacheScripts() throws Exception {
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(0L));
 
-        // To make sure that the cache is working test that a request not using
-        // a script is cached
-        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(count("foo").field("d")).get();
+        // Test that a request using a deterministic script gets cached
+        r = client().prepareSearch("cache_test_idx").setSize(0)
+                .addAggregation(count("foo").field("d").script(
+                    new Script(ScriptType.INLINE, METRIC_SCRIPT_ENGINE, VALUE_FIELD_SCRIPT, Collections.emptyMap())))
+                .get();
         assertSearchResponse(r);
 
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getHitCount(), equalTo(0L));
         assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
                 .getMissCount(), equalTo(1L));
+
+        // Ensure that non-scripted requests are cached as normal
+        r = client().prepareSearch("cache_test_idx").setSize(0).addAggregation(count("foo").field("d")).get();
+        assertSearchResponse(r);
+
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getHitCount(), equalTo(0L));
+        assertThat(client().admin().indices().prepareStats("cache_test_idx").setRequestCache(true).get().getTotal().getRequestCache()
+                .getMissCount(), equalTo(2L));
     }
 
     public void testOrderByEmptyAggregation() throws Exception {
diff --git a/test/framework/src/main/java/org/elasticsearch/script/MockDeterministicScript.java b/test/framework/src/main/java/org/elasticsearch/script/MockDeterministicScript.java
new file mode 100644
index 0000000000000..8cafd512450a7
--- /dev/null
+++ b/test/framework/src/main/java/org/elasticsearch/script/MockDeterministicScript.java
@@ -0,0 +1,45 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.script;
+
+import java.util.Map;
+import java.util.function.Function;
+
+/**
+ * A mocked script used for testing purposes.  {@code deterministic} implies cacheability in query shard cache.
+ */
+public abstract class MockDeterministicScript implements Function<Map<String, Object>, Object>, ScriptFactory {
+    public abstract Object apply(Map<String, Object> vars);
+    public abstract boolean isResultDeterministic();
+
+    public static MockDeterministicScript asDeterministic(Function<Map<String, Object>, Object> script) {
+        return new MockDeterministicScript() {
+            @Override public boolean isResultDeterministic() { return true; }
+            @Override public Object apply(Map<String, Object> vars) { return script.apply(vars); }
+        };
+    }
+
+    public static MockDeterministicScript asNonDeterministic(Function<Map<String, Object>, Object> script) {
+        return new MockDeterministicScript() {
+            @Override public boolean isResultDeterministic() { return false; }
+            @Override public Object apply(Map<String, Object> vars) { return script.apply(vars); }
+        };
+    }
+}
diff --git a/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java b/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
index 84aad77377a30..3069efbebb451 100644
--- a/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
+++ b/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
@@ -62,11 +62,22 @@ public interface ContextCompiler {
     public static final String NAME = "mockscript";
 
     private final String type;
-    private final Map<String, Function<Map<String, Object>, Object>> scripts;
+    private final Map<String, MockDeterministicScript> scripts;
     private final Map<ScriptContext<?>, ContextCompiler> contexts;
 
     public MockScriptEngine(String type, Map<String, Function<Map<String, Object>, Object>> scripts,
                             Map<ScriptContext<?>, ContextCompiler> contexts) {
+        this(type, scripts, Collections.emptyMap(), contexts);
+    }
+
+    public MockScriptEngine(String type, Map<String, Function<Map<String, Object>, Object>> deterministicScripts,
+                            Map<String, Function<Map<String, Object>, Object>> nonDeterministicScripts,
+                            Map<ScriptContext<?>, ContextCompiler> contexts) {
+
+        Map<String, MockDeterministicScript> scripts = new HashMap<>(deterministicScripts.size() + nonDeterministicScripts.size());
+        deterministicScripts.forEach((key, value) -> scripts.put(key, MockDeterministicScript.asDeterministic(value)));
+        nonDeterministicScripts.forEach((key, value) -> scripts.put(key, MockDeterministicScript.asNonDeterministic(value)));
+
         this.type = type;
         this.scripts = Collections.unmodifiableMap(scripts);
         this.contexts = Collections.unmodifiableMap(contexts);
@@ -85,34 +96,14 @@ public String getType() {
     public <T extends ScriptFactory> T compile(String name, String source, ScriptContext<T> context, Map<String, String> params) {
         // Scripts are always resolved using the script's source. For inline scripts, it's easy because they don't have names and the
         // source is always provided. For stored and file scripts, the source of the script must match the key of a predefined script.
-        Function<Map<String, Object>, Object> script = scripts.get(source);
+        MockDeterministicScript script = scripts.get(source);
         if (script == null) {
             throw new IllegalArgumentException("No pre defined script matching [" + source + "] for script with name [" + name + "], " +
                     "did you declare the mocked script?");
         }
         MockCompiledScript mockCompiled = new MockCompiledScript(name, params, source, script);
         if (context.instanceClazz.equals(FieldScript.class)) {
-            FieldScript.Factory factory = (parameters, lookup) ->
-                ctx -> new FieldScript(parameters, lookup, ctx) {
-                    @Override
-                    public Object execute() {
-                        Map<String, Object> vars = createVars(parameters);
-                        vars.putAll(getLeafLookup().asMap());
-                        return script.apply(vars);
-                    }
-                };
-            return context.factoryClazz.cast(factory);
-        } else if (context.instanceClazz.equals(FieldScript.class)) {
-            FieldScript.Factory factory = (parameters, lookup) ->
-                ctx -> new FieldScript(parameters, lookup, ctx) {
-                    @Override
-                    public Object execute() {
-                        Map<String, Object> vars = createVars(parameters);
-                        vars.putAll(getLeafLookup().asMap());
-                        return script.apply(vars);
-                    }
-                };
-            return context.factoryClazz.cast(factory);
+            return context.factoryClazz.cast(new MockFieldScriptFactory(script));
         } else if(context.instanceClazz.equals(TermsSetQueryScript.class)) {
             TermsSetQueryScript.Factory factory = (parameters, lookup) -> (TermsSetQueryScript.LeafFactory) ctx
                 -> new TermsSetQueryScript(parameters, lookup, ctx) {
@@ -147,17 +138,7 @@ public boolean needs_score() {
             };
             return context.factoryClazz.cast(factory);
         } else if (context.instanceClazz.equals(StringSortScript.class)) {
-            StringSortScript.Factory factory = (parameters, lookup) -> (StringSortScript.LeafFactory) ctx
-                -> new StringSortScript(parameters, lookup, ctx) {
-                @Override
-                public String execute() {
-                    Map<String, Object> vars = new HashMap<>(parameters);
-                    vars.put("params", parameters);
-                    vars.put("doc", getDoc());
-                    return String.valueOf(script.apply(vars));
-                }
-            };
-            return context.factoryClazz.cast(factory);
+            return context.factoryClazz.cast(new MockStringSortScriptFactory(script));
         } else if (context.instanceClazz.equals(IngestScript.class)) {
             IngestScript.Factory factory = vars -> new IngestScript(vars) {
                 @Override
@@ -167,37 +148,7 @@ public void execute(Map<String, Object> ctx) {
             };
             return context.factoryClazz.cast(factory);
         } else if(context.instanceClazz.equals(AggregationScript.class)) {
-            AggregationScript.Factory factory = (parameters, lookup) -> new AggregationScript.LeafFactory() {
-                @Override
-                public AggregationScript newInstance(final LeafReaderContext ctx) {
-                    return new AggregationScript(parameters, lookup, ctx) {
-                        @Override
-                        public Object execute() {
-                            Map<String, Object> vars = new HashMap<>(parameters);
-                            vars.put("params", parameters);
-                            vars.put("doc", getDoc());
-                            vars.put("_score", get_score());
-                            vars.put("_value", get_value());
-                            return script.apply(vars);
-                        }
-                    };
-                }
-
-                @Override
-                public boolean needs_score() {
-                    return true;
-                }
-            };
-            return context.factoryClazz.cast(factory);
-        } else if (context.instanceClazz.equals(IngestScript.class)) {
-            IngestScript.Factory factory = vars ->
-                new IngestScript(vars) {
-                    @Override
-                    public void execute(Map<String, Object> ctx) {
-                        script.apply(ctx);
-                    }
-                };
-            return context.factoryClazz.cast(factory);
+            return context.factoryClazz.cast(new MockAggregationScript(script));
         } else if (context.instanceClazz.equals(IngestConditionalScript.class)) {
             IngestConditionalScript.Factory factory = parameters -> new IngestConditionalScript(parameters) {
                 @Override
@@ -240,13 +191,7 @@ public boolean execute() {
             };
             return context.factoryClazz.cast(factory);
         } else if (context.instanceClazz.equals(SignificantTermsHeuristicScoreScript.class)) {
-            SignificantTermsHeuristicScoreScript.Factory factory = () -> new SignificantTermsHeuristicScoreScript() {
-                @Override
-                public double execute(Map<String, Object> vars) {
-                    return ((Number) script.apply(vars)).doubleValue();
-                }
-            };
-            return context.factoryClazz.cast(factory);
+            return context.factoryClazz.cast(new MockSignificantTermsHeuristicScoreScript(script));
         } else if (context.instanceClazz.equals(TemplateScript.class)) {
             TemplateScript.Factory factory = vars -> {
                 Map<String, Object> varsWithParams = new HashMap<>();
@@ -280,19 +225,19 @@ public double execute(Map<String, Object> params1, double[] values) {
             };
             return context.factoryClazz.cast(factory);
         } else if (context.instanceClazz.equals(ScoreScript.class)) {
-            ScoreScript.Factory factory = new MockScoreScript(script);
+            ScoreScript.Factory factory = new MockScoreScript(script::apply);
             return context.factoryClazz.cast(factory);
         } else if (context.instanceClazz.equals(ScriptedMetricAggContexts.InitScript.class)) {
-            ScriptedMetricAggContexts.InitScript.Factory factory = mockCompiled::createMetricAggInitScript;
+            ScriptedMetricAggContexts.InitScript.Factory factory = new MockMetricAggInitScriptFactory(script);
             return context.factoryClazz.cast(factory);
         } else if (context.instanceClazz.equals(ScriptedMetricAggContexts.MapScript.class)) {
-            ScriptedMetricAggContexts.MapScript.Factory factory = mockCompiled::createMetricAggMapScript;
+            ScriptedMetricAggContexts.MapScript.Factory factory = new MockMetricAggMapScriptFactory(script);
             return context.factoryClazz.cast(factory);
         } else if (context.instanceClazz.equals(ScriptedMetricAggContexts.CombineScript.class)) {
-            ScriptedMetricAggContexts.CombineScript.Factory factory = mockCompiled::createMetricAggCombineScript;
+            ScriptedMetricAggContexts.CombineScript.Factory factory = new MockMetricAggCombineScriptFactory(script);
             return context.factoryClazz.cast(factory);
         } else if (context.instanceClazz.equals(ScriptedMetricAggContexts.ReduceScript.class)) {
-            ScriptedMetricAggContexts.ReduceScript.Factory factory = mockCompiled::createMetricAggReduceScript;
+            ScriptedMetricAggContexts.ReduceScript.Factory factory = new MockMetricAggReduceScriptFactory(script);
             return context.factoryClazz.cast(factory);
         } else if (context.instanceClazz.equals(IntervalFilterScript.class)) {
             IntervalFilterScript.Factory factory = mockCompiled::createIntervalFilterScript;
@@ -300,7 +245,7 @@ public double execute(Map<String, Object> params1, double[] values) {
         }
         ContextCompiler compiler = contexts.get(context);
         if (compiler != null) {
-            return context.factoryClazz.cast(compiler.compile(script, params));
+            return context.factoryClazz.cast(compiler.compile(script::apply, params));
         }
         throw new IllegalArgumentException("mock script engine does not know how to handle context [" + context.name + "]");
     }
@@ -370,25 +315,6 @@ public SimilarityWeightScript createSimilarityWeightScript() {
             return new MockSimilarityWeightScript(script != null ? script : ctx -> 42d);
         }
 
-        public ScriptedMetricAggContexts.InitScript createMetricAggInitScript(Map<String, Object> params, Map<String, Object> state) {
-            return new MockMetricAggInitScript(params, state, script != null ? script : ctx -> 42d);
-        }
-
-        public ScriptedMetricAggContexts.MapScript.LeafFactory createMetricAggMapScript(Map<String, Object> params,
-                                                                                        Map<String, Object> state,
-                                                                                        SearchLookup lookup) {
-            return new MockMetricAggMapScript(params, state, lookup, script != null ? script : ctx -> 42d);
-        }
-
-        public ScriptedMetricAggContexts.CombineScript createMetricAggCombineScript(Map<String, Object> params,
-                                                                                    Map<String, Object> state) {
-            return new MockMetricAggCombineScript(params, state, script != null ? script : ctx -> 42d);
-        }
-
-        public ScriptedMetricAggContexts.ReduceScript createMetricAggReduceScript(Map<String, Object> params, List<Object> states) {
-            return new MockMetricAggReduceScript(params, states, script != null ? script : ctx -> 42d);
-        }
-
         public IntervalFilterScript createIntervalFilterScript() {
             return new IntervalFilterScript() {
                 @Override
@@ -469,6 +395,17 @@ public double execute(Query query, Field field, Term term) {
         }
     }
 
+    public static class MockMetricAggInitScriptFactory implements ScriptedMetricAggContexts.InitScript.Factory, ScriptFactory {
+        private final MockDeterministicScript script;
+        MockMetricAggInitScriptFactory(MockDeterministicScript script) { this.script = script; }
+        @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
+
+        @Override
+        public ScriptedMetricAggContexts.InitScript newInstance(Map<String, Object> params, Map<String, Object> state) {
+            return new MockMetricAggInitScript(params, state, script);
+        }
+    }
+
     public static class MockMetricAggInitScript extends ScriptedMetricAggContexts.InitScript {
         private final Function<Map<String, Object>, Object> script;
 
@@ -491,6 +428,18 @@ public void execute() {
         }
     }
 
+    public static class MockMetricAggMapScriptFactory implements  ScriptedMetricAggContexts.MapScript.Factory, ScriptFactory {
+        private final MockDeterministicScript script;
+        MockMetricAggMapScriptFactory(MockDeterministicScript script) { this.script = script; }
+        @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
+
+        @Override
+        public ScriptedMetricAggContexts.MapScript.LeafFactory newFactory(Map<String, Object> params, Map<String, Object> state,
+                                                                          SearchLookup lookup) {
+            return new MockMetricAggMapScript(params, state, lookup, script);
+        }
+    }
+
     public static class MockMetricAggMapScript implements ScriptedMetricAggContexts.MapScript.LeafFactory {
         private final Map<String, Object> params;
         private final Map<String, Object> state;
@@ -527,11 +476,21 @@ public void execute() {
         }
     }
 
+    public static class MockMetricAggCombineScriptFactory implements ScriptedMetricAggContexts.CombineScript.Factory, ScriptFactory {
+        private final MockDeterministicScript script;
+        MockMetricAggCombineScriptFactory(MockDeterministicScript script) { this.script = script; }
+        @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
+
+        @Override
+        public ScriptedMetricAggContexts.CombineScript newInstance(Map<String, Object> params, Map<String, Object> state) {
+            return new MockMetricAggCombineScript(params, state, script);
+        }
+    }
+
     public static class MockMetricAggCombineScript extends ScriptedMetricAggContexts.CombineScript {
         private final Function<Map<String, Object>, Object> script;
 
-        MockMetricAggCombineScript(Map<String, Object> params, Map<String, Object> state,
-                                Function<Map<String, Object>, Object> script) {
+        MockMetricAggCombineScript(Map<String, Object> params, Map<String, Object> state, Function<Map<String, Object>, Object> script) {
             super(params, state);
             this.script = script;
         }
@@ -549,11 +508,21 @@ public Object execute() {
         }
     }
 
+    public static class MockMetricAggReduceScriptFactory implements ScriptedMetricAggContexts.ReduceScript.Factory, ScriptFactory {
+        private final MockDeterministicScript script;
+        MockMetricAggReduceScriptFactory(MockDeterministicScript script) { this.script = script; }
+        @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
+
+        @Override
+        public ScriptedMetricAggContexts.ReduceScript newInstance(Map<String, Object> params, List<Object> states) {
+            return new MockMetricAggReduceScript(params, states, script);
+        }
+    }
+
     public static class MockMetricAggReduceScript extends ScriptedMetricAggContexts.ReduceScript {
         private final Function<Map<String, Object>, Object> script;
 
-        MockMetricAggReduceScript(Map<String, Object> params, List<Object> states,
-                                  Function<Map<String, Object>, Object> script) {
+        MockMetricAggReduceScript(Map<String, Object> params, List<Object> states, Function<Map<String, Object>, Object> script) {
             super(params, states);
             this.script = script;
         }
@@ -615,4 +584,88 @@ public void setScorer(Scorable scorer) {
         }
     }
 
+    class MockAggregationScript implements AggregationScript.Factory, ScriptFactory {
+        private final MockDeterministicScript script;
+        MockAggregationScript(MockDeterministicScript script) { this.script = script; }
+        @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
+
+        @Override
+        public AggregationScript.LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup) {
+            return new AggregationScript.LeafFactory() {
+                @Override
+                public AggregationScript newInstance(final LeafReaderContext ctx) {
+                    return new AggregationScript(params, lookup, ctx) {
+                        @Override
+                        public Object execute() {
+                            Map<String, Object> vars = new HashMap<>(params);
+                            vars.put("params", params);
+                            vars.put("doc", getDoc());
+                            vars.put("_score", get_score());
+                            vars.put("_value", get_value());
+                            return script.apply(vars);
+                        }
+                    };
+                }
+
+                @Override
+                public boolean needs_score() {
+                    return true;
+                }
+            };
+        }
+    }
+
+    class MockSignificantTermsHeuristicScoreScript implements SignificantTermsHeuristicScoreScript.Factory, ScriptFactory {
+        private final MockDeterministicScript script;
+        MockSignificantTermsHeuristicScoreScript(MockDeterministicScript script) { this.script = script; }
+        @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
+
+        @Override
+        public SignificantTermsHeuristicScoreScript newInstance() {
+            return new SignificantTermsHeuristicScoreScript() {
+                @Override
+                public double execute(Map<String, Object> vars) {
+                    return ((Number) script.apply(vars)).doubleValue();
+                }
+            };
+        }
+    }
+
+    class MockFieldScriptFactory implements FieldScript.Factory, ScriptFactory {
+        private final MockDeterministicScript script;
+        MockFieldScriptFactory(MockDeterministicScript script) { this.script = script; }
+        @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
+
+        @Override
+        public FieldScript.LeafFactory newFactory(Map<String, Object> parameters, SearchLookup lookup) {
+            return ctx -> new FieldScript(parameters, lookup, ctx) {
+                @Override
+                public Object execute() {
+                    Map<String, Object> vars = createVars(parameters);
+                    vars.putAll(getLeafLookup().asMap());
+                    return script.apply(vars);
+
+                }
+            };
+        }
+    }
+
+    class MockStringSortScriptFactory implements StringSortScript.Factory, ScriptFactory {
+        private final MockDeterministicScript script;
+        MockStringSortScriptFactory(MockDeterministicScript script) { this.script = script; }
+        @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
+
+        @Override
+        public StringSortScript.LeafFactory newFactory(Map<String, Object> parameters, SearchLookup lookup) {
+            return ctx -> new StringSortScript(parameters, lookup, ctx) {
+                @Override
+                public String execute() {
+                    Map<String, Object> vars = new HashMap<>(parameters);
+                    vars.put("params", parameters);
+                    vars.put("doc", getDoc());
+                    return String.valueOf(script.apply(vars));
+                }
+            };
+        }
+    }
 }
diff --git a/test/framework/src/main/java/org/elasticsearch/script/MockScriptPlugin.java b/test/framework/src/main/java/org/elasticsearch/script/MockScriptPlugin.java
index 34aca79ec4725..972879a735a72 100644
--- a/test/framework/src/main/java/org/elasticsearch/script/MockScriptPlugin.java
+++ b/test/framework/src/main/java/org/elasticsearch/script/MockScriptPlugin.java
@@ -37,11 +37,13 @@ public abstract class MockScriptPlugin extends Plugin implements ScriptPlugin {
 
     @Override
     public ScriptEngine getScriptEngine(Settings settings, Collection<ScriptContext<?>> contexts) {
-        return new MockScriptEngine(pluginScriptLang(), pluginScripts(), pluginContextCompilers());
+        return new MockScriptEngine(pluginScriptLang(), pluginScripts(), nonDeterministicPluginScripts(), pluginContextCompilers());
     }
 
     protected abstract Map<String, Function<Map<String, Object>, Object>> pluginScripts();
 
+    protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPluginScripts() { return Collections.emptyMap(); }
+
     protected Map<ScriptContext<?>, MockScriptEngine.ContextCompiler> pluginContextCompilers() {
         return Collections.emptyMap();
     }

From f6380f1d4ebee1b79199ca649b7a729433d54bc7 Mon Sep 17 00:00:00 2001
From: Igor Motov <igor@motovs.org>
Date: Wed, 18 Dec 2019 07:28:56 -1000
Subject: [PATCH 255/686] Geo: Switch generated WKT to upper case (#50285)

Switches generated WKT to upper case to
conform to the standard recommendation.

Relates #49568
---
 .../ingest/processors/circle.asciidoc         |  2 +-
 .../geometry/utils/WellKnownText.java         | 18 ++--
 .../elasticsearch/geometry/CircleTests.java   |  8 +-
 .../geometry/GeometryCollectionTests.java     |  8 +-
 .../org/elasticsearch/geometry/LineTests.java | 12 +--
 .../geometry/MultiLineTests.java              |  8 +-
 .../geometry/MultiPointTests.java             | 16 +--
 .../geometry/MultiPolygonTests.java           |  8 +-
 .../elasticsearch/geometry/PointTests.java    | 10 +-
 .../elasticsearch/geometry/PolygonTests.java  | 18 ++--
 .../geometry/RectangleTests.java              |  8 +-
 .../common/geo/GeometryParserTests.java       |  2 +-
 .../qa/src/main/resources/docs/geo.csv-spec   |  4 +-
 .../qa/src/main/resources/geo/geosql.csv-spec | 98 +++++++++----------
 .../scalar/geo/GeoProcessorTests.java         |  4 +-
 .../scalar/geo/StWkttosqlProcessorTests.java  |  4 +-
 .../sql/planner/QueryTranslatorTests.java     |  8 +-
 17 files changed, 118 insertions(+), 118 deletions(-)

diff --git a/docs/reference/ingest/processors/circle.asciidoc b/docs/reference/ingest/processors/circle.asciidoc
index e2d5c428b9d5d..300d7763fe634 100644
--- a/docs/reference/ingest/processors/circle.asciidoc
+++ b/docs/reference/ingest/processors/circle.asciidoc
@@ -80,7 +80,7 @@ The response from the above index request:
   "_seq_no": 22,
   "_primary_term": 1,
   "_source": {
-    "circle": "polygon ((30.000365257263184 10.0, 30.000111397193788 10.00034284530941, 29.999706043744222 10.000213571721195, 29.999706043744222 9.999786428278805, 30.000111397193788 9.99965715469059, 30.000365257263184 10.0))"
+    "circle": "POLYGON ((30.000365257263184 10.0, 30.000111397193788 10.00034284530941, 29.999706043744222 10.000213571721195, 29.999706043744222 9.999786428278805, 30.000111397193788 9.99965715469059, 30.000365257263184 10.0))"
   }
 }
 --------------------------------------------------
diff --git a/libs/geo/src/main/java/org/elasticsearch/geometry/utils/WellKnownText.java b/libs/geo/src/main/java/org/elasticsearch/geometry/utils/WellKnownText.java
index a59820785e968..a71ce222f1e9e 100644
--- a/libs/geo/src/main/java/org/elasticsearch/geometry/utils/WellKnownText.java
+++ b/libs/geo/src/main/java/org/elasticsearch/geometry/utils/WellKnownText.java
@@ -586,17 +586,17 @@ private static String getWKTName(Geometry geometry) {
         return geometry.visit(new GeometryVisitor<String, RuntimeException>() {
             @Override
             public String visit(Circle circle) {
-                return "circle";
+                return "CIRCLE";
             }
 
             @Override
             public String visit(GeometryCollection<?> collection) {
-                return "geometrycollection";
+                return "GEOMETRYCOLLECTION";
             }
 
             @Override
             public String visit(Line line) {
-                return "linestring";
+                return "LINESTRING";
             }
 
             @Override
@@ -606,32 +606,32 @@ public String visit(LinearRing ring) {
 
             @Override
             public String visit(MultiLine multiLine) {
-                return "multilinestring";
+                return "MULTILINESTRING";
             }
 
             @Override
             public String visit(MultiPoint multiPoint) {
-                return "multipoint";
+                return "MULTIPOINT";
             }
 
             @Override
             public String visit(MultiPolygon multiPolygon) {
-                return "multipolygon";
+                return "MULTIPOLYGON";
             }
 
             @Override
             public String visit(Point point) {
-                return "point";
+                return "POINT";
             }
 
             @Override
             public String visit(Polygon polygon) {
-                return "polygon";
+                return "POLYGON";
             }
 
             @Override
             public String visit(Rectangle rectangle) {
-                return "bbox";
+                return "BBOX";
             }
         });
     }
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/CircleTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/CircleTests.java
index eba391dc97038..9f42118821fe7 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/CircleTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/CircleTests.java
@@ -40,14 +40,14 @@ protected Circle createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("circle (20.0 10.0 15.0)", wkt.toWKT(new Circle(20, 10, 15)));
+        assertEquals("CIRCLE (20.0 10.0 15.0)", wkt.toWKT(new Circle(20, 10, 15)));
         assertEquals(new Circle(20, 10, 15), wkt.fromWKT("circle (20.0 10.0 15.0)"));
 
-        assertEquals("circle (20.0 10.0 15.0 25.0)", wkt.toWKT(new Circle(20, 10, 25, 15)));
+        assertEquals("CIRCLE (20.0 10.0 15.0 25.0)", wkt.toWKT(new Circle(20, 10, 25, 15)));
         assertEquals(new Circle(20, 10, 25, 15), wkt.fromWKT("circle (20.0 10.0 15.0 25.0)"));
 
-        assertEquals("circle EMPTY", wkt.toWKT(Circle.EMPTY));
-        assertEquals(Circle.EMPTY, wkt.fromWKT("circle EMPTY)"));
+        assertEquals("CIRCLE EMPTY", wkt.toWKT(Circle.EMPTY));
+        assertEquals(Circle.EMPTY, wkt.fromWKT("CIRCLE EMPTY)"));
     }
 
     public void testInitValidation() {
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/GeometryCollectionTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/GeometryCollectionTests.java
index 0783983131ea0..a0898242546df 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/GeometryCollectionTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/GeometryCollectionTests.java
@@ -37,14 +37,14 @@ protected GeometryCollection<Geometry> createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("geometrycollection (point (20.0 10.0),point EMPTY)",
+        assertEquals("GEOMETRYCOLLECTION (POINT (20.0 10.0),POINT EMPTY)",
             wkt.toWKT(new GeometryCollection<Geometry>(Arrays.asList(new Point(20, 10), Point.EMPTY))));
 
         assertEquals(new GeometryCollection<Geometry>(Arrays.asList(new Point(20, 10), Point.EMPTY)),
-            wkt.fromWKT("geometrycollection (point (20.0 10.0),point EMPTY)"));
+            wkt.fromWKT("GEOMETRYCOLLECTION (POINT (20.0 10.0),POINT EMPTY)"));
 
-        assertEquals("geometrycollection EMPTY", wkt.toWKT(GeometryCollection.EMPTY));
-        assertEquals(GeometryCollection.EMPTY, wkt.fromWKT("geometrycollection EMPTY)"));
+        assertEquals("GEOMETRYCOLLECTION EMPTY", wkt.toWKT(GeometryCollection.EMPTY));
+        assertEquals(GeometryCollection.EMPTY, wkt.fromWKT("GEOMETRYCOLLECTION EMPTY)"));
     }
 
     @SuppressWarnings("ConstantConditions")
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/LineTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/LineTests.java
index 7342e0b562d19..0ca38c185ef46 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/LineTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/LineTests.java
@@ -36,16 +36,16 @@ protected Line createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("linestring (3.0 1.0, 4.0 2.0)", wkt.toWKT(new Line(new double[]{3, 4}, new double[]{1, 2})));
-        assertEquals(new Line(new double[]{3, 4}, new double[]{1, 2}), wkt.fromWKT("linestring (3 1, 4 2)"));
+        assertEquals("LINESTRING (3.0 1.0, 4.0 2.0)", wkt.toWKT(new Line(new double[]{3, 4}, new double[]{1, 2})));
+        assertEquals(new Line(new double[]{3, 4}, new double[]{1, 2}), wkt.fromWKT("LINESTRING (3 1, 4 2)"));
 
-        assertEquals("linestring (3.0 1.0 5.0, 4.0 2.0 6.0)", wkt.toWKT(new Line(new double[]{3, 4}, new double[]{1, 2},
+        assertEquals("LINESTRING (3.0 1.0 5.0, 4.0 2.0 6.0)", wkt.toWKT(new Line(new double[]{3, 4}, new double[]{1, 2},
             new double[]{5, 6})));
         assertEquals(new Line(new double[]{3, 4}, new double[]{1, 2}, new double[]{6, 5}),
-            wkt.fromWKT("linestring (3 1 6, 4 2 5)"));
+            wkt.fromWKT("LINESTRING (3 1 6, 4 2 5)"));
 
-        assertEquals("linestring EMPTY", wkt.toWKT(Line.EMPTY));
-        assertEquals(Line.EMPTY, wkt.fromWKT("linestring EMPTY)"));
+        assertEquals("LINESTRING EMPTY", wkt.toWKT(Line.EMPTY));
+        assertEquals(Line.EMPTY, wkt.fromWKT("LINESTRING EMPTY)"));
     }
 
     public void testInitValidation() {
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/MultiLineTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/MultiLineTests.java
index 4610932e0afbf..260eb5facf462 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/MultiLineTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/MultiLineTests.java
@@ -44,13 +44,13 @@ protected MultiLine createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("multilinestring ((3.0 1.0, 4.0 2.0))", wkt.toWKT(
+        assertEquals("MULTILINESTRING ((3.0 1.0, 4.0 2.0))", wkt.toWKT(
             new MultiLine(Collections.singletonList(new Line(new double[]{3, 4}, new double[]{1, 2})))));
         assertEquals(new MultiLine(Collections.singletonList(new Line(new double[]{3, 4}, new double[]{1, 2}))),
-            wkt.fromWKT("multilinestring ((3 1, 4 2))"));
+            wkt.fromWKT("MULTILINESTRING ((3 1, 4 2))"));
 
-        assertEquals("multilinestring EMPTY", wkt.toWKT(MultiLine.EMPTY));
-        assertEquals(MultiLine.EMPTY, wkt.fromWKT("multilinestring EMPTY)"));
+        assertEquals("MULTILINESTRING EMPTY", wkt.toWKT(MultiLine.EMPTY));
+        assertEquals(MultiLine.EMPTY, wkt.fromWKT("MULTILINESTRING EMPTY)"));
     }
 
     public void testValidation() {
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/MultiPointTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/MultiPointTests.java
index 469801279ee17..c512603d0b762 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/MultiPointTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/MultiPointTests.java
@@ -45,23 +45,23 @@ protected MultiPoint createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("multipoint (2.0 1.0)", wkt.toWKT(
+        assertEquals("MULTIPOINT (2.0 1.0)", wkt.toWKT(
             new MultiPoint(Collections.singletonList(new Point(2, 1)))));
         assertEquals(new MultiPoint(Collections.singletonList(new Point(2, 1))),
-            wkt.fromWKT("multipoint (2 1)"));
+            wkt.fromWKT("MULTIPOINT (2 1)"));
 
-        assertEquals("multipoint (2.0 1.0, 3.0 4.0)",
+        assertEquals("MULTIPOINT (2.0 1.0, 3.0 4.0)",
             wkt.toWKT(new MultiPoint(Arrays.asList(new Point(2, 1), new Point(3, 4)))));
         assertEquals(new MultiPoint(Arrays.asList(new Point(2, 1), new Point(3, 4))),
-            wkt.fromWKT("multipoint (2 1, 3 4)"));
+            wkt.fromWKT("MULTIPOINT (2 1, 3 4)"));
 
-        assertEquals("multipoint (2.0 1.0 10.0, 3.0 4.0 20.0)",
+        assertEquals("MULTIPOINT (2.0 1.0 10.0, 3.0 4.0 20.0)",
             wkt.toWKT(new MultiPoint(Arrays.asList(new Point(2, 1, 10), new Point(3, 4, 20)))));
         assertEquals(new MultiPoint(Arrays.asList(new Point(2, 1, 10), new Point(3, 4, 20))),
-            wkt.fromWKT("multipoint (2 1 10, 3 4 20)"));
+            wkt.fromWKT("MULTIPOINT (2 1 10, 3 4 20)"));
 
-        assertEquals("multipoint EMPTY", wkt.toWKT(MultiPoint.EMPTY));
-        assertEquals(MultiPoint.EMPTY, wkt.fromWKT("multipoint EMPTY)"));
+        assertEquals("MULTIPOINT EMPTY", wkt.toWKT(MultiPoint.EMPTY));
+        assertEquals(MultiPoint.EMPTY, wkt.fromWKT("MULTIPOINT EMPTY)"));
     }
 
     public void testValidation() {
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/MultiPolygonTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/MultiPolygonTests.java
index dfd8142ae2c9e..ee1d9a6a5873c 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/MultiPolygonTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/MultiPolygonTests.java
@@ -44,15 +44,15 @@ protected MultiPolygon createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("multipolygon (((3.0 1.0, 4.0 2.0, 5.0 3.0, 3.0 1.0)))",
+        assertEquals("MULTIPOLYGON (((3.0 1.0, 4.0 2.0, 5.0 3.0, 3.0 1.0)))",
             wkt.toWKT(new MultiPolygon(Collections.singletonList(
                 new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1}))))));
         assertEquals(new MultiPolygon(Collections.singletonList(
             new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1})))),
-            wkt.fromWKT("multipolygon (((3.0 1.0, 4.0 2.0, 5.0 3.0, 3.0 1.0)))"));
+            wkt.fromWKT("MULTIPOLYGON (((3.0 1.0, 4.0 2.0, 5.0 3.0, 3.0 1.0)))"));
 
-        assertEquals("multipolygon EMPTY", wkt.toWKT(MultiPolygon.EMPTY));
-        assertEquals(MultiPolygon.EMPTY, wkt.fromWKT("multipolygon EMPTY)"));
+        assertEquals("MULTIPOLYGON EMPTY", wkt.toWKT(MultiPolygon.EMPTY));
+        assertEquals(MultiPolygon.EMPTY, wkt.fromWKT("MULTIPOLYGON EMPTY)"));
     }
 
     public void testValidation() {
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/PointTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/PointTests.java
index 70920aac49b88..79c9371e58ce6 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/PointTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/PointTests.java
@@ -36,14 +36,14 @@ protected Point createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("point (20.0 10.0)", wkt.toWKT(new Point(20, 10)));
+        assertEquals("POINT (20.0 10.0)", wkt.toWKT(new Point(20, 10)));
         assertEquals(new Point(20, 10), wkt.fromWKT("point (20.0 10.0)"));
 
-        assertEquals("point (20.0 10.0 100.0)", wkt.toWKT(new Point(20, 10, 100)));
-        assertEquals(new Point(20, 10, 100), wkt.fromWKT("point (20.0 10.0 100.0)"));
+        assertEquals("POINT (20.0 10.0 100.0)", wkt.toWKT(new Point(20, 10, 100)));
+        assertEquals(new Point(20, 10, 100), wkt.fromWKT("POINT (20.0 10.0 100.0)"));
 
-        assertEquals("point EMPTY", wkt.toWKT(Point.EMPTY));
-        assertEquals(Point.EMPTY, wkt.fromWKT("point EMPTY)"));
+        assertEquals("POINT EMPTY", wkt.toWKT(Point.EMPTY));
+        assertEquals(Point.EMPTY, wkt.fromWKT("POINT EMPTY)"));
     }
 
     public void testInitValidation() {
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/PolygonTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/PolygonTests.java
index dd2c0552101d6..c90243d253df5 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/PolygonTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/PolygonTests.java
@@ -36,27 +36,27 @@ protected Polygon createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("polygon ((3.0 1.0, 4.0 2.0, 5.0 3.0, 3.0 1.0))",
+        assertEquals("POLYGON ((3.0 1.0, 4.0 2.0, 5.0 3.0, 3.0 1.0))",
             wkt.toWKT(new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1}))));
         assertEquals(new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1})),
-            wkt.fromWKT("polygon ((3 1, 4 2, 5 3, 3 1))"));
+            wkt.fromWKT("POLYGON ((3 1, 4 2, 5 3, 3 1))"));
 
-        assertEquals("polygon ((3.0 1.0 5.0, 4.0 2.0 4.0, 5.0 3.0 3.0, 3.0 1.0 5.0))",
+        assertEquals("POLYGON ((3.0 1.0 5.0, 4.0 2.0 4.0, 5.0 3.0 3.0, 3.0 1.0 5.0))",
             wkt.toWKT(new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1}, new double[]{5, 4, 3, 5}))));
         assertEquals(new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1}, new double[]{5, 4, 3, 5})),
-            wkt.fromWKT("polygon ((3 1 5, 4 2 4, 5 3 3, 3 1 5))"));
+            wkt.fromWKT("POLYGON ((3 1 5, 4 2 4, 5 3 3, 3 1 5))"));
 
         // Auto closing in coerce mode
         assertEquals(new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1})),
-            wkt.fromWKT("polygon ((3 1, 4 2, 5 3))"));
+            wkt.fromWKT("POLYGON ((3 1, 4 2, 5 3))"));
         assertEquals(new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1}, new double[]{5, 4, 3, 5})),
-            wkt.fromWKT("polygon ((3 1 5, 4 2 4, 5 3 3))"));
+            wkt.fromWKT("POLYGON ((3 1 5, 4 2 4, 5 3 3))"));
         assertEquals(new Polygon(new LinearRing(new double[]{3, 4, 5, 3}, new double[]{1, 2, 3, 1}),
             Collections.singletonList(new LinearRing(new double[]{0.5, 2.5, 2.0, 0.5}, new double[]{1.5, 1.5, 1.0, 1.5}))),
-            wkt.fromWKT("polygon ((3 1, 4 2, 5 3, 3 1), (0.5 1.5, 2.5 1.5, 2.0 1.0))"));
+            wkt.fromWKT("POLYGON ((3 1, 4 2, 5 3, 3 1), (0.5 1.5, 2.5 1.5, 2.0 1.0))"));
 
-        assertEquals("polygon EMPTY", wkt.toWKT(Polygon.EMPTY));
-        assertEquals(Polygon.EMPTY, wkt.fromWKT("polygon EMPTY)"));
+        assertEquals("POLYGON EMPTY", wkt.toWKT(Polygon.EMPTY));
+        assertEquals(Polygon.EMPTY, wkt.fromWKT("POLYGON EMPTY)"));
     }
 
     public void testInitValidation() {
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/RectangleTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/RectangleTests.java
index b613e5b191f19..32ce6abe8de6e 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/RectangleTests.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/RectangleTests.java
@@ -37,11 +37,11 @@ protected Rectangle createTestInstance(boolean hasAlt) {
 
     public void testBasicSerialization() throws IOException, ParseException {
         WellKnownText wkt = new WellKnownText(true, new GeographyValidator(true));
-        assertEquals("bbox (10.0, 20.0, 40.0, 30.0)", wkt.toWKT(new Rectangle(10, 20, 40, 30)));
-        assertEquals(new Rectangle(10, 20, 40, 30), wkt.fromWKT("bbox (10.0, 20.0, 40.0, 30.0)"));
+        assertEquals("BBOX (10.0, 20.0, 40.0, 30.0)", wkt.toWKT(new Rectangle(10, 20, 40, 30)));
+        assertEquals(new Rectangle(10, 20, 40, 30), wkt.fromWKT("BBOX (10.0, 20.0, 40.0, 30.0)"));
 
-        assertEquals("bbox EMPTY", wkt.toWKT(Rectangle.EMPTY));
-        assertEquals(Rectangle.EMPTY, wkt.fromWKT("bbox EMPTY)"));
+        assertEquals("BBOX EMPTY", wkt.toWKT(Rectangle.EMPTY));
+        assertEquals(Rectangle.EMPTY, wkt.fromWKT("BBOX EMPTY)"));
     }
 
     public void testInitValidation() {
diff --git a/server/src/test/java/org/elasticsearch/common/geo/GeometryParserTests.java b/server/src/test/java/org/elasticsearch/common/geo/GeometryParserTests.java
index fc3dc43294ba0..df4b47f23689f 100644
--- a/server/src/test/java/org/elasticsearch/common/geo/GeometryParserTests.java
+++ b/server/src/test/java/org/elasticsearch/common/geo/GeometryParserTests.java
@@ -113,7 +113,7 @@ public void testWKTParsing() throws Exception {
             XContentBuilder newGeoJson = XContentFactory.jsonBuilder().startObject().field("val");
             format.toXContent(new Point(100, 10), newGeoJson, ToXContent.EMPTY_PARAMS);
             newGeoJson.endObject();
-            assertEquals("{\"val\":\"point (100.0 10.0)\"}", Strings.toString(newGeoJson));
+            assertEquals("{\"val\":\"POINT (100.0 10.0)\"}", Strings.toString(newGeoJson));
         }
 
         // Make sure we can parse values outside the normal lat lon boundaries
diff --git a/x-pack/plugin/sql/qa/src/main/resources/docs/geo.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/docs/geo.csv-spec
index 1307079e216ca..899147fd3e6d9 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/docs/geo.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/docs/geo.csv-spec
@@ -15,7 +15,7 @@ selectAsWKT
 SELECT city, ST_AsWKT(location) location FROM "geo" WHERE city = 'Amsterdam';
 
      city:s    |     location:s
-Amsterdam      |point (4.850311987102032 52.347556999884546)
+Amsterdam      |POINT (4.850311987102032 52.347556999884546)
 // end::aswkt
 ;
 
@@ -24,7 +24,7 @@ selectWKTToSQL
 SELECT CAST(ST_WKTToSQL('POINT (10 20)') AS STRING) location;
 
    location:s
-point (10.0 20.0)
+POINT (10.0 20.0)
 // end::wkttosql
 ;
 
diff --git a/x-pack/plugin/sql/qa/src/main/resources/geo/geosql.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/geo/geosql.csv-spec
index e63f4325cb0e7..ad31e3dbe9dd3 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/geo/geosql.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/geo/geosql.csv-spec
@@ -33,21 +33,21 @@ selectAllPointsAsStrings
 SELECT city, CAST(location AS STRING) location, CAST(location_no_dv AS STRING) location_no_dv, CAST(geoshape AS STRING) geoshape, CAST(shape AS STRING) shape, region FROM "geo" ORDER BY "city";
 
      city:s    |             location:s                       |      location_no_dv:s        |             geoshape:s            |               shape:s             |  region:s
-Amsterdam      |point (4.850311987102032 52.347556999884546)  |point (4.850312 52.347557)    |point (4.850312 52.347557 2.0)     |point (4.850312 52.347557 2.0)     |Europe
-Berlin         |point (13.390888944268227 52.48670099303126)  |point (13.390889 52.486701)   |point (13.390889 52.486701 34.0)   |point (13.390889 52.486701 34.0)   |Europe
-Chicago        |point (-87.63787407428026 41.888782968744636) |point (-87.637874 41.888783)  |point (-87.637874 41.888783 181.0) |point (-87.637874 41.888783 181.0) |Americas
-Hong Kong      |point (114.18392493389547 22.28139698971063)  |point (114.183925 22.281397)  |point (114.183925 22.281397 552.0) |point (114.183925 22.281397 552.0) |Asia
-London         |point (-0.12167204171419144 51.51087098289281)|point (-0.121672 51.510871)   |point (-0.121672 51.510871 11.0)   |point (-0.121672 51.510871 11.0)   |Europe
-Mountain View  |point (-122.08384302444756 37.38648299127817) |point (-122.083843 37.386483) |point (-122.083843 37.386483 30.0) |point (-122.083843 37.386483 30.0) |Americas
-Munich         |point (11.537504978477955 48.14632098656148)  |point (11.537505 48.146321)   |point (11.537505 48.146321 519.0)  |point (11.537505 48.146321 519.0)  |Europe
-New York       |point (-73.9900270756334 40.74517097789794)   |point (-73.990027 40.745171)  |point (-73.990027 40.745171 10.0)  |point (-73.990027 40.745171 10.0)  |Americas
-Paris          |point (2.3517729341983795 48.84553796611726)  |point (2.351773 48.845538)    |point (2.351773 48.845538 35.0)    |point (2.351773 48.845538 35.0)    |Europe
-Phoenix        |point (-111.97350500151515 33.37624196894467) |point (-111.973505 33.376242) |point (-111.973505 33.376242 331.0)|point (-111.973505 33.376242 331.0)|Americas
-San Francisco  |point (-122.39422800019383 37.789540970698)   |point (-122.394228 37.789541) |point (-122.394228 37.789541 16.0) |point (-122.394228 37.789541 16.0) |Americas
-Seoul          |point (127.06085099838674 37.50913198571652)  |point (127.060851 37.509132)  |point (127.060851 37.509132 38.0)  |point (127.060851 37.509132 38.0)  |Asia
-Singapore      |point (103.8555349688977 1.2958679627627134)  |point (103.855535 1.295868)   |point (103.855535 1.295868 15.0)   |point (103.855535 1.295868 15.0)   |Asia
-Sydney         |point (151.20862897485495 -33.863385021686554)|point (151.208629 -33.863385) |point (151.208629 -33.863385 100.0)|point (151.208629 -33.863385 100.0)|Asia
-Tokyo          |point (139.76402222178876 35.66961596254259)  |point (139.76402225 35.669616)|point (139.76402225 35.669616 40.0)|point (139.76402225 35.669616 40.0)|Asia
+Amsterdam      |POINT (4.850311987102032 52.347556999884546)  |POINT (4.850312 52.347557)    |POINT (4.850312 52.347557 2.0)     |POINT (4.850312 52.347557 2.0)     |Europe
+Berlin         |POINT (13.390888944268227 52.48670099303126)  |POINT (13.390889 52.486701)   |POINT (13.390889 52.486701 34.0)   |POINT (13.390889 52.486701 34.0)   |Europe
+Chicago        |POINT (-87.63787407428026 41.888782968744636) |POINT (-87.637874 41.888783)  |POINT (-87.637874 41.888783 181.0) |POINT (-87.637874 41.888783 181.0) |Americas
+Hong Kong      |POINT (114.18392493389547 22.28139698971063)  |POINT (114.183925 22.281397)  |POINT (114.183925 22.281397 552.0) |POINT (114.183925 22.281397 552.0) |Asia
+London         |POINT (-0.12167204171419144 51.51087098289281)|POINT (-0.121672 51.510871)   |POINT (-0.121672 51.510871 11.0)   |POINT (-0.121672 51.510871 11.0)   |Europe
+Mountain View  |POINT (-122.08384302444756 37.38648299127817) |POINT (-122.083843 37.386483) |POINT (-122.083843 37.386483 30.0) |POINT (-122.083843 37.386483 30.0) |Americas
+Munich         |POINT (11.537504978477955 48.14632098656148)  |POINT (11.537505 48.146321)   |POINT (11.537505 48.146321 519.0)  |POINT (11.537505 48.146321 519.0)  |Europe
+New York       |POINT (-73.9900270756334 40.74517097789794)   |POINT (-73.990027 40.745171)  |POINT (-73.990027 40.745171 10.0)  |POINT (-73.990027 40.745171 10.0)  |Americas
+Paris          |POINT (2.3517729341983795 48.84553796611726)  |POINT (2.351773 48.845538)    |POINT (2.351773 48.845538 35.0)    |POINT (2.351773 48.845538 35.0)    |Europe
+Phoenix        |POINT (-111.97350500151515 33.37624196894467) |POINT (-111.973505 33.376242) |POINT (-111.973505 33.376242 331.0)|POINT (-111.973505 33.376242 331.0)|Americas
+San Francisco  |POINT (-122.39422800019383 37.789540970698)   |POINT (-122.394228 37.789541) |POINT (-122.394228 37.789541 16.0) |POINT (-122.394228 37.789541 16.0) |Americas
+Seoul          |POINT (127.06085099838674 37.50913198571652)  |POINT (127.060851 37.509132)  |POINT (127.060851 37.509132 38.0)  |POINT (127.060851 37.509132 38.0)  |Asia
+Singapore      |POINT (103.8555349688977 1.2958679627627134)  |POINT (103.855535 1.295868)   |POINT (103.855535 1.295868 15.0)   |POINT (103.855535 1.295868 15.0)   |Asia
+Sydney         |POINT (151.20862897485495 -33.863385021686554)|POINT (151.208629 -33.863385) |POINT (151.208629 -33.863385 100.0)|POINT (151.208629 -33.863385 100.0)|Asia
+Tokyo          |POINT (139.76402222178876 35.66961596254259)  |POINT (139.76402225 35.669616)|POINT (139.76402225 35.669616 40.0)|POINT (139.76402225 35.669616 40.0)|Asia
 ;
 
 // TODO: Both shape and location contain the same data for now, we should change it later to make things more interesting
@@ -55,28 +55,28 @@ selectAllPointsAsWKT
 SELECT city, ST_ASWKT(location) location_wkt, ST_ASWKT(geoshape) geoshape_wkt, region FROM "geo" ORDER BY "city";
 
      city:s    |                     location_wkt:s           |        geoshape_wkt:s              |  region:s
-Amsterdam      |point (4.850311987102032 52.347556999884546)  |point (4.850312 52.347557 2.0)      |Europe
-Berlin         |point (13.390888944268227 52.48670099303126)  |point (13.390889 52.486701 34.0)    |Europe
-Chicago        |point (-87.63787407428026 41.888782968744636) |point (-87.637874 41.888783 181.0)  |Americas
-Hong Kong      |point (114.18392493389547 22.28139698971063)  |point (114.183925 22.281397 552.0)  |Asia
-London         |point (-0.12167204171419144 51.51087098289281)|point (-0.121672 51.510871 11.0)    |Europe
-Mountain View  |point (-122.08384302444756 37.38648299127817) |point (-122.083843 37.386483 30.0)  |Americas
-Munich         |point (11.537504978477955 48.14632098656148)  |point (11.537505 48.146321 519.0)   |Europe
-New York       |point (-73.9900270756334 40.74517097789794)   |point (-73.990027 40.745171 10.0)   |Americas
-Paris          |point (2.3517729341983795 48.84553796611726)  |point (2.351773 48.845538 35.0)     |Europe
-Phoenix        |point (-111.97350500151515 33.37624196894467) |point (-111.973505 33.376242 331.0) |Americas
-San Francisco  |point (-122.39422800019383 37.789540970698)   |point (-122.394228 37.789541 16.0)  |Americas
-Seoul          |point (127.06085099838674 37.50913198571652)  |point (127.060851 37.509132 38.0)   |Asia
-Singapore      |point (103.8555349688977 1.2958679627627134)  |point (103.855535 1.295868 15.0)    |Asia
-Sydney         |point (151.20862897485495 -33.863385021686554)|point (151.208629 -33.863385 100.0) |Asia
-Tokyo          |point (139.76402222178876 35.66961596254259)  |point (139.76402225 35.669616 40.0) |Asia
+Amsterdam      |POINT (4.850311987102032 52.347556999884546)  |POINT (4.850312 52.347557 2.0)      |Europe
+Berlin         |POINT (13.390888944268227 52.48670099303126)  |POINT (13.390889 52.486701 34.0)    |Europe
+Chicago        |POINT (-87.63787407428026 41.888782968744636) |POINT (-87.637874 41.888783 181.0)  |Americas
+Hong Kong      |POINT (114.18392493389547 22.28139698971063)  |POINT (114.183925 22.281397 552.0)  |Asia
+London         |POINT (-0.12167204171419144 51.51087098289281)|POINT (-0.121672 51.510871 11.0)    |Europe
+Mountain View  |POINT (-122.08384302444756 37.38648299127817) |POINT (-122.083843 37.386483 30.0)  |Americas
+Munich         |POINT (11.537504978477955 48.14632098656148)  |POINT (11.537505 48.146321 519.0)   |Europe
+New York       |POINT (-73.9900270756334 40.74517097789794)   |POINT (-73.990027 40.745171 10.0)   |Americas
+Paris          |POINT (2.3517729341983795 48.84553796611726)  |POINT (2.351773 48.845538 35.0)     |Europe
+Phoenix        |POINT (-111.97350500151515 33.37624196894467) |POINT (-111.973505 33.376242 331.0) |Americas
+San Francisco  |POINT (-122.39422800019383 37.789540970698)   |POINT (-122.394228 37.789541 16.0)  |Americas
+Seoul          |POINT (127.06085099838674 37.50913198571652)  |POINT (127.060851 37.509132 38.0)   |Asia
+Singapore      |POINT (103.8555349688977 1.2958679627627134)  |POINT (103.855535 1.295868 15.0)    |Asia
+Sydney         |POINT (151.20862897485495 -33.863385021686554)|POINT (151.208629 -33.863385 100.0) |Asia
+Tokyo          |POINT (139.76402222178876 35.66961596254259)  |POINT (139.76402225 35.669616 40.0) |Asia
 ;
 
 selectWithAsWKTInWhere
 SELECT city, ST_ASWKT(location) location_wkt, region FROM "geo" WHERE LOCATE('114', ST_ASWKT(location)) > 0 ORDER BY "city";
 
      city:s    |                   location_wkt:s           |  region:s
-Hong Kong      |point (114.18392493389547 22.28139698971063)|Asia
+Hong Kong      |POINT (114.18392493389547 22.28139698971063)|Asia
 ;
 
 selectAllPointsOrderByLonFromAsWKT
@@ -112,30 +112,30 @@ selectRegionUsingWktToSql
 SELECT region, city, ST_ASWKT(ST_WKTTOSQL(region_point)) region_wkt  FROM geo ORDER BY region, city;
 
    region:s    |    city:s     |       region_wkt:s
-Americas       |Chicago        |point (-105.2551 54.526)
-Americas       |Mountain View  |point (-105.2551 54.526)
-Americas       |New York       |point (-105.2551 54.526)
-Americas       |Phoenix        |point (-105.2551 54.526)
-Americas       |San Francisco  |point (-105.2551 54.526)
-Asia           |Hong Kong      |point (100.6197 34.0479)
-Asia           |Seoul          |point (100.6197 34.0479)
-Asia           |Singapore      |point (100.6197 34.0479)
-Asia           |Sydney         |point (100.6197 34.0479)
-Asia           |Tokyo          |point (100.6197 34.0479)
-Europe         |Amsterdam      |point (15.2551 54.526)
-Europe         |Berlin         |point (15.2551 54.526)
-Europe         |London         |point (15.2551 54.526)
-Europe         |Munich         |point (15.2551 54.526)
-Europe         |Paris          |point (15.2551 54.526)
+Americas       |Chicago        |POINT (-105.2551 54.526)
+Americas       |Mountain View  |POINT (-105.2551 54.526)
+Americas       |New York       |POINT (-105.2551 54.526)
+Americas       |Phoenix        |POINT (-105.2551 54.526)
+Americas       |San Francisco  |POINT (-105.2551 54.526)
+Asia           |Hong Kong      |POINT (100.6197 34.0479)
+Asia           |Seoul          |POINT (100.6197 34.0479)
+Asia           |Singapore      |POINT (100.6197 34.0479)
+Asia           |Sydney         |POINT (100.6197 34.0479)
+Asia           |Tokyo          |POINT (100.6197 34.0479)
+Europe         |Amsterdam      |POINT (15.2551 54.526)
+Europe         |Berlin         |POINT (15.2551 54.526)
+Europe         |London         |POINT (15.2551 54.526)
+Europe         |Munich         |POINT (15.2551 54.526)
+Europe         |Paris          |POINT (15.2551 54.526)
 ;
 
 selectCitiesWithAGroupByWktToSql
 SELECT COUNT(city) city_by_region, CAST(ST_WKTTOSQL(region_point) AS STRING) region FROM geo WHERE city LIKE '%a%' GROUP BY ST_WKTTOSQL(region_point) ORDER BY ST_WKTTOSQL(region_point);
 
  city_by_region:l    |       region:s
-3                    |point (-105.2551 54.526)
-1                    |point (100.6197 34.0479)
-2                    |point (15.2551 54.526)
+3                    |POINT (-105.2551 54.526)
+1                    |POINT (100.6197 34.0479)
+2                    |POINT (15.2551 54.526)
 ;
 
 selectCitiesWithEOrderByWktToSql
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessorTests.java
index 07cc6171cf013..b14a61945cf41 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessorTests.java
@@ -33,8 +33,8 @@ protected GeoProcessor mutateInstance(GeoProcessor instance) throws IOException
     }
 
     public void testApplyAsWKT() throws Exception {
-        assertEquals("point (10.0 20.0)", new GeoProcessor(GeoOperation.ASWKT).process(new GeoShape(10, 20)));
-        assertEquals("point (10.0 20.0)", new GeoProcessor(GeoOperation.ASWKT).process(new GeoShape("POINT (10 20)")));
+        assertEquals("POINT (10.0 20.0)", new GeoProcessor(GeoOperation.ASWKT).process(new GeoShape(10, 20)));
+        assertEquals("POINT (10.0 20.0)", new GeoProcessor(GeoOperation.ASWKT).process(new GeoShape("POINT (10 20)")));
     }
 
     public void testApplyGeometryType() throws Exception {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessorTests.java
index 82a580d159cb8..8c2d61ed80094 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessorTests.java
@@ -21,7 +21,7 @@ public void testApply() {
         Object result = proc.process("POINT (10 20)");
         assertThat(result, instanceOf(GeoShape.class));
         GeoShape geoShape = (GeoShape) result;
-        assertEquals("point (10.0 20.0)", geoShape.toString());
+        assertEquals("POINT (10.0 20.0)", geoShape.toString());
     }
 
     public void testTypeCheck() {
@@ -46,6 +46,6 @@ public void testCoerce() {
         Object result = proc.process("POLYGON ((3 1 5, 4 2 4, 5 3 3))");
         assertThat(result, instanceOf(GeoShape.class));
         GeoShape geoShape = (GeoShape) result;
-        assertEquals("polygon ((3.0 1.0 5.0, 4.0 2.0 4.0, 5.0 3.0 3.0, 3.0 1.0 5.0))", geoShape.toString());
+        assertEquals("POLYGON ((3.0 1.0 5.0, 4.0 2.0 4.0, 5.0 3.0 3.0, 3.0 1.0 5.0))", geoShape.toString());
     }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
index 41da90ad3164f..0007398fbb83a 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
@@ -309,7 +309,7 @@ private void testDateRangeWithCurrentFunctions(String function, String pattern,
         assertEquals(operator.equals("=") || operator.equals("!=") || operator.equals(">="), rq.includeLower());
         assertEquals(pattern, rq.format());
     }
-    
+
     private void testDateRangeWithCurrentFunctions_AndRangeOptimization(String function, String pattern, ZonedDateTime lowerValue,
             ZonedDateTime upperValue) {
         String lowerOperator = randomFrom(new String[] {"<", "<="});
@@ -324,7 +324,7 @@ private void testDateRangeWithCurrentFunctions_AndRangeOptimization(String funct
         assertEquals(1, eqe.output().size());
         assertEquals("test.some.string", eqe.output().get(0).qualifiedName());
         assertEquals(DataType.TEXT, eqe.output().get(0).dataType());
-        
+
         Query query = eqe.queryContainer().query();
         // the range queries optimization should create a single "range" query with "from" and "to" populated with the values
         // in the two branches of the AND condition
@@ -820,7 +820,7 @@ public void testTranslateStWktToSql() {
                 "InternalSqlScriptUtils.eq(InternalSqlScriptUtils.stWktToSql(" +
                 "InternalSqlScriptUtils.docValue(doc,params.v0)),InternalSqlScriptUtils.stWktToSql(params.v1)))",
             aggFilter.scriptTemplate().toString());
-        assertEquals("[{v=keyword}, {v=point (10.0 20.0)}]", aggFilter.scriptTemplate().params().toString());
+        assertEquals("[{v=keyword}, {v=POINT (10.0 20.0)}]", aggFilter.scriptTemplate().params().toString());
     }
 
     public void testTranslateStDistanceToScript() {
@@ -840,7 +840,7 @@ public void testTranslateStDistanceToScript() {
                 "InternalSqlScriptUtils.stDistance(" +
                 "InternalSqlScriptUtils.geoDocValue(doc,params.v0),InternalSqlScriptUtils.stWktToSql(params.v1)),params.v2))",
             sc.script().toString());
-        assertEquals("[{v=point}, {v=point (10.0 20.0)}, {v=20}]", sc.script().params().toString());
+        assertEquals("[{v=point}, {v=POINT (10.0 20.0)}, {v=20}]", sc.script().params().toString());
     }
 
     public void testTranslateStDistanceToQuery() {

From 2834550dc8f53c710bd8b700da76f39dfd6afb20 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Wed, 18 Dec 2019 09:50:31 -0800
Subject: [PATCH 256/686] [DOCS] Move machine learning results definitions into
 APIs (#50257)

---
 .../apis/get-bucket.asciidoc                  | 123 ++++-
 .../apis/get-category.asciidoc                |  60 ++-
 .../apis/get-influencer.asciidoc              | 111 ++--
 .../apis/get-overall-buckets.asciidoc         |  54 +-
 .../apis/get-record.asciidoc                  | 208 ++++++--
 .../apis/resultsresource.asciidoc             | 479 ------------------
 docs/reference/ml/ml-shared.asciidoc          |  23 +
 docs/reference/redirects.asciidoc             |  17 +
 docs/reference/rest-api/defs.asciidoc         |   2 -
 9 files changed, 471 insertions(+), 606 deletions(-)
 delete mode 100644 docs/reference/ml/anomaly-detection/apis/resultsresource.asciidoc

diff --git a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
index 027de1385e83f..f06632bcbd54f 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
@@ -40,50 +40,133 @@ bucket.
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<timestamp>`::
-  (Optional, string) The timestamp of a single bucket result. If you do not
-  specify this parameter, the API returns information about all buckets.
+(Optional, string) The timestamp of a single bucket result. If you do not
+specify this parameter, the API returns information about all buckets.
 
 [[ml-get-bucket-request-body]]
 ==== {api-request-body-title}
 
 `anomaly_score`::
-  (Optional, double) Returns buckets with anomaly scores greater or equal than
-  this value.
+(Optional, double) Returns buckets with anomaly scores greater or equal than
+this value.
 
 `desc`::
-  (Optional, boolean) If true, the buckets are sorted in descending order.
+(Optional, boolean) If true, the buckets are sorted in descending order.
 
 `end`::
-  (Optional, string) Returns buckets with timestamps earlier than this time.
+(Optional, string) Returns buckets with timestamps earlier than this time.
 
 `exclude_interim`::
-  (Optional, boolean) If true, the output excludes interim results. By default,
-  interim results are included.
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 
 `expand`::
-  (Optional, boolean) If true, the output includes anomaly records.
+(Optional, boolean) If true, the output includes anomaly records.
 
 `page`::
-`from`:::
-  (Optional, integer) Skips the specified number of buckets.
-`size`:::
-  (Optional, integer) Specifies the maximum number of buckets to obtain.
+`page`.`from`:::
+(Optional, integer) Skips the specified number of buckets.
+`page`.`size`:::
+(Optional, integer) Specifies the maximum number of buckets to obtain.
 
 `sort`::
-  (Optional, string) Specifies the sort field for the requested buckets. By
-  default, the buckets are sorted by the `timestamp` field.
+(Optional, string) Specifies the sort field for the requested buckets. By
+default, the buckets are sorted by the `timestamp` field.
 
 `start`::
-  (Optional, string) Returns buckets with timestamps after this time.
+(Optional, string) Returns buckets with timestamps after this time.
 
 [[ml-get-bucket-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of bucket objects, which have the following properties:
 
-`buckets`::
-  (array) An array of bucket objects. For more information, see
-  <<ml-results-buckets,Buckets>>.
+`anomaly_score`::
+(number) The maximum anomaly score, between 0-100, for any of the bucket
+influencers. This is an overall, rate-limited score for the job. All the anomaly 
+records in the bucket contribute to this score. This value might be updated as
+new data is analyzed.
+
+`bucket_influencers`::
+(array) An array of bucket influencer objects, which have the following
+properties:
+
+`bucket_influencers`.`anomaly_score`:::
+(number) A normalized score between 0-100, which is calculated for each bucket
+influencer. This score might be updated as newer data is analyzed.
+
+`bucket_influencers`.`bucket_span`:::
+(number) The length of the bucket in seconds. This value matches the `bucket_span`
+that is specified in the job.
+
+`bucket_influencers`.`initial_anomaly_score`:::
+(number) The score between 0-100 for each bucket influencer. This score is the
+initial value that was calculated at the time the bucket was processed.
+
+`bucket_influencers`.`influencer_field_name`:::
+(string) The field name of the influencer.
+
+`bucket_influencers`.`influencer_field_value`:::
+(string) The field value of the influencer. 
+
+`bucket_influencers`.`is_interim`:::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+
+`bucket_influencers`.`job_id`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`bucket_influencers`.`probability`:::
+(number) The probability that the bucket has this behavior, in the range 0 to 1.
+This value can be held to a high precision of over 300 decimal places, so the
+`anomaly_score` is provided as a human-readable and friendly interpretation of
+this.
+
+`bucket_influencers`.`raw_anomaly_score`:::
+(number) Internal.
+
+`bucket_influencers`.`result_type`:::
+(string) Internal. This value is always set to `bucket_influencer`.
+
+`bucket_influencers`.`timestamp`:::
+(date) The start time of the bucket for which these results were calculated.
+
+`bucket_span`::
+(number)
+include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
+
+`event_count`::
+(number) The number of input data records processed in this bucket.
+
+`initial_anomaly_score`::
+(number) The maximum `anomaly_score` for any of the bucket influencers. This is
+the initial value that was calculated at the time the bucket was processed.
+
+`is_interim`::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+
+`job_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`processing_time_ms`::
+(number) The amount of time, in milliseconds, that it took to analyze the
+bucket contents and calculate results.
+
+`result_type`::
+(string) Internal. This value is always set to `bucket`.
+
+`timestamp`::
+(date) The start time of the bucket. This timestamp uniquely identifies the
+bucket. 
++
+--
+NOTE: Events that occur exactly at the timestamp of the bucket are included in
+the results for the bucket.
+
+--
 
 [[ml-get-bucket-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
index 3280b79534f50..92beaa0360b5e 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
@@ -28,7 +28,15 @@ privileges. See <<security-privileges>> and
 [[ml-get-category-desc]]
 ==== {api-description-title}
 
-For more information about categories, see
+When `categorization_field_name` is specified in the job configuration, it is
+possible to view the definitions of the resulting categories. A category
+definition describes the common terms matched and contains examples of matched
+values.
+
+The anomaly results from a categorization analysis are available as bucket,
+influencer, and record results. For example, the results might indicate that
+at 16:45 there was an unusual count of log message category 11. You can then
+examine the description and examples of that category. For more information, see
 {stack-ov}/ml-configuring-categories.html[Categorizing log messages].
 
 [[ml-get-category-path-parms]]
@@ -39,34 +47,55 @@ For more information about categories, see
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<category_id>`::
-  (Optional, long) Identifier for the category. If you do not specify this
-  parameter, the API returns information about all categories in the
-  {anomaly-job}.
+(Optional, long) Identifier for the category. If you do not specify this
+parameter, the API returns information about all categories in the {anomaly-job}.
 
 [[ml-get-category-request-body]]
 ==== {api-request-body-title}
 
 `page`::
-`from`:::
-  (Optional, integer) Skips the specified number of categories.
-`size`:::
-  (Optional, integer) Specifies the maximum number of categories to obtain.
+`page`.`from`:::
+(Optional, integer) Skips the specified number of categories.
+`page`.`size`:::
+(Optional, integer) Specifies the maximum number of categories to obtain.
 
 [[ml-get-category-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of category objects, which have the following properties:
 
-`categories`::
-  (array) An array of category objects. For more information, see
-  <<ml-results-categories,Categories>>.
+`category_id`::
+(unsigned integer) A unique identifier for the category.
+
+`examples`::
+(array) A list of examples of actual values that matched the category.
+
+`grok_pattern`::
+experimental[] (string) A Grok pattern that could be used in {ls} or an ingest 
+pipeline to extract fields from messages that match the category. This field is experimental and may be changed or removed in a future release. The Grok
+patterns that are found are not optimal, but are often a good starting point for
+manual tweaking.
+
+`job_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`max_matching_length`::
+(unsigned integer) The maximum length of the fields that matched the category.
+The value is increased by 10% to enable matching for similar fields that have
+not been analyzed.
+
+`regex`::
+(string) A regular expression that is used to search for values that match the
+category.
+
+`terms`::
+(string) A space separated list of the common tokens that are matched in values
+of the category.
 
 [[ml-get-category-example]]
 ==== {api-examples-title}
 
-The following example gets information about one category for the
-`esxi_log` job:
-
 [source,console]
 --------------------------------------------------
 GET _ml/anomaly_detectors/esxi_log/results/categories
@@ -78,7 +107,6 @@ GET _ml/anomaly_detectors/esxi_log/results/categories
 --------------------------------------------------
 // TEST[skip:todo]
 
-In this example, the API returns the following information:
 [source,js]
 ----
 {
diff --git a/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
index 2165d8ef9f7f9..e2727a04dc07c 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
@@ -23,6 +23,13 @@ need `read` index privilege on the index that stores the results. The
 privileges. See <<security-privileges>> and
 <<built-in-roles>>.
 
+[[ml-get-influencer-desc]]
+==== {api-description-title}
+
+Influencers are the entities that have contributed to, or are to blame for,
+the anomalies. Influencer results are available only if an
+`influencer_field_name` is specified in the job configuration.
+
 [[ml-get-influencer-path-parms]]
 ==== {api-path-parms-title}
 
@@ -34,75 +41,119 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 ==== {api-request-body-title}
 
 `desc`::
-  (Optional, boolean) If true, the results are sorted in descending order.
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=desc-results]
 
 `end`::
-  (Optional, string) Returns influencers with timestamps earlier than this time.
+(Optional, string) Returns influencers with timestamps earlier than this time.
 
 `exclude_interim`::
-  (Optional, boolean) If true, the output excludes interim results. By default,
-  interim results are included.
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 
 `influencer_score`::
-  (Optional, double) Returns influencers with anomaly scores greater than or
-  equal to this value.
+(Optional, double) Returns influencers with anomaly scores greater than or
+equal to this value.
 
 `page`::
 `from`:::
-    (Optional, integer) Skips the specified number of influencers.
+(Optional, integer) Skips the specified number of influencers.
 `size`:::
-  (Optional, integer) Specifies the maximum number of influencers to obtain.
+(Optional, integer) Specifies the maximum number of influencers to obtain.
 
 `sort`::
-  (Optional, string) Specifies the sort field for the requested influencers. By
-  default, the influencers are sorted by the `influencer_score` value.
+(Optional, string) Specifies the sort field for the requested influencers. By
+default, the influencers are sorted by the `influencer_score` value.
 
 `start`::
-  (Optional, string) Returns influencers with timestamps after this time.
+(Optional, string) Returns influencers with timestamps after this time.
 
 [[ml-get-influencer-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of influencer objects, which have the following
+properties:
+
+`bucket_span`::
+(number)
+include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
+
+`influencer_score`::
+(number) A normalized score between 0-100, which is based on the probability of
+the influencer in this bucket aggregated across detectors. Unlike
+`initial_influencer_score`, this value will be updated by a re-normalization
+process as new data is analyzed.
+
+`influencer_field_name`::
+(string) The field name of the influencer.
+
+`influencer_field_value`::
+(string) The entity that influenced, contributed to, or was to blame for the
+anomaly.
+
+`initial_influencer_score`::
+(number) A normalized score between 0-100, which is based on the probability of
+the influencer aggregated across detectors. This is the initial value that was
+calculated at the time the bucket was processed.
 
-`influencers`::
-  (array) An array of influencer objects.
-  For more information, see <<ml-results-influencers,Influencers>>.
+`is_interim`::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+
+`job_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`probability`::
+(number) The probability that the influencer has this behavior, in the range 0
+to 1. For example, 0.0000109783. This value can be held to a high precision of
+over 300 decimal places, so the `influencer_score` is provided as a
+human-readable and friendly interpretation of this.
+
+`result_type`::
+(string) Internal. This value is always set to `influencer`.
+
+`timestamp`::
+(date)
+include::{docdir}/ml/ml-shared.asciidoc[tag=timestamp-results]
+
+NOTE: Additional influencer properties are added, depending on the fields being
+analyzed. For example, if it's analyzing `user_name` as an influencer, then a
+field `user_name` is added to the result document. This information enables you to
+filter the anomaly results more easily.
 
 [[ml-get-influencer-example]]
 ==== {api-examples-title}
 
-The following example gets influencer information for the `it_ops_new_kpi` job:
-
 [source,console]
 --------------------------------------------------
-GET _ml/anomaly_detectors/it_ops_new_kpi/results/influencers
+GET _ml/anomaly_detectors/high_sum_total_sales/results/influencers
 {
   "sort": "influencer_score",
   "desc": true
 }
 --------------------------------------------------
-// TEST[skip:todo]
+// TEST[skip:Kibana sample data]
 
 In this example, the API returns the following information, sorted based on the
 influencer score in descending order:
 [source,js]
 ----
 {
-  "count": 28,
+  "count": 189,
   "influencers": [
     {
-      "job_id": "it_ops_new_kpi",
+      "job_id": "high_sum_total_sales",
       "result_type": "influencer",
-      "influencer_field_name": "kpi_indicator",
-      "influencer_field_value": "online_purchases",
-      "kpi_indicator": "online_purchases",
-      "influencer_score": 94.1386,
-      "initial_influencer_score": 94.1386,
-      "probability": 0.000111612,
-      "bucket_span": 600,
-      "is_interim": false,
-      "timestamp": 1454943600000
+      "influencer_field_name": "customer_full_name.keyword",
+      "influencer_field_value": "Wagdi Shaw",
+      "customer_full_name.keyword" : "Wagdi Shaw",
+      "influencer_score": 99.02493,
+      "initial_influencer_score" : 94.67233079580171,
+      "probability" : 1.4784807245686567E-10,
+      "bucket_span" : 3600,
+      "is_interim" : false,
+      "timestamp" : 1574661600000
     },
   ...
   ]
diff --git a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
index 62acd7902b9ff..3c0df917e4b3c 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
@@ -54,6 +54,8 @@ a span equal to the jobs' largest bucket span.
 [[ml-get-overall-buckets-path-parms]]
 ==== {api-path-parms-title}
 
+`<job_id>`::
+(Required, string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-wildcard-list]
 
 [[ml-get-overall-buckets-request-body]]
@@ -64,38 +66,56 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-wildcard-li
 include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 
 `bucket_span`::
-  (Optional, string) The span of the overall buckets. Must be greater or equal
-  to the largest bucket span of the specified {anomaly-jobs}, which is the
-  default value.
+(Optional, string) The span of the overall buckets. Must be greater or equal to
+the largest bucket span of the specified {anomaly-jobs}, which is the default
+value.
 
 `end`::
-  (Optional, string) Returns overall buckets with timestamps earlier than this
-  time.
+(Optional, string) Returns overall buckets with timestamps earlier than this
+time.
 
 `exclude_interim`::
-  (Optional, boolean) If `true`, the output excludes interim overall buckets.
-  Overall buckets are interim if any of the job buckets within the overall
-  bucket interval are interim. By default, interim results are included.
+(Optional, boolean) If `true`, the output excludes interim overall buckets.
+Overall buckets are interim if any of the job buckets within the overall bucket
+interval are interim. By default, interim results are included.
 
 `overall_score`::
-  (Optional, double) Returns overall buckets with overall scores greater or
-  equal than this value.
+(Optional, double) Returns overall buckets with overall scores greater or equal
+than this value.
 
 `start`::
-  (Optional, string) Returns overall buckets with timestamps after this time.
+(Optional, string) Returns overall buckets with timestamps after this time.
 
 `top_n`::
-  (Optional, integer) The number of top {anomaly-job} bucket scores to be used
-  in the `overall_score` calculation. The default value is `1`.
+(Optional, integer) The number of top {anomaly-job} bucket scores to be used in
+the `overall_score` calculation. The default value is `1`.
 
 [[ml-get-overall-buckets-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of overall bucket objects, which have the following
+properties:
 
-`overall_buckets`::
-  (array) An array of overall bucket objects. For more information, see
-  <<ml-results-overall-buckets,Overall Buckets>>.
+`bucket_span`::
+(number) The length of the bucket in seconds. Matches the `bucket_span`
+of the job with the longest one.
+
+`is_interim`::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+
+`jobs`::
+(array) An array of objects that contain the `max_anomaly_score` per `job_id`.
+
+`overall_score`::
+(number) The `top_n` average of the max bucket `anomaly_score` per job.
+
+`result_type`::
+(string) Internal. This is always set to `overall_bucket`.
+
+`timestamp`::
+(date)
+include::{docdir}/ml/ml-shared.asciidoc[tag=timestamp-results]
 
 [[ml-get-overall-buckets-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
index b5bbb15580e19..7e56fc757cb79 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
@@ -22,6 +22,22 @@ need `read` index privilege on the index that stores the results. The
 `machine_learning_admin` and `machine_learning_user` roles provide these
 privileges. See <<security-privileges>> and <<built-in-roles>>.
 
+[[ml-get-record-desc]]
+==== {api-description-title}
+
+Records contain the detailed analytical results. They describe the anomalous
+activity that has been identified in the input data based on the detector
+configuration.
+
+There can be many anomaly records depending on the characteristics and size of
+the input data. In practice, there are often too many to be able to manually
+process them. The {ml-features} therefore perform a sophisticated aggregation of
+the anomaly records into buckets.
+
+The number of record results depends on the number of anomalies found in each
+bucket, which relates to the number of time series being modeled and the number
+of detectors.
+
 [[ml-get-record-path-parms]]
 ==== {api-path-parms-title}
 
@@ -33,83 +49,191 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 ==== {api-request-body-title}
 
 `desc`::
-  (Optional, boolean) If true, the results are sorted in descending order.
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=desc-results]
 
 `end`::
-  (Optional, string) Returns records with timestamps earlier than this time.
+(Optional, string) Returns records with timestamps earlier than this time.
 
 `exclude_interim`::
-  (Optional, boolean) If true, the output excludes interim results. By default,
-  interim results are included.
+(Optional, boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 
 `page`::
-`from`:::
-  (Optional, integer) Skips the specified number of records.
-`size`:::
-  (Optional, integer) Specifies the maximum number of records to obtain.
+`page`.`from`:::
+(Optional, integer) Skips the specified number of records.
+`page`.`size`:::
+(Optional, integer) Specifies the maximum number of records to obtain.
 
 `record_score`::
-  (Optional, double) Returns records with anomaly scores greater or equal than
-  this value.
+(Optional, double) Returns records with anomaly scores greater or equal than
+this value.
 
 `sort`::
-  (Optional, string) Specifies the sort field for the requested records. By
-  default, the records are sorted by the `anomaly_score` value.
+(Optional, string) Specifies the sort field for the requested records. By
+default, the records are sorted by the `anomaly_score` value.
 
 `start`::
-  (Optional, string) Returns records with timestamps after this time.
+(Optional, string) Returns records with timestamps after this time.
 
 [[ml-get-record-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of record objects, which have the following properties:
+
+`actual`::
+(array) The actual value for the bucket.
+
+`bucket_span`::
+(number)
+include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
+
+`by_field_name`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=by-field-name]
+
+`by_field_value`::
+(string) The value of `by_field_name`.
+
+`causes`::
+(array) For population analysis, an over field must be specified in the detector.
+This property contains an array of anomaly records that are the causes for the
+anomaly that has been identified for the over field. If no over fields exist,
+this field is not present. This sub-resource contains the most anomalous records
+for the `over_field_name`. For scalability reasons, a maximum of the 10 most
+significant causes of the anomaly are returned. As part of the core analytical modeling, these low-level anomaly records are aggregated for their parent over
+field record. The causes resource contains similar elements to the record
+resource, namely `actual`, `typical`, `geo_results.actual_point`, 
+`geo_results.typical_point`, `*_field_name` and `*_field_value`. Probability and
+scores are not applicable to causes.
+
+`detector_index`::
+(number) A unique identifier for the detector.
+
+`field_name`::
+(string) Certain functions require a field to operate on, for example, `sum()`.
+For those functions, this value is the name of the field to be analyzed.
+
+`function`::
+(string) The function in which the anomaly occurs, as specified in the detector
+configuration. For example, `max`.
+
+`function_description`::
+(string) The description of the function in which the anomaly occurs, as
+specified in the detector configuration.
+
+`geo_results.actual_point`::
+(string) The actual value for the bucket formatted as a `geo_point`. If the
+detector function is `lat_long`, this is a comma delimited string of the
+latitude and longitude.
+
+`geo_results.typical_point`::
+(string) The typical value for the bucket formatted as a `geo_point`. If the
+detector function is `lat_long`, this is a comma delimited string of the
+latitude and longitude.
+
+`influencers`::
+(array) If `influencers` was specified in the detector configuration, this array
+contains influencers that contributed to or were to blame for an anomaly.
+
+`initial_record_score`::
+(number) A normalized score between 0-100, which is based on the probability of
+the anomalousness of this record. This is the initial value that was calculated
+at the time the bucket was processed.
+
+`is_interim`::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+
+`job_id`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`over_field_name`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=over-field-name]
+
+`over_field_value`::
+(string) The value of `over_field_name`.
+
+`partition_field_name`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=partition-field-name]
+
+`partition_field_value`::
+(string) The value of `partition_field_name`.
+
+`probability`::
+(number) The probability of the individual anomaly occurring, in the range
+0 to 1. For example, 0.0000772031. This value can be held to a high precision
+of over 300 decimal places, so the `record_score` is provided as a
+human-readable and friendly interpretation of this.
+
+`multi_bucket_impact`::
+(number) An indication of how strongly an anomaly is multi bucket or single
+bucket. The value is on a scale of `-5.0` to `+5.0` where `-5.0` means the
+anomaly is purely single bucket and `+5.0` means the anomaly is purely multi
+bucket.
+
+`record_score`::
+(number) A normalized score between 0-100, which is based on the probability of
+the anomalousness of this record. Unlike `initial_record_score`, this value will
+be updated by a re-normalization process as new data is analyzed.
+
+`result_type`::
+(string) Internal. This is always set to `record`.
+
+`timestamp`::
+(date)
+include::{docdir}/ml/ml-shared.asciidoc[tag=timestamp-results]
+
+`typical`::
+(array) The typical value for the bucket, according to analytical modeling.
+
+NOTE: Additional record properties are added, depending on the fields being
+analyzed. For example, if it's analyzing `hostname` as a _by field_, then a field
+`hostname` is added to the result document. This information enables you to
+filter the anomaly results more easily.
 
-`records`::
-  (array) An array of record objects. For more information, see
-  <<ml-results-records>>.
 
 [[ml-get-record-example]]
 ==== {api-examples-title}
 
-The following example gets record information for the `it-ops-kpi` job:
-
 [source,console]
 --------------------------------------------------
-GET _ml/anomaly_detectors/it-ops-kpi/results/records
+GET _ml/anomaly_detectors/low_request_rate/results/records
 {
   "sort": "record_score",
   "desc": true,
   "start": "1454944100000"
 }
 --------------------------------------------------
-// TEST[skip:todo]
+// TEST[skip:Kibana sample data]
 
-In this example, the API returns twelve results for the specified
-time constraints:
 [source,js]
 ----
 {
-  "count": 12,
-  "records": [
+  "count" : 4,
+  "records" : [
     {
-      "job_id": "it-ops-kpi",
-      "result_type": "record",
-      "probability": 0.00000332668,
-      "record_score": 72.9929,
-      "initial_record_score": 65.7923,
-      "bucket_span": 300,
-      "detector_index": 0,
-      "is_interim": false,
-      "timestamp": 1454944200000,
-      "function": "low_sum",
-      "function_description": "sum",
-      "typical": [
-        1806.48
-      ],
-      "actual": [
-        288
+      "job_id" : "low_request_rate",
+      "result_type" : "record",
+      "probability" : 1.3882308899968812E-4,
+      "multi_bucket_impact" : -5.0,
+      "record_score" : 94.98554565630553,
+      "initial_record_score" : 94.98554565630553,
+      "bucket_span" : 3600,
+      "detector_index" : 0,
+      "is_interim" : false,
+      "timestamp" : 1577793600000,
+      "function" : "low_count",
+      "function_description" : "count",
+      "typical" : [
+        28.254208230188834
       ],
-      "field_name": "events_per_min"
+      "actual" : [
+        0.0
+      ]
     },
   ...
   ]
diff --git a/docs/reference/ml/anomaly-detection/apis/resultsresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/resultsresource.asciidoc
deleted file mode 100644
index b35100c24e6ae..0000000000000
--- a/docs/reference/ml/anomaly-detection/apis/resultsresource.asciidoc
+++ /dev/null
@@ -1,479 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-results-resource]]
-=== Results resources
-
-Several different result types are created for each job. You can query anomaly
-results for _buckets_, _influencers_, and _records_ by using the results API.
-Summarized bucket results over multiple jobs can be queried as well; those
-results are called _overall buckets_.
-
-Results are written for each `bucket_span`. The timestamp for the results is the
-start of the bucket time interval.
-
-The results include scores, which are calculated for each anomaly result type and
-each bucket interval. These scores are aggregated in order to reduce noise, and
-normalized in order to identify and rank the most mathematically significant
-anomalies.
-
-Bucket results provide the top level, overall view of the job and are ideal for
-alerts. For example, the bucket results might indicate that at 16:05 the system
-was unusual. This information is a summary of all the anomalies, pinpointing
-when they occurred.
-
-Influencer results show which entities were anomalous and when. For example,
-the influencer results might indicate that at 16:05 `user_name: Bob` was unusual.
-This information is a summary of all the anomalies for each entity, so there
-can be a lot of these results. Once you have identified a notable bucket time,
-you can look to see which entities were significant.
-
-Record results provide details about what the individual anomaly was, when it
-occurred and which entity was involved. For example, the record results might
-indicate that at 16:05 Bob sent 837262434 bytes, when the typical value was
-1067 bytes. Once you have identified a bucket time and perhaps a significant
-entity too, you can drill through to the record results in order to investigate
-the anomalous behavior.
-
-Categorization results contain the definitions of _categories_ that have been
-identified. These are only applicable for jobs that are configured to analyze
-unstructured log data using categorization. These results do not contain a
-timestamp or any calculated scores. For more information, see
-{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
-
-* <<ml-results-buckets,Buckets>>
-* <<ml-results-influencers,Influencers>>
-* <<ml-results-records,Records>>
-* <<ml-results-categories,Categories>>
-* <<ml-results-overall-buckets,Overall Buckets>>
-
-NOTE: All of these resources and properties are informational; you cannot
-change their values.
-
-[float]
-[[ml-results-buckets]]
-==== Buckets
-
-Bucket results provide the top level, overall view of the job and are best for
-alerting.
-
-Each bucket has an `anomaly_score`, which is a statistically aggregated and
-normalized view of the combined anomalousness of all the record results within
-each bucket.
-
-One bucket result is written for each `bucket_span` for each job, even if it is
-not considered to be anomalous. If the bucket is not anomalous, it has an
-`anomaly_score` of zero.
-
-When you identify an anomalous bucket, you can investigate further by expanding
-the bucket resource to show the records as nested objects. Alternatively, you
-can access the records resource directly and filter by the date range.
-
-A bucket resource has the following properties:
-
-`anomaly_score`::
-  (number) The maximum anomaly score, between 0-100, for any of the bucket
-  influencers. This is an overall, rate-limited score for the job. All the
-  anomaly records in the bucket contribute to this score. This value might be
-  updated as new data is analyzed.
-
-`bucket_influencers`::
-  (array) An array of bucket influencer objects.
-  For more information, see <<ml-results-bucket-influencers,Bucket Influencers>>.
-
-`bucket_span`::
-  (number) The length of the bucket in seconds.
-  This value matches the `bucket_span` that is specified in the job.
-
-`event_count`::
-  (number) The number of input data records processed in this bucket.
-
-`initial_anomaly_score`::
-  (number) The maximum `anomaly_score` for any of the bucket influencers.
-  This is the initial value that was calculated at the time the bucket was
-  processed.
-
-`is_interim`::
-  (boolean) If true, this is an interim result. In other words, the bucket
-  results are calculated based on partial input data.
-
-`job_id`::
-  (string) The unique identifier for the job that these results belong to.
-
-`processing_time_ms`::
-  (number) The amount of time, in milliseconds, that it took to analyze the
-  bucket contents and calculate results.
-
-`result_type`::
-  (string) Internal. This value is always set to `bucket`.
-
-`timestamp`::
-  (date) The start time of the bucket. This timestamp uniquely identifies the
-  bucket. +
-
-NOTE: Events that occur exactly at the timestamp of the bucket are included in
-the results for the bucket.
-
-
-[float]
-[[ml-results-bucket-influencers]]
-==== Bucket Influencers
-
-Bucket influencer results are available as nested objects contained within
-bucket results. These results are an aggregation for each type of influencer.
-For example, if both `client_ip` and `user_name` were specified as influencers,
-then you would be able to determine when the `client_ip` or `user_name` values
-were collectively anomalous.
-
-There is a built-in bucket influencer called `bucket_time` which is always
-available. This bucket influencer is the aggregation of all records in the
-bucket; it is not just limited to a type of influencer.
-
-NOTE: A bucket influencer is a type of influencer. For example, `client_ip` or
-`user_name` can be bucket influencers, whereas `192.168.88.2` and `Bob` are
-influencers.
-
-An bucket influencer object has the following properties:
-
-`anomaly_score`::
-  (number) A normalized score between 0-100, which is calculated for each bucket
-  influencer. This score might be updated as newer data is analyzed.
-
-`bucket_span`::
-  (number) The length of the bucket in seconds. This value matches the `bucket_span`
-  that is specified in the job.
-
-`initial_anomaly_score`::
-  (number) The score between 0-100 for each bucket influencer. This score is
-  the initial value that was calculated at the time the bucket was processed.
-
-`influencer_field_name`::
-  (string) The field name of the influencer. For example `client_ip` or
-  `user_name`.
-
-`influencer_field_value`::
-  (string) The field value of the influencer. For example `192.168.88.2` or
-  `Bob`.
-
-`is_interim`::
-  (boolean) If true, this is an interim result. In other words, the bucket
-  influencer results are calculated based on partial input data.
-
-`job_id`::
-  (string) The unique identifier for the job that these results belong to.
-
-`probability`::
-  (number) The probability that the bucket has this behavior, in the range 0
-  to 1. For example, 0.0000109783. This value can be held to a high precision
-  of over 300 decimal places, so the `anomaly_score` is provided as a
-  human-readable and friendly interpretation of this.
-
-`raw_anomaly_score`::
-  (number) Internal.
-
-`result_type`::
-  (string) Internal. This value is always set to `bucket_influencer`.
-
-`timestamp`::
-  (date) The start time of the bucket for which these results were calculated.
-
-[float]
-[[ml-results-influencers]]
-==== Influencers
-
-Influencers are the entities that have contributed to, or are to blame for,
-the anomalies. Influencer results are available only if an
-`influencer_field_name` is specified in the job configuration.
-
-Influencers are given an `influencer_score`, which is calculated based on the
-anomalies that have occurred in each bucket interval. For jobs with more than
-one detector, this gives a powerful view of the most anomalous entities.
-
-For example, if you are analyzing unusual bytes sent and unusual domains
-visited and you specified `user_name` as the influencer, then an
-`influencer_score` for each anomalous user name is written per bucket. For
-example, if `user_name: Bob` had an `influencer_score` greater than 75, then
-`Bob` would be considered very anomalous during this time interval in one or
-both of those areas (unusual bytes sent or unusual domains visited).
-
-One influencer result is written per bucket for each influencer that is
-considered anomalous.
-
-When you identify an influencer with a high score, you can investigate further
-by accessing the records resource for that bucket and enumerating the anomaly
-records that contain the influencer.
-
-An influencer object has the following properties:
-
-`bucket_span`::
-  (number) The length of the bucket in seconds. This value matches the `bucket_span`
-  that is specified in the job.
-
-`influencer_score`::
-  (number) A normalized score between 0-100, which is based on the probability
-  of the influencer in this bucket aggregated across detectors. Unlike
-  `initial_influencer_score`, this value will be updated by a re-normalization
-  process as new data is analyzed.
-
-`initial_influencer_score`::
-  (number) A normalized score between 0-100, which is based on the probability
-  of the influencer aggregated across detectors. This is the initial value that
-  was calculated at the time the bucket was processed.
-
-`influencer_field_name`::
-  (string) The field name of the influencer.
-
-`influencer_field_value`::
-  (string) The entity that influenced, contributed to, or was to blame for the
-  anomaly.
-
-`is_interim`::
-  (boolean) If true, this is an interim result. In other words, the influencer
-  results are calculated based on partial input data.
-
-`job_id`::
-  (string) The unique identifier for the job that these results belong to.
-
-`probability`::
-  (number) The probability that the influencer has this behavior, in the range
-  0 to 1. For example, 0.0000109783. This value can be held to a high precision
-  of over 300 decimal places, so the `influencer_score` is provided as a
-  human-readable and friendly interpretation of this.
-// For example, 0.03 means 3%. This value is held to a high precision of over
-//300 decimal places. In scientific notation, a value of 3.24E-300 is highly
-//unlikely and therefore highly anomalous.
-
-`result_type`::
-  (string) Internal. This value is always set to `influencer`.
-
-`timestamp`::
-  (date) The start time of the bucket for which these results were calculated.
-
-NOTE: Additional influencer properties are added, depending on the fields being
-analyzed. For example, if it's analyzing `user_name` as an influencer, then a
-field `user_name` is added to the result document. This information enables you to
-filter the anomaly results more easily.
-
-
-[float]
-[[ml-results-records]]
-==== Records
-
-Records contain the detailed analytical results. They describe the anomalous
-activity that has been identified in the input data based on the detector
-configuration.
-
-For example, if you are looking for unusually large data transfers, an anomaly
-record can identify the source IP address, the destination, the time window
-during which it occurred, the expected and actual size of the transfer, and the
-probability of this occurrence.
-
-There can be many anomaly records depending on the characteristics and size of
-the input data. In practice, there are often too many to be able to manually
-process them. The {ml-features} therefore perform a sophisticated
-aggregation of the anomaly records into buckets.
-
-The number of record results depends on the number of anomalies found in each
-bucket, which relates to the number of time series being modeled and the number of
-detectors.
-
-A record object has the following properties:
-
-`actual`::
-  (array) The actual value for the bucket.
-
-`bucket_span`::
-  (number) The length of the bucket in seconds.
-  This value matches the `bucket_span` that is specified in the job.
-
-`by_field_name`::
-  (string) The name of the analyzed field. This value is present only if
-  it is specified in the detector. For example, `client_ip`.
-
-`by_field_value`::
-  (string) The value of `by_field_name`. This value is present only if
-  it is specified in the detector. For example, `192.168.66.2`.
-
-`causes`::
-  (array) For population analysis, an over field must be specified in the
-  detector. This property contains an array of anomaly records that are the
-  causes for the anomaly that has been identified for the over field. If no
-  over fields exist, this field is not present. This sub-resource contains
-  the most anomalous records for the `over_field_name`. For scalability reasons,
-  a maximum of the 10 most significant causes of the anomaly are returned. As
-  part of the core analytical modeling, these low-level anomaly records are
-  aggregated for their parent over field record. The causes resource contains
-  similar elements to the record resource, namely `actual`, `typical`,
-  `geo_results.actual_point`, `geo_results.typical_point`,
-  `*_field_name` and `*_field_value`.
-  Probability and scores are not applicable to causes.
-
-`detector_index`::
-  (number) A unique identifier for the detector.
-
-`field_name`::
-  (string) Certain functions require a field to operate on, for example, `sum()`.
-  For those functions, this value is the name of the field to be analyzed.
-
-`function`::
-  (string) The function in which the anomaly occurs, as specified in the
-  detector configuration. For example, `max`.
-
-`function_description`::
-  (string) The description of the function in which the anomaly occurs, as
-  specified in the detector configuration.
-
-`influencers`::
-  (array) If `influencers` was specified in the detector configuration, then
-  this array contains influencers that contributed to or were to blame for an
-  anomaly.
-
-`initial_record_score`::
-  (number) A normalized score between 0-100, which is based on the
-  probability of the anomalousness of this record. This is the initial value
-  that was calculated at the time the bucket was processed.
-
-`is_interim`::
-  (boolean) If true, this is an interim result. In other words, the anomaly
-  record is calculated based on partial input data.
-
-`job_id`::
-  (string) The unique identifier for the job that these results belong to.
-
-`over_field_name`::
-  (string) The name of the over field that was used in the analysis. This value
-  is present only if it was specified in the detector. Over fields are used
-  in population analysis. For example, `user`.
-
-`over_field_value`::
-  (string) The value of `over_field_name`. This value is present only if it
-  was specified in the detector. For example, `Bob`.
-
-`partition_field_name`::
-  (string) The name of the partition field that was used in the analysis. This
-  value is present only if it was specified in the detector. For example,
-  `region`.
-
-`partition_field_value`::
-  (string) The value of `partition_field_name`. This value is present only if
-  it was specified in the detector. For example, `us-east-1`.
-
-`probability`::
-  (number) The probability of the individual anomaly occurring, in the range
-  0 to 1. For example, 0.0000772031. This value can be held to a high precision
-  of over 300 decimal places, so the `record_score` is provided as a
-  human-readable and friendly interpretation of this.
-//In scientific notation, a value of 3.24E-300 is highly unlikely and therefore
-//highly anomalous.
-
-`multi_bucket_impact`::
-  (number) an indication of how strongly an anomaly is multi bucket or single bucket.
-  The value is on a scale of -5 to +5 where -5 means the anomaly is purely single 
-  bucket and +5 means the anomaly is purely multi bucket.
-
-`record_score`::
-  (number) A normalized score between 0-100, which is based on the probability
-  of the anomalousness of this record. Unlike `initial_record_score`, this
-  value will be updated by a re-normalization process as new data is analyzed.
-
-`result_type`::
-  (string) Internal. This is always set to `record`.
-
-`timestamp`::
-  (date) The start time of the bucket for which these results were calculated.
-
-`typical`::
-  (array) The typical value for the bucket, according to analytical modeling.
-
-`geo_results.actual_point`::
-  (string) The actual value for the bucket formatted as a `geo_point`.
-  If the detector function is `lat_long`, this is a comma delimited string
-  of the latitude and longitude.
-
-`geo_results.typical_point`::
-  (string) The typical value for the bucket formatted as a `geo_point`.
-  If the detector function is `lat_long`, this is a comma delimited string
-  of the latitude and longitude.
-
-NOTE: Additional record properties are added, depending on the fields being
-analyzed. For example, if it's analyzing `hostname` as a _by field_, then a field
-`hostname` is added to the result document. This information enables you to
-filter the anomaly results more easily.
-
-
-[float]
-[[ml-results-categories]]
-==== Categories
-
-When `categorization_field_name` is specified in the job configuration, it is
-possible to view the definitions of the resulting categories. A category
-definition describes the common terms matched and contains examples of matched
-values.
-
-The anomaly results from a categorization analysis are available as bucket,
-influencer, and record results. For example, the results might indicate that
-at 16:45 there was an unusual count of log message category 11. You can then
-examine the description and examples of that category.
-
-A category resource has the following properties:
-
-`category_id`::
-  (unsigned integer) A unique identifier for the category.
-
-`examples`::
-  (array) A list of examples of actual values that matched the category.
-
-`grok_pattern`::
-  experimental[] (string) A Grok pattern that could be used in Logstash or an
-  Ingest Pipeline to extract fields from messages that match the category. This
-  field is experimental and may be changed or removed in a future release. The
-  Grok patterns that are found are not optimal, but are often a good starting
-  point for manual tweaking.
-
-`job_id`::
-  (string) The unique identifier for the job that these results belong to.
-
-`max_matching_length`::
-  (unsigned integer) The maximum length of the fields that matched the category.
-  The value is increased by 10% to enable matching for similar fields that have
-  not been analyzed.
-
-`regex`::
-  (string) A regular expression that is used to search for values that match the
-  category.
-
-`terms`::
-  (string) A space separated list of the common tokens that are matched in
-  values of the category.
-
-[float]
-[[ml-results-overall-buckets]]
-==== Overall Buckets
-
-Overall buckets provide a summary of bucket results over multiple jobs.
-Their `bucket_span` equals the longest `bucket_span` of the jobs in question.
-The `overall_score` is the `top_n` average of the max `anomaly_score` per job
-within the overall bucket time interval.
-This means that you can fine-tune the `overall_score` so that it is more
-or less sensitive to the number of jobs that detect an anomaly at the same time.
-
-An overall bucket resource has the following properties:
-
-`timestamp`::
-  (date) The start time of the overall bucket.
-
-`bucket_span`::
-  (number) The length of the bucket in seconds. Matches the `bucket_span`
-  of the job with the longest one.
-
-`overall_score`::
-  (number) The `top_n` average of the max bucket `anomaly_score` per job.
-
-`jobs`::
-  (array) An array of objects that contain the `max_anomaly_score` per `job_id`.
-
-`is_interim`::
-  (boolean) If true, this is an interim result. In other words, the anomaly
-  record is calculated based on partial input data.
-
-`result_type`::
-  (string) Internal. This is always set to `overall_bucket`.
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 5056281642bae..5003f8c4f5403 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -185,6 +185,11 @@ The size of the interval that the analysis is aggregated into, typically between
 see <<time-units>>.
 end::bucket-span[]
 
+tag::bucket-span-results[]
+The length of the bucket in seconds. This value matches the `bucket_span`
+that is specified in the job.
+end::bucket-span-results[]
+
 tag::by-field-name[]
 The field used to split the data. In particular, this property is used for 
 analyzing the splits with respect to their own history. It is used for finding 
@@ -525,6 +530,10 @@ that document will not be used for training, but a prediction with the trained
 model will be generated for it. It is also known as continuous target variable.
 end::dependent-variable[]
 
+tag::desc-results[]
+If true, the results are sorted in descending order.
+end::desc-results[]
+
 tag::description-dfa[]
 A description of the job.
 end::description-dfa[]
@@ -623,6 +632,11 @@ working with both over and by fields, then you can set `exclude_frequent` to
 `all` for both fields, or to `by` or `over` for those specific fields.
 end::exclude-frequent[]
 
+tag::exclude-interim-results[]
+If `true`, the output excludes interim results. By default, interim results are 
+included.
+end::exclude-interim-results[]
+
 tag::feature-bag-fraction[]
 Defines the fraction of features that will be used when 
 selecting a random bag for each candidate split. 
@@ -718,6 +732,11 @@ is available as part of the input data. When you use multiple detectors, the use
 of influencers is recommended as it aggregates results for each influencer entity.
 end::influencers[]
 
+tag::is-interim[]
+If `true`, this is an interim result. In other words, the results are calculated
+based on partial input data.
+end::is-interim[]
+
 tag::job-id-anomaly-detection[]
 Identifier for the {anomaly-job}.
 end::job-id-anomaly-detection[]
@@ -1129,6 +1148,10 @@ The time span that each search will be querying. This setting is only applicable
 when the mode is set to `manual`. For example: `3h`.
 end::time-span[]
 
+tag::timestamp-results[]
+The start time of the bucket for which these results were calculated.
+end::timestamp-results[]
+
 tag::tokenizer[]
 The name or definition of the <<analysis-tokenizers,tokenizer>> to use after 
 character filters are applied. This property is compulsory if 
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 32a30a326bfde..57c7bf93092a7 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -1095,3 +1095,20 @@ See <<ml-update-snapshot>> and <<ml-get-snapshot>>.
 This page was deleted.
 See <<put-transform>>, <<preview-transform>>, <<update-transform>>,
 <<get-transform>>.
+
+[role="exclude",id="ml-results-resource"]
+=== Results resources
+
+This page was deleted.
+[[ml-results-buckets]]
+See <<ml-get-bucket>>,
+[[ml-results-bucket-influencers]]
+<<ml-get-bucket>>,
+[[ml-results-influencers]]
+<<ml-get-influencer>>,
+[[ml-results-records]]
+<<ml-get-record>>,
+[[ml-results-categories]]
+<<ml-get-category>>, and
+[[ml-results-overall-buckets]]
+<<ml-get-overall-buckets>>.
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index 137af880c0a9a..85ffbae5925fd 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -7,10 +7,8 @@ These resource definitions are used in APIs related to {ml-features} and
 
 
 * <<ml-dfa-analysis-objects>>
-* <<ml-results-resource,{anomaly-detect-cap} results>>
 * <<role-mapping-resources,Role mappings>>
 
 
 include::{es-repo-dir}/ml/df-analytics/apis/analysisobjects.asciidoc[]
 include::{xes-repo-dir}/rest-api/security/role-mapping-resources.asciidoc[]
-include::{es-repo-dir}/ml/anomaly-detection/apis/resultsresource.asciidoc[]

From c4fdc67f5e1b75e869665d68a1fbde89649c220f Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Wed, 18 Dec 2019 18:41:26 +0100
Subject: [PATCH 257/686] Add 7.5.2 version.

---
 .ci/bwcVersions                                     | 1 +
 server/src/main/java/org/elasticsearch/Version.java | 1 +
 2 files changed, 2 insertions(+)

diff --git a/.ci/bwcVersions b/.ci/bwcVersions
index 52b778bf11235..e94365d6b0a22 100644
--- a/.ci/bwcVersions
+++ b/.ci/bwcVersions
@@ -13,5 +13,6 @@ BWC_VERSION:
   - "7.4.2"
   - "7.5.0"
   - "7.5.1"
+  - "7.5.2"
   - "7.6.0"
   - "8.0.0"
diff --git a/server/src/main/java/org/elasticsearch/Version.java b/server/src/main/java/org/elasticsearch/Version.java
index c39502f0b0e3d..ce8d0053e76dc 100644
--- a/server/src/main/java/org/elasticsearch/Version.java
+++ b/server/src/main/java/org/elasticsearch/Version.java
@@ -71,6 +71,7 @@ public class Version implements Comparable<Version>, ToXContentFragment {
     public static final Version V_7_4_2 = new Version(7040299, org.apache.lucene.util.Version.LUCENE_8_2_0);
     public static final Version V_7_5_0 = new Version(7050099, org.apache.lucene.util.Version.LUCENE_8_3_0);
     public static final Version V_7_5_1 = new Version(7050199, org.apache.lucene.util.Version.LUCENE_8_3_0);
+    public static final Version V_7_5_2 = new Version(7050299, org.apache.lucene.util.Version.LUCENE_8_3_0);
     public static final Version V_7_6_0 = new Version(7060099, org.apache.lucene.util.Version.LUCENE_8_4_0);
     public static final Version V_8_0_0 = new Version(8000099, org.apache.lucene.util.Version.LUCENE_8_4_0);
     public static final Version CURRENT = V_8_0_0;

From ffbd22ee68db0b559bd843af8f3b0b2fdef42407 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Wed, 18 Dec 2019 14:03:41 -0500
Subject: [PATCH 258/686] [ML][Inference] fix support for nested fields
 (#50258)

This fixes support for nested fields

We now support fully nested, fully collapsed, or a mix of both on inference docs.

ES mappings allow the `_source` to be any combination of nested objects + dot delimited fields.
So, we should do our best to find the best path down the Map for the desired field.
---
 .../preprocessing/FrequencyEncoding.java      |   3 +-
 .../preprocessing/OneHotEncoding.java         |   3 +-
 .../preprocessing/TargetMeanEncoding.java     |   3 +-
 .../ml/inference/trainedmodel/tree/Tree.java  |   5 +-
 .../xpack/core/ml/utils/MapHelper.java        | 133 ++++++++++++
 .../preprocessing/FrequencyEncodingTests.java |  18 ++
 .../preprocessing/OneHotEncodingTests.java    |  15 ++
 .../TargetMeanEncodingTests.java              |  20 ++
 .../trainedmodel/ensemble/EnsembleTests.java  |  57 ++++++
 .../trainedmodel/tree/TreeTests.java          |  52 +++++
 .../xpack/core/ml/utils/MapHelperTests.java   | 193 ++++++++++++++++++
 .../inference/ingest/InferenceProcessor.java  |   3 +-
 .../inference/loadingservice/LocalModel.java  |   4 +-
 .../ingest/InferenceProcessorTests.java       |  44 +++-
 .../loadingservice/LocalModelTests.java       |  14 +-
 .../integration/ModelInferenceActionIT.java   |  48 +++--
 16 files changed, 582 insertions(+), 33 deletions(-)
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/utils/MapHelper.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/utils/MapHelperTests.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/FrequencyEncoding.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/FrequencyEncoding.java
index ed693460edcc7..e9606d53ae27d 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/FrequencyEncoding.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/FrequencyEncoding.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+import org.elasticsearch.xpack.core.ml.utils.MapHelper;
 
 import java.io.IOException;
 import java.util.Collections;
@@ -103,7 +104,7 @@ public String getName() {
 
     @Override
     public void process(Map<String, Object> fields) {
-        Object value = fields.get(field);
+        Object value = MapHelper.dig(field, fields);
         if (value == null) {
             return;
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/OneHotEncoding.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/OneHotEncoding.java
index a4924a277c0ad..9bb2537b61ed3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/OneHotEncoding.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/OneHotEncoding.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+import org.elasticsearch.xpack.core.ml.utils.MapHelper;
 
 import java.io.IOException;
 import java.util.Collections;
@@ -86,7 +87,7 @@ public String getName() {
 
     @Override
     public void process(Map<String, Object> fields) {
-        Object value = fields.get(field);
+        Object value = MapHelper.dig(field, fields);
         if (value == null) {
             return;
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/TargetMeanEncoding.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/TargetMeanEncoding.java
index 8276fc2c8fefb..19c3cadbbef95 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/TargetMeanEncoding.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/TargetMeanEncoding.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+import org.elasticsearch.xpack.core.ml.utils.MapHelper;
 
 import java.io.IOException;
 import java.util.Collections;
@@ -114,7 +115,7 @@ public String getName() {
 
     @Override
     public void process(Map<String, Object> fields) {
-        Object value = fields.get(field);
+        Object value = MapHelper.dig(field, fields);
         if (value == null) {
             return;
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
index b137c8f28d58e..831838e0f7df2 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.StrictlyParsedTrainedModel;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.TargetType;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+import org.elasticsearch.xpack.core.ml.utils.MapHelper;
 
 import java.io.IOException;
 import java.util.ArrayDeque;
@@ -129,7 +130,9 @@ public InferenceResults infer(Map<String, Object> fields, InferenceConfig config
                 "Cannot infer using configuration for [{}] when model target_type is [{}]", config.getName(), targetType.toString());
         }
 
-        List<Double> features = featureNames.stream().map(f -> InferenceHelpers.toDouble(fields.get(f))).collect(Collectors.toList());
+        List<Double> features = featureNames.stream()
+            .map(f -> InferenceHelpers.toDouble(MapHelper.dig(f, fields)))
+            .collect(Collectors.toList());
         return infer(features, config);
     }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/utils/MapHelper.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/utils/MapHelper.java
new file mode 100644
index 0000000000000..dcd74af158173
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/utils/MapHelper.java
@@ -0,0 +1,133 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.utils;
+
+import org.elasticsearch.common.Nullable;
+
+import java.util.Arrays;
+import java.util.Map;
+import java.util.Stack;
+
+public final class MapHelper {
+
+    private MapHelper() {}
+
+    /**
+     * This eagerly digs (depth first search, longer keys first) through the map by tokenizing the provided path on '.'.
+     *
+     * It is possible for ES _source docs to have "mixed" path formats. So, we should search all potential paths
+     * given the current knowledge of the map.
+     *
+     * Examples:
+     *
+     * The following maps would return `2` given the path "a.b.c.d"
+     *
+     * {
+     *     "a.b.c.d" : 2
+     * }
+     * {
+     *     "a" :{"b": {"c": {"d" : 2}}}
+     * }
+     * {
+     *     "a" :{"b.c": {"d" : 2}}}
+     * }
+     * {
+     *     "a" :{"b": {"c": {"d" : 2}}},
+     *     "a.b" :{"c": {"d" : 5}} // we choose the first one found, we go down longer keys first
+     * }
+     * {
+     *     "a" :{"b": {"c": {"NOT_d" : 2, "d": 2}}}
+     * }
+     *
+     * Conceptual "Worse case" 5 potential paths explored for "a.b.c.d" until 2 is finally returned
+     * {
+     *     "a.b.c": {"not_d": 2},
+     *     "a.b": {"c": {"not_d": 2}},
+     *     "a": {"b.c": {"not_d": 2}},
+     *     "a": {"b" :{ "c.not_d": 2}},
+     *     "a" :{"b": {"c": {"not_d" : 2}}},
+     *     "a" :{"b": {"c": {"d" : 2}}},
+     * }
+     *
+     * We don't exhaustively create all potential paths.
+     * If we did, this would result in 2^n-1 total possible paths, where {@code n = path.split("\\.").length}.
+     *
+     * Instead we lazily create potential paths once we know that they are possibilities.
+     *
+     * @param path Dot delimited path containing the field desired
+     * @param map The {@link Map} map to dig
+     * @return The found object. Returns {@code null} if not found
+     */
+    @Nullable
+    public static Object dig(String path, Map<String, Object> map) {
+        // short cut before search
+        if (map.keySet().contains(path)) {
+            return map.get(path);
+        }
+        String[] fields = path.split("\\.");
+        if (Arrays.stream(fields).anyMatch(String::isEmpty)) {
+            throw new IllegalArgumentException("Empty path detected. Invalid field name");
+        }
+        Stack<PotentialPath> pathStack = new Stack<>();
+        pathStack.push(new PotentialPath(map, 0));
+        return explore(fields, pathStack);
+    }
+
+    @SuppressWarnings("unchecked")
+    private static Object explore(String[] path, Stack<PotentialPath> pathStack) {
+        while (pathStack.empty() == false) {
+            PotentialPath potentialPath = pathStack.pop();
+            int endPos = potentialPath.pathPosition + 1;
+            int startPos = potentialPath.pathPosition;
+            Map<String, Object> map = potentialPath.map;
+            String candidateKey = null;
+            while(endPos <= path.length) {
+                candidateKey = mergePath(path, startPos, endPos);
+                Object next = map.get(candidateKey);
+                if (endPos == path.length && next != null) { // exit early, we reached the full path and found something
+                    return next;
+                }
+                if (next instanceof Map<?, ?>) { // we found another map, continue exploring down this path
+                    pathStack.push(new PotentialPath((Map<String, Object>)next, endPos));
+                }
+                endPos++;
+            }
+            if (candidateKey != null && map.containsKey(candidateKey)) { //exit early
+                return map.get(candidateKey);
+            }
+        }
+
+        return null;
+    }
+
+    private static String mergePath(String[] path, int start, int end) {
+        if (start + 1 == end) { // early exit, no need to create sb
+            return path[start];
+        }
+
+        StringBuilder sb = new StringBuilder();
+        for (int i = start; i < end - 1; i++) {
+            sb.append(path[i]);
+            sb.append(".");
+        }
+        sb.append(path[end - 1]);
+        return sb.toString();
+    }
+
+    private static class PotentialPath {
+
+        // Pointer to where to start exploring
+        private final Map<String, Object> map;
+        // Where in the requested path are we
+        private final int pathPosition;
+
+        private PotentialPath(Map<String, Object> map, int pathPosition) {
+            this.map = map;
+            this.pathPosition = pathPosition;
+        }
+
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/FrequencyEncodingTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/FrequencyEncodingTests.java
index 4c0497fa409f9..5e296c8f11f81 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/FrequencyEncodingTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/FrequencyEncodingTests.java
@@ -65,4 +65,22 @@ public void testProcessWithFieldPresent() {
         testProcess(encoding, fieldValues, matchers);
     }
 
+    public void testProcessWithNestedField() {
+        String field = "categorical.child";
+        List<Object> values = Arrays.asList("foo", "bar", "foobar", "baz", "farequote", 1.5);
+        Map<String, Double> valueMap = values.stream().collect(Collectors.toMap(Object::toString,
+            v -> randomDoubleBetween(0.0, 1.0, false)));
+        String encodedFeatureName = "encoded";
+        FrequencyEncoding encoding = new FrequencyEncoding(field, encodedFeatureName, valueMap);
+
+        Map<String, Object> fieldValues = new HashMap<>() {{
+            put("categorical", new HashMap<>(){{
+                put("child", "farequote");
+            }});
+        }};
+
+        encoding.process(fieldValues);
+        assertThat(fieldValues.get("encoded"), equalTo(valueMap.get("farequote")));
+    }
+
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/OneHotEncodingTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/OneHotEncodingTests.java
index 8b35b77b5a69c..c065d652fcb1a 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/OneHotEncodingTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/OneHotEncodingTests.java
@@ -67,4 +67,19 @@ public void testProcessWithFieldPresent() {
         testProcess(encoding, fieldValues, matchers);
     }
 
+    public void testProcessWithNestedField() {
+        String field = "categorical.child";
+        List<Object> values = Arrays.asList("foo", "bar", "foobar", "baz", "farequote", 1.5);
+        Map<String, String> valueMap = values.stream().collect(Collectors.toMap(Object::toString, v -> "Column_" + v.toString()));
+        OneHotEncoding encoding = new OneHotEncoding(field, valueMap);
+        Map<String, Object> fieldValues = new HashMap<>() {{
+            put("categorical", new HashMap<>(){{
+                put("child", "farequote");
+            }});
+        }};
+
+        encoding.process(fieldValues);
+        assertThat(fieldValues.get("Column_farequote"), equalTo(1));
+    }
+
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/TargetMeanEncodingTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/TargetMeanEncodingTests.java
index e2aaf1e1256c6..8143b5118ed70 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/TargetMeanEncodingTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/TargetMeanEncodingTests.java
@@ -68,4 +68,24 @@ public void testProcessWithFieldPresent() {
         testProcess(encoding, fieldValues, matchers);
     }
 
+    public void testProcessWithNestedField() {
+        String field = "categorical.child";
+        List<Object> values = Arrays.asList("foo", "bar", "foobar", "baz", "farequote", 1.5);
+        Map<String, Double> valueMap = values.stream().collect(Collectors.toMap(Object::toString,
+            v -> randomDoubleBetween(0.0, 1.0, false)));
+        String encodedFeatureName = "encoded";
+        Double defaultvalue = randomDouble();
+        TargetMeanEncoding encoding = new TargetMeanEncoding(field, encodedFeatureName, valueMap, defaultvalue);
+
+        Map<String, Object> fieldValues = new HashMap<>() {{
+            put("categorical", new HashMap<>(){{
+                put("child", "farequote");
+            }});
+        }};
+
+        encoding.process(fieldValues);
+
+        assertThat(fieldValues.get("encoded"), equalTo(valueMap.get("farequote")));
+    }
+
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
index 13a401117b479..46373dae834c9 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
@@ -445,6 +445,63 @@ public void testRegressionInference() {
             closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
     }
 
+    public void testInferNestedFields() {
+        List<String> featureNames = Arrays.asList("foo.baz", "bar.biz");
+        Tree tree1 = Tree.builder()
+            .setFeatureNames(featureNames)
+            .setRoot(TreeNode.builder(0)
+                .setLeftChild(1)
+                .setRightChild(2)
+                .setSplitFeature(0)
+                .setThreshold(0.5))
+            .addNode(TreeNode.builder(1).setLeafValue(0.3))
+            .addNode(TreeNode.builder(2)
+                .setThreshold(0.8)
+                .setSplitFeature(1)
+                .setLeftChild(3)
+                .setRightChild(4))
+            .addNode(TreeNode.builder(3).setLeafValue(0.1))
+            .addNode(TreeNode.builder(4).setLeafValue(0.2)).build();
+        Tree tree2 = Tree.builder()
+            .setFeatureNames(featureNames)
+            .setRoot(TreeNode.builder(0)
+                .setLeftChild(1)
+                .setRightChild(2)
+                .setSplitFeature(0)
+                .setThreshold(0.5))
+            .addNode(TreeNode.builder(1).setLeafValue(1.5))
+            .addNode(TreeNode.builder(2).setLeafValue(0.9))
+            .build();
+        Ensemble ensemble = Ensemble.builder()
+            .setTargetType(TargetType.REGRESSION)
+            .setFeatureNames(featureNames)
+            .setTrainedModels(Arrays.asList(tree1, tree2))
+            .setOutputAggregator(new WeightedSum(new double[]{0.5, 0.5}))
+            .build();
+
+        Map<String, Object> featureMap = new HashMap<>() {{
+            put("foo", new HashMap<>(){{
+                put("baz", 0.4);
+            }});
+            put("bar", new HashMap<>(){{
+                put("biz", 0.0);
+            }});
+        }};
+        assertThat(0.9,
+            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
+
+        featureMap = new HashMap<>() {{
+            put("foo", new HashMap<>(){{
+                put("baz", 2.0);
+            }});
+            put("bar", new HashMap<>(){{
+                put("biz", 0.7);
+            }});
+        }};
+        assertThat(0.5,
+            closeTo(((SingleValueInferenceResults)ensemble.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
+    }
+
     public void testOperationsEstimations() {
         Tree tree1 = TreeTests.buildRandomTree(Arrays.asList("foo", "bar"), 2);
         Tree tree2 = TreeTests.buildRandomTree(Arrays.asList("foo", "bar", "baz"), 5);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
index 9d682896569bb..8c05c8d7b9d3a 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
@@ -169,6 +169,58 @@ public void testInfer() {
             closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
     }
 
+    public void testInferNestedFields() {
+        // Build a tree with 2 nodes and 3 leaves using 2 features
+        // The leaves have unique values 0.1, 0.2, 0.3
+        Tree.Builder builder = Tree.builder().setTargetType(TargetType.REGRESSION);
+        TreeNode.Builder rootNode = builder.addJunction(0, 0, true, 0.5);
+        builder.addLeaf(rootNode.getRightChild(), 0.3);
+        TreeNode.Builder leftChildNode = builder.addJunction(rootNode.getLeftChild(), 1, true, 0.8);
+        builder.addLeaf(leftChildNode.getLeftChild(), 0.1);
+        builder.addLeaf(leftChildNode.getRightChild(), 0.2);
+
+        List<String> featureNames = Arrays.asList("foo.baz", "bar.biz");
+        Tree tree = builder.setFeatureNames(featureNames).build();
+
+        // This feature vector should hit the right child of the root node
+        Map<String, Object> featureMap = new HashMap<>() {{
+            put("foo", new HashMap<>(){{
+                put("baz", 0.6);
+            }});
+            put("bar", new HashMap<>(){{
+                put("biz", 0.0);
+            }});
+        }};
+        assertThat(0.3,
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
+
+        // This should hit the left child of the left child of the root node
+        // i.e. it takes the path left, left
+        featureMap = new HashMap<>() {{
+            put("foo", new HashMap<>(){{
+                put("baz", 0.3);
+            }});
+            put("bar", new HashMap<>(){{
+                put("biz", 0.7);
+            }});
+        }};
+        assertThat(0.1,
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
+
+        // This should hit the right child of the left child of the root node
+        // i.e. it takes the path left, right
+        featureMap = new HashMap<>() {{
+            put("foo", new HashMap<>(){{
+                put("baz", 0.3);
+            }});
+            put("bar", new HashMap<>(){{
+                put("biz", 0.9);
+            }});
+        }};
+        assertThat(0.2,
+            closeTo(((SingleValueInferenceResults)tree.infer(featureMap, RegressionConfig.EMPTY_PARAMS)).value(), 0.00001));
+    }
+
     public void testTreeClassificationProbability() {
         // Build a tree with 2 nodes and 3 leaves using 2 features
         // The leaves have unique values 0.1, 0.2, 0.3
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/utils/MapHelperTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/utils/MapHelperTests.java
new file mode 100644
index 0000000000000..c3a7eeff76fe7
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/utils/MapHelperTests.java
@@ -0,0 +1,193 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.utils;
+
+import org.elasticsearch.test.ESTestCase;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.nullValue;
+
+public class MapHelperTests extends ESTestCase {
+
+    public void testAbsolutePathStringAsKey() {
+        String path = "a.b.c.d";
+        Map<String, Object> map = Collections.singletonMap(path, 2);
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+        assertThat(MapHelper.dig(path, Collections.emptyMap()), is(nullValue()));
+    }
+
+    public void testSimplePath() {
+        String path = "a.b.c.d";
+        Map<String, Object> map = Collections.singletonMap("a",
+            Collections.singletonMap("b",
+                Collections.singletonMap("c",
+                    Collections.singletonMap("d", 2))));
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = Collections.singletonMap("a",
+            Collections.singletonMap("b",
+                Collections.singletonMap("e", // Not part of path
+                    Collections.singletonMap("d", 2))));
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+    }
+
+    public void testSimplePathReturningMap() {
+        String path = "a.b.c";
+        Map<String, Object> map = Collections.singletonMap("a",
+            Collections.singletonMap("b",
+                Collections.singletonMap("c",
+                    Collections.singletonMap("d", 2))));
+        assertThat(MapHelper.dig(path, map), equalTo(Collections.singletonMap("d", 2)));
+    }
+
+    public void testSimpleMixedPath() {
+        String path = "a.b.c.d";
+        Map<String, Object> map = Collections.singletonMap("a",
+            Collections.singletonMap("b.c",
+                    Collections.singletonMap("d", 2)));
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = Collections.singletonMap("a.b",
+            Collections.singletonMap("c",
+                Collections.singletonMap("d", 2)));
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = Collections.singletonMap("a.b.c",
+                Collections.singletonMap("d", 2));
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = Collections.singletonMap("a",
+            Collections.singletonMap("b",
+                Collections.singletonMap("c.d", 2)));
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = Collections.singletonMap("a",
+            Collections.singletonMap("b.c.d", 2));
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = Collections.singletonMap("a.b",
+            Collections.singletonMap("c.d", 2));
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = Collections.singletonMap("a",
+            Collections.singletonMap("b.foo",
+                Collections.singletonMap("d", 2)));
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+
+        map = Collections.singletonMap("a",
+            Collections.singletonMap("b.c",
+                Collections.singletonMap("foo", 2)));
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+
+        map = Collections.singletonMap("x",
+            Collections.singletonMap("b.c",
+                Collections.singletonMap("d", 2)));
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+    }
+
+    public void testSimpleMixedPathReturningMap() {
+        String path = "a.b.c";
+        Map<String, Object> map = Collections.singletonMap("a",
+            Collections.singletonMap("b.c",
+                Collections.singletonMap("d", 2)));
+        assertThat(MapHelper.dig(path, map), equalTo(Collections.singletonMap("d", 2)));
+
+        map = Collections.singletonMap("a",
+            Collections.singletonMap("b.foo",
+                Collections.singletonMap("d", 2)));
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+
+        map = Collections.singletonMap("a",
+            Collections.singletonMap("b.not_c",
+                Collections.singletonMap("foo", 2)));
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+
+        map = Collections.singletonMap("x",
+            Collections.singletonMap("b.c",
+                Collections.singletonMap("d", 2)));
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+    }
+
+    public void testMultiplePotentialPaths() {
+        String path = "a.b.c.d";
+        Map<String, Object> map = new LinkedHashMap<>() {{
+            put("a", Collections.singletonMap("b",
+                Collections.singletonMap("c",
+                    Collections.singletonMap("not_d", 5))));
+            put("a.b", Collections.singletonMap("c", Collections.singletonMap("d", 2)));
+        }};
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = new LinkedHashMap<>() {{
+            put("a", Collections.singletonMap("b",
+                Collections.singletonMap("c",
+                    Collections.singletonMap("d", 2))));
+            put("a.b", Collections.singletonMap("c", Collections.singletonMap("not_d", 5)));
+        }};
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = new LinkedHashMap<>() {{
+            put("a", Collections.singletonMap("b",
+                new HashMap<>() {{
+                    put("c", Collections.singletonMap("not_d", 5));
+                    put("c.d", 2);
+                }}));
+        }};
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = new LinkedHashMap<>() {{
+            put("a", Collections.singletonMap("b",
+                new HashMap<>() {{
+                    put("c", Collections.singletonMap("d", 2));
+                    put("c.not_d", 5);
+                }}));
+        }};
+        assertThat(MapHelper.dig(path, map), equalTo(2));
+
+        map = new LinkedHashMap<>() {{
+            put("a", Collections.singletonMap("b",
+                Collections.singletonMap("c",
+                    Collections.singletonMap("not_d", 5))));
+            put("a.b", Collections.singletonMap("c", Collections.singletonMap("not_d", 2)));
+        }};
+
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+    }
+
+    public void testMultiplePotentialPathsReturningMap() {
+        String path = "a.b.c";
+        Map<String, Object> map = new LinkedHashMap<>() {{
+            put("a", Collections.singletonMap("b",
+                Collections.singletonMap("c",
+                    Collections.singletonMap("d", 2))));
+            put("a.b", Collections.singletonMap("not_c", Collections.singletonMap("d", 2)));
+        }};
+        assertThat(MapHelper.dig(path, map), equalTo(Collections.singletonMap("d", 2)));
+
+        map = new LinkedHashMap<>() {{
+            put("a", Collections.singletonMap("b",
+                Collections.singletonMap("not_c",
+                    Collections.singletonMap("d", 2))));
+            put("a.b", Collections.singletonMap("c", Collections.singletonMap("d", 2)));
+        }};
+        assertThat(MapHelper.dig(path, map), equalTo(Collections.singletonMap("d", 2)));
+
+        map = new LinkedHashMap<>() {{
+            put("a", Collections.singletonMap("b",
+                Collections.singletonMap("not_c",
+                    Collections.singletonMap("d", 2))));
+            put("a.b", Collections.singletonMap("not_c", Collections.singletonMap("d", 2)));
+        }};
+        assertThat(MapHelper.dig(path, map), is(nullValue()));
+    }
+
+}
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
index 19c0054b522bf..18ac57d1ae818 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+import org.elasticsearch.xpack.core.ml.utils.MapHelper;
 import org.elasticsearch.xpack.ml.notifications.InferenceAuditor;
 
 import java.util.Arrays;
@@ -128,7 +129,7 @@ InternalInferModelAction.Request buildRequest(IngestDocument ingestDocument) {
         Map<String, Object> fields = new HashMap<>(ingestDocument.getSourceAndMetadata());
         if (fieldMapping != null) {
             fieldMapping.forEach((src, dest) -> {
-                Object srcValue = fields.remove(src);
+                Object srcValue = MapHelper.dig(src, fields);
                 if (srcValue != null) {
                     fields.put(dest, srcValue);
                 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModel.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModel.java
index 4e62c69336b6a..8a233d534a76f 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModel.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModel.java
@@ -6,7 +6,6 @@
 package org.elasticsearch.xpack.ml.inference.loadingservice;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
 import org.elasticsearch.xpack.core.ml.inference.results.WarningInferenceResults;
@@ -16,6 +15,7 @@
 import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.RegressionInferenceResults;
+import org.elasticsearch.xpack.core.ml.utils.MapHelper;
 
 import java.util.HashSet;
 import java.util.Map;
@@ -61,7 +61,7 @@ public String getResultsType() {
     @Override
     public void infer(Map<String, Object> fields, InferenceConfig config, ActionListener<InferenceResults> listener) {
         try {
-            if (Sets.haveEmptyIntersection(fieldNames, fields.keySet())) {
+            if (fieldNames.stream().allMatch(f -> MapHelper.dig(f, fields) == null)) {
                 listener.onResponse(new WarningInferenceResults(Messages.getMessage(INFERENCE_WARNING_ALL_FIELDS_MISSING, modelId)));
                 return;
             }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
index 014c9fad11203..57389b3660241 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorTests.java
@@ -181,7 +181,7 @@ public void testGenerateWithMapping() {
         String modelId = "model";
         Integer topNClasses = randomBoolean() ? null : randomIntBetween(1, 10);
 
-        Map<String, String> fieldMapping = new HashMap<>(3) {{
+        Map<String, String> fieldMapping = new HashMap<>(5) {{
             put("value1", "new_value1");
             put("value2", "new_value2");
             put("categorical", "new_categorical");
@@ -195,7 +195,7 @@ public void testGenerateWithMapping() {
             new ClassificationConfig(topNClasses, null, null),
             fieldMapping);
 
-        Map<String, Object> source = new HashMap<>(3){{
+        Map<String, Object> source = new HashMap<>(5){{
             put("value1", 1);
             put("categorical", "foo");
             put("un_touched", "bar");
@@ -203,8 +203,46 @@ public void testGenerateWithMapping() {
         Map<String, Object> ingestMetadata = new HashMap<>();
         IngestDocument document = new IngestDocument(source, ingestMetadata);
 
-        Map<String, Object> expectedMap = new HashMap<>(2) {{
+        Map<String, Object> expectedMap = new HashMap<>(7) {{
             put("new_value1", 1);
+            put("value1", 1);
+            put("categorical", "foo");
+            put("new_categorical", "foo");
+            put("un_touched", "bar");
+        }};
+        assertThat(processor.buildRequest(document).getObjectsToInfer().get(0), equalTo(expectedMap));
+    }
+
+    public void testGenerateWithMappingNestedFields() {
+        String modelId = "model";
+        Integer topNClasses = randomBoolean() ? null : randomIntBetween(1, 10);
+
+        Map<String, String> fieldMapping = new HashMap<>(5) {{
+            put("value1.foo", "new_value1");
+            put("value2", "new_value2");
+            put("categorical.bar", "new_categorical");
+        }};
+
+        InferenceProcessor processor = new InferenceProcessor(client,
+            auditor,
+            "my_processor",
+            "my_field",
+            modelId,
+            new ClassificationConfig(topNClasses, null, null),
+            fieldMapping);
+
+        Map<String, Object> source = new HashMap<>(5){{
+            put("value1", Collections.singletonMap("foo", 1));
+            put("categorical.bar", "foo");
+            put("un_touched", "bar");
+        }};
+        Map<String, Object> ingestMetadata = new HashMap<>();
+        IngestDocument document = new IngestDocument(source, ingestMetadata);
+
+        Map<String, Object> expectedMap = new HashMap<>(7) {{
+            put("new_value1", 1);
+            put("value1", Collections.singletonMap("foo", 1));
+            put("categorical.bar", "foo");
             put("new_categorical", "foo");
             put("un_touched", "bar");
         }};
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
index fb82c4ddfaaf5..faa1717cc4fde 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
@@ -41,7 +41,7 @@ public class LocalModelTests extends ESTestCase {
 
     public void testClassificationInfer() throws Exception {
         String modelId = "classification_model";
-        List<String> inputFields = Arrays.asList("foo", "bar", "categorical");
+        List<String> inputFields = Arrays.asList("field.foo", "field.bar", "categorical");
         TrainedModelDefinition definition = new TrainedModelDefinition.Builder()
             .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotMap())))
             .setTrainedModel(buildClassification(false))
@@ -49,8 +49,8 @@ public void testClassificationInfer() throws Exception {
 
         Model model = new LocalModel(modelId, definition, new TrainedModelInput(inputFields));
         Map<String, Object> fields = new HashMap<>() {{
-            put("foo", 1.0);
-            put("bar", 0.5);
+            put("field.foo", 1.0);
+            put("field.bar", 0.5);
             put("categorical", "dog");
         }};
 
@@ -93,8 +93,8 @@ public void testRegression() throws Exception {
         Model model = new LocalModel("regression_model", trainedModelDefinition, new TrainedModelInput(inputFields));
 
         Map<String, Object> fields = new HashMap<>() {{
-            put("foo", 1.0);
-            put("bar", 0.5);
+            put("field.foo", 1.0);
+            put("field.bar", 0.5);
             put("categorical", "dog");
         }};
 
@@ -147,7 +147,7 @@ private static Map<String, String> oneHotMap() {
     }
 
     public static TrainedModel buildClassification(boolean includeLabels) {
-        List<String> featureNames = Arrays.asList("foo", "bar", "animal_cat", "animal_dog");
+        List<String> featureNames = Arrays.asList("field.foo", "field.bar", "animal_cat", "animal_dog");
         Tree tree1 = Tree.builder()
             .setFeatureNames(featureNames)
             .setRoot(TreeNode.builder(0)
@@ -193,7 +193,7 @@ public static TrainedModel buildClassification(boolean includeLabels) {
     }
 
     public static TrainedModel buildRegression() {
-        List<String> featureNames = Arrays.asList("foo", "bar", "animal_cat", "animal_dog");
+        List<String> featureNames = Arrays.asList("field.foo", "field.bar", "animal_cat", "animal_dog");
         Tree tree1 = Tree.builder()
             .setFeatureNames(featureNames)
             .setRoot(TreeNode.builder(0)
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
index 6f48ce7d3e745..86d5f278c42a3 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/ModelInferenceActionIT.java
@@ -66,9 +66,9 @@ public void testInferModels() throws Exception {
         oneHotEncoding.put("cat", "animal_cat");
         oneHotEncoding.put("dog", "animal_dog");
         TrainedModelConfig config1 = buildTrainedModelConfigBuilder(modelId2)
-            .setInput(new TrainedModelInput(Arrays.asList("foo", "bar", "categorical")))
+            .setInput(new TrainedModelInput(Arrays.asList("field.foo", "field.bar", "other.categorical")))
             .setParsedDefinition(new TrainedModelDefinition.Builder()
-                .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotEncoding)))
+                .setPreProcessors(Arrays.asList(new OneHotEncoding("other.categorical", oneHotEncoding)))
                 .setTrainedModel(buildClassification(true)))
             .setVersion(Version.CURRENT)
             .setLicenseLevel(License.OperationMode.PLATINUM.description())
@@ -77,9 +77,9 @@ public void testInferModels() throws Exception {
             .setEstimatedHeapMemory(0)
             .build();
         TrainedModelConfig config2 = buildTrainedModelConfigBuilder(modelId1)
-            .setInput(new TrainedModelInput(Arrays.asList("foo", "bar", "categorical")))
+            .setInput(new TrainedModelInput(Arrays.asList("field.foo", "field.bar", "other.categorical")))
             .setParsedDefinition(new TrainedModelDefinition.Builder()
-                .setPreProcessors(Arrays.asList(new OneHotEncoding("categorical", oneHotEncoding)))
+                .setPreProcessors(Arrays.asList(new OneHotEncoding("other.categorical", oneHotEncoding)))
                 .setTrainedModel(buildRegression()))
             .setVersion(Version.CURRENT)
             .setEstimatedOperations(0)
@@ -99,26 +99,42 @@ public void testInferModels() throws Exception {
 
         List<Map<String, Object>> toInfer = new ArrayList<>();
         toInfer.add(new HashMap<>() {{
-            put("foo", 1.0);
-            put("bar", 0.5);
-            put("categorical", "dog");
+            put("field", new HashMap<>(){{
+                put("foo", 1.0);
+                put("bar", 0.5);
+            }});
+            put("other", new HashMap<>(){{
+                put("categorical", "dog");
+            }});
         }});
         toInfer.add(new HashMap<>() {{
-            put("foo", 0.9);
-            put("bar", 1.5);
-            put("categorical", "cat");
+            put("field", new HashMap<>(){{
+                put("foo", 0.9);
+                put("bar", 1.5);
+            }});
+            put("other", new HashMap<>(){{
+                put("categorical", "cat");
+            }});
         }});
 
         List<Map<String, Object>> toInfer2 = new ArrayList<>();
         toInfer2.add(new HashMap<>() {{
-            put("foo", 0.0);
-            put("bar", 0.01);
-            put("categorical", "dog");
+            put("field", new HashMap<>(){{
+                put("foo", 0.0);
+                put("bar", 0.01);
+            }});
+            put("other", new HashMap<>(){{
+                put("categorical", "dog");
+            }});
         }});
         toInfer2.add(new HashMap<>() {{
-            put("foo", 1.0);
-            put("bar", 0.0);
-            put("categorical", "cat");
+            put("field", new HashMap<>(){{
+                put("foo", 1.0);
+                put("bar", 0.0);
+            }});
+            put("other", new HashMap<>(){{
+                put("categorical", "cat");
+            }});
         }});
 
         // Test regression

From a53ce5259cd205712542a632337645d281455c27 Mon Sep 17 00:00:00 2001
From: lcawl <lcawley@elastic.co>
Date: Wed, 18 Dec 2019 11:46:00 -0800
Subject: [PATCH 259/686] [DOCS] Fixes security links

---
 docs/reference/ml/anomaly-detection/stopping-ml.asciidoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ml/anomaly-detection/stopping-ml.asciidoc b/docs/reference/ml/anomaly-detection/stopping-ml.asciidoc
index e91776e287aec..9902ef59857f8 100644
--- a/docs/reference/ml/anomaly-detection/stopping-ml.asciidoc
+++ b/docs/reference/ml/anomaly-detection/stopping-ml.asciidoc
@@ -30,7 +30,7 @@ POST _ml/datafeeds/feed1/_stop
 // TEST[skip:setup:server_metrics_startdf]
 
 NOTE: You must have `manage_ml`, or `manage` cluster privileges to stop {dfeeds}.
-For more information, see <<security-privileges>>.
+For more information, see {ref}/security-privileges.html[Security privileges]
 
 A {dfeed} can be started and stopped multiple times throughout its lifecycle.
 
@@ -69,7 +69,7 @@ POST _ml/anomaly_detectors/job1/_close
 // TEST[skip:setup:server_metrics_openjob]
 
 NOTE: You must have `manage_ml`, or `manage` cluster privileges to stop {dfeeds}.
-For more information, see <<security-privileges>>.
+For more information, see {ref}/security-privileges.html[Security privileges]
 
 {anomaly-jobs-cap} can be opened and closed multiple times throughout their
 lifecycle.

From 603ebef7a723275b700adbc82745e1841de447e8 Mon Sep 17 00:00:00 2001
From: Stuart Tettemer <stu@elastic.co>
Date: Wed, 18 Dec 2019 13:29:17 -0700
Subject: [PATCH 260/686] [TEST] Exclude name on ScriptContextInfo mutate
 (#50332)

ScriptContextInfoSerializingTests:testEqualsAndHashcode was failing
because the mutation was generating the same name.

Fixes: #50331
---
 .../storedscripts/ScriptContextInfoSerializingTests.java     | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/storedscripts/ScriptContextInfoSerializingTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/storedscripts/ScriptContextInfoSerializingTests.java
index 3a9fb4d3baa39..588a39489b737 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/storedscripts/ScriptContextInfoSerializingTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/storedscripts/ScriptContextInfoSerializingTests.java
@@ -56,7 +56,10 @@ protected ScriptContextInfo mutateInstance(ScriptContextInfo instance) throws IO
     }
 
     private static ScriptContextInfo mutate(ScriptContextInfo instance, Set<String> names) {
-        if (names == null) { names = new HashSet<>(); }
+        if (names == null) {
+            names = new HashSet<>();
+            names.add(instance.name);
+        }
         switch (randomIntBetween(0, 2)) {
             case 0:
                 return new ScriptContextInfo(

From b6211cdbfdc8b7bd480860195be7caefb083d25c Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 18 Dec 2019 16:57:38 -0500
Subject: [PATCH 261/686] [DOCS] Document `thread_pool` node stats (#50330)

---
 docs/reference/cluster/nodes-stats.asciidoc | 41 +++++++++++++++++----
 1 file changed, 34 insertions(+), 7 deletions(-)

diff --git a/docs/reference/cluster/nodes-stats.asciidoc b/docs/reference/cluster/nodes-stats.asciidoc
index d607c6430d789..af3ad0deee442 100644
--- a/docs/reference/cluster/nodes-stats.asciidoc
+++ b/docs/reference/cluster/nodes-stats.asciidoc
@@ -895,6 +895,33 @@ Total number of buffer pool classes loaded since the JVM started.
 (integer)
 Total number of buffer pool classes unloaded since the JVM started.
 
+[[cluster-nodes-stats-api-response-body-threadpool]]
+===== `thread_pool` section
+
+`thread_pool.<thread_pool_name>.threads`::
+(integer)
+Number of threads in the thread pool.
+
+`thread_pool.<thread_pool_name>.queue`::
+(integer)
+Number of tasks in queue for the thread pool.
+
+`thread_pool.<thread_pool_name>.active`::
+(integer)
+Number of active threads in the thread pool.
+
+`thread_pool.<thread_pool_name>.rejected`::
+(integer)
+Number of tasks rejected by the thread pool executor.
+
+`thread_pool.<thread_pool_name>.largest`::
+(integer)
+Highest number of active threads in the thread pool.
+
+`thread_pool.<thread_pool_name>.completed`::
+(integer)
+Number of tasks completed by the thread pool executor.
+
 [[cluster-nodes-stats-api-response-body-ingest]]
 ===== `ingest` section
 
@@ -915,31 +942,31 @@ Total number of buffer pool classes unloaded since the JVM started.
     (integer)
     Total number of failed ingest operations during the lifetime of this node.
 
-`ingest.pipelines.<pipeline-id>.count`::
+`ingest.pipelines.<pipeline_id>.count`::
     (integer)
     Number of documents preprocessed by the ingest pipeline.
 
-`ingest.pipelines.<pipeline-id>.time_in_millis`::
+`ingest.pipelines.<pipeline_id>.time_in_millis`::
     (integer)
     Total time spent preprocessing documents in the ingest pipeline.
 
-`ingest.pipelines.<pipeline-id>.failed`::
+`ingest.pipelines.<pipeline_id>.failed`::
     (integer)
     Total number of failed operations for the ingest pipeline.
 
-`ingest.pipelines.<pipeline-id>.<processor>.count`::
+`ingest.pipelines.<pipeline_id>.<processor>.count`::
     (integer)
     Number of documents transformed by the processor.
 
-`ingest.pipelines.<pipeline-id>.<processor>.time_in_millis`::
+`ingest.pipelines.<pipeline_id>.<processor>.time_in_millis`::
     (integer)
     Time spent by the processor transforming documents.
 
-`ingest.pipelines.<pipeline-id>.<processor>.current`::
+`ingest.pipelines.<pipeline_id>.<processor>.current`::
     (integer)
     Number of documents currently being transformed by the processor.
 
-`ingest.pipelines.<pipeline-id>.<processor>.failed`::
+`ingest.pipelines.<pipeline_id>.<processor>.failed`::
     (integer)
     Number of failed operations for the processor.
 

From 49c05ee14cb97b2834bfc232b2dc1077b555cba4 Mon Sep 17 00:00:00 2001
From: Stuart Tettemer <stu@elastic.co>
Date: Wed, 18 Dec 2019 15:03:53 -0700
Subject: [PATCH 262/686] [TEST] BWC re-enable after backport of #50106
 (#50336)

---
 build.gradle | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/build.gradle b/build.gradle
index 6f786b5c3beea..df1641dcc9efe 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = false
-final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/50106" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = true
+final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")

From 16dcea199c9daa829d44112f5fa6175464104712 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Wed, 18 Dec 2019 16:09:59 -0700
Subject: [PATCH 263/686] Add ILM histore store index (#50287)

* Add ILM histore store index

This commit adds an ILM history store that tracks the lifecycle
execution state as an index progresses through its ILM policy. ILM
history documents store output similar to what the ILM explain API
returns.

An example document with ALL fields (not all documents will have all
fields) would look like:

```json
{
  "@timestamp": 1203012389,
  "policy": "my-ilm-policy",
  "index": "index-2019.1.1-000023",
  "index_age":123120,
  "success": true,
  "state": {
    "phase": "warm",
    "action": "allocate",
    "step": "ERROR",
    "failed_step": "update-settings",
    "is_auto-retryable_error": true,
    "creation_date": 12389012039,
    "phase_time": 12908389120,
    "action_time": 1283901209,
    "step_time": 123904107140,
    "phase_definition": "{\"policy\":\"ilm-history-ilm-policy\",\"phase_definition\":{\"min_age\":\"0ms\",\"actions\":{\"rollover\":{\"max_size\":\"50gb\",\"max_age\":\"30d\"}}},\"version\":1,\"modified_date_in_millis\":1576517253463}",
    "step_info": "{... etc step info here as json ...}"
  },
  "error_details": "java.lang.RuntimeException: etc\n\tcaused by:etc etc etc full stacktrace"
}
```

These documents go into the `ilm-history-1-00000N` index to provide an
audit trail of the operations ILM has performed.

This history storage is enabled by default but can be disabled by setting
`index.lifecycle.history_index_enabled` to `false.`

Resolves #49180
---
 client/rest-high-level/build.gradle           |   1 +
 docs/build.gradle                             |   1 +
 docs/plugins/analysis-icu.asciidoc            |   2 +-
 .../reference/indices/rollover-index.asciidoc |   2 +-
 docs/reference/settings/ilm-settings.asciidoc |   5 +
 .../test/rest/ESRestTestCase.java             |  24 +-
 .../xpack/core/ilm/LifecycleSettings.java     |   3 +
 .../resources/ilm-history-ilm-policy.json     |  18 +
 .../core/src/main/resources/ilm-history.json  |  83 ++++
 x-pack/plugin/ilm/qa/multi-node/build.gradle  |   2 +
 .../ilm/TimeSeriesLifecycleActionsIT.java     | 172 +++++++-
 .../xpack/ilm/ExecuteStepsUpdateTask.java     |  52 ++-
 .../xpack/ilm/IndexLifecycle.java             |  14 +-
 .../xpack/ilm/IndexLifecycleRunner.java       | 128 +++++-
 .../xpack/ilm/IndexLifecycleService.java      |   8 +-
 .../xpack/ilm/MoveToErrorStepUpdateTask.java  |  13 +-
 .../xpack/ilm/history/ILMHistoryItem.java     | 115 +++++
 .../xpack/ilm/history/ILMHistoryStore.java    | 189 +++++++++
 .../history/ILMHistoryTemplateRegistry.java   |  80 ++++
 .../IndexLifecycleInitialisationTests.java    |   3 +-
 .../xpack/ilm/IndexLifecycleRunnerTests.java  |  77 +++-
 .../xpack/ilm/IndexLifecycleServiceTests.java |   2 +-
 .../ilm/MoveToErrorStepUpdateTaskTests.java   |   8 +-
 .../ilm/history/ILMHistoryItemTests.java      |  92 ++++
 .../ilm/history/ILMHistoryStoreTests.java     | 398 ++++++++++++++++++
 .../test/MonitoringIntegTestCase.java         |   1 +
 .../AbstractWatcherIntegrationTestCase.java   |   1 +
 27 files changed, 1419 insertions(+), 75 deletions(-)
 create mode 100644 x-pack/plugin/core/src/main/resources/ilm-history-ilm-policy.json
 create mode 100644 x-pack/plugin/core/src/main/resources/ilm-history.json
 create mode 100644 x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryItem.java
 create mode 100644 x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStore.java
 create mode 100644 x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryTemplateRegistry.java
 create mode 100644 x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryItemTests.java
 create mode 100644 x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStoreTests.java

diff --git a/client/rest-high-level/build.gradle b/client/rest-high-level/build.gradle
index d1f63d837fdce..1df697cbc5f6e 100644
--- a/client/rest-high-level/build.gradle
+++ b/client/rest-high-level/build.gradle
@@ -138,6 +138,7 @@ testClusters.all {
   setting 'xpack.security.authc.realms.pki.pki1.delegation.enabled', 'true'
 
   setting 'indices.lifecycle.poll_interval', '1000ms'
+  setting 'index.lifecycle.history_index_enabled', 'false'
   keystore 'xpack.security.transport.ssl.truststore.secure_password', 'testnode'
   extraConfigFile 'roles.yml', file('roles.yml')
   user username: System.getProperty('tests.rest.cluster.username', 'test_user'),
diff --git a/docs/build.gradle b/docs/build.gradle
index a39c7e0d9f3bd..5d9b8ae0a73e8 100644
--- a/docs/build.gradle
+++ b/docs/build.gradle
@@ -60,6 +60,7 @@ testClusters.integTest {
   extraConfigFile 'hunspell/en_US/en_US.dic', project(":server").file('src/test/resources/indices/analyze/conf_dir/hunspell/en_US/en_US.dic')
   // Whitelist reindexing from the local node so we can test it.
   setting 'reindex.remote.whitelist', '127.0.0.1:*'
+  setting 'index.lifecycle.history_index_enabled', 'false'
 
   // TODO: remove this once cname is prepended to transport.publish_address by default in 8.0
   systemProperty 'es.transport.cname_in_publish_address', 'true'
diff --git a/docs/plugins/analysis-icu.asciidoc b/docs/plugins/analysis-icu.asciidoc
index 19a8625f60403..d0b95ae7f497b 100644
--- a/docs/plugins/analysis-icu.asciidoc
+++ b/docs/plugins/analysis-icu.asciidoc
@@ -368,7 +368,7 @@ PUT my_index
   }
 }
 
-GET _search <3>
+GET /my_index/_search <3>
 {
   "query": {
     "match": {
diff --git a/docs/reference/indices/rollover-index.asciidoc b/docs/reference/indices/rollover-index.asciidoc
index c4c7fb980bebb..b75961a52559e 100644
--- a/docs/reference/indices/rollover-index.asciidoc
+++ b/docs/reference/indices/rollover-index.asciidoc
@@ -428,7 +428,7 @@ PUT logs/_doc/2 <2>
 //////////////////////////
 [source,console]
 --------------------------------------------------
-GET _alias
+GET my_logs_index-000001,my_logs_index-000002/_alias
 --------------------------------------------------
 // TEST[continued]
 //////////////////////////
diff --git a/docs/reference/settings/ilm-settings.asciidoc b/docs/reference/settings/ilm-settings.asciidoc
index 8781581a6e57d..946848017bf7b 100644
--- a/docs/reference/settings/ilm-settings.asciidoc
+++ b/docs/reference/settings/ilm-settings.asciidoc
@@ -14,6 +14,11 @@ ILM REST API endpoints and functionality. Defaults to `true`.
 (<<time-units, time units>>) How often {ilm} checks for indices that meet policy
 criteria. Defaults to `10m`.
 
+`index.lifecycle.history_index_enabled`::
+Whether ILM's history index is enabled. If enabled, ILM will record the
+history of actions taken as part of ILM policies to the `ilm-history-*`
+indices. Defaults to `true`.
+
 ==== Index level settings
 These index-level {ilm-init} settings are typically configured through index
 templates. For more information, see <<ilm-gs-create-policy>>.
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index 1eb52ac6de769..73ca1dde99ca8 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -75,6 +75,7 @@
 import java.security.cert.CertificateException;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
@@ -448,6 +449,13 @@ protected boolean preserveILMPoliciesUponCompletion() {
         return false;
     }
 
+    /**
+     * A set of ILM policies that should be preserved between runs.
+     */
+    protected Set<String> preserveILMPolicyIds() {
+        return Collections.singleton("ilm-history-ilm-policy");
+    }
+
     /**
      * Returns whether to preserve auto-follow patterns. Defaults to not
      * preserving them. Only runs at all if xpack is installed on the cluster
@@ -545,7 +553,7 @@ private void wipeCluster() throws Exception {
         }
 
         if (hasXPack && false == preserveILMPoliciesUponCompletion()) {
-            deleteAllILMPolicies();
+            deleteAllILMPolicies(preserveILMPolicyIds());
         }
 
         if (hasXPack && false == preserveAutoFollowPatternsUponCompletion()) {
@@ -680,7 +688,7 @@ private void waitForPendingRollupTasks() throws Exception {
         waitForPendingTasks(adminClient(), taskName -> taskName.startsWith("xpack/rollup/job") == false);
     }
 
-    private static void deleteAllILMPolicies() throws IOException {
+    private static void deleteAllILMPolicies(Set<String> exclusions) throws IOException {
         Map<String, Object> policies;
 
         try {
@@ -699,9 +707,15 @@ private static void deleteAllILMPolicies() throws IOException {
             return;
         }
 
-        for (String policyName : policies.keySet()) {
-            adminClient().performRequest(new Request("DELETE", "/_ilm/policy/" + policyName));
-        }
+        policies.keySet().stream()
+            .filter(p -> exclusions.contains(p) == false)
+            .forEach(policyName -> {
+                try {
+                    adminClient().performRequest(new Request("DELETE", "/_ilm/policy/" + policyName));
+                } catch (IOException e) {
+                    throw new RuntimeException("failed to delete policy: " + policyName, e);
+                }
+            });
     }
 
     private static void deleteAllSLMPolicies() throws IOException {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecycleSettings.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecycleSettings.java
index de037dc6f034e..b10f8defcdfc7 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecycleSettings.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecycleSettings.java
@@ -19,6 +19,7 @@ public class LifecycleSettings {
     public static final String LIFECYCLE_INDEXING_COMPLETE = "index.lifecycle.indexing_complete";
     public static final String LIFECYCLE_ORIGINATION_DATE = "index.lifecycle.origination_date";
     public static final String LIFECYCLE_PARSE_ORIGINATION_DATE = "index.lifecycle.parse_origination_date";
+    public static final String LIFECYCLE_HISTORY_INDEX_ENABLED = "index.lifecycle.history_index_enabled";
 
     public static final String SLM_HISTORY_INDEX_ENABLED = "slm.history_index_enabled";
     public static final String SLM_RETENTION_SCHEDULE = "slm.retention_schedule";
@@ -35,6 +36,8 @@ public class LifecycleSettings {
         Setting.longSetting(LIFECYCLE_ORIGINATION_DATE, -1, -1, Setting.Property.Dynamic, Setting.Property.IndexScope);
     public static final Setting<Boolean> LIFECYCLE_PARSE_ORIGINATION_DATE_SETTING = Setting.boolSetting(LIFECYCLE_PARSE_ORIGINATION_DATE,
         false, Setting.Property.Dynamic, Setting.Property.IndexScope);
+    public static final Setting<Boolean> LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING = Setting.boolSetting(LIFECYCLE_HISTORY_INDEX_ENABLED,
+        true, Setting.Property.NodeScope);
 
 
     public static final Setting<Boolean> SLM_HISTORY_INDEX_ENABLED_SETTING = Setting.boolSetting(SLM_HISTORY_INDEX_ENABLED, true,
diff --git a/x-pack/plugin/core/src/main/resources/ilm-history-ilm-policy.json b/x-pack/plugin/core/src/main/resources/ilm-history-ilm-policy.json
new file mode 100644
index 0000000000000..febae00bc3608
--- /dev/null
+++ b/x-pack/plugin/core/src/main/resources/ilm-history-ilm-policy.json
@@ -0,0 +1,18 @@
+{
+  "phases": {
+    "hot": {
+      "actions": {
+        "rollover": {
+          "max_size": "50GB",
+          "max_age": "30d"
+        }
+      }
+    },
+    "delete": {
+      "min_age": "90d",
+      "actions": {
+        "delete": {}
+      }
+    }
+  }
+}
diff --git a/x-pack/plugin/core/src/main/resources/ilm-history.json b/x-pack/plugin/core/src/main/resources/ilm-history.json
new file mode 100644
index 0000000000000..ae9c50552b385
--- /dev/null
+++ b/x-pack/plugin/core/src/main/resources/ilm-history.json
@@ -0,0 +1,83 @@
+{
+  "index_patterns": [
+    "ilm-history-${xpack.ilm_history.template.version}*"
+  ],
+  "order": 2147483647,
+  "settings": {
+    "index.number_of_shards": 1,
+    "index.number_of_replicas": 0,
+    "index.auto_expand_replicas": "0-1",
+    "index.lifecycle.name": "ilm-history-ilm-policy",
+    "index.lifecycle.rollover_alias": "ilm-history-${xpack.ilm_history.template.version}",
+    "index.format": 1
+  },
+  "mappings": {
+    "_doc": {
+      "dynamic": false,
+      "properties": {
+        "@timestamp": {
+          "type": "date",
+          "format": "epoch_millis"
+        },
+        "policy": {
+          "type": "keyword"
+        },
+        "index": {
+          "type": "keyword"
+        },
+        "index_age":{
+          "type": "long"
+        },
+        "success": {
+          "type": "boolean"
+        },
+        "state": {
+          "type": "object",
+          "dynamic": true,
+          "properties": {
+            "phase": {
+              "type": "keyword"
+            },
+            "action": {
+              "type": "keyword"
+            },
+            "step": {
+              "type": "keyword"
+            },
+            "failed_step": {
+              "type": "keyword"
+            },
+            "is_auto-retryable_error": {
+              "type": "keyword"
+            },
+            "creation_date": {
+              "type": "date",
+              "format": "epoch_millis"
+            },
+            "phase_time": {
+              "type": "date",
+              "format": "epoch_millis"
+            },
+            "action_time": {
+              "type": "date",
+              "format": "epoch_millis"
+            },
+            "step_time": {
+              "type": "date",
+              "format": "epoch_millis"
+            },
+            "phase_definition": {
+              "type": "text"
+            },
+            "step_info": {
+              "type": "text"
+            }
+          }
+        },
+        "error_details": {
+          "type": "text"
+        }
+      }
+    }
+  }
+}
diff --git a/x-pack/plugin/ilm/qa/multi-node/build.gradle b/x-pack/plugin/ilm/qa/multi-node/build.gradle
index 1fd9ccd079726..b27285e9b70c4 100644
--- a/x-pack/plugin/ilm/qa/multi-node/build.gradle
+++ b/x-pack/plugin/ilm/qa/multi-node/build.gradle
@@ -25,4 +25,6 @@ testClusters.integTest {
   setting 'xpack.ml.enabled', 'false'
   setting 'xpack.license.self_generated.type', 'trial'
   setting 'indices.lifecycle.poll_interval', '1000ms'
+  setting 'logger.org.elasticsearch.xpack.core.ilm', 'TRACE'
+  setting 'logger.org.elasticsearch.xpack.ilm', 'TRACE'
 }
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index f1de3fe738820..29976664bc896 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -8,14 +8,15 @@
 
 import org.apache.http.entity.ContentType;
 import org.apache.http.entity.StringEntity;
-import org.apache.log4j.LogManager;
-import org.apache.log4j.Logger;
 import org.apache.lucene.codecs.Codec;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.Response;
 import org.elasticsearch.client.ResponseException;
 import org.elasticsearch.client.RestClient;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
@@ -38,8 +39,10 @@
 import org.elasticsearch.xpack.core.ilm.SetPriorityAction;
 import org.elasticsearch.xpack.core.ilm.ShrinkAction;
 import org.elasticsearch.xpack.core.ilm.ShrinkStep;
+import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
+import org.elasticsearch.xpack.core.ilm.WaitForRolloverReadyStep;
 import org.hamcrest.Matchers;
 import org.junit.Before;
 
@@ -1002,6 +1005,171 @@ public void testILMRolloverOnManuallyRolledIndex() throws Exception {
        assertBusy(() -> assertTrue(indexExists(thirdIndex)));
    }
 
+    public void testHistoryIsWrittenWithSuccess() throws Exception {
+        String index = "index";
+
+        createNewSingletonPolicy("hot", new RolloverAction(null, null, 1L));
+        Request createIndexTemplate = new Request("PUT", "_template/rolling_indexes");
+        createIndexTemplate.setJsonEntity("{" +
+            "\"index_patterns\": [\""+ index + "-*\"], \n" +
+            "  \"settings\": {\n" +
+            "    \"number_of_shards\": 1,\n" +
+            "    \"number_of_replicas\": 0,\n" +
+            "    \"index.lifecycle.name\": \"" + policy+ "\",\n" +
+            "    \"index.lifecycle.rollover_alias\": \"alias\"\n" +
+            "  }\n" +
+            "}");
+        client().performRequest(createIndexTemplate);
+
+        createIndexWithSettings(index + "-1",
+            Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0),
+            true);
+
+        // Index a document
+        index(client(), index + "-1", "1", "foo", "bar");
+        Request refreshIndex = new Request("POST", "/" + index + "-1/_refresh");
+        client().performRequest(refreshIndex);
+
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "wait-for-indexing-complete"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "wait-for-follow-shard-tasks"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "pause-follower-index"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "close-follower-index"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "unfollow-follower-index"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "open-follower-index"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "wait-for-yellow-step"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "check-rollover-ready"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "attempt-rollover"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "update-rollover-lifecycle-date"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "set-indexing-complete"), 30, TimeUnit.SECONDS);
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "completed"), 30, TimeUnit.SECONDS);
+
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-000002", true, "check-rollover-ready"), 30, TimeUnit.SECONDS);
+    }
+
+    public void testHistoryIsWrittenWithFailure() throws Exception {
+        String index = "index";
+
+        createNewSingletonPolicy("hot", new RolloverAction(null, null, 1L));
+        Request createIndexTemplate = new Request("PUT", "_template/rolling_indexes");
+        createIndexTemplate.setJsonEntity("{" +
+            "\"index_patterns\": [\""+ index + "-*\"], \n" +
+            "  \"settings\": {\n" +
+            "    \"number_of_shards\": 1,\n" +
+            "    \"number_of_replicas\": 0,\n" +
+            "    \"index.lifecycle.name\": \"" + policy+ "\"\n" +
+            "  }\n" +
+            "}");
+        client().performRequest(createIndexTemplate);
+
+        createIndexWithSettings(index + "-1",
+            Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0),
+            false);
+
+        // Index a document
+        index(client(), index + "-1", "1", "foo", "bar");
+        Request refreshIndex = new Request("POST", "/" + index + "-1/_refresh");
+        client().performRequest(refreshIndex);
+
+        assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", false, "ERROR"), 30, TimeUnit.SECONDS);
+    }
+
+    public void testHistoryIsWrittenWithDeletion() throws Exception {
+        String index = "index";
+
+        createNewSingletonPolicy("delete", new DeleteAction());
+        Request createIndexTemplate = new Request("PUT", "_template/delete_indexes");
+        createIndexTemplate.setJsonEntity("{" +
+            "\"index_patterns\": [\""+ index + "\"], \n" +
+            "  \"settings\": {\n" +
+            "    \"number_of_shards\": 1,\n" +
+            "    \"number_of_replicas\": 0,\n" +
+            "    \"index.lifecycle.name\": \"" + policy+ "\"\n" +
+            "  }\n" +
+            "}");
+        client().performRequest(createIndexTemplate);
+
+        // Index should be created and then deleted by ILM
+        createIndexWithSettings(index, Settings.builder(), false);
+
+        assertBusy(() -> {
+            logger.info("--> checking for index deletion...");
+            Request existCheck = new Request("HEAD", "/" + index);
+            Response resp = client().performRequest(existCheck);
+            assertThat(resp.getStatusLine().getStatusCode(), equalTo(404));
+        });
+
+        assertBusy(() -> {
+            assertHistoryIsPresent(policy, index, true, "delete", "delete", "wait-for-shard-history-leases");
+            assertHistoryIsPresent(policy, index, true, "delete", "delete", "complete");
+        }, 30, TimeUnit.SECONDS);
+    }
+
+    // This method should be called inside an assertBusy, it has no retry logic of its own
+    private void assertHistoryIsPresent(String policyName, String indexName, boolean success, String stepName) throws IOException {
+        assertHistoryIsPresent(policyName, indexName, success, null, null, stepName);
+    }
+
+    // This method should be called inside an assertBusy, it has no retry logic of its own
+    private void assertHistoryIsPresent(String policyName, String indexName, boolean success,
+                                        @Nullable String phase, @Nullable String action, String stepName) throws IOException {
+        logger.info("--> checking for history item [{}], [{}], success: [{}], phase: [{}], action: [{}], step: [{}]",
+            policyName, indexName, success, phase, action, stepName);
+        final Request historySearchRequest = new Request("GET", "ilm-history*/_search");
+        historySearchRequest.setJsonEntity("{\n" +
+            "  \"query\": {\n" +
+            "    \"bool\": {\n" +
+            "      \"must\": [\n" +
+            "        {\n" +
+            "          \"term\": {\n" +
+            "            \"policy\": \"" + policyName + "\"\n" +
+            "          }\n" +
+            "        },\n" +
+            "        {\n" +
+            "          \"term\": {\n" +
+            "            \"success\": " + success + "\n" +
+            "          }\n" +
+            "        },\n" +
+            "        {\n" +
+            "          \"term\": {\n" +
+            "            \"index\": \"" + indexName + "\"\n" +
+            "          }\n" +
+            "        },\n" +
+            "        {\n" +
+            "          \"term\": {\n" +
+            "            \"state.step\": \"" + stepName + "\"\n" +
+            "          }\n" +
+            "        }\n" +
+            (phase == null ? "" : ",{\"term\": {\"state.phase\": \"" + phase + "\"}}") +
+            (action == null ? "" : ",{\"term\": {\"state.action\": \"" + action + "\"}}") +
+            "      ]\n" +
+            "    }\n" +
+            "  }\n" +
+            "}");
+        Response historyResponse;
+        try {
+            historyResponse = client().performRequest(historySearchRequest);
+            Map<String, Object> historyResponseMap;
+            try (InputStream is = historyResponse.getEntity().getContent()) {
+                historyResponseMap = XContentHelper.convertToMap(XContentType.JSON.xContent(), is, true);
+            }
+            logger.info("--> history response: {}", historyResponseMap);
+            assertThat((int)((Map<String, Object>) ((Map<String, Object>) historyResponseMap.get("hits")).get("total")).get("value"),
+                greaterThanOrEqualTo(1));
+        } catch (ResponseException e) {
+            // Throw AssertionError instead of an exception if the search fails so that assertBusy works as expected
+            logger.error(e);
+            fail("failed to perform search:" + e.getMessage());
+        }
+
+        // Finally, check that the history index is in a good state
+        Step.StepKey stepKey = getStepKeyForIndex("ilm-history-1-000001");
+        assertEquals("hot", stepKey.getPhase());
+        assertEquals(RolloverAction.NAME, stepKey.getAction());
+        assertEquals(WaitForRolloverReadyStep.NAME, stepKey.getName());
+    }
+
     private void createFullPolicy(TimeValue hotTime) throws IOException {
         Map<String, LifecycleAction> hotActions = new HashMap<>();
         hotActions.put(SetPriorityAction.NAME, new SetPriorityAction(100));
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTask.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTask.java
index 46364f7cb4021..b97944fe67bf7 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTask.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/ExecuteStepsUpdateTask.java
@@ -12,10 +12,13 @@
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.ClusterStateUpdateTask;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.xpack.core.ilm.ClusterStateActionStep;
 import org.elasticsearch.xpack.core.ilm.ClusterStateWaitStep;
+import org.elasticsearch.xpack.core.ilm.ErrorStep;
+import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
 import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
 
@@ -29,8 +32,9 @@ public class ExecuteStepsUpdateTask extends ClusterStateUpdateTask {
     private final Step startStep;
     private final PolicyStepsRegistry policyStepsRegistry;
     private final IndexLifecycleRunner lifecycleRunner;
-    private LongSupplier nowSupplier;
+    private final LongSupplier nowSupplier;
     private Step.StepKey nextStepKey = null;
+    private Exception failure = null;
 
     public ExecuteStepsUpdateTask(String policy, Index index, Step startStep, PolicyStepsRegistry policyStepsRegistry,
                                   IndexLifecycleRunner lifecycleRunner, LongSupplier nowSupplier) {
@@ -115,7 +119,7 @@ public ClusterState execute(final ClusterState currentState) throws IOException
                     // wait for the next trigger to evaluate the
                     // condition again
                     logger.trace("[{}] waiting for cluster state step condition ({}) [{}], next: [{}]",
-                        index.getName(), currentStep.getClass().getSimpleName(), currentStep.getKey(), currentStep.getNextStepKey());
+                        index.getName(), currentStep.getClass().getSimpleName(), currentStep.getKey(), nextStepKey);
                     ClusterStateWaitStep.Result result;
                     try {
                         result = ((ClusterStateWaitStep) currentStep).isConditionMet(index, state);
@@ -124,22 +128,25 @@ public ClusterState execute(final ClusterState currentState) throws IOException
                     }
                     if (result.isComplete()) {
                         logger.trace("[{}] cluster state step condition met successfully ({}) [{}], moving to next step {}",
-                            index.getName(), currentStep.getClass().getSimpleName(), currentStep.getKey(), currentStep.getNextStepKey());
-                        if (currentStep.getNextStepKey() == null) {
+                            index.getName(), currentStep.getClass().getSimpleName(), currentStep.getKey(), nextStepKey);
+                        if (nextStepKey == null) {
                             return state;
                         } else {
                             state = IndexLifecycleTransition.moveClusterStateToStep(index, state,
-                                currentStep.getNextStepKey(), nowSupplier, policyStepsRegistry,false);
+                                nextStepKey, nowSupplier, policyStepsRegistry,false);
                         }
                     } else {
-                        logger.trace("[{}] condition not met ({}) [{}], returning existing state",
-                            index.getName(), currentStep.getClass().getSimpleName(), currentStep.getKey());
+                        final ToXContentObject stepInfo = result.getInfomationContext();
+                        if (logger.isTraceEnabled()) {
+                            logger.trace("[{}] condition not met ({}) [{}], returning existing state (info: {})",
+                                index.getName(), currentStep.getClass().getSimpleName(), currentStep.getKey(),
+                                Strings.toString(stepInfo));
+                        }
                         // We may have executed a step and set "nextStepKey" to
                         // a value, but in this case, since the condition was
                         // not met, we can't advance any way, so don't attempt
                         // to run the current step
                         nextStepKey = null;
-                        ToXContentObject stepInfo = result.getInfomationContext();
                         if (stepInfo == null) {
                             return state;
                         } else {
@@ -169,13 +176,23 @@ public ClusterState execute(final ClusterState currentState) throws IOException
     public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
         if (oldState.equals(newState) == false) {
             IndexMetaData indexMetaData = newState.metaData().index(index);
-            if (nextStepKey != null && nextStepKey != TerminalPolicyStep.KEY && indexMetaData != null) {
-                logger.trace("[{}] step sequence starting with {} has completed, running next step {} if it is an async action",
-                    index.getName(), startStep.getKey(), nextStepKey);
-                // After the cluster state has been processed and we have moved
-                // to a new step, we need to conditionally execute the step iff
-                // it is an `AsyncAction` so that it is executed exactly once.
-                lifecycleRunner.maybeRunAsyncAction(newState, indexMetaData, policy, nextStepKey);
+            if (indexMetaData != null) {
+
+                LifecycleExecutionState exState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
+                if (ErrorStep.NAME.equals(exState.getStep()) && this.failure != null) {
+                    lifecycleRunner.registerFailedOperation(indexMetaData, failure);
+                } else {
+                    lifecycleRunner.registerSuccessfulOperation(indexMetaData);
+                }
+
+                if (nextStepKey != null && nextStepKey != TerminalPolicyStep.KEY) {
+                    logger.trace("[{}] step sequence starting with {} has completed, running next step {} if it is an async action",
+                        index.getName(), startStep.getKey(), nextStepKey);
+                    // After the cluster state has been processed and we have moved
+                    // to a new step, we need to conditionally execute the step iff
+                    // it is an `AsyncAction` so that it is executed exactly once.
+                    lifecycleRunner.maybeRunAsyncAction(newState, indexMetaData, policy, nextStepKey);
+                }
             }
         }
     }
@@ -187,10 +204,9 @@ public void onFailure(String source, Exception e) {
     }
 
     private ClusterState moveToErrorStep(final ClusterState state, Step.StepKey currentStepKey, Exception cause) throws IOException {
+        this.failure = cause;
         logger.error("policy [{}] for index [{}] failed on cluster state step [{}]. Moving to ERROR step", policy, index.getName(),
             currentStepKey);
-        MoveToErrorStepUpdateTask moveToErrorStepUpdateTask = new MoveToErrorStepUpdateTask(index, policy, currentStepKey, cause,
-            nowSupplier, policyStepsRegistry::getStep);
-        return moveToErrorStepUpdateTask.execute(state);
+        return IndexLifecycleTransition.moveClusterStateToErrorStep(index, state, cause, nowSupplier, policyStepsRegistry::getStep);
     }
 }
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
index 394174ed673f6..4051b291b9801 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
@@ -94,6 +94,8 @@
 import org.elasticsearch.xpack.ilm.action.TransportRetryAction;
 import org.elasticsearch.xpack.ilm.action.TransportStartILMAction;
 import org.elasticsearch.xpack.ilm.action.TransportStopILMAction;
+import org.elasticsearch.xpack.ilm.history.ILMHistoryStore;
+import org.elasticsearch.xpack.ilm.history.ILMHistoryTemplateRegistry;
 import org.elasticsearch.xpack.slm.SLMInfoTransportAction;
 import org.elasticsearch.xpack.slm.SLMUsageTransportAction;
 import org.elasticsearch.xpack.slm.SnapshotLifecycleService;
@@ -132,6 +134,7 @@
 
 public class IndexLifecycle extends Plugin implements ActionPlugin {
     private final SetOnce<IndexLifecycleService> indexLifecycleInitialisationService = new SetOnce<>();
+    private final SetOnce<ILMHistoryStore> ilmHistoryStore = new SetOnce<>();
     private final SetOnce<SnapshotLifecycleService> snapshotLifecycleService = new SetOnce<>();
     private final SetOnce<SnapshotRetentionService> snapshotRetentionService = new SetOnce<>();
     private final SetOnce<SnapshotHistoryStore> snapshotHistoryStore = new SetOnce<>();
@@ -158,6 +161,7 @@ public List<Setting<?>> getSettings() {
             LifecycleSettings.LIFECYCLE_ORIGINATION_DATE_SETTING,
             LifecycleSettings.LIFECYCLE_PARSE_ORIGINATION_DATE_SETTING,
             LifecycleSettings.LIFECYCLE_INDEXING_COMPLETE_SETTING,
+            LifecycleSettings.LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING,
             RolloverAction.LIFECYCLE_ROLLOVER_ALIAS_SETTING,
             LifecycleSettings.SLM_HISTORY_INDEX_ENABLED_SETTING,
             LifecycleSettings.SLM_RETENTION_SCHEDULE_SETTING,
@@ -171,8 +175,13 @@ public Collection<Object> createComponents(Client client, ClusterService cluster
                                                NodeEnvironment nodeEnvironment, NamedWriteableRegistry namedWriteableRegistry) {
         final List<Object> components = new ArrayList<>();
         if (ilmEnabled) {
+            // This registers a cluster state listener, so appears unused but is not.
+            @SuppressWarnings("unused")
+            ILMHistoryTemplateRegistry ilmTemplateRegistry =
+                new ILMHistoryTemplateRegistry(settings, clusterService, threadPool, client, xContentRegistry);
+            ilmHistoryStore.set(new ILMHistoryStore(settings, new OriginSettingClient(client, INDEX_LIFECYCLE_ORIGIN), clusterService));
             indexLifecycleInitialisationService.set(new IndexLifecycleService(settings, client, clusterService, threadPool,
-                getClock(), System::currentTimeMillis, xContentRegistry));
+                getClock(), System::currentTimeMillis, xContentRegistry, ilmHistoryStore.get()));
             components.add(indexLifecycleInitialisationService.get());
         }
         if (slmEnabled) {
@@ -308,7 +317,8 @@ public void onIndexModule(IndexModule indexModule) {
     @Override
     public void close() {
         try {
-            IOUtils.close(indexLifecycleInitialisationService.get(), snapshotLifecycleService.get(), snapshotRetentionService.get());
+            IOUtils.close(indexLifecycleInitialisationService.get(), ilmHistoryStore.get(),
+                snapshotLifecycleService.get(), snapshotRetentionService.get());
         } catch (IOException e) {
             throw new ElasticsearchException("unable to close index lifecycle services", e);
         }
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
index 5d64c35498a3d..736d5decc1123 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.cluster.ClusterStateUpdateTask;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.index.Index;
@@ -23,10 +24,13 @@
 import org.elasticsearch.xpack.core.ilm.ClusterStateWaitStep;
 import org.elasticsearch.xpack.core.ilm.ErrorStep;
 import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
+import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
 import org.elasticsearch.xpack.core.ilm.PhaseCompleteStep;
 import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
+import org.elasticsearch.xpack.ilm.history.ILMHistoryItem;
+import org.elasticsearch.xpack.ilm.history.ILMHistoryStore;
 
 import java.util.function.LongSupplier;
 
@@ -35,13 +39,15 @@
 class IndexLifecycleRunner {
     private static final Logger logger = LogManager.getLogger(IndexLifecycleRunner.class);
     private final ThreadPool threadPool;
-    private PolicyStepsRegistry stepRegistry;
-    private ClusterService clusterService;
-    private LongSupplier nowSupplier;
+    private final ClusterService clusterService;
+    private final PolicyStepsRegistry stepRegistry;
+    private final ILMHistoryStore ilmHistoryStore;
+    private final LongSupplier nowSupplier;
 
-    IndexLifecycleRunner(PolicyStepsRegistry stepRegistry, ClusterService clusterService,
+    IndexLifecycleRunner(PolicyStepsRegistry stepRegistry, ILMHistoryStore ilmHistoryStore, ClusterService clusterService,
                          ThreadPool threadPool, LongSupplier nowSupplier) {
         this.stepRegistry = stepRegistry;
+        this.ilmHistoryStore = ilmHistoryStore;
         this.clusterService = clusterService;
         this.nowSupplier = nowSupplier;
         this.threadPool = threadPool;
@@ -62,17 +68,29 @@ static Step getCurrentStep(PolicyStepsRegistry stepRegistry, String policy, Inde
     }
 
     /**
-     * Return true or false depending on whether the index is ready to be in {@code phase}
+     * Calculate the index's origination time (in milliseconds) based on its
+     * metadata. Returns null if there is no lifecycle date and the origination
+     * date is not set.
      */
-    boolean isReadyToTransitionToThisPhase(final String policy, final IndexMetaData indexMetaData, final String phase) {
+    @Nullable
+    private static Long calculateOriginationMillis(final IndexMetaData indexMetaData) {
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(indexMetaData);
         Long originationDate = indexMetaData.getSettings().getAsLong(LIFECYCLE_ORIGINATION_DATE, -1L);
         if (lifecycleState.getLifecycleDate() == null && originationDate == -1L) {
-            logger.trace("no index creation or origination date has been set yet");
+            return null;
+        }
+        return originationDate == -1L ? lifecycleState.getLifecycleDate() : originationDate;
+    }
+
+    /**
+     * Return true or false depending on whether the index is ready to be in {@code phase}
+     */
+    boolean isReadyToTransitionToThisPhase(final String policy, final IndexMetaData indexMetaData, final String phase) {
+        final Long lifecycleDate = calculateOriginationMillis(indexMetaData);
+        if (lifecycleDate == null) {
+            logger.trace("[{}] no index creation or origination date has been set yet", indexMetaData.getIndex().getName());
             return true;
         }
-        final Long lifecycleDate = originationDate != -1L ? originationDate : lifecycleState.getLifecycleDate();
-        assert lifecycleDate != null && lifecycleDate >= 0 : "expected index to have a lifecycle date but it did not";
         final TimeValue after = stepRegistry.getIndexAgeForPhase(policy, phase);
         final long now = nowSupplier.getAsLong();
         final TimeValue age = new TimeValue(now - lifecycleDate);
@@ -221,19 +239,26 @@ void maybeRunAsyncAction(ClusterState currentState, IndexMetaData indexMetaData,
             ((AsyncActionStep) currentStep).performAction(indexMetaData, currentState,
                 new ClusterStateObserver(clusterService, null, logger, threadPool.getThreadContext()), new AsyncActionStep.Listener() {
 
-                @Override
-                public void onResponse(boolean complete) {
-                    logger.trace("cs-change-async-action-callback, [{}], current-step: {}", index, currentStep.getKey());
-                    if (complete && ((AsyncActionStep) currentStep).indexSurvives()) {
-                        moveToStep(indexMetaData.getIndex(), policy, currentStep.getKey(), currentStep.getNextStepKey());
+                    @Override
+                    public void onResponse(boolean complete) {
+                        logger.trace("cs-change-async-action-callback, [{}], current-step: {}", index, currentStep.getKey());
+                        if (complete) {
+                            if (((AsyncActionStep) currentStep).indexSurvives()) {
+                                moveToStep(indexMetaData.getIndex(), policy, currentStep.getKey(), currentStep.getNextStepKey());
+                            } else {
+                                // Delete needs special handling, because after this step we
+                                // will no longer have access to any information about the
+                                // index since it will be... deleted.
+                                registerDeleteOperation(indexMetaData);
+                            }
+                        }
                     }
-                }
 
-                @Override
-                public void onFailure(Exception e) {
-                    moveToErrorStep(indexMetaData.getIndex(), policy, currentStep.getKey(), e);
-                }
-            });
+                    @Override
+                    public void onFailure(Exception e) {
+                        moveToErrorStep(indexMetaData.getIndex(), policy, currentStep.getKey(), e);
+                    }
+                });
         } else {
             logger.trace("[{}] ignoring non async action step execution from step transition [{}]", index, currentStep.getKey());
         }
@@ -298,6 +323,7 @@ private void moveToStep(Index index, String policy, Step.StepKey currentStepKey,
             new MoveToNextStepUpdateTask(index, policy, currentStepKey, newStepKey, nowSupplier, stepRegistry, clusterState ->
             {
                 IndexMetaData indexMetaData = clusterState.metaData().index(index);
+                registerSuccessfulOperation(indexMetaData);
                 if (newStepKey != null && newStepKey != TerminalPolicyStep.KEY && indexMetaData != null) {
                     maybeRunAsyncAction(clusterState, indexMetaData, policy, newStepKey);
                 }
@@ -311,7 +337,10 @@ private void moveToErrorStep(Index index, String policy, Step.StepKey currentSte
         logger.error(new ParameterizedMessage("policy [{}] for index [{}] failed on step [{}]. Moving to ERROR step",
             policy, index.getName(), currentStepKey), e);
         clusterService.submitStateUpdateTask("ilm-move-to-error-step",
-            new MoveToErrorStepUpdateTask(index, policy, currentStepKey, e, nowSupplier, stepRegistry::getStep));
+            new MoveToErrorStepUpdateTask(index, policy, currentStepKey, e, nowSupplier, stepRegistry::getStep, clusterState -> {
+                IndexMetaData indexMetaData = clusterState.metaData().index(index);
+                registerFailedOperation(indexMetaData, e);
+            }));
     }
 
     /**
@@ -343,4 +372,61 @@ private void markPolicyRetrievalError(String policyName, Index index, LifecycleE
         setStepInfo(index, policyName, LifecycleExecutionState.getCurrentStepKey(executionState),
             new SetStepInfoUpdateTask.ExceptionWrapper(e));
     }
+
+    /**
+     * For the given index metadata, register (index a document) that the index has transitioned
+     * successfully into this new state using the {@link ILMHistoryStore}
+     */
+    void registerSuccessfulOperation(IndexMetaData indexMetaData) {
+        if (indexMetaData == null) {
+            // This index may have been deleted and has no metadata, so ignore it
+            return;
+        }
+        Long origination = calculateOriginationMillis(indexMetaData);
+        ilmHistoryStore.putAsync(
+            ILMHistoryItem.success(indexMetaData.getIndex().getName(),
+                LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexMetaData.getSettings()),
+                nowSupplier.getAsLong(),
+                origination == null ? null : (nowSupplier.getAsLong() - origination),
+                LifecycleExecutionState.fromIndexMetadata(indexMetaData)));
+    }
+
+    /**
+     * For the given index metadata, register (index a document) that the index
+     * has been deleted by ILM using the {@link ILMHistoryStore}
+     */
+    void registerDeleteOperation(IndexMetaData metadataBeforeDeletion) {
+        if (metadataBeforeDeletion == null) {
+            throw new IllegalStateException("cannot register deletion of an index that did not previously exist");
+        }
+        Long origination = calculateOriginationMillis(metadataBeforeDeletion);
+        ilmHistoryStore.putAsync(
+            ILMHistoryItem.success(metadataBeforeDeletion.getIndex().getName(),
+                LifecycleSettings.LIFECYCLE_NAME_SETTING.get(metadataBeforeDeletion.getSettings()),
+                nowSupplier.getAsLong(),
+                origination == null ? null : (nowSupplier.getAsLong() - origination),
+                LifecycleExecutionState.builder(LifecycleExecutionState.fromIndexMetadata(metadataBeforeDeletion))
+                    // Register that the delete phase is now "complete"
+                    .setStep(PhaseCompleteStep.NAME)
+                    .build()));
+    }
+
+    /**
+     * For the given index metadata, register (index a document) that the index has transitioned
+     * into the ERROR state using the {@link ILMHistoryStore}
+     */
+    void registerFailedOperation(IndexMetaData indexMetaData, Exception failure) {
+        if (indexMetaData == null) {
+            // This index may have been deleted and has no metadata, so ignore it
+            return;
+        }
+        Long origination = calculateOriginationMillis(indexMetaData);
+        ilmHistoryStore.putAsync(
+            ILMHistoryItem.failure(indexMetaData.getIndex().getName(),
+                LifecycleSettings.LIFECYCLE_NAME_SETTING.get(indexMetaData.getSettings()),
+                nowSupplier.getAsLong(),
+                origination == null ? null : (nowSupplier.getAsLong() - origination),
+                LifecycleExecutionState.fromIndexMetadata(indexMetaData),
+                failure));
+    }
 }
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleService.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleService.java
index f116f9de08743..a5ae4d4673a77 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleService.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleService.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.xpack.core.ilm.ShrinkStep;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 import org.elasticsearch.xpack.core.scheduler.SchedulerEngine;
+import org.elasticsearch.xpack.ilm.history.ILMHistoryStore;
 
 import java.io.Closeable;
 import java.time.Clock;
@@ -59,21 +60,24 @@ public class IndexLifecycleService
     private final Clock clock;
     private final PolicyStepsRegistry policyRegistry;
     private final IndexLifecycleRunner lifecycleRunner;
+    private final ILMHistoryStore ilmHistoryStore;
     private final Settings settings;
     private ClusterService clusterService;
     private LongSupplier nowSupplier;
     private SchedulerEngine.Job scheduledJob;
 
     public IndexLifecycleService(Settings settings, Client client, ClusterService clusterService, ThreadPool threadPool, Clock clock,
-                                 LongSupplier nowSupplier, NamedXContentRegistry xContentRegistry) {
+                                 LongSupplier nowSupplier, NamedXContentRegistry xContentRegistry,
+                                 ILMHistoryStore ilmHistoryStore) {
         super();
         this.settings = settings;
         this.clusterService = clusterService;
         this.clock = clock;
         this.nowSupplier = nowSupplier;
         this.scheduledJob = null;
+        this.ilmHistoryStore = ilmHistoryStore;
         this.policyRegistry = new PolicyStepsRegistry(xContentRegistry, client);
-        this.lifecycleRunner = new IndexLifecycleRunner(policyRegistry, clusterService, threadPool, nowSupplier);
+        this.lifecycleRunner = new IndexLifecycleRunner(policyRegistry, ilmHistoryStore, clusterService, threadPool, nowSupplier);
         this.pollInterval = LifecycleSettings.LIFECYCLE_POLL_INTERVAL_SETTING.get(settings);
         clusterService.addStateApplier(this);
         clusterService.addListener(this);
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTask.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTask.java
index 1b80e070c5552..ae05d21021339 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTask.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTask.java
@@ -17,6 +17,7 @@
 
 import java.io.IOException;
 import java.util.function.BiFunction;
+import java.util.function.Consumer;
 import java.util.function.LongSupplier;
 
 public class MoveToErrorStepUpdateTask extends ClusterStateUpdateTask {
@@ -24,17 +25,20 @@ public class MoveToErrorStepUpdateTask extends ClusterStateUpdateTask {
     private final String policy;
     private final Step.StepKey currentStepKey;
     private final BiFunction<IndexMetaData, Step.StepKey, Step> stepLookupFunction;
+    private final Consumer<ClusterState> stateChangeConsumer;
     private LongSupplier nowSupplier;
     private Exception cause;
 
     public MoveToErrorStepUpdateTask(Index index, String policy, Step.StepKey currentStepKey, Exception cause, LongSupplier nowSupplier,
-                                     BiFunction<IndexMetaData, Step.StepKey, Step> stepLookupFunction) {
+                                     BiFunction<IndexMetaData, Step.StepKey, Step> stepLookupFunction,
+                                     Consumer<ClusterState> stateChangeConsumer) {
         this.index = index;
         this.policy = policy;
         this.currentStepKey = currentStepKey;
         this.cause = cause;
         this.nowSupplier = nowSupplier;
         this.stepLookupFunction = stepLookupFunction;
+        this.stateChangeConsumer = stateChangeConsumer;
     }
 
     Index getIndex() {
@@ -73,6 +77,13 @@ public ClusterState execute(ClusterState currentState) throws IOException {
         }
     }
 
+    @Override
+    public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
+        if (newState.equals(oldState) == false) {
+            stateChangeConsumer.accept(newState);
+        }
+    }
+
     @Override
     public void onFailure(String source, Exception e) {
         throw new ElasticsearchException("policy [" + policy + "] for index [" + index.getName()
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryItem.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryItem.java
new file mode 100644
index 0000000000000..e972613e3e901
--- /dev/null
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryItem.java
@@ -0,0 +1,115 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ilm.history;
+
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.Objects;
+
+import static org.elasticsearch.ElasticsearchException.REST_EXCEPTION_SKIP_STACK_TRACE;
+
+/**
+ * The {@link ILMHistoryItem} class encapsulates the state of an index at a point in time. It should
+ * be constructed when an index has transitioned into a new step. Construction is done through the
+ * {@link #success(String, String, long, Long, LifecycleExecutionState)} and
+ * {@link #failure(String, String, long, Long, LifecycleExecutionState, Exception)} methods.
+ */
+public class ILMHistoryItem implements ToXContentObject {
+    private static final ParseField INDEX = new ParseField("index");
+    private static final ParseField POLICY = new ParseField("policy");
+    private static final ParseField TIMESTAMP = new ParseField("@timestamp");
+    private static final ParseField INDEX_AGE = new ParseField("index_age");
+    private static final ParseField SUCCESS = new ParseField("success");
+    private static final ParseField EXECUTION_STATE = new ParseField("state");
+    private static final ParseField ERROR = new ParseField("error_details");
+
+    private final String index;
+    private final String policyId;
+    private final long timestamp;
+    @Nullable
+    private final Long indexAge;
+    private final boolean success;
+    @Nullable
+    private final LifecycleExecutionState executionState;
+    @Nullable
+    private final String errorDetails;
+
+    private ILMHistoryItem(String index, String policyId, long timestamp, @Nullable Long indexAge, boolean success,
+                           @Nullable LifecycleExecutionState executionState, @Nullable String errorDetails) {
+        this.index = index;
+        this.policyId = policyId;
+        this.timestamp = timestamp;
+        this.indexAge = indexAge;
+        this.success = success;
+        this.executionState = executionState;
+        this.errorDetails = errorDetails;
+    }
+
+    public static ILMHistoryItem success(String index, String policyId, long timestamp, @Nullable Long indexAge,
+                                         @Nullable LifecycleExecutionState executionState) {
+        return new ILMHistoryItem(index, policyId, timestamp, indexAge, true, executionState, null);
+    }
+
+    public static ILMHistoryItem failure(String index, String policyId, long timestamp, @Nullable Long indexAge,
+                                         @Nullable LifecycleExecutionState executionState, Exception error) {
+        Objects.requireNonNull(error, "ILM failures require an attached exception");
+        return new ILMHistoryItem(index, policyId, timestamp, indexAge, false, executionState, exceptionToString(error));
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.field(INDEX.getPreferredName(), index);
+        builder.field(POLICY.getPreferredName(), policyId);
+        builder.field(TIMESTAMP.getPreferredName(), timestamp);
+        if (indexAge != null) {
+            builder.field(INDEX_AGE.getPreferredName(), indexAge);
+        }
+        builder.field(SUCCESS.getPreferredName(), success);
+        if (executionState != null) {
+            builder.field(EXECUTION_STATE.getPreferredName(), executionState.asMap());
+        }
+        if (errorDetails != null) {
+            builder.field(ERROR.getPreferredName(), errorDetails);
+        }
+        builder.endObject();
+        return builder;
+    }
+
+    private static String exceptionToString(Exception exception) {
+        Params stacktraceParams = new MapParams(Collections.singletonMap(REST_EXCEPTION_SKIP_STACK_TRACE, "false"));
+        String exceptionString;
+        try (XContentBuilder causeXContentBuilder = JsonXContent.contentBuilder()) {
+            causeXContentBuilder.startObject();
+            ElasticsearchException.generateThrowableXContent(causeXContentBuilder, stacktraceParams, exception);
+            causeXContentBuilder.endObject();
+            exceptionString = BytesReference.bytes(causeXContentBuilder).utf8ToString();
+        } catch (IOException e) {
+            // In the unlikely case that we cannot generate an exception string,
+            // try the best way can to encapsulate the error(s) with at least
+            // the message
+            exceptionString = "unable to generate the ILM error details due to: " + e.getMessage() +
+                "; the ILM error was: " + exception.getMessage();
+        }
+        return exceptionString;
+    }
+
+    @Override
+    public String toString() {
+        return Strings.toString(this);
+    }
+}
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStore.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStore.java
new file mode 100644
index 0000000000000..ab8168de4b28d
--- /dev/null
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStore.java
@@ -0,0 +1,189 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ilm.history;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.elasticsearch.ResourceAlreadyExistsException;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.alias.Alias;
+import org.elasticsearch.action.admin.indices.create.CreateIndexResponse;
+import org.elasticsearch.action.bulk.BackoffPolicy;
+import org.elasticsearch.action.bulk.BulkItemResponse;
+import org.elasticsearch.action.bulk.BulkProcessor;
+import org.elasticsearch.action.bulk.BulkRequest;
+import org.elasticsearch.action.bulk.BulkResponse;
+import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.AliasOrIndex;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.ByteSizeUnit;
+import org.elasticsearch.common.unit.ByteSizeValue;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentFactory;
+
+import java.io.Closeable;
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.Map;
+import java.util.concurrent.TimeUnit;
+import java.util.stream.Collectors;
+
+import static org.elasticsearch.xpack.core.ClientHelper.INDEX_LIFECYCLE_ORIGIN;
+import static org.elasticsearch.xpack.core.ilm.LifecycleSettings.LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING;
+import static org.elasticsearch.xpack.ilm.history.ILMHistoryTemplateRegistry.INDEX_TEMPLATE_VERSION;
+
+/**
+ * The {@link ILMHistoryStore} handles indexing {@link ILMHistoryItem} documents into the
+ * appropriate index. It sets up a {@link BulkProcessor} for indexing in bulk, and handles creation
+ * of the index/alias as needed for ILM policies.
+ */
+public class ILMHistoryStore implements Closeable {
+    private static final Logger logger = LogManager.getLogger(ILMHistoryStore.class);
+
+    public static final String ILM_HISTORY_INDEX_PREFIX = "ilm-history-" + INDEX_TEMPLATE_VERSION + "-";
+    public static final String ILM_HISTORY_ALIAS = "ilm-history-" + INDEX_TEMPLATE_VERSION;
+
+    private final Client client;
+    private final ClusterService clusterService;
+    private final boolean ilmHistoryEnabled;
+    private final BulkProcessor processor;
+
+    public ILMHistoryStore(Settings nodeSettings, Client client, ClusterService clusterService) {
+        this.client = client;
+        this.clusterService = clusterService;
+        ilmHistoryEnabled = LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING.get(nodeSettings);
+
+        this.processor = BulkProcessor.builder(
+            new OriginSettingClient(client, INDEX_LIFECYCLE_ORIGIN)::bulk,
+            new BulkProcessor.Listener() {
+                @Override
+                public void beforeBulk(long executionId, BulkRequest request) { }
+
+                @Override
+                public void afterBulk(long executionId, BulkRequest request, BulkResponse response) {
+                    long items = request.numberOfActions();
+                    logger.trace("indexed [{}] items into ILM history index", items);
+                    if (response.hasFailures()) {
+                        Map<String, String> failures = Arrays.stream(response.getItems())
+                            .filter(BulkItemResponse::isFailed)
+                            .collect(Collectors.toMap(BulkItemResponse::getId, BulkItemResponse::getFailureMessage));
+                        logger.error("failures: [{}]", failures);
+                    }
+                }
+
+                @Override
+                public void afterBulk(long executionId, BulkRequest request, Throwable failure) {
+                    long items = request.numberOfActions();
+                    logger.error(new ParameterizedMessage("failed to index {} items into ILM history index", items), failure);
+                }
+            })
+            .setBulkActions(100)
+            .setBulkSize(new ByteSizeValue(5, ByteSizeUnit.MB))
+            .setFlushInterval(TimeValue.timeValueSeconds(5))
+            .setConcurrentRequests(1)
+            .setBackoffPolicy(BackoffPolicy.exponentialBackoff(TimeValue.timeValueMillis(1000), 3))
+            .build();
+    }
+
+    /**
+     * Attempts to asynchronously index an ILM history entry
+     */
+    public void putAsync(ILMHistoryItem item) {
+        if (ilmHistoryEnabled == false) {
+            logger.trace("not recording ILM history item because [{}] is [false]: [{}]",
+                LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING.getKey(), item);
+            return;
+        }
+        logger.trace("about to index ILM history item in index [{}]: [{}]", ILM_HISTORY_ALIAS, item);
+        ensureHistoryIndex(client, clusterService.state(), ActionListener.wrap(createdIndex -> {
+            try (XContentBuilder builder = XContentFactory.jsonBuilder()) {
+                item.toXContent(builder, ToXContent.EMPTY_PARAMS);
+                IndexRequest request = new IndexRequest(ILM_HISTORY_ALIAS).source(builder);
+                processor.add(request);
+            } catch (IOException exception) {
+                logger.error(new ParameterizedMessage("failed to index ILM history item in index [{}]: [{}]",
+                    ILM_HISTORY_ALIAS, item), exception);
+            }
+        }, ex -> logger.error(new ParameterizedMessage("failed to ensure ILM history index exists, not indexing history item [{}]",
+            item), ex)));
+    }
+
+    /**
+     * Checks if the ILM history index exists, and if not, creates it.
+     *
+     * @param client  The client to use to create the index if needed
+     * @param state   The current cluster state, to determine if the alias exists
+     * @param listener Called after the index has been created. `onResponse` called with `true` if the index was created,
+     *                `false` if it already existed.
+     */
+    static void ensureHistoryIndex(Client client, ClusterState state, ActionListener<Boolean> listener) {
+        final String initialHistoryIndexName = ILM_HISTORY_INDEX_PREFIX + "000001";
+        final AliasOrIndex ilmHistory = state.metaData().getAliasAndIndexLookup().get(ILM_HISTORY_ALIAS);
+        final AliasOrIndex initialHistoryIndex = state.metaData().getAliasAndIndexLookup().get(initialHistoryIndexName);
+
+        if (ilmHistory == null && initialHistoryIndex == null) {
+            // No alias or index exists with the expected names, so create the index with appropriate alias
+            client.admin().indices().prepareCreate(initialHistoryIndexName)
+                .setWaitForActiveShards(1)
+                .addAlias(new Alias(ILM_HISTORY_ALIAS)
+                    .writeIndex(true))
+                .execute(new ActionListener<CreateIndexResponse>() {
+                    @Override
+                    public void onResponse(CreateIndexResponse response) {
+                        listener.onResponse(true);
+                    }
+
+                    @Override
+                    public void onFailure(Exception e) {
+                        if (e instanceof ResourceAlreadyExistsException) {
+                            // The index didn't exist before we made the call, there was probably a race - just ignore this
+                            logger.debug("index [{}] was created after checking for its existence, likely due to a concurrent call",
+                                initialHistoryIndexName);
+                            listener.onResponse(false);
+                        } else {
+                            listener.onFailure(e);
+                        }
+                    }
+                });
+        } else if (ilmHistory == null) {
+            // alias does not exist but initial index does, something is broken
+            listener.onFailure(new IllegalStateException("ILM history index [" + initialHistoryIndexName +
+                "] already exists but does not have alias [" + ILM_HISTORY_ALIAS + "]"));
+        } else if (ilmHistory.isAlias() && ilmHistory instanceof AliasOrIndex.Alias) {
+            if (((AliasOrIndex.Alias) ilmHistory).getWriteIndex() != null) {
+                // The alias exists and has a write index, so we're good
+                listener.onResponse(false);
+            } else {
+                // The alias does not have a write index, so we can't index into it
+                listener.onFailure(new IllegalStateException("ILM history alias [" + ILM_HISTORY_ALIAS + "does not have a write index"));
+            }
+        } else if (ilmHistory.isAlias() == false) {
+            // This is not an alias, error out
+            listener.onFailure(new IllegalStateException("ILM history alias [" + ILM_HISTORY_ALIAS +
+                "] already exists as concrete index"));
+        } else {
+            logger.error("unexpected IndexOrAlias for [{}]: [{}]", ILM_HISTORY_ALIAS, ilmHistory);
+            assert false : ILM_HISTORY_ALIAS + " cannot be both an alias and not an alias simultaneously";
+        }
+    }
+
+    @Override
+    public void close() {
+        try {
+            processor.awaitClose(10, TimeUnit.SECONDS);
+        } catch (InterruptedException e) {
+            logger.warn("failed to shut down ILM history bulk processor after 10 seconds", e);
+        }
+    }
+}
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryTemplateRegistry.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryTemplateRegistry.java
new file mode 100644
index 0000000000000..21b2d16afdc83
--- /dev/null
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryTemplateRegistry.java
@@ -0,0 +1,80 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ilm.history;
+
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.core.ClientHelper;
+import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
+import org.elasticsearch.xpack.core.template.IndexTemplateConfig;
+import org.elasticsearch.xpack.core.template.IndexTemplateRegistry;
+import org.elasticsearch.xpack.core.template.LifecyclePolicyConfig;
+
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * The {@link ILMHistoryTemplateRegistry} class sets up and configures an ILM policy and index
+ * template for the ILM history indices (ilm-history-N-00000M).
+ */
+public class ILMHistoryTemplateRegistry extends IndexTemplateRegistry {
+    // history (please add a comment why you increased the version here)
+    // version 1: initial
+    public static final String INDEX_TEMPLATE_VERSION = "1";
+
+    public static final String ILM_TEMPLATE_VERSION_VARIABLE = "xpack.ilm_history.template.version";
+    public static final String ILM_TEMPLATE_NAME = "ilm-history";
+
+    public static final String ILM_POLICY_NAME = "ilm-history-ilm-policy";
+
+    public static final IndexTemplateConfig TEMPLATE_ILM_HISTORY = new IndexTemplateConfig(
+        ILM_TEMPLATE_NAME,
+        "/ilm-history.json",
+        INDEX_TEMPLATE_VERSION,
+        ILM_TEMPLATE_VERSION_VARIABLE
+    );
+
+    public static final LifecyclePolicyConfig ILM_HISTORY_POLICY = new LifecyclePolicyConfig(
+        ILM_POLICY_NAME,
+        "/ilm-history-ilm-policy.json"
+    );
+
+    private final boolean ilmHistoryEnabled;
+
+    public ILMHistoryTemplateRegistry(Settings nodeSettings, ClusterService clusterService,
+                                      ThreadPool threadPool, Client client,
+                                      NamedXContentRegistry xContentRegistry) {
+        super(nodeSettings, clusterService, threadPool, client, xContentRegistry);
+        this.ilmHistoryEnabled = LifecycleSettings.LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING.get(nodeSettings);
+    }
+
+    @Override
+    protected List<IndexTemplateConfig> getTemplateConfigs() {
+        if (this.ilmHistoryEnabled) {
+            return Collections.singletonList(TEMPLATE_ILM_HISTORY);
+        } else {
+            return Collections.emptyList();
+        }
+    }
+
+    @Override
+    protected List<LifecyclePolicyConfig> getPolicyConfigs() {
+        if (this.ilmHistoryEnabled) {
+            return Collections.singletonList(ILM_HISTORY_POLICY);
+        } else {
+            return Collections.emptyList();
+        }
+    }
+
+    @Override
+    protected String getOrigin() {
+        return ClientHelper.INDEX_LIFECYCLE_ORIGIN;
+    }
+}
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleInitialisationTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleInitialisationTests.java
index b49d0870bdaa3..22f40913997a3 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleInitialisationTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleInitialisationTests.java
@@ -106,7 +106,8 @@ protected Settings nodeSettings(int nodeOrdinal) {
         settings.put(XPackSettings.LOGSTASH_ENABLED.getKey(), false);
         settings.put(LifecycleSettings.LIFECYCLE_POLL_INTERVAL, "1s");
 
-        // This is necessary to prevent SLM installing a lifecycle policy, these tests assume a blank slate
+        // This is necessary to prevent ILM and SLM installing a lifecycle policy, these tests assume a blank slate
+        settings.put(LifecycleSettings.LIFECYCLE_HISTORY_INDEX_ENABLED, false);
         settings.put(LifecycleSettings.SLM_HISTORY_INDEX_ENABLED_SETTING.getKey(), false);
         return settings.build();
     }
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
index 2580e2970e521..130a77cf853dd 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
@@ -55,6 +55,8 @@
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
 import org.elasticsearch.xpack.core.ilm.WaitForRolloverReadyStep;
+import org.elasticsearch.xpack.ilm.history.ILMHistoryItem;
+import org.elasticsearch.xpack.ilm.history.ILMHistoryStore;
 import org.junit.After;
 import org.junit.Before;
 import org.mockito.ArgumentMatcher;
@@ -91,6 +93,8 @@
 public class IndexLifecycleRunnerTests extends ESTestCase {
     private static final NamedXContentRegistry REGISTRY;
     private ThreadPool threadPool;
+    private Client noopClient;
+    private NoOpHistoryStore historyStore;
 
     static {
         try (IndexLifecycle indexLifecycle = new IndexLifecycle(Settings.EMPTY)) {
@@ -100,12 +104,16 @@ public class IndexLifecycleRunnerTests extends ESTestCase {
     }
 
     @Before
-    public void prepareThreadPool() {
+    public void prepare() {
         threadPool = new TestThreadPool("test");
+        noopClient = new NoOpClient(threadPool);
+        historyStore = new NoOpHistoryStore();
     }
 
     @After
     public void shutdown() {
+        historyStore.close();
+        noopClient.close();
         threadPool.shutdownNow();
     }
 
@@ -114,7 +122,7 @@ public void testRunPolicyTerminalPolicyStep() {
         TerminalPolicyStep step = TerminalPolicyStep.INSTANCE;
         PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
         ClusterService clusterService = mock(ClusterService.class);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
         IndexMetaData indexMetaData = IndexMetaData.builder("my_index").settings(settings(Version.CURRENT))
             .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
 
@@ -136,7 +144,7 @@ public void testRunPolicyErrorStep() {
 
         PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
         ClusterService clusterService = mock(ClusterService.class);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
         LifecycleExecutionState.Builder newState = LifecycleExecutionState.builder();
         newState.setFailedStep(stepKey.getName());
         newState.setIsAutoRetryableError(false);
@@ -176,7 +184,7 @@ public void testRunPolicyErrorStepOnRetryableFailedStep() {
 
         PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, waitForRolloverStep);
         ClusterService clusterService = mock(ClusterService.class);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
         LifecycleExecutionState.Builder newState = LifecycleExecutionState.builder();
         newState.setFailedStep(stepKey.getName());
         newState.setIsAutoRetryableError(true);
@@ -221,7 +229,7 @@ public void testRunStateChangePolicyWithNoNextStep() throws Exception {
                 .localNodeId(node.getId()))
             .build();
         ClusterServiceUtils.setState(clusterService, state);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
 
         ClusterState before = clusterService.state();
         CountDownLatch latch = new CountDownLatch(1);
@@ -282,7 +290,8 @@ public void testRunStateChangePolicyWithNextStep() throws Exception {
             .build();
         ClusterServiceUtils.setState(clusterService, state);
         long stepTime = randomLong();
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> stepTime);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore,
+            clusterService, threadPool, () -> stepTime);
 
         ClusterState before = clusterService.state();
         CountDownLatch latch = new CountDownLatch(1);
@@ -303,6 +312,14 @@ public void testRunStateChangePolicyWithNextStep() throws Exception {
         assertThat(nextStep.getExecuteCount(), equalTo(1L));
         clusterService.close();
         threadPool.shutdownNow();
+
+        ILMHistoryItem historyItem = historyStore.getItems().stream()
+            .findFirst()
+            .orElseThrow(() -> new AssertionError("failed to register ILM history"));
+        assertThat(historyItem.toString(),
+            containsString("{\"index\":\"test\",\"policy\":\"foo\",\"@timestamp\":" + stepTime +
+                ",\"success\":true,\"state\":{\"phase\":\"phase\",\"action\":\"action\"," +
+                "\"step\":\"next_cluster_state_action_step\",\"step_time\":\"" + stepTime + "\"}}"));
     }
 
     public void testRunPeriodicPolicyWithFailureToReadPolicy() throws Exception {
@@ -357,7 +374,8 @@ public void doTestRunPolicyWithFailureToReadPolicy(boolean asyncAction, boolean
             .build();
         ClusterServiceUtils.setState(clusterService, state);
         long stepTime = randomLong();
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> stepTime);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore,
+            clusterService, threadPool, () -> stepTime);
 
         ClusterState before = clusterService.state();
         if (asyncAction) {
@@ -409,7 +427,7 @@ public void testRunAsyncActionDoesNotRun() {
                 .localNodeId(node.getId()))
             .build();
         ClusterServiceUtils.setState(clusterService, state);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
 
         ClusterState before = clusterService.state();
         // State changes should not run AsyncAction steps
@@ -468,7 +486,7 @@ public void testRunStateChangePolicyWithAsyncActionNextStep() throws Exception {
             .build();
         logger.info("--> state: {}", state);
         ClusterServiceUtils.setState(clusterService, state);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
 
         ClusterState before = clusterService.state();
         CountDownLatch latch = new CountDownLatch(1);
@@ -488,6 +506,13 @@ public void testRunStateChangePolicyWithAsyncActionNextStep() throws Exception {
         assertThat(nextStep.getExecuteCount(), equalTo(1L));
         clusterService.close();
         threadPool.shutdownNow();
+
+        ILMHistoryItem historyItem = historyStore.getItems().stream()
+            .findFirst()
+            .orElseThrow(() -> new AssertionError("failed to register ILM history"));
+        assertThat(historyItem.toString(),
+            containsString("{\"index\":\"test\",\"policy\":\"foo\",\"@timestamp\":0,\"success\":true," +
+                "\"state\":{\"phase\":\"phase\",\"action\":\"action\",\"step\":\"async_action_step\",\"step_time\":\"0\"}}"));
     }
 
     public void testRunPeriodicStep() throws Exception {
@@ -535,7 +560,7 @@ public void testRunPeriodicStep() throws Exception {
             .build();
         logger.info("--> state: {}", state);
         ClusterServiceUtils.setState(clusterService, state);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
 
         ClusterState before = clusterService.state();
         CountDownLatch latch = new CountDownLatch(1);
@@ -558,7 +583,7 @@ public void testRunPolicyClusterStateActionStep() {
         MockClusterStateActionStep step = new MockClusterStateActionStep(stepKey, null);
         PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
         ClusterService clusterService = mock(ClusterService.class);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
         IndexMetaData indexMetaData = IndexMetaData.builder("my_index").settings(settings(Version.CURRENT))
             .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
 
@@ -576,7 +601,7 @@ public void testRunPolicyClusterStateWaitStep() {
         step.setWillComplete(true);
         PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
         ClusterService clusterService = mock(ClusterService.class);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
         IndexMetaData indexMetaData = IndexMetaData.builder("my_index").settings(settings(Version.CURRENT))
             .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
 
@@ -595,7 +620,7 @@ public void testRunPolicyAsyncActionStepClusterStateChangeIgnored() {
         step.setException(expectedException);
         PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
         ClusterService clusterService = mock(ClusterService.class);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
         IndexMetaData indexMetaData = IndexMetaData.builder("my_index").settings(settings(Version.CURRENT))
             .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
 
@@ -613,7 +638,7 @@ public void testRunPolicyAsyncWaitStepClusterStateChangeIgnored() {
         step.setException(expectedException);
         PolicyStepsRegistry stepRegistry = createOneStepPolicyStepRegistry(policyName, step);
         ClusterService clusterService = mock(ClusterService.class);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, clusterService, threadPool, () -> 0L);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(stepRegistry, historyStore, clusterService, threadPool, () -> 0L);
         IndexMetaData indexMetaData = IndexMetaData.builder("my_index").settings(settings(Version.CURRENT))
             .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
 
@@ -627,7 +652,7 @@ public void testRunPolicyThatDoesntExist() {
         String policyName = "cluster_state_action_policy";
         ClusterService clusterService = mock(ClusterService.class);
         IndexLifecycleRunner runner = new IndexLifecycleRunner(new PolicyStepsRegistry(NamedXContentRegistry.EMPTY, null),
-            clusterService, threadPool, () -> 0L);
+            historyStore, clusterService, threadPool, () -> 0L);
         IndexMetaData indexMetaData = IndexMetaData.builder("my_index").settings(settings(Version.CURRENT))
             .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
         // verify that no exception is thrown
@@ -712,7 +737,8 @@ public void testIsReadyToTransition() {
             stepMap, NamedXContentRegistry.EMPTY, null);
         ClusterService clusterService = mock(ClusterService.class);
         final AtomicLong now = new AtomicLong(5);
-        IndexLifecycleRunner runner = new IndexLifecycleRunner(policyStepsRegistry, clusterService, threadPool, now::get);
+        IndexLifecycleRunner runner = new IndexLifecycleRunner(policyStepsRegistry, historyStore,
+            clusterService, threadPool, now::get);
         IndexMetaData indexMetaData = IndexMetaData.builder("my_index").settings(settings(Version.CURRENT))
             .numberOfShards(randomIntBetween(1, 5))
             .numberOfReplicas(randomIntBetween(0, 5))
@@ -1086,4 +1112,23 @@ public static MockPolicyStepsRegistry createMultiStepPolicyStepRegistry(String p
         when(client.settings()).thenReturn(Settings.EMPTY);
         return new MockPolicyStepsRegistry(lifecyclePolicyMap, firstStepMap, stepMap, REGISTRY, client);
     }
+
+    private class NoOpHistoryStore extends ILMHistoryStore {
+
+        private final List<ILMHistoryItem> items = new ArrayList<>();
+
+        NoOpHistoryStore() {
+            super(Settings.EMPTY, noopClient, null);
+        }
+
+        public List<ILMHistoryItem> getItems() {
+            return items;
+        }
+
+        @Override
+        public void putAsync(ILMHistoryItem item) {
+            logger.info("--> adding ILM history item: [{}]", item);
+            items.add(item);
+        }
+    }
 }
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleServiceTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleServiceTests.java
index a7f15419d3718..2bf054d318fb5 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleServiceTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleServiceTests.java
@@ -108,7 +108,7 @@ public void prepareServices() {
 
         threadPool = new TestThreadPool("test");
         indexLifecycleService = new IndexLifecycleService(Settings.EMPTY, client, clusterService, threadPool,
-            clock, () -> now, null);
+            clock, () -> now, null, null);
         Mockito.verify(clusterService).addListener(indexLifecycleService);
         Mockito.verify(clusterService).addStateApplier(indexLifecycleService);
     }
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTaskTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTaskTests.java
index fa2a626b0f9bc..39b3fca46c1f1 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTaskTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/MoveToErrorStepUpdateTaskTests.java
@@ -75,7 +75,7 @@ public void testExecuteSuccessfullyMoved() throws IOException {
         setStateToKey(currentStepKey);
 
         MoveToErrorStepUpdateTask task = new MoveToErrorStepUpdateTask(index, policy, currentStepKey, cause, () -> now,
-            (idxMeta, stepKey) -> new MockStep(stepKey, nextStepKey));
+            (idxMeta, stepKey) -> new MockStep(stepKey, nextStepKey), state -> {});
         ClusterState newState = task.execute(clusterState);
         LifecycleExecutionState lifecycleState = LifecycleExecutionState.fromIndexMetadata(newState.getMetaData().index(index));
         StepKey actualKey = LifecycleExecutionState.getCurrentStepKey(lifecycleState);
@@ -101,7 +101,7 @@ public void testExecuteNoopDifferentStep() throws IOException {
         Exception cause = new ElasticsearchException("THIS IS AN EXPECTED CAUSE");
         setStateToKey(notCurrentStepKey);
         MoveToErrorStepUpdateTask task = new MoveToErrorStepUpdateTask(index, policy, currentStepKey, cause, () -> now,
-            (idxMeta, stepKey) -> new MockStep(stepKey, new StepKey("next-phase", "action", "step")));
+            (idxMeta, stepKey) -> new MockStep(stepKey, new StepKey("next-phase", "action", "step")), state -> {});
         ClusterState newState = task.execute(clusterState);
         assertThat(newState, sameInstance(clusterState));
     }
@@ -113,7 +113,7 @@ public void testExecuteNoopDifferentPolicy() throws IOException {
         setStateToKey(currentStepKey);
         setStatePolicy("not-" + policy);
         MoveToErrorStepUpdateTask task = new MoveToErrorStepUpdateTask(index, policy, currentStepKey, cause, () -> now,
-            (idxMeta, stepKey) -> new MockStep(stepKey, new StepKey("next-phase", "action", "step")));
+            (idxMeta, stepKey) -> new MockStep(stepKey, new StepKey("next-phase", "action", "step")), state -> {});
         ClusterState newState = task.execute(clusterState);
         assertThat(newState, sameInstance(clusterState));
     }
@@ -126,7 +126,7 @@ public void testOnFailure() {
         setStateToKey(currentStepKey);
 
         MoveToErrorStepUpdateTask task = new MoveToErrorStepUpdateTask(index, policy, currentStepKey, cause, () -> now,
-            (idxMeta, stepKey) -> new MockStep(stepKey, new StepKey("next-phase", "action", "step")));
+            (idxMeta, stepKey) -> new MockStep(stepKey, new StepKey("next-phase", "action", "step")), state -> {});
         Exception expectedException = new RuntimeException();
         ElasticsearchException exception = expectThrows(ElasticsearchException.class,
                 () -> task.onFailure(randomAlphaOfLength(10), expectedException));
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryItemTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryItemTests.java
new file mode 100644
index 0000000000000..2e3f76c6370e7
--- /dev/null
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryItemTests.java
@@ -0,0 +1,92 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ilm.history;
+
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
+
+import java.io.IOException;
+
+import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.startsWith;
+
+public class ILMHistoryItemTests extends ESTestCase {
+
+    public void testToXContent() throws IOException {
+        ILMHistoryItem success = ILMHistoryItem.success("index", "policy", 1234L, 100L,
+            LifecycleExecutionState.builder()
+                .setPhase("phase")
+                .setAction("action")
+                .setStep("step")
+                .setPhaseTime(10L)
+                .setActionTime(20L)
+                .setStepTime(30L)
+                .setPhaseDefinition("{}")
+                .setStepInfo("{\"step_info\": \"foo\"")
+                .build());
+
+        ILMHistoryItem failure = ILMHistoryItem.failure("index", "policy", 1234L, 100L,
+            LifecycleExecutionState.builder()
+                .setPhase("phase")
+                .setAction("action")
+                .setStep("ERROR")
+                .setFailedStep("step")
+                .setFailedStepRetryCount(7)
+                .setIsAutoRetryableError(true)
+                .setPhaseTime(10L)
+                .setActionTime(20L)
+                .setStepTime(30L)
+                .setPhaseDefinition("{\"phase_json\": \"eggplant\"}")
+                .setStepInfo("{\"step_info\": \"foo\"")
+                .build(),
+            new IllegalArgumentException("failure"));
+
+        try (XContentBuilder builder = jsonBuilder()) {
+            success.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            String json = Strings.toString(builder);
+            assertThat(json, equalTo("{\"index\":\"index\"," +
+                "\"policy\":\"policy\"," +
+                "\"@timestamp\":1234," +
+                "\"index_age\":100," +
+                "\"success\":true," +
+                "\"state\":{\"phase\":\"phase\"," +
+                "\"phase_definition\":\"{}\"," +
+                "\"action_time\":\"20\"," +
+                "\"phase_time\":\"10\"," +
+                "\"step_info\":\"{\\\"step_info\\\": \\\"foo\\\"\",\"action\":\"action\",\"step\":\"step\",\"step_time\":\"30\"}}"
+            ));
+        }
+
+        try (XContentBuilder builder = jsonBuilder()) {
+            failure.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            String json = Strings.toString(builder);
+            assertThat(json, startsWith("{\"index\":\"index\"," +
+                "\"policy\":\"policy\"," +
+                "\"@timestamp\":1234," +
+                "\"index_age\":100," +
+                "\"success\":false," +
+                "\"state\":{\"phase\":\"phase\"," +
+                "\"failed_step\":\"step\"," +
+                "\"phase_definition\":\"{\\\"phase_json\\\": \\\"eggplant\\\"}\"," +
+                "\"action_time\":\"20\"," +
+                "\"is_auto_retryable_error\":\"true\"," +
+                "\"failed_step_retry_count\":\"7\"," +
+                "\"phase_time\":\"10\"," +
+                "\"step_info\":\"{\\\"step_info\\\": \\\"foo\\\"\"," +
+                "\"action\":\"action\"," +
+                "\"step\":\"ERROR\"," +
+                "\"step_time\":\"30\"}," +
+                "\"error_details\":\"{\\\"type\\\":\\\"illegal_argument_exception\\\"," +
+                "\\\"reason\\\":\\\"failure\\\"," +
+                "\\\"stack_trace\\\":\\\"java.lang.IllegalArgumentException: failure"));
+        }
+    }
+}
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStoreTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStoreTests.java
new file mode 100644
index 0000000000000..3e6b9a638737c
--- /dev/null
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStoreTests.java
@@ -0,0 +1,398 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ilm.history;
+
+import org.elasticsearch.ResourceAlreadyExistsException;
+import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.ActionRequest;
+import org.elasticsearch.action.ActionResponse;
+import org.elasticsearch.action.ActionType;
+import org.elasticsearch.action.DocWriteRequest;
+import org.elasticsearch.action.LatchedActionListener;
+import org.elasticsearch.action.admin.indices.create.CreateIndexAction;
+import org.elasticsearch.action.admin.indices.create.CreateIndexRequest;
+import org.elasticsearch.action.admin.indices.create.CreateIndexResponse;
+import org.elasticsearch.action.bulk.BulkAction;
+import org.elasticsearch.action.bulk.BulkItemResponse;
+import org.elasticsearch.action.bulk.BulkRequest;
+import org.elasticsearch.action.bulk.BulkResponse;
+import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.action.index.IndexResponse;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.AliasMetaData;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.TriFunction;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.shard.ShardId;
+import org.elasticsearch.test.ClusterServiceUtils;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.client.NoOpClient;
+import org.elasticsearch.test.hamcrest.ElasticsearchAssertions;
+import org.elasticsearch.threadpool.TestThreadPool;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
+import org.hamcrest.Matchers;
+import org.junit.After;
+import org.junit.Assert;
+import org.junit.Before;
+
+import java.util.Map;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicInteger;
+import java.util.stream.IntStream;
+
+import static org.elasticsearch.xpack.core.ilm.LifecycleSettings.LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING;
+import static org.elasticsearch.xpack.ilm.history.ILMHistoryStore.ILM_HISTORY_ALIAS;
+import static org.elasticsearch.xpack.ilm.history.ILMHistoryStore.ILM_HISTORY_INDEX_PREFIX;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.instanceOf;
+
+public class ILMHistoryStoreTests extends ESTestCase {
+
+    private ThreadPool threadPool;
+    private VerifyingClient client;
+    private ClusterService clusterService;
+    private ILMHistoryStore historyStore;
+
+    @Before
+    public void setup() {
+        threadPool = new TestThreadPool(this.getClass().getName());
+        client = new VerifyingClient(threadPool);
+        clusterService = ClusterServiceUtils.createClusterService(threadPool);
+        historyStore = new ILMHistoryStore(Settings.EMPTY, client, clusterService);
+    }
+
+    @After
+    public void setdown() {
+        historyStore.close();
+        clusterService.close();
+        client.close();
+        threadPool.shutdownNow();
+    }
+
+    public void testNoActionIfDisabled() throws Exception {
+        Settings settings = Settings.builder().put(LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING.getKey(), false).build();
+        try (ILMHistoryStore disabledHistoryStore = new ILMHistoryStore(settings, client, null)) {
+            String policyId = randomAlphaOfLength(5);
+            final long timestamp = randomNonNegativeLong();
+            ILMHistoryItem record = ILMHistoryItem.success("index", policyId, timestamp, null, null);
+
+            CountDownLatch latch = new CountDownLatch(1);
+            client.setVerifier((a, r, l) -> {
+                fail("the history store is disabled, no action should have been taken");
+                latch.countDown();
+                return null;
+            });
+            disabledHistoryStore.putAsync(record);
+            latch.await(10, TimeUnit.SECONDS);
+        }
+    }
+
+    @SuppressWarnings("unchecked")
+    public void testPut() throws Exception {
+        String policyId = randomAlphaOfLength(5);
+        final long timestamp = randomNonNegativeLong();
+        {
+            ILMHistoryItem record = ILMHistoryItem.success("index", policyId, timestamp, 10L,
+                LifecycleExecutionState.builder()
+                    .setPhase("phase")
+                    .build());
+
+            AtomicInteger calledTimes = new AtomicInteger(0);
+            client.setVerifier((action, request, listener) -> {
+                if (action instanceof CreateIndexAction && request instanceof CreateIndexRequest) {
+                    return new CreateIndexResponse(true, true, ((CreateIndexRequest) request).index());
+                }
+                calledTimes.incrementAndGet();
+                assertThat(action, instanceOf(BulkAction.class));
+                assertThat(request, instanceOf(BulkRequest.class));
+                BulkRequest bulkRequest = (BulkRequest) request;
+                bulkRequest.requests().forEach(dwr -> assertEquals(ILM_HISTORY_ALIAS, dwr.index()));
+                assertNotNull(listener);
+
+                // The content of this BulkResponse doesn't matter, so just make it have the same number of responses
+                int responses = bulkRequest.numberOfActions();
+                return new BulkResponse(IntStream.range(0, responses)
+                    .mapToObj(i -> new BulkItemResponse(i, DocWriteRequest.OpType.INDEX,
+                        new IndexResponse(new ShardId("index", "uuid", 0), randomAlphaOfLength(10), 1, 1, 1, true)))
+                    .toArray(BulkItemResponse[]::new),
+                    1000L);
+            });
+
+            historyStore.putAsync(record);
+            assertBusy(() -> assertThat(calledTimes.get(), equalTo(1)));
+        }
+
+        {
+            final String cause = randomAlphaOfLength(9);
+            Exception failureException = new RuntimeException(cause);
+            ILMHistoryItem record = ILMHistoryItem.failure("index", policyId, timestamp, 10L,
+                LifecycleExecutionState.builder()
+                    .setPhase("phase")
+                    .build(), failureException);
+
+            AtomicInteger calledTimes = new AtomicInteger(0);
+            client.setVerifier((action, request, listener) -> {
+                if (action instanceof CreateIndexAction && request instanceof CreateIndexRequest) {
+                    return new CreateIndexResponse(true, true, ((CreateIndexRequest) request).index());
+                }
+                calledTimes.incrementAndGet();
+                assertThat(action, instanceOf(BulkAction.class));
+                assertThat(request, instanceOf(BulkRequest.class));
+                BulkRequest bulkRequest = (BulkRequest) request;
+                bulkRequest.requests().forEach(dwr -> {
+                    assertEquals(ILM_HISTORY_ALIAS, dwr.index());
+                    assertThat(dwr, instanceOf(IndexRequest.class));
+                    IndexRequest ir = (IndexRequest) dwr;
+                    String indexedDocument = ir.source().utf8ToString();
+                    assertThat(indexedDocument, Matchers.containsString("runtime_exception"));
+                    assertThat(indexedDocument, Matchers.containsString(cause));
+                });
+                assertNotNull(listener);
+
+                // The content of this BulkResponse doesn't matter, so just make it have the same number of responses with failures
+                int responses = bulkRequest.numberOfActions();
+                return new BulkResponse(IntStream.range(0, responses)
+                    .mapToObj(i -> new BulkItemResponse(i, DocWriteRequest.OpType.INDEX,
+                        new BulkItemResponse.Failure("index", i + "", failureException)))
+                    .toArray(BulkItemResponse[]::new),
+                    1000L);
+            });
+
+            historyStore.putAsync(record);
+            assertBusy(() -> assertThat(calledTimes.get(), equalTo(1)));
+        }
+    }
+
+    public void testHistoryIndexNeedsCreation() throws InterruptedException {
+        ClusterState state = ClusterState.builder(new ClusterName(randomAlphaOfLength(5)))
+            .metaData(MetaData.builder())
+            .build();
+
+        client.setVerifier((a, r, l) -> {
+            assertThat(a, instanceOf(CreateIndexAction.class));
+            assertThat(r, instanceOf(CreateIndexRequest.class));
+            CreateIndexRequest request = (CreateIndexRequest) r;
+            assertThat(request.aliases(), Matchers.hasSize(1));
+            request.aliases().forEach(alias -> {
+                assertThat(alias.name(), equalTo(ILM_HISTORY_ALIAS));
+                assertTrue(alias.writeIndex());
+            });
+            return new CreateIndexResponse(true, true, request.index());
+        });
+
+        CountDownLatch latch = new CountDownLatch(1);
+        ILMHistoryStore.ensureHistoryIndex(client, state, new LatchedActionListener<>(ActionListener.wrap(
+            Assert::assertTrue,
+            ex -> {
+                logger.error(ex);
+                fail("should have called onResponse, not onFailure");
+            }), latch));
+
+        ElasticsearchAssertions.awaitLatch(latch, 10, TimeUnit.SECONDS);
+    }
+
+    public void testHistoryIndexProperlyExistsAlready() throws InterruptedException {
+        ClusterState state = ClusterState.builder(new ClusterName(randomAlphaOfLength(5)))
+            .metaData(MetaData.builder()
+                .put(IndexMetaData.builder(ILM_HISTORY_INDEX_PREFIX + "000001")
+                    .settings(Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT))
+                    .numberOfShards(randomIntBetween(1,10))
+                    .numberOfReplicas(randomIntBetween(1,10))
+                    .putAlias(AliasMetaData.builder(ILM_HISTORY_ALIAS)
+                        .writeIndex(true)
+                        .build())))
+            .build();
+
+        client.setVerifier((a, r, l) -> {
+            fail("no client calls should have been made");
+            return null;
+        });
+
+        CountDownLatch latch = new CountDownLatch(1);
+        ILMHistoryStore.ensureHistoryIndex(client, state, new LatchedActionListener<>(ActionListener.wrap(
+            Assert::assertFalse,
+            ex -> {
+                logger.error(ex);
+                fail("should have called onResponse, not onFailure");
+            }), latch));
+
+        ElasticsearchAssertions.awaitLatch(latch, 10, TimeUnit.SECONDS);
+    }
+
+    public void testHistoryIndexHasNoWriteIndex() throws InterruptedException {
+        ClusterState state = ClusterState.builder(new ClusterName(randomAlphaOfLength(5)))
+            .metaData(MetaData.builder()
+                .put(IndexMetaData.builder(ILM_HISTORY_INDEX_PREFIX + "000001")
+                    .settings(Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT))
+                    .numberOfShards(randomIntBetween(1,10))
+                    .numberOfReplicas(randomIntBetween(1,10))
+                    .putAlias(AliasMetaData.builder(ILM_HISTORY_ALIAS)
+                        .build()))
+                .put(IndexMetaData.builder(randomAlphaOfLength(5))
+                    .settings(Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT))
+                    .numberOfShards(randomIntBetween(1,10))
+                    .numberOfReplicas(randomIntBetween(1,10))
+                    .putAlias(AliasMetaData.builder(ILM_HISTORY_ALIAS)
+                        .build())))
+            .build();
+
+        client.setVerifier((a, r, l) -> {
+            fail("no client calls should have been made");
+            return null;
+        });
+
+        CountDownLatch latch = new CountDownLatch(1);
+        ILMHistoryStore.ensureHistoryIndex(client, state, new LatchedActionListener<>(ActionListener.wrap(
+            indexCreated -> fail("should have called onFailure, not onResponse"),
+            ex -> {
+                assertThat(ex, instanceOf(IllegalStateException.class));
+                assertThat(ex.getMessage(), Matchers.containsString("ILM history alias [" + ILM_HISTORY_ALIAS +
+                    "does not have a write index"));
+            }), latch));
+
+        ElasticsearchAssertions.awaitLatch(latch, 10, TimeUnit.SECONDS);
+    }
+
+    public void testHistoryIndexNotAlias() throws InterruptedException {
+        ClusterState state = ClusterState.builder(new ClusterName(randomAlphaOfLength(5)))
+            .metaData(MetaData.builder()
+                .put(IndexMetaData.builder(ILM_HISTORY_ALIAS)
+                    .settings(Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT))
+                    .numberOfShards(randomIntBetween(1,10))
+                    .numberOfReplicas(randomIntBetween(1,10))))
+            .build();
+
+        client.setVerifier((a, r, l) -> {
+            fail("no client calls should have been made");
+            return null;
+        });
+
+        CountDownLatch latch = new CountDownLatch(1);
+        ILMHistoryStore.ensureHistoryIndex(client, state, new LatchedActionListener<>(ActionListener.wrap(
+            indexCreated -> fail("should have called onFailure, not onResponse"),
+            ex -> {
+                assertThat(ex, instanceOf(IllegalStateException.class));
+                assertThat(ex.getMessage(), Matchers.containsString("ILM history alias [" + ILM_HISTORY_ALIAS +
+                    "] already exists as concrete index"));
+            }), latch));
+
+        ElasticsearchAssertions.awaitLatch(latch, 10, TimeUnit.SECONDS);
+    }
+
+    public void testHistoryIndexCreatedConcurrently() throws InterruptedException {
+        ClusterState state = ClusterState.builder(new ClusterName(randomAlphaOfLength(5)))
+            .metaData(MetaData.builder())
+            .build();
+
+        client.setVerifier((a, r, l) -> {
+            assertThat(a, instanceOf(CreateIndexAction.class));
+            assertThat(r, instanceOf(CreateIndexRequest.class));
+            CreateIndexRequest request = (CreateIndexRequest) r;
+            assertThat(request.aliases(), Matchers.hasSize(1));
+            request.aliases().forEach(alias -> {
+                assertThat(alias.name(), equalTo(ILM_HISTORY_ALIAS));
+                assertTrue(alias.writeIndex());
+            });
+            throw new ResourceAlreadyExistsException("that index already exists");
+        });
+
+        CountDownLatch latch = new CountDownLatch(1);
+        ILMHistoryStore.ensureHistoryIndex(client, state, new LatchedActionListener<>(ActionListener.wrap(
+            Assert::assertFalse,
+            ex -> {
+                logger.error(ex);
+                fail("should have called onResponse, not onFailure");
+            }), latch));
+
+        ElasticsearchAssertions.awaitLatch(latch, 10, TimeUnit.SECONDS);
+    }
+
+    public void testHistoryAliasDoesntExistButIndexDoes() throws InterruptedException {
+        final String initialIndex = ILM_HISTORY_INDEX_PREFIX + "000001";
+        ClusterState state = ClusterState.builder(new ClusterName(randomAlphaOfLength(5)))
+            .metaData(MetaData.builder()
+                .put(IndexMetaData.builder(initialIndex)
+                    .settings(Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT))
+                    .numberOfShards(randomIntBetween(1,10))
+                    .numberOfReplicas(randomIntBetween(1,10))))
+            .build();
+
+        client.setVerifier((a, r, l) -> {
+            fail("no client calls should have been made");
+            return null;
+        });
+
+        CountDownLatch latch = new CountDownLatch(1);
+        ILMHistoryStore.ensureHistoryIndex(client, state, new LatchedActionListener<>(ActionListener.wrap(
+            response -> {
+                logger.error(response);
+                fail("should have called onFailure, not onResponse");
+            },
+            ex -> {
+                assertThat(ex, instanceOf(IllegalStateException.class));
+                assertThat(ex.getMessage(), Matchers.containsString("ILM history index [" + initialIndex +
+                    "] already exists but does not have alias [" + ILM_HISTORY_ALIAS + "]"));
+            }), latch));
+
+        ElasticsearchAssertions.awaitLatch(latch, 10, TimeUnit.SECONDS);
+    }
+
+    @SuppressWarnings("unchecked")
+    private void assertContainsMap(String indexedDocument, Map<String, Object> map) {
+        map.forEach((k, v) -> {
+            assertThat(indexedDocument, Matchers.containsString(k));
+            if (v instanceof Map) {
+                assertContainsMap(indexedDocument, (Map<String, Object>) v);
+            }
+            if (v instanceof Iterable) {
+                ((Iterable) v).forEach(elem -> {
+                    assertThat(indexedDocument, Matchers.containsString(elem.toString()));
+                });
+            } else {
+                assertThat(indexedDocument, Matchers.containsString(v.toString()));
+            }
+        });
+    }
+
+    /**
+     * A client that delegates to a verifying function for action/request/listener
+     */
+    public static class VerifyingClient extends NoOpClient {
+
+        private TriFunction<ActionType<?>, ActionRequest, ActionListener<?>, ActionResponse> verifier = (a, r, l) -> {
+            fail("verifier not set");
+            return null;
+        };
+
+        VerifyingClient(ThreadPool threadPool) {
+            super(threadPool);
+        }
+
+        @Override
+        @SuppressWarnings("unchecked")
+        protected <Request extends ActionRequest, Response extends ActionResponse> void doExecute(ActionType<Response> action,
+                                                                                                  Request request,
+                                                                                                  ActionListener<Response> listener) {
+            try {
+                listener.onResponse((Response) verifier.apply(action, request, listener));
+            } catch (Exception e) {
+                listener.onFailure(e);
+            }
+        }
+
+        VerifyingClient setVerifier(TriFunction<ActionType<?>, ActionRequest, ActionListener<?>, ActionResponse> verifier) {
+            this.verifier = verifier;
+            return this;
+        }
+    }
+}
diff --git a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/test/MonitoringIntegTestCase.java b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/test/MonitoringIntegTestCase.java
index 22f3b59220998..8270f97d7c01b 100644
--- a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/test/MonitoringIntegTestCase.java
+++ b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/test/MonitoringIntegTestCase.java
@@ -54,6 +54,7 @@ protected Settings nodeSettings(int nodeOrdinal) {
 //                .put(MachineLearningField.AUTODETECT_PROCESS.getKey(), false)
 //                .put(XPackSettings.MACHINE_LEARNING_ENABLED.getKey(), false)
                 // we do this by default in core, but for monitoring this isn't needed and only adds noise.
+                .put("index.lifecycle.history_index_enabled", false)
                 .put("index.store.mock.check_index_on_close", false);
 
         return builder.build();
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
index 82a9cffc35a9d..0c1377ac79767 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
@@ -116,6 +116,7 @@ protected Settings nodeSettings(int nodeOrdinal) {
                 // watcher settings that should work despite randomization
                 .put("xpack.watcher.execution.scroll.size", randomIntBetween(1, 100))
                 .put("xpack.watcher.watch.scroll.size", randomIntBetween(1, 100))
+                .put("index.lifecycle.history_index_enabled", false)
                 .build();
     }
 

From 4e68c855e55c3dbff2f4923aa560d171878450fc Mon Sep 17 00:00:00 2001
From: Stuart Tettemer <stu@elastic.co>
Date: Wed, 18 Dec 2019 16:19:28 -0700
Subject: [PATCH 264/686] [TEST] Unknown scripting annotations raise error
 (#50343)

Ensure that unknown annotations, such as typo'd `@nondeterministic`,
will raise an exception.
---
 .../painless/WhitelistLoaderTests.java        | 20 +++++++++++++++++++
 ....elasticsearch.painless.annotation.unknown |  6 ++++++
 ...h.painless.annotation.unknown_with_options |  5 +++++
 3 files changed, 31 insertions(+)
 create mode 100644 modules/lang-painless/src/test/resources/org/elasticsearch/painless/spi/org.elasticsearch.painless.annotation.unknown
 create mode 100644 modules/lang-painless/src/test/resources/org/elasticsearch/painless/spi/org.elasticsearch.painless.annotation.unknown_with_options

diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/WhitelistLoaderTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/WhitelistLoaderTests.java
index 7fe9dcce3bc09..59018e60c5db4 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/WhitelistLoaderTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/WhitelistLoaderTests.java
@@ -31,6 +31,26 @@
 import java.util.Map;
 
 public class WhitelistLoaderTests extends ScriptTestCase {
+    public void testUnknownAnnotations() {
+        Map<String, WhitelistAnnotationParser> parsers = new HashMap<>(WhitelistAnnotationParser.BASE_ANNOTATION_PARSERS);
+
+        RuntimeException expected = expectThrows(RuntimeException.class, () -> {
+            WhitelistLoader.loadFromResourceFiles(Whitelist.class, parsers, "org.elasticsearch.painless.annotation.unknown");
+        });
+        assertEquals(
+            "invalid annotation: parser not found for [unknownAnnotation] [@unknownAnnotation]", expected.getCause().getMessage()
+        );
+        assertEquals(IllegalArgumentException.class, expected.getCause().getClass());
+
+        expected = expectThrows(RuntimeException.class, () -> {
+            WhitelistLoader.loadFromResourceFiles(Whitelist.class, parsers, "org.elasticsearch.painless.annotation.unknown_with_options");
+        });
+        assertEquals(
+            "invalid annotation: parser not found for [unknownAnootationWithMessage] [@unknownAnootationWithMessage[arg=\"arg value\"]]",
+            expected.getCause().getMessage()
+        );
+        assertEquals(IllegalArgumentException.class, expected.getCause().getClass());
+    }
 
     public void testAnnotations() {
         Map<String, WhitelistAnnotationParser> parsers = new HashMap<>(WhitelistAnnotationParser.BASE_ANNOTATION_PARSERS);
diff --git a/modules/lang-painless/src/test/resources/org/elasticsearch/painless/spi/org.elasticsearch.painless.annotation.unknown b/modules/lang-painless/src/test/resources/org/elasticsearch/painless/spi/org.elasticsearch.painless.annotation.unknown
new file mode 100644
index 0000000000000..c67f535705b7a
--- /dev/null
+++ b/modules/lang-painless/src/test/resources/org/elasticsearch/painless/spi/org.elasticsearch.painless.annotation.unknown
@@ -0,0 +1,6 @@
+# whitelist for annotation tests with unknown annotation
+
+class org.elasticsearch.painless.AnnotationTestObject @no_import {
+  void unknownAnnotationMethod() @unknownAnnotation
+  void unknownAnnotationMethod() @unknownAnootationWithMessage[message="use another method"]
+}
diff --git a/modules/lang-painless/src/test/resources/org/elasticsearch/painless/spi/org.elasticsearch.painless.annotation.unknown_with_options b/modules/lang-painless/src/test/resources/org/elasticsearch/painless/spi/org.elasticsearch.painless.annotation.unknown_with_options
new file mode 100644
index 0000000000000..071b7f57fad2d
--- /dev/null
+++ b/modules/lang-painless/src/test/resources/org/elasticsearch/painless/spi/org.elasticsearch.painless.annotation.unknown_with_options
@@ -0,0 +1,5 @@
+# whitelist for annotation tests with unknown annotation containing options
+
+class org.elasticsearch.painless.AnnotationTestObject @no_import {
+  void unknownAnnotationMethod() @unknownAnootationWithMessage[arg="arg value"]
+}

From 899d9eb31f02f479f0f859f911c693a276af7f93 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 18 Dec 2019 23:18:11 -0800
Subject: [PATCH 265/686] Review comments by dakrone

---
 .../xpack/core/ilm/ForceMergeAction.java      | 68 +++++++++++--------
 .../xpack/core/ilm/WaitForIndexColorStep.java | 43 ++++++------
 .../xpack/core/ilm/ForceMergeActionTests.java | 19 ++++--
 .../ilm/TimeseriesLifecycleTypeTests.java     |  2 +-
 4 files changed, 76 insertions(+), 56 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 78417857a7363..6ee7c3eb2df19 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -10,6 +10,7 @@
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -23,7 +24,7 @@
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 
 import java.io.IOException;
-import java.util.Arrays;
+import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
 
@@ -38,13 +39,13 @@ public class ForceMergeAction implements LifecycleAction {
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        Codec codec = a[1] != null ? Codec.forName((String) a[1]) : Codec.getDefault();
+        Codec codec = a[1] != null ? Codec.forName((String) a[1]) : null;
         return new ForceMergeAction(maxNumSegments, codec);
     });
 
     static {
         PARSER.declareInt(ConstructingObjectParser.constructorArg(), MAX_NUM_SEGMENTS_FIELD);
-        PARSER.declareInt(ConstructingObjectParser.constructorArg(), CODEC);
+        PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), CODEC);
     }
 
     private final int maxNumSegments;
@@ -54,21 +55,24 @@ public static ForceMergeAction parse(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    public ForceMergeAction(int maxNumSegments, Codec codec) {
+    public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
         if (maxNumSegments <= 0) {
             throw new IllegalArgumentException("[" + MAX_NUM_SEGMENTS_FIELD.getPreferredName()
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
+        if (codec != null && Codec.forName(codec.getName()) == null) {
+            throw new IllegalArgumentException("Compression type of " + codec.getName() + "does not exist");
+        }
         this.codec = codec;
     }
 
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
         if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
-            this.codec = Codec.forName(in.readString());
+            this.codec = Codec.forName(in.readOptionalString());
         } else {
-            this.codec = Codec.getDefault();
+            this.codec = null;
         }
     }
 
@@ -84,9 +88,9 @@ public Codec getCodec() {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
         if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
-            out.writeString(codec.getName());
+            out.writeOptionalString(codec.getName());
         } else {
-            out.writeString(Codec.getDefault().getName());
+            out.writeString(null);
         }
     }
 
@@ -104,7 +108,9 @@ public boolean isSafeAction() {
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
         builder.field(MAX_NUM_SEGMENTS_FIELD.getPreferredName(), maxNumSegments);
-        builder.field(CODEC.getPreferredName(), codec);
+        if (codec != null) {
+            builder.field(CODEC.getPreferredName(), codec);
+        }
         builder.endObject();
         return builder;
     }
@@ -119,28 +125,34 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         StepKey forceMergeKey = new StepKey(phase, NAME, ForceMergeStep.NAME);
         StepKey countKey = new StepKey(phase, NAME, SegmentCountStep.NAME);
 
-
-        if (codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
-            StepKey closeKey = new StepKey(phase, NAME, CloseIndexStep.NAME);
-            StepKey openKey = new StepKey(phase, NAME, OpenIndexStep.NAME);
-            StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
-            StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
-
-            CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
-            UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
-                openKey, client, bestCompressionSettings);
-            OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
-            WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
-                forceMergeKey, ClusterHealthStatus.GREEN);
-            ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, nextStepKey, client, maxNumSegments);
-            return Arrays.asList(closeIndexStep, updateBestCompressionSettings,
-                openIndexStep, waitForIndexGreenStep, forceMergeStep);
-        }
+        StepKey closeKey = new StepKey(phase, NAME, CloseIndexStep.NAME);
+        StepKey openKey = new StepKey(phase, NAME, OpenIndexStep.NAME);
+        StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
+        StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
 
         UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, forceMergeKey, client, readOnlySettings);
         ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
         SegmentCountStep segmentCountStep = new SegmentCountStep(countKey, nextStepKey, client, maxNumSegments);
-        return Arrays.asList(readOnlyStep, forceMergeStep, segmentCountStep);
+        CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
+        UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
+            openKey, client, bestCompressionSettings);
+        OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
+        WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
+            forceMergeKey, ClusterHealthStatus.GREEN);
+
+        List<Step> mergeSteps = new ArrayList<>();
+        mergeSteps.add(readOnlyStep);
+
+        if (codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
+            mergeSteps.add(closeIndexStep);
+            mergeSteps.add(updateBestCompressionSettings);
+            mergeSteps.add(openIndexStep);
+            mergeSteps.add(waitForIndexGreenStep);
+        }
+
+        mergeSteps.add(forceMergeStep);
+        mergeSteps.add(segmentCountStep);
+        return mergeSteps;
     }
 
     @Override
@@ -158,7 +170,7 @@ public boolean equals(Object obj) {
         }
         ForceMergeAction other = (ForceMergeAction) obj;
         return Objects.equals(maxNumSegments, other.maxNumSegments)
-            && Objects.equals(codec, other.codec);
+            && ((codec == null && other.codec == null) || Objects.equals(codec, other.codec));
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
index 812ad66323668..bfaf6ab5bfcb1 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
@@ -23,7 +23,7 @@
 
 /**
  * Wait Step for index based on color
- * */
+ */
 
 class WaitForIndexColorStep extends ClusterStateWaitStep {
 
@@ -47,8 +47,12 @@ public int hashCode() {
 
     @Override
     public boolean equals(Object obj) {
-        if (obj == null) return false;
-        if (!(obj instanceof WaitForIndexColorStep)) return false;
+        if (obj == null) {
+            return false;
+        }
+        if (obj.getClass() != getClass()) {
+            return false;
+        }
         WaitForIndexColorStep other = (WaitForIndexColorStep) obj;
         return super.equals(obj) && Objects.equals(this.color, other.color);
     }
@@ -69,7 +73,7 @@ public Result isConditionMet(Index index, ClusterState clusterState) {
                 result = waitForRed(indexRoutingTable);
                 break;
             default:
-                result = new Result(false, new Info("No index color match"));
+                result = new Result(false, new Info("no index color match"));
                 break;
         }
         return result;
@@ -77,14 +81,14 @@ public Result isConditionMet(Index index, ClusterState clusterState) {
 
     private Result waitForRed(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
-            return new Result(true, new Info("Index is red"));
+            return new Result(true, new Info("index is red"));
         }
-        return new Result(false, new Info("Index is not red"));
+        return new Result(false, new Info("index is not red"));
     }
 
     private Result waitForYellow(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
-            return new Result(false, new Info("index is red; no IndexRoutingTable"));
+            return new Result(false, new Info("index is red; no indexRoutingTable"));
         }
 
         boolean indexIsAtLeastYellow = indexRoutingTable.allPrimaryShardsActive();
@@ -97,27 +101,20 @@ private Result waitForYellow(IndexRoutingTable indexRoutingTable) {
 
     private Result waitForGreen(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
-            return new Result(false, new Info("index is red; no IndexRoutingTable"));
+            return new Result(false, new Info("index is red; no indexRoutingTable"));
         }
 
-        boolean indexIsGreen = false;
         if (indexRoutingTable.allPrimaryShardsActive()) {
-            boolean replicaIndexIsGreen = false;
             for (ObjectCursor<IndexShardRoutingTable> shardRouting : indexRoutingTable.getShards().values()) {
-                replicaIndexIsGreen = shardRouting.value.replicaShards().stream().allMatch(ShardRouting::active);
-                if (!replicaIndexIsGreen) {
+                boolean replicaIndexIsGreen = shardRouting.value.replicaShards().stream().allMatch(ShardRouting::active);
+                if (replicaIndexIsGreen == false) {
                     return new Result(false, new Info("index is yellow; not all replica shards are active"));
                 }
             }
-            indexIsGreen = replicaIndexIsGreen;
-        }
-
-
-        if (indexIsGreen) {
             return new Result(true, null);
-        } else {
-            return new Result(false, new Info("index is not green; not all shards are active"));
         }
+
+        return new Result(false, new Info("index is not green; not all shards are active"));
     }
 
     static final class Info implements ToXContentObject {
@@ -144,8 +141,12 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
 
         @Override
         public boolean equals(Object o) {
-            if (this == o) return true;
-            if (o == null || getClass() != o.getClass()) return false;
+            if (o == null) {
+                return false;
+            }
+            if (getClass() != o.getClass()) {
+                return false;
+            }
             Info info = (Info) o;
             return Objects.equals(getMessage(), info.getMessage());
         }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index ef88e461c0d13..042c12b9fcb78 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -41,7 +41,7 @@ static ForceMergeAction randomInstance() {
 
     static Codec createRandomCompressionSettings() {
         if(randomBoolean()) {
-            return Codec.getDefault();
+            return null;
         }
         return Codec.forName(CodecService.BEST_COMPRESSION_CODEC);
     }
@@ -50,7 +50,7 @@ static Codec createRandomCompressionSettings() {
     protected ForceMergeAction mutateInstance(ForceMergeAction instance) {
         int maxNumSegments = instance.getMaxNumSegments();
         maxNumSegments = maxNumSegments + randomIntBetween(1, 10);
-        return new ForceMergeAction(maxNumSegments, Codec.getDefault());
+        return new ForceMergeAction(maxNumSegments, createRandomCompressionSettings());
     }
 
     @Override
@@ -81,12 +81,13 @@ private void assertBestCompression(ForceMergeAction instance) {
         StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
         List<Step> steps = instance.toSteps(null, phase, nextStepKey);
         assertNotNull(steps);
-        assertEquals(5, steps.size());
+        assertEquals(6, steps.size());
         CloseIndexStep firstStep = (CloseIndexStep) steps.get(0);
         UpdateSettingsStep secondStep = (UpdateSettingsStep) steps.get(1);
         OpenIndexStep thirdStep = (OpenIndexStep) steps.get(2);
         WaitForIndexColorStep fourthStep = (WaitForIndexColorStep) steps.get(3);
         ForceMergeStep fifthStep = (ForceMergeStep) steps.get(4);
+        SegmentCountStep sixthStep = (SegmentCountStep) steps.get(4);
         assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
         assertThat(firstStep.getNextStepKey(), equalTo(secondStep.getKey()));
         assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
@@ -98,6 +99,8 @@ private void assertBestCompression(ForceMergeAction instance) {
         assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
         assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
         assertThat(fifthStep.getNextStepKey(), equalTo(nextStepKey));
+        assertThat(sixthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
+        assertThat(sixthStep.getNextStepKey(), equalTo(nextStepKey));
     }
 
     public void testMissingMaxNumSegments() throws IOException {
@@ -105,18 +108,22 @@ public void testMissingMaxNumSegments() throws IOException {
         XContentParser parser = XContentHelper.createParser(null, DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
             emptyObject, XContentType.JSON);
         Exception e = expectThrows(IllegalArgumentException.class, () -> ForceMergeAction.parse(parser));
-        assertThat(e.getMessage(), equalTo("Required [max_num_segments, best_compression]"));
+        assertThat(e.getMessage(), equalTo("Required [max_num_segments]"));
     }
 
     public void testInvalidNegativeSegmentNumber() {
         Exception r = expectThrows(IllegalArgumentException.class, () -> new
-            ForceMergeAction(randomIntBetween(-10, 0), Codec.getDefault()));
+            ForceMergeAction(randomIntBetween(-10, 0), null));
         assertThat(r.getMessage(), equalTo("[max_num_segments] must be a positive integer"));
     }
 
+    public void testInvalidCodec() {
+
+    }
+
     public void testToSteps() {
         ForceMergeAction instance = createTestInstance();
-        if (CodecService.BEST_COMPRESSION_CODEC.equals(instance.getCodec().getName())) {
+        if (instance.getCodec() != null && CodecService.BEST_COMPRESSION_CODEC.equals(instance.getCodec().getName())) {
             assertBestCompression(instance);
         }
         else {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index 1469e40e6682d..e1df27f09a44f 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -493,7 +493,7 @@ private ConcurrentMap<String, LifecycleAction> convertActionNamesToActions(Strin
             case DeleteAction.NAME:
                 return new DeleteAction();
             case ForceMergeAction.NAME:
-                return new ForceMergeAction(1, Codec.getDefault());
+                return new ForceMergeAction(1, null);
             case ReadOnlyAction.NAME:
                 return new ReadOnlyAction();
             case RolloverAction.NAME:

From 5b4149fc0b0fdf6427b1f8df34e42a4cba9ec1b0 Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Thu, 19 Dec 2019 09:45:44 +0000
Subject: [PATCH 266/686] Mute TimeSeriesLifecycleActionsIT.
 testHistoryIsWrittenWithFailure

Relates to #50353
---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 29976664bc896..7192febb6b11e 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1047,6 +1047,7 @@ public void testHistoryIsWrittenWithSuccess() throws Exception {
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-000002", true, "check-rollover-ready"), 30, TimeUnit.SECONDS);
     }
 
+    @AwaitsFix( bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithFailure() throws Exception {
         String index = "index";
 

From 0ef7bbe0a860909e2b5d56d62ffc2de4467e34ef Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Thu, 19 Dec 2019 10:52:54 +0000
Subject: [PATCH 267/686] Mute SnapshotLifecycleRestIT testFullPolicySnapshot

Relates to #50358
---
 .../org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
index cb37d3ad051ad..07628b54c960e 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
@@ -82,6 +82,7 @@ public void testMissingRepo() throws Exception {
     }
 
     @SuppressWarnings("unchecked")
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50358")
     public void testFullPolicySnapshot() throws Exception {
         final String indexName = "test";
         final String policyName = "test-policy";

From 727f641583b788d604b12bdddf74a67dd6236a33 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 19 Dec 2019 12:19:44 +0100
Subject: [PATCH 268/686] [DOCS] Adds inference processor documentation
 (#50204)

Co-Authored-By: Lisa Cawley <lcawley@elastic.co>
---
 docs/reference/ingest/ingest-node.asciidoc    |   1 +
 .../ingest/processors/inference.asciidoc      | 107 ++++++++++++++++++
 2 files changed, 108 insertions(+)
 create mode 100644 docs/reference/ingest/processors/inference.asciidoc

diff --git a/docs/reference/ingest/ingest-node.asciidoc b/docs/reference/ingest/ingest-node.asciidoc
index 596bda67d3ed8..d32384e613bb7 100644
--- a/docs/reference/ingest/ingest-node.asciidoc
+++ b/docs/reference/ingest/ingest-node.asciidoc
@@ -838,6 +838,7 @@ include::processors/geoip.asciidoc[]
 include::processors/grok.asciidoc[]
 include::processors/gsub.asciidoc[]
 include::processors/html_strip.asciidoc[]
+include::processors/inference.asciidoc[]
 include::processors/join.asciidoc[]
 include::processors/json.asciidoc[]
 include::processors/kv.asciidoc[]
diff --git a/docs/reference/ingest/processors/inference.asciidoc b/docs/reference/ingest/processors/inference.asciidoc
new file mode 100644
index 0000000000000..799e465f87a48
--- /dev/null
+++ b/docs/reference/ingest/processors/inference.asciidoc
@@ -0,0 +1,107 @@
+[role="xpack"]
+[testenv="basic"]
+[[inference-processor]]
+=== {infer-cap} Processor
+
+Uses a pre-trained {dfanalytics} model to infer against the data that is being 
+ingested in the pipeline.
+
+
+[[inference-options]]
+.{infer-cap} Options
+[options="header"]
+|======
+| Name               | Required  | Default                        | Description
+| `model_id`      | yes       | -                              | (String) The ID of the model to load and infer against.
+| `target_field`     | no        | `ml.inference.<processor_tag>` | (String) Field added to incoming documents to contain results objects.
+| `field_mappings`   | yes       | -                              | (Object) Maps the document field names to the known field names of the model.
+| `inference_config` | yes       | -                              | (Object) Contains the inference type and its options. There are two types: <<inference-processor-regression-opt,`regression`>> and <<inference-processor-classification-opt,`classification`>>.
+include::common-options.asciidoc[]
+|======
+
+
+[source,js]
+--------------------------------------------------
+{
+  	"inference": {
+      	"model_id": "flight_delay_regression-1571767128603",
+      	"target_field": "FlightDelayMin_prediction_infer",
+      	"field_mappings": {},
+      	"inference_config": {"regression": {}},
+      	"model_info_field": "ml"
+    }
+}
+--------------------------------------------------
+// NOTCONSOLE
+
+
+
+[discrete]
+[[inference-processor-regression-opt]]
+==== {regression-cap} configuration options
+
+`results_field`::
+(Optional, string)
+Specifies the field to which the inference prediction is written. Defaults to 
+`predicted_value`.
+
+
+[discrete]
+[[inference-processor-classification-opt]]
+==== {classification-cap} configuration options
+
+`results_field`::
+(Optional, string)
+The field that is added to incoming documents to contain the inference prediction. Defaults to 
+`predicted_value`.
+
+`num_top_classes`::
+(Optional, integer) 
+Specifies the number of top class predictions to return. Defaults to 0.
+
+`top_classes_results_field`::
+(Optional, string) 
+Specifies the field to which the top classes are written. Defaults to 
+`top_classes`.
+
+
+[discrete]
+[[inference-processor-config-example]]
+==== `inference_config` examples
+
+[source,js]
+--------------------------------------------------
+{
+  "inference_config": {
+    “regression�: {
+    “results_field�: “my_regression�
+    }
+  },
+}
+--------------------------------------------------
+// NOTCONSOLE
+
+This configuration specifies a `regression` inference and the results are 
+written to the `my_regression` field contained in the `target_field` results 
+object.
+
+
+[source,js]
+--------------------------------------------------
+{
+  "inference_config": {
+    “classification�: {
+      “num_top_classes�: 2, 
+      “results_field�: “prediction�, 
+      “top_classes_results_field�: “probabilities�
+      }
+    }
+}
+--------------------------------------------------
+// NOTCONSOLE
+
+This configuration specifies a `classification` inference. The number of 
+categories for which the predicted probabilities are reported is 2 
+(`num_top_classes`). The result is written to the `prediction` field and the top 
+classes to the `probabilities` field. Both fields are contained in the 
+`target_field` results object.

From 97a23a9edbffa5a1bb8af9bc78fbb86317b1ca19 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Thu, 19 Dec 2019 11:31:43 +0000
Subject: [PATCH 269/686] Fixes to task result index mapping (#50359)

The built-in mapping for the tasks result index still has a mapping type defined; while
this does not matter for index creation, as we still have a create method that takes a
top-level type, it does matter for updates. In combination with a separate bug, that the
built-in mapping has not incremented its meta version, this meant that tasks submitted
to a cluster with an already existing task index would attempt to update the mappings
on that index, and fail due to the top-level type.

This commit fixes the mapping to have a top-level mapping of _doc, and also updates
the meta version so that we do not update mappings on every new task. It also adds a
test that explicitly runs two asynchronous tasks to ensure that the mappings do not
cause a failure.

Fixes #50248
---
 .../java/org/elasticsearch/tasks/TaskResultsService.java   | 4 +---
 .../org/elasticsearch/tasks/task-index-mapping.json        | 4 ++--
 .../action/admin/cluster/node/tasks/TasksIT.java           | 7 +++++++
 3 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/tasks/TaskResultsService.java b/server/src/main/java/org/elasticsearch/tasks/TaskResultsService.java
index bcc7d62fd4c22..6e1b5ec2d9e00 100644
--- a/server/src/main/java/org/elasticsearch/tasks/TaskResultsService.java
+++ b/server/src/main/java/org/elasticsearch/tasks/TaskResultsService.java
@@ -67,8 +67,6 @@ public class TaskResultsService {
 
     public static final String TASK_INDEX = ".tasks";
 
-    public static final String TASK_TYPE = "task";
-
     public static final String TASK_RESULT_INDEX_MAPPING_FILE = "task-index-mapping.json";
 
     public static final String TASK_RESULT_MAPPING_VERSION_META_FIELD = "version";
@@ -103,7 +101,7 @@ public void storeResult(TaskResult taskResult, ActionListener<Void> listener) {
             CreateIndexRequest createIndexRequest = new CreateIndexRequest();
             createIndexRequest.settings(taskResultIndexSettings());
             createIndexRequest.index(TASK_INDEX);
-            createIndexRequest.mapping(TASK_TYPE, taskResultIndexMapping(), XContentType.JSON);
+            createIndexRequest.mapping(taskResultIndexMapping());
             createIndexRequest.cause("auto(task api)");
 
             client.admin().indices().create(createIndexRequest, new ActionListener<CreateIndexResponse>() {
diff --git a/server/src/main/resources/org/elasticsearch/tasks/task-index-mapping.json b/server/src/main/resources/org/elasticsearch/tasks/task-index-mapping.json
index b8ef2dcd56216..ef5873ae53c58 100644
--- a/server/src/main/resources/org/elasticsearch/tasks/task-index-mapping.json
+++ b/server/src/main/resources/org/elasticsearch/tasks/task-index-mapping.json
@@ -1,7 +1,7 @@
 {
-  "task" : {
+  "_doc" : {
     "_meta": {
-      "version": 2
+      "version": 3
     },
     "dynamic" : "strict",
     "properties" : {
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/node/tasks/TasksIT.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/node/tasks/TasksIT.java
index 21c2c5da15137..a102cb4bc2082 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/node/tasks/TasksIT.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/node/tasks/TasksIT.java
@@ -768,6 +768,13 @@ public void testTaskStoringSuccessfulResult() throws Exception {
         GetTaskResponse getResponse = expectFinishedTask(taskId);
         assertEquals(result, getResponse.getTask().getResponseAsMap());
         assertNull(getResponse.getTask().getError());
+
+        // run it again to check that the tasks index has been successfully created and can be re-used
+        client().execute(TestTaskPlugin.TestTaskAction.INSTANCE, request).get();
+
+        events = findEvents(TestTaskPlugin.TestTaskAction.NAME, Tuple::v1);
+
+        assertEquals(2, events.size());
     }
 
     public void testTaskStoringFailureResult() throws Exception {

From 5268edd0f44e8f0dd8420c63340aa3595eae629a Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Thu, 19 Dec 2019 07:12:04 -0500
Subject: [PATCH 270/686] [ML][Inference] points HLRC javadocs to reference
 docs (#50321)

---
 .../elasticsearch/client/MachineLearningClient.java  | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/MachineLearningClient.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/MachineLearningClient.java
index 0589f5c28d865..0a71b8ddb0172 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/MachineLearningClient.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/MachineLearningClient.java
@@ -2301,7 +2301,7 @@ public Cancellable explainDataFrameAnalyticsAsync(ExplainDataFrameAnalyticsReque
      * Gets trained model configs
      * <p>
      * For additional info
-     * see <a href="TODO">
+     * see <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/get-inference.html">
      *     GET Trained Model Configs documentation</a>
      *
      * @param request The {@link GetTrainedModelsRequest}
@@ -2321,7 +2321,7 @@ public GetTrainedModelsResponse getTrainedModels(GetTrainedModelsRequest request
      * Gets trained model configs asynchronously and notifies listener upon completion
      * <p>
      * For additional info
-     * see <a href="TODO">
+     * see <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/get-inference.html">
      *     GET Trained Model Configs documentation</a>
      *
      * @param request The {@link GetTrainedModelsRequest}
@@ -2344,7 +2344,7 @@ public Cancellable getTrainedModelsAsync(GetTrainedModelsRequest request,
      * Gets trained model stats
      * <p>
      * For additional info
-     * see <a href="TODO">
+     * see <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/get-inference-stats.html">
      *     GET Trained Model Stats documentation</a>
      *
      * @param request The {@link GetTrainedModelsStatsRequest}
@@ -2364,7 +2364,7 @@ public GetTrainedModelsStatsResponse getTrainedModelsStats(GetTrainedModelsStats
      * Gets trained model stats asynchronously and notifies listener upon completion
      * <p>
      * For additional info
-     * see <a href="TODO">
+     * see <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/get-inference-stats.html">
      *     GET Trained Model Stats documentation</a>
      *
      * @param request The {@link GetTrainedModelsStatsRequest}
@@ -2387,7 +2387,7 @@ public Cancellable getTrainedModelsStatsAsync(GetTrainedModelsStatsRequest reque
      * Deletes the given Trained Model
      * <p>
      * For additional info
-     * see <a href="TODO">
+     * see <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/delete-inference.html">
      *     DELETE Trained  Model documentation</a>
      *
      * @param request The {@link DeleteTrainedModelRequest}
@@ -2407,7 +2407,7 @@ public AcknowledgedResponse deleteTrainedModel(DeleteTrainedModelRequest request
      * Deletes the given Trained Model asynchronously and notifies listener upon completion
      * <p>
      * For additional info
-     * see <a href="TODO">
+     * see <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/delete-inference.html">
      *     DELETE Trained Model documentation</a>
      *
      * @param request The {@link DeleteTrainedModelRequest}

From d1b40000f9f8f608d039f0c6bc32721b6b875091 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Thu, 19 Dec 2019 16:07:09 +0100
Subject: [PATCH 271/686] Implement `precision` and `recall` metrics for
 classification evaluation (#49671)

---
 .../client/ml/EvaluateDataFrameResponse.java  |   7 +-
 .../MlEvaluationNamedXContentProvider.java    | 106 ++++--
 .../classification/Classification.java        |  12 +-
 .../classification/PrecisionMetric.java       | 201 ++++++++++
 .../classification/RecallMetric.java          | 201 ++++++++++
 .../evaluation/regression/Regression.java     |  12 +-
 .../BinarySoftClassification.java             |   4 +-
 .../client/MachineLearningIT.java             |  64 ++++
 .../client/RestHighLevelClientTests.java      |  49 ++-
 .../MlClientDocumentationIT.java              |  28 +-
 .../ml/EvaluateDataFrameResponseTests.java    |   2 +
 .../classification/ClassificationTests.java   |   2 +
 .../PrecisionMetricResultTests.java           |  67 ++++
 .../classification/PrecisionMetricTests.java  |  53 +++
 .../RecallMetricResultTests.java              |  67 ++++
 .../classification/RecallMetricTests.java     |  53 +++
 .../ml/evaluate-data-frame.asciidoc           |  16 +-
 .../xpack/core/XPackClientPlugin.java         |  34 +-
 .../ml/dataframe/evaluation/Evaluation.java   |   7 +-
 .../evaluation/EvaluationMetric.java          |   4 +-
 .../MlEvaluationNamedXContentProvider.java    | 222 +++++++----
 .../evaluation/classification/Accuracy.java   |  26 +-
 .../classification/Classification.java        |  21 +-
 .../classification/ClassificationMetric.java  |  11 -
 .../MulticlassConfusionMatrix.java            |  48 ++-
 .../evaluation/classification/Precision.java  | 345 ++++++++++++++++++
 .../evaluation/classification/Recall.java     | 319 ++++++++++++++++
 .../regression/MeanSquaredError.java          |  19 +-
 .../evaluation/regression/RSquared.java       |  23 +-
 .../evaluation/regression/Regression.java     |  21 +-
 .../regression/RegressionMetric.java          |  11 -
 .../AbstractConfusionMatrixMetric.java        |  13 +-
 .../evaluation/softclassification/AucRoc.java |  20 +-
 .../BinarySoftClassification.java             |  25 +-
 .../softclassification/ConfusionMatrix.java   |   6 +-
 .../softclassification/Precision.java         |   4 +-
 .../evaluation/softclassification/Recall.java |   4 +-
 .../ScoreByThresholdResult.java               |   7 +-
 .../SoftClassificationMetric.java             |  17 -
 .../EvaluateDataFrameActionRequestTests.java  |  11 +-
 .../EvaluateDataFrameActionResponseTests.java |  11 +-
 .../classification/AccuracyResultTests.java   |  24 +-
 .../classification/ClassificationTests.java   |  23 +-
 .../MulticlassConfusionMatrixTests.java       |  12 +-
 .../classification/PrecisionResultTests.java  |  48 +++
 .../classification/PrecisionTests.java        | 119 ++++++
 .../classification/RecallResultTests.java     |  48 +++
 .../classification/RecallTests.java           | 118 ++++++
 .../classification/TupleMatchers.java         |  49 +++
 .../regression/RegressionTests.java           |   5 +-
 .../BinarySoftClassificationTests.java        |   5 +-
 .../ClassificationEvaluationIT.java           | 149 ++++++--
 .../ml/integration/ClassificationIT.java      |  26 +-
 .../test/ml/evaluate_data_frame.yml           |  52 +++
 54 files changed, 2483 insertions(+), 368 deletions(-)
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetric.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetric.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetricResultTests.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetricTests.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetricResultTests.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetricTests.java
 delete mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationMetric.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
 delete mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RegressionMetric.java
 delete mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/SoftClassificationMetric.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/PrecisionResultTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/PrecisionTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/RecallResultTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/RecallTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/TupleMatchers.java

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/EvaluateDataFrameResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/EvaluateDataFrameResponse.java
index 0709021ed4bd5..b53e692315507 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/EvaluateDataFrameResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/EvaluateDataFrameResponse.java
@@ -34,6 +34,7 @@
 import java.util.Objects;
 import java.util.stream.Collectors;
 
+import static org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
 import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
 
 public class EvaluateDataFrameResponse implements ToXContentObject {
@@ -46,7 +47,7 @@ public static EvaluateDataFrameResponse fromXContent(XContentParser parser) thro
         ensureExpectedToken(XContentParser.Token.FIELD_NAME, parser.nextToken(), parser::getTokenLocation);
         String evaluationName = parser.currentName();
         parser.nextToken();
-        Map<String, EvaluationMetric.Result> metrics = parser.map(LinkedHashMap::new, EvaluateDataFrameResponse::parseMetric);
+        Map<String, EvaluationMetric.Result> metrics = parser.map(LinkedHashMap::new, p -> parseMetric(evaluationName, p));
         List<EvaluationMetric.Result> knownMetrics =
             metrics.values().stream()
                 .filter(Objects::nonNull)  // Filter out null values returned by {@link EvaluateDataFrameResponse::parseMetric}.
@@ -55,10 +56,10 @@ public static EvaluateDataFrameResponse fromXContent(XContentParser parser) thro
         return new EvaluateDataFrameResponse(evaluationName, knownMetrics);
     }
 
-    private static EvaluationMetric.Result parseMetric(XContentParser parser) throws IOException {
+    private static EvaluationMetric.Result parseMetric(String evaluationName, XContentParser parser) throws IOException {
         String metricName = parser.currentName();
         try {
-            return parser.namedObject(EvaluationMetric.Result.class, metricName, null);
+            return parser.namedObject(EvaluationMetric.Result.class, registeredMetricName(evaluationName, metricName), null);
         } catch (NamedObjectNotFoundException e) {
             parser.skipChildren();
             // Metric name not recognized. Return {@code null} value here and filter it out later.
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/MlEvaluationNamedXContentProvider.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/MlEvaluationNamedXContentProvider.java
index efe58b9739eda..cd5c2abdf5627 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/MlEvaluationNamedXContentProvider.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/MlEvaluationNamedXContentProvider.java
@@ -20,24 +20,36 @@
 
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.Classification;
-import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetric;
+import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.RSquaredMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.Regression;
-import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.BinarySoftClassification;
-import org.elasticsearch.common.ParseField;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
-import org.elasticsearch.plugins.spi.NamedXContentProvider;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.AucRocMetric;
+import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.BinarySoftClassification;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.PrecisionMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.RecallMetric;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.plugins.spi.NamedXContentProvider;
 
 import java.util.Arrays;
 import java.util.List;
 
 public class MlEvaluationNamedXContentProvider implements NamedXContentProvider {
 
+    /**
+     * Constructs the name under which a metric (or metric result) is registered.
+     * The name is prefixed with evaluation name so that registered names are unique.
+     *
+     * @param evaluationName name of the evaluation
+     * @param metricName name of the metric
+     * @return name appropriate for registering a metric (or metric result) in {@link NamedXContentRegistry}
+     */
+    public static String registeredMetricName(String evaluationName, String metricName) {
+        return evaluationName + "." +  metricName;
+    }
+
     @Override
     public List<NamedXContentRegistry.Entry> getNamedXContentParsers() {
         return Arrays.asList(
@@ -47,39 +59,91 @@ Evaluation.class, new ParseField(BinarySoftClassification.NAME), BinarySoftClass
             new NamedXContentRegistry.Entry(Evaluation.class, new ParseField(Classification.NAME), Classification::fromXContent),
             new NamedXContentRegistry.Entry(Evaluation.class, new ParseField(Regression.NAME), Regression::fromXContent),
             // Evaluation metrics
-            new NamedXContentRegistry.Entry(EvaluationMetric.class, new ParseField(AucRocMetric.NAME), AucRocMetric::fromXContent),
-            new NamedXContentRegistry.Entry(EvaluationMetric.class, new ParseField(PrecisionMetric.NAME), PrecisionMetric::fromXContent),
-            new NamedXContentRegistry.Entry(EvaluationMetric.class, new ParseField(RecallMetric.NAME), RecallMetric::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.class, new ParseField(ConfusionMatrixMetric.NAME), ConfusionMatrixMetric::fromXContent),
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, AucRocMetric.NAME)),
+                AucRocMetric::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.class, new ParseField(AccuracyMetric.NAME), AccuracyMetric::fromXContent),
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, PrecisionMetric.NAME)),
+                PrecisionMetric::fromXContent),
             new NamedXContentRegistry.Entry(
                 EvaluationMetric.class,
-                new ParseField(MulticlassConfusionMatrixMetric.NAME),
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, RecallMetric.NAME)),
+                RecallMetric::fromXContent),
+            new NamedXContentRegistry.Entry(
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, ConfusionMatrixMetric.NAME)),
+                ConfusionMatrixMetric::fromXContent),
+            new NamedXContentRegistry.Entry(
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(Classification.NAME, AccuracyMetric.NAME)),
+                AccuracyMetric::fromXContent),
+            new NamedXContentRegistry.Entry(
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(
+                    Classification.NAME, org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.NAME)),
+                org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric::fromXContent),
+            new NamedXContentRegistry.Entry(
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(
+                    Classification.NAME, org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.NAME)),
+                org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric::fromXContent),
+            new NamedXContentRegistry.Entry(
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(Classification.NAME, MulticlassConfusionMatrixMetric.NAME)),
                 MulticlassConfusionMatrixMetric::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.class, new ParseField(MeanSquaredErrorMetric.NAME), MeanSquaredErrorMetric::fromXContent),
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(Regression.NAME, MeanSquaredErrorMetric.NAME)),
+                MeanSquaredErrorMetric::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.class, new ParseField(RSquaredMetric.NAME), RSquaredMetric::fromXContent),
+                EvaluationMetric.class,
+                new ParseField(registeredMetricName(Regression.NAME, RSquaredMetric.NAME)),
+                RSquaredMetric::fromXContent),
             // Evaluation metrics results
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.Result.class, new ParseField(AucRocMetric.NAME), AucRocMetric.Result::fromXContent),
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, AucRocMetric.NAME)),
+                AucRocMetric.Result::fromXContent),
+            new NamedXContentRegistry.Entry(
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, PrecisionMetric.NAME)),
+                PrecisionMetric.Result::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.Result.class, new ParseField(PrecisionMetric.NAME), PrecisionMetric.Result::fromXContent),
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, RecallMetric.NAME)),
+                RecallMetric.Result::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.Result.class, new ParseField(RecallMetric.NAME), RecallMetric.Result::fromXContent),
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, ConfusionMatrixMetric.NAME)),
+                ConfusionMatrixMetric.Result::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.Result.class, new ParseField(ConfusionMatrixMetric.NAME), ConfusionMatrixMetric.Result::fromXContent),
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(Classification.NAME, AccuracyMetric.NAME)),
+                AccuracyMetric.Result::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.Result.class, new ParseField(AccuracyMetric.NAME), AccuracyMetric.Result::fromXContent),
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(
+                    Classification.NAME, org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.NAME)),
+                org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.Result::fromXContent),
             new NamedXContentRegistry.Entry(
                 EvaluationMetric.Result.class,
-                new ParseField(MulticlassConfusionMatrixMetric.NAME),
+                new ParseField(registeredMetricName(
+                    Classification.NAME, org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.NAME)),
+                org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.Result::fromXContent),
+            new NamedXContentRegistry.Entry(
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(Classification.NAME, MulticlassConfusionMatrixMetric.NAME)),
                 MulticlassConfusionMatrixMetric.Result::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.Result.class, new ParseField(MeanSquaredErrorMetric.NAME), MeanSquaredErrorMetric.Result::fromXContent),
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(Regression.NAME, MeanSquaredErrorMetric.NAME)),
+                MeanSquaredErrorMetric.Result::fromXContent),
             new NamedXContentRegistry.Entry(
-                EvaluationMetric.Result.class, new ParseField(RSquaredMetric.NAME), RSquaredMetric.Result::fromXContent));
+                EvaluationMetric.Result.class,
+                new ParseField(registeredMetricName(Regression.NAME, RSquaredMetric.NAME)),
+                RSquaredMetric.Result::fromXContent)
+        );
     }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/Classification.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/Classification.java
index d7466fcc023b5..f64078228986b 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/Classification.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/Classification.java
@@ -32,6 +32,10 @@
 import java.util.List;
 import java.util.Objects;
 
+import static org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
+
 /**
  * Evaluation of classification results.
  */
@@ -48,10 +52,10 @@ public class Classification implements Evaluation {
         NAME, true, a -> new Classification((String) a[0], (String) a[1], (List<EvaluationMetric>) a[2]));
 
     static {
-        PARSER.declareString(ConstructingObjectParser.constructorArg(), ACTUAL_FIELD);
-        PARSER.declareString(ConstructingObjectParser.constructorArg(), PREDICTED_FIELD);
-        PARSER.declareNamedObjects(ConstructingObjectParser.optionalConstructorArg(),
-            (p, c, n) -> p.namedObject(EvaluationMetric.class, n, c), METRICS);
+        PARSER.declareString(constructorArg(), ACTUAL_FIELD);
+        PARSER.declareString(constructorArg(), PREDICTED_FIELD);
+        PARSER.declareNamedObjects(
+            optionalConstructorArg(), (p, c, n) -> p.namedObject(EvaluationMetric.class, registeredMetricName(NAME, n), c), METRICS);
     }
 
     public static Classification fromXContent(XContentParser parser) {
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetric.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetric.java
new file mode 100644
index 0000000000000..8eff7986dcc36
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetric.java
@@ -0,0 +1,201 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.client.ml.dataframe.evaluation.EvaluationMetric;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
+/**
+ * {@link PrecisionMetric} is a metric that answers the question:
+ *   "What fraction of documents classified as X actually belongs to X?"
+ * for any given class X
+ *
+ * equation: precision(X) = TP(X) / (TP(X) + FP(X))
+ * where: TP(X) - number of true positives wrt X
+ *        FP(X) - number of false positives wrt X
+ */
+public class PrecisionMetric implements EvaluationMetric {
+
+    public static final String NAME = "precision";
+
+    private static final ObjectParser<PrecisionMetric, Void> PARSER = new ObjectParser<>(NAME, true, PrecisionMetric::new);
+
+    public static PrecisionMetric fromXContent(XContentParser parser) {
+        return PARSER.apply(parser, null);
+    }
+
+    public PrecisionMetric() {}
+
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        return true;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(NAME);
+    }
+
+    public static class Result implements EvaluationMetric.Result {
+
+        private static final ParseField CLASSES = new ParseField("classes");
+        private static final ParseField AVG_PRECISION = new ParseField("avg_precision");
+
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<Result, Void> PARSER =
+            new ConstructingObjectParser<>("precision_result", true, a -> new Result((List<PerClassResult>) a[0], (double) a[1]));
+
+        static {
+            PARSER.declareObjectArray(constructorArg(), PerClassResult.PARSER, CLASSES);
+            PARSER.declareDouble(constructorArg(), AVG_PRECISION);
+        }
+
+        public static Result fromXContent(XContentParser parser) {
+            return PARSER.apply(parser, null);
+        }
+
+        /** List of per-class results. */
+        private final List<PerClassResult> classes;
+        /** Average of per-class precisions. */
+        private final double avgPrecision;
+
+        public Result(List<PerClassResult> classes, double avgPrecision) {
+            this.classes = Collections.unmodifiableList(Objects.requireNonNull(classes));
+            this.avgPrecision = avgPrecision;
+        }
+
+        @Override
+        public String getMetricName() {
+            return NAME;
+        }
+
+        public List<PerClassResult> getClasses() {
+            return classes;
+        }
+
+        public double getAvgPrecision() {
+            return avgPrecision;
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(CLASSES.getPreferredName(), classes);
+            builder.field(AVG_PRECISION.getPreferredName(), avgPrecision);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Result that = (Result) o;
+            return Objects.equals(this.classes, that.classes)
+                && this.avgPrecision == that.avgPrecision;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(classes, avgPrecision);
+        }
+    }
+
+    public static class PerClassResult implements ToXContentObject {
+
+        private static final ParseField CLASS_NAME = new ParseField("class_name");
+        private static final ParseField PRECISION = new ParseField("precision");
+
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<PerClassResult, Void> PARSER =
+            new ConstructingObjectParser<>("precision_per_class_result", true, a -> new PerClassResult((String) a[0], (double) a[1]));
+
+        static {
+            PARSER.declareString(constructorArg(), CLASS_NAME);
+            PARSER.declareDouble(constructorArg(), PRECISION);
+        }
+
+        /** Name of the class. */
+        private final String className;
+        /** Fraction of documents predicted as belonging to the {@code predictedClass} class predicted correctly. */
+        private final double precision;
+
+        public PerClassResult(String className, double precision) {
+            this.className = Objects.requireNonNull(className);
+            this.precision = precision;
+        }
+
+        public String getClassName() {
+            return className;
+        }
+
+        public double getPrecision() {
+            return precision;
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(CLASS_NAME.getPreferredName(), className);
+            builder.field(PRECISION.getPreferredName(), precision);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            PerClassResult that = (PerClassResult) o;
+            return Objects.equals(this.className, that.className)
+                && this.precision == that.precision;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(className, precision);
+        }
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetric.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetric.java
new file mode 100644
index 0000000000000..d46a70da8c3f6
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetric.java
@@ -0,0 +1,201 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.client.ml.dataframe.evaluation.EvaluationMetric;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
+/**
+ * {@link RecallMetric} is a metric that answers the question:
+ *   "What fraction of documents belonging to X have been predicted as X by the classifier?"
+ * for any given class X
+ *
+ * equation: recall(X) = TP(X) / (TP(X) + FN(X))
+ * where: TP(X) - number of true positives wrt X
+ *        FN(X) - number of false negatives wrt X
+ */
+public class RecallMetric implements EvaluationMetric {
+
+    public static final String NAME = "recall";
+
+    private static final ObjectParser<RecallMetric, Void> PARSER = new ObjectParser<>(NAME, true, RecallMetric::new);
+
+    public static RecallMetric fromXContent(XContentParser parser) {
+        return PARSER.apply(parser, null);
+    }
+
+    public RecallMetric() {}
+
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        return true;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(NAME);
+    }
+
+    public static class Result implements EvaluationMetric.Result {
+
+        private static final ParseField CLASSES = new ParseField("classes");
+        private static final ParseField AVG_RECALL = new ParseField("avg_recall");
+
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<Result, Void> PARSER =
+            new ConstructingObjectParser<>("recall_result", true, a -> new Result((List<PerClassResult>) a[0], (double) a[1]));
+
+        static {
+            PARSER.declareObjectArray(constructorArg(), PerClassResult.PARSER, CLASSES);
+            PARSER.declareDouble(constructorArg(), AVG_RECALL);
+        }
+
+        public static Result fromXContent(XContentParser parser) {
+            return PARSER.apply(parser, null);
+        }
+
+        /** List of per-class results. */
+        private final List<PerClassResult> classes;
+        /** Average of per-class recalls. */
+        private final double avgRecall;
+
+        public Result(List<PerClassResult> classes, double avgRecall) {
+            this.classes = Collections.unmodifiableList(Objects.requireNonNull(classes));
+            this.avgRecall = avgRecall;
+        }
+
+        @Override
+        public String getMetricName() {
+            return NAME;
+        }
+
+        public List<PerClassResult> getClasses() {
+            return classes;
+        }
+
+        public double getAvgRecall() {
+            return avgRecall;
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(CLASSES.getPreferredName(), classes);
+            builder.field(AVG_RECALL.getPreferredName(), avgRecall);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Result that = (Result) o;
+            return Objects.equals(this.classes, that.classes)
+                && this.avgRecall == that.avgRecall;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(classes, avgRecall);
+        }
+    }
+
+    public static class PerClassResult implements ToXContentObject {
+
+        private static final ParseField CLASS_NAME = new ParseField("class_name");
+        private static final ParseField RECALL = new ParseField("recall");
+
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<PerClassResult, Void> PARSER =
+            new ConstructingObjectParser<>("recall_per_class_result", true, a -> new PerClassResult((String) a[0], (double) a[1]));
+
+        static {
+            PARSER.declareString(constructorArg(), CLASS_NAME);
+            PARSER.declareDouble(constructorArg(), RECALL);
+        }
+
+        /** Name of the class. */
+        private final String className;
+        /** Fraction of documents actually belonging to the {@code actualClass} class predicted correctly. */
+        private final double recall;
+
+        public PerClassResult(String className, double recall) {
+            this.className = Objects.requireNonNull(className);
+            this.recall = recall;
+        }
+
+        public String getClassName() {
+            return className;
+        }
+
+        public double getRecall() {
+            return recall;
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(CLASS_NAME.getPreferredName(), className);
+            builder.field(RECALL.getPreferredName(), recall);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            PerClassResult that = (PerClassResult) o;
+            return Objects.equals(this.className, that.className)
+                && this.recall == that.recall;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(className, recall);
+        }
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/regression/Regression.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/regression/Regression.java
index 79b9ab6eb1dd5..1d8b5bcdb0902 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/regression/Regression.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/regression/Regression.java
@@ -33,6 +33,10 @@
 import java.util.List;
 import java.util.Objects;
 
+import static org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
+
 /**
  * Evaluation of regression results.
  */
@@ -49,10 +53,10 @@ public class Regression implements Evaluation {
         NAME, true, a -> new Regression((String) a[0], (String) a[1], (List<EvaluationMetric>) a[2]));
 
     static {
-        PARSER.declareString(ConstructingObjectParser.constructorArg(), ACTUAL_FIELD);
-        PARSER.declareString(ConstructingObjectParser.constructorArg(), PREDICTED_FIELD);
-        PARSER.declareNamedObjects(ConstructingObjectParser.optionalConstructorArg(),
-            (p, c, n) -> p.namedObject(EvaluationMetric.class, n, c), METRICS);
+        PARSER.declareString(constructorArg(), ACTUAL_FIELD);
+        PARSER.declareString(constructorArg(), PREDICTED_FIELD);
+        PARSER.declareNamedObjects(
+            optionalConstructorArg(), (p, c, n) -> p.namedObject(EvaluationMetric.class, registeredMetricName(NAME, n), c), METRICS);
     }
 
     public static Regression fromXContent(XContentParser parser) {
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/BinarySoftClassification.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/BinarySoftClassification.java
index cb531c6ab044a..b75af7cec11f6 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/BinarySoftClassification.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/softclassification/BinarySoftClassification.java
@@ -33,6 +33,7 @@
 import java.util.List;
 import java.util.Objects;
 
+import static org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
 
@@ -59,7 +60,8 @@ public class BinarySoftClassification implements Evaluation {
     static {
         PARSER.declareString(constructorArg(), ACTUAL_FIELD);
         PARSER.declareString(constructorArg(), PREDICTED_PROBABILITY_FIELD);
-        PARSER.declareNamedObjects(optionalConstructorArg(), (p, c, n) -> p.namedObject(EvaluationMetric.class, n, null), METRICS);
+        PARSER.declareNamedObjects(
+            optionalConstructorArg(), (p, c, n) -> p.namedObject(EvaluationMetric.class, registeredMetricName(NAME, n), null), METRICS);
     }
 
     public static BinarySoftClassification fromXContent(XContentParser parser) {
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index 29e69c5095cbd..4aee48dff13a5 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -1830,6 +1830,70 @@ public void testEvaluateDataFrame_Classification() throws IOException {
                         new AccuracyMetric.ActualClass("ant", 1, 0.0))));
             assertThat(accuracyResult.getOverallAccuracy(), equalTo(0.6));  // 6 out of 10 examples were classified correctly
         }
+        {  // Precision
+            EvaluateDataFrameRequest evaluateDataFrameRequest =
+                new EvaluateDataFrameRequest(
+                    indexName,
+                    null,
+                    new Classification(
+                        actualClassField,
+                        predictedClassField,
+                        new org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric()));
+
+            EvaluateDataFrameResponse evaluateDataFrameResponse =
+                execute(evaluateDataFrameRequest, machineLearningClient::evaluateDataFrame, machineLearningClient::evaluateDataFrameAsync);
+            assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME));
+            assertThat(evaluateDataFrameResponse.getMetrics().size(), equalTo(1));
+
+            org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.Result precisionResult =
+                evaluateDataFrameResponse.getMetricByName(
+                    org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.NAME);
+            assertThat(
+                precisionResult.getMetricName(),
+                equalTo(org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.NAME));
+            assertThat(
+                precisionResult.getClasses(),
+                equalTo(
+                    List.of(
+                        // 3 out of 5 examples labeled as "cat" were classified correctly
+                        new org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.PerClassResult("cat", 0.6),
+                        // 3 out of 4 examples labeled as "dog" were classified correctly
+                        new org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.PerClassResult("dog", 0.75))));
+            assertThat(precisionResult.getAvgPrecision(), equalTo(0.675));
+        }
+        {  // Recall
+            EvaluateDataFrameRequest evaluateDataFrameRequest =
+                new EvaluateDataFrameRequest(
+                    indexName,
+                    null,
+                    new Classification(
+                        actualClassField,
+                        predictedClassField,
+                        new org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric()));
+
+            EvaluateDataFrameResponse evaluateDataFrameResponse =
+                execute(evaluateDataFrameRequest, machineLearningClient::evaluateDataFrame, machineLearningClient::evaluateDataFrameAsync);
+            assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME));
+            assertThat(evaluateDataFrameResponse.getMetrics().size(), equalTo(1));
+
+            org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.Result recallResult =
+                evaluateDataFrameResponse.getMetricByName(
+                    org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.NAME);
+            assertThat(
+                recallResult.getMetricName(),
+                equalTo(org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.NAME));
+            assertThat(
+                recallResult.getClasses(),
+                equalTo(
+                    List.of(
+                        // 3 out of 5 examples labeled as "cat" were classified correctly
+                        new org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.PerClassResult("cat", 0.6),
+                        // 3 out of 4 examples labeled as "dog" were classified correctly
+                        new org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.PerClassResult("dog", 0.75),
+                        // no examples labeled as "ant" were classified correctly
+                        new org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.PerClassResult("ant", 0.0))));
+            assertThat(recallResult.getAvgRecall(), equalTo(0.45));
+        }
         {  // No size provided for MulticlassConfusionMatrixMetric, default used instead
             EvaluateDataFrameRequest evaluateDataFrameRequest =
                 new EvaluateDataFrameRequest(
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
index 3135239530199..4039ec251d335 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
@@ -128,6 +128,7 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
+import static org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
 import static org.elasticsearch.common.xcontent.XContentHelper.toXContent;
 import static org.hamcrest.CoreMatchers.endsWith;
 import static org.hamcrest.CoreMatchers.equalTo;
@@ -688,7 +689,7 @@ public void testDefaultNamedXContents() {
 
     public void testProvidedNamedXContents() {
         List<NamedXContentRegistry.Entry> namedXContents = RestHighLevelClient.getProvidedNamedXContents();
-        assertEquals(51, namedXContents.size());
+        assertEquals(55, namedXContents.size());
         Map<Class<?>, Integer> categories = new HashMap<>();
         List<String> names = new ArrayList<>();
         for (NamedXContentRegistry.Entry namedXContent : namedXContents) {
@@ -730,26 +731,36 @@ public void testProvidedNamedXContents() {
         assertTrue(names.contains(TimeSyncConfig.NAME));
         assertEquals(Integer.valueOf(3), categories.get(org.elasticsearch.client.ml.dataframe.evaluation.Evaluation.class));
         assertThat(names, hasItems(BinarySoftClassification.NAME, Classification.NAME, Regression.NAME));
-        assertEquals(Integer.valueOf(8), categories.get(org.elasticsearch.client.ml.dataframe.evaluation.EvaluationMetric.class));
+        assertEquals(Integer.valueOf(10), categories.get(org.elasticsearch.client.ml.dataframe.evaluation.EvaluationMetric.class));
         assertThat(names,
-            hasItems(AucRocMetric.NAME,
-                PrecisionMetric.NAME,
-                RecallMetric.NAME,
-                ConfusionMatrixMetric.NAME,
-                AccuracyMetric.NAME,
-                MulticlassConfusionMatrixMetric.NAME,
-                MeanSquaredErrorMetric.NAME,
-                RSquaredMetric.NAME));
-        assertEquals(Integer.valueOf(8), categories.get(org.elasticsearch.client.ml.dataframe.evaluation.EvaluationMetric.Result.class));
+            hasItems(
+                registeredMetricName(BinarySoftClassification.NAME, AucRocMetric.NAME),
+                registeredMetricName(BinarySoftClassification.NAME, PrecisionMetric.NAME),
+                registeredMetricName(BinarySoftClassification.NAME, RecallMetric.NAME),
+                registeredMetricName(BinarySoftClassification.NAME, ConfusionMatrixMetric.NAME),
+                registeredMetricName(Classification.NAME, AccuracyMetric.NAME),
+                registeredMetricName(
+                    Classification.NAME, org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.NAME),
+                registeredMetricName(
+                    Classification.NAME, org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.NAME),
+                registeredMetricName(Classification.NAME, MulticlassConfusionMatrixMetric.NAME),
+                registeredMetricName(Regression.NAME, MeanSquaredErrorMetric.NAME),
+                registeredMetricName(Regression.NAME, RSquaredMetric.NAME)));
+        assertEquals(Integer.valueOf(10), categories.get(org.elasticsearch.client.ml.dataframe.evaluation.EvaluationMetric.Result.class));
         assertThat(names,
-            hasItems(AucRocMetric.NAME,
-                PrecisionMetric.NAME,
-                RecallMetric.NAME,
-                ConfusionMatrixMetric.NAME,
-                AccuracyMetric.NAME,
-                MulticlassConfusionMatrixMetric.NAME,
-                MeanSquaredErrorMetric.NAME,
-                RSquaredMetric.NAME));
+            hasItems(
+                registeredMetricName(BinarySoftClassification.NAME, AucRocMetric.NAME),
+                registeredMetricName(BinarySoftClassification.NAME, PrecisionMetric.NAME),
+                registeredMetricName(BinarySoftClassification.NAME, RecallMetric.NAME),
+                registeredMetricName(BinarySoftClassification.NAME, ConfusionMatrixMetric.NAME),
+                registeredMetricName(Classification.NAME, AccuracyMetric.NAME),
+                registeredMetricName(
+                    Classification.NAME, org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.NAME),
+                registeredMetricName(
+                    Classification.NAME, org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.NAME),
+                registeredMetricName(Classification.NAME, MulticlassConfusionMatrixMetric.NAME),
+                registeredMetricName(Regression.NAME, MeanSquaredErrorMetric.NAME),
+                registeredMetricName(Regression.NAME, RSquaredMetric.NAME)));
         assertEquals(Integer.valueOf(3), categories.get(org.elasticsearch.client.ml.inference.preprocessing.PreProcessor.class));
         assertThat(names, hasItems(FrequencyEncoding.NAME, OneHotEncoding.NAME, TargetMeanEncoding.NAME));
         assertEquals(Integer.valueOf(2), categories.get(org.elasticsearch.client.ml.inference.trainedmodel.TrainedModel.class));
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
index 13185e221633b..12fea5f5c5658 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
@@ -3372,7 +3372,9 @@ public void testEvaluateDataFrame_Classification() throws Exception {
                     "predicted_class", // <3>
                     // Evaluation metrics // <4>
                     new AccuracyMetric(), // <5>
-                    new MulticlassConfusionMatrixMetric(3)); // <6>
+                    new org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric(), // <6>
+                    new org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric(), // <7>
+                    new MulticlassConfusionMatrixMetric(3)); // <8>
             // end::evaluate-data-frame-evaluation-classification
 
             EvaluateDataFrameRequest request = new EvaluateDataFrameRequest(indexName, null, evaluation);
@@ -3382,16 +3384,34 @@ public void testEvaluateDataFrame_Classification() throws Exception {
             AccuracyMetric.Result accuracyResult = response.getMetricByName(AccuracyMetric.NAME); // <1>
             double accuracy = accuracyResult.getOverallAccuracy(); // <2>
 
+            org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.Result precisionResult =
+                response.getMetricByName(org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.NAME); // <3>
+            double precision = precisionResult.getAvgPrecision(); // <4>
+
+            org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.Result recallResult =
+                response.getMetricByName(org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.NAME); // <5>
+            double recall = recallResult.getAvgRecall(); // <6>
+
             MulticlassConfusionMatrixMetric.Result multiclassConfusionMatrix =
-                response.getMetricByName(MulticlassConfusionMatrixMetric.NAME); // <3>
+                response.getMetricByName(MulticlassConfusionMatrixMetric.NAME); // <7>
 
-            List<ActualClass> confusionMatrix = multiclassConfusionMatrix.getConfusionMatrix(); // <4>
-            long otherClassesCount = multiclassConfusionMatrix.getOtherActualClassCount(); // <5>
+            List<ActualClass> confusionMatrix = multiclassConfusionMatrix.getConfusionMatrix(); // <8>
+            long otherClassesCount = multiclassConfusionMatrix.getOtherActualClassCount(); // <9>
             // end::evaluate-data-frame-results-classification
 
             assertThat(accuracyResult.getMetricName(), equalTo(AccuracyMetric.NAME));
             assertThat(accuracy, equalTo(0.6));
 
+            assertThat(
+                precisionResult.getMetricName(),
+                equalTo(org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.NAME));
+            assertThat(precision, equalTo(0.675));
+
+            assertThat(
+                recallResult.getMetricName(),
+                equalTo(org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.NAME));
+            assertThat(recall, equalTo(0.45));
+
             assertThat(multiclassConfusionMatrix.getMetricName(), equalTo(MulticlassConfusionMatrixMetric.NAME));
             assertThat(
                 confusionMatrix,
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/EvaluateDataFrameResponseTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/EvaluateDataFrameResponseTests.java
index f6b7459b1043b..92d3ab81bce47 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/EvaluateDataFrameResponseTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/EvaluateDataFrameResponseTests.java
@@ -64,6 +64,8 @@ public static EvaluateDataFrameResponse randomResponse() {
                 metrics = randomSubsetOf(
                     Arrays.asList(
                         AccuracyMetricResultTests.randomResult(),
+                        org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetricResultTests.randomResult(),
+                        org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetricResultTests.randomResult(),
                         MulticlassConfusionMatrixMetricResultTests.randomResult()));
                 break;
             default:
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/ClassificationTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/ClassificationTests.java
index acb6f21cb8209..81691fcbb2eed 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/ClassificationTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/ClassificationTests.java
@@ -41,6 +41,8 @@ static Classification createRandom() {
             randomSubsetOf(
                 Arrays.asList(
                     AccuracyMetricTests.createRandom(),
+                    PrecisionMetricTests.createRandom(),
+                    RecallMetricTests.createRandom(),
                     MulticlassConfusionMatrixMetricTests.createRandom()));
         return new Classification(randomAlphaOfLength(10), randomAlphaOfLength(10), metrics.isEmpty() ? null : metrics);
     }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetricResultTests.java
new file mode 100644
index 0000000000000..ef6e41e78f0e8
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetricResultTests.java
@@ -0,0 +1,67 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.PerClassResult;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.PrecisionMetric.Result;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+public class PrecisionMetricResultTests extends AbstractXContentTestCase<Result> {
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlEvaluationNamedXContentProvider().getNamedXContentParsers());
+    }
+
+    public static Result randomResult() {
+        int numClasses = randomIntBetween(2, 100);
+        List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
+        List<PerClassResult> classes = new ArrayList<>(numClasses);
+        for (int i = 0; i < numClasses; i++) {
+            double precision = randomDoubleBetween(0.0, 1.0, true);
+            classes.add(new PerClassResult(classNames.get(i), precision));
+        }
+        double avgPrecision = randomDoubleBetween(0.0, 1.0, true);
+        return new Result(classes, avgPrecision);
+    }
+
+    @Override
+    protected Result createTestInstance() {
+        return randomResult();
+    }
+
+    @Override
+    protected Result doParseInstance(XContentParser parser) throws IOException {
+        return Result.fromXContent(parser);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetricTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetricTests.java
new file mode 100644
index 0000000000000..7e21be190d938
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/PrecisionMetricTests.java
@@ -0,0 +1,53 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+
+import java.io.IOException;
+
+public class PrecisionMetricTests extends AbstractXContentTestCase<PrecisionMetric> {
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlEvaluationNamedXContentProvider().getNamedXContentParsers());
+    }
+
+    static PrecisionMetric createRandom() {
+        return new PrecisionMetric();
+    }
+
+    @Override
+    protected PrecisionMetric createTestInstance() {
+        return createRandom();
+    }
+
+    @Override
+    protected PrecisionMetric doParseInstance(XContentParser parser) throws IOException {
+        return PrecisionMetric.fromXContent(parser);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetricResultTests.java
new file mode 100644
index 0000000000000..f8fffb405ea1b
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetricResultTests.java
@@ -0,0 +1,67 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.PerClassResult;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.RecallMetric.Result;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+public class RecallMetricResultTests extends AbstractXContentTestCase<Result> {
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlEvaluationNamedXContentProvider().getNamedXContentParsers());
+    }
+
+    public static Result randomResult() {
+        int numClasses = randomIntBetween(2, 100);
+        List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
+        List<PerClassResult> classes = new ArrayList<>(numClasses);
+        for (int i = 0; i < numClasses; i++) {
+            double recall = randomDoubleBetween(0.0, 1.0, true);
+            classes.add(new PerClassResult(classNames.get(i), recall));
+        }
+        double avgRecall = randomDoubleBetween(0.0, 1.0, true);
+        return new Result(classes, avgRecall);
+    }
+
+    @Override
+    protected Result createTestInstance() {
+        return randomResult();
+    }
+
+    @Override
+    protected Result doParseInstance(XContentParser parser) throws IOException {
+        return Result.fromXContent(parser);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetricTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetricTests.java
new file mode 100644
index 0000000000000..087f9838aaf3e
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/RecallMetricTests.java
@@ -0,0 +1,53 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+
+import java.io.IOException;
+
+public class RecallMetricTests extends AbstractXContentTestCase<RecallMetric> {
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlEvaluationNamedXContentProvider().getNamedXContentParsers());
+    }
+
+    static RecallMetric createRandom() {
+        return new RecallMetric();
+    }
+
+    @Override
+    protected RecallMetric createTestInstance() {
+        return createRandom();
+    }
+
+    @Override
+    protected RecallMetric doParseInstance(XContentParser parser) throws IOException {
+        return RecallMetric.fromXContent(parser);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+}
diff --git a/docs/java-rest/high-level/ml/evaluate-data-frame.asciidoc b/docs/java-rest/high-level/ml/evaluate-data-frame.asciidoc
index b4abafa249ee0..57a82d1c7132f 100644
--- a/docs/java-rest/high-level/ml/evaluate-data-frame.asciidoc
+++ b/docs/java-rest/high-level/ml/evaluate-data-frame.asciidoc
@@ -53,7 +53,9 @@ include-tagged::{doc-tests-file}[{api}-evaluation-classification]
 <3> Name of the field in the index. Its value denotes the predicted (as per some ML algorithm) class of the example.
 <4> The remaining parameters are the metrics to be calculated based on the two fields described above
 <5> Accuracy
-<6> Multiclass confusion matrix of size 3
+<6> Precision
+<7> Recall
+<8> Multiclass confusion matrix of size 3
 
 ===== Regression
 
@@ -104,9 +106,13 @@ include-tagged::{doc-tests-file}[{api}-results-classification]
 
 <1> Fetching accuracy metric by name
 <2> Fetching the actual accuracy value
-<3> Fetching multiclass confusion matrix metric by name
-<4> Fetching the contents of the confusion matrix
-<5> Fetching the number of classes that were not included in the matrix
+<3> Fetching precision metric by name
+<4> Fetching the actual precision value
+<5> Fetching recall metric by name
+<6> Fetching the actual recall value
+<7> Fetching multiclass confusion matrix metric by name
+<8> Fetching the contents of the confusion matrix
+<9> Fetching the number of classes that were not included in the matrix
 
 ===== Regression
 
@@ -118,4 +124,4 @@ include-tagged::{doc-tests-file}[{api}-results-regression]
 <1> Fetching mean squared error metric by name
 <2> Fetching the actual mean squared error value
 <3> Fetching R squared metric by name
-<4> Fetching the actual R squared value
\ No newline at end of file
+<4> Fetching the actual R squared value
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
index 9128f75a0937b..06bc4182cabfd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
@@ -68,7 +68,6 @@
 import org.elasticsearch.xpack.core.ml.MlMetadata;
 import org.elasticsearch.xpack.core.ml.MlTasks;
 import org.elasticsearch.xpack.core.ml.action.CloseJobAction;
-import org.elasticsearch.xpack.core.ml.action.ExplainDataFrameAnalyticsAction;
 import org.elasticsearch.xpack.core.ml.action.DeleteCalendarAction;
 import org.elasticsearch.xpack.core.ml.action.DeleteCalendarEventAction;
 import org.elasticsearch.xpack.core.ml.action.DeleteDataFrameAnalyticsAction;
@@ -80,6 +79,7 @@
 import org.elasticsearch.xpack.core.ml.action.DeleteModelSnapshotAction;
 import org.elasticsearch.xpack.core.ml.action.DeleteTrainedModelAction;
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction;
+import org.elasticsearch.xpack.core.ml.action.ExplainDataFrameAnalyticsAction;
 import org.elasticsearch.xpack.core.ml.action.FinalizeJobExecutionAction;
 import org.elasticsearch.xpack.core.ml.action.FindFileStructureAction;
 import org.elasticsearch.xpack.core.ml.action.FlushJobAction;
@@ -134,15 +134,7 @@
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.DataFrameAnalysis;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.OutlierDetection;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.Evaluation;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.AucRoc;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.BinarySoftClassification;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.ConfusionMatrix;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.Precision;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.Recall;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.ScoreByThresholdResult;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.SoftClassificationMetric;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.FrequencyEncoding;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.OneHotEncoding;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.PreProcessor;
@@ -245,6 +237,9 @@
 import java.util.Arrays;
 import java.util.List;
 import java.util.Optional;
+import java.util.stream.Stream;
+
+import static java.util.stream.Collectors.toList;
 
 // TODO: merge this into XPackPlugin
 public class XPackClientPlugin extends Plugin implements ActionPlugin, NetworkPlugin {
@@ -426,7 +421,8 @@ public List<ActionType<? extends ActionResponse>> getClientActions() {
 
     @Override
     public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
-        return Arrays.asList(
+        return Stream.concat(
+            Arrays.asList(
                 // graph
                 new NamedWriteableRegistry.Entry(XPackFeatureSet.Usage.class, XPackField.GRAPH, GraphFeatureSetUsage::new),
                 // logstash
@@ -454,18 +450,6 @@ public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
                 new NamedWriteableRegistry.Entry(DataFrameAnalysis.class, OutlierDetection.NAME.getPreferredName(), OutlierDetection::new),
                 new NamedWriteableRegistry.Entry(DataFrameAnalysis.class, Regression.NAME.getPreferredName(), Regression::new),
                 new NamedWriteableRegistry.Entry(DataFrameAnalysis.class, Classification.NAME.getPreferredName(), Classification::new),
-                // ML - Data frame evaluation
-                new NamedWriteableRegistry.Entry(Evaluation.class, BinarySoftClassification.NAME.getPreferredName(),
-                        BinarySoftClassification::new),
-                new NamedWriteableRegistry.Entry(SoftClassificationMetric.class, AucRoc.NAME.getPreferredName(), AucRoc::new),
-                new NamedWriteableRegistry.Entry(SoftClassificationMetric.class, Precision.NAME.getPreferredName(), Precision::new),
-                new NamedWriteableRegistry.Entry(SoftClassificationMetric.class, Recall.NAME.getPreferredName(), Recall::new),
-                new NamedWriteableRegistry.Entry(SoftClassificationMetric.class, ConfusionMatrix.NAME.getPreferredName(),
-                        ConfusionMatrix::new),
-                new NamedWriteableRegistry.Entry(EvaluationMetricResult.class, AucRoc.NAME.getPreferredName(), AucRoc.Result::new),
-                new NamedWriteableRegistry.Entry(EvaluationMetricResult.class, ScoreByThresholdResult.NAME, ScoreByThresholdResult::new),
-                new NamedWriteableRegistry.Entry(EvaluationMetricResult.class, ConfusionMatrix.NAME.getPreferredName(),
-                        ConfusionMatrix.Result::new),
                 // ML - Inference preprocessing
                 new NamedWriteableRegistry.Entry(PreProcessor.class, FrequencyEncoding.NAME.getPreferredName(), FrequencyEncoding::new),
                 new NamedWriteableRegistry.Entry(PreProcessor.class, OneHotEncoding.NAME.getPreferredName(), OneHotEncoding::new),
@@ -568,7 +552,9 @@ public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
                 new NamedWriteableRegistry.Entry(XPackFeatureSet.Usage.class, XPackField.SPATIAL, SpatialFeatureSetUsage::new),
                 // data science
                 new NamedWriteableRegistry.Entry(XPackFeatureSet.Usage.class, XPackField.ANALYTICS, AnalyticsFeatureSetUsage::new)
-        );
+            ).stream(),
+            MlEvaluationNamedXContentProvider.getNamedWriteables().stream()
+        ).collect(toList());
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/Evaluation.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/Evaluation.java
index 98888c539c189..1a79dff41e10c 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/Evaluation.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/Evaluation.java
@@ -7,12 +7,14 @@
 
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.index.query.BoolQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
@@ -76,8 +78,9 @@ default SearchSourceBuilder buildSearch(QueryBuilder userProvidedQueryBuilder) {
         SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder().size(0).query(boolQuery);
         for (EvaluationMetric metric : getMetrics()) {
             // Fetch aggregations requested by individual metrics
-            List<AggregationBuilder> aggs = metric.aggs(getActualField(), getPredictedField());
-            aggs.forEach(searchSourceBuilder::aggregation);
+            Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs = metric.aggs(getActualField(), getPredictedField());
+            aggs.v1().forEach(searchSourceBuilder::aggregation);
+            aggs.v2().forEach(searchSourceBuilder::aggregation);
         }
         return searchSourceBuilder;
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/EvaluationMetric.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/EvaluationMetric.java
index 7a539d030dd44..36bf7634cb43f 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/EvaluationMetric.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/EvaluationMetric.java
@@ -6,10 +6,12 @@
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation;
 
 import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 
 import java.util.List;
 import java.util.Optional;
@@ -30,7 +32,7 @@ public interface EvaluationMetric extends ToXContentObject, NamedWriteable {
      * @param predictedField the field that stores the predicted value (class name or probability)
      * @return the aggregations required to compute the metric
      */
-    List<AggregationBuilder> aggs(String actualField, String predictedField);
+    Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField);
 
     /**
      * Processes given aggregations as a step towards computing result
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/MlEvaluationNamedXContentProvider.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/MlEvaluationNamedXContentProvider.java
index 1ef8b89a99609..42e530a7a602d 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/MlEvaluationNamedXContentProvider.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/MlEvaluationNamedXContentProvider.java
@@ -5,109 +5,179 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation;
 
+import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.plugins.spi.NamedXContentProvider;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Classification;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.ClassificationMetric;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression.MeanSquaredError;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression.MeanSquaredError;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression.RSquared;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression.Regression;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression.RegressionMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.AucRoc;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.BinarySoftClassification;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.ConfusionMatrix;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.Precision;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.Recall;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.ScoreByThresholdResult;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.SoftClassificationMetric;
 
-import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.List;
 
 public class MlEvaluationNamedXContentProvider implements NamedXContentProvider {
 
-    @Override
-    public List<NamedXContentRegistry.Entry> getNamedXContentParsers() {
-        List<NamedXContentRegistry.Entry> namedXContent = new ArrayList<>();
+    /**
+     * Constructs the name under which a metric (or metric result) is registered.
+     * The name is prefixed with evaluation name so that registered names are unique.
+     *
+     * @param evaluationName name of the evaluation
+     * @param metricName name of the metric
+     * @return name appropriate for registering a metric (or metric result) in {@link NamedXContentRegistry}
+     */
+    public static String registeredMetricName(ParseField evaluationName, ParseField metricName) {
+        return registeredMetricName(evaluationName.getPreferredName(), metricName.getPreferredName());
+    }
 
-        // Evaluations
-        namedXContent.add(new NamedXContentRegistry.Entry(Evaluation.class, BinarySoftClassification.NAME,
-            BinarySoftClassification::fromXContent));
-        namedXContent.add(new NamedXContentRegistry.Entry(Evaluation.class, Classification.NAME, Classification::fromXContent));
-        namedXContent.add(new NamedXContentRegistry.Entry(Evaluation.class, Regression.NAME, Regression::fromXContent));
+    /**
+     * Constructs the name under which a metric (or metric result) is registered.
+     * The name is prefixed with evaluation name so that registered names are unique.
+     *
+     * @param evaluationName name of the evaluation
+     * @param metricName name of the metric
+     * @return name appropriate for registering a metric (or metric result) in {@link NamedXContentRegistry}
+     */
+    public static String registeredMetricName(String evaluationName, String metricName) {
+        return evaluationName + "." +  metricName;
+    }
 
-        // Soft classification metrics
-        namedXContent.add(new NamedXContentRegistry.Entry(SoftClassificationMetric.class, AucRoc.NAME, AucRoc::fromXContent));
-        namedXContent.add(new NamedXContentRegistry.Entry(SoftClassificationMetric.class, Precision.NAME, Precision::fromXContent));
-        namedXContent.add(new NamedXContentRegistry.Entry(SoftClassificationMetric.class, Recall.NAME, Recall::fromXContent));
-        namedXContent.add(new NamedXContentRegistry.Entry(SoftClassificationMetric.class, ConfusionMatrix.NAME,
-            ConfusionMatrix::fromXContent));
+    @Override
+    public List<NamedXContentRegistry.Entry> getNamedXContentParsers() {
+        return Arrays.asList(
+            // Evaluations
+            new NamedXContentRegistry.Entry(Evaluation.class, BinarySoftClassification.NAME, BinarySoftClassification::fromXContent),
+            new NamedXContentRegistry.Entry(Evaluation.class, Classification.NAME, Classification::fromXContent),
+            new NamedXContentRegistry.Entry(Evaluation.class, Regression.NAME, Regression::fromXContent),
 
-        // Classification metrics
-        namedXContent.add(new NamedXContentRegistry.Entry(ClassificationMetric.class, MulticlassConfusionMatrix.NAME,
-            MulticlassConfusionMatrix::fromXContent));
-        namedXContent.add(new NamedXContentRegistry.Entry(ClassificationMetric.class, Accuracy.NAME, Accuracy::fromXContent));
+            // Soft classification metrics
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, AucRoc.NAME)),
+                AucRoc::fromXContent),
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, Precision.NAME)),
+                Precision::fromXContent),
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, Recall.NAME)),
+                Recall::fromXContent),
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(registeredMetricName(BinarySoftClassification.NAME, ConfusionMatrix.NAME)),
+                ConfusionMatrix::fromXContent),
 
-        // Regression metrics
-        namedXContent.add(new NamedXContentRegistry.Entry(RegressionMetric.class, MeanSquaredError.NAME, MeanSquaredError::fromXContent));
-        namedXContent.add(new NamedXContentRegistry.Entry(RegressionMetric.class, RSquared.NAME, RSquared::fromXContent));
+            // Classification metrics
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(registeredMetricName(Classification.NAME, MulticlassConfusionMatrix.NAME)),
+                MulticlassConfusionMatrix::fromXContent),
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(registeredMetricName(Classification.NAME, Accuracy.NAME)),
+                Accuracy::fromXContent),
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(
+                    registeredMetricName(
+                        Classification.NAME, org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision.NAME)),
+                org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision::fromXContent),
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(
+                    registeredMetricName(
+                        Classification.NAME, org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall.NAME)),
+                org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall::fromXContent),
 
-        return namedXContent;
+            // Regression metrics
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(registeredMetricName(Regression.NAME, MeanSquaredError.NAME)),
+                MeanSquaredError::fromXContent),
+            new NamedXContentRegistry.Entry(EvaluationMetric.class,
+                new ParseField(registeredMetricName(Regression.NAME, RSquared.NAME)),
+                RSquared::fromXContent)
+        );
     }
 
-    public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
-        List<NamedWriteableRegistry.Entry> namedWriteables = new ArrayList<>();
-
-        // Evaluations
-        namedWriteables.add(new NamedWriteableRegistry.Entry(Evaluation.class, BinarySoftClassification.NAME.getPreferredName(),
-            BinarySoftClassification::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(Evaluation.class, Classification.NAME.getPreferredName(),
-            Classification::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(Evaluation.class, Regression.NAME.getPreferredName(), Regression::new));
-
-        // Evaluation Metrics
-        namedWriteables.add(new NamedWriteableRegistry.Entry(SoftClassificationMetric.class, AucRoc.NAME.getPreferredName(),
-            AucRoc::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(SoftClassificationMetric.class, Precision.NAME.getPreferredName(),
-            Precision::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(SoftClassificationMetric.class, Recall.NAME.getPreferredName(),
-            Recall::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(SoftClassificationMetric.class, ConfusionMatrix.NAME.getPreferredName(),
-            ConfusionMatrix::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(ClassificationMetric.class,
-            MulticlassConfusionMatrix.NAME.getPreferredName(),
-            MulticlassConfusionMatrix::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(ClassificationMetric.class, Accuracy.NAME.getPreferredName(), Accuracy::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(RegressionMetric.class,
-            MeanSquaredError.NAME.getPreferredName(),
-            MeanSquaredError::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(RegressionMetric.class,
-            RSquared.NAME.getPreferredName(),
-            RSquared::new));
+    public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
+        return Arrays.asList(
+            // Evaluations
+            new NamedWriteableRegistry.Entry(Evaluation.class,
+                BinarySoftClassification.NAME.getPreferredName(),
+                BinarySoftClassification::new),
+            new NamedWriteableRegistry.Entry(Evaluation.class,
+                Classification.NAME.getPreferredName(),
+                Classification::new),
+            new NamedWriteableRegistry.Entry(Evaluation.class,
+                Regression.NAME.getPreferredName(),
+                Regression::new),
 
-        // Evaluation Metrics Results
-        namedWriteables.add(new NamedWriteableRegistry.Entry(EvaluationMetricResult.class, AucRoc.NAME.getPreferredName(),
-            AucRoc.Result::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(EvaluationMetricResult.class, ScoreByThresholdResult.NAME,
-            ScoreByThresholdResult::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(EvaluationMetricResult.class, ConfusionMatrix.NAME.getPreferredName(),
-            ConfusionMatrix.Result::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
-            MulticlassConfusionMatrix.NAME.getPreferredName(),
-            MulticlassConfusionMatrix.Result::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
-            Accuracy.NAME.getPreferredName(),
-            Accuracy.Result::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
-            MeanSquaredError.NAME.getPreferredName(),
-            MeanSquaredError.Result::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
-            RSquared.NAME.getPreferredName(),
-            RSquared.Result::new));
+            // Evaluation metrics
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(BinarySoftClassification.NAME, AucRoc.NAME),
+                AucRoc::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(BinarySoftClassification.NAME, Precision.NAME),
+                Precision::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(BinarySoftClassification.NAME, Recall.NAME),
+                Recall::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(BinarySoftClassification.NAME, ConfusionMatrix.NAME),
+                ConfusionMatrix::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(Classification.NAME, MulticlassConfusionMatrix.NAME),
+                MulticlassConfusionMatrix::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(Classification.NAME, Accuracy.NAME),
+                Accuracy::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(
+                    Classification.NAME, org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision.NAME),
+                org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(
+                    Classification.NAME, org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall.NAME),
+                org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(Regression.NAME, MeanSquaredError.NAME),
+                MeanSquaredError::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetric.class,
+                registeredMetricName(Regression.NAME, RSquared.NAME),
+                RSquared::new),
 
-        return namedWriteables;
+            // Evaluation metrics results
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(BinarySoftClassification.NAME, AucRoc.NAME),
+                AucRoc.Result::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(BinarySoftClassification.NAME, ScoreByThresholdResult.NAME),
+                ScoreByThresholdResult::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(BinarySoftClassification.NAME, ConfusionMatrix.NAME),
+                ConfusionMatrix.Result::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(Classification.NAME, MulticlassConfusionMatrix.NAME),
+                MulticlassConfusionMatrix.Result::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(Classification.NAME, Accuracy.NAME),
+                Accuracy.Result::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(
+                    Classification.NAME, org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision.NAME),
+                org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision.Result::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(
+                    Classification.NAME, org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall.NAME),
+                org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall.Result::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(Regression.NAME, MeanSquaredError.NAME),
+                MeanSquaredError.Result::new),
+            new NamedWriteableRegistry.Entry(EvaluationMetricResult.class,
+                registeredMetricName(Regression.NAME, RSquared.NAME),
+                RSquared.Result::new)
+        );
     }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Accuracy.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Accuracy.java
index d0db9189b0422..8e7b8b6066932 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Accuracy.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Accuracy.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -18,8 +19,10 @@
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.terms.Terms;
 import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
@@ -33,6 +36,7 @@
 import java.util.Optional;
 
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
 
 /**
  * {@link Accuracy} is a metric that answers the question:
@@ -40,7 +44,7 @@
  *
  * equation: accuracy = 1/n * Σ(y == y´)
  */
-public class Accuracy implements ClassificationMetric {
+public class Accuracy implements EvaluationMetric {
 
     public static final ParseField NAME = new ParseField("accuracy");
 
@@ -67,7 +71,7 @@ public Accuracy(StreamInput in) throws IOException {}
 
     @Override
     public String getWriteableName() {
-        return NAME.getPreferredName();
+        return registeredMetricName(Classification.NAME, NAME);
     }
 
     @Override
@@ -76,16 +80,18 @@ public String getName() {
     }
 
     @Override
-    public final List<AggregationBuilder> aggs(String actualField, String predictedField) {
+    public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
         if (result != null) {
-            return List.of();
+            return Tuple.tuple(List.of(), List.of());
         }
         Script accuracyScript = new Script(buildScript(actualField, predictedField));
-        return List.of(
-            AggregationBuilders.terms(CLASSES_AGG_NAME)
-                .field(actualField)
-                .subAggregation(AggregationBuilders.avg(PER_CLASS_ACCURACY_AGG_NAME).script(accuracyScript)),
-            AggregationBuilders.avg(OVERALL_ACCURACY_AGG_NAME).script(accuracyScript));
+        return Tuple.tuple(
+            List.of(
+                AggregationBuilders.terms(CLASSES_AGG_NAME)
+                    .field(actualField)
+                    .subAggregation(AggregationBuilders.avg(PER_CLASS_ACCURACY_AGG_NAME).script(accuracyScript)),
+                AggregationBuilders.avg(OVERALL_ACCURACY_AGG_NAME).script(accuracyScript)),
+            List.of());
     }
 
     @Override
@@ -168,7 +174,7 @@ public Result(StreamInput in) throws IOException {
 
         @Override
         public String getWriteableName() {
-            return NAME.getPreferredName();
+            return registeredMetricName(Classification.NAME, NAME);
         }
 
         @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Classification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Classification.java
index ee312ee7c7fd8..fb8014697555e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Classification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Classification.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.Evaluation;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.io.IOException;
@@ -20,6 +21,8 @@
 import java.util.List;
 import java.util.Objects;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 /**
  * Evaluation of classification results.
  */
@@ -33,13 +36,13 @@ public class Classification implements Evaluation {
 
     @SuppressWarnings("unchecked")
     public static final ConstructingObjectParser<Classification, Void> PARSER = new ConstructingObjectParser<>(
-        NAME.getPreferredName(), a -> new Classification((String) a[0], (String) a[1], (List<ClassificationMetric>) a[2]));
+        NAME.getPreferredName(), a -> new Classification((String) a[0], (String) a[1], (List<EvaluationMetric>) a[2]));
 
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), ACTUAL_FIELD);
         PARSER.declareString(ConstructingObjectParser.constructorArg(), PREDICTED_FIELD);
         PARSER.declareNamedObjects(ConstructingObjectParser.optionalConstructorArg(),
-            (p, c, n) -> p.namedObject(ClassificationMetric.class, n, c), METRICS);
+            (p, c, n) -> p.namedObject(EvaluationMetric.class, registeredMetricName(NAME.getPreferredName(), n), c), METRICS);
     }
 
     public static Classification fromXContent(XContentParser parser) {
@@ -61,22 +64,22 @@ public static Classification fromXContent(XContentParser parser) {
     /**
      * The list of metrics to calculate
      */
-    private final List<ClassificationMetric> metrics;
+    private final List<EvaluationMetric> metrics;
 
-    public Classification(String actualField, String predictedField, @Nullable List<ClassificationMetric> metrics) {
+    public Classification(String actualField, String predictedField, @Nullable List<EvaluationMetric> metrics) {
         this.actualField = ExceptionsHelper.requireNonNull(actualField, ACTUAL_FIELD);
         this.predictedField = ExceptionsHelper.requireNonNull(predictedField, PREDICTED_FIELD);
         this.metrics = initMetrics(metrics, Classification::defaultMetrics);
     }
 
-    private static List<ClassificationMetric> defaultMetrics() {
+    private static List<EvaluationMetric> defaultMetrics() {
         return Arrays.asList(new MulticlassConfusionMatrix());
     }
 
     public Classification(StreamInput in) throws IOException {
         this.actualField = in.readString();
         this.predictedField = in.readString();
-        this.metrics = in.readNamedWriteableList(ClassificationMetric.class);
+        this.metrics = in.readNamedWriteableList(EvaluationMetric.class);
     }
 
     @Override
@@ -95,7 +98,7 @@ public String getPredictedField() {
     }
 
     @Override
-    public List<ClassificationMetric> getMetrics() {
+    public List<EvaluationMetric> getMetrics() {
         return metrics;
     }
 
@@ -118,8 +121,8 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         builder.field(PREDICTED_FIELD.getPreferredName(), predictedField);
 
         builder.startObject(METRICS.getPreferredName());
-        for (ClassificationMetric metric : metrics) {
-            builder.field(metric.getWriteableName(), metric);
+        for (EvaluationMetric metric : metrics) {
+            builder.field(metric.getName(), metric);
         }
         builder.endObject();
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationMetric.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationMetric.java
deleted file mode 100644
index a61ac9a702fa2..0000000000000
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationMetric.java
+++ /dev/null
@@ -1,11 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
-
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
-
-public interface ClassificationMetric extends EvaluationMetric {
-}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
index 1a53b48666a5a..7b9d524abf6f7 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
@@ -7,6 +7,7 @@
 
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -19,10 +20,12 @@
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.Aggregations;
 import org.elasticsearch.search.aggregations.BucketOrder;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.filter.Filters;
 import org.elasticsearch.search.aggregations.bucket.filter.FiltersAggregator.KeyedFilter;
 import org.elasticsearch.search.aggregations.bucket.terms.Terms;
 import org.elasticsearch.search.aggregations.metrics.Cardinality;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
@@ -37,13 +40,14 @@
 import static java.util.Comparator.comparing;
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
 
 /**
  * {@link MulticlassConfusionMatrix} is a metric that answers the question:
- *   "How many examples belonging to class X were classified as Y by the classifier?"
+ *   "How many documents belonging to class X were classified as Y by the classifier?"
  * for all the possible class pairs {X, Y}.
  */
-public class MulticlassConfusionMatrix implements ClassificationMetric {
+public class MulticlassConfusionMatrix implements EvaluationMetric {
 
     public static final ParseField NAME = new ParseField("multiclass_confusion_matrix");
 
@@ -91,7 +95,7 @@ public MulticlassConfusionMatrix(StreamInput in) throws IOException {
 
     @Override
     public String getWriteableName() {
-        return NAME.getPreferredName();
+        return registeredMetricName(Classification.NAME, NAME);
     }
 
     @Override
@@ -104,13 +108,15 @@ public int getSize() {
     }
 
     @Override
-    public final List<AggregationBuilder> aggs(String actualField, String predictedField) {
+    public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
         if (topActualClassNames == null) {  // This is step 1
-            return List.of(
-                AggregationBuilders.terms(STEP_1_AGGREGATE_BY_ACTUAL_CLASS)
-                    .field(actualField)
-                    .order(List.of(BucketOrder.count(false), BucketOrder.key(true)))
-                    .size(size));
+            return Tuple.tuple(
+                List.of(
+                    AggregationBuilders.terms(STEP_1_AGGREGATE_BY_ACTUAL_CLASS)
+                        .field(actualField)
+                        .order(List.of(BucketOrder.count(false), BucketOrder.key(true)))
+                        .size(size)),
+                List.of());
         }
         if (result == null) {  // This is step 2
             KeyedFilter[] keyedFiltersActual =
@@ -121,15 +127,17 @@ public final List<AggregationBuilder> aggs(String actualField, String predictedF
                 topActualClassNames.stream()
                     .map(className -> new KeyedFilter(className, QueryBuilders.termQuery(predictedField, className)))
                     .toArray(KeyedFilter[]::new);
-            return List.of(
-                AggregationBuilders.cardinality(STEP_2_CARDINALITY_OF_ACTUAL_CLASS)
-                    .field(actualField),
-                AggregationBuilders.filters(STEP_2_AGGREGATE_BY_ACTUAL_CLASS, keyedFiltersActual)
-                    .subAggregation(AggregationBuilders.filters(STEP_2_AGGREGATE_BY_PREDICTED_CLASS, keyedFiltersPredicted)
-                        .otherBucket(true)
-                        .otherBucketKey(OTHER_BUCKET_KEY)));
-        }
-        return List.of();
+            return Tuple.tuple(
+                List.of(
+                    AggregationBuilders.cardinality(STEP_2_CARDINALITY_OF_ACTUAL_CLASS)
+                        .field(actualField),
+                    AggregationBuilders.filters(STEP_2_AGGREGATE_BY_ACTUAL_CLASS, keyedFiltersActual)
+                        .subAggregation(AggregationBuilders.filters(STEP_2_AGGREGATE_BY_PREDICTED_CLASS, keyedFiltersPredicted)
+                            .otherBucket(true)
+                            .otherBucketKey(OTHER_BUCKET_KEY))),
+                List.of());
+        }
+        return Tuple.tuple(List.of(), List.of());
     }
 
     @Override
@@ -231,7 +239,7 @@ public Result(StreamInput in) throws IOException {
 
         @Override
         public String getWriteableName() {
-            return NAME.getPreferredName();
+            return registeredMetricName(Classification.NAME, NAME);
         }
 
         @Override
@@ -300,7 +308,7 @@ public static class ActualClass implements ToXContentObject, Writeable {
 
         /** Name of the actual class. */
         private final String actualClass;
-        /** Number of documents (examples) belonging to the {code actualClass} class. */
+        /** Number of documents belonging to the {code actualClass} class. */
         private final long actualClassDocCount;
         /** List of predicted classes. */
         private final List<PredictedClass> predictedClasses;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
new file mode 100644
index 0000000000000..f6bacbec05e7b
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
@@ -0,0 +1,345 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.script.Script;
+import org.elasticsearch.search.aggregations.AggregationBuilder;
+import org.elasticsearch.search.aggregations.AggregationBuilders;
+import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.BucketOrder;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
+import org.elasticsearch.search.aggregations.PipelineAggregatorBuilders;
+import org.elasticsearch.search.aggregations.bucket.filter.Filters;
+import org.elasticsearch.search.aggregations.bucket.filter.FiltersAggregator.KeyedFilter;
+import org.elasticsearch.search.aggregations.bucket.terms.Terms;
+import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
+import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+
+import java.io.IOException;
+import java.text.MessageFormat;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Locale;
+import java.util.Objects;
+import java.util.Optional;
+import java.util.stream.Collectors;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
+/**
+ * {@link Precision} is a metric that answers the question:
+ *   "What fraction of documents classified as X actually belongs to X?"
+ * for any given class X
+ *
+ * equation: precision(X) = TP(X) / (TP(X) + FP(X))
+ * where: TP(X) - number of true positives wrt X
+ *        FP(X) - number of false positives wrt X
+ */
+public class Precision implements EvaluationMetric {
+
+    public static final ParseField NAME = new ParseField("precision");
+
+    private static final String PAINLESS_TEMPLATE = "doc[''{0}''].value == doc[''{1}''].value";
+    private static final String AGG_NAME_PREFIX = "classification_precision_";
+    static final String ACTUAL_CLASSES_NAMES_AGG_NAME = AGG_NAME_PREFIX + "by_actual_class";
+    static final String BY_PREDICTED_CLASS_AGG_NAME = AGG_NAME_PREFIX + "by_predicted_class";
+    static final String PER_PREDICTED_CLASS_PRECISION_AGG_NAME = AGG_NAME_PREFIX + "per_predicted_class_precision";
+    static final String AVG_PRECISION_AGG_NAME = AGG_NAME_PREFIX + "avg_precision";
+
+    private static Script buildScript(Object...args) {
+        return new Script(new MessageFormat(PAINLESS_TEMPLATE, Locale.ROOT).format(args));
+    }
+
+    private static final ObjectParser<Precision, Void> PARSER = new ObjectParser<>(NAME.getPreferredName(), true, Precision::new);
+
+    public static Precision fromXContent(XContentParser parser) {
+        return PARSER.apply(parser, null);
+    }
+
+    private static final int DEFAULT_MAX_CLASSES_CARDINALITY = 1000;
+
+    private final int maxClassesCardinality;
+    private String actualField;
+    private List<String> topActualClassNames;
+    private EvaluationMetricResult result;
+
+    public Precision() {
+        this((Integer) null);
+    }
+
+    // Visible for testing
+    public Precision(@Nullable Integer maxClassesCardinality) {
+        this.maxClassesCardinality = maxClassesCardinality != null ? maxClassesCardinality : DEFAULT_MAX_CLASSES_CARDINALITY;
+    }
+
+    public Precision(StreamInput in) throws IOException {
+        this.maxClassesCardinality = DEFAULT_MAX_CLASSES_CARDINALITY;
+    }
+
+    @Override
+    public String getWriteableName() {
+        return registeredMetricName(Classification.NAME, NAME);
+    }
+
+    @Override
+    public String getName() {
+        return NAME.getPreferredName();
+    }
+
+    @Override
+    public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
+        // Store given {@code actualField} for the purpose of generating error message in {@code process}.
+        this.actualField = actualField;
+        if (topActualClassNames == null) {  // This is step 1
+            return Tuple.tuple(
+                List.of(
+                    AggregationBuilders.terms(ACTUAL_CLASSES_NAMES_AGG_NAME)
+                        .field(actualField)
+                        .order(List.of(BucketOrder.count(false), BucketOrder.key(true)))
+                        .size(maxClassesCardinality)),
+                List.of());
+        }
+        if (result == null) {  // This is step 2
+            KeyedFilter[] keyedFiltersPredicted =
+                topActualClassNames.stream()
+                    .map(className -> new KeyedFilter(className, QueryBuilders.termQuery(predictedField, className)))
+                    .toArray(KeyedFilter[]::new);
+            Script script = buildScript(actualField, predictedField);
+            return Tuple.tuple(
+                List.of(
+                    AggregationBuilders.filters(BY_PREDICTED_CLASS_AGG_NAME, keyedFiltersPredicted)
+                        .subAggregation(AggregationBuilders.avg(PER_PREDICTED_CLASS_PRECISION_AGG_NAME).script(script))),
+                List.of(
+                    PipelineAggregatorBuilders.avgBucket(
+                        AVG_PRECISION_AGG_NAME,
+                        BY_PREDICTED_CLASS_AGG_NAME + ">" + PER_PREDICTED_CLASS_PRECISION_AGG_NAME)));
+        }
+        return Tuple.tuple(List.of(), List.of());
+    }
+
+    @Override
+    public void process(Aggregations aggs) {
+        if (topActualClassNames == null && aggs.get(ACTUAL_CLASSES_NAMES_AGG_NAME) instanceof Terms) {
+            Terms topActualClassesAgg = aggs.get(ACTUAL_CLASSES_NAMES_AGG_NAME);
+            if (topActualClassesAgg.getSumOfOtherDocCounts() > 0) {
+                // This means there were more than {@code maxClassesCardinality} buckets.
+                // We cannot calculate average precision accurately, so we fail.
+                throw ExceptionsHelper.badRequestException(
+                    "Cannot calculate average precision. Cardinality of field [{}] is too high", actualField);
+            }
+            topActualClassNames =
+                topActualClassesAgg.getBuckets().stream().map(Terms.Bucket::getKeyAsString).sorted().collect(Collectors.toList());
+        }
+        if (result == null &&
+                aggs.get(BY_PREDICTED_CLASS_AGG_NAME) instanceof Filters &&
+                aggs.get(AVG_PRECISION_AGG_NAME) instanceof NumericMetricsAggregation.SingleValue) {
+            Filters byPredictedClassAgg = aggs.get(BY_PREDICTED_CLASS_AGG_NAME);
+            NumericMetricsAggregation.SingleValue avgPrecisionAgg = aggs.get(AVG_PRECISION_AGG_NAME);
+            List<PerClassResult> classes = new ArrayList<>(byPredictedClassAgg.getBuckets().size());
+            for (Filters.Bucket bucket : byPredictedClassAgg.getBuckets()) {
+                String className = bucket.getKeyAsString();
+                NumericMetricsAggregation.SingleValue precisionAgg = bucket.getAggregations().get(PER_PREDICTED_CLASS_PRECISION_AGG_NAME);
+                double precision = precisionAgg.value();
+                if (Double.isFinite(precision)) {
+                    classes.add(new PerClassResult(className, precision));
+                }
+            }
+            result = new Result(classes, avgPrecisionAgg.value());
+        }
+    }
+
+    @Override
+    public Optional<EvaluationMetricResult> getResult() {
+        return Optional.ofNullable(result);
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        return true;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(NAME.getPreferredName());
+    }
+
+    public static class Result implements EvaluationMetricResult {
+
+        private static final ParseField CLASSES = new ParseField("classes");
+        private static final ParseField AVG_PRECISION = new ParseField("avg_precision");
+
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<Result, Void> PARSER =
+            new ConstructingObjectParser<>("precision_result", true, a -> new Result((List<PerClassResult>) a[0], (double) a[1]));
+
+        static {
+            PARSER.declareObjectArray(constructorArg(), PerClassResult.PARSER, CLASSES);
+            PARSER.declareDouble(constructorArg(), AVG_PRECISION);
+        }
+
+        public static Result fromXContent(XContentParser parser) {
+            return PARSER.apply(parser, null);
+        }
+
+        /** List of per-class results. */
+        private final List<PerClassResult> classes;
+        /** Average of per-class precisions. */
+        private final double avgPrecision;
+
+        public Result(List<PerClassResult> classes, double avgPrecision) {
+            this.classes = Collections.unmodifiableList(ExceptionsHelper.requireNonNull(classes, CLASSES));
+            this.avgPrecision = avgPrecision;
+        }
+
+        public Result(StreamInput in) throws IOException {
+            this.classes = Collections.unmodifiableList(in.readList(PerClassResult::new));
+            this.avgPrecision = in.readDouble();
+        }
+
+        @Override
+        public String getWriteableName() {
+            return registeredMetricName(Classification.NAME, NAME);
+        }
+
+        @Override
+        public String getMetricName() {
+            return NAME.getPreferredName();
+        }
+
+        public List<PerClassResult> getClasses() {
+            return classes;
+        }
+
+        public double getAvgPrecision() {
+            return avgPrecision;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeList(classes);
+            out.writeDouble(avgPrecision);
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(CLASSES.getPreferredName(), classes);
+            builder.field(AVG_PRECISION.getPreferredName(), avgPrecision);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Result that = (Result) o;
+            return Objects.equals(this.classes, that.classes)
+                && this.avgPrecision == that.avgPrecision;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(classes, avgPrecision);
+        }
+    }
+
+    public static class PerClassResult implements ToXContentObject, Writeable {
+
+        private static final ParseField CLASS_NAME = new ParseField("class_name");
+        private static final ParseField PRECISION = new ParseField("precision");
+
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<PerClassResult, Void> PARSER =
+            new ConstructingObjectParser<>("precision_per_class_result", true, a -> new PerClassResult((String) a[0], (double) a[1]));
+
+        static {
+            PARSER.declareString(constructorArg(), CLASS_NAME);
+            PARSER.declareDouble(constructorArg(), PRECISION);
+        }
+
+        /** Name of the class. */
+        private final String className;
+        /** Fraction of documents predicted as belonging to the {@code predictedClass} class predicted correctly. */
+        private final double precision;
+
+        public PerClassResult(String className, double precision) {
+            this.className = ExceptionsHelper.requireNonNull(className, CLASS_NAME);
+            this.precision = precision;
+        }
+
+        public PerClassResult(StreamInput in) throws IOException {
+            this.className = in.readString();
+            this.precision = in.readDouble();
+        }
+
+        public String getClassName() {
+            return className;
+        }
+
+        public double getPrecision() {
+            return precision;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(className);
+            out.writeDouble(precision);
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(CLASS_NAME.getPreferredName(), className);
+            builder.field(PRECISION.getPreferredName(), precision);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            PerClassResult that = (PerClassResult) o;
+            return Objects.equals(this.className, that.className)
+                && this.precision == that.precision;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(className, precision);
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
new file mode 100644
index 0000000000000..522810e57e2dd
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
@@ -0,0 +1,319 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.script.Script;
+import org.elasticsearch.search.aggregations.AggregationBuilder;
+import org.elasticsearch.search.aggregations.AggregationBuilders;
+import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
+import org.elasticsearch.search.aggregations.PipelineAggregatorBuilders;
+import org.elasticsearch.search.aggregations.bucket.terms.Terms;
+import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
+import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+
+import java.io.IOException;
+import java.text.MessageFormat;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Locale;
+import java.util.Objects;
+import java.util.Optional;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
+/**
+ * {@link Recall} is a metric that answers the question:
+ *   "What fraction of documents belonging to X have been predicted as X by the classifier?"
+ * for any given class X
+ *
+ * equation: recall(X) = TP(X) / (TP(X) + FN(X))
+ * where: TP(X) - number of true positives wrt X
+ *        FN(X) - number of false negatives wrt X
+ */
+public class Recall implements EvaluationMetric {
+
+    public static final ParseField NAME = new ParseField("recall");
+
+    private static final String PAINLESS_TEMPLATE = "doc[''{0}''].value == doc[''{1}''].value";
+    private static final String AGG_NAME_PREFIX = "classification_recall_";
+    static final String BY_ACTUAL_CLASS_AGG_NAME = AGG_NAME_PREFIX + "by_actual_class";
+    static final String PER_ACTUAL_CLASS_RECALL_AGG_NAME = AGG_NAME_PREFIX + "per_actual_class_recall";
+    static final String AVG_RECALL_AGG_NAME = AGG_NAME_PREFIX + "avg_recall";
+
+    private static Script buildScript(Object...args) {
+        return new Script(new MessageFormat(PAINLESS_TEMPLATE, Locale.ROOT).format(args));
+    }
+
+    private static final ObjectParser<Recall, Void> PARSER = new ObjectParser<>(NAME.getPreferredName(), true, Recall::new);
+
+    public static Recall fromXContent(XContentParser parser) {
+        return PARSER.apply(parser, null);
+    }
+
+    private static final int DEFAULT_MAX_CLASSES_CARDINALITY = 1000;
+
+    private final int maxClassesCardinality;
+    private String actualField;
+    private EvaluationMetricResult result;
+
+    public Recall() {
+        this((Integer) null);
+    }
+
+    // Visible for testing
+    public Recall(@Nullable Integer maxClassesCardinality) {
+        this.maxClassesCardinality = maxClassesCardinality != null ? maxClassesCardinality : DEFAULT_MAX_CLASSES_CARDINALITY;
+    }
+
+    public Recall(StreamInput in) throws IOException {
+        this.maxClassesCardinality = DEFAULT_MAX_CLASSES_CARDINALITY;
+    }
+
+    @Override
+    public String getWriteableName() {
+        return registeredMetricName(Classification.NAME, NAME);
+    }
+
+    @Override
+    public String getName() {
+        return NAME.getPreferredName();
+    }
+
+    @Override
+    public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
+        // Store given {@code actualField} for the purpose of generating error message in {@code process}.
+        this.actualField = actualField;
+        if (result != null) {
+            return Tuple.tuple(List.of(), List.of());
+        }
+        Script script = buildScript(actualField, predictedField);
+        return Tuple.tuple(
+            List.of(
+                AggregationBuilders.terms(BY_ACTUAL_CLASS_AGG_NAME)
+                    .field(actualField)
+                    .size(maxClassesCardinality)
+                    .subAggregation(AggregationBuilders.avg(PER_ACTUAL_CLASS_RECALL_AGG_NAME).script(script))),
+            List.of(
+                PipelineAggregatorBuilders.avgBucket(
+                    AVG_RECALL_AGG_NAME,
+                    BY_ACTUAL_CLASS_AGG_NAME + ">" + PER_ACTUAL_CLASS_RECALL_AGG_NAME)));
+    }
+
+    @Override
+    public void process(Aggregations aggs) {
+        if (result == null &&
+                aggs.get(BY_ACTUAL_CLASS_AGG_NAME) instanceof Terms &&
+                aggs.get(AVG_RECALL_AGG_NAME) instanceof NumericMetricsAggregation.SingleValue) {
+            Terms byActualClassAgg = aggs.get(BY_ACTUAL_CLASS_AGG_NAME);
+            if (byActualClassAgg.getSumOfOtherDocCounts() > 0) {
+                // This means there were more than {@code maxClassesCardinality} buckets.
+                // We cannot calculate average recall accurately, so we fail.
+                throw ExceptionsHelper.badRequestException(
+                    "Cannot calculate average recall. Cardinality of field [{}] is too high", actualField);
+            }
+            NumericMetricsAggregation.SingleValue avgRecallAgg = aggs.get(AVG_RECALL_AGG_NAME);
+            List<PerClassResult> classes = new ArrayList<>(byActualClassAgg.getBuckets().size());
+            for (Terms.Bucket bucket : byActualClassAgg.getBuckets()) {
+                String className = bucket.getKeyAsString();
+                NumericMetricsAggregation.SingleValue recallAgg = bucket.getAggregations().get(PER_ACTUAL_CLASS_RECALL_AGG_NAME);
+                classes.add(new PerClassResult(className, recallAgg.value()));
+            }
+            result = new Result(classes, avgRecallAgg.value());
+        }
+    }
+
+    @Override
+    public Optional<EvaluationMetricResult> getResult() {
+        return Optional.ofNullable(result);
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        return true;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(NAME.getPreferredName());
+    }
+
+    public static class Result implements EvaluationMetricResult {
+
+        private static final ParseField CLASSES = new ParseField("classes");
+        private static final ParseField AVG_RECALL = new ParseField("avg_recall");
+
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<Result, Void> PARSER =
+            new ConstructingObjectParser<>("recall_result", true, a -> new Result((List<PerClassResult>) a[0], (double) a[1]));
+
+        static {
+            PARSER.declareObjectArray(constructorArg(), PerClassResult.PARSER, CLASSES);
+            PARSER.declareDouble(constructorArg(), AVG_RECALL);
+        }
+
+        public static Result fromXContent(XContentParser parser) {
+            return PARSER.apply(parser, null);
+        }
+
+        /** List of per-class results. */
+        private final List<PerClassResult> classes;
+        /** Average of per-class recalls. */
+        private final double avgRecall;
+
+        public Result(List<PerClassResult> classes, double avgRecall) {
+            this.classes = Collections.unmodifiableList(ExceptionsHelper.requireNonNull(classes, CLASSES));
+            this.avgRecall = avgRecall;
+        }
+
+        public Result(StreamInput in) throws IOException {
+            this.classes = Collections.unmodifiableList(in.readList(PerClassResult::new));
+            this.avgRecall = in.readDouble();
+        }
+
+        @Override
+        public String getWriteableName() {
+            return registeredMetricName(Classification.NAME, NAME);
+        }
+
+        @Override
+        public String getMetricName() {
+            return NAME.getPreferredName();
+        }
+
+        public List<PerClassResult> getClasses() {
+            return classes;
+        }
+
+        public double getAvgRecall() {
+            return avgRecall;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeList(classes);
+            out.writeDouble(avgRecall);
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(CLASSES.getPreferredName(), classes);
+            builder.field(AVG_RECALL.getPreferredName(), avgRecall);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Result that = (Result) o;
+            return Objects.equals(this.classes, that.classes)
+                && this.avgRecall == that.avgRecall;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(classes, avgRecall);
+        }
+    }
+
+    public static class PerClassResult implements ToXContentObject, Writeable {
+
+        private static final ParseField CLASS_NAME = new ParseField("class_name");
+        private static final ParseField RECALL = new ParseField("recall");
+
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<PerClassResult, Void> PARSER =
+            new ConstructingObjectParser<>("recall_per_class_result", true, a -> new PerClassResult((String) a[0], (double) a[1]));
+
+        static {
+            PARSER.declareString(constructorArg(), CLASS_NAME);
+            PARSER.declareDouble(constructorArg(), RECALL);
+        }
+
+        /** Name of the class. */
+        private final String className;
+        /** Fraction of documents actually belonging to the {@code actualClass} class predicted correctly. */
+        private final double recall;
+
+        public PerClassResult(String className, double recall) {
+            this.className = ExceptionsHelper.requireNonNull(className, CLASS_NAME);
+            this.recall = recall;
+        }
+
+        public PerClassResult(StreamInput in) throws IOException {
+            this.className = in.readString();
+            this.recall = in.readDouble();
+        }
+
+        public String getClassName() {
+            return className;
+        }
+
+        public double getRecall() {
+            return recall;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(className);
+            out.writeDouble(recall);
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(CLASS_NAME.getPreferredName(), className);
+            builder.field(RECALL.getPreferredName(), recall);
+            builder.endObject();
+            return builder;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            PerClassResult that = (PerClassResult) o;
+            return Objects.equals(this.className, that.className)
+                && this.recall == that.recall;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(className, recall);
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/MeanSquaredError.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/MeanSquaredError.java
index 0d652f511807e..15a0522d72432 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/MeanSquaredError.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/MeanSquaredError.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression;
 
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ObjectParser;
@@ -15,7 +16,9 @@
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 
 import java.io.IOException;
@@ -25,12 +28,14 @@
 import java.util.Objects;
 import java.util.Optional;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 /**
  * Calculates the mean squared error between two known numerical fields.
  *
  * equation: mse = 1/n * Σ(y - y´)^2
  */
-public class MeanSquaredError implements RegressionMetric {
+public class MeanSquaredError implements EvaluationMetric {
 
     public static final ParseField NAME = new ParseField("mean_squared_error");
 
@@ -60,11 +65,13 @@ public String getName() {
     }
 
     @Override
-    public List<AggregationBuilder> aggs(String actualField, String predictedField) {
+    public Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
         if (result != null) {
-            return List.of();
+            return Tuple.tuple(List.of(), List.of());
         }
-        return List.of(AggregationBuilders.avg(AGG_NAME).script(new Script(buildScript(actualField, predictedField))));
+        return Tuple.tuple(
+            List.of(AggregationBuilders.avg(AGG_NAME).script(new Script(buildScript(actualField, predictedField)))),
+            List.of());
     }
 
     @Override
@@ -80,7 +87,7 @@ public Optional<EvaluationMetricResult> getResult() {
 
     @Override
     public String getWriteableName() {
-        return NAME.getPreferredName();
+        return registeredMetricName(Regression.NAME, NAME);
     }
 
     @Override
@@ -123,7 +130,7 @@ public Result(StreamInput in) throws IOException {
 
         @Override
         public String getWriteableName() {
-            return NAME.getPreferredName();
+            return registeredMetricName(Regression.NAME, NAME);
         }
 
         @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RSquared.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RSquared.java
index a153e7c148ef4..d3a04c415c047 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RSquared.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RSquared.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression;
 
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ObjectParser;
@@ -15,9 +16,11 @@
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.search.aggregations.metrics.ExtendedStats;
 import org.elasticsearch.search.aggregations.metrics.ExtendedStatsAggregationBuilder;
 import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 
 import java.io.IOException;
@@ -27,6 +30,8 @@
 import java.util.Objects;
 import java.util.Optional;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 /**
  * Calculates R-Squared between two known numerical fields.
  *
@@ -35,7 +40,7 @@
  * SSres = Σ(y - y´)^2, The residual sum of squares
  * SStot =  Σ(y - y_mean)^2, The total sum of squares
  */
-public class RSquared implements RegressionMetric {
+public class RSquared implements EvaluationMetric {
 
     public static final ParseField NAME = new ParseField("r_squared");
 
@@ -65,13 +70,15 @@ public String getName() {
     }
 
     @Override
-    public List<AggregationBuilder> aggs(String actualField, String predictedField) {
+    public Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
         if (result != null) {
-            return List.of();
+            return Tuple.tuple(List.of(), List.of());
         }
-        return List.of(
-            AggregationBuilders.sum(SS_RES).script(new Script(buildScript(actualField, predictedField))),
-            AggregationBuilders.extendedStats(ExtendedStatsAggregationBuilder.NAME + "_actual").field(actualField));
+        return Tuple.tuple(
+            List.of(
+                AggregationBuilders.sum(SS_RES).script(new Script(buildScript(actualField, predictedField))),
+                AggregationBuilders.extendedStats(ExtendedStatsAggregationBuilder.NAME + "_actual").field(actualField)),
+            List.of());
     }
 
     @Override
@@ -95,7 +102,7 @@ public Optional<EvaluationMetricResult> getResult() {
 
     @Override
     public String getWriteableName() {
-        return NAME.getPreferredName();
+        return registeredMetricName(Regression.NAME, NAME);
     }
 
     @Override
@@ -138,7 +145,7 @@ public Result(StreamInput in) throws IOException {
 
         @Override
         public String getWriteableName() {
-            return NAME.getPreferredName();
+            return registeredMetricName(Regression.NAME, NAME);
         }
 
         @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/Regression.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/Regression.java
index ccf16a9618ec6..cc32ea4049282 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/Regression.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/Regression.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.Evaluation;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.io.IOException;
@@ -20,6 +21,8 @@
 import java.util.List;
 import java.util.Objects;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 /**
  * Evaluation of regression results.
  */
@@ -33,13 +36,13 @@ public class Regression implements Evaluation {
 
     @SuppressWarnings("unchecked")
     public static final ConstructingObjectParser<Regression, Void> PARSER = new ConstructingObjectParser<>(
-        NAME.getPreferredName(), a -> new Regression((String) a[0], (String) a[1], (List<RegressionMetric>) a[2]));
+        NAME.getPreferredName(), a -> new Regression((String) a[0], (String) a[1], (List<EvaluationMetric>) a[2]));
 
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), ACTUAL_FIELD);
         PARSER.declareString(ConstructingObjectParser.constructorArg(), PREDICTED_FIELD);
         PARSER.declareNamedObjects(ConstructingObjectParser.optionalConstructorArg(),
-            (p, c, n) -> p.namedObject(RegressionMetric.class, n, c), METRICS);
+            (p, c, n) -> p.namedObject(EvaluationMetric.class, registeredMetricName(NAME.getPreferredName(), n), c), METRICS);
     }
 
     public static Regression fromXContent(XContentParser parser) {
@@ -61,22 +64,22 @@ public static Regression fromXContent(XContentParser parser) {
     /**
      * The list of metrics to calculate
      */
-    private final List<RegressionMetric> metrics;
+    private final List<EvaluationMetric> metrics;
 
-    public Regression(String actualField, String predictedField, @Nullable List<RegressionMetric> metrics) {
+    public Regression(String actualField, String predictedField, @Nullable List<EvaluationMetric> metrics) {
         this.actualField = ExceptionsHelper.requireNonNull(actualField, ACTUAL_FIELD);
         this.predictedField = ExceptionsHelper.requireNonNull(predictedField, PREDICTED_FIELD);
         this.metrics = initMetrics(metrics, Regression::defaultMetrics);
     }
 
-    private static List<RegressionMetric> defaultMetrics() {
+    private static List<EvaluationMetric> defaultMetrics() {
         return Arrays.asList(new MeanSquaredError(), new RSquared());
     }
 
     public Regression(StreamInput in) throws IOException {
         this.actualField = in.readString();
         this.predictedField = in.readString();
-        this.metrics = in.readNamedWriteableList(RegressionMetric.class);
+        this.metrics = in.readNamedWriteableList(EvaluationMetric.class);
     }
 
     @Override
@@ -95,7 +98,7 @@ public String getPredictedField() {
     }
 
     @Override
-    public List<RegressionMetric> getMetrics() {
+    public List<EvaluationMetric> getMetrics() {
         return metrics;
     }
 
@@ -118,8 +121,8 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         builder.field(PREDICTED_FIELD.getPreferredName(), predictedField);
 
         builder.startObject(METRICS.getPreferredName());
-        for (RegressionMetric metric : metrics) {
-            builder.field(metric.getWriteableName(), metric);
+        for (EvaluationMetric metric : metrics) {
+            builder.field(metric.getName(), metric);
         }
         builder.endObject();
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RegressionMetric.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RegressionMetric.java
deleted file mode 100644
index 5b46829b4c852..0000000000000
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RegressionMetric.java
+++ /dev/null
@@ -1,11 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression;
-
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
-
-public interface RegressionMetric extends EvaluationMetric {
-}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/AbstractConfusionMatrixMetric.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/AbstractConfusionMatrixMetric.java
index 286a68314d713..e09e03b1208aa 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/AbstractConfusionMatrixMetric.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/AbstractConfusionMatrixMetric.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification;
 
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -15,6 +16,8 @@
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
@@ -22,9 +25,9 @@
 import java.util.List;
 import java.util.Optional;
 
-import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.SoftClassificationMetric.actualIsTrueQuery;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.BinarySoftClassification.actualIsTrueQuery;
 
-abstract class AbstractConfusionMatrixMetric implements SoftClassificationMetric {
+abstract class AbstractConfusionMatrixMetric implements EvaluationMetric {
 
     public static final ParseField AT = new ParseField("at");
 
@@ -62,11 +65,11 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     }
 
     @Override
-    public final List<AggregationBuilder> aggs(String actualField, String predictedProbabilityField) {
+    public Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedProbabilityField) {
         if (result != null) {
-            return List.of();
+            return Tuple.tuple(List.of(), List.of());
         }
-        return aggsAt(actualField, predictedProbabilityField);
+        return Tuple.tuple(aggsAt(actualField, predictedProbabilityField), List.of());
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/AucRoc.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/AucRoc.java
index 40257ebce4cdb..3f62a0b144eec 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/AucRoc.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/AucRoc.java
@@ -7,6 +7,7 @@
 
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -18,8 +19,10 @@
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.filter.Filter;
 import org.elasticsearch.search.aggregations.metrics.Percentiles;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
@@ -33,7 +36,8 @@
 import java.util.Optional;
 import java.util.stream.IntStream;
 
-import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.SoftClassificationMetric.actualIsTrueQuery;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification.BinarySoftClassification.actualIsTrueQuery;
 
 /**
  * Area under the curve (AUC) of the receiver operating characteristic (ROC).
@@ -53,7 +57,7 @@
  * When this is used for multi-class classification, it will calculate the ROC
  * curve of each class versus the rest.
  */
-public class AucRoc implements SoftClassificationMetric {
+public class AucRoc implements EvaluationMetric {
 
     public static final ParseField NAME = new ParseField("auc_roc");
 
@@ -88,7 +92,7 @@ public AucRoc(StreamInput in) throws IOException {
 
     @Override
     public String getWriteableName() {
-        return NAME.getPreferredName();
+        return registeredMetricName(BinarySoftClassification.NAME, NAME);
     }
 
     @Override
@@ -123,9 +127,9 @@ public int hashCode() {
     }
 
     @Override
-    public List<AggregationBuilder> aggs(String actualField, String predictedProbabilityField) {
+    public Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedProbabilityField) {
         if (result != null) {
-            return List.of();
+            return Tuple.tuple(List.of(), List.of());
         }
         double[] percentiles = IntStream.range(1, 100).mapToDouble(v -> (double) v).toArray();
         AggregationBuilder percentilesForClassValueAgg =
@@ -138,7 +142,9 @@ public List<AggregationBuilder> aggs(String actualField, String predictedProbabi
                 .filter(NON_TRUE_AGG_NAME, QueryBuilders.boolQuery().mustNot(actualIsTrueQuery(actualField)))
                 .subAggregation(
                     AggregationBuilders.percentiles(PERCENTILES).field(predictedProbabilityField).percentiles(percentiles));
-        return List.of(percentilesForClassValueAgg, percentilesForRestAgg);
+        return Tuple.tuple(
+            List.of(percentilesForClassValueAgg, percentilesForRestAgg),
+            List.of());
     }
 
     @Override
@@ -330,7 +336,7 @@ public Result(StreamInput in) throws IOException {
 
         @Override
         public String getWriteableName() {
-            return NAME.getPreferredName();
+            return registeredMetricName(BinarySoftClassification.NAME, NAME);
         }
 
         @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/BinarySoftClassification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/BinarySoftClassification.java
index 67a635e078be2..8d4f4f01d02cd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/BinarySoftClassification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/BinarySoftClassification.java
@@ -12,7 +12,10 @@
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.Evaluation;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.io.IOException;
@@ -20,6 +23,8 @@
 import java.util.List;
 import java.util.Objects;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 /**
  * Evaluation of binary soft classification methods, e.g. outlier detection.
  * This is useful to evaluate problems where a model outputs a probability of whether
@@ -34,19 +39,23 @@ public class BinarySoftClassification implements Evaluation {
     private static final ParseField METRICS = new ParseField("metrics");
 
     public static final ConstructingObjectParser<BinarySoftClassification, Void> PARSER = new ConstructingObjectParser<>(
-        NAME.getPreferredName(), a -> new BinarySoftClassification((String) a[0], (String) a[1], (List<SoftClassificationMetric>) a[2]));
+        NAME.getPreferredName(), a -> new BinarySoftClassification((String) a[0], (String) a[1], (List<EvaluationMetric>) a[2]));
 
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), ACTUAL_FIELD);
         PARSER.declareString(ConstructingObjectParser.constructorArg(), PREDICTED_PROBABILITY_FIELD);
         PARSER.declareNamedObjects(ConstructingObjectParser.optionalConstructorArg(),
-            (p, c, n) -> p.namedObject(SoftClassificationMetric.class, n, null), METRICS);
+            (p, c, n) -> p.namedObject(EvaluationMetric.class, registeredMetricName(NAME.getPreferredName(), n), c), METRICS);
     }
 
     public static BinarySoftClassification fromXContent(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
+    static QueryBuilder actualIsTrueQuery(String actualField) {
+        return QueryBuilders.queryStringQuery(actualField + ": (1 OR true)");
+    }
+
     /**
      * The field where the actual class is marked up.
      * The value of this field is assumed to either be 1 or 0, or true or false.
@@ -61,16 +70,16 @@ public static BinarySoftClassification fromXContent(XContentParser parser) {
     /**
      * The list of metrics to calculate
      */
-    private final List<SoftClassificationMetric> metrics;
+    private final List<EvaluationMetric> metrics;
 
     public BinarySoftClassification(String actualField, String predictedProbabilityField,
-                                    @Nullable List<SoftClassificationMetric> metrics) {
+                                    @Nullable List<EvaluationMetric> metrics) {
         this.actualField = ExceptionsHelper.requireNonNull(actualField, ACTUAL_FIELD);
         this.predictedProbabilityField = ExceptionsHelper.requireNonNull(predictedProbabilityField, PREDICTED_PROBABILITY_FIELD);
         this.metrics = initMetrics(metrics, BinarySoftClassification::defaultMetrics);
     }
 
-    private static List<SoftClassificationMetric> defaultMetrics() {
+    private static List<EvaluationMetric> defaultMetrics() {
         return Arrays.asList(
             new AucRoc(false),
             new Precision(Arrays.asList(0.25, 0.5, 0.75)),
@@ -81,7 +90,7 @@ private static List<SoftClassificationMetric> defaultMetrics() {
     public BinarySoftClassification(StreamInput in) throws IOException {
         this.actualField = in.readString();
         this.predictedProbabilityField = in.readString();
-        this.metrics = in.readNamedWriteableList(SoftClassificationMetric.class);
+        this.metrics = in.readNamedWriteableList(EvaluationMetric.class);
     }
 
     @Override
@@ -100,7 +109,7 @@ public String getPredictedField() {
     }
 
     @Override
-    public List<SoftClassificationMetric> getMetrics() {
+    public List<EvaluationMetric> getMetrics() {
         return metrics;
     }
 
@@ -123,7 +132,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         builder.field(PREDICTED_PROBABILITY_FIELD.getPreferredName(), predictedProbabilityField);
 
         builder.startObject(METRICS.getPreferredName());
-        for (SoftClassificationMetric metric : metrics) {
+        for (EvaluationMetric metric : metrics) {
             builder.field(metric.getName(), metric);
         }
         builder.endObject();
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ConfusionMatrix.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ConfusionMatrix.java
index d52468a0214b6..1b1d5b8f9d170 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ConfusionMatrix.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ConfusionMatrix.java
@@ -21,6 +21,8 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 public class ConfusionMatrix extends AbstractConfusionMatrixMetric {
 
     public static final ParseField NAME = new ParseField("confusion_matrix");
@@ -46,7 +48,7 @@ public ConfusionMatrix(StreamInput in) throws IOException {
 
     @Override
     public String getWriteableName() {
-        return NAME.getPreferredName();
+        return registeredMetricName(BinarySoftClassification.NAME, NAME);
     }
 
     @Override
@@ -129,7 +131,7 @@ public Result(StreamInput in) throws IOException {
 
         @Override
         public String getWriteableName() {
-            return NAME.getPreferredName();
+            return registeredMetricName(BinarySoftClassification.NAME, NAME);
         }
 
         @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/Precision.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/Precision.java
index 80f838dd5d166..d05ddb5fc4c9b 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/Precision.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/Precision.java
@@ -19,6 +19,8 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 public class Precision extends AbstractConfusionMatrixMetric {
 
     public static final ParseField NAME = new ParseField("precision");
@@ -44,7 +46,7 @@ public Precision(StreamInput in) throws IOException {
 
     @Override
     public String getWriteableName() {
-        return NAME.getPreferredName();
+        return registeredMetricName(BinarySoftClassification.NAME, NAME);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/Recall.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/Recall.java
index 70bda8099db89..2dd44aff6715d 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/Recall.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/Recall.java
@@ -19,6 +19,8 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 public class Recall extends AbstractConfusionMatrixMetric {
 
     public static final ParseField NAME = new ParseField("recall");
@@ -44,7 +46,7 @@ public Recall(StreamInput in) throws IOException {
 
     @Override
     public String getWriteableName() {
-        return NAME.getPreferredName();
+        return registeredMetricName(BinarySoftClassification.NAME, NAME);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ScoreByThresholdResult.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ScoreByThresholdResult.java
index 0ad99a83cf25b..8fdb06bde4d6e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ScoreByThresholdResult.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/ScoreByThresholdResult.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification;
 
+import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -13,9 +14,11 @@
 import java.io.IOException;
 import java.util.Objects;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
+
 public class ScoreByThresholdResult implements EvaluationMetricResult {
 
-    public static final String NAME = "score_by_threshold_result";
+    public static final ParseField NAME = new ParseField("score_by_threshold_result");
 
     private final String name;
     private final double[] thresholds;
@@ -36,7 +39,7 @@ public ScoreByThresholdResult(StreamInput in) throws IOException {
 
     @Override
     public String getWriteableName() {
-        return NAME;
+        return registeredMetricName(BinarySoftClassification.NAME, NAME);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/SoftClassificationMetric.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/SoftClassificationMetric.java
deleted file mode 100644
index 9a9c382caf9d1..0000000000000
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/SoftClassificationMetric.java
+++ /dev/null
@@ -1,17 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.core.ml.dataframe.evaluation.softclassification;
-
-import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.index.query.QueryBuilders;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
-
-public interface SoftClassificationMetric extends EvaluationMetric {
-
-    static QueryBuilder actualIsTrueQuery(String actualField) {
-        return QueryBuilders.queryStringQuery(actualField + ": (1 OR true)");
-    }
-}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/EvaluateDataFrameActionRequestTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/EvaluateDataFrameActionRequestTests.java
index 51fc319642d59..dd485341cb7fd 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/EvaluateDataFrameActionRequestTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/EvaluateDataFrameActionRequestTests.java
@@ -31,7 +31,7 @@ public class EvaluateDataFrameActionRequestTests extends AbstractSerializingTest
     @Override
     protected NamedWriteableRegistry getNamedWriteableRegistry() {
         List<NamedWriteableRegistry.Entry> namedWriteables = new ArrayList<>();
-        namedWriteables.addAll(new MlEvaluationNamedXContentProvider().getNamedWriteables());
+        namedWriteables.addAll(MlEvaluationNamedXContentProvider.getNamedWriteables());
         namedWriteables.addAll(new SearchModule(Settings.EMPTY, Collections.emptyList()).getNamedWriteables());
         return new NamedWriteableRegistry(namedWriteables);
     }
@@ -46,13 +46,11 @@ protected NamedXContentRegistry xContentRegistry() {
 
     @Override
     protected Request createTestInstance() {
-        Request request = new Request();
         int indicesCount = randomIntBetween(1, 5);
         List<String> indices = new ArrayList<>(indicesCount);
         for (int i = 0; i < indicesCount; i++) {
             indices.add(randomAlphaOfLength(10));
         }
-        request.setIndices(indices);
         QueryProvider queryProvider = null;
         if (randomBoolean()) {
             try {
@@ -62,10 +60,11 @@ protected Request createTestInstance() {
                 throw new UncheckedIOException(e);
             }
         }
-        request.setQueryProvider(queryProvider);
         Evaluation evaluation = randomBoolean() ? BinarySoftClassificationTests.createRandom() : RegressionTests.createRandom();
-        request.setEvaluation(evaluation);
-        return request;
+        return new Request()
+            .setIndices(indices)
+            .setQueryProvider(queryProvider)
+            .setEvaluation(evaluation);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/EvaluateDataFrameActionResponseTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/EvaluateDataFrameActionResponseTests.java
index 8aedcb2bfa641..437734ac763be 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/EvaluateDataFrameActionResponseTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/EvaluateDataFrameActionResponseTests.java
@@ -11,7 +11,10 @@
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction.Response;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.AccuracyResultTests;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixResultTests;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.PrecisionResultTests;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.RecallResultTests;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression.MeanSquaredError;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.regression.RSquared;
 
@@ -21,7 +24,7 @@ public class EvaluateDataFrameActionResponseTests extends AbstractWireSerializin
 
     @Override
     protected NamedWriteableRegistry getNamedWriteableRegistry() {
-        return new NamedWriteableRegistry(new MlEvaluationNamedXContentProvider().getNamedWriteables());
+        return new NamedWriteableRegistry(MlEvaluationNamedXContentProvider.getNamedWriteables());
     }
 
     @Override
@@ -29,11 +32,13 @@ protected Response createTestInstance() {
         String evaluationName = randomAlphaOfLength(10);
         List<EvaluationMetricResult> metrics =
             List.of(
+                AccuracyResultTests.createRandom(),
+                PrecisionResultTests.createRandom(),
+                RecallResultTests.createRandom(),
                 MulticlassConfusionMatrixResultTests.createRandom(),
                 new MeanSquaredError.Result(randomDouble()),
                 new RSquared.Result(randomDouble()));
-        int numMetrics = randomIntBetween(0, metrics.size());
-        return new Response(evaluationName, metrics.subList(0, numMetrics));
+        return new Response(evaluationName, randomSubsetOf(metrics));
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyResultTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyResultTests.java
index bb3cc99192067..8fb4c6c02408d 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyResultTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyResultTests.java
@@ -17,15 +17,9 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
-public class AccuracyResultTests extends AbstractWireSerializingTestCase<Accuracy.Result> {
+public class AccuracyResultTests extends AbstractWireSerializingTestCase<Result> {
 
-    @Override
-    protected NamedWriteableRegistry getNamedWriteableRegistry() {
-        return new NamedWriteableRegistry(new MlEvaluationNamedXContentProvider().getNamedWriteables());
-    }
-
-    @Override
-    protected Accuracy.Result createTestInstance() {
+    public static Result createRandom() {
         int numClasses = randomIntBetween(2, 100);
         List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
         List<ActualClass> actualClasses = new ArrayList<>(numClasses);
@@ -38,7 +32,17 @@ protected Accuracy.Result createTestInstance() {
     }
 
     @Override
-    protected Writeable.Reader<Accuracy.Result> instanceReader() {
-        return Accuracy.Result::new;
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(MlEvaluationNamedXContentProvider.getNamedWriteables());
+    }
+
+    @Override
+    protected Result createTestInstance() {
+        return createRandom();
+    }
+
+    @Override
+    protected Writeable.Reader<Result> instanceReader() {
+        return Result::new;
     }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationTests.java
index 23c2effb37fe9..f205974809961 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/ClassificationTests.java
@@ -8,6 +8,7 @@
 import org.apache.lucene.search.TotalHits;
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -19,8 +20,10 @@
 import org.elasticsearch.search.SearchHits;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
 
@@ -42,7 +45,7 @@ public class ClassificationTests extends AbstractSerializingTestCase<Classificat
 
     @Override
     protected NamedWriteableRegistry getNamedWriteableRegistry() {
-        return new NamedWriteableRegistry(new MlEvaluationNamedXContentProvider().getNamedWriteables());
+        return new NamedWriteableRegistry(MlEvaluationNamedXContentProvider.getNamedWriteables());
     }
 
     @Override
@@ -51,10 +54,12 @@ protected NamedXContentRegistry xContentRegistry() {
     }
 
     public static Classification createRandom() {
-        List<ClassificationMetric> metrics =
+        List<EvaluationMetric> metrics =
             randomSubsetOf(
                 Arrays.asList(
                     AccuracyTests.createRandom(),
+                    PrecisionTests.createRandom(),
+                    RecallTests.createRandom(),
                     MulticlassConfusionMatrixTests.createRandom()));
         return new Classification(randomAlphaOfLength(10), randomAlphaOfLength(10), metrics.isEmpty() ? null : metrics);
     }
@@ -101,10 +106,10 @@ public void testBuildSearch() {
     }
 
     public void testProcess_MultipleMetricsWithDifferentNumberOfSteps() {
-        ClassificationMetric metric1 = new FakeClassificationMetric("fake_metric_1", 2);
-        ClassificationMetric metric2 = new FakeClassificationMetric("fake_metric_2", 3);
-        ClassificationMetric metric3 = new FakeClassificationMetric("fake_metric_3", 4);
-        ClassificationMetric metric4 = new FakeClassificationMetric("fake_metric_4", 5);
+        EvaluationMetric metric1 = new FakeClassificationMetric("fake_metric_1", 2);
+        EvaluationMetric metric2 = new FakeClassificationMetric("fake_metric_2", 3);
+        EvaluationMetric metric3 = new FakeClassificationMetric("fake_metric_3", 4);
+        EvaluationMetric metric4 = new FakeClassificationMetric("fake_metric_4", 5);
 
         Classification evaluation = new Classification("act", "pred", Arrays.asList(metric1, metric2, metric3, metric4));
         assertThat(metric1.getResult(), isEmpty());
@@ -168,7 +173,7 @@ private static SearchResponse mockSearchResponseWithNonZeroTotalHits() {
      * Number of steps is configurable.
      * Upon reaching the last step, the result is produced.
      */
-    private static class FakeClassificationMetric implements ClassificationMetric {
+    private static class FakeClassificationMetric implements EvaluationMetric {
 
         private final String name;
         private final int numSteps;
@@ -191,8 +196,8 @@ public String getWriteableName() {
         }
 
         @Override
-        public List<AggregationBuilder> aggs(String actualField, String predictedField) {
-            return List.of();
+        public Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
+            return Tuple.tuple(List.of(), List.of());
         }
 
         @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
index a04e47ff26e65..f145a06c3c894 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
@@ -6,10 +6,12 @@
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
 import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.ActualClass;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.PredictedClass;
@@ -23,9 +25,9 @@
 import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFiltersBucket;
 import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTerms;
 import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTermsBucket;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.TupleMatchers.isTuple;
 import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
 
 public class MulticlassConfusionMatrixTests extends AbstractSerializingTestCase<MulticlassConfusionMatrix> {
@@ -72,8 +74,8 @@ public void testConstructor_SizeValidationFailures() {
 
     public void testAggs() {
         MulticlassConfusionMatrix confusionMatrix = new MulticlassConfusionMatrix();
-        List<AggregationBuilder> aggs = confusionMatrix.aggs("act", "pred");
-        assertThat(aggs, is(not(empty())));
+        Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs = confusionMatrix.aggs("act", "pred");
+        assertThat(aggs, isTuple(not(empty()), empty()));
         assertThat(confusionMatrix.getResult(), isEmpty());
     }
 
@@ -105,7 +107,7 @@ public void testEvaluate() {
         MulticlassConfusionMatrix confusionMatrix = new MulticlassConfusionMatrix(2);
         confusionMatrix.process(aggs);
 
-        assertThat(confusionMatrix.aggs("act", "pred"), is(empty()));
+        assertThat(confusionMatrix.aggs("act", "pred"), isTuple(empty(), empty()));
         MulticlassConfusionMatrix.Result result = (MulticlassConfusionMatrix.Result) confusionMatrix.getResult().get();
         assertThat(result.getMetricName(), equalTo("multiclass_confusion_matrix"));
         assertThat(
@@ -145,7 +147,7 @@ public void testEvaluate_OtherClassesCountGreaterThanZero() {
         MulticlassConfusionMatrix confusionMatrix = new MulticlassConfusionMatrix(2);
         confusionMatrix.process(aggs);
 
-        assertThat(confusionMatrix.aggs("act", "pred"), is(empty()));
+        assertThat(confusionMatrix.aggs("act", "pred"), isTuple(empty(), empty()));
         MulticlassConfusionMatrix.Result result = (MulticlassConfusionMatrix.Result) confusionMatrix.getResult().get();
         assertThat(result.getMetricName(), equalTo("multiclass_confusion_matrix"));
         assertThat(
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/PrecisionResultTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/PrecisionResultTests.java
new file mode 100644
index 0000000000000..b86448a4daacb
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/PrecisionResultTests.java
@@ -0,0 +1,48 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision.PerClassResult;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision.Result;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+public class PrecisionResultTests extends AbstractWireSerializingTestCase<Result> {
+
+    public static Result createRandom() {
+        int numClasses = randomIntBetween(2, 100);
+        List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
+        List<PerClassResult> classes = new ArrayList<>(numClasses);
+        for (int i = 0; i < numClasses; i++) {
+            double precision = randomDoubleBetween(0.0, 1.0, true);
+            classes.add(new PerClassResult(classNames.get(i), precision));
+        }
+        double avgPrecision = randomDoubleBetween(0.0, 1.0, true);
+        return new Result(classes, avgPrecision);
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(MlEvaluationNamedXContentProvider.getNamedWriteables());
+    }
+
+    @Override
+    protected Result createTestInstance() {
+        return createRandom();
+    }
+
+    @Override
+    protected Writeable.Reader<Result> instanceReader() {
+        return Result::new;
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/PrecisionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/PrecisionTests.java
new file mode 100644
index 0000000000000..3000edf5b68b5
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/PrecisionTests.java
@@ -0,0 +1,119 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static org.elasticsearch.test.hamcrest.OptionalMatchers.isEmpty;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFilters;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockSingleValue;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTerms;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.TupleMatchers.isTuple;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.empty;
+import static org.hamcrest.Matchers.equalTo;
+
+public class PrecisionTests extends AbstractSerializingTestCase<Precision> {
+
+    @Override
+    protected Precision doParseInstance(XContentParser parser) throws IOException {
+        return Precision.fromXContent(parser);
+    }
+
+    @Override
+    protected Precision createTestInstance() {
+        return createRandom();
+    }
+
+    @Override
+    protected Writeable.Reader<Precision> instanceReader() {
+        return Precision::new;
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+
+    public static Precision createRandom() {
+        return new Precision();
+    }
+
+    public void testProcess() {
+        Aggregations aggs = new Aggregations(Arrays.asList(
+            mockTerms(Precision.ACTUAL_CLASSES_NAMES_AGG_NAME),
+            mockFilters(Precision.BY_PREDICTED_CLASS_AGG_NAME),
+            mockSingleValue(Precision.AVG_PRECISION_AGG_NAME, 0.8123),
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
+        ));
+
+        Precision precision = new Precision();
+        precision.process(aggs);
+
+        assertThat(precision.aggs("act", "pred"), isTuple(empty(), empty()));
+        assertThat(precision.getResult().get(), equalTo(new Precision.Result(List.of(), 0.8123)));
+    }
+
+    public void testProcess_GivenMissingAgg() {
+        {
+            Aggregations aggs = new Aggregations(Arrays.asList(
+                mockFilters(Precision.BY_PREDICTED_CLASS_AGG_NAME),
+                mockSingleValue("some_other_single_metric_agg", 0.2377)
+            ));
+            Precision precision = new Precision();
+            precision.process(aggs);
+            assertThat(precision.getResult(), isEmpty());
+        }
+        {
+            Aggregations aggs = new Aggregations(Arrays.asList(
+                mockSingleValue(Precision.AVG_PRECISION_AGG_NAME, 0.8123),
+                mockSingleValue("some_other_single_metric_agg", 0.2377)
+            ));
+            Precision precision = new Precision();
+            precision.process(aggs);
+            assertThat(precision.getResult(), isEmpty());
+        }
+    }
+
+    public void testProcess_GivenAggOfWrongType() {
+        {
+            Aggregations aggs = new Aggregations(Arrays.asList(
+                mockFilters(Precision.BY_PREDICTED_CLASS_AGG_NAME),
+                mockFilters(Precision.AVG_PRECISION_AGG_NAME)
+            ));
+            Precision precision = new Precision();
+            precision.process(aggs);
+            assertThat(precision.getResult(), isEmpty());
+        }
+        {
+            Aggregations aggs = new Aggregations(Arrays.asList(
+                mockSingleValue(Precision.BY_PREDICTED_CLASS_AGG_NAME, 1.0),
+                mockSingleValue(Precision.AVG_PRECISION_AGG_NAME, 0.8123)
+            ));
+            Precision precision = new Precision();
+            precision.process(aggs);
+            assertThat(precision.getResult(), isEmpty());
+        }
+    }
+
+    public void testProcess_GivenCardinalityTooHigh() {
+        Aggregations aggs =
+            new Aggregations(Collections.singletonList(mockTerms(Precision.ACTUAL_CLASSES_NAMES_AGG_NAME, Collections.emptyList(), 1)));
+        Precision precision = new Precision();
+        precision.aggs("foo", "bar");
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> precision.process(aggs));
+        assertThat(e.getMessage(), containsString("Cardinality of field [foo] is too high"));
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/RecallResultTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/RecallResultTests.java
new file mode 100644
index 0000000000000..a2a44ded76189
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/RecallResultTests.java
@@ -0,0 +1,48 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall.PerClassResult;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall.Result;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+public class RecallResultTests extends AbstractWireSerializingTestCase<Result> {
+
+    public static Result createRandom() {
+        int numClasses = randomIntBetween(2, 100);
+        List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
+        List<PerClassResult> classes = new ArrayList<>(numClasses);
+        for (int i = 0; i < numClasses; i++) {
+            double recall = randomDoubleBetween(0.0, 1.0, true);
+            classes.add(new PerClassResult(classNames.get(i), recall));
+        }
+        double avgRecall = randomDoubleBetween(0.0, 1.0, true);
+        return new Result(classes, avgRecall);
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(MlEvaluationNamedXContentProvider.getNamedWriteables());
+    }
+
+    @Override
+    protected Result createTestInstance() {
+        return createRandom();
+    }
+
+    @Override
+    protected Writeable.Reader<Result> instanceReader() {
+        return Result::new;
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/RecallTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/RecallTests.java
new file mode 100644
index 0000000000000..877f79e336fec
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/RecallTests.java
@@ -0,0 +1,118 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.search.aggregations.Aggregations;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static org.elasticsearch.test.hamcrest.OptionalMatchers.isEmpty;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockSingleValue;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTerms;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.TupleMatchers.isTuple;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.empty;
+import static org.hamcrest.Matchers.equalTo;
+
+public class RecallTests extends AbstractSerializingTestCase<Recall> {
+
+    @Override
+    protected Recall doParseInstance(XContentParser parser) throws IOException {
+        return Recall.fromXContent(parser);
+    }
+
+    @Override
+    protected Recall createTestInstance() {
+        return createRandom();
+    }
+
+    @Override
+    protected Writeable.Reader<Recall> instanceReader() {
+        return Recall::new;
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+
+    public static Recall createRandom() {
+        return new Recall();
+    }
+
+    public void testProcess() {
+        Aggregations aggs = new Aggregations(Arrays.asList(
+            mockTerms(Recall.BY_ACTUAL_CLASS_AGG_NAME),
+            mockSingleValue(Recall.AVG_RECALL_AGG_NAME, 0.8123),
+            mockSingleValue("some_other_single_metric_agg", 0.2377)
+        ));
+
+        Recall recall = new Recall();
+        recall.process(aggs);
+
+        assertThat(recall.aggs("act", "pred"), isTuple(empty(), empty()));
+        assertThat(recall.getResult().get(), equalTo(new Recall.Result(List.of(), 0.8123)));
+    }
+
+    public void testProcess_GivenMissingAgg() {
+        {
+            Aggregations aggs = new Aggregations(Arrays.asList(
+                mockTerms(Recall.BY_ACTUAL_CLASS_AGG_NAME),
+                mockSingleValue("some_other_single_metric_agg", 0.2377)
+            ));
+            Recall recall = new Recall();
+            recall.process(aggs);
+            assertThat(recall.getResult(), isEmpty());
+        }
+        {
+            Aggregations aggs = new Aggregations(Arrays.asList(
+                mockSingleValue(Recall.AVG_RECALL_AGG_NAME, 0.8123),
+                mockSingleValue("some_other_single_metric_agg", 0.2377)
+            ));
+            Recall recall = new Recall();
+            recall.process(aggs);
+            assertThat(recall.getResult(), isEmpty());
+        }
+    }
+
+    public void testProcess_GivenAggOfWrongType() {
+        {
+            Aggregations aggs = new Aggregations(Arrays.asList(
+                mockTerms(Recall.BY_ACTUAL_CLASS_AGG_NAME),
+                mockTerms(Recall.AVG_RECALL_AGG_NAME)
+            ));
+            Recall recall = new Recall();
+            recall.process(aggs);
+            assertThat(recall.getResult(), isEmpty());
+        }
+        {
+            Aggregations aggs = new Aggregations(Arrays.asList(
+                mockSingleValue(Recall.BY_ACTUAL_CLASS_AGG_NAME, 1.0),
+                mockSingleValue(Recall.AVG_RECALL_AGG_NAME, 0.8123)
+            ));
+            Recall recall = new Recall();
+            recall.process(aggs);
+            assertThat(recall.getResult(), isEmpty());
+        }
+    }
+
+    public void testProcess_GivenCardinalityTooHigh() {
+        Aggregations aggs = new Aggregations(Arrays.asList(
+            mockTerms(Recall.BY_ACTUAL_CLASS_AGG_NAME, Collections.emptyList(), 1),
+            mockSingleValue(Recall.AVG_RECALL_AGG_NAME, 0.8123)));
+        Recall recall = new Recall();
+        recall.aggs("foo", "bar");
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> recall.process(aggs));
+        assertThat(e.getMessage(), containsString("Cardinality of field [foo] is too high"));
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/TupleMatchers.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/TupleMatchers.java
new file mode 100644
index 0000000000000..8bd8ff7572f54
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/TupleMatchers.java
@@ -0,0 +1,49 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
+
+import org.elasticsearch.common.collect.Tuple;
+import org.hamcrest.Description;
+import org.hamcrest.Matcher;
+import org.hamcrest.TypeSafeMatcher;
+
+import java.util.Arrays;
+
+public class TupleMatchers {
+
+    private static class TupleMatcher<V1, V2> extends TypeSafeMatcher<Tuple<? extends V1, ? extends V2>> {
+
+        private final Matcher<? super V1> v1Matcher;
+        private final Matcher<? super V2> v2Matcher;
+
+        private TupleMatcher(Matcher<? super V1> v1Matcher, Matcher<? super V2> v2Matcher) {
+            this.v1Matcher = v1Matcher;
+            this.v2Matcher = v2Matcher;
+        }
+
+        @Override
+        protected boolean matchesSafely(final Tuple<? extends V1, ? extends V2> item) {
+            return item != null && v1Matcher.matches(item.v1()) && v2Matcher.matches(item.v2());
+        }
+
+        @Override
+        public void describeTo(final Description description) {
+            description.appendText("expected tuple matching ").appendList("[", ", ", "]", Arrays.asList(v1Matcher, v2Matcher));
+        }
+    }
+
+    /**
+     * Creates a matcher that matches iff:
+     *  1. the examined tuple's <code>v1()</code> matches the specified <code>v1Matcher</code>
+     * and
+     *  2. the examined tuple's <code>v2()</code> matches the specified <code>v2Matcher</code>
+     * For example:
+     * <pre>assertThat(Tuple.tuple("myValue1", "myValue2"), isTuple(startsWith("my"), containsString("Val")))</pre>
+     */
+    public static <V1, V2> TupleMatcher<? extends V1, ? extends V2> isTuple(Matcher<? super V1> v1Matcher, Matcher<? super V2> v2Matcher) {
+        return new TupleMatcher(v1Matcher, v2Matcher);
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RegressionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RegressionTests.java
index 077998b66aed0..96ba97ecc9348 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RegressionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/regression/RegressionTests.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
 
 import java.io.IOException;
@@ -29,7 +30,7 @@ public class RegressionTests extends AbstractSerializingTestCase<Regression> {
 
     @Override
     protected NamedWriteableRegistry getNamedWriteableRegistry() {
-        return new NamedWriteableRegistry(new MlEvaluationNamedXContentProvider().getNamedWriteables());
+        return new NamedWriteableRegistry(MlEvaluationNamedXContentProvider.getNamedWriteables());
     }
 
     @Override
@@ -38,7 +39,7 @@ protected NamedXContentRegistry xContentRegistry() {
     }
 
     public static Regression createRandom() {
-        List<RegressionMetric> metrics = new ArrayList<>();
+        List<EvaluationMetric> metrics = new ArrayList<>();
         if (randomBoolean()) {
             metrics.add(MeanSquaredErrorTests.createRandom());
         }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/BinarySoftClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/BinarySoftClassificationTests.java
index e63e88f6f848f..28e0a045b190d 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/BinarySoftClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/softclassification/BinarySoftClassificationTests.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
 
 import java.io.IOException;
@@ -29,7 +30,7 @@ public class BinarySoftClassificationTests extends AbstractSerializingTestCase<B
 
     @Override
     protected NamedWriteableRegistry getNamedWriteableRegistry() {
-        return new NamedWriteableRegistry(new MlEvaluationNamedXContentProvider().getNamedWriteables());
+        return new NamedWriteableRegistry(MlEvaluationNamedXContentProvider.getNamedWriteables());
     }
 
     @Override
@@ -38,7 +39,7 @@ protected NamedXContentRegistry xContentRegistry() {
     }
 
     public static BinarySoftClassification createRandom() {
-        List<SoftClassificationMetric> metrics = new ArrayList<>();
+        List<EvaluationMetric> metrics = new ArrayList<>();
         if (randomBoolean()) {
             metrics.add(AucRocTests.createRandom());
         }
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
index 6fd7e289fc231..14c2c3c9aca61 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
@@ -5,21 +5,23 @@
  */
 package org.elasticsearch.xpack.ml.integration;
 
+import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.bulk.BulkRequestBuilder;
 import org.elasticsearch.action.bulk.BulkResponse;
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Classification;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.ActualClass;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.PredictedClass;
 import org.junit.After;
 import org.junit.Before;
 
 import java.util.List;
 
+import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasSize;
 
@@ -116,6 +118,68 @@ public void testEvaluate_Accuracy_BooleanField() {
         assertThat(accuracyResult.getOverallAccuracy(), equalTo(45.0 / 75));
     }
 
+    public void testEvaluate_Precision() {
+        EvaluateDataFrameAction.Response evaluateDataFrameResponse =
+            evaluateDataFrame(
+                ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Precision())));
+
+        assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
+        assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
+
+        Precision.Result precisionResult = (Precision.Result) evaluateDataFrameResponse.getMetrics().get(0);
+        assertThat(precisionResult.getMetricName(), equalTo(Precision.NAME.getPreferredName()));
+        assertThat(
+            precisionResult.getClasses(),
+            equalTo(
+                List.of(
+                    new Precision.PerClassResult("ant", 1.0 / 15),
+                    new Precision.PerClassResult("cat", 1.0 / 15),
+                    new Precision.PerClassResult("dog", 1.0 / 15),
+                    new Precision.PerClassResult("fox", 1.0 / 15),
+                    new Precision.PerClassResult("mouse", 1.0 / 15))));
+        assertThat(precisionResult.getAvgPrecision(), equalTo(5.0 / 75));
+    }
+
+    public void testEvaluate_Precision_CardinalityTooHigh() {
+        ElasticsearchStatusException e =
+            expectThrows(
+                ElasticsearchStatusException.class,
+                () -> evaluateDataFrame(
+                    ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Precision(4)))));
+        assertThat(e.getMessage(), containsString("Cardinality of field [animal_name] is too high"));
+    }
+
+    public void testEvaluate_Recall() {
+        EvaluateDataFrameAction.Response evaluateDataFrameResponse =
+            evaluateDataFrame(
+                ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Recall())));
+
+        assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
+        assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
+
+        Recall.Result recallResult = (Recall.Result) evaluateDataFrameResponse.getMetrics().get(0);
+        assertThat(recallResult.getMetricName(), equalTo(Recall.NAME.getPreferredName()));
+        assertThat(
+            recallResult.getClasses(),
+            equalTo(
+                List.of(
+                    new Recall.PerClassResult("ant", 1.0 / 15),
+                    new Recall.PerClassResult("cat", 1.0 / 15),
+                    new Recall.PerClassResult("dog", 1.0 / 15),
+                    new Recall.PerClassResult("fox", 1.0 / 15),
+                    new Recall.PerClassResult("mouse", 1.0 / 15))));
+        assertThat(recallResult.getAvgRecall(), equalTo(5.0 / 75));
+    }
+
+    public void testEvaluate_Recall_CardinalityTooHigh() {
+        ElasticsearchStatusException e =
+            expectThrows(
+                ElasticsearchStatusException.class,
+                () -> evaluateDataFrame(
+                    ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Recall(4)))));
+        assertThat(e.getMessage(), containsString("Cardinality of field [animal_name] is too high"));
+    }
+
     public void testEvaluate_ConfusionMatrixMetricWithDefaultSize() {
         EvaluateDataFrameAction.Response evaluateDataFrameResponse =
             evaluateDataFrame(
@@ -131,50 +195,50 @@ public void testEvaluate_ConfusionMatrixMetricWithDefaultSize() {
         assertThat(
             confusionMatrixResult.getConfusionMatrix(),
             equalTo(List.of(
-                new ActualClass("ant",
+                new MulticlassConfusionMatrix.ActualClass("ant",
                     15,
                     List.of(
-                        new PredictedClass("ant", 1L),
-                        new PredictedClass("cat", 4L),
-                        new PredictedClass("dog", 3L),
-                        new PredictedClass("fox", 2L),
-                        new PredictedClass("mouse", 5L)),
+                        new MulticlassConfusionMatrix.PredictedClass("ant", 1L),
+                        new MulticlassConfusionMatrix.PredictedClass("cat", 4L),
+                        new MulticlassConfusionMatrix.PredictedClass("dog", 3L),
+                        new MulticlassConfusionMatrix.PredictedClass("fox", 2L),
+                        new MulticlassConfusionMatrix.PredictedClass("mouse", 5L)),
                     0),
-                new ActualClass("cat",
+                new MulticlassConfusionMatrix.ActualClass("cat",
                     15,
                     List.of(
-                        new PredictedClass("ant", 3L),
-                        new PredictedClass("cat", 1L),
-                        new PredictedClass("dog", 5L),
-                        new PredictedClass("fox", 4L),
-                        new PredictedClass("mouse", 2L)),
+                        new MulticlassConfusionMatrix.PredictedClass("ant", 3L),
+                        new MulticlassConfusionMatrix.PredictedClass("cat", 1L),
+                        new MulticlassConfusionMatrix.PredictedClass("dog", 5L),
+                        new MulticlassConfusionMatrix.PredictedClass("fox", 4L),
+                        new MulticlassConfusionMatrix.PredictedClass("mouse", 2L)),
                     0),
-                new ActualClass("dog",
+                new MulticlassConfusionMatrix.ActualClass("dog",
                     15,
                     List.of(
-                        new PredictedClass("ant", 4L),
-                        new PredictedClass("cat", 2L),
-                        new PredictedClass("dog", 1L),
-                        new PredictedClass("fox", 5L),
-                        new PredictedClass("mouse", 3L)),
+                        new MulticlassConfusionMatrix.PredictedClass("ant", 4L),
+                        new MulticlassConfusionMatrix.PredictedClass("cat", 2L),
+                        new MulticlassConfusionMatrix.PredictedClass("dog", 1L),
+                        new MulticlassConfusionMatrix.PredictedClass("fox", 5L),
+                        new MulticlassConfusionMatrix.PredictedClass("mouse", 3L)),
                     0),
-                new ActualClass("fox",
+                new MulticlassConfusionMatrix.ActualClass("fox",
                     15,
                     List.of(
-                        new PredictedClass("ant", 5L),
-                        new PredictedClass("cat", 3L),
-                        new PredictedClass("dog", 2L),
-                        new PredictedClass("fox", 1L),
-                        new PredictedClass("mouse", 4L)),
+                        new MulticlassConfusionMatrix.PredictedClass("ant", 5L),
+                        new MulticlassConfusionMatrix.PredictedClass("cat", 3L),
+                        new MulticlassConfusionMatrix.PredictedClass("dog", 2L),
+                        new MulticlassConfusionMatrix.PredictedClass("fox", 1L),
+                        new MulticlassConfusionMatrix.PredictedClass("mouse", 4L)),
                     0),
-                new ActualClass("mouse",
+                new MulticlassConfusionMatrix.ActualClass("mouse",
                     15,
                     List.of(
-                        new PredictedClass("ant", 2L),
-                        new PredictedClass("cat", 5L),
-                        new PredictedClass("dog", 4L),
-                        new PredictedClass("fox", 3L),
-                        new PredictedClass("mouse", 1L)),
+                        new MulticlassConfusionMatrix.PredictedClass("ant", 2L),
+                        new MulticlassConfusionMatrix.PredictedClass("cat", 5L),
+                        new MulticlassConfusionMatrix.PredictedClass("dog", 4L),
+                        new MulticlassConfusionMatrix.PredictedClass("fox", 3L),
+                        new MulticlassConfusionMatrix.PredictedClass("mouse", 1L)),
                     0))));
         assertThat(confusionMatrixResult.getOtherActualClassCount(), equalTo(0L));
     }
@@ -193,17 +257,26 @@ public void testEvaluate_ConfusionMatrixMetricWithUserProvidedSize() {
         assertThat(
             confusionMatrixResult.getConfusionMatrix(),
             equalTo(List.of(
-                new ActualClass("ant",
+                new MulticlassConfusionMatrix.ActualClass("ant",
                     15,
-                    List.of(new PredictedClass("ant", 1L), new PredictedClass("cat", 4L), new PredictedClass("dog", 3L)),
+                    List.of(
+                        new MulticlassConfusionMatrix.PredictedClass("ant", 1L),
+                        new MulticlassConfusionMatrix.PredictedClass("cat", 4L),
+                        new MulticlassConfusionMatrix.PredictedClass("dog", 3L)),
                     7),
-                new ActualClass("cat",
+                new MulticlassConfusionMatrix.ActualClass("cat",
                     15,
-                    List.of(new PredictedClass("ant", 3L), new PredictedClass("cat", 1L), new PredictedClass("dog", 5L)),
+                    List.of(
+                        new MulticlassConfusionMatrix.PredictedClass("ant", 3L),
+                        new MulticlassConfusionMatrix.PredictedClass("cat", 1L),
+                        new MulticlassConfusionMatrix.PredictedClass("dog", 5L)),
                     6),
-                new ActualClass("dog",
+                new MulticlassConfusionMatrix.ActualClass("dog",
                     15,
-                    List.of(new PredictedClass("ant", 4L), new PredictedClass("cat", 2L), new PredictedClass("dog", 1L)),
+                    List.of(
+                        new MulticlassConfusionMatrix.PredictedClass("ant", 4L),
+                        new MulticlassConfusionMatrix.PredictedClass("cat", 2L),
+                        new MulticlassConfusionMatrix.PredictedClass("dog", 1L)),
                     8))));
         assertThat(confusionMatrixResult.getOtherActualClassCount(), equalTo(2L));
     }
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 40138b826e462..87fa5c30b0755 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -27,6 +27,8 @@
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall;
 import org.junit.After;
 
 import java.util.ArrayList;
@@ -450,9 +452,11 @@ private <T> void assertEvaluation(String dependentVariable, List<T> dependentVar
             evaluateDataFrame(
                 destIndex,
                 new org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Classification(
-                    dependentVariable, predictedClassField, Arrays.asList(new Accuracy(), new MulticlassConfusionMatrix())));
+                    dependentVariable,
+                    predictedClassField,
+                    Arrays.asList(new Accuracy(), new MulticlassConfusionMatrix(), new Precision(), new Recall())));
         assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
-        assertThat(evaluateDataFrameResponse.getMetrics().size(), equalTo(2));
+        assertThat(evaluateDataFrameResponse.getMetrics().size(), equalTo(4));
 
         {   // Accuracy
             Accuracy.Result accuracyResult = (Accuracy.Result) evaluateDataFrameResponse.getMetrics().get(0);
@@ -483,6 +487,24 @@ private <T> void assertEvaluation(String dependentVariable, List<T> dependentVar
             }
             assertThat(confusionMatrixResult.getOtherActualClassCount(), equalTo(0L));
         }
+
+        {   // Precision
+            Precision.Result precisionResult = (Precision.Result) evaluateDataFrameResponse.getMetrics().get(2);
+            assertThat(precisionResult.getMetricName(), equalTo(Precision.NAME.getPreferredName()));
+            for (Precision.PerClassResult klass : precisionResult.getClasses()) {
+                assertThat(klass.getClassName(), is(in(dependentVariableValuesAsStrings)));
+                assertThat(klass.getPrecision(), allOf(greaterThanOrEqualTo(0.0), lessThanOrEqualTo(1.0)));
+            }
+        }
+
+        {   // Recall
+            Recall.Result recallResult = (Recall.Result) evaluateDataFrameResponse.getMetrics().get(3);
+            assertThat(recallResult.getMetricName(), equalTo(Recall.NAME.getPreferredName()));
+            for (Recall.PerClassResult klass : recallResult.getClasses()) {
+                assertThat(klass.getClassName(), is(in(dependentVariableValuesAsStrings)));
+                assertThat(klass.getRecall(), allOf(greaterThanOrEqualTo(0.0), lessThanOrEqualTo(1.0)));
+            }
+        }
     }
 
     protected String stateDocId() {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/evaluate_data_frame.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/evaluate_data_frame.yml
index 9d0d645e3d33a..95a7ef4e33218 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/evaluate_data_frame.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/evaluate_data_frame.yml
@@ -632,6 +632,58 @@ setup:
             accuracy: 0.5  # 1 out of 2
         overall_accuracy: 0.625  # 5 out of 8
 ---
+"Test classification precision":
+  - do:
+      ml.evaluate_data_frame:
+        body: >
+          {
+            "index": "utopia",
+            "evaluation": {
+              "classification": {
+                "actual_field": "classification_field_act.keyword",
+                "predicted_field": "classification_field_pred.keyword",
+                "metrics": { "precision": {} }
+              }
+            }
+          }
+
+  - match:
+      classification.precision:
+        classes:
+          - class_name: "cat"
+            precision: 0.5  # 2 out of 4
+          - class_name: "dog"
+            precision: 0.6666666666666666  # 2 out of 3
+          - class_name: "mouse"
+            precision: 1.0  # 1 out of 1
+        avg_precision: 0.7222222222222222
+---
+"Test classification recall":
+  - do:
+      ml.evaluate_data_frame:
+        body: >
+          {
+            "index": "utopia",
+            "evaluation": {
+              "classification": {
+                "actual_field": "classification_field_act.keyword",
+                "predicted_field": "classification_field_pred.keyword",
+                "metrics": { "recall": {} }
+              }
+            }
+          }
+
+  - match:
+      classification.recall:
+        classes:
+          - class_name: "cat"
+            recall: 0.6666666666666666  # 2 out of 3
+          - class_name: "dog"
+            recall: 0.6666666666666666  # 2 out of 3
+          - class_name: "mouse"
+            recall: 0.5  # 1 out of 2
+        avg_recall: 0.611111111111111
+---
 "Test classification multiclass_confusion_matrix":
   - do:
       ml.evaluate_data_frame:

From 845935d382fc6d6c4e10e183ac1f28be5d9fe0a4 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Thu, 19 Dec 2019 15:11:34 +0000
Subject: [PATCH 272/686] Reduce the max depth of randomly generated interval
 queries (#50317)

We randomly generate intervals sources to test serialization and query generation
in IntervalQueryBuilderTests. However, rarely we can generate a query that has
too many nested disjunctions, resulting in query rewrites running afoul of the maximum
boolean clause limit.

This commit reduces the maximum depth of the randomly generated intervals source
to make running into this limit much more unlikely.
---
 .../elasticsearch/index/query/IntervalQueryBuilderTests.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index ed28a06500d5a..cfcc1a9cd3eb0 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -86,7 +86,7 @@ protected void initializeAdditionalMappings(MapperService mapperService) throws
     }
 
     private IntervalsSourceProvider createRandomSource(int depth, boolean useScripts) {
-        if (depth > 3) {
+        if (depth > 2) {
             return createRandomMatch(depth + 1, useScripts);
         }
         switch (randomInt(20)) {

From 911e3318daefe569b99535edebc0c717527960cd Mon Sep 17 00:00:00 2001
From: Aleksandr Maus <aleksandr.maus@elastic.co>
Date: Thu, 19 Dec 2019 11:14:54 -0500
Subject: [PATCH 273/686] Improve SearchHit "equals" implementation for null
 fields cases (#50327)

* Improve SearchHit "equals" implementation for null fields cases
---
 .../main/java/org/elasticsearch/search/SearchHit.java    | 2 +-
 .../java/org/elasticsearch/search/SearchHitTests.java    | 9 ++++++---
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/search/SearchHit.java b/server/src/main/java/org/elasticsearch/search/SearchHit.java
index 23fb3d8d628b2..209e1e1b78c74 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchHit.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchHit.java
@@ -887,7 +887,7 @@ public boolean equals(Object obj) {
                 && Objects.equals(seqNo, other.seqNo)
                 && Objects.equals(primaryTerm, other.primaryTerm)
                 && Objects.equals(source, other.source)
-                && Objects.equals(fields, other.fields)
+                && Objects.equals(getFields(), other.getFields())
                 && Objects.equals(getHighlightFields(), other.getHighlightFields())
                 && Arrays.equals(matchedQueries, other.matchedQueries)
                 && Objects.equals(explanation, other.explanation)
diff --git a/server/src/test/java/org/elasticsearch/search/SearchHitTests.java b/server/src/test/java/org/elasticsearch/search/SearchHitTests.java
index 5d5d26f489677..0fba6141c7363 100644
--- a/server/src/test/java/org/elasticsearch/search/SearchHitTests.java
+++ b/server/src/test/java/org/elasticsearch/search/SearchHitTests.java
@@ -71,9 +71,12 @@ public static SearchHit createTestItem(XContentType xContentType, boolean withOp
         if (randomBoolean()) {
             nestedIdentity = NestedIdentityTests.createTestItem(randomIntBetween(0, 2));
         }
-        Map<String, DocumentField> fields = new HashMap<>();
-        if (randomBoolean()) {
-            fields = GetResultTests.randomDocumentFields(xContentType).v2();
+        Map<String, DocumentField> fields = null;
+        if (frequently()) {
+            fields = new HashMap<>();
+            if (randomBoolean()) {
+                fields = GetResultTests.randomDocumentFields(xContentType).v2();
+            }
         }
         SearchHit hit = new SearchHit(internalId, uid, nestedIdentity, fields);
         if (frequently()) {

From f85f7696a5bb74e3e3a170ffa6c2c32f820f57d3 Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Thu, 19 Dec 2019 09:31:28 -0700
Subject: [PATCH 274/686] Rename the remote connection mode simple to proxy
 (#50291)

This commit renames the simple connection mode to the proxy connection
mode for remote cluster connections. In order to do this, the mode specific
settings which we namespaced by their mode (ex: sniff.seed and
proxy.addresses) have been reverted.
---
 .../java/org/elasticsearch/client/CCRIT.java  |  2 +-
 .../documentation/CCRDocumentationIT.java     |  2 +-
 ...rossClusterSearchUnavailableClusterIT.java | 16 ++--
 .../15_connection_mode_configuration.yml      | 84 +++++++++----------
 .../test/multi_cluster/20_info.yml            | 30 +++----
 .../common/settings/ClusterSettings.java      |  9 +-
 ...tegy.java => ProxyConnectionStrategy.java} | 68 +++++++--------
 .../transport/RemoteClusterAware.java         |  7 +-
 .../transport/RemoteConnectionStrategy.java   | 12 +--
 .../transport/SniffConnectionStrategy.java    | 24 +-----
 .../search/TransportSearchActionTests.java    |  2 +-
 ...java => ProxyConnectionStrategyTests.java} | 44 +++++-----
 .../RemoteClusterAwareClientTests.java        |  4 +-
 .../transport/RemoteClusterClientTests.java   |  4 +-
 .../RemoteClusterConnectionTests.java         | 23 ++---
 .../transport/RemoteClusterServiceTests.java  | 56 ++++++-------
 .../transport/RemoteClusterSettingsTests.java |  4 +-
 .../RemoteConnectionStrategyTests.java        | 16 ++--
 .../SniffConnectionStrategyTests.java         |  7 +-
 .../xpack/ccr/IndexFollowingIT.java           |  2 +-
 .../70_connection_mode_configuration.yml      | 84 +++++++++----------
 21 files changed, 234 insertions(+), 266 deletions(-)
 rename server/src/main/java/org/elasticsearch/transport/{SimpleConnectionStrategy.java => ProxyConnectionStrategy.java} (84%)
 rename server/src/test/java/org/elasticsearch/transport/{SimpleConnectionStrategyTests.java => ProxyConnectionStrategyTests.java} (91%)

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
index 7f817103a63fc..6be2efe98c48b 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
@@ -83,7 +83,7 @@ public void setupRemoteClusterConfig() throws Exception {
         String transportAddress = (String) nodesResponse.get("transport_address");
 
         ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
-        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local_cluster.sniff.seeds", transportAddress));
+        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local_cluster.seeds", transportAddress));
         ClusterUpdateSettingsResponse updateSettingsResponse =
             highLevelClient().cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
         assertThat(updateSettingsResponse.isAcknowledged(), is(true));
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
index 465a035952599..48f7adda8445c 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
@@ -87,7 +87,7 @@ public void setupRemoteClusterConfig() throws IOException {
         String transportAddress = (String) nodesResponse.get("transport_address");
 
         ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
-        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local.sniff.seeds", transportAddress));
+        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local.seeds", transportAddress));
         ClusterUpdateSettingsResponse updateSettingsResponse =
             client.cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
         assertThat(updateSettingsResponse.isAcknowledged(), is(true));
diff --git a/qa/ccs-unavailable-clusters/src/test/java/org/elasticsearch/search/CrossClusterSearchUnavailableClusterIT.java b/qa/ccs-unavailable-clusters/src/test/java/org/elasticsearch/search/CrossClusterSearchUnavailableClusterIT.java
index 7b2a4835d1964..2bf0eae138135 100644
--- a/qa/ccs-unavailable-clusters/src/test/java/org/elasticsearch/search/CrossClusterSearchUnavailableClusterIT.java
+++ b/qa/ccs-unavailable-clusters/src/test/java/org/elasticsearch/search/CrossClusterSearchUnavailableClusterIT.java
@@ -144,7 +144,7 @@ public void testSearchSkipUnavailable() throws IOException {
         try (MockTransportService remoteTransport = startTransport("node0", new CopyOnWriteArrayList<>(), Version.CURRENT, threadPool)) {
             DiscoveryNode remoteNode = remoteTransport.getLocalDiscoNode();
 
-            updateRemoteClusterSettings(Collections.singletonMap("sniff.seeds", remoteNode.getAddress().toString()));
+            updateRemoteClusterSettings(Collections.singletonMap("seeds", remoteNode.getAddress().toString()));
 
             for (int i = 0; i < 10; i++) {
                 restHighLevelClient.index(
@@ -229,7 +229,7 @@ public void testSearchSkipUnavailable() throws IOException {
             assertSearchConnectFailure();
 
             Map<String, Object> map = new HashMap<>();
-            map.put("sniff.seeds", null);
+            map.put("seeds", null);
             map.put("skip_unavailable", null);
             updateRemoteClusterSettings(map);
         }
@@ -248,32 +248,32 @@ public void testSkipUnavailableDependsOnSeeds() throws IOException {
                         () -> client().performRequest(request));
                 assertEquals(400, responseException.getResponse().getStatusLine().getStatusCode());
                 assertThat(responseException.getMessage(),
-                        containsString("missing required setting [cluster.remote.remote1.sniff.seeds] " +
+                        containsString("missing required setting [cluster.remote.remote1.seeds] " +
                                 "for setting [cluster.remote.remote1.skip_unavailable]"));
             }
 
             Map<String, Object> settingsMap = new HashMap<>();
-            settingsMap.put("sniff.seeds", remoteNode.getAddress().toString());
+            settingsMap.put("seeds", remoteNode.getAddress().toString());
             settingsMap.put("skip_unavailable", randomBoolean());
             updateRemoteClusterSettings(settingsMap);
 
             {
                 //check that seeds cannot be reset alone if skip_unavailable is set
                 Request request = new Request("PUT", "/_cluster/settings");
-                request.setEntity(buildUpdateSettingsRequestBody(Collections.singletonMap("sniff.seeds", null)));
+                request.setEntity(buildUpdateSettingsRequestBody(Collections.singletonMap("seeds", null)));
                 ResponseException responseException = expectThrows(ResponseException.class,
                         () -> client().performRequest(request));
                 assertEquals(400, responseException.getResponse().getStatusLine().getStatusCode());
-                assertThat(responseException.getMessage(), containsString("missing required setting [cluster.remote.remote1.sniff.seeds] " +
+                assertThat(responseException.getMessage(), containsString("missing required setting [cluster.remote.remote1.seeds] " +
                         "for setting [cluster.remote.remote1.skip_unavailable]"));
             }
 
             if (randomBoolean()) {
                 updateRemoteClusterSettings(Collections.singletonMap("skip_unavailable", null));
-                updateRemoteClusterSettings(Collections.singletonMap("sniff.seeds", null));
+                updateRemoteClusterSettings(Collections.singletonMap("seeds", null));
             } else {
                 Map<String, Object> nullMap = new HashMap<>();
-                nullMap.put("sniff.seeds", null);
+                nullMap.put("seeds", null);
                 nullMap.put("skip_unavailable", null);
                 updateRemoteClusterSettings(nullMap);
             }
diff --git a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml
index ed639b3655ed5..5606a08cd261e 100644
--- a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml
+++ b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml
@@ -1,5 +1,5 @@
 ---
-"Add transient remote cluster in simple mode with invalid sniff settings":
+"Add transient remote cluster in proxy mode with invalid sniff settings":
   - do:
       cluster.get_settings:
         include_defaults: true
@@ -12,14 +12,14 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.sniff.node_connections: "5"
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.node_connections: "5"
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.sniff.node_connections\" cannot be
-  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=SIMPLE]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.node_connections\" cannot be
+  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=PROXY]" }
 
   - do:
       catch: bad_request
@@ -27,17 +27,17 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.sniff.seeds\" cannot be
-   used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=SIMPLE]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.seeds\" cannot be
+   used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=PROXY]" }
 
 ---
-"Add transient remote cluster in sniff mode with invalid simple settings":
+"Add transient remote cluster in sniff mode with invalid proxy settings":
   - do:
       cluster.get_settings:
         include_defaults: true
@@ -50,13 +50,13 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.simple.socket_connections: "20"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_socket_connections: "20"
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.simple.socket_connections\" cannot be
-  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SIMPLE, configured=SNIFF]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.proxy_socket_connections\" cannot be
+  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=PROXY, configured=SNIFF]" }
 
   - do:
       catch: bad_request
@@ -64,16 +64,16 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.simple.addresses\" cannot be
-   used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SIMPLE, configured=SNIFF]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.proxy_addresses\" cannot be
+   used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=PROXY, configured=SNIFF]" }
 
 ---
-"Add transient remote cluster using simple connection mode using valid settings":
+"Add transient remote cluster using proxy connection mode using valid settings":
   - do:
       cluster.get_settings:
         include_defaults: true
@@ -85,13 +85,13 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.simple.socket_connections: "3"
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.proxy_socket_connections: "3"
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
-  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "simple"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.socket_connections: "3"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_socket_connections: "3"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
 
   - do:
       search:
@@ -120,12 +120,12 @@
         body:
           transient:
             cluster.remote.test_remote_cluster.mode: "sniff"
-            cluster.remote.test_remote_cluster.sniff.node_connections: "3"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.node_connections: "3"
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "sniff"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.node_connections: "3"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.seeds: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.node_connections: "3"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.seeds: $remote_ip}
 
   - do:
       search:
@@ -154,10 +154,10 @@
         body:
           transient:
             cluster.remote.test_remote_cluster.mode: "sniff"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "sniff"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.seeds: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.seeds: $remote_ip}
 
   - do:
       search:
@@ -178,25 +178,25 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.sniff.seeds\" cannot be
-  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=SIMPLE]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.seeds\" cannot be
+  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=PROXY]" }
 
   - do:
       cluster.put_settings:
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.sniff.seeds: null
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.seeds: null
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
-  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "simple"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
 
   - do:
       search:
diff --git a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
index 761526a7bea60..10378aaeda125 100644
--- a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
+++ b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
@@ -23,12 +23,12 @@
         body:
           transient:
             cluster.remote.test_remote_cluster.mode: "sniff"
-            cluster.remote.test_remote_cluster.sniff.node_connections: "2"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.node_connections: "2"
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "sniff"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.node_connections: "2"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.seeds: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.node_connections: "2"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.seeds: $remote_ip}
 
   # we do another search here since this will enforce the connection to be established
   # otherwise the cluster might not have been connected yet.
@@ -66,15 +66,15 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.sniff.seeds: null
-            cluster.remote.test_remote_cluster.sniff.node_connections: null
-            cluster.remote.test_remote_cluster.simple.socket_connections: "10"
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.seeds: null
+            cluster.remote.test_remote_cluster.node_connections: null
+            cluster.remote.test_remote_cluster.proxy_socket_connections: "10"
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
-  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "simple"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.socket_connections: "10"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_socket_connections: "10"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
 
   - do:
       cluster.remote_info: {}
@@ -84,15 +84,15 @@
   - gt:    { test_remote_cluster.num_sockets_connected: 0}
   - match: { test_remote_cluster.max_socket_connections: 10}
   - match: { test_remote_cluster.initial_connect_timeout: "30s" }
-  - match: { test_remote_cluster.mode: "simple" }
+  - match: { test_remote_cluster.mode: "proxy" }
 
   - do:
       cluster.put_settings:
         body:
           transient:
             cluster.remote.test_remote_cluster.mode: null
-            cluster.remote.test_remote_cluster.simple.socket_connections: null
-            cluster.remote.test_remote_cluster.simple.addresses: null
+            cluster.remote.test_remote_cluster.proxy_socket_connections: null
+            cluster.remote.test_remote_cluster.proxy_addresses: null
 
 ---
 "skip_unavailable is returned as part of _remote/info response":
diff --git a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
index 694c1e2bddf64..928de4a0cb5e3 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
@@ -104,7 +104,7 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.RemoteClusterService;
 import org.elasticsearch.transport.RemoteConnectionStrategy;
-import org.elasticsearch.transport.SimpleConnectionStrategy;
+import org.elasticsearch.transport.ProxyConnectionStrategy;
 import org.elasticsearch.transport.SniffConnectionStrategy;
 import org.elasticsearch.transport.TransportSettings;
 import org.elasticsearch.watcher.ResourceWatcherService;
@@ -293,10 +293,9 @@ public void apply(Settings value, Settings current, Settings previous) {
             RemoteClusterService.REMOTE_CLUSTER_PING_SCHEDULE,
             RemoteClusterService.REMOTE_CLUSTER_COMPRESS,
             RemoteConnectionStrategy.REMOTE_CONNECTION_MODE,
-            SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES,
-            SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS,
-            SimpleConnectionStrategy.INCLUDE_SERVER_NAME,
-            SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD,
+            ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES,
+            ProxyConnectionStrategy.REMOTE_SOCKET_CONNECTIONS,
+            ProxyConnectionStrategy.INCLUDE_SERVER_NAME,
             SniffConnectionStrategy.REMOTE_CLUSTERS_PROXY,
             SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS,
             SniffConnectionStrategy.REMOTE_NODE_CONNECTIONS,
diff --git a/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
similarity index 84%
rename from server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
rename to server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
index 9393e4d0cafc0..dabdd771afaed 100644
--- a/server/src/main/java/org/elasticsearch/transport/SimpleConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
@@ -54,7 +54,7 @@
 import static org.elasticsearch.common.settings.Setting.boolSetting;
 import static org.elasticsearch.common.settings.Setting.intSetting;
 
-public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
+public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
 
     /**
      * A list of addresses for remote cluster connections. The connections will be opened to the configured addresses in a round-robin
@@ -62,12 +62,12 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
      */
     public static final Setting.AffixSetting<List<String>> REMOTE_CLUSTER_ADDRESSES = Setting.affixKeySetting(
         "cluster.remote.",
-        "simple.addresses",
+        "proxy_addresses",
         (ns, key) -> Setting.listSetting(key, Collections.emptyList(), s -> {
                 // validate address
                 parsePort(s);
                 return s;
-            }, new StrategyValidator<>(ns, key, ConnectionStrategy.SIMPLE),
+            }, new StrategyValidator<>(ns, key, ConnectionStrategy.PROXY),
             Setting.Property.Dynamic, Setting.Property.NodeScope));
 
     /**
@@ -75,8 +75,8 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
      */
     public static final Setting.AffixSetting<Integer> REMOTE_SOCKET_CONNECTIONS = Setting.affixKeySetting(
         "cluster.remote.",
-        "simple.socket_connections",
-        (ns, key) -> intSetting(key, 18, 1, new StrategyValidator<>(ns, key, ConnectionStrategy.SIMPLE),
+        "proxy_socket_connections",
+        (ns, key) -> intSetting(key, 18, 1, new StrategyValidator<>(ns, key, ConnectionStrategy.PROXY),
             Setting.Property.Dynamic, Setting.Property.NodeScope));
 
     /**
@@ -84,14 +84,14 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
      */
     public static final Setting.AffixSetting<Boolean> INCLUDE_SERVER_NAME = Setting.affixKeySetting(
         "cluster.remote.",
-        "simple.include_server_name",
-        (ns, key) -> boolSetting(key, false, new StrategyValidator<>(ns, key, ConnectionStrategy.SIMPLE),
+        "include_server_name",
+        (ns, key) -> boolSetting(key, false, new StrategyValidator<>(ns, key, ConnectionStrategy.PROXY),
             Setting.Property.Dynamic, Setting.Property.NodeScope));
 
     static final int CHANNELS_PER_CONNECTION = 1;
 
     private static final int MAX_CONNECT_ATTEMPTS_PER_RUN = 3;
-    private static final Logger logger = LogManager.getLogger(SimpleConnectionStrategy.class);
+    private static final Logger logger = LogManager.getLogger(ProxyConnectionStrategy.class);
 
     private final int maxNumConnections;
     private final AtomicLong counter = new AtomicLong(0);
@@ -102,8 +102,8 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
     private final ConnectionProfile profile;
     private final ConnectionManager.ConnectionValidator clusterNameValidator;
 
-    SimpleConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                             Settings settings) {
+    ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
+                            Settings settings) {
         this(
             clusterAlias,
             transportService,
@@ -113,28 +113,28 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
             INCLUDE_SERVER_NAME.getConcreteSettingForNamespace(clusterAlias).get(settings));
     }
 
-    SimpleConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                             int maxNumConnections, List<String> configuredAddresses) {
+    ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
+                            int maxNumConnections, List<String> configuredAddresses) {
         this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddresses,
             configuredAddresses.stream().map(address ->
                 (Supplier<TransportAddress>) () -> resolveAddress(address)).collect(Collectors.toList()), false);
     }
 
-    SimpleConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                             int maxNumConnections, List<String> configuredAddresses, boolean includeServerName) {
+    ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
+                            int maxNumConnections, List<String> configuredAddresses, boolean includeServerName) {
         this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddresses,
             configuredAddresses.stream().map(address ->
                 (Supplier<TransportAddress>) () -> resolveAddress(address)).collect(Collectors.toList()), includeServerName);
     }
 
-    SimpleConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                             int maxNumConnections, List<String> configuredAddresses, List<Supplier<TransportAddress>> addresses,
-                             boolean includeServerName) {
+    ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
+                            int maxNumConnections, List<String> configuredAddresses, List<Supplier<TransportAddress>> addresses,
+                            boolean includeServerName) {
         super(clusterAlias, transportService, connectionManager);
         this.maxNumConnections = maxNumConnections;
         this.configuredAddresses = configuredAddresses;
         this.includeServerName = includeServerName;
-        assert addresses.isEmpty() == false : "Cannot use simple connection strategy with no configured addresses";
+        assert addresses.isEmpty() == false : "Cannot use proxy connection strategy with no configured addresses";
         this.addresses = addresses;
         // TODO: Move into the ConnectionManager
         this.profile = new ConnectionProfile.Builder()
@@ -158,11 +158,11 @@ public class SimpleConnectionStrategy extends RemoteConnectionStrategy {
     }
 
     static Stream<Setting.AffixSetting<?>> enablementSettings() {
-        return Stream.of(SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES);
+        return Stream.of(ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES);
     }
 
     static Writeable.Reader<RemoteConnectionInfo.ModeInfo> infoReader() {
-        return SimpleModeInfo::new;
+        return ProxyModeInfo::new;
     }
 
     @Override
@@ -179,20 +179,20 @@ protected boolean strategyMustBeRebuilt(Settings newSettings) {
 
     @Override
     protected ConnectionStrategy strategyType() {
-        return ConnectionStrategy.SIMPLE;
+        return ConnectionStrategy.PROXY;
     }
 
     @Override
     protected void connectImpl(ActionListener<Void> listener) {
-        performSimpleConnectionProcess(listener);
+        performProxyConnectionProcess(listener);
     }
 
     @Override
     public RemoteConnectionInfo.ModeInfo getModeInfo() {
-        return new SimpleModeInfo(configuredAddresses, maxNumConnections, connectionManager.size());
+        return new ProxyModeInfo(configuredAddresses, maxNumConnections, connectionManager.size());
     }
 
-    private void performSimpleConnectionProcess(ActionListener<Void> listener) {
+    private void performProxyConnectionProcess(ActionListener<Void> listener) {
         openConnections(listener, 1);
     }
 
@@ -256,7 +256,7 @@ public void onFailure(Exception e) {
         } else {
             int openConnections = connectionManager.size();
             if (openConnections == 0) {
-                finished.onFailure(new IllegalStateException("Unable to open any simple connections to remote cluster [" + clusterAlias
+                finished.onFailure(new IllegalStateException("Unable to open any proxy connections to remote cluster [" + clusterAlias
                     + "]"));
             } else {
                 logger.debug("unable to open maximum number of connections [remote cluster: {}, opened: {}, maximum: {}]", clusterAlias,
@@ -285,19 +285,19 @@ private boolean addressesChanged(final List<String> oldAddresses, final List<Str
         return oldSeeds.equals(newSeeds) == false;
     }
 
-    static class SimpleModeInfo implements RemoteConnectionInfo.ModeInfo {
+    static class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
 
         private final List<String> addresses;
         private final int maxSocketConnections;
         private final int numSocketsConnected;
 
-        SimpleModeInfo(List<String> addresses, int maxSocketConnections, int numSocketsConnected) {
+        ProxyModeInfo(List<String> addresses, int maxSocketConnections, int numSocketsConnected) {
             this.addresses = addresses;
             this.maxSocketConnections = maxSocketConnections;
             this.numSocketsConnected = numSocketsConnected;
         }
 
-        private SimpleModeInfo(StreamInput input) throws IOException {
+        private ProxyModeInfo(StreamInput input) throws IOException {
             addresses = Arrays.asList(input.readStringArray());
             maxSocketConnections = input.readVInt();
             numSocketsConnected = input.readVInt();
@@ -329,22 +329,22 @@ public boolean isConnected() {
 
         @Override
         public String modeName() {
-            return "simple";
+            return "proxy";
         }
 
         @Override
         public RemoteConnectionStrategy.ConnectionStrategy modeType() {
-            return RemoteConnectionStrategy.ConnectionStrategy.SIMPLE;
+            return RemoteConnectionStrategy.ConnectionStrategy.PROXY;
         }
 
         @Override
         public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
-            SimpleModeInfo simple = (SimpleModeInfo) o;
-            return maxSocketConnections == simple.maxSocketConnections &&
-                numSocketsConnected == simple.numSocketsConnected &&
-                Objects.equals(addresses, simple.addresses);
+            ProxyModeInfo otherProxy = (ProxyModeInfo) o;
+            return maxSocketConnections == otherProxy.maxSocketConnections &&
+                numSocketsConnected == otherProxy.numSocketsConnected &&
+                Objects.equals(addresses, otherProxy.addresses);
         }
 
         @Override
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java b/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
index 63a9b857f5f7d..ba4f98d0d09a3 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
@@ -108,11 +108,10 @@ public void listenForUpdates(ClusterSettings clusterSettings) {
             RemoteConnectionStrategy.REMOTE_CONNECTION_MODE,
             SniffConnectionStrategy.REMOTE_CLUSTERS_PROXY,
             SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS,
-            SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD,
             SniffConnectionStrategy.REMOTE_NODE_CONNECTIONS,
-            SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES,
-            SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS,
-            SimpleConnectionStrategy.INCLUDE_SERVER_NAME);
+            ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES,
+            ProxyConnectionStrategy.REMOTE_SOCKET_CONNECTIONS,
+            ProxyConnectionStrategy.INCLUDE_SERVER_NAME);
         clusterSettings.addAffixGroupUpdateConsumer(remoteClusterSettings, this::validateAndUpdateRemoteCluster);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
index addd68b1c535e..562a6bfbe464f 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
@@ -65,11 +65,11 @@ public String toString() {
                 return "sniff";
             }
         },
-        SIMPLE(SimpleConnectionStrategy.CHANNELS_PER_CONNECTION, SimpleConnectionStrategy::enablementSettings,
-            SimpleConnectionStrategy::infoReader) {
+        PROXY(ProxyConnectionStrategy.CHANNELS_PER_CONNECTION, ProxyConnectionStrategy::enablementSettings,
+            ProxyConnectionStrategy::infoReader) {
             @Override
             public String toString() {
-                return "simple";
+                return "proxy";
             }
         };
 
@@ -140,8 +140,8 @@ static RemoteConnectionStrategy buildStrategy(String clusterAlias, TransportServ
         switch (mode) {
             case SNIFF:
                 return new SniffConnectionStrategy(clusterAlias, transportService, connectionManager, settings);
-            case SIMPLE:
-                return new SimpleConnectionStrategy(clusterAlias, transportService, connectionManager, settings);
+            case PROXY:
+                return new ProxyConnectionStrategy(clusterAlias, transportService, connectionManager, settings);
             default:
                 throw new AssertionError("Invalid connection strategy" + mode);
         }
@@ -159,7 +159,7 @@ public static boolean isConnectionEnabled(String clusterAlias, Settings settings
             List<String> seeds = SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace(clusterAlias).get(settings);
             return seeds.isEmpty() == false;
         } else {
-            List<String> addresses = SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias)
+            List<String> addresses = ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias)
                 .get(settings);
             return addresses.isEmpty() == false;
         }
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index bb7d6202c59b7..97b5e318841d6 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -68,7 +68,7 @@ public class SniffConnectionStrategy extends RemoteConnectionStrategy {
     /**
      * A list of initial seed nodes to discover eligible nodes from the remote cluster
      */
-    public static final Setting.AffixSetting<List<String>> REMOTE_CLUSTER_SEEDS_OLD = Setting.affixKeySetting(
+    public static final Setting.AffixSetting<List<String>> REMOTE_CLUSTER_SEEDS = Setting.affixKeySetting(
         "cluster.remote.",
         "seeds",
         (ns, key) -> Setting.listSetting(
@@ -83,24 +83,6 @@ public class SniffConnectionStrategy extends RemoteConnectionStrategy {
             Setting.Property.Dynamic,
             Setting.Property.NodeScope));
 
-    /**
-     * A list of initial seed nodes to discover eligible nodes from the remote cluster
-     */
-    public static final Setting.AffixSetting<List<String>> REMOTE_CLUSTER_SEEDS = Setting.affixKeySetting(
-        "cluster.remote.",
-        "sniff.seeds",
-        (ns, key) -> Setting.listSetting(key,
-            REMOTE_CLUSTER_SEEDS_OLD.getConcreteSettingForNamespace(ns),
-            s -> {
-                // validate seed address
-                parsePort(s);
-                return s;
-            },
-            s -> REMOTE_CLUSTER_SEEDS_OLD.getConcreteSettingForNamespace(ns).get(s),
-            new StrategyValidator<>(ns, key, ConnectionStrategy.SNIFF),
-            Setting.Property.Dynamic,
-            Setting.Property.NodeScope));
-
 
     /**
      * A proxy address for the remote cluster. By default this is not set, meaning that Elasticsearch will connect directly to the nodes in
@@ -138,7 +120,7 @@ public class SniffConnectionStrategy extends RemoteConnectionStrategy {
      */
     public static final Setting.AffixSetting<Integer> REMOTE_NODE_CONNECTIONS = Setting.affixKeySetting(
         "cluster.remote.",
-        "sniff.node_connections",
+        "node_connections",
         (ns, key) -> intSetting(
             key,
             REMOTE_CONNECTIONS_PER_CLUSTER,
@@ -194,7 +176,7 @@ public class SniffConnectionStrategy extends RemoteConnectionStrategy {
     }
 
     static Stream<Setting.AffixSetting<?>> enablementSettings() {
-        return Stream.of(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS, SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD);
+        return Stream.of(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS);
     }
 
     static Writeable.Reader<RemoteConnectionInfo.ModeInfo> infoReader() {
diff --git a/server/src/test/java/org/elasticsearch/action/search/TransportSearchActionTests.java b/server/src/test/java/org/elasticsearch/action/search/TransportSearchActionTests.java
index e9aeff6847ad5..105bcc66ac1c3 100644
--- a/server/src/test/java/org/elasticsearch/action/search/TransportSearchActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/search/TransportSearchActionTests.java
@@ -351,7 +351,7 @@ private MockTransportService[] startTransport(int numClusters, DiscoveryNode[] n
             DiscoveryNode remoteSeedNode = remoteSeedTransport.getLocalDiscoNode();
             knownNodes.add(remoteSeedNode);
             nodes[i] = remoteSeedNode;
-            settingsBuilder.put("cluster.remote.remote" + i + ".sniff.seeds", remoteSeedNode.getAddress().toString());
+            settingsBuilder.put("cluster.remote.remote" + i + ".seeds", remoteSeedNode.getAddress().toString());
             remoteIndices.put("remote" + i, new OriginalIndices(new String[]{"index"}, IndicesOptions.lenientExpandOpen()));
         }
         return mockTransportServices;
diff --git a/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
similarity index 91%
rename from server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java
rename to server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
index 53fe4a04d379c..5644ff895725d 100644
--- a/server/src/test/java/org/elasticsearch/transport/SimpleConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
@@ -48,11 +48,11 @@
 import java.util.function.Supplier;
 import java.util.stream.Collectors;
 
-public class SimpleConnectionStrategyTests extends ESTestCase {
+public class ProxyConnectionStrategyTests extends ESTestCase {
 
     private final String clusterAlias = "cluster-alias";
     private final String modeKey = RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace(clusterAlias).getKey();
-    private final Settings settings = Settings.builder().put(modeKey, "simple").build();
+    private final Settings settings = Settings.builder().put(modeKey, "proxy").build();
     private final ConnectionProfile profile = RemoteConnectionStrategy.buildConnectionProfile("cluster", settings);
     private final ThreadPool threadPool = new TestThreadPool(getClass().getName());
 
@@ -86,7 +86,7 @@ public MockTransportService startTransport(final String id, final Version versio
         }
     }
 
-    public void testSimpleStrategyWillOpenExpectedNumberOfConnectionsToAddresses() {
+    public void testProxyStrategyWillOpenExpectedNumberOfConnectionsToAddresses() {
         try (MockTransportService transport1 = startTransport("node1", Version.CURRENT);
              MockTransportService transport2 = startTransport("node2", Version.CURRENT)) {
             TransportAddress address1 = transport1.boundAddress().publishAddress();
@@ -99,7 +99,7 @@ public void testSimpleStrategyWillOpenExpectedNumberOfConnectionsToAddresses() {
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
                          numOfConnections, addresses(address1, address2))) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
@@ -117,7 +117,7 @@ numOfConnections, addresses(address1, address2))) {
         }
     }
 
-    public void testSimpleStrategyWillOpenNewConnectionsOnDisconnect() throws Exception {
+    public void testProxyStrategyWillOpenNewConnectionsOnDisconnect() throws Exception {
         try (MockTransportService transport1 = startTransport("node1", Version.CURRENT);
              MockTransportService transport2 = startTransport("node2", Version.CURRENT)) {
             TransportAddress address1 = transport1.boundAddress().publishAddress();
@@ -130,7 +130,7 @@ public void testSimpleStrategyWillOpenNewConnectionsOnDisconnect() throws Except
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
                          numOfConnections, addresses(address1, address2))) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
@@ -191,7 +191,7 @@ public void testConnectWithSingleIncompatibleNode() {
                 });
                 int numOfConnections = 5;
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
                          numOfConnections, addresses(address1, address2))) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
@@ -225,7 +225,7 @@ public void testConnectFailsWithIncompatibleNodes() {
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
                          numOfConnections, addresses(address1))) {
 
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
@@ -255,7 +255,7 @@ public void testClusterNameValidationPreventConnectingToDifferentClusters() thro
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
                          numOfConnections, addresses(address1, address2))) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
@@ -275,7 +275,7 @@ numOfConnections, addresses(address1, address2))) {
         }
     }
 
-    public void testSimpleStrategyWillResolveAddressesEachConnect() throws Exception {
+    public void testProxyStrategyWillResolveAddressesEachConnect() throws Exception {
         try (MockTransportService transport1 = startTransport("seed_node", Version.CURRENT)) {
             TransportAddress address = transport1.boundAddress().publishAddress();
 
@@ -292,7 +292,7 @@ public void testSimpleStrategyWillResolveAddressesEachConnect() throws Exception
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
                          numOfConnections,  addresses(address), Collections.singletonList(addressSupplier), false)) {
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
                     strategy.connect(connectFuture);
@@ -306,7 +306,7 @@ numOfConnections,  addresses(address), Collections.singletonList(addressSupplier
         }
     }
 
-    public void testSimpleStrategyWillNeedToBeRebuiltIfNumOfSocketsOrAddressesChange() {
+    public void testProxyStrategyWillNeedToBeRebuiltIfNumOfSocketsOrAddressesChange() {
         try (MockTransportService transport1 = startTransport("node1", Version.CURRENT);
              MockTransportService transport2 = startTransport("node2", Version.CURRENT)) {
             TransportAddress address1 = transport1.boundAddress().publishAddress();
@@ -319,7 +319,7 @@ public void testSimpleStrategyWillNeedToBeRebuiltIfNumOfSocketsOrAddressesChange
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
                          numOfConnections, addresses(address1, address2))) {
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
                     strategy.connect(connectFuture);
@@ -332,24 +332,24 @@ numOfConnections, addresses(address1, address2))) {
 
                     Setting<?> modeSetting = RemoteConnectionStrategy.REMOTE_CONNECTION_MODE
                         .getConcreteSettingForNamespace("cluster-alias");
-                    Setting<?> addressesSetting = SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES
+                    Setting<?> addressesSetting = ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES
                         .getConcreteSettingForNamespace("cluster-alias");
-                    Setting<?> socketConnections = SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS
+                    Setting<?> socketConnections = ProxyConnectionStrategy.REMOTE_SOCKET_CONNECTIONS
                         .getConcreteSettingForNamespace("cluster-alias");
 
                     Settings noChange = Settings.builder()
-                        .put(modeSetting.getKey(), "simple")
+                        .put(modeSetting.getKey(), "proxy")
                         .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1, address2).toArray()))
                         .put(socketConnections.getKey(), numOfConnections)
                         .build();
                     assertFalse(strategy.shouldRebuildConnection(noChange));
                     Settings addressesChanged = Settings.builder()
-                        .put(modeSetting.getKey(), "simple")
+                        .put(modeSetting.getKey(), "proxy")
                         .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1).toArray()))
                         .build();
                     assertTrue(strategy.shouldRebuildConnection(addressesChanged));
                     Settings socketsChanged = Settings.builder()
-                        .put(modeSetting.getKey(), "simple")
+                        .put(modeSetting.getKey(), "proxy")
                         .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1, address2).toArray()))
                         .put(socketConnections.getKey(), numOfConnections + 1)
                         .build();
@@ -361,8 +361,8 @@ numOfConnections, addresses(address1, address2))) {
 
     public void testModeSettingsCannotBeUsedWhenInDifferentMode() {
         List<Tuple<Setting.AffixSetting<?>, String>> restrictedSettings = Arrays.asList(
-            new Tuple<>(SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES, "192.168.0.1:8080"),
-            new Tuple<>(SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS, "3"));
+            new Tuple<>(ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES, "192.168.0.1:8080"),
+            new Tuple<>(ProxyConnectionStrategy.REMOTE_SOCKET_CONNECTIONS, "3"));
 
         RemoteConnectionStrategy.ConnectionStrategy sniff = RemoteConnectionStrategy.ConnectionStrategy.SNIFF;
 
@@ -384,7 +384,7 @@ public void testModeSettingsCannotBeUsedWhenInDifferentMode() {
             Settings invalid = Settings.builder().put(settings).put(concreteSetting.getKey(), restrictedSetting.v2()).build();
             IllegalArgumentException iae = expectThrows(IllegalArgumentException.class, () -> service.validate(invalid, true));
             String expected = "Setting \"" + concreteSetting.getKey() + "\" cannot be used with the configured " +
-                "\"cluster.remote.cluster_name.mode\" [required=SIMPLE, configured=SNIFF]";
+                "\"cluster.remote.cluster_name.mode\" [required=PROXY, configured=SNIFF]";
             assertEquals(expected, iae.getMessage());
         }
     }
@@ -404,7 +404,7 @@ public void testServerNameAttributes() {
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     SimpleConnectionStrategy strategy = new SimpleConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
+                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
                          numOfConnections, addresses, true)) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
 
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteClusterAwareClientTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteClusterAwareClientTests.java
index c3a0eefffb67f..1a6eaff9e5a2e 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteClusterAwareClientTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteClusterAwareClientTests.java
@@ -65,7 +65,7 @@ public void testSearchShards() throws Exception {
             knownNodes.add(discoverableTransport.getLocalDiscoNode());
             Collections.shuffle(knownNodes, random());
             Settings.Builder builder = Settings.builder();
-            builder.putList("cluster.remote.cluster1.sniff.seeds", seedTransport.getLocalDiscoNode().getAddress().toString());
+            builder.putList("cluster.remote.cluster1.seeds", seedTransport.getLocalDiscoNode().getAddress().toString());
             try (MockTransportService service = MockTransportService.createNewService(builder.build(), Version.CURRENT, threadPool, null)) {
                 service.start();
                 service.acceptIncomingRequests();
@@ -96,7 +96,7 @@ public void testSearchShardsThreadContextHeader() {
             knownNodes.add(discoverableTransport.getLocalDiscoNode());
             Collections.shuffle(knownNodes, random());
             Settings.Builder builder = Settings.builder();
-            builder.putList("cluster.remote.cluster1.sniff.seeds", seedTransport.getLocalDiscoNode().getAddress().toString());
+            builder.putList("cluster.remote.cluster1.seeds", seedTransport.getLocalDiscoNode().getAddress().toString());
             try (MockTransportService service = MockTransportService.createNewService(builder.build(), Version.CURRENT, threadPool, null)) {
                 service.start();
                 service.acceptIncomingRequests();
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteClusterClientTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteClusterClientTests.java
index 76f76b627b569..ed71b7f85c863 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteClusterClientTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteClusterClientTests.java
@@ -52,7 +52,7 @@ public void testConnectAndExecuteRequest() throws Exception {
 
             Settings localSettings = Settings.builder()
                 .put(RemoteClusterService.ENABLE_REMOTE_CLUSTERS.getKey(), true)
-                .put("cluster.remote.test.sniff.seeds",
+                .put("cluster.remote.test.seeds",
                     remoteNode.getAddress().getAddress() + ":" + remoteNode.getAddress().getPort()).build();
             try (MockTransportService service = MockTransportService.createNewService(localSettings, Version.CURRENT, threadPool, null)) {
                 service.start();
@@ -81,7 +81,7 @@ public void testEnsureWeReconnect() throws Exception {
             DiscoveryNode remoteNode = remoteTransport.getLocalDiscoNode();
             Settings localSettings = Settings.builder()
                 .put(RemoteClusterService.ENABLE_REMOTE_CLUSTERS.getKey(), true)
-                .put("cluster.remote.test.sniff.seeds",
+                .put("cluster.remote.test.seeds",
                     remoteNode.getAddress().getAddress() + ":" + remoteNode.getAddress().getPort()).build();
             try (MockTransportService service = MockTransportService.createNewService(localSettings, Version.CURRENT, threadPool, null)) {
                 Semaphore semaphore = new Semaphore(1);
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
index 934cf81a503ea..030174dde5f90 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
@@ -356,7 +356,7 @@ public void testRemoteConnectionInfo() throws IOException {
             modeInfo1 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 4, 4);
             modeInfo2 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 4, 3);
         } else {
-            modeInfo1 = new SimpleConnectionStrategy.SimpleModeInfo(remoteAddresses, 18, 18);
+            modeInfo1 = new ProxyConnectionStrategy.ProxyModeInfo(remoteAddresses, 18, 18);
             modeInfo2 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 18, 17);
         }
 
@@ -404,7 +404,7 @@ public void testRenderConnectionInfoXContent() throws IOException {
         if (sniff) {
             modeInfo = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 3, 2);
         } else {
-            modeInfo = new SimpleConnectionStrategy.SimpleModeInfo(remoteAddresses, 18, 16);
+            modeInfo = new ProxyConnectionStrategy.ProxyModeInfo(remoteAddresses, 18, 16);
         }
 
         RemoteConnectionInfo stats = new RemoteConnectionInfo("test_cluster", modeInfo, TimeValue.timeValueMinutes(30), true);
@@ -419,7 +419,7 @@ public void testRenderConnectionInfoXContent() throws IOException {
                 "\"num_nodes_connected\":2,\"max_connections_per_cluster\":3,\"initial_connect_timeout\":\"30m\"," +
                 "\"skip_unavailable\":true}}", Strings.toString(builder));
         } else {
-            assertEquals("{\"test_cluster\":{\"connected\":true,\"mode\":\"simple\",\"addresses\":[\"seed:1\",\"seed:2\"]," +
+            assertEquals("{\"test_cluster\":{\"connected\":true,\"mode\":\"proxy\",\"addresses\":[\"seed:1\",\"seed:2\"]," +
                 "\"num_sockets_connected\":16,\"max_socket_connections\":18,\"initial_connect_timeout\":\"30m\"," +
                 "\"skip_unavailable\":true}}", Strings.toString(builder));
         }
@@ -611,30 +611,25 @@ public void sendRequest(long requestId, String action, TransportRequest request,
 
     private Settings buildRandomSettings(String clusterAlias, List<String> addresses) {
         if (randomBoolean()) {
-            return buildSimpleSettings(clusterAlias, addresses);
+            return buildProxySettings(clusterAlias, addresses);
         } else {
             return buildSniffSettings(clusterAlias, addresses);
         }
     }
 
-    private static Settings buildSimpleSettings(String clusterAlias, List<String> addresses) {
+    private static Settings buildProxySettings(String clusterAlias, List<String> addresses) {
         Settings.Builder builder = Settings.builder();
-        builder.put(SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).getKey(),
+        builder.put(ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).getKey(),
             Strings.collectionToCommaDelimitedString(addresses));
-        builder.put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace(clusterAlias).getKey(), "simple");
+        builder.put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace(clusterAlias).getKey(), "proxy");
         return builder.build();
     }
 
     private static Settings buildSniffSettings(String clusterAlias, List<String> seedNodes) {
         Settings.Builder builder = Settings.builder();
         builder.put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace(clusterAlias).getKey(), "sniff");
-        if (randomBoolean()) {
-            builder.put(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD.getConcreteSettingForNamespace(clusterAlias).getKey(),
-                Strings.collectionToCommaDelimitedString(seedNodes));
-        } else {
-            builder.put(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace(clusterAlias).getKey(),
-                Strings.collectionToCommaDelimitedString(seedNodes));
-        }
+        builder.put(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace(clusterAlias).getKey(),
+            Strings.collectionToCommaDelimitedString(seedNodes));
         return builder.build();
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteClusterServiceTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteClusterServiceTests.java
index 0fdc797b8b377..e0e9b69ae29f8 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteClusterServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteClusterServiceTests.java
@@ -84,27 +84,26 @@ public void testSettingsAreRegistered() {
         assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE));
         assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(SniffConnectionStrategy.REMOTE_CONNECTIONS_PER_CLUSTER));
         assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS));
-        assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD));
         assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(SniffConnectionStrategy.REMOTE_NODE_CONNECTIONS));
-        assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(SimpleConnectionStrategy.REMOTE_CLUSTER_ADDRESSES));
-        assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(SimpleConnectionStrategy.REMOTE_SOCKET_CONNECTIONS));
+        assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES));
+        assertTrue(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS.contains(ProxyConnectionStrategy.REMOTE_SOCKET_CONNECTIONS));
     }
 
     public void testRemoteClusterSeedSetting() {
         // simple validation
         Settings settings = Settings.builder()
-            .put("cluster.remote.foo.sniff.seeds", "192.168.0.1:8080")
-            .put("cluster.remote.bar.sniff.seed", "[::1]:9090").build();
+            .put("cluster.remote.foo.seeds", "192.168.0.1:8080")
+            .put("cluster.remote.bar.seeds", "[::1]:9090").build();
         SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getAllConcreteSettings(settings).forEach(setting -> setting.get(settings));
 
         Settings brokenSettings = Settings.builder()
-            .put("cluster.remote.foo.sniff.seeds", "192.168.0.1").build();
+            .put("cluster.remote.foo.seeds", "192.168.0.1").build();
         expectThrows(IllegalArgumentException.class, () ->
             SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS
                 .getAllConcreteSettings(brokenSettings).forEach(setting -> setting.get(brokenSettings)));
 
         Settings brokenPortSettings = Settings.builder()
-            .put("cluster.remote.foo.sniff.seeds", "192.168.0.1:123456789123456789").build();
+            .put("cluster.remote.foo.seeds", "192.168.0.1:123456789123456789").build();
         Exception e = expectThrows(
             IllegalArgumentException.class,
             () -> SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getAllConcreteSettings(brokenSettings)
@@ -128,8 +127,8 @@ public void testGroupClusterIndices() throws IOException {
                 transportService.start();
                 transportService.acceptIncomingRequests();
                 Settings.Builder builder = Settings.builder();
-                builder.putList("cluster.remote.cluster_1.sniff.seeds", cluster1Seed.getAddress().toString());
-                builder.putList("cluster.remote.cluster_2.sniff.seeds", cluster2Seed.getAddress().toString());
+                builder.putList("cluster.remote.cluster_1.seeds", cluster1Seed.getAddress().toString());
+                builder.putList("cluster.remote.cluster_2.seeds", cluster2Seed.getAddress().toString());
                 try (RemoteClusterService service = new RemoteClusterService(builder.build(), transportService)) {
                     assertFalse(service.isCrossClusterSearchEnabled());
                     service.initializeRemoteClusters();
@@ -354,7 +353,7 @@ public void testChangeSettings() throws Exception {
                 transportService.start();
                 transportService.acceptIncomingRequests();
                 Settings.Builder builder = Settings.builder();
-                builder.putList("cluster.remote.cluster_1.sniff.seeds", cluster1Seed.getAddress().toString());
+                builder.putList("cluster.remote.cluster_1.seeds", cluster1Seed.getAddress().toString());
                 try (RemoteClusterService service = new RemoteClusterService(builder.build(), transportService)) {
                     service.initializeRemoteClusters();
                     RemoteClusterConnection remoteClusterConnection = service.getRemoteClusterConnection("cluster_1");
@@ -363,7 +362,7 @@ public void testChangeSettings() throws Exception {
                     settingsChange.put("cluster.remote.cluster_1.transport.ping_schedule", pingSchedule);
                     boolean compressionEnabled = true;
                     settingsChange.put("cluster.remote.cluster_1.transport.compress", compressionEnabled);
-                    settingsChange.putList("cluster.remote.cluster_1.sniff.seeds", cluster1Seed.getAddress().toString());
+                    settingsChange.putList("cluster.remote.cluster_1.seeds", cluster1Seed.getAddress().toString());
                     service.validateAndUpdateRemoteCluster("cluster_1", settingsChange.build());
                     assertBusy(remoteClusterConnection::isClosed);
 
@@ -408,9 +407,9 @@ public void testRemoteNodeAttribute() throws IOException, InterruptedException {
                 transportService.acceptIncomingRequests();
                 final Settings.Builder builder = Settings.builder();
                 builder.putList(
-                        "cluster.remote.cluster_1.sniff.seeds", c1N1Node.getAddress().toString());
+                        "cluster.remote.cluster_1.seed", c1N1Node.getAddress().toString());
                 builder.putList(
-                        "cluster.remote.cluster_2.sniff.seeds", c2N1Node.getAddress().toString());
+                        "cluster.remote.cluster_2.seed", c2N1Node.getAddress().toString());
                 try (RemoteClusterService service =
                              new RemoteClusterService(settings, transportService)) {
                     assertFalse(service.isCrossClusterSearchEnabled());
@@ -475,8 +474,8 @@ public void testRemoteNodeRoles() throws IOException, InterruptedException {
                 transportService.start();
                 transportService.acceptIncomingRequests();
                 final Settings.Builder builder = Settings.builder();
-                builder.putList("cluster.remote.cluster_1.sniff.seeds", c1N1Node.getAddress().toString());
-                builder.putList("cluster.remote.cluster_2.sniff.seeds", c2N1Node.getAddress().toString());
+                builder.putList("cluster.remote.cluster_1.seed", c1N1Node.getAddress().toString());
+                builder.putList("cluster.remote.cluster_2.seed", c2N1Node.getAddress().toString());
                 try (RemoteClusterService service = new RemoteClusterService(settings, transportService)) {
                     assertFalse(service.isCrossClusterSearchEnabled());
                     service.initializeRemoteClusters();
@@ -546,9 +545,9 @@ public void testCollectNodes() throws InterruptedException, IOException {
                 transportService.acceptIncomingRequests();
                 final Settings.Builder builder = Settings.builder();
                 builder.putList(
-                    "cluster.remote.cluster_1.sniff.seeds", c1N1Node.getAddress().toString());
+                    "cluster.remote.cluster_1.seed", c1N1Node.getAddress().toString());
                 builder.putList(
-                    "cluster.remote.cluster_2.sniff.seeds", c2N1Node.getAddress().toString());
+                    "cluster.remote.cluster_2.seed", c2N1Node.getAddress().toString());
                 try (RemoteClusterService service =
                          new RemoteClusterService(settings, transportService)) {
                     assertFalse(service.isCrossClusterSearchEnabled());
@@ -678,12 +677,12 @@ public void testRemoteClusterSkipIfDisconnectedSetting() {
         }
 
         AbstractScopedSettings service = new ClusterSettings(Settings.EMPTY,
-                new HashSet<>(Arrays.asList(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS, SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD,
-                        RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE)));
+                new HashSet<>(Arrays.asList(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS,
+                    RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE)));
         {
             Settings settings = Settings.builder().put("cluster.remote.foo.skip_unavailable", randomBoolean()).build();
             IllegalArgumentException iae = expectThrows(IllegalArgumentException.class, () -> service.validate(settings, true));
-            assertEquals("missing required setting [cluster.remote.foo.sniff.seeds] for setting [cluster.remote.foo.skip_unavailable]",
+            assertEquals("missing required setting [cluster.remote.foo.seeds] for setting [cluster.remote.foo.skip_unavailable]",
                     iae.getMessage());
         }
         {
@@ -691,11 +690,11 @@ public void testRemoteClusterSkipIfDisconnectedSetting() {
                 String seed = remoteSeedTransport.getLocalDiscoNode().getAddress().toString();
                 service.validate(Settings.builder().put("cluster.remote.foo.skip_unavailable", randomBoolean())
                         .put("cluster.remote.foo.seeds", seed).build(), true);
-                service.validate(Settings.builder().put("cluster.remote.foo.sniff.seeds", seed).build(), true);
+                service.validate(Settings.builder().put("cluster.remote.foo.seeds", seed).build(), true);
 
                 AbstractScopedSettings service2 = new ClusterSettings(Settings.builder().put("cluster.remote.foo.seeds", seed).build(),
-                        new HashSet<>(Arrays.asList(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD,
-                                RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE)));
+                        new HashSet<>(Arrays.asList(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS,
+                            RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE)));
                 service2.validate(Settings.builder().put("cluster.remote.foo.skip_unavailable", randomBoolean()).build(), false);
             }
         }
@@ -718,7 +717,7 @@ public void testReconnectWhenStrategySettingsUpdated() throws Exception {
                 transportService.acceptIncomingRequests();
 
                 final Settings.Builder builder = Settings.builder();
-                builder.putList("cluster.remote.cluster_test.sniff.seeds", Collections.singletonList(node0.getAddress().toString()));
+                builder.putList("cluster.remote.cluster_test.seeds", Collections.singletonList(node0.getAddress().toString()));
                 try (RemoteClusterService service = new RemoteClusterService(builder.build(), transportService)) {
                     assertFalse(service.isCrossClusterSearchEnabled());
                     service.initializeRemoteClusters();
@@ -814,13 +813,8 @@ public void testSkipUnavailable() {
 
     private static Settings createSettings(String clusterAlias, List<String> seeds) {
         Settings.Builder builder = Settings.builder();
-        if (randomBoolean()) {
-            builder.put(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD.getConcreteSettingForNamespace(clusterAlias).getKey(),
-                Strings.collectionToCommaDelimitedString(seeds));
-        } else {
-            builder.put(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace(clusterAlias).getKey(),
-                Strings.collectionToCommaDelimitedString(seeds));
-        }
+        builder.put(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace(clusterAlias).getKey(),
+            Strings.collectionToCommaDelimitedString(seeds));
         return builder.build();
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteClusterSettingsTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteClusterSettingsTests.java
index af855314278f7..0f2749ffacf6c 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteClusterSettingsTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteClusterSettingsTests.java
@@ -26,9 +26,9 @@
 import java.util.concurrent.TimeUnit;
 
 import static org.elasticsearch.transport.SniffConnectionStrategy.REMOTE_CLUSTERS_PROXY;
-import static org.elasticsearch.transport.SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD;
 import static org.elasticsearch.transport.RemoteClusterService.ENABLE_REMOTE_CLUSTERS;
 import static org.elasticsearch.transport.RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE;
+import static org.elasticsearch.transport.SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS;
 import static org.elasticsearch.transport.SniffConnectionStrategy.REMOTE_CONNECTIONS_PER_CLUSTER;
 import static org.elasticsearch.transport.RemoteClusterService.REMOTE_INITIAL_CONNECTION_TIMEOUT_SETTING;
 import static org.elasticsearch.transport.RemoteClusterService.REMOTE_NODE_ATTRIBUTE;
@@ -60,7 +60,7 @@ public void testSkipUnavailableDefault() {
 
     public void testSeedsDefault() {
         final String alias = randomAlphaOfLength(8);
-        assertThat(REMOTE_CLUSTER_SEEDS_OLD.getConcreteSettingForNamespace(alias).get(Settings.EMPTY), emptyCollectionOf(String.class));
+        assertThat(REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace(alias).get(Settings.EMPTY), emptyCollectionOf(String.class));
     }
 
     public void testProxyDefault() {
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteConnectionStrategyTests.java
index 2c6fc691ec5bd..814a3bd1913b1 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteConnectionStrategyTests.java
@@ -33,7 +33,7 @@ public void testStrategyChangeMeansThatStrategyMustBeRebuilt() {
         ConnectionManager connectionManager = new ConnectionManager(Settings.EMPTY, mock(Transport.class));
         RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager("cluster-alias", connectionManager);
         FakeConnectionStrategy first = new FakeConnectionStrategy("cluster-alias", mock(TransportService.class), remoteConnectionManager,
-            RemoteConnectionStrategy.ConnectionStrategy.SIMPLE);
+            RemoteConnectionStrategy.ConnectionStrategy.PROXY);
         Settings newSettings = Settings.builder()
             .put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace("cluster-alias").getKey(), "sniff")
             .build();
@@ -44,9 +44,9 @@ public void testSameStrategyChangeMeansThatStrategyDoesNotNeedToBeRebuilt() {
         ConnectionManager connectionManager = new ConnectionManager(Settings.EMPTY, mock(Transport.class));
         RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager("cluster-alias", connectionManager);
         FakeConnectionStrategy first = new FakeConnectionStrategy("cluster-alias", mock(TransportService.class), remoteConnectionManager,
-            RemoteConnectionStrategy.ConnectionStrategy.SIMPLE);
+            RemoteConnectionStrategy.ConnectionStrategy.PROXY);
         Settings newSettings = Settings.builder()
-            .put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace("cluster-alias").getKey(), "simple")
+            .put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace("cluster-alias").getKey(), "proxy")
             .build();
         assertFalse(first.shouldRebuildConnection(newSettings));
     }
@@ -57,10 +57,10 @@ public void testChangeInConnectionProfileMeansTheStrategyMustBeRebuilt() {
         assertEquals(false, connectionManager.getConnectionProfile().getCompressionEnabled());
         RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager("cluster-alias", connectionManager);
         FakeConnectionStrategy first = new FakeConnectionStrategy("cluster-alias", mock(TransportService.class), remoteConnectionManager,
-            RemoteConnectionStrategy.ConnectionStrategy.SIMPLE);
+            RemoteConnectionStrategy.ConnectionStrategy.PROXY);
 
         Settings.Builder newBuilder = Settings.builder();
-        newBuilder.put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace("cluster-alias").getKey(), "simple");
+        newBuilder.put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace("cluster-alias").getKey(), "proxy");
         if (randomBoolean()) {
             newBuilder.put(RemoteClusterService.REMOTE_CLUSTER_PING_SCHEDULE.getConcreteSettingForNamespace("cluster-alias").getKey(),
                 TimeValue.timeValueSeconds(5));
@@ -75,10 +75,10 @@ public void testCorrectChannelNumber() {
 
         for (RemoteConnectionStrategy.ConnectionStrategy strategy : RemoteConnectionStrategy.ConnectionStrategy.values()) {
             String settingKey = RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace(clusterAlias).getKey();
-            Settings simpleSettings = Settings.builder().put(settingKey, strategy.name()).build();
-            ConnectionProfile simpleProfile = RemoteConnectionStrategy.buildConnectionProfile(clusterAlias, simpleSettings);
+            Settings proxySettings = Settings.builder().put(settingKey, strategy.name()).build();
+            ConnectionProfile proxyProfile = RemoteConnectionStrategy.buildConnectionProfile(clusterAlias, proxySettings);
             assertEquals("Incorrect number of channels for " + strategy.name(),
-                strategy.getNumberOfChannels(), simpleProfile.getNumConnections());
+                strategy.getNumberOfChannels(), proxyProfile.getNumConnections());
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/transport/SniffConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/SniffConnectionStrategyTests.java
index 30f30723c19a8..9302e61d13710 100644
--- a/server/src/test/java/org/elasticsearch/transport/SniffConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/SniffConnectionStrategyTests.java
@@ -652,14 +652,13 @@ public void testGetNodePredicatesCombination() {
     public void testModeSettingsCannotBeUsedWhenInDifferentMode() {
         List<Tuple<Setting.AffixSetting<?>, String>> restrictedSettings = Arrays.asList(
             new Tuple<>(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS, "192.168.0.1:8080"),
-            new Tuple<>(SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD, "192.168.0.1:8080"),
             new Tuple<>(SniffConnectionStrategy.REMOTE_NODE_CONNECTIONS, "2"));
 
-        RemoteConnectionStrategy.ConnectionStrategy simple = RemoteConnectionStrategy.ConnectionStrategy.SIMPLE;
+        RemoteConnectionStrategy.ConnectionStrategy proxy = RemoteConnectionStrategy.ConnectionStrategy.PROXY;
 
         String clusterName = "cluster_name";
         Settings settings = Settings.builder()
-            .put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace(clusterName).getKey(), simple.name())
+            .put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace(clusterName).getKey(), proxy.name())
             .build();
 
         Set<Setting<?>> clusterSettings = new HashSet<>();
@@ -675,7 +674,7 @@ public void testModeSettingsCannotBeUsedWhenInDifferentMode() {
             Settings invalid = Settings.builder().put(settings).put(concreteSetting.getKey(), restrictedSetting.v2()).build();
             IllegalArgumentException iae = expectThrows(IllegalArgumentException.class, () -> service.validate(invalid, true));
             String expected = "Setting \"" + concreteSetting.getKey() + "\" cannot be used with the configured " +
-                "\"cluster.remote.cluster_name.mode\" [required=SNIFF, configured=SIMPLE]";
+                "\"cluster.remote.cluster_name.mode\" [required=SNIFF, configured=PROXY]";
             assertEquals(expected, iae.getMessage());
         }
     }
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
index 7bede18aea08d..e25c0be5731ae 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
@@ -1389,7 +1389,7 @@ public void testUpdateRemoteConfigsDuringFollowing() throws Exception {
             ClusterUpdateSettingsRequest settingsRequest = new ClusterUpdateSettingsRequest();
             String address = getLeaderCluster().getDataNodeInstance(TransportService.class).boundAddress().publishAddress().toString();
             Setting<Boolean> compress = RemoteClusterService.REMOTE_CLUSTER_COMPRESS.getConcreteSettingForNamespace("leader_cluster");
-            Setting<List<String>> seeds = SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS_OLD.getConcreteSettingForNamespace("leader_cluster");
+            Setting<List<String>> seeds = SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace("leader_cluster");
             settingsRequest.persistentSettings(Settings.builder().put(compress.getKey(), compress.getDefault(Settings.EMPTY))
                 .put(seeds.getKey(), address));
             assertAcked(followerClient().admin().cluster().updateSettings(settingsRequest).actionGet());
diff --git a/x-pack/qa/multi-cluster-search-security/src/test/resources/rest-api-spec/test/multi_cluster/70_connection_mode_configuration.yml b/x-pack/qa/multi-cluster-search-security/src/test/resources/rest-api-spec/test/multi_cluster/70_connection_mode_configuration.yml
index ed639b3655ed5..5606a08cd261e 100644
--- a/x-pack/qa/multi-cluster-search-security/src/test/resources/rest-api-spec/test/multi_cluster/70_connection_mode_configuration.yml
+++ b/x-pack/qa/multi-cluster-search-security/src/test/resources/rest-api-spec/test/multi_cluster/70_connection_mode_configuration.yml
@@ -1,5 +1,5 @@
 ---
-"Add transient remote cluster in simple mode with invalid sniff settings":
+"Add transient remote cluster in proxy mode with invalid sniff settings":
   - do:
       cluster.get_settings:
         include_defaults: true
@@ -12,14 +12,14 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.sniff.node_connections: "5"
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.node_connections: "5"
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.sniff.node_connections\" cannot be
-  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=SIMPLE]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.node_connections\" cannot be
+  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=PROXY]" }
 
   - do:
       catch: bad_request
@@ -27,17 +27,17 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.sniff.seeds\" cannot be
-   used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=SIMPLE]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.seeds\" cannot be
+   used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=PROXY]" }
 
 ---
-"Add transient remote cluster in sniff mode with invalid simple settings":
+"Add transient remote cluster in sniff mode with invalid proxy settings":
   - do:
       cluster.get_settings:
         include_defaults: true
@@ -50,13 +50,13 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.simple.socket_connections: "20"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_socket_connections: "20"
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.simple.socket_connections\" cannot be
-  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SIMPLE, configured=SNIFF]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.proxy_socket_connections\" cannot be
+  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=PROXY, configured=SNIFF]" }
 
   - do:
       catch: bad_request
@@ -64,16 +64,16 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.simple.addresses\" cannot be
-   used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SIMPLE, configured=SNIFF]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.proxy_addresses\" cannot be
+   used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=PROXY, configured=SNIFF]" }
 
 ---
-"Add transient remote cluster using simple connection mode using valid settings":
+"Add transient remote cluster using proxy connection mode using valid settings":
   - do:
       cluster.get_settings:
         include_defaults: true
@@ -85,13 +85,13 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.simple.socket_connections: "3"
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.proxy_socket_connections: "3"
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
-  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "simple"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.socket_connections: "3"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_socket_connections: "3"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
 
   - do:
       search:
@@ -120,12 +120,12 @@
         body:
           transient:
             cluster.remote.test_remote_cluster.mode: "sniff"
-            cluster.remote.test_remote_cluster.sniff.node_connections: "3"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.node_connections: "3"
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "sniff"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.node_connections: "3"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.seeds: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.node_connections: "3"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.seeds: $remote_ip}
 
   - do:
       search:
@@ -154,10 +154,10 @@
         body:
           transient:
             cluster.remote.test_remote_cluster.mode: "sniff"
-            cluster.remote.test_remote_cluster.sniff.seeds: $remote_ip
+            cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "sniff"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.sniff\.seeds: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.seeds: $remote_ip}
 
   - do:
       search:
@@ -178,25 +178,25 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.sniff.seeds\" cannot be
-  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=SIMPLE]" }
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.seeds\" cannot be
+  used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=SNIFF, configured=PROXY]" }
 
   - do:
       cluster.put_settings:
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.mode: "simple"
-            cluster.remote.test_remote_cluster.sniff.seeds: null
-            cluster.remote.test_remote_cluster.simple.addresses: $remote_ip
+            cluster.remote.test_remote_cluster.mode: "proxy"
+            cluster.remote.test_remote_cluster.seeds: null
+            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
 
-  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "simple"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.simple\.addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
 
   - do:
       search:

From a77d5865e413700553421afc395509b7875707cf Mon Sep 17 00:00:00 2001
From: Tanguy Leroux <tlrx.dev@gmail.com>
Date: Thu, 19 Dec 2019 17:50:59 +0100
Subject: [PATCH 275/686] Remove snapshots left by previous tests failures
 (#50380)

When a third party test failed, it potentially left some snapshots
in the repository. In case of tests running against an external
service like Azure, the remaining snapshots can fail the future
test executions are they are not supposed to exist.

Similarly to what has been done for S3 and GCS, this commit
cleans up remaining snapshots before the test execution.

Closes #50304
---
 .../test/repository_azure/10_repository.yml         | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/plugins/repository-azure/qa/microsoft-azure-storage/src/test/resources/rest-api-spec/test/repository_azure/10_repository.yml b/plugins/repository-azure/qa/microsoft-azure-storage/src/test/resources/rest-api-spec/test/repository_azure/10_repository.yml
index 088c4d28ef718..187908c0eecd1 100644
--- a/plugins/repository-azure/qa/microsoft-azure-storage/src/test/resources/rest-api-spec/test/repository_azure/10_repository.yml
+++ b/plugins/repository-azure/qa/microsoft-azure-storage/src/test/resources/rest-api-spec/test/repository_azure/10_repository.yml
@@ -13,6 +13,19 @@ setup:
             client: "integration_test"
             base_path: ${base_path}
 
+  # Remove the snapshots, if a previous test failed to delete them. This is
+  # useful for third party tests that runs the test against a real external service.
+  - do:
+      snapshot.delete:
+        repository: repository
+        snapshot: snapshot-one
+        ignore: 404
+  - do:
+      snapshot.delete:
+        repository: repository
+        snapshot: snapshot-two
+        ignore: 404
+
 ---
 "Snapshot/Restore with repository-azure":
   - skip:

From 6d4582e8b126468e2d634a25c4358bb069586e98 Mon Sep 17 00:00:00 2001
From: Alexander Reelsen <alexander@reelsen.net>
Date: Thu, 19 Dec 2019 17:53:09 +0100
Subject: [PATCH 276/686] [DOCS] Convert main README to asciidoc (#50303)

Converts the main README file to asciidoc.

Also includes the following changes:

* Mentioning Slack instead of IRC
* Removed mentioning of native java API, HTTP should be used
* Removed java as a installed requirement
---
 README.textile => README.asciidoc | 103 ++++++++++++++----------------
 1 file changed, 49 insertions(+), 54 deletions(-)
 rename README.textile => README.asciidoc (70%)

diff --git a/README.textile b/README.asciidoc
similarity index 70%
rename from README.textile
rename to README.asciidoc
index 2f7b0472c238e..962608f5b45ba 100644
--- a/README.textile
+++ b/README.asciidoc
@@ -1,8 +1,8 @@
-h1. Elasticsearch
+= Elasticsearch
 
-h2. A Distributed RESTful Search Engine
+== A Distributed RESTful Search Engine
 
-h3. "https://www.elastic.co/products/elasticsearch":https://www.elastic.co/products/elasticsearch
+=== https://www.elastic.co/products/elasticsearch[https://www.elastic.co/products/elasticsearch]
 
 Elasticsearch is a distributed RESTful search engine built for the cloud. Features include:
 
@@ -15,39 +15,34 @@ Elasticsearch is a distributed RESTful search engine built for the cloud. Featur
 ** Index level configuration (number of shards, index storage, ...).
 * Various set of APIs
 ** HTTP RESTful API
-** Native Java API.
 ** All APIs perform automatic node operation rerouting.
 * Document oriented
 ** No need for upfront schema definition.
 ** Schema can be defined for customization of the indexing process.
 * Reliable, Asynchronous Write Behind for long term persistency.
 * (Near) Real Time Search.
-* Built on top of Lucene
+* Built on top of Apache Lucene
 ** Each shard is a fully functional Lucene index
 ** All the power of Lucene easily exposed through simple configuration / plugins.
 * Per operation consistency
 ** Single document level operations are atomic, consistent, isolated and durable.
 
-h2. Getting Started
+== Getting Started
 
 First of all, DON'T PANIC. It will take 5 minutes to get the gist of what Elasticsearch is all about.
 
-h3. Requirements
+=== Installation
 
-You need to have a recent version of Java installed. See the "Setup":http://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html#jvm-version page for more information.
-
-h3. Installation
-
-* "Download":https://www.elastic.co/downloads/elasticsearch and unzip the Elasticsearch official distribution.
-* Run @bin/elasticsearch@ on unix, or @bin\elasticsearch.bat@ on windows.
-* Run @curl -X GET http://localhost:9200/@.
+* https://www.elastic.co/downloads/elasticsearch[Download] and unpack the Elasticsearch official distribution.
+* Run `bin/elasticsearch` on Linux or macOS. Run `bin\elasticsearch.bat` on Windows.
+* Run `curl -X GET http://localhost:9200/`.
 * Start more servers ...
 
-h3. Indexing
+=== Indexing
 
-Let's try and index some twitter like information. First, let's index some tweets (the @twitter@ index will be created automatically):
+Let's try and index some twitter like information. First, let's index some tweets (the `twitter` index will be created automatically):
 
-<pre>
+----
 curl -XPUT 'http://localhost:9200/twitter/_doc/1?pretty' -H 'Content-Type: application/json' -d '
 {
     "user": "kimchy",
@@ -68,50 +63,50 @@ curl -XPUT 'http://localhost:9200/twitter/_doc/3?pretty' -H 'Content-Type: appli
     "post_date": "2010-01-15T01:46:38",
     "message": "Building the site, should be kewl"
 }'
-</pre>
+----
 
 Now, let's see if the information was added by GETting it:
 
-<pre>
+----
 curl -XGET 'http://localhost:9200/twitter/_doc/1?pretty=true'
 curl -XGET 'http://localhost:9200/twitter/_doc/2?pretty=true'
 curl -XGET 'http://localhost:9200/twitter/_doc/3?pretty=true'
-</pre>
+----
 
-h3. Searching
+=== Searching
 
 Mmm search..., shouldn't it be elastic?
-Let's find all the tweets that @kimchy@ posted:
+Let's find all the tweets that `kimchy` posted:
 
-<pre>
+----
 curl -XGET 'http://localhost:9200/twitter/_search?q=user:kimchy&pretty=true'
-</pre>
+----
 
 We can also use the JSON query language Elasticsearch provides instead of a query string:
 
-<pre>
+----
 curl -XGET 'http://localhost:9200/twitter/_search?pretty=true' -H 'Content-Type: application/json' -d '
 {
     "query" : {
         "match" : { "user": "kimchy" }
     }
 }'
-</pre>
+----
 
-Just for kicks, let's get all the documents stored (we should see the tweet from @elastic@ as well):
+Just for kicks, let's get all the documents stored (we should see the tweet from `elastic` as well):
 
-<pre>
+----
 curl -XGET 'http://localhost:9200/twitter/_search?pretty=true' -H 'Content-Type: application/json' -d '
 {
     "query" : {
         "match_all" : {}
     }
 }'
-</pre>
+----
 
-We can also do range search (the @post_date@ was automatically identified as date)
+We can also do range search (the `post_date` was automatically identified as date)
 
-<pre>
+----
 curl -XGET 'http://localhost:9200/twitter/_search?pretty=true' -H 'Content-Type: application/json' -d '
 {
     "query" : {
@@ -120,19 +115,19 @@ curl -XGET 'http://localhost:9200/twitter/_search?pretty=true' -H 'Content-Type:
         }
     }
 }'
-</pre>
+----
 
 There are many more options to perform search, after all, it's a search product no? All the familiar Lucene queries are available through the JSON query language, or through the query parser.
 
-h3. Multi Tenant and Indices
+=== Multi Tenant and Indices
 
 Man, that twitter index might get big (in this case, index size == valuation). Let's see if we can structure our twitter system a bit differently in order to support such large amounts of data.
 
-Elasticsearch supports multiple indices. In the previous example we used an index called @twitter@ that stored tweets for every user.
+Elasticsearch supports multiple indices. In the previous example we used an index called `twitter` that stored tweets for every user.
 
 Another way to define our simple twitter system is to have a different index per user (note, though that each index has an overhead). Here is the indexing curl's in this case:
 
-<pre>
+----
 curl -XPUT 'http://localhost:9200/kimchy/_doc/1?pretty' -H 'Content-Type: application/json' -d '
 {
     "user": "kimchy",
@@ -146,13 +141,13 @@ curl -XPUT 'http://localhost:9200/kimchy/_doc/2?pretty' -H 'Content-Type: applic
     "post_date": "2009-11-15T14:12:12",
     "message": "Another tweet, will it be indexed?"
 }'
-</pre>
+----
 
-The above will index information into the @kimchy@ index. Each user will get their own special index.
+The above will index information into the `kimchy` index. Each user will get their own special index.
 
 Complete control on the index level is allowed. As an example, in the above case, we might want to change from the default 1 shard with 1 replica per index, to 2 shards with 1 replica per index (because this user tweets a lot). Here is how this can be done (the configuration can be in yaml as well):
 
-<pre>
+----
 curl -XPUT http://localhost:9200/another_user?pretty -H 'Content-Type: application/json' -d '
 {
     "settings" : {
@@ -160,34 +155,34 @@ curl -XPUT http://localhost:9200/another_user?pretty -H 'Content-Type: applicati
         "index.number_of_replicas" : 1
     }
 }'
-</pre>
+----
 
 Search (and similar operations) are multi index aware. This means that we can easily search on more than one
 index (twitter user), for example:
 
-<pre>
+----
 curl -XGET 'http://localhost:9200/kimchy,another_user/_search?pretty=true' -H 'Content-Type: application/json' -d '
 {
     "query" : {
         "match_all" : {}
     }
 }'
-</pre>
+----
 
 Or on all the indices:
 
-<pre>
+----
 curl -XGET 'http://localhost:9200/_search?pretty=true' -H 'Content-Type: application/json' -d '
 {
     "query" : {
         "match_all" : {}
     }
 }'
-</pre>
+----
 
-{One liner teaser}: And the cool part about that? You can easily search on multiple twitter users (indices), with different boost levels per user (index), making social search so much simpler (results from my friends rank higher than results from friends of my friends).
+And the cool part about that? You can easily search on multiple twitter users (indices), with different boost levels per user (index), making social search so much simpler (results from my friends rank higher than results from friends of my friends).
 
-h3. Distributed, Highly Available
+=== Distributed, Highly Available
 
 Let's face it, things will fail....
 
@@ -195,20 +190,20 @@ Elasticsearch is a highly available and distributed search engine. Each index is
 
 In order to play with the distributed nature of Elasticsearch, simply bring more nodes up and shut down nodes. The system will continue to serve requests (make sure you use the correct http port) with the latest data indexed.
 
-h3. Where to go from here?
+=== Where to go from here?
 
-We have just covered a very small portion of what Elasticsearch is all about. For more information, please refer to the "elastic.co":http://www.elastic.co/products/elasticsearch website. General questions can be asked on the "Elastic Discourse forum":https://discuss.elastic.co or on IRC on Freenode at "#elasticsearch":https://webchat.freenode.net/#elasticsearch. The Elasticsearch GitHub repository is reserved for bug reports and feature requests only.
+We have just covered a very small portion of what Elasticsearch is all about. For more information, please refer to the http://www.elastic.co/products/elasticsearch[elastic.co] website. General questions can be asked on the https://discuss.elastic.co[Elastic Forum] or https://ela.st/slack[on Slack]. The Elasticsearch GitHub repository is reserved for bug reports and feature requests only.
 
-h3. Building from Source
+=== Building from Source
 
-Elasticsearch uses "Gradle":https://gradle.org for its build system.
+Elasticsearch uses https://gradle.org[Gradle] for its build system.
 
-In order to create a distribution, simply run the @./gradlew assemble@ command in the cloned directory.
+In order to create a distribution, simply run the `./gradlew assemble` command in the cloned directory.
 
-The distribution for each project will be created under the @build/distributions@ directory in that project.
+The distribution for each project will be created under the `build/distributions` directory in that project.
 
-See the "TESTING":TESTING.asciidoc file for more information about running the Elasticsearch test suite.
+See the xref:TESTING.asciidoc[TESTING] for more information about running the Elasticsearch test suite.
 
-h3. Upgrading from older Elasticsearch versions
+=== Upgrading from older Elasticsearch versions
 
-In order to ensure a smooth upgrade process from earlier versions of Elasticsearch, please see our "upgrade documentation":https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html for more details on the upgrade process.
+In order to ensure a smooth upgrade process from earlier versions of Elasticsearch, please see our https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html[upgrade documentation] for more details on the upgrade process.

From a54d6cb59c1fde97e41d49e64cedcb93173bfbe0 Mon Sep 17 00:00:00 2001
From: Stuart Tettemer <stu@elastic.co>
Date: Thu, 19 Dec 2019 10:14:28 -0700
Subject: [PATCH 277/686] Scripting: ScriptFactory not required by compile
 (#50344)

Avoid backwards incompatible changes for 8.x and 7.6 by removing type
restriction on compile and Factory.  Factories may optionally implement
ScriptFactory.  If so, then they can indicate determinism and thus
cacheability.

Relates: #49466
---
 .../common/AnalysisPredicateScript.java       |  3 +-
 .../PredicateTokenScriptFilterTests.java      |  3 +-
 .../ScriptedConditionTokenFilterTests.java    |  3 +-
 .../expression/ExpressionScriptEngine.java    | 63 ++++++++++++++++---
 .../script/mustache/MustacheScriptEngine.java |  6 +-
 .../painless/PainlessScriptEngine.java        |  7 +--
 .../action/PainlessExecuteAction.java         |  3 +-
 .../painless/BaseClassTests.java              | 43 +++++++------
 .../painless/BasicStatementTests.java         |  3 +-
 .../elasticsearch/painless/BindingsTests.java |  3 +-
 .../elasticsearch/painless/FactoryTests.java  | 44 ++++++++++---
 .../expertscript/ExpertScriptPlugin.java      |  5 +-
 .../index/query/QueryShardContext.java        |  6 +-
 .../BucketAggregationSelectorScript.java      |  2 +-
 .../script/IngestConditionalScript.java       |  2 +-
 .../elasticsearch/script/IngestScript.java    |  2 +-
 .../elasticsearch/script/ScriptContext.java   |  2 +-
 .../elasticsearch/script/ScriptEngine.java    |  2 +-
 .../elasticsearch/script/ScriptService.java   |  2 +-
 .../elasticsearch/script/TemplateScript.java  |  2 +-
 .../elasticsearch/script/UpdateScript.java    |  2 +-
 .../query/IntervalQueryBuilderTests.java      |  3 +-
 .../script/ScriptContextTests.java            | 12 ++--
 .../script/ScriptLanguagesInfoTests.java      |  2 +-
 .../metrics/ScriptedMetricIT.java             |  1 -
 .../functionscore/ExplainableScriptIT.java    |  3 +-
 .../search/suggest/SuggestSearchIT.java       |  3 +-
 .../ingest/TestTemplateService.java           |  3 +-
 .../script/MockScriptEngine.java              | 19 +++---
 .../script/MockMustacheScriptEngine.java      |  2 +-
 .../test/MockPainlessScriptEngine.java        |  3 +-
 .../condition/WatcherConditionScript.java     |  3 +-
 .../script/WatcherTransformScript.java        |  3 +-
 33 files changed, 160 insertions(+), 105 deletions(-)

diff --git a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/AnalysisPredicateScript.java b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/AnalysisPredicateScript.java
index f14bd9ded9cc1..5d8c491efc585 100644
--- a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/AnalysisPredicateScript.java
+++ b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/AnalysisPredicateScript.java
@@ -27,7 +27,6 @@
 import org.apache.lucene.analysis.tokenattributes.TypeAttribute;
 import org.apache.lucene.util.AttributeSource;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 
 /**
  * A predicate based on the current token in a TokenStream
@@ -108,7 +107,7 @@ public boolean isKeyword() {
      */
     public abstract boolean execute(Token token);
 
-    public interface Factory extends ScriptFactory {
+    public interface Factory {
         AnalysisPredicateScript newInstance();
     }
 
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PredicateTokenScriptFilterTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PredicateTokenScriptFilterTests.java
index 9e61a59237348..84ba5e5d3373c 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PredicateTokenScriptFilterTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PredicateTokenScriptFilterTests.java
@@ -30,7 +30,6 @@
 import org.elasticsearch.indices.analysis.AnalysisModule;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.test.ESTokenStreamTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
@@ -64,7 +63,7 @@ public boolean execute(Token token) {
         @SuppressWarnings("unchecked")
         ScriptService scriptService = new ScriptService(indexSettings, Collections.emptyMap(), Collections.emptyMap()){
             @Override
-            public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+            public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
                 assertEquals(context, AnalysisPredicateScript.CONTEXT);
                 assertEquals(new Script("my_script"), script);
                 return (FactoryType) factory;
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/ScriptedConditionTokenFilterTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/ScriptedConditionTokenFilterTests.java
index d2bbc780c8747..58226ac169bc3 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/ScriptedConditionTokenFilterTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/ScriptedConditionTokenFilterTests.java
@@ -30,7 +30,6 @@
 import org.elasticsearch.indices.analysis.AnalysisModule;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.test.ESTokenStreamTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
@@ -64,7 +63,7 @@ public boolean execute(Token token) {
         @SuppressWarnings("unchecked")
         ScriptService scriptService = new ScriptService(indexSettings, Collections.emptyMap(), Collections.emptyMap()){
             @Override
-            public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+            public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
                 assertEquals(context, AnalysisPredicateScript.CONTEXT);
                 assertEquals(new Script("token.getPosition() > 1"), script);
                 return (FactoryType) factory;
diff --git a/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java b/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
index ead6d733b10de..b99730be826d5 100644
--- a/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
+++ b/modules/lang-expression/src/main/java/org/elasticsearch/script/expression/ExpressionScriptEngine.java
@@ -44,7 +44,6 @@
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
 import org.elasticsearch.script.ScriptException;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.TermsSetQueryScript;
 import org.elasticsearch.search.lookup.SearchLookup;
 
@@ -85,22 +84,72 @@ public boolean execute() {
             },
 
         FilterScript.CONTEXT,
-            (Expression expr) -> (FilterScript.Factory) (p, lookup) -> newFilterScript(expr, lookup, p),
+            (Expression expr) -> new FilterScript.Factory() {
+                @Override
+                public boolean isResultDeterministic() {
+                    return true;
+                }
+
+                @Override
+                public FilterScript.LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup) {
+                    return newFilterScript(expr, lookup, params);
+                }
+            },
 
         ScoreScript.CONTEXT,
-            (Expression expr) -> (ScoreScript.Factory) (p, lookup) -> newScoreScript(expr, lookup, p),
+            (Expression expr) -> new ScoreScript.Factory() {
+                @Override
+                public ScoreScript.LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup) {
+                    return newScoreScript(expr, lookup, params);
+                }
+
+                @Override
+                public boolean isResultDeterministic() {
+                    return true;
+                }
+            },
 
         TermsSetQueryScript.CONTEXT,
             (Expression expr) -> (TermsSetQueryScript.Factory) (p, lookup) -> newTermsSetQueryScript(expr, lookup, p),
 
         AggregationScript.CONTEXT,
-            (Expression expr) -> (AggregationScript.Factory) (p, lookup) -> newAggregationScript(expr, lookup, p),
+            (Expression expr) -> new AggregationScript.Factory() {
+                @Override
+                public AggregationScript.LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup) {
+                    return newAggregationScript(expr, lookup, params);
+                }
+
+                @Override
+                public boolean isResultDeterministic() {
+                    return true;
+                }
+            },
 
         NumberSortScript.CONTEXT,
-            (Expression expr) -> (NumberSortScript.Factory) (p, lookup) -> newSortScript(expr, lookup, p),
+            (Expression expr) -> new NumberSortScript.Factory() {
+                @Override
+                public NumberSortScript.LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup) {
+                    return newSortScript(expr, lookup, params);
+                }
+
+                @Override
+                public boolean isResultDeterministic() {
+                    return true;
+                }
+            },
 
         FieldScript.CONTEXT,
-            (Expression expr) -> (FieldScript.Factory) (p, lookup) -> newFieldScript(expr, lookup, p)
+            (Expression expr) -> new FieldScript.Factory() {
+                @Override
+                public FieldScript.LeafFactory newFactory(Map<String, Object> params, SearchLookup lookup) {
+                    return newFieldScript(expr, lookup, params);
+                }
+
+                @Override
+                public boolean isResultDeterministic() {
+                    return true;
+                }
+            }
     );
 
     @Override
@@ -109,7 +158,7 @@ public String getType() {
     }
 
     @Override
-    public <T extends ScriptFactory> T compile(
+    public <T> T compile(
         String scriptName,
         String scriptSource,
         ScriptContext<T> context,
diff --git a/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java b/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
index f14dd35d339fd..391b6a5c2d20c 100644
--- a/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
+++ b/modules/lang-mustache/src/main/java/org/elasticsearch/script/mustache/MustacheScriptEngine.java
@@ -21,9 +21,8 @@
 import com.github.mustachejava.Mustache;
 import com.github.mustachejava.MustacheException;
 import com.github.mustachejava.MustacheFactory;
-
-import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.apache.logging.log4j.util.Supplier;
 import org.elasticsearch.SpecialPermission;
@@ -32,7 +31,6 @@
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
 import org.elasticsearch.script.ScriptException;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.TemplateScript;
 
 import java.io.Reader;
@@ -65,7 +63,7 @@ public final class MustacheScriptEngine implements ScriptEngine {
      * @return a compiled template object for later execution.
      * */
     @Override
-    public <T extends ScriptFactory> T compile(
+    public <T> T compile(
         String templateName,
         String templateSource,
         ScriptContext<T> context,
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
index 45db4428aeced..67aedf113c32c 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/PainlessScriptEngine.java
@@ -28,7 +28,6 @@
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
 import org.elasticsearch.script.ScriptException;
-import org.elasticsearch.script.ScriptFactory;
 import org.objectweb.asm.ClassWriter;
 import org.objectweb.asm.Opcodes;
 import org.objectweb.asm.Type;
@@ -123,7 +122,7 @@ public String getType() {
     }
 
     @Override
-    public <T extends ScriptFactory> T compile(
+    public <T> T compile(
         String scriptName,
         String scriptSource,
         ScriptContext<T> context,
@@ -169,7 +168,7 @@ public Set<ScriptContext<?>> getSupportedContexts() {
      * @param <T> The factory class.
      * @return A factory class that will return script instances.
      */
-    private <T extends ScriptFactory> Type generateStatefulFactory(
+    private <T> Type generateStatefulFactory(
         Loader loader,
         ScriptContext<T> context,
         Set<String> extractedVariables
@@ -275,7 +274,7 @@ private <T extends ScriptFactory> Type generateStatefulFactory(
      * @param <T> The factory class.
      * @return A factory class that will return script instances.
      */
-    private <T extends ScriptFactory> T generateFactory(
+    private <T> T generateFactory(
         Loader loader,
         ScriptContext<T> context,
         Set<String> extractedVariables,
diff --git a/modules/lang-painless/src/main/java/org/elasticsearch/painless/action/PainlessExecuteAction.java b/modules/lang-painless/src/main/java/org/elasticsearch/painless/action/PainlessExecuteAction.java
index e38d87e69ccb3..b6bb1a842640d 100644
--- a/modules/lang-painless/src/main/java/org/elasticsearch/painless/action/PainlessExecuteAction.java
+++ b/modules/lang-painless/src/main/java/org/elasticsearch/painless/action/PainlessExecuteAction.java
@@ -75,7 +75,6 @@
 import org.elasticsearch.script.ScoreScript;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.threadpool.ThreadPool;
@@ -416,7 +415,7 @@ public Map<String, Object> getParams() {
 
         public abstract Object execute();
 
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
 
             PainlessTestScript newInstance(Map<String, Object> params);
 
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BaseClassTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BaseClassTests.java
index 96790301139f3..4c6aa890ba1f8 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BaseClassTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BaseClassTests.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.painless.spi.Whitelist;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 
 import java.util.Collections;
 import java.util.HashMap;
@@ -66,7 +65,7 @@ protected Map<ScriptContext<?>, List<Whitelist>> scriptContexts() {
 
     public abstract static class Gets {
 
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             Gets newInstance(String testString, int testInt, Map<String, Object> params);
         }
 
@@ -112,7 +111,7 @@ public void testGets() throws Exception {
     }
 
     public abstract static class NoArgs {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             NoArgs newInstance();
         }
 
@@ -138,7 +137,7 @@ public void testNoArgs() throws Exception {
     }
 
     public abstract static class OneArg {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             OneArg newInstance();
         }
 
@@ -155,7 +154,7 @@ public void testOneArg() throws Exception {
     }
 
     public abstract static class ArrayArg {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             ArrayArg newInstance();
         }
 
@@ -172,7 +171,7 @@ public void testArrayArg() throws Exception {
     }
 
     public abstract static class PrimitiveArrayArg {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             PrimitiveArrayArg newInstance();
         }
 
@@ -189,7 +188,7 @@ public void testPrimitiveArrayArg() throws Exception {
     }
 
     public abstract static class DefArrayArg {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             DefArrayArg newInstance();
         }
 
@@ -213,7 +212,7 @@ public void testDefArrayArg()throws Exception {
     }
 
     public abstract static class ManyArgs {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             ManyArgs newInstance();
         }
 
@@ -252,7 +251,7 @@ public void testManyArgs() throws Exception {
     }
 
     public abstract static class VarArgs {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             VarArgs newInstance();
         }
 
@@ -268,7 +267,7 @@ public void testVarArgs() throws Exception {
     }
 
     public abstract static class DefaultMethods {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             DefaultMethods newInstance();
         }
 
@@ -302,7 +301,7 @@ public void testDefaultMethods() throws Exception {
     }
 
     public abstract static class ReturnsVoid {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             ReturnsVoid newInstance();
         }
 
@@ -326,7 +325,7 @@ public void testReturnsVoid() throws Exception {
     }
 
     public abstract static class ReturnsPrimitiveBoolean {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             ReturnsPrimitiveBoolean newInstance();
         }
 
@@ -392,7 +391,7 @@ public void testReturnsPrimitiveBoolean() throws Exception {
     }
 
     public abstract static class ReturnsPrimitiveInt {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             ReturnsPrimitiveInt newInstance();
         }
 
@@ -456,7 +455,7 @@ public void testReturnsPrimitiveInt() throws Exception {
     }
 
     public abstract static class ReturnsPrimitiveFloat {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             ReturnsPrimitiveFloat newInstance();
         }
 
@@ -505,7 +504,7 @@ public void testReturnsPrimitiveFloat() throws Exception {
     }
 
    public abstract static class ReturnsPrimitiveDouble {
-       public interface Factory extends ScriptFactory {
+       public interface Factory {
            ReturnsPrimitiveDouble newInstance();
        }
 
@@ -568,7 +567,7 @@ public void testReturnsPrimitiveDouble() throws Exception {
     }
 
     public abstract static class NoArgsConstant {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             NoArgsConstant newInstance();
         }
 
@@ -585,7 +584,7 @@ public void testNoArgsConstant() {
     }
 
     public abstract static class WrongArgsConstant {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             WrongArgsConstant newInstance();
         }
 
@@ -603,7 +602,7 @@ public void testWrongArgsConstant() {
     }
 
     public abstract static class WrongLengthOfArgConstant {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             WrongLengthOfArgConstant newInstance();
         }
 
@@ -620,7 +619,7 @@ public void testWrongLengthOfArgConstant() {
     }
 
     public abstract static class UnknownArgType {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             UnknownArgType newInstance();
         }
 
@@ -637,7 +636,7 @@ public void testUnknownArgType() {
     }
 
     public abstract static class UnknownReturnType {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             UnknownReturnType newInstance();
         }
 
@@ -654,7 +653,7 @@ public void testUnknownReturnType() {
     }
 
     public abstract static class UnknownArgTypeInArray {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             UnknownArgTypeInArray newInstance();
         }
 
@@ -671,7 +670,7 @@ public void testUnknownArgTypeInArray() {
     }
 
     public abstract static class TwoExecuteMethods {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             TwoExecuteMethods newInstance();
         }
 
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BasicStatementTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BasicStatementTests.java
index 72fc01dbf2ce6..e4d1db2243b82 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BasicStatementTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BasicStatementTests.java
@@ -2,7 +2,6 @@
 
 import org.elasticsearch.painless.spi.Whitelist;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 
 import java.util.ArrayList;
 import java.util.Collections;
@@ -261,7 +260,7 @@ public void testReturnStatement() {
     }
 
     public abstract static class OneArg {
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             OneArg newInstance();
         }
 
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BindingsTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BindingsTests.java
index d165e0ef76d81..171880abd7907 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/BindingsTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/BindingsTests.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.painless.spi.WhitelistInstanceBinding;
 import org.elasticsearch.painless.spi.WhitelistLoader;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 
 import java.util.ArrayList;
 import java.util.Collections;
@@ -90,7 +89,7 @@ public abstract static class BindingsTestScript {
         public static final String[] PARAMETERS = { "test", "bound" };
         public int getTestValue() {return 7;}
         public abstract int execute(int test, int bound);
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             BindingsTestScript newInstance();
         }
         public static final ScriptContext<Factory> CONTEXT = new ScriptContext<>("bindings_test", Factory.class);
diff --git a/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java b/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
index 33645e24c0b3c..ffd4df43c9070 100644
--- a/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
+++ b/modules/lang-painless/src/test/java/org/elasticsearch/painless/FactoryTests.java
@@ -35,6 +35,7 @@ protected Map<ScriptContext<?>, List<Whitelist>> scriptContexts() {
         Map<ScriptContext<?>, List<Whitelist>> contexts = super.scriptContexts();
         contexts.put(StatefulFactoryTestScript.CONTEXT, Whitelist.BASE_WHITELISTS);
         contexts.put(FactoryTestScript.CONTEXT, Whitelist.BASE_WHITELISTS);
+        contexts.put(DeterministicFactoryTestScript.CONTEXT, Whitelist.BASE_WHITELISTS);
         contexts.put(EmptyTestScript.CONTEXT, Whitelist.BASE_WHITELISTS);
         contexts.put(TemplateScript.CONTEXT, Whitelist.BASE_WHITELISTS);
 
@@ -85,7 +86,7 @@ public interface StatefulFactory {
             boolean needsD();
         }
 
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             StatefulFactory newFactory(int x, int y);
 
             boolean needsTest();
@@ -138,7 +139,7 @@ public Map<String, Object> getParams() {
         public static final String[] PARAMETERS = new String[] {"test"};
         public abstract Object execute(int test);
 
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             FactoryTestScript newInstance(Map<String, Object> params);
 
             boolean needsTest();
@@ -149,6 +150,31 @@ public interface Factory extends ScriptFactory {
             new ScriptContext<>("test", FactoryTestScript.Factory.class);
     }
 
+    public abstract static class DeterministicFactoryTestScript {
+        private final Map<String, Object> params;
+
+        public DeterministicFactoryTestScript(Map<String, Object> params) {
+            this.params = params;
+        }
+
+        public Map<String, Object> getParams() {
+            return params;
+        }
+
+        public static final String[] PARAMETERS = new String[] {"test"};
+        public abstract Object execute(int test);
+
+        public interface Factory extends ScriptFactory{
+            FactoryTestScript newInstance(Map<String, Object> params);
+
+            boolean needsTest();
+            boolean needsNothing();
+        }
+
+        public static final ScriptContext<DeterministicFactoryTestScript.Factory> CONTEXT =
+            new ScriptContext<>("test", DeterministicFactoryTestScript.Factory.class);
+    }
+
     public void testFactory() {
         FactoryTestScript.Factory factory =
             scriptEngine.compile("factory_test", "test + params.get('test')", FactoryTestScript.CONTEXT, Collections.emptyMap());
@@ -163,26 +189,26 @@ public void testFactory() {
     }
 
     public void testDeterministic() {
-        FactoryTestScript.Factory factory =
+        DeterministicFactoryTestScript.Factory factory =
             scriptEngine.compile("deterministic_test", "Integer.parseInt('123')",
-                FactoryTestScript.CONTEXT, Collections.emptyMap());
+                DeterministicFactoryTestScript.CONTEXT, Collections.emptyMap());
         assertTrue(factory.isResultDeterministic());
         assertEquals(123, factory.newInstance(Collections.emptyMap()).execute(0));
     }
 
     public void testNotDeterministic() {
-        FactoryTestScript.Factory factory =
+        DeterministicFactoryTestScript.Factory factory =
             scriptEngine.compile("not_deterministic_test", "Math.random()",
-                FactoryTestScript.CONTEXT, Collections.emptyMap());
+                DeterministicFactoryTestScript.CONTEXT, Collections.emptyMap());
         assertFalse(factory.isResultDeterministic());
         Double d = (Double)factory.newInstance(Collections.emptyMap()).execute(0);
         assertTrue(d >= 0.0 && d <= 1.0);
     }
 
     public void testMixedDeterministicIsNotDeterministic() {
-        FactoryTestScript.Factory factory =
+        DeterministicFactoryTestScript.Factory factory =
             scriptEngine.compile("not_deterministic_test", "Integer.parseInt('123') + Math.random()",
-                FactoryTestScript.CONTEXT, Collections.emptyMap());
+                DeterministicFactoryTestScript.CONTEXT, Collections.emptyMap());
         assertFalse(factory.isResultDeterministic());
         Double d = (Double)factory.newInstance(Collections.emptyMap()).execute(0);
         assertTrue(d >= 123.0 && d <= 124.0);
@@ -192,7 +218,7 @@ public abstract static class EmptyTestScript {
         public static final String[] PARAMETERS = {};
         public abstract Object execute();
 
-        public interface Factory extends ScriptFactory {
+        public interface Factory {
             EmptyTestScript newInstance();
         }
 
diff --git a/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java b/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
index 5846f000f5e2d..5b9a357cff2f0 100644
--- a/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
+++ b/plugins/examples/script-expert-scoring/src/main/java/org/elasticsearch/example/expertscript/ExpertScriptPlugin.java
@@ -62,7 +62,7 @@ public String getType() {
         }
 
         @Override
-        public <T extends ScriptFactory> T compile(
+        public <T> T compile(
             String scriptName,
             String scriptSource,
             ScriptContext<T> context,
@@ -92,7 +92,8 @@ public Set<ScriptContext<?>> getSupportedContexts() {
             return Set.of(ScoreScript.CONTEXT);
         }
 
-        private static class PureDfFactory implements ScoreScript.Factory {
+        private static class PureDfFactory implements ScoreScript.Factory,
+                                                      ScriptFactory {
             @Override
             public boolean isResultDeterministic() {
                 // PureDfLeafFactory only uses deterministic APIs, this
diff --git a/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java b/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
index 56161d8f2fa34..12b2da120f63e 100644
--- a/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
+++ b/server/src/main/java/org/elasticsearch/index/query/QueryShardContext.java
@@ -323,11 +323,9 @@ public Index index() {
     }
 
     /** Compile script using script service */
-    public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+    public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
         FactoryType factory = scriptService.compile(script, context);
-        // TODO(stu): can check `factory instanceof ScriptFactory && ((ScriptFactory) factory).isResultDeterministic() == false`
-        // to avoid being so intrusive
-        if (factory.isResultDeterministic() == false) {
+        if (factory instanceof ScriptFactory && ((ScriptFactory) factory).isResultDeterministic() == false) {
             failIfFrozen();
         }
         return factory;
diff --git a/server/src/main/java/org/elasticsearch/script/BucketAggregationSelectorScript.java b/server/src/main/java/org/elasticsearch/script/BucketAggregationSelectorScript.java
index 3c765439223d2..a8e2fad7cdcda 100644
--- a/server/src/main/java/org/elasticsearch/script/BucketAggregationSelectorScript.java
+++ b/server/src/main/java/org/elasticsearch/script/BucketAggregationSelectorScript.java
@@ -48,7 +48,7 @@ public Map<String, Object> getParams() {
 
     public abstract boolean execute();
 
-    public interface Factory extends ScriptFactory {
+    public interface Factory {
         BucketAggregationSelectorScript newInstance(Map<String, Object> params);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/IngestConditionalScript.java b/server/src/main/java/org/elasticsearch/script/IngestConditionalScript.java
index 44d87cfe6aba2..27ce29b95dc50 100644
--- a/server/src/main/java/org/elasticsearch/script/IngestConditionalScript.java
+++ b/server/src/main/java/org/elasticsearch/script/IngestConditionalScript.java
@@ -45,7 +45,7 @@ public Map<String, Object> getParams() {
 
     public abstract boolean execute(Map<String, Object> ctx);
 
-    public interface Factory extends ScriptFactory {
+    public interface Factory {
         IngestConditionalScript newInstance(Map<String, Object> params);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/IngestScript.java b/server/src/main/java/org/elasticsearch/script/IngestScript.java
index 7104ed7d9b0d2..f357394ed31f0 100644
--- a/server/src/main/java/org/elasticsearch/script/IngestScript.java
+++ b/server/src/main/java/org/elasticsearch/script/IngestScript.java
@@ -46,7 +46,7 @@ public Map<String, Object> getParams() {
 
     public abstract void execute(Map<String, Object> ctx);
 
-    public interface Factory extends ScriptFactory {
+    public interface Factory {
         IngestScript newInstance(Map<String, Object> params);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptContext.java b/server/src/main/java/org/elasticsearch/script/ScriptContext.java
index 4e927da09d118..081a26d1e511a 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptContext.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptContext.java
@@ -54,7 +54,7 @@
  * If the variable name starts with an underscore, for example, {@code _score}, the needs method would
  * be {@code boolean needs_score()}.
  */
-public final class ScriptContext<FactoryType extends ScriptFactory> {
+public final class ScriptContext<FactoryType> {
 
     /** A unique identifier for this context. */
     public final String name;
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptEngine.java b/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
index 4c38ae5c6e19c..78a012700c2b2 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptEngine.java
@@ -42,7 +42,7 @@ public interface ScriptEngine extends Closeable {
      * @param params compile-time parameters (such as flags to the compiler)
      * @return A compiled script of the FactoryType from {@link ScriptContext}
      */
-    <FactoryType extends ScriptFactory> FactoryType compile(
+    <FactoryType> FactoryType compile(
         String name,
         String code,
         ScriptContext<FactoryType> context,
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptService.java b/server/src/main/java/org/elasticsearch/script/ScriptService.java
index 77375838e7f16..a1788ee74a163 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptService.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptService.java
@@ -284,7 +284,7 @@ void setMaxCompilationRate(Tuple<Integer, TimeValue> newRate) {
      *
      * @return a compiled script which may be used to construct instances of a script for the given context
      */
-    public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+    public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
         Objects.requireNonNull(script);
         Objects.requireNonNull(context);
 
diff --git a/server/src/main/java/org/elasticsearch/script/TemplateScript.java b/server/src/main/java/org/elasticsearch/script/TemplateScript.java
index f7cf4590387d8..c053cf2b509d0 100644
--- a/server/src/main/java/org/elasticsearch/script/TemplateScript.java
+++ b/server/src/main/java/org/elasticsearch/script/TemplateScript.java
@@ -41,7 +41,7 @@ public Map<String, Object> getParams() {
     /** Run a template and return the resulting string, encoded in utf8 bytes. */
     public abstract String execute();
 
-    public interface Factory extends ScriptFactory {
+    public interface Factory {
         TemplateScript newInstance(Map<String, Object> params);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/script/UpdateScript.java b/server/src/main/java/org/elasticsearch/script/UpdateScript.java
index 5dd08d5b602dd..ae0827ff83934 100644
--- a/server/src/main/java/org/elasticsearch/script/UpdateScript.java
+++ b/server/src/main/java/org/elasticsearch/script/UpdateScript.java
@@ -58,7 +58,7 @@ public Map<String, Object> getCtx() {
 
     public abstract void execute();
 
-    public interface Factory extends ScriptFactory {
+    public interface Factory {
         UpdateScript newInstance(Map<String, Object> params, Map<String, Object> ctx);
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index cfcc1a9cd3eb0..763d10ddf30e8 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -35,7 +35,6 @@
 import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.test.AbstractQueryTestCase;
@@ -397,7 +396,7 @@ public boolean execute(Interval interval) {
         ScriptService scriptService = new ScriptService(Settings.EMPTY, Collections.emptyMap(), Collections.emptyMap()){
             @Override
             @SuppressWarnings("unchecked")
-            public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+            public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
                 assertEquals(IntervalFilterScript.CONTEXT, context);
                 assertEquals(new Script("interval.start > 3"), script);
                 return (FactoryType) factory;
diff --git a/server/src/test/java/org/elasticsearch/script/ScriptContextTests.java b/server/src/test/java/org/elasticsearch/script/ScriptContextTests.java
index dc77fb0126262..157b0969ae813 100644
--- a/server/src/test/java/org/elasticsearch/script/ScriptContextTests.java
+++ b/server/src/test/java/org/elasticsearch/script/ScriptContextTests.java
@@ -23,28 +23,28 @@
 
 public class ScriptContextTests extends ESTestCase {
 
-    public interface TwoNewInstance extends ScriptFactory {
+    public interface TwoNewInstance {
         String newInstance(int foo, int bar);
         String newInstance(int foo);
 
-        interface StatefulFactory extends ScriptFactory {
+        interface StatefulFactory {
             TwoNewInstance newFactory();
         }
     }
 
-    public interface TwoNewFactory extends ScriptFactory {
+    public interface TwoNewFactory {
         String newFactory(int foo, int bar);
         String newFactory(int foo);
     }
 
-    public interface MissingNewInstance extends ScriptFactory {
+    public interface MissingNewInstance {
         String typoNewInstanceMethod(int foo);
     }
 
     public interface DummyScript {
         int execute(int foo);
 
-        interface Factory extends ScriptFactory {
+        interface Factory {
             DummyScript newInstance();
         }
     }
@@ -54,7 +54,7 @@ public interface DummyStatefulScript {
         interface StatefulFactory {
             DummyStatefulScript newInstance();
         }
-        interface Factory extends ScriptFactory {
+        interface Factory {
             StatefulFactory newFactory();
         }
     }
diff --git a/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java b/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java
index 6e720b480934b..38139103ed2ab 100644
--- a/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java
+++ b/server/src/test/java/org/elasticsearch/script/ScriptLanguagesInfoTests.java
@@ -75,7 +75,7 @@ private ScriptService getMockScriptService(Settings settings) {
     }
 
 
-    public interface MiscContext extends ScriptFactory {
+    public interface MiscContext {
         void execute();
         Object newInstance();
     }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
index 406a96e3c34cd..6c2981c4ad79d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
@@ -1037,7 +1037,6 @@ public void testEmptyAggregation() throws Exception {
      * Make sure that a request using a deterministic script gets cached and nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        // TODO(stu): add non-determinism in init, agg, combine and reduce, ensure not cached
         Script mapScript = new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "state['count'] = 1", Collections.emptyMap());
         Script combineScript =
             new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "no-op aggregation", Collections.emptyMap());
diff --git a/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java b/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
index 2e61882256b77..dda35ff803c1d 100644
--- a/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
+++ b/server/src/test/java/org/elasticsearch/search/functionscore/ExplainableScriptIT.java
@@ -34,7 +34,6 @@
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptType;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.search.SearchHits;
@@ -76,7 +75,7 @@ public String getType() {
                 }
 
                 @Override
-                public <T extends ScriptFactory> T compile(
+                public <T> T compile(
                     String scriptName,
                     String scriptSource,
                     ScriptContext<T> context,
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
index 5434f05c9aa00..fc2826258a47a 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
@@ -34,7 +34,6 @@
 import org.elasticsearch.plugins.ScriptPlugin;
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.TemplateScript;
 import org.elasticsearch.search.suggest.phrase.DirectCandidateGeneratorBuilder;
 import org.elasticsearch.search.suggest.phrase.Laplace;
@@ -1138,7 +1137,7 @@ public String getType() {
         }
 
         @Override
-        public <T extends ScriptFactory> T compile(
+        public <T> T compile(
             String scriptName,
             String scriptSource,
             ScriptContext<T> context,
diff --git a/test/framework/src/main/java/org/elasticsearch/ingest/TestTemplateService.java b/test/framework/src/main/java/org/elasticsearch/ingest/TestTemplateService.java
index b5fcb2a37d7e3..5bbf39d8fdc17 100644
--- a/test/framework/src/main/java/org/elasticsearch/ingest/TestTemplateService.java
+++ b/test/framework/src/main/java/org/elasticsearch/ingest/TestTemplateService.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.script.MockScriptEngine;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.script.ScriptService;
 import org.elasticsearch.script.TemplateScript;
 
@@ -49,7 +48,7 @@ private TestTemplateService(boolean compilationException) {
     }
 
     @Override
-    public <FactoryType extends ScriptFactory> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
+    public <FactoryType> FactoryType compile(Script script, ScriptContext<FactoryType> context) {
         if (this.compilationException) {
             throw new RuntimeException("could not compile script");
         } else {
diff --git a/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java b/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
index 3069efbebb451..ab34dcbf09bf5 100644
--- a/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
+++ b/test/framework/src/main/java/org/elasticsearch/script/MockScriptEngine.java
@@ -93,7 +93,7 @@ public String getType() {
     }
 
     @Override
-    public <T extends ScriptFactory> T compile(String name, String source, ScriptContext<T> context, Map<String, String> params) {
+    public <T> T compile(String name, String source, ScriptContext<T> context, Map<String, String> params) {
         // Scripts are always resolved using the script's source. For inline scripts, it's easy because they don't have names and the
         // source is always provided. For stored and file scripts, the source of the script must match the key of a predefined script.
         MockDeterministicScript script = scripts.get(source);
@@ -252,7 +252,6 @@ public double execute(Map<String, Object> params1, double[] values) {
 
     @Override
     public Set<ScriptContext<?>> getSupportedContexts() {
-        // TODO(stu): make part of `compile()`
         return Set.of(
             FieldScript.CONTEXT,
             TermsSetQueryScript.CONTEXT,
@@ -395,7 +394,7 @@ public double execute(Query query, Field field, Term term) {
         }
     }
 
-    public static class MockMetricAggInitScriptFactory implements ScriptedMetricAggContexts.InitScript.Factory, ScriptFactory {
+    public static class MockMetricAggInitScriptFactory implements ScriptedMetricAggContexts.InitScript.Factory {
         private final MockDeterministicScript script;
         MockMetricAggInitScriptFactory(MockDeterministicScript script) { this.script = script; }
         @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
@@ -428,7 +427,7 @@ public void execute() {
         }
     }
 
-    public static class MockMetricAggMapScriptFactory implements  ScriptedMetricAggContexts.MapScript.Factory, ScriptFactory {
+    public static class MockMetricAggMapScriptFactory implements  ScriptedMetricAggContexts.MapScript.Factory {
         private final MockDeterministicScript script;
         MockMetricAggMapScriptFactory(MockDeterministicScript script) { this.script = script; }
         @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
@@ -476,7 +475,7 @@ public void execute() {
         }
     }
 
-    public static class MockMetricAggCombineScriptFactory implements ScriptedMetricAggContexts.CombineScript.Factory, ScriptFactory {
+    public static class MockMetricAggCombineScriptFactory implements ScriptedMetricAggContexts.CombineScript.Factory {
         private final MockDeterministicScript script;
         MockMetricAggCombineScriptFactory(MockDeterministicScript script) { this.script = script; }
         @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
@@ -508,7 +507,7 @@ public Object execute() {
         }
     }
 
-    public static class MockMetricAggReduceScriptFactory implements ScriptedMetricAggContexts.ReduceScript.Factory, ScriptFactory {
+    public static class MockMetricAggReduceScriptFactory implements ScriptedMetricAggContexts.ReduceScript.Factory {
         private final MockDeterministicScript script;
         MockMetricAggReduceScriptFactory(MockDeterministicScript script) { this.script = script; }
         @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
@@ -584,7 +583,7 @@ public void setScorer(Scorable scorer) {
         }
     }
 
-    class MockAggregationScript implements AggregationScript.Factory, ScriptFactory {
+    class MockAggregationScript implements AggregationScript.Factory {
         private final MockDeterministicScript script;
         MockAggregationScript(MockDeterministicScript script) { this.script = script; }
         @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
@@ -615,7 +614,7 @@ public boolean needs_score() {
         }
     }
 
-    class MockSignificantTermsHeuristicScoreScript implements SignificantTermsHeuristicScoreScript.Factory, ScriptFactory {
+    class MockSignificantTermsHeuristicScoreScript implements SignificantTermsHeuristicScoreScript.Factory {
         private final MockDeterministicScript script;
         MockSignificantTermsHeuristicScoreScript(MockDeterministicScript script) { this.script = script; }
         @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
@@ -631,7 +630,7 @@ public double execute(Map<String, Object> vars) {
         }
     }
 
-    class MockFieldScriptFactory implements FieldScript.Factory, ScriptFactory {
+    class MockFieldScriptFactory implements FieldScript.Factory {
         private final MockDeterministicScript script;
         MockFieldScriptFactory(MockDeterministicScript script) { this.script = script; }
         @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
@@ -650,7 +649,7 @@ public Object execute() {
         }
     }
 
-    class MockStringSortScriptFactory implements StringSortScript.Factory, ScriptFactory {
+    class MockStringSortScriptFactory implements StringSortScript.Factory {
         private final MockDeterministicScript script;
         MockStringSortScriptFactory(MockDeterministicScript script) { this.script = script; }
         @Override public boolean isResultDeterministic() { return script.isResultDeterministic(); }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/script/MockMustacheScriptEngine.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/script/MockMustacheScriptEngine.java
index 16a95f0accdac..4f9b125a9fd6b 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/script/MockMustacheScriptEngine.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/script/MockMustacheScriptEngine.java
@@ -39,7 +39,7 @@ public String getType() {
     }
 
     @Override
-    public <T extends ScriptFactory> T compile(String name, String script, ScriptContext<T> context, Map<String, String> params) {
+    public <T> T compile(String name, String script, ScriptContext<T> context, Map<String, String> params) {
         if (script.contains("{{") && script.contains("}}")) {
             throw new IllegalArgumentException("Fix your test to not rely on mustache");
         }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/monitoring/test/MockPainlessScriptEngine.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/monitoring/test/MockPainlessScriptEngine.java
index 254542f355e5d..2052cebe1d0e9 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/monitoring/test/MockPainlessScriptEngine.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/monitoring/test/MockPainlessScriptEngine.java
@@ -11,7 +11,6 @@
 import org.elasticsearch.script.ScoreScript;
 import org.elasticsearch.script.ScriptContext;
 import org.elasticsearch.script.ScriptEngine;
-import org.elasticsearch.script.ScriptFactory;
 
 import java.util.Collection;
 import java.util.Collections;
@@ -43,7 +42,7 @@ public String getType() {
     }
 
     @Override
-    public <T extends ScriptFactory> T compile(String name, String script, ScriptContext<T> context, Map<String, String> options) {
+    public <T> T compile(String name, String script, ScriptContext<T> context, Map<String, String> options) {
         if (context.instanceClazz.equals(ScoreScript.class)) {
             return context.factoryClazz.cast(new MockScoreScript(p -> 0.0));
         }
diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/condition/WatcherConditionScript.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/condition/WatcherConditionScript.java
index f5376aa424692..1a5c8718bbd45 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/condition/WatcherConditionScript.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/condition/WatcherConditionScript.java
@@ -6,7 +6,6 @@
 package org.elasticsearch.xpack.watcher.condition;
 
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.xpack.core.watcher.execution.WatchExecutionContext;
 import org.elasticsearch.xpack.watcher.support.Variables;
 
@@ -38,7 +37,7 @@ public Map<String, Object> getCtx() {
         return ctx;
     }
 
-    public interface Factory extends ScriptFactory {
+    public interface Factory {
         WatcherConditionScript newInstance(Map<String, Object> params, WatchExecutionContext watcherContext);
     }
 
diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/transform/script/WatcherTransformScript.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/transform/script/WatcherTransformScript.java
index 3ef1f87cd608c..57ee1e9f35c5d 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/transform/script/WatcherTransformScript.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/transform/script/WatcherTransformScript.java
@@ -6,7 +6,6 @@
 package org.elasticsearch.xpack.watcher.transform.script;
 
 import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptFactory;
 import org.elasticsearch.xpack.core.watcher.execution.WatchExecutionContext;
 import org.elasticsearch.xpack.core.watcher.watch.Payload;
 import org.elasticsearch.xpack.watcher.support.Variables;
@@ -39,7 +38,7 @@ public Map<String, Object> getCtx() {
         return ctx;
     }
 
-    public interface Factory extends ScriptFactory {
+    public interface Factory {
         WatcherTransformScript newInstance(Map<String, Object> params, WatchExecutionContext watcherContext, Payload payload);
     }
 

From 76dba298f769c4906cb21aaad28970729e6ee0a7 Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Thu, 19 Dec 2019 12:22:54 -0700
Subject: [PATCH 278/686] Modify proxy mode to support a single address
 (#50391)

Currently, the remote proxy connection mode uses a list setting for the
proxy address. This commit modifies this so that the setting is
proxy_address and only supports a single remote proxy address.
---
 .../15_connection_mode_configuration.yml      |  18 +--
 .../test/multi_cluster/20_info.yml            |   8 +-
 .../transport/ProxyConnectionStrategy.java    |  95 +++++-------
 .../transport/RemoteConnectionStrategy.java   |   6 +-
 .../ProxyConnectionStrategyTests.java         | 144 +++++++-----------
 .../RemoteClusterConnectionTests.java         |  10 +-
 .../70_connection_mode_configuration.yml      |  18 +--
 7 files changed, 121 insertions(+), 178 deletions(-)

diff --git a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml
index 5606a08cd261e..05185cb3e3328 100644
--- a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml
+++ b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/15_connection_mode_configuration.yml
@@ -14,7 +14,7 @@
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
             cluster.remote.test_remote_cluster.node_connections: "5"
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
@@ -29,7 +29,7 @@
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
             cluster.remote.test_remote_cluster.seeds: $remote_ip
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
@@ -64,12 +64,12 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
             cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.proxy_addresses\" cannot be
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.proxy_address\" cannot be
    used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=PROXY, configured=SNIFF]" }
 
 ---
@@ -87,11 +87,11 @@
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
             cluster.remote.test_remote_cluster.proxy_socket_connections: "3"
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
   - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_socket_connections: "3"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_address: $remote_ip}
 
   - do:
       search:
@@ -179,7 +179,7 @@
         body:
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
@@ -193,10 +193,10 @@
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
             cluster.remote.test_remote_cluster.seeds: null
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_address: $remote_ip}
 
   - do:
       search:
diff --git a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
index 10378aaeda125..0e5236f9b1171 100644
--- a/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
+++ b/qa/multi-cluster-search/src/test/resources/rest-api-spec/test/multi_cluster/20_info.yml
@@ -70,17 +70,17 @@
             cluster.remote.test_remote_cluster.seeds: null
             cluster.remote.test_remote_cluster.node_connections: null
             cluster.remote.test_remote_cluster.proxy_socket_connections: "10"
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
   - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_socket_connections: "10"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_address: $remote_ip}
 
   - do:
       cluster.remote_info: {}
 
   - match: { test_remote_cluster.connected: true }
-  - match: { test_remote_cluster.addresses.0: $remote_ip }
+  - match: { test_remote_cluster.address: $remote_ip }
   - gt:    { test_remote_cluster.num_sockets_connected: 0}
   - match: { test_remote_cluster.max_socket_connections: 10}
   - match: { test_remote_cluster.initial_connect_timeout: "30s" }
@@ -92,7 +92,7 @@
           transient:
             cluster.remote.test_remote_cluster.mode: null
             cluster.remote.test_remote_cluster.proxy_socket_connections: null
-            cluster.remote.test_remote_cluster.proxy_addresses: null
+            cluster.remote.test_remote_cluster.proxy_address: null
 
 ---
 "skip_unavailable is returned as part of _remote/info response":
diff --git a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
index dabdd771afaed..78c9f5f28154d 100644
--- a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.node.DiscoveryNodeRole;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -37,18 +38,14 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 
 import java.io.IOException;
-import java.util.Arrays;
 import java.util.Collections;
-import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
-import java.util.Set;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.concurrent.atomic.AtomicLong;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Supplier;
-import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
 import static org.elasticsearch.common.settings.Setting.boolSetting;
@@ -57,18 +54,16 @@
 public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
 
     /**
-     * A list of addresses for remote cluster connections. The connections will be opened to the configured addresses in a round-robin
-     * fashion.
+     * The remote address for the proxy. The connections will be opened to the configured address.
      */
-    public static final Setting.AffixSetting<List<String>> REMOTE_CLUSTER_ADDRESSES = Setting.affixKeySetting(
+    public static final Setting.AffixSetting<String> REMOTE_CLUSTER_ADDRESSES = Setting.affixKeySetting(
         "cluster.remote.",
-        "proxy_addresses",
-        (ns, key) -> Setting.listSetting(key, Collections.emptyList(), s -> {
-                // validate address
-                parsePort(s);
-                return s;
-            }, new StrategyValidator<>(ns, key, ConnectionStrategy.PROXY),
-            Setting.Property.Dynamic, Setting.Property.NodeScope));
+        "proxy_address",
+        (ns, key) -> Setting.simpleString(key, new StrategyValidator<>(ns, key, ConnectionStrategy.PROXY, s -> {
+                if (Strings.hasLength(s)) {
+                    parsePort(s);
+                }
+            }), Setting.Property.Dynamic, Setting.Property.NodeScope));
 
     /**
      * The maximum number of socket connections that will be established to a remote cluster. The default is 18.
@@ -95,9 +90,9 @@ public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
 
     private final int maxNumConnections;
     private final AtomicLong counter = new AtomicLong(0);
-    private final List<String> configuredAddresses;
+    private final String configuredAddress;
     private final boolean includeServerName;
-    private final List<Supplier<TransportAddress>> addresses;
+    private final Supplier<TransportAddress> address;
     private final AtomicReference<ClusterName> remoteClusterName = new AtomicReference<>();
     private final ConnectionProfile profile;
     private final ConnectionManager.ConnectionValidator clusterNameValidator;
@@ -114,28 +109,26 @@ public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
     }
 
     ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                            int maxNumConnections, List<String> configuredAddresses) {
-        this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddresses,
-            configuredAddresses.stream().map(address ->
-                (Supplier<TransportAddress>) () -> resolveAddress(address)).collect(Collectors.toList()), false);
+                            int maxNumConnections, String configuredAddress) {
+        this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddress,
+            () -> resolveAddress(configuredAddress), false);
     }
 
     ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                            int maxNumConnections, List<String> configuredAddresses, boolean includeServerName) {
-        this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddresses,
-            configuredAddresses.stream().map(address ->
-                (Supplier<TransportAddress>) () -> resolveAddress(address)).collect(Collectors.toList()), includeServerName);
+                            int maxNumConnections, String configuredAddress, boolean includeServerName) {
+        this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddress,
+            () -> resolveAddress(configuredAddress), includeServerName);
     }
 
     ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                            int maxNumConnections, List<String> configuredAddresses, List<Supplier<TransportAddress>> addresses,
+                            int maxNumConnections, String configuredAddress, Supplier<TransportAddress> address,
                             boolean includeServerName) {
         super(clusterAlias, transportService, connectionManager);
         this.maxNumConnections = maxNumConnections;
-        this.configuredAddresses = configuredAddresses;
+        this.configuredAddress = configuredAddress;
         this.includeServerName = includeServerName;
-        assert addresses.isEmpty() == false : "Cannot use proxy connection strategy with no configured addresses";
-        this.addresses = addresses;
+        assert Strings.isEmpty(configuredAddress) == false : "Cannot use proxy connection strategy with no configured addresses";
+        this.address = address;
         // TODO: Move into the ConnectionManager
         this.profile = new ConnectionProfile.Builder()
             .addConnections(1, TransportRequestOptions.Type.REG, TransportRequestOptions.Type.PING)
@@ -172,9 +165,9 @@ protected boolean shouldOpenMoreConnections() {
 
     @Override
     protected boolean strategyMustBeRebuilt(Settings newSettings) {
-        List<String> addresses = REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).get(newSettings);
+        String address = REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).get(newSettings);
         int numOfSockets = REMOTE_SOCKET_CONNECTIONS.getConcreteSettingForNamespace(clusterAlias).get(newSettings);
-        return numOfSockets != maxNumConnections || addressesChanged(configuredAddresses, addresses);
+        return numOfSockets != maxNumConnections || configuredAddress.equals(address) == false;
     }
 
     @Override
@@ -189,7 +182,7 @@ protected void connectImpl(ActionListener<Void> listener) {
 
     @Override
     public RemoteConnectionInfo.ModeInfo getModeInfo() {
-        return new ProxyModeInfo(configuredAddresses, maxNumConnections, connectionManager.size());
+        return new ProxyModeInfo(configuredAddress, maxNumConnections, connectionManager.size());
     }
 
     private void performProxyConnectionProcess(ActionListener<Void> listener) {
@@ -198,7 +191,7 @@ private void performProxyConnectionProcess(ActionListener<Void> listener) {
 
     private void openConnections(ActionListener<Void> finished, int attemptNumber) {
         if (attemptNumber <= MAX_CONNECT_ATTEMPTS_PER_RUN) {
-            List<TransportAddress> resolved = addresses.stream().map(Supplier::get).collect(Collectors.toList());
+            TransportAddress resolved = address.get();
 
             int remaining = maxNumConnections - connectionManager.size();
             ActionListener<Void> compositeListener = new ActionListener<>() {
@@ -228,15 +221,14 @@ public void onFailure(Exception e) {
 
 
             for (int i = 0; i < remaining; ++i) {
-                TransportAddress address = nextAddress(resolved);
-                String id = clusterAlias + "#" + address;
+                String id = clusterAlias + "#" + resolved;
                 Map<String, String> attributes;
                 if (includeServerName) {
-                    attributes = Collections.singletonMap("server_name", address.address().getHostString());
+                    attributes = Collections.singletonMap("server_name", resolved.address().getHostString());
                 } else {
                     attributes = Collections.emptyMap();
                 }
-                DiscoveryNode node = new DiscoveryNode(id, address, attributes, DiscoveryNodeRole.BUILT_IN_ROLES,
+                DiscoveryNode node = new DiscoveryNode(id, resolved, attributes, DiscoveryNodeRole.BUILT_IN_ROLES,
                     Version.CURRENT.minimumCompatibilityVersion());
 
                 connectionManager.connectToNode(node, profile, clusterNameValidator, new ActionListener<>() {
@@ -248,7 +240,7 @@ public void onResponse(Void v) {
                     @Override
                     public void onFailure(Exception e) {
                         logger.debug(new ParameterizedMessage("failed to open remote connection [remote cluster: {}, address: {}]",
-                            clusterAlias, address), e);
+                            clusterAlias, resolved), e);
                         compositeListener.onFailure(e);
                     }
                 });
@@ -276,40 +268,27 @@ private static TransportAddress resolveAddress(String address) {
         return new TransportAddress(parseConfiguredAddress(address));
     }
 
-    private boolean addressesChanged(final List<String> oldAddresses, final List<String> newAddresses) {
-        if (oldAddresses.size() != newAddresses.size()) {
-            return true;
-        }
-        Set<String> oldSeeds = new HashSet<>(oldAddresses);
-        Set<String> newSeeds = new HashSet<>(newAddresses);
-        return oldSeeds.equals(newSeeds) == false;
-    }
-
     static class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
 
-        private final List<String> addresses;
+        private final String address;
         private final int maxSocketConnections;
         private final int numSocketsConnected;
 
-        ProxyModeInfo(List<String> addresses, int maxSocketConnections, int numSocketsConnected) {
-            this.addresses = addresses;
+        ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
+            this.address = address;
             this.maxSocketConnections = maxSocketConnections;
             this.numSocketsConnected = numSocketsConnected;
         }
 
         private ProxyModeInfo(StreamInput input) throws IOException {
-            addresses = Arrays.asList(input.readStringArray());
+            address = input.readString();
             maxSocketConnections = input.readVInt();
             numSocketsConnected = input.readVInt();
         }
 
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            builder.startArray("addresses");
-            for (String address : addresses) {
-                builder.value(address);
-            }
-            builder.endArray();
+            builder.field("address", address);
             builder.field("num_sockets_connected", numSocketsConnected);
             builder.field("max_socket_connections", maxSocketConnections);
             return builder;
@@ -317,7 +296,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
-            out.writeStringArray(addresses.toArray(new String[0]));
+            out.writeString(address);
             out.writeVInt(maxSocketConnections);
             out.writeVInt(numSocketsConnected);
         }
@@ -344,12 +323,12 @@ public boolean equals(Object o) {
             ProxyModeInfo otherProxy = (ProxyModeInfo) o;
             return maxSocketConnections == otherProxy.maxSocketConnections &&
                 numSocketsConnected == otherProxy.numSocketsConnected &&
-                Objects.equals(addresses, otherProxy.addresses);
+                Objects.equals(address, otherProxy.address);
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(addresses, maxSocketConnections, numSocketsConnected);
+            return Objects.hash(address, maxSocketConnections, numSocketsConnected);
         }
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
index 562a6bfbe464f..1ee8fba2bd7eb 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ContextPreservingActionListener;
 import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.settings.Setting;
@@ -159,9 +160,8 @@ public static boolean isConnectionEnabled(String clusterAlias, Settings settings
             List<String> seeds = SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS.getConcreteSettingForNamespace(clusterAlias).get(settings);
             return seeds.isEmpty() == false;
         } else {
-            List<String> addresses = ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias)
-                .get(settings);
-            return addresses.isEmpty() == false;
+            String address = ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).get(settings);
+            return Strings.isEmpty(address) == false;
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
index 5644ff895725d..1106067055353 100644
--- a/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.node.DiscoveryNode;
-import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.settings.AbstractScopedSettings;
 import org.elasticsearch.common.settings.ClusterSettings;
@@ -32,19 +31,16 @@
 import org.elasticsearch.common.transport.TransportAddress;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.transport.MockTransportService;
-import org.elasticsearch.test.transport.StubbableTransport;
 import org.elasticsearch.threadpool.TestThreadPool;
 import org.elasticsearch.threadpool.ThreadPool;
 
-import java.util.ArrayList;
 import java.util.Arrays;
-import java.util.Collections;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
-import java.util.concurrent.atomic.AtomicInteger;
+import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.Supplier;
 import java.util.stream.Collectors;
 
@@ -86,11 +82,9 @@ public MockTransportService startTransport(final String id, final Version versio
         }
     }
 
-    public void testProxyStrategyWillOpenExpectedNumberOfConnectionsToAddresses() {
-        try (MockTransportService transport1 = startTransport("node1", Version.CURRENT);
-             MockTransportService transport2 = startTransport("node2", Version.CURRENT)) {
+    public void testProxyStrategyWillOpenExpectedNumberOfConnectionsToAddress() {
+        try (MockTransportService transport1 = startTransport("node1", Version.CURRENT)) {
             TransportAddress address1 = transport1.boundAddress().publishAddress();
-            TransportAddress address2 = transport2.boundAddress().publishAddress();
 
             try (MockTransportService localService = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool)) {
                 localService.start();
@@ -100,16 +94,14 @@ public void testProxyStrategyWillOpenExpectedNumberOfConnectionsToAddresses() {
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, addresses(address1, address2))) {
+                         numOfConnections, address1.toString())) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
-                    assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
 
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
                     strategy.connect(connectFuture);
                     connectFuture.actionGet();
 
                     assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
-                    assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
                     assertEquals(numOfConnections, connectionManager.size());
                     assertTrue(strategy.assertNoRunningConnections());
                 }
@@ -129,9 +121,10 @@ public void testProxyStrategyWillOpenNewConnectionsOnDisconnect() throws Excepti
 
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
+
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, addresses(address1, address2))) {
+                         numOfConnections, address1.toString(), alternatingResolver(address1, address2), false)) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
 
@@ -143,7 +136,7 @@ numOfConnections, addresses(address1, address2))) {
                     long initialConnectionsToTransport2 = connectionManager.getAllConnectedNodes().stream()
                         .filter(n -> n.getAddress().equals(address2))
                         .count();
-                    assertNotEquals(0, initialConnectionsToTransport2);
+                    assertEquals(0, initialConnectionsToTransport2);
                     assertEquals(numOfConnections, connectionManager.size());
                     assertTrue(strategy.assertNoRunningConnections());
 
@@ -151,11 +144,12 @@ numOfConnections, addresses(address1, address2))) {
 
                     assertBusy(() -> {
                         assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
-                        // More connections now pointing to transport2
+                        // Connections now pointing to transport2
                         long finalConnectionsToTransport2 = connectionManager.getAllConnectedNodes().stream()
                             .filter(n -> n.getAddress().equals(address2))
                             .count();
-                        assertTrue(finalConnectionsToTransport2 > initialConnectionsToTransport2);
+                        assertNotEquals(0, finalConnectionsToTransport2);
+                        assertEquals(numOfConnections, connectionManager.size());
                         assertTrue(strategy.assertNoRunningConnections());
                     });
                 }
@@ -163,56 +157,6 @@ numOfConnections, addresses(address1, address2))) {
         }
     }
 
-    public void testConnectWithSingleIncompatibleNode() {
-        Version incompatibleVersion = Version.CURRENT.minimumCompatibilityVersion().minimumCompatibilityVersion();
-        try (MockTransportService transport1 = startTransport("compatible-node", Version.CURRENT);
-             MockTransportService transport2 = startTransport("incompatible-node", incompatibleVersion)) {
-            TransportAddress address1 = transport1.boundAddress().publishAddress();
-            TransportAddress address2 = transport2.boundAddress().publishAddress();
-
-            try (MockTransportService localService = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool)) {
-                localService.start();
-                localService.acceptIncomingRequests();
-
-                StubbableTransport stubbableTransport = new StubbableTransport(localService.transport);
-                ConnectionManager connectionManager = new ConnectionManager(profile, stubbableTransport);
-                AtomicInteger address1Attempts = new AtomicInteger(0);
-                AtomicInteger address2Attempts = new AtomicInteger(0);
-                stubbableTransport.setDefaultConnectBehavior((transport, discoveryNode, profile, listener) -> {
-                    if (discoveryNode.getAddress().equals(address1)) {
-                        address1Attempts.incrementAndGet();
-                        transport.openConnection(discoveryNode, profile, listener);
-                    } else if (discoveryNode.getAddress().equals(address2)) {
-                        address2Attempts.incrementAndGet();
-                        transport.openConnection(discoveryNode, profile, listener);
-                    } else {
-                        throw new AssertionError("Unexpected address");
-                    }
-                });
-                int numOfConnections = 5;
-                try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
-                     ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, addresses(address1, address2))) {
-                    assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
-                    assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
-
-                    PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
-                    strategy.connect(connectFuture);
-                    connectFuture.actionGet();
-
-                    assertEquals(4 ,connectionManager.size());
-                    assertEquals(4 ,connectionManager.getAllConnectedNodes().stream().map(n -> n.getAddress().equals(address1)).count());
-                    // Three attempts on first round, one attempts on second round, zero attempts on third round
-                    assertEquals(4, address1Attempts.get());
-                    // Two attempts on first round, one attempt on second round, one attempt on third round
-                    assertEquals(4, address2Attempts.get());
-                    assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
-                    assertTrue(strategy.assertNoRunningConnections());
-                }
-            }
-        }
-    }
-
     public void testConnectFailsWithIncompatibleNodes() {
         Version incompatibleVersion = Version.CURRENT.minimumCompatibilityVersion().minimumCompatibilityVersion();
         try (MockTransportService transport1 = startTransport("incompatible-node", incompatibleVersion)) {
@@ -226,7 +170,7 @@ public void testConnectFailsWithIncompatibleNodes() {
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, addresses(address1))) {
+                         numOfConnections, address1.toString())) {
 
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
                     strategy.connect(connectFuture);
@@ -254,9 +198,11 @@ public void testClusterNameValidationPreventConnectingToDifferentClusters() thro
 
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
+
+                Supplier<TransportAddress> resolver = alternatingResolver(address1, address2);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, addresses(address1, address2))) {
+                         numOfConnections, address1.toString(), resolver, false)) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
 
@@ -264,12 +210,23 @@ numOfConnections, addresses(address1, address2))) {
                     strategy.connect(connectFuture);
                     connectFuture.actionGet();
 
-                    if (connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1))) {
-                        assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
-                    } else {
-                        assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
-                    }
-                    assertTrue(strategy.assertNoRunningConnections());
+                    assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
+                    assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
+
+                    transport1.close();
+
+                    assertBusy(() -> {
+                        assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
+                        assertTrue(strategy.assertNoRunningConnections());
+
+                        long finalConnectionsToTransport2 = connectionManager.getAllConnectedNodes().stream()
+                            .filter(n -> n.getAddress().equals(address2))
+                            .count();
+
+                        // Connections not pointing to transport2 because the cluster name is different
+                        assertEquals(0, finalConnectionsToTransport2);
+                        assertEquals(0, connectionManager.size());
+                    });
                 }
             }
         }
@@ -293,7 +250,7 @@ public void testProxyStrategyWillResolveAddressesEachConnect() throws Exception
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections,  addresses(address), Collections.singletonList(addressSupplier), false)) {
+                         numOfConnections, address.toString(), addressSupplier, false)) {
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
                     strategy.connect(connectFuture);
                     connectFuture.actionGet();
@@ -307,10 +264,8 @@ numOfConnections,  addresses(address), Collections.singletonList(addressSupplier
     }
 
     public void testProxyStrategyWillNeedToBeRebuiltIfNumOfSocketsOrAddressesChange() {
-        try (MockTransportService transport1 = startTransport("node1", Version.CURRENT);
-             MockTransportService transport2 = startTransport("node2", Version.CURRENT)) {
-            TransportAddress address1 = transport1.boundAddress().publishAddress();
-            TransportAddress address2 = transport2.boundAddress().publishAddress();
+        try (MockTransportService remoteTransport = startTransport("node1", Version.CURRENT)) {
+            TransportAddress remoteAddress = remoteTransport.boundAddress().publishAddress();
 
             try (MockTransportService localService = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool)) {
                 localService.start();
@@ -320,13 +275,12 @@ public void testProxyStrategyWillNeedToBeRebuiltIfNumOfSocketsOrAddressesChange(
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, addresses(address1, address2))) {
+                         numOfConnections, remoteAddress.toString())) {
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
                     strategy.connect(connectFuture);
                     connectFuture.actionGet();
 
-                    assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
-                    assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
+                    assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(remoteAddress)));
                     assertEquals(numOfConnections, connectionManager.size());
                     assertTrue(strategy.assertNoRunningConnections());
 
@@ -339,18 +293,18 @@ numOfConnections, addresses(address1, address2))) {
 
                     Settings noChange = Settings.builder()
                         .put(modeSetting.getKey(), "proxy")
-                        .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1, address2).toArray()))
+                        .put(addressesSetting.getKey(), remoteAddress.toString())
                         .put(socketConnections.getKey(), numOfConnections)
                         .build();
                     assertFalse(strategy.shouldRebuildConnection(noChange));
                     Settings addressesChanged = Settings.builder()
                         .put(modeSetting.getKey(), "proxy")
-                        .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1).toArray()))
+                        .put(addressesSetting.getKey(), remoteAddress.toString())
                         .build();
                     assertTrue(strategy.shouldRebuildConnection(addressesChanged));
                     Settings socketsChanged = Settings.builder()
                         .put(modeSetting.getKey(), "proxy")
-                        .put(addressesSetting.getKey(), Strings.arrayToCommaDelimitedString(addresses(address1, address2).toArray()))
+                        .put(addressesSetting.getKey(), remoteAddress.toString())
                         .put(socketConnections.getKey(), numOfConnections + 1)
                         .build();
                     assertTrue(strategy.shouldRebuildConnection(socketsChanged));
@@ -398,14 +352,13 @@ public void testServerNameAttributes() {
                 localService.start();
                 localService.acceptIncomingRequests();
 
-                ArrayList<String> addresses = new ArrayList<>();
-                addresses.add("localhost:" + address1.getPort());
+                String serverName = "localhost:" + address1.getPort();
 
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, addresses, true)) {
+                         numOfConnections, serverName, true)) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
 
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
@@ -422,7 +375,18 @@ public void testServerNameAttributes() {
         }
     }
 
-    private static List<String> addresses(final TransportAddress... addresses) {
-        return Arrays.stream(addresses).map(TransportAddress::toString).collect(Collectors.toList());
+    private Supplier<TransportAddress> alternatingResolver(TransportAddress address1, TransportAddress address2) {
+        // On the first connection round, the connections will be routed to transport1. On the second
+        //connection round, the connections will be routed to transport2
+        AtomicBoolean transportSwitch = new AtomicBoolean(true);
+        return () -> {
+            if (transportSwitch.get()) {
+                transportSwitch.set(false);
+                return address1;
+            } else {
+                transportSwitch.set(true);
+                return address2;
+            }
+        };
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
index 030174dde5f90..195e979c56dc5 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
@@ -356,8 +356,8 @@ public void testRemoteConnectionInfo() throws IOException {
             modeInfo1 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 4, 4);
             modeInfo2 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 4, 3);
         } else {
-            modeInfo1 = new ProxyConnectionStrategy.ProxyModeInfo(remoteAddresses, 18, 18);
-            modeInfo2 = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 18, 17);
+            modeInfo1 = new ProxyConnectionStrategy.ProxyModeInfo(remoteAddresses.get(0), 18, 18);
+            modeInfo2 = new ProxyConnectionStrategy.ProxyModeInfo(remoteAddresses.get(0), 18, 17);
         }
 
         RemoteConnectionInfo stats =
@@ -404,7 +404,7 @@ public void testRenderConnectionInfoXContent() throws IOException {
         if (sniff) {
             modeInfo = new SniffConnectionStrategy.SniffModeInfo(remoteAddresses, 3, 2);
         } else {
-            modeInfo = new ProxyConnectionStrategy.ProxyModeInfo(remoteAddresses, 18, 16);
+            modeInfo = new ProxyConnectionStrategy.ProxyModeInfo(remoteAddresses.get(0), 18, 16);
         }
 
         RemoteConnectionInfo stats = new RemoteConnectionInfo("test_cluster", modeInfo, TimeValue.timeValueMinutes(30), true);
@@ -419,7 +419,7 @@ public void testRenderConnectionInfoXContent() throws IOException {
                 "\"num_nodes_connected\":2,\"max_connections_per_cluster\":3,\"initial_connect_timeout\":\"30m\"," +
                 "\"skip_unavailable\":true}}", Strings.toString(builder));
         } else {
-            assertEquals("{\"test_cluster\":{\"connected\":true,\"mode\":\"proxy\",\"addresses\":[\"seed:1\",\"seed:2\"]," +
+            assertEquals("{\"test_cluster\":{\"connected\":true,\"mode\":\"proxy\",\"address\":\"seed:1\"," +
                 "\"num_sockets_connected\":16,\"max_socket_connections\":18,\"initial_connect_timeout\":\"30m\"," +
                 "\"skip_unavailable\":true}}", Strings.toString(builder));
         }
@@ -620,7 +620,7 @@ private Settings buildRandomSettings(String clusterAlias, List<String> addresses
     private static Settings buildProxySettings(String clusterAlias, List<String> addresses) {
         Settings.Builder builder = Settings.builder();
         builder.put(ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).getKey(),
-            Strings.collectionToCommaDelimitedString(addresses));
+            addresses.get(0));
         builder.put(RemoteConnectionStrategy.REMOTE_CONNECTION_MODE.getConcreteSettingForNamespace(clusterAlias).getKey(), "proxy");
         return builder.build();
     }
diff --git a/x-pack/qa/multi-cluster-search-security/src/test/resources/rest-api-spec/test/multi_cluster/70_connection_mode_configuration.yml b/x-pack/qa/multi-cluster-search-security/src/test/resources/rest-api-spec/test/multi_cluster/70_connection_mode_configuration.yml
index 5606a08cd261e..05185cb3e3328 100644
--- a/x-pack/qa/multi-cluster-search-security/src/test/resources/rest-api-spec/test/multi_cluster/70_connection_mode_configuration.yml
+++ b/x-pack/qa/multi-cluster-search-security/src/test/resources/rest-api-spec/test/multi_cluster/70_connection_mode_configuration.yml
@@ -14,7 +14,7 @@
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
             cluster.remote.test_remote_cluster.node_connections: "5"
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
@@ -29,7 +29,7 @@
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
             cluster.remote.test_remote_cluster.seeds: $remote_ip
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
@@ -64,12 +64,12 @@
         flat_settings: true
         body:
           transient:
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
             cluster.remote.test_remote_cluster.seeds: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
-  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.proxy_addresses\" cannot be
+  - match: { error.root_cause.0.reason: "Setting \"cluster.remote.test_remote_cluster.proxy_address\" cannot be
    used with the configured \"cluster.remote.test_remote_cluster.mode\" [required=PROXY, configured=SNIFF]" }
 
 ---
@@ -87,11 +87,11 @@
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
             cluster.remote.test_remote_cluster.proxy_socket_connections: "3"
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
   - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_socket_connections: "3"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_address: $remote_ip}
 
   - do:
       search:
@@ -179,7 +179,7 @@
         body:
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: { status: 400 }
   - match: { error.root_cause.0.type: "illegal_argument_exception" }
@@ -193,10 +193,10 @@
           transient:
             cluster.remote.test_remote_cluster.mode: "proxy"
             cluster.remote.test_remote_cluster.seeds: null
-            cluster.remote.test_remote_cluster.proxy_addresses: $remote_ip
+            cluster.remote.test_remote_cluster.proxy_address: $remote_ip
 
   - match: {transient.cluster\.remote\.test_remote_cluster\.mode: "proxy"}
-  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_addresses: $remote_ip}
+  - match: {transient.cluster\.remote\.test_remote_cluster\.proxy_address: $remote_ip}
 
   - do:
       search:

From 7038fd2b60ab9f9bf171395b40ecf979f3d7f8d8 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Thu, 19 Dec 2019 12:47:53 -0800
Subject: [PATCH 279/686] Add --data-dir option to run task (#50342)

This commit adds a special run.datadir system property that may be
passed to `./gradlew run` which sets the root data directory used by the
task. While normally overriding the data path is not allowed for test
clusters, it is useful when experimenting with the run task.

closes #50338
---
 build.gradle                                  |  8 +++++
 .../testclusters/ElasticsearchNode.java       |  6 +++-
 .../gradle/testclusters/RunTask.java          | 29 +++++++++++++++++++
 3 files changed, 42 insertions(+), 1 deletion(-)

diff --git a/build.gradle b/build.gradle
index df1641dcc9efe..b03bb7e5a3794 100644
--- a/build.gradle
+++ b/build.gradle
@@ -434,6 +434,14 @@ class Run extends DefaultTask {
   public void setDebug(boolean enabled) {
     project.project(':distribution').run.debug = enabled
   }
+
+  @Option(
+    option = "data-dir",
+    description = "Override the base data directory used by the testcluster"
+  )
+  public void setDataDir(String dataDirStr) {
+    project.project(':distribution').run.dataDir = dataDirStr
+  }
 }
 
 task run(type: Run) {
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
index f43f28190da1a..3f54e4e16a149 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
@@ -134,7 +134,6 @@ public class ElasticsearchNode implements TestClusterConfiguration {
 
     private final Path confPathRepo;
     private final Path configFile;
-    private final Path confPathData;
     private final Path confPathLogs;
     private final Path transportPortFile;
     private final Path httpPortsFile;
@@ -151,6 +150,7 @@ public class ElasticsearchNode implements TestClusterConfiguration {
     private boolean isWorkingDirConfigured = false;
     private String httpPort = "0";
     private String transportPort = "0";
+    private Path confPathData;
 
     ElasticsearchNode(String path, String name, Project project, ReaperService reaper, File workingDirBase) {
         this.path = path;
@@ -1341,6 +1341,10 @@ void setTransportPort(String transportPort) {
         this.transportPort = transportPort;
     }
 
+    void setDataPath(Path dataPath) {
+        this.confPathData = dataPath;
+    }
+
     @Internal
     Path getEsStdoutFile() {
         return esStdoutFile;
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
index 2282651f6d4c1..07e5a6ae221f1 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
@@ -10,9 +10,12 @@
 import java.io.Closeable;
 import java.io.IOException;
 import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
+import java.util.function.Function;
 import java.util.stream.Collectors;
 
 public class RunTask extends DefaultTestClustersTask {
@@ -22,6 +25,8 @@ public class RunTask extends DefaultTestClustersTask {
 
     private Boolean debug = false;
 
+    private Path dataDir = null;
+
     @Option(
         option = "debug-jvm",
         description = "Enable debugging configuration, to allow attaching a debugger to elasticsearch."
@@ -35,6 +40,19 @@ public Boolean getDebug() {
         return debug;
     }
 
+    @Option(
+        option = "data-dir",
+        description = "Override the base data directory used by the testcluster"
+    )
+    public void setDataDir(String dataDirStr) {
+        dataDir = Paths.get(dataDirStr).toAbsolutePath();
+    }
+
+    @Input
+    public String getDataDir() {
+        return dataDir.toString();
+    }
+
     @Override
     public void beforeStart() {
         int debugPort = 5005;
@@ -46,6 +64,14 @@ public void beforeStart() {
                 entry -> entry.getKey().toString().substring(CUSTOM_SETTINGS_PREFIX.length()),
                 entry -> entry.getValue().toString()
             ));
+        boolean singleNode = getClusters().stream().flatMap(c -> c.getNodes().stream()).count() == 1;
+        final Function<ElasticsearchNode, Path> getDataPath;
+        if (singleNode) {
+            getDataPath = n -> dataDir;
+        } else {
+            getDataPath = n -> dataDir.resolve(n.getName());
+        }
+
         for (ElasticsearchCluster cluster : getClusters()) {
             cluster.getFirstNode().setHttpPort(String.valueOf(httpPort));
             httpPort++;
@@ -53,6 +79,9 @@ public void beforeStart() {
             transportPort++;
             for (ElasticsearchNode node : cluster.getNodes()) {
                 additionalSettings.forEach(node::setting);
+                if (dataDir != null) {
+                    node.setDataPath(getDataPath.apply(node));
+                }
                 if (debug) {
                     logger.lifecycle(
                         "Running elasticsearch in debug mode, {} suspending until connected on debugPort {}",

From a8adee423fa09f83afb53602298c3e5f63aaa1cc Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Thu, 19 Dec 2019 12:55:11 -0800
Subject: [PATCH 280/686] Add shell script for performing atomic pushes across
 branches (#50401)

---
 dev-tools/atomic_push.sh | 55 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100755 dev-tools/atomic_push.sh

diff --git a/dev-tools/atomic_push.sh b/dev-tools/atomic_push.sh
new file mode 100755
index 0000000000000..d1b735f15374e
--- /dev/null
+++ b/dev-tools/atomic_push.sh
@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+set -e
+
+if [ "$#" -eq 0 ]; then
+    printf 'Usage: %s <origin> <branch> <branch> ...\n' "$(basename "$0")"
+    exit 0;
+fi
+
+REMOTE="$1"
+
+if ! git ls-remote --exit-code "${REMOTE}" > /dev/null 2>&1; then
+    echo >&2 "Remote '${REMOTE}' is not valid."
+    exit 1;
+fi
+
+if [ "$#" -lt 3 ]; then
+    echo >&2 "You must specify at least two branchs to push."
+    exit 1;
+fi
+
+if ! git diff-index --quiet HEAD -- ; then
+    echo >&2 "Found uncommitted changes in working copy."
+    exit 1;
+fi
+
+ATOMIC_COMMIT_DATE="$(date)"
+
+for BRANCH in "${@:2}"
+do
+    echo "Validating branch '${BRANCH}'..."
+    
+    # Vailidate that script arguments are valid local branch names
+    if ! git show-ref --verify --quiet "refs/heads/${BRANCH}"; then
+        echo >&2 "No such branch named '${BRANCH}'."
+        exit 1;
+    fi
+    
+    # Pull and rebase all branches to ensure we've incorporated any new upstream commits
+    git checkout --quiet ${BRANCH}
+    git pull "${REMOTE}" --rebase --quiet
+    
+    PENDING_COMMITS=$(git log ${REMOTE}/${BRANCH}..HEAD --oneline | grep "^.*$" -c || true)
+    
+    # Ensure that there is exactly 1 unpushed commit in the branch
+    if [ "${PENDING_COMMITS}" -ne 1 ]; then
+        echo >&2 "Expected exactly 1 pending commit for branch '${BRANCH}' but ${PENDING_COMMITS} exist."
+        exit 1;
+    fi
+    
+    # Amend HEAD commit to ensure all branch commit dates are the same
+    GIT_COMMITTER_DATE="${ATOMIC_COMMIT_DATE}" git commit --amend --no-edit --quiet
+done
+
+echo "Pushing to remote '${REMOTE}'..."
+git push --atomic "${REMOTE}" "${@:2}"

From 1ff250c5b75037cde323f97bbbeedbd2789db37f Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@iernst.net>
Date: Thu, 19 Dec 2019 12:56:06 -0800
Subject: [PATCH 281/686] Fix location of README file for rpm/deb

The file suffix was changed but package building instructions were
missed.
---
 distribution/packages/build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/distribution/packages/build.gradle b/distribution/packages/build.gradle
index 99de6773c0f92..9e90412cb0c54 100644
--- a/distribution/packages/build.gradle
+++ b/distribution/packages/build.gradle
@@ -131,7 +131,7 @@ Closure commonPackageConfig(String type, boolean oss, boolean jdk) {
         with binFiles(type, oss, jdk)
       }
       from(rootProject.projectDir) {
-        include 'README.textile'
+        include 'README.asciidoc'
         fileMode 0644
       }
       into('lib') {

From 0dbda01f23c56b1842790ffa6b93bb540dc1e2ed Mon Sep 17 00:00:00 2001
From: Marios Trivyzas <matriv@gmail.com>
Date: Fri, 20 Dec 2019 00:19:22 +0200
Subject: [PATCH 282/686] SQL: Fix issue with CAST and NULL checking. (#50371)

Previously, during expression optimisation, CAST would be considered
nullable if the casted expression resulted to a NULL literal, and would
be always non-nullable otherwise. As a result if CASE was wrapped by a
null check function like IS NULL or IS NOT NULL it was simplified to
TRUE/FALSE, eliminating the actual casting operation. So in case of an
expression with an erroneous casting like CAST('foo' AS DATETIME) IS NULL
it would be simplified to FALSE instead of throwing an Exception signifying
the attempt to cast 'foo' to a DATETIME type.

CAST now always returns Nullability.UKNOWN except from the case that
its result evaluated to a constant NULL, where it returns Nullability.TRUE.
This way the IS NULL/IS NOT NULL don't get simplified to FALSE/TRUE
and the CAST actually gets evaluated resulting to a thrown Exception.

Fixes: #50191
---
 .../sql/expression/function/scalar/Cast.java  |  2 +-
 .../nulls/CheckNullProcessorTests.java        |  6 ---
 .../xpack/sql/optimizer/OptimizerTests.java   | 51 ++++++++++++++++++-
 3 files changed, 51 insertions(+), 8 deletions(-)

diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
index c3c0da0570903..35bc87eabd7b2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
@@ -66,7 +66,7 @@ public Nullability nullable() {
         if (from().isNull()) {
             return Nullability.TRUE;
         }
-        return field().nullable();
+        return Nullability.UNKNOWN;
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessorTests.java
index 01b8ba80de260..4ed35e2f9caa7 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessorTests.java
@@ -9,15 +9,9 @@
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 public class CheckNullProcessorTests extends AbstractWireSerializingTestCase<CheckNullProcessor> {
 
-    private static final Processor FALSE = new ConstantProcessor(false);
-    private static final Processor TRUE = new ConstantProcessor(true);
-    private static final Processor NULL = new ConstantProcessor((Object) null);
-
     public static CheckNullProcessor randomProcessor() {
         return new CheckNullProcessor(randomFrom(CheckNullProcessor.CheckNullOperation.values()));
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
index c81b376c0a534..1f45d917dabd2 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.sql.optimizer;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer.PruneSubqueryAliases;
 import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
 import org.elasticsearch.xpack.sql.expression.Alias;
@@ -438,10 +439,46 @@ public void testNullFoldingIsNull() {
         assertEquals(false, foldNull.rule(new IsNull(EMPTY, TRUE)).fold());
     }
 
+    public void testNullFoldingIsNullWithCast() {
+        FoldNull foldNull = new FoldNull();
+
+        Cast cast = new Cast(EMPTY, L("foo"), DataType.DATE);
+        IsNull isNull = new IsNull(EMPTY, cast);
+        final IsNull isNullOpt = (IsNull) foldNull.rule(isNull);
+        assertEquals(isNull, isNullOpt);
+
+        SqlIllegalArgumentException sqlIAE =
+                expectThrows(SqlIllegalArgumentException.class, () -> isNullOpt.asPipe().asProcessor().process(null));
+        assertEquals("cannot cast [foo] to [date]: Text 'foo' could not be parsed at index 0", sqlIAE.getMessage());
+
+        isNull = new IsNull(EMPTY, new Cast(EMPTY, NULL, randomFrom(DataType.values())));
+        assertTrue((Boolean) ((IsNull) foldNull.rule(isNull)).asPipe().asProcessor().process(null));
+    }
+
     public void testNullFoldingIsNotNull() {
         FoldNull foldNull = new FoldNull();
         assertEquals(true, foldNull.rule(new IsNotNull(EMPTY, TRUE)).fold());
         assertEquals(false, foldNull.rule(new IsNotNull(EMPTY, NULL)).fold());
+
+        Cast cast = new Cast(EMPTY, L("foo"), DataType.DATE);
+        IsNotNull isNotNull = new IsNotNull(EMPTY, cast);
+        assertEquals(isNotNull, foldNull.rule(isNotNull));
+    }
+
+    public void testNullFoldingIsNotNullWithCast() {
+        FoldNull foldNull = new FoldNull();
+
+        Cast cast = new Cast(EMPTY, L("foo"), DataType.DATE);
+        IsNotNull isNotNull = new IsNotNull(EMPTY, cast);
+        final IsNotNull isNotNullOpt = (IsNotNull) foldNull.rule(isNotNull);
+        assertEquals(isNotNull, isNotNullOpt);
+
+        SqlIllegalArgumentException sqlIAE =
+                expectThrows(SqlIllegalArgumentException.class, () -> isNotNullOpt.asPipe().asProcessor().process(null));
+        assertEquals("cannot cast [foo] to [date]: Text 'foo' could not be parsed at index 0", sqlIAE.getMessage());
+
+        isNotNull = new IsNotNull(EMPTY, new Cast(EMPTY, NULL, randomFrom(DataType.values())));
+        assertFalse((Boolean) ((IsNotNull) foldNull.rule(isNotNull)).asPipe().asProcessor().process(null));
     }
 
     public void testGenericNullableExpression() {
@@ -461,6 +498,18 @@ public void testGenericNullableExpression() {
         assertNullLiteral(rule.rule(new RLike(EMPTY, NULL, "123")));
     }
 
+    public void testNullFoldingOnCast() {
+        FoldNull foldNull = new FoldNull();
+
+        Cast cast = new Cast(EMPTY, NULL, randomFrom(DataType.values()));
+        assertEquals(Nullability.TRUE, cast.nullable());
+        assertNull(foldNull.rule(cast).fold());
+
+        cast = new Cast(EMPTY, L("foo"), DataType.DATE);
+        assertEquals(Nullability.UNKNOWN, cast.nullable());
+        assertEquals(cast, foldNull.rule(cast));
+    }
+
     public void testNullFoldingDoesNotApplyOnLogicalExpressions() {
         FoldNull rule = new FoldNull();
 
@@ -1684,4 +1733,4 @@ public void testReplaceAttributesWithTarget() {
         gt = (GreaterThan) and.left();
         assertEquals(a, gt.left());
     }
-}
\ No newline at end of file
+}

From 4b94ce3af686568e20410d3edf5a4fff01585e12 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Thu, 19 Dec 2019 14:37:25 -0800
Subject: [PATCH 283/686] Disable experimental job trigger

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 .ci/jobs.t/elastic+elasticsearch+{branch}+periodic-next.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.ci/jobs.t/elastic+elasticsearch+{branch}+periodic-next.yml b/.ci/jobs.t/elastic+elasticsearch+{branch}+periodic-next.yml
index 2a6d868853b03..1ca650911bc11 100644
--- a/.ci/jobs.t/elastic+elasticsearch+{branch}+periodic-next.yml
+++ b/.ci/jobs.t/elastic+elasticsearch+{branch}+periodic-next.yml
@@ -3,5 +3,4 @@
     workspace: /dev/shm/elastic+elasticsearch+%BRANCH%+periodic
     display-name: "elastic / elasticsearch # %BRANCH% - periodic (experimental)"
     description: "Periodic testing of the Elasticsearch %BRANCH% branch.\n"
-    triggers:
-      - timed: "H H/1 * * *"
+    triggers: []

From a161296ba0193971a86de0a607cdae05faef3854 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Thu, 19 Dec 2019 14:47:28 -0800
Subject: [PATCH 284/686] [DOCS] Updates ML links (#50387)

---
 docs/reference/intro.asciidoc                 |  2 +-
 .../apis/delete-filter.asciidoc               |  2 +-
 .../apis/delete-forecast.asciidoc             |  2 +-
 .../apis/eventresource.asciidoc               |  2 +-
 .../apis/filterresource.asciidoc              |  2 +-
 .../anomaly-detection/apis/forecast.asciidoc  |  2 +-
 .../apis/get-calendar-event.asciidoc          |  2 +-
 .../apis/get-calendar.asciidoc                |  2 +-
 .../apis/get-category.asciidoc                |  2 +-
 .../apis/get-filter.asciidoc                  |  2 +-
 .../apis/get-overall-buckets.asciidoc         |  2 +-
 .../apis/post-calendar-event.asciidoc         |  2 +-
 .../apis/put-calendar.asciidoc                |  2 +-
 .../apis/put-filter.asciidoc                  |  2 +-
 docs/reference/ml/ml-shared.asciidoc          | 22 +++++++++----------
 docs/reference/modules/node.asciidoc          |  2 +-
 docs/reference/redirects.asciidoc             |  6 ++---
 docs/reference/setup/restart-cluster.asciidoc |  2 +-
 docs/reference/upgrade/close-ml.asciidoc      |  2 +-
 .../upgrade/reindex_upgrade.asciidoc          |  4 ++--
 20 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/docs/reference/intro.asciidoc b/docs/reference/intro.asciidoc
index c16f1bd78a1d5..2591487bd04db 100644
--- a/docs/reference/intro.asciidoc
+++ b/docs/reference/intro.asciidoc
@@ -168,7 +168,7 @@ embroidery_ needles.
 ==== But wait, there’s more
 
 Want to automate the analysis of your time-series data? You can use
-{stack-ov}/ml-overview.html[machine learning] features to create accurate
+{ml-docs}/ml-overview.html[machine learning] features to create accurate
 baselines of normal behavior in your data and identify anomalous patterns. With
 machine learning, you can detect:
 
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
index d6c563fbe0a88..ffb2f7b894cc4 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
@@ -23,7 +23,7 @@ Deletes a filter.
 [[ml-delete-filter-desc]]
 ==== {api-description-title}
 
-This API deletes a {stack-ov}/ml-rules.html[filter]. 
+This API deletes a {ml-docs}/ml-rules.html[filter]. 
 If a {ml} job references the filter, you cannot delete the filter. You must 
 update or delete the job before you can delete the filter.
 
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
index d723b3fba4877..e269d532b0c27 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
@@ -35,7 +35,7 @@ one or more forecasts before they expire.
 NOTE: When you delete a job, its associated forecasts are deleted. 
 
 For more information, see
-{stack-ov}/ml-overview.html#ml-forecasting[Forecasting the future].
+{ml-docs}/ml-overview.html#ml-forecasting[Forecasting the future].
 
 [[ml-delete-forecast-path-parms]]
 ==== {api-path-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc
index 4fb179be3cbca..2f3ea4175936a 100644
--- a/docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc
@@ -24,4 +24,4 @@ An events resource has the following properties:
  in milliseconds since the epoch or ISO 8601 format.
 
 For more information, see
-{stack-ov}/ml-calendars.html[Calendars and Scheduled Events].
+{ml-docs}/ml-calendars.html[Calendars and scheduled events].
diff --git a/docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc
index 520a2a99a3c71..39d63aec6a418 100644
--- a/docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc
@@ -14,4 +14,4 @@ A filter resource has the following properties:
 `items`::
   (array of strings) An array of strings which is the filter item list.
   
-For more information, see {stack-ov}/ml-rules.html[Machine learning custom rules].
+For more information, see {ml-docs}/ml-rules.html[Machine learning custom rules].
diff --git a/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
index 0ec17ea9bd25e..61b8981843184 100644
--- a/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
@@ -23,7 +23,7 @@ Predicts the future behavior of a time series by using its historical behavior.
 [[ml-forecast-desc]]
 ==== {api-description-title}
 
-See {stack-ov}/ml-overview.html#ml-forecasting[Forecasting the future].
+See {ml-docs}/ml-overview.html#ml-forecasting[Forecasting the future].
 
 [NOTE]
 ===============================
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
index adf50483e25a5..7824c08e1da41 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
@@ -29,7 +29,7 @@ You can get scheduled event information for a single calendar or for all
 calendars by using `_all`.
 
 For more information, see
-{stack-ov}/ml-calendars.html[Calendars and scheduled events].
+{ml-docs}/ml-calendars.html[Calendars and scheduled events].
 
 [[ml-get-calendar-event-path-parms]]
 ==== {api-path-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
index 9552ba687033c..f2243825b81f0 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
@@ -29,7 +29,7 @@ You can get information for a single calendar or for all calendars by using
 `_all`.
 
 For more information, see 
-{stack-ov}/ml-calendars.html[Calendars and scheduled events].
+{ml-docs}/ml-calendars.html[Calendars and scheduled events].
 
 [[ml-get-calendar-path-parms]]
 ==== {api-path-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
index 92beaa0360b5e..97acffbc4a198 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
@@ -37,7 +37,7 @@ The anomaly results from a categorization analysis are available as bucket,
 influencer, and record results. For example, the results might indicate that
 at 16:45 there was an unusual count of log message category 11. You can then
 examine the description and examples of that category. For more information, see
-{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
+{ml-docs}/ml-configuring-categories.html[Categorizing log messages].
 
 [[ml-get-category-path-parms]]
 ==== {api-path-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
index 6ed8ee4fa0c41..6852ca7716d07 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
@@ -26,7 +26,7 @@ Retrieves filters.
 ==== {api-description-title}
 
 You can get a single filter or all filters. For more information, see 
-{stack-ov}/ml-rules.html[Machine learning custom rules].
+{ml-docs}/ml-rules.html[Machine learning custom rules].
 
 [[ml-get-filter-path-parms]]
 ==== {api-path-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
index 3c0df917e4b3c..ab1b5588cccfd 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
@@ -36,7 +36,7 @@ by specifying `*` as the `<job_id>`.
 By default, an overall bucket has a span equal to the largest bucket span of the
 specified {anomaly-jobs}. To override that behavior, use the optional
 `bucket_span` parameter. To learn more about the concept of buckets, see
-{stack-ov}/ml-buckets.html[Buckets].
+{ml-docs}/ml-buckets.html[Buckets].
 
 The `overall_score` is calculated by combining the scores of all the buckets
 within the overall bucket span. First, the maximum `anomaly_score` per
diff --git a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
index d7d3feedfdf3a..c241e7acdeb57 100644
--- a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
@@ -23,7 +23,7 @@ Posts scheduled events in a calendar.
 [[ml-post-calendar-event-desc]]
 ==== {api-description-title}
 
-This API accepts a list of {stack-ov}/ml-calendars.html[scheduled events], each
+This API accepts a list of {ml-docs}/ml-calendars.html[scheduled events], each
 of which must have a start time, end time, and description.
 
 [[ml-post-calendar-event-path-parms]]
diff --git a/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
index 09a65f4300dec..f543c06bd8cb0 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
@@ -24,7 +24,7 @@ Instantiates a calendar.
 ==== {api-description-title}
 
 For more information, see
-{stack-ov}/ml-calendars.html[Calendars and scheduled events].
+{ml-docs}/ml-calendars.html[Calendars and scheduled events].
 
 [[ml-put-calendar-path-parms]]
 ==== {api-path-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
index 3ff63bf927757..86245d84dbb28 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
@@ -23,7 +23,7 @@ Instantiates a filter.
 [[ml-put-filter-desc]]
 ==== {api-description-title}
 
-A {stack-ov}/ml-rules.html[filter] contains a list of strings. 
+A {ml-docs}/ml-rules.html[filter] contains a list of strings. 
 It can be used by one or more jobs. Specifically, filters are referenced in 
 the `custom_rules` property of detector configuration objects. 
 
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 5003f8c4f5403..76b1671fed595 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -2,7 +2,7 @@ tag::aggregations[]
 If set, the {dfeed} performs aggregation searches. Support for aggregations is
 limited and should only be used with low cardinality data. For more information,
 see
-{stack-ov}/ml-configuring-aggregation.html[Aggregating data for faster performance].
+{ml-docs}/ml-configuring-aggregation.html[Aggregating data for faster performance].
 end::aggregations[]
 
 tag::allow-lazy-open[]
@@ -203,7 +203,7 @@ at the same time as `categorization_filters`. The categorization analyzer
 specifies how the `categorization_field` is interpreted by the categorization
 process. The syntax is very similar to that used to define the `analyzer` in the
 <<indices-analyze,Analyze endpoint>>. For more information, see
-{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
+{ml-docs}/ml-configuring-categories.html[Categorizing log messages].
 +
 --
 The `categorization_analyzer` field can be specified either as a string or as an
@@ -234,7 +234,7 @@ set this value to `0`, no examples are stored.
 --
 NOTE: The `categorization_examples_limit` only applies to analysis that uses
 categorization. For more information, see
-{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
+{ml-docs}/ml-configuring-categories.html[Categorizing log messages].
 
 --
 end::categorization-examples-limit[]
@@ -244,7 +244,7 @@ If this property is specified, the values of the specified field will be
 categorized. The resulting categories must be used in a detector by setting
 `by_field_name`, `over_field_name`, or `partition_field_name` to the keyword
 `mlcategory`. For more information, see
-{stack-ov}/ml-configuring-categories.html[Categorizing log messages].
+{ml-docs}/ml-configuring-categories.html[Categorizing log messages].
 end::categorization-field-name[]
 
 tag::categorization-filters[]
@@ -254,7 +254,7 @@ are used to filter out matching sequences from the categorization field values.
 You can use this functionality to fine tune the categorization by excluding 
 sequences from consideration when categories are defined. For example, you can 
 exclude SQL statements that appear in your log files. For more information, see 
-{stack-ov}/ml-configuring-categories.html[Categorizing log messages]. This
+{ml-docs}/ml-configuring-categories.html[Categorizing log messages]. This
 property cannot be used at the same time as `categorization_analyzer`. If you
 only want to define simple regular expression filters that are applied prior to 
 tokenization, setting this property is the easiest method. If you also want to 
@@ -299,7 +299,7 @@ tag::custom-rules[]
 An array of custom rule objects, which enable you to customize the way detectors
 operate. For example, a rule may dictate to the detector conditions under which
 results should be skipped. For more examples, see 
-{stack-ov}/ml-configuring-detector-custom-rules.html[Configuring detector custom rules].
+{ml-docs}/ml-configuring-detector-custom-rules.html[Customizing detectors with custom rules].
 A custom rule has the following properties:
 +
 --
@@ -363,7 +363,7 @@ end::custom-rules[]
 tag::custom-settings[]
 Advanced configuration option. Contains custom meta data about the job. For
 example, it can contain custom URL information as shown in
-{stack-ov}/ml-configuring-url.html[Adding custom URLs to {ml} results].
+{ml-docs}/ml-configuring-url.html[Adding custom URLs to {ml} results].
 end::custom-settings[]
 
 tag::data-description[]
@@ -503,7 +503,7 @@ an effort to determine whether any data has subsequently been added to the index
 If missing data is found, it is a good indication that the `query_delay` option
 is set too low and the data is being indexed after the {dfeed} has passed that
 moment in time. See 
-{stack-ov}/ml-delayed-data-detection.html[Working with delayed data].
+{ml-docs}/ml-delayed-data-detection.html[Working with delayed data].
 
 This check runs only on real-time {dfeeds}.
 
@@ -692,7 +692,7 @@ end::from[]
 tag::function[]
 The analysis function that is used. For example, `count`, `rare`, `mean`, `min`, 
 `max`, and `sum`. For more information, see
-{stack-ov}/ml-functions.html[Function reference].
+{ml-docs}/ml-functions.html[Function reference].
 end::function[]
 
 tag::gamma[]
@@ -979,7 +979,7 @@ tag::over-field-name[]
 The field used to split the data. In particular, this property is used for 
 analyzing the splits with respect to the history of all splits. It is used for 
 finding unusual values in the population of all splits. For more information,
-see {stack-ov}/ml-configuring-pop.html[Performing population analysis].
+see {ml-docs}/ml-configuring-pop.html[Performing population analysis].
 end::over-field-name[]
 
 tag::outlier-fraction[]
@@ -1049,7 +1049,7 @@ tag::script-fields[]
 Specifies scripts that evaluate custom expressions and returns script fields to
 the {dfeed}. The detector configuration objects in a job can contain functions
 that use these script fields. For more information, see
-{stack-ov}/ml-configuring-transform.html[Transforming data with script fields]
+{ml-docs}/ml-configuring-transform.html[Transforming data with script fields]
 and <<request-body-search-script-fields,Script fields>>.
 end::script-fields[]
 
diff --git a/docs/reference/modules/node.asciidoc b/docs/reference/modules/node.asciidoc
index 35cfd89b80dc2..a41b98b7b2078 100644
--- a/docs/reference/modules/node.asciidoc
+++ b/docs/reference/modules/node.asciidoc
@@ -46,7 +46,7 @@ A node that has `xpack.ml.enabled` and `node.ml` set to `true`, which is the
 default behavior in the {es} {default-dist}. If you want to use {ml-features},
 there must be at least one {ml} node in your cluster. For more information about
 {ml-features}, see
-{stack-ov}/xpack-ml.html[Machine learning in the {stack}].
+{ml-docs}/xpack-ml.html[Machine learning in the {stack}].
 +
 IMPORTANT: If you use the {oss-dist}, do not set `node.ml`. Otherwise, the node
 fails to start.
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 57c7bf93092a7..8580705623146 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -631,19 +631,19 @@ more details.
 === Calendar resources
 
 See <<ml-get-calendar>> and
-{stack-ov}/ml-calendars.html[Calendars and scheduled events].
+{ml-docs}/ml-calendars.html[Calendars and scheduled events].
 
 [role="exclude",id="ml-filter-resource"]
 === Filter resources
 
 See <<ml-get-filter>> and
-{stack-ov}/ml-rules.html[Machine learning custom rules].
+{ml-docs}/ml-rules.html[Machine learning custom rules].
 
 [role="exclude",id="ml-event-resource"]
 === Scheduled event resources
 
 See <<ml-get-calendar-event>> and
-{stack-ov}/ml-calendars.html[Calendars and scheduled events].
+{ml-docs}/ml-calendars.html[Calendars and scheduled events].
 
 [role="exclude",id="index-apis"]
 === Index APIs
diff --git a/docs/reference/setup/restart-cluster.asciidoc b/docs/reference/setup/restart-cluster.asciidoc
index 1f56e7ffa9c08..58402758a72d8 100644
--- a/docs/reference/setup/restart-cluster.asciidoc
+++ b/docs/reference/setup/restart-cluster.asciidoc
@@ -55,7 +55,7 @@ was automatically saved. This option avoids the overhead of managing active jobs
 during the shutdown and is faster than explicitly stopping {dfeeds} and closing 
 jobs.
 
-* {stack-ov}/stopping-ml.html[Stop all {dfeeds} and close all jobs]. This option
+* {ml-docs}/stopping-ml.html[Stop all {dfeeds} and close all jobs]. This option
 saves the model state at the time of closure. When you reopen the jobs after the
 cluster restart, they use the exact same model. However, saving the latest model 
 state takes longer than using upgrade mode, especially if you have a lot of jobs 
diff --git a/docs/reference/upgrade/close-ml.asciidoc b/docs/reference/upgrade/close-ml.asciidoc
index 92be1e4106d87..09c6ee53b6930 100644
--- a/docs/reference/upgrade/close-ml.asciidoc
+++ b/docs/reference/upgrade/close-ml.asciidoc
@@ -34,7 +34,7 @@ state that was automatically saved. This option avoids the overhead of managing
 active jobs during the upgrade and is faster than explicitly stopping {dfeeds}
 and closing jobs.
 
-* {stack-ov}/stopping-ml.html[Stop all {dfeeds} and close all jobs]. This option
+* {ml-docs}/stopping-ml.html[Stop all {dfeeds} and close all jobs]. This option
 saves the model state at the time of closure. When you reopen the jobs after the
 upgrade, they use the exact same model. However, saving the latest model state
 takes longer than using upgrade mode, especially if you have a lot of jobs or
diff --git a/docs/reference/upgrade/reindex_upgrade.asciidoc b/docs/reference/upgrade/reindex_upgrade.asciidoc
index 151506797f52d..7f576bd42700e 100644
--- a/docs/reference/upgrade/reindex_upgrade.asciidoc
+++ b/docs/reference/upgrade/reindex_upgrade.asciidoc
@@ -62,7 +62,7 @@ If you use {ml-features} and your {ml} indices were created before
 {prev-major-version}, you must temporarily halt the tasks associated with your
 {ml} jobs and {dfeeds} and prevent new jobs from opening during the reindex. Use
 the <<ml-set-upgrade-mode,set upgrade mode API>> or
-{stack-ov}/stopping-ml.html[stop all {dfeeds} and close all {ml} jobs].
+{ml-docs}/stopping-ml.html[stop all {dfeeds} and close all {ml} jobs].
 
 If you use {es} {security-features}, before you reindex `.security*` internal
 indices it is a good idea to create a temporary superuser account in the `file`
@@ -121,7 +121,7 @@ from a 6.6 or later cluster, it is a good idea to temporarily halt the tasks
 associated with your {ml} jobs and {dfeeds} to prevent inconsistencies between
 different {ml} indices that are reindexed at slightly different times. Use the
 <<ml-set-upgrade-mode,set upgrade mode API>> or 
-{stack-ov}/stopping-ml.html[stop all {dfeeds} and close all {ml} jobs].
+{ml-docs}/stopping-ml.html[stop all {dfeeds} and close all {ml} jobs].
 endif::include-xpack[]
 
 =============================================

From 87345557de5430b819821f172b2cd20a05192a4e Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Thu, 19 Dec 2019 17:50:14 -0500
Subject: [PATCH 285/686] Handle renaming the README (#50404)

We renamed README.textile to README.asciidoc but a bunch of tests and
the package build itself still pointed at the old name. This switches
them the new name.
---
 distribution/archives/build.gradle                              | 2 +-
 qa/os/bats/utils/packages.bash                                  | 2 +-
 qa/os/bats/utils/tar.bash                                       | 2 +-
 .../test/java/org/elasticsearch/packaging/util/Archives.java    | 2 +-
 .../src/test/java/org/elasticsearch/packaging/util/Docker.java  | 2 +-
 .../test/java/org/elasticsearch/packaging/util/Packages.java    | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/distribution/archives/build.gradle b/distribution/archives/build.gradle
index 0c9bbc2063839..022453f945e6a 100644
--- a/distribution/archives/build.gradle
+++ b/distribution/archives/build.gradle
@@ -77,7 +77,7 @@ CopySpec archiveFiles(CopySpec modulesFiles, String distributionType, String pla
         }
       }
       from(rootProject.projectDir) {
-        include 'README.textile'
+        include 'README.asciidoc'
       }
       from(rootProject.file('licenses')) {
         include oss ? 'APACHE-LICENSE-2.0.txt' : 'ELASTIC-LICENSE.txt'
diff --git a/qa/os/bats/utils/packages.bash b/qa/os/bats/utils/packages.bash
index f0c6c963fed74..87b2943a8757b 100644
--- a/qa/os/bats/utils/packages.bash
+++ b/qa/os/bats/utils/packages.bash
@@ -136,7 +136,7 @@ verify_package_installation() {
     assert_file "$ESPLUGINS" d root root 755
     assert_file "$ESMODULES" d root root 755
     assert_file "$ESHOME/NOTICE.txt" f root root 644
-    assert_file "$ESHOME/README.textile" f root root 644
+    assert_file "$ESHOME/README.asciidoc" f root root 644
 
     if is_dpkg; then
         # Env file
diff --git a/qa/os/bats/utils/tar.bash b/qa/os/bats/utils/tar.bash
index 142215a703682..415e79cac3802 100644
--- a/qa/os/bats/utils/tar.bash
+++ b/qa/os/bats/utils/tar.bash
@@ -105,6 +105,6 @@ verify_archive_installation() {
     assert_file "$ESHOME/logs" d elasticsearch elasticsearch 755
     assert_file "$ESHOME/NOTICE.txt" f elasticsearch elasticsearch 644
     assert_file "$ESHOME/LICENSE.txt" f elasticsearch elasticsearch 644
-    assert_file "$ESHOME/README.textile" f elasticsearch elasticsearch 644
+    assert_file "$ESHOME/README.asciidoc" f elasticsearch elasticsearch 644
     assert_file_not_exist "$ESCONFIG/elasticsearch.keystore"
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
index 28234bd118701..83ff3fec8fa26 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Archives.java
@@ -204,7 +204,7 @@ private static void verifyOssInstallation(Installation es, Distribution distribu
         Stream.of(
             "NOTICE.txt",
             "LICENSE.txt",
-            "README.textile"
+            "README.asciidoc"
         ).forEach(doc -> assertThat(es.home.resolve(doc), file(File, owner, owner, p644)));
     }
 
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
index 313060cdd3989..ef3382cd86eff 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
@@ -445,7 +445,7 @@ private static void verifyOssInstallation(Installation es) {
             "elasticsearch-shard"
         ).forEach(executable -> assertPermissionsAndOwnership(es.bin(executable), p755));
 
-        Stream.of("LICENSE.txt", "NOTICE.txt", "README.textile").forEach(doc -> assertPermissionsAndOwnership(es.home.resolve(doc), p644));
+        Stream.of("LICENSE.txt", "NOTICE.txt", "README.asciidoc").forEach(doc -> assertPermissionsAndOwnership(es.home.resolve(doc), p644));
 
         // These are installed to help users who are working with certificates.
         Stream.of("zip", "unzip").forEach(cliPackage -> {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
index 19521e6b919d0..036358696d21d 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
@@ -207,7 +207,7 @@ private static void verifyOssInstallation(Installation es, Distribution distribu
 
         Stream.of(
             "NOTICE.txt",
-            "README.textile"
+            "README.asciidoc"
         ).forEach(doc -> assertThat(es.home.resolve(doc), file(File, "root", "root", p644)));
 
         assertThat(es.envFile, file(File, "root", "elasticsearch", p660));

From b6fdfb750fb39df8de3db0d46c5539245cf26daf Mon Sep 17 00:00:00 2001
From: Stuart Tettemer <stu@elastic.co>
Date: Thu, 19 Dec 2019 16:16:57 -0700
Subject: [PATCH 286/686] [DOCS] Deterministic scripted queries are cached
 (#50408)

Refs: #49321
---
 docs/reference/modules/indices/request_cache.asciidoc | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/reference/modules/indices/request_cache.asciidoc b/docs/reference/modules/indices/request_cache.asciidoc
index 11c8180eb4739..45d46e3a7714d 100644
--- a/docs/reference/modules/indices/request_cache.asciidoc
+++ b/docs/reference/modules/indices/request_cache.asciidoc
@@ -21,6 +21,9 @@ but it will cache `hits.total`,  <<search-aggregations,aggregations>>, and
 <<search-suggesters,suggestions>>.
 
 Most queries that use `now` (see <<date-math>>) cannot be cached.
+
+Scripted queries that use the API calls which are non-deterministic, such as
+`Math.random()` or `new Date()` are not cached.
 ===================================
 
 [float]
@@ -95,10 +98,6 @@ GET /my_index/_search?request_cache=true
 -----------------------------
 // TEST[continued]
 
-IMPORTANT: If your query uses a script whose result is not deterministic (e.g.
-it uses a random function or references the current time) you should set the
-`request_cache` flag to `false` to disable caching for that request.
-
 Requests where `size` is greater than 0 will not be cached even if the request cache is
 enabled in the index settings. To cache these requests you will need to use the
 query-string parameter detailed here.

From 1a21b5b050905f1e930ee77932f1a11067386500 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Thu, 19 Dec 2019 18:55:58 -0500
Subject: [PATCH 287/686] Docs: Add an example to CONTRIBUTING.md (#50398)

Adds an example of accessing Elasticsearch after building it from source
for the first time to CONTRIBUTING.md. I'm sure how to do it is
intuitive to some folks but I had to read three two build.gradle file to
find the password and I'd like to save other new folks the trouble.
---
 CONTRIBUTING.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 57021e3be565d..dd3bbfb1bf5e0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -119,6 +119,10 @@ For IntelliJ, the minimum version that we support is [IntelliJ 2017.2][intellij]
 
     ./gradlew :run
 
+You can access Elasticsearch with:
+
+    curl -u elastic:password localhost:9200
+
 ### Configuring IDEs And Running Tests
 
 Eclipse users can automatically configure their IDE: `./gradlew eclipse`

From 592bb71233cfef001ab7e6226f9073c5b1d581e0 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Thu, 19 Dec 2019 23:49:15 -0500
Subject: [PATCH 288/686] Mute testHistoryIsWrittenWithSuccess

Tracked at #50353
---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 7192febb6b11e..347e1fac4f96a 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1005,6 +1005,7 @@ public void testILMRolloverOnManuallyRolledIndex() throws Exception {
        assertBusy(() -> assertTrue(indexExists(thirdIndex)));
    }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithSuccess() throws Exception {
         String index = "index";
 

From 46179ebfaa736e32e2a07d6f3e0252f68b4f812a Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 20 Dec 2019 00:34:57 -0500
Subject: [PATCH 289/686] Mute testHistoryIsWrittenWithDeletion

Tracked at #50353
---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 347e1fac4f96a..3392ae4954353 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1077,6 +1077,7 @@ public void testHistoryIsWrittenWithFailure() throws Exception {
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", false, "ERROR"), 30, TimeUnit.SECONDS);
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithDeletion() throws Exception {
         String index = "index";
 

From f69fd9697ce736e06c2539dada39e44b4947f057 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 20 Dec 2019 00:39:53 -0500
Subject: [PATCH 290/686] Use peer recovery retention leases for indices
 without soft-deletes (#50351)

Today, the replica allocator uses peer recovery retention leases to
select the best-matched copies when allocating replicas of indices with
soft-deletes. We can employ this mechanism for indices without
soft-deletes because the retaining sequence number of a PRRL is the
persisted global checkpoint (plus one) of that copy. If the primary and
replica have the same retaining sequence number, then we should be able
to perform a noop recovery. The reason is that we must be retaining
translog up to the local checkpoint of the safe commit, which is at most
the global checkpoint of either copy). The only limitation is that we
might not cancel ongoing file-based recoveries with PRRLs for noop
recoveries. We can't make the translog retention policy comply with
PRRLs. We also have this problem with soft-deletes if a PRRL is about to
expire.

Relates #45136
Relates #46959
---
 .../upgrades/FullClusterRestartIT.java        |  4 +-
 .../elasticsearch/upgrades/RecoveryIT.java    |  5 +-
 .../org/elasticsearch/index/IndexService.java |  4 +-
 .../index/seqno/ReplicationTracker.java       | 17 +++--
 .../elasticsearch/index/shard/IndexShard.java |  9 ++-
 .../recovery/RecoverySourceHandler.java       | 62 ++++++++-----------
 .../gateway/ReplicaShardAllocatorIT.java      |  8 +--
 .../index/seqno/RetentionLeaseIT.java         | 30 ---------
 .../shard/IndexShardRetentionLeaseTests.java  |  3 +-
 .../recovery/RecoverySourceHandlerTests.java  |  9 +--
 .../test/rest/ESRestTestCase.java             | 18 +++++-
 11 files changed, 69 insertions(+), 100 deletions(-)

diff --git a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
index 2d367261f8895..67d3007e9af16 100644
--- a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
+++ b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
@@ -1278,7 +1278,7 @@ public void testOperationBasedRecovery() throws Exception {
                 }
             }
             flush(index, true);
-            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, false);
             // less than 10% of the committed docs (see IndexSetting#FILE_BASED_RECOVERY_THRESHOLD_SETTING).
             int uncommittedDocs = randomIntBetween(0, (int) (committedDocs * 0.1));
             for (int i = 0; i < uncommittedDocs; i++) {
@@ -1288,6 +1288,7 @@ public void testOperationBasedRecovery() throws Exception {
         } else {
             ensureGreen(index);
             assertNoFileBasedRecovery(index, n -> true);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, true);
         }
     }
 
@@ -1312,6 +1313,7 @@ public void testTurnOffTranslogRetentionAfterUpgraded() throws Exception {
             ensureGreen(index);
             flush(index, true);
             assertEmptyTranslog(index);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, true);
         }
     }
 }
diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index cd4a07aab3ec0..7bd52d266914d 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -695,7 +695,7 @@ public void testOperationBasedRecovery() throws Exception {
             ensureGreen(index);
             indexDocs(index, 0, randomIntBetween(100, 200));
             flush(index, randomBoolean());
-            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, false);
             // uncommitted docs must be less than 10% of committed docs (see IndexSetting#FILE_BASED_RECOVERY_THRESHOLD_SETTING).
             indexDocs(index, randomIntBetween(0, 100), randomIntBetween(0, 3));
         } else {
@@ -705,6 +705,9 @@ public void testOperationBasedRecovery() throws Exception {
                 || nodeName.startsWith(CLUSTER_NAME + "-0")
                 || (nodeName.startsWith(CLUSTER_NAME + "-1") && Booleans.parseBoolean(System.getProperty("tests.first_round")) == false));
             indexDocs(index, randomIntBetween(0, 100), randomIntBetween(0, 3));
+            if (CLUSTER_TYPE == ClusterType.UPGRADED) {
+                ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, true);
+            }
         }
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/IndexService.java b/server/src/main/java/org/elasticsearch/index/IndexService.java
index 481ad3f5a7f6f..15fd0de2760a6 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexService.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexService.java
@@ -820,9 +820,7 @@ private void maybeSyncGlobalCheckpoints() {
     }
 
     private void syncRetentionLeases() {
-        if (indexSettings.isSoftDeleteEnabled()) {
-            sync(IndexShard::syncRetentionLeases, "retention lease");
-        }
+        sync(IndexShard::syncRetentionLeases, "retention lease");
     }
 
     private void sync(final Consumer<IndexShard> sync, final String source) {
diff --git a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
index 8c42784b88f82..bfe89a65d89df 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
@@ -895,10 +895,12 @@ public ReplicationTracker(
         this.pendingInSync = new HashSet<>();
         this.routingTable = null;
         this.replicationGroup = null;
-        this.hasAllPeerRecoveryRetentionLeases = indexSettings.isSoftDeleteEnabled() &&
-            (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_6_0) ||
-            (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_4_0) &&
-             indexSettings.getIndexMetaData().getState() == IndexMetaData.State.OPEN));
+        this.hasAllPeerRecoveryRetentionLeases = indexSettings.getIndexVersionCreated().onOrAfter(Version.V_8_0_0)
+            || (indexSettings.isSoftDeleteEnabled() &&
+               (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_6_0) ||
+               (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_4_0) &&
+                indexSettings.getIndexMetaData().getState() == IndexMetaData.State.OPEN)));
+
         this.fileBasedRecoveryThreshold = IndexSettings.FILE_BASED_RECOVERY_THRESHOLD_SETTING.get(indexSettings.getSettings());
         this.safeCommitInfoSupplier = safeCommitInfoSupplier;
         assert Version.V_EMPTY.equals(indexSettings.getIndexVersionCreated()) == false;
@@ -994,10 +996,7 @@ public synchronized void activatePrimaryMode(final long localCheckpoint) {
         updateLocalCheckpoint(shardAllocationId, checkpoints.get(shardAllocationId), localCheckpoint);
         updateGlobalCheckpointOnPrimary();
 
-        if (indexSettings.isSoftDeleteEnabled()) {
-            addPeerRecoveryRetentionLeaseForSolePrimary();
-        }
-
+        addPeerRecoveryRetentionLeaseForSolePrimary();
         assert invariant();
     }
 
@@ -1358,7 +1357,7 @@ public synchronized boolean hasAllPeerRecoveryRetentionLeases() {
      * prior to {@link Version#V_7_4_0} that does not create peer-recovery retention leases.
      */
     public synchronized void createMissingPeerRecoveryRetentionLeases(ActionListener<Void> listener) {
-        if (indexSettings().isSoftDeleteEnabled() && hasAllPeerRecoveryRetentionLeases == false) {
+        if (hasAllPeerRecoveryRetentionLeases == false) {
             final List<ShardRouting> shardRoutings = routingTable.assignedShards();
             final GroupedActionListener<ReplicationResponse> groupedActionListener = new GroupedActionListener<>(ActionListener.wrap(vs -> {
                 setHasAllPeerRecoveryRetentionLeases();
diff --git a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
index 059961e1e5897..5415a433d8670 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
@@ -1892,10 +1892,10 @@ boolean shouldRollTranslogGeneration() {
     public void onSettingsChanged() {
         Engine engineOrNull = getEngineOrNull();
         if (engineOrNull != null) {
-            final boolean useRetentionLeasesInPeerRecovery = this.useRetentionLeasesInPeerRecovery;
+            final boolean disableTranslogRetention = indexSettings.isSoftDeleteEnabled() && useRetentionLeasesInPeerRecovery;
             engineOrNull.onSettingsChanged(
-                useRetentionLeasesInPeerRecovery ? TimeValue.MINUS_ONE : indexSettings.getTranslogRetentionAge(),
-                useRetentionLeasesInPeerRecovery ? new ByteSizeValue(-1) : indexSettings.getTranslogRetentionSize(),
+                disableTranslogRetention ? TimeValue.MINUS_ONE : indexSettings.getTranslogRetentionAge(),
+                disableTranslogRetention ? new ByteSizeValue(-1) : indexSettings.getTranslogRetentionSize(),
                 indexSettings.getSoftDeleteRetentionOperations()
             );
         }
@@ -2224,7 +2224,6 @@ public boolean assertRetentionLeasesPersisted() throws IOException {
     public void syncRetentionLeases() {
         assert assertPrimaryMode();
         verifyNotClosed();
-        ensureSoftDeletesEnabled("retention leases");
         replicationTracker.renewPeerRecoveryRetentionLeases();
         final Tuple<Boolean, RetentionLeases> retentionLeases = getRetentionLeases(true);
         if (retentionLeases.v1()) {
@@ -2619,7 +2618,7 @@ public RetentionLease addPeerRecoveryRetentionLease(String nodeId, long globalCh
                                                         ActionListener<ReplicationResponse> listener) {
         assert assertPrimaryMode();
         // only needed for BWC reasons involving rolling upgrades from versions that do not support PRRLs:
-        assert indexSettings.getIndexVersionCreated().before(Version.V_7_4_0);
+        assert indexSettings.getIndexVersionCreated().before(Version.V_7_4_0) || indexSettings.isSoftDeleteEnabled() == false;
         return replicationTracker.addPeerRecoveryRetentionLease(nodeId, globalCheckpoint, listener);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java b/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
index 285edc329be06..07db659299e7c 100644
--- a/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
+++ b/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
@@ -165,12 +165,12 @@ public void recoverToTarget(ActionListener<RecoveryResponse> listener) {
                     throw new DelayRecoveryException("source node does not have the shard listed in its state as allocated on the node");
                 }
                 assert targetShardRouting.initializing() : "expected recovery target to be initializing but was " + targetShardRouting;
-                retentionLeaseRef.set(softDeletesEnabled ? shard.getRetentionLeases().get(
-                    ReplicationTracker.getPeerRecoveryRetentionLeaseId(targetShardRouting)) : null);
+                retentionLeaseRef.set(
+                    shard.getRetentionLeases().get(ReplicationTracker.getPeerRecoveryRetentionLeaseId(targetShardRouting)));
             }, shardId + " validating recovery target ["+ request.targetAllocationId() + "] registered ",
                 shard, cancellableThreads, logger);
             final Engine.HistorySource historySource;
-            if (shard.useRetentionLeasesInPeerRecovery() || retentionLeaseRef.get() != null) {
+            if (softDeletesEnabled && (shard.useRetentionLeasesInPeerRecovery() || retentionLeaseRef.get() != null)) {
                 historySource = Engine.HistorySource.INDEX;
             } else {
                 historySource = Engine.HistorySource.TRANSLOG;
@@ -190,7 +190,7 @@ && isTargetSameHistory()
             // Also it's pretty cheap when soft deletes are enabled, and it'd be a disaster if we tried a sequence-number-based recovery
             // without having a complete history.
 
-            if (isSequenceNumberBasedRecovery && retentionLeaseRef.get() != null) {
+            if (isSequenceNumberBasedRecovery && softDeletesEnabled && retentionLeaseRef.get() != null) {
                 // all the history we need is retained by an existing retention lease, so we do not need a separate retention lock
                 retentionLock.close();
                 logger.trace("history is retained by {}", retentionLeaseRef.get());
@@ -209,7 +209,7 @@ && isTargetSameHistory()
             if (isSequenceNumberBasedRecovery) {
                 logger.trace("performing sequence numbers based recovery. starting at [{}]", request.startingSeqNo());
                 startingSeqNo = request.startingSeqNo();
-                if (softDeletesEnabled && retentionLeaseRef.get() == null) {
+                if (retentionLeaseRef.get() == null) {
                     createRetentionLease(startingSeqNo, ActionListener.map(sendFileStep, ignored -> SendFileResult.EMPTY));
                 } else {
                     sendFileStep.onResponse(SendFileResult.EMPTY);
@@ -251,36 +251,24 @@ && isTargetSameHistory()
                     });
 
                     final StepListener<ReplicationResponse> deleteRetentionLeaseStep = new StepListener<>();
-                    if (softDeletesEnabled) {
-                        runUnderPrimaryPermit(() -> {
-                                try {
-                                    // If the target previously had a copy of this shard then a file-based recovery might move its global
-                                    // checkpoint backwards. We must therefore remove any existing retention lease so that we can create a
-                                    // new one later on in the recovery.
-                                    shard.removePeerRecoveryRetentionLease(request.targetNode().getId(),
-                                        new ThreadedActionListener<>(logger, shard.getThreadPool(), ThreadPool.Names.GENERIC,
-                                            deleteRetentionLeaseStep, false));
-                                } catch (RetentionLeaseNotFoundException e) {
-                                    logger.debug("no peer-recovery retention lease for " + request.targetAllocationId());
-                                    deleteRetentionLeaseStep.onResponse(null);
-                                }
-                            }, shardId + " removing retention leaes for [" + request.targetAllocationId() + "]",
-                            shard, cancellableThreads, logger);
-                    } else {
-                        deleteRetentionLeaseStep.onResponse(null);
-                    }
+                    runUnderPrimaryPermit(() -> {
+                            try {
+                                // If the target previously had a copy of this shard then a file-based recovery might move its global
+                                // checkpoint backwards. We must therefore remove any existing retention lease so that we can create a
+                                // new one later on in the recovery.
+                                shard.removePeerRecoveryRetentionLease(request.targetNode().getId(),
+                                    new ThreadedActionListener<>(logger, shard.getThreadPool(), ThreadPool.Names.GENERIC,
+                                        deleteRetentionLeaseStep, false));
+                            } catch (RetentionLeaseNotFoundException e) {
+                                logger.debug("no peer-recovery retention lease for " + request.targetAllocationId());
+                                deleteRetentionLeaseStep.onResponse(null);
+                            }
+                        }, shardId + " removing retention lease for [" + request.targetAllocationId() + "]",
+                        shard, cancellableThreads, logger);
 
                     deleteRetentionLeaseStep.whenComplete(ignored -> {
                         assert Transports.assertNotTransportThread(RecoverySourceHandler.this + "[phase1]");
-
-                        final Consumer<ActionListener<RetentionLease>> createRetentionLeaseAsync;
-                        if (softDeletesEnabled) {
-                            createRetentionLeaseAsync = l -> createRetentionLease(startingSeqNo, l);
-                        } else {
-                            createRetentionLeaseAsync = l -> l.onResponse(null);
-                        }
-
-                        phase1(safeCommitRef.getIndexCommit(), createRetentionLeaseAsync, () -> estimateNumOps, sendFileStep);
+                        phase1(safeCommitRef.getIndexCommit(), startingSeqNo, () -> estimateNumOps, sendFileStep);
                     }, onFailure);
 
                 } catch (final Exception e) {
@@ -451,8 +439,7 @@ static final class SendFileResult {
      * segments that are missing. Only segments that have the same size and
      * checksum can be reused
      */
-    void phase1(IndexCommit snapshot, Consumer<ActionListener<RetentionLease>> createRetentionLease,
-                IntSupplier translogOps, ActionListener<SendFileResult> listener) {
+    void phase1(IndexCommit snapshot, long startingSeqNo, IntSupplier translogOps, ActionListener<SendFileResult> listener) {
         cancellableThreads.checkForCancel();
         final Store store = shard.store();
         try {
@@ -526,7 +513,7 @@ void phase1(IndexCommit snapshot, Consumer<ActionListener<RetentionLease>> creat
                 sendFileInfoStep.whenComplete(r ->
                     sendFiles(store, phase1Files.toArray(new StoreFileMetaData[0]), translogOps, sendFilesStep), listener::onFailure);
 
-                sendFilesStep.whenComplete(r -> createRetentionLease.accept(createRetentionLeaseStep), listener::onFailure);
+                sendFilesStep.whenComplete(r -> createRetentionLease(startingSeqNo, createRetentionLeaseStep), listener::onFailure);
 
                 createRetentionLeaseStep.whenComplete(retentionLease ->
                     {
@@ -554,7 +541,7 @@ void phase1(IndexCommit snapshot, Consumer<ActionListener<RetentionLease>> creat
 
                 // but we must still create a retention lease
                 final StepListener<RetentionLease> createRetentionLeaseStep = new StepListener<>();
-                createRetentionLease.accept(createRetentionLeaseStep);
+                createRetentionLease(startingSeqNo, createRetentionLeaseStep);
                 createRetentionLeaseStep.whenComplete(retentionLease -> {
                     final TimeValue took = stopWatch.totalTime();
                     logger.trace("recovery [phase1]: took [{}]", took);
@@ -590,7 +577,8 @@ private void createRetentionLease(final long startingSeqNo, ActionListener<Reten
                     // it's possible that the primary has no retention lease yet if we are doing a rolling upgrade from a version before
                     // 7.4, and in that case we just create a lease using the local checkpoint of the safe commit which we're using for
                     // recovery as a conservative estimate for the global checkpoint.
-                    assert shard.indexSettings().getIndexVersionCreated().before(Version.V_7_4_0);
+                    assert shard.indexSettings().getIndexVersionCreated().before(Version.V_7_4_0)
+                        || shard.indexSettings().isSoftDeleteEnabled() == false;
                     final StepListener<ReplicationResponse> addRetentionLeaseStep = new StepListener<>();
                     final long estimatedGlobalCheckpoint = startingSeqNo - 1;
                     final RetentionLease newLease = shard.addPeerRecoveryRetentionLease(request.targetNode().getId(),
diff --git a/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java b/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
index 35064b0063676..9868adfe3b86b 100644
--- a/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
@@ -78,7 +78,7 @@ public void testPreferCopyCanPerformNoopRecovery() throws Exception {
         assertAcked(
             client().admin().indices().prepareCreate(indexName)
                 .setSettings(Settings.builder()
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
+                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1)
                     .put(IndexSettings.FILE_BASED_RECOVERY_THRESHOLD_SETTING.getKey(), 1.0f)
@@ -211,7 +211,7 @@ public void testFullClusterRestartPerformNoopRecovery() throws Exception {
         assertAcked(
             client().admin().indices().prepareCreate(indexName)
                 .setSettings(Settings.builder()
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
+                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                     .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(), randomIntBetween(10, 100) + "kb")
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, numOfReplicas)
@@ -248,7 +248,7 @@ public void testPreferCopyWithHighestMatchingOperations() throws Exception {
         assertAcked(
             client().admin().indices().prepareCreate(indexName)
                 .setSettings(Settings.builder()
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
+                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                     .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(), randomIntBetween(10, 100) + "kb")
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1)
@@ -329,7 +329,7 @@ public void testPeerRecoveryForClosedIndices() throws Exception {
         createIndex(indexName, Settings.builder()
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
+            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
             .put(IndexService.GLOBAL_CHECKPOINT_SYNC_INTERVAL_SETTING.getKey(), "100ms")
             .put(IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(), "100ms")
             .build());
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseIT.java b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseIT.java
index 831422f8dad86..f081f87eaa365 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseIT.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/RetentionLeaseIT.java
@@ -336,36 +336,6 @@ public void testBackgroundRetentionLeaseSync() throws Exception {
         }
     }
 
-    public void testRetentionLeasesBackgroundSyncWithSoftDeletesDisabled() throws Exception {
-        final int numberOfReplicas = 2 - scaledRandomIntBetween(0, 2);
-        internalCluster().ensureAtLeastNumDataNodes(1 + numberOfReplicas);
-        TimeValue syncIntervalSetting = TimeValue.timeValueMillis(between(1, 100));
-        final Settings settings = Settings.builder()
-            .put("index.number_of_shards", 1)
-            .put("index.number_of_replicas", numberOfReplicas)
-            .put(IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(), syncIntervalSetting.getStringRep())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false)
-            .build();
-        createIndex("index", settings);
-        final String primaryShardNodeId = clusterService().state().routingTable().index("index").shard(0).primaryShard().currentNodeId();
-        final String primaryShardNodeName = clusterService().state().nodes().get(primaryShardNodeId).getName();
-        final MockTransportService primaryTransportService = (MockTransportService) internalCluster().getInstance(
-            TransportService.class, primaryShardNodeName);
-        final AtomicBoolean backgroundSyncRequestSent = new AtomicBoolean();
-        primaryTransportService.addSendBehavior((connection, requestId, action, request, options) -> {
-            if (action.startsWith(RetentionLeaseBackgroundSyncAction.ACTION_NAME)) {
-                backgroundSyncRequestSent.set(true);
-            }
-            connection.sendRequest(requestId, action, request, options);
-        });
-        final long start = System.nanoTime();
-        ensureGreen("index");
-        final long syncEnd = System.nanoTime();
-        // We sleep long enough for the retention leases background sync to be triggered
-        Thread.sleep(Math.max(0, randomIntBetween(2, 3) * syncIntervalSetting.millis() - TimeUnit.NANOSECONDS.toMillis(syncEnd - start)));
-        assertFalse("retention leases background sync must be a noop if soft deletes is disabled", backgroundSyncRequestSent.get());
-    }
-
     public void testRetentionLeasesSyncOnRecovery() throws Exception {
         final int numberOfReplicas = 2 - scaledRandomIntBetween(0, 2);
         internalCluster().ensureAtLeastNumDataNodes(1 + numberOfReplicas);
diff --git a/server/src/test/java/org/elasticsearch/index/shard/IndexShardRetentionLeaseTests.java b/server/src/test/java/org/elasticsearch/index/shard/IndexShardRetentionLeaseTests.java
index ed429bb680d7d..31bdfce261ad9 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/IndexShardRetentionLeaseTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/IndexShardRetentionLeaseTests.java
@@ -314,8 +314,7 @@ public void testRetentionLeasesActionsFailWithSoftDeletesDisabled() throws Excep
         assertThat(expectThrows(AssertionError.class, () -> shard.removeRetentionLease(
             randomAlphaOfLength(10), ActionListener.wrap(() -> {}))).getMessage(),
             equalTo("retention leases requires soft deletes but [index] does not have soft deletes enabled"));
-        assertThat(expectThrows(AssertionError.class, shard::syncRetentionLeases).getMessage(),
-            equalTo("retention leases requires soft deletes but [index] does not have soft deletes enabled"));
+        shard.syncRetentionLeases();
         closeShards(shard);
     }
 
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
index e57f5162a7a49..db9f52f942e63 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
@@ -64,7 +64,6 @@
 import org.elasticsearch.index.mapper.SeqNoFieldMapper;
 import org.elasticsearch.index.mapper.Uid;
 import org.elasticsearch.index.seqno.ReplicationTracker;
-import org.elasticsearch.index.seqno.RetentionLease;
 import org.elasticsearch.index.seqno.RetentionLeases;
 import org.elasticsearch.index.seqno.SeqNoStats;
 import org.elasticsearch.index.seqno.SequenceNumbers;
@@ -102,7 +101,6 @@
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.concurrent.atomic.AtomicLong;
-import java.util.function.Consumer;
 import java.util.function.IntSupplier;
 import java.util.zip.CRC32;
 
@@ -467,10 +465,9 @@ public void testThrowExceptionOnPrimaryRelocatedBeforePhase1Started() throws IOE
                 between(1, 8)) {
 
             @Override
-            void phase1(IndexCommit snapshot, Consumer<ActionListener<RetentionLease>> createRetentionLease,
-                        IntSupplier translogOps, ActionListener<SendFileResult> listener) {
+            void phase1(IndexCommit snapshot, long startingSeqNo, IntSupplier translogOps, ActionListener<SendFileResult> listener) {
                 phase1Called.set(true);
-                super.phase1(snapshot, createRetentionLease, translogOps, listener);
+                super.phase1(snapshot, startingSeqNo, translogOps, listener);
             }
 
             @Override
@@ -686,7 +683,7 @@ public void cleanFiles(int totalTranslogOps, long globalCheckpoint, Store.Metada
         try {
             final CountDownLatch latch = new CountDownLatch(1);
             handler.phase1(DirectoryReader.listCommits(dir).get(0),
-                l -> recoveryExecutor.execute(() -> l.onResponse(null)),
+                0,
                 () -> 0,
                 new LatchedActionListener<>(phase1Listener, latch));
             latch.await();
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index 73ca1dde99ca8..f10f444e918ed 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -52,6 +52,7 @@
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
 import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.index.seqno.ReplicationTracker;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.snapshots.SnapshotState;
 import org.elasticsearch.test.ESTestCase;
@@ -87,12 +88,15 @@
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Consumer;
 import java.util.function.Predicate;
+import java.util.stream.Collectors;
 
 import static java.util.Collections.sort;
 import static java.util.Collections.unmodifiableList;
 import static org.hamcrest.Matchers.anEmptyMap;
 import static org.hamcrest.Matchers.anyOf;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.everyItem;
+import static org.hamcrest.Matchers.in;
 
 /**
  * Superclass for tests that interact with an external test cluster using Elasticsearch's {@link RestClient}.
@@ -1128,7 +1132,7 @@ public void assertEmptyTranslog(String index) throws Exception {
      * Peer recovery retention leases are renewed and synced to replicas periodically (every 30 seconds). This ensures
      * that we have renewed every PRRL to the global checkpoint of the corresponding copy and properly synced to all copies.
      */
-    public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index) throws Exception {
+    public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index, boolean alwaysExists) throws Exception {
         assertBusy(() -> {
             Map<String, Object> stats = entityAsMap(client().performRequest(new Request("GET", index + "/_stats?level=shards")));
             @SuppressWarnings("unchecked") Map<String, List<Map<String, ?>>> shards =
@@ -1139,14 +1143,24 @@ public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index) thro
                     assertNotNull(globalCheckpoint);
                     @SuppressWarnings("unchecked") List<Map<String, ?>> retentionLeases =
                         (List<Map<String, ?>>) XContentMapValues.extractValue("retention_leases.leases", copy);
-                    if (retentionLeases == null) {
+                    if (alwaysExists == false && retentionLeases == null) {
                         continue;
                     }
+                    assertNotNull(retentionLeases);
                     for (Map<String, ?> retentionLease : retentionLeases) {
                         if (((String) retentionLease.get("id")).startsWith("peer_recovery/")) {
                             assertThat(retentionLease.get("retaining_seq_no"), equalTo(globalCheckpoint + 1));
                         }
                     }
+                    if (alwaysExists) {
+                        List<String> existingLeaseIds = retentionLeases.stream().map(lease -> (String) lease.get("id"))
+                            .collect(Collectors.toList());
+                        List<String> expectedLeaseIds = shard.stream()
+                            .map(shr -> (String) XContentMapValues.extractValue("routing.node", shr))
+                            .map(ReplicationTracker::getPeerRecoveryRetentionLeaseId)
+                            .collect(Collectors.toList());
+                        assertThat("not every active copy has established its PPRL", expectedLeaseIds, everyItem(in(existingLeaseIds)));
+                    }
                 }
             }
         }, 60, TimeUnit.SECONDS);

From 4bd1a35d4198a1fc029f65481739f23a6972187f Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 19 Dec 2019 22:41:19 -0800
Subject: [PATCH 291/686] Adding tests for review

---
 .../xpack/core/ilm/ForceMergeAction.java              |  4 ++--
 .../xpack/core/ilm/ForceMergeActionTests.java         |  4 +++-
 .../xpack/ilm/TimeSeriesLifecycleActionsIT.java       | 11 +++++++++--
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 6ee7c3eb2df19..c3c0288c9b315 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -61,8 +61,8 @@ public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
-        if (codec != null && Codec.forName(codec.getName()) == null) {
-            throw new IllegalArgumentException("Compression type of " + codec.getName() + "does not exist");
+        if (codec != null && CodecService.BEST_COMPRESSION_CODEC.equals(codec.getName()) == false) {
+            throw new IllegalArgumentException("Compression type not found instead " + codec.getName() + " is used.");
         }
         this.codec = codec;
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 042c12b9fcb78..a81a6e1350da6 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -118,7 +118,9 @@ public void testInvalidNegativeSegmentNumber() {
     }
 
     public void testInvalidCodec() {
-
+        Exception r = expectThrows(IllegalArgumentException.class, () -> new
+            ForceMergeAction(randomIntBetween(-10, 0), Codec.forName(CodecService.DEFAULT_CODEC)));
+        assertThat(r.getMessage(), equalTo("Best Compression type not found instead " + CodecService.DEFAULT_CODEC + " is used."));
     }
 
     public void testToSteps() {
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 3392ae4954353..c40e96bcdd9e8 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -25,6 +25,7 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.index.codec.CodecService;
 import org.elasticsearch.test.rest.ESRestTestCase;
 import org.elasticsearch.xpack.core.ilm.AllocateAction;
 import org.elasticsearch.xpack.core.ilm.DeleteAction;
@@ -391,7 +392,7 @@ public void testReadOnly() throws Exception {
     }
 
     @SuppressWarnings("unchecked")
-    public void testForceMergeAction() throws Exception {
+    public void forceMergeActionWithCodec(Codec codec) throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
         for (int i = 0; i < randomIntBetween(2, 10); i++) {
@@ -415,7 +416,7 @@ public void testForceMergeAction() throws Exception {
         };
         assertThat(numSegments.get(), greaterThan(1));
 
-        createNewSingletonPolicy("warm", new ForceMergeAction(1, Codec.getDefault()));
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, codec));
         updatePolicy(index, policy);
 
         assertBusy(() -> {
@@ -427,6 +428,12 @@ public void testForceMergeAction() throws Exception {
         expectThrows(ResponseException.class, this::indexDocument);
     }
 
+    public void testForceMergeAction() throws Exception {
+        forceMergeActionWithCodec(null);
+        forceMergeActionWithCodec(Codec.forName(CodecService.BEST_COMPRESSION_CODEC));
+    }
+
+
     public void testShrinkAction() throws Exception {
         int numShards = 6;
         int divisor = randomFrom(2, 3, 6);

From 9d52c2ab11d0674a3ed2cc8ba7c4f9c2d34573cc Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Fri, 20 Dec 2019 08:27:33 +0100
Subject: [PATCH 292/686] [Transform] refactor source and dest validation to
 support CCS (#50018)

refactors source and dest validation, adds support for CCS, makes resolve work like reindex/search, allow aliased dest index with a single write index.

fixes #49988
fixes #49851
relates #43201
---
 .../metadata/IndexNameExpressionResolver.java |  23 +-
 .../license/RemoteClusterLicenseChecker.java  |   5 +-
 .../license/XPackLicenseState.java            |   5 +
 .../validation/SourceDestValidator.java       | 460 ++++++++++
 .../core/transform/TransformMessages.java     |   3 -
 .../action/PreviewTransformAction.java        |  28 +-
 .../transform/action/PutTransformAction.java  |  40 +-
 .../action/UpdateTransformAction.java         |  29 +-
 .../validation/SourceDestValidatorTests.java  | 822 ++++++++++++++++++
 .../test/transform/preview_transforms.yml     |   2 +-
 .../test/transform/transforms_crud.yml        |   8 +-
 .../test/transform/transforms_update.yml      |  10 +-
 .../TransportPreviewTransformAction.java      | 279 +++---
 .../action/TransportPutTransformAction.java   |  56 +-
 .../action/TransportStartTransformAction.java |  72 +-
 .../TransportUpdateTransformAction.java       |  38 +-
 ...sportPreviewTransformActionDeprecated.java |  28 +-
 ...ansportStartTransformActionDeprecated.java |   7 +-
 .../transforms/SourceDestValidator.java       | 159 ----
 .../transforms/SourceDestValidatorTests.java  | 160 ----
 20 files changed, 1667 insertions(+), 567 deletions(-)
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidator.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidatorTests.java
 delete mode 100644 x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/SourceDestValidator.java
 delete mode 100644 x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/SourceDestValidatorTests.java

diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolver.java b/server/src/main/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolver.java
index 154b2ac23c216..93e8b84936133 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolver.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolver.java
@@ -296,10 +296,27 @@ public Index concreteWriteIndex(ClusterState state, IndicesRequest request) {
         if (request.indices() == null || (request.indices() != null && request.indices().length != 1)) {
             throw new IllegalArgumentException("indices request must specify a single index expression");
         }
-        Context context = new Context(state, request.indicesOptions(), false, true);
-        Index[] indices = concreteIndices(context, request.indices()[0]);
+        return concreteWriteIndex(state, request.indicesOptions(), request.indices()[0], false);
+    }
+
+    /**
+     * Utility method that allows to resolve an index expression to its corresponding single write index.
+     *
+     * @param state             the cluster state containing all the data to resolve to expression to a concrete index
+     * @param options           defines how the aliases or indices need to be resolved to concrete indices
+     * @param index             index that can be resolved to alias or index name.
+     * @param allowNoIndices    whether to allow resolve to no index
+     * @throws IllegalArgumentException if the index resolution does not lead to an index, or leads to more than one index
+     * @return the write index obtained as a result of the index resolution or null if no index
+     */
+    public Index concreteWriteIndex(ClusterState state, IndicesOptions options, String index, boolean allowNoIndices) {
+        Context context = new Context(state, options, false, true);
+        Index[] indices = concreteIndices(context, index);
+        if (allowNoIndices && indices.length == 0) {
+            return null;
+        }
         if (indices.length != 1) {
-            throw new IllegalArgumentException("The index expression [" + request.indices()[0] +
+            throw new IllegalArgumentException("The index expression [" + index +
                 "] and options provided did not point to a single write-index");
         }
         return indices[0];
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RemoteClusterLicenseChecker.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RemoteClusterLicenseChecker.java
index 5de1186767f4b..fc7d44c191601 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RemoteClusterLicenseChecker.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/RemoteClusterLicenseChecker.java
@@ -19,6 +19,7 @@
 import org.elasticsearch.transport.RemoteClusterAware;
 import org.elasticsearch.xpack.core.action.XPackInfoAction;
 
+import java.util.Collection;
 import java.util.EnumSet;
 import java.util.Iterator;
 import java.util.List;
@@ -229,7 +230,7 @@ public static boolean isRemoteIndex(final String index) {
      * @param indices the collection of index names
      * @return true if the collection of index names contains a name that represents a remote index, otherwise false
      */
-    public static boolean containsRemoteIndex(final List<String> indices) {
+    public static boolean containsRemoteIndex(final Collection<String> indices) {
         return indices.stream().anyMatch(RemoteClusterLicenseChecker::isRemoteIndex);
     }
 
@@ -240,7 +241,7 @@ public static boolean containsRemoteIndex(final List<String> indices) {
      * @param indices the collection of index names
      * @return list of index names that represent remote index names
      */
-    public static List<String> remoteIndices(final List<String> indices) {
+    public static List<String> remoteIndices(final Collection<String> indices) {
         return indices.stream().filter(RemoteClusterLicenseChecker::isRemoteIndex).collect(Collectors.toList());
     }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/XPackLicenseState.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/XPackLicenseState.java
index 69ff6dddcbe48..3c4c6dc0d6777 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/XPackLicenseState.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/XPackLicenseState.java
@@ -611,6 +611,11 @@ public synchronized boolean isTransformAllowed() {
         return status.active;
     }
 
+    public static boolean isTransformAllowedForOperationMode(final OperationMode operationMode) {
+        // any license (basic and upwards)
+        return operationMode != License.OperationMode.MISSING;
+    }
+
     /**
      * Rollup is always available as long as there is a valid license
      *
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidator.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidator.java
new file mode 100644
index 0000000000000..ef28fed54cf48
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidator.java
@@ -0,0 +1,460 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.core.common.validation;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.ActionRequest;
+import org.elasticsearch.action.ActionRequestValidationException;
+import org.elasticsearch.action.support.IndicesOptions;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
+import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.ValidationException;
+import org.elasticsearch.common.regex.Regex;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.index.IndexNotFoundException;
+import org.elasticsearch.indices.InvalidIndexNameException;
+import org.elasticsearch.license.RemoteClusterLicenseChecker;
+import org.elasticsearch.protocol.xpack.license.LicenseStatus;
+import org.elasticsearch.transport.NoSuchRemoteClusterException;
+import org.elasticsearch.transport.RemoteClusterService;
+
+import java.text.MessageFormat;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Locale;
+import java.util.Set;
+import java.util.SortedSet;
+import java.util.TreeSet;
+
+import static org.elasticsearch.action.ValidateActions.addValidationError;
+import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.validateIndexOrAliasName;
+
+/**
+ * Validation of source indexes and destination index.
+ *
+ * Validations are separated into validators to choose from, e.g. you want to run different types of validations for
+ * preview/create/start with or without support for remote clusters
+ */
+public final class SourceDestValidator {
+
+    // messages
+    public static final String SOURCE_INDEX_MISSING = "Source index [{0}] does not exist";
+    public static final String SOURCE_LOWERCASE = "Source index [{0}] must be lowercase";
+    public static final String DEST_IN_SOURCE = "Destination index [{0}] is included in source expression [{1}]";
+    public static final String DEST_LOWERCASE = "Destination index [{0}] must be lowercase";
+    public static final String NEEDS_REMOTE_CLUSTER_SEARCH = "Source index is configured with a remote index pattern(s) [{0}]"
+        + " but the current node [{1}] is not allowed to connect to remote clusters."
+        + " Please enable cluster.remote.connect for all data nodes.";
+    public static final String ERROR_REMOTE_CLUSTER_SEARCH = "Error resolving remote source: {0}";
+    public static final String UNKNOWN_REMOTE_CLUSTER_LICENSE = "Error during license check ({0}) for remote cluster "
+        + "alias(es) {1}, error: {2}";
+    public static final String FEATURE_NOT_LICENSED_REMOTE_CLUSTER_LICENSE = "License check failed for remote cluster "
+        + "alias [{0}], at least a [{1}] license is required, found license [{2}]";
+    public static final String REMOTE_CLUSTER_LICENSE_INACTIVE = "License check failed for remote cluster "
+        + "alias [{0}], license is not active";
+
+    private final IndexNameExpressionResolver indexNameExpressionResolver;
+    private final RemoteClusterService remoteClusterService;
+    private final RemoteClusterLicenseChecker remoteClusterLicenseChecker;
+    private final String nodeName;
+    private final String license;
+
+    /*
+     * Internal shared context between validators.
+     */
+    static class Context {
+        private final ClusterState state;
+        private final IndexNameExpressionResolver indexNameExpressionResolver;
+        private final RemoteClusterService remoteClusterService;
+        private final RemoteClusterLicenseChecker remoteClusterLicenseChecker;
+        private final String[] source;
+        private final String dest;
+        private final String nodeName;
+        private final String license;
+
+        private ValidationException validationException = null;
+        private SortedSet<String> resolvedSource = null;
+        private SortedSet<String> resolvedRemoteSource = null;
+        private String resolvedDest = null;
+
+        Context(
+            final ClusterState state,
+            final IndexNameExpressionResolver indexNameExpressionResolver,
+            final RemoteClusterService remoteClusterService,
+            final RemoteClusterLicenseChecker remoteClusterLicenseChecker,
+            final String[] source,
+            final String dest,
+            final String nodeName,
+            final String license
+        ) {
+            this.state = state;
+            this.indexNameExpressionResolver = indexNameExpressionResolver;
+            this.remoteClusterService = remoteClusterService;
+            this.remoteClusterLicenseChecker = remoteClusterLicenseChecker;
+            this.source = source;
+            this.dest = dest;
+            this.nodeName = nodeName;
+            this.license = license;
+        }
+
+        public ClusterState getState() {
+            return state;
+        }
+
+        public RemoteClusterService getRemoteClusterService() {
+            return remoteClusterService;
+        }
+
+        public RemoteClusterLicenseChecker getRemoteClusterLicenseChecker() {
+            return remoteClusterLicenseChecker;
+        }
+
+        public IndexNameExpressionResolver getIndexNameExpressionResolver() {
+            return indexNameExpressionResolver;
+        }
+
+        public boolean isRemoteSearchEnabled() {
+            return remoteClusterLicenseChecker != null;
+        }
+
+        public String[] getSource() {
+            return source;
+        }
+
+        public String getDest() {
+            return dest;
+        }
+
+        public String getNodeName() {
+            return nodeName;
+        }
+
+        public String getLicense() {
+            return license;
+        }
+
+        public SortedSet<String> resolveSource() {
+            if (resolvedSource == null) {
+                resolveLocalAndRemoteSource();
+            }
+
+            return resolvedSource;
+        }
+
+        public SortedSet<String> resolveRemoteSource() {
+            if (resolvedRemoteSource == null) {
+                resolveLocalAndRemoteSource();
+            }
+
+            return resolvedRemoteSource;
+        }
+
+        public String resolveDest() {
+            if (resolvedDest == null) {
+                try {
+                    Index singleWriteIndex = indexNameExpressionResolver.concreteWriteIndex(
+                        state,
+                        IndicesOptions.lenientExpandOpen(),
+                        dest,
+                        true
+                    );
+
+                    resolvedDest = singleWriteIndex != null ? singleWriteIndex.getName() : dest;
+                } catch (IllegalArgumentException e) {
+                    // stop here as we can not return a single dest index
+                    addValidationError(e.getMessage());
+                    throw validationException;
+                }
+            }
+
+            return resolvedDest;
+        }
+
+        public ValidationException addValidationError(String error, Object... args) {
+            if (validationException == null) {
+                validationException = new ValidationException();
+            }
+
+            validationException.addValidationError(getMessage(error, args));
+
+            return validationException;
+        }
+
+        public ValidationException getValidationException() {
+            return validationException;
+        }
+
+        // convenience method to make testing easier
+        public Set<String> getRegisteredRemoteClusterNames() {
+            return remoteClusterService.getRegisteredRemoteClusterNames();
+        }
+
+        private void resolveLocalAndRemoteSource() {
+            resolvedSource = new TreeSet<>(Arrays.asList(source));
+            resolvedRemoteSource = new TreeSet<>(RemoteClusterLicenseChecker.remoteIndices(resolvedSource));
+            resolvedSource.removeAll(resolvedRemoteSource);
+
+            // special case: if indexNameExpressionResolver gets an empty list it treats it as _all
+            if (resolvedSource.isEmpty() == false) {
+                resolvedSource = new TreeSet<>(
+                    Arrays.asList(
+                        indexNameExpressionResolver.concreteIndexNames(
+                            state,
+                            DEFAULT_INDICES_OPTIONS_FOR_VALIDATION,
+                            resolvedSource.toArray(new String[0])
+                        )
+                    )
+                );
+            }
+        }
+    }
+
+    interface SourceDestValidation {
+        void validate(Context context, ActionListener<Context> listener);
+    }
+
+    // note: this is equivalent to the default for search requests
+    private static final IndicesOptions DEFAULT_INDICES_OPTIONS_FOR_VALIDATION = IndicesOptions
+        .strictExpandOpenAndForbidClosedIgnoreThrottled();
+
+    public static final SourceDestValidation SOURCE_MISSING_VALIDATION = new SourceMissingValidation();
+    public static final SourceDestValidation REMOTE_SOURCE_VALIDATION = new RemoteSourceEnabledAndRemoteLicenseValidation();
+    public static final SourceDestValidation DESTINATION_IN_SOURCE_VALIDATION = new DestinationInSourceValidation();
+    public static final SourceDestValidation DESTINATION_SINGLE_INDEX_VALIDATION = new DestinationSingleIndexValidation();
+
+    // set of default validation collections, if you want to automatically benefit from new validators, use those
+    public static final List<SourceDestValidation> PREVIEW_VALIDATIONS = Arrays.asList(SOURCE_MISSING_VALIDATION, REMOTE_SOURCE_VALIDATION);
+
+    public static final List<SourceDestValidation> ALL_VALIDATIONS = Arrays.asList(
+        SOURCE_MISSING_VALIDATION,
+        REMOTE_SOURCE_VALIDATION,
+        DESTINATION_IN_SOURCE_VALIDATION,
+        DESTINATION_SINGLE_INDEX_VALIDATION
+    );
+
+    public static final List<SourceDestValidation> NON_DEFERABLE_VALIDATIONS = Arrays.asList(DESTINATION_SINGLE_INDEX_VALIDATION);
+
+    /**
+     * Create a new Source Dest Validator
+     *
+     * @param indexNameExpressionResolver A valid IndexNameExpressionResolver object
+     * @param remoteClusterService A valid RemoteClusterService object
+     * @param remoteClusterLicenseChecker A RemoteClusterLicenseChecker or null if CCS is disabled
+     * @param nodeName the name of this node
+     * @param license the license of the feature validated for
+     */
+    public SourceDestValidator(
+        IndexNameExpressionResolver indexNameExpressionResolver,
+        RemoteClusterService remoteClusterService,
+        RemoteClusterLicenseChecker remoteClusterLicenseChecker,
+        String nodeName,
+        String license
+    ) {
+        this.indexNameExpressionResolver = indexNameExpressionResolver;
+        this.remoteClusterService = remoteClusterService;
+        this.remoteClusterLicenseChecker = remoteClusterLicenseChecker;
+        this.nodeName = nodeName;
+        this.license = license;
+    }
+
+    /**
+     * Run validation against source and dest.
+     *
+     * @param clusterState The current ClusterState
+     * @param source an array of source indexes
+     * @param dest destination index
+     * @param validations list of of validations to run
+     * @param listener result listener
+     */
+    public void validate(
+        final ClusterState clusterState,
+        final String[] source,
+        final String dest,
+        final List<SourceDestValidation> validations,
+        final ActionListener<Boolean> listener
+    ) {
+        Context context = new Context(
+            clusterState,
+            indexNameExpressionResolver,
+            remoteClusterService,
+            remoteClusterLicenseChecker,
+            source,
+            dest,
+            nodeName,
+            license
+        );
+
+        ActionListener<Context> validationListener = ActionListener.wrap(c -> {
+            if (c.getValidationException() != null) {
+                listener.onFailure(c.getValidationException());
+            } else {
+                listener.onResponse(true);
+            }
+        }, listener::onFailure);
+
+        for (int i = validations.size() - 1; i >= 0; i--) {
+            final SourceDestValidation validation = validations.get(i);
+            final ActionListener<Context> previousValidationListener = validationListener;
+            validationListener = ActionListener.wrap(c -> { validation.validate(c, previousValidationListener); }, listener::onFailure);
+        }
+
+        validationListener.onResponse(context);
+    }
+
+    /**
+     * Validate dest request.
+     *
+     * This runs a couple of simple validations at request time, to be executed from a {@link ActionRequest}}
+     * implementation.
+     *
+     * Note: Source can not be validated at request time as it might contain expressions.
+     *
+     * @param validationException an ActionRequestValidationException for collection validation problem, can be null
+     * @param dest destination index, null if validation shall be skipped
+     */
+    public static ActionRequestValidationException validateRequest(
+        @Nullable ActionRequestValidationException validationException,
+        @Nullable String dest
+    ) {
+        try {
+            if (dest != null) {
+                validateIndexOrAliasName(dest, InvalidIndexNameException::new);
+                if (dest.toLowerCase(Locale.ROOT).equals(dest) == false) {
+                    validationException = addValidationError(getMessage(DEST_LOWERCASE, dest), validationException);
+                }
+            }
+        } catch (InvalidIndexNameException ex) {
+            validationException = addValidationError(ex.getMessage(), validationException);
+        }
+
+        return validationException;
+    }
+
+    static class SourceMissingValidation implements SourceDestValidation {
+
+        @Override
+        public void validate(Context context, ActionListener<Context> listener) {
+            try {
+                // non-trivia: if source contains a wildcard index, which does not resolve to a concrete index
+                // the resolved indices might be empty, but we can check if source contained something, this works because
+                // of no wildcard index is involved the resolve would have thrown an exception
+                if (context.resolveSource().isEmpty() && context.resolveRemoteSource().isEmpty() && context.getSource().length == 0) {
+                    context.addValidationError(SOURCE_INDEX_MISSING, Strings.arrayToCommaDelimitedString(context.getSource()));
+                }
+            } catch (IndexNotFoundException e) {
+                context.addValidationError(e.getMessage());
+            }
+            listener.onResponse(context);
+        }
+    }
+
+    static class RemoteSourceEnabledAndRemoteLicenseValidation implements SourceDestValidation {
+        @Override
+        public void validate(Context context, ActionListener<Context> listener) {
+            if (context.resolveRemoteSource().isEmpty()) {
+                listener.onResponse(context);
+                return;
+            }
+
+            List<String> remoteIndices = new ArrayList<>(context.resolveRemoteSource());
+            // we can only check this node at the moment, clusters with mixed CCS enabled/disabled nodes are not supported,
+            // see gh#50033
+            if (context.isRemoteSearchEnabled() == false) {
+                context.addValidationError(NEEDS_REMOTE_CLUSTER_SEARCH, context.resolveRemoteSource(), context.getNodeName());
+                listener.onResponse(context);
+                return;
+            }
+
+            // this can throw
+            List<String> remoteAliases;
+            try {
+                remoteAliases = RemoteClusterLicenseChecker.remoteClusterAliases(context.getRegisteredRemoteClusterNames(), remoteIndices);
+            } catch (NoSuchRemoteClusterException e) {
+                context.addValidationError(e.getMessage());
+                listener.onResponse(context);
+                return;
+            } catch (Exception e) {
+                context.addValidationError(ERROR_REMOTE_CLUSTER_SEARCH, e.getMessage());
+                listener.onResponse(context);
+                return;
+            }
+
+            context.getRemoteClusterLicenseChecker().checkRemoteClusterLicenses(remoteAliases, ActionListener.wrap(response -> {
+                if (response.isSuccess() == false) {
+                    if (response.remoteClusterLicenseInfo().licenseInfo().getStatus() != LicenseStatus.ACTIVE) {
+                        context.addValidationError(REMOTE_CLUSTER_LICENSE_INACTIVE, response.remoteClusterLicenseInfo().clusterAlias());
+                    } else {
+                        context.addValidationError(
+                            FEATURE_NOT_LICENSED_REMOTE_CLUSTER_LICENSE,
+                            response.remoteClusterLicenseInfo().clusterAlias(),
+                            context.getLicense(),
+                            response.remoteClusterLicenseInfo().licenseInfo().getType()
+                        );
+                    }
+                }
+                listener.onResponse(context);
+            }, e -> {
+                context.addValidationError(UNKNOWN_REMOTE_CLUSTER_LICENSE, context.getLicense(), remoteAliases, e.getMessage());
+                listener.onResponse(context);
+            }));
+        }
+    }
+
+    static class DestinationInSourceValidation implements SourceDestValidation {
+
+        @Override
+        public void validate(Context context, ActionListener<Context> listener) {
+            final String destIndex = context.getDest();
+            boolean foundSourceInDest = false;
+
+            for (String src : context.getSource()) {
+                if (Regex.simpleMatch(src, destIndex)) {
+                    context.addValidationError(DEST_IN_SOURCE, destIndex, src);
+                    // do not return immediately but collect all errors and than return
+                    foundSourceInDest = true;
+                }
+            }
+
+            if (foundSourceInDest) {
+                listener.onResponse(context);
+                return;
+            }
+
+            if (context.resolvedSource.contains(destIndex)) {
+                context.addValidationError(DEST_IN_SOURCE, destIndex, Strings.arrayToCommaDelimitedString(context.getSource()));
+                listener.onResponse(context);
+                return;
+            }
+
+            if (context.resolvedSource.contains(context.resolveDest())) {
+                context.addValidationError(
+                    DEST_IN_SOURCE,
+                    context.resolveDest(),
+                    Strings.collectionToCommaDelimitedString(context.resolveSource())
+                );
+            }
+
+            listener.onResponse(context);
+        }
+    }
+
+    static class DestinationSingleIndexValidation implements SourceDestValidation {
+
+        @Override
+        public void validate(Context context, ActionListener<Context> listener) {
+            context.resolveDest();
+            listener.onResponse(context);
+        }
+    }
+
+    private static String getMessage(String message, Object... args) {
+        return new MessageFormat(message, Locale.ROOT).format(args);
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
index 9708cd301e437..b1e9dffea5027 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
@@ -21,9 +21,6 @@ public class TransformMessages {
             "Failed to validate configuration";
     public static final String REST_PUT_FAILED_PERSIST_TRANSFORM_CONFIGURATION = "Failed to persist transform configuration";
     public static final String REST_PUT_TRANSFORM_FAILED_TO_DEDUCE_DEST_MAPPINGS = "Failed to deduce dest mappings";
-    public static final String REST_PUT_TRANSFORM_SOURCE_INDEX_MISSING = "Source index [{0}] does not exist";
-    public static final String REST_PUT_TRANSFORM_DEST_IN_SOURCE = "Destination index [{0}] is included in source expression [{1}]";
-    public static final String REST_PUT_TRANSFORM_DEST_SINGLE_INDEX = "Destination index [{0}] should refer to a single index";
     public static final String REST_PUT_TRANSFORM_INCONSISTENT_ID =
             "Inconsistent id; ''{0}'' specified in the body differs from ''{1}'' specified as a URL argument";
     public static final String TRANSFORM_CONFIG_INVALID = "Transform configuration is invalid [{0}]";
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PreviewTransformAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PreviewTransformAction.java
index cb095be157193..9078d5952e2af 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PreviewTransformAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PreviewTransformAction.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.transform.TransformField;
 import org.elasticsearch.xpack.core.transform.transforms.DestConfig;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
@@ -66,7 +67,7 @@ public static Request fromXContent(final XContentParser parser) throws IOExcepti
             Object providedDestination = content.get(TransformField.DESTINATION.getPreferredName());
             if (providedDestination instanceof Map) {
                 @SuppressWarnings("unchecked")
-                Map<String, String> destMap = (Map<String, String>)providedDestination;
+                Map<String, String> destMap = (Map<String, String>) providedDestination;
                 String pipeline = destMap.get(DestConfig.PIPELINE.getPreferredName());
                 if (pipeline != null) {
                     tempDestination.put(DestConfig.PIPELINE.getPreferredName(), pipeline);
@@ -74,12 +75,15 @@ public static Request fromXContent(final XContentParser parser) throws IOExcepti
             }
             content.put(TransformField.DESTINATION.getPreferredName(), tempDestination);
             content.put(TransformField.ID.getPreferredName(), "transform-preview");
-            try(XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().map(content);
-                XContentParser newParser = XContentType.JSON
-                    .xContent()
-                    .createParser(parser.getXContentRegistry(),
+            try (
+                XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().map(content);
+                XContentParser newParser = XContentType.JSON.xContent()
+                    .createParser(
+                        parser.getXContentRegistry(),
                         LoggingDeprecationHandler.INSTANCE,
-                        BytesReference.bytes(xContentBuilder).streamInput())) {
+                        BytesReference.bytes(xContentBuilder).streamInput()
+                    )
+            ) {
                 return new Request(TransformConfig.fromXContent(newParser, "transform-preview", false));
             }
         }
@@ -87,15 +91,20 @@ public static Request fromXContent(final XContentParser parser) throws IOExcepti
         @Override
         public ActionRequestValidationException validate() {
             ActionRequestValidationException validationException = null;
-            if(config.getPivotConfig() != null) {
-                for(String failure : config.getPivotConfig().aggFieldValidation()) {
+            if (config.getPivotConfig() != null) {
+                for (String failure : config.getPivotConfig().aggFieldValidation()) {
                     validationException = addValidationError(failure, validationException);
                 }
             }
+
+            validationException = SourceDestValidator.validateRequest(
+                validationException,
+                config.getDestination() != null ? config.getDestination().getIndex() : null
+            );
+
             return validationException;
         }
 
-
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
             return this.config.toXContent(builder, params);
@@ -141,6 +150,7 @@ public static class Response extends ActionResponse implements ToXContentObject
             PARSER.declareObjectArray(Response::setDocs, (p, c) -> p.mapOrdered(), PREVIEW);
             PARSER.declareObject(Response::setMappings, (p, c) -> p.mapOrdered(), MAPPINGS);
         }
+
         public Response() {}
 
         public Response(StreamInput in) throws IOException {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PutTransformAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PutTransformAction.java
index 734d1c9b0b8d8..5199ca0601e6a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PutTransformAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PutTransformAction.java
@@ -15,18 +15,16 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.indices.InvalidIndexNameException;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.transform.TransformField;
 import org.elasticsearch.xpack.core.transform.TransformMessages;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
 import org.elasticsearch.xpack.core.transform.utils.TransformStrings;
 
 import java.io.IOException;
-import java.util.Locale;
 import java.util.Objects;
 
 import static org.elasticsearch.action.ValidateActions.addValidationError;
-import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.validateIndexOrAliasName;
 
 public class PutTransformAction extends ActionType<AcknowledgedResponse> {
 
@@ -71,46 +69,46 @@ public static Request fromXContent(final XContentParser parser, final String id,
         @Override
         public ActionRequestValidationException validate() {
             ActionRequestValidationException validationException = null;
-            if(config.getPivotConfig() != null
+            if (config.getPivotConfig() != null
                 && config.getPivotConfig().getMaxPageSearchSize() != null
                 && (config.getPivotConfig().getMaxPageSearchSize() < 10 || config.getPivotConfig().getMaxPageSearchSize() > 10_000)) {
                 validationException = addValidationError(
-                    "pivot.max_page_search_size [" +
-                        config.getPivotConfig().getMaxPageSearchSize() + "] must be greater than 10 and less than 10,000",
-                    validationException);
+                    "pivot.max_page_search_size ["
+                        + config.getPivotConfig().getMaxPageSearchSize()
+                        + "] must be greater than 10 and less than 10,000",
+                    validationException
+                );
             }
-            for(String failure : config.getPivotConfig().aggFieldValidation()) {
+            for (String failure : config.getPivotConfig().aggFieldValidation()) {
                 validationException = addValidationError(failure, validationException);
             }
-            String destIndex = config.getDestination().getIndex();
-            try {
-                validateIndexOrAliasName(destIndex, InvalidIndexNameException::new);
-                if (!destIndex.toLowerCase(Locale.ROOT).equals(destIndex)) {
-                    validationException = addValidationError("dest.index [" + destIndex +"] must be lowercase", validationException);
-                }
-            } catch (InvalidIndexNameException ex) {
-                validationException = addValidationError(ex.getMessage(), validationException);
-            }
+
+            validationException = SourceDestValidator.validateRequest(validationException, config.getDestination().getIndex());
+
             if (TransformStrings.isValidId(config.getId()) == false) {
                 validationException = addValidationError(
                     TransformMessages.getMessage(TransformMessages.INVALID_ID, TransformField.ID.getPreferredName(), config.getId()),
-                    validationException);
+                    validationException
+                );
             }
             if (TransformStrings.hasValidLengthForId(config.getId()) == false) {
                 validationException = addValidationError(
                     TransformMessages.getMessage(TransformMessages.ID_TOO_LONG, TransformStrings.ID_LENGTH_LIMIT),
-                    validationException);
+                    validationException
+                );
             }
             TimeValue frequency = config.getFrequency();
             if (frequency != null) {
                 if (frequency.compareTo(MIN_FREQUENCY) < 0) {
                     validationException = addValidationError(
                         "minimum permitted [" + TransformField.FREQUENCY + "] is [" + MIN_FREQUENCY.getStringRep() + "]",
-                        validationException);
+                        validationException
+                    );
                 } else if (frequency.compareTo(MAX_FREQUENCY) > 0) {
                     validationException = addValidationError(
                         "highest permitted [" + TransformField.FREQUENCY + "] is [" + MAX_FREQUENCY.getStringRep() + "]",
-                        validationException);
+                        validationException
+                    );
                 }
             }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/UpdateTransformAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/UpdateTransformAction.java
index b8cc02949834d..81fdad0df2b63 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/UpdateTransformAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/UpdateTransformAction.java
@@ -16,17 +16,15 @@
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.indices.InvalidIndexNameException;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.transform.TransformField;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfigUpdate;
 
 import java.io.IOException;
-import java.util.Locale;
 import java.util.Objects;
 
 import static org.elasticsearch.action.ValidateActions.addValidationError;
-import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.validateIndexOrAliasName;
 
 public class UpdateTransformAction extends ActionType<UpdateTransformAction.Response> {
 
@@ -46,7 +44,7 @@ public static class Request extends AcknowledgedRequest<Request> {
         private final String id;
         private final boolean deferValidation;
 
-        public Request(TransformConfigUpdate update, String id, boolean deferValidation)  {
+        public Request(TransformConfigUpdate update, String id, boolean deferValidation) {
             this.update = update;
             this.id = id;
             this.deferValidation = deferValidation;
@@ -70,27 +68,24 @@ public static Request fromXContent(final XContentParser parser, final String id,
         @Override
         public ActionRequestValidationException validate() {
             ActionRequestValidationException validationException = null;
+
             if (update.getDestination() != null && update.getDestination().getIndex() != null) {
-                String destIndex = update.getDestination().getIndex();
-                try {
-                    validateIndexOrAliasName(destIndex, InvalidIndexNameException::new);
-                    if (!destIndex.toLowerCase(Locale.ROOT).equals(destIndex)) {
-                        validationException = addValidationError("dest.index [" + destIndex + "] must be lowercase", validationException);
-                    }
-                } catch (InvalidIndexNameException ex) {
-                    validationException = addValidationError(ex.getMessage(), validationException);
-                }
+
+                validationException = SourceDestValidator.validateRequest(validationException, update.getDestination().getIndex());
             }
+
             TimeValue frequency = update.getFrequency();
             if (frequency != null) {
                 if (frequency.compareTo(MIN_FREQUENCY) < 0) {
                     validationException = addValidationError(
                         "minimum permitted [" + TransformField.FREQUENCY + "] is [" + MIN_FREQUENCY.getStringRep() + "]",
-                        validationException);
+                        validationException
+                    );
                 } else if (frequency.compareTo(MAX_FREQUENCY) > 0) {
                     validationException = addValidationError(
                         "highest permitted [" + TransformField.FREQUENCY + "] is [" + MAX_FREQUENCY.getStringRep() + "]",
-                        validationException);
+                        validationException
+                    );
                 }
             }
 
@@ -131,9 +126,7 @@ public boolean equals(Object obj) {
                 return false;
             }
             Request other = (Request) obj;
-            return Objects.equals(update, other.update) &&
-                this.deferValidation == other.deferValidation &&
-                this.id.equals(other.id);
+            return Objects.equals(update, other.update) && this.deferValidation == other.deferValidation && this.id.equals(other.id);
         }
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidatorTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidatorTests.java
new file mode 100644
index 0000000000000..566925258c879
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidatorTests.java
@@ -0,0 +1,822 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.common.validation;
+
+import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.ActionRequest;
+import org.elasticsearch.action.ActionRequestValidationException;
+import org.elasticsearch.action.ActionResponse;
+import org.elasticsearch.action.ActionType;
+import org.elasticsearch.action.LatchedActionListener;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.AliasMetaData;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.CheckedConsumer;
+import org.elasticsearch.common.ValidationException;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.license.License;
+import org.elasticsearch.license.RemoteClusterLicenseChecker;
+import org.elasticsearch.license.XPackLicenseState;
+import org.elasticsearch.protocol.xpack.XPackInfoRequest;
+import org.elasticsearch.protocol.xpack.XPackInfoResponse;
+import org.elasticsearch.protocol.xpack.XPackInfoResponse.LicenseInfo;
+import org.elasticsearch.protocol.xpack.license.LicenseStatus;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.client.NoOpClient;
+import org.elasticsearch.test.transport.MockTransportService;
+import org.elasticsearch.threadpool.TestThreadPool;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.RemoteClusterService;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator.Context;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator.RemoteSourceEnabledAndRemoteLicenseValidation;
+import org.junit.After;
+import org.junit.Before;
+
+import java.util.Collections;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.function.Consumer;
+
+import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_CREATION_DATE;
+import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_REPLICAS;
+import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
+import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_VERSION_CREATED;
+import static org.elasticsearch.mock.orig.Mockito.when;
+import static org.hamcrest.Matchers.equalTo;
+import static org.mockito.Mockito.spy;
+
+public class SourceDestValidatorTests extends ESTestCase {
+
+    private static final String SOURCE_1 = "source-1";
+    private static final String SOURCE_1_ALIAS = "source-1-alias";
+    private static final String SOURCE_2 = "source-2";
+    private static final String DEST_ALIAS = "dest-alias";
+    private static final String ALIASED_DEST = "aliased-dest";
+    private static final String ALIAS_READ_WRITE_DEST = "alias-read-write-dest";
+    private static final String REMOTE_BASIC = "remote-basic";
+    private static final String REMOTE_PLATINUM = "remote-platinum";
+
+    private static final ClusterState CLUSTER_STATE;
+    private Client clientWithBasicLicense;
+    private Client clientWithExpiredBasicLicense;
+    private Client clientWithPlatinumLicense;
+    private Client clientWithTrialLicense;
+    private RemoteClusterLicenseChecker remoteClusterLicenseCheckerBasic;
+
+    private final ThreadPool threadPool = new TestThreadPool(getClass().getName());
+    private final TransportService transportService = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool);
+    private final RemoteClusterService remoteClusterService = transportService.getRemoteClusterService();
+    private final SourceDestValidator simpleNonRemoteValidator = new SourceDestValidator(
+        new IndexNameExpressionResolver(),
+        remoteClusterService,
+        null,
+        "node_id",
+        "license"
+    );
+
+    static {
+        IndexMetaData source1 = IndexMetaData.builder(SOURCE_1)
+            .settings(
+                Settings.builder()
+                    .put(SETTING_VERSION_CREATED, Version.CURRENT)
+                    .put(SETTING_NUMBER_OF_SHARDS, 1)
+                    .put(SETTING_NUMBER_OF_REPLICAS, 0)
+                    .put(SETTING_CREATION_DATE, System.currentTimeMillis())
+            )
+            .putAlias(AliasMetaData.builder(SOURCE_1_ALIAS).build())
+            .putAlias(AliasMetaData.builder(ALIAS_READ_WRITE_DEST).writeIndex(false).build())
+            .build();
+        IndexMetaData source2 = IndexMetaData.builder(SOURCE_2)
+            .settings(
+                Settings.builder()
+                    .put(SETTING_VERSION_CREATED, Version.CURRENT)
+                    .put(SETTING_NUMBER_OF_SHARDS, 1)
+                    .put(SETTING_NUMBER_OF_REPLICAS, 0)
+                    .put(SETTING_CREATION_DATE, System.currentTimeMillis())
+            )
+            .putAlias(AliasMetaData.builder(DEST_ALIAS).build())
+            .putAlias(AliasMetaData.builder(ALIAS_READ_WRITE_DEST).writeIndex(false).build())
+            .build();
+        IndexMetaData aliasedDest = IndexMetaData.builder(ALIASED_DEST)
+            .settings(
+                Settings.builder()
+                    .put(SETTING_VERSION_CREATED, Version.CURRENT)
+                    .put(SETTING_NUMBER_OF_SHARDS, 1)
+                    .put(SETTING_NUMBER_OF_REPLICAS, 0)
+                    .put(SETTING_CREATION_DATE, System.currentTimeMillis())
+            )
+            .putAlias(AliasMetaData.builder(DEST_ALIAS).build())
+            .putAlias(AliasMetaData.builder(ALIAS_READ_WRITE_DEST).build())
+            .build();
+        ClusterState.Builder state = ClusterState.builder(new ClusterName("test"));
+        state.metaData(
+            MetaData.builder()
+                .put(IndexMetaData.builder(source1).build(), false)
+                .put(IndexMetaData.builder(source2).build(), false)
+                .put(IndexMetaData.builder(aliasedDest).build(), false)
+        );
+        CLUSTER_STATE = state.build();
+    }
+
+    private class MockClientLicenseCheck extends NoOpClient {
+        private final String license;
+        private final LicenseStatus licenseStatus;
+
+        MockClientLicenseCheck(String testName, String license, LicenseStatus licenseStatus) {
+            super(testName);
+            this.license = license;
+            this.licenseStatus = licenseStatus;
+        }
+
+        @Override
+        public Client getRemoteClusterClient(String clusterAlias) {
+            return this;
+        }
+
+        @SuppressWarnings("unchecked")
+        @Override
+        protected <Request extends ActionRequest, Response extends ActionResponse> void doExecute(
+            ActionType<Response> action,
+            Request request,
+            ActionListener<Response> listener
+        ) {
+            if (request instanceof XPackInfoRequest) {
+                XPackInfoResponse response = new XPackInfoResponse(
+                    null,
+                    new LicenseInfo("uid", license, license, licenseStatus, randomNonNegativeLong()),
+                    null
+                );
+                listener.onResponse((Response) response);
+                return;
+            }
+            super.doExecute(action, request, listener);
+        }
+    }
+
+    @Before
+    public void setupComponents() {
+        clientWithBasicLicense = new MockClientLicenseCheck(getTestName(), "basic", LicenseStatus.ACTIVE);
+        clientWithExpiredBasicLicense = new MockClientLicenseCheck(getTestName(), "basic", LicenseStatus.EXPIRED);
+        remoteClusterLicenseCheckerBasic = new RemoteClusterLicenseChecker(
+            clientWithBasicLicense,
+            (operationMode -> operationMode != License.OperationMode.MISSING)
+        );
+        clientWithPlatinumLicense = new MockClientLicenseCheck(getTestName(), "platinum", LicenseStatus.ACTIVE);
+        clientWithTrialLicense = new MockClientLicenseCheck(getTestName(), "trial", LicenseStatus.ACTIVE);
+    }
+
+    @After
+    public void closeComponents() throws Exception {
+        clientWithBasicLicense.close();
+        clientWithExpiredBasicLicense.close();
+        clientWithPlatinumLicense.close();
+        clientWithTrialLicense.close();
+        ThreadPool.terminate(threadPool, 10, TimeUnit.SECONDS);
+    }
+
+    public void testCheck_GivenSimpleSourceIndexAndValidDestIndex() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1 },
+                "dest",
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_GivenNoSourceIndexAndValidDestIndex() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] {},
+                "dest",
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(e.validationErrors().get(0), equalTo("Source index [] does not exist"));
+            }
+        );
+    }
+
+    public void testCheck_GivenMissingConcreteSourceIndex() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { "missing" },
+                "dest",
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(e.validationErrors().get(0), equalTo("no such index [missing]"));
+            }
+        );
+
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { "missing" },
+                "dest",
+                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_GivenMixedMissingAndExistingConcreteSourceIndex() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1, "missing" },
+                "dest",
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(e.validationErrors().get(0), equalTo("no such index [missing]"));
+            }
+        );
+
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1, "missing" },
+                "dest",
+                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_GivenMixedMissingWildcardExistingConcreteSourceIndex() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1, "wildcard*", "missing" },
+                "dest",
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(e.validationErrors().get(0), equalTo("no such index [missing]"));
+            }
+        );
+
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1, "wildcard*", "missing" },
+                "dest",
+                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_GivenWildcardSourceIndex() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { "wildcard*" },
+                "dest",
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_GivenDestIndexSameAsSourceIndex() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1 },
+                SOURCE_1,
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(
+                    e.validationErrors().get(0),
+                    equalTo("Destination index [" + SOURCE_1 + "] is included in source expression [" + SOURCE_1 + "]")
+                );
+            }
+        );
+
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1 },
+                SOURCE_1,
+                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_GivenDestIndexMatchesSourceIndex() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { "source-*" },
+                SOURCE_2,
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(
+                    e.validationErrors().get(0),
+                    equalTo("Destination index [" + SOURCE_2 + "] is included in source expression [source-*]")
+                );
+            }
+        );
+
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { "source-*" },
+                SOURCE_2,
+                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_GivenDestIndexMatchesOneOfSourceIndices() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { "source-1", "source-*" },
+                SOURCE_2,
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(
+                    e.validationErrors().get(0),
+                    equalTo("Destination index [" + SOURCE_2 + "] is included in source expression [source-*]")
+                );
+            }
+        );
+
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { "source-1", "source-*" },
+                SOURCE_2,
+                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_GivenDestIndexMatchesMultipleSourceIndices() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { "source-1", "source-*", "sou*" },
+                SOURCE_2,
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(2, e.validationErrors().size());
+                assertThat(
+                    e.validationErrors().get(0),
+                    equalTo("Destination index [" + SOURCE_2 + "] is included in source expression [source-*]")
+                );
+                assertThat(
+                    e.validationErrors().get(1),
+                    equalTo("Destination index [" + SOURCE_2 + "] is included in source expression [sou*]")
+                );
+            }
+        );
+    }
+
+    public void testCheck_GivenDestIndexIsAliasThatMatchesMultipleIndices() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1 },
+                DEST_ALIAS,
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(
+                    e.validationErrors().get(0),
+                    equalTo(
+                        "no write index is defined for alias [dest-alias]. "
+                            + "The write index may be explicitly disabled using is_write_index=false or the alias points "
+                            + "to multiple indices without one being designated as a write index"
+                    )
+                );
+            }
+        );
+
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1 },
+                DEST_ALIAS,
+                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(
+                    e.validationErrors().get(0),
+                    equalTo(
+                        "no write index is defined for alias [dest-alias]. "
+                            + "The write index may be explicitly disabled using is_write_index=false or the alias points "
+                            + "to multiple indices without one being designated as a write index"
+                    )
+                );
+            }
+        );
+    }
+
+    public void testCheck_GivenDestIndexIsAliasThatMatchesMultipleIndicesButHasSingleWriteAlias() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1 },
+                ALIAS_READ_WRITE_DEST,
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(
+                    e.validationErrors().get(0),
+                    equalTo(
+                        "no write index is defined for alias ["
+                            + ALIAS_READ_WRITE_DEST
+                            + "]. "
+                            + "The write index may be explicitly disabled using is_write_index=false or the alias points "
+                            + "to multiple indices without one being designated as a write index"
+                    )
+                );
+            }
+        );
+    }
+
+    public void testCheck_GivenDestIndexIsAliasThatIsIncludedInSource() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1 },
+                SOURCE_1_ALIAS,
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(1, e.validationErrors().size());
+                assertThat(
+                    e.validationErrors().get(0),
+                    equalTo("Destination index [" + SOURCE_1 + "] is included in source expression [" + SOURCE_1 + "]")
+                );
+            }
+        );
+
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1 },
+                SOURCE_1_ALIAS,
+                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                listener
+            ),
+            true,
+            null
+        );
+    }
+
+    public void testCheck_MultipleValidationErrors() throws InterruptedException {
+        assertValidation(
+            listener -> simpleNonRemoteValidator.validate(
+                CLUSTER_STATE,
+                new String[] { SOURCE_1, "missing" },
+                SOURCE_1_ALIAS,
+                SourceDestValidator.ALL_VALIDATIONS,
+                listener
+            ),
+            (Boolean) null,
+            e -> {
+                assertEquals(2, e.validationErrors().size());
+                assertThat(e.validationErrors().get(0), equalTo("no such index [missing]"));
+                assertThat(
+                    e.validationErrors().get(1),
+                    equalTo("Destination index [" + SOURCE_1 + "] is included in source expression [missing,source-1]")
+                );
+            }
+        );
+    }
+
+    // CCS tests: at time of writing it wasn't possible to mock RemoteClusterService, therefore it's not possible
+    // to test the whole validation but test RemoteSourceEnabledAndRemoteLicenseValidation
+    public void testRemoteSourceBasic() throws InterruptedException {
+        Context context = spy(
+            new SourceDestValidator.Context(
+                CLUSTER_STATE,
+                new IndexNameExpressionResolver(),
+                remoteClusterService,
+                remoteClusterLicenseCheckerBasic,
+                new String[] { REMOTE_BASIC + ":" + "SOURCE_1" },
+                "dest",
+                "node_id",
+                "license"
+            )
+        );
+
+        when(context.getRegisteredRemoteClusterNames()).thenReturn(Collections.singleton(REMOTE_BASIC));
+        RemoteSourceEnabledAndRemoteLicenseValidation validator = new RemoteSourceEnabledAndRemoteLicenseValidation();
+
+        assertValidationWithContext(
+            listener -> validator.validate(context, listener),
+            c -> { assertNull(c.getValidationException()); },
+            null
+        );
+    }
+
+    public void testRemoteSourcePlatinum() throws InterruptedException {
+        final Context context = spy(
+            new SourceDestValidator.Context(
+                CLUSTER_STATE,
+                new IndexNameExpressionResolver(),
+                remoteClusterService,
+                new RemoteClusterLicenseChecker(clientWithBasicLicense, XPackLicenseState::isPlatinumOrTrialOperationMode),
+                new String[] { REMOTE_BASIC + ":" + "SOURCE_1" },
+                "dest",
+                "node_id",
+                "platinum"
+            )
+        );
+
+        when(context.getRegisteredRemoteClusterNames()).thenReturn(Collections.singleton(REMOTE_BASIC));
+        final RemoteSourceEnabledAndRemoteLicenseValidation validator = new RemoteSourceEnabledAndRemoteLicenseValidation();
+
+        assertValidationWithContext(listener -> validator.validate(context, listener), c -> {
+            assertNotNull(c.getValidationException());
+            assertEquals(1, c.getValidationException().validationErrors().size());
+            assertThat(
+                c.getValidationException().validationErrors().get(0),
+                equalTo(
+                    "License check failed for remote cluster alias ["
+                        + REMOTE_BASIC
+                        + "], at least a [platinum] license is required, found license [basic]"
+                )
+            );
+        }, null);
+
+        final Context context2 = spy(
+            new SourceDestValidator.Context(
+                CLUSTER_STATE,
+                new IndexNameExpressionResolver(),
+                remoteClusterService,
+                new RemoteClusterLicenseChecker(clientWithPlatinumLicense, XPackLicenseState::isPlatinumOrTrialOperationMode),
+                new String[] { REMOTE_PLATINUM + ":" + "SOURCE_1" },
+                "dest",
+                "node_id",
+                "license"
+            )
+        );
+        when(context2.getRegisteredRemoteClusterNames()).thenReturn(Collections.singleton(REMOTE_PLATINUM));
+
+        assertValidationWithContext(
+            listener -> validator.validate(context2, listener),
+            c -> { assertNull(c.getValidationException()); },
+            null
+        );
+
+        final Context context3 = spy(
+            new SourceDestValidator.Context(
+                CLUSTER_STATE,
+                new IndexNameExpressionResolver(),
+                remoteClusterService,
+                new RemoteClusterLicenseChecker(clientWithPlatinumLicense, XPackLicenseState::isPlatinumOrTrialOperationMode),
+                new String[] { REMOTE_PLATINUM + ":" + "SOURCE_1" },
+                "dest",
+                "node_id",
+                "platinum"
+            )
+        );
+        when(context3.getRegisteredRemoteClusterNames()).thenReturn(Collections.singleton(REMOTE_PLATINUM));
+
+        final RemoteSourceEnabledAndRemoteLicenseValidation validator3 = new RemoteSourceEnabledAndRemoteLicenseValidation();
+        assertValidationWithContext(
+            listener -> validator3.validate(context3, listener),
+            c -> { assertNull(c.getValidationException()); },
+            null
+        );
+
+        final Context context4 = spy(
+            new SourceDestValidator.Context(
+                CLUSTER_STATE,
+                new IndexNameExpressionResolver(),
+                remoteClusterService,
+                new RemoteClusterLicenseChecker(clientWithTrialLicense, XPackLicenseState::isPlatinumOrTrialOperationMode),
+                new String[] { REMOTE_PLATINUM + ":" + "SOURCE_1" },
+                "dest",
+                "node_id",
+                "trial"
+            )
+        );
+        when(context4.getRegisteredRemoteClusterNames()).thenReturn(Collections.singleton(REMOTE_PLATINUM));
+
+        final RemoteSourceEnabledAndRemoteLicenseValidation validator4 = new RemoteSourceEnabledAndRemoteLicenseValidation();
+        assertValidationWithContext(
+            listener -> validator4.validate(context4, listener),
+            c -> { assertNull(c.getValidationException()); },
+            null
+        );
+    }
+
+    public void testRemoteSourceLicenseInActive() throws InterruptedException {
+        final Context context = spy(
+            new SourceDestValidator.Context(
+                CLUSTER_STATE,
+                new IndexNameExpressionResolver(),
+                remoteClusterService,
+                new RemoteClusterLicenseChecker(clientWithExpiredBasicLicense, XPackLicenseState::isPlatinumOrTrialOperationMode),
+                new String[] { REMOTE_BASIC + ":" + "SOURCE_1" },
+                "dest",
+                "node_id",
+                "license"
+            )
+        );
+
+        when(context.getRegisteredRemoteClusterNames()).thenReturn(Collections.singleton(REMOTE_BASIC));
+        final RemoteSourceEnabledAndRemoteLicenseValidation validator = new RemoteSourceEnabledAndRemoteLicenseValidation();
+        assertValidationWithContext(listener -> validator.validate(context, listener), c -> {
+            assertNotNull(c.getValidationException());
+            assertEquals(1, c.getValidationException().validationErrors().size());
+            assertThat(
+                c.getValidationException().validationErrors().get(0),
+                equalTo("License check failed for remote cluster alias [" + REMOTE_BASIC + "], license is not active")
+            );
+        }, null);
+    }
+
+    public void testRemoteSourceDoesNotExist() throws InterruptedException {
+        Context context = spy(
+            new SourceDestValidator.Context(
+                CLUSTER_STATE,
+                new IndexNameExpressionResolver(),
+                remoteClusterService,
+                new RemoteClusterLicenseChecker(clientWithExpiredBasicLicense, XPackLicenseState::isPlatinumOrTrialOperationMode),
+                new String[] { "non_existing_remote:" + "SOURCE_1" },
+                "dest",
+                "node_id",
+                "license"
+            )
+        );
+
+        when(context.getRegisteredRemoteClusterNames()).thenReturn(Collections.singleton(REMOTE_BASIC));
+        RemoteSourceEnabledAndRemoteLicenseValidation validator = new RemoteSourceEnabledAndRemoteLicenseValidation();
+
+        assertValidationWithContext(listener -> validator.validate(context, listener), c -> {
+            assertNotNull(c.getValidationException());
+            assertEquals(1, c.getValidationException().validationErrors().size());
+            assertThat(c.getValidationException().validationErrors().get(0), equalTo("no such remote cluster: [non_existing_remote]"));
+        }, null);
+    }
+
+    public void testRequestValidation() {
+        ActionRequestValidationException validationException = SourceDestValidator.validateRequest(null, "UPPERCASE");
+        assertNotNull(validationException);
+        assertEquals(1, validationException.validationErrors().size());
+        assertThat(validationException.validationErrors().get(0), equalTo("Destination index [UPPERCASE] must be lowercase"));
+
+        validationException = SourceDestValidator.validateRequest(null, "remote:dest");
+        assertNotNull(validationException);
+        assertEquals(1, validationException.validationErrors().size());
+        assertThat(validationException.validationErrors().get(0), equalTo("Invalid index name [remote:dest], must not contain ':'"));
+
+        validationException = SourceDestValidator.validateRequest(null, "dest");
+        assertNull(validationException);
+
+        validationException = new ActionRequestValidationException();
+        validationException.addValidationError("error1");
+        validationException.addValidationError("error2");
+        validationException = SourceDestValidator.validateRequest(validationException, "dest");
+        assertNotNull(validationException);
+        assertEquals(2, validationException.validationErrors().size());
+        assertEquals(validationException.validationErrors().get(0), "error1");
+        assertEquals(validationException.validationErrors().get(1), "error2");
+
+        validationException = SourceDestValidator.validateRequest(validationException, "UPPERCASE");
+        assertNotNull(validationException);
+        assertEquals(3, validationException.validationErrors().size());
+        assertThat(validationException.validationErrors().get(2), equalTo("Destination index [UPPERCASE] must be lowercase"));
+    }
+
+    private <T> void assertValidation(Consumer<ActionListener<T>> function, T expected, Consumer<ValidationException> onException)
+        throws InterruptedException {
+
+        CountDownLatch latch = new CountDownLatch(1);
+        AtomicBoolean listenerCalled = new AtomicBoolean(false);
+
+        LatchedActionListener<T> listener = new LatchedActionListener<>(ActionListener.wrap(r -> {
+            assertTrue("listener called more than once", listenerCalled.compareAndSet(false, true));
+            if (expected == null) {
+                fail("expected an exception but got a response");
+            } else {
+                assertThat(r, equalTo(expected));
+            }
+        }, e -> {
+            assertTrue("listener called more than once", listenerCalled.compareAndSet(false, true));
+            if (onException == null) {
+                logger.error("got unexpected exception", e);
+                fail("got unexpected exception: " + e.getMessage());
+            } else if (e instanceof ValidationException) {
+                onException.accept((ValidationException) e);
+            } else {
+                fail("got unexpected exception type: " + e);
+            }
+        }), latch);
+
+        function.accept(listener);
+        assertTrue("timed out after 20s", latch.await(20, TimeUnit.SECONDS));
+    }
+
+    private void assertValidationWithContext(
+        Consumer<ActionListener<Context>> function,
+        CheckedConsumer<Context, ? extends Exception> onAnswer,
+        Consumer<ValidationException> onException
+    ) throws InterruptedException {
+
+        CountDownLatch latch = new CountDownLatch(1);
+        AtomicBoolean listenerCalled = new AtomicBoolean(false);
+
+        LatchedActionListener<Context> listener = new LatchedActionListener<>(ActionListener.wrap(r -> {
+            assertTrue("listener called more than once", listenerCalled.compareAndSet(false, true));
+            if (onAnswer == null) {
+                fail("expected an exception but got a response");
+            } else {
+                onAnswer.accept(r);
+            }
+        }, e -> {
+            assertTrue("listener called more than once", listenerCalled.compareAndSet(false, true));
+            if (onException == null) {
+                logger.error("got unexpected exception", e);
+                fail("got unexpected exception: " + e.getMessage());
+            } else if (e instanceof ValidationException) {
+                onException.accept((ValidationException) e);
+            } else {
+                fail("got unexpected exception type: " + e);
+            }
+        }), latch);
+
+        function.accept(listener);
+        assertTrue("timed out after 20s", latch.await(20, TimeUnit.SECONDS));
+    }
+}
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/preview_transforms.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/preview_transforms.yml
index 35289c2bbd09d..cf139b04b44c5 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/preview_transforms.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/preview_transforms.yml
@@ -166,7 +166,7 @@ setup:
 ---
 "Test preview with non-existing source index":
   - do:
-      catch: /Source index \[does_not_exist\] does not exist/
+      catch: /.*reason=Validation Failed.* no such index \[does_not_exist\]/
       transform.preview_transform:
         body: >
           {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
index fd9f75735e26c..1968e1fa431cc 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
@@ -79,7 +79,7 @@ setup:
 ---
 "Test put transform with invalid source index":
   - do:
-      catch: /Source index \[missing-index\] does not exist/
+      catch: /.*reason=Validation Failed.* no such index \[missing-index\]/
       transform.put_transform:
         transform_id: "missing-source-transform"
         body: >
@@ -384,7 +384,7 @@ setup:
         name: source-index
 
   - do:
-      catch: /Destination index \[created-destination-index\] is included in source expression \[airline-data,created-destination-index\]/
+      catch: /.*reason=Validation Failed.* Destination index \[created-destination-index\] is included in source expression \[airline-data,created-destination-index\]/
       transform.put_transform:
         transform_id: "transform-from-aliases-failures"
         body: >
@@ -410,7 +410,7 @@ setup:
         name: dest-index
 
   - do:
-      catch: /Destination index \[dest-index\] should refer to a single index/
+      catch: /.*reason=Validation Failed.* no write index is defined for alias [dest2-index].*/
       transform.put_transform:
         transform_id: "airline-transform"
         body: >
@@ -521,7 +521,7 @@ setup:
 ---
 "Test invalid destination index name":
   - do:
-      catch: /dest\.index \[DeStInAtIoN\] must be lowercase/
+      catch: /.*reason=Validation Failed.* Destination index \[DeStInAtIoN\] must be lowercase/
       transform.put_transform:
         transform_id: "airline-transform"
         body: >
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_update.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_update.yml
index 5b054a27fa38a..f55fcd2cb07e5 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_update.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_update.yml
@@ -67,7 +67,7 @@ setup:
 ---
 "Test put transform with invalid source index":
   - do:
-      catch: /Source index \[missing-index\] does not exist/
+      catch: /.*reason=Validation Failed.* no such index \[missing-index\]/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
@@ -255,7 +255,7 @@ setup:
         name: source2-index
 
   - do:
-      catch: /Destination index \[created-destination-index\] is included in source expression \[created-destination-index\]/
+      catch: /.*reason=Validation Failed.* Destination index \[created-destination-index\] is included in source expression \[created-destination-index\]/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
@@ -280,7 +280,7 @@ setup:
         index: created-destination-index
         name: dest2-index
   - do:
-      catch: /Destination index \[dest2-index\] should refer to a single index/
+      catch: /.*reason=Validation Failed.* no write index is defined for alias [dest2-index].*/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
@@ -290,7 +290,7 @@ setup:
 ---
 "Test invalid destination index name":
   - do:
-      catch: /dest\.index \[DeStInAtIoN\] must be lowercase/
+      catch: /.*reason=Validation Failed.* Destination index \[DeStInAtIoN\] must be lowercase/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
@@ -298,7 +298,7 @@ setup:
             "dest": { "index": "DeStInAtIoN" }
           }
   - do:
-      catch: /Invalid index name \[destination#dest\], must not contain \'#\'/
+      catch: /.*reason=Validation Failed.* Invalid index name \[destination#dest\], must not contain \'#\'/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPreviewTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPreviewTransformAction.java
index 7ee6ab5a05e0f..5ae62d0890ea9 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPreviewTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPreviewTransformAction.java
@@ -16,29 +16,33 @@
 import org.elasticsearch.action.search.SearchAction;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.HandledTransportAction;
-import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.inject.Inject;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
+import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
+import org.elasticsearch.license.RemoteClusterLicenseChecker;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.search.aggregations.Aggregations;
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeAggregation;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.RemoteClusterService;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.XPackField;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.transform.TransformField;
 import org.elasticsearch.xpack.core.transform.TransformMessages;
 import org.elasticsearch.xpack.core.transform.action.PreviewTransformAction;
@@ -65,34 +69,62 @@ public class TransportPreviewTransformAction extends
     private final XPackLicenseState licenseState;
     private final Client client;
     private final ThreadPool threadPool;
-    private final IndexNameExpressionResolver indexNameExpressionResolver;
     private final ClusterService clusterService;
+    private final SourceDestValidator sourceDestValidator;
 
     @Inject
-    public TransportPreviewTransformAction(TransportService transportService, ActionFilters actionFilters,
-                                                    Client client, ThreadPool threadPool, XPackLicenseState licenseState,
-                                                    IndexNameExpressionResolver indexNameExpressionResolver,
-                                                    ClusterService clusterService) {
-        this(PreviewTransformAction.NAME,transportService, actionFilters, client, threadPool, licenseState, indexNameExpressionResolver,
-             clusterService);
+    public TransportPreviewTransformAction(
+        TransportService transportService,
+        ActionFilters actionFilters,
+        Client client,
+        ThreadPool threadPool,
+        XPackLicenseState licenseState,
+        IndexNameExpressionResolver indexNameExpressionResolver,
+        ClusterService clusterService,
+        Settings settings
+    ) {
+        this(
+            PreviewTransformAction.NAME,
+            transportService,
+            actionFilters,
+            client,
+            threadPool,
+            licenseState,
+            indexNameExpressionResolver,
+            clusterService,
+            settings
+        );
     }
 
-    protected TransportPreviewTransformAction(String name, TransportService transportService, ActionFilters actionFilters,
-                                              Client client, ThreadPool threadPool, XPackLicenseState licenseState,
-                                              IndexNameExpressionResolver indexNameExpressionResolver,
-                                              ClusterService clusterService) {
+    protected TransportPreviewTransformAction(
+        String name,
+        TransportService transportService,
+        ActionFilters actionFilters,
+        Client client,
+        ThreadPool threadPool,
+        XPackLicenseState licenseState,
+        IndexNameExpressionResolver indexNameExpressionResolver,
+        ClusterService clusterService,
+        Settings settings
+    ) {
         super(name, transportService, actionFilters, PreviewTransformAction.Request::new);
         this.licenseState = licenseState;
         this.client = client;
         this.threadPool = threadPool;
         this.clusterService = clusterService;
-        this.indexNameExpressionResolver = indexNameExpressionResolver;
+        this.sourceDestValidator = new SourceDestValidator(
+            indexNameExpressionResolver,
+            transportService.getRemoteClusterService(),
+            RemoteClusterService.ENABLE_REMOTE_CLUSTERS.get(settings)
+                ? new RemoteClusterLicenseChecker(client, XPackLicenseState::isTransformAllowedForOperationMode)
+                : null,
+            clusterService.getNodeName(),
+            License.OperationMode.BASIC.description()
+        );
     }
 
     @Override
-    protected void doExecute(Task task,
-                             PreviewTransformAction.Request request,
-                             ActionListener<PreviewTransformAction.Response> listener) {
+    protected void doExecute(Task task, PreviewTransformAction.Request request, ActionListener<PreviewTransformAction.Response> listener) {
         if (!licenseState.isTransformAllowed()) {
             listener.onFailure(LicenseUtils.newComplianceException(XPackField.TRANSFORM));
             return;
@@ -101,120 +133,121 @@ protected void doExecute(Task task,
         ClusterState clusterState = clusterService.state();
 
         final TransformConfig config = request.getConfig();
-        for(String src : config.getSource().getIndex()) {
-            String[] concreteNames = indexNameExpressionResolver.concreteIndexNames(clusterState, IndicesOptions.lenientExpandOpen(), src);
-            if (concreteNames.length == 0) {
-                listener.onFailure(new ElasticsearchStatusException(
-                    TransformMessages.getMessage(TransformMessages.REST_PUT_TRANSFORM_SOURCE_INDEX_MISSING, src),
-                    RestStatus.BAD_REQUEST));
-                return;
-            }
-        }
 
-        Pivot pivot = new Pivot(config.getPivotConfig());
-        try {
-            pivot.validateConfig();
-        } catch (ElasticsearchStatusException e) {
-            listener.onFailure(
-                new ElasticsearchStatusException(TransformMessages.REST_PUT_TRANSFORM_FAILED_TO_VALIDATE_CONFIGURATION,
-                    e.status(),
-                    e));
-            return;
-        } catch (Exception e) {
-            listener.onFailure(new ElasticsearchStatusException(
-                TransformMessages.REST_PUT_TRANSFORM_FAILED_TO_VALIDATE_CONFIGURATION, RestStatus.INTERNAL_SERVER_ERROR, e));
-            return;
-        }
+        sourceDestValidator.validate(
+            clusterState,
+            config.getSource().getIndex(),
+            config.getDestination().getIndex(),
+            SourceDestValidator.PREVIEW_VALIDATIONS,
+            ActionListener.wrap(r -> {
+
+                Pivot pivot = new Pivot(config.getPivotConfig());
+                try {
+                    pivot.validateConfig();
+                } catch (ElasticsearchStatusException e) {
+                    listener.onFailure(
+                        new ElasticsearchStatusException(
+                            TransformMessages.REST_PUT_TRANSFORM_FAILED_TO_VALIDATE_CONFIGURATION,
+                            e.status(),
+                            e
+                        )
+                    );
+                    return;
+                } catch (Exception e) {
+                    listener.onFailure(
+                        new ElasticsearchStatusException(
+                            TransformMessages.REST_PUT_TRANSFORM_FAILED_TO_VALIDATE_CONFIGURATION,
+                            RestStatus.INTERNAL_SERVER_ERROR,
+                            e
+                        )
+                    );
+                    return;
+                }
+
+                getPreview(pivot, config.getSource(), config.getDestination().getPipeline(), config.getDestination().getIndex(), listener);
 
-        getPreview(pivot, config.getSource(), config.getDestination().getPipeline(), config.getDestination().getIndex(), listener);
+            }, listener::onFailure)
+        );
     }
 
     @SuppressWarnings("unchecked")
-    private void getPreview(Pivot pivot,
-                            SourceConfig source,
-                            String pipeline,
-                            String dest,
-                            ActionListener<PreviewTransformAction.Response> listener) {
+    private void getPreview(
+        Pivot pivot,
+        SourceConfig source,
+        String pipeline,
+        String dest,
+        ActionListener<PreviewTransformAction.Response> listener
+    ) {
         final PreviewTransformAction.Response previewResponse = new PreviewTransformAction.Response();
-        ActionListener<SimulatePipelineResponse> pipelineResponseActionListener = ActionListener.wrap(
-            simulatePipelineResponse -> {
-                List<Map<String, Object>> response = new ArrayList<>(simulatePipelineResponse.getResults().size());
-                for(var simulateDocumentResult : simulatePipelineResponse.getResults()) {
-                    try(XContentBuilder xContentBuilder = XContentFactory.jsonBuilder()) {
-                        XContentBuilder content = simulateDocumentResult.toXContent(xContentBuilder, ToXContent.EMPTY_PARAMS);
-                        Map<String, Object> tempMap = XContentHelper.convertToMap(BytesReference.bytes(content),
-                            true,
-                            XContentType.JSON).v2();
-                        response.add((Map<String, Object>)XContentMapValues.extractValue("doc._source", tempMap));
-                    }
+        ActionListener<SimulatePipelineResponse> pipelineResponseActionListener = ActionListener.wrap(simulatePipelineResponse -> {
+            List<Map<String, Object>> response = new ArrayList<>(simulatePipelineResponse.getResults().size());
+            for (var simulateDocumentResult : simulatePipelineResponse.getResults()) {
+                try (XContentBuilder xContentBuilder = XContentFactory.jsonBuilder()) {
+                    XContentBuilder content = simulateDocumentResult.toXContent(xContentBuilder, ToXContent.EMPTY_PARAMS);
+                    Map<String, Object> tempMap = XContentHelper.convertToMap(BytesReference.bytes(content), true, XContentType.JSON).v2();
+                    response.add((Map<String, Object>) XContentMapValues.extractValue("doc._source", tempMap));
                 }
-                previewResponse.setDocs(response);
-                listener.onResponse(previewResponse);
-            },
-            listener::onFailure
-        );
-        pivot.deduceMappings(client, source, ActionListener.wrap(
-            deducedMappings -> {
-                previewResponse.setMappingsFromStringMap(deducedMappings);
-                ClientHelper.executeWithHeadersAsync(threadPool.getThreadContext().getHeaders(),
-                    ClientHelper.TRANSFORM_ORIGIN,
-                    client,
-                    SearchAction.INSTANCE,
-                    pivot.buildSearchRequest(source, null, NUMBER_OF_PREVIEW_BUCKETS),
-                    ActionListener.wrap(
-                        r -> {
-                            try {
-                                final Aggregations aggregations = r.getAggregations();
-                                if (aggregations == null) {
-                                    listener.onFailure(
-                                        new ElasticsearchStatusException("Source indices have been deleted or closed.",
-                                            RestStatus.BAD_REQUEST)
-                                    );
-                                    return;
-                                }
-                                final CompositeAggregation agg = aggregations.get(COMPOSITE_AGGREGATION_NAME);
-                                TransformIndexerStats stats = new TransformIndexerStats();
-                                // remove all internal fields
-
-                                if (pipeline == null) {
-                                    List<Map<String, Object>> results = pivot.extractResults(agg, deducedMappings, stats)
-                                        .peek(doc -> doc.keySet().removeIf(k -> k.startsWith("_")))
-                                        .collect(Collectors.toList());
-                                    previewResponse.setDocs(results);
-                                    listener.onResponse(previewResponse);
-                                } else {
-                                    List<Map<String, Object>> results = pivot.extractResults(agg, deducedMappings, stats)
-                                        .map(doc -> {
-                                            Map<String, Object> src = new HashMap<>();
-                                            String id = (String) doc.get(TransformField.DOCUMENT_ID_FIELD);
-                                            doc.keySet().removeIf(k -> k.startsWith("_"));
-                                            src.put("_source", doc);
-                                            src.put("_id", id);
-                                            src.put("_index", dest);
-                                            return src;
-                                        }).collect(Collectors.toList());
-                                    try (XContentBuilder builder = jsonBuilder()) {
-                                        builder.startObject();
-                                        builder.field("docs", results);
-                                        builder.endObject();
-                                        var pipelineRequest = new SimulatePipelineRequest(BytesReference.bytes(builder), XContentType.JSON);
-                                        pipelineRequest.setId(pipeline);
-                                        ClientHelper.executeAsyncWithOrigin(client,
-                                            ClientHelper.TRANSFORM_ORIGIN,
-                                            SimulatePipelineAction.INSTANCE,
-                                            pipelineRequest,
-                                            pipelineResponseActionListener);
-                                    }
-                                }
-                            } catch (AggregationResultUtils.AggregationExtractionException extractionException) {
-                                listener.onFailure(
-                                        new ElasticsearchStatusException(extractionException.getMessage(), RestStatus.BAD_REQUEST));
+            }
+            previewResponse.setDocs(response);
+            listener.onResponse(previewResponse);
+        }, listener::onFailure);
+        pivot.deduceMappings(client, source, ActionListener.wrap(deducedMappings -> {
+            previewResponse.setMappingsFromStringMap(deducedMappings);
+            ClientHelper.executeWithHeadersAsync(
+                threadPool.getThreadContext().getHeaders(),
+                ClientHelper.TRANSFORM_ORIGIN,
+                client,
+                SearchAction.INSTANCE,
+                pivot.buildSearchRequest(source, null, NUMBER_OF_PREVIEW_BUCKETS),
+                ActionListener.wrap(r -> {
+                    try {
+                        final Aggregations aggregations = r.getAggregations();
+                        if (aggregations == null) {
+                            listener.onFailure(
+                                new ElasticsearchStatusException("Source indices have been deleted or closed.", RestStatus.BAD_REQUEST)
+                            );
+                            return;
+                        }
+                        final CompositeAggregation agg = aggregations.get(COMPOSITE_AGGREGATION_NAME);
+                        TransformIndexerStats stats = new TransformIndexerStats();
+                        // remove all internal fields
+
+                        if (pipeline == null) {
+                            List<Map<String, Object>> results = pivot.extractResults(agg, deducedMappings, stats)
+                                .peek(doc -> doc.keySet().removeIf(k -> k.startsWith("_")))
+                                .collect(Collectors.toList());
+                            previewResponse.setDocs(results);
+                            listener.onResponse(previewResponse);
+                        } else {
+                            List<Map<String, Object>> results = pivot.extractResults(agg, deducedMappings, stats).map(doc -> {
+                                Map<String, Object> src = new HashMap<>();
+                                String id = (String) doc.get(TransformField.DOCUMENT_ID_FIELD);
+                                doc.keySet().removeIf(k -> k.startsWith("_"));
+                                src.put("_source", doc);
+                                src.put("_id", id);
+                                src.put("_index", dest);
+                                return src;
+                            }).collect(Collectors.toList());
+                            try (XContentBuilder builder = jsonBuilder()) {
+                                builder.startObject();
+                                builder.field("docs", results);
+                                builder.endObject();
+                                var pipelineRequest = new SimulatePipelineRequest(BytesReference.bytes(builder), XContentType.JSON);
+                                pipelineRequest.setId(pipeline);
+                                ClientHelper.executeAsyncWithOrigin(
+                                    client,
+                                    ClientHelper.TRANSFORM_ORIGIN,
+                                    SimulatePipelineAction.INSTANCE,
+                                    pipelineRequest,
+                                    pipelineResponseActionListener
+                                );
                             }
-                        },
-                        listener::onFailure
-                    ));
-            },
-            listener::onFailure
-        ));
+                        }
+                    } catch (AggregationResultUtils.AggregationExtractionException extractionException) {
+                        listener.onFailure(new ElasticsearchStatusException(extractionException.getMessage(), RestStatus.BAD_REQUEST));
+                    }
+                }, listener::onFailure)
+            );
+        }, listener::onFailure));
     }
 }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
index 615fff1d54188..856ac77a801ab 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
@@ -26,17 +26,21 @@
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
+import org.elasticsearch.license.RemoteClusterLicenseChecker;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.persistent.PersistentTasksCustomMetaData;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.RemoteClusterService;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.XPackField;
 import org.elasticsearch.xpack.core.XPackPlugin;
 import org.elasticsearch.xpack.core.XPackSettings;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.security.SecurityContext;
 import org.elasticsearch.xpack.core.security.action.user.HasPrivilegesAction;
 import org.elasticsearch.xpack.core.security.action.user.HasPrivilegesRequest;
@@ -51,7 +55,6 @@
 import org.elasticsearch.xpack.transform.TransformServices;
 import org.elasticsearch.xpack.transform.notifications.TransformAuditor;
 import org.elasticsearch.xpack.transform.persistence.TransformConfigManager;
-import org.elasticsearch.xpack.transform.transforms.SourceDestValidator;
 import org.elasticsearch.xpack.transform.transforms.pivot.Pivot;
 
 import java.io.IOException;
@@ -70,6 +73,7 @@ public class TransportPutTransformAction extends TransportMasterNodeAction<Reque
     private final TransformConfigManager transformConfigManager;
     private final SecurityContext securityContext;
     private final TransformAuditor auditor;
+    private final SourceDestValidator sourceDestValidator;
 
     @Inject
     public TransportPutTransformAction(
@@ -125,6 +129,15 @@ protected TransportPutTransformAction(
             ? new SecurityContext(settings, threadPool.getThreadContext())
             : null;
         this.auditor = transformServices.getAuditor();
+        this.sourceDestValidator = new SourceDestValidator(
+            indexNameExpressionResolver,
+            transportService.getRemoteClusterService(),
+            RemoteClusterService.ENABLE_REMOTE_CLUSTERS.get(settings)
+                ? new RemoteClusterLicenseChecker(client, XPackLicenseState::isTransformAllowedForOperationMode)
+                : null,
+            clusterService.getNodeName(),
+            License.OperationMode.BASIC.description()
+        );
     }
 
     static HasPrivilegesRequest buildPrivilegeCheck(
@@ -208,26 +221,31 @@ protected void masterOperation(Task task, Request request, ClusterState clusterS
             );
             return;
         }
-        try {
-            SourceDestValidator.validate(config, clusterState, indexNameExpressionResolver, request.isDeferValidation());
-        } catch (ElasticsearchStatusException ex) {
-            listener.onFailure(ex);
-            return;
-        }
 
-        // Early check to verify that the user can create the destination index and can read from the source
-        if (licenseState.isAuthAllowed() && request.isDeferValidation() == false) {
-            final String username = securityContext.getUser().principal();
-            HasPrivilegesRequest privRequest = buildPrivilegeCheck(config, indexNameExpressionResolver, clusterState, username);
-            ActionListener<HasPrivilegesResponse> privResponseListener = ActionListener.wrap(
-                r -> handlePrivsResponse(username, request, r, listener),
-                listener::onFailure
-            );
+        sourceDestValidator.validate(
+            clusterState,
+            config.getSource().getIndex(),
+            config.getDestination().getIndex(),
+            request.isDeferValidation() ? SourceDestValidator.NON_DEFERABLE_VALIDATIONS : SourceDestValidator.ALL_VALIDATIONS,
+            ActionListener.wrap(
+                validationResponse -> {
+                    // Early check to verify that the user can create the destination index and can read from the source
+                    if (licenseState.isAuthAllowed() && request.isDeferValidation() == false) {
+                        final String username = securityContext.getUser().principal();
+                        HasPrivilegesRequest privRequest = buildPrivilegeCheck(config, indexNameExpressionResolver, clusterState, username);
+                        ActionListener<HasPrivilegesResponse> privResponseListener = ActionListener.wrap(
+                            r -> handlePrivsResponse(username, request, r, listener),
+                            listener::onFailure
+                        );
 
-            client.execute(HasPrivilegesAction.INSTANCE, privRequest, privResponseListener);
-        } else { // No security enabled, just create the transform
-            putTransform(request, listener);
-        }
+                        client.execute(HasPrivilegesAction.INSTANCE, privRequest, privResponseListener);
+                    } else { // No security enabled, just create the transform
+                        putTransform(request, listener);
+                    }
+                },
+                listener::onFailure
+            )
+        );
     }
 
     @Override
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
index 6e9e65fd3a712..f18c0712575e7 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
@@ -24,17 +24,22 @@
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
+import org.elasticsearch.license.RemoteClusterLicenseChecker;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.persistent.PersistentTasksCustomMetaData;
 import org.elasticsearch.persistent.PersistentTasksService;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.RemoteClusterService;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.XPackField;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.transform.TransformMessages;
 import org.elasticsearch.xpack.core.transform.action.StartTransformAction;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
@@ -45,7 +50,6 @@
 import org.elasticsearch.xpack.transform.notifications.TransformAuditor;
 import org.elasticsearch.xpack.transform.persistence.TransformConfigManager;
 import org.elasticsearch.xpack.transform.persistence.TransformIndex;
-import org.elasticsearch.xpack.transform.transforms.SourceDestValidator;
 import org.elasticsearch.xpack.transform.transforms.pivot.Pivot;
 
 import java.io.IOException;
@@ -66,6 +70,7 @@ public class TransportStartTransformAction extends TransportMasterNodeAction<Sta
     private final PersistentTasksService persistentTasksService;
     private final Client client;
     private final TransformAuditor auditor;
+    private final SourceDestValidator sourceDestValidator;
 
     @Inject
     public TransportStartTransformAction(
@@ -77,7 +82,8 @@ public TransportStartTransformAction(
         IndexNameExpressionResolver indexNameExpressionResolver,
         TransformServices transformServices,
         PersistentTasksService persistentTasksService,
-        Client client
+        Client client,
+        Settings settings
     ) {
         this(
             StartTransformAction.NAME,
@@ -89,7 +95,8 @@ public TransportStartTransformAction(
             indexNameExpressionResolver,
             transformServices,
             persistentTasksService,
-            client
+            client,
+            settings
         );
     }
 
@@ -103,7 +110,8 @@ protected TransportStartTransformAction(
         IndexNameExpressionResolver indexNameExpressionResolver,
         TransformServices transformServices,
         PersistentTasksService persistentTasksService,
-        Client client
+        Client client,
+        Settings settings
     ) {
         super(
             name,
@@ -119,6 +127,15 @@ protected TransportStartTransformAction(
         this.persistentTasksService = persistentTasksService;
         this.client = client;
         this.auditor = transformServices.getAuditor();
+        this.sourceDestValidator = new SourceDestValidator(
+            indexNameExpressionResolver,
+            transportService.getRemoteClusterService(),
+            RemoteClusterService.ENABLE_REMOTE_CLUSTERS.get(settings)
+                ? new RemoteClusterLicenseChecker(client, XPackLicenseState::isTransformAllowedForOperationMode)
+                : null,
+            clusterService.getNodeName(),
+            License.OperationMode.BASIC.description()
+        );
     }
 
     @Override
@@ -143,8 +160,9 @@ protected void masterOperation(
             return;
         }
         final AtomicReference<TransformTaskParams> transformTaskHolder = new AtomicReference<>();
+        final AtomicReference<TransformConfig> transformConfigHolder = new AtomicReference<>();
 
-        // <4> Wait for the allocated task's state to STARTED
+        // <5> Wait for the allocated task's state to STARTED
         ActionListener<PersistentTasksCustomMetaData.PersistentTask<TransformTaskParams>> newPersistentTaskActionListener = ActionListener
             .wrap(task -> {
                 TransformTaskParams transformTask = transformTaskHolder.get();
@@ -157,7 +175,7 @@ protected void masterOperation(
                 );
             }, listener::onFailure);
 
-        // <3> Create the task in cluster state so that it will start executing on the node
+        // <4> Create the task in cluster state so that it will start executing on the node
         ActionListener<Void> createOrGetIndexListener = ActionListener.wrap(unused -> {
             TransformTaskParams transformTask = transformTaskHolder.get();
             assert transformTask != null;
@@ -194,26 +212,13 @@ protected void masterOperation(
         }, listener::onFailure);
 
         // <2> If the destination index exists, start the task, otherwise deduce our mappings for the destination index and create it
-        ActionListener<TransformConfig> getTransformListener = ActionListener.wrap(config -> {
-            if (config.isValid() == false) {
-                listener.onFailure(
-                    new ElasticsearchStatusException(
-                        TransformMessages.getMessage(TransformMessages.TRANSFORM_CONFIG_INVALID, request.getId()),
-                        RestStatus.BAD_REQUEST
-                    )
-                );
-                return;
-            }
-            // Validate source and destination indices
-            SourceDestValidator.validate(config, clusterService.state(), indexNameExpressionResolver, false);
-
-            transformTaskHolder.set(createTransform(config.getId(), config.getVersion(), config.getFrequency()));
-            final String destinationIndex = config.getDestination().getIndex();
+        ActionListener<Boolean> validationListener = ActionListener.wrap(validationResponse -> {
+            final String destinationIndex = transformConfigHolder.get().getDestination().getIndex();
             String[] dest = indexNameExpressionResolver.concreteIndexNames(state, IndicesOptions.lenientExpandOpen(), destinationIndex);
 
             if (dest.length == 0) {
                 auditor.info(request.getId(), "Creating destination index [" + destinationIndex + "] with deduced mappings.");
-                createDestinationIndex(config, createOrGetIndexListener);
+                createDestinationIndex(transformConfigHolder.get(), createOrGetIndexListener);
             } else {
                 auditor.info(request.getId(), "Using existing destination index [" + destinationIndex + "].");
                 ClientHelper.executeAsyncWithOrigin(
@@ -240,6 +245,29 @@ protected void masterOperation(
             }
         }, listener::onFailure);
 
+        // <2> run transform validations
+        ActionListener<TransformConfig> getTransformListener = ActionListener.wrap(config -> {
+            if (config.isValid() == false) {
+                listener.onFailure(
+                    new ElasticsearchStatusException(
+                        TransformMessages.getMessage(TransformMessages.TRANSFORM_CONFIG_INVALID, request.getId()),
+                        RestStatus.BAD_REQUEST
+                    )
+                );
+                return;
+            }
+            transformTaskHolder.set(createTransform(config.getId(), config.getVersion(), config.getFrequency()));
+            transformConfigHolder.set(config);
+
+            sourceDestValidator.validate(
+                clusterService.state(),
+                config.getSource().getIndex(),
+                config.getDestination().getIndex(),
+                SourceDestValidator.ALL_VALIDATIONS,
+                validationListener
+            );
+        }, listener::onFailure);
+
         // <1> Get the config to verify it exists and is valid
         transformConfigManager.getTransformConfiguration(request.getId(), getTransformListener);
     }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportUpdateTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportUpdateTransformAction.java
index 81526bafc933c..e98360fb453ca 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportUpdateTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportUpdateTransformAction.java
@@ -23,17 +23,21 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.logging.LoggerMessageFormat;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
+import org.elasticsearch.license.RemoteClusterLicenseChecker;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.persistent.PersistentTasksCustomMetaData;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.RemoteClusterService;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.XPackField;
 import org.elasticsearch.xpack.core.XPackPlugin;
 import org.elasticsearch.xpack.core.XPackSettings;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.security.SecurityContext;
 import org.elasticsearch.xpack.core.security.action.user.HasPrivilegesAction;
 import org.elasticsearch.xpack.core.security.action.user.HasPrivilegesRequest;
@@ -51,7 +55,6 @@
 import org.elasticsearch.xpack.transform.persistence.SeqNoPrimaryTermAndIndex;
 import org.elasticsearch.xpack.transform.persistence.TransformConfigManager;
 import org.elasticsearch.xpack.transform.persistence.TransformIndex;
-import org.elasticsearch.xpack.transform.transforms.SourceDestValidator;
 import org.elasticsearch.xpack.transform.transforms.pivot.Pivot;
 
 import java.io.IOException;
@@ -70,6 +73,7 @@ public class TransportUpdateTransformAction extends TransportMasterNodeAction<Re
     private final TransformConfigManager transformConfigManager;
     private final SecurityContext securityContext;
     private final TransformAuditor auditor;
+    private final SourceDestValidator sourceDestValidator;
 
     @Inject
     public TransportUpdateTransformAction(
@@ -117,6 +121,15 @@ protected TransportUpdateTransformAction(
             ? new SecurityContext(settings, threadPool.getThreadContext())
             : null;
         this.auditor = transformServices.getAuditor();
+        this.sourceDestValidator = new SourceDestValidator(
+            indexNameExpressionResolver,
+            transportService.getRemoteClusterService(),
+            RemoteClusterService.ENABLE_REMOTE_CLUSTERS.get(settings)
+                ? new RemoteClusterLicenseChecker(client, XPackLicenseState::isTransformAllowedForOperationMode)
+                : null,
+            clusterService.getNodeName(),
+            License.OperationMode.BASIC.description()
+        );
     }
 
     @Override
@@ -160,7 +173,19 @@ protected void masterOperation(Task task, Request request, ClusterState clusterS
                 return;
             }
             TransformConfig updatedConfig = update.apply(config);
-            validateAndUpdateTransform(request, clusterState, updatedConfig, configAndVersion.v2(), listener);
+            sourceDestValidator.validate(
+                clusterState,
+                updatedConfig.getSource().getIndex(),
+                updatedConfig.getDestination().getIndex(),
+                request.isDeferValidation() ? SourceDestValidator.NON_DEFERABLE_VALIDATIONS : SourceDestValidator.ALL_VALIDATIONS,
+                ActionListener.wrap(
+                    validationResponse -> {
+                        checkPriviledgesAndUpdateTransform(request, clusterState, updatedConfig, configAndVersion.v2(), listener);
+                    },
+                    listener::onFailure
+                )
+            );
+
         }, listener::onFailure));
     }
 
@@ -197,20 +222,13 @@ private void handlePrivsResponse(
         }
     }
 
-    private void validateAndUpdateTransform(
+    private void checkPriviledgesAndUpdateTransform(
         Request request,
         ClusterState clusterState,
         TransformConfig config,
         SeqNoPrimaryTermAndIndex seqNoPrimaryTermAndIndex,
         ActionListener<Response> listener
     ) {
-        try {
-            SourceDestValidator.validate(config, clusterState, indexNameExpressionResolver, request.isDeferValidation());
-        } catch (ElasticsearchStatusException ex) {
-            listener.onFailure(ex);
-            return;
-        }
-
         // Early check to verify that the user can create the destination index and can read from the source
         if (licenseState.isAuthAllowed() && request.isDeferValidation() == false) {
             final String username = securityContext.getUser().principal();
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportPreviewTransformActionDeprecated.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportPreviewTransformActionDeprecated.java
index 8882fcf505b8b..d1ad8ac09f7f1 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportPreviewTransformActionDeprecated.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportPreviewTransformActionDeprecated.java
@@ -11,6 +11,7 @@
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
@@ -20,12 +21,27 @@
 public class TransportPreviewTransformActionDeprecated extends TransportPreviewTransformAction {
 
     @Inject
-    public TransportPreviewTransformActionDeprecated(TransportService transportService, ActionFilters actionFilters,
-                                                    Client client, ThreadPool threadPool, XPackLicenseState licenseState,
-                                                    IndexNameExpressionResolver indexNameExpressionResolver,
-                                                    ClusterService clusterService) {
-        super(PreviewTransformActionDeprecated.NAME, transportService, actionFilters, client, threadPool, licenseState,
-              indexNameExpressionResolver, clusterService);
+    public TransportPreviewTransformActionDeprecated(
+        TransportService transportService,
+        ActionFilters actionFilters,
+        Client client,
+        ThreadPool threadPool,
+        XPackLicenseState licenseState,
+        IndexNameExpressionResolver indexNameExpressionResolver,
+        ClusterService clusterService,
+        Settings settings
+    ) {
+        super(
+            PreviewTransformActionDeprecated.NAME,
+            transportService,
+            actionFilters,
+            client,
+            threadPool,
+            licenseState,
+            indexNameExpressionResolver,
+            clusterService,
+            settings
+        );
     }
 
 }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportStartTransformActionDeprecated.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportStartTransformActionDeprecated.java
index 17a996f760eb4..caef1b1edf1d3 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportStartTransformActionDeprecated.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportStartTransformActionDeprecated.java
@@ -11,6 +11,7 @@
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.persistent.PersistentTasksService;
 import org.elasticsearch.threadpool.ThreadPool;
@@ -31,7 +32,8 @@ public TransportStartTransformActionDeprecated(
         IndexNameExpressionResolver indexNameExpressionResolver,
         TransformServices transformServices,
         PersistentTasksService persistentTasksService,
-        Client client
+        Client client,
+        Settings settings
     ) {
         super(
             StartTransformActionDeprecated.NAME,
@@ -43,7 +45,8 @@ public TransportStartTransformActionDeprecated(
             indexNameExpressionResolver,
             transformServices,
             persistentTasksService,
-            client
+            client,
+            settings
         );
     }
 }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/SourceDestValidator.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/SourceDestValidator.java
deleted file mode 100644
index 8c89ffd6d5f55..0000000000000
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/SourceDestValidator.java
+++ /dev/null
@@ -1,159 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-
-package org.elasticsearch.xpack.transform.transforms;
-
-import org.elasticsearch.ElasticsearchStatusException;
-import org.elasticsearch.action.support.IndicesOptions;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.regex.Regex;
-import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.xpack.core.transform.TransformMessages;
-import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
-
-import java.util.Arrays;
-import java.util.HashSet;
-import java.util.List;
-import java.util.Set;
-
-/**
- * This class contains more complex validations in regards to how {@link TransformConfig#getSource()} and
- * {@link TransformConfig#getDestination()} relate to each other.
- */
-public final class SourceDestValidator {
-
-    interface SourceDestValidation {
-        boolean isDeferrable();
-        void validate(TransformConfig config, ClusterState clusterState, IndexNameExpressionResolver indexNameExpressionResolver);
-    }
-
-    private static final List<SourceDestValidation> VALIDATIONS = Arrays.asList(new SourceMissingValidation(),
-        new DestinationInSourceValidation(),
-        new DestinationSingleIndexValidation());
-
-    /**
-     * Validates the DataFrameTransformConfiguration source and destination indices.
-     *
-     * A simple name validation is done on {@link TransformConfig#getDestination()} inside
-     * {@link org.elasticsearch.xpack.core.transform.action.PutTransformAction}
-     *
-     * So, no need to do the name checks here.
-     *
-     * @param config DataFrameTransformConfig to validate
-     * @param clusterState The current ClusterState
-     * @param indexNameExpressionResolver A valid IndexNameExpressionResolver object
-     * @throws ElasticsearchStatusException when a validation fails
-     */
-    public static void validate(TransformConfig config,
-                                ClusterState clusterState,
-                                IndexNameExpressionResolver indexNameExpressionResolver,
-                                boolean shouldDefer) {
-        for (SourceDestValidation validation : VALIDATIONS) {
-            if (shouldDefer && validation.isDeferrable()) {
-                continue;
-            }
-            validation.validate(config, clusterState, indexNameExpressionResolver);
-        }
-    }
-
-    static class SourceMissingValidation implements SourceDestValidation {
-
-        @Override
-        public boolean isDeferrable() {
-            return true;
-        }
-
-        @Override
-        public void validate(TransformConfig config,
-                             ClusterState clusterState,
-                             IndexNameExpressionResolver indexNameExpressionResolver) {
-            for(String src : config.getSource().getIndex()) {
-                String[] concreteNames = indexNameExpressionResolver.concreteIndexNames(clusterState,
-                    IndicesOptions.lenientExpandOpen(),
-                    src);
-                if (concreteNames.length == 0) {
-                    throw new ElasticsearchStatusException(
-                        TransformMessages.getMessage(TransformMessages.REST_PUT_TRANSFORM_SOURCE_INDEX_MISSING, src),
-                        RestStatus.BAD_REQUEST);
-                }
-            }
-        }
-    }
-
-    static class DestinationInSourceValidation implements SourceDestValidation {
-
-        @Override
-        public boolean isDeferrable() {
-            return true;
-        }
-
-        @Override
-        public void validate(TransformConfig config,
-                             ClusterState clusterState,
-                             IndexNameExpressionResolver indexNameExpressionResolver) {
-            final String destIndex = config.getDestination().getIndex();
-            Set<String> concreteSourceIndexNames = new HashSet<>();
-            for(String src : config.getSource().getIndex()) {
-                String[] concreteNames = indexNameExpressionResolver.concreteIndexNames(clusterState,
-                    IndicesOptions.lenientExpandOpen(),
-                    src);
-                if (Regex.simpleMatch(src, destIndex)) {
-                    throw new ElasticsearchStatusException(
-                        TransformMessages.getMessage(TransformMessages.REST_PUT_TRANSFORM_DEST_IN_SOURCE, destIndex, src),
-                        RestStatus.BAD_REQUEST);
-                }
-                concreteSourceIndexNames.addAll(Arrays.asList(concreteNames));
-            }
-
-            if (concreteSourceIndexNames.contains(destIndex)) {
-                throw new ElasticsearchStatusException(
-                    TransformMessages.getMessage(TransformMessages.REST_PUT_TRANSFORM_DEST_IN_SOURCE,
-                        destIndex,
-                        Strings.arrayToCommaDelimitedString(config.getSource().getIndex())),
-                    RestStatus.BAD_REQUEST
-                );
-            }
-
-            final String[] concreteDest = indexNameExpressionResolver.concreteIndexNames(clusterState,
-                IndicesOptions.lenientExpandOpen(),
-                destIndex);
-            if (concreteDest.length > 0 && concreteSourceIndexNames.contains(concreteDest[0])) {
-                throw new ElasticsearchStatusException(
-                    TransformMessages.getMessage(TransformMessages.REST_PUT_TRANSFORM_DEST_IN_SOURCE,
-                        concreteDest[0],
-                        Strings.arrayToCommaDelimitedString(concreteSourceIndexNames.toArray(new String[0]))),
-                    RestStatus.BAD_REQUEST
-                );
-            }
-        }
-    }
-
-    static class DestinationSingleIndexValidation implements SourceDestValidation {
-
-        @Override
-        public boolean isDeferrable() {
-            return false;
-        }
-
-        @Override
-        public void validate(TransformConfig config,
-                             ClusterState clusterState,
-                             IndexNameExpressionResolver indexNameExpressionResolver) {
-            final String destIndex = config.getDestination().getIndex();
-            final String[] concreteDest =
-                indexNameExpressionResolver.concreteIndexNames(clusterState, IndicesOptions.lenientExpandOpen(), destIndex);
-
-            if (concreteDest.length > 1) {
-                throw new ElasticsearchStatusException(
-                    TransformMessages.getMessage(TransformMessages.REST_PUT_TRANSFORM_DEST_SINGLE_INDEX, destIndex),
-                    RestStatus.BAD_REQUEST
-                );
-            }
-        }
-    }
-}
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/SourceDestValidatorTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/SourceDestValidatorTests.java
deleted file mode 100644
index add6a0c27b908..0000000000000
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/SourceDestValidatorTests.java
+++ /dev/null
@@ -1,160 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.transform.transforms;
-
-import org.elasticsearch.ElasticsearchStatusException;
-import org.elasticsearch.Version;
-import org.elasticsearch.cluster.ClusterName;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.metadata.AliasMetaData;
-import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
-import org.elasticsearch.cluster.metadata.MetaData;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
-import org.elasticsearch.xpack.core.transform.transforms.DestConfig;
-import org.elasticsearch.xpack.core.transform.transforms.SourceConfig;
-import org.elasticsearch.xpack.core.transform.transforms.pivot.PivotConfigTests;
-
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_CREATION_DATE;
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_REPLICAS;
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_VERSION_CREATED;
-import static org.hamcrest.Matchers.equalTo;
-
-public class SourceDestValidatorTests extends ESTestCase {
-
-    private static final String SOURCE_1 = "source-1";
-    private static final String SOURCE_2 = "source-2";
-    private static final String ALIASED_DEST = "aliased-dest";
-
-    private static final ClusterState CLUSTER_STATE;
-
-    static {
-        IndexMetaData source1 = IndexMetaData.builder(SOURCE_1).settings(Settings.builder()
-            .put(SETTING_VERSION_CREATED, Version.CURRENT)
-            .put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(SETTING_CREATION_DATE, System.currentTimeMillis()))
-            .putAlias(AliasMetaData.builder("source-1-alias").build())
-            .build();
-        IndexMetaData source2 = IndexMetaData.builder(SOURCE_2).settings(Settings.builder()
-            .put(SETTING_VERSION_CREATED, Version.CURRENT)
-            .put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(SETTING_CREATION_DATE, System.currentTimeMillis()))
-            .putAlias(AliasMetaData.builder("dest-alias").build())
-            .build();
-        IndexMetaData aliasedDest = IndexMetaData.builder(ALIASED_DEST).settings(Settings.builder()
-            .put(SETTING_VERSION_CREATED, Version.CURRENT)
-            .put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(SETTING_CREATION_DATE, System.currentTimeMillis()))
-            .putAlias(AliasMetaData.builder("dest-alias").build())
-            .build();
-        ClusterState.Builder state = ClusterState.builder(new ClusterName("test"));
-        state.metaData(MetaData.builder()
-            .put(IndexMetaData.builder(source1).build(), false)
-            .put(IndexMetaData.builder(source2).build(), false)
-            .put(IndexMetaData.builder(aliasedDest).build(), false));
-        CLUSTER_STATE = state.build();
-    }
-
-    public void testCheck_GivenSimpleSourceIndexAndValidDestIndex() {
-        TransformConfig config = createTransform(new SourceConfig(SOURCE_1), new DestConfig("dest", null));
-        SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), false);
-    }
-
-    public void testCheck_GivenMissingConcreteSourceIndex() {
-        TransformConfig config = createTransform(new SourceConfig("missing"), new DestConfig("dest", null));
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), false));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Source index [missing] does not exist"));
-        SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), true);
-    }
-
-    public void testCheck_GivenMissingWildcardSourceIndex() {
-        TransformConfig config = createTransform(new SourceConfig("missing*"), new DestConfig("dest", null));
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), false));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Source index [missing*] does not exist"));
-        SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), true);
-    }
-
-    public void testCheck_GivenDestIndexSameAsSourceIndex() {
-        TransformConfig config = createTransform(new SourceConfig(SOURCE_1), new DestConfig("source-1", null));
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), false));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Destination index [source-1] is included in source expression [source-1]"));
-        SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), true);
-    }
-
-    public void testCheck_GivenDestIndexMatchesSourceIndex() {
-        TransformConfig config = createTransform(new SourceConfig("source-*"), new DestConfig(SOURCE_2, null));
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), false));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Destination index [source-2] is included in source expression [source-*]"));
-        SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), true);
-    }
-
-    public void testCheck_GivenDestIndexMatchesOneOfSourceIndices() {
-        TransformConfig config = createTransform(new SourceConfig("source-1", "source-*"),
-            new DestConfig(SOURCE_2, null));
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), false));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Destination index [source-2] is included in source expression [source-*]"));
-        SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), true);
-    }
-
-    public void testCheck_GivenDestIndexIsAliasThatMatchesMultipleIndices() {
-        TransformConfig config = createTransform(new SourceConfig(SOURCE_1), new DestConfig("dest-alias", null));
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), false));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(),
-            equalTo("Destination index [dest-alias] should refer to a single index"));
-
-        e = expectThrows(ElasticsearchStatusException.class,
-            () -> SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), true));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(),
-            equalTo("Destination index [dest-alias] should refer to a single index"));
-    }
-
-    public void testCheck_GivenDestIndexIsAliasThatIsIncludedInSource() {
-        TransformConfig config = createTransform(new SourceConfig(SOURCE_1), new DestConfig("source-1-alias", null));
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), false));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(),
-            equalTo("Destination index [source-1] is included in source expression [source-1]"));
-
-        SourceDestValidator.validate(config, CLUSTER_STATE, new IndexNameExpressionResolver(), true);
-    }
-
-    private static TransformConfig createTransform(SourceConfig sourceConfig, DestConfig destConfig) {
-        return new TransformConfig("test",
-            sourceConfig,
-            destConfig,
-            TimeValue.timeValueSeconds(60),
-            null,
-            null,
-            PivotConfigTests.randomPivotConfig(),
-            null);
-    }
-}

From 822dec64daeac4fb96443e700267ca5762684363 Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Fri, 20 Dec 2019 08:28:16 +0100
Subject: [PATCH 293/686] [Transform] improve checkpoint reporting (#50369)

fixes empty checkpoints, re-factors checkpoint info creation (moves builder) and always reports
last change detection

relates #43201
relates #50018
---
 .../transforms/TransformCheckpoint.java       |  45 ++--
 .../TransformCheckpointingInfo.java           | 193 ++++++++++++++----
 .../transforms/TransformCheckpointTests.java  |  87 +++++---
 .../TransportGetTransformStatsAction.java     |   3 +-
 .../checkpoint/CheckpointProvider.java        |  26 ++-
 .../checkpoint/DefaultCheckpointProvider.java | 107 ++--------
 .../TransformCheckpointService.java           |   4 +-
 .../transform/transforms/TransformTask.java   |  24 ++-
 .../TransformCheckpointServiceNodeTests.java  |  46 ++++-
 9 files changed, 325 insertions(+), 210 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpoint.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpoint.java
index 8431abc886d85..da5c4e934a33a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpoint.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpoint.java
@@ -62,20 +62,19 @@ public class TransformCheckpoint implements Writeable, ToXContentObject {
     private final long timeUpperBoundMillis;
 
     private static ConstructingObjectParser<TransformCheckpoint, Void> createParser(boolean lenient) {
-        ConstructingObjectParser<TransformCheckpoint, Void> parser = new ConstructingObjectParser<>(NAME,
-                lenient, args -> {
-                    String id = (String) args[0];
-                    long timestamp = (Long) args[1];
-                    long checkpoint = (Long) args[2];
+        ConstructingObjectParser<TransformCheckpoint, Void> parser = new ConstructingObjectParser<>(NAME, lenient, args -> {
+            String id = (String) args[0];
+            long timestamp = (Long) args[1];
+            long checkpoint = (Long) args[2];
 
-                    @SuppressWarnings("unchecked")
-                    Map<String, long[]> checkpoints = (Map<String, long[]>) args[3];
+            @SuppressWarnings("unchecked")
+            Map<String, long[]> checkpoints = (Map<String, long[]>) args[3];
 
-                    Long timeUpperBound = (Long) args[4];
+            Long timeUpperBound = (Long) args[4];
 
-                    // ignored, only for internal storage: String docType = (String) args[5];
-                    return new TransformCheckpoint(id, timestamp, checkpoint, checkpoints, timeUpperBound);
-                });
+            // ignored, only for internal storage: String docType = (String) args[5];
+            return new TransformCheckpoint(id, timestamp, checkpoint, checkpoints, timeUpperBound);
+        });
 
         parser.declareString(constructorArg(), TransformField.ID);
 
@@ -83,7 +82,7 @@ private static ConstructingObjectParser<TransformCheckpoint, Void> createParser(
         parser.declareLong(constructorArg(), TransformField.TIMESTAMP_MILLIS);
         parser.declareLong(constructorArg(), CHECKPOINT);
 
-        parser.declareObject(constructorArg(), (p,c) -> {
+        parser.declareObject(constructorArg(), (p, c) -> {
             Map<String, long[]> checkPointsByIndexName = new TreeMap<>();
             XContentParser.Token token = null;
             while ((token = p.nextToken()) != XContentParser.Token.END_OBJECT) {
@@ -108,8 +107,7 @@ private static ConstructingObjectParser<TransformCheckpoint, Void> createParser(
         return parser;
     }
 
-    public TransformCheckpoint(String transformId, long timestamp, long checkpoint, Map<String, long[]> checkpoints,
-            Long timeUpperBound) {
+    public TransformCheckpoint(String transformId, long timestamp, long checkpoint, Map<String, long[]> checkpoints, Long timeUpperBound) {
         this.transformId = Objects.requireNonNull(transformId);
         this.timestampMillis = timestamp;
         this.checkpoint = checkpoint;
@@ -126,7 +124,7 @@ public TransformCheckpoint(StreamInput in) throws IOException {
     }
 
     public boolean isEmpty() {
-        return indicesCheckpoints.isEmpty();
+        return this.equals(EMPTY);
     }
 
     /**
@@ -212,8 +210,10 @@ public boolean equals(Object other) {
         final TransformCheckpoint that = (TransformCheckpoint) other;
 
         // compare the timestamp, id, checkpoint and than call matches for the rest
-        return this.timestampMillis == that.timestampMillis && this.checkpoint == that.checkpoint
-                && this.timeUpperBoundMillis == that.timeUpperBoundMillis && matches(that);
+        return this.timestampMillis == that.timestampMillis
+            && this.checkpoint == that.checkpoint
+            && this.timeUpperBoundMillis == that.timeUpperBoundMillis
+            && matches(that);
     }
 
     /**
@@ -224,7 +224,7 @@ public boolean equals(Object other) {
      * @param that other checkpoint
      * @return true if checkpoints match
      */
-    public boolean matches (TransformCheckpoint that) {
+    public boolean matches(TransformCheckpoint that) {
         if (this == that) {
             return true;
         }
@@ -258,7 +258,7 @@ public static String documentId(String transformId, long checkpoint) {
         return NAME + "-" + transformId + "-" + checkpoint;
     }
 
-    public static boolean isNullOrEmpty (TransformCheckpoint checkpoint) {
+    public static boolean isNullOrEmpty(TransformCheckpoint checkpoint) {
         return checkpoint == null || checkpoint.isEmpty();
     }
 
@@ -315,8 +315,11 @@ private static Map<String, long[]> readCheckpoints(Map<String, Object> readMap)
             if (e.getValue() instanceof long[]) {
                 checkpoints.put(e.getKey(), (long[]) e.getValue());
             } else {
-                throw new ElasticsearchParseException("expecting the checkpoints for [{}] to be a long[], but found [{}] instead",
-                        e.getKey(), e.getValue().getClass());
+                throw new ElasticsearchParseException(
+                    "expecting the checkpoints for [{}] to be a long[], but found [{}] instead",
+                    e.getKey(),
+                    e.getValue().getClass()
+                );
             }
         }
         return checkpoints;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpointingInfo.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpointingInfo.java
index b0f665b7b8075..8a2f04e1e82b0 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpointingInfo.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpointingInfo.java
@@ -31,11 +31,110 @@
  */
 public class TransformCheckpointingInfo implements Writeable, ToXContentObject {
 
+    /**
+     * Builder for collecting checkpointing information for the purpose of _stats
+     */
+    public static class TransformCheckpointingInfoBuilder {
+        private TransformIndexerPosition nextCheckpointPosition;
+        private TransformProgress nextCheckpointProgress;
+        private TransformCheckpoint lastCheckpoint;
+        private TransformCheckpoint nextCheckpoint;
+        private TransformCheckpoint sourceCheckpoint;
+        private Instant changesLastDetectedAt;
+        private long operationsBehind;
+
+        public TransformCheckpointingInfoBuilder() {}
+
+        public TransformCheckpointingInfo build() {
+            if (lastCheckpoint == null) {
+                lastCheckpoint = TransformCheckpoint.EMPTY;
+            }
+            if (nextCheckpoint == null) {
+                nextCheckpoint = TransformCheckpoint.EMPTY;
+            }
+            if (sourceCheckpoint == null) {
+                sourceCheckpoint = TransformCheckpoint.EMPTY;
+            }
+
+            // checkpointstats requires a non-negative checkpoint number
+            long lastCheckpointNumber = lastCheckpoint.getCheckpoint() > 0 ? lastCheckpoint.getCheckpoint() : 0;
+            long nextCheckpointNumber = nextCheckpoint.getCheckpoint() > 0 ? nextCheckpoint.getCheckpoint() : 0;
+
+            return new TransformCheckpointingInfo(
+                new TransformCheckpointStats(
+                    lastCheckpointNumber,
+                    null,
+                    null,
+                    lastCheckpoint.getTimestamp(),
+                    lastCheckpoint.getTimeUpperBound()
+                ),
+                new TransformCheckpointStats(
+                    nextCheckpointNumber,
+                    nextCheckpointPosition,
+                    nextCheckpointProgress,
+                    nextCheckpoint.getTimestamp(),
+                    nextCheckpoint.getTimeUpperBound()
+                ),
+                operationsBehind,
+                changesLastDetectedAt
+            );
+        }
+
+        public TransformCheckpointingInfoBuilder setLastCheckpoint(TransformCheckpoint lastCheckpoint) {
+            this.lastCheckpoint = lastCheckpoint;
+            return this;
+        }
+
+        public TransformCheckpoint getLastCheckpoint() {
+            return lastCheckpoint;
+        }
+
+        public TransformCheckpointingInfoBuilder setNextCheckpoint(TransformCheckpoint nextCheckpoint) {
+            this.nextCheckpoint = nextCheckpoint;
+            return this;
+        }
+
+        public TransformCheckpoint getNextCheckpoint() {
+            return nextCheckpoint;
+        }
+
+        public TransformCheckpointingInfoBuilder setSourceCheckpoint(TransformCheckpoint sourceCheckpoint) {
+            this.sourceCheckpoint = sourceCheckpoint;
+            return this;
+        }
+
+        public TransformCheckpoint getSourceCheckpoint() {
+            return sourceCheckpoint;
+        }
+
+        public TransformCheckpointingInfoBuilder setNextCheckpointProgress(TransformProgress nextCheckpointProgress) {
+            this.nextCheckpointProgress = nextCheckpointProgress;
+            return this;
+        }
+
+        public TransformCheckpointingInfoBuilder setNextCheckpointPosition(TransformIndexerPosition nextCheckpointPosition) {
+            this.nextCheckpointPosition = nextCheckpointPosition;
+            return this;
+        }
+
+        public TransformCheckpointingInfoBuilder setChangesLastDetectedAt(Instant changesLastDetectedAt) {
+            this.changesLastDetectedAt = changesLastDetectedAt;
+            return this;
+        }
+
+        public TransformCheckpointingInfoBuilder setOperationsBehind(long operationsBehind) {
+            this.operationsBehind = operationsBehind;
+            return this;
+        }
+
+    }
+
     public static final TransformCheckpointingInfo EMPTY = new TransformCheckpointingInfo(
         TransformCheckpointStats.EMPTY,
         TransformCheckpointStats.EMPTY,
         0L,
-        null);
+        null
+    );
 
     public static final ParseField LAST_CHECKPOINT = new ParseField("last");
     public static final ParseField NEXT_CHECKPOINT = new ParseField("next");
@@ -44,32 +143,41 @@ public class TransformCheckpointingInfo implements Writeable, ToXContentObject {
     private final TransformCheckpointStats last;
     private final TransformCheckpointStats next;
     private final long operationsBehind;
-    private Instant changesLastDetectedAt;
-
-    private static final ConstructingObjectParser<TransformCheckpointingInfo, Void> LENIENT_PARSER =
-            new ConstructingObjectParser<>(
-                "data_frame_transform_checkpointing_info",
-                true,
-                a -> {
-                        long behind = a[2] == null ? 0L : (Long) a[2];
-                        Instant changesLastDetectedAt = (Instant)a[3];
-                        return new TransformCheckpointingInfo(
-                            a[0] == null ? TransformCheckpointStats.EMPTY : (TransformCheckpointStats) a[0],
-                            a[1] == null ? TransformCheckpointStats.EMPTY : (TransformCheckpointStats) a[1],
-                            behind,
-                            changesLastDetectedAt);
-                });
+    private final Instant changesLastDetectedAt;
+
+    private static final ConstructingObjectParser<TransformCheckpointingInfo, Void> LENIENT_PARSER = new ConstructingObjectParser<>(
+        "data_frame_transform_checkpointing_info",
+        true,
+        a -> {
+            long behind = a[2] == null ? 0L : (Long) a[2];
+            Instant changesLastDetectedAt = (Instant) a[3];
+            return new TransformCheckpointingInfo(
+                a[0] == null ? TransformCheckpointStats.EMPTY : (TransformCheckpointStats) a[0],
+                a[1] == null ? TransformCheckpointStats.EMPTY : (TransformCheckpointStats) a[1],
+                behind,
+                changesLastDetectedAt
+            );
+        }
+    );
 
     static {
-        LENIENT_PARSER.declareObject(ConstructingObjectParser.optionalConstructorArg(),
-            TransformCheckpointStats.LENIENT_PARSER::apply, LAST_CHECKPOINT);
-        LENIENT_PARSER.declareObject(ConstructingObjectParser.optionalConstructorArg(),
-            TransformCheckpointStats.LENIENT_PARSER::apply, NEXT_CHECKPOINT);
+        LENIENT_PARSER.declareObject(
+            ConstructingObjectParser.optionalConstructorArg(),
+            TransformCheckpointStats.LENIENT_PARSER::apply,
+            LAST_CHECKPOINT
+        );
+        LENIENT_PARSER.declareObject(
+            ConstructingObjectParser.optionalConstructorArg(),
+            TransformCheckpointStats.LENIENT_PARSER::apply,
+            NEXT_CHECKPOINT
+        );
         LENIENT_PARSER.declareLong(ConstructingObjectParser.optionalConstructorArg(), OPERATIONS_BEHIND);
-        LENIENT_PARSER.declareField(ConstructingObjectParser.optionalConstructorArg(),
+        LENIENT_PARSER.declareField(
+            ConstructingObjectParser.optionalConstructorArg(),
             p -> TimeUtils.parseTimeFieldToInstant(p, CHANGES_LAST_DETECTED_AT.getPreferredName()),
             CHANGES_LAST_DETECTED_AT,
-            ObjectParser.ValueType.VALUE);
+            ObjectParser.ValueType.VALUE
+        );
     }
 
     /**
@@ -81,28 +189,26 @@ public class TransformCheckpointingInfo implements Writeable, ToXContentObject {
      * @param operationsBehind counter of operations the current checkpoint is behind source
      * @param changesLastDetectedAt the last time the source indices were checked for changes
      */
-    public TransformCheckpointingInfo(TransformCheckpointStats last,
-                                               TransformCheckpointStats next,
-                                               long operationsBehind,
-                                               Instant changesLastDetectedAt) {
+    public TransformCheckpointingInfo(
+        TransformCheckpointStats last,
+        TransformCheckpointStats next,
+        long operationsBehind,
+        Instant changesLastDetectedAt
+    ) {
         this.last = Objects.requireNonNull(last);
         this.next = Objects.requireNonNull(next);
         this.operationsBehind = operationsBehind;
         this.changesLastDetectedAt = changesLastDetectedAt == null ? null : Instant.ofEpochMilli(changesLastDetectedAt.toEpochMilli());
     }
 
-    public TransformCheckpointingInfo(TransformCheckpointStats last,
-                                               TransformCheckpointStats next,
-                                               long operationsBehind) {
-        this(last, next, operationsBehind, null);
-    }
-
     public TransformCheckpointingInfo(StreamInput in) throws IOException {
         last = new TransformCheckpointStats(in);
         next = new TransformCheckpointStats(in);
         operationsBehind = in.readLong();
         if (in.getVersion().onOrAfter(Version.V_7_4_0)) {
             changesLastDetectedAt = in.readOptionalInstant();
+        } else {
+            changesLastDetectedAt = null;
         }
     }
 
@@ -122,11 +228,6 @@ public Instant getChangesLastDetectedAt() {
         return changesLastDetectedAt;
     }
 
-    public TransformCheckpointingInfo setChangesLastDetectedAt(Instant changesLastDetectedAt) {
-        this.changesLastDetectedAt = Instant.ofEpochMilli(Objects.requireNonNull(changesLastDetectedAt).toEpochMilli());
-        return this;
-    }
-
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
@@ -134,11 +235,15 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (next.getCheckpoint() > 0) {
             builder.field(NEXT_CHECKPOINT.getPreferredName(), next);
         }
-        builder.field(OPERATIONS_BEHIND.getPreferredName(), operationsBehind);
+        if (operationsBehind > 0) {
+            builder.field(OPERATIONS_BEHIND.getPreferredName(), operationsBehind);
+        }
         if (changesLastDetectedAt != null) {
-            builder.timeField(CHANGES_LAST_DETECTED_AT.getPreferredName(),
+            builder.timeField(
+                CHANGES_LAST_DETECTED_AT.getPreferredName(),
                 CHANGES_LAST_DETECTED_AT.getPreferredName() + "_string",
-                changesLastDetectedAt.toEpochMilli());
+                changesLastDetectedAt.toEpochMilli()
+            );
         }
         builder.endObject();
         return builder;
@@ -175,10 +280,10 @@ public boolean equals(Object other) {
 
         TransformCheckpointingInfo that = (TransformCheckpointingInfo) other;
 
-        return Objects.equals(this.last, that.last) &&
-            Objects.equals(this.next, that.next) &&
-            this.operationsBehind == that.operationsBehind &&
-            Objects.equals(this.changesLastDetectedAt, that.changesLastDetectedAt);
+        return Objects.equals(this.last, that.last)
+            && Objects.equals(this.next, that.next)
+            && this.operationsBehind == that.operationsBehind
+            && Objects.equals(this.changesLastDetectedAt, that.changesLastDetectedAt);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpointTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpointTests.java
index f70f6c68e0179..86955d12cdbba 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpointTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/transform/transforms/TransformCheckpointTests.java
@@ -14,6 +14,7 @@
 
 import java.io.IOException;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.List;
 import java.util.Map;
 import java.util.TreeMap;
@@ -23,8 +24,13 @@
 public class TransformCheckpointTests extends AbstractSerializingTransformTestCase<TransformCheckpoint> {
 
     public static TransformCheckpoint randomTransformCheckpoints() {
-        return new TransformCheckpoint(randomAlphaOfLengthBetween(1, 10), randomNonNegativeLong(), randomNonNegativeLong(),
-                randomCheckpointsByIndex(), randomNonNegativeLong());
+        return new TransformCheckpoint(
+            randomAlphaOfLengthBetween(1, 10),
+            randomNonNegativeLong(),
+            randomNonNegativeLong(),
+            randomCheckpointsByIndex(),
+            randomNonNegativeLong()
+        );
     }
 
     @Override
@@ -62,8 +68,13 @@ public void testMatches() throws IOException {
         otherCheckpointsByIndex.put(randomAlphaOfLengthBetween(1, 10), new long[] { 1, 2, 3 });
         long timeUpperBound = randomNonNegativeLong();
 
-        TransformCheckpoint dataFrameTransformCheckpoints = new TransformCheckpoint(id, timestamp, checkpoint,
-                checkpointsByIndex, timeUpperBound);
+        TransformCheckpoint dataFrameTransformCheckpoints = new TransformCheckpoint(
+            id,
+            timestamp,
+            checkpoint,
+            checkpointsByIndex,
+            timeUpperBound
+        );
 
         // same
         assertTrue(dataFrameTransformCheckpoints.matches(dataFrameTransformCheckpoints));
@@ -74,20 +85,40 @@ public void testMatches() throws IOException {
         assertTrue(dataFrameTransformCheckpointsCopy.matches(dataFrameTransformCheckpoints));
 
         // other id
-        assertFalse(dataFrameTransformCheckpoints
-                .matches(new TransformCheckpoint(id + "-1", timestamp, checkpoint, checkpointsByIndex, timeUpperBound)));
+        assertFalse(
+            dataFrameTransformCheckpoints.matches(
+                new TransformCheckpoint(id + "-1", timestamp, checkpoint, checkpointsByIndex, timeUpperBound)
+            )
+        );
         // other timestamp
-        assertTrue(dataFrameTransformCheckpoints
-                .matches(new TransformCheckpoint(id, (timestamp / 2) + 1, checkpoint, checkpointsByIndex, timeUpperBound)));
+        assertTrue(
+            dataFrameTransformCheckpoints.matches(
+                new TransformCheckpoint(id, (timestamp / 2) + 1, checkpoint, checkpointsByIndex, timeUpperBound)
+            )
+        );
         // other checkpoint
-        assertTrue(dataFrameTransformCheckpoints
-                .matches(new TransformCheckpoint(id, timestamp, (checkpoint / 2) + 1, checkpointsByIndex, timeUpperBound)));
+        assertTrue(
+            dataFrameTransformCheckpoints.matches(
+                new TransformCheckpoint(id, timestamp, (checkpoint / 2) + 1, checkpointsByIndex, timeUpperBound)
+            )
+        );
         // other index checkpoints
-        assertFalse(dataFrameTransformCheckpoints
-                .matches(new TransformCheckpoint(id, timestamp, checkpoint, otherCheckpointsByIndex, timeUpperBound)));
+        assertFalse(
+            dataFrameTransformCheckpoints.matches(
+                new TransformCheckpoint(id, timestamp, checkpoint, otherCheckpointsByIndex, timeUpperBound)
+            )
+        );
         // other time upper bound
-        assertTrue(dataFrameTransformCheckpoints
-                .matches(new TransformCheckpoint(id, timestamp, checkpoint, checkpointsByIndex, (timeUpperBound / 2) + 1)));
+        assertTrue(
+            dataFrameTransformCheckpoints.matches(
+                new TransformCheckpoint(id, timestamp, checkpoint, checkpointsByIndex, (timeUpperBound / 2) + 1)
+            )
+        );
+    }
+
+    public void testEmpty() {
+        assertTrue(TransformCheckpoint.EMPTY.isEmpty());
+        assertFalse(new TransformCheckpoint("some_id", 0L, -1, Collections.emptyMap(), 0L).isEmpty());
     }
 
     public void testGetBehind() {
@@ -119,14 +150,16 @@ public void testGetBehind() {
 
         long checkpoint = randomLongBetween(10, 100);
 
-        TransformCheckpoint checkpointOld = new TransformCheckpoint(
-                id, timestamp, checkpoint, checkpointsByIndexOld, 0L);
-        TransformCheckpoint checkpointTransientNew = new TransformCheckpoint(
-                id, timestamp, -1L, checkpointsByIndexNew, 0L);
-        TransformCheckpoint checkpointNew = new TransformCheckpoint(
-                id, timestamp, checkpoint + 1, checkpointsByIndexNew, 0L);
+        TransformCheckpoint checkpointOld = new TransformCheckpoint(id, timestamp, checkpoint, checkpointsByIndexOld, 0L);
+        TransformCheckpoint checkpointTransientNew = new TransformCheckpoint(id, timestamp, -1L, checkpointsByIndexNew, 0L);
+        TransformCheckpoint checkpointNew = new TransformCheckpoint(id, timestamp, checkpoint + 1, checkpointsByIndexNew, 0L);
         TransformCheckpoint checkpointOlderButNewerShardsCheckpoint = new TransformCheckpoint(
-                id, timestamp, checkpoint - 1, checkpointsByIndexNew, 0L);
+            id,
+            timestamp,
+            checkpoint - 1,
+            checkpointsByIndexNew,
+            0L
+        );
 
         assertEquals(indices * shards * 10L, TransformCheckpoint.getBehind(checkpointOld, checkpointTransientNew));
         assertEquals(indices * shards * 10L, TransformCheckpoint.getBehind(checkpointOld, checkpointNew));
@@ -140,8 +173,10 @@ public void testGetBehind() {
         assertEquals(0L, TransformCheckpoint.getBehind(checkpointNew, checkpointTransientNew));
 
         // transient new vs new: illegal
-        Exception e = expectThrows(IllegalArgumentException.class,
-                () -> TransformCheckpoint.getBehind(checkpointTransientNew, checkpointNew));
+        Exception e = expectThrows(
+            IllegalArgumentException.class,
+            () -> TransformCheckpoint.getBehind(checkpointTransientNew, checkpointNew)
+        );
         assertEquals("can not compare transient against a non transient checkpoint", e.getMessage());
 
         // new vs old: illegal
@@ -155,8 +190,10 @@ public void testGetBehind() {
         // remove something from old, so newer has 1 index more than old: should be equivalent to old index existing but empty
         checkpointsByIndexOld.remove(checkpointsByIndexOld.firstKey());
         long behind = TransformCheckpoint.getBehind(checkpointOld, checkpointTransientNew);
-        assertTrue("Expected behind (" + behind + ") => sum of shard checkpoint differences (" + indices * shards * 10L + ")",
-                behind >= indices * shards * 10L);
+        assertTrue(
+            "Expected behind (" + behind + ") => sum of shard checkpoint differences (" + indices * shards * 10L + ")",
+            behind >= indices * shards * 10L
+        );
 
         // remove same key: old and new should have equal indices again
         checkpointsByIndexNew.remove(checkpointsByIndexNew.firstKey());
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportGetTransformStatsAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportGetTransformStatsAction.java
index b9dffa5d50024..f77ef92483af2 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportGetTransformStatsAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportGetTransformStatsAction.java
@@ -207,7 +207,6 @@ private void collectStatsForTransformsWithoutTasks(Request request, Response res
             listener.onResponse(response);
             return;
         }
-
         Set<String> transformsWithoutTasks = new HashSet<>(request.getExpandedIds());
         transformsWithoutTasks.removeAll(response.getTransformsStats().stream().map(TransformStats::getId).collect(Collectors.toList()));
 
@@ -252,7 +251,7 @@ private void populateSingleStoppedTransformStat(TransformStoredDoc transform, Ac
             transform.getTransformState().getCheckpoint(),
             transform.getTransformState().getPosition(),
             transform.getTransformState().getProgress(),
-            ActionListener.wrap(listener::onResponse, e -> {
+            ActionListener.wrap(infoBuilder -> listener.onResponse(infoBuilder.build()), e -> {
                 logger.warn("Failed to retrieve checkpointing info for transform [" + transform.getId() + "]", e);
                 listener.onResponse(TransformCheckpointingInfo.EMPTY);
             })
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/CheckpointProvider.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/CheckpointProvider.java
index 5fca07cef2b0e..d8b084cbd86a0 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/CheckpointProvider.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/CheckpointProvider.java
@@ -7,9 +7,9 @@
 package org.elasticsearch.xpack.transform.checkpoint;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPosition;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpoint;
-import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo;
+import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo.TransformCheckpointingInfoBuilder;
+import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPosition;
 import org.elasticsearch.xpack.core.transform.transforms.TransformProgress;
 
 /**
@@ -44,11 +44,13 @@ public interface CheckpointProvider {
      * @param nextCheckpointProgress progress for the next checkpoint
      * @param listener listener to retrieve the result
      */
-    void getCheckpointingInfo(TransformCheckpoint lastCheckpoint,
-                              TransformCheckpoint nextCheckpoint,
-                              TransformIndexerPosition nextCheckpointPosition,
-                              TransformProgress nextCheckpointProgress,
-                              ActionListener<TransformCheckpointingInfo> listener);
+    void getCheckpointingInfo(
+        TransformCheckpoint lastCheckpoint,
+        TransformCheckpoint nextCheckpoint,
+        TransformIndexerPosition nextCheckpointPosition,
+        TransformProgress nextCheckpointProgress,
+        ActionListener<TransformCheckpointingInfoBuilder> listener
+    );
 
     /**
      * Get checkpoint statistics for a stopped data frame
@@ -60,8 +62,10 @@ void getCheckpointingInfo(TransformCheckpoint lastCheckpoint,
      * @param nextCheckpointProgress progress for the next checkpoint
      * @param listener listener to retrieve the result
      */
-    void getCheckpointingInfo(long lastCheckpointNumber,
-                              TransformIndexerPosition nextCheckpointPosition,
-                              TransformProgress nextCheckpointProgress,
-                              ActionListener<TransformCheckpointingInfo> listener);
+    void getCheckpointingInfo(
+        long lastCheckpointNumber,
+        TransformIndexerPosition nextCheckpointPosition,
+        TransformProgress nextCheckpointProgress,
+        ActionListener<TransformCheckpointingInfoBuilder> listener
+    );
 }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProvider.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProvider.java
index 8abb6ba159a79..a7bda6886fd58 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProvider.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProvider.java
@@ -21,14 +21,15 @@
 import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpoint;
-import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointStats;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo;
+import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo.TransformCheckpointingInfoBuilder;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
 import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPosition;
 import org.elasticsearch.xpack.core.transform.transforms.TransformProgress;
 import org.elasticsearch.xpack.transform.notifications.TransformAuditor;
 import org.elasticsearch.xpack.transform.persistence.TransformConfigManager;
 
+import java.time.Instant;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashSet;
@@ -41,78 +42,6 @@ public class DefaultCheckpointProvider implements CheckpointProvider {
     // threshold when to audit concrete index names, above this threshold we only report the number of changes
     private static final int AUDIT_CONCRETED_SOURCE_INDEX_CHANGES = 10;
 
-    /**
-     * Builder for collecting checkpointing information for the purpose of _stats
-     */
-    private static class TransformCheckpointingInfoBuilder {
-        private TransformIndexerPosition nextCheckpointPosition;
-        private TransformProgress nextCheckpointProgress;
-        private TransformCheckpoint lastCheckpoint;
-        private TransformCheckpoint nextCheckpoint;
-        private TransformCheckpoint sourceCheckpoint;
-
-        TransformCheckpointingInfoBuilder() {}
-
-        TransformCheckpointingInfo build() {
-            if (lastCheckpoint == null) {
-                lastCheckpoint = TransformCheckpoint.EMPTY;
-            }
-            if (nextCheckpoint == null) {
-                nextCheckpoint = TransformCheckpoint.EMPTY;
-            }
-            if (sourceCheckpoint == null) {
-                sourceCheckpoint = TransformCheckpoint.EMPTY;
-            }
-
-            // checkpointstats requires a non-negative checkpoint number
-            long lastCheckpointNumber = lastCheckpoint.getCheckpoint() > 0 ? lastCheckpoint.getCheckpoint() : 0;
-            long nextCheckpointNumber = nextCheckpoint.getCheckpoint() > 0 ? nextCheckpoint.getCheckpoint() : 0;
-
-            return new TransformCheckpointingInfo(
-                new TransformCheckpointStats(
-                    lastCheckpointNumber,
-                    null,
-                    null,
-                    lastCheckpoint.getTimestamp(),
-                    lastCheckpoint.getTimeUpperBound()
-                ),
-                new TransformCheckpointStats(
-                    nextCheckpointNumber,
-                    nextCheckpointPosition,
-                    nextCheckpointProgress,
-                    nextCheckpoint.getTimestamp(),
-                    nextCheckpoint.getTimeUpperBound()
-                ),
-                TransformCheckpoint.getBehind(lastCheckpoint, sourceCheckpoint)
-            );
-        }
-
-        public TransformCheckpointingInfoBuilder setLastCheckpoint(TransformCheckpoint lastCheckpoint) {
-            this.lastCheckpoint = lastCheckpoint;
-            return this;
-        }
-
-        public TransformCheckpointingInfoBuilder setNextCheckpoint(TransformCheckpoint nextCheckpoint) {
-            this.nextCheckpoint = nextCheckpoint;
-            return this;
-        }
-
-        public TransformCheckpointingInfoBuilder setSourceCheckpoint(TransformCheckpoint sourceCheckpoint) {
-            this.sourceCheckpoint = sourceCheckpoint;
-            return this;
-        }
-
-        public TransformCheckpointingInfoBuilder setNextCheckpointProgress(TransformProgress nextCheckpointProgress) {
-            this.nextCheckpointProgress = nextCheckpointProgress;
-            return this;
-        }
-
-        public TransformCheckpointingInfoBuilder setNextCheckpointPosition(TransformIndexerPosition nextCheckpointPosition) {
-            this.nextCheckpointPosition = nextCheckpointPosition;
-            return this;
-        }
-    }
-
     private static final Logger logger = LogManager.getLogger(DefaultCheckpointProvider.class);
 
     protected final Client client;
@@ -250,10 +179,10 @@ public void getCheckpointingInfo(
         TransformCheckpoint nextCheckpoint,
         TransformIndexerPosition nextCheckpointPosition,
         TransformProgress nextCheckpointProgress,
-        ActionListener<TransformCheckpointingInfo> listener
+        ActionListener<TransformCheckpointingInfoBuilder> listener
     ) {
-
-        TransformCheckpointingInfoBuilder checkpointingInfoBuilder = new TransformCheckpointingInfoBuilder();
+        TransformCheckpointingInfo.TransformCheckpointingInfoBuilder checkpointingInfoBuilder =
+            new TransformCheckpointingInfo.TransformCheckpointingInfoBuilder();
 
         checkpointingInfoBuilder.setLastCheckpoint(lastCheckpoint)
             .setNextCheckpoint(nextCheckpoint)
@@ -263,10 +192,10 @@ public void getCheckpointingInfo(
         long timestamp = System.currentTimeMillis();
 
         getIndexCheckpoints(ActionListener.wrap(checkpointsByIndex -> {
-            checkpointingInfoBuilder.setSourceCheckpoint(
-                new TransformCheckpoint(transformConfig.getId(), timestamp, -1L, checkpointsByIndex, 0L)
-            );
-            listener.onResponse(checkpointingInfoBuilder.build());
+            TransformCheckpoint sourceCheckpoint = new TransformCheckpoint(transformConfig.getId(), timestamp, -1L, checkpointsByIndex, 0L);
+            checkpointingInfoBuilder.setSourceCheckpoint(sourceCheckpoint);
+            checkpointingInfoBuilder.setOperationsBehind(TransformCheckpoint.getBehind(lastCheckpoint, sourceCheckpoint));
+            listener.onResponse(checkpointingInfoBuilder);
         }, listener::onFailure));
     }
 
@@ -275,21 +204,24 @@ public void getCheckpointingInfo(
         long lastCheckpointNumber,
         TransformIndexerPosition nextCheckpointPosition,
         TransformProgress nextCheckpointProgress,
-        ActionListener<TransformCheckpointingInfo> listener
+        ActionListener<TransformCheckpointingInfoBuilder> listener
     ) {
 
-        TransformCheckpointingInfoBuilder checkpointingInfoBuilder = new TransformCheckpointingInfoBuilder();
+        TransformCheckpointingInfo.TransformCheckpointingInfoBuilder checkpointingInfoBuilder =
+            new TransformCheckpointingInfo.TransformCheckpointingInfoBuilder();
 
         checkpointingInfoBuilder.setNextCheckpointPosition(nextCheckpointPosition).setNextCheckpointProgress(nextCheckpointProgress);
-
+        checkpointingInfoBuilder.setLastCheckpoint(TransformCheckpoint.EMPTY);
         long timestamp = System.currentTimeMillis();
 
         // <3> got the source checkpoint, notify the user
         ActionListener<Map<String, long[]>> checkpointsByIndexListener = ActionListener.wrap(checkpointsByIndex -> {
-            checkpointingInfoBuilder.setSourceCheckpoint(
-                new TransformCheckpoint(transformConfig.getId(), timestamp, -1L, checkpointsByIndex, 0L)
+            TransformCheckpoint sourceCheckpoint = new TransformCheckpoint(transformConfig.getId(), timestamp, -1L, checkpointsByIndex, 0L);
+            checkpointingInfoBuilder.setSourceCheckpoint(sourceCheckpoint);
+            checkpointingInfoBuilder.setOperationsBehind(
+                TransformCheckpoint.getBehind(checkpointingInfoBuilder.getLastCheckpoint(), sourceCheckpoint)
             );
-            listener.onResponse(checkpointingInfoBuilder.build());
+            listener.onResponse(checkpointingInfoBuilder);
         }, e -> {
             logger.debug(
                 (Supplier<?>) () -> new ParameterizedMessage(
@@ -320,7 +252,8 @@ public void getCheckpointingInfo(
 
         // <1> got last checkpoint, get the next checkpoint
         ActionListener<TransformCheckpoint> lastCheckpointListener = ActionListener.wrap(lastCheckpointObj -> {
-            checkpointingInfoBuilder.lastCheckpoint = lastCheckpointObj;
+            checkpointingInfoBuilder.setChangesLastDetectedAt(Instant.ofEpochMilli(lastCheckpointObj.getTimestamp()));
+            checkpointingInfoBuilder.setLastCheckpoint(lastCheckpointObj);
             transformConfigManager.getTransformCheckpoint(transformConfig.getId(), lastCheckpointNumber + 1, nextCheckpointListener);
         }, e -> {
             logger.debug(
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointService.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointService.java
index b72ab2e2be814..64faf41462589 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointService.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointService.java
@@ -11,7 +11,7 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.xpack.core.transform.transforms.TimeSyncConfig;
-import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo;
+import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo.TransformCheckpointingInfoBuilder;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
 import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPosition;
 import org.elasticsearch.xpack.core.transform.transforms.TransformProgress;
@@ -66,7 +66,7 @@ public void getCheckpointingInfo(
         final long lastCheckpointNumber,
         final TransformIndexerPosition nextCheckpointPosition,
         final TransformProgress nextCheckpointProgress,
-        final ActionListener<TransformCheckpointingInfo> listener
+        final ActionListener<TransformCheckpointingInfoBuilder> listener
     ) {
 
         // we need to retrieve the config first before we can defer the rest to the corresponding provider
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformTask.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformTask.java
index 48658e7b5ed24..d977d6b99f996 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformTask.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/TransformTask.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.xpack.core.transform.TransformMessages;
 import org.elasticsearch.xpack.core.transform.action.StartTransformAction;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo;
+import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo.TransformCheckpointingInfoBuilder;
 import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPosition;
 import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerStats;
 import org.elasticsearch.xpack.core.transform.transforms.TransformState;
@@ -159,9 +160,22 @@ public void getCheckpointingInfo(
         TransformCheckpointService transformsCheckpointService,
         ActionListener<TransformCheckpointingInfo> listener
     ) {
+        ActionListener<TransformCheckpointingInfoBuilder> checkPointInfoListener = ActionListener.wrap(infoBuilder -> {
+            if (context.getChangesLastDetectedAt() != null) {
+                infoBuilder.setChangesLastDetectedAt(context.getChangesLastDetectedAt());
+            }
+            listener.onResponse(infoBuilder.build());
+        }, listener::onFailure);
+
         ClientTransformIndexer indexer = getIndexer();
         if (indexer == null) {
-            transformsCheckpointService.getCheckpointingInfo(transform.getId(), context.getCheckpoint(), initialPosition, null, listener);
+            transformsCheckpointService.getCheckpointingInfo(
+                transform.getId(),
+                context.getCheckpoint(),
+                initialPosition,
+                null,
+                checkPointInfoListener
+            );
             return;
         }
         indexer.getCheckpointProvider()
@@ -170,13 +184,7 @@ public void getCheckpointingInfo(
                 indexer.getNextCheckpoint(),
                 indexer.getPosition(),
                 indexer.getProgress(),
-                ActionListener.wrap(info -> {
-                    if (context.getChangesLastDetectedAt() == null) {
-                        listener.onResponse(info);
-                    } else {
-                        listener.onResponse(info.setChangesLastDetectedAt(context.getChangesLastDetectedAt()));
-                    }
-                }, listener::onFailure)
+                checkPointInfoListener
             );
     }
 
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointServiceNodeTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointServiceNodeTests.java
index 5d36b9b164df3..7af774f4a6faf 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointServiceNodeTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointServiceNodeTests.java
@@ -39,12 +39,13 @@
 import org.elasticsearch.index.warmer.WarmerStats;
 import org.elasticsearch.search.suggest.completion.CompletionStats;
 import org.elasticsearch.test.client.NoOpClient;
-import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPosition;
-import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPositionTests;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpoint;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointStats;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo;
+import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo.TransformCheckpointingInfoBuilder;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfigTests;
+import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPosition;
+import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPositionTests;
 import org.elasticsearch.xpack.core.transform.transforms.TransformProgress;
 import org.elasticsearch.xpack.core.transform.transforms.TransformProgressTests;
 import org.elasticsearch.xpack.transform.TransformSingleNodeTestCase;
@@ -54,6 +55,7 @@
 import org.junit.Before;
 
 import java.nio.file.Path;
+import java.time.Instant;
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.HashSet;
@@ -73,7 +75,7 @@ public class TransformCheckpointServiceNodeTests extends TransformSingleNodeTest
     private static MockClientForCheckpointing mockClientForCheckpointing = null;
 
     private IndexBasedTransformConfigManager transformsConfigManager;
-    private TransformCheckpointService transformsCheckpointService;
+    private TransformCheckpointService transformCheckpointService;
 
     private class MockClientForCheckpointing extends NoOpClient {
 
@@ -136,7 +138,7 @@ public void createComponents() {
 
         // use a mock for the checkpoint service
         TransformAuditor mockAuditor = mock(TransformAuditor.class);
-        transformsCheckpointService = new TransformCheckpointService(mockClientForCheckpointing, transformsConfigManager, mockAuditor);
+        transformCheckpointService = new TransformCheckpointService(mockClientForCheckpointing, transformsConfigManager, mockAuditor);
     }
 
     @AfterClass
@@ -255,11 +257,12 @@ public void testGetCheckpointStats() throws InterruptedException {
         TransformCheckpointingInfo checkpointInfo = new TransformCheckpointingInfo(
             new TransformCheckpointStats(1, null, null, timestamp, 0L),
             new TransformCheckpointStats(2, position, progress, timestamp + 100L, 0L),
-            30L
+            30L,
+            Instant.ofEpochMilli(timestamp)
         );
 
         assertAsync(
-            listener -> transformsCheckpointService.getCheckpointingInfo(transformId, 1, position, progress, listener),
+            listener -> getCheckpoint(transformCheckpointService, transformId, 1, position, progress, listener),
             checkpointInfo,
             null,
             null
@@ -269,10 +272,11 @@ public void testGetCheckpointStats() throws InterruptedException {
         checkpointInfo = new TransformCheckpointingInfo(
             new TransformCheckpointStats(1, null, null, timestamp, 0L),
             new TransformCheckpointStats(2, position, progress, timestamp + 100L, 0L),
-            63L
+            63L,
+            Instant.ofEpochMilli(timestamp)
         );
         assertAsync(
-            listener -> transformsCheckpointService.getCheckpointingInfo(transformId, 1, position, progress, listener),
+            listener -> getCheckpoint(transformCheckpointService, transformId, 1, position, progress, listener),
             checkpointInfo,
             null,
             null
@@ -283,10 +287,11 @@ public void testGetCheckpointStats() throws InterruptedException {
         checkpointInfo = new TransformCheckpointingInfo(
             new TransformCheckpointStats(1, null, null, timestamp, 0L),
             new TransformCheckpointStats(2, position, progress, timestamp + 100L, 0L),
-            0L
+            0L,
+            Instant.ofEpochMilli(timestamp)
         );
         assertAsync(
-            listener -> transformsCheckpointService.getCheckpointingInfo(transformId, 1, position, progress, listener),
+            listener -> getCheckpoint(transformCheckpointService, transformId, 1, position, progress, listener),
             checkpointInfo,
             null,
             null
@@ -343,4 +348,25 @@ private static ShardStats[] createShardStats(Map<String, long[]> checkpoints) {
         return shardStats.toArray(new ShardStats[0]);
     }
 
+    private static void getCheckpoint(
+        TransformCheckpointService transformCheckpointService,
+        String transformId,
+        long lastCheckpointNumber,
+        TransformIndexerPosition nextCheckpointPosition,
+        TransformProgress nextCheckpointProgress,
+        ActionListener<TransformCheckpointingInfo> listener
+    ) {
+        ActionListener<TransformCheckpointingInfoBuilder> checkPointInfoListener = ActionListener.wrap(
+            infoBuilder -> { listener.onResponse(infoBuilder.build()); },
+            listener::onFailure
+        );
+        transformCheckpointService.getCheckpointingInfo(
+            transformId,
+            lastCheckpointNumber,
+            nextCheckpointPosition,
+            nextCheckpointProgress,
+            checkPointInfoListener
+        );
+    }
+
 }

From 27abe2e0ea2a1a350ed83fc30c8974d04439ace5 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Fri, 20 Dec 2019 10:22:23 +0100
Subject: [PATCH 294/686] Only auto-expand replicas with allocation filtering
 when all nodes upgraded (#50361)

Follow-up to #48974 that ensures that replicas are only auto-expanded according to allocation
filtering rules once all nodes are upgraded to a version that supports this. Helps with
orchestrating cluster upgrades.
---
 .../elasticsearch/upgrades/RecoveryIT.java    | 35 ++++++++++
 .../cluster/metadata/AutoExpandReplicas.java  | 14 ++--
 .../metadata/AutoExpandReplicasTests.java     | 64 ++++++++++++++++++-
 3 files changed, 106 insertions(+), 7 deletions(-)

diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index 7bd52d266914d..532b6d8c11b09 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -732,4 +732,39 @@ public void testTurnOffTranslogRetentionAfterUpgraded() throws Exception {
             assertEmptyTranslog(index);
         }
     }
+
+    public void testAutoExpandIndicesDuringRollingUpgrade() throws Exception {
+        final String indexName = "test-auto-expand-filtering";
+        final Version minimumNodeVersion = minimumNodeVersion();
+
+        Response response = client().performRequest(new Request("GET", "_nodes"));
+        ObjectPath objectPath = ObjectPath.createFromResponse(response);
+        final Map<String, Object> nodeMap = objectPath.evaluate("nodes");
+        List<String> nodes = new ArrayList<>(nodeMap.keySet());
+
+        if (CLUSTER_TYPE == ClusterType.OLD) {
+            createIndex(indexName, Settings.builder()
+                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, randomInt(2))
+                .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-all")
+                .put(IndexMetaData.INDEX_ROUTING_EXCLUDE_GROUP_PREFIX + "._id", nodes.get(randomInt(2)))
+                .build());
+        }
+
+        ensureGreen(indexName);
+
+        final int numberOfReplicas = Integer.parseInt(
+            getIndexSettingsAsMap(indexName).get(IndexMetaData.SETTING_NUMBER_OF_REPLICAS).toString());
+        if (minimumNodeVersion.onOrAfter(Version.V_7_6_0)) {
+            assertEquals(nodes.size() - 2, numberOfReplicas);
+        } else {
+            assertEquals(nodes.size() - 1, numberOfReplicas);
+        }
+    }
+
+    @SuppressWarnings("unchecked")
+    private Map<String, Object> getIndexSettingsAsMap(String index) throws IOException {
+        Map<String, Object> indexSettings = getIndexSettings(index);
+        return (Map<String, Object>)((Map<String, Object>) indexSettings.get(index)).get("settings");
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/AutoExpandReplicas.java b/server/src/main/java/org/elasticsearch/cluster/metadata/AutoExpandReplicas.java
index 346d755c37916..ffd1c2a8263c6 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/AutoExpandReplicas.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/AutoExpandReplicas.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.cluster.metadata;
 
 import com.carrotsearch.hppc.cursors.ObjectCursor;
+import org.elasticsearch.Version;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.routing.allocation.RoutingAllocation;
 import org.elasticsearch.cluster.routing.allocation.decider.Decision;
@@ -105,11 +106,16 @@ int getMaxReplicas(int numDataNodes) {
     private OptionalInt getDesiredNumberOfReplicas(IndexMetaData indexMetaData, RoutingAllocation allocation) {
         if (enabled) {
             int numMatchingDataNodes = 0;
-            for (ObjectCursor<DiscoveryNode> cursor : allocation.nodes().getDataNodes().values()) {
-                Decision decision = allocation.deciders().shouldAutoExpandToNode(indexMetaData, cursor.value, allocation);
-                if (decision.type() != Decision.Type.NO) {
-                    numMatchingDataNodes ++;
+            // Only start using new logic once all nodes are migrated to 7.6.0, avoiding disruption during an upgrade
+            if (allocation.nodes().getMinNodeVersion().onOrAfter(Version.V_7_6_0)) {
+                for (ObjectCursor<DiscoveryNode> cursor : allocation.nodes().getDataNodes().values()) {
+                    Decision decision = allocation.deciders().shouldAutoExpandToNode(indexMetaData, cursor.value, allocation);
+                    if (decision.type() != Decision.Type.NO) {
+                        numMatchingDataNodes ++;
+                    }
                 }
+            } else {
+                numMatchingDataNodes = allocation.nodes().getDataNodes().size();
             }
 
             final int min = getMinReplicas();
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/AutoExpandReplicasTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/AutoExpandReplicasTests.java
index f78104201c9fb..32d25b09fa3c0 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/AutoExpandReplicasTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/AutoExpandReplicasTests.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.action.admin.cluster.reroute.ClusterRerouteRequest;
 import org.elasticsearch.action.admin.indices.create.CreateIndexRequest;
+import org.elasticsearch.action.admin.indices.settings.put.UpdateSettingsRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
 import org.elasticsearch.action.support.replication.ClusterStateCreationUtils;
 import org.elasticsearch.cluster.ClusterState;
@@ -32,6 +33,7 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.indices.cluster.ClusterStateChanges;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.VersionUtils;
 import org.elasticsearch.threadpool.TestThreadPool;
 import org.elasticsearch.threadpool.ThreadPool;
 
@@ -46,6 +48,7 @@
 
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
+import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.everyItem;
 import static org.hamcrest.Matchers.isIn;
 
@@ -104,12 +107,15 @@ public void testInvalidValues() {
 
     private static final AtomicInteger nodeIdGenerator = new AtomicInteger();
 
-    protected DiscoveryNode createNode(DiscoveryNodeRole... mustHaveRoles) {
+    protected DiscoveryNode createNode(Version version, DiscoveryNodeRole... mustHaveRoles) {
         Set<DiscoveryNodeRole> roles = new HashSet<>(randomSubsetOf(DiscoveryNodeRole.BUILT_IN_ROLES));
         Collections.addAll(roles, mustHaveRoles);
         final String id = String.format(Locale.ROOT, "node_%03d", nodeIdGenerator.incrementAndGet());
-        return new DiscoveryNode(id, id, buildNewFakeTransportAddress(), Collections.emptyMap(), roles,
-            Version.CURRENT);
+        return new DiscoveryNode(id, id, buildNewFakeTransportAddress(), Collections.emptyMap(), roles, version);
+    }
+
+    protected DiscoveryNode createNode(DiscoveryNodeRole... mustHaveRoles) {
+        return createNode(Version.CURRENT, mustHaveRoles);
     }
 
     /**
@@ -200,4 +206,56 @@ public void testAutoExpandWhenNodeLeavesAndPossiblyRejoins() throws InterruptedE
             terminate(threadPool);
         }
     }
+
+    public void testOnlyAutoExpandAllocationFilteringAfterAllNodesUpgraded() {
+        final ThreadPool threadPool = new TestThreadPool(getClass().getName());
+        final ClusterStateChanges cluster = new ClusterStateChanges(xContentRegistry(), threadPool);
+
+        try {
+            List<DiscoveryNode> allNodes = new ArrayList<>();
+            DiscoveryNode oldNode = createNode(VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_5_1),
+                DiscoveryNodeRole.MASTER_ROLE, DiscoveryNodeRole.DATA_ROLE); // local node is the master
+            allNodes.add(oldNode);
+            ClusterState state = ClusterStateCreationUtils.state(oldNode, oldNode, allNodes.toArray(new DiscoveryNode[0]));
+
+            CreateIndexRequest request = new CreateIndexRequest("index",
+                Settings.builder()
+                    .put(SETTING_NUMBER_OF_SHARDS, 1)
+                    .put(SETTING_AUTO_EXPAND_REPLICAS, "0-all").build())
+                .waitForActiveShards(ActiveShardCount.NONE);
+            state = cluster.createIndex(state, request);
+            assertTrue(state.metaData().hasIndex("index"));
+            while (state.routingTable().index("index").shard(0).allShardsStarted() == false) {
+                logger.info(state);
+                state = cluster.applyStartedShards(state,
+                    state.routingTable().index("index").shard(0).shardsWithState(ShardRoutingState.INITIALIZING));
+                state = cluster.reroute(state, new ClusterRerouteRequest());
+            }
+
+            DiscoveryNode newNode = createNode(Version.V_7_6_0,
+                DiscoveryNodeRole.MASTER_ROLE, DiscoveryNodeRole.DATA_ROLE); // local node is the master
+
+            state = cluster.addNodes(state, Collections.singletonList(newNode));
+
+            // use allocation filtering
+            state = cluster.updateSettings(state, new UpdateSettingsRequest("index").settings(Settings.builder()
+                .put(IndexMetaData.INDEX_ROUTING_EXCLUDE_GROUP_PREFIX + "._name", oldNode.getName()).build()));
+
+            while (state.routingTable().index("index").shard(0).allShardsStarted() == false) {
+                logger.info(state);
+                state = cluster.applyStartedShards(state,
+                    state.routingTable().index("index").shard(0).shardsWithState(ShardRoutingState.INITIALIZING));
+                state = cluster.reroute(state, new ClusterRerouteRequest());
+            }
+
+            // check that presence of old node means that auto-expansion does not take allocation filtering into account
+            assertThat(state.routingTable().index("index").shard(0).size(), equalTo(2));
+
+            // remove old node and check that auto-expansion takes allocation filtering into account
+            state = cluster.removeNodes(state, Collections.singletonList(oldNode));
+            assertThat(state.routingTable().index("index").shard(0).size(), equalTo(1));
+        } finally {
+            terminate(threadPool);
+        }
+    }
 }

From 8fcc633e16f4e0decab0cd3fb611ce19781a90ad Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Fri, 20 Dec 2019 10:25:39 +0100
Subject: [PATCH 295/686] Improve FutureUtils.get exception handling (#50339)

FutureUtils.get() would unwrap ElasticsearchWrapperExceptions. This
is trappy, since nearly all usages of FutureUtils.get() expected only to
not have to deal with checked exceptions.

In particular, StepListener builds upon ListenableFuture which uses
FutureUtils.get to be informed about the exception passed to onFailure.
This had the bad consequence of masking away any exception that was an
ElasticsearchWrapperException like RemoteTransportException.
Specifically for recovery, this made CircuitBreakerExceptions happening
on the target node look like they originated from the source node.

The only usage that expected that behaviour was AdapterActionFuture.
The unwrap behaviour has been moved to that class.
---
 .../action/support/AdapterActionFuture.java   | 21 ++++++++++++--
 .../action/index/MappingUpdatedAction.java    | 10 ++-----
 .../common/util/concurrent/FutureUtils.java   | 14 +---------
 .../action/StepListenerTests.java             | 18 ++++++++++++
 .../support/AdapterActionFutureTests.java     | 28 +++++++++++++++++++
 5 files changed, 68 insertions(+), 23 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/support/AdapterActionFuture.java b/server/src/main/java/org/elasticsearch/action/support/AdapterActionFuture.java
index 528750ba89b90..c37e89b8396b8 100644
--- a/server/src/main/java/org/elasticsearch/action/support/AdapterActionFuture.java
+++ b/server/src/main/java/org/elasticsearch/action/support/AdapterActionFuture.java
@@ -19,11 +19,13 @@
 
 package org.elasticsearch.action.support;
 
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionFuture;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.util.concurrent.BaseFuture;
 import org.elasticsearch.common.util.concurrent.FutureUtils;
+import org.elasticsearch.common.util.concurrent.UncategorizedExecutionException;
 
 import java.util.concurrent.TimeUnit;
 
@@ -31,7 +33,11 @@ public abstract class AdapterActionFuture<T, L> extends BaseFuture<T> implements
 
     @Override
     public T actionGet() {
-        return FutureUtils.get(this);
+        try {
+            return FutureUtils.get(this);
+        } catch (ElasticsearchException e) {
+            throw unwrapEsException(e);
+        }
     }
 
     @Override
@@ -51,7 +57,11 @@ public T actionGet(TimeValue timeout) {
 
     @Override
     public T actionGet(long timeout, TimeUnit unit) {
-        return FutureUtils.get(this, timeout, unit);
+        try {
+            return FutureUtils.get(this, timeout, unit);
+        } catch (ElasticsearchException e) {
+            throw unwrapEsException(e);
+        }
     }
 
     @Override
@@ -66,4 +76,11 @@ public void onFailure(Exception e) {
 
     protected abstract T convert(L listenerResponse);
 
+    private static RuntimeException unwrapEsException(ElasticsearchException esEx) {
+        Throwable root = esEx.unwrapCause();
+        if (root instanceof RuntimeException) {
+            return (RuntimeException) root;
+        }
+        return new UncategorizedExecutionException("Failed execution", root);
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/cluster/action/index/MappingUpdatedAction.java b/server/src/main/java/org/elasticsearch/cluster/action/index/MappingUpdatedAction.java
index c25183ece82e9..874b5eb00646c 100644
--- a/server/src/main/java/org/elasticsearch/cluster/action/index/MappingUpdatedAction.java
+++ b/server/src/main/java/org/elasticsearch/cluster/action/index/MappingUpdatedAction.java
@@ -19,7 +19,6 @@
 
 package org.elasticsearch.cluster.action.index;
 
-import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
 import org.elasticsearch.action.support.master.MasterNodeRequest;
@@ -31,7 +30,6 @@
 import org.elasticsearch.common.settings.Setting.Property;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.common.util.concurrent.FutureUtils;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.mapper.Mapping;
@@ -72,7 +70,7 @@ public void setClient(Client client) {
     public void updateMappingOnMaster(Index index, Mapping mappingUpdate, ActionListener<Void> listener) {
         client.preparePutMapping().setConcreteIndex(index).setSource(mappingUpdate.toString(), XContentType.JSON)
             .setMasterNodeTimeout(dynamicMappingUpdateTimeout).setTimeout(TimeValue.ZERO)
-            .execute(new ActionListener<AcknowledgedResponse>() {
+            .execute(new ActionListener<>() {
                 @Override
                 public void onResponse(AcknowledgedResponse acknowledgedResponse) {
                     listener.onResponse(null);
@@ -80,12 +78,8 @@ public void onResponse(AcknowledgedResponse acknowledgedResponse) {
 
                 @Override
                 public void onFailure(Exception e) {
-                    listener.onFailure(unwrapException(e));
+                    listener.onFailure(e);
                 }
             });
     }
-
-    private static Exception unwrapException(Exception cause) {
-        return cause instanceof ElasticsearchException ? FutureUtils.unwrapEsException((ElasticsearchException) cause) : cause;
-    }
 }
diff --git a/server/src/main/java/org/elasticsearch/common/util/concurrent/FutureUtils.java b/server/src/main/java/org/elasticsearch/common/util/concurrent/FutureUtils.java
index 15e26779071ec..236dc9c716266 100644
--- a/server/src/main/java/org/elasticsearch/common/util/concurrent/FutureUtils.java
+++ b/server/src/main/java/org/elasticsearch/common/util/concurrent/FutureUtils.java
@@ -19,7 +19,6 @@
 
 package org.elasticsearch.common.util.concurrent;
 
-import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ElasticsearchTimeoutException;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.SuppressForbidden;
@@ -86,21 +85,10 @@ public static  <T> T get(Future<T> future, long timeout, TimeUnit unit) {
     }
 
     public static RuntimeException rethrowExecutionException(ExecutionException e) {
-        if (e.getCause() instanceof ElasticsearchException) {
-            ElasticsearchException esEx = (ElasticsearchException) e.getCause();
-            return unwrapEsException(esEx);
-        } else if (e.getCause() instanceof RuntimeException) {
+        if (e.getCause() instanceof RuntimeException) {
             return (RuntimeException) e.getCause();
         } else {
             return new UncategorizedExecutionException("Failed execution", e);
         }
     }
-
-    public static RuntimeException unwrapEsException(ElasticsearchException esEx) {
-        Throwable root = esEx.unwrapCause();
-        if (root instanceof ElasticsearchException || root instanceof RuntimeException) {
-            return (RuntimeException) root;
-        }
-        return new UncategorizedExecutionException("Failed execution", root);
-    }
 }
diff --git a/server/src/test/java/org/elasticsearch/action/StepListenerTests.java b/server/src/test/java/org/elasticsearch/action/StepListenerTests.java
index 15e88830e47e9..df57b30c52276 100644
--- a/server/src/test/java/org/elasticsearch/action/StepListenerTests.java
+++ b/server/src/test/java/org/elasticsearch/action/StepListenerTests.java
@@ -22,11 +22,13 @@
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.threadpool.TestThreadPool;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.RemoteTransportException;
 import org.junit.After;
 import org.junit.Before;
 
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.atomic.AtomicInteger;
+import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Consumer;
 
 import static org.hamcrest.Matchers.equalTo;
@@ -110,4 +112,20 @@ private void executeAction(Runnable runnable) {
             runnable.run();
         }
     }
+
+    /**
+     * This test checks that we no longer unwrap exceptions when using StepListener.
+     */
+    public void testNoUnwrap() {
+        StepListener<String> step = new StepListener<>();
+        step.onFailure(new RemoteTransportException("test", new RuntimeException("expected")));
+        AtomicReference<RuntimeException> exception = new AtomicReference<>();
+        step.whenComplete(null, e -> {
+            exception.set((RuntimeException) e);
+        });
+
+        assertEquals(RemoteTransportException.class, exception.get().getClass());
+        RuntimeException e = expectThrows(RuntimeException.class, () -> step.result());
+        assertEquals(RemoteTransportException.class, e.getClass());
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/action/support/AdapterActionFutureTests.java b/server/src/test/java/org/elasticsearch/action/support/AdapterActionFutureTests.java
index a7405ddae8cce..b2c6a8c5ba2aa 100644
--- a/server/src/test/java/org/elasticsearch/action/support/AdapterActionFutureTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/AdapterActionFutureTests.java
@@ -19,12 +19,16 @@
 
 package org.elasticsearch.action.support;
 
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.util.concurrent.UncategorizedExecutionException;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.transport.RemoteTransportException;
 
 import java.util.Objects;
 import java.util.concurrent.BrokenBarrierException;
 import java.util.concurrent.CyclicBarrier;
+import java.util.concurrent.ExecutionException;
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
 
@@ -90,4 +94,28 @@ protected String convert(final Integer listenerResponse) {
         thread.join();
     }
 
+    public void testUnwrapException() {
+        checkUnwrap(new RemoteTransportException("test", new RuntimeException()), RuntimeException.class, RemoteTransportException.class);
+        checkUnwrap(new RemoteTransportException("test", new Exception()),
+            UncategorizedExecutionException.class, RemoteTransportException.class);
+        checkUnwrap(new Exception(), UncategorizedExecutionException.class, Exception.class);
+        checkUnwrap(new ElasticsearchException("test", new Exception()), ElasticsearchException.class, ElasticsearchException.class);
+    }
+
+    private void checkUnwrap(Exception exception, Class<? extends Exception> actionGetException,
+                             Class<? extends Exception> getException) {
+        final AdapterActionFuture<Void, Void> adapter = new AdapterActionFuture<Void, Void>() {
+            @Override
+            protected Void convert(Void listenerResponse) {
+                fail();
+                return null;
+            }
+        };
+
+        adapter.onFailure(exception);
+        assertEquals(actionGetException, expectThrows(RuntimeException.class, adapter::actionGet).getClass());
+        assertEquals(actionGetException, expectThrows(RuntimeException.class, () -> adapter.actionGet(10, TimeUnit.SECONDS)).getClass());
+        assertEquals(getException, expectThrows(ExecutionException.class, () -> adapter.get()).getCause().getClass());
+        assertEquals(getException, expectThrows(ExecutionException.class, () -> adapter.get(10, TimeUnit.SECONDS)).getCause().getClass());
+    }
 }

From e8dfca0e80b50aa9816a2e573e14f7acd5964354 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Fri, 20 Dec 2019 11:24:50 +0100
Subject: [PATCH 296/686] Get rid of maxClassesCardinality internal parameter
 (#50418)

---
 .../evaluation/classification/Precision.java  | 19 ++++-----------
 .../evaluation/classification/Recall.java     | 19 ++++-----------
 .../ClassificationEvaluationIT.java           | 24 ++++++++++++++++---
 3 files changed, 29 insertions(+), 33 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
index f6bacbec05e7b..dd04f23710118 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
-import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -75,25 +74,15 @@ public static Precision fromXContent(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    private static final int DEFAULT_MAX_CLASSES_CARDINALITY = 1000;
+    private static final int MAX_CLASSES_CARDINALITY = 1000;
 
-    private final int maxClassesCardinality;
     private String actualField;
     private List<String> topActualClassNames;
     private EvaluationMetricResult result;
 
-    public Precision() {
-        this((Integer) null);
-    }
-
-    // Visible for testing
-    public Precision(@Nullable Integer maxClassesCardinality) {
-        this.maxClassesCardinality = maxClassesCardinality != null ? maxClassesCardinality : DEFAULT_MAX_CLASSES_CARDINALITY;
-    }
+    public Precision() {}
 
-    public Precision(StreamInput in) throws IOException {
-        this.maxClassesCardinality = DEFAULT_MAX_CLASSES_CARDINALITY;
-    }
+    public Precision(StreamInput in) throws IOException {}
 
     @Override
     public String getWriteableName() {
@@ -115,7 +104,7 @@ public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> a
                     AggregationBuilders.terms(ACTUAL_CLASSES_NAMES_AGG_NAME)
                         .field(actualField)
                         .order(List.of(BucketOrder.count(false), BucketOrder.key(true)))
-                        .size(maxClassesCardinality)),
+                        .size(MAX_CLASSES_CARDINALITY)),
                 List.of());
         }
         if (result == null) {  // This is step 2
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
index 522810e57e2dd..01bdbe6db230b 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
-import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -69,24 +68,14 @@ public static Recall fromXContent(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    private static final int DEFAULT_MAX_CLASSES_CARDINALITY = 1000;
+    private static final int MAX_CLASSES_CARDINALITY = 1000;
 
-    private final int maxClassesCardinality;
     private String actualField;
     private EvaluationMetricResult result;
 
-    public Recall() {
-        this((Integer) null);
-    }
-
-    // Visible for testing
-    public Recall(@Nullable Integer maxClassesCardinality) {
-        this.maxClassesCardinality = maxClassesCardinality != null ? maxClassesCardinality : DEFAULT_MAX_CLASSES_CARDINALITY;
-    }
+    public Recall() {}
 
-    public Recall(StreamInput in) throws IOException {
-        this.maxClassesCardinality = DEFAULT_MAX_CLASSES_CARDINALITY;
-    }
+    public Recall(StreamInput in) throws IOException {}
 
     @Override
     public String getWriteableName() {
@@ -110,7 +99,7 @@ public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> a
             List.of(
                 AggregationBuilders.terms(BY_ACTUAL_CLASS_AGG_NAME)
                     .field(actualField)
-                    .size(maxClassesCardinality)
+                    .size(MAX_CLASSES_CARDINALITY)
                     .subAggregation(AggregationBuilders.avg(PER_ACTUAL_CLASS_RECALL_AGG_NAME).script(script))),
             List.of(
                 PipelineAggregatorBuilders.avgBucket(
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
index 14c2c3c9aca61..437b2ddbf5180 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
@@ -38,6 +38,7 @@ public class ClassificationEvaluationIT extends MlNativeDataFrameAnalyticsIntegT
 
     @Before
     public void setup() {
+        createAnimalsIndex(ANIMALS_DATA_INDEX);
         indexAnimalsData(ANIMALS_DATA_INDEX);
     }
 
@@ -141,11 +142,12 @@ public void testEvaluate_Precision() {
     }
 
     public void testEvaluate_Precision_CardinalityTooHigh() {
+        indexDistinctAnimals(ANIMALS_DATA_INDEX, 1001);
         ElasticsearchStatusException e =
             expectThrows(
                 ElasticsearchStatusException.class,
                 () -> evaluateDataFrame(
-                    ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Precision(4)))));
+                    ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Precision()))));
         assertThat(e.getMessage(), containsString("Cardinality of field [animal_name] is too high"));
     }
 
@@ -172,11 +174,12 @@ public void testEvaluate_Recall() {
     }
 
     public void testEvaluate_Recall_CardinalityTooHigh() {
+        indexDistinctAnimals(ANIMALS_DATA_INDEX, 1001);
         ElasticsearchStatusException e =
             expectThrows(
                 ElasticsearchStatusException.class,
                 () -> evaluateDataFrame(
-                    ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Recall(4)))));
+                    ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new Recall()))));
         assertThat(e.getMessage(), containsString("Cardinality of field [animal_name] is too high"));
     }
 
@@ -281,7 +284,7 @@ public void testEvaluate_ConfusionMatrixMetricWithUserProvidedSize() {
         assertThat(confusionMatrixResult.getOtherActualClassCount(), equalTo(2L));
     }
 
-    private static void indexAnimalsData(String indexName) {
+    private static void createAnimalsIndex(String indexName) {
         client().admin().indices().prepareCreate(indexName)
             .addMapping("_doc",
                 ANIMAL_NAME_FIELD, "type=keyword",
@@ -291,7 +294,9 @@ private static void indexAnimalsData(String indexName) {
                 IS_PREDATOR_FIELD, "type=boolean",
                 IS_PREDATOR_PREDICTION_FIELD, "type=boolean")
             .get();
+    }
 
+    private static void indexAnimalsData(String indexName) {
         List<String> animalNames = List.of("dog", "cat", "mouse", "ant", "fox");
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk()
             .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
@@ -315,4 +320,17 @@ private static void indexAnimalsData(String indexName) {
             fail("Failed to index data: " + bulkResponse.buildFailureMessage());
         }
     }
+
+    private static void indexDistinctAnimals(String indexName, int distinctAnimalCount) {
+        BulkRequestBuilder bulkRequestBuilder = client().prepareBulk()
+            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
+        for (int i = 0; i < distinctAnimalCount; i++) {
+            bulkRequestBuilder.add(
+                new IndexRequest(indexName).source(ANIMAL_NAME_FIELD, "animal_" + i, ANIMAL_NAME_PREDICTION_FIELD, randomAlphaOfLength(5)));
+        }
+        BulkResponse bulkResponse = bulkRequestBuilder.get();
+        if (bulkResponse.hasFailures()) {
+            fail("Failed to index data: " + bulkResponse.buildFailureMessage());
+        }
+    }
 }

From 77ecdd8d2e76322cd8d4fddbe03ec885bbc7cfe5 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Fri, 20 Dec 2019 11:48:09 +0100
Subject: [PATCH 297/686] Fix testAutoExpandIndicesDuringRollingUpgrade
 (#50361)

Follow-up to #50361 that fixes the test that does not work against older ES versions
---
 .../src/test/java/org/elasticsearch/upgrades/RecoveryIT.java  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index 532b6d8c11b09..429687853e897 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -747,8 +747,10 @@ public void testAutoExpandIndicesDuringRollingUpgrade() throws Exception {
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, randomInt(2))
                 .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-all")
-                .put(IndexMetaData.INDEX_ROUTING_EXCLUDE_GROUP_PREFIX + "._id", nodes.get(randomInt(2)))
                 .build());
+            ensureGreen(indexName);
+            updateIndexSettings(indexName,
+                Settings.builder().put(IndexMetaData.INDEX_ROUTING_EXCLUDE_GROUP_PREFIX + "._id", nodes.get(randomInt(2))));
         }
 
         ensureGreen(indexName);

From d7be9aeff792b994c86c60eecd05bfc911577925 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Fri, 20 Dec 2019 11:59:09 +0100
Subject: [PATCH 298/686] Mute
 RecoverySourceHandlerTests.testCancelRecoveryDuringPhase1

Relates #50424
---
 .../indices/recovery/RecoverySourceHandlerTests.java             | 1 +
 1 file changed, 1 insertion(+)

diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
index db9f52f942e63..a10a8fc0410b6 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
@@ -628,6 +628,7 @@ public void writeFileChunk(StoreFileMetaData md, long position, BytesReference c
         store.close();
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50424")
     public void testCancelRecoveryDuringPhase1() throws Exception {
         Store store = newStore(createTempDir("source"), false);
         IndexShard shard = mock(IndexShard.class);

From a16d7c00555b65615b97a9a0b033d4f9d4f41380 Mon Sep 17 00:00:00 2001
From: Alpar Torok <torokalpar@gmail.com>
Date: Fri, 20 Dec 2019 13:10:06 +0200
Subject: [PATCH 299/686] Fix NPE when `./gradlew run` without `--data-dir`
 (#50421)

---
 .../java/org/elasticsearch/gradle/testclusters/RunTask.java    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
index 07e5a6ae221f1..cedeff6a9cf5d 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
@@ -3,6 +3,7 @@
 import org.gradle.api.logging.Logger;
 import org.gradle.api.logging.Logging;
 import org.gradle.api.tasks.Input;
+import org.gradle.api.tasks.Optional;
 import org.gradle.api.tasks.TaskAction;
 import org.gradle.api.tasks.options.Option;
 
@@ -49,7 +50,9 @@ public void setDataDir(String dataDirStr) {
     }
 
     @Input
+    @Optional
     public String getDataDir() {
+        if (dataDir == null) { return null;}
         return dataDir.toString();
     }
 

From 9d7fbe080404b47ff79a9c27685ff5e9682f5942 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Fri, 20 Dec 2019 12:14:41 +0100
Subject: [PATCH 300/686] Make each analysis report desired field mappings to
 be copied (#50219)

---
 .../ml/dataframe/analyses/Classification.java |   8 +
 .../dataframe/analyses/DataFrameAnalysis.java |  11 +
 .../dataframe/analyses/OutlierDetection.java  |   5 +
 .../ml/dataframe/analyses/Regression.java     |   5 +
 .../analyses/ClassificationTests.java         |  14 +-
 .../analyses/OutlierDetectionTests.java       |  16 +-
 .../dataframe/analyses/RegressionTests.java   |  14 +-
 .../ml/integration/ClassificationIT.java      | 129 ++++++-----
 ...nsportExplainDataFrameAnalyticsAction.java |  12 +-
 ...ransportStartDataFrameAnalyticsAction.java |   3 +-
 .../ml/dataframe/DataFrameAnalyticsIndex.java |  81 +++++--
 .../dataframe/DataFrameAnalyticsManager.java  |  10 +-
 .../extractor/DataFrameDataExtractor.java     |   5 +-
 .../DataFrameDataExtractorFactory.java        |   8 +-
 .../extractor/ExtractedFieldsDetector.java    |  31 +--
 .../ExtractedFieldsDetectorFactory.java       |  18 +-
 .../DataFrameAnalyticsIndexTests.java         | 208 +++++++++++++++---
 .../ExtractedFieldsDetectorTests.java         | 111 ++++------
 18 files changed, 444 insertions(+), 245 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
index f3afd387e10b5..0e68d13895e25 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
@@ -246,6 +246,14 @@ public Map<String, Long> getFieldCardinalityLimits() {
         return Collections.singletonMap(dependentVariable, 2L);
     }
 
+    @Override
+    public Map<String, String> getExplicitlyMappedFields(String resultsFieldName) {
+        return new HashMap<>() {{
+            put(resultsFieldName + "." + predictionFieldName, dependentVariable);
+            put(resultsFieldName + ".top_classes.class_name", dependentVariable);
+        }};
+    }
+
     @Override
     public boolean supportsMissingValues() {
         return true;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/DataFrameAnalysis.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/DataFrameAnalysis.java
index d0af0a452a474..74cdc5824cbdc 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/DataFrameAnalysis.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/DataFrameAnalysis.java
@@ -41,6 +41,17 @@ public interface DataFrameAnalysis extends ToXContentObject, NamedWriteable {
      */
     Map<String, Long> getFieldCardinalityLimits();
 
+    /**
+     * Returns fields for which the mappings should be copied from source index to destination index.
+     * Each entry of the returned {@link Map} is of the form:
+     *   key   - field path in the destination index
+     *   value - field path in the source index from which the mapping should be taken
+     *
+     * @param resultsFieldName name of the results field under which all the results are stored
+     * @return {@link Map} containing fields for which the mappings should be copied from source index to destination index
+     */
+    Map<String, String> getExplicitlyMappedFields(String resultsFieldName);
+
     /**
      * @return {@code true} if this analysis supports data frame rows with missing values
      */
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetection.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetection.java
index 70b3cfb9fe246..81c4673809368 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetection.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetection.java
@@ -229,6 +229,11 @@ public Map<String, Long> getFieldCardinalityLimits() {
         return Collections.emptyMap();
     }
 
+    @Override
+    public Map<String, String> getExplicitlyMappedFields(String resultsFieldName) {
+        return Collections.emptyMap();
+    }
+
     @Override
     public boolean supportsMissingValues() {
         return false;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
index 27c8a3f2eb7ca..fe2927591312a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
@@ -186,6 +186,11 @@ public Map<String, Long> getFieldCardinalityLimits() {
         return Collections.emptyMap();
     }
 
+    @Override
+    public Map<String, String> getExplicitlyMappedFields(String resultsFieldName) {
+        return Collections.singletonMap(resultsFieldName + "." + predictionFieldName, dependentVariable);
+    }
+
     @Override
     public boolean supportsMissingValues() {
         return true;
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
index 533839e40b524..1b988379fc218 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
@@ -23,7 +23,9 @@
 import java.util.Map;
 import java.util.Set;
 
+import static org.hamcrest.Matchers.anEmptyMap;
 import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
@@ -162,8 +164,16 @@ public void testGetParams() {
                     "prediction_field_type", "string")));
     }
 
-    public void testFieldCardinalityLimitsIsNonNull() {
-        assertThat(createTestInstance().getFieldCardinalityLimits(), is(not(nullValue())));
+    public void testRequiredFieldsIsNonEmpty() {
+        assertThat(createTestInstance().getRequiredFields(), is(not(empty())));
+    }
+
+    public void testFieldCardinalityLimitsIsNonEmpty() {
+        assertThat(createTestInstance().getFieldCardinalityLimits(), is(not(anEmptyMap())));
+    }
+
+    public void testFieldMappingsToCopyIsNonEmpty() {
+        assertThat(createTestInstance().getExplicitlyMappedFields(""), is(not(anEmptyMap())));
     }
 
     public void testToXContent_GivenVersionBeforeRandomizeSeedWasIntroduced() throws IOException {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetectionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetectionTests.java
index c35b9a3bad1af..5b7a23b46ff24 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetectionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/OutlierDetectionTests.java
@@ -12,11 +12,11 @@
 import java.io.IOException;
 import java.util.Map;
 
+import static org.hamcrest.Matchers.anEmptyMap;
 import static org.hamcrest.Matchers.closeTo;
+import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
-import static org.hamcrest.Matchers.not;
-import static org.hamcrest.Matchers.nullValue;
 
 public class OutlierDetectionTests extends AbstractSerializingTestCase<OutlierDetection> {
 
@@ -84,8 +84,16 @@ public void testGetParams_GivenExplicitValues() {
         assertThat(params.get(OutlierDetection.STANDARDIZATION_ENABLED.getPreferredName()), is(false));
     }
 
-    public void testFieldCardinalityLimitsIsNonNull() {
-        assertThat(createTestInstance().getFieldCardinalityLimits(), is(not(nullValue())));
+    public void testRequiredFieldsIsEmpty() {
+        assertThat(createTestInstance().getRequiredFields(), is(empty()));
+    }
+
+    public void testFieldCardinalityLimitsIsEmpty() {
+        assertThat(createTestInstance().getFieldCardinalityLimits(), is(anEmptyMap()));
+    }
+
+    public void testFieldMappingsToCopyIsEmpty() {
+        assertThat(createTestInstance().getExplicitlyMappedFields(""), is(anEmptyMap()));
     }
 
     public void testGetStateDocId() {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
index 1a1dc79ad2a12..c7f89cc0413b5 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
@@ -19,7 +19,9 @@
 import java.util.Collections;
 import java.util.Map;
 
+import static org.hamcrest.Matchers.anEmptyMap;
 import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
@@ -99,8 +101,16 @@ public void testGetParams() {
             equalTo(Map.of("dependent_variable", "foo", "prediction_field_name", "foo_prediction")));
     }
 
-    public void testFieldCardinalityLimitsIsNonNull() {
-        assertThat(createTestInstance().getFieldCardinalityLimits(), is(not(nullValue())));
+    public void testRequiredFieldsIsNonEmpty() {
+        assertThat(createTestInstance().getRequiredFields(), is(not(empty())));
+    }
+
+    public void testFieldCardinalityLimitsIsEmpty() {
+        assertThat(createTestInstance().getFieldCardinalityLimits(), is(anEmptyMap()));
+    }
+
+    public void testFieldMappingsToCopyIsNonEmpty() {
+        assertThat(createTestInstance().getExplicitlyMappedFields(""), is(not(anEmptyMap())));
     }
 
     public void testGetStateDocId() {
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 87fa5c30b0755..fc2739c0a70e3 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -7,6 +7,8 @@
 
 import com.google.common.collect.Ordering;
 import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.action.admin.indices.get.GetIndexAction;
+import org.elasticsearch.action.admin.indices.get.GetIndexRequest;
 import org.elasticsearch.action.admin.indices.refresh.RefreshRequest;
 import org.elasticsearch.action.bulk.BulkRequestBuilder;
 import org.elasticsearch.action.bulk.BulkResponse;
@@ -39,6 +41,7 @@
 import java.util.Set;
 
 import static java.util.stream.Collectors.toList;
+import static org.elasticsearch.common.xcontent.support.XContentMapValues.extractValue;
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.greaterThan;
@@ -64,6 +67,7 @@ public class ClassificationIT extends MlNativeDataFrameAnalyticsIntegTestCase {
     private String jobId;
     private String sourceIndex;
     private String destIndex;
+    private boolean analysisUsesExistingDestIndex;
 
     @After
     public void cleanup() {
@@ -72,6 +76,7 @@ public void cleanup() {
 
     public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws Exception {
         initialize("classification_single_numeric_feature_and_mixed_data_set");
+        String predictedClassField = KEYWORD_FIELD + "_prediction";
         indexData(sourceIndex, 300, 50, KEYWORD_FIELD);
 
         DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(KEYWORD_FIELD));
@@ -88,12 +93,9 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
         SearchResponse sourceData = client().prepareSearch(sourceIndex).setTrackTotalHits(true).setSize(1000).get();
         for (SearchHit hit : sourceData.getHits()) {
             Map<String, Object> destDoc = getDestDoc(config, hit);
-            Map<String, Object> resultsObject = getMlResultsObjectFromDestDoc(destDoc);
-
-            assertThat(resultsObject.containsKey("keyword-field_prediction"), is(true));
-            assertThat((String) resultsObject.get("keyword-field_prediction"), is(in(KEYWORD_FIELD_VALUES)));
-            assertThat(resultsObject.containsKey("is_training"), is(true));
-            assertThat(resultsObject.get("is_training"), is(destDoc.containsKey(KEYWORD_FIELD)));
+            Map<String, Object> resultsObject = getFieldValue(destDoc, "ml");
+            assertThat(getFieldValue(resultsObject, predictedClassField), is(in(KEYWORD_FIELD_VALUES)));
+            assertThat(getFieldValue(resultsObject, "is_training"), is(destDoc.containsKey(KEYWORD_FIELD)));
             assertTopClasses(resultsObject, 2, KEYWORD_FIELD, KEYWORD_FIELD_VALUES);
         }
 
@@ -101,19 +103,21 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
         assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
+        assertMlResultsFieldMappings(predictedClassField, "keyword");
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [classification]",
             "Estimated memory usage for this analytics to be",
             "Starting analytics on node",
             "Started analytics",
-            "Creating destination index [" + destIndex + "]",
+            expectedDestIndexAuditMessage(),
             "Finished reindexing to destination index [" + destIndex + "]",
             "Finished analysis");
-        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml.keyword-field_prediction.keyword");
+        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml." + predictedClassField);
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsHundred() throws Exception {
         initialize("classification_only_training_data_and_training_percent_is_100");
+        String predictedClassField = KEYWORD_FIELD + "_prediction";
         indexData(sourceIndex, 300, 0, KEYWORD_FIELD);
 
         DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(KEYWORD_FIELD));
@@ -129,12 +133,10 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsHundred() throws Excepti
         client().admin().indices().refresh(new RefreshRequest(destIndex));
         SearchResponse sourceData = client().prepareSearch(sourceIndex).setTrackTotalHits(true).setSize(1000).get();
         for (SearchHit hit : sourceData.getHits()) {
-            Map<String, Object> resultsObject = getMlResultsObjectFromDestDoc(getDestDoc(config, hit));
-
-            assertThat(resultsObject.containsKey("keyword-field_prediction"), is(true));
-            assertThat((String) resultsObject.get("keyword-field_prediction"), is(in(KEYWORD_FIELD_VALUES)));
-            assertThat(resultsObject.containsKey("is_training"), is(true));
-            assertThat(resultsObject.get("is_training"), is(true));
+            Map<String, Object> destDoc = getDestDoc(config, hit);
+            Map<String, Object> resultsObject = getFieldValue(destDoc, "ml");
+            assertThat(getFieldValue(resultsObject, predictedClassField), is(in(KEYWORD_FIELD_VALUES)));
+            assertThat(getFieldValue(resultsObject, "is_training"), is(true));
             assertTopClasses(resultsObject, 2, KEYWORD_FIELD, KEYWORD_FIELD_VALUES);
         }
 
@@ -142,19 +144,22 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsHundred() throws Excepti
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
         assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
+        assertMlResultsFieldMappings(predictedClassField, "keyword");
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [classification]",
             "Estimated memory usage for this analytics to be",
             "Starting analytics on node",
             "Started analytics",
-            "Creating destination index [" + destIndex + "]",
+            expectedDestIndexAuditMessage(),
             "Finished reindexing to destination index [" + destIndex + "]",
             "Finished analysis");
-        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml.keyword-field_prediction.keyword");
+        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml." + predictedClassField);
     }
 
-    public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-            String jobId, String dependentVariable, List<T> dependentVariableValues) throws Exception {
+    public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(String jobId,
+                                                                      String dependentVariable,
+                                                                      List<T> dependentVariableValues,
+                                                                      String expectedMappingTypeForPredictedField) throws Exception {
         initialize(jobId);
         String predictedClassField = dependentVariable + "_prediction";
         indexData(sourceIndex, 300, 0, dependentVariable);
@@ -181,16 +186,13 @@ public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
         client().admin().indices().refresh(new RefreshRequest(destIndex));
         SearchResponse sourceData = client().prepareSearch(sourceIndex).setTrackTotalHits(true).setSize(1000).get();
         for (SearchHit hit : sourceData.getHits()) {
-            Map<String, Object> resultsObject = getMlResultsObjectFromDestDoc(getDestDoc(config, hit));
-            assertThat(resultsObject.containsKey(predictedClassField), is(true));
-            @SuppressWarnings("unchecked")
-            T predictedClassValue = (T) resultsObject.get(predictedClassField);
-            assertThat(predictedClassValue, is(in(dependentVariableValues)));
+            Map<String, Object> destDoc = getDestDoc(config, hit);
+            Map<String, Object> resultsObject = getFieldValue(destDoc, "ml");
+            assertThat(getFieldValue(resultsObject, predictedClassField), is(in(dependentVariableValues)));
             assertTopClasses(resultsObject, numTopClasses, dependentVariable, dependentVariableValues);
 
-            assertThat(resultsObject.containsKey("is_training"), is(true));
             // Let's just assert there's both training and non-training results
-            if ((boolean) resultsObject.get("is_training")) {
+            if (getFieldValue(resultsObject, "is_training")) {
                 trainingRowsCount++;
             } else {
                 nonTrainingRowsCount++;
@@ -203,40 +205,39 @@ public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
         assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
         assertModelStatePersisted(stateDocId());
         assertInferenceModelPersisted(jobId);
+        assertMlResultsFieldMappings(predictedClassField, expectedMappingTypeForPredictedField);
         assertThatAuditMessagesMatch(jobId,
             "Created analytics with analysis type [classification]",
             "Estimated memory usage for this analytics to be",
             "Starting analytics on node",
             "Started analytics",
-            "Creating destination index [" + destIndex + "]",
+            expectedDestIndexAuditMessage(),
             "Finished reindexing to destination index [" + destIndex + "]",
             "Finished analysis");
+        assertEvaluation(dependentVariable, dependentVariableValues, "ml." + predictedClassField);
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableIsKeyword() throws Exception {
         testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-            "classification_training_percent_is_50_keyword", KEYWORD_FIELD, KEYWORD_FIELD_VALUES);
-        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml.keyword-field_prediction.keyword");
+            "classification_training_percent_is_50_keyword", KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "keyword");
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableIsInteger() throws Exception {
         testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-            "classification_training_percent_is_50_integer", DISCRETE_NUMERICAL_FIELD, DISCRETE_NUMERICAL_FIELD_VALUES);
-        assertEvaluation(DISCRETE_NUMERICAL_FIELD, DISCRETE_NUMERICAL_FIELD_VALUES, "ml.discrete-numerical-field_prediction");
+            "classification_training_percent_is_50_integer", DISCRETE_NUMERICAL_FIELD, DISCRETE_NUMERICAL_FIELD_VALUES, "integer");
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableIsDouble() throws Exception {
         ElasticsearchStatusException e = expectThrows(
             ElasticsearchStatusException.class,
             () -> testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-                "classification_training_percent_is_50_double", NUMERICAL_FIELD, NUMERICAL_FIELD_VALUES));
+                "classification_training_percent_is_50_double", NUMERICAL_FIELD, NUMERICAL_FIELD_VALUES, null));
         assertThat(e.getMessage(), startsWith("invalid types [double] for required field [numerical-field];"));
     }
 
     public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableIsBoolean() throws Exception {
         testWithOnlyTrainingRowsAndTrainingPercentIsFifty(
-            "classification_training_percent_is_50_boolean", BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES);
-        assertEvaluation(BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES, "ml.boolean-field_prediction");
+            "classification_training_percent_is_50_boolean", BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES, "boolean");
     }
 
     public void testDependentVariableCardinalityTooHighError() throws Exception {
@@ -282,6 +283,7 @@ public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exceptio
         String sourceIndex = "classification_two_jobs_with_same_randomize_seed_source";
         String dependentVariable = KEYWORD_FIELD;
 
+        createIndex(sourceIndex);
         // We use 100 rows as we can't set this too low. If too low it is possible
         // we only train with rows of one of the two classes which leads to a failure.
         indexData(sourceIndex, 100, 0, dependentVariable);
@@ -355,17 +357,24 @@ private void initialize(String jobId) {
         this.jobId = jobId;
         this.sourceIndex = jobId + "_source_index";
         this.destIndex = sourceIndex + "_results";
+        this.analysisUsesExistingDestIndex = randomBoolean();
+        createIndex(sourceIndex);
+        if (analysisUsesExistingDestIndex) {
+            createIndex(destIndex);
+        }
     }
 
-    private static void indexData(String sourceIndex, int numTrainingRows, int numNonTrainingRows, String dependentVariable) {
-        client().admin().indices().prepareCreate(sourceIndex)
+    private static void createIndex(String index) {
+        client().admin().indices().prepareCreate(index)
             .addMapping("_doc",
                 BOOLEAN_FIELD, "type=boolean",
                 NUMERICAL_FIELD, "type=double",
                 DISCRETE_NUMERICAL_FIELD, "type=integer",
                 KEYWORD_FIELD, "type=keyword")
             .get();
+    }
 
+    private static void indexData(String sourceIndex, int numTrainingRows, int numNonTrainingRows, String dependentVariable) {
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk()
             .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
         for (int i = 0; i < numTrainingRows; i++) {
@@ -407,34 +416,30 @@ private static Map<String, Object> getDestDoc(DataFrameAnalyticsConfig config, S
         Map<String, Object> sourceDoc = hit.getSourceAsMap();
         Map<String, Object> destDoc = destDocGetResponse.getSource();
         for (String field : sourceDoc.keySet()) {
-            assertThat(destDoc.containsKey(field), is(true));
+            assertThat(destDoc, hasKey(field));
             assertThat(destDoc.get(field), equalTo(sourceDoc.get(field)));
         }
         return destDoc;
     }
 
-    private static Map<String, Object> getMlResultsObjectFromDestDoc(Map<String, Object> destDoc) {
-        assertThat(destDoc.containsKey("ml"), is(true));
-        @SuppressWarnings("unchecked")
-        Map<String, Object> resultsObject = (Map<String, Object>) destDoc.get("ml");
-        return resultsObject;
+    /**
+     * Wrapper around extractValue with implicit casting to the appropriate type.
+     */
+    private static <T> T getFieldValue(Map<String, Object> doc, String... path) {
+        return (T)extractValue(doc, path);
     }
 
-    @SuppressWarnings("unchecked")
-    private static <T> void assertTopClasses(
-        Map<String, Object> resultsObject,
-    int numTopClasses,
-    String dependentVariable,
-    List<T> dependentVariableValues) {
-        assertThat(resultsObject.containsKey("top_classes"), is(true));
-        List<Map<String, Object>> topClasses = (List<Map<String, Object>>) resultsObject.get("top_classes");
+    private static <T> void assertTopClasses(Map<String, Object> resultsObject,
+                                             int numTopClasses,
+                                             String dependentVariable,
+                                             List<T> dependentVariableValues) {
+        List<Map<String, Object>> topClasses = getFieldValue(resultsObject, "top_classes");
         assertThat(topClasses, hasSize(numTopClasses));
         List<T> classNames = new ArrayList<>(topClasses.size());
         List<Double> classProbabilities = new ArrayList<>(topClasses.size());
         for (Map<String, Object> topClass : topClasses) {
-            assertThat(topClass, allOf(hasKey("class_name"), hasKey("class_probability")));
-            classNames.add((T) topClass.get("class_name"));
-            classProbabilities.add((Double) topClass.get("class_probability"));
+            classNames.add(getFieldValue(topClass, "class_name"));
+            classProbabilities.add(getFieldValue(topClass, "class_probability"));
         }
         // Assert that all the predicted class names come from the set of dependent variable values.
         classNames.forEach(className -> assertThat(className, is(in(dependentVariableValues))));
@@ -507,7 +512,25 @@ private <T> void assertEvaluation(String dependentVariable, List<T> dependentVar
         }
     }
 
-    protected String stateDocId() {
+    private void assertMlResultsFieldMappings(String predictedClassField, String expectedType) {
+        Map<String, Object> mappings =
+            client()
+                .execute(GetIndexAction.INSTANCE, new GetIndexRequest().indices(destIndex))
+                .actionGet()
+                .mappings()
+                .get(destIndex)
+                .sourceAsMap();
+        assertThat(getFieldValue(mappings, "properties", "ml", "properties", predictedClassField, "type"), equalTo(expectedType));
+        assertThat(
+            getFieldValue(mappings, "properties", "ml", "properties", "top_classes", "properties", "class_name", "type"),
+            equalTo(expectedType));
+    }
+
+    private String stateDocId() {
         return jobId + "_classification_state#1";
     }
+
+    private String expectedDestIndexAuditMessage() {
+        return (analysisUsesExistingDestIndex ? "Using existing" : "Creating") + " destination index [" + destIndex + "]";
+    }
 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportExplainDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportExplainDataFrameAnalyticsAction.java
index 7f19deb8d5ba0..46393a3277153 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportExplainDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportExplainDataFrameAnalyticsAction.java
@@ -84,12 +84,12 @@ protected void doExecute(Task task,
     private void explain(Task task, PutDataFrameAnalyticsAction.Request request,
                          ActionListener<ExplainDataFrameAnalyticsAction.Response> listener) {
         ExtractedFieldsDetectorFactory extractedFieldsDetectorFactory = new ExtractedFieldsDetectorFactory(client);
-        extractedFieldsDetectorFactory.createFromSource(request.getConfig(), true, ActionListener.wrap(
-            extractedFieldsDetector -> {
-                explain(task, request, extractedFieldsDetector, listener);
-            },
-            listener::onFailure
-        ));
+        extractedFieldsDetectorFactory.createFromSource(
+            request.getConfig(),
+            ActionListener.wrap(
+                extractedFieldsDetector -> explain(task, request, extractedFieldsDetector, listener),
+                listener::onFailure)
+        );
     }
 
     private void explain(Task task, PutDataFrameAnalyticsAction.Request request, ExtractedFieldsDetector extractedFieldsDetector,
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
index b760f6f02399b..14130402a0baa 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
@@ -276,8 +276,7 @@ private void getStartContext(String id, ActionListener<StartContext> finalListen
                 new SourceDestValidator(clusterService.state(), indexNameExpressionResolver).check(startContext.config);
 
                 // Validate extraction is possible
-                boolean isTaskRestarting = startContext.startingState != DataFrameAnalyticsTask.StartingState.FIRST_TIME;
-                new ExtractedFieldsDetectorFactory(client).createFromSource(startContext.config, isTaskRestarting, ActionListener.wrap(
+                new ExtractedFieldsDetectorFactory(client).createFromSource(startContext.config, ActionListener.wrap(
                     extractedFieldsDetector -> {
                         startContext.extractedFields = extractedFieldsDetector.detect().v1();
                         toValidateDestEmptyListener.onResponse(startContext);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
index a369bc7d0b09a..7996f21da6453 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
@@ -28,8 +28,11 @@
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsDest;
+import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.time.Clock;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.Iterator;
 import java.util.Map;
@@ -81,7 +84,7 @@ public static void createDestinationIndex(Client client,
     }
 
     private static void prepareCreateIndexRequest(Client client, Clock clock, DataFrameAnalyticsConfig config,
-                                                         ActionListener<CreateIndexRequest> listener) {
+                                                  ActionListener<CreateIndexRequest> listener) {
         AtomicReference<Settings> settingsHolder = new AtomicReference<>();
 
         ActionListener<ImmutableOpenMap<String, MappingMetaData>> mappingsListener = ActionListener.wrap(
@@ -102,12 +105,13 @@ private static void prepareCreateIndexRequest(Client client, Clock clock, DataFr
             listener::onFailure
         );
 
-        GetSettingsRequest getSettingsRequest = new GetSettingsRequest();
-        getSettingsRequest.indices(config.getSource().getIndex());
-        getSettingsRequest.indicesOptions(IndicesOptions.lenientExpandOpen());
-        getSettingsRequest.names(PRESERVED_SETTINGS);
-        ClientHelper.executeWithHeadersAsync(config.getHeaders(), ML_ORIGIN, client, GetSettingsAction.INSTANCE,
-            getSettingsRequest, getSettingsResponseListener);
+        GetSettingsRequest getSettingsRequest =
+            new GetSettingsRequest()
+                .indices(config.getSource().getIndex())
+                .indicesOptions(IndicesOptions.lenientExpandOpen())
+                .names(PRESERVED_SETTINGS);
+        ClientHelper.executeWithHeadersAsync(
+            config.getHeaders(), ML_ORIGIN, client, GetSettingsAction.INSTANCE, getSettingsRequest, getSettingsResponseListener);
     }
 
     private static CreateIndexRequest createIndexRequest(Clock clock, DataFrameAnalyticsConfig config, Settings settings,
@@ -118,8 +122,11 @@ private static CreateIndexRequest createIndexRequest(Clock clock, DataFrameAnaly
         String destinationIndex = config.getDest().getIndex();
         String type = mappings.keysIt().next();
         Map<String, Object> mappingsAsMap = mappings.valuesIt().next().sourceAsMap();
-        addProperties(mappingsAsMap);
-        addMetaData(mappingsAsMap, config.getId(), clock);
+        Map<String, Object> properties = getOrPutDefault(mappingsAsMap, PROPERTIES, HashMap::new);
+        checkResultsFieldIsNotPresentInProperties(config, properties);
+        properties.putAll(createAdditionalMappings(config, Collections.unmodifiableMap(properties)));
+        Map<String, Object> metadata = getOrPutDefault(mappingsAsMap, META, HashMap::new);
+        metadata.putAll(createMetaData(config.getId(), clock));
         return new CreateIndexRequest(destinationIndex, settings).mapping(type, mappingsAsMap);
     }
 
@@ -153,17 +160,28 @@ private static Integer findMaxSettingValue(GetSettingsResponse settingsResponse,
         return maxValue;
     }
 
-    private static void addProperties(Map<String, Object> mappingsAsMap) {
-        Map<String, Object> properties = getOrPutDefault(mappingsAsMap, PROPERTIES, HashMap::new);
+    private static Map<String, Object> createAdditionalMappings(DataFrameAnalyticsConfig config, Map<String, Object> mappingsProperties) {
+        Map<String, Object> properties = new HashMap<>();
         properties.put(ID_COPY, Map.of("type", "keyword"));
+        for (Map.Entry<String, String> entry
+                : config.getAnalysis().getExplicitlyMappedFields(config.getDest().getResultsField()).entrySet()) {
+            String destFieldPath = entry.getKey();
+            String sourceFieldPath = entry.getValue();
+            Object sourceFieldMapping = mappingsProperties.get(sourceFieldPath);
+            if (sourceFieldMapping != null) {
+                properties.put(destFieldPath, sourceFieldMapping);
+            }
+        }
+        return properties;
     }
 
-    private static void addMetaData(Map<String, Object> mappingsAsMap, String analyticsId, Clock clock) {
-        Map<String, Object> metadata = getOrPutDefault(mappingsAsMap, META, HashMap::new);
+    private static Map<String, Object> createMetaData(String analyticsId, Clock clock) {
+        Map<String, Object> metadata = new HashMap<>();
         metadata.put(CREATION_DATE_MILLIS, clock.millis());
         metadata.put(CREATED_BY, "data-frame-analytics");
         metadata.put(VERSION, Map.of(CREATED, Version.CURRENT));
         metadata.put(ANALYTICS, analyticsId);
+        return metadata;
     }
 
     @SuppressWarnings("unchecked")
@@ -176,17 +194,42 @@ private static <K, V> V getOrPutDefault(Map<K, Object> map, K key, Supplier<V> v
         return value;
     }
 
-    public static void updateMappingsToDestIndex(Client client, DataFrameAnalyticsConfig analyticsConfig, GetIndexResponse getIndexResponse,
+    @SuppressWarnings("unchecked")
+    public static void updateMappingsToDestIndex(Client client, DataFrameAnalyticsConfig config, GetIndexResponse getIndexResponse,
                                                  ActionListener<AcknowledgedResponse> listener) {
         // We have validated the destination index should match a single index
         assert getIndexResponse.indices().length == 1;
 
-        Map<String, Object> addedMappings = Map.of(PROPERTIES, Map.of(ID_COPY, Map.of("type", "keyword")));
+        // Fetch mappings from destination index
+        Map<String, Object> destMappingsAsMap = getIndexResponse.mappings().valuesIt().next().sourceAsMap();
+        Map<String, Object> destPropertiesAsMap =
+            (Map<String, Object>)destMappingsAsMap.getOrDefault(PROPERTIES, Collections.emptyMap());
+
+        // Verify that the results field does not exist in the dest index
+        checkResultsFieldIsNotPresentInProperties(config, destPropertiesAsMap);
+
+        // Determine mappings to be added to the destination index
+        Map<String, Object> addedMappings =
+            Map.of(PROPERTIES, createAdditionalMappings(config, Collections.unmodifiableMap(destPropertiesAsMap)));
 
-        PutMappingRequest putMappingRequest = new PutMappingRequest(getIndexResponse.indices());
-        putMappingRequest.source(addedMappings);
-        ClientHelper.executeWithHeadersAsync(analyticsConfig.getHeaders(), ML_ORIGIN, client, PutMappingAction.INSTANCE,
-            putMappingRequest, listener);
+        // Add the mappings to the destination index
+        PutMappingRequest putMappingRequest =
+            new PutMappingRequest(getIndexResponse.indices())
+                .source(addedMappings);
+        ClientHelper.executeWithHeadersAsync(
+            config.getHeaders(), ML_ORIGIN, client, PutMappingAction.INSTANCE, putMappingRequest, listener);
+    }
+
+    private static void checkResultsFieldIsNotPresentInProperties(DataFrameAnalyticsConfig config, Map<String, Object> properties) {
+        String resultsField = config.getDest().getResultsField();
+        if (properties.containsKey(resultsField)) {
+            throw ExceptionsHelper.badRequestException(
+                "A field that matches the {}.{} [{}] already exists; please set a different {}",
+                DataFrameAnalyticsConfig.DEST.getPreferredName(),
+                DataFrameAnalyticsDest.RESULTS_FIELD.getPreferredName(),
+                resultsField,
+                DataFrameAnalyticsDest.RESULTS_FIELD.getPreferredName());
+        }
     }
 }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
index 8e89113be7eba..6bcd22997fbdb 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsManager.java
@@ -76,7 +76,7 @@ public void execute(DataFrameAnalyticsTask task, DataFrameAnalyticsState current
                     // The task has fully reindexed the documents and we should continue on with our analyses
                     case ANALYZING:
                         LOGGER.debug("[{}] Reassigning job that was analyzing", config.getId());
-                        startAnalytics(task, config, true);
+                        startAnalytics(task, config);
                         break;
                     // If we are already at REINDEXING, we are not 100% sure if we reindexed ALL the docs.
                     // We will delete the destination index, recreate, reindex
@@ -124,7 +124,7 @@ private void executeStartingJob(DataFrameAnalyticsTask task, DataFrameAnalyticsC
                 ));
                 break;
             case RESUMING_ANALYZING:
-                startAnalytics(task, config, true);
+                startAnalytics(task, config);
                 break;
             case FINISHED:
             default:
@@ -168,7 +168,7 @@ private void reindexDataframeAndStartAnalysis(DataFrameAnalyticsTask task, DataF
                 auditor.info(
                     config.getId(),
                     Messages.getMessage(Messages.DATA_FRAME_ANALYTICS_AUDIT_FINISHED_REINDEXING, config.getDest().getIndex()));
-                startAnalytics(task, config, false);
+                startAnalytics(task, config);
             },
             error -> task.updateState(DataFrameAnalyticsState.FAILED, error.getMessage())
         );
@@ -223,7 +223,7 @@ private void reindexDataframeAndStartAnalysis(DataFrameAnalyticsTask task, DataF
                 new GetIndexRequest().indices(config.getDest().getIndex()), destIndexListener);
     }
 
-    private void startAnalytics(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig config, boolean isTaskRestarting) {
+    private void startAnalytics(DataFrameAnalyticsTask task, DataFrameAnalyticsConfig config) {
         // Ensure we mark reindexing is finished for the case we are recovering a task that had finished reindexing
         task.setReindexingFinished();
 
@@ -249,7 +249,7 @@ private void startAnalytics(DataFrameAnalyticsTask task, DataFrameAnalyticsConfi
         // TODO This could fail with errors. In that case we get stuck with the copied index.
         // We could delete the index in case of failure or we could try building the factory before reindexing
         // to catch the error early on.
-        DataFrameDataExtractorFactory.createForDestinationIndex(client, config, isTaskRestarting, dataExtractorFactoryListener);
+        DataFrameDataExtractorFactory.createForDestinationIndex(client, config, dataExtractorFactoryListener);
     }
 
     public void stop(DataFrameAnalyticsTask task) {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractor.java
index f8a4348d4891d..7448a1af6eb99 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractor.java
@@ -267,10 +267,7 @@ private SearchRequestBuilder buildDataSummarySearchRequestBuilder() {
     }
 
     public Set<String> getCategoricalFields(DataFrameAnalysis analysis) {
-        return context.extractedFields.getAllFields().stream()
-            .filter(extractedField -> analysis.getAllowedCategoricalTypes(extractedField.getName()).containsAll(extractedField.getTypes()))
-            .map(ExtractedField::getName)
-            .collect(Collectors.toUnmodifiableSet());
+        return ExtractedFieldsDetector.getCategoricalFields(context.extractedFields, analysis);
     }
 
     public static class DataSummary {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractorFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractorFactory.java
index c7d27805c3b4e..3243d92bf77b6 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractorFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/DataFrameDataExtractorFactory.java
@@ -31,8 +31,8 @@ public class DataFrameDataExtractorFactory {
     private final boolean includeRowsWithMissingValues;
 
     private DataFrameDataExtractorFactory(Client client, String analyticsId, List<String> indices, QueryBuilder sourceQuery,
-                                         ExtractedFields extractedFields, Map<String, String> headers,
-                                         boolean includeRowsWithMissingValues) {
+                                          ExtractedFields extractedFields, Map<String, String> headers,
+                                          boolean includeRowsWithMissingValues) {
         this.client = Objects.requireNonNull(client);
         this.analyticsId = Objects.requireNonNull(analyticsId);
         this.indices = Objects.requireNonNull(indices);
@@ -100,15 +100,13 @@ public static DataFrameDataExtractorFactory createForSourceIndices(Client client
      *
      * @param client ES Client used to make calls against the cluster
      * @param config The config from which to create the extractor factory
-     * @param isTaskRestarting Whether the task is restarting
      * @param listener The listener to notify on creation or failure
      */
     public static void createForDestinationIndex(Client client,
                                                  DataFrameAnalyticsConfig config,
-                                                 boolean isTaskRestarting,
                                                  ActionListener<DataFrameDataExtractorFactory> listener) {
         ExtractedFieldsDetectorFactory extractedFieldsDetectorFactory = new ExtractedFieldsDetectorFactory(client);
-        extractedFieldsDetectorFactory.createFromDest(config, isTaskRestarting, ActionListener.wrap(
+        extractedFieldsDetectorFactory.createFromDest(config, ActionListener.wrap(
             extractedFieldsDetector -> {
                 ExtractedFields extractedFields = extractedFieldsDetector.detect().v1();
                 DataFrameDataExtractorFactory extractorFactory = new DataFrameDataExtractorFactory(client, config.getId(),
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
index 6897263ee0638..ba33d63ec3a9d 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
@@ -17,7 +17,7 @@
 import org.elasticsearch.index.mapper.BooleanFieldMapper;
 import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
-import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsDest;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.DataFrameAnalysis;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.RequiredField;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Types;
 import org.elasticsearch.xpack.core.ml.dataframe.explain.FieldSelection;
@@ -53,16 +53,14 @@ public class ExtractedFieldsDetector {
 
     private final String[] index;
     private final DataFrameAnalyticsConfig config;
-    private final boolean isTaskRestarting;
     private final int docValueFieldsLimit;
     private final FieldCapabilitiesResponse fieldCapabilitiesResponse;
     private final Map<String, Long> fieldCardinalities;
 
-    ExtractedFieldsDetector(String[] index, DataFrameAnalyticsConfig config, boolean isTaskRestarting, int docValueFieldsLimit,
+    ExtractedFieldsDetector(String[] index, DataFrameAnalyticsConfig config, int docValueFieldsLimit,
                             FieldCapabilitiesResponse fieldCapabilitiesResponse, Map<String, Long> fieldCardinalities) {
         this.index = Objects.requireNonNull(index);
         this.config = Objects.requireNonNull(config);
-        this.isTaskRestarting = isTaskRestarting;
         this.docValueFieldsLimit = docValueFieldsLimit;
         this.fieldCapabilitiesResponse = Objects.requireNonNull(fieldCapabilitiesResponse);
         this.fieldCardinalities = Objects.requireNonNull(fieldCardinalities);
@@ -83,7 +81,6 @@ public Tuple<ExtractedFields, List<FieldSelection>> detect() {
     private Set<String> getIncludedFields(Set<FieldSelection> fieldSelection) {
         Set<String> fields = new TreeSet<>(fieldCapabilitiesResponse.get().keySet());
         fields.removeAll(IGNORE_FIELDS);
-        checkResultsFieldIsNotPresent();
         removeFieldsUnderResultsField(fields);
         applySourceFiltering(fields);
         FetchSourceContext analyzedFields = config.getAnalyzedFields();
@@ -115,24 +112,6 @@ private void removeFieldsUnderResultsField(Set<String> fields) {
         fields.removeIf(field -> field.startsWith(resultsField + "."));
     }
 
-    private void checkResultsFieldIsNotPresent() {
-        // If the task is restarting we do not mind the index containing the results field, we will overwrite all docs
-        if (isTaskRestarting) {
-            return;
-        }
-
-        String resultsField = config.getDest().getResultsField();
-        Map<String, FieldCapabilities> indexToFieldCaps = fieldCapabilitiesResponse.getField(resultsField);
-        if (indexToFieldCaps != null && indexToFieldCaps.isEmpty() == false) {
-            throw ExceptionsHelper.badRequestException(
-                "A field that matches the {}.{} [{}] already exists; please set a different {}",
-                DataFrameAnalyticsConfig.DEST.getPreferredName(),
-                DataFrameAnalyticsDest.RESULTS_FIELD.getPreferredName(),
-                resultsField,
-                DataFrameAnalyticsDest.RESULTS_FIELD.getPreferredName());
-        }
-    }
-
     private void applySourceFiltering(Set<String> fields) {
         Iterator<String> fieldsIterator = fields.iterator();
         while (fieldsIterator.hasNext()) {
@@ -395,7 +374,7 @@ private ExtractedFields fetchBooleanFieldsAsIntegers(ExtractedFields extractedFi
     private void addIncludedFields(ExtractedFields extractedFields, Set<FieldSelection> fieldSelection) {
         Set<String> requiredFields = config.getAnalysis().getRequiredFields().stream().map(RequiredField::getName)
             .collect(Collectors.toSet());
-        Set<String> categoricalFields = getCategoricalFields(extractedFields);
+        Set<String> categoricalFields = getCategoricalFields(extractedFields, config.getAnalysis());
         for (ExtractedField includedField : extractedFields.getAllFields()) {
             FieldSelection.FeatureType featureType = categoricalFields.contains(includedField.getName()) ?
                 FieldSelection.FeatureType.CATEGORICAL : FieldSelection.FeatureType.NUMERICAL;
@@ -404,9 +383,9 @@ private void addIncludedFields(ExtractedFields extractedFields, Set<FieldSelecti
         }
     }
 
-    private Set<String> getCategoricalFields(ExtractedFields extractedFields) {
+    static Set<String> getCategoricalFields(ExtractedFields extractedFields, DataFrameAnalysis analysis) {
         return extractedFields.getAllFields().stream()
-            .filter(extractedField -> config.getAnalysis().getAllowedCategoricalTypes(extractedField.getName())
+            .filter(extractedField -> analysis.getAllowedCategoricalTypes(extractedField.getName())
                 .containsAll(extractedField.getTypes()))
             .map(ExtractedField::getName)
             .collect(Collectors.toUnmodifiableSet());
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
index c44555921cf38..b2d9122ef5eb8 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorFactory.java
@@ -49,26 +49,24 @@ public ExtractedFieldsDetectorFactory(Client client) {
         this.client = Objects.requireNonNull(client);
     }
 
-    public void createFromSource(DataFrameAnalyticsConfig config, boolean isTaskRestarting,
-                                 ActionListener<ExtractedFieldsDetector> listener) {
-        create(config.getSource().getIndex(), config, isTaskRestarting, listener);
+    public void createFromSource(DataFrameAnalyticsConfig config, ActionListener<ExtractedFieldsDetector> listener) {
+        create(config.getSource().getIndex(), config, listener);
     }
 
-    public void createFromDest(DataFrameAnalyticsConfig config, boolean isTaskRestarting,
-                               ActionListener<ExtractedFieldsDetector> listener) {
-        create(new String[] {config.getDest().getIndex()}, config, isTaskRestarting, listener);
+    public void createFromDest(DataFrameAnalyticsConfig config, ActionListener<ExtractedFieldsDetector> listener) {
+        create(new String[] {config.getDest().getIndex()}, config, listener);
     }
 
-    private void create(String[] index, DataFrameAnalyticsConfig config, boolean isTaskRestarting,
-                        ActionListener<ExtractedFieldsDetector> listener) {
+    private void create(String[] index, DataFrameAnalyticsConfig config, ActionListener<ExtractedFieldsDetector> listener) {
         AtomicInteger docValueFieldsLimitHolder = new AtomicInteger();
         AtomicReference<FieldCapabilitiesResponse> fieldCapsResponseHolder = new AtomicReference<>();
 
         // Step 4. Create cardinality by field map and build detector
         ActionListener<Map<String, Long>> fieldCardinalitiesHandler = ActionListener.wrap(
             fieldCardinalities -> {
-                ExtractedFieldsDetector detector = new ExtractedFieldsDetector(index, config, isTaskRestarting,
-                    docValueFieldsLimitHolder.get(), fieldCapsResponseHolder.get(), fieldCardinalities);
+                ExtractedFieldsDetector detector =
+                    new ExtractedFieldsDetector(
+                        index, config, docValueFieldsLimitHolder.get(), fieldCapsResponseHolder.get(), fieldCardinalities);
                 listener.onResponse(detector);
             },
             listener::onFailure
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
index 950d5997a5a35..7cd00f68e4b8f 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
@@ -5,18 +5,22 @@
  */
 package org.elasticsearch.xpack.ml.dataframe;
 
+import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.indices.create.CreateIndexAction;
 import org.elasticsearch.action.admin.indices.create.CreateIndexRequest;
-import org.elasticsearch.action.admin.indices.create.CreateIndexResponse;
+import org.elasticsearch.action.admin.indices.get.GetIndexResponse;
 import org.elasticsearch.action.admin.indices.mapping.get.GetMappingsAction;
 import org.elasticsearch.action.admin.indices.mapping.get.GetMappingsRequest;
 import org.elasticsearch.action.admin.indices.mapping.get.GetMappingsResponse;
+import org.elasticsearch.action.admin.indices.mapping.put.PutMappingAction;
+import org.elasticsearch.action.admin.indices.mapping.put.PutMappingRequest;
 import org.elasticsearch.action.admin.indices.settings.get.GetSettingsAction;
 import org.elasticsearch.action.admin.indices.settings.get.GetSettingsRequest;
 import org.elasticsearch.action.admin.indices.settings.get.GetSettingsResponse;
 import org.elasticsearch.action.support.IndicesOptions;
+import org.elasticsearch.action.support.master.AcknowledgedResponse;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MappingMetaData;
@@ -30,8 +34,14 @@
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsDest;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsSource;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.DataFrameAnalysis;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.OutlierDetection;
+import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
+import org.junit.Assert;
+import org.junit.Before;
 import org.mockito.ArgumentCaptor;
+import org.mockito.stubbing.Answer;
 
 import java.io.IOException;
 import java.time.Clock;
@@ -41,13 +51,19 @@
 import java.util.Map;
 
 import static org.elasticsearch.common.xcontent.support.XContentMapValues.extractValue;
+import static org.hamcrest.Matchers.arrayContaining;
 import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
 import static org.mockito.Matchers.any;
 import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.atLeastOnce;
 import static org.mockito.Mockito.doAnswer;
 import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoMoreInteractions;
+import static org.mockito.Mockito.verifyZeroInteractions;
 import static org.mockito.Mockito.when;
 
 public class DataFrameAnalyticsIndexTests extends ESTestCase {
@@ -55,13 +71,7 @@ public class DataFrameAnalyticsIndexTests extends ESTestCase {
     private static final String ANALYTICS_ID = "some-analytics-id";
     private static final String[] SOURCE_INDEX = new String[] {"source-index"};
     private static final String DEST_INDEX = "dest-index";
-    private static final DataFrameAnalyticsConfig ANALYTICS_CONFIG =
-        new DataFrameAnalyticsConfig.Builder()
-            .setId(ANALYTICS_ID)
-            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null, null))
-            .setDest(new DataFrameAnalyticsDest(DEST_INDEX, null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
+    private static final String DEPENDENT_VARIABLE = "dep_var";
     private static final int CURRENT_TIME_MILLIS = 123456789;
     private static final String CREATED_BY = "data-frame-analytics";
 
@@ -69,18 +79,17 @@ public class DataFrameAnalyticsIndexTests extends ESTestCase {
     private Client client = mock(Client.class);
     private Clock clock = Clock.fixed(Instant.ofEpochMilli(123456789L), ZoneId.systemDefault());
 
-    public void testCreateDestinationIndex() throws IOException {
+    @Before
+    public void setUpMocks() {
         when(client.threadPool()).thenReturn(threadPool);
         when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
+    }
+
+    private Map<String, Object> testCreateDestinationIndex(DataFrameAnalysis analysis) throws IOException {
+        DataFrameAnalyticsConfig config = createConfig(analysis);
 
         ArgumentCaptor<CreateIndexRequest> createIndexRequestCaptor = ArgumentCaptor.forClass(CreateIndexRequest.class);
-        doAnswer(
-            invocationOnMock -> {
-                @SuppressWarnings("unchecked")
-                ActionListener<CreateIndexResponse> listener = (ActionListener<CreateIndexResponse>) invocationOnMock.getArguments()[2];
-                listener.onResponse(null);
-                return null;
-            })
+        doAnswer(callListenerOnResponse(null))
             .when(client).execute(eq(CreateIndexAction.INSTANCE), createIndexRequestCaptor.capture(), any());
 
         Settings index1Settings = Settings.builder()
@@ -104,19 +113,19 @@ public void testCreateDestinationIndex() throws IOException {
 
         GetSettingsResponse getSettingsResponse = new GetSettingsResponse(indexToSettings.build(), ImmutableOpenMap.of());
 
-        doAnswer(
-            invocationOnMock -> {
-                @SuppressWarnings("unchecked")
-                ActionListener<GetSettingsResponse> listener = (ActionListener<GetSettingsResponse>) invocationOnMock.getArguments()[2];
-                listener.onResponse(getSettingsResponse);
-                return null;
-            }
-        ).when(client).execute(eq(GetSettingsAction.INSTANCE), getSettingsRequestCaptor.capture(), any());
+        doAnswer(callListenerOnResponse(getSettingsResponse))
+            .when(client).execute(eq(GetSettingsAction.INSTANCE), getSettingsRequestCaptor.capture(), any());
 
-        Map<String, Object> index1Mappings = Map.of("properties", Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings"));
+        Map<String, Object> index1Mappings =
+            Map.of(
+                "properties",
+                Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings", DEPENDENT_VARIABLE, Map.of("type", "integer")));
         MappingMetaData index1MappingMetaData = new MappingMetaData("_doc", index1Mappings);
 
-        Map<String, Object> index2Mappings = Map.of("properties", Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings"));
+        Map<String, Object> index2Mappings =
+            Map.of(
+                "properties",
+                Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings", DEPENDENT_VARIABLE, Map.of("type", "integer")));
         MappingMetaData index2MappingMetaData = new MappingMetaData("_doc", index2Mappings);
 
         ImmutableOpenMap.Builder<String, MappingMetaData> mappings = ImmutableOpenMap.builder();
@@ -125,19 +134,13 @@ public void testCreateDestinationIndex() throws IOException {
 
         GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
 
-        doAnswer(
-            invocationOnMock -> {
-                @SuppressWarnings("unchecked")
-                ActionListener<GetMappingsResponse> listener = (ActionListener<GetMappingsResponse>) invocationOnMock.getArguments()[2];
-                listener.onResponse(getMappingsResponse);
-                return null;
-            }
-        ).when(client).execute(eq(GetMappingsAction.INSTANCE), getMappingsRequestCaptor.capture(), any());
+        doAnswer(callListenerOnResponse(getMappingsResponse))
+            .when(client).execute(eq(GetMappingsAction.INSTANCE), getMappingsRequestCaptor.capture(), any());
 
         DataFrameAnalyticsIndex.createDestinationIndex(
             client,
             clock,
-            ANALYTICS_CONFIG,
+            config,
             ActionListener.wrap(
                 response -> {},
                 e -> fail(e.getMessage())));
@@ -166,6 +169,141 @@ public void testCreateDestinationIndex() throws IOException {
             assertThat(extractValue("_doc._meta.analytics", map), equalTo(ANALYTICS_ID));
             assertThat(extractValue("_doc._meta.creation_date_in_millis", map), equalTo(CURRENT_TIME_MILLIS));
             assertThat(extractValue("_doc._meta.created_by", map), equalTo(CREATED_BY));
+            return map;
         }
     }
+
+    public void testCreateDestinationIndex_OutlierDetection() throws IOException {
+        testCreateDestinationIndex(new OutlierDetection.Builder().build());
+    }
+
+    public void testCreateDestinationIndex_Regression() throws IOException {
+        Map<String, Object> map = testCreateDestinationIndex(new Regression(DEPENDENT_VARIABLE));
+        assertThat(extractValue("_doc.properties.ml.dep_var_prediction.type", map), equalTo("integer"));
+    }
+
+    public void testCreateDestinationIndex_Classification() throws IOException {
+        Map<String, Object> map = testCreateDestinationIndex(new Classification(DEPENDENT_VARIABLE));
+        assertThat(extractValue("_doc.properties.ml.dep_var_prediction.type", map), equalTo("integer"));
+        assertThat(extractValue("_doc.properties.ml.top_classes.class_name.type", map), equalTo("integer"));
+    }
+
+    public void testCreateDestinationIndex_ResultsFieldsExistsInSourceIndex() {
+        DataFrameAnalyticsConfig config = createConfig(new OutlierDetection.Builder().build());
+
+        GetSettingsResponse getSettingsResponse = new GetSettingsResponse(ImmutableOpenMap.of(), ImmutableOpenMap.of());
+
+        ImmutableOpenMap.Builder<String, MappingMetaData> mappings = ImmutableOpenMap.builder();
+        mappings.put("", new MappingMetaData("_doc", Map.of("properties", Map.of("ml", "some-mapping"))));
+        GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
+
+        doAnswer(callListenerOnResponse(getSettingsResponse)).when(client).execute(eq(GetSettingsAction.INSTANCE), any(), any());
+        doAnswer(callListenerOnResponse(getMappingsResponse)).when(client).execute(eq(GetMappingsAction.INSTANCE), any(), any());
+
+        DataFrameAnalyticsIndex.createDestinationIndex(
+            client,
+            clock,
+            config,
+            ActionListener.wrap(
+                response -> fail("should not succeed"),
+                e -> assertThat(
+                    e.getMessage(),
+                    equalTo("A field that matches the dest.results_field [ml] already exists; please set a different results_field"))
+            )
+        );
+    }
+
+    private Map<String, Object> testUpdateMappingsToDestIndex(DataFrameAnalysis analysis,
+                                                              Map<String, Object> properties) throws IOException {
+        DataFrameAnalyticsConfig config = createConfig(analysis);
+
+        ImmutableOpenMap.Builder<String, MappingMetaData> mappings = ImmutableOpenMap.builder();
+        mappings.put("", new MappingMetaData("_doc", Map.of("properties", properties)));
+        GetIndexResponse getIndexResponse =
+            new GetIndexResponse(
+                new String[] { DEST_INDEX }, mappings.build(), ImmutableOpenMap.of(), ImmutableOpenMap.of(), ImmutableOpenMap.of());
+
+        ArgumentCaptor<PutMappingRequest> putMappingRequestCaptor = ArgumentCaptor.forClass(PutMappingRequest.class);
+
+        doAnswer(callListenerOnResponse(new AcknowledgedResponse(true)))
+            .when(client).execute(eq(PutMappingAction.INSTANCE), putMappingRequestCaptor.capture(), any());
+
+        DataFrameAnalyticsIndex.updateMappingsToDestIndex(
+            client,
+            config,
+            getIndexResponse,
+            ActionListener.wrap(
+                response -> assertThat(response.isAcknowledged(), is(true)),
+                e -> fail(e.getMessage())
+            )
+        );
+
+        verify(client, atLeastOnce()).threadPool();
+        verify(client).execute(eq(PutMappingAction.INSTANCE), any(), any());
+        verifyNoMoreInteractions(client);
+
+        PutMappingRequest putMappingRequest = putMappingRequestCaptor.getValue();
+        assertThat(putMappingRequest.indices(), arrayContaining(DEST_INDEX));
+        try (XContentParser parser = createParser(JsonXContent.jsonXContent, putMappingRequest.source())) {
+            Map<String, Object> map = parser.map();
+            assertThat(extractValue("properties.ml__id_copy.type", map), equalTo("keyword"));
+            return map;
+        }
+    }
+
+    public void testUpdateMappingsToDestIndex_OutlierDetection() throws IOException {
+        testUpdateMappingsToDestIndex(new OutlierDetection.Builder().build(), Map.of(DEPENDENT_VARIABLE, Map.of("type", "integer")));
+    }
+
+    public void testUpdateMappingsToDestIndex_Regression() throws IOException {
+        Map<String, Object> map =
+            testUpdateMappingsToDestIndex(new Regression(DEPENDENT_VARIABLE), Map.of(DEPENDENT_VARIABLE, Map.of("type", "integer")));
+        assertThat(extractValue("properties.ml.dep_var_prediction.type", map), equalTo("integer"));
+    }
+
+    public void testUpdateMappingsToDestIndex_Classification() throws IOException {
+        Map<String, Object> map =
+            testUpdateMappingsToDestIndex(new Classification(DEPENDENT_VARIABLE), Map.of(DEPENDENT_VARIABLE, Map.of("type", "integer")));
+        assertThat(extractValue("properties.ml.dep_var_prediction.type", map), equalTo("integer"));
+        assertThat(extractValue("properties.ml.top_classes.class_name.type", map), equalTo("integer"));
+    }
+
+    public void testUpdateMappingsToDestIndex_ResultsFieldsExistsInSourceIndex() {
+        DataFrameAnalyticsConfig config = createConfig(new OutlierDetection.Builder().build());
+
+        ImmutableOpenMap.Builder<String, MappingMetaData> mappings = ImmutableOpenMap.builder();
+        mappings.put("", new MappingMetaData("_doc", Map.of("properties", Map.of("ml", "some-mapping"))));
+        GetIndexResponse getIndexResponse =
+            new GetIndexResponse(
+                new String[] { DEST_INDEX }, mappings.build(), ImmutableOpenMap.of(), ImmutableOpenMap.of(), ImmutableOpenMap.of());
+
+        ElasticsearchStatusException e =
+            expectThrows(
+                ElasticsearchStatusException.class,
+                () -> DataFrameAnalyticsIndex.updateMappingsToDestIndex(
+                    client, config, getIndexResponse, ActionListener.wrap(Assert::fail)));
+        assertThat(
+            e.getMessage(),
+            equalTo("A field that matches the dest.results_field [ml] already exists; please set a different results_field"));
+
+        verifyZeroInteractions(client);
+    }
+
+    private static <Response> Answer<Response> callListenerOnResponse(Response response) {
+        return invocationOnMock -> {
+            @SuppressWarnings("unchecked")
+            ActionListener<Response> listener = (ActionListener<Response>) invocationOnMock.getArguments()[2];
+            listener.onResponse(response);
+            return null;
+        };
+    }
+
+    private static DataFrameAnalyticsConfig createConfig(DataFrameAnalysis analysis) {
+        return new DataFrameAnalyticsConfig.Builder()
+            .setId(ANALYTICS_ID)
+            .setSource(new DataFrameAnalyticsSource(SOURCE_INDEX, null, null))
+            .setDest(new DataFrameAnalyticsDest(DEST_INDEX, null))
+            .setAnalysis(analysis)
+            .build();
+    }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
index 6a273a72b254f..47776b85ae8db 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
@@ -54,7 +54,7 @@ public void testDetect_GivenFloatField() {
             .addAggregatableField("some_float", "float").build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -72,7 +72,7 @@ public void testDetect_GivenNumericFieldWithMultipleTypes() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -90,7 +90,7 @@ public void testDetect_GivenOutlierDetectionAndNonNumericField() {
             .addAggregatableField("some_keyword", "keyword").build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-        SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+        SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No compatible fields could be detected in index [source_index]." +
@@ -102,7 +102,7 @@ public void testDetect_GivenOutlierDetectionAndFieldWithNumericAndNonNumericType
             .addAggregatableField("indecisive_field", "float", "keyword").build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No compatible fields could be detected in index [source_index]. " +
@@ -118,7 +118,7 @@ public void testDetect_GivenOutlierDetectionAndMultipleFields() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -147,7 +147,7 @@ public void testDetect_GivenRegressionAndMultipleFields() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("foo"), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -174,7 +174,7 @@ public void testDetect_GivenRegressionAndRequiredFieldMissing() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("foo"), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("required field [foo] is missing; analysis requires fields [foo]"));
@@ -190,7 +190,7 @@ public void testDetect_GivenRegressionAndRequiredFieldExcluded() {
         analyzedFields = new FetchSourceContext(true, new String[0], new String[] {"foo"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("foo"), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("required field [foo] is missing; analysis requires fields [foo]"));
@@ -206,7 +206,7 @@ public void testDetect_GivenRegressionAndRequiredFieldNotIncluded() {
         analyzedFields = new FetchSourceContext(true, new String[]  {"some_float", "some_keyword"}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("foo"), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("required field [foo] is missing; analysis requires fields [foo]"));
@@ -220,7 +220,7 @@ public void testDetect_GivenFieldIsBothIncludedAndExcluded() {
         analyzedFields = new FetchSourceContext(true, new String[]  {"foo", "bar"}, new String[] {"foo"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -241,7 +241,7 @@ public void testDetect_GivenFieldIsNotIncludedAndIsExcluded() {
         analyzedFields = new FetchSourceContext(true, new String[]  {"foo"}, new String[] {"bar"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -263,7 +263,7 @@ public void testDetect_GivenRegressionAndRequiredFieldHasInvalidType() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("foo"), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("foo"), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("invalid types [keyword] for required field [foo]; " +
@@ -279,7 +279,7 @@ public void testDetect_GivenClassificationAndRequiredFieldHasInvalidType() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildClassificationConfig("some_float"), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildClassificationConfig("some_float"), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("invalid types [float] for required field [some_float]; " +
@@ -294,7 +294,7 @@ public void testDetect_GivenClassificationAndDependentVariableHasInvalidCardinal
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(SOURCE_INDEX,
-            buildClassificationConfig("some_keyword"), false, 100, fieldCapabilities, Collections.singletonMap("some_keyword", 3L));
+            buildClassificationConfig("some_keyword"), 100, fieldCapabilities, Collections.singletonMap("some_keyword", 3L));
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("Field [some_keyword] must have at most [2] distinct values but there were at least [3]"));
@@ -305,7 +305,7 @@ public void testDetect_GivenIgnoredField() {
             .addAggregatableField("_id", "float").build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No compatible fields could be detected in index [source_index]. " +
@@ -319,7 +319,7 @@ public void testDetect_GivenIncludedIgnoredField() {
         analyzedFields = new FetchSourceContext(true, new String[]{"_id"}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No field [_id] could be detected"));
@@ -332,7 +332,7 @@ public void testDetect_GivenExcludedFieldIsMissing() {
         analyzedFields = new FetchSourceContext(true, new String[]{"*"}, new String[] {"bar"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No field [bar] could be detected"));
@@ -346,7 +346,7 @@ public void testDetect_GivenExcludedFieldIsUnsupported() {
         analyzedFields = new FetchSourceContext(true, null, new String[] {"categorical"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
 
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
@@ -377,7 +377,7 @@ public void testDetect_ShouldSortFieldsAlphabetically() {
         FieldCapabilitiesResponse fieldCapabilities = mockFieldCapsResponseBuilder.build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
@@ -394,7 +394,7 @@ public void testDetect_GivenIncludeWithMissingField() {
         analyzedFields = new FetchSourceContext(true, new String[]{"your_field1", "my*"}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No field [your_field1] could be detected"));
@@ -409,7 +409,7 @@ public void testDetect_GivenExcludeAllValidFields() {
         analyzedFields = new FetchSourceContext(true, new String[0], new String[]{"my_*"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
         assertThat(e.getMessage(), equalTo("No compatible fields could be detected in index [source_index]. " +
             "Supported types are [boolean, byte, double, float, half_float, integer, long, scaled_float, short]."));
@@ -425,7 +425,7 @@ public void testDetect_GivenInclusionsAndExclusions() {
         analyzedFields = new FetchSourceContext(true, new String[]{"your*", "my_*"}, new String[]{"*nope"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
@@ -450,7 +450,7 @@ public void testDetect_GivenIncludedFieldHasUnsupportedType() {
         analyzedFields = new FetchSourceContext(true, new String[]{"your*", "my_*"}, new String[]{"*nope"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("field [your_keyword] has unsupported type [keyword]. " +
@@ -458,22 +458,6 @@ public void testDetect_GivenIncludedFieldHasUnsupportedType() {
     }
 
     public void testDetect_GivenIndexContainsResultsField() {
-        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
-            .addAggregatableField(RESULTS_FIELD, "float")
-            .addAggregatableField("my_field1", "float")
-            .addAggregatableField("your_field2", "float")
-            .addAggregatableField("your_keyword", "keyword")
-            .build();
-
-        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
-
-        assertThat(e.getMessage(), equalTo("A field that matches the dest.results_field [ml] already exists; " +
-            "please set a different results_field"));
-    }
-
-    public void testDetect_GivenIndexContainsResultsFieldAndTaskIsRestarting() {
         FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
             .addAggregatableField(RESULTS_FIELD + ".outlier_score", "float")
             .addAggregatableField("my_field1", "float")
@@ -482,7 +466,7 @@ public void testDetect_GivenIndexContainsResultsFieldAndTaskIsRestarting() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), true, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
@@ -498,23 +482,6 @@ public void testDetect_GivenIndexContainsResultsFieldAndTaskIsRestarting() {
     }
 
     public void testDetect_GivenIncludedResultsField() {
-        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
-            .addAggregatableField(RESULTS_FIELD, "float")
-            .addAggregatableField("my_field1", "float")
-            .addAggregatableField("your_field2", "float")
-            .addAggregatableField("your_keyword", "keyword")
-            .build();
-        analyzedFields = new FetchSourceContext(true, new String[]{RESULTS_FIELD}, new String[0]);
-
-        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
-
-        assertThat(e.getMessage(), equalTo("A field that matches the dest.results_field [ml] already exists; " +
-            "please set a different results_field"));
-    }
-
-    public void testDetect_GivenIncludedResultsFieldAndTaskIsRestarting() {
         FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
             .addAggregatableField(RESULTS_FIELD + ".outlier_score", "float")
             .addAggregatableField("my_field1", "float")
@@ -524,7 +491,7 @@ public void testDetect_GivenIncludedResultsFieldAndTaskIsRestarting() {
         analyzedFields = new FetchSourceContext(true, new String[]{RESULTS_FIELD}, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), true, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
 
         assertThat(e.getMessage(), equalTo("No field [ml] could be detected"));
@@ -539,7 +506,7 @@ public void testDetect_GivenLessFieldsThanDocValuesLimit() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), true, 4, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 4, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
@@ -558,7 +525,7 @@ public void testDetect_GivenEqualFieldsToDocValuesLimit() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), true, 3, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 3, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
@@ -577,7 +544,7 @@ public void testDetect_GivenMoreFieldsThanDocValuesLimit() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), true, 2, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 2, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<String> extractedFieldNames = fieldExtraction.v1().getAllFields().stream().map(ExtractedField::getName)
@@ -594,7 +561,7 @@ private void testDetect_GivenBooleanField(DataFrameAnalyticsConfig config, boole
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, config, false, 100, fieldCapabilities, config.getAnalysis().getFieldCardinalityLimits());
+            SOURCE_INDEX, config, 100, fieldCapabilities, config.getAnalysis().getFieldCardinalityLimits());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -650,7 +617,7 @@ public void testDetect_GivenMultiFields() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("a_float"), true, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("a_float"), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         assertThat(fieldExtraction.v1().getAllFields(), hasSize(5));
@@ -681,7 +648,7 @@ public void testDetect_GivenMultiFieldAndParentIsRequired() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildClassificationConfig("field_1"), true, 100, fieldCapabilities, Collections.singletonMap("field_1", 2L));
+            SOURCE_INDEX, buildClassificationConfig("field_1"), 100, fieldCapabilities, Collections.singletonMap("field_1", 2L));
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
@@ -705,7 +672,7 @@ public void testDetect_GivenMultiFieldAndMultiFieldIsRequired() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildClassificationConfig("field_1.keyword"), true, 100, fieldCapabilities,
+            SOURCE_INDEX, buildClassificationConfig("field_1.keyword"), 100, fieldCapabilities,
             Collections.singletonMap("field_1.keyword", 2L));
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
@@ -732,7 +699,7 @@ public void testDetect_GivenSeveralMultiFields_ShouldPickFirstSorted() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("field_2"), true, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("field_2"), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
@@ -758,7 +725,7 @@ public void testDetect_GivenMultiFields_OverDocValueLimit() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("field_2"), true, 0, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("field_2"), 0, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
@@ -783,7 +750,7 @@ public void testDetect_GivenParentAndMultiFieldBothAggregatable() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("field_2.double"), true, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("field_2.double"), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
@@ -808,7 +775,7 @@ public void testDetect_GivenParentAndMultiFieldNoneAggregatable() {
             .build();
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("field_2"), true, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("field_2"), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
@@ -833,7 +800,7 @@ public void testDetect_GivenMultiFields_AndExplicitlyIncludedFields() {
         analyzedFields = new FetchSourceContext(true, new String[] { "field_1", "field_2" }, new String[0]);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildRegressionConfig("field_2"), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildRegressionConfig("field_2"), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         assertThat(fieldExtraction.v1().getAllFields(), hasSize(2));
@@ -858,7 +825,7 @@ public void testDetect_GivenSourceFilteringWithIncludes() {
         sourceFiltering = new FetchSourceContext(true, new String[] {"field_1*"}, null);
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
@@ -881,7 +848,7 @@ public void testDetect_GivenSourceFilteringWithExcludes() {
         sourceFiltering = new FetchSourceContext(true, null, new String[] {"field_1*"});
 
         ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
-            SOURCE_INDEX, buildOutlierDetectionConfig(), false, 100, fieldCapabilities, Collections.emptyMap());
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
         Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
 
         List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();

From 3abcd6373250e873ee0f71885a4d633dd8295c1d Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Fri, 20 Dec 2019 12:31:46 +0100
Subject: [PATCH 301/686] Adapt InternalComposite serialization after backport
 (#50352)

This commit adapts the version checks of the InternalComposite
serialization after the backport of #50272.
Note that this pr disables bwc tests since #50272 is not merged yet.
---
 build.gradle                                                  | 4 ++--
 .../aggregations/bucket/composite/InternalComposite.java      | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/build.gradle b/build.gradle
index b03bb7e5a3794..e465a21a09842 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = true
-final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = false
+final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/50272" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
index d3d4c34953216..503c1780d22f0 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
@@ -80,7 +80,7 @@ public InternalComposite(StreamInput in) throws IOException {
         this.reverseMuls = in.readIntArray();
         this.buckets = in.readList((input) -> new InternalBucket(input, sourceNames, formats, reverseMuls));
         this.afterKey = in.readOptionalWriteable(CompositeKey::new);
-        this.earlyTerminated = in.getVersion().onOrAfter(Version.V_8_0_0) ? in.readBoolean() : false;
+        this.earlyTerminated = in.getVersion().onOrAfter(Version.V_7_6_0) ? in.readBoolean() : false;
     }
 
     @Override
@@ -93,7 +93,7 @@ protected void doWriteTo(StreamOutput out) throws IOException {
         out.writeIntArray(reverseMuls);
         out.writeList(buckets);
         out.writeOptionalWriteable(afterKey);
-        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             out.writeBoolean(earlyTerminated);
         }
     }

From 5ed3bd17df8e87586c44ae38395e67ba18dd6908 Mon Sep 17 00:00:00 2001
From: Alexander Reelsen <alexander@reelsen.net>
Date: Fri, 20 Dec 2019 13:53:11 +0100
Subject: [PATCH 302/686] Remove accidentally added license files (#50370)

As license infos and sha files belong to the licenses/ folder, these
files seem to have been added accidentally some time ago.
---
 plugins/analysis-icu/bin/licenses/icu4j-59.1.jar.sha1            | 1 -
 .../lucene-analyzers-icu-7.0.0-snapshot-ad2cb77.jar.sha1         | 1 -
 2 files changed, 2 deletions(-)
 delete mode 100644 plugins/analysis-icu/bin/licenses/icu4j-59.1.jar.sha1
 delete mode 100644 plugins/analysis-icu/bin/licenses/lucene-analyzers-icu-7.0.0-snapshot-ad2cb77.jar.sha1

diff --git a/plugins/analysis-icu/bin/licenses/icu4j-59.1.jar.sha1 b/plugins/analysis-icu/bin/licenses/icu4j-59.1.jar.sha1
deleted file mode 100644
index 5401f914f5853..0000000000000
--- a/plugins/analysis-icu/bin/licenses/icu4j-59.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-6f06e820cf4c8968bbbaae66ae0b33f6a256b57f
\ No newline at end of file
diff --git a/plugins/analysis-icu/bin/licenses/lucene-analyzers-icu-7.0.0-snapshot-ad2cb77.jar.sha1 b/plugins/analysis-icu/bin/licenses/lucene-analyzers-icu-7.0.0-snapshot-ad2cb77.jar.sha1
deleted file mode 100644
index 0c08e240dbf47..0000000000000
--- a/plugins/analysis-icu/bin/licenses/lucene-analyzers-icu-7.0.0-snapshot-ad2cb77.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-f90e2fe9e8ff1be65a800e719d2a25cd0a09cced
\ No newline at end of file

From c0ec3ef640c3c5c7c2d5e55b9634038fe8dff4fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Fri, 20 Dec 2019 14:00:21 +0100
Subject: [PATCH 303/686] Fix accuracy metric (#50310)

---
 .../classification/AccuracyMetric.java        |  97 ++++----
 .../client/MachineLearningIT.java             |  14 +-
 .../AccuracyMetricResultTests.java            |   8 +-
 .../evaluation/EvaluationMetric.java          |   2 +-
 .../evaluation/classification/Accuracy.java   | 212 +++++++++++-------
 .../MulticlassConfusionMatrix.java            |  87 ++++---
 .../evaluation/classification/Precision.java  |  33 +--
 .../evaluation/classification/Recall.java     |  21 +-
 .../classification/AccuracyResultTests.java   |  10 +-
 .../classification/AccuracyTests.java         | 147 ++++++++----
 .../MulticlassConfusionMatrixTests.java       |  44 ++--
 .../ClassificationEvaluationIT.java           |  65 ++++--
 .../ml/integration/ClassificationIT.java      |  10 +-
 .../test/ml/evaluate_data_frame.yml           |  17 +-
 14 files changed, 472 insertions(+), 295 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetric.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetric.java
index 4db165be06caa..151783499e46b 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetric.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetric.java
@@ -20,6 +20,7 @@
 
 import org.elasticsearch.client.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.ToXContent;
@@ -35,10 +36,25 @@
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 
 /**
- * {@link AccuracyMetric} is a metric that answers the question:
- *   "What fraction of examples have been classified correctly by the classifier?"
+ * {@link AccuracyMetric} is a metric that answers the following two questions:
  *
- * equation: accuracy = 1/n * Σ(y == y´)
+ *   1. What is the fraction of documents for which predicted class equals the actual class?
+ *
+ *      equation: overall_accuracy = 1/n * Σ(y == y')
+ *      where: n  = total number of documents
+ *             y  = document's actual class
+ *             y' = document's predicted class
+ *
+ *   2. For any given class X, what is the fraction of documents for which either
+ *       a) both actual and predicted class are equal to X (true positives)
+ *      or
+ *       b) both actual and predicted class are not equal to X (true negatives)
+ *
+ *      equation: accuracy(X) = 1/n * (TP(X) + TN(X))
+ *      where: X     = class being examined
+ *             n     = total number of documents
+ *             TP(X) = number of true positives wrt X
+ *             TN(X) = number of true negatives wrt X
  */
 public class AccuracyMetric implements EvaluationMetric {
 
@@ -78,15 +94,15 @@ public int hashCode() {
 
     public static class Result implements EvaluationMetric.Result {
 
-        private static final ParseField ACTUAL_CLASSES = new ParseField("actual_classes");
+        private static final ParseField CLASSES = new ParseField("classes");
         private static final ParseField OVERALL_ACCURACY = new ParseField("overall_accuracy");
 
         @SuppressWarnings("unchecked")
         private static final ConstructingObjectParser<Result, Void> PARSER =
-            new ConstructingObjectParser<>("accuracy_result", true, a -> new Result((List<ActualClass>) a[0], (double) a[1]));
+            new ConstructingObjectParser<>("accuracy_result", true, a -> new Result((List<PerClassResult>) a[0], (double) a[1]));
 
         static {
-            PARSER.declareObjectArray(constructorArg(), ActualClass.PARSER, ACTUAL_CLASSES);
+            PARSER.declareObjectArray(constructorArg(), PerClassResult.PARSER, CLASSES);
             PARSER.declareDouble(constructorArg(), OVERALL_ACCURACY);
         }
 
@@ -94,13 +110,13 @@ public static Result fromXContent(XContentParser parser) {
             return PARSER.apply(parser, null);
         }
 
-        /** List of actual classes. */
-        private final List<ActualClass> actualClasses;
-        /** Fraction of documents predicted correctly. */
+        /** List of per-class results. */
+        private final List<PerClassResult> classes;
+        /** Fraction of documents for which predicted class equals the actual class. */
         private final double overallAccuracy;
 
-        public Result(List<ActualClass> actualClasses, double overallAccuracy) {
-            this.actualClasses = Collections.unmodifiableList(Objects.requireNonNull(actualClasses));
+        public Result(List<PerClassResult> classes, double overallAccuracy) {
+            this.classes = Collections.unmodifiableList(Objects.requireNonNull(classes));
             this.overallAccuracy = overallAccuracy;
         }
 
@@ -109,8 +125,8 @@ public String getMetricName() {
             return NAME;
         }
 
-        public List<ActualClass> getActualClasses() {
-            return actualClasses;
+        public List<PerClassResult> getClasses() {
+            return classes;
         }
 
         public double getOverallAccuracy() {
@@ -120,7 +136,7 @@ public double getOverallAccuracy() {
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
             builder.startObject();
-            builder.field(ACTUAL_CLASSES.getPreferredName(), actualClasses);
+            builder.field(CLASSES.getPreferredName(), classes);
             builder.field(OVERALL_ACCURACY.getPreferredName(), overallAccuracy);
             builder.endObject();
             return builder;
@@ -131,52 +147,42 @@ public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
             Result that = (Result) o;
-            return Objects.equals(this.actualClasses, that.actualClasses)
+            return Objects.equals(this.classes, that.classes)
                 && this.overallAccuracy == that.overallAccuracy;
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(actualClasses, overallAccuracy);
+            return Objects.hash(classes, overallAccuracy);
         }
     }
 
-    public static class ActualClass implements ToXContentObject {
+    public static class PerClassResult implements ToXContentObject {
 
-        private static final ParseField ACTUAL_CLASS = new ParseField("actual_class");
-        private static final ParseField ACTUAL_CLASS_DOC_COUNT = new ParseField("actual_class_doc_count");
+        private static final ParseField CLASS_NAME = new ParseField("class_name");
         private static final ParseField ACCURACY = new ParseField("accuracy");
 
         @SuppressWarnings("unchecked")
-        private static final ConstructingObjectParser<ActualClass, Void> PARSER =
-            new ConstructingObjectParser<>("accuracy_actual_class", true, a -> new ActualClass((String) a[0], (long) a[1], (double) a[2]));
+        private static final ConstructingObjectParser<PerClassResult, Void> PARSER =
+            new ConstructingObjectParser<>("accuracy_per_class_result", true, a -> new PerClassResult((String) a[0], (double) a[1]));
 
         static {
-            PARSER.declareString(constructorArg(), ACTUAL_CLASS);
-            PARSER.declareLong(constructorArg(), ACTUAL_CLASS_DOC_COUNT);
+            PARSER.declareString(constructorArg(), CLASS_NAME);
             PARSER.declareDouble(constructorArg(), ACCURACY);
         }
 
-        /** Name of the actual class. */
-        private final String actualClass;
-        /** Number of documents (examples) belonging to the {code actualClass} class. */
-        private final long actualClassDocCount;
-        /** Fraction of documents belonging to the {code actualClass} class predicted correctly. */
+        /** Name of the class. */
+        private final String className;
+        /** Fraction of documents that are either true positives or true negatives wrt {@code className}. */
         private final double accuracy;
 
-        public ActualClass(
-            String actualClass, long actualClassDocCount, double accuracy) {
-            this.actualClass = Objects.requireNonNull(actualClass);
-            this.actualClassDocCount = actualClassDocCount;
+        public PerClassResult(String className, double accuracy) {
+            this.className = Objects.requireNonNull(className);
             this.accuracy = accuracy;
         }
 
-        public String getActualClass() {
-            return actualClass;
-        }
-
-        public long getActualClassDocCount() {
-            return actualClassDocCount;
+        public String getClassName() {
+            return className;
         }
 
         public double getAccuracy() {
@@ -186,8 +192,7 @@ public double getAccuracy() {
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
             builder.startObject();
-            builder.field(ACTUAL_CLASS.getPreferredName(), actualClass);
-            builder.field(ACTUAL_CLASS_DOC_COUNT.getPreferredName(), actualClassDocCount);
+            builder.field(CLASS_NAME.getPreferredName(), className);
             builder.field(ACCURACY.getPreferredName(), accuracy);
             builder.endObject();
             return builder;
@@ -197,15 +202,19 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
-            ActualClass that = (ActualClass) o;
-            return Objects.equals(this.actualClass, that.actualClass)
-                && this.actualClassDocCount == that.actualClassDocCount
+            PerClassResult that = (PerClassResult) o;
+            return Objects.equals(this.className, that.className)
                 && this.accuracy == that.accuracy;
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(actualClass, actualClassDocCount, accuracy);
+            return Objects.hash(className, accuracy);
+        }
+
+        @Override
+        public String toString() {
+            return Strings.toString(this);
         }
     }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index 4aee48dff13a5..443c337d089fa 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -1819,15 +1819,15 @@ public void testEvaluateDataFrame_Classification() throws IOException {
             AccuracyMetric.Result accuracyResult = evaluateDataFrameResponse.getMetricByName(AccuracyMetric.NAME);
             assertThat(accuracyResult.getMetricName(), equalTo(AccuracyMetric.NAME));
             assertThat(
-                accuracyResult.getActualClasses(),
+                accuracyResult.getClasses(),
                 equalTo(
                     List.of(
-                        // 3 out of 5 examples labeled as "cat" were classified correctly
-                        new AccuracyMetric.ActualClass("cat", 5, 0.6),
-                        // 3 out of 4 examples labeled as "dog" were classified correctly
-                        new AccuracyMetric.ActualClass("dog", 4, 0.75),
-                        // no examples labeled as "ant" were classified correctly
-                        new AccuracyMetric.ActualClass("ant", 1, 0.0))));
+                        // 9 out of 10 examples were classified correctly
+                        new AccuracyMetric.PerClassResult("ant", 0.9),
+                        // 6 out of 10 examples were classified correctly
+                        new AccuracyMetric.PerClassResult("cat", 0.6),
+                        // 8 out of 10 examples were classified correctly
+                        new AccuracyMetric.PerClassResult("dog", 0.8))));
             assertThat(accuracyResult.getOverallAccuracy(), equalTo(0.6));  // 6 out of 10 examples were classified correctly
         }
         {  // Precision
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetricResultTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetricResultTests.java
index df48ef3123dd1..8758cea86c451 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetricResultTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/evaluation/classification/AccuracyMetricResultTests.java
@@ -19,7 +19,7 @@
 package org.elasticsearch.client.ml.dataframe.evaluation.classification;
 
 import org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
-import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetric.ActualClass;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetric.PerClassResult;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetric.Result;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentParser;
@@ -41,13 +41,13 @@ protected NamedXContentRegistry xContentRegistry() {
     public static Result randomResult() {
         int numClasses = randomIntBetween(2, 100);
         List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
-        List<ActualClass> actualClasses = new ArrayList<>(numClasses);
+        List<PerClassResult> classes = new ArrayList<>(numClasses);
         for (int i = 0; i < numClasses; i++) {
             double accuracy = randomDoubleBetween(0.0, 1.0, true);
-            actualClasses.add(new ActualClass(classNames.get(i), randomNonNegativeLong(), accuracy));
+            classes.add(new PerClassResult(classNames.get(i), accuracy));
         }
         double overallAccuracy = randomDoubleBetween(0.0, 1.0, true);
-        return new Result(actualClasses, overallAccuracy);
+        return new Result(classes, overallAccuracy);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/EvaluationMetric.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/EvaluationMetric.java
index 36bf7634cb43f..8a106175ace91 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/EvaluationMetric.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/EvaluationMetric.java
@@ -44,5 +44,5 @@ public interface EvaluationMetric extends ToXContentObject, NamedWriteable {
      * Gets the evaluation result for this metric.
      * @return {@code Optional.empty()} if the result is not available yet, {@code Optional.of(result)} otherwise
      */
-    Optional<EvaluationMetricResult> getResult();
+    Optional<? extends EvaluationMetricResult> getResult();
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Accuracy.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Accuracy.java
index 8e7b8b6066932..c6636329a65d9 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Accuracy.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Accuracy.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
+import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -20,7 +21,6 @@
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.Aggregations;
 import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
-import org.elasticsearch.search.aggregations.bucket.terms.Terms;
 import org.elasticsearch.search.aggregations.metrics.NumericMetricsAggregation;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetric;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
@@ -39,22 +39,36 @@
 import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider.registeredMetricName;
 
 /**
- * {@link Accuracy} is a metric that answers the question:
- *   "What fraction of examples have been classified correctly by the classifier?"
+ * {@link Accuracy} is a metric that answers the following two questions:
  *
- * equation: accuracy = 1/n * Σ(y == y´)
+ *   1. What is the fraction of documents for which predicted class equals the actual class?
+ *
+ *      equation: overall_accuracy = 1/n * Σ(y == y')
+ *      where: n  = total number of documents
+ *             y  = document's actual class
+ *             y' = document's predicted class
+ *
+ *   2. For any given class X, what is the fraction of documents for which either
+ *       a) both actual and predicted class are equal to X (true positives)
+ *      or
+ *       b) both actual and predicted class are not equal to X (true negatives)
+ *
+ *      equation: accuracy(X) = 1/n * (TP(X) + TN(X))
+ *      where: X     = class being examined
+ *             n     = total number of documents
+ *             TP(X) = number of true positives wrt X
+ *             TN(X) = number of true negatives wrt X
  */
 public class Accuracy implements EvaluationMetric {
 
     public static final ParseField NAME = new ParseField("accuracy");
 
+    static final String OVERALL_ACCURACY_AGG_NAME = "classification_overall_accuracy";
+
     private static final String PAINLESS_TEMPLATE = "doc[''{0}''].value == doc[''{1}''].value";
-    private static final String CLASSES_AGG_NAME = "classification_classes";
-    private static final String PER_CLASS_ACCURACY_AGG_NAME = "classification_per_class_accuracy";
-    private static final String OVERALL_ACCURACY_AGG_NAME = "classification_overall_accuracy";
 
-    private static String buildScript(Object...args) {
-        return new MessageFormat(PAINLESS_TEMPLATE, Locale.ROOT).format(args);
+    private static Script buildScript(Object...args) {
+        return new Script(new MessageFormat(PAINLESS_TEMPLATE, Locale.ROOT).format(args));
     }
 
     private static final ObjectParser<Accuracy, Void> PARSER = new ObjectParser<>(NAME.getPreferredName(), true, Accuracy::new);
@@ -63,11 +77,20 @@ public static Accuracy fromXContent(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    private EvaluationMetricResult result;
+    private static final int MAX_CLASSES_CARDINALITY = 1000;
 
-    public Accuracy() {}
+    private final MulticlassConfusionMatrix matrix;
+    private final SetOnce<String> actualField = new SetOnce<>();
+    private final SetOnce<Double> overallAccuracy = new SetOnce<>();
+    private final SetOnce<Result> result = new SetOnce<>();
 
-    public Accuracy(StreamInput in) throws IOException {}
+    public Accuracy() {
+        this.matrix = new MulticlassConfusionMatrix(MAX_CLASSES_CARDINALITY, NAME.getPreferredName() + "_");
+    }
+
+    public Accuracy(StreamInput in) throws IOException {
+        this.matrix = new MulticlassConfusionMatrix(in);
+    }
 
     @Override
     public String getWriteableName() {
@@ -81,43 +104,79 @@ public String getName() {
 
     @Override
     public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
-        if (result != null) {
-            return Tuple.tuple(List.of(), List.of());
+        // Store given {@code actualField} for the purpose of generating error message in {@code process}.
+        this.actualField.trySet(actualField);
+        List<AggregationBuilder> aggs = new ArrayList<>();
+        List<PipelineAggregationBuilder> pipelineAggs = new ArrayList<>();
+        if (overallAccuracy.get() == null) {
+            aggs.add(AggregationBuilders.avg(OVERALL_ACCURACY_AGG_NAME).script(buildScript(actualField, predictedField)));
+        }
+        if (result.get() == null) {
+            Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> matrixAggs = matrix.aggs(actualField, predictedField);
+            aggs.addAll(matrixAggs.v1());
+            pipelineAggs.addAll(matrixAggs.v2());
         }
-        Script accuracyScript = new Script(buildScript(actualField, predictedField));
-        return Tuple.tuple(
-            List.of(
-                AggregationBuilders.terms(CLASSES_AGG_NAME)
-                    .field(actualField)
-                    .subAggregation(AggregationBuilders.avg(PER_CLASS_ACCURACY_AGG_NAME).script(accuracyScript)),
-                AggregationBuilders.avg(OVERALL_ACCURACY_AGG_NAME).script(accuracyScript)),
-            List.of());
+        return Tuple.tuple(aggs, pipelineAggs);
     }
 
     @Override
     public void process(Aggregations aggs) {
-        if (result != null) {
-            return;
+        if (overallAccuracy.get() == null && aggs.get(OVERALL_ACCURACY_AGG_NAME) instanceof NumericMetricsAggregation.SingleValue) {
+            NumericMetricsAggregation.SingleValue overallAccuracyAgg = aggs.get(OVERALL_ACCURACY_AGG_NAME);
+            overallAccuracy.set(overallAccuracyAgg.value());
         }
-        Terms classesAgg = aggs.get(CLASSES_AGG_NAME);
-        NumericMetricsAggregation.SingleValue overallAccuracyAgg = aggs.get(OVERALL_ACCURACY_AGG_NAME);
-        List<ActualClass> actualClasses = new ArrayList<>(classesAgg.getBuckets().size());
-        for (Terms.Bucket bucket : classesAgg.getBuckets()) {
-            String actualClass = bucket.getKeyAsString();
-            long actualClassDocCount = bucket.getDocCount();
-            NumericMetricsAggregation.SingleValue accuracyAgg = bucket.getAggregations().get(PER_CLASS_ACCURACY_AGG_NAME);
-            actualClasses.add(new ActualClass(actualClass, actualClassDocCount, accuracyAgg.value()));
+        matrix.process(aggs);
+        if (result.get() == null && matrix.getResult().isPresent()) {
+            if (matrix.getResult().get().getOtherActualClassCount() > 0) {
+                // This means there were more than {@code maxClassesCardinality} buckets.
+                // We cannot calculate per-class accuracy accurately, so we fail.
+                throw ExceptionsHelper.badRequestException(
+                    "Cannot calculate per-class accuracy. Cardinality of field [{}] is too high", actualField.get());
+            }
+            result.set(new Result(computePerClassAccuracy(matrix.getResult().get()), overallAccuracy.get()));
         }
-        result = new Result(actualClasses, overallAccuracyAgg.value());
     }
 
     @Override
-    public Optional<EvaluationMetricResult> getResult() {
-        return Optional.ofNullable(result);
+    public Optional<Result> getResult() {
+        return Optional.ofNullable(result.get());
+    }
+
+    /**
+     * Computes the per-class accuracy results based on multiclass confusion matrix's result.
+     * Time complexity of this method is linear wrt multiclass confusion matrix size, so O(n^2) where n is the matrix dimension.
+     * This method is visible for testing only.
+     */
+    static List<PerClassResult> computePerClassAccuracy(MulticlassConfusionMatrix.Result matrixResult) {
+        assert matrixResult.getOtherActualClassCount() == 0;
+        // Number of actual classes taken into account
+        int n = matrixResult.getConfusionMatrix().size();
+        // Total number of documents taken into account
+        long totalDocCount =
+            matrixResult.getConfusionMatrix().stream().mapToLong(MulticlassConfusionMatrix.ActualClass::getActualClassDocCount).sum();
+        List<PerClassResult> classes = new ArrayList<>(n);
+        for (int i = 0; i < n; ++i) {
+            String className = matrixResult.getConfusionMatrix().get(i).getActualClass();
+            // Start with the assumption that all the docs were predicted correctly.
+            long correctDocCount = totalDocCount;
+            for (int j = 0; j < n; ++j) {
+                if (i != j) {
+                    // Subtract errors (false negatives)
+                    correctDocCount -= matrixResult.getConfusionMatrix().get(i).getPredictedClasses().get(j).getCount();
+                    // Subtract errors (false positives)
+                    correctDocCount -= matrixResult.getConfusionMatrix().get(j).getPredictedClasses().get(i).getCount();
+                }
+            }
+            // Subtract errors (false negatives) for classes other than explicitly listed in confusion matrix
+            correctDocCount -= matrixResult.getConfusionMatrix().get(i).getOtherPredictedClassDocCount();
+            classes.add(new PerClassResult(className, ((double)correctDocCount) / totalDocCount));
+        }
+        return classes;
     }
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
+        matrix.writeTo(out);
     }
 
     @Override
@@ -131,25 +190,26 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
-        return true;
+        Accuracy that = (Accuracy) o;
+        return Objects.equals(this.matrix, that.matrix);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hashCode(NAME.getPreferredName());
+        return Objects.hash(matrix);
     }
 
     public static class Result implements EvaluationMetricResult {
 
-        private static final ParseField ACTUAL_CLASSES = new ParseField("actual_classes");
+        private static final ParseField CLASSES = new ParseField("classes");
         private static final ParseField OVERALL_ACCURACY = new ParseField("overall_accuracy");
 
         @SuppressWarnings("unchecked")
         private static final ConstructingObjectParser<Result, Void> PARSER =
-            new ConstructingObjectParser<>("accuracy_result", true, a -> new Result((List<ActualClass>) a[0], (double) a[1]));
+            new ConstructingObjectParser<>("accuracy_result", true, a -> new Result((List<PerClassResult>) a[0], (double) a[1]));
 
         static {
-            PARSER.declareObjectArray(constructorArg(), ActualClass.PARSER, ACTUAL_CLASSES);
+            PARSER.declareObjectArray(constructorArg(), PerClassResult.PARSER, CLASSES);
             PARSER.declareDouble(constructorArg(), OVERALL_ACCURACY);
         }
 
@@ -157,18 +217,18 @@ public static Result fromXContent(XContentParser parser) {
             return PARSER.apply(parser, null);
         }
 
-        /** List of actual classes. */
-        private final List<ActualClass> actualClasses;
-        /** Fraction of documents predicted correctly. */
+        /** List of per-class results. */
+        private final List<PerClassResult> classes;
+        /** Fraction of documents for which predicted class equals the actual class. */
         private final double overallAccuracy;
 
-        public Result(List<ActualClass> actualClasses, double overallAccuracy) {
-            this.actualClasses = Collections.unmodifiableList(ExceptionsHelper.requireNonNull(actualClasses, ACTUAL_CLASSES));
+        public Result(List<PerClassResult> classes, double overallAccuracy) {
+            this.classes = Collections.unmodifiableList(ExceptionsHelper.requireNonNull(classes, CLASSES));
             this.overallAccuracy = overallAccuracy;
         }
 
         public Result(StreamInput in) throws IOException {
-            this.actualClasses = Collections.unmodifiableList(in.readList(ActualClass::new));
+            this.classes = Collections.unmodifiableList(in.readList(PerClassResult::new));
             this.overallAccuracy = in.readDouble();
         }
 
@@ -182,8 +242,8 @@ public String getMetricName() {
             return NAME.getPreferredName();
         }
 
-        public List<ActualClass> getActualClasses() {
-            return actualClasses;
+        public List<PerClassResult> getClasses() {
+            return classes;
         }
 
         public double getOverallAccuracy() {
@@ -192,14 +252,14 @@ public double getOverallAccuracy() {
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
-            out.writeList(actualClasses);
+            out.writeList(classes);
             out.writeDouble(overallAccuracy);
         }
 
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
             builder.startObject();
-            builder.field(ACTUAL_CLASSES.getPreferredName(), actualClasses);
+            builder.field(CLASSES.getPreferredName(), classes);
             builder.field(OVERALL_ACCURACY.getPreferredName(), overallAccuracy);
             builder.endObject();
             return builder;
@@ -210,54 +270,47 @@ public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
             Result that = (Result) o;
-            return Objects.equals(this.actualClasses, that.actualClasses)
+            return Objects.equals(this.classes, that.classes)
                 && this.overallAccuracy == that.overallAccuracy;
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(actualClasses, overallAccuracy);
+            return Objects.hash(classes, overallAccuracy);
         }
     }
 
-    public static class ActualClass implements ToXContentObject, Writeable {
+    public static class PerClassResult implements ToXContentObject, Writeable {
 
-        private static final ParseField ACTUAL_CLASS = new ParseField("actual_class");
-        private static final ParseField ACTUAL_CLASS_DOC_COUNT = new ParseField("actual_class_doc_count");
+        private static final ParseField CLASS_NAME = new ParseField("class_name");
         private static final ParseField ACCURACY = new ParseField("accuracy");
 
         @SuppressWarnings("unchecked")
-        private static final ConstructingObjectParser<ActualClass, Void> PARSER =
-            new ConstructingObjectParser<>("accuracy_actual_class", true, a -> new ActualClass((String) a[0], (long) a[1], (double) a[2]));
+        private static final ConstructingObjectParser<PerClassResult, Void> PARSER =
+            new ConstructingObjectParser<>("accuracy_per_class_result", true, a -> new PerClassResult((String) a[0], (double) a[1]));
 
         static {
-            PARSER.declareString(constructorArg(), ACTUAL_CLASS);
-            PARSER.declareLong(constructorArg(), ACTUAL_CLASS_DOC_COUNT);
+            PARSER.declareString(constructorArg(), CLASS_NAME);
             PARSER.declareDouble(constructorArg(), ACCURACY);
         }
 
-        /** Name of the actual class. */
-        private final String actualClass;
-        /** Number of documents (examples) belonging to the {code actualClass} class. */
-        private final long actualClassDocCount;
-        /** Fraction of documents belonging to the {code actualClass} class predicted correctly. */
+        /** Name of the class. */
+        private final String className;
+        /** Fraction of documents that are either true positives or true negatives wrt {@code className}. */
         private final double accuracy;
 
-        public ActualClass(
-            String actualClass, long actualClassDocCount, double accuracy) {
-            this.actualClass = ExceptionsHelper.requireNonNull(actualClass, ACTUAL_CLASS);
-            this.actualClassDocCount = actualClassDocCount;
+        public PerClassResult(String className, double accuracy) {
+            this.className = ExceptionsHelper.requireNonNull(className, CLASS_NAME);
             this.accuracy = accuracy;
         }
 
-        public ActualClass(StreamInput in) throws IOException {
-            this.actualClass = in.readString();
-            this.actualClassDocCount = in.readVLong();
+        public PerClassResult(StreamInput in) throws IOException {
+            this.className = in.readString();
             this.accuracy = in.readDouble();
         }
 
-        public String getActualClass() {
-            return actualClass;
+        public String getClassName() {
+            return className;
         }
 
         public double getAccuracy() {
@@ -266,16 +319,14 @@ public double getAccuracy() {
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
-            out.writeString(actualClass);
-            out.writeVLong(actualClassDocCount);
+            out.writeString(className);
             out.writeDouble(accuracy);
         }
 
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
             builder.startObject();
-            builder.field(ACTUAL_CLASS.getPreferredName(), actualClass);
-            builder.field(ACTUAL_CLASS_DOC_COUNT.getPreferredName(), actualClassDocCount);
+            builder.field(CLASS_NAME.getPreferredName(), className);
             builder.field(ACCURACY.getPreferredName(), accuracy);
             builder.endObject();
             return builder;
@@ -285,15 +336,14 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
-            ActualClass that = (ActualClass) o;
-            return Objects.equals(this.actualClass, that.actualClass)
-                && this.actualClassDocCount == that.actualClassDocCount
+            PerClassResult that = (PerClassResult) o;
+            return Objects.equals(this.className, that.className)
                 && this.accuracy == that.accuracy;
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(actualClass, actualClassDocCount, accuracy);
+            return Objects.hash(className, accuracy);
         }
     }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
index 7b9d524abf6f7..e5a4de1605da0 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
+import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.collect.Tuple;
@@ -52,13 +54,16 @@ public class MulticlassConfusionMatrix implements EvaluationMetric {
     public static final ParseField NAME = new ParseField("multiclass_confusion_matrix");
 
     public static final ParseField SIZE = new ParseField("size");
+    public static final ParseField AGG_NAME_PREFIX = new ParseField("agg_name_prefix");
 
     private static final ConstructingObjectParser<MulticlassConfusionMatrix, Void> PARSER = createParser();
 
     private static ConstructingObjectParser<MulticlassConfusionMatrix, Void> createParser() {
         ConstructingObjectParser<MulticlassConfusionMatrix, Void>  parser =
-            new ConstructingObjectParser<>(NAME.getPreferredName(), true, args -> new MulticlassConfusionMatrix((Integer) args[0]));
+            new ConstructingObjectParser<>(
+                NAME.getPreferredName(), true, args -> new MulticlassConfusionMatrix((Integer) args[0], (String) args[1]));
         parser.declareInt(optionalConstructorArg(), SIZE);
+        parser.declareString(optionalConstructorArg(), AGG_NAME_PREFIX);
         return parser;
     }
 
@@ -66,31 +71,39 @@ public static MulticlassConfusionMatrix fromXContent(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    private static final String STEP_1_AGGREGATE_BY_ACTUAL_CLASS = NAME.getPreferredName() + "_step_1_by_actual_class";
-    private static final String STEP_2_AGGREGATE_BY_ACTUAL_CLASS = NAME.getPreferredName() + "_step_2_by_actual_class";
-    private static final String STEP_2_AGGREGATE_BY_PREDICTED_CLASS = NAME.getPreferredName() + "_step_2_by_predicted_class";
-    private static final String STEP_2_CARDINALITY_OF_ACTUAL_CLASS = NAME.getPreferredName() + "_step_2_cardinality_of_actual_class";
+    static final String STEP_1_AGGREGATE_BY_ACTUAL_CLASS = NAME.getPreferredName() + "_step_1_by_actual_class";
+    static final String STEP_2_AGGREGATE_BY_ACTUAL_CLASS = NAME.getPreferredName() + "_step_2_by_actual_class";
+    static final String STEP_2_AGGREGATE_BY_PREDICTED_CLASS = NAME.getPreferredName() + "_step_2_by_predicted_class";
+    static final String STEP_2_CARDINALITY_OF_ACTUAL_CLASS = NAME.getPreferredName() + "_step_2_cardinality_of_actual_class";
     private static final String OTHER_BUCKET_KEY = "_other_";
+    private static final String DEFAULT_AGG_NAME_PREFIX = "";
     private static final int DEFAULT_SIZE = 10;
     private static final int MAX_SIZE = 1000;
 
     private final int size;
-    private List<String> topActualClassNames;
-    private Result result;
+    private final String aggNamePrefix;
+    private final SetOnce<List<String>> topActualClassNames = new SetOnce<>();
+    private final SetOnce<Result> result = new SetOnce<>();
 
     public MulticlassConfusionMatrix() {
-        this((Integer) null);
+        this(null, null);
     }
 
-    public MulticlassConfusionMatrix(@Nullable Integer size) {
+    public MulticlassConfusionMatrix(@Nullable Integer size, @Nullable String aggNamePrefix) {
         if (size != null && (size <= 0 || size > MAX_SIZE)) {
             throw ExceptionsHelper.badRequestException("[{}] must be an integer in [1, {}]", SIZE.getPreferredName(), MAX_SIZE);
         }
         this.size = size != null ? size : DEFAULT_SIZE;
+        this.aggNamePrefix = aggNamePrefix != null ? aggNamePrefix : DEFAULT_AGG_NAME_PREFIX;
     }
 
     public MulticlassConfusionMatrix(StreamInput in) throws IOException {
         this.size = in.readVInt();
+        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            this.aggNamePrefix = in.readString();
+        } else {
+            this.aggNamePrefix = DEFAULT_AGG_NAME_PREFIX;
+        }
     }
 
     @Override
@@ -109,30 +122,30 @@ public int getSize() {
 
     @Override
     public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
-        if (topActualClassNames == null) {  // This is step 1
+        if (topActualClassNames.get() == null) {  // This is step 1
             return Tuple.tuple(
                 List.of(
-                    AggregationBuilders.terms(STEP_1_AGGREGATE_BY_ACTUAL_CLASS)
+                    AggregationBuilders.terms(aggName(STEP_1_AGGREGATE_BY_ACTUAL_CLASS))
                         .field(actualField)
                         .order(List.of(BucketOrder.count(false), BucketOrder.key(true)))
                         .size(size)),
                 List.of());
         }
-        if (result == null) {  // This is step 2
+        if (result.get() == null) {  // This is step 2
             KeyedFilter[] keyedFiltersActual =
-                topActualClassNames.stream()
+                topActualClassNames.get().stream()
                     .map(className -> new KeyedFilter(className, QueryBuilders.termQuery(actualField, className)))
                     .toArray(KeyedFilter[]::new);
             KeyedFilter[] keyedFiltersPredicted =
-                topActualClassNames.stream()
+                topActualClassNames.get().stream()
                     .map(className -> new KeyedFilter(className, QueryBuilders.termQuery(predictedField, className)))
                     .toArray(KeyedFilter[]::new);
             return Tuple.tuple(
                 List.of(
-                    AggregationBuilders.cardinality(STEP_2_CARDINALITY_OF_ACTUAL_CLASS)
+                    AggregationBuilders.cardinality(aggName(STEP_2_CARDINALITY_OF_ACTUAL_CLASS))
                         .field(actualField),
-                    AggregationBuilders.filters(STEP_2_AGGREGATE_BY_ACTUAL_CLASS, keyedFiltersActual)
-                        .subAggregation(AggregationBuilders.filters(STEP_2_AGGREGATE_BY_PREDICTED_CLASS, keyedFiltersPredicted)
+                    AggregationBuilders.filters(aggName(STEP_2_AGGREGATE_BY_ACTUAL_CLASS), keyedFiltersActual)
+                        .subAggregation(AggregationBuilders.filters(aggName(STEP_2_AGGREGATE_BY_PREDICTED_CLASS), keyedFiltersPredicted)
                             .otherBucket(true)
                             .otherBucketKey(OTHER_BUCKET_KEY))),
                 List.of());
@@ -142,18 +155,18 @@ public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> a
 
     @Override
     public void process(Aggregations aggs) {
-        if (topActualClassNames == null && aggs.get(STEP_1_AGGREGATE_BY_ACTUAL_CLASS) != null) {
-            Terms termsAgg = aggs.get(STEP_1_AGGREGATE_BY_ACTUAL_CLASS);
-            topActualClassNames = termsAgg.getBuckets().stream().map(Terms.Bucket::getKeyAsString).sorted().collect(Collectors.toList());
+        if (topActualClassNames.get() == null && aggs.get(aggName(STEP_1_AGGREGATE_BY_ACTUAL_CLASS)) != null) {
+            Terms termsAgg = aggs.get(aggName(STEP_1_AGGREGATE_BY_ACTUAL_CLASS));
+            topActualClassNames.set(termsAgg.getBuckets().stream().map(Terms.Bucket::getKeyAsString).sorted().collect(Collectors.toList()));
         }
-        if (result == null && aggs.get(STEP_2_AGGREGATE_BY_ACTUAL_CLASS) != null) {
-            Cardinality cardinalityAgg = aggs.get(STEP_2_CARDINALITY_OF_ACTUAL_CLASS);
-            Filters filtersAgg = aggs.get(STEP_2_AGGREGATE_BY_ACTUAL_CLASS);
+        if (result.get() == null && aggs.get(aggName(STEP_2_AGGREGATE_BY_ACTUAL_CLASS)) != null) {
+            Cardinality cardinalityAgg = aggs.get(aggName(STEP_2_CARDINALITY_OF_ACTUAL_CLASS));
+            Filters filtersAgg = aggs.get(aggName(STEP_2_AGGREGATE_BY_ACTUAL_CLASS));
             List<ActualClass> actualClasses = new ArrayList<>(filtersAgg.getBuckets().size());
             for (Filters.Bucket bucket : filtersAgg.getBuckets()) {
                 String actualClass = bucket.getKeyAsString();
                 long actualClassDocCount = bucket.getDocCount();
-                Filters subAgg = bucket.getAggregations().get(STEP_2_AGGREGATE_BY_PREDICTED_CLASS);
+                Filters subAgg = bucket.getAggregations().get(aggName(STEP_2_AGGREGATE_BY_PREDICTED_CLASS));
                 List<PredictedClass> predictedClasses = new ArrayList<>();
                 long otherPredictedClassDocCount = 0;
                 for (Filters.Bucket subBucket : subAgg.getBuckets()) {
@@ -168,18 +181,25 @@ public void process(Aggregations aggs) {
                 predictedClasses.sort(comparing(PredictedClass::getPredictedClass));
                 actualClasses.add(new ActualClass(actualClass, actualClassDocCount, predictedClasses, otherPredictedClassDocCount));
             }
-            result = new Result(actualClasses, Math.max(cardinalityAgg.getValue() - size, 0));
+            result.set(new Result(actualClasses, Math.max(cardinalityAgg.getValue() - size, 0)));
         }
     }
 
+    private String aggName(String aggNameWithoutPrefix) {
+        return aggNamePrefix + aggNameWithoutPrefix;
+    }
+
     @Override
-    public Optional<EvaluationMetricResult> getResult() {
-        return Optional.ofNullable(result);
+    public Optional<Result> getResult() {
+        return Optional.ofNullable(result.get());
     }
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(size);
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            out.writeString(aggNamePrefix);
+        }
     }
 
     @Override
@@ -195,12 +215,13 @@ public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
         MulticlassConfusionMatrix that = (MulticlassConfusionMatrix) o;
-        return Objects.equals(this.size, that.size);
+        return this.size == that.size
+            && Objects.equals(this.aggNamePrefix, that.aggNamePrefix);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(size);
+        return Objects.hash(size, aggNamePrefix);
     }
 
     public static class Result implements EvaluationMetricResult {
@@ -334,6 +355,10 @@ public String getActualClass() {
             return actualClass;
         }
 
+        public long getActualClassDocCount() {
+            return actualClassDocCount;
+        }
+
         public List<PredictedClass> getPredictedClasses() {
             return predictedClasses;
         }
@@ -410,6 +435,10 @@ public String getPredictedClass() {
             return predictedClass;
         }
 
+        public long getCount() {
+            return count;
+        }
+
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             out.writeString(predictedClass);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
index dd04f23710118..73c7723c86b96 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Precision.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
+import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -76,9 +77,9 @@ public static Precision fromXContent(XContentParser parser) {
 
     private static final int MAX_CLASSES_CARDINALITY = 1000;
 
-    private String actualField;
-    private List<String> topActualClassNames;
-    private EvaluationMetricResult result;
+    private final SetOnce<String> actualField = new SetOnce<>();
+    private final SetOnce<List<String>> topActualClassNames = new SetOnce<>();
+    private final SetOnce<Result> result = new SetOnce<>();
 
     public Precision() {}
 
@@ -97,8 +98,8 @@ public String getName() {
     @Override
     public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
         // Store given {@code actualField} for the purpose of generating error message in {@code process}.
-        this.actualField = actualField;
-        if (topActualClassNames == null) {  // This is step 1
+        this.actualField.trySet(actualField);
+        if (topActualClassNames.get() == null) {  // This is step 1
             return Tuple.tuple(
                 List.of(
                     AggregationBuilders.terms(ACTUAL_CLASSES_NAMES_AGG_NAME)
@@ -107,9 +108,9 @@ public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> a
                         .size(MAX_CLASSES_CARDINALITY)),
                 List.of());
         }
-        if (result == null) {  // This is step 2
+        if (result.get() == null) {  // This is step 2
             KeyedFilter[] keyedFiltersPredicted =
-                topActualClassNames.stream()
+                topActualClassNames.get().stream()
                     .map(className -> new KeyedFilter(className, QueryBuilders.termQuery(predictedField, className)))
                     .toArray(KeyedFilter[]::new);
             Script script = buildScript(actualField, predictedField);
@@ -127,18 +128,18 @@ public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> a
 
     @Override
     public void process(Aggregations aggs) {
-        if (topActualClassNames == null && aggs.get(ACTUAL_CLASSES_NAMES_AGG_NAME) instanceof Terms) {
+        if (topActualClassNames.get() == null && aggs.get(ACTUAL_CLASSES_NAMES_AGG_NAME) instanceof Terms) {
             Terms topActualClassesAgg = aggs.get(ACTUAL_CLASSES_NAMES_AGG_NAME);
             if (topActualClassesAgg.getSumOfOtherDocCounts() > 0) {
-                // This means there were more than {@code maxClassesCardinality} buckets.
+                // This means there were more than {@code MAX_CLASSES_CARDINALITY} buckets.
                 // We cannot calculate average precision accurately, so we fail.
                 throw ExceptionsHelper.badRequestException(
-                    "Cannot calculate average precision. Cardinality of field [{}] is too high", actualField);
+                    "Cannot calculate average precision. Cardinality of field [{}] is too high", actualField.get());
             }
-            topActualClassNames =
-                topActualClassesAgg.getBuckets().stream().map(Terms.Bucket::getKeyAsString).sorted().collect(Collectors.toList());
+            topActualClassNames.set(
+                topActualClassesAgg.getBuckets().stream().map(Terms.Bucket::getKeyAsString).sorted().collect(Collectors.toList()));
         }
-        if (result == null &&
+        if (result.get() == null &&
                 aggs.get(BY_PREDICTED_CLASS_AGG_NAME) instanceof Filters &&
                 aggs.get(AVG_PRECISION_AGG_NAME) instanceof NumericMetricsAggregation.SingleValue) {
             Filters byPredictedClassAgg = aggs.get(BY_PREDICTED_CLASS_AGG_NAME);
@@ -152,13 +153,13 @@ public void process(Aggregations aggs) {
                     classes.add(new PerClassResult(className, precision));
                 }
             }
-            result = new Result(classes, avgPrecisionAgg.value());
+            result.set(new Result(classes, avgPrecisionAgg.value()));
         }
     }
 
     @Override
-    public Optional<EvaluationMetricResult> getResult() {
-        return Optional.ofNullable(result);
+    public Optional<Result> getResult() {
+        return Optional.ofNullable(result.get());
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
index 01bdbe6db230b..0358820cc509c 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/Recall.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
+import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -70,8 +71,8 @@ public static Recall fromXContent(XContentParser parser) {
 
     private static final int MAX_CLASSES_CARDINALITY = 1000;
 
-    private String actualField;
-    private EvaluationMetricResult result;
+    private final SetOnce<String> actualField = new SetOnce<>();
+    private final SetOnce<Result> result = new SetOnce<>();
 
     public Recall() {}
 
@@ -90,8 +91,8 @@ public String getName() {
     @Override
     public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> aggs(String actualField, String predictedField) {
         // Store given {@code actualField} for the purpose of generating error message in {@code process}.
-        this.actualField = actualField;
-        if (result != null) {
+        this.actualField.trySet(actualField);
+        if (result.get() != null) {
             return Tuple.tuple(List.of(), List.of());
         }
         Script script = buildScript(actualField, predictedField);
@@ -109,15 +110,15 @@ public final Tuple<List<AggregationBuilder>, List<PipelineAggregationBuilder>> a
 
     @Override
     public void process(Aggregations aggs) {
-        if (result == null &&
+        if (result.get() == null &&
                 aggs.get(BY_ACTUAL_CLASS_AGG_NAME) instanceof Terms &&
                 aggs.get(AVG_RECALL_AGG_NAME) instanceof NumericMetricsAggregation.SingleValue) {
             Terms byActualClassAgg = aggs.get(BY_ACTUAL_CLASS_AGG_NAME);
             if (byActualClassAgg.getSumOfOtherDocCounts() > 0) {
-                // This means there were more than {@code maxClassesCardinality} buckets.
+                // This means there were more than {@code MAX_CLASSES_CARDINALITY} buckets.
                 // We cannot calculate average recall accurately, so we fail.
                 throw ExceptionsHelper.badRequestException(
-                    "Cannot calculate average recall. Cardinality of field [{}] is too high", actualField);
+                    "Cannot calculate average recall. Cardinality of field [{}] is too high", actualField.get());
             }
             NumericMetricsAggregation.SingleValue avgRecallAgg = aggs.get(AVG_RECALL_AGG_NAME);
             List<PerClassResult> classes = new ArrayList<>(byActualClassAgg.getBuckets().size());
@@ -126,13 +127,13 @@ public void process(Aggregations aggs) {
                 NumericMetricsAggregation.SingleValue recallAgg = bucket.getAggregations().get(PER_ACTUAL_CLASS_RECALL_AGG_NAME);
                 classes.add(new PerClassResult(className, recallAgg.value()));
             }
-            result = new Result(classes, avgRecallAgg.value());
+            result.set(new Result(classes, avgRecallAgg.value()));
         }
     }
 
     @Override
-    public Optional<EvaluationMetricResult> getResult() {
-        return Optional.ofNullable(result);
+    public Optional<Result> getResult() {
+        return Optional.ofNullable(result.get());
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyResultTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyResultTests.java
index 8fb4c6c02408d..176aa6e9a309b 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyResultTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyResultTests.java
@@ -8,9 +8,9 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy.ActualClass;
-import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy.Result;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy.PerClassResult;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy.Result;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -22,13 +22,13 @@ public class AccuracyResultTests extends AbstractWireSerializingTestCase<Result>
     public static Result createRandom() {
         int numClasses = randomIntBetween(2, 100);
         List<String> classNames = Stream.generate(() -> randomAlphaOfLength(10)).limit(numClasses).collect(Collectors.toList());
-        List<ActualClass> actualClasses = new ArrayList<>(numClasses);
+        List<PerClassResult> classes = new ArrayList<>(numClasses);
         for (int i = 0; i < numClasses; i++) {
             double accuracy = randomDoubleBetween(0.0, 1.0, true);
-            actualClasses.add(new ActualClass(classNames.get(i), randomNonNegativeLong(), accuracy));
+            classes.add(new PerClassResult(classNames.get(i), accuracy));
         }
         double overallAccuracy = randomDoubleBetween(0.0, 1.0, true);
-        return new Result(actualClasses, overallAccuracy);
+        return new Result(classes, overallAccuracy);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyTests.java
index 1809f0e735125..cac591a17d303 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/AccuracyTests.java
@@ -5,17 +5,26 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification;
 
+import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.aggregations.Aggregations;
 import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy.PerClassResult;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy.Result;
 
 import java.io.IOException;
-import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockCardinality;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFilters;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockFiltersBucket;
 import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockSingleValue;
 import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTerms;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.MockAggregations.mockTermsBucket;
+import static org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.TupleMatchers.isTuple;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.equalTo;
 
 public class AccuracyTests extends AbstractSerializingTestCase<Accuracy> {
@@ -45,53 +54,109 @@ public static Accuracy createRandom() {
     }
 
     public void testProcess() {
-        Aggregations aggs = new Aggregations(Arrays.asList(
-            mockTerms("classification_classes"),
-            mockSingleValue("classification_overall_accuracy", 0.8123),
-            mockSingleValue("some_other_single_metric_agg", 0.2377)
-        ));
+        Aggregations aggs = new Aggregations(List.of(
+            mockTerms(
+                "accuracy_" + MulticlassConfusionMatrix.STEP_1_AGGREGATE_BY_ACTUAL_CLASS,
+                List.of(
+                    mockTermsBucket("dog", new Aggregations(List.of())),
+                    mockTermsBucket("cat", new Aggregations(List.of()))),
+                100L),
+            mockFilters(
+                "accuracy_" + MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_ACTUAL_CLASS,
+                List.of(
+                    mockFiltersBucket(
+                        "dog",
+                        30,
+                        new Aggregations(List.of(mockFilters(
+                            "accuracy_" + MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_PREDICTED_CLASS,
+                            List.of(mockFiltersBucket("cat", 10L), mockFiltersBucket("dog", 20L), mockFiltersBucket("_other_", 0L)))))),
+                    mockFiltersBucket(
+                        "cat",
+                        70,
+                        new Aggregations(List.of(mockFilters(
+                            "accuracy_" + MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_PREDICTED_CLASS,
+                            List.of(mockFiltersBucket("cat", 30L), mockFiltersBucket("dog", 40L), mockFiltersBucket("_other_", 0L)))))))),
+            mockCardinality("accuracy_" + MulticlassConfusionMatrix.STEP_2_CARDINALITY_OF_ACTUAL_CLASS, 1000L),
+            mockSingleValue(Accuracy.OVERALL_ACCURACY_AGG_NAME, 0.5)));
 
         Accuracy accuracy = new Accuracy();
         accuracy.process(aggs);
 
-        assertThat(accuracy.getResult().get(), equalTo(new Accuracy.Result(List.of(), 0.8123)));
+        assertThat(accuracy.aggs("act", "pred"), isTuple(empty(), empty()));
+
+        Result result = accuracy.getResult().get();
+        assertThat(result.getMetricName(), equalTo(Accuracy.NAME.getPreferredName()));
+        assertThat(
+            result.getClasses(),
+            equalTo(
+                List.of(
+                    new PerClassResult("dog", 0.5),
+                    new PerClassResult("cat", 0.5))));
+        assertThat(result.getOverallAccuracy(), equalTo(0.5));
+    }
+
+    public void testProcess_GivenCardinalityTooHigh() {
+        Aggregations aggs = new Aggregations(List.of(
+            mockTerms(
+                "accuracy_" + MulticlassConfusionMatrix.STEP_1_AGGREGATE_BY_ACTUAL_CLASS,
+                List.of(
+                    mockTermsBucket("dog", new Aggregations(List.of())),
+                    mockTermsBucket("cat", new Aggregations(List.of()))),
+                100L),
+            mockFilters(
+                "accuracy_" + MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_ACTUAL_CLASS,
+                List.of(
+                    mockFiltersBucket(
+                        "dog",
+                        30,
+                        new Aggregations(List.of(mockFilters(
+                            "accuracy_" + MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_PREDICTED_CLASS,
+                            List.of(mockFiltersBucket("cat", 10L), mockFiltersBucket("dog", 20L), mockFiltersBucket("_other_", 0L)))))),
+                    mockFiltersBucket(
+                        "cat",
+                        70,
+                        new Aggregations(List.of(mockFilters(
+                            "accuracy_" + MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_PREDICTED_CLASS,
+                            List.of(mockFiltersBucket("cat", 30L), mockFiltersBucket("dog", 40L), mockFiltersBucket("_other_", 0L)))))))),
+            mockCardinality("accuracy_" + MulticlassConfusionMatrix.STEP_2_CARDINALITY_OF_ACTUAL_CLASS, 1001L),
+            mockSingleValue(Accuracy.OVERALL_ACCURACY_AGG_NAME, 0.5)));
+
+        Accuracy accuracy = new Accuracy();
+        accuracy.aggs("foo", "bar");
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> accuracy.process(aggs));
+        assertThat(e.getMessage(), containsString("Cardinality of field [foo] is too high"));
     }
 
-    public void testProcess_GivenMissingAgg() {
-        {
-            Aggregations aggs = new Aggregations(Arrays.asList(
-                mockTerms("classification_classes"),
-                mockSingleValue("some_other_single_metric_agg", 0.2377)
-            ));
-            Accuracy accuracy = new Accuracy();
-            expectThrows(NullPointerException.class, () -> accuracy.process(aggs));
-        }
-        {
-            Aggregations aggs = new Aggregations(Arrays.asList(
-                mockSingleValue("classification_overall_accuracy", 0.8123),
-                mockSingleValue("some_other_single_metric_agg", 0.2377)
-            ));
-            Accuracy accuracy = new Accuracy();
-            expectThrows(NullPointerException.class, () -> accuracy.process(aggs));
-        }
+    public void testComputePerClassAccuracy() {
+        assertThat(
+            Accuracy.computePerClassAccuracy(
+                new MulticlassConfusionMatrix.Result(
+                    List.of(
+                        new MulticlassConfusionMatrix.ActualClass("A", 14, List.of(
+                            new MulticlassConfusionMatrix.PredictedClass("A", 1),
+                            new MulticlassConfusionMatrix.PredictedClass("B", 6),
+                            new MulticlassConfusionMatrix.PredictedClass("C", 4)
+                        ), 3L),
+                        new MulticlassConfusionMatrix.ActualClass("B", 20, List.of(
+                            new MulticlassConfusionMatrix.PredictedClass("A", 5),
+                            new MulticlassConfusionMatrix.PredictedClass("B", 3),
+                            new MulticlassConfusionMatrix.PredictedClass("C", 9)
+                        ), 3L),
+                        new MulticlassConfusionMatrix.ActualClass("C", 17, List.of(
+                            new MulticlassConfusionMatrix.PredictedClass("A", 8),
+                            new MulticlassConfusionMatrix.PredictedClass("B", 2),
+                            new MulticlassConfusionMatrix.PredictedClass("C", 7)
+                        ), 0L)),
+                    0)),
+            equalTo(
+                List.of(
+                    new Accuracy.PerClassResult("A", 25.0 / 51),  // 13 false positives, 13 false negatives
+                    new Accuracy.PerClassResult("B", 26.0 / 51),  //  8 false positives, 17 false negatives
+                    new Accuracy.PerClassResult("C", 28.0 / 51))) // 13 false positives, 10 false negatives
+        );
     }
 
-    public void testProcess_GivenAggOfWrongType() {
-        {
-            Aggregations aggs = new Aggregations(Arrays.asList(
-                mockTerms("classification_classes"),
-                mockTerms("classification_overall_accuracy")
-            ));
-            Accuracy accuracy = new Accuracy();
-            expectThrows(ClassCastException.class, () -> accuracy.process(aggs));
-        }
-        {
-            Aggregations aggs = new Aggregations(Arrays.asList(
-                mockSingleValue("classification_classes", 1.0),
-                mockSingleValue("classification_overall_accuracy", 0.8123)
-            ));
-            Accuracy accuracy = new Accuracy();
-            expectThrows(ClassCastException.class, () -> accuracy.process(aggs));
-        }
+    public void testComputePerClassAccuracy_OtherActualClassCountIsNonZero() {
+        expectThrows(AssertionError.class, () -> Accuracy.computePerClassAccuracy(new MulticlassConfusionMatrix.Result(List.of(), 1)));
     }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
index f145a06c3c894..8c02a3c2c6fc3 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrixTests.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.ActualClass;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.PredictedClass;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix.Result;
 
 import java.io.IOException;
 import java.util.List;
@@ -54,20 +55,23 @@ protected boolean supportsUnknownFields() {
 
     public static MulticlassConfusionMatrix createRandom() {
         Integer size = randomBoolean() ? null : randomIntBetween(1, 1000);
-        return new MulticlassConfusionMatrix(size);
+        return new MulticlassConfusionMatrix(size, null);
     }
 
     public void testConstructor_SizeValidationFailures() {
         {
-            ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> new MulticlassConfusionMatrix(-1));
+            ElasticsearchStatusException e =
+                expectThrows(ElasticsearchStatusException.class, () -> new MulticlassConfusionMatrix(-1, null));
             assertThat(e.getMessage(), equalTo("[size] must be an integer in [1, 1000]"));
         }
         {
-            ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> new MulticlassConfusionMatrix(0));
+            ElasticsearchStatusException e =
+                expectThrows(ElasticsearchStatusException.class, () -> new MulticlassConfusionMatrix(0, null));
             assertThat(e.getMessage(), equalTo("[size] must be an integer in [1, 1000]"));
         }
         {
-            ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> new MulticlassConfusionMatrix(1001));
+            ElasticsearchStatusException e =
+                expectThrows(ElasticsearchStatusException.class, () -> new MulticlassConfusionMatrix(1001, null));
             assertThat(e.getMessage(), equalTo("[size] must be an integer in [1, 1000]"));
         }
     }
@@ -82,34 +86,34 @@ public void testAggs() {
     public void testEvaluate() {
         Aggregations aggs = new Aggregations(List.of(
             mockTerms(
-                "multiclass_confusion_matrix_step_1_by_actual_class",
+                MulticlassConfusionMatrix.STEP_1_AGGREGATE_BY_ACTUAL_CLASS,
                 List.of(
                     mockTermsBucket("dog", new Aggregations(List.of())),
                     mockTermsBucket("cat", new Aggregations(List.of()))),
                 0L),
             mockFilters(
-                "multiclass_confusion_matrix_step_2_by_actual_class",
+                MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_ACTUAL_CLASS,
                 List.of(
                     mockFiltersBucket(
                         "dog",
                         30,
                         new Aggregations(List.of(mockFilters(
-                            "multiclass_confusion_matrix_step_2_by_predicted_class",
+                            MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_PREDICTED_CLASS,
                             List.of(mockFiltersBucket("cat", 10L), mockFiltersBucket("dog", 20L), mockFiltersBucket("_other_", 0L)))))),
                     mockFiltersBucket(
                         "cat",
                         70,
                         new Aggregations(List.of(mockFilters(
-                            "multiclass_confusion_matrix_step_2_by_predicted_class",
+                            MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_PREDICTED_CLASS,
                             List.of(mockFiltersBucket("cat", 30L), mockFiltersBucket("dog", 40L), mockFiltersBucket("_other_", 0L)))))))),
-            mockCardinality("multiclass_confusion_matrix_step_2_cardinality_of_actual_class", 2L)));
+            mockCardinality(MulticlassConfusionMatrix.STEP_2_CARDINALITY_OF_ACTUAL_CLASS, 2L)));
 
-        MulticlassConfusionMatrix confusionMatrix = new MulticlassConfusionMatrix(2);
+        MulticlassConfusionMatrix confusionMatrix = new MulticlassConfusionMatrix(2, null);
         confusionMatrix.process(aggs);
 
         assertThat(confusionMatrix.aggs("act", "pred"), isTuple(empty(), empty()));
-        MulticlassConfusionMatrix.Result result = (MulticlassConfusionMatrix.Result) confusionMatrix.getResult().get();
-        assertThat(result.getMetricName(), equalTo("multiclass_confusion_matrix"));
+        Result result = confusionMatrix.getResult().get();
+        assertThat(result.getMetricName(), equalTo(MulticlassConfusionMatrix.NAME.getPreferredName()));
         assertThat(
             result.getConfusionMatrix(),
             equalTo(
@@ -122,34 +126,34 @@ public void testEvaluate() {
     public void testEvaluate_OtherClassesCountGreaterThanZero() {
         Aggregations aggs = new Aggregations(List.of(
             mockTerms(
-                "multiclass_confusion_matrix_step_1_by_actual_class",
+                MulticlassConfusionMatrix.STEP_1_AGGREGATE_BY_ACTUAL_CLASS,
                 List.of(
                     mockTermsBucket("dog", new Aggregations(List.of())),
                     mockTermsBucket("cat", new Aggregations(List.of()))),
                 100L),
             mockFilters(
-                "multiclass_confusion_matrix_step_2_by_actual_class",
+                MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_ACTUAL_CLASS,
                 List.of(
                     mockFiltersBucket(
                         "dog",
                         30,
                         new Aggregations(List.of(mockFilters(
-                            "multiclass_confusion_matrix_step_2_by_predicted_class",
+                            MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_PREDICTED_CLASS,
                             List.of(mockFiltersBucket("cat", 10L), mockFiltersBucket("dog", 20L), mockFiltersBucket("_other_", 0L)))))),
                     mockFiltersBucket(
                         "cat",
                         85,
                         new Aggregations(List.of(mockFilters(
-                            "multiclass_confusion_matrix_step_2_by_predicted_class",
+                            MulticlassConfusionMatrix.STEP_2_AGGREGATE_BY_PREDICTED_CLASS,
                             List.of(mockFiltersBucket("cat", 30L), mockFiltersBucket("dog", 40L), mockFiltersBucket("_other_", 15L)))))))),
-            mockCardinality("multiclass_confusion_matrix_step_2_cardinality_of_actual_class", 5L)));
+            mockCardinality(MulticlassConfusionMatrix.STEP_2_CARDINALITY_OF_ACTUAL_CLASS, 5L)));
 
-        MulticlassConfusionMatrix confusionMatrix = new MulticlassConfusionMatrix(2);
+        MulticlassConfusionMatrix confusionMatrix = new MulticlassConfusionMatrix(2, null);
         confusionMatrix.process(aggs);
 
         assertThat(confusionMatrix.aggs("act", "pred"), isTuple(empty(), empty()));
-        MulticlassConfusionMatrix.Result result = (MulticlassConfusionMatrix.Result) confusionMatrix.getResult().get();
-        assertThat(result.getMetricName(), equalTo("multiclass_confusion_matrix"));
+        Result result = confusionMatrix.getResult().get();
+        assertThat(result.getMetricName(), equalTo(MulticlassConfusionMatrix.NAME.getPreferredName()));
         assertThat(
             result.getConfusionMatrix(),
             equalTo(
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
index 437b2ddbf5180..da5439f6298dc 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
@@ -11,6 +11,7 @@
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction;
+import org.elasticsearch.xpack.core.ml.dataframe.evaluation.EvaluationMetricResult;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Precision;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Recall;
@@ -21,6 +22,8 @@
 
 import java.util.List;
 
+import static java.util.stream.Collectors.toList;
+import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasSize;
@@ -52,10 +55,28 @@ public void testEvaluate_DefaultMetrics() {
             evaluateDataFrame(ANIMALS_DATA_INDEX, new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, null));
 
         assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
-        assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
         assertThat(
-            evaluateDataFrameResponse.getMetrics().get(0).getMetricName(),
-            equalTo(MulticlassConfusionMatrix.NAME.getPreferredName()));
+            evaluateDataFrameResponse.getMetrics().stream().map(EvaluationMetricResult::getMetricName).collect(toList()),
+            contains(MulticlassConfusionMatrix.NAME.getPreferredName()));
+    }
+
+    public void testEvaluate_AllMetrics() {
+        EvaluateDataFrameAction.Response evaluateDataFrameResponse =
+            evaluateDataFrame(
+                ANIMALS_DATA_INDEX,
+                new Classification(
+                    ANIMAL_NAME_FIELD,
+                    ANIMAL_NAME_PREDICTION_FIELD,
+                    List.of(new Accuracy(), new MulticlassConfusionMatrix(), new Precision(), new Recall())));
+
+        assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
+        assertThat(
+            evaluateDataFrameResponse.getMetrics().stream().map(EvaluationMetricResult::getMetricName).collect(toList()),
+            contains(
+                Accuracy.NAME.getPreferredName(),
+                MulticlassConfusionMatrix.NAME.getPreferredName(),
+                Precision.NAME.getPreferredName(),
+                Recall.NAME.getPreferredName()));
     }
 
     public void testEvaluate_Accuracy_KeywordField() {
@@ -69,14 +90,14 @@ public void testEvaluate_Accuracy_KeywordField() {
         Accuracy.Result accuracyResult = (Accuracy.Result) evaluateDataFrameResponse.getMetrics().get(0);
         assertThat(accuracyResult.getMetricName(), equalTo(Accuracy.NAME.getPreferredName()));
         assertThat(
-            accuracyResult.getActualClasses(),
+            accuracyResult.getClasses(),
             equalTo(
                 List.of(
-                    new Accuracy.ActualClass("ant", 15, 1.0 / 15),
-                    new Accuracy.ActualClass("cat", 15, 1.0 / 15),
-                    new Accuracy.ActualClass("dog", 15, 1.0 / 15),
-                    new Accuracy.ActualClass("fox", 15, 1.0 / 15),
-                    new Accuracy.ActualClass("mouse", 15, 1.0 / 15))));
+                    new Accuracy.PerClassResult("ant", 47.0 / 75),
+                    new Accuracy.PerClassResult("cat", 47.0 / 75),
+                    new Accuracy.PerClassResult("dog", 47.0 / 75),
+                    new Accuracy.PerClassResult("fox", 47.0 / 75),
+                    new Accuracy.PerClassResult("mouse", 47.0 / 75))));
         assertThat(accuracyResult.getOverallAccuracy(), equalTo(5.0 / 75));
     }
 
@@ -91,13 +112,14 @@ public void testEvaluate_Accuracy_IntegerField() {
         Accuracy.Result accuracyResult = (Accuracy.Result) evaluateDataFrameResponse.getMetrics().get(0);
         assertThat(accuracyResult.getMetricName(), equalTo(Accuracy.NAME.getPreferredName()));
         assertThat(
-            accuracyResult.getActualClasses(),
-            equalTo(List.of(
-                new Accuracy.ActualClass("1", 15, 1.0 / 15),
-                new Accuracy.ActualClass("2", 15, 2.0 / 15),
-                new Accuracy.ActualClass("3", 15, 3.0 / 15),
-                new Accuracy.ActualClass("4", 15, 4.0 / 15),
-                new Accuracy.ActualClass("5", 15, 5.0 / 15))));
+            accuracyResult.getClasses(),
+            equalTo(
+                List.of(
+                    new Accuracy.PerClassResult("1", 57.0 / 75),
+                    new Accuracy.PerClassResult("2", 54.0 / 75),
+                    new Accuracy.PerClassResult("3", 51.0 / 75),
+                    new Accuracy.PerClassResult("4", 48.0 / 75),
+                    new Accuracy.PerClassResult("5", 45.0 / 75))));
         assertThat(accuracyResult.getOverallAccuracy(), equalTo(15.0 / 75));
     }
 
@@ -112,10 +134,11 @@ public void testEvaluate_Accuracy_BooleanField() {
         Accuracy.Result accuracyResult = (Accuracy.Result) evaluateDataFrameResponse.getMetrics().get(0);
         assertThat(accuracyResult.getMetricName(), equalTo(Accuracy.NAME.getPreferredName()));
         assertThat(
-            accuracyResult.getActualClasses(),
-            equalTo(List.of(
-                new Accuracy.ActualClass("true", 45, 27.0 / 45),
-                new Accuracy.ActualClass("false", 30, 18.0 / 30))));
+            accuracyResult.getClasses(),
+            equalTo(
+                List.of(
+                    new Accuracy.PerClassResult("false", 18.0 / 30),
+                    new Accuracy.PerClassResult("true", 27.0 / 45))));
         assertThat(accuracyResult.getOverallAccuracy(), equalTo(45.0 / 75));
     }
 
@@ -250,7 +273,7 @@ public void testEvaluate_ConfusionMatrixMetricWithUserProvidedSize() {
         EvaluateDataFrameAction.Response evaluateDataFrameResponse =
             evaluateDataFrame(
                 ANIMALS_DATA_INDEX,
-                new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new MulticlassConfusionMatrix(3))));
+                new Classification(ANIMAL_NAME_FIELD, ANIMAL_NAME_PREDICTION_FIELD, List.of(new MulticlassConfusionMatrix(3, null))));
 
         assertThat(evaluateDataFrameResponse.getEvaluationName(), equalTo(Classification.NAME.getPreferredName()));
         assertThat(evaluateDataFrameResponse.getMetrics(), hasSize(1));
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index fc2739c0a70e3..978b11efb0f39 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -466,12 +466,10 @@ private <T> void assertEvaluation(String dependentVariable, List<T> dependentVar
         {   // Accuracy
             Accuracy.Result accuracyResult = (Accuracy.Result) evaluateDataFrameResponse.getMetrics().get(0);
             assertThat(accuracyResult.getMetricName(), equalTo(Accuracy.NAME.getPreferredName()));
-            List<Accuracy.ActualClass> actualClasses = accuracyResult.getActualClasses();
-            assertThat(
-                actualClasses.stream().map(Accuracy.ActualClass::getActualClass).collect(toList()),
-                equalTo(dependentVariableValuesAsStrings));
-            actualClasses.forEach(
-                actualClass -> assertThat(actualClass.getAccuracy(), allOf(greaterThanOrEqualTo(0.0), lessThanOrEqualTo(1.0))));
+            for (Accuracy.PerClassResult klass : accuracyResult.getClasses()) {
+                assertThat(klass.getClassName(), is(in(dependentVariableValuesAsStrings)));
+                assertThat(klass.getAccuracy(), allOf(greaterThanOrEqualTo(0.0), lessThanOrEqualTo(1.0)));
+            }
         }
 
         {   // MulticlassConfusionMatrix
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/evaluate_data_frame.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/evaluate_data_frame.yml
index 95a7ef4e33218..2b16b79ac84b4 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/evaluate_data_frame.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/evaluate_data_frame.yml
@@ -620,16 +620,13 @@ setup:
 
   - match:
       classification.accuracy:
-        actual_classes:
-          - actual_class: "cat"
-            actual_class_doc_count: 3
-            accuracy: 0.6666666666666666  # 2 out of 3
-          - actual_class: "dog"
-            actual_class_doc_count: 3
-            accuracy: 0.6666666666666666  # 2 out of 3
-          - actual_class: "mouse"
-            actual_class_doc_count: 2
-            accuracy: 0.5  # 1 out of 2
+        classes:
+          - class_name: "cat"
+            accuracy: 0.625  # 5 out of 8
+          - class_name: "dog"
+            accuracy: 0.75  # 6 out of 8
+          - class_name: "mouse"
+            accuracy: 0.875  # 7 out of 8
         overall_accuracy: 0.625  # 5 out of 8
 ---
 "Test classification precision":

From bf5e87f5384ab3719208835f6f3d9d01cf828584 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Fri, 20 Dec 2019 14:34:56 +0100
Subject: [PATCH 304/686] reenable bwc test now that #50272 is merged (#50430)

---
 build.gradle | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/build.gradle b/build.gradle
index e465a21a09842..b03bb7e5a3794 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = false
-final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/50272" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = true
+final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")

From 1ab7a4b0a57d6813442526eca073740ccfcedacf Mon Sep 17 00:00:00 2001
From: Florian Kelbert <florian.kelbert@elastic.co>
Date: Fri, 20 Dec 2019 13:47:24 +0000
Subject: [PATCH 305/686] [DOCS] Fix typo in bucket sum aggregation docs
 (#50431)

---
 .../aggregations/pipeline/sum-bucket-aggregation.asciidoc       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/aggregations/pipeline/sum-bucket-aggregation.asciidoc b/docs/reference/aggregations/pipeline/sum-bucket-aggregation.asciidoc
index 1bae8bcb5251a..81375967cfe8b 100644
--- a/docs/reference/aggregations/pipeline/sum-bucket-aggregation.asciidoc
+++ b/docs/reference/aggregations/pipeline/sum-bucket-aggregation.asciidoc
@@ -1,7 +1,7 @@
 [[search-aggregations-pipeline-sum-bucket-aggregation]]
 === Sum Bucket Aggregation
 
-A sibling pipeline aggregation which calculates the sum across all bucket of a specified metric in a sibling aggregation.
+A sibling pipeline aggregation which calculates the sum across all buckets of a specified metric in a sibling aggregation.
 The specified metric must be numeric and the sibling aggregation must be a multi-bucket aggregation.
 
 ==== Syntax

From 9162267960ee31ec0ac35a741b31df35b8c8b6d5 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Fri, 20 Dec 2019 15:43:00 +0100
Subject: [PATCH 306/686] Disable slm in AbstractWatcherIntegrationTestCase
 (#50422)

SLM isn't required tests extending from this base class and
only add noise during test suite teardown.

Closes #50302
---
 .../xpack/watcher/test/AbstractWatcherIntegrationTestCase.java | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
index 0c1377ac79767..d276718ce2f7a 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
@@ -117,6 +117,9 @@ protected Settings nodeSettings(int nodeOrdinal) {
                 .put("xpack.watcher.execution.scroll.size", randomIntBetween(1, 100))
                 .put("xpack.watcher.watch.scroll.size", randomIntBetween(1, 100))
                 .put("index.lifecycle.history_index_enabled", false)
+                // SLM can cause timing issues during testsuite teardown: https://github.com/elastic/elasticsearch/issues/50302
+                // SLM is not required for tests extending from this base class and only add noise.
+                .put("xpack.slm.enabled", false)
                 .build();
     }
 

From f012958ec88174c0ee738bc56e1f21e862cfc906 Mon Sep 17 00:00:00 2001
From: Igor Motov <igor@motovs.org>
Date: Fri, 20 Dec 2019 04:47:42 -1000
Subject: [PATCH 307/686] Geo: Switch generated GeoJson type names to camel
 case (#50285) (#50400)

Switches generated GeoJson type names to camel case
to conform to the standard.

Closes #49568
---
 .../ingest/processors/circle.asciidoc          |  2 +-
 .../org/elasticsearch/common/geo/GeoJson.java  | 18 +++++++++---------
 .../common/geo/GeometryParserTests.java        |  4 ++--
 .../index/query/GeoShapeQueryBuilderTests.java |  2 +-
 .../index/query/ShapeQueryBuilderTests.java    |  2 +-
 5 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/reference/ingest/processors/circle.asciidoc b/docs/reference/ingest/processors/circle.asciidoc
index 300d7763fe634..a8a6bda02f8e2 100644
--- a/docs/reference/ingest/processors/circle.asciidoc
+++ b/docs/reference/ingest/processors/circle.asciidoc
@@ -128,7 +128,7 @@ The response from the above index request:
           [30.000365257263184, 10.0]
         ]
       ],
-      "type": "polygon"
+      "type": "Polygon"
     }
   }
 }
diff --git a/server/src/main/java/org/elasticsearch/common/geo/GeoJson.java b/server/src/main/java/org/elasticsearch/common/geo/GeoJson.java
index 0a1454a868738..5eb327588fb80 100644
--- a/server/src/main/java/org/elasticsearch/common/geo/GeoJson.java
+++ b/server/src/main/java/org/elasticsearch/common/geo/GeoJson.java
@@ -382,17 +382,17 @@ public static String getGeoJsonName(Geometry geometry) {
         return geometry.visit(new GeometryVisitor<>() {
             @Override
             public String visit(Circle circle) {
-                return "circle";
+                return "Circle";
             }
 
             @Override
             public String visit(GeometryCollection<?> collection) {
-                return "geometrycollection";
+                return "GeometryCollection";
             }
 
             @Override
             public String visit(Line line) {
-                return "linestring";
+                return "LineString";
             }
 
             @Override
@@ -402,32 +402,32 @@ public String visit(LinearRing ring) {
 
             @Override
             public String visit(MultiLine multiLine) {
-                return "multilinestring";
+                return "MultiLineString";
             }
 
             @Override
             public String visit(MultiPoint multiPoint) {
-                return "multipoint";
+                return "MultiPoint";
             }
 
             @Override
             public String visit(MultiPolygon multiPolygon) {
-                return "multipolygon";
+                return "MultiPolygon";
             }
 
             @Override
             public String visit(Point point) {
-                return "point";
+                return "Point";
             }
 
             @Override
             public String visit(Polygon polygon) {
-                return "polygon";
+                return "Polygon";
             }
 
             @Override
             public String visit(Rectangle rectangle) {
-                return "envelope";
+                return "Envelope";
             }
         });
     }
diff --git a/server/src/test/java/org/elasticsearch/common/geo/GeometryParserTests.java b/server/src/test/java/org/elasticsearch/common/geo/GeometryParserTests.java
index df4b47f23689f..4c53d40fb75db 100644
--- a/server/src/test/java/org/elasticsearch/common/geo/GeometryParserTests.java
+++ b/server/src/test/java/org/elasticsearch/common/geo/GeometryParserTests.java
@@ -51,7 +51,7 @@ public void testGeoJsonParsing() throws Exception {
             assertEquals(new Point(100, 0), format.fromXContent(parser));
             XContentBuilder newGeoJson = XContentFactory.jsonBuilder();
             format.toXContent(new Point(100, 10), newGeoJson, ToXContent.EMPTY_PARAMS);
-            assertEquals("{\"type\":\"point\",\"coordinates\":[100.0,10.0]}", Strings.toString(newGeoJson));
+            assertEquals("{\"type\":\"Point\",\"coordinates\":[100.0,10.0]}", Strings.toString(newGeoJson));
         }
 
         XContentBuilder pointGeoJsonWithZ = XContentFactory.jsonBuilder()
@@ -148,7 +148,7 @@ public void testNullParsing() throws Exception {
             // if we serialize non-null value - it should be serialized as geojson
             format.toXContent(new Point(100, 10), newGeoJson, ToXContent.EMPTY_PARAMS);
             newGeoJson.endObject();
-            assertEquals("{\"val\":{\"type\":\"point\",\"coordinates\":[100.0,10.0]}}", Strings.toString(newGeoJson));
+            assertEquals("{\"val\":{\"type\":\"Point\",\"coordinates\":[100.0,10.0]}}", Strings.toString(newGeoJson));
 
             newGeoJson = XContentFactory.jsonBuilder().startObject().field("val");
             format.toXContent(null, newGeoJson, ToXContent.EMPTY_PARAMS);
diff --git a/server/src/test/java/org/elasticsearch/index/query/GeoShapeQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/GeoShapeQueryBuilderTests.java
index 5eb89ccd4d454..8020083d106b6 100644
--- a/server/src/test/java/org/elasticsearch/index/query/GeoShapeQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/GeoShapeQueryBuilderTests.java
@@ -204,7 +204,7 @@ public void testFromJson() throws IOException {
                 "  \"geo_shape\" : {\n" +
                 "    \"location\" : {\n" +
                 "      \"shape\" : {\n" +
-                "        \"type\" : \"envelope\",\n" +
+                "        \"type\" : \"Envelope\",\n" +
                 "        \"coordinates\" : [ [ 13.0, 53.0 ], [ 14.0, 52.0 ] ]\n" +
                 "      },\n" +
                 "      \"relation\" : \"intersects\"\n" +
diff --git a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryBuilderTests.java b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryBuilderTests.java
index 2e9cd2db3a55d..fb0d7fbbe7557 100644
--- a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryBuilderTests.java
+++ b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryBuilderTests.java
@@ -179,7 +179,7 @@ public void testFromJson() throws IOException {
                 "  }\n" +
                 "}";
         ShapeQueryBuilder parsed = (ShapeQueryBuilder) parseQuery(json);
-        checkGeneratedJson(json, parsed);
+        checkGeneratedJson(json.replaceAll("envelope", "Envelope"), parsed);
         assertEquals(json, 42.0, parsed.boost(), 0.0001);
     }
 

From c793b775199a2563d09cbd9d06a06f7c9a3e4abb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Fri, 20 Dec 2019 16:14:01 +0100
Subject: [PATCH 308/686] Now, that the PR with `aggName` is backported, the
 version can be changed to 7.6 (#50436)

---
 .../evaluation/classification/MulticlassConfusionMatrix.java  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
index e5a4de1605da0..e2762bd7d7986 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/evaluation/classification/MulticlassConfusionMatrix.java
@@ -99,7 +99,7 @@ public MulticlassConfusionMatrix(@Nullable Integer size, @Nullable String aggNam
 
     public MulticlassConfusionMatrix(StreamInput in) throws IOException {
         this.size = in.readVInt();
-        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
             this.aggNamePrefix = in.readString();
         } else {
             this.aggNamePrefix = DEFAULT_AGG_NAME_PREFIX;
@@ -197,7 +197,7 @@ public Optional<Result> getResult() {
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(size);
-        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             out.writeString(aggNamePrefix);
         }
     }

From 8b06b14f0ee87a0eaf4acb576ca1422c08cc8612 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Fri, 20 Dec 2019 11:26:42 -0500
Subject: [PATCH 309/686] [ML][Inference] updates specs with new params + docs
 (#50373)

---
 .../rest-api-spec/api/ml.delete_trained_model.json     |  2 +-
 .../rest-api-spec/api/ml.get_trained_models.json       | 10 ++++++++--
 .../rest-api-spec/api/ml.get_trained_models_stats.json |  2 +-
 3 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_trained_model.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_trained_model.json
index edfc157646f91..01e935bd4ad59 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_trained_model.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_trained_model.json
@@ -1,7 +1,7 @@
 {
   "ml.delete_trained_model":{
     "documentation":{
-      "url":"TODO"
+      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/delete-inference.html"
     },
     "stability":"experimental",
     "url":{
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_trained_models.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_trained_models.json
index 22d16a6c36941..d92c8823b7330 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_trained_models.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_trained_models.json
@@ -1,7 +1,7 @@
 {
   "ml.get_trained_models":{
     "documentation":{
-      "url":"TODO"
+      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/get-inference.html"
     },
     "stability":"experimental",
     "url":{
@@ -36,9 +36,15 @@
       "include_model_definition":{
         "type":"boolean",
         "required":false,
-        "description":"Should the full model definition be included in the results. These definitions can be large",
+        "description":"Should the full model definition be included in the results. These definitions can be large. So be cautious when including them. Defaults to false.",
         "default":false
       },
+      "decompress_definition": {
+        "type": "boolean",
+        "required": false,
+        "default": true,
+        "description": "Should the model definition be decompressed into valid JSON or returned in a custom compressed format. Defaults to true."
+      },
       "from":{
         "type":"int",
         "description":"skips a number of trained models",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_trained_models_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_trained_models_stats.json
index 703380c708703..c00b33f2ea9ca 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_trained_models_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_trained_models_stats.json
@@ -1,7 +1,7 @@
 {
   "ml.get_trained_models_stats":{
     "documentation":{
-      "url":"TODO"
+      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/get-inference-stats.html"
     },
     "stability":"experimental",
     "url":{

From 79a570f2e8decde289ca2e029f5e65a9ae357a13 Mon Sep 17 00:00:00 2001
From: Andrei Dan <andrei.dan@elastic.co>
Date: Fri, 20 Dec 2019 16:29:37 +0000
Subject: [PATCH 310/686] Make the TransportRolloverAction execute in one
 cluster state update (#50388)

This commit makes the TransportRolloverAction more resilient, by having it execute
only one cluster state update that creates the new (rollover index), rolls over
the alias from the source to the target index and set the RolloverInfo on the
source index. Before these 3 steps were represented as 3 chained cluster state
updates, which would've seen the user manually intervene if, say, the alias
rollover cluster state update (second in the chain) failed but the creation of
the rollover index (first in the chain) update succeeded

* Rename innerExecute to applyAliasActions

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
---
 .../rollover/TransportRolloverAction.java     | 112 ++++++++----------
 .../metadata/MetaDataCreateIndexService.java  |   2 +-
 .../metadata/MetaDataIndexAliasesService.java |   7 +-
 .../TransportRolloverActionTests.java         |  13 +-
 .../MetaDataIndexAliasesServiceTests.java     |  46 +++----
 5 files changed, 81 insertions(+), 99 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverAction.java
index bc67685a976f7..9c1c9d71d6708 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverAction.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.action.admin.indices.rollover;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.action.admin.indices.alias.IndicesAliasesClusterStateUpdateRequest;
 import org.elasticsearch.action.admin.indices.create.CreateIndexClusterStateUpdateRequest;
 import org.elasticsearch.action.admin.indices.create.CreateIndexRequest;
 import org.elasticsearch.action.admin.indices.stats.IndicesStatsAction;
@@ -130,7 +129,7 @@ protected void masterOperation(Task task, final RolloverRequest rolloverRequest,
             .docs(true);
         statsRequest.setParentTask(clusterService.localNode().getId(), task.getId());
         client.execute(IndicesStatsAction.INSTANCE, statsRequest,
-            new ActionListener<IndicesStatsResponse>() {
+            new ActionListener<>() {
                 @Override
                 public void onResponse(IndicesStatsResponse statsResponse) {
                     final Map<String, Boolean> conditionResults = evaluateConditions(rolloverRequest.getConditions().values(),
@@ -141,56 +140,44 @@ public void onResponse(IndicesStatsResponse statsResponse) {
                             new RolloverResponse(sourceIndexName, rolloverIndexName, conditionResults, true, false, false, false));
                         return;
                     }
-                    List<Condition<?>> metConditions =  rolloverRequest.getConditions().values().stream()
+                    List<Condition<?>> metConditions = rolloverRequest.getConditions().values().stream()
                         .filter(condition -> conditionResults.get(condition.toString())).collect(Collectors.toList());
                     if (conditionResults.size() == 0 || metConditions.size() > 0) {
-                        CreateIndexClusterStateUpdateRequest updateRequest = prepareCreateIndexRequest(unresolvedName, rolloverIndexName,
-                            rolloverRequest);
-                        createIndexService.createIndex(updateRequest, ActionListener.wrap(createIndexClusterStateUpdateResponse -> {
-                            final IndicesAliasesClusterStateUpdateRequest aliasesUpdateRequest;
-                            if (explicitWriteIndex) {
-                                aliasesUpdateRequest = prepareRolloverAliasesWriteIndexUpdateRequest(sourceIndexName,
-                                    rolloverIndexName, rolloverRequest);
-                            } else {
-                                aliasesUpdateRequest = prepareRolloverAliasesUpdateRequest(sourceIndexName,
-                                    rolloverIndexName, rolloverRequest);
+                        CreateIndexClusterStateUpdateRequest createIndexRequest = prepareCreateIndexRequest(unresolvedName,
+                            rolloverIndexName, rolloverRequest);
+                        clusterService.submitStateUpdateTask("rollover_index source [" + sourceIndexName + "] to target ["
+                            + rolloverIndexName + "]", new ClusterStateUpdateTask() {
+                            @Override
+                            public ClusterState execute(ClusterState currentState) throws Exception {
+                                ClusterState newState = createIndexService.applyCreateIndexRequest(currentState, createIndexRequest);
+                                newState = indexAliasesService.applyAliasActions(newState,
+                                    rolloverAliasToNewIndex(sourceIndexName, rolloverIndexName, rolloverRequest, explicitWriteIndex));
+                                RolloverInfo rolloverInfo = new RolloverInfo(rolloverRequest.getAlias(), metConditions,
+                                    threadPool.absoluteTimeInMillis());
+                                return ClusterState.builder(newState)
+                                    .metaData(MetaData.builder(newState.metaData())
+                                        .put(IndexMetaData.builder(newState.metaData().index(sourceIndexName))
+                                            .putRolloverInfo(rolloverInfo))).build();
                             }
-                            indexAliasesService.indicesAliases(aliasesUpdateRequest,
-                                ActionListener.wrap(aliasClusterStateUpdateResponse -> {
-                                    if (aliasClusterStateUpdateResponse.isAcknowledged()) {
-                                        clusterService.submitStateUpdateTask("update_rollover_info", new ClusterStateUpdateTask() {
-                                            @Override
-                                            public ClusterState execute(ClusterState currentState) {
-                                                RolloverInfo rolloverInfo = new RolloverInfo(rolloverRequest.getAlias(), metConditions,
-                                                    threadPool.absoluteTimeInMillis());
-                                                return ClusterState.builder(currentState)
-                                                    .metaData(MetaData.builder(currentState.metaData())
-                                                        .put(IndexMetaData.builder(currentState.metaData().index(sourceIndexName))
-                                                            .putRolloverInfo(rolloverInfo))).build();
-                                            }
 
-                                            @Override
-                                            public void onFailure(String source, Exception e) {
-                                                listener.onFailure(e);
-                                            }
+                            @Override
+                            public void onFailure(String source, Exception e) {
+                                listener.onFailure(e);
+                            }
 
-                                            @Override
-                                            public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
-                                                activeShardsObserver.waitForActiveShards(new String[]{rolloverIndexName},
-                                                    rolloverRequest.getCreateIndexRequest().waitForActiveShards(),
-                                                    rolloverRequest.masterNodeTimeout(),
-                                                    isShardsAcknowledged -> listener.onResponse(new RolloverResponse(
-                                                        sourceIndexName, rolloverIndexName, conditionResults, false, true, true,
-                                                        isShardsAcknowledged)),
-                                                    listener::onFailure);
-                                            }
-                                        });
-                                    } else {
-                                        listener.onResponse(new RolloverResponse(sourceIndexName, rolloverIndexName, conditionResults,
-                                                                                    false, true, false, false));
-                                    }
-                                }, listener::onFailure));
-                        }, listener::onFailure));
+                            @Override
+                            public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
+                                if (newState.equals(oldState) == false) {
+                                    activeShardsObserver.waitForActiveShards(new String[]{rolloverIndexName},
+                                        rolloverRequest.getCreateIndexRequest().waitForActiveShards(),
+                                        rolloverRequest.masterNodeTimeout(),
+                                        isShardsAcknowledged -> listener.onResponse(new RolloverResponse(
+                                            sourceIndexName, rolloverIndexName, conditionResults, false, true, true,
+                                            isShardsAcknowledged)),
+                                        listener::onFailure);
+                                }
+                            }
+                        });
                     } else {
                         // conditions not met
                         listener.onResponse(
@@ -207,27 +194,24 @@ public void onFailure(Exception e) {
         );
     }
 
-    static IndicesAliasesClusterStateUpdateRequest prepareRolloverAliasesUpdateRequest(String oldIndex, String newIndex,
-                                                                                       RolloverRequest request) {
-        final List<AliasAction> actions = List.of(
-                new AliasAction.Add(newIndex, request.getAlias(), null, null, null, null),
-                new AliasAction.Remove(oldIndex, request.getAlias()));
-        return new IndicesAliasesClusterStateUpdateRequest(actions)
-            .ackTimeout(request.ackTimeout())
-            .masterNodeTimeout(request.masterNodeTimeout());
-    }
-
-    static IndicesAliasesClusterStateUpdateRequest prepareRolloverAliasesWriteIndexUpdateRequest(String oldIndex, String newIndex,
-                                                                                                 RolloverRequest request) {
-        final List<AliasAction> actions = List.of(
+    /**
+     * Creates the alias actions to reflect the alias rollover from the old (source) index to the new (target/rolled over) index. An
+     * alias pointing to multiple indices will have to be an explicit write index (ie. the old index alias has is_write_index set to true)
+     * in which case, after the rollover, the new index will need to be the explicit write index.
+     */
+    static List<AliasAction> rolloverAliasToNewIndex(String oldIndex, String newIndex, RolloverRequest request,
+                                                     boolean explicitWriteIndex) {
+        if (explicitWriteIndex) {
+            return List.of(
                 new AliasAction.Add(newIndex, request.getAlias(), null, null, null, true),
                 new AliasAction.Add(oldIndex, request.getAlias(), null, null, null, false));
-        return new IndicesAliasesClusterStateUpdateRequest(actions)
-            .ackTimeout(request.ackTimeout())
-            .masterNodeTimeout(request.masterNodeTimeout());
+        } else {
+            return List.of(
+                new AliasAction.Add(newIndex, request.getAlias(), null, null, null, null),
+                new AliasAction.Remove(oldIndex, request.getAlias()));
+        }
     }
 
-
     static String generateRolloverIndexName(String sourceIndexName, IndexNameExpressionResolver indexNameExpressionResolver) {
         String resolvedName = indexNameExpressionResolver.resolveDateMathExpression(sourceIndexName);
         final boolean isDateMath = sourceIndexName.equals(resolvedName) == false;
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
index 6a977fdaee368..9e310280636a0 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
@@ -262,7 +262,7 @@ public void onFailure(String source, Exception e) {
      * Handles the cluster state transition to a version that reflects the {@link CreateIndexClusterStateUpdateRequest}.
      * All the requested changes are firstly validated before mutating the {@link ClusterState}.
      */
-    ClusterState applyCreateIndexRequest(ClusterState currentState, CreateIndexClusterStateUpdateRequest request) throws Exception {
+    public ClusterState applyCreateIndexRequest(ClusterState currentState, CreateIndexClusterStateUpdateRequest request) throws Exception {
         logger.trace("executing IndexCreationTask for [{}] against cluster state version [{}]", request, currentState.version());
         Index createdIndex = null;
         String removalExtraInfo = null;
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesService.java
index 84e2f512e569f..5efd4b6eae8bc 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesService.java
@@ -85,12 +85,15 @@ protected ClusterStateUpdateResponse newResponse(boolean acknowledged) {
 
                 @Override
                 public ClusterState execute(ClusterState currentState) {
-                    return innerExecute(currentState, request.actions());
+                    return applyAliasActions(currentState, request.actions());
                 }
             });
     }
 
-    ClusterState innerExecute(ClusterState currentState, Iterable<AliasAction> actions) {
+     /**
+     * Handles the cluster state transition to a version that reflects the provided {@link AliasAction}s.
+     */
+     public ClusterState applyAliasActions(ClusterState currentState, Iterable<AliasAction> actions) {
         List<Index> indicesToClose = new ArrayList<>();
         Map<String, IndexService> indices = new HashMap<>();
         try {
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverActionTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverActionTests.java
index 9dac4a38a36b6..54454cd9f7ecb 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverActionTests.java
@@ -22,7 +22,6 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionRequest;
-import org.elasticsearch.action.admin.indices.alias.IndicesAliasesClusterStateUpdateRequest;
 import org.elasticsearch.action.admin.indices.create.CreateIndexClusterStateUpdateRequest;
 import org.elasticsearch.action.admin.indices.stats.CommonStats;
 import org.elasticsearch.action.admin.indices.stats.IndexStats;
@@ -219,15 +218,13 @@ public void testEvaluateWithoutMetaData() {
         results2.forEach((k, v) -> assertFalse(v));
     }
 
-    public void testCreateUpdateAliasRequest() {
+    public void testRolloverAliasActions() {
         String sourceAlias = randomAlphaOfLength(10);
         String sourceIndex = randomAlphaOfLength(10);
         String targetIndex = randomAlphaOfLength(10);
         final RolloverRequest rolloverRequest = new RolloverRequest(sourceAlias, targetIndex);
-        final IndicesAliasesClusterStateUpdateRequest updateRequest =
-            TransportRolloverAction.prepareRolloverAliasesUpdateRequest(sourceIndex, targetIndex, rolloverRequest);
 
-        List<AliasAction> actions = updateRequest.actions();
+        List<AliasAction> actions = TransportRolloverAction.rolloverAliasToNewIndex(sourceIndex, targetIndex, rolloverRequest, false);
         assertThat(actions, hasSize(2));
         boolean foundAdd = false;
         boolean foundRemove = false;
@@ -246,15 +243,13 @@ public void testCreateUpdateAliasRequest() {
         assertTrue(foundRemove);
     }
 
-    public void testCreateUpdateAliasRequestWithExplicitWriteIndex() {
+    public void testRolloverAliasActionsWithExplicitWriteIndex() {
         String sourceAlias = randomAlphaOfLength(10);
         String sourceIndex = randomAlphaOfLength(10);
         String targetIndex = randomAlphaOfLength(10);
         final RolloverRequest rolloverRequest = new RolloverRequest(sourceAlias, targetIndex);
-        final IndicesAliasesClusterStateUpdateRequest updateRequest =
-            TransportRolloverAction.prepareRolloverAliasesWriteIndexUpdateRequest(sourceIndex, targetIndex, rolloverRequest);
+        List<AliasAction> actions = TransportRolloverAction.rolloverAliasToNewIndex(sourceIndex, targetIndex, rolloverRequest, true);
 
-        List<AliasAction> actions = updateRequest.actions();
         assertThat(actions, hasSize(2));
         boolean foundAddWrite = false;
         boolean foundRemoveWrite = false;
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesServiceTests.java
index 7f7f26bcfbcbb..9b320ae9f27e7 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesServiceTests.java
@@ -72,7 +72,7 @@ public void testAddAndRemove() {
         ClusterState before = createIndex(ClusterState.builder(ClusterName.DEFAULT).build(), index);
 
         // Add an alias to it
-        ClusterState after = service.innerExecute(before, singletonList(new AliasAction.Add(index, "test", null, null, null, null)));
+        ClusterState after = service.applyAliasActions(before, singletonList(new AliasAction.Add(index, "test", null, null, null, null)));
         AliasOrIndex alias = after.metaData().getAliasAndIndexLookup().get("test");
         assertNotNull(alias);
         assertTrue(alias.isAlias());
@@ -81,7 +81,7 @@ public void testAddAndRemove() {
 
         // Remove the alias from it while adding another one
         before = after;
-        after = service.innerExecute(before, Arrays.asList(
+        after = service.applyAliasActions(before, Arrays.asList(
                 new AliasAction.Remove(index, "test"),
                 new AliasAction.Add(index, "test_2", null, null, null, null)));
         assertNull(after.metaData().getAliasAndIndexLookup().get("test"));
@@ -93,7 +93,7 @@ public void testAddAndRemove() {
 
         // Now just remove on its own
         before = after;
-        after = service.innerExecute(before, singletonList(new AliasAction.Remove(index, "test_2")));
+        after = service.applyAliasActions(before, singletonList(new AliasAction.Remove(index, "test_2")));
         assertNull(after.metaData().getAliasAndIndexLookup().get("test"));
         assertNull(after.metaData().getAliasAndIndexLookup().get("test_2"));
         assertAliasesVersionIncreased(index, before, after);
@@ -109,7 +109,7 @@ public void testMultipleIndices() {
             before = createIndex(before, index);
             addActions.add(new AliasAction.Add(index, "alias-" + index, null, null, null, null));
         }
-        final ClusterState afterAddingAliasesToAll = service.innerExecute(before, addActions);
+        final ClusterState afterAddingAliasesToAll = service.applyAliasActions(before, addActions);
         assertAliasesVersionIncreased(indices.toArray(new String[0]), before, afterAddingAliasesToAll);
 
         // now add some aliases randomly
@@ -121,7 +121,7 @@ public void testMultipleIndices() {
                 randomIndices.add(index);
             }
         }
-        final ClusterState afterAddingRandomAliases = service.innerExecute(afterAddingAliasesToAll, randomAddActions);
+        final ClusterState afterAddingRandomAliases = service.applyAliasActions(afterAddingAliasesToAll, randomAddActions);
         assertAliasesVersionIncreased(randomIndices.toArray(new String[0]), afterAddingAliasesToAll, afterAddingRandomAliases);
         assertAliasesVersionUnchanged(
                 Sets.difference(indices, randomIndices).toArray(new String[0]),
@@ -134,15 +134,15 @@ public void testChangingWriteAliasStateIncreasesAliasesVersion() {
         final ClusterState before = createIndex(ClusterState.builder(ClusterName.DEFAULT).build(), index);
 
         final ClusterState afterAddWriteAlias =
-                service.innerExecute(before, singletonList(new AliasAction.Add(index, "test", null, null, null, true)));
+                service.applyAliasActions(before, singletonList(new AliasAction.Add(index, "test", null, null, null, true)));
         assertAliasesVersionIncreased(index, before, afterAddWriteAlias);
 
         final ClusterState afterChangeWriteAliasToNonWriteAlias =
-                service.innerExecute(afterAddWriteAlias, singletonList(new AliasAction.Add(index, "test", null, null, null, false)));
+                service.applyAliasActions(afterAddWriteAlias, singletonList(new AliasAction.Add(index, "test", null, null, null, false)));
         assertAliasesVersionIncreased(index, afterAddWriteAlias, afterChangeWriteAliasToNonWriteAlias);
 
         final ClusterState afterChangeNonWriteAliasToWriteAlias =
-                service.innerExecute(
+                service.applyAliasActions(
                         afterChangeWriteAliasToNonWriteAlias,
                         singletonList(new AliasAction.Add(index, "test", null, null, null, true)));
         assertAliasesVersionIncreased(index, afterChangeWriteAliasToNonWriteAlias, afterChangeNonWriteAliasToWriteAlias);
@@ -158,7 +158,7 @@ public void testAddingAliasMoreThanOnceShouldOnlyIncreaseAliasesVersionByOne() {
         for (int i = 0; i < length; i++) {
             addActions.add(new AliasAction.Add(index, "test", null, null, null, null));
         }
-        final ClusterState afterAddingAliases = service.innerExecute(before, addActions);
+        final ClusterState afterAddingAliases = service.applyAliasActions(before, addActions);
 
         assertAliasesVersionIncreased(index, before, afterAddingAliases);
     }
@@ -175,7 +175,7 @@ public void testAliasesVersionUnchangedWhenActionsAreIdempotent() {
             final String aliasName = randomValueOtherThanMany(v -> aliasNames.add(v) == false, () -> randomAlphaOfLength(8));
             addActions.add(new AliasAction.Add(index, aliasName, null, null, null, null));
         }
-        final ClusterState afterAddingAlias = service.innerExecute(before, addActions);
+        final ClusterState afterAddingAlias = service.applyAliasActions(before, addActions);
 
         // now perform a remove and add for each alias which is idempotent, the resulting aliases are unchanged
         final var removeAndAddActions = new ArrayList<AliasAction>(2 * length);
@@ -183,7 +183,7 @@ public void testAliasesVersionUnchangedWhenActionsAreIdempotent() {
             removeAndAddActions.add(new AliasAction.Remove(index, aliasName));
             removeAndAddActions.add(new AliasAction.Add(index, aliasName, null, null, null, null));
         }
-        final ClusterState afterRemoveAndAddAlias = service.innerExecute(afterAddingAlias, removeAndAddActions);
+        final ClusterState afterRemoveAndAddAlias = service.applyAliasActions(afterAddingAlias, removeAndAddActions);
         assertAliasesVersionUnchanged(index, afterAddingAlias, afterRemoveAndAddAlias);
     }
 
@@ -193,7 +193,7 @@ public void testSwapIndexWithAlias() {
         before = createIndex(before, "test_2");
 
         // Now remove "test" and add an alias to "test" to "test_2" in one go
-        ClusterState after = service.innerExecute(before, Arrays.asList(
+        ClusterState after = service.applyAliasActions(before, Arrays.asList(
                 new AliasAction.Add("test_2", "test", null, null, null, null),
                 new AliasAction.RemoveIndex("test")));
         AliasOrIndex alias = after.metaData().getAliasAndIndexLookup().get("test");
@@ -208,7 +208,7 @@ public void testAddAliasToRemovedIndex() {
         ClusterState before = createIndex(ClusterState.builder(ClusterName.DEFAULT).build(), "test");
 
         // Attempt to add an alias to "test" at the same time as we remove it
-        IndexNotFoundException e = expectThrows(IndexNotFoundException.class, () -> service.innerExecute(before, Arrays.asList(
+        IndexNotFoundException e = expectThrows(IndexNotFoundException.class, () -> service.applyAliasActions(before, Arrays.asList(
                 new AliasAction.Add("test", "alias", null, null, null, null),
                 new AliasAction.RemoveIndex("test"))));
         assertEquals("test", e.getIndex().getName());
@@ -219,7 +219,7 @@ public void testRemoveIndexTwice() {
         ClusterState before = createIndex(ClusterState.builder(ClusterName.DEFAULT).build(), "test");
 
         // Try to remove an index twice. This should just remove the index once....
-        ClusterState after = service.innerExecute(before, Arrays.asList(
+        ClusterState after = service.applyAliasActions(before, Arrays.asList(
                 new AliasAction.RemoveIndex("test"),
                 new AliasAction.RemoveIndex("test")));
         assertNull(after.metaData().getAliasAndIndexLookup().get("test"));
@@ -228,20 +228,20 @@ public void testRemoveIndexTwice() {
     public void testAddWriteOnlyWithNoExistingAliases() {
         ClusterState before = createIndex(ClusterState.builder(ClusterName.DEFAULT).build(), "test");
 
-        ClusterState after = service.innerExecute(before, Arrays.asList(
+        ClusterState after = service.applyAliasActions(before, Arrays.asList(
             new AliasAction.Add("test", "alias", null, null, null, false)));
         assertFalse(after.metaData().index("test").getAliases().get("alias").writeIndex());
         assertNull(((AliasOrIndex.Alias) after.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex());
         assertAliasesVersionIncreased("test", before, after);
 
-        after = service.innerExecute(before, Arrays.asList(
+        after = service.applyAliasActions(before, Arrays.asList(
             new AliasAction.Add("test", "alias", null, null, null, null)));
         assertNull(after.metaData().index("test").getAliases().get("alias").writeIndex());
         assertThat(((AliasOrIndex.Alias) after.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex(),
             equalTo(after.metaData().index("test")));
         assertAliasesVersionIncreased("test", before, after);
 
-        after = service.innerExecute(before, Arrays.asList(
+        after = service.applyAliasActions(before, Arrays.asList(
             new AliasAction.Add("test", "alias", null, null, null, true)));
         assertTrue(after.metaData().index("test").getAliases().get("alias").writeIndex());
         assertThat(((AliasOrIndex.Alias) after.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex(),
@@ -258,7 +258,7 @@ public void testAddWriteOnlyWithExistingWriteIndex() {
         ClusterState before = ClusterState.builder(ClusterName.DEFAULT)
             .metaData(MetaData.builder().put(indexMetaData).put(indexMetaData2)).build();
 
-        ClusterState after = service.innerExecute(before, Arrays.asList(
+        ClusterState after = service.applyAliasActions(before, Arrays.asList(
             new AliasAction.Add("test", "alias", null, null, null, null)));
         assertNull(after.metaData().index("test").getAliases().get("alias").writeIndex());
         assertThat(((AliasOrIndex.Alias) after.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex(),
@@ -266,7 +266,7 @@ public void testAddWriteOnlyWithExistingWriteIndex() {
         assertAliasesVersionIncreased("test", before, after);
         assertAliasesVersionUnchanged("test2", before, after);
 
-        Exception exception = expectThrows(IllegalStateException.class, () -> service.innerExecute(before, Arrays.asList(
+        Exception exception = expectThrows(IllegalStateException.class, () -> service.applyAliasActions(before, Arrays.asList(
             new AliasAction.Add("test", "alias", null, null, null, true))));
         assertThat(exception.getMessage(), startsWith("alias [alias] has more than one write index ["));
     }
@@ -286,7 +286,7 @@ public void testSwapWriteOnlyIndex() {
             new AliasAction.Add("test2", "alias", null, null, null, true)
         );
         Collections.shuffle(swapActions, random());
-        ClusterState after = service.innerExecute(before, swapActions);
+        ClusterState after = service.applyAliasActions(before, swapActions);
         assertThat(after.metaData().index("test").getAliases().get("alias").writeIndex(), equalTo(unsetValue));
         assertTrue(after.metaData().index("test2").getAliases().get("alias").writeIndex());
         assertThat(((AliasOrIndex.Alias) after.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex(),
@@ -309,7 +309,7 @@ public void testAddWriteOnlyWithExistingNonWriteIndices() {
 
         assertNull(((AliasOrIndex.Alias) before.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex());
 
-        ClusterState after = service.innerExecute(before, Arrays.asList(
+        ClusterState after = service.applyAliasActions(before, Arrays.asList(
             new AliasAction.Add("test3", "alias", null, null, null, true)));
         assertTrue(after.metaData().index("test3").getAliases().get("alias").writeIndex());
         assertThat(((AliasOrIndex.Alias) after.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex(),
@@ -333,7 +333,7 @@ public void testAddWriteOnlyWithIndexRemoved() {
         assertNull(before.metaData().index("test2").getAliases().get("alias").writeIndex());
         assertNull(((AliasOrIndex.Alias) before.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex());
 
-        ClusterState after = service.innerExecute(before, Collections.singletonList(new AliasAction.RemoveIndex("test")));
+        ClusterState after = service.applyAliasActions(before, Collections.singletonList(new AliasAction.RemoveIndex("test")));
         assertNull(after.metaData().index("test2").getAliases().get("alias").writeIndex());
         assertThat(((AliasOrIndex.Alias) after.metaData().getAliasAndIndexLookup().get("alias")).getWriteIndex(),
             equalTo(after.metaData().index("test2")));
@@ -348,7 +348,7 @@ public void testAddWriteOnlyValidatesAgainstMetaDataBuilder() {
         ClusterState before = ClusterState.builder(ClusterName.DEFAULT)
             .metaData(MetaData.builder().put(indexMetaData).put(indexMetaData2)).build();
 
-        Exception exception = expectThrows(IllegalStateException.class, () -> service.innerExecute(before, Arrays.asList(
+        Exception exception = expectThrows(IllegalStateException.class, () -> service.applyAliasActions(before, Arrays.asList(
             new AliasAction.Add("test", "alias", null, null, null, true),
             new AliasAction.Add("test2", "alias", null, null, null, true)
         )));

From ce974294754eeeffd6ca48d7589ad08722d2f399 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 20 Dec 2019 11:47:47 -0500
Subject: [PATCH 311/686] Close engine before reset log appender (#50390)

Merge threads can run and access the mock appender after we have stopped it.

Closes #50315
---
 .../org/elasticsearch/index/engine/InternalEngineTests.java     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
index c38f426dbfb59..79e5cf7489ca3 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
@@ -2369,7 +2369,7 @@ public void testIndexWriterInfoStream() throws IllegalAccessException, IOExcepti
             engine.index(indexForDoc(doc));
             engine.flush();
             assertTrue(mockAppender.sawIndexWriterMessage);
-
+            engine.close();
         } finally {
             Loggers.removeAppender(rootLogger, mockAppender);
             mockAppender.stop();

From daf0e9f2eef315c94157531794aaecf3afeb0b5d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Fri, 20 Dec 2019 18:01:05 +0100
Subject: [PATCH 312/686] Throw Error on deprecated nGram and edgeNGram custom
 filters (#50376)

The camel-case `nGram` and `edgeNGram` filter names were deprecated in 6. We
currently throw errors on new indices when they are used. However these errors
are currently only thrown for pre-configured filters, adding them as custom
filters doesn't trigger the warning and error. This change adds the appropriate
exceptions for `nGram` and `edgeNGram` respectively.

Closes #50360
---
 .../analysis/common/CommonAnalysisPlugin.java |  40 +++++-
 .../common/CommonAnalysisPluginTests.java     | 129 ++++++++++++++++++
 2 files changed, 167 insertions(+), 2 deletions(-)
 create mode 100644 modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java

diff --git a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
index f9d8cb28f6c61..b9de97952eb4b 100644
--- a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
+++ b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
@@ -118,9 +118,11 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.regex.Regex;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.analysis.AnalyzerProvider;
 import org.elasticsearch.index.analysis.CharFilterFactory;
 import org.elasticsearch.index.analysis.PreBuiltAnalyzerProviderFactory;
@@ -238,7 +240,24 @@ public Map<String, AnalysisProvider<TokenFilterFactory>> getTokenFilters() {
         filters.put("dictionary_decompounder", requiresAnalysisSettings(DictionaryCompoundWordTokenFilterFactory::new));
         filters.put("dutch_stem", DutchStemTokenFilterFactory::new);
         filters.put("edge_ngram", EdgeNGramTokenFilterFactory::new);
-        filters.put("edgeNGram", EdgeNGramTokenFilterFactory::new);
+        filters.put("edgeNGram", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {
+            return new EdgeNGramTokenFilterFactory(indexSettings, environment, name, settings) {
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    if (indexSettings.getIndexVersionCreated().onOrAfter(org.elasticsearch.Version.V_8_0_0)) {
+                        throw new IllegalArgumentException(
+                                "The [edgeNGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
+                                        + "Please change the filter name to [edge_ngram] instead.");
+                    } else {
+                        deprecationLogger.deprecatedAndMaybeLog("edgeNGram_deprecation",
+                                "The [edgeNGram] token filter name is deprecated and will be removed in a future version. "
+                                        + "Please change the filter name to [edge_ngram] instead.");
+                    }
+                    return super.create(tokenStream);
+                }
+
+            };
+        });
         filters.put("elision", requiresAnalysisSettings(ElisionTokenFilterFactory::new));
         filters.put("fingerprint", FingerprintTokenFilterFactory::new);
         filters.put("flatten_graph", FlattenGraphTokenFilterFactory::new);
@@ -258,7 +277,24 @@ public Map<String, AnalysisProvider<TokenFilterFactory>> getTokenFilters() {
         filters.put("min_hash", MinHashTokenFilterFactory::new);
         filters.put("multiplexer", MultiplexerTokenFilterFactory::new);
         filters.put("ngram", NGramTokenFilterFactory::new);
-        filters.put("nGram", NGramTokenFilterFactory::new);
+        filters.put("nGram", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {
+            return new NGramTokenFilterFactory(indexSettings, environment, name, settings) {
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    if (indexSettings.getIndexVersionCreated().onOrAfter(org.elasticsearch.Version.V_8_0_0)) {
+                        throw new IllegalArgumentException(
+                                "The [nGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
+                                        + "Please change the filter name to [ngram] instead.");
+                    } else {
+                        deprecationLogger.deprecatedAndMaybeLog("nGram_deprecation",
+                                "The [nGram] token filter name is deprecated and will be removed in a future version. "
+                                        + "Please change the filter name to [ngram] instead.");
+                    }
+                    return super.create(tokenStream);
+                }
+
+            };
+        });
         filters.put("pattern_capture", requiresAnalysisSettings(PatternCaptureGroupTokenFilterFactory::new));
         filters.put("pattern_replace", requiresAnalysisSettings(PatternReplaceTokenFilterFactory::new));
         filters.put("persian_normalization", PersianNormalizationFilterFactory::new);
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
new file mode 100644
index 0000000000000..90190e42f2f85
--- /dev/null
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
@@ -0,0 +1,129 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.analysis.common;
+
+import org.apache.lucene.analysis.MockTokenizer;
+import org.apache.lucene.analysis.Tokenizer;
+import org.elasticsearch.Version;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.index.analysis.TokenFilterFactory;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.IndexSettingsModule;
+import org.elasticsearch.test.VersionUtils;
+
+import java.io.IOException;
+import java.io.StringReader;
+import java.util.Map;
+
+public class CommonAnalysisPluginTests extends ESTestCase {
+
+    /**
+     * Check that the deprecated "nGram" filter throws exception for indices created since 7.0.0 and
+     * logs a warning for earlier indices when the filter is used as a custom filter
+     */
+    public void testNGramFilterInCustomAnalyzerDeprecationError() throws IOException {
+        final Settings settings = Settings.builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(IndexMetaData.SETTING_VERSION_CREATED,
+                VersionUtils.randomVersionBetween(random(), Version.V_8_0_0, Version.CURRENT))
+            .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+            .put("index.analysis.analyzer.custom_analyzer.tokenizer", "standard")
+            .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram")
+            .put("index.analysis.filter.my_ngram.type", "nGram")
+            .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            Map<String, TokenFilterFactory> tokenFilters = createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings),
+                    settings, commonAnalysisPlugin).tokenFilter;
+            TokenFilterFactory tokenFilterFactory = tokenFilters.get("nGram");
+            Tokenizer tokenizer = new MockTokenizer();
+            tokenizer.setReader(new StringReader("foo bar"));
+
+            IllegalArgumentException ex = expectThrows(IllegalArgumentException.class, () -> tokenFilterFactory.create(tokenizer));
+            assertEquals("The [nGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
+                    + "Please change the filter name to [ngram] instead.", ex.getMessage());
+        }
+
+        final Settings settingsPre7 = Settings.builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+                .put(IndexMetaData.SETTING_VERSION_CREATED, VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_6_0))
+                .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+                .put("index.analysis.analyzer.custom_analyzer.tokenizer", "standard")
+                .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram").put("index.analysis.filter.my_ngram.type", "nGram")
+                .build();
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            Map<String, TokenFilterFactory> tokenFilters = createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settingsPre7),
+                    settingsPre7, commonAnalysisPlugin).tokenFilter;
+            TokenFilterFactory tokenFilterFactory = tokenFilters.get("nGram");
+            Tokenizer tokenizer = new MockTokenizer();
+            tokenizer.setReader(new StringReader("foo bar"));
+            assertNotNull(tokenFilterFactory.create(tokenizer));
+            assertWarnings("The [nGram] token filter name is deprecated and will be removed in a future version. "
+                    + "Please change the filter name to [ngram] instead.");
+        }
+    }
+
+    /**
+     * Check that the deprecated "edgeNGram" filter throws exception for indices created since 7.0.0 and
+     * logs a warning for earlier indices when the filter is used as a custom filter
+     */
+    public void testEdgeNGramFilterInCustomAnalyzerDeprecationError() throws IOException {
+        final Settings settings = Settings.builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(IndexMetaData.SETTING_VERSION_CREATED,
+                VersionUtils.randomVersionBetween(random(), Version.V_8_0_0, Version.CURRENT))
+            .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+            .put("index.analysis.analyzer.custom_analyzer.tokenizer", "standard")
+            .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram")
+            .put("index.analysis.filter.my_ngram.type", "edgeNGram")
+            .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            Map<String, TokenFilterFactory> tokenFilters = createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings),
+                    settings, commonAnalysisPlugin).tokenFilter;
+            TokenFilterFactory tokenFilterFactory = tokenFilters.get("edgeNGram");
+            Tokenizer tokenizer = new MockTokenizer();
+            tokenizer.setReader(new StringReader("foo bar"));
+
+            IllegalArgumentException ex = expectThrows(IllegalArgumentException.class, () -> tokenFilterFactory.create(tokenizer));
+            assertEquals("The [edgeNGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
+                    + "Please change the filter name to [edge_ngram] instead.", ex.getMessage());
+        }
+
+        final Settings settingsPre7 = Settings.builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+                .put(IndexMetaData.SETTING_VERSION_CREATED,
+                    VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_6_0))
+                .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+                .put("index.analysis.analyzer.custom_analyzer.tokenizer", "standard")
+                .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram")
+                .put("index.analysis.filter.my_ngram.type", "edgeNGram")
+                .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            Map<String, TokenFilterFactory> tokenFilters = createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settingsPre7),
+                    settingsPre7, commonAnalysisPlugin).tokenFilter;
+            TokenFilterFactory tokenFilterFactory = tokenFilters.get("edgeNGram");
+            Tokenizer tokenizer = new MockTokenizer();
+            tokenizer.setReader(new StringReader("foo bar"));
+            assertNotNull(tokenFilterFactory.create(tokenizer));
+            assertWarnings("The [edgeNGram] token filter name is deprecated and will be removed in a future version. "
+                    + "Please change the filter name to [edge_ngram] instead.");
+        }
+    }
+}

From 2e511cd143602e808a5fedc0eb0d92f98c133b09 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Fri, 20 Dec 2019 11:41:18 -0700
Subject: [PATCH 313/686] Make ILMHistoryStore.putAsync truly async (#50403)

* Make ILMHistoryStore.putAsync truly async

This moves the `putAsync` method in `ILMHistoryStore` never to block.
Previously due to the way that the `BulkProcessor` works, it was possible
for `BulkProcessor#add` to block executing a bulk request. This was bad
as we may be adding things to the history store in cluster state update
threads.

This also moves the index creation to be done prior to the bulk request
execution, rather than being checked every time an operation was added
to the queue. This lessens the chance of the index being created, then
deleted (by some external force), and then recreated via a bulk indexing
request.

Resolves #50353
---
 .../ilm/TimeSeriesLifecycleActionsIT.java     |  2 -
 .../xpack/ilm/IndexLifecycle.java             |  3 +-
 .../xpack/ilm/history/ILMHistoryStore.java    | 77 ++++++++++++++-----
 .../xpack/ilm/IndexLifecycleRunnerTests.java  |  2 +-
 .../ilm/history/ILMHistoryStoreTests.java     |  4 +-
 .../slm/SLMSnapshotBlockingIntegTests.java    |  8 ++
 6 files changed, 70 insertions(+), 26 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index c40e96bcdd9e8..e872de5b08f4e 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1012,7 +1012,6 @@ public void testILMRolloverOnManuallyRolledIndex() throws Exception {
        assertBusy(() -> assertTrue(indexExists(thirdIndex)));
    }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithSuccess() throws Exception {
         String index = "index";
 
@@ -1055,7 +1054,6 @@ public void testHistoryIsWrittenWithSuccess() throws Exception {
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-000002", true, "check-rollover-ready"), 30, TimeUnit.SECONDS);
     }
 
-    @AwaitsFix( bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithFailure() throws Exception {
         String index = "index";
 
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
index 4051b291b9801..3e1ad336905eb 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
@@ -179,7 +179,8 @@ public Collection<Object> createComponents(Client client, ClusterService cluster
             @SuppressWarnings("unused")
             ILMHistoryTemplateRegistry ilmTemplateRegistry =
                 new ILMHistoryTemplateRegistry(settings, clusterService, threadPool, client, xContentRegistry);
-            ilmHistoryStore.set(new ILMHistoryStore(settings, new OriginSettingClient(client, INDEX_LIFECYCLE_ORIGIN), clusterService));
+            ilmHistoryStore.set(new ILMHistoryStore(settings, new OriginSettingClient(client, INDEX_LIFECYCLE_ORIGIN),
+                clusterService, threadPool));
             indexLifecycleInitialisationService.set(new IndexLifecycleService(settings, client, clusterService, threadPool,
                 getClock(), System::currentTimeMillis, xContentRegistry, ilmHistoryStore.get()));
             components.add(indexLifecycleInitialisationService.get());
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStore.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStore.java
index ab8168de4b28d..96c54e5adfca3 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStore.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStore.java
@@ -9,6 +9,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ResourceAlreadyExistsException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.indices.alias.Alias;
@@ -31,11 +32,13 @@
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
+import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.Closeable;
 import java.io.IOException;
 import java.util.Arrays;
 import java.util.Map;
+import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.TimeUnit;
 import java.util.stream.Collectors;
 
@@ -54,26 +57,52 @@ public class ILMHistoryStore implements Closeable {
     public static final String ILM_HISTORY_INDEX_PREFIX = "ilm-history-" + INDEX_TEMPLATE_VERSION + "-";
     public static final String ILM_HISTORY_ALIAS = "ilm-history-" + INDEX_TEMPLATE_VERSION;
 
-    private final Client client;
-    private final ClusterService clusterService;
     private final boolean ilmHistoryEnabled;
     private final BulkProcessor processor;
+    private final ThreadPool threadPool;
 
-    public ILMHistoryStore(Settings nodeSettings, Client client, ClusterService clusterService) {
-        this.client = client;
-        this.clusterService = clusterService;
-        ilmHistoryEnabled = LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING.get(nodeSettings);
+    public ILMHistoryStore(Settings nodeSettings, Client client, ClusterService clusterService, ThreadPool threadPool) {
+        this.ilmHistoryEnabled = LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING.get(nodeSettings);
+        this.threadPool = threadPool;
 
         this.processor = BulkProcessor.builder(
             new OriginSettingClient(client, INDEX_LIFECYCLE_ORIGIN)::bulk,
             new BulkProcessor.Listener() {
                 @Override
-                public void beforeBulk(long executionId, BulkRequest request) { }
+                public void beforeBulk(long executionId, BulkRequest request) {
+                    // Prior to actually performing the bulk, we should ensure the index exists, and
+                    // if we were unable to create it or it was in a bad state, we should not
+                    // attempt to index documents.
+                    try {
+                        final CompletableFuture<Boolean> indexCreated = new CompletableFuture<>();
+                        ensureHistoryIndex(client, clusterService.state(), ActionListener.wrap(indexCreated::complete,
+                            ex -> {
+                                logger.warn("failed to create ILM history store index prior to issuing bulk request", ex);
+                                indexCreated.completeExceptionally(ex);
+                            }));
+                        indexCreated.get(2, TimeUnit.MINUTES);
+                    } catch (Exception e) {
+                        logger.warn(new ParameterizedMessage("unable to index the following ILM history items:\n{}",
+                            request.requests().stream()
+                                .filter(dwr -> (dwr instanceof IndexRequest))
+                                .map(dwr -> ((IndexRequest) dwr))
+                                .map(IndexRequest::sourceAsMap)
+                                .map(Object::toString)
+                                .collect(Collectors.joining("\n"))), e);
+                        throw new ElasticsearchException(e);
+                    }
+                }
 
                 @Override
                 public void afterBulk(long executionId, BulkRequest request, BulkResponse response) {
                     long items = request.numberOfActions();
-                    logger.trace("indexed [{}] items into ILM history index", items);
+                    if (logger.isTraceEnabled()) {
+                        logger.trace("indexed [{}] items into ILM history index [{}]", items,
+                            Arrays.stream(response.getItems())
+                                .map(BulkItemResponse::getIndex)
+                                .distinct()
+                                .collect(Collectors.joining(",")));
+                    }
                     if (response.hasFailures()) {
                         Map<String, String> failures = Arrays.stream(response.getItems())
                             .filter(BulkItemResponse::isFailed)
@@ -105,18 +134,25 @@ public void putAsync(ILMHistoryItem item) {
                 LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING.getKey(), item);
             return;
         }
-        logger.trace("about to index ILM history item in index [{}]: [{}]", ILM_HISTORY_ALIAS, item);
-        ensureHistoryIndex(client, clusterService.state(), ActionListener.wrap(createdIndex -> {
-            try (XContentBuilder builder = XContentFactory.jsonBuilder()) {
-                item.toXContent(builder, ToXContent.EMPTY_PARAMS);
-                IndexRequest request = new IndexRequest(ILM_HISTORY_ALIAS).source(builder);
-                processor.add(request);
-            } catch (IOException exception) {
-                logger.error(new ParameterizedMessage("failed to index ILM history item in index [{}]: [{}]",
-                    ILM_HISTORY_ALIAS, item), exception);
-            }
-        }, ex -> logger.error(new ParameterizedMessage("failed to ensure ILM history index exists, not indexing history item [{}]",
-            item), ex)));
+        logger.trace("queueing ILM history item for indexing [{}]: [{}]", ILM_HISTORY_ALIAS, item);
+        try (XContentBuilder builder = XContentFactory.jsonBuilder()) {
+            item.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            IndexRequest request = new IndexRequest(ILM_HISTORY_ALIAS).source(builder);
+            // TODO: remove the threadpool wrapping when the .add call is non-blocking
+            //  (it can currently execute the bulk request occasionally)
+            //  see: https://github.com/elastic/elasticsearch/issues/50440
+            threadPool.executor(ThreadPool.Names.GENERIC).execute(() -> {
+                try {
+                    processor.add(request);
+                } catch (Exception e) {
+                    logger.error(new ParameterizedMessage("failed add ILM history item to queue for index [{}]: [{}]",
+                        ILM_HISTORY_ALIAS, item), e);
+                }
+            });
+        } catch (IOException exception) {
+            logger.error(new ParameterizedMessage("failed to queue ILM history item in index [{}]: [{}]",
+                ILM_HISTORY_ALIAS, item), exception);
+        }
     }
 
     /**
@@ -134,6 +170,7 @@ static void ensureHistoryIndex(Client client, ClusterState state, ActionListener
 
         if (ilmHistory == null && initialHistoryIndex == null) {
             // No alias or index exists with the expected names, so create the index with appropriate alias
+            logger.debug("creating ILM history index [{}]", initialHistoryIndexName);
             client.admin().indices().prepareCreate(initialHistoryIndexName)
                 .setWaitForActiveShards(1)
                 .addAlias(new Alias(ILM_HISTORY_ALIAS)
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
index 130a77cf853dd..faa1270f479aa 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunnerTests.java
@@ -1118,7 +1118,7 @@ private class NoOpHistoryStore extends ILMHistoryStore {
         private final List<ILMHistoryItem> items = new ArrayList<>();
 
         NoOpHistoryStore() {
-            super(Settings.EMPTY, noopClient, null);
+            super(Settings.EMPTY, noopClient, null, null);
         }
 
         public List<ILMHistoryItem> getItems() {
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStoreTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStoreTests.java
index 3e6b9a638737c..47a1ba406e502 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStoreTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/history/ILMHistoryStoreTests.java
@@ -68,7 +68,7 @@ public void setup() {
         threadPool = new TestThreadPool(this.getClass().getName());
         client = new VerifyingClient(threadPool);
         clusterService = ClusterServiceUtils.createClusterService(threadPool);
-        historyStore = new ILMHistoryStore(Settings.EMPTY, client, clusterService);
+        historyStore = new ILMHistoryStore(Settings.EMPTY, client, clusterService, threadPool);
     }
 
     @After
@@ -81,7 +81,7 @@ public void setdown() {
 
     public void testNoActionIfDisabled() throws Exception {
         Settings settings = Settings.builder().put(LIFECYCLE_HISTORY_INDEX_ENABLED_SETTING.getKey(), false).build();
-        try (ILMHistoryStore disabledHistoryStore = new ILMHistoryStore(settings, client, null)) {
+        try (ILMHistoryStore disabledHistoryStore = new ILMHistoryStore(settings, client, null, threadPool)) {
             String policyId = randomAlphaOfLength(5);
             final long timestamp = randomNonNegativeLong();
             ILMHistoryItem record = ILMHistoryItem.success("index", policyId, timestamp, null, null);
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SLMSnapshotBlockingIntegTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SLMSnapshotBlockingIntegTests.java
index 7c7a555a8d5d9..16f388fa49481 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SLMSnapshotBlockingIntegTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SLMSnapshotBlockingIntegTests.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.snapshots.mockstore.MockRepository;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
+import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
 import org.elasticsearch.xpack.core.slm.SnapshotLifecyclePolicy;
 import org.elasticsearch.xpack.core.slm.SnapshotLifecyclePolicyItem;
 import org.elasticsearch.xpack.core.slm.SnapshotRetentionConfiguration;
@@ -64,6 +65,13 @@ public class SLMSnapshotBlockingIntegTests extends ESIntegTestCase {
     static final String REPO = "my-repo";
     List<String> dataNodeNames = null;
 
+    @Override
+    protected Settings nodeSettings(int nodeOrdinal) {
+        return Settings.builder().put(super.nodeSettings(nodeOrdinal))
+            .put(LifecycleSettings.LIFECYCLE_HISTORY_INDEX_ENABLED, false)
+            .build();
+    }
+
     @Before
     public void ensureClusterNodes() {
         logger.info("--> starting enough nodes to ensure we have enough to safely stop for tests");

From b577713e6ad921ccfa457fa0aa56158599ec1517 Mon Sep 17 00:00:00 2001
From: Jack Conradson <osjdconrad@gmail.com>
Date: Fri, 20 Dec 2019 10:52:44 -0800
Subject: [PATCH 314/686] Document use of context in put stored script (#50446)

This documents how to test compile a stored script against a specific
context when using PUT/POST.
---
 docs/reference/scripting/using.asciidoc | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/reference/scripting/using.asciidoc b/docs/reference/scripting/using.asciidoc
index 02a3cc6042c05..9d056415d8f76 100644
--- a/docs/reference/scripting/using.asciidoc
+++ b/docs/reference/scripting/using.asciidoc
@@ -155,6 +155,22 @@ POST _scripts/calculate-score
 -----------------------------------
 // TEST[setup:twitter]
 
+You may also specify a context as part of the url path to compile a
+stored script against that specific context in the form of
+`/_scripts/{id}/{context}`:
+
+[source,console]
+-----------------------------------
+POST _scripts/calculate-score/score
+{
+  "script": {
+    "lang": "painless",
+    "source": "Math.log(_score * 2) + params.my_modifier"
+  }
+}
+-----------------------------------
+// TEST[setup:twitter]
+
 This same script can be retrieved with:
 
 [source,console]

From c18fea389357ba005b11fb4458d386ffd8127309 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Fri, 20 Dec 2019 14:02:42 -0500
Subject: [PATCH 315/686] [DOCS] Remove outdated file scripts refererence
 (#50437)

File scripts were removed in 6.0 with #24627.

This removes an outdated file scripts reference from the conditional clauses section of the search templates docs.
---
 docs/reference/search/search-template.asciidoc | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/docs/reference/search/search-template.asciidoc b/docs/reference/search/search-template.asciidoc
index aa73e9d337232..0183213cd1fcc 100644
--- a/docs/reference/search/search-template.asciidoc
+++ b/docs/reference/search/search-template.asciidoc
@@ -545,8 +545,8 @@ The `params` would look like:
 // NOTCONSOLE
 <1> The `line_no`, `start`, and `end` parameters are optional.
 
-
-We could write the query as:
+When written as a query, the template would include invalid JSON, such as
+section markers like `{{#line_no}}`:
 
 [source,js]
 ------------------------------------------
@@ -587,19 +587,14 @@ We could write the query as:
 <6> Include the `lte` clause only if `line_no.end` is specified
 <7> Fill in the value of param `line_no.end`
 
-[NOTE]
-==================================
-As written above, this template is not valid JSON because it includes the
-_section_ markers like `{{#line_no}}`.  For this reason, the template should
-either be stored in a file (see <<pre-registered-templates>>) or, when used
-via the REST API, should be written as a string:
+Because search templates cannot include invalid JSON, you can pass the same
+query as a string instead:
 
 [source,js]
 --------------------
 "source": "{\"query\":{\"bool\":{\"must\":{\"match\":{\"line\":\"{{text}}\"}},\"filter\":{{{#line_no}}\"range\":{\"line_no\":{{{#start}}\"gte\":\"{{start}}\"{{#end}},{{/end}}{{/start}}{{#end}}\"lte\":\"{{end}}\"{{/end}}}}{{/line_no}}}}}}"
 --------------------
 // NOTCONSOLE
-==================================
 
 
 [[search-template-encode-urls]]

From 9f239d6d740005c6673baa485fd6c1cd5007204d Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Fri, 20 Dec 2019 14:32:37 -0500
Subject: [PATCH 316/686] [ML][Inference] minor cleanup for inference (#50444)

---
 .../core/ml/inference/InferenceToXContentCompressor.java | 4 ++--
 .../xpack/ml/inference/ingest/InferenceProcessor.java    | 9 ++-------
 2 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/InferenceToXContentCompressor.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/InferenceToXContentCompressor.java
index f2d24c81b8695..96b4eb9d6493a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/InferenceToXContentCompressor.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/InferenceToXContentCompressor.java
@@ -43,8 +43,8 @@ public static <T extends ToXContentObject> String deflate(T objectToCompress) th
     }
 
     static <T> T inflate(String compressedString,
-                                CheckedFunction<XContentParser, T, IOException> parserFunction,
-                                NamedXContentRegistry xContentRegistry) throws IOException {
+                         CheckedFunction<XContentParser, T, IOException> parserFunction,
+                         NamedXContentRegistry xContentRegistry) throws IOException {
         try(XContentParser parser = XContentHelper.createParser(xContentRegistry,
             LoggingDeprecationHandler.INSTANCE,
             inflate(compressedString, MAX_INFLATED_BYTES),
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
index 18ac57d1ae818..cc2e7997d6318 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessor.java
@@ -28,7 +28,6 @@
 import org.elasticsearch.ingest.Processor;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.xpack.core.ml.action.InternalInferModelAction;
-import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.WarningInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
@@ -151,12 +150,8 @@ void mutateDocument(InternalInferModelAction.Response response, IngestDocument i
         if (response.getInferenceResults().isEmpty()) {
             throw new ElasticsearchStatusException("Unexpected empty inference response", RestStatus.INTERNAL_SERVER_ERROR);
         }
-        InferenceResults inferenceResults = response.getInferenceResults().get(0);
-        if (inferenceResults instanceof WarningInferenceResults) {
-            inferenceResults.writeResult(ingestDocument, this.targetField);
-        } else {
-            response.getInferenceResults().get(0).writeResult(ingestDocument, this.targetField);
-        }
+        assert response.getInferenceResults().size() == 1;
+        response.getInferenceResults().get(0).writeResult(ingestDocument, this.targetField);
         ingestDocument.setFieldValue(targetField + "." + MODEL_ID, modelId);
     }
 

From 49d711f649b58810b179eb609507032d0a28c824 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Fri, 20 Dec 2019 15:01:19 -0800
Subject: [PATCH 317/686] Upgrade to Gradle Enterprise plugin 3.1.1 (#50451)

---
 settings.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/settings.gradle b/settings.gradle
index d92f5584a27a9..0d3c40a00ff7f 100644
--- a/settings.gradle
+++ b/settings.gradle
@@ -1,5 +1,5 @@
 plugins {
-  id "com.gradle.enterprise" version "3.0"
+  id "com.gradle.enterprise" version "3.1.1"
 }
 
 String dirName = rootProject.projectDir.name

From 87f18ffb98616ebc79d6618c000d4988e6c6f5da Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Mon, 23 Dec 2019 10:48:58 +0100
Subject: [PATCH 318/686] Unmute 'Test url escaping with url mustache function'
 webhook watcher test (#50439)

Some changes had to be made in order to make the test pass due to the removal or types.
Added some more assertions. The failure description in this comment [0] indicates that the rest handler couldn't be found. The test passes now.
I plan to merge this into master and see how CI reacts, if it handles this change well then I will also unmute this test in 7 dot x branch.

Relates to #41172

0: https://github.com/elastic/elasticsearch/issues/41172#issuecomment-496993976
---
 .../test/mustache/50_webhook_url_escaping.yml     | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/x-pack/qa/smoke-test-watcher/src/test/resources/rest-api-spec/test/mustache/50_webhook_url_escaping.yml b/x-pack/qa/smoke-test-watcher/src/test/resources/rest-api-spec/test/mustache/50_webhook_url_escaping.yml
index bff41eceab3f7..88986a5546c7c 100644
--- a/x-pack/qa/smoke-test-watcher/src/test/resources/rest-api-spec/test/mustache/50_webhook_url_escaping.yml
+++ b/x-pack/qa/smoke-test-watcher/src/test/resources/rest-api-spec/test/mustache/50_webhook_url_escaping.yml
@@ -1,8 +1,5 @@
 ---
 "Test url escaping with url mustache function":
-  - skip:
-      version: "all"
-      reason: "AwaitsFix https://github.com/elastic/elasticsearch/issues/41172"
   - do:
       cluster.health:
           wait_for_status: yellow
@@ -10,7 +7,6 @@
   - do:
       index:
         index:   <date-index-{now/d}>
-        type:    log
         id:      1
         refresh: true
         body:    { foo: bar }
@@ -36,10 +32,15 @@
           pipeline:
             description: _description
             processors: [ grok: { field: host, patterns : ["%{IPORHOST:hostname}:%{NUMBER:port:int}"] } ]
-          docs: [ { _index: index, _type: type, _id: id, _source: { host: $host } } ]
+          docs: [ { _index: index, _id: id, _source: { host: $host } } ]
   - set: { docs.0.doc._source.hostname: hostname }
   - set: { docs.0.doc._source.port: port }
 
+  - do:
+      count:
+        index: <date-index-{now/d}>
+  - match: {count: 1}
+
   - do:
       watcher.put_watch:
           id: "test_watch"
@@ -67,7 +68,7 @@
                   method: PUT
                   host: $hostname
                   port: $port
-                  path: "/{{#url}}{{ctx.metadata.index}}{{/url}}/log/2"
+                  path: "/{{#url}}{{ctx.metadata.index}}{{/url}}/_doc/2"
                   params:
                     refresh: "true"
                   body: "{ \"foo\": \"bar\" }"
@@ -78,6 +79,8 @@
   - do:
       watcher.execute_watch:
           id: "test_watch"
+  - match: {watch_record.result.condition.met: true}
+  - match: {watch_record.result.actions.0.status: 'success'}
 
   - do:
       count:

From df24374f2248640049db2a4408d593154d198ad8 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 23 Dec 2019 11:23:39 +0100
Subject: [PATCH 319/686] Fix Source Only Snapshot REST Test Failure (#50456)

We are matching on the exact number of shards in this test, but may run into
snapshotting more than the single index created in it due to auto-created indices like
`.watcher`.
Fixed by making the test only take a snapshot of the single index used by this test.

Closes #50450
---
 .../src/test/resources/rest-api-spec/test/snapshot/10_basic.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/snapshot/10_basic.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/snapshot/10_basic.yml
index 58ace059d04c1..e0ac436718595 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/snapshot/10_basic.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/snapshot/10_basic.yml
@@ -39,6 +39,8 @@ setup:
         repository: test_repo_restore_1
         snapshot: test_snapshot
         wait_for_completion: true
+        body: |
+          { "indices": "test_index" }
 
   - match: { snapshot.snapshot: test_snapshot }
   - match: { snapshot.state : SUCCESS }

From 19a922fee5bf9222269272e3dfd81178c72a647c Mon Sep 17 00:00:00 2001
From: Xiang Dai <764524258@qq.com>
Date: Mon, 23 Dec 2019 23:35:14 +0800
Subject: [PATCH 320/686] Fix docs typos (#50365)

Fixes a few typos in the docs.

Signed-off-by: Xiang Dai 764524258@qq.com
---
 docs/painless/painless-guide/painless-datetime.asciidoc  | 8 ++++----
 docs/plugins/discovery-ec2.asciidoc                      | 2 +-
 docs/plugins/mapper-annotated-text.asciidoc              | 2 +-
 docs/reference/analysis/analyzers/lang-analyzer.asciidoc | 4 ++--
 docs/reference/docs/delete-by-query.asciidoc             | 2 +-
 docs/reference/docs/get.asciidoc                         | 2 +-
 docs/reference/docs/update-by-query.asciidoc             | 2 +-
 docs/reference/ilm/apis/slm-api.asciidoc                 | 2 +-
 docs/reference/ilm/getting-started-slm.asciidoc          | 4 ++--
 docs/reference/mapping/types/shape.asciidoc              | 2 +-
 docs/reference/query-dsl/exists-query.asciidoc           | 2 +-
 docs/reference/search/validate.asciidoc                  | 2 +-
 docs/reference/setup/install/deb.asciidoc                | 2 +-
 docs/reference/setup/install/rpm.asciidoc                | 2 +-
 docs/reference/sql/language/syntax/lexic/index.asciidoc  | 4 ++--
 15 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/docs/painless/painless-guide/painless-datetime.asciidoc b/docs/painless/painless-guide/painless-datetime.asciidoc
index 68d93f4e3693d..17aed8fb90904 100644
--- a/docs/painless/painless-guide/painless-datetime.asciidoc
+++ b/docs/painless/painless-guide/painless-datetime.asciidoc
@@ -293,7 +293,7 @@ if (timestamp1 > timestamp2) {
 }
 ----
 +
-* Equality comparision of two complex datetimes
+* Equality comparison of two complex datetimes
 +
 [source,Painless]
 ----
@@ -307,7 +307,7 @@ if (zdt1.equals(zdt2)) {
 }
 ----
 +
-* Less than comparision of two complex datetimes
+* Less than comparison of two complex datetimes
 +
 [source,Painless]
 ----
@@ -321,7 +321,7 @@ if (zdt1.isBefore(zdt2)) {
 }
 ----
 +
-* Greater than comparision of two complex datetimes
+* Greater than comparison of two complex datetimes
 +
 [source,Painless]
 ----
@@ -611,7 +611,7 @@ per document, so each time the script is run a different `now` is returned. The
 second is scripts are often run in a distributed fashion without a way to
 appropriately synchronize `now`. Instead, pass in a user-defined parameter with
 either a string datetime or numeric datetime for `now`. A numeric datetime is
-preferred as there is no need to parse it for comparision.
+preferred as there is no need to parse it for comparison.
 
 ===== Datetime Now Examples
 
diff --git a/docs/plugins/discovery-ec2.asciidoc b/docs/plugins/discovery-ec2.asciidoc
index c1a4913170301..4ea3ab826bd70 100644
--- a/docs/plugins/discovery-ec2.asciidoc
+++ b/docs/plugins/discovery-ec2.asciidoc
@@ -290,7 +290,7 @@ available on AWS-based infrastructure from http://www.elastic.co/cloud.
 ===== Storage
 
 EC2 instances offer a number of different kinds of storage. Please be aware of
-the folowing when selecting the storage for your cluster:
+the following when selecting the storage for your cluster:
 
 * http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html[Instance
 Store] is recommended for {es} clusters as it offers excellent performance and
diff --git a/docs/plugins/mapper-annotated-text.asciidoc b/docs/plugins/mapper-annotated-text.asciidoc
index 151fccfd73344..ff1a497fb6c9a 100644
--- a/docs/plugins/mapper-annotated-text.asciidoc
+++ b/docs/plugins/mapper-annotated-text.asciidoc
@@ -137,7 +137,7 @@ GET my_index/_search
 inject the single token value `Beck` at the same position as `beck` in the token stream.
 <2> Note annotations can inject multiple tokens at the same position - here we inject both
 the very specific value `Jeff Beck` and the broader term `Guitarist`. This enables
-broader positional queries e.g. finding mentions of a `Guitarist` near to `strat`.
+broader positional queries e.g. finding mentions of a `Guitarist` near to `start`.
 <3> A benefit of searching with these carefully defined annotation tokens is that a query for 
 `Beck` will not match document 2 that contains the tokens `jeff`, `beck` and `Jeff Beck`
 
diff --git a/docs/reference/analysis/analyzers/lang-analyzer.asciidoc b/docs/reference/analysis/analyzers/lang-analyzer.asciidoc
index a57fef8d28e96..dbcbc17e44e96 100644
--- a/docs/reference/analysis/analyzers/lang-analyzer.asciidoc
+++ b/docs/reference/analysis/analyzers/lang-analyzer.asciidoc
@@ -388,7 +388,7 @@ PUT /catalan_example
         },
         "catalan_keywords": {
           "type":       "keyword_marker",
-          "keywords":   ["exemple"] <2>
+          "keywords":   ["example"] <2>
         },
         "catalan_stemmer": {
           "type":       "stemmer",
@@ -798,7 +798,7 @@ PUT /french_example
         },
         "french_keywords": {
           "type":       "keyword_marker",
-          "keywords":   ["Exemple"] <2>
+          "keywords":   ["Example"] <2>
         },
         "french_stemmer": {
           "type":       "stemmer",
diff --git a/docs/reference/docs/delete-by-query.asciidoc b/docs/reference/docs/delete-by-query.asciidoc
index 71d00528e80cc..093504f712adb 100644
--- a/docs/reference/docs/delete-by-query.asciidoc
+++ b/docs/reference/docs/delete-by-query.asciidoc
@@ -74,7 +74,7 @@ and all failed requests are returned in the response. Any delete requests that
 completed successfully still stick, they are not rolled back. 
 
 You can opt to count version conflicts instead of halting and returning by 
-setting `conflicts` to `proceeed`. 
+setting `conflicts` to `proceed`. 
 
 ===== Refreshing shards
 
diff --git a/docs/reference/docs/get.asciidoc b/docs/reference/docs/get.asciidoc
index 525eba79a03d3..a26b7cdf061f9 100644
--- a/docs/reference/docs/get.asciidoc
+++ b/docs/reference/docs/get.asciidoc
@@ -206,7 +206,7 @@ The explicit routing, if set.
 '_source'::
 If `found` is `true`, contains the document data formatted in JSON.
 Excluded if the `_source` parameter is set to `false` or the `stored_fields`
-paramter is set to `true`.
+parameter is set to `true`.
 
 '_fields'::
 If the `stored_fields` parameter is set to `true` and `found` is
diff --git a/docs/reference/docs/update-by-query.asciidoc b/docs/reference/docs/update-by-query.asciidoc
index 2f70994244b54..83d1105deaadf 100644
--- a/docs/reference/docs/update-by-query.asciidoc
+++ b/docs/reference/docs/update-by-query.asciidoc
@@ -59,7 +59,7 @@ When the versions match, the document is updated and the version number is incre
 If a document changes between the time that the snapshot is taken and 
 the update operation is processed, it results in a version conflict and the operation fails. 
 You can opt to count version conflicts instead of halting and returning by 
-setting `conflicts` to `proceeed`. 
+setting `conflicts` to `proceed`. 
 
 NOTE: Documents with a version equal to 0 cannot be updated using update by
 query because `internal` versioning does not support 0 as a valid
diff --git a/docs/reference/ilm/apis/slm-api.asciidoc b/docs/reference/ilm/apis/slm-api.asciidoc
index 890e645a989d4..51e095f72ef69 100644
--- a/docs/reference/ilm/apis/slm-api.asciidoc
+++ b/docs/reference/ilm/apis/slm-api.asciidoc
@@ -300,7 +300,7 @@ The API returns the following response:
 }
 --------------------------------------------------
 // TESTRESPONSE[s/"modified_date": "2019-04-23T01:30:00.000Z"/"modified_date": $body.daily-snapshots.modified_date/ s/"modified_date_millis": 1556048137314/"modified_date_millis": $body.daily-snapshots.modified_date_millis/ s/"next_execution": "2019-04-24T01:30:00.000Z"/"next_execution": $body.daily-snapshots.next_execution/ s/"next_execution_millis": 1556048160000/"next_execution_millis": $body.daily-snapshots.next_execution_millis/]
-<1> The version of the snapshot policy, only the latest verison is stored and incremented when the policy is updated
+<1> The version of the snapshot policy, only the latest version is stored and incremented when the policy is updated
 <2> The last time this policy was modified.
 <3> The next time this policy will be executed.
 
diff --git a/docs/reference/ilm/getting-started-slm.asciidoc b/docs/reference/ilm/getting-started-slm.asciidoc
index 54ebef9a8dd3b..f09a631e8abe1 100644
--- a/docs/reference/ilm/getting-started-slm.asciidoc
+++ b/docs/reference/ilm/getting-started-slm.asciidoc
@@ -137,7 +137,7 @@ While snapshots taken by SLM policies can be viewed through the standard snapsho
 API, SLM also keeps track of policy successes and failures in ways that are a bit
 easier to use to make sure the policy is working.  Once a policy has executed at
 least once, when you view the policy using the <<slm-api-get,Get Policy API>>, 
-some metadata will be returned indicating whether the snapshot was sucessfully 
+some metadata will be returned indicating whether the snapshot was successfully 
 initiated or not.
 
 Instead of waiting for our policy to run, let's tell SLM to take a snapshot
@@ -219,7 +219,7 @@ field - it's included above only as an example. You should, however, see a
 `last_success` field and a snapshot name. If you do, you've successfully taken
 your first snapshot using SLM!
 
-While only the most recent sucess and failure are available through the Get Policy 
+While only the most recent success and failure are available through the Get Policy 
 API, all policy executions are recorded to a history index, which may be queried
 by searching the index pattern `.slm-history*`.
 
diff --git a/docs/reference/mapping/types/shape.asciidoc b/docs/reference/mapping/types/shape.asciidoc
index 3a180690ff44d..9969021c7853d 100644
--- a/docs/reference/mapping/types/shape.asciidoc
+++ b/docs/reference/mapping/types/shape.asciidoc
@@ -61,7 +61,7 @@ and reject the whole document.
 Like `geo_shape`, the `shape` field type is indexed by decomposing geometries into
 a triangular mesh and indexing each triangle as a 7 dimension point in a BKD tree.
 The coordinates provided to the indexer are single precision floating point values so
-the field guarantess the same accuracy provided by the java virtual machine (typically
+the field guarantees the same accuracy provided by the java virtual machine (typically
 `1E-38`). For polygons/multi-polygons the performance of the tessellator primarily
 depends on the number of vertices that define the geometry.
 
diff --git a/docs/reference/query-dsl/exists-query.asciidoc b/docs/reference/query-dsl/exists-query.asciidoc
index 539e7208e0063..fd0f13b50ff50 100644
--- a/docs/reference/query-dsl/exists-query.asciidoc
+++ b/docs/reference/query-dsl/exists-query.asciidoc
@@ -33,7 +33,7 @@ GET /_search
 `field`::
 (Required, string) Name of the field you wish to search.
 +
-While a field is deemed non-existant if the JSON value is `null` or `[]`, these
+While a field is deemed non-existent if the JSON value is `null` or `[]`, these
 values will indicate the field does exist:
 +
 * Empty strings, such as `""` or `"-"`
diff --git a/docs/reference/search/validate.asciidoc b/docs/reference/search/validate.asciidoc
index 9ec81279f3df6..c88ca44a4a3b9 100644
--- a/docs/reference/search/validate.asciidoc
+++ b/docs/reference/search/validate.asciidoc
@@ -53,7 +53,7 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
 
 `explain`::
   (Optional, boolean) If `true`, the response returns detailed information if an 
-  error has occured. Defautls to `false`.
+  error has occurred. Defaults to `false`.
 
 include::{docdir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
 
diff --git a/docs/reference/setup/install/deb.asciidoc b/docs/reference/setup/install/deb.asciidoc
index 30ce4a5c0264b..77853e2337b6e 100644
--- a/docs/reference/setup/install/deb.asciidoc
+++ b/docs/reference/setup/install/deb.asciidoc
@@ -240,7 +240,7 @@ locations for a Debian-based system:
 
 | jdk
   | The bundled Java Development Kit used to run Elasticsearch. Can
-    be overriden by setting the `JAVA_HOME` environment variable
+    be overridden by setting the `JAVA_HOME` environment variable
     in `/etc/default/elasticsearch`.
   | /usr/share/elasticsearch/jdk
  d|
diff --git a/docs/reference/setup/install/rpm.asciidoc b/docs/reference/setup/install/rpm.asciidoc
index f1601f95b1773..301bbdc43b47a 100644
--- a/docs/reference/setup/install/rpm.asciidoc
+++ b/docs/reference/setup/install/rpm.asciidoc
@@ -233,7 +233,7 @@ locations for an RPM-based system:
 
 | jdk
   | The bundled Java Development Kit used to run Elasticsearch. Can
-    be overriden by setting the `JAVA_HOME` environment variable
+    be overridden by setting the `JAVA_HOME` environment variable
     in `/etc/sysconfig/elasticsearch`.
   | /usr/share/elasticsearch/jdk
  d|
diff --git a/docs/reference/sql/language/syntax/lexic/index.asciidoc b/docs/reference/sql/language/syntax/lexic/index.asciidoc
index 9b2f78c35cd90..b1405f0c9cb70 100644
--- a/docs/reference/sql/language/syntax/lexic/index.asciidoc
+++ b/docs/reference/sql/language/syntax/lexic/index.asciidoc
@@ -148,7 +148,7 @@ s|Description
 
 Most operators in {es-sql} have the same precedence and are left-associative. As this is done at parsing time, parenthesis need to be used to enforce a different precedence.
 
-The following table indicates the supported operators and their precendence (highest to lowest);
+The following table indicates the supported operators and their precedence (highest to lowest);
 
 [cols="^2m,^,^3"]
 
@@ -176,7 +176,7 @@ s|Description
 
 |+ -
 |left
-|addition, substraction
+|addition, subtraction
 
 |BETWEEN IN LIKE
 |

From 95d57063d795d8be9d185221ecee69c4b729de24 Mon Sep 17 00:00:00 2001
From: Tal Levy <JubBoy333@gmail.com>
Date: Mon, 23 Dec 2019 10:07:03 -0800
Subject: [PATCH 321/686] Centralize BoundingBox logic to a dedicated class
 (#50253)

Both geo_bounding_box query and geo_bounds aggregation have
a very similar definition of a "bounding box". A lot of this
logic (serialization, xcontent-parsing, etc) can be centralized
instead of having separated efforts to do the same things
---
 .../common/geo/GeoBoundingBox.java            | 229 ++++++++++++++++++
 .../query/GeoBoundingBoxQueryBuilder.java     | 125 ++--------
 .../metrics/InternalGeoBounds.java            |  84 ++-----
 .../aggregations/metrics/ParsedGeoBounds.java |  34 +--
 .../common/geo/GeoBoundingBoxTests.java       | 149 ++++++++++++
 ...gBoxIT.java => GeoBoundingBoxQueryIT.java} |   2 +-
 6 files changed, 434 insertions(+), 189 deletions(-)
 create mode 100644 server/src/main/java/org/elasticsearch/common/geo/GeoBoundingBox.java
 create mode 100644 server/src/test/java/org/elasticsearch/common/geo/GeoBoundingBoxTests.java
 rename server/src/test/java/org/elasticsearch/search/geo/{GeoBoundingBoxIT.java => GeoBoundingBoxQueryIT.java} (99%)

diff --git a/server/src/main/java/org/elasticsearch/common/geo/GeoBoundingBox.java b/server/src/main/java/org/elasticsearch/common/geo/GeoBoundingBox.java
new file mode 100644
index 0000000000000..78e81925275d7
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/common/geo/GeoBoundingBox.java
@@ -0,0 +1,229 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.common.geo;
+
+import org.elasticsearch.ElasticsearchParseException;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.geometry.Geometry;
+import org.elasticsearch.geometry.Rectangle;
+import org.elasticsearch.geometry.ShapeType;
+import org.elasticsearch.geometry.utils.StandardValidator;
+import org.elasticsearch.geometry.utils.WellKnownText;
+
+import java.io.IOException;
+import java.text.ParseException;
+import java.util.Objects;
+
+/**
+ * A class representing a Geo-Bounding-Box for use by Geo queries and aggregations
+ * that deal with extents/rectangles representing rectangular areas of interest.
+ */
+public class GeoBoundingBox implements ToXContentObject, Writeable {
+    private static final WellKnownText WKT_PARSER = new WellKnownText(true, new StandardValidator(true));
+    static final ParseField TOP_RIGHT_FIELD = new ParseField("top_right");
+    static final ParseField BOTTOM_LEFT_FIELD = new ParseField("bottom_left");
+    static final ParseField TOP_FIELD = new ParseField("top");
+    static final ParseField BOTTOM_FIELD = new ParseField("bottom");
+    static final ParseField LEFT_FIELD = new ParseField("left");
+    static final ParseField RIGHT_FIELD = new ParseField("right");
+    static final ParseField WKT_FIELD = new ParseField("wkt");
+    public static final ParseField BOUNDS_FIELD = new ParseField("bounds");
+    public static final ParseField LAT_FIELD = new ParseField("lat");
+    public static final ParseField LON_FIELD = new ParseField("lon");
+    public static final ParseField TOP_LEFT_FIELD = new ParseField("top_left");
+    public static final ParseField BOTTOM_RIGHT_FIELD = new ParseField("bottom_right");
+
+    private final GeoPoint topLeft;
+    private final GeoPoint bottomRight;
+
+    public GeoBoundingBox(GeoPoint topLeft, GeoPoint bottomRight) {
+        this.topLeft = topLeft;
+        this.bottomRight = bottomRight;
+    }
+
+    public GeoBoundingBox(StreamInput input) throws IOException {
+        this.topLeft = input.readGeoPoint();
+        this.bottomRight = input.readGeoPoint();
+    }
+
+    public GeoPoint topLeft() {
+        return topLeft;
+    }
+
+    public GeoPoint bottomRight() {
+        return bottomRight;
+    }
+
+    public double top() {
+        return topLeft.lat();
+    }
+
+    public double bottom() {
+        return bottomRight.lat();
+    }
+
+    public double left() {
+        return topLeft.lon();
+    }
+
+    public double right() {
+        return bottomRight.lon();
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject(BOUNDS_FIELD.getPreferredName());
+        toXContentFragment(builder, true);
+        builder.endObject();
+        return builder;
+    }
+
+    public XContentBuilder toXContentFragment(XContentBuilder builder, boolean buildLatLonFields) throws IOException {
+        if (buildLatLonFields) {
+            builder.startObject(TOP_LEFT_FIELD.getPreferredName());
+            builder.field(LAT_FIELD.getPreferredName(), topLeft.lat());
+            builder.field(LON_FIELD.getPreferredName(), topLeft.lon());
+            builder.endObject();
+        } else {
+            builder.array(TOP_LEFT_FIELD.getPreferredName(), topLeft.lon(), topLeft.lat());
+        }
+        if (buildLatLonFields) {
+            builder.startObject(BOTTOM_RIGHT_FIELD.getPreferredName());
+            builder.field(LAT_FIELD.getPreferredName(), bottomRight.lat());
+            builder.field(LON_FIELD.getPreferredName(), bottomRight.lon());
+            builder.endObject();
+        } else {
+            builder.array(BOTTOM_RIGHT_FIELD.getPreferredName(), bottomRight.lon(), bottomRight.lat());
+        }
+        return builder;
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeGeoPoint(topLeft);
+        out.writeGeoPoint(bottomRight);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        GeoBoundingBox that = (GeoBoundingBox) o;
+        return topLeft.equals(that.topLeft) &&
+            bottomRight.equals(that.bottomRight);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(topLeft, bottomRight);
+    }
+
+    @Override
+    public String toString() {
+        return "BBOX (" + topLeft.lon() + ", " + bottomRight.lon() + ", " + topLeft.lat() + ", " + bottomRight.lat() + ")";
+    }
+
+    /**
+     * Parses the bounding box and returns bottom, top, left, right coordinates
+     */
+    public static GeoBoundingBox parseBoundingBox(XContentParser parser) throws IOException, ElasticsearchParseException {
+        XContentParser.Token token = parser.currentToken();
+        if (token != XContentParser.Token.START_OBJECT) {
+            throw new ElasticsearchParseException("failed to parse bounding box. Expected start object but found [{}]", token);
+        }
+
+        double top = Double.NaN;
+        double bottom = Double.NaN;
+        double left = Double.NaN;
+        double right = Double.NaN;
+
+        String currentFieldName;
+        GeoPoint sparse = new GeoPoint();
+        Rectangle envelope = null;
+
+        while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
+            if (token == XContentParser.Token.FIELD_NAME) {
+                currentFieldName = parser.currentName();
+                token = parser.nextToken();
+                if (WKT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                    try {
+                        Geometry geometry = WKT_PARSER.fromWKT(parser.text());
+                        if (ShapeType.ENVELOPE.equals(geometry.type()) == false) {
+                            throw new ElasticsearchParseException("failed to parse WKT bounding box. ["
+                                + geometry.type() + "] found. expected [" + ShapeType.ENVELOPE + "]");
+                        }
+                        envelope = (Rectangle) geometry;
+                    } catch (ParseException|IllegalArgumentException e) {
+                        throw new ElasticsearchParseException("failed to parse WKT bounding box", e);
+                    }
+                } else if (TOP_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                    top = parser.doubleValue();
+                } else if (BOTTOM_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                    bottom = parser.doubleValue();
+                } else if (LEFT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                    left = parser.doubleValue();
+                } else if (RIGHT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                    right = parser.doubleValue();
+                } else {
+                    if (TOP_LEFT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                        GeoUtils.parseGeoPoint(parser, sparse, false, GeoUtils.EffectivePoint.TOP_LEFT);
+                        top = sparse.getLat();
+                        left = sparse.getLon();
+                    } else if (BOTTOM_RIGHT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                        GeoUtils.parseGeoPoint(parser, sparse, false, GeoUtils.EffectivePoint.BOTTOM_RIGHT);
+                        bottom = sparse.getLat();
+                        right = sparse.getLon();
+                    } else if (TOP_RIGHT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                        GeoUtils.parseGeoPoint(parser, sparse, false, GeoUtils.EffectivePoint.TOP_RIGHT);
+                        top = sparse.getLat();
+                        right = sparse.getLon();
+                    } else if (BOTTOM_LEFT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
+                        GeoUtils.parseGeoPoint(parser, sparse, false, GeoUtils.EffectivePoint.BOTTOM_LEFT);
+                        bottom = sparse.getLat();
+                        left = sparse.getLon();
+                    } else {
+                        throw new ElasticsearchParseException("failed to parse bounding box. unexpected field [{}]", currentFieldName);
+                    }
+                }
+            } else {
+                throw new ElasticsearchParseException("failed to parse bounding box. field name expected but [{}] found", token);
+            }
+        }
+        if (envelope != null) {
+            if (Double.isNaN(top) == false || Double.isNaN(bottom) == false || Double.isNaN(left) == false ||
+                Double.isNaN(right) == false) {
+                throw new ElasticsearchParseException("failed to parse bounding box. Conflicting definition found "
+                    + "using well-known text and explicit corners.");
+            }
+            GeoPoint topLeft = new GeoPoint(envelope.getMaxLat(), envelope.getMinLon());
+            GeoPoint bottomRight = new GeoPoint(envelope.getMinLat(), envelope.getMaxLon());
+            return new GeoBoundingBox(topLeft, bottomRight);
+        }
+        GeoPoint topLeft = new GeoPoint(top, left);
+        GeoPoint bottomRight = new GeoPoint(bottom, right);
+        return new GeoBoundingBox(topLeft, bottomRight);
+    }
+
+}
diff --git a/server/src/main/java/org/elasticsearch/index/query/GeoBoundingBoxQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/GeoBoundingBoxQueryBuilder.java
index 699d4b79aa72b..59025dc03e161 100644
--- a/server/src/main/java/org/elasticsearch/index/query/GeoBoundingBoxQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/GeoBoundingBoxQueryBuilder.java
@@ -21,7 +21,6 @@
 
 import org.apache.lucene.document.LatLonDocValuesField;
 import org.apache.lucene.document.LatLonPoint;
-//import org.apache.lucene.geo.Rectangle;
 import org.apache.lucene.search.IndexOrDocValuesQuery;
 import org.apache.lucene.search.MatchNoDocsQuery;
 import org.apache.lucene.search.Query;
@@ -29,11 +28,9 @@
 import org.elasticsearch.common.Numbers;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.ParsingException;
+import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.common.geo.GeoPoint;
-import org.elasticsearch.common.geo.GeoShapeType;
 import org.elasticsearch.common.geo.GeoUtils;
-import org.elasticsearch.common.geo.builders.EnvelopeBuilder;
-import org.elasticsearch.common.geo.parsers.GeoWKTParser;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -66,24 +63,12 @@ public class GeoBoundingBoxQueryBuilder extends AbstractQueryBuilder<GeoBounding
 
     private static final ParseField TYPE_FIELD = new ParseField("type");
     private static final ParseField VALIDATION_METHOD_FIELD = new ParseField("validation_method");
-    private static final ParseField TOP_FIELD = new ParseField("top");
-    private static final ParseField BOTTOM_FIELD = new ParseField("bottom");
-    private static final ParseField LEFT_FIELD = new ParseField("left");
-    private static final ParseField RIGHT_FIELD = new ParseField("right");
-    private static final ParseField TOP_LEFT_FIELD = new ParseField("top_left");
-    private static final ParseField BOTTOM_RIGHT_FIELD = new ParseField("bottom_right");
-    private static final ParseField TOP_RIGHT_FIELD = new ParseField("top_right");
-    private static final ParseField BOTTOM_LEFT_FIELD = new ParseField("bottom_left");
     private static final ParseField IGNORE_UNMAPPED_FIELD = new ParseField("ignore_unmapped");
-    private static final ParseField WKT_FIELD = new ParseField("wkt");
 
 
     /** Name of field holding geo coordinates to compute the bounding box on.*/
     private final String fieldName;
-    /** Top left corner coordinates of bounding box. */
-    private GeoPoint topLeft = new GeoPoint(Double.NaN, Double.NaN);
-    /** Bottom right corner coordinates of bounding box.*/
-    private GeoPoint bottomRight = new GeoPoint(Double.NaN, Double.NaN);
+    private GeoBoundingBox geoBoundingBox = new GeoBoundingBox(new GeoPoint(Double.NaN, Double.NaN), new GeoPoint(Double.NaN, Double.NaN));
     /** How to deal with incorrect coordinates.*/
     private GeoValidationMethod validationMethod = GeoValidationMethod.DEFAULT;
     /** How the query should be run. */
@@ -108,8 +93,7 @@ public GeoBoundingBoxQueryBuilder(String fieldName) {
     public GeoBoundingBoxQueryBuilder(StreamInput in) throws IOException {
         super(in);
         fieldName = in.readString();
-        topLeft = in.readGeoPoint();
-        bottomRight = in.readGeoPoint();
+        geoBoundingBox = new GeoBoundingBox(in);
         type = GeoExecType.readFromStream(in);
         validationMethod = GeoValidationMethod.readFromStream(in);
         ignoreUnmapped = in.readBoolean();
@@ -118,8 +102,7 @@ public GeoBoundingBoxQueryBuilder(StreamInput in) throws IOException {
     @Override
     protected void doWriteTo(StreamOutput out) throws IOException {
         out.writeString(fieldName);
-        out.writeGeoPoint(topLeft);
-        out.writeGeoPoint(bottomRight);
+        geoBoundingBox.writeTo(out);
         type.writeTo(out);
         validationMethod.writeTo(out);
         out.writeBoolean(ignoreUnmapped);
@@ -162,8 +145,8 @@ public GeoBoundingBoxQueryBuilder setCorners(double top, double left, double bot
                 // we do not check longitudes as the query generation code can deal with flipped left/right values
         }
 
-        topLeft.reset(top, left);
-        bottomRight.reset(bottom, right);
+        geoBoundingBox.topLeft().reset(top, left);
+        geoBoundingBox.bottomRight().reset(bottom, right);
         return this;
     }
 
@@ -197,12 +180,12 @@ public GeoBoundingBoxQueryBuilder setCorners(String topLeft, String bottomRight)
 
     /** Returns the top left corner of the bounding box. */
     public GeoPoint topLeft() {
-        return topLeft;
+        return geoBoundingBox.topLeft();
     }
 
     /** Returns the bottom right corner of the bounding box. */
     public GeoPoint bottomRight() {
-        return bottomRight;
+        return geoBoundingBox.bottomRight();
     }
 
     /**
@@ -295,6 +278,9 @@ QueryValidationException checkLatLon() {
             return null;
         }
 
+        GeoPoint topLeft = geoBoundingBox.topLeft();
+        GeoPoint bottomRight = geoBoundingBox.bottomRight();
+
         QueryValidationException validationException = null;
         // For everything post 2.0 validate latitude and longitude unless validation was explicitly turned off
         if (GeoUtils.isValidLatitude(topLeft.getLat()) == false) {
@@ -335,8 +321,8 @@ public Query doToQuery(QueryShardContext context) {
             throw new QueryShardException(context, "couldn't validate latitude/ longitude values", exception);
         }
 
-        GeoPoint luceneTopLeft = new GeoPoint(topLeft);
-        GeoPoint luceneBottomRight = new GeoPoint(bottomRight);
+        GeoPoint luceneTopLeft = new GeoPoint(geoBoundingBox.topLeft());
+        GeoPoint luceneBottomRight = new GeoPoint(geoBoundingBox.bottomRight());
         if (GeoValidationMethod.isCoerce(validationMethod)) {
             // Special case: if the difference between the left and right is 360 and the right is greater than the left, we are asking for
             // the complete longitude range so need to set longitude to the complete longitude range
@@ -368,8 +354,7 @@ protected void doXContent(XContentBuilder builder, Params params) throws IOExcep
         builder.startObject(NAME);
 
         builder.startObject(fieldName);
-        builder.array(TOP_LEFT_FIELD.getPreferredName(), topLeft.getLon(), topLeft.getLat());
-        builder.array(BOTTOM_RIGHT_FIELD.getPreferredName(), bottomRight.getLon(), bottomRight.getLat());
+        geoBoundingBox.toXContentFragment(builder, false);
         builder.endObject();
         builder.field(VALIDATION_METHOD_FIELD.getPreferredName(), validationMethod);
         builder.field(TYPE_FIELD.getPreferredName(), type);
@@ -391,7 +376,7 @@ public static GeoBoundingBoxQueryBuilder fromXContent(XContentParser parser) thr
         boolean ignoreUnmapped = DEFAULT_IGNORE_UNMAPPED;
 
         // bottom (minLat), top (maxLat), left (minLon), right (maxLon)
-        double[] bbox = null;
+        GeoBoundingBox bbox = null;
         String type = "memory";
 
         while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
@@ -399,7 +384,7 @@ public static GeoBoundingBoxQueryBuilder fromXContent(XContentParser parser) thr
                 currentFieldName = parser.currentName();
             } else if (token == XContentParser.Token.START_OBJECT) {
                 try {
-                    bbox = parseBoundingBox(parser);
+                    bbox = GeoBoundingBox.parseBoundingBox(parser);
                     fieldName = currentFieldName;
                 } catch (Exception e) {
                     throw new ElasticsearchParseException("failed to parse [{}] query. [{}]", NAME, e.getMessage());
@@ -426,11 +411,8 @@ public static GeoBoundingBoxQueryBuilder fromXContent(XContentParser parser) thr
             throw new ElasticsearchParseException("failed to parse [{}] query. bounding box not provided", NAME);
         }
 
-        final GeoPoint topLeft = new GeoPoint(bbox[1], bbox[2]);
-        final GeoPoint bottomRight = new GeoPoint(bbox[0], bbox[3]);
-
         GeoBoundingBoxQueryBuilder builder = new GeoBoundingBoxQueryBuilder(fieldName);
-        builder.setCorners(topLeft, bottomRight);
+        builder.setCorners(bbox.topLeft(), bbox.bottomRight());
         builder.queryName(queryName);
         builder.boost(boost);
         builder.type(GeoExecType.fromString(type));
@@ -444,8 +426,7 @@ public static GeoBoundingBoxQueryBuilder fromXContent(XContentParser parser) thr
 
     @Override
     protected boolean doEquals(GeoBoundingBoxQueryBuilder other) {
-        return Objects.equals(topLeft, other.topLeft) &&
-                Objects.equals(bottomRight, other.bottomRight) &&
+        return Objects.equals(geoBoundingBox, other.geoBoundingBox) &&
                 Objects.equals(type, other.type) &&
                 Objects.equals(validationMethod, other.validationMethod) &&
                 Objects.equals(fieldName, other.fieldName) &&
@@ -454,7 +435,7 @@ protected boolean doEquals(GeoBoundingBoxQueryBuilder other) {
 
     @Override
     protected int doHashCode() {
-        return Objects.hash(topLeft, bottomRight, type, validationMethod, fieldName, ignoreUnmapped);
+        return Objects.hash(geoBoundingBox, type, validationMethod, fieldName, ignoreUnmapped);
     }
 
     @Override
@@ -462,72 +443,4 @@ public String getWriteableName() {
         return NAME;
     }
 
-    /**
-     * Parses the bounding box and returns bottom, top, left, right coordinates
-     */
-    public static double[] parseBoundingBox(XContentParser parser) throws IOException, ElasticsearchParseException {
-        XContentParser.Token token = parser.currentToken();
-        if (token != XContentParser.Token.START_OBJECT) {
-            throw new ElasticsearchParseException("failed to parse bounding box. Expected start object but found [{}]", token);
-        }
-
-        double top = Double.NaN;
-        double bottom = Double.NaN;
-        double left = Double.NaN;
-        double right = Double.NaN;
-
-        String currentFieldName;
-        GeoPoint sparse = new GeoPoint();
-        EnvelopeBuilder envelope = null;
-
-        while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
-            if (token == XContentParser.Token.FIELD_NAME) {
-                currentFieldName = parser.currentName();
-                token = parser.nextToken();
-                if (WKT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    envelope = (EnvelopeBuilder)(GeoWKTParser.parseExpectedType(parser, GeoShapeType.ENVELOPE));
-                } else if (TOP_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    top = parser.doubleValue();
-                } else if (BOTTOM_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    bottom = parser.doubleValue();
-                } else if (LEFT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    left = parser.doubleValue();
-                } else if (RIGHT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    right = parser.doubleValue();
-                } else {
-                    if (TOP_LEFT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                        GeoUtils.parseGeoPoint(parser, sparse, false, GeoUtils.EffectivePoint.TOP_LEFT);
-                        top = sparse.getLat();
-                        left = sparse.getLon();
-                    } else if (BOTTOM_RIGHT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                        GeoUtils.parseGeoPoint(parser, sparse, false, GeoUtils.EffectivePoint.BOTTOM_RIGHT);
-                        bottom = sparse.getLat();
-                        right = sparse.getLon();
-                    } else if (TOP_RIGHT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                        GeoUtils.parseGeoPoint(parser, sparse, false, GeoUtils.EffectivePoint.TOP_RIGHT);
-                        top = sparse.getLat();
-                        right = sparse.getLon();
-                    } else if (BOTTOM_LEFT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                        GeoUtils.parseGeoPoint(parser, sparse, false, GeoUtils.EffectivePoint.BOTTOM_LEFT);
-                        bottom = sparse.getLat();
-                        left = sparse.getLon();
-                    } else {
-                        throw new ElasticsearchParseException("failed to parse bounding box. unexpected field [{}]", currentFieldName);
-                    }
-                }
-            } else {
-                throw new ElasticsearchParseException("failed to parse bounding box. field name expected but [{}] found", token);
-            }
-        }
-        if (envelope != null) {
-            if (Double.isNaN(top) == false || Double.isNaN(bottom) == false || Double.isNaN(left) == false ||
-                Double.isNaN(right) == false) {
-                throw new ElasticsearchParseException("failed to parse bounding box. Conflicting definition found "
-                    + "using well-known text and explicit corners.");
-            }
-            org.locationtech.spatial4j.shape.Rectangle r = envelope.buildS4J();
-            return new double[]{r.getMinY(), r.getMaxY(), r.getMinX(), r.getMaxX()};
-        }
-        return new double[]{bottom, top, left, right};
-    }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBounds.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBounds.java
index 91007ab2f8fff..15585c2f4a3a8 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBounds.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBounds.java
@@ -19,7 +19,7 @@
 
 package org.elasticsearch.search.aggregations.metrics;
 
-import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.common.geo.GeoPoint;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
@@ -33,14 +33,6 @@
 import java.util.Objects;
 
 public class InternalGeoBounds extends InternalAggregation implements GeoBounds {
-
-    static final ParseField BOUNDS_FIELD = new ParseField("bounds");
-    static final ParseField TOP_LEFT_FIELD = new ParseField("top_left");
-    static final ParseField BOTTOM_RIGHT_FIELD = new ParseField("bottom_right");
-    static final ParseField LAT_FIELD = new ParseField("lat");
-    static final ParseField LON_FIELD = new ParseField("lon");
-
-
     final double top;
     final double bottom;
     final double posLeft;
@@ -132,30 +124,30 @@ public Object getProperty(List<String> path) {
         if (path.isEmpty()) {
             return this;
         } else if (path.size() == 1) {
-            BoundingBox boundingBox = resolveBoundingBox();
+            GeoBoundingBox geoBoundingBox = resolveGeoBoundingBox();
             String bBoxSide = path.get(0);
             switch (bBoxSide) {
             case "top":
-                return boundingBox.topLeft.lat();
+                return geoBoundingBox.top();
             case "left":
-                return boundingBox.topLeft.lon();
+                return geoBoundingBox.left();
             case "bottom":
-                return boundingBox.bottomRight.lat();
+                return geoBoundingBox.bottom();
             case "right":
-                return boundingBox.bottomRight.lon();
+                return geoBoundingBox.right();
             default:
                 throw new IllegalArgumentException("Found unknown path element [" + bBoxSide + "] in [" + getName() + "]");
             }
         } else if (path.size() == 2) {
-            BoundingBox boundingBox = resolveBoundingBox();
+            GeoBoundingBox geoBoundingBox = resolveGeoBoundingBox();
             GeoPoint cornerPoint = null;
             String cornerString = path.get(0);
             switch (cornerString) {
             case "top_left":
-                cornerPoint = boundingBox.topLeft;
+                cornerPoint = geoBoundingBox.topLeft();
                 break;
             case "bottom_right":
-                cornerPoint = boundingBox.bottomRight;
+                cornerPoint = geoBoundingBox.bottomRight();
                 break;
             default:
                 throw new IllegalArgumentException("Found unknown path element [" + cornerString + "] in [" + getName() + "]");
@@ -176,78 +168,50 @@ public Object getProperty(List<String> path) {
 
     @Override
     public XContentBuilder doXContentBody(XContentBuilder builder, Params params) throws IOException {
-        GeoPoint topLeft = topLeft();
-        GeoPoint bottomRight = bottomRight();
-        if (topLeft != null) {
-            builder.startObject(BOUNDS_FIELD.getPreferredName());
-            builder.startObject(TOP_LEFT_FIELD.getPreferredName());
-            builder.field(LAT_FIELD.getPreferredName(), topLeft.lat());
-            builder.field(LON_FIELD.getPreferredName(), topLeft.lon());
-            builder.endObject();
-            builder.startObject(BOTTOM_RIGHT_FIELD.getPreferredName());
-            builder.field(LAT_FIELD.getPreferredName(), bottomRight.lat());
-            builder.field(LON_FIELD.getPreferredName(), bottomRight.lon());
-            builder.endObject();
-            builder.endObject();
+        GeoBoundingBox bbox = resolveGeoBoundingBox();
+        if (bbox != null) {
+            bbox.toXContent(builder, params);
         }
         return builder;
     }
 
-    private static class BoundingBox {
-        private final GeoPoint topLeft;
-        private final GeoPoint bottomRight;
-
-        BoundingBox(GeoPoint topLeft, GeoPoint bottomRight) {
-            this.topLeft = topLeft;
-            this.bottomRight = bottomRight;
-        }
-
-        public GeoPoint topLeft() {
-            return topLeft;
-        }
-
-        public GeoPoint bottomRight() {
-            return bottomRight;
-        }
-    }
-
-    private BoundingBox resolveBoundingBox() {
+    private GeoBoundingBox resolveGeoBoundingBox() {
         if (Double.isInfinite(top)) {
             return null;
         } else if (Double.isInfinite(posLeft)) {
-            return new BoundingBox(new GeoPoint(top, negLeft), new GeoPoint(bottom, negRight));
+            return new GeoBoundingBox(new GeoPoint(top, negLeft), new GeoPoint(bottom, negRight));
         } else if (Double.isInfinite(negLeft)) {
-            return new BoundingBox(new GeoPoint(top, posLeft), new GeoPoint(bottom, posRight));
+            return new GeoBoundingBox(new GeoPoint(top, posLeft), new GeoPoint(bottom, posRight));
         } else if (wrapLongitude) {
             double unwrappedWidth = posRight - negLeft;
             double wrappedWidth = (180 - posLeft) - (-180 - negRight);
             if (unwrappedWidth <= wrappedWidth) {
-                return new BoundingBox(new GeoPoint(top, negLeft), new GeoPoint(bottom, posRight));
+                return new GeoBoundingBox(new GeoPoint(top, negLeft), new GeoPoint(bottom, posRight));
             } else {
-                return new BoundingBox(new GeoPoint(top, posLeft), new GeoPoint(bottom, negRight));
+                return new GeoBoundingBox(new GeoPoint(top, posLeft), new GeoPoint(bottom, negRight));
             }
         } else {
-            return new BoundingBox(new GeoPoint(top, negLeft), new GeoPoint(bottom, posRight));
+            return new GeoBoundingBox(new GeoPoint(top, negLeft), new GeoPoint(bottom, posRight));
         }
     }
 
     @Override
     public GeoPoint topLeft() {
-        BoundingBox boundingBox = resolveBoundingBox();
-        if (boundingBox == null) {
+        GeoBoundingBox geoBoundingBox = resolveGeoBoundingBox();
+        if (geoBoundingBox == null) {
             return null;
         } else {
-            return boundingBox.topLeft();
+            return geoBoundingBox.topLeft();
         }
     }
 
     @Override
     public GeoPoint bottomRight() {
-        BoundingBox boundingBox = resolveBoundingBox();
-        if (boundingBox == null) {
+        GeoBoundingBox geoBoundingBox = resolveGeoBoundingBox();
+        if (geoBoundingBox == null) {
             return null;
         } else {
-            return boundingBox.bottomRight();
+            return geoBoundingBox.bottomRight();
         }
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedGeoBounds.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedGeoBounds.java
index 11d36d2ceeead..2b29ae15119d9 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedGeoBounds.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedGeoBounds.java
@@ -20,6 +20,7 @@
 package org.elasticsearch.search.aggregations.metrics;
 
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.common.geo.GeoPoint;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.ObjectParser;
@@ -30,15 +31,14 @@
 import java.io.IOException;
 
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
-import static org.elasticsearch.search.aggregations.metrics.InternalGeoBounds.BOTTOM_RIGHT_FIELD;
-import static org.elasticsearch.search.aggregations.metrics.InternalGeoBounds.BOUNDS_FIELD;
-import static org.elasticsearch.search.aggregations.metrics.InternalGeoBounds.LAT_FIELD;
-import static org.elasticsearch.search.aggregations.metrics.InternalGeoBounds.LON_FIELD;
-import static org.elasticsearch.search.aggregations.metrics.InternalGeoBounds.TOP_LEFT_FIELD;
+import static org.elasticsearch.common.geo.GeoBoundingBox.BOTTOM_RIGHT_FIELD;
+import static org.elasticsearch.common.geo.GeoBoundingBox.BOUNDS_FIELD;
+import static org.elasticsearch.common.geo.GeoBoundingBox.LAT_FIELD;
+import static org.elasticsearch.common.geo.GeoBoundingBox.LON_FIELD;
+import static org.elasticsearch.common.geo.GeoBoundingBox.TOP_LEFT_FIELD;
 
 public class ParsedGeoBounds extends ParsedAggregation implements GeoBounds {
-    private GeoPoint topLeft;
-    private GeoPoint bottomRight;
+    private GeoBoundingBox geoBoundingBox;
 
     @Override
     public String getType() {
@@ -47,29 +47,20 @@ public String getType() {
 
     @Override
     public XContentBuilder doXContentBody(XContentBuilder builder, Params params) throws IOException {
-        if (topLeft != null) {
-            builder.startObject(BOUNDS_FIELD.getPreferredName());
-            builder.startObject(TOP_LEFT_FIELD.getPreferredName());
-            builder.field(LAT_FIELD.getPreferredName(), topLeft.getLat());
-            builder.field(LON_FIELD.getPreferredName(), topLeft.getLon());
-            builder.endObject();
-            builder.startObject(BOTTOM_RIGHT_FIELD.getPreferredName());
-            builder.field(LAT_FIELD.getPreferredName(), bottomRight.getLat());
-            builder.field(LON_FIELD.getPreferredName(), bottomRight.getLon());
-            builder.endObject();
-            builder.endObject();
+        if (geoBoundingBox != null) {
+            geoBoundingBox.toXContent(builder, params);
         }
         return builder;
     }
 
     @Override
     public GeoPoint topLeft() {
-        return topLeft;
+        return geoBoundingBox.topLeft();
     }
 
     @Override
     public GeoPoint bottomRight() {
-        return bottomRight;
+        return geoBoundingBox.bottomRight();
     }
 
     private static final ObjectParser<ParsedGeoBounds, Void> PARSER = new ObjectParser<>(ParsedGeoBounds.class.getSimpleName(), true,
@@ -85,8 +76,7 @@ public GeoPoint bottomRight() {
     static {
         declareAggregationFields(PARSER);
         PARSER.declareObject((agg, bbox) -> {
-            agg.topLeft = bbox.v1();
-            agg.bottomRight = bbox.v2();
+            agg.geoBoundingBox = new GeoBoundingBox(bbox.v1(), bbox.v2());
         }, BOUNDS_PARSER, BOUNDS_FIELD);
 
         BOUNDS_PARSER.declareObject(constructorArg(), GEO_POINT_PARSER, TOP_LEFT_FIELD);
diff --git a/server/src/test/java/org/elasticsearch/common/geo/GeoBoundingBoxTests.java b/server/src/test/java/org/elasticsearch/common/geo/GeoBoundingBoxTests.java
new file mode 100644
index 0000000000000..ef705fa27c42c
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/common/geo/GeoBoundingBoxTests.java
@@ -0,0 +1,149 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.common.geo;
+
+import org.elasticsearch.ElasticsearchParseException;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentFactory;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.geo.GeometryTestUtils;
+import org.elasticsearch.test.ESTestCase;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.hamcrest.Matchers.equalTo;
+
+
+/**
+ * Tests for {@link GeoBoundingBox}
+ */
+public class GeoBoundingBoxTests extends ESTestCase {
+
+    public void testInvalidParseInvalidWKT() throws IOException {
+        XContentBuilder bboxBuilder = XContentFactory.jsonBuilder()
+            .startObject()
+            .field("wkt", "invalid")
+            .endObject();
+        XContentParser parser = createParser(bboxBuilder);
+        parser.nextToken();
+        ElasticsearchParseException e = expectThrows(ElasticsearchParseException.class, () -> GeoBoundingBox.parseBoundingBox(parser));
+        assertThat(e.getMessage(), equalTo("failed to parse WKT bounding box"));
+    }
+
+    public void testInvalidParsePoint() throws IOException {
+        XContentBuilder bboxBuilder = XContentFactory.jsonBuilder()
+            .startObject()
+                .field("wkt", "POINT (100.0 100.0)")
+            .endObject();
+        XContentParser parser = createParser(bboxBuilder);
+        parser.nextToken();
+        ElasticsearchParseException e = expectThrows(ElasticsearchParseException.class, () -> GeoBoundingBox.parseBoundingBox(parser));
+        assertThat(e.getMessage(), equalTo("failed to parse WKT bounding box. [POINT] found. expected [ENVELOPE]"));
+    }
+
+    public void testWKT() throws IOException {
+        GeoBoundingBox geoBoundingBox = randomBBox();
+        assertBBox(geoBoundingBox,
+            XContentFactory.jsonBuilder()
+                .startObject()
+                .field("wkt", geoBoundingBox.toString())
+                .endObject()
+        );
+    }
+
+    public void testTopBottomLeftRight() throws Exception {
+        GeoBoundingBox geoBoundingBox = randomBBox();
+        assertBBox(geoBoundingBox,
+            XContentFactory.jsonBuilder()
+                .startObject()
+                .field("top", geoBoundingBox.top())
+                .field("bottom", geoBoundingBox.bottom())
+                .field("left", geoBoundingBox.left())
+                .field("right", geoBoundingBox.right())
+                .endObject()
+        );
+    }
+
+    public void testTopLeftBottomRight() throws Exception {
+        GeoBoundingBox geoBoundingBox = randomBBox();
+        assertBBox(geoBoundingBox,
+            XContentFactory.jsonBuilder()
+                .startObject()
+                .field("top_left", geoBoundingBox.topLeft())
+                .field("bottom_right", geoBoundingBox.bottomRight())
+                .endObject()
+        );
+    }
+
+    public void testTopRightBottomLeft() throws Exception {
+        GeoBoundingBox geoBoundingBox = randomBBox();
+        assertBBox(geoBoundingBox,
+            XContentFactory.jsonBuilder()
+                .startObject()
+                .field("top_right", new GeoPoint(geoBoundingBox.top(), geoBoundingBox.right()))
+                .field("bottom_left", new GeoPoint(geoBoundingBox.bottom(), geoBoundingBox.left()))
+                .endObject()
+        );
+    }
+
+    // test that no exception is thrown. BBOX parsing is not validated
+    public void testNullTopBottomLeftRight() throws Exception {
+        GeoBoundingBox geoBoundingBox = randomBBox();
+        XContentBuilder builder = XContentFactory.jsonBuilder().startObject();
+        for (String field : randomSubsetOf(List.of("top", "bottom", "left", "right"))) {
+            switch (field) {
+                case "top":
+                    builder.field("top", geoBoundingBox.top());
+                    break;
+                case "bottom":
+                    builder.field("bottom", geoBoundingBox.bottom());
+                    break;
+                case "left":
+                    builder.field("left", geoBoundingBox.left());
+                    break;
+                case "right":
+                    builder.field("right", geoBoundingBox.right());
+                    break;
+                default:
+                    throw new IllegalStateException("unexpected branching");
+            }
+        }
+        builder.endObject();
+        try (XContentParser parser = createParser(builder)) {
+            parser.nextToken();
+            GeoBoundingBox.parseBoundingBox(parser);
+        }
+    }
+
+    private void assertBBox(GeoBoundingBox expected, XContentBuilder builder) throws IOException {
+        try (XContentParser parser = createParser(builder)) {
+            parser.nextToken();
+            assertThat(GeoBoundingBox.parseBoundingBox(parser), equalTo(expected));
+        }
+    }
+
+    private GeoBoundingBox randomBBox() {
+        double topLat = GeometryTestUtils.randomLat();
+        double bottomLat = randomDoubleBetween(GeoUtils.MIN_LAT, topLat, true);
+        return new GeoBoundingBox(new GeoPoint(topLat, GeometryTestUtils.randomLon()),
+            new GeoPoint(bottomLat, GeometryTestUtils.randomLon()));
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxIT.java b/server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryIT.java
similarity index 99%
rename from server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxIT.java
rename to server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryIT.java
index 6e3f853e90eab..fe7800e137c9c 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryIT.java
@@ -39,7 +39,7 @@
 import static org.hamcrest.Matchers.anyOf;
 import static org.hamcrest.Matchers.equalTo;
 
-public class GeoBoundingBoxIT extends ESIntegTestCase {
+public class GeoBoundingBoxQueryIT extends ESIntegTestCase {
 
     @Override
     protected boolean forbidPrivateIndexSettings() {

From 3e4fc5db04dda62ebd08465ec8df74f1a7a39c51 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 23 Dec 2019 13:11:31 -0500
Subject: [PATCH 322/686] [DOCS] Percentile aggs are non-deterministic (#50468)

Percentile aggregations are non-deterministic. A percentile aggregation
can produce different results even when using the same data.

Based on [this discuss post][0], the non-deterministic property stems
from processes in Lucene that can affect the order in which docs are
provided to the aggregation.

This adds a warning stating that the aggregation is non-deterministic
and what that means.

[0]: https://discuss.elastic.co/t/different-results-for-same-query/111757
---
 .../aggregations/metrics/percentile-aggregation.asciidoc   | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/reference/aggregations/metrics/percentile-aggregation.asciidoc b/docs/reference/aggregations/metrics/percentile-aggregation.asciidoc
index 9d4476c779997..e5744fec768b0 100644
--- a/docs/reference/aggregations/metrics/percentile-aggregation.asciidoc
+++ b/docs/reference/aggregations/metrics/percentile-aggregation.asciidoc
@@ -251,6 +251,13 @@ for large number of values is that the law of large numbers makes the distributi
 values more and more uniform and the t-digest tree can do a better job at summarizing
 it. It would not be the case on more skewed distributions.
 
+[WARNING]
+====
+Percentile aggregations are also
+https://en.wikipedia.org/wiki/Nondeterministic_algorithm[non-deterministic].
+This means you can get slightly different results using the same data.
+====
+
 [[search-aggregations-metrics-percentile-aggregation-compression]]
 ==== Compression
 

From a5365f7098251a8852b87aaf45b561aebac28988 Mon Sep 17 00:00:00 2001
From: Orhan Toy <toyorhan@gmail.com>
Date: Mon, 23 Dec 2019 20:38:37 +0100
Subject: [PATCH 323/686] [DOCS] Fixes "enables you to" typos (#50225)

---
 docs/reference/docs/update.asciidoc                           | 2 +-
 .../ml/anomaly-detection/apis/validate-detector.asciidoc      | 2 +-
 .../reference/ml/anomaly-detection/apis/validate-job.asciidoc | 2 +-
 docs/reference/upgrade/reindex_upgrade.asciidoc               | 4 ++--
 x-pack/docs/en/watcher/input/chain.asciidoc                   | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/reference/docs/update.asciidoc b/docs/reference/docs/update.asciidoc
index 5394eb56c6a11..8d8e37be6a497 100644
--- a/docs/reference/docs/update.asciidoc
+++ b/docs/reference/docs/update.asciidoc
@@ -14,7 +14,7 @@ Updates a document using the specified script.
 [[update-api-desc]]
 ==== {api-description-title}
 
-Enables you script document updates. The script can update, delete, or skip
+Enables you to script document updates. The script can update, delete, or skip
 modifying the document. The update API also supports passing a partial document,
 which is merged into the existing document. To fully replace an existing
 document, use the <<docs-index_,`index` API>>.
diff --git a/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
index 41d7e1e479c1c..cb811f247a1c7 100644
--- a/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
@@ -23,7 +23,7 @@ Validates detector configuration information.
 [[ml-valid-detector-desc]]
 ==== {api-description-title}
 
-This API enables you validate the detector configuration
+This API enables you to validate the detector configuration
 before you create an {anomaly-job}.
 
 [[ml-valid-detector-request-body]]
diff --git a/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
index a741242922d20..750af88339c20 100644
--- a/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
@@ -23,7 +23,7 @@ Validates {anomaly-job} configuration information.
 [[ml-valid-job-desc]]
 ==== {api-description-title}
 
-This API enables you validate the {anomaly-job} configuration before you
+This API enables you to validate the {anomaly-job} configuration before you
 create the job.
 
 [[ml-valid-job-request-body]]
diff --git a/docs/reference/upgrade/reindex_upgrade.asciidoc b/docs/reference/upgrade/reindex_upgrade.asciidoc
index 7f576bd42700e..a9b1f60800706 100644
--- a/docs/reference/upgrade/reindex_upgrade.asciidoc
+++ b/docs/reference/upgrade/reindex_upgrade.asciidoc
@@ -102,8 +102,8 @@ endif::include-xpack[]
 === Reindex from a remote cluster
 
 You can use <<reindex-from-remote,reindex from remote>> to migrate indices from
-your old cluster to a new {version} cluster. This enables you move to {version}
-from a pre-6.8 cluster without interrupting service.
+your old cluster to a new {version} cluster. This enables you to move to
+{version} from a pre-6.8 cluster without interrupting service.
 
 [WARNING]
 =============================================
diff --git a/x-pack/docs/en/watcher/input/chain.asciidoc b/x-pack/docs/en/watcher/input/chain.asciidoc
index 7ff39d97d2906..69afe31046360 100644
--- a/x-pack/docs/en/watcher/input/chain.asciidoc
+++ b/x-pack/docs/en/watcher/input/chain.asciidoc
@@ -7,7 +7,7 @@ execution context when the watch is triggered. The inputs in a chain
 are processed in order and the data loaded by an input can be accessed by the
 subsequent inputs in the chain. 
 
-The `chain` input enables you perform actions based on data from multiple 
+The `chain` input enables you to perform actions based on data from multiple
 sources. You can also use the data collected by one input to load data
 from another source.
 

From 4f613b80a1e88c9de62b2ab2d6bc3fcfa9986b69 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Mon, 23 Dec 2019 14:46:47 -0500
Subject: [PATCH 324/686] Fix name for eclipse formatter in CONTRIBUTING
 (#50470)

The CONTRIBUTING.md file calls the Eclipse formatter
`elasticsearch.eclipseformat.xml` but it looks like we call it
`.eclipseformat.xml`.
---
 CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index dd3bbfb1bf5e0..d8948af2a430e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -218,7 +218,7 @@ Please follow these formatting guidelines:
 
 #### Editor / IDE Support
 
-Eclipse IDEs can import the file [elasticsearch.eclipseformat.xml]
+Eclipse IDEs can import the file [.eclipseformat.xml]
 directly.
 
 IntelliJ IDEs can

From 7c3c001e6dc97c98825ac9e151dd21a9c40e0b2d Mon Sep 17 00:00:00 2001
From: j-bean <anton.shuvaev91@gmail.com>
Date: Tue, 24 Dec 2019 12:49:21 +0300
Subject: [PATCH 325/686] Add remote info to the HLRC (#49657)

Relates to #47678
---
 .../elasticsearch/client/ClusterClient.java   |  31 ++++
 .../client/ClusterRequestConverters.java      |   5 +
 .../client/cluster/ProxyModeInfo.java         |  75 ++++++++++
 .../client/cluster/RemoteConnectionInfo.java  | 137 ++++++++++++++++++
 .../client/cluster/RemoteInfoRequest.java     |  28 ++++
 .../client/cluster/RemoteInfoResponse.java    |  59 ++++++++
 .../client/cluster/SniffModeInfo.java         |  76 ++++++++++
 .../java/org/elasticsearch/client/CCRIT.java  |  31 +---
 .../elasticsearch/client/ClusterClientIT.java |  45 ++++++
 .../client/ClusterRequestConvertersTests.java |  10 ++
 .../client/ESRestHighLevelClientTestCase.java |  37 +++++
 .../client/RestHighLevelClientTests.java      |  10 +-
 .../cluster/RemoteInfoResponseTests.java      | 111 ++++++++++++++
 .../documentation/CCRDocumentationIT.java     |  26 +---
 .../ClusterClientDocumentationIT.java         |  60 ++++++++
 .../documentation/ILMDocumentationIT.java     |   8 -
 .../high-level/cluster/remote_info.asciidoc   |  32 ++++
 .../high-level/supported-apis.asciidoc        |   2 +
 .../cluster/remote/RemoteInfoResponse.java    |   2 +-
 .../transport/ProxyConnectionStrategy.java    |  16 +-
 .../transport/RemoteConnectionInfo.java       |  14 +-
 .../transport/SniffConnectionStrategy.java    |  16 +-
 .../org/elasticsearch/test/ESTestCase.java    |  13 ++
 23 files changed, 770 insertions(+), 74 deletions(-)
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
 create mode 100644 docs/java-rest/high-level/cluster/remote_info.asciidoc

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
index 5e99975f51491..14fbf3e1f6d0f 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
@@ -26,6 +26,8 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsResponse;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
+import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.rest.RestStatus;
 
 import java.io.IOException;
@@ -138,4 +140,33 @@ public Cancellable healthAsync(ClusterHealthRequest healthRequest, RequestOption
         return restHighLevelClient.performRequestAsyncAndParseEntity(healthRequest, ClusterRequestConverters::clusterHealth, options,
                 ClusterHealthResponse::fromXContent, listener, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
     }
+
+    /**
+     * Get the remote cluster information using the Remote cluster info API.
+     * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-remote-info.html"> Remote cluster info
+     * API on elastic.co</a>
+     * @param request the request
+     * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
+     * @return the response
+     * @throws IOException in case there is a problem sending the request or parsing back the response
+     */
+    public RemoteInfoResponse remoteInfo(RemoteInfoRequest request, RequestOptions options) throws IOException {
+        return restHighLevelClient.performRequestAndParseEntity(request, ClusterRequestConverters::remoteInfo, options,
+                RemoteInfoResponse::fromXContent, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
+    }
+
+    /**
+     * Asynchronously get remote cluster information using the Remote cluster info API.
+     * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-remote-info.html"> Remote cluster info
+     * API on elastic.co</a>
+     * @param request the request
+     * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
+     * @param listener the listener to be notified upon request completion
+     * @return cancellable that may be used to cancel the request
+     */
+    public Cancellable remoteInfoAsync(RemoteInfoRequest request, RequestOptions options,
+                                       ActionListener<RemoteInfoResponse> listener) {
+        return restHighLevelClient.performRequestAsyncAndParseEntity(request, ClusterRequestConverters::remoteInfo, options,
+                RemoteInfoResponse::fromXContent, listener, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
+    }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
index a246402b505cc..74b2c3b7c6aae 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
@@ -25,6 +25,7 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
 import org.elasticsearch.common.Strings;
 
 import java.io.IOException;
@@ -76,4 +77,8 @@ static Request clusterHealth(ClusterHealthRequest healthRequest) {
         request.addParameters(params.asMap());
         return request;
     }
+
+    static Request remoteInfo(RemoteInfoRequest remoteInfoRequest) {
+        return new Request(HttpGet.METHOD_NAME, "/_remote/info");
+    }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
new file mode 100644
index 0000000000000..0fc4f240eb8ef
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
@@ -0,0 +1,75 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.cluster;
+
+import java.util.Objects;
+
+public class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
+    static final String NAME = "proxy";
+    static final String ADDRESS = "address";
+    static final String NUM_SOCKETS_CONNECTED = "num_sockets_connected";
+    static final String MAX_SOCKET_CONNECTIONS = "max_socket_connections";
+    private final String address;
+    private final int maxSocketConnections;
+    private final int numSocketsConnected;
+
+    ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
+        this.address = address;
+        this.maxSocketConnections = maxSocketConnections;
+        this.numSocketsConnected = numSocketsConnected;
+    }
+
+    @Override
+    public boolean isConnected() {
+        return numSocketsConnected > 0;
+    }
+
+    @Override
+    public String modeName() {
+        return NAME;
+    }
+
+    public String getAddress() {
+        return address;
+    }
+
+    public int getMaxSocketConnections() {
+        return maxSocketConnections;
+    }
+
+    public int getNumSocketsConnected() {
+        return numSocketsConnected;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        ProxyModeInfo otherProxy = (ProxyModeInfo) o;
+        return maxSocketConnections == otherProxy.maxSocketConnections &&
+                numSocketsConnected == otherProxy.numSocketsConnected &&
+                Objects.equals(address, otherProxy.address);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(address, maxSocketConnections, numSocketsConnected);
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
new file mode 100644
index 0000000000000..9f3efc0b4899e
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
@@ -0,0 +1,137 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.cluster;
+
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Objects;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
+
+/**
+ * This class encapsulates all remote cluster information to be rendered on
+ * {@code _remote/info} requests.
+ */
+public final class RemoteConnectionInfo {
+    private static final String CONNECTED = "connected";
+    private static final String MODE = "mode";
+    private static final String INITIAL_CONNECT_TIMEOUT = "initial_connect_timeout";
+    private static final String SKIP_UNAVAILABLE = "skip_unavailable";
+
+    @SuppressWarnings("unchecked")
+    private static final ConstructingObjectParser<RemoteConnectionInfo, String> PARSER = new ConstructingObjectParser<>(
+            "RemoteConnectionInfoObjectParser",
+            false,
+            (args, clusterAlias) -> {
+                String mode = (String) args[1];
+                ModeInfo modeInfo;
+                if (mode.equals(ProxyModeInfo.NAME)) {
+                    modeInfo = new ProxyModeInfo((String) args[4], (int) args[5], (int) args[6]);
+                } else if (mode.equals(SniffModeInfo.NAME)) {
+                    modeInfo = new SniffModeInfo((List<String>) args[7], (int) args[8], (int) args[9]);
+                } else {
+                    throw new IllegalArgumentException("mode cannot be " + mode);
+                }
+                return new RemoteConnectionInfo(clusterAlias,
+                        modeInfo,
+                        TimeValue.parseTimeValue((String) args[2], INITIAL_CONNECT_TIMEOUT),
+                        (boolean) args[3]);
+            });
+
+    static {
+        PARSER.declareBoolean(constructorArg(), new ParseField(CONNECTED));
+        PARSER.declareString(constructorArg(), new ParseField(MODE));
+        PARSER.declareString(constructorArg(), new ParseField(INITIAL_CONNECT_TIMEOUT));
+        PARSER.declareBoolean(constructorArg(), new ParseField(SKIP_UNAVAILABLE));
+
+        PARSER.declareString(optionalConstructorArg(), new ParseField(ProxyModeInfo.ADDRESS));
+        PARSER.declareInt(optionalConstructorArg(), new ParseField(ProxyModeInfo.MAX_SOCKET_CONNECTIONS));
+        PARSER.declareInt(optionalConstructorArg(), new ParseField(ProxyModeInfo.NUM_SOCKETS_CONNECTED));
+
+        PARSER.declareStringArray(optionalConstructorArg(), new ParseField(SniffModeInfo.SEEDS));
+        PARSER.declareInt(optionalConstructorArg(), new ParseField(SniffModeInfo.MAX_CONNECTIONS_PER_CLUSTER));
+        PARSER.declareInt(optionalConstructorArg(), new ParseField(SniffModeInfo.NUM_NODES_CONNECTED));
+    }
+
+    final ModeInfo modeInfo;
+    final TimeValue initialConnectionTimeout;
+    final String clusterAlias;
+    final boolean skipUnavailable;
+
+    RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
+        this.clusterAlias = clusterAlias;
+        this.modeInfo = modeInfo;
+        this.initialConnectionTimeout = initialConnectionTimeout;
+        this.skipUnavailable = skipUnavailable;
+    }
+
+    public boolean isConnected() {
+        return modeInfo.isConnected();
+    }
+
+    public String getClusterAlias() {
+        return clusterAlias;
+    }
+
+    public ModeInfo getModeInfo() {
+        return modeInfo;
+    }
+
+    public TimeValue getInitialConnectionTimeout() {
+        return initialConnectionTimeout;
+    }
+
+    public boolean isSkipUnavailable() {
+        return skipUnavailable;
+    }
+
+    public static RemoteConnectionInfo fromXContent(XContentParser parser, String clusterAlias) throws IOException {
+        return PARSER.parse(parser, clusterAlias);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        RemoteConnectionInfo that = (RemoteConnectionInfo) o;
+        return skipUnavailable == that.skipUnavailable &&
+                Objects.equals(modeInfo, that.modeInfo) &&
+                Objects.equals(initialConnectionTimeout, that.initialConnectionTimeout) &&
+                Objects.equals(clusterAlias, that.clusterAlias);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(modeInfo, initialConnectionTimeout, clusterAlias, skipUnavailable);
+    }
+
+    public interface ModeInfo {
+
+        boolean isConnected();
+
+        String modeName();
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
new file mode 100644
index 0000000000000..5ffc8afc073c6
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
@@ -0,0 +1,28 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.cluster;
+
+import org.elasticsearch.client.Validatable;
+
+/**
+ * The request object used by the Remote cluster info API.
+ */
+public final class RemoteInfoRequest implements Validatable {
+
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
new file mode 100644
index 0000000000000..cc453049667b1
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
@@ -0,0 +1,59 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.cluster;
+
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+
+import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
+
+/**
+ * A response to _remote/info API request.
+ */
+public final class RemoteInfoResponse {
+
+    private List<RemoteConnectionInfo> infos;
+
+    RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
+        this.infos = List.copyOf(infos);
+    }
+
+    public List<RemoteConnectionInfo> getInfos() {
+        return infos;
+    }
+
+    public static RemoteInfoResponse fromXContent(XContentParser parser) throws IOException {
+        ensureExpectedToken(XContentParser.Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation);
+
+        List<RemoteConnectionInfo> infos = new ArrayList<>();
+
+        XContentParser.Token token;
+        while ((token = parser.nextToken()) == XContentParser.Token.FIELD_NAME) {
+            String clusterAlias = parser.currentName();
+            RemoteConnectionInfo info = RemoteConnectionInfo.fromXContent(parser, clusterAlias);
+            infos.add(info);
+        }
+        ensureExpectedToken(XContentParser.Token.END_OBJECT, token, parser::getTokenLocation);
+        return new RemoteInfoResponse(infos);
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
new file mode 100644
index 0000000000000..b0e75979975ee
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
@@ -0,0 +1,76 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.cluster;
+
+import java.util.List;
+import java.util.Objects;
+
+public class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
+    public static final String NAME = "sniff";
+    static final String SEEDS = "seeds";
+    static final String NUM_NODES_CONNECTED = "num_nodes_connected";
+    static final String MAX_CONNECTIONS_PER_CLUSTER = "max_connections_per_cluster";
+    final List<String> seedNodes;
+    final int maxConnectionsPerCluster;
+    final int numNodesConnected;
+
+    SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
+        this.seedNodes = seedNodes;
+        this.maxConnectionsPerCluster = maxConnectionsPerCluster;
+        this.numNodesConnected = numNodesConnected;
+    }
+
+    @Override
+    public boolean isConnected() {
+        return numNodesConnected > 0;
+    }
+
+    @Override
+    public String modeName() {
+        return NAME;
+    }
+
+    public List<String> getSeedNodes() {
+        return seedNodes;
+    }
+
+    public int getMaxConnectionsPerCluster() {
+        return maxConnectionsPerCluster;
+    }
+
+    public int getNumNodesConnected() {
+        return numNodesConnected;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        SniffModeInfo sniff = (SniffModeInfo) o;
+        return maxConnectionsPerCluster == sniff.maxConnectionsPerCluster &&
+                numNodesConnected == sniff.numNodesConnected &&
+                Objects.equals(seedNodes, sniff.seedNodes);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(seedNodes, maxConnectionsPerCluster, numNodesConnected);
+    }
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
index 6be2efe98c48b..c6678102fe2b1 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
@@ -19,10 +19,7 @@
 
 package org.elasticsearch.client;
 
-import org.apache.http.util.EntityUtils;
 import org.apache.logging.log4j.message.ParameterizedMessage;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
@@ -51,9 +48,7 @@
 import org.elasticsearch.client.indices.CloseIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexResponse;
-import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.seqno.ReplicationTracker;
 import org.elasticsearch.test.rest.yaml.ObjectPath;
 import org.junit.Before;
@@ -74,27 +69,7 @@ public class CCRIT extends ESRestHighLevelClientTestCase {
 
     @Before
     public void setupRemoteClusterConfig() throws Exception {
-        // Configure local cluster as remote cluster:
-        // TODO: replace with nodes info highlevel rest client code when it is available:
-        final Request request = new Request("GET", "/_nodes");
-        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
-        // Select node info of first node (we don't know the node id):
-        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
-        String transportAddress = (String) nodesResponse.get("transport_address");
-
-        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
-        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local_cluster.seeds", transportAddress));
-        ClusterUpdateSettingsResponse updateSettingsResponse =
-            highLevelClient().cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
-        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
-
-        assertBusy(() -> {
-            Map<?, ?> localConnection = (Map<?, ?>) toMap(client()
-                .performRequest(new Request("GET", "/_remote/info")))
-                .get("local_cluster");
-            assertThat(localConnection, notNullValue());
-            assertThat(localConnection.get("connected"), is(true));
-        });
+        setupRemoteClusterConfig("local_cluster");
     }
 
     public void testIndexFollowing() throws Exception {
@@ -311,8 +286,4 @@ public void testAutoFollowing() throws Exception {
         assertThat(pauseFollowResponse.isAcknowledged(), is(true));
     }
 
-    private static Map<String, Object> toMap(Response response) throws IOException {
-        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
-    }
-
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
index e78e7ec7ca6d3..471a6dc697795 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
@@ -27,19 +27,27 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsResponse;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
+import org.elasticsearch.client.cluster.RemoteConnectionInfo;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
+import org.elasticsearch.client.cluster.RemoteInfoResponse;
+import org.elasticsearch.client.cluster.SniffModeInfo;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.health.ClusterIndexHealth;
 import org.elasticsearch.cluster.health.ClusterShardHealth;
 import org.elasticsearch.cluster.routing.allocation.decider.EnableAllocationDecider;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
 import org.elasticsearch.indices.recovery.RecoverySettings;
 import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.transport.RemoteClusterService;
+import org.elasticsearch.transport.SniffConnectionStrategy;
 
 import java.io.IOException;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 
 import static java.util.Collections.emptyMap;
@@ -297,4 +305,41 @@ public void testClusterHealthNotFoundIndex() throws IOException {
         assertNoIndices(response);
     }
 
+    public void testRemoteInfo() throws Exception {
+        String clusterAlias = "local_cluster";
+        setupRemoteClusterConfig(clusterAlias);
+
+        ClusterGetSettingsRequest settingsRequest = new ClusterGetSettingsRequest();
+        settingsRequest.includeDefaults(true);
+        ClusterGetSettingsResponse settingsResponse = highLevelClient().cluster().getSettings(settingsRequest, RequestOptions.DEFAULT);
+
+        List<String> seeds = SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS
+                .getConcreteSettingForNamespace(clusterAlias)
+                .get(settingsResponse.getTransientSettings());
+        int connectionsPerCluster = SniffConnectionStrategy.REMOTE_CONNECTIONS_PER_CLUSTER
+                .get(settingsResponse.getDefaultSettings());
+        TimeValue initialConnectionTimeout = RemoteClusterService.REMOTE_INITIAL_CONNECTION_TIMEOUT_SETTING
+                .get(settingsResponse.getDefaultSettings());
+        boolean skipUnavailable = RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE
+                .getConcreteSettingForNamespace(clusterAlias)
+                .get(settingsResponse.getDefaultSettings());
+
+        RemoteInfoRequest request = new RemoteInfoRequest();
+        RemoteInfoResponse response = execute(request, highLevelClient().cluster()::remoteInfo,
+                highLevelClient().cluster()::remoteInfoAsync);
+
+        assertThat(response, notNullValue());
+        assertThat(response.getInfos().size(), equalTo(1));
+        RemoteConnectionInfo info = response.getInfos().get(0);
+        assertThat(info.getClusterAlias(), equalTo(clusterAlias));
+        assertThat(info.getInitialConnectionTimeout(), equalTo(initialConnectionTimeout));
+        assertThat(info.isSkipUnavailable(), equalTo(skipUnavailable));
+        assertThat(info.getModeInfo().modeName(), equalTo(SniffModeInfo.NAME));
+        assertThat(info.getModeInfo().isConnected(), equalTo(true));
+        SniffModeInfo sniffModeInfo = (SniffModeInfo) info.getModeInfo();
+        assertThat(sniffModeInfo.getMaxConnectionsPerCluster(), equalTo(connectionsPerCluster));
+        assertThat(sniffModeInfo.getNumNodesConnected(), equalTo(1));
+        assertThat(sniffModeInfo.getSeedNodes(), equalTo(seeds));
+    }
+
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
index 9b7b5b0d284dc..59bf52a677321 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
 import org.elasticsearch.action.support.master.AcknowledgedRequest;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.test.ESTestCase;
@@ -37,6 +38,7 @@
 import java.util.Locale;
 import java.util.Map;
 
+import static java.util.Collections.emptyMap;
 import static org.hamcrest.CoreMatchers.equalTo;
 import static org.hamcrest.Matchers.nullValue;
 
@@ -147,4 +149,12 @@ public void testClusterHealth() {
         }
         Assert.assertThat(request.getParameters(), equalTo(expectedParams));
     }
+
+    public void testRemoteInfo() {
+        RemoteInfoRequest request = new RemoteInfoRequest();
+        Request expectedRequest = ClusterRequestConverters.remoteInfo(request);
+        assertEquals("/_remote/info", expectedRequest.getEndpoint());
+        assertEquals(HttpGet.METHOD_NAME, expectedRequest.getMethod());
+        assertEquals(emptyMap(), expectedRequest.getParameters());
+    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
index a9012fda042d9..174c98f3642df 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
@@ -19,19 +19,25 @@
 
 package org.elasticsearch.client;
 
+import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.ingest.PutPipelineRequest;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
+import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.common.Booleans;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.ingest.Pipeline;
 import org.elasticsearch.search.SearchHit;
@@ -45,10 +51,15 @@
 import java.util.Arrays;
 import java.util.Base64;
 import java.util.Collections;
+import java.util.Map;
 import java.util.Objects;
 import java.util.stream.Collectors;
 
+import static java.util.Collections.singletonMap;
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
+import static org.hamcrest.Matchers.greaterThan;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.notNullValue;
 
 public abstract class ESRestHighLevelClientTestCase extends ESRestTestCase {
 
@@ -243,4 +254,30 @@ protected void createIndexWithMultipleShards(String index) throws IOException {
         );
         highLevelClient().indices().create(indexRequest, RequestOptions.DEFAULT);
     }
+
+    protected static void setupRemoteClusterConfig(String remoteClusterName) throws Exception {
+        // Configure local cluster as remote cluster:
+        // TODO: replace with nodes info highlevel rest client code when it is available:
+        final Request request = new Request("GET", "/_nodes");
+        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
+        // Select node info of first node (we don't know the node id):
+        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
+        String transportAddress = (String) nodesResponse.get("transport_address");
+
+        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
+        updateSettingsRequest.transientSettings(singletonMap("cluster.remote." + remoteClusterName + ".seeds", transportAddress));
+        ClusterUpdateSettingsResponse updateSettingsResponse =
+                restHighLevelClient.cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
+        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
+
+        assertBusy(() -> {
+            RemoteInfoResponse response = highLevelClient().cluster().remoteInfo(new RemoteInfoRequest(), RequestOptions.DEFAULT);
+            assertThat(response, notNullValue());
+            assertThat(response.getInfos().size(), greaterThan(0));
+        });
+    }
+
+    protected static Map<String, Object> toMap(Response response) throws IOException {
+        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
+    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
index 4039ec251d335..b3457eedb5569 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
@@ -59,8 +59,8 @@
 import org.elasticsearch.client.ml.dataframe.OutlierDetection;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.Classification;
-import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetric;
+import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.RSquaredMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.Regression;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.AucRocMetric;
@@ -68,14 +68,14 @@
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.PrecisionMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.RecallMetric;
+import org.elasticsearch.client.ml.inference.preprocessing.FrequencyEncoding;
+import org.elasticsearch.client.ml.inference.preprocessing.OneHotEncoding;
+import org.elasticsearch.client.ml.inference.preprocessing.TargetMeanEncoding;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.Ensemble;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.LogisticRegression;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedMode;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedSum;
 import org.elasticsearch.client.ml.inference.trainedmodel.tree.Tree;
-import org.elasticsearch.client.ml.inference.preprocessing.FrequencyEncoding;
-import org.elasticsearch.client.ml.inference.preprocessing.OneHotEncoding;
-import org.elasticsearch.client.ml.inference.preprocessing.TargetMeanEncoding;
 import org.elasticsearch.client.transform.transforms.SyncConfig;
 import org.elasticsearch.client.transform.transforms.TimeSyncConfig;
 import org.elasticsearch.common.CheckedFunction;
@@ -106,7 +106,6 @@
 import org.elasticsearch.test.InternalAggregationTestCase;
 import org.elasticsearch.test.rest.yaml.restspec.ClientYamlSuiteRestApi;
 import org.elasticsearch.test.rest.yaml.restspec.ClientYamlSuiteRestSpec;
-
 import org.hamcrest.Matchers;
 import org.junit.Before;
 
@@ -773,7 +772,6 @@ public void testProvidedNamedXContents() {
     public void testApiNamingConventions() throws Exception {
         //this list should be empty once the high-level client is feature complete
         String[] notYetSupportedApi = new String[]{
-            "cluster.remote_info",
             "create",
             "get_script_context",
             "get_script_languages",
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
new file mode 100644
index 0000000000000..6280bc9e11470
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
@@ -0,0 +1,111 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.cluster;
+
+import org.elasticsearch.client.AbstractResponseTestCase;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.transport.ProxyConnectionStrategy;
+import org.elasticsearch.transport.RemoteConnectionInfo;
+import org.elasticsearch.transport.SniffConnectionStrategy;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+import static java.util.function.Function.identity;
+import static java.util.stream.Collectors.toMap;
+import static org.hamcrest.Matchers.equalTo;
+
+public class RemoteInfoResponseTests extends AbstractResponseTestCase<org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse,
+        RemoteInfoResponse> {
+
+    @Override
+    protected org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse createServerTestInstance(XContentType xContentType) {
+        int numRemoteInfos = randomIntBetween(0, 8);
+        List<RemoteConnectionInfo> remoteInfos = new ArrayList<>();
+        for (int i = 0; i < numRemoteInfos; i++) {
+            remoteInfos.add(createRandomRemoteConnectionInfo());
+        }
+        return new org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse(remoteInfos);
+    }
+
+    @Override
+    protected RemoteInfoResponse doParseToClientInstance(XContentParser parser) throws IOException {
+        return RemoteInfoResponse.fromXContent(parser);
+    }
+
+    @Override
+    protected void assertInstances(org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse serverTestInstance,
+                                   RemoteInfoResponse clientInstance) {
+        assertThat(clientInstance.getInfos().size(), equalTo(serverTestInstance.getInfos().size()));
+        Map<String, RemoteConnectionInfo> serverInfos = serverTestInstance.getInfos().stream()
+                .collect(toMap(RemoteConnectionInfo::getClusterAlias, identity()));
+        for (org.elasticsearch.client.cluster.RemoteConnectionInfo clientRemoteInfo : clientInstance.getInfos()) {
+            RemoteConnectionInfo serverRemoteInfo = serverInfos.get(clientRemoteInfo.getClusterAlias());
+            assertThat(clientRemoteInfo.getClusterAlias(), equalTo(serverRemoteInfo.getClusterAlias()));
+            assertThat(clientRemoteInfo.getInitialConnectionTimeout(), equalTo(serverRemoteInfo.getInitialConnectionTimeout()));
+            assertThat(clientRemoteInfo.isConnected(), equalTo(serverRemoteInfo.isConnected()));
+            assertThat(clientRemoteInfo.isSkipUnavailable(), equalTo(serverRemoteInfo.isSkipUnavailable()));
+            assertThat(clientRemoteInfo.getModeInfo().isConnected(), equalTo(serverRemoteInfo.getModeInfo().isConnected()));
+            assertThat(clientRemoteInfo.getModeInfo().modeName(), equalTo(serverRemoteInfo.getModeInfo().modeName()));
+            if (clientRemoteInfo.getModeInfo().modeName().equals(SniffModeInfo.NAME)) {
+                SniffModeInfo clientModeInfo =
+                        (SniffModeInfo) clientRemoteInfo.getModeInfo();
+                SniffConnectionStrategy.SniffModeInfo serverModeInfo =
+                        (SniffConnectionStrategy.SniffModeInfo) serverRemoteInfo.getModeInfo();
+                assertThat(clientModeInfo.getMaxConnectionsPerCluster(), equalTo(serverModeInfo.getMaxConnectionsPerCluster()));
+                assertThat(clientModeInfo.getNumNodesConnected(), equalTo(serverModeInfo.getNumNodesConnected()));
+                assertThat(clientModeInfo.getSeedNodes(), equalTo(serverModeInfo.getSeedNodes()));
+            } else if (clientRemoteInfo.getModeInfo().modeName().equals(ProxyModeInfo.NAME)) {
+                ProxyModeInfo clientModeInfo =
+                        (ProxyModeInfo) clientRemoteInfo.getModeInfo();
+                ProxyConnectionStrategy.ProxyModeInfo serverModeInfo =
+                        (ProxyConnectionStrategy.ProxyModeInfo) serverRemoteInfo.getModeInfo();
+                assertThat(clientModeInfo.getAddress(), equalTo(serverModeInfo.getAddress()));
+                assertThat(clientModeInfo.getMaxSocketConnections(), equalTo(serverModeInfo.getMaxSocketConnections()));
+                assertThat(clientModeInfo.getNumSocketsConnected(), equalTo(serverModeInfo.getNumSocketsConnected()));
+            } else {
+                fail("impossible case");
+            }
+        }
+    }
+
+    private static RemoteConnectionInfo createRandomRemoteConnectionInfo() {
+        RemoteConnectionInfo.ModeInfo modeInfo;
+        if (randomBoolean()) {
+            String address = randomAlphaOfLength(8);
+            int maxSocketConnections = randomInt(5);
+            int numSocketsConnected = randomInt(5);
+            modeInfo = new ProxyConnectionStrategy.ProxyModeInfo(address, maxSocketConnections, numSocketsConnected);
+        } else {
+            List<String> seedNodes = randomList(randomInt(8), () -> randomAlphaOfLength(8));
+            int maxConnectionsPerCluster = randomInt(5);
+            int numNodesConnected = randomInt(5);
+            modeInfo = new SniffConnectionStrategy.SniffModeInfo(seedNodes, maxConnectionsPerCluster, numNodesConnected);
+        }
+        String clusterAlias = randomAlphaOfLength(8);
+        TimeValue initialConnectionTimeout = TimeValue.parseTimeValue(randomTimeValue(), "randomInitialConnectionTimeout");
+        boolean skipUnavailable = randomBoolean();
+        return new RemoteConnectionInfo(clusterAlias, modeInfo, initialConnectionTimeout, skipUnavailable);
+    }
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
index 48f7adda8445c..5e7da8142129d 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
@@ -19,11 +19,8 @@
 
 package org.elasticsearch.client.documentation;
 
-import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.LatchedActionListener;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
@@ -57,8 +54,6 @@
 import org.elasticsearch.client.indices.CloseIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexResponse;
-import org.elasticsearch.common.xcontent.XContentHelper;
-import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.test.rest.yaml.ObjectPath;
 import org.junit.Before;
 
@@ -76,21 +71,8 @@
 public class CCRDocumentationIT extends ESRestHighLevelClientTestCase {
 
     @Before
-    public void setupRemoteClusterConfig() throws IOException {
-        RestHighLevelClient client = highLevelClient();
-        // Configure local cluster as remote cluster:
-        // TODO: replace with nodes info highlevel rest client code when it is available:
-        final Request request = new Request("GET", "/_nodes");
-        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
-        // Select node info of first node (we don't know the node id):
-        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
-        String transportAddress = (String) nodesResponse.get("transport_address");
-
-        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
-        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local.seeds", transportAddress));
-        ClusterUpdateSettingsResponse updateSettingsResponse =
-            client.cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
-        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
+    public void setupRemoteClusterConfig() throws Exception {
+        setupRemoteClusterConfig("local");
     }
 
     public void testPutFollow() throws Exception {
@@ -985,8 +967,4 @@ public void onFailure(Exception e) {
         }
     }
 
-    static Map<String, Object> toMap(Response response) throws IOException {
-        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
-    }
-
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
index 8b7f1577114b0..5cc7a4424fcaa 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
@@ -31,6 +31,9 @@
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
 import org.elasticsearch.client.RequestOptions;
 import org.elasticsearch.client.RestHighLevelClient;
+import org.elasticsearch.client.cluster.RemoteConnectionInfo;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
+import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.health.ClusterIndexHealth;
@@ -46,6 +49,7 @@
 
 import java.io.IOException;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
@@ -415,4 +419,60 @@ public void onFailure(Exception e) {
             assertTrue(latch.await(30L, TimeUnit.SECONDS));
         }
     }
+
+    public void testRemoteInfo() throws Exception {
+        setupRemoteClusterConfig("local_cluster");
+
+        RestHighLevelClient client = highLevelClient();
+
+        // tag::remote-info-request
+        RemoteInfoRequest request = new RemoteInfoRequest();
+        // end::remote-info-request
+
+        // tag::remote-info-execute
+        RemoteInfoResponse response = client.cluster().remoteInfo(request, RequestOptions.DEFAULT); // <1>
+        // end::remote-info-execute
+
+        // tag::remote-info-response
+        List<RemoteConnectionInfo> infos = response.getInfos();
+        // end::remote-info-response
+
+        assertThat(infos.size(), greaterThan(0));
+    }
+
+    public void testRemoteInfoAsync() throws Exception {
+        setupRemoteClusterConfig("local_cluster");
+
+        RestHighLevelClient client = highLevelClient();
+
+        // tag::remote-info-request
+        RemoteInfoRequest request = new RemoteInfoRequest();
+        // end::remote-info-request
+
+
+        // tag::remote-info-execute-listener
+            ActionListener<RemoteInfoResponse> listener =
+                new ActionListener<>() {
+                    @Override
+                    public void onResponse(RemoteInfoResponse response) {
+                        // <1>
+                    }
+
+                    @Override
+                    public void onFailure(Exception e) {
+                        // <2>
+                    }
+                };
+            // end::remote-info-execute-listener
+
+        // Replace the empty listener by a blocking listener in test
+        final CountDownLatch latch = new CountDownLatch(1);
+        listener = new LatchedActionListener<>(listener, latch);
+
+        // tag::health-execute-async
+            client.cluster().remoteInfoAsync(request, RequestOptions.DEFAULT, listener); // <1>
+        // end::health-execute-async
+
+        assertTrue(latch.await(30L, TimeUnit.SECONDS));
+    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
index a9852c405a49d..a458c3ec2551d 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
@@ -19,7 +19,6 @@
 
 package org.elasticsearch.client.documentation;
 
-import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.LatchedActionListener;
 import org.elasticsearch.action.admin.cluster.repositories.put.PutRepositoryRequest;
@@ -28,7 +27,6 @@
 import org.elasticsearch.action.admin.indices.alias.Alias;
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
 import org.elasticsearch.client.RequestOptions;
-import org.elasticsearch.client.Response;
 import org.elasticsearch.client.RestHighLevelClient;
 import org.elasticsearch.client.core.AcknowledgedResponse;
 import org.elasticsearch.client.ilm.DeleteAction;
@@ -78,8 +76,6 @@
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.common.xcontent.XContentHelper;
-import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.repositories.fs.FsRepository;
 import org.elasticsearch.snapshots.SnapshotInfo;
 import org.elasticsearch.snapshots.SnapshotState;
@@ -1210,8 +1206,4 @@ public void onFailure(Exception e) {
         assertTrue(latch.await(30L, TimeUnit.SECONDS));
     }
 
-    static Map<String, Object> toMap(Response response) throws IOException {
-        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
-    }
-
 }
diff --git a/docs/java-rest/high-level/cluster/remote_info.asciidoc b/docs/java-rest/high-level/cluster/remote_info.asciidoc
new file mode 100644
index 0000000000000..6496a04a3a76c
--- /dev/null
+++ b/docs/java-rest/high-level/cluster/remote_info.asciidoc
@@ -0,0 +1,32 @@
+--
+:api: remote-info
+:request: RemoteInfoRequest
+:response: RemoteInfoResponse
+--
+
+[id="{upid}-{api}"]
+=== Remote Cluster Info API
+
+The Remote cluster info API allows to get all of the configured remote cluster information.
+
+[id="{upid}-{api}-request"]
+==== Remote Cluster Info Request
+
+A +{request}+:
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-request]
+--------------------------------------------------
+
+There are no required parameters.
+
+==== Remote Cluster Info Response
+
+The returned +{response}+ allows to retrieve remote cluster information.
+It returns connection and endpoint information keyed by the configured remote cluster alias.
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-response]
+--------------------------------------------------
diff --git a/docs/java-rest/high-level/supported-apis.asciidoc b/docs/java-rest/high-level/supported-apis.asciidoc
index 2191e795ebbb1..e0d228b5d1e4b 100644
--- a/docs/java-rest/high-level/supported-apis.asciidoc
+++ b/docs/java-rest/high-level/supported-apis.asciidoc
@@ -168,12 +168,14 @@ The Java High Level REST Client supports the following Cluster APIs:
 * <<java-rest-high-cluster-put-settings>>
 * <<java-rest-high-cluster-get-settings>>
 * <<java-rest-high-cluster-health>>
+* <<java-rest-high-cluster-remote-info>>
 
 :upid: {mainid}-cluster
 :doc-tests-file: {doc-tests}/ClusterClientDocumentationIT.java
 include::cluster/put_settings.asciidoc[]
 include::cluster/get_settings.asciidoc[]
 include::cluster/health.asciidoc[]
+include::cluster/remote_info.asciidoc[]
 
 == Ingest APIs
 The Java High Level REST Client supports the following Ingest APIs:
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
index 894cd9cf9fec4..9d72da7746974 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
@@ -39,7 +39,7 @@ public final class RemoteInfoResponse extends ActionResponse implements ToXConte
         infos = in.readList(RemoteConnectionInfo::new);
     }
 
-    RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
+    public RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
         this.infos = List.copyOf(infos);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
index 78c9f5f28154d..14ca217ade1b8 100644
--- a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
@@ -268,13 +268,13 @@ private static TransportAddress resolveAddress(String address) {
         return new TransportAddress(parseConfiguredAddress(address));
     }
 
-    static class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
+    public static class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
 
         private final String address;
         private final int maxSocketConnections;
         private final int numSocketsConnected;
 
-        ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
+        public ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
             this.address = address;
             this.maxSocketConnections = maxSocketConnections;
             this.numSocketsConnected = numSocketsConnected;
@@ -311,6 +311,18 @@ public String modeName() {
             return "proxy";
         }
 
+        public String getAddress() {
+            return address;
+        }
+
+        public int getMaxSocketConnections() {
+            return maxSocketConnections;
+        }
+
+        public int getNumSocketsConnected() {
+            return numSocketsConnected;
+        }
+
         @Override
         public RemoteConnectionStrategy.ConnectionStrategy modeType() {
             return RemoteConnectionStrategy.ConnectionStrategy.PROXY;
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
index e721a0b617fd1..152cafccb61e0 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
@@ -43,7 +43,7 @@ public final class RemoteConnectionInfo implements ToXContentFragment, Writeable
     final String clusterAlias;
     final boolean skipUnavailable;
 
-    RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
+    public RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
         this.clusterAlias = clusterAlias;
         this.modeInfo = modeInfo;
         this.initialConnectionTimeout = initialConnectionTimeout;
@@ -77,6 +77,18 @@ public String getClusterAlias() {
         return clusterAlias;
     }
 
+    public ModeInfo getModeInfo() {
+        return modeInfo;
+    }
+
+    public TimeValue getInitialConnectionTimeout() {
+        return initialConnectionTimeout;
+    }
+
+    public boolean isSkipUnavailable() {
+        return skipUnavailable;
+    }
+
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         // TODO: Change to 7.6 after backport
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index 97b5e318841d6..fcc4bde951dd0 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -465,13 +465,13 @@ private boolean proxyChanged(String oldProxy, String newProxy) {
         return Objects.equals(oldProxy, newProxy) == false;
     }
 
-    static class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
+    public static class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
 
         final List<String> seedNodes;
         final int maxConnectionsPerCluster;
         final int numNodesConnected;
 
-        SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
+        public SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
             this.seedNodes = seedNodes;
             this.maxConnectionsPerCluster = maxConnectionsPerCluster;
             this.numNodesConnected = numNodesConnected;
@@ -512,6 +512,18 @@ public String modeName() {
             return "sniff";
         }
 
+        public List<String> getSeedNodes() {
+            return seedNodes;
+        }
+
+        public int getMaxConnectionsPerCluster() {
+            return maxConnectionsPerCluster;
+        }
+
+        public int getNumNodesConnected() {
+            return numNodesConnected;
+        }
+
         @Override
         public RemoteConnectionStrategy.ConnectionStrategy modeType() {
             return RemoteConnectionStrategy.ConnectionStrategy.SNIFF;
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
index 4d1848e5b3a98..e4c9eb0986b34 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
@@ -755,6 +755,19 @@ public static <T> T[] randomArray(int minArraySize, int maxArraySize, IntFunctio
         return array;
     }
 
+    public static <T> List<T> randomList(int maxListSize, Supplier<T> valueConstructor) {
+        return randomList(0, maxListSize, valueConstructor);
+    }
+
+    public static <T> List<T> randomList(int minListSize, int maxListSize, Supplier<T> valueConstructor) {
+        final int size = randomIntBetween(minListSize, maxListSize);
+        List<T> list = new ArrayList<>();
+        for (int i = 0; i < size; i++) {
+            list.add(valueConstructor.get());
+        }
+        return list;
+    }
+
 
     private static final String[] TIME_SUFFIXES = new String[]{"d", "h", "ms", "s", "m", "micros", "nanos"};
 

From 9e287a8c673a0121d9e29233c2ab3526783174db Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Tue, 24 Dec 2019 11:26:10 +0100
Subject: [PATCH 326/686] serialize initial_connect_timeout as xcontent
 correctly

---
 .../java/org/elasticsearch/transport/RemoteConnectionInfo.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
index 152cafccb61e0..ef7c76113269f 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
@@ -121,7 +121,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             builder.field("connected", modeInfo.isConnected());
             builder.field("mode", modeInfo.modeName());
             modeInfo.toXContent(builder, params);
-            builder.field("initial_connect_timeout", initialConnectionTimeout);
+            builder.field("initial_connect_timeout", initialConnectionTimeout.getStringRep());
             builder.field("skip_unavailable", skipUnavailable);
         }
         builder.endObject();

From c5ff357a59ddbb10d6e2495cde0c3ad7daa43079 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Tue, 24 Dec 2019 11:39:22 +0100
Subject: [PATCH 327/686] Revert "serialize initial_connect_timeout as xcontent
 correctly"

This reverts commit ae64eaabdae001f91013c703ebe72d9acfc0cd13.
---
 .../java/org/elasticsearch/transport/RemoteConnectionInfo.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
index ef7c76113269f..152cafccb61e0 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
@@ -121,7 +121,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             builder.field("connected", modeInfo.isConnected());
             builder.field("mode", modeInfo.modeName());
             modeInfo.toXContent(builder, params);
-            builder.field("initial_connect_timeout", initialConnectionTimeout.getStringRep());
+            builder.field("initial_connect_timeout", initialConnectionTimeout);
             builder.field("skip_unavailable", skipUnavailable);
         }
         builder.endObject();

From d911f1834a45cb1dca5cc45d8599f27d8e582df9 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Tue, 24 Dec 2019 11:40:44 +0100
Subject: [PATCH 328/686] Revert "Add remote info to the HLRC (#49657)"

This reverts commit fa1a7c57b8e6fc6ecfc77a3811d4746087049b7e.
---
 .../elasticsearch/client/ClusterClient.java   |  31 ----
 .../client/ClusterRequestConverters.java      |   5 -
 .../client/cluster/ProxyModeInfo.java         |  75 ----------
 .../client/cluster/RemoteConnectionInfo.java  | 137 ------------------
 .../client/cluster/RemoteInfoRequest.java     |  28 ----
 .../client/cluster/RemoteInfoResponse.java    |  59 --------
 .../client/cluster/SniffModeInfo.java         |  76 ----------
 .../java/org/elasticsearch/client/CCRIT.java  |  31 +++-
 .../elasticsearch/client/ClusterClientIT.java |  45 ------
 .../client/ClusterRequestConvertersTests.java |  10 --
 .../client/ESRestHighLevelClientTestCase.java |  37 -----
 .../client/RestHighLevelClientTests.java      |  10 +-
 .../cluster/RemoteInfoResponseTests.java      | 111 --------------
 .../documentation/CCRDocumentationIT.java     |  26 +++-
 .../ClusterClientDocumentationIT.java         |  60 --------
 .../documentation/ILMDocumentationIT.java     |   8 +
 .../high-level/cluster/remote_info.asciidoc   |  32 ----
 .../high-level/supported-apis.asciidoc        |   2 -
 .../cluster/remote/RemoteInfoResponse.java    |   2 +-
 .../transport/ProxyConnectionStrategy.java    |  16 +-
 .../transport/RemoteConnectionInfo.java       |  14 +-
 .../transport/SniffConnectionStrategy.java    |  16 +-
 .../org/elasticsearch/test/ESTestCase.java    |  13 --
 23 files changed, 74 insertions(+), 770 deletions(-)
 delete mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
 delete mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
 delete mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
 delete mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
 delete mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
 delete mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
 delete mode 100644 docs/java-rest/high-level/cluster/remote_info.asciidoc

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
index 14fbf3e1f6d0f..5e99975f51491 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
@@ -26,8 +26,6 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsResponse;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
-import org.elasticsearch.client.cluster.RemoteInfoRequest;
-import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.rest.RestStatus;
 
 import java.io.IOException;
@@ -140,33 +138,4 @@ public Cancellable healthAsync(ClusterHealthRequest healthRequest, RequestOption
         return restHighLevelClient.performRequestAsyncAndParseEntity(healthRequest, ClusterRequestConverters::clusterHealth, options,
                 ClusterHealthResponse::fromXContent, listener, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
     }
-
-    /**
-     * Get the remote cluster information using the Remote cluster info API.
-     * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-remote-info.html"> Remote cluster info
-     * API on elastic.co</a>
-     * @param request the request
-     * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
-     * @return the response
-     * @throws IOException in case there is a problem sending the request or parsing back the response
-     */
-    public RemoteInfoResponse remoteInfo(RemoteInfoRequest request, RequestOptions options) throws IOException {
-        return restHighLevelClient.performRequestAndParseEntity(request, ClusterRequestConverters::remoteInfo, options,
-                RemoteInfoResponse::fromXContent, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
-    }
-
-    /**
-     * Asynchronously get remote cluster information using the Remote cluster info API.
-     * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-remote-info.html"> Remote cluster info
-     * API on elastic.co</a>
-     * @param request the request
-     * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
-     * @param listener the listener to be notified upon request completion
-     * @return cancellable that may be used to cancel the request
-     */
-    public Cancellable remoteInfoAsync(RemoteInfoRequest request, RequestOptions options,
-                                       ActionListener<RemoteInfoResponse> listener) {
-        return restHighLevelClient.performRequestAsyncAndParseEntity(request, ClusterRequestConverters::remoteInfo, options,
-                RemoteInfoResponse::fromXContent, listener, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
-    }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
index 74b2c3b7c6aae..a246402b505cc 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
@@ -25,7 +25,6 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
-import org.elasticsearch.client.cluster.RemoteInfoRequest;
 import org.elasticsearch.common.Strings;
 
 import java.io.IOException;
@@ -77,8 +76,4 @@ static Request clusterHealth(ClusterHealthRequest healthRequest) {
         request.addParameters(params.asMap());
         return request;
     }
-
-    static Request remoteInfo(RemoteInfoRequest remoteInfoRequest) {
-        return new Request(HttpGet.METHOD_NAME, "/_remote/info");
-    }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
deleted file mode 100644
index 0fc4f240eb8ef..0000000000000
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
+++ /dev/null
@@ -1,75 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.client.cluster;
-
-import java.util.Objects;
-
-public class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
-    static final String NAME = "proxy";
-    static final String ADDRESS = "address";
-    static final String NUM_SOCKETS_CONNECTED = "num_sockets_connected";
-    static final String MAX_SOCKET_CONNECTIONS = "max_socket_connections";
-    private final String address;
-    private final int maxSocketConnections;
-    private final int numSocketsConnected;
-
-    ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
-        this.address = address;
-        this.maxSocketConnections = maxSocketConnections;
-        this.numSocketsConnected = numSocketsConnected;
-    }
-
-    @Override
-    public boolean isConnected() {
-        return numSocketsConnected > 0;
-    }
-
-    @Override
-    public String modeName() {
-        return NAME;
-    }
-
-    public String getAddress() {
-        return address;
-    }
-
-    public int getMaxSocketConnections() {
-        return maxSocketConnections;
-    }
-
-    public int getNumSocketsConnected() {
-        return numSocketsConnected;
-    }
-
-    @Override
-    public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
-        ProxyModeInfo otherProxy = (ProxyModeInfo) o;
-        return maxSocketConnections == otherProxy.maxSocketConnections &&
-                numSocketsConnected == otherProxy.numSocketsConnected &&
-                Objects.equals(address, otherProxy.address);
-    }
-
-    @Override
-    public int hashCode() {
-        return Objects.hash(address, maxSocketConnections, numSocketsConnected);
-    }
-}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
deleted file mode 100644
index 9f3efc0b4899e..0000000000000
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
+++ /dev/null
@@ -1,137 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.client.cluster;
-
-import org.elasticsearch.common.ParseField;
-import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.common.xcontent.ConstructingObjectParser;
-import org.elasticsearch.common.xcontent.XContentParser;
-
-import java.io.IOException;
-import java.util.List;
-import java.util.Objects;
-
-import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
-import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
-
-/**
- * This class encapsulates all remote cluster information to be rendered on
- * {@code _remote/info} requests.
- */
-public final class RemoteConnectionInfo {
-    private static final String CONNECTED = "connected";
-    private static final String MODE = "mode";
-    private static final String INITIAL_CONNECT_TIMEOUT = "initial_connect_timeout";
-    private static final String SKIP_UNAVAILABLE = "skip_unavailable";
-
-    @SuppressWarnings("unchecked")
-    private static final ConstructingObjectParser<RemoteConnectionInfo, String> PARSER = new ConstructingObjectParser<>(
-            "RemoteConnectionInfoObjectParser",
-            false,
-            (args, clusterAlias) -> {
-                String mode = (String) args[1];
-                ModeInfo modeInfo;
-                if (mode.equals(ProxyModeInfo.NAME)) {
-                    modeInfo = new ProxyModeInfo((String) args[4], (int) args[5], (int) args[6]);
-                } else if (mode.equals(SniffModeInfo.NAME)) {
-                    modeInfo = new SniffModeInfo((List<String>) args[7], (int) args[8], (int) args[9]);
-                } else {
-                    throw new IllegalArgumentException("mode cannot be " + mode);
-                }
-                return new RemoteConnectionInfo(clusterAlias,
-                        modeInfo,
-                        TimeValue.parseTimeValue((String) args[2], INITIAL_CONNECT_TIMEOUT),
-                        (boolean) args[3]);
-            });
-
-    static {
-        PARSER.declareBoolean(constructorArg(), new ParseField(CONNECTED));
-        PARSER.declareString(constructorArg(), new ParseField(MODE));
-        PARSER.declareString(constructorArg(), new ParseField(INITIAL_CONNECT_TIMEOUT));
-        PARSER.declareBoolean(constructorArg(), new ParseField(SKIP_UNAVAILABLE));
-
-        PARSER.declareString(optionalConstructorArg(), new ParseField(ProxyModeInfo.ADDRESS));
-        PARSER.declareInt(optionalConstructorArg(), new ParseField(ProxyModeInfo.MAX_SOCKET_CONNECTIONS));
-        PARSER.declareInt(optionalConstructorArg(), new ParseField(ProxyModeInfo.NUM_SOCKETS_CONNECTED));
-
-        PARSER.declareStringArray(optionalConstructorArg(), new ParseField(SniffModeInfo.SEEDS));
-        PARSER.declareInt(optionalConstructorArg(), new ParseField(SniffModeInfo.MAX_CONNECTIONS_PER_CLUSTER));
-        PARSER.declareInt(optionalConstructorArg(), new ParseField(SniffModeInfo.NUM_NODES_CONNECTED));
-    }
-
-    final ModeInfo modeInfo;
-    final TimeValue initialConnectionTimeout;
-    final String clusterAlias;
-    final boolean skipUnavailable;
-
-    RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
-        this.clusterAlias = clusterAlias;
-        this.modeInfo = modeInfo;
-        this.initialConnectionTimeout = initialConnectionTimeout;
-        this.skipUnavailable = skipUnavailable;
-    }
-
-    public boolean isConnected() {
-        return modeInfo.isConnected();
-    }
-
-    public String getClusterAlias() {
-        return clusterAlias;
-    }
-
-    public ModeInfo getModeInfo() {
-        return modeInfo;
-    }
-
-    public TimeValue getInitialConnectionTimeout() {
-        return initialConnectionTimeout;
-    }
-
-    public boolean isSkipUnavailable() {
-        return skipUnavailable;
-    }
-
-    public static RemoteConnectionInfo fromXContent(XContentParser parser, String clusterAlias) throws IOException {
-        return PARSER.parse(parser, clusterAlias);
-    }
-
-    @Override
-    public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
-        RemoteConnectionInfo that = (RemoteConnectionInfo) o;
-        return skipUnavailable == that.skipUnavailable &&
-                Objects.equals(modeInfo, that.modeInfo) &&
-                Objects.equals(initialConnectionTimeout, that.initialConnectionTimeout) &&
-                Objects.equals(clusterAlias, that.clusterAlias);
-    }
-
-    @Override
-    public int hashCode() {
-        return Objects.hash(modeInfo, initialConnectionTimeout, clusterAlias, skipUnavailable);
-    }
-
-    public interface ModeInfo {
-
-        boolean isConnected();
-
-        String modeName();
-    }
-}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
deleted file mode 100644
index 5ffc8afc073c6..0000000000000
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
+++ /dev/null
@@ -1,28 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.client.cluster;
-
-import org.elasticsearch.client.Validatable;
-
-/**
- * The request object used by the Remote cluster info API.
- */
-public final class RemoteInfoRequest implements Validatable {
-
-}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
deleted file mode 100644
index cc453049667b1..0000000000000
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
+++ /dev/null
@@ -1,59 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.client.cluster;
-
-import org.elasticsearch.common.xcontent.XContentParser;
-
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.List;
-
-import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
-
-/**
- * A response to _remote/info API request.
- */
-public final class RemoteInfoResponse {
-
-    private List<RemoteConnectionInfo> infos;
-
-    RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
-        this.infos = List.copyOf(infos);
-    }
-
-    public List<RemoteConnectionInfo> getInfos() {
-        return infos;
-    }
-
-    public static RemoteInfoResponse fromXContent(XContentParser parser) throws IOException {
-        ensureExpectedToken(XContentParser.Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation);
-
-        List<RemoteConnectionInfo> infos = new ArrayList<>();
-
-        XContentParser.Token token;
-        while ((token = parser.nextToken()) == XContentParser.Token.FIELD_NAME) {
-            String clusterAlias = parser.currentName();
-            RemoteConnectionInfo info = RemoteConnectionInfo.fromXContent(parser, clusterAlias);
-            infos.add(info);
-        }
-        ensureExpectedToken(XContentParser.Token.END_OBJECT, token, parser::getTokenLocation);
-        return new RemoteInfoResponse(infos);
-    }
-}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
deleted file mode 100644
index b0e75979975ee..0000000000000
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
+++ /dev/null
@@ -1,76 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.client.cluster;
-
-import java.util.List;
-import java.util.Objects;
-
-public class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
-    public static final String NAME = "sniff";
-    static final String SEEDS = "seeds";
-    static final String NUM_NODES_CONNECTED = "num_nodes_connected";
-    static final String MAX_CONNECTIONS_PER_CLUSTER = "max_connections_per_cluster";
-    final List<String> seedNodes;
-    final int maxConnectionsPerCluster;
-    final int numNodesConnected;
-
-    SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
-        this.seedNodes = seedNodes;
-        this.maxConnectionsPerCluster = maxConnectionsPerCluster;
-        this.numNodesConnected = numNodesConnected;
-    }
-
-    @Override
-    public boolean isConnected() {
-        return numNodesConnected > 0;
-    }
-
-    @Override
-    public String modeName() {
-        return NAME;
-    }
-
-    public List<String> getSeedNodes() {
-        return seedNodes;
-    }
-
-    public int getMaxConnectionsPerCluster() {
-        return maxConnectionsPerCluster;
-    }
-
-    public int getNumNodesConnected() {
-        return numNodesConnected;
-    }
-
-    @Override
-    public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
-        SniffModeInfo sniff = (SniffModeInfo) o;
-        return maxConnectionsPerCluster == sniff.maxConnectionsPerCluster &&
-                numNodesConnected == sniff.numNodesConnected &&
-                Objects.equals(seedNodes, sniff.seedNodes);
-    }
-
-    @Override
-    public int hashCode() {
-        return Objects.hash(seedNodes, maxConnectionsPerCluster, numNodesConnected);
-    }
-}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
index c6678102fe2b1..6be2efe98c48b 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
@@ -19,7 +19,10 @@
 
 package org.elasticsearch.client;
 
+import org.apache.http.util.EntityUtils;
 import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
@@ -48,7 +51,9 @@
 import org.elasticsearch.client.indices.CloseIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexResponse;
+import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.seqno.ReplicationTracker;
 import org.elasticsearch.test.rest.yaml.ObjectPath;
 import org.junit.Before;
@@ -69,7 +74,27 @@ public class CCRIT extends ESRestHighLevelClientTestCase {
 
     @Before
     public void setupRemoteClusterConfig() throws Exception {
-        setupRemoteClusterConfig("local_cluster");
+        // Configure local cluster as remote cluster:
+        // TODO: replace with nodes info highlevel rest client code when it is available:
+        final Request request = new Request("GET", "/_nodes");
+        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
+        // Select node info of first node (we don't know the node id):
+        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
+        String transportAddress = (String) nodesResponse.get("transport_address");
+
+        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
+        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local_cluster.seeds", transportAddress));
+        ClusterUpdateSettingsResponse updateSettingsResponse =
+            highLevelClient().cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
+        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
+
+        assertBusy(() -> {
+            Map<?, ?> localConnection = (Map<?, ?>) toMap(client()
+                .performRequest(new Request("GET", "/_remote/info")))
+                .get("local_cluster");
+            assertThat(localConnection, notNullValue());
+            assertThat(localConnection.get("connected"), is(true));
+        });
     }
 
     public void testIndexFollowing() throws Exception {
@@ -286,4 +311,8 @@ public void testAutoFollowing() throws Exception {
         assertThat(pauseFollowResponse.isAcknowledged(), is(true));
     }
 
+    private static Map<String, Object> toMap(Response response) throws IOException {
+        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
+    }
+
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
index 471a6dc697795..e78e7ec7ca6d3 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
@@ -27,27 +27,19 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsResponse;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
-import org.elasticsearch.client.cluster.RemoteConnectionInfo;
-import org.elasticsearch.client.cluster.RemoteInfoRequest;
-import org.elasticsearch.client.cluster.RemoteInfoResponse;
-import org.elasticsearch.client.cluster.SniffModeInfo;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.health.ClusterIndexHealth;
 import org.elasticsearch.cluster.health.ClusterShardHealth;
 import org.elasticsearch.cluster.routing.allocation.decider.EnableAllocationDecider;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
-import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
 import org.elasticsearch.indices.recovery.RecoverySettings;
 import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.transport.RemoteClusterService;
-import org.elasticsearch.transport.SniffConnectionStrategy;
 
 import java.io.IOException;
 import java.util.HashMap;
-import java.util.List;
 import java.util.Map;
 
 import static java.util.Collections.emptyMap;
@@ -305,41 +297,4 @@ public void testClusterHealthNotFoundIndex() throws IOException {
         assertNoIndices(response);
     }
 
-    public void testRemoteInfo() throws Exception {
-        String clusterAlias = "local_cluster";
-        setupRemoteClusterConfig(clusterAlias);
-
-        ClusterGetSettingsRequest settingsRequest = new ClusterGetSettingsRequest();
-        settingsRequest.includeDefaults(true);
-        ClusterGetSettingsResponse settingsResponse = highLevelClient().cluster().getSettings(settingsRequest, RequestOptions.DEFAULT);
-
-        List<String> seeds = SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS
-                .getConcreteSettingForNamespace(clusterAlias)
-                .get(settingsResponse.getTransientSettings());
-        int connectionsPerCluster = SniffConnectionStrategy.REMOTE_CONNECTIONS_PER_CLUSTER
-                .get(settingsResponse.getDefaultSettings());
-        TimeValue initialConnectionTimeout = RemoteClusterService.REMOTE_INITIAL_CONNECTION_TIMEOUT_SETTING
-                .get(settingsResponse.getDefaultSettings());
-        boolean skipUnavailable = RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE
-                .getConcreteSettingForNamespace(clusterAlias)
-                .get(settingsResponse.getDefaultSettings());
-
-        RemoteInfoRequest request = new RemoteInfoRequest();
-        RemoteInfoResponse response = execute(request, highLevelClient().cluster()::remoteInfo,
-                highLevelClient().cluster()::remoteInfoAsync);
-
-        assertThat(response, notNullValue());
-        assertThat(response.getInfos().size(), equalTo(1));
-        RemoteConnectionInfo info = response.getInfos().get(0);
-        assertThat(info.getClusterAlias(), equalTo(clusterAlias));
-        assertThat(info.getInitialConnectionTimeout(), equalTo(initialConnectionTimeout));
-        assertThat(info.isSkipUnavailable(), equalTo(skipUnavailable));
-        assertThat(info.getModeInfo().modeName(), equalTo(SniffModeInfo.NAME));
-        assertThat(info.getModeInfo().isConnected(), equalTo(true));
-        SniffModeInfo sniffModeInfo = (SniffModeInfo) info.getModeInfo();
-        assertThat(sniffModeInfo.getMaxConnectionsPerCluster(), equalTo(connectionsPerCluster));
-        assertThat(sniffModeInfo.getNumNodesConnected(), equalTo(1));
-        assertThat(sniffModeInfo.getSeedNodes(), equalTo(seeds));
-    }
-
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
index 59bf52a677321..9b7b5b0d284dc 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
 import org.elasticsearch.action.support.master.AcknowledgedRequest;
-import org.elasticsearch.client.cluster.RemoteInfoRequest;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.test.ESTestCase;
@@ -38,7 +37,6 @@
 import java.util.Locale;
 import java.util.Map;
 
-import static java.util.Collections.emptyMap;
 import static org.hamcrest.CoreMatchers.equalTo;
 import static org.hamcrest.Matchers.nullValue;
 
@@ -149,12 +147,4 @@ public void testClusterHealth() {
         }
         Assert.assertThat(request.getParameters(), equalTo(expectedParams));
     }
-
-    public void testRemoteInfo() {
-        RemoteInfoRequest request = new RemoteInfoRequest();
-        Request expectedRequest = ClusterRequestConverters.remoteInfo(request);
-        assertEquals("/_remote/info", expectedRequest.getEndpoint());
-        assertEquals(HttpGet.METHOD_NAME, expectedRequest.getMethod());
-        assertEquals(emptyMap(), expectedRequest.getParameters());
-    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
index 174c98f3642df..a9012fda042d9 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
@@ -19,25 +19,19 @@
 
 package org.elasticsearch.client;
 
-import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.ingest.PutPipelineRequest;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
-import org.elasticsearch.client.cluster.RemoteInfoRequest;
-import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.common.Booleans;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.ingest.Pipeline;
 import org.elasticsearch.search.SearchHit;
@@ -51,15 +45,10 @@
 import java.util.Arrays;
 import java.util.Base64;
 import java.util.Collections;
-import java.util.Map;
 import java.util.Objects;
 import java.util.stream.Collectors;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
-import static org.hamcrest.Matchers.greaterThan;
-import static org.hamcrest.Matchers.is;
-import static org.hamcrest.Matchers.notNullValue;
 
 public abstract class ESRestHighLevelClientTestCase extends ESRestTestCase {
 
@@ -254,30 +243,4 @@ protected void createIndexWithMultipleShards(String index) throws IOException {
         );
         highLevelClient().indices().create(indexRequest, RequestOptions.DEFAULT);
     }
-
-    protected static void setupRemoteClusterConfig(String remoteClusterName) throws Exception {
-        // Configure local cluster as remote cluster:
-        // TODO: replace with nodes info highlevel rest client code when it is available:
-        final Request request = new Request("GET", "/_nodes");
-        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
-        // Select node info of first node (we don't know the node id):
-        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
-        String transportAddress = (String) nodesResponse.get("transport_address");
-
-        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
-        updateSettingsRequest.transientSettings(singletonMap("cluster.remote." + remoteClusterName + ".seeds", transportAddress));
-        ClusterUpdateSettingsResponse updateSettingsResponse =
-                restHighLevelClient.cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
-        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
-
-        assertBusy(() -> {
-            RemoteInfoResponse response = highLevelClient().cluster().remoteInfo(new RemoteInfoRequest(), RequestOptions.DEFAULT);
-            assertThat(response, notNullValue());
-            assertThat(response.getInfos().size(), greaterThan(0));
-        });
-    }
-
-    protected static Map<String, Object> toMap(Response response) throws IOException {
-        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
-    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
index b3457eedb5569..4039ec251d335 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
@@ -59,8 +59,8 @@
 import org.elasticsearch.client.ml.dataframe.OutlierDetection;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.Classification;
-import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetric;
+import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.RSquaredMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.Regression;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.AucRocMetric;
@@ -68,14 +68,14 @@
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.PrecisionMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.RecallMetric;
-import org.elasticsearch.client.ml.inference.preprocessing.FrequencyEncoding;
-import org.elasticsearch.client.ml.inference.preprocessing.OneHotEncoding;
-import org.elasticsearch.client.ml.inference.preprocessing.TargetMeanEncoding;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.Ensemble;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.LogisticRegression;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedMode;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedSum;
 import org.elasticsearch.client.ml.inference.trainedmodel.tree.Tree;
+import org.elasticsearch.client.ml.inference.preprocessing.FrequencyEncoding;
+import org.elasticsearch.client.ml.inference.preprocessing.OneHotEncoding;
+import org.elasticsearch.client.ml.inference.preprocessing.TargetMeanEncoding;
 import org.elasticsearch.client.transform.transforms.SyncConfig;
 import org.elasticsearch.client.transform.transforms.TimeSyncConfig;
 import org.elasticsearch.common.CheckedFunction;
@@ -106,6 +106,7 @@
 import org.elasticsearch.test.InternalAggregationTestCase;
 import org.elasticsearch.test.rest.yaml.restspec.ClientYamlSuiteRestApi;
 import org.elasticsearch.test.rest.yaml.restspec.ClientYamlSuiteRestSpec;
+
 import org.hamcrest.Matchers;
 import org.junit.Before;
 
@@ -772,6 +773,7 @@ public void testProvidedNamedXContents() {
     public void testApiNamingConventions() throws Exception {
         //this list should be empty once the high-level client is feature complete
         String[] notYetSupportedApi = new String[]{
+            "cluster.remote_info",
             "create",
             "get_script_context",
             "get_script_languages",
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
deleted file mode 100644
index 6280bc9e11470..0000000000000
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
+++ /dev/null
@@ -1,111 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.client.cluster;
-
-import org.elasticsearch.client.AbstractResponseTestCase;
-import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.transport.ProxyConnectionStrategy;
-import org.elasticsearch.transport.RemoteConnectionInfo;
-import org.elasticsearch.transport.SniffConnectionStrategy;
-
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Map;
-
-import static java.util.function.Function.identity;
-import static java.util.stream.Collectors.toMap;
-import static org.hamcrest.Matchers.equalTo;
-
-public class RemoteInfoResponseTests extends AbstractResponseTestCase<org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse,
-        RemoteInfoResponse> {
-
-    @Override
-    protected org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse createServerTestInstance(XContentType xContentType) {
-        int numRemoteInfos = randomIntBetween(0, 8);
-        List<RemoteConnectionInfo> remoteInfos = new ArrayList<>();
-        for (int i = 0; i < numRemoteInfos; i++) {
-            remoteInfos.add(createRandomRemoteConnectionInfo());
-        }
-        return new org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse(remoteInfos);
-    }
-
-    @Override
-    protected RemoteInfoResponse doParseToClientInstance(XContentParser parser) throws IOException {
-        return RemoteInfoResponse.fromXContent(parser);
-    }
-
-    @Override
-    protected void assertInstances(org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse serverTestInstance,
-                                   RemoteInfoResponse clientInstance) {
-        assertThat(clientInstance.getInfos().size(), equalTo(serverTestInstance.getInfos().size()));
-        Map<String, RemoteConnectionInfo> serverInfos = serverTestInstance.getInfos().stream()
-                .collect(toMap(RemoteConnectionInfo::getClusterAlias, identity()));
-        for (org.elasticsearch.client.cluster.RemoteConnectionInfo clientRemoteInfo : clientInstance.getInfos()) {
-            RemoteConnectionInfo serverRemoteInfo = serverInfos.get(clientRemoteInfo.getClusterAlias());
-            assertThat(clientRemoteInfo.getClusterAlias(), equalTo(serverRemoteInfo.getClusterAlias()));
-            assertThat(clientRemoteInfo.getInitialConnectionTimeout(), equalTo(serverRemoteInfo.getInitialConnectionTimeout()));
-            assertThat(clientRemoteInfo.isConnected(), equalTo(serverRemoteInfo.isConnected()));
-            assertThat(clientRemoteInfo.isSkipUnavailable(), equalTo(serverRemoteInfo.isSkipUnavailable()));
-            assertThat(clientRemoteInfo.getModeInfo().isConnected(), equalTo(serverRemoteInfo.getModeInfo().isConnected()));
-            assertThat(clientRemoteInfo.getModeInfo().modeName(), equalTo(serverRemoteInfo.getModeInfo().modeName()));
-            if (clientRemoteInfo.getModeInfo().modeName().equals(SniffModeInfo.NAME)) {
-                SniffModeInfo clientModeInfo =
-                        (SniffModeInfo) clientRemoteInfo.getModeInfo();
-                SniffConnectionStrategy.SniffModeInfo serverModeInfo =
-                        (SniffConnectionStrategy.SniffModeInfo) serverRemoteInfo.getModeInfo();
-                assertThat(clientModeInfo.getMaxConnectionsPerCluster(), equalTo(serverModeInfo.getMaxConnectionsPerCluster()));
-                assertThat(clientModeInfo.getNumNodesConnected(), equalTo(serverModeInfo.getNumNodesConnected()));
-                assertThat(clientModeInfo.getSeedNodes(), equalTo(serverModeInfo.getSeedNodes()));
-            } else if (clientRemoteInfo.getModeInfo().modeName().equals(ProxyModeInfo.NAME)) {
-                ProxyModeInfo clientModeInfo =
-                        (ProxyModeInfo) clientRemoteInfo.getModeInfo();
-                ProxyConnectionStrategy.ProxyModeInfo serverModeInfo =
-                        (ProxyConnectionStrategy.ProxyModeInfo) serverRemoteInfo.getModeInfo();
-                assertThat(clientModeInfo.getAddress(), equalTo(serverModeInfo.getAddress()));
-                assertThat(clientModeInfo.getMaxSocketConnections(), equalTo(serverModeInfo.getMaxSocketConnections()));
-                assertThat(clientModeInfo.getNumSocketsConnected(), equalTo(serverModeInfo.getNumSocketsConnected()));
-            } else {
-                fail("impossible case");
-            }
-        }
-    }
-
-    private static RemoteConnectionInfo createRandomRemoteConnectionInfo() {
-        RemoteConnectionInfo.ModeInfo modeInfo;
-        if (randomBoolean()) {
-            String address = randomAlphaOfLength(8);
-            int maxSocketConnections = randomInt(5);
-            int numSocketsConnected = randomInt(5);
-            modeInfo = new ProxyConnectionStrategy.ProxyModeInfo(address, maxSocketConnections, numSocketsConnected);
-        } else {
-            List<String> seedNodes = randomList(randomInt(8), () -> randomAlphaOfLength(8));
-            int maxConnectionsPerCluster = randomInt(5);
-            int numNodesConnected = randomInt(5);
-            modeInfo = new SniffConnectionStrategy.SniffModeInfo(seedNodes, maxConnectionsPerCluster, numNodesConnected);
-        }
-        String clusterAlias = randomAlphaOfLength(8);
-        TimeValue initialConnectionTimeout = TimeValue.parseTimeValue(randomTimeValue(), "randomInitialConnectionTimeout");
-        boolean skipUnavailable = randomBoolean();
-        return new RemoteConnectionInfo(clusterAlias, modeInfo, initialConnectionTimeout, skipUnavailable);
-    }
-}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
index 5e7da8142129d..48f7adda8445c 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
@@ -19,8 +19,11 @@
 
 package org.elasticsearch.client.documentation;
 
+import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.LatchedActionListener;
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
@@ -54,6 +57,8 @@
 import org.elasticsearch.client.indices.CloseIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexResponse;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.test.rest.yaml.ObjectPath;
 import org.junit.Before;
 
@@ -71,8 +76,21 @@
 public class CCRDocumentationIT extends ESRestHighLevelClientTestCase {
 
     @Before
-    public void setupRemoteClusterConfig() throws Exception {
-        setupRemoteClusterConfig("local");
+    public void setupRemoteClusterConfig() throws IOException {
+        RestHighLevelClient client = highLevelClient();
+        // Configure local cluster as remote cluster:
+        // TODO: replace with nodes info highlevel rest client code when it is available:
+        final Request request = new Request("GET", "/_nodes");
+        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
+        // Select node info of first node (we don't know the node id):
+        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
+        String transportAddress = (String) nodesResponse.get("transport_address");
+
+        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
+        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local.seeds", transportAddress));
+        ClusterUpdateSettingsResponse updateSettingsResponse =
+            client.cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
+        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
     }
 
     public void testPutFollow() throws Exception {
@@ -967,4 +985,8 @@ public void onFailure(Exception e) {
         }
     }
 
+    static Map<String, Object> toMap(Response response) throws IOException {
+        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
+    }
+
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
index 5cc7a4424fcaa..8b7f1577114b0 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
@@ -31,9 +31,6 @@
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
 import org.elasticsearch.client.RequestOptions;
 import org.elasticsearch.client.RestHighLevelClient;
-import org.elasticsearch.client.cluster.RemoteConnectionInfo;
-import org.elasticsearch.client.cluster.RemoteInfoRequest;
-import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.health.ClusterIndexHealth;
@@ -49,7 +46,6 @@
 
 import java.io.IOException;
 import java.util.HashMap;
-import java.util.List;
 import java.util.Map;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
@@ -419,60 +415,4 @@ public void onFailure(Exception e) {
             assertTrue(latch.await(30L, TimeUnit.SECONDS));
         }
     }
-
-    public void testRemoteInfo() throws Exception {
-        setupRemoteClusterConfig("local_cluster");
-
-        RestHighLevelClient client = highLevelClient();
-
-        // tag::remote-info-request
-        RemoteInfoRequest request = new RemoteInfoRequest();
-        // end::remote-info-request
-
-        // tag::remote-info-execute
-        RemoteInfoResponse response = client.cluster().remoteInfo(request, RequestOptions.DEFAULT); // <1>
-        // end::remote-info-execute
-
-        // tag::remote-info-response
-        List<RemoteConnectionInfo> infos = response.getInfos();
-        // end::remote-info-response
-
-        assertThat(infos.size(), greaterThan(0));
-    }
-
-    public void testRemoteInfoAsync() throws Exception {
-        setupRemoteClusterConfig("local_cluster");
-
-        RestHighLevelClient client = highLevelClient();
-
-        // tag::remote-info-request
-        RemoteInfoRequest request = new RemoteInfoRequest();
-        // end::remote-info-request
-
-
-        // tag::remote-info-execute-listener
-            ActionListener<RemoteInfoResponse> listener =
-                new ActionListener<>() {
-                    @Override
-                    public void onResponse(RemoteInfoResponse response) {
-                        // <1>
-                    }
-
-                    @Override
-                    public void onFailure(Exception e) {
-                        // <2>
-                    }
-                };
-            // end::remote-info-execute-listener
-
-        // Replace the empty listener by a blocking listener in test
-        final CountDownLatch latch = new CountDownLatch(1);
-        listener = new LatchedActionListener<>(listener, latch);
-
-        // tag::health-execute-async
-            client.cluster().remoteInfoAsync(request, RequestOptions.DEFAULT, listener); // <1>
-        // end::health-execute-async
-
-        assertTrue(latch.await(30L, TimeUnit.SECONDS));
-    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
index a458c3ec2551d..a9852c405a49d 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.client.documentation;
 
+import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.LatchedActionListener;
 import org.elasticsearch.action.admin.cluster.repositories.put.PutRepositoryRequest;
@@ -27,6 +28,7 @@
 import org.elasticsearch.action.admin.indices.alias.Alias;
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
 import org.elasticsearch.client.RequestOptions;
+import org.elasticsearch.client.Response;
 import org.elasticsearch.client.RestHighLevelClient;
 import org.elasticsearch.client.core.AcknowledgedResponse;
 import org.elasticsearch.client.ilm.DeleteAction;
@@ -76,6 +78,8 @@
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.repositories.fs.FsRepository;
 import org.elasticsearch.snapshots.SnapshotInfo;
 import org.elasticsearch.snapshots.SnapshotState;
@@ -1206,4 +1210,8 @@ public void onFailure(Exception e) {
         assertTrue(latch.await(30L, TimeUnit.SECONDS));
     }
 
+    static Map<String, Object> toMap(Response response) throws IOException {
+        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
+    }
+
 }
diff --git a/docs/java-rest/high-level/cluster/remote_info.asciidoc b/docs/java-rest/high-level/cluster/remote_info.asciidoc
deleted file mode 100644
index 6496a04a3a76c..0000000000000
--- a/docs/java-rest/high-level/cluster/remote_info.asciidoc
+++ /dev/null
@@ -1,32 +0,0 @@
---
-:api: remote-info
-:request: RemoteInfoRequest
-:response: RemoteInfoResponse
---
-
-[id="{upid}-{api}"]
-=== Remote Cluster Info API
-
-The Remote cluster info API allows to get all of the configured remote cluster information.
-
-[id="{upid}-{api}-request"]
-==== Remote Cluster Info Request
-
-A +{request}+:
-
-["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
-include-tagged::{doc-tests-file}[{api}-request]
---------------------------------------------------
-
-There are no required parameters.
-
-==== Remote Cluster Info Response
-
-The returned +{response}+ allows to retrieve remote cluster information.
-It returns connection and endpoint information keyed by the configured remote cluster alias.
-
-["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
-include-tagged::{doc-tests-file}[{api}-response]
---------------------------------------------------
diff --git a/docs/java-rest/high-level/supported-apis.asciidoc b/docs/java-rest/high-level/supported-apis.asciidoc
index e0d228b5d1e4b..2191e795ebbb1 100644
--- a/docs/java-rest/high-level/supported-apis.asciidoc
+++ b/docs/java-rest/high-level/supported-apis.asciidoc
@@ -168,14 +168,12 @@ The Java High Level REST Client supports the following Cluster APIs:
 * <<java-rest-high-cluster-put-settings>>
 * <<java-rest-high-cluster-get-settings>>
 * <<java-rest-high-cluster-health>>
-* <<java-rest-high-cluster-remote-info>>
 
 :upid: {mainid}-cluster
 :doc-tests-file: {doc-tests}/ClusterClientDocumentationIT.java
 include::cluster/put_settings.asciidoc[]
 include::cluster/get_settings.asciidoc[]
 include::cluster/health.asciidoc[]
-include::cluster/remote_info.asciidoc[]
 
 == Ingest APIs
 The Java High Level REST Client supports the following Ingest APIs:
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
index 9d72da7746974..894cd9cf9fec4 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
@@ -39,7 +39,7 @@ public final class RemoteInfoResponse extends ActionResponse implements ToXConte
         infos = in.readList(RemoteConnectionInfo::new);
     }
 
-    public RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
+    RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
         this.infos = List.copyOf(infos);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
index 14ca217ade1b8..78c9f5f28154d 100644
--- a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
@@ -268,13 +268,13 @@ private static TransportAddress resolveAddress(String address) {
         return new TransportAddress(parseConfiguredAddress(address));
     }
 
-    public static class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
+    static class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
 
         private final String address;
         private final int maxSocketConnections;
         private final int numSocketsConnected;
 
-        public ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
+        ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
             this.address = address;
             this.maxSocketConnections = maxSocketConnections;
             this.numSocketsConnected = numSocketsConnected;
@@ -311,18 +311,6 @@ public String modeName() {
             return "proxy";
         }
 
-        public String getAddress() {
-            return address;
-        }
-
-        public int getMaxSocketConnections() {
-            return maxSocketConnections;
-        }
-
-        public int getNumSocketsConnected() {
-            return numSocketsConnected;
-        }
-
         @Override
         public RemoteConnectionStrategy.ConnectionStrategy modeType() {
             return RemoteConnectionStrategy.ConnectionStrategy.PROXY;
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
index 152cafccb61e0..e721a0b617fd1 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
@@ -43,7 +43,7 @@ public final class RemoteConnectionInfo implements ToXContentFragment, Writeable
     final String clusterAlias;
     final boolean skipUnavailable;
 
-    public RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
+    RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
         this.clusterAlias = clusterAlias;
         this.modeInfo = modeInfo;
         this.initialConnectionTimeout = initialConnectionTimeout;
@@ -77,18 +77,6 @@ public String getClusterAlias() {
         return clusterAlias;
     }
 
-    public ModeInfo getModeInfo() {
-        return modeInfo;
-    }
-
-    public TimeValue getInitialConnectionTimeout() {
-        return initialConnectionTimeout;
-    }
-
-    public boolean isSkipUnavailable() {
-        return skipUnavailable;
-    }
-
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         // TODO: Change to 7.6 after backport
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index fcc4bde951dd0..97b5e318841d6 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -465,13 +465,13 @@ private boolean proxyChanged(String oldProxy, String newProxy) {
         return Objects.equals(oldProxy, newProxy) == false;
     }
 
-    public static class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
+    static class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
 
         final List<String> seedNodes;
         final int maxConnectionsPerCluster;
         final int numNodesConnected;
 
-        public SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
+        SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
             this.seedNodes = seedNodes;
             this.maxConnectionsPerCluster = maxConnectionsPerCluster;
             this.numNodesConnected = numNodesConnected;
@@ -512,18 +512,6 @@ public String modeName() {
             return "sniff";
         }
 
-        public List<String> getSeedNodes() {
-            return seedNodes;
-        }
-
-        public int getMaxConnectionsPerCluster() {
-            return maxConnectionsPerCluster;
-        }
-
-        public int getNumNodesConnected() {
-            return numNodesConnected;
-        }
-
         @Override
         public RemoteConnectionStrategy.ConnectionStrategy modeType() {
             return RemoteConnectionStrategy.ConnectionStrategy.SNIFF;
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
index e4c9eb0986b34..4d1848e5b3a98 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
@@ -755,19 +755,6 @@ public static <T> T[] randomArray(int minArraySize, int maxArraySize, IntFunctio
         return array;
     }
 
-    public static <T> List<T> randomList(int maxListSize, Supplier<T> valueConstructor) {
-        return randomList(0, maxListSize, valueConstructor);
-    }
-
-    public static <T> List<T> randomList(int minListSize, int maxListSize, Supplier<T> valueConstructor) {
-        final int size = randomIntBetween(minListSize, maxListSize);
-        List<T> list = new ArrayList<>();
-        for (int i = 0; i < size; i++) {
-            list.add(valueConstructor.get());
-        }
-        return list;
-    }
-
 
     private static final String[] TIME_SUFFIXES = new String[]{"d", "h", "ms", "s", "m", "micros", "nanos"};
 

From bea16009b27230f260984759e2932f1015f90b8e Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Tue, 24 Dec 2019 13:20:39 +0100
Subject: [PATCH 329/686] Add remote info to the HLRC (#50482)

Unreverts the commit that added the remote info api to HLRC (#49657).

The additional change to the original PR, is that `org.elasticsearch.client.cluster.RemoteConnectionInfo` now parses the initial_connect_timeout field as a string instead of a TimeValue instance.

The reason that this is needed is because that the initial_connect_timeout field in the remote connection api is serialized for human consumption, but not for parsing purposes.
Therefore the HLRC can't parse it correctly (which caused test failures in CI, but not in the PR CI
:( ). The way this field is serialized needs to be changed in the remote connection api, but that is a breaking change. We should wait making this change until rest api versioning is introduced.

Co-Authored-By: j-bean anton.shuvaev91@gmail.com
---
 .../elasticsearch/client/ClusterClient.java   |  31 ++++
 .../client/ClusterRequestConverters.java      |   5 +
 .../client/cluster/ProxyModeInfo.java         |  75 ++++++++++
 .../client/cluster/RemoteConnectionInfo.java  | 139 ++++++++++++++++++
 .../client/cluster/RemoteInfoRequest.java     |  28 ++++
 .../client/cluster/RemoteInfoResponse.java    |  59 ++++++++
 .../client/cluster/SniffModeInfo.java         |  76 ++++++++++
 .../java/org/elasticsearch/client/CCRIT.java  |  31 +---
 .../elasticsearch/client/ClusterClientIT.java |  45 ++++++
 .../client/ClusterRequestConvertersTests.java |  10 ++
 .../client/ESRestHighLevelClientTestCase.java |  37 +++++
 .../client/RestHighLevelClientTests.java      |  10 +-
 .../cluster/RemoteInfoResponseTests.java      | 112 ++++++++++++++
 .../documentation/CCRDocumentationIT.java     |  26 +---
 .../ClusterClientDocumentationIT.java         |  60 ++++++++
 .../documentation/ILMDocumentationIT.java     |   8 -
 .../high-level/cluster/remote_info.asciidoc   |  32 ++++
 .../high-level/supported-apis.asciidoc        |   2 +
 .../cluster/remote/RemoteInfoResponse.java    |   2 +-
 .../transport/ProxyConnectionStrategy.java    |  16 +-
 .../transport/RemoteConnectionInfo.java       |  14 +-
 .../transport/SniffConnectionStrategy.java    |  16 +-
 .../org/elasticsearch/test/ESTestCase.java    |  13 ++
 23 files changed, 773 insertions(+), 74 deletions(-)
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
 create mode 100644 docs/java-rest/high-level/cluster/remote_info.asciidoc

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
index 5e99975f51491..14fbf3e1f6d0f 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java
@@ -26,6 +26,8 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsResponse;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
+import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.rest.RestStatus;
 
 import java.io.IOException;
@@ -138,4 +140,33 @@ public Cancellable healthAsync(ClusterHealthRequest healthRequest, RequestOption
         return restHighLevelClient.performRequestAsyncAndParseEntity(healthRequest, ClusterRequestConverters::clusterHealth, options,
                 ClusterHealthResponse::fromXContent, listener, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
     }
+
+    /**
+     * Get the remote cluster information using the Remote cluster info API.
+     * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-remote-info.html"> Remote cluster info
+     * API on elastic.co</a>
+     * @param request the request
+     * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
+     * @return the response
+     * @throws IOException in case there is a problem sending the request or parsing back the response
+     */
+    public RemoteInfoResponse remoteInfo(RemoteInfoRequest request, RequestOptions options) throws IOException {
+        return restHighLevelClient.performRequestAndParseEntity(request, ClusterRequestConverters::remoteInfo, options,
+                RemoteInfoResponse::fromXContent, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
+    }
+
+    /**
+     * Asynchronously get remote cluster information using the Remote cluster info API.
+     * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-remote-info.html"> Remote cluster info
+     * API on elastic.co</a>
+     * @param request the request
+     * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
+     * @param listener the listener to be notified upon request completion
+     * @return cancellable that may be used to cancel the request
+     */
+    public Cancellable remoteInfoAsync(RemoteInfoRequest request, RequestOptions options,
+                                       ActionListener<RemoteInfoResponse> listener) {
+        return restHighLevelClient.performRequestAsyncAndParseEntity(request, ClusterRequestConverters::remoteInfo, options,
+                RemoteInfoResponse::fromXContent, listener, singleton(RestStatus.REQUEST_TIMEOUT.getStatus()));
+    }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
index a246402b505cc..74b2c3b7c6aae 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterRequestConverters.java
@@ -25,6 +25,7 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
 import org.elasticsearch.common.Strings;
 
 import java.io.IOException;
@@ -76,4 +77,8 @@ static Request clusterHealth(ClusterHealthRequest healthRequest) {
         request.addParameters(params.asMap());
         return request;
     }
+
+    static Request remoteInfo(RemoteInfoRequest remoteInfoRequest) {
+        return new Request(HttpGet.METHOD_NAME, "/_remote/info");
+    }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
new file mode 100644
index 0000000000000..0fc4f240eb8ef
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/ProxyModeInfo.java
@@ -0,0 +1,75 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.cluster;
+
+import java.util.Objects;
+
+public class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
+    static final String NAME = "proxy";
+    static final String ADDRESS = "address";
+    static final String NUM_SOCKETS_CONNECTED = "num_sockets_connected";
+    static final String MAX_SOCKET_CONNECTIONS = "max_socket_connections";
+    private final String address;
+    private final int maxSocketConnections;
+    private final int numSocketsConnected;
+
+    ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
+        this.address = address;
+        this.maxSocketConnections = maxSocketConnections;
+        this.numSocketsConnected = numSocketsConnected;
+    }
+
+    @Override
+    public boolean isConnected() {
+        return numSocketsConnected > 0;
+    }
+
+    @Override
+    public String modeName() {
+        return NAME;
+    }
+
+    public String getAddress() {
+        return address;
+    }
+
+    public int getMaxSocketConnections() {
+        return maxSocketConnections;
+    }
+
+    public int getNumSocketsConnected() {
+        return numSocketsConnected;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        ProxyModeInfo otherProxy = (ProxyModeInfo) o;
+        return maxSocketConnections == otherProxy.maxSocketConnections &&
+                numSocketsConnected == otherProxy.numSocketsConnected &&
+                Objects.equals(address, otherProxy.address);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(address, maxSocketConnections, numSocketsConnected);
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
new file mode 100644
index 0000000000000..2bf99c61085c4
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteConnectionInfo.java
@@ -0,0 +1,139 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.cluster;
+
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Objects;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
+
+/**
+ * This class encapsulates all remote cluster information to be rendered on
+ * {@code _remote/info} requests.
+ */
+public final class RemoteConnectionInfo {
+    private static final String CONNECTED = "connected";
+    private static final String MODE = "mode";
+    private static final String INITIAL_CONNECT_TIMEOUT = "initial_connect_timeout";
+    private static final String SKIP_UNAVAILABLE = "skip_unavailable";
+
+    @SuppressWarnings("unchecked")
+    private static final ConstructingObjectParser<RemoteConnectionInfo, String> PARSER = new ConstructingObjectParser<>(
+            "RemoteConnectionInfoObjectParser",
+            false,
+            (args, clusterAlias) -> {
+                String mode = (String) args[1];
+                ModeInfo modeInfo;
+                if (mode.equals(ProxyModeInfo.NAME)) {
+                    modeInfo = new ProxyModeInfo((String) args[4], (int) args[5], (int) args[6]);
+                } else if (mode.equals(SniffModeInfo.NAME)) {
+                    modeInfo = new SniffModeInfo((List<String>) args[7], (int) args[8], (int) args[9]);
+                } else {
+                    throw new IllegalArgumentException("mode cannot be " + mode);
+                }
+                return new RemoteConnectionInfo(clusterAlias,
+                        modeInfo,
+                        (String) args[2],
+                        (boolean) args[3]);
+            });
+
+    static {
+        PARSER.declareBoolean(constructorArg(), new ParseField(CONNECTED));
+        PARSER.declareString(constructorArg(), new ParseField(MODE));
+        PARSER.declareString(constructorArg(), new ParseField(INITIAL_CONNECT_TIMEOUT));
+        PARSER.declareBoolean(constructorArg(), new ParseField(SKIP_UNAVAILABLE));
+
+        PARSER.declareString(optionalConstructorArg(), new ParseField(ProxyModeInfo.ADDRESS));
+        PARSER.declareInt(optionalConstructorArg(), new ParseField(ProxyModeInfo.MAX_SOCKET_CONNECTIONS));
+        PARSER.declareInt(optionalConstructorArg(), new ParseField(ProxyModeInfo.NUM_SOCKETS_CONNECTED));
+
+        PARSER.declareStringArray(optionalConstructorArg(), new ParseField(SniffModeInfo.SEEDS));
+        PARSER.declareInt(optionalConstructorArg(), new ParseField(SniffModeInfo.MAX_CONNECTIONS_PER_CLUSTER));
+        PARSER.declareInt(optionalConstructorArg(), new ParseField(SniffModeInfo.NUM_NODES_CONNECTED));
+    }
+
+    private final ModeInfo modeInfo;
+    // TODO: deprecate and remove this field in favor of initialConnectionTimeout field that is of type TimeValue.
+    // When rest api versioning exists then change org.elasticsearch.transport.RemoteConnectionInfo to properly serialize
+    // the initialConnectionTimeout field so that we can properly parse initialConnectionTimeout as TimeValue
+    private final String initialConnectionTimeoutString;
+    private final String clusterAlias;
+    private final boolean skipUnavailable;
+
+    RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, String initialConnectionTimeoutString, boolean skipUnavailable) {
+        this.clusterAlias = clusterAlias;
+        this.modeInfo = modeInfo;
+        this.initialConnectionTimeoutString = initialConnectionTimeoutString;
+        this.skipUnavailable = skipUnavailable;
+    }
+
+    public boolean isConnected() {
+        return modeInfo.isConnected();
+    }
+
+    public String getClusterAlias() {
+        return clusterAlias;
+    }
+
+    public ModeInfo getModeInfo() {
+        return modeInfo;
+    }
+
+    public String getInitialConnectionTimeoutString() {
+        return initialConnectionTimeoutString;
+    }
+
+    public boolean isSkipUnavailable() {
+        return skipUnavailable;
+    }
+
+    public static RemoteConnectionInfo fromXContent(XContentParser parser, String clusterAlias) throws IOException {
+        return PARSER.parse(parser, clusterAlias);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        RemoteConnectionInfo that = (RemoteConnectionInfo) o;
+        return skipUnavailable == that.skipUnavailable &&
+                Objects.equals(modeInfo, that.modeInfo) &&
+                Objects.equals(initialConnectionTimeoutString, that.initialConnectionTimeoutString) &&
+                Objects.equals(clusterAlias, that.clusterAlias);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(modeInfo, initialConnectionTimeoutString, clusterAlias, skipUnavailable);
+    }
+
+    public interface ModeInfo {
+
+        boolean isConnected();
+
+        String modeName();
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
new file mode 100644
index 0000000000000..5ffc8afc073c6
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoRequest.java
@@ -0,0 +1,28 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.cluster;
+
+import org.elasticsearch.client.Validatable;
+
+/**
+ * The request object used by the Remote cluster info API.
+ */
+public final class RemoteInfoRequest implements Validatable {
+
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
new file mode 100644
index 0000000000000..cc453049667b1
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/RemoteInfoResponse.java
@@ -0,0 +1,59 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.cluster;
+
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+
+import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
+
+/**
+ * A response to _remote/info API request.
+ */
+public final class RemoteInfoResponse {
+
+    private List<RemoteConnectionInfo> infos;
+
+    RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
+        this.infos = List.copyOf(infos);
+    }
+
+    public List<RemoteConnectionInfo> getInfos() {
+        return infos;
+    }
+
+    public static RemoteInfoResponse fromXContent(XContentParser parser) throws IOException {
+        ensureExpectedToken(XContentParser.Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation);
+
+        List<RemoteConnectionInfo> infos = new ArrayList<>();
+
+        XContentParser.Token token;
+        while ((token = parser.nextToken()) == XContentParser.Token.FIELD_NAME) {
+            String clusterAlias = parser.currentName();
+            RemoteConnectionInfo info = RemoteConnectionInfo.fromXContent(parser, clusterAlias);
+            infos.add(info);
+        }
+        ensureExpectedToken(XContentParser.Token.END_OBJECT, token, parser::getTokenLocation);
+        return new RemoteInfoResponse(infos);
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
new file mode 100644
index 0000000000000..b0e75979975ee
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/cluster/SniffModeInfo.java
@@ -0,0 +1,76 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.cluster;
+
+import java.util.List;
+import java.util.Objects;
+
+public class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
+    public static final String NAME = "sniff";
+    static final String SEEDS = "seeds";
+    static final String NUM_NODES_CONNECTED = "num_nodes_connected";
+    static final String MAX_CONNECTIONS_PER_CLUSTER = "max_connections_per_cluster";
+    final List<String> seedNodes;
+    final int maxConnectionsPerCluster;
+    final int numNodesConnected;
+
+    SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
+        this.seedNodes = seedNodes;
+        this.maxConnectionsPerCluster = maxConnectionsPerCluster;
+        this.numNodesConnected = numNodesConnected;
+    }
+
+    @Override
+    public boolean isConnected() {
+        return numNodesConnected > 0;
+    }
+
+    @Override
+    public String modeName() {
+        return NAME;
+    }
+
+    public List<String> getSeedNodes() {
+        return seedNodes;
+    }
+
+    public int getMaxConnectionsPerCluster() {
+        return maxConnectionsPerCluster;
+    }
+
+    public int getNumNodesConnected() {
+        return numNodesConnected;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        SniffModeInfo sniff = (SniffModeInfo) o;
+        return maxConnectionsPerCluster == sniff.maxConnectionsPerCluster &&
+                numNodesConnected == sniff.numNodesConnected &&
+                Objects.equals(seedNodes, sniff.seedNodes);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(seedNodes, maxConnectionsPerCluster, numNodesConnected);
+    }
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
index 6be2efe98c48b..c6678102fe2b1 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
@@ -19,10 +19,7 @@
 
 package org.elasticsearch.client;
 
-import org.apache.http.util.EntityUtils;
 import org.apache.logging.log4j.message.ParameterizedMessage;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
@@ -51,9 +48,7 @@
 import org.elasticsearch.client.indices.CloseIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexResponse;
-import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.seqno.ReplicationTracker;
 import org.elasticsearch.test.rest.yaml.ObjectPath;
 import org.junit.Before;
@@ -74,27 +69,7 @@ public class CCRIT extends ESRestHighLevelClientTestCase {
 
     @Before
     public void setupRemoteClusterConfig() throws Exception {
-        // Configure local cluster as remote cluster:
-        // TODO: replace with nodes info highlevel rest client code when it is available:
-        final Request request = new Request("GET", "/_nodes");
-        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
-        // Select node info of first node (we don't know the node id):
-        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
-        String transportAddress = (String) nodesResponse.get("transport_address");
-
-        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
-        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local_cluster.seeds", transportAddress));
-        ClusterUpdateSettingsResponse updateSettingsResponse =
-            highLevelClient().cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
-        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
-
-        assertBusy(() -> {
-            Map<?, ?> localConnection = (Map<?, ?>) toMap(client()
-                .performRequest(new Request("GET", "/_remote/info")))
-                .get("local_cluster");
-            assertThat(localConnection, notNullValue());
-            assertThat(localConnection.get("connected"), is(true));
-        });
+        setupRemoteClusterConfig("local_cluster");
     }
 
     public void testIndexFollowing() throws Exception {
@@ -311,8 +286,4 @@ public void testAutoFollowing() throws Exception {
         assertThat(pauseFollowResponse.isAcknowledged(), is(true));
     }
 
-    private static Map<String, Object> toMap(Response response) throws IOException {
-        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
-    }
-
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
index e78e7ec7ca6d3..45ba23c2a3745 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
@@ -27,19 +27,27 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterGetSettingsResponse;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
+import org.elasticsearch.client.cluster.RemoteConnectionInfo;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
+import org.elasticsearch.client.cluster.RemoteInfoResponse;
+import org.elasticsearch.client.cluster.SniffModeInfo;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.health.ClusterIndexHealth;
 import org.elasticsearch.cluster.health.ClusterShardHealth;
 import org.elasticsearch.cluster.routing.allocation.decider.EnableAllocationDecider;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
 import org.elasticsearch.indices.recovery.RecoverySettings;
 import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.transport.RemoteClusterService;
+import org.elasticsearch.transport.SniffConnectionStrategy;
 
 import java.io.IOException;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 
 import static java.util.Collections.emptyMap;
@@ -297,4 +305,41 @@ public void testClusterHealthNotFoundIndex() throws IOException {
         assertNoIndices(response);
     }
 
+    public void testRemoteInfo() throws Exception {
+        String clusterAlias = "local_cluster";
+        setupRemoteClusterConfig(clusterAlias);
+
+        ClusterGetSettingsRequest settingsRequest = new ClusterGetSettingsRequest();
+        settingsRequest.includeDefaults(true);
+        ClusterGetSettingsResponse settingsResponse = highLevelClient().cluster().getSettings(settingsRequest, RequestOptions.DEFAULT);
+
+        List<String> seeds = SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS
+                .getConcreteSettingForNamespace(clusterAlias)
+                .get(settingsResponse.getTransientSettings());
+        int connectionsPerCluster = SniffConnectionStrategy.REMOTE_CONNECTIONS_PER_CLUSTER
+                .get(settingsResponse.getDefaultSettings());
+        TimeValue initialConnectionTimeout = RemoteClusterService.REMOTE_INITIAL_CONNECTION_TIMEOUT_SETTING
+                .get(settingsResponse.getDefaultSettings());
+        boolean skipUnavailable = RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE
+                .getConcreteSettingForNamespace(clusterAlias)
+                .get(settingsResponse.getDefaultSettings());
+
+        RemoteInfoRequest request = new RemoteInfoRequest();
+        RemoteInfoResponse response = execute(request, highLevelClient().cluster()::remoteInfo,
+                highLevelClient().cluster()::remoteInfoAsync);
+
+        assertThat(response, notNullValue());
+        assertThat(response.getInfos().size(), equalTo(1));
+        RemoteConnectionInfo info = response.getInfos().get(0);
+        assertThat(info.getClusterAlias(), equalTo(clusterAlias));
+        assertThat(info.getInitialConnectionTimeoutString(), equalTo(initialConnectionTimeout.toString()));
+        assertThat(info.isSkipUnavailable(), equalTo(skipUnavailable));
+        assertThat(info.getModeInfo().modeName(), equalTo(SniffModeInfo.NAME));
+        assertThat(info.getModeInfo().isConnected(), equalTo(true));
+        SniffModeInfo sniffModeInfo = (SniffModeInfo) info.getModeInfo();
+        assertThat(sniffModeInfo.getMaxConnectionsPerCluster(), equalTo(connectionsPerCluster));
+        assertThat(sniffModeInfo.getNumNodesConnected(), equalTo(1));
+        assertThat(sniffModeInfo.getSeedNodes(), equalTo(seeds));
+    }
+
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
index 9b7b5b0d284dc..59bf52a677321 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterRequestConvertersTests.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
 import org.elasticsearch.action.support.master.AcknowledgedRequest;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.test.ESTestCase;
@@ -37,6 +38,7 @@
 import java.util.Locale;
 import java.util.Map;
 
+import static java.util.Collections.emptyMap;
 import static org.hamcrest.CoreMatchers.equalTo;
 import static org.hamcrest.Matchers.nullValue;
 
@@ -147,4 +149,12 @@ public void testClusterHealth() {
         }
         Assert.assertThat(request.getParameters(), equalTo(expectedParams));
     }
+
+    public void testRemoteInfo() {
+        RemoteInfoRequest request = new RemoteInfoRequest();
+        Request expectedRequest = ClusterRequestConverters.remoteInfo(request);
+        assertEquals("/_remote/info", expectedRequest.getEndpoint());
+        assertEquals(HttpGet.METHOD_NAME, expectedRequest.getMethod());
+        assertEquals(emptyMap(), expectedRequest.getParameters());
+    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
index a9012fda042d9..174c98f3642df 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ESRestHighLevelClientTestCase.java
@@ -19,19 +19,25 @@
 
 package org.elasticsearch.client;
 
+import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.ingest.PutPipelineRequest;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
+import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.common.Booleans;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.ingest.Pipeline;
 import org.elasticsearch.search.SearchHit;
@@ -45,10 +51,15 @@
 import java.util.Arrays;
 import java.util.Base64;
 import java.util.Collections;
+import java.util.Map;
 import java.util.Objects;
 import java.util.stream.Collectors;
 
+import static java.util.Collections.singletonMap;
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
+import static org.hamcrest.Matchers.greaterThan;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.notNullValue;
 
 public abstract class ESRestHighLevelClientTestCase extends ESRestTestCase {
 
@@ -243,4 +254,30 @@ protected void createIndexWithMultipleShards(String index) throws IOException {
         );
         highLevelClient().indices().create(indexRequest, RequestOptions.DEFAULT);
     }
+
+    protected static void setupRemoteClusterConfig(String remoteClusterName) throws Exception {
+        // Configure local cluster as remote cluster:
+        // TODO: replace with nodes info highlevel rest client code when it is available:
+        final Request request = new Request("GET", "/_nodes");
+        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
+        // Select node info of first node (we don't know the node id):
+        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
+        String transportAddress = (String) nodesResponse.get("transport_address");
+
+        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
+        updateSettingsRequest.transientSettings(singletonMap("cluster.remote." + remoteClusterName + ".seeds", transportAddress));
+        ClusterUpdateSettingsResponse updateSettingsResponse =
+                restHighLevelClient.cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
+        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
+
+        assertBusy(() -> {
+            RemoteInfoResponse response = highLevelClient().cluster().remoteInfo(new RemoteInfoRequest(), RequestOptions.DEFAULT);
+            assertThat(response, notNullValue());
+            assertThat(response.getInfos().size(), greaterThan(0));
+        });
+    }
+
+    protected static Map<String, Object> toMap(Response response) throws IOException {
+        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
+    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
index 4039ec251d335..b3457eedb5569 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
@@ -59,8 +59,8 @@
 import org.elasticsearch.client.ml.dataframe.OutlierDetection;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.AccuracyMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.Classification;
-import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.classification.MulticlassConfusionMatrixMetric;
+import org.elasticsearch.client.ml.dataframe.evaluation.regression.MeanSquaredErrorMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.RSquaredMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.regression.Regression;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.AucRocMetric;
@@ -68,14 +68,14 @@
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.PrecisionMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.RecallMetric;
+import org.elasticsearch.client.ml.inference.preprocessing.FrequencyEncoding;
+import org.elasticsearch.client.ml.inference.preprocessing.OneHotEncoding;
+import org.elasticsearch.client.ml.inference.preprocessing.TargetMeanEncoding;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.Ensemble;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.LogisticRegression;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedMode;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedSum;
 import org.elasticsearch.client.ml.inference.trainedmodel.tree.Tree;
-import org.elasticsearch.client.ml.inference.preprocessing.FrequencyEncoding;
-import org.elasticsearch.client.ml.inference.preprocessing.OneHotEncoding;
-import org.elasticsearch.client.ml.inference.preprocessing.TargetMeanEncoding;
 import org.elasticsearch.client.transform.transforms.SyncConfig;
 import org.elasticsearch.client.transform.transforms.TimeSyncConfig;
 import org.elasticsearch.common.CheckedFunction;
@@ -106,7 +106,6 @@
 import org.elasticsearch.test.InternalAggregationTestCase;
 import org.elasticsearch.test.rest.yaml.restspec.ClientYamlSuiteRestApi;
 import org.elasticsearch.test.rest.yaml.restspec.ClientYamlSuiteRestSpec;
-
 import org.hamcrest.Matchers;
 import org.junit.Before;
 
@@ -773,7 +772,6 @@ public void testProvidedNamedXContents() {
     public void testApiNamingConventions() throws Exception {
         //this list should be empty once the high-level client is feature complete
         String[] notYetSupportedApi = new String[]{
-            "cluster.remote_info",
             "create",
             "get_script_context",
             "get_script_languages",
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
new file mode 100644
index 0000000000000..88f8f6f533e1d
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/cluster/RemoteInfoResponseTests.java
@@ -0,0 +1,112 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.cluster;
+
+import org.elasticsearch.client.AbstractResponseTestCase;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.transport.ProxyConnectionStrategy;
+import org.elasticsearch.transport.RemoteConnectionInfo;
+import org.elasticsearch.transport.SniffConnectionStrategy;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+import static java.util.function.Function.identity;
+import static java.util.stream.Collectors.toMap;
+import static org.hamcrest.Matchers.equalTo;
+
+public class RemoteInfoResponseTests extends AbstractResponseTestCase<org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse,
+        RemoteInfoResponse> {
+
+    @Override
+    protected org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse createServerTestInstance(XContentType xContentType) {
+        int numRemoteInfos = randomIntBetween(0, 8);
+        List<RemoteConnectionInfo> remoteInfos = new ArrayList<>();
+        for (int i = 0; i < numRemoteInfos; i++) {
+            remoteInfos.add(createRandomRemoteConnectionInfo());
+        }
+        return new org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse(remoteInfos);
+    }
+
+    @Override
+    protected RemoteInfoResponse doParseToClientInstance(XContentParser parser) throws IOException {
+        return RemoteInfoResponse.fromXContent(parser);
+    }
+
+    @Override
+    protected void assertInstances(org.elasticsearch.action.admin.cluster.remote.RemoteInfoResponse serverTestInstance,
+                                   RemoteInfoResponse clientInstance) {
+        assertThat(clientInstance.getInfos().size(), equalTo(serverTestInstance.getInfos().size()));
+        Map<String, RemoteConnectionInfo> serverInfos = serverTestInstance.getInfos().stream()
+                .collect(toMap(RemoteConnectionInfo::getClusterAlias, identity()));
+        for (org.elasticsearch.client.cluster.RemoteConnectionInfo clientRemoteInfo : clientInstance.getInfos()) {
+            RemoteConnectionInfo serverRemoteInfo = serverInfos.get(clientRemoteInfo.getClusterAlias());
+            assertThat(clientRemoteInfo.getClusterAlias(), equalTo(serverRemoteInfo.getClusterAlias()));
+            assertThat(clientRemoteInfo.getInitialConnectionTimeoutString(),
+                equalTo(serverRemoteInfo.getInitialConnectionTimeout().toString()));
+            assertThat(clientRemoteInfo.isConnected(), equalTo(serverRemoteInfo.isConnected()));
+            assertThat(clientRemoteInfo.isSkipUnavailable(), equalTo(serverRemoteInfo.isSkipUnavailable()));
+            assertThat(clientRemoteInfo.getModeInfo().isConnected(), equalTo(serverRemoteInfo.getModeInfo().isConnected()));
+            assertThat(clientRemoteInfo.getModeInfo().modeName(), equalTo(serverRemoteInfo.getModeInfo().modeName()));
+            if (clientRemoteInfo.getModeInfo().modeName().equals(SniffModeInfo.NAME)) {
+                SniffModeInfo clientModeInfo =
+                        (SniffModeInfo) clientRemoteInfo.getModeInfo();
+                SniffConnectionStrategy.SniffModeInfo serverModeInfo =
+                        (SniffConnectionStrategy.SniffModeInfo) serverRemoteInfo.getModeInfo();
+                assertThat(clientModeInfo.getMaxConnectionsPerCluster(), equalTo(serverModeInfo.getMaxConnectionsPerCluster()));
+                assertThat(clientModeInfo.getNumNodesConnected(), equalTo(serverModeInfo.getNumNodesConnected()));
+                assertThat(clientModeInfo.getSeedNodes(), equalTo(serverModeInfo.getSeedNodes()));
+            } else if (clientRemoteInfo.getModeInfo().modeName().equals(ProxyModeInfo.NAME)) {
+                ProxyModeInfo clientModeInfo =
+                        (ProxyModeInfo) clientRemoteInfo.getModeInfo();
+                ProxyConnectionStrategy.ProxyModeInfo serverModeInfo =
+                        (ProxyConnectionStrategy.ProxyModeInfo) serverRemoteInfo.getModeInfo();
+                assertThat(clientModeInfo.getAddress(), equalTo(serverModeInfo.getAddress()));
+                assertThat(clientModeInfo.getMaxSocketConnections(), equalTo(serverModeInfo.getMaxSocketConnections()));
+                assertThat(clientModeInfo.getNumSocketsConnected(), equalTo(serverModeInfo.getNumSocketsConnected()));
+            } else {
+                fail("impossible case");
+            }
+        }
+    }
+
+    private static RemoteConnectionInfo createRandomRemoteConnectionInfo() {
+        RemoteConnectionInfo.ModeInfo modeInfo;
+        if (randomBoolean()) {
+            String address = randomAlphaOfLength(8);
+            int maxSocketConnections = randomInt(5);
+            int numSocketsConnected = randomInt(5);
+            modeInfo = new ProxyConnectionStrategy.ProxyModeInfo(address, maxSocketConnections, numSocketsConnected);
+        } else {
+            List<String> seedNodes = randomList(randomInt(8), () -> randomAlphaOfLength(8));
+            int maxConnectionsPerCluster = randomInt(5);
+            int numNodesConnected = randomInt(5);
+            modeInfo = new SniffConnectionStrategy.SniffModeInfo(seedNodes, maxConnectionsPerCluster, numNodesConnected);
+        }
+        String clusterAlias = randomAlphaOfLength(8);
+        TimeValue initialConnectionTimeout = TimeValue.parseTimeValue(randomTimeValue(), "randomInitialConnectionTimeout");
+        boolean skipUnavailable = randomBoolean();
+        return new RemoteConnectionInfo(clusterAlias, modeInfo, initialConnectionTimeout, skipUnavailable);
+    }
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
index 48f7adda8445c..5e7da8142129d 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
@@ -19,11 +19,8 @@
 
 package org.elasticsearch.client.documentation;
 
-import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.LatchedActionListener;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
-import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsResponse;
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.support.ActiveShardCount;
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
@@ -57,8 +54,6 @@
 import org.elasticsearch.client.indices.CloseIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.client.indices.CreateIndexResponse;
-import org.elasticsearch.common.xcontent.XContentHelper;
-import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.test.rest.yaml.ObjectPath;
 import org.junit.Before;
 
@@ -76,21 +71,8 @@
 public class CCRDocumentationIT extends ESRestHighLevelClientTestCase {
 
     @Before
-    public void setupRemoteClusterConfig() throws IOException {
-        RestHighLevelClient client = highLevelClient();
-        // Configure local cluster as remote cluster:
-        // TODO: replace with nodes info highlevel rest client code when it is available:
-        final Request request = new Request("GET", "/_nodes");
-        Map<?, ?> nodesResponse = (Map<?, ?>) toMap(client().performRequest(request)).get("nodes");
-        // Select node info of first node (we don't know the node id):
-        nodesResponse = (Map<?, ?>) nodesResponse.get(nodesResponse.keySet().iterator().next());
-        String transportAddress = (String) nodesResponse.get("transport_address");
-
-        ClusterUpdateSettingsRequest updateSettingsRequest = new ClusterUpdateSettingsRequest();
-        updateSettingsRequest.transientSettings(Collections.singletonMap("cluster.remote.local.seeds", transportAddress));
-        ClusterUpdateSettingsResponse updateSettingsResponse =
-            client.cluster().putSettings(updateSettingsRequest, RequestOptions.DEFAULT);
-        assertThat(updateSettingsResponse.isAcknowledged(), is(true));
+    public void setupRemoteClusterConfig() throws Exception {
+        setupRemoteClusterConfig("local");
     }
 
     public void testPutFollow() throws Exception {
@@ -985,8 +967,4 @@ public void onFailure(Exception e) {
         }
     }
 
-    static Map<String, Object> toMap(Response response) throws IOException {
-        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
-    }
-
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
index 8b7f1577114b0..5cc7a4424fcaa 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ClusterClientDocumentationIT.java
@@ -31,6 +31,9 @@
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
 import org.elasticsearch.client.RequestOptions;
 import org.elasticsearch.client.RestHighLevelClient;
+import org.elasticsearch.client.cluster.RemoteConnectionInfo;
+import org.elasticsearch.client.cluster.RemoteInfoRequest;
+import org.elasticsearch.client.cluster.RemoteInfoResponse;
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.health.ClusterIndexHealth;
@@ -46,6 +49,7 @@
 
 import java.io.IOException;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
@@ -415,4 +419,60 @@ public void onFailure(Exception e) {
             assertTrue(latch.await(30L, TimeUnit.SECONDS));
         }
     }
+
+    public void testRemoteInfo() throws Exception {
+        setupRemoteClusterConfig("local_cluster");
+
+        RestHighLevelClient client = highLevelClient();
+
+        // tag::remote-info-request
+        RemoteInfoRequest request = new RemoteInfoRequest();
+        // end::remote-info-request
+
+        // tag::remote-info-execute
+        RemoteInfoResponse response = client.cluster().remoteInfo(request, RequestOptions.DEFAULT); // <1>
+        // end::remote-info-execute
+
+        // tag::remote-info-response
+        List<RemoteConnectionInfo> infos = response.getInfos();
+        // end::remote-info-response
+
+        assertThat(infos.size(), greaterThan(0));
+    }
+
+    public void testRemoteInfoAsync() throws Exception {
+        setupRemoteClusterConfig("local_cluster");
+
+        RestHighLevelClient client = highLevelClient();
+
+        // tag::remote-info-request
+        RemoteInfoRequest request = new RemoteInfoRequest();
+        // end::remote-info-request
+
+
+        // tag::remote-info-execute-listener
+            ActionListener<RemoteInfoResponse> listener =
+                new ActionListener<>() {
+                    @Override
+                    public void onResponse(RemoteInfoResponse response) {
+                        // <1>
+                    }
+
+                    @Override
+                    public void onFailure(Exception e) {
+                        // <2>
+                    }
+                };
+            // end::remote-info-execute-listener
+
+        // Replace the empty listener by a blocking listener in test
+        final CountDownLatch latch = new CountDownLatch(1);
+        listener = new LatchedActionListener<>(listener, latch);
+
+        // tag::health-execute-async
+            client.cluster().remoteInfoAsync(request, RequestOptions.DEFAULT, listener); // <1>
+        // end::health-execute-async
+
+        assertTrue(latch.await(30L, TimeUnit.SECONDS));
+    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
index a9852c405a49d..a458c3ec2551d 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/ILMDocumentationIT.java
@@ -19,7 +19,6 @@
 
 package org.elasticsearch.client.documentation;
 
-import org.apache.http.util.EntityUtils;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.LatchedActionListener;
 import org.elasticsearch.action.admin.cluster.repositories.put.PutRepositoryRequest;
@@ -28,7 +27,6 @@
 import org.elasticsearch.action.admin.indices.alias.Alias;
 import org.elasticsearch.client.ESRestHighLevelClientTestCase;
 import org.elasticsearch.client.RequestOptions;
-import org.elasticsearch.client.Response;
 import org.elasticsearch.client.RestHighLevelClient;
 import org.elasticsearch.client.core.AcknowledgedResponse;
 import org.elasticsearch.client.ilm.DeleteAction;
@@ -78,8 +76,6 @@
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.common.xcontent.XContentHelper;
-import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.repositories.fs.FsRepository;
 import org.elasticsearch.snapshots.SnapshotInfo;
 import org.elasticsearch.snapshots.SnapshotState;
@@ -1210,8 +1206,4 @@ public void onFailure(Exception e) {
         assertTrue(latch.await(30L, TimeUnit.SECONDS));
     }
 
-    static Map<String, Object> toMap(Response response) throws IOException {
-        return XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false);
-    }
-
 }
diff --git a/docs/java-rest/high-level/cluster/remote_info.asciidoc b/docs/java-rest/high-level/cluster/remote_info.asciidoc
new file mode 100644
index 0000000000000..6496a04a3a76c
--- /dev/null
+++ b/docs/java-rest/high-level/cluster/remote_info.asciidoc
@@ -0,0 +1,32 @@
+--
+:api: remote-info
+:request: RemoteInfoRequest
+:response: RemoteInfoResponse
+--
+
+[id="{upid}-{api}"]
+=== Remote Cluster Info API
+
+The Remote cluster info API allows to get all of the configured remote cluster information.
+
+[id="{upid}-{api}-request"]
+==== Remote Cluster Info Request
+
+A +{request}+:
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-request]
+--------------------------------------------------
+
+There are no required parameters.
+
+==== Remote Cluster Info Response
+
+The returned +{response}+ allows to retrieve remote cluster information.
+It returns connection and endpoint information keyed by the configured remote cluster alias.
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-response]
+--------------------------------------------------
diff --git a/docs/java-rest/high-level/supported-apis.asciidoc b/docs/java-rest/high-level/supported-apis.asciidoc
index 2191e795ebbb1..e0d228b5d1e4b 100644
--- a/docs/java-rest/high-level/supported-apis.asciidoc
+++ b/docs/java-rest/high-level/supported-apis.asciidoc
@@ -168,12 +168,14 @@ The Java High Level REST Client supports the following Cluster APIs:
 * <<java-rest-high-cluster-put-settings>>
 * <<java-rest-high-cluster-get-settings>>
 * <<java-rest-high-cluster-health>>
+* <<java-rest-high-cluster-remote-info>>
 
 :upid: {mainid}-cluster
 :doc-tests-file: {doc-tests}/ClusterClientDocumentationIT.java
 include::cluster/put_settings.asciidoc[]
 include::cluster/get_settings.asciidoc[]
 include::cluster/health.asciidoc[]
+include::cluster/remote_info.asciidoc[]
 
 == Ingest APIs
 The Java High Level REST Client supports the following Ingest APIs:
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
index 894cd9cf9fec4..9d72da7746974 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoResponse.java
@@ -39,7 +39,7 @@ public final class RemoteInfoResponse extends ActionResponse implements ToXConte
         infos = in.readList(RemoteConnectionInfo::new);
     }
 
-    RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
+    public RemoteInfoResponse(Collection<RemoteConnectionInfo> infos) {
         this.infos = List.copyOf(infos);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
index 78c9f5f28154d..14ca217ade1b8 100644
--- a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
@@ -268,13 +268,13 @@ private static TransportAddress resolveAddress(String address) {
         return new TransportAddress(parseConfiguredAddress(address));
     }
 
-    static class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
+    public static class ProxyModeInfo implements RemoteConnectionInfo.ModeInfo {
 
         private final String address;
         private final int maxSocketConnections;
         private final int numSocketsConnected;
 
-        ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
+        public ProxyModeInfo(String address, int maxSocketConnections, int numSocketsConnected) {
             this.address = address;
             this.maxSocketConnections = maxSocketConnections;
             this.numSocketsConnected = numSocketsConnected;
@@ -311,6 +311,18 @@ public String modeName() {
             return "proxy";
         }
 
+        public String getAddress() {
+            return address;
+        }
+
+        public int getMaxSocketConnections() {
+            return maxSocketConnections;
+        }
+
+        public int getNumSocketsConnected() {
+            return numSocketsConnected;
+        }
+
         @Override
         public RemoteConnectionStrategy.ConnectionStrategy modeType() {
             return RemoteConnectionStrategy.ConnectionStrategy.PROXY;
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
index e721a0b617fd1..152cafccb61e0 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionInfo.java
@@ -43,7 +43,7 @@ public final class RemoteConnectionInfo implements ToXContentFragment, Writeable
     final String clusterAlias;
     final boolean skipUnavailable;
 
-    RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
+    public RemoteConnectionInfo(String clusterAlias, ModeInfo modeInfo, TimeValue initialConnectionTimeout, boolean skipUnavailable) {
         this.clusterAlias = clusterAlias;
         this.modeInfo = modeInfo;
         this.initialConnectionTimeout = initialConnectionTimeout;
@@ -77,6 +77,18 @@ public String getClusterAlias() {
         return clusterAlias;
     }
 
+    public ModeInfo getModeInfo() {
+        return modeInfo;
+    }
+
+    public TimeValue getInitialConnectionTimeout() {
+        return initialConnectionTimeout;
+    }
+
+    public boolean isSkipUnavailable() {
+        return skipUnavailable;
+    }
+
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         // TODO: Change to 7.6 after backport
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index 97b5e318841d6..fcc4bde951dd0 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -465,13 +465,13 @@ private boolean proxyChanged(String oldProxy, String newProxy) {
         return Objects.equals(oldProxy, newProxy) == false;
     }
 
-    static class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
+    public static class SniffModeInfo implements RemoteConnectionInfo.ModeInfo {
 
         final List<String> seedNodes;
         final int maxConnectionsPerCluster;
         final int numNodesConnected;
 
-        SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
+        public SniffModeInfo(List<String> seedNodes, int maxConnectionsPerCluster, int numNodesConnected) {
             this.seedNodes = seedNodes;
             this.maxConnectionsPerCluster = maxConnectionsPerCluster;
             this.numNodesConnected = numNodesConnected;
@@ -512,6 +512,18 @@ public String modeName() {
             return "sniff";
         }
 
+        public List<String> getSeedNodes() {
+            return seedNodes;
+        }
+
+        public int getMaxConnectionsPerCluster() {
+            return maxConnectionsPerCluster;
+        }
+
+        public int getNumNodesConnected() {
+            return numNodesConnected;
+        }
+
         @Override
         public RemoteConnectionStrategy.ConnectionStrategy modeType() {
             return RemoteConnectionStrategy.ConnectionStrategy.SNIFF;
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
index 4d1848e5b3a98..e4c9eb0986b34 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
@@ -755,6 +755,19 @@ public static <T> T[] randomArray(int minArraySize, int maxArraySize, IntFunctio
         return array;
     }
 
+    public static <T> List<T> randomList(int maxListSize, Supplier<T> valueConstructor) {
+        return randomList(0, maxListSize, valueConstructor);
+    }
+
+    public static <T> List<T> randomList(int minListSize, int maxListSize, Supplier<T> valueConstructor) {
+        final int size = randomIntBetween(minListSize, maxListSize);
+        List<T> list = new ArrayList<>();
+        for (int i = 0; i < size; i++) {
+            list.add(valueConstructor.get());
+        }
+        return list;
+    }
+
 
     private static final String[] TIME_SUFFIXES = new String[]{"d", "h", "ms", "s", "m", "micros", "nanos"};
 

From 392d5e4f04bdceb08cd2c3b19b29c52bdaf96c39 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Tue, 24 Dec 2019 14:37:25 +0100
Subject: [PATCH 330/686] Adjusted test to use transient settings instead of
 default settings.

---
 .../test/java/org/elasticsearch/client/ClusterClientIT.java | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
index 45ba23c2a3745..09c8549d7258c 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ClusterClientIT.java
@@ -317,12 +317,12 @@ public void testRemoteInfo() throws Exception {
                 .getConcreteSettingForNamespace(clusterAlias)
                 .get(settingsResponse.getTransientSettings());
         int connectionsPerCluster = SniffConnectionStrategy.REMOTE_CONNECTIONS_PER_CLUSTER
-                .get(settingsResponse.getDefaultSettings());
+                .get(settingsResponse.getTransientSettings());
         TimeValue initialConnectionTimeout = RemoteClusterService.REMOTE_INITIAL_CONNECTION_TIMEOUT_SETTING
-                .get(settingsResponse.getDefaultSettings());
+                .get(settingsResponse.getTransientSettings());
         boolean skipUnavailable = RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE
                 .getConcreteSettingForNamespace(clusterAlias)
-                .get(settingsResponse.getDefaultSettings());
+                .get(settingsResponse.getTransientSettings());
 
         RemoteInfoRequest request = new RemoteInfoRequest();
         RemoteInfoResponse response = execute(request, highLevelClient().cluster()::remoteInfo,

From 96c6f30a7b0f18b6e816c3ea517881755da74240 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Tue, 24 Dec 2019 08:32:07 -0500
Subject: [PATCH 331/686] Adjust BWC for peer recovery retention leases
 (#50351)

Relates #50351
---
 .../upgrades/FullClusterRestartIT.java        |  6 ++--
 .../elasticsearch/upgrades/RecoveryIT.java    | 28 ++---------------
 .../index/seqno/ReplicationTracker.java       |  7 ++---
 .../test/rest/ESRestTestCase.java             | 31 +++++++++++++++++--
 4 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
index 67d3007e9af16..21ae48e9c77d4 100644
--- a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
+++ b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
@@ -1278,7 +1278,7 @@ public void testOperationBasedRecovery() throws Exception {
                 }
             }
             flush(index, true);
-            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, false);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
             // less than 10% of the committed docs (see IndexSetting#FILE_BASED_RECOVERY_THRESHOLD_SETTING).
             int uncommittedDocs = randomIntBetween(0, (int) (committedDocs * 0.1));
             for (int i = 0; i < uncommittedDocs; i++) {
@@ -1288,7 +1288,7 @@ public void testOperationBasedRecovery() throws Exception {
         } else {
             ensureGreen(index);
             assertNoFileBasedRecovery(index, n -> true);
-            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, true);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
         }
     }
 
@@ -1313,7 +1313,7 @@ public void testTurnOffTranslogRetentionAfterUpgraded() throws Exception {
             ensureGreen(index);
             flush(index, true);
             assertEmptyTranslog(index);
-            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, true);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
         }
     }
 }
diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index 429687853e897..080b15268db1d 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -511,28 +511,6 @@ private static Version indexVersionCreated(final String indexName) throws IOExce
         return Version.fromId(Integer.parseInt(ObjectPath.createFromResponse(response).evaluate(versionCreatedSetting)));
     }
 
-    /**
-     * Returns the minimum node version among all nodes of the cluster
-     */
-    private static Version minimumNodeVersion() throws IOException {
-        final Request request = new Request("GET", "_nodes");
-        request.addParameter("filter_path", "nodes.*.version");
-
-        final Response response = client().performRequest(request);
-        final Map<String, Object> nodes = ObjectPath.createFromResponse(response).evaluate("nodes");
-
-        Version minVersion = null;
-        for (Map.Entry<String, Object> node : nodes.entrySet()) {
-            @SuppressWarnings("unchecked")
-            Version nodeVersion = Version.fromString((String) ((Map<String, Object>) node.getValue()).get("version"));
-            if (minVersion == null || minVersion.after(nodeVersion)) {
-                minVersion = nodeVersion;
-            }
-        }
-        assertNotNull(minVersion);
-        return minVersion;
-    }
-
     /**
      * Asserts that an index is closed in the cluster state. If `checkRoutingTable` is true, it also asserts
      * that the index has started shards.
@@ -695,7 +673,7 @@ public void testOperationBasedRecovery() throws Exception {
             ensureGreen(index);
             indexDocs(index, 0, randomIntBetween(100, 200));
             flush(index, randomBoolean());
-            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, false);
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
             // uncommitted docs must be less than 10% of committed docs (see IndexSetting#FILE_BASED_RECOVERY_THRESHOLD_SETTING).
             indexDocs(index, randomIntBetween(0, 100), randomIntBetween(0, 3));
         } else {
@@ -705,9 +683,7 @@ public void testOperationBasedRecovery() throws Exception {
                 || nodeName.startsWith(CLUSTER_NAME + "-0")
                 || (nodeName.startsWith(CLUSTER_NAME + "-1") && Booleans.parseBoolean(System.getProperty("tests.first_round")) == false));
             indexDocs(index, randomIntBetween(0, 100), randomIntBetween(0, 3));
-            if (CLUSTER_TYPE == ClusterType.UPGRADED) {
-                ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index, true);
-            }
+            ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
         }
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
index bfe89a65d89df..aff85f10e4bf8 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
@@ -895,11 +895,10 @@ public ReplicationTracker(
         this.pendingInSync = new HashSet<>();
         this.routingTable = null;
         this.replicationGroup = null;
-        this.hasAllPeerRecoveryRetentionLeases = indexSettings.getIndexVersionCreated().onOrAfter(Version.V_8_0_0)
+        this.hasAllPeerRecoveryRetentionLeases = indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_6_0)
             || (indexSettings.isSoftDeleteEnabled() &&
-               (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_6_0) ||
-               (indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_4_0) &&
-                indexSettings.getIndexMetaData().getState() == IndexMetaData.State.OPEN)));
+                indexSettings.getIndexVersionCreated().onOrAfter(Version.V_7_4_0) &&
+                indexSettings.getIndexMetaData().getState() == IndexMetaData.State.OPEN);
 
         this.fileBasedRecoveryThreshold = IndexSettings.FILE_BASED_RECOVERY_THRESHOLD_SETTING.get(indexSettings.getSettings());
         this.safeCommitInfoSupplier = safeCommitInfoSupplier;
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index f10f444e918ed..d5da4320ab3ee 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -56,6 +56,7 @@
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.snapshots.SnapshotState;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.rest.yaml.ObjectPath;
 import org.hamcrest.Matchers;
 import org.junit.After;
 import org.junit.AfterClass;
@@ -1132,7 +1133,8 @@ public void assertEmptyTranslog(String index) throws Exception {
      * Peer recovery retention leases are renewed and synced to replicas periodically (every 30 seconds). This ensures
      * that we have renewed every PRRL to the global checkpoint of the corresponding copy and properly synced to all copies.
      */
-    public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index, boolean alwaysExists) throws Exception {
+    public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index) throws Exception {
+        boolean mustHavePRRLs = minimumNodeVersion().onOrAfter(Version.V_7_6_0);
         assertBusy(() -> {
             Map<String, Object> stats = entityAsMap(client().performRequest(new Request("GET", index + "/_stats?level=shards")));
             @SuppressWarnings("unchecked") Map<String, List<Map<String, ?>>> shards =
@@ -1140,10 +1142,11 @@ public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index, bool
             for (List<Map<String, ?>> shard : shards.values()) {
                 for (Map<String, ?> copy : shard) {
                     Integer globalCheckpoint = (Integer) XContentMapValues.extractValue("seq_no.global_checkpoint", copy);
+                    assertThat(XContentMapValues.extractValue("seq_no.max_seq_no", copy), equalTo(globalCheckpoint));
                     assertNotNull(globalCheckpoint);
                     @SuppressWarnings("unchecked") List<Map<String, ?>> retentionLeases =
                         (List<Map<String, ?>>) XContentMapValues.extractValue("retention_leases.leases", copy);
-                    if (alwaysExists == false && retentionLeases == null) {
+                    if (mustHavePRRLs == false && retentionLeases == null) {
                         continue;
                     }
                     assertNotNull(retentionLeases);
@@ -1152,7 +1155,7 @@ public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index, bool
                             assertThat(retentionLease.get("retaining_seq_no"), equalTo(globalCheckpoint + 1));
                         }
                     }
-                    if (alwaysExists) {
+                    if (mustHavePRRLs) {
                         List<String> existingLeaseIds = retentionLeases.stream().map(lease -> (String) lease.get("id"))
                             .collect(Collectors.toList());
                         List<String> expectedLeaseIds = shard.stream()
@@ -1165,4 +1168,26 @@ public void ensurePeerRecoveryRetentionLeasesRenewedAndSynced(String index, bool
             }
         }, 60, TimeUnit.SECONDS);
     }
+
+    /**
+     * Returns the minimum node version among all nodes of the cluster
+     */
+    protected static Version minimumNodeVersion() throws IOException {
+        final Request request = new Request("GET", "_nodes");
+        request.addParameter("filter_path", "nodes.*.version");
+
+        final Response response = client().performRequest(request);
+        final Map<String, Object> nodes = ObjectPath.createFromResponse(response).evaluate("nodes");
+
+        Version minVersion = null;
+        for (Map.Entry<String, Object> node : nodes.entrySet()) {
+            @SuppressWarnings("unchecked")
+            Version nodeVersion = Version.fromString((String) ((Map<String, Object>) node.getValue()).get("version"));
+            if (minVersion == null || minVersion.after(nodeVersion)) {
+                minVersion = nodeVersion;
+            }
+        }
+        assertNotNull(minVersion);
+        return minVersion;
+    }
 }

From 68668e073000411b739ad3a76396b35e54851c45 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Tue, 24 Dec 2019 15:39:56 +0100
Subject: [PATCH 332/686] Check watch count after stopping watcher in test
 teardown. Also disabled slm in smoke test watcher qa test.

Relates to #41172
---
 x-pack/qa/smoke-test-watcher/build.gradle                 | 3 ++-
 .../java/org/elasticsearch/smoketest/WatcherRestIT.java   | 8 ++++++++
 .../test/mustache/50_webhook_url_escaping.yml             | 8 --------
 3 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/x-pack/qa/smoke-test-watcher/build.gradle b/x-pack/qa/smoke-test-watcher/build.gradle
index 7bc68fee9f499..b3b638e938343 100644
--- a/x-pack/qa/smoke-test-watcher/build.gradle
+++ b/x-pack/qa/smoke-test-watcher/build.gradle
@@ -8,10 +8,11 @@ dependencies {
 
 testClusters.integTest {
   testDistribution = 'DEFAULT'
+  setting 'xpack.slm.enabled', 'false'
   setting 'xpack.ilm.enabled', 'false'
   setting 'xpack.security.enabled', 'false'
   setting 'xpack.monitoring.enabled', 'false'
   setting 'xpack.ml.enabled', 'false'
   setting 'xpack.license.self_generated.type', 'trial'
   setting 'logger.org.elasticsearch.xpack.watcher', 'DEBUG'
-}
\ No newline at end of file
+}
diff --git a/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/WatcherRestIT.java b/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/WatcherRestIT.java
index 63efe7ad781c8..a5068f39486db 100644
--- a/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/WatcherRestIT.java
+++ b/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/WatcherRestIT.java
@@ -7,6 +7,7 @@
 
 import com.carrotsearch.randomizedtesting.annotations.Name;
 import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+import org.elasticsearch.client.Request;
 import org.elasticsearch.test.rest.yaml.ClientYamlTestCandidate;
 import org.elasticsearch.test.rest.yaml.ClientYamlTestResponse;
 import org.elasticsearch.test.rest.yaml.ESClientYamlSuiteTestCase;
@@ -19,6 +20,7 @@
 import static java.util.Collections.emptyList;
 import static java.util.Collections.emptyMap;
 import static java.util.Collections.singletonMap;
+import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 
 /** Runs rest tests against external cluster */
@@ -70,6 +72,10 @@ public void startWatcher() throws Exception {
 
     @After
     public void stopWatcher() throws Exception {
+        Request deleteWatchesIndexRequest = new Request("DELETE", "/.watches");
+        deleteWatchesIndexRequest.addParameter("ignore_unavailable", "true");
+        adminClient().performRequest(deleteWatchesIndexRequest);
+
         assertBusy(() -> {
             ClientYamlTestResponse response =
                 getAdminExecutionContext().callApi("watcher.stats", emptyMap(), emptyList(), emptyMap());
@@ -77,6 +83,8 @@ public void stopWatcher() throws Exception {
 
             switch (state) {
                 case "stopped":
+                    int watcherCount = (int) response.evaluate("stats.0.watch_count");
+                    assertThat(watcherCount, equalTo(0));
                     // all good here, we are done
                     break;
                 case "stopping":
diff --git a/x-pack/qa/smoke-test-watcher/src/test/resources/rest-api-spec/test/mustache/50_webhook_url_escaping.yml b/x-pack/qa/smoke-test-watcher/src/test/resources/rest-api-spec/test/mustache/50_webhook_url_escaping.yml
index 88986a5546c7c..0ed3cfe04480f 100644
--- a/x-pack/qa/smoke-test-watcher/src/test/resources/rest-api-spec/test/mustache/50_webhook_url_escaping.yml
+++ b/x-pack/qa/smoke-test-watcher/src/test/resources/rest-api-spec/test/mustache/50_webhook_url_escaping.yml
@@ -1,9 +1,5 @@
 ---
 "Test url escaping with url mustache function":
-  - do:
-      cluster.health:
-          wait_for_status: yellow
-
   - do:
       index:
         index:   <date-index-{now/d}>
@@ -11,10 +7,6 @@
         refresh: true
         body:    { foo: bar }
 
-  - do: {watcher.stats:{}}
-  - match: { "stats.0.watcher_state": "started" }
-  - match: { "stats.0.watch_count": 0 }
-
   # extract http host and port from master node
   - do:
       cluster.state: {}

From 3d71812b12d6ccecaac2cc694c8815726474b868 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Tue, 24 Dec 2019 08:34:03 -0800
Subject: [PATCH 333/686] [DOCS] Remove redundant results from ML APIs (#50477)

---
 .../apis/delete-calendar-job.asciidoc         |   6 +-
 .../apis/delete-forecast.asciidoc             |  10 +-
 .../apis/get-bucket.asciidoc                  |   5 +-
 .../apis/get-calendar-event.asciidoc          |  17 +-
 .../apis/get-calendar.asciidoc                |  21 +-
 .../apis/get-category.asciidoc                |   8 +-
 .../apis/get-datafeed-stats.asciidoc          |  22 +-
 .../apis/get-datafeed.asciidoc                |  55 +---
 .../apis/get-filter.asciidoc                  |  24 +-
 .../apis/get-influencer.asciidoc              |   5 +-
 .../apis/get-job-stats.asciidoc               |  96 +++----
 .../anomaly-detection/apis/get-job.asciidoc   |  64 +----
 .../apis/get-record.asciidoc                  |   5 +-
 .../apis/post-calendar-event.asciidoc         |   8 +-
 .../apis/put-datafeed.asciidoc                |   5 +-
 .../anomaly-detection/apis/put-job.asciidoc   | 139 ++++++++++
 .../apis/update-job.asciidoc                  |  71 +++++-
 .../apis/validate-detector.asciidoc           |  75 +++++-
 docs/reference/ml/ml-shared.asciidoc          | 241 +++++-------------
 19 files changed, 459 insertions(+), 418 deletions(-)

diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
index dfe56c9388d84..6b705b8c6f932 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
@@ -24,11 +24,11 @@ Deletes {anomaly-jobs} from a calendar.
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-  (Required, string) Identifier for the calendar.
+(Required, string) Identifier for the calendar.
 
 `<job_id>`::
-  (Required, string) An identifier for the {anomaly-jobs}. It can be a job
-  identifier, a group name, or a comma-separated list of jobs or groups.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-list]
 
 [[ml-delete-calendar-job-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
index e269d532b0c27..80eb03c75b59d 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
@@ -41,12 +41,14 @@ For more information, see
 ==== {api-path-parms-title}
 
 `<forecast_id>`::
-  (Optional, string) A comma-separated list of forecast identifiers. 
-  If you do not specify this optional parameter or if you specify `_all`, the 
-  API deletes all forecasts from the job. 
+(Optional, string) A comma-separated list of forecast identifiers. If you do not
+specify this optional parameter or if you specify `_all`, the API deletes all
+forecasts from the job. 
   
 `<job_id>`::
-  (Required, string) Required. Identifier for the job.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+  
 
 [[ml-delete-forecast-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
index f06632bcbd54f..a34d6bc714a99 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
@@ -63,10 +63,9 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 `expand`::
 (Optional, boolean) If true, the output includes anomaly records.
 
-`page`::
-`page`.`from`:::
+`page`.`from`::
 (Optional, integer) Skips the specified number of buckets.
-`page`.`size`:::
+`page`.`size`::
 (Optional, integer) Specifies the maximum number of buckets to obtain.
 
 `sort`::
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
index 7824c08e1da41..f3fcd65aab210 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
@@ -56,27 +56,24 @@ For more information, see
 [[ml-get-calendar-event-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of scheduled event resources, which have the
+following properties:
 
-`events`::
-  (array) An array of scheduled event resources. An events resource has the
-  following properties:
-
-  `calendar_id`:::
+`calendar_id`::
     (string) An identifier for the calendar that contains the scheduled
     event. 
 
-  `description`:::
+`description`::
     (string) A description of the scheduled event.
 
-  `end_time`:::
+`end_time`::
     (date) The timestamp for the end of the scheduled event
     in milliseconds since the epoch or ISO 8601 format.
 
-  `event_id`:::
+`event_id`::
     (string) An automatically-generated identifier for the scheduled event.
 
-  `start_time`:::
+`start_time`::
    (date) The timestamp for the beginning of the scheduled event
    in milliseconds since the epoch or ISO 8601 format.
 
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
index f2243825b81f0..0d0d85090df69 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
@@ -40,27 +40,24 @@ For more information, see
 [[ml-get-calendar-request-body]]
 ==== {api-request-body-title}
 
-`page`::
-`from`:::
+`page`.`from`::
     (Optional, integer) Skips the specified number of calendars.
 
-`size`:::
+`page`.`size`::
     (Optional, integer) Specifies the maximum number of calendars to obtain.
 
 [[ml-get-calendar-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
+The API returns an array of calendar resources, which have the following
+properties:
 
-`calendars`::
-  (array) An array of calendar resources. A calendar resource has the following
-  properties:
-  `calendar_id`:::
-    (string) A numerical character string that uniquely identifies the calendar.
+`calendar_id`::
+(string) A numerical character string that uniquely identifies the calendar.
 
-  `job_ids`:::
-    (array) An array of {anomaly-job} identifiers. For example:
-    `["total-requests"]`.
+`job_ids`::
+(array) An array of {anomaly-job} identifiers. For example:
+`["total-requests"]`.
 
 [[ml-get-calendar-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
index 97acffbc4a198..66b71558e432f 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
@@ -53,10 +53,9 @@ parameter, the API returns information about all categories in the {anomaly-job}
 [[ml-get-category-request-body]]
 ==== {api-request-body-title}
 
-`page`::
-`page`.`from`:::
+`page`.`from`::
 (Optional, integer) Skips the specified number of categories.
-`page`.`size`:::
+`page`.`size`::
 (Optional, integer) Specifies the maximum number of categories to obtain.
 
 [[ml-get-category-results]]
@@ -72,7 +71,8 @@ The API returns an array of category objects, which have the following propertie
 
 `grok_pattern`::
 experimental[] (string) A Grok pattern that could be used in {ls} or an ingest 
-pipeline to extract fields from messages that match the category. This field is experimental and may be changed or removed in a future release. The Grok
+pipeline to extract fields from messages that match the category. This field is
+experimental and may be changed or removed in a future release. The Grok
 patterns that are found are not optimal, but are often a good starting point for
 manual tweaking.
 
diff --git a/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
index feccd52364f48..695c16761a623 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
@@ -47,8 +47,11 @@ IMPORTANT: This API returns a maximum of 10,000 {dfeeds}.
 `<feed_id>`::
 (Optional, string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
++
+--
 If you do not specify one of these options, the API returns information about
 all {dfeeds}.
+--
 
 [[ml-get-datafeed-stats-query-parms]]
 ==== {api-query-parms-title}
@@ -72,13 +75,14 @@ informational; you cannot update their values.
 include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 `node`::
-(object) For started {dfeeds} only, the node upon which the {dfeed} is started. The {dfeed} and job will be on the same node.
-`id`::: The unique identifier of the node. For example, "0-o0tOoRTwKFZifatTWKNw".
-`name`::: The node name. For example, `0-o0tOo`.
-`ephemeral_id`::: The node ephemeral ID.
-`transport_address`::: The host and port where transport HTTP connections are
+(object) For started {dfeeds} only, the node upon which the {dfeed} is started.
+The {dfeed} and job will be on the same node.
+`node`.`id`::: The unique identifier of the node. For example, "0-o0tOoRTwKFZifatTWKNw".
+`node`.`name`::: The node name. For example, `0-o0tOo`.
+`node`.`ephemeral_id`::: The node ephemeral ID.
+`node`.`transport_address`::: The host and port where transport HTTP connections are
 accepted. For example, `127.0.0.1:9300`.
-`attributes`::: For example, `{"ml.machine_memory": "17179869184"}`.
+`node`.`attributes`::: For example, `{"ml.machine_memory": "17179869184"}`.
 
 `state`::
 (string) The status of the {dfeed}, which can be one of the following values:
@@ -95,10 +99,10 @@ this {dfeed}.
 //average_search_time_per_bucket_ms
 //bucket_count
 //exponential_average_search_time_per_hour_ms
-`job_id`:::
+`timing_stats`.`job_id`:::
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
-`search_count`::: Number of searches performed by this {dfeed}.
-`total_search_time_ms`::: Total time the {dfeed} spent searching in milliseconds.
+`timing_stats`.`search_count`::: Number of searches performed by this {dfeed}.
+`timing_stats`.`total_search_time_ms`::: Total time the {dfeed} spent searching in milliseconds.
 
 
 [[ml-get-datafeed-stats-response-codes]]
diff --git a/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
index 11aca1edd95e1..368824aea6d51 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
@@ -44,8 +44,11 @@ IMPORTANT: This API returns a maximum of 10,000 {dfeeds}.
 `<feed_id>`::
 (Optional, string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
++
+--
 If you do not specify one of these options, the API returns information about
 all {dfeeds}.
+--
 
 [[ml-get-datafeed-query-parms]]
 ==== {api-query-parms-title}
@@ -57,56 +60,8 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
 [[ml-get-datafeed-results]]
 ==== {api-response-body-title}
 
-The API returns an array of {dfeed} resources, which have the following
-properties:
-
-`aggregations`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=aggregations]
-
-`chunking_config`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=chunking-config]
-
-`datafeed_id`::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
-
-`delayed_data_check_config`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
-
-`frequency`::
-(<<time-units,time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=frequency]
-
-`indices`::
-(array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=indices]
-
-`job_id`::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-datafeed]
-
-`max_empty_searches`::
-(integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=max-empty-searches]
-
-`query`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=query]
-
-`query_delay`::
-(<<time-units,time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=query-delay]
-
-`script_fields`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=script-fields]
-
-`scroll_size`::
-(unsigned integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
+The API returns an array of {dfeed} resources. For the full list of properties,
+see <<ml-put-datafeed-request-body,create {dfeeds} API>>.
 
 [[ml-get-datafeed-response-codes]]
 ==== {api-response-codes-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
index 6852ca7716d07..d53155681c7fa 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
@@ -37,28 +37,26 @@ You can get a single filter or all filters. For more information, see
 [[ml-get-filter-query-parms]]
 ==== {api-query-parms-title}
 
-`from`:::
+`from`::
     (Optional, integer) Skips the specified number of filters.
 
-`size`:::
+`size`::
     (Optional, integer) Specifies the maximum number of filters to obtain.
 
 [[ml-get-filter-results]]
 ==== {api-response-body-title}
 
-The API returns the following information:
-
-`filters`::
-  (array) An array of filter resources. A filter resource has the following
-  properties:
-  `filter_id`:::
-  (string) A string that uniquely identifies the filter.
+The API returns an array of filter resources, which have the following
+properties:
   
-  `description`:::
-  (string) A description of the filter.
+`description`::
+(string) A description of the filter.
+
+`filter_id`::
+(string) A string that uniquely identifies the filter.
   
-  `items`:::
-  (array of strings) An array of strings which is the filter item list.
+`items`::
+(array of strings) An array of strings which is the filter item list.
 
 [[ml-get-filter-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
index e2727a04dc07c..dd9be3652b3d2 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
@@ -55,10 +55,9 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 (Optional, double) Returns influencers with anomaly scores greater than or
 equal to this value.
 
-`page`::
-`from`:::
+`page`.`from`::
 (Optional, integer) Skips the specified number of influencers.
-`size`:::
+`page`.`size`::
 (Optional, integer) Specifies the maximum number of influencers to obtain.
 
 `sort`::
diff --git a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
index 4ef7704fe9fd0..9b9038abaa95b 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
@@ -66,51 +66,51 @@ related error counts. The `data_count` values are cumulative for the lifetime of
 a job. If a model snapshot is reverted or old results are deleted, the job
 counts are not reset.
 
-`bucket_count`:::
+`data_counts`.`bucket_count`:::
 (long) The number of bucket results produced by the job.
 
-`earliest_record_timestamp`:::
+`data_counts`.`earliest_record_timestamp`:::
 (date) The timestamp of the earliest chronologically input document.
 
-`empty_bucket_count`:::
+`data_counts`.`empty_bucket_count`:::
 (long) The number of buckets which did not contain any data. If your data
 contains many empty buckets, consider increasing your `bucket_span` or using
 functions that are tolerant to gaps in data such as `mean`, `non_null_sum` or
 `non_zero_count`.
 
-`input_bytes`:::
+`data_counts`.`input_bytes`:::
 (long) The number of bytes of input data posted to the job.
 
-`input_field_count`:::
+`data_counts`.`input_field_count`:::
 (long) The total number of fields in input documents posted to the job. This
 count includes fields that are not used in the analysis. However, be aware that
 if you are using a {dfeed}, it extracts only the required fields from the
 documents it retrieves before posting them to the job.
 
-`input_record_count`:::
+`data_counts`.`input_record_count`:::
 (long) The number of input documents posted to the job.
 
-`invalid_date_count`:::
+`data_counts`.`invalid_date_count`:::
 (long) The number of input documents with either a missing date field or a date
 that could not be parsed.
 
-`job_id`:::
+`data_counts`.`job_id`:::
 (string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
-`last_data_time`:::
+`data_counts`.`last_data_time`:::
 (date) The timestamp at which data was last analyzed, according to server time.
 
-`latest_empty_bucket_timestamp`:::
+`data_counts`.`latest_empty_bucket_timestamp`:::
 (date) The timestamp of the last bucket that did not contain any data.
 
-`latest_record_timestamp`:::
+`data_counts`.`latest_record_timestamp`:::
 (date) The timestamp of the latest chronologically input document.
 
-`latest_sparse_bucket_timestamp`:::
+`data_counts`.`latest_sparse_bucket_timestamp`:::
 (date) The timestamp of the last bucket that was considered sparse.
 
-`missing_field_count`:::
+`data_counts`.`missing_field_count`:::
 (long) The number of input documents that are missing a field that the job is
 configured to analyze. Input documents with missing fields are still processed
 because it is possible that not all fields are missing. The value of
@@ -123,26 +123,26 @@ necessarily a cause for concern.
 
 --
 
-`out_of_order_timestamp_count`:::
+`data_counts`.`out_of_order_timestamp_count`:::
 (long) The number of input documents that are out of time sequence and outside
 of the latency window. This information is applicable only when you provide data
 to the job by using the <<ml-post-data,post data API>>. These out of order
 documents are  discarded, since jobs require time series data to be in ascending
 chronological order.
 
-`processed_field_count`:::
+`data_counts`.`processed_field_count`:::
 (long) The total number of fields in all the documents that have been processed
 by the job. Only fields that are specified in the detector configuration object
 contribute to this count. The timestamp is not included in this count.
 
-`processed_record_count`:::
+`data_counts`.`processed_record_count`:::
 (long) The number of input documents that have been processed by the job. This
 value includes documents with missing fields, since they are nonetheless
 analyzed. If you use {dfeeds} and have aggregations in your search query, the
 `processed_record_count` will be the number of aggregation results processed,
 not the number of {es} documents.
 
-`sparse_bucket_count`:::
+`data_counts`.`sparse_bucket_count`:::
 (long) The number of buckets that contained few data points compared to the
 expected number of data points. If your data contains many sparse buckets,
 consider using a longer `bucket_span`.
@@ -157,24 +157,24 @@ NOTE: Unless there is at least one forecast, `memory_bytes`, `records`,
 
 --
 
-`forecasted_jobs`:::
+`forecasts_stats`.`forecasted_jobs`:::
 (long) The number of jobs that have at least one forecast.
 
-`memory_bytes`:::
+`forecasts_stats`.`memory_bytes`:::
 (object) Statistics about the memory usage: minimum, maximum, average and total.
 
-`records`:::
+`forecasts_stats`.`records`:::
 (object) Statistics about the number of forecast records: minimum, maximum,
 saverage and total.
 
-`processing_time_ms`:::
+`forecasts_stats`.`processing_time_ms`:::
 (object) Statistics about the forecast runtime in milliseconds: minimum, maximum,
 average and total.
 
-`status`:::
+`forecasts_stats`.`status`:::
 (object) Counts per forecast status. For example: `{"finished" : 2}`. 
 
-`total`:::
+`forecasts_stats`.`total`:::
 (long) The number of forecasts currently available for this model.
 
 `job_id`::
@@ -185,19 +185,19 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 (object) An object that provides information about the size and contents of the
 model. It has the following properties:
  
-`bucket_allocation_failures_count`:::
+`model_size_stats`.`bucket_allocation_failures_count`:::
 (long) The number of buckets for which new entities in incoming data were not
 processed due to insufficient model memory. This situation is also signified
 by a `hard_limit: memory_status` property value.
 
-`job_id`:::
+`model_size_stats`.`job_id`:::
 (string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
-`log_time`:::
+`model_size_stats`.`log_time`:::
 (date) The timestamp of the `model_size_stats` according to server time.
 
-`memory_status`:::
+`model_size_stats`.`memory_status`:::
 (string) The status of the mathematical models. This property can have one of
 the following values:
 +
@@ -209,22 +209,22 @@ and older unused models will be pruned to free up space.
 As a result, not all incoming data was processed.
 --
 
-`model_bytes`:::
+`model_size_stats`.`model_bytes`:::
 (long) The number of bytes of memory used by the models. This is the maximum
 value since the last time the model was persisted. If the job is closed,
 this value indicates the latest size.
 
-`model_bytes_exceeded`:::
+`model_size_stats`.`model_bytes_exceeded`:::
  (long) The number of bytes over the high limit for memory usage at the last
  allocation failure.
 
-`model_bytes_memory_limit`:::
+`model_size_stats`.`model_bytes_memory_limit`:::
 (long) The upper limit for memory usage, checked on increasing values.
 
-`result_type`:::
+`model_size_stats`.`result_type`:::
 (string) For internal use. The type of result.
 
-`total_by_field_count`:::
+`model_size_stats`.`total_by_field_count`:::
 (long) The number of `by` field values that were analyzed by the models.
 +
 --
@@ -233,7 +233,7 @@ partition.
 
 --
 
-`total_over_field_count`:::
+`model_size_stats`.`total_over_field_count`:::
 (long) The number of `over` field values that were analyzed by the models.
 +
 --
@@ -242,10 +242,10 @@ partition.
 
 --
 
-`total_partition_field_count`:::
+`model_size_stats`.`total_partition_field_count`:::
 (long) The number of `partition` field values that were analyzed by the models.
 
-`timestamp`:::
+`model_size_stats`.`timestamp`:::
 (date) The timestamp of the `model_size_stats` according to the timestamp of the
 data.
 
@@ -253,20 +253,20 @@ data.
 (object) Contains properties for the node that runs the job. This information is
 available only for open jobs.
 
-`attributes`:::
+`node`.`attributes`:::
 (object) Lists node attributes. For example,
 `{"ml.machine_memory": "17179869184", "ml.max_open_jobs" : "20"}`.
   
-`ephemeral_id`:::
+`node`.`ephemeral_id`:::
 (string) The ephemeral ID of the node.
 
-`id`:::
+`node`.`id`:::
 (string) The unique identifier of the node.
 
-`name`:::
+`node`.`name`:::
 (string) The node name.
 
-`transport_address`:::
+`node`.`transport_address`:::
 (string) The host and port where transport HTTP connections are accepted.
 
 `open_time`::
@@ -295,31 +295,31 @@ then re-opened.
 (object) An object that provides statistical information about timing aspect of
 this job. It has the following properties:
 
-`average_bucket_processing_time_ms`:::
+`timing_stats`.`average_bucket_processing_time_ms`:::
 (double) Average of all bucket processing times in milliseconds.
 
-`bucket_count`:::
+`timing_stats`.`bucket_count`:::
 (long) The number of buckets processed.
 
-`exponential_average_bucket_processing_time_ms`:::
+`timing_stats`.`exponential_average_bucket_processing_time_ms`:::
 (double) Exponential moving average of all bucket processing times in
 milliseconds.
 
-`exponential_average_bucket_processing_time_per_hour_ms`:::
+`timing_stats`.`exponential_average_bucket_processing_time_per_hour_ms`:::
 (double) Exponentially-weighted moving average of bucket processing times
 calculated in a 1 hour time window.
 
-`job_id`:::
+`timing_stats`.`job_id`:::
 (string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
-`maximum_bucket_processing_time_ms`:::
+`timing_stats`.`maximum_bucket_processing_time_ms`:::
 (double) Maximum among all bucket processing times in milliseconds.
 
-`minimum_bucket_processing_time_ms`:::
+`timing_stats`.`minimum_bucket_processing_time_ms`:::
 (double) Minimum among all bucket processing times in milliseconds.
 
-`total_bucket_processing_time_ms`:::
+`timing_stats`.`total_bucket_processing_time_ms`:::
 (double) Sum of all bucket processing times in milliseconds.
 
 [[ml-get-job-stats-response-codes]]
diff --git a/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
index 7aeafde9ee884..5f4da902734fe 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
@@ -54,87 +54,27 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 [[ml-get-job-results]]
 ==== {api-response-body-title}
 
-The API returns an array of {anomaly-job} resources, which have the following
-properties:
-
-`allow_lazy_open`::
-(boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
-
-[[get-analysisconfig]]`analysis_config`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-config]
-
-[[get-analysislimits]]`analysis_limits`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-limits]
-
-`background_persist_interval`::
-(time units)
-include::{docdir}/ml/ml-shared.asciidoc[tag=background-persist-interval]
+The API returns an array of {anomaly-job} resources. For the full list of
+properties, see <<ml-put-job-request-body,create {anomaly-jobs} API>>.
 
 `create_time`::
 (string) The time the job was created. For example, `1491007356077`. This
 property is informational; you cannot change its value.
-
-[[get-customsettings]]`custom_settings`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-settings]
-
-[[get-datadescription]]`data_description`:: 
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=data-description]
-
-`description`::
-(string) An optional description of the job.
   
 `finished_time`::
 (string) If the job closed or failed, this is the time the job finished,
 otherwise it is `null`. This property is informational; you cannot change its
 value.
 
-`groups`::
-(array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
-
-`job_id`::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-define]
-+
---
-This property is informational; you cannot change the identifier for existing
-jobs.
---
-
 `job_type`::
 (string) Reserved for future use, currently set to `anomaly_detector`.
 
 `job_version`::
 (string) The version of {es} that existed on the node when the job was created.
 
-[[get-modelplotconfig]]`model_plot_config`::
-(object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config]
-
 `model_snapshot_id`::
 (string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-id]
-+
---
-This property is informational; you cannot change its value. 
---
-
-`model_snapshot_retention_days`::
-(long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
-
-`renormalization_window_days`::
-(long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=renormalization-window-days]
-
-`results_index_name`::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=results-index-name]
 
 [[ml-get-job-response-codes]]
 ==== {api-response-codes-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
index 7e56fc757cb79..91cc1fa69d046 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
@@ -59,10 +59,9 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=desc-results]
 (Optional, boolean)
 include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 
-`page`::
-`page`.`from`:::
+`page`.`from`::
 (Optional, integer) Skips the specified number of records.
-`page`.`size`:::
+`page`.`size`::
 (Optional, integer) Specifies the maximum number of records to obtain.
 
 `record_score`::
diff --git a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
index c241e7acdeb57..8a621f1faafff 100644
--- a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
@@ -40,18 +40,18 @@ of which must have a start time, end time, and description.
 	and end times may be specified as integer milliseconds since the epoch or as a
 	string in ISO 8601 format. An event resource has the following properties:
 
-	`calendar_id`:::
+`events`.`calendar_id`:::
 	  (Optional, string) An identifier for the calendar that contains the scheduled
 	  event.
 
-	`description`:::
+`events`.`description`:::
 	  (Optional, string) A description of the scheduled event.
 
-	`end_time`:::
+`events`.`end_time`:::
 	  (Required, date) The timestamp for the end of the scheduled event
 	  in milliseconds since the epoch or ISO 8601 format.
 
-	`start_time`:::
+`events`.`start_time`:::
 	 (Required, date) The timestamp for the beginning of the scheduled event
 	 in milliseconds since the epoch or ISO 8601 format.
 
diff --git a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
index cb3765a86c97e..a5a168b9f9c14 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
@@ -69,10 +69,13 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=frequency]
 (Required, array)
 include::{docdir}/ml/ml-shared.asciidoc[tag=indices]
 
-
 `job_id`::
 (Required, string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+
+`max_empty_searches`::
+(Optional,integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=max-empty-searches]
  
 `query`::
 (Optional, object)
diff --git a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
index 15f4ae3466968..16c14c5faae41 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
@@ -46,9 +46,140 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
 (Required, object)
 include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-config]
 
+`analysis_config`.`bucket_span`:::
+(<<time-units,time units>>)
+include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span]
+
+`analysis_config`.`categorization_field_name`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-field-name]
+
+`analysis_config`.`categorization_filters`:::
+(array of strings)
+include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-filters]
+
+`analysis_config`.`categorization_analyzer`:::
+(object or string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-analyzer]
+
+`analysis_config`.`detectors`:::
+(array) An array of detector configuration objects. Detector configuration
+objects specify which data fields a job analyzes. They also specify which
+analytical functions are used. You can specify multiple detectors for a job. 
++
+--
+NOTE: If the `detectors` array does not contain at least one detector,
+no analysis can occur and an error is returned.
+
+A detector has the following properties:
+--
+
+`analysis_config`.`detectors`.`by_field_name`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=by-field-name]
+
+`analysis_config`.`detectors`.`custom_rules`::::
++
+--
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
+
+`analysis_config`.`detectors`.`custom_rules`.`actions`:::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-actions]
+
+`analysis_config`.`detectors`.`custom_rules`.`scope`:::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope]
+
+`analysis_config`.`detectors`.`custom_rules`.`scope`.`filter_id`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-id]
+
+`analysis_config`.`detectors`.`custom_rules`.`scope`.`filter_type`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
+
+`analysis_config`.`detectors`.`custom_rules`.`conditions`:::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions]
+
+`analysis_config`.`detectors`.`custom_rules`.`conditions`.`applies_to`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-applies-to]
+
+`analysis_config`.`detectors`.`custom_rules`.`conditions`.`operator`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-operator]
+
+`analysis_config`.`detectors`.`custom_rules`.`conditions`.`value`::::
+(double)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
+--
+
+`analysis_config`.`detectors`.`detector_description`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
+
+`analysis_config`.`detectors`.`detector_index`::::
+(integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+
+`analysis_config`.`detectors`.`exclude_frequent`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-frequent]
+
+`analysis_config`.`detectors`.`field_name`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-field-name]
+
+`analysis_config`.`detectors`.`function`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=function]
+
+`analysis_config`.`detectors`.`over_field_name`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=over-field-name]
+
+`analysis_config`.`detectors`.`partition_field_name`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=partition-field-name]
+
+`analysis_config`.`detectors`.`use_null`::::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=use-null]
+
+`analysis_config`.`influencers`:::
+(array of strings)
+include::{docdir}/ml/ml-shared.asciidoc[tag=influencers]
+
+`analysis_config`.`latency`:::
+(time units)
+include::{docdir}/ml/ml-shared.asciidoc[tag=latency]
+
+`analysis_config`.`multivariate_by_fields`:::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=multivariate-by-fields]
+
+`analysis_config`.`summary_count_field_name`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=summary-count-field-name]
+
 [[put-analysislimits]]`analysis_limits`::
 (Optional, object)
 include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-limits]
++
+--
+The `analysis_limits` object has the following properties:
+--
+
+`analysis_limits`.`categorization_examples_limit`:::
+(long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-examples-limit]
+
+`analysis_limits`.`model_memory_limit`:::
+(long or string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
 
 `background_persist_interval`::
 (Optional, <<time-units, time units>>)
@@ -73,6 +204,14 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
 (Optional, object)
 include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config]
 
+`model_plot_config`.`enabled`:::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config-enabled]
+
+`model_plot_config`.`terms`:::
+experimental[] (string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config-terms]
+
 `model_snapshot_retention_days`::
 (Optional, long)
 include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
diff --git a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
index 3a417b6a0fc38..dff75da52f841 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
@@ -43,19 +43,7 @@ close the job, then reopen the job and restart the {dfeed} for the changes to ta
 
 --
 
-`detectors`::
-`custom_rules`:::
-(array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
-`description`:::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
-`detector_index`:::
-(integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
-
-[[update-analysislimits]]`analysis_limits`::
-`model_memory_limit`:::
+[[update-analysislimits]]`analysis_limits`.`model_memory_limit`::
 (long or string) 
 include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
 +
@@ -87,6 +75,55 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=custom-settings]
 `description`::
 (string) A description of the job.
 
+`detectors`::
+(array) An array of detector update objects.
+
+`detectors`.`custom_rules`:::
++
+--
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
+
+`detectors`.`custom_rules`.`actions`:::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-actions]
+
+`detectors`.`custom_rules`.`scope`:::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope]
+
+`detectors`.`custom_rules`.`scope`.`filter_id`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-id]
+
+`detectors`.`custom_rules`.`scope`.`filter_type`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
+
+`detectors`.`custom_rules`.`conditions`:::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions]
+
+`detectors`.`custom_rules`.`conditions`.`applies_to`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-applies-to]
+
+`detectors`.`custom_rules`.`conditions`.`operator`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-operator]
+
+`detectors`.`custom_rules`.`conditions`.`value`::::
+(double)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
+--
+
+`detectors`.`description`:::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
+`detectors`.`detector_index`:::
+(integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+
 `groups`::
 (array of strings)
 include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
@@ -95,6 +132,14 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
 (object)
 include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config]
 
+`model_plot_config`.`enabled`:::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config-enabled]
+
+`model_plot_config`.`terms`:::
+experimental[] (string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config-terms]
+
 `model_snapshot_retention_days`::
 (long)
 include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
diff --git a/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
index cb811f247a1c7..247eb32b10dc7 100644
--- a/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
@@ -29,7 +29,80 @@ before you create an {anomaly-job}.
 [[ml-valid-detector-request-body]]
 ==== {api-request-body-title}
 
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector]
+`by_field_name`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=by-field-name]
+
+`custom_rules`::
++
+--
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
+
+`analysis_config`.`detectors`.`custom_rules`.`actions`:::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-actions]
+
+`analysis_config`.`detectors`.`custom_rules`.`scope`:::
+(object)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope]
+
+`analysis_config`.`detectors`.`custom_rules`.`scope`.`filter_id`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-id]
+
+`analysis_config`.`detectors`.`custom_rules`.`scope`.`filter_type`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
+
+`analysis_config`.`detectors`.`custom_rules`.`conditions`:::
+(array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions]
+
+`analysis_config`.`detectors`.`custom_rules`.`conditions`.`applies_to`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-applies-to]
+
+`analysis_config`.`detectors`.`custom_rules`.`conditions`.`operator`::::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-operator]
+
+`analysis_config`.`detectors`.`custom_rules`.`conditions`.`value`::::
+(double)
+include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
+--
+
+`detector_description`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
+
+`detector_index`::
+(integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+
+`exclude_frequent`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-frequent]
+
+`field_name`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=detector-field-name]
+
+`function`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=function]
+
+`over_field_name`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=over-field-name]
+
+`partition_field_name`::
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=partition-field-name]
+
+`use_null`::
+(boolean)
+include::{docdir}/ml/ml-shared.asciidoc[tag=use-null]
 
 [[ml-valid-detector-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 76b1671fed595..6918a3a502796 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -17,7 +17,6 @@ return an error and the job waits in the `opening` state until sufficient {ml}
 node capacity is available.
 end::allow-lazy-open[]
 
-
 tag::allow-lazy-start[]
 Whether this job should be allowed to start when there is insufficient {ml} node 
 capacity for it to be immediately assigned to a node. The default is `false`, 
@@ -80,71 +79,16 @@ example: `outlier_detection`. See <<ml-dfa-analysis-objects>>.
 end::analysis[]
 
 tag::analysis-config[]
-The analysis configuration, which specifies how to analyze the data.
-After you create a job, you cannot change the analysis configuration; all
-the properties are informational. An analysis configuration object has the 
-following properties:
-
-`bucket_span`:::
-(<<time-units,time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span]
-
-`categorization_field_name`:::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-field-name]
-
-`categorization_filters`:::
-(array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-filters]
-
-`categorization_analyzer`:::
-(object or string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-analyzer]
-
-`detectors`:::
-(array) An array of detector configuration objects. Detector configuration
-objects specify which data fields a job analyzes. They also specify which
-analytical functions are used. You can specify multiple detectors for a job. 
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector]
-+
---
-NOTE: If the `detectors` array does not contain at least one detector,
-no analysis can occur and an error is returned.
-
---
-
-`influencers`:::
-(array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=influencers]
-
-`latency`:::
-(time units)
-include::{docdir}/ml/ml-shared.asciidoc[tag=latency]
-
-`multivariate_by_fields`:::
-(boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=multivariate-by-fields]
-
-`summary_count_field_name`:::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=summary-count-field-name]
-
+The analysis configuration, which specifies how to analyze the data. After you
+create a job, you cannot change the analysis configuration; all the properties
+are informational.
 end::analysis-config[]
 
 tag::analysis-limits[]
 Limits can be applied for the resources required to hold the mathematical models
 in memory. These limits are approximate and can be set per job. They do not
-control the memory used by other processes, for example the {es} Java
-processes. If necessary, you can increase the limits after the job is created.
-The `analysis_limits` object has the following properties:
-
-`categorization_examples_limit`:::
-(long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-examples-limit]
-
-`model_memory_limit`:::
-(long or string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
+control the memory used by other processes, for example the {es} Java processes.
+If necessary, you can increase the limits after the job is created.
 end::analysis-limits[]
 
 tag::analyzed-fields[]
@@ -212,15 +156,15 @@ object. If it is a string it must refer to a
 is an object it has the following properties:
 --
 
-`char_filter`::::
+`analysis_config`.`categorization_analyzer`.`char_filter`::::
 (array of strings or objects)
 include::{docdir}/ml/ml-shared.asciidoc[tag=char-filter]
 
-`tokenizer`::::
+`analysis_config`.`categorization_analyzer`.`tokenizer`::::
 (string or object)
 include::{docdir}/ml/ml-shared.asciidoc[tag=tokenizer]
 
-`filter`::::
+`analysis_config`.`categorization_analyzer`.`filter`::::
 (array of strings or objects)
 include::{docdir}/ml/ml-shared.asciidoc[tag=filter]
 end::categorization-analyzer[]
@@ -286,11 +230,11 @@ on {es} is managed. Chunking configuration controls how the size of these time
 chunks are calculated and is an advanced configuration option.
 A chunking configuration object has the following properties:
 
-`mode`:::
+`chunking_config`.`mode`:::
 (string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=mode]
 
-`time_span`:::
+`chunking_config`.`time_span`:::
 (<<time-units,time units>>)
 include::{docdir}/ml/ml-shared.asciidoc[tag=time-span]
 end::chunking-config[]
@@ -300,11 +244,10 @@ An array of custom rule objects, which enable you to customize the way detectors
 operate. For example, a rule may dictate to the detector conditions under which
 results should be skipped. For more examples, see 
 {ml-docs}/ml-configuring-detector-custom-rules.html[Customizing detectors with custom rules].
-A custom rule has the following properties:
-+
---
-`actions`::
-(array) The set of actions to be triggered when the rule applies. If
+end::custom-rules[]
+
+tag::custom-rules-actions[]
+The set of actions to be triggered when the rule applies. If
 more than one action is specified the effects of all actions are combined. The
 available actions include:
 
@@ -316,49 +259,47 @@ model. Unless you also specify `skip_result`, the results will be created as
 usual. This action is suitable when certain values are expected to be
 consistently anomalous and they affect the model in a way that negatively
 impacts the rest of the results.
+end::custom-rules-actions[]
 
-`scope`::
-(object) An optional scope of series where the rule applies. A rule must either
+tag::custom-rules-scope[]
+An optional scope of series where the rule applies. A rule must either
 have a non-empty scope or at least one condition. By default, the scope includes
 all series. Scoping is allowed for any of the fields that are also specified in
 `by_field_name`, `over_field_name`, or `partition_field_name`. To add a scope
 for a field, add the field name as a key in the scope object and set its value
 to an object with the following properties:
-
-`filter_id`:::
-(string) The id of the filter to be used.
-
-`filter_type`:::
-(string) Either `include` (the rule applies for values in the filter) or
-`exclude` (the rule applies for values not in the filter). Defaults to 
-`include`.
-
-`conditions`::
-(array) An optional array of numeric conditions when the rule applies. A rule
-must either have a non-empty scope or at least one condition. Multiple
-conditions are combined together with a logical `AND`. A condition has the
-following properties: 
-
-`applies_to`:::
-(string) Specifies the result property to which the condition applies. The
-available options are `actual`, `typical`, `diff_from_typical`, `time`.
-
-`operator`:::
-(string) Specifies the condition operator. The available options are `gt`
-(greater than), `gte` (greater than or equals), `lt` (less than) and `lte` (less
-than or equals).
-
-`value`:::
-(double) The value that is compared against the `applies_to` field using the
-`operator`.
---
-+
---
-NOTE: If your detector uses `lat_long`, `metric`, `rare`, or `freq_rare`
-functions, you can only specify `conditions` that apply to `time`.
-
---
-end::custom-rules[]
+end::custom-rules-scope[]
+
+tag::custom-rules-scope-filter-id[]
+The id of the filter to be used.
+end::custom-rules-scope-filter-id[]
+
+tag::custom-rules-scope-filter-type[]
+Either `include` (the rule applies for values in the filter) or `exclude` (the
+rule applies for values not in the filter). Defaults to `include`.
+end::custom-rules-scope-filter-type[]
+
+tag::custom-rules-conditions[]
+An optional array of numeric conditions when the rule applies. A rule must
+either have a non-empty scope or at least one condition. Multiple conditions are
+combined together with a logical `AND`. A condition has the following properties:
+end::custom-rules-conditions[]
+
+tag::custom-rules-conditions-applies-to[]
+Specifies the result property to which the condition applies. The available
+options are `actual`, `typical`, `diff_from_typical`, `time`. If your detector
+uses `lat_long`, `metric`, `rare`, or `freq_rare` functions, you can only
+specify conditions that apply to `time`.
+end::custom-rules-conditions-applies-to[]
+
+tag::custom-rules-conditions-operator[]
+Specifies the condition operator. The available options are `gt` (greater than),
+`gte` (greater than or equals), `lt` (less than) and `lte` (less than or equals).
+end::custom-rules-conditions-operator[]
+
+tag::custom-rules-conditions-value[]
+The value that is compared against the `applies_to` field using the `operator`.
+end::custom-rules-conditions-value[]
 
 tag::custom-settings[]
 Advanced configuration option. Contains custom meta data about the job. For
@@ -375,16 +316,14 @@ a {dfeed}, these properties are automatically set.
 When data is received via the <<ml-post-data,post data>> API, it is not stored
 in {es}. Only the results for {anomaly-detect} are retained.
 
-A data description object has the following properties:
-
-`format`:::
+`data_description`.`format`:::
   (string) Only `JSON` format is supported at this time.
 
-`time_field`:::
+`data_description`.`time_field`:::
   (string) The name of the field that contains the timestamp.
   The default value is `time`.
 
-`time_format`:::
+`data_description`.`time_format`:::
 (string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=time-format]
 --
@@ -507,13 +446,11 @@ moment in time. See
 
 This check runs only on real-time {dfeeds}.
 
-The configuration object has the following properties:
-
-`enabled`::
+`delayed_data_check_config`.`enabled`::
 (boolean) Specifies whether the {dfeed} periodically checks for delayed data.
 Defaults to `true`.
 
-`check_window`::
+`delayed_data_check_config`.`check_window`::
 (<<time-units,time units>>) The window of time that is searched for late data.
 This window of time ends with the latest finalized bucket. It defaults to
 `null`, which causes an appropriate `check_window` to be calculated when the
@@ -571,51 +508,6 @@ the detectors in the `analysis_config`, starting at zero. You can use this
 identifier when you want to update a specific detector.
 end::detector-index[]
 
-tag::detector[]
-A detector has the following properties:
-
-`by_field_name`::::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=by-field-name]
-
-`custom_rules`::::
-(array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
-
-`detector_description`::::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
-
-`detector_index`::::
-(integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
-
-`exclude_frequent`::::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-frequent]
-
-`field_name`::::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-field-name]
-
-`function`::::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=function]
-
-`over_field_name`::::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=over-field-name]
-
-`partition_field_name`::::
-(string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=partition-field-name]
-
-`use_null`::::
-(boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=use-null]
-
-end::detector[]
-
 tag::eta[]
 The shrinkage applied to the weights. Smaller values result 
 in larger forests which have better generalization error. However, the smaller 
@@ -911,22 +803,21 @@ be seen in the model plot.
 
 Model plot config can be configured when the job is created or updated later. It 
 must be disabled if performance issues are experienced.
-
-The `model_plot_config` object has the following properties:
-
-`enabled`:::
-(boolean) If true, enables calculation and storage of the model bounds for
-each entity that is being analyzed. By default, this is not enabled.
-
-`terms`:::
-experimental[] (string) Limits data collection to this comma separated list of 
-partition or by field values. If terms are not specified or it is an empty 
-string, no filtering is applied. For example, "CPU,NetworkIn,DiskWrites". 
-Wildcards are not supported. Only the specified `terms` can be viewed when 
-using the Single Metric Viewer.
 --
 end::model-plot-config[]
 
+tag::model-plot-config-enabled[]
+If true, enables calculation and storage of the model bounds for each entity
+that is being analyzed. By default, this is not enabled.
+end::model-plot-config-enabled[]
+
+tag::model-plot-config-terms[]
+Limits data collection to this comma separated list of partition or by field
+values. If terms are not specified or it is an empty string, no filtering is
+applied. For example, "CPU,NetworkIn,DiskWrites". Wildcards are not supported.
+Only the specified `terms` can be viewed when using the Single Metric Viewer.
+end::model-plot-config-terms[]
+
 tag::model-snapshot-id[]
 A numerical character string that uniquely identifies the model snapshot. For 
 example, `1575402236000 `.

From 0b445e1db55124fb02bc7de5c9d10ab691087206 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 26 Dec 2019 07:41:23 -0500
Subject: [PATCH 334/686] [DOCS] Document `transport` and `http` node stats
 (#50473)

Documents the `transport` and `http` parameters returned by the
`_nodes/stats` API.
---
 docs/reference/cluster/nodes-stats.asciidoc | 38 +++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/docs/reference/cluster/nodes-stats.asciidoc b/docs/reference/cluster/nodes-stats.asciidoc
index af3ad0deee442..9306c23e43f43 100644
--- a/docs/reference/cluster/nodes-stats.asciidoc
+++ b/docs/reference/cluster/nodes-stats.asciidoc
@@ -922,6 +922,44 @@ Highest number of active threads in the thread pool.
 (integer)
 Number of tasks completed by the thread pool executor.
 
+[[cluster-nodes-stats-api-response-body-transport]]
+===== `transport` section
+
+`transport.server_open`::
+(integer)
+Number of open TCP connections used for internal communication between nodes.
+
+`transport.rx_count`::
+(integer)
+Total number of RX (receive) packets received by the node during internal
+cluster communication.
+
+`transport.rx_size_in_bytes`::
+(integer)
+Size, in bytes, of RX packets received by the node during internal cluster
+communication.
+
+`transport.tx_count`::
+(integer)
+Total number of TX (transmit) packets sent by the node during internal cluster
+communication.
+
+`transport.tx_size_in_bytes`::
+(integer)
+Size, in bytes, of TX packets sent by the node during internal cluster
+communication.
+
+[[cluster-nodes-stats-api-response-body-http]]
+===== `http` section
+
+`http.current_open`::
+(integer)
+Current number of open HTTP connections for the node.
+
+`http.total_opened`::
+(integer)
+Total number of HTTP connections opened for the node.
+
 [[cluster-nodes-stats-api-response-body-ingest]]
 ===== `ingest` section
 

From 85a38087a11e8aa48178268cf39735f09e7df4d7 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 26 Dec 2019 07:49:41 -0500
Subject: [PATCH 335/686] [DOCS] Remove unneeded redirects (#50476)

The docs/reference/redirects.asciidoc file stores a list of relocated or
deleted pages for the Elasticsearch Reference documentation.

This prunes several older redirects that are no longer needed and
don't require work to fix broken links in other repositories.
---
 docs/reference/how-to/search-speed.asciidoc   |   2 +-
 .../mapping/removal_of_types.asciidoc         |   2 +-
 .../ml/anomaly-detection/apis/ml-api.asciidoc |   4 +-
 docs/reference/redirects.asciidoc             | 596 ------------------
 .../security/create-api-keys.asciidoc         |   2 +-
 .../security/create-role-mappings.asciidoc    |   4 +-
 .../configuring-kerberos-realm.asciidoc       |   8 +-
 .../en/security/fips-140-compliance.asciidoc  |   3 +-
 8 files changed, 12 insertions(+), 609 deletions(-)

diff --git a/docs/reference/how-to/search-speed.asciidoc b/docs/reference/how-to/search-speed.asciidoc
index a275af5fead29..5d0e004a7fb6a 100644
--- a/docs/reference/how-to/search-speed.asciidoc
+++ b/docs/reference/how-to/search-speed.asciidoc
@@ -31,7 +31,7 @@ If your search is CPU-bound, you should investigate buying faster CPUs.
 Documents should be modeled so that search-time operations are as cheap as possible.
 
 In particular, joins should be avoided. <<nested,`nested`>> can make queries
-several times slower and <<mapping-parent-field,parent-child>> relations can make
+several times slower and <<parent-join,parent-child>> relations can make
 queries hundreds of times slower. So if the same questions can be answered without
 joins by denormalizing documents, significant speedups can be expected.
 
diff --git a/docs/reference/mapping/removal_of_types.asciidoc b/docs/reference/mapping/removal_of_types.asciidoc
index d2f5eef943df7..1c299bfc073c2 100644
--- a/docs/reference/mapping/removal_of_types.asciidoc
+++ b/docs/reference/mapping/removal_of_types.asciidoc
@@ -42,7 +42,7 @@ field, so documents of different types with the same `_id` could exist in a
 single index.
 
 Mapping types were also used to establish a
-<<mapping-parent-field,parent-child relationship>>
+<<parent-join,parent-child relationship>>
 between documents, so documents of type `question` could be parents to
 documents of type `answer`.
 
diff --git a/docs/reference/ml/anomaly-detection/apis/ml-api.asciidoc b/docs/reference/ml/anomaly-detection/apis/ml-api.asciidoc
index 2014d05812595..f02312cb0ac94 100644
--- a/docs/reference/ml/anomaly-detection/apis/ml-api.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/ml-api.asciidoc
@@ -3,9 +3,7 @@
 [[ml-apis]]
 == {ml-cap} {anomaly-detect} APIs
 
-You can use the following APIs to perform {ml} {anomaly-detect} activities. See
-<<ml-api-definitions, Definitions>> for the resource definitions used by the
-machine learning APIs and in advanced job configuration options in Kibana.
+You can use the following APIs to perform {ml} {anomaly-detect} activities.
 
 See also <<ml-df-analytics-apis>>. 
 
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 8580705623146..4c5e26bb2e799 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -3,619 +3,23 @@
 
 The following pages have moved or been deleted.
 
-[role="exclude",id="cluster-nodes-shutdown"]
-=== Nodes shutdown
-
-The `_shutdown` API has been removed.  Instead, setup Elasticsearch to run as
-a service (see <<rpm>>, <<deb>>,  or <<windows>>) or use the `-p`
-command line option to <<setup-installation-daemon,write the PID to a file>>.
-
 [role="exclude",id="indices-upgrade"]
 === Upgrade API
 
 The `_upgrade` API is no longer useful and will be removed.  Instead, see
 <<reindex-upgrade>>.
 
-[role="exclude",id="migration-api-assistance"]
-=== Migration Assistance API
-
-The Migration Assistance API has been replaced with the
-<<migration-api-deprecation, Deprecation Info API>>.
-
-[role="exclude",id="migration-api-upgrade"]
-=== Migration Upgrade API
-
-The Migration Upgrade API has been removed. Use the
-{kibana-ref}/upgrade-assistant.html[{kib} Upgrade Assistant] or
-<<reindex-upgrade,Reindex manually>> instead.
-
-[role="exclude",id="docs-bulk-udp"]
-=== Bulk UDP API
-
-The Bulk UDP services has been removed.  Use the standard <<docs-bulk>> instead.
-
-[role="exclude",id="indices-delete-mapping"]
-=== Delete Mapping
-
-It is no longer possible to delete the mapping for a type. Instead you should
-<<indices-delete-index,delete the index>> and recreate it with the new mappings.
-
-[role="exclude",id="indices-status"]
-=== Index Status
-
-The  index `_status` API has been replaced with the <<indices-stats>> and
-<<indices-recovery>> APIs.
-
-[role="exclude",id="mapping-analyzer-field"]
-=== `_analyzer`
-
-The `_analyzer` field in type mappings is no longer supported and will be
-automatically removed from mappings when upgrading to 2.x.
-
-[role="exclude",id="mapping-boost-field"]
-=== `_boost`
-
-The `_boost` field in type mappings is no longer supported and will be
-automatically removed from mappings when upgrading to 2.x.
-
-[role="exclude",id="mapping-conf-mappings"]
-=== Config mappings
-
-It is no longer possible to specify mappings in files in the `config`
-directory.  Instead, mappings should be created using the API with:
-
-* <<indices-create-index>>
-* <<indices-put-mapping>>
-* <<indices-templates>>
-
 [role="exclude",id="mapping-parent-field"]
 === `_parent` field
 
 The `_parent` field has been removed in favour of the <<parent-join,`join` field>>.
 
-[role="exclude",id="mapping-uid-field"]
-=== `_uid` field
-
-The `_uid` field has been removed in favour of the <<mapping-id-field,`_id` field>>.
-
-[role="exclude",id="modules-memcached"]
-=== memcached
-
-The `memcached` transport is no longer supported.  Instead use the REST
-interface over <<modules-http,HTTP>>.
-
-[role="exclude",id="modules-thrift"]
-=== Thrift
-
-The `thrift` transport is no longer supported.  Instead use the REST
-interface over <<modules-http,HTTP>>.
-
-// QUERY DSL
-
-[role="exclude",id="query-dsl-queries"]
-=== Queries
-
-Queries and filters have been merged.  Any query clause can now be used as a query
-in ``query context'' and as a filter in ``filter context'' (see <<query-dsl>>).
-
-[role="exclude",id="query-dsl-filters"]
-=== Filters
-
-Queries and filters have been merged.  Any query clause can now be used as a query
-in ``query context'' and as a filter in ``filter context'' (see <<query-dsl>>).
-
-[role="exclude",id="query-dsl-not-filter"]
-=== Not Filter
-
-The `not` query has been replaced by using a `must_not` clause in a `bool` query (see <<query-dsl-bool-query>>).
-
-[role="exclude",id="query-dsl-bool-filter"]
-=== Bool Filter
-
-The `bool` filter has been replaced by the <<query-dsl-bool-query>>.  It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-exists-filter"]
-=== Exists Filter
-
-The `exists` filter has been replaced by the <<query-dsl-exists-query>>.  It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-geo-bounding-box-filter"]
-=== Geo Bounding Box Filter
-
-The `geo_bounding_box` filter has been replaced by the <<query-dsl-geo-bounding-box-query>>.
-It behaves as a query in ``query context'' and as a filter in ``filter
-context'' (see <<query-dsl>>).
-
-[role="exclude",id="query-dsl-geo-distance-filter"]
-=== Geo Distance Filter
-
-The `geo_distance` filter has been replaced by the <<query-dsl-geo-distance-query>>.
-It behaves as a query in ``query context'' and as a filter in ``filter
-context'' (see <<query-dsl>>).
-
-[role="exclude",id="query-dsl-geo-distance-range-filter"]
-=== Geo Distance Range Filter
-
-The `geo_distance_range` filter has been replaced by the <<query-dsl-geo-distance-range-query>>.
-It behaves as a query in ``query context'' and as a filter in ``filter
-context'' (see <<query-dsl>>).
-
-[role="exclude",id="query-dsl-geo-polygon-filter"]
-=== Geo Polygon Filter
-
-The `geo_polygon` filter has been replaced by the <<query-dsl-geo-polygon-query>>.
-It behaves as a query in ``query context'' and as a filter in ``filter
-context'' (see <<query-dsl>>).
-
-[role="exclude",id="query-dsl-geo-shape-filter"]
-=== Geo Shape Filter
-
-The `geo_shape` filter has been replaced by the <<query-dsl-geo-shape-query>>.
-It behaves as a query in ``query context'' and as a filter in ``filter
-context'' (see <<query-dsl>>).
-
-[role="exclude",id="query-dsl-has-child-filter"]
-=== Has Child Filter
-
-The `has_child` filter has been replaced by the <<query-dsl-has-child-query>>.  It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-has-parent-filter"]
-=== Has Parent Filter
-
-The `has_parent` filter has been replaced by the <<query-dsl-has-parent-query>>.  It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-top-children-query"]
-=== Top Children Query
-
-The `top_children` query has been removed. Use the <<query-dsl-has-child-query>> instead.
-
-[role="exclude",id="query-dsl-ids-filter"]
-=== IDs Filter
-
-The `ids` filter has been replaced by the <<query-dsl-ids-query>>.  It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-match-all-filter"]
-=== Match All Filter
-
-The `match_all` filter has been replaced by the <<query-dsl-match-all-query>>.  It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-nested-filter"]
-=== Nested Filter
-
-The `nested` filter has been replaced by the <<query-dsl-nested-query>>.  It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-prefix-filter"]
-=== Prefix Filter
-
-The `prefix` filter has been replaced by the <<query-dsl-prefix-query>>. It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-query-filter"]
-=== Query Filter
-
-The `query` filter has been removed as queries and filters have been merged (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-range-filter"]
-=== Range Filter
-
-The `range` filter has been replaced by the <<query-dsl-range-query>>. It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-regexp-filter"]
-=== Regexp Filter
-
-The `regexp` filter has been replaced by the <<query-dsl-regexp-query>>. It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-script-filter"]
-=== Script Filter
-
-The `script` filter has been replaced by the <<query-dsl-script-query>>. It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-term-filter"]
-=== Term Filter
-
-The `term` filter has been replaced by the <<query-dsl-term-query>>. It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-terms-filter"]
-=== Terms Filter
-
-The `terms` filter has been replaced by the <<query-dsl-terms-query>>. It behaves
-as a query in ``query context'' and as a filter in ``filter context'' (see
-<<query-dsl>>).
-
-[role="exclude",id="query-dsl-flt-query"]
-=== Fuzzy Like This Query
-
-The `fuzzy_like_this`, alternatively known as `flt`, query has been removed.  Instead use either
-the <<query-dsl-match-query-fuzziness,`fuzziness`>> parameter with the
-<<query-dsl-match-query,`match` query>> or the <<query-dsl-mlt-query>>.
-
-
-[role="exclude",id="query-dsl-flt-field-query"]
-=== Fuzzy Like This Field Query
-
-The `fuzzy_like_this_field` or `flt_field` query has been removed.  Instead use
-the <<query-dsl-match-query-fuzziness,`fuzziness`>> parameter with the
-<<query-dsl-match-query,`match` query>> or the <<query-dsl-mlt-query>>.
-
-[role="exclude",id="query-dsl-geo-distance-range-query"]
-=== Geo distance range Query
-
-The `geo_distance_range` query has been removed. Instead use the
-<<query-dsl-geo-distance-query, Geo Distance Query>> with pagination
-or the
-<<search-aggregations-bucket-geodistance-aggregation, Geo Distance Aggregation>>
-depending on your needs.
-
-[role="exclude",id="query-dsl-geohash-cell-query"]
-=== Geohash Cell Query
-
-The `geohash_cell` query has been removed. Instead use the
-<<query-dsl-geo-bounding-box-query, Geo Bounding Box Query>>.
-
-[role="exclude",id="search-more-like-this"]
-=== More Like This API
-
-The More Like This API has been removed. Instead, use the <<query-dsl-mlt-query>>.
-
-// FACETS
-
-[role="exclude",id="search-facets"]
-=== Facets
-
-Faceted search refers to a way to explore large amounts of data by displaying
-summaries about various partitions of the data and later allowing to narrow
-the navigation to a specific partition.
-
-In Elasticsearch, `facets` are also the name of a feature that allowed to
-compute these summaries. `facets` have been replaced by
-<<search-aggregations, aggregations>> in Elasticsearch 1.0, which are a superset
-of facets.
-
-[role="exclude",id="search-facets-filter-facet"]
-=== Filter Facet
-
-Facets have been removed. Use the
-<<search-aggregations-bucket-filter-aggregation,`filter` aggregation>> or
-<<search-aggregations-bucket-filters-aggregation,`filters` aggregation>> instead.
-
-[role="exclude",id="search-facets-query-facet"]
-=== Query Facet
-
-Facets have been removed. Use the
-<<search-aggregations-bucket-filter-aggregation,`filter` aggregation>> or
-<<search-aggregations-bucket-filters-aggregation,`filters` aggregation>> instead.
-
-[role="exclude",id="search-facets-geo-distance-facet"]
-=== Geo Distance Facet
-
-Facets have been removed. Use the
-<<search-aggregations-bucket-geodistance-aggregation,`geo_distance` aggregation>> instead.
-
-[role="exclude",id="search-facets-histogram-facet"]
-=== Histogram Facet
-
-Facets have been removed. Use the
-<<search-aggregations-bucket-histogram-aggregation,`histogram` aggregation>> instead.
-
-[role="exclude",id="search-facets-date-histogram-facet"]
-=== Date Histogram Facet
-
-Facets have been removed. Use the
-<<search-aggregations-bucket-datehistogram-aggregation,`date_histogram` aggregation>> instead.
-
-[role="exclude",id="search-facets-range-facet"]
-=== Range Facet
-
-Facets have been removed. Use the
-<<search-aggregations-bucket-range-aggregation,`range` aggregation>> instead.
-
-[role="exclude",id="search-facets-terms-facet"]
-=== Terms Facet
-
-Facets have been removed. Use the
-<<search-aggregations-bucket-terms-aggregation,`terms` aggregation>> instead.
-
-[role="exclude",id="search-facets-terms-statistical-facet"]
-=== Terms Stats Facet
-
-Facets have been removed. Use the
-<<search-aggregations-bucket-terms-aggregation,`terms` aggregation>>
-with the <<search-aggregations-metrics-stats-aggregation,`stats` aggregation>>
-or the <<search-aggregations-metrics-extendedstats-aggregation,`extended_stats` aggregation>>
-instead.
-
-[role="exclude",id="search-facets-statistical-facet"]
-=== Statistical Facet
-
-Facets have been removed. Use the
-<<search-aggregations-metrics-stats-aggregation,`stats` aggregation>>
-or the <<search-aggregations-metrics-extendedstats-aggregation,`extended_stats` aggregation>>  instead.
-
-[role="exclude",id="search-facets-migrating-to-aggs"]
-=== Migrating from facets to aggregations
-
-Facets have been removed. Use <<search-aggregations>> instead.
-
-// CACHES
-
-[role="exclude",id="shard-query-cache"]
-=== Shard request cache
-
-The shard query cache has been renamed <<shard-request-cache>>.
-
-[role="exclude",id="filter-cache"]
-=== Query cache
-
-The filter cache has been renamed <<query-cache>>.
-
-[role="exclude",id="query-dsl-filtered-query"]
-=== Filtered query
-
-The `filtered` query is replaced by the <<query-dsl-bool-query,bool>> query. Instead of
-the following:
-
-[source,js]
--------------------------
-## INCORRECT - DEPRECATED SYNTAX, DO NOT USE
-GET _search
-{
-  "query": {
-    "filtered": {
-      "query": {
-        "match": {
-          "text": "quick brown fox"
-        }
-      },
-      "filter": {
-        "term": {
-          "status": "published"
-        }
-      }
-    }
-  }
-}
--------------------------
-// NOTCONSOLE
-
-move the query and filter to the `must` and `filter` parameters in the `bool`
-query:
-
-[source,console]
--------------------------
-GET _search
-{
-  "query": {
-    "bool": {
-      "must": {
-        "match": {
-          "text": "quick brown fox"
-        }
-      },
-      "filter": {
-        "term": {
-          "status": "published"
-        }
-      }
-    }
-  }
-}
--------------------------
-
-[role="exclude",id="query-dsl-or-query"]
-=== Or query
-
-The `or` query is replaced in favour of the <<query-dsl-bool-query,bool>> query.
-
-[role="exclude",id="query-dsl-or-filter"]
-=== Or filter
-
-The `or` filter is replaced in favour of the <<query-dsl-bool-query,bool>> query.
-
-[role="exclude",id="query-dsl-and-query"]
-=== And query
-
-The `and` query is replaced in favour of the <<query-dsl-bool-query,bool>> query.
-
-[role="exclude",id="query-dsl-and-filter"]
-=== And filter
-
-The `and` filter is replaced in favour of the <<query-dsl-bool-query,bool>> query.
-
-[role="exclude",id="query-dsl-limit-query"]
-=== Limit query
-
-The `limit` query is replaced in favour of the <<search-request-body,terminate_after>>
-parameter of search requests.
-
-[role="exclude",id="query-dsl-limit-filter"]
-=== Limit filter
-
-The `limit` filter is replaced in favour of the <<search-request-body,terminate_after>>
-parameter of search requests.
-
-[role="exclude",id="query-dsl-not-query"]
-=== Not query
-
-The `not` query has been replaced by using a `mustNot` clause in a Boolean query.
-
-[role="exclude",id="mapping-nested-type"]
-=== Nested type
-
-The docs for the `nested` field datatype have moved to <<nested>>.
-
 [role="exclude",id="indices-warmers"]
 === Warmers
 
 Warmers have been removed. There have been significant improvements to the
 index that make warmers not necessary anymore.
 
-[role="exclude",id="index-boost"]
-=== Index time boosting
-
-The index time boost mapping has been replaced with query time boost (see <<mapping-boost>>).
-
-[role="exclude",id="modules-scripting-native"]
-=== Native scripting
-
-Native scripts have been replaced with writing custom `ScriptEngine` backends (see <<modules-scripting-engine>>).
-
-[role="exclude",id="modules-advanced-scripting"]
-=== Advanced scripting
-
-Using `_index` in scripts has been replaced with writing `ScriptEngine` backends (see <<modules-scripting-engine>>).
-
-[role="exclude",id="modules-scripting-painless-syntax"]
-=== Painless Syntax
-
-See the
-{painless}/painless-lang-spec.html[Painless Language Specification]
-in the guide to the {painless}/index.html[Painless Scripting Language].
-
-[role="exclude",id="modules-scripting-painless-debugging"]
-=== Painless Debugging
-
-See {painless}/painless-debugging.html[Painless Debugging] in the
-guide to the {painless}/index.html[Painless Scripting Language].
-
-[role="exclude",id="painless-api-reference"]
-=== Painless Contexts API Reference
-
-See the {painless}/painless-api-reference.html[Painless Contexts API Reference]
-in the guide to the {painless}/index.html[Painless Scripting Language].
-
-[role="exclude", id="security-api-roles"]
-=== Role management APIs
-
-You can use the following APIs to add, remove, and retrieve roles in the native realm:
-
-* <<security-api-put-role,Create role>>, <<security-api-delete-role,Delete role>>
-* <<security-api-clear-role-cache,Clear roles cache>>
-* <<security-api-get-role,Get roles>>
-
-[role="exclude",id="security-api-tokens"]
-=== Token management APIs
-
-You can use the following APIs to create and invalidate bearer tokens for access
-without requiring basic authentication:
-
-* <<security-api-get-token,Get token>>, <<security-api-invalidate-token,Invalidate token>>
-
-[role="exclude",id="security-api-users"]
-=== User Management APIs
-
-You can use the following APIs to create, read, update, and delete users from the
-native realm:
-
-* <<security-api-put-user,Create users>>, <<security-api-delete-user,Delete users>>
-* <<security-api-enable-user,Enable users>>, <<security-api-disable-user,Disable users>>
-* <<security-api-change-password,Change passwords>>
-* <<security-api-get-user,Get users>>
-
-[role="exclude",id="security-api-role-mapping"]
-=== Role mapping APIs
-
-You can use the following APIs to add, remove, and retrieve role mappings:
-
-* <<security-api-put-role-mapping,Add role mappings>>, <<security-api-delete-role-mapping,Delete role mappings>>
-* <<security-api-get-role-mapping,Get role mappings>>
-
-[role="exclude",id="security-api-privileges"]
-=== Privilege APIs
-
-See <<security-api-has-privileges>>.
-
-[role="exclude",id="xpack-commands"]
-=== X-Pack commands
-
-See <<commands>>.
-
-[role="exclude",id="ml-api-definitions"]
-=== Machine learning API definitions
-
-See <<api-definitions>>.
-
-[role="exclude",id="analysis-standard-tokenfilter"]
-=== Standard filter removed
-
-The standard token filter has been removed.
-
-[role="exclude",id="modules-discovery-azure-classic"]
-
-See <<azure-classic-hosts-provider>>.
-
-[role="exclude",id="modules-discovery-ec2"]
-
-See <<ec2-hosts-provider>>.
-
-[role="exclude",id="modules-discovery-gce"]
-
-See <<gce-hosts-provider>>.
-
-[role="exclude",id="modules-discovery-zen"]
-
-Zen discovery is replaced by the <<modules-discovery,discovery and cluster
-formation module>>.
-
-[role="exclude",id="settings-xpack"]
-=== {xpack} settings in {es}
-
-include::{asciidoc-dir}/../../shared/settings.asciidoc[]
-
-[role="exclude",id="_faster_phrase_queries_with_literal_index_phrases_literal"]
-
-See <<faster-phrase-queries>>.
-
-[role="exclude",id="_faster_prefix_queries_with_literal_index_prefixes_literal.html"]
-
-See <<faster-prefix-queries>>.
-
-[role="exclude",id="setup-xpack"]
-=== Set up {xpack}
-
-{xpack} is an Elastic Stack extension that provides security, alerting,
-monitoring, reporting, machine learning, and many other capabilities. By default,
-when you install {es}, {xpack} is installed.
-
-[role="exclude",id="setup-xpack-client"]
-=== Configuring {xpack} Java Clients
-
-The `TransportClient` is deprecated in favour of the
-{java-rest}/java-rest-high.html[Java High Level REST Client] and was removed in
-Elasticsearch 8.0. The
-{java-rest}/java-rest-high-level-migration.html[migration guide] describes all
-the steps needed to migrate.
-
-[role="exclude",id="query-dsl-common-terms-query"]
-=== Common Terms Query
-
-The `common` terms query is deprecated. Use the <<query-dsl-match-query, `match`
-query>> instead. The `match` query skips blocks of documents efficiently,
-without any configuration, if the total number of hits is not tracked.
-
 [role="exclude",id="indices-types-exists"]
 === Types Exists
 
diff --git a/x-pack/docs/en/rest-api/security/create-api-keys.asciidoc b/x-pack/docs/en/rest-api/security/create-api-keys.asciidoc
index 801064dca452e..015fb4dc03130 100644
--- a/x-pack/docs/en/rest-api/security/create-api-keys.asciidoc
+++ b/x-pack/docs/en/rest-api/security/create-api-keys.asciidoc
@@ -54,7 +54,7 @@ authenticated user_. If you supply role descriptors then the resultant permissio
 would be an intersection of API keys permissions and authenticated user's permissions
 thereby limiting the access scope for API keys.
 The structure of role descriptor is the same as the request for create role API.
-For more details, see <<security-api-roles,role management APIs>>.
+For more details, see <<security-api-put-role, create or update roles API>>.
 
 `expiration`::
 (Optional, string) Expiration time for the API key. By default, API keys never
diff --git a/x-pack/docs/en/rest-api/security/create-role-mappings.asciidoc b/x-pack/docs/en/rest-api/security/create-role-mappings.asciidoc
index b03bee933fdc8..e80ff662c8305 100644
--- a/x-pack/docs/en/rest-api/security/create-role-mappings.asciidoc
+++ b/x-pack/docs/en/rest-api/security/create-role-mappings.asciidoc
@@ -32,8 +32,8 @@ The create or update role mappings API cannot update role mappings that are defi
 in role mapping files.
 
 NOTE: This API does not create roles. Rather, it maps users to existing roles.
-Roles can be created by using <<security-api-roles, Role Management APIs>> or
-<<roles-management-file,roles files>>.
+Roles can be created by using the <<security-api-put-role,create or update
+roles API>> or <<roles-management-file,roles files>>.
 
 For more information, see <<mapping-roles>>.
 
diff --git a/x-pack/docs/en/security/authentication/configuring-kerberos-realm.asciidoc b/x-pack/docs/en/security/authentication/configuring-kerberos-realm.asciidoc
index 9f20596837a0e..6448e96ca1da8 100644
--- a/x-pack/docs/en/security/authentication/configuring-kerberos-realm.asciidoc
+++ b/x-pack/docs/en/security/authentication/configuring-kerberos-realm.asciidoc
@@ -139,10 +139,10 @@ see <<ref-kerberos-settings>>.
 +
 --
 
-The `kerberos` realm enables you to map Kerberos users to roles. You can 
-configure these role mappings by using the 
-<<security-api-role-mapping,role-mapping API>>. You identify 
-users by their `username` field.
+The `kerberos` realm enables you to map Kerberos users to roles. You can
+configure these role mappings by using the
+<<security-api-put-role-mapping,create or update role mappings API>>. You
+identify users by their `username` field.
 
 The following example uses the role mapping API to map `user@REALM` to the roles 
 `monitoring` and `user`:
diff --git a/x-pack/docs/en/security/fips-140-compliance.asciidoc b/x-pack/docs/en/security/fips-140-compliance.asciidoc
index 8f5956068cb8b..a700ead8a8ee0 100644
--- a/x-pack/docs/en/security/fips-140-compliance.asciidoc
+++ b/x-pack/docs/en/security/fips-140-compliance.asciidoc
@@ -100,7 +100,8 @@ on disk.
 Authentication will still work, but in order to ensure FIPS 140-2 compliance,
 you would need to recreate users or change their password using the
 <<users-command, elasticsearch-user>> CLI tool for the file realm and the
-<<security-api-users,User Management APIs>> for the native realm.
+<<security-api-put-user,create users>> and <<security-api-change-password,change
+password>> APIs for the native realm.
 
 The user cache will be emptied upon node restart, so any existing hashes using
 non-compliant algorithms will be discarded and the new ones will be created

From 6b5ee4d419ee06e921ca4815cd3ec8217216c637 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Thu, 26 Dec 2019 08:56:00 -0500
Subject: [PATCH 336/686] Fix testCancelRecoveryDuringPhase1 (#50449)

testCancelRecoveryDuringPhase1 uses a mock of IndexShard, which can't
create retention leases. We need to stub method createRetentionLease.

Relates #50351
Closes #50424
---
 .../indices/recovery/RecoverySourceHandler.java      |  2 +-
 .../indices/recovery/RecoverySourceHandlerTests.java | 12 ++++++++++--
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java b/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
index 07db659299e7c..3e132c979d7b6 100644
--- a/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
+++ b/server/src/main/java/org/elasticsearch/indices/recovery/RecoverySourceHandler.java
@@ -555,7 +555,7 @@ void phase1(IndexCommit snapshot, long startingSeqNo, IntSupplier translogOps, A
         }
     }
 
-    private void createRetentionLease(final long startingSeqNo, ActionListener<RetentionLease> listener) {
+    void createRetentionLease(final long startingSeqNo, ActionListener<RetentionLease> listener) {
         runUnderPrimaryPermit(() -> {
                 // Clone the peer recovery retention lease belonging to the source shard. We are retaining history between the the local
                 // checkpoint of the safe commit we're creating and this lease's retained seqno with the retention lock, and by cloning an
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
index a10a8fc0410b6..999028cb083fd 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
@@ -64,6 +64,7 @@
 import org.elasticsearch.index.mapper.SeqNoFieldMapper;
 import org.elasticsearch.index.mapper.Uid;
 import org.elasticsearch.index.seqno.ReplicationTracker;
+import org.elasticsearch.index.seqno.RetentionLease;
 import org.elasticsearch.index.seqno.RetentionLeases;
 import org.elasticsearch.index.seqno.SeqNoStats;
 import org.elasticsearch.index.seqno.SequenceNumbers;
@@ -628,7 +629,6 @@ public void writeFileChunk(StoreFileMetaData md, long position, BytesReference c
         store.close();
     }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50424")
     public void testCancelRecoveryDuringPhase1() throws Exception {
         Store store = newStore(createTempDir("source"), false);
         IndexShard shard = mock(IndexShard.class);
@@ -677,8 +677,16 @@ public void cleanFiles(int totalTranslogOps, long globalCheckpoint, Store.Metada
                 }
             }
         };
+        final StartRecoveryRequest startRecoveryRequest = getStartRecoveryRequest();
         final RecoverySourceHandler handler = new RecoverySourceHandler(
-            shard, recoveryTarget, threadPool, getStartRecoveryRequest(), between(1, 16), between(1, 4));
+            shard, recoveryTarget, threadPool, startRecoveryRequest, between(1, 16), between(1, 4)) {
+            @Override
+            void createRetentionLease(long startingSeqNo, ActionListener<RetentionLease> listener) {
+                final String leaseId = ReplicationTracker.getPeerRecoveryRetentionLeaseId(startRecoveryRequest.targetNode().getId());
+                listener.onResponse(new RetentionLease(leaseId, startingSeqNo, threadPool.absoluteTimeInMillis(),
+                    ReplicationTracker.PEER_RECOVERY_RETENTION_LEASE_SOURCE));
+            }
+        };
         cancelRecovery.set(() -> handler.cancel("test"));
         final StepListener<RecoverySourceHandler.SendFileResult> phase1Listener = new StepListener<>();
         try {

From 3a792ba10611cbc2c23b291c0f8eaeb9a2ca76e1 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Thu, 26 Dec 2019 08:58:34 -0500
Subject: [PATCH 337/686] Ensure relocating shards establish peer recovery
 retention leases (#50486)

We forgot to establish peer recovery retention leases for relocating primaries
without soft-deletes.

Relates #50351
---
 .../index/seqno/ReplicationTracker.java       |  6 +--
 .../elasticsearch/recovery/RelocationIT.java  | 54 +++++++++++++++++++
 2 files changed, 55 insertions(+), 5 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
index aff85f10e4bf8..8071d0e4b7d79 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/ReplicationTracker.java
@@ -1334,11 +1334,7 @@ public synchronized void activateWithPrimaryContext(PrimaryContext primaryContex
         // note that if there was no cluster state update between start of the engine of this shard and the call to
         // initializeWithPrimaryContext, we might still have missed a cluster state update. This is best effort.
         runAfter.run();
-
-        if (indexSettings.isSoftDeleteEnabled()) {
-            addPeerRecoveryRetentionLeaseForSolePrimary();
-        }
-
+        addPeerRecoveryRetentionLeaseForSolePrimary();
         assert invariant();
     }
 
diff --git a/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java b/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
index 2d0856c95ec40..c22d1bc0dd28f 100644
--- a/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
+++ b/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
@@ -20,12 +20,14 @@
 package org.elasticsearch.recovery;
 
 import com.carrotsearch.hppc.IntHashSet;
+import com.carrotsearch.hppc.cursors.ObjectCursor;
 import com.carrotsearch.hppc.procedures.IntProcedure;
 import org.apache.lucene.index.IndexFileNames;
 import org.apache.lucene.util.English;
 import org.elasticsearch.action.ActionFuture;
 import org.elasticsearch.action.admin.cluster.health.ClusterHealthResponse;
 import org.elasticsearch.action.admin.cluster.reroute.ClusterRerouteResponse;
+import org.elasticsearch.action.admin.indices.stats.ShardStats;
 import org.elasticsearch.action.index.IndexRequestBuilder;
 import org.elasticsearch.action.index.IndexResponse;
 import org.elasticsearch.action.search.SearchResponse;
@@ -45,6 +47,9 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.IndexService;
+import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.index.seqno.ReplicationTracker;
+import org.elasticsearch.index.seqno.RetentionLease;
 import org.elasticsearch.index.shard.IndexEventListener;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.shard.IndexShardState;
@@ -77,9 +82,12 @@
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.List;
+import java.util.Map;
+import java.util.Set;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.Semaphore;
 import java.util.concurrent.TimeUnit;
+import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
 import static org.elasticsearch.index.query.QueryBuilders.matchAllQuery;
@@ -88,6 +96,8 @@
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertNoFailures;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertSearchHits;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.everyItem;
+import static org.hamcrest.Matchers.in;
 import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.startsWith;
 
@@ -103,6 +113,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
     @Override
     protected void beforeIndexDeletion() throws Exception {
         super.beforeIndexDeletion();
+        assertActiveCopiesEstablishedPeerRecoveryRetentionLeases();
         internalCluster().assertSeqNos();
         internalCluster().assertSameDocIdsOnShards();
     }
@@ -603,6 +614,49 @@ public void testRelocateWhileContinuouslyIndexingAndWaitingForRefresh() throws E
         assertThat(client().prepareSearch("test").setSize(0).execute().actionGet().getHits().getTotalHits().value, equalTo(120L));
     }
 
+    public void testRelocationEstablishedPeerRecoveryRetentionLeases() throws Exception {
+        int halfNodes = randomIntBetween(1, 3);
+        String indexName = "test";
+        Settings[] nodeSettings = Stream.concat(
+            Stream.generate(() -> Settings.builder().put("node.attr.color", "blue").build()).limit(halfNodes),
+            Stream.generate(() -> Settings.builder().put("node.attr.color", "red").build()).limit(halfNodes)).toArray(Settings[]::new);
+        List<String> nodes = internalCluster().startNodes(nodeSettings);
+        String[] blueNodes = nodes.subList(0, halfNodes).toArray(String[]::new);
+        String[] redNodes = nodes.subList(0, halfNodes).toArray(String[]::new);
+        ensureStableCluster(halfNodes * 2);
+        assertAcked(
+            client().admin().indices().prepareCreate(indexName).setSettings(Settings.builder()
+                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, randomIntBetween(0, halfNodes - 1))
+                .put("index.routing.allocation.include.color", "blue")));
+        ensureGreen("test");
+        assertBusy(() -> assertAllShardsOnNodes(indexName, blueNodes));
+        assertActiveCopiesEstablishedPeerRecoveryRetentionLeases();
+        client().admin().indices().prepareUpdateSettings(indexName)
+            .setSettings(Settings.builder().put("index.routing.allocation.include.color", "red")).get();
+        assertBusy(() -> assertAllShardsOnNodes(indexName, redNodes));
+        ensureGreen("test");
+        assertActiveCopiesEstablishedPeerRecoveryRetentionLeases();
+    }
+
+    private void assertActiveCopiesEstablishedPeerRecoveryRetentionLeases() throws Exception {
+        assertBusy(() -> {
+            for (ObjectCursor<String> it : client().admin().cluster().prepareState().get().getState().metaData().indices().keys()) {
+                Map<ShardId, List<ShardStats>> byShardId = Stream.of(client().admin().indices().prepareStats(it.value).get().getShards())
+                    .collect(Collectors.groupingBy(l -> l.getShardRouting().shardId()));
+                for (List<ShardStats> shardStats : byShardId.values()) {
+                    Set<String> expectedLeaseIds = shardStats.stream()
+                        .map(s -> ReplicationTracker.getPeerRecoveryRetentionLeaseId(s.getShardRouting())).collect(Collectors.toSet());
+                    for (ShardStats shardStat : shardStats) {
+                        Set<String> actualLeaseIds = shardStat.getRetentionLeaseStats().retentionLeases().leases().stream()
+                            .map(RetentionLease::id).collect(Collectors.toSet());
+                        assertThat(expectedLeaseIds, everyItem(in(actualLeaseIds)));
+                    }
+                }
+            }
+        });
+    }
+
     class RecoveryCorruption implements StubbableTransport.SendRequestBehavior {
 
         private final CountDownLatch corruptionCount;

From 8faf2773e7b123d9ac7dea0d764eac0d74943ded Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Thu, 26 Dec 2019 09:02:02 -0500
Subject: [PATCH 338/686] Always use soft-deletes in InternalEngine (#50415)

Peer recoveries become faster and use less storage (i.e., no more extra
translog) with soft-deletes. Soft-deletes has been enabled by default
since 7.0. We should make it mandatory in 8.0, so we can simplify the
logic in the engine, recoveries, and other components.

With this change, InternalEngine will always use soft-deletes regardless
of the soft_deletes settings.
---
 .../index/engine/InternalEngine.java          | 139 ++----
 .../index/engine/ReadOnlyEngine.java          |  10 +-
 .../index/mapper/SourceFieldMapper.java       |   2 +-
 .../index/engine/InternalEngineTests.java     | 439 ++++--------------
 .../index/shard/IndexShardTests.java          |  32 +-
 .../indices/stats/IndexStatsIT.java           |   4 +-
 .../index/engine/EngineTestCase.java          |  11 +-
 7 files changed, 159 insertions(+), 478 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java b/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
index 1e445c0b0ac85..a090501ca0de4 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
@@ -22,7 +22,6 @@
 import org.apache.logging.log4j.Logger;
 import org.apache.lucene.codecs.blocktree.BlockTreeTermsReader;
 import org.apache.lucene.codecs.blocktree.BlockTreeTermsReader.FSTLoadMode;
-import org.apache.lucene.document.Field;
 import org.apache.lucene.document.LongPoint;
 import org.apache.lucene.document.NumericDocValuesField;
 import org.apache.lucene.index.DirectoryReader;
@@ -170,7 +169,6 @@ public class InternalEngine extends Engine {
     private final CounterMetric numDocAppends = new CounterMetric();
     private final CounterMetric numDocUpdates = new CounterMetric();
     private final NumericDocValuesField softDeletesField = Lucene.newSoftDeletesField();
-    private final boolean softDeleteEnabled;
     private final SoftDeletesPolicy softDeletesPolicy;
     private final LastRefreshedCheckpointListener lastRefreshedCheckpointListener;
 
@@ -217,7 +215,6 @@ public InternalEngine(EngineConfig engineConfig) {
                     });
                 assert translog.getGeneration() != null;
                 this.translog = translog;
-                this.softDeleteEnabled = engineConfig.getIndexSettings().isSoftDeleteEnabled();
                 this.softDeletesPolicy = newSoftDeletesPolicy();
                 this.combinedDeletionPolicy =
                     new CombinedDeletionPolicy(logger, translogDeletionPolicy, softDeletesPolicy, translog::getLastSyncedGlobalCheckpoint);
@@ -254,7 +251,7 @@ public InternalEngine(EngineConfig engineConfig) {
             this.lastRefreshedCheckpointListener = new LastRefreshedCheckpointListener(localCheckpointTracker.getProcessedCheckpoint());
             this.internalReaderManager.addListener(lastRefreshedCheckpointListener);
             maxSeqNoOfUpdatesOrDeletes = new AtomicLong(SequenceNumbers.max(localCheckpointTracker.getMaxSeqNo(), translog.getMaxSeqNo()));
-            if (softDeleteEnabled && localCheckpointTracker.getPersistedCheckpoint() < localCheckpointTracker.getMaxSeqNo()) {
+            if (localCheckpointTracker.getPersistedCheckpoint() < localCheckpointTracker.getMaxSeqNo()) {
                 try (Searcher searcher =
                          acquireSearcher("restore_version_map_and_checkpoint_tracker", SearcherScope.INTERNAL)) {
                     restoreVersionMapAndCheckpointTracker(Lucene.wrapAllDocsLive(searcher.getDirectoryReader()));
@@ -537,7 +534,6 @@ public void syncTranslog() throws IOException {
     public Translog.Snapshot readHistoryOperations(String reason, HistorySource historySource,
                                                    MapperService mapperService, long startingSeqNo) throws IOException {
         if (historySource == HistorySource.INDEX) {
-            ensureSoftDeletesEnabled();
             return newChangesSnapshot(reason, mapperService, Math.max(0, startingSeqNo), Long.MAX_VALUE, false);
         } else {
             return getTranslog().newSnapshotFromMinSeqNo(startingSeqNo);
@@ -551,7 +547,6 @@ public Translog.Snapshot readHistoryOperations(String reason, HistorySource hist
     public int estimateNumberOfHistoryOperations(String reason, HistorySource historySource,
                                                  MapperService mapperService, long startingSeqNo) throws IOException {
         if (historySource == HistorySource.INDEX) {
-            ensureSoftDeletesEnabled();
             try (Translog.Snapshot snapshot = newChangesSnapshot(reason, mapperService, Math.max(0, startingSeqNo),
                 Long.MAX_VALUE, false)) {
                 return snapshot.totalOperations();
@@ -747,7 +742,7 @@ private OpVsLuceneDocStatus compareOpToLuceneDocBasedOnSeqNo(final Operation op)
                 } else if (op.seqNo() > docAndSeqNo.seqNo) {
                     status = OpVsLuceneDocStatus.OP_NEWER;
                 } else if (op.seqNo() == docAndSeqNo.seqNo) {
-                    assert localCheckpointTracker.hasProcessed(op.seqNo()) || softDeleteEnabled == false :
+                    assert localCheckpointTracker.hasProcessed(op.seqNo()) :
                         "local checkpoint tracker is not updated seq_no=" + op.seqNo() + " id=" + op.id();
                     status = OpVsLuceneDocStatus.OP_STALE_OR_EQUAL;
                 } else {
@@ -999,7 +994,7 @@ protected final IndexingStrategy planIndexingAsNonPrimary(Index index) throws IO
             versionMap.enforceSafeAccess();
             final OpVsLuceneDocStatus opVsLucene = compareOpToLuceneDocBasedOnSeqNo(index);
             if (opVsLucene == OpVsLuceneDocStatus.OP_STALE_OR_EQUAL) {
-                plan = IndexingStrategy.processAsStaleOp(softDeleteEnabled, index.version());
+                plan = IndexingStrategy.processAsStaleOp(index.version());
             } else {
                 plan = IndexingStrategy.processNormally(opVsLucene == OpVsLuceneDocStatus.LUCENE_DOC_NOT_FOUND, index.version());
             }
@@ -1151,7 +1146,6 @@ private void addDocs(final List<ParseContext.Document> docs, final IndexWriter i
     }
 
     private void addStaleDocs(final List<ParseContext.Document> docs, final IndexWriter indexWriter) throws IOException {
-        assert softDeleteEnabled : "Add history documents but soft-deletes is disabled";
         for (ParseContext.Document doc : docs) {
             doc.add(softDeletesField); // soft-deleted every document before adding to Lucene
         }
@@ -1212,9 +1206,8 @@ public static IndexingStrategy processButSkipLucene(boolean currentNotFoundOrDel
                 false, versionForIndexing, null);
         }
 
-        static IndexingStrategy processAsStaleOp(boolean addStaleOpToLucene, long versionForIndexing) {
-            return new IndexingStrategy(false, false, false,
-                addStaleOpToLucene, versionForIndexing, null);
+        static IndexingStrategy processAsStaleOp(long versionForIndexing) {
+            return new IndexingStrategy(false, false, false, true, versionForIndexing, null);
         }
     }
 
@@ -1243,18 +1236,10 @@ private boolean assertDocDoesNotExist(final Index index, final boolean allowDele
     }
 
     private void updateDocs(final Term uid, final List<ParseContext.Document> docs, final IndexWriter indexWriter) throws IOException {
-        if (softDeleteEnabled) {
-            if (docs.size() > 1) {
-                indexWriter.softUpdateDocuments(uid, docs, softDeletesField);
-            } else {
-                indexWriter.softUpdateDocument(uid, docs.get(0), softDeletesField);
-            }
+        if (docs.size() > 1) {
+            indexWriter.softUpdateDocuments(uid, docs, softDeletesField);
         } else {
-            if (docs.size() > 1) {
-                indexWriter.updateDocuments(uid, docs);
-            } else {
-                indexWriter.updateDocument(uid, docs.get(0));
-            }
+            indexWriter.softUpdateDocument(uid, docs.get(0), softDeletesField);
         }
         numDocUpdates.inc(docs.size());
     }
@@ -1293,6 +1278,12 @@ public DeleteResult delete(Delete delete) throws IOException {
                     deleteResult = new DeleteResult(
                         plan.versionOfDeletion, delete.primaryTerm(), delete.seqNo(), plan.currentlyDeleted == false);
                 }
+                if (plan.deleteFromLucene) {
+                    numDocDeletes.inc();
+                    versionMap.putDeleteUnderLock(delete.uid().bytes(),
+                        new DeleteVersionValue(plan.versionOfDeletion, delete.seqNo(), delete.primaryTerm(),
+                            engineConfig.getThreadPool().relativeTimeInMillis()));
+                }
             }
             if (delete.origin().isFromTranslog() == false && deleteResult.getResultType() == Result.Type.SUCCESS) {
                 final Translog.Location location = translog.add(new Translog.Delete(delete, deleteResult));
@@ -1342,7 +1333,7 @@ protected final DeletionStrategy planDeletionAsNonPrimary(Delete delete) throws
         } else {
             final OpVsLuceneDocStatus opVsLucene = compareOpToLuceneDocBasedOnSeqNo(delete);
             if (opVsLucene == OpVsLuceneDocStatus.OP_STALE_OR_EQUAL) {
-                plan = DeletionStrategy.processAsStaleOp(softDeleteEnabled, delete.version());
+                plan = DeletionStrategy.processAsStaleOp(delete.version());
             } else {
                 plan = DeletionStrategy.processNormally(opVsLucene == OpVsLuceneDocStatus.LUCENE_DOC_NOT_FOUND, delete.version());
             }
@@ -1392,30 +1383,18 @@ private DeletionStrategy planDeletionAsPrimary(Delete delete) throws IOException
     private DeleteResult deleteInLucene(Delete delete, DeletionStrategy plan) throws IOException {
         assert assertMaxSeqNoOfUpdatesIsAdvanced(delete.uid(), delete.seqNo(), false, false);
         try {
-            if (softDeleteEnabled) {
-                final ParsedDocument tombstone = engineConfig.getTombstoneDocSupplier().newDeleteTombstoneDoc(delete.id());
-                assert tombstone.docs().size() == 1 : "Tombstone doc should have single doc [" + tombstone + "]";
-                tombstone.updateSeqID(delete.seqNo(), delete.primaryTerm());
-                tombstone.version().setLongValue(plan.versionOfDeletion);
-                final ParseContext.Document doc = tombstone.docs().get(0);
-                assert doc.getField(SeqNoFieldMapper.TOMBSTONE_NAME) != null :
-                    "Delete tombstone document but _tombstone field is not set [" + doc + " ]";
-                doc.add(softDeletesField);
-                if (plan.addStaleOpToLucene || plan.currentlyDeleted) {
-                    indexWriter.addDocument(doc);
-                } else {
-                    indexWriter.softUpdateDocument(delete.uid(), doc, softDeletesField);
-                }
-            } else if (plan.currentlyDeleted == false) {
-                // any exception that comes from this is a either an ACE or a fatal exception there
-                // can't be any document failures  coming from this
-                indexWriter.deleteDocuments(delete.uid());
-            }
-            if (plan.deleteFromLucene) {
-                numDocDeletes.inc();
-                versionMap.putDeleteUnderLock(delete.uid().bytes(),
-                    new DeleteVersionValue(plan.versionOfDeletion, delete.seqNo(), delete.primaryTerm(),
-                        engineConfig.getThreadPool().relativeTimeInMillis()));
+            final ParsedDocument tombstone = engineConfig.getTombstoneDocSupplier().newDeleteTombstoneDoc(delete.id());
+            assert tombstone.docs().size() == 1 : "Tombstone doc should have single doc [" + tombstone + "]";
+            tombstone.updateSeqID(delete.seqNo(), delete.primaryTerm());
+            tombstone.version().setLongValue(plan.versionOfDeletion);
+            final ParseContext.Document doc = tombstone.docs().get(0);
+            assert doc.getField(SeqNoFieldMapper.TOMBSTONE_NAME) != null :
+                "Delete tombstone document but _tombstone field is not set [" + doc + " ]";
+            doc.add(softDeletesField);
+            if (plan.addStaleOpToLucene || plan.currentlyDeleted) {
+                indexWriter.addDocument(doc);
+            } else {
+                indexWriter.softUpdateDocument(delete.uid(), doc, softDeletesField);
             }
             return new DeleteResult(
                 plan.versionOfDeletion, delete.primaryTerm(), delete.seqNo(), plan.currentlyDeleted == false);
@@ -1475,8 +1454,8 @@ public static DeletionStrategy processButSkipLucene(boolean currentlyDeleted, lo
             return new DeletionStrategy(false, false, currentlyDeleted, versionOfDeletion, null);
         }
 
-        static DeletionStrategy processAsStaleOp(boolean addStaleOpToLucene, long versionOfDeletion) {
-            return new DeletionStrategy(false, addStaleOpToLucene, false, versionOfDeletion, null);
+        static DeletionStrategy processAsStaleOp(long versionOfDeletion) {
+            return new DeletionStrategy(false, true, false, versionOfDeletion, null);
         }
     }
 
@@ -1519,7 +1498,7 @@ private NoOpResult innerNoOp(final NoOp noOp) throws IOException {
                     SequenceNumbers.UNASSIGNED_SEQ_NO, preFlightError.get());
             } else {
                 markSeqNoAsSeen(noOp.seqNo());
-                if (softDeleteEnabled && hasBeenProcessedBefore(noOp) == false) {
+                if (hasBeenProcessedBefore(noOp) == false) {
                     try {
                         final ParsedDocument tombstone = engineConfig.getTombstoneDocSupplier().newNoopTombstoneDoc(noOp.reason());
                         tombstone.updateSeqID(noOp.seqNo(), noOp.primaryTerm());
@@ -2236,11 +2215,9 @@ private IndexWriterConfig getIndexWriterConfig() {
         MergePolicy mergePolicy = config().getMergePolicy();
         // always configure soft-deletes field so an engine with soft-deletes disabled can open a Lucene index with soft-deletes.
         iwc.setSoftDeletesField(Lucene.SOFT_DELETES_FIELD);
-        if (softDeleteEnabled) {
-            mergePolicy = new RecoverySourcePruneMergePolicy(SourceFieldMapper.RECOVERY_SOURCE_NAME, softDeletesPolicy::getRetentionQuery,
-                new SoftDeletesRetentionMergePolicy(Lucene.SOFT_DELETES_FIELD, softDeletesPolicy::getRetentionQuery,
-                    new PrunePostingsMergePolicy(mergePolicy, IdFieldMapper.NAME)));
-        }
+        mergePolicy = new RecoverySourcePruneMergePolicy(SourceFieldMapper.RECOVERY_SOURCE_NAME, softDeletesPolicy::getRetentionQuery,
+            new SoftDeletesRetentionMergePolicy(Lucene.SOFT_DELETES_FIELD, softDeletesPolicy::getRetentionQuery,
+                new PrunePostingsMergePolicy(mergePolicy, IdFieldMapper.NAME)));
         boolean shuffleForcedMerge = Booleans.parseBoolean(System.getProperty("es.shuffle_forced_merge", Boolean.TRUE.toString()));
         if (shuffleForcedMerge) {
             // We wrap the merge policy for all indices even though it is mostly useful for time-based indices
@@ -2441,9 +2418,7 @@ protected void commitIndexWriter(final IndexWriter writer, final Translog transl
                 commitData.put(SequenceNumbers.MAX_SEQ_NO, Long.toString(localCheckpointTracker.getMaxSeqNo()));
                 commitData.put(MAX_UNSAFE_AUTO_ID_TIMESTAMP_COMMIT_ID, Long.toString(maxUnsafeAutoIdTimestamp.get()));
                 commitData.put(HISTORY_UUID_KEY, historyUUID);
-                if (softDeleteEnabled) {
-                    commitData.put(Engine.MIN_RETAINED_SEQNO, Long.toString(softDeletesPolicy.getMinRetainedSeqNo()));
-                }
+                commitData.put(Engine.MIN_RETAINED_SEQNO, Long.toString(softDeletesPolicy.getMinRetainedSeqNo()));
                 logger.trace("committing writer with commit data [{}]", commitData);
                 return commitData.entrySet().iterator();
             });
@@ -2600,17 +2575,9 @@ long getNumDocUpdates() {
         return numDocUpdates.count();
     }
 
-    private void ensureSoftDeletesEnabled() {
-        if (softDeleteEnabled == false) {
-            assert false : "index " + shardId.getIndex() + " does not have soft-deletes enabled";
-            throw new IllegalStateException("index " + shardId.getIndex() + " does not have soft-deletes enabled");
-        }
-    }
-
     @Override
     public Translog.Snapshot newChangesSnapshot(String source, MapperService mapperService,
                                                 long fromSeqNo, long toSeqNo, boolean requiredFullRange) throws IOException {
-        ensureSoftDeletesEnabled();
         ensureOpen();
         refreshIfNeeded(source, toSeqNo);
         Searcher searcher = acquireSearcher(source, SearcherScope.INTERNAL);
@@ -2635,7 +2602,6 @@ public Translog.Snapshot newChangesSnapshot(String source, MapperService mapperS
     public boolean hasCompleteOperationHistory(String reason, HistorySource historySource,
                                                MapperService mapperService, long startingSeqNo) throws IOException {
         if (historySource == HistorySource.INDEX) {
-            ensureSoftDeletesEnabled();
             return getMinRetainedSeqNo() <= startingSeqNo;
         } else {
             final long currentLocalCheckpoint = localCheckpointTracker.getProcessedCheckpoint();
@@ -2661,14 +2627,12 @@ public boolean hasCompleteOperationHistory(String reason, HistorySource historyS
      * Operations whose seq# are at least this value should exist in the Lucene index.
      */
     public final long getMinRetainedSeqNo() {
-        ensureSoftDeletesEnabled();
         return softDeletesPolicy.getMinRetainedSeqNo();
     }
 
     @Override
     public Closeable acquireHistoryRetentionLock(HistorySource historySource) {
         if (historySource == HistorySource.INDEX) {
-            ensureSoftDeletesEnabled();
             return softDeletesPolicy.acquireRetentionLock();
         } else {
             return translog.acquireRetentionLock();
@@ -2686,40 +2650,29 @@ private static Map<String, String> commitDataAsMap(final IndexWriter indexWriter
         return commitData;
     }
 
-    private final class AssertingIndexWriter extends IndexWriter {
+    private static class AssertingIndexWriter extends IndexWriter {
         AssertingIndexWriter(Directory d, IndexWriterConfig conf) throws IOException {
             super(d, conf);
         }
+
         @Override
-        public long updateDocument(Term term, Iterable<? extends IndexableField> doc) throws IOException {
-            assert softDeleteEnabled == false : "Call #updateDocument but soft-deletes is enabled";
-            return super.updateDocument(term, doc);
-        }
-        @Override
-        public long updateDocuments(Term delTerm, Iterable<? extends Iterable<? extends IndexableField>> docs) throws IOException {
-            assert softDeleteEnabled == false : "Call #updateDocuments but soft-deletes is enabled";
-            return super.updateDocuments(delTerm, docs);
-        }
-        @Override
-        public long deleteDocuments(Term... terms) throws IOException {
-            assert softDeleteEnabled == false : "Call #deleteDocuments but soft-deletes is enabled";
-            return super.deleteDocuments(terms);
+        public long updateDocument(Term term, Iterable<? extends IndexableField> doc) {
+            throw new AssertionError("must not hard update document");
         }
+
         @Override
-        public long softUpdateDocument(Term term, Iterable<? extends IndexableField> doc, Field... softDeletes) throws IOException {
-            assert softDeleteEnabled : "Call #softUpdateDocument but soft-deletes is disabled";
-            return super.softUpdateDocument(term, doc, softDeletes);
+        public long updateDocuments(Term delTerm, Iterable<? extends Iterable<? extends IndexableField>> docs) {
+            throw new AssertionError("must not hard update documents");
         }
+
         @Override
-        public long softUpdateDocuments(Term term, Iterable<? extends Iterable<? extends IndexableField>> docs,
-                                            Field... softDeletes) throws IOException {
-            assert softDeleteEnabled : "Call #softUpdateDocuments but soft-deletes is disabled";
-            return super.softUpdateDocuments(term, docs, softDeletes);
+        public long deleteDocuments(Term... terms) {
+            throw new AssertionError("must not hard delete documents");
         }
+
         @Override
         public long tryDeleteDocument(IndexReader readerIn, int docID) {
-            assert false : "#tryDeleteDocument is not supported. See Lucene#DirectoryReaderWithAllLiveDocs";
-            throw new UnsupportedOperationException();
+            throw new AssertionError("tryDeleteDocument is not supported. See Lucene#DirectoryReaderWithAllLiveDocs");
         }
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java b/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
index 768655cf1c852..4bc06aeea00b9 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
@@ -168,15 +168,12 @@ public void verifyEngineBeforeIndexClosing() throws IllegalStateException {
 
     protected final ElasticsearchDirectoryReader wrapReader(DirectoryReader reader,
                                                     Function<DirectoryReader, DirectoryReader> readerWrapperFunction) throws IOException {
-        if (engineConfig.getIndexSettings().isSoftDeleteEnabled()) {
-            reader = new SoftDeletesDirectoryReaderWrapper(reader, Lucene.SOFT_DELETES_FIELD);
-        }
         reader = readerWrapperFunction.apply(reader);
         return ElasticsearchDirectoryReader.wrap(reader, engineConfig.getShardId());
     }
 
     protected DirectoryReader open(IndexCommit commit) throws IOException {
-        return DirectoryReader.open(commit, OFF_HEAP_READER_ATTRIBUTES);
+        return new SoftDeletesDirectoryReaderWrapper(DirectoryReader.open(commit, OFF_HEAP_READER_ATTRIBUTES), Lucene.SOFT_DELETES_FIELD);
     }
 
     private DocsStats docsStats(final SegmentInfos lastCommittedSegmentInfos) {
@@ -313,10 +310,7 @@ public Closeable acquireHistoryRetentionLock(HistorySource historySource) {
 
     @Override
     public Translog.Snapshot newChangesSnapshot(String source, MapperService mapperService, long fromSeqNo, long toSeqNo,
-                                                boolean requiredFullRange) throws IOException {
-        if (engineConfig.getIndexSettings().isSoftDeleteEnabled() == false) {
-            throw new IllegalStateException("accessing changes snapshot requires soft-deletes enabled");
-        }
+                                                boolean requiredFullRange)  {
         return newEmptySnapshot();
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/SourceFieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/SourceFieldMapper.java
index 4f5e1b79bd1f1..2b0bbe40a2fb3 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/SourceFieldMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/SourceFieldMapper.java
@@ -236,7 +236,7 @@ protected void parseCreateField(ParseContext context, List<IndexableField> field
             fields.add(new StoredField(fieldType().name(), ref.bytes, ref.offset, ref.length));
         }
 
-        if (originalSource != null && adaptedSource != originalSource && context.indexSettings().isSoftDeleteEnabled()) {
+        if (originalSource != null && adaptedSource != originalSource) {
             // if we omitted source or modified it we add the _recovery_source to ensure we have it for ops based recovery
             BytesRef ref = originalSource.toBytesRef();
             fields.add(new StoredField(RECOVERY_SOURCE_NAME, ref.bytes, ref.offset, ref.length));
diff --git a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
index 79e5cf7489ca3..9a2f79b7530a7 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
@@ -175,6 +175,7 @@
 import java.util.function.ToLongBiFunction;
 import java.util.stream.Collectors;
 import java.util.stream.LongStream;
+import java.util.stream.StreamSupport;
 
 import static java.util.Collections.shuffle;
 import static org.elasticsearch.index.engine.Engine.Operation.Origin.LOCAL_RESET;
@@ -277,198 +278,6 @@ public void testVersionMapAfterAutoIDDocument() throws IOException {
         }
     }
 
-    public void testSegmentsWithoutSoftDeletes() throws Exception {
-        Settings settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false).build();
-        IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(
-            IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
-        try (Store store = createStore();
-             InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
-            List<Segment> segments = engine.segments(false);
-            assertThat(segments.isEmpty(), equalTo(true));
-            assertThat(engine.segmentsStats(false, false).getCount(), equalTo(0L));
-            assertThat(engine.segmentsStats(false, false).getMemoryInBytes(), equalTo(0L));
-
-            // create two docs and refresh
-            ParsedDocument doc = testParsedDocument("1", null, testDocumentWithTextField(), B_1, null);
-            Engine.Index first = indexForDoc(doc);
-            Engine.IndexResult firstResult = engine.index(first);
-            ParsedDocument doc2 = testParsedDocument("2", null, testDocumentWithTextField(), B_2, null);
-            Engine.Index second = indexForDoc(doc2);
-            Engine.IndexResult secondResult = engine.index(second);
-            assertThat(secondResult.getTranslogLocation(), greaterThan(firstResult.getTranslogLocation()));
-            engine.refresh("test");
-
-            segments = engine.segments(false);
-            assertThat(segments.size(), equalTo(1));
-            SegmentsStats stats = engine.segmentsStats(false, false);
-            assertThat(stats.getCount(), equalTo(1L));
-            assertThat(stats.getTermsMemoryInBytes(), greaterThan(0L));
-            assertThat(stats.getStoredFieldsMemoryInBytes(), greaterThan(0L));
-            assertThat(stats.getTermVectorsMemoryInBytes(), equalTo(0L));
-            assertThat(stats.getNormsMemoryInBytes(), greaterThan(0L));
-            assertThat(stats.getDocValuesMemoryInBytes(), greaterThan(0L));
-            assertThat(segments.get(0).isCommitted(), equalTo(false));
-            assertThat(segments.get(0).isSearch(), equalTo(true));
-            assertThat(segments.get(0).getNumDocs(), equalTo(2));
-            assertThat(segments.get(0).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(0).isCompound(), equalTo(true));
-            assertThat(segments.get(0).ramTree, nullValue());
-            engine.flush();
-
-            segments = engine.segments(false);
-            assertThat(segments.size(), equalTo(1));
-            assertThat(engine.segmentsStats(false, false).getCount(), equalTo(1L));
-            assertThat(segments.get(0).isCommitted(), equalTo(true));
-            assertThat(segments.get(0).isSearch(), equalTo(true));
-            assertThat(segments.get(0).getNumDocs(), equalTo(2));
-            assertThat(segments.get(0).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(0).isCompound(), equalTo(true));
-
-            ParsedDocument doc3 = testParsedDocument("3", null, testDocumentWithTextField(), B_3, null);
-            engine.index(indexForDoc(doc3));
-            engine.refresh("test");
-
-            segments = engine.segments(false);
-            assertThat(segments.size(), equalTo(2));
-            assertThat(engine.segmentsStats(false, false).getCount(), equalTo(2L));
-            assertThat(engine.segmentsStats(false, false).getTermsMemoryInBytes(),
-                greaterThan(stats.getTermsMemoryInBytes()));
-            assertThat(engine.segmentsStats(false, false).getStoredFieldsMemoryInBytes(),
-                greaterThan(stats.getStoredFieldsMemoryInBytes()));
-            assertThat(engine.segmentsStats(false, false).getTermVectorsMemoryInBytes(), equalTo(0L));
-            assertThat(engine.segmentsStats(false, false).getNormsMemoryInBytes(),
-                greaterThan(stats.getNormsMemoryInBytes()));
-            assertThat(engine.segmentsStats(false, false).getDocValuesMemoryInBytes(),
-                greaterThan(stats.getDocValuesMemoryInBytes()));
-            assertThat(segments.get(0).getGeneration() < segments.get(1).getGeneration(), equalTo(true));
-            assertThat(segments.get(0).isCommitted(), equalTo(true));
-            assertThat(segments.get(0).isSearch(), equalTo(true));
-            assertThat(segments.get(0).getNumDocs(), equalTo(2));
-            assertThat(segments.get(0).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(0).isCompound(), equalTo(true));
-
-
-            assertThat(segments.get(1).isCommitted(), equalTo(false));
-            assertThat(segments.get(1).isSearch(), equalTo(true));
-            assertThat(segments.get(1).getNumDocs(), equalTo(1));
-            assertThat(segments.get(1).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(1).isCompound(), equalTo(true));
-
-
-            engine.delete(new Engine.Delete("1", newUid(doc), primaryTerm.get()));
-            engine.refresh("test");
-
-            segments = engine.segments(false);
-            assertThat(segments.size(), equalTo(2));
-            assertThat(engine.segmentsStats(false, false).getCount(), equalTo(2L));
-            assertThat(segments.get(0).getGeneration() < segments.get(1).getGeneration(), equalTo(true));
-            assertThat(segments.get(0).isCommitted(), equalTo(true));
-            assertThat(segments.get(0).isSearch(), equalTo(true));
-            assertThat(segments.get(0).getNumDocs(), equalTo(1));
-            assertThat(segments.get(0).getDeletedDocs(), equalTo(1));
-            assertThat(segments.get(0).isCompound(), equalTo(true));
-
-            assertThat(segments.get(1).isCommitted(), equalTo(false));
-            assertThat(segments.get(1).isSearch(), equalTo(true));
-            assertThat(segments.get(1).getNumDocs(), equalTo(1));
-            assertThat(segments.get(1).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(1).isCompound(), equalTo(true));
-
-            engine.onSettingsChanged(indexSettings.getTranslogRetentionAge(), indexSettings.getTranslogRetentionSize(),
-                indexSettings.getSoftDeleteRetentionOperations());
-            ParsedDocument doc4 = testParsedDocument("4", null, testDocumentWithTextField(), B_3, null);
-            engine.index(indexForDoc(doc4));
-            engine.refresh("test");
-
-            segments = engine.segments(false);
-            assertThat(segments.size(), equalTo(3));
-            assertThat(engine.segmentsStats(false, false).getCount(), equalTo(3L));
-            assertThat(segments.get(0).getGeneration() < segments.get(1).getGeneration(), equalTo(true));
-            assertThat(segments.get(0).isCommitted(), equalTo(true));
-            assertThat(segments.get(0).isSearch(), equalTo(true));
-            assertThat(segments.get(0).getNumDocs(), equalTo(1));
-            assertThat(segments.get(0).getDeletedDocs(), equalTo(1));
-            assertThat(segments.get(0).isCompound(), equalTo(true));
-
-            assertThat(segments.get(1).isCommitted(), equalTo(false));
-            assertThat(segments.get(1).isSearch(), equalTo(true));
-            assertThat(segments.get(1).getNumDocs(), equalTo(1));
-            assertThat(segments.get(1).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(1).isCompound(), equalTo(true));
-
-            assertThat(segments.get(2).isCommitted(), equalTo(false));
-            assertThat(segments.get(2).isSearch(), equalTo(true));
-            assertThat(segments.get(2).getNumDocs(), equalTo(1));
-            assertThat(segments.get(2).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(2).isCompound(), equalTo(true));
-
-            // internal refresh - lets make sure we see those segments in the stats
-            ParsedDocument doc5 = testParsedDocument("5", null, testDocumentWithTextField(), B_3, null);
-            engine.index(indexForDoc(doc5));
-            engine.refresh("test", Engine.SearcherScope.INTERNAL, true);
-
-            segments = engine.segments(false);
-            assertThat(segments.size(), equalTo(4));
-            assertThat(engine.segmentsStats(false, false).getCount(), equalTo(4L));
-            assertThat(segments.get(0).getGeneration() < segments.get(1).getGeneration(), equalTo(true));
-            assertThat(segments.get(0).isCommitted(), equalTo(true));
-            assertThat(segments.get(0).isSearch(), equalTo(true));
-            assertThat(segments.get(0).getNumDocs(), equalTo(1));
-            assertThat(segments.get(0).getDeletedDocs(), equalTo(1));
-            assertThat(segments.get(0).isCompound(), equalTo(true));
-
-            assertThat(segments.get(1).isCommitted(), equalTo(false));
-            assertThat(segments.get(1).isSearch(), equalTo(true));
-            assertThat(segments.get(1).getNumDocs(), equalTo(1));
-            assertThat(segments.get(1).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(1).isCompound(), equalTo(true));
-
-            assertThat(segments.get(2).isCommitted(), equalTo(false));
-            assertThat(segments.get(2).isSearch(), equalTo(true));
-            assertThat(segments.get(2).getNumDocs(), equalTo(1));
-            assertThat(segments.get(2).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(2).isCompound(), equalTo(true));
-
-            assertThat(segments.get(3).isCommitted(), equalTo(false));
-            assertThat(segments.get(3).isSearch(), equalTo(false));
-            assertThat(segments.get(3).getNumDocs(), equalTo(1));
-            assertThat(segments.get(3).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(3).isCompound(), equalTo(true));
-
-            // now refresh the external searcher and make sure it has the new segment
-            engine.refresh("test");
-            segments = engine.segments(false);
-            assertThat(segments.size(), equalTo(4));
-            assertThat(engine.segmentsStats(false, false).getCount(), equalTo(4L));
-            assertThat(segments.get(0).getGeneration() < segments.get(1).getGeneration(), equalTo(true));
-            assertThat(segments.get(0).isCommitted(), equalTo(true));
-            assertThat(segments.get(0).isSearch(), equalTo(true));
-            assertThat(segments.get(0).getNumDocs(), equalTo(1));
-            assertThat(segments.get(0).getDeletedDocs(), equalTo(1));
-            assertThat(segments.get(0).isCompound(), equalTo(true));
-
-            assertThat(segments.get(1).isCommitted(), equalTo(false));
-            assertThat(segments.get(1).isSearch(), equalTo(true));
-            assertThat(segments.get(1).getNumDocs(), equalTo(1));
-            assertThat(segments.get(1).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(1).isCompound(), equalTo(true));
-
-            assertThat(segments.get(2).isCommitted(), equalTo(false));
-            assertThat(segments.get(2).isSearch(), equalTo(true));
-            assertThat(segments.get(2).getNumDocs(), equalTo(1));
-            assertThat(segments.get(2).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(2).isCompound(), equalTo(true));
-
-            assertThat(segments.get(3).isCommitted(), equalTo(false));
-            assertThat(segments.get(3).isSearch(), equalTo(true));
-            assertThat(segments.get(3).getNumDocs(), equalTo(1));
-            assertThat(segments.get(3).getDeletedDocs(), equalTo(0));
-            assertThat(segments.get(3).isCompound(), equalTo(true));
-        }
-    }
-
     public void testVerboseSegments() throws Exception {
         try (Store store = createStore();
              Engine engine = createEngine(defaultSettings, store, createTempDir(), NoMergePolicy.INSTANCE)) {
@@ -606,15 +415,10 @@ public void testSegmentsStatsIncludingFileSizes() throws Exception {
         }
     }
 
-    public void testSegmentsWithSoftDeletes() throws Exception {
-        Settings.Builder settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
-        final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
-        final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
+    public void testSegments() throws Exception {
         final AtomicLong globalCheckpoint = new AtomicLong(SequenceNumbers.NO_OPS_PERFORMED);
         try (Store store = createStore();
-             InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null,
+             InternalEngine engine = createEngine(config(defaultSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null,
                  null, globalCheckpoint::get))) {
             assertThat(engine.segments(false), empty());
             int numDocsFirstSegment = randomIntBetween(5, 50);
@@ -1457,55 +1261,6 @@ public void testVersioningNewIndex() throws IOException {
         assertThat(indexResult.getVersion(), equalTo(1L));
     }
 
-    public void testForceMergeWithoutSoftDeletes() throws IOException {
-        Settings settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false).build();
-        IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
-        try (Store store = createStore();
-             Engine engine = createEngine(config(IndexSettingsModule.newIndexSettings(indexMetaData), store, createTempDir(),
-                 new LogByteSizeMergePolicy(), null))) { // use log MP here we test some behavior in ESMP
-            int numDocs = randomIntBetween(10, 100);
-            for (int i = 0; i < numDocs; i++) {
-                ParsedDocument doc = testParsedDocument(Integer.toString(i), null, testDocument(), B_1, null);
-                Engine.Index index = indexForDoc(doc);
-                engine.index(index);
-                engine.refresh("test");
-            }
-            try (Engine.Searcher test = engine.acquireSearcher("test")) {
-                assertEquals(numDocs, test.getIndexReader().numDocs());
-            }
-            engine.forceMerge(true, 1, false, false, false);
-            engine.refresh("test");
-            assertEquals(engine.segments(true).size(), 1);
-
-            ParsedDocument doc = testParsedDocument(Integer.toString(0), null, testDocument(), B_1, null);
-            Engine.Index index = indexForDoc(doc);
-            engine.delete(new Engine.Delete(index.id(), index.uid(), primaryTerm.get()));
-            //expunge deletes
-            engine.forceMerge(true, -1, true, false, false);
-            engine.refresh("test");
-
-            assertEquals(engine.segments(true).size(), 1);
-            try (Engine.Searcher test = engine.acquireSearcher("test")) {
-                assertEquals(numDocs - 1, test.getIndexReader().numDocs());
-                assertEquals(engine.config().getMergePolicy().toString(), numDocs - 1, test.getIndexReader().maxDoc());
-            }
-
-            doc = testParsedDocument(Integer.toString(1), null, testDocument(), B_1, null);
-            index = indexForDoc(doc);
-            engine.delete(new Engine.Delete(index.id(), index.uid(), primaryTerm.get()));
-            //expunge deletes
-            engine.forceMerge(true, 10, false, false, false);
-            engine.refresh("test");
-            assertEquals(engine.segments(true).size(), 1);
-            try (Engine.Searcher test = engine.acquireSearcher("test")) {
-                assertEquals(numDocs - 2, test.getIndexReader().numDocs());
-                assertEquals(numDocs - 1, test.getIndexReader().maxDoc());
-            }
-        }
-    }
-
     /*
      * we are testing an edge case here where we have a fully deleted segment that is retained but has all it's IDs pruned away.
      */
@@ -1535,16 +1290,10 @@ public void testLookupVersionWithPrunedAwayIds() throws IOException {
     }
 
     public void testUpdateWithFullyDeletedSegments() throws IOException {
-        Settings.Builder settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
-            .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), Integer.MAX_VALUE);
-        final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
-        final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
         final AtomicLong globalCheckpoint = new AtomicLong(SequenceNumbers.NO_OPS_PERFORMED);
         final Set<String> liveDocs = new HashSet<>();
         try (Store store = createStore();
-             InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), newMergePolicy(), null,
+             InternalEngine engine = createEngine(config(defaultSettings, store, createTempDir(), newMergePolicy(), null,
                  null, globalCheckpoint::get))) {
             int numDocs = scaledRandomIntBetween(10, 100);
             for (int i = 0; i < numDocs; i++) {
@@ -1565,7 +1314,6 @@ public void testForceMergeWithSoftDeletesRetention() throws Exception {
         final long retainedExtraOps = randomLongBetween(0, 10);
         Settings.Builder settings = Settings.builder()
             .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), retainedExtraOps);
         final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
         final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
@@ -1639,7 +1387,6 @@ public void testForceMergeWithSoftDeletesRetentionAndRecoverySource() throws Exc
         final long retainedExtraOps = randomLongBetween(0, 10);
         Settings.Builder settings = Settings.builder()
             .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), retainedExtraOps);
         final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
         final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
@@ -4059,14 +3806,9 @@ public void testLookupSeqNoByIdInLucene() throws Exception {
             }
         }
         Randomness.shuffle(operations);
-        Settings.Builder settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
-        final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
-        final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
         Map<String, Engine.Operation> latestOps = new HashMap<>(); // id -> latest seq_no
         try (Store store = createStore();
-             InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), newMergePolicy(), null))) {
+             InternalEngine engine = createEngine(config(defaultSettings, store, createTempDir(), newMergePolicy(), null))) {
             CheckedRunnable<IOException> lookupAndCheck = () -> {
                 try (Engine.Searcher searcher = engine.acquireSearcher("test", Engine.SearcherScope.INTERNAL)) {
                     Map<String, Long> liveOps = latestOps.entrySet().stream()
@@ -5325,7 +5067,6 @@ private void assertOperationHistoryInLucene(List<Engine.Operation> operations) t
             Lucene.SOFT_DELETES_FIELD, () -> new MatchAllDocsQuery(), engine.config().getMergePolicy());
         Settings.Builder settings = Settings.builder()
             .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), randomLongBetween(0, 10));
         final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
         final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
@@ -5363,7 +5104,6 @@ public void testKeepMinRetainedSeqNoByMergePolicy() throws IOException {
         IOUtils.close(engine, store);
         Settings.Builder settings = Settings.builder()
             .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), randomLongBetween(0, 10));
         final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
         final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
@@ -5488,11 +5228,8 @@ public void testLuceneSnapshotRefreshesOnlyOnce() throws Exception {
         final MapperService mapperService = createMapperService();
         final long maxSeqNo = randomLongBetween(10, 50);
         final AtomicLong refreshCounter = new AtomicLong();
-        final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(
-            IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(Settings.builder().
-                put(defaultSettings.getSettings()).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)).build());
         try (Store store = createStore();
-             InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), newMergePolicy(),
+             InternalEngine engine = createEngine(config(defaultSettings, store, createTempDir(), newMergePolicy(),
                  null,
                  new ReferenceManager.RefreshListener() {
                      @Override
@@ -5548,14 +5285,8 @@ public void testAcquireSearcherOnClosingEngine() throws Exception {
 
     public void testNoOpOnClosingEngine() throws Exception {
         engine.close();
-        Settings settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
-        IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(
-            IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
-        assertTrue(indexSettings.isSoftDeleteEnabled());
         try (Store store = createStore();
-             InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
+             InternalEngine engine = createEngine(config(defaultSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
             engine.close();
             expectThrows(AlreadyClosedException.class, () -> engine.noOp(
                 new Engine.NoOp(2, primaryTerm.get(), LOCAL_TRANSLOG_RECOVERY, System.nanoTime(), "reason")));
@@ -5564,14 +5295,8 @@ public void testNoOpOnClosingEngine() throws Exception {
 
     public void testSoftDeleteOnClosingEngine() throws Exception {
         engine.close();
-        Settings settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
-        IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(
-            IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
-        assertTrue(indexSettings.isSoftDeleteEnabled());
         try (Store store = createStore();
-             InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
+             InternalEngine engine = createEngine(config(defaultSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
             engine.close();
             expectThrows(AlreadyClosedException.class, () -> engine.delete(replicaDeleteForDoc("test", 42, 7, System.nanoTime())));
         }
@@ -5605,19 +5330,13 @@ public void testTrackMaxSeqNoOfUpdatesOrDeletesOnPrimary() throws Exception {
     }
 
     public void testRebuildLocalCheckpointTrackerAndVersionMap() throws Exception {
-        Settings.Builder settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), 10000)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
-        final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build();
-        final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
         final AtomicLong globalCheckpoint = new AtomicLong(SequenceNumbers.NO_OPS_PERFORMED);
         Path translogPath = createTempDir();
         List<Engine.Operation> operations = generateHistoryOnReplica(between(1, 500), randomBoolean(), randomBoolean(), randomBoolean());
         List<List<Engine.Operation>> commits = new ArrayList<>();
         commits.add(new ArrayList<>());
         try (Store store = createStore()) {
-            EngineConfig config = config(indexSettings, store, translogPath, NoMergePolicy.INSTANCE, null, null, globalCheckpoint::get);
+            EngineConfig config = config(defaultSettings, store, translogPath, NoMergePolicy.INSTANCE, null, null, globalCheckpoint::get);
             final List<DocIdSeqNoAndSource> docs;
             try (InternalEngine engine = createEngine(config)) {
                 List<Engine.Operation> flushedOperations = new ArrayList<>();
@@ -5680,42 +5399,79 @@ public void testRebuildLocalCheckpointTrackerAndVersionMap() throws Exception {
         }
     }
 
-    public void testOpenSoftDeletesIndexWithSoftDeletesDisabled() throws Exception {
-        try (Store store = createStore()) {
-            Path translogPath = createTempDir();
-            final AtomicLong globalCheckpoint = new AtomicLong(SequenceNumbers.NO_OPS_PERFORMED);
-            final IndexSettings softDeletesEnabled = IndexSettingsModule.newIndexSettings(
-                IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(Settings.builder().
-                    put(defaultSettings.getSettings()).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)).build());
-            final List<DocIdSeqNoAndSource> docs;
-            try (InternalEngine engine = createEngine(
-                config(softDeletesEnabled, store, translogPath, newMergePolicy(), null, null, globalCheckpoint::get))) {
-                List<Engine.Operation> ops = generateHistoryOnReplica(between(1, 100), randomBoolean(), randomBoolean(), randomBoolean());
-                applyOperations(engine, ops);
-                engine.syncTranslog(); // to advance persisted checkpoint
-                globalCheckpoint.set(randomLongBetween(globalCheckpoint.get(), engine.getPersistedLocalCheckpoint()));
-                engine.flush();
-                docs = getDocIds(engine, true);
+    public void testRecoverFromHardDeletesIndex() throws Exception {
+        IndexWriterFactory hardDeletesWriter = (directory, iwc) -> new IndexWriter(directory, iwc) {
+            boolean isTombstone(Iterable<? extends IndexableField> doc) {
+                return StreamSupport.stream(doc.spliterator(), false).anyMatch(d -> d.name().equals(Lucene.SOFT_DELETES_FIELD));
             }
-            final IndexSettings softDeletesDisabled = IndexSettingsModule.newIndexSettings(
-                IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(Settings.builder()
-                    .put(defaultSettings.getSettings()).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false)).build());
-            EngineConfig config = config(softDeletesDisabled, store, translogPath, newMergePolicy(), null, null, globalCheckpoint::get);
-            try (InternalEngine engine = createEngine(config)) {
-                assertThat(getDocIds(engine, true), equalTo(docs));
+
+            @Override
+            public long addDocument(Iterable<? extends IndexableField> doc) throws IOException {
+                if (isTombstone(doc)) {
+                    return 0;
+                }
+                return super.addDocument(doc);
             }
-        }
-    }
 
-    public void testRequireSoftDeletesWhenAccessingChangesSnapshot() throws Exception {
+            @Override
+            public long addDocuments(Iterable<? extends Iterable<? extends IndexableField>> docs) throws IOException {
+                if (StreamSupport.stream(docs.spliterator(), false).anyMatch(this::isTombstone)) {
+                    return 0;
+                }
+                return super.addDocuments(docs);
+            }
+
+            @Override
+            public long softUpdateDocument(Term term, Iterable<? extends IndexableField> doc,
+                                           Field... softDeletes) throws IOException {
+                if (isTombstone(doc)) {
+                    return super.deleteDocuments(term);
+                } else {
+                    return super.updateDocument(term, doc);
+                }
+            }
+
+            @Override
+            public long softUpdateDocuments(Term term, Iterable<? extends Iterable<? extends IndexableField>> docs,
+                                            Field... softDeletes) throws IOException {
+                if (StreamSupport.stream(docs.spliterator(), false).anyMatch(this::isTombstone)) {
+                    return super.deleteDocuments(term);
+                } else {
+                    return super.updateDocuments(term, docs);
+                }
+            }
+        };
+        final AtomicLong globalCheckpoint = new AtomicLong(SequenceNumbers.NO_OPS_PERFORMED);
+        Path translogPath = createTempDir();
+        List<Engine.Operation> operations = generateHistoryOnReplica(between(1, 500), randomBoolean(), randomBoolean(), randomBoolean());
         try (Store store = createStore()) {
-            final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(
-                IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(Settings.builder().
-                    put(defaultSettings.getSettings()).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false)).build());
-            try (InternalEngine engine = createEngine(config(indexSettings, store, createTempDir(), newMergePolicy(), null))) {
-                AssertionError error = expectThrows(AssertionError.class,
-                    () -> engine.newChangesSnapshot("test", createMapperService(), 0, randomNonNegativeLong(), randomBoolean()));
-                assertThat(error.getMessage(), containsString("does not have soft-deletes enabled"));
+            EngineConfig config = config(defaultSettings, store, translogPath, NoMergePolicy.INSTANCE, null, null, globalCheckpoint::get);
+            final List<DocIdSeqNoAndSource> docs;
+            try (InternalEngine hardDeletesEngine = createEngine(defaultSettings, store, translogPath, newMergePolicy(),
+                hardDeletesWriter, null, globalCheckpoint::get)) {
+                for (Engine.Operation op : operations) {
+                    applyOperation(hardDeletesEngine, op);
+                    if (randomBoolean()) {
+                        hardDeletesEngine.syncTranslog();
+                        globalCheckpoint.set(randomLongBetween(globalCheckpoint.get(), hardDeletesEngine.getPersistedLocalCheckpoint()));
+                    }
+                    if (randomInt(100) < 10) {
+                        hardDeletesEngine.refresh("test");
+                    }
+                    if (randomInt(100) < 5) {
+                        hardDeletesEngine.flush(true, true);
+                    }
+                }
+                docs = getDocIds(hardDeletesEngine, true);
+            }
+            try (InternalEngine softDeletesEngine = new InternalEngine(config)) { // do not recover from translog
+                assertThat(softDeletesEngine.getVersionMap().keySet(), empty());
+                softDeletesEngine.recoverFromTranslog(translogHandler, Long.MAX_VALUE);
+                if (randomBoolean()) {
+                    softDeletesEngine.forceMerge(randomBoolean());
+                }
+                assertThat(getDocIds(softDeletesEngine, true), equalTo(docs));
+                assertConsistentHistoryBetweenTranslogAndLuceneIndex(softDeletesEngine, createMapperService());
             }
         }
     }
@@ -5889,15 +5645,10 @@ public void testGetReaderAttributes() throws IOException {
 
     public void testPruneAwayDeletedButRetainedIds() throws Exception {
         IOUtils.close(engine, store);
-        Settings settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
-        IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(
-            IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
-        store = createStore(indexSettings, newDirectory());
+        store = createStore(defaultSettings, newDirectory());
         LogDocMergePolicy policy = new LogDocMergePolicy();
         policy.setMinMergeDocs(10000);
-        try (InternalEngine engine = createEngine(indexSettings, store, createTempDir(), policy)) {
+        try (InternalEngine engine = createEngine(defaultSettings, store, createTempDir(), policy)) {
             int numDocs = between(1, 20);
             for (int i = 0; i < numDocs; i++) {
                 index(engine, i);
@@ -6040,11 +5791,6 @@ public void testAlwaysRecordReplicaOrPeerRecoveryOperationsToTranslog() throws E
 
     public void testNoOpFailure() throws IOException {
         engine.close();
-        final Settings settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
-        final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(
-            IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
         try (Store store = createStore();
              Engine engine = createEngine((dir, iwc) -> new IndexWriter(dir, iwc) {
 
@@ -6056,7 +5802,7 @@ public long addDocument(Iterable<? extends IndexableField> doc) throws IOExcepti
                  },
                  null,
                  null,
-                 config(indexSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
+                 config(defaultSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
             final Engine.NoOp op = new Engine.NoOp(0, 0, PRIMARY, System.currentTimeMillis(), "test");
             final IllegalArgumentException e = expectThrows(IllegalArgumentException. class, () -> engine.noOp(op));
             assertThat(e.getMessage(), equalTo("fatal"));
@@ -6067,27 +5813,16 @@ public long addDocument(Iterable<? extends IndexableField> doc) throws IOExcepti
         }
     }
 
-    public void testDeleteFailureSoftDeletesEnabledDocAlreadyDeleted() throws IOException {
-        runTestDeleteFailure(true, InternalEngine::delete);
-    }
-
-    public void testDeleteFailureSoftDeletesEnabled() throws IOException {
-        runTestDeleteFailure(true, (engine, op) -> {});
+    public void testDeleteFailureDocAlreadyDeleted() throws IOException {
+        runTestDeleteFailure(InternalEngine::delete);
     }
 
-    public void testDeleteFailureSoftDeletesDisabled() throws IOException {
-        runTestDeleteFailure(false, (engine, op) -> {});
+    public void testDeleteFailure() throws IOException {
+        runTestDeleteFailure((engine, op) -> {});
     }
 
-    private void runTestDeleteFailure(
-        final boolean softDeletesEnabled,
-        final CheckedBiConsumer<InternalEngine, Engine.Delete, IOException> consumer) throws IOException {
+    private void runTestDeleteFailure(final CheckedBiConsumer<InternalEngine, Engine.Delete, IOException> consumer) throws IOException {
         engine.close();
-        final Settings settings = Settings.builder()
-            .put(defaultSettings.getSettings())
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), softDeletesEnabled).build();
-        final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(
-            IndexMetaData.builder(defaultSettings.getIndexMetaData()).settings(settings).build());
         final AtomicReference<ThrowingIndexWriter> iw = new AtomicReference<>();
         try (Store store = createStore();
              InternalEngine engine = createEngine(
@@ -6097,7 +5832,7 @@ private void runTestDeleteFailure(
                  },
                  null,
                  null,
-                 config(indexSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
+                 config(defaultSettings, store, createTempDir(), NoMergePolicy.INSTANCE, null))) {
             engine.index(new Engine.Index(newUid("0"), primaryTerm.get(), InternalEngineTests.createParsedDoc("0", null)));
             final Engine.Delete op = new Engine.Delete("0", newUid("0"), primaryTerm.get());
             consumer.accept(engine, op);
diff --git a/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java b/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
index 93867f4aa4c77..21d3c95c5942f 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
@@ -2911,25 +2911,23 @@ public void testDocStats() throws Exception {
                 indexDoc(indexShard, "_doc", id);
             }
             // Need to update and sync the global checkpoint and the retention leases for the soft-deletes retention MergePolicy.
-            if (indexShard.indexSettings.isSoftDeleteEnabled()) {
-                final long newGlobalCheckpoint = indexShard.getLocalCheckpoint();
-                if (indexShard.routingEntry().primary()) {
-                    indexShard.updateLocalCheckpointForShard(indexShard.routingEntry().allocationId().getId(),
-                        indexShard.getLocalCheckpoint());
-                    indexShard.updateGlobalCheckpointForShard(indexShard.routingEntry().allocationId().getId(),
-                        indexShard.getLocalCheckpoint());
-                    indexShard.syncRetentionLeases();
-                } else {
-                    indexShard.updateGlobalCheckpointOnReplica(newGlobalCheckpoint, "test");
+            final long newGlobalCheckpoint = indexShard.getLocalCheckpoint();
+            if (indexShard.routingEntry().primary()) {
+                indexShard.updateLocalCheckpointForShard(indexShard.routingEntry().allocationId().getId(),
+                    indexShard.getLocalCheckpoint());
+                indexShard.updateGlobalCheckpointForShard(indexShard.routingEntry().allocationId().getId(),
+                    indexShard.getLocalCheckpoint());
+                indexShard.syncRetentionLeases();
+            } else {
+                indexShard.updateGlobalCheckpointOnReplica(newGlobalCheckpoint, "test");
 
-                    final RetentionLeases retentionLeases = indexShard.getRetentionLeases();
-                    indexShard.updateRetentionLeasesOnReplica(new RetentionLeases(
-                        retentionLeases.primaryTerm(), retentionLeases.version() + 1,
-                        retentionLeases.leases().stream().map(lease -> new RetentionLease(lease.id(), newGlobalCheckpoint + 1,
-                            lease.timestamp(), ReplicationTracker.PEER_RECOVERY_RETENTION_LEASE_SOURCE)).collect(Collectors.toList())));
-                }
-                indexShard.sync();
+                final RetentionLeases retentionLeases = indexShard.getRetentionLeases();
+                indexShard.updateRetentionLeasesOnReplica(new RetentionLeases(
+                    retentionLeases.primaryTerm(), retentionLeases.version() + 1,
+                    retentionLeases.leases().stream().map(lease -> new RetentionLease(lease.id(), newGlobalCheckpoint + 1,
+                        lease.timestamp(), ReplicationTracker.PEER_RECOVERY_RETENTION_LEASE_SOURCE)).collect(Collectors.toList())));
             }
+            indexShard.sync();
             // flush the buffered deletes
             final FlushRequest flushRequest = new FlushRequest();
             flushRequest.force(false);
diff --git a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
index 71d3cdb2ea610..a77091a2ce93e 100644
--- a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
@@ -982,9 +982,7 @@ public void testFilterCacheStats() throws Exception {
         indexRandom(false, true,
                 client().prepareIndex("index").setId("1").setSource("foo", "bar"),
                 client().prepareIndex("index").setId("2").setSource("foo", "baz"));
-        if (IndexSettings.INDEX_SOFT_DELETES_SETTING.get(settings)) {
-            persistGlobalCheckpoint("index"); // Need to persist the global checkpoint for the soft-deletes retention MP.
-        }
+        persistGlobalCheckpoint("index"); // Need to persist the global checkpoint for the soft-deletes retention MP.
         refresh();
         ensureGreen();
 
diff --git a/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java b/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
index 2a676bb7b7750..81b2bdd8385ec 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
@@ -1067,8 +1067,7 @@ public static List<Translog.Operation> readAllOperationsInLucene(Engine engine,
      * Asserts the provided engine has a consistent document history between translog and Lucene index.
      */
     public static void assertConsistentHistoryBetweenTranslogAndLuceneIndex(Engine engine, MapperService mapper) throws IOException {
-        if (mapper == null || mapper.documentMapper() == null || engine.config().getIndexSettings().isSoftDeleteEnabled() == false
-            || (engine instanceof InternalEngine) == false) {
+        if (mapper == null || mapper.documentMapper() == null || (engine instanceof InternalEngine) == false) {
             return;
         }
         final List<Translog.Operation> translogOps = new ArrayList<>();
@@ -1090,8 +1089,12 @@ public static void assertConsistentHistoryBetweenTranslogAndLuceneIndex(Engine e
         final long globalCheckpoint = EngineTestCase.getTranslog(engine).getLastSyncedGlobalCheckpoint();
         final long retainedOps = engine.config().getIndexSettings().getSoftDeleteRetentionOperations();
         final long seqNoForRecovery;
-        try (Engine.IndexCommitRef safeCommit = engine.acquireSafeIndexCommit()) {
-            seqNoForRecovery = Long.parseLong(safeCommit.getIndexCommit().getUserData().get(SequenceNumbers.LOCAL_CHECKPOINT_KEY)) + 1;
+        if (engine.config().getIndexSettings().isSoftDeleteEnabled()) {
+            try (Engine.IndexCommitRef safeCommit = engine.acquireSafeIndexCommit()) {
+                seqNoForRecovery = Long.parseLong(safeCommit.getIndexCommit().getUserData().get(SequenceNumbers.LOCAL_CHECKPOINT_KEY)) + 1;
+            }
+        } else {
+            seqNoForRecovery = engine.getMinRetainedSeqNo();
         }
         final long minSeqNoToRetain = Math.min(seqNoForRecovery, globalCheckpoint + 1 - retainedOps);
         for (Translog.Operation translogOp : translogOps) {

From 81631d2f6901f050aef7c53d0b89d6b663f8d16e Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 26 Dec 2019 12:32:27 -0500
Subject: [PATCH 339/686] [DOCS] Fix search request body link (#50498)

---
 docs/painless/painless-guide/painless-datetime.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/painless/painless-guide/painless-datetime.asciidoc b/docs/painless/painless-guide/painless-datetime.asciidoc
index 17aed8fb90904..227119867b67c 100644
--- a/docs/painless/painless-guide/painless-datetime.asciidoc
+++ b/docs/painless/painless-guide/painless-datetime.asciidoc
@@ -825,7 +825,7 @@ GET /messages/_search?pretty=true
 ===== Age of a Message Script Field Example
 
 The following example uses a
-{ref}/search-request-script-fields.html[script field] as part of the
+{ref}/search-request-body.html#request-body-search-script-fields[script field] as part of the
 <<painless-field-context, field context>> to display the elapsed time between
 "now" and when a message was received.
 

From d2662eec17c078eca4c14cd9f98edeb20762c7bc Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 26 Dec 2019 14:20:51 -0500
Subject: [PATCH 340/686] [DOCS] Fix search request body links (#50500)

PR #44238 changed several links related to the Elasticsearch search request body API. This updates several places still using outdated links or anchors.

This will ultimately let us remove some redirects related to those link changes.
---
 docs/reference/query-dsl/has-parent-query.asciidoc | 2 +-
 docs/reference/search/request-body.asciidoc        | 2 +-
 x-pack/docs/en/watcher/input/search.asciidoc       | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/reference/query-dsl/has-parent-query.asciidoc b/docs/reference/query-dsl/has-parent-query.asciidoc
index ba31069fad9f3..e2b8ee0f6446c 100644
--- a/docs/reference/query-dsl/has-parent-query.asciidoc
+++ b/docs/reference/query-dsl/has-parent-query.asciidoc
@@ -112,7 +112,7 @@ You can use this parameter to query multiple indices that may not contain the
 [[has-parent-query-performance]]
 ===== Sorting
 You cannot sort the results of a `has_parent` query using standard
-<<search-request-sort,sort options>>.
+<<request-body-search-sort,sort options>>.
 
 If you need to sort returned documents by a field in their parent documents, use
 a `function_score` query and sort by `_score`. For example, the following query
diff --git a/docs/reference/search/request-body.asciidoc b/docs/reference/search/request-body.asciidoc
index c3a9fe71e16b8..999ee05cb9dca 100644
--- a/docs/reference/search/request-body.asciidoc
+++ b/docs/reference/search/request-body.asciidoc
@@ -58,7 +58,7 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=index]
 `ccs_minimize_roundtrips`::
   (Optional, boolean) If `true`, the network round-trips between the 
   coordinating node and the remote clusters ewill be minimized when executing 
-  {ccs} requests. See <<ccs-reduction>> for more. Defaults to `true`. 
+  {ccs} requests. See <<ccs-network-delays>>. Defaults to `true`. 
 
 include::{docdir}/rest-api/common-parms.asciidoc[tag=from]
 
diff --git a/x-pack/docs/en/watcher/input/search.asciidoc b/x-pack/docs/en/watcher/input/search.asciidoc
index 9533a450395e6..7abef248f371a 100644
--- a/x-pack/docs/en/watcher/input/search.asciidoc
+++ b/x-pack/docs/en/watcher/input/search.asciidoc
@@ -163,7 +163,7 @@ accurately.
 |======
 | Name                                          |Required   | Default             | Description
 
-| `request.search_type`                         | no        | `query_then_fetch`  | The <<search-request-search-type,type>>
+| `request.search_type`                         | no        | `query_then_fetch`  | The <<request-body-search-search-type,type>>
                                                                                     of search request to perform. Valid values are: `dfs_query_and_fetch`,
                                                                                     `dfs_query_then_fetch`, `query_and_fetch`, and `query_then_fetch`. The
                                                                                     Elasticsearch default is `query_then_fetch`.

From 5ebd01a3a43736beac473113916642825279d81a Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Fri, 27 Dec 2019 11:00:51 -0500
Subject: [PATCH 341/686] [DOCS] Abbreviate token filter titles (#50511)

---
 .../analysis/tokenfilters/flatten-graph-tokenfilter.asciidoc | 5 ++++-
 .../analysis/tokenfilters/hunspell-tokenfilter.asciidoc      | 5 ++++-
 .../tokenfilters/keyword-marker-tokenfilter.asciidoc         | 5 ++++-
 .../tokenfilters/keyword-repeat-tokenfilter.asciidoc         | 5 ++++-
 .../analysis/tokenfilters/kstem-tokenfilter.asciidoc         | 5 ++++-
 .../analysis/tokenfilters/minhash-tokenfilter.asciidoc       | 5 ++++-
 .../analysis/tokenfilters/multiplexer-tokenfilter.asciidoc   | 5 ++++-
 .../analysis/tokenfilters/normalization-tokenfilter.asciidoc | 5 ++++-
 .../tokenfilters/pattern-capture-tokenfilter.asciidoc        | 5 ++++-
 .../tokenfilters/pattern_replace-tokenfilter.asciidoc        | 5 ++++-
 .../analysis/tokenfilters/phonetic-tokenfilter.asciidoc      | 5 ++++-
 .../analysis/tokenfilters/porterstem-tokenfilter.asciidoc    | 5 ++++-
 .../analysis/tokenfilters/predicate-tokenfilter.asciidoc     | 5 ++++-
 .../tokenfilters/remove-duplicates-tokenfilter.asciidoc      | 5 ++++-
 .../analysis/tokenfilters/reverse-tokenfilter.asciidoc       | 5 ++++-
 .../analysis/tokenfilters/shingle-tokenfilter.asciidoc       | 5 ++++-
 .../analysis/tokenfilters/snowball-tokenfilter.asciidoc      | 5 ++++-
 .../tokenfilters/stemmer-override-tokenfilter.asciidoc       | 5 ++++-
 .../analysis/tokenfilters/stemmer-tokenfilter.asciidoc       | 5 ++++-
 .../analysis/tokenfilters/stop-tokenfilter.asciidoc          | 5 ++++-
 .../analysis/tokenfilters/synonym-graph-tokenfilter.asciidoc | 5 ++++-
 .../analysis/tokenfilters/synonym-tokenfilter.asciidoc       | 5 ++++-
 .../analysis/tokenfilters/trim-tokenfilter.asciidoc          | 5 ++++-
 .../analysis/tokenfilters/truncate-tokenfilter.asciidoc      | 5 ++++-
 .../analysis/tokenfilters/unique-tokenfilter.asciidoc        | 5 ++++-
 .../analysis/tokenfilters/uppercase-tokenfilter.asciidoc     | 5 ++++-
 .../tokenfilters/word-delimiter-graph-tokenfilter.asciidoc   | 5 ++++-
 .../tokenfilters/word-delimiter-tokenfilter.asciidoc         | 5 ++++-
 28 files changed, 112 insertions(+), 28 deletions(-)

diff --git a/docs/reference/analysis/tokenfilters/flatten-graph-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/flatten-graph-tokenfilter.asciidoc
index 1495e8a91b2a7..bcff83c5e9950 100644
--- a/docs/reference/analysis/tokenfilters/flatten-graph-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/flatten-graph-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-flatten-graph-tokenfilter]]
-=== Flatten Graph Token Filter
+=== Flatten graph token filter
+++++
+<titleabbrev>Flatten graph</titleabbrev>
+++++
 
 experimental[This functionality is marked as experimental in Lucene]
 
diff --git a/docs/reference/analysis/tokenfilters/hunspell-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/hunspell-tokenfilter.asciidoc
index 2f258b00ee96b..39f584bffe694 100644
--- a/docs/reference/analysis/tokenfilters/hunspell-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/hunspell-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-hunspell-tokenfilter]]
-=== Hunspell Token Filter
+=== Hunspell token filter
+++++
+<titleabbrev>Hunspell</titleabbrev>
+++++
 
 Basic support for hunspell stemming. Hunspell dictionaries will be
 picked up from a dedicated hunspell directory on the filesystem
diff --git a/docs/reference/analysis/tokenfilters/keyword-marker-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/keyword-marker-tokenfilter.asciidoc
index ea9dcad8a6ca9..6ee9f41f777d1 100644
--- a/docs/reference/analysis/tokenfilters/keyword-marker-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/keyword-marker-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-keyword-marker-tokenfilter]]
-=== Keyword Marker Token Filter
+=== Keyword marker token filter
+++++
+<titleabbrev>Keyword marker</titleabbrev>
+++++
 
 Protects words from being modified by stemmers. Must be placed before
 any stemming filters.
diff --git a/docs/reference/analysis/tokenfilters/keyword-repeat-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/keyword-repeat-tokenfilter.asciidoc
index ca15b2da5a8f5..58d86596bbf04 100644
--- a/docs/reference/analysis/tokenfilters/keyword-repeat-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/keyword-repeat-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-keyword-repeat-tokenfilter]]
-=== Keyword Repeat Token Filter
+=== Keyword repeat token filter
+++++
+<titleabbrev>Keyword repeat</titleabbrev>
+++++
 
 The `keyword_repeat` token filter Emits each incoming token twice once
 as keyword and once as a non-keyword to allow an unstemmed version of a
diff --git a/docs/reference/analysis/tokenfilters/kstem-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/kstem-tokenfilter.asciidoc
index ff0695e64964f..3b7796bc596fa 100644
--- a/docs/reference/analysis/tokenfilters/kstem-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/kstem-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-kstem-tokenfilter]]
-=== KStem Token Filter
+=== KStem token filter
+++++
+<titleabbrev>KStem</titleabbrev>
+++++
 
 The `kstem` token filter is a high performance filter for english. All
 terms must already be lowercased (use `lowercase` filter) for this
diff --git a/docs/reference/analysis/tokenfilters/minhash-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/minhash-tokenfilter.asciidoc
index 86e14c09d51cd..c6b134f8735be 100644
--- a/docs/reference/analysis/tokenfilters/minhash-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/minhash-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-minhash-tokenfilter]]
-=== MinHash Token Filter
+=== MinHash token filter
+++++
+<titleabbrev>MinHash</titleabbrev>
+++++
 
 The `min_hash` token filter hashes each token of the token stream and divides
 the resulting hashes into buckets, keeping the lowest-valued hashes per
diff --git a/docs/reference/analysis/tokenfilters/multiplexer-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/multiplexer-tokenfilter.asciidoc
index c943c95defe2d..e12fa99324228 100644
--- a/docs/reference/analysis/tokenfilters/multiplexer-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/multiplexer-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-multiplexer-tokenfilter]]
-=== Multiplexer Token Filter
+=== Multiplexer token filter
+++++
+<titleabbrev>Multiplexer</titleabbrev>
+++++
 
 A token filter of type `multiplexer` will emit multiple tokens at the same position,
 each version of the token having been run through a different filter.  Identical
diff --git a/docs/reference/analysis/tokenfilters/normalization-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/normalization-tokenfilter.asciidoc
index 2ff8ab134972a..85f33d3f38490 100644
--- a/docs/reference/analysis/tokenfilters/normalization-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/normalization-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-normalization-tokenfilter]]
-=== Normalization Token Filter
+=== Normalization token filters
+++++
+<titleabbrev>Normalization</titleabbrev>
+++++
 
 There are several token filters available which try to normalize special
 characters of a certain language.
diff --git a/docs/reference/analysis/tokenfilters/pattern-capture-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/pattern-capture-tokenfilter.asciidoc
index 0b5aa62029fea..7b9a3b3199040 100644
--- a/docs/reference/analysis/tokenfilters/pattern-capture-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/pattern-capture-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-pattern-capture-tokenfilter]]
-=== Pattern Capture Token Filter
+=== Pattern capture token filter
+++++
+<titleabbrev>Pattern capture</titleabbrev>
+++++
 
 The `pattern_capture` token filter, unlike the `pattern` tokenizer,
 emits a token for every capture group in the regular expression.
diff --git a/docs/reference/analysis/tokenfilters/pattern_replace-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/pattern_replace-tokenfilter.asciidoc
index bc8cdc385bf56..85ddd236556f0 100644
--- a/docs/reference/analysis/tokenfilters/pattern_replace-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/pattern_replace-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-pattern_replace-tokenfilter]]
-=== Pattern Replace Token Filter
+=== Pattern replace token filter
+++++
+<titleabbrev>Pattern replace</titleabbrev>
+++++
 
 The `pattern_replace` token filter allows to easily handle string
 replacements based on a regular expression. The regular expression is
diff --git a/docs/reference/analysis/tokenfilters/phonetic-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/phonetic-tokenfilter.asciidoc
index 4a7324acc39a7..cceac39e691ca 100644
--- a/docs/reference/analysis/tokenfilters/phonetic-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/phonetic-tokenfilter.asciidoc
@@ -1,4 +1,7 @@
 [[analysis-phonetic-tokenfilter]]
-=== Phonetic Token Filter
+=== Phonetic token filter
+++++
+<titleabbrev>Phonetic</titleabbrev>
+++++
 
 The `phonetic` token filter is provided as the {plugins}/analysis-phonetic.html[`analysis-phonetic`] plugin.
diff --git a/docs/reference/analysis/tokenfilters/porterstem-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/porterstem-tokenfilter.asciidoc
index fc2edf526c372..519618c2b2108 100644
--- a/docs/reference/analysis/tokenfilters/porterstem-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/porterstem-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-porterstem-tokenfilter]]
-=== Porter Stem Token Filter
+=== Porter stem token filter
+++++
+<titleabbrev>Porter stem</titleabbrev>
+++++
 
 A token filter of type `porter_stem` that transforms the token stream as
 per the Porter stemming algorithm.
diff --git a/docs/reference/analysis/tokenfilters/predicate-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/predicate-tokenfilter.asciidoc
index e21e4e5690f60..2360b386aae55 100644
--- a/docs/reference/analysis/tokenfilters/predicate-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/predicate-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-predicatefilter-tokenfilter]]
-=== Predicate Token Filter Script
+=== Predicate script token filter
+++++
+<titleabbrev>Predicate script</titleabbrev>
+++++
 
 The predicate_token_filter token filter takes a predicate script, and removes tokens that do
 not match the predicate.
diff --git a/docs/reference/analysis/tokenfilters/remove-duplicates-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/remove-duplicates-tokenfilter.asciidoc
index 594e18eaf7f7e..e9dbf1ed15303 100644
--- a/docs/reference/analysis/tokenfilters/remove-duplicates-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/remove-duplicates-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-remove-duplicates-tokenfilter]]
-=== Remove Duplicates Token Filter
+=== Remove duplicates token filter
+++++
+<titleabbrev>Remove duplicates</titleabbrev>
+++++
 
 A token filter of type `remove_duplicates` that drops identical tokens at the
 same position.
diff --git a/docs/reference/analysis/tokenfilters/reverse-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/reverse-tokenfilter.asciidoc
index b00499815553b..08eaa796951c8 100644
--- a/docs/reference/analysis/tokenfilters/reverse-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/reverse-tokenfilter.asciidoc
@@ -1,4 +1,7 @@
 [[analysis-reverse-tokenfilter]]
-=== Reverse Token Filter
+=== Reverse token filter
+++++
+<titleabbrev>Reverse</titleabbrev>
+++++
 
 A token filter of type `reverse` that simply reverses each token.
diff --git a/docs/reference/analysis/tokenfilters/shingle-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/shingle-tokenfilter.asciidoc
index a6d544fc7b39d..5f6bec96dbae7 100644
--- a/docs/reference/analysis/tokenfilters/shingle-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/shingle-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-shingle-tokenfilter]]
-=== Shingle Token Filter
+=== Shingle token filter
+++++
+<titleabbrev>Shingle</titleabbrev>
+++++
 
 NOTE: Shingles are generally used to help speed up phrase queries.  Rather
 than building filter chains by hand, you may find it easier to use the
diff --git a/docs/reference/analysis/tokenfilters/snowball-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/snowball-tokenfilter.asciidoc
index bafb4fb7f7734..df1df3a43cb31 100644
--- a/docs/reference/analysis/tokenfilters/snowball-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/snowball-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-snowball-tokenfilter]]
-=== Snowball Token Filter
+=== Snowball token filter
+++++
+<titleabbrev>Snowball</titleabbrev>
+++++
 
 A filter that stems words using a Snowball-generated stemmer. The
 `language` parameter controls the stemmer with the following available
diff --git a/docs/reference/analysis/tokenfilters/stemmer-override-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/stemmer-override-tokenfilter.asciidoc
index d2fbba841808e..94d64bb82ea9b 100644
--- a/docs/reference/analysis/tokenfilters/stemmer-override-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/stemmer-override-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-stemmer-override-tokenfilter]]
-=== Stemmer Override Token Filter
+=== Stemmer override token filter
+++++
+<titleabbrev>Stemmer override</titleabbrev>
+++++
 
 Overrides stemming algorithms, by applying a custom mapping, then
 protecting these terms from being modified by stemmers. Must be placed
diff --git a/docs/reference/analysis/tokenfilters/stemmer-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/stemmer-tokenfilter.asciidoc
index 29ae8e96606c7..4e98e24d08ef0 100644
--- a/docs/reference/analysis/tokenfilters/stemmer-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/stemmer-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-stemmer-tokenfilter]]
-=== Stemmer Token Filter
+=== Stemmer token filter
+++++
+<titleabbrev>Stemmer</titleabbrev>
+++++
 
 // Adds attribute for the 'minimal_portuguese' stemmer values link.
 // This link contains ~, which is converted to subscript.
diff --git a/docs/reference/analysis/tokenfilters/stop-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/stop-tokenfilter.asciidoc
index f4019fa1800e9..3263d89e2b3ff 100644
--- a/docs/reference/analysis/tokenfilters/stop-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/stop-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-stop-tokenfilter]]
-=== Stop Token Filter
+=== Stop token filter
+++++
+<titleabbrev>Stop</titleabbrev>
+++++
 
 A token filter of type `stop` that removes stop words from token
 streams.
diff --git a/docs/reference/analysis/tokenfilters/synonym-graph-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/synonym-graph-tokenfilter.asciidoc
index 63e037de486f8..13e7609ac7ee2 100644
--- a/docs/reference/analysis/tokenfilters/synonym-graph-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/synonym-graph-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-synonym-graph-tokenfilter]]
-=== Synonym Graph Token Filter
+=== Synonym graph token filter
+++++
+<titleabbrev>Synonym graph</titleabbrev>
+++++
 
 The `synonym_graph` token filter allows to easily handle synonyms,
 including multi-word synonyms correctly during the analysis process.
diff --git a/docs/reference/analysis/tokenfilters/synonym-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/synonym-tokenfilter.asciidoc
index 3c0e967afc4bd..58caf8bb28281 100644
--- a/docs/reference/analysis/tokenfilters/synonym-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/synonym-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-synonym-tokenfilter]]
-=== Synonym Token Filter
+=== Synonym token filter
+++++
+<titleabbrev>Synonym</titleabbrev>
+++++
 
 The `synonym` token filter allows to easily handle synonyms during the
 analysis process. Synonyms are configured using a configuration file.
diff --git a/docs/reference/analysis/tokenfilters/trim-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/trim-tokenfilter.asciidoc
index 34a0e93a3af22..1373811b0cb82 100644
--- a/docs/reference/analysis/tokenfilters/trim-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/trim-tokenfilter.asciidoc
@@ -1,4 +1,7 @@
 [[analysis-trim-tokenfilter]]
-=== Trim Token Filter
+=== Trim token filter
+++++
+<titleabbrev>Trim</titleabbrev>
+++++
 
 The `trim` token filter trims the whitespace surrounding a token.
diff --git a/docs/reference/analysis/tokenfilters/truncate-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/truncate-tokenfilter.asciidoc
index 4c28ddba38146..c1d171dbbbbc0 100644
--- a/docs/reference/analysis/tokenfilters/truncate-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/truncate-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-truncate-tokenfilter]]
-=== Truncate Token Filter
+=== Truncate token filter
+++++
+<titleabbrev>Truncate</titleabbrev>
+++++
 
 The `truncate` token filter can be used to truncate tokens into a
 specific length.
diff --git a/docs/reference/analysis/tokenfilters/unique-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/unique-tokenfilter.asciidoc
index 8b42f6b73b934..6ce084c183ff4 100644
--- a/docs/reference/analysis/tokenfilters/unique-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/unique-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-unique-tokenfilter]]
-=== Unique Token Filter
+=== Unique token filter
+++++
+<titleabbrev>Unique</titleabbrev>
+++++
 
 The `unique` token filter can be used to only index unique tokens during
 analysis. By default it is applied on all the token stream. If
diff --git a/docs/reference/analysis/tokenfilters/uppercase-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/uppercase-tokenfilter.asciidoc
index 639d1e9106849..c745f247ec3d9 100644
--- a/docs/reference/analysis/tokenfilters/uppercase-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/uppercase-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-uppercase-tokenfilter]]
-=== Uppercase Token Filter
+=== Uppercase token filter
+++++
+<titleabbrev>Uppercase</titleabbrev>
+++++
 
 A token filter of type `uppercase` that normalizes token text to upper
 case.
diff --git a/docs/reference/analysis/tokenfilters/word-delimiter-graph-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/word-delimiter-graph-tokenfilter.asciidoc
index 4acd0163109a4..66e7b18c74426 100644
--- a/docs/reference/analysis/tokenfilters/word-delimiter-graph-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/word-delimiter-graph-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-word-delimiter-graph-tokenfilter]]
-=== Word Delimiter Graph Token Filter
+=== Word delimiter graph token filter
+++++
+<titleabbrev>Word delimiter graph</titleabbrev>
+++++
 
 experimental[This functionality is marked as experimental in Lucene]
 
diff --git a/docs/reference/analysis/tokenfilters/word-delimiter-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/word-delimiter-tokenfilter.asciidoc
index 1c07176430eed..d0cea87176d41 100644
--- a/docs/reference/analysis/tokenfilters/word-delimiter-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/word-delimiter-tokenfilter.asciidoc
@@ -1,5 +1,8 @@
 [[analysis-word-delimiter-tokenfilter]]
-=== Word Delimiter Token Filter
+=== Word delimiter token filter
+++++
+<titleabbrev>Word delimiter</titleabbrev>
+++++
 
 Named `word_delimiter`, it Splits words into subwords and performs
 optional transformations on subword groups. Words are split into

From 30b4133872dcfb0abbf79b291cc735f11b4d90ba Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 27 Dec 2019 13:41:05 -0500
Subject: [PATCH 342/686] Adjust tests after always enable soft-deletes in 8.0

The InternalEngine always enables soft deletes in 8.0 regardless of the
setting. We need to wait for the global checkpoint and peer recovery
retention leases to be synced in these tests.

Relates #50415
---
 .../index/shard/IndexShardTests.java          | 14 ++++++-------
 .../indices/stats/IndexStatsIT.java           | 20 +++++++++----------
 .../SharedClusterSnapshotRestoreIT.java       |  9 ++-------
 3 files changed, 17 insertions(+), 26 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java b/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
index 21d3c95c5942f..6a8a63ce17f32 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
@@ -3511,14 +3511,12 @@ public void testSegmentMemoryTrackedInBreaker() throws Exception {
         // Here we are testing that a fully deleted segment should be dropped and its memory usage is freed.
         // In order to instruct the merge policy not to keep a fully deleted segment,
         // we need to flush and make that commit safe so that the SoftDeletesPolicy can drop everything.
-        if (IndexSettings.INDEX_SOFT_DELETES_SETTING.get(settings)) {
-            primary.updateGlobalCheckpointForShard(
-                primary.routingEntry().allocationId().getId(),
-                primary.getLastSyncedGlobalCheckpoint());
-            primary.syncRetentionLeases();
-            primary.sync();
-            flushShard(primary);
-        }
+        primary.updateGlobalCheckpointForShard(
+            primary.routingEntry().allocationId().getId(),
+            primary.getLastSyncedGlobalCheckpoint());
+        primary.syncRetentionLeases();
+        primary.sync();
+        flushShard(primary);
         primary.refresh("force refresh");
 
         ss = primary.segmentStats(randomBoolean(), randomBoolean());
diff --git a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
index a77091a2ce93e..70eb62e127c75 100644
--- a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
@@ -1017,17 +1017,15 @@ public void testFilterCacheStats() throws Exception {
         // Here we are testing that a fully deleted segment should be dropped and its cached is evicted.
         // In order to instruct the merge policy not to keep a fully deleted segment,
         // we need to flush and make that commit safe so that the SoftDeletesPolicy can drop everything.
-        if (IndexSettings.INDEX_SOFT_DELETES_SETTING.get(settings)) {
-            persistGlobalCheckpoint("index");
-            assertBusy(() -> {
-                for (final ShardStats shardStats : client().admin().indices().prepareStats("index").get().getIndex("index").getShards()) {
-                    final long maxSeqNo = shardStats.getSeqNoStats().getMaxSeqNo();
-                    assertTrue(shardStats.getRetentionLeaseStats().retentionLeases().leases().stream()
-                        .allMatch(retentionLease -> retentionLease.retainingSequenceNumber() == maxSeqNo + 1));
-                }
-            });
-            flush("index");
-        }
+        persistGlobalCheckpoint("index");
+        assertBusy(() -> {
+            for (final ShardStats shardStats : client().admin().indices().prepareStats("index").get().getIndex("index").getShards()) {
+                final long maxSeqNo = shardStats.getSeqNoStats().getMaxSeqNo();
+                assertTrue(shardStats.getRetentionLeaseStats().retentionLeases().leases().stream()
+                    .allMatch(retentionLease -> retentionLease.retainingSequenceNumber() == maxSeqNo + 1));
+            }
+        });
+        flush("index");
         logger.info("--> force merging to a single segment");
         ForceMergeResponse forceMergeResponse =
             client().admin().indices().prepareForceMerge("index").setFlush(true).setMaxNumSegments(1).get();
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java b/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
index e31ad37296093..b54359e516d00 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
@@ -117,7 +117,6 @@
 import static org.elasticsearch.cluster.routing.allocation.decider.MaxRetryAllocationDecider.SETTING_ALLOCATION_MAX_RETRY;
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
 import static org.elasticsearch.index.IndexSettings.INDEX_REFRESH_INTERVAL_SETTING;
-import static org.elasticsearch.index.IndexSettings.INDEX_SOFT_DELETES_SETTING;
 import static org.elasticsearch.index.query.QueryBuilders.matchQuery;
 import static org.elasticsearch.index.shard.IndexShardTests.getEngineFromShard;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
@@ -2325,12 +2324,8 @@ public void testSnapshotMoreThanOnce() throws ExecutionException, InterruptedExc
             List<SnapshotIndexShardStatus> shards = snapshotStatus.getShards();
             for (SnapshotIndexShardStatus status : shards) {
                 // we flush before the snapshot such that we have to process the segments_N files plus the .del file
-                if (INDEX_SOFT_DELETES_SETTING.get(settings)) {
-                    // soft-delete generates DV files.
-                    assertThat(status.getStats().getProcessedFileCount(), greaterThan(2));
-                } else {
-                    assertThat(status.getStats().getProcessedFileCount(), equalTo(2));
-                }
+                // soft-delete generates DV files.
+                assertThat(status.getStats().getProcessedFileCount(), greaterThan(2));
             }
         }
     }

From e163058801b0a599a5356315f4f514ccde37b5a7 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Sun, 29 Dec 2019 16:40:42 -0500
Subject: [PATCH 343/686] Fix hard-deletes engine simulation (#50517)

The test "testRecoverFromHardDeletesIndex" failed because the
"min_retained_seqno" commit tag exists after we index using a
hard-deletes engine. A hard-deletes engine must not create this
commit tag; hence we need to remove it in the test.

Relates #50415
---
 .../index/engine/InternalEngineTests.java         | 15 +++++++++++++++
 .../index/engine/EngineTestCase.java              |  9 +++++----
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
index 9a2f79b7530a7..b9fe4c7dc4d98 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
@@ -5464,7 +5464,22 @@ public long softUpdateDocuments(Term term, Iterable<? extends Iterable<? extends
                 }
                 docs = getDocIds(hardDeletesEngine, true);
             }
+            // We need to remove min_retained_seq_no commit tag as the actual hard-deletes engine does not have it.
+            store.trimUnsafeCommits(translogPath);
+            Map<String, String> userData = new HashMap<>(store.readLastCommittedSegmentsInfo().userData);
+            userData.remove(Engine.MIN_RETAINED_SEQNO);
+            IndexWriterConfig indexWriterConfig = new IndexWriterConfig(null)
+                .setOpenMode(IndexWriterConfig.OpenMode.APPEND)
+                .setIndexCreatedVersionMajor(Version.CURRENT.luceneVersion.major)
+                .setSoftDeletesField(Lucene.SOFT_DELETES_FIELD)
+                .setCommitOnClose(false)
+                .setMergePolicy(NoMergePolicy.INSTANCE);
+            try (IndexWriter writer = new IndexWriter(store.directory(), indexWriterConfig)) {
+                writer.setLiveCommitData(userData.entrySet());
+                writer.commit();
+            }
             try (InternalEngine softDeletesEngine = new InternalEngine(config)) { // do not recover from translog
+                assertThat(softDeletesEngine.getLastCommittedSegmentInfos().userData, equalTo(userData));
                 assertThat(softDeletesEngine.getVersionMap().keySet(), empty());
                 softDeletesEngine.recoverFromTranslog(translogHandler, Long.MAX_VALUE);
                 if (randomBoolean()) {
diff --git a/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java b/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
index 81b2bdd8385ec..6ec344783c8f2 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
@@ -1088,15 +1088,16 @@ public static void assertConsistentHistoryBetweenTranslogAndLuceneIndex(Engine e
         }
         final long globalCheckpoint = EngineTestCase.getTranslog(engine).getLastSyncedGlobalCheckpoint();
         final long retainedOps = engine.config().getIndexSettings().getSoftDeleteRetentionOperations();
-        final long seqNoForRecovery;
+        final long minSeqNoToRetain;
         if (engine.config().getIndexSettings().isSoftDeleteEnabled()) {
             try (Engine.IndexCommitRef safeCommit = engine.acquireSafeIndexCommit()) {
-                seqNoForRecovery = Long.parseLong(safeCommit.getIndexCommit().getUserData().get(SequenceNumbers.LOCAL_CHECKPOINT_KEY)) + 1;
+                final long seqNoForRecovery = Long.parseLong(
+                    safeCommit.getIndexCommit().getUserData().get(SequenceNumbers.LOCAL_CHECKPOINT_KEY)) + 1;
+                minSeqNoToRetain = Math.min(seqNoForRecovery, globalCheckpoint + 1 - retainedOps);
             }
         } else {
-            seqNoForRecovery = engine.getMinRetainedSeqNo();
+            minSeqNoToRetain = engine.getMinRetainedSeqNo();
         }
-        final long minSeqNoToRetain = Math.min(seqNoForRecovery, globalCheckpoint + 1 - retainedOps);
         for (Translog.Operation translogOp : translogOps) {
             final Translog.Operation luceneOp = luceneOps.get(translogOp.seqNo());
             if (luceneOp == null) {

From 85af0dd5820fdc57cfd22148d3346e071fe52636 Mon Sep 17 00:00:00 2001
From: riverbuilding <riverbuilding@hotmail.com>
Date: Mon, 30 Dec 2019 08:48:10 -0500
Subject: [PATCH 344/686] [DOCS] Correct Painless operator typos (#50472)

---
 .../painless-lang-spec/painless-operators-numeric.asciidoc  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/painless/painless-lang-spec/painless-operators-numeric.asciidoc b/docs/painless/painless-lang-spec/painless-operators-numeric.asciidoc
index 22c2f04d50677..80fedd6e9b69c 100644
--- a/docs/painless/painless-lang-spec/painless-operators-numeric.asciidoc
+++ b/docs/painless/painless-lang-spec/painless-operators-numeric.asciidoc
@@ -1204,7 +1204,7 @@ The following table illustrates the resultant bit from the xoring of two bits.
 
 [source,ANTLR4]
 ----
-bitwise_and: expression '^' expression;
+bitwise_xor: expression '^' expression;
 ----
 
 *Promotion*
@@ -1284,7 +1284,7 @@ The following table illustrates the resultant bit from the oring of two bits.
 
 [source,ANTLR4]
 ----
-bitwise_and: expression '|' expression;
+bitwise_or: expression '|' expression;
 ----
 
 *Promotion*
@@ -1336,4 +1336,4 @@ def y = x ^ 8; <2>
     implicit cast `def` to `int 7`;
     bitwise or `int 7` and `int 8` -> `int 15`;
     implicit cast `int 15` to `def` -> `def`;
-    store `def` to `y`
\ No newline at end of file
+    store `def` to `y`

From 8d3deeb5e181c630deee4040b9cf54c9e77efd11 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Mon, 30 Dec 2019 07:03:38 -0800
Subject: [PATCH 345/686] [DOCS] Adds intro for OIDC realm (#50485)

---
 .../en/security/authentication/index.asciidoc |  1 +
 .../authentication/oidc-realm.asciidoc        | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+)
 create mode 100644 x-pack/docs/en/security/authentication/oidc-realm.asciidoc

diff --git a/x-pack/docs/en/security/authentication/index.asciidoc b/x-pack/docs/en/security/authentication/index.asciidoc
index 3055a6024ab10..7b20e3220ea40 100644
--- a/x-pack/docs/en/security/authentication/index.asciidoc
+++ b/x-pack/docs/en/security/authentication/index.asciidoc
@@ -9,6 +9,7 @@ include::active-directory-realm.asciidoc[]
 include::file-realm.asciidoc[]
 include::ldap-realm.asciidoc[]
 include::native-realm.asciidoc[]
+include::oidc-realm.asciidoc[]
 include::pki-realm.asciidoc[]
 include::saml-realm.asciidoc[]
 include::kerberos-realm.asciidoc[]
diff --git a/x-pack/docs/en/security/authentication/oidc-realm.asciidoc b/x-pack/docs/en/security/authentication/oidc-realm.asciidoc
new file mode 100644
index 0000000000000..7d47e5288eb10
--- /dev/null
+++ b/x-pack/docs/en/security/authentication/oidc-realm.asciidoc
@@ -0,0 +1,19 @@
+[role="xpack"]
+[[oidc-realm]]
+=== OpenID Connect authentication
+
+The OpenID Connect realm enables {es} to serve as an OpenID Connect Relying
+Party (RP) and provides single sign-on (SSO) support in {kib}. 
+
+It is specifically designed to support authentication via an interactive web
+browser, so it does not operate as a standard authentication realm. Instead,
+there are {kib} and {es} {security-features} that work together to enable
+interactive OpenID Connect sessions.
+
+This means that the OpenID Connect realm is not suitable for use by standard
+REST clients. If you configure an OpenID Connect realm for use in {kib}, you
+should also configure another realm, such as the <<native-realm, native realm>>
+in your authentication chain.
+
+In order to simplify the process of configuring OpenID Connect authentication
+within the {stack}, there is a step-by-step guide: <<oidc-guide>>.

From c29cdc1352b5d35c8c7dd960a5bf015eb0175851 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Mon, 30 Dec 2019 11:30:30 -0500
Subject: [PATCH 346/686] Replace synced-flush with flush in rolling upgrade to
 8.0 (#50524)

This change recommends using a regular flush instead of synced-flush in
a rolling upgrade from 7.x to 8.0. We can perform noop recoveries with a
regular flush
---
 docs/reference/upgrade/rolling_upgrade.asciidoc | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/docs/reference/upgrade/rolling_upgrade.asciidoc b/docs/reference/upgrade/rolling_upgrade.asciidoc
index 96b3d12fb0264..02a85814537a5 100644
--- a/docs/reference/upgrade/rolling_upgrade.asciidoc
+++ b/docs/reference/upgrade/rolling_upgrade.asciidoc
@@ -36,15 +36,17 @@ To perform a rolling upgrade to {version}:
 include::disable-shard-alloc.asciidoc[]
 --
 
-. *Stop non-essential indexing and perform a synced flush.* (Optional)
+. *Stop non-essential indexing and perform a flush.* (Optional)
 +
 --
 While you can continue indexing during the upgrade, shard recovery
 is much faster if you temporarily stop non-essential indexing and perform a
-<<indices-synced-flush-api, synced-flush>>.
-
-include::synced-flush.asciidoc[]
+<<indices-flush, flush>>.
 
+[source,console]
+--------------------------------------------------
+POST /_flush
+--------------------------------------------------
 --
 
 . *Temporarily stop the tasks associated with active {ml} jobs and {dfeeds}.* (Optional)
@@ -148,7 +150,7 @@ As soon as another node is upgraded, the replicas can be assigned and the
 status will change to `green`.
 ====================================================
 
-Shards that were not <<indices-synced-flush-api,sync-flushed>> might take longer to
+Shards that were not <<indices-flush,flushed>> might take longer to
 recover.  You can monitor the recovery status of individual shards by
 submitting a <<cat-recovery,`_cat/recovery`>> request:
 

From e24506680487fdfe1142f91d75a8bb1f331243ff Mon Sep 17 00:00:00 2001
From: Jake <jakesyl@gmail.com>
Date: Mon, 30 Dec 2019 15:38:59 -0500
Subject: [PATCH 347/686] [DOCS] Bump copyright to 2019 for Java HLRC license
 (#50206)

---
 docs/java-rest/license.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/java-rest/license.asciidoc b/docs/java-rest/license.asciidoc
index 687974868274e..2ec3d15197439 100644
--- a/docs/java-rest/license.asciidoc
+++ b/docs/java-rest/license.asciidoc
@@ -1,6 +1,6 @@
 == License
 
-Copyright 2013-2018 Elasticsearch
+Copyright 2013-2019 Elasticsearch
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

From dc3c829375bcf32f6d38da1d215717b7027863ab Mon Sep 17 00:00:00 2001
From: lcawl <lcawley@elastic.co>
Date: Mon, 30 Dec 2019 15:21:18 -0800
Subject: [PATCH 348/686] [DOCS] Minor fixes in ML APIs

---
 .../anomaly-detection/apis/close-job.asciidoc |  4 +-
 .../apis/delete-calendar-event.asciidoc       |  3 --
 .../apis/delete-calendar-job.asciidoc         |  3 --
 .../apis/delete-calendar.asciidoc             |  2 -
 .../apis/delete-datafeed.asciidoc             |  2 -
 .../apis/delete-filter.asciidoc               |  2 -
 .../apis/delete-forecast.asciidoc             |  2 -
 .../apis/delete-job.asciidoc                  |  2 -
 .../apis/delete-snapshot.asciidoc             |  2 -
 .../anomaly-detection/apis/flush-job.asciidoc |  6 +--
 .../anomaly-detection/apis/forecast.asciidoc  |  5 +-
 .../apis/get-bucket.asciidoc                  | 51 +++++++++----------
 .../apis/get-calendar-event.asciidoc          |  3 --
 .../apis/get-calendar.asciidoc                |  3 --
 .../apis/get-datafeed.asciidoc                |  3 --
 .../apis/get-filter.asciidoc                  |  3 --
 .../apis/get-job-stats.asciidoc               |  2 +-
 .../anomaly-detection/apis/get-job.asciidoc   |  2 -
 .../apis/get-overall-buckets.asciidoc         |  3 --
 .../anomaly-detection/apis/open-job.asciidoc  |  7 +--
 .../apis/post-calendar-event.asciidoc         |  2 -
 .../apis/put-datafeed.asciidoc                |  2 -
 .../apis/put-filter.asciidoc                  |  2 -
 .../anomaly-detection/apis/put-job.asciidoc   |  2 -
 .../apis/start-datafeed.asciidoc              |  8 ++-
 .../apis/stop-datafeed.asciidoc               |  6 +--
 .../apis/update-datafeed.asciidoc             |  4 --
 .../apis/update-filter.asciidoc               |  3 --
 .../apis/update-job.asciidoc                  |  2 -
 .../apis/update-snapshot.asciidoc             |  2 -
 .../apis/validate-detector.asciidoc           |  2 -
 .../apis/validate-job.asciidoc                |  2 -
 32 files changed, 37 insertions(+), 110 deletions(-)

diff --git a/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
index 7f9fd0489ab77..0700d92ba7283 100644
--- a/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
@@ -92,9 +92,9 @@ The following example closes the `total-requests` job:
 
 [source,console]
 --------------------------------------------------
-POST _ml/anomaly_detectors/total-requests/_close
+POST _ml/anomaly_detectors/low_request_rate/_close
 --------------------------------------------------
-// TEST[skip:sometimes fails due to https://github.com/elastic/elasticsearch/pull/48583#issuecomment-552991325 - on unmuting use setup:server_metrics_openjob-raw]
+// TEST[skip:sometimes fails due to https://github.com/elastic/elasticsearch/pull/48583#issuecomment-552991325]
 
 When the job is closed, you receive the following results:
 
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
index e0be1e135afcf..d401d7dc052d4 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
@@ -40,9 +40,6 @@ events and delete the calendar, see the
 [[ml-delete-calendar-event-example]]
 ==== {api-examples-title}
 
-The following example deletes a scheduled event from the `planned-outages`
-calendar:
-
 [source,console]
 --------------------------------------------------
 DELETE _ml/calendars/planned-outages/events/LS8LJGEBMTCMA-qz49st
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
index 6b705b8c6f932..12f7b88769dd8 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
@@ -33,9 +33,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-list]
 [[ml-delete-calendar-job-example]]
 ==== {api-examples-title}
 
-The following example removes the association between the `planned-outages`
-calendar and `total-requests` job:
-
 [source,console]
 --------------------------------------------------
 DELETE _ml/calendars/planned-outages/jobs/total-requests
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
index c9dad6bbba19c..e9ac45e35600a 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
@@ -35,8 +35,6 @@ calendar.
 [[ml-delete-calendar-example]]
 ==== {api-examples-title}
 
-The following example deletes the `planned-outages` calendar:
-
 [source,console]
 --------------------------------------------------
 DELETE _ml/calendars/planned-outages
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
index d933afe4f9a42..a555dd9285c5b 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
@@ -41,8 +41,6 @@ quicker than stopping and deleting the {dfeed}.
 [[ml-delete-datafeed-example]]
 ==== {api-examples-title}
 
-The following example deletes the `datafeed-total-requests` {dfeed}:
-
 [source,console]
 --------------------------------------------------
 DELETE _ml/datafeeds/datafeed-total-requests
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
index ffb2f7b894cc4..2894aaefb7a89 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
@@ -36,8 +36,6 @@ update or delete the job before you can delete the filter.
 [[ml-delete-filter-example]]
 ==== {api-examples-title}
 
-The following example deletes the `safe_domains` filter:
-
 [source,console]
 --------------------------------------------------
 DELETE _ml/filters/safe_domains
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
index 80eb03c75b59d..e3b0161a17f64 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
@@ -67,8 +67,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 [[ml-delete-forecast-example]]
 ==== {api-examples-title}
 
-The following example deletes all forecasts from the `total-requests` job:
-
 [source,console]
 --------------------------------------------------
 DELETE _ml/anomaly_detectors/total-requests/_forecast/_all
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
index 0c04ec468bbbf..cb2d59fbc825a 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
@@ -56,8 +56,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 [[ml-delete-job-example]]
 ==== {api-examples-title}
 
-The following example deletes the `total-requests` job:
-
 [source,console]
 --------------------------------------------------
 DELETE _ml/anomaly_detectors/total-requests
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
index 90d0303b9aff3..0894d6373d874 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
@@ -40,8 +40,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 [[ml-delete-snapshot-example]]
 ==== {api-examples-title}
 
-The following example deletes the `1491948163` snapshot:
-
 [source,console]
 --------------------------------------------------
 DELETE _ml/anomaly_detectors/farequote/model_snapshots/1491948163
diff --git a/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
index f6e81a3b26131..510e5b9a7b863 100644
--- a/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
@@ -67,16 +67,14 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 [[ml-flush-job-example]]
 ==== {api-examples-title}
 
-The following example flushes the `total-requests` job:
-
 [source,console]
 --------------------------------------------------
-POST _ml/anomaly_detectors/total-requests/_flush
+POST _ml/anomaly_detectors/low_request_rate/_flush
 {
   "calc_interim": true
 }
 --------------------------------------------------
-// TEST[skip:setup:server_metrics_openjob]
+// TEST[skip:Kibana sample data]
 
 When the operation succeeds, you receive the following results:
 
diff --git a/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
index 61b8981843184..f083639ff248b 100644
--- a/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
@@ -57,11 +57,9 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 [[ml-forecast-example]]
 ==== {api-examples-title}
 
-The following example requests a 10 day forecast for the `total-requests` job:
-
 [source,console]
 --------------------------------------------------
-POST _ml/anomaly_detectors/total-requests/_forecast
+POST _ml/anomaly_detectors/low_request_rate/_forecast
 {
   "duration": "10d"
 }
@@ -79,4 +77,3 @@ When the forecast is created, you receive the following results:
 // NOTCONSOLE
 
 You can subsequently see the forecast in the *Single Metric Viewer* in {kib}.
-
diff --git a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
index a34d6bc714a99..a3e5606f25d82 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
@@ -170,50 +170,47 @@ the results for the bucket.
 [[ml-get-bucket-example]]
 ==== {api-examples-title}
 
-The following example gets bucket information for the `it-ops-kpi` job:
-
 [source,console]
 --------------------------------------------------
-GET _ml/anomaly_detectors/it-ops-kpi/results/buckets
+GET _ml/anomaly_detectors/low_request_rate/results/buckets
 {
   "anomaly_score": 80,
   "start": "1454530200001"
 }
 --------------------------------------------------
-// TEST[skip:todo]
+// TEST[skip:Kibana sample data]
 
 In this example, the API returns a single result that matches the specified
 score and time constraints:
 [source,js]
 ----
 {
-  "count": 1,
-  "buckets": [
+  "count" : 1,
+  "buckets" : [
     {
-      "job_id": "it-ops-kpi",
-      "timestamp": 1454943900000,
-      "anomaly_score": 94.1706,
-      "bucket_span": 300,
-      "initial_anomaly_score": 94.1706,
-      "event_count": 153,
-      "is_interim": false,
-      "bucket_influencers": [
+      "job_id" : "low_request_rate",
+      "timestamp" : 1578398400000,
+      "anomaly_score" : 91.58505459594764,
+      "bucket_span" : 3600,
+      "initial_anomaly_score" : 91.58505459594764,
+      "event_count" : 0,
+      "is_interim" : false,
+      "bucket_influencers" : [
         {
-          "job_id": "it-ops-kpi",
-          "result_type": "bucket_influencer",
-          "influencer_field_name": "bucket_time",
-          "initial_anomaly_score": 94.1706,
-          "anomaly_score": 94.1706,
-          "raw_anomaly_score": 2.32119,
-          "probability": 0.00000575042,
-          "timestamp": 1454943900000,
-          "bucket_span": 300,
-          "is_interim": false
+          "job_id" : "low_request_rate",
+          "result_type" : "bucket_influencer",
+          "influencer_field_name" : "bucket_time",
+          "initial_anomaly_score" : 91.58505459594764,
+          "anomaly_score" : 91.58505459594764,
+          "raw_anomaly_score" : 0.5758246639716365,
+          "probability" : 1.7340849573442696E-4,
+          "timestamp" : 1578398400000,
+          "bucket_span" : 3600,
+          "is_interim" : false
         }
       ],
-      "processing_time_ms": 2,
-      "partition_scores": [],
-      "result_type": "bucket"
+      "processing_time_ms" : 0,
+      "result_type" : "bucket"
     }
   ]
 }
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
index f3fcd65aab210..22fdc718c5d8e 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
@@ -80,9 +80,6 @@ following properties:
 [[ml-get-calendar-event-example]]
 ==== {api-examples-title}
 
-The following example gets information about the scheduled events in the
-`planned-outages` calendar:
-
 [source,console]
 --------------------------------------------------
 GET _ml/calendars/planned-outages/events
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
index 0d0d85090df69..9c56a7742de5b 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
@@ -62,9 +62,6 @@ properties:
 [[ml-get-calendar-example]]
 ==== {api-examples-title}
 
-The following example gets configuration information for the `planned-outages`
-calendar:
-
 [source,console]
 --------------------------------------------------
 GET _ml/calendars/planned-outages
diff --git a/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
index 368824aea6d51..8e96235b7fb05 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
@@ -73,9 +73,6 @@ see <<ml-put-datafeed-request-body,create {dfeeds} API>>.
 [[ml-get-datafeed-example]]
 ==== {api-examples-title}
 
-The following example gets configuration information for the
-`datafeed-high_sum_total_sales` {dfeed}:
-
 [source,console]
 --------------------------------------------------
 GET _ml/datafeeds/datafeed-high_sum_total_sales
diff --git a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
index d53155681c7fa..9da2f44c198c7 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
@@ -61,9 +61,6 @@ properties:
 [[ml-get-filter-example]]
 ==== {api-examples-title}
 
-The following example gets configuration information for the `safe_domains`
-filter:
-
 [source,console]
 --------------------------------------------------
 GET _ml/filters/safe_domains
diff --git a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
index 9b9038abaa95b..9bf583595494d 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
@@ -165,7 +165,7 @@ NOTE: Unless there is at least one forecast, `memory_bytes`, `records`,
 
 `forecasts_stats`.`records`:::
 (object) Statistics about the number of forecast records: minimum, maximum,
-saverage and total.
+average and total.
 
 `forecasts_stats`.`processing_time_ms`:::
 (object) Statistics about the forecast runtime in milliseconds: minimum, maximum,
diff --git a/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
index 5f4da902734fe..0eab920cff7ea 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
@@ -86,8 +86,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-id]
 [[ml-get-job-example]]
 ==== {api-examples-title}
 
-//The following example gets configuration information for the `total-requests` job:
-
 [source,console]
 --------------------------------------------------
 GET _ml/anomaly_detectors/high_sum_total_sales
diff --git a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
index ab1b5588cccfd..6b0c6bf503918 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
@@ -120,9 +120,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=timestamp-results]
 [[ml-get-overall-buckets-example]]
 ==== {api-examples-title}
 
-The following example gets overall buckets for {anomaly-jobs} with IDs matching
-`job-*`:
-
 [source,console]
 --------------------------------------------------
 GET _ml/anomaly_detectors/job-*/results/overall_buckets
diff --git a/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
index 3651834480f10..39f3488201925 100644
--- a/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
@@ -50,17 +50,14 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 [[ml-open-job-example]]
 ==== {api-examples-title}
 
-The following example opens the `total-requests` job and sets an optional
-property:
-
 [source,console]
 --------------------------------------------------
-POST _ml/anomaly_detectors/total-requests/_open
+POST _ml/anomaly_detectors/low_request_rate/_open
 {
   "timeout": "35m"
 }
 --------------------------------------------------
-// TEST[skip:setup:server_metrics_job]
+// TEST[skip:Kibana sample data]
 
 When the job opens, you receive the following results:
 
diff --git a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
index 8a621f1faafff..76e7111fcd0cb 100644
--- a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
@@ -58,8 +58,6 @@ of which must have a start time, end time, and description.
 [[ml-post-calendar-event-example]]
 ==== {api-examples-title}
 
-You can add scheduled events to the `planned-outages` calendar as follows:
-
 [source,console]
 --------------------------------------------------
 POST _ml/calendars/planned-outages/events
diff --git a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
index a5a168b9f9c14..796d4995404a9 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
@@ -96,8 +96,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
 [[ml-put-datafeed-example]]
 ==== {api-examples-title}
 
-The following example creates the `datafeed-total-requests` {dfeed}:
-
 [source,console]
 --------------------------------------------------
 PUT _ml/datafeeds/datafeed-total-requests
diff --git a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
index 86245d84dbb28..3168389690a75 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
@@ -47,8 +47,6 @@ the `custom_rules` property of detector configuration objects.
 [[ml-put-filter-example]]
 ==== {api-examples-title}
 
-The following example creates the `safe_domains` filter:
-
 [source,console]
 --------------------------------------------------
 PUT _ml/filters/safe_domains
diff --git a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
index 16c14c5faae41..1c4e59e1341be 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
@@ -231,8 +231,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=results-retention-days]
 [[ml-put-job-example]]
 ==== {api-examples-title}
 
-The following example creates the `total-requests` job:
-
 [source,console]
 --------------------------------------------------
 PUT _ml/anomaly_detectors/total-requests
diff --git a/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
index dd3e6bbdfff54..2dffa5e62481e 100644
--- a/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
@@ -95,16 +95,14 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 [[ml-start-datafeed-example]]
 ==== {api-examples-title}
 
-The following example starts the `datafeed-it-ops-kpi` {dfeed}:
-
 [source,console]
 --------------------------------------------------
-POST _ml/datafeeds/datafeed-total-requests/_start
+POST _ml/datafeeds/datafeed-low_request_rate/_start
 {
-  "start": "2017-04-07T18:22:16Z"
+  "start": "2019-04-07T18:22:16Z"
 }
 --------------------------------------------------
-// TEST[skip:setup:server_metrics_openjob]
+// TEST[skip:Kibana sample data]
 
 When the {dfeed} starts, you receive the following results:
 
diff --git a/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
index f115d8657f7ec..21f46cef0b740 100644
--- a/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
@@ -70,16 +70,14 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
 [[ml-stop-datafeed-example]]
 ==== {api-examples-title}
 
-The following example stops the `datafeed-total-requests` {dfeed}:
-
 [source,console]
 --------------------------------------------------
-POST _ml/datafeeds/datafeed-total-requests/_stop
+POST _ml/datafeeds/datafeed-low_request_rate/_stop
 {
   "timeout": "30s"
 }
 --------------------------------------------------
-// TEST[skip:setup:server_metrics_startdf]
+// TEST[skip:Kibana sample data]
 
 When the {dfeed} stops, you receive the following results:
 
diff --git a/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
index 1336f71fcff77..044c65f11abcf 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
@@ -104,9 +104,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
 [[ml-update-datafeed-example]]
 ==== {api-examples-title}
 
-The following example updates the query for the `datafeed-total-requests`
-{dfeed} so that only log entries of error level are analyzed:
-
 [source,console]
 --------------------------------------------------
 POST _ml/datafeeds/datafeed-total-requests/_update
@@ -120,7 +117,6 @@ POST _ml/datafeeds/datafeed-total-requests/_update
 --------------------------------------------------
 // TEST[skip:setup:server_metrics_datafeed]
 
-
 When the {dfeed} is updated, you receive the full {dfeed} configuration with
 with the updated values:
 
diff --git a/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
index a4aa5c3cab155..bf55d6900b1ec 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
@@ -41,9 +41,6 @@ Updates the description of a filter, adds items, or removes items.
 [[ml-update-filter-example]]
 ==== {api-examples-title}
 
-You can change the description, add and remove items to the `safe_domains`
-filter as follows:
-
 [source,console]
 --------------------------------------------------
 POST _ml/filters/safe_domains/_update
diff --git a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
index dff75da52f841..1fd3a6e620379 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
@@ -162,8 +162,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=results-retention-days]
 [[ml-update-job-example]]
 ==== {api-examples-title}
 
-The following example updates the `total-requests` job:
-
 [source,console]
 --------------------------------------------------
 POST _ml/anomaly_detectors/total-requests/_update
diff --git a/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
index e0220042eccb0..da2bdfa3d3eab 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
@@ -48,8 +48,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=retain]
 [[ml-update-snapshot-example]]
 ==== {api-examples-title}
 
-The following example updates the snapshot identified as `1491852978`:
-
 [source,console]
 --------------------------------------------------
 POST
diff --git a/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
index 247eb32b10dc7..8c24c8e13a80c 100644
--- a/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
@@ -107,8 +107,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=use-null]
 [[ml-valid-detector-example]]
 ==== {api-examples-title}
 
-The following example validates detector configuration information:
-
 [source,console]
 --------------------------------------------------
 POST _ml/anomaly_detectors/_validate/detector
diff --git a/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
index 750af88339c20..c74d46421dbf0 100644
--- a/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
@@ -35,8 +35,6 @@ see <<ml-put-job-request-body>>.
 [[ml-valid-job-example]]
 ==== {api-examples-title}
 
-The following example validates job configuration information:
-
 [source,console]
 --------------------------------------------------
 POST _ml/anomaly_detectors/_validate

From 9908f02dc9925cc8910002307943df0b2a6e3cf2 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Thu, 2 Jan 2020 11:14:47 +0000
Subject: [PATCH 349/686] Remove CreateIndexRequest.addMapping(type, string,
 xcontenttype) (#50419)

We still have a number of places, mainly in test code but some in production, that
are building mappings with a named type as the root of a map. CreateIndexRequest
handles this automatically, but PutMappingRequest does not, which is a bit trappy -
we can get situations like #50359 where the same mapping will work when an
index is created but fail on an update.

This commit is a first step to removing the leniency in CreateIndexRequest so that
we can catch mappings with a named type root earlier.

Relates to #41059
---
 .../indices/create/CreateIndexRequest.java    | 11 --------
 .../create/CreateIndexRequestBuilder.java     |  6 ++--
 .../create/CreateIndexRequestTests.java       | 28 ++-----------------
 .../action/admin/indices/get/GetIndexIT.java  |  3 +-
 .../cluster/SpecificMasterNodesIT.java        |  7 ++---
 .../gateway/GatewayIndexStateIT.java          |  7 ++---
 .../gateway/RecoveryFromGatewayIT.java        | 13 ++++-----
 .../org/elasticsearch/get/GetActionIT.java    |  5 ++--
 .../mapper/CopyToMapperIntegrationIT.java     |  7 ++---
 .../mapper/GeoPointFieldMapperTests.java      |  6 ++--
 .../index/mapper/MapperServiceTests.java      |  5 ++--
 .../mapping/ConcurrentDynamicTemplateIT.java  |  8 ++----
 .../mapping/UpdateMappingIntegrationIT.java   |  8 +++---
 .../RandomExceptionCircuitBreakerIT.java      |  5 +---
 .../indices/state/OpenCloseIndexIT.java       |  9 ++----
 .../indices/stats/IndexStatsIT.java           |  6 ++--
 .../routing/PartitionedRoutingIT.java         |  5 ++--
 .../aggregations/bucket/DateHistogramIT.java  |  7 ++---
 .../bucket/TermsDocCountErrorIT.java          |  3 +-
 .../basic/SearchWithRandomExceptionsIT.java   |  8 ++----
 .../basic/SearchWithRandomIOExceptionsIT.java |  7 ++---
 .../highlight/HighlighterSearchIT.java        | 13 ++++-----
 .../elasticsearch/search/geo/GeoFilterIT.java |  4 +--
 .../search/geo/GeoShapeIntegrationIT.java     | 22 +++++++--------
 .../search/geo/GeoShapeQueryTests.java        | 28 +++++++++----------
 .../geo/LegacyGeoShapeIntegrationIT.java      | 18 ++++++------
 .../search/morelikethis/MoreLikeThisIT.java   | 28 +++----------------
 .../search/nested/SimpleNestedIT.java         | 10 +++----
 .../search/query/SimpleQueryStringIT.java     |  8 ++----
 .../search/slice/SearchSliceIT.java           |  7 ++---
 .../search/sort/SimpleSortIT.java             |  9 ++----
 .../MachineLearningLicensingTests.java        | 23 +++++++--------
 .../support/SecurityIndexManager.java         |  2 +-
 .../throttler/ActionThrottleTests.java        |  4 +--
 34 files changed, 116 insertions(+), 224 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
index 39014d173c468..8ebf54d81b7c3 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
@@ -231,17 +231,6 @@ public CreateIndexRequest mapping(String mapping) {
         return this;
     }
 
-    /**
-     * Adds mapping that will be added when the index gets created.
-     *
-     * @param type   The mapping type
-     * @param source The mapping source
-     * @param xContentType The content type of the source
-     */
-    public CreateIndexRequest mapping(String type, String source, XContentType xContentType) {
-        return mapping(type, new BytesArray(source), xContentType);
-    }
-
     /**
      * Adds mapping that will be added when the index gets created.
      *
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
index 93b4184f958bc..f1009f731d671 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
@@ -96,12 +96,10 @@ public CreateIndexRequestBuilder setSettings(Map<String, ?> source) {
     /**
      * Adds mapping that will be added when the index gets created.
      *
-     * @param type   The mapping type
      * @param source The mapping source
-     * @param xContentType The content type of the source
      */
-    public CreateIndexRequestBuilder addMapping(String type, String source, XContentType xContentType) {
-        request.mapping(type, source, xContentType);
+    public CreateIndexRequestBuilder setMapping(String source) {
+        request.mapping(source);
         return this;
     }
 
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestTests.java
index c3d8a1853c1f4..845e645079fc9 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestTests.java
@@ -22,7 +22,6 @@
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.action.admin.indices.alias.Alias;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.collect.MapBuilder;
 import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
@@ -44,8 +43,8 @@ public class CreateIndexRequestTests extends ESTestCase {
 
     public void testSerialization() throws IOException {
         CreateIndexRequest request = new CreateIndexRequest("foo");
-        String mapping = Strings.toString(JsonXContent.contentBuilder().startObject().startObject("my_type").endObject().endObject());
-        request.mapping("my_type", mapping, XContentType.JSON);
+        String mapping = Strings.toString(JsonXContent.contentBuilder().startObject().startObject("_doc").endObject().endObject());
+        request.mapping(mapping);
 
         try (BytesStreamOutput output = new BytesStreamOutput()) {
             request.writeTo(output);
@@ -117,29 +116,6 @@ public void testMappingKeyedByType() throws IOException {
             request2.mapping("type1", builder);
             assertEquals(request1.mappings(), request2.mappings());
         }
-        {
-            request1 = new CreateIndexRequest("foo");
-            request2 = new CreateIndexRequest("bar");
-            String nakedMapping = "{\"properties\": {\"foo\": {\"type\": \"integer\"}}}";
-            request1.mapping("type2", nakedMapping, XContentType.JSON);
-            request2.mapping("type2", "{\"type2\": " + nakedMapping + "}", XContentType.JSON);
-            assertEquals(request1.mappings(), request2.mappings());
-        }
-        {
-            request1 = new CreateIndexRequest("foo");
-            request2 = new CreateIndexRequest("bar");
-            Map<String , Object> nakedMapping = MapBuilder.<String, Object>newMapBuilder()
-                    .put("properties", MapBuilder.<String, Object>newMapBuilder()
-                            .put("bar", MapBuilder.<String, Object>newMapBuilder()
-                                    .put("type", "scaled_float")
-                                    .put("scaling_factor", 100)
-                            .map())
-                    .map())
-            .map();
-            request1.mapping("type3", nakedMapping);
-            request2.mapping("type3", MapBuilder.<String, Object>newMapBuilder().put("type3", nakedMapping).map());
-            assertEquals(request1.mappings(), request2.mappings());
-        }
     }
 
     public void testSettingsType() throws IOException {
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/get/GetIndexIT.java b/server/src/test/java/org/elasticsearch/action/admin/indices/get/GetIndexIT.java
index 5726e405f613b..dc269fd2386fe 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/get/GetIndexIT.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/get/GetIndexIT.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.cluster.metadata.MappingMetaData;
 import org.elasticsearch.common.collect.ImmutableOpenMap;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexNotFoundException;
 import org.elasticsearch.test.ESIntegTestCase;
 
@@ -51,7 +50,7 @@
 public class GetIndexIT extends ESIntegTestCase {
     @Override
     protected void setupSuiteScopeCluster() throws Exception {
-        assertAcked(prepareCreate("idx").addAlias(new Alias("alias_idx")).addMapping("type1", "{\"type1\":{}}", XContentType.JSON)
+        assertAcked(prepareCreate("idx").addAlias(new Alias("alias_idx"))
                 .setSettings(Settings.builder().put("number_of_shards", 1)).get());
         ensureSearchable("idx");
         createIndex("empty_idx");
diff --git a/server/src/test/java/org/elasticsearch/cluster/SpecificMasterNodesIT.java b/server/src/test/java/org/elasticsearch/cluster/SpecificMasterNodesIT.java
index cad4f51d7eac0..0e8f0f3f7e193 100644
--- a/server/src/test/java/org/elasticsearch/cluster/SpecificMasterNodesIT.java
+++ b/server/src/test/java/org/elasticsearch/cluster/SpecificMasterNodesIT.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.action.admin.cluster.configuration.AddVotingConfigExclusionsAction;
 import org.elasticsearch.action.admin.cluster.configuration.AddVotingConfigExclusionsRequest;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.discovery.MasterNotDiscoveredException;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.node.Node;
@@ -141,9 +140,9 @@ public void testAliasFilterValidation() {
         internalCluster().startNode(Settings.builder()
             .put(Node.NODE_DATA_SETTING.getKey(), true).put(Node.NODE_MASTER_SETTING.getKey(), false));
 
-        assertAcked(prepareCreate("test").addMapping(
-            "type1", "{\"type1\" : {\"properties\" : {\"table_a\" : { \"type\" : \"nested\", " +
-            "\"properties\" : {\"field_a\" : { \"type\" : \"keyword\" },\"field_b\" :{ \"type\" : \"keyword\" }}}}}}", XContentType.JSON));
+        assertAcked(prepareCreate("test").setMapping(
+            "{\"properties\" : {\"table_a\" : { \"type\" : \"nested\", " +
+            "\"properties\" : {\"field_a\" : { \"type\" : \"keyword\" },\"field_b\" :{ \"type\" : \"keyword\" }}}}}"));
         client().admin().indices().prepareAliases().addAlias("test", "a_test",
             QueryBuilders.nestedQuery("table_a", QueryBuilders.termQuery("table_a.field_b", "y"), ScoreMode.Avg)).get();
     }
diff --git a/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java b/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
index 1df326cb1857e..1f736eaa3f74e 100644
--- a/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
@@ -46,7 +46,6 @@
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.mapper.MapperParsingException;
@@ -424,16 +423,14 @@ public void testRecoverMissingAnalyzer() throws Exception {
         prepareCreate("test").setSettings(Settings.builder()
             .put("index.analysis.analyzer.test.tokenizer", "standard")
             .put("index.number_of_shards", "1"))
-            .addMapping("type1", "{\n" +
-                "    \"type1\": {\n" +
+            .setMapping("{\n" +
                 "      \"properties\": {\n" +
                 "        \"field1\": {\n" +
                 "          \"type\": \"text\",\n" +
                 "          \"analyzer\": \"test\"\n" +
                 "        }\n" +
                 "      }\n" +
-                "    }\n" +
-                "  }}", XContentType.JSON).get();
+                "  }}").get();
         logger.info("--> indexing a simple document");
         client().prepareIndex("test").setId("1").setSource("field1", "value one").setRefreshPolicy(IMMEDIATE).get();
         logger.info("--> waiting for green status");
diff --git a/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java b/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
index e3a754f0003db..ee55545fe34ea 100644
--- a/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
@@ -37,7 +37,6 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexService;
@@ -98,10 +97,10 @@ public void testOneNodeRecoverFromGateway() throws Exception {
 
         internalCluster().startNode();
 
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
-            .startObject("properties").startObject("appAccountIds").field("type", "text").endObject().endObject()
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
+            .startObject("properties").startObject("appAccountIds").field("type", "text").endObject()
             .endObject().endObject());
-        assertAcked(prepareCreate("test").addMapping("type1", mapping, XContentType.JSON));
+        assertAcked(prepareCreate("test").setMapping(mapping));
 
         client().prepareIndex("test").setId("10990239").setSource(jsonBuilder().startObject()
             .startArray("appAccountIds").value(14).value(179).endArray().endObject()).execute().actionGet();
@@ -168,14 +167,14 @@ private Map<String, long[]> assertAndCapturePrimaryTerms(Map<String, long[]> pre
     public void testSingleNodeNoFlush() throws Exception {
         internalCluster().startNode();
 
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
             .startObject("properties").startObject("field").field("type", "text").endObject().startObject("num").field("type", "integer")
-            .endObject().endObject()
+            .endObject()
             .endObject().endObject());
         // note: default replica settings are tied to #data nodes-1 which is 0 here. We can do with 1 in this test.
         int numberOfShards = numberOfShards();
         assertAcked(prepareCreate("test").setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, numberOfShards())
-            .put(SETTING_NUMBER_OF_REPLICAS, randomIntBetween(0, 1))).addMapping("type1", mapping, XContentType.JSON));
+            .put(SETTING_NUMBER_OF_REPLICAS, randomIntBetween(0, 1))).setMapping(mapping));
 
         int value1Docs;
         int value2Docs;
diff --git a/server/src/test/java/org/elasticsearch/get/GetActionIT.java b/server/src/test/java/org/elasticsearch/get/GetActionIT.java
index 13a64d66f744b..55e706601ddc4 100644
--- a/server/src/test/java/org/elasticsearch/get/GetActionIT.java
+++ b/server/src/test/java/org/elasticsearch/get/GetActionIT.java
@@ -271,13 +271,12 @@ public void testSimpleMultiGet() throws Exception {
     }
 
     public void testGetDocWithMultivaluedFields() throws Exception {
-        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
+        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject()
                 .startObject("properties")
                 .startObject("field").field("type", "text").field("store", true).endObject()
-                .endObject()
                 .endObject().endObject());
         assertAcked(prepareCreate("test")
-                .addMapping("type1", mapping1, XContentType.JSON));
+                .setMapping(mapping1));
         ensureGreen();
 
         GetResponse response = client().prepareGet("test", "1").get();
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperIntegrationIT.java b/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperIntegrationIT.java
index 5cad69fbb112b..e91f216a76ea0 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperIntegrationIT.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.aggregations.AggregationBuilders;
 import org.elasticsearch.search.aggregations.Aggregator.SubAggCollectionMode;
@@ -70,15 +69,15 @@ public void testDynamicTemplateCopyTo() throws Exception {
     }
 
     public void testDynamicObjectCopyTo() throws Exception {
-        String mapping = Strings.toString(jsonBuilder().startObject().startObject("_doc").startObject("properties")
+        String mapping = Strings.toString(jsonBuilder().startObject().startObject("properties")
             .startObject("foo")
                 .field("type", "text")
                 .field("copy_to", "root.top.child")
             .endObject()
-            .endObject().endObject().endObject());
+            .endObject().endObject());
         assertAcked(
             client().admin().indices().prepareCreate("test-idx")
-                .addMapping("_doc", mapping, XContentType.JSON)
+                .setMapping(mapping)
         );
         client().prepareIndex("test-idx").setId("1")
             .setSource("foo", "bar")
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/GeoPointFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/GeoPointFieldMapperTests.java
index 3ff6eda1fd7fa..b1420d712f860 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/GeoPointFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/GeoPointFieldMapperTests.java
@@ -337,16 +337,16 @@ public void testIgnoreZValue() throws IOException {
 
     public void testMultiField() throws Exception {
         int numDocs = randomIntBetween(10, 100);
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("pin")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
             .startObject("properties").startObject("location")
             .field("type", "geo_point")
             .startObject("fields")
             .startObject("geohash").field("type", "keyword").endObject()  // test geohash as keyword
             .startObject("latlon").field("type", "keyword").endObject()  // test geohash as string
             .endObject()
-            .endObject().endObject().endObject().endObject());
+            .endObject().endObject().endObject());
         CreateIndexRequestBuilder mappingRequest = client().admin().indices().prepareCreate("test")
-            .addMapping("pin", mapping, XContentType.JSON);
+            .setMapping(mapping);
         mappingRequest.execute().actionGet();
 
         // create index and add random test points
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/MapperServiceTests.java b/server/src/test/java/org/elasticsearch/index/mapper/MapperServiceTests.java
index 4ac246561e6eb..d934040ab6ed8 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/MapperServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/MapperServiceTests.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.index.IndexSettings;
@@ -148,7 +147,7 @@ public void testPartitionedConstraints() {
         // partitioned index must have routing
          IllegalArgumentException noRoutingException = expectThrows(IllegalArgumentException.class, () -> {
             client().admin().indices().prepareCreate("test-index")
-                    .addMapping("type", "{\"type\":{}}", XContentType.JSON)
+                    .setMapping("{\"_doc\":{}}")
                     .setSettings(Settings.builder()
                         .put("index.number_of_shards", 4)
                         .put("index.routing_partition_size", 2))
@@ -158,7 +157,7 @@ public void testPartitionedConstraints() {
 
         // valid partitioned index
         assertTrue(client().admin().indices().prepareCreate("test-index")
-            .addMapping("type", "{\"type\":{\"_routing\":{\"required\":true}}}", XContentType.JSON)
+            .setMapping("{\"_doc\":{\"_routing\":{\"required\":true}}}")
             .setSettings(Settings.builder()
                 .put("index.number_of_shards", 4)
                 .put("index.routing_partition_size", 2))
diff --git a/server/src/test/java/org/elasticsearch/indices/mapping/ConcurrentDynamicTemplateIT.java b/server/src/test/java/org/elasticsearch/indices/mapping/ConcurrentDynamicTemplateIT.java
index b62b80854b57a..a1944225b0b85 100644
--- a/server/src/test/java/org/elasticsearch/indices/mapping/ConcurrentDynamicTemplateIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/mapping/ConcurrentDynamicTemplateIT.java
@@ -22,7 +22,6 @@
 
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.index.IndexResponse;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.test.ESIntegTestCase;
 
@@ -37,15 +36,14 @@
 import static org.hamcrest.Matchers.emptyIterable;
 
 public class ConcurrentDynamicTemplateIT extends ESIntegTestCase {
-    private final String mappingType = "test-mapping";
 
     // see #3544
     public void testConcurrentDynamicMapping() throws Exception {
         final String fieldName = "field";
-        final String mapping = "{ \"" + mappingType + "\": {" +
+        final String mapping = "{" +
                 "\"dynamic_templates\": ["
                 + "{ \"" + fieldName + "\": {" + "\"path_match\": \"*\"," + "\"mapping\": {" + "\"type\": \"text\"," + "\"store\": true,"
-                + "\"analyzer\": \"whitespace\" } } } ] } }";
+                + "\"analyzer\": \"whitespace\" } } } ] }";
         // The 'fieldNames' array is used to help with retrieval of index terms
         // after testing
 
@@ -53,7 +51,7 @@ public void testConcurrentDynamicMapping() throws Exception {
         for (int i = 0; i < iters; i++) {
             cluster().wipeIndices("test");
             assertAcked(prepareCreate("test")
-                    .addMapping(mappingType, mapping, XContentType.JSON));
+                    .setMapping(mapping));
             int numDocs = scaledRandomIntBetween(10, 100);
             final CountDownLatch latch = new CountDownLatch(numDocs);
             final List<Throwable> throwable = new CopyOnWriteArrayList<>();
diff --git a/server/src/test/java/org/elasticsearch/indices/mapping/UpdateMappingIntegrationIT.java b/server/src/test/java/org/elasticsearch/indices/mapping/UpdateMappingIntegrationIT.java
index 0929beb189213..0feb82afc1fb1 100644
--- a/server/src/test/java/org/elasticsearch/indices/mapping/UpdateMappingIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/mapping/UpdateMappingIntegrationIT.java
@@ -117,7 +117,7 @@ public void testUpdateMappingWithoutType() {
                         Settings.builder()
                                 .put("index.number_of_shards", 1)
                                 .put("index.number_of_replicas", 0)
-                ).addMapping("_doc", "{\"_doc\":{\"properties\":{\"body\":{\"type\":\"text\"}}}}", XContentType.JSON)
+                ).setMapping("{\"properties\":{\"body\":{\"type\":\"text\"}}}")
                 .execute().actionGet();
         client().admin().cluster().prepareHealth().setWaitForEvents(Priority.LANGUID).setWaitForGreenStatus().execute().actionGet();
 
@@ -158,7 +158,7 @@ public void testUpdateMappingWithConflicts() {
                         Settings.builder()
                                 .put("index.number_of_shards", 2)
                                 .put("index.number_of_replicas", 0)
-                ).addMapping("type", "{\"type\":{\"properties\":{\"body\":{\"type\":\"text\"}}}}", XContentType.JSON)
+                ).setMapping("{\"properties\":{\"body\":{\"type\":\"text\"}}}")
                 .execute().actionGet();
         client().admin().cluster().prepareHealth().setWaitForEvents(Priority.LANGUID).setWaitForGreenStatus().execute().actionGet();
 
@@ -173,7 +173,7 @@ public void testUpdateMappingWithConflicts() {
 
     public void testUpdateMappingWithNormsConflicts() {
         client().admin().indices().prepareCreate("test")
-                .addMapping("type", "{\"type\":{\"properties\":{\"body\":{\"type\":\"text\", \"norms\": false }}}}", XContentType.JSON)
+                .setMapping("{\"properties\":{\"body\":{\"type\":\"text\", \"norms\": false }}}")
                 .execute().actionGet();
         try {
             client().admin().indices().preparePutMapping("test")
@@ -194,7 +194,7 @@ public void testUpdateMappingNoChanges() {
                         Settings.builder()
                                 .put("index.number_of_shards", 2)
                                 .put("index.number_of_replicas", 0)
-                ).addMapping("type", "{\"type\":{\"properties\":{\"body\":{\"type\":\"text\"}}}}", XContentType.JSON)
+                ).setMapping("{\"properties\":{\"body\":{\"type\":\"text\"}}}")
                 .execute().actionGet();
         client().admin().cluster().prepareHealth().setWaitForEvents(Priority.LANGUID).setWaitForGreenStatus().execute().actionGet();
 
diff --git a/server/src/test/java/org/elasticsearch/indices/memory/breaker/RandomExceptionCircuitBreakerIT.java b/server/src/test/java/org/elasticsearch/indices/memory/breaker/RandomExceptionCircuitBreakerIT.java
index 33260878ebda6..1fb278ba31311 100644
--- a/server/src/test/java/org/elasticsearch/indices/memory/breaker/RandomExceptionCircuitBreakerIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/memory/breaker/RandomExceptionCircuitBreakerIT.java
@@ -36,7 +36,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.MockEngineFactoryPlugin;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.indices.IndicesService;
@@ -81,7 +80,6 @@ public void testBreakerWithRandomExceptions() throws IOException, InterruptedExc
         String mapping = Strings // {}
                 .toString(XContentFactory.jsonBuilder()
                         .startObject()
-                        .startObject("type")
                         .startObject("properties")
                         .startObject("test-str")
                         .field("type", "keyword")
@@ -92,7 +90,6 @@ public void testBreakerWithRandomExceptions() throws IOException, InterruptedExc
                         .field("type", randomFrom(Arrays.asList("float", "long", "double", "short", "integer")))
                         .endObject() // test-num
                         .endObject() // properties
-                        .endObject() // type
                         .endObject());
         final double topLevelRate;
         final double lowLevelRate;
@@ -123,7 +120,7 @@ public void testBreakerWithRandomExceptions() throws IOException, InterruptedExc
         logger.info("creating index: [test] using settings: [{}]", settings.build());
         CreateIndexResponse response = client().admin().indices().prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type", mapping, XContentType.JSON).execute().actionGet();
+                .setMapping(mapping).execute().actionGet();
         final int numDocs;
         if (response.isShardsAcknowledged() == false) {
             /* some seeds just won't let you create the index at all and we enter a ping-pong mode
diff --git a/server/src/test/java/org/elasticsearch/indices/state/OpenCloseIndexIT.java b/server/src/test/java/org/elasticsearch/indices/state/OpenCloseIndexIT.java
index a36e4dae66958..c95b61f7e6a90 100644
--- a/server/src/test/java/org/elasticsearch/indices/state/OpenCloseIndexIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/state/OpenCloseIndexIT.java
@@ -33,7 +33,6 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexNotFoundException;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -266,17 +265,15 @@ public void testOpenWaitingForActiveShardsFailed() throws Exception {
     public void testOpenCloseWithDocs() throws IOException, ExecutionException, InterruptedException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().
                 startObject().
-                startObject("type").
                 startObject("properties").
                 startObject("test")
                 .field("type", "keyword")
-                .endObject().
-                        endObject().
-                        endObject()
+                .endObject()
+                .endObject()
                 .endObject());
 
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", mapping, XContentType.JSON));
+                .setMapping(mapping));
         ensureGreen();
         int docs = between(10, 100);
         IndexRequestBuilder[] builder = new IndexRequestBuilder[docs];
diff --git a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
index 70eb62e127c75..c84272127623f 100644
--- a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
@@ -773,11 +773,9 @@ public void testMultiIndex() throws Exception {
 
     public void testCompletionFieldsParam() throws Exception {
         assertAcked(prepareCreate("test1")
-                .addMapping(
-                        "_doc",
+                .setMapping(
                         "{ \"properties\": { \"bar\": { \"type\": \"text\", \"fields\": { \"completion\": { \"type\": \"completion\" }}}" +
-                            ",\"baz\": { \"type\": \"text\", \"fields\": { \"completion\": { \"type\": \"completion\" }}}}}",
-                    XContentType.JSON));
+                            ",\"baz\": { \"type\": \"text\", \"fields\": { \"completion\": { \"type\": \"completion\" }}}}}"));
         ensureGreen();
 
         client().prepareIndex("test1").setId(Integer.toString(1)).setSource("{\"bar\":\"bar\",\"baz\":\"baz\"}"
diff --git a/server/src/test/java/org/elasticsearch/routing/PartitionedRoutingIT.java b/server/src/test/java/org/elasticsearch/routing/PartitionedRoutingIT.java
index 45a1e98289dbe..a837e6441256c 100644
--- a/server/src/test/java/org/elasticsearch/routing/PartitionedRoutingIT.java
+++ b/server/src/test/java/org/elasticsearch/routing/PartitionedRoutingIT.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.mockito.internal.util.collections.Sets;
@@ -45,7 +44,7 @@ public void testVariousPartitionSizes() throws Exception {
                         .put("index.number_of_shards", shards)
                         .put("index.number_of_routing_shards", shards)
                         .put("index.routing_partition_size", partitionSize))
-                    .addMapping("type", "{\"type\":{\"_routing\":{\"required\":true}}}", XContentType.JSON)
+                    .setMapping("{\"_routing\":{\"required\":true}}")
                     .execute().actionGet();
                 ensureGreen();
 
@@ -74,7 +73,7 @@ public void testShrinking() throws Exception {
                 .put("index.number_of_routing_shards", currentShards)
                 .put("index.number_of_replicas", numberOfReplicas())
                 .put("index.routing_partition_size", partitionSize))
-            .addMapping("_doc", "{\"_doc\":{\"_routing\":{\"required\":true}}}", XContentType.JSON)
+            .setMapping("{\"_routing\":{\"required\":true}}")
             .execute().actionGet();
         ensureGreen();
 
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
index 0dceff9d0f0d1..19c48c9b32f9d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
@@ -28,7 +28,6 @@
 import org.elasticsearch.common.time.DateFormatter;
 import org.elasticsearch.common.time.DateFormatters;
 import org.elasticsearch.common.time.DateMathParser;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.mapper.DateFieldMapper;
 import org.elasticsearch.index.query.MatchNoneQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -1238,10 +1237,10 @@ public void testSingleValueFieldWithExtendedBoundsOffset() throws Exception {
 
     public void testSingleValueWithMultipleDateFormatsFromMapping() throws Exception {
         String mappingJson = Strings.toString(jsonBuilder().startObject()
-                .startObject("type").startObject("properties")
+                .startObject("properties")
                 .startObject("date").field("type", "date").field("format", "strict_date_optional_time||dd-MM-yyyy")
-                .endObject().endObject().endObject().endObject());
-        prepareCreate("idx2").addMapping("type", mappingJson, XContentType.JSON).get();
+                .endObject().endObject().endObject());
+        prepareCreate("idx2").setMapping(mappingJson).get();
         IndexRequestBuilder[] reqs = new IndexRequestBuilder[5];
         for (int i = 0; i < reqs.length; i++) {
             reqs[i] = client().prepareIndex("idx2").setId("" + i)
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsDocCountErrorIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsDocCountErrorIT.java
index b6b817cc7c270..f405f47e0ee2c 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsDocCountErrorIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsDocCountErrorIT.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.search.aggregations.Aggregator.SubAggCollectionMode;
 import org.elasticsearch.search.aggregations.BucketOrder;
 import org.elasticsearch.search.aggregations.bucket.terms.Terms;
@@ -89,7 +88,7 @@ public void setupSuiteScopeCluster() throws Exception {
         }
         numRoutingValues = between(1,40);
         assertAcked(prepareCreate("idx_with_routing")
-            .addMapping("type", "{ \"type\" : { \"_routing\" : { \"required\" : true } } }", XContentType.JSON));
+            .setMapping("{ \"_routing\" : { \"required\" : true } }"));
         for (int i = 0; i < numDocs; i++) {
             builders.add(client().prepareIndex("idx_single_shard").setId("" + i)
                 .setRouting(String.valueOf(randomInt(numRoutingValues)))
diff --git a/server/src/test/java/org/elasticsearch/search/basic/SearchWithRandomExceptionsIT.java b/server/src/test/java/org/elasticsearch/search/basic/SearchWithRandomExceptionsIT.java
index c06b501f08681..593423e843cd7 100644
--- a/server/src/test/java/org/elasticsearch/search/basic/SearchWithRandomExceptionsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/basic/SearchWithRandomExceptionsIT.java
@@ -36,7 +36,6 @@
 import org.elasticsearch.common.settings.Settings.Builder;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.MockEngineFactoryPlugin;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.plugins.Plugin;
@@ -70,13 +69,10 @@ protected boolean addMockInternalEngine() {
     public void testRandomExceptions() throws IOException, InterruptedException, ExecutionException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().
                 startObject().
-                startObject("type").
                 startObject("properties").
                 startObject("test")
                 .field("type", "keyword")
-                .endObject().
-                        endObject().
-                        endObject()
+                .endObject().endObject()
                 .endObject());
         final double lowLevelRate;
         final double topLevelRate;
@@ -107,7 +103,7 @@ public void testRandomExceptions() throws IOException, InterruptedException, Exe
         logger.info("creating index: [test] using settings: [{}]", settings.build());
         assertAcked(prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type", mapping, XContentType.JSON));
+                .setMapping(mapping));
         ensureSearchable();
         final int numDocs = between(10, 100);
         int numCreated = 0;
diff --git a/server/src/test/java/org/elasticsearch/search/basic/SearchWithRandomIOExceptionsIT.java b/server/src/test/java/org/elasticsearch/search/basic/SearchWithRandomIOExceptionsIT.java
index 265fdef034d8c..e116fbe380fcf 100644
--- a/server/src/test/java/org/elasticsearch/search/basic/SearchWithRandomIOExceptionsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/basic/SearchWithRandomIOExceptionsIT.java
@@ -32,7 +32,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.search.sort.SortOrder;
@@ -61,12 +60,10 @@ public void testRemoveWhenAwaitsFixIsResolved() {
     public void testRandomDirectoryIOExceptions() throws IOException, InterruptedException, ExecutionException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().
             startObject().
-            startObject("type").
             startObject("properties").
             startObject("test")
             .field("type", "keyword")
             .endObject().
-                endObject().
                 endObject()
             .endObject());
         final double exceptionRate;
@@ -98,7 +95,7 @@ public void testRandomDirectoryIOExceptions() throws IOException, InterruptedExc
             logger.info("creating index: [test] using settings: [{}]", settings.build());
             client().admin().indices().prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type", mapping, XContentType.JSON).get();
+                .setMapping(mapping).get();
             numInitialDocs = between(10, 100);
             ensureGreen();
             for (int i = 0; i < numInitialDocs; i++) {
@@ -121,7 +118,7 @@ public void testRandomDirectoryIOExceptions() throws IOException, InterruptedExc
             logger.info("creating index: [test] using settings: [{}]", settings.build());
             client().admin().indices().prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type", mapping, XContentType.JSON).get();
+                .setMapping(mapping).get();
         }
         ClusterHealthResponse clusterHealthResponse = client().admin().cluster()
             // it's OK to timeout here
diff --git a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
index 68077456a6c5f..d09e7d05fa6f0 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
@@ -37,7 +37,6 @@
 import org.elasticsearch.common.time.DateFormatter;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.analysis.AbstractIndexAnalyzerProvider;
 import org.elasticsearch.index.analysis.AnalyzerProvider;
 import org.elasticsearch.index.analysis.PreConfiguredTokenFilter;
@@ -2722,7 +2721,7 @@ public void testKeywordFieldHighlighting() throws IOException {
     }
 
     public void testACopyFieldWithNestedQuery() throws Exception {
-        String mapping = Strings.toString(jsonBuilder().startObject().startObject("type").startObject("properties")
+        String mapping = Strings.toString(jsonBuilder().startObject().startObject("properties")
                     .startObject("foo")
                         .field("type", "nested")
                         .startObject("properties")
@@ -2737,8 +2736,8 @@ public void testACopyFieldWithNestedQuery() throws Exception {
                         .field("term_vector", "with_positions_offsets")
                         .field("store", true)
                     .endObject()
-                .endObject().endObject().endObject());
-        prepareCreate("test").addMapping("type", mapping, XContentType.JSON).get();
+                .endObject().endObject());
+        prepareCreate("test").setMapping(mapping).get();
 
         client().prepareIndex("test").setId("1").setSource(jsonBuilder().startObject().startArray("foo")
                     .startObject().field("text", "brown").endObject()
@@ -2833,7 +2832,7 @@ public void testHighlightQueryRewriteDatesWithNow() throws Exception {
     }
 
     public void testWithNestedQuery() throws Exception {
-        String mapping = Strings.toString(jsonBuilder().startObject().startObject("type").startObject("properties")
+        String mapping = Strings.toString(jsonBuilder().startObject().startObject("properties")
             .startObject("text")
                 .field("type", "text")
                 .field("index_options", "offsets")
@@ -2847,8 +2846,8 @@ public void testWithNestedQuery() throws Exception {
                     .endObject()
                 .endObject()
             .endObject()
-            .endObject().endObject().endObject());
-        prepareCreate("test").addMapping("type", mapping, XContentType.JSON).get();
+            .endObject().endObject());
+        prepareCreate("test").setMapping(mapping).get();
 
         client().prepareIndex("test").setId("1").setSource(jsonBuilder().startObject()
             .startArray("foo")
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoFilterIT.java b/server/src/test/java/org/elasticsearch/search/geo/GeoFilterIT.java
index 5a8f32313557d..0ce547ec14975 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoFilterIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoFilterIT.java
@@ -203,18 +203,16 @@ public void testShapeRelations() throws Exception {
 
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("polygon")
                 .startObject("properties")
                 .startObject("area")
                 .field("type", "geo_shape")
                 .field("tree", "geohash")
                 .endObject()
                 .endObject()
-                .endObject()
                 .endObject());
 
         CreateIndexRequestBuilder mappingRequest = client().admin().indices().prepareCreate("shapes")
-            .addMapping("polygon", mapping, XContentType.JSON);
+            .setMapping(mapping);
         mappingRequest.get();
         client().admin().cluster().prepareHealth().setWaitForEvents(Priority.LANGUID).setWaitForGreenStatus().get();
 
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeIntegrationIT.java b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeIntegrationIT.java
index bb42258ab8de6..fac3bda1c1935 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeIntegrationIT.java
@@ -46,24 +46,24 @@ public class GeoShapeIntegrationIT extends ESIntegTestCase {
      */
     public void testOrientationPersistence() throws Exception {
         String idxName = "orientation";
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("shape")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
             .startObject("properties").startObject("location")
             .field("type", "geo_shape")
             .field("orientation", "left")
-            .endObject().endObject()
+            .endObject()
             .endObject().endObject());
 
         // create index
-        assertAcked(prepareCreate(idxName).addMapping("shape", mapping, XContentType.JSON));
+        assertAcked(prepareCreate(idxName).setMapping(mapping));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("shape")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
             .startObject("properties").startObject("location")
             .field("type", "geo_shape")
             .field("orientation", "right")
-            .endObject().endObject()
+            .endObject()
             .endObject().endObject());
 
-        assertAcked(prepareCreate(idxName+"2").addMapping("shape", mapping, XContentType.JSON));
+        assertAcked(prepareCreate(idxName+"2").setMapping(mapping));
         ensureGreen(idxName, idxName+"2");
 
         internalCluster().fullRestart();
@@ -149,7 +149,7 @@ public void testMappingUpdate() throws Exception {
      * Test that the indexed shape routing can be provided if it is required
      */
     public void testIndexShapeRouting() throws Exception {
-        String mapping = "{\n" +
+        String mapping = "{\"_doc\":{\n" +
             "    \"_routing\": {\n" +
             "      \"required\": true\n" +
             "    },\n" +
@@ -158,11 +158,11 @@ public void testIndexShapeRouting() throws Exception {
             "        \"type\": \"geo_shape\"\n" +
             "      }\n" +
             "    }\n" +
-            "  }";
+            "  }}";
 
 
         // create index
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("doc", mapping, XContentType.JSON).get());
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(mapping).get());
         ensureGreen();
 
         String source = "{\n" +
@@ -201,10 +201,10 @@ public void testIndexPolygonDateLine() throws Exception {
 
 
         // create index
-        assertAcked(client().admin().indices().prepareCreate("vector").addMapping("doc", mappingVector, XContentType.JSON).get());
+        assertAcked(client().admin().indices().prepareCreate("vector").setMapping(mappingVector).get());
         ensureGreen();
 
-        assertAcked(client().admin().indices().prepareCreate("quad").addMapping("doc", mappingQuad, XContentType.JSON).get());
+        assertAcked(client().admin().indices().prepareCreate("quad").setMapping(mappingQuad).get());
         ensureGreen();
 
         String source = "{\n" +
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
index 8ed913242ebda..612973c0b2362 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
@@ -77,21 +77,21 @@ public class GeoShapeQueryTests extends ESSingleNodeTestCase {
     };
 
     private XContentBuilder createMapping() throws Exception {
-        XContentBuilder xcb = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder xcb = XContentFactory.jsonBuilder().startObject()
             .startObject("properties").startObject("location")
             .field("type", "geo_shape");
         if (randomBoolean()) {
             xcb = xcb.field("tree", randomFrom(PREFIX_TREES))
             .field("strategy", randomFrom(SpatialStrategy.RECURSIVE, SpatialStrategy.TERM));
         }
-        xcb = xcb.endObject().endObject().endObject().endObject();
+        xcb = xcb.endObject().endObject().endObject();
 
         return xcb;
     }
 
     public void testNullShape() throws Exception {
         String mapping = Strings.toString(createMapping());
-        client().admin().indices().prepareCreate("test").addMapping("type1", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("test").setMapping(mapping).get();
         ensureGreen();
 
         client().prepareIndex("test").setId("aNullshape").setSource("{\"location\": null}", XContentType.JSON)
@@ -102,7 +102,7 @@ public void testNullShape() throws Exception {
 
     public void testIndexPointsFilterRectangle() throws Exception {
         String mapping = Strings.toString(createMapping());
-        client().admin().indices().prepareCreate("test").addMapping("type1", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("test").setMapping(mapping).get();
         ensureGreen();
 
         client().prepareIndex("test").setId("1").setSource(jsonBuilder().startObject()
@@ -143,12 +143,12 @@ public void testIndexPointsFilterRectangle() throws Exception {
     }
 
     public void testEdgeCases() throws Exception {
-        XContentBuilder xcb = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder xcb = XContentFactory.jsonBuilder().startObject()
             .startObject("properties").startObject("location")
             .field("type", "geo_shape")
-            .endObject().endObject().endObject().endObject();
+            .endObject().endObject().endObject();
         String mapping = Strings.toString(xcb);
-        client().admin().indices().prepareCreate("test").addMapping("type1", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("test").setMapping(mapping).get();
         ensureGreen();
 
         client().prepareIndex("test").setId("blakely").setSource(jsonBuilder().startObject()
@@ -180,7 +180,7 @@ public void testEdgeCases() throws Exception {
 
     public void testIndexedShapeReference() throws Exception {
         String mapping = Strings.toString(createMapping());
-        client().admin().indices().prepareCreate("test").addMapping("type1", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("test").setMapping(mapping).get();
         createIndex("shapes");
         ensureGreen();
 
@@ -584,17 +584,17 @@ public void testShapeFilterWithDefinedGeoCollection() throws Exception {
     }
 
     public void testPointsOnly() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
                 .startObject("properties").startObject("location")
                 .field("type", "geo_shape")
                 .field("tree", randomBoolean() ? "quadtree" : "geohash")
                 .field("tree_levels", "6")
                 .field("distance_error_pct", "0.01")
                 .field("points_only", true)
-                .endObject().endObject()
+                .endObject()
                 .endObject().endObject());
 
-        client().admin().indices().prepareCreate("geo_points_only").addMapping("type1", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("geo_points_only").setMapping(mapping).get();
         ensureGreen();
 
         ShapeBuilder shape = RandomShapeGenerator.createShape(random());
@@ -617,17 +617,17 @@ public void testPointsOnly() throws Exception {
     }
 
     public void testPointsOnlyExplicit() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
             .startObject("properties").startObject("location")
             .field("type", "geo_shape")
             .field("tree", randomBoolean() ? "quadtree" : "geohash")
             .field("tree_levels", "6")
             .field("distance_error_pct", "0.01")
             .field("points_only", true)
-            .endObject().endObject()
+            .endObject()
             .endObject().endObject());
 
-        client().admin().indices().prepareCreate("geo_points_only").addMapping("type1", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("geo_points_only").setMapping(mapping).get();
         ensureGreen();
 
         // MULTIPOINT
diff --git a/server/src/test/java/org/elasticsearch/search/geo/LegacyGeoShapeIntegrationIT.java b/server/src/test/java/org/elasticsearch/search/geo/LegacyGeoShapeIntegrationIT.java
index 1a919015bb401..4e7ded64a2586 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/LegacyGeoShapeIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/LegacyGeoShapeIntegrationIT.java
@@ -46,26 +46,26 @@ public class LegacyGeoShapeIntegrationIT extends ESIntegTestCase {
      */
     public void testOrientationPersistence() throws Exception {
         String idxName = "orientation";
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("shape")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
                 .startObject("properties").startObject("location")
                 .field("type", "geo_shape")
                 .field("tree", "quadtree")
                 .field("orientation", "left")
-                .endObject().endObject()
+                .endObject()
                 .endObject().endObject());
 
         // create index
-        assertAcked(prepareCreate(idxName).addMapping("shape", mapping, XContentType.JSON));
+        assertAcked(prepareCreate(idxName).setMapping(mapping));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("shape")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
                 .startObject("properties").startObject("location")
                 .field("type", "geo_shape")
                 .field("tree", "quadtree")
                 .field("orientation", "right")
-                .endObject().endObject()
+                .endObject()
                 .endObject().endObject());
 
-        assertAcked(prepareCreate(idxName+"2").addMapping("shape", mapping, XContentType.JSON));
+        assertAcked(prepareCreate(idxName+"2").setMapping(mapping));
         ensureGreen(idxName, idxName+"2");
 
         internalCluster().fullRestart();
@@ -130,7 +130,7 @@ public void testIgnoreMalformed() throws Exception {
      * Test that the indexed shape routing can be provided if it is required
      */
     public void testIndexShapeRouting() throws Exception {
-        String mapping = "{\n" +
+        String mapping = "{\"_doc\":{\n" +
             "    \"_routing\": {\n" +
             "      \"required\": true\n" +
             "    },\n" +
@@ -140,11 +140,11 @@ public void testIndexShapeRouting() throws Exception {
             "        \"tree\" : \"quadtree\"\n" +
             "      }\n" +
             "    }\n" +
-            "  }";
+            "  }}";
 
 
         // create index
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("doc", mapping, XContentType.JSON).get());
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(mapping).get());
         ensureGreen();
 
         String source = "{\n" +
diff --git a/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java b/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
index 99d83eb4521b1..34a9363d5a5b7 100644
--- a/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
+++ b/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
@@ -25,11 +25,9 @@
 import org.elasticsearch.action.search.SearchPhaseExecutionException;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
-import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.MoreLikeThisQueryBuilder;
 import org.elasticsearch.index.query.MoreLikeThisQueryBuilder.Item;
 import org.elasticsearch.index.query.QueryBuilder;
@@ -223,13 +221,8 @@ public void testMoreLikeThisWithAliases() throws Exception {
     public void testMoreLikeThisWithAliasesInLikeDocuments() throws Exception {
         String indexName = "foo";
         String aliasName = "foo_name";
-        String typeName = "bar";
 
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("bar")
-                .startObject("properties")
-                .endObject()
-                .endObject().endObject());
-        client().admin().indices().prepareCreate(indexName).addMapping(typeName, mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate(indexName).get();
         client().admin().indices().prepareAliases().addAlias(indexName, aliasName).get();
 
         assertThat(ensureGreen(), equalTo(ClusterHealthStatus.GREEN));
@@ -249,11 +242,7 @@ public void testMoreLikeThisWithAliasesInLikeDocuments() throws Exception {
     }
 
     public void testMoreLikeThisIssue2197() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("bar")
-                .startObject("properties")
-                .endObject()
-                .endObject().endObject());
-        client().admin().indices().prepareCreate("foo").addMapping("bar", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("foo").get();
         client().prepareIndex("foo").setId("1")
                 .setSource(jsonBuilder().startObject().startObject("foo").field("bar", "boz").endObject().endObject())
                 .get();
@@ -272,11 +261,7 @@ public void testMoreLikeThisIssue2197() throws Exception {
 
     // Issue #2489
     public void testMoreLikeWithCustomRouting() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("bar")
-                .startObject("properties")
-                .endObject()
-                .endObject().endObject());
-        client().admin().indices().prepareCreate("foo").addMapping("bar", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("foo").get();
         ensureGreen();
 
         client().prepareIndex("foo").setId("1")
@@ -293,13 +278,8 @@ public void testMoreLikeWithCustomRouting() throws Exception {
 
     // Issue #3039
     public void testMoreLikeThisIssueRoutingNotSerialized() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("bar")
-                .startObject("properties")
-                .endObject()
-                .endObject().endObject());
         assertAcked(prepareCreate("foo", 2,
-                Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 2).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("bar", mapping, XContentType.JSON));
+                Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 2).put(SETTING_NUMBER_OF_REPLICAS, 0)));
         ensureGreen();
 
         client().prepareIndex("foo").setId("1")
diff --git a/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java b/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
index 75dca03b297c1..cca4d4e8e1a57 100644
--- a/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
+++ b/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
@@ -522,8 +522,7 @@ public void testSimpleNestedSortingWithNestedFilterMissing() throws Exception {
 
     public void testNestedSortWithMultiLevelFiltering() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("type1", "{\n"
-                + "  \"type1\": {\n"
+            .setMapping("{\n"
                 + "    \"properties\": {\n"
                 + "      \"acl\": {\n"
                 + "        \"type\": \"nested\",\n"
@@ -545,8 +544,7 @@ public void testNestedSortWithMultiLevelFiltering() throws Exception {
                 + "        }\n"
                 + "      }\n"
                 + "    }\n"
-                + "  }\n"
-                + "}", XContentType.JSON));
+                + "}"));
         ensureGreen();
 
         client().prepareIndex("test").setId("1").setSource("{\n"
@@ -738,7 +736,7 @@ public void testNestedSortWithMultiLevelFiltering() throws Exception {
     public void testLeakingSortValues() throws Exception {
         assertAcked(prepareCreate("test")
             .setSettings(Settings.builder().put("number_of_shards", 1))
-            .addMapping("test-type", "{\n"
+            .setMapping("{\"_doc\":{\n"
                     + "        \"dynamic\": \"strict\",\n"
                     + "        \"properties\": {\n"
                     + "          \"nested1\": {\n"
@@ -758,7 +756,7 @@ public void testLeakingSortValues() throws Exception {
                     + "            }\n"
                     + "          }\n"
                     + "        }\n"
-                    + "      }\n", XContentType.JSON));
+                    + "      }}\n"));
             ensureGreen();
 
             client().prepareIndex("test").setId("1").setSource("{\n"
diff --git a/server/src/test/java/org/elasticsearch/search/query/SimpleQueryStringIT.java b/server/src/test/java/org/elasticsearch/search/query/SimpleQueryStringIT.java
index bc3f387afc3e3..dde2dc53514a5 100644
--- a/server/src/test/java/org/elasticsearch/search/query/SimpleQueryStringIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/SimpleQueryStringIT.java
@@ -336,18 +336,16 @@ public void testLenientFlagBeingTooLenient() throws Exception {
     public void testSimpleQueryStringAnalyzeWildcard() throws ExecutionException, InterruptedException, IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type1")
                 .startObject("properties")
                 .startObject("location")
                 .field("type", "text")
                 .field("analyzer", "standard")
                 .endObject()
                 .endObject()
-                .endObject()
                 .endObject());
 
         CreateIndexRequestBuilder mappingRequest = client().admin().indices().prepareCreate("test1")
-            .addMapping("type1", mapping, XContentType.JSON);
+            .setMapping(mapping);
         mappingRequest.get();
         indexRandom(true, client().prepareIndex("test1").setId("1").setSource("location", "Köln"));
         refresh();
@@ -386,19 +384,17 @@ public void testEmptySimpleQueryStringWithAnalysis() throws Exception {
         // https://github.com/elastic/elasticsearch/issues/18202
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type1")
                 .startObject("properties")
                 .startObject("body")
                 .field("type", "text")
                 .field("analyzer", "stop")
                 .endObject()
                 .endObject()
-                .endObject()
                 .endObject());
 
         CreateIndexRequestBuilder mappingRequest = client().admin().indices()
                 .prepareCreate("test1")
-                .addMapping("type1", mapping, XContentType.JSON);
+                .setMapping(mapping);
         mappingRequest.get();
         indexRandom(true, client().prepareIndex("test1").setId("1").setSource("body", "Some Text"));
         refresh();
diff --git a/server/src/test/java/org/elasticsearch/search/slice/SearchSliceIT.java b/server/src/test/java/org/elasticsearch/search/slice/SearchSliceIT.java
index 3d43662fca8c5..9c0310fd45772 100644
--- a/server/src/test/java/org/elasticsearch/search/slice/SearchSliceIT.java
+++ b/server/src/test/java/org/elasticsearch/search/slice/SearchSliceIT.java
@@ -29,7 +29,6 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.search.Scroll;
 import org.elasticsearch.search.SearchException;
 import org.elasticsearch.search.SearchHit;
@@ -37,9 +36,9 @@
 import org.elasticsearch.test.ESIntegTestCase;
 
 import java.io.IOException;
-import java.util.List;
 import java.util.ArrayList;
 import java.util.HashSet;
+import java.util.List;
 import java.util.concurrent.ExecutionException;
 
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
@@ -52,7 +51,6 @@ public class SearchSliceIT extends ESIntegTestCase {
     private void setupIndex(int numDocs, int numberOfShards) throws IOException, ExecutionException, InterruptedException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().
             startObject()
-                .startObject("type")
                     .startObject("properties")
                         .startObject("invalid_random_kw")
                             .field("type", "keyword")
@@ -67,11 +65,10 @@ private void setupIndex(int numDocs, int numberOfShards) throws IOException, Exe
                             .field("doc_values", "false")
                         .endObject()
                     .endObject()
-                .endObject()
             .endObject());
         assertAcked(client().admin().indices().prepareCreate("test")
             .setSettings(Settings.builder().put("number_of_shards", numberOfShards).put("index.max_slices_per_scroll", 10000))
-            .addMapping("type", mapping, XContentType.JSON));
+            .setMapping(mapping));
         ensureGreen();
 
         List<IndexRequestBuilder> requests = new ArrayList<>();
diff --git a/server/src/test/java/org/elasticsearch/search/sort/SimpleSortIT.java b/server/src/test/java/org/elasticsearch/search/sort/SimpleSortIT.java
index faea56f47d326..237235a0a230e 100644
--- a/server/src/test/java/org/elasticsearch/search/sort/SimpleSortIT.java
+++ b/server/src/test/java/org/elasticsearch/search/sort/SimpleSortIT.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.geo.GeoPoint;
 import org.elasticsearch.common.geo.GeoUtils;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.fielddata.ScriptDocValues;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.script.MockScriptPlugin;
@@ -225,7 +224,6 @@ public void testSimpleSorts() throws Exception {
     public void testSortMinValueScript() throws IOException {
         String mapping = Strings.toString(jsonBuilder()
                 .startObject()
-                    .startObject("type1")
                         .startObject("properties")
                             .startObject("lvalue")
                                 .field("type", "long")
@@ -240,10 +238,9 @@ public void testSortMinValueScript() throws IOException {
                                 .field("type", "geo_point")
                             .endObject()
                         .endObject()
-                    .endObject()
                 .endObject());
 
-        assertAcked(prepareCreate("test").addMapping("type1", mapping, XContentType.JSON));
+        assertAcked(prepareCreate("test").setMapping(mapping));
         ensureGreen();
 
         for (int i = 0; i < 10; i++) {
@@ -344,7 +341,6 @@ public void testDocumentsWithNullValue() throws Exception {
         // be propagated to all nodes yet and sort operation fail when the sort field is not defined
         String mapping = Strings.toString(jsonBuilder()
                 .startObject()
-                    .startObject("type1")
                         .startObject("properties")
                             .startObject("id")
                                 .field("type", "keyword")
@@ -353,9 +349,8 @@ public void testDocumentsWithNullValue() throws Exception {
                                 .field("type", "keyword")
                             .endObject()
                         .endObject()
-                    .endObject()
                 .endObject());
-        assertAcked(prepareCreate("test").addMapping("type1", mapping, XContentType.JSON));
+        assertAcked(prepareCreate("test").setMapping(mapping));
         ensureGreen();
 
         client().prepareIndex("test")
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
index 760a98a3316f1..f819cff871637 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
@@ -152,7 +152,7 @@ public void testMachineLearningPutDatafeedActionRestricted() throws Exception {
         // test that license restricted apis do not work
         ElasticsearchSecurityException e = expectThrows(ElasticsearchSecurityException.class, () -> {
             PlainActionFuture<PutDatafeedAction.Response> listener = PlainActionFuture.newFuture();
-            client().execute(PutDatafeedAction.INSTANCE, 
+            client().execute(PutDatafeedAction.INSTANCE,
                 new PutDatafeedAction.Request(createDatafeed(datafeedId, jobId, Collections.singletonList(jobId))), listener);
             listener.actionGet();
         });
@@ -166,7 +166,7 @@ public void testMachineLearningPutDatafeedActionRestricted() throws Exception {
         assertMLAllowed(true);
         // test that license restricted apis do now work
         PlainActionFuture<PutDatafeedAction.Response> listener = PlainActionFuture.newFuture();
-        client().execute(PutDatafeedAction.INSTANCE, 
+        client().execute(PutDatafeedAction.INSTANCE,
                 new PutDatafeedAction.Request(createDatafeed(datafeedId, jobId, Collections.singletonList(jobId))), listener);
         PutDatafeedAction.Response response = listener.actionGet();
         assertNotNull(response);
@@ -177,8 +177,7 @@ public void testAutoCloseJobWithDatafeed() throws Exception {
         String datafeedId = jobId + "-datafeed";
         assertMLAllowed(true);
         String datafeedIndex = jobId + "-data";
-        prepareCreate(datafeedIndex).addMapping("type", "{\"type\":{\"properties\":{\"time\":{\"type\":\"date\"}}}}",
-            XContentType.JSON).get();
+        prepareCreate(datafeedIndex).setMapping("{\"_doc\":{\"properties\":{\"time\":{\"type\":\"date\"}}}}").get();
 
         // put job
         PlainActionFuture<PutJobAction.Response> putJobListener = PlainActionFuture.newFuture();
@@ -187,7 +186,7 @@ public void testAutoCloseJobWithDatafeed() throws Exception {
         assertNotNull(putJobResponse);
         // put datafeed
         PlainActionFuture<PutDatafeedAction.Response> putDatafeedListener = PlainActionFuture.newFuture();
-        client().execute(PutDatafeedAction.INSTANCE, 
+        client().execute(PutDatafeedAction.INSTANCE,
                 new PutDatafeedAction.Request(createDatafeed(datafeedId, jobId,
                         Collections.singletonList(datafeedIndex))), putDatafeedListener);
         PutDatafeedAction.Response putDatafeedResponse = putDatafeedListener.actionGet();
@@ -276,15 +275,14 @@ public void testMachineLearningStartDatafeedActionRestricted() throws Exception
         String datafeedId = jobId + "-datafeed";
         assertMLAllowed(true);
         String datafeedIndex = jobId + "-data";
-        prepareCreate(datafeedIndex).addMapping("type", "{\"type\":{\"properties\":{\"time\":{\"type\":\"date\"}}}}",
-            XContentType.JSON).get();
+        prepareCreate(datafeedIndex).setMapping("{\"_doc\":{\"properties\":{\"time\":{\"type\":\"date\"}}}}").get();
         // test that license restricted apis do now work
         PlainActionFuture<PutJobAction.Response> putJobListener = PlainActionFuture.newFuture();
         client().execute(PutJobAction.INSTANCE, new PutJobAction.Request(createJob(jobId)), putJobListener);
         PutJobAction.Response putJobResponse = putJobListener.actionGet();
         assertNotNull(putJobResponse);
         PlainActionFuture<PutDatafeedAction.Response> putDatafeedListener = PlainActionFuture.newFuture();
-        client().execute(PutDatafeedAction.INSTANCE, 
+        client().execute(PutDatafeedAction.INSTANCE,
                 new PutDatafeedAction.Request(createDatafeed(datafeedId, jobId,
                         Collections.singletonList(datafeedIndex))), putDatafeedListener);
         PutDatafeedAction.Response putDatafeedResponse = putDatafeedListener.actionGet();
@@ -340,15 +338,14 @@ public void testMachineLearningStopDatafeedActionNotRestricted() throws Exceptio
         String datafeedId = jobId + "-datafeed";
         assertMLAllowed(true);
         String datafeedIndex = jobId + "-data";
-        prepareCreate(datafeedIndex).addMapping("type", "{\"type\":{\"properties\":{\"time\":{\"type\":\"date\"}}}}",
-            XContentType.JSON).get();
+        prepareCreate(datafeedIndex).setMapping("{\"_doc\":{\"properties\":{\"time\":{\"type\":\"date\"}}}}").get();
         // test that license restricted apis do now work
         PlainActionFuture<PutJobAction.Response> putJobListener = PlainActionFuture.newFuture();
         client().execute(PutJobAction.INSTANCE, new PutJobAction.Request(createJob(jobId)), putJobListener);
         PutJobAction.Response putJobResponse = putJobListener.actionGet();
         assertNotNull(putJobResponse);
         PlainActionFuture<PutDatafeedAction.Response> putDatafeedListener = PlainActionFuture.newFuture();
-        client().execute(PutDatafeedAction.INSTANCE, 
+        client().execute(PutDatafeedAction.INSTANCE,
                 new PutDatafeedAction.Request(createDatafeed(datafeedId, jobId,
                         Collections.singletonList(datafeedIndex))), putDatafeedListener);
         PutDatafeedAction.Response putDatafeedResponse = putDatafeedListener.actionGet();
@@ -358,7 +355,7 @@ public void testMachineLearningStopDatafeedActionNotRestricted() throws Exceptio
         AcknowledgedResponse openJobResponse = openJobListener.actionGet();
         assertNotNull(openJobResponse);
         PlainActionFuture<AcknowledgedResponse> startDatafeedListener = PlainActionFuture.newFuture();
-        client().execute(StartDatafeedAction.INSTANCE, 
+        client().execute(StartDatafeedAction.INSTANCE,
             new StartDatafeedAction.Request(datafeedId, 0L), startDatafeedListener);
         AcknowledgedResponse startDatafeedResponse = startDatafeedListener.actionGet();
         assertNotNull(startDatafeedResponse);
@@ -457,7 +454,7 @@ public void testMachineLearningDeleteDatafeedActionNotRestricted() throws Except
         PutJobAction.Response putJobResponse = putJobListener.actionGet();
         assertNotNull(putJobResponse);
         PlainActionFuture<PutDatafeedAction.Response> putDatafeedListener = PlainActionFuture.newFuture();
-        client().execute(PutDatafeedAction.INSTANCE, 
+        client().execute(PutDatafeedAction.INSTANCE,
                 new PutDatafeedAction.Request(createDatafeed(datafeedId, jobId,
                         Collections.singletonList(jobId))), putDatafeedListener);
         PutDatafeedAction.Response putDatafeedResponse = putDatafeedListener.actionGet();
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
index 368cef6336966..4d7b22af1cd32 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
@@ -360,7 +360,7 @@ public void prepareIndexIfNeededThenExecute(final Consumer<Exception> consumer,
                 final Tuple<String, Settings> mappingAndSettings = parseMappingAndSettingsFromTemplateBytes(mappingSource);
                 CreateIndexRequest request = new CreateIndexRequest(indexState.concreteIndexName)
                         .alias(new Alias(this.aliasName))
-                        .mapping(MapperService.SINGLE_MAPPING_NAME, mappingAndSettings.v1(), XContentType.JSON)
+                        .mapping("{\"_doc\":" + mappingAndSettings.v1() + "}")
                         .waitForActiveShards(ActiveShardCount.ALL)
                         .settings(mappingAndSettings.v2());
                 executeAsyncWithOrigin(client.threadPool().getThreadContext(), SECURITY_ORIGIN, request,
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/throttler/ActionThrottleTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/throttler/ActionThrottleTests.java
index 86cd201a9330f..bb45e16ed7263 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/throttler/ActionThrottleTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/throttler/ActionThrottleTests.java
@@ -284,16 +284,14 @@ public void testFailingActionDoesGetThrottled() throws Exception {
         // create a mapping with a wrong @timestamp field, so that the index action of the watch below will fail
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("bar")
                 .startObject("properties")
                 .startObject("@timestamp")
                 .field("type", "integer")
                 .endObject()
                 .endObject()
-                .endObject()
                 .endObject());
 
-        client().admin().indices().prepareCreate("foo").addMapping("bar", mapping, XContentType.JSON).get();
+        client().admin().indices().prepareCreate("foo").setMapping(mapping).get();
 
         TimeValue throttlePeriod = new TimeValue(60, TimeUnit.MINUTES);
 

From d971d0ab356ab877d2d35f60b07a8ce3cc3c6d6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Thu, 2 Jan 2020 14:28:50 +0100
Subject: [PATCH 350/686] Fix type conversion problem in Eclipse (#50549)

Eclipse 4.13 shows a type mismatch error in the affected line because it cannot
correctly infer the boolean return type for the method call. Assigning return
value to a local variable resolves this problem.
---
 .../elasticsearch/xpack/ml/integration/ClassificationIT.java | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 978b11efb0f39..6d96f627b3f00 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.ml.integration;
 
 import com.google.common.collect.Ordering;
+
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.admin.indices.get.GetIndexAction;
 import org.elasticsearch.action.admin.indices.get.GetIndexRequest;
@@ -192,7 +193,9 @@ public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(String jobId,
             assertTopClasses(resultsObject, numTopClasses, dependentVariable, dependentVariableValues);
 
             // Let's just assert there's both training and non-training results
-            if (getFieldValue(resultsObject, "is_training")) {
+            //
+            boolean isTraining = getFieldValue(resultsObject, "is_training");
+            if (isTraining) {
                 trainingRowsCount++;
             } else {
                 nonTrainingRowsCount++;

From 5f981c19f07bd1b6446de6484638603eccfea16f Mon Sep 17 00:00:00 2001
From: Oleg <25862932+olegbonar@users.noreply.github.com>
Date: Thu, 2 Jan 2020 18:22:40 +0400
Subject: [PATCH 351/686] Deprecate the 'local' parameter of /_cat/nodes
 (#50499)

The cat nodes API performs a `ClusterStateAction` then a `NodesInfoAction`.
Today it accepts the `?local` parameter and passes this to the
`ClusterStateAction` but this parameter has no effect on the `NodesInfoAction`.
This is surprising, because `GET _cat/nodes?local` looks like it might be a
completely local call but in fact it still depends on every node in the
cluster.

This commit deprecates the `?local` parameter on this API so that it can be
removed in 8.0.

Relates #50088
---
 docs/reference/cat/nodes.asciidoc                 | 10 ++++++++++
 .../resources/rest-api-spec/api/cat.nodes.json    |  6 +++++-
 .../rest/action/cat/RestNodesAction.java          |  9 +++++++++
 .../rest/action/cat/RestNodesActionTests.java     | 15 +++++++++++++++
 4 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/docs/reference/cat/nodes.asciidoc b/docs/reference/cat/nodes.asciidoc
index 1c77f17d7e4f6..506bc6f5c2721 100644
--- a/docs/reference/cat/nodes.asciidoc
+++ b/docs/reference/cat/nodes.asciidoc
@@ -286,6 +286,16 @@ Number of suggest operations, such as `0`.
 include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
 
 include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
++
+--
+`local`::
+(Optional, boolean) If `true`, the request computes the list of selected nodes
+from the local cluster state. Defaults to `false`, which means the list of
+selected nodes is computed from the cluster state on the master node. In either
+case the coordinating node sends a request for further information to each
+selected node. deprecated::[8.0,This parameter does not cause this API to act
+locally. It will be removed in version 8.0.]
+--
 
 include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
 
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
index 7fd96f8b387c3..753a6aab1d5f3 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
@@ -43,7 +43,11 @@
       },
       "local":{
         "type":"boolean",
-        "description":"Return local information, do not retrieve the state from master node (default: false)"
+        "description":"Calculate the selected nodes using the local cluster state rather than the state from master node (default: false)",
+        "deprecated":{
+          "version":"8.0.0",
+          "description":"This parameter does not cause this API to act locally."
+        }
       },
       "master_timeout":{
         "type":"time",
diff --git a/server/src/main/java/org/elasticsearch/rest/action/cat/RestNodesAction.java b/server/src/main/java/org/elasticsearch/rest/action/cat/RestNodesAction.java
index aa780f104c27d..849fbdac49224 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/cat/RestNodesAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/cat/RestNodesAction.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.rest.action.cat;
 
+import org.apache.logging.log4j.LogManager;
 import org.elasticsearch.action.admin.cluster.node.info.NodeInfo;
 import org.elasticsearch.action.admin.cluster.node.info.NodesInfoRequest;
 import org.elasticsearch.action.admin.cluster.node.info.NodesInfoResponse;
@@ -33,6 +34,7 @@
 import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.Table;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.network.NetworkAddress;
 import org.elasticsearch.common.transport.TransportAddress;
 import org.elasticsearch.common.unit.ByteSizeValue;
@@ -67,6 +69,10 @@
 import static org.elasticsearch.rest.RestRequest.Method.GET;
 
 public class RestNodesAction extends AbstractCatAction {
+    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(
+        LogManager.getLogger(RestNodesAction.class));
+    static final String LOCAL_DEPRECATED_MESSAGE = "Deprecated parameter [local] used. This parameter does not cause this API to act " +
+            "locally, and should not be used. It will be unsupported in version 8.0.";
 
     public RestNodesAction(RestController controller) {
         controller.registerHandler(GET, "/_cat/nodes", this);
@@ -86,6 +92,9 @@ protected void documentation(StringBuilder sb) {
     public RestChannelConsumer doCatRequest(final RestRequest request, final NodeClient client) {
         final ClusterStateRequest clusterStateRequest = new ClusterStateRequest();
         clusterStateRequest.clear().nodes(true);
+        if (request.hasParam("local")) {
+            deprecationLogger.deprecated(LOCAL_DEPRECATED_MESSAGE);
+        }
         clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));
         clusterStateRequest.masterNodeTimeout(request.paramAsTime("master_timeout", clusterStateRequest.masterNodeTimeout()));
         final boolean fullId = request.paramAsBoolean("full_id", false);
diff --git a/server/src/test/java/org/elasticsearch/rest/action/cat/RestNodesActionTests.java b/server/src/test/java/org/elasticsearch/rest/action/cat/RestNodesActionTests.java
index bbdb098a42d34..05b14d6b1cfc4 100644
--- a/server/src/test/java/org/elasticsearch/rest/action/cat/RestNodesActionTests.java
+++ b/server/src/test/java/org/elasticsearch/rest/action/cat/RestNodesActionTests.java
@@ -23,13 +23,16 @@
 import org.elasticsearch.action.admin.cluster.node.info.NodesInfoResponse;
 import org.elasticsearch.action.admin.cluster.node.stats.NodesStatsResponse;
 import org.elasticsearch.action.admin.cluster.state.ClusterStateResponse;
+import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.node.DiscoveryNodes;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.rest.RestController;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.rest.FakeRestRequest;
+import org.elasticsearch.threadpool.TestThreadPool;
 import org.elasticsearch.usage.UsageService;
 import org.junit.Before;
 
@@ -65,4 +68,16 @@ public void testBuildTableDoesNotThrowGivenNullNodeInfoAndStats() {
 
         action.buildTable(false, new FakeRestRequest(), clusterStateResponse, nodesInfoResponse, nodesStatsResponse);
     }
+
+    public void testCatNodesWithLocalDeprecationWarning() {
+        TestThreadPool threadPool = new TestThreadPool(RestNodesActionTests.class.getName());
+        NodeClient client = new NodeClient(Settings.EMPTY, threadPool);
+        FakeRestRequest request = new FakeRestRequest();
+        request.params().put("local", randomFrom("", "true", "false"));
+
+        action.doCatRequest(request, client);
+        assertWarnings(RestNodesAction.LOCAL_DEPRECATED_MESSAGE);
+
+        terminate(threadPool);
+    }
 }

From aa4dd23485582d9e4d1b895022b8b2c378be0edd Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Thu, 2 Jan 2020 09:47:12 -0500
Subject: [PATCH 352/686] Make some ObjectParsers final (#50471)

We have about 800 `ObjectParsers` in Elasticsearch, about 700 of which
are final. This is *probably* the right way to declare them because in
practice we never mutate them after they are built. And we certainly
don't change the static reference. Anyway, this adds `final` to a bunch
of these parsers, mostly the ones in xpack and their "paired" parsers in
the high level rest client. I picked these just to have somewhere to
break the up the change so it wouldn't be huge.

I found the non-final parsers with this:
```
diff \
  <(find . -type f -name '*.java' -exec grep -iHe 'static.*PARSER\s*=' {} \+ | sort) \
  <(find . -type f -name '*.java' -exec grep -iHe 'static.*final.*PARSER\s*=' {} \+ | sort) \
  2>&1 | grep '^<'
```
---
 .../org/elasticsearch/client/core/MainResponse.java   |  3 +--
 .../org/elasticsearch/client/ilm/LifecyclePolicy.java |  2 +-
 .../client/ml/dataframe/explain/FieldSelection.java   |  2 +-
 .../client/security/CreateApiKeyResponse.java         |  2 +-
 .../client/security/GetApiKeyResponse.java            |  7 ++++---
 .../client/security/InvalidateApiKeyResponse.java     | 10 ++++++----
 .../elasticsearch/client/security/support/ApiKey.java |  2 +-
 .../aggregations/matrix/stats/ParsedMatrixStats.java  |  2 +-
 .../xpack/ccr/action/ShardFollowTask.java             |  2 +-
 .../elasticsearch/xpack/core/ilm/LifecyclePolicy.java |  2 +-
 .../xpack/core/ml/action/CloseJobAction.java          |  2 +-
 .../xpack/core/ml/action/IsolateDatafeedAction.java   |  3 +--
 .../xpack/core/ml/action/OpenJobAction.java           |  2 +-
 .../core/ml/action/RevertModelSnapshotAction.java     |  3 +--
 .../core/ml/action/StartDataFrameAnalyticsAction.java |  2 +-
 .../xpack/core/ml/action/StartDatafeedAction.java     |  6 +++++-
 .../xpack/core/ml/action/StopDatafeedAction.java      |  3 +--
 .../core/ml/dataframe/explain/FieldSelection.java     |  3 ++-
 .../xpack/core/security/action/ApiKey.java            |  2 +-
 .../core/security/action/CreateApiKeyResponse.java    |  2 +-
 .../xpack/core/security/action/GetApiKeyResponse.java |  2 +-
 .../security/action/InvalidateApiKeyResponse.java     | 11 +++++++----
 .../core/transform/action/PreviewTransformAction.java |  2 +-
 23 files changed, 42 insertions(+), 35 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MainResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MainResponse.java
index 96810fe8c8b62..09fc2b49a0156 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MainResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MainResponse.java
@@ -27,8 +27,7 @@
 
 public class MainResponse {
 
-    @SuppressWarnings("unchecked")
-    private static ConstructingObjectParser<MainResponse, Void> PARSER =
+    private static final ConstructingObjectParser<MainResponse, Void> PARSER =
         new ConstructingObjectParser<>(MainResponse.class.getName(), true,
             args -> {
                  return new MainResponse((String) args[0], (Version) args[1], (String) args[2], (String) args[3], (String) args[4]);
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ilm/LifecyclePolicy.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ilm/LifecyclePolicy.java
index e3ead01006256..b6d16ddccfe89 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ilm/LifecyclePolicy.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ilm/LifecyclePolicy.java
@@ -44,7 +44,7 @@ public class LifecyclePolicy implements ToXContentObject {
     static final ParseField PHASES_FIELD = new ParseField("phases");
 
     @SuppressWarnings("unchecked")
-    public static ConstructingObjectParser<LifecyclePolicy, String> PARSER = new ConstructingObjectParser<>("lifecycle_policy", true,
+    public static final ConstructingObjectParser<LifecyclePolicy, String> PARSER = new ConstructingObjectParser<>("lifecycle_policy", true,
         (a, name) -> {
             List<Phase> phases = (List<Phase>) a[0];
             Map<String, Phase> phaseMap = phases.stream().collect(Collectors.toMap(Phase::getName, Function.identity()));
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/explain/FieldSelection.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/explain/FieldSelection.java
index 4483b6fa5e09a..997fa8727692a 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/explain/FieldSelection.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/explain/FieldSelection.java
@@ -57,7 +57,7 @@ public String toString() {
     }
 
     @SuppressWarnings("unchecked")
-    public static ConstructingObjectParser<FieldSelection, Void> PARSER = new ConstructingObjectParser<>("field_selection", true,
+    public static final ConstructingObjectParser<FieldSelection, Void> PARSER = new ConstructingObjectParser<>("field_selection", true,
         a -> new FieldSelection((String) a[0], new HashSet<>((List<String>) a[1]), (boolean) a[2], (boolean) a[3], (FeatureType) a[4],
             (String) a[5]));
 
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/security/CreateApiKeyResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/security/CreateApiKeyResponse.java
index 9c5037237407b..0e99f0476bab0 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/security/CreateApiKeyResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/security/CreateApiKeyResponse.java
@@ -89,7 +89,7 @@ public boolean equals(Object obj) {
                 && Objects.equals(expiration, other.expiration);
     }
 
-    static ConstructingObjectParser<CreateApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("create_api_key_response",
+    static final ConstructingObjectParser<CreateApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("create_api_key_response",
             args -> new CreateApiKeyResponse((String) args[0], (String) args[1], new SecureString((String) args[2]),
                     (args[3] == null) ? null : Instant.ofEpochMilli((Long) args[3])));
     static {
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/security/GetApiKeyResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/security/GetApiKeyResponse.java
index 58e3e8effbb09..306866bad6955 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/security/GetApiKeyResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/security/GetApiKeyResponse.java
@@ -73,9 +73,10 @@ public boolean equals(Object obj) {
     }
 
     @SuppressWarnings("unchecked")
-    static ConstructingObjectParser<GetApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("get_api_key_response", args -> {
-        return (args[0] == null) ? GetApiKeyResponse.emptyResponse() : new GetApiKeyResponse((List<ApiKey>) args[0]);
-    });
+    static final ConstructingObjectParser<GetApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>(
+        "get_api_key_response",
+        args -> { return (args[0] == null) ? GetApiKeyResponse.emptyResponse() : new GetApiKeyResponse((List<ApiKey>) args[0]); }
+    );
     static {
         PARSER.declareObjectArray(optionalConstructorArg(), (p, c) -> ApiKey.fromXContent(p), new ParseField("api_keys"));
     }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/security/InvalidateApiKeyResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/security/InvalidateApiKeyResponse.java
index 48df9d0f7f12b..14deac350506d 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/security/InvalidateApiKeyResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/security/InvalidateApiKeyResponse.java
@@ -74,10 +74,12 @@ public List<ElasticsearchException> getErrors() {
     }
 
     @SuppressWarnings("unchecked")
-    static ConstructingObjectParser<InvalidateApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("invalidate_api_key_response",
-            args -> {
-                return new InvalidateApiKeyResponse((List<String>) args[0], (List<String>) args[1], (List<ElasticsearchException>) args[3]);
-            });
+    static final ConstructingObjectParser<InvalidateApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>(
+        "invalidate_api_key_response",
+        args -> {
+            return new InvalidateApiKeyResponse((List<String>) args[0], (List<String>) args[1], (List<ElasticsearchException>) args[3]);
+        }
+    );
     static {
         PARSER.declareStringArray(constructorArg(), new ParseField("invalidated_api_keys"));
         PARSER.declareStringArray(constructorArg(), new ParseField("previously_invalidated_api_keys"));
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/security/support/ApiKey.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/security/support/ApiKey.java
index d7065a311a53e..747010fd09f98 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/security/support/ApiKey.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/security/support/ApiKey.java
@@ -127,7 +127,7 @@ public boolean equals(Object obj) {
                 && Objects.equals(realm, other.realm);
     }
 
-    static ConstructingObjectParser<ApiKey, Void> PARSER = new ConstructingObjectParser<>("api_key", args -> {
+    static final ConstructingObjectParser<ApiKey, Void> PARSER = new ConstructingObjectParser<>("api_key", args -> {
         return new ApiKey((String) args[0], (String) args[1], Instant.ofEpochMilli((Long) args[2]),
                 (args[3] == null) ? null : Instant.ofEpochMilli((Long) args[3]), (Boolean) args[4], (String) args[5], (String) args[6]);
     });
diff --git a/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/ParsedMatrixStats.java b/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/ParsedMatrixStats.java
index a0b9224ad0d25..ba28e0b0ee361 100644
--- a/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/ParsedMatrixStats.java
+++ b/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/ParsedMatrixStats.java
@@ -151,7 +151,7 @@ private static <T> T checkedGet(final Map<String, T> values, final String fieldN
         return values.get(fieldName);
     }
 
-    private static ObjectParser<ParsedMatrixStats, Void> PARSER =
+    private static final ObjectParser<ParsedMatrixStats, Void> PARSER =
             new ObjectParser<>(ParsedMatrixStats.class.getSimpleName(), true, ParsedMatrixStats::new);
     static {
         declareAggregationFields(PARSER);
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/ShardFollowTask.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/ShardFollowTask.java
index 28f06505a0060..bcadfe4f80717 100644
--- a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/ShardFollowTask.java
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/action/ShardFollowTask.java
@@ -44,7 +44,7 @@ public class ShardFollowTask extends ImmutableFollowParameters implements Persis
     private static final ParseField HEADERS = new ParseField("headers");
 
     @SuppressWarnings("unchecked")
-    private static ConstructingObjectParser<ShardFollowTask, Void> PARSER = new ConstructingObjectParser<>(NAME,
+    private static final ConstructingObjectParser<ShardFollowTask, Void> PARSER = new ConstructingObjectParser<>(NAME,
             (a) -> new ShardFollowTask((String) a[0],
                 new ShardId((String) a[1], (String) a[2], (int) a[3]), new ShardId((String) a[4], (String) a[5], (int) a[6]),
                 (Integer) a[7], (Integer) a[8], (Integer) a[9], (Integer) a[10], (ByteSizeValue) a[11], (ByteSizeValue) a[12],
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicy.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicy.java
index 7c810d12552bb..aa16473f2111f 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicy.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicy.java
@@ -47,7 +47,7 @@ public class LifecyclePolicy extends AbstractDiffable<LifecyclePolicy>
     public static final ParseField PHASES_FIELD = new ParseField("phases");
 
     @SuppressWarnings("unchecked")
-    public static ConstructingObjectParser<LifecyclePolicy, String> PARSER = new ConstructingObjectParser<>("lifecycle_policy", false,
+    public static final ConstructingObjectParser<LifecyclePolicy, String> PARSER = new ConstructingObjectParser<>("lifecycle_policy", false,
             (a, name) -> {
                 List<Phase> phases = (List<Phase>) a[0];
                 Map<String, Phase> phaseMap = phases.stream().collect(Collectors.toMap(Phase::getName, Function.identity()));
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/CloseJobAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/CloseJobAction.java
index 4e19af64758ac..97debd2bc55e9 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/CloseJobAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/CloseJobAction.java
@@ -40,7 +40,7 @@ public static class Request extends BaseTasksRequest<Request> implements ToXCont
         public static final ParseField TIMEOUT = new ParseField("timeout");
         public static final ParseField FORCE = new ParseField("force");
         public static final ParseField ALLOW_NO_JOBS = new ParseField("allow_no_jobs");
-        public static ObjectParser<Request, Void> PARSER = new ObjectParser<>(NAME, Request::new);
+        public static final ObjectParser<Request, Void> PARSER = new ObjectParser<>(NAME, Request::new);
 
         static {
             PARSER.declareString(Request::setJobId, Job.ID);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/IsolateDatafeedAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/IsolateDatafeedAction.java
index a3d8088d138ab..4187b347a8da6 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/IsolateDatafeedAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/IsolateDatafeedAction.java
@@ -46,8 +46,7 @@ private IsolateDatafeedAction() {
 
     public static class Request extends BaseTasksRequest<Request> implements ToXContentObject {
 
-        public static ObjectParser<Request, Void> PARSER = new ObjectParser<>(NAME, Request::new);
-
+        public static final ObjectParser<Request, Void> PARSER = new ObjectParser<>(NAME, Request::new);
         static {
             PARSER.declareString((request, datafeedId) -> request.datafeedId = datafeedId, DatafeedConfig.ID);
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/OpenJobAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/OpenJobAction.java
index 63b664c0bd99e..67d5d96972ac3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/OpenJobAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/OpenJobAction.java
@@ -124,7 +124,7 @@ public static class JobParams implements PersistentTaskParams {
         public static final ParseField TIMEOUT = new ParseField("timeout");
         public static final ParseField JOB = new ParseField("job");
 
-        public static ObjectParser<JobParams, Void> PARSER = new ObjectParser<>(MlTasks.JOB_TASK_NAME, true, JobParams::new);
+        public static final ObjectParser<JobParams, Void> PARSER = new ObjectParser<>(MlTasks.JOB_TASK_NAME, true, JobParams::new);
         static {
             PARSER.declareString(JobParams::setJobId, Job.ID);
             PARSER.declareString((params, val) ->
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/RevertModelSnapshotAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/RevertModelSnapshotAction.java
index aeabe2102f09d..dfeb94d73291c 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/RevertModelSnapshotAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/RevertModelSnapshotAction.java
@@ -42,8 +42,7 @@ public static class Request extends AcknowledgedRequest<Request> implements ToXC
         public static final ParseField SNAPSHOT_ID = new ParseField("snapshot_id");
         public static final ParseField DELETE_INTERVENING = new ParseField("delete_intervening_results");
 
-        private static ObjectParser<Request, Void> PARSER = new ObjectParser<>(NAME, Request::new);
-
+        private static final ObjectParser<Request, Void> PARSER = new ObjectParser<>(NAME, Request::new);
         static {
             PARSER.declareString((request, jobId) -> request.jobId = jobId, Job.ID);
             PARSER.declareString((request, snapshotId) -> request.snapshotId = snapshotId, SNAPSHOT_ID);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartDataFrameAnalyticsAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartDataFrameAnalyticsAction.java
index c9e486fb86cc0..0455e1eb1b35d 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartDataFrameAnalyticsAction.java
@@ -157,7 +157,7 @@ public static class TaskParams implements PersistentTaskParams {
         private static final ParseField PROGRESS_ON_START = new ParseField("progress_on_start");
 
         @SuppressWarnings("unchecked")
-        public static ConstructingObjectParser<TaskParams, Void> PARSER = new ConstructingObjectParser<>(
+        public static final ConstructingObjectParser<TaskParams, Void> PARSER = new ConstructingObjectParser<>(
             MlTasks.DATA_FRAME_ANALYTICS_TASK_NAME, true,
             a -> new TaskParams((String) a[0], (String) a[1], (List<PhaseProgress>) a[2], (Boolean) a[3]));
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartDatafeedAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartDatafeedAction.java
index 2e2f837039c51..afd58e0b70554 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartDatafeedAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartDatafeedAction.java
@@ -136,7 +136,11 @@ public static class DatafeedParams implements PersistentTaskParams {
 
         public static final ParseField INDICES = new ParseField("indices");
 
-        public static ObjectParser<DatafeedParams, Void> PARSER = new ObjectParser<>(MlTasks.DATAFEED_TASK_NAME, true, DatafeedParams::new);
+        public static final ObjectParser<DatafeedParams, Void> PARSER = new ObjectParser<>(
+            MlTasks.DATAFEED_TASK_NAME,
+            true,
+            DatafeedParams::new
+        );
         static {
             PARSER.declareString((params, datafeedId) -> params.datafeedId = datafeedId, DatafeedConfig.ID);
             PARSER.declareString((params, startTime) -> params.startTime = parseDateOrThrow(
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StopDatafeedAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StopDatafeedAction.java
index 1c21fde4382df..96d1fdb31d479 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StopDatafeedAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StopDatafeedAction.java
@@ -44,8 +44,7 @@ public static class Request extends BaseTasksRequest<Request> implements ToXCont
         public static final ParseField FORCE = new ParseField("force");
         public static final ParseField ALLOW_NO_DATAFEEDS = new ParseField("allow_no_datafeeds");
 
-        public static ObjectParser<Request, Void> PARSER = new ObjectParser<>(NAME, Request::new);
-
+        public static final ObjectParser<Request, Void> PARSER = new ObjectParser<>(NAME, Request::new);
         static {
             PARSER.declareString((request, datafeedId) -> request.datafeedId = datafeedId, DatafeedConfig.ID);
             PARSER.declareString((request, val) ->
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/explain/FieldSelection.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/explain/FieldSelection.java
index 57fae51d36643..609cec3734562 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/explain/FieldSelection.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/explain/FieldSelection.java
@@ -46,7 +46,8 @@ public String toString() {
         }
     }
 
-    public static ConstructingObjectParser<FieldSelection, Void> PARSER = new ConstructingObjectParser<>("field_selection",
+    @SuppressWarnings("unchecked")
+    public static final ConstructingObjectParser<FieldSelection, Void> PARSER = new ConstructingObjectParser<>("field_selection",
         a -> new FieldSelection((String) a[0], new HashSet<>((List<String>) a[1]), (boolean) a[2], (boolean) a[3], (FeatureType) a[4],
             (String) a[5]));
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/ApiKey.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/ApiKey.java
index 214881f34ea01..9c6d6a9f9b63a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/ApiKey.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/ApiKey.java
@@ -147,7 +147,7 @@ public boolean equals(Object obj) {
                 && Objects.equals(realm, other.realm);
     }
 
-    static ConstructingObjectParser<ApiKey, Void> PARSER = new ConstructingObjectParser<>("api_key", args -> {
+    static final ConstructingObjectParser<ApiKey, Void> PARSER = new ConstructingObjectParser<>("api_key", args -> {
         return new ApiKey((String) args[0], (String) args[1], Instant.ofEpochMilli((Long) args[2]),
                 (args[3] == null) ? null : Instant.ofEpochMilli((Long) args[3]), (Boolean) args[4], (String) args[5], (String) args[6]);
     });
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/CreateApiKeyResponse.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/CreateApiKeyResponse.java
index 56c855fe26b00..2fe2c36f9ceac 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/CreateApiKeyResponse.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/CreateApiKeyResponse.java
@@ -31,7 +31,7 @@
  */
 public final class CreateApiKeyResponse extends ActionResponse implements ToXContentObject {
 
-    static ConstructingObjectParser<CreateApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("create_api_key_response",
+    static final ConstructingObjectParser<CreateApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("create_api_key_response",
             args -> new CreateApiKeyResponse((String) args[0], (String) args[1], new SecureString((String) args[2]),
                     (args[3] == null) ? null : Instant.ofEpochMilli((Long) args[3])));
     static {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/GetApiKeyResponse.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/GetApiKeyResponse.java
index f4765721819b5..19c826da524da 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/GetApiKeyResponse.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/GetApiKeyResponse.java
@@ -63,7 +63,7 @@ public void writeTo(StreamOutput out) throws IOException {
     }
 
     @SuppressWarnings("unchecked")
-    static ConstructingObjectParser<GetApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("get_api_key_response", args -> {
+    static final ConstructingObjectParser<GetApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("get_api_key_response", args -> {
         return (args[0] == null) ? GetApiKeyResponse.emptyResponse() : new GetApiKeyResponse((List<ApiKey>) args[0]);
     });
     static {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/InvalidateApiKeyResponse.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/InvalidateApiKeyResponse.java
index 39850c0fff88d..d6b03d6e5fdbd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/InvalidateApiKeyResponse.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/InvalidateApiKeyResponse.java
@@ -109,10 +109,13 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeCollection(errors, StreamOutput::writeException);
     }
 
-    static ConstructingObjectParser<InvalidateApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>("invalidate_api_key_response",
-            args -> {
-                return new InvalidateApiKeyResponse((List<String>) args[0], (List<String>) args[1], (List<ElasticsearchException>) args[3]);
-            });
+    @SuppressWarnings("unchecked")
+    static final ConstructingObjectParser<InvalidateApiKeyResponse, Void> PARSER = new ConstructingObjectParser<>(
+        "invalidate_api_key_response",
+        args -> {
+            return new InvalidateApiKeyResponse((List<String>) args[0], (List<String>) args[1], (List<ElasticsearchException>) args[3]);
+        }
+    );
     static {
         PARSER.declareStringArray(constructorArg(), new ParseField("invalidated_api_keys"));
         PARSER.declareStringArray(constructorArg(), new ParseField("previously_invalidated_api_keys"));
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PreviewTransformAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PreviewTransformAction.java
index 9078d5952e2af..66c57e2bf0080 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PreviewTransformAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/action/PreviewTransformAction.java
@@ -145,7 +145,7 @@ public static class Response extends ActionResponse implements ToXContentObject
         public static ParseField PREVIEW = new ParseField("preview");
         public static ParseField MAPPINGS = new ParseField("mappings");
 
-        static ObjectParser<Response, Void> PARSER = new ObjectParser<>("data_frame_transform_preview", Response::new);
+        static final ObjectParser<Response, Void> PARSER = new ObjectParser<>("data_frame_transform_preview", Response::new);
         static {
             PARSER.declareObjectArray(Response::setDocs, (p, c) -> p.mapOrdered(), PREVIEW);
             PARSER.declareObject(Response::setMappings, (p, c) -> p.mapOrdered(), MAPPINGS);

From 6b789f2eec18906bf4c86d6aa4c1aaa7432f20e1 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Thu, 2 Jan 2020 10:02:55 -0500
Subject: [PATCH 353/686] Docs: Refine note about `after_key` (#50475)

* Docs: Refine note about `after_key`

I was curious about composite aggregations, specifically I wanted to
know how to write a composite aggregation that had all of its buckets
filtered out so you *had* to use the `after_key`. Then I saw that we've
declared composite aggregations not to work with pipelines in #44180. So
I'm not sure you *can* do that any more. Which makes the note about
`after_key` inaccurate. This rejiggers that section of the docs a little
so it is more obvious that you send the `after_key` back to us. And so
it is more obvious that you should *only* use the `after_key` that we
give you rather than try to work it out for yourself.

* Apply suggestions from code review

Co-Authored-By: James Rodewig <james.rodewig@elastic.co>

Co-authored-by: James Rodewig <james.rodewig@elastic.co>
---
 .../bucket/composite-aggregation.asciidoc     | 20 ++++++++-----------
 1 file changed, 8 insertions(+), 12 deletions(-)

diff --git a/docs/reference/aggregations/bucket/composite-aggregation.asciidoc b/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
index 226d9c2d7ade1..ec253a5556059 100644
--- a/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
+++ b/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
@@ -441,7 +441,7 @@ GET /_search
     ...
     "aggregations": {
         "my_buckets": {
-            "after_key": { <1>
+            "after_key": {
                 "date": 1494288000000,
                 "product": "mad max"
             },
@@ -467,17 +467,9 @@ GET /_search
 --------------------------------------------------
 // TESTRESPONSE[s/\.\.\.//]
 
-<1> The last composite bucket returned by the query.
-
-NOTE: The `after_key` is equals to the last bucket returned in the response before
-any filtering that could be done by <<search-aggregations-pipeline, Pipeline aggregations>>.
-If all buckets are filtered/removed by a pipeline aggregation, the `after_key` will contain
-the last bucket before filtering.
-
-The `after` parameter can be used to retrieve the composite buckets that are **after**
-the last composite buckets returned in a previous round.
-For the example below the last bucket can be found in `after_key` and the next
-round of result can be retrieved with:
+To get the next set of buckets, resend the same aggregation with the `after`
+parameter set to the `after_key` value returned in the response.
+For example, this request uses the `after_key` value provided in the previous response:
 
 [source,console,id=composite-aggregation-after-example]
 --------------------------------------------------
@@ -501,6 +493,10 @@ GET /_search
 
 <1> Should restrict the aggregation to buckets that sort **after** the provided values.
 
+NOTE: The `after_key` is *usually* the key to the last bucket returned in
+the response, but that isn't guaranteed. Always use the returned `after_key` instead
+of derriving it from the buckets.
+
 ==== Early termination
 
 For optimal performance the <<index-modules-index-sorting,index sort>> should be set on the index so that it matches

From 188677118b1dfd8240f10a1305c69b1fbc493734 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 2 Jan 2020 16:30:23 +0100
Subject: [PATCH 354/686] Make EC2 Discovery Plugin Retry Requests (#50550)

Use the default retry condition instead of never retrying in the discovery plugin causing hot retries upstream and add a test that verifies retrying works.

Closes #50462
---
 .../discovery/ec2/AwsEc2ServiceImpl.java      |  17 +-
 .../discovery/ec2/EC2RetriesTests.java        | 266 ++++++++++++++++++
 2 files changed, 268 insertions(+), 15 deletions(-)
 create mode 100644 plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/EC2RetriesTests.java

diff --git a/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImpl.java b/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImpl.java
index 739b964925c3e..546634c88cf45 100644
--- a/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImpl.java
+++ b/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImpl.java
@@ -25,21 +25,18 @@
 import com.amazonaws.auth.AWSStaticCredentialsProvider;
 import com.amazonaws.auth.DefaultAWSCredentialsProviderChain;
 import com.amazonaws.http.IdleConnectionReaper;
-import com.amazonaws.retry.RetryPolicy;
 import com.amazonaws.services.ec2.AmazonEC2;
 import com.amazonaws.services.ec2.AmazonEC2Client;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.util.LazyInitializable;
 
-import java.util.Random;
 import java.util.concurrent.atomic.AtomicReference;
 
 class AwsEc2ServiceImpl implements AwsEc2Service {
-    
+
     private static final Logger logger = LogManager.getLogger(AwsEc2ServiceImpl.class);
 
     private final AtomicReference<LazyInitializable<AmazonEc2Reference, ElasticsearchException>> lazyClientReference =
@@ -77,17 +74,7 @@ static ClientConfiguration buildConfiguration(Logger logger, Ec2ClientSettings c
             clientConfiguration.setProxyPassword(clientSettings.proxyPassword);
         }
         // Increase the number of retries in case of 5xx API responses
-        final Random rand = Randomness.get();
-        final RetryPolicy retryPolicy = new RetryPolicy(
-            RetryPolicy.RetryCondition.NO_RETRY_CONDITION,
-            (originalRequest, exception, retriesAttempted) -> {
-               // with 10 retries the max delay time is 320s/320000ms (10 * 2^5 * 1 * 1000)
-               logger.warn("EC2 API request failed, retry again. Reason was:", exception);
-               return 1000L * (long) (10d * Math.pow(2, retriesAttempted / 2.0d) * (1.0d + rand.nextDouble()));
-            },
-            10,
-            false);
-        clientConfiguration.setRetryPolicy(retryPolicy);
+        clientConfiguration.setMaxErrorRetry(10);
         clientConfiguration.setSocketTimeout(clientSettings.readTimeoutMillis);
         return clientConfiguration;
     }
diff --git a/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/EC2RetriesTests.java b/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/EC2RetriesTests.java
new file mode 100644
index 0000000000000..df8effd9548b6
--- /dev/null
+++ b/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/EC2RetriesTests.java
@@ -0,0 +1,266 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.discovery.ec2;
+
+import com.amazonaws.http.HttpMethodName;
+import com.sun.net.httpserver.HttpServer;
+import org.apache.http.HttpStatus;
+import org.apache.http.NameValuePair;
+import org.apache.http.client.utils.URLEncodedUtils;
+import org.elasticsearch.Version;
+import org.elasticsearch.common.SuppressForbidden;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.network.InetAddresses;
+import org.elasticsearch.common.network.NetworkService;
+import org.elasticsearch.common.settings.MockSecureSettings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.transport.TransportAddress;
+import org.elasticsearch.common.util.PageCacheRecycler;
+import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.discovery.SeedHostsProvider;
+import org.elasticsearch.discovery.SeedHostsResolver;
+import org.elasticsearch.indices.breaker.NoneCircuitBreakerService;
+import org.elasticsearch.mocksocket.MockHttpServer;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.transport.MockTransportService;
+import org.elasticsearch.threadpool.TestThreadPool;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.transport.nio.MockNioTransport;
+import org.hamcrest.Matchers;
+import org.junit.After;
+import org.junit.Before;
+
+import javax.xml.XMLConstants;
+import javax.xml.stream.XMLOutputFactory;
+import javax.xml.stream.XMLStreamWriter;
+
+import java.io.IOException;
+import java.io.StringWriter;
+import java.net.InetAddress;
+import java.net.InetSocketAddress;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+
+import static java.nio.charset.StandardCharsets.UTF_8;
+import static org.hamcrest.Matchers.aMapWithSize;
+import static org.hamcrest.Matchers.is;
+
+@SuppressForbidden(reason = "use a http server")
+public class EC2RetriesTests extends ESTestCase {
+
+    private HttpServer httpServer;
+
+    private ThreadPool threadPool;
+
+    private MockTransportService transportService;
+
+    private NetworkService networkService = new NetworkService(Collections.emptyList());
+
+    @Before
+    public void setUp() throws Exception {
+        httpServer = MockHttpServer.createHttp(new InetSocketAddress(InetAddress.getLoopbackAddress(), 0), 0);
+        httpServer.start();
+        threadPool = new TestThreadPool(EC2RetriesTests.class.getName());
+        final MockNioTransport transport = new MockNioTransport(Settings.EMPTY, Version.CURRENT, threadPool, networkService,
+            PageCacheRecycler.NON_RECYCLING_INSTANCE, new NamedWriteableRegistry(Collections.emptyList()),
+            new NoneCircuitBreakerService());
+        transportService =
+            new MockTransportService(Settings.EMPTY, transport, threadPool, TransportService.NOOP_TRANSPORT_INTERCEPTOR, null);
+        super.setUp();
+    }
+
+    @After
+    public void tearDown() throws Exception {
+        try {
+            IOUtils.close(transportService, () -> terminate(threadPool), () -> httpServer.stop(0));
+        } finally {
+            super.tearDown();
+        }
+    }
+
+    public void testEC2DiscoveryRetriesOnRateLimiting() throws IOException {
+        final String accessKey = "ec2_access";
+        final List<String> hosts = List.of("127.0.0.1:9000");
+        final Map<String, Integer> failedRequests = new ConcurrentHashMap<>();
+        // retry the same request 5 times at most
+        final int maxRetries = randomIntBetween(1, 5);
+        httpServer.createContext("/", exchange -> {
+            if (exchange.getRequestMethod().equals(HttpMethodName.POST.name())) {
+                final String request = new String(exchange.getRequestBody().readAllBytes(), UTF_8);
+                final String userAgent = exchange.getRequestHeaders().getFirst("User-Agent");
+                if (userAgent != null && userAgent.startsWith("aws-sdk-java")) {
+                    final String auth = exchange.getRequestHeaders().getFirst("Authorization");
+                    if (auth == null || auth.contains(accessKey) == false) {
+                        throw new IllegalArgumentException("wrong access key: " + auth);
+                    }
+                    if (failedRequests.compute(exchange.getRequestHeaders().getFirst("Amz-sdk-invocation-id"),
+                        (requestId, count) -> Objects.requireNonNullElse(count, 0) + 1) < maxRetries) {
+                        exchange.sendResponseHeaders(HttpStatus.SC_SERVICE_UNAVAILABLE, -1);
+                        return;
+                    }
+                    // Simulate an EC2 DescribeInstancesResponse
+                    byte[] responseBody = null;
+                    for (NameValuePair parse : URLEncodedUtils.parse(request, UTF_8)) {
+                        if ("Action".equals(parse.getName())) {
+                            responseBody = generateDescribeInstancesResponse(hosts);
+                            break;
+                        }
+                    }
+                    responseBody = responseBody == null ? new byte[0] : responseBody;
+                    exchange.getResponseHeaders().set("Content-Type", "text/xml; charset=UTF-8");
+                    exchange.sendResponseHeaders(HttpStatus.SC_OK, responseBody.length);
+                    exchange.getResponseBody().write(responseBody);
+                    return;
+                }
+            }
+            fail("did not send response");
+        });
+
+        final InetSocketAddress address = httpServer.getAddress();
+        final String endpoint = "http://" + InetAddresses.toUriString(address.getAddress()) + ":" + address.getPort();
+        final MockSecureSettings mockSecure = new MockSecureSettings();
+        mockSecure.setString(Ec2ClientSettings.ACCESS_KEY_SETTING.getKey(), accessKey);
+        mockSecure.setString(Ec2ClientSettings.SECRET_KEY_SETTING.getKey(), "ec2_secret");
+        try (Ec2DiscoveryPlugin plugin = new Ec2DiscoveryPlugin(
+            Settings.builder().put(Ec2ClientSettings.ENDPOINT_SETTING.getKey(), endpoint).setSecureSettings(mockSecure).build())) {
+            final SeedHostsProvider seedHostsProvider = plugin.getSeedHostProviders(transportService, networkService).get("ec2").get();
+            final SeedHostsResolver resolver = new SeedHostsResolver("test", Settings.EMPTY, transportService, seedHostsProvider);
+            resolver.start();
+            final List<TransportAddress> addressList = seedHostsProvider.getSeedAddresses(resolver);
+            assertThat(addressList, Matchers.hasSize(1));
+            assertThat(addressList.get(0).toString(), is(hosts.get(0)));
+            assertThat(failedRequests, aMapWithSize(1));
+            assertThat(failedRequests.values().iterator().next(), is(maxRetries));
+        }
+    }
+
+    /**
+     * Generates a XML response that describe the EC2 instances
+     * TODO: org.elasticsearch.discovery.ec2.AmazonEC2Fixture uses pretty much the same code. We should dry up that test fixture.
+     */
+    private byte[] generateDescribeInstancesResponse(List<String> nodes) {
+        final XMLOutputFactory xmlOutputFactory = XMLOutputFactory.newFactory();
+        xmlOutputFactory.setProperty(XMLOutputFactory.IS_REPAIRING_NAMESPACES, true);
+
+        final StringWriter out = new StringWriter();
+        XMLStreamWriter sw;
+        try {
+            sw = xmlOutputFactory.createXMLStreamWriter(out);
+            sw.writeStartDocument();
+
+            String namespace = "http://ec2.amazonaws.com/doc/2013-02-01/";
+            sw.setDefaultNamespace(namespace);
+            sw.writeStartElement(XMLConstants.DEFAULT_NS_PREFIX, "DescribeInstancesResponse", namespace);
+            {
+                sw.writeStartElement("requestId");
+                sw.writeCharacters(UUID.randomUUID().toString());
+                sw.writeEndElement();
+
+                sw.writeStartElement("reservationSet");
+                {
+                    for (String address : nodes) {
+                        sw.writeStartElement("item");
+                        {
+                            sw.writeStartElement("reservationId");
+                            sw.writeCharacters(UUID.randomUUID().toString());
+                            sw.writeEndElement();
+
+                            sw.writeStartElement("instancesSet");
+                            {
+                                sw.writeStartElement("item");
+                                {
+                                    sw.writeStartElement("instanceId");
+                                    sw.writeCharacters(UUID.randomUUID().toString());
+                                    sw.writeEndElement();
+
+                                    sw.writeStartElement("imageId");
+                                    sw.writeCharacters(UUID.randomUUID().toString());
+                                    sw.writeEndElement();
+
+                                    sw.writeStartElement("instanceState");
+                                    {
+                                        sw.writeStartElement("code");
+                                        sw.writeCharacters("16");
+                                        sw.writeEndElement();
+
+                                        sw.writeStartElement("name");
+                                        sw.writeCharacters("running");
+                                        sw.writeEndElement();
+                                    }
+                                    sw.writeEndElement();
+
+                                    sw.writeStartElement("privateDnsName");
+                                    sw.writeCharacters(address);
+                                    sw.writeEndElement();
+
+                                    sw.writeStartElement("dnsName");
+                                    sw.writeCharacters(address);
+                                    sw.writeEndElement();
+
+                                    sw.writeStartElement("instanceType");
+                                    sw.writeCharacters("m1.medium");
+                                    sw.writeEndElement();
+
+                                    sw.writeStartElement("placement");
+                                    {
+                                        sw.writeStartElement("availabilityZone");
+                                        sw.writeCharacters("use-east-1e");
+                                        sw.writeEndElement();
+
+                                        sw.writeEmptyElement("groupName");
+
+                                        sw.writeStartElement("tenancy");
+                                        sw.writeCharacters("default");
+                                        sw.writeEndElement();
+                                    }
+                                    sw.writeEndElement();
+
+                                    sw.writeStartElement("privateIpAddress");
+                                    sw.writeCharacters(address);
+                                    sw.writeEndElement();
+
+                                    sw.writeStartElement("ipAddress");
+                                    sw.writeCharacters(address);
+                                    sw.writeEndElement();
+                                }
+                                sw.writeEndElement();
+                            }
+                            sw.writeEndElement();
+                        }
+                        sw.writeEndElement();
+                    }
+                    sw.writeEndElement();
+                }
+                sw.writeEndElement();
+
+                sw.writeEndDocument();
+                sw.flush();
+            }
+        } catch (Exception e) {
+            throw new RuntimeException(e);
+        }
+        return out.toString().getBytes(UTF_8);
+    }
+}

From 4aec2a9de03ec7ab94886c6b8e5d34b1d304432a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Thu, 2 Jan 2020 16:53:56 +0100
Subject: [PATCH 355/686] Delete removed token filter names from
 SynonymsAnalysisTests (#50438)

The `testPreconfiguredTokenFilters` test refers to the `nGram` and `edgeNGram`
token filter which are no longer part of the preconfigured token filters, so
they can be removed here as well.
---
 .../common/SynonymsAnalysisTests.java         | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/SynonymsAnalysisTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/SynonymsAnalysisTests.java
index 47fb4afae2ca8..992cd11bedf0c 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/SynonymsAnalysisTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/SynonymsAnalysisTests.java
@@ -250,8 +250,8 @@ public void testTokenFiltersBypassSynonymAnalysis() throws IOException {
 
     public void testPreconfiguredTokenFilters() throws IOException {
         Set<String> disallowedFilters = new HashSet<>(Arrays.asList(
-            "common_grams", "edge_ngram", "edgeNGram", "keyword_repeat", "ngram", "nGram",
-            "shingle", "word_delimiter", "word_delimiter_graph"
+            "common_grams", "edge_ngram", "keyword_repeat", "ngram", "shingle",
+            "word_delimiter", "word_delimiter_graph"
         ));
 
         Settings settings = Settings.builder()
@@ -260,23 +260,23 @@ public void testPreconfiguredTokenFilters() throws IOException {
             .put("path.home", createTempDir().toString())
             .build();
         IndexSettings idxSettings = IndexSettingsModule.newIndexSettings("index", settings);
-
-        CommonAnalysisPlugin plugin = new CommonAnalysisPlugin();
-
-        for (PreConfiguredTokenFilter tf : plugin.getPreConfiguredTokenFilters()) {
-            if (disallowedFilters.contains(tf.getName())) {
-                IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                    "Expected exception for factory " + tf.getName(), () -> {
-                        tf.get(idxSettings, null, tf.getName(), settings).getSynonymFilter();
-                    });
-                assertEquals(tf.getName(), "Token filter [" + tf.getName()
-                        + "] cannot be used to parse synonyms",
-                    e.getMessage());
-            }
-            else {
-                tf.get(idxSettings, null, tf.getName(), settings).getSynonymFilter();
+        Set<String> disallowedFiltersTested = new HashSet<String>();
+
+        try (CommonAnalysisPlugin plugin = new CommonAnalysisPlugin()) {
+            for (PreConfiguredTokenFilter tf : plugin.getPreConfiguredTokenFilters()) {
+                if (disallowedFilters.contains(tf.getName())) {
+                    IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
+                            "Expected exception for factory " + tf.getName(), () -> {
+                                tf.get(idxSettings, null, tf.getName(), settings).getSynonymFilter();
+                            });
+                    assertEquals(tf.getName(), "Token filter [" + tf.getName() + "] cannot be used to parse synonyms", e.getMessage());
+                    disallowedFiltersTested.add(tf.getName());
+                } else {
+                    tf.get(idxSettings, null, tf.getName(), settings).getSynonymFilter();
+                }
             }
         }
+        assertEquals("Set of dissallowed filters contains more filters than tested", disallowedFiltersTested, disallowedFilters);
     }
 
     public void testDisallowedTokenFilters() throws IOException {

From 2083266e9df4e12e44da9ce58e824e82bcf60c19 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 2 Jan 2020 13:13:00 -0500
Subject: [PATCH 356/686] [DOCS] Correct typos in Painless datetime docs
 (#50563)

Fixes several typos and grammar errors raised by @glenacota in #47512.

Co-authored-by: Guido Lena Cota <guido.lenacota@gmail.com>
---
 .../painless/painless-guide/painless-datetime.asciidoc | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/painless/painless-guide/painless-datetime.asciidoc b/docs/painless/painless-guide/painless-datetime.asciidoc
index 227119867b67c..24d5b56ab6c0c 100644
--- a/docs/painless/painless-guide/painless-datetime.asciidoc
+++ b/docs/painless/painless-guide/painless-datetime.asciidoc
@@ -45,7 +45,7 @@ datetime formatting is a switch from a complex datetime to a string datetime.
 A <<painless-api-reference-shared-DateTimeFormatter, DateTimeFormatter>> is a
 complex type (<<reference-types, object>>) that defines the allowed sequence
 of characters for a string datetime. Datetime parsing and formatting often
-requires a DateTimeFormatter. For more information about how to use a
+require a DateTimeFormatter. For more information about how to use a
 DateTimeFormatter see the
 {java11-javadoc}/java.base/java/time/format/DateTimeFormatter.html[Java documentation].
 
@@ -231,8 +231,8 @@ ZonedDateTime updatedZdt = zdt.withYear(1976);
 
 Use either two numeric datetimes or two complex datetimes to calculate the
 difference (elapsed time) between two different datetimes. Use
-<<subtraction-operator, subtraction>> to calculate the difference between
-between two numeric datetimes of the same time unit such as milliseconds. For
+<<subtraction-operator, subtraction>> to calculate the difference between two
+numeric datetimes of the same time unit such as milliseconds. For
 complex datetimes there is often a method or another complex type
 (<<reference-types, object>>) available to calculate the difference. Use
 <<painless-api-reference-shared-ChronoUnit, ChronoUnit>>
@@ -606,9 +606,9 @@ value for the current document.
 ==== Datetime Now
 
 Under most Painless contexts the current datetime, `now`, is not supported.
-There are two primary reasons for this. The first is scripts are often run once
+There are two primary reasons for this. The first is that scripts are often run once
 per document, so each time the script is run a different `now` is returned. The
-second is scripts are often run in a distributed fashion without a way to
+second is that scripts are often run in a distributed fashion without a way to
 appropriately synchronize `now`. Instead, pass in a user-defined parameter with
 either a string datetime or numeric datetime for `now`. A numeric datetime is
 preferred as there is no need to parse it for comparison.

From d47a53cea3167f37c96be65de3853b50fed509a4 Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Thu, 2 Jan 2020 19:19:52 +0100
Subject: [PATCH 357/686] Enhance TransportReplicationAction assertions
 (#49081)

Include failure into assertion error when replication action discovers
that it has been double triggered.
---
 .../support/replication/TransportReplicationAction.java       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java b/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
index 5888ec3f46bf6..81402ffead304 100644
--- a/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
+++ b/server/src/main/java/org/elasticsearch/action/support/replication/TransportReplicationAction.java
@@ -792,7 +792,7 @@ void finishAsFailed(Exception failure) {
                 logger.trace(() -> new ParameterizedMessage("operation failed. action [{}], request [{}]", actionName, request), failure);
                 listener.onFailure(failure);
             } else {
-                assert false : "finishAsFailed called but operation is already finished";
+                assert false : new AssertionError("finishAsFailed called but operation is already finished", failure);
             }
         }
 
@@ -804,7 +804,7 @@ void finishWithUnexpectedFailure(Exception failure) {
                 setPhase(task, "failed");
                 listener.onFailure(failure);
             } else {
-                assert false : "finishWithUnexpectedFailure called but operation is already finished";
+                assert false : new AssertionError("finishWithUnexpectedFailure called but operation is already finished", failure);
             }
         }
 

From 300b02a3ad37f7811f4339bd6bc143fec56ab61f Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Thu, 2 Jan 2020 10:59:54 -0800
Subject: [PATCH 358/686] [DOCS] Adds filter and calendar attributes (#50566)

---
 .../anomaly-detection/apis/close-job.asciidoc |  2 --
 .../apis/delete-calendar-event.asciidoc       |  3 ++-
 .../apis/delete-calendar-job.asciidoc         |  3 ++-
 .../apis/delete-calendar.asciidoc             |  3 ++-
 .../apis/delete-filter.asciidoc               |  3 ++-
 .../apis/eventresource.asciidoc               | 27 -------------------
 .../apis/filterresource.asciidoc              | 17 ------------
 .../apis/get-calendar-event.asciidoc          | 19 ++++++-------
 .../apis/get-calendar.asciidoc                |  6 +++--
 .../apis/get-filter.asciidoc                  |  6 +++--
 .../apis/post-calendar-event.asciidoc         | 23 ++++++++--------
 .../apis/put-calendar-job.asciidoc            |  3 ++-
 .../apis/put-calendar.asciidoc                |  5 ++--
 .../apis/put-filter.asciidoc                  |  3 ++-
 .../apis/update-filter.asciidoc               |  3 ++-
 docs/reference/ml/ml-shared.asciidoc          |  8 ++++++
 16 files changed, 55 insertions(+), 79 deletions(-)
 delete mode 100644 docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc
 delete mode 100644 docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc

diff --git a/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
index 0700d92ba7283..2520ae95faeb5 100644
--- a/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
@@ -88,8 +88,6 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 [[ml-close-job-example]]
 ==== {api-examples-title}
 
-The following example closes the `total-requests` job:
-
 [source,console]
 --------------------------------------------------
 POST _ml/anomaly_detectors/low_request_rate/_close
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
index d401d7dc052d4..e7bdbd1a02867 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
@@ -31,7 +31,8 @@ events and delete the calendar, see the
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-  (Required, string) Identifier for the calendar.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `<event_id>`::
   (Required, string) Identifier for the scheduled event. You can obtain this
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
index 12f7b88769dd8..adf0907118175 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
@@ -24,7 +24,8 @@ Deletes {anomaly-jobs} from a calendar.
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-(Required, string) Identifier for the calendar.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `<job_id>`::
 (Required, string)
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
index e9ac45e35600a..86e9d43591d21 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
@@ -30,7 +30,8 @@ calendar.
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-  (Required, string) Identifier for the calendar.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-delete-calendar-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
index 2894aaefb7a89..e691cfea4a159 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
@@ -31,7 +31,8 @@ update or delete the job before you can delete the filter.
 ==== {api-path-parms-title}
 
 `<filter_id>`::
-  (Required, string) Identifier for the filter.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
 
 [[ml-delete-filter-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc
deleted file mode 100644
index 2f3ea4175936a..0000000000000
--- a/docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc
+++ /dev/null
@@ -1,27 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-event-resource]]
-=== Scheduled event resources
-
-An events resource has the following properties:
-
-`calendar_id`::
-  (string) An identifier for the calendar that contains the scheduled
-  event. This property is optional in the <<ml-post-calendar-event>>. 
-
-`description`::
-  (string) A description of the scheduled event.
-
-`end_time`::
-  (date) The timestamp for the end of the scheduled event
-  in milliseconds since the epoch or ISO 8601 format.
-
-`event_id`::
-  (string) An automatically-generated identifier for the scheduled event.
-
-`start_time`::
- (date) The timestamp for the beginning of the scheduled event
- in milliseconds since the epoch or ISO 8601 format.
-
-For more information, see
-{ml-docs}/ml-calendars.html[Calendars and scheduled events].
diff --git a/docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc
deleted file mode 100644
index 39d63aec6a418..0000000000000
--- a/docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc
+++ /dev/null
@@ -1,17 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-filter-resource]]
-=== Filter resources
-
-A filter resource has the following properties:
-
-`filter_id`::
-  (string) A string that uniquely identifies the filter.
-
-`description`::
-  (string) A description of the filter.
-
-`items`::
-  (array of strings) An array of strings which is the filter item list.
-  
-For more information, see {ml-docs}/ml-rules.html[Machine learning custom rules].
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
index 22fdc718c5d8e..5c9f6a01acd1d 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
@@ -35,7 +35,8 @@ For more information, see
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-  (Required, string) Identifier for the calendar.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-get-calendar-event-request-body]]
 ==== {api-request-body-title}
@@ -60,22 +61,22 @@ The API returns an array of scheduled event resources, which have the
 following properties:
 
 `calendar_id`::
-    (string) An identifier for the calendar that contains the scheduled
-    event. 
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `description`::
-    (string) A description of the scheduled event.
+(string) A description of the scheduled event.
 
 `end_time`::
-    (date) The timestamp for the end of the scheduled event
-    in milliseconds since the epoch or ISO 8601 format.
+(date) The timestamp for the end of the scheduled event in milliseconds since
+the epoch or ISO 8601 format.
 
 `event_id`::
-    (string) An automatically-generated identifier for the scheduled event.
+(string) An automatically-generated identifier for the scheduled event.
 
 `start_time`::
-   (date) The timestamp for the beginning of the scheduled event
-   in milliseconds since the epoch or ISO 8601 format.
+(date) The timestamp for the beginning of the scheduled event in milliseconds
+since the epoch or ISO 8601 format.
 
 [[ml-get-calendar-event-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
index 9c56a7742de5b..caf720547bf8e 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
@@ -35,7 +35,8 @@ For more information, see
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-  (Required, string) Identifier for the calendar.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-get-calendar-request-body]]
 ==== {api-request-body-title}
@@ -53,7 +54,8 @@ The API returns an array of calendar resources, which have the following
 properties:
 
 `calendar_id`::
-(string) A numerical character string that uniquely identifies the calendar.
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `job_ids`::
 (array) An array of {anomaly-job} identifiers. For example:
diff --git a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
index 9da2f44c198c7..59b4fcccb89e5 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
@@ -32,7 +32,8 @@ You can get a single filter or all filters. For more information, see
 ==== {api-path-parms-title}
 
 `<filter_id>`::
-  (Optional, string) Identifier for the filter.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
 
 [[ml-get-filter-query-parms]]
 ==== {api-query-parms-title}
@@ -53,7 +54,8 @@ properties:
 (string) A description of the filter.
 
 `filter_id`::
-(string) A string that uniquely identifies the filter.
+(string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
   
 `items`::
 (array of strings) An array of strings which is the filter item list.
diff --git a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
index 76e7111fcd0cb..f981f24badca9 100644
--- a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
@@ -30,30 +30,31 @@ of which must have a start time, end time, and description.
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-		(Required, string) Identifier for the calendar.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-post-calendar-event-request-body]]
 ==== {api-request-body-title}
 
 `events`::
-  (Required, array) A list of one of more scheduled events. The event's start
-	and end times may be specified as integer milliseconds since the epoch or as a
-	string in ISO 8601 format. An event resource has the following properties:
+(Required, array) A list of one of more scheduled events. The event's start and
+end times may be specified as integer milliseconds since the epoch or as a
+string in ISO 8601 format. An event resource has the following properties:
 
 `events`.`calendar_id`:::
-	  (Optional, string) An identifier for the calendar that contains the scheduled
-	  event.
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `events`.`description`:::
-	  (Optional, string) A description of the scheduled event.
+(Optional, string) A description of the scheduled event.
 
 `events`.`end_time`:::
-	  (Required, date) The timestamp for the end of the scheduled event
-	  in milliseconds since the epoch or ISO 8601 format.
+(Required, date) The timestamp for the end of the scheduled event in
+milliseconds since the epoch or ISO 8601 format.
 
 `events`.`start_time`:::
-	 (Required, date) The timestamp for the beginning of the scheduled event
-	 in milliseconds since the epoch or ISO 8601 format.
+(Required, date) The timestamp for the beginning of the scheduled event in
+milliseconds since the epoch or ISO 8601 format.
 
 [[ml-post-calendar-event-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
index 767a3d3d5bae5..650ed1a8878fb 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
@@ -24,7 +24,8 @@ Adds an {anomaly-job} to a calendar.
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-  (Required, string) Identifier for the calendar.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `<job_id>`::
 (Required, string) 
diff --git a/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
index f543c06bd8cb0..5b7ada0f9b172 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
@@ -30,13 +30,14 @@ For more information, see
 ==== {api-path-parms-title}
 
 `<calendar_id>`::
-  (Required, string) Identifier for the calendar.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-put-calendar-request-body]]
 ==== {api-request-body-title}
 
 `description`::
-  (Optional, string) A description of the calendar.
+(Optional, string) A description of the calendar.
 
 [[ml-put-calendar-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
index 3168389690a75..47f3af0909193 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
@@ -31,7 +31,8 @@ the `custom_rules` property of detector configuration objects.
 ==== {api-path-parms-title}
 
 `<filter_id>`::
-  (Required, string) Identifier for the filter.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
 
 [[ml-put-filter-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
index bf55d6900b1ec..66aa9ad8dad02 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
@@ -24,7 +24,8 @@ Updates the description of a filter, adds items, or removes items.
 ==== {api-path-parms-title}
 
 `<filter_id>`::
-		(Required, string) Identifier for the filter.
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
 
 [[ml-update-filter-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 6918a3a502796..7b0f8b64718a7 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -140,6 +140,10 @@ analyzing the splits with respect to their own history. It is used for finding
 unusual values in the context of the split.
 end::by-field-name[]
 
+tag::calendar-id[]
+A string that uniquely identifies a calendar.
+end::calendar-id[]
+
 tag::categorization-analyzer[]
 If `categorization_field_name` is specified, you can also define the analyzer
 that is used to interpret the categorization field. This property cannot be used
@@ -570,6 +574,10 @@ optional. If it is not specified, no token filters are applied prior to
 categorization.
 end::filter[]
 
+tag::filter-id[]
+A string that uniquely identifies a filter.
+end::filter-id[]
+
 tag::frequency[]
 The interval at which scheduled queries are made while the {dfeed} runs in real
 time. The default value is either the bucket span for short bucket spans, or,

From 5d5fe811b8c16ff6152f63cbc7eae13ed6737f4e Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Thu, 2 Jan 2020 16:39:18 -0500
Subject: [PATCH 359/686] Mark some constants in decay functions final (#50569)

This marks a couple of constants in the `DecayFunctionBuilder` as final.
They are written in CONSTANT_CASE and used as constants but not final
which is a little confusing and might lead to sneaky bugs.
---
 .../index/query/functionscore/DecayFunctionBuilder.java       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/query/functionscore/DecayFunctionBuilder.java b/server/src/main/java/org/elasticsearch/index/query/functionscore/DecayFunctionBuilder.java
index 7bca4ac920683..e31e646200a69 100644
--- a/server/src/main/java/org/elasticsearch/index/query/functionscore/DecayFunctionBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/functionscore/DecayFunctionBuilder.java
@@ -65,8 +65,8 @@ public abstract class DecayFunctionBuilder<DFB extends DecayFunctionBuilder<DFB>
     protected static final String DECAY = "decay";
     protected static final String OFFSET = "offset";
 
-    public static double DEFAULT_DECAY = 0.5;
-    public static MultiValueMode DEFAULT_MULTI_VALUE_MODE = MultiValueMode.MIN;
+    public static final double DEFAULT_DECAY = 0.5;
+    public static final MultiValueMode DEFAULT_MULTI_VALUE_MODE = MultiValueMode.MIN;
 
     private final String fieldName;
     //parsing of origin, scale, offset and decay depends on the field type, delayed to the data node that has the mapping for it

From 76355c7098827b08f576b82e5722d0cb349a4cda Mon Sep 17 00:00:00 2001
From: bellengao <gbl_long@163.com>
Date: Fri, 3 Jan 2020 07:10:21 +0800
Subject: [PATCH 360/686] Don't dump a stacktrace for invalid patterns when
 executing elasticsearch-croneval (#49744)

---
 docs/reference/commands/croneval.asciidoc     |  6 +-
 .../trigger/schedule/tool/CronEvalTool.java   | 90 +++++++++++--------
 2 files changed, 60 insertions(+), 36 deletions(-)

diff --git a/docs/reference/commands/croneval.asciidoc b/docs/reference/commands/croneval.asciidoc
index be9b16770dc33..fa7b9aed33bb3 100644
--- a/docs/reference/commands/croneval.asciidoc
+++ b/docs/reference/commands/croneval.asciidoc
@@ -30,7 +30,11 @@ This command is provided in the `$ES_HOME/bin` directory.
 `-c, --count` <Integer>::
   The number of future times this expression will be triggered. The default
   value is `10`.
-  
+
+`-d, --detail`::
+  Shows detail for invalid cron expression. It will print the stacktrace if the
+  expression is not valid.
+
 `-h, --help`::
   Returns all of the command parameters.
 
diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
index 565bae15ea998..9464abcc4ba59 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
@@ -37,13 +37,16 @@ public static void main(String[] args) throws Exception {
 
     private final OptionSpec<Integer> countOption;
     private final OptionSpec<String> arguments;
+    private final OptionSpec<Void> detailOption;
 
     CronEvalTool() {
         super("Validates and evaluates a cron expression");
-        this.countOption = parser.acceptsAll(Arrays.asList("c", "count"),
-            "The number of future times this expression will be triggered")
-            .withRequiredArg().ofType(Integer.class).defaultsTo(10);
+        this.countOption = parser.acceptsAll(Arrays.asList("c", "count"), "The number of future times this expression will be triggered")
+            .withRequiredArg()
+            .ofType(Integer.class)
+            .defaultsTo(10);
         this.arguments = parser.nonOptions("expression");
+        this.detailOption = parser.acceptsAll(Arrays.asList("d", "detail"), "Show detail for invalid cron expression");
 
         parser.accepts("E", "Unused. Only for compatibility with other CLI tools.").withRequiredArg();
     }
@@ -55,46 +58,63 @@ protected void execute(Terminal terminal, OptionSet options) throws Exception {
         if (args.size() != 1) {
             throw new UserException(ExitCodes.USAGE, "expecting a single argument that is the cron expression to evaluate");
         }
-        execute(terminal, args.get(0), count);
+        boolean printDetail = options.has(detailOption);
+        execute(terminal, args.get(0), count, printDetail);
     }
 
-    private void execute(Terminal terminal, String expression, int count) throws Exception {
-        Cron.validate(expression);
-        terminal.println("Valid!");
+    private void execute(Terminal terminal, String expression, int count, boolean printDetail) throws Exception {
+        try {
+            Cron.validate(expression);
+            terminal.println("Valid!");
 
-        final ZonedDateTime date = ZonedDateTime.now(ZoneOffset.UTC);
-        final boolean isLocalTimeUTC = UTC_FORMATTER.zone().equals(LOCAL_FORMATTER.zone());
-        if (isLocalTimeUTC) {
-            terminal.println("Now is [" + UTC_FORMATTER.format(date) + "] in UTC");
-        } else {
-            terminal.println("Now is [" + UTC_FORMATTER.format(date) + "] in UTC, local time is [" + LOCAL_FORMATTER.format(date) + "]");
+            final ZonedDateTime date = ZonedDateTime.now(ZoneOffset.UTC);
+            final boolean isLocalTimeUTC = UTC_FORMATTER.zone().equals(LOCAL_FORMATTER.zone());
+            if (isLocalTimeUTC) {
+                terminal.println("Now is [" + UTC_FORMATTER.format(date) + "] in UTC");
+            } else {
+                terminal.println(
+                    "Now is [" + UTC_FORMATTER.format(date) + "] in UTC, local time is [" + LOCAL_FORMATTER.format(date) + "]"
+                );
 
-        }
-        terminal.println("Here are the next " + count + " times this cron expression will trigger:");
-
-        Cron cron = new Cron(expression);
-        long time = date.toInstant().toEpochMilli();
-
-        for (int i = 0; i < count; i++) {
-            long prevTime = time;
-            time = cron.getNextValidTimeAfter(time);
-            if (time < 0) {
-                if (i == 0) {
-                    throw new UserException(ExitCodes.OK, "Could not compute future times since ["
-                            + UTC_FORMATTER.format(Instant.ofEpochMilli(prevTime)) + "] " + "(perhaps the cron expression only points to " +
-                        "times in the" +
-                        " " +
-                        "past?)");
-                }
-                break;
             }
+            terminal.println("Here are the next " + count + " times this cron expression will trigger:");
+
+            Cron cron = new Cron(expression);
+            long time = date.toInstant().toEpochMilli();
+
+            for (int i = 0; i < count; i++) {
+                long prevTime = time;
+                time = cron.getNextValidTimeAfter(time);
+                if (time < 0) {
+                    if (i == 0) {
+                        throw new UserException(
+                            ExitCodes.OK,
+                            "Could not compute future times since ["
+                                + UTC_FORMATTER.format(Instant.ofEpochMilli(prevTime))
+                                + "] "
+                                + "(perhaps the cron expression only points to "
+                                + "times in the"
+                                + " "
+                                + "past?)"
+                        );
+                    }
+                    break;
+                }
 
-            if (isLocalTimeUTC) {
-                terminal.println((i + 1) + ".\t" + UTC_FORMATTER.format(Instant.ofEpochMilli(time)));
+                if (isLocalTimeUTC) {
+                    terminal.println((i + 1) + ".\t" + UTC_FORMATTER.format(Instant.ofEpochMilli(time)));
+                } else {
+                    terminal.println((i + 1) + ".\t" + UTC_FORMATTER.format(Instant.ofEpochMilli(time)));
+                    terminal.println("\t" + LOCAL_FORMATTER.format(Instant.ofEpochMilli(time)));
+                }
+            }
+        } catch (Exception e) {
+            if (printDetail) {
+                throw e;
             } else {
-                terminal.println((i + 1) + ".\t" + UTC_FORMATTER.format(Instant.ofEpochMilli(time)));
-                terminal.println("\t" + LOCAL_FORMATTER.format(Instant.ofEpochMilli(time)));
+                throw new UserException(ExitCodes.OK, e.getMessage() + (e.getCause() == null ? "" : ": " + e.getCause().getMessage()));
             }
+
         }
     }
 }

From 96c8899b05320cc2a5c2fabb2199d7f50d5bb18f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Fri, 3 Jan 2020 10:41:38 +0100
Subject: [PATCH 361/686] [DOCS] Specifies the possible data types of
 classification dependent_variable (#50582)

---
 docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc b/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc
index 035601fe71409..0004416c05cd7 100644
--- a/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc
@@ -145,7 +145,8 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
 include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
 +
 --
-The data type of the field must be numeric or boolean.
+The data type of the field must be numeric (`integer`, `short`, `long`, `byte`), 
+categorical (`ip`, `keyword`, `text`), or boolean.
 --
   
 `num_top_classes`::

From f38555b4825f7216e88e87a67946839136b968a7 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Fri, 3 Jan 2020 09:55:53 +0000
Subject: [PATCH 362/686] Add fuzzy intervals source (#49762)

This intervals source will return terms that are similar to an input term, up to
an edit distance defined by fuzziness, similar to FuzzyQuery.

Closes #49595
---
 .../query-dsl/intervals-query.asciidoc        |  39 ++++-
 .../test/search/230_interval_query.yml        |  21 +++
 .../org/apache/lucene/queries/XIntervals.java |   4 +
 .../index/query/IntervalsSourceProvider.java  | 149 ++++++++++++++++++
 .../elasticsearch/search/SearchModule.java    |   2 +
 .../query/IntervalQueryBuilderTests.java      |  58 +++++++
 6 files changed, 272 insertions(+), 1 deletion(-)

diff --git a/docs/reference/query-dsl/intervals-query.asciidoc b/docs/reference/query-dsl/intervals-query.asciidoc
index 9f9280c80a484..7fc9d60b26397 100644
--- a/docs/reference/query-dsl/intervals-query.asciidoc
+++ b/docs/reference/query-dsl/intervals-query.asciidoc
@@ -73,6 +73,7 @@ Valid rules include:
 * <<intervals-match,`match`>>
 * <<intervals-prefix,`prefix`>>
 * <<intervals-wildcard,`wildcard`>>
+* <<intervals-fuzzy,`fuzzy`>>
 * <<intervals-all_of,`all_of`>>
 * <<intervals-any_of,`any_of`>>
 --
@@ -97,7 +98,7 @@ set to `0`, the terms must appear next to each other.
 --
 
 `ordered`::
-(Optional, boolean) 
+(Optional, boolean)
 If `true`, matching terms must appear in their specified order. Defaults to
 `false`.
 
@@ -177,6 +178,42 @@ The `pattern` is normalized using the search analyzer from this field, unless
 `analyzer` is specified separately.
 --
 
+[[intervals-fuzzy]]
+==== `fuzzy` rule parameters
+
+The `fuzzy` rule matches terms that are similar to the provided term, within an
+edit distance defined by <<fuzziness>>.  If the fuzzy expansion matches more than
+128 terms, {es} returns an error.
+
+`term`::
+(Required, string) The term to match
+
+`prefix_length`::
+(Optional, string) Number of beginning characters left unchanged when creating
+expansions. Defaults to `0`.
+
+`transpositions`::
+(Optional, boolean) Indicates whether edits include transpositions of two
+adjacent characters (ab → ba). Defaults to `true`.
+
+`fuzziness`::
+(Optional, string) Maximum edit distance allowed for matching. See <<fuzziness>>
+for valid values and more information.  Defaults to `auto`.
+
+`analyzer`::
+(Optional, string) <<analysis, analyzer>> used to normalize the `term`.
+Defaults to the top-level `<field>` 's analyzer.
+
+`use_field`::
++
+--
+(Optional, string) If specified, match intervals from this field rather than the
+top-level `<field>`.
+
+The `term` is normalized using the search analyzer from this field, unless
+`analyzer` is specified separately.
+--
+
 [[intervals-all_of]]
 ==== `all_of` rule parameters
 
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search/230_interval_query.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search/230_interval_query.yml
index 82aa0883008a8..654ef2a2e173f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search/230_interval_query.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search/230_interval_query.yml
@@ -424,3 +424,24 @@ setup:
                         pattern: out?ide
   - match: { hits.total.value: 3 }
 
+---
+"Test fuzzy match":
+  - skip:
+      version: " - 8.0.0"
+      reason: "TODO: change to 7.6 in backport"
+  - do:
+      search:
+        index: test
+        body:
+          query:
+            intervals:
+              text:
+                all_of:
+                  intervals:
+                    - fuzzy:
+                        query: cald
+                    - prefix:
+                        prefix: out
+  - match: { hits.total.value: 3 }
+
+
diff --git a/server/src/main/java/org/apache/lucene/queries/XIntervals.java b/server/src/main/java/org/apache/lucene/queries/XIntervals.java
index b389a29c21115..1d77094bd1427 100644
--- a/server/src/main/java/org/apache/lucene/queries/XIntervals.java
+++ b/server/src/main/java/org/apache/lucene/queries/XIntervals.java
@@ -67,6 +67,10 @@ public static IntervalsSource prefix(BytesRef prefix) {
         return new MultiTermIntervalsSource(ca, 128, prefix.utf8ToString());
     }
 
+    public static IntervalsSource multiterm(CompiledAutomaton ca, String label) {
+        return new MultiTermIntervalsSource(ca, 128, label);
+    }
+
     static class MultiTermIntervalsSource extends IntervalsSource {
 
         private final CompiledAutomaton automaton;
diff --git a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
index 4918d7c7c7f3f..dbd8f339ca66f 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
@@ -20,12 +20,15 @@
 package org.elasticsearch.index.query;
 
 import org.apache.lucene.index.IndexOptions;
+import org.apache.lucene.index.Term;
 import org.apache.lucene.queries.XIntervals;
 import org.apache.lucene.queries.intervals.FilteredIntervalsSource;
 import org.apache.lucene.queries.intervals.IntervalIterator;
 import org.apache.lucene.queries.intervals.Intervals;
 import org.apache.lucene.queries.intervals.IntervalsSource;
+import org.apache.lucene.search.FuzzyQuery;
 import org.apache.lucene.util.BytesRef;
+import org.apache.lucene.util.automaton.CompiledAutomaton;
 import org.elasticsearch.Version;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.ParsingException;
@@ -33,7 +36,9 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.unit.Fuzziness;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.ToXContentFragment;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -85,6 +90,8 @@ public static IntervalsSourceProvider fromXContent(XContentParser parser) throws
                 return Prefix.fromXContent(parser);
             case "wildcard":
                 return Wildcard.fromXContent(parser);
+            case "fuzzy":
+                return Fuzzy.fromXContent(parser);
         }
         throw new ParsingException(parser.getTokenLocation(),
             "Unknown interval type [" + parser.currentName() + "], expecting one of [match, any_of, all_of, prefix, wildcard]");
@@ -691,6 +698,148 @@ String getUseField() {
         }
     }
 
+    public static class Fuzzy extends IntervalsSourceProvider {
+
+        public static final String NAME = "fuzzy";
+
+        private final String term;
+        private final int prefixLength;
+        private final boolean transpositions;
+        private final Fuzziness fuzziness;
+        private final String analyzer;
+        private final String useField;
+
+        public Fuzzy(String term, int prefixLength, boolean transpositions, Fuzziness fuzziness, String analyzer, String useField) {
+            this.term = term;
+            this.prefixLength = prefixLength;
+            this.transpositions = transpositions;
+            this.fuzziness = fuzziness;
+            this.analyzer = analyzer;
+            this.useField = useField;
+        }
+
+        public Fuzzy(StreamInput in) throws IOException {
+            this.term = in.readString();
+            this.prefixLength = in.readVInt();
+            this.transpositions = in.readBoolean();
+            this.fuzziness = new Fuzziness(in);
+            this.analyzer = in.readOptionalString();
+            this.useField = in.readOptionalString();
+        }
+
+        @Override
+        public IntervalsSource getSource(QueryShardContext context, MappedFieldType fieldType) {
+            NamedAnalyzer analyzer = fieldType.searchAnalyzer();
+            if (this.analyzer != null) {
+                analyzer = context.getMapperService().getIndexAnalyzers().get(this.analyzer);
+            }
+            IntervalsSource source;
+            if (useField != null) {
+                fieldType = context.fieldMapper(useField);
+                assert fieldType != null;
+                checkPositions(fieldType);
+                if (this.analyzer == null) {
+                    analyzer = fieldType.searchAnalyzer();
+                }
+            }
+            checkPositions(fieldType);
+            BytesRef normalizedTerm = analyzer.normalize(fieldType.name(), term);
+            FuzzyQuery fq = new FuzzyQuery(new Term(fieldType.name(), normalizedTerm),
+                fuzziness.asDistance(term), prefixLength, 128, transpositions);
+            CompiledAutomaton ca = new CompiledAutomaton(fq.toAutomaton());
+            source = XIntervals.multiterm(ca, term);
+            if (useField != null) {
+                source = Intervals.fixField(useField, source);
+            }
+            return source;
+        }
+
+        private void checkPositions(MappedFieldType type) {
+            if (type.indexOptions().compareTo(IndexOptions.DOCS_AND_FREQS_AND_POSITIONS) < 0) {
+                throw new IllegalArgumentException("Cannot create intervals over field [" + type.name() + "] with no positions indexed");
+            }
+        }
+
+        @Override
+        public void extractFields(Set<String> fields) {
+            if (useField != null) {
+                fields.add(useField);
+            }
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Fuzzy fuzzy = (Fuzzy) o;
+            return prefixLength == fuzzy.prefixLength &&
+                transpositions == fuzzy.transpositions &&
+                Objects.equals(term, fuzzy.term) &&
+                Objects.equals(fuzziness, fuzzy.fuzziness) &&
+                Objects.equals(analyzer, fuzzy.analyzer) &&
+                Objects.equals(useField, fuzzy.useField);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(term, prefixLength, transpositions, fuzziness, analyzer, useField);
+        }
+
+        @Override
+        public String getWriteableName() {
+            return NAME;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(term);
+            out.writeVInt(prefixLength);
+            out.writeBoolean(transpositions);
+            fuzziness.writeTo(out);
+            out.writeOptionalString(analyzer);
+            out.writeOptionalString(useField);
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject(NAME);
+            builder.field("term", term);
+            builder.field("prefix_length", prefixLength);
+            builder.field("transpositions", transpositions);
+            fuzziness.toXContent(builder, params);
+            if (analyzer != null) {
+                builder.field("analyzer", analyzer);
+            }
+            if (useField != null) {
+                builder.field("use_field", useField);
+            }
+            builder.endObject();
+            return builder;
+        }
+
+        private static final ConstructingObjectParser<Fuzzy, Void> PARSER = new ConstructingObjectParser<>(NAME, args -> {
+            String term = (String) args[0];
+            int prefixLength = (args[1] == null) ? FuzzyQueryBuilder.DEFAULT_PREFIX_LENGTH : (int) args[1];
+            boolean transpositions = (args[2] == null) ? FuzzyQueryBuilder.DEFAULT_TRANSPOSITIONS : (boolean) args[2];
+            Fuzziness fuzziness = (args[3] == null) ? FuzzyQueryBuilder.DEFAULT_FUZZINESS : (Fuzziness) args[3];
+            String analyzer = (String) args[4];
+            String useField = (String) args[5];
+            return new Fuzzy(term, prefixLength, transpositions, fuzziness, analyzer, useField);
+        });
+        static {
+            PARSER.declareString(constructorArg(), new ParseField("term"));
+            PARSER.declareInt(optionalConstructorArg(), new ParseField("prefix_length"));
+            PARSER.declareBoolean(optionalConstructorArg(), new ParseField("transpositions"));
+            PARSER.declareField(optionalConstructorArg(), (p, c) -> Fuzziness.parse(p), Fuzziness.FIELD, ObjectParser.ValueType.VALUE);
+            PARSER.declareString(optionalConstructorArg(), new ParseField("analyzer"));
+            PARSER.declareString(optionalConstructorArg(), new ParseField("use_field"));
+        }
+
+        public static Fuzzy fromXContent(XContentParser parser) throws IOException {
+            return PARSER.parse(parser, null);
+        }
+    }
+
     static class ScriptFilterSource extends FilteredIntervalsSource {
 
         final IntervalFilterScript script;
diff --git a/server/src/main/java/org/elasticsearch/search/SearchModule.java b/server/src/main/java/org/elasticsearch/search/SearchModule.java
index cdfd28760869c..ca64b749a5809 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchModule.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchModule.java
@@ -804,6 +804,8 @@ private void registerIntervalsSourceProviders() {
             IntervalsSourceProvider.Prefix.NAME, IntervalsSourceProvider.Prefix::new));
         namedWriteables.add(new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
             IntervalsSourceProvider.Wildcard.NAME, IntervalsSourceProvider.Wildcard::new));
+        namedWriteables.add(new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
+            IntervalsSourceProvider.Fuzzy.NAME, IntervalsSourceProvider.Fuzzy::new));
     }
 
     private void registerQuery(QuerySpec<?> spec) {
diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index 763d10ddf30e8..ed7caeb0473de 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -19,17 +19,22 @@
 
 package org.elasticsearch.index.query;
 
+import org.apache.lucene.index.Term;
 import org.apache.lucene.queries.XIntervals;
 import org.apache.lucene.queries.intervals.IntervalQuery;
 import org.apache.lucene.queries.intervals.Intervals;
+import org.apache.lucene.queries.intervals.IntervalsSource;
 import org.apache.lucene.search.BoostQuery;
+import org.apache.lucene.search.FuzzyQuery;
 import org.apache.lucene.search.MatchNoDocsQuery;
 import org.apache.lucene.search.Query;
 import org.apache.lucene.util.BytesRef;
+import org.apache.lucene.util.automaton.CompiledAutomaton;
 import org.elasticsearch.common.ParsingException;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.compress.CompressedXContent;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.Fuzziness;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.index.mapper.MapperService;
@@ -529,4 +534,57 @@ public void testWildcard() throws IOException {
         assertEquals(expected, builder.toQuery(createShardContext()));
     }
 
+    private static IntervalsSource buildFuzzySource(String term, String label, int prefixLength, boolean transpositions, int editDistance) {
+        FuzzyQuery fq = new FuzzyQuery(new Term("field", term), editDistance, prefixLength, 128, transpositions);
+        return XIntervals.multiterm(new CompiledAutomaton(fq.toAutomaton()), label);
+    }
+
+    public void testFuzzy() throws IOException {
+
+        String json = "{ \"intervals\" : { \"" + STRING_FIELD_NAME + "\": { " +
+            "\"fuzzy\" : { \"term\" : \"Term\" } } } }";
+        IntervalQueryBuilder builder = (IntervalQueryBuilder) parseQuery(json);
+
+        Query expected = new IntervalQuery(STRING_FIELD_NAME,
+            buildFuzzySource("term", "Term", FuzzyQueryBuilder.DEFAULT_PREFIX_LENGTH, true, Fuzziness.AUTO.asDistance("term")));
+        assertEquals(expected, builder.toQuery(createShardContext()));
+
+        String json_with_prefix = "{ \"intervals\" : { \"" + STRING_FIELD_NAME + "\": { " +
+            "\"fuzzy\" : { \"term\" : \"Term\", \"prefix_length\" : 2 } } } }";
+        builder = (IntervalQueryBuilder) parseQuery(json_with_prefix);
+        expected = new IntervalQuery(STRING_FIELD_NAME,
+            buildFuzzySource("term", "Term", 2, true, Fuzziness.AUTO.asDistance("term")));
+        assertEquals(expected, builder.toQuery(createShardContext()));
+
+        String json_with_fuzziness = "{ \"intervals\" : { \"" + STRING_FIELD_NAME + "\": { " +
+            "\"fuzzy\" : { \"term\" : \"Term\", \"prefix_length\" : 2, \"fuzziness\" : \"1\" } } } }";
+        builder = (IntervalQueryBuilder) parseQuery(json_with_fuzziness);
+        expected = new IntervalQuery(STRING_FIELD_NAME,
+            buildFuzzySource("term", "Term", 2, true, Fuzziness.ONE.asDistance("term")));
+        assertEquals(expected, builder.toQuery(createShardContext()));
+
+        String json_no_transpositions = "{ \"intervals\" : { \"" + STRING_FIELD_NAME + "\": { " +
+            "\"fuzzy\" : { \"term\" : \"Term\", \"prefix_length\" : 2, \"transpositions\" : false } } } }";
+        builder = (IntervalQueryBuilder) parseQuery(json_no_transpositions);
+        expected = new IntervalQuery(STRING_FIELD_NAME,
+            buildFuzzySource("term", "Term", 2, false, Fuzziness.AUTO.asDistance("term")));
+        assertEquals(expected, builder.toQuery(createShardContext()));
+
+        String json_with_analyzer = "{ \"intervals\" : { \"" + STRING_FIELD_NAME + "\": { " +
+            "\"fuzzy\" : { \"term\" : \"Term\", \"prefix_length\" : 2, \"analyzer\" : \"keyword\" } } } }";
+        builder = (IntervalQueryBuilder) parseQuery(json_with_analyzer);
+        expected = new IntervalQuery(STRING_FIELD_NAME,
+            buildFuzzySource("Term", "Term", 2, true, Fuzziness.AUTO.asDistance("term")));
+        assertEquals(expected, builder.toQuery(createShardContext()));
+
+        String json_with_fixfield = "{ \"intervals\" : { \"" + STRING_FIELD_NAME + "\": { " +
+            "\"fuzzy\" : { \"term\" : \"Term\", \"prefix_length\" : 2, \"fuzziness\" : \"1\", " +
+            "\"use_field\" : \"" + MASKED_FIELD + "\" } } } }";
+        builder = (IntervalQueryBuilder) parseQuery(json_with_fixfield);
+        expected = new IntervalQuery(STRING_FIELD_NAME, Intervals.fixField(MASKED_FIELD,
+            buildFuzzySource("term", "Term", 2, true, Fuzziness.ONE.asDistance("term"))));
+        assertEquals(expected, builder.toQuery(createShardContext()));
+
+    }
+
 }

From e15470a47d3881928b0ab1ffd75e37add3f4b654 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 3 Jan 2020 12:01:41 +0200
Subject: [PATCH 363/686] [ML] Implement force deleting a data frame analytics
 job (#50553)

Adds a `force` parameter to the delete data frame analytics
request. When `force` is `true`, the action force-stops the
jobs and then proceeds to the deletion. This can be used in
order to delete a non-stopped job with a single request.

Closes #48124
---
 .../client/MLRequestConverters.java           | 15 ++++++--
 .../ml/DeleteDataFrameAnalyticsRequest.java   | 19 ++++++++--
 .../client/MLRequestConvertersTests.java      | 13 +++++--
 .../client/MachineLearningIT.java             |  7 ++--
 .../MlClientDocumentationIT.java              | 10 ++++--
 .../ml/delete-data-frame-analytics.asciidoc   | 11 ++++++
 .../apis/delete-dfanalytics.asciidoc          |  9 ++++-
 .../DeleteDataFrameAnalyticsAction.java       | 35 +++++++++++++------
 .../core/ml/action/KillProcessAction.java     |  9 -----
 ...ansportDeleteDataFrameAnalyticsAction.java | 30 ++++++++++++++--
 .../RestDeleteDataFrameAnalyticsAction.java   |  1 +
 .../api/ml.delete_data_frame_analytics.json   |  7 ++++
 12 files changed, 130 insertions(+), 36 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/MLRequestConverters.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/MLRequestConverters.java
index e0bba0c78a120..4967d8091c961 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/MLRequestConverters.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/MLRequestConverters.java
@@ -29,8 +29,6 @@
 import org.elasticsearch.client.RequestConverters.EndpointBuilder;
 import org.elasticsearch.client.core.PageParams;
 import org.elasticsearch.client.ml.CloseJobRequest;
-import org.elasticsearch.client.ml.DeleteTrainedModelRequest;
-import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsRequest;
 import org.elasticsearch.client.ml.DeleteCalendarEventRequest;
 import org.elasticsearch.client.ml.DeleteCalendarJobRequest;
 import org.elasticsearch.client.ml.DeleteCalendarRequest;
@@ -41,7 +39,9 @@
 import org.elasticsearch.client.ml.DeleteForecastRequest;
 import org.elasticsearch.client.ml.DeleteJobRequest;
 import org.elasticsearch.client.ml.DeleteModelSnapshotRequest;
+import org.elasticsearch.client.ml.DeleteTrainedModelRequest;
 import org.elasticsearch.client.ml.EvaluateDataFrameRequest;
+import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsRequest;
 import org.elasticsearch.client.ml.FindFileStructureRequest;
 import org.elasticsearch.client.ml.FlushJobRequest;
 import org.elasticsearch.client.ml.ForecastJobRequest;
@@ -692,7 +692,16 @@ static Request deleteDataFrameAnalytics(DeleteDataFrameAnalyticsRequest deleteRe
             .addPathPartAsIs("_ml", "data_frame", "analytics")
             .addPathPart(deleteRequest.getId())
             .build();
-        return new Request(HttpDelete.METHOD_NAME, endpoint);
+
+        Request request = new Request(HttpDelete.METHOD_NAME, endpoint);
+
+        RequestConverters.Params params = new RequestConverters.Params();
+        if (deleteRequest.getForce() != null) {
+            params.putParam("force", Boolean.toString(deleteRequest.getForce()));
+        }
+        request.addParameters(params.asMap());
+
+        return request;
     }
 
     static Request evaluateDataFrame(EvaluateDataFrameRequest evaluateRequest) throws IOException {
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/DeleteDataFrameAnalyticsRequest.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/DeleteDataFrameAnalyticsRequest.java
index f03466632304d..b7300430b55b0 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/DeleteDataFrameAnalyticsRequest.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/DeleteDataFrameAnalyticsRequest.java
@@ -31,6 +31,7 @@
 public class DeleteDataFrameAnalyticsRequest implements Validatable {
 
     private final String id;
+    private Boolean force;
 
     public DeleteDataFrameAnalyticsRequest(String id) {
         this.id = id;
@@ -40,6 +41,20 @@ public String getId() {
         return id;
     }
 
+    public Boolean getForce() {
+        return force;
+    }
+
+    /**
+     * Used to forcefully delete an job that is not stopped.
+     * This method is quicker than stopping and deleting the job.
+     *
+     * @param force When {@code true} forcefully delete a non stopped job. Defaults to {@code false}
+     */
+    public void setForce(Boolean force) {
+        this.force = force;
+    }
+
     @Override
     public Optional<ValidationException> validate() {
         if (id == null) {
@@ -54,11 +69,11 @@ public boolean equals(Object o) {
         if (o == null || getClass() != o.getClass()) return false;
 
         DeleteDataFrameAnalyticsRequest other = (DeleteDataFrameAnalyticsRequest) o;
-        return Objects.equals(id, other.id);
+        return Objects.equals(id, other.id) && Objects.equals(force, other.force);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(id);
+        return Objects.hash(id, force);
     }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MLRequestConvertersTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MLRequestConvertersTests.java
index cf22ba80c1624..475dda254448f 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MLRequestConvertersTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MLRequestConvertersTests.java
@@ -25,8 +25,6 @@
 import org.apache.http.client.methods.HttpPut;
 import org.elasticsearch.client.core.PageParams;
 import org.elasticsearch.client.ml.CloseJobRequest;
-import org.elasticsearch.client.ml.DeleteTrainedModelRequest;
-import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsRequest;
 import org.elasticsearch.client.ml.DeleteCalendarEventRequest;
 import org.elasticsearch.client.ml.DeleteCalendarJobRequest;
 import org.elasticsearch.client.ml.DeleteCalendarRequest;
@@ -37,8 +35,10 @@
 import org.elasticsearch.client.ml.DeleteForecastRequest;
 import org.elasticsearch.client.ml.DeleteJobRequest;
 import org.elasticsearch.client.ml.DeleteModelSnapshotRequest;
+import org.elasticsearch.client.ml.DeleteTrainedModelRequest;
 import org.elasticsearch.client.ml.EvaluateDataFrameRequest;
 import org.elasticsearch.client.ml.EvaluateDataFrameRequestTests;
+import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsRequest;
 import org.elasticsearch.client.ml.FindFileStructureRequest;
 import org.elasticsearch.client.ml.FindFileStructureRequestTests;
 import org.elasticsearch.client.ml.FlushJobRequest;
@@ -778,6 +778,15 @@ public void testDeleteDataFrameAnalytics() {
         assertEquals(HttpDelete.METHOD_NAME, request.getMethod());
         assertEquals("/_ml/data_frame/analytics/" + deleteRequest.getId(), request.getEndpoint());
         assertNull(request.getEntity());
+        assertThat(request.getParameters().isEmpty(), is(true));
+
+        deleteRequest = new DeleteDataFrameAnalyticsRequest(randomAlphaOfLength(10));
+        deleteRequest.setForce(true);
+        request = MLRequestConverters.deleteDataFrameAnalytics(deleteRequest);
+        assertEquals(HttpDelete.METHOD_NAME, request.getMethod());
+        assertEquals("/_ml/data_frame/analytics/" + deleteRequest.getId(), request.getEndpoint());
+        assertNull(request.getEntity());
+        assertEquals(Boolean.toString(true), request.getParameters().get("force"));
     }
 
     public void testEvaluateDataFrame() throws IOException {
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index 443c337d089fa..f3b63801987db 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -1616,8 +1616,11 @@ public void testDeleteDataFrameAnalyticsConfig() throws Exception {
             machineLearningClient::getDataFrameAnalytics, machineLearningClient::getDataFrameAnalyticsAsync);
         assertThat(getDataFrameAnalyticsResponse.getAnalytics(), hasSize(1));
 
-        AcknowledgedResponse deleteDataFrameAnalyticsResponse = execute(
-            new DeleteDataFrameAnalyticsRequest(configId),
+        DeleteDataFrameAnalyticsRequest deleteRequest = new DeleteDataFrameAnalyticsRequest(configId);
+        if (randomBoolean()) {
+            deleteRequest.setForce(randomBoolean());
+        }
+        AcknowledgedResponse deleteDataFrameAnalyticsResponse = execute(deleteRequest,
             machineLearningClient::deleteDataFrameAnalytics, machineLearningClient::deleteDataFrameAnalyticsAsync);
         assertTrue(deleteDataFrameAnalyticsResponse.isAcknowledged());
 
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
index 12fea5f5c5658..37ae59e9b992a 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
@@ -36,9 +36,6 @@
 import org.elasticsearch.client.indices.CreateIndexRequest;
 import org.elasticsearch.client.ml.CloseJobRequest;
 import org.elasticsearch.client.ml.CloseJobResponse;
-import org.elasticsearch.client.ml.DeleteTrainedModelRequest;
-import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsRequest;
-import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsResponse;
 import org.elasticsearch.client.ml.DeleteCalendarEventRequest;
 import org.elasticsearch.client.ml.DeleteCalendarJobRequest;
 import org.elasticsearch.client.ml.DeleteCalendarRequest;
@@ -51,8 +48,11 @@
 import org.elasticsearch.client.ml.DeleteJobRequest;
 import org.elasticsearch.client.ml.DeleteJobResponse;
 import org.elasticsearch.client.ml.DeleteModelSnapshotRequest;
+import org.elasticsearch.client.ml.DeleteTrainedModelRequest;
 import org.elasticsearch.client.ml.EvaluateDataFrameRequest;
 import org.elasticsearch.client.ml.EvaluateDataFrameResponse;
+import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsRequest;
+import org.elasticsearch.client.ml.ExplainDataFrameAnalyticsResponse;
 import org.elasticsearch.client.ml.FindFileStructureRequest;
 import org.elasticsearch.client.ml.FindFileStructureResponse;
 import org.elasticsearch.client.ml.FlushJobRequest;
@@ -3065,6 +3065,10 @@ public void testDeleteDataFrameAnalytics() throws Exception {
             DeleteDataFrameAnalyticsRequest request = new DeleteDataFrameAnalyticsRequest("my-analytics-config"); // <1>
             // end::delete-data-frame-analytics-request
 
+            //tag::delete-data-frame-analytics-request-force
+            request.setForce(false); // <1>
+            //end::delete-data-frame-analytics-request-force
+
             // tag::delete-data-frame-analytics-execute
             AcknowledgedResponse response = client.machineLearning().deleteDataFrameAnalytics(request, RequestOptions.DEFAULT);
             // end::delete-data-frame-analytics-execute
diff --git a/docs/java-rest/high-level/ml/delete-data-frame-analytics.asciidoc b/docs/java-rest/high-level/ml/delete-data-frame-analytics.asciidoc
index cb321d95c3864..d57b37ff21741 100644
--- a/docs/java-rest/high-level/ml/delete-data-frame-analytics.asciidoc
+++ b/docs/java-rest/high-level/ml/delete-data-frame-analytics.asciidoc
@@ -21,6 +21,17 @@ include-tagged::{doc-tests-file}[{api}-request]
 ---------------------------------------------------
 <1> Constructing a new request referencing an existing {dfanalytics-job}.
 
+==== Optional arguments
+
+The following arguments are optional:
+
+["source","java",subs="attributes,callouts,macros"]
+---------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-request-force]
+---------------------------------------------------
+<1> Use to forcefully delete a job that is not stopped. This method is quicker than stopping
+and deleting the job. Defaults to `false`.
+
 include::../execution.asciidoc[]
 
 [id="{upid}-{api}-response"]
diff --git a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
index 8d80e3bba8783..a7adad79185d2 100644
--- a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
@@ -21,7 +21,7 @@ experimental[]
 [[ml-delete-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `machine_learning_admin` built-in role to use this API. For more 
+* You must have `machine_learning_admin` built-in role to use this API. For more
 information, see <<security-privileges>> and <<built-in-roles>>.
 
 
@@ -32,6 +32,13 @@ information, see <<security-privileges>> and <<built-in-roles>>.
 (Required, string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
 
+[[ml-delete-dfanalytics-query-params]]
+==== {api-query-parms-title}
+
+`force`::
+  (Optional, boolean) If `true`, it deletes a job that is not stopped; this method is
+  quicker than stopping and deleting the job.
+
 
 [[ml-delete-dfanalytics-example]]
 ==== {api-examples-title}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/DeleteDataFrameAnalyticsAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/DeleteDataFrameAnalyticsAction.java
index c9c16025bb69c..40d70d979be9e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/DeleteDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/DeleteDataFrameAnalyticsAction.java
@@ -5,16 +5,16 @@
  */
 package org.elasticsearch.xpack.core.ml.action;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.action.ActionType;
 import org.elasticsearch.action.support.master.AcknowledgedRequest;
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
 import org.elasticsearch.action.support.master.MasterNodeOperationRequestBuilder;
 import org.elasticsearch.client.ElasticsearchClient;
+import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.xcontent.ToXContentFragment;
-import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
@@ -30,13 +30,21 @@ private DeleteDataFrameAnalyticsAction() {
         super(NAME, AcknowledgedResponse::new);
     }
 
-    public static class Request extends AcknowledgedRequest<Request> implements ToXContentFragment {
+    public static class Request extends AcknowledgedRequest<Request> {
+
+        public static final ParseField FORCE = new ParseField("force");
 
         private String id;
+        private boolean force;
 
         public Request(StreamInput in) throws IOException {
             super(in);
             id = in.readString();
+            if (in.getVersion().onOrAfter(Version.CURRENT)) {
+                force = in.readBoolean();
+            } else {
+                force = false;
+            }
         }
 
         public Request() {}
@@ -49,15 +57,17 @@ public String getId() {
             return id;
         }
 
-        @Override
-        public ActionRequestValidationException validate() {
-            return null;
+        public boolean isForce() {
+            return force;
+        }
+
+        public void setForce(boolean force) {
+            this.force = force;
         }
 
         @Override
-        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            builder.field(DataFrameAnalyticsConfig.ID.getPreferredName(), id);
-            return builder;
+        public ActionRequestValidationException validate() {
+            return null;
         }
 
         @Override
@@ -65,18 +75,21 @@ public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
             DeleteDataFrameAnalyticsAction.Request request = (DeleteDataFrameAnalyticsAction.Request) o;
-            return Objects.equals(id, request.id);
+            return Objects.equals(id, request.id) && force == request.force;
         }
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             out.writeString(id);
+            if (out.getVersion().onOrAfter(Version.CURRENT)) {
+                out.writeBoolean(force);
+            }
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(id);
+            return Objects.hash(id, force);
         }
     }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/KillProcessAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/KillProcessAction.java
index dcd8c524415e7..ba7d6c1f744ea 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/KillProcessAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/KillProcessAction.java
@@ -6,9 +6,7 @@
 package org.elasticsearch.xpack.core.ml.action;
 
 import org.elasticsearch.action.ActionType;
-import org.elasticsearch.action.ActionRequestBuilder;
 import org.elasticsearch.action.support.tasks.BaseTasksResponse;
-import org.elasticsearch.client.ElasticsearchClient;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -25,13 +23,6 @@ private KillProcessAction() {
         super(NAME, KillProcessAction.Response::new);
     }
 
-    static class RequestBuilder extends ActionRequestBuilder<Request, Response> {
-
-        RequestBuilder(ElasticsearchClient client, KillProcessAction action) {
-            super(client, action, new Request());
-        }
-    }
-
     public static class Request extends JobTaskRequest<Request> {
 
         public Request(String jobId) {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
index d42cf9684cca9..47f2a216f2a81 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteDataFrameAnalyticsAction.java
@@ -38,6 +38,7 @@
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.ml.MlTasks;
 import org.elasticsearch.xpack.core.ml.action.DeleteDataFrameAnalyticsAction;
+import org.elasticsearch.xpack.core.ml.action.StopDataFrameAnalyticsAction;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsState;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
@@ -100,6 +101,32 @@ protected AcknowledgedResponse read(StreamInput in) throws IOException {
     protected void masterOperation(Task task, DeleteDataFrameAnalyticsAction.Request request, ClusterState state,
                                    ActionListener<AcknowledgedResponse> listener) {
         String id = request.getId();
+        TaskId taskId = new TaskId(clusterService.localNode().getId(), task.getId());
+        ParentTaskAssigningClient parentTaskClient = new ParentTaskAssigningClient(client, taskId);
+
+        if (request.isForce()) {
+            forceDelete(parentTaskClient, id, listener);
+        } else {
+            normalDelete(parentTaskClient, state, id, listener);
+        }
+    }
+
+    private void forceDelete(ParentTaskAssigningClient parentTaskClient, String id,
+                             ActionListener<AcknowledgedResponse> listener) {
+        logger.debug("[{}] Force deleting data frame analytics job", id);
+
+        ActionListener<StopDataFrameAnalyticsAction.Response> stopListener = ActionListener.wrap(
+            stopResponse -> normalDelete(parentTaskClient, clusterService.state(), id, listener),
+            listener::onFailure
+        );
+
+        StopDataFrameAnalyticsAction.Request request = new StopDataFrameAnalyticsAction.Request(id);
+        request.setForce(true);
+        executeAsyncWithOrigin(parentTaskClient, ML_ORIGIN, StopDataFrameAnalyticsAction.INSTANCE, request, stopListener);
+    }
+
+    private void normalDelete(ParentTaskAssigningClient parentTaskClient, ClusterState state, String id,
+                              ActionListener<AcknowledgedResponse> listener) {
         PersistentTasksCustomMetaData tasks = state.getMetaData().custom(PersistentTasksCustomMetaData.TYPE);
         DataFrameAnalyticsState taskState = MlTasks.getDataFrameAnalyticsState(id, tasks);
         if (taskState != DataFrameAnalyticsState.STOPPED) {
@@ -108,9 +135,6 @@ protected void masterOperation(Task task, DeleteDataFrameAnalyticsAction.Request
             return;
         }
 
-        TaskId taskId = new TaskId(clusterService.localNode().getId(), task.getId());
-        ParentTaskAssigningClient parentTaskClient = new ParentTaskAssigningClient(client, taskId);
-
         // We clean up the memory tracker on delete because there is no stop; the task stops by itself
         memoryTracker.removeDataFrameAnalyticsJob(id);
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/rest/dataframe/RestDeleteDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/rest/dataframe/RestDeleteDataFrameAnalyticsAction.java
index 26edf340b2b16..9e78a7cd9f214 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/rest/dataframe/RestDeleteDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/rest/dataframe/RestDeleteDataFrameAnalyticsAction.java
@@ -32,6 +32,7 @@ public String getName() {
     protected RestChannelConsumer prepareRequest(RestRequest restRequest, NodeClient client) throws IOException {
         String id = restRequest.param(DataFrameAnalyticsConfig.ID.getPreferredName());
         DeleteDataFrameAnalyticsAction.Request request = new DeleteDataFrameAnalyticsAction.Request(id);
+        request.setForce(restRequest.paramAsBoolean(DeleteDataFrameAnalyticsAction.Request.FORCE.getPreferredName(), request.isForce()));
         return channel -> client.execute(DeleteDataFrameAnalyticsAction.INSTANCE, request, new RestToXContentListener<>(channel));
     }
 }
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_data_frame_analytics.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_data_frame_analytics.json
index bb2101765c75c..98f6a3eedaba5 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_data_frame_analytics.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_data_frame_analytics.json
@@ -19,6 +19,13 @@
           }
         }
       ]
+    },
+    "params":{
+      "force":{
+        "type":"boolean",
+        "description":"True if the job should be forcefully deleted",
+        "default":false
+      }
     }
   }
 }

From ba905d7ebe147627517b1fd7e5e0d40addac0ea0 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 29 Nov 2019 14:38:06 +0200
Subject: [PATCH 364/686] [ML] Mute data frame analytics BWC tests

Until #50553 is backported to 7.x
---
 .../test/mixed_cluster/90_ml_data_frame_analytics_crud.yml   | 5 +++++
 .../test/old_cluster/90_ml_data_frame_analytics_crud.yml     | 3 +++
 .../upgraded_cluster/90_ml_data_frame_analytics_crud.yml     | 5 +++++
 3 files changed, 13 insertions(+)

diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
index 7780691b2bbbd..a6fbc5cc4e2c0 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,3 +1,8 @@
+setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/50553"
+
 ---
 "Get old outlier_detection job":
 
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
index fe160bba15f23..51f21afa6761d 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,4 +1,7 @@
 setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/50553"
 
   - do:
       index:
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
index 14438883f0da1..b20c63f69d8e2 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,3 +1,8 @@
+setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/50553"
+
 ---
 "Get old cluster outlier_detection job":
 

From 3db02d16fee9434e8fa14b7fce940543063598ec Mon Sep 17 00:00:00 2001
From: Andrei Dan <andrei.dan@elastic.co>
Date: Fri, 3 Jan 2020 12:24:03 +0200
Subject: [PATCH 365/686] ILM retryable async action steps (#50522)

This adds support for retrying AsyncActionSteps by triggering the async
step after ILM was moved back on the failed step (the async step we'll
be attempting to run after the cluster state reflects ILM being moved
back on the failed step).

This also marks the RolloverStep as retryable and adds an integration
test where the RolloverStep is failing to execute as the rolled over
index already exists to test that the async action RolloverStep is
retried until the rolled over index is deleted.
---
 .../xpack/core/ilm/RolloverStep.java          |   5 +
 .../ilm/TimeSeriesLifecycleActionsIT.java     | 199 ++++++++++++------
 .../xpack/ilm/IndexLifecycleRunner.java       |  14 ++
 3 files changed, 155 insertions(+), 63 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/RolloverStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/RolloverStep.java
index 90b9d15f21b85..542ac156a9871 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/RolloverStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/RolloverStep.java
@@ -30,6 +30,11 @@ public RolloverStep(StepKey key, StepKey nextStepKey, Client client) {
         super(key, nextStepKey, client);
     }
 
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
+
     @Override
     public void performAction(IndexMetaData indexMetaData, ClusterState currentClusterState,
                               ClusterStateObserver observer, Listener listener) {
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index e872de5b08f4e..7cb8d92789169 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -948,69 +948,142 @@ public void testILMRolloverRetriesOnReadOnlyBlock() throws Exception {
         assertBusy(() -> assertThat(getStepKeyForIndex(firstIndex), equalTo(TerminalPolicyStep.KEY)));
     }
 
-   public void testILMRolloverOnManuallyRolledIndex() throws Exception {
-       String originalIndex = index + "-000001";
-       String secondIndex = index + "-000002";
-       String thirdIndex = index + "-000003";
-
-       // Set up a policy with rollover
-       createNewSingletonPolicy("hot", new RolloverAction(null, null, 2L));
-       Request createIndexTemplate = new Request("PUT", "_template/rolling_indexes");
-       createIndexTemplate.setJsonEntity("{" +
-           "\"index_patterns\": [\""+ index + "-*\"], \n" +
-           "  \"settings\": {\n" +
-           "    \"number_of_shards\": 1,\n" +
-           "    \"number_of_replicas\": 0,\n" +
-           "    \"index.lifecycle.name\": \"" + policy+ "\", \n" +
-           "    \"index.lifecycle.rollover_alias\": \"alias\"\n" +
-           "  }\n" +
-           "}");
-       client().performRequest(createIndexTemplate);
-
-       createIndexWithSettings(
-           originalIndex,
-           Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-               .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0),
-           true
-       );
-
-       // Index a document
-       index(client(), originalIndex, "1", "foo", "bar");
-       Request refreshOriginalIndex = new Request("POST", "/" + originalIndex + "/_refresh");
-       client().performRequest(refreshOriginalIndex);
-
-       // Manual rollover
-       Request rolloverRequest = new Request("POST", "/alias/_rollover");
-       rolloverRequest.setJsonEntity("{\n" +
-           "  \"conditions\": {\n" +
-           "    \"max_docs\": \"1\"\n" +
-           "  }\n" +
-           "}"
-       );
-       client().performRequest(rolloverRequest);
-       assertBusy(() -> assertTrue(indexExists(secondIndex)));
-
-       // Index another document into the original index so the ILM rollover policy condition is met
-       index(client(), originalIndex, "2", "foo", "bar");
-       client().performRequest(refreshOriginalIndex);
-
-       // Wait for the rollover policy to execute
-       assertBusy(() -> assertThat(getStepKeyForIndex(originalIndex), equalTo(TerminalPolicyStep.KEY)));
-
-       // ILM should manage the second index after attempting (and skipping) rolling the original index
-       assertBusy(() -> assertTrue((boolean) explainIndex(secondIndex).getOrDefault("managed", true)));
-
-       // index some documents to trigger an ILM rollover
-       index(client(), "alias", "1", "foo", "bar");
-       index(client(), "alias", "2", "foo", "bar");
-       index(client(), "alias", "3", "foo", "bar");
-       Request refreshSecondIndex = new Request("POST", "/" + secondIndex + "/_refresh");
-       client().performRequest(refreshSecondIndex).getStatusLine();
-
-       // ILM should rollover the second index even though it skipped the first one
-       assertBusy(() -> assertThat(getStepKeyForIndex(secondIndex), equalTo(TerminalPolicyStep.KEY)));
-       assertBusy(() -> assertTrue(indexExists(thirdIndex)));
-   }
+    public void testILMRolloverOnManuallyRolledIndex() throws Exception {
+        String originalIndex = index + "-000001";
+        String secondIndex = index + "-000002";
+        String thirdIndex = index + "-000003";
+
+        // Set up a policy with rollover
+        createNewSingletonPolicy("hot", new RolloverAction(null, null, 2L));
+        Request createIndexTemplate = new Request("PUT", "_template/rolling_indexes");
+        createIndexTemplate.setJsonEntity("{" +
+            "\"index_patterns\": [\"" + index + "-*\"], \n" +
+            "  \"settings\": {\n" +
+            "    \"number_of_shards\": 1,\n" +
+            "    \"number_of_replicas\": 0,\n" +
+            "    \"index.lifecycle.name\": \"" + policy + "\", \n" +
+            "    \"index.lifecycle.rollover_alias\": \"alias\"\n" +
+            "  }\n" +
+            "}");
+        client().performRequest(createIndexTemplate);
+
+        createIndexWithSettings(
+            originalIndex,
+            Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0),
+            true
+        );
+
+        // Index a document
+        index(client(), originalIndex, "1", "foo", "bar");
+        Request refreshOriginalIndex = new Request("POST", "/" + originalIndex + "/_refresh");
+        client().performRequest(refreshOriginalIndex);
+
+        // Manual rollover
+        Request rolloverRequest = new Request("POST", "/alias/_rollover");
+        rolloverRequest.setJsonEntity("{\n" +
+            "  \"conditions\": {\n" +
+            "    \"max_docs\": \"1\"\n" +
+            "  }\n" +
+            "}"
+        );
+        client().performRequest(rolloverRequest);
+        assertBusy(() -> assertTrue(indexExists(secondIndex)));
+
+        // Index another document into the original index so the ILM rollover policy condition is met
+        index(client(), originalIndex, "2", "foo", "bar");
+        client().performRequest(refreshOriginalIndex);
+
+        // Wait for the rollover policy to execute
+        assertBusy(() -> assertThat(getStepKeyForIndex(originalIndex), equalTo(TerminalPolicyStep.KEY)));
+
+        // ILM should manage the second index after attempting (and skipping) rolling the original index
+        assertBusy(() -> assertTrue((boolean) explainIndex(secondIndex).getOrDefault("managed", true)));
+
+        // index some documents to trigger an ILM rollover
+        index(client(), "alias", "1", "foo", "bar");
+        index(client(), "alias", "2", "foo", "bar");
+        index(client(), "alias", "3", "foo", "bar");
+        Request refreshSecondIndex = new Request("POST", "/" + secondIndex + "/_refresh");
+        client().performRequest(refreshSecondIndex).getStatusLine();
+
+        // ILM should rollover the second index even though it skipped the first one
+        assertBusy(() -> assertThat(getStepKeyForIndex(secondIndex), equalTo(TerminalPolicyStep.KEY)));
+        assertBusy(() -> assertTrue(indexExists(thirdIndex)));
+    }
+
+    public void testRolloverStepRetriesUntilRolledOverIndexIsDeleted() throws Exception {
+        String index = this.index + "-000001";
+        String rolledIndex = this.index + "-000002";
+
+        createNewSingletonPolicy("hot", new RolloverAction(null, TimeValue.timeValueSeconds(1), null));
+
+        // create the rolled index so the rollover of the first index fails
+        createIndexWithSettings(
+            rolledIndex,
+            Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
+                .put(RolloverAction.LIFECYCLE_ROLLOVER_ALIAS, "alias"),
+            false
+        );
+
+        createIndexWithSettings(
+            index,
+            Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
+                .put(LifecycleSettings.LIFECYCLE_NAME, policy)
+                .put(RolloverAction.LIFECYCLE_ROLLOVER_ALIAS, "alias"),
+            true
+        );
+
+        assertBusy(() -> assertThat((Integer) explainIndex(index).get(FAILED_STEP_RETRY_COUNT_FIELD), greaterThanOrEqualTo(1)), 30,
+            TimeUnit.SECONDS);
+
+        Request moveToStepRequest = new Request("POST", "_ilm/move/" + index);
+        moveToStepRequest.setJsonEntity("{\n" +
+            "  \"current_step\": {\n" +
+            "    \"phase\": \"hot\",\n" +
+            "    \"action\": \"rollover\",\n" +
+            "    \"name\": \"check-rollover-ready\"\n" +
+            "  },\n" +
+            "  \"next_step\": {\n" +
+            "    \"phase\": \"hot\",\n" +
+            "    \"action\": \"rollover\",\n" +
+            "    \"name\": \"attempt-rollover\"\n" +
+            "  }\n" +
+            "}");
+
+        // Using {@link #waitUntil} here as ILM moves back and forth between the {@link WaitForRolloverReadyStep} step and
+        // {@link org.elasticsearch.xpack.core.ilm.ErrorStep} in order to retry the failing step. As {@link #assertBusy}
+        // increases the wait time between calls exponentially, we might miss the window where the policy is on
+        // {@link WaitForRolloverReadyStep} and the move to `attempt-rollover` request will not be successful.
+        waitUntil(() -> {
+            try {
+                return client().performRequest(moveToStepRequest).getStatusLine().getStatusCode() == 200;
+            } catch (IOException e) {
+                return false;
+            }
+        }, 30, TimeUnit.SECONDS);
+
+        // Similar to above, using {@link #waitUntil} as we want to make sure the `attempt-rollover` step started failing and is being
+        // retried (which means ILM moves back and forth between the `attempt-rollover` step and the `error` step)
+        waitUntil(() -> {
+            try {
+                Map<String, Object> explainIndexResponse = explainIndex(index);
+                String step = (String) explainIndexResponse.get("step");
+                Integer retryCount = (Integer) explainIndexResponse.get(FAILED_STEP_RETRY_COUNT_FIELD);
+                return step != null && step.equals("attempt-rollover") && retryCount != null && retryCount >= 1;
+            } catch (IOException e) {
+                return false;
+            }
+        }, 30, TimeUnit.SECONDS);
+
+        deleteIndex(rolledIndex);
+
+        // the rollover step should eventually succeed
+        assertBusy(() -> assertThat(indexExists(rolledIndex), is(true)));
+        assertBusy(() -> assertThat(getStepKeyForIndex(index), equalTo(TerminalPolicyStep.KEY)));
+    }
 
     public void testHistoryIsWrittenWithSuccess() throws Exception {
         String index = "index";
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
index 736d5decc1123..8e892a351d655 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleRunner.java
@@ -203,6 +203,20 @@ public void onFailure(String source, Exception e) {
                     logger.error(new ParameterizedMessage("retry execution of step [{}] for index [{}] failed",
                         failedStep.getKey().getName(), index), e);
                 }
+
+                @Override
+                public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
+                    if (oldState.equals(newState) == false) {
+                        IndexMetaData newIndexMeta = newState.metaData().index(index);
+                        Step indexMetaCurrentStep = getCurrentStep(stepRegistry, policy, newIndexMeta);
+                        StepKey stepKey = indexMetaCurrentStep.getKey();
+                        if (stepKey != null && stepKey != TerminalPolicyStep.KEY && newIndexMeta != null) {
+                            logger.trace("policy [{}] for index [{}] was moved back on the failed step for as part of an automatic " +
+                                "retry. Attempting to execute the failed step [{}] if it's an async action", policy, index, stepKey);
+                            maybeRunAsyncAction(newState, newIndexMeta, policy, stepKey);
+                        }
+                    }
+                }
             });
         } else {
             logger.debug("policy [{}] for index [{}] on an error step after a terminal error, skipping execution", policy, index);

From 588d6ebee8b1ec254db742c37b05fdc001df2b2f Mon Sep 17 00:00:00 2001
From: kkewwei <kewei03@meituan.com>
Date: Fri, 3 Jan 2020 19:23:20 +0800
Subject: [PATCH 366/686] Log index name when updating index settings (#49969)

Today we log changes to index settings like this:

    updating [index.setting.blah] from [A] to [B]

The identity of the index whose settings were updated is conspicuously absent
from this message. This commit addresses this by adding the index name to these
messages.

Fixes #49818.
---
 .../settings/AbstractScopedSettings.java      |  6 ++-
 .../common/settings/IndexScopedSettings.java  |  3 +-
 .../common/settings/SettingTests.java         | 41 +++++++++++++++++++
 3 files changed, 47 insertions(+), 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/settings/AbstractScopedSettings.java b/server/src/main/java/org/elasticsearch/common/settings/AbstractScopedSettings.java
index 81b3b92844d6b..99c651ef7df80 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/AbstractScopedSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/AbstractScopedSettings.java
@@ -55,7 +55,7 @@ public abstract class AbstractScopedSettings {
     private static final Pattern GROUP_KEY_PATTERN = Pattern.compile("^(?:[-\\w]+[.])+$");
     private static final Pattern AFFIX_KEY_PATTERN = Pattern.compile("^(?:[-\\w]+[.])+[*](?:[.][-\\w]+)+$");
 
-    protected final Logger logger = LogManager.getLogger(this.getClass());
+    private final Logger logger;
 
     private final Settings settings;
     private final List<SettingUpdater<?>> settingUpdaters = new CopyOnWriteArrayList<>();
@@ -70,6 +70,7 @@ protected AbstractScopedSettings(
             final Set<Setting<?>> settingsSet,
             final Set<SettingUpgrader<?>> settingUpgraders,
             final Setting.Property scope) {
+        this.logger = LogManager.getLogger(this.getClass());
         this.settings = settings;
         this.lastSettingsApplied = Settings.EMPTY;
 
@@ -110,7 +111,8 @@ protected void validateSettingKey(Setting<?> setting) {
         }
     }
 
-    protected AbstractScopedSettings(Settings nodeSettings, Settings scopeSettings, AbstractScopedSettings other) {
+    protected AbstractScopedSettings(Settings nodeSettings, Settings scopeSettings, AbstractScopedSettings other, Logger logger) {
+        this.logger = logger;
         this.settings = nodeSettings;
         this.lastSettingsApplied = scopeSettings;
         this.scope = other.scope;
diff --git a/server/src/main/java/org/elasticsearch/common/settings/IndexScopedSettings.java b/server/src/main/java/org/elasticsearch/common/settings/IndexScopedSettings.java
index f83012f2db32b..e278f01002595 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/IndexScopedSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/IndexScopedSettings.java
@@ -24,6 +24,7 @@
 import org.elasticsearch.cluster.routing.allocation.decider.EnableAllocationDecider;
 import org.elasticsearch.cluster.routing.allocation.decider.MaxRetryAllocationDecider;
 import org.elasticsearch.cluster.routing.allocation.decider.ShardsLimitAllocationDecider;
+import org.elasticsearch.common.logging.Loggers;
 import org.elasticsearch.common.settings.Setting.Property;
 import org.elasticsearch.index.IndexModule;
 import org.elasticsearch.index.IndexSettings;
@@ -186,7 +187,7 @@ public IndexScopedSettings(Settings settings, Set<Setting<?>> settingsSet) {
     }
 
     private IndexScopedSettings(Settings settings, IndexScopedSettings other, IndexMetaData metaData) {
-        super(settings, metaData.getSettings(), other);
+        super(settings, metaData.getSettings(), other, Loggers.getLogger(IndexScopedSettings.class, metaData.getIndex()));
     }
 
     public IndexScopedSettings copy(Settings settings, IndexMetaData metaData) {
diff --git a/server/src/test/java/org/elasticsearch/common/settings/SettingTests.java b/server/src/test/java/org/elasticsearch/common/settings/SettingTests.java
index 4ad401454b914..889bfadb10ec7 100644
--- a/server/src/test/java/org/elasticsearch/common/settings/SettingTests.java
+++ b/server/src/test/java/org/elasticsearch/common/settings/SettingTests.java
@@ -18,14 +18,23 @@
  */
 package org.elasticsearch.common.settings;
 
+import org.apache.logging.log4j.Level;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.core.LogEvent;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.logging.Loggers;
 import org.elasticsearch.common.settings.AbstractScopedSettings.SettingUpdater;
 import org.elasticsearch.common.settings.Setting.Property;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.monitor.jvm.JvmInfo;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.MockLogAppender;
+import org.elasticsearch.test.junit.annotations.TestLogging;
 
 import java.util.Arrays;
 import java.util.Collections;
@@ -40,6 +49,7 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
+import static org.elasticsearch.index.IndexSettingsTests.newIndexMeta;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasSize;
@@ -1092,4 +1102,35 @@ public void testNonSecureSettingInKeystore() {
         assertThat(e.getMessage(), containsString("must be stored inside elasticsearch.yml"));
     }
 
+    @TestLogging(value="org.elasticsearch.common.settings.IndexScopedSettings:INFO",
+        reason="to ensure we log INFO-level messages from IndexScopedSettings")
+    public void testLogSettingUpdate() throws Exception {
+        final IndexMetaData metaData = newIndexMeta("index1",
+            Settings.builder().put(IndexSettings.INDEX_REFRESH_INTERVAL_SETTING.getKey(), "20s").build());
+        final IndexSettings settings = new IndexSettings(metaData, Settings.EMPTY);
+
+        final MockLogAppender mockLogAppender = new MockLogAppender();
+        mockLogAppender.addExpectation(new MockLogAppender.SeenEventExpectation(
+            "message",
+            "org.elasticsearch.common.settings.IndexScopedSettings",
+            Level.INFO,
+            "updating [index.refresh_interval] from [20s] to [10s]") {
+            @Override
+            public boolean innerMatch(LogEvent event) {
+                return event.getMarker().getName().equals(" [index1]");
+            }
+        });
+        mockLogAppender.start();
+        final Logger logger = LogManager.getLogger(IndexScopedSettings.class);
+        try {
+            Loggers.addAppender(logger, mockLogAppender);
+            settings.updateIndexMetaData(newIndexMeta("index1",
+                Settings.builder().put(IndexSettings.INDEX_REFRESH_INTERVAL_SETTING.getKey(), "10s").build()));
+
+            mockLogAppender.assertAllExpectationsMatched();
+        } finally {
+            Loggers.removeAppender(logger, mockLogAppender);
+            mockLogAppender.stop();
+        }
+    }
 }

From 62b023538e558bea33dd5bb6dd6a85b269f6205e Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Fri, 3 Jan 2020 11:24:12 +0000
Subject: [PATCH 367/686] Adjust version skips for intervals rest tests
 (#50588)

The rest tests for prefix, wildcard and fuzzy intervals can all be run
against 7.x clusters.  Also corrects the invocation of the fuzzy interval.
---
 .../test/search/230_interval_query.yml             | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search/230_interval_query.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search/230_interval_query.yml
index 654ef2a2e173f..ea29e5b208b23 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search/230_interval_query.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search/230_interval_query.yml
@@ -387,8 +387,8 @@ setup:
 ---
 "Test prefix":
   - skip:
-      version: " - 8.0.0"
-      reason: "TODO: change to 7.3 in backport"
+      version: " - 7.2.99"
+      reason: "Implemented in 7.3"
   - do:
       search:
         index: test
@@ -407,8 +407,8 @@ setup:
 ---
 "Test wildcard":
   - skip:
-      version: " - 8.0.0"
-      reason: "TODO: change to 7.3 in backport"
+      version: " - 7.2.99"
+      reason: "Implemented in 7.3"
   - do:
       search:
         index: test
@@ -427,8 +427,8 @@ setup:
 ---
 "Test fuzzy match":
   - skip:
-      version: " - 8.0.0"
-      reason: "TODO: change to 7.6 in backport"
+      version: " - 7.5.99"
+      reason: "Implemented in 7.6"
   - do:
       search:
         index: test
@@ -439,7 +439,7 @@ setup:
                 all_of:
                   intervals:
                     - fuzzy:
-                        query: cald
+                        term: cald
                     - prefix:
                         prefix: out
   - match: { hits.total.value: 3 }

From a1b9bbb0e90d17b41914243caef4e870331f4acc Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 3 Jan 2020 13:25:28 +0100
Subject: [PATCH 368/686] Remove some Dead Code from Discovery Plugins (#50592)

None of this stuff is used.
---
 .../classic/AzureServiceDisableException.java |  3 --
 .../classic/AzureServiceRemoteException.java  |  3 --
 .../discovery/ec2/AwsEc2ServiceImpl.java      |  4 +-
 .../discovery/ec2/AwsEc2ServiceImplTests.java |  4 +-
 .../elasticsearch/cloud/gce/GceModule.java    | 47 -------------------
 ...ingClusterStatePublishResponseHandler.java |  2 +-
 .../discovery/DiscoveryModule.java            |  3 +-
 .../MasterNotDiscoveredException.java         |  5 --
 .../gateway/LocalAllocateDangledIndices.java  |  2 +-
 .../java/org/elasticsearch/node/Node.java     |  2 +-
 ...usterStatePublishResponseHandlerTests.java |  2 +-
 .../discovery/DiscoveryModuleTests.java       |  9 +---
 .../ml/action/TransportCloseJobAction.java    |  2 +-
 ...TransportStopDataFrameAnalyticsAction.java |  2 +-
 .../action/TransportStopDatafeedAction.java   |  2 +-
 .../TransportDeleteRollupJobAction.java       |  2 +-
 .../action/TransportGetRollupJobAction.java   |  2 +-
 .../action/TransportStopTransformAction.java  |  2 +-
 18 files changed, 17 insertions(+), 81 deletions(-)
 delete mode 100644 plugins/discovery-gce/src/main/java/org/elasticsearch/cloud/gce/GceModule.java

diff --git a/plugins/discovery-azure-classic/src/main/java/org/elasticsearch/cloud/azure/classic/AzureServiceDisableException.java b/plugins/discovery-azure-classic/src/main/java/org/elasticsearch/cloud/azure/classic/AzureServiceDisableException.java
index 66488f90c31bf..0f2e255116645 100644
--- a/plugins/discovery-azure-classic/src/main/java/org/elasticsearch/cloud/azure/classic/AzureServiceDisableException.java
+++ b/plugins/discovery-azure-classic/src/main/java/org/elasticsearch/cloud/azure/classic/AzureServiceDisableException.java
@@ -20,9 +20,6 @@
 package org.elasticsearch.cloud.azure.classic;
 
 public class AzureServiceDisableException extends IllegalStateException {
-    public AzureServiceDisableException(String msg) {
-        super(msg);
-    }
 
     public AzureServiceDisableException(String msg, Throwable cause) {
         super(msg, cause);
diff --git a/plugins/discovery-azure-classic/src/main/java/org/elasticsearch/cloud/azure/classic/AzureServiceRemoteException.java b/plugins/discovery-azure-classic/src/main/java/org/elasticsearch/cloud/azure/classic/AzureServiceRemoteException.java
index c961c03ba719c..e61b39a03bb29 100644
--- a/plugins/discovery-azure-classic/src/main/java/org/elasticsearch/cloud/azure/classic/AzureServiceRemoteException.java
+++ b/plugins/discovery-azure-classic/src/main/java/org/elasticsearch/cloud/azure/classic/AzureServiceRemoteException.java
@@ -20,9 +20,6 @@
 package org.elasticsearch.cloud.azure.classic;
 
 public class AzureServiceRemoteException extends IllegalStateException {
-    public AzureServiceRemoteException(String msg) {
-        super(msg);
-    }
 
     public AzureServiceRemoteException(String msg, Throwable cause) {
         super(msg, cause);
diff --git a/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImpl.java b/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImpl.java
index 546634c88cf45..92b5f740dc127 100644
--- a/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImpl.java
+++ b/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImpl.java
@@ -44,7 +44,7 @@ class AwsEc2ServiceImpl implements AwsEc2Service {
 
     private AmazonEC2 buildClient(Ec2ClientSettings clientSettings) {
         final AWSCredentialsProvider credentials = buildCredentials(logger, clientSettings);
-        final ClientConfiguration configuration = buildConfiguration(logger, clientSettings);
+        final ClientConfiguration configuration = buildConfiguration(clientSettings);
         final AmazonEC2 client = buildClient(credentials, configuration);
         if (Strings.hasText(clientSettings.endpoint)) {
             logger.debug("using explicit ec2 endpoint [{}]", clientSettings.endpoint);
@@ -60,7 +60,7 @@ AmazonEC2 buildClient(AWSCredentialsProvider credentials, ClientConfiguration co
     }
 
     // pkg private for tests
-    static ClientConfiguration buildConfiguration(Logger logger, Ec2ClientSettings clientSettings) {
+    static ClientConfiguration buildConfiguration(Ec2ClientSettings clientSettings) {
         final ClientConfiguration clientConfiguration = new ClientConfiguration();
         // the response metadata cache is only there for diagnostics purposes,
         // but can force objects from every response to the old generation.
diff --git a/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImplTests.java b/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImplTests.java
index 148e58d7b3c06..931cc891a91fc 100644
--- a/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImplTests.java
+++ b/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/AwsEc2ServiceImplTests.java
@@ -120,8 +120,8 @@ protected void launchAWSConfigurationTest(Settings settings,
                                               String expectedProxyUsername,
                                               String expectedProxyPassword,
                                               int expectedReadTimeout) {
-        final ClientConfiguration configuration = AwsEc2ServiceImpl.buildConfiguration(logger,
-                Ec2ClientSettings.getClientSettings(settings));
+        final ClientConfiguration configuration = AwsEc2ServiceImpl.buildConfiguration(
+            Ec2ClientSettings.getClientSettings(settings));
 
         assertThat(configuration.getResponseMetadataCacheSize(), is(0));
         assertThat(configuration.getProtocol(), is(expectedProtocol));
diff --git a/plugins/discovery-gce/src/main/java/org/elasticsearch/cloud/gce/GceModule.java b/plugins/discovery-gce/src/main/java/org/elasticsearch/cloud/gce/GceModule.java
deleted file mode 100644
index 064fe606244ee..0000000000000
--- a/plugins/discovery-gce/src/main/java/org/elasticsearch/cloud/gce/GceModule.java
+++ /dev/null
@@ -1,47 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.cloud.gce;
-
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
-import org.elasticsearch.common.inject.AbstractModule;
-import org.elasticsearch.common.settings.Settings;
-
-public class GceModule extends AbstractModule {
-    // pkg private so tests can override with mock
-    static Class<? extends GceInstancesService> computeServiceImpl = GceInstancesServiceImpl.class;
-
-    protected final Settings settings;
-    protected final Logger logger = LogManager.getLogger(GceModule.class);
-
-    public GceModule(Settings settings) {
-        this.settings = settings;
-    }
-
-    public static Class<? extends GceInstancesService> getComputeServiceImpl() {
-        return computeServiceImpl;
-    }
-
-    @Override
-    protected void configure() {
-        logger.debug("configure GceModule (bind compute service)");
-        bind(GceInstancesService.class).to(computeServiceImpl).asEagerSingleton();
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/discovery/BlockingClusterStatePublishResponseHandler.java b/server/src/main/java/org/elasticsearch/discovery/BlockingClusterStatePublishResponseHandler.java
index 8d5ef1926cdd5..5aac5758fc467 100644
--- a/server/src/main/java/org/elasticsearch/discovery/BlockingClusterStatePublishResponseHandler.java
+++ b/server/src/main/java/org/elasticsearch/discovery/BlockingClusterStatePublishResponseHandler.java
@@ -64,7 +64,7 @@ public void onResponse(DiscoveryNode node) {
      * Called for each failure obtained from non master nodes
      * @param node the node that replied to the publish event
      */
-    public void onFailure(DiscoveryNode node, Exception e) {
+    public void onFailure(DiscoveryNode node) {
         boolean found = pendingNodes.remove(node);
         assert found : "node [" + node + "] already responded or failed";
         boolean added = failedNodes.add(node);
diff --git a/server/src/main/java/org/elasticsearch/discovery/DiscoveryModule.java b/server/src/main/java/org/elasticsearch/discovery/DiscoveryModule.java
index d1b008ec76eb7..843562ef9e619 100644
--- a/server/src/main/java/org/elasticsearch/discovery/DiscoveryModule.java
+++ b/server/src/main/java/org/elasticsearch/discovery/DiscoveryModule.java
@@ -39,7 +39,6 @@
 import org.elasticsearch.common.transport.TransportAddress;
 import org.elasticsearch.gateway.GatewayMetaState;
 import org.elasticsearch.plugins.DiscoveryPlugin;
-import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
 
 import java.nio.file.Path;
@@ -82,7 +81,7 @@ public class DiscoveryModule {
 
     private final Discovery discovery;
 
-    public DiscoveryModule(Settings settings, ThreadPool threadPool, TransportService transportService,
+    public DiscoveryModule(Settings settings, TransportService transportService,
                            NamedWriteableRegistry namedWriteableRegistry, NetworkService networkService, MasterService masterService,
                            ClusterApplier clusterApplier, ClusterSettings clusterSettings, List<DiscoveryPlugin> plugins,
                            AllocationService allocationService, Path configFile, GatewayMetaState gatewayMetaState,
diff --git a/server/src/main/java/org/elasticsearch/discovery/MasterNotDiscoveredException.java b/server/src/main/java/org/elasticsearch/discovery/MasterNotDiscoveredException.java
index 282d849debd44..e79a8f7b0f202 100644
--- a/server/src/main/java/org/elasticsearch/discovery/MasterNotDiscoveredException.java
+++ b/server/src/main/java/org/elasticsearch/discovery/MasterNotDiscoveredException.java
@@ -30,15 +30,10 @@ public class MasterNotDiscoveredException extends ElasticsearchException {
     public MasterNotDiscoveredException() {
         super("");
     }
-
     public MasterNotDiscoveredException(Throwable cause) {
         super(cause);
     }
 
-    public MasterNotDiscoveredException(String message) {
-        super(message);
-    }
-
     @Override
     public RestStatus status() {
         return RestStatus.SERVICE_UNAVAILABLE;
diff --git a/server/src/main/java/org/elasticsearch/gateway/LocalAllocateDangledIndices.java b/server/src/main/java/org/elasticsearch/gateway/LocalAllocateDangledIndices.java
index 281c96415457d..a90e31ada1cf2 100644
--- a/server/src/main/java/org/elasticsearch/gateway/LocalAllocateDangledIndices.java
+++ b/server/src/main/java/org/elasticsearch/gateway/LocalAllocateDangledIndices.java
@@ -80,7 +80,7 @@ public void allocateDangled(Collection<IndexMetaData> indices, ActionListener<Al
         ClusterState clusterState = clusterService.state();
         DiscoveryNode masterNode = clusterState.nodes().getMasterNode();
         if (masterNode == null) {
-            listener.onFailure(new MasterNotDiscoveredException("no master to send allocate dangled request"));
+            listener.onFailure(new MasterNotDiscoveredException());
             return;
         }
         AllocateDangledRequest request = new AllocateDangledRequest(clusterService.localNode(),
diff --git a/server/src/main/java/org/elasticsearch/node/Node.java b/server/src/main/java/org/elasticsearch/node/Node.java
index e4c1e7766af40..347e8a8c79389 100644
--- a/server/src/main/java/org/elasticsearch/node/Node.java
+++ b/server/src/main/java/org/elasticsearch/node/Node.java
@@ -496,7 +496,7 @@ protected Node(
                 clusterService.getClusterSettings(), client, threadPool::relativeTimeInMillis, rerouteService);
             clusterInfoService.addListener(diskThresholdMonitor::onNewInfo);
 
-            final DiscoveryModule discoveryModule = new DiscoveryModule(settings, threadPool, transportService, namedWriteableRegistry,
+            final DiscoveryModule discoveryModule = new DiscoveryModule(settings, transportService, namedWriteableRegistry,
                 networkService, clusterService.getMasterService(), clusterService.getClusterApplierService(),
                 clusterService.getClusterSettings(), pluginsService.filterPlugins(DiscoveryPlugin.class),
                 clusterModule.getAllocationService(), environment.configFile(), gatewayMetaState, rerouteService);
diff --git a/server/src/test/java/org/elasticsearch/discovery/BlockingClusterStatePublishResponseHandlerTests.java b/server/src/test/java/org/elasticsearch/discovery/BlockingClusterStatePublishResponseHandlerTests.java
index da9a4d6c2bf19..14955a0f1251a 100644
--- a/server/src/test/java/org/elasticsearch/discovery/BlockingClusterStatePublishResponseHandlerTests.java
+++ b/server/src/test/java/org/elasticsearch/discovery/BlockingClusterStatePublishResponseHandlerTests.java
@@ -66,7 +66,7 @@ public void onFailure(Exception e) {
         protected void doRun() throws Exception {
             barrier.await();
             if (fail) {
-                handler.onFailure(node, new Exception("bla"));
+                handler.onFailure(node);
             } else {
                 handler.onResponse(node);
             }
diff --git a/server/src/test/java/org/elasticsearch/discovery/DiscoveryModuleTests.java b/server/src/test/java/org/elasticsearch/discovery/DiscoveryModuleTests.java
index 4ba865a2495e2..c004af13fd344 100644
--- a/server/src/test/java/org/elasticsearch/discovery/DiscoveryModuleTests.java
+++ b/server/src/test/java/org/elasticsearch/discovery/DiscoveryModuleTests.java
@@ -29,7 +29,6 @@
 import org.elasticsearch.common.network.NetworkService;
 import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.gateway.GatewayMetaState;
 import org.elasticsearch.plugins.DiscoveryPlugin;
@@ -51,7 +50,6 @@
 import java.util.function.Supplier;
 
 import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
 
 public class DiscoveryModuleTests extends ESTestCase {
 
@@ -59,7 +57,6 @@ public class DiscoveryModuleTests extends ESTestCase {
     private NamedWriteableRegistry namedWriteableRegistry;
     private MasterService masterService;
     private ClusterApplier clusterApplier;
-    private ThreadPool threadPool;
     private ClusterSettings clusterSettings;
     private GatewayMetaState gatewayMetaState;
 
@@ -74,9 +71,7 @@ default Map<String, Supplier<SeedHostsProvider>> getSeedHostProviders(TransportS
 
     @Before
     public void setupDummyServices() {
-        threadPool = mock(ThreadPool.class);
-        when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
-        transportService = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool, null);
+        transportService = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, mock(ThreadPool.class), null);
         masterService = mock(MasterService.class);
         namedWriteableRegistry = new NamedWriteableRegistry(Collections.emptyList());
         clusterApplier = mock(ClusterApplier.class);
@@ -90,7 +85,7 @@ public void clearDummyServices() throws IOException {
     }
 
     private DiscoveryModule newModule(Settings settings, List<DiscoveryPlugin> plugins) {
-        return new DiscoveryModule(settings, threadPool, transportService, namedWriteableRegistry, null, masterService,
+        return new DiscoveryModule(settings, transportService, namedWriteableRegistry, null, masterService,
             clusterApplier, clusterSettings, plugins, null, createTempDir().toAbsolutePath(), gatewayMetaState,
             mock(RerouteService.class));
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportCloseJobAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportCloseJobAction.java
index c79ee507bd9d2..c0131cb5a8099 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportCloseJobAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportCloseJobAction.java
@@ -87,7 +87,7 @@ protected void doExecute(Task task, CloseJobAction.Request request, ActionListen
             // Delegates close job to elected master node, so it becomes the coordinating node.
             // See comment in OpenJobAction.Transport class for more information.
             if (nodes.getMasterNode() == null) {
-                listener.onFailure(new MasterNotDiscoveredException("no known master node"));
+                listener.onFailure(new MasterNotDiscoveredException());
             } else {
                 transportService.sendRequest(nodes.getMasterNode(), actionName, request,
                         new ActionListenerResponseHandler<>(listener, CloseJobAction.Response::new));
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDataFrameAnalyticsAction.java
index 2d0f3adfd14ab..881c6e410f743 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDataFrameAnalyticsAction.java
@@ -202,7 +202,7 @@ private String[] findAllocatedNodesAndRemoveUnassignedTasks(Set<String> analytic
     private void redirectToMasterNode(DiscoveryNode masterNode, StopDataFrameAnalyticsAction.Request request,
                                       ActionListener<StopDataFrameAnalyticsAction.Response> listener) {
         if (masterNode == null) {
-            listener.onFailure(new MasterNotDiscoveredException("no known master node"));
+            listener.onFailure(new MasterNotDiscoveredException());
         } else {
             transportService.sendRequest(masterNode, actionName, request,
                 new ActionListenerResponseHandler<>(listener, StopDataFrameAnalyticsAction.Response::new));
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDatafeedAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDatafeedAction.java
index d90f175e46b1f..d254aeebd5b4b 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDatafeedAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStopDatafeedAction.java
@@ -125,7 +125,7 @@ protected void doExecute(Task task, StopDatafeedAction.Request request, ActionLi
             // Delegates stop datafeed to elected master node, so it becomes the coordinating node.
             // See comment in TransportStartDatafeedAction for more information.
             if (nodes.getMasterNode() == null) {
-                listener.onFailure(new MasterNotDiscoveredException("no known master node"));
+                listener.onFailure(new MasterNotDiscoveredException());
             } else {
                 transportService.sendRequest(nodes.getMasterNode(), actionName, request,
                         new ActionListenerResponseHandler<>(listener, StopDatafeedAction.Response::new));
diff --git a/x-pack/plugin/rollup/src/main/java/org/elasticsearch/xpack/rollup/action/TransportDeleteRollupJobAction.java b/x-pack/plugin/rollup/src/main/java/org/elasticsearch/xpack/rollup/action/TransportDeleteRollupJobAction.java
index f5a484a8e2751..ac37ee7288ae9 100644
--- a/x-pack/plugin/rollup/src/main/java/org/elasticsearch/xpack/rollup/action/TransportDeleteRollupJobAction.java
+++ b/x-pack/plugin/rollup/src/main/java/org/elasticsearch/xpack/rollup/action/TransportDeleteRollupJobAction.java
@@ -57,7 +57,7 @@ protected void doExecute(Task task, DeleteRollupJobAction.Request request, Actio
             // Non-master nodes may have a stale cluster state that shows jobs which are cancelled
             // on the master, which makes testing difficult.
             if (nodes.getMasterNode() == null) {
-                listener.onFailure(new MasterNotDiscoveredException("no known master nodes"));
+                listener.onFailure(new MasterNotDiscoveredException());
             } else {
                 transportService.sendRequest(nodes.getMasterNode(), actionName, request,
                     new ActionListenerResponseHandler<>(listener, DeleteRollupJobAction.Response::new));
diff --git a/x-pack/plugin/rollup/src/main/java/org/elasticsearch/xpack/rollup/action/TransportGetRollupJobAction.java b/x-pack/plugin/rollup/src/main/java/org/elasticsearch/xpack/rollup/action/TransportGetRollupJobAction.java
index 836ccfd2cfef7..ec7f5495aa314 100644
--- a/x-pack/plugin/rollup/src/main/java/org/elasticsearch/xpack/rollup/action/TransportGetRollupJobAction.java
+++ b/x-pack/plugin/rollup/src/main/java/org/elasticsearch/xpack/rollup/action/TransportGetRollupJobAction.java
@@ -59,7 +59,7 @@ protected void doExecute(Task task, GetRollupJobsAction.Request request, ActionL
             // Non-master nodes may have a stale cluster state that shows jobs which are cancelled
             // on the master, which makes testing difficult.
             if (nodes.getMasterNode() == null) {
-                listener.onFailure(new MasterNotDiscoveredException("no known master nodes"));
+                listener.onFailure(new MasterNotDiscoveredException());
             } else {
                 transportService.sendRequest(nodes.getMasterNode(), actionName, request,
                         new ActionListenerResponseHandler<>(listener, GetRollupJobsAction.Response::new));
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
index aaf51396abb87..bd3ddc3e8ceab 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
@@ -134,7 +134,7 @@ protected void doExecute(Task task, Request request, ActionListener<Response> li
         if (nodes.isLocalNodeElectedMaster() == false) {
             // Delegates stop transform to elected master node so it becomes the coordinating node.
             if (nodes.getMasterNode() == null) {
-                listener.onFailure(new MasterNotDiscoveredException("no known master node"));
+                listener.onFailure(new MasterNotDiscoveredException());
             } else {
                 transportService.sendRequest(
                     nodes.getMasterNode(),

From 7e6a793c62f5115f52090e716f32937a50ee2a68 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Fri, 3 Jan 2020 08:34:11 -0500
Subject: [PATCH 369/686] [DOCS] Reformat uppercase token filter docs (#50555)

* Updates the description and adds a Lucene link
* Adds analyze and custom analyzer snippets
---
 .../uppercase-tokenfilter.asciidoc            | 101 +++++++++++++++++-
 1 file changed, 99 insertions(+), 2 deletions(-)

diff --git a/docs/reference/analysis/tokenfilters/uppercase-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/uppercase-tokenfilter.asciidoc
index c745f247ec3d9..06ea2c3279c56 100644
--- a/docs/reference/analysis/tokenfilters/uppercase-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/uppercase-tokenfilter.asciidoc
@@ -4,5 +4,102 @@
 <titleabbrev>Uppercase</titleabbrev>
 ++++
 
-A token filter of type `uppercase` that normalizes token text to upper
-case.
+Changes token text to uppercase. For example, you can use the `uppercase` filter
+to change `the Lazy DoG` to `THE LAZY DOG`.
+
+This filter uses Lucene's
+https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/core/UpperCaseFilter.html[UpperCaseFilter].
+
+[WARNING]
+====
+Depending on the language, an uppercase character can map to multiple
+lowercase characters. Using the `uppercase` filter could result in the loss of
+lowercase character information.
+
+To avoid this loss but still have a consistent lettercase, use the <<analysis-lowercase-tokenfilter,`lowercase`>> filter instead.
+====
+
+[[analysis-uppercase-tokenfilter-analyze-ex]]
+==== Example
+
+The following <<indices-analyze,analyze API>> request uses the default
+`uppercase` filter to change the `the Quick FoX JUMPs` to uppercase:
+
+[source,console]
+--------------------------------------------------
+GET _analyze
+{
+  "tokenizer" : "standard",
+  "filter" : ["uppercase"],
+  "text" : "the Quick FoX JUMPs"
+}
+--------------------------------------------------
+
+The filter produces the following tokens:
+
+[source,text]
+--------------------------------------------------
+[ THE, QUICK, FOX, JUMPS ]
+--------------------------------------------------
+
+/////////////////////
+[source,console-result]
+--------------------------------------------------
+{
+  "tokens" : [
+    {
+      "token" : "THE",
+      "start_offset" : 0,
+      "end_offset" : 3,
+      "type" : "<ALPHANUM>",
+      "position" : 0
+    },
+    {
+      "token" : "QUICK",
+      "start_offset" : 4,
+      "end_offset" : 9,
+      "type" : "<ALPHANUM>",
+      "position" : 1
+    },
+    {
+      "token" : "FOX",
+      "start_offset" : 10,
+      "end_offset" : 13,
+      "type" : "<ALPHANUM>",
+      "position" : 2
+    },
+    {
+      "token" : "JUMPS",
+      "start_offset" : 14,
+      "end_offset" : 19,
+      "type" : "<ALPHANUM>",
+      "position" : 3
+    }
+  ]
+}
+--------------------------------------------------
+/////////////////////
+
+[[analysis-uppercase-tokenfilter-analyzer-ex]]
+==== Add to an analyzer
+
+The following <<indices-create-index,create index API>> request uses the
+`uppercase` filter to configure a new 
+<<analysis-custom-analyzer,custom analyzer>>.
+
+[source,console]
+--------------------------------------------------
+PUT uppercase_example
+{
+    "settings" : {
+        "analysis" : {
+            "analyzer" : {
+                "whitespace_uppercase" : {
+                    "tokenizer" : "whitespace",
+                    "filter" : ["uppercase"]
+                }
+            }
+        }
+    }
+}
+--------------------------------------------------

From 46686a7fefd87335b38c0c9f4f7bffb643e68e5e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Fri, 3 Jan 2020 14:49:43 +0100
Subject: [PATCH 370/686] [DOCS] Fine-tunes training_percent definition.
 (#50601)

---
 docs/reference/ml/ml-shared.asciidoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 7b0f8b64718a7..61e862486f12a 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -1064,8 +1064,8 @@ end::tokenizer[]
 tag::training-percent[]
 Defines what percentage of the eligible documents that will 
 be used for training. Documents that are ignored by the analysis (for example 
-those that contain arrays) won’t be included in the calculation for used 
-percentage. Defaults to `100`.
+those that contain arrays with more than one value) won’t be included in the 
+calculation for used percentage. Defaults to `100`.
 end::training-percent[]
 
 tag::use-null[]

From 9e178689b7558c864464a3fb2c9f35c995cf3b86 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 3 Jan 2020 16:44:38 +0200
Subject: [PATCH 371/686] [ML] Unmute BWC tests and fix version after backport
 of #50553 (#50599)

Relates #50553
---
 .../DeleteDataFrameAnalyticsAction.java       |  4 +--
 .../90_ml_data_frame_analytics_crud.yml       | 28 +++++++++++++++----
 .../90_ml_data_frame_analytics_crud.yml       |  3 --
 .../90_ml_data_frame_analytics_crud.yml       |  5 ----
 4 files changed, 25 insertions(+), 15 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/DeleteDataFrameAnalyticsAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/DeleteDataFrameAnalyticsAction.java
index 40d70d979be9e..74a473ec6832b 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/DeleteDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/DeleteDataFrameAnalyticsAction.java
@@ -40,7 +40,7 @@ public static class Request extends AcknowledgedRequest<Request> {
         public Request(StreamInput in) throws IOException {
             super(in);
             id = in.readString();
-            if (in.getVersion().onOrAfter(Version.CURRENT)) {
+            if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
                 force = in.readBoolean();
             } else {
                 force = false;
@@ -82,7 +82,7 @@ public boolean equals(Object o) {
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             out.writeString(id);
-            if (out.getVersion().onOrAfter(Version.CURRENT)) {
+            if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
                 out.writeBoolean(force);
             }
         }
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
index a6fbc5cc4e2c0..af304afc57db6 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,8 +1,3 @@
-setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/50553"
-
 ---
 "Get old outlier_detection job":
 
@@ -148,3 +143,26 @@ setup:
   - match: { count: 1 }
   - match: { data_frame_analytics.0.id: "mixed_cluster_outlier_detection_job" }
   - match: { data_frame_analytics.0.state: "stopped" }
+
+---
+"Put and delete a job":
+
+  - do:
+      ml.put_data_frame_analytics:
+        id: "mixed_cluster_job_to_delete"
+        body: >
+          {
+            "source": {
+              "index": "bwc_ml_outlier_detection_job_source"
+            },
+            "dest": {
+              "index": "mixed_cluster_job_to_delete_results"
+            },
+            "analysis": {"outlier_detection":{}}
+          }
+  - match: { id: "mixed_cluster_job_to_delete" }
+
+  - do:
+      ml.delete_data_frame_analytics:
+        id: mixed_cluster_job_to_delete
+  - match: { acknowledged: true }
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
index 51f21afa6761d..fe160bba15f23 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,7 +1,4 @@
 setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/50553"
 
   - do:
       index:
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
index b20c63f69d8e2..14438883f0da1 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,8 +1,3 @@
-setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/issues/50553"
-
 ---
 "Get old cluster outlier_detection job":
 

From 149a4c3b89f3f516a63afe2ca3849c272c15ecb0 Mon Sep 17 00:00:00 2001
From: Aleksandr Maus <aleksandr.maus@elastic.co>
Date: Fri, 3 Jan 2020 10:03:48 -0500
Subject: [PATCH 372/686] Fix RestSqlQueryAction comment typos (#50603)

---
 .../elasticsearch/xpack/sql/plugin/RestSqlQueryAction.java  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/RestSqlQueryAction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/RestSqlQueryAction.java
index e4807389e33a5..d389a5ba1e17d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/RestSqlQueryAction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/RestSqlQueryAction.java
@@ -49,15 +49,15 @@ protected RestChannelConsumer prepareRequest(RestRequest request, NodeClient cli
          * {@link XContent} outputs we can't use {@link RestToXContentListener}
          * like everything else. We want to stick as closely as possible to
          * Elasticsearch's defaults though, while still layering in ways to
-         * control the output more easilly.
+         * control the output more easily.
          *
          * First we find the string that the user used to specify the response
-         * format. If there is a {@code format} paramter we use that. If there
+         * format. If there is a {@code format} parameter we use that. If there
          * isn't but there is a {@code Accept} header then we use that. If there
          * isn't then we use the {@code Content-Type} header which is required.
          */
         String accept = null;
-        
+
         if ((Mode.isDriver(sqlRequest.requestInfo().mode()) || sqlRequest.requestInfo().mode() == Mode.CLI)
                 && (sqlRequest.binaryCommunication() == null || sqlRequest.binaryCommunication() == true)) {
             // enforce CBOR response for drivers and CLI (unless instructed differently through the config param)

From 160eea78cf7e08f54c28284538c7c6c3a500a1ad Mon Sep 17 00:00:00 2001
From: Andrei Dan <andrei.dan@elastic.co>
Date: Fri, 3 Jan 2020 17:14:33 +0200
Subject: [PATCH 373/686] Guard against null geoBoundingBox (#50506)

A geo box with a top value of Double.NEGATIVE_INFINITY will yield an empty
xContent which translates to a null `geoBoundingBox`. This commit marks the
field as `Nullable` and guards against null when retrieving the `topLeft`
and `bottomRight` fields.

Fixes https://github.com/elastic/elasticsearch/issues/50505
---
 .../search/aggregations/metrics/ParsedGeoBounds.java | 12 +++++++++---
 .../aggregations/metrics/InternalGeoBoundsTests.java |  2 --
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedGeoBounds.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedGeoBounds.java
index 2b29ae15119d9..cbe1494b13f9d 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedGeoBounds.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedGeoBounds.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.search.aggregations.metrics;
 
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.common.geo.GeoPoint;
@@ -30,14 +31,17 @@
 
 import java.io.IOException;
 
-import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 import static org.elasticsearch.common.geo.GeoBoundingBox.BOTTOM_RIGHT_FIELD;
 import static org.elasticsearch.common.geo.GeoBoundingBox.BOUNDS_FIELD;
 import static org.elasticsearch.common.geo.GeoBoundingBox.LAT_FIELD;
 import static org.elasticsearch.common.geo.GeoBoundingBox.LON_FIELD;
 import static org.elasticsearch.common.geo.GeoBoundingBox.TOP_LEFT_FIELD;
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 
 public class ParsedGeoBounds extends ParsedAggregation implements GeoBounds {
+
+    // A top of Double.NEGATIVE_INFINITY yields an empty xContent, so the bounding box is null
+    @Nullable
     private GeoBoundingBox geoBoundingBox;
 
     @Override
@@ -54,13 +58,15 @@ public XContentBuilder doXContentBody(XContentBuilder builder, Params params) th
     }
 
     @Override
+    @Nullable
     public GeoPoint topLeft() {
-        return geoBoundingBox.topLeft();
+        return geoBoundingBox != null ? geoBoundingBox.topLeft() : null;
     }
 
     @Override
+    @Nullable
     public GeoPoint bottomRight() {
-        return geoBoundingBox.bottomRight();
+        return geoBoundingBox != null ? geoBoundingBox.bottomRight() : null;
     }
 
     private static final ObjectParser<ParsedGeoBounds, Void> PARSER = new ObjectParser<>(ParsedGeoBounds.class.getSimpleName(), true,
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBoundsTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBoundsTests.java
index aa2e527b2e605..27ef688a8666d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBoundsTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/InternalGeoBoundsTests.java
@@ -21,8 +21,6 @@
 
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.search.aggregations.ParsedAggregation;
-import org.elasticsearch.search.aggregations.metrics.InternalGeoBounds;
-import org.elasticsearch.search.aggregations.metrics.ParsedGeoBounds;
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
 import org.elasticsearch.test.InternalAggregationTestCase;
 

From c439cbc3b0b33f0579785119c9917c6d18cd3868 Mon Sep 17 00:00:00 2001
From: Orhan Toy <toyorhan@gmail.com>
Date: Fri, 3 Jan 2020 16:15:18 +0100
Subject: [PATCH 374/686] [DOCS] Fix missing quote in
 script-score-query.asciidoc  (#50590)

---
 docs/reference/query-dsl/script-score-query.asciidoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/query-dsl/script-score-query.asciidoc b/docs/reference/query-dsl/script-score-query.asciidoc
index c74a50087170f..029cc7469e0f3 100644
--- a/docs/reference/query-dsl/script-score-query.asciidoc
+++ b/docs/reference/query-dsl/script-score-query.asciidoc
@@ -281,7 +281,7 @@ as described in <<random-score-function, random score function>>.
 --------------------------------------------------
 "script" : {
     "source" : "Math.log10(doc['field'].value * params.factor)",
-    params" : {
+    "params" : {
         "factor" : 5
     }
 }
@@ -297,7 +297,7 @@ a value `1` if a document doesn't have a field `field`:
 --------------------------------------------------
 "script" : {
     "source" : "Math.log10((doc['field'].size() == 0 ? 1 : doc['field'].value()) * params.factor)",
-    params" : {
+    "params" : {
         "factor" : 5
     }
 }

From 0ac7475a3a3b939af7926e8914b04bff628cbeef Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 3 Jan 2020 10:47:51 -0500
Subject: [PATCH 375/686] Declare remaining parsers `final` (#50571)

We have about 800 `ObjectParsers` in Elasticsearch, about 700 of which
are final. This is *probably* the right way to declare them because in
practice we never mutate them after they are built. And we certainly
don't change the static reference. Anyway, this adds `final` to these
parsers.

I found the non-final parsers with this:
```
diff \
  <(find . -type f -name '*.java' -exec grep -iHe 'static.*PARSER\s*=' {} \+ | sort) \
  <(find . -type f -name '*.java' -exec grep -iHe 'static.*final.*PARSER\s*=' {} \+ | sort) \
  2>&1 | grep '^<'
```
---
 .../org/elasticsearch/client/SyncedFlushResponse.java  |  2 +-
 .../org/elasticsearch/client/core/MainResponse.java    |  3 +--
 .../client/core/MultiTermVectorsResponse.java          |  2 +-
 .../elasticsearch/client/core/TermVectorsResponse.java | 10 +++++-----
 .../elasticsearch/client/ml/StartDatafeedRequest.java  |  2 +-
 .../client/ml/dataframe/DataFrameAnalyticsConfig.java  |  2 +-
 .../client/ml/dataframe/DataFrameAnalyticsDest.java    |  2 +-
 .../client/ml/dataframe/DataFrameAnalyticsSource.java  |  2 +-
 .../client/ml/dataframe/OutlierDetection.java          |  2 +-
 .../elasticsearch/client/watcher/AckWatchResponse.java |  2 +-
 .../client/watcher/ActivateWatchResponse.java          |  2 +-
 .../elasticsearch/client/watcher/GetWatchResponse.java |  2 +-
 .../client/watcher/WatcherStatsResponse.java           |  2 +-
 .../smoketest/DocsClientYamlTestSuiteIT.java           |  2 +-
 .../aggregations/matrix/stats/ParsedMatrixStats.java   |  2 +-
 .../index/query/RankFeatureQueryBuilder.java           |  2 +-
 .../allocation/ClusterAllocationExplainRequest.java    |  2 +-
 .../action/admin/indices/rollover/RolloverInfo.java    |  2 +-
 .../admin/indices/validate/query/QueryExplanation.java |  2 +-
 .../indices/validate/query/ValidateQueryResponse.java  |  2 +-
 .../elasticsearch/action/bulk/BulkItemResponse.java    |  2 +-
 .../action/fieldcaps/FieldCapabilities.java            |  2 +-
 .../action/fieldcaps/FieldCapabilitiesRequest.java     |  2 +-
 .../java/org/elasticsearch/common/geo/GeoJson.java     |  2 +-
 .../org/elasticsearch/index/query/IdsQueryBuilder.java |  3 +--
 .../query/functionscore/ScriptScoreQueryBuilder.java   |  2 +-
 .../elasticsearch/index/reindex/BulkByScrollTask.java  |  2 +-
 .../org/elasticsearch/index/seqno/RetentionLease.java  |  2 +-
 .../org/elasticsearch/index/seqno/RetentionLeases.java |  2 +-
 .../org/elasticsearch/script/ScriptContextInfo.java    |  6 +++---
 .../org/elasticsearch/script/ScriptLanguagesInfo.java  |  4 ++--
 .../main/java/org/elasticsearch/search/SearchHit.java  |  2 +-
 .../bucket/adjacency/ParsedAdjacencyMatrix.java        |  2 +-
 .../aggregations/bucket/composite/ParsedComposite.java |  2 +-
 .../aggregations/bucket/filter/ParsedFilters.java      |  2 +-
 .../aggregations/bucket/geogrid/ParsedGeoHashGrid.java |  2 +-
 .../aggregations/bucket/geogrid/ParsedGeoTileGrid.java |  2 +-
 .../histogram/DateHistogramAggregationBuilder.java     |  2 +-
 .../bucket/histogram/ParsedAutoDateHistogram.java      |  2 +-
 .../bucket/histogram/ParsedDateHistogram.java          |  2 +-
 .../aggregations/bucket/histogram/ParsedHistogram.java |  2 +-
 .../aggregations/bucket/range/ParsedBinaryRange.java   |  2 +-
 .../aggregations/bucket/range/ParsedDateRange.java     |  2 +-
 .../aggregations/bucket/range/ParsedGeoDistance.java   |  2 +-
 .../search/aggregations/bucket/range/ParsedRange.java  |  2 +-
 .../bucket/significant/ParsedSignificantLongTerms.java |  2 +-
 .../significant/ParsedSignificantStringTerms.java      |  2 +-
 .../aggregations/bucket/terms/ParsedDoubleTerms.java   |  2 +-
 .../aggregations/bucket/terms/ParsedLongTerms.java     |  2 +-
 .../aggregations/bucket/terms/ParsedStringTerms.java   |  2 +-
 .../aggregations/metrics/ParsedHDRPercentileRanks.java |  2 +-
 .../aggregations/metrics/ParsedHDRPercentiles.java     |  2 +-
 .../metrics/ParsedTDigestPercentileRanks.java          |  2 +-
 .../aggregations/metrics/ParsedTDigestPercentiles.java |  2 +-
 .../search/aggregations/metrics/ParsedTopHits.java     |  2 +-
 .../aggregations/pipeline/ParsedPercentilesBucket.java |  2 +-
 .../elasticsearch/search/sort/FieldSortBuilder.java    |  2 +-
 .../elasticsearch/search/sort/ScoreSortBuilder.java    |  2 +-
 .../elasticsearch/search/sort/ScriptSortBuilder.java   |  2 +-
 .../suggest/completion/CompletionSuggestion.java       |  5 ++---
 .../completion/context/CategoryQueryContext.java       |  2 +-
 .../suggest/completion/context/GeoQueryContext.java    |  2 +-
 .../search/suggest/phrase/PhraseSuggestion.java        |  3 +--
 .../search/suggest/term/TermSuggestion.java            |  3 +--
 .../common/geo/GeoJsonSerializationTests.java          |  2 +-
 65 files changed, 73 insertions(+), 78 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/SyncedFlushResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/SyncedFlushResponse.java
index 303e8328d08e8..41e9c3d062b0a 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/SyncedFlushResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/SyncedFlushResponse.java
@@ -282,7 +282,7 @@ public static final class ShardFailure implements ToXContentFragment {
         private Map<String, Object> routing;
 
         @SuppressWarnings("unchecked")
-        static ConstructingObjectParser<ShardFailure, Void> PARSER = new ConstructingObjectParser<>(
+        static final ConstructingObjectParser<ShardFailure, Void> PARSER = new ConstructingObjectParser<>(
             "shardfailure",
             a -> new ShardFailure((Integer)a[0], (String)a[1], (Map<String, Object>)a[2])
         );
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MainResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MainResponse.java
index 09fc2b49a0156..5fa0120611fa6 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MainResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MainResponse.java
@@ -99,8 +99,7 @@ public int hashCode() {
     }
 
     public static class Version {
-        @SuppressWarnings("unchecked")
-        private static ConstructingObjectParser<Version, Void> PARSER =
+        private static final ConstructingObjectParser<Version, Void> PARSER =
             new ConstructingObjectParser<>(Version.class.getName(), true,
                 args -> {
                     return new Version((String) args[0], (String) args[1], (String) args[2], (String) args[3], (String) args[4],
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MultiTermVectorsResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MultiTermVectorsResponse.java
index 0a2974a8aa166..ea58e93eb9e34 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MultiTermVectorsResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/core/MultiTermVectorsResponse.java
@@ -36,7 +36,7 @@ public MultiTermVectorsResponse(List<TermVectorsResponse> responses) {
         this.responses = responses;
     }
 
-    private static ConstructingObjectParser<MultiTermVectorsResponse, Void> PARSER =
+    private static final ConstructingObjectParser<MultiTermVectorsResponse, Void> PARSER =
         new ConstructingObjectParser<>("multi_term_vectors", true,
         args -> {
             // as the response comes from server, we are sure that args[0] will be a list of TermVectorsResponse
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/core/TermVectorsResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/core/TermVectorsResponse.java
index f53f125cbf788..14e9ff7415099 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/core/TermVectorsResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/core/TermVectorsResponse.java
@@ -48,7 +48,7 @@ public TermVectorsResponse(String index, String id, long version, boolean found,
         this.termVectorList = termVectorList;
     }
 
-    private static ConstructingObjectParser<TermVectorsResponse, Void> PARSER = new ConstructingObjectParser<>("term_vectors", true,
+    private static final ConstructingObjectParser<TermVectorsResponse, Void> PARSER = new ConstructingObjectParser<>("term_vectors", true,
         args -> {
             // as the response comes from server, we are sure that args[5] will be a list of TermVector
             @SuppressWarnings("unchecked") List<TermVector> termVectorList = (List<TermVector>) args[5];
@@ -145,7 +145,7 @@ public int hashCode() {
 
     public static final class TermVector {
 
-        private static ConstructingObjectParser<TermVector, String> PARSER = new ConstructingObjectParser<>("term_vector", true,
+        private static final ConstructingObjectParser<TermVector, String> PARSER = new ConstructingObjectParser<>("term_vector", true,
             (args, ctxFieldName)  -> {
                 // as the response comes from server, we are sure that args[1] will be a list of Term
                 @SuppressWarnings("unchecked") List<Term> terms = (List<Term>) args[1];
@@ -218,7 +218,7 @@ public int hashCode() {
         // Class containing a general field statistics for the field
         public static final class FieldStatistics {
 
-            private static ConstructingObjectParser<FieldStatistics, Void> PARSER = new ConstructingObjectParser<>(
+            private static final ConstructingObjectParser<FieldStatistics, Void> PARSER = new ConstructingObjectParser<>(
                 "field_statistics", true,
                 args  -> {
                     return new FieldStatistics((long) args[0], (int) args[1], (long) args[2]);
@@ -282,7 +282,7 @@ public int hashCode() {
 
 
         public static final class Term {
-            private static ConstructingObjectParser<Term, String> PARSER = new ConstructingObjectParser<>("token", true,
+            private static final ConstructingObjectParser<Term, String> PARSER = new ConstructingObjectParser<>("token", true,
                 (args, ctxTerm)  -> {
                     // as the response comes from server, we are sure that args[4] will be a list of Token
                     @SuppressWarnings("unchecked") List<Token> tokens = (List<Token>) args[4];
@@ -393,7 +393,7 @@ public int hashCode() {
 
         public static final class Token {
 
-            private static ConstructingObjectParser<Token, Void> PARSER = new ConstructingObjectParser<>("token", true,
+            private static final ConstructingObjectParser<Token, Void> PARSER = new ConstructingObjectParser<>("token", true,
                 args  -> {
                     return new Token((Integer) args[0], (Integer) args[1], (Integer) args[2], (String) args[3]);
                 });
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/StartDatafeedRequest.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/StartDatafeedRequest.java
index 68e93141b01e2..f246f5b976b86 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/StartDatafeedRequest.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/StartDatafeedRequest.java
@@ -38,7 +38,7 @@ public class StartDatafeedRequest implements Validatable, ToXContentObject {
     public static final ParseField END = new ParseField("end");
     public static final ParseField TIMEOUT = new ParseField("timeout");
 
-    public static ConstructingObjectParser<StartDatafeedRequest, Void> PARSER =
+    public static final ConstructingObjectParser<StartDatafeedRequest, Void> PARSER =
         new ConstructingObjectParser<>("start_datafeed_request", a -> new StartDatafeedRequest((String)a[0]));
 
     static {
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsConfig.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsConfig.java
index 0c3f98b9a46ad..5e803f714cd22 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsConfig.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsConfig.java
@@ -58,7 +58,7 @@ public static Builder builder() {
     private static final ParseField VERSION = new ParseField("version");
     private static final ParseField ALLOW_LAZY_START = new ParseField("allow_lazy_start");
 
-    private static ObjectParser<Builder, Void> PARSER = new ObjectParser<>("data_frame_analytics_config", true, Builder::new);
+    private static final ObjectParser<Builder, Void> PARSER = new ObjectParser<>("data_frame_analytics_config", true, Builder::new);
 
     static {
         PARSER.declareString(Builder::setId, ID);
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsDest.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsDest.java
index 4123f85ee2f43..3b765c9b49c69 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsDest.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsDest.java
@@ -45,7 +45,7 @@ public static Builder builder() {
     private static final ParseField INDEX = new ParseField("index");
     private static final ParseField RESULTS_FIELD = new ParseField("results_field");
 
-    private static ObjectParser<Builder, Void> PARSER = new ObjectParser<>("data_frame_analytics_dest", true, Builder::new);
+    private static final ObjectParser<Builder, Void> PARSER = new ObjectParser<>("data_frame_analytics_dest", true, Builder::new);
 
     static {
         PARSER.declareString(Builder::setIndex, INDEX);
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSource.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSource.java
index 1f731f4c28aaa..29672fb569d6e 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSource.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/DataFrameAnalyticsSource.java
@@ -47,7 +47,7 @@ public static Builder builder() {
     private static final ParseField QUERY = new ParseField("query");
     public static final ParseField _SOURCE = new ParseField("_source");
 
-    private static ObjectParser<Builder, Void> PARSER = new ObjectParser<>("data_frame_analytics_source", true, Builder::new);
+    private static final ObjectParser<Builder, Void> PARSER = new ObjectParser<>("data_frame_analytics_source", true, Builder::new);
 
     static {
         PARSER.declareStringArray(Builder::setIndex, INDEX);
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/OutlierDetection.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/OutlierDetection.java
index f58c9b3d35429..ceb6b6e71f2ee 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/OutlierDetection.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/OutlierDetection.java
@@ -51,7 +51,7 @@ public static Builder builder() {
     static final ParseField OUTLIER_FRACTION = new ParseField("outlier_fraction");
     static final ParseField STANDARDIZATION_ENABLED = new ParseField("standardization_enabled");
 
-    private static ObjectParser<Builder, Void> PARSER = new ObjectParser<>(NAME.getPreferredName(), true, Builder::new);
+    private static final ObjectParser<Builder, Void> PARSER = new ObjectParser<>(NAME.getPreferredName(), true, Builder::new);
 
     static {
         PARSER.declareInt(Builder::setNNeighbors, N_NEIGHBORS);
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/AckWatchResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/AckWatchResponse.java
index 5c6750193a7c0..61245462dbecf 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/AckWatchResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/AckWatchResponse.java
@@ -45,7 +45,7 @@ public WatchStatus getStatus() {
     }
 
     private static final ParseField STATUS_FIELD = new ParseField("status");
-    private static ConstructingObjectParser<AckWatchResponse, Void> PARSER =
+    private static final ConstructingObjectParser<AckWatchResponse, Void> PARSER =
         new ConstructingObjectParser<>("ack_watch_response", true,
             a -> new AckWatchResponse((WatchStatus) a[0]));
 
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/ActivateWatchResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/ActivateWatchResponse.java
index b1e63e767f3be..d4dc044df647d 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/ActivateWatchResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/ActivateWatchResponse.java
@@ -32,7 +32,7 @@
 public final class ActivateWatchResponse {
 
     private static final ParseField STATUS_FIELD = new ParseField("status");
-    private static ConstructingObjectParser<ActivateWatchResponse, Void> PARSER =
+    private static final ConstructingObjectParser<ActivateWatchResponse, Void> PARSER =
         new ConstructingObjectParser<>("activate_watch_response", true,
             a -> new ActivateWatchResponse((WatchStatus) a[0]));
 
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/GetWatchResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/GetWatchResponse.java
index 83727003106e9..43a1a2a781520 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/GetWatchResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/GetWatchResponse.java
@@ -132,7 +132,7 @@ public int hashCode() {
     private static final ParseField STATUS_FIELD = new ParseField("status");
     private static final ParseField WATCH_FIELD = new ParseField("watch");
 
-    private static ConstructingObjectParser<GetWatchResponse, Void> PARSER =
+    private static final ConstructingObjectParser<GetWatchResponse, Void> PARSER =
         new ConstructingObjectParser<>("get_watch_response", true,
             a -> {
                 boolean isFound = (boolean) a[1];
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/WatcherStatsResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/WatcherStatsResponse.java
index 708954e666b5f..513adc8bd1478 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/WatcherStatsResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/watcher/WatcherStatsResponse.java
@@ -82,7 +82,7 @@ public String getClusterName() {
     }
 
     @SuppressWarnings("unchecked")
-    private static ConstructingObjectParser<WatcherStatsResponse, Void> PARSER =
+    private static final ConstructingObjectParser<WatcherStatsResponse, Void> PARSER =
         new ConstructingObjectParser<>("watcher_stats_response", true,
             a -> new WatcherStatsResponse((NodesResponseHeader) a[0], (String) a[1], new WatcherMetaData((boolean) a[2]),
                 (List<Node>) a[3]));
diff --git a/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java b/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
index 14fef43344644..ff796aba81d69 100644
--- a/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
+++ b/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
@@ -125,7 +125,7 @@ protected boolean isTransformTest() {
      * small number of tokens.
      */
     private static class CompareAnalyzers implements ExecutableSection {
-        private static ConstructingObjectParser<CompareAnalyzers, XContentLocation> PARSER =
+        private static final ConstructingObjectParser<CompareAnalyzers, XContentLocation> PARSER =
             new ConstructingObjectParser<>("test_analyzer", false, (a, location) -> {
                 String index = (String) a[0];
                 String first = (String) a[1];
diff --git a/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/ParsedMatrixStats.java b/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/ParsedMatrixStats.java
index ba28e0b0ee361..660ecc930982c 100644
--- a/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/ParsedMatrixStats.java
+++ b/modules/aggs-matrix-stats/src/main/java/org/elasticsearch/search/aggregations/matrix/stats/ParsedMatrixStats.java
@@ -187,7 +187,7 @@ static class ParsedMatrixStatsResult {
         Map<String, Double> covariances;
         Map<String, Double> correlations;
 
-        private static ObjectParser<ParsedMatrixStatsResult, Void> RESULT_PARSER =
+        private static final ObjectParser<ParsedMatrixStatsResult, Void> RESULT_PARSER =
                 new ObjectParser<>(ParsedMatrixStatsResult.class.getSimpleName(), true, ParsedMatrixStatsResult::new);
         static {
             RESULT_PARSER.declareString((result, name) -> result.name = name,
diff --git a/modules/mapper-extras/src/main/java/org/elasticsearch/index/query/RankFeatureQueryBuilder.java b/modules/mapper-extras/src/main/java/org/elasticsearch/index/query/RankFeatureQueryBuilder.java
index c934e0c1f79db..86990d95c42c6 100644
--- a/modules/mapper-extras/src/main/java/org/elasticsearch/index/query/RankFeatureQueryBuilder.java
+++ b/modules/mapper-extras/src/main/java/org/elasticsearch/index/query/RankFeatureQueryBuilder.java
@@ -260,7 +260,7 @@ private static ScoreFunction readScoreFunction(StreamInput in) throws IOExceptio
         }
     }
 
-    public static ConstructingObjectParser<RankFeatureQueryBuilder, Void> PARSER = new ConstructingObjectParser<>(
+    public static final ConstructingObjectParser<RankFeatureQueryBuilder, Void> PARSER = new ConstructingObjectParser<>(
             "feature", args -> {
                 final String field = (String) args[0];
                 final float boost = args[1] == null ? DEFAULT_BOOST : (Float) args[1];
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/allocation/ClusterAllocationExplainRequest.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/allocation/ClusterAllocationExplainRequest.java
index 0b0bb8c57a9b7..e1c5856e116a5 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/allocation/ClusterAllocationExplainRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/allocation/ClusterAllocationExplainRequest.java
@@ -37,7 +37,7 @@
  */
 public class ClusterAllocationExplainRequest extends MasterNodeRequest<ClusterAllocationExplainRequest> {
 
-    private static ObjectParser<ClusterAllocationExplainRequest, Void> PARSER = new ObjectParser<>("cluster/allocation/explain");
+    private static final ObjectParser<ClusterAllocationExplainRequest, Void> PARSER = new ObjectParser<>("cluster/allocation/explain");
     static {
         PARSER.declareString(ClusterAllocationExplainRequest::setIndex, new ParseField("index"));
         PARSER.declareInt(ClusterAllocationExplainRequest::setShard, new ParseField("shard"));
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverInfo.java b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverInfo.java
index edb8e3b16e7f4..6dec5ace786f9 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverInfo.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverInfo.java
@@ -44,7 +44,7 @@ public class RolloverInfo extends AbstractDiffable<RolloverInfo> implements Writ
     public static final ParseField TIME_FIELD = new ParseField("time");
 
     @SuppressWarnings("unchecked")
-    public static ConstructingObjectParser<RolloverInfo, String> PARSER = new ConstructingObjectParser<>("rollover_info", false,
+    public static final ConstructingObjectParser<RolloverInfo, String> PARSER = new ConstructingObjectParser<>("rollover_info", false,
         (a, alias) -> new RolloverInfo(alias, (List<Condition<?>>) a[0], (Long) a[1]));
     static {
         PARSER.declareNamedObjects(ConstructingObjectParser.constructorArg(),
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/validate/query/QueryExplanation.java b/server/src/main/java/org/elasticsearch/action/admin/indices/validate/query/QueryExplanation.java
index 61745d8c10602..d11a88fe50621 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/validate/query/QueryExplanation.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/validate/query/QueryExplanation.java
@@ -44,7 +44,7 @@ public class QueryExplanation implements Writeable, ToXContentFragment {
 
     public static final int RANDOM_SHARD = -1;
 
-    static ConstructingObjectParser<QueryExplanation, Void> PARSER = new ConstructingObjectParser<>(
+    static final ConstructingObjectParser<QueryExplanation, Void> PARSER = new ConstructingObjectParser<>(
         "query_explanation",
         true,
         a -> {
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/validate/query/ValidateQueryResponse.java b/server/src/main/java/org/elasticsearch/action/admin/indices/validate/query/ValidateQueryResponse.java
index 2489011fd3d73..9937d98c38ac3 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/validate/query/ValidateQueryResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/validate/query/ValidateQueryResponse.java
@@ -48,7 +48,7 @@ public class ValidateQueryResponse extends BroadcastResponse {
     public static final String EXPLANATIONS_FIELD = "explanations";
 
     @SuppressWarnings("unchecked")
-    static ConstructingObjectParser<ValidateQueryResponse, Void> PARSER = new ConstructingObjectParser<>(
+    static final ConstructingObjectParser<ValidateQueryResponse, Void> PARSER = new ConstructingObjectParser<>(
         "validate_query",
         true,
         arg -> {
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/BulkItemResponse.java b/server/src/main/java/org/elasticsearch/action/bulk/BulkItemResponse.java
index 616c4e5bd2830..bdf7abaa13d77 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/BulkItemResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/BulkItemResponse.java
@@ -176,7 +176,7 @@ public static class Failure implements Writeable, ToXContentFragment {
         private final long term;
         private final boolean aborted;
 
-        public static ConstructingObjectParser<Failure, Void> PARSER =
+        public static final ConstructingObjectParser<Failure, Void> PARSER =
             new ConstructingObjectParser<>(
                 "bulk_failures",
                 true,
diff --git a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
index 15598a2a88a5c..9631463c436c4 100644
--- a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
+++ b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
@@ -181,7 +181,7 @@ public static FieldCapabilities fromXContent(String name, XContentParser parser)
     }
 
     @SuppressWarnings("unchecked")
-    private static ConstructingObjectParser<FieldCapabilities, String> PARSER = new ConstructingObjectParser<>(
+    private static final ConstructingObjectParser<FieldCapabilities, String> PARSER = new ConstructingObjectParser<>(
         "field_capabilities",
         true,
         (a, name) -> new FieldCapabilities(name,
diff --git a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesRequest.java b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesRequest.java
index 442ed3f68ee9c..905384a76390a 100644
--- a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesRequest.java
@@ -49,7 +49,7 @@ public final class FieldCapabilitiesRequest extends ActionRequest implements Ind
     // pkg private API mainly for cross cluster search to signal that we do multiple reductions ie. the results should not be merged
     private boolean mergeResults = true;
 
-    private static ObjectParser<FieldCapabilitiesRequest, Void> PARSER =
+    private static final ObjectParser<FieldCapabilitiesRequest, Void> PARSER =
         new ObjectParser<>(NAME, FieldCapabilitiesRequest::new);
 
     static {
diff --git a/server/src/main/java/org/elasticsearch/common/geo/GeoJson.java b/server/src/main/java/org/elasticsearch/common/geo/GeoJson.java
index 5eb327588fb80..3dc8ecbab21fa 100644
--- a/server/src/main/java/org/elasticsearch/common/geo/GeoJson.java
+++ b/server/src/main/java/org/elasticsearch/common/geo/GeoJson.java
@@ -206,7 +206,7 @@ private XContentBuilder coordinatesToXContent(Polygon polygon) throws IOExceptio
         return builder.endObject();
     }
 
-    private static ConstructingObjectParser<Geometry, GeoJson> PARSER =
+    private static final ConstructingObjectParser<Geometry, GeoJson> PARSER =
         new ConstructingObjectParser<>("geojson", true, (a, c) -> {
             String type = (String) a[0];
             CoordinateNode coordinates = (CoordinateNode) a[1];
diff --git a/server/src/main/java/org/elasticsearch/index/query/IdsQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/IdsQueryBuilder.java
index def29b91a7f81..03a3fdfd646e6 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IdsQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IdsQueryBuilder.java
@@ -115,8 +115,7 @@ protected void doXContent(XContentBuilder builder, Params params) throws IOExcep
         builder.endObject();
     }
 
-    private static ObjectParser<IdsQueryBuilder, Void> PARSER = new ObjectParser<>(NAME,
-            () -> new IdsQueryBuilder());
+    private static final ObjectParser<IdsQueryBuilder, Void> PARSER = new ObjectParser<>(NAME, IdsQueryBuilder::new);
 
     static {
         PARSER.declareStringArray(fromList(String.class, IdsQueryBuilder::addIds), IdsQueryBuilder.VALUES_FIELD);
diff --git a/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreQueryBuilder.java
index e55c6d318777a..74e51ff09a683 100644
--- a/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/functionscore/ScriptScoreQueryBuilder.java
@@ -53,7 +53,7 @@ public class ScriptScoreQueryBuilder extends AbstractQueryBuilder<ScriptScoreQue
     public static final ParseField SCRIPT_FIELD = new ParseField("script");
     public static final ParseField MIN_SCORE_FIELD = new ParseField("min_score");
 
-    private static ConstructingObjectParser<ScriptScoreQueryBuilder, Void> PARSER = new ConstructingObjectParser<>(NAME, false,
+    private static final ConstructingObjectParser<ScriptScoreQueryBuilder, Void> PARSER = new ConstructingObjectParser<>(NAME, false,
         args -> {
             ScriptScoreQueryBuilder ssQueryBuilder = new ScriptScoreQueryBuilder((QueryBuilder) args[0], (Script) args[1]);
             if (args[2] != null) ssQueryBuilder.setMinScore((Float) args[2]);
diff --git a/server/src/main/java/org/elasticsearch/index/reindex/BulkByScrollTask.java b/server/src/main/java/org/elasticsearch/index/reindex/BulkByScrollTask.java
index 8df6620dabc3d..f60b6fc85e137 100644
--- a/server/src/main/java/org/elasticsearch/index/reindex/BulkByScrollTask.java
+++ b/server/src/main/java/org/elasticsearch/index/reindex/BulkByScrollTask.java
@@ -383,7 +383,7 @@ public static class Status implements Task.Status, SuccessfullyProcessed {
         }
 
         @SuppressWarnings("unchecked")
-        static ConstructingObjectParser<Tuple<Long, Long>, Void> RETRIES_PARSER = new ConstructingObjectParser<>(
+        static final ConstructingObjectParser<Tuple<Long, Long>, Void> RETRIES_PARSER = new ConstructingObjectParser<>(
             "bulk_by_scroll_task_status_retries",
             true,
             a -> new Tuple(a[0], a[1])
diff --git a/server/src/main/java/org/elasticsearch/index/seqno/RetentionLease.java b/server/src/main/java/org/elasticsearch/index/seqno/RetentionLease.java
index 9cfad7c36ea06..bf667cc29376c 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/RetentionLease.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/RetentionLease.java
@@ -145,7 +145,7 @@ public void writeTo(final StreamOutput out) throws IOException {
     private static final ParseField TIMESTAMP_FIELD = new ParseField("timestamp");
     private static final ParseField SOURCE_FIELD = new ParseField("source");
 
-    private static ConstructingObjectParser<RetentionLease, Void> PARSER = new ConstructingObjectParser<>(
+    private static final ConstructingObjectParser<RetentionLease, Void> PARSER = new ConstructingObjectParser<>(
             "retention_leases",
             (a) -> new RetentionLease((String) a[0], (Long) a[1], (Long) a[2], (String) a[3]));
 
diff --git a/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeases.java b/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeases.java
index 8c5c282a72d08..c46ba17a946f6 100644
--- a/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeases.java
+++ b/server/src/main/java/org/elasticsearch/index/seqno/RetentionLeases.java
@@ -182,7 +182,7 @@ public void writeTo(final StreamOutput out) throws IOException {
     private static final ParseField LEASES_FIELD = new ParseField("leases");
 
     @SuppressWarnings("unchecked")
-    private static ConstructingObjectParser<RetentionLeases, Void> PARSER = new ConstructingObjectParser<>(
+    private static final ConstructingObjectParser<RetentionLeases, Void> PARSER = new ConstructingObjectParser<>(
             "retention_leases",
             (a) -> new RetentionLeases((Long) a[0], (Long) a[1], (Collection<RetentionLease>) a[2]));
 
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptContextInfo.java b/server/src/main/java/org/elasticsearch/script/ScriptContextInfo.java
index f72b933ae886c..65bbcf2cded82 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptContextInfo.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptContextInfo.java
@@ -135,7 +135,7 @@ public List<ScriptMethodInfo> methods() {
     }
 
     @SuppressWarnings("unchecked")
-    public static ConstructingObjectParser<ScriptContextInfo,Void> PARSER =
+    public static final ConstructingObjectParser<ScriptContextInfo,Void> PARSER =
         new ConstructingObjectParser<>("script_context_info", true,
             (m, name) -> new ScriptContextInfo((String) m[0], (List<ScriptMethodInfo>) m[1])
         );
@@ -210,7 +210,7 @@ public void writeTo(StreamOutput out) throws IOException {
         }
 
         @SuppressWarnings("unchecked")
-        private static ConstructingObjectParser<ScriptMethodInfo,Void> PARSER =
+        private static final ConstructingObjectParser<ScriptMethodInfo,Void> PARSER =
             new ConstructingObjectParser<>("method", true,
                 (m, name) -> new ScriptMethodInfo((String) m[0], (String) m[1], (List<ParameterInfo>) m[2])
             );
@@ -271,7 +271,7 @@ public void writeTo(StreamOutput out) throws IOException {
                 out.writeString(name);
             }
 
-            private static ConstructingObjectParser<ParameterInfo,Void> PARSER =
+            private static final ConstructingObjectParser<ParameterInfo, Void> PARSER =
                 new ConstructingObjectParser<>("parameters", true,
                     (p) -> new ParameterInfo((String)p[0], (String)p[1])
             );
diff --git a/server/src/main/java/org/elasticsearch/script/ScriptLanguagesInfo.java b/server/src/main/java/org/elasticsearch/script/ScriptLanguagesInfo.java
index d8bfb4f499fe5..c5225c32caf04 100644
--- a/server/src/main/java/org/elasticsearch/script/ScriptLanguagesInfo.java
+++ b/server/src/main/java/org/elasticsearch/script/ScriptLanguagesInfo.java
@@ -98,7 +98,7 @@ public ScriptLanguagesInfo(StreamInput in) throws IOException {
     }
 
     @SuppressWarnings("unchecked")
-    public static ConstructingObjectParser<ScriptLanguagesInfo,Void> PARSER =
+    public static final ConstructingObjectParser<ScriptLanguagesInfo,Void> PARSER =
         new ConstructingObjectParser<>("script_languages_info", true,
             (a) -> new ScriptLanguagesInfo(
                 new HashSet<>((List<String>)a[0]),
@@ -107,7 +107,7 @@ public ScriptLanguagesInfo(StreamInput in) throws IOException {
         );
 
     @SuppressWarnings("unchecked")
-    private static ConstructingObjectParser<Tuple<String,Set<String>>,Void> LANGUAGE_CONTEXT_PARSER =
+    private static final ConstructingObjectParser<Tuple<String,Set<String>>,Void> LANGUAGE_CONTEXT_PARSER =
         new ConstructingObjectParser<>("language_contexts", true,
             (m, name) -> new Tuple<>((String)m[0], Set.copyOf((List<String>)m[1]))
         );
diff --git a/server/src/main/java/org/elasticsearch/search/SearchHit.java b/server/src/main/java/org/elasticsearch/search/SearchHit.java
index 209e1e1b78c74..448b19a34bc83 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchHit.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchHit.java
@@ -661,7 +661,7 @@ public XContentBuilder toInnerXContent(XContentBuilder builder, Params params) t
      * of the included search hit. The output of the map is used to create the
      * actual SearchHit instance via {@link #createFromMap(Map)}
      */
-    private static ObjectParser<Map<String, Object>, Void> MAP_PARSER = new ObjectParser<>("innerHitParser", true, HashMap::new);
+    private static final ObjectParser<Map<String, Object>, Void> MAP_PARSER = new ObjectParser<>("innerHitParser", true, HashMap::new);
 
     static {
         declareInnerHitsParseFields(MAP_PARSER);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/adjacency/ParsedAdjacencyMatrix.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/adjacency/ParsedAdjacencyMatrix.java
index 1fb356d45c28c..b07bbf529d23b 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/adjacency/ParsedAdjacencyMatrix.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/adjacency/ParsedAdjacencyMatrix.java
@@ -53,7 +53,7 @@ public ParsedBucket getBucketByKey(String key) {
         return bucketMap.get(key);
     }
 
-    private static ObjectParser<ParsedAdjacencyMatrix, Void> PARSER =
+    private static final ObjectParser<ParsedAdjacencyMatrix, Void> PARSER =
             new ObjectParser<>(ParsedAdjacencyMatrix.class.getSimpleName(), true, ParsedAdjacencyMatrix::new);
     static {
         declareMultiBucketAggregationFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/ParsedComposite.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/ParsedComposite.java
index e7d6f775f1d87..6dc42c7405d85 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/ParsedComposite.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/ParsedComposite.java
@@ -30,7 +30,7 @@
 import java.util.Map;
 
 public class ParsedComposite extends ParsedMultiBucketAggregation<ParsedComposite.ParsedBucket> implements CompositeAggregation {
-    private static ObjectParser<ParsedComposite, Void> PARSER =
+    private static final ObjectParser<ParsedComposite, Void> PARSER =
         new ObjectParser<>(ParsedComposite.class.getSimpleName(), true, ParsedComposite::new);
 
     static {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/filter/ParsedFilters.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/filter/ParsedFilters.java
index b2e9c36ccbee8..194c18cc4abb1 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/filter/ParsedFilters.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/filter/ParsedFilters.java
@@ -60,7 +60,7 @@ public ParsedBucket getBucketByKey(String key) {
         return bucketMap.get(key);
     }
 
-    private static ObjectParser<ParsedFilters, Void> PARSER =
+    private static final ObjectParser<ParsedFilters, Void> PARSER =
             new ObjectParser<>(ParsedFilters.class.getSimpleName(), true, ParsedFilters::new);
     static {
         declareMultiBucketAggregationFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/ParsedGeoHashGrid.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/ParsedGeoHashGrid.java
index b9af237eb6323..362c220fdff32 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/ParsedGeoHashGrid.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/ParsedGeoHashGrid.java
@@ -26,7 +26,7 @@
 
 public class ParsedGeoHashGrid extends ParsedGeoGrid {
 
-    private static ObjectParser<ParsedGeoGrid, Void> PARSER = createParser(ParsedGeoHashGrid::new,
+    private static final ObjectParser<ParsedGeoGrid, Void> PARSER = createParser(ParsedGeoHashGrid::new,
         ParsedGeoHashGridBucket::fromXContent, ParsedGeoHashGridBucket::fromXContent);
 
     public static ParsedGeoGrid fromXContent(XContentParser parser, String name) throws IOException {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/ParsedGeoTileGrid.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/ParsedGeoTileGrid.java
index e88c7ad305433..9e07d6af1dc0d 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/ParsedGeoTileGrid.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/ParsedGeoTileGrid.java
@@ -26,7 +26,7 @@
 
 public class ParsedGeoTileGrid extends ParsedGeoGrid {
 
-    private static ObjectParser<ParsedGeoGrid, Void> PARSER = createParser(ParsedGeoTileGrid::new,
+    private static final ObjectParser<ParsedGeoGrid, Void> PARSER = createParser(ParsedGeoTileGrid::new,
         ParsedGeoTileGridBucket::fromXContent, ParsedGeoTileGridBucket::fromXContent);
 
     public static ParsedGeoGrid fromXContent(XContentParser parser, String name) throws IOException {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
index 96e5641619caa..6d8afedbb2336 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
@@ -72,7 +72,7 @@ public class DateHistogramAggregationBuilder extends ValuesSourceAggregationBuil
         implements MultiBucketAggregationBuilder, DateIntervalConsumer {
 
     public static final String NAME = "date_histogram";
-    private static DateMathParser EPOCH_MILLIS_PARSER = DateFormatter.forPattern("epoch_millis").toDateMathParser();
+    private static final DateMathParser EPOCH_MILLIS_PARSER = DateFormatter.forPattern("epoch_millis").toDateMathParser();
 
     public static final Map<String, Rounding.DateTimeUnit> DATE_FIELD_UNITS = Map.ofEntries(
             entry("year", Rounding.DateTimeUnit.YEAR_OF_CENTURY),
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedAutoDateHistogram.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedAutoDateHistogram.java
index 66a29b4e05073..525591f55679b 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedAutoDateHistogram.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedAutoDateHistogram.java
@@ -52,7 +52,7 @@ public List<? extends Histogram.Bucket> getBuckets() {
         return buckets;
     }
 
-    private static ObjectParser<ParsedAutoDateHistogram, Void> PARSER =
+    private static final ObjectParser<ParsedAutoDateHistogram, Void> PARSER =
             new ObjectParser<>(ParsedAutoDateHistogram.class.getSimpleName(), true, ParsedAutoDateHistogram::new);
     static {
         declareMultiBucketAggregationFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedDateHistogram.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedDateHistogram.java
index 1cf43a53ed26c..e212ecc6fb479 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedDateHistogram.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedDateHistogram.java
@@ -41,7 +41,7 @@ public List<? extends Histogram.Bucket> getBuckets() {
         return buckets;
     }
 
-    private static ObjectParser<ParsedDateHistogram, Void> PARSER =
+    private static final ObjectParser<ParsedDateHistogram, Void> PARSER =
             new ObjectParser<>(ParsedDateHistogram.class.getSimpleName(), true, ParsedDateHistogram::new);
     static {
         declareMultiBucketAggregationFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedHistogram.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedHistogram.java
index 6037c1558867a..6e0caac936f37 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedHistogram.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ParsedHistogram.java
@@ -38,7 +38,7 @@ public List<? extends Histogram.Bucket> getBuckets() {
         return buckets;
     }
 
-    private static ObjectParser<ParsedHistogram, Void> PARSER =
+    private static final ObjectParser<ParsedHistogram, Void> PARSER =
             new ObjectParser<>(ParsedHistogram.class.getSimpleName(), true, ParsedHistogram::new);
     static {
         declareMultiBucketAggregationFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedBinaryRange.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedBinaryRange.java
index 79b1cd6cc0d09..4aadbb44a4832 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedBinaryRange.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedBinaryRange.java
@@ -45,7 +45,7 @@ public List<? extends Range.Bucket> getBuckets() {
         return buckets;
     }
 
-    private static ObjectParser<ParsedBinaryRange, Void> PARSER =
+    private static final ObjectParser<ParsedBinaryRange, Void> PARSER =
             new ObjectParser<>(ParsedBinaryRange.class.getSimpleName(), true, ParsedBinaryRange::new);
     static {
         declareMultiBucketAggregationFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedDateRange.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedDateRange.java
index d4504e245541b..3028aec4af24b 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedDateRange.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedDateRange.java
@@ -34,7 +34,7 @@ public String getType() {
         return DateRangeAggregationBuilder.NAME;
     }
 
-    private static ObjectParser<ParsedDateRange, Void> PARSER =
+    private static final ObjectParser<ParsedDateRange, Void> PARSER =
             new ObjectParser<>(ParsedDateRange.class.getSimpleName(), true, ParsedDateRange::new);
     static {
         declareParsedRangeFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedGeoDistance.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedGeoDistance.java
index 3a49a8e8de200..5d4afb1e3f093 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedGeoDistance.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedGeoDistance.java
@@ -31,7 +31,7 @@ public String getType() {
         return GeoDistanceAggregationBuilder.NAME;
     }
 
-    private static ObjectParser<ParsedGeoDistance, Void> PARSER =
+    private static final ObjectParser<ParsedGeoDistance, Void> PARSER =
             new ObjectParser<>(ParsedGeoDistance.class.getSimpleName(), true, ParsedGeoDistance::new);
     static {
         declareParsedRangeFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedRange.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedRange.java
index 6095348e68863..9546ff3784dbc 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedRange.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/range/ParsedRange.java
@@ -53,7 +53,7 @@ protected static void declareParsedRangeFields(final ObjectParser<? extends Pars
         declareMultiBucketAggregationFields(objectParser, bucketParser::apply, keyedBucketParser::apply);
     }
 
-    private static ObjectParser<ParsedRange, Void> PARSER =
+    private static final ObjectParser<ParsedRange, Void> PARSER =
             new ObjectParser<>(ParsedRange.class.getSimpleName(), true, ParsedRange::new);
     static {
         declareParsedRangeFields(PARSER,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/ParsedSignificantLongTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/ParsedSignificantLongTerms.java
index 9592d80c77625..f48d0680698c6 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/ParsedSignificantLongTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/ParsedSignificantLongTerms.java
@@ -32,7 +32,7 @@ public String getType() {
         return SignificantLongTerms.NAME;
     }
 
-    private static ObjectParser<ParsedSignificantLongTerms, Void> PARSER =
+    private static final ObjectParser<ParsedSignificantLongTerms, Void> PARSER =
             new ObjectParser<>(ParsedSignificantLongTerms.class.getSimpleName(), true, ParsedSignificantLongTerms::new);
     static {
         declareParsedSignificantTermsFields(PARSER, ParsedBucket::fromXContent);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/ParsedSignificantStringTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/ParsedSignificantStringTerms.java
index 365cc8b588aec..076aa74457fe3 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/ParsedSignificantStringTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/ParsedSignificantStringTerms.java
@@ -34,7 +34,7 @@ public String getType() {
         return SignificantStringTerms.NAME;
     }
 
-    private static ObjectParser<ParsedSignificantStringTerms, Void> PARSER =
+    private static final ObjectParser<ParsedSignificantStringTerms, Void> PARSER =
             new ObjectParser<>(ParsedSignificantStringTerms.class.getSimpleName(), true, ParsedSignificantStringTerms::new);
     static {
         declareParsedSignificantTermsFields(PARSER, ParsedBucket::fromXContent);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedDoubleTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedDoubleTerms.java
index d3afe5c17603f..02bc3e636bb47 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedDoubleTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedDoubleTerms.java
@@ -32,7 +32,7 @@ public String getType() {
         return DoubleTerms.NAME;
     }
 
-    private static ObjectParser<ParsedDoubleTerms, Void> PARSER =
+    private static final ObjectParser<ParsedDoubleTerms, Void> PARSER =
             new ObjectParser<>(ParsedDoubleTerms.class.getSimpleName(), true, ParsedDoubleTerms::new);
     static {
         declareParsedTermsFields(PARSER, ParsedBucket::fromXContent);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedLongTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedLongTerms.java
index b5869fc6ee2d8..07185abdcc03c 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedLongTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedLongTerms.java
@@ -32,7 +32,7 @@ public String getType() {
         return LongTerms.NAME;
     }
 
-    private static ObjectParser<ParsedLongTerms, Void> PARSER =
+    private static final ObjectParser<ParsedLongTerms, Void> PARSER =
             new ObjectParser<>(ParsedLongTerms.class.getSimpleName(), true, ParsedLongTerms::new);
     static {
         declareParsedTermsFields(PARSER, ParsedBucket::fromXContent);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedStringTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedStringTerms.java
index ecd88c871dfcc..29304ec1871bb 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedStringTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/ParsedStringTerms.java
@@ -34,7 +34,7 @@ public String getType() {
         return StringTerms.NAME;
     }
 
-    private static ObjectParser<ParsedStringTerms, Void> PARSER =
+    private static final ObjectParser<ParsedStringTerms, Void> PARSER =
             new ObjectParser<>(ParsedStringTerms.class.getSimpleName(), true, ParsedStringTerms::new);
     static {
         declareParsedTermsFields(PARSER, ParsedBucket::fromXContent);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedHDRPercentileRanks.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedHDRPercentileRanks.java
index eac1f2109056c..278f2423a432f 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedHDRPercentileRanks.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedHDRPercentileRanks.java
@@ -49,7 +49,7 @@ public Percentile next() {
         };
     }
 
-    private static ObjectParser<ParsedHDRPercentileRanks, Void> PARSER =
+    private static final ObjectParser<ParsedHDRPercentileRanks, Void> PARSER =
             new ObjectParser<>(ParsedHDRPercentileRanks.class.getSimpleName(), true, ParsedHDRPercentileRanks::new);
     static {
         ParsedPercentiles.declarePercentilesFields(PARSER);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedHDRPercentiles.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedHDRPercentiles.java
index bb34d8550d0ee..60f3a88734388 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedHDRPercentiles.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedHDRPercentiles.java
@@ -41,7 +41,7 @@ public String percentileAsString(double percent) {
         return getPercentileAsString(percent);
     }
 
-    private static ObjectParser<ParsedHDRPercentiles, Void> PARSER =
+    private static final ObjectParser<ParsedHDRPercentiles, Void> PARSER =
             new ObjectParser<>(ParsedHDRPercentiles.class.getSimpleName(), true, ParsedHDRPercentiles::new);
     static {
         ParsedPercentiles.declarePercentilesFields(PARSER);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTDigestPercentileRanks.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTDigestPercentileRanks.java
index f17bc8784aef4..f15dacd74c1a7 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTDigestPercentileRanks.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTDigestPercentileRanks.java
@@ -49,7 +49,7 @@ public Percentile next() {
         };
     }
 
-    private static ObjectParser<ParsedTDigestPercentileRanks, Void> PARSER =
+    private static final ObjectParser<ParsedTDigestPercentileRanks, Void> PARSER =
             new ObjectParser<>(ParsedTDigestPercentileRanks.class.getSimpleName(), true, ParsedTDigestPercentileRanks::new);
     static {
         ParsedPercentiles.declarePercentilesFields(PARSER);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTDigestPercentiles.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTDigestPercentiles.java
index 2453c702b9608..f7a876c16bf12 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTDigestPercentiles.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTDigestPercentiles.java
@@ -41,7 +41,7 @@ public String percentileAsString(double percent) {
         return getPercentileAsString(percent);
     }
 
-    private static ObjectParser<ParsedTDigestPercentiles, Void> PARSER =
+    private static final ObjectParser<ParsedTDigestPercentiles, Void> PARSER =
             new ObjectParser<>(ParsedTDigestPercentiles.class.getSimpleName(), true, ParsedTDigestPercentiles::new);
     static {
         ParsedPercentiles.declarePercentilesFields(PARSER);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTopHits.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTopHits.java
index 321ed5709e82f..ced2698a52a11 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTopHits.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ParsedTopHits.java
@@ -47,7 +47,7 @@ protected XContentBuilder doXContentBody(XContentBuilder builder, Params params)
         return searchHits.toXContent(builder, params);
     }
 
-    private static ObjectParser<ParsedTopHits, Void> PARSER =
+    private static final ObjectParser<ParsedTopHits, Void> PARSER =
             new ObjectParser<>(ParsedTopHits.class.getSimpleName(), true, ParsedTopHits::new);
     static {
         declareAggregationFields(PARSER);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/ParsedPercentilesBucket.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/ParsedPercentilesBucket.java
index 360ed9de214b0..93bc53f327947 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/ParsedPercentilesBucket.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/ParsedPercentilesBucket.java
@@ -73,7 +73,7 @@ public XContentBuilder doXContentBody(XContentBuilder builder, Params params) th
         return builder;
     }
 
-    private static ObjectParser<ParsedPercentilesBucket, Void> PARSER =
+    private static final ObjectParser<ParsedPercentilesBucket, Void> PARSER =
             new ObjectParser<>(ParsedPercentilesBucket.class.getSimpleName(), true, ParsedPercentilesBucket::new);
 
     static {
diff --git a/server/src/main/java/org/elasticsearch/search/sort/FieldSortBuilder.java b/server/src/main/java/org/elasticsearch/search/sort/FieldSortBuilder.java
index ba03e058a37b9..7a7cf1437888d 100644
--- a/server/src/main/java/org/elasticsearch/search/sort/FieldSortBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/sort/FieldSortBuilder.java
@@ -563,7 +563,7 @@ public static FieldSortBuilder fromXContent(XContentParser parser, String fieldN
         return PARSER.parse(parser, new FieldSortBuilder(fieldName), null);
     }
 
-    private static ObjectParser<FieldSortBuilder, Void> PARSER = new ObjectParser<>(NAME);
+    private static final ObjectParser<FieldSortBuilder, Void> PARSER = new ObjectParser<>(NAME);
 
     static {
         PARSER.declareField(FieldSortBuilder::missing, p -> p.objectText(),  MISSING, ValueType.VALUE);
diff --git a/server/src/main/java/org/elasticsearch/search/sort/ScoreSortBuilder.java b/server/src/main/java/org/elasticsearch/search/sort/ScoreSortBuilder.java
index c27979fdc748e..112a5eb2c8c96 100644
--- a/server/src/main/java/org/elasticsearch/search/sort/ScoreSortBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/sort/ScoreSortBuilder.java
@@ -86,7 +86,7 @@ public static ScoreSortBuilder fromXContent(XContentParser parser, String fieldN
         return PARSER.apply(parser, null);
     }
 
-    private static ObjectParser<ScoreSortBuilder, Void> PARSER = new ObjectParser<>(NAME, ScoreSortBuilder::new);
+    private static final ObjectParser<ScoreSortBuilder, Void> PARSER = new ObjectParser<>(NAME, ScoreSortBuilder::new);
 
     static {
         PARSER.declareString((builder, order) -> builder.order(SortOrder.fromString(order)), ORDER_FIELD);
diff --git a/server/src/main/java/org/elasticsearch/search/sort/ScriptSortBuilder.java b/server/src/main/java/org/elasticsearch/search/sort/ScriptSortBuilder.java
index 6cf33830b0453..af766ec463711 100644
--- a/server/src/main/java/org/elasticsearch/search/sort/ScriptSortBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/sort/ScriptSortBuilder.java
@@ -204,7 +204,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params builderParams)
         return builder;
     }
 
-    private static ConstructingObjectParser<ScriptSortBuilder, Void> PARSER = new ConstructingObjectParser<>(NAME,
+    private static final ConstructingObjectParser<ScriptSortBuilder, Void> PARSER = new ConstructingObjectParser<>(NAME,
             a -> new ScriptSortBuilder((Script) a[0], (ScriptSortType) a[1]));
 
     static {
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/completion/CompletionSuggestion.java b/server/src/main/java/org/elasticsearch/search/suggest/completion/CompletionSuggestion.java
index d9be0c3a4938b..0115ec79b435f 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/completion/CompletionSuggestion.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/completion/CompletionSuggestion.java
@@ -260,9 +260,8 @@ protected Option newOption(StreamInput in) throws IOException {
             return new Option(in);
         }
 
-        private static ObjectParser<Entry, Void> PARSER = new ObjectParser<>("CompletionSuggestionEntryParser", true,
+        private static final ObjectParser<Entry, Void> PARSER = new ObjectParser<>("CompletionSuggestionEntryParser", true,
                 Entry::new);
-
         static {
             declareCommonFields(PARSER);
             PARSER.declareObjectArray(Entry::addOptions, (p,c) -> Option.fromXContent(p), new ParseField(OPTIONS));
@@ -353,7 +352,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
                 return builder;
             }
 
-            private static ObjectParser<Map<String, Object>, Void> PARSER = new ObjectParser<>("CompletionOptionParser",
+            private static final ObjectParser<Map<String, Object>, Void> PARSER = new ObjectParser<>("CompletionOptionParser",
                     true, HashMap::new);
 
             static {
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/completion/context/CategoryQueryContext.java b/server/src/main/java/org/elasticsearch/search/suggest/completion/context/CategoryQueryContext.java
index e391f78f27c50..9326e0ff666f7 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/completion/context/CategoryQueryContext.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/completion/context/CategoryQueryContext.java
@@ -95,7 +95,7 @@ public int hashCode() {
         return result;
     }
 
-    private static ObjectParser<Builder, Void> CATEGORY_PARSER = new ObjectParser<>(NAME, null);
+    private static final ObjectParser<Builder, Void> CATEGORY_PARSER = new ObjectParser<>(NAME, null);
     static {
         CATEGORY_PARSER.declareField(Builder::setCategory, XContentParser::text, new ParseField(CONTEXT_VALUE),
                 ObjectParser.ValueType.VALUE);
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/completion/context/GeoQueryContext.java b/server/src/main/java/org/elasticsearch/search/suggest/completion/context/GeoQueryContext.java
index 7885dd1d29674..439fa161d3897 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/completion/context/GeoQueryContext.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/completion/context/GeoQueryContext.java
@@ -112,7 +112,7 @@ public static Builder builder() {
         return new Builder();
     }
 
-    private static ObjectParser<GeoQueryContext.Builder, Void> GEO_CONTEXT_PARSER = new ObjectParser<>(NAME, null);
+    private static final ObjectParser<GeoQueryContext.Builder, Void> GEO_CONTEXT_PARSER = new ObjectParser<>(NAME, null);
     static {
         GEO_CONTEXT_PARSER.declareField((parser, geoQueryContext,
                 geoContextMapping) -> geoQueryContext.setGeoPoint(GeoUtils.parseGeoPoint(parser)),
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/phrase/PhraseSuggestion.java b/server/src/main/java/org/elasticsearch/search/suggest/phrase/PhraseSuggestion.java
index a29c6f08a7d8b..fe7c03b11b1ec 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/phrase/PhraseSuggestion.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/phrase/PhraseSuggestion.java
@@ -120,8 +120,7 @@ public void addOption(Option option) {
             }
         }
 
-        private static ObjectParser<Entry, Void> PARSER = new ObjectParser<>("PhraseSuggestionEntryParser", true, Entry::new);
-
+        private static final ObjectParser<Entry, Void> PARSER = new ObjectParser<>("PhraseSuggestionEntryParser", true, Entry::new);
         static {
             declareCommonFields(PARSER);
             PARSER.declareObjectArray(Entry::addOptions, (p, c) -> Option.fromXContent(p), new ParseField(OPTIONS));
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/term/TermSuggestion.java b/server/src/main/java/org/elasticsearch/search/suggest/term/TermSuggestion.java
index b6afaf4ba964b..665c95cd47eb3 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/term/TermSuggestion.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/term/TermSuggestion.java
@@ -179,8 +179,7 @@ protected Option newOption(StreamInput in) throws IOException {
             return new Option(in);
         }
 
-        private static ObjectParser<Entry, Void> PARSER = new ObjectParser<>("TermSuggestionEntryParser", true, Entry::new);
-
+        private static final ObjectParser<Entry, Void> PARSER = new ObjectParser<>("TermSuggestionEntryParser", true, Entry::new);
         static {
             declareCommonFields(PARSER);
             PARSER.declareObjectArray(Entry::addOptions, (p,c) -> Option.fromXContent(p), new ParseField(OPTIONS));
diff --git a/server/src/test/java/org/elasticsearch/common/geo/GeoJsonSerializationTests.java b/server/src/test/java/org/elasticsearch/common/geo/GeoJsonSerializationTests.java
index 7d1ff1bfc580f..e3974872dee69 100644
--- a/server/src/test/java/org/elasticsearch/common/geo/GeoJsonSerializationTests.java
+++ b/server/src/test/java/org/elasticsearch/common/geo/GeoJsonSerializationTests.java
@@ -47,7 +47,7 @@ public class GeoJsonSerializationTests extends ESTestCase {
     private static class GeometryWrapper implements ToXContentObject {
 
         private Geometry geometry;
-        private static GeoJson PARSER = new GeoJson(true, false, new GeographyValidator(true));
+        private static final GeoJson PARSER = new GeoJson(true, false, new GeographyValidator(true));
 
         GeometryWrapper(Geometry geometry) {
             this.geometry = geometry;

From e8bd6261d1a268a03124a9c743c7916e6360b126 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 3 Jan 2020 11:55:02 -0500
Subject: [PATCH 376/686] Use Void context on parsers where possible (#50573)

*Most* of our parsing can be done without passing any extra context into
the parser that isn't already part of the xcontent stream. While I was
looking around at the places that *do* need a context I found a few
places that were declared to need a context but don't actually need it.
---
 .../reindex/remote/RemoteResponseParsers.java      | 14 +++++++-------
 .../reindex/remote/RemoteResponseParsersTests.java |  3 +--
 .../searchbusinessrules/PinnedQueryBuilder.java    |  2 +-
 .../xpack/sql/action/SqlClearCursorRequest.java    |  9 +++++----
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/modules/reindex/src/main/java/org/elasticsearch/index/reindex/remote/RemoteResponseParsers.java b/modules/reindex/src/main/java/org/elasticsearch/index/reindex/remote/RemoteResponseParsers.java
index 1029b76d0f94b..efa81aab6dc82 100644
--- a/modules/reindex/src/main/java/org/elasticsearch/index/reindex/remote/RemoteResponseParsers.java
+++ b/modules/reindex/src/main/java/org/elasticsearch/index/reindex/remote/RemoteResponseParsers.java
@@ -124,7 +124,7 @@ class Fields {
     /**
      * Parser for {@code failed} shards in the {@code _shards} elements.
      */
-    public static final ConstructingObjectParser<SearchFailure, XContentType> SEARCH_FAILURE_PARSER =
+    public static final ConstructingObjectParser<SearchFailure, Void> SEARCH_FAILURE_PARSER =
             new ConstructingObjectParser<>("failure", true, a -> {
                 int i = 0;
                 String index = (String) a[i++];
@@ -146,7 +146,7 @@ class Fields {
         SEARCH_FAILURE_PARSER.declareString(optionalConstructorArg(), new ParseField("node"));
         SEARCH_FAILURE_PARSER.declareField(constructorArg(), (p, c) -> {
             if (p.currentToken() == XContentParser.Token.START_OBJECT) {
-                return ThrowableBuilder.PARSER.apply(p, c);
+                return ThrowableBuilder.PARSER.apply(p, null);
             } else {
                 return p.text();
             }
@@ -157,7 +157,7 @@ class Fields {
      * Parser for the {@code _shards} element. Throws everything out except the errors array if there is one. If there isn't one then it
      * parses to an empty list.
      */
-    public static final ConstructingObjectParser<List<Throwable>, XContentType> SHARDS_PARSER =
+    public static final ConstructingObjectParser<List<Throwable>, Void> SHARDS_PARSER =
             new ConstructingObjectParser<>("_shards", true, a -> {
                 @SuppressWarnings("unchecked")
                 List<Throwable> failures = (List<Throwable>) a[0];
@@ -196,20 +196,20 @@ class Fields {
                 return new Response(timedOut, failures, totalHits, hits, scroll);
             });
     static {
-        RESPONSE_PARSER.declareObject(optionalConstructorArg(), ThrowableBuilder.PARSER::apply, new ParseField("error"));
+        RESPONSE_PARSER.declareObject(optionalConstructorArg(), (p, c) -> ThrowableBuilder.PARSER.apply(p, null), new ParseField("error"));
         RESPONSE_PARSER.declareBoolean(optionalConstructorArg(), new ParseField("timed_out"));
         RESPONSE_PARSER.declareString(optionalConstructorArg(), new ParseField("_scroll_id"));
         RESPONSE_PARSER.declareObject(optionalConstructorArg(), HITS_PARSER, new ParseField("hits"));
-        RESPONSE_PARSER.declareObject(optionalConstructorArg(), SHARDS_PARSER, new ParseField("_shards"));
+        RESPONSE_PARSER.declareObject(optionalConstructorArg(), (p, c) -> SHARDS_PARSER.apply(p, null), new ParseField("_shards"));
     }
 
     /**
      * Collects stuff about Throwables and attempts to rebuild them.
      */
     public static class ThrowableBuilder {
-        public static final BiFunction<XContentParser, XContentType, Throwable> PARSER;
+        public static final BiFunction<XContentParser, Void, Throwable> PARSER;
         static {
-            ObjectParser<ThrowableBuilder, XContentType> parser = new ObjectParser<>("reason", true, ThrowableBuilder::new);
+            ObjectParser<ThrowableBuilder, Void> parser = new ObjectParser<>("reason", true, ThrowableBuilder::new);
             PARSER = parser.andThen(ThrowableBuilder::build);
             parser.declareString(ThrowableBuilder::setType, new ParseField("type"));
             parser.declareString(ThrowableBuilder::setReason, new ParseField("reason"));
diff --git a/modules/reindex/src/test/java/org/elasticsearch/index/reindex/remote/RemoteResponseParsersTests.java b/modules/reindex/src/test/java/org/elasticsearch/index/reindex/remote/RemoteResponseParsersTests.java
index f5b406f779a9e..61a8320696439 100644
--- a/modules/reindex/src/test/java/org/elasticsearch/index/reindex/remote/RemoteResponseParsersTests.java
+++ b/modules/reindex/src/test/java/org/elasticsearch/index/reindex/remote/RemoteResponseParsersTests.java
@@ -24,7 +24,6 @@
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.reindex.ScrollableHitSource;
 import org.elasticsearch.test.ESTestCase;
 import org.hamcrest.Matchers;
@@ -43,7 +42,7 @@ public void testFailureWithoutIndex() throws IOException {
         XContentBuilder builder = jsonBuilder();
         failure.toXContent(builder, ToXContent.EMPTY_PARAMS);
         try (XContentParser parser = createParser(builder)) {
-            ScrollableHitSource.SearchFailure parsed = RemoteResponseParsers.SEARCH_FAILURE_PARSER.parse(parser, XContentType.JSON);
+            ScrollableHitSource.SearchFailure parsed = RemoteResponseParsers.SEARCH_FAILURE_PARSER.parse(parser, null);
             assertNotNull(parsed.getReason());
             assertThat(parsed.getReason().getMessage(), Matchers.containsString("exhausted"));
             assertThat(parsed.getReason(), Matchers.instanceOf(EsRejectedExecutionException.class));
diff --git a/x-pack/plugin/search-business-rules/src/main/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilder.java b/x-pack/plugin/search-business-rules/src/main/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilder.java
index 5e2adc5c67440..5cca38245ce71 100644
--- a/x-pack/plugin/search-business-rules/src/main/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilder.java
+++ b/x-pack/plugin/search-business-rules/src/main/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilder.java
@@ -133,7 +133,7 @@ protected void doXContent(XContentBuilder builder, Params params) throws IOExcep
     
     
     
-    private static final ConstructingObjectParser<PinnedQueryBuilder, XContentParser> PARSER = new ConstructingObjectParser<>(NAME,
+    private static final ConstructingObjectParser<PinnedQueryBuilder, Void> PARSER = new ConstructingObjectParser<>(NAME,
             a -> 
                 {
                     QueryBuilder organicQuery = (QueryBuilder) a[0];
diff --git a/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlClearCursorRequest.java b/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlClearCursorRequest.java
index 4d5cc1734333f..563b1fe7cf886 100644
--- a/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlClearCursorRequest.java
+++ b/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlClearCursorRequest.java
@@ -19,16 +19,17 @@
 
 import static org.elasticsearch.action.ValidateActions.addValidationError;
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
+import static org.elasticsearch.xpack.sql.action.AbstractSqlQueryRequest.CLIENT_ID;
 import static org.elasticsearch.xpack.sql.action.AbstractSqlQueryRequest.CURSOR;
 import static org.elasticsearch.xpack.sql.action.AbstractSqlQueryRequest.MODE;
-import static org.elasticsearch.xpack.sql.action.AbstractSqlQueryRequest.CLIENT_ID;
 
 /**
  * Request to clean all SQL resources associated with the cursor
  */
 public class SqlClearCursorRequest extends AbstractSqlRequest {
 
-    private static final ConstructingObjectParser<SqlClearCursorRequest, RequestInfo> PARSER =
+    private static final ConstructingObjectParser<SqlClearCursorRequest, Void> PARSER =
         // here the position in "objects" is the same as the fields parser declarations below 
         new ConstructingObjectParser<>(SqlClearCursorAction.NAME, objects -> {
             RequestInfo requestInfo = new RequestInfo(Mode.fromString((String) objects[1]),
@@ -39,8 +40,8 @@ public class SqlClearCursorRequest extends AbstractSqlRequest {
     static {
         // "cursor" is required constructor parameter
         PARSER.declareString(constructorArg(), CURSOR);
-        PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), MODE);
-        PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), CLIENT_ID);
+        PARSER.declareString(optionalConstructorArg(), MODE);
+        PARSER.declareString(optionalConstructorArg(), CLIENT_ID);
     }
 
     private String cursor;

From bafbc235d59c6304a4bb06d4f7f63c664b2a116b Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 3 Jan 2020 11:58:29 -0500
Subject: [PATCH 377/686] x-content: Support collapsed named objects (#50564)

This adds support for "collapsed" named object to `ObjectParser`. In
particular, this supports the sort of xcontent that we use to specify
significance heuristics. See #25519 and this example:

```
GET /_search
{
    "query" : {
        "terms" : {"force" : [ "British Transport Police" ]}
    },
    "aggregations" : {
        "significant_crime_types" : {
            "significant_terms" : {
                "field" : "crime_type",
                "mutual_information" : { <<------- This is the name
                    "include_negatives": true
                }
            }
        }
    }
}
```

I believe there are a couple of things that work this way.

I've held off on moving the actual parsing of the significant heuristics
to this code to keep the review more compact. The moving is pretty
mechanical stuff in the aggs framework.
---
 .../common/xcontent/ObjectParser.java         | 42 +++++++++++++--
 .../xcontent/XContentParseException.java      |  8 ++-
 .../common/xcontent/ObjectParserTests.java    | 52 +++++++++++++++++++
 3 files changed, 96 insertions(+), 6 deletions(-)

diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
index c80c5bdb0d09a..09a997e7a1516 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
@@ -130,21 +130,36 @@ private static <Value, Context> UnknownFieldParser<Value, Context> consumeUnknow
         };
     }
 
+    private static <Value, Category, Context> UnknownFieldParser<Value, Context> unknownIsNamedXContent(
+        Class<Category> categoryClass,
+        BiConsumer<Value, ? super Category> consumer
+    ) {
+        return (parserName, field, location, parser, value, context) -> {
+            Category o;
+            try {
+                o = parser.namedObject(categoryClass, field, context);
+            } catch (NamedObjectNotFoundException e) {
+                throw new XContentParseException(location, "[" + parserName  + "] " + e.getBareMessage(), e);
+            }
+            consumer.accept(value, o);
+        };
+    }
+
     private final Map<String, FieldParser> fieldParserMap = new HashMap<>();
     private final String name;
     private final Supplier<Value> valueSupplier;
-
     private final UnknownFieldParser<Value, Context> unknownFieldParser;
 
     /**
-     * Creates a new ObjectParser instance with a name. This name is used to reference the parser in exceptions and messages.
+     * Creates a new ObjectParser.
+     * @param name the parsers name, used to reference the parser in exceptions and messages.
      */
     public ObjectParser(String name) {
         this(name, null);
     }
 
     /**
-     * Creates a new ObjectParser instance with a name.
+     * Creates a new ObjectParser.
      * @param name the parsers name, used to reference the parser in exceptions and messages.
      * @param valueSupplier a supplier that creates a new Value instance used when the parser is used as an inner object parser.
      */
@@ -153,7 +168,7 @@ public ObjectParser(String name, @Nullable Supplier<Value> valueSupplier) {
     }
 
     /**
-     * Creates a new ObjectParser instance with a name.
+     * Creates a new ObjectParser.
      * @param name the parsers name, used to reference the parser in exceptions and messages.
      * @param ignoreUnknownFields Should this parser ignore unknown fields? This should generally be set to true only when parsing
      *      responses from external systems, never when parsing requests from users.
@@ -164,7 +179,7 @@ public ObjectParser(String name, boolean ignoreUnknownFields, @Nullable Supplier
     }
 
     /**
-     * Creates a new ObjectParser instance with a name.
+     * Creates a new ObjectParser that consumes unknown fields as generic Objects.
      * @param name the parsers name, used to reference the parser in exceptions and messages.
      * @param unknownFieldConsumer how to consume parsed unknown fields
      * @param valueSupplier a supplier that creates a new Value instance used when the parser is used as an inner object parser.
@@ -173,6 +188,23 @@ public ObjectParser(String name, UnknownFieldConsumer<Value> unknownFieldConsume
         this(name, consumeUnknownField(unknownFieldConsumer), valueSupplier);
     }
 
+    /**
+     * Creates a new ObjectParser that attempts to resolve unknown fields as {@link XContentParser#namedObject namedObjects}.
+     * @param <C> the type of named object that unknown fields are expected to be
+     * @param name the parsers name, used to reference the parser in exceptions and messages.
+     * @param categoryClass the type of named object that unknown fields are expected to be
+     * @param unknownFieldConsumer how to consume parsed unknown fields
+     * @param valueSupplier a supplier that creates a new Value instance used when the parser is used as an inner object parser.
+     */
+    public <C> ObjectParser(
+        String name,
+        Class<C> categoryClass,
+        BiConsumer<Value, C> unknownFieldConsumer,
+        @Nullable Supplier<Value> valueSupplier
+    ) {
+        this(name, unknownIsNamedXContent(categoryClass, unknownFieldConsumer), valueSupplier);
+    }
+
     /**
      * Creates a new ObjectParser instance with a name.
      * @param name the parsers name, used to reference the parser in exceptions and messages.
diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentParseException.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentParseException.java
index 69c345d20c2a6..cf9d4ed6713d9 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentParseException.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentParseException.java
@@ -59,7 +59,13 @@ public XContentLocation getLocation() {
 
     @Override
     public String getMessage() {
-        return location.map(l -> "[" + l.toString() + "] ").orElse("") + super.getMessage();
+        return location.map(l -> "[" + l.toString() + "] ").orElse("") + getBareMessage();
     }
 
+    /**
+     * Get the exception message without location information.
+     */
+    public String getBareMessage() {
+        return super.getMessage();
+    }
 }
diff --git a/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java b/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
index a2c45eceb8d58..fb5db61935a27 100644
--- a/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
+++ b/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
@@ -753,4 +753,56 @@ public void testConsumeUnknownFields() throws IOException {
         assertEquals(List.of(1, 2, 3, 4), o.fields.get("test_array"));
         assertEquals(Map.of("field", "value", "field2", List.of("list1", "list2")), o.fields.get("test_nested"));
     }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(Arrays.asList(
+            new NamedXContentRegistry.Entry(Object.class, new ParseField("str"), p -> p.text()),
+            new NamedXContentRegistry.Entry(Object.class, new ParseField("int"), p -> p.intValue()),
+            new NamedXContentRegistry.Entry(Object.class, new ParseField("float"), p -> p.floatValue()),
+            new NamedXContentRegistry.Entry(Object.class, new ParseField("bool"), p -> p.booleanValue())
+        ));
+    }
+
+    private static class TopLevelNamedXConent {
+        public static final ObjectParser<TopLevelNamedXConent, Void> PARSER = new ObjectParser<>(
+            "test", Object.class, TopLevelNamedXConent::setNamed, TopLevelNamedXConent::new
+        );
+
+        Object named;
+        void setNamed(Object named) {
+            if (this.named != null) {
+                throw new IllegalArgumentException("Only one [named] allowed!");
+            }
+            this.named = named;
+        }
+    }
+
+    public void testTopLevelNamedXContent() throws IOException {
+        {
+            XContentParser parser = createParser(JsonXContent.jsonXContent, "{\"str\": \"foo\"}");
+            TopLevelNamedXConent o = TopLevelNamedXConent.PARSER.parse(parser, null);
+            assertEquals("foo", o.named);
+        }
+        {
+            XContentParser parser = createParser(JsonXContent.jsonXContent, "{\"int\": 1}");
+            TopLevelNamedXConent o = TopLevelNamedXConent.PARSER.parse(parser, null);
+            assertEquals(1, o.named);
+        }
+        {
+            XContentParser parser = createParser(JsonXContent.jsonXContent, "{\"float\": 4.0}");
+            TopLevelNamedXConent o = TopLevelNamedXConent.PARSER.parse(parser, null);
+            assertEquals(4.0F, o.named);
+        }
+        {
+            XContentParser parser = createParser(JsonXContent.jsonXContent, "{\"bool\": false}");
+            TopLevelNamedXConent o = TopLevelNamedXConent.PARSER.parse(parser, null);
+            assertEquals(false, o.named);
+        }
+        {
+            XContentParser parser = createParser(JsonXContent.jsonXContent, "{\"not_supported_field\" : \"foo\"}");
+            XContentParseException ex = expectThrows(XContentParseException.class, () -> TopLevelNamedXConent.PARSER.parse(parser, null));
+            assertEquals("[1:2] [test] unable to parse Object with name [not_supported_field]: parser not found", ex.getMessage());
+        }
+    }
 }

From 16535e84c35cf1342829fdcdb3d739c95438c6f3 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Fri, 3 Jan 2020 09:07:08 -0800
Subject: [PATCH 378/686] [DOCS] Adds missing timing_stats descriptions
 (#50574)

---
 .../anomaly-detection/apis/get-datafeed-stats.asciidoc   | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
index 695c16761a623..21a907a703c9a 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
@@ -96,9 +96,12 @@ re-started.
 `timing_stats`::
 (object) An object that provides statistical information about timing aspect of
 this {dfeed}.
-//average_search_time_per_bucket_ms
-//bucket_count
-//exponential_average_search_time_per_hour_ms
+`timing_stats`.`average_search_time_per_bucket_ms`:::
+(double) Average of the {dfeed} search times in milliseconds.
+`timing_stats`.`bucket_count`:::
+(long) The number of buckets processed. 
+`timing_stats`.`exponential_average_search_time_per_hour_ms`:::
+(double) Exponential moving average of the {dfeed} search times in milliseconds.
 `timing_stats`.`job_id`:::
 include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 `timing_stats`.`search_count`::: Number of searches performed by this {dfeed}.

From 4a6f4269b8433bdd526b6fa6f69537081c1ff8a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Fri, 3 Jan 2020 18:25:02 +0100
Subject: [PATCH 379/686] Mute
 TimeSeriesLifecycleActionsIT.testHistoryIsWrittenWithSuccess

Also muting TimeSeriesLifecycleActionsIT.testHistoryIsWrittenWithFailure.

Tracked in #50353
---
 .../xpack/ilm/TimeSeriesLifecycleActionsIT.java            | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 7cb8d92789169..16ef7a9639542 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1085,6 +1085,7 @@ public void testRolloverStepRetriesUntilRolledOverIndexIsDeleted() throws Except
         assertBusy(() -> assertThat(getStepKeyForIndex(index), equalTo(TerminalPolicyStep.KEY)));
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithSuccess() throws Exception {
         String index = "index";
 
@@ -1127,6 +1128,8 @@ public void testHistoryIsWrittenWithSuccess() throws Exception {
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-000002", true, "check-rollover-ready"), 30, TimeUnit.SECONDS);
     }
 
+
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithFailure() throws Exception {
         String index = "index";
 
@@ -1361,7 +1364,9 @@ private static StepKey getStepKey(Map<String, Object> explainIndexResponse) {
 
     private String getFailedStepForIndex(String indexName) throws IOException {
         Map<String, Object> indexResponse = explainIndex(indexName);
-        if (indexResponse == null) return null;
+        if (indexResponse == null) {
+            return null;
+        }
 
         return (String) indexResponse.get("failed_step");
     }

From 6ce4ed9655bd32bcfcf9f7528ef9471c039f97ee Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 3 Jan 2020 20:46:00 +0100
Subject: [PATCH 380/686] Make EC2 Discovery Cache Empty Seed Hosts List
 (#50607)

Follow up to #50550. Cache empty nodes lists (`fetchDynamicNodes` will return an empty list in case of failure)
now that the plugin properly retries requests to AWS EC2 APIs.
---
 .../discovery/ec2/AwsEc2SeedHostsProvider.java      | 13 ++-----------
 .../discovery/ec2/Ec2DiscoveryTests.java            |  4 ++--
 2 files changed, 4 insertions(+), 13 deletions(-)

diff --git a/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2SeedHostsProvider.java b/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2SeedHostsProvider.java
index 515aef8408b01..dd4ef02c0b318 100644
--- a/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2SeedHostsProvider.java
+++ b/plugins/discovery-ec2/src/main/java/org/elasticsearch/discovery/ec2/AwsEc2SeedHostsProvider.java
@@ -53,7 +53,7 @@
 import static org.elasticsearch.discovery.ec2.AwsEc2Service.HostType.TAG_PREFIX;
 
 class AwsEc2SeedHostsProvider implements SeedHostsProvider {
-    
+
     private static final Logger logger = LogManager.getLogger(AwsEc2SeedHostsProvider.class);
 
     private final TransportService transportService;
@@ -221,22 +221,13 @@ private DescribeInstancesRequest buildDescribeInstancesRequest() {
 
     private final class TransportAddressesCache extends SingleObjectCache<List<TransportAddress>> {
 
-        private boolean empty = true;
-
         protected TransportAddressesCache(TimeValue refreshInterval) {
             super(refreshInterval,  new ArrayList<>());
         }
 
-        @Override
-        protected boolean needsRefresh() {
-            return (empty || super.needsRefresh());
-        }
-
         @Override
         protected List<TransportAddress> refresh() {
-            final List<TransportAddress> nodes = fetchDynamicNodes();
-            empty = nodes.isEmpty();
-            return nodes;
+            return fetchDynamicNodes();
         }
     }
 }
diff --git a/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/Ec2DiscoveryTests.java b/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/Ec2DiscoveryTests.java
index 6703812a4ec0c..ba31848464310 100644
--- a/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/Ec2DiscoveryTests.java
+++ b/plugins/discovery-ec2/src/test/java/org/elasticsearch/discovery/ec2/Ec2DiscoveryTests.java
@@ -306,10 +306,10 @@ protected List<TransportAddress> fetchDynamicNodes() {
                 return new ArrayList<>();
             }
         };
-        for (int i=0; i<3; i++) {
+        for (int i = 0; i < 3; i++) {
             provider.getSeedAddresses(null);
         }
-        assertThat(provider.fetchCount, is(3));
+        assertThat(provider.fetchCount, is(1));
     }
 
     public void testGetNodeListCached() throws Exception {

From 9f47b06deedfe7d36443d4b96db338a7e7c55c6e Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Sun, 5 Jan 2020 14:42:34 -0500
Subject: [PATCH 381/686] Clean up wire test case a bit (#50627)

* Adds JavaDoc to `AbstractWireTestCase` and
`AbstractWireSerializingTestCase` so it is more obvious you should prefer
the latter if you have a choice
* Moves the `instanceReader` method out of `AbstractWireTestCase` becaue
it is no longer used.
* Marks a bunch of methods final so it is more obvious which classes are
for what.
* Cleans up the side effects of the above.
---
 .../geometry/BaseGeometryTestCase.java        |  7 ----
 .../rollover/RolloverResponseTests.java       | 11 ++-----
 .../test/AbstractWireSerializingTestCase.java | 14 +++++++-
 .../test/AbstractWireTestCase.java            | 32 +++++++++++++------
 .../AbstractSqlWireSerializingTestCase.java   |  5 +++
 .../xpack/sql/session/ListCursorTests.java    | 12 ++-----
 6 files changed, 45 insertions(+), 36 deletions(-)

diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/BaseGeometryTestCase.java b/libs/geo/src/test/java/org/elasticsearch/geometry/BaseGeometryTestCase.java
index ae2dd17e4285b..9cf05ca1a005f 100644
--- a/libs/geo/src/test/java/org/elasticsearch/geometry/BaseGeometryTestCase.java
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/BaseGeometryTestCase.java
@@ -21,7 +21,6 @@
 
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.Version;
-import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.geometry.utils.GeographyValidator;
 import org.elasticsearch.geometry.utils.WellKnownText;
 import org.elasticsearch.test.AbstractWireTestCase;
@@ -42,12 +41,6 @@ protected final T createTestInstance() {
 
     protected abstract T createTestInstance(boolean hasAlt);
 
-    @Override
-    protected Writeable.Reader<T> instanceReader() {
-        throw new IllegalStateException("shouldn't be called in this test");
-    }
-
-
     @SuppressWarnings("unchecked")
     @Override
     protected T copyInstance(T instance, Version version) throws IOException {
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/RolloverResponseTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/RolloverResponseTests.java
index e268ed481e2cd..7264b00f83ff3 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/RolloverResponseTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/RolloverResponseTests.java
@@ -19,20 +19,18 @@
 
 package org.elasticsearch.action.admin.indices.rollover;
 
-import org.elasticsearch.Version;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.test.AbstractWireTestCase;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
 
-import java.io.IOException;
 import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.function.Supplier;
 
-public class RolloverResponseTests extends AbstractWireTestCase<RolloverResponse> {
+public class RolloverResponseTests extends AbstractWireSerializingTestCase<RolloverResponse> {
 
     @Override
     protected RolloverResponse createTestInstance() {
@@ -65,11 +63,6 @@ protected Writeable.Reader<RolloverResponse> instanceReader() {
         return RolloverResponse::new;
     }
 
-    @Override
-    protected RolloverResponse copyInstance(RolloverResponse instance, Version version) throws IOException {
-        return copyWriteable(instance, writableRegistry(), RolloverResponse::new);
-    }
-
     @Override
     protected RolloverResponse mutateInstance(RolloverResponse response) {
         int i = randomIntBetween(0, 6);
diff --git a/test/framework/src/main/java/org/elasticsearch/test/AbstractWireSerializingTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/AbstractWireSerializingTestCase.java
index cb7f5ff4a229e..ce1e5f7ce9713 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/AbstractWireSerializingTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/AbstractWireSerializingTestCase.java
@@ -19,14 +19,26 @@
 package org.elasticsearch.test;
 
 import org.elasticsearch.Version;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
 
 import java.io.IOException;
 
+/**
+ * Standard test case for testing the wire serialization of subclasses of {@linkplain Writeable}.
+ */
 public abstract class AbstractWireSerializingTestCase<T extends Writeable> extends AbstractWireTestCase<T> {
+    /**
+     * Returns a {@link Writeable.Reader} that can be used to de-serialize the instance
+     */
+    protected abstract Writeable.Reader<T> instanceReader();
 
+    /**
+     * Copy the {@link Writeable} by round tripping it through {@linkplain StreamInput} and {@linkplain StreamOutput}.
+     */
     @Override
-    protected T copyInstance(T instance, Version version) throws IOException {
+    protected final T copyInstance(T instance, Version version) throws IOException {
         return copyWriteable(instance, getNamedWriteableRegistry(), instanceReader(), version);
     }
 }
diff --git a/test/framework/src/main/java/org/elasticsearch/test/AbstractWireTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/AbstractWireTestCase.java
index 3e58dc8809d5d..3997db194e9b5 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/AbstractWireTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/AbstractWireTestCase.java
@@ -27,6 +27,10 @@
 import java.io.IOException;
 import java.util.Collections;
 
+/**
+ * Standard test case for testing wire serialization. If the class being tested
+ * extends {@link Writeable} then prefer extending {@link AbstractWireSerializingTestCase}.
+ */
 public abstract class AbstractWireTestCase<T> extends ESTestCase {
 
     protected static final int NUMBER_OF_TEST_RUNS = 20;
@@ -38,11 +42,6 @@ public abstract class AbstractWireTestCase<T> extends ESTestCase {
      */
     protected abstract T createTestInstance();
 
-    /**
-     * Returns a {@link Writeable.Reader} that can be used to de-serialize the instance
-     */
-    protected abstract Writeable.Reader<T> instanceReader();
-
     /**
      * Returns an instance which is mutated slightly so it should not be equal
      * to the given instance.
@@ -73,18 +72,26 @@ public final void testSerialization() throws IOException {
     }
 
     /**
-     * Serialize the given instance and asserts that both are equal
+     * Serialize the given instance and asserts that both are equal.
      */
-    protected final T assertSerialization(T testInstance) throws IOException {
-        return assertSerialization(testInstance, Version.CURRENT);
+    protected final void assertSerialization(T testInstance) throws IOException {
+        assertSerialization(testInstance, Version.CURRENT);
     }
 
-    protected final T assertSerialization(T testInstance, Version version) throws IOException {
+    /**
+     * Assert that instances copied at a particular version are equal. The version is useful
+     * for sanity checking the backwards compatibility of the wire. It isn't a substitute for
+     * real backwards compatibility tests but it is *so* much faster.
+     */
+    protected final void assertSerialization(T testInstance, Version version) throws IOException {
         T deserializedInstance = copyInstance(testInstance, version);
         assertEqualInstances(testInstance, deserializedInstance);
-        return deserializedInstance;
     }
 
+    /**
+     * Assert that two instances are equal. This is intentionally not final so we can override
+     * how equality is checked.
+     */
     protected void assertEqualInstances(T expectedInstance, T newInstance) {
         assertNotSame(newInstance, expectedInstance);
         assertEquals(expectedInstance, newInstance);
@@ -95,6 +102,11 @@ protected final T copyInstance(T instance) throws IOException {
         return copyInstance(instance, Version.CURRENT);
     }
 
+    /**
+     * Copy the instance as by reading and writing using the code specific to the provided version.
+     * The version is useful for sanity checking the backwards compatibility of the wire. It isn't
+     * a substitute for real backwards compatibility tests but it is *so* much faster.
+     */
     protected abstract T copyInstance(T instance, Version version) throws IOException;
 
     /**
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/AbstractSqlWireSerializingTestCase.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/AbstractSqlWireSerializingTestCase.java
index 057cc76ee0226..6f8dae854f48d 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/AbstractSqlWireSerializingTestCase.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/AbstractSqlWireSerializingTestCase.java
@@ -32,6 +32,11 @@ protected T copyInstance(T instance, Version version) throws IOException {
             }
         }
     }
+    
+    /**
+     * Returns a {@link Writeable.Reader} that can be used to de-serialize the instance
+     */
+    protected abstract Writeable.Reader<T> instanceReader();
 
     protected ZoneId instanceZoneId(T instance) {
         return randomSafeZone();
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/session/ListCursorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/session/ListCursorTests.java
index ac14465451eb4..2fd88e3c0bc8c 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/session/ListCursorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/session/ListCursorTests.java
@@ -7,15 +7,14 @@
 
 import org.elasticsearch.Version;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
-import org.elasticsearch.common.io.stream.Writeable.Reader;
-import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.test.AbstractWireTestCase;
 
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
 
-public class ListCursorTests extends AbstractWireSerializingTestCase<ListCursor> {
+public class ListCursorTests extends AbstractWireTestCase<ListCursor> {
     public static ListCursor randomPagingListCursor() {
         int size = between(1, 20);
         int depth = between(1, 20);
@@ -45,17 +44,12 @@ protected ListCursor createTestInstance() {
         return randomPagingListCursor();
     }
 
-    @Override
-    protected Reader<ListCursor> instanceReader() {
-        return ListCursor::new;
-    }
-
     @Override
     protected ListCursor copyInstance(ListCursor instance, Version version) throws IOException {
         /* Randomly choose between internal protocol round trip and String based
          * round trips used to toXContent. */
         if (randomBoolean()) {
-            return super.copyInstance(instance, version);
+            return copyWriteable(instance, getNamedWriteableRegistry(), ListCursor::new, version);
         }
         return (ListCursor) Cursors.decodeFromString(Cursors.encodeToString(instance, randomZone()));
     }

From 8906189e952f51a2cfe2c81b523b9f6b33c8fcda Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Sun, 5 Jan 2020 18:30:17 -0500
Subject: [PATCH 382/686] Deprecate indices without soft-deletes (#50502)

Soft-deletes will be enabled for all indices in 8.0. Hence, we should
deprecate new indices without soft-deletes in 7.x.
---
 .../index-modules/history-retention.asciidoc  |  3 ++
 .../elasticsearch/upgrades/RecoveryIT.java    | 29 ++++++++++++--
 .../test/indices.create/10_basic.yml          | 17 +++++++++
 .../test/indices.stats/20_translog.yml        | 25 +++++++++---
 .../metadata/MetaDataCreateIndexService.java  |  8 ++++
 .../MetaDataCreateIndexServiceTests.java      | 15 ++++++++
 .../test/rest/ESRestTestCase.java             | 38 ++++++++++++++-----
 7 files changed, 115 insertions(+), 20 deletions(-)

diff --git a/docs/reference/index-modules/history-retention.asciidoc b/docs/reference/index-modules/history-retention.asciidoc
index 94e17e49251e3..8df79625c88d0 100644
--- a/docs/reference/index-modules/history-retention.asciidoc
+++ b/docs/reference/index-modules/history-retention.asciidoc
@@ -65,6 +65,9 @@ there>>. {ccr-cap} will not function if soft deletes are disabled.
   configured at index creation and only on indices created on or after 6.5.0.
   The default value is `true`.
 
+  deprecated::[7.6, Creating indices with soft-deletes disabled is
+  deprecated and will be removed in future Elasticsearch versions.]
+
 `index.soft_deletes.retention_lease.period`::
 
   The maximum length of time to retain a shard history retention lease before
diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index 080b15268db1d..88dabadbd09fd 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.cluster.metadata.MetaDataIndexStateService;
 import org.elasticsearch.cluster.routing.allocation.decider.EnableAllocationDecider;
 import org.elasticsearch.common.Booleans;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
@@ -281,7 +282,7 @@ public void testRelocationWithConcurrentIndexing() throws Exception {
         }
     }
 
-    public void testRecoveryWithSoftDeletes() throws Exception {
+    public void testRecovery() throws Exception {
         final String index = "recover_with_soft_deletes";
         if (CLUSTER_TYPE == ClusterType.OLD) {
             Settings.Builder settings = Settings.builder()
@@ -294,7 +295,7 @@ public void testRecoveryWithSoftDeletes() throws Exception {
                 .put(INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), "100ms")
                 .put(SETTING_ALLOCATION_MAX_RETRY.getKey(), "0"); // fail faster
             if (randomBoolean()) {
-                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
+                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
             }
             createIndex(index, settings.build());
             int numDocs = randomInt(10);
@@ -325,7 +326,7 @@ public void testRetentionLeasesEstablishedWhenPromotingPrimary() throws Exceptio
                 .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), between(1, 2)) // triggers nontrivial promotion
                 .put(INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), "100ms")
                 .put(SETTING_ALLOCATION_MAX_RETRY.getKey(), "0") // fail faster
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
+                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
             createIndex(index, settings.build());
             int numDocs = randomInt(10);
             indexDocs(index, 0, numDocs);
@@ -348,7 +349,7 @@ public void testRetentionLeasesEstablishedWhenRelocatingPrimary() throws Excepti
                     .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), between(0, 1))
                     .put(INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), "100ms")
                     .put(SETTING_ALLOCATION_MAX_RETRY.getKey(), "0") // fail faster
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
+                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
                 createIndex(index, settings.build());
                 int numDocs = randomInt(10);
                 indexDocs(index, 0, numDocs);
@@ -740,6 +741,26 @@ public void testAutoExpandIndicesDuringRollingUpgrade() throws Exception {
         }
     }
 
+    public void testSoftDeletesDisabledWarning() throws Exception {
+        final String indexName = "test_soft_deletes_disabled_warning";
+        if (CLUSTER_TYPE == ClusterType.OLD) {
+            boolean softDeletesEnabled = true;
+            Settings.Builder settings = Settings.builder();
+            if (randomBoolean()) {
+                softDeletesEnabled = randomBoolean();
+                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), softDeletesEnabled);
+            }
+            Request request = new Request("PUT", "/" + indexName);
+            request.setJsonEntity("{\"settings\": " + Strings.toString(settings.build()) + "}");
+            if (softDeletesEnabled == false) {
+                expectSoftDeletesWarning(request, indexName);
+            }
+            client().performRequest(request);
+        }
+        ensureGreen(indexName);
+        indexDocs(indexName, randomInt(100), randomInt(100));
+    }
+
     @SuppressWarnings("unchecked")
     private Map<String, Object> getIndexSettingsAsMap(String index) throws IOException {
         Map<String, Object> indexSettings = getIndexSettings(index);
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
index 7e15ba70c16ba..1dacfd6ad61c3 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
@@ -119,3 +119,20 @@
             properties:
               "":
                 type:     keyword
+
+---
+"Create index without soft deletes":
+  - skip:
+      version:  " - 7.9.99"
+      reason:   "indices without soft deletes are deprecated in 8.0"
+      features: "warnings"
+
+  - do:
+      warnings:
+        - Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions.
+          Please do not specify value for setting [index.soft_deletes.enabled] of index [test_index].
+      indices.create:
+        index: test_index
+        body:
+          settings:
+            soft_deletes.enabled: false
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
index c522b27a0be97..8ba11bb280ce7 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
@@ -1,11 +1,19 @@
 ---
 "Translog retention without soft_deletes":
+  - skip:
+      version:  " - 7.9.99"
+      reason:   "indices without soft deletes are deprecated in 8.0"
+      features: "warnings"
+
   - do:
       indices.create:
         index: test
         body:
           settings:
             soft_deletes.enabled: false
+      warnings:
+        - Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions.
+          Please do not specify value for setting [index.soft_deletes.enabled] of index [test].
   - do:
       cluster.health:
         wait_for_no_initializing_shards: true
@@ -68,8 +76,8 @@
 ---
 "Translog retention with soft_deletes":
   - skip:
-      version: " - 7.9.99"
-      reason:  "start ignoring translog retention policy with soft-deletes enabled in 8.0"
+      version: " - 7.3.99"
+      reason:  "start ignoring translog retention policy with soft-deletes enabled in 7.4"
   - do:
       indices.create:
         index: test
@@ -130,8 +138,9 @@
 ---
 "Translog stats on closed indices without soft-deletes":
   - skip:
-      version: " - 7.2.99"
-      reason:  "closed indices have translog stats starting version 7.3.0"
+      version: " - 7.9.99"
+      reason:  "indices without soft deletes are deprecated in 8.0"
+      features: "warnings"
 
   - do:
       indices.create:
@@ -139,6 +148,10 @@
         body:
           settings:
             soft_deletes.enabled: false
+      warnings:
+        - Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions.
+          Please do not specify value for setting [index.soft_deletes.enabled] of index [test].
+
   - do:
       cluster.health:
         wait_for_no_initializing_shards: true
@@ -184,8 +197,8 @@
 ---
 "Translog stats on closed indices with soft-deletes":
   - skip:
-      version: " - 7.9.99"
-      reason:  "start ignoring translog retention policy with soft-deletes enabled in 8.0"
+      version: " - 7.3.99"
+      reason:  "start ignoring translog retention policy with soft-deletes enabled in 7.4"
   - do:
       indices.create:
         index: test
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
index 9e310280636a0..1ed7fb04407f1 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
@@ -53,6 +53,7 @@
 import org.elasticsearch.common.ValidationException;
 import org.elasticsearch.common.compress.CompressedXContent;
 import org.elasticsearch.common.io.PathUtils;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.settings.IndexScopedSettings;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
@@ -62,6 +63,7 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexNotFoundException;
 import org.elasticsearch.index.IndexService;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.mapper.DocumentMapper;
 import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.index.mapper.MapperService.MergeReason;
@@ -102,6 +104,7 @@
  */
 public class MetaDataCreateIndexService {
     private static final Logger logger = LogManager.getLogger(MetaDataCreateIndexService.class);
+    private static final DeprecationLogger DEPRECATION_LOGGER = new DeprecationLogger(logger);
 
     public static final int MAX_INDEX_NAME_BYTES = 255;
 
@@ -434,6 +437,11 @@ static Settings aggregateIndexSettings(ClusterState currentState, CreateIndexClu
          * that will be used to create this index.
          */
         MetaDataCreateIndexService.checkShardLimit(indexSettings, currentState);
+        if (indexSettings.getAsBoolean(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true) == false) {
+            DEPRECATION_LOGGER.deprecatedAndMaybeLog("soft_deletes_disabled",
+                "Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions. " +
+                "Please do not specify value for setting [index.soft_deletes.enabled] of index [" + request.index() + "].");
+        }
         return indexSettings;
     }
 
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
index e7d35eaeb18ab..e90f710af0f45 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
@@ -828,6 +828,21 @@ public void testGetIndexNumberOfRoutingShardsYieldsSourceNumberOfShards() {
         assertThat(targetRoutingNumberOfShards, is(6));
     }
 
+    public void testSoftDeletesDisabledDeprecation() {
+        request = new CreateIndexClusterStateUpdateRequest("create index", "test", "test");
+        request.settings(Settings.builder().put(INDEX_SOFT_DELETES_SETTING.getKey(), false).build());
+        aggregateIndexSettings(ClusterState.EMPTY_STATE, request, List.of(), Map.of(),
+            null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+        assertWarnings("Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions. "
+            + "Please do not specify value for setting [index.soft_deletes.enabled] of index [test].");
+        request = new CreateIndexClusterStateUpdateRequest("create index", "test", "test");
+        if (randomBoolean()) {
+            request.settings(Settings.builder().put(INDEX_SOFT_DELETES_SETTING.getKey(), true).build());
+        }
+        aggregateIndexSettings(ClusterState.EMPTY_STATE, request, List.of(), Map.of(),
+            null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+    }
+
     private IndexTemplateMetaData addMatchingTemplate(Consumer<IndexTemplateMetaData.Builder> configurator) {
         IndexTemplateMetaData.Builder builder = templateMetaDataBuilder("template1", "te*");
         configurator.accept(builder);
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index d5da4320ab3ee..4344b54c38eda 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -52,6 +52,7 @@
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
 import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.seqno.ReplicationTracker;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.snapshots.SnapshotState;
@@ -964,23 +965,27 @@ protected static void ensureNoInitializingShards() throws IOException {
     }
 
     protected static void createIndex(String name, Settings settings) throws IOException {
-        Request request = new Request("PUT", "/" + name);
-        request.setJsonEntity("{\n \"settings\": " + Strings.toString(settings) + "}");
-        client().performRequest(request);
+        createIndex(name, settings, null);
     }
 
     protected static void createIndex(String name, Settings settings, String mapping) throws IOException {
-        Request request = new Request("PUT", "/" + name);
-        request.setJsonEntity("{\n \"settings\": " + Strings.toString(settings)
-                + ", \"mappings\" : {" + mapping + "} }");
-        client().performRequest(request);
+        createIndex(name, settings, mapping, null);
     }
 
     protected static void createIndex(String name, Settings settings, String mapping, String aliases) throws IOException {
         Request request = new Request("PUT", "/" + name);
-        request.setJsonEntity("{\n \"settings\": " + Strings.toString(settings)
-            + ", \"mappings\" : {" + mapping + "}"
-            + ", \"aliases\": {" + aliases + "} }");
+        String entity = "{\"settings\": " + Strings.toString(settings);
+        if (mapping != null) {
+            entity += ",\"mappings\" : {" + mapping + "}";
+        }
+        if (aliases != null) {
+            entity += ",\"aliases\": {" + aliases + "}";
+        }
+        entity += "}";
+        if (settings.getAsBoolean(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true) == false) {
+            expectSoftDeletesWarning(request, name);
+        }
+        request.setJsonEntity(entity);
         client().performRequest(request);
     }
 
@@ -999,6 +1004,19 @@ private static void updateIndexSettings(String index, Settings settings) throws
         client().performRequest(request);
     }
 
+    protected static void expectSoftDeletesWarning(Request request, String indexName) {
+        final List<String> expectedWarnings = List.of(
+            "Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions. " +
+            "Please do not specify value for setting [index.soft_deletes.enabled] of index [" + indexName + "].");
+        if (nodeVersions.stream().allMatch(version -> version.onOrAfter(Version.V_8_0_0))) {
+            request.setOptions(RequestOptions.DEFAULT.toBuilder()
+                .setWarningsHandler(warnings -> warnings.equals(expectedWarnings) == false));
+        } else if (nodeVersions.stream().anyMatch(version -> version.onOrAfter(Version.V_8_0_0))) {
+            request.setOptions(RequestOptions.DEFAULT.toBuilder()
+                .setWarningsHandler(warnings -> warnings.isEmpty() == false && warnings.equals(expectedWarnings) == false));
+        }
+    }
+
     protected static Map<String, Object> getIndexSettings(String index) throws IOException {
         Request request = new Request("GET", "/" + index + "/_settings");
         request.addParameter("flat_settings", "true");

From 15f4be04e08626cace6dfa71cb4a7869ceff8f78 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Mon, 6 Jan 2020 15:45:20 +1100
Subject: [PATCH 383/686] Remove obsolete constructor from SSLService (#50347)

This removes the old `SSLService(Settings, Environment)` constructor
and converts all uses cases to the `SSLService(Environment)`
constructor that was added in #49667
---
 .../xpack/core/ssl/SSLService.java            | 31 +++++----
 .../transport/ProfileConfigurationsTests.java |  4 +-
 .../ssl/SSLConfigurationReloaderTests.java    | 23 ++++---
 .../xpack/core/ssl/SSLServiceTests.java       | 60 ++++++++--------
 .../xpack/core/ssl/TestsSSLService.java       |  4 +-
 .../exporter/http/HttpExporterIT.java         |  3 +-
 .../exporter/http/HttpExporterSslIT.java      |  4 +-
 .../esnative/tool/CommandLineHttpClient.java  |  8 +--
 .../esnative/tool/SetupPasswordTool.java      | 18 ++---
 .../security/PkiRealmBootstrapCheckTests.java | 37 ++++------
 .../xpack/security/SecurityTests.java         |  2 +-
 ...ansportOpenIdConnectLogoutActionTests.java |  4 +-
 .../tool/CommandLineHttpClientTests.java      | 10 +--
 .../esnative/tool/SetupPasswordToolTests.java |  2 +-
 .../authc/ldap/ActiveDirectoryRealmTests.java |  4 +-
 .../security/authc/ldap/LdapRealmTests.java   | 10 +--
 .../authc/ldap/LdapSessionFactoryTests.java   |  2 +-
 .../security/authc/ldap/LdapTestUtils.java    |  2 +-
 .../LdapUserSearchSessionFactoryTests.java    |  4 +-
 .../SessionFactoryLoadBalancingTests.java     |  2 +-
 .../ldap/support/SessionFactoryTests.java     | 14 ++--
 .../oidc/OpenIdConnectAuthenticatorTests.java | 11 ++-
 .../security/authc/saml/SamlRealmTests.java   |  5 +-
 ...stractSimpleSecurityTransportTestCase.java |  2 +-
 ...ecurityNetty4HttpServerTransportTests.java | 16 ++---
 .../SecurityNioHttpServerTransportTests.java  | 16 ++---
 .../transport/ssl/SslIntegrationTests.java    |  3 +-
 ...orMessageCertificateVerificationTests.java |  7 +-
 .../xpack/ssl/SSLErrorMessageFileTests.java   |  6 +-
 .../xpack/ssl/SSLReloadIntegTests.java        |  2 +-
 .../xpack/ssl/SSLTrustRestrictionsTests.java  |  2 +-
 .../watcher/actions/email/EmailSslTests.java  |  2 +-
 .../actions/webhook/WebhookActionTests.java   |  2 +-
 .../webhook/WebhookHttpsIntegrationTests.java |  4 +-
 .../watcher/common/http/HttpClientTests.java  | 68 +++++++++++--------
 .../http/HttpConnectionTimeoutTests.java      |  6 +-
 .../common/http/HttpReadTimeoutTests.java     |  6 +-
 .../org/elasticsearch/test/OpenLdapTests.java |  2 +-
 ...OpenLdapUserSearchSessionFactoryTests.java |  2 +-
 .../ADLdapUserSearchSessionFactoryTests.java  |  6 +-
 .../ldap/AbstractActiveDirectoryTestCase.java |  2 +-
 .../ActiveDirectorySessionFactoryTests.java   |  4 +-
 42 files changed, 216 insertions(+), 206 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
index a788090c831d9..2e7a3a5855943 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
@@ -100,6 +100,7 @@ public class SSLService {
     private static final Setting<Boolean> DIAGNOSE_TRUST_EXCEPTIONS_SETTING = Setting.boolSetting(
         "xpack.security.ssl.diagnose.trust", true, Setting.Property.NodeScope);
 
+    private final Environment env;
     private final Settings settings;
     private final boolean diagnoseTrustExceptions;
 
@@ -120,33 +121,33 @@ public class SSLService {
      */
     private final Map<SSLConfiguration, SSLContextHolder> sslContexts;
     private final SetOnce<SSLConfiguration> transportSSLConfiguration = new SetOnce<>();
-    private final Environment env;
 
     /**
-     * Create a new SSLService using the {@code Settings} from {@link Environment#settings()}.
-     * @see #SSLService(Settings, Environment)
+     * Create a new SSLService that parses the settings for the ssl contexts that need to be created, creates them, and then caches them
+     * for use later
      */
     public SSLService(Environment environment) {
-        this(environment.settings(), environment);
+        this.env = environment;
+        this.settings = env.settings();
+        this.diagnoseTrustExceptions = DIAGNOSE_TRUST_EXCEPTIONS_SETTING.get(environment.settings());
+        this.sslConfigurations = new HashMap<>();
+        this.sslContexts = loadSSLConfigurations();
     }
 
-    /**
-     * Create a new SSLService that parses the settings for the ssl contexts that need to be created, creates them, and then caches them
-     * for use later
-     */
+    @Deprecated
     public SSLService(Settings settings, Environment environment) {
-        this.settings = settings;
         this.env = environment;
+        this.settings = env.settings();
         this.diagnoseTrustExceptions = DIAGNOSE_TRUST_EXCEPTIONS_SETTING.get(settings);
         this.sslConfigurations = new HashMap<>();
         this.sslContexts = loadSSLConfigurations();
     }
 
-    private SSLService(Settings settings, Environment environment, Map<String, SSLConfiguration> sslConfigurations,
+    private SSLService(Environment environment, Map<String, SSLConfiguration> sslConfigurations,
                        Map<SSLConfiguration, SSLContextHolder> sslContexts) {
-        this.settings = settings;
         this.env = environment;
-        this.diagnoseTrustExceptions = DIAGNOSE_TRUST_EXCEPTIONS_SETTING.get(settings);
+        this.settings = env.settings();
+        this.diagnoseTrustExceptions = DIAGNOSE_TRUST_EXCEPTIONS_SETTING.get(environment.settings());
         this.sslConfigurations = sslConfigurations;
         this.sslContexts = sslContexts;
     }
@@ -157,7 +158,7 @@ private SSLService(Settings settings, Environment environment, Map<String, SSLCo
      * have been created during initialization
      */
     public SSLService createDynamicSSLService() {
-        return new SSLService(settings, env, sslConfigurations, sslContexts) {
+        return new SSLService(env, sslConfigurations, sslContexts) {
 
             @Override
             Map<SSLConfiguration, SSLContextHolder> loadSSLConfigurations() {
@@ -489,9 +490,9 @@ X509ExtendedTrustManager wrapWithDiagnostics(X509ExtendedTrustManager trustManag
      * Parses the settings to load all SSLConfiguration objects that will be used.
      */
     Map<SSLConfiguration, SSLContextHolder> loadSSLConfigurations() {
-        Map<SSLConfiguration, SSLContextHolder> sslContextHolders = new HashMap<>();
+        final Map<SSLConfiguration, SSLContextHolder> sslContextHolders = new HashMap<>();
 
-        Map<String, Settings> sslSettingsMap = new HashMap<>();
+        final Map<String, Settings> sslSettingsMap = new HashMap<>();
         sslSettingsMap.put(XPackSettings.HTTP_SSL_PREFIX, getHttpTransportSSLSettings(settings));
         sslSettingsMap.put("xpack.http.ssl", settings.getByPrefix("xpack.http.ssl."));
         sslSettingsMap.putAll(getRealmsSSLSettings(settings));
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/transport/ProfileConfigurationsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/transport/ProfileConfigurationsTests.java
index fd7315d7457c2..8b3d4cc3bec75 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/transport/ProfileConfigurationsTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/transport/ProfileConfigurationsTests.java
@@ -30,7 +30,7 @@ public void testGetSecureTransportProfileConfigurations() {
             .put("transport.profiles.cert.xpack.security.ssl.verification_mode", VerificationMode.CERTIFICATE.name())
             .build();
         final Environment env = TestEnvironment.newEnvironment(settings);
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(env);
         final SSLConfiguration defaultConfig = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         final Map<String, SSLConfiguration> profileConfigurations = ProfileConfigurations.get(settings, sslService, defaultConfig);
         assertThat(profileConfigurations.size(), Matchers.equalTo(3));
@@ -48,7 +48,7 @@ public void testGetInsecureTransportProfileConfigurations() {
             .put("transport.profiles.none.xpack.security.ssl.verification_mode", VerificationMode.NONE.name())
             .build();
         final Environment env = TestEnvironment.newEnvironment(settings);
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(env);
         final SSLConfiguration defaultConfig = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         final Map<String, SSLConfiguration> profileConfigurations = ProfileConfigurations.get(settings, sslService, defaultConfig);
         assertThat(profileConfigurations.size(), Matchers.equalTo(2));
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLConfigurationReloaderTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLConfigurationReloaderTests.java
index c2ba99a441616..2c9cc037e7cc4 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLConfigurationReloaderTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLConfigurationReloaderTests.java
@@ -147,7 +147,7 @@ public void testReloadingKeyStore() throws Exception {
                     throw new RuntimeException("Exception starting or connecting to the mock server", e);
                 }
             };
-            validateSSLConfigurationIsReloaded(settings, env, keyMaterialPreChecks, modifier, keyMaterialPostChecks);
+            validateSSLConfigurationIsReloaded(env, keyMaterialPreChecks, modifier, keyMaterialPostChecks);
         }
     }
     /**
@@ -174,7 +174,7 @@ public void testPEMKeyConfigReloading() throws Exception {
             .putList("xpack.security.transport.ssl.certificate_authorities", certPath.toString())
             .setSecureSettings(secureSettings)
             .build();
-        final Environment env = newEnvironment();
+        final Environment env = TestEnvironment.newEnvironment(settings);
         // Load HTTPClient once. Client uses a keystore containing testnode key/cert as a truststore
         try (CloseableHttpClient client = getSSLClient(Collections.singletonList(certPath))) {
             final Consumer<SSLContext> keyMaterialPreChecks = (context) -> {
@@ -207,7 +207,7 @@ public void testPEMKeyConfigReloading() throws Exception {
                     throw new RuntimeException("Exception starting or connecting to the mock server", e);
                 }
             };
-            validateSSLConfigurationIsReloaded(settings, env, keyMaterialPreChecks, modifier, keyMaterialPostChecks);
+            validateSSLConfigurationIsReloaded(env, keyMaterialPreChecks, modifier, keyMaterialPostChecks);
         }
     }
 
@@ -259,7 +259,7 @@ public void testReloadingTrustStore() throws Exception {
                     throw new RuntimeException("Error closing CloseableHttpClient", e);
                 }
             };
-            validateSSLConfigurationIsReloaded(settings, env, trustMaterialPreChecks, modifier, trustMaterialPostChecks);
+            validateSSLConfigurationIsReloaded(env, trustMaterialPreChecks, modifier, trustMaterialPostChecks);
         }
     }
 
@@ -309,7 +309,7 @@ public void testReloadingPEMTrustConfig() throws Exception {
                     throw new RuntimeException("Error closing CloseableHttpClient", e);
                 }
             };
-            validateSSLConfigurationIsReloaded(settings, env, trustMaterialPreChecks, modifier, trustMaterialPostChecks);
+            validateSSLConfigurationIsReloaded(env, trustMaterialPreChecks, modifier, trustMaterialPostChecks);
         }
     }
 
@@ -331,7 +331,7 @@ public void testReloadingKeyStoreException() throws Exception {
             .put("path.home", createTempDir())
             .build();
         Environment env = TestEnvironment.newEnvironment(settings);
-        final SSLService sslService = new SSLService(settings, env);
+        final SSLService sslService = new SSLService(env);
         final SSLConfiguration config = sslService.getSSLConfiguration("xpack.security.transport.ssl.");
         final AtomicReference<Exception> exceptionRef = new AtomicReference<>();
         final CountDownLatch latch = new CountDownLatch(1);
@@ -353,6 +353,7 @@ void reloadSSLContext(SSLConfiguration configuration) {
 
         // truncate the keystore
         try (OutputStream ignore = Files.newOutputStream(keystorePath, StandardOpenOption.TRUNCATE_EXISTING)) {
+            // do nothing
         }
 
         latch.await();
@@ -384,7 +385,7 @@ public void testReloadingPEMKeyConfigException() throws Exception {
             .setSecureSettings(secureSettings)
             .build();
         Environment env = TestEnvironment.newEnvironment(settings);
-        final SSLService sslService = new SSLService(settings, env);
+        final SSLService sslService = new SSLService(env);
         final SSLConfiguration config = sslService.getSSLConfiguration("xpack.security.transport.ssl.");
         final AtomicReference<Exception> exceptionRef = new AtomicReference<>();
         final CountDownLatch latch = new CountDownLatch(1);
@@ -430,7 +431,7 @@ public void testTrustStoreReloadException() throws Exception {
             .put("path.home", createTempDir())
             .build();
         Environment env = TestEnvironment.newEnvironment(settings);
-        final SSLService sslService = new SSLService(settings, env);
+        final SSLService sslService = new SSLService(env);
         final SSLConfiguration config = sslService.getSSLConfiguration("xpack.security.transport.ssl.");
         final AtomicReference<Exception> exceptionRef = new AtomicReference<>();
         final CountDownLatch latch = new CountDownLatch(1);
@@ -474,7 +475,7 @@ public void testPEMTrustReloadException() throws Exception {
             .put("path.home", createTempDir())
             .build();
         Environment env = TestEnvironment.newEnvironment(settings);
-        final SSLService sslService = new SSLService(settings, env);
+        final SSLService sslService = new SSLService(env);
         final SSLConfiguration config = sslService.sslConfiguration(settings.getByPrefix("xpack.security.transport.ssl."));
         final AtomicReference<Exception> exceptionRef = new AtomicReference<>();
         final CountDownLatch latch = new CountDownLatch(1);
@@ -524,10 +525,10 @@ private Settings.Builder baseKeystoreSettings(Path tempDir, MockSecureSettings s
             .setSecureSettings(secureSettings);
     }
 
-    private void validateSSLConfigurationIsReloaded(Settings settings, Environment env, Consumer<SSLContext> preChecks,
+    private void validateSSLConfigurationIsReloaded(Environment env, Consumer<SSLContext> preChecks,
                                                     Runnable modificationFunction, Consumer<SSLContext> postChecks) throws Exception {
         final CountDownLatch reloadLatch = new CountDownLatch(1);
-        final SSLService sslService = new SSLService(settings, env);
+        final SSLService sslService = new SSLService(env);
         final SSLConfiguration config = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         new SSLConfigurationReloader(env, sslService, resourceWatcherService) {
             @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
index b2bf6974e319d..14654902b0405 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
@@ -121,7 +121,7 @@ public void testThatCustomTruststoreCanBeSpecified() throws Exception {
             .setSecureSettings(secureSettings)
             .put("transport.profiles.foo.xpack.security.ssl.truststore.path", testClientStore)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
 
         MockSecureSettings secureCustomSettings = new MockSecureSettings();
         secureCustomSettings.setString("truststore.secure_password", "testclient");
@@ -153,7 +153,7 @@ public void testThatSslContextCachingWorks() throws Exception {
             .put("xpack.security.transport.ssl.key", testnodeKey)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
 
         final Settings transportSSLSettings = settings.getByPrefix("xpack.security.transport.ssl.");
         SSLContext sslContext = sslService.sslContext(sslService.sslConfiguration(transportSSLSettings));
@@ -179,7 +179,7 @@ public void testThatKeyStoreAndKeyCanHaveDifferentPasswords() throws Exception {
             .setSecureSettings(secureSettings)
             .build();
 
-        final SSLService sslService = new SSLService(settings, env);
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLConfiguration configuration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         sslService.createSSLEngine(configuration, null, -1);
     }
@@ -195,7 +195,7 @@ public void testIncorrectKeyPasswordThrowsException() throws Exception {
                 .put("xpack.security.transport.ssl.keystore.path", differentPasswordsStore)
                 .setSecureSettings(secureSettings)
                 .build();
-            final SSLService sslService = new SSLService(settings, env);
+            final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
             SSLConfiguration configuration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
             sslService.createSSLEngine(configuration, null, -1);
             fail("expected an exception");
@@ -214,14 +214,14 @@ public void testThatSSLv3IsNotEnabled() throws Exception {
             .put("xpack.security.transport.ssl.key", testnodeKey)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLConfiguration configuration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         SSLEngine engine = sslService.createSSLEngine(configuration, null, -1);
         assertThat(Arrays.asList(engine.getEnabledProtocols()), not(hasItem("SSLv3")));
     }
 
     public void testThatCreateClientSSLEngineWithoutAnySettingsWorks() throws Exception {
-        SSLService sslService = new SSLService(Settings.EMPTY, env);
+        SSLService sslService = new SSLService(env);
         SSLConfiguration configuration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         SSLEngine sslEngine = sslService.createSSLEngine(configuration, null, -1);
         assertThat(sslEngine, notNullValue());
@@ -235,7 +235,7 @@ public void testThatCreateSSLEngineWithOnlyTruststoreWorks() throws Exception {
             .put("xpack.http.ssl.truststore.path", testclientStore)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLConfiguration configuration = sslService.getSSLConfiguration("xpack.security.http.ssl");
         SSLEngine sslEngine = sslService.createSSLEngine(configuration, null, -1);
         assertThat(sslEngine, notNullValue());
@@ -252,7 +252,7 @@ public void testCreateWithKeystoreIsValidForServer() throws Exception {
             .put("xpack.security.transport.ssl.keystore.type", testnodeStoreType)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
 
         assertTrue(sslService.isConfigurationValidForServerUsage(sslService.getSSLConfiguration("xpack.security.transport.ssl")));
     }
@@ -266,7 +266,7 @@ public void testValidForServer() throws Exception {
             .put("xpack.http.ssl.truststore.type", testnodeStoreType)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         // Technically, we don't care whether xpack.http.ssl is valid for server - it's a client context, but we validate both of the
         // server contexts (http & transport) during construction, so this is the only way to make a non-server-valid context.
         assertFalse(sslService.isConfigurationValidForServerUsage(sslService.getSSLConfiguration("xpack.http.ssl")));
@@ -279,13 +279,13 @@ public void testValidForServer() throws Exception {
             .put("xpack.http.ssl.keystore.path", testnodeStore)
             .put("xpack.http.ssl.keystore.type", testnodeStoreType)
             .build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         assertTrue(sslService.isConfigurationValidForServerUsage(sslService.getSSLConfiguration("xpack.http.ssl")));
     }
 
     public void testGetVerificationMode() throws Exception {
         assumeFalse("Can't run in a FIPS JVM, TrustAllConfig is not a SunJSSE TrustManagers", inFipsJvm());
-        SSLService sslService = new SSLService(Settings.EMPTY, env);
+        SSLService sslService = new SSLService(env);
         assertThat(sslService.getSSLConfiguration("xpack.security.transport.ssl").verificationMode(),
             is(XPackSettings.VERIFICATION_MODE_DEFAULT));
 
@@ -294,14 +294,14 @@ public void testGetVerificationMode() throws Exception {
             .put("xpack.security.transport.ssl.verification_mode", "certificate")
             .put("transport.profiles.foo.xpack.security.ssl.verification_mode", "full")
             .build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         assertThat(sslService.getSSLConfiguration("xpack.security.transport.ssl.").verificationMode(), is(VerificationMode.CERTIFICATE));
         assertThat(sslService.getSSLConfiguration("transport.profiles.foo.xpack.security.ssl.").verificationMode(),
             is(VerificationMode.FULL));
     }
 
     public void testIsSSLClientAuthEnabled() throws Exception {
-        SSLService sslService = new SSLService(Settings.EMPTY, env);
+        SSLService sslService = new SSLService(env);
         assertTrue(sslService.getSSLConfiguration("xpack.security.transport.ssl").sslClientAuth().enabled());
 
         Settings settings = Settings.builder()
@@ -309,7 +309,7 @@ public void testIsSSLClientAuthEnabled() throws Exception {
             .put("xpack.security.transport.ssl.client_authentication", "optional")
             .put("transport.profiles.foo.port", "9400-9410")
             .build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         assertTrue(sslService.isSSLClientAuthEnabled(sslService.getSSLConfiguration("xpack.security.transport.ssl")));
         assertTrue(sslService.isSSLClientAuthEnabled(sslService.getSSLConfiguration("transport.profiles.foo.xpack.security.ssl")));
     }
@@ -328,7 +328,7 @@ public void testThatHttpClientAuthDefaultsToNone() throws Exception {
             .put("xpack.security.transport.ssl.keystore.type", testnodeStoreType)
             .setSecureSettings(secureSettings)
             .build();
-        final SSLService sslService = new SSLService(globalSettings, env);
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(globalSettings)));
 
         final SSLConfiguration globalConfig = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         assertThat(globalConfig.sslClientAuth(), is(SSLClientAuth.OPTIONAL));
@@ -348,7 +348,7 @@ public void testThatTruststorePasswordIsRequired() throws Exception {
             .put("xpack.security.transport.ssl.truststore.type", testnodeStoreType)
             .build();
         ElasticsearchException e =
-            expectThrows(ElasticsearchException.class, () -> new SSLService(settings, env));
+            expectThrows(ElasticsearchException.class, () -> new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings))));
         assertThat(e, throwableWithMessage("failed to load SSL configuration [xpack.security.transport.ssl]"));
         assertThat(e.getCause(), throwableWithMessage(containsString("failed to initialize SSL TrustManager")));
     }
@@ -359,7 +359,7 @@ public void testThatKeystorePasswordIsRequired() throws Exception {
             .put("xpack.security.transport.ssl.keystore.type", testnodeStoreType)
             .build();
         ElasticsearchException e =
-            expectThrows(ElasticsearchException.class, () -> new SSLService(settings, env));
+            expectThrows(ElasticsearchException.class, () -> new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings))));
         assertThat(e, throwableWithMessage("failed to load SSL configuration [xpack.security.transport.ssl]"));
         assertThat(e.getCause(), throwableWithMessage("failed to create trust manager"));
     }
@@ -377,7 +377,7 @@ public void testCiphersAndInvalidCiphersWork() throws Exception {
             .setSecureSettings(secureSettings)
             .putList("xpack.security.transport.ssl.ciphers", ciphers.toArray(new String[ciphers.size()]))
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLConfiguration configuration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         SSLEngine engine = sslService.createSSLEngine(configuration, null, -1);
         assertThat(engine, is(notNullValue()));
@@ -396,7 +396,7 @@ public void testInvalidCiphersOnlyThrowsException() throws Exception {
             .putList("xpack.security.transport.ssl.cipher_suites", new String[] { "foo", "bar" })
             .build();
         ElasticsearchException e =
-            expectThrows(ElasticsearchException.class, () -> new SSLService(settings, env));
+            expectThrows(ElasticsearchException.class, () -> new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings))));
         assertThat(e, throwableWithMessage("failed to load SSL configuration [xpack.security.transport.ssl]"));
         assertThat(e.getCause(), throwableWithMessage("none of the ciphers [foo, bar] are supported by this JVM"));
     }
@@ -410,7 +410,7 @@ public void testThatSSLEngineHasCipherSuitesOrderSet() throws Exception {
             .put("xpack.security.transport.ssl.key", testnodeKey)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLConfiguration configuration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         SSLEngine engine = sslService.createSSLEngine(configuration, null, -1);
         assertThat(engine, is(notNullValue()));
@@ -426,7 +426,7 @@ public void testThatSSLSocketFactoryHasProperCiphersAndProtocols() throws Except
             .put("xpack.security.transport.ssl.key", testnodeKey)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLConfiguration config = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         final SSLSocketFactory factory = sslService.sslSocketFactory(config);
         final String[] ciphers = sslService.supportedCiphers(factory.getSupportedCipherSuites(), config.cipherSuites(), false);
@@ -452,7 +452,7 @@ public void testThatSSLEngineHasProperCiphersAndProtocols() throws Exception {
             .put("xpack.security.transport.ssl.key", testnodeKey)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLConfiguration configuration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         SSLEngine engine = sslService.createSSLEngine(configuration, null, -1);
         final String[] ciphers = sslService.supportedCiphers(engine.getSupportedCipherSuites(), configuration.cipherSuites(), false);
@@ -542,7 +542,7 @@ public void testGetConfigurationByContextName() throws Exception {
         final Settings settings = builder
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
 
         for (int i = 0; i < contextNames.length; i++) {
             final String name = contextNames[i];
@@ -576,7 +576,7 @@ public void testReadCertificateInformation() throws Exception {
             .setSecureSettings(secureSettings)
             .build();
 
-        final SSLService sslService = new SSLService(settings, env);
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         final List<CertificateInfo> certificates = new ArrayList<>(sslService.getLoadedCertificates());
         assertThat(certificates, iterableWithSize(13));
         Collections.sort(certificates,
@@ -757,7 +757,7 @@ public int getSessionCacheSize() {
 
     @Network
     public void testThatSSLContextWithoutSettingsWorks() throws Exception {
-        SSLService sslService = new SSLService(Settings.EMPTY, env);
+        SSLService sslService = new SSLService(env);
         SSLContext sslContext = sslService.sslContext(sslService.sslConfiguration(Settings.EMPTY));
         try (CloseableHttpClient client = HttpClients.custom().setSSLContext(sslContext).build()) {
             // Execute a GET on a site known to have a valid certificate signed by a trusted public CA
@@ -775,7 +775,7 @@ public void testThatSSLContextTrustsJDKTrustedCAs() throws Exception {
             .put("xpack.security.transport.ssl.keystore.path", testclientStore)
             .setSecureSettings(secureSettings)
             .build();
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLContext sslContext = sslService.sslContext(sslService.sslConfiguration(settings.getByPrefix("xpack.security.transport.ssl.")));
         try (CloseableHttpClient client = HttpClients.custom().setSSLContext(sslContext).build()) {
             // Execute a GET on a site known to have a valid certificate signed by a trusted public CA which will succeed because the JDK
@@ -786,7 +786,7 @@ public void testThatSSLContextTrustsJDKTrustedCAs() throws Exception {
 
     @Network
     public void testThatSSLIOSessionStrategyWithoutSettingsWorks() throws Exception {
-        SSLService sslService = new SSLService(Settings.EMPTY, env);
+        SSLService sslService = new SSLService(env);
         SSLConfiguration sslConfiguration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         logger.info("SSL Configuration: {}", sslConfiguration);
         SSLIOSessionStrategy sslStrategy = sslService.sslIOSessionStrategy(sslConfiguration);
@@ -808,7 +808,7 @@ public void testThatSSLIOSessionStrategyTrustsJDKTrustedCAs() throws Exception {
             .put("xpack.security.transport.ssl.keystore.path", testclientStore)
             .setSecureSettings(secureSettings)
             .build();
-        final SSLService sslService = new SSLService(settings, env);
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         SSLIOSessionStrategy sslStrategy = sslService.sslIOSessionStrategy(sslService.getSSLConfiguration("xpack.security.transport.ssl"));
         try (CloseableHttpAsyncClient client = getAsyncHttpClient(sslStrategy)) {
             client.start();
@@ -824,7 +824,7 @@ public void testWrapTrustManagerWhenDiagnosticsEnabled() {
         if (randomBoolean()) { // randomly select between default, and explicit enabled
             builder.put("xpack.security.ssl.diagnose.trust", true);
         }
-        final SSLService sslService = new SSLService(builder.build(), env);
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(builder.build())));
         final X509ExtendedTrustManager baseTrustManager = TrustAllConfig.INSTANCE.createTrustManager(env);
         final SSLConfiguration sslConfiguration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         final X509ExtendedTrustManager wrappedTrustManager = sslService.wrapWithDiagnostics(baseTrustManager, sslConfiguration);
@@ -835,7 +835,7 @@ public void testWrapTrustManagerWhenDiagnosticsEnabled() {
     public void testDontWrapTrustManagerWhenDiagnosticsDisabled() {
         final Settings.Builder builder = Settings.builder();
         builder.put("xpack.security.ssl.diagnose.trust", false);
-        final SSLService sslService = new SSLService(builder.build(), env);
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(builder.build())));
         final X509ExtendedTrustManager baseTrustManager = TrustAllConfig.INSTANCE.createTrustManager(env);
         final SSLConfiguration sslConfiguration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         assertThat(sslService.wrapWithDiagnostics(baseTrustManager, sslConfiguration), sameInstance(baseTrustManager));
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/TestsSSLService.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/TestsSSLService.java
index e8766225a7a92..5a2c43d504616 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/TestsSSLService.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/TestsSSLService.java
@@ -15,8 +15,8 @@
  */
 public class TestsSSLService extends SSLService {
 
-    public TestsSSLService(Settings settings, Environment environment) {
-        super(settings, environment);
+    public TestsSSLService(Environment environment) {
+        super(environment);
     }
 
     /**
diff --git a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterIT.java b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterIT.java
index 1bed5f1c7fff9..c27162d003ccf 100644
--- a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterIT.java
+++ b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterIT.java
@@ -590,7 +590,8 @@ private HttpExporter createHttpExporter(final Settings settings) {
         final Exporter.Config config =
                 new Exporter.Config("_http", "http", settings, clusterService(), new XPackLicenseState(Settings.EMPTY));
 
-        return new HttpExporter(config, new SSLService(settings, environment), new ThreadContext(settings));
+        final Environment env = TestEnvironment.newEnvironment(buildEnvSettings(settings));
+        return new HttpExporter(config, new SSLService(env), new ThreadContext(settings));
     }
 
     private void export(final Settings settings, final Collection<MonitoringDoc> docs) throws Exception {
diff --git a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterSslIT.java b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterSslIT.java
index fb0da753be3b5..94b1e3f4699b4 100644
--- a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterSslIT.java
+++ b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/exporter/http/HttpExporterSslIT.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.bootstrap.JavaVersion;
 import org.elasticsearch.common.settings.MockSecureSettings;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.TestEnvironment;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.ESIntegTestCase.Scope;
@@ -44,7 +43,6 @@
 public class HttpExporterSslIT extends MonitoringIntegTestCase {
 
     private final Settings globalSettings = Settings.builder().put("path.home", createTempDir()).build();
-    private final Environment environment = TestEnvironment.newEnvironment(globalSettings);
 
     private static MockWebServer webServer;
     private MockSecureSettings secureSettings;
@@ -108,7 +106,7 @@ private MockWebServer buildWebServer() throws IOException {
             .put(globalSettings)
             .build();
 
-        TestsSSLService sslService = new TestsSSLService(sslSettings, environment);
+        TestsSSLService sslService = new TestsSSLService(TestEnvironment.newEnvironment(sslSettings));
         final SSLContext sslContext = sslService.sslContext("xpack.security.transport.ssl");
         MockWebServer server = new MockWebServer(sslContext, false);
         server.start();
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/esnative/tool/CommandLineHttpClient.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/esnative/tool/CommandLineHttpClient.java
index 7e9d5a8a32657..4b16e4d84bda3 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/esnative/tool/CommandLineHttpClient.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/esnative/tool/CommandLineHttpClient.java
@@ -53,11 +53,9 @@ public class CommandLineHttpClient {
      */
     private static final int READ_TIMEOUT = 35 * 1000;
 
-    private final Settings settings;
     private final Environment env;
 
-    public CommandLineHttpClient(Settings settings, Environment env) {
-        this.settings = settings;
+    public CommandLineHttpClient(Environment env) {
         this.env = env;
     }
 
@@ -82,7 +80,7 @@ public HttpResponse execute(String method, URL url, String user, SecureString pa
         final HttpURLConnection conn;
         // If using SSL, need a custom service because it's likely a self-signed certificate
         if ("https".equalsIgnoreCase(url.getProtocol())) {
-            final SSLService sslService = new SSLService(settings, env);
+            final SSLService sslService = new SSLService(env);
             final HttpsURLConnection httpsConn = (HttpsURLConnection) url.openConnection();
             AccessController.doPrivileged((PrivilegedAction<Void>) () -> {
                 final SSLConfiguration sslConfiguration = sslService.getHttpTransportSSLConfiguration();
@@ -133,6 +131,7 @@ public HttpResponse execute(String method, URL url, String user, SecureString pa
     }
 
     String getDefaultURL() {
+        final Settings settings = env.settings();
         final String scheme = XPackSettings.HTTP_SSL_ENABLED.get(settings) ? "https" : "http";
         List<String> httpPublishHost = SETTING_HTTP_PUBLISH_HOST.get(settings);
         if (httpPublishHost.isEmpty()) {
@@ -162,5 +161,4 @@ String getDefaultURL() {
                 "provide the url", e);
         }
     }
-
 }
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/esnative/tool/SetupPasswordTool.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/esnative/tool/SetupPasswordTool.java
index 5ac81a0648019..9f853134d00b7 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/esnative/tool/SetupPasswordTool.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/esnative/tool/SetupPasswordTool.java
@@ -50,7 +50,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
-import java.util.function.BiFunction;
+import java.util.function.Function;
 
 import static java.util.Arrays.asList;
 
@@ -68,15 +68,13 @@ public class SetupPasswordTool extends LoggingAwareMultiCommand {
     public static final List<String> USERS = asList(ElasticUser.NAME, APMSystemUser.NAME, KibanaUser.NAME, LogstashSystemUser.NAME,
         BeatsSystemUser.NAME, RemoteMonitoringUser.NAME);
 
-    private final BiFunction<Environment, Settings, CommandLineHttpClient> clientFunction;
+    private final Function<Environment, CommandLineHttpClient> clientFunction;
     private final CheckedFunction<Environment, KeyStoreWrapper, Exception> keyStoreFunction;
 
     private CommandLineHttpClient client;
 
     SetupPasswordTool() {
-        this((environment, settings) -> {
-            return new CommandLineHttpClient(settings, environment);
-        }, (environment) -> {
+        this(environment -> new CommandLineHttpClient(environment), environment -> {
             KeyStoreWrapper keyStoreWrapper = KeyStoreWrapper.load(environment.configFile());
             if (keyStoreWrapper == null) {
                 throw new UserException(ExitCodes.CONFIG,
@@ -86,8 +84,8 @@ public class SetupPasswordTool extends LoggingAwareMultiCommand {
         });
     }
 
-    SetupPasswordTool(BiFunction<Environment, Settings, CommandLineHttpClient> clientFunction,
-            CheckedFunction<Environment, KeyStoreWrapper, Exception> keyStoreFunction) {
+    SetupPasswordTool(Function<Environment, CommandLineHttpClient> clientFunction,
+                      CheckedFunction<Environment, KeyStoreWrapper, Exception> keyStoreFunction) {
         super("Sets the passwords for reserved users");
         subcommands.put("auto", newAutoSetup());
         subcommands.put("interactive", newInteractiveSetup());
@@ -261,12 +259,14 @@ void setupOptions(OptionSet options, Environment env) throws Exception {
             Settings settings = settingsBuilder.build();
             elasticUserPassword = ReservedRealm.BOOTSTRAP_ELASTIC_PASSWORD.get(settings);
 
-            client = clientFunction.apply(env, settings);
+            final Environment newEnv = new Environment(settings, env.configFile());
+            Environment.assertEquivalent(newEnv, env);
+
+            client = clientFunction.apply(newEnv);
 
             String providedUrl = urlOption.value(options);
             url = new URL(providedUrl == null ? client.getDefaultURL() : providedUrl);
             setShouldPrompt(options);
-
         }
 
         private void setParser() {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/PkiRealmBootstrapCheckTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/PkiRealmBootstrapCheckTests.java
index 62aece1f4fdf2..2d9411f5407b9 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/PkiRealmBootstrapCheckTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/PkiRealmBootstrapCheckTests.java
@@ -19,9 +19,8 @@
 public class PkiRealmBootstrapCheckTests extends AbstractBootstrapCheckTestCase {
 
     public void testPkiRealmBootstrapDefault() throws Exception {
-        final Settings settings = Settings.EMPTY;
-        final Environment env = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
-        assertFalse(runCheck(settings, env).isFailure());
+        final Settings settings = Settings.builder().put("path.home", createTempDir()).build();
+        assertFalse(runCheck(settings).isFailure());
     }
 
     public void testBootstrapCheckWithPkiRealm() throws Exception {
@@ -34,8 +33,7 @@ public void testBootstrapCheckWithPkiRealm() throws Exception {
                 .put("path.home", createTempDir())
                 .setSecureSettings(secureSettings)
                 .build();
-        Environment env = TestEnvironment.newEnvironment(settings);
-        assertTrue(runCheck(settings, env).isFailure());
+        assertTrue(runCheck(settings).isFailure());
 
         // enable transport tls
         secureSettings.setString("xpack.security.transport.ssl.secure_key_passphrase", "testnode");
@@ -44,7 +42,7 @@ public void testBootstrapCheckWithPkiRealm() throws Exception {
                 .put("xpack.security.transport.ssl.certificate", certPath)
                 .put("xpack.security.transport.ssl.key", keyPath)
                 .build();
-        assertFalse(runCheck(settings, env).isFailure());
+        assertFalse(runCheck(settings).isFailure());
 
         // enable ssl for http
         secureSettings.setString("xpack.security.http.ssl.secure_key_passphrase", "testnode");
@@ -54,29 +52,25 @@ public void testBootstrapCheckWithPkiRealm() throws Exception {
                 .put("xpack.security.http.ssl.certificate", certPath)
                 .put("xpack.security.http.ssl.key", keyPath)
                 .build();
-        env = TestEnvironment.newEnvironment(settings);
-        assertTrue(runCheck(settings, env).isFailure());
+        assertTrue(runCheck(settings).isFailure());
 
         // enable client auth for http
         settings = Settings.builder().put(settings)
                 .put("xpack.security.http.ssl.client_authentication", randomFrom("required", "optional"))
                 .build();
-        env = TestEnvironment.newEnvironment(settings);
-        assertFalse(runCheck(settings, env).isFailure());
+        assertFalse(runCheck(settings).isFailure());
 
         // disable http ssl
         settings = Settings.builder().put(settings)
                 .put("xpack.security.http.ssl.enabled", false)
                 .build();
-        env = TestEnvironment.newEnvironment(settings);
-        assertTrue(runCheck(settings, env).isFailure());
+        assertTrue(runCheck(settings).isFailure());
 
         // set transport auth
         settings = Settings.builder().put(settings)
                 .put("xpack.security.transport.client_authentication", randomFrom("required", "optional"))
                 .build();
-        env = TestEnvironment.newEnvironment(settings);
-        assertTrue(runCheck(settings, env).isFailure());
+        assertTrue(runCheck(settings).isFailure());
 
         // test with transport profile
         settings = Settings.builder().put(settings)
@@ -84,12 +78,12 @@ public void testBootstrapCheckWithPkiRealm() throws Exception {
                 .put("xpack.security.transport.client_authentication", "none")
                 .put("transport.profiles.foo.xpack.security.ssl.client_authentication", randomFrom("required", "optional"))
                 .build();
-        env = TestEnvironment.newEnvironment(settings);
-        assertFalse(runCheck(settings, env).isFailure());
+        assertFalse(runCheck(settings).isFailure());
     }
 
-    private BootstrapCheck.BootstrapCheckResult runCheck(Settings settings, Environment env) throws Exception {
-        return new PkiRealmBootstrapCheck(new SSLService(settings, env)).check(createTestContext(settings, null));
+    private BootstrapCheck.BootstrapCheckResult runCheck(Settings settings) throws Exception {
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(settings));
+        return new PkiRealmBootstrapCheck(sslService).check(createTestContext(settings, null));
     }
 
     public void testBootstrapCheckWithDisabledRealm() throws Exception {
@@ -100,7 +94,7 @@ public void testBootstrapCheckWithDisabledRealm() throws Exception {
                 .put("path.home", createTempDir())
                 .build();
         Environment env = TestEnvironment.newEnvironment(settings);
-        assertFalse(runCheck(settings, env).isFailure());
+        assertFalse(runCheck(settings).isFailure());
     }
 
     public void testBootstrapCheckWithDelegationEnabled() throws Exception {
@@ -119,8 +113,7 @@ public void testBootstrapCheckWithDelegationEnabled() throws Exception {
                 .put("path.home", createTempDir())
                 .setSecureSettings(secureSettings)
                 .build();
-        Environment env = TestEnvironment.newEnvironment(settings);
-        assertFalse(runCheck(settings, env).isFailure());
+        assertFalse(runCheck(settings).isFailure());
     }
 
     public void testBootstrapCheckWithClosedSecuredSetting() throws Exception {
@@ -140,7 +133,7 @@ public void testBootstrapCheckWithClosedSecuredSetting() throws Exception {
             .build();
 
         Environment env = TestEnvironment.newEnvironment(settings);
-        final PkiRealmBootstrapCheck check = new PkiRealmBootstrapCheck(new SSLService(settings, env));
+        final PkiRealmBootstrapCheck check = new PkiRealmBootstrapCheck(new SSLService(env));
         secureSettings.close();
         assertThat(check.check(createTestContext(settings, null)).isFailure(), Matchers.equalTo(expectFail));
     }
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/SecurityTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/SecurityTests.java
index 2d663ea619f9a..d5b513284510f 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/SecurityTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/SecurityTests.java
@@ -104,7 +104,7 @@ private Collection<Object> createComponents(Settings testSettings, SecurityExten
             .put("path.home", createTempDir()).build();
         Environment env = TestEnvironment.newEnvironment(settings);
         licenseState = new TestUtils.UpdatableLicenseState(settings);
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(env);
         security = new Security(settings, null, Arrays.asList(extensions)) {
             @Override
             protected XPackLicenseState getLicenseState() {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/oidc/TransportOpenIdConnectLogoutActionTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/oidc/TransportOpenIdConnectLogoutActionTests.java
index 387470090735b..d2ed6500036c4 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/oidc/TransportOpenIdConnectLogoutActionTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/oidc/TransportOpenIdConnectLogoutActionTests.java
@@ -182,8 +182,8 @@ public void setup() throws Exception {
         final RealmConfig.RealmIdentifier realmIdentifier = new RealmConfig.RealmIdentifier("oidc", REALM_NAME);
 
         final RealmConfig realmConfig = new RealmConfig(realmIdentifier, settings, env, threadContext);
-        oidcRealm = new OpenIdConnectRealm(realmConfig, new SSLService(sslSettings, env), mock(UserRoleMapper.class),
-            mock(ResourceWatcherService.class));
+        oidcRealm = new OpenIdConnectRealm(realmConfig, new SSLService(TestEnvironment.newEnvironment(sslSettings)),
+            mock(UserRoleMapper.class), mock(ResourceWatcherService.class));
         when(realms.realm(realmConfig.name())).thenReturn(oidcRealm);
     }
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/esnative/tool/CommandLineHttpClientTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/esnative/tool/CommandLineHttpClientTests.java
index 4f2484d193116..65ae66278cee2 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/esnative/tool/CommandLineHttpClientTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/esnative/tool/CommandLineHttpClientTests.java
@@ -8,7 +8,6 @@
 import org.elasticsearch.common.settings.MockSecureSettings;
 import org.elasticsearch.common.settings.SecureString;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.TestEnvironment;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.http.MockResponse;
@@ -36,7 +35,6 @@
 public class CommandLineHttpClientTests extends ESTestCase {
 
     private MockWebServer webServer;
-    private Environment environment = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
     private Path certPath;
     private Path keyPath;
 
@@ -60,7 +58,7 @@ public void testCommandLineHttpClientCanExecuteAndReturnCorrectResultUsingSSLSet
             .put("xpack.security.http.ssl.certificate_authorities", certPath.toString())
             .put("xpack.security.http.ssl.verification_mode", VerificationMode.CERTIFICATE)
             .build();
-        CommandLineHttpClient client = new CommandLineHttpClient(settings, environment);
+        CommandLineHttpClient client = new CommandLineHttpClient(TestEnvironment.newEnvironment(settings));
         HttpResponse httpResponse = client.execute("GET", new URL("https://localhost:" + webServer.getPort() + "/test"), "u1",
                 new SecureString(new char[]{'p'}), () -> null, is -> responseBuilder(is));
 
@@ -71,16 +69,17 @@ public void testCommandLineHttpClientCanExecuteAndReturnCorrectResultUsingSSLSet
 
     public void testGetDefaultURLFailsWithHelpfulMessage() {
         Settings settings = Settings.builder()
+            .put("path.home", createTempDir())
             .put("network.host", "_ec2:privateIpv4_")
             .build();
-        CommandLineHttpClient client = new CommandLineHttpClient(settings, environment);
+        CommandLineHttpClient client = new CommandLineHttpClient(TestEnvironment.newEnvironment(settings));
         assertThat(expectThrows(IllegalStateException.class, () -> client.getDefaultURL()).getMessage(),
             containsString("unable to determine default URL from settings, please use the -u option to explicitly provide the url"));
     }
 
     private MockWebServer createMockWebServer() {
         Settings settings = getHttpSslSettings().build();
-        TestsSSLService sslService = new TestsSSLService(settings, environment);
+        TestsSSLService sslService = new TestsSSLService(TestEnvironment.newEnvironment(settings));
         return new MockWebServer(sslService.sslContext("xpack.security.http.ssl."), false);
     }
 
@@ -88,6 +87,7 @@ private Settings.Builder getHttpSslSettings() {
         MockSecureSettings secureSettings = new MockSecureSettings();
         secureSettings.setString("xpack.security.http.ssl.secure_key_passphrase", "testnode");
         return Settings.builder()
+            .put("path.home", createTempDir())
             .put("xpack.security.http.ssl.enabled", true)
             .put("xpack.security.http.ssl.key", keyPath.toString())
             .put("xpack.security.http.ssl.certificate", certPath.toString())
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/esnative/tool/SetupPasswordToolTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/esnative/tool/SetupPasswordToolTests.java
index adb4fc58d3ed4..e80c4636e9766 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/esnative/tool/SetupPasswordToolTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/esnative/tool/SetupPasswordToolTests.java
@@ -124,7 +124,7 @@ public void setSecretsAndKeyStore() throws Exception {
 
     @Override
     protected Command newCommand() {
-        return new SetupPasswordTool((e, s) -> httpClient, (e) -> keyStore) {
+        return new SetupPasswordTool(env -> httpClient, env -> keyStore) {
 
             @Override
             protected AutoSetup newAutoSetup() {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ActiveDirectoryRealmTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ActiveDirectoryRealmTests.java
index 4080b318a2eeb..fea74c5d660be 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ActiveDirectoryRealmTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ActiveDirectoryRealmTests.java
@@ -143,7 +143,7 @@ public void start() throws Exception {
         threadPool = new TestThreadPool("active directory realm tests");
         resourceWatcherService = new ResourceWatcherService(Settings.EMPTY, threadPool);
         globalSettings = Settings.builder().put("path.home", createTempDir()).build();
-        sslService = new SSLService(globalSettings, TestEnvironment.newEnvironment(globalSettings));
+        sslService = new SSLService(TestEnvironment.newEnvironment(globalSettings));
         licenseState = new TestUtils.UpdatableLicenseState();
     }
 
@@ -168,7 +168,7 @@ public boolean enableWarningsCheck() {
     private RealmConfig setupRealm(RealmConfig.RealmIdentifier realmIdentifier, Settings localSettings) {
         final Settings mergedSettings = Settings.builder().put(globalSettings).put(localSettings).build();
         final Environment env = TestEnvironment.newEnvironment(mergedSettings);
-        this.sslService = new SSLService(mergedSettings, env);
+        this.sslService = new SSLService(env);
         return new RealmConfig(
             realmIdentifier,
             mergedSettings,
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapRealmTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapRealmTests.java
index a56c5550c65c2..39268be35a8db 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapRealmTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapRealmTests.java
@@ -99,7 +99,7 @@ public void init() throws Exception {
         threadPool = new TestThreadPool("ldap realm tests");
         resourceWatcherService = new ResourceWatcherService(Settings.EMPTY, threadPool);
         defaultGlobalSettings = Settings.builder().put("path.home", createTempDir()).build();
-        sslService = new SSLService(defaultGlobalSettings, TestEnvironment.newEnvironment(defaultGlobalSettings));
+        sslService = new SSLService(TestEnvironment.newEnvironment(defaultGlobalSettings));
         licenseState = mock(XPackLicenseState.class);
         when(licenseState.isAuthorizationRealmAllowed()).thenReturn(true);
     }
@@ -305,6 +305,7 @@ public void testLdapRealmSelectsLdapSessionFactory() throws Exception {
         String userTemplate = VALID_USER_TEMPLATE;
         Settings settings = Settings.builder()
                 .put(defaultGlobalSettings)
+
                 .putList(getFullSettingKey(identifier, URLS_SETTING), ldapUrls())
                 .putList(getFullSettingKey(identifier.getName(), LdapSessionFactorySettings.USER_DN_TEMPLATES_SETTING), userTemplate)
                 .put(getFullSettingKey(identifier, SearchGroupsResolverSettings.BASE_DN), groupSearchBase)
@@ -312,7 +313,8 @@ public void testLdapRealmSelectsLdapSessionFactory() throws Exception {
                 .put(getFullSettingKey(identifier, SSLConfigurationSettings.VERIFICATION_MODE_SETTING_REALM), VerificationMode.CERTIFICATE)
                 .build();
         RealmConfig config = getRealmConfig(identifier, settings);
-        SessionFactory sessionFactory = LdapRealm.sessionFactory(config, new SSLService(settings, config.env()), threadPool);
+        final SSLService ssl = new SSLService(config.env());
+        SessionFactory sessionFactory = LdapRealm.sessionFactory(config, ssl, threadPool);
         assertThat(sessionFactory, is(instanceOf(LdapSessionFactory.class)));
     }
 
@@ -332,7 +334,7 @@ public void testLdapRealmSelectsLdapUserSearchSessionFactory() throws Exception
                 .put(getFullSettingKey(identifier, SSLConfigurationSettings.VERIFICATION_MODE_SETTING_REALM), VerificationMode.CERTIFICATE)
                 .build();
         final RealmConfig config = getRealmConfig(identifier, settings);
-        SessionFactory sessionFactory = LdapRealm.sessionFactory(config, new SSLService(config.settings(), config.env()), threadPool);
+        SessionFactory sessionFactory = LdapRealm.sessionFactory(config, new SSLService(config.env()), threadPool);
         try {
             assertThat(sessionFactory, is(instanceOf(LdapUserSearchSessionFactory.class)));
         } finally {
@@ -530,7 +532,7 @@ public void testUsageStats() throws Exception {
 
         RealmConfig config = getRealmConfig(identifier, settings.build());
 
-        LdapSessionFactory ldapFactory = new LdapSessionFactory(config, new SSLService(config.settings(), config.env()), threadPool);
+        LdapSessionFactory ldapFactory = new LdapSessionFactory(config, new SSLService(config.env()), threadPool);
         LdapRealm realm = new LdapRealm(config, ldapFactory, new DnRoleMapper(config, resourceWatcherService), threadPool);
         realm.initialize(Collections.singleton(realm), licenseState);
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapSessionFactoryTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapSessionFactoryTests.java
index f7f38d41a2d66..3ba6d0da34824 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapSessionFactoryTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapSessionFactoryTests.java
@@ -63,7 +63,7 @@ public void setup() throws Exception {
             .put("path.home", createTempDir())
             .putList(RealmSettings.realmSslPrefix(REALM_IDENTIFIER) + "certificate_authorities", ldapCaPath.toString())
             .build();
-        sslService = new SSLService(globalSettings, TestEnvironment.newEnvironment(globalSettings));
+        sslService = new SSLService(TestEnvironment.newEnvironment(globalSettings));
         threadPool = new TestThreadPool("LdapSessionFactoryTests thread pool");
     }
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapTestUtils.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapTestUtils.java
index 65eb36aeba73b..f8d1281434567 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapTestUtils.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapTestUtils.java
@@ -40,7 +40,7 @@ public static LDAPConnection openConnection(String url, String bindDN, String bi
         secureSettings.setString("xpack.security.authc.realms.ldap.bar.ssl.truststore.secure_password", "changeit");
         Settings settings = builder.build();
         Environment env = TestEnvironment.newEnvironment(settings);
-        SSLService sslService = new SSLService(settings, env);
+        SSLService sslService = new SSLService(env);
 
         LDAPURL ldapurl = new LDAPURL(url);
         LDAPConnectionOptions options = new LDAPConnectionOptions();
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapUserSearchSessionFactoryTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapUserSearchSessionFactoryTests.java
index d6a370d9d3464..b59d95cb7a9da 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapUserSearchSessionFactoryTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapUserSearchSessionFactoryTests.java
@@ -21,7 +21,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
-import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.TestEnvironment;
 import org.elasticsearch.threadpool.TestThreadPool;
 import org.elasticsearch.threadpool.ThreadPool;
@@ -56,7 +55,6 @@ public class LdapUserSearchSessionFactoryTests extends LdapTestCase {
     @Before
     public void init() throws Exception {
         Path certPath = getDataPath("support/smb_ca.crt");
-        Environment env = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
         /*
          * Prior to each test we reinitialize the socket factory with a new SSLService so that we get a new SSLContext.
          * If we re-use an SSLContext, previously connected sessions can get re-established which breaks hostname
@@ -68,7 +66,7 @@ public void init() throws Exception {
             .put("xpack.security.transport.ssl.enabled", false)
             .put("xpack.security.transport.ssl.certificate_authorities", certPath)
             .build();
-        sslService = new SSLService(globalSettings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(globalSettings));
         threadPool = new TestThreadPool("LdapUserSearchSessionFactoryTests");
     }
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/support/SessionFactoryLoadBalancingTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/support/SessionFactoryLoadBalancingTests.java
index 7c80de3ace4fe..f0ace87cd6990 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/support/SessionFactoryLoadBalancingTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/support/SessionFactoryLoadBalancingTests.java
@@ -292,7 +292,7 @@ private TestSessionFactory createSessionFactory(LdapLoadBalancing loadBalancing)
         Settings globalSettings = Settings.builder().put("path.home", createTempDir()).put(settings).build();
         RealmConfig config = new RealmConfig(REALM_IDENTIFIER, globalSettings,
                 TestEnvironment.newEnvironment(globalSettings), new ThreadContext(Settings.EMPTY));
-        return new TestSessionFactory(config, new SSLService(Settings.EMPTY, TestEnvironment.newEnvironment(config.settings())),
+        return new TestSessionFactory(config, new SSLService(TestEnvironment.newEnvironment(config.settings())),
                 threadPool);
     }
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/support/SessionFactoryTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/support/SessionFactoryTests.java
index bb93e95950e86..313cd943f19a3 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/support/SessionFactoryTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/support/SessionFactoryTests.java
@@ -52,7 +52,7 @@ public void testConnectionFactoryReturnsCorrectLDAPConnectionOptionsWithDefaultS
         final Environment environment = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
         RealmConfig realmConfig = new RealmConfig(new RealmConfig.RealmIdentifier("ldap", "conn_settings"),
                 environment.settings(), environment, new ThreadContext(Settings.EMPTY));
-        LDAPConnectionOptions options = SessionFactory.connectionOptions(realmConfig, new SSLService(environment.settings(), environment),
+        LDAPConnectionOptions options = SessionFactory.connectionOptions(realmConfig, new SSLService(environment),
                 logger);
         assertThat(options.followReferrals(), is(equalTo(true)));
         assertThat(options.allowConcurrentSocketFactoryUse(), is(equalTo(true)));
@@ -72,9 +72,9 @@ public void testConnectionFactoryReturnsCorrectLDAPConnectionOptions() throws Ex
                 .put("path.home", pathHome)
                 .build();
 
-        final Environment environment = TestEnvironment.newEnvironment(settings);
+        Environment environment = TestEnvironment.newEnvironment(settings);
         RealmConfig realmConfig = new RealmConfig(realmId, settings, environment, new ThreadContext(settings));
-        LDAPConnectionOptions options = SessionFactory.connectionOptions(realmConfig, new SSLService(settings, environment), logger);
+        LDAPConnectionOptions options = SessionFactory.connectionOptions(realmConfig, new SSLService(environment), logger);
         assertThat(options.followReferrals(), is(equalTo(false)));
         assertThat(options.allowConcurrentSocketFactoryUse(), is(equalTo(true)));
         assertThat(options.getConnectTimeoutMillis(), is(equalTo(10)));
@@ -88,7 +88,7 @@ public void testConnectionFactoryReturnsCorrectLDAPConnectionOptions() throws Ex
                 .put("path.home", pathHome)
                 .build();
         realmConfig = new RealmConfig(realmId, settings, environment, new ThreadContext(settings));
-        options = SessionFactory.connectionOptions(realmConfig, new SSLService(settings, environment), logger);
+        options = SessionFactory.connectionOptions(realmConfig, new SSLService(TestEnvironment.newEnvironment(settings)), logger);
         assertThat(options.getSSLSocketVerifier(), is(instanceOf(TrustAllSSLSocketVerifier.class)));
 
         // Can't run in FIPS with verification_mode none, disable this check instead of duplicating the test case
@@ -97,8 +97,9 @@ public void testConnectionFactoryReturnsCorrectLDAPConnectionOptions() throws Ex
                     .put(getFullSettingKey(realmId, SSLConfigurationSettings.VERIFICATION_MODE_SETTING_REALM), VerificationMode.NONE)
                     .put("path.home", pathHome)
                     .build();
+            environment = TestEnvironment.newEnvironment(settings);
             realmConfig = new RealmConfig(realmId, settings, environment, new ThreadContext(settings));
-            options = SessionFactory.connectionOptions(realmConfig, new SSLService(settings, environment), logger);
+            options = SessionFactory.connectionOptions(realmConfig, new SSLService(environment), logger);
             assertThat(options.getSSLSocketVerifier(), is(instanceOf(TrustAllSSLSocketVerifier.class)));
         }
 
@@ -106,8 +107,9 @@ public void testConnectionFactoryReturnsCorrectLDAPConnectionOptions() throws Ex
                 .put(getFullSettingKey(realmId, SSLConfigurationSettings.VERIFICATION_MODE_SETTING_REALM), VerificationMode.FULL)
                 .put("path.home", pathHome)
                 .build();
+        environment = TestEnvironment.newEnvironment(settings);
         realmConfig = new RealmConfig(realmId, settings, environment, new ThreadContext(settings));
-        options = SessionFactory.connectionOptions(realmConfig, new SSLService(settings, environment), logger);
+        options = SessionFactory.connectionOptions(realmConfig, new SSLService(environment), logger);
         assertThat(options.getSSLSocketVerifier(), is(instanceOf(HostNameSSLSocketVerifier.class)));
     }
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectAuthenticatorTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectAuthenticatorTests.java
index ad4b9fcd2af81..bf0bdbee13e9c 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectAuthenticatorTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectAuthenticatorTests.java
@@ -86,14 +86,13 @@
 public class OpenIdConnectAuthenticatorTests extends OpenIdConnectTestCase {
 
     private OpenIdConnectAuthenticator authenticator;
-    private Settings globalSettings;
     private Environment env;
     private ThreadContext threadContext;
     private int callsToReloadJwk;
 
     @Before
     public void setup() {
-        globalSettings = Settings.builder().put("path.home", createTempDir())
+        final Settings globalSettings = Settings.builder().put("path.home", createTempDir())
             .put("xpack.security.authc.realms.oidc.oidc-realm.ssl.verification_mode", "certificate").build();
         env = TestEnvironment.newEnvironment(globalSettings);
         threadContext = new ThreadContext(globalSettings);
@@ -109,7 +108,7 @@ public void cleanup() {
 
     private OpenIdConnectAuthenticator buildAuthenticator() throws URISyntaxException {
         final RealmConfig config = buildConfig(getBasicRealmSettings().build(), threadContext);
-        return new OpenIdConnectAuthenticator(config, getOpConfig(), getDefaultRpConfig(), new SSLService(globalSettings, env), null);
+        return new OpenIdConnectAuthenticator(config, getOpConfig(), getDefaultRpConfig(), new SSLService(env), null);
     }
 
     private OpenIdConnectAuthenticator buildAuthenticator(OpenIdConnectProviderConfiguration opConfig, RelyingPartyConfiguration rpConfig,
@@ -117,7 +116,7 @@ private OpenIdConnectAuthenticator buildAuthenticator(OpenIdConnectProviderConfi
         final RealmConfig config = buildConfig(getBasicRealmSettings().build(), threadContext);
         final JWSVerificationKeySelector keySelector = new JWSVerificationKeySelector(rpConfig.getSignatureAlgorithm(), jwkSource);
         final IDTokenValidator validator = new IDTokenValidator(opConfig.getIssuer(), rpConfig.getClientId(), keySelector, null);
-        return new OpenIdConnectAuthenticator(config, opConfig, rpConfig, new SSLService(globalSettings, env), validator,
+        return new OpenIdConnectAuthenticator(config, opConfig, rpConfig, new SSLService(env), validator,
             null);
     }
 
@@ -126,7 +125,7 @@ private OpenIdConnectAuthenticator buildAuthenticator(OpenIdConnectProviderConfi
         final RealmConfig config = buildConfig(getBasicRealmSettings().build(), threadContext);
         final IDTokenValidator validator = new IDTokenValidator(opConfig.getIssuer(), rpConfig.getClientId(),
             rpConfig.getSignatureAlgorithm(), new Secret(rpConfig.getClientSecret().toString()));
-        return new OpenIdConnectAuthenticator(config, opConfig, rpConfig, new SSLService(globalSettings, env), validator,
+        return new OpenIdConnectAuthenticator(config, opConfig, rpConfig, new SSLService(env), validator,
             null);
     }
 
@@ -984,7 +983,7 @@ private Tuple<Key, JWKSet> getRandomJwkForType(String type) throws Exception {
         } else {
             throw new IllegalArgumentException("Invalid key type :" + type);
         }
-        return new Tuple(key, new JWKSet(jwk));
+        return new Tuple<>(key, new JWKSet(jwk));
     }
 
     private Curve curveFromHashSize(int size) {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTests.java
index b4800c798a7f5..9b86075107876 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTests.java
@@ -141,7 +141,7 @@ public void testReadIdpMetadataFromHttps() throws Exception {
             .put("path.home", createTempDir())
             .setSecureSettings(mockSecureSettings)
             .build();
-        TestsSSLService sslService = new TestsSSLService(settings, TestEnvironment.newEnvironment(settings));
+        TestsSSLService sslService = new TestsSSLService(TestEnvironment.newEnvironment(settings));
         try (MockWebServer proxyServer =
                      new MockWebServer(sslService.sslContext("xpack.security.http.ssl"), false)) {
             proxyServer.start();
@@ -690,9 +690,8 @@ private EntityDescriptor mockIdp() {
 
     private Tuple<RealmConfig, SSLService> buildConfig(String idpMetaDataPath) throws Exception {
         Settings globalSettings = buildSettings(idpMetaDataPath).build();
-        final Environment env = TestEnvironment.newEnvironment(globalSettings);
         final RealmConfig config = realmConfigFromGlobalSettings(globalSettings);
-        final SSLService sslService = new SSLService(globalSettings, env);
+        final SSLService sslService = new SSLService(config.env());
         return new Tuple<>(config, sslService);
     }
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/AbstractSimpleSecurityTransportTestCase.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/AbstractSimpleSecurityTransportTestCase.java
index ffb470083e90e..1dd7981af5038 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/AbstractSimpleSecurityTransportTestCase.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/AbstractSimpleSecurityTransportTestCase.java
@@ -90,7 +90,7 @@ protected SSLService createSSLService(Settings settings) {
             .setSecureSettings(secureSettings)
             .build();
         try {
-            return new SSLService(settings1, TestEnvironment.newEnvironment(settings1));
+            return new SSLService(TestEnvironment.newEnvironment(settings1));
         } catch (Exception e) {
             throw new RuntimeException(e);
         }
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/netty4/SecurityNetty4HttpServerTransportTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/netty4/SecurityNetty4HttpServerTransportTests.java
index 8efa61ebe40b6..e73a4ad715109 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/netty4/SecurityNetty4HttpServerTransportTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/netty4/SecurityNetty4HttpServerTransportTests.java
@@ -55,14 +55,14 @@ public void createSSLService() {
             .setSecureSettings(secureSettings)
             .build();
         env = TestEnvironment.newEnvironment(settings);
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(env);
     }
 
     public void testDefaultClientAuth() throws Exception {
         Settings settings = Settings.builder()
                 .put(env.settings())
                 .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true).build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SecurityNetty4HttpServerTransport transport = new SecurityNetty4HttpServerTransport(settings,
                 new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(IPFilter.class), sslService,
                 mock(ThreadPool.class), xContentRegistry(), new NullDispatcher());
@@ -78,7 +78,7 @@ public void testOptionalClientAuth() throws Exception {
                 .put(env.settings())
                 .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true)
                 .put("xpack.security.http.ssl.client_authentication", value).build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SecurityNetty4HttpServerTransport transport = new SecurityNetty4HttpServerTransport(settings,
                 new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(IPFilter.class), sslService,
                 mock(ThreadPool.class), xContentRegistry(), new NullDispatcher());
@@ -94,7 +94,7 @@ public void testRequiredClientAuth() throws Exception {
                 .put(env.settings())
                 .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true)
                 .put("xpack.security.http.ssl.client_authentication", value).build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SecurityNetty4HttpServerTransport transport = new SecurityNetty4HttpServerTransport(settings,
                 new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(IPFilter.class), sslService,
                 mock(ThreadPool.class), xContentRegistry(), new NullDispatcher());
@@ -110,7 +110,7 @@ public void testNoClientAuth() throws Exception {
                 .put(env.settings())
                 .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true)
                 .put("xpack.security.http.ssl.client_authentication", value).build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SecurityNetty4HttpServerTransport transport = new SecurityNetty4HttpServerTransport(settings,
                 new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(IPFilter.class), sslService,
                 mock(ThreadPool.class), xContentRegistry(), new NullDispatcher());
@@ -124,7 +124,7 @@ public void testCustomSSLConfiguration() throws Exception {
         Settings settings = Settings.builder()
                 .put(env.settings())
                 .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true).build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SecurityNetty4HttpServerTransport transport = new SecurityNetty4HttpServerTransport(settings,
                 new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(IPFilter.class), sslService,
                 mock(ThreadPool.class), xContentRegistry(), new NullDispatcher());
@@ -137,7 +137,7 @@ public void testCustomSSLConfiguration() throws Exception {
                 .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true)
                 .put("xpack.security.http.ssl.supported_protocols", "TLSv1.2")
                 .build();
-        sslService = new SSLService(settings, TestEnvironment.newEnvironment(settings));
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         transport = new SecurityNetty4HttpServerTransport(settings, new NetworkService(Collections.emptyList()),
                 mock(BigArrays.class), mock(IPFilter.class), sslService, mock(ThreadPool.class), xContentRegistry(), new NullDispatcher());
         handler = transport.configureServerChannelHandler();
@@ -158,7 +158,7 @@ public void testNoExceptionWhenConfiguredWithoutSslKeySSLDisabled() throws Excep
             .put("path.home", createTempDir())
             .build();
         env = TestEnvironment.newEnvironment(settings);
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(env);
         SecurityNetty4HttpServerTransport transport = new SecurityNetty4HttpServerTransport(settings,
                 new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(IPFilter.class), sslService,
                 mock(ThreadPool.class), xContentRegistry(), new NullDispatcher());
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/nio/SecurityNioHttpServerTransportTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/nio/SecurityNioHttpServerTransportTests.java
index 14addd0620b43..f1474ccc77145 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/nio/SecurityNioHttpServerTransportTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/nio/SecurityNioHttpServerTransportTests.java
@@ -63,7 +63,7 @@ public void createSSLService() {
             .setSecureSettings(secureSettings)
             .build();
         env = TestEnvironment.newEnvironment(settings);
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(env);
     }
 
     public void testDefaultClientAuth() throws IOException {
@@ -71,7 +71,7 @@ public void testDefaultClientAuth() throws IOException {
             .put(env.settings())
             .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true).build();
         nioGroupFactory = new NioGroupFactory(settings, logger);
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SecurityNioHttpServerTransport transport = new SecurityNioHttpServerTransport(settings,
             new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(PageCacheRecycler.class), mock(ThreadPool.class),
             xContentRegistry(), new NullDispatcher(), mock(IPFilter.class), sslService, nioGroupFactory);
@@ -91,7 +91,7 @@ public void testOptionalClientAuth() throws IOException {
             .put(env.settings())
             .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true)
             .put("xpack.security.http.ssl.client_authentication", value).build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         nioGroupFactory = new NioGroupFactory(settings, logger);
         SecurityNioHttpServerTransport transport = new SecurityNioHttpServerTransport(settings,
             new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(PageCacheRecycler.class), mock(ThreadPool.class),
@@ -113,7 +113,7 @@ public void testRequiredClientAuth() throws IOException {
             .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true)
             .put("xpack.security.http.ssl.client_authentication", value).build();
         nioGroupFactory = new NioGroupFactory(settings, logger);
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SecurityNioHttpServerTransport transport = new SecurityNioHttpServerTransport(settings,
             new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(PageCacheRecycler.class), mock(ThreadPool.class),
             xContentRegistry(), new NullDispatcher(), mock(IPFilter.class), sslService, nioGroupFactory);
@@ -133,7 +133,7 @@ public void testNoClientAuth() throws IOException {
             .put(env.settings())
             .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true)
             .put("xpack.security.http.ssl.client_authentication", value).build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         nioGroupFactory = new NioGroupFactory(settings, logger);
         SecurityNioHttpServerTransport transport = new SecurityNioHttpServerTransport(settings,
             new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(PageCacheRecycler.class), mock(ThreadPool.class),
@@ -152,7 +152,7 @@ public void testCustomSSLConfiguration() throws IOException {
         Settings settings = Settings.builder()
             .put(env.settings())
             .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true).build();
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         nioGroupFactory = new NioGroupFactory(settings, logger);
         SecurityNioHttpServerTransport transport = new SecurityNioHttpServerTransport(settings,
             new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(PageCacheRecycler.class), mock(ThreadPool.class),
@@ -168,7 +168,7 @@ public void testCustomSSLConfiguration() throws IOException {
             .put(XPackSettings.HTTP_SSL_ENABLED.getKey(), true)
             .put("xpack.security.http.ssl.supported_protocols", "TLSv1.2")
             .build();
-        sslService = new SSLService(settings, TestEnvironment.newEnvironment(settings));
+        sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         nioGroupFactory = new NioGroupFactory(settings, logger);
         transport = new SecurityNioHttpServerTransport(settings,
             new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(PageCacheRecycler.class), mock(ThreadPool.class),
@@ -191,7 +191,7 @@ public void testNoExceptionWhenConfiguredWithoutSslKeySSLDisabled() {
             .put("path.home", createTempDir())
             .build();
         env = TestEnvironment.newEnvironment(settings);
-        sslService = new SSLService(settings, env);
+        sslService = new SSLService(env);
         nioGroupFactory = new NioGroupFactory(settings, logger);
         SecurityNioHttpServerTransport transport = new SecurityNioHttpServerTransport(settings,
             new NetworkService(Collections.emptyList()), mock(BigArrays.class), mock(PageCacheRecycler.class), mock(ThreadPool.class),
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/ssl/SslIntegrationTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/ssl/SslIntegrationTests.java
index 741b70c2258c3..7d24b273de209 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/ssl/SslIntegrationTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/transport/ssl/SslIntegrationTests.java
@@ -19,6 +19,7 @@
 import org.elasticsearch.common.network.NetworkAddress;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.transport.TransportAddress;
+import org.elasticsearch.env.TestEnvironment;
 import org.elasticsearch.http.HttpServerTransport;
 import org.elasticsearch.test.SecurityIntegTestCase;
 import org.elasticsearch.xpack.core.common.socket.SocketAccess;
@@ -68,7 +69,7 @@ public void testThatConnectionToHTTPWorks() throws Exception {
             "/org/elasticsearch/xpack/security/transport/ssl/certs/simple/testclient.crt",
             "xpack.security.http.",
             Arrays.asList("/org/elasticsearch/xpack/security/transport/ssl/certs/simple/testnode.crt"));
-        SSLService service = new SSLService(builder.build(), newEnvironment());
+        SSLService service = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(builder.build())));
 
         CredentialsProvider provider = new BasicCredentialsProvider();
         provider.setCredentials(AuthScope.ANY, new UsernamePasswordCredentials(nodeClientUsername(),
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLErrorMessageCertificateVerificationTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLErrorMessageCertificateVerificationTests.java
index 691b6501273a5..2c21b3984309a 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLErrorMessageCertificateVerificationTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLErrorMessageCertificateVerificationTests.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.common.logging.Loggers;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.ssl.DiagnosticTrustManager;
+import org.elasticsearch.env.TestEnvironment;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.MockLogAppender;
 import org.elasticsearch.test.http.MockResponse;
@@ -58,7 +59,7 @@ public void testMessageForHttpClientHostnameVerificationFailure() throws IOExcep
             SSLClientAuth.NONE, VerificationMode.FULL, null)
             .putList("xpack.http.ssl.certificate_authorities", getPath("ca1.crt"))
             .build();
-        final SSLService sslService = new SSLService(sslSetup, newEnvironment());
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(sslSetup)));
         try (MockWebServer webServer = initWebServer(sslService);
              CloseableHttpClient client = buildHttpClient(sslService)) {
             final HttpGet request = new HttpGet(webServer.getUri("/"));
@@ -79,7 +80,7 @@ public void testMessageForRestClientHostnameVerificationFailure() throws IOExcep
             // Client
             .putList("xpack.http.ssl.certificate_authorities", getPath("ca1.crt"))
             .build();
-        final SSLService sslService = new SSLService(sslSetup, newEnvironment());
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(sslSetup)));
         try (MockWebServer webServer = initWebServer(sslService)) {
             try (RestClient restClient = buildRestClient(sslService, webServer)) {
                 restClient.performRequest(new Request("GET", "/"));
@@ -98,7 +99,7 @@ public void testDiagnosticTrustManagerForHostnameVerificationFailure() throws Ex
             SSLClientAuth.NONE, VerificationMode.FULL, null)
             .putList("xpack.http.ssl.certificate_authorities", getPath("ca1.crt"))
             .build();
-        final SSLService sslService = new SSLService(settings, newEnvironment());
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings)));
         final SSLConfiguration clientSslConfig = sslService.getSSLConfiguration(HTTP_CLIENT_SSL);
         final SSLSocketFactory clientSocketFactory = sslService.sslSocketFactory(clientSslConfig);
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLErrorMessageFileTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLErrorMessageFileTests.java
index de12f2c3cf331..5efce0a8ab0fa 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLErrorMessageFileTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLErrorMessageFileTests.java
@@ -346,10 +346,12 @@ private Settings.Builder configureWorkingKeystore(String prefix, Settings.Builde
     }
 
     private ElasticsearchException expectFailure(Settings.Builder settings) {
-        return expectThrows(ElasticsearchException.class, () -> new SSLService(settings.build(), env));
+        return expectThrows(ElasticsearchException.class,
+            () -> new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings.build()))));
     }
+
     private SSLService expectSuccess(Settings.Builder settings) {
-        return new SSLService(settings.build(), env);
+        return new SSLService(TestEnvironment.newEnvironment(buildEnvSettings(settings.build())));
     }
 
     private String resource(String fileName) {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLReloadIntegTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLReloadIntegTests.java
index 6354ddb5046c3..6f51f453f9178 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLReloadIntegTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLReloadIntegTests.java
@@ -108,7 +108,7 @@ public void testThatSSLConfigurationReloadsOnModification() throws Exception {
             .setSecureSettings(secureSettings)
             .build();
         String node = randomFrom(internalCluster().getNodeNames());
-        SSLService sslService = new SSLService(settings, TestEnvironment.newEnvironment(settings));
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SSLConfiguration sslConfiguration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         SSLSocketFactory sslSocketFactory = sslService.sslSocketFactory(sslConfiguration);
         TransportAddress address = internalCluster()
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLTrustRestrictionsTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLTrustRestrictionsTests.java
index 2f097480f928d..e23ed8dcb20a3 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLTrustRestrictionsTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/ssl/SSLTrustRestrictionsTests.java
@@ -221,7 +221,7 @@ private void tryConnect(CertificateInfo certificate, boolean shouldFail) throws
                 .build();
 
         String node = randomFrom(internalCluster().getNodeNames());
-        SSLService sslService = new SSLService(settings, TestEnvironment.newEnvironment(settings));
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         SSLConfiguration sslConfiguration = sslService.getSSLConfiguration("xpack.security.transport.ssl");
         SSLSocketFactory sslSocketFactory = sslService.sslSocketFactory(sslConfiguration);
         TransportAddress address = internalCluster().getInstance(Transport.class, node).boundAddress().publishAddress();
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/email/EmailSslTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/email/EmailSslTests.java
index 70d7f2f6dd5ee..91bf327a37e18 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/email/EmailSslTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/email/EmailSslTests.java
@@ -138,7 +138,7 @@ private ExecutableEmailAction buildEmailAction(Settings.Builder baseSettings, Mo
         Set<Setting<?>> registeredSettings = new HashSet<>(ClusterSettings.BUILT_IN_CLUSTER_SETTINGS);
         registeredSettings.addAll(EmailService.getSettings());
         ClusterSettings clusterSettings = new ClusterSettings(settings, registeredSettings);
-        SSLService sslService = new SSLService(settings, TestEnvironment.newEnvironment(settings));
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(settings));
         final EmailService emailService = new EmailService(settings, null, sslService, clusterSettings);
         EmailTemplate emailTemplate = EmailTemplate.builder().from("from@example.org").to("to@example.org")
             .subject("subject").textBody("body").build();
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/webhook/WebhookActionTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/webhook/WebhookActionTests.java
index 439eb45f0159f..7cb87c62a2a3a 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/webhook/WebhookActionTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/webhook/WebhookActionTests.java
@@ -215,7 +215,7 @@ private WebhookActionFactory webhookFactory(HttpClient client) {
     public void testThatSelectingProxyWorks() throws Exception {
         Environment environment = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
 
-        try (HttpClient httpClient = new HttpClient(Settings.EMPTY, new SSLService(environment.settings(), environment), null,
+        try (HttpClient httpClient = new HttpClient(Settings.EMPTY, new SSLService(environment), null,
             mockClusterService());
              MockWebServer proxyServer = new MockWebServer()) {
             proxyServer.start();
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/webhook/WebhookHttpsIntegrationTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/webhook/WebhookHttpsIntegrationTests.java
index c03d924cd6faa..1deced67b3d23 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/webhook/WebhookHttpsIntegrationTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/actions/webhook/WebhookHttpsIntegrationTests.java
@@ -64,8 +64,8 @@ protected Settings nodeSettings(int nodeOrdinal) {
 
     @Before
     public void startWebservice() throws Exception {
-        Settings settings = getInstanceFromMaster(Settings.class);
-        TestsSSLService sslService = new TestsSSLService(settings, getInstanceFromMaster(Environment.class));
+        final Environment environment = getInstanceFromMaster(Environment.class);
+        final TestsSSLService sslService = new TestsSSLService(environment);
         webServer = new MockWebServer(sslService.sslContext("xpack.http.ssl"), false);
         webServer.start();
     }
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpClientTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpClientTests.java
index e83f9154c5459..f820b530de26d 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpClientTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpClientTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.watcher.common.http;
 
-import com.carrotsearch.randomizedtesting.generators.RandomStrings;
 import com.sun.net.httpserver.HttpsServer;
 import org.apache.http.HttpHeaders;
 import org.apache.http.HttpHost;
@@ -86,7 +85,7 @@ public void init() throws Exception {
         ClusterService clusterService = mock(ClusterService.class);
         ClusterSettings clusterSettings = new ClusterSettings(Settings.EMPTY, new HashSet<>(HttpSettings.getSettings()));
         when(clusterService.getClusterSettings()).thenReturn(clusterSettings);
-        httpClient = new HttpClient(Settings.EMPTY, new SSLService(environment.settings(), environment), null, clusterService);
+        httpClient = new HttpClient(Settings.EMPTY, new SSLService(environment), null, clusterService);
     }
 
     @After
@@ -189,14 +188,17 @@ public void testHttps() throws Exception {
         Path keyPath = getDataPath("/org/elasticsearch/xpack/security/keystore/testnode.pem");
         MockSecureSettings secureSettings = new MockSecureSettings();
         Settings settings = Settings.builder()
+            .put(environment.settings())
             .put("xpack.http.ssl.certificate_authorities", trustedCertPath)
             .setSecureSettings(secureSettings)
             .build();
-        try (HttpClient client = new HttpClient(settings, new SSLService(settings, environment), null, mockClusterService())) {
+        final SSLService ssl = new SSLService(TestEnvironment.newEnvironment(settings));
+        try (HttpClient client = new HttpClient(settings, ssl, null, mockClusterService())) {
             secureSettings = new MockSecureSettings();
             // We can't use the client created above for the server since it is only a truststore
             secureSettings.setString("xpack.security.http.ssl.secure_key_passphrase", "testnode");
             Settings settings2 = Settings.builder()
+                .put(environment.settings())
                 .put("xpack.security.http.ssl.enabled", true)
                 .put("xpack.security.http.ssl.key", keyPath)
                 .put("xpack.security.http.ssl.certificate", certPath)
@@ -204,7 +206,7 @@ public void testHttps() throws Exception {
                 .setSecureSettings(secureSettings)
                 .build();
 
-            TestsSSLService sslService = new TestsSSLService(settings2, environment);
+            TestsSSLService sslService = new TestsSSLService(TestEnvironment.newEnvironment(settings2));
             testSslMockWebserver(client, sslService.sslContext("xpack.security.http.ssl"), false);
         }
     }
@@ -212,8 +214,8 @@ public void testHttps() throws Exception {
     public void testHttpsDisableHostnameVerification() throws Exception {
         Path certPath = getDataPath("/org/elasticsearch/xpack/security/transport/ssl/certs/simple/testnode-no-subjaltname.crt");
         Path keyPath = getDataPath("/org/elasticsearch/xpack/security/transport/ssl/certs/simple/testnode-no-subjaltname.pem");
-        Settings settings;
         Settings.Builder builder = Settings.builder()
+            .put(environment.settings())
             .put("xpack.http.ssl.certificate_authorities", certPath);
         if (inFipsJvm()) {
             //Can't use TrustAllConfig in FIPS mode
@@ -221,12 +223,14 @@ public void testHttpsDisableHostnameVerification() throws Exception {
         } else {
             builder.put("xpack.http.ssl.verification_mode", randomFrom(VerificationMode.NONE, VerificationMode.CERTIFICATE));
         }
-        settings = builder.build();
-        try (HttpClient client = new HttpClient(settings, new SSLService(settings, environment), null, mockClusterService())) {
+        final Settings settings = builder.build();
+        final SSLService ssl = new SSLService(TestEnvironment.newEnvironment(settings));
+        try (HttpClient client = new HttpClient(settings, ssl, null, mockClusterService())) {
             MockSecureSettings secureSettings = new MockSecureSettings();
             // We can't use the client created above for the server since it only defines a truststore
             secureSettings.setString("xpack.security.http.ssl.secure_key_passphrase", "testnode-no-subjaltname");
             Settings settings2 = Settings.builder()
+                .put(environment.settings())
                 .put("xpack.security.http.ssl.enabled", true)
                 .put("xpack.security.http.ssl.key", keyPath)
                 .put("xpack.security.http.ssl.certificate", certPath)
@@ -234,8 +238,8 @@ public void testHttpsDisableHostnameVerification() throws Exception {
                 .setSecureSettings(secureSettings)
                 .build();
 
-            TestsSSLService sslService = new TestsSSLService(settings2, environment);
-            testSslMockWebserver(client, sslService.sslContext("xpack.security.http.ssl"), false);
+            TestsSSLService ssl2 = new TestsSSLService(TestEnvironment.newEnvironment(settings2));
+            testSslMockWebserver(client, ssl2.sslContext("xpack.security.http.ssl"), false);
         }
     }
 
@@ -245,13 +249,14 @@ public void testHttpsClientAuth() throws Exception {
         MockSecureSettings secureSettings = new MockSecureSettings();
         secureSettings.setString("xpack.http.ssl.secure_key_passphrase", "testnode");
         Settings settings = Settings.builder()
+            .put(environment.settings())
             .put("xpack.http.ssl.key", keyPath)
             .put("xpack.http.ssl.certificate", certPath)
             .putList("xpack.http.ssl.supported_protocols", getProtocols())
             .setSecureSettings(secureSettings)
             .build();
 
-        TestsSSLService sslService = new TestsSSLService(settings, environment);
+        TestsSSLService sslService = new TestsSSLService(TestEnvironment.newEnvironment(settings));
         try (HttpClient client = new HttpClient(settings, sslService, null, mockClusterService())) {
             testSslMockWebserver(client, sslService.sslContext("xpack.http.ssl"), true);
         }
@@ -275,9 +280,9 @@ private void testSslMockWebserver(HttpClient client, SSLContext sslContext, bool
     }
 
     public void testHttpResponseWithAnyStatusCodeCanReturnBody() throws Exception {
-        int statusCode = randomFrom(200, 201, 400, 401, 403, 404, 405, 409, 413, 429, 500, 503);
-        String body = RandomStrings.randomAsciiOfLength(random(), 100);
-        boolean hasBody = usually();
+        final int statusCode = randomFrom(200, 201, 400, 401, 403, 404, 405, 409, 413, 429, 500, 503);
+        final String body = randomAlphaOfLength(100);
+        final boolean hasBody = usually();
         MockResponse mockResponse = new MockResponse().setResponseCode(statusCode);
         if (hasBody) {
             mockResponse.setBody(body);
@@ -300,7 +305,7 @@ public void testHttpResponseWithAnyStatusCodeCanReturnBody() throws Exception {
 
     @Network
     public void testHttpsWithoutTruststore() throws Exception {
-        try (HttpClient client = new HttpClient(Settings.EMPTY, new SSLService(Settings.EMPTY, environment), null, mockClusterService())) {
+        try (HttpClient client = new HttpClient(Settings.EMPTY, new SSLService(environment), null, mockClusterService())) {
             // Known server with a valid cert from a commercial CA
             HttpRequest.Builder request = HttpRequest.builder("www.elastic.co", 443).scheme(Scheme.HTTPS);
             HttpResponse response = client.execute(request.build());
@@ -316,6 +321,7 @@ public void testThatProxyCanBeConfigured() throws Exception {
             proxyServer.enqueue(new MockResponse().setResponseCode(200).setBody("fullProxiedContent"));
             proxyServer.start();
             Settings settings = Settings.builder()
+                    .put(environment.settings())
                     .put(HttpSettings.PROXY_HOST.getKey(), "localhost")
                     .put(HttpSettings.PROXY_PORT.getKey(), proxyServer.getPort())
                     .build();
@@ -324,7 +330,8 @@ public void testThatProxyCanBeConfigured() throws Exception {
                     .method(HttpMethod.GET)
                     .path("/");
 
-            try (HttpClient client = new HttpClient(settings, new SSLService(settings, environment), null, mockClusterService())) {
+            final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(settings));
+            try (HttpClient client = new HttpClient(settings, sslService, null, mockClusterService())) {
                 HttpResponse response = client.execute(requestBuilder.build());
                 assertThat(response.status(), equalTo(200));
                 assertThat(response.body().utf8ToString(), equalTo("fullProxiedContent"));
@@ -382,19 +389,21 @@ public void testProxyCanHaveDifferentSchemeThanRequest() throws Exception {
         // We can't use the client created above for the server since it is only a truststore
         serverSecureSettings.setString("xpack.http.ssl.secure_key_passphrase", "testnode");
         Settings serverSettings = Settings.builder()
+            .put(environment.settings())
             .put("xpack.http.ssl.key", keyPath)
             .put("xpack.http.ssl.certificate", certPath)
             .put("xpack.security.http.ssl.enabled", false)
             .putList("xpack.security.http.ssl.supported_protocols", getProtocols())
             .setSecureSettings(serverSecureSettings)
             .build();
-        TestsSSLService sslService = new TestsSSLService(serverSettings, environment);
+        TestsSSLService sslService = new TestsSSLService(TestEnvironment.newEnvironment(serverSettings));
 
         try (MockWebServer proxyServer = new MockWebServer(sslService.sslContext(serverSettings.getByPrefix("xpack.http.ssl.")), false)) {
             proxyServer.enqueue(new MockResponse().setResponseCode(200).setBody("fullProxiedContent"));
             proxyServer.start();
 
             Settings settings = Settings.builder()
+                .put(environment.settings())
                 .put(HttpSettings.PROXY_HOST.getKey(), "localhost")
                 .put(HttpSettings.PROXY_PORT.getKey(), proxyServer.getPort())
                 .put(HttpSettings.PROXY_SCHEME.getKey(), "https")
@@ -408,7 +417,8 @@ public void testProxyCanHaveDifferentSchemeThanRequest() throws Exception {
                     .scheme(Scheme.HTTP)
                     .path("/");
 
-            try (HttpClient client = new HttpClient(settings, new SSLService(settings, environment), null, mockClusterService())) {
+            final SSLService ssl = new SSLService(TestEnvironment.newEnvironment(settings));
+            try (HttpClient client = new HttpClient(settings, ssl, null, mockClusterService())) {
                 HttpResponse response = client.execute(requestBuilder.build());
                 assertThat(response.status(), equalTo(200));
                 assertThat(response.body().utf8ToString(), equalTo("fullProxiedContent"));
@@ -426,6 +436,7 @@ public void testThatProxyCanBeOverriddenByRequest() throws Exception {
             proxyServer.enqueue(new MockResponse().setResponseCode(200).setBody("fullProxiedContent"));
             proxyServer.start();
             Settings settings = Settings.builder()
+                    .put(environment.settings())
                     .put(HttpSettings.PROXY_HOST.getKey(), "localhost")
                     .put(HttpSettings.PROXY_PORT.getKey(), proxyServer.getPort() + 1)
                     .put(HttpSettings.PROXY_HOST.getKey(), "https")
@@ -436,7 +447,8 @@ public void testThatProxyCanBeOverriddenByRequest() throws Exception {
                     .proxy(new HttpProxy("localhost", proxyServer.getPort(), Scheme.HTTP))
                     .path("/");
 
-            try (HttpClient client = new HttpClient(settings, new SSLService(settings, environment), null, mockClusterService())) {
+            final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(settings));
+            try (HttpClient client = new HttpClient(settings, sslService, null, mockClusterService())) {
                 HttpResponse response = client.execute(requestBuilder.build());
                 assertThat(response.status(), equalTo(200));
                 assertThat(response.body().utf8ToString(), equalTo("fullProxiedContent"));
@@ -449,15 +461,17 @@ public void testThatProxyCanBeOverriddenByRequest() throws Exception {
     }
 
     public void testThatProxyConfigurationRequiresHostAndPort() {
-        Settings.Builder settings = Settings.builder();
+        Settings.Builder settings = Settings.builder().put(environment.settings());
         if (randomBoolean()) {
             settings.put(HttpSettings.PROXY_HOST.getKey(), "localhost");
         } else {
             settings.put(HttpSettings.PROXY_PORT.getKey(), 8080);
         }
 
+        final SSLService sslService = new SSLService(TestEnvironment.newEnvironment(settings.build()));
         IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                () -> new HttpClient(settings.build(), new SSLService(settings.build(), environment), null, mockClusterService()));
+                () -> new HttpClient(settings.build(), sslService, null,
+                    mockClusterService()));
         assertThat(e.getMessage(),
                 containsString("HTTP proxy requires both settings: [xpack.http.proxy.host] and [xpack.http.proxy.port]"));
     }
@@ -515,7 +529,7 @@ public void testThatClientTakesTimeoutsIntoAccountAfterHeadersAreSent() throws E
 
     public void testThatHttpClientFailsOnNonHttpResponse() throws Exception {
         ExecutorService executor = Executors.newSingleThreadExecutor();
-        AtomicReference<Exception> hasExceptionHappened = new AtomicReference();
+        AtomicReference<Exception> hasExceptionHappened = new AtomicReference<>();
         try (ServerSocket serverSocket = new MockServerSocket(0, 50, InetAddress.getByName("localhost"))) {
             executor.execute(() -> {
                 try (Socket socket = serverSocket.accept()) {
@@ -556,7 +570,7 @@ public void testMaxHttpResponseSize() throws Exception {
 
         HttpRequest.Builder requestBuilder = HttpRequest.builder("localhost", webServer.getPort()).method(HttpMethod.GET).path("/");
 
-        try (HttpClient client = new HttpClient(settings, new SSLService(environment.settings(), environment), null,
+        try (HttpClient client = new HttpClient(settings, new SSLService(environment), null,
             mockClusterService())) {
             IOException e = expectThrows(IOException.class, () -> client.execute(requestBuilder.build()));
             assertThat(e.getMessage(), startsWith("Maximum limit of"));
@@ -631,7 +645,7 @@ public void testThatWhiteListingWorks() throws Exception {
         webServer.enqueue(new MockResponse().setResponseCode(200).setBody("whatever"));
         Settings settings = Settings.builder().put(HttpSettings.HOSTS_WHITELIST.getKey(), getWebserverUri()).build();
 
-        try (HttpClient client = new HttpClient(settings, new SSLService(environment.settings(), environment), null,
+        try (HttpClient client = new HttpClient(settings, new SSLService(environment), null,
             mockClusterService())) {
             HttpRequest request = HttpRequest.builder(webServer.getHostName(), webServer.getPort()).path("foo").build();
             client.execute(request);
@@ -643,7 +657,7 @@ public void testThatWhiteListBlocksRequests() throws Exception {
             .put(HttpSettings.HOSTS_WHITELIST.getKey(), getWebserverUri())
             .build();
 
-        try (HttpClient client = new HttpClient(settings, new SSLService(environment.settings(), environment), null,
+        try (HttpClient client = new HttpClient(settings, new SSLService(environment), null,
             mockClusterService())) {
             HttpRequest request = HttpRequest.builder("blocked.domain.org", webServer.getPort())
                 .path("foo")
@@ -667,7 +681,7 @@ public void testThatWhiteListBlocksRedirects() throws Exception {
 
         Settings settings = Settings.builder().put(HttpSettings.HOSTS_WHITELIST.getKey(), getWebserverUri()).build();
 
-        try (HttpClient client = new HttpClient(settings, new SSLService(environment.settings(), environment), null,
+        try (HttpClient client = new HttpClient(settings, new SSLService(environment), null,
             mockClusterService())) {
             HttpRequest request = HttpRequest.builder(webServer.getHostName(), webServer.getPort()).path("/")
                 .method(method)
@@ -688,7 +702,7 @@ public void testThatWhiteListingWorksForRedirects() throws Exception {
 
         Settings settings = Settings.builder().put(HttpSettings.HOSTS_WHITELIST.getKey(), getWebserverUri() + "*").build();
 
-        try (HttpClient client = new HttpClient(settings, new SSLService(environment.settings(), environment), null,
+        try (HttpClient client = new HttpClient(settings, new SSLService(environment), null,
             mockClusterService())) {
             HttpRequest request = HttpRequest.builder(webServer.getHostName(), webServer.getPort()).path("/")
                 .method(HttpMethod.GET)
@@ -708,7 +722,7 @@ public void testThatWhiteListReloadingWorks() throws Exception {
         when(clusterService.getClusterSettings()).thenReturn(clusterSettings);
 
         try (HttpClient client =
-                 new HttpClient(settings, new SSLService(environment.settings(), environment), null, clusterService)) {
+                 new HttpClient(settings, new SSLService(environment), null, clusterService)) {
 
             // blacklisted
             HttpRequest request = HttpRequest.builder(webServer.getHostName(), webServer.getPort()).path("/")
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpConnectionTimeoutTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpConnectionTimeoutTests.java
index 3451c771e3e60..94f5115d673fd 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpConnectionTimeoutTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpConnectionTimeoutTests.java
@@ -25,7 +25,7 @@ public class HttpConnectionTimeoutTests extends ESTestCase {
     @Network
     public void testDefaultTimeout() throws Exception {
         Environment environment = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
-        HttpClient httpClient = new HttpClient(Settings.EMPTY, new SSLService(environment.settings(), environment), null,
+        HttpClient httpClient = new HttpClient(Settings.EMPTY, new SSLService(environment), null,
             mockClusterService());
 
         HttpRequest request = HttpRequest.builder(UNROUTABLE_IP, 12345)
@@ -51,7 +51,7 @@ public void testDefaultTimeout() throws Exception {
     public void testDefaultTimeoutCustom() throws Exception {
         Environment environment = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
         HttpClient httpClient = new HttpClient(Settings.builder()
-                .put("xpack.http.default_connection_timeout", "5s").build(), new SSLService(environment.settings(), environment), null,
+                .put("xpack.http.default_connection_timeout", "5s").build(), new SSLService(environment), null,
             mockClusterService());
 
         HttpRequest request = HttpRequest.builder(UNROUTABLE_IP, 12345)
@@ -77,7 +77,7 @@ public void testDefaultTimeoutCustom() throws Exception {
     public void testTimeoutCustomPerRequest() throws Exception {
         Environment environment = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
         HttpClient httpClient = new HttpClient(Settings.builder()
-                .put("xpack.http.default_connection_timeout", "10s").build(), new SSLService(environment.settings(), environment), null,
+                .put("xpack.http.default_connection_timeout", "10s").build(), new SSLService(environment), null,
             mockClusterService());
 
         HttpRequest request = HttpRequest.builder(UNROUTABLE_IP, 12345)
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpReadTimeoutTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpReadTimeoutTests.java
index e534a2a90757e..918bc33d61cf4 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpReadTimeoutTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/http/HttpReadTimeoutTests.java
@@ -44,7 +44,7 @@ public void testDefaultTimeout() throws Exception {
                 .path("/")
                 .build();
 
-        try (HttpClient httpClient = new HttpClient(Settings.EMPTY, new SSLService(environment.settings(), environment),
+        try (HttpClient httpClient = new HttpClient(Settings.EMPTY, new SSLService(environment),
             null, mockClusterService())) {
             long start = System.nanoTime();
 
@@ -67,7 +67,7 @@ public void testDefaultTimeoutCustom() throws Exception {
                 .build();
 
         try (HttpClient httpClient = new HttpClient(Settings.builder()
-            .put("xpack.http.default_read_timeout", "3s").build(), new SSLService(environment.settings(), environment),
+            .put("xpack.http.default_read_timeout", "3s").build(), new SSLService(environment),
             null, mockClusterService())) {
 
             long start = System.nanoTime();
@@ -91,7 +91,7 @@ public void testTimeoutCustomPerRequest() throws Exception {
                 .build();
 
         try (HttpClient httpClient = new HttpClient(Settings.builder()
-            .put("xpack.http.default_read_timeout", "10s").build(), new SSLService(environment.settings(), environment),
+            .put("xpack.http.default_read_timeout", "10s").build(), new SSLService(environment),
             null, mockClusterService())) {
 
             long start = System.nanoTime();
diff --git a/x-pack/qa/openldap-tests/src/test/java/org/elasticsearch/test/OpenLdapTests.java b/x-pack/qa/openldap-tests/src/test/java/org/elasticsearch/test/OpenLdapTests.java
index b763e3e985fb5..2e9ecdfbc67f4 100644
--- a/x-pack/qa/openldap-tests/src/test/java/org/elasticsearch/test/OpenLdapTests.java
+++ b/x-pack/qa/openldap-tests/src/test/java/org/elasticsearch/test/OpenLdapTests.java
@@ -102,7 +102,7 @@ public void initializeSslSocketFactory() throws Exception {
         builder.put("xpack.security.authc.realms.ldap.vmode_full.ssl.verification_mode", VerificationMode.FULL);
         globalSettings = builder.setSecureSettings(mockSecureSettings).build();
         Environment environment = TestEnvironment.newEnvironment(globalSettings);
-        sslService = new SSLService(globalSettings, environment);
+        sslService = new SSLService(environment);
     }
 
     public void testConnect() throws Exception {
diff --git a/x-pack/qa/openldap-tests/src/test/java/org/elasticsearch/xpack/security/authc/ldap/OpenLdapUserSearchSessionFactoryTests.java b/x-pack/qa/openldap-tests/src/test/java/org/elasticsearch/xpack/security/authc/ldap/OpenLdapUserSearchSessionFactoryTests.java
index de1183db19391..74396e3ff9837 100644
--- a/x-pack/qa/openldap-tests/src/test/java/org/elasticsearch/xpack/security/authc/ldap/OpenLdapUserSearchSessionFactoryTests.java
+++ b/x-pack/qa/openldap-tests/src/test/java/org/elasticsearch/xpack/security/authc/ldap/OpenLdapUserSearchSessionFactoryTests.java
@@ -94,7 +94,7 @@ public void testUserSearchWithBindUserOpenLDAP() throws Exception {
         RealmConfig config = new RealmConfig(realmId, settings,
                 TestEnvironment.newEnvironment(globalSettings), new ThreadContext(globalSettings));
 
-        SSLService sslService = new SSLService(settings, TestEnvironment.newEnvironment(settings));
+        SSLService sslService = new SSLService(TestEnvironment.newEnvironment(settings));
 
         String[] users = new String[]{"cap", "hawkeye", "hulk", "ironman", "thor"};
         try (LdapUserSearchSessionFactory sessionFactory = new LdapUserSearchSessionFactory(config, sslService, threadPool)) {
diff --git a/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ADLdapUserSearchSessionFactoryTests.java b/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ADLdapUserSearchSessionFactoryTests.java
index d2c79d8882f46..54e6cd1e0ed0b 100644
--- a/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ADLdapUserSearchSessionFactoryTests.java
+++ b/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ADLdapUserSearchSessionFactoryTests.java
@@ -37,7 +37,6 @@ public class ADLdapUserSearchSessionFactoryTests extends AbstractActiveDirectory
     @Before
     public void init() throws Exception {
         Path certPath = getDataPath("support/smb_ca.crt");
-        Environment env = TestEnvironment.newEnvironment(Settings.builder().put("path.home", createTempDir()).build());
         /*
          * Prior to each test we reinitialize the socket factory with a new SSLService so that we get a new SSLContext.
          * If we re-use an SSLContext, previously connected sessions can get re-established which breaks hostname
@@ -48,7 +47,8 @@ public void init() throws Exception {
             .put("path.home", createTempDir())
             .put("xpack.security.authc.realms.ldap.ad-as-ldap-test.ssl.certificate_authorities", certPath)
             .build();
-        sslService = new SSLService(globalSettings, env);
+        Environment env = TestEnvironment.newEnvironment(globalSettings);
+        sslService = new SSLService(env);
         threadPool = new TestThreadPool("ADLdapUserSearchSessionFactoryTests");
     }
 
@@ -77,7 +77,7 @@ public void testUserSearchWithActiveDirectory() throws Exception {
 
         });
         Settings fullSettings = builder.build();
-        sslService = new SSLService(fullSettings, TestEnvironment.newEnvironment(fullSettings));
+        sslService = new SSLService(TestEnvironment.newEnvironment(fullSettings));
         RealmConfig config = new RealmConfig(new RealmConfig.RealmIdentifier("ldap", "ad-as-ldap-test"), fullSettings,
                 TestEnvironment.newEnvironment(fullSettings), new ThreadContext(fullSettings));
         LdapUserSearchSessionFactory sessionFactory = getLdapUserSearchSessionFactory(config, sslService, threadPool);
diff --git a/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/AbstractActiveDirectoryTestCase.java b/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/AbstractActiveDirectoryTestCase.java
index df8b23d9381a1..e77c00b534b88 100644
--- a/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/AbstractActiveDirectoryTestCase.java
+++ b/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/AbstractActiveDirectoryTestCase.java
@@ -90,7 +90,7 @@ public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IO
         builder.put("xpack.security.authc.realms.active_directory.bar.ssl.verification_mode", VerificationMode.CERTIFICATE);
         globalSettings = builder.build();
         Environment environment = TestEnvironment.newEnvironment(globalSettings);
-        sslService = new SSLService(globalSettings, environment);
+        sslService = new SSLService(environment);
     }
 
     Settings buildAdSettings(RealmConfig.RealmIdentifier realmId, String ldapUrl, String adDomainName, String userSearchDN,
diff --git a/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ActiveDirectorySessionFactoryTests.java b/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ActiveDirectorySessionFactoryTests.java
index b122404507bc6..65936248b4db5 100644
--- a/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ActiveDirectorySessionFactoryTests.java
+++ b/x-pack/qa/third-party/active-directory/src/test/java/org/elasticsearch/xpack/security/authc/ldap/ActiveDirectorySessionFactoryTests.java
@@ -87,13 +87,13 @@ public void testAdAuth() throws Exception {
     }
 
     private RealmConfig configureRealm(String name, String type, Settings settings) {
-        final Environment env = TestEnvironment.newEnvironment(globalSettings);
         final Settings mergedSettings = Settings.builder()
             .put(settings)
             .normalizePrefix("xpack.security.authc.realms." + type + "." + name + ".")
             .put(globalSettings)
             .build();
-        this.sslService = new SSLService(mergedSettings, env);
+        final Environment env = TestEnvironment.newEnvironment(mergedSettings);
+        this.sslService = new SSLService(env);
         final RealmConfig.RealmIdentifier identifier = new RealmConfig.RealmIdentifier(type, name);
         return new RealmConfig(identifier, mergedSettings, env, new ThreadContext(globalSettings));
     }

From 1fbf799882d2bd58b6a995d29f821b6c2d206825 Mon Sep 17 00:00:00 2001
From: j-bean <anton.shuvaev91@gmail.com>
Date: Mon, 6 Jan 2020 10:23:57 +0500
Subject: [PATCH 384/686] Security should not reload files that haven't changed
 (#50207)

In security we currently monitor a set of files for changes:

- config/role_mapping.yml (or alternative configured path)
- config/roles.yml
- config/users
- config/users_roles

This commit prevents unnecessary reloading when the file change actually doesn't change the internal structure.

Closes: #50063

Co-authored-by: Anton Shuvaev <anton.shuvaev91@gmail.com>
---
 .../org/elasticsearch/common/util/Maps.java   | 19 ++++++++++
 .../elasticsearch/common/util/MapsTests.java  | 36 +++++++++++++++++++
 .../authc/file/FileUserPasswdStore.java       | 11 ++++--
 .../authc/file/FileUserRolesStore.java        | 11 ++++--
 .../security/authc/support/DnRoleMapper.java  | 10 ++++--
 .../security/authz/store/FileRolesStore.java  |  8 +++--
 .../authc/file/FileUserPasswdStoreTests.java  | 16 ++++++++-
 .../authc/file/FileUserRolesStoreTests.java   | 13 ++++++-
 .../authc/support/DnRoleMapperTests.java      | 12 +++++++
 .../authz/store/FileRolesStoreTests.java      | 15 +++++++-
 10 files changed, 136 insertions(+), 15 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/util/Maps.java b/server/src/main/java/org/elasticsearch/common/util/Maps.java
index 175a2a24db562..6c3a367b15ee8 100644
--- a/server/src/main/java/org/elasticsearch/common/util/Maps.java
+++ b/server/src/main/java/org/elasticsearch/common/util/Maps.java
@@ -99,4 +99,23 @@ public static <K, V> Map<K, V> ofEntries(final Collection<Map.Entry<K, V>> entri
         return map;
     }
 
+    /**
+     * Returns {@code true} if the two specified maps are equal to one another. Two maps are considered equal if both represent identical
+     * mappings where values are checked with Objects.deepEquals. The primary use case is to check if two maps with array values are equal.
+     *
+     * @param left  one map to be tested for equality
+     * @param right the other map to be tested for equality
+     * @return {@code true} if the two maps are equal
+     */
+    public static <K, V> boolean deepEquals(Map<K, V> left, Map<K, V> right) {
+        if (left == right) {
+            return true;
+        }
+        if (left == null || right == null || left.size() != right.size()) {
+            return false;
+        }
+        return left.entrySet().stream()
+                .allMatch(e -> right.containsKey(e.getKey()) && Objects.deepEquals(e.getValue(), right.get(e.getKey())));
+    }
+
 }
diff --git a/server/src/test/java/org/elasticsearch/common/util/MapsTests.java b/server/src/test/java/org/elasticsearch/common/util/MapsTests.java
index 6edffee268ecc..b670d6badab1c 100644
--- a/server/src/test/java/org/elasticsearch/common/util/MapsTests.java
+++ b/server/src/test/java/org/elasticsearch/common/util/MapsTests.java
@@ -22,13 +22,18 @@
 import org.elasticsearch.test.ESTestCase;
 
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collection;
+import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Map;
+import java.util.function.Supplier;
 import java.util.stream.Collectors;
+import java.util.stream.IntStream;
 import java.util.stream.Stream;
 
 import static java.util.Map.entry;
+import static java.util.stream.Collectors.toMap;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasItem;
 
@@ -103,6 +108,31 @@ public void testOfEntries() {
         assertMapEntriesAndImmutability(map, entries);
     }
 
+    public void testDeepEquals() {
+        final Supplier<String> keyGenerator = () -> randomAlphaOfLengthBetween(1, 5);
+        final Supplier<int[]> arrayValueGenerator = () -> random().ints(randomInt(5)).toArray();
+        final Map<String, int[]> map = randomMap(randomInt(5), keyGenerator, arrayValueGenerator);
+        final Map<String, int[]> mapCopy = map.entrySet().stream()
+                .collect(toMap(Map.Entry::getKey, e -> Arrays.copyOf(e.getValue(), e.getValue().length)));
+
+        assertTrue(Maps.deepEquals(map, mapCopy));
+
+        final Map<String, int[]> mapModified = mapCopy;
+        if (mapModified.isEmpty()) {
+            mapModified.put(keyGenerator.get(), arrayValueGenerator.get());
+        } else {
+            if (randomBoolean()) {
+                final String randomKey = mapModified.keySet().toArray(new String[0])[randomInt(mapModified.size() - 1)];
+                final int[] value = mapModified.get(randomKey);
+                mapModified.put(randomKey, randomValueOtherThanMany((v) -> Arrays.equals(v, value), arrayValueGenerator));
+            } else {
+                mapModified.put(randomValueOtherThanMany(mapModified::containsKey, keyGenerator), arrayValueGenerator.get());
+            }
+        }
+
+        assertFalse(Maps.deepEquals(map, mapModified));
+    }
+
     private void assertMapEntries(final Map<String, String> map, final Collection<Map.Entry<String, String>> entries) {
         for (var entry : entries) {
             assertThat("map [" + map + "] does not contain key [" + entry.getKey() + "]", map.keySet(), hasItem(entry.getKey()));
@@ -160,4 +190,10 @@ private void assertMapEntriesAndImmutability(
         assertMapImmutability(map);
     }
 
+    private static <K, V> Map<K, V> randomMap(int size, Supplier<K> keyGenerator, Supplier<V> valueGenerator) {
+        final Map<K, V> map = new HashMap<>();
+        IntStream.range(0, size).forEach(i -> map.put(keyGenerator.get(), valueGenerator.get()));
+        return map;
+    }
+
 }
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/file/FileUserPasswdStore.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/file/FileUserPasswdStore.java
index bbb5d77b90f4a..dab7152c538df 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/file/FileUserPasswdStore.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/file/FileUserPasswdStore.java
@@ -5,14 +5,15 @@
  */
 package org.elasticsearch.xpack.security.authc.file;
 
-import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.apache.logging.log4j.util.Supplier;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.settings.SecureString;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.Maps;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.watcher.FileChangesListener;
 import org.elasticsearch.watcher.FileWatcher;
@@ -191,9 +192,13 @@ public void onFileDeleted(Path file) {
         @Override
         public void onFileChanged(Path file) {
             if (file.equals(FileUserPasswdStore.this.file)) {
-                logger.info("users file [{}] changed. updating users... )", file.toAbsolutePath());
+                final Map<String, char[]> previousUsers = users;
                 users = parseFileLenient(file, logger, settings);
-                notifyRefresh();
+
+                if (Maps.deepEquals(previousUsers, users) == false) {
+                    logger.info("users file [{}] changed. updating users... )", file.toAbsolutePath());
+                    notifyRefresh();
+                }
             }
         }
     }
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/file/FileUserRolesStore.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/file/FileUserRolesStore.java
index e79621964e70e..1eb2e468c8ef2 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/file/FileUserRolesStore.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/file/FileUserRolesStore.java
@@ -5,13 +5,14 @@
  */
 package org.elasticsearch.xpack.security.authc.file;
 
-import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.apache.logging.log4j.util.Supplier;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.util.Maps;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.watcher.FileChangesListener;
 import org.elasticsearch.watcher.FileWatcher;
@@ -206,9 +207,13 @@ public void onFileDeleted(Path file) {
         @Override
         public void onFileChanged(Path file) {
             if (file.equals(FileUserRolesStore.this.file)) {
-                logger.info("users roles file [{}] changed. updating users roles...", file.toAbsolutePath());
+                final Map<String, String[]> previousUserRoles = userRoles;
                 userRoles = parseFileLenient(file, logger);
-                notifyRefresh();
+
+                if (Maps.deepEquals(previousUserRoles, userRoles) == false) {
+                    logger.info("users roles file [{}] changed. updating users roles...", file.toAbsolutePath());
+                    notifyRefresh();
+                }
             }
         }
     }
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapper.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapper.java
index 1018c591617a9..f62c8521a69ff 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapper.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapper.java
@@ -223,10 +223,14 @@ public void onFileDeleted(Path file) {
         @Override
         public void onFileChanged(Path file) {
             if (file.equals(DnRoleMapper.this.file)) {
-                logger.info("role mappings file [{}] changed for realm [{}/{}]. updating mappings...", file.toAbsolutePath(),
-                        config.type(), config.name());
+                final Map<String, List<String>> previousDnRoles = dnRoles;
                 dnRoles = parseFileLenient(file, logger, config.type(), config.name());
-                notifyRefresh();
+
+                if (previousDnRoles.equals(dnRoles) == false) {
+                    logger.info("role mappings file [{}] changed for realm [{}/{}]. updating mappings...", file.toAbsolutePath(),
+                            config.type(), config.name());
+                    notifyRefresh();
+                }
             }
         }
     }
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/FileRolesStore.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/FileRolesStore.java
index b1059c46cc668..90b94d1275989 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/FileRolesStore.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/FileRolesStore.java
@@ -368,8 +368,6 @@ public synchronized void onFileChanged(Path file) {
                 final Map<String, RoleDescriptor> previousPermissions = permissions;
                 try {
                     permissions = parseFile(file, logger, settings, licenseState, xContentRegistry);
-                    logger.info("updated roles (roles file [{}] {})", file.toAbsolutePath(),
-                        Files.exists(file) ? "changed" : "removed");
                 } catch (Exception e) {
                     logger.error(
                             (Supplier<?>) () -> new ParameterizedMessage(
@@ -383,7 +381,11 @@ public synchronized void onFileChanged(Path file) {
                         .collect(Collectors.toSet());
                 final Set<String> addedRoles = Sets.difference(permissions.keySet(), previousPermissions.keySet());
                 final Set<String> changedRoles = Collections.unmodifiableSet(Sets.union(changedOrMissingRoles, addedRoles));
-                listeners.forEach(c -> c.accept(changedRoles));
+                if (changedRoles.isEmpty() == false) {
+                    logger.info("updated roles (roles file [{}] {})", file.toAbsolutePath(),
+                            Files.exists(file) ? "changed" : "removed");
+                    listeners.forEach(c -> c.accept(changedRoles));
+                }
             }
         }
     }
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/file/FileUserPasswdStoreTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/file/FileUserPasswdStoreTests.java
index e6f099e389741..42cd5530f306d 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/file/FileUserPasswdStoreTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/file/FileUserPasswdStoreTests.java
@@ -53,7 +53,7 @@ public class FileUserPasswdStoreTests extends ESTestCase {
     @Before
     public void init() {
         settings = Settings.builder()
-            .put("resource.reload.interval.high", "2s")
+            .put("resource.reload.interval.high", "100ms")
             .put("path.home", createTempDir())
             .put("xpack.security.authc.password_hashing.algorithm", randomFrom("bcrypt", "bcrypt11", "pbkdf2", "pbkdf2_1000",
                 "pbkdf2_50000"))
@@ -103,6 +103,20 @@ public void testStore_AutoReload() throws Exception {
 
         watcherService.start();
 
+        try (BufferedWriter writer = Files.newBufferedWriter(file, StandardCharsets.UTF_8, StandardOpenOption.APPEND)) {
+            writer.append("\n");
+        }
+
+        watcherService.notifyNow(ResourceWatcherService.Frequency.HIGH);
+        if (latch.getCount() != 1) {
+            fail("Listener should not be called as users passwords are not changed.");
+        }
+
+        assertThat(store.userExists(username), is(true));
+        result = store.verifyPassword(username, new SecureString("test123"), () -> user);
+        assertThat(result.getStatus(), is(AuthenticationResult.Status.SUCCESS));
+        assertThat(result.getUser(), is(user));
+
         try (BufferedWriter writer = Files.newBufferedWriter(file, StandardCharsets.UTF_8, StandardOpenOption.APPEND)) {
             writer.newLine();
             writer.append("foobar:").append(new String(hasher.hash(new SecureString("barfoo"))));
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/file/FileUserRolesStoreTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/file/FileUserRolesStoreTests.java
index 0fef08acefbd4..4e1dd0644911c 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/file/FileUserRolesStoreTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/file/FileUserRolesStoreTests.java
@@ -54,7 +54,7 @@ public class FileUserRolesStoreTests extends ESTestCase {
     @Before
     public void init() {
         settings = Settings.builder()
-                .put("resource.reload.interval.high", "2s")
+                .put("resource.reload.interval.high", "100ms")
                 .put("path.home", createTempDir())
                 .build();
         env = TestEnvironment.newEnvironment(settings);
@@ -102,6 +102,17 @@ public void testStoreAutoReload() throws Exception {
 
         watcherService.start();
 
+        try (BufferedWriter writer = Files.newBufferedWriter(tmp, StandardCharsets.UTF_8, StandardOpenOption.APPEND)) {
+            writer.append("\n");
+        }
+
+        watcherService.notifyNow(ResourceWatcherService.Frequency.HIGH);
+        if (latch.getCount() != 1) {
+            fail("Listener should not be called as users roles are not changed.");
+        }
+
+        assertThat(store.roles("user1"), arrayContaining("role1", "role2", "role3"));
+
         try (BufferedWriter writer = Files.newBufferedWriter(tmp, StandardCharsets.UTF_8, StandardOpenOption.APPEND)) {
             writer.newLine();
             writer.append("role4:user4\nrole5:user4\n");
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapperTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapperTests.java
index 7f7899e65943c..2f62c35ba1130 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapperTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapperTests.java
@@ -112,6 +112,18 @@ public void testMapper_AutoReload() throws Exception {
 
         watcherService.start();
 
+        try (BufferedWriter writer = Files.newBufferedWriter(file, StandardCharsets.UTF_8, StandardOpenOption.APPEND)) {
+            writer.append("\n");
+        }
+
+        watcherService.notifyNow(ResourceWatcherService.Frequency.HIGH);
+        if (latch.getCount() != 1) {
+            fail("Listener should not be called as roles mapping is not changed.");
+        }
+
+        roles = mapper.resolveRoles("", Collections.singletonList("cn=shield,ou=marvel,o=superheros"));
+        assertThat(roles, contains("security"));
+
         try (BufferedWriter writer = Files.newBufferedWriter(file, StandardCharsets.UTF_8, StandardOpenOption.APPEND)) {
             writer.newLine();
             writer.append("fantastic_four:\n")
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/FileRolesStoreTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/FileRolesStoreTests.java
index 99ae113e15fe9..f0cc9840e5e13 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/FileRolesStoreTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/FileRolesStoreTests.java
@@ -332,7 +332,7 @@ public void testAutoReload() throws Exception {
             }
 
             Settings.Builder builder = Settings.builder()
-                    .put("resource.reload.interval.high", "500ms")
+                    .put("resource.reload.interval.high", "100ms")
                     .put("path.home", home);
             Settings settings = builder.build();
             Environment env = TestEnvironment.newEnvironment(settings);
@@ -354,6 +354,19 @@ public void testAutoReload() throws Exception {
 
             watcherService.start();
 
+            try (BufferedWriter writer = Files.newBufferedWriter(tmp, StandardCharsets.UTF_8, StandardOpenOption.APPEND)) {
+                writer.append("\n");
+            }
+
+            watcherService.notifyNow(ResourceWatcherService.Frequency.HIGH);
+            if (latch.getCount() != 1) {
+                fail("Listener should not be called as roles are not changed.");
+            }
+
+            descriptors = store.roleDescriptors(Collections.singleton("role1"));
+            assertThat(descriptors, notNullValue());
+            assertEquals(1, descriptors.size());
+
             try (BufferedWriter writer = Files.newBufferedWriter(tmp, StandardCharsets.UTF_8, StandardOpenOption.APPEND)) {
                 writer.newLine();
                 writer.newLine();

From cf1d80b55678be7cc67cb00be8eb7cd5bd042e54 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Mon, 6 Jan 2020 10:47:52 +0100
Subject: [PATCH 385/686] Re-enable FullClusterRestartIT#testWatcher test
 (#50463)

Previously this test failed waiting for yellow:
https://gradle-enterprise.elastic.co/s/fv55holsa36tg/console-log#L2676

Oddly cluster health returned red status, but there were no unassigned, relocating or initializing shards.
Placed the waiting for green in a try-catch block, so that when this fails again then cluster state gets printed.

Relates to #48381
---
 .../xpack/restart/FullClusterRestartIT.java     | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/x-pack/qa/full-cluster-restart/src/test/java/org/elasticsearch/xpack/restart/FullClusterRestartIT.java b/x-pack/qa/full-cluster-restart/src/test/java/org/elasticsearch/xpack/restart/FullClusterRestartIT.java
index b14e3bb86ce14..e8c1b6e94ccf6 100644
--- a/x-pack/qa/full-cluster-restart/src/test/java/org/elasticsearch/xpack/restart/FullClusterRestartIT.java
+++ b/x-pack/qa/full-cluster-restart/src/test/java/org/elasticsearch/xpack/restart/FullClusterRestartIT.java
@@ -123,7 +123,6 @@ public void testSecurityNativeRealm() throws Exception {
     }
 
     @SuppressWarnings("unchecked")
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/48381")
     public void testWatcher() throws Exception {
         if (isRunningAgainstOldCluster()) {
             logger.info("Adding a watch on old cluster {}", getOldClusterVersion());
@@ -143,13 +142,25 @@ public void testWatcher() throws Exception {
             client().performRequest(createFunnyTimeout);
 
             logger.info("Waiting for watch results index to fill up...");
-            waitForYellow(".watches,bwc_watch_index,.watcher-history*");
+            try {
+                waitForYellow(".watches,bwc_watch_index,.watcher-history*");
+            } catch (ResponseException e) {
+                String rsp = toStr(client().performRequest(new Request("GET", "/_cluster/state")));
+                logger.info("cluster_state_response=\n{}", rsp);
+                throw e;
+            }
             waitForHits("bwc_watch_index", 2);
             waitForHits(".watcher-history*", 2);
             logger.info("Done creating watcher-related indices");
         } else {
             logger.info("testing against {}", getOldClusterVersion());
-            waitForYellow(".watches,bwc_watch_index,.watcher-history*");
+            try {
+                waitForYellow(".watches,bwc_watch_index,.watcher-history*");
+            } catch (ResponseException e) {
+                String rsp = toStr(client().performRequest(new Request("GET", "/_cluster/state")));
+                logger.info("cluster_state_response=\n{}", rsp);
+                throw e;
+            }
 
             logger.info("checking that the Watches index is the correct version");
 

From 52cc1384fc6a21e6390d545f8a4c49740e2f9e17 Mon Sep 17 00:00:00 2001
From: j-bean <anton.shuvaev91@gmail.com>
Date: Mon, 6 Jan 2020 15:03:15 +0500
Subject: [PATCH 386/686] Add 'monitor_snapshot' cluster privilege (#50489)

This adds a new cluster privilege `monitor_snapshot` which is a restricted
version of `create_snapshot`, granting the same privileges to view
snapshot and repository info and status but not granting the actual
privilege to create a snapshot.

Co-authored-by: Anton Shuvaev <anton.shuvaev91@gmail.com>
---
 .../security/get-builtin-privileges.asciidoc  |  1 +
 .../authorization/privileges.asciidoc         |  3 ++
 .../privilege/ClusterPrivilegeResolver.java   |  4 +++
 .../integration/ClusterPrivilegeTests.java    | 33 +++++++++++++++++--
 .../test/privileges/11_builtin.yml            |  2 +-
 5 files changed, 39 insertions(+), 4 deletions(-)

diff --git a/x-pack/docs/en/rest-api/security/get-builtin-privileges.asciidoc b/x-pack/docs/en/rest-api/security/get-builtin-privileges.asciidoc
index cedffe7a6f9d4..e5af329b63843 100644
--- a/x-pack/docs/en/rest-api/security/get-builtin-privileges.asciidoc
+++ b/x-pack/docs/en/rest-api/security/get-builtin-privileges.asciidoc
@@ -87,6 +87,7 @@ A successful call returns an object with "cluster" and "index" fields.
     "monitor_data_frame_transforms",
     "monitor_ml",
     "monitor_rollup",
+    "monitor_snapshot",
     "monitor_transform",
     "monitor_watcher",
     "none",
diff --git a/x-pack/docs/en/security/authorization/privileges.asciidoc b/x-pack/docs/en/security/authorization/privileges.asciidoc
index aed7b236e172d..1d53c7b20aa6a 100644
--- a/x-pack/docs/en/security/authorization/privileges.asciidoc
+++ b/x-pack/docs/en/security/authorization/privileges.asciidoc
@@ -16,6 +16,9 @@ settings update, rerouting, or managing users and roles.
 Privileges to create snapshots for existing repositories. Can also list and view
 details on existing repositories and snapshots.
 
+`monitor_snapshot`::
+Privileges to list and view details on existing repositories and snapshots.
+
 `manage`::
 Builds on `monitor` and adds cluster operations that change values in the cluster.
 This includes snapshotting, updating settings, and rerouting. It also includes 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ClusterPrivilegeResolver.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ClusterPrivilegeResolver.java
index 65469f77a116c..c9754e586c0a6 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ClusterPrivilegeResolver.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ClusterPrivilegeResolver.java
@@ -66,6 +66,8 @@ public class ClusterPrivilegeResolver {
         Set.of("cluster:admin/xpack/ccr/*", ClusterStateAction.NAME, HasPrivilegesAction.NAME);
     private static final Set<String> CREATE_SNAPSHOT_PATTERN = Set.of(CreateSnapshotAction.NAME, SnapshotsStatusAction.NAME + "*",
         GetSnapshotsAction.NAME, SnapshotsStatusAction.NAME, GetRepositoriesAction.NAME);
+    private static final Set<String> MONITOR_SNAPSHOT_PATTERN = Set.of(SnapshotsStatusAction.NAME + "*", GetSnapshotsAction.NAME,
+            SnapshotsStatusAction.NAME, GetRepositoriesAction.NAME);
     private static final Set<String> READ_CCR_PATTERN = Set.of(ClusterStateAction.NAME, HasPrivilegesAction.NAME);
     private static final Set<String> MANAGE_ILM_PATTERN = Set.of("cluster:admin/ilm/*");
     private static final Set<String> READ_ILM_PATTERN = Set.of(GetLifecycleAction.NAME, GetStatusAction.NAME);
@@ -109,6 +111,7 @@ public class ClusterPrivilegeResolver {
     public static final NamedClusterPrivilege MANAGE_CCR =            new ActionClusterPrivilege("manage_ccr", MANAGE_CCR_PATTERN);
     public static final NamedClusterPrivilege READ_CCR = new ActionClusterPrivilege("read_ccr", READ_CCR_PATTERN);
     public static final NamedClusterPrivilege CREATE_SNAPSHOT = new ActionClusterPrivilege("create_snapshot", CREATE_SNAPSHOT_PATTERN);
+    public static final NamedClusterPrivilege MONITOR_SNAPSHOT = new ActionClusterPrivilege("monitor_snapshot", MONITOR_SNAPSHOT_PATTERN);
     public static final NamedClusterPrivilege MANAGE_ILM = new ActionClusterPrivilege("manage_ilm", MANAGE_ILM_PATTERN);
     public static final NamedClusterPrivilege READ_ILM = new ActionClusterPrivilege("read_ilm", READ_ILM_PATTERN);
     public static final NamedClusterPrivilege MANAGE_SLM = new ActionClusterPrivilege("manage_slm", MANAGE_SLM_PATTERN);
@@ -146,6 +149,7 @@ public class ClusterPrivilegeResolver {
         MANAGE_CCR,
         READ_CCR,
         CREATE_SNAPSHOT,
+        MONITOR_SNAPSHOT,
         MANAGE_ILM,
         READ_ILM,
         MANAGE_SLM,
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/ClusterPrivilegeTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/ClusterPrivilegeTests.java
index c434d3b182888..c699e21aed72b 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/ClusterPrivilegeTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/ClusterPrivilegeTests.java
@@ -36,13 +36,17 @@ public class ClusterPrivilegeTests extends AbstractPrivilegeTestCase {
                     "    - names: 'someindex'\n" +
                     "      privileges: [ all ]\n" +
                     "role_d:\n" +
-                    "  cluster: [ create_snapshot ]\n";
+                    "  cluster: [ create_snapshot ]\n" +
+                    "\n" +
+                    "role_e:\n" +
+                    "  cluster: [ monitor_snapshot]\n";
 
     private static final String USERS_ROLES =
                     "role_a:user_a\n" +
                     "role_b:user_b\n" +
                     "role_c:user_c\n" +
-                    "role_d:user_d\n";
+                    "role_d:user_d\n" +
+                    "role_e:user_e\n";
 
     private static Path repositoryLocation;
 
@@ -81,7 +85,8 @@ protected String configUsers() {
             "user_a:" + usersPasswdHashed + "\n" +
             "user_b:" + usersPasswdHashed + "\n" +
             "user_c:" + usersPasswdHashed + "\n" +
-            "user_d:" + usersPasswdHashed + "\n";
+            "user_d:" + usersPasswdHashed + "\n" +
+            "user_e:" + usersPasswdHashed + "\n";
     }
 
     @Override
@@ -139,6 +144,19 @@ public void testThatClusterPrivilegesWorkAsExpectedViaHttp() throws Exception {
         assertAccessIsDenied("user_d", "GET", "/_nodes/infos");
         assertAccessIsDenied("user_d", "POST", "/_cluster/reroute");
         assertAccessIsDenied("user_d", "PUT", "/_cluster/settings", "{ \"transient\" : { \"search.default_search_timeout\": \"1m\" } }");
+
+        // user_e can view repos and snapshots on existing repos, everything else is DENIED
+        assertAccessIsDenied("user_e", "GET", "/_cluster/state");
+        assertAccessIsDenied("user_e", "GET", "/_cluster/health");
+        assertAccessIsDenied("user_e", "GET", "/_cluster/settings");
+        assertAccessIsDenied("user_e", "GET", "/_cluster/stats");
+        assertAccessIsDenied("user_e", "GET", "/_cluster/pending_tasks");
+        assertAccessIsDenied("user_e", "GET", "/_nodes/stats");
+        assertAccessIsDenied("user_e", "GET", "/_nodes/hot_threads");
+        assertAccessIsDenied("user_e", "GET", "/_nodes/infos");
+        assertAccessIsDenied("user_e", "POST", "/_cluster/reroute");
+        assertAccessIsDenied("user_e", "PUT", "/_cluster/settings", "{ \"transient\" : { \"search.default_search_timeout\": \"1m\" } }");
+
     }
 
     public void testThatSnapshotAndRestore() throws Exception {
@@ -147,6 +165,7 @@ public void testThatSnapshotAndRestore() throws Exception {
         assertAccessIsDenied("user_b", "PUT", "/_snapshot/my-repo", repoJson);
         assertAccessIsDenied("user_c", "PUT", "/_snapshot/my-repo", repoJson);
         assertAccessIsDenied("user_d", "PUT", "/_snapshot/my-repo", repoJson);
+        assertAccessIsDenied("user_e", "PUT", "/_snapshot/my-repo", repoJson);
         assertAccessIsAllowed("user_a", "PUT", "/_snapshot/my-repo", repoJson);
 
         Request createBar = new Request("PUT", "/someindex/_doc/1");
@@ -155,16 +174,19 @@ public void testThatSnapshotAndRestore() throws Exception {
         assertAccessIsDenied("user_a", createBar);
         assertAccessIsDenied("user_b", createBar);
         assertAccessIsDenied("user_d", createBar);
+        assertAccessIsDenied("user_e", createBar);
         assertAccessIsAllowed("user_c", createBar);
 
         assertAccessIsDenied("user_b", "PUT", "/_snapshot/my-repo/my-snapshot", "{ \"indices\": \"someindex\" }");
         assertAccessIsDenied("user_c", "PUT", "/_snapshot/my-repo/my-snapshot", "{ \"indices\": \"someindex\" }");
+        assertAccessIsDenied("user_e", "PUT", "/_snapshot/my-repo/my-snapshot", "{ \"indices\": \"someindex\" }");
         assertAccessIsAllowed("user_a", "PUT", "/_snapshot/my-repo/my-snapshot", "{ \"indices\": \"someindex\" }");
 
         assertAccessIsDenied("user_b", "GET", "/_snapshot/my-repo/my-snapshot/_status");
         assertAccessIsDenied("user_c", "GET", "/_snapshot/my-repo/my-snapshot/_status");
         assertAccessIsAllowed("user_a", "GET", "/_snapshot/my-repo/my-snapshot/_status");
         assertAccessIsAllowed("user_d", "GET", "/_snapshot/my-repo/my-snapshot/_status");
+        assertAccessIsAllowed("user_e", "GET", "/_snapshot/my-repo/my-snapshot/_status");
 
         // This snapshot needs to be finished in order to be restored
         waitForSnapshotToFinish("my-repo", "my-snapshot");
@@ -175,6 +197,7 @@ public void testThatSnapshotAndRestore() throws Exception {
         assertAccessIsDenied("user_a", "DELETE", "/someindex");
         assertAccessIsDenied("user_b", "DELETE", "/someindex");
         assertAccessIsDenied("user_d", "DELETE", "/someindex");
+        assertAccessIsDenied("user_e", "DELETE", "/someindex");
         assertAccessIsAllowed("user_c", "DELETE", "/someindex");
 
         Request restoreSnapshotRequest = new Request("POST", "/_snapshot/my-repo/my-snapshot/_restore");
@@ -182,21 +205,25 @@ public void testThatSnapshotAndRestore() throws Exception {
         assertAccessIsDenied("user_b", restoreSnapshotRequest);
         assertAccessIsDenied("user_c", restoreSnapshotRequest);
         assertAccessIsDenied("user_d", restoreSnapshotRequest);
+        assertAccessIsDenied("user_e", restoreSnapshotRequest);
         assertAccessIsAllowed("user_a", restoreSnapshotRequest);
 
         assertAccessIsDenied("user_a", "GET", "/someindex/_doc/1");
         assertAccessIsDenied("user_b", "GET", "/someindex/_doc/1");
         assertAccessIsDenied("user_d", "GET", "/someindex/_doc/1");
+        assertAccessIsDenied("user_e", "GET", "/someindex/_doc/1");
         assertAccessIsAllowed("user_c", "GET", "/someindex/_doc/1");
 
         assertAccessIsDenied("user_b", "DELETE", "/_snapshot/my-repo/my-snapshot");
         assertAccessIsDenied("user_c", "DELETE", "/_snapshot/my-repo/my-snapshot");
         assertAccessIsDenied("user_d", "DELETE", "/_snapshot/my-repo/my-snapshot");
+        assertAccessIsDenied("user_e", "DELETE", "/_snapshot/my-repo/my-snapshot");
         assertAccessIsAllowed("user_a", "DELETE", "/_snapshot/my-repo/my-snapshot");
 
         assertAccessIsDenied("user_b", "DELETE", "/_snapshot/my-repo");
         assertAccessIsDenied("user_c", "DELETE", "/_snapshot/my-repo");
         assertAccessIsDenied("user_d", "DELETE", "/_snapshot/my-repo");
+        assertAccessIsDenied("user_e", "DELETE", "/_snapshot/my-repo");
         assertAccessIsAllowed("user_a", "DELETE", "/_snapshot/my-repo");
     }
 
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/privileges/11_builtin.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/privileges/11_builtin.yml
index c7130faf27749..02961a2db12f8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/privileges/11_builtin.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/privileges/11_builtin.yml
@@ -15,5 +15,5 @@ setup:
   # This is fragile - it needs to be updated every time we add a new cluster/index privilege
   # I would much prefer we could just check that specific entries are in the array, but we don't have
   # an assertion for that
-  - length: { "cluster" : 33 }
+  - length: { "cluster" : 34 }
   - length: { "index" : 17 }

From 3e449ac8e6acb201561ea85a89de55380e539421 Mon Sep 17 00:00:00 2001
From: David Turner <david.turner@elastic.co>
Date: Mon, 6 Jan 2020 11:07:35 +0000
Subject: [PATCH 387/686] Collect shard sizes for closed indices (#50645)

Today the `InternalClusterInfoService` collects information on the sizes of
shards of open indices, but does not consider closed indices. This means that
shards of closed indices are treated as having zero size when they are being
allocated. This commit fixes this, obtaining the sizes of all shards.

Relates #33888
---
 .../elasticsearch/cluster/InternalClusterInfoService.java    | 2 ++
 .../java/org/elasticsearch/cluster/ClusterInfoServiceIT.java | 5 ++++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/cluster/InternalClusterInfoService.java b/server/src/main/java/org/elasticsearch/cluster/InternalClusterInfoService.java
index d07897199ae8e..8c49c3de39690 100644
--- a/server/src/main/java/org/elasticsearch/cluster/InternalClusterInfoService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/InternalClusterInfoService.java
@@ -30,6 +30,7 @@
 import org.elasticsearch.action.admin.indices.stats.IndicesStatsRequest;
 import org.elasticsearch.action.admin.indices.stats.IndicesStatsResponse;
 import org.elasticsearch.action.admin.indices.stats.ShardStats;
+import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.cluster.block.ClusterBlockException;
 import org.elasticsearch.cluster.node.DiscoveryNode;
@@ -258,6 +259,7 @@ protected CountDownLatch updateIndicesStats(final ActionListener<IndicesStatsRes
         final IndicesStatsRequest indicesStatsRequest = new IndicesStatsRequest();
         indicesStatsRequest.clear();
         indicesStatsRequest.store(true);
+        indicesStatsRequest.indicesOptions(IndicesOptions.STRICT_EXPAND_OPEN_CLOSED);
 
         client.admin().indices().stats(indicesStatsRequest, new LatchedActionListener<>(listener, latch));
         return latch;
diff --git a/server/src/test/java/org/elasticsearch/cluster/ClusterInfoServiceIT.java b/server/src/test/java/org/elasticsearch/cluster/ClusterInfoServiceIT.java
index aa897f10bb895..6db2097f7d359 100644
--- a/server/src/test/java/org/elasticsearch/cluster/ClusterInfoServiceIT.java
+++ b/server/src/test/java/org/elasticsearch/cluster/ClusterInfoServiceIT.java
@@ -114,11 +114,14 @@ private void setClusterInfoTimeout(String timeValue) {
             .put(InternalClusterInfoService.INTERNAL_CLUSTER_INFO_TIMEOUT_SETTING.getKey(), timeValue).build()));
     }
 
-    public void testClusterInfoServiceCollectsInformation() throws Exception {
+    public void testClusterInfoServiceCollectsInformation() {
         internalCluster().startNodes(2);
         assertAcked(prepareCreate("test").setSettings(Settings.builder()
             .put(Store.INDEX_STORE_STATS_REFRESH_INTERVAL_SETTING.getKey(), 0)
             .put(EnableAllocationDecider.INDEX_ROUTING_REBALANCE_ENABLE_SETTING.getKey(), EnableAllocationDecider.Rebalance.NONE).build()));
+        if (randomBoolean()) {
+            assertAcked(client().admin().indices().prepareClose("test"));
+        }
         ensureGreen("test");
         InternalTestCluster internalTestCluster = internalCluster();
         // Get the cluster info service on the master node

From cb1edde31119a9010636bae52321080ae6820bbe Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Mon, 6 Jan 2020 12:18:12 +0100
Subject: [PATCH 388/686] Workaround for JDK 14 EA FileChannel.map issue
 (#50523)

FileChannel.map provokes static initialization of ExtendedMapMode in
JDK14 EA, which needs elevated privileges.

Relates #50512
---
 .../elasticsearch/bootstrap/Bootstrap.java    | 24 +++++++++++++++++--
 .../bootstrap/BootstrapForTesting.java        |  2 ++
 2 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/bootstrap/Bootstrap.java b/server/src/main/java/org/elasticsearch/bootstrap/Bootstrap.java
index f59f082596d7b..2c3184ed9812b 100644
--- a/server/src/main/java/org/elasticsearch/bootstrap/Bootstrap.java
+++ b/server/src/main/java/org/elasticsearch/bootstrap/Bootstrap.java
@@ -19,14 +19,13 @@
 
 package org.elasticsearch.bootstrap;
 
-import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.core.Appender;
 import org.apache.logging.log4j.core.LoggerContext;
 import org.apache.logging.log4j.core.appender.ConsoleAppender;
 import org.apache.logging.log4j.core.config.Configurator;
 import org.apache.lucene.util.Constants;
-import org.elasticsearch.core.internal.io.IOUtils;
 import org.apache.lucene.util.StringHelper;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.Version;
@@ -41,6 +40,7 @@
 import org.elasticsearch.common.settings.SecureSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.transport.BoundTransportAddress;
+import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.monitor.jvm.JvmInfo;
 import org.elasticsearch.monitor.os.OsProbe;
@@ -158,6 +158,24 @@ static void initializeProbes() {
         JvmInfo.jvmInfo();
     }
 
+    /**
+     * JDK 14 bug:
+     * https://github.com/elastic/elasticsearch/issues/50512
+     * We circumvent it here by loading the offending class before installing security manager.
+     *
+     * To be removed once the JDK is fixed.
+     */
+    static void fixJDK14EAFileChannelMap() {
+        // minor time-bomb here to ensure that we reevaluate if final 14 version does not include fix.
+        if (System.getProperty("java.version").equals("14-ea")) {
+            try {
+                Class.forName("jdk.internal.misc.ExtendedMapMode", true, Bootstrap.class.getClassLoader());
+            } catch (ClassNotFoundException e) {
+                throw new RuntimeException("Unable to lookup ExtendedMapMode class", e);
+            }
+        }
+    }
+
     private void setup(boolean addShutdownHook, Environment environment) throws BootstrapException {
         Settings settings = environment.settings();
 
@@ -209,6 +227,8 @@ public void run() {
         // Log ifconfig output before SecurityManager is installed
         IfConfig.logIfNecessary();
 
+        fixJDK14EAFileChannelMap();
+
         // install SM after natives, shutdown hooks, etc.
         try {
             Security.configure(environment, BootstrapSettings.SECURITY_FILTER_BAD_DEFAULTS_SETTING.get(settings));
diff --git a/test/framework/src/main/java/org/elasticsearch/bootstrap/BootstrapForTesting.java b/test/framework/src/main/java/org/elasticsearch/bootstrap/BootstrapForTesting.java
index e035b779b3f02..c67eea7524951 100644
--- a/test/framework/src/main/java/org/elasticsearch/bootstrap/BootstrapForTesting.java
+++ b/test/framework/src/main/java/org/elasticsearch/bootstrap/BootstrapForTesting.java
@@ -102,6 +102,8 @@ public class BootstrapForTesting {
         // Log ifconfig output before SecurityManager is installed
         IfConfig.logIfNecessary();
 
+        Bootstrap.fixJDK14EAFileChannelMap();
+
         // install security manager if requested
         if (systemPropertyAsBoolean("tests.security.manager", true)) {
             try {

From ed50a37e9967220d2345ae6ecf34196e720f8ce4 Mon Sep 17 00:00:00 2001
From: Nikita Glashenko <nikita.glashenko@gmail.com>
Date: Mon, 6 Jan 2020 15:46:08 +0400
Subject: [PATCH 389/686] Add tests for remaining IntervalsSourceProvider
 implementations (#50326)

This PR adds unit tests for wire and xContent serialization of remaining IntervalsSourceProvider
implementations.

Closes #50150
---
 .../index/query/IntervalsSourceProvider.java  |  95 +++++++++++++++-
 .../elasticsearch/search/SearchModule.java    |  30 +++---
 .../CombineIntervalsSourceProviderTests.java  |  88 +++++++++++++++
 ...sjunctionIntervalsSourceProviderTests.java |  75 +++++++++++++
 .../FilterIntervalsSourceProviderTests.java   |  87 +++++++++++++++
 .../FuzzyIntervalsSourceProviderTests.java    | 101 ++++++++++++++++++
 .../query/IntervalQueryBuilderTests.java      |  60 +++++++----
 .../MatchIntervalsSourceProviderTests.java    |  93 ++++++++++++++++
 .../WildcardIntervalsSourceProviderTests.java |   4 +
 9 files changed, 594 insertions(+), 39 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/index/query/CombineIntervalsSourceProviderTests.java
 create mode 100644 server/src/test/java/org/elasticsearch/index/query/DisjunctionIntervalsSourceProviderTests.java
 create mode 100644 server/src/test/java/org/elasticsearch/index/query/FilterIntervalsSourceProviderTests.java
 create mode 100644 server/src/test/java/org/elasticsearch/index/query/FuzzyIntervalsSourceProviderTests.java
 create mode 100644 server/src/test/java/org/elasticsearch/index/query/MatchIntervalsSourceProviderTests.java

diff --git a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
index dbd8f339ca66f..1f015af9b7f98 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
@@ -246,6 +246,30 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         public static Match fromXContent(XContentParser parser) {
             return PARSER.apply(parser, null);
         }
+
+        String getQuery() {
+            return query;
+        }
+
+        int getMaxGaps() {
+            return maxGaps;
+        }
+
+        boolean isOrdered() {
+            return ordered;
+        }
+
+        String getAnalyzer() {
+            return analyzer;
+        }
+
+        IntervalFilter getFilter() {
+            return filter;
+        }
+
+        String getUseField() {
+            return useField;
+        }
     }
 
     public static class Disjunction extends IntervalsSourceProvider {
@@ -290,12 +314,13 @@ public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
             Disjunction that = (Disjunction) o;
-            return Objects.equals(subSources, that.subSources);
+            return Objects.equals(subSources, that.subSources) &&
+                Objects.equals(filter, that.filter);
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(subSources);
+            return Objects.hash(subSources, filter);
         }
 
         @Override
@@ -342,6 +367,14 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         public static Disjunction fromXContent(XContentParser parser) throws IOException {
             return PARSER.parse(parser, null);
         }
+
+        List<IntervalsSourceProvider> getSubSources() {
+            return subSources;
+        }
+
+        IntervalFilter getFilter() {
+            return filter;
+        }
     }
 
     public static class Combine extends IntervalsSourceProvider {
@@ -393,12 +426,14 @@ public boolean equals(Object o) {
             if (o == null || getClass() != o.getClass()) return false;
             Combine combine = (Combine) o;
             return Objects.equals(subSources, combine.subSources) &&
-                ordered == combine.ordered && maxGaps == combine.maxGaps;
+                ordered == combine.ordered &&
+                maxGaps == combine.maxGaps &&
+                Objects.equals(filter, combine.filter);
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(subSources, ordered, maxGaps);
+            return Objects.hash(subSources, ordered, maxGaps, filter);
         }
 
         @Override
@@ -452,6 +487,22 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         public static Combine fromXContent(XContentParser parser) {
             return PARSER.apply(parser, null);
         }
+
+        List<IntervalsSourceProvider> getSubSources() {
+            return subSources;
+        }
+
+        boolean isOrdered() {
+            return ordered;
+        }
+
+        int getMaxGaps() {
+            return maxGaps;
+        }
+
+        IntervalFilter getFilter() {
+            return filter;
+        }
     }
 
     public static class Prefix extends IntervalsSourceProvider {
@@ -838,6 +889,30 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         public static Fuzzy fromXContent(XContentParser parser) throws IOException {
             return PARSER.parse(parser, null);
         }
+
+        String getTerm() {
+            return term;
+        }
+
+        int getPrefixLength() {
+            return prefixLength;
+        }
+
+        boolean isTranspositions() {
+            return transpositions;
+        }
+
+        Fuzziness getFuzziness() {
+            return fuzziness;
+        }
+
+        String getAnalyzer() {
+            return analyzer;
+        }
+
+        String getUseField() {
+            return useField;
+        }
     }
 
     static class ScriptFilterSource extends FilteredIntervalsSource {
@@ -985,6 +1060,18 @@ public static IntervalFilter fromXContent(XContentParser parser) throws IOExcept
             }
             return new IntervalFilter(intervals, type);
         }
+
+        String getType() {
+            return type;
+        }
+
+        IntervalsSourceProvider getFilter() {
+            return filter;
+        }
+
+        Script getScript() {
+            return script;
+        }
     }
 
 
diff --git a/server/src/main/java/org/elasticsearch/search/SearchModule.java b/server/src/main/java/org/elasticsearch/search/SearchModule.java
index ca64b749a5809..0be9317242c68 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchModule.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchModule.java
@@ -794,18 +794,24 @@ private void registerQueryParsers(List<SearchPlugin> plugins) {
     }
 
     private void registerIntervalsSourceProviders() {
-        namedWriteables.add(new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
-            IntervalsSourceProvider.Match.NAME, IntervalsSourceProvider.Match::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
-            IntervalsSourceProvider.Combine.NAME, IntervalsSourceProvider.Combine::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
-            IntervalsSourceProvider.Disjunction.NAME, IntervalsSourceProvider.Disjunction::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
-            IntervalsSourceProvider.Prefix.NAME, IntervalsSourceProvider.Prefix::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
-            IntervalsSourceProvider.Wildcard.NAME, IntervalsSourceProvider.Wildcard::new));
-        namedWriteables.add(new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
-            IntervalsSourceProvider.Fuzzy.NAME, IntervalsSourceProvider.Fuzzy::new));
+        namedWriteables.addAll(getIntervalsSourceProviderNamedWritables());
+    }
+
+    public static List<NamedWriteableRegistry.Entry> getIntervalsSourceProviderNamedWritables() {
+        return List.of(
+            new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
+                IntervalsSourceProvider.Match.NAME, IntervalsSourceProvider.Match::new),
+            new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
+                IntervalsSourceProvider.Combine.NAME, IntervalsSourceProvider.Combine::new),
+            new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
+                IntervalsSourceProvider.Disjunction.NAME, IntervalsSourceProvider.Disjunction::new),
+            new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
+                IntervalsSourceProvider.Prefix.NAME, IntervalsSourceProvider.Prefix::new),
+            new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
+                IntervalsSourceProvider.Wildcard.NAME, IntervalsSourceProvider.Wildcard::new),
+            new NamedWriteableRegistry.Entry(IntervalsSourceProvider.class,
+                IntervalsSourceProvider.Fuzzy.NAME, IntervalsSourceProvider.Fuzzy::new)
+        );
     }
 
     private void registerQuery(QuerySpec<?> spec) {
diff --git a/server/src/test/java/org/elasticsearch/index/query/CombineIntervalsSourceProviderTests.java b/server/src/test/java/org/elasticsearch/index/query/CombineIntervalsSourceProviderTests.java
new file mode 100644
index 0000000000000..f65a08d2b2b12
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/query/CombineIntervalsSourceProviderTests.java
@@ -0,0 +1,88 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.index.query.IntervalsSourceProvider.Combine;
+
+public class CombineIntervalsSourceProviderTests extends AbstractSerializingTestCase<Combine> {
+
+    @Override
+    protected Combine createTestInstance() {
+        return IntervalQueryBuilderTests.createRandomCombine(0, randomBoolean());
+    }
+
+    @Override
+    protected Combine mutateInstance(Combine instance) throws IOException {
+        List<IntervalsSourceProvider> subSources = instance.getSubSources();
+        boolean ordered = instance.isOrdered();
+        int maxGaps = instance.getMaxGaps();
+        IntervalsSourceProvider.IntervalFilter filter = instance.getFilter();
+        switch (between(0, 3)) {
+            case 0:
+                subSources = subSources == null ?
+                    IntervalQueryBuilderTests.createRandomSourceList(0, randomBoolean(), randomInt(5) + 1) :
+                    null;
+                break;
+            case 1:
+                ordered = !ordered;
+                break;
+            case 2:
+                maxGaps++;
+                break;
+            case 3:
+                filter = filter == null ?
+                    IntervalQueryBuilderTests.createRandomNonNullFilter(0, randomBoolean()) :
+                    FilterIntervalsSourceProviderTests.mutateFilter(filter);
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+        return new Combine(subSources, ordered, maxGaps, filter);
+    }
+
+    @Override
+    protected Writeable.Reader<Combine> instanceReader() {
+        return Combine::new;
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(SearchModule.getIntervalsSourceProviderNamedWritables());
+    }
+
+    @Override
+    protected Combine doParseInstance(XContentParser parser) throws IOException {
+        if (parser.nextToken() == XContentParser.Token.START_OBJECT) {
+            parser.nextToken();
+        }
+        Combine combine = (Combine) IntervalsSourceProvider.fromXContent(parser);
+        assertEquals(XContentParser.Token.END_OBJECT, parser.nextToken());
+        return combine;
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/query/DisjunctionIntervalsSourceProviderTests.java b/server/src/test/java/org/elasticsearch/index/query/DisjunctionIntervalsSourceProviderTests.java
new file mode 100644
index 0000000000000..0daf48df07ba6
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/query/DisjunctionIntervalsSourceProviderTests.java
@@ -0,0 +1,75 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.index.query.IntervalsSourceProvider.Disjunction;
+
+public class DisjunctionIntervalsSourceProviderTests extends AbstractSerializingTestCase<Disjunction> {
+
+    @Override
+    protected Disjunction createTestInstance() {
+        return IntervalQueryBuilderTests.createRandomDisjunction(0, randomBoolean());
+    }
+
+    @Override
+    protected Disjunction mutateInstance(Disjunction instance) throws IOException {
+        List<IntervalsSourceProvider> subSources = instance.getSubSources();
+        IntervalsSourceProvider.IntervalFilter filter = instance.getFilter();
+        if (randomBoolean()) {
+            subSources = subSources == null ?
+                IntervalQueryBuilderTests.createRandomSourceList(0, randomBoolean(), randomInt(5) + 1) :
+                null;
+        } else {
+            filter = filter == null ?
+                IntervalQueryBuilderTests.createRandomNonNullFilter(0, randomBoolean()) :
+                FilterIntervalsSourceProviderTests.mutateFilter(filter);
+        }
+        return new Disjunction(subSources, filter);
+    }
+
+    @Override
+    protected Writeable.Reader<Disjunction> instanceReader() {
+        return Disjunction::new;
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(SearchModule.getIntervalsSourceProviderNamedWritables());
+    }
+
+    @Override
+    protected Disjunction doParseInstance(XContentParser parser) throws IOException {
+        if (parser.nextToken() == XContentParser.Token.START_OBJECT) {
+            parser.nextToken();
+        }
+        Disjunction disjunction = (Disjunction) IntervalsSourceProvider.fromXContent(parser);
+        assertEquals(XContentParser.Token.END_OBJECT, parser.nextToken());
+        return disjunction;
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/query/FilterIntervalsSourceProviderTests.java b/server/src/test/java/org/elasticsearch/index/query/FilterIntervalsSourceProviderTests.java
new file mode 100644
index 0000000000000..9e7c5e84a0c80
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/query/FilterIntervalsSourceProviderTests.java
@@ -0,0 +1,87 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.script.Script;
+import org.elasticsearch.script.ScriptType;
+import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+import java.util.Collections;
+
+import static org.elasticsearch.index.query.IntervalsSourceProvider.IntervalFilter;
+
+public class FilterIntervalsSourceProviderTests extends AbstractSerializingTestCase<IntervalFilter> {
+
+    @Override
+    protected IntervalFilter createTestInstance() {
+        return IntervalQueryBuilderTests.createRandomNonNullFilter(0, randomBoolean());
+    }
+
+    @Override
+    protected IntervalFilter mutateInstance(IntervalFilter instance) throws IOException {
+        return mutateFilter(instance);
+    }
+
+    static IntervalFilter mutateFilter(IntervalFilter instance) {
+        IntervalsSourceProvider filter = instance.getFilter();
+        String type = instance.getType();
+        Script script = instance.getScript();
+
+        if (filter != null) {
+            if (randomBoolean()) {
+                if (filter instanceof IntervalsSourceProvider.Match) {
+                    filter = WildcardIntervalsSourceProviderTests.createRandomWildcard();
+                } else {
+                    filter = IntervalQueryBuilderTests.createRandomMatch(0, randomBoolean());
+                }
+            } else {
+                if (type.equals("containing")) {
+                    type = "overlapping";
+                } else {
+                    type = "containing";
+                }
+            }
+            return new IntervalFilter(filter, type);
+        } else {
+            return new IntervalFilter(new Script(ScriptType.INLINE, "mockscript", script.getIdOrCode() + "foo", Collections.emptyMap()));
+        }
+    }
+
+    @Override
+    protected Writeable.Reader<IntervalFilter> instanceReader() {
+        return IntervalFilter::new;
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(SearchModule.getIntervalsSourceProviderNamedWritables());
+    }
+
+    @Override
+    protected IntervalFilter doParseInstance(XContentParser parser) throws IOException {
+        parser.nextToken();
+        return IntervalFilter.fromXContent(parser);
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/query/FuzzyIntervalsSourceProviderTests.java b/server/src/test/java/org/elasticsearch/index/query/FuzzyIntervalsSourceProviderTests.java
new file mode 100644
index 0000000000000..ade0777740868
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/query/FuzzyIntervalsSourceProviderTests.java
@@ -0,0 +1,101 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.unit.Fuzziness;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.index.query.IntervalsSourceProvider.Fuzzy;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+
+public class FuzzyIntervalsSourceProviderTests extends AbstractSerializingTestCase<Fuzzy> {
+    @Override
+    protected Fuzzy createTestInstance() {
+        return new Fuzzy(
+            randomAlphaOfLength(10),
+            randomInt(5),
+            randomBoolean(),
+            Fuzziness.fromEdits(randomInt(2)),
+            randomBoolean() ? null : randomAlphaOfLength(10),
+            randomBoolean() ? null : randomAlphaOfLength(10)
+        );
+    }
+
+    @Override
+    protected Fuzzy mutateInstance(Fuzzy instance) throws IOException {
+        String term = instance.getTerm();
+        int prefixLength = instance.getPrefixLength();
+        boolean isTranspositions = instance.isTranspositions();
+        Fuzziness fuzziness = instance.getFuzziness();
+        String analyzer = instance.getAnalyzer();
+        String useField = instance.getUseField();
+        switch (between(0, 5)) {
+            case 0:
+                term = randomAlphaOfLength(5);
+                break;
+            case 1:
+                prefixLength++;
+                break;
+            case 2:
+                isTranspositions = !isTranspositions;
+                break;
+            case 3:
+                if (fuzziness.equals(Fuzziness.ZERO)) {
+                    fuzziness = Fuzziness.ONE;
+                } else {
+                    fuzziness = Fuzziness.ZERO;
+                }
+                break;
+            case 4:
+                analyzer = analyzer == null ? randomAlphaOfLength(5) : null;
+                break;
+            case 5:
+                useField = useField == null ? randomAlphaOfLength(5) : null;
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+        return new Fuzzy(
+            term,
+            prefixLength,
+            isTranspositions,
+            fuzziness,
+            analyzer,
+            useField
+        );
+    }
+
+    @Override
+    protected Writeable.Reader<Fuzzy> instanceReader() {
+        return Fuzzy::new;
+    }
+
+    @Override
+    protected Fuzzy doParseInstance(XContentParser parser) throws IOException {
+        if (parser.nextToken() == XContentParser.Token.START_OBJECT) {
+            parser.nextToken();
+        }
+        Fuzzy Fuzzy = (Fuzzy) IntervalsSourceProvider.fromXContent(parser);
+        assertEquals(XContentParser.Token.END_OBJECT, parser.nextToken());
+        return Fuzzy;
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
index ed7caeb0473de..4da5ebf4d4ea7 100644
--- a/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/IntervalQueryBuilderTests.java
@@ -89,47 +89,61 @@ protected void initializeAdditionalMappings(MapperService mapperService) throws
             new CompressedXContent(Strings.toString(mapping)), MapperService.MergeReason.MAPPING_UPDATE);
     }
 
-    private IntervalsSourceProvider createRandomSource(int depth, boolean useScripts) {
+    private static IntervalsSourceProvider createRandomSource(int depth, boolean useScripts) {
         if (depth > 2) {
             return createRandomMatch(depth + 1, useScripts);
         }
         switch (randomInt(20)) {
             case 0:
             case 1:
-                int orCount = randomInt(4) + 1;
-                List<IntervalsSourceProvider> orSources = new ArrayList<>();
-                for (int i = 0; i < orCount; i++) {
-                    orSources.add(createRandomSource(depth + 1, useScripts));
-                }
-                return new IntervalsSourceProvider.Disjunction(orSources, createRandomFilter(depth + 1, useScripts));
+                return createRandomDisjunction(depth, useScripts);
             case 2:
             case 3:
-                int count = randomInt(5) + 1;
-                List<IntervalsSourceProvider> subSources = new ArrayList<>();
-                for (int i = 0; i < count; i++) {
-                    subSources.add(createRandomSource(depth + 1, useScripts));
-                }
-                boolean ordered = randomBoolean();
-                int maxGaps = randomInt(5) - 1;
-                IntervalsSourceProvider.IntervalFilter filter = createRandomFilter(depth + 1, useScripts);
-                return new IntervalsSourceProvider.Combine(subSources, ordered, maxGaps, filter);
+                return createRandomCombine(depth, useScripts);
             default:
                 return createRandomMatch(depth + 1, useScripts);
         }
     }
 
-    private IntervalsSourceProvider.IntervalFilter createRandomFilter(int depth, boolean useScripts) {
+    static IntervalsSourceProvider.Disjunction createRandomDisjunction(int depth, boolean useScripts) {
+        int orCount = randomInt(4) + 1;
+        List<IntervalsSourceProvider> orSources = createRandomSourceList(depth, useScripts, orCount);
+        return new IntervalsSourceProvider.Disjunction(orSources, createRandomFilter(depth + 1, useScripts));
+    }
+
+    static IntervalsSourceProvider.Combine createRandomCombine(int depth, boolean useScripts) {
+        int count = randomInt(5) + 1;
+        List<IntervalsSourceProvider> subSources = createRandomSourceList(depth, useScripts, count);
+        boolean ordered = randomBoolean();
+        int maxGaps = randomInt(5) - 1;
+        IntervalsSourceProvider.IntervalFilter filter = createRandomFilter(depth + 1, useScripts);
+        return new IntervalsSourceProvider.Combine(subSources, ordered, maxGaps, filter);
+    }
+
+    static List<IntervalsSourceProvider> createRandomSourceList(int depth, boolean useScripts, int count) {
+        List<IntervalsSourceProvider> subSources = new ArrayList<>();
+        for (int i = 0; i < count; i++) {
+            subSources.add(createRandomSource(depth + 1, useScripts));
+        }
+        return subSources;
+    }
+
+    private static IntervalsSourceProvider.IntervalFilter createRandomFilter(int depth, boolean useScripts) {
         if (depth < 3 && randomInt(20) > 18) {
-            if (useScripts == false || randomBoolean()) {
-                return new IntervalsSourceProvider.IntervalFilter(createRandomSource(depth + 1, false), randomFrom(filters));
-            }
-            return new IntervalsSourceProvider.IntervalFilter(
-                new Script(ScriptType.INLINE, "mockscript", "1", Collections.emptyMap()));
+            return createRandomNonNullFilter(depth, useScripts);
         }
         return null;
     }
 
-    private IntervalsSourceProvider createRandomMatch(int depth, boolean useScripts) {
+    static IntervalsSourceProvider.IntervalFilter createRandomNonNullFilter(int depth, boolean useScripts) {
+        if (useScripts == false || randomBoolean()) {
+            return new IntervalsSourceProvider.IntervalFilter(createRandomSource(depth + 1, false), randomFrom(filters));
+        }
+        return new IntervalsSourceProvider.IntervalFilter(
+            new Script(ScriptType.INLINE, "mockscript", "1", Collections.emptyMap()));
+    }
+
+    static IntervalsSourceProvider.Match createRandomMatch(int depth, boolean useScripts) {
         String useField = rarely() ? MASKED_FIELD : null;
         int wordCount = randomInt(4) + 1;
         List<String> words = new ArrayList<>();
diff --git a/server/src/test/java/org/elasticsearch/index/query/MatchIntervalsSourceProviderTests.java b/server/src/test/java/org/elasticsearch/index/query/MatchIntervalsSourceProviderTests.java
new file mode 100644
index 0000000000000..be2a2d69a05e8
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/query/MatchIntervalsSourceProviderTests.java
@@ -0,0 +1,93 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+
+import static org.elasticsearch.index.query.IntervalsSourceProvider.Match;
+
+public class MatchIntervalsSourceProviderTests extends AbstractSerializingTestCase<Match> {
+
+    @Override
+    protected Match createTestInstance() {
+        return IntervalQueryBuilderTests.createRandomMatch(0, randomBoolean());
+    }
+
+    @Override
+    protected Match mutateInstance(Match instance) throws IOException {
+        String query = instance.getQuery();
+        int maxGaps = instance.getMaxGaps();
+        boolean isOrdered = instance.isOrdered();
+        String analyzer = instance.getAnalyzer();
+        IntervalsSourceProvider.IntervalFilter filter = instance.getFilter();
+        String useField = instance.getUseField();
+        switch (between(0, 5)) {
+            case 0:
+                query = randomAlphaOfLength(query.length() + 3);
+                break;
+            case 1:
+                maxGaps++;
+                break;
+            case 2:
+                isOrdered = !isOrdered;
+                break;
+            case 3:
+                analyzer = analyzer == null ? randomAlphaOfLength(5) : null;
+                break;
+            case 4:
+                filter = filter == null ?
+                    IntervalQueryBuilderTests.createRandomNonNullFilter(0, randomBoolean()) :
+                    FilterIntervalsSourceProviderTests.mutateFilter(filter);
+                break;
+            case 5:
+                useField = useField == null ? randomAlphaOfLength(5) : (useField + "foo");
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+        return new Match(query, maxGaps, isOrdered, analyzer, filter, useField);
+    }
+
+    @Override
+    protected Writeable.Reader<Match> instanceReader() {
+        return Match::new;
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(SearchModule.getIntervalsSourceProviderNamedWritables());
+    }
+
+    @Override
+    protected Match doParseInstance(XContentParser parser) throws IOException {
+        if (parser.nextToken() == XContentParser.Token.START_OBJECT) {
+            parser.nextToken();
+        }
+        Match Match = (Match) IntervalsSourceProvider.fromXContent(parser);
+        assertEquals(XContentParser.Token.END_OBJECT, parser.nextToken());
+        return Match;
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/query/WildcardIntervalsSourceProviderTests.java b/server/src/test/java/org/elasticsearch/index/query/WildcardIntervalsSourceProviderTests.java
index 7bcf3defeea9c..b67621e8878f1 100644
--- a/server/src/test/java/org/elasticsearch/index/query/WildcardIntervalsSourceProviderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/WildcardIntervalsSourceProviderTests.java
@@ -31,6 +31,10 @@ public class WildcardIntervalsSourceProviderTests extends AbstractSerializingTes
 
     @Override
     protected Wildcard createTestInstance() {
+        return createRandomWildcard();
+    }
+
+    static Wildcard createRandomWildcard() {
         return new Wildcard(
             randomAlphaOfLength(10),
             randomBoolean() ? randomAlphaOfLength(10) : null,

From 5d15e90efaad086295ce77c71cd63322dfdd41e0 Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Mon, 6 Jan 2020 13:24:07 +0100
Subject: [PATCH 390/686] Deleted docs disregarded for if_seq_no check (#50526)

Previously, as long as a deleted version value was kept as a tombstone,
another index or delete operation against the same id would leak that
the doc had existed (through seq_no info) or would allow the operation
if the client forged the seq_no. Fixed to disregard info on deleted docs
when doing seq_no based optimistic concurrency check.
---
 .../index/engine/InternalEngine.java          |  4 +-
 .../index/engine/InternalEngineTests.java     | 38 +++++++++++++++++--
 .../indices/settings/UpdateSettingsIT.java    | 22 +++++------
 .../versioning/SimpleVersioningIT.java        |  9 +----
 4 files changed, 49 insertions(+), 24 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java b/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
index a090501ca0de4..0ea50322b173b 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
@@ -1032,7 +1032,7 @@ private IndexingStrategy planIndexingAsPrimary(Index index) throws IOException {
                 currentVersion = versionValue.version;
                 currentNotFoundOrDeleted = versionValue.isDelete();
             }
-            if (index.getIfSeqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO && versionValue == null) {
+            if (index.getIfSeqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO && currentNotFoundOrDeleted) {
                 final VersionConflictEngineException e = new VersionConflictEngineException(shardId, index.id(),
                     index.getIfSeqNo(), index.getIfPrimaryTerm(), SequenceNumbers.UNASSIGNED_SEQ_NO,
                     SequenceNumbers.UNASSIGNED_PRIMARY_TERM);
@@ -1361,7 +1361,7 @@ private DeletionStrategy planDeletionAsPrimary(Delete delete) throws IOException
             currentlyDeleted = versionValue.isDelete();
         }
         final DeletionStrategy plan;
-        if (delete.getIfSeqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO && versionValue == null) {
+        if (delete.getIfSeqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO && currentlyDeleted) {
             final VersionConflictEngineException e = new VersionConflictEngineException(shardId, delete.id(),
                 delete.getIfSeqNo(), delete.getIfPrimaryTerm(), SequenceNumbers.UNASSIGNED_SEQ_NO, SequenceNumbers.UNASSIGNED_PRIMARY_TERM);
             plan = DeletionStrategy.skipDueToVersionConflict(e, currentVersion, true);
diff --git a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
index b9fe4c7dc4d98..c71730b6494f9 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
@@ -138,6 +138,7 @@
 import org.elasticsearch.test.VersionUtils;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.hamcrest.MatcherAssert;
+import org.hamcrest.Matchers;
 
 import java.io.Closeable;
 import java.io.IOException;
@@ -1719,7 +1720,7 @@ private int assertOpsOnPrimary(List<Engine.Operation> ops, long currentOpVersion
                 currentTerm.set(currentTerm.get() + 1L);
                 engine.rollTranslogGeneration();
             }
-            final long correctVersion = docDeleted && randomBoolean() ? Versions.MATCH_DELETED : lastOpVersion;
+            final long correctVersion = docDeleted ? Versions.MATCH_DELETED : lastOpVersion;
             logger.info("performing [{}]{}{}",
                 op.operationType().name().charAt(0),
                 versionConflict ? " (conflict " + conflictingVersion + ")" : "",
@@ -1742,7 +1743,7 @@ private int assertOpsOnPrimary(List<Engine.Operation> ops, long currentOpVersion
                     final Engine.IndexResult result;
                     if (versionedOp) {
                         // TODO: add support for non-existing docs
-                        if (randomBoolean() && lastOpSeqNo != SequenceNumbers.UNASSIGNED_SEQ_NO) {
+                        if (randomBoolean() && lastOpSeqNo != SequenceNumbers.UNASSIGNED_SEQ_NO && docDeleted == false) {
                             result = engine.index(indexWithSeq.apply(lastOpSeqNo, lastOpTerm, index));
                         } else {
                             result = engine.index(indexWithVersion.apply(correctVersion, index));
@@ -1777,8 +1778,9 @@ private int assertOpsOnPrimary(List<Engine.Operation> ops, long currentOpVersion
                     assertThat(result.getFailure(), instanceOf(VersionConflictEngineException.class));
                 } else {
                     final Engine.DeleteResult result;
+                    long correctSeqNo = docDeleted ? UNASSIGNED_SEQ_NO : lastOpSeqNo;
                     if (versionedOp && lastOpSeqNo != UNASSIGNED_SEQ_NO && randomBoolean()) {
-                        result = engine.delete(delWithSeq.apply(lastOpSeqNo, lastOpTerm, delete));
+                        result = engine.delete(delWithSeq.apply(correctSeqNo, lastOpTerm, delete));
                     } else if (versionedOp) {
                         result = engine.delete(delWithVersion.apply(correctVersion, delete));
                     } else {
@@ -4031,6 +4033,36 @@ public void testOutOfOrderSequenceNumbersWithVersionConflict() throws IOExceptio
         }
     }
 
+    /**
+     * Test that we do not leak out information on a deleted doc due to it existing in version map. There are at least 2 cases:
+     * <ul>
+     *     <li>Guessing the deleted seqNo makes the operation succeed</li>
+     *     <li>Providing any other seqNo leaks info that the doc was deleted (and its SeqNo)</li>
+     * </ul>
+     */
+    public void testVersionConflictIgnoreDeletedDoc() throws IOException {
+        ParsedDocument doc = testParsedDocument("1", null, testDocument(),
+            new BytesArray("{}".getBytes(Charset.defaultCharset())), null);
+        engine.delete(new Engine.Delete("1", newUid("1"), 1));
+        for (long seqNo : new long[]{0, 1, randomNonNegativeLong()}) {
+            assertDeletedVersionConflict(engine.index(new Engine.Index(newUid("1"), doc, UNASSIGNED_SEQ_NO, 1,
+                    Versions.MATCH_ANY, VersionType.INTERNAL,
+                    PRIMARY, randomNonNegativeLong(), IndexRequest.UNSET_AUTO_GENERATED_TIMESTAMP, false, seqNo, 1)),
+                "update: " + seqNo);
+
+            assertDeletedVersionConflict(engine.delete(new Engine.Delete("1", newUid("1"), UNASSIGNED_SEQ_NO, 1,
+                    Versions.MATCH_ANY, VersionType.INTERNAL, PRIMARY, randomNonNegativeLong(), seqNo, 1)),
+                "delete: " + seqNo);
+        }
+    }
+
+    private void assertDeletedVersionConflict(Engine.Result result, String operation) {
+        assertNotNull("Must have failure for " + operation, result.getFailure());
+        assertThat(operation, result.getFailure(), Matchers.instanceOf(VersionConflictEngineException.class));
+        VersionConflictEngineException exception = (VersionConflictEngineException) result.getFailure();
+        assertThat(operation, exception.getMessage(), containsString("but no document was found"));
+    }
+
     /*
      * This test tests that a no-op does not generate a new sequence number, that no-ops can advance the local checkpoint, and that no-ops
      * are correctly added to the translog.
diff --git a/server/src/test/java/org/elasticsearch/indices/settings/UpdateSettingsIT.java b/server/src/test/java/org/elasticsearch/indices/settings/UpdateSettingsIT.java
index 3d063ac3690bb..e79c0a15d21c9 100644
--- a/server/src/test/java/org/elasticsearch/indices/settings/UpdateSettingsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/settings/UpdateSettingsIT.java
@@ -21,13 +21,13 @@
 
 import org.elasticsearch.action.admin.cluster.health.ClusterHealthResponse;
 import org.elasticsearch.action.admin.indices.settings.get.GetSettingsResponse;
-import org.elasticsearch.action.delete.DeleteResponse;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.IndexModule;
 import org.elasticsearch.index.IndexService;
+import org.elasticsearch.index.VersionType;
 import org.elasticsearch.index.engine.VersionConflictEngineException;
 import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.plugins.Plugin;
@@ -449,16 +449,15 @@ public void testOpenCloseUpdateSettings() throws Exception {
 
     public void testEngineGCDeletesSetting() throws Exception {
         createIndex("test");
-        client().prepareIndex("test").setId("1").setSource("f", 1).get();
-        DeleteResponse response = client().prepareDelete("test", "1").get();
-        long seqNo = response.getSeqNo();
-        long primaryTerm = response.getPrimaryTerm();
-        // delete is still in cache this should work
-        client().prepareIndex("test").setId("1").setSource("f", 2).setIfSeqNo(seqNo).setIfPrimaryTerm(primaryTerm).get();
+        client().prepareIndex("test").setId("1").setSource("f", 1).setVersionType(VersionType.EXTERNAL).setVersion(1).get();
+        client().prepareDelete("test", "1").setVersionType(VersionType.EXTERNAL).setVersion(2).get();
+        // delete is still in cache this should fail
+        assertThrows(client().prepareIndex("test").setId("1").setSource("f", 3).setVersionType(VersionType.EXTERNAL).setVersion(1),
+            VersionConflictEngineException.class);
+
         assertAcked(client().admin().indices().prepareUpdateSettings("test").setSettings(Settings.builder().put("index.gc_deletes", 0)));
 
-        response = client().prepareDelete("test", "1").get();
-        seqNo = response.getSeqNo();
+        client().prepareDelete("test", "1").setVersionType(VersionType.EXTERNAL).setVersion(4).get();
 
         // Make sure the time has advanced for InternalEngine#resolveDocVersion()
         for (ThreadPool threadPool : internalCluster().getInstances(ThreadPool.class)) {
@@ -466,9 +465,8 @@ public void testEngineGCDeletesSetting() throws Exception {
             assertBusy(() -> assertThat(threadPool.relativeTimeInMillis(), greaterThan(startTime)));
         }
 
-        // delete is should not be in cache
-        assertThrows(client().prepareIndex("test").setId("1").setSource("f", 3).setIfSeqNo(seqNo).setIfPrimaryTerm(primaryTerm),
-            VersionConflictEngineException.class);
+        // delete should not be in cache
+        client().prepareIndex("test").setId("1").setSource("f", 2).setVersionType(VersionType.EXTERNAL).setVersion(1);
     }
 
     public void testUpdateSettingsWithBlocks() {
diff --git a/server/src/test/java/org/elasticsearch/versioning/SimpleVersioningIT.java b/server/src/test/java/org/elasticsearch/versioning/SimpleVersioningIT.java
index 9acc0c572039a..7709100cca2b7 100644
--- a/server/src/test/java/org/elasticsearch/versioning/SimpleVersioningIT.java
+++ b/server/src/test/java/org/elasticsearch/versioning/SimpleVersioningIT.java
@@ -283,13 +283,8 @@ public void testCompareAndSet() {
         assertThrows(client().prepareDelete("test", "1").setIfSeqNo(3).setIfPrimaryTerm(12), VersionConflictEngineException.class);
         assertThrows(client().prepareDelete("test", "1").setIfSeqNo(1).setIfPrimaryTerm(2), VersionConflictEngineException.class);
 
-
-        // This is intricate - the object was deleted but a delete transaction was with the right version. We add another one
-        // and thus the transaction is increased.
-        deleteResponse = client().prepareDelete("test", "1").setIfSeqNo(2).setIfPrimaryTerm(1).get();
-        assertEquals(DocWriteResponse.Result.NOT_FOUND, deleteResponse.getResult());
-        assertThat(deleteResponse.getSeqNo(), equalTo(3L));
-        assertThat(deleteResponse.getPrimaryTerm(), equalTo(1L));
+        // the doc is deleted. Even when we hit the deleted seqNo, a conditional delete should fail.
+        assertThrows(client().prepareDelete("test", "1").setIfSeqNo(2).setIfPrimaryTerm(1), VersionConflictEngineException.class);
     }
 
     public void testSimpleVersioningWithFlush() throws Exception {

From 0158b153832a540601f721dd51eb1c1f0a281453 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Mon, 6 Jan 2020 08:25:00 -0500
Subject: [PATCH 391/686] Replace bespoke parser for significance heuristics
 (#50623)

This replaces the hand written xcontent parsers for significance
heristics with `ObjectParser` and parsing named xcontent.

As a happy accident, this was the last user of `ParseFieldRegistry` so
this PR entirely removes that class.

Closes #25519
---
 .../common/xcontent/ParseFieldRegistry.java   | 107 ------------------
 .../elasticsearch/plugins/SearchPlugin.java   |  17 ++-
 .../java/org/elasticsearch/script/Script.java |  14 +++
 .../elasticsearch/search/SearchModule.java    |  41 +++----
 .../SignificantTermsAggregationBuilder.java   |  49 +++-----
 .../SignificantTextAggregationBuilder.java    |  32 ++----
 .../significant/heuristics/ChiSquare.java     |  14 +--
 .../bucket/significant/heuristics/GND.java    |  39 ++-----
 .../significant/heuristics/JLHScore.java      |  20 +---
 .../heuristics/MutualInformation.java         |  14 +--
 .../heuristics/NXYSignificanceHeuristic.java  |  50 ++++----
 .../heuristics/PercentageScore.java           |   2 +
 .../heuristics/ScriptHeuristic.java           |  37 ++----
 .../SignificanceHeuristicParser.java          |  34 ------
 .../search/SearchModuleTests.java             |   6 +-
 .../SignificantTermsSignificanceScoreIT.java  |  16 +--
 .../SignificanceHeuristicTests.java           |  72 +++++-------
 17 files changed, 160 insertions(+), 404 deletions(-)
 delete mode 100644 server/src/main/java/org/elasticsearch/common/xcontent/ParseFieldRegistry.java
 delete mode 100644 server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/SignificanceHeuristicParser.java

diff --git a/server/src/main/java/org/elasticsearch/common/xcontent/ParseFieldRegistry.java b/server/src/main/java/org/elasticsearch/common/xcontent/ParseFieldRegistry.java
deleted file mode 100644
index 98ecf52e4814d..0000000000000
--- a/server/src/main/java/org/elasticsearch/common/xcontent/ParseFieldRegistry.java
+++ /dev/null
@@ -1,107 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.common.xcontent;
-
-import org.elasticsearch.common.ParseField;
-import org.elasticsearch.common.ParsingException;
-import org.elasticsearch.common.collect.Tuple;
-
-import java.util.HashMap;
-import java.util.Map;
-import java.util.Set;
-
-/**
- * Registry for looking things up using ParseField semantics.
- */
-public class ParseFieldRegistry<T> {
-    private final Map<String, Tuple<ParseField, T>> registry = new HashMap<>();
-    private final String registryName;
-
-    /**
-     * Build the registry.
-     * @param registryName used for error messages
-     */
-    public ParseFieldRegistry(String registryName) {
-        this.registryName = registryName;
-    }
-
-    /**
-     * All the names under which values are registered. Expect this to be used mostly for testing.
-     */
-    public Set<String> getNames() {
-        return registry.keySet();
-    }
-
-    /**
-     * Register a parser.
-     */
-    public void register(T value, String name) {
-        register(value, new ParseField(name));
-    }
-
-    /**
-     * Register a parser.
-     */
-    public void register(T value, ParseField parseField) {
-        Tuple<ParseField, T> parseFieldParserTuple = new Tuple<>(parseField, value);
-        for (String name: parseField.getAllNamesIncludedDeprecated()) {
-            Tuple<ParseField, T> previousValue = registry.putIfAbsent(name, parseFieldParserTuple);
-            if (previousValue != null) {
-                throw new IllegalArgumentException("[" + previousValue.v2() + "] already registered for [" + registryName + "][" + name
-                        + "] while trying to register [" + value + "]");
-            }
-        }
-    }
-
-    /**
-     * Lookup a value from the registry by name while checking that the name matches the ParseField.
-     *
-     * @param name The name of the thing to look up.
-     * @return The value being looked up. Never null.
-     * @throws ParsingException if the named thing isn't in the registry or the name was deprecated and deprecated names aren't supported.
-     */
-    public T lookup(String name, XContentLocation xContentLocation, DeprecationHandler deprecationHandler) {
-        T value = lookupReturningNullIfNotFound(name, deprecationHandler);
-        if (value == null) {
-            throw new ParsingException(xContentLocation, "no [" + registryName + "] registered for [" + name + "]");
-        }
-        return value;
-    }
-
-    /**
-     * Lookup a value from the registry by name while checking that the name matches the ParseField.
-     *
-     * @param name The name of the thing to look up.
-     * @return The value being looked up or null if it wasn't found.
-     * @throws ParsingException if the named thing isn't in the registry or the name was deprecated and deprecated names aren't supported.
-     */
-    public T lookupReturningNullIfNotFound(String name, DeprecationHandler deprecationHandler) {
-        Tuple<ParseField, T> parseFieldAndValue = registry.get(name);
-        if (parseFieldAndValue == null) {
-            return null;
-        }
-        ParseField parseField = parseFieldAndValue.v1();
-        T value = parseFieldAndValue.v2();
-        boolean match = parseField.match(name, deprecationHandler);
-        //this is always expected to match, ParseField is useful for deprecation warnings etc. here
-        assert match : "ParseField did not match registered name [" + name + "][" + registryName + "]";
-        return value;
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java b/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
index 9cd3f391a2bd5..b48f1cbcc3f1c 100644
--- a/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
+++ b/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
@@ -40,7 +40,6 @@
 import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.significant.SignificantTerms;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
-import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristicParser;
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
 import org.elasticsearch.search.fetch.FetchSubPhase;
 import org.elasticsearch.search.fetch.subphase.highlight.Highlighter;
@@ -54,6 +53,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.TreeMap;
+import java.util.function.BiFunction;
 
 import static java.util.Collections.emptyList;
 import static java.util.Collections.emptyMap;
@@ -72,7 +72,7 @@ default List<ScoreFunctionSpec<?>> getScoreFunctions() {
      * The new {@link SignificanceHeuristic}s defined by this plugin. {@linkplain SignificanceHeuristic}s are used by the
      * {@link SignificantTerms} aggregation to pick which terms are significant for a given query.
      */
-    default List<SearchExtensionSpec<SignificanceHeuristic, SignificanceHeuristicParser>> getSignificanceHeuristics() {
+    default List<SignificanceHeuristicSpec<?>> getSignificanceHeuristics() {
         return emptyList();
     }
     /**
@@ -137,6 +137,19 @@ public ScoreFunctionSpec(String name, Writeable.Reader<T> reader, ScoreFunctionP
         }
     }
 
+    /**
+     * Specification of custom {@link SignificanceHeuristic}.
+     */
+    class SignificanceHeuristicSpec<T extends SignificanceHeuristic> extends SearchExtensionSpec<T, BiFunction<XContentParser, Void, T>> {
+        public SignificanceHeuristicSpec(ParseField name, Writeable.Reader<T> reader, BiFunction<XContentParser, Void, T> parser) {
+            super(name, reader, parser);
+        }
+
+        public SignificanceHeuristicSpec(String name, Writeable.Reader<T> reader, BiFunction<XContentParser, Void, T> parser) {
+            super(name, reader, parser);
+        }
+    }
+
     /**
      * Specification for a {@link Suggester}.
      */
diff --git a/server/src/main/java/org/elasticsearch/script/Script.java b/server/src/main/java/org/elasticsearch/script/Script.java
index bd74ed806cd74..dc5dd600ba2d3 100644
--- a/server/src/main/java/org/elasticsearch/script/Script.java
+++ b/server/src/main/java/org/elasticsearch/script/Script.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.AbstractObjectParser;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.ObjectParser;
@@ -47,6 +48,9 @@
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Objects;
+import java.util.function.BiConsumer;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 
 /**
  * {@link Script} represents used-defined input that can be used to
@@ -269,6 +273,16 @@ private Script build(String defaultLang) {
         PARSER.declareField(Builder::setParams, XContentParser::map, PARAMS_PARSE_FIELD, ValueType.OBJECT);
     }
 
+    /**
+     * Declare a script field on an {@link ObjectParser}.
+     * @param <T> Whatever type the {@linkplain ObjectParser} is parsing.
+     * @param parser the parser itself
+     * @param consumer the consumer for the script
+     */
+    public static <T> void declareScript(AbstractObjectParser<T, ?> parser, BiConsumer<T, Script> consumer) {
+        parser.declareField(constructorArg(), (p, c) -> Script.parse(p), Script.SCRIPT_PARSE_FIELD, ValueType.OBJECT_OR_STRING);
+    }
+
     /**
      * Convenience method to call {@link Script#parse(XContentParser, String)}
      * using the default scripting language.
diff --git a/server/src/main/java/org/elasticsearch/search/SearchModule.java b/server/src/main/java/org/elasticsearch/search/SearchModule.java
index 0be9317242c68..6e861889c7bc6 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchModule.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchModule.java
@@ -29,7 +29,6 @@
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
-import org.elasticsearch.common.xcontent.ParseFieldRegistry;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.BoolQueryBuilder;
 import org.elasticsearch.index.query.BoostingQueryBuilder;
@@ -66,6 +65,7 @@
 import org.elasticsearch.index.query.SpanFirstQueryBuilder;
 import org.elasticsearch.index.query.SpanMultiTermQueryBuilder;
 import org.elasticsearch.index.query.SpanNearQueryBuilder;
+import org.elasticsearch.index.query.SpanNearQueryBuilder.SpanGapQueryBuilder;
 import org.elasticsearch.index.query.SpanNotQueryBuilder;
 import org.elasticsearch.index.query.SpanOrQueryBuilder;
 import org.elasticsearch.index.query.SpanTermQueryBuilder;
@@ -93,7 +93,7 @@
 import org.elasticsearch.plugins.SearchPlugin.RescorerSpec;
 import org.elasticsearch.plugins.SearchPlugin.ScoreFunctionSpec;
 import org.elasticsearch.plugins.SearchPlugin.SearchExtSpec;
-import org.elasticsearch.plugins.SearchPlugin.SearchExtensionSpec;
+import org.elasticsearch.plugins.SearchPlugin.SignificanceHeuristicSpec;
 import org.elasticsearch.plugins.SearchPlugin.SuggesterSpec;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregatorFactories;
@@ -150,7 +150,6 @@
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.PercentageScore;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.ScriptHeuristic;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
-import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristicParser;
 import org.elasticsearch.search.aggregations.bucket.terms.DoubleTerms;
 import org.elasticsearch.search.aggregations.bucket.terms.LongRareTerms;
 import org.elasticsearch.search.aggregations.bucket.terms.LongTerms;
@@ -273,7 +272,6 @@
 
 import static java.util.Collections.unmodifiableMap;
 import static java.util.Objects.requireNonNull;
-import static org.elasticsearch.index.query.SpanNearQueryBuilder.SpanGapQueryBuilder;
 
 /**
  * Sets up things that can be done at search time like queries, aggregations, and suggesters.
@@ -283,8 +281,6 @@ public class SearchModule {
             1024, 1, Integer.MAX_VALUE, Setting.Property.NodeScope);
 
     private final Map<String, Highlighter> highlighters;
-    private final ParseFieldRegistry<SignificanceHeuristicParser> significanceHeuristicParserRegistry = new ParseFieldRegistry<>(
-            "significance_heuristic");
 
     private final List<FetchSubPhase> fetchSubPhases = new ArrayList<>();
 
@@ -333,13 +329,6 @@ public Map<String, Highlighter> getHighlighters() {
         return highlighters;
     }
 
-    /**
-     * The registry of {@link SignificanceHeuristic}s.
-     */
-    public ParseFieldRegistry<SignificanceHeuristicParser> getSignificanceHeuristicParserRegistry() {
-        return significanceHeuristicParserRegistry;
-    }
-
     private void registerAggregations(List<SearchPlugin> plugins) {
         registerAggregation(new AggregationSpec(AvgAggregationBuilder.NAME, AvgAggregationBuilder::new, AvgAggregationBuilder::parse)
                 .addResultReader(InternalAvg::new));
@@ -399,12 +388,12 @@ private void registerAggregations(List<SearchPlugin> plugins) {
                     .addResultReader(UnmappedRareTerms.NAME, UnmappedRareTerms::new)
                     .addResultReader(LongRareTerms.NAME, LongRareTerms::new));
         registerAggregation(new AggregationSpec(SignificantTermsAggregationBuilder.NAME, SignificantTermsAggregationBuilder::new,
-                SignificantTermsAggregationBuilder.getParser(significanceHeuristicParserRegistry))
+                SignificantTermsAggregationBuilder::parse)
                     .addResultReader(SignificantStringTerms.NAME, SignificantStringTerms::new)
                     .addResultReader(SignificantLongTerms.NAME, SignificantLongTerms::new)
                     .addResultReader(UnmappedSignificantTerms.NAME, UnmappedSignificantTerms::new));
         registerAggregation(new AggregationSpec(SignificantTextAggregationBuilder.NAME, SignificantTextAggregationBuilder::new,
-                SignificantTextAggregationBuilder.getParser(significanceHeuristicParserRegistry)));
+                SignificantTextAggregationBuilder::parse));
         registerAggregation(new AggregationSpec(RangeAggregationBuilder.NAME, RangeAggregationBuilder::new,
                 RangeAggregationBuilder::parse).addResultReader(InternalRange::new));
         registerAggregation(new AggregationSpec(DateRangeAggregationBuilder.NAME, DateRangeAggregationBuilder::new,
@@ -680,20 +669,22 @@ private void registerValueFormat(String name, Writeable.Reader<? extends DocValu
     }
 
     private void registerSignificanceHeuristics(List<SearchPlugin> plugins) {
-        registerSignificanceHeuristic(new SearchExtensionSpec<>(ChiSquare.NAME, ChiSquare::new, ChiSquare.PARSER));
-        registerSignificanceHeuristic(new SearchExtensionSpec<>(GND.NAME, GND::new, GND.PARSER));
-        registerSignificanceHeuristic(new SearchExtensionSpec<>(JLHScore.NAME, JLHScore::new, JLHScore::parse));
-        registerSignificanceHeuristic(new SearchExtensionSpec<>(MutualInformation.NAME, MutualInformation::new, MutualInformation.PARSER));
-        registerSignificanceHeuristic(new SearchExtensionSpec<>(PercentageScore.NAME, PercentageScore::new, PercentageScore::parse));
-        registerSignificanceHeuristic(new SearchExtensionSpec<>(ScriptHeuristic.NAME, ScriptHeuristic::new, ScriptHeuristic::parse));
+        registerSignificanceHeuristic(new SignificanceHeuristicSpec<>(ChiSquare.NAME, ChiSquare::new, ChiSquare.PARSER));
+        registerSignificanceHeuristic(new SignificanceHeuristicSpec<>(GND.NAME, GND::new, GND.PARSER));
+        registerSignificanceHeuristic(new SignificanceHeuristicSpec<>(JLHScore.NAME, JLHScore::new, JLHScore.PARSER));
+        registerSignificanceHeuristic(new SignificanceHeuristicSpec<>(
+            MutualInformation.NAME, MutualInformation::new, MutualInformation.PARSER));
+        registerSignificanceHeuristic(new SignificanceHeuristicSpec<>(PercentageScore.NAME, PercentageScore::new, PercentageScore.PARSER));
+        registerSignificanceHeuristic(new SignificanceHeuristicSpec<>(ScriptHeuristic.NAME, ScriptHeuristic::new, ScriptHeuristic.PARSER));
 
         registerFromPlugin(plugins, SearchPlugin::getSignificanceHeuristics, this::registerSignificanceHeuristic);
     }
 
-    private void registerSignificanceHeuristic(SearchExtensionSpec<SignificanceHeuristic, SignificanceHeuristicParser> heuristic) {
-        significanceHeuristicParserRegistry.register(heuristic.getParser(), heuristic.getName());
-        namedWriteables.add(new NamedWriteableRegistry.Entry(SignificanceHeuristic.class, heuristic.getName().getPreferredName(),
-                heuristic.getReader()));
+    private <T extends SignificanceHeuristic> void registerSignificanceHeuristic(SignificanceHeuristicSpec<?> spec) {
+        namedXContents.add(new NamedXContentRegistry.Entry(
+            SignificanceHeuristic.class, spec.getName(), p -> spec.getParser().apply(p, null)));
+        namedWriteables.add(new NamedWriteableRegistry.Entry(
+            SignificanceHeuristic.class, spec.getName().getPreferredName(), spec.getReader()));
     }
 
     private void registerFetchSubPhases(List<SearchPlugin> plugins) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTermsAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTermsAggregationBuilder.java
index 908bc0586169c..81d1b0445b3e2 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTermsAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTermsAggregationBuilder.java
@@ -23,30 +23,27 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ObjectParser;
-import org.elasticsearch.common.xcontent.ParseFieldRegistry;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryShardContext;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
-import org.elasticsearch.search.aggregations.Aggregator;
 import org.elasticsearch.search.aggregations.AggregatorFactories.Builder;
 import org.elasticsearch.search.aggregations.AggregatorFactory;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.JLHScore;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
-import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristicParser;
 import org.elasticsearch.search.aggregations.bucket.terms.IncludeExclude;
 import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregator;
 import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregator.BucketCountThresholds;
+import org.elasticsearch.search.aggregations.support.CoreValuesSourceType;
 import org.elasticsearch.search.aggregations.support.ValueType;
 import org.elasticsearch.search.aggregations.support.ValuesSource;
 import org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder;
 import org.elasticsearch.search.aggregations.support.ValuesSourceAggregatorFactory;
 import org.elasticsearch.search.aggregations.support.ValuesSourceConfig;
 import org.elasticsearch.search.aggregations.support.ValuesSourceParserHelper;
-import org.elasticsearch.search.aggregations.support.CoreValuesSourceType;
 
 import java.io.IOException;
 import java.util.Map;
@@ -65,48 +62,36 @@ public class SignificantTermsAggregationBuilder extends ValuesSourceAggregationB
             3, 0, 10, -1);
     static final SignificanceHeuristic DEFAULT_SIGNIFICANCE_HEURISTIC = new JLHScore();
 
-    public static Aggregator.Parser getParser(ParseFieldRegistry<SignificanceHeuristicParser> significanceHeuristicParserRegistry) {
-        ObjectParser<SignificantTermsAggregationBuilder, Void> aggregationParser =
-                new ObjectParser<>(SignificantTermsAggregationBuilder.NAME);
-        ValuesSourceParserHelper.declareAnyFields(aggregationParser, true, true);
+    private static final ObjectParser<SignificantTermsAggregationBuilder, Void> PARSER = new ObjectParser<>(
+        SignificantTermsAggregationBuilder.NAME,
+        SignificanceHeuristic.class, SignificantTermsAggregationBuilder::significanceHeuristic, null);
+    static {
+        ValuesSourceParserHelper.declareAnyFields(PARSER, true, true);
 
-        aggregationParser.declareInt(SignificantTermsAggregationBuilder::shardSize, TermsAggregationBuilder.SHARD_SIZE_FIELD_NAME);
+        PARSER.declareInt(SignificantTermsAggregationBuilder::shardSize, TermsAggregationBuilder.SHARD_SIZE_FIELD_NAME);
 
-        aggregationParser.declareLong(SignificantTermsAggregationBuilder::minDocCount, TermsAggregationBuilder.MIN_DOC_COUNT_FIELD_NAME);
+        PARSER.declareLong(SignificantTermsAggregationBuilder::minDocCount, TermsAggregationBuilder.MIN_DOC_COUNT_FIELD_NAME);
 
-        aggregationParser.declareLong(SignificantTermsAggregationBuilder::shardMinDocCount,
+        PARSER.declareLong(SignificantTermsAggregationBuilder::shardMinDocCount,
                 TermsAggregationBuilder.SHARD_MIN_DOC_COUNT_FIELD_NAME);
 
-        aggregationParser.declareInt(SignificantTermsAggregationBuilder::size, TermsAggregationBuilder.REQUIRED_SIZE_FIELD_NAME);
+        PARSER.declareInt(SignificantTermsAggregationBuilder::size, TermsAggregationBuilder.REQUIRED_SIZE_FIELD_NAME);
 
-        aggregationParser.declareString(SignificantTermsAggregationBuilder::executionHint,
+        PARSER.declareString(SignificantTermsAggregationBuilder::executionHint,
                 TermsAggregationBuilder.EXECUTION_HINT_FIELD_NAME);
 
-        aggregationParser.declareObject(SignificantTermsAggregationBuilder::backgroundFilter,
+        PARSER.declareObject(SignificantTermsAggregationBuilder::backgroundFilter,
                 (p, context) -> parseInnerQueryBuilder(p),
                 SignificantTermsAggregationBuilder.BACKGROUND_FILTER);
 
-        aggregationParser.declareField((b, v) -> b.includeExclude(IncludeExclude.merge(v, b.includeExclude())),
+        PARSER.declareField((b, v) -> b.includeExclude(IncludeExclude.merge(v, b.includeExclude())),
                 IncludeExclude::parseInclude, IncludeExclude.INCLUDE_FIELD, ObjectParser.ValueType.OBJECT_ARRAY_OR_STRING);
 
-        aggregationParser.declareField((b, v) -> b.includeExclude(IncludeExclude.merge(b.includeExclude(), v)),
+        PARSER.declareField((b, v) -> b.includeExclude(IncludeExclude.merge(b.includeExclude(), v)),
                 IncludeExclude::parseExclude, IncludeExclude.EXCLUDE_FIELD, ObjectParser.ValueType.STRING_ARRAY);
-
-        for (String name : significanceHeuristicParserRegistry.getNames()) {
-            aggregationParser.declareObject(SignificantTermsAggregationBuilder::significanceHeuristic,
-                    (p, context) -> {
-                        SignificanceHeuristicParser significanceHeuristicParser = significanceHeuristicParserRegistry
-                                .lookupReturningNullIfNotFound(name, p.getDeprecationHandler());
-                        return significanceHeuristicParser.parse(p);
-                    },
-                    new ParseField(name));
-        }
-        return new Aggregator.Parser() {
-            @Override
-            public AggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
-                return aggregationParser.parse(parser, new SignificantTermsAggregationBuilder(aggregationName, null), null);
-            }
-        };
+    }
+    public static SignificantTermsAggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
+        return PARSER.parse(parser, new SignificantTermsAggregationBuilder(aggregationName, null), null);
     }
 
     private IncludeExclude includeExclude = null;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTextAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTextAggregationBuilder.java
index d2e3729c335a5..c3c6e6ea53baa 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTextAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/SignificantTextAggregationBuilder.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ObjectParser;
-import org.elasticsearch.common.xcontent.ParseFieldRegistry;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.AbstractQueryBuilder;
@@ -32,11 +31,9 @@
 import org.elasticsearch.search.aggregations.AbstractAggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationInitializationException;
-import org.elasticsearch.search.aggregations.Aggregator;
 import org.elasticsearch.search.aggregations.AggregatorFactories.Builder;
 import org.elasticsearch.search.aggregations.AggregatorFactory;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
-import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristicParser;
 import org.elasticsearch.search.aggregations.bucket.terms.IncludeExclude;
 import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregator;
@@ -69,11 +66,10 @@ public class SignificantTextAggregationBuilder extends AbstractAggregationBuilde
             DEFAULT_BUCKET_COUNT_THRESHOLDS);
     private SignificanceHeuristic significanceHeuristic = DEFAULT_SIGNIFICANCE_HEURISTIC;
 
-    public static Aggregator.Parser getParser(
-            ParseFieldRegistry<SignificanceHeuristicParser> significanceHeuristicParserRegistry) {
-        ObjectParser<SignificantTextAggregationBuilder, Void> PARSER = new ObjectParser<>(
-                SignificantTextAggregationBuilder.NAME);
-
+    private static final ObjectParser<SignificantTextAggregationBuilder, Void> PARSER = new ObjectParser<>(
+                SignificantTextAggregationBuilder.NAME,
+                SignificanceHeuristic.class, SignificantTextAggregationBuilder::significanceHeuristic, null);
+    static {
         PARSER.declareInt(SignificantTextAggregationBuilder::shardSize,
                 TermsAggregationBuilder.SHARD_SIZE_FIELD_NAME);
 
@@ -105,23 +101,9 @@ public static Aggregator.Parser getParser(
         PARSER.declareField((b, v) -> b.includeExclude(IncludeExclude.merge(b.includeExclude(), v)),
                 IncludeExclude::parseExclude, IncludeExclude.EXCLUDE_FIELD,
                 ObjectParser.ValueType.STRING_ARRAY);
-
-        for (String name : significanceHeuristicParserRegistry.getNames()) {
-            PARSER.declareObject(SignificantTextAggregationBuilder::significanceHeuristic,
-                    (p, context) -> {
-                        SignificanceHeuristicParser significanceHeuristicParser = significanceHeuristicParserRegistry
-                                .lookupReturningNullIfNotFound(name, p.getDeprecationHandler());
-                        return significanceHeuristicParser.parse(p);
-                    }, new ParseField(name));
-        }
-        return new Aggregator.Parser() {
-            @Override
-            public AggregationBuilder parse(String aggregationName, XContentParser parser)
-                    throws IOException {
-                return PARSER.parse(parser,
-                        new SignificantTextAggregationBuilder(aggregationName, null), null);
-            }
-        };
+    }
+    public static SignificantTextAggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
+        return PARSER.parse(parser, new SignificantTextAggregationBuilder(aggregationName, null), null);
     }
 
     protected SignificantTextAggregationBuilder(SignificantTextAggregationBuilder clone,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ChiSquare.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ChiSquare.java
index de3c6c6acd0a3..a724c976f6899 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ChiSquare.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ChiSquare.java
@@ -22,12 +22,18 @@
 
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 
 import java.io.IOException;
 
 public class ChiSquare extends NXYSignificanceHeuristic {
     public static final String NAME = "chi_square";
+    public static final ConstructingObjectParser<ChiSquare, Void> PARSER = new ConstructingObjectParser<>(
+        NAME, buildFromParsedArgs(ChiSquare::new));
+    static {
+        NXYSignificanceHeuristic.declareParseFields(PARSER);
+    }
 
     public ChiSquare(boolean includeNegatives, boolean backgroundIsSuperset) {
         super(includeNegatives, backgroundIsSuperset);
@@ -84,15 +90,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         return builder;
     }
 
-    public static final SignificanceHeuristicParser PARSER = new NXYParser() {
-        @Override
-        protected SignificanceHeuristic newHeuristic(boolean includeNegatives, boolean backgroundIsSuperset) {
-            return new ChiSquare(includeNegatives, backgroundIsSuperset);
-        }
-    };
-
     public static class ChiSquareBuilder extends NXYSignificanceHeuristic.NXYBuilder {
-
         public ChiSquareBuilder(boolean includeNegatives, boolean backgroundIsSuperset) {
             super(includeNegatives, backgroundIsSuperset);
         }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/GND.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/GND.java
index 66b45b54f6416..e4968bd489385 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/GND.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/GND.java
@@ -21,17 +21,24 @@
 package org.elasticsearch.search.aggregations.bucket.significant.heuristics;
 
 
-import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.index.query.QueryShardException;
 
 import java.io.IOException;
 
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
+
 public class GND extends NXYSignificanceHeuristic {
     public static final String NAME = "gnd";
+    public static final ConstructingObjectParser<GND, Void> PARSER = new ConstructingObjectParser<>(NAME, args -> {
+        boolean backgroundIsSuperset = args[0] == null ? true : (boolean) args[0];
+        return new GND(backgroundIsSuperset);
+    });
+    static {
+        PARSER.declareBoolean(optionalConstructorArg(), BACKGROUND_IS_SUPERSET);
+    }
 
     public GND(boolean backgroundIsSuperset) {
         super(true, backgroundIsSuperset);
@@ -105,33 +112,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         return builder;
     }
 
-    public static final SignificanceHeuristicParser PARSER = new NXYParser() {
-        @Override
-        protected SignificanceHeuristic newHeuristic(boolean includeNegatives, boolean backgroundIsSuperset) {
-            return new GND(backgroundIsSuperset);
-        }
-
-        @Override
-        public SignificanceHeuristic parse(XContentParser parser) throws IOException, QueryShardException {
-            String givenName = parser.currentName();
-            boolean backgroundIsSuperset = true;
-            XContentParser.Token token = parser.nextToken();
-            while (!token.equals(XContentParser.Token.END_OBJECT)) {
-                if (BACKGROUND_IS_SUPERSET.match(parser.currentName(), parser.getDeprecationHandler())) {
-                    parser.nextToken();
-                    backgroundIsSuperset = parser.booleanValue();
-                } else {
-                    throw new ElasticsearchParseException("failed to parse [{}] significance heuristic. unknown field [{}]",
-                            givenName, parser.currentName());
-                }
-                token = parser.nextToken();
-            }
-            return newHeuristic(true, backgroundIsSuperset);
-        }
-    };
-
     public static class GNDBuilder extends NXYBuilder {
-
         public GNDBuilder(boolean backgroundIsSuperset) {
             super(true, backgroundIsSuperset);
         }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/JLHScore.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/JLHScore.java
index 2627008b47d81..46eda89177ce7 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/JLHScore.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/JLHScore.java
@@ -21,17 +21,16 @@
 package org.elasticsearch.search.aggregations.bucket.significant.heuristics;
 
 
-import org.elasticsearch.ElasticsearchParseException;
+import java.io.IOException;
+
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.index.query.QueryShardException;
-
-import java.io.IOException;
 
 public class JLHScore extends SignificanceHeuristic {
     public static final String NAME = "jlh";
+    public static final ObjectParser<JLHScore, Void> PARSER = new ObjectParser<>(NAME, JLHScore::new);
 
     public JLHScore() {
     }
@@ -103,17 +102,6 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         return builder;
     }
 
-    public static SignificanceHeuristic parse(XContentParser parser)
-            throws IOException, QueryShardException {
-        // move to the closing bracket
-        if (!parser.nextToken().equals(XContentParser.Token.END_OBJECT)) {
-            throw new ElasticsearchParseException(
-                    "failed to parse [jlh] significance heuristic. expected an empty object, but found [{}] instead",
-                    parser.currentToken());
-        }
-        return new JLHScore();
-    }
-
     @Override
     public boolean equals(Object obj) {
         if (obj == null || obj.getClass() != getClass()) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/MutualInformation.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/MutualInformation.java
index f8c8b61a7293b..c226d48d5d665 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/MutualInformation.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/MutualInformation.java
@@ -22,12 +22,18 @@
 
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 
 import java.io.IOException;
 
 public class MutualInformation extends NXYSignificanceHeuristic {
     public static final String NAME = "mutual_information";
+    public static final ConstructingObjectParser<MutualInformation, Void> PARSER = new ConstructingObjectParser<>(
+        NAME, buildFromParsedArgs(MutualInformation::new));
+    static {
+        NXYSignificanceHeuristic.declareParseFields(PARSER);
+    }
 
     private static final double log2 = Math.log(2.0);
 
@@ -118,15 +124,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         return builder;
     }
 
-    public static final SignificanceHeuristicParser PARSER = new NXYParser() {
-        @Override
-        protected SignificanceHeuristic newHeuristic(boolean includeNegatives, boolean backgroundIsSuperset) {
-            return new MutualInformation(includeNegatives, backgroundIsSuperset);
-        }
-    };
-
     public static class MutualInformationBuilder extends NXYBuilder {
-
         public MutualInformationBuilder(boolean includeNegatives, boolean backgroundIsSuperset) {
             super(includeNegatives, backgroundIsSuperset);
         }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/NXYSignificanceHeuristic.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/NXYSignificanceHeuristic.java
index b01bc8c1650ca..e64e14d8567a0 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/NXYSignificanceHeuristic.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/NXYSignificanceHeuristic.java
@@ -21,15 +21,17 @@
 package org.elasticsearch.search.aggregations.bucket.significant.heuristics;
 
 
-import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.index.query.QueryShardException;
 
 import java.io.IOException;
+import java.util.function.BiFunction;
+import java.util.function.Function;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
 
 public abstract class NXYSignificanceHeuristic extends SignificanceHeuristic {
 
@@ -160,34 +162,24 @@ protected void build(XContentBuilder builder) throws IOException {
                 backgroundIsSuperset);
     }
 
-    public abstract static class NXYParser implements SignificanceHeuristicParser {
-
-        @Override
-        public SignificanceHeuristic parse(XContentParser parser)
-                throws IOException, QueryShardException {
-            String givenName = parser.currentName();
-            boolean includeNegatives = false;
-            boolean backgroundIsSuperset = true;
-            XContentParser.Token token = parser.nextToken();
-            while (!token.equals(XContentParser.Token.END_OBJECT)) {
-                if (INCLUDE_NEGATIVES_FIELD.match(parser.currentName(), parser.getDeprecationHandler())) {
-                    parser.nextToken();
-                    includeNegatives = parser.booleanValue();
-                } else if (BACKGROUND_IS_SUPERSET.match(parser.currentName(), parser.getDeprecationHandler())) {
-                    parser.nextToken();
-                    backgroundIsSuperset = parser.booleanValue();
-                } else {
-                    throw new ElasticsearchParseException("failed to parse [{}] significance heuristic. unknown field [{}]",
-                            givenName, parser.currentName());
-                }
-                token = parser.nextToken();
-            }
-            return newHeuristic(includeNegatives, backgroundIsSuperset);
-        }
-
-        protected abstract SignificanceHeuristic newHeuristic(boolean includeNegatives, boolean backgroundIsSuperset);
+    /**
+     * Set up and {@linkplain ConstructingObjectParser} to accept the standard arguments for an {@linkplain NXYSignificanceHeuristic}.
+     */
+    protected static void declareParseFields(ConstructingObjectParser<? extends NXYSignificanceHeuristic, ?> parser) {
+        parser.declareBoolean(optionalConstructorArg(), INCLUDE_NEGATIVES_FIELD);
+        parser.declareBoolean(optionalConstructorArg(), BACKGROUND_IS_SUPERSET);
     }
 
+    /**
+     * Adapt a standard two argument ctor into one that consumes a {@linkplain ConstructingObjectParser}'s fields.
+     */
+    protected static <T> Function<Object[], T> buildFromParsedArgs(BiFunction<Boolean, Boolean, T> ctor) {
+        return args -> {
+            boolean includeNegatives = args[0] == null ? false : (boolean) args[0];
+            boolean backgroundIsSuperset = args[1] == null ? true : (boolean) args[1];
+            return ctor.apply(includeNegatives, backgroundIsSuperset);
+        };
+    }
 
     protected abstract static class NXYBuilder implements SignificanceHeuristicBuilder {
         protected boolean includeNegatives = true;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/PercentageScore.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/PercentageScore.java
index 80f1fece739f7..a5c7dc18b7349 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/PercentageScore.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/PercentageScore.java
@@ -24,6 +24,7 @@
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.QueryShardException;
@@ -32,6 +33,7 @@
 
 public class PercentageScore extends SignificanceHeuristic {
     public static final String NAME = "percentage";
+    public static final ObjectParser<PercentageScore, Void> PARSER = new ObjectParser<>(NAME, PercentageScore::new);
 
     public PercentageScore() {
     }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ScriptHeuristic.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ScriptHeuristic.java
index e90df2ed33a0b..3d1f331862031 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ScriptHeuristic.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/ScriptHeuristic.java
@@ -21,13 +21,11 @@
 package org.elasticsearch.search.aggregations.bucket.significant.heuristics;
 
 
-import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.QueryShardContext;
-import org.elasticsearch.index.query.QueryShardException;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.SignificantTermsHeuristicScoreScript;
 import org.elasticsearch.search.aggregations.InternalAggregation;
@@ -37,8 +35,15 @@
 import java.util.Map;
 import java.util.Objects;
 
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
 public class ScriptHeuristic extends SignificanceHeuristic {
     public static final String NAME = "script_heuristic";
+    public static final ConstructingObjectParser<ScriptHeuristic, Void> PARSER = new ConstructingObjectParser<>(NAME, args ->
+        new ScriptHeuristic((Script) args[0]));
+    static {
+        Script.declareScript(PARSER, constructorArg());
+    }
 
     private final Script script;
 
@@ -153,32 +158,6 @@ public boolean equals(Object obj) {
         return Objects.equals(script, other.script);
     }
 
-    public static SignificanceHeuristic parse(XContentParser parser)
-            throws IOException, QueryShardException {
-        String heuristicName = parser.currentName();
-        Script script = null;
-        XContentParser.Token token;
-        String currentFieldName = null;
-        while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
-            if (token.equals(XContentParser.Token.FIELD_NAME)) {
-                currentFieldName = parser.currentName();
-            } else {
-                if (Script.SCRIPT_PARSE_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    script = Script.parse(parser);
-                } else {
-                    throw new ElasticsearchParseException("failed to parse [{}] significance heuristic. unknown object [{}]",
-                            heuristicName, currentFieldName);
-                }
-            }
-        }
-
-        if (script == null) {
-            throw new ElasticsearchParseException("failed to parse [{}] significance heuristic. no script found in script_heuristic",
-                    heuristicName);
-        }
-        return new ScriptHeuristic(script);
-    }
-
     public final class LongAccessor extends Number {
         public long value;
         @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/SignificanceHeuristicParser.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/SignificanceHeuristicParser.java
deleted file mode 100644
index bab88555cbbf6..0000000000000
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/significant/heuristics/SignificanceHeuristicParser.java
+++ /dev/null
@@ -1,34 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-
-package org.elasticsearch.search.aggregations.bucket.significant.heuristics;
-
-import org.elasticsearch.common.ParsingException;
-import org.elasticsearch.common.xcontent.XContentParser;
-
-import java.io.IOException;
-
-/**
- * Parses {@link SignificanceHeuristic}s from an {@link XContentParser}.
- */
-@FunctionalInterface
-public interface SignificanceHeuristicParser {
-    SignificanceHeuristic parse(XContentParser parser) throws IOException, ParsingException;
-}
diff --git a/server/src/test/java/org/elasticsearch/search/SearchModuleTests.java b/server/src/test/java/org/elasticsearch/search/SearchModuleTests.java
index 5998982c95db3..95f1e0d4af26d 100644
--- a/server/src/test/java/org/elasticsearch/search/SearchModuleTests.java
+++ b/server/src/test/java/org/elasticsearch/search/SearchModuleTests.java
@@ -40,8 +40,6 @@
 import org.elasticsearch.search.aggregations.InternalAggregation;
 import org.elasticsearch.search.aggregations.InternalAggregation.ReduceContext;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.ChiSquare;
-import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
-import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristicParser;
 import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregationBuilder;
 import org.elasticsearch.search.aggregations.pipeline.AbstractPipelineAggregationBuilder;
 import org.elasticsearch.search.aggregations.pipeline.DerivativePipelineAggregationBuilder;
@@ -120,8 +118,8 @@ public List<ScoreFunctionSpec<?>> getScoreFunctions() {
 
         SearchPlugin registersDupeSignificanceHeuristic = new SearchPlugin() {
             @Override
-            public List<SearchExtensionSpec<SignificanceHeuristic, SignificanceHeuristicParser>> getSignificanceHeuristics() {
-                return singletonList(new SearchExtensionSpec<>(ChiSquare.NAME, ChiSquare::new, ChiSquare.PARSER));
+            public List<SignificanceHeuristicSpec<?>> getSignificanceHeuristics() {
+                return singletonList(new SignificanceHeuristicSpec<>(ChiSquare.NAME, ChiSquare::new, ChiSquare.PARSER));
             }
         };
         expectThrows(IllegalArgumentException.class, registryForPlugin(registersDupeSignificanceHeuristic));
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
index 80b67fe850d8d..9e4717cb61991 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
@@ -25,14 +25,13 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
-import org.elasticsearch.index.query.QueryShardException;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.plugins.SearchPlugin;
 import org.elasticsearch.script.MockScriptPlugin;
@@ -49,7 +48,6 @@
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.MutualInformation;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.ScriptHeuristic;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
-import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristicParser;
 import org.elasticsearch.search.aggregations.bucket.terms.StringTerms;
 import org.elasticsearch.search.aggregations.bucket.terms.Terms;
 import org.elasticsearch.test.ESIntegTestCase;
@@ -173,9 +171,8 @@ public void testPlugin() throws Exception {
 
     public static class CustomSignificanceHeuristicPlugin extends MockScriptPlugin implements SearchPlugin {
         @Override
-        public List<SearchExtensionSpec<SignificanceHeuristic, SignificanceHeuristicParser>> getSignificanceHeuristics() {
-            return singletonList(new SearchExtensionSpec<SignificanceHeuristic, SignificanceHeuristicParser>(SimpleHeuristic.NAME,
-                    SimpleHeuristic::new, (parser) -> SimpleHeuristic.parse(parser)));
+        public List<SignificanceHeuristicSpec<?>> getSignificanceHeuristics() {
+            return singletonList(new SignificanceHeuristicSpec<>(SimpleHeuristic.NAME, SimpleHeuristic::new, SimpleHeuristic.PARSER));
         }
 
         @Override
@@ -209,6 +206,7 @@ private static long longValue(Object value) {
 
     public static class SimpleHeuristic extends SignificanceHeuristic {
         public static final String NAME = "simple";
+        public static final ObjectParser<SimpleHeuristic, Void> PARSER = new ObjectParser<>(NAME, SimpleHeuristic::new);
 
         public SimpleHeuristic() {
         }
@@ -263,12 +261,6 @@ public boolean equals(Object obj) {
         public double getScore(long subsetFreq, long subsetSize, long supersetFreq, long supersetSize) {
             return subsetFreq / subsetSize > supersetFreq / supersetSize ? 2.0 : 1.0;
         }
-
-        public static SignificanceHeuristic parse(XContentParser parser)
-                throws IOException, QueryShardException {
-            parser.nextToken();
-            return new SimpleHeuristic();
-        }
     }
 
     public void testXContentResponse() throws Exception {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificanceHeuristicTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificanceHeuristicTests.java
index 6afc5e94e3029..510d06579205c 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificanceHeuristicTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/significant/SignificanceHeuristicTests.java
@@ -28,7 +28,7 @@
 import org.elasticsearch.common.io.stream.OutputStreamStreamOutput;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.ParseFieldRegistry;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentParseException;
@@ -46,7 +46,6 @@
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.MutualInformation;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.PercentageScore;
 import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
-import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristicParser;
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.TestSearchContext;
@@ -218,81 +217,62 @@ SignificantLongTerms.Bucket createBucket(long subsetDF, long subsetSize, long su
     // 1. The output of the builders can actually be parsed
     // 2. The parser does not swallow parameters after a significance heuristic was defined
     public void testBuilderAndParser() throws Exception {
-        SearchModule searchModule = new SearchModule(Settings.EMPTY, emptyList());
-        ParseFieldRegistry<SignificanceHeuristicParser> heuristicParserMapper = searchModule.getSignificanceHeuristicParserRegistry();
-
         // test jlh with string
-        assertTrue(parseFromString(heuristicParserMapper, "\"jlh\":{}") instanceof JLHScore);
+        assertTrue(parseFromString("\"jlh\":{}") instanceof JLHScore);
         // test gnd with string
-        assertTrue(parseFromString(heuristicParserMapper, "\"gnd\":{}") instanceof GND);
+        assertTrue(parseFromString("\"gnd\":{}") instanceof GND);
         // test mutual information with string
         boolean includeNegatives = randomBoolean();
         boolean backgroundIsSuperset = randomBoolean();
         String mutual = "\"mutual_information\":{\"include_negatives\": " + includeNegatives + ", \"background_is_superset\":"
                 + backgroundIsSuperset + "}";
         assertEquals(new MutualInformation(includeNegatives, backgroundIsSuperset),
-                parseFromString(heuristicParserMapper, mutual));
+                parseFromString(mutual));
         String chiSquare = "\"chi_square\":{\"include_negatives\": " + includeNegatives + ", \"background_is_superset\":"
                 + backgroundIsSuperset + "}";
         assertEquals(new ChiSquare(includeNegatives, backgroundIsSuperset),
-                parseFromString(heuristicParserMapper, chiSquare));
+                parseFromString(chiSquare));
 
         // test with builders
-        assertThat(parseFromBuilder(heuristicParserMapper, new JLHScore()), instanceOf(JLHScore.class));
-        assertThat(parseFromBuilder(heuristicParserMapper, new GND(backgroundIsSuperset)), instanceOf(GND.class));
+        assertThat(parseFromBuilder(new JLHScore()), instanceOf(JLHScore.class));
+        assertThat(parseFromBuilder(new GND(backgroundIsSuperset)), instanceOf(GND.class));
         assertEquals(new MutualInformation(includeNegatives, backgroundIsSuperset),
-                parseFromBuilder(heuristicParserMapper, new MutualInformation(includeNegatives, backgroundIsSuperset)));
+                parseFromBuilder(new MutualInformation(includeNegatives, backgroundIsSuperset)));
         assertEquals(new ChiSquare(includeNegatives, backgroundIsSuperset),
-                parseFromBuilder(heuristicParserMapper, new ChiSquare(includeNegatives, backgroundIsSuperset)));
+                parseFromBuilder(new ChiSquare(includeNegatives, backgroundIsSuperset)));
 
         // test exceptions
-        String faultyHeuristicdefinition = "\"mutual_information\":{\"include_negatives\": false, \"some_unknown_field\": false}";
-        String expectedError = "unknown field [some_unknown_field]";
-        checkParseException(heuristicParserMapper, faultyHeuristicdefinition, expectedError);
-
-        faultyHeuristicdefinition = "\"chi_square\":{\"unknown_field\": true}";
-        expectedError = "unknown field [unknown_field]";
-        checkParseException(heuristicParserMapper, faultyHeuristicdefinition, expectedError);
-
-        faultyHeuristicdefinition = "\"jlh\":{\"unknown_field\": true}";
-        expectedError = "expected an empty object, but found ";
-        checkParseException(heuristicParserMapper, faultyHeuristicdefinition, expectedError);
-
-        faultyHeuristicdefinition = "\"gnd\":{\"unknown_field\": true}";
-        expectedError = "unknown field [unknown_field]";
-        checkParseException(heuristicParserMapper, faultyHeuristicdefinition, expectedError);
+        String expectedError = "unknown field [unknown_field]";
+        checkParseException("\"mutual_information\":{\"include_negatives\": false, \"unknown_field\": false}", expectedError);
+        checkParseException("\"chi_square\":{\"unknown_field\": true}", expectedError);
+        checkParseException("\"jlh\":{\"unknown_field\": true}", expectedError);
+        checkParseException("\"gnd\":{\"unknown_field\": true}", expectedError);
     }
 
-    protected void checkParseException(ParseFieldRegistry<SignificanceHeuristicParser> significanceHeuristicParserRegistry,
-            String faultyHeuristicDefinition, String expectedError) throws IOException {
+    protected void checkParseException(String faultyHeuristicDefinition, String expectedError) throws IOException {
 
         try (XContentParser stParser = createParser(JsonXContent.jsonXContent,
                     "{\"field\":\"text\", " + faultyHeuristicDefinition + ",\"min_doc_count\":200}")) {
             stParser.nextToken();
-            SignificantTermsAggregationBuilder.getParser(significanceHeuristicParserRegistry).parse("testagg", stParser);
+            SignificantTermsAggregationBuilder.parse("testagg", stParser);
             fail();
         } catch (XContentParseException e) {
-            assertThat(e.getCause().getMessage(), containsString(expectedError));
+            assertThat(e.getMessage(), containsString(expectedError));
         }
     }
 
-    protected SignificanceHeuristic parseFromBuilder(ParseFieldRegistry<SignificanceHeuristicParser> significanceHeuristicParserRegistry,
-            SignificanceHeuristic significanceHeuristic) throws IOException {
+    protected SignificanceHeuristic parseFromBuilder(SignificanceHeuristic significanceHeuristic) throws IOException {
         SignificantTermsAggregationBuilder stBuilder = significantTerms("testagg");
         stBuilder.significanceHeuristic(significanceHeuristic).field("text").minDocCount(200);
         XContentBuilder stXContentBuilder = XContentFactory.jsonBuilder();
         stBuilder.internalXContent(stXContentBuilder, null);
         XContentParser stParser = createParser(JsonXContent.jsonXContent, Strings.toString(stXContentBuilder));
-        return parseSignificanceHeuristic(significanceHeuristicParserRegistry, stParser);
+        return parseSignificanceHeuristic(stParser);
     }
 
-    private static SignificanceHeuristic parseSignificanceHeuristic(
-            ParseFieldRegistry<SignificanceHeuristicParser> significanceHeuristicParserRegistry,
-            XContentParser stParser) throws IOException {
+    private static SignificanceHeuristic parseSignificanceHeuristic(XContentParser stParser) throws IOException {
         stParser.nextToken();
-        SignificantTermsAggregationBuilder aggregatorFactory =
-                (SignificantTermsAggregationBuilder) SignificantTermsAggregationBuilder.getParser(
-                significanceHeuristicParserRegistry).parse("testagg", stParser);
+        SignificantTermsAggregationBuilder aggregatorFactory = SignificantTermsAggregationBuilder.parse("testagg", stParser);
         stParser.nextToken();
         assertThat(aggregatorFactory.getBucketCountThresholds().getMinDocCount(), equalTo(200L));
         assertThat(stParser.currentToken(), equalTo(null));
@@ -300,11 +280,10 @@ private static SignificanceHeuristic parseSignificanceHeuristic(
         return aggregatorFactory.significanceHeuristic();
     }
 
-    protected SignificanceHeuristic parseFromString(ParseFieldRegistry<SignificanceHeuristicParser> significanceHeuristicParserRegistry,
-            String heuristicString) throws IOException {
+    protected SignificanceHeuristic parseFromString(String heuristicString) throws IOException {
         try (XContentParser stParser = createParser(JsonXContent.jsonXContent,
                 "{\"field\":\"text\", " + heuristicString + ", \"min_doc_count\":200}")) {
-            return parseSignificanceHeuristic(significanceHeuristicParserRegistry, stParser);
+            return parseSignificanceHeuristic(stParser);
         }
     }
 
@@ -494,4 +473,9 @@ public void testGNDCornerCases() throws Exception {
         gnd = new GND(false);
         assertThat(gnd.getScore(0, 0, 0, 0), equalTo(0.0));
     }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new SearchModule(Settings.EMPTY, emptyList()).getNamedXContents());
+    }
 }

From 16c25d72d67b0c0531a4e34a5045444dff442721 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Sun, 5 Jan 2020 19:08:11 -0500
Subject: [PATCH 392/686] Adjus bwc for #50502

Relates #50502
---
 .../rest-api-spec/test/indices.create/10_basic.yml        | 4 ++--
 .../rest-api-spec/test/indices.stats/20_translog.yml      | 8 ++++----
 .../java/org/elasticsearch/test/rest/ESRestTestCase.java  | 4 ++--
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
index 1dacfd6ad61c3..b5ce95c31a581 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
@@ -123,8 +123,8 @@
 ---
 "Create index without soft deletes":
   - skip:
-      version:  " - 7.9.99"
-      reason:   "indices without soft deletes are deprecated in 8.0"
+      version:  " - 7.5.99"
+      reason:   "indices without soft deletes are deprecated in 7.6"
       features: "warnings"
 
   - do:
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
index 8ba11bb280ce7..0cc21eda1bdcd 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
@@ -1,8 +1,8 @@
 ---
 "Translog retention without soft_deletes":
   - skip:
-      version:  " - 7.9.99"
-      reason:   "indices without soft deletes are deprecated in 8.0"
+      version:  " - 7.5.99"
+      reason:   "indices without soft deletes are deprecated in 7.6"
       features: "warnings"
 
   - do:
@@ -138,8 +138,8 @@
 ---
 "Translog stats on closed indices without soft-deletes":
   - skip:
-      version: " - 7.9.99"
-      reason:  "indices without soft deletes are deprecated in 8.0"
+      version: " - 7.5.99"
+      reason:  "indices without soft deletes are deprecated in 7.6"
       features: "warnings"
 
   - do:
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index 4344b54c38eda..b843ea7a3d2b5 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -1008,10 +1008,10 @@ protected static void expectSoftDeletesWarning(Request request, String indexName
         final List<String> expectedWarnings = List.of(
             "Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions. " +
             "Please do not specify value for setting [index.soft_deletes.enabled] of index [" + indexName + "].");
-        if (nodeVersions.stream().allMatch(version -> version.onOrAfter(Version.V_8_0_0))) {
+        if (nodeVersions.stream().allMatch(version -> version.onOrAfter(Version.V_7_6_0))) {
             request.setOptions(RequestOptions.DEFAULT.toBuilder()
                 .setWarningsHandler(warnings -> warnings.equals(expectedWarnings) == false));
-        } else if (nodeVersions.stream().anyMatch(version -> version.onOrAfter(Version.V_8_0_0))) {
+        } else if (nodeVersions.stream().anyMatch(version -> version.onOrAfter(Version.V_7_6_0))) {
             request.setOptions(RequestOptions.DEFAULT.toBuilder()
                 .setWarningsHandler(warnings -> warnings.isEmpty() == false && warnings.equals(expectedWarnings) == false));
         }

From f0c36c6f7371e2fde26cfa345aa1f93cec2b8c7e Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 6 Jan 2020 07:45:49 -0600
Subject: [PATCH 393/686] [DOCS] Warn about using `geo_centroid` as sub-agg to
 `geohash_grid` (#50038)

If `geo_point fields` are multi-valued, using `geo_centroid` as a
sub-agg to `geohash_grid` could result in centroids outside of bucket
boundaries.

This adds a related warning to the geo_centroid agg docs.
---
 .../metrics/geocentroid-aggregation.asciidoc       | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/reference/aggregations/metrics/geocentroid-aggregation.asciidoc b/docs/reference/aggregations/metrics/geocentroid-aggregation.asciidoc
index d26897c9de7e7..659dec496c87a 100644
--- a/docs/reference/aggregations/metrics/geocentroid-aggregation.asciidoc
+++ b/docs/reference/aggregations/metrics/geocentroid-aggregation.asciidoc
@@ -143,3 +143,17 @@ The response for the above aggregation:
 }
 --------------------------------------------------
 // TESTRESPONSE[s/\.\.\./"took": $body.took,"_shards": $body._shards,"hits":$body.hits,"timed_out":false,/]
+
+[WARNING]
+.Using `geo_centroid` as a sub-aggregation of `geohash_grid`
+====
+The <<search-aggregations-bucket-geohashgrid-aggregation,`geohash_grid`>>
+aggregation places documents, not individual geo-points, into buckets. If a
+document's `geo_point` field contains <<array,multiple values>>, the document
+could be assigned to multiple buckets, even if one or more of its geo-points are
+outside the bucket boundaries.
+    
+If a `geocentroid` sub-aggregation is also used, each centroid is calculated
+using all geo-points in a bucket, including those outside the bucket boundaries.
+This can result in centroids outside of bucket boundaries.
+====
\ No newline at end of file

From 8a4562488d51f0f390cb7ab2a79b1a6246015725 Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Mon, 6 Jan 2020 13:58:07 +0000
Subject: [PATCH 394/686] Mute
 HistogramPercentileAggregationTests.testTDigestHistogram

See https://github.com/elastic/elasticsearch/issues/50307
---
 .../analytics/mapper/HistogramPercentileAggregationTests.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramPercentileAggregationTests.java b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramPercentileAggregationTests.java
index 1c826449d4a3f..833334660ca65 100644
--- a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramPercentileAggregationTests.java
+++ b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/mapper/HistogramPercentileAggregationTests.java
@@ -132,6 +132,7 @@ public void testHDRHistogram() throws Exception {
         }
     }
 
+    @AwaitsFix( bugUrl = "https://github.com/elastic/elasticsearch/issues/50307")
     public void testTDigestHistogram() throws Exception {
 
         XContentBuilder xContentBuilder = XContentFactory.jsonBuilder()

From 8cce9781a70feaa3ab3ecc8f3ec4efe1acf7c0e6 Mon Sep 17 00:00:00 2001
From: David Turner <david.turner@elastic.co>
Date: Mon, 6 Jan 2020 14:12:51 +0000
Subject: [PATCH 395/686] Remove the 'local' parameter of /_cat/nodes (#50594)

The cat nodes API performs a `ClusterStateAction` then a `NodesInfoAction`.
Today it accepts the `?local` parameter and passes this to the
`ClusterStateAction` but this parameter has no effect on the `NodesInfoAction`.
This is surprising, because `GET _cat/nodes?local` looks like it might be a
completely local call but in fact it still depends on every node in the
cluster.

This parameter was deprecated in 7.x in #50499 and this commit removes it.

Relates #50088
---
 docs/reference/cat/nodes.asciidoc             | 12 ------------
 docs/reference/migration/migrate_8_0.asciidoc |  2 ++
 .../migration/migrate_8_0/api.asciidoc        | 19 +++++++++++++++++++
 .../rest-api-spec/api/cat.nodes.json          |  8 --------
 .../rest/action/cat/RestNodesAction.java      | 12 +++---------
 .../rest/action/cat/RestNodesActionTests.java | 12 ++++++------
 6 files changed, 30 insertions(+), 35 deletions(-)
 create mode 100644 docs/reference/migration/migrate_8_0/api.asciidoc

diff --git a/docs/reference/cat/nodes.asciidoc b/docs/reference/cat/nodes.asciidoc
index 506bc6f5c2721..a5aff2f8daf2d 100644
--- a/docs/reference/cat/nodes.asciidoc
+++ b/docs/reference/cat/nodes.asciidoc
@@ -285,18 +285,6 @@ Number of suggest operations, such as `0`.
 
 include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
 
-include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
-+
---
-`local`::
-(Optional, boolean) If `true`, the request computes the list of selected nodes
-from the local cluster state. Defaults to `false`, which means the list of
-selected nodes is computed from the cluster state on the master node. In either
-case the coordinating node sends a request for further information to each
-selected node. deprecated::[8.0,This parameter does not cause this API to act
-locally. It will be removed in version 8.0.]
---
-
 include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
 
 include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-s]
diff --git a/docs/reference/migration/migrate_8_0.asciidoc b/docs/reference/migration/migrate_8_0.asciidoc
index eff10899a2e03..9e4532b87ccbe 100644
--- a/docs/reference/migration/migrate_8_0.asciidoc
+++ b/docs/reference/migration/migrate_8_0.asciidoc
@@ -30,6 +30,7 @@ coming[8.0.0]
 * <<breaking_80_search_changes>>
 * <<breaking_80_settings_changes>>
 * <<breaking_80_indices_changes>>
+* <<breaking_80_api_changes>>
 
 //NOTE: The notable-breaking-changes tagged regions are re-used in the
 //Installation and Upgrade Guide
@@ -81,3 +82,4 @@ include::migrate_8_0/reindex.asciidoc[]
 include::migrate_8_0/search.asciidoc[]
 include::migrate_8_0/settings.asciidoc[]
 include::migrate_8_0/indices.asciidoc[]
+include::migrate_8_0/api.asciidoc[]
diff --git a/docs/reference/migration/migrate_8_0/api.asciidoc b/docs/reference/migration/migrate_8_0/api.asciidoc
new file mode 100644
index 0000000000000..f3293a85d5621
--- /dev/null
+++ b/docs/reference/migration/migrate_8_0/api.asciidoc
@@ -0,0 +1,19 @@
+[float]
+[[breaking_80_api_changes]]
+=== REST API changes
+
+//NOTE: The notable-breaking-changes tagged regions are re-used in the
+//Installation and Upgrade Guide
+//tag::notable-breaking-changes[]
+
+// end::notable-breaking-changes[]
+
+[float]
+==== Deprecated `?local` parameter removed from `GET _cat/nodes` API
+
+The `?local` parameter to the `GET _cat/nodes` API was deprecated in 7.x and is
+rejected in 8.0. This parameter caused the API to use the local cluster state
+to determine the nodes returned by the API rather than the cluster state from
+the master, but this API requests information from each selected node
+regardless of the `?local` parameter which means this API does not run in a
+fully node-local fashion.
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
index 753a6aab1d5f3..20de099e2e9cb 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
@@ -41,14 +41,6 @@
         "type":"boolean",
         "description":"Return the full node ID instead of the shortened version (default: false)"
       },
-      "local":{
-        "type":"boolean",
-        "description":"Calculate the selected nodes using the local cluster state rather than the state from master node (default: false)",
-        "deprecated":{
-          "version":"8.0.0",
-          "description":"This parameter does not cause this API to act locally."
-        }
-      },
       "master_timeout":{
         "type":"time",
         "description":"Explicit operation timeout for connection to master node"
diff --git a/server/src/main/java/org/elasticsearch/rest/action/cat/RestNodesAction.java b/server/src/main/java/org/elasticsearch/rest/action/cat/RestNodesAction.java
index 849fbdac49224..ac26c43385004 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/cat/RestNodesAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/cat/RestNodesAction.java
@@ -19,7 +19,7 @@
 
 package org.elasticsearch.rest.action.cat;
 
-import org.apache.logging.log4j.LogManager;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.admin.cluster.node.info.NodeInfo;
 import org.elasticsearch.action.admin.cluster.node.info.NodesInfoRequest;
 import org.elasticsearch.action.admin.cluster.node.info.NodesInfoResponse;
@@ -34,7 +34,6 @@
 import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.Table;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.network.NetworkAddress;
 import org.elasticsearch.common.transport.TransportAddress;
 import org.elasticsearch.common.unit.ByteSizeValue;
@@ -69,10 +68,6 @@
 import static org.elasticsearch.rest.RestRequest.Method.GET;
 
 public class RestNodesAction extends AbstractCatAction {
-    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(
-        LogManager.getLogger(RestNodesAction.class));
-    static final String LOCAL_DEPRECATED_MESSAGE = "Deprecated parameter [local] used. This parameter does not cause this API to act " +
-            "locally, and should not be used. It will be unsupported in version 8.0.";
 
     public RestNodesAction(RestController controller) {
         controller.registerHandler(GET, "/_cat/nodes", this);
@@ -92,10 +87,9 @@ protected void documentation(StringBuilder sb) {
     public RestChannelConsumer doCatRequest(final RestRequest request, final NodeClient client) {
         final ClusterStateRequest clusterStateRequest = new ClusterStateRequest();
         clusterStateRequest.clear().nodes(true);
-        if (request.hasParam("local")) {
-            deprecationLogger.deprecated(LOCAL_DEPRECATED_MESSAGE);
+        if (request.hasParam("local") && Version.CURRENT.major == Version.V_7_0_0.major + 1) { // only needed in v8 to catch breaking usages
+            throw new IllegalArgumentException("parameter [local] is not supported");
         }
-        clusterStateRequest.local(request.paramAsBoolean("local", clusterStateRequest.local()));
         clusterStateRequest.masterNodeTimeout(request.paramAsTime("master_timeout", clusterStateRequest.masterNodeTimeout()));
         final boolean fullId = request.paramAsBoolean("full_id", false);
         return channel -> client.admin().cluster().state(clusterStateRequest, new RestActionListener<ClusterStateResponse>(channel) {
diff --git a/server/src/test/java/org/elasticsearch/rest/action/cat/RestNodesActionTests.java b/server/src/test/java/org/elasticsearch/rest/action/cat/RestNodesActionTests.java
index 05b14d6b1cfc4..38c4837468362 100644
--- a/server/src/test/java/org/elasticsearch/rest/action/cat/RestNodesActionTests.java
+++ b/server/src/test/java/org/elasticsearch/rest/action/cat/RestNodesActionTests.java
@@ -40,6 +40,7 @@
 
 import static java.util.Collections.emptyMap;
 import static java.util.Collections.emptySet;
+import static org.hamcrest.Matchers.is;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
@@ -69,15 +70,14 @@ public void testBuildTableDoesNotThrowGivenNullNodeInfoAndStats() {
         action.buildTable(false, new FakeRestRequest(), clusterStateResponse, nodesInfoResponse, nodesStatsResponse);
     }
 
-    public void testCatNodesWithLocalDeprecationWarning() {
+    public void testCatNodesRejectsLocalParameter() {
+        assumeTrue("test is only needed in v8, can be removed in v9", Version.CURRENT.major == Version.V_7_0_0.major + 1);
         TestThreadPool threadPool = new TestThreadPool(RestNodesActionTests.class.getName());
         NodeClient client = new NodeClient(Settings.EMPTY, threadPool);
         FakeRestRequest request = new FakeRestRequest();
-        request.params().put("local", randomFrom("", "true", "false"));
-
-        action.doCatRequest(request, client);
-        assertWarnings(RestNodesAction.LOCAL_DEPRECATED_MESSAGE);
-
+        request.params().put("local", randomFrom("", "true", "false", randomAlphaOfLength(10)));
+        assertThat(expectThrows(IllegalArgumentException.class, () -> action.doCatRequest(request, client)).getMessage(),
+            is("parameter [local] is not supported"));
         terminate(threadPool);
     }
 }

From 71f68c26862878085e3c530b31960026e48d0005 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Mon, 6 Jan 2020 15:37:02 +0100
Subject: [PATCH 396/686] Fix ingest stats test bug. (#50653)

This test code fixes a serialization test bug:
https://gradle-enterprise.elastic.co/s/7x2ct6yywkw3o

Rarely stats for the same processor are generated and
the production code then sums up these stats. However
the test code wasn't summing up in that case,
which caused inconsistencies between the actual and expected results.

Closes #50507
---
 .../cluster/stats/ClusterStatsNodesTests.java | 20 ++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsNodesTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsNodesTests.java
index 8083d4558c972..9caf1f841478f 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsNodesTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsNodesTests.java
@@ -70,9 +70,23 @@ public void testNetworkTypesToXContent() throws Exception {
     public void testIngestStats() throws Exception {
         NodeStats nodeStats = randomValueOtherThanMany(n -> n.getIngestStats() == null, NodeStatsTests::createNodeStats);
         SortedMap<String, long[]> processorStats = new TreeMap<>();
-        nodeStats.getIngestStats().getProcessorStats().values().forEach(l -> l.forEach(s -> processorStats.put(s.getType(),
-            new long[] { s.getStats().getIngestCount(), s.getStats().getIngestFailedCount(),
-                s.getStats().getIngestCurrent(), s.getStats().getIngestTimeInMillis()})));
+        nodeStats.getIngestStats().getProcessorStats().values().forEach(stats -> {
+            stats.forEach(stat -> {
+                processorStats.compute(stat.getType(), (key, value) -> {
+                    if (value == null) {
+                        return new long[] { stat.getStats().getIngestCount(), stat.getStats().getIngestFailedCount(),
+                            stat.getStats().getIngestCurrent(), stat.getStats().getIngestTimeInMillis()};
+                    } else {
+                        value[0] += stat.getStats().getIngestCount();
+                        value[1] += stat.getStats().getIngestFailedCount();
+                        value[2] += stat.getStats().getIngestCurrent();
+                        value[3] += stat.getStats().getIngestTimeInMillis();
+                        return value;
+                    }
+                });
+            });
+        });
+
         ClusterStatsNodes.IngestStats stats = new ClusterStatsNodes.IngestStats(Collections.singletonList(nodeStats));
         assertThat(stats.pipelineCount, equalTo(nodeStats.getIngestStats().getProcessorStats().size()));
         String processorStatsString = "{";

From 9cd22c5fa793298466c23d6de1920b07ec5b1f53 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 6 Jan 2020 08:38:21 -0600
Subject: [PATCH 397/686] [DOCS] Remove unneeded redirects (#50510)

The docs/reference/redirects.asciidoc file stores a list of relocated or
deleted pages for the Elasticsearch Reference documentation.

This prunes several older redirects that are no longer needed.
---
 docs/reference/redirects.asciidoc | 223 ------------------------------
 1 file changed, 223 deletions(-)

diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 4c5e26bb2e799..063be6616c9ac 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -26,229 +26,6 @@ index that make warmers not necessary anymore.
 The types exists endpoint has been removed. See <<removal-of-types>> for
 more details.
 
-[role="exclude",id="xpack-api"]
-=== X-Pack APIs
-
-{es} {xpack} APIs are now documented in <<rest-apis, REST APIs>>.
-
-[role="exclude",id="ml-calendar-resource"]]
-=== Calendar resources
-
-See <<ml-get-calendar>> and
-{ml-docs}/ml-calendars.html[Calendars and scheduled events].
-
-[role="exclude",id="ml-filter-resource"]
-=== Filter resources
-
-See <<ml-get-filter>> and
-{ml-docs}/ml-rules.html[Machine learning custom rules].
-
-[role="exclude",id="ml-event-resource"]
-=== Scheduled event resources
-
-See <<ml-get-calendar-event>> and
-{ml-docs}/ml-calendars.html[Calendars and scheduled events].
-
-[role="exclude",id="index-apis"]
-=== Index APIs
-{es} index APIs are now documented in <<indices>>.
-
-[role="exclude",id="search-request-docvalue-fields"]
-=== Doc value fields parameter for request body search API
-See <<request-body-search-docvalue-fields>>.
-
-[role="exclude",id="search-request-explain"]
-=== Explain parameter for request body search API
-See <<request-body-search-explain>>.
-
-[role="exclude",id="search-request-collapse"]
-=== Collapse parameter for request body search API
-See <<request-body-search-collapse>>.
-
-[role="exclude",id="search-request-from-size"]
-=== From and size parameters for request body search API
-See <<request-body-search-from-size>>.
-
-[role="exclude",id="search-request-highlighting"]
-=== Highlight parameter for request body search API
-See <<request-body-search-highlighting>>.
-
-[role="exclude",id="search-request-index-boost"]
-=== Index boost parameter for request body search API
-See <<request-body-search-index-boost>>.
-
-[role="exclude",id="search-request-inner-hits"]
-=== Inner hits parameter for request body search API
-See <<request-body-search-inner-hits>>.
-
-[role="exclude",id="search-request-min-score"]
-=== Minimum score parameter for request body search API
-See <<request-body-search-min-score>>.
-
-[role="exclude",id="search-request-named-queries-and-filters"]
-=== Named query parameter for request body search API
-See <<request-body-search-queries-and-filters>>.
-
-[role="exclude",id="search-request-post-filter"]
-=== Post filter parameter for request body search API
-See <<request-body-search-post-filter>>.
-
-[role="exclude",id="search-request-preference"]
-=== Preference parameter for request body search API
-See <<request-body-search-preference>>.
-
-[role="exclude",id="search-request-query"]
-=== Query parameter for request body search API
-See <<request-body-search-query>>.
-
-[role="exclude",id="search-request-rescore"]
-=== Rescoring parameter for request body search API
-See <<request-body-search-rescore>>.
-
-[role="exclude",id="search-request-script-fields"]
-=== Script fields parameter for request body search API
-See <<request-body-search-script-fields>>.
-
-[role="exclude",id="search-request-scroll"]
-=== Scroll parameter for request body search API
-See <<request-body-search-scroll>>.
-
-[role="exclude",id="search-request-search-after"]
-=== Search after parameter for request body search API
-See <<request-body-search-search-after>>.
-
-[role="exclude",id="search-request-search-type"]
-=== Search type parameter for request body search API
-See <<request-body-search-search-type>>.
-
-[role="exclude",id="search-request-seq-no-primary-term"]
-=== Sequence numbers and primary terms parameter for request body search API
-See <<request-body-search-search-type>>.
-
-[role="exclude",id="search-request-sort"]
-=== Sort parameter for request body search API
-See <<request-body-search-sort>>.
-
-[role="exclude",id="search-request-source-filtering"]
-=== Source filtering parameter for request body search API
-See <<request-body-search-source-filtering>>.
-
-[role="exclude",id="search-request-stored-fields"]
-=== Stored fields parameter for request body search API
-See <<request-body-search-stored-fields>>.
-
-[role="exclude",id="search-request-track-total-hits"]
-=== Track total hits parameter for request body search API
-See <<request-body-search-track-total-hits>>.
-
-[role="exclude",id="search-request-version"]
-=== Version parameter for request body search API
-See <<request-body-search-version>>.
-
-[role="exclude",id="search-suggesters-term"]
-=== Term suggester
-See <<term-suggester>>.
-
-[role="exclude",id="search-suggesters-phrase"]
-=== Phrase suggester
-See <<phrase-suggester>>.
-
-[role="exclude",id="search-suggesters-completion"]
-=== Completion suggester
-See <<completion-suggester>>.
-
-[role="exclude",id="suggester-context"]
-=== Context suggester
-See <<context-suggester>>.
-
-[role="exclude",id="returning-suggesters-type"]
-=== Return suggester type
-See <<return-suggesters-type>>.
-
-[role="exclude",id="search-profile-queries"]
-=== Profiling queries
-See <<profiling-queries>>.
-
-[role="exclude",id="search-profile-aggregations"]
-=== Profiling aggregations
-See <<profiling-aggregations>>.
-
-[role="exclude",id="search-profile-considerations"]
-=== Profiling considerations
-See <<profiling-considerations>>.
-
-[role="exclude",id="_explain_analyze"]
-=== Explain analyze API
-See <<explain-analyze-api>>.
-
-[role="exclude",id="indices-synced-flush"]
-=== Synced flush API
-See <<indices-synced-flush-api>>.
-
-[role="exclude",id="_repositories"]
-=== Snapshot repositories
-See <<snapshots-repositories>>.
-
-[role="exclude",id="_snapshot"]
-=== Snapshot
-See <<snapshots-take-snapshot>>.
-
-[role="exclude",id="getting-started-explore"]
-=== Exploring your cluster
-See <<cat>>.
-
-[role="exclude",id="getting-started-cluster-health"]
-=== Cluster health
-See <<cat-health>>.
-
-[role="exclude", id="getting-started-list-indices"]
-=== List all indices
-See <<cat-indices>>.
-
-[role="exclude", id="getting-started-create-index"]
-=== Create an index
-See <<indices-create-index>>.
-
-[role="exclude", id="getting-started-query-document"]
-=== Index and query a document
-See <<getting-started-index>>.
-
-[role="exclude", id="getting-started-delete-index"]
-=== Delete an index
-See <<indices-delete-index>>.
-
-[role="exclude", id="getting-started-modify-data"]
-== Modifying your data
-See <<docs-update>>.
-
-[role="exclude", id="indexing-replacing-documents"]
-=== Indexing/replacing documents
-See <<docs-index_>>.
-
-[role="exclude", id="getting-started-explore-data"]
-=== Exploring your data
-See <<getting-started-search>>.
-
-[role="exclude", id="getting-started-search-API"]
-=== Search API
-See <<getting-started-search>>.
-
-[role="exclude", id="getting-started-conclusion"]
-=== Conclusion
-See <<getting-started-next-steps>>.
-
-[role="exclude",id="ccs-reduction"]
-=== {ccs-cap} reduction
-See <<ccs-works>>.
-
-[role="exclude",id="administer-elasticsearch"]
-=== Administering {es}
-See <<high-availability>>.
-
-[role="exclude",id="slm-api"]
-=== Snapshot lifecycle management API
-See <<snapshot-lifecycle-management-api>>.
-
 [role="exclude",id="delete-data-frame-transform"]
 ===  Delete {transforms} API
 

From 63881350a5f9b746e43e44409a5ba70b0c4985eb Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Mon, 6 Jan 2020 11:17:29 -0500
Subject: [PATCH 398/686] Fix testRecoverFromHardDeletesIndex (#50663)

We need to create a hard-deletes engine in the test with soft-deletes
disabled; otherwise, we the min_retained_seqno will be calculated
incorrectly.

Closes #50654
---
 .../elasticsearch/index/engine/InternalEngineTests.java   | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
index c71730b6494f9..2d5dc675f025b 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
@@ -5476,10 +5476,14 @@ public long softUpdateDocuments(Term term, Iterable<? extends Iterable<? extends
         final AtomicLong globalCheckpoint = new AtomicLong(SequenceNumbers.NO_OPS_PERFORMED);
         Path translogPath = createTempDir();
         List<Engine.Operation> operations = generateHistoryOnReplica(between(1, 500), randomBoolean(), randomBoolean(), randomBoolean());
+        final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData())
+            .settings(Settings.builder().put(defaultSettings.getSettings()).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false))
+            .build();
+        final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
         try (Store store = createStore()) {
-            EngineConfig config = config(defaultSettings, store, translogPath, NoMergePolicy.INSTANCE, null, null, globalCheckpoint::get);
+            EngineConfig config = config(indexSettings, store, translogPath, NoMergePolicy.INSTANCE, null, null, globalCheckpoint::get);
             final List<DocIdSeqNoAndSource> docs;
-            try (InternalEngine hardDeletesEngine = createEngine(defaultSettings, store, translogPath, newMergePolicy(),
+            try (InternalEngine hardDeletesEngine = createEngine(indexSettings, store, translogPath, newMergePolicy(),
                 hardDeletesWriter, null, globalCheckpoint::get)) {
                 for (Engine.Operation op : operations) {
                     applyOperation(hardDeletesEngine, op);

From 62d0307db1eb9c51536281d62b6334d1e950dda9 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 6 Jan 2020 17:52:20 +0100
Subject: [PATCH 399/686] Fix GCS Mock Broken Handling of some Blobs (#50666)

* Fix GCS Mock Broken Handling of some Blobs

We were incorrectly handling blobs starting in `\r\n` which broke
tests randomly when blobs started on these.

Relates #49429
---
 .../java/fixture/gcs/GoogleCloudStorageHttpHandler.java     | 4 +++-
 .../blobstore/ESBlobStoreRepositoryIntegTestCase.java       | 6 +++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
index 1b4c6b4caacb9..75cb9a9abe2c7 100644
--- a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
+++ b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
@@ -271,6 +271,7 @@ public byte[] toByteArray() {
                     return buf;
                 }
             };
+            boolean skippedEmptyLine = false;
             while ((read = in.read()) != -1) {
                 out.reset();
                 boolean markAndContinue = false;
@@ -290,7 +291,7 @@ public byte[] toByteArray() {
                 } while ((read = in.read()) != -1);
                 final String bucketPrefix = "{\"bucket\":";
                 final String start = new String(out.toByteArray(), 0, Math.min(out.size(), bucketPrefix.length()), UTF_8);
-                if (start.length() == 0 || start.equals("\r\n") || start.startsWith("--")
+                if ((skippedEmptyLine == false && start.length() == 0) || start.startsWith("--")
                     || start.toLowerCase(Locale.ROOT).startsWith("content")) {
                     markAndContinue = true;
                 } else if (start.startsWith(bucketPrefix)) {
@@ -302,6 +303,7 @@ public byte[] toByteArray() {
                     }
                 }
                 if (markAndContinue) {
+                    skippedEmptyLine = start.length() == 0;
                     in.mark(Integer.MAX_VALUE);
                     continue;
                 }
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
index 62af8e26da073..6ae627972b62c 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESBlobStoreRepositoryIntegTestCase.java
@@ -132,7 +132,11 @@ public void testWriteRead() throws IOException {
                     byte[] buffer = new byte[scaledRandomIntBetween(1, data.length - target.length())];
                     int offset = scaledRandomIntBetween(0, buffer.length - 1);
                     int read = stream.read(buffer, offset, buffer.length - offset);
-                    target.append(new BytesRef(buffer, offset, read));
+                    if (read >= 0) {
+                        target.append(new BytesRef(buffer, offset, read));
+                    } else {
+                        fail("Expected [" + (data.length - target.length()) + "] more bytes to be readable but reached EOF");
+                    }
                 }
                 assertEquals(data.length, target.length());
                 assertArrayEquals(data, Arrays.copyOfRange(target.bytes(), 0, target.length()));

From b1db9f4cb4c4f621371473997aeff20c8dcff48b Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Mon, 6 Jan 2020 09:58:24 -0700
Subject: [PATCH 400/686] Add aditional logging for ILM history store tests
 (#50624)

These tests use the same index name, making it hard to read logs when
diagnosing the failures. Additionally more information about the current
state of the index could be retrieved when failing.

This changes these two things in the hope of capturing more data about
why this fails on some CI nodes but not others.

Relates to #50353

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
---
 .../ilm/TimeSeriesLifecycleActionsIT.java     | 42 +++++++++++++++----
 1 file changed, 34 insertions(+), 8 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 16ef7a9639542..47992798cde8e 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1085,9 +1085,8 @@ public void testRolloverStepRetriesUntilRolledOverIndexIsDeleted() throws Except
         assertBusy(() -> assertThat(getStepKeyForIndex(index), equalTo(TerminalPolicyStep.KEY)));
     }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithSuccess() throws Exception {
-        String index = "index";
+        String index = "success-index";
 
         createNewSingletonPolicy("hot", new RolloverAction(null, null, 1L));
         Request createIndexTemplate = new Request("PUT", "_template/rolling_indexes");
@@ -1129,9 +1128,8 @@ public void testHistoryIsWrittenWithSuccess() throws Exception {
     }
 
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithFailure() throws Exception {
-        String index = "index";
+        String index = "failure-index";
 
         createNewSingletonPolicy("hot", new RolloverAction(null, null, 1L));
         Request createIndexTemplate = new Request("PUT", "_template/rolling_indexes");
@@ -1158,9 +1156,8 @@ public void testHistoryIsWrittenWithFailure() throws Exception {
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", false, "ERROR"), 30, TimeUnit.SECONDS);
     }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithDeletion() throws Exception {
-        String index = "index";
+        String index = "delete-index";
 
         createNewSingletonPolicy("delete", new DeleteAction());
         Request createIndexTemplate = new Request("PUT", "_template/delete_indexes");
@@ -1239,8 +1236,37 @@ private void assertHistoryIsPresent(String policyName, String indexName, boolean
                 historyResponseMap = XContentHelper.convertToMap(XContentType.JSON.xContent(), is, true);
             }
             logger.info("--> history response: {}", historyResponseMap);
-            assertThat((int)((Map<String, Object>) ((Map<String, Object>) historyResponseMap.get("hits")).get("total")).get("value"),
-                greaterThanOrEqualTo(1));
+            int hits = (int)((Map<String, Object>) ((Map<String, Object>) historyResponseMap.get("hits")).get("total")).get("value");
+
+            // For a failure, print out whatever history we *do* have for the index
+            if (hits == 0) {
+                final Request allResults = new Request("GET", "ilm-history*/_search");
+                allResults.setJsonEntity("{\n" +
+                    "  \"query\": {\n" +
+                    "    \"bool\": {\n" +
+                    "      \"must\": [\n" +
+                    "        {\n" +
+                    "          \"term\": {\n" +
+                    "            \"policy\": \"" + policyName + "\"\n" +
+                    "          }\n" +
+                    "        },\n" +
+                    "        {\n" +
+                    "          \"term\": {\n" +
+                    "            \"index\": \"" + indexName + "\"\n" +
+                    "          }\n" +
+                    "        }\n" +
+                    "      ]\n" +
+                    "    }\n" +
+                    "  }\n" +
+                    "}");
+                final Response allResultsResp = client().performRequest(historySearchRequest);
+                Map<String, Object> allResultsMap;
+                try (InputStream is = allResultsResp.getEntity().getContent()) {
+                    allResultsMap = XContentHelper.convertToMap(XContentType.JSON.xContent(), is, true);
+                }
+                logger.info("--> expected at least 1 hit, got 0. All history for index [{}]: {}", index, allResultsMap);
+            }
+            assertThat(hits, greaterThanOrEqualTo(1));
         } catch (ResponseException e) {
             // Throw AssertionError instead of an exception if the search fails so that assertBusy works as expected
             logger.error(e);

From e951a8135ac609fbee0c06a515b9849116a64a11 Mon Sep 17 00:00:00 2001
From: Jay Modi <jaymode@users.noreply.github.com>
Date: Mon, 6 Jan 2020 10:02:36 -0700
Subject: [PATCH 401/686] Remove unused IndicesOptions#fromByte method (#50665)

This change removes a no longer used method, `fromByte`, in
IndicesOptions. This method was necessary for backwards compatibility
with versions prior to 6.4.0 and was used when talking to those
versions. However, the minimum wire compatibility version has changed
and we no longer use this code.
---
 .../action/support/IndicesOptions.java        | 36 -------------------
 .../action/support/IndicesOptionsTests.java   | 25 -------------
 2 files changed, 61 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java b/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
index 25e7a25335d66..e830ed8795608 100644
--- a/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
+++ b/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
@@ -118,42 +118,6 @@ private IndicesOptions(Collection<Option> options, Collection<WildcardStates> ex
             expandWildcards.isEmpty() ? WildcardStates.NONE : EnumSet.copyOf(expandWildcards));
     }
 
-    // Package visible for testing
-    static IndicesOptions fromByte(final byte id) {
-        // IGNORE_UNAVAILABLE = 1;
-        // ALLOW_NO_INDICES = 2;
-        // EXPAND_WILDCARDS_OPEN = 4;
-        // EXPAND_WILDCARDS_CLOSED = 8;
-        // FORBID_ALIASES_TO_MULTIPLE_INDICES = 16;
-        // FORBID_CLOSED_INDICES = 32;
-        // IGNORE_ALIASES = 64;
-
-        Set<Option> opts = new HashSet<>();
-        Set<WildcardStates> wildcards = new HashSet<>();
-        if ((id & 1) != 0) {
-            opts.add(Option.IGNORE_UNAVAILABLE);
-        }
-        if ((id & 2) != 0) {
-            opts.add(Option.ALLOW_NO_INDICES);
-        }
-        if ((id & 4) != 0) {
-            wildcards.add(WildcardStates.OPEN);
-        }
-        if ((id & 8) != 0) {
-            wildcards.add(WildcardStates.CLOSED);
-        }
-        if ((id & 16) != 0) {
-            opts.add(Option.FORBID_ALIASES_TO_MULTIPLE_INDICES);
-        }
-        if ((id & 32) != 0) {
-            opts.add(Option.FORBID_CLOSED_INDICES);
-        }
-        if ((id & 64) != 0) {
-            opts.add(Option.IGNORE_ALIASES);
-        }
-        return new IndicesOptions(opts, wildcards);
-    }
-
     /**
      * @return Whether specified concrete indices should be ignored when unavailable (missing or closed)
      */
diff --git a/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java b/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
index 10edb0b30d6cc..f28873e155102 100644
--- a/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
@@ -160,31 +160,6 @@ public void testFromParameters() {
         assertEquals(defaultOptions.ignoreAliases(), updatedOptions.ignoreAliases());
     }
 
-    public void testSimpleByteBWC() {
-        Map<Byte, IndicesOptions> old = new HashMap<>();
-        // These correspond to each individual option (bit) in the old byte-based IndicesOptions
-        old.put((byte) 0, IndicesOptions.fromOptions(false, false, false, false, true, false, false, false));
-        old.put((byte) 1, IndicesOptions.fromOptions(true, false, false, false, true, false, false, false));
-        old.put((byte) 2, IndicesOptions.fromOptions(false, true, false, false, true, false, false, false));
-        old.put((byte) 4, IndicesOptions.fromOptions(false, false, true, false, true, false, false, false));
-        old.put((byte) 8, IndicesOptions.fromOptions(false, false, false, true, true, false, false, false));
-        old.put((byte) 16, IndicesOptions.fromOptions(false, false, false, false, false, false, false, false));
-        old.put((byte) 32, IndicesOptions.fromOptions(false, false, false, false, true, true, false, false));
-        old.put((byte) 64, IndicesOptions.fromOptions(false, false, false, false, true, false, true, false));
-        // Test a few multi-selected options
-        old.put((byte) 13, IndicesOptions.fromOptions(true, false, true, true, true, false, false, false));
-        old.put((byte) 19, IndicesOptions.fromOptions(true, true, false, false, false, false, false, false));
-        old.put((byte) 24, IndicesOptions.fromOptions(false, false, false, true, false, false, false, false));
-        old.put((byte) 123, IndicesOptions.fromOptions(true, true, false, true, false, true, true, false));
-
-        for (Map.Entry<Byte, IndicesOptions> entry : old.entrySet()) {
-            IndicesOptions indicesOptions2 = IndicesOptions.fromByte(entry.getKey());
-            logger.info("--> 1 {}", entry.getValue().toString());
-            logger.info("--> 2 {}", indicesOptions2.toString());
-            assertThat("IndicesOptions for byte " + entry.getKey() + " differ for conversion",indicesOptions2, equalTo(entry.getValue()));
-        }
-    }
-
     public void testEqualityAndHashCode() {
         IndicesOptions indicesOptions = IndicesOptions.fromOptions(
             randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(),

From d3bfcdf666c992c3450de0791c105747cd9b8d69 Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Mon, 6 Jan 2020 11:12:00 -0600
Subject: [PATCH 402/686] Remove races in ProxyConnectionStrategyTests (#50620)

Currently, we use delayed address resolution in the proxy strategy tests
to allow tests to connect to different addresses. Unfortunately, this
has the potential to introduce races as the address is resolved each
connection attempt. The number of connection attempts can vary based on
when connections are opening and closing. This commit modifies the test
be allowing them to specifically control which address is used.

Related to #50618
---
 .../ProxyConnectionStrategyTests.java         | 21 ++++++++++---------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
index 1106067055353..0aa2c88142945 100644
--- a/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
@@ -122,9 +122,11 @@ public void testProxyStrategyWillOpenNewConnectionsOnDisconnect() throws Excepti
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
 
+                AtomicBoolean useAddress1 = new AtomicBoolean(true);
+
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, address1.toString(), alternatingResolver(address1, address2), false)) {
+                         numOfConnections, address1.toString(), alternatingResolver(address1, address2, useAddress1), false)) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
 
@@ -139,6 +141,7 @@ public void testProxyStrategyWillOpenNewConnectionsOnDisconnect() throws Excepti
                     assertEquals(0, initialConnectionsToTransport2);
                     assertEquals(numOfConnections, connectionManager.size());
                     assertTrue(strategy.assertNoRunningConnections());
+                    useAddress1.set(false);
 
                     transport1.close();
 
@@ -199,10 +202,11 @@ public void testClusterNameValidationPreventConnectingToDifferentClusters() thro
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
 
-                Supplier<TransportAddress> resolver = alternatingResolver(address1, address2);
+                AtomicBoolean useAddress1 = new AtomicBoolean(true);
+
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, address1.toString(), resolver, false)) {
+                         numOfConnections, address1.toString(), alternatingResolver(address1, address2, useAddress1), false)) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
 
@@ -212,6 +216,7 @@ public void testClusterNameValidationPreventConnectingToDifferentClusters() thro
 
                     assertTrue(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
+                    useAddress1.set(false);
 
                     transport1.close();
 
@@ -375,16 +380,12 @@ public void testServerNameAttributes() {
         }
     }
 
-    private Supplier<TransportAddress> alternatingResolver(TransportAddress address1, TransportAddress address2) {
-        // On the first connection round, the connections will be routed to transport1. On the second
-        //connection round, the connections will be routed to transport2
-        AtomicBoolean transportSwitch = new AtomicBoolean(true);
+    private Supplier<TransportAddress> alternatingResolver(TransportAddress address1, TransportAddress address2,
+                                                           AtomicBoolean useAddress1) {
         return () -> {
-            if (transportSwitch.get()) {
-                transportSwitch.set(false);
+            if (useAddress1.get()) {
                 return address1;
             } else {
-                transportSwitch.set(true);
                 return address2;
             }
         };

From bae11588512059bf6bdabc8dc84d50e0e1010cfb Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Mon, 6 Jan 2020 11:22:23 -0600
Subject: [PATCH 403/686] [DOCS] Remove unused docinfo.xml files (#50661)

This change is no-op.

The `index-docinfo.xml` and `index.x-docinfo.xml` were replaced by the
`index-extra-title-page.html` file in #50189.

Now that our documentation is built using direct HTML rather than
docbook, these XML files are no longer used.
---
 docs/reference/index-docinfo.xml   | 13 -------------
 docs/reference/index.x-docinfo.xml | 13 -------------
 2 files changed, 26 deletions(-)
 delete mode 100644 docs/reference/index-docinfo.xml
 delete mode 100644 docs/reference/index.x-docinfo.xml

diff --git a/docs/reference/index-docinfo.xml b/docs/reference/index-docinfo.xml
deleted file mode 100644
index e681b78c45596..0000000000000
--- a/docs/reference/index-docinfo.xml
+++ /dev/null
@@ -1,13 +0,0 @@
-<legalnotice>
-    <simpara>
-      Welcome to the official documentation for Elasticsearch:
-      the search and analytics engine that powers the Elastic Stack.
-      If you want to learn how to use Elasticsearch to search and analyze your
-      data, you've come to the right place. This guide shows you how to:
-    </simpara>
-    <itemizedlist>
-      <listitem><simpara>Install, configure, and administer an Elasticsearch cluster.</simpara></listitem>
-      <listitem><simpara>Index your data, optimize your indices, and search with the Elasticsearch query language.</simpara></listitem>
-      <listitem><simpara>Discover trends, patterns, and anomalies with aggregations and the machine learning APIs.</simpara></listitem>
-    </itemizedlist>
-</legalnotice>
diff --git a/docs/reference/index.x-docinfo.xml b/docs/reference/index.x-docinfo.xml
deleted file mode 100644
index e681b78c45596..0000000000000
--- a/docs/reference/index.x-docinfo.xml
+++ /dev/null
@@ -1,13 +0,0 @@
-<legalnotice>
-    <simpara>
-      Welcome to the official documentation for Elasticsearch:
-      the search and analytics engine that powers the Elastic Stack.
-      If you want to learn how to use Elasticsearch to search and analyze your
-      data, you've come to the right place. This guide shows you how to:
-    </simpara>
-    <itemizedlist>
-      <listitem><simpara>Install, configure, and administer an Elasticsearch cluster.</simpara></listitem>
-      <listitem><simpara>Index your data, optimize your indices, and search with the Elasticsearch query language.</simpara></listitem>
-      <listitem><simpara>Discover trends, patterns, and anomalies with aggregations and the machine learning APIs.</simpara></listitem>
-    </itemizedlist>
-</legalnotice>

From bd4b0d834fccb39c15076936d24850c87596e487 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Mon, 6 Jan 2020 12:42:29 -0500
Subject: [PATCH 404/686] [ML][Inference] lang_ident model (#50292)

This PR contains a java port of Google's CLD3 compact NN model https://github.com/google/cld3

The ported model is formatted to fit within our inference model formatting and stored as a resource in the `:xpack:ml:` plugin and is under basic license.

The model is broken up into two major parts:
- Preprocessing through the custom embedding (based on CLD3's embedding layer)
- Pushing the embedded text through the two layers of fully connected shallow NN.

Main differences between this port and CLD3:
- We take advantage of Java's internal Unicode handling where possible (i.e. codepoints, characters, decoders, etc.)
- We do not trim down input text by removing duplicated tokens
- We do not encode doubles/floats as longs/integers.
---
 .../xpack/core/XPackClientPlugin.java         |   6 +
 .../MlInferenceNamedXContentProvider.java     |  17 +
 .../core/ml/inference/TrainedModelConfig.java |   4 +
 .../preprocessing/CustomWordEmbedding.java    | 300 ++++++++++
 .../ContinuousFeatureValue.java               |  30 +
 .../DiscreteFeatureValue.java                 |  22 +
 .../customwordembedding/FeatureExtractor.java |  12 +
 .../customwordembedding/FeatureUtils.java     |  76 +++
 .../customwordembedding/FeatureValue.java     |  19 +
 .../customwordembedding/Hash32.java           |  89 +++
 .../NGramFeatureExtractor.java                |  92 +++
 .../RelevantScriptFeatureExtractor.java       |  60 ++
 .../customwordembedding/ScriptCode.java       | 339 +++++++++++
 .../customwordembedding/ScriptDetector.java   | 107 ++++
 .../ScriptFeatureExtractor.java               |  65 +++
 .../langident/LangIdentNeuralNetwork.java     | 227 ++++++++
 .../trainedmodel/langident/LangNetLayer.java  | 175 ++++++
 .../CustomWordEmbeddingTests.java             |  51 ++
 .../FeatureUtilsTests.java                    |  73 +++
 .../customwordembedding/Hash32Tests.java      |  66 +++
 .../NGramFeatureExtractorTests.java           | 294 ++++++++++
 .../RelevantScriptFeatureExtractorTests.java  |  99 ++++
 .../ScriptDetectorTests.java                  | 103 ++++
 .../ScriptFeatureExtractorTests.java          |  51 ++
 .../LangIdentNeuralNetworkTests.java          |  66 +++
 .../langident/LangNetLayerTests.java          |  56 ++
 .../langident/LanguageExamples.java           | 123 ++++
 .../core/ml/inference/language_examples.json  | 542 ++++++++++++++++++
 .../core/ml/inference/ngram_examples.json     |   1 +
 .../persistence/lang_ident_model_1.json       |  20 +
 .../LangIdentNeuralNetworkInferenceTests.java |  73 +++
 31 files changed, 3258 insertions(+)
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/CustomWordEmbedding.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ContinuousFeatureValue.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/DiscreteFeatureValue.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureExtractor.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureUtils.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureValue.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/Hash32.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/NGramFeatureExtractor.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/RelevantScriptFeatureExtractor.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptCode.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptDetector.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptFeatureExtractor.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangNetLayer.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/CustomWordEmbeddingTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureUtilsTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/Hash32Tests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/NGramFeatureExtractorTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/RelevantScriptFeatureExtractorTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptDetectorTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptFeatureExtractorTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetworkTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangNetLayerTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LanguageExamples.java
 create mode 100644 x-pack/plugin/core/src/test/resources/org/elasticsearch/xpack/core/ml/inference/language_examples.json
 create mode 100644 x-pack/plugin/core/src/test/resources/org/elasticsearch/xpack/core/ml/inference/ngram_examples.json
 create mode 100644 x-pack/plugin/ml/src/main/resources/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json
 create mode 100644 x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/trainedmodels/langident/LangIdentNeuralNetworkInferenceTests.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
index 06bc4182cabfd..efdb5e31118ae 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
@@ -135,6 +135,7 @@
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.OutlierDetection;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.inference.preprocessing.CustomWordEmbedding;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.FrequencyEncoding;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.OneHotEncoding;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.PreProcessor;
@@ -151,6 +152,7 @@
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ensemble.OutputAggregator;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ensemble.WeightedMode;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ensemble.WeightedSum;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident.LangIdentNeuralNetwork;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.tree.Tree;
 import org.elasticsearch.xpack.core.ml.job.config.JobTaskState;
 import org.elasticsearch.xpack.core.monitoring.MonitoringFeatureSetUsage;
@@ -454,9 +456,13 @@ public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
                 new NamedWriteableRegistry.Entry(PreProcessor.class, FrequencyEncoding.NAME.getPreferredName(), FrequencyEncoding::new),
                 new NamedWriteableRegistry.Entry(PreProcessor.class, OneHotEncoding.NAME.getPreferredName(), OneHotEncoding::new),
                 new NamedWriteableRegistry.Entry(PreProcessor.class, TargetMeanEncoding.NAME.getPreferredName(), TargetMeanEncoding::new),
+                new NamedWriteableRegistry.Entry(PreProcessor.class, CustomWordEmbedding.NAME.getPreferredName(), CustomWordEmbedding::new),
                 // ML - Inference models
                 new NamedWriteableRegistry.Entry(TrainedModel.class, Tree.NAME.getPreferredName(), Tree::new),
                 new NamedWriteableRegistry.Entry(TrainedModel.class, Ensemble.NAME.getPreferredName(), Ensemble::new),
+                new NamedWriteableRegistry.Entry(TrainedModel.class,
+                    LangIdentNeuralNetwork.NAME.getPreferredName(),
+                    LangIdentNeuralNetwork::new),
                 // ML - Inference aggregators
                 new NamedWriteableRegistry.Entry(OutputAggregator.class, WeightedSum.NAME.getPreferredName(), WeightedSum::new),
                 new NamedWriteableRegistry.Entry(OutputAggregator.class, WeightedMode.NAME.getPreferredName(), WeightedMode::new),
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/MlInferenceNamedXContentProvider.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/MlInferenceNamedXContentProvider.java
index ca380dac2bf00..029a97e0351c8 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/MlInferenceNamedXContentProvider.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/MlInferenceNamedXContentProvider.java
@@ -8,6 +8,7 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.plugins.spi.NamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.inference.preprocessing.CustomWordEmbedding;
 import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.results.RegressionInferenceResults;
@@ -24,6 +25,7 @@
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ensemble.StrictlyParsedOutputAggregator;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ensemble.WeightedMode;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ensemble.WeightedSum;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident.LangIdentNeuralNetwork;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.tree.Tree;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.FrequencyEncoding;
 import org.elasticsearch.xpack.core.ml.inference.preprocessing.LenientlyParsedPreProcessor;
@@ -48,6 +50,8 @@ public List<NamedXContentRegistry.Entry> getNamedXContentParsers() {
             TargetMeanEncoding::fromXContentLenient));
         namedXContent.add(new NamedXContentRegistry.Entry(LenientlyParsedPreProcessor.class, FrequencyEncoding.NAME,
             FrequencyEncoding::fromXContentLenient));
+        namedXContent.add(new NamedXContentRegistry.Entry(LenientlyParsedPreProcessor.class, CustomWordEmbedding.NAME,
+            CustomWordEmbedding::fromXContentLenient));
 
         // PreProcessing Strict
         namedXContent.add(new NamedXContentRegistry.Entry(StrictlyParsedPreProcessor.class, OneHotEncoding.NAME,
@@ -56,10 +60,15 @@ public List<NamedXContentRegistry.Entry> getNamedXContentParsers() {
             TargetMeanEncoding::fromXContentStrict));
         namedXContent.add(new NamedXContentRegistry.Entry(StrictlyParsedPreProcessor.class, FrequencyEncoding.NAME,
             FrequencyEncoding::fromXContentStrict));
+        namedXContent.add(new NamedXContentRegistry.Entry(StrictlyParsedPreProcessor.class, CustomWordEmbedding.NAME,
+            CustomWordEmbedding::fromXContentStrict));
 
         // Model Lenient
         namedXContent.add(new NamedXContentRegistry.Entry(LenientlyParsedTrainedModel.class, Tree.NAME, Tree::fromXContentLenient));
         namedXContent.add(new NamedXContentRegistry.Entry(LenientlyParsedTrainedModel.class, Ensemble.NAME, Ensemble::fromXContentLenient));
+        namedXContent.add(new NamedXContentRegistry.Entry(LenientlyParsedTrainedModel.class,
+            LangIdentNeuralNetwork.NAME,
+            LangIdentNeuralNetwork::fromXContentLenient));
 
         // Output Aggregator Lenient
         namedXContent.add(new NamedXContentRegistry.Entry(LenientlyParsedOutputAggregator.class,
@@ -75,6 +84,9 @@ public List<NamedXContentRegistry.Entry> getNamedXContentParsers() {
         // Model Strict
         namedXContent.add(new NamedXContentRegistry.Entry(StrictlyParsedTrainedModel.class, Tree.NAME, Tree::fromXContentStrict));
         namedXContent.add(new NamedXContentRegistry.Entry(StrictlyParsedTrainedModel.class, Ensemble.NAME, Ensemble::fromXContentStrict));
+        namedXContent.add(new NamedXContentRegistry.Entry(StrictlyParsedTrainedModel.class,
+            LangIdentNeuralNetwork.NAME,
+            LangIdentNeuralNetwork::fromXContentStrict));
 
         // Output Aggregator Strict
         namedXContent.add(new NamedXContentRegistry.Entry(StrictlyParsedOutputAggregator.class,
@@ -100,10 +112,15 @@ public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
             TargetMeanEncoding::new));
         namedWriteables.add(new NamedWriteableRegistry.Entry(PreProcessor.class, FrequencyEncoding.NAME.getPreferredName(),
             FrequencyEncoding::new));
+        namedWriteables.add(new NamedWriteableRegistry.Entry(PreProcessor.class, CustomWordEmbedding.NAME.getPreferredName(),
+            CustomWordEmbedding::new));
 
         // Model
         namedWriteables.add(new NamedWriteableRegistry.Entry(TrainedModel.class, Tree.NAME.getPreferredName(), Tree::new));
         namedWriteables.add(new NamedWriteableRegistry.Entry(TrainedModel.class, Ensemble.NAME.getPreferredName(), Ensemble::new));
+        namedWriteables.add(new NamedWriteableRegistry.Entry(LangIdentNeuralNetwork.class,
+            LangIdentNeuralNetwork.NAME.getPreferredName(),
+            LangIdentNeuralNetwork::new));
 
         // Output Aggregator
         namedWriteables.add(new NamedWriteableRegistry.Entry(OutputAggregator.class,
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
index 343a520d9b5d3..d0056dce73467 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
@@ -192,6 +192,10 @@ public String getCompressedDefinition() throws IOException {
         return definition.getCompressedString();
     }
 
+    public void clearCompressed() {
+        definition.compressedString = null;
+    }
+
     public TrainedModelConfig ensureParsedDefinition(NamedXContentRegistry xContentRegistry) throws IOException {
         if (definition == null) {
             return null;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/CustomWordEmbedding.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/CustomWordEmbedding.java
new file mode 100644
index 0000000000000..960fdbd86e2dc
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/CustomWordEmbedding.java
@@ -0,0 +1,300 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing;
+
+import org.apache.lucene.util.RamUsageEstimator;
+import org.elasticsearch.common.CheckedFunction;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding.FeatureExtractor;
+import org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding.FeatureUtils;
+import org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding.FeatureValue;
+import org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding.NGramFeatureExtractor;
+import org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding.RelevantScriptFeatureExtractor;
+import org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding.ScriptFeatureExtractor;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.stream.Collectors;
+
+/**
+ * This is a pre-processor that embeds text into a numerical vector.
+ *
+ * It calculates a set of features based on script type, ngram hashes, and most common script values.
+ *
+ * The features are then concatenated with specific quantization scales and weights into a vector of length 80.
+ *
+ * This is a fork and a port of: https://github.com/google/cld3/blob/06f695f1c8ee530104416aab5dcf2d6a1414a56a/src/embedding_network.cc
+ */
+public class CustomWordEmbedding implements LenientlyParsedPreProcessor, StrictlyParsedPreProcessor {
+
+    private static final long SHALLOW_SIZE = RamUsageEstimator.shallowSizeOfInstance(CustomWordEmbedding.class);
+    public static final int MAX_STRING_SIZE_IN_BYTES = 10000;
+    public static final ParseField NAME = new ParseField("custom_word_embedding");
+    public static final ParseField FIELD = new ParseField("field");
+    public static final ParseField DEST_FIELD = new ParseField("dest_field");
+    public static final ParseField EMBEDDING_WEIGHTS = new ParseField("embedding_weights");
+    public static final ParseField EMBEDDING_QUANT_SCALES = new ParseField("embedding_quant_scales");
+
+    public static final ConstructingObjectParser<CustomWordEmbedding, Void> STRICT_PARSER = createParser(false);
+    public static final ConstructingObjectParser<CustomWordEmbedding, Void> LENIENT_PARSER = createParser(true);
+
+    @SuppressWarnings("unchecked")
+    private static ConstructingObjectParser<CustomWordEmbedding, Void> createParser(boolean lenient) {
+        ConstructingObjectParser<CustomWordEmbedding, Void> parser = new ConstructingObjectParser<>(
+            NAME.getPreferredName(),
+            lenient,
+            a -> new CustomWordEmbedding((short[][])a[0], (byte[][])a[1], (String)a[2], (String)a[3]));
+
+        parser.declareField(ConstructingObjectParser.constructorArg(),
+            (p, c) -> {
+                List<List<Short>> listOfListOfShorts = parseArrays(EMBEDDING_QUANT_SCALES.getPreferredName(),
+                    XContentParser::shortValue,
+                    p);
+                short[][] primitiveShorts = new short[listOfListOfShorts.size()][];
+                int i = 0;
+                for (List<Short> shorts : listOfListOfShorts) {
+                    short[] innerShorts = new short[shorts.size()];
+                    for (int j = 0; j < shorts.size(); j++) {
+                        innerShorts[j] = shorts.get(j);
+                    }
+                    primitiveShorts[i++] = innerShorts;
+                }
+                return primitiveShorts;
+            },
+            EMBEDDING_QUANT_SCALES,
+            ObjectParser.ValueType.VALUE_ARRAY);
+        parser.declareField(ConstructingObjectParser.constructorArg(),
+            (p, c) -> {
+                List<byte[]> values = new ArrayList<>();
+                while(p.nextToken() != XContentParser.Token.END_ARRAY) {
+                    values.add(p.binaryValue());
+                }
+                byte[][] primitiveBytes = new byte[values.size()][];
+                int i = 0;
+                for (byte[] bytes : values) {
+                    primitiveBytes[i++] = bytes;
+                }
+                return primitiveBytes;
+            },
+            EMBEDDING_WEIGHTS,
+            ObjectParser.ValueType.VALUE_ARRAY);
+        parser.declareString(ConstructingObjectParser.constructorArg(), FIELD);
+        parser.declareString(ConstructingObjectParser.constructorArg(), DEST_FIELD);
+        return parser;
+    }
+
+    private static <T> List<List<T>> parseArrays(String fieldName,
+                                                 CheckedFunction<XContentParser, T, IOException> fromParser,
+                                                 XContentParser p) throws IOException {
+        if (p.currentToken() != XContentParser.Token.START_ARRAY) {
+            throw new IllegalArgumentException("unexpected token [" + p.currentToken() + "] for [" + fieldName + "]");
+        }
+        List<List<T>> values = new ArrayList<>();
+        while(p.nextToken() != XContentParser.Token.END_ARRAY) {
+            if (p.currentToken() != XContentParser.Token.START_ARRAY) {
+                throw new IllegalArgumentException("unexpected token [" + p.currentToken() + "] for [" + fieldName + "]");
+            }
+            List<T> innerList = new ArrayList<>();
+            while(p.nextToken() != XContentParser.Token.END_ARRAY) {
+                if(p.currentToken().isValue() == false) {
+                    throw new IllegalStateException("expected non-null value but got [" + p.currentToken() + "] " +
+                        "for [" + fieldName + "]");
+                }
+                innerList.add(fromParser.apply(p));
+            }
+            values.add(innerList);
+        }
+        return values;
+    }
+
+    public static CustomWordEmbedding fromXContentStrict(XContentParser parser) {
+        return STRICT_PARSER.apply(parser, null);
+    }
+
+    public static CustomWordEmbedding fromXContentLenient(XContentParser parser) {
+        return LENIENT_PARSER.apply(parser, null);
+    }
+
+    private static final int CONCAT_LAYER_SIZE = 80;
+    private static final int[] EMBEDDING_DIMENSIONS = new int[]{16, 16, 8, 8, 16, 16};
+
+    // Order matters
+    private static final List<FeatureExtractor> FEATURE_EXTRACTORS = Arrays.asList(
+        new NGramFeatureExtractor(2, 1000),
+        new NGramFeatureExtractor(4, 5000),
+        new RelevantScriptFeatureExtractor(),
+        new ScriptFeatureExtractor(),
+        new NGramFeatureExtractor(3, 5000),
+        new NGramFeatureExtractor(1, 100)
+    );
+
+    private final short[][] embeddingsQuantScales;
+    private final byte[][] embeddingsWeights;
+    private final String fieldName;
+    private final String destField;
+
+    public CustomWordEmbedding(StreamInput in) throws IOException {
+        this.fieldName = in.readString();
+        this.destField = in.readString();
+        this.embeddingsWeights = in.readArray(StreamInput::readByteArray, (length) -> new byte[length][]);
+        this.embeddingsQuantScales = in.readArray((input -> {
+            int length = input.readVInt();
+            short[] shorts = new short[length];
+            for (int i = 0; i < length; i++) {
+                shorts[i] = in.readShort();
+            }
+            return shorts;
+        }), (length) -> new short[length][]);
+    }
+
+    public CustomWordEmbedding(short[][] embeddingsQuantScales, byte[][] embeddingsWeights, String fieldName, String destField) {
+        this.embeddingsQuantScales = embeddingsQuantScales;
+        this.embeddingsWeights = embeddingsWeights;
+        this.fieldName = fieldName;
+        this.destField = destField;
+    }
+
+    /**
+     * Derived from: https://github.com/google/cld3/blob/06f695f1c8ee530104416aab5dcf2d6a1414a56a/src/embedding_network.cc#L74
+     */
+    private double[] concatEmbeddings(List<FeatureValue[]> featureVectors) {
+        double[] concat = new double[CONCAT_LAYER_SIZE];
+
+        int offset = 0;
+        // "esIndex" stands for "embedding space index".
+        for (int esIndex = 0; esIndex < featureVectors.size(); ++esIndex) {
+            byte[] embeddingWeight = this.embeddingsWeights[esIndex];
+            short[] quants = this.embeddingsQuantScales[esIndex];
+            int embeddingDim = EMBEDDING_DIMENSIONS[esIndex];
+
+            FeatureValue[] featureVector = featureVectors.get(esIndex);
+            assert (offset + embeddingDim <= concat.length);
+            for (FeatureValue featureValue : featureVector) {
+                // Multiplier for each embedding weight.
+                int row = featureValue.getRow();
+                double multiplier = featureValue.getWeight() * shortToDouble(quants[row]);
+
+                // Iterate across columns for this row
+                for (int i = 0; i < embeddingDim; ++i) {
+                    double value = (getRowMajorData(embeddingWeight, embeddingDim, row, i)) * multiplier;
+                    int concatIndex = offset + i;
+                    concat[concatIndex] += value;
+                }
+            }
+            offset += embeddingDim;
+        }
+
+        return concat;
+    }
+
+    /**
+     * Internal logic to CLD3. The quantiles are stored as "compact float16" values.
+     * These values are stored as `unsigned int16` in C++, best represented by a `short` Java
+     * To "expand" these to a regular float, the mantissa bytes are filled with 0, a la a bit shift of 16
+     * The memory is then statically cast to a float with the shift.
+     *
+     * The following satisfies this in java
+     * @param s Represents a "compact float16", i.e. unsigned int16
+     * @return Float representation with the short shifted over to zero out the underlying mantissa bytes
+     */
+    private static double shortToDouble(short s) {
+        return Float.intBitsToFloat(s << 16);
+    }
+
+    private static int getRowMajorData(byte[] data, int colDim, int row, int col) {
+        return data[row * colDim + col];
+    }
+
+    @Override
+    public void process(Map<String, Object> fields) {
+        Object field = fields.get(fieldName);
+        if ((field instanceof String) == false) {
+            return;
+        }
+        String text = (String)field;
+        text = FeatureUtils.cleanAndLowerText(text);
+        text = FeatureUtils.truncateToNumValidBytes(text, MAX_STRING_SIZE_IN_BYTES);
+        String finalText = text;
+        List<FeatureValue[]> processedFeatures = FEATURE_EXTRACTORS.stream()
+            .map((featureExtractor) -> featureExtractor.extractFeatures(finalText))
+            .collect(Collectors.toList());
+        fields.put(destField, concatEmbeddings(processedFeatures));
+    }
+
+    @Override
+    public long ramBytesUsed() {
+        long size = SHALLOW_SIZE;
+        for(byte[] bytes : embeddingsWeights) {
+            size += RamUsageEstimator.sizeOf(bytes);
+        }
+        for(short[] shorts : embeddingsQuantScales) {
+            size += RamUsageEstimator.sizeOf(shorts);
+        }
+        return size;
+    }
+
+    @Override
+    public String getWriteableName() {
+        return NAME.getPreferredName();
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeString(fieldName);
+        out.writeString(destField);
+        out.writeArray(StreamOutput::writeByteArray, embeddingsWeights);
+        out.writeArray((output, value) -> {
+            output.writeVInt(value.length);
+            for(short s : value) {
+                output.writeShort(s);
+            }
+        }, embeddingsQuantScales);
+    }
+
+    @Override
+    public String getName() {
+        return NAME.getPreferredName();
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.field(FIELD.getPreferredName(), fieldName);
+        builder.field(DEST_FIELD.getPreferredName(), destField);
+        builder.field(EMBEDDING_QUANT_SCALES.getPreferredName(), embeddingsQuantScales);
+        builder.field(EMBEDDING_WEIGHTS.getPreferredName(), embeddingsWeights);
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        CustomWordEmbedding that = (CustomWordEmbedding) o;
+        return Objects.equals(fieldName, that.fieldName)
+            && Objects.equals(destField, that.destField)
+            && Arrays.deepEquals(embeddingsWeights, that.embeddingsWeights)
+            && Arrays.deepEquals(embeddingsQuantScales, that.embeddingsQuantScales);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(fieldName, destField, Arrays.deepHashCode(embeddingsQuantScales), Arrays.deepHashCode(embeddingsWeights));
+    }
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ContinuousFeatureValue.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ContinuousFeatureValue.java
new file mode 100644
index 0000000000000..df34a79e1a126
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ContinuousFeatureValue.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+/**
+ * Extracted feature that has a continuous weight value
+ */
+public class ContinuousFeatureValue extends FeatureValue {
+
+    private final int id;
+    private final double weight;
+
+    public ContinuousFeatureValue(int id, double weight) {
+        this.id = id;
+        this.weight = weight;
+    }
+
+    @Override
+    public int getRow() {
+        return id;
+    }
+
+    @Override
+    public double getWeight() {
+        return weight;
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/DiscreteFeatureValue.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/DiscreteFeatureValue.java
new file mode 100644
index 0000000000000..3d0fc2048fc82
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/DiscreteFeatureValue.java
@@ -0,0 +1,22 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+/**
+ * Discrete extracted value with a static weight of 1.0
+ */
+public class DiscreteFeatureValue extends FeatureValue {
+
+    private final int id;
+    DiscreteFeatureValue(int id) {
+        this.id = id;
+    }
+
+    @Override
+    public int getRow() {
+        return id;
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureExtractor.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureExtractor.java
new file mode 100644
index 0000000000000..b9ee0b9ff4aa6
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureExtractor.java
@@ -0,0 +1,12 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+public interface FeatureExtractor {
+
+    FeatureValue[] extractFeatures(String text);
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureUtils.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureUtils.java
new file mode 100644
index 0000000000000..7224ee410860d
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureUtils.java
@@ -0,0 +1,76 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import java.nio.ByteBuffer;
+import java.nio.CharBuffer;
+import java.nio.charset.CharsetDecoder;
+import java.nio.charset.CodingErrorAction;
+import java.nio.charset.StandardCharsets;
+import java.util.Locale;
+
+/**
+ * A collection of messy feature extractors
+ */
+public final class FeatureUtils {
+
+    private FeatureUtils() {}
+
+    /**
+     * Truncates a string to the number of characters that fit in X bytes avoiding multi byte characters being cut in
+     * half at the cut off point. Also handles surrogate pairs where 2 characters in the string is actually one literal
+     * character.
+     *
+     * Based on: https://stackoverflow.com/a/35148974/1818849
+     *
+     */
+    public static String truncateToNumValidBytes(String text, int maxLength) {
+        if (text == null) {
+            return null;
+        }
+        byte[] sba = text.getBytes(StandardCharsets.UTF_8);
+        if (sba.length <= maxLength) {
+            return text;
+        }
+        CharsetDecoder decoder = StandardCharsets.UTF_8.newDecoder();
+        // Ensure truncation by having byte buffer = maxBytes
+        ByteBuffer bb = ByteBuffer.wrap(sba, 0, maxLength);
+        CharBuffer cb = CharBuffer.allocate(maxLength);
+        // Ignore an incomplete character
+        decoder.onMalformedInput(CodingErrorAction.IGNORE);
+        decoder.decode(bb, cb, true);
+        decoder.flush(cb);
+        return new String(cb.array(), 0, cb.position());
+    }
+
+    /**
+     * Cleanup text and lower-case it
+     * NOTE: This does not do any string compression by removing duplicate tokens
+     */
+    public static String cleanAndLowerText(String text) {
+        // 1. Start with ' ', only if the string already does not start with a space
+        String newText = text.startsWith(" ") ? "" : " ";
+
+        // 2. Replace punctuation and whitespace with ' '
+        // NOTE: we capture unicode letters AND marks as Nepalese and other languages
+        newText += text.replaceAll("[^\\p{L}|\\p{M}|\\s]|\\|", " ");
+
+        // 2.1. Replace spacing modifier characters
+        newText = newText.replaceAll("\\p{InSpacing_Modifier_Letters}", " ");
+
+        // 3. Add space at end
+        newText += text.endsWith(" ") ? "" : " ";
+
+        // 4. Remove multiple spaces (2 or more) with a single space
+        newText = newText.replaceAll("\\p{IsWhite_Space}+", " ");
+
+        // 5. Replace Turkish Ä° with I (TODO - check this out better...)
+        newText = newText.replaceAll("\\u0130", "I");
+
+        return newText.toLowerCase(Locale.ROOT);
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureValue.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureValue.java
new file mode 100644
index 0000000000000..15b33c6e64e66
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureValue.java
@@ -0,0 +1,19 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+/**
+ * Extracted feature values from the text
+ */
+public abstract class FeatureValue {
+
+    public double getWeight() {
+        return 1.0;
+    }
+
+    public abstract int getRow();
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/Hash32.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/Hash32.java
new file mode 100644
index 0000000000000..bf3f331cab3ff
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/Hash32.java
@@ -0,0 +1,89 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import java.nio.charset.StandardCharsets;
+
+/**
+ * Custom Hash class necessary for hashing nGrams
+ */
+final class Hash32 {
+
+    private static final int DEFAULT_SEED = 0xBEEF;
+
+    private final int seed;
+
+    Hash32(int seed) {
+        this.seed = seed;
+    }
+
+    Hash32() {
+        this(DEFAULT_SEED);
+    }
+
+    public long hash(String input) {
+        byte[] bytes = input.getBytes(StandardCharsets.UTF_8);
+        return Integer.toUnsignedLong(hash32(bytes));
+    }
+
+    /**
+     * Derived from https://github.com/google/cld3/blob/06f695f1c8ee530104416aab5dcf2d6a1414a56a/src/utils.cc#L137
+     *
+     * It is critical that we utilize this hash as it determines which weight and quantile column/row we choose
+     * when building the feature array.
+     */
+    private int hash32(byte[] data) {
+        int n = data.length;
+        // 'm' and 'r' are mixing constants generated offline.
+        // They're not really 'magic', they just happen to work well.
+        int m = 0x5bd1e995;
+        int r = 24;
+
+        // Initialize the hash to a 'random' value
+        int h = (seed ^ n);
+
+        // Mix 4 bytes at a time into the hash
+        int i = 0;
+        while (n >= 4) {
+            int k = decodeFixed32(data, i);
+            k *= m;
+            k ^= k >>> r; // use unsigned shift
+            k *= m;
+            h *= m;
+            h ^= k;
+            i += 4;
+            n -= 4;
+        }
+
+        // Handle the last few bytes of the input array
+        if (n == 3) {
+            h ^= Byte.toUnsignedInt(data[i + 2]) << 16;
+        }
+        if (n >= 2) {
+            h ^= Byte.toUnsignedInt(data[i + 1]) << 8;
+        }
+        if (n >= 1) {
+            h ^= Byte.toUnsignedInt(data[i]);
+            h *= m;
+        }
+
+        // Do a few final mixes of the hash to ensure the last few
+        // bytes are well-incorporated.
+        h ^= h >>> 13; // use unsigned shift
+        h *= m;
+        h ^= h >>> 15; // use unsigned shift
+        return h;
+    }
+
+    private static int decodeFixed32(byte[] ptr, int offset) {
+        return Byte.toUnsignedInt(ptr[offset]) |
+            Byte.toUnsignedInt(ptr[offset + 1]) << 8 |
+            Byte.toUnsignedInt(ptr[offset + 2]) << 16 |
+            Byte.toUnsignedInt(ptr[offset + 3]) << 24;
+    }
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/NGramFeatureExtractor.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/NGramFeatureExtractor.java
new file mode 100644
index 0000000000000..06dc68e1f283f
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/NGramFeatureExtractor.java
@@ -0,0 +1,92 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.apache.lucene.util.Counter;
+
+import java.util.Map;
+import java.util.TreeMap;
+
+/**
+ * This provides an array of {@link FeatureValue} for the given nGram size and dimensionId
+ *
+ * Each feature value contains the average occurrence of an nGram and its "id". This id is determined via a custom hash ({@link Hash32})
+ * and the provided dimensionId
+ */
+public class NGramFeatureExtractor implements FeatureExtractor {
+
+    private static final Hash32 hashing = new Hash32();
+
+    private final int nGrams;
+    private final int dimensionId;
+
+    public NGramFeatureExtractor(int nGrams, int dimensionId) {
+        this.nGrams = nGrams;
+        this.dimensionId = dimensionId;
+    }
+
+    @Override
+    public FeatureValue[] extractFeatures(String text) {
+        // First add terminators:
+        // Split the text based on spaces to get tokens, adds "^"
+        // to the beginning of each token, and adds "$" to the end of each token.
+        // e.g.
+        // " this text is written in english" goes to
+        // "^$ ^this$ ^text$ ^is$ ^written$ ^in$ ^english$ ^$"
+        StringBuilder newText = new StringBuilder("^");
+        for (int i = 0; i < text.length(); i++) {
+            char c = text.charAt(i);
+            if (c == ' ') {
+                newText.append("$ ^");
+            } else {
+                newText.append(c);
+            }
+        }
+        newText.append("$");
+
+        // Find the char ngrams
+        // ^$ ^this$ ^text$ ^is$ ^written$ ^in$ ^english$ ^$"
+        // nGramSize = 2
+        // [{h$},{sh},{li},{gl},{in},{en},{^$},...]
+        Map<String, Counter> charNGrams = new TreeMap<>();
+
+        int countSum = 0;
+        int end = newText.toString().length() - nGrams;
+        for (int start = 0; start <= end; ++start) {
+            StringBuilder charNGram = new StringBuilder();
+
+            int index;
+            for (index = 0; index < nGrams; ++index) {
+                char currentChar = newText.toString().charAt(start + index);
+                if (currentChar == ' ') {
+                    break;
+                }
+                charNGram.append(currentChar);
+            }
+
+            if (index == nGrams) {
+                charNGrams.computeIfAbsent(charNGram.toString(), ngram -> Counter.newCounter()).addAndGet(1);
+                ++countSum;
+            }
+        }
+
+        FeatureValue[] results = new FeatureValue[charNGrams.size()];
+        int index = 0;
+        for (Map.Entry<String, Counter> entry : charNGrams.entrySet()) {
+            String key = entry.getKey();
+            long value = entry.getValue().get();
+
+            double weight = (double) value / (double) countSum;
+            // We need to use the special hashing so that we choose the appropriate weight+ quantile
+            // when building the feature vector.
+            int id = (int)(hashing.hash(key) % dimensionId);
+
+            results[index++] = new ContinuousFeatureValue(id, weight);
+        }
+        return results;
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/RelevantScriptFeatureExtractor.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/RelevantScriptFeatureExtractor.java
new file mode 100644
index 0000000000000..175b280c41440
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/RelevantScriptFeatureExtractor.java
@@ -0,0 +1,60 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.apache.lucene.util.Counter;
+
+import java.util.Map;
+import java.util.TreeMap;
+
+/**
+ * Derived from: https://github.com/google/cld3/blob/master/src/relevant_script_feature.cc
+ *
+ * This extracts an array of {@link FeatureValue} from the given text.
+ *
+ * These values contain the particular script id for each code point (determined via {@link ScriptDetector})
+ * and their average occurrence in the text.
+ *
+ */
+public class RelevantScriptFeatureExtractor implements FeatureExtractor {
+
+    @Override
+    public FeatureValue[] extractFeatures(String text) {
+        if (text.isEmpty()) {
+            return new FeatureValue[0];
+        }
+
+        // counts[s] is the number of characters with script s.
+        // Use treemap so results are sorted in scriptid order
+        final Counter totalCount = Counter.newCounter();
+        TreeMap<ScriptDetector.Script, Counter> counts = new TreeMap<>();
+
+        text.codePoints().forEach(cp -> {
+            // Get anything that is a letter, or anything complex enough warranting a check (more than one UTF-8 byte).
+            // cp > Byte.MAX_VALUE works as the first 127 codepoints are the same as the ASCII encoding,
+            // which is the same as one UTF-8 byte.
+            if(Character.isLetter(cp) || cp > Byte.MAX_VALUE) {
+                ScriptDetector.Script script = ScriptDetector.Script.fromCodePoint(cp);
+                counts.computeIfAbsent(script, (s) -> Counter.newCounter()).addAndGet(1);
+                totalCount.addAndGet(1L);
+            }
+        });
+
+        FeatureValue[] result = new FeatureValue[counts.size()];
+        int index = 0;
+
+        for (Map.Entry<ScriptDetector.Script, Counter> entry : counts.entrySet()) {
+            ScriptDetector.Script scriptId = entry.getKey();
+            long count = entry.getValue().get();
+            double weight = (double) count / (double) totalCount.get();
+            result[index++] = new ContinuousFeatureValue(scriptId.toInt(), weight);
+        }
+
+        return result;
+    }
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptCode.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptCode.java
new file mode 100644
index 0000000000000..bd7af9d551f4f
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptCode.java
@@ -0,0 +1,339 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+/**
+ * These are the custom script codes that match up to the appropriate id row for the CLD3 weights and quantiles
+ *
+ * See https://github.com/google/cld3/blob/master/src/script_span/generated_ulscript.h
+ */
+public enum ScriptCode {
+    Common(0),//Zyyy
+    Latin(1),//Latn
+    Greek(2),//Grek
+    Cyrillic(3),//Cyrl
+    Armenian(4),//Armn
+    Hebrew(5),//Hebr
+    Arabic(6),//Arab
+    Syriac(7),//Syrc
+    Thaana(8),//Thaa
+    Devanagari(9),//Deva
+    Bengali(10),//Beng
+    Gurmukhi(11),//Guru
+    Gujarati(12),//Gujr
+    Oriya(13),//Orya
+    Tamil(14),//Taml
+    Telugu(15),//Telu
+    Kannada(16),//Knda
+    Malayalam(17),//Mlym
+    Sinhala(18),//Sinh
+    Thai(19),//Thai
+    Lao(20),//Laoo
+    Tibetan(21),//Tibt
+    Myanmar(22),//Mymr
+    Georgian(23),//Geor
+    Hani(24),//Hani
+    Ethiopic(25),//Ethi
+    Cherokee(26),//Cher
+    Canadian_Aboriginal(27),//Cans
+    Ogham(28),//Ogam
+    Runic(29),//Runr
+    Khmer(30),//Khmr
+    Mongolian(31),//Mong
+    Undefined_32(32),//
+    Undefined_33(33),//
+    Bopomofo(34),//Bopo
+    Undefined_35(35),//
+    Yi(36),//Yiii
+    Old_Italic(37),//Ital
+    Gothic(38),//Goth
+    Deseret(39),//Dsrt
+    Inherited(40),//Zinh
+    Tagalog(41),//Tglg
+    Hanunoo(42),//Hano
+    Buhid(43),//Buhd
+    Tagbanwa(44),//Tagb
+    Limbu(45),//Limb
+    Tai_Le(46),//Tale
+    Linear_B(47),//Linb
+    Ugaritic(48),//Ugar
+    Shavian(49),//Shaw
+    Osmanya(50),//Osma
+    Cypriot(51),//Cprt
+    Braille(52),//Brai
+    Buginese(53),//Bugi
+    Coptic(54),//Copt
+    New_Tai_Lue(55),//Talu
+    Glagolitic(56),//Glag
+    Tifinagh(57),//Tfng
+    Syloti_Nagri(58),//Sylo
+    Old_Persian(59),//Xpeo
+    Kharoshthi(60),//Khar
+    Balinese(61),//Bali
+    Cuneiform(62),//Xsux
+    Phoenician(63),//Phnx
+    Phags_Pa(64),//Phag
+    Nko(65),//Nkoo
+    Sundanese(66),//Sund
+    Lepcha(67),//Lepc
+    Ol_Chiki(68),//Olck
+    Vai(69),//Vaii
+    Saurashtra(70),//Saur
+    Kayah_Li(71),//Kali
+    Rejang(72),//Rjng
+    Lycian(73),//Lyci
+    Carian(74),//Cari
+    Lydian(75),//Lydi
+    Cham(76),//Cham
+    Tai_Tham(77),//Lana
+    Tai_Viet(78),//Tavt
+    Avestan(79),//Avst
+    Egyptian_Hieroglyphs(80),//Egyp
+    Samaritan(81),//Samr
+    Lisu(82),//Lisu
+    Bamum(83),//Bamu
+    Javanese(84),//Java
+    Meetei_Mayek(85),//Mtei
+    Imperial_Aramaic(86),//Armi
+    Old_South_Arabian(87),//Sarb
+    Inscriptional_Parthian(88),//Prti
+    Inscriptional_Pahlavi(89),//Phli
+    Old_Turkic(90),//Orkh
+    Kaithi(91),//Kthi
+    Batak(92),//Batk
+    Brahmi(93),//Brah
+    Mandaic(94),//Mand
+    Chakma(95),//Cakm
+    Meroitic_Cursive(96),//Merc
+    Meroitic_Hieroglyphs(97),//Mero
+    Miao(98),//Plrd
+    Sharada(99),//Shrd
+    Sora_Sompeng(100),//Sora
+    Takri(101),//Takr
+    MAX_SCRIPT_CODE(102);
+
+    private final int code;
+
+    ScriptCode(int code) {
+        this.code = code;
+    }
+
+    public static ScriptCode unicodeScriptToULScript(Character.UnicodeScript scriptId) {
+        switch (scriptId) {
+            case COMMON:
+                return ScriptCode.Common;
+            case LATIN:
+                return ScriptCode.Latin;
+            case GREEK:
+                return ScriptCode.Greek;
+            case CYRILLIC:
+                return ScriptCode.Cyrillic;
+            case ARMENIAN:
+                return ScriptCode.Armenian;
+            case HEBREW:
+                return ScriptCode.Hebrew;
+            case ARABIC:
+                return ScriptCode.Arabic;
+            case SYRIAC:
+                return ScriptCode.Syriac;
+            case THAANA:
+                return ScriptCode.Thaana;
+            case DEVANAGARI:
+                return ScriptCode.Devanagari;
+            case BENGALI:
+                return ScriptCode.Bengali;
+            case GURMUKHI:
+                return ScriptCode.Gurmukhi;
+            case GUJARATI:
+                return ScriptCode.Gujarati;
+            case ORIYA:
+                return ScriptCode.Oriya;
+            case TAMIL:
+                return ScriptCode.Tamil;
+            case TELUGU:
+                return ScriptCode.Telugu;
+            case KANNADA:
+                return ScriptCode.Kannada;
+            case MALAYALAM:
+                return ScriptCode.Malayalam;
+            case SINHALA:
+                return ScriptCode.Sinhala;
+            case THAI:
+                return ScriptCode.Thai;
+            case LAO:
+                return ScriptCode.Lao;
+            case TIBETAN:
+                return ScriptCode.Tibetan;
+            case MYANMAR:
+                return ScriptCode.Myanmar;
+            case GEORGIAN:
+                return ScriptCode.Georgian;
+            case HANGUL:
+            case HAN:       // (based on testing cld3 vs java codepoints)
+            case HIRAGANA:  // (based on testing cld3 va java codepoints)
+            case KATAKANA:  // (based on testing cld3 va java codepoints)
+                return ScriptCode.Hani;
+            case ETHIOPIC:
+                return ScriptCode.Ethiopic;
+            case CHEROKEE:
+                return ScriptCode.Cherokee;
+            case CANADIAN_ABORIGINAL:
+                return ScriptCode.Canadian_Aboriginal;
+            case OGHAM:
+                return ScriptCode.Ogham;
+            case RUNIC:
+                return ScriptCode.Runic;
+            case KHMER:
+                return ScriptCode.Khmer;
+            case MONGOLIAN:
+                return ScriptCode.Mongolian;
+            case BOPOMOFO:
+                return ScriptCode.Bopomofo;
+            case YI:
+                return ScriptCode.Yi;
+            case OLD_ITALIC:
+                return ScriptCode.Old_Italic;
+            case GOTHIC:
+                return ScriptCode.Gothic;
+            case DESERET:
+                return ScriptCode.Deseret;
+            case INHERITED:
+                return ScriptCode.Inherited;
+            case TAGALOG:
+                return ScriptCode.Tagalog;
+            case HANUNOO:
+                return ScriptCode.Hanunoo;
+            case BUHID:
+                return ScriptCode.Buhid;
+            case TAGBANWA:
+                return ScriptCode.Tagbanwa;
+            case LIMBU:
+                return ScriptCode.Limbu;
+            case TAI_LE:
+                return ScriptCode.Tai_Le;
+            case LINEAR_B:
+                return ScriptCode.Linear_B;
+            case UGARITIC:
+                return ScriptCode.Ugaritic;
+            case SHAVIAN:
+                return ScriptCode.Shavian;
+            case OSMANYA:
+                return ScriptCode.Osmanya;
+            case CYPRIOT:
+                return ScriptCode.Cypriot;
+            case BRAILLE:
+                return ScriptCode.Braille;
+            case BUGINESE:
+                return ScriptCode.Buginese;
+            case COPTIC:
+                return ScriptCode.Coptic;
+            case NEW_TAI_LUE:
+                return ScriptCode.New_Tai_Lue;
+            case GLAGOLITIC:
+                return ScriptCode.Glagolitic;
+            case TIFINAGH:
+                return ScriptCode.Tifinagh;
+            case SYLOTI_NAGRI:
+                return ScriptCode.Syloti_Nagri;
+            case OLD_PERSIAN:
+                return ScriptCode.Old_Persian;
+            case KHAROSHTHI:
+                return ScriptCode.Kharoshthi;
+            case BALINESE:
+                return ScriptCode.Balinese;
+            case CUNEIFORM:
+                return ScriptCode.Cuneiform;
+            case PHOENICIAN:
+                return ScriptCode.Phoenician;
+            case PHAGS_PA:
+                return ScriptCode.Phags_Pa;
+            case NKO:
+                return ScriptCode.Nko;
+            case SUNDANESE:
+                return ScriptCode.Sundanese;
+            case LEPCHA:
+                return ScriptCode.Lepcha;
+            case OL_CHIKI:
+                return ScriptCode.Ol_Chiki;
+            case VAI:
+                return ScriptCode.Vai;
+            case SAURASHTRA:
+                return ScriptCode.Saurashtra;
+            case KAYAH_LI:
+                return ScriptCode.Kayah_Li;
+            case REJANG:
+                return ScriptCode.Rejang;
+            case LYCIAN:
+                return ScriptCode.Lycian;
+            case CARIAN:
+                return ScriptCode.Carian;
+            case LYDIAN:
+                return ScriptCode.Lydian;
+            case CHAM:
+                return ScriptCode.Cham;
+            case TAI_THAM:
+                return ScriptCode.Tai_Tham;
+            case TAI_VIET:
+                return ScriptCode.Tai_Viet;
+            case AVESTAN:
+                return ScriptCode.Avestan;
+            case EGYPTIAN_HIEROGLYPHS:
+                return ScriptCode.Egyptian_Hieroglyphs;
+            case SAMARITAN:
+                return ScriptCode.Samaritan;
+            case LISU:
+                return ScriptCode.Lisu;
+            case BAMUM:
+                return ScriptCode.Bamum;
+            case JAVANESE:
+                return ScriptCode.Javanese;
+            case MEETEI_MAYEK:
+                return ScriptCode.Meetei_Mayek;
+            case IMPERIAL_ARAMAIC:
+                return ScriptCode.Imperial_Aramaic;
+            case OLD_SOUTH_ARABIAN:
+                return ScriptCode.Old_South_Arabian;
+            case INSCRIPTIONAL_PARTHIAN:
+                return ScriptCode.Inscriptional_Parthian;
+            case INSCRIPTIONAL_PAHLAVI:
+                return ScriptCode.Inscriptional_Pahlavi;
+            case OLD_TURKIC:
+                return ScriptCode.Old_Turkic;
+            case KAITHI:
+                return ScriptCode.Kaithi;
+            case BATAK:
+                return ScriptCode.Batak;
+            case BRAHMI:
+                return ScriptCode.Brahmi;
+            case MANDAIC:
+                return ScriptCode.Mandaic;
+            case MEROITIC_CURSIVE:
+                return ScriptCode.Meroitic_Cursive;
+            case MEROITIC_HIEROGLYPHS:
+                return ScriptCode.Meroitic_Hieroglyphs;
+            case CHAKMA:
+                return ScriptCode.Chakma;
+            case SHARADA:
+                return ScriptCode.Sharada;
+            case SORA_SOMPENG:
+                return ScriptCode.Sora_Sompeng;
+            case MIAO:
+                return ScriptCode.Miao;
+            case TAKRI:
+                return ScriptCode.Takri;
+            case UNKNOWN:
+            default:
+        }
+        // Fall-through for unknown(s)
+        return ScriptCode.Common;
+    }
+
+    public int toInt() {
+        return code;
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptDetector.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptDetector.java
new file mode 100644
index 0000000000000..ba2f7d8a197d4
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptDetector.java
@@ -0,0 +1,107 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import static java.lang.Character.UnicodeBlock.ARABIC;
+import static java.lang.Character.UnicodeBlock.CYRILLIC;
+import static java.lang.Character.UnicodeBlock.GREEK;
+import static java.lang.Character.UnicodeBlock.HANGUL_JAMO;
+import static java.lang.Character.UnicodeBlock.HEBREW;
+import static java.lang.Character.UnicodeBlock.HIRAGANA;
+import static java.lang.Character.UnicodeBlock.KATAKANA;
+
+/**
+ * Derived from https://github.com/google/cld3/blob/master/src/script_detector.h
+ *
+ * We take advantage of Java codepoints to determine the specific script value we care about
+ */
+public final class ScriptDetector {
+
+    private ScriptDetector() { }
+
+    // Unicode scripts we care about.  To get compact and fast code, we detect only
+    // a few Unicode scripts that offer a strong indication about the language of
+    // the text (e.g., Hiragana -> Japanese).
+    public enum Script {
+        // Special value to indicate internal errors in the script detection code.
+        kScriptError(0),
+
+        // Special values for all Unicode scripts that we do not detect.  One special
+        // value for Unicode characters of 1, 2, 3, respectively 4 bytes (as we
+        // already have that information, we use it).  kScriptOtherUtf8OneByte means
+        // ~Latin and kScriptOtherUtf8FourBytes means ~Han.
+        kScriptOtherUtf8OneByte(1),
+        kScriptOtherUtf8TwoBytes(2),
+        kScriptOtherUtf8ThreeBytes(3),
+        kScriptOtherUtf8FourBytes(4),
+
+        kScriptGreek(5),
+        kScriptCyrillic(6),
+        kScriptHebrew(7),
+        kScriptArabic(8),
+        kScriptHangulJamo(9),  // Used primarily for Korean.
+        kScriptHiragana(10),    // Used primarily for Japanese.
+        kScriptKatakana(11);    // Used primarily for Japanese.
+
+        private final int code;
+
+        Script(int code) {
+            this.code = code;
+        }
+
+        public int toInt() {
+            return code;
+        }
+
+        public static Script fromCodePoint(int codePoint) {
+            // Using blocks for the HANGUL vs HANGUL_JANO distinctions
+            // If one exists. Needs investigated
+            Character.UnicodeBlock block = Character.UnicodeBlock.of(codePoint);
+            if (GREEK.equals(block)) {
+                return kScriptGreek;
+            }
+            if (CYRILLIC.equals(block)) {
+                return kScriptCyrillic;
+            }
+            if (ARABIC.equals(block)) {
+                return kScriptArabic;
+            }
+            if (HEBREW.equals(block)) {
+                return kScriptHebrew;
+            }
+            if (KATAKANA.equals(block)) {
+                return kScriptKatakana;
+            }
+            if (HIRAGANA.equals(block)) {
+                return kScriptHiragana;
+            }
+            if (HANGUL_JAMO.equals(block)) {
+                return kScriptHangulJamo;
+            }
+
+            // Not one of our special cases, need to determine the utf8 byte size
+            if (codePoint > 0) {
+                // Fits in a single UTF-8 byte
+                if (codePoint < 128) {
+                    return kScriptOtherUtf8OneByte;
+                }
+                if (codePoint < 2048) {
+                    return kScriptOtherUtf8TwoBytes;
+                }
+                if (codePoint < 65536) {
+                    return kScriptOtherUtf8ThreeBytes;
+                }
+                if (codePoint < 1114112) {
+                    return kScriptOtherUtf8FourBytes;
+                }
+            }
+
+            return kScriptError;
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptFeatureExtractor.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptFeatureExtractor.java
new file mode 100644
index 0000000000000..67369d5935482
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptFeatureExtractor.java
@@ -0,0 +1,65 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.apache.lucene.util.Counter;
+
+import java.util.OptionalInt;
+
+/**
+ * This is the lone discrete feature.
+ *
+ * It returns an array of {@link FeatureValue} with length 1.
+ *
+ * The feature has a non-continuous weight (it is always 1.0). The "id" is the related {@link ScriptCode} for the first letter
+ * Java codepoint.
+ *
+ * The exception to this is if {@link ScriptCode#Hani} is returned. In that case the number of {@link Character.UnicodeScript#HANGUL}
+ * characters are counted. If more exist than not, {@link ScriptCode#MAX_SCRIPT_CODE} is returned.
+ * Otherwise its {@link ScriptCode#Hani}
+ */
+public final class ScriptFeatureExtractor implements FeatureExtractor {
+
+    private static ScriptCode getScriptIdOfFirstLetter(String text) {
+        OptionalInt optionalCp = text.codePoints().filter(Character::isLetter).findFirst();
+        if (optionalCp.isPresent() == false) {
+            return ScriptCode.Common;
+        }
+        Character.UnicodeScript unicodeScript = Character.UnicodeScript.of(optionalCp.getAsInt());
+        return ScriptCode.unicodeScriptToULScript(unicodeScript);
+    }
+
+    // Get script feature value for the string
+    static int getScriptFeatureValue(String text) {
+        ScriptCode scriptCode = getScriptIdOfFirstLetter(text);
+        if (scriptCode != ScriptCode.Hani) {
+            return scriptCode.toInt();
+        }
+        // Out of the codepoints captured by ULScript_Hani, separately count those
+        // in Hangul (Korean script) and those in a script other than Hangul.
+        Counter hangulCounter = Counter.newCounter();
+        Counter nonHangulCounter = Counter.newCounter();
+        text.codePoints().forEach(cp -> {
+            if (Character.isSpaceChar(cp)) {
+                return;
+            }
+            if (Character.UnicodeScript.of(cp).equals(Character.UnicodeScript.HANGUL)) {
+                hangulCounter.addAndGet(1);
+            } else {
+                nonHangulCounter.addAndGet(1);
+            }
+        });
+
+        return hangulCounter.get() > nonHangulCounter.get() ? ScriptCode.MAX_SCRIPT_CODE.toInt() : ScriptCode.Hani.toInt();
+    }
+
+    @Override
+    public FeatureValue[] extractFeatures(String text) {
+        return new FeatureValue[] { new DiscreteFeatureValue(getScriptFeatureValue(text)) };
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
new file mode 100644
index 0000000000000..b9edeb7885504
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
@@ -0,0 +1,227 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+package org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident;
+
+import org.apache.lucene.util.RamUsageEstimator;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
+import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceConfig;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.InferenceHelpers;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.LenientlyParsedTrainedModel;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.StrictlyParsedTrainedModel;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.TargetType;
+import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.stream.Collectors;
+import java.util.stream.IntStream;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.xpack.core.ml.inference.utils.Statistics.softMax;
+
+public class LangIdentNeuralNetwork implements StrictlyParsedTrainedModel, LenientlyParsedTrainedModel {
+
+    public static final ParseField NAME = new ParseField("lang_ident_neural_network");
+    public static final ParseField EMBEDDED_VECTOR_FEATURE_NAME = new ParseField("embedded_vector_feature_name");
+    public static final ParseField HIDDEN_LAYER = new ParseField("hidden_layer");
+    public static final ParseField SOFTMAX_LAYER = new ParseField("softmax_layer");
+    public static final ConstructingObjectParser<LangIdentNeuralNetwork, Void> STRICT_PARSER = createParser(false);
+    public static final ConstructingObjectParser<LangIdentNeuralNetwork, Void> LENIENT_PARSER = createParser(true);
+
+    private static final List<String> LANGUAGE_NAMES = Arrays.asList(
+        "eo", "co", "eu", "ta", "de", "mt", "ps", "te", "su", "uz", "zh-Latn", "ne",
+        "nl", "sw", "sq", "hmn", "ja", "no", "mn", "so", "ko", "kk", "sl", "ig",
+        "mr", "th", "zu", "ml", "hr", "bs", "lo", "sd", "cy", "hy", "uk", "pt",
+        "lv", "iw", "cs", "vi", "jv", "be", "km", "mk", "tr", "fy", "am", "zh",
+        "da", "sv", "fi", "ht", "af", "la", "id", "fil", "sm", "ca", "el", "ka",
+        "sr", "it", "sk", "ru", "ru-Latn", "bg", "ny", "fa", "haw", "gl", "et",
+        "ms", "gd", "bg-Latn", "ha", "is", "ur", "mi", "hi", "bn", "hi-Latn", "fr",
+        "yi", "hu", "xh", "my", "tg", "ro", "ar", "lb", "el-Latn", "st", "ceb",
+        "kn", "az", "si", "ky", "mg", "en", "gu", "es", "pl", "ja-Latn", "ga", "lt",
+        "sn", "yo", "pa", "ku");
+
+    private static final long SHALLOW_SIZE = RamUsageEstimator.shallowSizeOfInstance(LangIdentNeuralNetwork.class);
+
+    private static final int EMBEDDING_VECTOR_LENGTH = 80;
+
+    @SuppressWarnings("unchecked")
+    private static ConstructingObjectParser<LangIdentNeuralNetwork, Void> createParser(boolean lenient) {
+        ConstructingObjectParser<LangIdentNeuralNetwork, Void> parser = new ConstructingObjectParser<>(
+            NAME.getPreferredName(),
+            lenient,
+            a -> new LangIdentNeuralNetwork((String) a[0],
+                (LangNetLayer) a[1],
+                (LangNetLayer) a[2]));
+        parser.declareString(constructorArg(), EMBEDDED_VECTOR_FEATURE_NAME);
+        parser.declareObject(constructorArg(),
+            (p, c) -> lenient ? LangNetLayer.LENIENT_PARSER.apply(p, c) : LangNetLayer.STRICT_PARSER.apply(p, c),
+            HIDDEN_LAYER);
+        parser.declareObject(constructorArg(),
+            (p, c) -> lenient ? LangNetLayer.LENIENT_PARSER.apply(p, c) : LangNetLayer.STRICT_PARSER.apply(p, c),
+            SOFTMAX_LAYER);
+        return parser;
+    }
+
+    public static LangIdentNeuralNetwork fromXContentStrict(XContentParser parser) {
+        return STRICT_PARSER.apply(parser, null);
+    }
+
+    public static LangIdentNeuralNetwork fromXContentLenient(XContentParser parser) {
+        return LENIENT_PARSER.apply(parser, null);
+    }
+
+    private final LangNetLayer hiddenLayer;
+    private final LangNetLayer softmaxLayer;
+    private final String embeddedVectorFeatureName;
+
+    public LangIdentNeuralNetwork(String embeddedVectorFeatureName,
+                                  LangNetLayer hiddenLayer,
+                                  LangNetLayer softmaxLayer) {
+        this.embeddedVectorFeatureName = ExceptionsHelper.requireNonNull(embeddedVectorFeatureName, EMBEDDED_VECTOR_FEATURE_NAME);
+        this.hiddenLayer = ExceptionsHelper.requireNonNull(hiddenLayer, HIDDEN_LAYER);
+        this.softmaxLayer = ExceptionsHelper.requireNonNull(softmaxLayer, SOFTMAX_LAYER);
+    }
+
+    public LangIdentNeuralNetwork(StreamInput in) throws IOException {
+        this.embeddedVectorFeatureName = in.readString();
+        this.hiddenLayer = new LangNetLayer(in);
+        this.softmaxLayer = new LangNetLayer(in);
+    }
+
+    @Override
+    public List<String> getFeatureNames() {
+        return Collections.singletonList(embeddedVectorFeatureName);
+    }
+
+    @Override
+    public InferenceResults infer(Map<String, Object> fields, InferenceConfig config) {
+        if (config instanceof ClassificationConfig == false) {
+            throw ExceptionsHelper.badRequestException("[{}] model only supports classification",
+                NAME.getPreferredName());
+        }
+        Object vector = fields.get(embeddedVectorFeatureName);
+        if (vector instanceof double[] == false) {
+            throw ExceptionsHelper.badRequestException("[{}] model could not find non-null numerical array named [{}]",
+                NAME.getPreferredName(),
+                embeddedVectorFeatureName);
+        }
+        double[] embeddedVector = (double[]) vector;
+        if (embeddedVector.length != EMBEDDING_VECTOR_LENGTH) {
+            throw ExceptionsHelper.badRequestException("[{}] model is expecting embedding vector of length [{}] but got [{}]",
+                NAME.getPreferredName(),
+                EMBEDDING_VECTOR_LENGTH,
+                embeddedVector.length);
+        }
+        double[] h0 = hiddenLayer.productPlusBias(false, embeddedVector);
+        double[] scores = softmaxLayer.productPlusBias(true, h0);
+
+        List<Double> probabilities = softMax(Arrays.stream(scores).boxed().collect(Collectors.toList()));
+
+        int maxIndex = IntStream.range(0, probabilities.size())
+            .boxed()
+            .max(Comparator.comparing(probabilities::get))
+            .orElseThrow(() -> ExceptionsHelper.serverError("Unexpected null value while searching for max probability"));
+
+        assert maxIndex >= 0 && maxIndex < LANGUAGE_NAMES.size() : "Invalid language predicted. Predicted language index " + maxIndex;
+        ClassificationConfig classificationConfig = (ClassificationConfig) config;
+        List<ClassificationInferenceResults.TopClassEntry> topClasses = InferenceHelpers.topClasses(
+            probabilities,
+            LANGUAGE_NAMES,
+            classificationConfig.getNumTopClasses());
+        return new ClassificationInferenceResults(maxIndex,
+            LANGUAGE_NAMES.get(maxIndex),
+            topClasses,
+            classificationConfig);
+    }
+
+    @Override
+    public TargetType targetType() {
+        return TargetType.CLASSIFICATION;
+    }
+
+    @Override
+    public List<String> classificationLabels() {
+        return LANGUAGE_NAMES;
+    }
+
+    @Override
+    public void validate() {
+    }
+
+    @Override
+    public long estimatedNumOperations() {
+        long numOps = hiddenLayer.getBias().length; // adding bias
+        numOps += hiddenLayer.getWeights().length; // multiplying weights
+        numOps += softmaxLayer.getBias().length; // adding bias
+        numOps += softmaxLayer.getWeights().length; // multiplying softmax weights
+        return numOps;
+    }
+
+    @Override
+    public long ramBytesUsed() {
+        long size = SHALLOW_SIZE;
+        size += RamUsageEstimator.sizeOf(hiddenLayer);
+        size += RamUsageEstimator.sizeOf(softmaxLayer);
+        return size;
+    }
+
+    @Override
+    public String getWriteableName() {
+        return NAME.getPreferredName();
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeString(embeddedVectorFeatureName);
+        this.hiddenLayer.writeTo(out);
+        this.softmaxLayer.writeTo(out);
+    }
+
+    @Override
+    public String getName() {
+        return NAME.getPreferredName();
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.field(EMBEDDED_VECTOR_FEATURE_NAME.getPreferredName(), embeddedVectorFeatureName);
+        builder.field(HIDDEN_LAYER.getPreferredName(), hiddenLayer);
+        builder.field(SOFTMAX_LAYER.getPreferredName(), softmaxLayer);
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        LangIdentNeuralNetwork that = (LangIdentNeuralNetwork) o;
+        return Objects.equals(embeddedVectorFeatureName, that.embeddedVectorFeatureName)
+            && Objects.equals(hiddenLayer, that.hiddenLayer)
+            && Objects.equals(softmaxLayer, that.softmaxLayer);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(embeddedVectorFeatureName, hiddenLayer, softmaxLayer);
+    }
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangNetLayer.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangNetLayer.java
new file mode 100644
index 0000000000000..a14901296da0f
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangNetLayer.java
@@ -0,0 +1,175 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+package org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident;
+
+import org.apache.lucene.util.Accountable;
+import org.apache.lucene.util.RamUsageEstimator;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Objects;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
+/**
+ * Represents a single layer in the compressed Lang Net
+ */
+public class LangNetLayer implements ToXContentObject, Writeable, Accountable {
+
+    public static final ParseField NAME = new ParseField("lang_net_layer");
+    private static final long SHALLOW_SIZE = RamUsageEstimator.shallowSizeOfInstance(LangNetLayer.class);
+
+    public static final ParseField NUM_ROWS = new ParseField("num_rows");
+    public static final ParseField NUM_COLS = new ParseField("num_cols");
+    public static final ParseField WEIGHTS = new ParseField("weights");
+    public static final ParseField BIAS = new ParseField("bias");
+
+    public static final ConstructingObjectParser<LangNetLayer, Void> STRICT_PARSER = createParser(false);
+    public static final ConstructingObjectParser<LangNetLayer, Void> LENIENT_PARSER = createParser(true);
+
+
+    @SuppressWarnings("unchecked")
+    private static ConstructingObjectParser<LangNetLayer, Void> createParser(boolean lenient) {
+        ConstructingObjectParser<LangNetLayer, Void> parser = new ConstructingObjectParser<>(
+            NAME.getPreferredName(),
+            lenient,
+            a -> new LangNetLayer(
+                (List<Double>) a[0],
+                (int) a[1],
+                (int) a[2],
+                (List<Double>) a[3]));
+        parser.declareDoubleArray(constructorArg(), WEIGHTS);
+        parser.declareInt(constructorArg(), NUM_COLS);
+        parser.declareInt(constructorArg(), NUM_ROWS);
+        parser.declareDoubleArray(constructorArg(), BIAS);
+        return parser;
+    }
+
+    private final double[] weights;
+    private final int weightRows;
+    private final int weightCols;
+    private final double[] bias;
+
+    private LangNetLayer(List<Double> weights, int numCols, int numRows, List<Double> bias) {
+        this(weights.stream().mapToDouble(Double::doubleValue).toArray(),
+            numCols,
+            numRows,
+            bias.stream().mapToDouble(Double::doubleValue).toArray());
+    }
+
+    LangNetLayer(double[] weights, int numCols, int numRows, double[] bias) {
+        this.weights = weights;
+        this.weightCols = numCols;
+        this.weightRows = numRows;
+        this.bias = bias;
+        if (weights.length != numCols * numRows) {
+            throw ExceptionsHelper.badRequestException("malformed network layer. Total vector size [{}] does not equal [{}] x [{}].",
+                weights.length,
+                numCols,
+                numRows);
+        }
+    }
+
+    LangNetLayer(StreamInput in) throws IOException {
+        this.weights = in.readDoubleArray();
+        this.bias = in.readDoubleArray();
+        this.weightRows = in.readInt();
+        this.weightCols = in.readInt();
+    }
+
+    double[] productPlusBias(boolean applyRelu, double[] x) {
+        double[] y = Arrays.copyOf(bias, bias.length);
+
+        for (int i = 0; i < x.length; ++i) {
+            double scale = x[i];
+            if (applyRelu) {
+                if (scale > 0) {
+                    for (int j = 0; j < y.length; ++j) {
+                        y[j] += weights[rowMajorIndex(i, weightCols, j)] * scale;
+                    }
+                }
+            } else {
+                for (int j = 0; j < y.length; ++j) {
+                    y[j] += weights[rowMajorIndex(i, weightCols, j)] * scale;
+                }
+            }
+        }
+        return y;
+    }
+
+    private static int rowMajorIndex(int row, int colDim, int col) {
+        return row * colDim + col;
+    }
+
+    double[] getWeights() {
+        return weights;
+    }
+
+    int getWeightRows() {
+        return weightRows;
+    }
+
+    int getWeightCols() {
+        return weightCols;
+    }
+
+    double[] getBias() {
+        return bias;
+    }
+
+    @Override
+    public long ramBytesUsed() {
+        long size = SHALLOW_SIZE;
+        size += RamUsageEstimator.sizeOf(weights);
+        size += RamUsageEstimator.sizeOf(bias);
+        return size;
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeDoubleArray(weights);
+        out.writeDoubleArray(bias);
+        out.writeInt(weightRows);
+        out.writeInt(weightCols);
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.field(NUM_COLS.getPreferredName(), weightCols);
+        builder.field(NUM_ROWS.getPreferredName(), weightRows);
+        builder.field(WEIGHTS.getPreferredName(), weights);
+        builder.field(BIAS.getPreferredName(), bias);
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        LangNetLayer that = (LangNetLayer) o;
+        return Arrays.equals(weights, that.weights)
+            && Arrays.equals(bias, that.bias)
+            && Objects.equals(weightCols, that.weightCols)
+            && Objects.equals(weightRows, that.weightRows);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(Arrays.hashCode(weights), Arrays.hashCode(bias), weightCols, weightRows);
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/CustomWordEmbeddingTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/CustomWordEmbeddingTests.java
new file mode 100644
index 0000000000000..dbdbb2822aa0b
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/CustomWordEmbeddingTests.java
@@ -0,0 +1,51 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+
+
+public class CustomWordEmbeddingTests extends PreProcessingTests<CustomWordEmbedding> {
+
+    @Override
+    protected CustomWordEmbedding doParseInstance(XContentParser parser) throws IOException {
+        return lenient ? CustomWordEmbedding.fromXContentLenient(parser) : CustomWordEmbedding.fromXContentStrict(parser);
+    }
+
+    @Override
+    protected CustomWordEmbedding createTestInstance() {
+        return createRandom();
+    }
+
+    public static CustomWordEmbedding createRandom() {
+        int quantileSize = randomIntBetween(1, 10);
+        int internalQuantSize = randomIntBetween(1, 10);
+        short[][] quantiles = new short[quantileSize][internalQuantSize];
+        for (int i = 0; i < quantileSize; i++) {
+            for (int j = 0; j < internalQuantSize; j++) {
+                quantiles[i][j] = randomShort();
+            }
+        }
+        int weightsSize = randomIntBetween(1, 10);
+        int internalWeightsSize = randomIntBetween(1, 10);
+        byte[][] weights = new byte[weightsSize][internalWeightsSize];
+        for (int i = 0; i < weightsSize; i++) {
+            for (int j = 0; j < internalWeightsSize; j++) {
+                weights[i][j] = randomByte();
+            }
+        }
+        return new CustomWordEmbedding(quantiles, weights, randomAlphaOfLength(10), randomAlphaOfLength(10));
+    }
+
+    @Override
+    protected Writeable.Reader<CustomWordEmbedding> instanceReader() {
+        return CustomWordEmbedding::new;
+    }
+
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureUtilsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureUtilsTests.java
new file mode 100644
index 0000000000000..61f302ccb7e9e
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/FeatureUtilsTests.java
@@ -0,0 +1,73 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.elasticsearch.test.ESTestCase;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+
+public class FeatureUtilsTests extends ESTestCase {
+
+    public void testValidUTF8Length() {
+        {
+            // Truncate to UTF8 boundary (no cut)
+            String strAZ = " a az qalıb breyn rinq intellektual oyunu üzrə yarışın zona mərhələləri " +
+                "keçirilib miq un qalıqlarının dənizdən çıxarılması davam edir məhəmməd " +
+                "peyğəmbərin karikaturalarını";
+
+            String truncated = FeatureUtils.truncateToNumValidBytes(strAZ, 200);
+            assertThat(truncated, equalTo(strAZ));
+        }
+        {
+            // Truncate to UTF8 boundary (cuts)
+            String strBE = " а друкаваць іх не было т�хнічна магчыма бліж�й за вільню тым �амым ча�ам " +
+                "н�мецкае кіраўніцтва прапаноўвала апроч ўв�дзенн� лацінкі �е";
+
+            String truncated = FeatureUtils.truncateToNumValidBytes(strBE, 200);
+            assertThat(truncated, equalTo(" а друкаваць іх не было т�хнічна магчыма бліж�й за вільню тым �амым ча�ам " +
+                "н�мецкае кіраўніцтва прапаноўвала "));
+        }
+        {
+            // Don't truncate
+            String strAR = "احتيالية بيع أي حساب";
+
+            String truncated = FeatureUtils.truncateToNumValidBytes(strAR, 200);
+            assertThat(truncated, equalTo(strAR));
+        }
+        {
+            // Truncate to UTF8 boundary (cuts)
+            String strZH = "产�的简报和公告 �交该申请�无法进行更改 请确认您的选择是正确的 " +
+                "对于��交的图书 我确认 我是版�所有者或已得到版�所有者的授� " +
+                "�更改您的国家 地区 请在此表的最上端更改您的";
+
+            String truncated = FeatureUtils.truncateToNumValidBytes(strZH, 200);
+            assertThat(truncated, equalTo("产�的简报和公告 �交该申请�无法进行更改 请确认您的选择是正确的 " +
+                "对于��交的图书 我确认 我是版�所有者或已得到版�所有者的授� " +
+                "�更改"));
+        }
+    }
+
+    public void testCleanText() {
+        assertThat(FeatureUtils.cleanAndLowerText("This has a tag in <br> it <ssss>&..///1/2@@3winter"),
+            equalTo(" this has a tag in br it ssss winter "));
+
+        assertThat(FeatureUtils.cleanAndLowerText(" This has a tag in <br> it <ssss>&..///1/2@@3winter "),
+            equalTo(" this has a tag in br it ssss winter "));
+
+        assertThat(FeatureUtils.cleanAndLowerText(" This has a tag in <p> it </p><ssss>&..///1/2@@3winter "),
+            equalTo(" this has a tag in p it p ssss winter "));
+
+        assertThat(FeatureUtils.cleanAndLowerText("  This has a tag in \n<p> it \r\n</p><ssss>&..///1/2@@3winter "),
+            equalTo(" this has a tag in p it p ssss winter "));
+
+        assertThat(FeatureUtils.cleanAndLowerText(" !This has    a tag.in\n+|iW£#   <p> hello\nit </p><ssss>&..///1/2@@3winter "),
+            equalTo(" this has a tag in iw p hello it p ssss winter "));
+
+        assertThat(FeatureUtils.cleanAndLowerText("北京——。"), equalTo(" 北京 "));
+        assertThat(FeatureUtils.cleanAndLowerText("北京——中国共产党已为国家主席习近平或许无�期地继续执政扫清了�路。"),
+            equalTo(" 北京 中国共产党已为国家主席习近平或许无�期地继续执政扫清了�路 "));
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/Hash32Tests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/Hash32Tests.java
new file mode 100644
index 0000000000000..cfeeb4d1220a2
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/Hash32Tests.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.elasticsearch.test.ESTestCase;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+
+public class Hash32Tests extends ESTestCase {
+
+    public void testHash32WithDefaultSeed() {
+        Hash32 hash32 = new Hash32();
+
+        assertThat(hash32.hash("$"), equalTo(3182025368L));
+        assertThat(hash32.hash("t"), equalTo(138132021L));
+        assertThat(hash32.hash("i"), equalTo(2965039166L));
+        assertThat(hash32.hash("l"), equalTo(1580082402L));
+        assertThat(hash32.hash("^"), equalTo(2207093652L));
+
+        assertThat(hash32.hash("in"), equalTo(4112208493L));
+        assertThat(hash32.hash("en"), equalTo(2079238153L));
+        assertThat(hash32.hash("^$"), equalTo(4032735838L));
+        assertThat(hash32.hash("tt"), equalTo(817858275L));
+        assertThat(hash32.hash("it"), equalTo(1589737287L));
+        assertThat(hash32.hash("n$"), equalTo(2413977248L));
+
+        assertThat(hash32.hash("rit"), equalTo(1921565252L));
+        assertThat(hash32.hash("^in"), equalTo(2446331876L));
+        assertThat(hash32.hash("tte"), equalTo(1722883625L));
+        assertThat(hash32.hash("^is"), equalTo(1526307372L));
+        assertThat(hash32.hash("^wr"), equalTo(2206189520L));
+
+        assertThat(hash32.hash("^is$"), equalTo(790119734L));
+        assertThat(hash32.hash("glis"), equalTo(3888555831L));
+        assertThat(hash32.hash("^tex"), equalTo(260719639L));
+        assertThat(hash32.hash("text"), equalTo(1712111248L));
+        assertThat(hash32.hash("ritt"), equalTo(3582828510L));
+
+        assertThat(hash32.hash("다"), equalTo(2787769683L));
+        assertThat(hash32.hash("세"), equalTo(1500228512L));
+        assertThat(hash32.hash("습"), equalTo(2218653723L));
+        assertThat(hash32.hash("í• "), equalTo(3913427461L));
+        assertThat(hash32.hash("ì—¬"), equalTo(2765963430L));
+
+        assertThat(hash32.hash("한$"), equalTo(2241076599L));
+        assertThat(hash32.hash("다$"), equalTo(1903255056L));
+        assertThat(hash32.hash("니다"), equalTo(2071203213L));
+        assertThat(hash32.hash("있습"), equalTo(530856195L));
+        assertThat(hash32.hash("수$"), equalTo(681457790L));
+
+        assertThat(hash32.hash("�트$"), equalTo(3931486187L));
+        assertThat(hash32.hash("습니다"), equalTo(3371415996L));
+        assertThat(hash32.hash("^리�"), equalTo(3050042250L));
+        assertThat(hash32.hash("권한$"), equalTo(2791953805L));
+
+        assertThat(hash32.hash("습니다$"), equalTo(2290190997L));
+        assertThat(hash32.hash("^있습니"), equalTo(2954770380L));
+        assertThat(hash32.hash("^권한$"), equalTo(3837435447L));
+        assertThat(hash32.hash("부여할$"), equalTo(815437673L));
+        assertThat(hash32.hash("^부여할"), equalTo(151570116L));
+
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/NGramFeatureExtractorTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/NGramFeatureExtractorTests.java
new file mode 100644
index 0000000000000..e81205c0f593c
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/NGramFeatureExtractorTests.java
@@ -0,0 +1,294 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.DeprecationHandler;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident.LanguageExamples;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.IntStream;
+
+import static org.elasticsearch.xpack.core.ml.inference.preprocessing.CustomWordEmbedding.MAX_STRING_SIZE_IN_BYTES;
+import static org.hamcrest.Matchers.closeTo;
+import static org.hamcrest.Matchers.equalTo;
+
+public class NGramFeatureExtractorTests extends ESTestCase {
+
+    /**
+     * Known failing languages (due to string pre-processing) and why
+     *
+     * This does not mean that these languages are not accurately chosen when necessary, just that the golden result text did extra
+     *  processing for efficiency reasons that are not currently done.
+     *
+     *  - Bengali ("bn") does not get mutated by String#toLowerCase skipping it in tests for now
+     *  - Bosnian ("bs") sections of the text removed
+     *  - Croatian ("hr") inexplicable extra white space surrounding " κυαξα�ης " in processed text
+     *  - French ("fr") "créer ni supprimer des collections enfin il a accès a" removed
+     *  - Hausa ("ha") removes many words final process text looks like " a cikin a kan sakamako daga sakwannin a kan kafar "
+     *  - Hindi ("hi") removes " विज�ञापनों का अधिकतम लाभ " from the end of the text
+     *  - Haitian Creole ("ht") The text " pitit leta fèt pou ba yo konkoul menm jan tou pou timoun " is removed
+     *  - Hungarian ("hu") CLD3 removed language in text processing
+     *  - Igbo ("ig") CLD3 removed language in text processing
+     *  - Icelandic ("is") CLD3 removed language in text processing
+     *  - Maori ("mi") CLD3 removed language in text processing
+     *  - Mongolian ("mn") text " журам болов�руулах орон нутгийн " removed
+     *  - Marathi ("mr") CLD3 removed language in text processing
+     *  - Malay ("ms") CLD3 removed language in text processing
+     *  - Nepali ("ne") CLD3 removed language in text processing
+     *  - Punjabi ("pa") CLD3 removed language in text processing
+     *  - Tajik ("tg") CLD3 removed language in text processing
+     *  - Turkish ("tr") CLD3 removed language in text processing
+     *  - Zulu ("zu") CLD3 removed language in text processing
+     */
+    private static final Map<String, String> KNOWN_PROCESSING_FAILURE_LANGUAGES = new HashMap<>();
+    static {
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("bn",
+            "�নপির ওয়াক আউট তপন চৌধ�রী হারবাল অ�যাসোসিয়েশনের সভাপতি " +
+                "আন�তর�জাতিক পরামর ালিকপক�ষের কান�না শ�রমিকের অনিশ�চয়তা মতি�িলে সমাবেশ " +
+                "নিষিদ�ধ �ফবিসিসিআইয় ের গ�র�যান�ডমাস�টার সিজন ব�রাজিলে বিশ�বকাপ ফ�টবল" +
+                " আয়োজনবিরোধী বিক�ষোভ দেশ ের দক�ষতা ও যোগ�যতার পাশাপাশি তারা " +
+                "জাতীয় ইস�য�গ�লোতে প�রাধান�য দিয়েছেন প া যাবে কি �কজন দর�শকের " +
+                "�মন প�রশ�নে জবাবে আব�দ�ল�লাহ আল নোমান বলেন �ই �রতিন ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("bs",
+            " novi predsjednik mešihata islamske zajednice u srbiji izus i muftija dr mevlud ef dudić izjavio je u intervjuu za anadolu" +
+                " agency aa kako je uvjeren da će doći do vraćanja jedinstva među muslimanima i unutar islamske zajednice na " +
+                "prostoru sandžaka te da je njegova ruka pružena za povratak svih u okrilje islamske zajednice u srbiji nakon " +
+                "skoro sedam godina podjela u tom u srbiji izabran januara a zvani�na inauguracija će biti obavljena u prvoj polovini " +
+                "februara kako se o�ekuje prisustvovat će joj i reisu l koji će i zvani�no promovirati dudića boraviti u prvoj" +
+                " zvani�noj posjeti reisu kavazoviću što je njegov privi simboli�ni potez nakon imenovanja ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("fr",
+            " a accès aux collections et aux frontaux qui lui ont été attribués il peut consulter et modifier ses collections et" +
+                " exporter des configurations de collection toutefois il ne peut pas aux fonctions ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("ha", " a cikin a kan sakamako daga sakwannin a kan kafar ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("hi", " ं �डवर�ड�स विज�ञापनों के अन�भव पर आधारित हैं और इनकी मदद से आपको अपने ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("hr",
+            " posljednja dva vladara su kijaksar  κυαξα�ης  prije krista fraortov sin koji će proširiti teritorij medije i " +
+                "astijag kijaksar je imao kćer ili unuku koja se zvala amitis a postala je ženom nabukodonosora ii kojoj je " +
+                "ovaj izgradio viseće vrtove babilona kijaksar je modernizirao svoju vojsku i uništio ninivu prije krista naslijedio " +
+                "ga je njegov sin posljednji medijski kralj astijag kojega je detronizirao srušio sa vlasti njegov unuk kir veliki" +
+                " zemljom su zavladali perzijanci hrvatska je zemlja situacija u europi ona ima bogatu kulturu i ukusna jela ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("ht",
+            " ak pitit tout sosyete a chita se pou sa leta dwe pwoteje yo nimewo leta fèt pou li pwoteje tout paran ak pitit nan " +
+                "peyi a menm jan kit paran yo marye kit yo pa marye tout manman ki fè piti ak pou ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("hu",
+            " a felhasználóim a google azonosító szöveget fogják látni minden tranzakció után ha a vásárlását regisztrációját oldalunk ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("ig", " chineke bụ aha �z� ndï omenala igbo kp�ro chukwu mgbe ndị bekee bịara ha " +
+            "mee ya nke ndi christian n echiche ndi ekpere chi omenala ndi igbo christianity judaism ma islam chineke nwere �tụtụ " +
+            "utu aha ma nwee nanị otu aha ụz� abụ� e si akp� aha ahụ bụ jehovah ma � bụ yahweh na �tụtụ akwụkw� ns� e wepụla aha" +
+            " chineke ma jiri utu aha bụ onyenwe anyị ma � bụ chineke dochie ya pụtara n ime ya ihe dị ka ugboro pụkụ asaa ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("is",
+            " a afköst leitarorða þinna leitarorð neikvæð leitarorð auglýsingahópa byggja upp og skoða ítarleg gögn um árangur " +
+                "leitarorða eins og samkeppni auglýsenda og leitarmagn er krafist notkun ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("mi",
+            " haere ki te kainga o o haere ki te kainga o o kainga o ka tangohia he ki to rapunga kaore au mohio te tikanga" +
+                " whakatiki o te ra he nga awhina o te ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("mn",
+            " а болов�ронгуй болгох орон нутгийн ажил үйл�ийг у�лдуулж зохицуулах дүр�м өмч хөрөнгө �анхүүгийн ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("mr",
+            " हैदराबाद उच�चार �का सहाय�य माहिती तेल�गू  హైదరాబాద�  उर�दू  حیدر آباد  हे भारतातील" +
+                " आंध�र प�रदेश राज�याच�या राजधानीचे शहर आहे हैदराबादची लोकसंख�या " +
+                "लाख हजार आहे मोत�यांचे शहर अशी �केकाळी ओळख असलेल�या या शहराला �तिहासिक " +
+                "सांस�कृतिक आणि स�थापत�यशास�त�रीय वारसा लाभला आहे नंतर त�याचप�रमाणे " +
+                "औषधनिर�मिती आणि उद�योगधंद�यांची वाढ शहरात �ाली दक�षिण मध�य तेल�गू केंद�र आहे ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("ms",
+            " pengampunan beramai ramai supaya mereka pulang ke rumah masing masing orang orang besarnya enggan " +
+                "mengiktiraf sultan yang dilantik oleh belanda sebagai yang dipertuan selangor orang ramai pula " +
+                "tidak mahu menjalankan perniagaan bijih timah dengan belanda selagi raja yang berhak tidak ditabalkan " +
+                "perdagang yang lain dibekukan terus kerana untuk membalas jasa beliau yang membantu belanda menentang " +
+                "riau johor dan selangor di antara tiga orang sultan juga dipandang oleh rakyat ganti sultan ibrahim ditabalkan" +
+                " raja muhammad iaitu raja muda walaupun baginda bukan anak isteri pertama bergelar sultan muhammad " +
+                "ioleh cina di lukut tidak diambil tindakan sedangkan baginda sendiri banyak berhutang kepada ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("ne",
+            " अरू ठाऊ�बाटपनि ख�लेको छ यो खाता अर ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("pa",
+            " ਂ ਦਿਨਾਂ ਵਿਚ ਭਾਈ ਸਾਹਿਬ ਦੀ ਬ�ੱਚੜ ਗੋਬਿੰਦ ਰਾਮ ਨਾਲ ਅੜਫਸ ਚੱਲ ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("tg",
+            " адолат ва ин�ондӯ�тиро бар фашизм нажодпара�тӣ ва адоват тарҷеҳ додаа�т чоп кунед ба дигарон фири�тед ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("tr",
+            " a ayarlarınızı görmeniz ve yönetmeniz içindir eğer kampanyanız için günlük bütçenizi gözden geçirebileceğiniz " +
+                "yeri ve kampanya ayarlarını düzenle yi tıklayın sunumu ");
+        KNOWN_PROCESSING_FAILURE_LANGUAGES.put("zu",
+            " ana engu uma inkinga iqhubeka siza ubike kwi isexwayiso ngenxa yephutha lomlekeleli sikwazi ukubuyisela " +
+                "emuva kuphela imiphumela engaqediwe ukuthola imiphumela eqediwe zama ukulayisha siza uthumele ");
+    }
+
+    private String processedText(String language, List<LanguageExamples.LanguageExampleEntry> languages) {
+        if (KNOWN_PROCESSING_FAILURE_LANGUAGES.containsKey(language)) {
+            return KNOWN_PROCESSING_FAILURE_LANGUAGES.get(language);
+        }
+        String text = null;
+        for (LanguageExamples.LanguageExampleEntry goldenLang : languages) {
+            if (goldenLang.getLanguage().equals(language)) {
+                text = goldenLang.getText();
+                break;
+            }
+        }
+        if (text == null) {
+            fail("unable to find text for language: " + language);
+        }
+        text = FeatureUtils.cleanAndLowerText(text);
+        return FeatureUtils.truncateToNumValidBytes(text, MAX_STRING_SIZE_IN_BYTES);
+    }
+
+    public void testExtractor() throws Exception {
+        List<LanguageExamples.LanguageExampleEntry> entries = new LanguageExamples().getLanguageExamples();
+        for (NGramFeatureExtractorTests.NGramExampleEntry entry : getGoldenNGrams()) {
+            String text = processedText(entry.language, entries);
+
+            Integer[] sortedIndices = IntStream.range(0, entry.nGrams.length)
+                .boxed()
+                .sorted(Comparator.comparing((i) -> entry.nGrams[i]))
+                .toArray(Integer[]::new);
+            double[] orderedWeights = new double[entry.weights.length];
+            int[] orderedIds = new int[entry.ids.length];
+            for(int i = 0; i < entry.nGrams.length; i++) {
+                orderedIds[i] = entry.ids[sortedIndices[i]];
+                orderedWeights[i] = entry.weights[sortedIndices[i]];
+            }
+            FeatureValue[] features = new NGramFeatureExtractor(entry.nGramSize, entry.dimension).extractFeatures(text);
+
+            int[] extractedIds = Arrays.stream(features).map(FeatureValue::getRow).mapToInt(Integer::valueOf).toArray();
+            double[] extractedWeights = Arrays.stream(features).map(FeatureValue::getWeight).mapToDouble(Double::valueOf).toArray();
+
+            String msg = "for language [" + entry.language + "] dimension [" + entry.dimension + "] ngrams [" + entry.nGramSize + "]";
+            assertThat("weights length mismatch " + msg, extractedWeights.length, equalTo(entry.weights.length));
+            assertThat("ids length mismatch " + msg, extractedIds.length, equalTo(entry.ids.length));
+            for(int i = 0; i < extractedIds.length; i++) {
+                String assertMessage = "ids mismatch for id [" + i + "] and " + msg;
+                assertThat(assertMessage, extractedIds[i], equalTo(orderedIds[i]));
+            }
+
+            double eps = 0.00001;
+            for(int i = 0; i < extractedWeights.length; i++) {
+                String assertMessage = " Difference [" + Math.abs(extractedWeights[i] - entry.weights[i]) + "]" +
+                    "weights mismatch for weight [" + i + "] and " + msg;
+                assertThat(
+                    assertMessage,
+                    extractedWeights[i],
+                    closeTo(orderedWeights[i], eps));
+            }
+
+        }
+    }
+
+    /**
+     * These nGram examples were created through running Google's CLD3 network
+     */
+    public List<NGramFeatureExtractorTests.NGramExampleEntry> getGoldenNGrams() throws Exception {
+        String path = "/org/elasticsearch/xpack/core/ml/inference/ngram_examples.json";
+        try(XContentParser parser = XContentType.JSON.xContent().createParser(
+                NamedXContentRegistry.EMPTY,
+                DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
+                Files.newInputStream(getDataPath(path))) ) {
+            List<NGramFeatureExtractorTests.NGramExampleEntry> entries = new ArrayList<>();
+            while(parser.nextToken() != XContentParser.Token.END_ARRAY) {
+                entries.add(NGramFeatureExtractorTests.NGramExampleEntry.PARSER.apply(parser, null));
+            }
+            return entries;
+        }
+    }
+
+    public static class NGramExampleEntry implements ToXContentObject {
+
+        private static final ParseField LANGUAGE = new ParseField("language");
+        private static final ParseField NGRAMS = new ParseField("ngrams");
+        private static final ParseField WEIGHTS = new ParseField("weights");
+        private static final ParseField IDS = new ParseField("ids");
+        private static final ParseField DIMENSION = new ParseField("dimension");
+        private static final ParseField NGRAM_SIZE = new ParseField("ngram_size");
+
+        public static ObjectParser<NGramExampleEntry, Void> PARSER = new ObjectParser<>(
+            "ngram_example_entry",
+            true,
+            NGramExampleEntry::new);
+
+        static {
+            PARSER.declareString(NGramExampleEntry::setLanguage, LANGUAGE);
+            PARSER.declareStringArray(NGramExampleEntry::setnGrams, NGRAMS);
+            PARSER.declareDoubleArray(NGramExampleEntry::setWeights, WEIGHTS);
+            PARSER.declareIntArray(NGramExampleEntry::setIds, IDS);
+            PARSER.declareInt(NGramExampleEntry::setDimension, DIMENSION);
+            PARSER.declareInt(NGramExampleEntry::setnGramSize, NGRAM_SIZE);
+        }
+        String language;
+        String[] nGrams;
+        double[] weights;
+        int[] ids;
+        int dimension;
+        int nGramSize;
+
+        private NGramExampleEntry() {
+
+        }
+
+        public void setLanguage(String language) {
+            this.language = language;
+        }
+
+        public void setnGrams(String[] nGrams) {
+            this.nGrams = nGrams;
+        }
+
+        public void setWeights(double[] weights) {
+            this.weights = weights;
+        }
+
+        public void setWeights(List<Double> weights) {
+            setWeights(weights.stream().mapToDouble(Double::doubleValue).toArray());
+        }
+
+        public void setIds(int[] ids) {
+            this.ids = ids;
+        }
+
+        public void setIds(List<Integer> ids) {
+            setIds(ids.stream().mapToInt(Integer::intValue).toArray());
+        }
+
+        public void setDimension(int dimension) {
+            this.dimension = dimension;
+        }
+
+        public void setnGramSize(int nGramSize) {
+            this.nGramSize = nGramSize;
+        }
+
+        public void setnGrams(List<String> nGrams) {
+            setnGrams(nGrams.toArray(new String[0]));
+        }
+
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(LANGUAGE.getPreferredName(), language);
+            builder.field(WEIGHTS.getPreferredName(), weights);
+            builder.field(IDS.getPreferredName(), ids);
+            builder.field(NGRAMS.getPreferredName(), nGrams);
+            builder.field(NGRAM_SIZE.getPreferredName(), nGramSize);
+            builder.field(DIMENSION.getPreferredName(), dimension);
+            builder.endObject();
+            return builder;
+        }
+    }
+
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/RelevantScriptFeatureExtractorTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/RelevantScriptFeatureExtractorTests.java
new file mode 100644
index 0000000000000..b4263b6dd61d1
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/RelevantScriptFeatureExtractorTests.java
@@ -0,0 +1,99 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.elasticsearch.test.ESTestCase;
+
+import static org.hamcrest.Matchers.closeTo;
+import static org.hamcrest.Matchers.equalTo;
+
+public class RelevantScriptFeatureExtractorTests extends ESTestCase {
+    
+    private final RelevantScriptFeatureExtractor extractor = new RelevantScriptFeatureExtractor();
+
+    private static final double eps = 0.000001;
+
+    public void testNonMixedScripts() {
+        FeatureValue[] results;
+
+        results = extractor.extractFeatures("just some plain text");
+        assertThat(results.length, equalTo(1));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptOtherUtf8OneByte.toInt()));
+        assertThat(results[0].getWeight(), closeTo(1.0, eps));
+
+        results = extractor.extractFeatures("ヸヂ゠ヂ");
+        assertThat(results.length, equalTo(1));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptKatakana.toInt()));
+        assertThat(results[0].getWeight(), closeTo(1.0, eps));
+
+        // One UTF8 character by itself.
+        results = extractor.extractFeatures("ã‚Ÿ");
+        assertThat(results.length, equalTo(1));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptHiragana.toInt()));
+        assertThat(results[0].getWeight(), closeTo(1.0, eps));
+
+        results = extractor.extractFeatures("×”");
+        assertThat(results.length, equalTo(1));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptHebrew.toInt()));
+        assertThat(results[0].getWeight(), closeTo(1.0, eps));
+    }
+
+    public void testMixedScripts() {
+        FeatureValue[] results;
+
+        results = extractor.extractFeatures("ヸtヂe゠xtヂ");
+        assertThat(results.length, equalTo(2));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptOtherUtf8OneByte.toInt()));
+        assertThat(results[0].getWeight(), closeTo(0.5, eps));
+        assertThat(results[1].getRow(), equalTo(ScriptDetector.Script.kScriptKatakana.toInt()));
+        assertThat(results[1].getWeight(), closeTo(0.5, eps));
+
+        results = extractor.extractFeatures("just some 121212%^^( ヸヂ゠ヂ   text");
+        assertThat(results.length, equalTo(2));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptOtherUtf8OneByte.toInt()));
+        assertThat(results[0].getWeight(), closeTo(0.75, eps));
+        assertThat(results[1].getRow(), equalTo(ScriptDetector.Script.kScriptKatakana.toInt()));
+        assertThat(results[1].getWeight(), closeTo(0.25, eps));
+    }
+
+    public void testRelevantScriptFeatureCornerCases() {
+        FeatureValue[] results;
+
+        // Empty string.
+        results = extractor.extractFeatures("");
+        assertEquals(0, results.length);
+
+        // Only whitespaces.
+        results = extractor.extractFeatures("   ");
+        assertEquals(0, results.length);
+
+        // Only numbers and punctuation.
+        results = extractor.extractFeatures("12----)(");
+        assertEquals(0, results.length);
+
+        // Only numbers, punctuation, and spaces.
+        results = extractor.extractFeatures("12--- - ) ( ");
+        assertEquals(0, results.length);
+
+        // One UTF8 character with some numbers / punctuation / spaces: character at
+        // one extremity or in the middle.
+        results = extractor.extractFeatures("1234ã‚Ÿ");
+        assertThat(results.length, equalTo(1));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptHiragana.toInt()));
+        assertThat(results[0].getWeight(), closeTo(1.0, eps));
+
+        results = extractor.extractFeatures("ã‚Ÿ12-(");
+        assertThat(results.length, equalTo(1));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptHiragana.toInt()));
+        assertThat(results[0].getWeight(), closeTo(1.0, eps));
+
+        results = extractor.extractFeatures("8*1ã‚Ÿ12----");
+        assertThat(results.length, equalTo(1));
+        assertThat(results[0].getRow(), equalTo(ScriptDetector.Script.kScriptHiragana.toInt()));
+        assertThat(results[0].getWeight(), closeTo(1.0, eps));;
+    }
+
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptDetectorTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptDetectorTests.java
new file mode 100644
index 0000000000000..a94fd9981a62d
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptDetectorTests.java
@@ -0,0 +1,103 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.elasticsearch.test.ESTestCase;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.CoreMatchers.not;
+
+public class ScriptDetectorTests extends ESTestCase {
+
+    public void testGreekScript() {
+        assertThat(ScriptDetector.Script.fromCodePoint("Í°".codePointAt(0)), is(ScriptDetector.Script.kScriptGreek));
+        assertThat(ScriptDetector.Script.fromCodePoint("Ï¿".codePointAt(0)), is(ScriptDetector.Script.kScriptGreek));
+        assertThat(ScriptDetector.Script.fromCodePoint("δ".codePointAt(0)), is(ScriptDetector.Script.kScriptGreek));
+        assertThat(ScriptDetector.Script.fromCodePoint("Θ".codePointAt(0)), is(ScriptDetector.Script.kScriptGreek));
+        assertThat(ScriptDetector.Script.fromCodePoint("Δ".codePointAt(0)), is(ScriptDetector.Script.kScriptGreek));
+        assertThat(ScriptDetector.Script.fromCodePoint("a".codePointAt(0)), is(not(ScriptDetector.Script.kScriptGreek)));
+        assertThat(ScriptDetector.Script.fromCodePoint("a".codePointAt(0)), is(not(ScriptDetector.Script.kScriptGreek)));
+    }
+
+    public void testCyrillicScript() {
+        assertThat(ScriptDetector.Script.fromCodePoint("Ѐ".codePointAt(0)), is(ScriptDetector.Script.kScriptCyrillic));
+        assertThat(ScriptDetector.Script.fromCodePoint("Ó¿".codePointAt(0)), is(ScriptDetector.Script.kScriptCyrillic));
+        assertThat(ScriptDetector.Script.fromCodePoint("ш".codePointAt(0)), is(ScriptDetector.Script.kScriptCyrillic));
+        assertThat(ScriptDetector.Script.fromCodePoint("Б".codePointAt(0)), is(ScriptDetector.Script.kScriptCyrillic));
+        assertThat(ScriptDetector.Script.fromCodePoint("Ó°".codePointAt(0)), is(ScriptDetector.Script.kScriptCyrillic));
+    }
+
+    public void testHebrewScript() {
+        assertThat(ScriptDetector.Script.fromCodePoint("Ö‘".codePointAt(0)), is(ScriptDetector.Script.kScriptHebrew));
+        assertThat(ScriptDetector.Script.fromCodePoint("×´".codePointAt(0)), is(ScriptDetector.Script.kScriptHebrew));
+        assertThat(ScriptDetector.Script.fromCodePoint("ד".codePointAt(0)), is(ScriptDetector.Script.kScriptHebrew));
+        assertThat(ScriptDetector.Script.fromCodePoint("×”".codePointAt(0)), is(ScriptDetector.Script.kScriptHebrew));
+        assertThat(ScriptDetector.Script.fromCodePoint("צ".codePointAt(0)), is(ScriptDetector.Script.kScriptHebrew));
+    }
+
+    public void testArabicScript() {
+        assertThat(ScriptDetector.Script.fromCodePoint("Ù…".codePointAt(0)), is(ScriptDetector.Script.kScriptArabic));
+        assertThat(ScriptDetector.Script.fromCodePoint("Ø®".codePointAt(0)), is(ScriptDetector.Script.kScriptArabic));
+    }
+
+    public void testHangulJamoScript() {
+        assertThat(ScriptDetector.Script.fromCodePoint("á„€".codePointAt(0)), is(ScriptDetector.Script.kScriptHangulJamo));
+        assertThat(ScriptDetector.Script.fromCodePoint("ᇿ".codePointAt(0)), is(ScriptDetector.Script.kScriptHangulJamo));
+        assertThat(ScriptDetector.Script.fromCodePoint("á„¡".codePointAt(0)), is(ScriptDetector.Script.kScriptHangulJamo));
+        assertThat(ScriptDetector.Script.fromCodePoint("ᆅ".codePointAt(0)), is(ScriptDetector.Script.kScriptHangulJamo));
+        assertThat(ScriptDetector.Script.fromCodePoint("á…˜".codePointAt(0)), is(ScriptDetector.Script.kScriptHangulJamo));
+    }
+
+    public void testHiraganaScript() {
+        assertThat(ScriptDetector.Script.fromCodePoint("�".codePointAt(0)), is(ScriptDetector.Script.kScriptHiragana));
+        assertThat(ScriptDetector.Script.fromCodePoint("ã‚Ÿ".codePointAt(0)), is(ScriptDetector.Script.kScriptHiragana));
+        assertThat(ScriptDetector.Script.fromCodePoint("�".codePointAt(0)), is(ScriptDetector.Script.kScriptHiragana));
+        assertThat(ScriptDetector.Script.fromCodePoint("ã‚„".codePointAt(0)), is(ScriptDetector.Script.kScriptHiragana));
+        assertThat(ScriptDetector.Script.fromCodePoint("�".codePointAt(0)), is(ScriptDetector.Script.kScriptHiragana));
+    }
+
+    public void testKatakanaScript() {
+        assertThat(ScriptDetector.Script.fromCodePoint("ã‚ ".codePointAt(0)), is(ScriptDetector.Script.kScriptKatakana));
+        assertThat(ScriptDetector.Script.fromCodePoint("ヿ".codePointAt(0)), is(ScriptDetector.Script.kScriptKatakana));
+        assertThat(ScriptDetector.Script.fromCodePoint("ヂ".codePointAt(0)), is(ScriptDetector.Script.kScriptKatakana));
+        assertThat(ScriptDetector.Script.fromCodePoint("ザ".codePointAt(0)), is(ScriptDetector.Script.kScriptKatakana));
+        assertThat(ScriptDetector.Script.fromCodePoint("ヸ".codePointAt(0)), is(ScriptDetector.Script.kScriptKatakana));
+    }
+
+    public void testOtherOneByte() {
+        assertThat(ScriptDetector.Script.fromCodePoint("^".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8OneByte));
+        assertThat(ScriptDetector.Script.fromCodePoint("$".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8OneByte));
+    }
+
+    public void testOtherTwoBytes() {
+        // Unrecognized 2-byte scripts.  For info on the scripts mentioned below, see
+        // http://www.unicode.org/charts/#scripts Note: the scripts below are uniquely
+        // associated with a language.  Still, the number of queries in those
+        // languages is small and we didn't want to increase the code size and
+        // latency, so (at least for now) we do not treat them specially.
+        // The following three tests are, respectively, for Armenian, Syriac and
+        // Thaana.
+        assertThat(ScriptDetector.Script.fromCodePoint("Õ�".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8TwoBytes));
+        assertThat(ScriptDetector.Script.fromCodePoint("Ü”".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8TwoBytes));
+        assertThat(ScriptDetector.Script.fromCodePoint("Þ�".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8TwoBytes));
+    }
+
+    public void testOtherThreeBytes() {
+        // Unrecognized 3-byte script: CJK Unified Ideographs. Not uniquely associated with a language.
+        assertThat(ScriptDetector.Script.fromCodePoint("万".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8ThreeBytes));
+        assertThat(ScriptDetector.Script.fromCodePoint("両".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8ThreeBytes));
+    }
+
+    public void testOtherFourBytes() {
+        // Unrecognized 4-byte script: CJK Unified Ideographs Extension C. Not uniquely associated with a language.
+        assertThat(ScriptDetector.Script.fromCodePoint("𪩘".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8FourBytes));
+
+        // Unrecognized 4-byte script: CJK Unified Ideographs Extension E. Not uniquely associated with a language.
+        assertThat(ScriptDetector.Script.fromCodePoint("𫢸".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8FourBytes));
+        assertThat(ScriptDetector.Script.fromCodePoint("𫫇".codePointAt(0)), is(ScriptDetector.Script.kScriptOtherUtf8FourBytes));
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptFeatureExtractorTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptFeatureExtractorTests.java
new file mode 100644
index 0000000000000..4367db6f5e9bb
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/preprocessing/customwordembedding/ScriptFeatureExtractorTests.java
@@ -0,0 +1,51 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+
+package org.elasticsearch.xpack.core.ml.inference.preprocessing.customwordembedding;
+
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident.LanguageExamples;
+
+import java.io.IOException;
+import java.util.List;
+
+public class ScriptFeatureExtractorTests extends ESTestCase {
+
+    private void testScriptId(String text, ScriptCode expected) {
+        long actual = ScriptFeatureExtractor.getScriptFeatureValue(text);
+        assertEquals(expected.toInt(), actual);
+    }
+
+    public void testBasicExamples() {
+        testScriptId("food", ScriptCode.Latin);
+        testScriptId("å­—", ScriptCode.Hani);
+        testScriptId("워드", ScriptCode.MAX_SCRIPT_CODE);
+    }
+
+    public void testSimpleJa() {
+        testScriptId("オリンピック大会", ScriptCode.Hani);
+        testScriptId("��ん�� クラス� �よ��� も�よ���", ScriptCode.Hani);
+    }
+
+    public void testAllExamples() throws IOException {
+
+        // compare against cld3 expected text type
+        long[] expected = new long[]{1, 6, 1, 3, 3, 10, 1, 1, 1, 1, 1, 1, 1, 2, 1, 1, 1, 1, 1, 6, 1, 1, 1, 1, 1, 12, 1, 9, 1, 1, 1, 1,
+            4, 1, 1, 1, 1, 5, 24, 1, 23, 3, 30, 16, 102, 1, 20, 1, 1, 1, 1, 3, 17, 3, 9, 1, 1, 22, 9, 1, 1, 1, 11, 1, 1, 1, 3, 18, 1,
+            1, 1, 1, 3, 1, 1, 1, 1, 14, 15, 3, 19, 1, 3, 6, 1, 1, 5, 1, 24, 1};
+
+        List<LanguageExamples.LanguageExampleEntry> entries = new LanguageExamples().getLanguageExamples();
+        assertEquals(expected.length, entries.size());
+        for (int i = 0; i < entries.size(); ++i) {
+            String text = entries.get(i).getText();
+
+            assertEquals(expected[i], ScriptFeatureExtractor.getScriptFeatureValue(text));
+        }
+    }
+
+}
+
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetworkTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetworkTests.java
new file mode 100644
index 0000000000000..118c2f5d62751
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetworkTests.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
+import org.junit.Before;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+
+public class LangIdentNeuralNetworkTests extends AbstractSerializingTestCase<LangIdentNeuralNetwork> {
+
+    private boolean lenient;
+
+    @Before
+    public void chooseStrictOrLenient() {
+        lenient = randomBoolean();
+    }
+
+    @Override
+    protected LangIdentNeuralNetwork doParseInstance(XContentParser parser) throws IOException {
+        return lenient ? LangIdentNeuralNetwork.fromXContentLenient(parser) : LangIdentNeuralNetwork.fromXContentStrict(parser);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return lenient;
+    }
+
+    @Override
+    protected LangIdentNeuralNetwork createTestInstance() {
+        return createRandom();
+    }
+
+    public static LangIdentNeuralNetwork createRandom() {
+        return new LangIdentNeuralNetwork(randomAlphaOfLength(10),
+            LangNetLayerTests.createRandom(),
+            LangNetLayerTests.createRandom());
+    }
+
+    @Override
+    protected Writeable.Reader<LangIdentNeuralNetwork> instanceReader() {
+        return LangIdentNeuralNetwork::new;
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        List<NamedXContentRegistry.Entry> namedXContent = new ArrayList<>();
+        namedXContent.addAll(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+        namedXContent.addAll(new SearchModule(Settings.EMPTY, Collections.emptyList()).getNamedXContents());
+        return new NamedXContentRegistry(namedXContent);
+    }
+
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangNetLayerTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangNetLayerTests.java
new file mode 100644
index 0000000000000..8a7b316fbef8a
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangNetLayerTests.java
@@ -0,0 +1,56 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.test.ESTestCase;
+import org.junit.Before;
+
+import java.io.IOException;
+import java.util.stream.Stream;
+
+
+public class LangNetLayerTests extends AbstractSerializingTestCase<LangNetLayer> {
+
+    private boolean lenient;
+
+    @Before
+    public void chooseStrictOrLenient() {
+        lenient = randomBoolean();
+    }
+
+    @Override
+    protected LangNetLayer doParseInstance(XContentParser parser) throws IOException {
+        return lenient ? LangNetLayer.LENIENT_PARSER.apply(parser, null) : LangNetLayer.STRICT_PARSER.apply(parser, null);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return lenient;
+    }
+
+    @Override
+    protected LangNetLayer createTestInstance() {
+        return createRandom();
+    }
+
+    public static LangNetLayer createRandom() {
+        int numWeights = randomIntBetween(1, 1000);
+        return new LangNetLayer(
+            Stream.generate(ESTestCase::randomDouble).limit(numWeights).mapToDouble(Double::doubleValue).toArray(),
+            numWeights,
+            1,
+            Stream.generate(ESTestCase::randomDouble).limit(numWeights).mapToDouble(Double::doubleValue).toArray());
+    }
+
+    @Override
+    protected Writeable.Reader<LangNetLayer> instanceReader() {
+        return LangNetLayer::new;
+    }
+
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LanguageExamples.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LanguageExamples.java
new file mode 100644
index 0000000000000..910f392df9fbc
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LanguageExamples.java
@@ -0,0 +1,123 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ * This Java port of CLD3 was derived from Google's CLD3 project at https://github.com/google/cld3
+ */
+
+package org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident;
+
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.DeprecationHandler;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentType;
+
+import java.io.IOException;
+import java.net.URL;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * These language examples are gathered from Google's CLD3 testing code.
+ */
+public final class LanguageExamples {
+
+    public LanguageExamples() {}
+
+    public  List<LanguageExampleEntry> getLanguageExamples() throws IOException {
+        String path = "/org/elasticsearch/xpack/core/ml/inference/language_examples.json";
+        URL resource = getClass().getResource(path);
+        if (resource == null) {
+            throw new ElasticsearchException("Could not find resource stored at [" + path + "]");
+        }
+        try(XContentParser parser =
+                XContentType.JSON.xContent().createParser(
+                    NamedXContentRegistry.EMPTY,
+                    DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
+                    getClass().getResourceAsStream(path))) {
+            List<LanguageExampleEntry> entries = new ArrayList<>();
+            while(parser.nextToken() != XContentParser.Token.END_ARRAY) {
+                entries.add(LanguageExampleEntry.PARSER.apply(parser, null));
+            }
+            return entries;
+        }
+    }
+
+    public static class LanguageExampleEntry implements ToXContentObject {
+        private static final ParseField LANGUAGE = new ParseField("language");
+        private static final ParseField PREDICTED_LANGUAGE = new ParseField("predicted_language");
+        private static final ParseField PROBABILITY = new ParseField("probability");
+        private static final ParseField TEXT = new ParseField("text");
+
+        public static ObjectParser<LanguageExampleEntry, Void> PARSER = new ObjectParser<>(
+            "language_example_entry",
+            true,
+            LanguageExampleEntry::new);
+
+        static {
+            PARSER.declareString(LanguageExampleEntry::setLanguage, LANGUAGE);
+            PARSER.declareString(LanguageExampleEntry::setPredictedLanguage, PREDICTED_LANGUAGE);
+            PARSER.declareDouble(LanguageExampleEntry::setProbability, PROBABILITY);
+            PARSER.declareString(LanguageExampleEntry::setText, TEXT);
+        }
+        // The true language
+        String language;
+        // The language predicted by CLD3
+        String predictedLanguage;
+        // The probability of the prediction
+        double probability;
+        // The raw text on which the prediction is based
+        String text;
+
+        private LanguageExampleEntry() {
+        }
+
+        private void setLanguage(String language) {
+            this.language = language;
+        }
+
+        private void setPredictedLanguage(String predictedLanguage) {
+            this.predictedLanguage = predictedLanguage;
+        }
+
+        private void setProbability(double probability) {
+            this.probability = probability;
+        }
+
+        private void setText(String text) {
+            this.text = text;
+        }
+
+        public String getLanguage() {
+            return language;
+        }
+
+        public String getPredictedLanguage() {
+            return predictedLanguage;
+        }
+
+        public double getProbability() {
+            return probability;
+        }
+
+        public String getText() {
+            return text;
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(LANGUAGE.getPreferredName(), language);
+            builder.field(PREDICTED_LANGUAGE.getPreferredName(), predictedLanguage);
+            builder.field(PROBABILITY.getPreferredName(), probability);
+            builder.field(TEXT.getPreferredName(), text);
+            builder.endObject();
+            return builder;
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/test/resources/org/elasticsearch/xpack/core/ml/inference/language_examples.json b/x-pack/plugin/core/src/test/resources/org/elasticsearch/xpack/core/ml/inference/language_examples.json
new file mode 100644
index 0000000000000..4a4b865a7085e
--- /dev/null
+++ b/x-pack/plugin/core/src/test/resources/org/elasticsearch/xpack/core/ml/inference/language_examples.json
@@ -0,0 +1,542 @@
+[
+  {
+    "language" : "af",
+    "predicted_language" : "af",
+    "probability" : 1.0,
+    "text" : "Dit is 'n kort stukkie van die teks wat gebruik sal word vir die toets van die akkuraatheid van die nuwe benadering."
+  },
+  {
+    "language" : "ar",
+    "predicted_language" : "ar",
+    "probability" : 0.999949,
+    "text" : "احتيالية بيع أي حساب"
+  },
+  {
+    "language" : "az",
+    "predicted_language" : "az",
+    "probability" : 1.0,
+    "text" : " a az qalıb breyn rinq intellektual oyunu üzrə yarışın zona mərhələləri keçirilib miq un qalıqlarının dənizdən çıxarılması davam edir məhəmməd peyğəmbərin karikaturalarını çap edən qəzetin baş redaktoru iş otağında ölüb"
+  },
+  {
+    "language" : "be",
+    "predicted_language" : "be",
+    "probability" : 0.999994,
+    "text" : " а друкаваць іх не было т�хнічна магчыма бліж�й за вільню тым �амым ча�ам н�мецкае кіраўніцтва прапаноўвала апроч ўв�дзенн� лацінкі �е"
+  },
+  {
+    "language" : "bg",
+    "predicted_language" : "bg",
+    "probability" : 0.999996,
+    "text" : " а дума попада в �ъ�то�ние на изпитание ключовите думи � пред�казана малко под то изи�кване на �траниците за тър�ене в"
+  },
+  {
+    "language" : "bn",
+    "predicted_language" : "bn",
+    "probability" : 0.999985,
+    "text" : "গ�যালারির ৩৮ বছর পূর�তিতে মূল�যছাড় অর�থনীতি বি�নপির ওয়াক আউট তপন চৌধ�রী হারবাল অ�যাসোসিয়েশনের সভাপতি আন�তর�জাতিক পরামর�শক বোর�ড দিয়ে শরিয়াহ� ইনন�ডেক�স করবে সি�সই মালিকপক�ষের কান�না, শ�রমিকের অনিশ�চয়তা মতি�িলে সমাবেশ নিষিদ�ধ: �ফবিসিসিআইয়ের ধন�যবাদ বিনোদন বিশেষ প�রতিবেদন বাংলালিংকের গ�র�যান�ডমাস�টার সিজন-৩ ব�রাজিলে বিশ�বকাপ ফ�টবল আয়োজনবিরোধী বিক�ষোভ দেশের নিরাপত�তার  চেয়ে অনেক বেশি সচেতন । প�রার�থীদের দক�ষতা  ও যোগ�যতার পাশাপাশি তারা জাতীয় ইস�য�গ�লোতে প�রাধান�য দিয়েছেন । � পা�চটি সিটিতে ২০ লাখ ভোটারদের দিয়ে জাতীয় নির�বাচনে ৮ কোটি ভোটারদের সঙ�গে ত�লনা করা যাবে কি �কজন দর�শকের �মন প�রশ�নে জবাবে আব�দ�ল�লাহ আল নোমান বলেন , “ �ই পা�চটি সিটি কর�পোরেশন নির�বাচন দেশের পা�চটি বড় বিভাগের প�রতিনিধিত�ব করছে । �ছাড়া �খানকার ভোটার রা সবাই সচেতন । তারা"
+  },
+  {
+    "language" : "bs",
+    "predicted_language" : "hr",
+    "probability" : 0.553621,
+    "text" : "Novi predsjednik Mešihata Islamske zajednice u Srbiji (IZuS) i muftija dr. Mevlud ef. Dudić izjavio je u intervjuu za Anadolu Agency (AA) kako je uvjeren da će doći do vraćanja jedinstva među muslimanima i unutar Islamske zajednice na prostoru Sandžaka, te da je njegova ruka pružena za povratak svih u okrilje Islamske zajednice u Srbiji nakon skoro sedam godina podjela u tom dijelu Srbije. Dudić je za predsjednika Mešihata IZ u Srbiji izabran 4. januara, a zvani�na inauguracija će biti obavljena u prvoj polovini februara. Kako se o�ekuje, prisustvovat će joj i reisu-l-ulema Islamske zajednice u Srbiji Husein ef. Kavazović koji će i zvani�no promovirati Dudića u novog prvog �ovjeka IZ u Srbiji. Dudić će danas boraviti u prvoj zvani�noj posjeti reisu Kavazoviću, što je njegov privi simboli�ni potez nakon imenovanja. "
+  },
+  {
+    "language" : "ca",
+    "predicted_language" : "ca",
+    "probability" : 1.0,
+    "text" : "al final en un únic lloc nhorabona l correu electrònic està concebut com a eina de productivitat aleshores per què perdre el temps arxivant missatges per després intentar recordar on els veu desar i per què heu d eliminar missatges importants per l"
+  },
+  {
+    "language" : "ceb",
+    "predicted_language" : "ceb",
+    "probability" : 0.999312,
+    "text" : "Ang Sugbo usa sa mga labing ugmad nga lalawigan sa nasod. Kini ang sentro sa komersyo, edukasyon ug industriya sa sentral ug habagatang dapit sa kapupod-an. Ang mipadayag sa Sugbo isip ikapito nga labing nindot nga pulo sa , ang nag-inusarang pulo sa Pilipinas nga napasidunggan sa maong magasin sukad pa sa tuig"
+  },
+  {
+    "language" : "cs",
+    "predicted_language" : "cs",
+    "probability" : 0.999912,
+    "text" : " a akci opakujte film uložen vykreslit gmail tokio smazat obsah adresáře nelze na�íst systémový profil jednotky smoot okud používáte pro ur�ení polokoule zna�ky z západ nebo v východ používejte nezáporné hodnoty zeměpisné délky nelze"
+  },
+  {
+    "language" : "cy",
+    "predicted_language" : "cy",
+    "probability" : 1.0,
+    "text" : " a chofrestru eich cyfrif ymwelwch a unwaith i chi greu eich cyfrif mi fydd yn cael ei hysbysu o ch cyfeiriad ebost newydd fel eich bod yn gallu cadw mewn cysylltiad drwy gmail os nad ydych chi wedi clywed yn barod am gmail mae n gwasanaeth gwebost"
+  },
+  {
+    "language" : "da",
+    "predicted_language" : "da",
+    "probability" : 0.999977,
+    "text" : " a z tallene og punktummer der er tilladte log ud angiv den ønskede adgangskode igen november gem personlige oplysninger kontrolspørgsmål det sidste tegn i dit brugernavn skal være et bogstav a z eller tal skriv de tegn du kan se i billedet nedenfor"
+  },
+  {
+    "language" : "de",
+    "predicted_language" : "de",
+    "probability" : 0.998885,
+    "text" : " abschnitt ordner aktivieren werden die ordnereinstellungen im farbabschnitt deaktiviert öchten sie wirklich fortfahren eldtypen angeben optional n diesem schritt geben sie für jedesfeld aus dem datenset den typ an ieser schritt ist optional eldtypen"
+  },
+  {
+    "language" : "el",
+    "predicted_language" : "el",
+    "probability" : 0.999956,
+    "text" : " ή α�νητική αναζήτηση λέξης κλειδιο� καταστήστε τις μεμονωμένες λέξεις κλειδιά πε�ισσότε�ο στοχοθετημένες με τη μετατ�οπή τους σε"
+  },
+  {
+    "language" : "en",
+    "predicted_language" : "en",
+    "probability" : 0.993561,
+    "text" : " a backup credit card by visiting your billing preferences page or visit the adwords help centre for more details https adwords google com support bin answer py answer hl en we were unable to process the payment of for your outstanding google adwords"
+  },
+  {
+    "language" : "eo",
+    "predicted_language" : "eo",
+    "probability" : 0.997801,
+    "text" : " a jarcento refoje per enmetado de koncerna pastro tiam de reformita konfesio ekde refoje ekzistis luteranaj komunumanoj tamen tiuj fondis propran komunumon nur en ambaÅ­ apartenis ekde al la evangela eklezio en prusio resp ties rejnlanda provinceklezio en"
+  },
+  {
+    "language" : "es",
+    "predicted_language" : "es",
+    "probability" : 0.999996,
+    "text" : " a continuación haz clic en el botón obtener ruta también puedes desplazarte hasta el final de la página para cambiar tus opciones de búsqueda gráfico y detalles ésta es una lista de los vídeos que te recomendamos nuestras recomendaciones se basan"
+  },
+  {
+    "language" : "et",
+    "predicted_language" : "et",
+    "probability" : 0.999996,
+    "text" : " a niipea kui sinu maksimaalne igakuine krediidi limiit on meie poolt heaks kiidetud on sinu kohustuseks see krediidilimiit"
+  },
+  {
+    "language" : "eu",
+    "predicted_language" : "eu",
+    "probability" : 1.0,
+    "text" : " a den eraso bat honen kontra hortaz eragiketa bakarrik behar dituen eraso batek aes apurtuko luke nahiz eta oraingoz eraso bideraezina izan gaur egungo teknologiaren mugak direla eta oraingoz kezka hauek alde batera utzi daitezke orain arteko indar"
+  },
+  {
+    "language" : "fa",
+    "predicted_language" : "fa",
+    "probability" : 0.999878,
+    "text" : " آب خوردن عجله می کردند به جای باز ی کتک کاری می کردند و همه چيز مثل قبل بود �قط من ماندم و يک دنيا حر� و انتظار تا عاقبت رسيد احضاريه ی ای با"
+  },
+  {
+    "language" : "fi",
+    "predicted_language" : "fi",
+    "probability" : 1.0,
+    "text" : " a joilla olet käynyt tämä kerro meille kuka ä olet ei tunnistettavia käyttötietoja kuten virheraportteja käytetään google desktopin parantamiseen etsi näyttää mukautettuja uutisia google desktop keskivaihto leikkaa voit kaksoisnapsauttaa"
+  },
+  {
+    "language" : "fil",
+    "predicted_language" : "fil",
+    "probability" : 1.0,
+    "text" : "Ito ay isang maikling piraso ng teksto na ito ay gagamitin para sa pagsubok ang kawastuhan ng mga bagong diskarte."
+  },
+  {
+    "language" : "fr",
+    "predicted_language" : "fr",
+    "probability" : 0.999987,
+    "text" : " a accès aux collections et aux frontaux qui lui ont été attribués il peut consulter et modifier ses collections et exporter des configurations de collection toutefois il ne peut pas créer ni supprimer des collections enfin il a accès aux fonctions"
+  },
+  {
+    "language" : "ga",
+    "predicted_language" : "ga",
+    "probability" : 0.999996,
+    "text" : " a bhfuil na focail go léir i do cheist le fáil orthu ní gá ach focail breise a chur leis na cinn a cuardaíodh cheana chun an cuardach a bheachtú nó a chúngú má chuirtear focal breise isteach aimseofar fo aicme ar leith de na torthaí a fuarthas"
+  },
+  {
+    "language" : "gl",
+    "predicted_language" : "gl",
+    "probability" : 0.998022,
+    "text" : "  debe ser como mínimo taranto tendas de venda polo miúdo cociñas servizos bordado canadá viaxes parques de vehículos de recreo hotel oriental habitación recibir unha postal no enderezo indicado anteriormente"
+  },
+  {
+    "language" : "gu",
+    "predicted_language" : "gu",
+    "probability" : 0.999962,
+    "text" : " આના પરિણામ પ�રમાણસર ફોન�ટ અવતરણ ચિન�હવાળા પાઠને છ�પાવો બધા સમૂહો શોધાયા હાલનો જ સંદેશ વિષયની"
+  },
+  {
+    "language" : "ha",
+    "predicted_language" : "ha",
+    "probability" : 1.0,
+    "text" : " a cikin a kan sakamako daga sakwannin a kan sakamako daga sakwannin daga ranar zuwa a kan sakamako daga guda daga ranar zuwa a kan sakamako daga shafukan daga ranar zuwa a kan sakamako daga guda a cikin last hour a kan sakamako daga guda daga kafar"
+  },
+  {
+    "language" : "hi",
+    "predicted_language" : "hi",
+    "probability" : 1.0,
+    "text" : " ं �डवर�ड�स विज�ञापनों के अन�भव पर आधारित हैं और इनकी मदद से आपको अपने विज�ञापनों का अधिकतम लाभ"
+  },
+  {
+    "language" : "hmn",
+    "predicted_language" : "hmn",
+    "probability" : 1.0,
+    "text" : "Qhov no yog ib tug luv luv daim ntawv nyeem uas yuav siv tau rau kev soj ntsuam qhov tseeb ntawm tus tshiab mus kom ze."
+  },
+  {
+    "language" : "hr",
+    "predicted_language" : "hr",
+    "probability" : 0.522486,
+    "text" : "Posljednja dva vladara su Kijaksar (Κυαξα�ης; 625-585 prije Krista), fraortov sin koji će proširiti teritorij Medije i Astijag. Kijaksar je imao kćer ili unuku koja se zvala Amitis a postala je ženom Nabukodonosora II. kojoj je ovaj izgradio Viseće vrtove Babilona. Kijaksar je modernizirao svoju vojsku i uništio Ninivu 612. prije Krista. Naslijedio ga je njegov sin, posljednji medijski kralj, Astijag, kojega je detronizirao (srušio sa vlasti) njegov unuk Kir Veliki. Zemljom su zavladali Perzijanci. Hrvatska je zemlja situacija u Europi. Ona ima bogatu kulturu i ukusna jela."
+  },
+  {
+    "language" : "ht",
+    "predicted_language" : "ht",
+    "probability" : 1.0,
+    "text" : " ak pitit tout sosyete a chita se pou sa leta dwe pwoteje yo nimewo leta fèt pou li pwoteje tout paran ak pitit nan peyi a menm jan kit paran yo marye kit yo pa marye tout manman ki fè pitit leta fèt pou ba yo konkoul menm jan tou pou timoun piti ak pou"
+  },
+  {
+    "language" : "hu",
+    "predicted_language" : "hu",
+    "probability" : 1.0,
+    "text" : " a felhasználóim a google azonosító szöveget ikor látják a felhasználóim a google azonosító szöveget felhasználók a google azonosító szöveget fogják látni minden tranzakció után ha a vásárlását regisztrációját oldalunk"
+  },
+  {
+    "language" : "hy",
+    "predicted_language" : "hy",
+    "probability" : 1.0,
+    "text" : " Õ¡ Õµ Õ¥Õ¾ Õ¶Õ¡ Õ°Õ«Õ¡Ö�Õ¡Õ® Õ¡Õ¹Ö„Õ¥Ö€Õ¸Õ¾ Õ¶Õ¡ÕµÕ¸Ö‚Õ´ Õ§ Õ°Õ«Õ¶Õ£Õ°Õ¡Ö€Õ¯Õ¡Õ¶Õ« Õ·Õ¥Õ¶Ö„Õ« Õ¿Õ¡Ö€Ö…Ö€Õ«Õ¶Õ¡Õ¯ ÖƒÕ¸Ö„Ö€Õ«Õ¯ Ö„Õ¡Õ¼Õ¡Õ¯Õ¸Ö‚Õ½Õ« ÕºÕ¡Õ¿Õ¸Ö‚Õ°Õ¡Õ¶Õ¶Õ¥Ö€Õ«Õ¶ Õ¤Õ¥Õ¼ Õ´Õ¥Õ¶Ö„ Õ·Õ¡Õ¿ Õ¥Õ¶Ö„ Õ°Õ¥Õ¿Õ¡Õ´Õ¶Õ¡Ö� Õ¡Õ½Õ¸Ö‚Õ´ Õ§ Õ¶Õ¡ Õ¡ÕµÕ½ÕºÕ¥Õ½ Õ§"
+  },
+  {
+    "language" : "id",
+    "predicted_language" : "ms",
+    "probability" : 0.621919,
+    "text" : "berdiri setelah pengurusnya yang berusia 83 tahun, Fayzrahman Satarov, mendeklarasikan diri sebagai nabi dan rumahnya sebagai negara Islam Satarov digambarkan sebagai mantan ulama Islam  tahun 1970-an. Pengikutnya didorong membaca manuskripnya dan kebanyakan dilarang meninggalkan tempat persembunyian bawah tanah di dasar gedung delapan lantai mereka. Jaksa membuka penyelidikan kasus kriminal pada kelompok itu dan menyatakan akan membubarkan kelompok kalau tetap melakukan kegiatan ilegal seperti mencegah anggotanya mencari bantuan medis atau pendidikan. Sampai sekarang pihak berwajib belum melakukan penangkapan meskipun polisi mencurigai adanya tindak kekerasan pada anak. Pengadilan selanjutnya akan memutuskan apakah anak-anak diizinkan tetap tinggal dengan orang tua mereka. Kazan yang berada sekitar 800 kilometer di timur Moskow merupakan wilayah Tatarstan yang"
+  },
+  {
+    "language" : "ig",
+    "predicted_language" : "ig",
+    "probability" : 1.0,
+    "text" : "Chineke bụ aha �z� ndï omenala Igbo kp�ro Chukwu. Mgbe ndị bekee bịara, ha mee ya nke ndi Christian. N'echiche ndi ekpere chi Omenala Ndi Igbo, Christianity, Judaism, ma Islam, Chineke nwere �tụtụ utu aha, ma nwee nanị otu aha. Ụz� abụ� e si akp� aha ahụ bụ Jehovah ma Ọ bụ Yahweh. Na �tụtụ Akwụkw� Ns�, e wepụla aha Chineke ma jiri utu aha bụ Onyenwe Anyị ma � bụ Chineke dochie ya. Ma mgbe e dere akwụkw� ns�, aha ahụ bụ Jehova pụtara n’ime ya, ihe dị ka ugboro pụkụ asaa(7,000)."
+  },
+  {
+    "language" : "is",
+    "predicted_language" : "is",
+    "probability" : 0.999937,
+    "text" : " a afköst leitarorða þinna leitarorð neikvæð leitarorð auglýsingahópa byggja upp aðallista yfir ný leitarorð fyrir auglýsingahópana og skoða ítarleg gögn um árangur leitarorða eins og samkeppni auglýsenda og leitarmagn er krafist notkun"
+  },
+  {
+    "language" : "it",
+    "predicted_language" : "it",
+    "probability" : 0.999996,
+    "text" : " a causa di un intervento di manutenzione del sistema fino alle ore circa ora legale costa del pacifico del novembre le campagne esistenti continueranno a essere pubblicate come di consueto anche durante questo breve periodo di inattività ci scusiamo per"
+  },
+  {
+    "language" : "iw",
+    "predicted_language" : "iw",
+    "probability" : 0.999413,
+    "text" : " �ו לערוך �ת העדפות ההפצה �נ� עקוב �חרי השלבי� הב�י� כנס לחשבון ה�ישי שלך ב"
+  },
+  {
+    "language" : "ja",
+    "predicted_language" : "ja",
+    "probability" : 1.0,
+    "text" : " ��ペ ジ�� アカウント�指定�れ�予算�履歴を一覧������ �れ�れ�項目�� 予算��特定期間�ステ タス�表示�れ�� �在���今後�予算を設定�る��"
+  },
+  {
+    "language" : "jv",
+    "predicted_language" : "jv",
+    "probability" : 0.999968,
+    "text" : "Iki Piece cendhak teks sing bakal digunakake kanggo Testing akurasi pendekatan anyar."
+  },
+  {
+    "language" : "ka",
+    "predicted_language" : "ka",
+    "probability" : 0.999977,
+    "text" : " � ბირთვიდ�ნ მიღებული ელემენტი მენდელეევის პერი�დულ სიტემ�ში გ�დ�ინ�ცვლებს �რი უჯრით"
+  },
+  {
+    "language" : "kk",
+    "predicted_language" : "kk",
+    "probability" : 0.999998,
+    "text" : " а билердің өзіне рұқ�ат берілмеген егер халық талап ет�е ғана хан келі�ім берген өздеріңіз біле�іздер қр қыл мы� тық кодек�інде жазаның"
+  },
+  {
+    "language" : "km",
+    "predicted_language" : "km",
+    "probability" : 0.999996,
+    "text" : "ន�ះគឺជាបំណែក�្លីនៃអ�្�បទដែលនឹង�្រូវបានប្រើសម្រាប់ការធ្វើ��ស្�ភាព�្រឹម�្រូវនៃវិធីសាស្រ្��្មីន�ះ។"
+  },
+  {
+    "language" : "kn",
+    "predicted_language" : "kn",
+    "probability" : 0.999977,
+    "text" : " ಂಠಯ�ಯನವರ� ತ�ಮಕೂರ� ಜಿಲ�ಲೆಯ ಚಿಕ�ಕನಾಯಕನಹಳ�ಳಿ ತಾಲ�ಲೂಕಿನ ತೀರ�ಥಪ�ರ ವೆಂಬ ಸಾಧಾರಣ ಹಳ�ಳಿಯ ಶ�ಯಾನ�ಭೋಗರ"
+  },
+  {
+    "language" : "ko",
+    "predicted_language" : "ko",
+    "probability" : 0.999989,
+    "text" : " 개별�으로 리�트 액세스 권한� 부여할 수 있습니다 액세스 권한 부여사용��게 프로필 리�트� 액세스할 수 있는 권한� 부여하시려면 가용 프로필 ���서 프로필 �름� 선�한 다�"
+  },
+  {
+    "language" : "la",
+    "predicted_language" : "la",
+    "probability" : 0.999989,
+    "text" : " a deo qui enim nocendi causa mentiri solet si iam consulendi causa mentiatur multum profecit sed aliud est quod per se ipsum laudabile proponitur aliud quod in deterioris comparatione praeponitur aliter enim gratulamur cum sanus est homo aliter cum melius"
+  },
+  {
+    "language" : "lo",
+    "predicted_language" : "lo",
+    "probability" : 0.999958,
+    "text" : " �ຫາທົ່ວທັງເວັບ �ລະໃນເວັບໄຮ້ສາ� ທຳອິດໃຫ້ທຳ�ານຊອ�ຫາ�່ອນ ຈາ�ນັ້ນ ໃຫ້�ົດປຸ່ມເມນູ ໃນໜ້າຜົນໄດ້"
+  },
+  {
+    "language" : "lt",
+    "predicted_language" : "lt",
+    "probability" : 0.999998,
+    "text" : " a išsijungia mano idėja dėl geriausio laiko po pastarųjų savo santykių pasimokiau penki dalykai be kurių negaliu gyventi mano miegamajame tu surasi ideali pora išsilavinimas aukštoji mokykla koledžas universitetas pagrindinis laipsnis metai"
+  },
+  {
+    "language" : "lv",
+    "predicted_language" : "lv",
+    "probability" : 0.999998,
+    "text" : " a gadsk�rtēj� izp�rdošana slēpošana j�ņi atlaide izmaiņas trafik� kas saistītas ar sezonas izp�rdošanu speci�laj�m atlaidēm u c ir parastas un atslēgv�rdi kas ir popul�ri noteiktos laika posmos šaj� laik� saņems liel�ku klikšķu"
+  },
+  {
+    "language" : "mg",
+    "predicted_language" : "mg",
+    "probability" : 0.999996,
+    "text" : " amporisihin i ianao mba hijery ny dika teksta ranofotsiny an ity lahatsoratra ity tsy ilaina ny opérateur efa karohina daholo ny teny rehetra nosoratanao ampiasao anaovana dokambarotra i google telugu datin ny takelaka fikarohana sary renitakelak i"
+  },
+  {
+    "language" : "mi",
+    "predicted_language" : "mi",
+    "probability" : 1.0,
+    "text" : " haere ki te kainga o o haere ki te kainga o o haere ki te kainga o te rapunga ahua o haere ki te kainga o ka tangohia he ki to rapunga kaore au mohio te tikanga whakatiki o te ra he whakaharuru te pai rapunga a te rapunga ahua a e kainga o nga awhina o te"
+  },
+  {
+    "language" : "mk",
+    "predicted_language" : "mk",
+    "probability" : 1.0,
+    "text" : " гла�овите коалицијата на вмро дпмне како партија �о најмногу о�воени гла�ови ќе добие евра а на �метката на коализијата за македонија"
+  },
+  {
+    "language" : "ml",
+    "predicted_language" : "ml",
+    "probability" : 0.999973,
+    "text" : " ം അങ�ങനെ ഞങ�ങള� അവര�ടെ മ�മ�പില� നിന�ന� ഔട�ം ഉടനെ നിങ�ങള� പതിയിരിപ�പില� നിന�ന� എഴ�ന�നേറ�റ�"
+  },
+  {
+    "language" : "mn",
+    "predicted_language" : "mn",
+    "probability" : 1.0,
+    "text" : " а болов�ронгуй болгох орон нутгийн ажил үйл�ийг у�лдуулж зохицуулах дүр�м журам болов�руулах орон нутгийн өмч хөрөнгө �анхүүгийн"
+  },
+  {
+    "language" : "mr",
+    "predicted_language" : "mr",
+    "probability" : 1.0,
+    "text" : "हैदराबाद  उच�चार �का (सहाय�य·माहिती)तेल�गू: హైదరాబాద� , उर�दू: حیدر آباد हे भारतातील आंध�र प�रदेश राज�याच�या राजधानीचे शहर आहे. हैदराबादची लोकसंख�या ७७ लाख ४० हजार ३३४ आहे. मोत�यांचे शहर अशी �केकाळी ओळख असलेल�या या शहराला �तिहासिक, सांस�कृतिक आणि स�थापत�यशास�त�रीय वारसा लाभला आहे. १९९० नंतर शिक�षण आणि माहिती तंत�रज�ञान त�याचप�रमाणे औषधनिर�मिती आणि जैवतंत�रज�ञान क�षेत�रातील उद�योगधंद�यांची वाढ शहरात �ाली. दक�षिण मध�य भारतातील पर�यटन आणि तेल�गू चित�रपटनिर�मितीचे हैदराबाद हे केंद�र आहे"
+  },
+  {
+    "language" : "ms",
+    "predicted_language" : "ms",
+    "probability" : 0.849837,
+    "text" : "pengampunan beramai-ramai supaya mereka pulang ke rumah masing-masing. Orang-orang besarnya enggan mengiktiraf sultan yang dilantik oleh Belanda sebagai Yang DiPertuan Selangor. Orang ramai pula tidak mahu menjalankan perniagaan bijih timah dengan Belanda, selagi raja yang berhak tidak ditabalkan. Perdagang yang lain dibekukan terus kerana untuk membalas jasa beliau yang membantu Belanda menentang Riau, Johor dan Selangor. Di antara tiga orang Sultan juga dipandang oleh rakyat sebagai seorang sultan yang paling gigih. 1 | 2 SULTAN Sebagai ganti Sultan Ibrahim ditabalkan Raja Muhammad iaitu Raja Muda. Walaupun baginda bukan anak isteri pertama bergelar Sultan Muhammad bersemayam di Kuala Selangor juga. Pentadbiran baginda yang lemah itu menyebabkan Kuala Selangor menjadi sarang ioleh Cina di Lukut tidak diambil tindakan, sedangkan baginda sendiri banyak berhutang kepada 1"
+  },
+  {
+    "language" : "mt",
+    "predicted_language" : "mt",
+    "probability" : 0.999949,
+    "text" : " ata ikteb messaġġ lil indirizzi differenti billi tagħżilhom u tagħfas il buttuna ikteb żid numri tfittxijja tal kotba mur print home kotba minn pagni ghal pagna minn ghall ktieb ta aċċessa stieden habib iehor grazzi it tim tal gruppi google"
+  },
+  {
+    "language" : "my",
+    "predicted_language" : "my",
+    "probability" : 0.999884,
+    "text" : " �က္ကသုိလ္ မ္ဟ ပ္ရန္ လာ္ရပီးေနာက္ န္ဟစ္ အရ္�ယ္ ဦးသန္ ့သည္ ပန္ း�နော္ အမ္ယုိးသား ေက္ယာင္ း"
+  },
+  {
+    "language" : "ne",
+    "predicted_language" : "ne",
+    "probability" : 0.999344,
+    "text" : "अरू ठाऊ�बाटपनि ख�लेको छ यो खाता अर अरू ठाऊ�बाटपनि ख�लेको छ यो खाता अर ू"
+  },
+  {
+    "language" : "nl",
+    "predicted_language" : "nl",
+    "probability" : 0.999985,
+    "text" : " a als volgt te werk om een configuratiebestand te maken sitemap gen py ebruik filters om de s op te geven die moeten worden toegevoegd of uitgesloten op basis van de opmaaktaal elke sitemap mag alleen de s bevatten voor een bepaalde opmaaktaal dit"
+  },
+  {
+    "language" : "no",
+    "predicted_language" : "no",
+    "probability" : 0.999922,
+    "text" : " a er obligatorisk tidsforskyvning plassering av katalogsøk planinformasjon loggfilbane gruppenavn kontoinformasjon passord domene gruppeinformasjon alle kampanjesporing alternativ bruker grupper oppgaveplanlegger oppgavehistorikk kontosammendrag antall"
+  },
+  {
+    "language" : "ny",
+    "predicted_language" : "ny",
+    "probability" : 0.999985,
+    "text" : "Boma ndi gawo la dziko lomwe linapangidwa ndi cholinga chothandiza ntchito yolamulira. Kuŵalako kulikuunikabe mandita, Edipo nyima unalephera kugonjetsa kuŵalako."
+  },
+  {
+    "language" : "pa",
+    "predicted_language" : "pa",
+    "probability" : 0.999926,
+    "text" : " ਂ ਦਿਨਾਂ ਵਿਚ ਭਾਈ ਸਾਹਿਬ ਦੀ ਬ�ੱਚੜ ਗੋਬਿੰਦ ਰਾਮ ਨਾਲ ਅੜਫਸ ਚੱਲ ਰਹੀ ਸੀ ਗੋਬਿੰਦ ਰਾਮ ਨੇ ਭਾਈ ਸਾਹਿਬ ਦੀਆਂ ਭੈਣਾ"
+  },
+  {
+    "language" : "pl",
+    "predicted_language" : "pl",
+    "probability" : 1.0,
+    "text" : " a australii będzie widział inne reklamy niż użytkownik z kanady kierowanie geograficzne sprawia że reklamy są lepiej dopasowane do użytkownika twojej strony oznacza to także że możesz nie zobaczyć wszystkich reklam które są wyświetlane na"
+  },
+  {
+    "language" : "pt",
+    "predicted_language" : "pt",
+    "probability" : 0.999992,
+    "text" : " a abit prevê que a entrada desses produtos estrangeiros no mercado têxtil e vestuário do brasil possa reduzir os preços em cerca de a partir de má notícia para os empresários que terão que lutar para garantir suas margens de lucro mas boa notícia"
+  },
+  {
+    "language" : "ro",
+    "predicted_language" : "ro",
+    "probability" : 1.0,
+    "text" : " a anunţurilor reţineţi nu plătiţi pentru clicuri sau impresii ci numai atunci când pe site ul dvs survine o acţiune dorită site urile negative nu pot avea uri de destinaţie daţi instrucţiuni societăţii dvs bancare sau constructoare să"
+  },
+  {
+    "language" : "ru",
+    "predicted_language" : "ru",
+    "probability" : 0.997257,
+    "text" : " а неправильный формат идентификатора дн назад"
+  },
+  {
+    "language" : "si",
+    "predicted_language" : "si",
+    "probability" : 0.999956,
+    "text" : " අනුර�ධ මිහිඳුකුල නමින් සකුර� ට ලිපියක් ත�පෑලෙන් එව� තිබුණ� කි ් රස්ටි ෂෙල්ටන් ප ් රන�න්දු ද"
+  },
+  {
+    "language" : "sk",
+    "predicted_language" : "sk",
+    "probability" : 0.999996,
+    "text" : " a aktivovať reklamnú kampaň ak chcete kampaň pred spustením ešte prispôsobiť uložte ju ako šablónu a pokra�ujte v úprave vyberte si jednu z možností nižšie a kliknite na tla�idlo uložiť kampaň nastavenia kampane môžete ľubovoľne"
+  },
+  {
+    "language" : "sl",
+    "predicted_language" : "sl",
+    "probability" : 0.974819,
+    "text" : " adsense stanje prijave za google adsense google adsense ra�un je bil za�asno zamrznjen pozdravljeni hvala za vaše zanimanje v google adsense po pregledu vaše prijavnice so naši strokovnjaki ugotovili da spletna stran ki je trenutno povezana z vašim"
+  },
+  {
+    "language" : "so",
+    "predicted_language" : "so",
+    "probability" : 1.0,
+    "text" : " a oo maanta bogga koobaad ugu qoran yahey beesha caalamka laakiin si kata oo beesha caalamku ula guntato soomaaliya waxa aan shaki ku jirin in aakhirataanka dadka soomaalida oo kaliya ay yihiin ku soomaaliya ka saari kara dhibka ay ku jirto"
+  },
+  {
+    "language" : "sq",
+    "predicted_language" : "sq",
+    "probability" : 1.0,
+    "text" : " a do të kërkoni nga beogradi që të njohë pavarësinë e kosovës zoti thaçi prishtina është gati ta njoh pavarësinë e serbisë ndërsa natyrisht se do të kërkohet një gjë e tillë që edhe beogradi ta njoh shtetin e pavarur dhe sovran të"
+  },
+  {
+    "language" : "sr",
+    "predicted_language" : "sr",
+    "probability" : 0.985774,
+    "text" : "балчак балчак на мапи �рбије уреди демографија у на�ељу балчак живи пунолетна �тановника а про�ечна �таро�т �тановништва изно�и година"
+  },
+  {
+    "language" : "st",
+    "predicted_language" : "st",
+    "probability" : 0.999998,
+    "text" : " bang ba nang le thahasello matshwao a sehlooho thuto e thehilweng hodima diphetho ke tsela ya ho ruta le ho ithuta e totobatsang hantle seo baithuti ba lokelang ho se fihlella ntlhatheo eo e sebetsang ka yona ke ya hore titjhere o hlakisa pele seo"
+  },
+  {
+    "language" : "su",
+    "predicted_language" : "su",
+    "probability" : 0.992152,
+    "text" : "Nu ngatur kahirupan warga, keur kapentingan pamarentahan diatur ku RT, RW jeung Kepala Dusun, sedengkeun urusan adat dipupuhuan ku Kuncen jeung kepala adat. Sanajan Kampung Kuta teu pati anggang jeung lembur sejenna nu aya di wewengkon Desa Pasir Angin, tapi boh wangunan imah atawa tradisi kahirupan masarakatna nenggang ti nu lian."
+  },
+  {
+    "language" : "sv",
+    "predicted_language" : "sv",
+    "probability" : 1.0,
+    "text" : " a bort objekt från google desktop post äldst meny öretag dress etaljer alternativ för vad är inne yaste google skrivbord plugin program för nyheter google visa nyheter som är anpassade efter de artiklar som du läser om du till exempel läser"
+  },
+  {
+    "language" : "sw",
+    "predicted_language" : "sw",
+    "probability" : 0.999998,
+    "text" : " a ujumbe mpya jumla unda tafuta na angalia vikundi vya kujadiliana na kushiriki mawazo iliyopangwa kwa tarehe watumiaji wapya futa orodha hizi lugha hoja vishikanisho vilivyo dhaminiwa ujumbe sanaa na tamasha toka udhibitisho wa neno kwa haraka fikia"
+  },
+  {
+    "language" : "ta",
+    "predicted_language" : "ta",
+    "probability" : 0.999943,
+    "text" : " அங�க� ராஜேந�திர சோழனால� கட�டப�பட�ட பிரம�மாண�டமான சிவன� கோவில� ஒன�ற�ம� உள�ளத� தொக�"
+  },
+  {
+    "language" : "te",
+    "predicted_language" : "te",
+    "probability" : 0.999962,
+    "text" : " � దనర జయించిన తత�వ మరసి చూడ� దాన యగ�న� రాజయోగి యిట�ల� తేజరిల�ల�చ� న�ండ� విశ�వదాభిరామ వినర వేమ"
+  },
+  {
+    "language" : "tg",
+    "predicted_language" : "tg",
+    "probability" : 0.999949,
+    "text" : " адолат ва ин�ондӯ�тиро бар фашизм нажодпара�тӣ ва адоват тарҷеҳ додаа�т чоп кунед ба дигарон фири�тед чоп кунед ба дигарон фири�тед"
+  },
+  {
+    "language" : "th",
+    "predicted_language" : "th",
+    "probability" : 0.999981,
+    "text" : " ��ใน�ารค้นหา หรือหน้าเนื้อหา หา�ท่านเลือ�ลงโฆษณา ท่านอาจจะปรับต้องเพิ่มงบประมาณรายวันตา"
+  },
+  {
+    "language" : "tr",
+    "predicted_language" : "tr",
+    "probability" : 1.0,
+    "text" : " a ayarlarınızı görmeniz ve yönetmeniz içindir eğer kampanyanız için günlük bütçenizi gözden geçirebileceğiniz yeri arıyorsanız kampanya yönetimi ne gidin kampanyanızı seçin ve kampanya ayarlarını düzenle yi tıklayın sunumu"
+  },
+  {
+    "language" : "uk",
+    "predicted_language" : "uk",
+    "probability" : 1.0,
+    "text" : " а більший бюджет щоб забезпечити �обі мак�имум прибутків від переходів від�тежуйте �вої об �ви за датою географічним розташуванн�м"
+  },
+  {
+    "language" : "ur",
+    "predicted_language" : "ur",
+    "probability" : 0.999998,
+    "text" : " آپ کو کم سے کم ممکن� رقم چارج کرتا �ے اس کی مثال کے طور پر �رض کریں اگر آپ کی زیاد� سے زیاد� قیمت �ی کل�ک امریکی ڈالر اور کل�ک کرنے کی شرح �و تو"
+  },
+  {
+    "language" : "uz",
+    "predicted_language" : "uz",
+    "probability" : 0.999367,
+    "text" : " abadiylashtirildi aqsh ayol prezidentga tayyormi markaziy osiyo afg onistonga qanday yordam berishi mumkin ukrainada o zbekistonlik muhojirlar tazyiqdan shikoyat qilmoqda gruziya va ukraina hozircha natoga qabul qilinmaydi afg oniston o zbekistonni g"
+  },
+  {
+    "language" : "vi",
+    "predicted_language" : "vi",
+    "probability" : 0.999996,
+    "text" : " adsense cho nội dung nhà cung câ�p dịch vụ di động xa�c minh ti�n dụng thay đổi nhãn kg ca�c ô xem chi phi� cho từ chô�i ca�c đơn đặt hàng dạng câ�p dữ liệu a�c minh trang web của bạn để xem"
+  },
+  {
+    "language" : "yi",
+    "predicted_language" : "yi",
+    "probability" : 0.999954,
+    "text" : "�ן פ�נט�זיע ער �יז ב�ק�נט צי� מערסטן פ�ר זיינע ב�ַל�ַדעס ער ה�ָט געוווינט �ין וו�רשע יעס פ�ריס ליווערפול �ון ל�נד�ן סוף כל סוף �יז ער"
+  },
+  {
+    "language" : "yo",
+    "predicted_language" : "yo",
+    "probability" : 0.999836,
+    "text" : " abinibi han ikawe alantakun le ni opolopo ede abinibi ti a to lesese bi eniyan to fe lo se fe lati se atunse jowo mo pe awon oju iwe itakunagbaye miran ti ako ni oniruru ede abinibi le faragba nipa atunse ninu se iwadi blogs ni ori itakun agbaye ti e ba"
+  },
+  {
+    "language" : "zh",
+    "predicted_language" : "zh",
+    "probability" : 0.999977,
+    "text" : "产�的简报和公告 �交该申请�无法进行更改 请确认您的选择是正确的 对于��交的图书 我确认 我是版�所有者或已得到版�所有者的授� �更改您的国家 地区 请在此表的最上端更改您的"
+  },
+  {
+    "language" : "zu",
+    "predicted_language" : "zu",
+    "probability" : 0.999989,
+    "text" : " ana engu uma inkinga iqhubeka siza ubike kwi isexwayiso ngenxa yephutha lomlekeleli sikwazi ukubuyisela emuva kuphela imiphumela engaqediwe ukuthola imiphumela eqediwe zama ukulayisha kabusha leli khasi emizuzwini engu uma inkinga iqhubeka siza uthumele"
+  }
+]
diff --git a/x-pack/plugin/core/src/test/resources/org/elasticsearch/xpack/core/ml/inference/ngram_examples.json b/x-pack/plugin/core/src/test/resources/org/elasticsearch/xpack/core/ml/inference/ngram_examples.json
new file mode 100644
index 0000000000000..0bb879aa1a9fc
--- /dev/null
+++ b/x-pack/plugin/core/src/test/resources/org/elasticsearch/xpack/core/ml/inference/ngram_examples.json
@@ -0,0 +1 @@
+[{"language":"af","weights":[0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.017094,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.042735,0.00854701,0.00854701,0.00854701,0.017094,0.00854701,0.025641,0.034188,0.00854701,0.00854701,0.017094,0.0512821,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.017094,0.00854701,0.00854701,0.042735,0.00854701,0.00854701,0.00854701,0.00854701,0.00854701,0.017094,0.017094,0.034188,0.017094,0.00854701,0.00854701,0.00854701,0.00854701,0.025641,0.00854701,0.00854701,0.00854701,0.017094,0.017094,0.042735,0.025641,0.00854701,0.00854701,0.025641,0.00854701,0.00854701],"ids":[353,157,153,486,712,173,183,347,879,191,108,898,716,327,134,364,734,314,80,8,875,717,98,575,778,273,763,925,144,458,10,422,757,841,980,385,780,71,493,46,854,651,793,7,884,564,999,108,364,559,803,834,605,545,984,200,532,630,248,146,770,421,955,826,510,61,786,645,707,838,862,613,985,688,269,822,287],"ngrams":["er","na","en","^b","we","ei","he","th","ra","ku","ak","ts","oe","r$","ui","vi","et","l$","nu","^a","k$","^w","ik","rd","ru","eb","ad","^g","be","tu","ie","ks","ek","id","^t","de","va","^v","in","al","^n","e$","to","sa","uw","ki","ge","kk","uk","wo","di","br","ng","ir","rt","st","^s","at","n$","or","g$","ur","te","ko","s$","^k","is","^i","d$","^$","^d","t$","ri","wa","an","aa","it"],"ngram_size":2,"dimension":1000},{"language":"af","weights":[0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.056338,0.0140845,0.0140845,0.056338,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0422535,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0422535,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845],"ids":[4504,3588,660,567,2130,2309,1957,2555,3605,4440,4084,58,1756,1206,603,3452,634,4372,4521,887,4791,4806,1343,335,4884,881,3407,866,538,3322,4568,3797,4475,2410,4734,3156,1031,3094,3854,2122,3444,2015,259,3478,657,134,2790,2481,4287,3934,4298,3819,4032,4483,3678,3165,2286,3343,3391,3394,2047],"ngrams":["ing$","nade","enad","nuwe","eid$","thei","athe","aath","kura","akku","kkur","stuk","^akk","oets","ebru","toet","deri","^toe","vir$","^dit","word","^sal","ruik","brui","^ben","uraa","uik$","gebr","^die","teks","^tek","die$","^wat","kie$","^is$","eks$","erin","van$","ring","bena","wat$","^wor","ort$","ader","kkie","ukki","^geb","uwe$","^stu","raat","heid","tukk","kort","^vir","^van","ets$","^kor","ord$","^nuw","dit$","sal$"],"ngram_size":4,"dimension":5000},{"language":"af","weights":[0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0430108,0.0107527,0.0322581,0.0107527,0.0322581,0.0107527,0.0537634,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0322581,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0537634],"ids":[4092,1790,1946,2260,1955,1054,325,2383,4180,1507,550,1281,901,875,1297,1703,4520,3037,2143,4534,104,2285,1162,1601,60,4971,3991,2629,1915,2258,611,4066,3153,4317,2766,2262,16,2870,2256,2241,3239,4575,4650,436,2799,794,3511,1052,4366,392,2632,277,1608,4852,3849,6,271,1864,1689,384,1989,1547,2085,3244,1413,4590,1051,539,3899,2372,144,3356,873,2483,201,4381],"ngrams":["ing","ade","ben","^be","uwe","nuw","eid","ath","aat","ura","ng$","kur","kku","^ak","^nu","ts$","ets","ebr","^ge","rd$","sal","oet","^sa","the","ik$","uik","bru","at$","tek","^wa","is$","ks$","rin","wat","ir$","hei","^te","^n$","die","toe","an$","kie","van","akk","ie$","vir","kki","rui","ord","ukk","id$","tuk","^vi","stu","geb","^va","der","wor","we$","eks","^st","rt$","eri","raa","kor","ort","^wo","^ko","ena","^is","nad","it$","^to","al$","dit","^di"],"ngram_size":3,"dimension":5000},{"language":"af","weights":[0.0141844,0.0212766,0.0638298,0.0283688,0.0141844,0.0496454,0.0283688,0.0425532,0.0070922,0.170213,0.0496454,0.035461,0.170213,0.0567376,0.0070922,0.0212766,0.0851064,0.0567376,0.0780142],"ids":[88,32,96,57,11,20,59,24,2,52,19,44,68,21,63,22,79,0,66],"ngrams":["g","w","a","v","b","n","u","r","l","^","k","s","$","t","h","o","e","d","i"],"ngram_size":1,"dimension":100},{"language":"ar","weights":[0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0869565,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783,0.0434783],"ids":[903,866,378,3,788,666,54,979,640,234,685,522,678,415,505,838,771,605,62,558,30,270],"ngrams":["ب$","حس","^ح","اب","^أ","ع$","يع","سا","بي","ة$","لي","ال","يا","^ب","أي","^$","ية","تي","حت","ي$","اح","^ا"],"ngram_size":2,"dimension":1000},{"language":"ar","weights":[0.0769231,0.0769231,0.0769231,0.0769231,0.0769231,0.0769231,0.0769231,0.0769231,0.0769231,0.0769231,0.0769231,0.0769231,0.0769231],"ids":[2434,4976,1963,4160,3122,4116,1900,3947,2691,55,4616,230,2390],"ngrams":["ساب$","حساب","^أي$","لية$","^بيع","^حسا","بيع$","يالي","^احت","تيال","حتيا","احتي","الية"],"ngram_size":4,"dimension":5000},{"language":"ar","weights":[0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235,0.0588235],"ids":[819,4956,841,3853,4649,3150,2683,4490,2246,800,2878,1623,2535,3450,2397,4146,2765],"ngrams":["ساب","أي$","^أي","بيع","^بي","حتي","يع$","ية$","اب$","^حس","لية","حسا","^اح","تيا","يال","الي","احت"],"ngram_size":3,"dimension":5000},{"language":"ar","weights":[0.0344828,0.0344828,0.0344828,0.206897,0.0344828,0.0344828,0.0689655,0.137931,0.0344828,0.206897,0.0689655,0.103448],"ids":[78,55,55,52,86,87,89,73,2,68,29,40],"ngrams":["س","أ","ع","^","ة","ل","ب","ي","ت","$","ح","ا"],"ngram_size":1,"dimension":100},{"language":"az","weights":[0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00904977,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00904977,0.0135747,0.00452489,0.00452489,0.00452489,0.00452489,0.00904977,0.00452489,0.00452489,0.00452489,0.00452489,0.00904977,0.00904977,0.00452489,0.00452489,0.00452489,0.00452489,0.0180995,0.00452489,0.00904977,0.00452489,0.00452489,0.00452489,0.00452489,0.00904977,0.00452489,0.00452489,0.00452489,0.0135747,0.00904977,0.00452489,0.00904977,0.00452489,0.00452489,0.0135747,0.00452489,0.0135747,0.0135747,0.00452489,0.00904977,0.00904977,0.00452489,0.00904977,0.00452489,0.00452489,0.0226244,0.00452489,0.0180995,0.00904977,0.00452489,0.00904977,0.00904977,0.00904977,0.0135747,0.00904977,0.00452489,0.0226244,0.00452489,0.00452489,0.00904977,0.00904977,0.00452489,0.00904977,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00904977,0.00452489,0.00452489,0.00904977,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00904977,0.0180995,0.00452489,0.00904977,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.0226244,0.00452489,0.00452489,0.00904977,0.00452489,0.00904977,0.00452489,0.00452489,0.00904977,0.00452489,0.0135747,0.00904977,0.0135747,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00452489,0.00904977,0.0135747,0.00452489,0.0361991,0.00452489,0.00452489,0.00452489,0.0135747],"ids":[560,203,614,245,778,155,252,30,134,314,879,421,630,98,515,935,748,553,702,212,477,87,96,803,96,254,300,334,672,794,955,41,575,579,193,110,230,321,147,862,146,741,108,690,46,885,976,879,819,517,757,545,80,503,591,590,260,734,9,850,18,904,793,489,383,526,279,575,511,378,614,809,985,409,640,23,707,39,367,486,708,61,342,453,33,382,909,19,157,875,729,314,920,750,518,15,213,678,805,8,333,973,175,92,67,895,28,493,465,645,67,834,111,994,671,116,525,848,237,123,265,22,327,584,501,989,458,355,370,88,747,780,943,485,215,190,838,270,126,248,933,1,559,891],"ngrams":["üb","lü","^ö","ağ","ru","ş$","aş","ze","p$","ça","ra","ur","at","ik","bə","ap","mb","ğı","ğə","^p","əd","əz","əh","di","ni","av","m$","^r","da","sı","te","ma","oy","^ç","le","zd","iz","çı","ka","^d","or","ql","ak","ıq","al","^u","^o","ib","li","mi","ek","ir","nu","eç","ke","b$","lə","et","hə","qə","as","ər","to","ed","mə","on","nı","^e","zo","la","öl","nd","ri","rh","rı","u$","d$","ey","ı$","^b","ən","^k","yğ","ın","ə$","mm","əl","lı","na","un","yu","l$","ua","xa","pe","zr","əm","yn","nq","^a","ll","el","il","şı","nt","am","kt","in","ıl","^i","lm","br","ıx","iq","^z","ar","iş","i$","qa","^y","re","ıb","r$","q$","ba","a$","tu","^m","ış","az","z$","va","ot","üz","ta","ya","^$","də","rə","n$","ti","^ü","çi","^q"],"ngram_size":2,"dimension":1000},{"language":"az","weights":[0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931],"ids":[2219,4391,4698,1918,2263,1557,457,220,1578,1890,4287,447,1555,334,914,85,453,220,2238,1989,2520,3229,3790,4255,1754,3678,3193,1754,4515,2622,4196,1527,3881,731,1982,1343,770,1901,4831,1258,1409,3152,661,4956,4372,1917,329,734,660,3349,2102,522,1521,830,3054,1395,76,1165,2449,827,3469,2898,1397,765,1361,3828,3226,4868,854,1861,4126,2817,2953,4288,4547,3614,2369,2110,3249,3483,1050,1537,625,3236,119,1459,996,1148,4639,3717,858,4306,2572,4172,1237,328,3971,3500,594,2949,456,3033,1126,836,3493,2526,549,870,2770,3358,1184,1011,1113,1214,502,4009,1536,2254,4563,1824,2032,3311,4783,1860,4728,499,1510,363,4006,1008,3707,302,2517,1733,4362,1154,3664,4758,510,2764,132,4226,4057,3983,319,2376,2485,4228,4285,2049,3883,1579,3166],"ngrams":["lüb$","tağı","dakt","ktor","edak","akto","reda","baş$","^baş","tin$","zeti","^qəz","edən","^edə","rala","ural","tura","katu","ikat","arik","kari","^kar","rin$","ərin","bəri","əmbə","ğəmb","yğəm","eyğə","peyğ","mməd","ölüb","əmmə","məhə","dir$","lələ","zrə$","edir","avam","ında","etin","rını","həmm","dava","^üzr","ması","məd$","lmas","nda$","ktua","rılm","ntel","xarı","ıxar","ası$","elle","əhəm","^çıx","zdən","^int","izdə","dəni","ının","çap$","arın","^az$","ları","^məh","qlar","lıql","^un$","^miq","eyn$","ilib","^iş$","toru","iril","dən$","miq$","çiri","^keç","^ota","ləri","əniz","^red","alar","oyun","oru$","rhəl","^dən","mərh","ona$","arış","çıxa","^zon","^çap","inq$","ələr","ələl","ışın","alıb","lib$","rışı","ğınd","arıl","keçi","yarı","ağın","^yar","^edi","ərhə","rinq","əzet","üzrə","əri$","unu$","vam$","^oyu","otağ","yunu","ual$","rili","alıq","ılma","tell","llek","tual","nın$","zona","mbər","lekt","^ölü","atur","rika","şın$","eçir","hələ","ını$","ıqla","^pey","inte","^dav","^mər","^bre","qalı","ektu","qəze","brey","reyn","^qal","lıb$","nizd","^rin"],"ngram_size":4,"dimension":5000},{"language":"az","weights":[0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.015873,0.00529101,0.010582,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.021164,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101,0.010582,0.00529101,0.00529101,0.00529101,0.00529101,0.00529101],"ids":[1477,272,2272,1711,1275,2788,4842,3374,4635,3678,2413,1306,4779,2165,800,4311,4605,4589,2406,141,1507,3956,177,3189,642,2355,723,4016,1849,4258,1269,4998,4743,514,918,2980,3357,3920,2953,1486,4351,2766,4483,3695,2533,996,2327,3915,176,1145,3049,1818,4990,2163,4079,660,1150,4771,4162,2479,2765,1183,360,1317,3519,3392,354,2053,1633,4673,425,3599,1943,4005,1965,2295,2247,1267,2887,3641,694,3147,3251,1433,4538,1645,614,1174,885,1740,233,1709,2549,3342,863,4331,1224,1052,1592,486,3133,2667,1913,4301,2374,2690,3187,3732,35,3374,4378,792,3153,3614,4973,3512,2791,3109,2985,505,2644,979,1642,3211,2033,3134,1821,4249,3424,2964,3697,298,4476,615,1876,4388,3524,235,2867,1171,303,2483,1647,1876,2436,2336,916,1068,1572,3479,4856,1323,3357,1417,323,2037,1283,1126,4852,3386,1471,1678,4522,2901,571,2428,2617,3910,1124,579],"ngrams":["üb$","^öl","da$","nda","ğın","ağı","tağ","^ot","ru$","oru","akt","baş","^ba","eti","qəz","ap$","çap","zet","^ça","ala","ura","tur","ınd","atu","kat","ika","ari","kar","^ka","in$","bər","mbə","tin","əmb","ğəm","ota","yğə","mmə","əhə","^pe","məh","ir$","dir","edi","^ed","am$","ava","dav","ası","^də","mas","lma","izd","əmm","qla","iri","niz","rın","lar","tua","ıql","zrə","un$","nın","^mi","iş$","lib","red","ili","na$","lər","ktu","unu","ələ","həl","rhə","mər","qal","ri$","ləl","ərh","rə$","^mə","dən","ona","^qa","eyn","^da","ın$","çıx","^çı","kto","aş$","lıq","nı$","eçi","rış","nte","həm","iq$","^iş","^re","əd$","^ya","ən$","nu$","eda","ışı","üzr","dak","^ke","tor","rin","ekt","sı$","yun","inq","oyu","ral","məd","ell","^zo","^oy","şın","^az","nq$","eyğ","ual","ılm","yar","zon","lek","edə","ını","keç","tel","^qə","zdə","rıl","int","əri","al$","arı","^in","xar","ölü","ıxa","lüb","ib$","lıb","çir","vam","rey","^ri","yn$","ıb$","az$","bre","rik","pey","lle","əni","miq","əze","alı","^a$","^br","ril","^üz","^un"],"ngram_size":3,"dimension":5000},{"language":"az","weights":[0.00395257,0.00790514,0.00395257,0.0316206,0.00790514,0.00395257,0.0118577,0.0237154,0.0158103,0.0632411,0.0237154,0.0513834,0.0355731,0.00790514,0.055336,0.0632411,0.0237154,0.0237154,0.0197628,0.126482,0.00395257,0.0474308,0.0316206,0.126482,0.0197628,0.083004,0.0118577,0.00790514,0.0158103,0.0474308],"ids":[28,77,44,0,43,86,10,12,65,20,21,66,79,86,9,24,59,11,19,52,57,2,0,68,86,96,37,63,22,19],"ngrams":["ö","p","s","d","ü","x","ş","q","y","n","t","i","e","ğ","ə","r","u","b","k","^","v","l","m","$","z","a","ç","h","o","ı"],"ngram_size":1,"dimension":100},{"language":"be","weights":[0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0147059,0.0147059,0.00735294,0.00735294,0.0147059,0.00735294,0.0147059,0.00735294,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0147059,0.0147059,0.0220588,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0220588,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0147059,0.0147059,0.00735294,0.00735294,0.00735294,0.0147059,0.0147059,0.00735294,0.0147059,0.0147059,0.00735294,0.00735294,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0441176,0.00735294,0.0220588,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0220588,0.00735294,0.00735294,0.0147059],"ids":[890,182,627,821,322,668,341,996,209,23,83,247,50,886,505,573,807,8,0,29,117,307,56,589,965,523,270,734,279,85,850,716,982,223,957,789,376,540,349,499,469,461,968,38,431,720,565,339,352,444,856,29,404,95,868,575,272,589,425,711,805,194,364,750,914,366,782,613,978,287,632,212,107,662,795,196,936,25,639,990,693,520,436,728,817,269,284,838,679,688,267,929,327,833,192,297,532,236,280,426,304,325,370,544,464],"ngrams":["і$","нк","ін","ці","�$","�й","нн","ен","зе","в�","^ў","ро","^ч","�д","ла","ац","ал","ць","ўв","но","^н","оў","ап","чн","^п","тв","цт","^л","кі","^к","цк","ец","а�","ча","дз","^д","ае","х$","ам","^а","м$","^�","ю$","мы","�х","ню","ль","ві","^в","н�","за","ьн","^�","^з","й$","ч$","аў","ж�","бл","ва","чы","гч","т�","^м","іх","ні","ма","на","ь$","лі","^б","^т","аг","ра","ка","ме","хн","пр","оч","�е","ру","ір","ло","іл","а$","па","ым","^$","ыл","бы","ав","не","іж","др","іц","^і","ты","ук","ўн","о$","�м","е$","іч","ан","�а"],"ngram_size":2,"dimension":1000},{"language":"be","weights":[0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383],"ids":[1451,1204,1668,2031,990,292,3684,2765,4797,1601,2669,3632,3011,2052,2521,1652,303,3415,4595,4002,2036,699,1735,797,2946,2834,3206,4458,4861,2887,2700,4114,2948,4982,30,1485,2760,2672,1208,4131,2821,3722,3781,3537,3073,2413,1709,541,4341,1455,3312,3843,2533,4063,3372,4149,3013,2007,4379,4959,1552,4170,4137,3285,2655,4200,269,3899,4011,4226,4885,3222,3104,390,2326,1159,2003,1066,3745,2601,874,2064,2202,3559,3941,2520,3466,3640,3190,825,50,4797,3208,1483],"ngrams":["нкі$","інкі","^лац","енн�","роч$","проч","апро","нн�$","ала$","аноў","цінк","апан","цтва","ўніц","аўні","раўн","�дзе","іраў","кіра","кае$","пано","ецка","оўва","�мец","^кір","н�ме","лаці","^н�м","а�ам","�ам$","^апр","ча�а","цкае","хніч","т�хн","амым","�амы","^�ам","зенн","^ча�","дзен","ільн","^віл","рапа","^за$","ьню$","тым$","віль","^ўв�","прап","іж�й","ліж�","ўв�д","^блі","іцтв","ыма$","^тым","агчы","чыма","авац","ж�й$","кава","гчым","чна$","^іх$","^маг","нічн","�хні","магч","укав","ваць","вала","^дру","^т�х","было","аць$","льню","^не$","рука","^�е$","ніцт","ыло$","ўвал","ічна","мым$","в�дз","ноўв","^был","мецк","бліж","ацін","^пра","тва$","друк"],"ngram_size":4,"dimension":5000},{"language":"be","weights":[0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.0175439,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.0175439,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193,0.00877193],"ids":[4461,1469,2246,4076,2251,3259,777,775,3453,4528,2457,217,2113,737,3421,3342,851,1998,2613,1642,1708,3446,51,3618,3407,964,383,2090,10,1701,3291,2464,2659,4465,2889,2618,90,1339,693,3249,214,2945,3731,3626,1700,78,2954,639,1030,2517,416,4753,276,3361,3558,3655,441,3461,2555,755,1059,593,4262,3247,240,3228,3456,696,565,4509,1321,3448,1149,468,1078,4455,3035,3447,2988,4711,1708,1062,4827,1792,887,3998,3105,4894,1625,1146,184,4438,4095,3599,2372,3343,953,2865,326,3293,4718,2218,4757,1225,3496,1500,1085,3709,2302,1297,56,2672],"ngrams":["�е$","нкі","інк","^ла","нн�","енн","зен","�дз","^ўв","роч","про","^за","^ап","ла$","цін","іль","оч$","ала","вал","в�д","оўв","ноў","ўва","^а$","ано","пан","пра","ва$","ж�й","іцт","ўні","аўн","раў","кір","гчы","^кі","ніц","ўв�","�ме","^�е","^н�","а�а","^ча","кі$","дзе","мым","амы","апр","цка","^�а","^пр","ецк","ава","ым$","^ты","ьню","кае","^бл","віл","ае$","лац","тым","^ві","кав","іх$","за$","^не","аці","�й$","�ам","блі","цтв","н�м","ыма","чым","агч","ню$","ука","ліж","ма$","маг","^ма","мец","іж�","на$","чна","тва","ічн","ам$","т�х","ча�","н�$","хні","ць$","�хн","не$","ыло","рук","был","рап","^іх","аць","дру","^т�","апа","^др","ло$","іра","вац","^бы","льн","ніч"],"ngram_size":3,"dimension":5000},{"language":"be","weights":[0.0189873,0.0189873,0.0253165,0.0126582,0.00632911,0.00632911,0.00632911,0.0443038,0.139241,0.0316456,0.0253165,0.0189873,0.0253165,0.0126582,0.0253165,0.0316456,0.0632911,0.00632911,0.0253165,0.0506329,0.0126582,0.0189873,0.0126582,0.0253165,0.0126582,0.120253,0.0126582,0.139241,0.0316456,0.00632911,0.0126582],"ids":[41,20,32,50,36,81,15,85,52,10,70,20,67,26,72,30,81,79,39,34,54,15,52,82,10,63,49,68,44,89,52],"ngrams":["п","ў","�","з","й","ж","г","м","^","в","ч","т","ы","б","ц","е","н","у","к","і","ь","о","х","р","д","а","�","$","л","ю","�"],"ngram_size":1,"dimension":100},{"language":"bg","weights":[0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.00833333,0.00833333,0.0166667,0.00833333,0.0166667,0.00833333,0.00833333,0.0166667,0.0166667,0.00833333,0.00833333,0.00833333,0.0166667,0.00833333,0.00833333,0.025,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.025,0.0166667,0.0166667,0.05,0.0166667,0.0166667,0.025,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.0166667,0.0166667,0.0333333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.025,0.0166667,0.0166667,0.00833333,0.0166667,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.025,0.00833333,0.00833333,0.0166667,0.00833333,0.0583333,0.00833333,0.00833333,0.0166667,0.0166667,0.00833333,0.0166667],"ids":[996,736,764,514,662,929,711,490,212,498,426,807,750,856,99,795,154,120,927,25,672,922,673,691,145,476,429,475,178,718,941,85,310,404,117,703,325,988,359,544,899,387,625,294,978,653,789,544,269,95,97,580,65,613,782,376,967,954,389,435,577,729,141,692,965,783,635,375,461,817,499,960,694,352,802,838],"ngrams":["ен","�е","ър","тъ","ра","не","ва","зи","^т","од","о$","ал","^м","за","�к","ка","д�","р�","ум","пр","иц","ни","�$","тр","аз","та","и$","и�","кл","ми","пи","^к","зп","^�","^н","из","е$","те","ие","ит","кв","ъ�","�ъ","ед","в$","ду","^д","ан","па","^з","да","ад","ко","на","ма","по","ов","^и","лю","�н","чо","юч","ци","лк","^п","оп","о�","�т","ре","а$","^а","д$","то","^в","ви","^$"],"ngram_size":2,"dimension":1000},{"language":"bg","weights":[0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.025641,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.025641,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.025641,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.025641],"ids":[1764,669,639,2372,3260,3915,1759,1046,2567,412,3289,2168,3406,2187,4249,2120,2060,274,3615,4248,804,1302,1938,71,2854,2366,1898,3073,2447,2412,3170,3810,3365,215,4604,1677,3553,265,3816,4121,517,64,2059,1588,4198,4857,3650,4205,4967,1655,3928,1219,4325,935,1892,2277,269,3700,954,1400,807,456,4110,2635,2215,3978,1035,3137,837,1730,2896,35,3314,4831],"ngrams":["ър�е","ците","ицит","ници","аниц","рани","тран","ане$","^�тр","�ква","и�кв","под$","^под","лко$","малк","ана$","�ъ�т","ума$","азан","ене$","каза","�ние","�каз","зи�к","ние$","д�ка","ед�к","^за$","алко","�ене","кван","^на$","ред�","пада","пред","^пре","думи","^тър","^изи","^поп","чови","р�ен","ключ","ючов","овит","^то$","лючо","^клю","то�н","тани","опад","ване","зпит","итан","�тра","уми$","ите$","изпи","пита","^мал","^изп","зана","�то�","изи�","вите","ада$","попа","^�ъ�","ание","ъ�то","дума","тър�","о�ни","^дум"],"ngram_size":4,"dimension":5000},{"language":"bg","weights":[0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0204082,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0204082,0.0102041,0.0102041,0.0102041,0.0102041,0.0204082,0.0102041,0.0102041,0.0102041,0.0204082,0.0204082,0.0102041,0.0204082,0.0102041,0.0102041,0.0204082,0.0204082,0.0102041,0.0102041,0.0102041,0.0102041,0.0204082,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0204082,0.0204082,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041,0.0204082,0.0102041,0.0306122,0.0102041,0.0102041,0.0102041,0.0102041,0.0102041],"ids":[2955,574,3484,3095,2784,2355,2465,1881,3343,3743,2053,4637,510,3029,4003,924,3599,1080,151,801,4833,1062,2699,1406,2084,3116,2168,1384,3649,3879,2790,961,3240,4365,2133,43,74,416,3806,3215,4066,2967,4315,371,4665,4323,4914,2579,4329,2980,3564,585,4489,3179,3228,3024,3450,248,4711,3618,209,3513,4821,527,4287,4347,77,4725,965,217,2377,4559,3978,1556,458,2350,4036,2406,887,1499,188,3890,511,350],"ngrams":["р�е","ър�","^тъ","ене","цит","ици","�тр","^�т","не$","ван","�кв","и�к","изи","то$","^то","од$","лко","тра","алк","ко$","мал","^ма","ана","ниц","зан","�ка","то�","д�к","тър","ква","зи�","люч","пит","ред","пре","каз","да$","^пр","�ъ�","^�$","те$","вит","уми","ючо","клю","дум","^кл","под","ада","^ду","ани","ита","ите","изп","за$","^на","ие$","ми$","ма$","^а$","�ни","ние","о�н","^�ъ","чов","зпи","�ен","^по","^из","^за","аза","ови","�то","ъ�т","пад","ане","^в$","тан","на$","опа","ед�","поп","ран","ума"],"ngram_size":3,"dimension":5000},{"language":"bg","weights":[0.00704225,0.028169,0.056338,0.00704225,0.0492958,0.00704225,0.0492958,0.0211268,0.0211268,0.0704225,0.0422535,0.0352113,0.0352113,0.00704225,0.0140845,0.0140845,0.028169,0.028169,0.15493,0.056338,0.0140845,0.0985916,0.15493],"ids":[70,39,30,32,20,89,49,85,82,98,15,41,10,72,42,44,50,10,52,81,79,63,68],"ngrams":["ч","к","е","�","т","ю","�","м","р","и","о","п","д","ц","ъ","л","з","в","^","н","у","а","$"],"ngram_size":1,"dimension":100},{"language":"bn","weights":[0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00542005,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00813008,0.00271003,0.00271003,0.00542005,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00542005,0.00271003,0.0135501,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00542005,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00542005,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00542005,0.00542005,0.00271003,0.00271003,0.00271003,0.00813008,0.00271003,0.00271003,0.00271003,0.00271003,0.00542005,0.00542005,0.00271003,0.00542005,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00542005,0.00271003,0.00542005,0.0108401,0.00813008,0.00271003,0.00813008,0.0162602,0.00271003,0.0108401,0.00542005,0.00271003,0.00813008,0.00271003,0.00271003,0.00271003,0.00271003,0.0162602,0.00813008,0.0108401,0.00271003,0.00271003,0.0108401,0.00271003,0.00542005,0.00271003,0.00542005,0.00271003,0.00271003,0.0162602,0.00271003,0.00271003,0.00271003,0.00271003,0.0108401,0.00271003,0.0108401,0.00271003,0.0135501,0.00271003,0.0108401,0.00271003,0.00813008,0.00813008,0.00542005,0.00271003,0.00271003,0.00271003,0.00271003,0.00542005,0.00542005,0.0135501,0.00271003,0.00542005,0.00542005,0.00271003,0.00271003,0.0108401,0.00542005,0.00271003,0.0271003,0.00271003,0.00542005,0.00271003,0.00271003,0.00271003,0.00813008,0.00271003,0.00271003,0.00542005,0.00542005,0.0135501,0.00542005,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00813008,0.00813008,0.00542005,0.00542005,0.00271003,0.00271003,0.00813008,0.00542005,0.00542005,0.00271003,0.00271003,0.0135501,0.00271003,0.00271003,0.00271003,0.00542005,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.00271003,0.0108401,0.00271003,0.00813008,0.00542005,0.00271003,0.00542005,0.00542005,0.00271003,0.00271003,0.00271003,0.00813008,0.00542005,0.00271003,0.00271003,0.00542005,0.00271003,0.00542005,0.00542005,0.00271003,0.0108401,0.00271003,0.00542005,0.00542005,0.0216802,0.00813008,0.00271003,0.00271003,0.00271003,0.00542005,0.00271003,0.0108401,0.00271003,0.0108401,0.00271003],"ids":[671,191,109,419,453,936,336,840,917,241,214,569,77,500,777,255,616,158,146,710,118,372,172,235,461,659,472,376,680,373,637,876,554,36,244,838,23,355,239,979,848,277,781,695,207,191,783,927,154,585,857,744,345,662,661,286,135,296,552,351,98,321,991,471,890,302,137,392,534,1,642,791,297,918,92,69,243,669,274,724,769,937,411,317,352,417,407,382,908,923,913,425,871,253,235,105,495,277,52,590,573,624,472,256,584,266,868,888,654,528,45,599,523,448,153,647,943,290,153,532,111,761,105,93,455,443,523,948,892,53,910,516,200,829,470,230,816,225,388,524,505,92,419,227,353,923,688,189,69,357,324,730,377,378,38,970,382,726,783,710,576,85,855,752,161,517,696,634,691,516,860,917,693,929,559,924,616,679,837,259,615,336,597,760,25,801,712,86,238,12,796,443,830,427,792,214,684,673,281,671,863,382,916,927,80,911,246,157,555,636,817,649],"ngrams":["িন","াহ","ল�","দ�","আব","^জ","�ম","ষো","দর","কজ","ষে","েছ","মন","েশ","য$","ধা","প�","ফব","তে","দি","�দ","োত","লো","�ল","গ�","^�","�চ","^ই","শি","যত","যে","োস","ষত","পা","ভ$","^$","ইস","ধী","োধ","লা","য়া","আয়","বল","�ট","দক","ফ�","^হ","পন","াজ","ইয়","তপ","টা","স�","�ন","�গ","ট$","ডম","াব","�ক","তী","�ড","�ট","^য","গ�","আল","য়$","িদ","আই","ধ$","�ফ","রব","�ধ","য�","মর","দ�","পক","^ন","�ই","ক$","শ�","বে","লি","মা","ে$","ীয়","বি","িল","নব","লে","কি","রশ","�ি","াধ","ের","নে","^ব","চৌ","^ম","তা","দে","নি","হা","^ও","অন","মত","�র","রম","�ব","িষ","জব","^দ","^শ","তি","সভ","া$","না","ান","বক","�ষ","ক�","েন","�জ","নপ","াগ","চয়","^অ","াম","^আ","^গ","^ে","াত","ওয়","ি�","ন�","^ত","রী","র$","�শ","কে","সম","�র","�ত","র�","শা","আউ","ো","িস","�য","^া","হ$","োভ","রত","োজ","তর","ও$","পত","ি$","াপ","^ক","িয়","ভা","িজ","^স","প$","য়ে","শক","রো","^প","সো","�ল","ৌধ","াস","শন","উট","^ফ","অ�","আন","টব","রা","পর","ল$","াল","ষি","ির","বা","�ন","কপ","য়ত","জন","ী$","িআ","ই$","ব�","^চ","িশ","জা","মি","িক","জি","শ$","াশ","ন$","যা","ছে","াক","য়ো","কা","ধ�","ার","^�","সি","পি"],"ngram_size":2,"dimension":1000},{"language":"bn","weights":[0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00757576,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00757576,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00757576,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00757576,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00757576,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788,0.00378788],"ids":[4044,4409,3362,769,1337,1179,1739,4246,4477,1321,181,348,3640,3500,599,4027,4775,4187,4630,1712,47,3868,1461,2552,2349,2209,1931,3293,3245,2438,2550,3119,4545,2495,3586,152,4376,52,1712,1494,4188,1515,2429,4786,1997,756,2874,1228,3849,2868,4782,234,2541,4949,34,4983,2098,2202,1741,2476,2848,4033,941,1613,2921,4252,3158,662,1315,1695,2527,1936,61,4856,2636,4808,3422,1583,3139,674,3129,2693,2326,4773,1102,389,4326,2418,4171,791,739,2323,774,2145,4766,4941,2780,3938,2818,2614,844,775,3143,454,1504,2307,4824,3608,3192,1356,2633,1941,3746,3871,3641,627,3152,266,2096,4844,1741,1096,4019,1858,4601,2366,3705,4562,662,3812,3590,2938,1817,1019,2384,1718,3199,1833,1816,1432,2660,4556,4045,2951,3761,492,1264,4914,4375,248,3137,2982,709,4930,1775,4511,860,4032,1749,3531,3218,4962,1809,3777,4917,4511,724,4632,3466,4905,2431,1800,3134,1700,4229,2451,2169,2413,3584,4974,2952,1310,4610,3662,2860,4523,3826,3084,3964,3396,4233,2023,1904,1101,3962,1998,1928,3749,2374,4679,4664,3950,2942,2761,1509,3159,4680,931,3875,897,1843,3452,1294,1773,4753,1555,2751,1561,1086,3471,2496,699,3104,4568,4632,4068,2662,2451,1060,1784,848,3745,1624,3753,1,2517,3962,1215,497,1362,1914,4170,2185,4830,2276,2110,1616,4489,3464,18,4099,1213,4225,893,3327,859,4022,1148,4117],"ngrams":["তিন$","রতিন","বলেন","^বলে","ামান","োমা","�লাহ","ল�লা","দ�ল�","ব�দ�","আব�দ","^আব�","বাবে","জবাব","^জবা","লাহ$","শ�নে","রশ�ন","�রশ�","প�রশ","�মন$","^�মন","�কজন","^�কজ","^কি$","াবে$","যাবে","^যাব","েছেন","িয়েছ","^দিয়","ান�য","ধান�","াধান","রাধা","প�রা","^প�র","োতে$","�লোত","গ�লো","�য�গ","^হার","স�য�","^আল$","নিশ�","^নিষ","ইস�য","^�ফব","^ইস�","াতীয়","তারা","^তার","নোম","�বকা","াপাশ","শাপা","পাশা","তার$","যতার","�যতা","াগ�য","জাতী","^যো","ক�ষত","াশাপ","গ�যত","�টার","দক�ষ","ছেন$","োজনব","দেশ$","ষোভ$","�ষোভ","ন�য$","সিআই","ক�ষো","িক�ষ","^শ�র","নবির","জনবি","আয়োজ","টবল$","দর�শ","ধ�রী","ফ�টব","কাপ$","শ�বক","িশ�ব","সিজন","বিশ�","তীয়$","টার$","^বিশ","জিলে","রাজি","ব�রা","�রমি","�গ�ল","^ের$","য়োজন","^ব�র","য়েছে","িজন$","ডমাস","ন�ডম","বেশ$","ান�ড","যান�","র�যা","র�শক","গ�র�","^গ�র","�রতি","আইয়$","িআইয়","েশনে","পাশি","ৌধ�র","�যান","মাবে","াসোস","িসিআ","াস�ট","�নে$","বিসি","�টবল","দ�ধ$","নপির","বিক�","োগ�","মান$","�শকে","যাসো","^আন�","াতিক","াবেশ","চয়তা","মতি�","�িলে","^আয়ো","^অ�য","�ল�ল","ি�িল","রবাল","^সমা","^তপন","য়তা$","�চয়ত","শ�চয়","য�গ�","লেন$","^জাত","িশ�চ","ারা$","�রাধ","অনিশ","^সিজ","োসিয়","^কান","^চৌধ","মিকে","ামর$","�ষের","^পাশ","^দর�","�না$","িষিদ","^ালি","^নো","তি�ি","�রাজ","^মতি","�ষতা","^বিক","িকপক","ান�ন","কান�","দিয়ে","^দেশ","ষের$","সিয়ে","ক�ষে","স�টা","�ফবি","লোতে","লিকপ","নিষি","ন�তর","িলে$","ষতা$","ালিক","তর�জ","রামর","^�রত","^পরা","াজিল","ফবিস","তিক$","াশি$","�তর�","আউট$","তপন$","িদ�ধ","পরাম","আন�ত","�র�য","জাতি","�ডমা","য়াক$","য়েশন","পতি$","শ�রম","কপক�","^দক�","রোধী","বাল$","ভাপত","সিসি","ন�না","�দ�ল","িকের","সভাপ","শকের","বিরো","মাস�","চৌধ�","শনের","িয়েশ","^�ই$","সোসি","নের$","^ফ�ট","োধী$","হারব","কজন$","াপতি","ষিদ�","^ওয়া","যোগ","^সভা","িরোধ","সমাব","�যাস","রমিক","^�নপ","�জাত","র�জা","িসিস","কের$","�রী$","পক�ষ","ওয়াক","পির$","অ�যা","ারবা","^অনি","^আউট","বকাপ","�নপি"],"ngram_size":4,"dimension":5000},{"language":"bn","weights":[0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.0189873,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00949367,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00949367,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00632911,0.00316456,0.00316456,0.00949367,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00632911,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456,0.00316456],"ids":[3467,2136,1564,2104,912,571,2647,2181,2474,1184,1079,3166,4496,376,988,3614,4018,2831,1982,4239,1428,4254,1277,2037,3441,1290,3029,1107,3382,1054,3429,3709,1543,3619,1924,2521,4970,1716,3419,3309,2085,3336,309,12,2685,4626,3217,639,2652,161,1719,187,248,1478,3444,1786,3901,2982,3503,444,947,3553,2342,145,2667,905,2351,15,4084,506,1579,2453,2071,1914,353,3994,2377,2617,3152,4906,1324,3134,2138,1365,2274,28,2986,1657,1237,1176,1465,2722,698,2980,1249,1536,1242,4571,428,4852,2122,3307,3051,2975,4503,4104,1999,1743,4036,3710,2333,1610,2902,2503,3168,1998,2998,1427,252,4861,4677,539,2679,4174,4820,2233,4636,396,3073,4236,347,97,846,2313,3276,4346,3665,893,4711,4365,2888,2980,4199,991,3554,4461,3490,4053,4355,1974,2466,2519,3041,4124,1899,3869,3787,3527,678,3237,388,4554,3924,4040,1332,439,4628,2988,512,2137,807,885,453,805,1176,599,1257,2562,136,1205,3628,4385,1707,2172,610,1369,3433,3795,4311,3754,2322,4170,4373,4514,4071,715,3526,3812,1977,2526,1618,4555,2664,203,3415,690,2018,4235,2246,2516,747,665,1001,2184,616,4260,1163,4575,4186,1818,3054,2413,1213,3797,973,2602,571,785,3992,1389,247,1350,4209,4551,2471,613,3014,1351,3990,1541,4750,4337,92,1275,2656,1832,1534,4322,1992,1534,4404,479,962,2181,1186,909,1399,753,2446,13,2379,4600,1498,2758,3981,4709,1725,3352,146,1304,2071,1490,3565,817,254,3951,3364,4025,2061,3321,3173,1760,2163,3537],"ngrams":["তিন","রতি","�রত","^�র","�ই$","^বল","ান$","মান","নো","^নে","^আল","াহ$","লাহ","�লা","ল�ল","দ�ল","ব�দ","জবা","নে$","�নে","শ�ন","রশ�","�রশ","মন$","�মন","র�শ","^দর","কি$","^া$","েন$","�দ�","ছেন","েছে","দিয়","^দি","ধান","াধা","রাধ","প�র","তে$","�লো","গ�ল","বে$","য�গ","�য�","ীয়$","তীয়","াতী","^জা","ন�য","রা$","^আব","ারা","^যা","শি$","াশি","টার","জাত","াপা","শাপ","াশা","^পা","তার","গ�য","^ওয়","তি�","^ও$","ষতা","^�ফ","�ষত","লেন","জিল","দক�","ামা","^দক","দর�","োভ$","াজি","�যত","ষোভ","মতি","িক�","স�য","�বক","বিক","োধী","আউট","নবি","জনব","^অ�","যতা","োজন","�না","য়োজ","আয়ো","^আয়","টবল","^ফ�","াপ$","বকা","বিশ","^প�","অনি","রাজ","িজন","শ�ব","সিজ","^সি","�টা","ের$","িক$","াস�","মাস","শ�চ","যান","�র�","ইয়$","িন$","গ�র","আইয়","^সভ","াতি","সিআ","িসি","�ফব","িদ�","ষিদ","েশ$","বেশ","দ�ধ","াবে","োগ","�কজ","মাব","সিস","^কা","লে$","�টব","িলে","�ধ$","�িল","ি�ি","^কি","ার$","^�ই","ন�ন","যাস","^মত","মিক","চয়ত","^বি","োসি","নিশ","ামর","না$","ফবি","^নি","যাব","পতি","শনে","^জব","^�ক","াল$","কের","কাপ","�ডম","ান�","�জা","^াল","ষের","আল$","বিস","�ষে","�গ�","ব�র","স�ট","^গ�","অ�য","^যে","কপক","^ইস","ফ�ট","িষি","িয়ে","লিক","িকে","জন$","�চয়","বল$","সমা","তপন","রাম","আন�","^�ন","িকপ","^তা","পরা","^পর","পক�","তিক","বির","ন�ড","সোস","�শক","তা$","িশ�","শকে","�রী","ক�ষ","দেশ","^চৌ","তর�","�তর","োতে","�রা","^ের","বাব","লোত","ইস�","^শ�","�রম","ালি","^�ম","মর$","াগ�","ন�ত","�য$","^আন","�ষো","কজন","য়েছ","নের","^অন","য়েশ","^তপ","াসো","নিষ","নপি","উট$","�যা","আব�","য়তা","িআই","রবা","রমি","রোধ","বাল","শ�র","চৌধ","পাশ","ারব","^হা","রী$","হার","ৌধ�","বলে","পন$","য়াক","ওয়া","^ব�","�ল�","কান","^সম","েশন","াপত","সিয়","তি$","ভাপ","^প$","াক$","যো","ির$","পির","^আউ","োম","^দে","র�য","সভা","ডমা","ধী$","র�জ","িরো","ধ�র","�নপ"],"ngram_size":3,"dimension":5000},{"language":"bn","weights":[0.00236967,0.00236967,0.007109,0.00947867,0.014218,0.00236967,0.0165877,0.0118483,0.0236967,0.0165877,0.00473934,0.0236967,0.021327,0.0331754,0.00473934,0.0473934,0.00947867,0.0165877,0.00236967,0.00473934,0.028436,0.028436,0.00236967,0.00473934,0.014218,0.0545024,0.007109,0.0616114,0.0165877,0.125592,0.007109,0.00473934,0.125592,0.0545024,0.007109,0.0805687,0.0473934,0.0118483,0.00473934,0.0260663,0.0118483],"ids":[53,80,14,80,69,47,34,62,26,21,7,87,23,74,30,48,37,98,85,53,89,63,28,93,76,87,20,62,63,68,55,90,52,97,0,76,39,24,17,59,45],"ngrams":["ছ","ড","গ","ষ","দ","�","জ","ো","শ","য","অ","ল","স","ব","হ","ে","ধ","ম","ৌ","চ","ত","ক","উ","ও","আ","ি","ই","�","য়","$","ী","ভ","^","র","ট","া","ন","�","ফ","প","�"],"ngram_size":1,"dimension":100},{"language":"bs","weights":[0.00152439,0.00152439,0.00152439,0.00152439,0.00152439,0.00152439,0.00152439,0.00304878,0.00914634,0.00152439,0.00152439,0.00152439,0.00152439,0.00152439,0.00152439,0.00304878,0.00152439,0.00152439,0.00152439,0.00152439,0.00457317,0.00152439,0.00457317,0.00609756,0.00457317,0.00152439,0.00152439,0.0198171,0.00152439,0.00152439,0.0106707,0.0152439,0.00152439,0.00609756,0.00152439,0.00152439,0.00609756,0.00457317,0.00304878,0.00304878,0.00152439,0.00304878,0.00152439,0.00304878,0.00152439,0.00152439,0.00457317,0.00152439,0.00152439,0.00304878,0.00152439,0.00152439,0.00304878,0.00304878,0.00152439,0.00152439,0.00457317,0.00304878,0.00152439,0.00152439,0.00304878,0.00304878,0.00304878,0.00457317,0.00609756,0.00152439,0.00152439,0.0121951,0.00152439,0.00914634,0.00609756,0.0121951,0.00152439,0.00457317,0.00152439,0.00304878,0.00152439,0.00304878,0.0121951,0.00304878,0.00152439,0.00152439,0.00609756,0.00304878,0.00304878,0.00457317,0.00152439,0.00457317,0.00304878,0.00609756,0.00152439,0.00152439,0.00152439,0.00152439,0.00457317,0.00152439,0.0106707,0.00152439,0.00152439,0.00152439,0.00609756,0.00762195,0.0137195,0.00152439,0.00152439,0.00304878,0.0106707,0.00609756,0.00152439,0.00457317,0.00609756,0.00457317,0.00609756,0.00152439,0.00152439,0.027439,0.00152439,0.00457317,0.00762195,0.00457317,0.00152439,0.00152439,0.00762195,0.00152439,0.0152439,0.00914634,0.00152439,0.00152439,0.00457317,0.00609756,0.00304878,0.00152439,0.00152439,0.00457317,0.00152439,0.00457317,0.00457317,0.00152439,0.00304878,0.00609756,0.00152439,0.00152439,0.00457317,0.00762195,0.00152439,0.00152439,0.00304878,0.00609756,0.00152439,0.0137195,0.00304878,0.00457317,0.0228659,0.00457317,0.00152439,0.00152439,0.00304878,0.00304878,0.00914634,0.00609756,0.00457317,0.00304878,0.00609756,0.0152439,0.00914634,0.00152439,0.00152439,0.0259146,0.0381098,0.0121951,0.00457317,0.00152439,0.00304878,0.00152439,0.00304878,0.00304878,0.0259146,0.00609756,0.00152439,0.00152439,0.00762195,0.00304878,0.00152439,0.00152439,0.00152439,0.00152439,0.0121951,0.0137195,0.00304878,0.00457317,0.00152439,0.00609756,0.00152439,0.00609756,0.00762195,0.00609756,0.00914634,0.00457317,0.0198171,0.00457317,0.00609756,0.00762195,0.00609756,0.00152439,0.0106707,0.00762195,0.00152439,0.00457317,0.00609756,0.00457317,0.00609756],"ids":[748,27,895,732,511,88,671,656,854,314,535,67,613,117,545,327,757,317,273,493,707,707,843,630,682,332,963,212,34,887,862,885,745,120,679,576,677,109,920,834,973,514,7,526,166,496,976,631,734,838,887,635,886,980,7,191,146,540,637,438,349,353,819,116,895,421,381,671,50,108,3,780,421,200,877,80,384,73,879,301,999,71,725,861,300,334,287,672,486,61,822,102,98,907,114,605,532,782,763,875,978,493,157,594,809,176,68,803,90,793,651,215,778,648,386,651,575,19,933,392,205,211,887,54,96,786,510,943,170,254,927,175,209,503,289,230,323,227,875,125,652,804,985,791,518,763,892,265,752,532,402,512,23,591,893,766,487,504,676,829,670,41,378,269,826,677,501,685,989,364,732,925,463,128,622,544,848,248,829,307,153,173,747,364,915,239,75,648,287,955,854,333,841,356,355,8,629,470,645,591,942,147,122,996,489,128,760,553,75,702,403],"ngrams":["mb","si","št","^š","zo","az","ću","bo","^n","l$","^l","nt","t$","ža","ir","r$","ek","o�","eb","lo","ce","d$","vo","at","rv","ob","ci","^p","gu","v$","^d","^u","ug","im","au","už","i�","zv","ua","br","el","du","ći","on","sv","kr","^o","že","et","^$","oć","uj","eg","^t","sa","ku","or","os","ut","ć$","se","er","li","ar","am","đu","fe","^z","eđ","ak","j$","va","ur","st","ez","nu","ns","ća","ra","vr","ge","^v","^ć","vj","m$","^r","uv","da","^b","^k","aa","cy","ik","ag","do","y$","o$","dr","ad","un","bi","in","na","ju","nd","lu","^j","di","^f","to","�n","ta","ru","f$","dž","e$","^e","ol","ti","ud","ev","uf","oj","ft","ni","is","s$","ot","sr","av","mu","il","�e","us","ać","iz","ić","iv","k$","ji","dj","h$","ri","ij","uu","zj","vl","re","ha","^s","od","ic","u$","ke","mo","ab","om","tv","za","sk","ms","ma","la","an","ko","ef","ba","je","a$","vi","su","^g","ih","jo","lj","sj","i$","n$","ši","nc","en","ei","z$","uk","io","zu","pr","ov","it","te","ac","dn","eš","me","^m","^a","ja","rb","^i","ro","će","ka","sl","ds","ed","po","ok","go","nj","aj","no"],"ngram_size":2,"dimension":1000},{"language":"bs","weights":[0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00678733,0.00678733,0.00452489,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00452489,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00678733,0.00226244,0.00226244,0.00452489,0.00452489,0.00226244,0.00678733,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00678733,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00452489,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00452489,0.00904977,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00678733,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00452489,0.00678733,0.00904977,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00678733,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00678733,0.00678733,0.00678733,0.00678733,0.00226244,0.00226244,0.00226244,0.00678733,0.00226244,0.00226244,0.00226244,0.00678733,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00678733,0.00452489,0.00226244,0.00226244,0.00226244,0.00904977,0.00226244,0.00904977,0.00452489,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244,0.00226244],"ids":[2271,4318,3222,1967,3289,455,2517,611,2349,160,2936,3799,1911,1676,4596,164,2989,1079,4473,4404,216,4367,2916,3616,3876,3878,1883,2473,2858,484,691,1949,3616,1391,2571,3218,2124,2431,4885,631,2021,4345,410,4620,4312,2371,2991,1070,4654,1048,2612,3861,3220,4202,603,813,860,4728,4864,3689,2204,2790,671,353,2274,1520,1145,3364,3045,856,4397,1629,4651,328,4831,3906,2134,1987,2952,2531,1108,3377,2406,1466,3596,738,872,325,4049,1630,3827,1888,1810,2041,1175,2967,3818,3091,4065,4407,15,2326,4616,196,670,1020,1670,4240,2251,3679,1130,4901,3616,2214,2403,463,855,4326,2946,3879,1725,1582,4677,4069,4851,3302,4473,3665,712,3290,1431,3916,1755,66,370,394,2175,4295,2138,161,1499,1884,4621,3642,4100,4245,422,1267,3692,3236,4835,2683,1524,59,435,4493,2792,2033,4698,4374,2816,1148,3614,4970,2131,807,3645,209,4249,1582,491,1762,3808,2262,4778,4516,3748,532,1312,1034,3071,3914,2,1398,548,3813,2246,1045,4919,3146,881,1166,73,4463,1410,4078,2567,334,2070,3677,2653,1916,1804,4064,1677,4095,1948,2000,4113,4605,2297,417,4512,1050,1500,1706,3800,1357,1662,500,70,4193,4593,270,1170,4439,3318,299,1787,37,2366,4757,4439,2536,3216,3506,3070,218,3384,132,504,4708,1471,1003,2011,210,4854,3784,663,1898,2743,1386,2637,59,2987,4123,2459,344,3109,571,941,1207,1982,110,4686,2914,1389,3909,1712,4882,3543,4928,3756,3702,1297,1795,1671,4755,1018,2389,827,640,1295,2230,311,941,972,2887,803,67,3680,4754,2970,1160,903,2200,3000,1454,2714,4119,558,2563,3743,1367,23,2405,447,4690,3572,3650,3899,318,4712,1502,772,1051,3266,2765,3735,843,1383,2150,3719,3677,1055,906,4438,3160,1261,1968,1388,4862,3280,26,2979,4547,601,3426,4236,4594,804,3376,812,1685,654,893,2507,1095,53,934],"ngrams":["vanj","ovan","imen","tez$","�ni$","i�ni","mbol","^sim","ivi$","priv","što$","viću","azov","avaz","eti$","jeti","sjet","osje","posj","noj$","viti","avit","orav","ati$","simb","rati","vira","ovir","movi","oli�","omov","romo","prom","�no$","koji","^koj","isu$","joj$","ravi","^joj","vat$","ovat","i�no","tvov","stvo","pote","ustv","pris","uje$","o�ek","^o�e","^se$","ruar","brua","ebru","febr","vini","ovin","olov","imbo","voj$","vova","prvo","jena","bavl","obav","^oba","iti$","avlj","^bit","^bor","raci","urac","isus","naug","ani�","vani","zvan","ara$","enov","uara","kuje","�na$","nuar","^pot","anua","janu","ran$","bran","abra","zabr","izab","tom$","^tom","djel","odje","^pod","ervj","odin","seda","^sed","oro$","^meš","lima","kon$","akon","nako","^što","bora","stva","vih$","kril","i�na","okri","gova","^okr","tak$","agen","vrat","eisu","polo","povr","lovi","nima","^pov","žena","oji$","^jan","koro","biti","ovi$","ruže","ića$","ćanj","pruž","gov$","jedi","^pru","reis","uka$","ruka","ina$","^ruk","edam","skor","ova$","adol","sand","ovra","^nje","ljen","aka$","�eku","^zva","rilj","džak","^pri","rvoj","ndža","rbij","andž","oru$","toru","genc","pros","^pro","ni�n","^jed","^na$","nuta","ima$","^aa$","njeg","anim","^nak","vio$","mani","iman","slim","vjer","^mus","utar","�noj","podj","srbi","eđu$","atak","edsj","^međ","meši","nado","tva$","dam$","zovi","nstv","dins","acij","dsje","unut","lud$","lams","^izu","edin","sust","rata","hata","nja$","aćan","^rei","augu","raća","vrać","^iza","lje$","oći$","^doć","dića","ako$","avio","^uvj","usli","jere","vazo","tija","kako","vlud","nik$","^prv","ncy$","tar$","ency","dina","isla","ija$","ugur","dolu","^dr$","dić$","^age","inte","^ana","^pol","^san","dnik","^za$","dudi","juu$","^kak","vjuu","rvju","reds","^da$","^je$","izja","nova","eren","nter","^kav","^zaj","olu$","užen","javi","ilje","svih","zjav","^izj","inst","irat","musl","udić","^dud","^ef$","ović","evlu","rivi","^te$","jego","^mev","gura","doći","^int","šiha","među","ufti","^muf","ske$","nice","ren$","žaka","^god","zus$","^pos","cija","izus","jela","ena$","iji$","^će$","kava","godi","ihat","ini$","biji","ice$","anad","muft","^svi","ekuj","^do$","uvje","iću$","risu","osto","terv","zaje","mske","dnic","^srb","amsk","sjed","^ime","ela$","^isl","mevl","meno","otez","slam","^unu","ata$","vlje","stor","^feb","^ina","ajed","egov","rost","eših","novi","edni","boli","jedn","anja","pred","li�n","^pre","inau","^vra","ftij","^sko","^nov"],"ngram_size":4,"dimension":5000},{"language":"bs","weights":[0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00547445,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00729927,0.00364964,0.00364964,0.00182482,0.00182482,0.00729927,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00729927,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00547445,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00364964,0.00547445,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00364964,0.00182482,0.00182482,0.00364964,0.00364964,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00729927,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00729927,0.00364964,0.00182482,0.00912409,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00547445,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00547445,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00547445,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00364964,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00547445,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00729927,0.00182482,0.00729927,0.00364964,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00729927,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00547445,0.00182482,0.00182482,0.00182482,0.0109489,0.00547445,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00547445,0.00364964,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00364964,0.00364964,0.00182482,0.00182482,0.00364964,0.00182482,0.00547445,0.00182482,0.00364964,0.00182482,0.00364964,0.00182482,0.00182482,0.00182482,0.00182482,0.00729927,0.00182482,0.00364964,0.00547445,0.00182482,0.00182482,0.00729927,0.00182482,0.00547445,0.00182482,0.00182482,0.00182482,0.00547445,0.00364964,0.00364964,0.00182482,0.00364964,0.00182482,0.00182482,0.00912409,0.00729927,0.00547445,0.00547445,0.00729927,0.00547445,0.00182482,0.00182482,0.00547445,0.00182482,0.00547445,0.00182482,0.00182482,0.00182482,0.00182482,0.00182482,0.00364964,0.00547445,0.00182482,0.00547445,0.00182482,0.00364964,0.00547445,0.00364964,0.00547445,0.00182482,0.00364964,0.00729927,0.00182482,0.00182482,0.00182482,0.00182482,0.0145985,0.00182482,0.00182482,0.00182482,0.00182482,0.00912409,0.00182482,0.00182482,0.00182482,0.00364964,0.00547445,0.00182482,0.00547445,0.00182482,0.00182482,0.00182482,0.00182482,0.00912409,0.00182482,0.00182482,0.00182482,0.00182482,0.00547445,0.00182482,0.00364964,0.00182482,0.00182482,0.00729927,0.00912409,0.00182482,0.00182482,0.00182482,0.00364964,0.0145985,0.00182482,0.00547445],"ids":[1765,2640,3106,3498,4307,4912,1591,2908,2822,442,2119,1928,4628,3565,2259,1174,1305,2656,2523,4176,1785,4731,2098,3875,2825,539,3136,4240,2667,3237,1026,3269,4286,4853,2101,3597,1987,1317,3098,4259,3991,3037,4405,1353,16,4639,4721,4036,1776,2200,1732,3549,3195,3466,4103,2633,81,562,382,2275,1332,4647,4650,2428,4530,605,1493,1594,1959,2861,4484,4691,2034,1960,4041,842,1302,1673,4625,2931,3414,887,2672,4447,996,1128,4058,3187,3136,748,4718,1413,796,1507,2911,2241,2267,420,4760,2000,4102,1618,3910,3695,792,3966,1091,2626,4972,2659,2596,1294,1946,4597,970,3407,3346,2245,592,2941,1162,1119,361,30,1924,2151,2484,669,2859,4673,3120,16,4761,700,4484,1458,3534,1808,503,3915,2019,535,3641,3887,415,4002,4232,1193,374,144,523,3348,495,4526,1999,2386,2720,2217,1212,1524,3928,951,190,2030,1750,4017,3142,4155,962,60,1943,4439,3465,3944,2437,4805,3771,3022,94,4603,292,2196,2555,2272,4372,1174,1619,636,2806,2918,3185,255,805,3573,1076,2911,1082,196,977,2105,2629,194,2639,87,2078,2640,3977,2254,1870,621,2894,1033,1951,4775,2491,4511,3433,2861,1440,1817,1914,4024,3836,2378,328,711,4406,1091,1876,1637,1778,4635,2759,873,3109,4103,4814,4675,4248,1099,701,1046,2331,460,4636,2357,1674,2253,1898,914,1136,4987,1589,1789,2066,579,2509,3855,3538,475,3869,1047,1749,1188,2374,4976,1171,2202,3067,1529,4063,4703,2558,4102,1695,4215,164,2053,245,4833,3327,3470,2377,3990,782,1077,3635,1475,2073,4800,4112,1715,74,2372,3046,4610,3265,1431,3931,4155,2892,4373,3634,67,3448,503,4894,2111,378,4057,1519,1535,3082,1849,4210,4009,2017,3899,706,3990,2165,794,3016,1057,3239,3678,1132,4828,4151,741,4158,1995,2870,1745,638,3334,4608,136,1052,4696,3584,2327,4876,4376,2352,2463,1960,3606,1137,3204,1063,1964,3744,4636,1102,3877,1439,1115,4958],"ngrams":["eno","^im","ez$","^si","ivi","mbo","riv","ov$","zov","sim","azo","vaz","jet","noj","bor","ća$","ati","mov","ime","rom","kav","no$","�no","oji","koj","^ko","^l$","su$","^re","joj","^jo","vat","tvo","ust","sus","isu","pri","o�e","ću$","se$","bru","ebr","vin","to$","pol","oj$","voj","rvo","avl","bav","ti$","iti","bit","omo","^bi","jen","cij","ića","aci","li�","ugu","aug","van","^a$","ara","anu","^ja","ran","zab","ini","om$","ni�","la$","ela","jel","dje","ina","odi","ni$","^zv","god","abr","^go","jan","am$","lov","dam","eda","^ob","ro$","oro","kor","sko","ura","^sk","men","on$","lje","ilj","^ok","vih","ak$","ril","edi","tor","ruž","ruk","^do","^ru","jeg","pot","pos","nje","^nj","ih$","aka","kon","žak","san","ja$","^sa","^o�","sto","ros","mus","tak","ovi","pro","kuj","na$","eis","^te","bol","uta","nut","zja","ma$","oba","^no","^na","ris","age","nim","erv","uka","ima","ske","do$","man","nad","usl","đu$","bij","međ","iza","din","tva","osj","svi","stv","nst","ins","lu$","ka$","tom","ar$","nja","anj","sed","ik$","unu","aa$","aća","aje","and","�ni","rać","vra","^vr","uže","će$","ndž","^će","da$","rua","^da","oći","eđu","ić$","ren","jer","vje","ost","^uv","zus","ko$","ako","kak","iha","^aa","at$","enc","odj","gen","^mu","^ag","rac","rat","ovr","dol","olu","iji","ado","^št","vlu","je$","^iz","ana","tij","sli","nua","ter","za$","rvj","ćan","zva","vi$","vit","^in","ira","nik","ru$","io$","^to","doć","vio","dža","dud","kri","ego","vju","ote","ef$","imb","vić","^ef","lud","evl","feb","nau","^dr","tez","tar","ija","fti","^un","juu","udi","ata","lim","eku","uar","ud$","ce$","mev","gov","int","^du","�na","okr","us$","uft","^i$","ere","va$","nic","uu$","red","ji$","što","^sr","^sv","cy$","jav","ice","rei","nak","izj","nov","gur","pov","^za","edn","^is","srb","i�n","ke$","uje","^an","msk","ora","lam","bra","te$","muf","en$","^bo","avi","sla","vov","ams","eds","ra$","^ka","sje","ova","hat","ena","ani","izu","eti","vir","�ek","^u$","an$","oru","pru","ših","jed","eši","pod","meš","prv","^me","oli","isl","pre","olo","nte","ta$","^je","ava","žen","rav","ncy","rbi","^fe","^se","dsj","ći$","dni","^po","uvj","vlj","dr$","dić","^pr","iću","zaj"],"ngram_size":3,"dimension":5000},{"language":"bs","weights":[0.0065445,0.0026178,0.0013089,0.0065445,0.0039267,0.0065445,0.0876963,0.0013089,0.0484293,0.0222513,0.0026178,0.0196335,0.0431937,0.0274869,0.0589005,0.039267,0.0157068,0.0340314,0.0170157,0.0772251,0.0117801,0.0431937,0.0026178,0.0117801,0.052356,0.141361,0.0170157,0.0327225,0.0235602,0.141361],"ids":[87,78,58,88,22,58,96,65,20,21,3,0,5,0,79,24,2,57,77,66,11,59,63,66,22,68,86,44,19,52],"ngrams":["�","ž","đ","g","f","c","a","y","n","t","š","m","j","d","e","r","l","v","p","i","b","u","h","ć","o","$","z","s","k","^"],"ngram_size":1,"dimension":100},{"language":"ca","weights":[0.00398406,0.00398406,0.00796813,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.0119522,0.00796813,0.0119522,0.00796813,0.0278884,0.00796813,0.00796813,0.00796813,0.00398406,0.00398406,0.00398406,0.00796813,0.00398406,0.00796813,0.00796813,0.00398406,0.00796813,0.0318725,0.00398406,0.0199203,0.00796813,0.00398406,0.0119522,0.00398406,0.0239044,0.0278884,0.00796813,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.0159363,0.0119522,0.00398406,0.00398406,0.0159363,0.00398406,0.00398406,0.0159363,0.0119522,0.00398406,0.0119522,0.00398406,0.00398406,0.0159363,0.00398406,0.00398406,0.0119522,0.00398406,0.0159363,0.0119522,0.00398406,0.00796813,0.00398406,0.00398406,0.0119522,0.0119522,0.0119522,0.00796813,0.00796813,0.00398406,0.0199203,0.0119522,0.00398406,0.0119522,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00796813,0.00398406,0.0199203,0.00796813,0.00398406,0.0119522,0.00398406,0.0278884,0.0159363,0.00398406,0.00398406,0.00398406,0.00398406,0.0159363,0.00398406,0.0119522,0.00398406,0.00398406,0.00796813,0.00796813,0.00398406,0.00398406,0.0159363,0.00796813,0.00398406,0.00796813,0.00398406,0.00398406,0.0119522,0.00398406,0.00796813,0.0199203,0.0199203,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00796813],"ids":[898,984,120,819,707,183,848,346,976,645,620,7,96,510,452,786,571,353,410,980,575,113,740,355,493,891,327,917,116,269,90,215,933,212,575,651,536,173,672,334,300,402,862,613,637,273,67,168,875,157,303,167,535,637,365,973,272,834,23,939,265,476,591,404,830,780,385,517,989,225,193,104,353,526,957,517,108,200,656,879,75,601,707,518,26,782,630,266,489,8,462,333,766,487,493,885,46,854,287,955,999,0,393,720,727,91,512,71,734,248,307,153,314,146,128,364,514,458,227,838],"ngrams":["ts","rt","im","li","d$","he","i$","ls","^o","^i","tg","sa","ni","s$","uè","is","mp","^h","em","^t","rd","bu","è$","^m","lo","^q","r$","rr","ar","an","^f","ta","ti","^p","^e","e$","és","ei","da","^r","m$","od","^d","t$","ut","eb","nt","à$","un","na","c$","tà","^l","nh","tr","el","ún","^ú","u$","sh","re","^c","ro","ec","òn","va","de","eu","a$","ss","le","sp","er","on","uc","mi","ps","st","bo","ra","pr","ho","ce","pe","ct","dr","at","ré","es","^a","rx","ll","ab","om","in","^u","al","^n","it","te","ge","oc","xi","co","qu","ve","ic","^v","rò","n$","nc","en","l$","or","po","vi","du","fi","iv","^$"],"ngram_size":2,"dimension":1000},{"language":"ca","weights":[0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.0122699,0.0122699,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.0245399,0.00613497,0.00613497,0.0306748,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497],"ids":[1525,2867,4339,562,2904,2109,1329,80,3518,3163,4355,2851,2714,1963,1926,1828,707,4735,1994,421,2297,1390,4632,3801,3337,1956,4280,2802,2064,4737,3377,4192,559,1865,2049,1756,741,3860,2392,1517,4730,537,4571,1119,1696,2347,4973,1862,2839,1802,626,2333,543,4965,132,1892,1943,1120,485,24,4647,3727,3651,1638,4671,3563,2681,623,3985,2499,2476,4295,1869,807,1504,1739,4514,2073,3140,341,2391,2371,1004,640,3637,1884,2041,3451,3297,3632,4289,2575,879,3820,2245,2882,2321,4623,1138,936,1894,4930,4180,4306,2979,4781,2881,1525,825,4246,4126,4998,4473,921,1941,906,1432,1840,2693,4776,1439,1873,1870,827,2498,4345,111,4807,806,3896,1787,3689,531,3801,37,3996,84,331,422,3954,1967,3171,1404,68],"ngrams":["nts$","ants","tant","rtan","orta","port","mpor","impo","^imp","elim","heu$","esar","desa","veu$","^on$","dar$","rdar","orda","ecor","enta","nten","spré","desp","^des","ges$","tges","cebu","miss","ant$","^com","ivan","^els","mps$","inar","^veu","rxiv","arxi","duct","^el$","emps","limi","^ale","perd","què$","per$","^heu","rodu","^per","esho","ales","nal$","elec","tat$","^mis","inte","inal","itat","nar$","lloc","vita","issa","^ein","ivit","sar$","satg","tivi","vant","prés","reu$","ctiv","prod","erdr","res$","^pro","orre","^de$","dre$","eina","espr","orab","but$","oduc","^con","lect","ròni","ina$","cord","ectr","loc$","^arx","ntar","ssat","rdre","^úni","ucti","ebut","once","^ele","rreu","com$","nhor","^fin","^cor","ona$","està","^est","xiva","rabo","stà$","shor","^un$","imin","abon","reco","atge","conc","únic","^al$","hora","^rec","^tem","^nho","mina","^int","ores","nceb","lesh","ònic","hore","rés$","^en$","tròn","nic$","^llo","tar$","bona","temp","ctrò","corr","^eli","tent","^què","els$","fina"],"ngram_size":4,"dimension":5000},{"language":"ca","weights":[0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00970874,0.00970874,0.00485437,0.00970874,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.0194175,0.0242718,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.0145631,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.0145631,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.0145631,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.0194175,0.00485437,0.0194175,0.00485437,0.00485437,0.00970874,0.0242718,0.00485437,0.00970874,0.00970874,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.0145631,0.00970874,0.00970874,0.00970874,0.00485437,0.00970874,0.0145631,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437],"ids":[1703,3292,2890,4698,4590,4689,951,3052,3785,2891,2558,1590,1881,2667,3745,2667,1589,2176,3938,3719,1052,1171,1876,2938,2707,3430,1020,1546,1640,2739,3519,94,4650,16,3028,3814,504,857,2582,1206,337,4388,1669,947,4662,1439,3500,319,1486,4234,4616,1738,357,2629,3247,3807,4682,1091,4307,933,3894,3892,2982,1986,1329,2563,874,669,1971,1057,3456,665,2756,444,16,2213,446,3242,2428,842,2957,1786,2537,2805,4366,1529,197,1618,1107,4826,31,2427,2741,3278,4269,2687,4484,2640,4579,348,3442,3008,3377,4277,4017,3203,4538,4995,1628,3417,3136,2222,4673,1290,2892,2908,2272,355,4901,2267,114,2837,1481,1464,3943,2959,2483,2862,503,360,1147,222,3480,2682,1001,1540,4337,411,3980,3536,4215,3387,4194,1302,323,3780,1852,2277,579,475,1627,2564,3939,4427,4805,2255,1442,2479],"ngrams":["ts$","nts","tan","rta","ort","mpo","nar","min","heu","^he","^i$","^ve","^on","dar","rec","^re","tar","nta","veu","ten","nte","int","^in","pré","spr","des","atg","iss","^d$","mis","^mi","nt$","van","^te","ele","el$","re$","llo","sho","dre","nal","erd","arx","tem","^qu","^pr","lec","er$","^pe","res","iva","rdr","les","at$","tat","imi","cor","vit","ivi","es$","ut$","cti","duc","és$","odu","uct","rod","pro","de$","^de","rés","^ar","ein","ceb","ita","^ei","esp","ssa","^a$","com","ls$","mps","but","què","ord","ebu","abo","est","ròn","por","ale","fin","ect","^co","xiv","onc","om$","^im","tge","trò","reu","imp","^el","orr","ar$","^ún","ona","ant","per","^en","^l$","hor","na$","esa","ora","^es","rre","rab","ps$","on$","emp","tà$","nho","els","eco","esh","al$","^nh","en$","un$","con","rda","oc$","loc","rxi","^ll","eli","eu$","ic$","ges","nic","úni","^al","ina","stà","bon","sar","^fi","^un","lim","sat","tiv","ent","nce","ctr","uè$","ore","òni"],"ngram_size":3,"dimension":5000},{"language":"ca","weights":[0.00675676,0.00337838,0.0371622,0.0101351,0.0304054,0.00337838,0.00337838,0.0202703,0.00337838,0.00675676,0.0506757,0.0472973,0.0101351,0.0371622,0.00675676,0.027027,0.152027,0.0337838,0.0709459,0.0236486,0.0945946,0.0506757,0.00337838,0.00675676,0.00337838,0.0472973,0.0574324,0.152027],"ids":[88,86,2,57,77,96,12,0,58,12,20,21,63,22,11,59,52,58,24,0,79,44,85,33,22,66,96,68],"ngrams":["g","x","l","v","p","ú","à","m","é","q","n","t","h","o","b","u","^","c","r","d","e","s","ò","è","f","i","a","$"],"ngram_size":1,"dimension":100},{"language":"ceb","weights":[0.00322581,0.00322581,0.0129032,0.00322581,0.00322581,0.00322581,0.00322581,0.00322581,0.00322581,0.00322581,0.00322581,0.0129032,0.0129032,0.00322581,0.0580645,0.00322581,0.00967742,0.00322581,0.00645161,0.00322581,0.00645161,0.00322581,0.00645161,0.00645161,0.00322581,0.00322581,0.00645161,0.00967742,0.00322581,0.00322581,0.00322581,0.0129032,0.00322581,0.00322581,0.00645161,0.00322581,0.00322581,0.00645161,0.00967742,0.00967742,0.00322581,0.0129032,0.00322581,0.00322581,0.016129,0.00322581,0.016129,0.00322581,0.00645161,0.00967742,0.0225806,0.00645161,0.00322581,0.00322581,0.0129032,0.00645161,0.00645161,0.00967742,0.00322581,0.00967742,0.00322581,0.0258065,0.0129032,0.0258065,0.00645161,0.00322581,0.00322581,0.00645161,0.00322581,0.00322581,0.00645161,0.00967742,0.00322581,0.00322581,0.00322581,0.00967742,0.0129032,0.00967742,0.0451613,0.00645161,0.00967742,0.00322581,0.00645161,0.00322581,0.00645161,0.0290323,0.00645161,0.00645161,0.00322581,0.00967742,0.0129032,0.00645161,0.016129,0.00322581,0.0451613,0.0483871,0.0129032,0.00322581,0.00322581,0.00645161,0.00322581,0.00645161,0.00967742,0.00645161,0.016129,0.0290323,0.0129032,0.0387097],"ids":[980,961,212,943,134,114,98,128,652,630,116,265,907,458,989,501,298,353,656,623,879,215,190,809,356,985,364,514,793,489,575,645,200,734,526,353,826,493,535,365,875,157,738,841,248,80,8,819,349,763,532,379,596,862,147,153,83,27,998,766,487,493,885,854,46,975,848,803,564,134,287,41,752,736,89,61,355,780,770,500,732,510,96,786,672,391,613,402,175,503,707,838,745,517,605,532,378,233,314,270,591,978,960,67,18,269,935,7],"ngrams":["^t","gg","^p","ot","ui","do","ik","po","up","at","ar","pi","ag","tu","a$","ba","ip","^h","bo","aw","ra","ta","ya","nd","me","ri","uk","du","to","ed","^e","^i","st","rs","on","er","ko","lo","^l","tr","un","na","so","id","n$","nu","^a","li","se","ad","o$","ig","wi","^d","ka","en","ul","si","ay","ab","om","in","^u","^n","al","ao","i$","sy","ki","p$","it","ma","ha","gm","iy","^k","^m","pu","g$","yo","su","s$","ni","is","da","ga","t$","od","il","us","d$","^$","ug","mi","ng","^s","la","mg","l$","gb","ro","bi","pa","nt","as","an","ap","sa"],"ngram_size":2,"dimension":1000},{"language":"ceb","weights":[0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.01,0.005,0.01,0.01,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.02,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.01,0.005,0.005,0.02,0.005,0.005,0.01,0.005,0.005,0.005,0.02,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.05,0.005,0.005,0.005,0.01,0.005,0.01,0.01,0.005,0.005,0.03],"ids":[4153,752,4683,4344,3437,3158,4706,3351,1867,2569,4140,2117,4994,3575,3592,3491,188,2251,3709,4957,2414,236,4342,114,3019,4797,3204,220,4651,2101,1235,3417,2487,593,1160,4529,750,2455,4491,40,4164,666,4984,2019,740,261,1752,2606,4476,2687,3707,735,2900,327,4886,4850,185,1007,1497,2031,2671,4307,4504,3399,4023,2026,4585,1207,4709,809,3047,2398,2595,3712,2326,1875,4139,1821,2917,4441,4137,1212,2749,4253,4821,715,2653,3572,2514,2716,1953,4529,2383,2204,3743,2383,3740,3158,2773,4920,1629,2482,2055,2298,1038,2506,120,4762,2239,3999,49,905,2082,4294,3888,3283,4751,4539,921,2796,2250,2268,449,578,1990,4305,1482,4864,1507,3905,833,4465,3084,103,1148,439,54,1259,2500,2901,3085,742,343,2371,3775,1568,4501,2917,2551,2525,1384,2563,865,2012,4335,4024,3804,4199,458],"ngrams":["uig$","tuig","kad$","sin$","agas","maga","^mag","ong$","gasi","aong","maon","^mao","ggan","^pa$","ukad","ngga","suka","ungg","dung","sidu","pasi","napa","nas$","pina","ipin","inas","ilip","pili","aran","apas","sara","usar","ndot","indo","nind","ito$","kapi","ikap","isip","^isi","rang","awig","ayag","bing","^mip","^suk","ntro","^kap","^pil","riya","pit$","^ind","ustr","dapi","^dap","^ika","alaw","iya$","gata","agat","abag","sip$","ing$","aday","tral","nag$","ntra","triy","nusa","gbo$","lala","kapu","^usa","^an$","dust","pupo","atan","idun","ndus","^nin","yon$","syon","ukas","^lab","^edu","ral$","kasy","rsyo","sugb","igan","kome","entr","^kom","apit","^sug","^inu","asyo","dot$","^sen","^nag","mipa","sod$","asod","ersy","omer","ugma","eduk","^pul","^lal","nga$","^tui","^nas","^hab","lawi","lipi","wiga","apup","tang","duka","tro$","^nap","^ug$","naso","mad$","sent","baga","daya","^nga","stri","asin","ulo$","syo$","gmad","pada","^ang","upod","gan$","^ugm","yag$","^kin","usa$","inus","labi","mga$","ipad","asid","haba","mers","^sa$","pito","indu","ini$","pulo","kini","ugbo","abin","pod$","^mga","ang$"],"ngram_size":4,"dimension":5000},{"language":"ceb","weights":[0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00787402,0.00787402,0.00393701,0.00787402,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.015748,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.011811,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.011811,0.00393701,0.00787402,0.00393701,0.00787402,0.00787402,0.00393701,0.00393701,0.00393701,0.0433071,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.00787402,0.00787402,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.015748,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.011811,0.00393701,0.00787402,0.023622,0.00393701,0.00393701,0.00787402,0.00393701,0.019685,0.00787402,0.00393701,0.00787402,0.00393701,0.00787402,0.011811,0.00393701,0.00393701,0.00393701,0.00393701,0.00787402,0.00393701,0.00393701,0.00393701,0.00393701,0.0393701,0.00393701,0.00787402,0.00787402,0.00393701,0.00787402,0.00787402,0.00393701,0.00393701,0.00393701,0.00393701,0.00393701,0.00787402,0.00787402,0.00787402,0.019685,0.0354331,0.00393701,0.011811],"ids":[815,484,2192,4258,3478,1544,92,4824,1936,4341,1756,1829,2841,2603,4290,3104,3120,1594,3302,3272,2721,3752,14,4249,2481,4965,4873,3849,4226,133,2355,1488,3767,2881,3848,3198,4839,442,4530,1374,4726,4606,3519,4158,2191,1849,2220,3624,1080,1951,2890,2544,266,2976,2985,1102,2378,1376,2073,4942,2242,4997,3504,4250,3915,1332,3454,1111,507,4624,1002,3716,4021,2644,3701,2054,3302,2533,2621,888,4908,4823,2596,2483,4705,2805,3538,2390,4529,1962,1876,1446,3550,748,3106,4814,1758,3018,3538,1023,2850,539,1174,1225,3606,2861,4625,4870,4382,1302,3663,2868,3938,4975,4448,3060,405,3413,2267,141,280,1001,2387,2110,4290,1680,2355,1847,4211,497,4207,4236,2268,4092,93,4952,3239,1903,2558,1633,1353,1095,4104,4096,1805,1852,1162,4853,4330,1826,3356,3939,3469,4992,3121,2372,3552,2389,415,3454,4968,3931,550,3881,2585],"ngrams":["ig$","uig","kad","in$","sin","ong","aon","mao","^ma","ngg","ung","dun","asi","pas","nap","as$","^pi","ran","nus","inu","tui","nag","lo$","ulo","pa$","pul","dot","nin","^pu","ito","ika","^ik","sip","suk","ag$","yag","aya","ada","ara","pad","ipa","mip","^mi","pod","upo","^ka","dap","ipi","^ng","yon","tan","abi","gat","^ha","ral","aba","bag","tra","^ug","ya$","kap","iya","dus","ndu","^na","sod","ind","apa","usa","pit","kas","idu","lip","sa$","aso","duk","edu","^ed","mag","apu","sug","yo$","ot$","al$","asy","kom","ata","sid","mer","ome","^in","ip$","rsy","ro$","tro","^pa","hab","ntr","ndo","syo","sen","^ko","^da","lal","^se","ini","ni$","od$","pup","ina","kin","nas","iga","nga","awi","gga","^ni","law","on$","ala","riy","str","^la","isi","ad$","ang","mad","ugm","bin","day","ga$","bo$","gma","ing","pin","ug$","an$","wig","mga","ili","to$","aga","^mg","gas","tri","sar","^sa","ust","gan","gbo","it$","ent","lab","^us","^tu","^is","^ki","pil","uka","ugb","api","^an","ng$","ers","^su"],"ngram_size":3,"dimension":5000},{"language":"ceb","weights":[0.0327869,0.0136612,0.0218579,0.00273224,0.010929,0.0273224,0.057377,0.0163934,0.153005,0.0218579,0.00273224,0.0355191,0.0819672,0.0136612,0.0409836,0.068306,0.153005,0.010929,0.0163934,0.0737705,0.144809],"ids":[77,24,21,32,79,0,66,19,52,2,63,22,20,11,59,44,68,65,0,88,96],"ngrams":["p","r","t","w","e","d","i","k","^","l","h","o","n","b","u","s","$","y","m","g","a"],"ngram_size":1,"dimension":100},{"language":"cs","weights":[0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00851064,0.00425532,0.00425532,0.00425532,0.00851064,0.00851064,0.00425532,0.00425532,0.00425532,0.00851064,0.00851064,0.00425532,0.00425532,0.0170213,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00851064,0.0170213,0.012766,0.00425532,0.00851064,0.00425532,0.00425532,0.00425532,0.00425532,0.00851064,0.00425532,0.00851064,0.00425532,0.00425532,0.0212766,0.00425532,0.00851064,0.012766,0.00425532,0.00425532,0.00425532,0.00851064,0.00425532,0.00851064,0.00851064,0.00425532,0.012766,0.012766,0.00425532,0.00425532,0.00425532,0.00851064,0.00425532,0.00425532,0.00425532,0.00851064,0.012766,0.00425532,0.00851064,0.00425532,0.00851064,0.00425532,0.00851064,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.012766,0.00851064,0.00425532,0.00851064,0.00851064,0.00425532,0.0170213,0.00425532,0.00425532,0.00425532,0.0170213,0.00425532,0.00425532,0.012766,0.00851064,0.00425532,0.00425532,0.012766,0.00425532,0.00851064,0.00851064,0.00851064,0.00425532,0.00425532,0.00851064,0.00425532,0.00851064,0.012766,0.00851064,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00425532,0.00851064,0.0212766,0.00851064,0.012766,0.00425532,0.00851064,0.00425532,0.00425532,0.00425532,0.00425532,0.0170213,0.00851064,0.00425532,0.00425532,0.012766,0.00425532,0.00425532,0.012766,0.00425532,0.00851064,0.012766,0.00851064,0.00425532,0.00851064,0.00851064,0.00425532,0.00425532,0.0297872],"ids":[272,842,108,862,8,786,265,170,410,353,245,166,877,207,402,601,466,656,273,367,743,270,475,671,193,826,958,209,156,672,337,185,128,707,392,403,122,793,489,68,591,648,75,804,110,212,676,893,30,736,943,848,333,421,200,161,540,383,760,275,146,75,953,201,361,822,763,532,915,489,564,477,91,108,842,534,658,7,694,287,955,41,980,314,271,795,605,925,989,685,613,662,819,532,265,146,91,71,248,567,153,973,631,88,191,657,963,175,493,496,90,963,300,848,803,885,885,854,458,93,742,576,635,747,888,795,237,485,332,921,943,782,630,8,954,157,976,83,67,960,838,887,19,651],"ngrams":["lk","él","dé","^d","sn","is","pi","mě","em","^h","né","rn","ez","ej","od","ho","ty","bo","eb","áp","zá","�k","zn","^z","le","ko","í$","�e","r�","át","vá","ív","po","d$","ud","no","sl","to","ed","^j","ro","ov","pr","h$","ís","^p","za","mo","ze","gm","ém","ys","dn","ur","st","vý","�í","ky","ok","té","or","op","lz","sá","ře","bs","ad","o$","io","es","ki","a�","ve","ak","kc","oo","ý$","sa","of","it","te","ma","^t","l$","sm","ai","y$","^g","a$","je","t$","ář","li","^s","re","ýc","vy","^v","n$","é$","en","el","že","az","ku","ch","jt","il","lo","kr","^f","ci","m$","i$","sy","tk","^u","^n","fi","ou","yk","už","uj","z$","ož","ah","ne","ží","ob","ní","ot","dr","at","^a","ěp","na","^o","ul","lm","pa","^$","v$","ol","e$"],"ngram_size":2,"dimension":1000},{"language":"cs","weights":[0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.0121212,0.0121212,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.0121212,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061],"ids":[2641,682,2948,784,1270,3084,635,950,1811,821,1536,2484,2515,4353,3085,616,1436,4874,1553,166,790,2956,2716,2042,4140,3617,931,2141,3337,1105,4066,1499,1787,3168,2022,1025,1725,4708,746,3476,2557,1760,2409,4855,746,2710,3718,36,1148,2764,1162,4404,3071,4124,4610,4615,2682,4579,35,321,114,209,209,857,4285,3034,3225,3834,2353,3210,4136,4012,263,316,1426,1166,1529,4849,1212,1090,1209,774,1597,1479,3781,2682,3047,133,418,2301,1227,3327,1874,781,4778,2399,4626,4098,4328,1924,4734,2289,807,2164,1071,3468,462,3774,3993,1309,3230,2202,1296,1345,713,4906,1245,2843,3419,4060,1347,2283,4421,4308,3236,1679,1475,2127,353,804,2136,465,2463,740,3359,4767,2881,3041,339,2037,2654,4511,3920,1410,4423,2435,4471,1669,2012,4938,2923,4873,3236,3499],"ngrams":["délk","sné$","isné","měpi","eměp","země","^zem","odno","hodn","^hod","orné","^dél","ápor","ezáp","nezá","ejte","vejt","žíve","hod$","rné$","ýcho","ebo$","nebo","élky","^neb","pad$","ěpis","^záp","a�ky","na�k","zna�","^zna","ule$","loko","olok","koul","polo","^pol","ení$","lky$","^ur�","�ení","pro$","kci$","váte","užív","^nel","použ","esli","^pou","porn","moot","ívát","^oku","smoo","slit","tky$","azat","otky","ívej","edno","^jed","^obs","ouží","ofil","paku","rofi","fil$","mový","^výc","jte$","^tok","^smo","ysté","syst","zápo","a�ís","na�í","smaz","ur�e","ový$","lze$","elze","áte$","notk","nelz","prof","íst$","áře$","resá","akuj","adre","stém","chod","témo","^sma","^adr","ilm$","film","resl","r�en","maza","^pro","gmai","kujt","^gma","lit$","oule","obsa","ulož","sah$","žívá","ápad","opak","^fil","mail","dnot","esář","^ulo","toki","okou","ykre","zat$","ail$","okud","noty","^vyk","vých","kud$","jedn","žen$","akci","oot$","émov","kres","sáře","lože","^na�","oty$","�íst","okio","dres","zápa","^opa","�ky$","bsah","ožen","^sys","pisn","^akc","^nez","ujte","vykr","kio$"],"ngram_size":4,"dimension":5000},{"language":"cs","weights":[0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.0150754,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.0201005,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.0150754,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.0150754,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.0100503,0.0100503,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.0100503,0.0100503,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.00502513,0.0100503,0.00502513,0.00502513,0.00502513,0.00502513],"ids":[903,4913,778,1904,2,3144,563,566,3341,4945,77,1306,2195,3734,4811,2732,4870,1271,4236,4290,524,3523,1147,1357,831,136,2476,2655,128,3052,737,748,287,1931,1290,1749,4370,48,2899,4327,2000,4657,1344,1460,4497,630,3936,2596,2756,1378,2205,2883,4151,3584,3598,1232,3636,1340,1090,3113,4358,1206,377,1374,2612,2344,4539,4826,4171,2714,1502,3465,4233,2849,1369,4627,4098,1889,1044,1643,74,4001,2656,2792,1483,3136,3915,2507,4455,2629,2686,912,2361,1964,3932,124,870,950,4033,873,3938,3864,4278,1216,2268,4389,4950,4824,3804,67,3856,1817,983,4318,2521,2759,3010,3514,669,715,868,295,486,3242,2428,1189,16,2511,2595,4549,4570,875,1892,503,1412,925,1814,351,1942,2740,2306,3443,2558,4234,1065,1300,476,2859,1355,1439,2003,4864,1772,3014,485,4876,4068,3415,1007,2329,3356,1132,4876,140,857,4249,2123,2592,2277],"ngrams":["lky","élk","^dé","sné","pis","ěpi","měp","^ze","ty$","odn","rné","orn","vej","zem","íve","^ho","od$","hod","bo$","ad$","nez","^z$","�ky","zna","lok","olo","^zá","�en","r�e","ur�","kou","ro$","áte","vát","ívá","ud$","isn","ní$","kud","dél","^ok","pou","oot","smo","le$","ky$","lož","ot$","otk","not","moo","cho","jed","^je","ofi","vý$","oty","^vý","^sy","^ul","st$","dre","íst","pad","aza","ze$","elz","por","oko","sté","adr","^ne","ře$","a�í","né$","mai","áře","tok","sah","ouž","edn","bsa","mov","obs","�ís","^ob","^na","emě","ezá","at$","ápa","na�","maz","^po","pak","sma","uží","tém","kio","^to","ail","yst","neb","lit","gma","ení","^gm","nel","aku","te$","oki","sli","ože","esl","kre","io$","oul","vyk","pro","ah$","fil","^vy","tky","ápo","^a$","kci","pol","^op","ule","ový","^ur","^ak","ilm","en$","ci$","esá","^zn","il$","sys","lm$","záp","^sm","^v$","res","zat","émo","sář","kuj","ebo","^pr","a�k","žív","jte","ujt","ých","výc","dno","ykr","oku","^ad","it$","ejt","žen","opa","lze","ulo","akc","rof","^fi"],"ngram_size":3,"dimension":5000},{"language":"cs","weights":[0.00738007,0.0147601,0.0110701,0.00369004,0.0258303,0.0110701,0.0147601,0.00738007,0.0221402,0.00369004,0.0147601,0.0405904,0.0442804,0.0221402,0.0221402,0.132841,0.0295203,0.0332103,0.00738007,0.0664207,0.0369004,0.0221402,0.0332103,0.0110701,0.0811808,0.132841,0.0332103,0.0258303,0.00738007,0.00369004,0.0110701,0.0258303,0.0405904],"ids":[62,54,87,22,0,63,65,11,24,88,58,21,20,65,0,68,86,44,22,79,2,57,77,5,22,52,19,59,58,97,78,66,96],"ngrams":["ý","í","�","ř","d","h","á","b","r","g","é","t","n","y","m","$","z","s","f","e","l","v","p","j","o","^","k","u","c","ě","ž","i","a"],"ngram_size":1,"dimension":100},{"language":"cy","weights":[0.004,0.004,0.008,0.004,0.004,0.004,0.004,0.008,0.004,0.004,0.008,0.004,0.008,0.004,0.004,0.004,0.016,0.008,0.008,0.008,0.008,0.004,0.008,0.008,0.012,0.012,0.008,0.024,0.004,0.044,0.008,0.004,0.012,0.004,0.012,0.004,0.004,0.016,0.004,0.012,0.02,0.004,0.032,0.004,0.008,0.012,0.004,0.008,0.008,0.004,0.012,0.004,0.004,0.008,0.012,0.012,0.004,0.012,0.004,0.012,0.004,0.008,0.004,0.004,0.024,0.004,0.004,0.004,0.012,0.008,0.004,0.004,0.012,0.004,0.004,0.016,0.004,0.004,0.004,0.008,0.004,0.016,0.008,0.004,0.004,0.008,0.016,0.02,0.004,0.008,0.008,0.032,0.004,0.008,0.012,0.004,0.02,0.004,0.004,0.004,0.004,0.004,0.004,0.012,0.008,0.004,0.004,0.008,0.012,0.004,0.004,0.036,0.004,0.012,0.004,0.02,0.004],"ids":[7,18,680,895,591,135,803,489,717,233,175,933,381,660,300,391,712,486,736,148,380,862,402,613,540,656,976,925,732,476,429,996,848,269,671,889,353,314,865,263,248,67,707,116,36,239,298,648,90,545,200,924,517,972,355,41,287,795,356,985,601,688,510,741,848,803,46,885,854,157,875,118,834,694,940,102,73,238,605,333,532,763,481,645,178,347,23,123,176,265,273,804,778,768,512,734,173,237,176,365,86,402,170,973,838,517,501,989,678,126,782,657,489,8,651,575,390],"ngrams":["sa","as","gw","am","ro","cl","di","ed","^w","yc","il","ti","fe","lt","m$","ga","we","^b","gm","wy","ew","^d","od","t$","os","bo","^o","^g","su","^c","ia","by","ys","an","fr","hy","^h","l$","w$","ae","n$","dy","d$","ar","dd","yf","yw","f$","^f","ir","st","dw","mi","if","^m","ma","it","ai","me","ri","ho","wa","s$","nw","i$","sy","al","^u","^n","na","un","sb","yd","of","yl","cy","wc","rw","y$","ll","o$","ad","hi","^i","ym","th","u$","^y","lu","re","eb","h$","ru","ca","ic","et","ei","ne","lw","tr","ly","wn","fy","el","^$","eu","ba","a$","yn","gr","dr","ch","es","^a","e$","^e","mw"],"ngram_size":2,"dimension":1000},{"language":"cy","weights":[0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.0194805,0.012987,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.012987,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.012987,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.012987,0.00649351,0.00649351,0.012987,0.012987,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.012987,0.012987,0.00649351,0.00649351,0.00649351,0.012987,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.0194805,0.012987,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.012987,0.00649351,0.00649351,0.0194805,0.00649351,0.00649351,0.012987,0.00649351,0.00649351,0.0194805,0.00649351,0.00649351,0.00649351,0.012987,0.00649351,0.0194805,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.00649351,0.012987,0.00649351,0.012987,0.00649351,0.00649351],"ids":[2625,2383,1426,3363,4677,3425,2553,4883,3117,1660,1967,119,4307,2896,1477,2518,2708,4074,1466,1697,177,1783,2870,2850,4120,3468,3765,2587,4754,2861,2843,2889,2977,4770,4488,2588,4927,4240,1253,4710,2456,1442,4322,3429,3894,3233,2671,3690,3471,3073,1119,4174,3504,3472,1284,27,3234,2335,1657,4697,3312,4946,3244,2956,3617,1694,3199,2941,1665,4166,3529,866,3985,2207,4581,702,2164,4883,4023,1549,3254,2676,391,4506,4395,3460,2039,117,2544,3324,1112,3225,3550,1976,726,1916,2778,4498,3402,1580,3502,410,4322,2931,2726,2798,3635,1832,4906,3787,1064,2749,4283,4635,579,4480,1040,2346,3719,1610,1193,319,1457,3590,4308,3803,3028,847,927],"ngrams":["gweb","aeth","anae","sana","asan","wasa","eth$","^am$","^mae","arod","^bar","naet","wed$","ywed","^cly","edi$","wedi","ych$","dych","ydyc","^ydy","mae$","nad$","^os$","ich$","^gma","welw","drwy","^drw","rod$","wydd","tiad","ltia","fel$","cysy","ewn$","llti","^mi$","ydd$","^cad","baro","clyw","allu","ael$","^gal","iad$","bod$","^bod","^fel","^cys","^new","mewn","ost$","fydd","^cae","bost","ebos","iria","eiri","ysu$","^ch$","bysu","^ebo","sbys","lwch","ysby","^gwa","ysyl","hysb","cael","^hys","riad","reu$","adw$","llu$","^chi","gmai","yfei","wait","webo","cyfr","rest","unwa","gall","yllt","^fyd","ith$","greu","wch$","newy","ymwe","gwas","estr","^gre","^yn$","rif$","feir","elwc","ofre","hofr","tru$","^nad","chi$","cadw","^wed","eich","^ei$","mwel","mail","^mew","aith","^cyf","fres","^ymw","^gwe","yfri","lywe","^eic","syll","ewyd","^unw","^cho","stru","cyfe","ail$","rwy$","frif","chof","nwai"],"ngram_size":4,"dimension":5000},{"language":"cy","weights":[0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00995025,0.00995025,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00995025,0.00995025,0.00497512,0.00497512,0.00995025,0.0149254,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.0149254,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00995025,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.0199005,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.0199005,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.0149254,0.00497512,0.00497512,0.00497512,0.0298507,0.0149254,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00995025,0.00995025,0.0149254,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.0199005,0.0149254],"ids":[4244,652,1887,2870,1936,2266,874,2563,3652,960,1755,3695,4864,1119,1230,939,144,3915,4916,2384,3938,4627,2268,4950,2861,1871,4256,4399,2833,4921,2015,1149,1788,1611,1355,4529,190,3006,424,1618,4870,1975,4009,2830,1745,3465,4358,4356,1558,1448,7,4187,4290,1197,411,633,2581,3128,281,4894,4532,2537,2311,2982,2959,3151,146,3099,1285,4449,1041,579,3631,2224,4081,1850,3519,4443,4109,3442,629,2570,3814,1689,638,2824,164,914,3506,592,1136,2556,306,1153,2328,4030,1651,419,3925,2428,2525,893,2213,4321,3640,4183,1387,1416,4240,2067,360,1390,1136,639,186,1960,2645,1726,564,4524,4917,4779,2883,1048,996,1121,1003,517,660,2048,1133,2112,3875,26,504,3456,4635,1099,351,805,323,3903,1552,4234,1033,4214,2558,1001,242,4939],"ngrams":["web","was","gwa","^n$","^ma","^am","rod","ed$","ywe","lyw","di$","edi","wed","^we","ych","aet","nad","^na","os$","^os","ail","mai","gma","^gm","ana","rwy","drw","tia","lti","llt","ysy","ysu","wn$","adw","ebo","cad","lu$","all","ith","est","od$","wyd","new","eir","^me","^ne","st$","dd$","bos","^eb","wy$","yfr","ad$","iad","eu$","ria","^o$","gre","bys","^bo","^yd","sby","dyc","hys","bar","^hy","ael","fei","cae","^ca","eic","^un","fyd","asa","mew","^fy","^mi","mae","^cl","reu","nwa","^gr","el$","yll","chi","ysb","th$","ae$","dw$","san","^ch","bod","wai","lwc","ewn","wch","^ga","cly","hof","^a$","cys","eth","^ei","^gw","wel","gwe","ydy","elw","su$","ydd","syl","ait","^dr","mwe","llu","^fe","ymw","nae","if$","fri","yfe","^ba","cho","mi$","am$","aro","^ym","cyf","iri","ewy","ei$","ch$","ich","tru","gal","fre","ru$","hi$","il$","ost","yn$","unw","rif","res","ofr","fel","^i$","str","^cy","^yn"],"ngram_size":3,"dimension":5000},{"language":"cy","weights":[0.0367893,0.0200669,0.0234114,0.0568562,0.0568562,0.0167224,0.0301003,0.0167224,0.0267559,0.0234114,0.0401338,0.0468227,0.0602007,0.0267559,0.0267559,0.0535117,0.0568562,0.0200669,0.16388,0.0334448,0.16388],"ids":[32,88,0,65,66,11,20,59,24,22,63,0,79,44,22,58,96,21,68,2,52],"ngrams":["w","g","m","y","i","b","n","u","r","o","h","d","e","s","f","c","a","t","$","l","^"],"ngram_size":1,"dimension":100},{"language":"da","weights":[0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00796813,0.00398406,0.00398406,0.0159363,0.0159363,0.0119522,0.0119522,0.0119522,0.00398406,0.00796813,0.00398406,0.0318725,0.00398406,0.00398406,0.00398406,0.00398406,0.0119522,0.00796813,0.00796813,0.00398406,0.00398406,0.0159363,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00796813,0.00398406,0.00398406,0.0119522,0.0119522,0.00398406,0.00398406,0.00398406,0.00398406,0.0119522,0.00398406,0.00398406,0.0199203,0.00398406,0.00796813,0.00398406,0.00398406,0.00398406,0.0239044,0.00796813,0.00796813,0.00398406,0.0119522,0.0119522,0.0119522,0.0119522,0.0358566,0.0119522,0.00398406,0.00796813,0.00398406,0.00398406,0.00398406,0.0159363,0.00796813,0.00398406,0.00398406,0.00796813,0.00398406,0.00398406,0.00398406,0.00796813,0.00398406,0.0159363,0.00398406,0.00796813,0.0278884,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.0318725,0.0199203,0.00398406,0.00398406,0.00398406,0.00796813,0.0239044,0.00398406,0.00398406,0.00796813,0.00796813,0.00398406,0.00398406,0.0159363,0.00398406,0.00796813,0.00398406,0.00796813,0.00796813,0.00796813,0.0119522,0.0159363,0.00398406,0.00398406,0.0119522,0.00398406,0.00398406,0.00796813,0.00398406],"ids":[978,23,514,496,973,656,265,71,166,745,778,834,803,296,848,886,842,27,532,613,734,314,46,885,854,787,353,104,346,591,67,486,61,254,96,8,829,848,86,146,144,668,75,518,391,300,748,648,826,200,490,734,645,19,349,346,819,996,489,591,384,999,73,410,276,752,841,248,878,227,91,605,215,269,887,651,575,19,379,933,392,925,333,763,365,420,747,535,493,382,770,287,955,780,175,327,649,157,875,738,985,142,356,549,385,980,290,402,839,147,862,244,900,526,212,493,28,8,489,976,458,989,237,671,937,153,692,403,193,271,707,838,378],"ngrams":["bi","u$","du","kr","el","bo","re","^v","rn","ug","ru","br","di","nf","i$","eg","fo","si","^s","t$","et","l$","al","^u","^n","pø","er","sp","ls","ro","nt","^b","^k","av","ni","sn","sk","ys","ly","or","be","rg","op","pe","ga","m$","mb","ov","ko","st","um","rs","^i","gs","se","ær","li","ds","ed","ke","ns","ge","øn","em","^ø","dg","id","n$","gn","iv","ve","ng","ta","an","v$","e$","^e","ol","ig","ti","ud","^g","ll","ad","tr","må","z$","^l","lo","mm","g$","it","te","pu","il","r$","dt","na","un","so","ri","ør","me","nl","de","^t","nk","od","væ","ka","^d","vn","pl","on","^p","in","kt","^a","ål","^o","tu","a$","ne","^z","og","en","gi","no","le","sm","d$","^$","la"],"ngram_size":2,"dimension":1000},{"language":"da","weights":[0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497,0.00613497],"ids":[4875,2766,2925,1169,3998,1299,3420,782,2111,4857,1682,3861,69,3100,272,27,2916,1739,2388,3791,4111,640,4372,3394,1409,887,2608,3017,3853,3168,1900,725,1952,1913,4432,2523,1461,2896,4989,3794,1069,3910,183,4000,3586,150,4517,3168,4284,2559,1318,4352,3053,310,3934,4019,1038,3003,4187,1813,124,1487,2700,394,4249,849,934,1316,3845,1941,1207,4740,2544,2530,2501,1257,965,2360,4971,3851,3599,1620,2518,933,3009,1148,3916,3703,1039,2026,1264,3302,244,947,2708,4715,4007,2205,3991,2737,703,4970,4988,4715,1951,1180,1862,624,2753,3914,574,3887,4115,2794,1104,1425,1179,805,3463,4379,3723,807,3018,4569,1549,1793,3660,985,4726,2433,3256,2801,3497,2553,2904,4235,3822,3455,1871,152,267,510,1395,2959,1494,1752,4133,93,4714,1073,2248,3132,3513,1994,715,14,455,3211],"ngrams":["lede","ille","bill","^bil","^kan","riv$","^skr","ller","^ell","gsta","ogst","^se$","bogs","ære$","^bog","^vær","kal$","^de$","skal","avn$","rnav","uger","^bru","dit$","tal$","^dit","^teg","eden","lled","dste","idst","skri","mål$","navn","snin","tumm","^ige","spør","olsp","gang","rols","^adg","^kon","nger","ger$","^log","ning","plys","^pun","lige","onli","enfo","kan$","erso","trol","gem$","oply","^gem","stav","det$","ber$","vemb","^opl","ngiv","nove","^sid","^nov","ode$","kode","skod","ngsk","ler$","ysni","giv$","ede$","for$","sked","tav$","dgan","lysn","nfor","sonl","^et$","^tal","den$","^ang","egn$","^og$","angs","ovem","log$","tegn","tall","igen","^ned","ste$","punk","till","dte$","^du$","adga","^den","gsmå","rgsm","ladt","^er$","^per","^ud$","ruge","pers","^til","ktum","unkt","ene$","mer$","der$","være","kede","pørg","rson","gen$","ontr","umme","denf","mber","kont","angi","smål","gern","llad","adte","embe","nktu","nske","kriv","inge","brug","lene","erna","nlig","edet","gsko","elle","mmer","^det","ntro","^der","ørgs","alle","ige$","illa","sids","^øns","ønsk","nede","^ska","lspø","llen"],"ngram_size":4,"dimension":5000},{"language":"da","weights":[0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00970874,0.00970874,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.0194175,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.0145631,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.0145631,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.0145631,0.00485437,0.0145631,0.00485437,0.00970874,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.0291262,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00970874,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437],"ids":[1916,4103,4259,3606,3239,122,1849,1591,607,870,2644,132,582,3641,4894,2841,1473,217,4662,2911,4248,2460,1366,2483,1060,862,3377,2617,3356,4899,4381,187,3131,16,542,4312,1778,2202,217,3498,157,831,3990,4031,3141,4645,2320,4327,3399,1205,1763,3598,891,1894,2886,4092,3849,4752,4223,3637,2511,1132,1457,3159,3684,1057,2982,4562,154,3691,3764,1971,908,2558,451,3881,2239,4602,3844,3483,2441,220,2143,2073,61,3156,458,2561,1745,721,207,1486,503,1449,3018,1653,32,4867,4484,1705,796,4330,944,1870,1471,3599,563,1484,3005,2785,249,4721,4487,3724,1794,3991,450,691,539,3931,4827,67,4622,4625,1369,2660,4441,2847,2626,1987,2390,4529,3123,3006,271,3465,1491,2329,2265,3346,4232,564,319,3496,1628,358,3106,504,4226,4902,4102,2426,4094,2120,503,4882,87,1889,2428,1098,1680,3511,1749,201,3398,75,2338,3523,3139],"ngrams":["nfo","^bi","se$","^se","an$","or$","^ka","riv","skr","ler","ell","av$","sta","bog","^bo","vær","^væ","kal","ogs","^sk","kri","vn$","ern","al$","uge","rug","^el","^br","it$","tav","^di","gn$","egn","^te","teg","dst","ids","^du","avn","^si","det","led","ål$","mål","små","enf","ned","gsm","pør","spø","lsp","ols","ont","dga","nge","ing","nin","ige","sni","ply","^op","opl","ære","nli","rna","^de","lla","den","onl","for","mme","de$","ysn","^i$","son","ers","bil","^og","gem","ska","pun","ngs","^ge","nov","ber","gst","øns","vem","et$","tal","ove","^pe","^no","ode","ntr","^øn","kod","^ig","mbe","nav","sko","gan","ede","ked","lle","ktu","iv$","ger","rso","kan","du$","emb","giv","^et","ngi","bru","og$","rol","^ko","^an","^lo","te$","^ud","ge$","lig","dte","ill","nkt","ørg","^ti","sid","mer","^er","all","der","^ne","em$","^ad","rgs","kon","ske","til","er$","tum","per","lad","tro","re$","^pu","unk","log","adt","ne$","^ta","en$","ene","gen","ste","^a$","umm","ang","gsk","ud$","dit","lys","len","nsk","^z$","adg"],"ngram_size":3,"dimension":5000},{"language":"da","weights":[0.00337838,0.00337838,0.0337838,0.00675676,0.0371622,0.0472973,0.0506757,0.0202703,0.0135135,0.00337838,0.0135135,0.0168919,0.0472973,0.00337838,0.0641892,0.0472973,0.108108,0.0236486,0.152027,0.0405405,0.152027,0.00675676,0.0168919,0.0472973,0.0405405],"ids":[22,27,22,46,66,24,2,57,77,76,11,59,21,65,20,0,79,19,52,44,68,86,0,88,96],"ngrams":["f","æ","o","ø","i","r","l","v","p","å","b","u","t","y","n","d","e","k","^","s","$","z","m","g","a"],"ngram_size":1,"dimension":100},{"language":"de","weights":[0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.015873,0.00396825,0.00793651,0.00396825,0.00396825,0.00396825,0.00793651,0.00793651,0.00793651,0.00396825,0.0119048,0.00396825,0.0238095,0.00396825,0.00793651,0.00793651,0.00396825,0.00793651,0.00396825,0.00793651,0.00396825,0.0119048,0.00396825,0.00396825,0.00396825,0.0119048,0.00396825,0.00396825,0.00793651,0.00396825,0.00396825,0.00396825,0.00396825,0.00793651,0.0119048,0.00396825,0.00396825,0.0119048,0.0119048,0.00396825,0.00793651,0.00793651,0.00793651,0.015873,0.0119048,0.015873,0.0119048,0.00793651,0.00793651,0.00396825,0.00793651,0.00396825,0.00793651,0.00793651,0.00793651,0.0119048,0.00396825,0.0198413,0.00793651,0.0436508,0.00396825,0.00793651,0.0119048,0.00396825,0.00396825,0.0119048,0.0277778,0.00793651,0.015873,0.0119048,0.0277778,0.00793651,0.00396825,0.00793651,0.015873,0.0119048,0.00793651,0.00793651,0.0238095,0.00793651,0.0119048,0.047619,0.00396825,0.00793651,0.00396825,0.00396825,0.00396825,0.00793651,0.00396825,0.00793651,0.00793651,0.00793651,0.00396825,0.00793651,0.0119048,0.0238095,0.0119048,0.015873,0.015873,0.0198413,0.00793651],"ids":[980,630,503,679,707,381,257,489,275,176,605,68,631,316,410,269,518,134,122,795,862,157,314,27,842,273,804,108,512,349,819,265,596,90,261,614,822,820,685,501,116,842,645,470,672,682,300,545,984,333,200,532,265,973,146,144,75,734,915,173,384,28,575,651,689,385,717,153,925,626,466,333,296,99,10,649,994,327,613,985,120,237,287,955,187,526,353,803,575,248,854,46,493,786,510,96,712,838,766,157,875,364,489,657,999,933,976,8,227],"ngrams":["^t","at","us","au","d$","fe","sf","ed","tt","lu","ng","^j","ür","fü","em","an","pe","p$","ld","ah","^d","tf","l$","si","fo","eb","h$","ak","ic","se","li","kl","wi","^f","öc","^ö","bs","ea","je","ba","ar","fa","^i","rb","da","yp","m$","ir","rt","dn","st","^s","re","el","or","be","op","et","io","ei","ns","kt","^e","e$","ht","de","^w","en","^g","pt","ty","ll","rk","hr","ie","dt","sc","r$","t$","ri","im","ne","it","te","hn","on","er","di","rd","n$","^n","al","in","is","s$","ni","we","^$","ab","na","un","vi","es","ch","ge","ti","^o","^a","iv"],"ngram_size":2,"dimension":1000},{"language":"de","weights":[0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.010989,0.010989,0.00549451,0.00549451,0.010989,0.00549451,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.00549451,0.00549451,0.010989,0.00549451,0.010989,0.010989,0.00549451,0.00549451,0.00549451,0.00549451,0.010989,0.00549451,0.00549451,0.010989,0.00549451,0.010989,0.010989,0.00549451,0.010989,0.00549451,0.010989,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.010989,0.00549451,0.00549451,0.010989,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.010989,0.00549451,0.00549451,0.00549451,0.00549451,0.010989,0.00549451,0.00549451,0.00549451,0.010989,0.010989,0.010989,0.010989,0.00549451,0.00549451,0.010989,0.00549451,0.00549451,0.00549451,0.010989,0.00549451,0.010989,0.00549451,0.010989,0.010989,0.00549451,0.010989,0.010989,0.010989,0.00549451,0.010989,0.010989,0.00549451,0.00549451,0.00549451,0.00549451,0.010989,0.010989,0.021978,0.010989,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.00549451,0.010989,0.010989,0.00549451,0.00549451,0.00549451],"ids":[2307,1042,2397,382,3712,626,4970,4179,1637,4044,3619,3281,2757,809,3697,4675,3308,2727,747,1864,3236,2247,651,2422,1627,2790,3510,1998,1009,1731,284,3505,230,4926,4121,211,262,4478,2312,1273,535,2526,2124,2127,2826,3203,499,2779,3891,911,1237,3227,1091,4371,213,1877,4910,3440,3492,2407,2001,297,2513,4490,1640,1037,4802,3723,1346,2887,3275,4239,198,2068,442,209,3227,4728,2570,2300,1650,2412,1085,1148,1389,3295,968,1381,2247,808,4132,2696,3737,231,538,626,3009,4398,4413,1361,1953,62,3797,137,4074,2774,4978,3640,4463,2165,3376,3563,1350,2757,1402,3927,323,3802,4420,124,1873,3555,2812,2963,1752,2455,3741,4123,700,4120,3607,1619,3989,3351,3719,4678],"ngrams":["ist$","ser$","eser","^ies","^an$","typ$","^den","nset","aten","date","^dat","ense","dem$","^dem","tens","aus$","^aus","^typ","eld$","sfel","desf","jede","für$","set$","^für","^geb","ritt","^sch","sem$","esem","iese","ngeb","iona","absc","^opt","eben","ldty","ypen","eldt","^eld","ahre","^for","opti","klic","hrit","ktiv","irkl","ten$","rtfa","chte","pen$","llun","öcht","^sie","iert","ptio","schn","eakt","type","deak","ben$","^dea","ortf","unge","rbab","fahr","vier","gen$","iere","ren$","arba","farb","^far","ellu","^im$","^jed","wirk","tell","lich","ner$","eins","fort","hten","^ang","inst","ordn","^ist","rein","erei","nere","chri","dies","ange","rkli","^die","nal$","den$","onal","rden","feld","^ord","erde","die$","ert$","hnit","babs","akti","tfah","ivie","dner","stel","tivi","gebe","bsch","^akt","dtyp","rdne","nste","esfe","^öch","^wer","sie$","chni","itt$","schr","lung","werd","eren","edes","ich$","^wir","nitt","tion","ngen","hren","^abs"],"ngram_size":4,"dimension":5000},{"language":"de","weights":[0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00925926,0.00925926,0.00462963,0.00925926,0.00925926,0.00462963,0.00462963,0.00925926,0.00925926,0.00925926,0.00925926,0.00462963,0.00925926,0.00925926,0.00462963,0.00925926,0.00462963,0.0462963,0.00925926,0.00925926,0.00462963,0.00925926,0.00462963,0.00925926,0.00925926,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00925926,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.00462963,0.00925926,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00925926,0.00462963,0.00925926,0.00462963,0.0138889,0.0138889,0.00462963,0.00462963,0.00925926,0.0138889,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00925926,0.00462963,0.00925926,0.00925926,0.00462963,0.00462963,0.00462963,0.00925926,0.00925926,0.0185185,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.00925926,0.00462963,0.00925926,0.00462963,0.00925926,0.00925926,0.0138889,0.00925926,0.00925926,0.00925926,0.00462963,0.00925926,0.00462963,0.00925926,0.0185185,0.0185185],"ids":[4358,2372,1795,3139,3239,2357,2990,1745,906,1643,356,1174,4214,4151,3584,1356,3240,2211,3092,2892,2143,940,4583,810,2870,2483,4538,1576,982,4697,3896,180,2644,3849,1680,503,2729,3931,4388,3625,2902,612,3377,1594,2792,3701,4776,186,4590,2859,4793,3691,3486,1575,1706,2640,899,3498,3719,404,4376,1119,1547,825,3213,3875,1426,2718,1491,4384,2269,4102,4535,944,2932,3564,2886,2028,3439,1756,2267,4650,40,1889,3928,92,4319,951,1597,3378,4381,2756,2799,3643,1317,1077,3151,2512,337,4388,2699,2112,2796,3430,87,3541,252,1119,2918,1946,3065,3031,1051,2564,1371,3497,814,3570,989,591,2256,261,875,4307,4692,4420,2951,2491,2413,2511,1057,4562,319,2009,4362,1113,4063,4366,3511,794],"ngrams":["st$","^is","ser","^ie","an$","yp$","^ty","et$","nse","ens","ate","^da","fel","jed","^je","für","^fü","hri","chr","^sc","^ge","ese","ies","set","^n$","al$","ona","pti","ebe","ist","nit","kti","ell","geb","ang","en$","ion","^an","tel","pen","sfe","ldt","^el","fah","rtf","sem","vie","llu","ort","dem","rdn","for","ype","^fo","irk","^im","wir","^si","ten","opt","hte","cht","rt$","ld$","bab","ich","far","rba","em$","hre","arb","ere","^fa","ede","hni","lic","nge","im$","tio","ung","ahr","rkl","dat","ste","nst","^öc","dty","ins","^or","kli","^di","ein","ie$","eld","rde","rei","dne","typ","nal","erd","ür$","ch$","ert","des","gen","sie","rit","^we","ren","ben","tfa","esf","wer","tiv","ier","tt$","dea","lun","aus","öch","die","^wi","^ak","ivi","chn","^au","abs","eak","akt","^op","^de","den","er$","ner","^ab","bsc","us$","ord","sch","itt"],"ngram_size":3,"dimension":5000},{"language":"de","weights":[0.00347222,0.00347222,0.0173611,0.0104167,0.0104167,0.0694444,0.00694444,0.0277778,0.00694444,0.121528,0.0451389,0.0520833,0.0243056,0.0243056,0.00694444,0.0173611,0.0104167,0.0763889,0.0763889,0.0208333,0.125,0.00347222,0.0173611,0.0451389,0.0416667,0.0104167,0.125],"ids":[5,43,77,0,88,66,32,2,57,79,0,24,63,22,59,11,65,21,20,58,68,28,22,44,96,19,52],"ngrams":["j","ü","p","m","g","i","w","l","v","e","d","r","h","o","u","b","y","t","n","c","$","ö","f","s","a","k","^"],"ngram_size":1,"dimension":100},{"language":"el","weights":[0.00763359,0.00763359,0.00763359,0.0152672,0.00763359,0.0152672,0.00763359,0.00763359,0.0152672,0.00763359,0.00763359,0.0152672,0.00763359,0.0152672,0.00763359,0.0152672,0.00763359,0.00763359,0.00763359,0.0152672,0.00763359,0.00763359,0.00763359,0.0229008,0.0152672,0.0229008,0.0229008,0.0152672,0.00763359,0.00763359,0.00763359,0.00763359,0.0152672,0.0152672,0.0152672,0.00763359,0.00763359,0.00763359,0.00763359,0.00763359,0.0229008,0.00763359,0.0152672,0.0229008,0.00763359,0.0152672,0.0458015,0.0229008,0.00763359,0.00763359,0.0229008,0.0152672,0.00763359,0.0152672,0.00763359,0.00763359,0.00763359,0.00763359,0.00763359,0.00763359,0.0152672,0.00763359,0.00763359,0.0152672,0.00763359,0.00763359,0.00763359,0.00763359,0.0229008,0.00763359,0.0152672,0.00763359,0.0152672,0.00763359,0.00763359,0.0152672,0.0152672,0.00763359,0.0152672,0.0229008,0.0152672,0.00763359,0.00763359,0.00763359],"ids":[122,902,424,320,881,999,506,369,573,799,288,232,805,845,245,653,773,363,754,631,870,808,445,235,914,547,471,595,885,652,727,792,261,182,176,585,645,399,393,108,788,187,688,820,185,290,721,356,792,876,100,386,505,978,160,276,876,860,960,762,481,616,662,625,517,722,287,880,51,627,781,486,557,33,858,838,209,280,743,113,326,374,791,794],"ngrams":["ου","πή","ημ","ετ","οχ","το","σό","ισ","ε�","ά$","ιά","ες","ξε","νε","θε","έν","ωμ","νω","ον","�ο","μο","εμ","σε","με","δι","στ","^μ","τε","χο","ήσ","^π","ασ","ις","τα","ατ","�$","ιο","πε","ο�","κα","ει","ητ","λε","^τ","ήτ","λέ","ς$","ή$","σσ","ση","τη","ιδ","τ�","η$","τή","ζή","�ι","α�","να","�ν","^α","^ή","αν","^σ","ξη","ησ","αζ","οθ","ε$","υς","μέ","ης","κλ","νη","ότ","^$","τι","ο$","έξ","^κ","^λ","οπ","ικ","κή"],"ngram_size":2,"dimension":1000},{"language":"el","weights":[0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0105263,0.0210526,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0210526,0.0210526,0.0105263,0.0105263,0.0210526,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263],"ids":[4838,70,3513,4532,4566,1058,740,1803,2563,1447,3251,4293,1713,464,3126,3311,2509,1047,3128,1335,2338,4611,4054,1478,2193,112,1347,3202,2575,4402,3695,4413,2543,968,2347,3018,1850,3274,1001,1682,2627,3769,3526,2937,2060,552,528,3359,2826,4511,2395,3083,102,4543,1845,3449,355,1260,4884,1411,3800,4326,3059,1085,2818,2446,4606,4480,2794,3951,1962,1104,366,621,767,2064,2766,579,2552,4139,3763,2483,2011,4261,4597,4015,4374],"ngrams":["^σε$","ους$","τους","^του","τατ�","^με$","ημέν","^μετ","τημέ","θετη","τοχο","^στο","ατ�ο","τε�ο","ότε�","σότε","�ισσ","^πε�","διά$","νες$","α�νη","ένες","ετημ","ωμέν","ατασ","ονωμ","εμον","ε�ισ","^τις","στε$","ισσό","τήστ","ταστ","ετατ","λέξε","κατα","^κατ","διο�","μετα","^μεμ","^λέξ","^κλε","κλει","στοχ","έξει","ειδι","τις$","ήστε","�οπή","οθετ","σσότ","στήσ","ητικ","ξης$","νωμέ","ε�ο$","ιο�$","οχοθ","λέξη","ιδιά","μένε","ιδιο","ηση$","^τη$","χοθε","^α�ν","εις$","^ανα","έξης","ναζή","αστή","οπή$","τηση","μονω","ήτησ","τ�οπ","τική","ζήτη","πε�ι","μεμο","αναζ","λειδ","�νητ","ική$","ξεις","νητι","αζήτ"],"ngram_size":4,"dimension":5000},{"language":"el","weights":[0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.0267857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.0178571,0.0178571,0.0178571,0.00892857,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857],"ids":[2530,907,2716,2332,2130,3073,199,2542,1801,2440,1221,4528,2505,4449,3398,436,1968,4312,4742,1278,1142,1866,926,4898,4545,2356,542,3017,4343,3905,3824,411,2946,2998,1180,417,4859,3004,3323,815,1508,3930,4386,2967,140,2549,1706,2426,2172,3672,2665,1184,1059,259,2761,318,515,224,2381,2496,241,4467,2386,4751,4069,4691,664,4761,692,281,1695,2771,4212,1228,4168,4194,1299,3859,4365,4894,4525,659,559,400,2250,1681,2635,4451,1914,771,3255,1320,3779,4932,2878,1424,4287,2715],"ngrams":["του","^το","πή$","^τη","με$","^με","ημέ","θετ","υς$","οπή","τασ","οχο","τοχ","τε�","^πε","ότε","σότ","έξε","σσό","^αν","^στ","^λέ","�ισ","εμο","μετ","ε�ι","πε�","ε�ο","διά","ιά$","λέξ","ξει","στή","ένε","ζήτ","ωμέ","διο","νωμ","μέν","τη$","ονω","μον","ιδι","ση$","έξη","ισσ","^α�","τις","ες$","^τι","�νη","τε$","ήστ","ους","νητ","ατα","�οπ","ιο�","τ�ο","�ο$","λει","ο�$","μεμ","ητι","ειδ","κλε","^κλ","τήσ","ξης","τημ","νες","στε","^ή$","ηση","τησ","τικ","ναζ","κή$","ις$","χοθ","α�ν","αζή","^σε","στο","αστ","κατ","ική","σε$","ετα","οθε","^κα","τατ","ανα","ετη","ήτη","εις","ης$","ατ�"],"ngram_size":3,"dimension":5000},{"language":"el","weights":[0.00666667,0.00666667,0.00666667,0.0133333,0.00666667,0.00666667,0.0466667,0.00666667,0.0266667,0.0133333,0.0333333,0.0866667,0.04,0.0266667,0.0466667,0.0266667,0.0533333,0.0866667,0.04,0.00666667,0.0333333,0.0266667,0.04,0.04,0.00666667,0.126667,0.0133333,0.126667],"ids":[82,46,85,68,6,30,89,98,37,7,83,70,29,62,16,56,81,32,18,20,14,2,99,29,55,68,44,52],"ngrams":["υ","χ","ό","π","ά","ω","ο","θ","λ","δ","ή","ε","ς","έ","σ","κ","ι","τ","η","ζ","ν","�","α","μ","�","$","ξ","^"],"ngram_size":1,"dimension":100},{"language":"en","weights":[0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00793651,0.00396825,0.00396825,0.00793651,0.0119048,0.00396825,0.00793651,0.00793651,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.0119048,0.00793651,0.00793651,0.00793651,0.00793651,0.0119048,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00396825,0.00793651,0.00793651,0.00396825,0.00793651,0.00793651,0.00396825,0.0119048,0.0277778,0.00793651,0.0119048,0.00396825,0.0119048,0.0119048,0.00793651,0.0119048,0.031746,0.0119048,0.00396825,0.0396825,0.00396825,0.015873,0.015873,0.00793651,0.00396825,0.0198413,0.00396825,0.00396825,0.00793651,0.00396825,0.0119048,0.00793651,0.00793651,0.00396825,0.00396825,0.0277778,0.00396825,0.00396825,0.00793651,0.00793651,0.0119048,0.00396825,0.00793651,0.00793651,0.00793651,0.0119048,0.00396825,0.00396825,0.0119048,0.015873,0.00396825,0.00793651,0.00793651,0.00793651,0.00793651,0.015873,0.00396825,0.00396825,0.015873,0.015873,0.00396825,0.00396825,0.00396825,0.0119048,0.015873,0.00793651,0.00396825,0.00793651,0.015873,0.00396825,0.00396825,0.00793651,0.00396825,0.0238095,0.00793651,0.00396825,0.00396825,0.00396825,0.0119048,0.00396825,0.00396825,0.00396825,0.0238095],"ids":[898,637,694,809,356,178,998,591,115,157,875,885,717,314,159,384,269,307,248,364,128,300,933,720,225,565,193,989,534,978,553,605,275,346,795,689,385,766,487,893,355,734,317,27,842,648,215,90,365,353,510,786,559,973,924,183,347,980,146,976,575,651,907,153,353,685,854,212,819,732,925,532,763,134,605,333,385,327,0,999,75,175,770,200,421,500,652,93,984,108,707,493,933,937,71,67,960,476,996,116,712,486,862,793,489,996,613,838,707,803,575,381,347,123,532,265,489,86,677,191,287,989,501,768,8],"ngrams":["ts","ut","of","nd","me","ym","ay","ro","bl","na","un","^u","^w","l$","py","ns","an","nc","n$","vi","po","m$","tp","co","ss","lp","le","gl","oo","bi","go","ng","tt","ls","ai","ht","de","ab","om","mo","^m","et","hl","si","fo","f$","ta","^f","tr","^h","s$","is","wo","el","dw","he","th","^t","or","^o","^e","e$","ag","en","er","sw","ac","^p","li","su","^g","o$","ad","p$","y$","ll","ck","r$","oc","ge","pr","il","g$","st","ur","yo","up","ou","rt","ps","ce","in","ti","og","^v","nt","pa","^c","by","ar","we","^b","^d","to","ed","ds","t$","^$","d$","di","rd","fe","pp","^y","^s","re","es","cr","ef","ku","it","a$","ba","ca","^a"],"ngram_size":2,"dimension":1000},{"language":"en","weights":[0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.0182927,0.0121951,0.00609756,0.0121951,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0182927,0.00609756,0.00609756,0.0182927,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0182927,0.0182927,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.0121951,0.0121951,0.0121951,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0182927,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0182927,0.0121951,0.0121951,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756],"ids":[2984,4231,3534,1470,443,4729,4995,3790,2789,351,3140,1413,3183,4748,1873,1787,23,4611,562,2014,3178,1994,2347,2247,259,4737,4791,179,4529,1832,4416,1419,2552,2251,3775,304,3923,2957,923,3552,2109,807,3760,3561,607,1372,1258,728,1494,2183,4780,2042,94,4971,4138,1510,1513,1506,2158,1169,1232,2450,4885,4947,2890,3267,4908,438,990,177,755,3845,2261,1100,3373,81,3085,860,499,4951,2539,4910,2763,3054,4816,846,3221,105,2160,3873,2118,4123,654,826,2925,3009,237,2526,2202,3665,4196,2304,4390,3029,936,3650,1335,2580,751,1128,4409,3022,3320,1673,3298,1653,4833,4317,2655,1982,2237,3394,4504,1257,4131,4176,2352,2291,559,2038],"ngrams":["andi","stan","tsta","utst","outs","ment","ayme","^pay","tand","^to$","unab","^una","ere$","oces","^wer","^en$","^hl$","swer","^hel","nswe","elp$","^ans","^bin","ble$","ort$","^com","word","gle$","entr","oogl","cess","uppo","^goo","deta","tps$","ndin","proc","http","ils$","help","port","^pro","etai","ttps","more","^mor","ntre","illi","^det","cent","back","^cen","^we$","dwor","ess$","roce","^adw","^the","ails","^bil","sit$","bin$","^or$","itin","were","^pag","age$","ords","rds$","ces$","fere","goog","tre$","^of$","page","ppor","efer","wer$","nces","^htt","ard$","refe","visi","pref","ore$","isit","renc","ling","ence","^out","^py$","eren","^pre","llin","bill","your","ogle","^for","^you","^by$","edit","^vis","ckup","card","com$","ymen","siti","^car","supp","tail","adwo","able","ting","the$","ent$","^cre","^bac","redi","cred","ding","paym","dit$","ing$","for$","answ","acku","^sup","nabl","our$","kup$"],"ngram_size":4,"dimension":5000},{"language":"en","weights":[0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.00966184,0.00966184,0.00966184,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.00966184,0.00483092,0.00966184,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.00966184,0.00966184,0.00966184,0.00966184,0.00483092,0.0144928,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.00483092,0.00966184,0.00483092,0.0144928,0.00483092,0.0144928,0.0144928,0.00483092,0.00483092,0.00966184,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.00966184,0.00966184,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00966184,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.0144928,0.00966184,0.00966184,0.00966184,0.0144928,0.00483092,0.00483092,0.00483092,0.0144928,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.0144928,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092],"ids":[2386,1558,2503,2953,1636,4798,94,1093,3102,2437,2096,873,1501,2683,579,1689,2241,1119,3417,1063,2694,104,1051,1803,4828,1700,3931,4258,4211,4590,4826,2860,1931,1030,4484,842,1547,4497,1010,4625,1818,3018,4901,2672,3705,1184,2918,2607,470,331,1494,4449,157,367,1575,2736,1881,319,1439,1601,3931,504,3938,1794,4866,3367,2244,2302,4229,1685,2891,162,771,669,3691,503,4102,2713,4366,644,1597,2445,4814,2260,3939,4427,2239,2649,327,4608,4441,3359,2110,2660,152,2875,1442,550,2488,17,4102,3501,4743,933,2481,4103,582,4534,2815,3984,3549,4672,4040,3606,3795,535,4971,4761,2585,2329,907,3629,4509,122,2789,1353,2053,1611,3965,92,159,201,15,1952,1608,4257,1057,2068,3356,2890,4729,2428,2957,1864,4092,3695,3278,194,1408,4779],"ngrams":["din","ndi","out","^ou","of$","^of","nt$","pay","ss$","and","oce","^to","abl","nab","^un","we$","men","^we","^en","py$","^py","roc","wer","swe","nsw","ans","^an","in$","bin","ort","por","ppo","^hl","upp","om$","com","rt$","le$","ogl","ge$","goo","ntr","ps$","^go","ttp","^by","ren","htt","^ht","yme","eta","^ca","det","^mo","^fo","uts","oog","er$","^pr","the","tre","re$","ail","cen","tps","lp$","elp","by$","hel","cre","^he","mor","ds$","pro","for","en$","rds","pag","ord","dwo","^or","efe","^pa","aym","ent","nce","bil","ref","una","pre","ill","you","isi","ess","ble","lin","ore","ng$","sit","our","ere","ack","tin","es$","bac","^bi","sta","rd$","ils","kup","iti","up$","he$","^yo","sup","age","tst","vis","^su","^ad","ces","ur$","^th","or$","ard","to$","red","adw","lli","^cr","gle","dit","cku","fer","^vi","tai","^de","^ce","it$","tan","car","^a$","ls$","wor","ing","edi","^co","enc","hl$","^ba"],"ngram_size":3,"dimension":5000},{"language":"en","weights":[0.010101,0.037037,0.023569,0.016835,0.0639731,0.013468,0.047138,0.026936,0.040404,0.016835,0.047138,0.0808081,0.03367,0.0639731,0.026936,0.00673401,0.03367,0.151515,0.003367,0.016835,0.020202,0.023569,0.043771,0.151515],"ids":[0,66,32,63,22,22,44,88,20,65,21,79,0,24,2,57,77,52,19,11,59,58,96,68],"ngrams":["m","i","w","h","o","f","s","g","n","y","t","e","d","r","l","v","p","^","k","b","u","c","a","$"],"ngram_size":1,"dimension":100},{"language":"eo","weights":[0.00389105,0.00389105,0.00389105,0.00389105,0.00389105,0.00389105,0.00389105,0.0077821,0.0077821,0.0077821,0.00389105,0.00389105,0.0116732,0.00389105,0.0155642,0.0116732,0.0155642,0.00389105,0.00389105,0.00389105,0.00389105,0.0233463,0.0077821,0.00389105,0.00389105,0.00389105,0.00389105,0.0077821,0.00389105,0.00389105,0.00389105,0.00389105,0.0116732,0.00389105,0.00389105,0.0077821,0.0233463,0.00389105,0.00389105,0.00389105,0.0077821,0.0077821,0.0077821,0.00389105,0.0155642,0.00389105,0.00389105,0.0116732,0.0077821,0.0077821,0.0077821,0.00389105,0.00389105,0.00389105,0.0077821,0.00389105,0.0155642,0.00389105,0.0077821,0.0194553,0.00389105,0.0116732,0.00389105,0.00389105,0.0077821,0.0077821,0.00389105,0.0155642,0.0077821,0.00389105,0.00389105,0.0272374,0.0272374,0.00389105,0.0194553,0.0116732,0.00389105,0.0077821,0.0077821,0.0155642,0.0077821,0.00389105,0.00389105,0.0194553,0.00389105,0.00389105,0.00389105,0.00389105,0.00389105,0.0233463,0.0350195,0.00389105,0.00389105,0.0116732,0.0155642,0.00389105,0.0116732,0.00389105,0.00389105,0.0116732,0.00389105,0.00389105,0.00389105,0.0194553,0.0116732,0.0077821,0.0116732,0.0155642,0.0077821,0.00389105,0.0155642,0.0116732,0.00389105,0.0155642,0.0155642,0.0194553,0.00389105,0.0155642,0.0077821],"ids":[493,364,549,551,10,134,503,877,193,265,973,999,378,314,510,887,786,96,18,292,980,989,685,501,935,748,778,487,893,146,75,803,215,90,635,307,248,403,46,854,157,875,927,734,915,285,780,3,879,490,200,421,41,287,955,637,933,612,942,757,702,489,381,984,356,809,517,61,862,207,114,153,532,763,269,677,67,960,27,842,535,365,672,334,300,285,429,205,726,651,575,296,104,353,526,166,707,518,484,591,605,68,176,265,895,838,62,980,116,793,385,80,629,8,826,212,648,75,327],"ngrams":["in","vi","nl","jn","ie","p$","us","ez","le","kl","el","ge","la","l$","s$","oj","is","ni","as","ŭ$","aŭ","a$","je","ba","ap","mb","ru","om","mo","or","op","di","ta","^f","uj","nc","n$","no","al","^n","na","un","mu","et","io","iu","va","j$","ra","um","st","ur","ma","it","te","ut","ti","kz","kd","ek","aj","es","fe","rt","me","nd","mi","^k","^d","ej","do","en","o$","ad","an","ef","nt","pa","si","fo","^l","tr","da","^r","m$","rm","ia","ev","nm","e$","^e","nf","sp","er","on","rn","ce","pe","rc","ro","ng","^j","lu","re","am","^$","zi","^t","ar","to","de","nu","ja","^a","ko","^p","ov","pr","r$"],"ngram_size":2,"dimension":1000},{"language":"eo","weights":[0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0111732,0.0111732,0.0111732,0.0111732,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0167598,0.00558659,0.0111732,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.0111732,0.0111732,0.00558659,0.00558659,0.0111732,0.0111732,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.0167598,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659,0.00558659,0.00558659,0.00558659,0.0167598,0.00558659,0.00558659,0.00558659,0.00558659,0.0111732,0.00558659,0.00558659],"ids":[2113,279,1556,2855,542,660,773,2264,927,3655,174,2081,1887,3274,2919,4386,1162,3193,3599,1639,1613,4200,2150,3511,3625,2798,3145,226,2655,1446,1198,4258,4538,2905,4689,3782,3223,411,1285,4320,1787,4253,4983,4588,2746,807,1809,325,3592,3737,1751,1352,2233,1800,2131,4974,4564,1777,1549,673,741,4821,3757,4404,2240,3971,2997,1501,4295,35,2514,1645,3899,2383,4173,268,705,2101,1736,1109,1404,4703,1834,3274,1253,3381,626,520,4198,765,937,3662,4251,753,4089,1398,2525,3257,4068,4918,1255,4768,4707,3476,91,1366,357,100,3117,3517,4415,265,1653,4791,3329,2796,4855,2321,523,3737,4473,2183,1739,1564,4215,1840,2044,3195,3454,2657,2371,2125,1871,3557,845,3210,1029,1696,1862,2122,753,990,4258,2414,4728,4858,1362,3119,977,3132,183,1808,4749],"ngrams":["ncek","ince","vinc","rovi","prov","nda$","land","nlan","jnla","ejnl","^rej","ies$","ties","^tie","resp","usio","rusi","prus","zio$","ezio","klez","ekle","ela$","vang","evan","^eva","^la$","nis$","enis","teni","rten","^ekl","apar","^apa","baŭ$","mbaŭ","anda","^res","amba","^amb","^en$","nur$","lezi","mon$","uman","^pro","umon","ran$","pran","opra","ropr","dis$","rcen","kzis","ondi","anoj","^fon","nto$","iuj$","ado$","tiuj","esp$","amen","noj$","part","mano","unum","prop","^pru","tiam","omun","etad","munu","^kom","naj$","rana","foje","kde$","tame","eran","tera","lute","tis$","^ekz","stis","rejn","fesi","astr","^ekd","^nur","refo","nfes","onfe","efoj","past","mita","zist","rmit","rna$","ita$","jarc","^tia","sio$","stro","numo","gela","fond","men$","ekde","form","^pas","cekl","komu","^lut","ncer","tro$","ekzi","once","konc","ange","cern","cent","^de$","isti","meta","^al$","^jar","ento","nmet","^tam","ormi","anaj","erna","arte","uter","ngel","^enm","per$","^per","oje$","tado","esio","efor","arce","ovin","^ref","^tiu","enme","ndis","iam$","^kon","numa","konf"],"ngram_size":4,"dimension":5000},{"language":"eo","weights":[0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00921659,0.00921659,0.00921659,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.0184332,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.00460829,0.00921659,0.00921659,0.00460829,0.00921659,0.00460829,0.00460829,0.00460829,0.00921659,0.0138249,0.00460829,0.00460829,0.00460829,0.00460829,0.00921659,0.0184332,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.00921659,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.00460829,0.00460829,0.00921659,0.0184332,0.00460829,0.00460829,0.0138249,0.0230415,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.0184332,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.0184332,0.00460829,0.00460829,0.00460829,0.00460829,0.00460829,0.0184332,0.00460829,0.00460829,0.00460829,0.00921659,0.00460829,0.00460829,0.00921659,0.00460829,0.00460829,0.00460829,0.0138249,0.00460829,0.00460829,0.00921659,0.0138249,0.00460829,0.0138249,0.00460829,0.00460829,0.00460829,0.00460829],"ids":[1886,278,4405,562,2272,36,4583,4234,1610,2597,1132,2531,484,3196,4700,1336,1680,681,4650,1307,239,2437,2034,2387,4194,926,1711,1971,405,2140,3844,4272,2266,4263,3629,840,2267,2792,2577,3239,4775,652,524,1960,1558,2242,469,2120,503,2241,16,1575,4639,3288,4770,1843,3088,400,4726,1943,4815,2483,2805,1426,3719,4983,1552,611,2557,4287,2375,933,1733,3969,3565,3485,2687,2379,2484,727,4034,501,1001,4501,3323,3346,3116,3643,326,669,1971,3691,4144,1987,2667,3106,2898,4356,4399,1628,4923,230,2932,996,3590,4673,4697,1193,748,1057,3684,539,2130,1111,1366,4275,2333,2112,2032,699,4024,2603,2861,4427,3939,4324,1951,2886,971,4599,446,2428,1480,1594,1740,3417,2039,4696,1486,2090,1953,2759,1168,2939,2936,2035,1494,3217,4343,1353,1794,374,1116,1297,2742,4511,2649,4814,1439,319,4150,2364,1493],"ngrams":["cek","inc","vin","rov","da$","ejn","ies","res","usi","rus","pru","zio","lez","kle","nla","gel","ang","ekl","van","eva","^ev","and","la$","^la","^al","rte","nda","art","^ap","baŭ","sp$","mba","^am","jnl","ur$","nur","on$","rej","mon","an$","pra","rop","dis","ela","ndi","iuj","opr","^ta","en$","men","ita","^fo","oj$","ano","uma","mit","num","ame","zis","unu","omu","al$","kom","aj$","ten","era","ezi","is$","tiu","tis","sti","es$","ekd","^ek","noj","arc","onc","sio","ovi","foj","fes","^lu","str","ekz","nfe","kon","onf","eni","rmi","pro","de$","for","cer","^ti","^re","tro","fon","amb","tia","per","ast","nis","umo","am$","ute","na$","ist","do$","ro$","^de","rna","^ko","tie","apa","ern","orm","jar","enm","iam","mun","ter","pas","ana","nce","ent","aŭ$","ado","nge","tad","lan","esp","^a$","nme","ran","esi","^en","uj$","ta$","^pe","rce","tam","io$","nto","ond","lut","oje","eta","naj","kde","to$","cen","man","efo","^nu","kzi","je$","ref","^pa","^pr","er$","met","par","^ja"],"ngram_size":3,"dimension":5000},{"language":"eo","weights":[0.003367,0.043771,0.030303,0.023569,0.00673401,0.026936,0.003367,0.003367,0.026936,0.037037,0.0740741,0.13468,0.010101,0.030303,0.016835,0.023569,0.111111,0.010101,0.0639731,0.023569,0.0572391,0.0740741,0.030303,0.13468],"ids":[88,66,0,2,57,77,36,11,59,21,20,68,86,44,22,0,79,58,22,5,24,96,19,52],"ngrams":["g","i","m","l","v","p","ŭ","b","u","t","n","$","z","s","f","d","e","c","o","j","r","a","k","^"],"ngram_size":1,"dimension":100},{"language":"es","weights":[0.00401606,0.00401606,0.00401606,0.00803213,0.00803213,0.00803213,0.00401606,0.0120482,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00803213,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.0120482,0.0120482,0.00401606,0.00401606,0.00401606,0.00803213,0.00401606,0.00401606,0.00803213,0.0240964,0.00401606,0.0120482,0.0160643,0.00401606,0.00401606,0.00803213,0.00401606,0.00401606,0.00803213,0.00401606,0.00401606,0.00401606,0.0120482,0.00401606,0.0200803,0.00401606,0.0120482,0.00401606,0.0401606,0.0281125,0.00401606,0.0120482,0.00401606,0.0281125,0.00803213,0.00803213,0.0160643,0.00401606,0.00401606,0.00401606,0.00803213,0.00803213,0.00401606,0.00401606,0.0401606,0.00401606,0.0120482,0.0120482,0.00401606,0.00401606,0.0120482,0.00803213,0.0120482,0.00401606,0.00401606,0.00401606,0.00401606,0.0120482,0.00401606,0.00803213,0.00401606,0.00401606,0.0120482,0.00803213,0.0160643,0.0281125,0.0160643,0.00401606,0.0120482,0.00803213,0.00401606,0.00401606,0.00803213,0.0160643,0.00401606,0.00803213,0.00803213,0.0120482,0.00401606,0.0120482,0.00401606,0.00803213,0.00401606,0.00803213,0.00401606,0.00401606,0.0120482,0.00803213,0.0200803,0.00401606,0.0120482,0.00401606,0.00401606,0.00401606,0.00803213,0.00803213,0.00401606,0.00401606,0.00803213,0.00401606,0.00803213],"ids":[269,7,532,809,356,265,71,540,891,493,365,891,193,404,123,282,126,32,333,196,605,925,334,672,252,75,656,879,692,920,458,215,90,18,200,984,893,487,778,676,378,900,353,104,493,223,862,592,116,786,510,489,802,895,364,385,489,80,339,134,503,303,748,327,501,458,989,332,237,526,478,780,955,83,980,859,8,486,943,486,536,915,315,734,314,973,153,651,575,875,157,976,303,135,88,720,129,752,353,476,429,963,532,727,768,512,637,501,212,854,248,933,535,747,854,885,46,838,960,67,978,349,819],"ngrams":["an","sa","^s","nd","me","re","^v","os","^q","lo","tr","^é","le","ec","^y","rá","gr","ús","ll","ví","y$","^g","^r","da","sq","op","bo","ra","gi","ua","fi","ta","^f","as","st","rt","mo","om","ru","za","la","pl","er","sp","in","pá","^d","bú","ar","is","s$","es","eo","am","áf","de","ed","nu","ue","én","us","ié","mb","r$","ba","tu","a$","ob","ne","on","bt","pu","te","ón","^t","tó","^a","ió","ot","^b","és","io","ág","et","l$","el","en","e$","^e","un","na","^o","c$","cl","az","co","pc","ha","^h","^c","ia","ci","o$","qu","ca","ic","ut","íd","^p","ac","n$","ti","^l","z$","^n","^u","al","^$","pa","nt","bi","se","li"],"ngram_size":2,"dimension":1000},{"language":"es","weights":[0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.0121212,0.00606061,0.0121212,0.0121212,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.0181818,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0181818,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061],"ids":[3861,354,508,4111,3701,1607,3550,3879,2777,3122,2063,1901,3429,1333,577,921,1795,1809,4390,3711,4555,3788,250,4695,796,189,3312,4046,4677,4387,1413,3553,244,2251,3123,4066,1729,931,851,1030,1,720,2738,1494,2580,1702,2978,147,3009,2212,2672,2254,165,386,1006,1739,4853,626,3467,232,1614,258,1650,2835,2686,2772,4499,305,2383,3171,1892,3753,68,1312,4292,3002,1479,459,718,1285,1635,4930,1961,4754,4084,3102,567,2783,2401,2607,3755,1351,183,2300,4908,2392,4632,3700,411,4312,1711,826,3683,1213,4128,2663,2075,2657,4211,3557,258,1465,3956,4443,375,2499,4173,3900,4776,4147,3406,4113,700,3145,2967,1473,4581,3150,4257,2665,3267,4423,1884,1758,1312,1594,2606,2556,832,351,4683,4714,1004,1126,2952,4520,1787,3801],"ngrams":["^se$","acio","daci","ras$","tras","stra","estr","^nue","mos$","amos","ndam","enda","ecom","basa","come","reco","^te$","^que","^bas","omen","eos$","deos","ídeo","^víd","^los","ista","list","^lis","asan","una$","^una","ésta","tall","deta","fico","áfic","ráfi","les$","^grá","eda$","ueda","sque","ones","^det","^cam","tinu","ione","san$","que$","etal","cion","^tus","ión$","iar$","nuac","^de$","biar","nal$","búsq","^es$","para","^par","cont","ién$","tamb","hast","^opc","víde","pági","espl","inal","uaci","fina","uest","^bot","gráf","los$","úsqu","ción","^haz","laza","^fin","ndac","plaz","sta$","asta","ruta","^has","ació","opci","rte$","tus$","uta$","ner$","pued","^el$","desp","ico$","mend","des$","^cli","bién","mbié","ntin","nes$","azar","otón","^tam","^ést","arte","^pue","^rut","tene","ener","bten","^obt","qued","^pág","^rec","tón$","clic","botó","edes","^la$","ambi","onti","lles","zart","haz$","camb","inua","obte","ina$","lic$","mbia","pcio","spla","damo","gina","uede","^bús","alle","^con","nues","ara$","ágin","^en$","^des"],"ngram_size":4,"dimension":5000},{"language":"es","weights":[0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00970874,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00970874,0.0145631,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00970874,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.0145631,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.0145631,0.00970874,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.0242718,0.00970874,0.00485437,0.0242718,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00970874,0.00970874,0.00485437,0.00485437,0.00970874,0.00485437,0.00485437,0.00485437,0.00485437,0.0194175,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437,0.00485437],"ids":[3239,592,2224,4779,1051,4511,1376,1001,1297,3368,4058,842,3943,3606,3,119,1962,3044,3757,4916,2682,4697,617,2816,327,579,2908,271,18,357,3006,721,3815,1226,2272,3187,1533,3745,3398,4794,3238,2241,3739,637,1147,503,2120,2729,1494,3510,3430,2328,157,4449,1982,3957,2258,2289,2511,4063,3121,1357,3048,3082,2364,4259,3508,4814,1007,4673,1971,1588,337,2427,2277,1421,582,67,2034,926,1711,3272,2554,1971,1732,4530,2612,1819,2428,446,4045,1958,1137,1057,4972,1669,933,3980,1032,1003,456,3704,3564,1490,2009,4637,4226,2032,1471,2976,4109,16,700,3848,319,2704,3377,4356,3006,4310,3676,1384,3518,2961,3278,2064,1448,4017,4894,4972,3814,2387,4882,1302,944,4631,3104,3417,4827,2700,2667,3136,4923,382,4662,1283,4743,2570,4696,2349,1618,1900,4835,3917,1953,1914,2038,399,2483,891,2834,162,256,3719],"ngrams":["an$","san","asa","^ba","dac","ras","tra","str","^nu","mos","dam","com","eco","^se","eos","deo","ome","víd","end","os$","los","ist","nue","lis","una","^un","^es","ést","ue$","les","all","tal","áfi","grá","da$","eda","squ","rec","úsq","bús","^bú","men","zar","nes","con","en$","^ta","ion","eta","cli","des","cio","det","^ca","haz","pci","opc","ues","^op","us$","^tu","bia","obt","ra$","par","se$","^és","^pa","ció","na$","de$","mbi","nal","fin","^fi","^pá","sta","te$","la$","rte","nda","inu","tón","art","iar","ara","aza","spl","^a$","esp","que","gin","pla","^de","one","ági","es$","ic$","laz","fic","ued","pue","lic","ico","ner","uac","^pu","ién","lle","^ha","^cl","^te","uta","co$","er$","amo","^el","amb","^li","bte","íde","ráf","cam","otó","^co","bot","bas","ar$","^bo","^ru","el$","^la","ene","ina","ede","én$","as$","^en","^lo","ón$","^re","^ob","ast","aci","^qu","az$","tin","^gr","ta$","ión","est","bié","pág","^y$","tam","nua","has","tus","al$","ont","^ví","rut","nti","ten"],"ngram_size":3,"dimension":5000},{"language":"es","weights":[0.00342466,0.00684932,0.0171233,0.00342466,0.0171233,0.0308219,0.0342466,0.0924658,0.00684932,0.0616438,0.14726,0.00684932,0.0410959,0.00684932,0.00684932,0.0205479,0.00342466,0.00684932,0.0445205,0.00684932,0.0547945,0.0273973,0.0342466,0.00684932,0.0376712,0.0890411,0.00342466,0.0342466,0.14726],"ids":[54,88,77,96,0,24,0,79,22,44,68,86,22,63,65,11,65,12,21,58,20,59,58,11,66,96,57,2,52],"ngrams":["í","g","p","ú","m","r","d","e","f","s","$","z","o","h","á","b","y","q","t","é","n","u","c","ó","i","a","v","l","^"],"ngram_size":1,"dimension":100},{"language":"et","weights":[0.008,0.008,0.008,0.008,0.008,0.016,0.008,0.008,0.008,0.008,0.016,0.008,0.008,0.008,0.008,0.008,0.008,0.008,0.008,0.008,0.016,0.024,0.024,0.008,0.016,0.008,0.016,0.008,0.016,0.032,0.024,0.016,0.008,0.016,0.024,0.008,0.008,0.016,0.04,0.048,0.016,0.016,0.024,0.008,0.024,0.016,0.016,0.016,0.008,0.008,0.008,0.024,0.016,0.016,0.024,0.008,0.016,0.008,0.016,0.016,0.032,0.008,0.016,0.008,0.016,0.016,0.008,0.016,0.016,0.008],"ids":[175,531,757,29,826,503,707,734,385,564,510,183,660,392,19,534,128,212,173,356,248,120,613,822,287,200,517,391,819,803,532,265,379,41,841,645,519,489,61,983,355,848,493,46,27,134,237,989,353,518,298,108,191,458,422,10,349,8,80,496,651,854,820,307,526,838,96,23,976,535],"ngrams":["il","ee","ek","oh","ko","us","d$","et","de","ki","s$","he","lt","ud","ol","oo","po","^p","ei","me","n$","im","t$","aa","it","st","mi","ga","li","di","^s","re","ig","ma","id","^i","ln","ed","^k","ii","^m","i$","in","al","si","ui","ne","a$","^h","pe","ip","ak","ku","tu","ks","ie","se","^a","nu","kr","e$","^n","ea","hu","on","^$","ni","u$","^o","^l"],"ngram_size":2,"dimension":1000},{"language":"et","weights":[0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0229885,0.0229885,0.0229885,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943],"ids":[552,4014,1932,4142,2617,2247,3332,89,3371,3171,2301,2941,4730,4838,3839,565,4317,4830,2327,1198,450,2189,3082,2330,1279,3289,330,3365,1912,1573,2911,4575,3478,2904,4844,59,4193,3156,3784,237,1928,1879,1936,3096,371,2894,4120,2649,4524,4862,3205,1441,2415,1043,2673,1145,544,1926,2565,4493,2741,2496,600,2461,1577,3550,4851,639,4499,49,500,1403,2087],"ngrams":["idil","^see","seks","stus","ustu","ohus","detu","idet","^kii","heak","^poo","meie","limi","^lim","diid","edii","redi","dili","^kre","kuin","hust","kohu","eaks","akui","imii","ipea","pea$","lne$","gaku","^iga","alne","aaln","see$","sinu","uine","imaa","ksim","eks$","^mei","iide","aksi","pool","igak","^hea","iidi","iipe","maks","kred","kui$","oolt","aks$","idi$","sima","^koh","eie$","kiid","^sin","^on$","^kui","olt$","ilim","maal","miit","^mak","ine$","tud$","inu$","tuse","iit$","usek","etud","niip","^nii"],"ngram_size":4,"dimension":5000},{"language":"et","weights":[0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.0190476,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.0190476,0.0190476,0.0190476,0.00952381,0.0190476,0.00952381,0.0190476,0.0190476,0.00952381,0.00952381,0.0190476,0.0285714,0.00952381,0.0190476,0.00952381,0.0190476,0.00952381,0.0190476,0.00952381,0.00952381,0.0190476,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.0190476,0.00952381,0.00952381,0.00952381,0.00952381,0.0190476,0.00952381,0.00952381,0.0190476,0.00952381,0.00952381,0.0190476,0.0190476,0.0190476,0.00952381,0.00952381,0.0190476,0.00952381,0.00952381,0.0190476,0.00952381,0.0190476,0.00952381,0.00952381,0.00952381,0.00952381],"ids":[1633,553,4024,3124,4853,3815,1456,539,1749,4094,2588,3552,335,4066,2491,4089,2891,3839,1887,2622,2799,44,2903,1745,2267,1881,3356,4852,3065,3006,3807,475,1755,4002,4714,3870,1594,4511,3606,3695,1851,2521,4867,3804,2722,3861,438,152,3938,1559,3608,1936,761,4587,2274,442,1168,592,384,308,2428,2053,3092,1264,2690,2828,4702,4094,3498,3478,1964,1150,4471,3166,399,358,4857,3272,4896,405,157,3877],"ngrams":["ili","dil","ee$","sek","ust","use","ohu","^ko","ud$","etu","tud","^ki","koh","ks$","eak","hea","^he","hus","lt$","poo","ie$","eie","ide","^me","on$","^on","it$","stu","mii","^li","imi","lim","di$","ima","idi","iid","ipe","dii","^se","edi","pea","kre","^ig","aku","^kr","gak","olt","mak","iga","aln","ool","^ma","aal","lne","maa","sim","aks","see","eks","ine","^a$","red","ksi","mei","nu$","^ku","ui$","ne$","^si","sin","^po","nii","iit","ea$","tus","kui","uin","inu","kii","^ni","det","iip"],"ngram_size":3,"dimension":5000},{"language":"et","weights":[0.0137931,0.0344828,0.0344828,0.0137931,0.0482759,0.0482759,0.0413793,0.0827586,0.0137931,0.0275862,0.137931,0.062069,0.0482759,0.158621,0.0551724,0.137931,0.00689655,0.0344828],"ids":[63,22,21,24,20,59,0,79,77,2,52,19,96,66,44,68,88,0],"ngrams":["h","o","t","r","n","u","d","e","p","l","^","k","a","i","s","$","g","m"],"ngram_size":1,"dimension":100},{"language":"eu","weights":[0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.0278884,0.0119522,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00398406,0.00398406,0.00796813,0.00796813,0.00796813,0.00398406,0.00398406,0.00796813,0.0119522,0.00398406,0.0239044,0.00398406,0.00398406,0.0119522,0.00398406,0.0199203,0.00796813,0.0159363,0.00398406,0.0119522,0.0119522,0.00796813,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.0119522,0.00398406,0.0119522,0.00796813,0.00398406,0.0159363,0.00398406,0.00796813,0.00796813,0.00398406,0.00796813,0.0199203,0.00796813,0.00796813,0.00796813,0.0119522,0.00796813,0.0159363,0.0358566,0.00796813,0.0159363,0.00398406,0.00398406,0.00398406,0.0119522,0.0199203,0.00398406,0.00398406,0.0159363,0.0159363,0.00796813,0.00398406,0.0199203,0.00398406,0.0159363,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.0159363,0.00796813,0.0239044,0.0119522,0.0239044,0.00796813,0.00398406,0.00398406,0.0119522,0.00796813,0.00398406,0.0398406,0.00398406,0.0119522,0.0159363,0.00796813,0.0119522,0.00398406,0.0159363,0.00796813,0.0239044,0.00796813,0.00796813,0.00398406,0.0119522,0.00398406],"ids":[848,787,637,378,973,745,927,575,651,19,403,975,122,34,325,267,355,679,672,391,937,676,645,877,980,248,841,886,553,978,493,230,747,795,976,738,157,875,885,46,854,265,605,176,734,364,935,591,429,263,421,780,287,955,339,692,803,327,62,501,989,458,146,144,809,985,353,116,917,510,153,862,147,907,8,481,875,493,535,365,269,887,215,526,353,826,486,61,925,237,18,601,613,879,489,630,795,98,385,545,757,752,532,838,108,88,984,67],"ngrams":["i$","tz","ut","la","el","ug","mu","^e","e$","ol","no","kn","ld","gu","zk","eh","^m","au","da","ga","og","za","^i","ez","^t","n$","id","eg","go","bi","in","iz","z$","ah","^o","so","na","un","^u","al","^n","re","ng","lu","et","uk","ap","ke","ia","ae","ur","pu","it","te","ue","gi","di","r$","zi","ba","a$","tu","or","be","nd","ri","^h","ar","rr","s$","en","^d","ka","ag","^a","hi","k$","lo","^l","tr","an","oz","ta","on","er","ko","^b","^k","^g","ne","as","ho","t$","ra","es","at","ai","ik","de","ir","ek","ha","o$","^$","ak","az","rt","nt"],"ngram_size":2,"dimension":1000},{"language":"eu","weights":[0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.0115607,0.017341,0.00578035,0.00578035,0.017341,0.00578035,0.017341,0.017341,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.017341,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.017341,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0231214,0.00578035,0.00578035,0.00578035,0.017341,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.017341],"ids":[1828,5,2586,2013,3557,3537,4339,3013,4564,1777,1143,4702,1954,1986,2898,1404,3095,2721,1705,195,14,4868,2588,2583,2662,193,735,2399,1762,3135,3092,473,568,1444,2753,4475,1596,3045,766,2098,4512,3548,4302,1434,903,790,4568,1342,1368,465,218,1884,1616,4740,1027,3245,1169,157,2150,1757,3325,1332,1873,316,3775,3171,4255,2973,70,2822,690,4639,3248,1278,1864,1492,3142,65,997,719,3899,3424,1111,3810,114,1064,4136,879,887,18,258,3398,22,1900,1067,4244,3301,262,2887,4573,1609,221,2433,4560,1697,766,1775,1240,1865,1939,3149,2139,4409,4970,1655,3009,3956,1178,4677,2229,2268,1676,183,2904,4195,1485,3764,1580,3621,4585,2429,4170,4513,4142,1793,468,4744,3077,4891,1814,1178,4445,1724,2085,3125,807,1097,939],"ngrams":["dar$","inda","eko$","rtek","arte","ain$","zke$","ezke","itez","aite","tezk","dait","^dai","tzi$","utzi","tera","ater","lde$","alde","era$","haue","^hau","^kez","irel","^dir","gak$","^ind","ugak","muga","iare","auek","logi","olog","knol","ungo","gung","zka$","gaur","uko$","zan$","^iza","zina","uek$","^gau","erae","dera","^tek","^ald","nolo","ider","ogia","ina$","^hor","goz$","ngo$","hone","aing","rain","ela$","^egu","orai","tuko","^ora","eras","^eta","ahiz","nahi","rtuk","bide","teko","giar","purt","ngoz","apur","^art","urtu","^apu","aes$","tek$","dire","itue","ekno","aren","ehar","tekn","ndar","agik","izan","^dit","^utz","^bak","erag","bate","eta$","har$","^beh","tuen","luke","ren$","rik$","^bid","rrik","^luk","arri","atek","karr","ragi","keta","gike","uen$","hort","rela","taz$","^den","ditu","den$","rtaz","^hon","bat$","^bat","nen$","hiz$","^kon","orta","ezka","beha","tra$","onen","aur$","ntra","kezk","^era","egun","aezi","kont","aso$","raez","akar","ezin","baka","iket","^mug","ingo","^aes","uke$","ontr","^nah","raso"],"ngram_size":4,"dimension":5000},{"language":"eu","weights":[0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.014218,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.014218,0.014218,0.00473934,0.014218,0.014218,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.014218,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.014218,0.00473934,0.00473934,0.00473934,0.014218,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.0189573,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.028436,0.00473934,0.00473934,0.014218,0.00947867,0.00473934,0.00947867,0.0189573,0.00947867,0.014218,0.00473934,0.00473934,0.00473934,0.014218,0.00473934,0.00473934,0.00473934,0.0189573,0.00473934,0.00947867,0.00947867,0.00473934,0.014218,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934],"ids":[600,926,1711,1971,665,4017,531,1390,446,4948,4012,4024,1971,317,3727,4194,3695,4353,4994,2030,1960,984,1618,3861,2078,2918,2354,4809,3570,3042,2436,16,3328,4102,1756,3613,3048,1671,2672,3629,1540,4391,4621,1651,4271,1999,3433,3239,4673,2608,2562,2903,731,271,3267,702,1687,4090,2892,1597,4590,0,3289,2667,3724,2976,4852,501,2911,1280,840,2785,136,3701,405,2581,933,1727,3958,4707,1732,4887,1582,4381,3324,4103,2778,2034,1358,3407,3507,888,4696,4698,4964,2222,1494,1448,4527,4483,3346,1734,1283,1302,4049,503,4770,2877,2732,1475,4787,4562,1057,4338,4016,3082,277,377,4378,4157,1376,356,60,3018,1729,1174,539,2523,2132,3454,4987,4983,3915,2629,1915,4092,4972,1536,3123,3515,2242,891,201,4258,4511,1876,1207,134,4779,3931,4017,3265,963,3762,2260,493,1552,2854,2660,2428],"ngrams":["eko","rte","nda","art","^ar","zke","ite","ait","dai","tzi","^ut","ter","de$","lde","ald","^al","uek","aue","hau","ka$","ela","zi$","ak$","gak","^mu","ren","are","ogi","nol","ekn","gia","^te","go$","log","ung","gun","kez","egu","^eg","ur$","aur","gau","ire","^ga","aez","iza","^iz","an$","na$","ain","rae","ide","goz","der","kno","ngo","rai","iz$","ora","^or","ort","uke","ahi","dar","^et","^ha","rik","^lu","ko$","zan","urt","bid","olo","aso","^ap","mug","es$","aes","^ae","uen","iar","tue","itu","^di","utz","^bi","luk","la$","beh","aka","rri","apu","ta$","rta","uko","hor","eta","nah","zin","dir","kon","gik","az$","ina","har","en$","zka","bak","^ho","taz","ike","den","^de","rel","kar","ra$","tuk","rag","^ke","eha","tra","ate","ik$","ntr","nen","^da","^ko","pur","hon","ind","tez","era","^na","at$","tek","ing","one","oz$","^er","ek$","bat","ont","dit","in$","ras","^in","arr","rtu","^ba","hiz","ar$","ke$","ket","so$","^be","ezk","ezi","agi","uga","^a$"],"ngram_size":3,"dimension":5000},{"language":"eu","weights":[0.00343643,0.0515464,0.00343643,0.0274914,0.0309278,0.0515464,0.0206186,0.0687285,0.0171821,0.0549828,0.0927835,0.024055,0.123711,0.04811,0.0309278,0.0137457,0.137457,0.0137457,0.04811,0.137457],"ids":[77,66,0,88,59,20,11,24,63,22,79,0,96,21,86,44,68,2,19,52],"ngrams":["p","i","m","g","u","n","b","r","h","o","e","d","a","t","z","s","$","l","k","^"],"ngram_size":1,"dimension":100},{"language":"fa","weights":[0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0208333,0.00694444,0.00694444,0.00694444,0.00694444,0.0208333,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0208333,0.00694444,0.00694444,0.00694444,0.00694444,0.0138889,0.0138889,0.00694444,0.0138889,0.0138889,0.0138889,0.00694444,0.0277778,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0347222,0.0138889,0.00694444,0.00694444,0.0138889,0.0277778,0.00694444,0.00694444,0.00694444,0.0208333,0.0138889,0.00694444,0.0138889,0.0486111,0.0277778,0.0208333,0.00694444,0.00694444,0.00694444,0.00694444,0.0208333,0.00694444,0.00694444,0.00694444,0.00694444,0.0138889,0.00694444,0.0138889,0.00694444,0.0277778,0.00694444,0.0208333,0.0277778,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444],"ids":[949,991,900,199,55,270,487,15,378,340,833,979,346,936,678,693,30,441,366,667,481,200,316,287,425,392,99,317,298,288,505,962,914,418,577,513,561,15,898,818,984,823,712,816,496,135,541,916,298,178,612,167,429,120,449,781,179,415,544,740,405,371,769,853,731,310,113,898,515,437,871,520,391,904,510,117,160,838,702,943,982,686,947,8,539,447,944,778,903,755,787,542],"ngrams":["سي","اق","تا","^ت","نت","^ا","�$","حر","^ح","^ر","ا$","^د","يک","م$","يا","دم","اح","ت$","ان","قط","ود","قب","بت","^ق","ثل","کا","مث","حض","يد","مه","ر�","هم","ط$","^و","يه","^�","يز","کت","^ی","ز$","^ه","با","^ع","ای","آب","^ک","تک","جا","ظا","^ج","بو","به","^م","ن$","ري","رس","ل$","^ب","ضا","ری","ما","ند","کر","^خ","می","ی$","ه$","رد","جل","تظ","ور","بل","ار","من","^آ","چي","عا","^$","خو","ک$","^ي","د$","از","و$","دن","^چ","له","�ق","ب$","ر$","ني","عج"],"ngram_size":2,"dimension":1000},{"language":"fa","weights":[0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889],"ids":[2159,3370,122,652,2335,1779,2604,4505,3879,4506,660,115,2424,3380,4218,2785,1707,2003,382,4474,2623,83,2942,2898,4053,3905,4117,859,2766,4399,1141,18,1384,876,3374,499,2277,2437,4882,803,946,1823,3969,2055,230,3933,4645,2967,1329,3160,2475,3392,2967,624,2654,1218,772,3969,2309,3902,4241,4175,2237,1381,1048,3141,4161],"ngrams":["^با$","^ای$","حضار","^احض","سيد$","قبت$","اقبت","^عاق","^تا$","ظار$","تظار","انتظ","نيا$","^دني","احضا","^انت","^يک$","ندم$","^مان","اندم","ماند","^رسي","�قط$","همه$","^من$","^�قط","جای$","بود$","کتک$","قبل$","اريه","^قبل","مثل$","نتظا","دنيا","^چيز","اری$","ردند","باز$","^جای","^کار","دند$","^به$","^همه","عاقب","^بود","کردن","عجله","^مثل","^حر�","^می$","جله$","^عجل","حر�$","ردن$","^خور","ريه$","^کتک","وردن","^باز","^کرد","ضاري","^آب$","خورد","رسيد","کاری","چيز$"],"ngram_size":4,"dimension":5000},{"language":"fa","weights":[0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.0186916,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.0280374,0.00934579,0.00934579,0.0186916,0.00934579,0.0186916,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.0186916,0.00934579,0.00934579,0.00934579,0.00934579,0.0186916,0.0186916,0.0186916,0.00934579,0.00934579,0.00934579,0.0280374,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.0186916,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.00934579,0.0186916,0.00934579],"ids":[4611,4518,4651,675,2833,2535,28,4957,4506,2951,876,1347,3254,4804,2961,4716,1514,3737,1762,694,2525,2621,4094,1669,2212,1514,1476,4590,180,2784,3741,1550,4342,3660,3656,4078,1561,3561,900,1905,521,4454,3590,1613,4336,4320,1178,348,4469,1248,4681,4000,719,1309,1850,438,2097,3976,3277,4457,4429,4743,2638,2541,1336,3731,4456,2736,1151,3030,2562,2122,314,4595,1045,3268,500,1160,170,1398,4789,3224,2544,3224,1820,3692,2474,830,1959,1368,2488,2597,4259,1378],"ngrams":["با$","^ای","يه$","اري","ضار","^اح","يد$","سيد","^رس","بت$","اقب","^عا","ظار","تظا","نتظ","انت","^ان","حضا","حر�","يا$","دني","^دن","يک$","احض","ندم","اند","ار$","^ما","رسي","^من","�قط","تا$","^�ق","ود$","بود","له$","^قب","^عج","^چي","مثل","ند$","^مث","يز$","^هم","ری$","اری","کار","من$","بل$","^و$","^کا","عاق","می$","تک$","^ی$","ر�$","از$","ريه","جای","قط$","^جا","خور","^کت","به$","ثل$","مان","مه$","^به","دند","^بو","همه","دم$","باز","کرد","^می","^کر","جله","^آب","^تا","ردن","آب$","عجل","^حر","^يک","کتک","ای$","قبت","دن$","قبل","ورد","^خو","نيا","^با","چيز"],"ngram_size":3,"dimension":5000},{"language":"fa","weights":[0.00552486,0.00552486,0.0110497,0.00552486,0.0110497,0.20442,0.0165746,0.0220994,0.0110497,0.0718232,0.0110497,0.038674,0.0165746,0.0110497,0.0276243,0.0441989,0.00552486,0.00552486,0.038674,0.00552486,0.0276243,0.0497238,0.038674,0.0276243,0.00552486,0.00552486,0.038674,0.0331492,0.20442],"ids":[47,12,29,52,92,68,14,2,97,40,55,84,87,29,73,6,0,78,14,89,14,70,56,49,9,43,89,1,52],"ngrams":["ض","ظ","ح","ط","�","$","ق","ت","ز","ا","ع","م","ل","ج","ي","ر","آ","س","ن","چ","و","د","ی","ه","ث","خ","ب","ک","^"],"ngram_size":1,"dimension":100},{"language":"fi","weights":[0.00416667,0.00416667,0.00416667,0.00833333,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00833333,0.00833333,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.0125,0.00416667,0.0125,0.00833333,0.00833333,0.00416667,0.00833333,0.00833333,0.00416667,0.00833333,0.00833333,0.0166667,0.00833333,0.00416667,0.0166667,0.00833333,0.00416667,0.00833333,0.00416667,0.00416667,0.0166667,0.00416667,0.00416667,0.00416667,0.00833333,0.00833333,0.00833333,0.0166667,0.00833333,0.00416667,0.00416667,0.0125,0.00416667,0.025,0.0166667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.0125,0.00833333,0.0125,0.00833333,0.00416667,0.00833333,0.00833333,0.00833333,0.0166667,0.0125,0.0291667,0.0125,0.00833333,0.00416667,0.00416667,0.00416667,0.00833333,0.00416667,0.0208333,0.00833333,0.0125,0.00833333,0.00416667,0.00416667,0.00416667,0.0166667,0.00833333,0.025,0.00416667,0.00416667,0.00833333,0.00833333,0.00416667,0.00416667,0.0333333,0.00416667,0.00416667,0.00416667,0.0166667,0.00416667,0.00833333,0.00833333,0.00416667,0.00833333,0.00833333,0.00833333,0.0416667,0.00416667,0.00416667,0.00416667,0.00416667,0.00416667,0.0125,0.00833333,0.00416667,0.00416667,0.0125,0.00416667,0.00833333,0.00416667],"ids":[7,108,8,822,108,98,535,689,795,780,227,134,518,635,679,27,917,265,116,67,960,212,993,493,898,829,564,489,385,989,843,561,879,183,937,71,248,364,128,637,28,895,75,146,96,786,254,887,108,534,553,935,793,933,128,269,215,68,275,770,568,157,738,875,43,334,19,651,575,269,848,153,862,147,606,734,173,364,409,356,591,175,287,955,353,742,355,590,207,927,84,980,193,678,531,591,429,251,422,61,885,854,128,613,463,925,333,378,191,532,458,989,517,984,545,200,154,397,838,224,349,629,8,976,10],"ngrams":["sa","ps","sn","aa","kk","ik","^l","ht","ai","va","iv","p$","uu","uj","au","si","rr","pi","ar","nt","pa","^p","äm","in","ts","sk","ki","es","de","gl","vo","ää","ra","he","og","^v","n$","vi","po","ut","kt","am","op","or","ni","is","av","oj","ak","oo","go","ap","to","ti","öt","an","ta","^j","tt","yt","nn","na","so","un","än","kä","ol","e$","^e","^ä","i$","en","^d","ka","tä","et","ei","uk","rh","me","ro","il","it","te","er","ä$","^m","mä","ej","mu","äy","^t","le","yn","ee","ke","ia","ny","ks","^k","^u","^n","jo","t$","ih","^g","ll","la","ku","o$","tu","a$","mi","rt","ir","st","tö","oi","^$","nä","se","ja","^a","^o","ie"],"ngram_size":2,"dimension":1000},{"language":"fi","weights":[0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.0111111,0.0111111,0.00555556,0.00555556,0.0111111,0.00555556,0.0111111,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.0166667,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.00555556,0.0111111,0.00555556,0.00555556,0.00555556,0.0111111],"ids":[4928,1713,1935,403,3381,1953,3784,288,626,108,3434,3089,784,486,653,1761,3313,1538,902,951,2858,3161,2216,281,1059,3981,4012,3532,2239,2606,7,2952,4917,3095,4001,1422,1725,4221,4746,3014,3102,4239,3535,4960,1832,1614,4868,3517,709,3636,4767,1919,1751,161,179,2417,3845,126,4097,3684,4651,3933,1878,152,3755,2127,4416,2008,3593,2163,2779,1031,4198,1824,4076,1368,3196,1696,316,1462,781,4358,2109,3393,3906,4231,1220,2005,1382,468,3021,1116,4729,4492,739,387,3635,1237,1447,50,67,4318,1397,404,4972,3801,369,856,2582,3626,1685,3384,1771,2667,3043,4483,1341,4720,4343,4638,901,1503,203,2766,244,4968,2080,2526,3442,2920,3475,2757,2606,235,3261,1294,3847,560,2248,3895,4269,258,1192,2173,3586,2333,2552,2252,2147,3839,237,20,3652,4015,3784,269,453,4823,2746,3242,4849,4225],"ngrams":["ttaa","autt","isna","oisn","akso","kaks","^kak","oit$","^voi","eikk","naps","leik","hto$","kiva","taa$","^kes","sia$","isia","utis","uuti","^uut","ttuj","ettu","ivai","aute","kaut","ukau","muka","^muk","tää$","ttää","yttä","ksoi","tisi","^ets","tuja","een$","ikka","isee","mise","ntam","^näy","rant","skiv","oogl","para","topi","erro","ktop","eskt","^lei","ttöt","desk","uka$","gle$","^kuk","goog","äyte","teja","ttej","aran","psau","utet","ortt","rapo","hera","anta","rher","irhe","amis","ten$","^kut","toja","via$","pin$","apsa","sois","joil","etoj","tiet","ämä$","yttö","port","äytt","meil","ytet","virh","vaih","käyt","utta","etää","kesk","uja$","nnis","voit","rro$","^ei$","kkaa","eski","etta","ötie","let$","ynyt","iste","näyt","^des","ieto","saut","nist","oill","kerr","seen","eill","äyny","unni","^vir","ttav","tunn","^tun","snap","avia","^ker","töti","ille","eja$","oja$","stet","^joi","tavi","tämä","skto","tami","ään$","etsi","^täm","lle$","erap","olet","illa","kaa$","aiht","^par","apor","tsi$","^käy","kuka","^goo","uten","käyn","nyt$","ogle","kute","ihto","tetä","^mei","top$","tään","^ole","rtte","lla$","opin","tett"],"ngram_size":4,"dimension":5000},{"language":"fi","weights":[0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.0143541,0.00956938,0.00478469,0.00956938,0.00478469,0.00478469,0.00956938,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.00956938,0.00478469,0.00956938,0.00478469,0.00478469,0.0143541,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00956938,0.0143541,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00956938,0.00478469,0.0143541,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00956938,0.00956938,0.0143541,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.0143541,0.00478469,0.00478469,0.0143541,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469],"ids":[2366,2614,4859,146,4290,2965,3216,1849,3147,136,3356,1782,4433,1353,1720,2250,2055,196,2533,1486,3319,4224,1050,1631,408,2564,4370,2322,3045,2367,694,2110,2458,4573,1645,3833,4287,4520,2413,3724,2176,1594,2364,4814,4258,4826,85,4497,1986,2982,1057,1097,1471,159,3430,4616,4682,4189,1818,2672,3925,1660,2268,392,2747,1640,3479,3625,1856,4590,4915,772,1154,4983,3719,1388,794,93,2111,503,3590,2941,4640,3325,3594,2665,862,2246,3843,1745,221,2078,4965,1168,4715,3848,677,4899,681,2541,4763,4961,1955,1026,2034,230,2030,748,1255,275,658,587,2132,4896,4697,1313,722,1833,415,2704,2739,2667,1684,1264,2828,2910,1745,592,3394,4378,723,3343,557,2428,1889,1709,2130,2213,3021,4003,4005,176,1871,4439,1608,3121,1903,1010,2722,2840,2716,2998,1422,1881,3484,1953,765,4995,3224,2438,3142,543,1133,4441,4663,1062,4530,3673],"ngrams":["utt","sau","psa","aps","nap","ois","soi","^ka","kka","kso","it$","ikk","eik","to$","hto","aih","kiv","kak","kes","uti","ski","uut","^uu","uja","^vo","tuj","isn","ttu","aut","kau","ää$","isi","näy","^nä","tsi","iht","tis","ets","^le","^et","nta","ran","par","^pa","in$","por","top","le$","skt","lla","^de","voi","lle","gle","des","iva","äyn","än$","goo","^go","muk","tää","ttä","ttö","esk","mä$","yte","tte","taa","ort","apo","ise","her","era","ten","rhe","vir","pin","avi","en$","ute","ja$","oja","toj","iet","lei","ami","öti","sia","et$","ytt","^mu","äyt","aks","vai","ia$","via","tav","tta","ett","tet","eto","etä","^jo","la$","nis","ka$","ro$","nni","si$","let","ker","oil","unn","ist","tej","opi","irh","uka","rtt","mis","kuk","ole","mei","^ku","^ä$","^me","see","rro","^ke","err","^ol","^tä","^a$","ste","kto","tie","^ei","ämä","een","nyt","op$","ään","aa$","^vi","^tu","rap","ogl","yny","käy","oit","töt","^kä","oog","joi","tam","eja","ant","täm","kut","yt$","kaa","ei$","ill","tun","sna","ara","eil"],"ngram_size":3,"dimension":5000},{"language":"fi","weights":[0.0184502,0.0147601,0.00369004,0.0369004,0.0221402,0.0332103,0.0369004,0.0147601,0.0147601,0.0184502,0.0405904,0.114391,0.0332103,0.0590406,0.00738007,0.0811808,0.00738007,0.0553506,0.0147601,0.0627306,0.0811808,0.114391,0.114391],"ids":[77,57,28,44,24,59,20,88,0,65,97,52,2,19,0,79,63,22,5,66,96,21,68],"ngrams":["p","v","ö","s","r","u","n","g","m","y","ä","^","l","k","d","e","h","o","j","i","a","t","$"],"ngram_size":1,"dimension":100},{"language":"fil","weights":[0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.0172414,0.00862069,0.00862069,0.00862069,0.0172414,0.00862069,0.00862069,0.00862069,0.0517241,0.0172414,0.00862069,0.0172414,0.00862069,0.0258621,0.00862069,0.0172414,0.0258621,0.00862069,0.00862069,0.00862069,0.0258621,0.00862069,0.00862069,0.0172414,0.0258621,0.00862069,0.0172414,0.00862069,0.0172414,0.0172414,0.00862069,0.0344828,0.00862069,0.00862069,0.00862069,0.0172414,0.00862069,0.0258621,0.0172414,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.0517241,0.0172414,0.0258621,0.0344828,0.00862069,0.00862069,0.0258621,0.0172414,0.00862069,0.0258621,0.0258621,0.0172414,0.00862069,0.0172414],"ids":[651,803,862,526,501,486,233,688,623,147,61,656,662,248,933,984,545,605,200,517,960,265,907,819,786,391,157,458,422,854,760,738,879,645,19,605,925,998,493,732,532,829,795,98,18,58,269,355,752,757,980,41,265,770,955,212,989,532,553,793,7,875,8,287,116,895,838],"ngrams":["e$","di","^d","on","ba","^b","mg","wa","aw","ka","^k","bo","ub","n$","ti","rt","ir","ng","st","mi","pa","pi","ag","li","is","ga","na","tu","ks","^n","ok","so","ra","^i","gs","y$","^g","ay","in","su","o$","sk","ai","ik","as","uh","an","^m","ha","ek","^t","ma","kl","g$","te","^p","a$","^s","go","to","sa","k$","^a","it","ar","am","^$"],"ngram_size":2,"dimension":1000},{"language":"fil","weights":[0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.027027,0.0135135,0.027027,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.027027,0.0135135,0.027027,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.027027,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135],"ids":[3755,3557,4950,852,537,2371,4199,1770,873,4803,2601,2847,3351,3663,3942,2702,3267,1474,2551,617,1614,2948,258,4208,2026,756,4249,1890,4287,4811,2649,2753,2506,3322,1148,1891,4563,4568,458,939,3248,85,3963,4947,174,1687,4529,105,4416,4504,3495,4331,4951,1647,1121,533,4253,3503,1101,2823,4109,770,3357,2952,354,1792,1428,4443,468],"ngrams":["rte$","arte","kart","gong","bago","mga$","^mga","han$","uhan","tuha","wast","awas","ong$","kawa","pags","^dis","^pag","miti","^sa$","^isa","para","ubok","^par","disk","astu","subo","^na$","tin$","amit","skar","agsu","gami","^gag","teks","^ang","gaga","gsub","^tek","ang$","raso","^ay$","iras","bok$","itin","agam","^pir","ito$","ling","^ng$","ing$","agon","klin","isan","aikl","^kaw","ksto","^mai","sang","stuh","^ito","iska","ekst","maik","ara$","pira","ikli","sto$","^bag","aso$"],"ngram_size":4,"dimension":5000},{"language":"fil","weights":[0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0638298,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0319149,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0212766,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766],"ids":[4016,4973,1544,2049,2911,4207,129,3439,926,1971,1467,4852,1760,405,67,1849,1267,4711,2310,1936,4814,1162,382,1843,4530,2364,4258,2110,4104,1095,1680,1651,3239,652,4673,3082,524,3915,3549,384,147,1915,16,3639,4092,3762,3701,4552,592,2378,1637,4381,3378,862,550,2875,1080,2485,3931,3120,361,2644,4099,1353,2372,4779,2558,4272,2713,4923,3406,4511,964,2839,133,3046,4627,3483,4743,1672],"ngrams":["kar","isk","ong","gon","ago","ga$","han","uha","rte","art","tuh","stu","awa","kaw","te$","^ka","ok$","sub","ags","^ma","^pa","^sa","gsu","mit","ara","par","in$","gam","^mg","aga","ang","^ga","an$","was","na$","ra$","dis","^na","iti","eks","pir","tek","^te","ubo","ing","so$","aso","kst","san","bag","ira","^di","kli","ami","ng$","lin","^ng","ikl","^an","^pi","sto","sa$","gag","to$","^is","^ba","mga","isa","pag","ast","^ay","ras","ay$","bok","ito","aik","mai","ska","tin","^it"],"ngram_size":3,"dimension":5000},{"language":"fil","weights":[0.00724638,0.00724638,0.0144928,0.0217391,0.0217391,0.0144928,0.0144928,0.0652174,0.0217391,0.0797101,0.0144928,0.00724638,0.0434783,0.0507246,0.15942,0.0507246,0.137681,0.0652174,0.00724638,0.0362319,0.15942],"ids":[32,0,79,24,77,11,59,20,0,88,65,63,22,44,68,21,96,66,2,19,52],"ngrams":["w","d","e","r","p","b","u","n","m","g","y","h","o","s","$","t","a","i","l","k","^"],"ngram_size":1,"dimension":100},{"language":"fr","weights":[0.00505051,0.00505051,0.050505,0.00505051,0.00505051,0.00505051,0.00505051,0.00505051,0.00505051,0.00505051,0.0151515,0.020202,0.010101,0.00505051,0.00505051,0.00505051,0.00505051,0.0151515,0.00505051,0.00505051,0.010101,0.00505051,0.010101,0.00505051,0.00505051,0.0151515,0.00505051,0.0151515,0.00505051,0.010101,0.00505051,0.0151515,0.010101,0.010101,0.00505051,0.00505051,0.0151515,0.0252525,0.00505051,0.00505051,0.00505051,0.010101,0.010101,0.00505051,0.00505051,0.00505051,0.00505051,0.00505051,0.00505051,0.00505051,0.010101,0.00505051,0.010101,0.00505051,0.010101,0.00505051,0.00505051,0.010101,0.010101,0.00505051,0.030303,0.00505051,0.0151515,0.0252525,0.0252525,0.00505051,0.00505051,0.00505051,0.0151515,0.050505,0.020202,0.00505051,0.00505051,0.00505051,0.00505051,0.00505051,0.0252525,0.00505051,0.0151515,0.00505051,0.0252525,0.00505051,0.00505051,0.010101,0.00505051,0.00505051,0.00505051,0.020202,0.00505051,0.010101,0.020202,0.020202,0.0151515,0.00505051,0.00505051,0.030303,0.010101,0.010101],"ids":[18,854,510,786,984,93,793,980,307,248,19,575,651,879,34,146,200,193,926,369,517,10,458,803,893,327,660,333,83,385,421,955,175,645,355,972,734,915,536,397,113,489,630,535,891,365,567,732,275,296,848,891,134,677,90,215,960,67,862,402,613,128,637,384,933,379,671,727,353,526,360,514,427,194,976,879,720,164,404,591,476,176,275,838,237,989,985,805,532,518,679,26,212,854,349,8,842,314],"ngrams":["as","^n","s$","is","rt","ou","to","^t","nc","n$","ol","^e","e$","ra","gu","or","cè","le","xp","ex","eu","ie","fi","di","mo","r$","lt","ll","ul","de","ur","te","il","^i","^m","if","et","io","és","oi","bu","es","at","^l","^é","tr","é$","su","té","nf","i$","^q","ui","ef","^f","ta","pa","nt","^d","od","t$","po","ut","ns","ti","ig","fr","qu","er","on","x$","ès","cc","ét","^o","ib","co","ué","ec","ro","^c","lu","tt","^$","ne","a$","ri","ux","^s","pe","au","ct","^p","ac","se","^a","fo","l$"],"ngram_size":2,"dimension":1000},{"language":"fr","weights":[0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.0151515,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.0227273,0.00757576,0.0151515,0.00757576,0.00757576,0.0378788,0.0151515,0.0151515,0.00757576,0.00757576,0.00757576,0.00757576,0.0151515,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.030303,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.0227273,0.00757576,0.0151515,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.00757576,0.0227273,0.00757576,0.0227273,0.0227273,0.00757576,0.00757576,0.00757576,0.0227273,0.00757576,0.00757576,0.0227273,0.0227273,0.030303,0.00757576,0.030303,0.00757576,0.00757576,0.030303,0.00757576,0.00757576,0.00757576],"ids":[4415,1348,250,2602,2423,883,1739,3878,1491,2519,4312,1836,2109,3807,3890,2207,2319,595,1018,2819,3451,4292,764,2530,299,2473,3327,3830,835,2722,1023,4325,640,4161,2202,184,4604,3989,19,861,1851,2485,525,564,1004,4833,3154,4221,1977,360,1911,429,2701,1883,1767,4882,126,2650,4521,3129,411,2769,929,3356,1699,4437,2545,4564,2456,1701,3441,3764,2262,2623,3801,3461,2650,2353,4279,582,3761,4841,1075,2518,161,1382,2925,3457,2030,3175,4822,4695,3391,3093],"ngrams":["^pas","^ne$","ois$","tefo","utef","oute","^de$","rati","onfi","conf","des$","orte","port","igur","xpor","fois","^exp","ses$","gura","ier$","fier","ifie","difi","pas$","modi","^mod","ter$","odif","lter","ulte","efoi","sult","lect","cons","peut","tout","accè","tion","^peu","^il$","expo","ués$","bués","ribu","^con","trib","nfig","attr","ibué","ntau","ctio","^att","figu","été$","ont$","^ont","lui$","^lui","ttri","^qui","^aux","onta","eut$","^acc","fron","nsul","^été","^fon","atio","^ses","^fro","taux","rter","coll","^des","ecti","llec","onsu","urat","qui$","^col","fonc","^tou","^et$","olle","ons$","ion$","aux$","onct","ccès","ions","ront","ncti","cès$"],"ngram_size":4,"dimension":5000},{"language":"fr","weights":[0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0304878,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0243902,0.00609756,0.00609756,0.00609756,0.00609756,0.0182927,0.0182927,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0304878,0.0121951,0.0243902,0.0121951,0.00609756,0.0121951,0.00609756,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.0121951,0.00609756,0.0243902,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0182927,0.0182927,0.00609756,0.00609756,0.00609756,0.0182927,0.00609756,0.00609756,0.00609756,0.00609756,0.0243902,0.00609756,0.0182927,0.00609756,0.00609756,0.0182927,0.00609756,0.00609756,0.00609756,0.0304878,0.0121951,0.00609756,0.0182927,0.00609756,0.0182927,0.00609756,0.0121951,0.0304878,0.00609756,0.0121951,0.00609756],"ids":[1346,2687,2898,3104,4814,4094,611,1116,873,1507,1569,1192,1057,4710,926,4590,4619,62,1305,1656,674,3606,2814,1371,3590,1670,367,3500,319,1971,4317,4024,107,3672,3465,4826,681,2651,2729,1147,3892,3894,1575,1322,3116,94,4895,4800,1486,3430,2630,1230,1001,351,2477,2094,980,2603,3631,1986,3205,2503,1881,3170,870,1805,1764,1117,3685,4261,1243,1848,2267,2222,2282,3724,1471,501,2489,2428,4420,2896,4662,2176,2254,853,834,1745,2041,2965,3592,4923,3297,665,3278,933,1673,2741,4478,2985,4889,891,3439,2795,4702,3838],"ngrams":["nct","onc","fon","as$","^pa","ne$","is$","efo","^to","ura","ons","fig","^de","nfi","rte","ort","ses","exp","ati","^ex","sul","^se","aux","ier","ute","fie","^mo","lec","er$","de$","igu","ter","ult","tou","^ne","por","lte","nsu","ion","con","cti","ut$","^fo","eut","onf","nt$","peu","gur","^pe","des","ifi","ibu","dif","il$","té$","tef","^il","pas","ns$","és$","ués","out","^on","^fr","tau","tri","att","été","rib","qui","^ét","^at","on$","ccè","lui","^et","lle","^lu","xpo","^a$","^au","acc","^qu","nta","rat","ux$","ron","et$","fro","ois","oll","bué","mod","^ac","^co","es$","odi","ect","foi","col","ès$","ont","tio","ttr","ui$","cès"],"ngram_size":3,"dimension":5000},{"language":"fr","weights":[0.00431034,0.00431034,0.0172414,0.00431034,0.0301724,0.0603448,0.0818966,0.146552,0.0431034,0.0732759,0.0215517,0.012931,0.0387931,0.00431034,0.012931,0.0732759,0.00431034,0.0474138,0.0517241,0.0474138,0.0215517,0.0517241,0.146552],"ids":[88,0,77,12,24,66,21,52,2,22,86,58,96,33,0,79,11,20,59,58,22,44,68],"ngrams":["g","m","p","q","r","i","t","^","l","o","x","é","a","è","d","e","b","n","u","c","f","s","$"],"ngram_size":1,"dimension":100},{"language":"ga","weights":[0.00406504,0.00406504,0.00813008,0.00406504,0.00406504,0.00406504,0.00406504,0.00406504,0.00406504,0.00813008,0.00406504,0.00406504,0.00406504,0.00813008,0.0162602,0.00406504,0.00813008,0.0121951,0.0121951,0.00406504,0.00406504,0.0243902,0.0203252,0.00813008,0.00813008,0.00813008,0.0203252,0.0162602,0.00813008,0.0203252,0.00406504,0.00406504,0.0203252,0.00406504,0.0203252,0.00813008,0.00406504,0.00813008,0.0162602,0.00406504,0.00406504,0.00406504,0.00406504,0.0162602,0.00406504,0.00813008,0.0121951,0.00406504,0.00813008,0.00813008,0.0162602,0.00406504,0.00813008,0.0203252,0.0121951,0.00406504,0.00406504,0.0365854,0.0406504,0.00406504,0.0203252,0.00406504,0.0162602,0.00406504,0.0162602,0.00406504,0.0121951,0.0447154,0.00406504,0.00406504,0.00813008,0.0162602,0.00406504,0.0121951,0.0121951,0.00813008,0.00406504,0.0162602,0.00406504,0.0243902,0.00813008,0.0406504,0.0162602,0.0121951,0.0162602,0.00406504,0.00406504,0.00406504,0.00406504,0.00813008,0.00813008,0.00813008,0.00813008,0.00406504,0.00406504,0.00406504,0.00406504,0.00813008,0.00406504,0.00813008],"ids":[18,793,955,287,980,694,802,761,355,645,762,587,748,666,820,507,575,248,920,568,963,116,786,510,265,834,804,854,269,314,236,181,854,46,651,557,493,958,486,272,396,848,789,347,23,146,193,605,89,545,984,421,200,173,183,120,356,476,989,421,327,385,307,875,157,976,349,8,123,114,134,535,512,768,532,672,553,795,670,90,203,657,842,0,175,842,450,402,613,862,752,242,838,689,368,921,880,925,460,645],"ngrams":["as","to","te","it","^t","of","eo","má","^m","^i","gú","hú","ó$","ú$","ea","ío","rd","n$","ua","nn","ci","ar","is","s$","re","br","h$","ac","an","l$","lé","gá","^n","al","e$","cu","in","í$","^b","ún","fá","i$","ái","th","u$","or","le","ng","á$","ir","rt","ur","st","ei","he","im","me","^c","a$","tú","r$","de","hu","un","na","^o","se","^a","dh","do","ui","^l","ic","ca","o$","da","go","ai","ms","^f","aí","ch","fo","oc","il","fa","éi","od","t$","^d","ha","fu","^$","ht","hf","ní","cm","^g","nó","bh"],"ngram_size":2,"dimension":1000},{"language":"ga","weights":[0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0202703,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.0135135,0.0135135,0.00675676,0.0135135,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.0135135,0.0135135,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.0202703,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.0135135,0.0202703,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0202703,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.0202703,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676],"ids":[730,2586,1275,73,696,1739,2039,1243,2170,359,4858,1016,1834,4877,3088,4300,4528,4894,2326,2368,1502,404,3608,52,1913,1173,791,4953,1762,872,3496,1320,2755,93,4391,2057,2005,960,4195,3802,591,933,1359,4931,3712,3808,4456,4493,4796,1501,1338,2323,4899,2923,2373,1070,793,3794,4658,3234,4830,1335,4767,558,4762,1284,2146,721,802,3410,719,4720,42,1081,2201,3983,3910,1184,2862,3825,2620,3946,1683,4249,2269,342,79,1764,4398,3754,254,2138,2344,1191,893,1231,3001,848,4864,2307,3572,3564,968,2228,4940,3329,4,1367,2182,2969,3218,4977,4308,3180,1851,1805,4064,355,660,1700,3389],"ngrams":["has$","arth","uart","fuar","^fua","^de$","ith$","cme$","icme","aicm","^aic","^fo$","thas","far$","haí$","eofa","seof","mseo","^aim","teac","stea","iste","ocal","^le$","tear","chui","rtha","fáil","^má$","thaí","leit","ngú$","úngú","húng","chtú","^che","irte","acht","ofar","heac","íodh","bhea","each","^bhe","^an$","cal$","ocai","rtea","ana$","eith","hean","^fái","daío","rdaí","^ar$","^foc","htú$","dach","arda","aims","^nó$","uard","^lei","odh$","cuar","^cua","cinn","ear$","chea","^go$","chei","leis","cail","chur","hur$","^bre","eise","chún","brei","chun","eis$","thu$","^ach","^na$","^tor","inn$","^gá$","rthu","^ort","huir","orth","reis","^chu","^bhf","heis","ise$","hfui","uirt","^léi","ist$","^do$","éir$","^ist","léir","eana","ach$","bhfu","hun$","^cin","imse","^chú","áil$","ail$","aíod","foca","^ní$","eist","tort","rdac","uil$","fuil"],"ngram_size":4,"dimension":5000},{"language":"ga","weights":[0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.0153061,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.0102041,0.00510204,0.0102041,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.0102041,0.0102041,0.00510204,0.0102041,0.00510204,0.0102041,0.0153061,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.0102041,0.00510204,0.0153061,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0153061,0.00510204,0.00510204,0.0102041,0.0204082,0.0153061,0.0153061,0.00510204,0.0102041,0.0102041,0.00510204,0.0153061,0.00510204,0.0306122,0.0204082,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0204082,0.0153061,0.00510204,0.00510204,0.00510204,0.00510204,0.0204082,0.0153061,0.0204082,0.00510204,0.0306122,0.00510204,0.00510204],"ids":[3104,2038,1971,2791,2148,849,792,1971,1057,4383,665,623,3195,1307,4399,1746,3992,3323,2372,2483,3123,4017,1216,926,4811,2653,1684,1577,1720,3160,2461,164,3901,2805,3939,428,4201,603,1051,622,3021,3268,3931,3068,686,873,4784,222,2789,2186,1546,360,809,4125,611,1111,3629,172,4590,3922,4259,1426,772,48,383,4391,1077,2540,1597,1126,2861,2617,2112,1133,1152,2665,1710,3566,3938,136,1259,3909,1294,3792,462,3585,860,2989,2262,2413,255,3731,4697,3120,1047,2465,217,1443,4089,4497,2115,3666,1136,4364,4394,1193,2626,4835,2558,1869,4802,2672,1119,424,1122,4848,3698,3328,2766,351,1077,4358,3239,665,4727,4673,3915,1575,1889,2428,2854,4083],"ngrams":["as$","has","art","^fu","aí$","tha","tor","de$","^de","fua","^ar","me$","cme","ofa","eof","seo","mse","^ai","^is","al$","cal","ar$","tea","rte","aic","uir","hui","ngú","fái","^cu","úng","th$","chú","gú$","htú","eac","bhe","má$","dac","nó$","uil","tú$","^an","íod","aío","^to","^nó","rda","ard","ean","^ci","un$","nn$","inn","is$","cua","ur$","fo$","ort","hur","se$","far","ise","ní$","irt","eit","rei","cai","^or","bre","ana","^br","ch$","gá$","hu$","lei","ear","hun","ail","thu","rth","dh$","áil","ims","éir","^fá","hún","odh","hei","^le","fui","léi","ist","eis","uar","oca","^gá","che","hea","le$","chu","bhf","^ch","ach","cin","do$","^do","^bh","^i$","^lé","haí","^go","cht","ith","aim","hfu","icm","go$","ir$","il$","foc","st$","an$","^ac","daí","na$","^na","^fo","ste","^a$","^má","^ní"],"ngram_size":3,"dimension":5000},{"language":"ga","weights":[0.0101351,0.00337838,0.0371622,0.0304054,0.0506757,0.0168919,0.0101351,0.0101351,0.0439189,0.0101351,0.0574324,0.0574324,0.0337838,0.168919,0.0304054,0.0101351,0.0135135,0.027027,0.0236486,0.027027,0.00337838,0.0540541,0.101351,0.168919],"ids":[54,58,20,21,79,0,0,96,24,88,58,63,22,52,2,65,11,59,44,22,11,66,96,68],"ngrams":["í","é","n","t","e","d","m","ú","r","g","c","h","o","^","l","á","b","u","s","f","ó","i","a","$"],"ngram_size":1,"dimension":100},{"language":"gl","weights":[0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.0191388,0.00478469,0.00478469,0.00956938,0.00478469,0.00956938,0.00478469,0.00478469,0.0191388,0.00956938,0.0143541,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.0191388,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.0478469,0.0143541,0.00478469,0.00478469,0.0143541,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.0143541,0.00478469,0.00956938,0.00956938,0.00478469,0.00478469,0.0143541,0.00478469,0.0143541,0.00478469,0.00478469,0.0143541,0.00956938,0.00478469,0.0143541,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.0239234,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.0191388,0.0191388,0.0143541,0.00478469,0.00956938,0.00478469,0.00956938,0.0143541,0.00478469,0.00478469,0.0287081,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.0191388,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.0239234,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00956938,0.0191388,0.00956938,0.00956938,0.00478469,0.0239234,0.0143541,0.00478469,0.00956938],"ids":[915,803,493,877,200,637,545,248,978,955,287,487,893,766,752,356,120,809,985,314,8,486,943,353,339,645,86,489,22,353,255,854,429,879,976,875,157,355,267,532,763,575,144,146,879,656,980,83,486,540,230,128,364,682,285,476,429,963,0,973,114,493,844,71,539,989,89,517,512,91,153,601,950,382,18,960,67,215,269,802,404,419,334,672,793,96,510,645,116,403,157,727,768,862,854,885,46,83,575,651,511,557,19,10,273,327,720,265,532,349,464,385,212,609,838],"ngrams":["io","di","in","ez","st","nh","ir","n$","bi","te","it","om","mo","ab","ha","me","im","nd","ri","l$","^a","ió","ot","^h","ue","^i","cr","es","xe","er","ax","ac","dá","ib","^o","un","na","^m","eh","o$","ad","rd","be","or","ra","bo","^t","ón","^b","os","iz","po","vi","rv","rm","^c","ia","ci","oc","el","do","lo","hí","^v","úd","a$","á$","mi","ic","ve","en","ho","íc","iú","as","pa","nt","ta","an","eo","ec","iñ","^r","da","to","ni","s$","rq","ar","no","mí","qu","ca","^d","^n","^u","al","ul","^e","e$","zo","cu","ol","ie","eb","r$","co","re","^s","se","ña","de","^p","ín","^$"],"ngram_size":2,"dimension":1000},{"language":"gl","weights":[0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0204082,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272],"ids":[1726,3269,4596,4143,2459,1421,2135,1168,4694,4,4081,4068,782,1893,1771,3316,3684,4754,1014,1532,3298,2326,165,679,2401,745,637,1625,1915,2082,2661,124,2047,563,3915,4302,1004,1177,460,2237,3558,4776,4152,4097,2941,2846,11,3445,3302,4479,258,2348,4749,2000,2438,1409,2736,4527,2635,23,4770,483,673,4729,2619,4735,4627,4397,1755,2075,2902,4292,1960,3124,818,1746,2053,2508,1901,3091,4708,1539,1125,2608,660,3469,2208,836,2808,3877,2115,1739,4186,342,1568,1378,4633,421,2446,735,1042,3551,2721,1777,1725,4929,4737,3516,3037,3535,4744,3012,3689,2249,4112,4046,2802,1658,1922,2197,1254,4870,1911,4098,3478,474,718,465,2658,3022,4362,4651,3035,933,1212,3921,1479,4113,4141,3420],"ngrams":["ente","rmen","rior","erio","nter","ante","dica","indi","orme","erez","nte$","nder","ende","^end","^no$","stal","post","^pos","nha$","^unh","ibir","cibi","ión$","cado","ació","itac","abit","icad","habi","^hab","reci","ient","ntal","^ori","hote","hícu","^hot","axes","reo$","creo","ecre","^rec","teri","^mín","bord","recr","culo","osta","^veh","ues$","^par","ques","arqu","xes$","^via","tal$","^miú","nadá","rque","anad","cana","como","ado$","ment","dado","orda","^ven","^bor","otel","ndic","ociñ","coci","nimo","iúdo","olo$","^coc","viax","údo$","enda","^deb","^pol","iorm","iñas","miúd","nda$","ñas$","vend","orie","^can","tara","izos","^de$","vehí","ciña","vizo","das$","zos$","enta","adá$","^ind","ser$","^ten","taci","nto$","polo","anto","^com","debe","iaxe","rant","unha","ínim","^ant","ehíc","bir$","tend","míni","tel$","^tar","rezo","omo$","ícul","ezo$","parq","rviz","dere","ción","ulos","ervi","imo$","^ser","aran","bita","ecib","ndas","rien","los$","rdad","serv","ebe$"],"ngram_size":4,"dimension":5000},{"language":"gl","weights":[0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.0112994,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.0112994,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.0225989,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0169492,0.00564972,0.0169492,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.0112994,0.0112994,0.00564972,0.00564972,0.0169492,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972],"ids":[67,214,4024,2659,1872,1558,2656,3634,271,805,1294,4348,1876,2040,2934,579,4102,2130,2339,2085,2053,1292,1007,3308,16,2544,2976,2483,721,2766,3939,4512,927,1630,1589,3663,3606,4388,1685,1951,1977,4275,4731,3745,3195,982,2667,2682,2700,1936,4249,1057,4016,294,3031,4045,382,508,3819,3571,1011,3146,2553,2364,1758,4814,933,2349,1608,3814,1641,3952,553,573,2259,1046,503,2732,4449,3886,3378,4894,4366,842,1577,424,2405,3887,677,3931,4870,4530,1052,2592,2301,1193,1524,3757,4916,3519,4529,319,2585,3466,2241,14,136,2630,144,3848,2289,16,216,1964,3417,3104,2575,2176,3214,2272,1590,1711,4995,1295,4933,1971,3454,3641,3719,1052,1168,1594,1353,1215,4248,1524,4492,2120,677,16,1825,3870,222,582,1795,3278,1858,859,1597,2861],"ngrams":["te$","rme","ter","ica","dic","ndi","zo$","rez","der","ost","pos","ha$","^in","nha","unh","^un","ere","bir","ibi","eri","cib","eci","ció","tac","ita","abi","^ha","al$","tal","ir$","ent","ien","be$","ori","tar","mo$","^se","tel","cre","ado","ecr","orm","no$","rec","bit","ebe","^re","los","ón$","ciñ","ulo","^de","cul","ícu","híc","que","aci","zos","rqu","ezo","údo","arq","reo","par","hab","^pa","es$","ión","^vi","el$","adá","hot","nde","can","bor","ote","^no","^ho","^ca","veh","dad","^bo","ord","com","xes","axe","viz","erv","rio","^an","ñas","ara","iña","izo","oci","do$","ior","end","os$","^mi","cad","er$","^mí","omo","men","lo$","olo","rie","nad","ven","ues","pol","ehí","^po","^en","as$","imo","nta","das","da$","^ve","nda","ant","iúd","iax","de$","ind","nim","ten","nte","nto","ran","to$","dá$","coc","miú","mín","^ta","via","^te","íni","eo$","rda","sta","ser","^co","deb","rvi","^or","ana"],"ngram_size":3,"dimension":5000},{"language":"gl","weights":[0.00414938,0.0165975,0.0124481,0.00414938,0.0124481,0.0207469,0.0165975,0.0165975,0.00414938,0.00414938,0.0705394,0.0539419,0.0207469,0.00414938,0.0539419,0.00414938,0.0373444,0.0539419,0.0829876,0.0954357,0.0539419,0.0373444,0.00829876,0.13278,0.00829876,0.0373444,0.13278],"ids":[11,63,59,86,77,2,57,11,65,23,96,66,0,96,24,12,21,20,22,79,0,58,54,68,86,44,52],"ngrams":["ó","h","u","x","p","l","v","b","á","ñ","a","i","m","ú","r","q","t","n","o","e","d","c","í","$","z","s","^"],"ngram_size":1,"dimension":100},{"language":"gu","weights":[0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0210526,0.0105263,0.0105263,0.0105263,0.0315789,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0105263,0.0210526,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0315789,0.0105263,0.0421053,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263],"ids":[722,756,247,286,221,763,900,695,643,679,613,361,151,399,583,103,299,900,233,692,229,786,704,284,367,675,295,894,110,31,372,90,640,770,314,39,721,505,605,708,718,544,994,866,369,459,704,283,742,832,974,748,381,78,646,897,262,716,252,622,648,283,838,55,367,277,71,824,203,898,667,408,803,180,318,201,7,361,715,35,769,109,531],"ngrams":["િષ","ની","^વ","નો","ાલ","હા","યા","મૂ","^સ","ધા","બધ","^બ","દે","ો$","ૂહ","વો","ોધ","ાવ","^જ","છ�","ી$","અવ","^છ","�પ","પર","�ટ","ને","ાઠ","સં","વા","હવ","ંદ","�હ","યન","ણ$","રણ","શ$","રમ","^ચ","શો","ળા","ચિ","રિ","સર","ન�","ેશ","ટ$","�ર","ફો","હો","વત","ષય","જ$","ર$","ોન","ે$","^અ","સમ","તર","ણસ","^શ","ાણ","^$","મા","પા","વિ","િન","પ�","^આ","ણા","િણ","ામ","ઠન","^ફ","^પ","આન","ા$","ાય","ના","લન","ાળ","^હ","મ$"],"ngram_size":2,"dimension":1000},{"language":"gu","weights":[0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873],"ids":[1987,3587,2762,4196,3420,4933,3574,960,1999,2736,4579,4868,3851,2197,425,4191,2787,4559,4906,2727,827,3316,1993,1258,1388,3389,3115,3819,3245,2546,3563,3511,4188,4780,766,1485,3749,2464,415,3967,570,2527,354,3547,4352,2233,4865,4390,2862,2070,2555,906,1979,2716,593,4572,4365,1907,2685,2027,43,3763,4397],"ngrams":["યની$","િષયન","^વિષ","દેશ$","ંદેશ","સંદે","^સંદ","લનો$","ાયા$","ોધાય","િન�હ","શોધા","ૂહો$","બધા$","મૂહો","^શોધ","^પરિ","સમૂહ","છ�પા","ાવો$","^છ�પ","ાઠને","^પાઠ","પાવો","ાળા$","વાળા","હાલન","હવાળ","�હવા","ન�હવ","�પાવ","^ફોન","વતરણ","^અવત","ફોન�","^સમૂ","વિષય","રિણા","ચિન�","પાઠન","ણસર$","ાણસર","ધાયા","^બધા","માણસ","ન�ટ$","�રમા","રમાણ","ણામ$","^ચિન","ોન�ટ","^પ�ર","આના$","િણામ","ષયની","^આના","પરિણ","ાલનો","^હાલ","તરણ$","અવતર","ઠને$","પ�રમ"],"ngram_size":4,"dimension":5000},{"language":"gu","weights":[0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205],"ids":[3935,2467,3618,3219,1614,1644,4174,2385,3554,484,3506,4297,3841,3733,875,4441,4382,4000,772,655,3503,814,3887,3758,4567,633,1542,889,2083,1238,3675,4463,1778,2772,4910,4698,2578,769,1742,3689,2959,572,1290,339,1754,1797,3478,162,76,1834,756,224,158,1007,1534,1981,1447,4505,4670,3706,3600,2083,2358,4391,1612,3989,567,1490,2391,4344,2864,2681,1846,4353,2287,511,2437,336],"ngrams":["ની$","યની","ષયન","^વિ","દેશ","ેશ$","^સં","સંદ","હાલ","યા$","ાયા","ધાય","^હા","શોધ","હો$","ૂહો","મૂહ","સમૂ","^સમ","બધા","ચિન","રણ$","પાવ","રમા","છ�પ","^છ�","ઠને","ાઠન","ાળા","હવા","�પા","પ�ર","ન�હ","^પા","િન�","ણસર","તરણ","^ચિ","વતર","અવત","^બધ","ાવો","ને$","^ફો","ંદે","^અવ","ન�ટ","વાળ","નો$","માણ","ાણસ","^શો","વો$","ોધા","�ટ$","ામ$","ફોન","િષય","ધા$","રિણ","પાઠ","ળા$","^જ$","સર$","ોન�","વિષ","િણા","^પ�","લનો","�હવ","ણામ","ાલન","આના","પરિ","�રમ","^પર","ના$","^આન"],"ngram_size":3,"dimension":5000},{"language":"gu","weights":[0.00892857,0.00892857,0.0178571,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.00892857,0.0357143,0.00892857,0.151786,0.0446429,0.00892857,0.0982143,0.0267857,0.00892857,0.00892857,0.0267857,0.00892857,0.0267857,0.0267857,0.0535714,0.0178571,0.00892857,0.0267857,0.0357143,0.151786,0.0267857,0.0178571,0.00892857,0.00892857,0.0178571,0.0357143],"ids":[92,70,18,3,34,22,56,16,9,15,87,41,86,52,9,14,53,20,7,36,9,84,29,5,80,68,18,78,90,68,94,79,5,90,51,14],"ngrams":["ી","જ","શ","ૂ","બ","�","લ","છ","ળ","ઠ","ત","વ","ષ","^","ો","ફ","ા","સ","દ","ં","મ","ચ","ણ","િ","ન","ે","અ","�","ર","$","હ","ય","ટ","આ","ધ","પ"],"ngram_size":1,"dimension":100},{"language":"ha","weights":[0.0192308,0.0192308,0.0192308,0.0192308,0.0192308,0.0192308,0.0192308,0.0192308,0.0192308,0.0192308,0.0384615,0.0384615,0.0192308,0.0192308,0.0576923,0.0384615,0.0192308,0.0769231,0.0576923,0.0192308,0.0192308,0.0192308,0.0192308,0.0576923,0.0192308,0.0192308,0.0384615,0.0576923,0.0769231,0.0192308,0.0769231],"ids":[327,116,754,291,672,842,862,532,826,41,7,532,568,688,269,838,895,989,108,564,98,963,907,61,96,391,493,8,248,476,147],"ngrams":["r$","ar","af","kw","da","fa","^d","o$","ko","ma","sa","^s","nn","wa","an","^$","am","a$","ak","ki","ik","ci","ag","^k","ni","ga","in","^a","n$","^c","ka"],"ngram_size":2,"dimension":1000},{"language":"ha","weights":[0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0666667,0.0333333,0.0333333,0.0666667,0.0333333,0.0666667,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333,0.0333333],"ids":[4806,2007,774,3105,4337,377,1636,2071,378,1357,1472,3515,2282,2983,4966,4010,507,3998,4877,3053,3931,1582,4215,3843,3913,606,3253],"ngrams":["kafa","^kaf","nin$","kwan","anni","daga","akwa","aga$","wann","ako$","amak","^dag","akam","mako","^sak","kin$","ikin","^kan","far$","kan$","saka","nnin","afar","sakw","ciki","kama","^cik"],"ngram_size":4,"dimension":5000},{"language":"ha","weights":[0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.05,0.025,0.025,0.025,0.075,0.025,0.025,0.025,0.05,0.025,0.05,0.05,0.025,0.025,0.05,0.025,0.025,0.025,0.025,0.025,0.075,0.025],"ids":[4017,1426,4874,1255,52,1373,3809,4207,2911,3239,1095,3407,1082,2428,152,2229,2624,1162,1960,4662,2785,1174,1531,4258,3849,1909,1315,332,3663,1849,1546],"ngrams":["ar$","far","kaf","nni","ann","wan","dag","ga$","ko$","an$","aga","aka","ako","^a$","mak","kam","ama","^sa","akw","sak","kan","^da","afa","in$","nin","iki","cik","kwa","kin","^ka","^ci"],"ngram_size":3,"dimension":5000},{"language":"ha","weights":[0.015625,0.015625,0.015625,0.015625,0.09375,0.1875,0.109375,0.015625,0.21875,0.046875,0.015625,0.03125,0.1875,0.015625,0.015625],"ids":[24,32,0,22,20,52,19,58,96,66,22,44,68,88,0],"ngrams":["r","w","d","o","n","^","k","c","a","i","f","s","$","g","m"],"ngram_size":1,"dimension":100},{"language":"hi","weights":[0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0277778,0.0416667,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0416667,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889],"ids":[11,165,197,421,872,456,810,126,605,201,716,282,348,946,876,968,388,605,24,296,161,20,534,416,632,380,280,802,416,151,881,372,920,163,876,998,896,838,1,846,255,707,441,599,548,294,680,110,243,705,672,266,739,831,129,629,877,642,406,977,347,777,110],"ngrams":["ने","अप","पक","से","^स","दद","^म","ी$","इन","�ञ","^इ","भव","^औ","ार","धा","आप","है","र$","पर","अन","^अ","े$","के","ो$","की","नक","ाप","पन","नो","�स","ञा","^आ","^ं","न�","ज�","रि","र�","^$","वि","^व","^ह","मद","व$","�ड","�ड","स$","िज","द$","त$","वर","को","ों","डव","ं$","और","ैं","�भ","आध","^क","^�","^प","ित","ड�"],"ngram_size":2,"dimension":1000},{"language":"hi","weights":[0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095,0.0238095],"ids":[2973,80,3615,4144,4514,95,2403,1535,2290,849,4036,4487,4846,2975,4941,3608,3480,1921,2348,3775,191,116,582,2891,3439,2902,4403,293,294,2535,1915,1939,16,1787,1176,2631,2409,4253,4594,4209,2379,1810],"ngrams":["पने$","अपने","पको$","^आपक","^से$","मदद$","नकी$","^इनक","^और$","रित$","आधार","^आधा","हैं$","ारित","धारि","ञापन","^अन�","नों$","ापनो","�ड�स","^पर$","अन�भ","�भव$","^हैं","ज�ञा","वर�ड","^के$","विज�","ड�स$","^विज","पनों","िज�ञ","र�ड�","^अपन","डवर�","�डवर","आपको","इनकी","न�भव","�ञाप","^मदद","^�डव"],"ngram_size":4,"dimension":5000},{"language":"hi","weights":[0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571,0.0178571],"ids":[3857,3650,91,4916,4889,3958,3588,4748,1303,1318,2996,3120,4062,1566,3343,4179,1892,3120,3692,1617,1908,618,2516,664,1762,231,2368,2101,1543,1987,892,2608,4702,1092,307,2181,2030,770,4993,3637,3992,1429,939,3163,1874,2038,2821,3216,1449,517,2701,1790,1347,750,3580,1609],"ngrams":["^अप","को$","पको","अपन","से$","ने$","न�भ","^से","दद$","�डव","^मद","^आप","की$","नकी","^है","^इन","और$","नों","ारि","^आध","पने","आधा","पर$","�भव","ज�ञ","अन�","के$","^अन","^के","इनक","�स$","�ञा","ित$","ड�स","िज�","हैं","धार","^�ड","र�ड","^वि","डवर","�ड�","ों$","भव$","रित","^ं$","पनो","आपक","^और","ापन","वर�","मदद","ैं$","विज","^पर","ञाप"],"ngram_size":3,"dimension":5000},{"language":"hi","weights":[0.0113636,0.0113636,0.0113636,0.0113636,0.0113636,0.0227273,0.0227273,0.0113636,0.0227273,0.181818,0.0340909,0.0340909,0.0227273,0.0340909,0.0454545,0.0113636,0.0113636,0.0227273,0.0454545,0.0113636,0.0227273,0.0113636,0.0227273,0.181818,0.0454545,0.0227273,0.0113636,0.0113636,0.0340909,0.0113636,0.0340909],"ids":[85,63,46,55,80,17,54,43,50,68,57,90,79,52,80,15,59,1,92,50,46,7,2,52,68,69,6,99,34,81,95],"ngrams":["इ","ै","ह","त","ध","द","आ","भ","ि","$","व","�","अ","े","प","म","औ","ा","न","ञ","स","�","ो","^","र","ड","ज","�","ं","ी","क"],"ngram_size":1,"dimension":100},{"language":"hmn","weights":[0.00826446,0.00826446,0.00826446,0.0165289,0.00826446,0.00826446,0.0247934,0.00826446,0.00826446,0.00826446,0.00826446,0.00826446,0.00826446,0.00826446,0.0165289,0.00826446,0.0165289,0.00826446,0.0165289,0.00826446,0.00826446,0.00826446,0.0661157,0.00826446,0.00826446,0.00826446,0.0247934,0.00826446,0.0247934,0.00826446,0.00826446,0.0165289,0.0165289,0.00826446,0.0165289,0.00826446,0.0413223,0.00826446,0.00826446,0.0247934,0.0165289,0.00826446,0.0247934,0.00826446,0.00826446,0.00826446,0.00826446,0.00826446,0.0165289,0.00826446,0.00826446,0.0165289,0.0165289,0.0413223,0.0165289,0.0247934,0.00826446,0.00826446,0.0165289,0.00826446,0.00826446,0.00826446,0.0165289,0.0413223,0.00826446,0.00826446,0.0165289,0.0165289,0.0165289,0.00826446,0.0165289,0.00826446],"ids":[651,30,766,503,273,349,898,616,3,895,887,481,738,205,61,879,23,355,679,487,27,927,887,254,227,671,510,522,920,410,939,176,532,591,531,429,300,251,858,215,601,18,67,795,729,862,120,672,891,937,745,597,287,980,123,590,645,885,770,732,500,532,623,854,879,826,648,535,458,334,838,403],"ngrams":["e$","ze","ab","us","eb","se","ts","wm","j$","am","oj","hi","so","ev","^k","ra","u$","^m","au","om","si","mu","v$","av","iv","^z","s$","ye","ua","em","sh","lu","^s","ke","ee","ia","m$","ny","wv","ta","ho","as","nt","ai","yu","^d","im","da","^q","og","ug","qh","uv","^t","^y","b$","^i","^u","g$","su","yo","o$","aw","^n","ib","ko","ov","^l","tu","^r","^$","no"],"ngram_size":2,"dimension":1000},{"language":"hmn","weights":[0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0298507,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0298507,0.0298507,0.0149254,0.0149254,0.0149254,0.0298507,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0298507,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0149254,0.0298507,0.0149254,0.0149254,0.0149254,0.0149254,0.0298507],"ids":[2383,716,2995,3009,1068,1757,1351,754,2254,4557,2820,3216,635,545,1287,4531,3196,1452,2987,3071,3892,1912,2116,1049,4704,1328,4437,2240,949,1806,2877,1135,3618,4662,4031,1636,1959,4586,3913,2543,2239,4325,2353,760,2248,1066,1954,4128,4873,3520,1300,680,3216,1376,3463,2281,3643,168,1771,2766],"ngrams":["^kom","mus$","iab$","hiab","shia","tshi","tus$","kom$","^tus","^kev","tawm","^tsh","^tse","tsua","ntsu","seeb","soj$","^soj","rau$","^mus","^rau","^luv","tau$","tug$","siv$","uav$","^siv","suam","awm$","yuav","hov$","luv$","eem$","yeem","tsee","ntaw","^uas","^ze$","yog$","nyee","^nye","awv$","^nta","tawv","eeb$","^yua","^dai","^yog","uam$","^tau","uas$","kev$","^tug","^nts","qhov","daim","^ib$","aim$","^no$","^qho"],"ngram_size":4,"dimension":5000},{"language":"hmn","weights":[0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0215054,0.0107527,0.0322581,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0215054,0.0215054,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527],"ids":[1924,2078,4063,399,566,1706,4161,3447,4053,438,2926,2116,3116,4378,3721,1948,2120,132,3826,188,3502,2885,4529,2761,592,3292,1491,3437,503,1319,3652,2864,1072,1942,1164,4639,878,2914,2908,4467,3104,501,2028,1122,563,2805,225,2554,4952,539,3267,2176,4234,2719,3174,2344,2290,193,3498,450,3917,59,1174,3606,3413,446,1024,4731,1426,996,117,4992,3121,3777,4484,1572,870,383],"ngrams":["mus","^mu","us$","tus","^ze","eeb","^ts","tse","uam","tsu","soj","ev$","kev","^ke","^ra","au$","^ta","av$","taw","rau","^nt","^yu","uas","^ua","see","nts","em$","iab","^no","uav","eem","yee","hov","^ny","sua","oj$","awv","awm","ov$","yua","as$","^lu","im$","aim","iv$","kom","siv","uv$","ug$","^ko","luv","nta","qho","ab$","^ib","ze$","shi","^qh","^si","og$","tsh","wm$","^da","^yo","^so","dai","eb$","no$","hia","am$","nye","tug","^tu","wv$","om$","ib$","tau","yog"],"ngram_size":3,"dimension":5000},{"language":"hmn","weights":[0.00671141,0.00671141,0.0536913,0.0268456,0.0134228,0.0604027,0.0402685,0.00671141,0.0134228,0.0201342,0.033557,0.0536913,0.0671141,0.0201342,0.0402685,0.0134228,0.0201342,0.0402685,0.0134228,0.0536913,0.00671141,0.187919,0.0134228,0.187919],"ids":[5,24,44,66,32,96,79,0,12,65,20,21,59,11,0,88,63,22,2,57,86,68,19,52],"ngrams":["j","r","s","i","w","a","e","d","q","y","n","t","u","b","m","g","h","o","l","v","z","$","k","^"],"ngram_size":1,"dimension":100},{"language":"hr","weights":[0.0018018,0.0018018,0.0018018,0.0018018,0.0018018,0.0018018,0.0018018,0.0018018,0.0018018,0.0036036,0.0036036,0.0018018,0.0036036,0.0018018,0.0036036,0.0018018,0.0018018,0.00540541,0.0036036,0.0036036,0.0018018,0.0018018,0.0018018,0.0036036,0.0018018,0.0018018,0.0018018,0.0018018,0.0018018,0.00540541,0.0018018,0.0036036,0.0036036,0.0018018,0.0018018,0.0018018,0.0036036,0.00540541,0.0018018,0.0036036,0.0018018,0.0018018,0.0018018,0.0018018,0.0018018,0.0018018,0.00720721,0.00720721,0.0036036,0.00900901,0.00720721,0.00900901,0.0018018,0.0144144,0.0036036,0.0144144,0.00720721,0.0036036,0.0126126,0.0036036,0.00540541,0.00720721,0.00720721,0.00720721,0.0018018,0.0018018,0.0036036,0.018018,0.0036036,0.00720721,0.0018018,0.0036036,0.0018018,0.0018018,0.0036036,0.0108108,0.0018018,0.00540541,0.00540541,0.0018018,0.0036036,0.0018018,0.00900901,0.00720721,0.0252252,0.0018018,0.0036036,0.0018018,0.0252252,0.00540541,0.00900901,0.0018018,0.00540541,0.00900901,0.0018018,0.00900901,0.0018018,0.00720721,0.0126126,0.0018018,0.00540541,0.00540541,0.0126126,0.0018018,0.0018018,0.00540541,0.0018018,0.0018018,0.0036036,0.0018018,0.0036036,0.0036036,0.0018018,0.0018018,0.00540541,0.00720721,0.00720721,0.0018018,0.0018018,0.00900901,0.00540541,0.00900901,0.00540541,0.00540541,0.0036036,0.0036036,0.0018018,0.00720721,0.0018018,0.00720721,0.0036036,0.0234234,0.00540541,0.0126126,0.0036036,0.0234234,0.0162162,0.0018018,0.0036036,0.0018018,0.00720721,0.0018018,0.00720721,0.00720721,0.0036036,0.0036036,0.0108108,0.0018018,0.0018018,0.0126126,0.0018018,0.0018018,0.0036036,0.0108108,0.0018018,0.00540541,0.00720721,0.0036036,0.0036036,0.00720721,0.0108108,0.0108108,0.00540541,0.0018018,0.00540541,0.0018018,0.0162162,0.00540541,0.00540541,0.0018018,0.0378378,0.0306306,0.0018018,0.0036036,0.0018018,0.0036036,0.0018018,0.00720721,0.0018018,0.00720721,0.00540541,0.00720721,0.0018018,0.0018018,0.00900901,0.00540541,0.0036036,0.00540541],"ids":[8,660,83,937,517,854,920,898,682,963,442,353,410,98,973,365,227,829,908,843,166,833,594,385,493,301,29,166,126,230,702,976,30,983,114,170,402,886,113,403,153,631,517,895,109,734,915,364,128,854,46,885,860,68,907,645,803,120,985,356,355,780,3,353,503,895,175,629,770,287,955,41,186,980,829,933,577,591,942,662,984,725,622,975,848,307,248,575,651,887,826,99,75,648,254,96,510,786,887,75,146,763,532,269,671,215,90,676,778,893,766,487,113,144,496,18,191,950,490,327,122,489,793,391,300,672,616,526,893,7,486,61,422,212,630,791,23,925,732,83,671,265,116,545,333,421,200,656,486,879,518,875,125,564,364,128,819,349,80,8,71,378,493,449,27,739,532,892,458,501,989,685,147,862,721,553,978,75,656,838,62,540,70,738,157,875,91,108],"ngrams":["sn","lt","ul","og","eu","ac","ua","ts","rv","ci","ml","^h","em","ik","el","tr","iv","sk","js","vo","sv","uš","ju","de","lo","vr","eć","rn","gr","iz","aj","^o","ze","ii","do","sr","od","eg","bu","no","en","že","mi","am","zv","et","io","uk","jo","^n","al","^u","α�","^j","ag","^i","di","im","ri","me","^m","va","j$","er","us","št","il","ja","g$","it","te","ma","rz","^t","ši","ti","oš","ro","će","dv","rt","^ć","lj","ao","i$","nc","n$","^e","e$","v$","ko","hr","pr","ov","av","ni","s$","is","oj","op","or","ad","o$","an","fr","ta","^f","za","ru","mo","ab","om","^κ","κυ","kr","as","ku","�η","ξα","r$","sl","ed","to","ga","m$","da","vu","on","αξ","sa","^b","^k","ks","^p","at","ij","u$","^g","su","iš","^z","pi","ar","ir","dn","ur","st","bo","ης","ra","pe","k$","ji","ki","vi","po","li","se","nu","^a","^v","la","in","zg","si","^ž","^s","vl","tu","ba","a$","je","ka","^d","ς$","go","bi","nj","kć","^$","zi","os","υα","so","na","un","ve","ak"],"ngram_size":2,"dimension":1000},{"language":"hr","weights":[0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00527705,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00527705,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00791557,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00791557,0.00791557,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.0184697,0.00527705,0.00527705,0.00791557,0.00263852,0.00527705,0.00263852,0.00527705,0.00263852,0.00263852,0.00791557,0.00527705,0.00527705,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.0105541,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00791557,0.00527705,0.00527705,0.00527705,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00527705,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00791557,0.00263852,0.00791557,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00263852,0.00791557,0.00527705,0.00527705,0.00263852,0.00791557,0.00263852,0.00263852,0.00263852,0.00263852,0.00527705,0.00263852,0.00527705,0.00527705,0.00527705,0.00527705,0.00263852,0.00263852,0.00527705,0.00527705,0.00527705,0.00527705,0.00263852,0.00263852,0.00527705,0.00527705,0.00527705],"ids":[2150,4174,4341,2029,1283,2261,1407,684,491,2190,4537,3911,815,3753,192,1786,4451,2567,2107,2,2255,463,1573,795,2661,3125,4308,3707,651,1078,1862,3707,2300,4092,1001,633,2747,633,2774,1427,4509,3945,3725,418,1599,297,2605,2925,2471,1036,4509,4730,2298,4498,1494,2705,2293,1069,3609,4405,3502,2811,3862,1376,439,2979,1671,2068,394,2312,2175,4146,3728,2214,2410,2776,4384,3677,2885,4185,4674,4027,2925,3455,361,670,1454,2403,903,4063,68,2628,2473,55,4926,360,3039,2821,2623,2620,2234,3297,767,1476,3769,2304,4864,619,3882,4179,2571,3321,547,3743,2082,1883,4782,2551,4617,2431,760,2770,115,1782,3808,3727,204,4200,2591,536,1322,4873,3640,2630,1251,3215,3763,2970,272,1852,4661,772,508,2473,3787,1591,527,3316,3684,1834,544,111,3939,1513,1474,2633,3349,810,59,829,2742,3151,1607,3160,2735,3818,1796,2809,1560,865,116,3116,1013,4523,3451,1109,4437,1426,2970,4754,2018,2832,301,2851,200,4306,3913,3828,3762,4338,4237,2637,1793,270,3978,4661,1194,387,2697,1617,3678,987,1854,4344,383,3180,3720,983,1352,2050,4557,1435,1120,807,553,4484,4832,3927,4968,2213,4301,519,3364,832,4469,29,731,2562,1179,3294,3861,2536,907,4473,3218,3173,3049,905,1062,4287,387,3000,3935,446,3663,4045,4084,1499,947,1961,1860,1948,2283,4200,1399,2792,2330,2564,4847,882,2417,2700,4013,2952,3413,1874,2338,1638,3350,2650,3078,4441,4854,4588,4335,4014,1573,4339,2143,966,2711,1345,2182,3445,4152,635,4209,465,867,957,4743,4300,1406,4444,2095,3731,189,212,1436,804,1904,3236],"ngrams":["ela$","kusn","uru$","turu","ltur","kult","ogat","boga","ima$","^ona","ropi","urop","^eur","uaci","ultu","itua","situ","acij","mlja","ska$","tska","vats","rvat","ukus","^hrv","nci$","anci","janc","ijan","zija","^per","ali$","adal","avla","zavl","ljom","hrva","emlj","iki$","liki","^vel","nuk$","sti$","last","vlas","šio$","ušio","sruš","^sru","oniz","roni","euro","etro","detr","^det","ega$","ojeg","^kul","koje","ralj","kral","^kra","ijsk","alj$","dnji","egov","jego","edio","gov$","uniš","jedi","lije","nasl","sna$","ivu$","iniv","αξα�","tio$","štio","tron","išti","uku$","jsku","vojs","rao$","rniz","^će$","erni","jela","dern","^ili","mode","^mod","lona","bilo","irao","abil","babi","^bab","ala$","tove","slij","eće$","vise","oder","^vis","jski","nizi","dio$","^jel","koji","zgra","izir","^izg","ovaj","ruši","^ova","^sa$","ništ","joj$","^ii$","osor","^fra","ojsk","njeg","dono","riti","^ga$","odon","^uku","asli","noso","tuac","buko","^kij","nabu","nom$","adio","^bog","enom","ijed","atsk","ženo","υαξα","tala","ilon","tov$","stal","post","tis$","^sin","itis","ojoj","jega","miti","^ami","zval","rist","^zva","nji$","tori","unuk","ili$","^unu","^zav","abuk","ski$","kćer","ukod","^sit","^kće","usna","imao","nuku","rij$","mao$","^kri","frao","cija","^pos","ije$","koja","^kir","^svo","ove$","ona$","^ima","erzi","orij","opi$","dva$","^je$","ijag","tija","asti","lja$","^ast","voju","edij","gatu","rzij","jaks","medi","sin$","zira","mljo","^žen","^dva","rito","^voj","ošir","dije","dara","^pro","veli","orto","erit","roši","oja$","dijs","adar","^ter","iti$","seće","irit","kir$","^vrt","onos","atu$","^nab","^se$","ija$","sora","oji$","^koj","ćer$","jom$","^nas","^uni","amit","svoj","aort","širi","ijak","^vla","ednj","sta$","raor","grad","vala","kris","nja$","perz","prij","nini","^pri","elik","^κυα","�ης$","rtov","itor","vaj$","α�ης","ara$","ξα�η","iseć","rije","sar$","radi","ksar","proš","^nin","ora$","vlad","sku$","kojo","aksa","zeml","^med","dali","kija","nivu","izgr","osta","teri","^zem","kodo","^su$","slje","jag$","ljed","oju$","vrto","oslj","posl","stij","ista","κυαξ","dnja","jedn","lada","^nje"],"ngram_size":4,"dimension":5000},{"language":"hr","weights":[0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00645161,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00645161,0.00215054,0.00430108,0.00430108,0.00215054,0.00645161,0.00215054,0.00430108,0.00860215,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00645161,0.00430108,0.00215054,0.00645161,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00645161,0.00215054,0.00430108,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00645161,0.00215054,0.00645161,0.00645161,0.00645161,0.00430108,0.00215054,0.00430108,0.00215054,0.00430108,0.00215054,0.00215054,0.00645161,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00645161,0.00430108,0.00215054,0.00215054,0.00860215,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00645161,0.00430108,0.00215054,0.00215054,0.00215054,0.00860215,0.00645161,0.00645161,0.00215054,0.00430108,0.00430108,0.00215054,0.00215054,0.00430108,0.00215054,0.00430108,0.00430108,0.00215054,0.00215054,0.00430108,0.00215054,0.0215054,0.00645161,0.00215054,0.00215054,0.00430108,0.00430108,0.00215054,0.00430108,0.00645161,0.00430108,0.00215054,0.00215054,0.00860215,0.00215054,0.00860215,0.00215054,0.00215054,0.00215054,0.00645161,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00645161,0.00215054,0.00430108,0.00430108,0.00645161,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00215054,0.00430108,0.00430108,0.00645161,0.00215054,0.00430108,0.00430108,0.0172043,0.00645161,0.00430108,0.00430108,0.00215054,0.00645161,0.00215054,0.00430108,0.00215054,0.00215054,0.00430108,0.00215054,0.00430108,0.00645161,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00430108,0.0150538,0.00430108,0.00430108,0.00215054,0.00215054,0.00215054,0.00215054,0.00215054,0.00860215,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00645161,0.00430108,0.00215054,0.00215054,0.00215054,0.00430108,0.00215054,0.00215054,0.00645161],"ids":[1128,1253,1955,4200,3956,661,4041,107,3641,3534,1881,3006,2483,1606,81,382,2479,1582,2488,3269,2852,2475,3263,4447,3473,1628,1580,3254,2280,2010,1859,3734,1412,566,2991,3189,1776,2766,1270,2644,2039,4505,1899,834,3106,4520,157,1057,3194,3681,796,3168,2985,4953,722,3319,2655,4976,2659,273,4207,1715,1651,2067,2832,2868,1101,2320,405,2773,4995,1227,141,230,605,38,408,4258,3470,4356,271,3297,416,4673,1187,4538,318,1486,2263,2610,4847,2759,4115,2239,1377,3810,928,94,2558,4829,4337,1745,772,4635,1637,1909,1608,1477,4486,4894,4625,2599,2085,456,1190,4009,182,1345,3237,4282,3478,2522,4412,2892,690,1905,207,998,4942,3517,3915,4259,2820,4876,2428,4287,1843,2030,721,4640,2266,805,3951,652,431,3683,3902,266,579,2828,4002,32,3849,2931,980,4639,4447,1960,3457,2878,2034,4824,2640,2035,4866,252,3433,1820,582,51,2375,4923,2558,2596,3213,419,3483,3848,2353,792,3695,4382,3029,4905,1776,611,1168,442,2244,1370,2825,1630,2861,862,4484,3028,133,1426,4761,1732,1066,1852,3549,2555,3327,4886,539,3498,2908,1057,2585,2410,2589,4590,2764,3170,4696,252,367,2132,2019,1765,4511,2149,3280,2676,1099,4248,1817,1440,1964,74,1678,4540,3552,147,3054,3875,180,319,1439,4976,4637,4639,3963,705,4485,4597,819,4024,4118,4914,3142,4017,961,358,1150,4167,660,2965,4258,104,3606,1184,3290,420,2722,1633,245,3082,3584,591,722,1943,3439,4108,1695,4721,4821,2683,4697,4287,1946,1294,2544,2667,669,2188,1003,292,1789,156,4240,3797,1590,329,711,1162,2941,1062,612,1366,750,1449,2147,4714,4530,16,4964,1987,2188,4779,4151],"ngrams":["usn","kus","^uk","uru","tur","ltu","jel","ult","bog","ma$","^on","uro","eur","^eu","cij","aci","tua","itu","sit","vat","hrv","^hr","anc","jan","zij","per","ali","dal","jom","ljo","rva","zem","ci$","^ze","vel","atu","avl","ir$","las","sa$","šio","kul","sru","ron","tro","etr","det","^de","ega","lj$","tu$","alj","ral","kra","opi","ski","ijs","gov","jeg","lik","ga$","^za","^ga","lij","asl","nas","vu$","ivu","^ni","šti","niš","uni","ala","sku","^že","jsk","^vo","ju$","^sv","svo","der","mod","osl","na$","ij$","ona","izi","^pe","vla","ilo","eml","io$","ćer","bil","ve$","vrt","rni","^vr","pi$","seć","eli","^me","ise","ru$","ira","iki","^vi","dio","adi","^bo","tov","izg","eri","vaj","nji","ova","oju","^ov","joj","ojo","sin","li$","ii$","ora","erz","oso","ove","nos","zgr","abu","^na","se$","nom","žen","^a$","tis","mit","ka$","tal","oja","^am","ost","val","rop","ojs","rij","ku$","gat","^un","^ku","ima","kod","nin","^zv","^il","oj$","zir","ela","kće","šir","la$","mao","^im","oje","jag","nci","^iz","ats","sta","rzi","sti","ast","^i$","^as","bab","dij","ska","ag$","niv","tor","edi","don","med","aor","buk","is$","aks","ada","lja","zav","koj","ori","ini","ami","om$","sor","ito","aj$","vis","ti$","uk$","sar","iti","^će","^sr","roš","^ko","^si","ov$","^u$","^su","rto","^kć","ort","mlj","^fr","ta$","rit","^mo","gra","ris","eno","je$","kij","oga","kir","ego","kri","sli","tij","^po","edn","�ης","^κυ","^ki","^dv","ije","oji","ξα�","er$","^pr","α�η","uac","αξα","υαξ","κυα","uku","^nj","fra","ter","oši","ono","nja","ar$","^ii","lad","niz","ksa","iri","eće","in$","lon","^se","ruš","dnj","lje","^kr","ili","ji$","ra$","^je","rao","^vl","unu","tio","jak","va$","voj","dva","nab","ist","ης$","nje","pos","abi","dar","pro","uši","oni","će$","ija","ki$","su$","rad","^ve","odo","zva","^sa","ja$","sna","tsk","ern","slj","ode","ao$","nuk","ara","^te","uko","pri","išt","^ba","jed"],"ngram_size":3,"dimension":5000},{"language":"hr","weights":[0.00155039,0.00310078,0.00620155,0.00155039,0.0124031,0.0155039,0.00155039,0.0372093,0.00155039,0.0434109,0.00155039,0.00310078,0.00465116,0.00155039,0.0883721,0.0449612,0.0837209,0.0186047,0.00155039,0.00155039,0.00155039,0.0341085,0.027907,0.0325581,0.0527132,0.139535,0.0263566,0.0263566,0.0124031,0.139535,0.0589147,0.00465116,0.0573643,0.0124031],"ids":[63,58,11,78,88,0,22,19,29,44,2,99,3,56,66,24,96,0,18,82,44,59,21,20,79,52,57,2,86,68,5,66,22,77],"ngrams":["h","c","b","ž","g","m","f","k","ς","s","�","α","š","κ","i","r","a","d","η","υ","ξ","u","t","n","e","^","v","l","z","$","j","ć","o","p"],"ngram_size":1,"dimension":100},{"language":"ht","weights":[0.00505051,0.010101,0.0151515,0.00505051,0.00505051,0.010101,0.00505051,0.020202,0.00505051,0.00505051,0.0252525,0.010101,0.020202,0.0151515,0.00505051,0.020202,0.00505051,0.00505051,0.010101,0.010101,0.0151515,0.00505051,0.00505051,0.00505051,0.00505051,0.010101,0.040404,0.00505051,0.010101,0.00505051,0.020202,0.0151515,0.0151515,0.010101,0.00505051,0.010101,0.00505051,0.00505051,0.00505051,0.010101,0.0151515,0.00505051,0.0151515,0.0151515,0.0151515,0.00505051,0.0151515,0.0252525,0.00505051,0.030303,0.0151515,0.00505051,0.00505051,0.010101,0.0353535,0.0606061,0.0151515,0.0151515,0.020202,0.0151515,0.010101,0.010101,0.0151515,0.00505051,0.0151515,0.0151515,0.0151515,0.0151515,0.030303,0.040404,0.0151515,0.0353535,0.0151515],"ids":[740,515,564,68,300,726,153,355,977,518,248,879,116,960,39,848,819,821,823,90,61,380,476,738,481,356,613,862,685,120,532,500,108,943,157,416,712,96,924,193,793,7,23,637,128,629,875,8,349,269,215,657,803,854,651,212,955,734,41,980,207,838,522,540,532,535,933,123,93,287,559,989,265],"ngrams":["è$","ry","ki","^j","m$","nm","en","^m","yi","pe","n$","ra","ar","pa","ey","i$","li","èt","fè","^f","^k","ew","^c","so","hi","me","t$","^d","je","im","o$","yo","ak","ot","na","pw","we","ni","dw","le","to","sa","u$","ut","po","ja","k$","^a","se","an","ta","ch","sy","^n","e$","^p","te","et","ma","^t","ej","^$","ye","os","^s","^l","ti","^y","ou","it","wo","a$","pi"],"ngram_size":2,"dimension":1000},{"language":"ht","weights":[0.00909091,0.00909091,0.00909091,0.00909091,0.00909091,0.0181818,0.0181818,0.0181818,0.0181818,0.0181818,0.00909091,0.00909091,0.00909091,0.00909091,0.00909091,0.00909091,0.00909091,0.00909091,0.0181818,0.00909091,0.0181818,0.00909091,0.0272727,0.00909091,0.0181818,0.0181818,0.0181818,0.0272727,0.00909091,0.00909091,0.0181818,0.0181818,0.0181818,0.0181818,0.00909091,0.0181818,0.0272727,0.0181818,0.0181818,0.00909091,0.00909091,0.0272727,0.00909091,0.00909091,0.00909091,0.0272727,0.00909091,0.00909091,0.0272727,0.00909091,0.0272727,0.00909091,0.0181818,0.00909091,0.0272727,0.00909091,0.0181818,0.0272727,0.00909091,0.00909091,0.00909091,0.00909091,0.00909091,0.00909091,0.00909091,0.0181818,0.00909091,0.00909091,0.0181818,0.00909091,0.00909091],"ids":[2122,1145,2603,2026,2442,2925,202,4159,3297,3998,1474,4930,1309,4734,888,3665,2101,3857,325,295,2693,4439,1808,3861,1061,4017,1735,4368,4892,3575,3257,1614,3321,422,396,1706,1075,1900,1059,3248,4602,3785,3361,1054,4918,3828,1272,4160,1246,1219,2764,761,3102,867,184,1605,3301,1510,702,2551,293,3364,2764,3127,1438,258,2320,582,4651,4149,4030],"ngrams":["^ki$","^fè$","man$","manm","^man","rye$","arye","^mar","kit$","^kit","jan$","enm$","menm","peyi","nan$","^jan","^nan","ete$","ran$","^fèt","^let","nime","^yo$","^se$","teje","otej","wote","^pit","^nim","^pa$","pwot","para","^pwo","mary","^dwe","eje$","^tou","eta$","leta","imew","nman","piti","chit","^li$","ita$","pou$","eyi$","fèt$","out$","syet","^pou","^men","tit$","osye","tout","anma","itit","^ak$","^chi","^sa$","yete","iti$","^pey","ewo$","hita","^par","dwe$","sosy","aran","mewo","^sos"],"ngram_size":4,"dimension":5000},{"language":"ht","weights":[0.00653595,0.00653595,0.00653595,0.00653595,0.0130719,0.0130719,0.0130719,0.0130719,0.0196078,0.00653595,0.00653595,0.00653595,0.00653595,0.00653595,0.00653595,0.00653595,0.0326797,0.0130719,0.0130719,0.0130719,0.00653595,0.00653595,0.0130719,0.00653595,0.00653595,0.00653595,0.00653595,0.0196078,0.00653595,0.0196078,0.00653595,0.0196078,0.0130719,0.0130719,0.0130719,0.00653595,0.00653595,0.00653595,0.00653595,0.0130719,0.00653595,0.00653595,0.0261438,0.0196078,0.00653595,0.0130719,0.0130719,0.00653595,0.00653595,0.0196078,0.00653595,0.0130719,0.00653595,0.00653595,0.00653595,0.00653595,0.00653595,0.0196078,0.0130719,0.00653595,0.0130719,0.0130719,0.00653595,0.0196078,0.0196078,0.00653595,0.0130719,0.0196078,0.00653595,0.00653595,0.00653595,0.0130719,0.0196078,0.0196078,0.0196078,0.0196078,0.00653595,0.0196078,0.0196078,0.00653595,0.00653595,0.0130719,0.0196078,0.0130719,0.00653595,0.00653595,0.00653595,0.0196078],"ids":[1732,3922,1761,2481,4692,4932,4964,3829,3552,1493,4447,4264,2112,2241,1745,3915,3239,4530,1368,2364,3006,41,2011,4324,509,2523,1486,4624,55,4696,1136,4823,1046,3487,2810,1689,2522,3782,156,658,3641,2644,3356,4657,4230,335,2413,1078,1591,1964,2305,374,16,3896,638,3172,4081,3672,1313,4259,1594,2428,67,873,1618,3606,3315,3549,498,4373,3413,1494,3894,3606,1936,4814,1162,2503,844,405,4393,4511,3120,3471,1401,3386,4963,875],"ngrams":["ti$","fè$","anm","pa$","rye","ary","mar","kit","^ki","^ja","jan","nm$","enm","men","^me","^na","an$","ara","ye$","par","^li","fèt","^fè","wo$","ewo","ime","^pe","pit","sos","ta$","^ch","yo$","ote","pwo","wot","we$","li$","dwe","ki$","let","nim","sa$","it$","pou","hit","^pw","^le","èt$","yet","^po","osy","man","ita","nan","chi","nma","mew","tou","tej","se$","ran","^a$","te$","^to","ak$","^se","tit","iti","^dw","eyi","^so","eta","ut$","^yo","^ma","^pa","^sa","out","ou$","^ni","sye","je$","^pi","eje","yi$","pey","ete","^ak"],"ngram_size":3,"dimension":5000},{"language":"ht","weights":[0.0164609,0.00823045,0.0123457,0.0164609,0.00411523,0.00411523,0.0617284,0.0288066,0.0288066,0.037037,0.0246914,0.00411523,0.0534979,0.0493827,0.0123457,0.185185,0.0246914,0.0534979,0.0823045,0.00823045,0.0164609,0.0823045,0.185185],"ids":[24,33,5,32,58,0,79,0,65,20,59,63,22,77,2,52,19,66,96,22,44,21,68],"ngrams":["r","è","j","w","c","d","e","m","y","n","u","h","o","p","l","^","k","i","a","f","s","t","$"],"ngram_size":1,"dimension":100},{"language":"hu","weights":[0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.0243902,0.0162602,0.0325203,0.0162602,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.0162602,0.0243902,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.0325203,0.00813008,0.00813008,0.0243902,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008],"ids":[19,976,336,282,786,334,109,319,353,780,434,637,842,486,108,269,879,248,153,385,46,493,355,122,848,286,954,96,672,31,8,875,842,734,18,856,999,809,517,604,91,885,166,640,176,265,532,461,748,290,980,859,841,309,337,193,403,241,511,886,651,989,145,201,526,71,676,937,672,553,534,925,17,90,963,566,300,337,381,216,838,692,719,88,989,875,475,613,120,365,535,331,613,540,752,973],"ngrams":["ol","^o","ój","rá","is","^r","rl","ár","^h","án","tá","ut","kc","ió","ak","an","ra","n$","en","de","al","in","^m","ld","i$","zt","ás","ni","át","lá","^a","k$","fo","et","as","já","ge","nd","mi","ál","ve","^u","öv","zö","lu","re","^s","ló","ó$","nk","^t","tó","ít","gj","vá","le","no","ói","zo","eg","e$","gl","ák","sá","on","^v","za","og","da","go","oo","^g","nz","^f","ci","sz","m$","tn","fe","ná","^$","gi","sí","az","a$","un","zn","t$","im","tr","^l","ác","lh","os","ha","el"],"ngram_size":2,"dimension":1000},{"language":"hu","weights":[0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236,0.011236],"ids":[788,2731,4649,58,2544,2022,808,1658,3095,2353,2056,468,4259,1320,284,147,4025,3848,1606,3957,2341,2099,4579,1324,4949,2496,3782,729,2266,2850,3034,312,4042,3428,4971,1203,3961,3274,4204,3471,2546,2469,2301,3009,4362,4565,725,859,1558,3116,4468,3845,3759,4319,4533,4933,3715,4245,215,4802,2562,465,2445,2390,2804,730,4518,988,4174,2726,179,1832,4223,959,4354,4861,2526,237,1430,2552,144,2401,3215,2785,4060,466,1740,2648,789],"ngrams":["unk$","lunk","olda","óját","iójá","ját$","áció","ztrá","dalu","sztr","gisz","ráci","egis","regi","ldal","sát$","ását","lásá","árlá","sárl","vásá","tán$","után","ció$","kció","anza","ranz","^old","tran","^tra","ásár","inde","zakc","mind","^vás","tni$","látn","ják$","^utá","^fel","gják","átni","eget","den$","náló","vege","öveg","zöve","trác","^fog","^szö","goog","nden","ító$","zono","sító","rlás","^min","osít","^azo","onos","akci","lhas","azon","^lát","hasz","ciój","^reg","szöv","felh","gle$","oogl","^ha$","ogjá","get$","alun","nzak","ogle","álói","^goo","iszt","óim$","aszn","znál","elha","szná","fogj","lóim","nosí"],"ngram_size":4,"dimension":5000},{"language":"hu","weights":[0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.0190476,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.0190476,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.0190476,0.00952381,0.0285714,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381,0.00952381],"ids":[669,4902,3570,1425,4497,2690,126,2667,1350,4560,4759,4912,4348,2107,2482,887,2667,1092,3983,4611,4625,4480,2993,1636,1877,2281,4348,3254,3519,4617,2038,3198,856,4851,765,1007,1376,3399,755,4562,553,1264,326,3454,4214,3052,402,1594,998,1946,4982,3497,4405,2297,3431,1575,3393,94,503,1808,4359,4616,1493,862,1745,2993,3772,1862,1189,2428,3580,2976,159,600,4914,2119,1956,4012,1929,1818,2033,4614,1618,1881,2028,3697,360,4896,3521,1809,4384,1960,1010,3343,1925,2672,2123,1090,4268,3177],"ngrams":["nk$","unk","lun","áló","le$","old","ját","^re","ójá","iój","áci","ják","ztr","ogj","szt","isz","zöv","gis","egi","reg","ni$","sát","lás","tó$","rlá","lda","ha$","dal","^mi","án$","has","tán","alu","utá","ió$","ció","tra","sár","^tr","den","nde","nza","zak","ind","fel","min","nál","ran","nos","át$","^lá","elh","gjá","ák$","get","^fo","tni","fog","en$","szö","ege","^vá","szn","lát","et$","asz","ító","ásá","kci","^a$","osí","^ha","gle","átn","ono","azo","árl","^ut","anz","goo","^az","sít","veg","oog","im$","zon","rác","trá","lói","óim","vás","^fe","ogl","^ol","^sz","^go","akc","lha","öve","zná"],"ngram_size":3,"dimension":5000},{"language":"hu","weights":[0.0141844,0.0141844,0.0283688,0.0141844,0.0496454,0.0141844,0.0567376,0.0567376,0.0070922,0.035461,0.0141844,0.0425532,0.0283688,0.0141844,0.0070922,0.0425532,0.12766,0.035461,0.0425532,0.0141844,0.0212766,0.12766,0.0638298,0.070922,0.0141844,0.0425532],"ids":[59,58,24,5,2,57,20,21,54,88,0,66,11,22,28,44,68,86,22,63,19,52,96,65,0,79],"ngrams":["u","c","r","j","l","v","n","t","í","g","m","i","ó","f","ö","s","$","z","o","h","k","^","a","á","d","e"],"ngram_size":1,"dimension":100},{"language":"hy","weights":[0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0141844,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0141844,0.0141844,0.0070922,0.0070922,0.0070922,0.0070922,0.0212766,0.0070922,0.0070922,0.0212766,0.0070922,0.0070922,0.0070922,0.0212766,0.0141844,0.0212766,0.0070922,0.0141844,0.0070922,0.0070922,0.0070922,0.0070922,0.0212766,0.0212766,0.0070922,0.0141844,0.0141844,0.0212766,0.0070922,0.0070922,0.0141844,0.0070922,0.0070922,0.0070922,0.0070922,0.0070922,0.0141844,0.0070922,0.0141844,0.0070922,0.0070922,0.0283688,0.0141844,0.0070922,0.0212766,0.0070922,0.0141844,0.0141844,0.0070922,0.0212766,0.0141844,0.0070922,0.0070922,0.0141844,0.0070922,0.0070922,0.0070922,0.0141844,0.0141844,0.035461,0.0070922,0.0141844,0.0070922,0.0070922,0.0070922,0.0283688,0.0212766],"ids":[254,522,406,94,167,533,946,727,255,97,242,951,11,689,627,116,932,244,523,660,328,356,762,897,622,664,762,888,501,619,117,355,41,981,543,377,184,287,623,21,9,410,502,95,601,789,219,983,983,523,399,722,540,175,236,579,143,139,337,244,664,714,851,393,761,331,592,178,73,344,440,394,32,914,555,848,141,988,850,814,359,896,78,318,236,714,272,838,984,381,677,530,991],"ngrams":["պե","սպ","սո","աս","ամ","տ$","շա","մե","ք$","^մ","եռ","դե","^դ","ետ","ն$","յս","նն","հե","ւս","կո","ռա","առ","իկ","քր","ոք","փո","կ$","ակ","սի","օր","^տ","^ք","են","^փ","րօ","^հ","քի","շե","նե","րի","^շ","ի$","րկ","հա","տո","գհ","ս$","պա","ին","^է","նի","ա�","մ$","^ն","աչ","յո","այ","քա","ով","ւհ","ած","չք","հի","քե","ւմ","նգ","ծ$","^ա","վ$","կա","նք","եվ","ար","^ե","մն","է$","ան","յ$","րո","եր","�ա","�$","ռ$","տա","ատ","նա","իա","^$","ես","^պ","^յ","ու","ա$"],"ngram_size":2,"dimension":1000},{"language":"hy","weights":[0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989],"ids":[3886,1561,657,835,772,55,3471,2518,3016,4808,1643,856,901,4219,415,2057,1977,3046,1008,1581,3321,2808,4559,437,1278,4122,3598,835,3347,118,968,4403,2889,1369,3086,1469,1939,1689,4947,3137,2776,1802,4243,3276,2632,1637,2326,1418,1666,3425,451,598,3055,402,3348,2467,2495,3760,100,1862,4885,3040,990,3701,2981,1047,2832,98,4813,2264,4145,3083,2475,3051,352,4169,3198,473,3954,3901,3542,3044,214,3352,2448,1370,1159,2724],"ngrams":["պես$","մնա�","տամն","ետամ","հետա","^հետ","շատ$","սպես","^շատ","^այս","րին$","երին","ների","աննե","ենք$","ուհա","դեռ$","պատո","ւսի$","ուսի","ակու","ռակո","առակ","յսպե","երով","րօրի","^քառ","մենք","քրիկ","հիա�","ոքրի","�ած$","^փոք","ասու","^ենք","չքեր","օրին","րիկ$","րինա","^շեն","^տար","^նա$","նքի$","ենքի","ինակ","հանն","շենք","այսպ","^մեն","քառա","կանի","րկան","ններ","արկա","տարօ","հարկ","գհար","ինգհ","հինգ","սում","փոքր","ում$","յում","ատու","կուս","այու","արօր","^դեռ","^նայ","քերո","^ասո","նա�$","ւհան","իա�ա","րով$","նայո","^եվ$","նակ$","^հին","աչքե","նգհա","ամնա","^հիա","ա�ած","^աչք","տուհ","^պատ","անի$"],"ngram_size":4,"dimension":5000},{"language":"hy","weights":[0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.026087,0.00869565,0.00869565,0.0173913,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.026087,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.0173913,0.00869565,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.026087],"ids":[1511,1230,4227,89,3421,2407,4279,2076,2605,558,2230,1271,4532,390,4409,337,4965,1656,2517,1859,3682,1326,2110,1039,1710,1055,3108,4768,4631,722,2076,1446,1730,3166,3517,2373,3558,268,2433,475,4407,4096,3844,2076,3460,4989,3670,37,944,2088,3552,3850,1169,2347,3457,3837,2854,4056,137,1769,2182,447,4566,3582,2594,263,1555,1792,828,4970,3244,2224,635,697,3257,3485,423,3302,1146,1100,3174,2360,3083,4264,3407,40,2304,3424,1061,688,1708,2336,4646,3985,2008,3171,4283,1641,4738,4474,238,2752,2563],"ngrams":["ես$","պես","յսպ","այս","^այ","սու","ասո","^աս","տամ","^յ$","ետա","ակ$","^են","մեն","հար","ննե","դեռ","երի","ներ","ռակ","հետ","ատո","պատ","ամն","ւսի","աչք","ակո","առա","քառ","ած$","^քա","իկ$","ուհ","ով$","նգհ","րիկ","ոքր","փոք","կու","^փո","անն","նակ","քի$","րին","ւհա","րկա","իա�","տար","^շա","^տա","ենք","նքի","ատ$","նք$","նա$","եվ$","ին$","արկ","սի$","կան","եռ$","գհա","հին","ինա","^է$","նա�","րով","նայ","արօ","տու","սպե","քեր","օրի","ուս","^մե","հիա","մնա","քրի","շեն","հան","րօր","^շե","^հե","երո","^պա","^աչ","յու","ում","ա�$","ւմ$","անի","շատ","չքե","այո","^ա$","^հի","�ած","նի$","^դե","ինգ","^եվ","ա�ա","^նա"],"ngram_size":3,"dimension":5000},{"language":"hy","weights":[0.00598802,0.0239521,0.00598802,0.0179641,0.0239521,0.00598802,0.0359281,0.0179641,0.011976,0.0359281,0.00598802,0.00598802,0.155689,0.0239521,0.0359281,0.155689,0.011976,0.00598802,0.011976,0.0299401,0.0239521,0.0239521,0.011976,0.11976,0.011976,0.0778443,0.0538922,0.0479042],"ids":[6,79,82,46,1,70,35,86,55,33,10,49,68,9,15,52,19,13,4,7,23,97,9,55,95,96,56,92],"ngrams":["դ","ս","փ","յ","կ","գ","ո","է","շ","ք","չ","օ","$","տ","ր","^","�","ծ","պ","հ","մ","ւ","ռ","ա","վ","ն","ե","ի"],"ngram_size":1,"dimension":100},{"language":"id","weights":[0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00350467,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00233645,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00233645,0.00116822,0.00350467,0.00350467,0.00350467,0.00584112,0.00350467,0.00116822,0.00233645,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.00116822,0.0046729,0.00233645,0.00116822,0.00116822,0.00934579,0.0046729,0.00116822,0.00116822,0.00584112,0.0163551,0.00233645,0.00233645,0.0046729,0.00116822,0.00233645,0.00233645,0.00116822,0.00700935,0.00116822,0.010514,0.00233645,0.00350467,0.00350467,0.00584112,0.00233645,0.00116822,0.00350467,0.00584112,0.00584112,0.00584112,0.00233645,0.00584112,0.0046729,0.00700935,0.00116822,0.0046729,0.00233645,0.00116822,0.00233645,0.00350467,0.00233645,0.00350467,0.0046729,0.00116822,0.00116822,0.00233645,0.00116822,0.00116822,0.00116822,0.00116822,0.00350467,0.0046729,0.00116822,0.00584112,0.00817757,0.00233645,0.00116822,0.0046729,0.00116822,0.00350467,0.010514,0.0140187,0.00350467,0.0046729,0.0221963,0.010514,0.0280374,0.0151869,0.0046729,0.0046729,0.00116822,0.00233645,0.00700935,0.00233645,0.00700935,0.00350467,0.021028,0.0233645,0.00116822,0.00116822,0.00233645,0.00233645,0.00233645,0.00350467,0.00116822,0.0140187,0.00817757,0.00700935,0.00350467,0.0397196,0.00350467,0.0128505,0.00233645,0.00584112,0.00584112,0.00116822,0.00934579,0.00350467,0.00116822,0.0163551,0.00116822,0.00116822,0.0151869,0.0198598,0.00116822,0.00116822,0.00233645,0.00233645,0.0128505,0.00116822,0.00350467,0.00233645,0.00116822,0.00233645,0.00350467,0.0595794,0.00116822,0.00116822,0.00116822,0.0151869,0.00700935,0.00350467,0.0128505,0.00116822,0.00116822,0.00817757,0.00116822,0.00934579,0.0128505,0.00116822,0.00116822,0.0186916,0.00350467,0.0046729,0.0128505,0.00700935,0.0163551,0.0116822,0.00116822,0.00116822,0.00934579,0.00233645,0.00116822,0.0116822,0.00233645,0.010514,0.00116822,0.00116822,0.00233645,0.0151869,0.00116822,0.0116822,0.00817757,0.00350467,0.0046729,0.00116822,0.00233645,0.00584112,0.00584112],"ids":[596,865,826,88,290,540,62,230,780,564,489,976,879,238,752,920,943,652,984,198,379,193,679,662,23,128,493,763,314,517,265,535,514,795,999,463,732,925,327,688,977,613,960,571,717,272,493,108,298,496,829,80,927,768,854,410,526,973,337,961,637,46,854,885,67,935,748,144,146,895,645,795,187,933,379,200,734,421,490,113,886,75,553,760,522,978,893,676,487,778,766,875,157,510,96,786,334,300,672,391,907,458,989,501,147,862,98,18,265,545,757,120,985,809,356,355,557,19,887,296,648,591,265,116,630,7,307,248,841,980,287,955,41,623,879,191,765,378,983,430,190,215,90,842,489,122,353,594,385,307,83,998,27,269,590,237,8,153,591,429,251,125,707,875,15,518,532,176,68,605,123,273,212,804,848,795,114,629,770,134,34,8,819,349,575,702,692,803,422,61,486,364,734,352,838,175,503],"ngrams":["wi","w$","ko","az","nk","os","zi","iz","pu","ki","es","^o","ib","rw","ha","ua","ot","up","rt","gk","ep","le","au","ub","u$","po","lo","ad","l$","mi","re","^l","du","ow","ge","ih","su","^g","r$","wa","yi","t$","pa","mp","^w","lk","in","ak","ip","kr","sk","nu","mu","ca","ac","em","on","el","tn","gg","ut","al","^n","^u","nt","ap","mb","be","or","am","^i","ai","hn","ti","ig","st","rs","ur","um","bu","eg","nj","go","ok","ye","bi","mo","za","om","ru","ab","un","na","s$","ni","is","^r","m$","da","ga","ag","tu","a$","ba","ka","^d","ik","as","kl","ir","ek","im","ri","nd","me","^m","cu","ol","v$","rk","ov","ro","pi","ar","at","sa","nc","n$","id","^t","it","te","ma","aw","ra","ku","yz","la","ii","hm","ya","ta","^f","fa","ed","sl","er","ju","de","hu","ul","ay","si","an","b$","ne","sn","en","ke","ia","ny","ji","ce","k$","zr","pe","^s","lu","^j","ng","^y","eb","^p","h$","i$","ah","do","ja","g$","p$","gu","^a","li","se","rd","aj","gi","di","ks","^k","^b","uk","et","pn","^$","il","us"],"ngram_size":2,"dimension":1000},{"language":"id","weights":[0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00315457,0.00315457,0.00157729,0.00315457,0.00315457,0.00315457,0.00315457,0.00157729,0.00157729,0.00473186,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00315457,0.00315457,0.00315457,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.0236593,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00473186,0.00157729,0.00946372,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00788643,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00315457,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.011041,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00473186,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00473186,0.00157729,0.00315457,0.00157729,0.00315457,0.00315457,0.00315457,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00630915,0.00157729,0.00946372,0.00157729,0.00157729,0.00630915,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00315457,0.00315457,0.00157729,0.00157729,0.00315457,0.00315457,0.00157729,0.00157729,0.00315457,0.00157729,0.00946372,0.00315457,0.00157729,0.00157729,0.00157729,0.00473186,0.00157729,0.00157729,0.00157729,0.00157729,0.00630915,0.00157729,0.00315457,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00157729,0.00315457,0.00157729,0.00157729,0.00315457],"ids":[2279,159,3545,2582,1737,2643,1705,66,2321,3336,470,4825,3802,1323,1824,519,1683,1520,2371,1215,3885,210,3354,2529,1287,1358,2916,4970,4224,4249,178,4505,1400,2534,4474,2582,2905,414,2278,3325,2090,2696,54,1988,684,892,2126,3299,2707,2807,84,504,161,147,500,3247,4651,3515,3951,1568,1749,2452,3366,2011,3860,3491,573,3236,817,2543,2586,945,99,3477,2330,4062,1852,3529,253,4708,4004,4864,2841,4320,2523,3638,2160,4320,4905,1049,1573,4144,2955,4483,4421,2857,4394,957,3791,4141,3412,4371,4672,4854,1592,3425,386,1444,964,76,2143,731,1447,3088,1284,1666,2534,564,3029,2982,4497,1437,2045,774,1046,2133,3635,1925,1638,3635,2410,1148,1776,3591,4231,2865,2169,4569,3169,240,2132,2912,3095,4805,4173,160,872,2235,1855,4893,146,4243,3703,956,4156,1873,2992,724,1829,2764,1790,4456,3928,106,4724,1459,2542,1467,103,4393,1292,220,51,342,937,937,2123,3926,125,4676,2892,4819,831,747,4458,626,1870,4998,3709,4139,3053,91,688,3229,4437,998,4065,1000,4734,1037,738,3458,3668,4657,4164,269,4862,53,1573,1854,4649,1284,76,141,987,269,3327,2246,2059,1837,1599,2918,3093,761,3735,4470,1192,1762,4576,3172,1394,2236,100,2712,1892,2082,4342,4661,80,1019,3729,268,1733,4415,2103,445,1482,3899,1589,3811,3468,4306,3766,3914,4040,4696,1862,3472,624,4647,411,4517,3878,1367,692,993,3748,2025,3724,1827,2232,2201,643,3758,3090,1815,1932,628,3336,4600,2174,2874,3313,243,1733,1983,3634,1443,4626,3309,783,4138,826,2739,3079,3625,884,2537,4098,1439,1068,4862,3115,2100,2320,3712,2403,4012,3320,1820,2634,1352,3179,2888,1686,3822,2997,3034,1262,5,3276,1283,1738,4272,3116,3267,2442,2785,1592,789,656,1153,3007,4439,4104,3112,31,3351,1285,3288,4660,2596,1300,2236,69,316,1658,304,3098,4651,725,3424,554,251,1819,1164,2603,1978,4252,1663,3273,4721,2694,286,2808,4724,3294,2420,4537,1779,1294,2952,4634,4264,173,4305,2087,1515,4120,315,135,3719,2098,997,1685,4568,2662,4970,1008,1959,2222,2108,1241,3614,613,782,2719,4916,4607,4456,2727,2,2709,4328,2622,3745,511,137,1389,2319,3351,4163,4188,1490,4284,1332,3471,900,296,3852,550,3167,4501,3069,1715,4547,3854,3130,3196,1222,3911,1679,1269,110,1639,3188,4416,4551,1367,524,4438,4349,2116,1848,2057,458,2153,4261,37,1162,2803,4677,4561,2153,1277,3505,2007,2333,2883,2747,4398,3150,474,4576,1557,94,4036,1728,353,704,4366,1144,1165,3558,3327,3420,3100],"ngrams":["arst","^tat","yah$","ilay","wila","upak","rupa","erup","skow","osko","mosk","^tim","eter","mete","lome","ilom","kilo","itar","kita","rada","erad","kaza","^kaz","^tua","oran","ngan","meru","^den","inka","zink","iizi","diiz","^dii","kah$","akah","apak","^apa","skan","uska","utus","emut","jutn","gan$","njut","lanj","elan","sela","^sel","giat","ilan","temp","^ana","uka$","san$","taro","rasa","rsta","ahma","kera","eker","^kil","^ula","unyi","^kek","omet","ngga","dak$","^lan","ekar","ndak","ulam","tind","tua$","rdir","dany","ubar","adan","lisi","beru","^pol","mutu","pun$","nak$","ipun","skip","^mes","ence","gkap","nang","arov","enan","belu","^bel","hak$","^pih","usia","seka","^del","igai","^sek","mpai","^sam","ampa","keke","^di$","alka","endi","^ata","rimi","encu","^med","^ile","eski","eka$","tuan","kipu","bant","gamb","poli","ari$","ajib","ncar","^ban","enca","azan","tany","otan","ggot","sar$","angg","berd","^ang","gah$","berw","stan","^tet","nceg","erti","pert","eper","ngka","^sep","egal","curi","samp","ileg","engi","cari","iata","tusk","egia","kegi","elak","mela","^mel","^ora","tap$","pan$","etap","teta","ntua","kala","ebag","buba","^aka","atau","yata","nyat","pada","enya","itu$","erse","embu","^itu","lega","doro","ompo","emba","ukan","lomp","kelo","urus","^das","^pad","yian","nal$","mina","imin","dung","atan","kan$","krim","^kal","dela","^kri","asus","piha","kasu","^kas","idik","pai$","lum$","lidi","izin","rang","cega","peny","jib$","aksa","medi","engu","nggo","rkan","ntai","jaks","laku","sus$","atak","rsem","dido","reka","^mer","tai$","^men","apan","elap","bany","elid","umah","riga","erek","akan","edun","wah$","inal","ahun","^ged","ngad","edis","lara","^tan","nyak","asar","dasa","yeli","^ada","ingg","^baw","anju","erus","nusk","buny","anya","pers","akuk","ggal","^per","mesk","gedu","nah$","mend","ning","ian$","hun$","hman","enin","uskr","dila","lan$","yaka","elom","yzra","eban","keba","ada$","etel","pena","ipny","anus","^dil","pok$","^kel","sia$","aca$","isi$","bawa","krip","mbac","baca","egah","memb","manu","hnya","oron","gadi","sika","idor","lkan","urig","^tem","utny","ung$","giku","mbuk","ksa$","^an$","ripn","galk","ting","nya$","^keb","dis$","ama$","lapa","buka","lama","sete","enga","kutn","inda","imur","tan$","ahny","ntan","meny","mant","^man","menc","mbar","lau$","timu","ikut","tars","isla","pnya","awah","nega","seki","amba","nyel","^neg","^yan","ekit","^dig","^sat","eras","lant","mahn","tata","aran","skri","mpat","sepe","egar","tela","empa","man$","mbun","rong","dan$","erwa","^dan","erdi","diri","igam","zrah","^nab","agai","pat$","ekla","memu","ara$","mpok","asik","^rum","baga","taka","mere","^jak","lam$","^tah","^isl","zan$","seba","^mos","alau","^dir","rasi","bark","elah","^seb","dekl","olis","ndek","kapa","ende","^keg","meni","ikan","mur$","ncur","uan$","tana","^tin","ayah","laya","antu","peng","rahm","angk","ong$","enye","guru","yang","gai$","mbub","^pen","rusn","anah","^ber","ayzr","ihak","^fay","kara","ndid","diga","arka","rti$","lah$","ilar","^wil","anak","ngur","fayz","nyia","paka","anta","aras","nkan","tahu","slam","abi$","tau$","gal$","kow$","ang$","rov$","semb","tar$","rusi","atar","asan","snya","usny","pend","^mem","waji","kuka","gara","gota","tnya","^set","^did","rwaj","didi","ruma","klar","bera","adil","iri$","elum","ngik","deng","sata","ter$","nabi","dika"],"ngram_size":4,"dimension":5000},{"language":"id","weights":[0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00537634,0.00134409,0.00134409,0.00134409,0.00134409,0.00537634,0.00134409,0.00134409,0.00134409,0.00134409,0.00806452,0.00134409,0.00134409,0.00134409,0.00537634,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00403226,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00403226,0.00403226,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00403226,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00403226,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00672043,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00672043,0.00134409,0.00403226,0.00672043,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00403226,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00268817,0.00268817,0.00134409,0.00134409,0.0107527,0.00268817,0.00134409,0.00134409,0.00134409,0.0094086,0.00268817,0.00134409,0.00403226,0.00134409,0.00268817,0.00268817,0.00403226,0.00403226,0.00134409,0.00537634,0.00268817,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00403226,0.00403226,0.00403226,0.00134409,0.00134409,0.00134409,0.00134409,0.00537634,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00268817,0.00268817,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00268817,0.00134409,0.00268817,0.00134409,0.00134409,0.00403226,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00268817,0.00134409,0.00134409,0.00403226,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00672043,0.00806452,0.00134409,0.00403226,0.00134409,0.00134409,0.00403226,0.00403226,0.00134409,0.00403226,0.00134409,0.00134409,0.00268817,0.00268817,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00268817,0.00134409,0.00268817,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00537634,0.00268817,0.00134409,0.00268817,0.00268817,0.00134409,0.00403226,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00672043,0.00134409,0.00134409,0.00268817,0.00403226,0.00403226,0.00268817,0.00134409,0.00403226,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.0201613,0.00134409,0.00268817,0.00403226,0.00134409,0.00268817,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00268817,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00268817,0.00537634,0.00268817,0.0120968,0.00134409,0.00134409,0.00268817,0.00403226,0.00403226,0.00403226,0.0094086,0.00134409,0.00134409,0.00134409,0.00134409,0.00537634,0.00134409,0.00134409,0.0094086,0.00134409,0.00134409,0.00268817,0.00268817,0.00134409,0.00134409,0.00268817,0.00403226,0.00537634,0.00134409,0.00134409,0.00134409,0.00403226,0.00537634,0.00134409,0.00134409,0.00268817,0.00134409,0.00403226,0.00134409,0.00134409,0.00134409,0.00134409,0.0416667,0.00134409,0.0228495,0.00403226,0.00134409,0.00268817,0.00134409,0.00268817,0.00806452,0.00268817,0.0107527,0.00403226,0.00134409,0.00537634,0.00806452,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00537634,0.00537634,0.00268817,0.00134409,0.00134409,0.00134409,0.00268817,0.00672043,0.00134409,0.00134409,0.00268817,0.00806452,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.00268817,0.00268817,0.00134409,0.00806452,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00268817,0.00134409,0.00134409,0.00134409,0.0107527,0.00134409,0.00134409,0.00134409,0.00134409,0.00134409,0.00403226,0.00134409],"ids":[1190,3247,814,4839,261,4597,796,1174,4127,319,4024,2179,3619,3552,3797,2612,4562,3625,3121,1558,3428,2389,3313,318,4438,1163,4511,52,1848,4543,2983,194,2180,3603,2477,4975,1280,552,3635,592,4983,587,1440,2644,4229,16,3374,4743,2629,504,1493,2329,3849,295,2595,275,4102,2270,1964,3014,1078,3319,1162,4714,2747,3454,4823,705,3124,3896,4521,323,4770,62,2110,4446,3148,4378,1572,2908,2288,4978,3829,3931,1495,4341,1618,977,4486,607,301,3383,248,4016,1711,4763,1342,3120,870,1962,3695,3029,234,2479,3848,1455,1886,723,4995,1760,4729,2980,784,1732,3318,2667,791,3613,4162,2610,780,16,4194,3983,56,3165,3841,3804,4285,2816,2696,4311,141,4731,1680,1221,2151,1672,1582,1486,1221,399,2042,2683,3271,1103,2272,1987,3899,442,4814,337,1302,1616,3807,2722,1002,1341,1848,2441,343,1357,1776,4108,3932,524,1168,3206,2172,4529,1111,2365,915,4120,4589,4501,3017,1536,1852,3302,4689,1875,4483,1267,2624,3113,2143,4017,4527,611,3357,1494,2518,2224,4330,1755,2268,2242,4301,1448,85,4881,3299,3483,4779,1337,796,243,3701,2691,3881,117,1232,1628,4427,1960,442,947,16,3332,3859,2483,1594,4150,2403,3333,1468,553,4963,813,4802,3368,1892,2544,3897,2388,4074,4248,3052,2959,2481,75,2176,2387,605,367,3629,1674,996,4921,834,61,425,1756,3402,3060,2438,415,1027,1400,3534,114,2796,2606,1057,2890,3214,217,3757,2030,138,1628,4257,4599,2537,1374,1737,3107,2436,2924,1537,2785,490,1936,374,4800,1365,2350,2110,2204,1942,3839,1734,4718,4272,3938,4374,378,582,681,4630,638,3334,4699,3781,2372,3903,1029,1544,660,3194,360,1095,4381,4167,1569,3915,1749,4530,2080,1794,4942,4265,4063,875,562,2189,2101,1627,2378,908,2527,4356,4513,1423,4721,2841,1344,1167,4155,2355,2649,980,3209,3465,3239,4337,1745,1849,3082,4092,1597,4511,2241,1121,3606,2887,4388,1589,3538,4388,3187,2312,3302,2423,2120,2861,280,4424,1128,4535,1944,2260,4324,1610,3239,3407,4026,3623,3310,3566,2344,1621,2278,2597,1948,3444,715,4200,2380,1829,3144,3643,4872,3365,4972,3711,4411,550,1674,3843,810,405,2892,4373,553],"ngrams":["rst","tat","yah","aya","^wi","kow","sko","^da","mur","er$","ter","kil","dan","^ki","rad","aza","den","pen","^tu","ndi","ow$","eng","nka","izi","sel","iiz","dii","kah","utu","jut","upa","enc","osk","nju","gad","nga","zan","yan","nak","san","era","ker","kek","sa$","eke","ita","dak","tin","at$","gal","^ja","^ad","nin","uri","ncu","si$","ere","ngk","^po","ipu","kaz","ski","^sa","idi","esk","ind","mes","gka","sek","nan","lum","mut","uma","elu","gam","imu","bel","^ke","ib$","ov$","wah","yia","kit","^an","erw","ngg","ak$","iha","adi","skr","pih","wil","bi$","kar","nda","tet","pai","^pi","tau","ome","edi","med","uan","tua","ia$","ntu","aji","ari","ant","awa","car","ota","gah","ti$","sep","kuk","eki","leg","lar","ilo","ile","pol","iat","egi","asu","del","keg","aku","waj","lis","lak","ap$","ala","bub","ang","omp","tak","^it","itu","^pe","pok","tus","lom","nab","elo","kel","da$","^ti","ena","ada","^pa","nal","ina","usk","imi","^kr","kas","dik","^at","pun","jib","eny","buk","jak","pak","dis","aks","tim","eka","mer","apa","bun","gar","lap","dor","gai","aca","nyi","sar","edu","mpo","ged","dir","ok$","ama","^ul","^ge","ar$","zin","is$","ggo","eta","ido","asa","gan","di$","rah","kap","^ya","nah","baw","hma","mpa","ska","^ba","ian","tu$","mbu","sem","rse","ers","nye","pat","sam","nce","ela","ai$","tem","^te","alk","emu","al$","ran","met","ila","ars","hny","dil","ete","rum","ban","mos","rwa","abi","keb","lay","ipn","kri","min","bar","bac","rka","nta","^la","anu","^mo","ur$","neg","am$","ca$","ron","ber","did","ung","utn","gga","kut","uka","iku","mel","ma$","emp","ert","ahn","^de","tan","das","kal","end","ka$","any","per","tai","lan","rti","pad","ua$","got","gia","ula","pny","kan","rdi","^ma","man","gur","ark","uny","isi","pan","epe","sny","gik","oro","mba","iga","mah","sla","sta","ekl","ngu","oli","isl","ahu","mem","^is","nya","ink","ong","iri","ega","un$","aga","^di","ksa","dig","^na","ahm","ara","nca","ngi","ya$","rip","us$","^ak","rov","cur","sus","sat","bag","eba","rig","amb","yat","seb","emb","asi","kla","rek","anj","ika","dek","^il","uba","^ne","an$","eli","^me","^ka","ra$","ing","^or","ras","men","aro","^se","ri$","tel","tar","ata","erd","zra","yzr","nus","fay","^ta","ana","tah","rim","usn","^fa","tap","^be","hak","usi","tny","aka","yak","um$","lah","hun","rup","ayz","lid","rus","au$","kip","ah$","uru","ceg","dun","lau","eni","amp","eru","^ru","yel","lka","ng$","sik","sia","set","^ap","ora","lam","nde"],"ngram_size":3,"dimension":5000},{"language":"id","weights":[0.00309917,0.00413223,0.0402893,0.0340909,0.0847107,0.0165289,0.0299587,0.0258264,0.00206612,0.0247934,0.0144628,0.0113636,0.0495868,0.115702,0.160124,0.00413223,0.053719,0.0630165,0.0278926,0.035124,0.0299587,0.0196281,0.115702,0.00309917,0.00103306,0.0299587],"ids":[5,58,0,21,20,65,88,2,57,77,22,63,19,52,96,32,66,79,0,24,59,11,68,86,22,44],"ngrams":["j","c","m","t","n","y","g","l","v","p","o","h","k","^","a","w","i","e","d","r","u","b","$","z","f","s"],"ngram_size":1,"dimension":100},{"language":"ig","weights":[0.00239808,0.00239808,0.00239808,0.00239808,0.00239808,0.00239808,0.00239808,0.00479616,0.00239808,0.00239808,0.00239808,0.00479616,0.00239808,0.00719424,0.00239808,0.00239808,0.00239808,0.00239808,0.00239808,0.00479616,0.00479616,0.00479616,0.00239808,0.00239808,0.00239808,0.00239808,0.00239808,0.00239808,0.00239808,0.00239808,0.00479616,0.0311751,0.00479616,0.00719424,0.00719424,0.00239808,0.00239808,0.00239808,0.00959233,0.00479616,0.00239808,0.00719424,0.00239808,0.00239808,0.00719424,0.00479616,0.00479616,0.00239808,0.00239808,0.0119904,0.00239808,0.00479616,0.00239808,0.00239808,0.0431655,0.00959233,0.00959233,0.0143885,0.0191847,0.00479616,0.00239808,0.00479616,0.00479616,0.00239808,0.00959233,0.00239808,0.0119904,0.00959233,0.00719424,0.00719424,0.00239808,0.00239808,0.00239808,0.00239808,0.00959233,0.00239808,0.00719424,0.00479616,0.00239808,0.00719424,0.00239808,0.00239808,0.00479616,0.00239808,0.00479616,0.00479616,0.00479616,0.00239808,0.00239808,0.00239808,0.00479616,0.0167866,0.00479616,0.0191847,0.0167866,0.0119904,0.00479616,0.00479616,0.00239808,0.00959233,0.00959233,0.00719424,0.00239808,0.00239808,0.0167866,0.00959233,0.0119904,0.00239808,0.00479616,0.00239808,0.00239808,0.00239808,0.00239808,0.00959233,0.00479616,0.00959233,0.00479616,0.00239808,0.00719424,0.0551559,0.00959233,0.00239808,0.00239808,0.0143885,0.0167866,0.00479616,0.00959233,0.00959233,0.028777,0.00719424,0.0143885,0.00239808,0.00719424,0.0215827,0.00239808,0.0215827,0.0143885,0.00719424,0.0119904,0.00239808,0.00479616,0.00959233,0.00239808,0.0263789,0.00959233,0.00479616],"ids":[822,18,463,10,0,114,147,862,7,662,522,251,526,574,379,717,96,384,951,634,212,804,601,27,532,874,745,618,943,386,637,854,46,885,446,895,795,271,280,300,672,68,605,538,656,112,879,466,882,41,287,265,904,656,651,575,269,591,476,429,392,379,933,96,786,120,809,356,985,803,290,307,594,404,123,200,741,116,118,248,54,648,99,146,144,35,183,233,154,364,267,355,343,581,486,712,61,108,512,532,330,153,125,518,481,493,975,766,487,122,815,240,215,190,254,23,200,685,458,989,237,345,545,757,752,353,157,976,8,291,848,780,528,795,970,339,35,531,645,353,591,378,204,657,270,838],"ngrams":["aa","as","ih","ie","oc","do","ka","^d","sa","yị","ye","ny","on","pụ","ep","^w","s�","ns","w�","ụk","^p","h$","ho","si","^s","ụ�","ug","ụz","ot","nị","ut","^n","al","^u","ụt","am","ai","sm","tụ","m$","da","^j","y$","^ụ","bo","p�","ra","ty","wụ","ma","it","re","ụl","hw","e$","^e","an","ke","^c","ia","ud","ig","ti","ni","is","im","nd","me","ri","di","nk","hu","ju","ec","^y","kụ","nw","ar","�r","n$","ịa","ov","hr","or","be","dị","he","mg","wu","uk","eh","^m","�t","�$","^b","we","^k","ak","ic","o$","ị$","en","ji","pe","hi","in","^�","ab","om","sl","hụ","ï$","ta","ya","z�","u$","st","je","tu","a$","ne","�z","ir","ek","ha","er","na","^o","^a","kw","i$","va","kp","ah","dï","ụ$","bụ","ee","^i","^h","ro","la","bị","ch","gb","^$"],"ngram_size":2,"dimension":1000},{"language":"ig","weights":[0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00816326,0.00816326,0.00816326,0.00408163,0.00408163,0.00408163,0.00816326,0.00408163,0.00408163,0.00408163,0.0244898,0.00408163,0.00408163,0.00816326,0.00408163,0.00408163,0.00408163,0.00816326,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00816326,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00816326,0.00816326,0.00408163,0.00816326,0.0163265,0.00408163,0.00408163,0.00816326,0.00408163,0.00408163,0.00408163,0.00816326,0.00408163,0.0122449,0.00408163,0.0122449,0.00408163,0.00408163,0.00816326,0.00408163,0.00816326,0.00408163,0.0163265,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.0204082,0.00408163,0.00408163,0.00816326,0.00816326,0.00408163,0.00408163,0.00816326,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.0204082,0.00408163,0.00816326,0.00408163,0.00408163,0.00408163,0.00816326,0.00408163,0.00408163,0.0204082,0.00816326,0.00816326,0.00408163,0.00408163,0.00408163,0.00408163,0.0163265,0.00816326,0.00408163,0.00408163,0.0163265,0.00408163,0.00816326,0.00816326,0.00408163,0.00408163,0.0122449,0.00408163,0.00408163,0.0244898,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.00408163,0.0163265,0.00816326],"ids":[18,688,3890,2340,4751,62,1383,3216,4069,4362,2620,1272,244,4848,3215,4956,3593,1408,704,4,884,3770,1708,1853,1517,402,3616,4249,1063,4471,1072,3645,2885,1682,4816,4898,2326,860,4282,2299,651,3862,3289,2558,4093,125,37,2244,3636,2905,3748,1601,3552,3001,4132,2365,3878,694,4335,3410,938,2890,4788,4735,2678,2485,4427,2101,4858,3104,3183,2077,3561,4322,4058,1520,1478,1421,3674,1461,4896,4009,358,3141,396,3102,1688,4458,2683,16,4046,4860,1073,4436,1685,4438,1882,1564,1566,1239,3896,810,4439,2879,4975,2827,306,4223,2952,4156,2798,4842,3083,4898,1383,940,964,252,1256,215,2247,4834,2344,4142,1885,4344,4071,3711,4814,795,3047,809,1785,4683,3877,1164,1375,3794,3631,2620,3397,2099,2287,1179,3941,1765,702,841,3943,3719,315,634,1914,2284,4485,3353,1133,1144,1409,3329,846,3451,3916,2523,1474,2213,3952,873,374,2159,1666,186,387,4944,3042,801,1741],"ngrams":["pụkụ","^pụk","gbor","^dị$","ụkụ$","^ihe","^ime","pụta","chie","doch","^doc","anyị","^any","^ugb","nwe$","yenw","enwe","nyen","iri$","pụla","wepụ","^ns�","epụl","ụkw�","kwụk","akwụ","^jir","^na$","weh$","ahwe","yahw","^yah","ovah","hova","ehov","^jeh","oro$","akp�","^akp","^asa","^si$","bụ�$","abụ�","^abụ","ụz�$","^ụz�","otu$","jeho","^otu","hie$","anị$","nanị","udai","^utu","chri","tụtụ","ian$","nwer","ugbo","^nwe","ism$","were","aism","aha$","dais","juda","ụtụ$","^nan","^jud","ity$","ere$","pere","ekee","chi$","ekpe","^pụt","che$","utu$","hich","ns�$","^nke","chic","ihe$","echi","hweh","kp�$","ịara","anit","^ech","nyị$","^�tụ","tian","^ekp","stia","chin","slam","kw�$","isti","^wep","^�z�","iche","rist","isla","ndi$","mee$","^ndi","nke$","^ha$","ara$","ahụ$","�tụt","^bịa","hine","kee$","^ndị","hukw","ndị$","vah$","^mgb","kwu$","chuk","kper","^chu","wee$","^bụ$","nity","�ro$","omen","^igb","beke","onye","gbo$","kp�r","^kp�","tara","mgbe","jiri","^ma$","ukwu","ala$","bịar","^akw","iani","mena","nwee","ụla$","^chi","^chr","nala","^isl","lam$","asaa","boro","neke","^ome","ochi","^ndï","inek","�z�$","igbo","hris","ụtar","^ony","^ya$","^bek","^mee","^aha","ime$","wụkw","ndï$","p�ro","^ka$","^ahụ","gbe$","saa$","eke$","enal"],"ngram_size":4,"dimension":5000},{"language":"ig","weights":[0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.00606061,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.0030303,0.0030303,0.0151515,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00909091,0.0030303,0.00606061,0.0030303,0.00606061,0.0030303,0.00909091,0.0030303,0.00606061,0.0030303,0.00606061,0.00606061,0.00606061,0.0030303,0.0121212,0.00909091,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0151515,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.00606061,0.0030303,0.0030303,0.00606061,0.0030303,0.0151515,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0151515,0.0030303,0.0030303,0.0030303,0.00606061,0.00606061,0.0121212,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.00909091,0.0030303,0.0151515,0.00606061,0.0030303,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0151515,0.00606061,0.0030303,0.00606061,0.00606061,0.0030303,0.0212121,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0242424,0.0030303,0.00606061,0.0181818,0.00606061,0.00606061,0.0030303,0.0121212,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.00909091,0.00909091,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.00909091,0.0030303,0.00606061,0.00606061,0.00606061,0.0030303,0.0212121,0.0030303,0.0030303,0.00606061,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0212121,0.00909091,0.0030303,0.0121212,0.0030303,0.0151515],"ids":[77,282,3039,2289,3454,3082,1849,3817,177,4205,623,1589,2003,4867,2914,2375,2799,2224,84,3931,4989,1239,2768,1566,396,2523,1689,2169,117,2626,3702,1881,2644,4866,4000,2371,3455,2640,1570,4102,1118,2887,1960,4673,2734,2030,844,2073,4362,274,4300,3657,4093,2746,1936,2259,1233,3584,1119,4326,3115,4873,4079,4009,3930,1149,697,2211,1152,4677,3983,275,98,1755,4180,4530,2152,2019,1858,796,57,4012,3374,4581,4743,2959,1051,3488,1888,2744,996,1159,2612,4373,3412,1443,2675,378,3334,2372,4718,1823,3534,2167,660,1352,446,3915,1859,3475,738,3899,706,504,2980,2596,875,3969,4229,927,4261,127,4670,2126,3265,2560,138,2451,2870,4221,4301,987,1745,3239,1628,2596,4399,4942,1099,466,4040,715,369,2976,3487,247,3895,1091,2518,748,2260,2241,3092,1380,4348,4853,821,3896,267,1072,90,747,1136,2115,4697,3414,1337,1231,469,807,3875,2853,169,1293,141,1558,1826,1728,3896,4104,4608,4236,4032,4024,3123,337,2964,1962,2687,638,3498,3341,1848,3944,1822,4439,3010,1941,2047,3508,2034,814,308,1554,2398],"ngrams":["saa","kụ$","ụkụ","pụk","ugb","ra$","^ka","sm$","jir","^dị","me$","tar","ụta","^ig","^pụ","sti","ie$","asa","bụ�","^an","hie","doc","yị$","anị","nyị","ime","we$","enw","nye","^do","ony","^on","^ji","ns�","^ns","kw�","epụ","^im","kwụ","ere","ism","ri$","akw","na$","^e$","ka$","bek","^ug","^ab","eh$","^�$","vah","wụk","eho","^ma","bor","jeh","^je","^we","mgb","pụt","ụtụ","ụkw","ova","hụ$","nke","dị$","hri","ahụ","ihe","ụla","si$","ụ�$","di$","^ụz","ara","otu","ris","wee","tu$","och","^ut","^ot","tụt","�tụ","^�t","wer","hin","nwe","^nw","am$","mee","abụ","lam","huk","che","s�$","sla","isl","^is","oro","tụ$","ma$","dï$","iri","p�r","dai","^na","akp","�ro","jud","ena","ani","re$","kpe","^nk","^ak","^ek","eke","be$","hic","nị$","p�$","ndị","ke$","^ec","any","bịa","^n$","igb","^ya","ais","^me","an$","per","^as","tia","ya$","hi$","^bụ","he$","ah$","kp�","^ha","ity","^ih","weh","ịar","^nd","ro$","^be","men","chr","ech","ha$","�z�","pụl","nit","wu$","hov","ekp","ụz�","^ch","chu","ist","aha","ian","z�$","wep","nek","ich","^kp","gbe","hwe","ala","ndi","gbo","kee","nan","^mg","^bị","bo$","w�$","ee$","ndï","nal","^om","ome","ahw","chi","^si","ty$","utu","^�z","yen","aa$","ukw","^ju","uda","^ah","la$","yah","ine","kwu","bụ$"],"ngram_size":3,"dimension":5000},{"language":"ig","weights":[0.00595238,0.0138889,0.00992064,0.047619,0.015873,0.0178571,0.0119048,0.00793651,0.0238095,0.00198413,0.0238095,0.0178571,0.0218254,0.0138889,0.0496032,0.0238095,0.00198413,0.00793651,0.172619,0.0277778,0.0218254,0.047619,0.015873,0.0714286,0.0218254,0.093254,0.172619,0.00396825,0.0337302],"ids":[5,44,17,66,32,24,77,88,0,38,17,59,21,65,20,11,57,2,52,19,22,63,0,79,58,96,68,86,13],"ngrams":["j","s","ị","i","w","r","p","g","m","ï","�","u","t","y","n","b","v","l","^","k","o","h","d","e","c","a","$","z","ụ"],"ngram_size":1,"dimension":100},{"language":"is","weights":[0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.026738,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.0106952,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.026738,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.0106952,0.00534759,0.00534759,0.0213904,0.00534759,0.00534759,0.00534759,0.0106952,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.0160428,0.00534759,0.00534759,0.0160428,0.00534759,0.0160428,0.0106952,0.0106952,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.0213904,0.0160428,0.0106952,0.0374332,0.0160428,0.0213904,0.00534759,0.0213904,0.00534759,0.0160428,0.00534759,0.00534759,0.00534759,0.0320856,0.00534759,0.00534759,0.0106952,0.00534759,0.0427807,0.00534759,0.0320856,0.0106952,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.0213904,0.0106952,0.0320856],"ids":[191,943,403,458,496,353,907,287,41,996,591,285,153,786,510,96,391,300,672,7,575,134,34,879,319,838,352,273,744,327,109,535,841,75,886,646,826,532,490,200,421,629,770,925,652,885,854,885,309,288,486,809,501,605,384,493,27,734,478,403,937,857,745,194,960,379,679,839,922,96,181,829,98,730,277,591,248,989,173,18,174,895,146,568,976,875,157,269,215,848,795,347,961,989,237,193,754,61,486,613,287,598,349,8,878,116],"ngrams":["ku","ot","no","fi","kr","er","ag","it","ma","by","ke","rm","en","is","s$","ni","ga","m$","da","sa","^e","p$","gu","ra","ár","^$","pn","ög","gö","r$","rl","^l","ít","æð","eg","^í","ko","^s","um","st","ur","ja","g$","^g","up","tk","^n","^u","gj","þi","óp","nd","hó","ng","ns","in","si","ös","ð$","mk","og","lý","ug","^þ","pa","ep","au","væ","kv","^á","yg","sk","ik","oð","ýs","ro","n$","gl","ei","ða","rð","am","or","nn","^o","un","na","an","ta","i$","ah","pp","gg","a$","ne","le","af","^k","^b","t$","fk","kö","se","^a","gn","ar"],"ngram_size":2,"dimension":1000},{"language":"is","weights":[0.0150376,0.0150376,0.037594,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.037594,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0225564,0.0075188,0.0075188,0.0075188,0.0300752,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0300752,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.037594,0.0075188,0.0150376,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0300752,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.037594,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188],"ids":[758,4852,3496,2695,3781,2811,2466,2306,4440,4702,4192,3862,1520,2713,10,1901,863,675,941,1530,1180,638,443,4371,4159,1650,789,1269,3559,1235,4081,512,997,1637,573,4310,53,1575,748,2246,2823,4159,1188,3835,1855,4610,3703,1387,4320,267,500,237,4910,4720,1082,3727,1082,1255,381,4117,1452,4164,880,1603,2969,2564,821,2307,3591,2265,1527,1115,4598,660,2655,3203,4548,3456,2926,2333,3879,1505,1865,308,3993,4495,4341,2628,2598,2097,290,4767,2915,587,4164,2506,2420,1838,1186],"ngrams":["augl","^aug","leit","otku","notk","^kra","magn","rmag","arma","áran","tarm","ýsen","itar","pni$","ppni","enda","kepp","mkep","kun$","amke","^er$","samk","^nei","^sam","rafi","eins","gur$","ngur","angu","lýse","send","^ára","^um$","leg$","tarl","gögn","^sko","ítar","ýsin","skoð","afkö","upp$","glýs","eikv","^gög","rleg","^og$","ggja","ins$","bygg","taro","^byg","koða","ópa$","tkun","^ein","gahó","kvæð","ngah","fist","inga","rorð","lýsi","væð$","arle","gja$","köst","ist$","öst$","kraf","eita","ahóp","rða$","nda$","oða$","orð$","ögn$","afis","neik","sing","nna$","hópa","aror","^not","agn$","inna","^upp","^þin","orða","eppn","^íta","^lei","ikvæ","uglý","rang","^afk","fkös","yggj","þinn"],"ngram_size":4,"dimension":5000},{"language":"is","weights":[0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.0251572,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.0314465,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.0125786,0.00628931,0.0125786,0.0251572,0.00628931,0.0314465,0.0314465,0.00628931,0.0314465,0.00628931,0.0251572,0.00628931,0.0377358,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931],"ids":[360,4418,3100,503,759,708,3123,2845,1378,3138,2272,1711,1184,3757,2850,4625,1194,1594,1628,984,3478,4800,3629,4630,1680,565,3623,187,1914,1030,1822,646,2159,450,1162,258,1121,951,796,2911,4602,918,3953,2404,4815,2941,4125,1956,1593,1645,3059,4561,4137,1083,4092,2481,1010,4189,4544,4358,2712,4420,4953,4433,319,3331,2428,1013,4417,3631,3602,2320,2183,634,2413,4091,3613,2756,4476,784,4647,951,4799,788,2213,16,4391,4975,2665,105,945,2722,1589,2957,2216,3271,2017,4673,967,4135,4697,1719,4511,1010,1740,1258,2621,3465,2756,1079,3893,2613,4910,2538],"ngrams":["un$","kun","tku","^no","afi","raf","^er","agn","not","rma","da$","nda","^by","end","sen","ni$","ppn","ran","sam","mke","sin","gur","ur$","ngu","ang","gja","um$","gn$","^gö","upp","eg$","^ár","rle","og$","^sa","koð","aro","ins","sko","^sk","^og","pp$","amk","oða","^up","ja$","inn","ygg","^ít","ggj","ára","ópa","ögn","þin","ing","pa$","ýsi","pni","byg","st$","glý","^au","kra","eik","er$","æð$","^a$","væð","kvæ","ns$","ikv","nei","ugl","fkö","^le","nna","leg","otk","ða$","gah","aug","epp","rða","orð","^ei","ita","eit","nga","lei","kep","ror","^kr","tar","ahó","arm","arl","lýs","na$","^um","öst","ist","^þi","ýse","afk","fis","kös","mag","^ne","ein","^af","íta","hóp","rð$","gög"],"ngram_size":3,"dimension":5000},{"language":"is","weights":[0.00465116,0.0139535,0.00465116,0.00465116,0.00465116,0.00465116,0.0232558,0.00930233,0.0604651,0.00465116,0.0372093,0.00465116,0.027907,0.00465116,0.0418605,0.055814,0.102326,0.00465116,0.00465116,0.0418605,0.0651163,0.130233,0.027907,0.0325581,0.00930233,0.00930233,0.0511628,0.00465116,0.0511628,0.027907,0.130233],"ids":[0,0,54,5,65,11,77,62,88,27,2,57,59,65,21,20,96,99,63,22,24,52,19,44,22,28,79,11,66,67,68],"ngrams":["d","m","í","j","á","b","p","ý","g","æ","l","v","u","y","t","n","a","þ","h","o","r","^","k","s","f","ö","e","ó","i","ð","$"],"ngram_size":1,"dimension":100},{"language":"it","weights":[0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.0078125,0.00390625,0.00390625,0.00390625,0.00390625,0.0078125,0.00390625,0.00390625,0.00390625,0.015625,0.00390625,0.00390625,0.0078125,0.00390625,0.0117188,0.0117188,0.00390625,0.0078125,0.0117188,0.00390625,0.0507812,0.0078125,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.015625,0.00390625,0.00390625,0.00390625,0.00390625,0.0195312,0.00390625,0.0078125,0.0117188,0.00390625,0.0117188,0.0078125,0.0078125,0.0078125,0.00390625,0.0117188,0.00390625,0.0078125,0.00390625,0.0078125,0.0117188,0.00390625,0.015625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.0078125,0.015625,0.0078125,0.00390625,0.00390625,0.015625,0.00390625,0.00390625,0.0078125,0.0117188,0.0078125,0.00390625,0.0117188,0.0117188,0.0117188,0.0273438,0.0078125,0.0195312,0.0117188,0.00390625,0.00390625,0.0234375,0.0078125,0.00390625,0.00390625,0.00390625,0.015625,0.03125,0.00390625,0.0117188,0.00390625,0.00390625,0.0117188,0.015625,0.0078125,0.0195312,0.0078125,0.0234375,0.0078125,0.015625,0.015625,0.0078125,0.0078125,0.00390625,0.00390625,0.00390625,0.03125,0.00390625,0.00390625,0.03125],"ids":[327,168,167,364,275,114,402,518,486,727,891,183,410,843,732,994,193,225,568,80,384,339,933,657,630,489,557,651,575,227,878,907,571,748,648,355,972,854,212,62,540,115,205,720,886,535,879,662,963,895,146,976,333,403,682,458,545,512,91,421,200,514,17,215,90,349,819,391,786,265,532,893,487,493,854,885,46,27,915,734,314,973,385,989,237,353,526,637,287,955,41,679,780,484,768,532,7,793,248,307,153,269,960,67,645,848,834,803,8,503,838,985,356,429,476,157,875,862],"ngrams":["r$","à$","tà","vi","tt","do","od","pe","^b","qu","^q","he","em","bb","su","sc","le","ss","nn","nu","ns","ue","ti","ch","at","es","cu","e$","^e","iv","gn","ag","mp","mb","ov","^m","if","ac","^p","zi","os","bl","ev","co","eg","^l","ra","ub","ci","am","or","^o","ll","no","rv","fi","ir","ic","ve","ur","st","du","nz","ta","^f","se","li","ga","is","re","^s","mo","om","in","^n","^u","al","si","io","et","l$","el","de","a$","ne","er","on","ut","it","te","ma","au","pu","rc","ca","o$","sa","to","n$","nc","en","an","pa","nt","^i","i$","br","di","^a","us","^$","ri","me","ia","^c","na","un","^d"],"ngram_size":2,"dimension":1000},{"language":"it","weights":[0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.0114943,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.0229885,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.0172414,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.0114943,0.00574713,0.00574713,0.00574713,0.00574713,0.0114943,0.0114943,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.0172414,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713,0.00574713],"ids":[1739,4971,2857,3681,2270,110,512,3280,2591,2760,2936,4143,4503,1862,4496,3781,1295,3983,2961,2348,653,1809,4081,3535,181,4803,1478,4616,2703,4301,1650,1450,1696,2498,577,4737,1317,3623,1944,1632,2074,2221,268,2428,3422,1370,796,4898,1109,1637,1592,4902,351,2978,2580,1702,3195,497,2317,3127,798,221,2128,4076,1473,3183,4285,1025,1416,3150,1967,4165,3700,3916,3651,743,4034,957,4199,3123,1478,4179,1810,678,4716,1417,1294,4084,2327,3203,2353,1650,945,646,827,937,134,1421,4426,632,1312,4161,260,666,2635,4218,4418,1004,4714,1974,4012,1344,404,2392,2252,4930,1428,4695,775,3336,4152,3450,1213,808,2459,3320,754,4503,4113,32,3085,302,4816,1972,4576,1169,4126,3445,4854,2501,132,4138,52,2353,4809,4950,1502,2442,3164,1487,842,260,4471,1873,4672,4549,1777,3095,3563,2026,1684,934,4249],"ngrams":["amo$","siam","usia","^scu","ità$","atti","natt","^ina","odo$","iodo","riod","erio","peri","^per","eve$","reve","brev","^bre","esto","ques","scus","^que","nte$","rant","uran","dura","che$","inat","^anc","eto$","ueto","nsue","per$","ome$","come","^com","^dur","icat","anch","lica","^ci$","^pub","sere","esse","anno","rven","nno$","suet","eran","caus","^di$","^pac","nuer","ione","^cam","tinu","ento","enti","irca","gne$","pagn","nche","^ess","^esi","onti","ere$","zion","mpag","cate","camp","tent","embr","ico$","cusi","ivit","ubbl","esis","^del","^cir","fico","ific","^cos","^sis","cifi","paci","ate$","lle$","sta$","cost","ale$","rann","cont","erve","gale","^int","lega","^leg","ante","ino$","rca$","uest","cons","vent","inue","sser","bre$","mbre","^con","alle","circ","tema","^ore","iste","sist","uten","^fin","sto$","sten","fino","del$","iamo","blic","ntin","vità","nter","nzio","pubb","nti$","agne","ema$","usa$","ausa","ore$","enzi","nute","anut","^un$","osta","ora$","uera","inte","manu","^le$","onsu","bbli","stem","terv","^man","^all","vemb","tenz","ttiv","one$","^ora","ampa","acif","nto$","egal","tivi","ovem","^cau","^nov","nove"],"ngram_size":4,"dimension":5000},{"language":"it","weights":[0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0186916,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.00934579,0.0046729,0.0140187,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0140187,0.00934579,0.0046729,0.0046729,0.0140187,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0140187,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.0046729,0.0046729,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.00934579,0.0046729,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0140187,0.0140187,0.00934579,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.00934579,0.00934579,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.00934579,0.0046729,0.0046729,0.00934579,0.0186916,0.0046729,0.0046729,0.0046729,0.0046729,0.0046729,0.0186916,0.0046729,0.0046729,0.00934579],"ids":[3663,2032,1610,3687,2892,1412,4307,2564,1193,1708,1486,4786,361,2289,4662,1628,4995,1377,1507,329,725,3836,3263,677,3931,4961,3798,1091,2651,842,67,2704,2617,2659,3564,4446,4046,4894,2660,4040,321,52,1782,4513,3272,1732,1594,1740,1795,582,331,579,4079,2713,356,2887,2744,3299,507,1597,1126,3843,2050,623,207,3518,319,3418,3848,1490,814,1856,4678,3278,891,3613,2845,2892,668,360,2729,1147,1546,4226,504,3173,31,382,2644,1947,4497,2413,3006,3534,3814,1337,1302,4102,210,989,2277,3165,2531,4743,4194,4045,374,3052,4094,4983,4872,3719,3204,1471,1919,4484,4721,1171,605,4814,805,1936,256,2908,1764,4697,1569,2561,3246,702,2427,1353,1057,3939,1052,1168,2837,259,3194,2085,947,2202,3498,2428,1889,1876,3848,1618,503,4696,504,3887,1443,617,2073,1003,3082,1761,4024,4921,4731,1755,3590,2630,579,4534,1962,4381,4972,1442,4449],"ngrams":["mo$","iam","usi","cus","^sc","ci$","ivi","tiv","do$","iod","^pe","rev","sto","ues","^qu","per","ant","ve$","ura","odo","dur","nch","anc","rio","^an","eto","uet","vit","nsu","com","te$","amo","^br","ica","lic","bbl","sse","tti","ess","he$","nno","ann","uer","sue","inu","ti$","ran","esi","ser","sta","gne","ubb","rca","pag","ate","cau","enz","mpa","usa","^or","bre","sia","scu","me$","ove","cam","er$","nat","co$","ico","mbr","cif","pac","^co","ont","leg","agn","ora","cir","un$","ion","con","^ci","^pu","re$","pub","ale","aci","sa$","irc","le$","^le","all","ma$","el$","cos","ina","ere","ino","aus","^fi","del","zio","tin","^al","que","man","cat","ne$","era","amp","ten","eve","lle","ità","nut","emb","int","anu","^pa","ost","^ma","nti","^es","att","ist","ons","vem","nzi","bli","fin","to$","^de","ent","nte","nto","tà$","rve","ega","eri","tem","^du","^si","^a$","ste","^in","ven","est","^no","ta$","gal","erv","che","nue","nov","fic","ra$","sis","ter","ca$","no$","di$","ute","ifi","^un","ema","ome","^di","one","ore","^ca"],"ngram_size":3,"dimension":5000},{"language":"it","weights":[0.0503356,0.0604027,0.0033557,0.00671141,0.0033557,0.0201342,0.0033557,0.057047,0.0167785,0.0302013,0.0134228,0.0369128,0.0134228,0.0302013,0.0302013,0.107383,0.0469799,0.0704698,0.0671141,0.00671141,0.14094,0.0033557,0.0402685,0.14094],"ids":[21,20,12,88,12,0,63,22,77,2,57,24,11,59,0,79,58,66,96,22,68,86,44,52],"ngrams":["t","n","q","g","à","m","h","o","p","l","v","r","b","u","d","e","c","i","a","f","$","z","s","^"],"ngram_size":1,"dimension":100},{"language":"iw","weights":[0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.025974,0.012987,0.012987,0.012987,0.025974,0.025974,0.0519481,0.012987,0.025974,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.025974,0.025974,0.012987,0.012987,0.012987,0.025974,0.012987,0.012987,0.012987,0.025974,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.0649351,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.025974,0.025974],"ids":[35,631,268,207,40,364,672,558,287,693,787,806,530,182,175,808,915,505,712,444,130,780,222,560,962,199,399,481,886,949,158,682,183,408,599,704,874,492,618,533,362,121,369,980,611,205,8,393,6,602,680,915,855,67,341,126,846,672,92,838],"ngrams":["שי","ה�","ן$","ון","בו","שב","חש","ס$","�י","הב","עד","נס","י�","של","^�","הש","י$","ו$","בי","לך","רי","�ח","כנ","ת$","ב$","�$","וב","^ש","ך$","קו","עק","נ�","�$","וך","הע","ה$","הפ","חר","הה","^ה","צה","^ב","פצ","יש","ער","לח","לע","ב�","^ע","רו","דפ","�ת","פו","�נ","^כ","לב","ות","�ו","^ל","^$"],"ngram_size":2,"dimension":1000},{"language":"iw","weights":[0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222,0.0222222],"ids":[4494,2088,3400,1313,3460,3107,1665,1297,3327,1473,2829,3632,4596,4279,2409,949,2608,296,499,1309,2539,4138,842,1640,2220,53,1572,2282,1328,1081,1446,1940,4109,1633,1408,1751,4776,1784,4197,807,3529,1502,3519,177,1470],"ngrams":["^שלך","�ישי","ה�יש","ישי$","^ה�י","שבון","^לחש","הב�י","בי�$","לבי�","שלבי","השלב","^השל","רוך$","ההפצ","חרי$","פצה$","קוב$","�חרי","עקוב","לחשב","^ההפ","^עקו","^�נ�","בון$","^�חר","^�ו$","כנס$","^העד","פות$","^כנס","עדפו","^הב�","^�ת$","שלך$","�נ�$","העדפ","ב�י�","ערוך","�י�$","הפצה","חשבו","דפות","לערו","^לער"],"ngram_size":4,"dimension":5000},{"language":"iw","weights":[0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0333333,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667,0.0166667],"ids":[133,2440,2752,3387,3711,2048,1243,3222,4416,221,2257,2901,3075,2850,3661,2988,3243,2406,1260,425,1283,3991,4396,4890,1728,3401,2326,2197,3032,1547,1975,2482,4391,1647,589,4222,3134,3592,1717,1569,578,2694,3417,2236,2172,1229,2223,3133,326,3428,3818,2032,88,4036,236,964,3405,3266,24],"ngrams":["^ב$","לך$","שלך","שי$","ישי","ה�י","^ה�","ון$","בון","^של","שבו","נס$","וך$","^כנ","�י�","^הב","כנס","ב�י","בי�","י�$","שלב","השל","רי$","^�ו","חרי","�חר","וב$","קוב","פצה","^עק","^הה","עקו","�ו$","לחש","ות$","פות","^�נ","דפו","�יש","^לח","עדפ","^הש","צה$","הב�","^הע","לבי","ערו","�ת$","ההפ","נ�$","^לע","�נ�","חשב","^�ת","רוך","העד","הפצ","^�ח","לער"],"ngram_size":3,"dimension":5000},{"language":"iw","weights":[0.0106383,0.0106383,0.0106383,0.0212766,0.0425532,0.0531915,0.0212766,0.0212766,0.0106383,0.0106383,0.0106383,0.0212766,0.0531915,0.0319149,0.0212766,0.0531915,0.0744681,0.0212766,0.0212766,0.0425532,0.0744681,0.180851,0.180851],"ids":[77,68,18,70,79,67,88,34,89,44,8,81,65,18,61,45,80,52,66,61,37,68,52],"ngrams":["ן","ס","כ","�","ש","י","ח","נ","ק","צ","ד","ר","ו","ע","ת","ב","ה","פ","ך","ל","�","$","^"],"ngram_size":1,"dimension":100},{"language":"ja","weights":[0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0232558,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0232558,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0348837,0.0116279,0.0116279,0.0116279,0.0116279,0.0232558,0.0116279,0.0116279,0.0348837,0.0232558,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0232558,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279],"ids":[758,875,967,293,229,594,385,728,363,839,387,235,240,305,542,926,109,143,353,105,439,400,874,510,616,475,281,428,146,945,507,666,25,350,472,393,985,359,751,783,80,413,12,93,396,643,554,743,982,656,246,855,646,174,838,760,22,676,7,761,867,836,155,818,11,711,108,193,281,120,515,439,435,138,886,508,717],"ngrams":["る�","�る","定�","を設","算を","�予","後�","�今","��","在�","�在","示�","表示","�表","ス�","タス","^タ","�ス","今後","特定","れ�","算�","^�","��","期間","�項","算�","れ�","項目","ステ","��","テ$","��","�ペ","�れ","��","覧�","一覧","カウ","�$","�履","指定","��","を一","�$","��","アカ","予算","�れ","間�","��","定�","ト�","定期","^$","れ�","ント","れ�","ウン","��","ジ�","�指","��","��","設定","歴を","^予","^�","^ア","�特","目�","�れ","�予","ペ$","履歴","^�","^ジ"],"ngram_size":2,"dimension":1000},{"language":"ja","weights":[0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857,0.0142857],"ids":[2531,280,3655,193,1053,761,1508,52,3919,3631,601,3625,4364,4827,2404,1304,2730,4469,1006,2086,811,4250,650,1898,2509,606,1546,2871,2937,1860,3927,761,2638,4448,350,1134,3017,440,4119,3735,4524,1824,2197,4615,3374,2664,3785,4175,1802,2506,662,1374,3146,4813,2302,3111,4381,3944,545,133,4201,4046,4236,3523,4425,3712,1384,3964,278,2818],"ngrams":["定�る�","予算を設","後�予算","今後�予","�今後�","���今","�予算を","れ��$","�れ��","表示�れ","ス�表示","予算��","^予算�","期間�ス","�れ�予","�項目�","在���","^�在�","^ジ��","れ�項目","�れ�項","れ�れ�","�れ�れ","���$","�特定期","タス�表","^�れ�","����","�在��","示�れ�","�ステ$","れ�予算","����","����","る��$","��今後","を一覧�","ジ��$","アカウン","歴を一覧","覧���","�表示�","算�履歴","^タス�","�予算�","を設定�","ント�指","項目��","一覧��","�履歴を","��特定","定�れ�","目��$","�る��","履歴を一","予算�履","算��特","指定�れ","カウント","間�ステ","設定�る","ウント�","�指定�","ト�指定","算を設定","定期間�","^アカウ","��ペ$","特定期間","^��ペ"],"ngram_size":4,"dimension":5000},{"language":"ja","weights":[0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.025974,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.025974,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987],"ids":[2931,3304,244,697,3833,4959,4936,3622,4898,2155,1164,3332,175,179,2100,4795,1127,4287,670,3805,2786,2959,3559,3647,1146,1430,1143,1041,55,1235,2879,3464,4201,163,1864,2302,603,4794,4648,422,573,4119,2968,1312,4469,1959,1500,2132,3827,1867,4147,4395,3585,4444,2072,4314,3156,338,2147,2105,3088,344,3661,4225,3430,75,1947,2311,426,3204,4502,1025,4310,3096,2854],"ngrams":["�る�","を設定","�予算","今後�","�今後","���","定�る","れ��","^�在","�れ�","示�れ","る��","表示�","ス�表","算を設","タス�","^タス","ステ$","��$","�特定","項目�","�予算","^予算","��今","ウント","��特","�れ�","�ステ","れ�れ","�れ�","予算�","間�ス","^�れ","歴を一","���","カウン","定期間","アカウ","���","一覧�","�項目","を一覧","�履歴","覧��","��$","�在�","算�履","^アカ","���","れ�予","�れ�","設定�","目��","���","ト�指","�指定","後�予","��$","期間�","�ペ$","履歴を","指定�","特定期","予算�","予算を","ント�","算��","�表示","定�れ","��ペ","ジ��","れ�項","在��","^ジ�","^��"],"ngram_size":3,"dimension":5000},{"language":"ja","weights":[0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0315789,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0526316,0.0315789,0.0105263,0.0105263,0.0210526,0.0105263,0.0947368,0.0421053,0.0105263,0.0105263,0.0421053,0.0105263,0.0421053,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0315789,0.0105263,0.0105263,0.0105263,0.0315789,0.0315789,0.0105263,0.0210526,0.0947368,0.0210526],"ids":[9,87,79,12,69,40,59,24,80,17,97,20,88,87,0,73,62,93,95,6,30,77,61,70,75,10,11,81,48,90,52,44,18,24,70,24,85,64,31,11,2,97,75,56,45,1,53,13,36,35,68,25],"ngrams":["設","る","今","在","ペ","示","�","表","タ","テ","ウ","ス","間","特","一","�","�","歴","�","目","�","�","�","覧","�","算","�","履","�","ア","^","れ","指","�","�","ン","�","�","期","ト","カ","ジ","予","�","後","項","定","�","�","を","$","�"],"ngram_size":1,"dimension":100},{"language":"jv","weights":[0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0344828,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0344828,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0229885,0.0229885,0.0114943,0.045977,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0229885,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0229885,0.0229885,0.0229885,0.0229885,0.0574713,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943],"ids":[251,248,190,385,518,18,879,191,933,809,605,200,630,489,379,532,553,327,961,215,269,591,157,34,803,501,486,27,46,707,493,532,147,153,10,422,61,116,510,980,8,875,875,862,757,752,564,123,476,421,955,770,848,651,212,108,265,838,314,404,645,98],"ngrams":["ny","n$","ya","de","pe","as","ra","ku","ti","nd","ng","st","at","es","ig","o$","go","r$","gg","ta","an","ke","na","gu","di","ba","^b","si","al","ce","in","^s","ka","en","ie","ks","^k","ar","s$","^t","^a","k$","un","^d","ek","ha","ki","dh","^c","ur","te","g$","i$","e$","^p","ak","pi","^$","l$","ec","^i","ik"],"ngram_size":2,"dimension":1000},{"language":"jv","weights":[0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0327869,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934,0.0163934],"ids":[1588,1503,3766,244,1283,4139,4620,782,3471,3605,1965,496,1284,4199,3187,833,1165,3273,1693,1277,4284,3998,3156,1084,4338,2236,1814,155,3635,3322,2365,4504,1646,544,4568,2155,2171,3614,536,3320,4014,1514,2042,1773,2913,4970,2556,3918,4098,4763,258,299,3189,2333,4258,4510,4483,2774,1573,2916],"ngrams":["yar$","nyar","anya","^any","tan$","atan","deka","ende","^pen","kura","akur","ggo$","nggo","ake$","esti","naka","kake","akal","akak","pend","unak","^kan","eks$","digu","^aku","^dig","baka","kang","angg","teks","guna","ing$","asi$","^sin","^tek","iece","stin","ndek","dhak","ting","^iki","ece$","^cen","endh","^tes","rasi","uras","ekat","igun","kata","^bak","cend","^pie","sing","test","ndha","hak$","iki$","piec","kal$"],"ngram_size":4,"dimension":5000},{"language":"jv","weights":[0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986],"ids":[2964,3903,138,3538,642,2649,553,275,4511,3804,196,1618,1486,4743,3625,3357,1680,384,2785,1849,1281,550,3265,2375,1488,3635,3613,1569,217,4381,2483,2841,4317,2890,875,2877,4324,4092,3757,327,3478,4017,3328,3498,1414,4066,1915,1618,3473,16,1909,1794,4207,1507,4779,2068,2253,156,4341,2391,3407,1188,3239,2108,3931,2172,3120,4607],"ngrams":["yar","nya","any","ata","kat","dek","nde","si$","ras","aku","kak","est","^pe","tin","pen","ggo","ang","eks","kan","^ka","kur","ng$","ke$","sti","^ik","nak","gun","dig","kal","^di","al$","asi","igu","tan","^ak","bak","hak","ing","end","una","sin","ar$","go$","^si","ake","ks$","tek","ak$","ndh","^te","iki","cen","tes","ura","^ba","^ce","dha","ki$","ngg","pie","aka","ce$","an$","iec","^an","eka","^pi","ece"],"ngram_size":3,"dimension":5000},{"language":"jv","weights":[0.019802,0.00990099,0.049505,0.039604,0.039604,0.0792079,0.029703,0.019802,0.019802,0.00990099,0.00990099,0.019802,0.00990099,0.0792079,0.00990099,0.138614,0.0891089,0.118812,0.0693069,0.138614],"ids":[24,65,88,44,21,79,0,58,77,22,63,59,11,20,2,52,19,96,66,68],"ngrams":["r","y","g","s","t","e","d","c","p","o","h","u","b","n","l","^","k","a","i","$"],"ngram_size":1,"dimension":100},{"language":"ka","weights":[0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0348837,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0232558,0.0232558,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0465116,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0232558,0.0232558,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0116279,0.0348837,0.0116279,0.0232558,0.0232558,0.0116279,0.0116279,0.0116279,0.0116279,0.0232558,0.0116279,0.0232558,0.0232558,0.0232558,0.0232558,0.0116279],"ids":[95,767,821,314,63,484,403,153,924,368,825,443,784,403,728,778,864,982,349,258,44,97,277,864,76,222,273,221,527,972,558,223,46,754,967,193,788,864,838,381,197,936,921,343,534,802,394,174,839,914,0,259,231,446,156,633,951,209,851,845,399,688,540,42,794,303,368,739],"ngrams":["ით","უჯ","^უ","�რ","ცვ","^�","�ც","ნ�","ინ","�დ","გ�","^გ","ში","მ�","ტე","იტ","ლ$","რი","სი","ერ","ბს","პე","ი�","ს$","ემ","^პ","ჯრ","�შ","ევ","ნ$","ი$","ეე","ბი","�ნ","ტი","ღე","დუ","ელ","^$","^ე","ვლ","�დ","იღ","მი","თ$","ლი","^ს","^ბ","დე","ნდ","ბუ","თვ","ის","ლე","^�","^მ","მე","რთ","იდ","�ი","ირ","ვი","ნტ","ენ","ებ","დ�","ულ","�$"],"ngram_size":2,"dimension":1000},{"language":"ka","weights":[0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625],"ids":[2951,3537,3479,713,1819,2896,1378,1144,2625,1555,744,3191,1273,1453,3961,4205,3139,1832,1090,3358,4300,4738,1515,3909,1829,412,1929,3651,1431,4827,1522,3079,2969,2247,4337,1502,3057,339,3891,830,2343,891,1462,3912,1233,439,4807,280,3399,1468,4373,2629,3933,2851,1974,2444,3668,2432,519,3449,3764,3565,3345,923],"ngrams":["�რი$","^�რი","ვლებ","ცვლე","ნ�ცვ","ინ�ც","ჯრით","�ინ�","დ�ინ","�დ�ი","ეევი","�ში$","მ�ში","ემ�შ","თვიდ","^პერ","ტემ�","�დულ","რით$","ნტი$","ი�დუ","^უჯრ","მენტ","რი�დ","ერი�","ებს$","ლებს","ენტი","პერი","დელე","ლემე","ენდე","იდ�ნ","ემენ","^გ�დ","ნდელ","უჯრი","^ბირ","^მენ","გ�დ�","იტემ","ელეე","ღებუ","ელემ","მენდ","^ელე","ული$","ლეევ","დ�ნ$","ბირთ","^მიღ","�ცვლ","რთვი","ბული","მიღე","ევის","ვიდ�","ირთვ","ებულ","სიტე","ვის$","იღებ","დულ$","^სიტ"],"ngram_size":4,"dimension":5000},{"language":"ka","weights":[0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.027027,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.027027,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135,0.0135135],"ids":[4795,1240,643,4638,4189,1756,4727,3399,824,1055,856,4103,2839,474,3035,4241,1734,2931,721,1184,2951,184,761,940,1812,2528,4928,316,976,2034,4115,2572,599,1350,4968,4638,3171,2839,948,2748,409,2793,2275,3471,3667,4303,4335,450,2957,595,4175,3814,3661,1321,790,4142,1633,3369,4451,3455,3916,1341,1551,2620,2601,2301,3640,2427,2718,4372,3556,4340],"ngrams":["ჯრი","^უჯ","�რი","^�რ","ბს$","რით","ლებ","�ცვ","ნ�ც","�დ�","გ�დ","�ში","ით$","მ�შ","ლეე","ტემ","ულ$","ვლე","რი�","ში$","ირთ","ვიდ","პერ","ბირ","^პე","^�$","^მე","ვის","�ინ","ტი$","იტე","ენტ","ევი","ლემ","ეევ","ემ�","ელე","სიტ","ი�დ","ნდე","ენდ","ის$","ნტი","მენ","^მი","დულ","უჯრ","დელ","ებს","თვი","^ელ","ლი$","^ბი","ღებ","�დუ","�ნ$","^გ�","^სი","ცვლ","დ�ნ","ემე","ინ�","იღე","რი$","იდ�","ბულ","ებუ","რთვ","ული","ერი","დ�ი","მიღ"],"ngram_size":3,"dimension":5000},{"language":"ka","weights":[0.0102041,0.0102041,0.0306122,0.0306122,0.112245,0.0510204,0.0102041,0.0204082,0.0408163,0.122449,0.0306122,0.0204082,0.0102041,0.122449,0.0408163,0.0204082,0.0408163,0.0612245,0.0102041,0.0408163,0.0306122,0.0102041,0.122449],"ids":[7,20,24,45,42,65,55,87,0,3,92,78,72,52,41,6,32,11,76,21,23,83,68],"ngrams":["შ","პ","უ","ს","ე","ლ","ღ","�","დ","ი","ვ","თ","ჯ","^","რ","ტ","მ","�","ც","ნ","ბ","გ","$"],"ngram_size":1,"dimension":100},{"language":"kk","weights":[0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.0144928,0.00724638,0.00724638,0.00724638,0.00724638,0.0289855,0.00724638,0.0144928,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.0144928,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.0144928,0.0144928,0.0144928,0.0144928,0.0217391,0.0217391,0.0217391,0.00724638,0.0144928,0.00724638,0.00724638,0.00724638,0.0144928,0.00724638,0.00724638,0.0144928,0.0434783,0.00724638,0.0144928,0.0144928,0.0144928,0.00724638,0.00724638,0.00724638,0.0217391,0.00724638,0.00724638,0.0217391,0.0144928,0.00724638,0.00724638,0.0217391,0.0144928,0.0144928,0.00724638,0.00724638,0.00724638,0.0144928,0.0144928,0.0144928,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.0289855,0.00724638,0.00724638,0.00724638,0.00724638,0.00724638,0.0144928,0.00724638,0.0144928,0.00724638,0.00724638,0.0144928,0.0144928,0.0144928,0.00724638],"ids":[601,856,213,706,498,673,974,565,52,485,648,750,634,965,710,514,469,741,287,444,75,870,85,65,613,301,958,736,779,360,716,212,71,778,276,78,325,997,196,996,524,56,728,591,145,532,463,799,476,807,746,425,274,149,505,667,308,947,544,574,464,93,546,627,985,814,440,38,279,0,769,131,379,397,695,708,632,454,728,929,975,300,373,679,838,516,381,728,817,826,499],"ngrams":["ың","за","жа","^ж","од","�$","қы","қр","^қ","е�","бі","^м","ңі","де","ы�","зд","м$","нд","лі","ек","ке","рг","^к","ко","на","ға","^ғ","�е","т�","з$","ет","^т","^е","^х","ха","н$","е$","ге","ме","ен","лм","ап","ім","рі","аз","ты","із","ер","та","ал","ің","бе","т$","ат","ла","�і","і�","рд","ан","ық","�а","^р","р$","ін","ң$","ді","рұ","мы","өз","ег","қ$","ұқ","зі","л$","ел","п$","^б","ил","ны","не","к�","қ�","ле","ыл","^$","би","лы","іл","а$","^ө","^а"],"ngram_size":2,"dimension":1000},{"language":"kk","weights":[0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383],"ids":[4619,3702,3615,1334,3643,404,3286,3284,2993,1964,2685,2586,4729,49,3681,614,271,4688,3436,4157,2558,2566,3350,3369,3181,3131,1050,2499,766,4790,1895,1619,1395,2192,4400,4394,3285,2321,2359,1724,1914,133,4924,3707,1828,2610,1846,2111,1928,138,1483,4594,1609,2120,2557,4040,2945,3282,1374,2317,2592,4001,2009,30,3280,3732,1147,1606,2889,709,3512,1603,2479,2492,1766,1403,1371,4213,2557,4200,1497,2865,3,2271,3413,4163,2304,2505,2080,628,4436],"ngrams":["ның$","аның","азан","жаза","^жаз","к�ін","^код","^тық","^қыл","дер$","е�із","ле�і","біле","мы�$","ңіз$","�інд","іңіз","ріңі","ізде","ерің","нде$","^біл","дері","здер","өзде","^өзд","рген","ерге","і�ім","тық$","т�е$","^ған","^қр$","^ет�","^рұқ","лап$","^хал","алап","інде","лі�і","тала","зіне","алық","халы","ет�е","^өзі","егер","^тал","гер$","ілме","^еге","ек�і","еген","ана$","елі�","ғана","лмег","бері","берг","^хан","рұқ�","^бер","қыл$","келі","заны","дек�","^кел","�ізд","дің$","�ат$","илер","қ�ат","ерді","өзін","лық$","�ім$","меге","еріл","іне$","хан$","^мы�","^бил","рдің","рілм","коде","ген$","одек","іле�","ұқ�а","лерд","биле"],"ngram_size":4,"dimension":5000},{"language":"kk","weights":[0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.0173913,0.00869565,0.00869565,0.00869565,0.0173913,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.0173913,0.00869565,0.00869565,0.0173913,0.0173913,0.00869565,0.0173913,0.00869565,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.0173913,0.00869565,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.0173913,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565,0.00869565],"ids":[4757,989,2032,2377,34,2555,3531,1046,1168,949,2641,1491,2400,2084,3389,2704,665,4925,4110,3157,825,2561,657,201,840,3326,432,1697,1302,4101,1655,661,1795,2886,3545,1061,2068,4352,2699,887,4955,3448,4854,4340,1457,2776,2939,4835,4638,2358,4337,3618,1783,1196,4169,67,3614,1998,1809,2446,2706,2349,3475,1775,4796,4250,4769,3558,3549,3297,1001,2462,2379,4667,774,3409,2282,341,1433,2661,626,1400,1387,281,2333,52,1560,3194,94,2193,618,3618,3070,3854,2622,2505,3931,4855,458,2702,3343,4164,1609],"ngrams":["ың$","ның","аны","аза","ек�","дек","^жа","оде","жаз","код","тық","ы�$","^қы","зан","қр$","ізд","�із","інд","е�і","т�е","іле","^бі","іңі","^ға","рің","дер","ңіз","ыл$","иле","зде","ық$","ерг","ле�","ім$","елі","кел","ан$","хан","ана","на$","өзд","ған","мы�","^ет","ері","ріл","ап$","рге","лі�","лық","лап","^а$","^ко","�ін","алы","дің","^қр","ала","^ха","хал","ат$","ер$","ен$","ет�","ген","^ке","еге","^ты","мег","ілм","�ат","лме","^өз","і�і","бер","к�і","біл","рұқ","іне","өзі","нде","із$","ің$","ұқ�","^бе","тал","зін","қ�а","ерд","де$","�е$","�ім","^та","лер","^ег","бил","^рұ","рді","^мы","қыл","не$","гер","^би"],"ngram_size":3,"dimension":5000},{"language":"kk","weights":[0.00621118,0.00621118,0.0124224,0.0186335,0.0186335,0.0248447,0.0310559,0.142857,0.0372671,0.0310559,0.0310559,0.0186335,0.0434783,0.0186335,0.0621118,0.0124224,0.142857,0.00621118,0.0496894,0.10559,0.0310559,0.0434783,0.00621118,0.0248447,0.00621118,0.00621118,0.0621118],"ids":[81,99,47,15,85,20,67,68,49,10,56,24,81,39,34,52,52,98,82,30,50,44,41,26,15,74,63],"ngrams":["ж","ғ","ө","г","м","т","ы","$","�","д","қ","ң","н","к","і","х","^","и","р","е","з","л","п","б","о","ұ","а"],"ngram_size":1,"dimension":100},{"language":"km","weights":[0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0206186,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0206186,0.0103093,0.0103093,0.0103093,0.0103093,0.0618557,0.0206186,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0206186,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0206186,0.0103093,0.0103093,0.0103093,0.0103093,0.0206186,0.0206186,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0206186,0.0103093,0.0103093,0.0206186,0.0103093,0.0412371,0.0103093,0.0103093,0.0206186],"ids":[836,639,115,537,35,999,422,162,663,877,349,740,914,780,550,520,738,914,536,671,973,633,549,742,338,629,583,800,555,26,646,600,614,863,493,339,513,420,87,831,964,550,829,687,81,774,791,579,688,539,903,376,57,981,901,838,500,722,83,607,924,566,357,516,185,273,652,276,31,196,532,69,779,182,583,729,784,634,127],"ngrams":["ះ$","�្","��","រ្","ាស","សា","ធី","ៃវ","ម�","ឹម","រឹ","ព�","ភា","ាព","�ភ","្�","�ស","��","្វ","ធ្","រធ","កា","្ល","់ក","វិ","ះគ","ម្","សម","ើស","ិធ","ន�","រើ","វន","ំណ","ប្","្រ","ាប","នឹ","ើ�","បា","វប","លន","បទ","រូ","�ប","អ�","ក�","មី","ារ","្�","ឹង","ីស","ង�","�្","ដែ","^$","ែក","វើ","ាន","ណែ","ីន","ស្","ទដ","នប","រា","គឺ","ែល","បំ","លី","ប់","នៃ","^ន","ជា","ូវ","្ម","�្","ឺជ","ៃអ","�ះ"],"ngram_size":2,"dimension":1000},{"language":"km","weights":[0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527],"ids":[2196,2278,4358,2455,3053,215,597,2389,1996,3584,1123,2273,2555,209,1786,180,2563,739,1169,4283,3789,1531,1420,2161,2618,1390,1249,3082,533,1020,3532,1526,2839,4452,2786,420,3920,4256,4201,2626,656,1972,4018,4399,4457,2665,2666,1532,4558,241,1635,3475,3769,2209,2918,102,1473,3837,3744,4289,4694,2148,2347,3202,947,3486,1598,4111,3228,3220,2375,4645,2235,4112,2082,706,3259,3830,1567,2218,2907,3280,3240,550,789,2112,3099,4643,4294,3180,3642],"ngrams":["ីន�ះ","មីន�","្មីន","��្ម","្រ្�","ស្រ្","ីសាស","វនៃវ","ម�្រ","ឹម�្","ធីសា","នៃវិ","រឹម�","្រឹម","�្រឹ","ព�្រ","ាព�្","�ភាព","្�ភា","ូវនៃ","ស្�ភ","�ស្�","ើ��ស","វើ��","ធ្វើ","ារធ្","ការធ","ើសម្","ន�ះ$","រើសម","វិធី","រូវន","ប្រើ","បានប","ភាព�","សម្រ","នៃអ�","ូវបា","រូវប","្រើស","្រូវ","ាប់ក","ដែលន","រាប់","ានប្","ង�្រ","នឹង�","�្មី","ប់កា","ែលនឹ","្រាប","បទដែ","បំណែ","�បទដ","��ស្","នប្រ","ឹង�្","�្�ប","�្លី","្�បទ","�្រូ","អ�្�","ៃអ�្","សាស្","ៃវិធ","លនឹង","ីនៃអ","ែក�្","ណែក�","^ន�ះ","ាស្រ","្វើ�","ឺជាប","ិធីស","ះគឺជ","រ្��","វបាន","់ការ","ំណែក","ក�្ល","លីនៃ","្��្","រធ្វ","ាបំណ","ន�ះគ","ម្រា","គឺជា","�ះគឺ","្លីន","ទដែល","ជាបំ"],"ngram_size":4,"dimension":5000},{"language":"km","weights":[0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0319149,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383],"ids":[4986,4579,648,4555,2537,515,520,208,2081,1384,525,4700,2914,2724,4083,3945,2938,1609,2782,1232,3482,1384,2981,3480,3671,906,4034,2827,4230,3250,836,4060,4037,2625,4027,3132,4882,3967,1270,432,829,4242,735,1288,2110,1865,2298,120,1629,1127,2463,3298,3240,2719,3146,2756,1737,4935,3743,4086,4653,2761,841,1766,1073,3212,3115,2418,497,2260,3417,2063,3934,1863,320,2684,564,1398,2395,2304,4039,2429,684,445,2524,1562,4767,1646,990],"ngrams":["មីន","�្ម","�ះ$","សាស","ិធី","នៃវ","ឹម�","្រឹ","ព�្","្�ភ","ស្�","ើ��","វិធ","វើ�","្វើ","�ស្","ធ្វ","ៃវិ","រធ្","ារធ","ការ","ាប់","ាស្","វនៃ","្រា","ម្រ","សម្","^ន�","ប្រ","ានប","ក�្","វបា","្រូ","ភាព","�ភា","រាប","ជាប","�្រ","ស្រ","ឹង�","ប់ក","នប្","នឹង","ែលន","ង�្","ដែល","រ្�","បទដ","រើស","្រ្","ម�្","បាន","�្�","គឺជ","ើសម","លីន","ីនៃ","នៃអ","�្ល","ីន�","��ស","ទដែ","អ�្","្រើ","បំណ","្��","់កា","ៃអ�","្មី","ូវប","្លី","ូវន","រូវ","លនឹ","រឹម","ែក�","��្","ីសា","ន�ះ","ណែក","ំណែ","�ះគ","�បទ","ធីស","ឺជា","ាព�","្�ប","ាបំ","ះគឺ"],"ngram_size":3,"dimension":5000},{"language":"km","weights":[0.01,0.01,0.02,0.04,0.07,0.01,0.02,0.02,0.01,0.01,0.02,0.07,0.01,0.01,0.01,0.02,0.01,0.03,0.12,0.01,0.02,0.02,0.01,0.04,0.06,0.02,0.05,0.01,0.01,0.03,0.06,0.01,0.03,0.02,0.03,0.02,0.03],"ids":[13,64,19,43,73,49,7,82,64,72,45,65,73,99,64,31,97,99,94,95,95,12,76,93,98,75,65,36,50,44,28,86,66,57,68,99,52],"ngrams":["ិ","ព","ធ","វ","រ","ង","ឹ","�","ភ","ទ","ល","�","់","ដ","អ","ៃ","គ","ី","្","�","ក","ែ","ំ","ស","ា","ូ","ប","ជ","ណ","ម","ន","ឺ","�","ើ","$","ះ","^"],"ngram_size":1,"dimension":100},{"language":"kn","weights":[0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0215054,0.0107527,0.0215054,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0215054,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0322581,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527],"ids":[593,772,309,516,770,612,194,233,988,666,61,240,955,787,138,135,352,306,744,861,220,130,581,712,737,888,923,251,119,772,435,467,90,112,685,368,166,946,988,647,867,440,477,619,779,638,439,436,155,727,262,501,374,845,838,470,53,897,372,46,262,459,258,700,283,7,538,792,637,406,381,35,636,933,314,718,355,174],"ngrams":["ಾನ","ಶ�","^ಶ","ಿಯ","ಯಾ","ರಣ","ಾರ","ಧಾ","^ಸ","ಂಬ","ೆಂ","^ಹ","ರ$","^ವ","ಪ�","�ಥ","ತೀ","ಬ$","ಿನ","ೋಗ","ಕಿ","ಿ$","ಭೋ","ನವ","ಳಿ","ಥಪ","ಿಲ","�ಳ","ವೆ","�ಯ","ಳ�","ಜಿ","ಾಲ","ಾಯ","ಗರ","ಹಳ","ಕನ","ಕ�","�ರ","^ಚ","ರ�","ಲೆ","ನ$","�ಕ","ನಹ","ಮಕ","ಣ$","ಲೂ","ರ�","ತ�","�ಮ","ೆಯ","�ಲ","ತಾ","^$","ೀರ","ಕೂ","ಯಕ","�ಭ","^ತ","ಂಠ","^ಂ","ಸಾ","ೂಕ","ಯನ","ನ�","ಠಯ","�$","ನಾ","^ಜ","ಚಿ","ಯ$","ಾಧ","ಯ�","ಿಕ","ವರ","ಲ�","ೂರ"],"ngram_size":2,"dimension":1000},{"language":"kn","weights":[0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.028169,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.028169,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845],"ids":[1716,995,134,4197,1338,3232,4014,1885,3669,2450,3324,2142,473,2012,1519,4022,2540,3448,4871,2438,4548,2405,2190,1396,437,4707,4073,655,990,1756,3877,2061,2515,1993,4816,564,4635,3994,4823,3382,1249,473,43,4146,2315,877,1437,1566,3069,1781,2327,1485,4130,2569,2217,4208,1521,3388,3153,1888,4078,2085,3598,2864,4806,4830,1918,2050,12],"ngrams":["ಭೋಗರ","�ಭೋಗ","ನ�ಭೋ","ಯಾನ�","�ಯಾನ","ಶ�ಯಾ","ಸಾಧಾ","^ಸಾಧ","ೆಂಬ$","ವೆಂಬ","^ವೆಂ","ರ�ಥಪ","ೀರ�ಥ","ಿಲ�ಲ","^ತೀರ","ಲೂಕಿ","ಯ�ಯನ","ತ�ಮಕ","ಲ�ಲೂ","ಂಠಯ�","ತಾಲ�","ಾಧಾರ","ಕಿನ$","^ತಾಲ","ಳ�ಳಿ","ಕನಹಳ","�ಳಿ$","ಯಕನಹ","�ಕನಾ","ತೀರ�","�ಯನವ","ಕ�ಕನ","ಾರಣ$","ಚಿಕ�","^ಹಳ�","ಯನವರ","ನವರ�","ಲ�ಲೆ","ಧಾರಣ","ಾಲ�ಲ","^ಜಿಲ","^ಚಿಕ","�ಲೂಕ","ಳಿಯ$","ಮಕೂರ","ೋಗರ$","ಹಳ�ಳ","ಥಪ�ರ","ಕನಾಯ","ೂರ�$","ನಾಯಕ","ನಹಳ�","^ಶ�ಯ","ಪ�ರ$","ಾಯಕನ","ಾನ�ಭ","ವರ�$","�ಳಿಯ","ಲೆಯ$","ಕೂರ�","�ಲೆಯ","ಿಕ�ಕ","ಠಯ�ಯ","�ಮಕೂ","�ಥಪ�","^ತ�ಮ","ಜಿಲ�","ೂಕಿನ","^ಂಠಯ"],"ngram_size":4,"dimension":5000},{"language":"kn","weights":[0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0246914,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0246914,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0246914,0.0123457,0.0123457,0.0246914,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0123457,0.0246914,0.0123457,0.0123457,0.0123457,0.0123457],"ids":[4014,555,3644,913,3555,4988,2748,2604,1863,3610,4597,1707,1084,4345,1371,1601,4548,3839,2080,996,4384,363,462,4242,2001,753,2802,4094,2832,1667,1743,1082,721,2125,236,1582,1117,4508,1183,453,4636,808,1513,1598,170,3653,1688,1578,4745,3948,1191,2254,3300,4220,4201,4345,2728,4714,4280,567,133,3997,3192,4338,789,274,509,3379,4824,2696,4094,2312,737,1592,650,2773],"ngrams":["ಗರ$","ಭೋಗ","�ಭೋ","ನ�ಭ","ಾನ�","ಯಾನ","ಿಯ$","^ಹಳ","ಾಧಾ","ಸಾಧ","ೋಗರ","^ಸಾ","ಂಬ$","ೆಂಬ","^ಶ�","ವೆಂ","�ರ$","ರಣ$","ಥಪ�","�ಥಪ","ಚಿಕ","ನಾಯ","^ತೀ","ಿನ$","ಧಾರ","ಪ�ರ","ಲೂಕ","ೂರ�","ತಾಲ","^ಚಿ","ಳಿ$","ಕನಾ","�ಲೂ","ಳ�ಳ","ಯಕನ","ಾಯಕ","ತೀರ","�ಕನ","ಕ�ಕ","ಿಕ�","ಳಿಯ","�ಲೆ","�ಯನ","ಮಕೂ","�ಯಾ","ಲ�ಲ","ಿಲ�","ಶ�ಯ","ಲೆಯ","ೂಕಿ","ೀರ�","ನವರ","ಠಯ�","ರ�ಥ","ಕೂರ","ಜಿಲ","�ಮಕ","ಕಿನ","ಕನಹ","ರ�$","^ತಾ","ಯ�ಯ","�ಳಿ","^ವೆ","ತ�ಮ","ಾಲ�","ಯನವ","ೆಯ$","ಾರಣ","ನಹಳ","ವರ�","ಹಳ�","^ಂಠ","^ಜಿ","ಂಠಯ","^ತ�"],"ngram_size":3,"dimension":5000},{"language":"kn","weights":[0.00952381,0.00952381,0.00952381,0.00952381,0.0285714,0.047619,0.00952381,0.0190476,0.00952381,0.047619,0.00952381,0.047619,0.0190476,0.047619,0.0190476,0.00952381,0.0571429,0.0571429,0.0761905,0.00952381,0.00952381,0.00952381,0.0190476,0.114286,0.0380952,0.0190476,0.00952381,0.00952381,0.00952381,0.0380952,0.00952381,0.047619,0.114286],"ids":[3,68,84,17,51,9,21,20,0,75,97,88,94,44,70,25,69,54,31,23,95,61,83,52,0,31,99,52,78,32,34,44,68],"ngrams":["ಣ","ಧ","ಥ","ೀ","ತ","ಾ","ಚ","ೆ","ಜ","�","ೋ","ನ","ಂ","ಕ","ವ","ಭ","ಯ","ರ","�","ಸ","ಬ","ಪ","ಹ","^","ಲ","ೂ","ಠ","ಮ","ಗ","ಳ","ಶ","ಿ","$"],"ngram_size":1,"dimension":100},{"language":"ko","weights":[0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.0291262,0.00970874,0.0291262,0.00970874,0.00970874,0.0194175,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.0291262,0.00970874,0.00970874,0.0291262,0.00970874,0.0194175,0.0291262,0.0194175,0.00970874,0.0194175,0.0291262,0.0291262,0.00970874,0.0194175,0.0291262,0.00970874,0.0194175,0.0291262,0.0194175,0.0291262,0.0291262,0.0194175,0.00970874,0.0194175,0.0291262,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874,0.0194175,0.00970874,0.0194175,0.0194175,0.00970874,0.00970874,0.00970874,0.00970874,0.00970874],"ids":[159,699,280,474,31,269,5,390,683,152,983,925,415,920,951,476,517,945,999,316,639,764,599,990,56,46,213,195,407,669,803,305,257,790,539,782,905,927,650,559,875,603,877,618,265,625,971,921,573,315,734,674,793,634,490,525,551,817,838,860,675,502,443,565,912,366,785],"ngrams":["다�","^선","름�","서$","�서","��","용$","^다","^가","면$","려면","시려","하시","는$","용�","스할","^�","세스","�$","로필","가용","사용","한$","^�","다$","게$","니다","있습","필$","여사","�한","^프","여할","수$","프로","^있","�름","�트","�$","권한","�게","��","부여","여하","스$","액세","한�","^부","^권","^수","습니","리�","^액","^개","트$","�$","으로","트�","^$","로$","할$","^리","�으","있는","별�","선�","개별"],"ngram_size":2,"dimension":1000},{"language":"ko","weights":[0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0566038,0.0188679,0.0566038,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.0377358,0.0377358,0.0188679,0.0188679,0.0566038,0.0377358,0.0377358],"ids":[4543,1784,2080,1885,4415,1909,3803,1930,3625,3978,1520,682,4250,3840,350,3051,3624,3079,1916,3765,973,1940,116,719,997,380,4399,447,2234,2673,4729,986,4789,1770,1192,4668,680,1225,1260,4967,1533,1120,3617],"ngrams":["^다�$","��서$","���서","^���","^가용$","시려면$","하시려면","여하시려","�름�$","^부여하","^있는$","액세스할","^프로필","세스할$","프로필$","��게$","^선�한","리�트$","용��게","^�름�","사용��","여사용�","^부여할","^부여사","습니다$","^있습니","선�한$","^권한$","�트�$","부여할$","있습니다","리�트�","�으로$","부여사용","개별�으","부여하시","권한�$","액세스$","별�으로","^개별�","^액세스","^리�트","^권한�"],"ngram_size":4,"dimension":5000},{"language":"ko","weights":[0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.038961,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.038961,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.038961,0.012987,0.025974,0.012987,0.012987,0.012987,0.012987,0.025974,0.012987,0.012987,0.038961,0.012987,0.012987,0.012987,0.025974,0.038961,0.025974,0.025974,0.012987,0.012987,0.012987,0.025974,0.012987,0.012987,0.038961,0.038961,0.012987,0.012987,0.012987],"ids":[51,3300,4016,1468,724,1619,3628,2863,3210,443,4624,3977,3687,2897,2019,3090,2021,3872,704,3726,4884,904,4764,290,2103,2435,3805,3609,667,2764,2949,969,1499,1037,996,266,3328,4121,97,185,1022,1565,1866,256,1456,3909,4429,594,1187,2250,4961,135,4774,2583,530,2066,530],"ngrams":["름�$","�름�","^선�","^�름","��서","사용�","^��","하시려","가용$","�서$","프로필","려면$","여하시","부여하","별�으","시려면","^있는","스할$","^다�","부여사","^프로","세스할","�트�","�게$","여사용","^가용","권한$","있습니","액세스","니다$","리�트","다�$","^있습","선�한","습니다","권한�","여할$","���","^액세","있는$","부여할","트�$","^수$","^권한","세스$","한�$","용��","�한$","�트$","^리�","��게","으로$","로필$","^부여","개별�","�으로","^개별"],"ngram_size":3,"dimension":5000},{"language":"ko","weights":[0.00775194,0.00775194,0.00775194,0.00775194,0.00775194,0.0232558,0.00775194,0.0232558,0.00775194,0.0155039,0.00775194,0.00775194,0.0232558,0.0155039,0.0232558,0.00775194,0.0155039,0.00775194,0.0232558,0.0155039,0.00775194,0.00775194,0.00775194,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0155039,0.00775194,0.0155039,0.0310078,0.0155039,0.0155039,0.00775194,0.0310078,0.00775194,0.00775194,0.00775194,0.20155,0.0155039,0.00775194,0.00775194,0.20155],"ids":[74,96,75,4,63,12,80,8,80,54,8,54,10,83,12,23,61,30,30,33,25,52,15,70,97,15,35,78,89,0,68,38,96,9,38,73,61,66,5,68,96,77,9,52],"ngrams":["�","서","가","면","시","필","게","�","선","용","사","름","프","다","세","습","할","�","여","수","�","�","개","권","스","부","�","액","트","니","있","한","�","리","는","로","으","�","하","$","�","별","려","^"],"ngram_size":1,"dimension":100},{"language":"la","weights":[0.00387597,0.00387597,0.00387597,0.00387597,0.00387597,0.00387597,0.00387597,0.00387597,0.0116279,0.00387597,0.00387597,0.0155039,0.00387597,0.0116279,0.00775194,0.0116279,0.00775194,0.00387597,0.00387597,0.00387597,0.00775194,0.00387597,0.00775194,0.0155039,0.00387597,0.0116279,0.00387597,0.00387597,0.00387597,0.00387597,0.00775194,0.0193798,0.00387597,0.00775194,0.00387597,0.0116279,0.0193798,0.00387597,0.00387597,0.00387597,0.00387597,0.0116279,0.0155039,0.00775194,0.00775194,0.0271318,0.0116279,0.0193798,0.00775194,0.0116279,0.00775194,0.0116279,0.00387597,0.00387597,0.0155039,0.0116279,0.00387597,0.00775194,0.00775194,0.0116279,0.00775194,0.0116279,0.00775194,0.0155039,0.0155039,0.0155039,0.00387597,0.0116279,0.0193798,0.0116279,0.0116279,0.00387597,0.00775194,0.00387597,0.00775194,0.0232558,0.0116279,0.0155039,0.0271318,0.00387597,0.0116279,0.0193798,0.00387597,0.0155039,0.00775194,0.00387597,0.0155039,0.0155039,0.00775194,0.00387597,0.00775194,0.0116279,0.00387597,0.00775194,0.00387597,0.00387597,0.00387597,0.00387597,0.0193798,0.0116279,0.0232558,0.00387597,0.00775194,0.00387597,0.00775194,0.00775194,0.00387597,0.0193798,0.00775194,0.00775194,0.00775194],"ids":[973,601,353,269,126,379,263,237,879,116,571,96,786,510,734,285,915,248,146,75,378,535,557,575,19,651,298,707,518,978,349,819,893,487,766,955,287,489,660,381,694,75,212,768,927,327,989,458,489,630,685,645,493,854,46,83,27,402,862,985,809,356,120,613,353,526,403,193,532,392,933,960,67,738,429,476,679,355,300,672,7,707,175,503,803,108,421,490,200,545,532,727,0,128,80,384,963,134,848,891,153,925,732,404,591,895,802,8,385,720,838],"ngrams":["el","ho","^h","an","gr","ep","ae","ne","ra","ar","mp","ni","is","s$","et","iu","io","n$","or","op","la","^l","cu","^e","ol","e$","ip","ce","pe","bi","se","li","mo","om","ab","te","it","ed","lt","fe","of","pr","^p","ca","mu","r$","a$","tu","es","at","uo","^i","in","^n","al","ul","si","od","^d","ri","nd","me","im","t$","er","on","no","le","^s","ud","ti","pa","nt","so","ia","^c","au","^m","m$","da","sa","d$","il","us","di","ps","ur","um","st","ir","o$","qu","oc","po","nu","ns","ci","ui","i$","^q","en","^g","su","ec","ro","am","eo","^a","de","co","^$"],"ngram_size":2,"dimension":1000},{"language":"la","weights":[0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.0113636,0.0113636,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.00568182,0.0113636,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.00568182,0.0113636,0.00568182,0.0113636,0.00568182,0.0227273,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.00568182,0.0113636,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.0170455,0.0113636,0.00568182,0.0113636,0.00568182,0.00568182,0.00568182,0.0113636,0.00568182,0.00568182,0.0113636,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.00568182,0.0113636,0.00568182,0.00568182,0.00568182,0.0113636,0.0113636,0.0113636,0.00568182,0.00568182,0.00568182,0.0113636,0.0113636,0.0113636,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.00568182,0.0113636,0.00568182,0.00568182,0.0113636,0.00568182,0.00568182,0.00568182,0.0113636,0.0113636,0.00568182,0.00568182,0.0113636,0.0113636,0.00568182,0.00568182,0.00568182],"ids":[2166,3320,4182,4450,1708,4697,4456,597,2586,4553,3210,3263,3408,4156,2686,3327,4679,522,1950,2953,3989,2456,3878,3763,4686,1614,4737,3053,4143,3802,2600,3043,1133,1358,3977,4671,2842,2293,1169,3039,4161,379,951,1888,3336,4434,2054,3696,1340,1943,1172,1862,3630,3889,2978,174,1494,891,571,1909,983,4473,3047,2872,192,807,3286,1637,410,279,2729,15,1004,651,1467,4314,761,3767,3879,101,182,2517,2995,4471,4729,1987,1989,4068,4437,2478,2353,3132,4400,4276,4596,299,1341,915,1999,1684,560,3904,1636,3085,302,4453,2030,582,4318,3853,497,4781,1254,679,4266,3220,1696,3143,1225,704,1860,1471,1501,4410,3365,32,758,2879,4152,733,4661,386,696,3129,3901,4966,2054,1834,3861,796],"ngrams":["lius","meli","homo","^hom","sanu","^cum","mur$","amur","ulam","tula","atul","ratu","eliu","^mel","^gra","ter$","iter","alit","aepo","^pra","tion","atio","rati","arat","prae","para","^com","iori","erio","eter","sule","nitu","^noc","onit","opon","ropo","tiri","bile","lamu","abil","cons","udab","mpar","auda","anus","laud","^deo","^lau","ulen","psum","nus$","^per","ris$","liud","ione","poni","^det","est$","noce","^ali","sed$","feci","prof","sum$","ultu","^pro","ius$","caus","tum$","epon","ntia","^sed","^con","^si$","mult","comp","^men","tur$","cum$","sole","uod$","atur","ipsu","one$","ment","ofec","oris","quod","nsul","^ips","onsu","iam$","rofe","iatu","rior","cend","lend","aliu","raep","^cau","olet","ile$","ecit","usa$","ausa","^eni","deo$","qui$","let$","lite","enti","^est","omo$","tiat","cit$","dete","per$","iud$","^iam","iri$","^mul","^san","prop","^sol","^quo","ltum","^in$","ndi$","teri","ntir","ocen","endi","nim$","^qui","ompa","itur","enim","grat","^se$","dabi"],"ngram_size":4,"dimension":5000},{"language":"la","weights":[0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.0138889,0.00462963,0.00462963,0.00925926,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.0138889,0.0138889,0.00925926,0.00925926,0.00925926,0.00462963,0.00462963,0.00925926,0.00925926,0.00925926,0.00925926,0.0185185,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.0185185,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.0185185,0.00462963,0.0138889,0.00925926,0.00462963,0.00925926,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00925926,0.00462963,0.00925926,0.00925926,0.00925926,0.00925926,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.0138889,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00925926,0.00925926,0.00925926,0.00462963,0.00462963,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.0185185,0.00462963,0.00925926,0.00462963,0.00462963,0.00462963,0.00462963,0.0138889,0.00462963,0.0138889,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00462963,0.00925926],"ids":[4504,4337,3466,2262,4063,592,1162,3160,4373,2924,4492,2570,3791,3639,1216,4972,3439,2254,3274,4530,1221,842,677,2085,4024,4963,4258,1582,3896,2239,2544,3144,1578,2364,1318,4358,6,1439,319,2991,1755,3689,2732,503,4870,1618,1558,2374,4194,962,4127,658,275,3269,1292,611,4567,1630,1192,2592,669,3623,1628,3496,660,4446,4497,4399,2562,1569,605,2387,2729,1147,3629,3498,3956,3278,1684,2028,2595,989,909,3870,3663,3606,674,1400,396,119,2887,4919,3189,2908,3299,2887,1262,256,1003,2651,3356,1057,1305,2710,3939,1745,107,2241,4259,2359,3641,2132,2019,2644,1745,996,4194,3413,1749,2044,1524,3643,3757,531,1794,1486,2078,507,2092,2096,4261,661,985,1580,4702,3417,2563,3302,2428,1034,2170,2032,4662,4094,780,2047,1876,652,75,4775,157,4449],"ngrams":["ius","eli","omo","hom","us$","san","^sa","^cu","lam","ula","tul","^gr","epo","aep","lit","one","tio","rat","cum","ara","omp","com","rio","eri","ter","ete","in$","itu","nit","bil","abi","lau","sum","par","ips","st$","^ip","^pr","er$","uod","di$","quo","^ho","^no","od$","est","ndi","iud","^al","sed","mur","let","si$","cit","eci","is$","fec","ori","psu","rof","pro","um$","per","tum","iri","mul","le$","tia","rae","ons","anu","^la","ion","con","ur$","^si","tur","^co","ole","im$","ule","aus","sol","eo$","mo$","^se","sul","mel","dab","deo","ri$","tir","atu","^es","mpa","cau","pon","nti","oni","nsu","it$","^de","ati","opo","ent","^me","ult","men","se$","ofe","nim","gra","ris","sa$","et$","am$","iat","^so","ud$","aud","ior","eni","end","ite","cen","^pe","^mu","usa","^ia","oce","qui","ltu","noc","ali","ui$","^en","ed$","nus","^a$","amu","liu","iam","^qu","ne$","ile","uda","^in","rop","len","pra","det","^ca"],"ngram_size":3,"dimension":5000},{"language":"la","weights":[0.0266667,0.05,0.05,0.00333333,0.0466667,0.0266667,0.00333333,0.07,0.0433333,0.01,0.00333333,0.05,0.0733333,0.0333333,0.08,0.0633333,0.14,0.00333333,0.0466667,0.0366667,0.14],"ids":[77,24,21,22,44,58,11,59,20,12,63,22,79,0,66,96,68,88,0,2,52],"ngrams":["p","r","t","f","s","c","b","u","n","q","h","o","e","d","i","a","$","g","m","l","^"],"ngram_size":1,"dimension":100},{"language":"lo","weights":[0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.021978,0.021978,0.021978,0.021978,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.021978,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989],"ids":[568,104,521,186,70,898,589,472,428,981,377,234,171,891,79,465,52,833,956,960,889,133,752,3,775,896,56,635,750,552,705,788,961,229,52,56,34,299,416,906,17,56,945,402,934,838,264,663,70,743,986,457,705,187,694,231,931,194,954,700,430,904,574,152,130,942,680,723,488,623,109,415,503,924,395,175,442,173],"ngrams":["ໄດ","ົນ","າຜ","້າ","ນໜ","ນູ","ມນ","ເມ","ມເ","ປຸ","່ມ","ົດ","ດປ","�ົ","້�","^ໃ","້ນ","ັ້","ຸ່","ນັ","^ຈ","ນ$","ອນ","ດ້","ອ�","ນຊ","ຳ�","້ທ","ູ$","ບ$","ດໃ","ທຳ","ໜ້","ສາ","ລະ","້ສ","ຮ້","^�","ານ","ໄຮ","�ນ","ະໃ","�$","ຈາ","�ລ","^$","ບໄ","່ອ","ນເ","ຜົ","�່","່ວ","ັບ","ອິ","ວັ","າ�","ໃຫ","ຫ້","ເວ","^ທ","ິດ","ງເ","າ�","ທັ","ຳອ","ໃນ","ວທ","�ຫ","ຫາ","^�","ັງ","ົ່","�າ","ທົ","້$","ຊອ","ນໄ","າທ"],"ngram_size":2,"dimension":1000},{"language":"lo","weights":[0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.025974,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987,0.012987],"ids":[2969,4762,2354,4721,3464,3158,2154,1714,2178,830,377,2260,4567,1122,4994,3007,2539,3067,4112,3600,590,4313,1715,3615,4246,3936,359,2814,4218,504,1453,1455,4488,3727,4663,2081,3933,3184,4716,3832,225,3448,713,765,3133,371,646,2801,1380,1971,2090,4224,487,1207,643,3558,2973,4140,2470,849,866,2229,4195,1898,3066,2657,4883,3361,406,3469,4472,2674,998,4220,1605,3026],"ngrams":["າຜົນ","້າຜົ","ນໜ້າ","່ມເມ","ປຸ່ມ","ໃນໜ້","ດປຸ່","ນໄດ້","ົດປຸ","ົນໄດ","້�ົດ","ຫ້�ົ","ໜ້າຜ","ນັ້ນ","ຈາ�ນ","ນເວັ","�່ອນ","ໄດ້$","ໃຫ້�","ົ່ວທ","່ອນ$","�ນັ້","າ�່ອ","^ໃຫ້","ເວັບ","ອ�ຫາ","ຫາ�່","ຊອ�ຫ","ັ້ນ$","ທຳ�າ","ຫ້ທຳ","ດໃຫ້","ິດໃຫ","ຜົນໄ","ເມນູ","ວທັງ","ຳອິດ","�ົດປ","ຳ�ານ","^ທຳອ","ສາ�$","�ຫາ�","້ສາ�","ບໄຮ້","ນຊອ�","ວັບໄ","ໄຮ້ສ","ອິດໃ","ທັງເ","ະໃນເ","ານຊອ","�ລະໃ","^�ລະ","ວັບ$","ໃຫ້ທ","້ທຳ�","າທົ່","ມເມນ","�ຫາທ","ຫາທົ","ໃນເວ","^ໃນໜ","�ານຊ","ຸ່ມເ","່ວທັ","ມນູ$","າ�ນັ","ັບໄຮ","ຮ້ສາ","ງເວັ","^�ຫາ","^ຈາ�","ັງເວ","ທຳອິ","ລະໃນ","ທົ່ວ"],"ngram_size":4,"dimension":5000},{"language":"lo","weights":[0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0240964,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0240964,0.0120482,0.0120482,0.0240964,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0120482,0.0240964,0.0120482,0.0120482,0.0120482,0.0120482],"ids":[2320,1382,1547,1972,1309,571,3931,553,4319,2482,3855,3077,3033,1895,1207,993,2224,4571,2918,751,4745,1867,350,331,220,2645,707,3270,549,2448,1717,1609,4365,3377,4844,3371,1728,1529,2228,559,3160,1171,1521,891,3681,4934,4137,526,2571,815,600,2514,3478,2897,4281,3472,3944,3394,576,2015,2433,759,1154,421,2207,2405,644,2740,574,937,38,2654,4051,1434,733,2262,3063,441,2956],"ngrams":["ດ້$","ໄດ້","ົນໄ","ໜ້າ","ນໜ້","^ໃນ","ນູ$","າຜົ","ມນູ","ເມນ","ມເມ","ປຸ່","�ົດ","ຫ້�","^ໃຫ","້ນ$","ັ້ນ","ນັ້","າ�ນ","່ອນ","^�ຫ","້ສາ","^ທຳ","ນຊອ","າ�່","ອນ$","ຫາ�","ອ�ຫ","້�ົ","ຈາ�","ລະໃ","ຊອ�","�ນັ","�ານ","ຸ່ມ","ທຳ�","ໃຫ້","ສາ�","ດໃຫ","ຫາທ","ິດໃ","ອິດ","າ�$","ຜົນ","ບໄຮ","^ຈາ","ໃນເ","ຳອິ","ໃນໜ","້ທຳ","ນເວ","ົ່ວ","ຮ້ສ","ດປຸ","ໄຮ້","ະໃນ","ົດປ","ຫ້ທ","�່ອ","ັບ$","ນໄດ","້າຜ","ວັບ","ັງເ","່ມເ","ເວັ","ທັງ","ານຊ","ງເວ","�ລະ","ວທັ","່ວທ","ຳ�າ","ັບໄ","�ຫາ","^�ລ","ທົ່","ທຳອ","າທົ"],"ngram_size":3,"dimension":5000},{"language":"lo","weights":[0.010101,0.010101,0.020202,0.010101,0.010101,0.010101,0.030303,0.010101,0.030303,0.020202,0.010101,0.010101,0.010101,0.010101,0.0606061,0.0606061,0.010101,0.010101,0.020202,0.010101,0.0808081,0.0808081,0.010101,0.0808081,0.020202,0.030303,0.030303,0.040404,0.030303,0.040404,0.040404,0.010101,0.030303,0.040404,0.0606061],"ids":[20,90,85,38,84,0,12,27,66,9,63,5,99,48,37,70,24,68,68,14,21,68,90,52,88,74,85,56,56,68,43,23,6,95,94],"ngrams":["ຜ","ໜ","ມ","ຸ","ປ","ຊ","ດ","ິ","ອ","ຳ","ຈ","ງ","�","ສ","້","າ","ຮ","ູ","ໄ","ະ","ນ","$","�","^","ບ","ເ","ວ","ຫ","່","ັ","ທ","ລ","ົ","ໃ","�"],"ngram_size":1,"dimension":100},{"language":"lt","weights":[0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.0123457,0.00411523,0.00411523,0.00411523,0.00823045,0.00823045,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.00411523,0.00823045,0.00823045,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.00411523,0.00823045,0.0205761,0.00411523,0.00411523,0.0288066,0.00823045,0.00411523,0.00823045,0.00411523,0.00411523,0.0123457,0.00411523,0.0123457,0.00823045,0.00823045,0.00411523,0.00823045,0.00823045,0.0123457,0.0123457,0.00411523,0.00823045,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.0123457,0.00411523,0.00823045,0.00411523,0.0205761,0.0164609,0.00823045,0.00411523,0.0123457,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.0164609,0.00411523,0.0123457,0.0123457,0.00411523,0.00411523,0.0164609,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.0123457,0.0205761,0.0123457,0.00411523,0.00411523,0.0246914,0.00823045,0.00823045,0.0246914,0.00411523,0.00411523,0.0123457,0.00411523,0.00823045,0.00823045,0.00823045,0.00823045,0.00411523,0.0164609,0.00411523,0.00411523,0.00411523,0.00411523,0.0164609,0.00823045,0.00823045,0.00823045,0.0123457,0.0246914,0.00411523,0.00411523,0.00411523,0.0246914,0.00823045,0.00823045,0.00823045],"ids":[8,108,803,126,907,227,117,386,193,265,489,793,734,493,594,385,466,879,925,732,144,146,895,933,108,819,672,391,734,364,915,285,886,734,200,421,486,61,989,458,10,848,862,147,153,125,518,23,809,985,120,356,383,760,893,564,742,19,651,843,7,291,86,403,532,820,786,887,510,96,254,298,64,311,116,517,91,605,364,128,795,98,269,215,237,652,378,692,702,895,175,503,67,960,355,679,791,522,212,826,353,18,999,885,46,854,875,8,629,318,982,645,980,290,955,287,41,841,403,738,429,532,314,191,274,27,838,83,535],"ngrams":["sn","ps","di","gr","ag","iv","ža","dž","le","kl","ed","to","kš","in","ju","de","ty","ra","^g","su","be","or","am","ti","gy","li","da","ga","et","uk","io","iu","eg","rs","st","ur","^b","^k","a$","tu","ie","i$","^d","ka","en","ji","pe","u$","nd","ri","im","me","ky","ok","mo","ki","yk","ol","e$","vo","sa","yv","ly","ių","^s","ea","is","oj","s$","ni","av","ip","ų$","jų","ar","mi","ve","ng","vi","po","ai","ik","an","ta","ne","rų","la","gi","aj","št","il","us","nt","pa","^m","au","ij","ėj","^p","ko","er","as","ge","^u","al","^n","un","^a","ja","dė","ųj","^i","^t","nk","te","it","ma","id","no","šs","ia","o$","l$","ku","ėl","si","^$","iš","^l"],"ngram_size":2,"dimension":1000},{"language":"lt","weights":[0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.0112994,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972,0.00564972],"ids":[3093,4582,406,2636,2012,226,1168,3387,3428,3987,3267,3677,732,2457,1062,280,2081,1067,1323,3890,4644,1726,2055,4473,4658,4407,4118,147,1314,1244,2187,109,3464,4069,3766,350,860,2573,75,3752,2793,254,4854,432,1176,3707,3113,4840,1646,2556,103,2764,3203,4125,4736,1607,3056,4657,915,3202,3827,3222,31,2680,2798,4503,4386,4567,3672,1465,4660,2649,260,3959,2030,77,1268,2713,2333,4422,1541,4372,1079,2237,1018,1825,332,2054,1693,3944,2645,4224,3471,2370,3688,135,3946,1733,3858,4856,1428,4274,4834,1590,841,707,1471,2352,344,1624,2406,4788,970,3095,4339,4058,4263,739,4043,3124,3760,2434,2551,2818,3548,2414,4807,4089,864,4415,2974,1669,3102,3057,4970,1936,3195,3688,4409,446,923,304,1615,1713,4728,752,2329,1914,1128,1668,133,497,1075,2442,2751,824,18,3971,860,4707,1605,2270,1496,4370,4583,1704,4215,4379,1360],"ngrams":["tai$","ipsn","psni","laip","aips","nis$","indi","grin","agri","pagr","^pag","site","rsit","nive","^uni","edža","oled","etas","kole","tas$","^kol","kla$","moky","oji$","kykl","toji","štoj","ledž","aukš","^auk","rind","ersi","mas$","nima","džas","inim","vini","avin","lavi","ilav","sila","šsil","ora$","univ","^por","ali$","idea","^ide","asi$","uras","maja","teta","savo","egam","iaus","ųjų$","^gyv","liu$","aliu","gali","^sur","gama","nega","idėj","rių$","nti$","usio","gyve","žas$","kuri","^neg","^kur","vent","^išs","^be$","kai$","lyka","ajam","^tu$","tarų","alyk","kšto","sura","daly","^dal","ėja$","nki$","penk","okyk","amaj","ykai","inis","^pen","iau$","ykla","iega","snis","okia","imas","tyki","geri","yven","imok","^met","simo","pora","^san","ykių","mieg","dini","anty","asim","sant","egal","^lai","eria","jame","ungi","avo$","^sav","etai","rųjų","^mie","urių","^ger","pasi","iko$","past","kių$","^pas","deal","aiko","asta","laik","rasi","^dėl","ukšt","dėl$","vers","šsij","ausi","ndin","dėja","^idė","arųj","išsi","enki","jung","ntyk","ano$","^mok","enti","eali","^man","riau","iver","kiau","mano","^po$","sio$","gia$","ijun","ngia","ame$","itet","moki","meta","siju","star"],"ngram_size":4,"dimension":5000},{"language":"lt","weights":[0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.0143541,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.00956938,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00956938,0.00478469,0.0143541,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00956938,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00956938,0.00478469,0.00478469,0.00478469],"ids":[2333,23,230,2386,2713,1383,1494,4763,3827,2353,579,110,2797,1684,4188,2034,1859,7,566,4833,1386,2299,3104,3049,3454,3641,4405,2111,4420,1721,2892,4002,2522,4599,275,4511,3325,1507,1558,4190,2585,1344,400,4285,4180,4995,4981,3121,2624,531,2247,831,2420,1732,3592,156,256,3848,4257,1964,754,2488,3881,1580,2861,504,4223,3194,295,582,1281,2828,245,256,933,4984,2025,4150,2047,1783,284,971,1486,4913,3856,2575,1585,3519,3254,1410,4995,3875,625,4829,3990,592,2143,3939,796,4572,1471,327,3848,927,1204,442,1756,3669,4171,3625,1589,1162,1936,4814,4814,2185,1484,4112,1849,539,1174,3153,2379,2260,1674,1610,989,2911,2403,4731,3288,633,2387,3382,1301,4923,2618,3046,2085,4826,2110,3479,3465,4981,3082,65,867,1859,1794,2759,374,1330,2903,2603,1948,367,1474,1318,1071,611,2316,3856,1745,2599,1418,1227,814,2190,3629,2436,623,442,2941,3740,4869,4660,3704,2841,2170,897,2428],"ngrams":["psn","aip","nis","din","pag","tas","eta","tet","rsi","niv","^un","ive","žas","ole","kol","la$","ykl","kyk","oky","što","edž","auk","as$","mas","ind","nim","vin","avi","^au","sil","ora","ima","li$","eal","si$","ras","toj","ura","ndi","sur","^su","kla","ame","kšt","jam","aja","maj","^tu","ama","ite","ieg","led","mie","ti$","lav","ki$","nti","ven","tai","^po","yve","sit","ers","ali","ini","gal","sni","ega","uri","sta","kur","^ku","ji$","kai","gri","iau","yka","met","lyk","šsi","aly","nki","^pe","gyv","oki","imo","nty","^mi","dal","ųjų","ant","oji","rių","^id","ių$","san","^ge","ent","tu$","yki","tyk","vo$","ia$","be$","jų$","ai$","ung","ukš","arų","pen","tar","^sa","^ma","dža","^pa","iu$","ger","po$","lai","^ko","^da","rin","sio","^be","neg","usi","aus","ko$","ila","no$","ano","ria","^la","iko","agr","ast","sav","aik","eri","por","gam","mok","^ne","dėl","ra$","kia","idė","ėl$","ngi","io$","man","^gy","ide","pas","au$","^mo","^dė","ips","rųj","is$","ver","enk","^me","kių","^iš","uni","dea","sij","avo","gia","me$","sim","ja$","dėj","išs","jun","ėja","asi","liu","iju","^a$"],"ngram_size":3,"dimension":5000},{"language":"lt","weights":[0.00361011,0.00361011,0.0144404,0.032491,0.0144404,0.0252708,0.0252708,0.0108303,0.00722022,0.0433213,0.0216607,0.0397112,0.0144404,0.0288809,0.0433213,0.032491,0.0180505,0.111913,0.115523,0.032491,0.0216607,0.0577617,0.122744,0.0361011,0.122744],"ids":[78,11,73,2,57,77,24,3,79,79,0,22,65,21,20,59,5,96,66,0,88,44,68,19,52],"ngrams":["ž","b","ų","l","v","p","r","š","ė","e","d","o","y","t","n","u","j","a","i","m","g","s","$","k","^"],"ngram_size":1,"dimension":100},{"language":"lv","weights":[0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.0130435,0.0130435,0.00434783,0.00434783,0.00434783,0.00869565,0.0130435,0.00434783,0.00869565,0.00434783,0.00434783,0.0130435,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.0173913,0.00434783,0.00434783,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.00434783,0.00434783,0.00869565,0.0130435,0.00869565,0.0130435,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.0173913,0.00869565,0.00434783,0.0130435,0.00434783,0.00434783,0.00434783,0.0217391,0.0130435,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.0130435,0.00434783,0.026087,0.0130435,0.00869565,0.00434783,0.0391304,0.00869565,0.00434783,0.00434783,0.0130435,0.0217391,0.00434783,0.0173913,0.00434783,0.0217391,0.00434783,0.0173913,0.00434783,0.00434783,0.00434783,0.0217391,0.00434783,0.00434783,0.0173913,0.00869565,0.00434783,0.0304348,0.0217391,0.00434783,0.00869565,0.0130435,0.00869565,0.00869565,0.00434783,0.0130435,0.00434783,0.00869565,0.00434783,0.0217391,0.00869565,0.0130435,0.00434783,0.00869565,0.0130435,0.00434783,0.00869565],"ids":[615,734,265,102,973,10,410,732,566,438,893,535,540,173,985,780,340,848,409,841,248,960,212,476,763,770,83,530,925,337,191,670,955,989,609,391,300,153,963,404,518,526,854,885,877,754,379,7,147,520,61,32,458,950,365,980,955,41,511,651,321,385,23,909,342,630,842,919,68,378,157,875,793,996,122,303,128,271,795,577,116,786,510,819,349,379,230,645,23,577,403,91,28,740,784,803,356,532,28,898,819,702,416,18,98,829,215,269,545,200,984,575,75,838,80,8,879,955,104,114,327,943,178],"ngrams":["ķu","kš","kl","�k","el","ie","em","^š","ņe","aņ","mo","^l","os","ei","ri","pu","l�","i$","v�","id","n$","pa","^p","^c","ad","ēm","ul","dē","^g","�m","ku","ms","�l","a$","i�","ga","m$","ņi","ci","ec","pe","on","^n","^u","ez","af","īt","sa","ka","zp","^k","lē","fi","tī","tr","^t","te","ma","zo","e$","ēp","de","u$","tl","gv","at","�ņ","šķ","^j","la","na","un","to","ds","sl","c$","po","sm","ai","oš","ar","is","s$","li","se","zm","iz","^i","ēj","�$","no","�r","kt","j�","ņa","di","iņ","^s","ēg","ts","ša","aj","tē","as","ik","sk","ta","an","ir","st","rt","rd","op","^$","nu","^a","ra","k�","sp","do","r$","ot","p�"],"ngram_size":2,"dimension":1000},{"language":"lv","weights":[0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0182927,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.0121951,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.0121951,0.00609756,0.00609756,0.0121951,0.0121951,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756,0.00609756],"ids":[2398,2281,3308,4942,259,4840,58,4462,3576,3444,4147,3864,659,3746,2777,3503,4339,4209,3002,1333,334,4418,848,2891,2572,2226,949,3521,4006,2787,1151,3399,2402,3630,3618,4126,3400,4510,1536,3673,3111,258,976,1087,697,4981,2773,86,3450,2861,2473,1848,3203,4061,308,119,3165,4551,4005,790,4166,3086,1614,3281,9,2773,4100,2094,4228,2373,3890,3142,4342,2217,2219,2537,167,3258,2988,3922,4303,1387,4734,3147,1988,1295,601,3234,2354,2850,4776,1631,2652,4155,2119,1717,3057,3684,1192,4159,4962,1360,205,2333,598,275,3348,637,4175,577,1804,4584,1876,2798,3542,40,1928,4796,437,369,2254,3126,3705,677,4226,956,1197,1221,3367,1719,129,2486,4754,308,1268,3383,368,1445,2729,3102,38,1305],"ngrams":["ikšķ","klik","^kli","�ku$","l�ku","iel�","liel","^lie","ems$","ņems","saņe","aik�","aj�$","^šaj","mos$","osmo","^lai","tos$","ktos","teik","note","�ri$","l�ri","ul�r","eikt","opul","popu","^pop","zona","ēgv�","ošan","tslē","atsl","^ats","ēpoš","^un$","gv�r","likš","otei","�ņi$","stas","^par","lēgv","^ir$","^gad","aidē","j�m$","rdi$","aj�m","laj�","i�la","idēm","posm","�rdi","eci�","^spe","ide$","aras","šķu$","anu$","šanu","onas","para","ik�$","ezon","^izp","sezo","^sez","šana","^ar$","tas$","spec","nas$","ītas","stīt","izma","aide","istī","aist","doša","slēp","sais","^kas","^atl","iņas","�laj","el�k","aņem","fik�","^tra","ika$","ņas$","p�rd","maiņ","izp�","rast","laik","^izm","laid","rafi","tlai","^sai","smos","zmai","j�ņi","zp�r","atla","^j�ņ","dēm$","lēpo","slēg","tēj�","rtēj","ci�l","^slē","peci","kšķu","ana$","tīta","poša","^saņ","adsk","dsk�","gads","�rtē","šaj�","aika","rdoš","pul�","k�rt","kas$","�rdo","^pos","^not","aiņa","traf","v�rd","afik","ikto","asta","sk�r","ēj�$"],"ngram_size":4,"dimension":5000},{"language":"lv","weights":[0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.0153061,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.0102041,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.0153061,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.0102041,0.0204082,0.0102041,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0153061,0.0153061,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0306122,0.00510204,0.00510204,0.00510204,0.0102041,0.0102041,0.0153061,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.0102041,0.0102041,0.0102041,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.0102041,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204,0.00510204],"ids":[4095,4274,3378,3902,3379,1615,1615,721,1856,3006,4148,4132,1653,1792,3722,1460,3133,1294,2030,2355,4916,1709,1468,4433,1046,3019,503,2537,4059,2017,2454,1964,1755,490,273,4237,2319,1820,360,579,2013,3433,582,4923,1200,4530,4146,2364,2766,3809,1057,4511,4031,2390,1292,1482,3573,3718,1171,2387,2690,605,4858,3489,2868,4094,3380,3697,2477,3571,4230,522,1378,645,4017,1848,2137,665,3471,4538,705,128,3606,3468,2657,484,3123,4697,4814,1162,3669,1002,1849,1849,3637,4770,4322,708,1376,2475,1445,4243,2803,2200,2582,4478,1886,3187,1971,3487,2689,3109,1925,3166,3438,1138,2340,797,3104,2428,184,969,4983,4673,1680,3861,2903,2715,2775,755,3368,2741,3657,4229,1383,3046,3817,3195,987,1484,4191,671,4627,1463,2949,2887,2861,2309,3509,759,2595,4965,1651],"ngrams":["kšķ","ikš","kli","ku$","�ku","l�k","el�","iel","lie","^li","ms$","ems","saņ","šaj","^ša","smo","osm","pos","ka$","ika","os$","kto","ikt","eik","ote","tos","^no","�ri","ul�","opu","pop","^po","di$","rdi","lik","lēg","tsl","ats","un$","^un","slē","^iz","sta","ast","zp�","ara","^sl","par","ir$","^c$","^u$","ras","dēm","idē","eci","�la","spe","atl","aj�","^la","nu$","anu","ēm$","ēgv","nas","ņem","aiņ","zon","gad","ezo","sez","tei","not","doš","ar$","^at","laj","^ar","īta","ona","tīt","aid","^se","l�r","k�$","stī","i�l","ist","^pa","^sa","ci�","kas","lai","^ka","aņe","ik�","fik","raf","tra","ķu$","^ir","sai","dsk","iņa","v�r","ēj�","oša","�rd","de$","ņas","tla","^sp","šķu","zma","rtē","izm","ņi$","�ņi","as$","^a$","j�ņ","ēpo","izp","na$","šan","gv�","ide","�rt","rdo","^tr","mos","ads","p�r","j�$","tas","aik","^j�","�m$","ais","k�r","j�m","^kl","mai","tēj","poš","ri$","ana","sk�","pec","afi","lēp","pul","^ga"],"ngram_size":3,"dimension":5000},{"language":"lv","weights":[0.00378788,0.00757576,0.0227273,0.00378788,0.0378788,0.0227273,0.0340909,0.030303,0.0113636,0.0719697,0.0151515,0.0151515,0.0378788,0.00378788,0.0416667,0.128788,0.0378788,0.0492424,0.0227273,0.0227273,0.0189394,0.00378788,0.128788,0.0151515,0.0719697,0.0189394,0.00757576,0.113636],"ids":[33,58,59,30,21,20,22,77,38,66,5,10,24,57,2,52,19,22,79,0,3,22,68,86,44,0,88,96],"ngrams":["ķ","c","u","ī","t","n","o","p","ņ","i","j","ē","r","v","l","^","k","�","e","d","š","f","$","z","s","m","g","a"],"ngram_size":1,"dimension":100},{"language":"mg","weights":[0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.0119522,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.0159363,0.00398406,0.00398406,0.00398406,0.00796813,0.0119522,0.00796813,0.00398406,0.0159363,0.00796813,0.0119522,0.00398406,0.0159363,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00398406,0.00796813,0.00398406,0.00398406,0.0159363,0.0119522,0.00398406,0.00398406,0.0199203,0.0159363,0.00398406,0.0119522,0.00398406,0.0119522,0.00796813,0.0199203,0.00398406,0.00796813,0.00796813,0.0278884,0.00398406,0.00398406,0.00398406,0.00796813,0.00398406,0.00398406,0.00796813,0.0478088,0.00796813,0.00398406,0.0199203,0.0159363,0.00796813,0.00796813,0.0239044,0.0119522,0.0159363,0.00398406,0.0199203,0.00398406,0.00398406,0.00398406,0.00398406,0.0438247,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00398406,0.00398406,0.00796813,0.0199203,0.00796813,0.00398406,0.0278884,0.00796813,0.00398406,0.00398406,0.00796813,0.0278884,0.00796813,0.0278884,0.00398406,0.0119522,0.00398406,0.00398406,0.0119522,0.00398406,0.0119522,0.0119522,0.0159363,0.0159363,0.00398406],"ids":[532,458,933,23,34,745,176,973,193,937,114,648,540,183,265,651,575,19,18,601,108,534,760,553,7,334,672,90,215,29,591,265,116,422,61,842,327,795,780,515,517,989,955,287,31,791,630,378,493,365,535,898,943,980,694,403,466,879,392,421,200,752,757,795,98,989,501,685,147,862,591,429,251,848,975,803,854,463,925,355,267,605,175,353,803,734,27,842,353,748,493,838,677,269,571,985,976,738,157,153,645,875,481,96,786,895,75,146,248,8,532,128],"ngrams":["^s","fi","ti","u$","gu","ug","lu","el","le","og","do","ov","os","he","re","e$","^e","ol","as","ho","ak","oo","ok","go","sa","^r","da","^f","ta","oh","ro","pi","ar","ks","^k","fa","r$","ah","va","ry","eu","gl","te","it","pé","ij","at","la","lo","tr","^l","ts","ot","^t","of","no","ty","ra","ér","ur","st","ha","ek","ai","ik","a$","ba","je","ka","^d","ke","ia","ny","i$","ao","sy","^n","ih","^g","^m","eh","y$","il","er","di","et","si","fo","^h","mb","in","^$","ef","an","mp","ri","^o","so","na","en","^i","k$","hi","ni","is","am","op","or","n$","^a","o$","po"],"ngram_size":2,"dimension":1000},{"language":"mg","weights":[0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0228571,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0171429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0171429,0.0114286],"ids":[2938,3670,2972,1027,4629,3865,2798,1198,1843,3708,3272,1890,3786,1749,808,954,179,237,1832,3845,2552,2568,2456,1592,1285,2667,1108,4796,3249,3719,3188,4139,4955,2148,4723,3771,2709,4662,3261,658,4252,2448,3449,3088,3551,1154,1910,2770,4163,818,2405,4546,249,4084,1677,1510,378,2436,3229,2004,4814,3016,504,472,237,4512,2683,345,1825,700,3619,4318,3079,2726,1946,3136,4049,858,1884,4465,3439,4293,2054,3825,26,2786,4230,2098,4328,3712,2520,1647,4873,4892,577,2683,1087,979,1615,3104,1389,742,1389,53,2655,1236,366,2686,4007,1524,4922,4443,3830,3703,3100,639,770,3322,2705,3012,1329,3118,4568,1635,2938,1989,3633,3764,680,1557,2547,4325,2451,4829,4530,1672,3028,3497,311,2224,937,1412,317,3430,3832,907,4776,3615,1512,3275,2250,4029,1547,1909],"ngrams":["lak$","itak","nita","^ren","roha","ikar","fika","^fik","laka","kela","^tak","tin$","lugu","elug","telu","^tel","gle$","ogle","oogl","goog","^goo","arot","baro","mbar","amba","kamb","okam","ana$","vana","sao$","ampi","atan","^nos","hana","ehet","rehe","tana","rotr","doka","^reh","aova","teny","mpia","ahat","^ten","reni","pias","osor","naov","olo$","ary$","ahol","karo","sta$","rata","take","péra","hetr","^kar","lain","^efa","sary","^ana","holo","teur","etra","otra","iana","eny$","rate","^dat","ovan","iasa","sihi","aina","érat","pori","^opé","ina$","ugu$","^ila","atra","ratr","ilai","orat","tsor","atso","^dok","isih","^an$","rohi","hats","noso","anof","eur$","aka$","laha","^ny$","ateu","ity$","hina","ery$","iny$","asao","^tsy","fots","^ian","ihin","nofo","^ran","dati","^dik","ksta","elak","dika","efa$","ekst","teks","tsin","risi","mpor","akel","^tek","enit","ohin","oris","daho","tra$","jery","^dah","ijer","rano","hije","^hij","^mba","aroh","tsy$","ofot","nao$","^sar","^lah","hin$","atin","^ity","siny","sora","ika$","opér","otsi","mba$","ohan","ampo","anao","^amp"],"ngram_size":4,"dimension":5000},{"language":"mg","weights":[0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00943396,0.00471698,0.00943396,0.00943396,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00943396,0.00471698,0.00471698,0.00471698,0.00471698,0.00943396,0.00471698,0.00471698,0.00471698,0.00471698,0.00943396,0.00471698,0.00943396,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00943396,0.00943396,0.00471698,0.00471698,0.00471698,0.00943396,0.0141509,0.00943396,0.0141509,0.00471698,0.00471698,0.00471698,0.00943396,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.0141509,0.00943396,0.00943396,0.00471698,0.0188679,0.00471698,0.00471698,0.00471698,0.00471698,0.0141509,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.0141509,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.0141509,0.00471698,0.00471698,0.00943396,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.00471698,0.0141509,0.00471698,0.00471698,0.0235849,0.00943396,0.00471698,0.00471698,0.00471698,0.00471698,0.00943396,0.00471698,0.00471698,0.00471698,0.0188679,0.00471698,0.00471698,0.00471698,0.00471698,0.00943396,0.00471698,0.00471698,0.0283019,0.00943396,0.00471698,0.00471698,0.00471698,0.00471698,0.00943396,0.0141509,0.00943396,0.00471698,0.00943396,0.00471698,0.00471698,0.00943396,0.00471698,0.00471698,0.00943396],"ids":[1618,3896,4932,4322,1852,1162,2277,1960,129,1103,2151,2120,40,193,4497,159,1010,1818,2672,2446,4388,1821,2229,3079,2626,4650,1194,2224,2890,3538,3643,2918,1905,503,2054,3870,2667,4356,1357,3612,238,4872,3719,16,3618,3688,3068,2959,3028,1849,1849,806,3629,2483,4710,1915,2511,2696,1302,980,1881,357,4016,3082,3487,1376,1139,2019,136,2892,1305,4434,3913,2403,2223,1337,1820,4009,365,2017,4161,3414,2254,3341,1672,3741,4673,3239,1640,3478,1645,1121,130,4071,4826,3264,145,2453,356,1814,3288,343,1630,3721,4552,4689,16,563,582,2030,1341,62,14,2387,3423,3185,3407,3310,4381,2558,4520,775,2861,1174,2092,2917,3054,2129,2266,3230,853,2110,1942,2115,3375,4696,384,2355,2357,1658,537,4699,1332,957,2608,1685,4272,2147,3931,4743,3488,3915,2568,1414,998,1594,4258],"ngrams":["ak$","nit","ary","fik","sar","^sa","^fi","ela","han","kel","tak","^ta","dat","gu$","le$","gle","ogl","goo","^go","otr","tel","rot","kam","oka","^do","van","sao","asa","tan","ata","eni","ren","oso","^no","het","reh","^re","amb","eny","pia","hol","amp","ten","ita","^mb","ohi","roh","bar","sor","lai","^ka","efa","ur$","eur","pér","tek","^op","lak","ina","^il","oog","opé","kar","ra$","ity","tra","ehe","ris","olo","ora","ati","ihi","tso","ila","dok","ian","ats","ova","dah","hat","^ts","aha","rat","ty$","^it","atr","na$","an$","iny","sin","tsi","aro","ots","fot","por","éra","nof","nao","ate","oha","ano","sy$","ori","^ra","kst","mpo","^te","lug","sta","ka$","dik","elu","lo$","^la","ery","jer","aka","lah","^di","^i$","etr","ba$","ana","^da","^ia","aho","ije","sih","^am","ias","tsy","isi","^ny","^hi","mpi","ta$","eks","ika","^ef","aov","ny$","ry$","ugu","teu","ain","hij","mba","ao$","^an","tin","hin","ofo","fa$","ake","nos","ran","in$"],"ngram_size":3,"dimension":5000},{"language":"mg","weights":[0.0103448,0.00344828,0.037931,0.0655172,0.0586207,0.0137931,0.0413793,0.00344828,0.0103448,0.00689655,0.0655172,0.0241379,0.0551724,0.0241379,0.00344828,0.0103448,0.0310345,0.134483,0.0137931,0.0655172,0.148276,0.0103448,0.0275862,0.134483],"ids":[88,58,65,20,21,0,79,5,59,11,22,63,24,2,57,77,19,52,0,66,96,22,44,68],"ngrams":["g","é","y","n","t","d","e","j","u","b","o","h","r","l","v","p","k","^","m","i","a","f","s","$"],"ngram_size":1,"dimension":100},{"language":"mi","weights":[0.0134228,0.0201342,0.00671141,0.0134228,0.0134228,0.00671141,0.00671141,0.00671141,0.00671141,0.00671141,0.033557,0.00671141,0.00671141,0.00671141,0.00671141,0.0134228,0.0134228,0.00671141,0.0201342,0.00671141,0.00671141,0.0134228,0.0604027,0.0402685,0.0134228,0.00671141,0.0268456,0.0134228,0.0134228,0.0671141,0.00671141,0.0469799,0.0268456,0.0268456,0.0536913,0.0201342,0.0134228,0.00671141,0.0469799,0.00671141,0.0671141,0.0134228,0.00671141,0.0134228,0.0536913,0.00671141,0.00671141,0.0201342,0.0469799,0.0268456],"ids":[495,795,717,98,933,23,355,679,630,146,955,780,793,553,935,879,263,429,481,915,215,269,532,391,838,975,493,29,353,651,623,147,848,564,61,265,8,157,976,108,989,334,893,183,980,854,875,752,605,353],"ngrams":["wh","ai","^w","ik","ti","u$","^m","au","at","or","te","pu","to","go","ap","ra","ae","ia","hi","io","ta","an","o$","ga","^$","ao","in","oh","er","e$","aw","ka","i$","ki","^k","re","^a","na","^o","ak","a$","^r","mo","he","^t","^n","un","ha","ng","^h"],"ngram_size":2,"dimension":1000},{"language":"mi","weights":[0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0379747,0.0379747,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0253165,0.0126582,0.0126582,0.0126582,0.0126582,0.0253165,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0632911,0.0126582,0.0126582,0.0126582,0.0126582,0.0379747,0.0759494,0.0126582,0.0253165,0.0253165,0.0379747,0.0126582,0.0126582,0.0126582,0.0379747,0.0126582,0.0253165],"ids":[1884,1389,1493,982,414,653,4236,4455,2547,3293,155,2810,1169,1452,3247,1765,1616,2028,4816,6,3158,2100,351,2381,1578,1620,2029,3729,237,4415,841,1215,4539,186,2907,3497,4607,3387,1795,1835,488,4243,4864,2980,3999,334,1273,722,1231,4280,3804,2774,2122,879,3183],"ngrams":["ina$","hina","whin","awhi","atik","^wha","unga","akat","whak","anga","kang","ohio","aing","inga","tika","^tik","^moh","^au$","ore$","apun","aore","kati","^to$","haka","gohi","haer","rapu","^tan","kaor","^kao","^hae","ohia","tang","^ka$","mohi","^rap","ikan","pung","^te$","tiki","hia$","^awh","^nga","kain","nga$","ngoh","aere","^he$","^kai","hio$","ango","iki$","^ki$","^ra$","ere$"],"ngram_size":4,"dimension":5000},{"language":"mi","weights":[0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.0176991,0.0176991,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.0265487,0.0530973,0.0530973,0.0265487,0.00884956,0.00884956,0.0442478,0.0442478,0.0265487,0.00884956,0.0442478,0.00884956,0.0353982,0.00884956,0.0265487,0.00884956,0.00884956,0.00884956,0.0176991,0.0265487,0.00884956,0.00884956,0.0619469,0.00884956,0.0176991,0.0176991],"ids":[4673,3488,1858,2625,1080,3082,1305,642,3407,818,2785,1512,2759,367,1987,2355,4905,751,2976,2120,1756,1903,3721,1353,3848,4040,3358,919,873,2891,1909,1426,3688,1302,2890,4324,4092,4207,4975,2608,1948,2217,67,1849,256,2441,16,1229,156,3944,3552,4420,150,1442,1680,504,2030,702,2581,888,4102,2186],"ngrams":["na$","hin","whi","^aw","^ng","ra$","ati","kat","aka","wha","kan","tik","io$","^mo","^ti","ika","aor","kao","^ha","^ta","ung","rap","^ra","to$","ia$","he$","aer","hio","^to","^he","iki","hia","ohi","ina","tan","hak","ing","ga$","nga","ain","au$","awh","te$","^ka","kai","pun","^te","moh","ki$","goh","^ki","^au","^wh","ore","ang","re$","ka$","ngo","^o$","apu","ere","hae"],"ngram_size":3,"dimension":5000},{"language":"mi","weights":[0.0108108,0.00540541,0.027027,0.0648649,0.124324,0.0108108,0.0432432,0.194595,0.0594595,0.0648649,0.0432432,0.0648649,0.00540541,0.0378378,0.0486486,0.194595],"ids":[32,77,24,66,96,59,20,52,19,22,63,79,0,88,21,68],"ngrams":["w","p","r","i","a","u","n","^","k","o","h","e","m","g","t","$"],"ngram_size":1,"dimension":100},{"language":"mk","weights":[0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0147059,0.0147059,0.00735294,0.00735294,0.0147059,0.00735294,0.00735294,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0220588,0.0294118,0.00735294,0.0147059,0.0294118,0.0220588,0.00735294,0.0220588,0.0294118,0.0147059,0.00735294,0.0147059,0.00735294,0.0220588,0.0147059,0.0147059,0.00735294,0.0294118,0.0147059,0.0147059,0.00735294,0.0147059,0.0147059,0.00735294,0.0294118,0.00735294,0.0147059,0.0147059,0.0147059,0.0147059,0.0220588,0.0147059,0.0808824,0.0220588],"ids":[757,294,75,750,856,95,490,716,387,499,196,662,702,71,359,179,996,920,227,423,555,354,401,895,531,15,457,816,802,521,752,838,922,534,516,825,247,269,789,29,155,373,658,352,141,965,782,65,613,631,404,117,149,929,85,325,922,672,429,525,476,451,807,47,342,92,802,703,266,967,988,154,544,505,515,795,502,426,982,817,661],"ngrams":["он","ед","ке","^м","за","^з","зи","ет","�м","^а","ме","ра","вр","^е","ие","^ќ","ен","во","о�","^о","гу","ај","јм","об","ти","тк","рт","�в","ар","пм","у$","^$","ак","дп","би","гл","ро","па","^д","но","мр","вм","ев","^в","ци","^п","ма","ко","на","ќе","^�","^н","ат","не","^к","е$","ни","иц","и$","ое","та","ли","ал","ог","иј","оа","ви","из","^г","ов","те","ја","ит","ла","мн","ка","до","о$","а�","а$","�о"],"ngram_size":2,"dimension":1000},{"language":"mk","weights":[0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0326087,0.0217391,0.0217391,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0217391,0.0217391,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0326087,0.0217391],"ids":[3582,1491,4493,4728,4634,3073,163,1069,1767,4149,2775,4764,1486,2627,4784,4374,1130,1086,4346,1284,3793,4603,4777,3050,2158,4767,1319,975,2670,468,1582,3820,2359,4553,2544,4937,1176,1138,3543,269,288,3562,4268,4335,3714,2896,3681,1751,1989,3810,4496,593,2773,1139,2694,1514,1081,120,4118,1246,2440,3048,541,3588,2215,3426,1914,4198,3196,1666,817,3174,736,4217,1259,1122,2974],"ngrams":["нија","ониј","кедо","маке","^мак","^за$","зија","изиј","етка","^�ме","вра$","евра","обие","^доб","^ќе$","воен","ла�о","�вое","огу$","о�во","^о�в","метк","ногу","�ови","мног","^�о$","ија$","ови$","тија","ени$","арти","^вмр","како","едон","гла�","ако$","акед","ткат","пмне","ите$","дпмн","лизи","алиц","^как","^дпм","мро$","а�ов","вмро","^пар","^на$","^коа","јата","^евр","ција","оали","доби","ициј","ката","ртиј","дони","оени","јмно","ијат","коал","вите","лици","ализ","овит","^нај","мне$","најм","парт","ајмн","�мет","бие$","ата$","^гла"],"ngram_size":4,"dimension":5000},{"language":"mk","weights":[0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0265487,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0265487,0.0176991,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0353982,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.0353982,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.0265487,0.0176991],"ids":[4855,812,3865,175,1062,4850,3618,3234,2560,3732,3929,3450,2208,4872,1994,1913,2078,4916,1691,4315,4724,4936,4125,1197,3671,1621,4356,3018,887,838,1822,4336,2701,2578,3262,2909,3865,4855,801,510,525,1783,3616,4477,2612,2377,990,2892,3991,4317,1110,2439,2422,2487,2247,2800,712,2514,4417,2967,1929,2484,4856,2387,157,4174,4226,2199,1168,1269,471,4066,3206,4489,4633,3343,4841,3228,3024,217,4559,763,4847,3103,2355,1263,2840,1058,3626],"ngrams":["дон","едо","аке","мак","^ма","�ме","^а$","ра$","вра","евр","^ев","ие$","оби","доб","^до","кед","ќе$","ви$","ени","лиз","^�м","вое","етк","�во","тка","о�в","гу$","огу","на$","ако","јмн","^вм","нај","^�о","гла","арт","�ов","^па","ко$","изи","мет","^ко","^ка","мне","зиј","^дп","ног","мро","ајм","рти","пмн","ата","ла�","пар","јат","как","ниј","ро$","оен","вит","ија","бие","^ќе","ја$","ни$","тиј","лиц","^о�","дпм","али","вмр","те$","оал","ите","�о$","не$","коа","за$","^на","^за","ови","циј","они","мно","ици","а�о","кат","та$","^гл"],"ngram_size":3,"dimension":5000},{"language":"mk","weights":[0.00628931,0.0125786,0.0188679,0.0314465,0.00628931,0.0503145,0.00628931,0.00628931,0.0377358,0.0503145,0.0377358,0.0188679,0.0628931,0.0754717,0.0314465,0.0125786,0.0314465,0.0251572,0.144654,0.0188679,0.0314465,0.138365,0.144654],"ids":[26,41,10,85,79,81,72,56,39,30,20,82,98,15,49,50,10,44,68,15,86,63,52],"ngrams":["б","п","д","м","у","н","ц","ќ","к","е","т","р","и","о","�","з","в","л","$","г","ј","а","^"],"ngram_size":1,"dimension":100},{"language":"ml","weights":[0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0326087,0.0108696,0.0108696,0.0108696,0.0108696,0.0326087,0.0108696,0.0217391,0.0326087,0.0326087,0.0217391,0.0217391,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0108696,0.0434783,0.0108696,0.0217391,0.0108696,0.0108696,0.0326087,0.0217391,0.0326087,0.0108696,0.0217391,0.0217391,0.0108696,0.0326087,0.0108696,0.0217391,0.0108696,0.0108696,0.0217391,0.0108696,0.0108696,0.0108696,0.0326087,0.0108696,0.0108696,0.0217391],"ids":[354,237,564,938,593,144,850,178,621,66,239,965,836,481,802,43,936,860,379,349,988,157,342,855,743,963,678,663,727,322,255,713,555,790,425,784,11,449,156,458,439,649,384,394,614,916,320,369,841,700,916,187,152,167,119,987,562,28,342,261,838],"ngrams":["റ�","േറ","എഴ","പ�","�റ","നേ","ിപ","രി","യി","�പ","ിയ","ഴ�","തി","^പ","റ�","ന�","ിങ","�ം","�ന","ഔട","�ട","ഉട","ിര","ന�","ടെ","ിന","നി","^ന","പി","ില","മ�","ര�","ഞങ","അങ","അവ","^ഔ","�$","^എ","ള�","^ഉ","ങന","ങ�","ങള","�$","മ�","നെ","ം$","^ഞ","െ$","ട�","ല�","വര","�മ","^അ","^ം","പത","�ന","�ങ","^മ","ടന","^$"],"ngram_size":2,"dimension":1000},{"language":"ml","weights":[0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.030303,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.030303,0.030303,0.0151515,0.030303,0.030303,0.0151515,0.030303,0.0151515,0.030303,0.0151515,0.0151515,0.030303,0.030303,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.030303,0.0151515,0.0151515,0.0151515,0.030303,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515,0.0151515],"ids":[3832,3650,515,700,249,3295,3365,1325,2900,638,2833,2096,3958,3756,2842,4065,2369,2294,4265,4251,3972,258,616,1922,516,3141,1990,4164,2292,6,160,1781,735,126,885,4266,1841,515,1159,1467,4361,2847,4615,1726,3428,3839,3890,4909,1908,2852,47,3551,131,4079,3554],"ngrams":["�റ�$","റ�റ�","േറ�റ","നേറ�","ന�നേ","�ന�ന","എഴ�ന","തിയി","^എഴ�","�നേറ","�ടെ$","�ങള�","പ�പി","യിരി","ിരിപ","^പതി","അവര�","ിങ�ങ","^ഔട�","ടനെ$","ട�ം$","^ഉടന","ഔട�ം","�ന�$","ന�ന�","രിപ�","ിന�ന","ില�$","ിപ�പ","നിന�","�ങനെ","പില�","പതിയ","^ഞങ�","ങള�$","�പില","^മ�മ","ങനെ$","ര�ടെ","വര�ട","മ�മ�","ങ�ങള","^അങ�","ിയിര","^നിങ","^നിന","അങ�ങ","ഞങ�ങ","മ�പി","ഉടനെ","ങ�ങന","നിങ�","�മ�പ","ഴ�ന�","^അവര"],"ngram_size":4,"dimension":5000},{"language":"ml","weights":[0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.025641,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.025641,0.025641,0.0128205,0.025641,0.0128205,0.025641,0.0384615,0.0128205,0.025641,0.0384615,0.0128205,0.0128205,0.0128205,0.0128205,0.025641,0.0128205,0.025641,0.025641,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205,0.0384615,0.025641,0.025641,0.0128205,0.0128205,0.0128205,0.025641,0.0128205,0.0128205,0.0128205,0.0128205,0.0128205],"ids":[777,3402,4810,1533,4854,3882,3664,848,2169,1184,1399,3315,581,498,1952,2526,1998,2297,287,122,3880,239,4385,611,4749,1497,788,2389,2378,2542,4838,4849,2073,1015,3926,3486,1131,446,1664,3137,3893,91,4044,3283,3457,1875,4368,681,1490,2475,2510,4823,1787,350,534,2655,2741,3234,4588,2126],"ngrams":["റ�$","�റ�","റ�റ","നേറ","ഴ�ന","എഴ�","^എഴ","പ�പ","ിപ�","�നേ","രിപ","ിരി","യിര","പതി","ങനെ","�പി","^പത","ിങ�","�ന�","�ടെ","ഔട�","ന�$","നിന","�മ�","ല�$","�ങന","ില�","ങ�ങ","തിയ","പില","^നി","�ം$","^ഔട","അങ�","^ഉട","�ന�","^അങ","ിന�","നെ$","േറ�","ടെ$","ര�ട","^ം$","ട�ം","വര�","ിയി","^അവ","മ�മ","ന�ന","ള�$","�ങള","ഉടന","അവര","ഞങ�","ങള�","^മ�","നിങ","മ�പ","ടനെ","^ഞങ"],"ngram_size":3,"dimension":5000},{"language":"ml","weights":[0.0188679,0.00943396,0.00943396,0.00943396,0.00943396,0.00943396,0.0188679,0.0188679,0.0188679,0.0283019,0.0377358,0.0660377,0.0566038,0.00943396,0.0188679,0.132075,0.00943396,0.00943396,0.122642,0.0283019,0.103774,0.0754717,0.0188679,0.0188679,0.132075,0.00943396],"ids":[67,1,22,95,29,46,58,50,42,53,65,12,61,80,72,52,58,62,3,43,31,34,2,13,68,90],"ngrams":["റ","എ","േ","യ","ത","ഉ","ല","അ","മ","ട","പ","�","ങ","ഔ","ര","^","ഴ","ഞ","�","െ","ന","ി","ള","ം","$","വ"],"ngram_size":1,"dimension":100},{"language":"mn","weights":[0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.020202,0.020202,0.010101,0.020202,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.020202,0.010101,0.010101,0.010101,0.030303,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.020202,0.020202,0.010101,0.010101,0.020202,0.010101,0.020202,0.020202,0.020202,0.010101,0.010101,0.030303,0.020202,0.010101,0.010101,0.010101,0.020202,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.020202,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.010101,0.020202],"ids":[874,676,568,556,960,784,575,469,377,712,544,464,776,789,233,505,726,492,849,307,679,13,423,302,540,382,50,127,871,610,563,672,997,789,320,849,397,209,987,689,864,42,28,246,892,213,404,117,499,678,663,653,669,454,757,632,106,778,548,78,838,628,780,905,735,923,925,95,868,678,817,247,555,20,935,826,967,589,436,898,361],"ngrams":["үг","хү","үү","нх","гө","рө","ч$","м$","�м","р�","ан","�а","өр","^д","ө$","ла","цу","өм","зо","ж$","лж","дү","^о","уу","х$","лд","нг","у�","�и","л�","йл","иц","г$","үй","^ү","йг","л$","ол","жи","аж","үр","ий","^у","тг","ут","ну","^�","^н","^а","ул","ор","ду","ги","ил","он","^б","ох","^х","в�","н$","^$","өн","го","хи","йн","лг","хө","^з","й$","ах","а$","ро","гу","�р","мч","^ө","ов","уй","ло","�л","бо"],"ngram_size":2,"dimension":1000},{"language":"mn","weights":[0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.028169,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.028169,0.0140845,0.0140845,0.028169,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845,0.0140845],"ids":[1029,4963,4040,1733,790,3035,510,4256,4024,3279,1436,1022,391,767,423,488,383,2920,2715,2889,2798,2938,821,2326,3145,337,450,3875,4207,3272,4849,3765,338,4461,173,1548,4973,201,2697,3305,3996,420,2553,58,2415,2541,1425,2697,2129,1451,3660,1874,2056,4698,2666,2404,2940,377,944,2111,3949,3585,2502,581,2006,4248,1073,2067],"ngrams":["үүги","анхү","үгий","�анх","өнгө","хөрө","^хөр","р�м$","дүр�","^дүр","лах$","улах","хицу","^ажи","лдуу","у�лд","ийг$","нхүү","�ийг","л�ий","^�ан","^үйл","рөнг","жил$","цуул","ажил","�лду","өрөн","тгий","олго","^нут","олов","орон","^өмч","улж$","гох$","боло","дуул","нутг","гийн","йл�и","охиц","үйл�","нгуй","уула","лгох","^у�л","утги","онгу","ийн$","в�ро","гуй$","^бол","^оро","уулж","ронг","үр�м","болг","�рон","ицуу","ов�р","хүүг","рон$","өмч$","зохи","^зох","нгө$","лов�"],"ngram_size":4,"dimension":5000},{"language":"mn","weights":[0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0238095,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0238095],"ids":[634,1170,1710,2517,4359,76,2482,3241,2940,3628,4298,667,487,2809,4588,1519,2252,2662,3384,3457,1807,4814,407,4920,1287,1370,1770,1123,3288,1621,3460,1977,781,2508,860,2410,4726,614,3549,252,2883,3138,944,1712,1891,322,4578,1292,357,3638,996,3611,335,35,4683,117,4836,4310,403,3178,1569,2479,3052,4488,521,3636,1821,3004,2538,3618,3542,4960,4867,1152,725,4607,1339],"ngrams":["үүг","хүү","�ан","^�а","нгө","өнг","нхү","өрө","хөр","^хө","мч$","үр�","дүр","^дү","ах$","лах","охи","өмч","^ну","^зо","ула","�ро","дуу","лду","уул","�лд","йг$","ийг","үги","лго","ил$","жил","гө$","рөн","ицу","ажи","�ий","йн$","лов","ийн","гий","тги","утг","нут","^у�","ов�","олг","хиц","уй$","он$","лж$","^ор","гуй","үйл","нгу","анх","оло","рон","оро","цуу","^үй","�м$","гох","зох","йл�","улж","л�и","^аж","ох$","^а$","р�м","у�л","онг","^өм","бол","в�р","^бо"],"ngram_size":3,"dimension":5000},{"language":"mn","weights":[0.0175439,0.00877193,0.0175439,0.00877193,0.0175439,0.00877193,0.00877193,0.131579,0.00877193,0.0438596,0.0438596,0.0438596,0.0701754,0.0350877,0.131579,0.0263158,0.00877193,0.0614035,0.0175439,0.0350877,0.0614035,0.0614035,0.0350877,0.0350877,0.0526316,0.00877193],"ids":[85,72,10,32,81,20,70,52,10,98,52,36,15,82,68,49,50,44,26,97,79,81,63,47,15,52],"ngrams":["м","ц","д","�","ж","т","ч","^","в","и","х","й","о","р","$","�","з","л","б","ү","у","н","а","ө","г","�"],"ngram_size":1,"dimension":100},{"language":"mr","weights":[0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.00275482,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.00826446,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00826446,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00550964,0.00550964,0.00275482,0.00275482,0.00275482,0.00550964,0.00275482,0.00550964,0.00275482,0.00550964,0.00275482,0.0110193,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.00275482,0.00275482,0.00826446,0.00275482,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.0110193,0.00275482,0.00275482,0.0110193,0.00550964,0.0110193,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00826446,0.00550964,0.00275482,0.0220386,0.00275482,0.00550964,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00550964,0.0110193,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.0137741,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.0110193,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.00550964,0.00275482,0.00275482,0.00826446,0.00275482,0.00275482,0.00275482,0.00550964,0.00275482,0.00550964,0.00275482,0.00275482,0.00550964,0.0192837,0.00275482,0.00275482,0.00275482,0.0110193,0.00275482,0.00275482,0.00275482,0.0137741,0.00550964,0.00275482,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00826446,0.00550964,0.00550964,0.0110193,0.00826446,0.00275482,0.00275482,0.00550964,0.030303,0.00550964,0.0192837,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00550964,0.00550964,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00275482,0.00826446,0.00275482,0.0165289,0.0220386,0.00826446,0.0192837,0.00275482,0.00826446,0.00826446,0.00275482,0.0220386,0.00275482,0.00550964,0.00550964,0.00826446,0.00550964,0.00275482,0.0165289],"ids":[298,406,173,730,826,752,146,473,305,481,913,9,724,30,266,969,152,526,148,598,23,787,739,807,998,929,775,476,358,419,69,675,897,141,277,280,403,45,110,186,620,149,243,697,284,371,916,221,283,931,242,753,27,507,933,523,715,173,534,286,115,348,241,161,793,659,486,736,762,149,71,748,810,719,235,268,689,360,430,282,812,417,518,849,143,773,158,531,451,821,460,716,501,215,184,437,370,116,174,931,372,225,439,489,7,168,715,147,50,602,347,718,255,876,378,692,110,256,488,899,904,823,802,133,928,496,545,695,755,947,876,714,418,186,487,407,815,531,264,63,367,518,896,879,856,354,126,503,950,299,200,424,196,60,225,388,116,170,391,811,627,846,232,402,742,846,777,946,872,510,940,823,23,577,605,3,856,686,753,581,420,717,844,455,712,363,903,571,958,469,342,838,339,643,372,608,167,537,268,20,491,131,977,85,907,378,356],"ngrams":["ें","^क","मध","ण$","िण","�ष","क�","दक","ाढ","ंद","ात","धं","ढ$","गध","ोग","यो","मि","^హ","सा","पत","िर","प�","नि","धन","औष","ाण","रम","तर","नं","^�","वा","सल","री","शा","^न","ाप","�थ","णे","ि$","द�","ळख","आण","त$","कृ","भल","स�","ंस","िक","िह","यश","�त","ाल","ति","ल�","ओळ","^ओ","णि","ळी","के","^�","ाद","^औ","त�","^अ","ोत","ाह","ాద","हज","उच","ख$","ाख","ंख","^म","सं","ली","ास","षध","ोक","चप","लो","ंत","ची","शह","दच","ीच","आह","ल�","^श","ाय","चे","ेश","ेक","चा","ेल","ंच","नी","ा$","जध","ाज","�क","^र","श$","ले","ద�","मो","^भ","ైద","ाच","در","रद","^प","ैद","^ह","ज�","भा","ख�","द$","ील","हे","ल$","सि","با","जा","ाभ","ला","آب","ृत","ता","ر$","उद","धा","�क","च�","�ग","ید","ंध","ां","حی","था","ाळ","ाब","दू","र�","ीय","अश","बा","ी$","उर","�द","�$","हर","ान","रस","रत","�र","है","బా","का","�त","రా","దర","హై","दे","कस","ती","^व","ित","ार","^स","^آ","हि","मा","�य","हा","र$","ध�","शी","د$","सह","�ा","اد","दर","क$","अस","षि","आं","ాబ","�क","�म","य$","^य","^$","या","^त","^आ","य�","^ल","^उ","�च","े$","^द","गू","^�","ू$","ते","^ح","रा"],"ngram_size":2,"dimension":1000},{"language":"mr","weights":[0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.0156863,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.0117647,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.0156863,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.0156863,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00784314,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157],"ids":[3383,1331,197,1829,1037,1393,2517,997,1018,2089,4028,903,3381,3656,885,2499,163,2741,163,3360,973,1137,2640,975,4665,1966,62,3061,4501,2767,2098,3789,284,4097,3383,4470,2805,3469,1817,2204,2251,983,1127,2569,3580,275,4697,2453,4556,3503,2728,4386,192,2964,1164,3873,1426,4301,3901,2822,873,3145,4678,2310,2653,315,1519,543,2375,1821,982,691,4660,4891,713,3367,2836,3165,1161,925,2407,33,947,4620,2060,1580,3011,2736,4445,4529,95,4622,2749,2622,3439,1683,2775,1553,1299,4753,2138,3024,2095,1194,2649,4478,1084,2754,4977,1903,147,3043,3798,1098,2902,4952,3129,1105,3164,4221,2400,4732,655,4924,1925,3147,4064,3787,52,2822,803,2506,1084,4141,1263,3901,3926,3142,3155,4642,2835,1786,392,3753,2673,1187,2338,1677,1562,3786,3067,2256,3193,1368,154,2757,239,2719,1213,278,1046,123,3578,1657,4700,4442,1751,4758,894,183,1360,1665,1624,1585,4850,3688,1516,1916,3736,1266,2669,316,1142,4482,2608,1086,1559,1082,3200,2584,2530,2577,4260,1876,600,1951,1999,1695,3180,3320,2714,1763,2212,506,1896,4003,2770,284,894,288,2784,12,2241,4436,1887,2736,607,4498,2811,4953,3058,213,2768],"ngrams":["द�र$","ेंद�","केंद","^कें","ध�य$","मध�य","^मध�","षिण$","क�षि","दक�ष","ाली$","�ाली","हरात","^वाढ","द�या","धंद�","गधंद","ोगधं","�योग","मिती","�मित","र�मि","षधनि","ाणे$","रमाण","^असल","हराल","प�रम","ोत�य","याचप","लाभल","^माह","असले","धनिर","^लाभ","ृतिक","रसा$","^राज","^वार","त�री","^प�र","�रदे","ास�त","^औषध","िर�म","शास�","यशास","त�यश","पत�य","^त�य","ापत�","^स�थ","आणि$","माणे","^आणि","ारसा","तिक$","�कृत","ंस�क","^सां","सिक$","ाबाद","रीय$","हासि","^�ति","ाला$","^या$","ंचे$","ल�या","स�कृ","राला","लेल�","ांची","ेल�ग","रतात","सलेल","^ओळख","भारत","�त�र","^मोत","�यशा","थापत","शहरा","राजध","ाळी$","काळी","�केक","�थाप","^�के","ांचे","यांच","अशी$","�यां","^حید","یدر$","मोत�","हैदर","ాబాద","आहे$","^हजा","लाख$","ाचप�","^उर�","लोकस","शहर$","संख�","^लोक","चार$","औषधन","ीचे$","नीचे","ानीच","उद�य","जधान","हाय�","^हैद","चप�र","दची$","ाजधा","ओळख$","सांस","�या$","�षिण","^नंत","ंद�य","^लाख","च�या","याच�","बाद$","آباد","�याच","जार$","ाज�य","ाभला","स�त�","राज�","नंतर","^सहा","देश$","प�रद","ाच�य","ध�र$","हजार","राबा","ंख�य","तील$","ंतर$","ातील","�रीय","तिहा","^दक�","ाय�य","य�य$","ेकाळ","ंद�र","वाढ$","ादची","ारता","ांस�","�दू$","باد$","�तिह","^आहे","र�दू","रात$","दराब","कृति","^�ाल","రాబా","దరాబ","^आंध","त�या","బాద�","ైదరా","योगध","केका","उर�द","वारस","^शहर","ज�या","रदेश","ंची$","హైదర","माहि","�गू$","^హైద","ल�गू","िती$","भला$","धानी","ाहित","हिती","िहास","ेल�य","ख�या","ंध�र","^उच�","�चार","ैदरा","ासिक","सहाय","^भार","^हे$","निर�","^آبا","ताती","^उद�","^अशी","�का$","^�का","द�यो","^तेल","तेल�","ोकसं","बादच","उच�च","حیدر","आंध�","�रमा","ాద�$","स�था","कसंख","च�चा"],"ngram_size":4,"dimension":5000},{"language":"mr","weights":[0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00980392,0.00326797,0.00326797,0.00326797,0.00653595,0.00653595,0.00326797,0.00653595,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00653595,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.0130719,0.00326797,0.00326797,0.00326797,0.00326797,0.0130719,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.0228758,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.0130719,0.00326797,0.00653595,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00653595,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.0130719,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.0163399,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00653595,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.00653595,0.00326797,0.00326797,0.0130719,0.00653595,0.00326797,0.00326797,0.00653595,0.00653595,0.00326797,0.00326797],"ids":[2464,190,1543,537,649,3841,2673,3655,4059,5,2694,3650,3280,1418,631,79,4346,1381,4085,1598,2595,2221,973,939,4841,4677,4517,231,726,1934,368,3530,87,1358,4654,4982,1160,2328,4204,1942,3198,2354,1677,1418,1188,338,1540,2124,4442,1884,1653,200,1826,482,1618,2755,2652,1209,4460,2488,1502,1799,3385,3940,358,3859,171,2345,4061,1011,248,568,3783,1616,3096,2336,1793,1623,4286,1885,1802,1264,2494,1544,3989,715,2692,4667,1460,2210,4047,335,4878,2728,4095,356,4852,3261,356,1190,2473,2309,475,3457,1637,2244,2335,4724,2944,3459,1656,4746,4550,2850,743,1049,4718,3349,4209,779,545,3682,1962,3971,1597,243,4723,4890,1505,2698,2485,3259,4377,2284,2054,4913,3260,4145,3536,4478,2864,2154,4815,1732,2935,4915,2891,1213,3696,3476,960,2680,3918,2784,2852,4910,17,2540,990,979,3780,2918,2708,3049,3404,3953,4851,2350,3722,3106,2365,870,338,2811,2414,4266,216,3829,4424,2838,3554,1395,2704,1105,3660,585,809,3611,660,1000,1995,4593,2289,4541,1989,3334,2820,1195,1825,2842,3530,2909,3684,4574,2344,3837,3907,1263,4070,501,868,374,192,2309,2369,2397,4217,809,1255,4403,2601,660,156,4104,1755,2627,2762,2863,3343,4947,4061,1511,1619,514,2345,597,3836,1657,4197,4031,4565,814],"ngrams":["द�र","कें","^के","ध�य","मध�","^मध","िण$","षिण","क�ष","ली$","�ाल","^�ा","रात","ाढ$","ंद�","धंद","ोगध","�यो","उद�","�मि","औषध","^औष","ाणे","माण","^उद","रमा","�रम","तर$","दची","जधा","भला","^लो","ाभल","सा$","दरा","रसा","^آب","^वा","�री","उच�","ापत","^हज","णि$","आणि","तिक","ारस","آبا","लाभ","�षि","स�त","ृति","�त�","^उच","स�क","असल","केक","^आण","దరా","उर�","ंस�","ांस","^सा","हास","�था","िहा","^�त","ाज�","ला$","नंत","राल","कसं","^या","ल�य","वार","र�म","^अस","^प�","ळख$","ाली","^ओळ","ाळी","^अश","त�य","ात$","संख","हजा","^ला","ांच","ाख$","िती","ख�य","स�थ","िक$","ोकस","लोक","ाबा","शास","द�य","ాబా","लेल","ंतर","ादच","ైదర","^आह","िर�","सहा","जार","रदे","या$","हर$","हित","नीच","तिह","मित","तील","ती$","च�य","सिक","ाच�","ीचे","निर","ल�ग","रता","�या","ज�य","य�य","चे$","त�र","ास�","यशा","चार","ळी$","देश","^शह","�रद","याच","प�र","^आं","अशी","�का","ंध�","आंध","गधं","�कृ","ाती","च�च","गू$","तात","ील$","ेल�","^मो","ासि","बाद","^भा","یدر","�यश","در$","हरा","اد$","حید","^حی","राज","�ति","ोत�","दक�","दू$","�दू","राब","ार$","ाद$","^ते","योग","^नं","णे$","शहर","थाप","चप�","ाचप","शी$","पत�","^रा","రాబ","माह","सले","హైద","काळ","^హై","मोत","तेल","ओळख","ेंद","^�क","धनि","ारत","ాద�","^�क","र�द","ेल�","ानी","^मा","ाला","ेश$","^हे","ద�$","सां","^दक","भार","हे$","^उर","यां","लाख","ंख�","धान","ध�र","ंची","^सह","ीय$","�य$","ंचे","ची$","^त�","^स�","�चा","ेका","का$","బాద","कृत","ाय�","^है","ाहि","ाजध","�र$","रीय","वाढ","आहे","�गू","षधन","हाय","ैदर","हैद","�के","باد"],"ngram_size":3,"dimension":5000},{"language":"mr","weights":[0.00238095,0.00238095,0.0047619,0.00952381,0.00238095,0.00238095,0.0047619,0.00714286,0.00714286,0.00714286,0.0119048,0.0047619,0.00238095,0.00238095,0.00238095,0.00238095,0.00238095,0.0047619,0.00238095,0.00714286,0.0047619,0.00238095,0.00238095,0.00238095,0.0166667,0.0047619,0.0047619,0.00238095,0.0238095,0.0047619,0.0190476,0.00238095,0.00714286,0.00714286,0.135714,0.0047619,0.0261905,0.135714,0.0547619,0.0214286,0.0333333,0.0904762,0.00238095,0.0119048,0.00238095,0.0238095,0.0214286,0.00714286,0.0047619,0.0333333,0.0214286,0.0047619,0.00714286,0.0166667,0.0047619,0.0190476,0.0333333,0.00238095,0.0357143,0.047619],"ids":[37,81,57,92,24,28,59,89,92,80,80,43,40,97,3,0,6,70,29,6,63,89,6,84,11,53,64,83,17,99,34,45,97,65,52,79,64,68,90,50,52,1,59,15,56,81,95,2,7,73,46,48,71,54,85,24,55,50,46,68],"ngrams":["�","ढ","व","ण","ृ","ओ","ळ","ख","न","प","ध","भ","ا","थ","�","آ","ر","د","ح","ज","ै","ب","బ","ర","श","ద","ष","�","द","�","ं","హ","ू","ग","^","अ","ल","$","�","ि","े","ा","औ","म","ی","ी","क","ो","�","य","स","ब","उ","आ","ా","च","त","ై","ह","र"],"ngram_size":1,"dimension":100},{"language":"ms","weights":[0.00142653,0.00142653,0.00142653,0.00142653,0.00142653,0.00142653,0.00285307,0.0042796,0.00142653,0.00285307,0.0042796,0.00142653,0.00570613,0.00285307,0.00142653,0.00285307,0.00142653,0.00142653,0.00142653,0.0042796,0.0042796,0.00285307,0.00142653,0.00570613,0.00285307,0.00285307,0.00142653,0.00142653,0.00285307,0.0042796,0.00142653,0.00142653,0.00142653,0.00142653,0.00285307,0.00142653,0.00713267,0.00142653,0.0114123,0.00142653,0.0085592,0.00570613,0.0299572,0.0114123,0.0114123,0.0171184,0.0042796,0.00142653,0.00142653,0.0042796,0.00285307,0.0228245,0.00713267,0.00142653,0.0085592,0.00142653,0.00142653,0.00713267,0.0114123,0.0114123,0.0156919,0.00713267,0.00285307,0.00570613,0.00142653,0.0142653,0.0128388,0.00142653,0.0042796,0.00142653,0.00142653,0.0128388,0.0142653,0.0042796,0.00570613,0.00570613,0.00285307,0.00142653,0.00142653,0.0042796,0.00713267,0.0042796,0.00142653,0.00285307,0.00142653,0.00285307,0.00142653,0.0128388,0.0114123,0.021398,0.00285307,0.00142653,0.00142653,0.00142653,0.00713267,0.00285307,0.00142653,0.0085592,0.00998573,0.0142653,0.00570613,0.0042796,0.00570613,0.00285307,0.0085592,0.00142653,0.00142653,0.00142653,0.0085592,0.0085592,0.0156919,0.00142653,0.0042796,0.00285307,0.00285307,0.0114123,0.0085592,0.0199715,0.0042796,0.0114123,0.00142653,0.00285307,0.00285307,0.0085592,0.0042796,0.00142653,0.00142653,0.00713267,0.00285307,0.00285307,0.00285307,0.00285307,0.00142653,0.0042796,0.0328103,0.00570613,0.0656205,0.00285307,0.0085592,0.00285307,0.00142653,0.00998573,0.0142653,0.00142653,0.0271041,0.0042796,0.00998573,0.00285307,0.0042796,0.0156919,0.021398,0.00142653,0.00285307,0.00570613,0.0114123,0.00142653,0.00285307,0.00285307,0.0199715,0.00142653,0.00142653,0.00285307,0.0171184],"ids":[379,198,489,314,963,113,707,763,999,58,927,834,645,613,745,8,688,601,237,679,748,410,915,364,191,535,575,717,272,752,630,791,822,786,510,96,23,754,108,920,907,458,989,501,973,355,267,651,575,19,382,770,629,819,349,481,125,518,875,147,862,123,251,660,29,215,190,648,193,392,379,933,803,702,692,327,637,961,476,591,429,116,383,978,75,553,300,391,334,672,7,489,128,885,46,27,998,83,493,848,795,875,157,879,976,200,490,273,212,804,532,265,985,409,120,809,356,486,61,895,28,766,778,67,960,925,463,732,652,984,757,545,176,68,605,18,269,98,795,838,668,146,144,290,248,841,980,955,287,41,879,503,175,780,153,571,298,166,378,594,385,307,353],"ngrams":["ep","gk","ed","l$","ci","bu","d$","ad","ge","uh","mu","br","^i","t$","ug","^a","wa","ho","ne","au","mb","em","io","uk","ku","^l","rd","^w","lk","ha","at","ij","aa","is","s$","ni","u$","af","ak","ua","ag","tu","a$","ba","el","^m","eh","e$","^e","ol","mm","g$","ja","li","se","hi","ji","pe","k$","ka","^d","^y","ny","lt","oh","ta","ya","f$","le","ud","ig","ti","di","aj","gi","r$","ut","gg","^c","ke","ia","ar","ky","bi","nj","go","m$","ga","^r","da","sa","es","jo","^u","al","si","ay","ul","in","i$","ah","un","na","ib","^o","st","um","eb","^p","h$","^s","re","ri","rh","im","nd","me","^b","^k","am","kt","ab","ru","nt","pa","^g","ih","su","up","rt","ek","ir","lu","^j","ng","as","an","ik","ai","^$","rg","or","be","nk","n$","id","^t","te","it","ma","ra","us","il","pu","en","mp","ip","rn","la","ju","de","hu","er"],"ngram_size":2,"dimension":1000},{"language":"ms","weights":[0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00399202,0.00399202,0.00399202,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.0139721,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00399202,0.00199601,0.00199601,0.00399202,0.00199601,0.00598802,0.00199601,0.00399202,0.00399202,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00598802,0.00199601,0.00199601,0.00199601,0.00598802,0.00199601,0.00199601,0.00199601,0.00598802,0.00798403,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00598802,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00598802,0.00199601,0.00199601,0.00199601,0.00598802,0.00199601,0.00199601,0.00598802,0.00399202,0.00199601,0.00199601,0.00399202,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00598802,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00598802,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00399202,0.00998004,0.00199601,0.00199601,0.00199601,0.00399202,0.00399202,0.00199601,0.00399202,0.00199601,0.00598802,0.00798403,0.00199601,0.00199601,0.00598802,0.00399202,0.00199601,0.00598802,0.00998004,0.00598802,0.00399202,0.00199601,0.00598802,0.00399202,0.00199601,0.00199601,0.00598802,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00598802,0.00998004,0.00798403,0.00199601,0.00199601,0.00598802,0.00798403,0.00199601,0.00199601,0.00798403,0.00199601,0.00199601,0.00199601,0.00598802,0.00199601,0.00399202,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00798403,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00798403,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00598802,0.00399202,0.00199601,0.00798403,0.00798403,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00798403,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00399202,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00998004,0.00199601,0.0279441,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00798403,0.00199601,0.00199601,0.00399202,0.00199601,0.00199601,0.00199601,0.00199601,0.00199601,0.00399202,0.00199601],"ids":[576,4094,3553,126,695,2412,268,3766,2045,704,4081,103,1192,2132,2543,945,2427,2967,4164,852,2935,2856,2718,2209,2689,90,386,2112,3734,4277,85,228,4443,894,3729,4944,968,3678,122,578,4914,688,402,628,1950,3701,1164,2452,2690,4503,912,1064,925,3594,200,4568,1998,778,1162,3562,4207,2340,286,4195,4091,1004,3877,4416,1592,1663,4721,282,421,4272,535,1229,2534,2370,1749,4616,3910,1401,3894,3179,4792,1136,1946,1318,3458,3744,4399,3053,268,511,1109,3951,2841,4339,3905,3794,3024,287,4407,1942,377,3090,15,4303,159,4576,3926,2751,359,1503,4571,3425,4864,4841,2540,2269,3389,887,4483,3873,4252,700,2637,2622,304,3161,980,513,1229,3088,4893,1849,821,4970,2030,5,1283,4303,4358,4825,783,3746,3743,3930,2603,1129,2952,4088,2049,573,3955,2004,2067,3928,2403,2182,2196,3169,2788,4851,4732,783,1862,1728,1367,689,3505,4640,725,936,664,125,2394,523,3808,4600,1663,573,1553,3537,3782,2333,1884,3299,1442,2352,2,835,4289,4539,2485,1165,3804,1490,4284,4796,503,3162,3416,2222,613,3244,1688,3223,4692,997,760,2537,1087,3841,892,773,4504,943,489,4823,1686,2748,4891,2319,2292,2025,498,1465,2126,2596,69,4136,51,761,4325,460,173,3272,412,3982,1599,1602,2450,4779,2241,3034,404,698,4994,1358,2430,3491,2990,3239,688,174,2864,1820,4027,689,1679,3972,4246,2002,502,2966,2868,1658,4164,1299,1284,3689,358,2773,2851,1320,3352,54,1344,1873,1287,3527,2433,4152,2977,2751,3798,3124,3440,4328,137,3852,45,2504,2807,3811,2985,3471,1301,888,4475,2333,1662,2381,4994,2813,4295,872,2424,2039,3691,94,504,4327,2350,247,4305,494,2236,1394,660,380,458,1769,2576,4003,1144,519,1292,4762,1366,590,2426,2918,2388,3952,2955,1553,1876,3507,968,1758,2420,216,3329,2427,1515],"ngrams":["epad","kepa","^kep","huta","erhu","yak$","nyak","anya","^ban","iri$","send","pada","bany","ngka","ndak","tind","mbil","ambi","^dia","kut$","^iol","lar$","elar","tama","rtam","erta","endi","cina","eri$","ster","^buk","gind","^bag","^wal","uda$","muda","^mud","iait","^iai","mad$","mmad","amma","hamm","^muh","him$","berg","ahim","ibra","rgel","nti$","gant","^gan","yat$","akya","raky","alau","ndan","pand","ipan","uga$","upun","juga","diri","iga$","tiga","^tig","tara","anta","^di$","dan$","^dan","^ria","enta","ntan","nent","mene","bant","iau$","asa$","jasa","edan","las$","bala","ama$","ohor","ntuk","^jas","untu","^ibr","^unt","rnia","kan$","rana","antu","eran","kera","nak$","^lai","asin","gang","supa","^dib","seda","agan","daga","ada$","^sed","laup","mban","umah","emba","riau","^dip","^ker","perd","alka","pun$","amai","tuk$","abal","taba","^dit","hak$","rhak","beku","mbal","erha","rtua","berh","ndir","besa","aja$","rdag","eka$","agi$","raja","anka","^den","imah","inda","tan$","puna","tima","^tim","memb","ijih","biji","itab","^bij","iamb","ara$","gaan","ukut","iaga","tida","lain","niag","ebag","erni","^cin","rus$","pert","^raj","daka","pern","ahu$","^per","bera","nkan","rama","^mem","lank","utan","anti","alan","ukan","enen","enja","menj","^dil","^mah","dak$","dipe","ain$","ngor","kuka","ina$","^sel","ibek","^sup","uan$","iper","ntar","tang","ntu$","deng","ango","yang","gai$","ana$","^rak","dang","pula","^seb","agin","mahu","mai$","anda","^joh","seba","^tid","lkan","elia","idak","elan","land","ing$","^eng","bela","^ole","buka","tik$","leh$","angk","aya$","dila","elag","ula$","sela","^yan","ltan","jala","sarn","^men","sult","ktir","^rum","^sul","^jug","unan","reka","oleh","luku","bagi","tira","enga","iste","ikti","ggan","ngan","dita","ngga","mah$","brah","eram","meng","upay","nya$","engg","ntik","anak","ulta","ngam","bil$","arny","jih$","joho","lant","rang","alas","tuan","^ant","ertu","^sen","esar","^bes","lang","gan$","paya","^ora","oran","diam","^luk","teri","hor$","teru","raf$","erge","ampu","^tin","peng","^ber","rhut","aan$","ilan","erus","uham","^pen","muha","nan$","iraf","sing","erda","gikt","aupu","dibe","lagi","engi","gkan","aitu","balk","ruma","^ana","rahi","^ke$","ulan","baga","rnya","akan","erek","nda$","iole","ang$","dipa","^ram","wala","ngik","^ter","itu$","^pul","gela","agaa","beli","^mer","njal","masi","^bel","kyat","liau","gor$","^ist","mpun","agai","ekuk","gamp","^mas","mere"],"ngram_size":4,"dimension":5000},{"language":"ms","weights":[0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.005,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00333333,0.00333333,0.00333333,0.00166667,0.00166667,0.00333333,0.00333333,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.0116667,0.00333333,0.01,0.01,0.00166667,0.00166667,0.00333333,0.005,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00333333,0.00166667,0.00333333,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00666667,0.00333333,0.00166667,0.0133333,0.0266667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.005,0.00333333,0.00166667,0.00333333,0.005,0.00166667,0.00166667,0.005,0.005,0.005,0.00166667,0.00166667,0.00166667,0.00666667,0.00166667,0.00333333,0.00333333,0.00333333,0.005,0.00166667,0.00166667,0.00166667,0.00166667,0.00333333,0.005,0.00166667,0.00333333,0.00166667,0.00166667,0.00166667,0.00166667,0.00333333,0.0116667,0.00166667,0.00333333,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00333333,0.01,0.005,0.00333333,0.00166667,0.00166667,0.01,0.00333333,0.00166667,0.00333333,0.005,0.00333333,0.00166667,0.00166667,0.00166667,0.00333333,0.00166667,0.00166667,0.005,0.00166667,0.00166667,0.00333333,0.005,0.00166667,0.00166667,0.00166667,0.0116667,0.00166667,0.00166667,0.00666667,0.01,0.00166667,0.00166667,0.00666667,0.005,0.00166667,0.00166667,0.00166667,0.005,0.00833333,0.00166667,0.00166667,0.00333333,0.00166667,0.00166667,0.00333333,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.005,0.00833333,0.01,0.00166667,0.00333333,0.00666667,0.00333333,0.005,0.005,0.00166667,0.00166667,0.00333333,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.005,0.00166667,0.015,0.00166667,0.00333333,0.00833333,0.00166667,0.00666667,0.00666667,0.00666667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00333333,0.00166667,0.00166667,0.00333333,0.00166667,0.00166667,0.00166667,0.00166667,0.0283333,0.00166667,0.00666667,0.00166667,0.00166667,0.005,0.00666667,0.00833333,0.005,0.00333333,0.00333333,0.00166667,0.005,0.00333333,0.00166667,0.00166667,0.00666667,0.00166667,0.00333333,0.00333333,0.00666667,0.00166667,0.00166667,0.00166667,0.00166667,0.00333333,0.00333333,0.00166667,0.0283333,0.00333333,0.005,0.00166667,0.00166667,0.00333333,0.00166667,0.00166667,0.00666667,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00666667,0.00333333,0.00166667,0.00666667,0.00333333,0.00166667,0.00166667,0.00166667,0.00333333,0.00333333,0.00166667,0.00166667,0.00166667,0.00166667,0.00166667,0.00666667,0.0116667,0.00166667,0.00166667,0.015,0.00333333,0.005,0.00333333,0.005,0.00333333,0.00166667,0.00166667,0.00166667,0.00333333],"ids":[4026,138,660,4483,3187,4743,351,2239,2032,105,2495,149,2778,1302,4017,4162,3534,1953,3471,4698,2085,2372,3635,4779,442,4804,4081,2258,2047,4486,2092,4290,2355,3366,700,290,241,3439,2268,949,3141,1732,1651,2592,2204,1889,2660,1613,2850,1941,3938,3552,3082,4530,1589,1174,1965,3174,1026,633,1417,3827,3939,705,1729,1960,1948,3721,1745,4337,2644,3931,4627,2224,4454,2028,1493,3407,970,277,1066,1852,3287,3332,579,2861,4146,587,3365,1546,16,1628,415,1336,4599,550,3869,4258,2608,4487,4324,3809,222,4388,2270,1432,3351,4349,201,2941,549,4739,4995,2601,2078,2387,2172,4209,3374,3142,16,3209,2176,2854,665,1588,4356,180,4673,1936,3206,459,1033,495,4103,2222,4721,2785,3313,4207,2403,2467,4002,1734,1152,813,4802,1618,833,3781,4699,442,1987,4024,1849,1958,122,702,1558,234,1057,2796,3212,844,274,1594,1390,1392,1095,1270,908,3894,2272,4394,3625,674,3606,2034,2438,2437,141,928,2110,2030,610,1594,962,60,4977,1512,599,256,4485,3289,134,4562,4513,1423,553,1684,4301,2890,3060,4226,2315,1102,2241,4438,4919,1374,4272,4697,4063,1290,1484,1637,821,4374,360,4381,3634,796,552,1794,4995,107,2624,4341,1167,3104,3417,2629,3478,4252,720,3903,327,4532,4211,4882,1680,4902,2892,2575,1366,4378,1597,2585,4258,2441,4965,4724,3619,3049,4501,4972,3148,708,4411,1755,2389,3896,589,4839,3265,4984,2924,1582,3239,2841,1575,4726,2667,715,3592,3144,4330,1093,3098,3399,583,4741,442,4351,4770,1486,2887,4102,3757,4872,4983,4092,2516,2597,2983,1468,3276,61,1711,2479,501,2260,1455,2378,4975,3454,3343,1776,3795,4529,4942],"ngrams":["yak","any","iri","dir","eda","tin","il$","bil","iam","kep","rhu","dia","luk","ina","ar$","lar","ma$","tam","iol","rta","eri","^is","nak","^ba","upu","aup","wal","^wa","uda","iai","^ia","ad$","mad","amm","uta","hut","ham","uha","rah","epa","ibr","ti$","^ga","rak","pan","ste","uga","jug","sen","^ju","iga","tig","ra$","ara","tar","^da","joh","^ib","^jo","ria","^ri","kya","ent","gka","nen","ela","au$","^ra","^me","eli","sa$","^an","mai","asa","jas","im$","^ja","aka","ih$","tuk","uk$","sar","unt","alk","^un","ana","aky","ker","eru","^ci","^te","per","uka","gel","lan","ng$","eku","in$","ain","iag","hak","dag","rda","erd","ngk","bal","tab","jih","dit","ja$","rha","af$","aja","raj","^mu","^la","eka","gi$","dak","nja","ita","erh","nta","agi","lag","mbi","amb","kti","na$","^ma","tim","mma","iji","bij","^bi","hor","emb","kan","nka","ga$","ila","jal","ima","gik","hu$","rum","ban","ak$","ida","mem","ahu","ada","^ti","ter","lai","gin","or$","ngo","ndi","uan","^de","ert","him","bek","eh$","ipe","ait","dip","aga","las","eba","ut$","da$","cin","pen","sul","^se","la$","kut","and","ala","rni","gam","ka$","leh","ran","sed","ik$","gor","tik","ibe","nti","uku","ahi","rtu","den","yat","seb","dil","ole","^ya","tan","gga","^pu","lta","aba","men","sel","tir","pad","mba","ist","us$","esa","gaa","ira","nia","mah","un$","^di","bra","tu$","yan","ngi","ant","ult","ama","ngg","rek","as$","^en","at$","sin","^io","ank","nya","una","rny","arn","ene","ang","mud","ora","dib","ern","^ke","^or","^su","tid","pun","pul","aan","dan","mas","gai","^ru","bel","raf","lka","di$","eng","nan","oho","aya","ke$","iau","ula","itu","an$","asi","ram","ipa","kuk","ah$","^bu","lau","gan","pay","lia","erg","enj","rge","ai$","muh","uma","^pe","ri$","ere","end","amp","era","ing","mpu","rus","upa","ikt","bes","ber","nda","tua","^lu","^be","ntu","bag","nga","ind","^ol","buk","sup","mer","ya$"],"ngram_size":3,"dimension":5000},{"language":"ms","weights":[0.00124688,0.0561097,0.00124688,0.00997506,0.0112219,0.0822943,0.0336658,0.0137157,0.0162095,0.00124688,0.0224439,0.0411471,0.0361596,0.0274314,0.157107,0.0149626,0.0349127,0.0498753,0.0336658,0.042394,0.125935,0.032419,0.0286783,0.125935],"ids":[58,66,32,5,65,20,21,22,63,22,44,24,59,11,96,77,0,79,0,88,68,2,19,52],"ngrams":["c","i","w","j","y","n","t","o","h","f","s","r","u","b","a","p","d","e","m","g","$","l","k","^"],"ngram_size":1,"dimension":100},{"language":"mt","weights":[0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.0123457,0.00823045,0.0205761,0.00823045,0.00823045,0.00411523,0.0123457,0.00823045,0.00823045,0.00823045,0.0329218,0.00411523,0.00823045,0.00823045,0.0123457,0.00411523,0.00411523,0.0123457,0.00411523,0.00411523,0.00823045,0.00823045,0.00823045,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.0164609,0.00411523,0.00411523,0.00823045,0.00823045,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.0123457,0.00823045,0.0123457,0.00823045,0.00411523,0.00823045,0.0164609,0.0288066,0.0246914,0.00411523,0.0164609,0.00823045,0.00823045,0.00411523,0.00823045,0.00411523,0.00411523,0.0123457,0.00823045,0.00411523,0.0164609,0.00411523,0.00411523,0.00823045,0.00411523,0.0123457,0.00823045,0.00411523,0.00823045,0.00411523,0.00823045,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.00823045,0.00411523,0.00823045,0.00411523,0.00823045,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.0164609,0.0246914,0.00411523,0.0164609,0.00411523,0.00411523,0.00823045,0.0164609,0.00823045,0.0123457,0.00411523,0.00823045,0.00411523,0.0288066,0.00411523,0.00411523,0.00411523,0.00823045,0.00823045,0.00823045,0.0246914],"ids":[989,937,534,265,347,652,879,126,146,879,385,489,532,101,43,663,10,320,925,878,960,841,248,568,353,327,989,458,501,943,212,630,791,752,393,545,8,955,287,809,927,458,200,421,490,875,157,46,885,854,826,275,113,96,510,842,291,300,75,18,601,486,61,52,23,255,907,980,645,539,933,67,153,17,613,862,157,273,851,267,355,972,120,356,809,985,517,612,803,557,819,88,811,629,80,682,8,489,535,333,899,7,707,230,553,978,265,590,314,381,175,778,766,487,493,651,28,613,98,353,848,637,658,193,225,62,838,215],"ngrams":["gl","og","oo","pi","pp","up","ra","gr","or","ib","de","ed","^s","ċe","ċċ","aċ","ie","gh","^g","gn","pa","id","n$","nn","^h","r$","a$","tu","ba","ot","^p","at","ij","ha","xi","ir","tb","te","it","mr","mu","fi","st","ur","um","un","na","al","^u","^n","ko","tt","bu","ni","s$","fa","ħf","m$","pr","as","ho","^b","^k","żi","u$","għ","ag","^t","^i","tx","ti","nt","en","ff","t$","^d","tf","eb","zz","eh","^m","if","im","me","nd","ri","mi","jj","di","ġġ","li","az","ġ$","ja","nu","ħż","^a","es","^l","ll","^ż","sa","d$","iz","go","bi","re","b$","l$","fe","il","ru","ab","om","in","e$","kt","lh","ik","er","i$","ut","aġ","le","ss","zi","^$","ta"],"ngram_size":2,"dimension":1000},{"language":"mt","weights":[0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.0124224,0.0124224,0.00621118,0.0124224,0.00621118,0.00621118,0.0124224,0.0124224,0.00621118,0.0124224,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.0124224,0.0124224,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.0124224,0.00621118,0.00621118,0.00621118,0.00621118,0.00621118],"ids":[237,3845,2552,1231,2424,4085,1628,4773,347,1915,3009,2686,4636,1909,4241,4921,2998,1170,4126,3866,1188,3547,3115,140,4696,798,616,4352,342,2415,3698,4862,182,3275,311,2766,1630,2498,2874,550,3324,1409,1168,933,1542,4183,291,870,1466,3791,1083,179,2612,3937,174,1711,2502,1659,4216,3017,4387,1777,4610,3308,1779,619,46,1307,646,2870,3343,2923,2445,2164,62,4245,2082,286,2696,470,4365,2742,861,4794,3306,728,2536,1169,645,497,2455,2977,2688,1716,3014,1832,3148,3267,1972,3693,1261,3270,3476,4556,2597,735,755,2233,3152,2580,3161,4450,610,3544,4848,2595,3901,1284,2989,1667,2092,295,2792,4594,4503,4825,1629,711,692,1082,3035,1936,4456,3638,4687,2925,4123,2001,2054,1444],"ngrams":["ogle","goog","^goo","rupp","grup","^it$","azzi","bib$","abib","habi","den$","^gra","iede","ppi$","tied","stie","^sti","uppi","ċess","ċċes","ieb$","ktie","^kti","agna","hal$","pagn","tim$","^num","inn$","home","int$","rint","^gha","ghal","^mur","tba$","lil$","ome$","otba","minn","tuna","tal$","indi","^tal","jja$","ijja","razz","kteb","gna$","ittx","mri$","gle$","umri","xijj","żid$","^ieh","^żid","aċċe","uttu","eden","una$","gni$","ttun","agni","^tag","fas$","ttxi","hall","ħfas","għżi","diff","agħż","ieho","tagħ","għfa","^min","^hab","diri","ħżil","^kot","txij","saġġ","^il$","lli$","ehor","illi","ssa$","^bil","iriz","enti","butt","hor$","ffer","iffe","^tfi","oogl","hom$","^pag","ilho","agħf","ata$","teb$","^dif","mess","fitt","^ind","fere","numr","aġġ$","izzi","ndir","^hom","rent","kotb","zzi$","rizz","^but","^gru","prin","^ta$","tfit","^ikt","^pri","lhom","nti$","^tim","^lil","żilh","graz","^aċċ","tieb","ikte","mur$","^mes","essa","bill","eren","ssaġ","all$","^ata"],"ngram_size":4,"dimension":5000},{"language":"mt","weights":[0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00995025,0.00995025,0.00497512,0.00995025,0.00497512,0.00995025,0.00995025,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00995025,0.00497512,0.00995025,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00995025,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00995025,0.00497512,0.00995025,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.0149254,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.00995025,0.00995025,0.00497512,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00497512,0.00995025,0.00497512,0.0149254,0.00497512,0.0248756,0.00497512,0.00995025,0.00497512,0.00995025,0.00497512,0.00497512,0.00497512,0.00995025,0.00995025,0.00497512,0.00995025,0.00995025,0.00497512],"ids":[1010,1881,2672,2558,1631,1030,1249,3356,1672,4590,122,9,2465,2544,159,2976,4562,944,2375,2344,1989,243,2331,4872,2130,4303,180,4091,4610,540,4625,2713,1758,4814,3052,3519,2732,1171,4823,4484,3153,859,3629,2537,4127,775,1987,4125,4438,3074,2129,2941,3907,4077,3006,918,1987,4988,1131,1818,2513,3913,3532,2632,1001,1360,2845,2887,3206,4673,4103,2262,2213,3230,2322,2777,1249,4794,2366,2570,4696,3592,980,4676,3538,2483,2642,2146,2239,3747,1046,4497,1204,362,1952,2950,4479,4823,2746,1572,1297,720,2522,1312,4483,2207,327,4441,4102,2918,3180,2222,479,623,721,809,1962,4381,984,2078,1908,4931,3380,3139,2514,1605,660,256,3454,3104,3965,1732,1848,94,1745,1876,1439,3088,3006,4101,2028,81,1558,351,4736,1024,503,2120,794,3242,3939,2450,2132,2644,1057,2660,539,3290,1468,1488,4663],"ngrams":["ogl","oog","^go","pi$","ppi","upp","gru","it$","^it","azz","or$","ieh","bib","abi","gle","^ha","den","ede","sti","rup","^st","ċes","ieb","ied","tie","^aċ","kti","gna","hal","gha","ni$","pag","hab","^pa","min","^mi","^ho","int","mes","om$","rin","aċċ","ur$","but","mur","ba$","^ti","inn","ffe","otb","kot","ja$","żid","ijj","all","xij","pri","txi","fit","goo","mri","umr","gni","id$","dif","^żi","agn","ri$","tim","na$","^bi","hom","aġġ","iff","ttu","ttx","tba","^gh","utt","^gr","ta$","^bu","^il","fas","ata","al$","ħfa","lho","bil","zzi","ilh","le$","għf","żil","fer","għż","tfi","agħ","eho","ib$","^nu","tag","li$","^kt","dir","ll$","una","ill","ere","ren","raz","hor","kte","me$","tal","nn$","ome","^di","zi$","^mu","ċċe","ġġ$","izz","^ie","riz","lil","iri","nti","ind","as$","lli","ti$","^at","nt$","^me","^in","^pr","num","^li","saġ","im$","jja","ndi","il$","^tf","eb$","en$","^ta","itt","ssa","ent","teb","gra","sa$","^u$","ess","^ko","ħżi","ikt","^ik","tun"],"ngram_size":3,"dimension":5000},{"language":"mt","weights":[0.00701754,0.0175439,0.00701754,0.00350877,0.0245614,0.0210526,0.0280702,0.0210526,0.0736842,0.0421053,0.0315789,0.0140351,0.0421053,0.0421053,0.147368,0.0175439,0.0140351,0.147368,0.0140351,0.0210526,0.00701754,0.00701754,0.00701754,0.077193,0.101754,0.0350877,0.0280702],"ids":[76,77,5,86,22,63,24,59,21,20,11,0,79,2,52,19,22,68,86,44,38,50,82,96,66,88,0],"ngrams":["ċ","p","j","x","o","h","r","u","t","n","b","d","e","l","^","k","f","$","z","s","ħ","ż","ġ","a","i","g","m"],"ngram_size":1,"dimension":100},{"language":"my","weights":[0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.021978,0.043956,0.010989,0.021978,0.010989,0.010989,0.021978,0.010989,0.010989,0.10989,0.021978,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.010989,0.010989,0.010989,0.021978,0.010989,0.032967,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989,0.010989],"ids":[391,634,309,483,158,751,787,491,199,217,166,193,863,679,546,577,143,836,769,358,616,287,584,769,332,633,54,271,923,200,361,524,793,143,160,415,470,19,557,756,766,139,306,777,317,199,337,121,276,987,838,319,243,966,667,749,695,786,440,800,642,359,981,690,524],"ngrams":["င္","ာင","ေက","း$","သာ","ယု","္ယ","နေ","�န","ပန","အမ","သည","့သ","းသ","^ဦ","�ယ","း�","္�","^အ","ဟစ","္ဟ","^န","^ေ","ာက","ရ္","ေန","လာ","းေ","ပီ","^ပ","ဟ$","ီး","လ္","္ရ","န္","ည္","^း","နာ","ပ္","ာ္","စ္","ရပ","္$","မ္","ိး","^မ","^�","္က","ယ္","ရန","^$","ကသ","သန","ိလ","ယာ","ုိ","သု","က္","^့","ဦး","ော","အရ","ား","�က","^လ"],"ngram_size":2,"dimension":1000},{"language":"my","weights":[0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873,0.015873],"ids":[4607,2412,59,3657,1600,2169,3619,1753,618,920,1937,2303,2114,2330,2284,4838,343,446,404,2610,2865,1137,305,2967,712,4345,4230,4717,2417,1330,1830,3014,4046,1678,2124,3860,1804,4187,1245,3003,2419,3935,3584,3612,1039,1460,986,4043,4929,3036,586,2489,4516,292,689,3566,3015,1427,2650,3396,6,739,4981],"ngrams":["ာင္$","္ယာင","က္ယာ","ေက္ယ","သား$","းသား","ုိးသ","ယုိး","္ယုိ","မ္ယု","^အမ္","ော္$","^ေက္","း�နေ","^း�န","သည္$","�ယ္$","့သည္","္�ယ္","္ကသု","နော္","^့သည","ရန္$","^ဦးသ","ရ္�ယ","ဟစ္$","းေနာ","္ဟစ္","^မ္ဟ","^န္ဟ","းသန္","ာက္$","ဦးသန","အမ္ယ","န္ဟစ","�က္က","ေနာက","ုိလ္","ပီးေ","�နော","သန္$","^�က္","ရပီး","္ရပီ","^ပ္ရ","^အရ္","ာ္ရပ","လာ္ရ","^လာ္","ီးေန","ပန္$","အရ္�","ပ္ရန","က္ကသ","^ပန္","ယာင္","ိးသာ","မ္ဟ$","ိလ္$","ကသုိ","နာက္","သုိလ","္ရန္"],"ngram_size":4,"dimension":5000},{"language":"my","weights":[0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0394737,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579,0.0131579],"ids":[1181,1937,2648,3070,3877,3454,3269,2927,1744,4108,956,3112,3707,898,3791,2964,1040,2377,1545,3692,722,3038,3082,1870,4910,1481,2294,701,359,830,4619,242,3150,2658,3958,413,4999,3349,1087,1306,3779,1503,1907,1336,637,216,634,4481,4991,214,2909,3106,2224,1730,246,4724,3501,2866,1221,1525,2537,245,40,4760,1341,3762,3452,247,4095,3995,3654,2854,4323,2472],"ngrams":["က္ယ","းသာ","ိးသ","္ယု","ယာင","အမ္","^အမ","ာ္$","ော္","ုိး","�နေ","^း$","ာင္","^း�","ပန္","ယုိ","ည္$","္ကသ","့သည","သန္","္ယာ","ပ္ရ","ဦးသ","�ယ္","ရန္","္�ယ","ရ္�","အရ္","^အရ","စ္$","^ေက","သည္","ဟစ္","္ရပ","က္$","^ဦး","း�န","^န္","ာက္","နာက","သား","ေနာ","ယ္$","းေန","မ္ဟ","^�က","ာ္ရ","မ္ယ","^ပန","^့သ","^လာ","င္$","္ဟ$","န္$","ေက္","^ပ္","္ရန","ား$","ပီး","နော","္ဟစ","လ္$","န္ဟ","သုိ","ိလ္","ရပီ","လာ္","�က္","းသန","ီးေ","က္က","ုိလ","^မ္","ကသု"],"ngram_size":3,"dimension":5000},{"language":"my","weights":[0.00943396,0.00943396,0.0283019,0.00943396,0.0283019,0.0188679,0.00943396,0.0283019,0.0188679,0.0566038,0.0471698,0.0188679,0.0566038,0.0188679,0.0188679,0.0377358,0.00943396,0.0188679,0.141509,0.0377358,0.169811,0.00943396,0.0188679,0.00943396,0.0283019,0.141509],"ids":[93,62,72,52,60,75,6,9,7,98,43,44,61,18,24,67,87,26,68,38,76,24,1,64,28,52],"ngrams":["င","ည","ယ","ဦ","ရ","အ","စ","ေ","လ","န","ာ","ဟ","း","ု","ိ","သ","့","မ","$","က","္","ီ","�","�","ပ","^"],"ngram_size":1,"dimension":100},{"language":"ne","weights":[0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.0540541,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.027027,0.0540541,0.027027,0.027027,0.027027,0.0540541,0.0540541,0.027027,0.0540541],"ids":[605,370,913,40,342,132,671,672,416,439,969,716,332,355,536,739,802,110,736,628,354,690,513,554,838,633,506,85,155,329,695,161],"ngrams":["र$","ा$","ात","खा","^य","^छ","छ$","को","ो$","ले","यो","ेक","�ल","रू","ख�","नि","पन","ि$","टप","ाट","बा","^ठ","�ब","ऊ�","^$","ाऊ","ठा","ू$","^ख","अर","ता","^अ"],"ngram_size":2,"dimension":1000},{"language":"ne","weights":[0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619,0.047619],"ids":[1983,1620,750,4219,3135,2106,758,360,1017,3856,2386,3975,919,1674,2407,1389,3428,2476,491,2834,3838],"ngrams":["^अर$","खाता","^खात","ेको$","�लेक","ाता$","ख�ले","पनि$","टपनि","अरू$","बाटप","�बाट","^ख�ल","^अरू","^यो$","ाऊ�ब","लेको","ाटपन","ऊ�बा","ठाऊ�","^ठाऊ"],"ngram_size":4,"dimension":5000},{"language":"ne","weights":[0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0357143,0.0714286],"ids":[1108,1502,3506,4834,3650,1210,527,2473,177,92,4220,3268,144,3140,4218,3853,3138,2805,4715,483,4267,3019,2263,2099,859,574,2453],"ngrams":["ता$","अर$","ाता","�ले","को$","^यो","^छ$","ठाऊ","�बा","ेको","ाटप","^ख�","नि$","ाऊ�","बाट","ख�ल","पनि","ऊ�ब","^खा","^ठा","रू$","खात","यो$","लेक","टपन","अरू","^अर"],"ngram_size":3,"dimension":5000},{"language":"ne","weights":[0.0217391,0.0217391,0.0434783,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0217391,0.0434783,0.0869565,0.0217391,0.0434783,0.195652,0.0434783,0.195652],"ids":[95,55,89,50,92,80,44,82,73,48,52,97,60,99,70,64,79,1,92,2,52,68,68],"ngrams":["क","त","ख","ि","न","प","ट","�","य","ब","े","ू","छ","�","ऊ","ल","अ","ा","ठ","ो","^","र","$"],"ngram_size":1,"dimension":100},{"language":"nl","weights":[0.004,0.004,0.004,0.004,0.004,0.004,0.004,0.004,0.008,0.008,0.02,0.008,0.02,0.004,0.004,0.004,0.004,0.004,0.012,0.004,0.004,0.004,0.012,0.004,0.02,0.004,0.012,0.004,0.004,0.012,0.016,0.008,0.004,0.004,0.004,0.012,0.008,0.02,0.004,0.004,0.004,0.004,0.004,0.008,0.004,0.004,0.008,0.004,0.008,0.004,0.004,0.004,0.016,0.004,0.008,0.004,0.004,0.016,0.008,0.008,0.024,0.036,0.016,0.016,0.004,0.004,0.004,0.012,0.008,0.004,0.012,0.004,0.008,0.004,0.004,0.004,0.008,0.004,0.008,0.004,0.004,0.008,0.004,0.004,0.008,0.004,0.008,0.008,0.044,0.04,0.012,0.004,0.008,0.004,0.036,0.016,0.012,0.008,0.004,0.004,0.004,0.008,0.012,0.012,0.02,0.008,0.008,0.004,0.016,0.012,0.028,0.008,0.008],"ids":[960,379,327,275,193,333,770,907,314,28,822,474,510,559,786,989,501,712,486,493,793,122,716,620,46,885,215,90,648,144,75,146,734,98,720,205,780,385,421,200,734,660,575,487,893,778,803,834,886,159,212,18,999,605,925,122,34,134,935,410,41,955,287,532,943,534,91,108,269,216,355,809,10,379,933,879,458,296,353,526,346,273,973,930,591,476,489,630,248,153,531,175,134,19,651,575,8,875,296,835,272,717,27,843,862,613,300,694,980,71,976,707,838],"ngrams":["pa","ep","r$","tt","le","ll","g$","ag","l$","kt","aa","pm","s$","wo","is","a$","ba","we","^b","lo","to","sl","oe","tg","al","^u","ta","^f","f$","be","op","or","et","ik","co","ev","va","de","ur","st","rs","lt","rd","om","mo","ru","di","br","eg","py","^p","as","ge","y$","^g","ld","gu","p$","ap","em","ma","te","it","^s","ot","oo","ve","ak","an","gd","^m","nd","ie","ig","ti","ra","fi","nf","er","on","ls","eb","el","gt","ke","^c","es","at","n$","en","ee","il","ui","ol","e$","^e","^a","k$","rk","lg","lk","^w","si","vo","^d","t$","m$","of","^t","^v","^o","d$","^$"],"ngram_size":2,"dimension":1000},{"language":"nl","weights":[0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.0125,0.0125,0.00625,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.01875,0.00625,0.00625,0.00625,0.00625,0.01875,0.00625,0.00625,0.00625,0.00625,0.0125,0.00625,0.0125,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.0125,0.00625,0.0125,0.00625,0.0125,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.0125,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.00625,0.0125,0.00625,0.00625,0.00625,0.00625,0.01875,0.00625,0.00625,0.00625,0.00625,0.01875,0.0125,0.00625,0.00625,0.00625,0.00625,0.0125,0.0125,0.00625,0.00625,0.00625,0.00625,0.00625],"ids":[3394,887,1705,2029,2012,4877,259,2590,3441,2505,1695,3411,984,1924,2085,485,4913,700,3647,4566,395,1211,3147,2859,3222,3094,2023,3678,1327,603,2236,3454,3889,2721,3164,4377,2701,1100,791,582,538,3203,4791,720,2015,1103,2141,3009,4109,2789,2883,2541,2779,3420,2376,685,3807,1739,3561,188,835,3158,4635,564,1775,4894,3119,3918,713,4372,3407,1343,3702,335,4837,3677,4401,865,4327,4012,2461,2433,3723,1329,3221,3967,1705,4926,2499,4279,4231,3035,1956,2118,4390,1373,4389,445,3818,4622,658,4413,3797,4834,4706,1873,3878,895,3330,4959,1018,2237,1659,4714,1004,3427,1725,1872,2519,3242,3410,1795,4419,1607,1891,1491,2117,1258,884,3038,3154,899,765,4083],"ngrams":["dit$","^dit","alde","aald","paal","epaa","bepa","^bep","oor$","vatt","^bev","llee","lke$","elke","^voo","aal$","taal","voor","ktaa","akta","maak","pmaa","opma","^opm","beva","van$","tten","^van","^gen","ebru","sis$","oege","asis","lde$","^all","itge","figu","^of$","egd$","oten","^die","toeg","word","egev","^wor","eten","moet","den$","evat","tand","even","^moe","ten$","^gev","olgt","voeg","igur","^de$","^uit","ers$","lter","gevo","map$","ilte","emap","filt","atte","^elk","^fil","^toe","uik$","ruik","oegd","brui","evoe","site","volg","^sit","atie","tema","^mak","ken$","gen$","best","ven$","slot","esta","aken","make","urat","stan","tieb","tges","^py$","^bas","uitg","ters","^op$","^als","ebes","lote","rden","die$","iebe","^mag","^wer","rati","als$","^ebr","^vol","gura","^een","basi","alle","^con","geve","een$","gesl","conf","lgt$","eslo","^te$","^om$","leen","mag$","onfi","erk$","aakt","item","and$","nfig","orde","oete","werk"],"ngram_size":4,"dimension":5000},{"language":"nl","weights":[0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00980392,0.00490196,0.00980392,0.00980392,0.00980392,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.0147059,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.0196078,0.00980392,0.00980392,0.00490196,0.00490196,0.0147059,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00980392,0.00490196,0.00980392,0.00490196,0.00980392,0.00980392,0.00980392,0.0196078,0.00490196,0.0147059,0.00980392,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.0147059,0.00490196,0.00980392,0.0490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00980392,0.00490196,0.00490196,0.0147059,0.00980392,0.0147059,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196],"ids":[3356,3727,27,4326,2491,1764,1307,2260,3625,3006,2621,3265,4280,2371,3377,2483,2413,317,2274,3315,3423,2770,3239,611,1761,1448,4779,1725,4318,1046,4579,2875,4678,1636,2256,4798,3090,1715,4317,4359,3719,2241,1317,1975,3848,2799,1471,3204,809,4963,2511,4713,176,3725,4710,1057,4562,1590,1051,413,3848,681,4366,868,3991,2277,3881,2488,4971,1414,60,1063,2793,87,4650,3796,1052,4311,1119,2034,201,4534,531,947,1971,1051,761,3498,3989,3276,2285,1936,4689,2437,582,2964,982,350,4800,122,3059,4024,705,2694,3662,3507,4003,2841,408,503,1147,4194,3087,2890,3881,1507,3037,1305,2143,4484,4732,3278,16,1856,67,1618,4572,3536,3116,873,2331,1448,1844,152,2428,1864,2957,1856,4381,4233,2130,3269,367,2652,599,949,2254,6,1192],"ngrams":["it$","ald","paa","bep","oor","att","eva","^be","tte","all","mag","ke$","lke","elk","^el","al$","akt","lde","maa","pma","kta","opm","an$","is$","sis","bas","^ba","slo","esl","ote","tge","itg","^ui","of$","die","^of","lot","evo","igu","ege","ten","toe","rde","bev","ven","ie$","lle","eve","egd","ete","^op","gev","op$","lee","nfi","^de","den","^s$","wer","rs$","ag$","lte","ord","fil","bru","^fi","ers","sit","uik","ake","ik$","py$","ilt","gen","van","oeg","rui","ap$","^we","map","dit","ema","ite","tem","de$","^wo","aal","^si","gd$","bes","oet","^ma","nd$","and","sta","^om","ebe","moe","gur","or$","als","ter","ken","^py","gt$","rk$","een","asi","^vo","en$","con","^al","uit","tan","voo","ura","ebr","ati","^ge","om$","erk","^co","^te","taa","te$","est","aak","ges","onf","^to","ieb","^eb","lgt","mak","^a$","wor","ls$","voe","^di","^ee","tie","vat","^mo","olg","vol","epa","rat","^va","fig"],"ngram_size":3,"dimension":5000},{"language":"nl","weights":[0.0337838,0.00337838,0.0168919,0.0101351,0.0439189,0.0202703,0.0304054,0.128378,0.00675676,0.0540541,0.027027,0.0202703,0.0608108,0.00337838,0.0304054,0.027027,0.155405,0.0101351,0.0337838,0.0202703,0.155405,0.0337838,0.0743243],"ids":[66,58,11,59,20,24,0,79,32,22,77,57,21,65,0,88,68,22,44,19,52,2,96],"ngrams":["i","c","b","u","n","r","d","e","w","o","p","v","t","y","m","g","$","f","s","k","^","l","a"],"ngram_size":1,"dimension":100},{"language":"no","weights":[0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.00784314,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.0156863,0.00784314,0.00784314,0.00392157,0.00392157,0.00784314,0.0117647,0.00784314,0.00392157,0.00392157,0.00392157,0.0117647,0.0117647,0.0235294,0.00392157,0.0196078,0.0117647,0.00392157,0.00392157,0.0156863,0.00784314,0.00784314,0.00392157,0.0117647,0.00784314,0.0117647,0.00392157,0.00784314,0.0117647,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.00392157,0.0156863,0.0156863,0.0117647,0.0117647,0.00392157,0.0117647,0.00392157,0.00784314,0.0235294,0.00392157,0.0156863,0.0196078,0.0196078,0.00784314,0.00784314,0.00392157,0.0117647,0.0117647,0.00392157,0.00784314,0.00392157,0.00392157,0.0156863,0.0117647,0.00392157,0.00784314,0.0117647,0.00392157,0.00392157,0.00392157,0.00392157,0.00784314,0.0156863,0.00392157,0.0156863,0.00392157,0.0117647,0.00392157,0.00392157,0.00392157,0.0117647,0.00784314,0.0156863,0.00784314,0.00392157,0.0117647,0.00784314,0.00784314,0.0313726,0.0196078,0.00392157,0.0156863,0.00784314,0.00392157,0.00784314,0.00392157,0.00784314,0.00392157,0.0117647,0.00392157,0.00392157,0.00392157,0.00784314,0.0117647,0.0196078,0.0117647],"ids":[314,907,879,7,540,108,98,267,999,886,379,91,83,834,227,660,128,571,364,173,707,809,985,356,157,738,397,960,67,826,383,75,481,875,518,353,104,347,652,575,487,778,225,193,166,126,333,925,575,887,651,989,685,501,549,19,195,841,248,46,128,544,591,285,604,937,493,486,61,18,269,215,961,949,378,153,862,147,175,382,770,605,114,244,900,782,291,257,535,493,793,996,327,955,41,980,349,819,391,96,254,786,489,630,895,75,146,8,458,842,933,379,829,115,237,332,976,19,200,734,838,212,526,296],"ngrams":["l$","ag","ra","sa","os","kk","ik","eh","ge","eg","ep","ve","pg","br","iv","lt","po","mp","uk","ei","d$","nd","ri","me","na","so","oi","pa","nt","ko","ky","nj","hi","k$","pe","er","sp","pp","up","rd","om","ru","ss","le","rn","gr","ll","^g","^e","v$","e$","a$","je","ba","nl","lb","gf","id","n$","al","jo","sj","ke","rm","øk","og","in","^b","^k","as","an","ta","gg","sø","la","en","^d","ka","il","mm","g$","ng","do","vn","pl","dr","yv","sf","^l","lo","to","ds","r$","te","ma","^t","se","li","ga","ni","av","is","es","at","am","op","or","^a","fi","fo","ti","ig","sk","bl","ne","ob","^o","gs","st","rs","^$","^p","on","nf"],"ngram_size":2,"dimension":1000},{"language":"no","weights":[0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00966184,0.00966184,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.00483092,0.0144928,0.0144928,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.0144928,0.00483092,0.00483092,0.00483092,0.0144928,0.00483092,0.0144928,0.00483092,0.0144928,0.00483092,0.00483092,0.0144928,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00483092,0.0144928,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.00483092,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.0144928,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00483092,0.00966184,0.00966184,0.0144928,0.00483092,0.00966184,0.00483092,0.00483092,0.00483092,0.00483092],"ids":[3689,3452,2254,1867,2977,2047,1408,4192,411,3547,2824,1388,4881,2873,4612,2936,4148,1810,707,3897,3253,1255,1294,4770,480,2628,3832,759,4282,4372,606,3428,2826,1871,1672,835,4215,2743,3289,4408,2025,503,4681,4283,1294,4714,571,4022,3299,1391,1705,1912,3343,2907,4846,2579,2371,1793,1696,3791,1913,3586,655,1932,4049,4580,4672,4049,3464,1345,4341,162,1231,2667,4374,2424,244,4416,2256,700,2881,3644,1229,2622,1284,1205,4033,2054,435,3204,4961,3517,2034,850,4517,150,3599,1766,484,1108,734,3973,4254,2324,641,4227,3877,1501,183,4879,1065,4763,2794,1140,4251,1831,2231,538,1031,4914,2183,1180,1811,2635,2742,2987,3814,100,1000,4419,3023,2767,160,4504,3164,3885,2643,1804,1856,570,3986,4666,2116,2036,1989,4297,2655,2545,3814,4508,445,1173,1138,760,3711,2842,4253,1985,3854,4390,1205,754,4942,3935,2401,4415,627],"ngrams":["^ant","drag","endr","mmen","amme","ntal","samm","osam","mend","ikk$","rikk","stor","isto","ehis","vehi","aveh","gger","legg","vepl","pgav","ppga","oppg","^opp","pper","ker$","ndra","epla","uker","ntos","^bru","bruk","tiv$","nati","erna","tern","lter","^alt","spor","njes","panj","mpan","kamp","^kam","lanl","lle$","alle","obli","einf","yvni","asso","pein","dome","ord$","tids","ssor","hist","toin","kont","per$","avn$","navn","ger$","idsf","pena","pori","ppei","ampa","uppe","avep","oggf","pass","bane","rupp","rnat","jon$","grup","tall","anta","ane$","lban","filb","ggfi","mene","ativ","^gru","sjon","ilba","all$","jesp","asjo","oinf","form","espo","info","ning","^log","nfor","ruke","ninf","anin","ator","enav","søk$","gsøk","^kat","liga","logs","orin","^kon","rsky","igat","kata","ene$","ogsø","ntoi","^obl","gato","^av$","erin","seri","^pla","^er$","masj","sser","tori","lass","tosa","plas","gfil","fors","vnin","alte","isk$","ing$","^all","ppen","plan","kyvn","egge","asse","^dom","sord","nleg","anle","oris","rag$","alog","anje","dsfo","risk","rmas","atal","orik","^tid","omen","skyv","logg","sfor","ring","onto","orma","orsk","gave","talo","blig","^pas","lani"],"ngram_size":4,"dimension":5000},{"language":"no","weights":[0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.00869565,0.00869565,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.00869565,0.00434783,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.00869565,0.00434783,0.00434783,0.00869565,0.00434783,0.00434783,0.0130435,0.00434783,0.00434783,0.0130435,0.0130435,0.00434783,0.00434783,0.0130435,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.0130435,0.00434783,0.00434783,0.0130435,0.00434783,0.00869565,0.0130435,0.0130435,0.00434783,0.0130435,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.00434783,0.0130435,0.00434783,0.00434783,0.00434783,0.0130435,0.00434783,0.00869565,0.00434783,0.00869565,0.0130435,0.0130435,0.00434783,0.00434783,0.0130435,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.0130435,0.00434783,0.00434783,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00869565,0.00434783,0.0130435,0.00869565,0.00434783,0.00869565,0.00869565,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.0130435,0.00869565,0.0130435,0.00434783,0.0173913,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.00434783,0.0173913,0.00434783,0.00434783,0.00434783],"ids":[2207,2176,377,2549,3366,3019,1782,4697,1628,2634,1484,649,3703,3754,3931,1886,1472,2511,4995,1628,587,0,3991,1944,2617,563,2564,1305,3684,1366,3848,681,4826,1946,4155,4513,2204,3299,777,4872,2229,4497,4852,1471,4194,2756,2241,4024,1849,3028,3886,4001,868,891,3891,539,217,1981,1168,3625,2626,2397,1795,4534,1630,1249,1705,597,2570,4802,4716,1091,3791,2701,3130,4827,3514,2460,3757,1094,4845,3346,4275,1916,3938,4246,2085,1250,706,446,2428,4599,4773,4936,1778,4642,361,1350,2603,4102,3538,437,3138,4877,4448,132,2267,3374,792,4258,3153,550,4601,2534,760,4092,4884,405,4662,642,2584,2019,1137,4814,4035,1191,4631,4046,4149,4885,3851,592,276,721,4973,2344,3849,166,3006,2942,3123,4276,1369,4366,266,3049,4094,1030,3764,3691,1270,4400,2346,1962,702,1987,4146,4882,2505,1086,3418,319,3613,3899,3136],"ngrams":["ll$","nta","rag","ndr","amm","tos","ikk","ist","sam","his","ger","egg","anl","ave","^an","gav","opp","^op","ant","per","ker","uke","bru","epl","^br","iv$","tiv","ati","rna","ern","ag$","lte","por","nje","anj","pga","pan","mpa","dra","amp","kam","le$","rik","lle","^al","ein","men","ter","^ka","sor","veh","oin","fil","ont","gge","^ko","avn","toi","nto","pen","^do","ppe","ser","rd$","ori","gru","nav","ane","^gr","ban","ehi","ruk","lba","dsf","gfi","^lo","jon","vn$","end","asj","vep","kon","orm","nfo","iga","inf","eri","alo","ani","esp","^a$","lan","øk$","spo","ids","gsø","sto","vni","pas","log","ata","^av","rma","jes","rsk","av$","on$","kk$","tor","tid","rin","ng$","sjo","ggf","ilb","ing","^pl","alt","ogs","kat","obl","ris","pla","^pa","kyv","ppg","ors","sse","søk","sfo","ato","dom","sso","tal","isk","rup","nin","sk$","all","ass","^er","osa","lig","ord","gat","mas","ne$","upp","mme","for","las","nle","sky","ome","bli","^ti","pei","ene","yvn","ogg","nat","er$","leg","ena","^ob"],"ngram_size":3,"dimension":5000},{"language":"no","weights":[0.00357143,0.0142857,0.0571429,0.0464286,0.0214286,0.0178571,0.05,0.0357143,0.0892857,0.0142857,0.00357143,0.0321429,0.0785714,0.0107143,0.00357143,0.075,0.0678571,0.0464286,0.0892857,0.0142857,0.0607143,0.025,0.0535714,0.0892857],"ids":[63,5,77,2,57,22,44,19,52,59,65,21,20,11,46,22,24,66,96,0,79,0,88,68],"ngrams":["h","j","p","l","v","f","s","k","^","u","y","t","n","b","ø","o","r","i","a","d","e","m","g","$"],"ngram_size":1,"dimension":100},{"language":"ny","weights":[0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.0123457,0.0308642,0.0246914,0.0123457,0.00617284,0.00617284,0.0123457,0.00617284,0.00617284,0.00617284,0.0123457,0.00617284,0.00617284,0.0123457,0.00617284,0.0123457,0.0123457,0.00617284,0.0123457,0.0185185,0.00617284,0.00617284,0.0246914,0.0123457,0.00617284,0.00617284,0.00617284,0.00617284,0.0185185,0.0308642,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.0617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.00617284,0.0185185,0.0123457,0.0246914,0.037037,0.0185185,0.0123457,0.0123457,0.0246914,0.00617284,0.0123457,0.0185185,0.0123457,0.0123457,0.0123457,0.0123457,0.00617284,0.00617284,0.0185185,0.0123457,0.0246914,0.00617284,0.00617284,0.00617284,0.0185185,0.00617284],"ids":[898,734,745,526,353,183,880,193,885,977,251,128,75,298,489,575,379,355,789,191,61,879,927,895,107,500,123,766,287,676,230,108,943,19,601,481,476,41,841,545,809,605,960,67,688,215,269,803,692,7,553,793,935,559,439,989,144,62,147,390,623,529,752,685,120,518,862,493,535,391,819,532,826,651,875,854,656,838,46,83,493,487,848,924,347,657,157,378,96,712,925,98,486],"ngrams":["ts","et","ug","on","er","he","ph","le","^u","yi","ny","po","nj","ip","ed","^e","ep","^m","uŵ","ku","^k","ra","mu","am","ŵa","yo","^y","ab","it","za","iz","ak","ot","ol","ho","hi","^c","ma","id","ir","nd","ng","pa","nt","wa","ta","an","di","gi","sa","go","to","ap","wo","tc","a$","be","zi","ka","mw","aw","dz","ha","je","im","uu","^d","lo","^l","ga","li","o$","ko","e$","un","^n","bo","^$","al","ul","in","om","i$","dw","th","ch","na","la","ni","we","^g","ik","^b"],"ngram_size":2,"dimension":1000},{"language":"ny","weights":[0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.0166667,0.0166667,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.0166667,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.0166667,0.0166667,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333,0.00833333],"ids":[740,3665,2846,2127,4283,4905,3181,963,594,2373,3409,2430,4331,525,3910,3962,2652,1512,3894,4807,3922,2377,102,4410,1357,3814,1135,4108,3609,805,4918,414,3611,3623,1413,3318,3736,4192,4968,598,3612,2359,3358,4529,2426,2827,80,2243,355,400,4959,3999,2989,105,1452,4081,4644,2020,3162,4604,2352,3361,1779,2210,4802,2577,1811,3119,1108,236,2984,319,2442,2627,2331,2442,2194,1868,3880,2869,3735,2088,2879,22,4808,491,1169,4368,1015,3487,715,3336,3917,2705,4648,4372,2612,1974,849,4412,195,2982,373,944,1069,3660,1338,3109,3145],"ngrams":["etsa","njet","onje","hera","pher","ephe","nale","unal","yima","nyim","edip","dita","ndit","^kug","abe$","kabe","ikab","^kuŵ","nika","iko$","uuni","ipo$","kuli","^bom","ako$","alak","uŵal","mwe$","dipo","lira","ita$","kuŵa","ira$","tsa$","^una","muli","amul","ikuu","tchi","yola","^yol","oma$","^edi","ito$","kugo","^ndi","^ntc","chol","hand","mand","hoth","nga$","lako","ling","inga","alep","unik","gonj","gawo","olam","holi","chit","ziko","chot","leph","^nyi","kuun","dwa$","gidw","napa","andi","^cho","jets","ngid","hito","^man","otha","ntch","pang","liku","apan","boma","ndi$","ŵala","iza$","ima$","lamu","diza","^lom","omwe","lomw","ugon","inap","ndiz","ulik","olin","dzik","^dzi","idwa","awo$","era$","ulir","^gaw","lina","^kul","angi","^lin","than","^la$"],"ngram_size":4,"dimension":5000},{"language":"ny","weights":[0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.0142857,0.0285714,0.0142857,0.00714286,0.0142857,0.0142857,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.0142857,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.0142857,0.00714286,0.00714286,0.00714286,0.0142857,0.00714286,0.00714286,0.0142857,0.00714286,0.0142857,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.0142857,0.00714286,0.0142857,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.0214286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.00714286,0.0142857,0.0285714,0.00714286,0.0142857,0.00714286,0.0142857,0.00714286,0.00714286,0.00714286,0.0142857,0.00714286,0.00714286],"ids":[2644,3335,4520,4628,1946,2049,4649,4983,1154,337,327,579,4002,1397,3811,1208,2533,201,2042,1936,927,3353,522,4324,2355,639,4290,1392,4230,1111,1778,2959,1536,3836,1227,1719,16,374,2343,1027,1082,1558,141,4505,2715,3346,1637,3007,1942,4584,1655,638,3606,4619,1889,3888,1353,1302,2696,133,1999,3695,4373,2034,2437,4907,714,4975,2879,4110,4063,2883,4696,1136,1079,1520,3952,3999,849,31,2477,1651,1520,1680,2204,1034,235,3082,3502,2518,3006,4446,1689,2387,3382,4827,129,2911,1285,638,4207,1794,327,1599,3249,4215,2828,1501,1755,238,3534,4112,4092,1257,2875,273,4894],"ngrams":["sa$","tsa","ets","jet","nje","gon","ugo","era","her","nal","una","^un","ima","yim","wa$","ipo","^ed","dit","lom","^ma","be$","abe","kab","wo$","ika","mwe","nap","dip","hit","apa","nik","^dz","nyi","za$","uni","uun","ita","man","kuu","iku","ako","ndi","ala","kul","uŵa","kuŵ","ira","lir","^ny","ola","yol","oli","^yo","kug","eph","bom","to$","ina","lak","ito","iza","edi","lam","la$","and","omw","oth","nga","uli","ntc","phe","cho","ta$","^ch","tch","onj","hot","dwa","tha","ale","idw","^ga","lep","ang","pan","amu","gid","ra$","^nt","^nd","^li","mul","we$","^la","iko","^lo","han","ko$","dzi","chi","ga$","ngi","gaw","zik","awo","ŵal","^ku","diz","di$","hol","ma$","po$","ing","oma","lin","lik","^bo"],"ngram_size":3,"dimension":5000},{"language":"ny","weights":[0.00543478,0.00543478,0.0543478,0.0108696,0.0108696,0.0108696,0.0652174,0.0271739,0.0163043,0.0163043,0.119565,0.0108696,0.0434783,0.0108696,0.0163043,0.076087,0.119565,0.048913,0.119565,0.0217391,0.0271739,0.0326087,0.0380435,0.0271739,0.0652174],"ids":[44,5,2,81,24,65,20,21,58,77,68,86,59,11,32,66,96,19,52,88,0,79,0,63,22],"ngrams":["s","j","l","ŵ","r","y","n","t","c","p","$","z","u","b","w","i","a","k","^","g","m","e","d","h","o"],"ngram_size":1,"dimension":100},{"language":"pa","weights":[0.0175439,0.0175439,0.0175439,0.0350877,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0350877,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0350877,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0175439,0.0350877,0.0350877],"ids":[275,729,253,968,189,225,861,643,163,66,577,475,25,943,439,637,106,77,977,220,295,45,363,323,72,219,843,950,496,561,849,173,276,566,422,996,279,34,16,301,437,149,70,550,855,499,897,518,192,85,475,838],"ngrams":["ਚੱ","ਫਸ","ੜਫ","ਲ$","ਅੜ","ਾਲ","ਮ$","ਾਮ","^ਂ","ਰਾ","ਚ$","^ਰ","ੰਦ","ਭਾ","ੋਬ","ਿੰ","ਸ$","ਬਿ","^ਗ","ੜ$","ਗੋ","^ਚ","ੀ$","ਬ$","ਿਬ","^ਸ","ਾਂ","ਾਈ","ਬ�","^ਵ","^ਭ","^ਨ","ਦੀ","^ਦ","ਵਿ","ਈ$","ਦ$","�ੱ","ੱਲ","ਨਾ","ਾਹ","^ਅ","ਸਾ","ਿਨ","ਹਿ","^ਬ","ਦਿ","ਚੜ","ਿਚ","ੱਚ","ਂ$","^$"],"ngram_size":2,"dimension":1000},{"language":"pa","weights":[0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581,0.0322581],"ids":[3945,4767,2865,3215,1576,1830,964,3559,4187,451,3615,4988,5,1687,1572,1191,2799,2785,3462,2146,93,4831,3135,723,4983,905,16,3960,215,4145,2378],"ngrams":["ਚੱਲ$","ਅੜਫਸ","ਨਾਲ$","^ਨਾਲ","^ਰਾਮ","ਰਾਮ$","^ਭਾਈ","ਬਿੰਦ","^ਦੀ$","^ਬ�ੱ","ੋਬਿੰ","^ਗੋਬ","ੱਚੜ$","�ੱਚੜ","^ਸਾਹ","ਬ�ੱਚ","ਾਹਿਬ","ਭਾਈ$","ਦਿਨਾ","^ਵਿਚ","^ਚੱਲ","ਿੰਦ$","ਨਾਂ$","ਸਾਹਿ","ਹਿਬ$","ੜਫਸ$","ਿਨਾਂ","ਵਿਚ$","^ਅੜਫ","ਗੋਬਿ","^ਦਿਨ"],"ngram_size":4,"dimension":5000},{"language":"pa","weights":[0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558,0.0232558],"ids":[2596,3985,3326,278,4647,3328,2688,2354,1118,3142,3206,4935,553,613,3326,490,341,3445,2154,3500,728,2288,2886,1253,4983,1669,1838,1780,381,3751,3837,3189,4139,2027,178,4632,1386,1215,1256,96,2014,954,1381],"ngrams":["^ਚੱ","ੜਫਸ","ਾਲ$","ਨਾਲ","^ਨਾ","^ਰਾ","ੰਦ$","ਬਿੰ","ੋਬਿ","ਿੰਦ","ਚੜ$","ਸਾਹ","ੱਚੜ","^ਅੜ","^ਗੋ","ਭਾਈ","^ਭਾ","^ਬ�","ਾਮ$","ਦੀ$","ਿਬ$","ਦਿਨ","ਾਂ$","ਹਿਬ","ਾਹਿ","ਨਾਂ","ਾਈ$","ਰਾਮ","ਬ�ੱ","ਗੋਬ","ਿਚ$","ਫਸ$","ਵਿਚ","ੱਲ$","ਅੜਫ","^ਂ$","^ਵਿ","ਚੱਲ","ਿਨਾ","^ਦੀ","^ਦਿ","�ੱਚ","^ਸਾ"],"ngram_size":3,"dimension":5000},{"language":"pa","weights":[0.028169,0.0140845,0.0140845,0.0140845,0.0422535,0.0140845,0.0140845,0.0422535,0.028169,0.0140845,0.0140845,0.028169,0.0140845,0.0422535,0.028169,0.0140845,0.0140845,0.028169,0.0140845,0.0140845,0.028169,0.0704225,0.056338,0.197183,0.0140845,0.197183],"ids":[97,72,58,54,12,96,24,32,19,5,65,75,9,87,30,45,52,6,41,44,62,66,22,68,26,52],"ngrams":["ਲ","ਮ","ੰ","ੋ","ਬ","ਹ","ਅ","ਚ","ਸ","ਗ","�","ੜ","ੀ","ਦ","ਂ","ਭ","ਈ","ਨ","ਵ","ਰ","ੱ","ਾ","ਿ","$","ਫ","^"],"ngram_size":1,"dimension":100},{"language":"pl","weights":[0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00829876,0.00414938,0.00829876,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00829876,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.0207469,0.00414938,0.0124481,0.00414938,0.00414938,0.00414938,0.00829876,0.00829876,0.00829876,0.00829876,0.00829876,0.00829876,0.00829876,0.00414938,0.00414938,0.00414938,0.00829876,0.00414938,0.00414938,0.00829876,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.0165975,0.00414938,0.00829876,0.00414938,0.00414938,0.0124481,0.00414938,0.00829876,0.00829876,0.0124481,0.00414938,0.00829876,0.00414938,0.0165975,0.00414938,0.0124481,0.00829876,0.0165975,0.00829876,0.00414938,0.00829876,0.00829876,0.0165975,0.0124481,0.0165975,0.0165975,0.00414938,0.0165975,0.00414938,0.00414938,0.0207469,0.00414938,0.0165975,0.00414938,0.00829876,0.00414938,0.00829876,0.00829876,0.00414938,0.00414938,0.0124481,0.00414938,0.00414938,0.00829876,0.0124481,0.0124481,0.00414938,0.00829876,0.00414938,0.0456432,0.00829876,0.00414938,0.0124481,0.0124481,0.00414938,0.00414938,0.00829876,0.00414938,0.00829876,0.00829876,0.00414938,0.00414938,0.00414938,0.00414938,0.0124481,0.00829876,0.00829876,0.0248963,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.00414938,0.0124481,0.0124481,0.00829876,0.0124481,0.00414938,0.00829876,0.00414938],"ids":[734,443,148,88,859,657,848,560,332,566,742,772,355,804,999,793,893,676,854,215,887,576,976,251,526,887,341,96,559,157,738,960,75,207,114,147,862,747,3,396,353,104,763,532,108,754,512,458,193,126,18,75,795,999,688,28,893,895,802,899,591,715,489,564,67,269,486,61,671,586,294,438,826,173,378,757,532,265,925,605,501,685,989,909,237,875,8,249,303,429,645,746,980,841,568,98,717,879,623,529,511,651,885,46,854,885,685,679,475,436,770,402,493,937,470,300,334,164,62,10,848,379,983,819,280,265,596,265,838,200,535,365,503],"ngrams":["et","św","wy","ór","tó","ch","ys","ws","ob","sz","oż","zy","^m","h$","kż","to","mo","za","ac","ta","oz","yś","^o","ny","on","oj","ż$","ni","wo","na","so","pa","op","ej","do","ka","^d","z$","j$","ą$","er","sp","ad","o$","ak","af","ic","fi","le","gr","as","pr","ow","ge","wa","kt","yć","am","eo","^ż","ro","cz","es","ki","dy","an","^b","^k","^z","że","są","ć$","ko","ży","la","ek","^s","re","^g","y$","ba","je","a$","tl","ne","k$","^a","ł$","uż","ia","^i","ał","^t","id","nn","ik","^w","ra","aw","dz","zo","e$","^u","al","^n","tk","bę","au","zn","tw","yt","wn","in","og","iż","m$","^r","my","zi","ie","i$","ep","ii","li","ęd","pi","wi","kl","^$","st","^l","tr","us"],"ngram_size":2,"dimension":1000},{"language":"pl","weights":[0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.0118343,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.0118343,0.00591716,0.00591716,0.0118343,0.00591716,0.00591716,0.00591716,0.0118343,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.0118343,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.0118343,0.0118343,0.00591716,0.00591716,0.0118343,0.0118343,0.00591716,0.0118343,0.00591716,0.00591716,0.00591716,0.0118343,0.00591716,0.00591716,0.00591716,0.0177515,0.00591716,0.0177515,0.00591716,0.0177515,0.00591716,0.0177515,0.00591716,0.00591716,0.00591716,0.00591716,0.0118343,0.0118343,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.0118343,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.0118343,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716,0.00591716],"ids":[2066,2527,4558,2988,2799,4381,1497,4633,1267,3141,1763,893,2376,3890,409,837,3692,3967,355,1935,380,2609,2143,4474,4185,129,3894,4629,2156,3572,3318,3328,2256,3628,2153,1445,422,3674,1945,4023,4696,185,502,4926,201,2259,2772,724,4776,2070,1353,2651,2253,2060,3350,4159,4400,2079,546,2370,499,4338,951,3883,315,351,369,1563,743,3607,2151,23,3636,4833,4346,2669,4546,3137,1374,1724,2358,3899,4791,1471,1784,1891,3439,2900,3703,3998,2219,3476,2873,2436,4793,3522,453,991,3710,4771,1779,157,2425,4098,2270,876,3102,894,610,1423,3058,1855,4319,3548,2795,1574,1607,2055,2026,1138,3729,4551,4751,2140,2134,766,1824,4249,3197,52,948,4184,3272,3122,127,3244,3933,4133,4423,2487,4448,3308,4120,1658,1267,664],"ngrams":["tlan","etla","ietl","wyśw","tóre","tkic","stki","ystk","zyst","szys","wszy","zyć$","aczy","bacz","zoba","żesz","któr","może","kże$","akże","acza","ozna","^ozn","ony$","tron","twoj","nika","^któ","woje","^do$","nik$","praw","ane$","obac","wane","sowa","^spr","afic","paso","tral","^two","opas","tkow","dopa","iej$","^są$","wia$","iczn","ika$","owan","awia","wiet","^moż","spra","lepi","rafi","óre$","graf","^że$","ogra","yświ","geog","^geo","wani","lam$","^to$","rowa","erow","iero","kier","będz","anad","rali","ficz","kana","esz$","ojej","alii","nne$","lamy","kown","^wsz","piej","żytk","ytko","^niż","amy$","ustr","ział","^kan","owni","stro","^nie","anie","klam","znac","rekl","nacz","^rek","ożes","ekla","lane","ady$","inne","iał$","użyt","^uży","nady","^inn","zne$","takż","zie$","^wyś","rony","świe","nie$","stra","idzi","asow","czne","czyć","widz","epie","dzie","^str","kich","^dop","^na$","ędzi","lii$","^kie","dzia","^tak","rawi","aust","wnik","niż$","^będ","^zob","jej$","^wid","^aus","ich$","cza$","^lep","eogr"],"ngram_size":4,"dimension":5000},{"language":"pl","weights":[0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.0147059,0.00490196,0.00490196,0.00490196,0.0147059,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.0147059,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.0147059,0.00980392,0.00980392,0.00980392,0.00980392,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00980392,0.00980392,0.00980392,0.00980392,0.0147059,0.0196078,0.00980392,0.00490196,0.00490196,0.0147059,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.0147059,0.00980392,0.00490196,0.00490196,0.00980392,0.00980392,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00980392,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196,0.00490196],"ids":[4673,3915,557,3594,729,185,1238,2921,504,1312,996,2112,3875,188,3864,2944,2200,1916,3670,2982,1808,2961,3341,350,2120,873,3836,1297,1645,2460,870,4232,805,1866,1941,2319,2030,2355,1193,537,4329,900,2391,1378,4054,4814,3848,734,2667,1167,4448,1989,1088,4775,234,597,1353,2121,140,4753,2707,1012,1003,2481,3603,367,3701,2132,4377,989,708,1360,2700,3702,2626,2371,2143,77,1427,706,2133,1706,2073,1344,1371,4575,144,4005,2861,2785,1849,979,2985,1152,1088,3523,2689,3109,60,4887,3021,4373,4597,1592,1077,405,2958,2054,1984,261,3860,1876,708,2163,759,1778,4121,2249,2718,681,4094,1446,1716,78,1167,3940,4125,2603,1326,1366,1357,3194,3542,1376,2201,1058,3438,4853,2799,1373,2151,322,3566,4177,4412,834,3106,1285,1580,4599,3569,2428,2035,2728,169,3861,1001,1265,2413,1520,883,3552,4420],"ngrams":["na$","^na","etl","iet","wie","świ","yśw","wyś","re$","^kt","am$","ch$","ich","stk","yst","zys","szy","wsz","yć$","zyć","oba","zob","esz","moż","^ta","^to","za$","cza","acz","^wy","nac","^oz","kże","jej","two","^tw","ka$","ika","do$","ny$","dop","ej$","pie","dy$","że$","tki","ia$","będ","^re","wia","awi","^st","raw","pra","czn","ane","to$","zne","opa","^są","spr","ozn","fic","bac","epi","^mo","aso","gra","eog","aus","zia","geo","akż","ony","^do","icz","^ge","sow","sz$","ani","iej","ero","któ","kla","ier","kie","nad","ogr","ana","kan","^ka","^zo","ral","^bę","ytk","^z$","tla","^sp","ik$","żes","own","lam","kow","tko","żyt","^ni","tór","owa","czy","^wi","iż$","^in","raf","my$","afi","nik","amy","uży","^uż","ekl","ne$","nie","nne","kic","rek","lii","inn","pas","idz","ał$","zna","iał","ędz","tra","ady","wid","są$","ust","ie$","wan","tak","woj","wni","^że","ii$","ron","tro","dzi","ali","lan","oże","^a$","oje","niż","óre","^ws","str","zie","^le","lep","row","^ki","^au"],"ngram_size":3,"dimension":5000},{"language":"pl","weights":[0.00359712,0.00359712,0.00359712,0.0107914,0.0107914,0.0143885,0.00359712,0.00359712,0.0467626,0.00719424,0.0359712,0.0503597,0.0323741,0.0143885,0.00359712,0.0611511,0.0359712,0.0755396,0.00719424,0.0179856,0.0107914,0.00719424,0.0431655,0.133094,0.0215827,0.0323741,0.0251799,0.00359712,0.133094,0.0359712,0.0323741,0.0791367],"ids":[86,11,63,5,77,58,22,66,22,88,21,20,65,0,95,66,32,79,90,0,59,11,19,52,2,24,50,23,68,86,44,96],"ngrams":["ś","ó","h","j","p","c","f","ć","o","g","t","n","y","m","ł","i","w","e","ą","d","u","b","k","^","l","r","ż","ę","$","z","s","a"],"ngram_size":1,"dimension":100},{"language":"pt","weights":[0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00803213,0.00401606,0.00401606,0.00803213,0.00803213,0.0160643,0.00401606,0.00401606,0.00803213,0.00803213,0.00401606,0.00401606,0.00401606,0.00401606,0.00803213,0.00803213,0.0160643,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00401606,0.00803213,0.00401606,0.00803213,0.00803213,0.0281125,0.00401606,0.0441767,0.00401606,0.00401606,0.00803213,0.00803213,0.00401606,0.00401606,0.00803213,0.0120482,0.00401606,0.0240964,0.00401606,0.00401606,0.00803213,0.00803213,0.00401606,0.0120482,0.00401606,0.00401606,0.00401606,0.00803213,0.00803213,0.00401606,0.00401606,0.0160643,0.00803213,0.0120482,0.00803213,0.00401606,0.00401606,0.00803213,0.0160643,0.00401606,0.0240964,0.00401606,0.0401606,0.0160643,0.00401606,0.00803213,0.00803213,0.0160643,0.00401606,0.0240964,0.00803213,0.0120482,0.00803213,0.0281125,0.0200803,0.00401606,0.00401606,0.0120482,0.00401606,0.0120482,0.00401606,0.00401606,0.00803213,0.00803213,0.0120482,0.0120482,0.00401606,0.0160643,0.0120482,0.00401606,0.00803213,0.00401606,0.00803213,0.00803213,0.0120482,0.00803213,0.0281125,0.00401606,0.0200803,0.00401606,0.00803213,0.00401606,0.0200803],"ids":[994,957,668,920,532,732,925,215,535,666,571,442,943,75,761,476,429,963,391,672,334,300,410,976,327,844,793,489,707,27,834,486,173,915,319,540,62,989,458,71,314,41,287,955,175,933,656,879,210,65,980,114,201,353,89,984,91,200,176,171,605,545,950,18,999,128,854,637,355,590,116,847,510,8,349,514,225,385,7,532,763,891,153,651,575,384,503,339,953,854,86,770,768,484,727,591,978,265,403,766,985,356,365,269,960,67,212,613,862,402,838,205,489],"ngrams":["oa","uc","rg","ua","^s","su","^g","ta","^l","ão","mp","tí","ot","pr","má","^c","ia","ci","ga","da","^r","m$","em","^o","r$","uz","to","ed","ce","si","br","^b","ei","io","ár","os","zi","a$","tu","^v","l$","ma","it","te","il","ti","bo","ra","êx","tê","^t","do","sá","er","á$","rt","ve","st","lu","xt","ng","ir","íc","as","ge","po","uá","ut","^m","vê","ar","ê$","s$","^a","se","du","ss","de","sa","o$","ad","^q","en","e$","^e","ns","eç","ue","rã","^n","cr","ço","ca","rc","qu","ro","bi","re","no","ab","ri","me","tr","an","pa","nt","^p","t$","^d","od","^$","ev","es"],"ngram_size":2,"dimension":1000},{"language":"pt","weights":[0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.0125786,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.0188679,0.00628931,0.0188679,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.0125786,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931],"ids":[2354,3464,1098,3351,1571,1666,2131,4159,1300,733,3535,3914,532,2883,4791,4831,3215,62,3371,4562,3759,3755,4651,2301,1092,2952,4529,1614,4585,2964,4509,3791,2240,1739,632,258,3696,998,2856,2144,3458,394,542,3796,3565,119,3005,4011,1225,497,1419,700,4395,37,3780,4483,4795,3572,308,4754,2362,1762,3152,1667,4209,3009,144,1849,911,1715,2850,2699,3145,3801,807,679,2594,2400,1536,2918,4973,822,595,3866,654,1771,3737,4164,2266,1607,3550,2349,343,673,4731,191,4781,4555,1809,2530,1167,2608,2325,2476,3540,4350,4081,3552,1924,519,2428,1192,3090,336,4831,1215,936,4700,2145,2452,4393,3594,3445,3801,1795,567,4970,1926,2427,2391,3210,42,3357,3913,2536,4900,823,637],"ngrams":["boa$","mas$","lucr","^luc","ens$","arge","marg","^mar","uas$","ntir","rant","utar","luta","gara","^lut","rão$","erão","terã","cro$","ios$","rios","esár","aran","resá","pres","ara$","entr","para","ntra","vest","cia$","rtir","part","^de$","rca$","^par","^cer","eços","^emp","preç","êxti","zir$","duzi","eduz","redu","^red","tíci","sári","ços$","poss","sil$","uzir","asil","tar$","trad","bras","^bra","^do$","^not","^pos","ário","^má$","utos","uári","tos$","que$","cerc","estu","tir$","arti","^os$","reço","^ves","xtil","^pro","cado","rcad","otíc","suas","^mer","rodu","iros","ses$","ngei","^pre","^no$","ange","rang","tran","stra","estr","duto","odut","ado$","ossa","rgen","^est","tuár","^que","ucro","eiro","erca","^têx","prod","til$","evê$","^boa","ros$","têxt","^ter","esse","^em$","ada$","empr","dess","rada","anti","^ent","^sua","merc","^gar","revê","mpre","^des","notí","prev","rasi","stuá","^mas","geir","ícia","rio$","gens","sses","ssa$","^abi","bit$","abit"],"ngram_size":4,"dimension":5000},{"language":"pt","weights":[0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.0147783,0.00985222,0.00985222,0.00492611,0.00985222,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.0147783,0.00492611,0.00492611,0.00492611,0.00492611,0.0147783,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00985222,0.00492611,0.00985222,0.0147783,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00985222,0.00492611,0.0147783,0.00492611,0.00492611,0.00492611,0.0147783,0.00492611,0.0147783,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.0147783,0.00492611,0.0147783,0.00985222,0.00492611,0.00985222,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.0197044,0.0147783,0.0295567,0.00492611,0.0147783,0.00985222,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.0147783,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611],"ids":[3026,4894,3348,1643,4383,2585,256,4995,1651,1589,2936,501,3187,1743,291,3836,700,16,4024,3977,3399,925,4234,114,4530,1599,4339,4017,1378,2854,4919,377,2537,1971,3356,2068,398,3049,3164,2384,3939,2766,2053,3195,2667,1491,2428,3242,4511,603,3634,2544,2759,3208,397,1294,4852,1936,4572,2734,4529,2626,564,3797,4692,4447,3302,1164,3228,1881,748,1193,1951,4079,2644,4741,1749,1659,1332,1181,3019,1618,503,3082,1590,3783,12,2830,1745,941,30,2886,3082,1680,1721,1594,456,677,1001,1439,4529,3631,1329,4814,874,1971,669,4619,4046,2660,2272,3745,4662,1964,18,3848,442,4541,2908,4964,1376,915,2617,1057,4045,4916,3018,2364,3104,3417,4144,4529,4959,2320,933,4608,4862,351,87,3430,4786,2841,2218,4965,2761,4362,1881,4921,4731],"ngrams":["oa$","^bo","luc","ens","arg","^su","nti","ant","^ga","tar","lut","^lu","cro","ão$","rão","boa","uta","^te","ter","ios","sár","esá","res","emp","ara","cia","tíc","ar$","not","^má","tir","mpr","rti","art","it$","^ce","reç","mas","uzi","^os","ent","ir$","red","bit","^re","em$","^a$","ssa","ras","má$","bra","abi","io$","ári","uár","pos","stu","^ma","ves","^e$","uas","^do","til","rad","xti","zir","edu","sua","êxt","^tê","ro$","do$","ado","rca","sa$","rge","eço","tuá","erc","otí","tos","est","^no","ra$","^ve","iro","gei","eir","^me","vê$","ros","nge","ucr","ang","sil","ran","duz","rio","str","^pr","cad","ns$","odu","^pa","rod","de$","pro","ses","sse","ess","da$","ços","^qu","^po","ue$","ia$","ada","íci","^es","mar","tra","gar","^br","^de","que","os$","ntr","par","as$","^en","cer","mer","^em","oss","es$","pre","evê","il$","gen","des","rev","asi","dut","têx","erã","^ab","uto","ca$","no$"],"ngram_size":3,"dimension":5000},{"language":"pt","weights":[0.00677966,0.00338983,0.00338983,0.020339,0.020339,0.0101695,0.0576271,0.0440678,0.0237288,0.0101695,0.0271186,0.0135593,0.00677966,0.0305085,0.0779661,0.0813559,0.0305085,0.0101695,0.0101695,0.0847458,0.0372881,0.00338983,0.00338983,0.155932,0.0644068,0.00677966,0.155932],"ids":[54,37,86,58,0,88,22,21,20,12,77,2,57,0,79,24,59,11,65,96,66,33,86,68,44,31,52],"ngrams":["í","ç","x","c","m","g","o","t","n","q","p","l","v","d","e","r","u","b","á","a","i","ã","z","$","s","ê","^"],"ngram_size":1,"dimension":100},{"language":"ro","weights":[0.00421941,0.00421941,0.00421941,0.00421941,0.00421941,0.00843882,0.00421941,0.00421941,0.00421941,0.00843882,0.00843882,0.00421941,0.00421941,0.00421941,0.00421941,0.00421941,0.00421941,0.00421941,0.0168776,0.00421941,0.00421941,0.00421941,0.00421941,0.00421941,0.00843882,0.00421941,0.00421941,0.00421941,0.00421941,0.00843882,0.0253165,0.00843882,0.00421941,0.0168776,0.0126582,0.00843882,0.00421941,0.0126582,0.00421941,0.021097,0.00421941,0.0126582,0.00421941,0.00843882,0.021097,0.00421941,0.00421941,0.00421941,0.00421941,0.00843882,0.00421941,0.00421941,0.00421941,0.00843882,0.0126582,0.0168776,0.0295359,0.00421941,0.0126582,0.0168776,0.00421941,0.0464135,0.00421941,0.00421941,0.00843882,0.00421941,0.00843882,0.00843882,0.00421941,0.00843882,0.0126582,0.0126582,0.00843882,0.00421941,0.00843882,0.0126582,0.00421941,0.0337553,0.00421941,0.0168776,0.0464135,0.00421941,0.00421941,0.00421941,0.00843882,0.0168776,0.00421941,0.00843882,0.00843882,0.00421941,0.00421941,0.00421941,0.00843882,0.00843882,0.00843882,0.00843882,0.00421941,0.00421941,0.00843882,0.00421941,0.00843882,0.00421941,0.00421941,0.00843882,0.00843882,0.021097,0.00843882,0.0168776,0.0168776,0.00421941,0.00421941,0.021097,0.00843882,0.00421941],"ids":[12,994,793,526,720,116,768,486,0,957,385,943,364,128,227,193,114,738,875,157,976,820,96,494,510,254,246,682,732,768,862,428,314,854,885,955,41,287,707,421,490,200,512,91,985,120,809,886,734,285,493,563,795,430,963,265,532,83,27,493,557,651,135,847,983,26,679,114,532,274,778,365,307,153,518,933,900,821,854,212,848,613,501,458,989,237,67,269,10,672,391,334,489,626,838,645,321,327,175,75,146,819,213,7,662,8,384,80,476,279,284,23,630,571],"ngrams":["să","oa","to","on","co","ar","ca","^b","oc","uc","de","ot","vi","po","iv","le","do","so","un","na","^o","ea","ni","lă","s$","av","ăţ","rv","su","aţ","^d","vs","l$","^n","^u","te","ma","it","d$","ur","um","st","ic","ve","ri","im","nd","eg","et","iu","lo","ân","ai","ă$","ci","re","^s","ul","si","in","cu","e$","cl","câ","ii","ct","au","cţ","o$","tă","ru","tr","nc","en","pe","ti","pl","ţi","ac","^p","i$","t$","ba","tu","a$","ne","nt","an","ie","da","ga","^r","es","eţ","^$","^i","ăt","r$","il","pr","or","li","ţu","sa","dv","^a","ns","nu","^c","iţ","nţ","u$","at","mp"],"ngram_size":2,"dimension":1000},{"language":"ro","weights":[0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.00628931,0.00628931],"ids":[1427,2104,4161,1437,4601,676,1784,1004,1315,531,1991,319,3643,4308,1059,1389,3569,4365,1817,2589,4660,3187,4497,1739,4337,3831,4054,3596,575,4660,827,260,2922,3027,4493,144,3034,1577,3962,2622,4285,3621,3341,354,2889,3359,31,469,1593,3827,4436,2326,3904,4300,846,3275,3677,3675,1470,3862,1365,239,2171,2404,2331,3600,3762,1808,3065,2074,132,2434,4911,2689,1915,1711,1721,2681,2645,2051,1540,3722,330,1390,1390,536,2045,1457,1680,1623,1688,1732,4415,3406,182,4529,2608,1729,153,1092,4805,3679,4497,2924,1423,3606,4931,1681,2216,806,3031,2313,865,3801,3445,3430,4352,2491,3770,4227,69,3409,248,413,3125,3502,3518,2124,1635,3913,534,2157,2996,2596,365,960,1774,56,222,2225,3471,312],"ngrams":["ucto","ruct","cons","ncar","anca","banc","etăţ","^con","ietă","ciet","ocie","iuni","truc","nstr","ctoa","inst","^ins","daţi","aţie","inaţ","tina","esti","dest","^de$","avea","pot$","lor$","^pot","tive","^neg","^uri","rită","orit","onst","dori","naţi","une$","ine$","^cân","ativ","vine","vea$","rvin","urvi","surv","iţi$","nega","^ul$","acţi","^sur","dvs$","^plă","ile$","^dvs","gati","eţin","site","^pe$","toar","^daţ","ând$","aţi$","stin","când","ive$","unci","tunc","numa","^atu","^ci$","ţii$","ţine","resi","atun","iune","^cli","ţuri","^reţ","eţi$","sii$","sau$","^sau","ucţi","impr","licu","uri$","^ban","stru","icur","ineţ","mai$","are$","rucţ","clic","uni$","entr","^acţ","pent","ilor","pres","curi","rile","plăt","oare","^ave","tiţi","^nu$","ătiţ","neţi","ţie$","esii","egat","^sit","^des","mpre","ite$","^num","nunţ","lăti","^să$","umai","soci","^soc","reţi","nci$","tru$","^imp","ăţii","tăţi","ită$","care","nţur","ntru","^dor","uril","anun","unţu","rilo","ţiun","cţiu","^pen","^anu"],"ngram_size":4,"dimension":5000},{"language":"ro","weights":[0.00507614,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.0101523,0.0101523,0.0101523,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.0101523,0.0101523,0.0101523,0.00507614,0.0101523,0.00507614,0.0101523,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.00507614,0.0101523,0.0101523,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.0101523,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.0101523,0.0101523,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.00507614,0.0152284,0.0101523,0.00507614,0.00507614,0.0152284,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.00507614,0.0101523,0.0101523,0.00507614,0.00507614,0.0203046,0.00507614,0.0101523,0.00507614,0.00507614,0.00507614,0.0101523,0.0101523,0.0101523,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614,0.00507614,0.0152284,0.00507614,0.00507614,0.00507614,0.0101523,0.00507614],"ids":[487,3749,806,2563,504,4729,4779,1468,41,3386,1569,3594,2301,1584,3413,2788,1227,4625,508,2354,1001,951,1876,1174,4743,2375,1618,1971,1057,3709,437,2596,2596,1964,1302,110,3194,1674,2196,3465,377,4589,147,4570,531,2626,2324,2479,3705,3278,665,780,4094,1270,4405,1486,4153,4882,3166,3113,67,3274,2488,3340,4627,4689,1785,1191,252,4190,4318,2182,4497,4663,3189,2799,1848,3263,442,461,4770,3754,2585,1147,1546,2408,859,4802,1281,4412,1305,3939,4741,1740,4608,3625,2707,3008,2143,4635,3088,257,2614,2860,1377,2189,407,2428,2640,4109,3963,3018,3430,3510,252,1988,1630,2184,1162,3396,907,26,3931,13,3341,3928,2024,4234,3178,3661,4884,3564,295,2610,2887,2581,2312,605,2690,308,3498,4598,2667,2564,3910,1357,122,1376,332,1412,4309,2080,1297,266,4635,3509,1948,4713],"ngrams":["să$","oar","cto","uct","re$","car","^ba","ţii","tăţ","etă","ons","iet","oci","soc","^so","cie","uni","ni$","ruc","are","str","ins","^in","^da","tin","sti","est","de$","^de","vea","^av","ot$","pot","^po","ina","ive","ega","neg","ţie","^ne","mpr","dor","^dv","^ur","ite","^do","ţiu","acţ","cţi","^co","^ac","ile","ne$","^să","vin","^pe","vs$","ul$","ea$","^ul","te$","tiţ","sit","une","mai","nd$","dvs","ând","nci","sur","daţ","unc","le$","tun","atu","ie$","^at","anc","ai$","naţ","uma","ave","^su","con","^ci","lor","rvi","ban","reţ","ii$","ati","ent","sii","esi","pre","pen","neţ","imp","ucţ","ţur","num","aţi","sau","cân","ve$","cur","icu","^a$","^im","^cl","nun","ntr","des","cli","rit","ţin","ori","ţi$","^sa","iţi","ăti","tru","^an","ăţi","lăt","nst","plă","res","iun","eţi","^pl","lic","uri","ilo","ri$","^o$","urv","anu","nu$","ine","^si","^câ","^re","tiv","ril","tă$","or$","nţu","pe$","ci$","ită","nca","^nu","gat","ru$","toa","au$","unţ"],"ngram_size":3,"dimension":5000},{"language":"ro","weights":[0.00361011,0.00722022,0.0469314,0.0397112,0.0469314,0.0180505,0.0180505,0.0252708,0.144404,0.0180505,0.0505415,0.00361011,0.064982,0.032491,0.0613718,0.108303,0.0541516,0.0252708,0.00361011,0.0685921,0.0144404,0.144404],"ids":[88,0,44,58,21,57,77,22,52,2,24,11,59,75,20,66,96,0,75,79,97,68],"ngrams":["g","m","s","c","t","v","p","o","^","l","r","b","u","ţ","n","i","a","d","â","e","ă","$"],"ngram_size":1,"dimension":100},{"language":"ru","weights":[0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0416667,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0416667,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0208333,0.0416667,0.0208333,0.0416667,0.0208333,0.0416667,0.0208333,0.0208333,0.0416667],"ids":[856,789,207,694,795,67,78,828,965,422,613,954,808,499,663,849,816,868,505,29,145,802,996,782,662,531,711,278,25,267,454,929,961,580,149,565,117,728,817,274,960,838],"ngrams":["за","^д","дн","то","ка","ик","н$","фи","де","ид","на","^и","нт","^а","ор","иф","фо","й$","ый","ьн","аз","ви","ен","ма","ра","ти","^ф","рм","пр","ав","ил","не","еп","ад","ат","ль","^н","ны","а$","т$","д$","^$"],"ngram_size":2,"dimension":1000},{"language":"ru","weights":[0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118,0.0294118],"ids":[2363,340,1697,2084,2538,1130,3901,459,4621,641,3529,57,24,1443,572,1949,2162,2323,3841,2726,3904,2442,653,1779,1152,4316,1494,1545,4242,3486,4887,639,4292,1557],"ngrams":["зад$","азад","наза","^дн$","ора$","тора","атор","като","фика","ифик","^наз","енти","дент","^иде","мат$","рави","нтиф","рмат","форм","орма","^фор","икат","виль","ильн","ьный","иден","епра","льны","непр","тифи","авил","ный$","^неп","прав"],"ngram_size":4,"dimension":5000},{"language":"ru","weights":[0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025,0.025],"ids":[4932,3506,1792,542,3043,2840,2377,1827,3270,3365,4798,3079,2446,2005,457,2706,2208,3820,3234,1814,3024,383,2349,4385,4510,56,2559,1650,1284,627,2404,250,2262,4020,3999,3456,591,145,745,3618],"ngrams":["ад$","наз","зад","ато","дн$","кат","аза","фик","нти","ден","ент","тиф","иде","ный","^ид","ат$","фор","мат","ра$","ый$","^на","пра","^фо","ифи","ьны","льн","иль","епр","^дн","ора","ави","вил","орм","рав","тор","^не","неп","рма","ика","^а$"],"ngram_size":3,"dimension":5000},{"language":"ru","weights":[0.0178571,0.0535714,0.0535714,0.0178571,0.0357143,0.0178571,0.0178571,0.0178571,0.0178571,0.0357143,0.0178571,0.0714286,0.0535714,0.0178571,0.0892857,0.0178571,0.0357143,0.125,0.142857,0.142857],"ids":[39,10,20,85,53,67,50,10,44,15,36,98,82,41,81,54,30,63,68,52],"ngrams":["к","д","т","м","ф","ы","з","в","л","о","й","и","р","п","н","ь","е","а","$","^"],"ngram_size":1,"dimension":100},{"language":"si","weights":[0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0638298,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0212766,0.0425532,0.0106383,0.0212766,0.0106383,0.0319149,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0106383,0.0212766,0.0106383,0.0106383,0.0106383],"ids":[866,559,590,737,819,165,672,436,684,132,804,918,19,765,741,802,70,780,316,838,260,97,292,855,88,91,26,929,427,858,49,826,328,739,939,883,24,224,193,289,551,66,860,221,834,625,60,465,966,420,602,986,943,945,366,536,836,545,812,484,401,154,198,655,847,291,663,424,488,722,637,834,154,734],"ngrams":["ද$","්ද","�න","රන","ප$","^ප","ු$","ටන","ෙල","ෂෙ","^ෂ","්ට","කි","^ක","ණ�","^්","බු","ව�","එව","^$","ෙන","සක","ලි","ෑල","පෑ","ුල","^ත","ි$","�ප","හි","ිය","යක","න�","පි","්$","ිප","ට$","^ට","ක්","^ස","ලෙ","ින","ස්","නම","ුර","^න","ර�","න්","ල්","කු","ත�","�$","^ද","^එ","ල$","ටි","ිහ","ති","^ම","ුක","ිඳ","�ධ","මි","^ල","රස","ධ$","අන","නු","දු","ිබ","^ර","ඳු","ුණ","^අ"],"ngram_size":2,"dimension":1000},{"language":"si","weights":[0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414,0.0172414],"ids":[3832,2077,1710,4944,379,766,2748,3734,1600,2437,4832,3683,2757,2832,1698,4137,1678,241,2731,2243,2503,3757,2944,587,148,3460,1387,1116,815,1171,605,2045,693,905,3354,3318,1234,778,2222,369,3568,1894,1270,4122,2159,3784,1792,961,212,578,3462,3903,3494,358,1792,4695,2662,4222],"ngrams":["න්දු","�න්ද","රන�න","^රන�","ටන්$","්ටන්","ල්ටන","ෙල්ට","ෂෙල්","ස්ටි","ියක්","ිහිඳ","^ලිප","^රස්","ුර�ධ","රස්ට","^කි$","බුණ�","කුර�","�පෑල","ිබුණ","්දු$","තිබු","ෙන්$","කුල$","ලෙන්","මිහි","^ෂෙල","ෑලෙන","^ත�ප","^තිබ","ත�පෑ","පියක","ිපිය","ුණ�$","ලිපි","පෑලෙ","ුර�$","්ටි$","ින්$","මින්","නමින","^නමි","යක්$","ුකුල","සකුර","ඳුකු","ිඳුක","න�න්","ර�ධ$","හිඳු","එව�$","^සකු","අනුර","^මිහ","^එව�","නුර�","^අනු"],"ngram_size":4,"dimension":5000},{"language":"si","weights":[0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0266667,0.0133333,0.0133333,0.0133333,0.0133333,0.0266667,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.04,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333,0.0133333],"ids":[3793,2296,4496,4423,2694,1963,3874,4256,2773,2732,4590,1048,4839,1688,120,2969,4982,1929,1997,2443,3194,2481,4896,3741,3559,1344,4349,904,1,3017,1868,4582,1601,416,3616,2402,2095,350,1258,560,1816,3273,1795,1798,3775,2112,2656,1791,329,2950,965,644,1073,3545,4052,2925,3245,100,1190,1487,314,4707,2673,177,158,2668,3692,3186,1278,333,4560],"ngrams":["^ද$","දු$","්දු","න්ද","�න්","න�න","^ප$","ල්ට","ෙල්","්ටි","රස්","^්$","රන�","^කි","�ධ$","එව�","ුර�","ෙන්","තිබ","^ති","ස්ට","�පෑ","^ලි","යක්","ුල$","ිබු","කි$","ක්$","පිය","^ට$","ර�$","ෂෙල","අනු","පෑල","ඳුක","සකු","්ටන","ව�$","කුර","^ත�","ලිප","^සක","ටන්","න්$","ින්","මින","^නම","ටි$","ත�ප","කුල","ිහි","නමි","^රස","ණ�$","^එව","මිහ","^මි","^අන","ුණ�","ර�ධ","^රන","බුණ","ලෙන","හිඳ","ිපි","නුර","^ෂෙ","ියක","ුකු","ෑලෙ","ිඳු"],"ngram_size":3,"dimension":5000},{"language":"si","weights":[0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.0265487,0.0176991,0.0176991,0.0265487,0.079646,0.0353982,0.00884956,0.0530973,0.00884956,0.0176991,0.0707965,0.00884956,0.00884956,0.0442478,0.0353982,0.0619469,0.00884956,0.168142,0.0353982,0.168142],"ids":[88,25,91,1,29,25,34,81,87,65,43,70,3,88,79,32,14,39,78,50,18,26,65,18,19,32,68,5,52],"ngrams":["ද","ෂ","ණ","ව","එ","ෑ","�","ත","අ","ප","ෙ","ස","ට","්","ල","හ","ු","ඳ","ම","ි","ධ","බ","�","ර","න","ය","$","ක","^"],"ngram_size":1,"dimension":100},{"language":"sk","weights":[0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.00865801,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.00865801,0.004329,0.004329,0.004329,0.012987,0.004329,0.004329,0.00865801,0.004329,0.004329,0.00865801,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.00865801,0.004329,0.00865801,0.012987,0.004329,0.004329,0.012987,0.00865801,0.004329,0.00865801,0.012987,0.00865801,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.004329,0.047619,0.004329,0.004329,0.004329,0.004329,0.004329,0.012987,0.00865801,0.012987,0.004329,0.004329,0.004329,0.034632,0.004329,0.004329,0.004329,0.004329,0.00865801,0.00865801,0.00865801,0.012987,0.004329,0.004329,0.004329,0.00865801,0.00865801,0.021645,0.004329,0.012987,0.017316,0.00865801,0.00865801,0.004329,0.004329,0.004329,0.004329,0.004329,0.00865801,0.025974,0.00865801,0.017316,0.004329,0.017316,0.004329,0.004329,0.004329,0.004329,0.004329,0.021645,0.00865801,0.004329,0.004329,0.004329,0.004329,0.004329,0.00865801,0.004329,0.00865801,0.00865801,0.00865801,0.004329,0.004329,0.012987,0.004329,0.004329,0.00865801,0.004329,0.004329,0.004329,0.012987,0.004329,0.012987,0.004329,0.012987,0.004329,0.004329,0.021645,0.004329],"ids":[688,132,662,556,631,254,215,18,918,841,392,237,909,975,98,819,958,442,353,540,403,730,355,671,333,848,23,41,834,71,635,656,879,496,771,128,980,83,115,825,819,732,532,594,68,493,332,618,854,885,829,835,96,254,786,985,861,683,503,895,887,651,575,334,300,984,291,108,91,200,707,841,287,955,780,213,27,631,265,532,648,75,893,766,353,104,843,895,28,212,147,153,83,854,875,707,10,949,80,8,734,960,721,571,760,978,269,709,227,61,489,921,126,105,963,657,378,461,265,477,157,738,429,915,476,666,838,144,933,91,776,747,888,780,778,757,685,989,826],"ngrams":["ľn","oľ","ub","^ľ","že","mô","ta","as","ži","id","�i","ne","tl","kn","ik","li","í$","tí","žš","os","no","žn","^m","^z","dn","i$","u$","úp","^ú","^v","uj","bo","ra","kr","ôž","po","^t","ón","bl","ať","ša","^š","o$","ju","^j","lo","ob","žt","^n","^u","ši","iť","ni","av","is","ri","dl","�u","us","št","v$","e$","^e","^r","m$","rt","yb","ak","ve","st","d$","eš","it","te","pu","pô","si","ím","re","^s","ov","pr","mo","ab","er","sp","vo","am","kt","^p","ka","en","ul","ľu","k$","ce","ie","hc","nu","^a","et","pa","ôs","mp","ok","bi","an","nú","iv","^k","ed","ní","iž","mn","jt","ch","la","ló","kl","a�","na","so","ia","ť$","^c","ú$","^$","be","ti","vy","ň$","z$","ož","va","aň","ek","je","a$","ko"],"ngram_size":2,"dimension":1000},{"language":"sk","weights":[0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.0251572,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.0251572,0.0251572,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0188679],"ids":[2949,2056,3481,3425,2163,4804,2378,2256,2025,3981,4439,500,566,3702,4187,3102,1828,905,936,4399,1084,2038,3059,2281,3308,3524,1334,4195,301,2903,2979,3116,2369,2840,2419,1357,209,1246,2578,2925,3890,104,4136,2152,1915,2633,4492,3755,2288,1672,804,3303,4793,1070,4873,2790,2649,2501,3124,3103,1410,4714,1260,2332,664,1852,4783,2045,1309,3419,503,880,707,835,3389,1492,1054,1270,1579,1869,4621,2572,390,2610,4249,2073,2492,4129,2540,439,4614,3829,3430,3671,4695,1402,2054,812,453,3583,439,4978,3710,810,2069,4682,1203,654,3857,2221,651,2894,4212,1847,4763,3088,4223,3362,766,1779,2217,4414,3357,4672,4681,4726,4167,4137,1041,171,2326,2883,1185,2517,2757,1510,2792,4726,904,1587,3203,2828,183],"ngrams":["oľne","voľn","bovo","ubov","ovoľ","ôžet","^môž","ane$","mpan","nia$","enia","veni","aven","tave","stav","asta","nast","^nas","dlo$","môže","idlo","nite","ikni","klik","^kli","loži","ižši","pane","^niž","žnos","stí$","�idl","možn","ednu","a�id","ako$","^jed","vybe","erte","žiť$","bert","pôso","jte$","nost","�ujt","ením","okra","rte$","žete","^pok","jedn","ožiť","klam","pris","ujte","vova","ónu$","úpra","^ľub","kra�","lónu","amnú","šabl","^ju$","prav","la�i","obiť","pokr","ulož","^ulo","kamp","^úpr","biť$","sobi","šie$","^šab","ôsob","risp","lamn","likn","šte$","žšie","a�uj","^vyb","^na$","ožte","ním$","knit","tení","uste","abló","ave$","ite$","chce","sten","^akt","žte$","pred","rekl","^ako","ovať","akti","^rek","ostí","spus","ľubo","tla�","^pre","ete$","cete","^si$","^chc","ľne$","^ešt","ivov","mnú$","blón","^tla","ložt","ekla","tivo","paň$","rave","ampa","^kam","dnu$","spôs","^spu","red$","ešte","yber","vať$","pust","ispô","ožno","^ak$","^pri","^mož","hcet","ra�u","ktiv","nižš","mpaň"],"ngram_size":4,"dimension":5000},{"language":"sk","weights":[0.00515464,0.00515464,0.00515464,0.00515464,0.0103093,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.0103093,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.0103093,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.0206186,0.00515464,0.00515464,0.00515464,0.00515464,0.0103093,0.00515464,0.0103093,0.0103093,0.00515464,0.0103093,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.0206186,0.0103093,0.0206186,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.0103093,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.0360825,0.0103093,0.00515464,0.00515464,0.00515464,0.00515464,0.0154639,0.00515464,0.00515464,0.00515464,0.0154639,0.00515464,0.00515464,0.0206186,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.0154639,0.00515464,0.0154639,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464,0.00515464],"ids":[4805,4327,3639,201,4094,3643,582,4923,1541,2868,2081,14,3008,3870,3218,531,273,1497,3378,2799,4436,2204,3145,1923,405,3247,4905,2322,20,3523,4330,409,74,3311,4151,3584,3498,3848,2976,61,1377,805,4376,855,367,2019,2803,671,1221,2690,821,4899,3700,3854,691,3754,4681,3722,2911,3699,1082,4009,4775,758,1941,3848,1753,1849,1772,3197,926,295,3936,4844,4249,3113,2796,2466,301,3433,4673,817,2493,2508,681,2724,4201,4373,1803,1964,4041,4795,3160,275,2519,3942,2229,3915,4872,3719,4608,4853,2724,3014,681,1439,1812,3221,1501,2689,998,4769,3109,67,4963,3507,3299,4866,757,2428,1889,2907,2558,4051,1136,273,3299,4056,2226,2807,2053,3140,1529,3219,165,875,1626,1618,597,3358,2413,1344,3796,1167,3896,180,4389,2667,4057,4085,2564,4258,839,3789,4953,2563,4996,1987],"ngrams":["voľ","ovo","ubo","môž","ne$","eni","sta","ast","ôže","nas","oži","lo$","�id","a�i","^tl","ite","lik","žet","kli","ie$","žši","pan","ižš","niž","^ni","tí$","stí","ľne","mož","^z$","dnu","ožn","edn","la�","jed","^je","^si","ia$","chc","ber","ve$","ost","rav","úpr","^mo","ris","�uj","^kl","pok","nu$","nia","tav","šie","lón","bló","ave","vať","^ša","ko$","ikn","ako","ova","pra","šte","^ju","ven","žte","^ka","jte","ožt","rte","^vy","lož","ešt","ulo","^ul","ert","iť$","ybe","ľub","na$","pôs","biť","obi","sob","ôso","^úp","lam","spô","^po","^eš","ním","pus","si$","bov","hce","kam","^na","amp","ten","pre","ust","ónu","ujt","ekl","^pr","ím$","spu","abl","tla","nos","a�u","^sp","te$","ete","idl","ra�","kni","šab","^a$","ste","dlo","^v$","paň","^ch","isp","mpa","nú$","^ľu","mnú","red","žiť","okr","aň$","vyb","^ak","ať$","ak$","ane","amn","akt","kla","ivo","rek","nit","kti","ení","^re","vov","cet","tiv","ju$","oľn","^mô","kra","ed$","žno","pri"],"ngram_size":3,"dimension":5000},{"language":"sk","weights":[0.00746269,0.00373134,0.011194,0.0186567,0.0149254,0.00746269,0.00746269,0.0261194,0.00746269,0.011194,0.0298507,0.00373134,0.0447761,0.0447761,0.00746269,0.0298507,0.011194,0.0746269,0.0223881,0.0410448,0.011194,0.00373134,0.0410448,0.0373134,0.0261194,0.0261194,0.13806,0.0410448,0.00373134,0.13806,0.011194,0.00746269,0.0895522],"ids":[87,11,5,78,11,74,97,44,58,44,59,65,21,20,96,0,0,79,24,66,40,63,22,77,57,2,52,19,86,68,3,54,96],"ngrams":["�","ó","j","ž","b","ô","ľ","s","c","ň","u","y","t","n","ú","m","d","e","r","i","ť","h","o","p","v","l","^","k","z","$","š","í","a"],"ngram_size":1,"dimension":100},{"language":"sl","weights":[0.00398406,0.00796813,0.00398406,0.00398406,0.0318725,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.00398406,0.00796813,0.0119522,0.00398406,0.00398406,0.00398406,0.0119522,0.00398406,0.00398406,0.0119522,0.00398406,0.00796813,0.00398406,0.00398406,0.0159363,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813,0.0159363,0.00398406,0.00398406,0.00398406,0.0159363,0.00398406,0.0199203,0.0119522,0.0119522,0.00398406,0.0199203,0.00398406,0.0119522,0.0119522,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.00398406,0.0159363,0.0159363,0.00796813,0.00398406,0.00398406,0.0159363,0.00398406,0.0159363,0.00398406,0.00398406,0.00398406,0.00796813,0.0119522,0.00398406,0.00796813,0.0119522,0.0239044,0.0239044,0.00398406,0.0119522,0.0159363,0.0119522,0.0239044,0.059761,0.00398406,0.00398406,0.0199203,0.00796813,0.00398406,0.00796813,0.00796813,0.00796813,0.00398406,0.0119522,0.0159363,0.00398406,0.0119522,0.00398406,0.0159363,0.0239044,0.00796813,0.0278884,0.0119522,0.0159363,0.0239044,0.00398406,0.00796813,0.00398406,0.0199203,0.00398406,0.00398406,0.00398406,0.00398406,0.00796813],"ids":[877,337,734,104,349,819,745,854,46,885,564,943,91,534,512,108,591,365,738,875,157,900,244,23,514,996,793,489,41,300,334,672,36,416,378,707,747,780,622,848,254,96,782,193,110,75,648,826,980,186,809,215,887,763,532,403,314,886,75,760,553,978,61,486,68,248,475,477,925,685,989,8,200,71,937,676,651,887,18,269,175,862,985,120,791,548,629,8,364,128,80,384,212,829,153,879,989,671,353,265,892,532,895,154,637,683,838],"ngrams":["ez","tn","et","sp","se","li","ug","^n","al","^u","ki","ot","ve","oo","ic","ak","ro","tr","so","un","na","pl","vn","u$","du","ds","to","ed","ma","m$","^r","da","še","aš","la","ce","z$","va","lj","i$","av","ni","dr","le","zd","pr","ov","ko","^t","rz","mr","ta","oz","ad","o$","no","l$","eg","nj","ok","go","bi","^k","^b","^j","n$","zn","a�","^g","je","a$","sn","st","^v","og","za","e$","v$","as","an","il","^d","ri","im","ij","hv","ja","^a","vi","po","nu","ns","^p","ši","en","ra","gl","^z","^h","re","vl","^s","am","�a","ut","�u","^$"],"ngram_size":2,"dimension":1000},{"language":"sl","weights":[0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.017341,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.017341,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.017341,0.0115607,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.017341,0.00578035,0.0231214,0.0115607,0.00578035,0.0231214,0.0231214,0.00578035,0.00578035,0.0231214,0.00578035,0.00578035,0.0231214,0.00578035,0.0115607,0.00578035,0.0115607,0.017341,0.00578035,0.017341,0.00578035,0.00578035,0.00578035,0.00578035,0.0231214,0.00578035,0.00578035,0.00578035,0.00578035],"ids":[4796,2620,4268,1031,3579,3034,2122,2266,1607,3496,3042,1386,3546,2158,3819,3029,144,1587,3504,4214,365,2700,1093,1796,2134,2528,625,972,4916,2190,755,3705,3718,3554,3945,3894,860,4545,4069,4231,3178,3959,1968,4987,3424,262,2620,1961,1169,4835,4112,1673,4827,486,400,4303,3045,1396,3420,1091,3619,2289,1343,3342,1667,3181,480,4320,2011,4060,3845,4851,3790,3451,2262,2545,1463,868,906,203,1234,1761,1678,294,2002,1984,1083,3476,532,2637,3279,2358,4554,2426,4310,1130,1832,2435,4200,2055,1784,3829,3234,237,325,3403,865,3775,686,1283,2784,2125,3753,998,1367,3281,1607,1359,2764,2792,179,835,2552,3667,24,1816,2983,1581,645,654,4085,4684],"ngrams":["ana$","ezan","tno$","utno","nutn","tren","^ki$","tran","stra","tna$","plet","^da$","vili","ovil","goto","ugot","^ugo","ra�u","njak","vnja","ovnj","kovn","roko","^vaš","^str","naši","^naš","nice","avni","ledu","^ra�","gled","aki$","egle","aši$","ovez","^po$","^za�","nima","stan","^zan","aše$","vlje","vaše","manj","sple","ala$","vala","^bil","ljen","^hva","^so$","eni$","letn","jeni","edu$","avlj","enut","ravl","hval","etna","zdra","šim$","ozdr","vaši","jaki","jen$","njen","^za$","drav","goog","^pov","mrzn","^zam","anim","anje","^tre","sno$","�asn","a�un","ašim","a�as","veza","zani","bil$","^sta","tovi","stro","iman","^je$","zana","rznj","regl","�un$","preg","^spl","oogl","ijav","prij","amrz","^poz","ave$","otov","ogle","ran$","adse","rija","javn","^ads","sens","zamr","pove","nse$","znje","ice$","ense","ili$","nje$","okov","^pri","gle$","trok","^goo","za�a","tanj","jave","asno","dsen","vnic","^pre","renu","pozd"],"ngram_size":4,"dimension":5000},{"language":"sl","weights":[0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00947867,0.014218,0.00947867,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.014218,0.00947867,0.0189573,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.0189573,0.00473934,0.00473934,0.0189573,0.00947867,0.00473934,0.00947867,0.014218,0.00473934,0.00473934,0.0236967,0.00473934,0.014218,0.00473934,0.014218,0.00473934,0.0189573,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.014218,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.0189573,0.00947867,0.0189573,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00473934,0.00947867,0.00473934,0.00473934,0.0189573,0.00473934,0.00947867,0.00473934,0.014218,0.00473934,0.00473934,0.014218,0.00473934,0.00473934,0.00473934,0.014218,0.00947867,0.014218,0.0189573,0.00473934,0.014218,0.00473934,0.00473934,0.00473934,0.0189573,0.00473934,0.00473934,0.00473934],"ids":[3523,2861,2135,2058,3402,755,3239,658,2272,1174,1633,3976,3021,3552,2484,4625,2342,2073,156,2854,901,4108,2866,16,4171,2155,3584,1001,2672,1280,1913,1188,3225,4608,2028,2558,3762,4611,3721,4112,2522,4002,4484,4625,249,1376,63,3302,3104,706,2522,503,360,3221,1707,4766,2034,3142,831,3683,1217,1214,141,1776,351,4376,3951,420,4636,3641,3915,777,3830,2918,3643,4434,2633,4649,4511,4088,3299,159,4673,1237,4731,1881,4722,4862,1715,3735,1010,1350,1818,782,2741,1594,3109,4769,187,3210,4497,1819,851,3106,2446,3990,2850,3836,4259,1377,2368,4215,2285,207,1279,4155,1392,374,2329,3754,1789,3413,1946,217,582,1964,4112,4103,1190,1989,1987,6,906,3931,1439,2270,574,2239,1643,2890,3107,902],"ngrams":["^z$","ana","eza","tno","utn","^tr","an$","let","da$","^da","ili","tna","vil","^ki","ovi","tov","oto","^ug","ki$","aki","enu","jak","vnj","etn","oko","ovn","^je","str","^go","zan","aši","ce$","naš","pre","im$","^v$","so$","reg","^ra","po$","li$","ima","nut","ni$","du$","tra","še$","edu","egl","ani","ple","en$","un$","vaš","aše","dse","la$","nja","led","rij","rzn","^hv","ala","avl","il$","rav","val","lje","vlj","nim","^na","dra","poz","ren","eni","rok","jen","ugo","je$","mrz","ra�","gle","na$","zam","no$","oog","amr","asn","^za","sno","ogl","vni","goo","ice","ads","ran","^sp","a�u","znj","kov","le$","spl","�as","tro","hva","jav","sen","za$","se$","ve$","ši$","nic","vez","ove","zdr","anj","�un","man","^ad","ave","ija","^so","nje","avn","sta","^po","pov","^bi","a�a","^st","pri","^va","nse","tre","^pr","za�","šim","bil","ens","tan","got","ozd"],"ngram_size":3,"dimension":5000},{"language":"sl","weights":[0.0103093,0.00343643,0.00343643,0.0549828,0.0103093,0.0274914,0.0412371,0.0309278,0.0309278,0.0378007,0.024055,0.00343643,0.0137457,0.024055,0.0687285,0.024055,0.0893471,0.0137457,0.137457,0.0309278,0.04811,0.0309278,0.0962199,0.00687285,0.137457],"ids":[19,58,63,22,0,88,66,24,2,57,77,11,59,21,20,0,79,3,68,86,44,5,96,87,52],"ngrams":["k","c","h","o","m","g","i","r","l","v","p","b","u","t","n","d","e","š","$","z","s","j","a","�","^"],"ngram_size":1,"dimension":100},{"language":"so","weights":[0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00411523,0.0123457,0.00823045,0.00823045,0.00411523,0.00411523,0.00411523,0.00411523,0.0164609,0.00823045,0.00823045,0.0123457,0.00411523,0.0329218,0.0205761,0.00823045,0.00411523,0.0123457,0.00823045,0.00823045,0.0123457,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.0123457,0.00411523,0.00411523,0.0164609,0.0246914,0.0164609,0.0123457,0.0123457,0.00823045,0.00823045,0.0123457,0.0246914,0.00823045,0.00411523,0.00823045,0.00823045,0.00823045,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.0329218,0.0164609,0.00411523,0.00411523,0.0123457,0.00823045,0.0123457,0.00411523,0.0164609,0.0164609,0.0164609,0.0123457,0.0493827,0.00411523,0.00411523,0.0164609,0.00411523,0.00823045,0.00411523,0.0246914,0.0123457,0.00411523,0.0740741,0.0123457,0.00823045,0.0205761,0.0123457,0.0205761,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.00823045,0.0288066],"ids":[879,123,116,463,977,862,372,645,984,545,68,985,688,255,717,875,191,125,564,108,535,147,532,768,750,752,531,144,848,795,39,891,183,998,487,83,27,493,46,190,481,738,476,123,879,248,895,146,34,885,838,656,707,501,350,983,355,61,819,391,925,605,763,486,826,378,269,215,89,822,841,290,41,553,67,961,532,939,332,989,630,489,8,976,23,984,745,403,937,7,672,793,534],"ngrams":["ib","dh","ar","ih","yi","^d","kh","^i","rt","ir","^j","ri","wa","ax","^w","un","ku","ji","ki","ak","^l","ka","o$","ca","xa","ha","ee","be","i$","ah","ey","^q","he","ay","om","ul","si","in","al","ya","hi","so","^c","^y","ra","n$","am","or","gu","^u","^$","bo","d$","ba","dk","ii","^m","^k","li","ga","^g","y$","ad","^b","ko","la","an","ta","iy","aa","id","nk","ma","qo","nt","gg","^s","sh","ob","a$","at","es","^a","^o","u$","bk","ug","mk","og","sa","da","to","oo"],"ngram_size":2,"dimension":1000},{"language":"so","weights":[0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0188679,0.0125786,0.00628931,0.00628931,0.0188679,0.0188679,0.0188679,0.0188679,0.0188679,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.0125786,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.0188679,0.0125786,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.00628931,0.0188679],"ids":[440,2752,2005,3069,3229,4011,186,4910,3151,3811,2982,3202,3089,1290,4421,4375,3909,2952,1038,4180,1138,758,1375,4550,1411,3616,3718,650,3236,805,4766,3158,40,1405,1114,3413,1240,4777,4451,1480,2312,2190,1007,967,1395,641,1113,1450,2496,104,1596,1423,1677,1016,4330,2829,384,3709,2452,821,68,2552,1261,4872,4763,4465,3585,248,3193,880,3636,3834,1287,651,4011,3248,4500,36,4340,3645,3525,3236,1360,2864,1169,1,8,227,3333,3596,2838,836,3457,3676,2373,1158,4116,1107,325,879,4109,1465,775,3969,3091,1259,1617,3516,3393,3790,770,1738,2712,2320,272,2504,2938,1524,4282,3564,688,4416,3388,1778],"ngrams":["rto$","bka$","ibka","kara","^kar","aari","^ka$","^yih","lida","alid","ari$","dka$","dadk","^aak","nka$","aank","irat","ara$","gunt","unta","khir","^in$","jiri","yihi","^dad","^jir","aki$","hiin","akhi","irto","ida$","aant","nta$","haki","shak","saar","ihii","waxa","bogg","^wax","ataa","ahey","iya$","esha","taan","^kat","liya","aali","maal","ooma","^soo","ntat","rata","adka","ato$","^gun","dhib","^bee","^ula","anka","amku","bees","ata$","akii","kata","ugu$","kiin","koob","aaki","amka","tato","alam","oran","^si$","aala","^ay$","^qor","aakh","^saa","^yah","axa$","ogga","mku$","caal","^caa","jirt","^laa","obaa","yahe","sha$","mka$","kali","lamk","gga$","hey$","^ku$","^ugu","^dhi","ran$","aad$","omaa","ula$","laak","^oo$","eesh","baad","iin$","^sha","ooba","rin$","^aan","maan","^maa","^koo","^bog","aan$","hira","hibk","qora","soom","^kal","anta","irin","aliy"],"ngram_size":4,"dimension":5000},{"language":"so","weights":[0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.015,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.015,0.015,0.015,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.015,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.02,0.005,0.005,0.025,0.005,0.01,0.015,0.01,0.005,0.005,0.015,0.005,0.005,0.005,0.01,0.01,0.01,0.01,0.005,0.005,0.01,0.01,0.01,0.01,0.02,0.005,0.005,0.005,0.005,0.015,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.01,0.005,0.015,0.02,0.005,0.005,0.01,0.005,0.005,0.015,0.005,0.005,0.01,0.01,0.005,0.005,0.01,0.025,0.01,0.005,0.005,0.005,0.005,0.005,0.02,0.005,0.015,0.005,0.015,0.02,0.005],"ids":[2410,383,1751,2222,4530,3082,4016,2887,1850,77,1162,4506,4434,964,217,2272,833,135,3378,1856,2254,1637,1103,720,4724,4846,1876,156,2468,4623,2105,4896,4683,1257,275,1678,3247,4450,177,3613,4301,2034,2073,4942,723,3113,1936,2924,3313,3851,4497,3538,1849,4894,275,761,3498,3933,4997,2854,1389,2759,2812,2387,4995,1105,2260,3953,4572,1838,4290,3641,2959,744,4023,4449,1580,4708,1650,4324,1332,1159,3989,1424,416,3153,3406,2892,132,3926,4140,3239,3060,193,1174,539,2176,2527,1808,1353,814,3413,2274,3089,4866,4373,3287,4207,2828,4301,2704,4696,141,2258,1086,4348,2030,2644,1594,2428,2278,660,2738,4258,4147,4202,621,599,3902,642],"ngrams":["rto","irt","^dh","bka","ara","ra$","kar","ri$","aar","saa","^sa","hii","ihi","ay$","kal","da$","ida","dka","dad","taa","rat","ira","hir","ank","aan","akh","^in","ki$","^sh","khi","^aa","kii","wax","oma","oom","soo","tat","ibk","jir","gun","axa","la$","^ug","ya$","ari","^ul","^ma","ula","nka","ato","mku","ata","^ka","^bo","si$","aal","^si","iin","iya","aki","laa","yih","liy","^la","ant","mka","^be","amk","aak","caa","ad$","bog","esh","ees","bee","^ca","ali","ahe","ey$","hak","ugu","^oo","oob","^qo","dhi","rin","^ay","ora","xa$","qor","hey","an$","gga","gu$","^da","^ko","nta","adk","oba","to$","yah","^so","maa","baa","^gu","lam","unt","ga$","^ku","^ya","koo","ta$","ala","^wa","ogg","ha$","ka$","^ji","ran","^a$","lid","iri","^yi","in$","aad","sha","hib","oo$","ku$","kat"],"ngram_size":3,"dimension":5000},{"language":"so","weights":[0.00699301,0.0034965,0.0034965,0.0629371,0.00699301,0.027972,0.020979,0.020979,0.027972,0.0314685,0.0034965,0.027972,0.0174825,0.027972,0.0559441,0.15035,0.013986,0.020979,0.0174825,0.0174825,0.0244755,0.0629371,0.195804,0.15035],"ids":[5,86,32,66,58,44,24,21,65,20,12,59,11,2,19,52,88,0,79,0,63,22,96,68],"ngrams":["j","x","w","i","c","s","r","t","y","n","q","u","b","l","k","^","g","m","e","d","h","o","a","$"],"ngram_size":1,"dimension":100},{"language":"sq","weights":[0.00429185,0.00429185,0.00429185,0.00429185,0.00429185,0.00429185,0.00429185,0.00858369,0.0600858,0.00429185,0.00429185,0.00429185,0.00429185,0.0171674,0.00429185,0.00429185,0.0171674,0.00858369,0.0171674,0.00858369,0.0128755,0.00858369,0.00858369,0.0300429,0.0214592,0.00429185,0.00429185,0.00858369,0.00858369,0.0128755,0.0171674,0.0171674,0.00429185,0.00429185,0.00858369,0.00429185,0.00429185,0.00429185,0.0214592,0.00429185,0.00429185,0.00858369,0.00429185,0.0171674,0.0128755,0.00429185,0.00858369,0.00858369,0.00429185,0.00858369,0.00858369,0.00429185,0.00858369,0.00858369,0.00429185,0.0128755,0.00429185,0.00858369,0.0128755,0.00858369,0.0171674,0.0128755,0.00429185,0.00858369,0.00858369,0.00858369,0.00858369,0.00858369,0.00429185,0.00429185,0.0214592,0.00858369,0.00429185,0.0128755,0.00429185,0.0128755,0.00858369,0.00858369,0.00429185,0.0257511,0.00429185,0.0300429,0.0128755,0.0128755,0.00858369,0.0171674,0.00858369,0.00858369,0.00429185,0.00858369,0.00858369,0.00858369,0.0128755,0.00429185,0.00429185,0.0128755,0.0343348,0.00858369,0.0257511],"ids":[269,489,734,421,955,175,309,734,926,778,492,7,697,75,978,470,212,804,29,215,780,690,630,651,575,511,472,738,157,734,532,939,147,809,985,856,752,347,933,943,327,123,671,689,960,835,763,532,770,296,648,75,419,803,333,879,466,925,61,486,967,183,559,813,891,937,802,144,527,301,922,158,510,254,96,786,391,133,605,848,540,854,128,826,27,493,114,349,8,248,838,613,862,353,526,116,980,126,989],"ngrams":["an","ed","rs","ur","te","il","gj","et","ë$","ru","yr","sa","dë","nj","bi","rb","^p","h$","oh","ta","va","jë","at","e$","^e","zo","^ë","so","na","ër","^s","sh","lë","nd","ri","aç","ha","th","ti","ot","r$","dh","^z","ht","pa","së","ad","o$","hë","rk","ov","pr","që","di","ll","ra","ty","^g","^k","^b","ës","he","çi","në","^q","og","eo","be","vë","vr","të","rë","s$","av","ni","is","ga","kë","ng","i$","os","^n","jo","ko","si","in","do","se","^a","n$","^$","t$","^d","er","on","ar","^t","gr","a$"],"ngram_size":2,"dimension":1000},{"language":"sq","weights":[0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.0137931,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.0137931,0.00689655,0.00689655,0.00689655,0.0137931,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.0137931,0.00689655,0.00689655,0.00689655,0.0137931,0.00689655,0.00689655,0.00689655,0.0137931,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.0137931,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.0206897,0.0137931,0.0137931,0.00689655,0.0206897,0.00689655,0.0137931,0.0206897,0.0137931,0.00689655,0.00689655,0.00689655,0.00689655,0.0206897,0.0137931,0.0275862,0.00689655,0.00689655,0.00689655,0.0137931,0.0137931,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.0137931,0.0137931,0.00689655,0.0137931,0.0137931,0.0137931,0.0137931,0.00689655,0.00689655,0.00689655,0.0137931,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.0206897,0.0137931,0.0137931,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655,0.00689655],"ids":[325,3692,3411,4354,2477,2092,2924,2205,574,403,1970,1065,3388,3130,2746,4805,3648,312,2260,1258,3942,2069,260,4932,3699,2700,3099,4864,3353,819,3821,1592,3101,613,1153,3164,4414,1667,846,216,1950,2276,3616,1890,3133,2845,1884,4292,596,2792,2184,4764,3161,1980,94,2531,742,1070,1981,3454,4914,1961,2476,3371,1174,1493,947,177,1412,3978,3861,2410,3267,2394,1192,2947,4362,2370,664,124,832,1263,1023,4433,4902,1402,1010,4884,2598,169,3572,3624,3549,823,3419,967,372,349,1409,3423,2286,3350,4130,1072,3910,1392,4660,1046,3999],"ngrams":["ran$","ovra","sovr","^sht","^edh","llë$","rish","till","^til","htë$","ohet","kohe","^kër","^gjë","sht$","htet","adi$","yris","vran","tyri","^sov","thaç","atyr","naty","^dhe","^kos","ndër","^nga","dërs","isë$","rur$","bisë","një$","sinë","rbis","serb","shte","^ta$","gati","shtë","haçi","isht","ati$","tin$","ësht","koso","ina$","htin","shti","^pri","ërsa","^tha","arës","vës$","açi$","gjë$","sovë","pris","^pav","inë$","ësin","ohë$","avar","arur","joh$","pava","grad","osov","^zot","koni","^se$","njoh","^që$","^të$","^një","^ndë","^ser","ogra","eogr","^nat","rkon","erbi","^ësh","teti","^beo","rësi","rsa$","beog","kërk","ërko","^do$","oni$","ovës","illë","varë","zoti","het$","johë","etin","edhe","^njo","radi","dhe$","rkoh","^gat","varu","tina","oti$","nga$"],"ngram_size":4,"dimension":5000},{"language":"sq","weights":[0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.0106383,0.0106383,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.0106383,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.0106383,0.00531915,0.00531915,0.00531915,0.00531915,0.0106383,0.0106383,0.0106383,0.0106383,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.0106383,0.00531915,0.00531915,0.0212766,0.0265957,0.0106383,0.0106383,0.0106383,0.00531915,0.0106383,0.00531915,0.00531915,0.00531915,0.0106383,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.0106383,0.00531915,0.00531915,0.0106383,0.0106383,0.0106383,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.0212766,0.0106383,0.00531915,0.0159574,0.0106383,0.0106383,0.0159574,0.0212766,0.00531915,0.00531915,0.0159574,0.00531915,0.0106383,0.0106383,0.00531915,0.00531915,0.0106383,0.00531915,0.0106383,0.00531915,0.0106383,0.0106383,0.0106383,0.00531915,0.0106383,0.0106383,0.0106383,0.0159574,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.00531915,0.0159574,0.00531915,0.0106383,0.0106383,0.0159574,0.00531915,0.00531915,0.0212766,0.0106383],"ids":[3239,1594,1870,3413,1751,3629,1421,4258,2165,4763,4376,2468,4040,3124,652,2533,4633,4441,564,1987,336,3600,3094,4435,1745,335,4238,2425,2351,1439,3418,4529,441,4296,539,2052,2252,2463,4743,572,2733,4509,1246,3606,339,3803,2120,1305,266,1651,3356,1094,4673,4696,1795,2855,904,238,2797,2132,3738,2644,2019,4930,3581,2991,1732,3332,979,3346,1554,1682,187,1905,88,1004,2626,100,1272,4823,3022,849,3915,2734,2788,1629,1965,4959,2290,4556,4597,4977,1031,4814,4259,1193,2260,2518,4625,1755,2022,3797,1080,3747,4377,2116,2054,4790,3616,3375,3586,1987,4207,4975,901,191,1623,2327,1302,4005,3478,3301,2428,1003,1442,4486],"ngrams":["an$","ran","ovr","^so","^dh","ur$","rur","in$","eti","tet","hte","^sh","he$","dhe","edh","^ed","lë$","ill","til","^ti","gjë","^gj","jë$","një","et$","koh","ht$","llë","yri","^pr","nat","rsa","dër","ndë","^ko","isë","bis","rbi","tin","tyr","ërs","^th","erb","^se","oh$","^kë","^ta","ati","gat","^ga","htë","ësh","na$","ta$","ser","hti","sht","të$","ish","gra","^që","sa$","ris","çi$","açi","haç","ti$","zot","^zo","kon","ës$","ovë","inë","oso","kos","në$","^do","ësi","hë$","ohë","vra","tha","^na","^e$","kër","oti","joh","që$","rko","pav","^nj","ohe","së$","^pa","se$","do$","^be","^nd","ni$","di$","^ës","rad","^ng","rës","eog","arë","het","ërk","beo","sov","var","pri","ga$","nga","aru","aty","vës","ava","ina","ogr","sin","njo","^a$","oni","^të","adi"],"ngram_size":3,"dimension":5000},{"language":"sq","weights":[0.00359712,0.161871,0.00359712,0.0467626,0.00719424,0.0179856,0.0143885,0.0179856,0.0611511,0.0467626,0.00719424,0.00359712,0.0179856,0.0467626,0.0107914,0.161871,0.0179856,0.0755396,0.00359712,0.0395683,0.0467626,0.0467626,0.0251799,0.0503597,0.0647482],"ids":[59,68,86,44,2,57,77,5,21,20,12,65,88,24,11,52,19,46,37,63,22,79,0,66,96],"ngrams":["u","$","z","s","l","v","p","j","t","n","q","y","g","r","b","^","k","ë","ç","h","o","e","d","i","a"],"ngram_size":1,"dimension":100},{"language":"sr","weights":[0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.0145985,0.00729927,0.00729927,0.0145985,0.00729927,0.0291971,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.0145985,0.00729927,0.00729927,0.00729927,0.00729927,0.0145985,0.00729927,0.00729927,0.00729927,0.00729927,0.0145985,0.00729927,0.0145985,0.0291971,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.0218978,0.0145985,0.0145985,0.00729927,0.0145985,0.0291971,0.0145985,0.0218978,0.00729927,0.00729927,0.00729927,0.00729927,0.0364963,0.0583942,0.0218978,0.00729927,0.0145985,0.00729927,0.0218978,0.00729927,0.00729927,0.0145985,0.0218978,0.0145985,0.0218978,0.00729927,0.00729927,0.0218978,0.00729927,0.00729927,0.0218978,0.0291971,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.00729927,0.0218978],"ids":[498,266,703,274,802,499,795,67,967,711,262,356,716,375,373,871,788,890,802,210,60,523,209,965,987,726,513,982,736,828,662,130,20,346,294,544,29,789,64,408,848,325,954,31,922,752,838,47,342,404,117,439,941,780,56,782,613,817,930,861,247,516,282,237,25,28,807,922,223,695,750,227,694,706,476,429,154,589,20,461,651,965,632],"ngrams":["од","^г","из","т$","ар","^а","ка","ик","ов","ва","тн","вн","ет","�т","ле","�и","ун","пу","ви","ив","ин","тв","ол","^п","жи","шт","љу","а�","�е","фи","ра","гр","ем","ди","ед","ан","но","^д","ур","аф","рб","е$","^и","ељ","ак","у$","^$","ог","иј","^�","^н","лч","пи","го","ап","ма","на","а$","ба","зн","ро","би","к$","мо","пр","^у","ал","ни","ча","иш","^м","о�","је","^ж","та","и$","ја","чн","�р","ре","еч","де","^б"],"ngram_size":2,"dimension":1000},{"language":"sr","weights":[0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0206186,0.0206186,0.0103093,0.0206186,0.0309278,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0309278,0.0103093,0.0206186,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0309278,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0309278,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0309278,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0103093,0.0206186,0.0103093,0.0309278],"ids":[2913,862,1201,4963,1344,2912,3208,1327,2936,555,2727,63,1570,4118,3285,2214,1815,417,3524,3543,370,3819,4082,4304,3040,1324,4680,2618,4041,2988,4087,4528,2485,618,2190,1639,2443,4208,3618,4753,1409,2373,4746,2957,2139,772,1397,1319,3352,978,3622,168,1671,4516,4692,265,4620,866,3455,3041,4244,4559,2023,2900,1403,2482,956,3701,2224,4766,3141,2713,650,4160,3810,3420,3463,524,2145,2259],"ngrams":["годи","^год","о�и$","но�и","изно","^изн","тва$","штва","ништ","ро�т","аро�","дина","вниш","таро","чна$","о�еч","^про","ника","вник","овни","анов","демо","тано","^�та","летн","а�ељ","олет","^мап","ноле","про�","еди$","унол","�ечн","пуно","^пун","один","ечна","чак$","иви$","�тан","на�е","тна$","живи","ељу$","ина$","о�т$","апи$","ија$","фија","ро�е","алча","афиј","бије","рафи","^уре","етна","иштв","рбиј","^дем","зно�","лчак","�ељу","уред","граф","�тар","�рби","могр","ије$","огра","^бал","мапи","^�рб","^жив","ика$","^на$","^на�","реди","новн","емог","балч"],"ngram_size":4,"dimension":5000},{"language":"sr","weights":[0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.0172414,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.0172414,0.00862069,0.0172414,0.0172414,0.0258621,0.0258621,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.0258621,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.0258621,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.0258621,0.00862069,0.00862069,0.0258621,0.00862069,0.00862069,0.00862069,0.0172414,0.00862069,0.00862069,0.0344828,0.00862069,0.00862069,0.0172414,0.00862069,0.00862069,0.00862069,0.00862069,0.00862069,0.0172414,0.0258621,0.00862069,0.0258621],"ids":[3396,4030,2090,1248,975,4890,4836,434,3998,518,2035,416,3618,2258,745,3170,1402,81,3407,2406,3615,1881,3105,3281,1920,4891,3038,1599,1694,2009,3419,4298,2182,3465,2152,858,2687,1318,4916,3123,2208,2387,2690,1929,1917,3430,1992,2184,3671,2803,432,4962,208,312,1746,3626,4365,4018,2887,3639,2128,4994,1624,629,1747,878,3301,1280,3087,757,4658,1062,3349,1720,1553,4054,1986,887,4906,1974,3024,965,303,4864,2457,2627,4665,4589,2304,2163],"ngrams":["�и$","зно","ва$","штв","ишт","�т$","ина","о�т","чна","ечн","ро�","^пр","^а$","ка$","ика","ник","нов","�еч","ано","тан","�та","^�т","тва","етн","лет","но�","оле","уно","дин","пун","о�е","уре","^пу","мап","жив","оди","ниш","љу$","ви$","ељу","на�","ја$","еди","ија","афи","раф","год","нол","гра","о�и","мог","алч","дем","^де","апи","ди$","ред","је$","тна","лча","емо","иви","огр","^�р","биј","рби","а�е","^ба","^го","фиј","чак","^ма","пи$","аро","вни","�ељ","^ур","на$","изн","^жи","^на","^из","тар","�рб","про","^у$","овн","ак$","ије","бал"],"ngram_size":3,"dimension":5000},{"language":"sr","weights":[0.00632911,0.0379747,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.0189873,0.0379747,0.132911,0.0506329,0.0126582,0.0253165,0.0189873,0.0253165,0.132911,0.0696203,0.0253165,0.0253165,0.0253165,0.0126582,0.0253165,0.0696203,0.126582,0.0506329,0.0316456],"ids":[50,20,81,40,79,53,15,10,30,68,49,85,26,41,39,52,98,70,10,44,86,79,81,63,15,82],"ngrams":["з","т","ж","љ","ш","ф","г","д","е","$","�","м","б","п","к","^","и","ч","в","л","ј","у","н","а","о","р"],"ngram_size":1,"dimension":100},{"language":"st","weights":[0.004,0.004,0.004,0.004,0.004,0.004,0.004,0.004,0.004,0.004,0.008,0.004,0.004,0.016,0.008,0.008,0.004,0.004,0.012,0.004,0.004,0.004,0.004,0.008,0.012,0.016,0.012,0.012,0.008,0.004,0.008,0.004,0.004,0.004,0.004,0.004,0.028,0.004,0.004,0.004,0.016,0.004,0.004,0.004,0.012,0.012,0.004,0.016,0.052,0.012,0.008,0.008,0.004,0.008,0.004,0.012,0.024,0.008,0.004,0.004,0.016,0.024,0.004,0.012,0.012,0.02,0.004,0.004,0.016,0.016,0.004,0.008,0.024,0.028,0.004,0.008,0.004,0.02,0.024,0.004,0.004,0.012,0.028,0.004,0.02,0.004,0.008,0.028,0.048,0.008,0.004,0.004,0.052,0.016,0.02],"ids":[212,786,564,427,146,500,273,463,458,90,933,613,795,802,909,67,108,943,287,645,778,144,334,190,123,378,591,61,734,880,803,862,120,402,518,298,353,176,760,481,637,29,147,153,7,793,534,575,532,317,333,267,712,838,975,630,980,41,132,355,898,770,175,535,493,973,848,795,752,183,688,215,269,601,18,265,939,532,605,353,526,307,349,8,193,976,157,347,651,854,656,332,989,486,501],"ngrams":["^p","is","ki","tj","or","yo","eb","ih","fi","^f","ti","lh","ai","eo","tl","nt","ak","ot","it","^i","ru","be","^r","ya","^y","la","ke","^k","et","ph","di","^d","im","od","pe","ip","^h","lw","ok","hi","ut","oh","ka","en","sa","to","oo","^e","o$","hl","ll","eh","we","^$","ao","at","^t","ma","jh","^m","ts","g$","il","^l","lo","el","i$","ah","ha","he","wa","ta","an","ho","as","re","sh","^s","ng","er","on","hu","se","^a","le","^o","na","th","e$","^n","hw","ob","a$","^b","ba"],"ngram_size":2,"dimension":1000},{"language":"st","weights":[0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0189873,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.00632911,0.0126582,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0189873,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.00632911,0.00632911,0.0126582,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.00632911,0.0126582,0.0316456],"ids":[731,4458,1993,3957,2675,1632,3724,4816,806,1616,4306,3431,186,740,4531,4055,1664,2398,417,4878,2567,358,3745,3861,3352,3708,1302,4212,907,2632,4201,2495,3810,4757,4216,4752,1489,4252,3723,4643,225,2029,126,1728,4380,2999,3158,889,2919,337,1465,3760,2336,1479,2150,3588,2126,685,564,4520,2523,4730,2871,1844,4436,2908,4820,567,359,3326,4001,2350,1064,3503,491,1101,821,4294,3189,3644,794,3183,1713,2797,96,1028,1325,2767,131,4945,3573,4541,3543,277,1408,2358,3949,1506,4330,4294,4386,2045,4764,3134,892,4863,3584,635,3671,883,918,1948,3587,4141,1611,2744,3318,710,2223,3923,2101,2459,1957,3480,258,2222,3242,52,698,15,1408,3779,3828,3270,2309,2718,4905,1128,183,458],"ngrams":["ele$","isa$","laki","^hla","here","jher","itjh","ore$","hore","^hor","ona$","^yon","^ka$","etsa","sebe","^eo$","hath","tlha","ntlh","fihl","ithu","^fih","shwa","^se$","lang","kela","loke","tsan","huti","titj","bait","theo","^seo","hant","bets","antl","^han","sell","bats","otob","haha","seo$","huta","heo$","okel","huto","^lok","hilw","^ith","atsa","^rut","ihle","uti$","^ho$","ela$","lell","sela","tsel","tho$","ella","^ya$","^tit","heth","^seh","iphe","toto","diph","ruta","^dip","kisa","lhat","^ke$","aith","sang","ima$","dima","^hod","ehil","^bai","akis","ahas","ere$","tjhe","eng$","weng","sehl","thut","ilwe","phet","^pel","tshw","lwen","^ntl","hwao","hodi","^tot","odim","^the","thah","ooho","looh","^ban","^tha","hehi","elan","yona","^thu","^tse","hlel","etho","hloo","pele","ehlo","tle$","atsh","mats","wao$","theh","^mat","bang","^nan","llo$","athe","hase","^ba$","^seb","lla$","^le$","ello","uto$","toba","oho$","hlak","ebet","ntle","asel","nang","obat","uta$","ang$"],"ngram_size":4,"dimension":5000},{"language":"st","weights":[0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.0197044,0.00985222,0.00492611,0.00985222,0.00492611,0.00985222,0.00492611,0.00492611,0.0147783,0.0246305,0.00985222,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00985222,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.0147783,0.00492611,0.00492611,0.0147783,0.00492611,0.00492611,0.0147783,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.0246305,0.00985222,0.00492611,0.00492611,0.0246305,0.00492611,0.00985222,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.0197044,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00985222,0.00492611,0.0197044,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.00492611,0.0295567,0.00985222,0.00492611,0.00492611,0.00985222,0.00492611,0.00985222,0.0246305,0.00492611,0.00985222,0.00492611],"ids":[3028,4113,1486,2644,4272,2168,2854,1931,1154,2792,2973,1987,504,4673,4538,1951,2030,1849,3214,2998,1090,3502,1423,2982,2759,3106,4259,3315,1540,4827,3562,1103,129,628,2976,3870,592,1732,3335,2242,1601,2437,4450,4509,2732,424,1672,4696,873,162,4972,4942,3764,1960,3447,2202,4378,857,2054,4381,4148,3606,982,4301,2696,4102,1660,3534,831,1271,2277,2420,3494,1009,4471,1993,2017,2819,1746,1002,2734,3915,1881,290,1353,3896,136,849,2627,589,166,4520,3451,1734,2383,4002,4716,1981,3917,3606,700,1392,4599,4644,2428,2034,1071,1390,1936,2147,2581,3414,4161,893,775,4779,4063,14,3165,56,4995,2038,3265,3595,4497,959,679,1486,2316,1808,696,2389,2049,1442,550,2413,2222,1673,1820,2342,4438,1680,4802,2644,3142],"ngrams":["ele","pel","^pe","sa$","isa","kis","aki","^hl","her","jhe","tjh","^ti","re$","na$","ona","yon","ka$","^ka","bet","heo","lha","^nt","seb","lla","ihl","fih","se$","tit","hlo","^lo","ntl","kel","han","hle","^ha","eo$","san","ti$","tsa","bat","the","ooh","tot","^th","^ho","ith","^it","ta$","^to","rut","^ru","ya$","^eo","ela","tse","wao","^ke","llo","het","^di","iph","^yo","ebe","^ya","lak","ere","dim","ma$","lok","hod","^fi","wen","ilw","itj","hil","hla","hat","tlh","seo","heh","^e$","^na","uto","hut","to$","nan","thu","tha","ehl","oho","lwe","ets","loo","tho","ath","ima","ehi","tob","tsh","^se","uta","dip","lan","ho$","^a$","la$","mat","ait","^ma","ao$","^o$","aha","^ts","eth","ba$","^ba","phe","lo$","ase","tle","ant","has","ke$","bai","le$","oke","hah","uti","seh","oba","lel","eng","shw","ore","ng$","^le","hor","odi","ats","oto","sel","ang","ban","ell","hwa"],"ngram_size":3,"dimension":5000},{"language":"st","weights":[0.003367,0.010101,0.00673401,0.030303,0.00673401,0.00673401,0.0942761,0.016835,0.158249,0.0538721,0.0707071,0.0774411,0.013468,0.020202,0.03367,0.0909091,0.003367,0.037037,0.0707071,0.010101,0.00673401,0.020202,0.158249],"ids":[5,24,77,66,32,0,79,19,52,2,22,63,59,11,20,96,22,44,21,65,0,88,68],"ngrams":["j","r","p","i","w","d","e","k","^","l","o","h","u","b","n","a","f","s","t","y","m","g","$"],"ngram_size":1,"dimension":100},{"language":"su","weights":[0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.0030303,0.00606061,0.00606061,0.0030303,0.0030303,0.0030303,0.0333333,0.00606061,0.0030303,0.0030303,0.0030303,0.00606061,0.00606061,0.0030303,0.0030303,0.0242424,0.0121212,0.0030303,0.0030303,0.0030303,0.00606061,0.0030303,0.00909091,0.0151515,0.00606061,0.0030303,0.00606061,0.00606061,0.0030303,0.0030303,0.00606061,0.0030303,0.00606061,0.0424242,0.00909091,0.0272727,0.00606061,0.0121212,0.0151515,0.0151515,0.00909091,0.0121212,0.0121212,0.0030303,0.0030303,0.0030303,0.0454545,0.0030303,0.0030303,0.0121212,0.00909091,0.0030303,0.0030303,0.0121212,0.0030303,0.00909091,0.00606061,0.00909091,0.0030303,0.00606061,0.0030303,0.0030303,0.00606061,0.00909091,0.0424242,0.0030303,0.0212121,0.0030303,0.0151515,0.00606061,0.00606061,0.0121212,0.0030303,0.00606061,0.00606061,0.0121212,0.0030303,0.0030303,0.00909091,0.00909091,0.0030303,0.0212121,0.00606061,0.00909091,0.00909091,0.0030303,0.0030303,0.00909091,0.0030303,0.00909091,0.0151515,0.0121212,0.0151515,0.00909091,0.0030303,0.0181818,0.0151515,0.0181818,0.0030303,0.0212121,0.0181818,0.0181818,0.0030303,0.00606061,0.00909091,0.00606061,0.00606061],"ids":[237,337,108,355,786,365,120,645,34,879,623,656,27,18,489,826,486,61,712,113,410,193,535,961,637,571,875,157,568,920,526,385,307,763,854,46,885,379,198,489,732,503,514,378,605,68,989,458,685,147,862,613,191,803,380,752,58,269,29,190,215,532,265,207,980,955,41,804,212,998,481,518,707,493,933,248,307,153,298,391,334,672,7,748,935,429,591,865,668,545,652,984,960,67,688,717,692,702,778,265,116,848,795,327,780,629,770,421,517,238,630,23,8,819,349,80,895,838],"ngrams":["ne","tn","ak","^m","is","tr","im","^i","gu","ra","aw","bo","si","as","es","ko","^b","^k","we","bu","em","le","^l","gg","ut","mp","un","na","nn","ua","on","de","hu","ad","^n","al","^u","ep","gk","ed","su","us","du","la","ng","^j","a$","tu","je","ka","^d","t$","ku","di","ew","ha","uh","an","oh","ya","ta","^s","re","ej","^t","te","ma","h$","^p","ay","hi","pe","ce","in","ti","n$","nc","en","ip","ga","^r","da","sa","mb","ap","ia","ke","w$","rg","ir","up","rt","pa","nt","wa","^w","gi","aj","ru","pi","ar","i$","ah","r$","pu","ja","g$","ur","eu","rw","at","u$","^a","li","se","nu","am","^$"],"ngram_size":2,"dimension":1000},{"language":"su","weights":[0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00884956,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00884956,0.00884956,0.00442478,0.00884956,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00442478,0.00442478,0.00884956,0.00884956,0.00884956,0.00442478,0.00442478,0.00442478,0.0132743,0.00442478,0.00442478,0.0132743,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.0132743,0.00442478,0.00884956,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.0176991,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00884956,0.00884956,0.00442478,0.00884956,0.00884956,0.00442478,0.0132743,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00442478,0.00884956,0.00884956,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00442478,0.00442478,0.00442478,0.00442478,0.00884956,0.00442478,0.00442478,0.00884956],"ids":[4729,4919,4180,1235,464,1733,4559,3804,3350,4536,1444,2030,2365,2427,1650,1305,2990,4644,2414,3329,2292,4337,2716,4184,2028,3660,1592,3603,3505,1304,51,4796,4994,1148,3616,3913,124,4813,3435,1266,3635,4323,1031,1758,3440,503,4681,2981,400,183,1474,20,3363,1471,2702,1919,758,3977,1942,15,1066,379,2,3879,1710,4078,57,1583,714,670,3534,4521,3491,589,1092,445,381,1208,1797,364,18,3092,3496,1856,4864,1892,3878,3110,3090,684,1231,3551,2021,458,1193,3553,3001,2254,4276,712,3093,2888,346,1811,1307,2690,4155,1331,3005,3982,3387,4164,96,1377,4365,1504,2444,3200,4942,610,4455,1690,199,2850,2877,4862,421,4180,1733,1630,1213,4334,2620,1770,4819,1886,54,3559,1165,359,1111,1452,4993,4013,2445,147,1358,2593,497,577,158,2606,878,1158,1385,3767,724,3266,4931,4415,526,659,769,4027,1705,3801,1985,3595,1576,2277,1729,3320,4419,2125,774,888,4094,3911,4819,1321,3435,3780,3017,4120,1617,2161,3794,4891,2714,2517],"ngrams":["^lia","^nen","atna","sara","lian","asar","disi","adis","radi","awa$","^ata","imah","guna","^mas","ngun","wang","mah$","tapi","pasi","esa$","aya$","asir","^aya","enna","ejen","angi","^di$","^sej","bur$","mbur","embu","^lem","ggan","^ang","ati$","^ima","^wew","^pat","ngin","teu$","angg","^teu","^kut","mpun","ampu","kamp","^kam","^ti$","api$","uta$","jan$","naja","sana","^san","ngke","cen$","ewen","unce","sir$","^sed","kunc","lemb","uan$","nna$","huan","uhua","masa","puhu","pupu","kon$","dat$","^boh","ngga","adat","raka","^ada","usan","dipu","^uru","^tap","keun","engk","tna$","usun","^nga","ncen","ian$","tawa","^wan","pala","dusu","sede","arak","ang$","epal","^kep","seje","rusa","iatu","eung","ngko","sun$","^jeu","kape","^rw$","neng","diat","^rt$","eun$","unan","pung","^dia","weng","ahan","katn","jeun","ngat","^kah","^pam","rent","akat","kuta","upuh","^tra","^dus","ung$","enta","warg","isi$","mare","ntin","pama","ala$","han$","ataw","gkon","gan$","angu","deng","^dip","aren","inga","gin$","taha","rga$","san$","ngan","boh$","enti","eur$","irup","^kap","upan","^ku$","^war","tur$","pan$","apen","^nu$","^pas","wewe","jenn","ajan","engg","rupa","^des","amar","hiru","ahir","gkeu","pent","ting","arga","anaj","ipup","nan$","kepa","^keu","urus","^kun","kahi","trad","eden","pati","gatu","keur","gang","ntah","desa","atur"],"ngram_size":4,"dimension":5000},{"language":"su","weights":[0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.00361011,0.0180505,0.00722022,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.0108303,0.00361011,0.00722022,0.00361011,0.00361011,0.00361011,0.0108303,0.00722022,0.00722022,0.00722022,0.00722022,0.00722022,0.00361011,0.00722022,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.00722022,0.00361011,0.00361011,0.00722022,0.0108303,0.0216607,0.0144404,0.00361011,0.00722022,0.00361011,0.0144404,0.0108303,0.00722022,0.00361011,0.0108303,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.0144404,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.0108303,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00722022,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.032491,0.00361011,0.0144404,0.00722022,0.0108303,0.00361011,0.00722022,0.0108303,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011,0.0144404,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00722022,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.0108303,0.00722022,0.00361011,0.00361011,0.00361011,0.00361011,0.00361011,0.00722022,0.00361011],"ids":[1987,1729,3465,1180,3407,2592,4530,2224,3049,1936,2110,3797,3811,1760,1848,2640,3896,327,4630,1373,339,275,4894,755,4968,3613,1944,4258,1958,1741,2603,2644,3430,4251,2267,3346,2772,1119,4673,4942,4377,243,3155,4341,1290,3406,1680,3931,1732,1232,3055,411,4486,957,4696,16,700,2516,4872,2229,3538,4995,3217,2120,360,503,1323,1794,2766,1305,2441,3939,4427,4814,2182,2258,234,3826,1392,2690,2629,739,442,592,2983,2597,2344,4200,944,3625,3606,2474,3006,1099,2202,4226,562,2034,4383,141,1057,4562,949,2389,550,1756,3098,3060,2438,460,353,2270,2354,3584,962,2259,4839,3902,1547,2633,2328,4198,2828,642,524,2558,105,149,129,2918,715,4002,316,4330,2176,4743,2557,2242,4607,40,2488,2624,2581,4470,3956,2841,2483,3300,4570,2861,280,1376,4964,3239,4194,3629,3289,4378,4721,2204,1297,507,1794,4091,2413,266,4092,1103,1023,1849,4447,256,3414,3976,1852,2420,1162,1337,2329,52,958,4382,4003,1755,3504,4374,4381,3189,4418,3014,1080,3471,4207,4975,442],"ngrams":["^ti","nen","^ne","atn","aka","rak","ara","asa","mas","^ma","isi","rad","wa$","awa","^at","^im","nan","una","ngu","wan","oh$","si$","^bo","^tr","api","gun","tap","in$","gin","sir","pas","sa$","des","boh","on$","kon","wew","^we","na$","ya$","enn","mbu","lem","ngg","esa","^ay","ang","^an","ti$","pat","ewe","eu$","adi","teu","ta$","^te","uta","mpu","amp","kam","ata","aja","naj","^ta","un$","en$","rga","cen","ir$","ati","pun","ent","nce","^pa","unc","^wa","uan","taw","dip","nu$","at$","pal","ada","san","upa","rus","rup","uru","ede","pen","^se","sun","^li","usu","^du","sej","hua","la$","arg","ala","^de","den","epa","eng","ng$","ung","lia","gga","kut","eun","jeu","ngk","are","^je","sed","rw$","aya","ku$","rt$","jen","^rw","^rt","^ku","kat","dis","pi$","kep","dia","han","ren","ah$","ima","bur","gan","nta","tin","ape","kap","war","dat","iru","ama","gko","gke","tur","asi","eur","puh","^ur","ana","tah","tra","mar","an$","iat","ur$","ahi","^ke","emb","pan","^nu","usa","ngi","nna","^le","gat","ing","hir","uhu","^ka","jan","nti","aha","tna","sar","wen","^sa","ian","^ad","kah","keu","pup","pam","di$","dus","mah","^di","atu","kun","ipu","^ng","eje","ga$","nga","upu"],"ngram_size":3,"dimension":5000},{"language":"su","weights":[0.00261097,0.0234987,0.0130548,0.0234987,0.0522193,0.0156658,0.0313316,0.0365535,0.0391645,0.138381,0.0391645,0.138381,0.00261097,0.0130548,0.0443864,0.00522193,0.0156658,0.0104439,0.138381,0.0365535,0.00522193,0.104439,0.0704961],"ids":[58,44,5,0,79,32,77,24,66,96,21,68,65,0,88,22,63,2,52,19,11,20,59],"ngrams":["c","s","j","d","e","w","p","r","i","a","t","$","y","m","g","o","h","l","^","k","b","n","u"],"ngram_size":1,"dimension":100},{"language":"sv","weights":[0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00411523,0.00823045,0.00823045,0.00823045,0.00823045,0.00411523,0.00823045,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00411523,0.0123457,0.00411523,0.00823045,0.00823045,0.00823045,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.0288066,0.0123457,0.00411523,0.0123457,0.00411523,0.00411523,0.0123457,0.00411523,0.0452675,0.0288066,0.00823045,0.00823045,0.00823045,0.00823045,0.00411523,0.00411523,0.0123457,0.00823045,0.0205761,0.00411523,0.00411523,0.0123457,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.0123457,0.00823045,0.00411523,0.00411523,0.00411523,0.0123457,0.00823045,0.0123457,0.00411523,0.00411523,0.00411523,0.00411523,0.0123457,0.00823045,0.0123457,0.0123457,0.00411523,0.00823045,0.00411523,0.0123457,0.0123457,0.00411523,0.00411523,0.00823045,0.00411523,0.0123457,0.0164609,0.00411523,0.00411523,0.0123457,0.00411523,0.00823045,0.0164609,0.0164609,0.00411523,0.00823045,0.0164609,0.00823045,0.00823045,0.0205761,0.00411523,0.00411523,0.00411523,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.00411523,0.00823045,0.00411523,0.00411523,0.00823045,0.0164609,0.00823045,0.00411523,0.00823045,0.00823045,0.00411523,0.00411523],"ids":[973,518,571,410,314,333,175,980,349,360,535,23,22,514,378,265,98,116,54,960,544,487,369,7,183,656,879,591,745,477,900,575,391,356,985,75,18,123,645,707,568,677,782,651,575,887,933,126,166,251,660,327,353,493,854,46,753,786,510,193,225,955,770,907,90,937,190,215,176,64,532,265,614,692,496,632,763,925,122,134,605,355,269,984,200,212,752,146,75,553,534,996,793,829,780,385,300,364,128,989,153,71,937,734,895,28,613,989,685,862,761,237,332,269,785,671,757,227,622,838,630,782,489,8,738,157,976,248,540,486],"ngrams":["el","pe","mp","em","l$","ll","il","^t","se","äs","^l","u$","xe","du","la","kl","ik","ar","ft","pa","np","om","ex","sa","he","bo","ra","ro","ug","är","pl","rd","vb","me","ri","pr","as","^y","^i","d$","nn","ef","fö","e$","^e","v$","ti","gr","rn","ny","lt","r$","er","in","^n","al","lä","is","s$","le","ss","te","g$","ag","^f","ån","ya","ta","lu","äl","^s","re","^ö","gi","kr","ör","ad","^g","ld","p$","y$","^m","^ä","rt","st","^p","bj","or","op","go","oo","ds","to","sk","va","de","m$","vi","po","gl","en","^v","og","et","am","kt","t$","a$","je","^d","rå","ne","ob","an","yh","fr","ek","iv","lj","^$","at","dr","es","^a","so","na","^o","n$","os","^b"],"ngram_size":2,"dimension":1000},{"language":"sv","weights":[0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.0188679,0.0188679,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0188679,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.0125786,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.0188679,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.0125786,0.00628931,0.00628931,0.00628931,0.0188679,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931,0.00628931],"ids":[231,2069,1313,574,1042,1359,4036,33,98,1715,1447,4144,4341,3711,4458,3042,2214,3845,3327,4929,4770,2180,4295,4993,1377,2370,1450,110,4873,4246,807,2865,550,910,3659,3724,237,2288,2941,1832,4202,320,2904,2205,1825,4715,892,4098,725,610,2819,4448,84,4883,3428,2622,2826,201,1672,709,2767,3801,4215,960,1404,716,4239,2897,2579,662,4511,4138,3645,195,835,1739,3116,407,2094,3420,761,3002,3775,2737,399,4632,3964,3252,470,4681,1374,2720,3684,2304,4419,1310,2571,269,3841,3343,3560,819,2605,586,3636,1751,3801,2420,4640,2212,179,2667,4754,2856,1871,1005,302,1918,3244,1252,3802,4476,1862,3504,2552,4151,3577,3475,1864,259,3922,4397],"ngrams":["empe","exem","^exe","^til","ser$","^läs","klar","ikla","rtik","arti","^eft","sade","pass","^anp","isa$","läse","anpa","goog","ter$","älds","visa","hete","tikl","gin$","gram","ogra","rogr","efte","yhet","ill$","^pro","lugi","plug","mpel","talj","^som","ogle","ugin","bord","oogl","ivbo","vbor","kriv","till","eny$","ste$","aste","inne","skri","^inn","prog","^för","nyhe","fter","tiv$","ativ","nati","^plu","tern","ktop","alte","^är$","^alt","för$","jer$","alje","ade$","etag","jekt","reta","dres","ess$","öret","ress","lter","^de$","meny","ram$","npas","^skr","^men","dst$","^eta","^du$","assa","ldst","ssad","^obj","^äld","xemp","nne$","vad$","post","^vis","^om$","äser","^nyh","top$","^dre","ord$","^öre","^yas","rån$","^frå","eskt","desk","^des","rivb","som$","etal","gle$","rnat","^pos","lar$","erna","bort","^vad","ljer","bjek","obje","eter","yast","tag$","ost$","^goo","ekt$","från","skto","^art","ort$","pel$","^bor"],"ngram_size":4,"dimension":5000},{"language":"sv","weights":[0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.01,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.015,0.005,0.005,0.005,0.01,0.01,0.01,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.01,0.01,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.015,0.005,0.005,0.03,0.005,0.005,0.015,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.015,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.005,0.01,0.005,0.005,0.02,0.005,0.005,0.005,0.01,0.005,0.005,0.015,0.01,0.005,0.005,0.005,0.01,0.01,0.005,0.005,0.005,0.005,0.01,0.005,0.01,0.01,0.005,0.005,0.005,0.01,0.005,0.015,0.005,0.005,0.005,0.015,0.005],"ids":[3814,4113,3020,2207,4441,2964,2868,2467,249,4017,1344,1512,2537,1971,665,4106,2357,4867,1634,4289,3931,4484,4761,1608,4272,2457,1942,4586,1575,2644,2132,4005,3413,2522,1504,2942,62,4884,4366,3814,222,1226,4248,607,1709,405,2911,3009,1591,4590,537,67,4312,913,3136,4301,2505,4189,748,4290,1987,2571,4963,4125,3876,1366,3848,681,4194,3242,2428,1889,1876,3185,420,3724,721,3102,996,2660,1494,3430,1656,1818,1136,1439,319,3418,1547,4497,1986,2747,1294,1305,4234,4258,2586,426,1958,4094,1357,159,2241,6,563,373,1745,3170,805,1971,669,3193,4979,1964,2564,3108,4162,176,720,3178,3284,85,4024,3168,527,281,1057,3684,3802,1881,2259,1790,3369,4923,2835,1795,563,4534,1981,114,4358,4811,2202,2054,1206,1871,3614,569,2603,1010,564,2485,1716,2672,4894],"ngrams":["el$","pel","exe","ll$","ill","^om","äse","^lä","du$","ar$","kla","tik","rti","art","^ar","eft","^ef","sad","npa","anp","^an","om$","vis","^vi","isa","yhe","^ny","nyh","ram","sa$","gra","ogr","^so","rog","ugi","ass","plu","^pl","ord","ör$","vbo","ivb","kri","skr","kto","alt","^sk","fte","riv","ort","ny$","te$","dst","yas","^ob","^ya","ret","är$","jek","ad$","^ti","läs","ete","inn","för","ern","ag$","lte","^al","ssa","^a$","ste","^in","jer","lje","^et","tal","ss$","am$","ess","eta","des","^ex","goo","^dr","^pr","er$","nat","rt$","le$","skt","esk","pos","ati","res","in$","bje","öre","gin","ne$","eny","gle","men","^va","iv$","ån$","^me","^fr","ost","de$","pro","kt$","äld","^po","tiv","mpe","lar","op$","tag","som","^ör","top","ter","alj","xem","rån","^de","rna","^äl","oog","bor","ade","vad","ast","^fö","ser","lug","rd$","lds","emp","st$","obj","^du","het","dre","frå","ekt","^är","pas","ogl","til","ikl","nne","^go","^bo"],"ngram_size":3,"dimension":5000},{"language":"sv","weights":[0.0034965,0.00699301,0.0104895,0.0244755,0.0174825,0.020979,0.0524476,0.0314685,0.013986,0.020979,0.0314685,0.013986,0.0454545,0.15035,0.013986,0.013986,0.0104895,0.048951,0.0314685,0.0909091,0.0734266,0.00699301,0.0034965,0.0524476,0.0104895,0.048951,0.15035],"ids":[86,63,59,66,97,77,21,20,65,0,88,57,2,52,19,22,28,44,0,79,24,5,76,22,11,96,68],"ngrams":["x","h","u","i","ä","p","t","n","y","m","g","v","l","^","k","f","ö","s","d","e","r","j","å","o","b","a","$"],"ngram_size":1,"dimension":100},{"language":"sw","weights":[0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.0316206,0.0118577,0.00395257,0.00395257,0.00395257,0.0118577,0.00790514,0.0197628,0.0118577,0.00395257,0.00395257,0.00395257,0.00790514,0.0118577,0.00790514,0.00395257,0.00790514,0.00395257,0.00395257,0.0118577,0.0197628,0.00790514,0.00395257,0.00395257,0.00395257,0.00790514,0.00790514,0.00395257,0.00395257,0.00790514,0.00395257,0.00395257,0.0118577,0.00395257,0.00395257,0.00395257,0.0158103,0.00395257,0.00790514,0.00790514,0.00395257,0.00790514,0.00395257,0.0197628,0.00395257,0.00790514,0.00790514,0.00790514,0.00790514,0.00395257,0.0118577,0.00395257,0.0118577,0.0118577,0.0158103,0.0158103,0.00395257,0.00395257,0.00790514,0.00395257,0.00395257,0.00395257,0.00790514,0.0197628,0.00790514,0.00395257,0.0158103,0.0158103,0.00395257,0.00395257,0.0197628,0.00790514,0.00395257,0.00395257,0.00790514,0.00395257,0.0158103,0.00395257,0.00395257,0.00395257,0.00790514,0.0158103,0.00395257,0.00395257,0.102767,0.00395257,0.0158103,0.0118577,0.0118577,0.0158103,0.00395257,0.0118577,0.00395257,0.00790514,0.0158103,0.0118577,0.0158103,0.00790514,0.00395257,0.0197628],"ids":[458,403,153,237,933,392,978,760,793,18,822,7,532,662,227,688,601,320,745,535,353,242,752,147,862,402,591,895,786,96,887,144,75,146,190,215,90,702,630,183,116,291,680,960,500,89,645,651,511,879,623,481,125,564,809,985,355,267,532,763,8,629,91,803,503,175,88,191,717,98,819,672,391,517,545,176,68,605,269,637,493,885,854,46,442,157,875,108,754,748,935,71,879,976,378,159,61,230,62,989,458,490,123,364,429,571,594,287,41,980,635,848,838,265,939],"ngrams":["fi","no","en","ne","ti","ud","bi","ok","to","as","aa","sa","^s","iw","iv","wa","ho","gh","ug","^l","^h","fu","ha","ka","^d","od","ro","am","is","ni","oj","be","op","or","ya","ta","^f","aj","at","he","ar","kw","gw","pa","yo","iy","^i","e$","zo","ra","aw","hi","ji","ki","nd","ri","^m","eh","o$","ad","^a","ja","vy","di","us","il","az","ku","^w","ik","li","da","ga","mi","ir","lu","^j","ng","an","ut","in","^u","^n","al","ml","na","un","ak","af","mb","ap","^v","ib","^o","la","py","^k","iz","zi","a$","tu","um","dh","vi","ia","mp","ju","it","ma","^t","uj","i$","^$","re","sh"],"ngram_size":2,"dimension":1000},{"language":"sw","weights":[0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0171429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.00571429,0.00571429,0.00571429,0.00571429,0.00571429,0.0114286,0.0114286,0.00571429,0.00571429,0.00571429],"ids":[2683,2121,2967,4930,4808,1112,486,973,3290,821,1884,384,4012,3596,3229,2254,1471,2667,1621,1767,1781,1991,2490,2233,111,3546,2676,3167,2606,2304,3440,1227,4605,989,1932,2657,3491,4659,1882,870,2014,353,2635,2514,4617,1633,3882,3248,4165,1922,976,3390,4939,1811,4679,417,888,3002,1174,4115,4734,2071,1463,3880,432,4742,4919,3686,4010,452,1790,1198,887,3258,552,2648,4755,2021,4682,4328,3885,658,2289,149,4243,2879,4607,449,1258,3025,3363,2424,4194,175,2891,1401,68,3975,1092,3291,3448,2980,4283,183,4830,1374,3213,1273,956,3280,3202,1824,2063,1559,3124,1148,3526,488,3825,4703,4249,4475,423,377,3265,89,2774,1209,789,42,345,119,2087,4968,3934,624,3822,2209,4236,2547,4428,4822,3771,3293,1516,1408,807,383,464,1836,897,2661,660,4335,1215,4796,3283,4333,4015,1980,565],"ngrams":["aka$","ikia","hara","^har","eno$","neno","^wa$","tish","biti","ibit","hibi","dhib","^tok","sha$","mash","naa$","^san","iniw","amin","hami","vyo$","ivyo","iliv","fiki","itis","vili","nish","hika","vish","^vis","hoja","^hoj","gha$","^vil","ugha","^tam","mawa","rodh","apya","^wap","^lug","adil","iaji","umia","asha","iwa$","tumi","watu","vya$","^tar","^dha","tare","kwa$","ilia","ngwa","aji$","niwa","^kwa","amas","wapy","angw","ehe$","^mpy","pang","iyop","iliy","^nen","awaz","sho$","afut","^fut","^fik","riki","^jum","irik","yopa","hiri","arak","alia","shir","toka","ushi","^uju","miaj","isho","ndi$","ikan","^vik","^hiz","atum","sana","jumb","kuja","^kuj","undi","ikun","^ili","lia$","raka","udhi","tafu","ngal","oka$","uta$","dili","^udh","mla$","izi$","orod","kund","gali","hizi","dha$","^kus","ujad","^ang","livy","odha","opan","jadi","^na$","^wat","liyo","umla","azo$","anaa","iki$","kush","futa","kani","iana","wazo","viku","oja$","lugh","mpya","ujum","tama","gwa$","anis","unda","dham","rehe","anga","mini","^oro","ishi","^taf","lian","kia$","umbe","^und","nda$","areh","^maw","ana$","mbe$","pya$","shik","^vya","juml"],"ngram_size":4,"dimension":5000},{"language":"sw","weights":[0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00938967,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00938967,0.00469484,0.00469484,0.0140845,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.0140845,0.00938967,0.00938967,0.0140845,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.0140845,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00938967,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.0234742,0.00469484,0.0140845,0.00469484,0.00469484,0.00938967,0.00469484,0.00469484,0.00469484,0.00469484,0.0140845,0.00938967,0.00938967,0.00469484,0.00938967,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00469484,0.00938967,0.00469484,0.00469484,0.00469484,0.00938967,0.00469484,0.00469484,0.00469484,0.00469484,0.00938967,0.00938967,0.00469484,0.0140845,0.00469484,0.00469484,0.00469484,0.00938967,0.00469484,0.0187793,0.00469484,0.00938967,0.00469484,0.00469484,0.00469484,0.00938967,0.00938967,0.00938967,0.00469484,0.00938967,0.00938967,0.00469484,0.0140845,0.00938967,0.00469484,0.00469484,0.00469484,0.00469484,0.00938967,0.00469484,0.00469484,0.00938967,0.00469484,0.00469484,0.00469484,0.0140845,0.00469484],"ids":[65,4322,2592,4530,4731,1729,3465,4287,2339,621,416,351,4622,3079,873,872,3049,2624,1953,592,2030,4895,862,241,1751,4823,1765,1595,270,2277,3549,1162,3021,2582,230,3524,2797,4761,2941,3490,540,2560,563,1889,984,318,2115,4348,2253,4336,1633,245,2989,1711,2385,2791,3052,2123,4486,1886,4418,3189,2258,4219,1139,1589,3043,4317,2785,2204,140,2393,706,817,1103,1724,660,4079,2812,2732,4718,980,2656,2642,1491,2972,874,1936,4975,4198,2355,156,2976,501,4852,1536,3811,4439,1608,2119,3363,2290,1597,4146,1066,3301,4407,4696,332,1253,2861,1337,4202,3931,825,553,2354,2272,1755,4484,1558,1027,1760,1189,3496,4040,3195,1631,927,3848,1580,3915,2861,504,3166,3098,3931,4673,3407,2484,1941,3341,2859,2828,1680,4644,2428,953,700,4049,2120,2003,295,2034,5,1887,4711,3870,3908,1909,579,1661,4640,4942,4677],"ngrams":["kia","fik","rak","ara","no$","nen","^ne","tis","ibi","hib","dhi","udh","^ud","oka","^to","ash","mas","ama","tam","san","ka$","niw","ami","ham","^dh","yo$","eno","vyo","ivy","^fi","iti","^sa","vil","sho","nis","hik","ish","vis","ja$","hoj","gha","ugh","lug","tok","zi$","izi","^hi","ha$","dha","pya","ili","ji$","odh","nda","jad","^fu","min","wap","adi","aji","kun","atu","^wa","mpy","ehe","tar","afu","wat","kan","pan","opa","iaj","ani","ngw","hir","yop","iri","iyo","liy","^ho","oro","^il","zo$","mia","waz","uml","rod","^ma","nga","^kw","ika","ki$","^ha","^lu","rik","apy","wa$","aa$","^vi","azo","naa","shi","^or","vya","ush","liv","jum","ta$","kwa","kus","ana","ian","sha","hiz","umi","dil","are","da$","di$","mbe","ndi","iku","awa","und","tum","he$","bit","uja","be$","ia$","ali","^na","ini","gal","taf","lia","^an","na$","aka","fut","^ju","maw","kuj","^ku","ang","ho$","^a$","uju","uta","har","^ta","^uj","^vy","la$","mla","gwa","umb","reh","iwa","iki","^un","^mp","oja","ya$","vik"],"ngram_size":3,"dimension":5000},{"language":"sw","weights":[0.0341297,0.0887372,0.0273038,0.0136519,0.0443686,0.0204778,0.0102389,0.0443686,0.0170648,0.0273038,0.0341297,0.136519,0.0170648,0.0204778,0.0102389,0.0273038,0.0102389,0.0477816,0.0102389,0.0204778,0.156997,0.0204778,0.0170648,0.00682594,0.136519],"ids":[22,66,32,24,63,44,22,20,65,21,19,52,57,2,88,0,77,59,11,5,96,0,79,86,68],"ngrams":["o","i","w","r","h","s","f","n","y","t","k","^","v","l","g","m","p","u","b","j","a","d","e","z","$"],"ngram_size":1,"dimension":100},{"language":"ta","weights":[0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0357143,0.0238095,0.0119048,0.0238095,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.047619,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0357143,0.0119048,0.0119048,0.0119048],"ids":[752,731,731,410,400,750,953,276,171,462,749,982,726,396,206,859,648,253,40,179,114,640,732,838,258,238,676,507,422,419,428,836,485,896,365,4,647,423,856,9,774,931,818,876,387,209,32,667,565,616,824,447,4,336,8,722,131,24,203,741,73,176,259,366,25,174,332],"ngrams":["ொக","^த","த�","�ள","ளத","உள","�ற","ஒன","^ஒ","�ம","ில","வி","தொ","ோவ","ன�","வன","ிவ","ன$","ாண","ம�","^ப","னா","பட","^$","ப�","ண�","டம","டப","கட","ான","�ப","ால","�ட","ட�","ரம","^க","ஜே","ந�","ல�","�க","ழன","மா","^உ","ற�","ட$","�$","அங","சி","ர$","க�","^அ","ிர","சோ","தி","ரா","�த","^ர","ேந","ள�","கோ","�ம","பி","^ச","�$","ோழ","ங�","ாஜ"],"ngram_size":2,"dimension":1000},{"language":"ta","weights":[0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129,0.016129],"ids":[4549,784,3844,2918,2865,1633,1223,617,2603,4831,4467,3281,438,4368,3500,3633,3523,2235,868,601,3338,1125,1567,2022,3987,764,2407,3691,1091,3721,1754,2723,1848,2901,3155,3193,4880,3548,384,4970,1624,3354,4971,876,28,1389,1744,4629,4569,236,3852,722,2868,4657,170,3825,957,4191,4142,3611,67,331],"ngrams":["ொக�$","தொக�","^தொக","ளத�$","�ளத�","ள�ளத","^உள�","�ம�$","ற�ம�","ன�ற�","உள�ள","^ஒன�","ில�$","வில�","ோவில","ஜேந�","^கோவ","ிவன�","�க�$","மான$","^சிவ","�டமா","டமான","மாண�","ம�மா","வன�$","ிரம�","^பிர","ட�ட$","ட�டப","பட�ட","�பட�","�ற�ம","டப�ப","�டப�","ாண�ட","ப�பட","ந�தி","ோழனா","கட�ட","ால�$","பிரம","ராஜே","னால�","ழனால","^சோழ","�திர","ண�டம","ஒன�ற","^அங�","திர$","சிவன","ேந�த","ாஜேந","^ராஜ","^கட�","ங�க�","�மாண","ரம�ம","சோழன","கோவி","அங�க"],"ngram_size":4,"dimension":5000},{"language":"ta","weights":[0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889],"ids":[1895,2127,4585,3437,786,4615,4968,2318,4870,3249,4772,4426,522,4632,4506,4674,578,292,2498,4902,2005,4546,2859,630,479,4344,2205,3879,3106,1654,3505,2693,2521,369,3751,1819,2349,2189,242,4593,905,3888,3068,404,2157,713,2383,686,2474,1301,3672,947,342,3243,1059,3953,951,352,1892,3633,1938,4757,1332,3621,3277,948,3726,4870,1299],"ngrams":["ொக�","த�$","ளத�","�ளத","உள�","^உள","ம�$","ஒன�","ோவி","கோவ","ற�ம","ிவன","சிவ","^ஒன","ான$","ண�ட","டமா","�டம","ாண�","மாண","வன�","ம�ம","ிரம","சோழ","பிர","�ட$","ேந�","அங�","பட�","தொக","�பட","ப�ப","ாஜே","ரம�","ன�ற","^பி","டப�","�டப","ட�ட","^சி","�ம�","�ற�","வில","^கோ","^கட","ன�$","^ரா","�க�","ல�$","கட�","ால�","^தொ","ழனா","ோழன","ள�ள","ில�","ிர$","�தி","^சோ","திர","�மா","னால","ராஜ","மான","ந�த","க�$","^அங","ங�க","ஜேந"],"ngram_size":3,"dimension":5000},{"language":"ta","weights":[0.0104167,0.0104167,0.0104167,0.0208333,0.03125,0.0208333,0.0416667,0.0520833,0.0104167,0.0208333,0.0416667,0.0208333,0.0104167,0.0104167,0.0208333,0.0104167,0.03125,0.03125,0.125,0.0416667,0.0104167,0.0416667,0.0416667,0.0104167,0.0104167,0.0416667,0.135417,0.0104167,0.125],"ids":[91,43,63,62,20,58,18,65,46,81,64,30,98,71,64,47,4,2,68,73,4,81,32,72,9,22,63,5,52],"ngrams":["ற","ொ","ஒ","வ","ப","ள","�","ட","ந","ல","ன","ச","ழ","ே","ோ","உ","த","ர","$","ா","ஜ","ம","ி","ண","அ","க","�","ங","^"],"ngram_size":1,"dimension":100},{"language":"te","weights":[0.0104167,0.0208333,0.0104167,0.0104167,0.0104167,0.0208333,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0208333,0.0104167,0.0104167,0.0208333,0.0104167,0.0208333,0.0104167,0.0208333,0.0104167,0.0416667,0.0208333,0.0104167,0.0208333,0.0104167,0.0104167,0.0208333,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0104167,0.0208333,0.0104167,0.03125,0.0208333,0.0208333,0.0208333,0.0104167,0.0104167,0.0104167,0.0208333,0.0104167,0.0104167,0.0104167,0.0104167,0.0208333,0.0104167,0.0208333,0.0208333,0.0208333,0.0104167,0.0208333,0.0104167,0.0208333],"ids":[214,427,799,7,896,240,877,361,707,867,258,367,538,710,195,164,684,710,782,200,299,858,978,645,285,811,434,838,694,299,480,831,195,669,916,950,594,676,51,285,839,288,248,992,101,176,705,41,815,162,873,961,365,171,457,510,911,450,377,736,785,322,663,805,814,880,342,984,403,897,723],"ngrams":["వే","మ$","ిర","వద","ిశ","వి","ండ","�ం","^న","చ�","ేమ","�చ","భి","ల�","ామ","ిల","ేజ","తే","రి","ోగ","ల�","ాభ","శ�","�ల","యో","రా","జర","^$","^ర","�$","న�","డ�","^య","ంచ","ట�","దా","ూడ","త�","డ�","సి","చూ","రస","గ�","^చ","గి","ాజ","మర","ాన","నర","^మ","^వ","�వ","ర$","న$","చి","^�","ిం","�$","తత","�న","దన","ిట","^త","యగ","జయ","ి$","యి","వ$","ిన","^జ","^ద"],"ngram_size":2,"dimension":1000},{"language":"te","weights":[0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625,0.015625],"ids":[1102,3329,2614,3871,1272,1339,4563,850,1865,179,2920,4255,398,779,1066,645,4495,3943,3971,3368,4194,3403,757,4356,463,246,1215,4857,2725,1044,4013,3932,4230,2182,3636,1064,4942,4739,2533,3311,2891,157,1538,214,4510,23,2205,4615,1082,50,1348,3967,1533,1746,1089,2208,2935,58,3285,3057,3189,1277,324,948],"ngrams":["వేమ$","వినర","రామ$","ిరామ","ినర$","ాభిర","వదాభ","�వదా","ిశ�వ","^విన","విశ�","^విశ","ండ�$","తత�వ","న�ండ","ల�చ�","భిరా","శ�వద","జరిల","ేజరి","�చ�$","�ండ�","�ల�$","ట�ల�","యోగి","ిట�ల","యిట�","^యిట","^దాన","గ�న�","ోగి$","^వేమ","తేజర","జయోగ","ాజయో","ిల�ల","రాజయ","^రాజ","దాభి","^తేజ","�న�$","యగ�న","రిల�","^దనర","యించ","మరసి","త�వ$","^యగ�","చూడ�","^చూడ","రసి$","ూడ�$","దనర$","^న�ం","జయిం","^తత�","^మరస","చిన$","ల�ల�","ంచిన","�ల�చ","దాన$","ించి","^జయి"],"ngram_size":4,"dimension":5000},{"language":"te","weights":[0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0253165,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0253165,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0126582,0.0253165,0.0126582,0.0126582],"ids":[3878,2183,2436,3135,1962,1777,4542,4354,4805,4103,355,3073,617,4102,4238,3736,4362,3232,3931,4205,4160,3353,601,1870,2823,1004,291,1096,2259,889,1968,2932,4625,1580,1944,2095,1088,4482,834,4361,1720,3155,3696,4215,1388,898,3183,4859,1790,1197,4580,956,4246,4778,1283,906,1560,4752,799,2821,592,48,3144,3518,3705,730,3962,3247,1596,4937,110,1330,3584,846,787,1757],"ngrams":["వేమ","^వే","విన","రామ","ిరా","ాభి","దాభ","విశ","�వద","డ�$","న�ం","ేమ$","చ�$","�చ�","ిశ�","ల�ల","ిల�","తేజ","భిర","ల�$","ిట�","సి$","^యి","ల�చ","యోగ","�ండ","జయో","రాజ","జరి","ాజయ","^�$","�న�","గ�న","మరస","యగ�","ామ$","ాన$","^దా","చూడ","రసి","ినర","^తే","శ�వ","^వి","^తత","గి$","^జయ","^చూ","రిల","జయి","^మర","న�$","�వ$","^న�","త�వ","వదా","ోగి","దాన","ూడ�","ంచి","తత�","ట�ల","ిన$","నర$","^దన","చిన","దనర","ేజర","^యగ","ించ","ండ�","^రా","యిం","�ల�","డ�$","యిట"],"ngram_size":3,"dimension":5000},{"language":"te","weights":[0.00884956,0.00884956,0.0265487,0.00884956,0.00884956,0.0176991,0.0619469,0.0176991,0.00884956,0.00884956,0.0353982,0.0442478,0.0265487,0.079646,0.0530973,0.0176991,0.0176991,0.0353982,0.0265487,0.0530973,0.0265487,0.0265487,0.0353982,0.0265487,0.0176991,0.150442,0.150442],"ids":[1,41,73,16,38,90,3,76,99,83,5,51,15,31,84,86,5,17,52,76,54,53,85,20,87,68,52],"ngrams":["భ","శ","ల","ో","ట","ే","�","గ","స","ూ","�","వ","త","ి","ర","ం","డ","య","జ","న","మ","ద","ా","చ","�","$","^"],"ngram_size":1,"dimension":100},{"language":"tg","weights":[0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.0192308,0.0192308,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.0192308,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.0288462,0.00961538,0.00961538,0.00961538,0.00961538,0.0384615,0.0288462,0.0192308,0.0192308,0.00961538,0.0192308,0.0192308,0.0192308,0.0192308,0.00961538,0.0384615,0.00961538,0.00961538,0.00961538,0.0192308,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.0192308,0.0192308,0.0288462,0.0288462,0.0192308,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.0192308,0.00961538,0.00961538,0.00961538,0.00961538,0.0192308,0.00961538,0.0192308],"ids":[988,475,459,3,346,960,294,929,708,783,50,97,85,819,257,828,212,577,512,980,789,269,534,117,469,78,346,375,703,502,426,142,967,151,802,817,930,757,598,632,982,339,711,531,375,120,565,388,499,741,209,60,613,954,476,689,580,149,711,274,352,349,400,998,662,546,247,533,661,788,257,498,505,838],"ngrams":["те","и�","ри","га","ди","д$","ед","не","п$","оп","^ч","да","^к","ҷе","рҷ","фи","^т","чо","аа","тӣ","^д","па","дп","^н","м$","н$","зм","ҳ$","из","до","о$","ши","ов","фа","ар","а$","ба","он","н�","^б","а�","ир","^ф","ти","�т","жо","ӯ�","дӯ","^а","нд","ол","ин","на","^и","та","аж","ад","ат","ва","т$","^в","иг","аш","еҳ","ра","р$","ро","ку","�о","ун","ӣ$","од","ла","^$"],"ngram_size":2,"dimension":1000},{"language":"tg","weights":[0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889,0.0138889,0.0138889,0.0277778,0.0138889],"ids":[4252,345,4001,3600,2741,3555,1375,252,2502,4772,2518,698,1732,1955,4866,793,4274,4819,2419,751,4438,3641,1929,1321,4100,628,4823,4124,2647,1931,2593,627,4762,4258,1013,2032,1716,2145,3789,1718,1107,3765,2652,3583,1522,2265,2378,4341,2710,3814,1156,2156,4236,4567,1206,3364,4711,1596,2545,4319,3362,198,1564,1679,736,4503,860,4942,4353,2186],"ngrams":["ри�т","фири","^фир","гаро","тед$","дига","^диг","^ба$","рон$","нед$","унед","куне","^кун","аа�т","даа�","и�те","жодп","рҷеҳ","адол","^тар","игар","ӯ�ти","нажо","оват","дова","а�тӣ","^фаш","дода","ара�","ват$","дпар","одпа","ири�","ажод","^наж","пара","изм$","^дод","ра�т","�тӣ$","олат","арон","фаши","иро$","^бар","ашиз","тиро","тарҷ","шизм","�тир","бар$","^чоп","ндӯ�","лат$","�онд","чоп$","а�т$","адов","ин�о","^ин�","�тед","одаа","ондӯ","ҷеҳ$","^ва$","дола","н�он","дӯ�т","^адо","арҷе"],"ngram_size":4,"dimension":5000},{"language":"tg","weights":[0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0229885,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943,0.0114943,0.0114943,0.0229885,0.0114943,0.0114943],"ids":[2962,2058,3657,1720,3620,1683,2604,558,4197,4310,1994,878,4890,1590,3944,3070,1279,1579,4374,4839,2499,2747,3291,1816,3024,1026,1237,2415,408,4743,4558,4531,991,3638,3383,2151,2706,3333,4109,4204,4347,625,4935,1280,1315,1669,965,2326,3484,1783,3528,2487,2514,4240,755,724,804,2536,372,4384,2763,3844,120,1927,4654,303,290,3606,1486,2853,1078,2090,649,3461,4241,1375,2843,4241,3135],"ngrams":["�те","ри�","ири","аро","ига","ед$","кун","и�т","дод","рон","^до","диг","�т$","еҳ$","ҷеҳ","^та","нед","�тӣ","фир","дпа","одп","дӯ�","ажо","^ку","^на","дов","рҷе","зм$","чоп","ода","бар","�он","арҷ","он$","гар","жод","ат$","^ва","изм","адо","аши","фаш","ар$","^ба","^фи","лат","ндӯ","ара","а�т","тед","шиз","пар","ро$","онд","тир","^фа","уне","наж","тӣ$","^ин","иро","ра�","даа","ӯ�т","ола","тар","ин�","ба$","ова","оп$","аа�","ва$","�ти","^ди","ват","дол","^ад","^чо","н�о"],"ngram_size":3,"dimension":5000},{"language":"tg","weights":[0.00826446,0.00826446,0.00826446,0.00826446,0.0247934,0.00826446,0.140496,0.0495868,0.0247934,0.00826446,0.00826446,0.00826446,0.00826446,0.0165289,0.0165289,0.0165289,0.140496,0.0413223,0.00826446,0.0578512,0.00826446,0.00826446,0.00826446,0.0743802,0.0495868,0.0661157,0.0413223,0.132231],"ids":[15,79,39,64,30,70,52,98,10,76,81,85,79,53,41,26,68,49,80,20,70,50,44,10,82,15,81,63],"ngrams":["г","у","к","ҳ","е","ч","^","и","в","ҷ","ж","м","ш","ф","п","б","$","�","ӯ","т","ӣ","з","л","д","р","о","н","а"],"ngram_size":1,"dimension":100},{"language":"th","weights":[0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0222222,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0444444,0.0111111,0.0222222,0.0222222,0.0111111,0.0111111,0.0222222,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0222222,0.0111111,0.0111111,0.0111111,0.0111111,0.0222222,0.0333333,0.0111111,0.0111111,0.0111111,0.0222222,0.0222222,0.0111111,0.0222222,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111,0.0111111],"ids":[382,927,32,388,158,225,997,824,511,605,74,212,81,178,271,79,369,584,754,279,722,867,574,829,120,667,187,264,322,105,725,595,259,591,255,697,396,905,31,398,211,712,489,958,742,268,808,116,175,598,838,773,435,897,375,257,262,725,482,256,414,533,727,427,861,739,414,530,569,534,849,804,286,454,352,101],"ngrams":["ยว","บป","วั","งบ","่ม","ิ่","เพ","งเ","มา","อง","ต้","บต","นต","รั","ปร","ะป","จจ","เล","าจ","้น","อา","เน","�ล","^ท","นเ","ณา","รา","ฆษ","งโ","อ�","า$","โฆ","าน","ท่","�ท","มง","่า","จะ","ื้","นื","ตา","ัน","น้","��","นอ","าเ","พิ","ษณ","หน","ใน","^$","รื","า�","หร","�า","อห","หา","าย","ณร","ระ","^ห","้อ","้า","ือ","าร","น�","รค","ลื","นห","�ใ","ค้","าณ","ลง","ะม","ับ","^�"],"ngram_size":2,"dimension":1000},{"language":"th","weights":[0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.025,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125,0.0125],"ids":[1359,1125,2586,342,2397,360,3902,2412,4165,3718,1919,3198,1694,3713,3442,3956,1058,758,1632,1380,4001,1694,3671,3469,1436,3180,3082,1508,4417,2288,2073,493,1556,282,887,3670,958,580,4742,4164,1411,1672,1621,4069,369,2545,2364,2662,4455,2308,1659,2885,1436,4067,3138,2771,898,4929,1848,2018,4600,377,747,2420,1835,1252,4885,2897,3821,584,2417,3668,4365,1502,4645,2418,3571,4848,2440],"ngrams":["นตา$","ยวัน","ันตา","ายวั","รายว","ระมา","มงบป","ิ่มง","พิ่ม","เพิ่","งบปร","งเพิ","องเพ","ประม","ต้อง","บต้อ","ณราย","รับต","ะปรั","จะปร","วันต","จจะป","อาจจ","้องเ","นอาจ","่านอ","^ท่า","น�าร","ษณา$","้นหา","ฆษณา","ปรับ","ลงโฆ","ใน�า","งโฆษ","อ�ลง","ะมาณ","่านเ","ท่าน","หา�ท","านอา","โฆษณ","^หา�","าณรา","�ท่า","มาณร","นหา$","อหา$","่มงบ","้อหา","อหน้","นื้อ","บประ","ารค้","าเนื","ลือ�","รค้น","านเล","^��ใ","น้าเ","เลือ","หรือ","�ลงโ","้าเน","รือห","^หรื","ื้อห","าจจะ","ค้นห","�ใน�","ือหน","นเลื","เนื้","หน้า","ือ�ล","ับต้","�ารค","า�ท่","��ใน"],"ngram_size":4,"dimension":5000},{"language":"th","weights":[0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048],"ids":[4772,429,4765,1292,4102,2917,4754,1883,1917,981,828,2279,94,42,3309,4598,3117,2011,503,3073,4029,3466,56,2407,1515,1542,2507,2525,4147,4857,4101,982,3144,2164,926,2435,1728,1260,2613,2103,1893,3129,3326,467,4562,899,4999,730,1618,1621,2311,126,1497,1718,1868,3352,1681,1647,3048,3081,28,1133,1035,256,3268,3714,1889,354,3068,551,2035,3038,3828,2309,2229,1192,799,2192,4733,3349,2359],"ngrams":["ตา$","วัน","ยวั","ราย","มาณ","ะมา","ระม","งบป","มงบ","่มง","ิ่ม","พิ่","งเพ","าณร","องเ","บต้","จะป","าจจ","บปร","้อง","นอา","านอ","ฆษณ","เพิ","โฆษ","เนื","งโฆ","^หร","�ลง","าเน","เลื","ประ","ับต","�ใน","นเล","ะปร","อ�ล","านเ","นื้","่าน","ท่า","า�ท","นตา","^หา","้อห","^ท่","รือ","�ท่","หา�","ื้อ","รับ","ณา$","รค้","้าเ","�าร","น้า","อหน","ือ�","ายว","ือห","หน้","^��","หา$","นหา","ลือ","อหา","ต้อ","ปรั","น�า","จจะ","ษณา","ารค","ลงโ","ันต","ณรา","อาจ","้นห","หรื","ค้น","��ใ","ใน�"],"ngram_size":3,"dimension":5000},{"language":"th","weights":[0.0104167,0.0208333,0.0104167,0.0104167,0.0208333,0.0208333,0.0208333,0.03125,0.0104167,0.0208333,0.0208333,0.0208333,0.03125,0.0208333,0.0104167,0.03125,0.0625,0.0208333,0.0520833,0.0520833,0.125,0.0104167,0.0104167,0.0416667,0.0208333,0.0520833,0.0104167,0.0104167,0.0729167,0.0416667,0.03125,0.0104167,0.0625],"ids":[43,63,46,46,54,68,39,23,35,42,74,26,27,98,4,58,52,27,67,66,70,8,66,66,56,15,15,95,25,64,18,76,68],"ngrams":["ว","ม","พ","ย","ั","ต","ป","ง","ิ","ล","ท","ณ","เ","จ","ษ","ื","^","บ","ห","ร","า","ค","�","้","ะ","อ","ฆ","ใ","น","�","่","โ","$"],"ngram_size":1,"dimension":100},{"language":"tr","weights":[0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.0179641,0.00598802,0.00598802,0.00598802,0.011976,0.00598802,0.00598802,0.00598802,0.00598802,0.00598802,0.0179641,0.011976,0.0179641,0.011976,0.00598802,0.011976,0.011976,0.00598802,0.00598802,0.0299401,0.011976,0.011976,0.00598802,0.00598802,0.0179641,0.00598802,0.00598802,0.00598802,0.011976,0.0179641,0.011976,0.011976,0.00598802,0.011976,0.00598802,0.011976,0.011976,0.00598802,0.00598802,0.00598802,0.0179641,0.0239521,0.011976,0.00598802,0.00598802,0.00598802,0.011976,0.00598802,0.0179641,0.0179641,0.0239521,0.011976,0.011976,0.0179641,0.011976,0.00598802,0.00598802,0.00598802,0.00598802,0.011976,0.00598802,0.0179641,0.00598802,0.0239521,0.0179641,0.00598802,0.00598802,0.011976,0.0239521,0.00598802,0.00598802,0.011976,0.00598802,0.011976,0.0239521,0.0239521,0.00598802,0.011976,0.011976,0.00598802,0.00598802,0.0179641],"ids":[23,927,490,732,265,32,980,862,404,175,273,532,265,110,104,848,62,719,28,193,137,999,230,541,30,248,251,269,960,819,571,353,978,694,153,147,500,203,575,559,632,803,977,34,279,327,645,734,989,237,91,545,809,486,220,123,747,356,854,183,985,744,707,998,493,925,61,367,378,640,404,875,125,31,162,522,453,852,96,651,485,385,549,190,503,285,71,925,109,230,116,410,895,838,80,875,8],"ngrams":["u$","mu","um","su","kl","ık","^t","^d","ec","il","eb","^s","re","zd","öz","i$","zi","tı","çe","le","tç","ge","bü","gü","ze","n$","ny","an","pa","ük","mp","er","bi","ğe","en","ka","eğ","lü","^e","çi","ör","di","yi","iç","nı","r$","^i","et","a$","ne","ve","ir","nd","^b","yö","^y","z$","me","tm","ön","ri","gö","ce","ay","in","^g","^k","ı$","la","rı","zı","un","dü","ği","ız","ye","ın","üt","ni","e$","üz","de","nl","ya","eç","rm","^v","yı","rl","iz","ar","ün","am","^$","nu","k$","^a"],"ngram_size":2,"dimension":1000},{"language":"tr","weights":[0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.0243902,0.0162602,0.00813008,0.00813008,0.0162602,0.0162602,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.0243902,0.00813008,0.0162602,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.0162602,0.00813008,0.00813008,0.00813008,0.00813008,0.0162602],"ids":[3837,4372,318,4112,1582,3705,4519,2937,4857,503,1828,1307,2280,3353,4237,4916,1820,4672,2104,2293,714,688,2742,950,1468,1940,1404,2210,3161,729,3728,4908,1154,1371,3631,4572,3513,3858,908,3009,3438,1273,664,2997,2990,3143,222,4037,823,1147,1480,38,1913,619,117,518,3476,4667,4758,1982,4483,109,2093,1670,4940,3152,2465,4681,3734,1168,3226,483,2755,4297,3510,3849,876,2025,4703,4062,2162,3086,1055,1361,3269,4974,3837,4562,1834,629,427,3766,2556,4624,1563,569,1786,2794,2707,2258,2716],"ngrams":["umu$","numu","sunu","yanı","yın$","layı","çire","klay","ıkla","kamp","tıkl","^tık","^yi$","enle","zenl","meni","nya$","ampa","^yer","bile","ğini","zden","eğin","ceği","lük$","özde","eceğ","^eğe","ndir","lece","düze","ilec","eçir","rebi","ebil","yeri","ireb","^geç","geçi","den$","gözd","izi$","çeni","unum","tçen","ınız","ütçe","yarl","pany","ünlü","çin$","nız$","anız","nizi","arla","günl","iniz","ğer$","ını$","dir$","^ve$","çind","eğer","nlük","^düz","rını","eniz","^kam","eri$","indi","ları","için","nızı","^içi","bütç","tmen","etme","mpan","önet","^göz","niz$","netm","rlar","arın","rmen","örme","^gör","^büt","ızı$","üzen","görm","anya","nle$","^gün","^yön","ayar","nyan","^sun","yöne","ayın","^aya"],"ngram_size":4,"dimension":5000},{"language":"tr","weights":[0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.0138889,0.0138889,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.0138889,0.0138889,0.0138889,0.00694444,0.00694444,0.0138889,0.0138889,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.00694444,0.0277778,0.0138889,0.00694444,0.0208333,0.0138889,0.00694444,0.00694444,0.0138889,0.0208333,0.0138889,0.00694444,0.00694444,0.0138889,0.00694444,0.0138889,0.0138889,0.0138889,0.0138889,0.0138889,0.00694444,0.00694444,0.00694444,0.0138889,0.00694444,0.00694444,0.00694444],"ids":[2474,2585,885,1943,1344,2583,3499,4975,1401,4400,1822,4942,4497,4839,3878,2861,2085,4607,4066,4607,2239,1590,2394,503,4621,4856,780,863,4331,2388,2766,2143,2148,503,5,4562,428,1490,3966,214,4184,2887,2550,3815,2337,4962,4261,112,4799,2964,2010,1620,4134,138,3088,552,3299,2001,1793,2229,2204,790,4257,4483,116,1558,1195,813,3149,4771,2949,4900,3439,2882,3903,4872,3454,4333,319,3500,3858,2738,4258,82,1967,2514,1740,1150,1377,1573,3643,4162,4654,4806,3406,4090,1914,3062,318,615,984,3197,3271,1849,3792,2241,1028,2494,3308,1647,515,2428,1256],"ngrams":["sun","^su","ın$","unu","kla","ıkl","tık","^tı","yi$","nle","^dü","ya$","le$","aya","yer","ini","eri","ğin","eği","ece","bil","^ve","reb","yön","ire","çir","ile","nı$","eçi","lay","ir$","^ge","mu$","en$","üze","den","zde","çen","ütç","rme","büt","ri$","^bü","ük$","umu","nlü","^ye","gün","ünl","yar","anı","enl","lük","any","num","yan","mpa","özd","zen","kam","pan","eğe","^eğ","dir","etm","ndi","çin","ceğ","tçe","rın","içi","^iç","net","yın","nya","amp","ind","öne","er$","lec","^yö","^yi","in$","ğer","ızı","geç","ayı","niz","ve$","düz","eni","lar","ız$","tme","^ay","iz$","^gö","örm","izi","ını","zi$","nız","arl","^ka","rla","men","göz","zı$","gör","arı","^gü","^a$","ebi"],"ngram_size":3,"dimension":5000},{"language":"tr","weights":[0.0157895,0.00526316,0.0210526,0.00526316,0.0105263,0.0421053,0.0894737,0.0157895,0.0105263,0.0315789,0.0105263,0.0789474,0.0157895,0.0842105,0.121053,0.0421053,0.0157895,0.0105263,0.0210526,0.0421053,0.0210526,0.121053,0.0263158,0.0210526,0.0473684,0.0736842],"ids":[59,44,43,58,86,65,20,21,77,2,57,66,0,79,68,86,28,11,37,19,19,52,0,88,24,96],"ngrams":["u","s","ü","c","ğ","y","n","t","p","l","v","i","d","e","$","z","ö","b","ç","ı","k","^","m","g","r","a"],"ngram_size":1,"dimension":100},{"language":"uk","weights":[0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0225564,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0150376,0.0075188,0.0150376,0.0075188,0.0150376,0.0075188,0.0150376,0.0150376,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0225564,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0150376,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0150376,0.0075188,0.0075188,0.0075188],"ids":[304,444,544,711,689,400,476,555,93,922,965,250,589,370,375,408,56,835,266,931,461,968,508,523,789,816,119,895,997,97,325,927,802,274,788,341,589,949,130,430,975,154,837,425,694,960,922,461,339,352,324,978,357,135,983,988,750,149,4,549,47,459,648,25,499,469,814,871,618,782,838,890,661,799,429,531,264,279,544,95,404,585,547,4,423,310,750,145,920,425,126,42,651,755,247,721,15,856,565,142,872,498,108,662,632,391,728,817,892,716,868],"ngrams":["�м","н�","ан","ва","шу","аш","та","зт","^р","ни","^п","бу","чн","іч","�т","аф","оз","ео","^г","що","^�","ю$","бю","фі","^д","�в","ї$","об","ге","да","е$","ум","ви","т$","�в","нн","уй","им","гр","жу","к�","д�","еж","хо","то","д$","ак","ре","ві","^в","дж","в$","ез","ів","же","те","ід","ат","иб","б$","ог","ри","бі","пр","^а","м$","ді","�и","ув","ма","^$","і$","�о","ер","и$","ти","йт","кі","ит","^з","^�","ех","чи","пе","^о","зп","^м","ої","во","бе","ою","ий","еч","юд","ро","аб","тк","за","ль","ши","ьш","од","му","ра","^б","^щ","іл","а$","ут","ет","й$"],"ngram_size":2,"dimension":1000},{"language":"uk","weights":[0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263,0.0210526,0.0105263,0.0105263,0.0105263,0.0105263,0.0105263],"ids":[1266,2223,4560,1961,3092,1275,2900,2224,2941,1370,1270,4748,1627,3259,4025,195,134,1372,4557,914,1174,2324,155,4015,217,2750,1672,699,4979,3129,1660,3818,3976,2566,2104,2559,4366,4762,2072,3073,318,1223,399,4002,258,3230,4934,1447,1276,1249,4865,3876,1064,2108,1589,208,3368,2432,4841,3415,715,4382,2867,1658,813,2446,3979,4541,1891,1746,1991,4202,1643,4585,2946,2476,1681,4764,4744,1666,1697,4932,4089,4634,800,3373,2509,3080,3922,3811,2811,4568,3372,3303],"ngrams":["н�м$","уван","ашув","ташу","фічн","рафі","граф","огра","еогр","геог","афіч","дато","^дат","�ви$","атою","^�ви","шува","^�во","нн�м","ічни","�теж","одів","^гео","ході","озта","розт","ним$","еход","від$","бюдж","ків$","ибут","ерех","^біл","чити","ак�и","рибу","к�им","анн�","^за$","мак�","обі$","^�об","бутк","жет$","пере","печи","абез","^об$","забе","ечит","ший$","^пер","від�","^бюд","щоб$","тежу","�обі","^щоб","джет","жуйт","ежуй","юдже","вої$","ід�т","безп","^заб","тою$","рехо","ванн","уйте","мум$","^роз","зпеч","тків","приб","йте$","біль","�вої","дів$","ити$","зташ","уткі","^мак","�иму","льши","чним","ьший","^від","ільш","д�те","езпе","^при","имум"],"ngram_size":4,"dimension":5000},{"language":"uk","weights":[0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.0176991,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956,0.00884956],"ids":[2381,1149,2251,3673,3743,4821,4551,330,1377,2061,925,2841,3450,2464,3243,2987,1586,3430,1624,2402,1875,3590,2945,1128,3306,542,111,4455,256,1594,4916,1097,1976,1197,3482,753,4685,3228,3239,4123,4894,2366,3952,997,771,2715,1733,2962,2760,2987,3514,2253,3259,3044,4888,515,3671,4066,4823,2813,1410,4029,416,3618,901,3620,4191,175,4262,3587,4069,1062,2497,3387,2282,4176,2010,2973,1521,2940,4623,781,217,2477,1120,2079,2578,1881,3872,801,3177,4809,1029,1653,2677,3654,2117,3292,1342,2494,3011,1947,3350,3778,1966,3342,2030,2561],"ngrams":["�м$","н�м","нн�","анн","ван","ува","шув","ашу","озт","роз","ший","ним","еог","фіч","им$","без","афі","раф","огр","ід$","від","гео","ою$","заб","ів$","ато","теж","^да","ий$","�об","ви$","риб","�ви","�во","ід�","^�в","ої$","за$","д�т","таш","ічн","чит","вої","^об","дів","ежу","оді","�те","ехо","рех","ере","пер","^пе","^ро","ткі","^що","гра","те$","^�в","ибу","юдж","печ","^пр","^а$","мум","к�и","щоб","мак","^ві","ити","дже","^ма","дат","бі$","біл","ти$","ечи","зта","зпе","тою","ет$","�им","^за","ків","обі","утк","^�о","при","уйт","жет","льш","ум$","езп","бут","об$","^бю","иму","жуй","бюд","ьши","абе","йте","^ге","ак�","чни","іль","ход","^бі"],"ngram_size":3,"dimension":5000},{"language":"uk","weights":[0.0196078,0.0130719,0.0130719,0.00653595,0.00653595,0.0261438,0.0261438,0.0457516,0.0130719,0.0326797,0.0457516,0.130719,0.0457516,0.0130719,0.0457516,0.0522876,0.00653595,0.0130719,0.0326797,0.130719,0.0261438,0.0130719,0.00653595,0.0130719,0.0522876,0.0130719,0.00653595,0.0261438,0.00653595,0.0196078,0.0457516,0.0522876],"ids":[81,15,32,30,52,82,79,34,39,85,10,52,98,70,20,30,10,81,10,68,49,89,53,79,15,36,54,50,44,41,26,63],"ngrams":["н","г","�","ї","х","р","у","і","к","м","в","^","и","ч","т","е","щ","ж","д","$","�","ю","ф","ш","о","й","ь","з","л","п","б","а"],"ngram_size":1,"dimension":100},{"language":"ur","weights":[0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0136054,0.0136054,0.00680272,0.00680272,0.00680272,0.0136054,0.0136054,0.0136054,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0272109,0.00680272,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.0204082,0.00680272,0.00680272,0.00680272,0.0340136,0.00680272,0.0136054,0.00680272,0.00680272,0.0136054,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.00680272,0.0204082,0.0136054,0.0136054,0.0340136,0.00680272,0.0272109,0.00680272,0.0136054,0.0136054,0.00680272,0.0136054,0.0136054,0.0136054,0.00680272,0.0136054,0.0204082,0.00680272,0.0816327,0.00680272,0.00680272,0.0136054,0.00680272,0.0136054,0.00680272,0.0340136,0.00680272,0.00680272,0.0136054,0.0204082],"ids":[645,459,751,26,566,871,943,283,94,458,740,420,902,912,846,218,740,523,836,199,794,871,475,684,179,220,522,214,315,558,922,99,323,552,441,404,488,838,952,984,897,769,287,115,148,310,36,709,900,468,236,447,707,833,340,709,124,898,177,101,743,513,220,737,270,257,51,429,391,66,510,140,216,976,936,397,135,220,227,625,968,261,403,755,263,703,954,8],"ngrams":["^ش","او","لر","نے","^ڈ","مر","ک$","ل�","�ی","مت","قی","اد","زی","^ز","اگ","یں","ری","ض$","رض","^ت","�ر","ور","طو","کے","ل$","مم","ال","یک","یم","قم","ثا","مث","رن","کی","ت$","ج$","س$","^$","اس","�ے","ح$","کر","^ق","رج","^ط","ی$","مک","^س","تا","تو","�ک","^چ","گر","ا$","^ر","ام","ں$","ن�","ڈا","�$","آپ","^�","ے$","کن","^ا","شر","د�","^م","ار","یا","^آ","^�","رح","سے","م$","رت","^ک","چا","^پ","کل","رق","کم","�و","ر$","پر","کو","پ$","و$"],"ngram_size":2,"dimension":1000},{"language":"ur","weights":[0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0136986,0.0273973,0.0273973,0.0136986,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0273973,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0410959,0.0136986,0.0273973,0.0136986,0.0273973,0.0136986,0.0136986,0.0136986],"ids":[3788,1011,4362,3404,422,1068,2569,4824,2459,3365,1601,3055,1400,21,2945,3807,2903,1994,2595,3817,2142,2722,4061,3542,523,2891,3432,4762,2176,3934,2954,2985,1022,140,2507,1714,2371,478,2304,1727,2969,652,2675,1892,3948,1702,1330,2138,2668,1709,2662,2293,934,4496,487,1981,3704,4944,3513,1679,513],"ngrams":["^تو$","شرح$","رنے$","کرنے","^کرن","الر$","ڈالر","^�و$","یکی$","مریک","امری","کن�$","ل�ک$","^ڈال","کرتا","اد�$","زیاد","^�ی$","^زیا","اگر$","مکن�","^اگر","کریں","ریکی","^کے$","^کری","^کل�","�رض$","^�رض","^پر$","طور$","مثال","ریں$","^طور","کل�ک","^ممک","^آپ$","^سے$","^اس$","یمت$","^کرت","^رقم","^�ے$","ارج$","ثال$","ممکن","رتا$","^شرح","^اور","^کو$","چارج","^چار","^امر","^کی$","قیمت","یاد�","اور$","^کم$","^مثا","^قیم","رقم$"],"ngram_size":4,"dimension":5000},{"language":"ur","weights":[0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.0183486,0.0183486,0.0183486,0.00917431,0.00917431,0.00917431,0.0183486,0.0183486,0.0275229,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.0183486,0.0183486,0.00917431,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.0366972,0.00917431,0.0183486,0.00917431,0.0275229,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.0183486,0.00917431,0.0183486,0.00917431,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.0183486,0.00917431,0.0183486,0.00917431,0.00917431],"ids":[4235,1453,499,3264,4633,1249,2129,3581,320,2620,1277,4328,1465,2099,3580,833,4600,2285,919,3268,2159,1097,532,432,1927,2409,4248,3761,4039,18,3559,1090,1913,246,124,4494,828,2362,4143,3953,63,4454,493,2961,3518,4088,3021,766,1446,1020,4471,2970,2878,3830,3659,3224,1033,4666,236,4284,4839,3881,4260,4359,4719,4493,2737,3731,1550,3710,1638,1642,3662,4908,3345,4887,4703,497,2941,1322,3151,827,3110,1988,3962,4666],"ngrams":["^�و","رح$","^شر","نے$","رنے","اور","^او","لر$","الر","ڈال","یکی","�ک$","ل�ک","کل�","^�ی","یمت","^قی","زیا","^زی","^کر","یں$","قیم","مثا","کری","کن�","�رض","^�ر","^ڈا","پر$","امر","^کم","ور$","^پر","�ے$","^طو","^آپ","^کے","شرح","سے$","ال$","ثال","^مث","رض$","قم$","کی$","^ام","^کل","اگر","^کی","اس$","^اس","گر$","رتا","رقم","ریں","ن�$","^اگ","ارج","اد�","^�ے","مت$","^چا","چار","مری","کے$","^رق","کرت","تو$","تا$","ممک","مکن","ریک","کم$","�و$","یاد","کو$","^تو","رج$","آپ$","^مم","کرن","د�$","طور","^سے","�ی$","^کو"],"ngram_size":3,"dimension":5000},{"language":"ur","weights":[0.00540541,0.00540541,0.0108108,0.0108108,0.0108108,0.00540541,0.00540541,0.0216216,0.0540541,0.00540541,0.00540541,0.00540541,0.0162162,0.00540541,0.0540541,0.0108108,0.205405,0.0108108,0.0702703,0.0108108,0.00540541,0.0162162,0.0108108,0.0432432,0.0864865,0.0162162,0.00540541,0.027027,0.205405,0.027027,0.027027],"ids":[29,81,37,70,97,85,52,87,56,9,88,47,2,29,40,92,68,14,6,0,19,78,14,84,1,63,89,96,52,88,14],"ngrams":["ح","ڈ","�","د","ز","ں","ط","ل","ی","ث","ش","ض","ت","ج","ا","�","$","ق","ر","آ","گ","س","ن","م","ک","پ","چ","ے","^","�","و"],"ngram_size":1,"dimension":100},{"language":"uz","weights":[0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00790514,0.00395257,0.00395257,0.00395257,0.00790514,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.0118577,0.00790514,0.00395257,0.00790514,0.00395257,0.00790514,0.00790514,0.00790514,0.00790514,0.00395257,0.0118577,0.00790514,0.0118577,0.00395257,0.00790514,0.00395257,0.00395257,0.00790514,0.00395257,0.0118577,0.0197628,0.00395257,0.00395257,0.0158103,0.0197628,0.00395257,0.0197628,0.0118577,0.00395257,0.00790514,0.00790514,0.0158103,0.00395257,0.00790514,0.0118577,0.00395257,0.0158103,0.00395257,0.0118577,0.0197628,0.00790514,0.0197628,0.00395257,0.00395257,0.00790514,0.00790514,0.00395257,0.0118577,0.00395257,0.00790514,0.00790514,0.00395257,0.00790514,0.00395257,0.00395257,0.00395257,0.00395257,0.00790514,0.00395257,0.00395257,0.00395257,0.00790514,0.00790514,0.00395257,0.00395257,0.00395257,0.00395257,0.00395257,0.0355731,0.00790514,0.0118577,0.00395257,0.00790514,0.0158103,0.0158103,0.00790514,0.00395257,0.0158103,0.00395257,0.00395257,0.00790514,0.00395257,0.0197628,0.00395257,0.00790514,0.00395257,0.0118577,0.0118577,0.0158103,0.00395257,0.00395257,0.00395257,0.00790514,0.00395257,0.0158103,0.00395257,0.00790514,0.00395257,0.00790514,0.00790514,0.00790514,0.0118577,0.00395257,0.00395257,0.0237154,0.00395257,0.00790514,0.00395257,0.00395257,0.00790514],"ids":[568,834,83,113,937,752,657,484,353,780,71,126,925,844,67,613,630,826,532,994,977,327,109,545,757,403,836,726,98,795,879,496,841,248,152,564,620,927,125,875,481,486,391,672,300,123,891,793,887,786,96,575,307,754,200,490,763,532,575,62,540,157,976,88,8,75,296,980,41,772,355,689,671,116,307,819,147,153,549,385,601,18,804,212,314,985,809,605,517,19,501,989,146,144,265,605,939,493,156,27,998,67,246,237,122,848,285,364,940,770,175,89,778,893,585,766,895,500,58,269,887,190,215,378,803,241,353,526,854,885,877,933,838],"ngrams":["nn","yd","ul","bu","og","ha","ch","rc","^h","va","^v","gr","^g","uz","lm","t$","at","ko","^s","iq","yi","r$","rl","ir","ek","mk","zb","nm","ik","ai","ra","kr","id","n$","qi","ki","tg","mu","ji","k$","hi","^b","ga","da","m$","^y","^q","to","oj","is","ni","rd","fg","af","st","um","ad","o$","oy","zi","os","na","^o","az","^a","pr","rk","^t","ma","zy","^m","ht","^z","ar","yy","li","ka","en","nl","de","ho","as","h$","^p","l$","ri","nd","ng","mi","ol","ba","a$","or","be","re","y$","sh","in","qd","si","ay","nt","qs","qa","ld","i$","rm","uk","yl","g$","il","iy","ru","mo","aq","ab","am","yo","uh","an","oz","ya","ta","la","di","oq","er","on","^n","^u","ez","ti","^$"],"ngram_size":2,"dimension":1000},{"language":"uz","weights":[0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.0106952,0.0106952,0.00534759,0.0106952,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0213904,0.00534759,0.0106952,0.00534759,0.0106952,0.00534759,0.0213904,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.0106952,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759,0.00534759],"ids":[2064,1706,4282,1290,1439,3070,4181,69,989,124,595,4898,225,1884,3664,2326,4681,2456,4785,3598,3893,4088,923,4074,2627,1351,925,2959,4182,3603,4859,1159,2056,4015,1284,4326,1663,2065,1098,2307,4901,1284,2565,1208,359,998,258,2369,2044,1318,282,3572,372,1879,4946,427,1946,4542,4005,2947,2924,1007,4819,4735,3852,747,3862,3543,73,2716,3090,3223,3655,4583,3999,794,2308,3141,3209,3447,2582,2365,4091,1156,4881,4011,3357,2934,497,2202,1034,2810,513,2171,3854,4602,1055,4581,4852,3640,1240,2450,3163,2850,2377,4125,593,2010,586,2371,815,3331,1902,1530,937,2639,1165,3949,367,2485,4010,460,1669,4051,4350,655,1297,654,1190,1483,3957,4655,4895,813,2771,550,1220,4159,628,2842,4366,3500,1358,3819,4985,1252,2856,1266,807,3349,2496,3885,4525,2891,4010,157,4500,596,784,4543,3368,3104,477,4935,4564],"ngrams":["onni","tonn","ton$","nmay","ilin","mayd","bul$","qabu","nato","^nat","cha$","zirc","^hoz","ina$","^va$","abul","ziya","uziy","ruzi","gruz","ozir","qda$","moqd","lmoq","qilm","^qil","yat$","oyat","rcha","ikoy","toga","hozi","hiko","shik","^gru","^shi","dan$","iqda","zyiq","azyi","tazy","qdan","ojir","uhoj","muho","atog","lik$","iril","nlik","onli","zbek","irch","^osi","onis","^zbe","rezi","aina","krai","shi$","oqda","rish","iya$","eris","orda","^ber","^ayo","beri","^qan","dam$","nday","ada$","anda","^taz","qand","nga$","onga","ziy$","tong","ston","ydi$","nist","prez","afg$","hoji","isto","iyo$","siyo","mumk","jirl","osiy","kist","rkaz","^aqs","^afg","arka","rdam","rlar","tga$","rild","qsh$","ilmo","yol$","nada","mark","inma","rmi$","tayy","badi","abad","ormi","yyor","koya","asht","ayyo","inad","yiqd","yord","iden","^tay","irla","kin$","dent","^yor","qili","zide","ntga","ekis","^pre","yorm","entg","mkin","ldi$","beki","ezid","nni$","aydi","ukra","^mar","^muh","tiri","aziy","^oni","linm","kazi","ildi","^qab","lar$","ayol","ishi","^ukr","iyla","aqsh","day$","htir","ylas","rain","umki","shti","lash","oga$","diyl","adiy","tonl","^mum","^aba"],"ngram_size":4,"dimension":5000},{"language":"uz","weights":[0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00913242,0.00456621,0.00913242,0.00913242,0.00456621,0.00913242,0.00913242,0.00913242,0.00913242,0.00913242,0.00456621,0.00913242,0.00456621,0.00456621,0.00456621,0.00913242,0.00913242,0.00456621,0.00456621,0.00456621,0.00913242,0.00456621,0.00913242,0.00456621,0.00456621,0.00913242,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00913242,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.0182648,0.00456621,0.0182648,0.00913242,0.0182648,0.00913242,0.00456621,0.00456621,0.00456621,0.00913242,0.00456621,0.00913242,0.00913242,0.00456621,0.00456621,0.00913242,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00913242,0.0136986,0.00456621,0.00913242,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00913242,0.00456621,0.00456621,0.00456621,0.00456621,0.00913242,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00913242,0.00913242,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00913242,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00456621,0.00913242,0.00456621],"ids":[2267,1469,4410,3172,3080,3517,4833,4348,1363,641,4447,1633,2241,1695,4942,4673,2060,2570,4808,1892,2629,4513,3767,3382,3524,2468,3239,3619,2732,1475,4017,4162,3792,389,3066,177,3875,2482,4625,4351,60,2720,273,2168,791,3915,844,1409,1459,2581,2272,144,4953,3266,904,3753,2130,1302,3663,3159,1270,2078,933,1687,2875,3851,230,75,996,4448,222,4366,1711,4252,4182,660,4079,1544,4156,436,2903,361,2345,4697,1003,2085,4882,4017,1881,1730,1079,2290,4722,4975,404,3499,1144,1099,3606,3164,2416,568,2384,154,4562,610,2528,1936,872,4258,326,6,1912,497,2608,4207,352,1955,4362,1947,2019,4058,1832,3939,2996,4561,1078,4997,742,1504,3490,964,3814,3347,689,4608,468,2260,3918,3634,1365,4722,3418,1439,4243,4083,2120,2407,2096,4823,4919,4058,1255,3406,4920,1645,4275,3681,1048,3834,3910,4964,1749,4839,527,2855,2797,3280,1655,1313,3204,2437,1552,4486,1249,442,61,1755,1102],"ngrams":["on$","ydi","ayd","nma","bul","abu","tog","ha$","cha","rch","zir","ili","hoz","va$","ya$","na$","ruz","^gr","lmo","ilm","at$","yat","koy","iko","hik","^sh","an$","dan","^ho","taz","ar$","lar","rla","onn","oqd","jir","oji","uho","ni$","muh","ik$","qil","lik","kis","eki","^na","bek","zbe","^zb","^o$","da$","nad","kra","iyl","sht","ayy","ukr","ina","kin","nli","las","^mu","tga","rai","lin","ato","nis","rka","am$","mki","rda","ord","nda","ziy","qan","iri","iyo","ong","ol$","ton","ide","sto","yor","ist","oni","eri","ul$","qsh","^on","qab","^af","shi","siy","nga","afg","may","osi","hi$","^yo","uzi","moq","azy","^os","onl","den","umk","azi","^ma","ash","in$","rmi","^va","sh$","day","ain","ga$","^g$","^uk","^ab","irc","ris","dam","tay","ent","inm","ntg","kaz","iya","mum","yiq","hoj","ay$","iy$","zid","bad","pre","ozi","^be","yyo","rez","ark","fg$","nat","^pr","iqd","ayo","^ta","^aq","zyi","yo$","tir","ldi","nni","^ay","qda","^qa","orm","aqs","mi$","ild","ril","mar","^qi","diy","yla","hti","ish","oga","yol","oya","irl","and","ezi","adi","gru","ada","ber","di$","aba"],"ngram_size":3,"dimension":5000},{"language":"uz","weights":[0.00348432,0.00348432,0.00348432,0.0348432,0.0522648,0.0418118,0.0243902,0.0418118,0.0627178,0.0243902,0.0278746,0.118467,0.00348432,0.0278746,0.0278746,0.0243902,0.0174216,0.0313589,0.0209059,0.0174216,0.097561,0.111498,0.00696864,0.118467,0.0243902,0.0313589],"ids":[58,5,77,21,20,65,12,24,22,63,19,52,57,2,0,88,79,0,59,11,66,96,22,68,86,44],"ngrams":["c","j","p","t","n","y","q","r","o","h","k","^","v","l","m","g","e","d","u","b","i","a","f","$","z","s"],"ngram_size":1,"dimension":100},{"language":"vi","weights":[0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.00952381,0.0047619,0.00952381,0.0047619,0.0047619,0.0047619,0.0190476,0.00952381,0.0047619,0.00952381,0.0047619,0.0047619,0.0047619,0.0047619,0.0190476,0.0047619,0.0047619,0.00952381,0.0047619,0.0142857,0.0047619,0.0047619,0.0047619,0.00952381,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0190476,0.0047619,0.00952381,0.0047619,0.0238095,0.00952381,0.0047619,0.0047619,0.0047619,0.00952381,0.0190476,0.0047619,0.0238095,0.00952381,0.047619,0.0047619,0.00952381,0.00952381,0.0142857,0.00952381,0.00952381,0.0047619,0.0047619,0.00952381,0.0047619,0.0047619,0.00952381,0.00952381,0.0047619,0.0190476,0.00952381,0.0238095,0.0380952,0.0047619,0.00952381,0.0333333,0.0190476,0.0047619,0.0142857,0.00952381,0.00952381,0.0047619,0.0047619,0.0285714,0.0047619,0.00952381,0.0047619,0.0047619,0.00952381,0.00952381,0.00952381,0.0047619,0.00952381,0.0047619,0.0047619,0.00952381,0.0047619,0.0047619,0.0047619,0.0047619,0.0047619,0.0190476,0.0047619,0.0047619,0.0047619,0.0047619,0.0190476,0.00952381],"ids":[288,484,205,501,989,590,273,717,269,879,365,590,349,819,875,793,83,487,248,376,520,410,353,153,111,656,752,506,885,134,880,804,457,212,672,300,652,758,538,302,603,260,535,168,933,980,98,355,170,657,164,556,998,750,319,303,807,888,481,476,783,170,815,854,847,493,824,651,557,943,217,768,359,467,798,823,848,770,312,517,605,736,99,977,22,514,613,996,862,430,364,384,480,803,218,8,371,601,885,763,532,23,347,616,605,153,637,71,486,712,61,112,838],"ngrams":["̉$","ể","đê","ba","a$","b$","eb","^w","an","ra","tr","̣u","se","li","un","̃$","̉a","ữ","n$","ạ","̀n","em","^h","ơn","�i","ừ","ha","tư","�$","p$","ph","h$","̣c","^p","da","m$","^ô","�n","̃n","̉i","dư","hô","^l","kg","ti","^t","nô","^m","ủ","ch","ụ","ô$","ay","xa","đô","c$","ị","^đ","hi","^c","đă","â�","ộ","^n","câ","in","ệ","e$","cu","iê","đơ","ca","i�","̣i","�c","à","i$","g$","ã","mi","ng","a�","ặ","^x","xe","du","t$","ds","^d","ổ","̀$","ns","ô�","di","�p","^a","̣t","ho","̣$","ad","o$","u$","th","vu","y$","en","nh","^v","^b","we","^k","̣n","^$"],"ngram_size":2,"dimension":1000},{"language":"vi","weights":[0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.0163934,0.0163934,0.00819672,0.0163934,0.00819672,0.0163934,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.0163934,0.00819672,0.00819672,0.0163934,0.00819672,0.0245902,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.0163934,0.0163934,0.00819672,0.0163934,0.00819672,0.00819672,0.00819672,0.00819672,0.0163934,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.0327869,0.0163934,0.0163934,0.00819672,0.00819672,0.00819672,0.00819672,0.00819672,0.0163934,0.00819672,0.0163934,0.00819672,0.00819672,0.00819672,0.00819672],"ids":[870,577,2359,1062,4164,201,1197,3281,458,4195,2216,4365,2113,1791,2620,2910,1359,4773,2666,3466,2038,2935,1330,4391,2932,724,1720,4322,2994,3399,702,1147,2394,670,4062,4971,1664,2266,2609,2521,2560,1063,4961,1043,4764,2388,1286,2936,2901,3994,1938,2938,3694,2476,3753,1544,4957,957,1182,1542,3343,3551,313,2850,2762,1541,3071,3403,625,3031,2021,319,1725,1286,4103,3592,1438,3013,1996,3552,686,3709,1283,1623,1471,1201,1423,3208,1201,4862,309,528,439,2364,2888,4266,788,4297,4245,1581,1608,1592,4277],"ngrams":["để$","^để","ạn$","bạn","rang","web$","^web","ense","ang$","^a�c","liệ","^liê","dữ$","ặt$","^đơn","^đổ","của","ô�i$","hô�i","chô�","đơn$","^chô","^đặ","xa�c","^từ","hi�$","dạn","chi$","^phi","đặt","^chi","xem$","^xem","^củ","ca�c","hà$","^ca�","tran","dụn","ệu$","^kg$","nhã","ãn$","đổi","^tha","nội","i�n$","^dạ","ụng","ti�n","ội$","độn","^ti�","thay","nse$","hãn","inh$","^bạ","̀ng$","minh","^xa�","̣ng$","iệu","^tra","̣ch$","àng","ộng","adse","^vụ","^dụ","dịc","^cho","â�p$","^dun","câ�p","vụ$","^độ","hàn","hay$","^câ�","^ads","dung","sens","cung","ịch","^cun","^dị","ạng","a�c$","ung$","^nha","ủa$","từ$","ổi$","^nộ","nhà","cho$","^dữ","^min","dsen","phi�","^di$","^hà"],"ngram_size":4,"dimension":5000},{"language":"vi","weights":[0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.0242424,0.00606061,0.00606061,0.0121212,0.0121212,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.0121212,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.0242424,0.00606061,0.00606061,0.0121212,0.00606061,0.0181818,0.0121212,0.0121212,0.00606061,0.0121212,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.0121212,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0424242,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.0242424,0.00606061,0.0121212,0.00606061,0.0121212,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.00606061,0.0121212,0.00606061,0.00606061,0.0121212,0.00606061,0.0121212],"ids":[1390,389,2715,1181,1024,1119,1680,1594,1632,1376,2761,3674,3739,3006,688,555,848,3809,3555,1388,1973,3169,4843,3293,3494,475,1359,4911,1748,2052,1106,4449,252,4705,4644,1282,2462,2977,964,4039,256,4509,2190,59,2875,2204,1097,1987,490,2290,2467,3052,1254,976,2112,906,4166,4046,4259,69,1755,1491,3957,2406,3923,1136,496,2939,809,2879,2768,3122,4529,4244,2202,4598,1737,4672,1643,1641,123,565,670,1152,755,557,3160,2968,4766,2409,1174,909,2580,3519,2850,2862,2225,2329,4629,3346,638,550,3017,2976,1756,4025,4815,1800,1480,4155,4779,2883,1829,1796,1518,2741,3933,849,527,902,1099,2040,4864,4381],"ngrams":["ể$","để","bạ","ủa","eb$","^we","ang","ran","̣n$","tra","^a�","̣u$","ệu","^li","ữ$","dữ","^dư","^đê","ạn","̀ng","^đă","chô","àn","^đơ","�i$","i�$","^xe","a�c","^ô$","^ph","ca�","^ca","từ","^kg","ho$","̣t$","ãn","̉i$","ay$","hi�","hay","^th","^nô","̃n$","�n$","i�n","đặ","^ti","kg$","nh$","nộ","min","^xa","^đô","ch$","nse","độ","phi","se$","ụn","di$","em$","ụ$","vụ","ti�","^ch","hô�","xa�","â�p","ịc","̣ng","inh","câ�","web","^du","^câ","^vu","hã","ens","cun","liê","đơn","ừ$","đổ","^tr","dụ","^cu","ơn$","dse","̣ch","^da","�p$","^tư","^mi","sen","^nh","ặt","^ad","iệ","ộn","chi","ng$","̣i$","^ha","ung","củ","ội","�c$","dạ","hà","^ba","cho","dun","ô�i","ổi","ads","̉a$","tha","xem","à$","hi$","nha","dị","^di"],"ngram_size":3,"dimension":5000},{"language":"vi","weights":[0.00784314,0.00392157,0.00784314,0.00392157,0.00392157,0.00784314,0.0352941,0.0117647,0.0196078,0.00392157,0.00392157,0.0117647,0.0117647,0.0352941,0.00784314,0.176471,0.0117647,0.0156863,0.0313726,0.00392157,0.0431373,0.0588235,0.0196078,0.00784314,0.00784314,0.0470588,0.0235294,0.00392157,0.0196078,0.0666667,0.027451,0.0196078,0.00784314,0.00392157,0.0509804,0.176471],"ids":[11,24,31,2,19,96,72,86,58,2,57,91,77,17,54,68,28,0,88,32,66,58,74,75,22,63,59,65,21,20,0,79,44,97,96,52],"ngrams":["b","r","ê","ơ","k","̃","̣","x","đ","l","v","̉","p","�","ư","$","̀","m","g","w","i","c","ô","â","o","h","u","y","t","n","d","e","s","ă","a","^"],"ngram_size":1,"dimension":100},{"language":"yi","weights":[0.00735294,0.0147059,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0294118,0.00735294,0.00735294,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.00735294,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.0220588,0.0147059,0.0147059,0.00735294,0.00735294,0.00735294,0.00735294,0.0220588,0.00735294,0.0147059,0.00735294,0.0147059,0.00735294,0.0220588,0.0294118,0.00735294,0.0367647,0.0147059,0.00735294,0.00735294,0.00735294,0.0147059,0.00735294,0.0220588,0.0147059,0.0220588,0.0220588,0.00735294,0.0147059,0.0147059,0.0147059,0.0220588,0.00735294,0.0220588,0.0147059,0.0367647,0.00735294,0.0220588,0.0147059,0.0147059,0.0220588,0.00735294,0.00735294,0.00735294,0.0147059,0.0367647],"ids":[822,514,922,115,933,207,672,855,206,854,372,593,130,825,388,191,987,423,341,582,995,611,296,917,166,990,811,582,533,931,844,153,183,350,931,760,310,96,540,295,336,6,695,393,58,458,85,287,464,121,611,204,631,564,470,186,273,177,121,558,609,699,939,596,92,168,530,67,60,268,413,497,838,460,897,629,354,662,721,175],"ngrams":["כל","וף","^ס","נד","ד�","ון","�ו","פו","רפ","וע","לי","יס","רי","^י","רש","ו�","^ו","ין","^כ","וי","וו","עו","�ָ","עס","ק�","ַד","גע","דע","^ה","ל�","ול","ַל","�$","יי","�ר","יע","ינ","טן","סט","שע","^מ","^ע","^ז","ב�","�ז","יז","רס","�י","ר$","ָט","ער","זי","ה�","מע","צי","ף$","יו","פ�","^ב","ס$","ט$","ט�","סו","ל$","^ל","נט","י�","�נ","ז$","ן$","נע","ע$","^$","�ַ","^פ","^ג","�ק","^צ","�ן","^�"],"ngram_size":2,"dimension":1000},{"language":"yi","weights":[0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0238095,0.0119048,0.0357143,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048,0.0119048],"ids":[2041,1645,3511,4400,1254,4204,3226,477,1962,2788,4553,4773,4035,4688,1146,4951,2212,4994,3947,2444,2806,2762,958,651,3882,903,2048,893,4051,2386,1011,1877,3060,1841,1753,1913,331,4453,2865,1765,4264,4052,1567,4895,2874,3440,415,2420,4825,2744,3310,3234,2562,4176,4461,2141,1946,1558,4196,2059,1559,2895,83,3272,4574,1737,4775,1630,3624,572,1837,4094,2812,1634,2077,2724,2401],"ngrams":["סוף$","ד�ן$","נד�ן","�נד�","ל�נד","�ון$","פול$","וערפ","ריס$","�ריס","פ�רי","יעס$","^יעס","רשע$","�רשע","ווער","ו�רש","�ין$","ווינ","^ליו","עווו","�ַדע","^געו","^וו�","^ה�ָ","דעס$","�נט$","ק�נט","פ�נט","ַל�ַ","צי�$","�ַל�","^סוף","ליוו","ב�ַל","^פ�נ","ַדעס","^ב�ַ","יינע","זיע$","^זיי","^מער","פ�ר$","ערפו","וווי","^�ון","^פ�ר","^ל�נ","וינט","סטן$","�נט�","ל�ַד","ערסט","געוו","^כל$","�ָט$","^�יז","מערס","רפול","ב�ק�","יווע","^�ן$","ינט$","^�ין","^צי�","�יז$","�ק�נ","^ער$","ה�ָט","וו�ר","ט�זי","רסטן","^ב�ק","זיינ","נט�ז","ינע$","�זיע"],"ngram_size":4,"dimension":5000},{"language":"yi","weights":[0.00917431,0.00917431,0.0183486,0.0183486,0.0183486,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.0183486,0.0183486,0.00917431,0.0183486,0.00917431,0.0275229,0.00917431,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.0183486,0.00917431,0.00917431,0.00917431,0.0275229,0.00917431,0.00917431,0.0275229,0.00917431,0.0275229,0.00917431,0.00917431],"ids":[2078,4696,621,3238,2954,2718,2416,1615,3222,364,4144,1695,2815,4385,4245,2368,3557,1750,4633,2322,71,1715,3374,245,2519,1125,1243,3024,3827,618,4233,442,1973,318,166,4890,3573,3133,3164,1162,1711,163,733,47,3623,3696,3274,2843,425,1571,2780,1993,2601,1107,2169,917,3099,4836,4315,2189,1885,3323,2967,2217,1731,583,2038,2323,1056,2573,1465,3722,1161,4883,3096,1982,991,1620,2686,4454,3511,67,3842,156,629,1857,1591,2857,1075,802],"ngrams":["כל$","^כל","וף$","סוף","^סו","ד�ן","�נד","^ל�","ון$","�ון","ול$","פול","ערפ","וער","יוו","ליו","יס$","ריס","יעס","^יע","שע$","�רש","ווי","זיי","�ָט","ל�נ","^ה�","ו�ר","^�ן","נט�","ַדע","דעס","^וו","ב�ק","ל�ַ","^�ו","געו","ב�ַ","ָט$","ינע","וו�","ינט","^צי","יינ","�ַל","צי�","�ר$","וינ","י�$","פ�ר","ין$","^גע","טן$","זיע","רסט","�רי","רשע","ערס","^מע","עס$","רפו","^זי","נע$","נט$","ווע","עוו","יז$","�יז","יע$","�נט","ווו","^פ�","�זי","�ין","�ַד","^ב�","ַל�","ט�ז","�ן$","פ�נ","�ק�","^לי","^�י","סטן","נד�","ער$","ק�נ","^ער","מער","ה�ָ"],"ngram_size":3,"dimension":5000},{"language":"yi","weights":[0.00613497,0.0122699,0.00613497,0.00613497,0.00613497,0.0368098,0.0306748,0.00613497,0.0122699,0.0122699,0.00613497,0.0245399,0.0122699,0.0490798,0.0674847,0.165644,0.00613497,0.0674847,0.00613497,0.00613497,0.0674847,0.0306748,0.0306748,0.0306748,0.104294,0.0245399,0.165644],"ids":[18,4,79,10,89,68,61,70,8,94,80,52,45,81,18,52,38,67,23,44,65,83,77,34,37,29,68],"ngrams":["כ","ף","ש","ג","ק","ס","ל","�","ד","ַ","ה","פ","ב","ר","ע","^","ָ","י","מ","צ","ו","ט","ן","נ","�","ז","$"],"ngram_size":1,"dimension":100},{"language":"yo","weights":[0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.00390625,0.0078125,0.00390625,0.0078125,0.0078125,0.00390625,0.0078125,0.015625,0.0117188,0.0117188,0.0117188,0.00390625,0.00390625,0.00390625,0.0078125,0.00390625,0.00390625,0.00390625,0.0078125,0.0078125,0.00390625,0.00390625,0.00390625,0.0078125,0.0117188,0.0117188,0.00390625,0.0078125,0.00390625,0.0117188,0.015625,0.0078125,0.0195312,0.0078125,0.0078125,0.015625,0.0273438,0.00390625,0.0078125,0.0078125,0.0078125,0.0078125,0.0117188,0.00390625,0.0078125,0.0117188,0.0195312,0.0117188,0.0117188,0.015625,0.015625,0.015625,0.0117188,0.0078125,0.0078125,0.00390625,0.0195312,0.0195312,0.0703125,0.0078125,0.00390625,0.015625,0.0390625,0.0078125,0.00390625,0.00390625,0.0507812,0.00390625,0.0195312,0.0273438,0.00390625,0.0117188,0.00390625,0.0390625,0.0273438,0.00390625,0.00390625,0.00390625,0.00390625,0.0078125,0.0234375,0.0117188,0.0078125,0.00390625,0.015625],"ids":[937,115,803,763,985,688,510,116,421,778,826,879,545,517,522,501,270,907,23,594,146,887,526,212,842,893,355,559,795,128,68,458,532,90,147,623,153,486,933,793,980,381,489,575,532,19,384,128,75,287,766,89,662,193,535,493,191,989,108,269,215,378,385,190,875,854,651,998,46,493,96,712,960,67,848,19,645,978,752,879,80,8,349,298,518,353,98,838,248,630,489,157,976],"ngrams":["og","bl","di","ad","ri","wa","s$","ar","ur","ru","ko","ra","ir","mi","ye","ba","gb","ag","u$","ju","or","oj","on","^p","fa","mo","^m","wo","ow","jo","^j","tu","^s","^f","ka","aw","en","^b","ti","to","^t","fe","ed","^e","o$","ol","ns","po","op","it","ab","iy","iw","le","^l","lo","ku","a$","ak","an","ta","la","de","ya","un","^n","e$","ay","al","in","ni","we","pa","nt","i$","gs","^i","bi","ha","ib","nu","^a","se","ip","pe","^h","ik","^$","n$","at","es","na","^o"],"ngram_size":2,"dimension":1000},{"language":"yo","weights":[0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.0133333,0.0133333,0.00666667,0.0133333,0.00666667,0.02,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.0133333,0.00666667,0.00666667,0.00666667,0.02,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.0133333,0.0133333,0.0133333,0.00666667,0.00666667,0.0133333,0.02,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.0133333,0.00666667,0.0133333,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.0133333,0.00666667,0.00666667,0.00666667,0.0133333,0.0133333,0.00666667,0.00666667,0.00666667,0.00666667,0.02,0.00666667,0.02,0.00666667,0.00666667,0.00666667,0.00666667,0.00666667,0.0133333,0.00666667,0.00666667,0.0133333,0.00666667,0.02,0.00666667,0.02,0.00666667,0.00666667,0.00666667,0.02,0.00666667,0.02,0.02,0.00666667,0.00666667,0.02,0.00666667,0.0133333,0.02],"ids":[3553,1777,4505,1061,4168,4851,3715,4453,181,4341,66,3713,3583,153,3871,3600,4919,4977,4850,3459,3790,4305,4154,3069,3880,325,1658,3670,1208,3469,4300,4024,21,4722,258,1243,4453,336,3593,563,3753,2689,3065,4376,3616,821,4900,3285,1489,2953,2139,1669,3648,872,198,1149,2501,2930,941,1981,1507,2206,489,1725,4441,4262,414,3500,43,4334,3675,52,489,1956,1174,370,3993,3168,4114,1660,3958,1563,1642,1555,2231,2488,2731,4981,3906,2751,4416,3129,351,1357,1974,3000,4021,799,664,1199,3861,3877,2981,2602,1770,4153,801,4240,2015,130],"ngrams":["^agb","blog","wadi","iwad","^iwa","inu$","gba$","^eni","arag","uru$","ruru","^mo$","^ako","mira","niru","^mir","aye$","baye","^ika","gbay","^jow","agba","nagb","unag","yan$","ran$","lant","itak","iwe$","^iwe","oju$","abin","^oju","won$","^ba$","^blo","lopo","ninu","^awo","^ori","nse$","atun","^atu","awon","ati$","^fe$","^abi","niya","^han","ipa$","ese$","lese","adi$","ntak","^far","^les","ede$","ragb","kun$","eniy","opo$","ori$","ogs$","polo","^nin","^bi$","opol","^oni","^opo","iyan","^pe$","^le$","^ala","iran","jowo","^ede","tuns","awe$","kawe","olop","^lo$","akun","sese","taku","irur","lati","eses","owo$","nipa","^ita","anta","kuna","^to$","ako$","ibi$","^lat","bini","ikaw","alan","fara","^se$","logs","^ti$","nibi","han$","^nip","^ni$","onir","unse","inib"],"ngram_size":4,"dimension":5000},{"language":"yo","weights":[0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00990099,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00990099,0.00495049,0.0148515,0.00495049,0.00495049,0.00990099,0.00990099,0.0148515,0.00990099,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00990099,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00990099,0.00990099,0.00495049,0.0148515,0.00495049,0.00495049,0.029703,0.00990099,0.00495049,0.00495049,0.00990099,0.00990099,0.00495049,0.00495049,0.00990099,0.00495049,0.00495049,0.00495049,0.00495049,0.00990099,0.00990099,0.0148515,0.00495049,0.0247525,0.019802,0.00990099,0.0148515,0.00990099,0.00990099,0.00495049,0.0148515,0.0148515,0.00495049,0.00495049,0.019802,0.00495049,0.00990099,0.00990099,0.0148515,0.00495049,0.00495049,0.00495049,0.00990099,0.0148515,0.00495049,0.00495049,0.00990099,0.00495049,0.00495049,0.00495049,0.0148515,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.0148515,0.00990099,0.00495049,0.00495049,0.0148515,0.00495049,0.00495049,0.00495049,0.0148515,0.00495049,0.00495049,0.00990099,0.0148515,0.00495049,0.00495049,0.00495049,0.00990099,0.00495049,0.00495049,0.0148515,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.00495049,0.0148515],"ids":[4779,2734,2640,2887,1630,1597,1133,4662,2246,1755,4486,1309,4726,1181,775,377,1426,4535,2488,4840,1003,1881,1082,3448,2481,4663,4112,3752,16,1689,1536,2108,768,182,3908,816,3249,1486,1368,136,3220,367,2355,4324,1026,4530,1672,1047,3663,3606,14,4827,4259,3414,552,4725,1353,873,2511,16,2533,3272,432,3643,1305,940,2710,1987,4997,405,248,4663,2339,4497,1848,4635,2413,2544,4454,3262,1732,4517,360,1960,3804,2690,2387,1421,3189,4418,4995,3417,944,4029,3849,4200,4362,1637,2428,4599,2267,141,4625,3947,332,357,4211,2176,405,4475,3239,4102,4619,1971,2151,327,2447,4103,906,2911,129,3602,2976,3519,875,4194,1594,1488,4258,2625,2861],"ngrams":["^ba","^e$","^ag","ri$","ori","^or","gs$","ogs","blo","di$","adi","wad","ipa","nip","ba$","rag","far","^fa","iru","nir","oni","^on","ako","bay","pa$","gba","po$","nag","ita","we$","agb","^iw","lop","oju","iwa","won","awo","^pe","ye$","olo","lat","^mo","ika","wo$","^jo","ara","^it","uns","mo$","^se","lo$","^lo","se$","fe$","yan","niy","to$","^to","^op","pol","^ed","inu","iwe","eni","ati","ese","opo","^ti","iya","^ni","bi$","tun","ibi","le$","^at","ru$","^le","abi","^bl","^oj","ti$","awe","un$","^fe","aku","nu$","^la","rur","atu","kun","ant","^en","ede","mir","nin","uru","^ab","ira","^a$","lan","on$","ala","ni$","aye","pe$","les","bin","nta","kaw","owo","an$","log","ses","de$","tak","una","jow","^bi","nse","ko$","han","nib","^ha","^mi","^ak","^al","ran","^ik","ju$","^aw","ini"],"ngram_size":3,"dimension":5000},{"language":"yo","weights":[0.016129,0.00645161,0.0129032,0.00645161,0.00967742,0.00967742,0.0258065,0.0129032,0.0354839,0.174194,0.016129,0.0258065,0.00967742,0.0741935,0.016129,0.0516129,0.00322581,0.0290323,0.0677419,0.0387097,0.0903226,0.0935484,0.174194],"ids":[24,5,88,0,65,22,44,77,21,52,19,2,0,79,32,22,63,59,20,11,96,66,68],"ngrams":["r","j","g","m","y","f","s","p","t","^","k","l","d","e","w","o","h","u","n","b","a","i","$"],"ngram_size":1,"dimension":100},{"language":"zh","weights":[0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0215054,0.0215054,0.0215054,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0322581,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0215054,0.0322581,0.0107527,0.0215054,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0215054,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527,0.0107527],"ids":[558,381,875,375,860,136,975,366,998,564,302,799,534,284,384,706,388,479,446,883,410,838,927,357,65,919,148,743,693,160,726,392,640,620,160,185,92,50,510,105,261,825,832,707,648,312,308,247,305,690,42,317,247,678,247,916,672,612,485,940,327,583,723,624,773,151,229,703,926,199,33,73,193,711,660,947,416,969],"ngrams":["端更","表的","此表","在此","请在","地区","家$","国家","的国","改您","�更","者的","最上","到版","^地","或已","者或","有者","^�","所有","版�","^$","我是","我确","认您","^我","行更","图书","更改","确的","书$","择是","于�","是正","的授","已得","选择","授�","确认","的选","公告","认$","�$","请确","法进","的简","无法","该申","改$","�无","交的","��","的$","您的","是版","^请","交该","简报","�交","得到","正确","�所","申请","的最","告$","区$","^对","^产","报和","对于","请�","�的","^�","进行","和公","的图","上端","产�"],"ngram_size":2,"dimension":1000},{"language":"zh","weights":[0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0136986,0.0273973,0.0136986,0.0136986],"ids":[4769,3823,2883,4748,2124,1810,641,492,1602,2357,1851,1513,3960,3591,4317,1433,1743,3999,339,3375,1711,1670,4843,2957,4674,1801,3233,3535,4132,3014,865,1405,2650,1152,3585,3002,4235,2334,2415,4024,4749,3521,3596,1382,4598,2180,3643,182,3068,3749,2169,3177,2321,996,1619,3177,3138,4489,3409,3441,3804,3326,3897,3010,177,807,3068,4699,188,3679],"ngrams":["上端更改","改您的$","的最上端","表的最上","此表的最","在此表的","^地区$","的国家$","更改您的","端更改您","的授�$","�更改您","者的授�","有者的授","到版�所","得到版�","有者或已","所有者或","�的简报","^我是版","您的国家","或已得到","^请确认","的图书$","交的图书","^请在此","�交的图","的简报和","��交的","确认您的","我是版�","对于��","^对于�","所有者的","择是正确","^�更改","选择是正","的选择是","报和公告","您的选择","简报和公","我确认$","进行更改","行更改$","是正确的","于��交","该申请�","认您的选","^�交该","者或已得","�无法进","法进行更","是版�所","改您的国","已得到版","正确的$","无法进行","请�无法","版�所有","申请�无","交该申请","产�的简","�交该申","请确认您","^我确认","最上端更","^产�的","�所有者","请在此表","和公告$"],"ngram_size":4,"dimension":5000},{"language":"zh","weights":[0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0243902,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0243902,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0243902,0.0121951,0.0121951,0.0121951,0.0243902,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0243902,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951,0.0121951],"ids":[17,10,3622,680,1694,4265,628,529,55,4371,69,823,3104,4670,2869,556,2051,3368,1331,2898,4866,3600,3665,2479,1739,1752,4171,2390,3306,1787,3220,1796,1090,4998,491,916,3544,2692,1985,1782,3841,1766,3056,2505,2902,4677,3307,2221,2899,2232,3441,1689,1007,1791,1146,2585,4393,1545,3946,13,697,3254,109,2758,2606,2838,2840,4854,2336,115,4680,4622,703,2549,1222,2746,4094],"ngrams":["您的$","端更改","上端更","此表的","地区$","国家$","您的国","更改您","授�$","的授�","的国家","有者的","到版�","得到版","^请在","或已得","者或已","有者或","所有者","确认$","和公告","^我确","请在此","图书$","的图书","行更改","交的图","�交的","^�更","该申请","��交","于��","的最上","对于�","表的最","是正确","的选择","已得到","选择是","请确认","我是版","^地区","报和公","确认您","^请确","公告$","法进行","申请�","正确的","请�无","�无法","在此表","进行更","无法进","交该申","产�的","我确认","�所有","�交该","简报和","�的简","改您的","^�交","^对于","^我是","认您的","更改$","者的授","版�所","最上端","您的选","择是正","是版�","的简报","�更改","确的$","^产�"],"ngram_size":3,"dimension":5000},{"language":"zh","weights":[0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.0192308,0.00961538,0.0192308,0.0192308,0.0192308,0.00961538,0.0288462,0.0192308,0.00961538,0.00961538,0.0192308,0.00961538,0.00961538,0.0192308,0.00961538,0.0288462,0.105769,0.00961538,0.00961538,0.00961538,0.105769,0.0192308,0.00961538,0.00961538,0.0192308,0.0288462,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.00961538,0.0288462,0.00961538,0.0192308,0.00961538,0.0288462,0.0288462,0.0769231,0.00961538],"ids":[0,94,12,46,73,3,66,64,64,12,15,30,76,4,87,18,45,17,34,36,6,40,37,76,34,19,71,68,7,51,0,52,62,5,3,61,57,26,3,61,62,74,12,62,94,56,55,53,24,12,67,58,32,58,14],"ngrams":["端","上","最","此","区","地","家","到","和","已","或","者","于","我","有","所","�","�","版","书","图","�","对","得","是","选","改","$","进","申","法","^","交","行","国","�","请","无","简","�","产","正","在","报","该","授","择","您","表","认","公","确","更","的","告"],"ngram_size":1,"dimension":100},{"language":"zu","weights":[0.005,0.005,0.01,0.01,0.01,0.005,0.005,0.005,0.005,0.005,0.03,0.005,0.02,0.005,0.035,0.01,0.015,0.005,0.005,0.015,0.015,0.02,0.005,0.005,0.005,0.01,0.01,0.005,0.005,0.005,0.02,0.005,0.015,0.005,0.005,0.01,0.005,0.01,0.02,0.005,0.01,0.01,0.005,0.005,0.02,0.01,0.01,0.005,0.015,0.005,0.01,0.01,0.005,0.005,0.005,0.01,0.01,0.015,0.015,0.005,0.005,0.005,0.015,0.005,0.005,0.005,0.01,0.005,0.005,0.015,0.01,0.005,0.01,0.025,0.005,0.005,0.025,0.005,0.015,0.015,0.005,0.03,0.005,0.02,0.005,0.015,0.01,0.02,0.005,0.01,0.08,0.005,0.01,0.005],"ids":[895,19,803,489,298,183,652,780,927,410,378,113,191,88,973,662,193,493,535,347,637,880,379,522,123,515,120,904,601,999,490,532,356,738,8,349,819,391,786,596,712,291,442,854,651,591,98,978,676,369,61,230,83,766,487,998,493,27,364,827,62,144,977,597,671,994,41,290,23,662,752,750,757,645,585,287,307,564,848,153,147,885,34,575,939,532,517,605,157,838,989,602,688,269],"ngrams":["am","ol","di","ed","ip","he","up","va","mu","em","la","bu","ku","az","el","iw","le","lo","^l","th","ut","ph","ep","ye","^y","qe","im","nx","ho","ge","um","o$","me","so","^a","se","li","ga","is","wi","we","kw","ml","^n","e$","ke","ik","bi","za","ex","^k","iz","ul","uy","om","ay","in","si","uk","xw","zi","be","yi","qh","^z","iq","ma","nk","u$","ub","ha","xa","ek","^i","aq","uv","hu","ki","i$","en","ka","^u","gu","^e","sh","^s","mi","ng","na","^$","a$","eq","wa","an"],"ngram_size":2,"dimension":1000},{"language":"zu","weights":[0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.0135135,0.00675676,0.00675676,0.00675676,0.0135135,0.0202703,0.0135135,0.0135135,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.0202703,0.0135135,0.027027,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0202703,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.0135135,0.00675676,0.00675676,0.0135135,0.0135135,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676,0.00675676],"ids":[3596,45,4829,148,2652,319,2603,3671,4057,2705,3401,2001,1015,956,1221,3200,4294,782,1378,1704,4735,3943,4628,2627,2933,1208,107,536,3879,2150,4114,4828,3241,2354,1139,2680,1125,1189,1285,3179,3351,4910,3477,804,3196,4558,2031,612,3257,3124,1125,3299,4354,1452,4540,504,4645,1989,951,177,3451,2663,1198,716,3999,1077,4796,459,4359,911,1915,3936,4036,1415,2126,3351,3322,3940,2823,4034,3088,1389,1349,941,4808,4017,3677,1265,600,4169,600,4649,3432,4807,3520,731,4419,4628,4898,665,2536,2590,3612,3560,1836,1107,878,540,3034,3820,80,2056,1788,2738,1984,3127,943,379,611,2017,2061,23,2049,1606],"ngrams":["sha$","isha","layi","zama","^eqe","eqed","utho","uthu","diwe","qedi","kula","ngaq","^lom","mela","umel","iphu","miph","mele","imip","uphe","kuph","^uth","uva$","muva","emuv","iwe$","^emu","^uku","^imi","ela$","buyi","ubuy","ukub","azi$","wayi","wazi","aqed","gaqe","kwaz","ama$","ikwa","sikw","thum","ubek","phel","ekel","loml","hume","eli$","utha","kuth","elel","huth","inga","ola$","^ana","bike","^yep","kwi$","genx","^zam","^siz","phut","tha$","nga$","^nge","ana$","isel","kubu","^ubi","ayis","ubik","nkin","xway","sela","ngen","nxa$","exwa","isex","^ise","eka$","thol","leli","uyis","iza$","ike$","kele","leke","ngu$","yiso","qhub","engu","^kwi","mlek","siza","ele$","yise","ukul","inki","^ink","sexw","hela","iso$","beka","hube","ulay","iqhu","ephu","enga","omle","yeph","yish","hola","phum","^sik","king","^eng","ediw","^uma","uma$","enxa","^kup","ukut","^iqh"],"ngram_size":4,"dimension":5000},{"language":"zu","weights":[0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.0115607,0.0115607,0.00578035,0.017341,0.017341,0.0115607,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.017341,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.017341,0.017341,0.017341,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0231214,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.0289017,0.00578035,0.017341,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.00578035,0.017341,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.0115607,0.017341,0.00578035,0.0115607,0.0115607,0.00578035,0.0115607,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035,0.00578035],"ids":[4012,4202,2797,2388,4505,1715,208,2357,4584,1734,432,3143,3695,879,1400,2174,4606,4063,3984,3028,2828,1695,36,3399,4438,1889,3675,4630,4253,3759,1579,4485,1674,3859,4337,238,2389,696,332,1180,4229,4827,4959,844,1370,3781,4348,1491,1103,4248,1308,1249,2521,2924,2528,2042,2438,4261,1960,132,87,2886,3762,2748,1080,29,4092,2034,2172,2668,3653,1469,4229,4724,4379,4975,4198,984,4497,3265,4999,967,4787,414,3417,1110,1999,2625,1584,271,2522,136,3807,2161,632,193,3836,2333,2624,2372,625,298,2030,772,1584,3498,1689,290,3931,4207,3663,1876,1029,971,4148,1955,663,2613,2640,1882,3534,4266,2861,1237,4673,4770,849,943],"ngrams":["^ut","sha","ish","lay","kul","^za","eqe","^eq","ola","tho","iwe","diw","edi","gaq","mel","ume","mip","phe","kup","ele","^ku","va$","aqe","uva","sel","eph","uyi","ngu","buy","kwi","ubu","uku","sik","emu","eli","hol","eng","lel","kwa","kub","eke","^lo","^em","bek","oml","qhu","ha$","waz","kel","hum","uth","phu","yep","ula","azi","lom","kut","^ye","ela","xa$","gen","nge","so$","enx","^ng","siz","ing","la$","eka","yis","nxa","ayi","hel","way","muv","nga","^kw","zi$","le$","ke$","wi$","^um","ike","iso","^en","bik","iza","mle","xwa","ubi","li$","thu","imi","uph","sex","gu$","za$","ube","ama","^is","^ub","lek","ka$","ise","hub","^si","we$","hut","^an","ga$","kin","^in","ink","nki","iph","^uk","iqh","qed","^im","exw","ma$","ikw","ana","zam","na$","uma","tha","^iq"],"ngram_size":3,"dimension":5000},{"language":"zu","weights":[0.00881057,0.0176211,0.030837,0.0132159,0.0132159,0.0484582,0.00440529,0.0176211,0.00881057,0.0881057,0.0220264,0.118943,0.0176211,0.030837,0.0132159,0.0396476,0.118943,0.0440529,0.0132159,0.0792952,0.0969163,0.0969163,0.0396476,0.0176211],"ids":[0,65,20,12,21,2,57,77,86,66,32,68,86,44,22,63,52,19,11,59,96,79,0,88],"ngrams":["d","y","n","q","t","l","v","p","x","i","w","$","z","s","o","h","^","k","b","u","a","e","m","g"],"ngram_size":1,"dimension":100}]
diff --git a/x-pack/plugin/ml/src/main/resources/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json b/x-pack/plugin/ml/src/main/resources/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json
new file mode 100644
index 0000000000000..63af5fe0ffaec
--- /dev/null
+++ b/x-pack/plugin/ml/src/main/resources/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json
@@ -0,0 +1,20 @@
+{
+  "model_id" : "lang_ident_model_1",
+  "created_by" : "ml_admin",
+  "version" : "7.6.0",
+  "description" : "Model used for identifying language from arbitrary input text.",
+  "create_time" : 1575548914594,
+  "compressed_definition" : "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",
+  "tags" : [
+    "lang_ident",
+    "prepackaged"
+  ],
+  "input" : {
+    "field_names" : [
+      "text"
+    ]
+  },
+  "estimated_heap_memory_usage_bytes" : 1053992,
+  "estimated_operations" : 39629,
+  "license_level" : "basic"
+}
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/trainedmodels/langident/LangIdentNeuralNetworkInferenceTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/trainedmodels/langident/LangIdentNeuralNetworkInferenceTests.java
new file mode 100644
index 0000000000000..c93d2d58dde42
--- /dev/null
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/trainedmodels/langident/LangIdentNeuralNetworkInferenceTests.java
@@ -0,0 +1,73 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.inference.trainedmodels.langident;
+
+import org.elasticsearch.common.xcontent.DeprecationHandler;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
+import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident.LanguageExamples;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.Matchers.closeTo;
+
+
+public class LangIdentNeuralNetworkInferenceTests extends ESTestCase {
+
+    public void testLangInference() throws Exception {
+        TrainedModelConfig config = getLangIdentModel();
+
+        TrainedModelDefinition trainedModelDefinition = config.getModelDefinition();
+        List<LanguageExamples.LanguageExampleEntry> examples = new LanguageExamples().getLanguageExamples();
+        ClassificationConfig classificationConfig = new ClassificationConfig(1);
+
+        for (LanguageExamples.LanguageExampleEntry entry : examples) {
+            String text = entry.getText();
+            String cld3Actual = entry.getPredictedLanguage();
+            double cld3Probability = entry.getProbability();
+
+            Map<String, Object> inferenceFields = new HashMap<>();
+            inferenceFields.put("text", text);
+            ClassificationInferenceResults singleValueInferenceResults =
+                (ClassificationInferenceResults) trainedModelDefinition.infer(inferenceFields, classificationConfig);
+
+            assertThat(singleValueInferenceResults.valueAsString(), equalTo(cld3Actual));
+            double eps = entry.getLanguage().equals("hr") ? 0.001 : 0.00001;
+            assertThat("mismatch probability for language " + cld3Actual,
+                singleValueInferenceResults.getTopClasses().get(0).getProbability(), closeTo(cld3Probability, eps));
+        }
+    }
+
+    private TrainedModelConfig getLangIdentModel() throws IOException {
+        String path = "/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json";
+        try(XContentParser parser =
+                XContentType.JSON.xContent().createParser(
+                    NamedXContentRegistry.EMPTY,
+                    DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
+                    Files.newInputStream(getDataPath(path)))) {
+            TrainedModelConfig config = TrainedModelConfig.fromXContent(parser, true).build();
+            config.ensureParsedDefinition(xContentRegistry());
+            return config;
+        }
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
+}

From b467e228d3c7380684e143868074bb672da1bfb2 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Mon, 6 Jan 2020 12:59:26 -0500
Subject: [PATCH 405/686] Fix bare warnings on RollupJobTests (#50633)

Silences some ugly warnings.
---
 .../xpack/core/rollup/job/RollupJobTests.java     | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/rollup/job/RollupJobTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/rollup/job/RollupJobTests.java
index 3d2367f12bf29..e061bc85586ad 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/rollup/job/RollupJobTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/rollup/job/RollupJobTests.java
@@ -6,9 +6,7 @@
 package org.elasticsearch.xpack.core.rollup.job;
 
 import org.elasticsearch.cluster.Diff;
-import org.elasticsearch.cluster.Diffable;
 import org.elasticsearch.common.io.stream.Writeable;
-import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.test.AbstractDiffableSerializationTestCase;
 import org.elasticsearch.xpack.core.rollup.ConfigTestHelpers;
@@ -18,24 +16,24 @@
 import java.util.HashMap;
 import java.util.Map;
 
-public class RollupJobTests extends AbstractDiffableSerializationTestCase {
+public class RollupJobTests extends AbstractDiffableSerializationTestCase<RollupJob> {
     @Override
-    protected Writeable.Reader<Diff> diffReader() {
+    protected Writeable.Reader<Diff<RollupJob>> diffReader() {
         return RollupJob::readJobDiffFrom;
     }
 
     @Override
-    protected ToXContent doParseInstance(XContentParser parser) throws IOException {
+    protected RollupJob doParseInstance(XContentParser parser) throws IOException {
         return RollupJob.fromXContent(parser);
     }
 
     @Override
-    protected Writeable.Reader instanceReader() {
+    protected Writeable.Reader<RollupJob> instanceReader() {
         return RollupJob::new;
     }
 
     @Override
-    protected Writeable createTestInstance() {
+    protected RollupJob createTestInstance() {
         if (randomBoolean()) {
             return new RollupJob(ConfigTestHelpers.randomRollupJobConfig(random()), null);
         }
@@ -49,8 +47,7 @@ protected Writeable createTestInstance() {
     }
 
     @Override
-    protected Diffable makeTestChanges(Diffable testInstance) {
-        RollupJob other = (RollupJob) testInstance;
+    protected RollupJob makeTestChanges(RollupJob other) {
         if (randomBoolean()) {
             if (other.getHeaders().isEmpty()) {
                 Map<String, String> headers = new HashMap<>(1);

From ad432b15d5dfd2034f9266ccc3ad1aeafaa2f74c Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Mon, 6 Jan 2020 13:14:49 -0500
Subject: [PATCH 406/686] Replace AggParseContext with a String (#50625)

We used to have a *ton* off stuff in the `AggParseContext` but now we
parse aggs entirely with named xcontent. So we don't need the context
any more.
---
 .../org/elasticsearch/search/SearchModule.java     |  9 ++++-----
 .../search/aggregations/AggregatorFactories.java   | 14 +-------------
 2 files changed, 5 insertions(+), 18 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/search/SearchModule.java b/server/src/main/java/org/elasticsearch/search/SearchModule.java
index 6e861889c7bc6..44886f947cd4a 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchModule.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchModule.java
@@ -96,7 +96,6 @@
 import org.elasticsearch.plugins.SearchPlugin.SignificanceHeuristicSpec;
 import org.elasticsearch.plugins.SearchPlugin.SuggesterSpec;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
-import org.elasticsearch.search.aggregations.AggregatorFactories;
 import org.elasticsearch.search.aggregations.BaseAggregationBuilder;
 import org.elasticsearch.search.aggregations.InternalAggregation;
 import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
@@ -431,8 +430,8 @@ private void registerAggregations(List<SearchPlugin> plugins) {
 
     private void registerAggregation(AggregationSpec spec) {
         namedXContents.add(new NamedXContentRegistry.Entry(BaseAggregationBuilder.class, spec.getName(), (p, c) -> {
-            AggregatorFactories.AggParseContext context = (AggregatorFactories.AggParseContext) c;
-            return spec.getParser().parse(context.name, p);
+            String name = (String) c;
+            return spec.getParser().parse(name, p);
         }));
         namedWriteables.add(
                 new NamedWriteableRegistry.Entry(AggregationBuilder.class, spec.getName().getPreferredName(), spec.getReader()));
@@ -530,8 +529,8 @@ private void registerPipelineAggregations(List<SearchPlugin> plugins) {
 
     private void registerPipelineAggregation(PipelineAggregationSpec spec) {
         namedXContents.add(new NamedXContentRegistry.Entry(BaseAggregationBuilder.class, spec.getName(), (p, c) -> {
-            AggregatorFactories.AggParseContext context = (AggregatorFactories.AggParseContext) c;
-            return spec.getParser().parse(context.name, p);
+            String name = (String) c;
+            return spec.getParser().parse(name, p);
         }));
         namedWriteables.add(
                 new NamedWriteableRegistry.Entry(PipelineAggregationBuilder.class, spec.getName().getPreferredName(), spec.getReader()));
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/AggregatorFactories.java b/server/src/main/java/org/elasticsearch/search/aggregations/AggregatorFactories.java
index 81611f2c8e1b2..6e3e71a51489d 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/AggregatorFactories.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/AggregatorFactories.java
@@ -119,8 +119,7 @@ private static AggregatorFactories.Builder parseAggregators(XContentParser parse
                                     + aggregationName + "]: [" + aggBuilder.getType() + "] and [" + fieldName + "]");
                         }
 
-                        aggBuilder = parser.namedObject(BaseAggregationBuilder.class, fieldName,
-                                new AggParseContext(aggregationName));
+                        aggBuilder = parser.namedObject(BaseAggregationBuilder.class, fieldName, aggregationName);
                     }
                 } else {
                     throw new ParsingException(parser.getTokenLocation(), "Expected [" + XContentParser.Token.START_OBJECT + "] under ["
@@ -151,17 +150,6 @@ private static AggregatorFactories.Builder parseAggregators(XContentParser parse
         return factories;
     }
 
-    /**
-     * Context to parse and aggregation. This should eventually be removed and replaced with a String.
-     */
-    public static final class AggParseContext {
-        public final String name;
-
-        public AggParseContext(String name) {
-            this.name = name;
-        }
-    }
-
     public static final AggregatorFactories EMPTY = new AggregatorFactories(new AggregatorFactory[0], new ArrayList<>());
 
     private AggregatorFactory[] factories;

From 0d937353b5c41a7c5dd3262430dbab13db72066d Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Mon, 6 Jan 2020 13:30:08 -0500
Subject: [PATCH 407/686] Fix
 testRelocationEstablishedPeerRecoveryRetentionLeases (#50673)

The redNodes are calculated incorrectly.

Closes #50660
---
 .../src/test/java/org/elasticsearch/recovery/RelocationIT.java | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java b/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
index c22d1bc0dd28f..7a3de4f4c977e 100644
--- a/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
+++ b/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
@@ -622,7 +622,8 @@ public void testRelocationEstablishedPeerRecoveryRetentionLeases() throws Except
             Stream.generate(() -> Settings.builder().put("node.attr.color", "red").build()).limit(halfNodes)).toArray(Settings[]::new);
         List<String> nodes = internalCluster().startNodes(nodeSettings);
         String[] blueNodes = nodes.subList(0, halfNodes).toArray(String[]::new);
-        String[] redNodes = nodes.subList(0, halfNodes).toArray(String[]::new);
+        String[] redNodes = nodes.subList(halfNodes, nodes.size()).toArray(String[]::new);
+        logger.debug("--> blue nodes: [{}], red nodes: [{}]", blueNodes, redNodes);
         ensureStableCluster(halfNodes * 2);
         assertAcked(
             client().admin().indices().prepareCreate(indexName).setSettings(Settings.builder()

From f7ebc89885496e884cd28e3fa36c744115f17d8a Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Mon, 6 Jan 2020 13:32:59 -0500
Subject: [PATCH 408/686] Drop references to deprecated logger (#50474)

This drops all remaining references to `BaseRestHandler.logger` which
has been deprecated for something like a year now. I replaced all of the
references with locally declared loggers which is so much less spooky
action at a distance to me.
---
 .../security/rest/action/apikey/ApiKeyBaseRestHandler.java   | 4 ++++
 .../rest/action/oidc/OpenIdConnectBaseRestHandler.java       | 3 +++
 .../action/oidc/RestOpenIdConnectAuthenticateAction.java     | 3 +++
 .../oidc/RestOpenIdConnectPrepareAuthenticationAction.java   | 3 +++
 .../rest/action/saml/RestSamlAuthenticateAction.java         | 5 +++--
 .../xpack/security/rest/action/saml/SamlBaseRestHandler.java | 3 +++
 6 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/apikey/ApiKeyBaseRestHandler.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/apikey/ApiKeyBaseRestHandler.java
index 4d797bd543dc3..51d03d858cee7 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/apikey/ApiKeyBaseRestHandler.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/apikey/ApiKeyBaseRestHandler.java
@@ -6,6 +6,8 @@
 
 package org.elasticsearch.xpack.security.rest.action.apikey;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.license.XPackLicenseState;
@@ -16,6 +18,8 @@
  * A base rest handler that handles licensing for ApiKey actions
  */
 abstract class ApiKeyBaseRestHandler extends SecurityBaseRestHandler {
+    private static final Logger logger = LogManager.getLogger();
+
     ApiKeyBaseRestHandler(Settings settings, XPackLicenseState licenseState) {
         super(settings, licenseState);
     }
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/OpenIdConnectBaseRestHandler.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/OpenIdConnectBaseRestHandler.java
index 008b5d0676e2c..3fe31b97f59b9 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/OpenIdConnectBaseRestHandler.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/OpenIdConnectBaseRestHandler.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.security.rest.action.oidc;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.license.XPackLicenseState;
@@ -14,6 +16,7 @@
 import org.elasticsearch.xpack.security.rest.action.SecurityBaseRestHandler;
 
 public abstract class OpenIdConnectBaseRestHandler extends SecurityBaseRestHandler {
+    private static final Logger logger = LogManager.getLogger();
 
     private static final String OIDC_REALM_TYPE = OpenIdConnectRealmSettings.TYPE;
 
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/RestOpenIdConnectAuthenticateAction.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/RestOpenIdConnectAuthenticateAction.java
index 904300ffbdced..d820fb7a88b47 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/RestOpenIdConnectAuthenticateAction.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/RestOpenIdConnectAuthenticateAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.security.rest.action.oidc;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.settings.Settings;
@@ -30,6 +32,7 @@
  * Rest handler that authenticates the user based on the information provided as parameters of the redirect_uri
  */
 public class RestOpenIdConnectAuthenticateAction extends OpenIdConnectBaseRestHandler {
+    private static final Logger logger = LogManager.getLogger();
 
     static final ObjectParser<OpenIdConnectAuthenticateRequest, Void> PARSER = new ObjectParser<>("oidc_authn",
         OpenIdConnectAuthenticateRequest::new);
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/RestOpenIdConnectPrepareAuthenticationAction.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/RestOpenIdConnectPrepareAuthenticationAction.java
index 60786c82b56ef..c86da0ed4edc9 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/RestOpenIdConnectPrepareAuthenticationAction.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/oidc/RestOpenIdConnectPrepareAuthenticationAction.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.security.rest.action.oidc;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.settings.Settings;
@@ -30,6 +32,7 @@
  * Generates an oAuth 2.0 authentication request as a URL string and returns it to the REST client.
  */
 public class RestOpenIdConnectPrepareAuthenticationAction extends OpenIdConnectBaseRestHandler {
+    private static final Logger logger = LogManager.getLogger();
 
     static final ObjectParser<OpenIdConnectPrepareAuthenticationRequest, Void> PARSER = new ObjectParser<>("oidc_prepare_authentication",
         OpenIdConnectPrepareAuthenticationRequest::new);
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/saml/RestSamlAuthenticateAction.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/saml/RestSamlAuthenticateAction.java
index f1efc9437a8ef..486e749ca6a27 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/saml/RestSamlAuthenticateAction.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/saml/RestSamlAuthenticateAction.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.security.rest.action.saml;
 
 import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
@@ -35,9 +36,9 @@
  * A REST handler that attempts to authenticate a user based on the provided SAML response/assertion.
  */
 public class RestSamlAuthenticateAction extends SamlBaseRestHandler implements RestHandler {
+    private static final Logger logger = LogManager.getLogger();
+    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(logger);
 
-    private static final DeprecationLogger deprecationLogger =
-        new DeprecationLogger(LogManager.getLogger(RestSamlAuthenticateAction.class));
     static class Input {
         String content;
         List<String> ids;
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/saml/SamlBaseRestHandler.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/saml/SamlBaseRestHandler.java
index c136fdf95f68e..e30d844bb5644 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/saml/SamlBaseRestHandler.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/saml/SamlBaseRestHandler.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.security.rest.action.saml;
 
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.license.XPackLicenseState;
@@ -17,6 +19,7 @@
  * An abstract implementation of {@link SecurityBaseRestHandler} that performs a license check for the SAML realm type
  */
 public abstract class SamlBaseRestHandler extends SecurityBaseRestHandler {
+    private static final Logger logger = LogManager.getLogger();
 
     private static final String SAML_REALM_TYPE = SamlRealmSettings.TYPE;
 

From 3710865c1f7f135ec1295458616efe487e4909ae Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Mon, 6 Jan 2020 15:41:58 -0500
Subject: [PATCH 409/686] [ML] construct new random generator on each
 persistence call (#50657)

Sharing a random generator may cause test failures as non-threadsafe random generators are periodically utilized in tests (see: https://github.com/elastic/elasticsearch/issues/50651)

This change constructs a calls `Randomness.get()` within the  `bulkIndexWithRetry` method so that the returned `Random` object is only used in a single thread. Before, the member variable could have been used between threads, which caused test failures.
---
 .../xpack/ml/utils/persistence/ResultsPersisterService.java     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterService.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterService.java
index 6aad7d6a4f9b8..09224d9939945 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterService.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/ResultsPersisterService.java
@@ -52,7 +52,6 @@ public class ResultsPersisterService {
     // Having an exponent higher than this causes integer overflow
     private static final int MAX_RETRY_EXPONENT = 24;
 
-    private final Random random = Randomness.get();
     private final Client client;
     private volatile int maxFailureRetries;
 
@@ -90,6 +89,7 @@ public BulkResponse bulkIndexWithRetry(BulkRequest bulkRequest,
         int currentMax = MIN_RETRY_SLEEP_MILLIS;
         int currentAttempt = 0;
         BulkResponse bulkResponse = null;
+        final Random random = Randomness.get();
         while(currentAttempt <= maxFailureRetries) {
             bulkResponse = bulkIndex(bulkRequest);
             if (bulkResponse.hasFailures() == false) {

From 49b5a947913c1ac6d9133a61879b7812c1b64392 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Mon, 6 Jan 2020 16:33:57 -0500
Subject: [PATCH 410/686] Drop unused logger (#50682)

Drops the logger from `BaseRestHandler` which has been deprecated for
mor than a year. As of #50474 we don't use it any more.
---
 .../main/java/org/elasticsearch/rest/BaseRestHandler.java | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/rest/BaseRestHandler.java b/server/src/main/java/org/elasticsearch/rest/BaseRestHandler.java
index fa993e30ba2c4..5d33e55514629 100644
--- a/server/src/main/java/org/elasticsearch/rest/BaseRestHandler.java
+++ b/server/src/main/java/org/elasticsearch/rest/BaseRestHandler.java
@@ -18,8 +18,6 @@
  */
 
 package org.elasticsearch.rest;
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
 import org.apache.lucene.search.spell.LevenshteinDistance;
 import org.apache.lucene.util.CollectionUtil;
 import org.elasticsearch.client.node.NodeClient;
@@ -56,12 +54,6 @@ public abstract class BaseRestHandler implements RestHandler {
         Setting.boolSetting("rest.action.multi.allow_explicit_index", true, Property.NodeScope);
 
     private final LongAdder usageCount = new LongAdder();
-    /**
-     * @deprecated declare your own logger.
-     */
-    @Deprecated
-    protected Logger logger = LogManager.getLogger(getClass());
-
 
     public final long getUsageCount() {
         return usageCount.sum();

From dfe99208f67b082a7e748ec986f38b24715bc741 Mon Sep 17 00:00:00 2001
From: Lee Hinman <lee@writequit.org>
Date: Mon, 6 Jan 2020 12:24:36 -0700
Subject: [PATCH 411/686] Add additional wait conditions to test

---
 .../xpack/ilm/TimeSeriesLifecycleActionsIT.java              | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 47992798cde8e..1560dbd5effe7 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.test.rest.ESRestTestCase;
 import org.elasticsearch.xpack.core.ilm.AllocateAction;
 import org.elasticsearch.xpack.core.ilm.DeleteAction;
+import org.elasticsearch.xpack.core.ilm.ErrorStep;
 import org.elasticsearch.xpack.core.ilm.ForceMergeAction;
 import org.elasticsearch.xpack.core.ilm.FreezeAction;
 import org.elasticsearch.xpack.core.ilm.LifecycleAction;
@@ -1111,6 +1112,8 @@ public void testHistoryIsWrittenWithSuccess() throws Exception {
         Request refreshIndex = new Request("POST", "/" + index + "-1/_refresh");
         client().performRequest(refreshIndex);
 
+        assertBusy(() -> assertThat(getStepKeyForIndex(index + "-1"), equalTo(TerminalPolicyStep.KEY)));
+
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "wait-for-indexing-complete"), 30, TimeUnit.SECONDS);
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "wait-for-follow-shard-tasks"), 30, TimeUnit.SECONDS);
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", true, "pause-follower-index"), 30, TimeUnit.SECONDS);
@@ -1153,6 +1156,8 @@ public void testHistoryIsWrittenWithFailure() throws Exception {
         Request refreshIndex = new Request("POST", "/" + index + "-1/_refresh");
         client().performRequest(refreshIndex);
 
+        assertBusy(() -> assertThat(getStepKeyForIndex(index + "-1").getName(), equalTo(ErrorStep.NAME)));
+
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", false, "ERROR"), 30, TimeUnit.SECONDS);
     }
 

From c79d29e697d9ca43341d2de48e240e4ebad2ff7b Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Mon, 6 Jan 2020 17:40:07 -0500
Subject: [PATCH 412/686] Silence eclipse warnings about forbidden refs
 (#50686)

We intentionally have a couple hundred forbidden and discouraged
references to jdk internals in our tests. This silences all of the
warnings Eclipse has about it. Don't worry though, the build still runs
forbidden APIs to make sure we only reference internal stuff that we've
decided is ok.
---
 .../resources/eclipse.settings/org.eclipse.jdt.core.prefs   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/buildSrc/src/main/resources/eclipse.settings/org.eclipse.jdt.core.prefs b/buildSrc/src/main/resources/eclipse.settings/org.eclipse.jdt.core.prefs
index 285b882a154ba..f9ebf63c74923 100644
--- a/buildSrc/src/main/resources/eclipse.settings/org.eclipse.jdt.core.prefs
+++ b/buildSrc/src/main/resources/eclipse.settings/org.eclipse.jdt.core.prefs
@@ -22,3 +22,9 @@ org.eclipse.jdt.core.formatter.comment.line_length=140
 org.eclipse.jdt.core.formatter.lineSplit=140
 org.eclipse.jdt.core.formatter.tabulation.char=space
 org.eclipse.jdt.core.formatter.tabulation.size=4
+
+# Silence warnings about references to jdk internals. We intentionally use some
+# and have much tighter control of the warnings in the forbidden APIs gradle
+# task which is the definitive list of allowed references.
+org.eclipse.jdt.core.compiler.problem.forbiddenReference=ignore
+org.eclipse.jdt.core.compiler.problem.discouragedReference=ignore
\ No newline at end of file

From 85d3a6ba593f6cfd5f4c87da754de68be49f063b Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 7 Jan 2020 09:38:50 +0100
Subject: [PATCH 413/686] Check allocation id when failing shard on recovery
 (#50656)

A failure of a recovering shard can race with a new allocation of the shard, and cause the new
allocation to be failed as well. This can result in a shard being marked as initializing in the cluster
state, but not exist on the node anymore.

Closes #50508
---
 .../cluster/IndicesClusterStateService.java   |  8 +++--
 ...ClusterStateServiceRandomUpdatesTests.java | 34 +++++++++++++++++++
 2 files changed, 40 insertions(+), 2 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java b/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
index b72a56b4a0543..23c8c26230c87 100644
--- a/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
+++ b/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
@@ -717,7 +717,8 @@ public void onRecoveryFailure(RecoveryState state, RecoveryFailedException e, bo
         }
     }
 
-    private synchronized void handleRecoveryFailure(ShardRouting shardRouting, boolean sendShardFailure, Exception failure) {
+    // package-private for testing
+    synchronized void handleRecoveryFailure(ShardRouting shardRouting, boolean sendShardFailure, Exception failure) {
         failAndRemoveShard(shardRouting, sendShardFailure, "failed recovery", failure, clusterService.state());
     }
 
@@ -726,7 +727,10 @@ private void failAndRemoveShard(ShardRouting shardRouting, boolean sendShardFail
         try {
             AllocatedIndex<? extends Shard> indexService = indicesService.indexService(shardRouting.shardId().getIndex());
             if (indexService != null) {
-                indexService.removeShard(shardRouting.shardId().id(), message);
+                Shard shard = indexService.getShardOrNull(shardRouting.shardId().id());
+                if (shard != null && shard.routingEntry().isSameAllocation(shardRouting)) {
+                    indexService.removeShard(shardRouting.shardId().id(), message);
+                }
             }
         } catch (ShardNotFoundException e) {
             // the node got closed on us, ignore it
diff --git a/server/src/test/java/org/elasticsearch/indices/cluster/IndicesClusterStateServiceRandomUpdatesTests.java b/server/src/test/java/org/elasticsearch/indices/cluster/IndicesClusterStateServiceRandomUpdatesTests.java
index 3590c52e505bf..71af6ac7f040f 100644
--- a/server/src/test/java/org/elasticsearch/indices/cluster/IndicesClusterStateServiceRandomUpdatesTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/cluster/IndicesClusterStateServiceRandomUpdatesTests.java
@@ -256,6 +256,40 @@ public void testInitializingPrimaryRemovesInitializingReplicaWithSameAID() {
 
     }
 
+    public void testRecoveryFailures() {
+        disableRandomFailures();
+        String index = "index_" + randomAlphaOfLength(8).toLowerCase(Locale.ROOT);
+        ClusterState state = ClusterStateCreationUtils.state(index, randomBoolean(),
+            ShardRoutingState.STARTED, ShardRoutingState.INITIALIZING);
+
+        // the initial state which is derived from the newly created cluster state but doesn't contain the index
+        ClusterState previousState = ClusterState.builder(state)
+            .metaData(MetaData.builder(state.metaData()).remove(index))
+            .routingTable(RoutingTable.builder().build())
+            .build();
+
+        // pick a data node to simulate the adding an index cluster state change event on, that has shards assigned to it
+        final ShardRouting shardRouting = state.routingTable().index(index).shard(0).replicaShards().get(0);
+        final ShardId shardId = shardRouting.shardId();
+        DiscoveryNode node = state.nodes().get(shardRouting.currentNodeId());
+
+        // simulate the cluster state change on the node
+        ClusterState localState = adaptClusterStateToLocalNode(state, node);
+        ClusterState previousLocalState = adaptClusterStateToLocalNode(previousState, node);
+        IndicesClusterStateService indicesCSSvc = createIndicesClusterStateService(node, RecordingIndicesService::new);
+        indicesCSSvc.start();
+        indicesCSSvc.applyClusterState(new ClusterChangedEvent("cluster state change that adds the index", localState, previousLocalState));
+
+        assertNotNull(indicesCSSvc.indicesService.getShardOrNull(shardId));
+
+        // check that failing unrelated allocation does not remove shard
+        indicesCSSvc.handleRecoveryFailure(shardRouting.reinitializeReplicaShard(), false, new Exception("dummy"));
+        assertNotNull(indicesCSSvc.indicesService.getShardOrNull(shardId));
+
+        indicesCSSvc.handleRecoveryFailure(shardRouting, false, new Exception("dummy"));
+        assertNull(indicesCSSvc.indicesService.getShardOrNull(shardId));
+    }
+
     public ClusterState randomInitialClusterState(Map<DiscoveryNode, IndicesClusterStateService> clusterStateServiceMap,
                                                   Supplier<MockIndicesService> indicesServiceSupplier) {
         List<DiscoveryNode> allNodes = new ArrayList<>();

From 8ca80d6daf4e1022f98a2d5b010811d2a9ca3b20 Mon Sep 17 00:00:00 2001
From: David Turner <david.turner@elastic.co>
Date: Tue, 7 Jan 2020 09:02:35 +0000
Subject: [PATCH 414/686] Fix testDelayVariabilityAppliesToFutureTasks (#50667)

This test seems to be bogus as it was confusing a nominal execution time with a
delay (i.e. an elapsed time). This commit reworks the test to address this.

Fixes #50650
---
 .../coordination/DeterministicTaskQueueTests.java   | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/test/framework/src/test/java/org/elasticsearch/cluster/coordination/DeterministicTaskQueueTests.java b/test/framework/src/test/java/org/elasticsearch/cluster/coordination/DeterministicTaskQueueTests.java
index 129ef89e88c9b..b7fbde22f5048 100644
--- a/test/framework/src/test/java/org/elasticsearch/cluster/coordination/DeterministicTaskQueueTests.java
+++ b/test/framework/src/test/java/org/elasticsearch/cluster/coordination/DeterministicTaskQueueTests.java
@@ -376,20 +376,19 @@ public void testDelayVariabilityAppliesToImmediateTasks() {
     public void testDelayVariabilityAppliesToFutureTasks() {
         final DeterministicTaskQueue deterministicTaskQueue = newTaskQueue();
         advanceToRandomTime(deterministicTaskQueue);
-        final long delayMillis = randomLongBetween(30000, 60000);
-        final long variabilityMillis = randomLongBetween(100, 500);
+        final long nominalExecutionTime = randomLongBetween(0, 60000);
+        final long variabilityMillis = randomLongBetween(1, 500);
+        final long startTime = deterministicTaskQueue.getCurrentTimeMillis();
         deterministicTaskQueue.setExecutionDelayVariabilityMillis(variabilityMillis);
         for (int i = 0; i < 100; i++) {
-            deterministicTaskQueue.scheduleAt(delayMillis, () -> {});
+            deterministicTaskQueue.scheduleAt(nominalExecutionTime, () -> {});
         }
         final long expectedEndTime = deterministicTaskQueue.getLatestDeferredExecutionTime();
+        assertThat(expectedEndTime, greaterThan(nominalExecutionTime)); // fails if every task has zero variability -- vanishingly unlikely
+        assertThat(expectedEndTime, lessThanOrEqualTo(Math.max(startTime, nominalExecutionTime + variabilityMillis)));
 
-        final long startTime = deterministicTaskQueue.getCurrentTimeMillis();
         deterministicTaskQueue.runAllTasks();
-        final long elapsedTime = deterministicTaskQueue.getCurrentTimeMillis() - startTime;
         assertThat(deterministicTaskQueue.getCurrentTimeMillis(), is(expectedEndTime));
-        assertThat(elapsedTime, greaterThan(delayMillis)); // fails with negligible probability
-        assertThat(elapsedTime, lessThanOrEqualTo(delayMillis + variabilityMillis));
     }
 
     public void testThreadPoolSchedulesPeriodicFutureTasks() {

From b88bec293b0a4d1e5a8afc67d0723b79906af17e Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Tue, 7 Jan 2020 09:09:47 +0000
Subject: [PATCH 415/686] Skip Linux OS checks unless running in CI (#50664)

Closes #50393. When generating the packaging test tasks, skip the Linux OS
checks unless we're running in CI.
---
 .../org/elasticsearch/gradle/test/DistroTestPlugin.java    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java b/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
index e8294ce738b7f..b62ff129c8638 100644
--- a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
+++ b/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
@@ -498,6 +498,13 @@ private static boolean shouldRunDockerTests(Project project) {
                 return true;
 
             case LINUX:
+                // We don't attempt to check the current flavor and version of Linux unless we're
+                // running in CI, because we don't want to stop people running the Docker tests in
+                // their own environments if they really want to.
+                if (BuildParams.isCi() == false) {
+                    return true;
+                }
+
                 // Only some hosts in CI are configured with Docker. We attempt to work out the OS
                 // and version, so that we know whether to expect to find Docker. We don't attempt
                 // to probe for whether Docker is available, because that doesn't tell us whether

From 45e524453df85cd234ea23e98b43880fe6edfb16 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Tue, 7 Jan 2020 09:31:22 +0000
Subject: [PATCH 416/686] Correctly handle MSM for nested disjunctions (#50669)

With the rewrite of the percolator's QueryAnalyzer to use lucene's QueryVisitor API,
term queries that are direct children of a boolean query are handled separately from
other children. This works fine for conjunctions, but for disjunctions we need to
treat the extracted terms from these direct descendents along with extractions from
more deeply nested children to ensure that minimum-should-match requirements
are met correctly.

This commit changes the logic in QueryAnalyzer#getResult() to bundle child term
results with all other results before handling them.

Fixes #50305
---
 .../percolator/QueryAnalyzer.java             |  2 +-
 .../percolator/QueryAnalyzerTests.java        | 37 +++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/modules/percolator/src/main/java/org/elasticsearch/percolator/QueryAnalyzer.java b/modules/percolator/src/main/java/org/elasticsearch/percolator/QueryAnalyzer.java
index f08600cdfd0e9..800706b74b9d3 100644
--- a/modules/percolator/src/main/java/org/elasticsearch/percolator/QueryAnalyzer.java
+++ b/modules/percolator/src/main/java/org/elasticsearch/percolator/QueryAnalyzer.java
@@ -126,7 +126,7 @@ public String toString() {
         Result getResult() {
             List<Result> partialResults = new ArrayList<>();
             if (terms.size() > 0) {
-                partialResults.add(conjunction ? handleConjunction(terms) : handleDisjunction(terms, minimumShouldMatch));
+                partialResults.addAll(terms);
             }
             if (children.isEmpty() == false) {
                 List<Result> childResults = children.stream().map(ResultBuilder::getResult).collect(Collectors.toList());
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/QueryAnalyzerTests.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/QueryAnalyzerTests.java
index 1c00d0555b41a..adde835deb104 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/QueryAnalyzerTests.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/QueryAnalyzerTests.java
@@ -1209,6 +1209,43 @@ public void testIntervalQueries() {
         assertTermsEqual(result.extractions, new Term("field", "a"));
     }
 
+    public void testRangeAndTermWithNestedMSM() {
+
+        Query q1 = new BooleanQuery.Builder()
+            .add(new TermQuery(new Term("f", "v3")), Occur.SHOULD)
+            .add(new BooleanQuery.Builder()
+                .add(new TermQuery(new Term("f", "n1")), Occur.SHOULD)
+                .build(), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v4")), Occur.SHOULD)
+            .setMinimumNumberShouldMatch(2)
+            .build();
+
+        Result r1 = analyze(q1, Version.CURRENT);
+        assertEquals(2, r1.minimumShouldMatch);
+        assertThat(r1.extractions, hasSize(3));
+        assertFalse(r1.matchAllDocs);
+        assertTrue(r1.verified);
+
+        Query q = new BooleanQuery.Builder()
+            .add(IntPoint.newRangeQuery("i", 0, 10), Occur.FILTER)
+            .add(new TermQuery(new Term("f", "v1")), Occur.MUST)
+            .add(new TermQuery(new Term("f", "v2")), Occur.MUST)
+            .add(IntPoint.newRangeQuery("i", 2, 20), Occur.FILTER)
+            .add(new TermQuery(new Term("f", "v3")), Occur.SHOULD)
+            .add(new BooleanQuery.Builder()
+                .add(new TermQuery(new Term("f", "n1")), Occur.SHOULD)
+                .build(), Occur.SHOULD)
+            .add(new TermQuery(new Term("f", "v4")), Occur.SHOULD)
+            .setMinimumNumberShouldMatch(2)
+            .build();
+
+        Result r = analyze(q, Version.CURRENT);
+        assertThat(r.minimumShouldMatch, equalTo(5));
+        assertThat(r.extractions, hasSize(7));
+        assertFalse(r.matchAllDocs);
+        assertFalse(r.verified);
+    }
+
     public void testCombinedRangeAndTermWithMinimumShouldMatch() {
 
         Query disj = new BooleanQuery.Builder()

From 0cbf9578ac2ce75d4301b70aa05fc89076f90baa Mon Sep 17 00:00:00 2001
From: David Roberts <dave.roberts@elastic.co>
Date: Tue, 7 Jan 2020 10:11:09 +0000
Subject: [PATCH 417/686] [ML] Fix off-by-one error in ml_classic tokenizer end
 offset (#50655)

The end offset of a tokenizer is supposed to point one past the
end of the input, not to the end character of the input.  The
ml_classic tokenizer was erroneously doing the latter.
---
 .../ml/job/categorization/MlClassicTokenizer.java |  2 +-
 .../categorization/MlClassicTokenizerTests.java   | 15 +++++++++++++++
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/categorization/MlClassicTokenizer.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/categorization/MlClassicTokenizer.java
index 72fd2242105eb..5462052919a44 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/categorization/MlClassicTokenizer.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/categorization/MlClassicTokenizer.java
@@ -105,7 +105,7 @@ public final boolean incrementToken() throws IOException {
     public final void end() throws IOException {
         super.end();
         // Set final offset
-        int finalOffset = Math.max(0, nextOffset + (int) input.skip(Integer.MAX_VALUE) - 1);
+        int finalOffset = nextOffset + (int) input.skip(Integer.MAX_VALUE);
         offsetAtt.setOffset(finalOffset, finalOffset);
         // Adjust any skipped tokens
         posIncrAtt.setPositionIncrement(posIncrAtt.getPositionIncrement() + skippedPositions);
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/categorization/MlClassicTokenizerTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/categorization/MlClassicTokenizerTests.java
index 8aba5642255b5..8260b2662ddbc 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/categorization/MlClassicTokenizerTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/categorization/MlClassicTokenizerTests.java
@@ -7,6 +7,7 @@
 
 import org.apache.lucene.analysis.Tokenizer;
 import org.apache.lucene.analysis.tokenattributes.CharTermAttribute;
+import org.apache.lucene.analysis.tokenattributes.OffsetAttribute;
 import org.elasticsearch.test.ESTestCase;
 
 import java.io.IOException;
@@ -21,28 +22,40 @@ public void testTokenize() throws IOException {
             tokenizer.setReader(new StringReader(testData));
             tokenizer.reset();
             CharTermAttribute term = tokenizer.addAttribute(CharTermAttribute.class);
+            OffsetAttribute offset = tokenizer.addAttribute(OffsetAttribute.class);
             assertTrue(tokenizer.incrementToken());
             assertEquals("one", term.toString());
+            assertEquals(0, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("two", term.toString());
+            assertEquals(7, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("stars", term.toString());
+            assertEquals(13, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("in", term.toString());
+            assertEquals(20, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("their", term.toString());
+            assertEquals(24, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("eyes", term.toString());
+            assertEquals(31, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("three", term.toString());
+            assertEquals(38, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("sand.-_wich", term.toString());
+            assertEquals(47, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("five5", term.toString());
+            assertEquals(65, offset.startOffset());
             assertTrue(tokenizer.incrementToken());
             assertEquals("www.elastic.co", term.toString());
+            assertEquals(81, offset.startOffset());
             assertFalse(tokenizer.incrementToken());
             tokenizer.end();
+            assertEquals(testData.length(), offset.endOffset());
         }
     }
 
@@ -52,9 +65,11 @@ public void testTokenize_emptyString() throws IOException {
             tokenizer.setReader(new StringReader(testData));
             tokenizer.reset();
             CharTermAttribute term = tokenizer.addAttribute(CharTermAttribute.class);
+            OffsetAttribute offset = tokenizer.addAttribute(OffsetAttribute.class);
             assertFalse(tokenizer.incrementToken());
             assertEquals("", term.toString());
             tokenizer.end();
+            assertEquals(testData.length(), offset.endOffset());
         }
     }
 }

From 1856e92df7e8df07ada4cae47f4cba1c58bae48a Mon Sep 17 00:00:00 2001
From: David Roberts <dave.roberts@elastic.co>
Date: Tue, 7 Jan 2020 10:23:40 +0000
Subject: [PATCH 418/686] [ML] Improve uniqueness of result document IDs
 (#50644)

Switch from a 32 bit Java hash to a 128 bit Murmur hash for
creating document IDs from by/over/partition field values.
The 32 bit Java hash was not sufficiently unique, and could
produce identical numbers for relatively common combinations
of by/partition field values such as L018/128 and L017/228.

Fixes #50613
---
 .../xpack/core/ml/MachineLearningField.java   | 17 ++++++
 .../core/ml/job/results/AnomalyRecord.java    | 12 +++--
 .../xpack/core/ml/job/results/Forecast.java   |  6 +--
 .../xpack/core/ml/job/results/Influencer.java |  3 +-
 .../xpack/core/ml/job/results/ModelPlot.java  |  7 +--
 .../ml/job/results/AnomalyRecordTests.java    | 30 +++++++----
 .../core/ml/job/results/InfluencerTests.java  |  6 +--
 .../xpack/ml/job/results/ForecastTests.java   | 12 ++---
 .../xpack/ml/job/results/ModelPlotTests.java  | 54 +++++++++++++++----
 9 files changed, 103 insertions(+), 44 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/MachineLearningField.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/MachineLearningField.java
index 5c3da41df7349..30dda7e066db2 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/MachineLearningField.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/MachineLearningField.java
@@ -5,10 +5,18 @@
  */
 package org.elasticsearch.xpack.core.ml;
 
+import org.elasticsearch.common.Numbers;
+import org.elasticsearch.common.hash.MurmurHash3;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 
+import java.math.BigInteger;
+import java.nio.charset.StandardCharsets;
+import java.util.Arrays;
+import java.util.Objects;
+import java.util.stream.Collectors;
+
 public final class MachineLearningField {
     public static final Setting<Boolean> AUTODETECT_PROCESS =
             Setting.boolSetting("xpack.ml.autodetect_process", true, Setting.Property.NodeScope);
@@ -19,4 +27,13 @@ public final class MachineLearningField {
 
     private MachineLearningField() {}
 
+    public static String valuesToId(String... values) {
+        String combined = Arrays.stream(values).filter(Objects::nonNull).collect(Collectors.joining());
+        byte[] bytes = combined.getBytes(StandardCharsets.UTF_8);
+        MurmurHash3.Hash128 hash = MurmurHash3.hash128(bytes, 0, bytes.length, 0, new MurmurHash3.Hash128());
+        byte[] hashedBytes = new byte[16];
+        System.arraycopy(Numbers.longToBytes(hash.h1), 0, hashedBytes, 0, 8);
+        System.arraycopy(Numbers.longToBytes(hash.h2), 0, hashedBytes, 8, 8);
+        return new BigInteger(hashedBytes) + "_" + combined.length();
+    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/AnomalyRecord.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/AnomalyRecord.java
index e95e4cadc3567..98a59f2ef74eb 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/AnomalyRecord.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/AnomalyRecord.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.common.xcontent.ObjectParser.ValueType;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.core.ml.MachineLearningField;
 import org.elasticsearch.xpack.core.ml.job.config.Detector;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
@@ -353,12 +354,13 @@ public String getJobId() {
      * Data store ID of this record.
      */
     public String getId() {
-        int valuesHash = Objects.hash(byFieldValue, overFieldValue, partitionFieldValue);
-        int length = (byFieldValue == null ? 0 : byFieldValue.length()) +
-                (overFieldValue == null ? 0 : overFieldValue.length()) +
-                (partitionFieldValue == null ? 0 : partitionFieldValue.length());
+        return buildId(jobId, timestamp, bucketSpan, detectorIndex, byFieldValue, overFieldValue, partitionFieldValue);
+    }
 
-        return jobId + "_record_" + timestamp.getTime() + "_" + bucketSpan + "_" + detectorIndex + "_" + valuesHash + "_" + length;
+    static String buildId(String jobId, Date timestamp, long bucketSpan, int detectorIndex,
+                          String byFieldValue, String overFieldValue, String partitionFieldValue) {
+        return jobId + "_record_" + timestamp.getTime() + "_" + bucketSpan + "_" + detectorIndex + "_"
+            + MachineLearningField.valuesToId(byFieldValue, overFieldValue, partitionFieldValue);
     }
 
     public int getDetectorIndex() {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/Forecast.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/Forecast.java
index 5f4e3c829c3d5..097ecdabe9c37 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/Forecast.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/Forecast.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.common.xcontent.ObjectParser.ValueType;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.core.ml.MachineLearningField;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.common.time.TimeUtils;
 
@@ -165,12 +166,9 @@ public String getForecastId() {
     }
 
     public String getId() {
-        int valuesHash = Objects.hash(byFieldValue, partitionFieldValue);
-        int length = (byFieldValue == null ? 0 : byFieldValue.length()) +
-                (partitionFieldValue == null ? 0 : partitionFieldValue.length());
         return jobId + "_model_forecast_" + forecastId + "_" + timestamp.getTime()
                 + "_" + bucketSpan + "_" + detectorIndex + "_"
-                + valuesHash + "_" + length;
+                + MachineLearningField.valuesToId(byFieldValue, partitionFieldValue);
     }
 
     public Date getTimestamp() {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/Influencer.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/Influencer.java
index d17b375459bb4..771f55cc96efd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/Influencer.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/Influencer.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.common.xcontent.ObjectParser.ValueType;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.core.ml.MachineLearningField;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 import org.elasticsearch.xpack.core.common.time.TimeUtils;
@@ -134,7 +135,7 @@ public String getJobId() {
 
     public String getId() {
         return jobId + "_influencer_" + timestamp.getTime() + "_" + bucketSpan + "_" +
-                influenceField + "_" + influenceValue.hashCode() + "_" + influenceValue.length();
+                influenceField + "_" + MachineLearningField.valuesToId(influenceValue);
     }
 
     public double getProbability() {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ModelPlot.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ModelPlot.java
index ab7235ca27ac4..deae8ff1e2e78 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ModelPlot.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ModelPlot.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.common.xcontent.ObjectParser.ValueType;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.core.ml.MachineLearningField;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.common.time.TimeUtils;
 
@@ -183,12 +184,8 @@ public String getJobId() {
     }
 
     public String getId() {
-        int valuesHash = Objects.hash(byFieldValue, overFieldValue, partitionFieldValue);
-        int length = (byFieldValue == null ? 0 : byFieldValue.length()) +
-                (overFieldValue == null ? 0 : overFieldValue.length()) +
-                (partitionFieldValue == null ? 0 : partitionFieldValue.length());
         return jobId + "_model_plot_" + timestamp.getTime() + "_" + bucketSpan
-                + "_" + detectorIndex + "_" + valuesHash + "_" + length;
+                + "_" + detectorIndex + "_" + MachineLearningField.valuesToId(byFieldValue, overFieldValue, partitionFieldValue);
     }
 
     public Date getTimestamp() {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/results/AnomalyRecordTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/results/AnomalyRecordTests.java
index 7c94e6721435c..c300d8d908f0e 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/results/AnomalyRecordTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/results/AnomalyRecordTests.java
@@ -14,17 +14,20 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.MachineLearningField;
+import org.elasticsearch.xpack.core.ml.utils.MlStrings;
 
 import java.io.IOException;
+import java.nio.charset.StandardCharsets;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.Date;
 import java.util.List;
 import java.util.Map;
-import java.util.Objects;
 
 import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.lessThanOrEqualTo;
 
 public class AnomalyRecordTests extends AbstractSerializingTestCase<AnomalyRecord> {
 
@@ -174,28 +177,23 @@ public void testId() {
         String overFieldValue = null;
         String partitionFieldValue = null;
 
-        int valuesHash = Objects.hash(byFieldValue, overFieldValue, partitionFieldValue);
-        assertEquals("test-job_record_1000_60_0_" + valuesHash + "_0", record.getId());
+        assertEquals("test-job_record_1000_60_0_0_0", record.getId());
 
-        int length = 0;
         if (randomBoolean()) {
             byFieldValue = randomAlphaOfLength(10);
-            length += byFieldValue.length();
             record.setByFieldValue(byFieldValue);
         }
         if (randomBoolean()) {
             overFieldValue = randomAlphaOfLength(10);
-            length += overFieldValue.length();
             record.setOverFieldValue(overFieldValue);
         }
         if (randomBoolean()) {
             partitionFieldValue = randomAlphaOfLength(10);
-            length += partitionFieldValue.length();
             record.setPartitionFieldValue(partitionFieldValue);
         }
 
-        valuesHash = Objects.hash(byFieldValue, overFieldValue, partitionFieldValue);
-        assertEquals("test-job_record_1000_60_0_" + valuesHash + "_" + length, record.getId());
+        String valuesPart = MachineLearningField.valuesToId(byFieldValue, overFieldValue, partitionFieldValue);
+        assertEquals("test-job_record_1000_60_0_" + valuesPart, record.getId());
     }
 
     public void testStrictParser_IsLenientOnTopLevelFields() throws IOException {
@@ -222,4 +220,18 @@ public void testLenientParser() throws IOException {
             AnomalyRecord.LENIENT_PARSER.apply(parser, null);
         }
     }
+
+    public void testIdLength() {
+        String jobId = randomAlphaOfLength(MlStrings.ID_LENGTH_LIMIT);
+        Date timestamp = new Date(Long.MAX_VALUE);
+        long bucketSpan = Long.MAX_VALUE;
+        int detectorIndex = Integer.MAX_VALUE;
+        String byFieldValue = randomAlphaOfLength(randomIntBetween(100, 1000));
+        String overFieldValue = randomAlphaOfLength(randomIntBetween(100, 1000));
+        String partitionFieldValue = randomAlphaOfLength(randomIntBetween(100, 1000));
+
+        String id = AnomalyRecord.buildId(jobId, timestamp, bucketSpan, detectorIndex, byFieldValue, overFieldValue, partitionFieldValue);
+        // 512 comes from IndexRequest.validate()
+        assertThat(id.getBytes(StandardCharsets.UTF_8).length, lessThanOrEqualTo(512));
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/results/InfluencerTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/results/InfluencerTests.java
index 7b2da1d795539..7aee1829acc9d 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/results/InfluencerTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/results/InfluencerTests.java
@@ -12,10 +12,10 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.MachineLearningField;
 
 import java.io.IOException;
 import java.util.Date;
-import java.util.Objects;
 
 public class InfluencerTests extends AbstractSerializingTestCase<Influencer> {
 
@@ -64,8 +64,8 @@ public void testToXContentDoesNotIncludeNameValueFieldWhenReservedWord() throws
     public void testId() {
         String influencerFieldValue = "wopr";
         Influencer influencer = new Influencer("job-foo", "host", influencerFieldValue, new Date(1000), 300L);
-        int valueHash = Objects.hashCode(influencerFieldValue);
-        assertEquals("job-foo_influencer_1000_300_host_" + valueHash + "_" + influencerFieldValue.length(), influencer.getId());
+        String valuePart = MachineLearningField.valuesToId(influencerFieldValue);
+        assertEquals("job-foo_influencer_1000_300_host_" + valuePart, influencer.getId());
     }
 
     public void testLenientParser() throws IOException {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/results/ForecastTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/results/ForecastTests.java
index a5c15716ea293..ba8cb203495e4 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/results/ForecastTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/results/ForecastTests.java
@@ -9,11 +9,11 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.MachineLearningField;
 import org.elasticsearch.xpack.core.ml.job.results.Forecast;
 
 import java.io.IOException;
 import java.util.Date;
-import java.util.Objects;
 
 import static org.hamcrest.Matchers.containsString;
 
@@ -72,23 +72,19 @@ public void testId() {
         String byFieldValue = null;
         String partitionFieldValue = null;
 
-        int valuesHash = Objects.hash(byFieldValue, partitionFieldValue);
-        assertEquals("job-foo_model_forecast_222_100_60_2_" + valuesHash + "_0", forecast.getId());
+        assertEquals("job-foo_model_forecast_222_100_60_2_0_0", forecast.getId());
 
-        int length = 0;
         if (randomBoolean()) {
             byFieldValue = randomAlphaOfLength(10);
-            length += byFieldValue.length();
             forecast.setByFieldValue(byFieldValue);
         }
         if (randomBoolean()) {
             partitionFieldValue = randomAlphaOfLength(10);
-            length += partitionFieldValue.length();
             forecast.setPartitionFieldValue(partitionFieldValue);
         }
 
-        valuesHash = Objects.hash(byFieldValue, partitionFieldValue);
-        assertEquals("job-foo_model_forecast_222_100_60_2_" + valuesHash + "_" + length, forecast.getId());
+        String valuesPart = MachineLearningField.valuesToId(byFieldValue, partitionFieldValue);
+        assertEquals("job-foo_model_forecast_222_100_60_2_" + valuesPart, forecast.getId());
     }
 
     public void testStrictParser() throws IOException {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/results/ModelPlotTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/results/ModelPlotTests.java
index 37788bfa203d2..c7451f6cc045a 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/results/ModelPlotTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/results/ModelPlotTests.java
@@ -12,11 +12,15 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.MachineLearningField;
 import org.elasticsearch.xpack.core.ml.job.results.ModelPlot;
 
 import java.io.IOException;
+import java.util.ArrayList;
 import java.util.Date;
-import java.util.Objects;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
 
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.not;
@@ -221,28 +225,23 @@ public void testId() {
         String overFieldValue = null;
         String partitionFieldValue = null;
 
-        int valuesHash = Objects.hash(byFieldValue, overFieldValue, partitionFieldValue);
-        assertEquals("job-foo_model_plot_100_60_33_" + valuesHash + "_0", plot.getId());
+        assertEquals("job-foo_model_plot_100_60_33_0_0", plot.getId());
 
-        int length = 0;
         if (randomBoolean()) {
             byFieldValue = randomAlphaOfLength(10);
-            length += byFieldValue.length();
             plot.setByFieldValue(byFieldValue);
         }
         if (randomBoolean()) {
             overFieldValue = randomAlphaOfLength(10);
-            length += overFieldValue.length();
             plot.setOverFieldValue(overFieldValue);
         }
         if (randomBoolean()) {
             partitionFieldValue = randomAlphaOfLength(10);
-            length += partitionFieldValue.length();
             plot.setPartitionFieldValue(partitionFieldValue);
         }
 
-        valuesHash = Objects.hash(byFieldValue, overFieldValue, partitionFieldValue);
-        assertEquals("job-foo_model_plot_100_60_33_" + valuesHash + "_" + length, plot.getId());
+        String valuesPart = MachineLearningField.valuesToId(byFieldValue, overFieldValue, partitionFieldValue);
+        assertEquals("job-foo_model_plot_100_60_33_" + valuesPart, plot.getId());
     }
 
     public void testStrictParser() throws IOException {
@@ -262,6 +261,43 @@ public void testLenientParser() throws IOException {
         }
     }
 
+    public void testIdUniqueness() {
+        ModelPlot modelPlot = new ModelPlot("foo", new Date(), 3600, 0);
+
+        String[] partitionFieldValues =  { "730", "132", "358", "552", "888", "236", "224", "674",
+                                           "438", "128", "722", "560", "228", "628", "226", "656" };
+        String[] byFieldValues = { "S000", "S001", "S002", "S003", "S004", "S005", "S006", "S007", "S008", "S009",
+                                   "S010", "S011", "S012", "S013", "S014", "S015", "S016", "S017", "S018", "S019",
+                                   "S020", "S021", "S022", "S023", "S024", "S025", "S026", "S027", "S028", "S029",
+                                   "S057", "S058", "S059", "M020", "M021", "M026", "M027", "M028", "M029", "M030",
+                                   "M031", "M032", "M033", "M056", "M057", "M058", "M059", "M060", "M061", "M062",
+                                   "M063", "M086", "M087", "M088", "M089", "M090", "M091", "M092", "M093", "M116",
+                                   "M117", "M118", "M119", "L012", "L013", "L014", "L017", "L018", "L019", "L023",
+                                   "L024", "L025", "L029", "L030", "L031" };
+
+        Map<String, List<String>> uniqueIds = new HashMap<>();
+
+        for (String partitionFieldValue : partitionFieldValues) {
+            modelPlot.setPartitionFieldValue(partitionFieldValue);
+            for (String byFieldValue : byFieldValues) {
+                modelPlot.setByFieldValue(byFieldValue);
+                String id = modelPlot.getId();
+                uniqueIds.compute(id, (k, v) -> {
+                   if (v == null) {
+                       v = new ArrayList<>();
+                   }
+                   v.add(partitionFieldValue + "/" + byFieldValue);
+                   if (v.size() > 1) {
+                       logger.error("Duplicates for ID [" + id + "]: " + v);
+                   }
+                   return v;
+                });
+            }
+        }
+
+        assertEquals(partitionFieldValues.length * byFieldValues.length, uniqueIds.size());
+    }
+
     private ModelPlot createFullyPopulated() {
         ModelPlot modelPlot = new ModelPlot("foo", new Date(12345678L), 360L, 22);
         modelPlot.setByFieldName("by");

From 2589de88532139b30f4f45758680f5bbbbb314ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Tue, 7 Jan 2020 12:55:57 +0100
Subject: [PATCH 419/686] Implement testStopAndRestart for ClassificationIT
 (#50585)

---
 .../ml/integration/ClassificationIT.java      | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 6d96f627b3f00..0397eb7cc2363 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -19,12 +19,14 @@
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.WriteRequest;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.core.ml.action.EvaluateDataFrameAction;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
+import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsState;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParams;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParamsTests;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
@@ -44,6 +46,7 @@
 import static java.util.stream.Collectors.toList;
 import static org.elasticsearch.common.xcontent.support.XContentMapValues.extractValue;
 import static org.hamcrest.Matchers.allOf;
+import static org.hamcrest.Matchers.anyOf;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.greaterThan;
 import static org.hamcrest.Matchers.greaterThanOrEqualTo;
@@ -243,6 +246,64 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty_DependentVariableI
             "classification_training_percent_is_50_boolean", BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES, "boolean");
     }
 
+    public void testStopAndRestart() throws Exception {
+        initialize("classification_stop_and_restart");
+        String predictedClassField = KEYWORD_FIELD + "_prediction";
+        indexData(sourceIndex, 350, 0, KEYWORD_FIELD);
+
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(KEYWORD_FIELD));
+        registerAnalytics(config);
+        putAnalytics(config);
+
+        assertIsStopped(jobId);
+        assertProgress(jobId, 0, 0, 0, 0);
+
+        startAnalytics(jobId);
+
+        // Wait until state is one of REINDEXING or ANALYZING, or until it is STOPPED.
+        assertBusy(() -> {
+            DataFrameAnalyticsState state = getAnalyticsStats(jobId).getState();
+            assertThat(
+                state,
+                is(anyOf(
+                    equalTo(DataFrameAnalyticsState.REINDEXING),
+                    equalTo(DataFrameAnalyticsState.ANALYZING),
+                    equalTo(DataFrameAnalyticsState.STOPPED))));
+        });
+        stopAnalytics(jobId);
+        waitUntilAnalyticsIsStopped(jobId);
+
+        // Now let's start it again
+        try {
+            startAnalytics(jobId);
+        } catch (Exception e) {
+            if (e.getMessage().equals("Cannot start because the job has already finished")) {
+                // That means the job had managed to complete
+            } else {
+                throw e;
+            }
+        }
+
+        waitUntilAnalyticsIsStopped(jobId, TimeValue.timeValueMinutes(1));
+
+        SearchResponse sourceData = client().prepareSearch(sourceIndex).setTrackTotalHits(true).setSize(1000).get();
+        for (SearchHit hit : sourceData.getHits()) {
+            Map<String, Object> destDoc = getDestDoc(config, hit);
+            Map<String, Object> resultsObject = getFieldValue(destDoc, "ml");
+            assertThat(getFieldValue(resultsObject, predictedClassField), is(in(KEYWORD_FIELD_VALUES)));
+            assertThat(getFieldValue(resultsObject, "is_training"), is(true));
+            assertTopClasses(resultsObject, 2, KEYWORD_FIELD, KEYWORD_FIELD_VALUES);
+        }
+
+        assertProgress(jobId, 100, 100, 100, 100);
+        assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
+        assertInferenceModelPersisted(jobId);
+        assertMlResultsFieldMappings(predictedClassField, "keyword");
+        assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml." + predictedClassField);
+
+    }
+
     public void testDependentVariableCardinalityTooHighError() throws Exception {
         initialize("cardinality_too_high");
         indexData(sourceIndex, 6, 5, KEYWORD_FIELD);

From e3772a308566b6eaa82ffae79317d2919ac2ddca Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Tue, 7 Jan 2020 08:21:20 -0500
Subject: [PATCH 420/686] [ML][Inference] Add support for models shipped as
 resources (#50680)

This adds support for models that are shipped as resources in the ML plugin. The first of which is the `lang_ident` model.
---
 .../client/MachineLearningIT.java             |  10 +-
 .../action/GetTrainedModelsStatsAction.java   |   6 +
 .../core/ml/inference/TrainedModelConfig.java |   5 +
 .../xpack/core/ml/job/messages/Messages.java  |   4 +-
 .../ml/integration/InferenceIngestIT.java     |  26 ++++
 .../xpack/ml/integration/TrainedModelIT.java  |  42 +++----
 .../TransportGetTrainedModelsAction.java      |   2 +-
 .../persistence/TrainedModelProvider.java     | 111 +++++++++++++++++-
 .../TrainedModelProviderTests.java            |  74 ++++++++++++
 .../LangIdentNeuralNetworkInferenceTests.java |  30 ++---
 .../rest-api-spec/test/ml/inference_crud.yml  |  23 ++--
 .../test/ml/inference_stats_crud.yml          |  54 ++++-----
 12 files changed, 290 insertions(+), 97 deletions(-)
 create mode 100644 x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProviderTests.java

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index f3b63801987db..0985cf4fd91a6 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -2168,8 +2168,8 @@ public void testGetTrainedModels() throws Exception {
             GetTrainedModelsResponse getTrainedModelsResponse = execute(
                 GetTrainedModelsRequest.getAllTrainedModelConfigsRequest(),
                 machineLearningClient::getTrainedModels, machineLearningClient::getTrainedModelsAsync);
-            assertThat(getTrainedModelsResponse.getTrainedModels(), hasSize(numberOfModels));
-            assertThat(getTrainedModelsResponse.getCount(), equalTo(5L));
+            assertThat(getTrainedModelsResponse.getTrainedModels(), hasSize(numberOfModels + 1));
+            assertThat(getTrainedModelsResponse.getCount(), equalTo(5L + 1));
         }
         {
             GetTrainedModelsResponse getTrainedModelsResponse = execute(
@@ -2192,7 +2192,7 @@ public void testGetTrainedModels() throws Exception {
 
     public void testGetTrainedModelsStats() throws Exception {
         MachineLearningClient machineLearningClient = highLevelClient().machineLearning();
-        String modelIdPrefix = "get-trained-model-stats-";
+        String modelIdPrefix = "a-get-trained-model-stats-";
         int numberOfModels = 5;
         for (int i = 0; i < numberOfModels; ++i) {
             String modelId = modelIdPrefix + i;
@@ -2224,8 +2224,8 @@ public void testGetTrainedModelsStats() throws Exception {
             GetTrainedModelsStatsResponse getTrainedModelsStatsResponse = execute(
                 GetTrainedModelsStatsRequest.getAllTrainedModelStatsRequest(),
                 machineLearningClient::getTrainedModelsStats, machineLearningClient::getTrainedModelsStatsAsync);
-            assertThat(getTrainedModelsStatsResponse.getTrainedModelStats(), hasSize(numberOfModels));
-            assertThat(getTrainedModelsStatsResponse.getCount(), equalTo(5L));
+            assertThat(getTrainedModelsStatsResponse.getTrainedModelStats(), hasSize(numberOfModels + 1));
+            assertThat(getTrainedModelsStatsResponse.getCount(), equalTo(5L + 1));
             assertThat(getTrainedModelsStatsResponse.getTrainedModelStats().get(0).getPipelineCount(), equalTo(1));
             assertThat(getTrainedModelsStatsResponse.getTrainedModelStats().get(1).getPipelineCount(), equalTo(0));
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/GetTrainedModelsStatsAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/GetTrainedModelsStatsAction.java
index f3cb43e8ef790..3e91fd0444b0a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/GetTrainedModelsStatsAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/GetTrainedModelsStatsAction.java
@@ -24,6 +24,7 @@
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Collections;
+import java.util.Comparator;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
@@ -98,6 +99,10 @@ public TrainedModelStats(StreamInput in) throws IOException {
                 pipelineCount = in.readVInt();
             }
 
+            public String getModelId() {
+                return modelId;
+            }
+
             @Override
             public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
                 builder.startObject();
@@ -186,6 +191,7 @@ public Response build() {
                         0 :
                         ingestStats.getPipelineStats().size()));
                 });
+                trainedModelStats.sort(Comparator.comparing(TrainedModelStats::getModelId));
                 return new Response(new QueryPage<>(trainedModelStats, totalModelCount, RESULTS_FIELD));
             }
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
index d0056dce73467..be4d40efc8501 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
@@ -409,6 +409,11 @@ public Builder setDefinitionFromString(String definitionFromString) {
             return this;
         }
 
+        public Builder clearDefinition() {
+            this.definition = null;
+            return this;
+        }
+
         private Builder setLazyDefinition(TrainedModelDefinition.Builder parsedTrainedModel) {
             if (parsedTrainedModel == null) {
                 return this;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
index 5e7d3ee3318c6..1b80d1963598e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
@@ -87,10 +87,12 @@ public final class Messages {
     public static final String INFERENCE_CONFIG_NOT_SUPPORTED_ON_VERSION =
         "Configuration [{0}] requires minimum node version [{1}] (current minimum node version [{2}]";
     public static final String MODEL_DEFINITION_NOT_FOUND = "Could not find trained model definition [{0}]";
+    public static final String INFERENCE_CANNOT_DELETE_MODEL =
+        "Unable to delete model [{0}]";
     public static final String MODEL_DEFINITION_TRUNCATED =
         "Model definition truncated. Unable to deserialize trained model definition [{0}]";
     public static final String INFERENCE_FAILED_TO_DESERIALIZE = "Could not deserialize trained model [{0}]";
-    public static final String INFERENCE_TO_MANY_DEFINITIONS_REQUESTED =
+    public static final String INFERENCE_TOO_MANY_DEFINITIONS_REQUESTED =
         "Getting model definition is not supported when getting more than one model";
     public static final String INFERENCE_WARNING_ALL_FIELDS_MISSING = "Model [{0}] could not be inferred as all fields were missing";
 
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
index 05b425363c5d3..27e83e04b412b 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
@@ -232,6 +232,32 @@ public void testSimulate() {
             containsString("Could not find trained model [test_classification_missing]"));
     }
 
+    public void testSimulateLangIdent() {
+        String source = "{\n" +
+            "  \"pipeline\": {\n" +
+            "    \"processors\": [\n" +
+            "      {\n" +
+            "        \"inference\": {\n" +
+            "          \"inference_config\": {\"classification\":{}},\n" +
+            "          \"model_id\": \"lang_ident_model_1\",\n" +
+            "          \"field_mappings\": {}\n" +
+            "        }\n" +
+            "      }\n" +
+            "    ]\n" +
+            "  },\n" +
+            "  \"docs\": [\n" +
+            "    {\"_source\": {\n" +
+            "      \"text\": \"this is some plain text.\"\n" +
+            "    }}]\n" +
+            "}";
+
+        SimulatePipelineResponse response = client().admin().cluster()
+            .prepareSimulatePipeline(new BytesArray(source.getBytes(StandardCharsets.UTF_8)),
+                XContentType.JSON).get();
+        SimulateDocumentBaseResult baseResult = (SimulateDocumentBaseResult)response.getResults().get(0);
+        assertThat(baseResult.getIngestDocument().getFieldValue("ml.inference.predicted_value", String.class), equalTo("en"));
+    }
+
     private Map<String, Object> generateSourceDoc() {
         return new HashMap<>(){{
             put("col1", randomFrom("female", "male"));
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
index 5502a6c2c80b7..5911732257e6a 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
@@ -60,8 +60,8 @@ protected boolean preserveTemplatesUponCompletion() {
     }
 
     public void testGetTrainedModels() throws IOException {
-        String modelId = "test_regression_model";
-        String modelId2 = "test_regression_model-2";
+        String modelId = "a_test_regression_model";
+        String modelId2 = "a_test_regression_model-2";
         Request model1 = new Request("PUT",
             InferenceIndexConstants.LATEST_INDEX_NAME + "/_doc/" + modelId);
         model1.setJsonEntity(buildRegressionModel(modelId));
@@ -84,36 +84,36 @@ public void testGetTrainedModels() throws IOException {
         assertThat(getModel.getStatusLine().getStatusCode(), equalTo(200));
         String response = EntityUtils.toString(getModel.getEntity());
 
-        assertThat(response, containsString("\"model_id\":\"test_regression_model\""));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model\""));
         assertThat(response, containsString("\"count\":1"));
 
         getModel = client().performRequest(new Request("GET",
-            MachineLearning.BASE_PATH + "inference/test_regression*"));
+            MachineLearning.BASE_PATH + "inference/a_test_regression*"));
         assertThat(getModel.getStatusLine().getStatusCode(), equalTo(200));
 
         response = EntityUtils.toString(getModel.getEntity());
-        assertThat(response, containsString("\"model_id\":\"test_regression_model\""));
-        assertThat(response, containsString("\"model_id\":\"test_regression_model-2\""));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model\""));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model-2\""));
         assertThat(response, not(containsString("\"definition\"")));
         assertThat(response, containsString("\"count\":2"));
 
         getModel = client().performRequest(new Request("GET",
-            MachineLearning.BASE_PATH + "inference/test_regression_model?human=true&include_model_definition=true"));
+            MachineLearning.BASE_PATH + "inference/a_test_regression_model?human=true&include_model_definition=true"));
         assertThat(getModel.getStatusLine().getStatusCode(), equalTo(200));
 
         response = EntityUtils.toString(getModel.getEntity());
-        assertThat(response, containsString("\"model_id\":\"test_regression_model\""));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model\""));
         assertThat(response, containsString("\"estimated_heap_memory_usage_bytes\""));
         assertThat(response, containsString("\"estimated_heap_memory_usage\""));
         assertThat(response, containsString("\"definition\""));
         assertThat(response, containsString("\"count\":1"));
 
         getModel = client().performRequest(new Request("GET",
-            MachineLearning.BASE_PATH + "inference/test_regression_model?decompress_definition=false&include_model_definition=true"));
+            MachineLearning.BASE_PATH + "inference/a_test_regression_model?decompress_definition=false&include_model_definition=true"));
         assertThat(getModel.getStatusLine().getStatusCode(), equalTo(200));
 
         response = EntityUtils.toString(getModel.getEntity());
-        assertThat(response, containsString("\"model_id\":\"test_regression_model\""));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model\""));
         assertThat(response, containsString("\"estimated_heap_memory_usage_bytes\""));
         assertThat(response, containsString("\"compressed_definition\""));
         assertThat(response, not(containsString("\"definition\"")));
@@ -121,17 +121,17 @@ public void testGetTrainedModels() throws IOException {
 
         ResponseException responseException = expectThrows(ResponseException.class, () ->
             client().performRequest(new Request("GET",
-                MachineLearning.BASE_PATH + "inference/test_regression*?human=true&include_model_definition=true")));
+                MachineLearning.BASE_PATH + "inference/a_test_regression*?human=true&include_model_definition=true")));
         assertThat(EntityUtils.toString(responseException.getResponse().getEntity()),
-            containsString(Messages.INFERENCE_TO_MANY_DEFINITIONS_REQUESTED));
+            containsString(Messages.INFERENCE_TOO_MANY_DEFINITIONS_REQUESTED));
 
         getModel = client().performRequest(new Request("GET",
-            MachineLearning.BASE_PATH + "inference/test_regression_model,test_regression_model-2"));
+            MachineLearning.BASE_PATH + "inference/a_test_regression_model,a_test_regression_model-2"));
         assertThat(getModel.getStatusLine().getStatusCode(), equalTo(200));
 
         response = EntityUtils.toString(getModel.getEntity());
-        assertThat(response, containsString("\"model_id\":\"test_regression_model\""));
-        assertThat(response, containsString("\"model_id\":\"test_regression_model-2\""));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model\""));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model-2\""));
         assertThat(response, containsString("\"count\":2"));
 
         getModel = client().performRequest(new Request("GET",
@@ -149,17 +149,17 @@ public void testGetTrainedModels() throws IOException {
         assertThat(getModel.getStatusLine().getStatusCode(), equalTo(200));
 
         response = EntityUtils.toString(getModel.getEntity());
-        assertThat(response, containsString("\"count\":2"));
-        assertThat(response, containsString("\"model_id\":\"test_regression_model\""));
-        assertThat(response, not(containsString("\"model_id\":\"test_regression_model-2\"")));
+        assertThat(response, containsString("\"count\":3"));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model\""));
+        assertThat(response, not(containsString("\"model_id\":\"a_test_regression_model-2\"")));
 
         getModel = client().performRequest(new Request("GET", MachineLearning.BASE_PATH + "inference?from=1&size=1"));
         assertThat(getModel.getStatusLine().getStatusCode(), equalTo(200));
 
         response = EntityUtils.toString(getModel.getEntity());
-        assertThat(response, containsString("\"count\":2"));
-        assertThat(response, not(containsString("\"model_id\":\"test_regression_model\"")));
-        assertThat(response, containsString("\"model_id\":\"test_regression_model-2\""));
+        assertThat(response, containsString("\"count\":3"));
+        assertThat(response, not(containsString("\"model_id\":\"a_test_regression_model\"")));
+        assertThat(response, containsString("\"model_id\":\"a_test_regression_model-2\""));
     }
 
     public void testDeleteTrainedModels() throws IOException {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetTrainedModelsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetTrainedModelsAction.java
index 15629579368f3..4b467912e1b43 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetTrainedModelsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportGetTrainedModelsAction.java
@@ -50,7 +50,7 @@ protected void doExecute(Task task, Request request, ActionListener<Response> li
 
                 if (request.isIncludeModelDefinition() && totalAndIds.v2().size() > 1) {
                     listener.onFailure(
-                        ExceptionsHelper.badRequestException(Messages.INFERENCE_TO_MANY_DEFINITIONS_REQUESTED)
+                        ExceptionsHelper.badRequestException(Messages.INFERENCE_TOO_MANY_DEFINITIONS_REQUESTED)
                     );
                     return;
                 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProvider.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProvider.java
index 20476855e26ca..993de87b07193 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProvider.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProvider.java
@@ -8,6 +8,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.ResourceAlreadyExistsException;
 import org.elasticsearch.ResourceNotFoundException;
@@ -31,6 +32,7 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.io.Streams;
 import org.elasticsearch.common.regex.Regex;
 import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
@@ -39,6 +41,7 @@
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
+import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexNotFoundException;
@@ -64,8 +67,10 @@
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.net.URL;
 import java.util.ArrayList;
 import java.util.Collections;
+import java.util.Comparator;
 import java.util.HashSet;
 import java.util.LinkedHashSet;
 import java.util.List;
@@ -78,6 +83,10 @@
 
 public class TrainedModelProvider {
 
+    public static final Set<String> MODELS_STORED_AS_RESOURCE = Collections.singleton("lang_ident_model_1");
+    private static final String MODEL_RESOURCE_PATH = "/org/elasticsearch/xpack/ml/inference/persistence/";
+    private static final String MODEL_RESOURCE_FILE_EXT = ".json";
+
     private static final Logger logger = LogManager.getLogger(TrainedModelProvider.class);
     private final Client client;
     private final NamedXContentRegistry xContentRegistry;
@@ -91,6 +100,12 @@ public TrainedModelProvider(Client client, NamedXContentRegistry xContentRegistr
 
     public void storeTrainedModel(TrainedModelConfig trainedModelConfig,
                                   ActionListener<Boolean> listener) {
+        if (MODELS_STORED_AS_RESOURCE.contains(trainedModelConfig.getModelId())) {
+            listener.onFailure(new ResourceAlreadyExistsException(
+                Messages.getMessage(Messages.INFERENCE_TRAINED_MODEL_EXISTS, trainedModelConfig.getModelId())));
+            return;
+        }
+
         try {
             trainedModelConfig.ensureParsedDefinition(xContentRegistry);
         } catch (IOException ex) {
@@ -184,6 +199,16 @@ private void storeTrainedModelAndDefinition(TrainedModelConfig trainedModelConfi
 
     public void getTrainedModel(final String modelId, final boolean includeDefinition, final ActionListener<TrainedModelConfig> listener) {
 
+        if (MODELS_STORED_AS_RESOURCE.contains(modelId)) {
+            try {
+                listener.onResponse(loadModelFromResource(modelId, includeDefinition == false));
+                return;
+            } catch (ElasticsearchException ex) {
+                listener.onFailure(ex);
+                return;
+            }
+        }
+
         QueryBuilder queryBuilder = QueryBuilders.constantScoreQuery(QueryBuilders
             .idsQuery()
             .addIds(modelId));
@@ -267,11 +292,29 @@ public void getTrainedModels(Set<String> modelIds, boolean allowNoResources, fin
             .addSort("_index", SortOrder.DESC)
             .setQuery(queryBuilder)
             .request();
+        List<TrainedModelConfig> configs = new ArrayList<>(modelIds.size());
+        Set<String> modelsInIndex = Sets.difference(modelIds, MODELS_STORED_AS_RESOURCE);
+        Set<String> modelsAsResource = Sets.intersection(MODELS_STORED_AS_RESOURCE, modelIds);
+        for(String modelId : modelsAsResource) {
+            try {
+                configs.add(loadModelFromResource(modelId, true));
+            } catch (ElasticsearchException ex) {
+                listener.onFailure(ex);
+                return;
+            }
+        }
+        if (modelsInIndex.isEmpty()) {
+            configs.sort(Comparator.comparing(TrainedModelConfig::getModelId));
+            listener.onResponse(configs);
+            return;
+        }
 
         ActionListener<SearchResponse> configSearchHandler = ActionListener.wrap(
             searchResponse -> {
-                Set<String> observedIds = new HashSet<>(searchResponse.getHits().getHits().length, 1.0f);
-                List<TrainedModelConfig> configs = new ArrayList<>(searchResponse.getHits().getHits().length);
+                Set<String> observedIds = new HashSet<>(
+                    searchResponse.getHits().getHits().length + modelsAsResource.size(),
+                    1.0f);
+                observedIds.addAll(modelsAsResource);
                 for(SearchHit searchHit : searchResponse.getHits().getHits()) {
                     try {
                         if (observedIds.contains(searchHit.getId()) == false) {
@@ -294,6 +337,8 @@ public void getTrainedModels(Set<String> modelIds, boolean allowNoResources, fin
                     listener.onFailure(new ResourceNotFoundException(Messages.INFERENCE_NOT_FOUND_MULTIPLE, missingConfigs));
                     return;
                 }
+                // Ensure sorted even with the injection of locally resourced models
+                configs.sort(Comparator.comparing(TrainedModelConfig::getModelId));
                 listener.onResponse(configs);
             },
             listener::onFailure
@@ -303,6 +348,10 @@ public void getTrainedModels(Set<String> modelIds, boolean allowNoResources, fin
     }
 
     public void deleteTrainedModel(String modelId, ActionListener<Boolean> listener) {
+        if (MODELS_STORED_AS_RESOURCE.contains(modelId)) {
+            listener.onFailure(ExceptionsHelper.badRequestException(Messages.getMessage(Messages.INFERENCE_CANNOT_DELETE_MODEL, modelId)));
+            return;
+        }
         DeleteByQueryRequest request = new DeleteByQueryRequest().setAbortOnVersionConflict(false);
 
         request.indices(InferenceIndexConstants.INDEX_PATTERN);
@@ -359,8 +408,8 @@ public void expandIds(String idExpression,
             searchRequest,
             ActionListener.<SearchResponse>wrap(
                 response -> {
-                    Set<String> foundResourceIds = new LinkedHashSet<>();
-                    long totalHitCount = response.getHits().getTotalHits().value;
+                    Set<String> foundResourceIds = new LinkedHashSet<>(matchedResourceIds(tokens));
+                    long totalHitCount = response.getHits().getTotalHits().value + foundResourceIds.size();
                     for (SearchHit hit : response.getHits().getHits()) {
                         Map<String, Object> docSource = hit.getSourceAsMap();
                         if (docSource == null) {
@@ -385,6 +434,37 @@ public void expandIds(String idExpression,
 
     }
 
+    TrainedModelConfig loadModelFromResource(String modelId, boolean nullOutDefinition) {
+        URL resource = getClass().getResource(MODEL_RESOURCE_PATH + modelId + MODEL_RESOURCE_FILE_EXT);
+        if (resource == null) {
+            logger.error("[{}] presumed stored as a resource but not found", modelId);
+            throw new ResourceNotFoundException(
+                Messages.getMessage(Messages.INFERENCE_NOT_FOUND, modelId));
+        }
+        try {
+            BytesReference bytes = Streams.readFully(getClass()
+                .getResourceAsStream(MODEL_RESOURCE_PATH + modelId + MODEL_RESOURCE_FILE_EXT));
+            try (XContentParser parser =
+                     XContentHelper.createParser(xContentRegistry,
+                         LoggingDeprecationHandler.INSTANCE,
+                         bytes,
+                         XContentType.JSON)) {
+                TrainedModelConfig.Builder builder = TrainedModelConfig.fromXContent(parser, true);
+                if (nullOutDefinition) {
+                    builder.clearDefinition();
+                }
+                return builder.build();
+            } catch (IOException ioEx) {
+                logger.error(new ParameterizedMessage("[{}] failed to parse model definition", modelId), ioEx);
+                throw ExceptionsHelper.serverError(INFERENCE_FAILED_TO_DESERIALIZE, ioEx, modelId);
+            }
+        } catch (IOException ex) {
+            String msg = new ParameterizedMessage("[{}] failed to read model as resource", modelId).getFormattedMessage();
+            logger.error(msg, ex);
+            throw ExceptionsHelper.serverError(msg, ex);
+        }
+    }
+
     private QueryBuilder buildQueryIdExpressionQuery(String[] tokens, String resourceIdField) {
         BoolQueryBuilder boolQuery = QueryBuilders.boolQuery()
             .filter(QueryBuilders.termQuery(InferenceIndexConstants.DOC_TYPE.getPreferredName(), TrainedModelConfig.NAME));
@@ -413,6 +493,29 @@ private QueryBuilder buildQueryIdExpressionQuery(String[] tokens, String resourc
         return boolQuery;
     }
 
+    private Set<String> matchedResourceIds(String[] tokens) {
+        if (Strings.isAllOrWildcard(tokens)) {
+            return new HashSet<>(MODELS_STORED_AS_RESOURCE);
+        }
+
+        Set<String> matchedModels = new HashSet<>();
+
+        for (String token : tokens) {
+            if (Regex.isSimpleMatchPattern(token)) {
+                for (String modelId : MODELS_STORED_AS_RESOURCE) {
+                    if(Regex.simpleMatch(token, modelId)) {
+                        matchedModels.add(modelId);
+                    }
+                }
+            } else {
+                if (MODELS_STORED_AS_RESOURCE.contains(token)) {
+                    matchedModels.add(token);
+                }
+            }
+        }
+        return matchedModels;
+    }
+
     private static <T> T handleSearchItem(MultiSearchResponse.Item item,
                                           String resourceId,
                                           CheckedBiFunction<BytesReference, String, T, Exception> parseLeniently) throws Exception {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProviderTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProviderTests.java
new file mode 100644
index 0000000000000..705a8f60dd2f3
--- /dev/null
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProviderTests.java
@@ -0,0 +1,74 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.inference.persistence;
+
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfigTests;
+import org.elasticsearch.xpack.core.ml.job.messages.Messages;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.nullValue;
+import static org.mockito.Mockito.mock;
+
+public class TrainedModelProviderTests extends ESTestCase {
+
+    public void testDeleteModelStoredAsResource() {
+        TrainedModelProvider trainedModelProvider = new TrainedModelProvider(mock(Client.class), xContentRegistry());
+        PlainActionFuture<Boolean> future = new PlainActionFuture<>();
+        // Should be OK as we don't make any client calls
+        trainedModelProvider.deleteTrainedModel("lang_ident_model_1", future);
+        ElasticsearchException ex = expectThrows(ElasticsearchException.class, future::actionGet);
+        assertThat(ex.getMessage(), equalTo(Messages.getMessage(Messages.INFERENCE_CANNOT_DELETE_MODEL, "lang_ident_model_1")));
+    }
+
+    public void testPutModelThatExistsAsResource() {
+        TrainedModelConfig config = TrainedModelConfigTests.createTestInstance("lang_ident_model_1").build();
+        TrainedModelProvider trainedModelProvider = new TrainedModelProvider(mock(Client.class), xContentRegistry());
+        PlainActionFuture<Boolean> future = new PlainActionFuture<>();
+        trainedModelProvider.storeTrainedModel(config, future);
+        ElasticsearchException ex = expectThrows(ElasticsearchException.class, future::actionGet);
+        assertThat(ex.getMessage(), equalTo(Messages.getMessage(Messages.INFERENCE_TRAINED_MODEL_EXISTS, "lang_ident_model_1")));
+    }
+
+    public void testGetModelThatExistsAsResource() throws Exception {
+        TrainedModelProvider trainedModelProvider = new TrainedModelProvider(mock(Client.class), xContentRegistry());
+        for(String modelId : TrainedModelProvider.MODELS_STORED_AS_RESOURCE) {
+            PlainActionFuture<TrainedModelConfig> future = new PlainActionFuture<>();
+            trainedModelProvider.getTrainedModel(modelId, true, future);
+            TrainedModelConfig configWithDefinition = future.actionGet();
+
+            assertThat(configWithDefinition.getModelId(), equalTo(modelId));
+            assertThat(configWithDefinition.ensureParsedDefinition(xContentRegistry()).getModelDefinition(), is(not(nullValue())));
+
+            PlainActionFuture<TrainedModelConfig> futureNoDefinition = new PlainActionFuture<>();
+            trainedModelProvider.getTrainedModel(modelId, false, futureNoDefinition);
+            TrainedModelConfig configWithoutDefinition = futureNoDefinition.actionGet();
+
+            assertThat(configWithoutDefinition.getModelId(), equalTo(modelId));
+            assertThat(configWithDefinition.ensureParsedDefinition(xContentRegistry()).getModelDefinition(), is(not(nullValue())));
+        }
+    }
+
+    public void testGetModelThatExistsAsResourceButIsMissing() {
+        TrainedModelProvider trainedModelProvider = new TrainedModelProvider(mock(Client.class), xContentRegistry());
+        ElasticsearchException ex = expectThrows(ElasticsearchException.class,
+            () -> trainedModelProvider.loadModelFromResource("missing_model", randomBoolean()));
+        assertThat(ex.getMessage(), equalTo(Messages.getMessage(Messages.INFERENCE_NOT_FOUND, "missing_model")));
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
+}
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/trainedmodels/langident/LangIdentNeuralNetworkInferenceTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/trainedmodels/langident/LangIdentNeuralNetworkInferenceTests.java
index c93d2d58dde42..8357f1cb78276 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/trainedmodels/langident/LangIdentNeuralNetworkInferenceTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/trainedmodels/langident/LangIdentNeuralNetworkInferenceTests.java
@@ -5,10 +5,9 @@
  */
 package org.elasticsearch.xpack.ml.inference.trainedmodels.langident;
 
-import org.elasticsearch.common.xcontent.DeprecationHandler;
+import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.client.Client;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
@@ -16,22 +15,26 @@
 import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.ClassificationConfig;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.langident.LanguageExamples;
+import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelProvider;
 
-import java.io.IOException;
-import java.nio.file.Files;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 
 import static org.hamcrest.CoreMatchers.equalTo;
 import static org.hamcrest.Matchers.closeTo;
-
+import static org.mockito.Mockito.mock;
 
 public class LangIdentNeuralNetworkInferenceTests extends ESTestCase {
 
     public void testLangInference() throws Exception {
-        TrainedModelConfig config = getLangIdentModel();
+        TrainedModelProvider trainedModelProvider = new TrainedModelProvider(mock(Client.class), xContentRegistry());
+        PlainActionFuture<TrainedModelConfig> future = new PlainActionFuture<>();
+        // Should be OK as we don't make any client calls
+        trainedModelProvider.getTrainedModel("lang_ident_model_1", true, future);
+        TrainedModelConfig config = future.actionGet();
 
+        config.ensureParsedDefinition(xContentRegistry());
         TrainedModelDefinition trainedModelDefinition = config.getModelDefinition();
         List<LanguageExamples.LanguageExampleEntry> examples = new LanguageExamples().getLanguageExamples();
         ClassificationConfig classificationConfig = new ClassificationConfig(1);
@@ -53,19 +56,6 @@ public void testLangInference() throws Exception {
         }
     }
 
-    private TrainedModelConfig getLangIdentModel() throws IOException {
-        String path = "/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json";
-        try(XContentParser parser =
-                XContentType.JSON.xContent().createParser(
-                    NamedXContentRegistry.EMPTY,
-                    DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
-                    Files.newInputStream(getDataPath(path)))) {
-            TrainedModelConfig config = TrainedModelConfig.fromXContent(parser, true).build();
-            config.ensureParsedDefinition(xContentRegistry());
-            return config;
-        }
-    }
-
     @Override
     protected NamedXContentRegistry xContentRegistry() {
         return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_crud.yml
index a8b199a7a3b59..f72fd1120d81e 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_crud.yml
@@ -1,18 +1,3 @@
----
-"Test get-all given no trained models exist":
-
-  - do:
-      ml.get_trained_models:
-        model_id: "_all"
-  - match: { count: 0 }
-  - match: { trained_model_configs: [] }
-
-  - do:
-      ml.get_trained_models:
-        model_id: "*"
-  - match: { count: 0 }
-  - match: { trained_model_configs: [] }
-
 ---
 "Test get given missing trained model":
 
@@ -111,3 +96,11 @@
       catch: conflict
       ml.delete_trained_model:
         model_id: "used-regression-model"
+---
+"Test get pre-packaged trained models":
+  - do:
+      ml.get_trained_models:
+        model_id: "_all"
+        allow_no_match: false
+  - match: { count: 1 }
+  - match: { trained_model_configs.0.model_id: "lang_ident_model_1" }
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_stats_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_stats_crud.yml
index 6062f6519067f..5143a690b018a 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_stats_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_stats_crud.yml
@@ -5,17 +5,15 @@ setup:
       headers:
         Authorization: "Basic eF9wYWNrX3Jlc3RfdXNlcjp4LXBhY2stdGVzdC1wYXNzd29yZA==" # run as x_pack_rest_user, i.e. the test setup superuser
       index:
-        id: trained_model_config-unused-regression-model1-0
+        id: trained_model_config-a-unused-regression-model1-0
         index: .ml-inference-000001
         body: >
           {
-            "model_id": "unused-regression-model1",
+            "model_id": "a-unused-regression-model1",
             "created_by": "ml_tests",
             "version": "8.0.0",
             "description": "empty model for tests",
             "create_time": 0,
-            "model_version": 0,
-            "model_type": "local",
             "doc_type": "trained_model_config"
           }
 
@@ -23,34 +21,30 @@ setup:
       headers:
         Authorization: "Basic eF9wYWNrX3Jlc3RfdXNlcjp4LXBhY2stdGVzdC1wYXNzd29yZA==" # run as x_pack_rest_user, i.e. the test setup superuser
       index:
-        id: trained_model_config-unused-regression-model-0
+        id: trained_model_config-a-unused-regression-model-0
         index: .ml-inference-000001
         body: >
           {
-            "model_id": "unused-regression-model",
+            "model_id": "a-unused-regression-model",
             "created_by": "ml_tests",
             "version": "8.0.0",
             "description": "empty model for tests",
             "create_time": 0,
-            "model_version": 0,
-            "model_type": "local",
             "doc_type": "trained_model_config"
           }
   - do:
       headers:
         Authorization: "Basic eF9wYWNrX3Jlc3RfdXNlcjp4LXBhY2stdGVzdC1wYXNzd29yZA==" # run as x_pack_rest_user, i.e. the test setup superuser
       index:
-        id: trained_model_config-used-regression-model-0
+        id: trained_model_config-a-used-regression-model-0
         index: .ml-inference-000001
         body: >
           {
-            "model_id": "used-regression-model",
+            "model_id": "a-used-regression-model",
             "created_by": "ml_tests",
             "version": "8.0.0",
             "description": "empty model for tests",
             "create_time": 0,
-            "model_version": 0,
-            "model_type": "local",
             "doc_type": "trained_model_config"
           }
 
@@ -69,7 +63,7 @@ setup:
             "processors": [
               {
                 "inference" : {
-                  "model_id" : "used-regression-model",
+                  "model_id" : "a-used-regression-model",
                   "inference_config": {"regression": {}},
                   "target_field": "regression_field",
                   "field_mappings": {}
@@ -87,7 +81,7 @@ setup:
             "processors": [
               {
                 "inference" : {
-                  "model_id" : "used-regression-model",
+                  "model_id" : "a-used-regression-model",
                   "inference_config": {"regression": {}},
                   "target_field": "regression_field",
                   "field_mappings": {}
@@ -125,18 +119,18 @@ setup:
 
   - do:
       ml.get_trained_models_stats:
-        model_id: "unused-regression-model"
+        model_id: "a-unused-regression-model"
 
   - match: { count: 1 }
 
   - do:
       ml.get_trained_models_stats:
         model_id: "_all"
-  - match: { count: 3 }
-  - match: { trained_model_stats.0.model_id: unused-regression-model }
+  - match: { count: 4 }
+  - match: { trained_model_stats.0.model_id: a-unused-regression-model }
   - match: { trained_model_stats.0.pipeline_count: 0 }
   - is_false: trained_model_stats.0.ingest
-  - match: { trained_model_stats.1.model_id: unused-regression-model1 }
+  - match: { trained_model_stats.1.model_id: a-unused-regression-model1 }
   - match: { trained_model_stats.1.pipeline_count: 0 }
   - is_false: trained_model_stats.1.ingest
   - match: { trained_model_stats.2.pipeline_count: 2 }
@@ -145,11 +139,11 @@ setup:
   - do:
       ml.get_trained_models_stats:
         model_id: "*"
-  - match: { count: 3 }
-  - match: { trained_model_stats.0.model_id: unused-regression-model }
+  - match: { count: 4 }
+  - match: { trained_model_stats.0.model_id: a-unused-regression-model }
   - match: { trained_model_stats.0.pipeline_count: 0 }
   - is_false: trained_model_stats.0.ingest
-  - match: { trained_model_stats.1.model_id: unused-regression-model1 }
+  - match: { trained_model_stats.1.model_id: a-unused-regression-model1 }
   - match: { trained_model_stats.1.pipeline_count: 0 }
   - is_false: trained_model_stats.1.ingest
   - match: { trained_model_stats.2.pipeline_count: 2 }
@@ -157,40 +151,40 @@ setup:
 
   - do:
       ml.get_trained_models_stats:
-        model_id: "unused-regression-model*"
+        model_id: "a-unused-regression-model*"
   - match: { count: 2 }
-  - match: { trained_model_stats.0.model_id: unused-regression-model }
+  - match: { trained_model_stats.0.model_id: a-unused-regression-model }
   - match: { trained_model_stats.0.pipeline_count: 0 }
   - is_false: trained_model_stats.0.ingest
-  - match: { trained_model_stats.1.model_id: unused-regression-model1 }
+  - match: { trained_model_stats.1.model_id: a-unused-regression-model1 }
   - match: { trained_model_stats.1.pipeline_count: 0 }
   - is_false: trained_model_stats.1.ingest
 
   - do:
       ml.get_trained_models_stats:
-        model_id: "unused-regression-model*"
+        model_id: "a-unused-regression-model*"
         size: 1
   - match: { count: 2 }
-  - match: { trained_model_stats.0.model_id: unused-regression-model }
+  - match: { trained_model_stats.0.model_id: a-unused-regression-model }
   - match: { trained_model_stats.0.pipeline_count: 0 }
   - is_false: trained_model_stats.0.ingest
 
   - do:
       ml.get_trained_models_stats:
-        model_id: "unused-regression-model*"
+        model_id: "a-unused-regression-model*"
         from: 1
         size: 1
   - match: { count: 2 }
-  - match: { trained_model_stats.0.model_id: unused-regression-model1 }
+  - match: { trained_model_stats.0.model_id: a-unused-regression-model1 }
   - match: { trained_model_stats.0.pipeline_count: 0 }
   - is_false: trained_model_stats.0.ingest
 
   - do:
       ml.get_trained_models_stats:
-        model_id: "used-regression-model"
+        model_id: "a-used-regression-model"
 
   - match: { count: 1 }
-  - match: { trained_model_stats.0.model_id: used-regression-model }
+  - match: { trained_model_stats.0.model_id: a-used-regression-model }
   - match: { trained_model_stats.0.pipeline_count: 2 }
   - match:
       trained_model_stats.0.ingest.total:

From b19f4df85a7e17101216a738b0c3901ea8ef8808 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Tue, 7 Jan 2020 10:08:13 -0500
Subject: [PATCH 421/686] Disable auto refresh in testSegmentsStats (#50689)

If an auto-refresh happens, then version_map_memory is reset to 0. By
default, the auto-refresh occurs for every second in the first 30
seconds until search becomes idle.

Closes #50362
---
 .../java/org/elasticsearch/indices/stats/IndexStatsIT.java    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
index c84272127623f..fd4bb6e41def2 100644
--- a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
@@ -41,6 +41,7 @@
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexModule;
 import org.elasticsearch.index.IndexService;
@@ -594,7 +595,8 @@ public void testMergeStats() {
 
     public void testSegmentsStats() {
         assertAcked(prepareCreate("test_index")
-                .setSettings(Settings.builder().put(SETTING_NUMBER_OF_REPLICAS, between(0, 1))));
+            .setSettings(Settings.builder().put(SETTING_NUMBER_OF_REPLICAS, between(0, 1))
+                .put(IndexSettings.INDEX_REFRESH_INTERVAL_SETTING.getKey(), TimeValue.MINUS_ONE)));
         ensureGreen();
 
         NumShards test1 = getNumShards("test_index");

From 1928e78309c9cf42a0cc074fc597162e034d9453 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Tue, 7 Jan 2020 09:17:54 -0600
Subject: [PATCH 422/686] [DOCS] Update SQL REST API pages for new structure
 (#50690)

#43007 restructured the SQL REST API docs so they display across several pages.

This updates up a reference that assumes a single page in the "Paginating through a large response" section. It also reformats a tip for the Kibana console.

Closes #50688
---
 docs/reference/sql/endpoints/rest.asciidoc | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/reference/sql/endpoints/rest.asciidoc b/docs/reference/sql/endpoints/rest.asciidoc
index 0bc98e34c0d75..6001005f3de2c 100644
--- a/docs/reference/sql/endpoints/rest.asciidoc
+++ b/docs/reference/sql/endpoints/rest.asciidoc
@@ -42,12 +42,15 @@ James S.A. Corey |Leviathan Wakes     |561            |2011-06-02T00:00:00.000Z
 // TESTRESPONSE[non_json]
 
 [[sql-kibana-console]]
+[TIP]
 .Using Kibana Console
+====
 If you are using {kibana-ref}/console-kibana.html[Kibana Console]
 (which is highly recommended), take advantage of the
 triple quotes `"""` when creating the query. This not only automatically escapes double
 quotes (`"`) inside the query string but also support multi-line as shown below:
 image:images/sql/rest/console-triple-quotes.png[]
+====
 
 [[sql-rest-format]]
 === Response Data Formats
@@ -270,8 +273,9 @@ cursor: "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWWWdrRlVfSS1TbDYtcW9lc1FJNmlYdw==:BAFmB
 [[sql-pagination]]
 === Paginating through a large response
 
-Using the example above, one can continue to the next page by sending back the `cursor` field. In
-case of text format the cursor is returned as `Cursor` http header.
+Using the example from the <<sql-rest-format,previous section>>, one can
+continue to the next page by sending back the cursor field. In case of text
+format, the cursor is returned as `Cursor` http header.
 
 [source,console]
 --------------------------------------------------

From 414334f519df829294b2abbcf6c0499e1fc8fa3f Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 7 Jan 2020 16:36:55 +0100
Subject: [PATCH 423/686] Faster and Simpler GCS REST Mock (#50706)

* Faster and Simpler GCS REST Mock

I reworked the GCS mock a little to use less copying+allocation,
log the full request body on failure to read a multi-part request
and generally be a little simpler and easy to follow to track down
the remaining issues that are causing almost daily failures from this
class's multi-part request parsing that can't be reproduced locally.
---
 .../gcs/GoogleCloudStorageHttpHandler.java    | 109 +++++++++---------
 1 file changed, 55 insertions(+), 54 deletions(-)

diff --git a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
index 75cb9a9abe2c7..2c36bcd0858b0 100644
--- a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
+++ b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
@@ -20,6 +20,9 @@
 
 import com.sun.net.httpserver.HttpExchange;
 import com.sun.net.httpserver.HttpHandler;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.apache.lucene.util.ArrayUtil;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.SuppressForbidden;
@@ -33,14 +36,14 @@
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.rest.RestUtils;
 
-import java.io.BufferedInputStream;
+import java.io.BufferedReader;
 import java.io.ByteArrayOutputStream;
 import java.io.IOException;
 import java.io.InputStream;
+import java.io.InputStreamReader;
 import java.net.InetSocketAddress;
 import java.net.URLDecoder;
 import java.util.ArrayList;
-import java.util.Arrays;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
@@ -54,6 +57,7 @@
 import java.util.function.BiFunction;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
+import java.util.stream.Collectors;
 import java.util.zip.GZIPInputStream;
 
 import static java.nio.charset.StandardCharsets.UTF_8;
@@ -64,6 +68,8 @@
 @SuppressForbidden(reason = "Uses a HttpServer to emulate a Google Cloud Storage endpoint")
 public class GoogleCloudStorageHttpHandler implements HttpHandler {
 
+    private static final Logger logger = LogManager.getLogger(GoogleCloudStorageHttpHandler.class);
+
     private final ConcurrentMap<String, BytesReference> blobs;
     private final String bucket;
 
@@ -262,63 +268,58 @@ private String httpServerUrl(final HttpExchange exchange) {
 
     public static Optional<Tuple<String, BytesArray>> parseMultipartRequestBody(final InputStream requestBody) throws IOException {
         Tuple<String, BytesArray> content = null;
-        try (BufferedInputStream in = new BufferedInputStream(new GZIPInputStream(requestBody))) {
-            String name = null;
-            int read;
-            ByteArrayOutputStream out = new ByteArrayOutputStream() {
-                @Override
-                public byte[] toByteArray() {
-                    return buf;
-                }
-            };
-            boolean skippedEmptyLine = false;
-            while ((read = in.read()) != -1) {
-                out.reset();
-                boolean markAndContinue = false;
-                do { // search next consecutive {carriage return, new line} chars and stop
-                    if ((char) read == '\r') {
-                        int next = in.read();
-                        if (next != -1) {
-                            if (next == '\n') {
-                                break;
-                            }
-                            out.write(read);
-                            out.write(next);
-                            continue;
-                        }
-                    }
-                    out.write(read);
-                } while ((read = in.read()) != -1);
-                final String bucketPrefix = "{\"bucket\":";
-                final String start = new String(out.toByteArray(), 0, Math.min(out.size(), bucketPrefix.length()), UTF_8);
-                if ((skippedEmptyLine == false && start.length() == 0) || start.startsWith("--")
-                    || start.toLowerCase(Locale.ROOT).startsWith("content")) {
-                    markAndContinue = true;
-                } else if (start.startsWith(bucketPrefix)) {
+        final BytesReference fullRequestBody;
+        try (InputStream in = new GZIPInputStream(requestBody)) {
+            fullRequestBody = Streams.readFully(in);
+        }
+        String name = null;
+        boolean skippedEmptyLine = false;
+        int startPos = 0;
+        int endPos = 0;
+        while (startPos < fullRequestBody.length()) {
+            do {
+                endPos = fullRequestBody.indexOf((byte) '\r', endPos + 1);
+            } while (endPos >= 0 && fullRequestBody.get(endPos + 1) != '\n');
+            boolean markAndContinue = false;
+            final String bucketPrefix = "{\"bucket\":";
+            if (startPos > 0) {
+                startPos += 2;
+            }
+            if (name == null || skippedEmptyLine == false) {
+                if ((skippedEmptyLine == false && endPos == startPos)
+                    || (fullRequestBody.get(startPos) == '-' && fullRequestBody.get(startPos + 1) == '-')) {
                     markAndContinue = true;
-                    final String line = new String(out.toByteArray(), bucketPrefix.length(), out.size() - bucketPrefix.length(), UTF_8);
-                    Matcher matcher = NAME_PATTERN.matcher(line);
-                    if (matcher.find()) {
-                        name = matcher.group(1);
-                    }
-                }
-                if (markAndContinue) {
-                    skippedEmptyLine = start.length() == 0;
-                    in.mark(Integer.MAX_VALUE);
-                    continue;
-                }
-                if (name != null) {
-                    in.reset();
-                    out.reset();
-                    while ((read = in.read()) != -1) {
-                        out.write(read);
+                } else {
+                    final String start = fullRequestBody.slice(startPos, Math.min(endPos - startPos, bucketPrefix.length())).utf8ToString();
+                    if (start.toLowerCase(Locale.ROOT).startsWith("content")) {
+                        markAndContinue = true;
+                    } else if (start.startsWith(bucketPrefix)) {
+                        markAndContinue = true;
+                        final String line = fullRequestBody.slice(
+                            startPos + bucketPrefix.length(), endPos - startPos - bucketPrefix.length()).utf8ToString();
+                        Matcher matcher = NAME_PATTERN.matcher(line);
+                        if (matcher.find()) {
+                            name = matcher.group(1);
+                        }
                     }
-                    // removes the trailing end "\r\n--__END_OF_PART__--\r\n" which is 23 bytes long
-                    content = Tuple.tuple(name, new BytesArray(Arrays.copyOf(out.toByteArray(), out.size() - 23)));
-                    break;
                 }
+                skippedEmptyLine = markAndContinue && endPos == startPos;
+                startPos = endPos;
+            } else {
+                // removes the trailing end "\r\n--__END_OF_PART__--\r\n" which is 23 bytes long
+                int len = fullRequestBody.length() - startPos - 23;
+                final InputStream stream = fullRequestBody.slice(startPos, len).streamInput();
+                final byte[] buffer = new byte[len];
+                Streams.readFully(stream, buffer);
+                content = Tuple.tuple(name, new BytesArray(buffer));
+                break;
             }
         }
+        if (content == null) {
+            final InputStream stream = fullRequestBody.streamInput();
+            logger.warn(() -> new ParameterizedMessage("Failed to find multi-part upload in [{}]", new BufferedReader(
+                new InputStreamReader(stream)).lines().collect(Collectors.joining("\n"))));
+        }
         return Optional.ofNullable(content);
     }
 

From 859428366cbb5a652430c516deededa6feedfb15 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Tue, 7 Jan 2020 10:55:17 -0500
Subject: [PATCH 424/686] Teach ObjectParser a happy pattern (#50691)

We *very* commonly have object with ctors like:
```
public Foo(String name)
```

And then declare a bunch of setters on the object. Every aggregation
works like this, for example. This change teaches `ObjectParser` how to
build these aggregations all on its own, without any help. This'll make
it much cleaner to parse aggs, and, probably, a bunch of other things.
It'll let us remove lots of wrapping. I've used this new power for the
`avg` aggregation just to prove that it works outside of a unit test.
---
 .../common/xcontent/ObjectParser.java         | 45 ++++++++++++-------
 .../common/xcontent/ObjectParserTests.java    |  8 ++++
 .../admin/indices/analyze/AnalyzeAction.java  |  2 +-
 .../admin/indices/shrink/ResizeRequest.java   |  2 +-
 .../metrics/AvgAggregationBuilder.java        |  5 +--
 .../search/rescore/QueryRescorerBuilder.java  |  2 +-
 .../CompletionSuggestionBuilder.java          |  2 +-
 .../context/CategoryQueryContext.java         |  2 +-
 .../completion/context/GeoQueryContext.java   |  2 +-
 9 files changed, 44 insertions(+), 26 deletions(-)

diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
index 09a997e7a1516..69a4a4bd31e45 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
@@ -32,8 +32,10 @@
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
 import java.util.function.Consumer;
+import java.util.function.Function;
 import java.util.function.Supplier;
 
+import static java.util.Objects.requireNonNull;
 import static org.elasticsearch.common.xcontent.XContentParser.Token.START_ARRAY;
 import static org.elasticsearch.common.xcontent.XContentParser.Token.START_OBJECT;
 import static org.elasticsearch.common.xcontent.XContentParser.Token.VALUE_BOOLEAN;
@@ -147,7 +149,7 @@ private static <Value, Category, Context> UnknownFieldParser<Value, Context> unk
 
     private final Map<String, FieldParser> fieldParserMap = new HashMap<>();
     private final String name;
-    private final Supplier<Value> valueSupplier;
+    private final Function<Context, Value> valueBuilder;
     private final UnknownFieldParser<Value, Context> unknownFieldParser;
 
     /**
@@ -155,16 +157,27 @@ private static <Value, Category, Context> UnknownFieldParser<Value, Context> unk
      * @param name the parsers name, used to reference the parser in exceptions and messages.
      */
     public ObjectParser(String name) {
-        this(name, null);
+        this(name, errorOnUnknown(), null);
     }
 
     /**
      * Creates a new ObjectParser.
      * @param name the parsers name, used to reference the parser in exceptions and messages.
-     * @param valueSupplier a supplier that creates a new Value instance used when the parser is used as an inner object parser.
+     * @param valueSupplier A supplier that creates a new Value instance. Used when the parser is used as an inner object parser.
      */
     public ObjectParser(String name, @Nullable Supplier<Value> valueSupplier) {
-        this(name, errorOnUnknown(), valueSupplier);
+        this(name, errorOnUnknown(), c -> valueSupplier.get());
+    }
+
+    /**
+     * Creates a new ObjectParser.
+     * @param name the parsers name, used to reference the parser in exceptions and messages.
+     * @param valueBuilder A function that creates a new Value from the parse Context. Used
+     *                     when the parser is used as an inner object parser.
+     */
+    public static <Value, Context> ObjectParser<Value, Context> fromBuilder(String name, Function<Context, Value> valueBuilder) {
+        requireNonNull(valueBuilder, "Use the single argument ctor instead");
+        return new ObjectParser<Value, Context>(name, errorOnUnknown(), valueBuilder);
     }
 
     /**
@@ -175,7 +188,7 @@ public ObjectParser(String name, @Nullable Supplier<Value> valueSupplier) {
      * @param valueSupplier a supplier that creates a new Value instance used when the parser is used as an inner object parser.
      */
     public ObjectParser(String name, boolean ignoreUnknownFields, @Nullable Supplier<Value> valueSupplier) {
-        this(name, ignoreUnknownFields ? ignoreUnknown() : errorOnUnknown(), valueSupplier);
+        this(name, ignoreUnknownFields ? ignoreUnknown() : errorOnUnknown(), c -> valueSupplier.get());
     }
 
     /**
@@ -185,7 +198,7 @@ public ObjectParser(String name, boolean ignoreUnknownFields, @Nullable Supplier
      * @param valueSupplier a supplier that creates a new Value instance used when the parser is used as an inner object parser.
      */
     public ObjectParser(String name, UnknownFieldConsumer<Value> unknownFieldConsumer, @Nullable Supplier<Value> valueSupplier) {
-        this(name, consumeUnknownField(unknownFieldConsumer), valueSupplier);
+        this(name, consumeUnknownField(unknownFieldConsumer), c -> valueSupplier.get());
     }
 
     /**
@@ -202,19 +215,20 @@ public <C> ObjectParser(
         BiConsumer<Value, C> unknownFieldConsumer,
         @Nullable Supplier<Value> valueSupplier
     ) {
-        this(name, unknownIsNamedXContent(categoryClass, unknownFieldConsumer), valueSupplier);
+        this(name, unknownIsNamedXContent(categoryClass, unknownFieldConsumer), c -> valueSupplier.get());
     }
 
     /**
      * Creates a new ObjectParser instance with a name.
      * @param name the parsers name, used to reference the parser in exceptions and messages.
      * @param unknownFieldParser how to parse unknown fields
-     * @param valueSupplier a supplier that creates a new Value instance used when the parser is used as an inner object parser.
+     * @param valueBuilder builds the value from the context. Used when the ObjectParser is not passed a value.
      */
-    private ObjectParser(String name, UnknownFieldParser<Value, Context> unknownFieldParser, @Nullable Supplier<Value> valueSupplier) {
+    private ObjectParser(String name, UnknownFieldParser<Value, Context> unknownFieldParser,
+                @Nullable Function<Context, Value> valueBuilder) {
         this.name = name;
-        this.valueSupplier = valueSupplier;
         this.unknownFieldParser = unknownFieldParser;
+        this.valueBuilder = valueBuilder;
     }
 
     /**
@@ -226,10 +240,10 @@ private ObjectParser(String name, UnknownFieldParser<Value, Context> unknownFiel
      */
     @Override
     public Value parse(XContentParser parser, Context context) throws IOException {
-        if (valueSupplier == null) {
-            throw new NullPointerException("valueSupplier is not set");
+        if (valueBuilder == null) {
+            throw new NullPointerException("valueBuilder is not set");
         }
-        return parse(parser, valueSupplier.get(), context);
+        return parse(parser, valueBuilder.apply(context), context);
     }
 
     /**
@@ -277,11 +291,8 @@ public Value parse(XContentParser parser, Value value, Context context) throws I
 
     @Override
     public Value apply(XContentParser parser, Context context) {
-        if (valueSupplier == null) {
-            throw new NullPointerException("valueSupplier is not set");
-        }
         try {
-            return parse(parser, valueSupplier.get(), context);
+            return parse(parser, context);
         } catch (IOException e) {
             throw new XContentParseException(parser.getTokenLocation(), "[" + name  + "] failed to parse object", e);
         }
diff --git a/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java b/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
index fb5db61935a27..96d0f11af7c40 100644
--- a/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
+++ b/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
@@ -39,6 +39,7 @@
 import java.util.concurrent.atomic.AtomicReference;
 
 import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasSize;
 
 public class ObjectParserTests extends ESTestCase {
@@ -805,4 +806,11 @@ public void testTopLevelNamedXContent() throws IOException {
             assertEquals("[1:2] [test] unable to parse Object with name [not_supported_field]: parser not found", ex.getMessage());
         }
     }
+
+    public void testContextBuilder() throws IOException {
+        ObjectParser<AtomicReference<String>, String> parser = ObjectParser.fromBuilder("test", AtomicReference::new);
+        String context = randomAlphaOfLength(5);
+        AtomicReference<String> parsed = parser.parse(createParser(JsonXContent.jsonXContent, "{}"), context);
+        assertThat(parsed.get(), equalTo(context));
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/analyze/AnalyzeAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/analyze/AnalyzeAction.java
index 51ac4bee89266..41de8ce531bde 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/analyze/AnalyzeAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/analyze/AnalyzeAction.java
@@ -264,7 +264,7 @@ public static Request fromXContent(XContentParser parser, String index) throws I
             return request;
         }
 
-        private static final ObjectParser<Request, Void> PARSER = new ObjectParser<>("analyze_request", null);
+        private static final ObjectParser<Request, Void> PARSER = new ObjectParser<>("analyze_request");
         static {
             PARSER.declareStringArray(Request::text, new ParseField("text"));
             PARSER.declareString(Request::analyzer, new ParseField("analyzer"));
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/shrink/ResizeRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/shrink/ResizeRequest.java
index 465e1d2e11d70..ac824eb2fc6cd 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/shrink/ResizeRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/shrink/ResizeRequest.java
@@ -45,7 +45,7 @@
  */
 public class ResizeRequest extends AcknowledgedRequest<ResizeRequest> implements IndicesRequest, ToXContentObject {
 
-    public static final ObjectParser<ResizeRequest, Void> PARSER = new ObjectParser<>("resize_request", null);
+    public static final ObjectParser<ResizeRequest, Void> PARSER = new ObjectParser<>("resize_request");
     static {
         PARSER.declareField((parser, request, context) -> request.getTargetIndexRequest().settings(parser.map()),
             new ParseField("settings"), ObjectParser.ValueType.OBJECT);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AvgAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AvgAggregationBuilder.java
index 7bf6034473a76..32e9aaf5e2bc9 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AvgAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/AvgAggregationBuilder.java
@@ -42,14 +42,13 @@
 public class AvgAggregationBuilder extends ValuesSourceAggregationBuilder.LeafOnly<ValuesSource.Numeric, AvgAggregationBuilder> {
     public static final String NAME = "avg";
 
-    private static final ObjectParser<AvgAggregationBuilder, Void> PARSER;
+    private static final ObjectParser<AvgAggregationBuilder, String> PARSER = ObjectParser.fromBuilder(NAME, AvgAggregationBuilder::new);
     static {
-        PARSER = new ObjectParser<>(AvgAggregationBuilder.NAME);
         ValuesSourceParserHelper.declareNumericFields(PARSER, true, true, false);
     }
 
     public static AggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
-        return PARSER.parse(parser, new AvgAggregationBuilder(aggregationName), null);
+        return PARSER.parse(parser, aggregationName);
     }
 
     public AvgAggregationBuilder(String name) {
diff --git a/server/src/main/java/org/elasticsearch/search/rescore/QueryRescorerBuilder.java b/server/src/main/java/org/elasticsearch/search/rescore/QueryRescorerBuilder.java
index 02e748dfbc95d..684b44a5ed719 100644
--- a/server/src/main/java/org/elasticsearch/search/rescore/QueryRescorerBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/rescore/QueryRescorerBuilder.java
@@ -45,7 +45,7 @@ public class QueryRescorerBuilder extends RescorerBuilder<QueryRescorerBuilder>
     private static final ParseField RESCORE_QUERY_WEIGHT_FIELD = new ParseField("rescore_query_weight");
     private static final ParseField SCORE_MODE_FIELD = new ParseField("score_mode");
 
-    private static final ObjectParser<InnerBuilder, Void> QUERY_RESCORE_PARSER = new ObjectParser<>(NAME, null);
+    private static final ObjectParser<InnerBuilder, Void> QUERY_RESCORE_PARSER = new ObjectParser<>(NAME);
     static {
         QUERY_RESCORE_PARSER.declareObject(InnerBuilder::setQueryBuilder, (p, c) -> {
             try {
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/completion/CompletionSuggestionBuilder.java b/server/src/main/java/org/elasticsearch/search/suggest/completion/CompletionSuggestionBuilder.java
index 6a7e271256d4e..2ad88c5b3f101 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/completion/CompletionSuggestionBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/completion/CompletionSuggestionBuilder.java
@@ -74,7 +74,7 @@ public class CompletionSuggestionBuilder extends SuggestionBuilder<CompletionSug
      *     "payload" : STRING_ARRAY
      * }
      */
-    private static final ObjectParser<CompletionSuggestionBuilder.InnerBuilder, Void> PARSER = new ObjectParser<>(SUGGESTION_NAME, null);
+    private static final ObjectParser<CompletionSuggestionBuilder.InnerBuilder, Void> PARSER = new ObjectParser<>(SUGGESTION_NAME);
     static {
         PARSER.declareField((parser, completionSuggestionContext, context) -> {
                 if (parser.currentToken() == XContentParser.Token.VALUE_BOOLEAN) {
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/completion/context/CategoryQueryContext.java b/server/src/main/java/org/elasticsearch/search/suggest/completion/context/CategoryQueryContext.java
index 9326e0ff666f7..e830377c4cea5 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/completion/context/CategoryQueryContext.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/completion/context/CategoryQueryContext.java
@@ -95,7 +95,7 @@ public int hashCode() {
         return result;
     }
 
-    private static final ObjectParser<Builder, Void> CATEGORY_PARSER = new ObjectParser<>(NAME, null);
+    private static final ObjectParser<Builder, Void> CATEGORY_PARSER = new ObjectParser<>(NAME);
     static {
         CATEGORY_PARSER.declareField(Builder::setCategory, XContentParser::text, new ParseField(CONTEXT_VALUE),
                 ObjectParser.ValueType.VALUE);
diff --git a/server/src/main/java/org/elasticsearch/search/suggest/completion/context/GeoQueryContext.java b/server/src/main/java/org/elasticsearch/search/suggest/completion/context/GeoQueryContext.java
index 439fa161d3897..b2882e0e8326e 100644
--- a/server/src/main/java/org/elasticsearch/search/suggest/completion/context/GeoQueryContext.java
+++ b/server/src/main/java/org/elasticsearch/search/suggest/completion/context/GeoQueryContext.java
@@ -112,7 +112,7 @@ public static Builder builder() {
         return new Builder();
     }
 
-    private static final ObjectParser<GeoQueryContext.Builder, Void> GEO_CONTEXT_PARSER = new ObjectParser<>(NAME, null);
+    private static final ObjectParser<GeoQueryContext.Builder, Void> GEO_CONTEXT_PARSER = new ObjectParser<>(NAME);
     static {
         GEO_CONTEXT_PARSER.declareField((parser, geoQueryContext,
                 geoContextMapping) -> geoQueryContext.setGeoPoint(GeoUtils.parseGeoPoint(parser)),

From eb7bf445f14d3fd3a666baad1e10c61ef73b9604 Mon Sep 17 00:00:00 2001
From: arkel-s <54832605+arkel-s@users.noreply.github.com>
Date: Tue, 7 Jan 2020 17:07:29 +0100
Subject: [PATCH 425/686] [DOCS] Add example format for `date_optional_time`
 (#50458)

Adds an example format for `date_optional_time` to the `format` mapping
parameter docs.

Closes #50457
---
 docs/reference/mapping/params/format.asciidoc | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/reference/mapping/params/format.asciidoc b/docs/reference/mapping/params/format.asciidoc
index 3a7cf54098873..e89e037ea970d 100644
--- a/docs/reference/mapping/params/format.asciidoc
+++ b/docs/reference/mapping/params/format.asciidoc
@@ -66,8 +66,9 @@ The following tables lists all the defaults ISO formats supported:
 
 [[strict-date-time]]`date_optional_time` or `strict_date_optional_time`::
 
-    A generic ISO datetime parser where the date is mandatory and the time is
-    optional.
+    A generic ISO datetime parser where the date, in `year_month_day format`, is
+    mandatory and the time, separated by `T`, is optional.
+    Examples: `yyyy-MM-dd'T'HH:mm:ss.SSSZ` or  `yyyy-MM-dd`.
 
 `basic_date`::
 
@@ -281,4 +282,3 @@ The following tables lists all the defaults ISO formats supported:
 
     A formatter for a four digit year, two digit month of year, and two digit
     day of month: `yyyy-MM-dd`.
-

From 92abe0414081e092e83c5168ade24fb834c555d8 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Tue, 7 Jan 2020 10:32:54 -0600
Subject: [PATCH 426/686] [DOCS] Reformat truncate token filter docs (#50687)

* Updates the description and adds a Lucene link
* Adds analyze, custom analyzer, and custom filter snippets
* Adds parameter documentation
---
 .../truncate-tokenfilter.asciidoc             | 145 +++++++++++++++++-
 1 file changed, 141 insertions(+), 4 deletions(-)

diff --git a/docs/reference/analysis/tokenfilters/truncate-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/truncate-tokenfilter.asciidoc
index c1d171dbbbbc0..1ca6f86cc502f 100644
--- a/docs/reference/analysis/tokenfilters/truncate-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/truncate-tokenfilter.asciidoc
@@ -4,8 +4,145 @@
 <titleabbrev>Truncate</titleabbrev>
 ++++
 
-The `truncate` token filter can be used to truncate tokens into a
-specific length.
+Truncates tokens that exceed a specified character limit. This limit defaults to
+`10` but can be customized using the `length` parameter.
 
-It accepts a `length` parameter which control the number of characters
-to truncate to, defaults to `10`.
+For example, you can use the `truncate` filter to shorten all tokens to
+`3` characters or fewer, changing `jumping fox` to `jum fox`.
+
+This filter uses Lucene's
+https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/miscellaneous/TruncateTokenFilter.html[TruncateTokenFilter].
+
+[[analysis-truncate-tokenfilter-analyze-ex]]
+==== Example
+
+The following <<indices-analyze,analyze API>> request uses the `truncate` filter
+to shorten tokens that exceed 10 characters in
+`the quinquennial extravaganza carried on`:
+
+[source,console]
+--------------------------------------------------
+GET _analyze
+{
+  "tokenizer" : "whitespace",
+  "filter" : ["truncate"],
+  "text" : "the quinquennial extravaganza carried on"
+}
+--------------------------------------------------
+
+The filter produces the following tokens:
+
+[source,text]
+--------------------------------------------------
+[ the, quinquenni, extravagan, carried, on ]
+--------------------------------------------------
+
+/////////////////////
+[source,console-result]
+--------------------------------------------------
+{
+  "tokens" : [
+    {
+      "token" : "the",
+      "start_offset" : 0,
+      "end_offset" : 3,
+      "type" : "word",
+      "position" : 0
+    },
+    {
+      "token" : "quinquenni",
+      "start_offset" : 4,
+      "end_offset" : 16,
+      "type" : "word",
+      "position" : 1
+    },
+    {
+      "token" : "extravagan",
+      "start_offset" : 17,
+      "end_offset" : 29,
+      "type" : "word",
+      "position" : 2
+    },
+    {
+      "token" : "carried",
+      "start_offset" : 30,
+      "end_offset" : 37,
+      "type" : "word",
+      "position" : 3
+    },
+    {
+      "token" : "on",
+      "start_offset" : 38,
+      "end_offset" : 40,
+      "type" : "word",
+      "position" : 4
+    }
+  ]
+}
+--------------------------------------------------
+/////////////////////
+
+[[analysis-truncate-tokenfilter-analyzer-ex]]
+==== Add to an analyzer
+
+The following <<indices-create-index,create index API>> request uses the
+`truncate` filter to configure a new 
+<<analysis-custom-analyzer,custom analyzer>>.
+
+[source,console]
+--------------------------------------------------
+PUT custom_truncate_example
+{
+  "settings" : {
+    "analysis" : {
+      "analyzer" : {
+        "standard_truncate" : {
+        "tokenizer" : "standard",
+        "filter" : ["truncate"]
+        }
+      }
+    }
+  }
+}
+--------------------------------------------------
+
+[[analysis-truncate-tokenfilter-configure-parms]]
+==== Configurable parameters
+
+`length`::
+(Optional, integer)
+Character limit for each token. Tokens exceeding this limit are truncated.
+Defaults to `10`.
+
+[[analysis-truncate-tokenfilter-customize]]
+==== Customize
+
+To customize the `truncate` filter, duplicate it to create the basis
+for a new custom token filter. You can modify the filter using its configurable
+parameters.
+
+For example, the following request creates a custom `truncate` filter,
+`5_char_trunc`, that shortens tokens to a `length` of `5` or fewer characters:
+
+[source,console]
+--------------------------------------------------
+PUT 5_char_words_example
+{
+  "settings": {
+    "analysis": {
+      "analyzer": {
+        "lowercase_5_char": {
+          "tokenizer": "lowercase",
+          "filter": [ "5_char_trunc" ]
+        }
+      },
+      "filter": {
+        "5_char_trunc": {
+          "type": "truncate",
+          "length": 5
+        }
+      }
+    }
+  }
+}
+--------------------------------------------------
\ No newline at end of file

From 24e2325486b868213e847e957859a2b052026b9c Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Tue, 7 Jan 2020 10:54:16 -0600
Subject: [PATCH 427/686] [DOCS] Reformat reverse token filter docs (#50672)

* Updates the description and adds a Lucene link
* Adds analyze and custom analyzer snippets
---
 .../tokenfilters/reverse-tokenfilter.asciidoc | 88 ++++++++++++++++++-
 1 file changed, 87 insertions(+), 1 deletion(-)

diff --git a/docs/reference/analysis/tokenfilters/reverse-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/reverse-tokenfilter.asciidoc
index 08eaa796951c8..e0c9f93c97b3d 100644
--- a/docs/reference/analysis/tokenfilters/reverse-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/reverse-tokenfilter.asciidoc
@@ -4,4 +4,90 @@
 <titleabbrev>Reverse</titleabbrev>
 ++++
 
-A token filter of type `reverse` that simply reverses each token.
+Reverses each token in a stream. For example, you can use the `reverse` filter
+to change `cat` to `tac`.
+
+Reversed tokens are useful for suffix-based searches,
+such as finding words that end in `-ion` or searching file names by their
+extension.
+
+This filter uses Lucene's
+https://lucene.apache.org/core/{lucene_version_path}/analyzers-common/org/apache/lucene/analysis/reverse/ReverseStringFilter.html[ReverseStringFilter].
+
+[[analysis-reverse-tokenfilter-analyze-ex]]
+==== Example
+
+The following <<indices-analyze,analyze API>> request uses the `reverse`
+filter to reverse each token in `quick fox jumps`:
+
+[source,console]
+--------------------------------------------------
+GET _analyze
+{
+  "tokenizer" : "standard",
+  "filter" : ["reverse"],
+  "text" : "quick fox jumps"
+}
+--------------------------------------------------
+
+The filter produces the following tokens:
+
+[source,text]
+--------------------------------------------------
+[ kciuq, xof, spmuj ]
+--------------------------------------------------
+
+/////////////////////
+[source,console-result]
+--------------------------------------------------
+{
+  "tokens" : [
+    {
+      "token" : "kciuq",
+      "start_offset" : 0,
+      "end_offset" : 5,
+      "type" : "<ALPHANUM>",
+      "position" : 0
+    },
+    {
+      "token" : "xof",
+      "start_offset" : 6,
+      "end_offset" : 9,
+      "type" : "<ALPHANUM>",
+      "position" : 1
+    },
+    {
+      "token" : "spmuj",
+      "start_offset" : 10,
+      "end_offset" : 15,
+      "type" : "<ALPHANUM>",
+      "position" : 2
+    }
+  ]
+}
+--------------------------------------------------
+/////////////////////
+
+[[analysis-reverse-tokenfilter-analyzer-ex]]
+==== Add to an analyzer
+
+The following <<indices-create-index,create index API>> request uses the
+`reverse` filter to configure a new
+<<analysis-custom-analyzer,custom analyzer>>.
+
+[source,console]
+--------------------------------------------------
+PUT reverse_example
+{
+  "settings" : {
+    "analysis" : {
+      "analyzer" : {
+        "whitespace_reverse" : {
+          "tokenizer" : "whitespace",
+          "filter" : ["reverse"]
+        }
+      }
+    }
+  }
+}
+--------------------------------------------------
\ No newline at end of file

From 663e6dca9659190069f143a058803f17f80512a5 Mon Sep 17 00:00:00 2001
From: Mayya Sharipova <mayya.sharipova@elastic.co>
Date: Tue, 7 Jan 2020 12:20:09 -0500
Subject: [PATCH 428/686] Fix NPE bug inner_hits (#50709)

When there several subqueries on different relations of the join field,
and only one of subqueries is using inner_hits, NPE occurs.
This PR prevents NPE error.

Closes #50539
---
 .../ParentChildInnerHitContextBuilder.java    |  4 ++
 .../rest-api-spec/test/30_inner_hits.yml      | 68 +++++++++++++++++++
 2 files changed, 72 insertions(+)
 create mode 100644 modules/parent-join/src/test/resources/rest-api-spec/test/30_inner_hits.yml

diff --git a/modules/parent-join/src/main/java/org/elasticsearch/join/query/ParentChildInnerHitContextBuilder.java b/modules/parent-join/src/main/java/org/elasticsearch/join/query/ParentChildInnerHitContextBuilder.java
index 090798eb51c4e..551e57abb62a1 100644
--- a/modules/parent-join/src/main/java/org/elasticsearch/join/query/ParentChildInnerHitContextBuilder.java
+++ b/modules/parent-join/src/main/java/org/elasticsearch/join/query/ParentChildInnerHitContextBuilder.java
@@ -127,6 +127,10 @@ public TopDocsAndMaxScore[] topDocs(SearchHit[] hits) throws IOException {
                         .build();
                 } else {
                     String parentId = getSortedDocValue(parentIdFieldMapper.name(), context, hit.docId());
+                    if (parentId == null) {
+                        result[i] = new TopDocsAndMaxScore(Lucene.EMPTY_TOP_DOCS, Float.NaN);
+                        continue;
+                    }
                     q = context.mapperService().fullName(IdFieldMapper.NAME).termQuery(parentId, qsc);
                 }
 
diff --git a/modules/parent-join/src/test/resources/rest-api-spec/test/30_inner_hits.yml b/modules/parent-join/src/test/resources/rest-api-spec/test/30_inner_hits.yml
new file mode 100644
index 0000000000000..44b1897485f16
--- /dev/null
+++ b/modules/parent-join/src/test/resources/rest-api-spec/test/30_inner_hits.yml
@@ -0,0 +1,68 @@
+---
+"Test two sub-queries with only one having inner_hits":
+    - skip:
+        version: " - 7.99.99"
+        reason: "The bug was corrected from 8.0"
+
+    - do:
+        indices.create:
+          index: test
+          body:
+            mappings:
+              properties:
+                entity_type: { "type": "keyword" }
+                join_field: { "type": "join", "relations": { "question": "answer", "person" : "address" } }
+            settings:
+              number_of_shards: 1
+
+    - do:
+        index:
+          index: test
+          id: 1
+          body: { "join_field": { "name": "question" }, "entity_type": "question" }
+
+    - do:
+        index:
+          index: test
+          id: 2
+          routing: 1
+          body: { "join_field": { "name": "answer", "parent": 1} , "entity_type": "answer" }
+
+    - do:
+        index:
+          index: test
+          id: 3
+          body: { "join_field": { "name": "person" }, "entity_type": "person" }
+
+    - do:
+        index:
+          index: test
+          routing: 3
+          id: 4
+          body: { "join_field": { "name": "address", "parent": 3 }, "entity_type": "address" }
+
+    - do:
+        indices.refresh: {}
+
+    - do:
+        search:
+          index: test
+          body:
+            query:
+              bool:
+                should:
+                  - term:
+                      entity_type: person
+                  - has_parent:
+                      parent_type: question
+                      query:
+                        match_all: {}
+                      inner_hits: {}
+
+
+    - match: { hits.total.value: 2 }
+    - match: { hits.hits.0._id: "3" }
+    - match: { hits.hits.0.inner_hits.question.hits.total.value: 0}
+    - match: { hits.hits.1._id: "2" }
+    - match: { hits.hits.1.inner_hits.question.hits.total.value: 1}
+    - match: { hits.hits.1.inner_hits.question.hits.hits.0._id: "1"}

From ff77eaebab9d0b593f4fb32691352b016848a4de Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Tue, 7 Jan 2020 10:28:47 -0800
Subject: [PATCH 429/686] Add cliSetup command to test clusters configuration
 (#50414)

This commit adds a cliSetup command that can be used to run arbitrary
bin scripts to setup a test cluster. This is the same as what was
previously called setupCommands in cluster formation tasks.

closes #50382
---
 .../testclusters/ElasticsearchCluster.java    |  5 ++
 .../testclusters/ElasticsearchNode.java       | 49 +++++++++++++++++--
 .../TestClusterConfiguration.java             |  2 +
 3 files changed, 51 insertions(+), 5 deletions(-)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchCluster.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchCluster.java
index a3cf70a70ef92..32789f69e9f2f 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchCluster.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchCluster.java
@@ -179,6 +179,11 @@ public void keystore(String key, FileSupplier valueSupplier) {
         nodes.all(each -> each.keystore(key, valueSupplier));
     }
 
+    @Override
+    public void cliSetup(String binTool, CharSequence... args) {
+        nodes.all(each -> each.cliSetup(binTool, args));
+    }
+
     @Override
     public void setting(String key, String value) {
         nodes.all(each -> each.setting(key, value));
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
index 3f54e4e16a149..36656a2516634 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
@@ -124,6 +124,7 @@ public class ElasticsearchNode implements TestClusterConfiguration {
     private final LazyPropertyMap<String, CharSequence> settings = new LazyPropertyMap<>("Settings", this);
     private final LazyPropertyMap<String, CharSequence> keystoreSettings = new LazyPropertyMap<>("Keystore", this);
     private final LazyPropertyMap<String, File> keystoreFiles = new LazyPropertyMap<>("Keystore files", this, FileEntry::new);
+    private final LazyPropertyList<CliEntry> cliSetup = new LazyPropertyList<>("CLI setup commands", this);
     private final LazyPropertyMap<String, CharSequence> systemProperties = new LazyPropertyMap<>("System properties", this);
     private final LazyPropertyMap<String, CharSequence> environment = new LazyPropertyMap<>("Environment", this);
     private final LazyPropertyList<CharSequence> jvmArgs = new LazyPropertyList<>("JVM arguments", this);
@@ -301,6 +302,11 @@ public void keystore(String key, FileSupplier valueSupplier) {
         keystoreFiles.put(key, valueSupplier);
     }
 
+    @Override
+    public void cliSetup(String binTool, CharSequence... args) {
+        cliSetup.add(new CliEntry(binTool, args));
+    }
+
     @Override
     public void setting(String key, String value) {
         settings.put(key, value);
@@ -475,6 +481,14 @@ public synchronized void start() {
             ));
         }
 
+        if (cliSetup.isEmpty() == false) {
+            logToProcessStdout("Running " + cliSetup.size() + " setup commands");
+
+            for (CliEntry entry : cliSetup) {
+                runElasticsearchBinScript(entry.executable, entry.args);
+            }
+        }
+
         logToProcessStdout("Starting Elasticsearch process");
         startElasticsearchProcess();
     }
@@ -623,7 +637,7 @@ public void user(Map<String, String> userSpec) {
         credentials.add(cred);
     }
 
-    private void runElasticsearchBinScriptWithInput(String input, String tool, String... args) {
+    private void runElasticsearchBinScriptWithInput(String input, String tool, CharSequence... args) {
         if (
             Files.exists(getDistroDir().resolve("bin").resolve(tool)) == false &&
                 Files.exists(getDistroDir().resolve("bin").resolve(tool + ".bat")) == false
@@ -642,12 +656,12 @@ private void runElasticsearchBinScriptWithInput(String input, String tool, Strin
                         .supply()
                 );
                 spec.args(
-                    OS.<List<String>>conditional()
+                    OS.<List<CharSequence>>conditional()
                         .onWindows(() -> {
-                            ArrayList<String> result = new ArrayList<>();
+                            ArrayList<CharSequence> result = new ArrayList<>();
                             result.add("/c");
                             result.add("bin\\" + tool + ".bat");
-                            for (String arg : args) {
+                            for (CharSequence arg : args) {
                                 result.add(arg);
                             }
                             return result;
@@ -663,7 +677,7 @@ private void runElasticsearchBinScriptWithInput(String input, String tool, Strin
         }
     }
 
-    private void runElasticsearchBinScript(String tool, String... args) {
+    private void runElasticsearchBinScript(String tool, CharSequence... args) {
         runElasticsearchBinScriptWithInput("", tool, args);
     }
 
@@ -1205,6 +1219,11 @@ public List<?> getKeystoreFiles() {
         return keystoreFiles.getNormalizedCollection();
     }
 
+    @Nested
+    public List<?> getCliSetup() {
+        return cliSetup.getNormalizedCollection();
+    }
+
     @Nested
     public List<?> getSettings() {
         return settings.getNormalizedCollection();
@@ -1376,4 +1395,24 @@ public File getFile() {
             return file;
         }
     }
+
+    private static class CliEntry {
+        private String executable;
+        private CharSequence[] args;
+
+        CliEntry(String executable, CharSequence[] args) {
+            this.executable = executable;
+            this.args = args;
+        }
+
+        @Input
+        public String getExecutable() {
+            return executable;
+        }
+
+        @Input
+        public CharSequence[] getArgs() {
+            return args;
+        }
+    }
 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClusterConfiguration.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClusterConfiguration.java
index 651ab0fae6170..11e5a35604837 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClusterConfiguration.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClusterConfiguration.java
@@ -58,6 +58,8 @@ public interface TestClusterConfiguration {
 
     void keystore(String key, FileSupplier valueSupplier);
 
+    void cliSetup(String binTool, CharSequence... args);
+
     void setting(String key, String value);
 
     void setting(String key, String value, PropertyNormalization normalization);

From 8d14a6dd9cbd36be9b033f499b5ba24c62f8a3d3 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Tue, 7 Jan 2020 12:53:47 -0600
Subject: [PATCH 430/686] [DOCS] Fuzzy wildcard not supported in `query_string`
 (#50466)

The `query_string` does not support mixing wildcards with fuzziness.
This adds a related warning to the `query_string` docs.
---
 .../reference/query-dsl/query-string-syntax.asciidoc | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/reference/query-dsl/query-string-syntax.asciidoc b/docs/reference/query-dsl/query-string-syntax.asciidoc
index 0f766f92dff64..b59d9ef9adfca 100644
--- a/docs/reference/query-dsl/query-string-syntax.asciidoc
+++ b/docs/reference/query-dsl/query-string-syntax.asciidoc
@@ -44,6 +44,7 @@ You can specify fields to search in the query syntax:
 
     _exists_:title
 
+[[query-string-wildcard]]
 ====== Wildcards
 
 Wildcard searches can be run on individual terms, using `?` to replace
@@ -112,6 +113,7 @@ Elasticsearch to visit every term in the index:
 Use with caution!
 =======
 
+[[query-string-fuzziness]]
 ====== Fuzziness
 
 We can search for terms that are
@@ -132,6 +134,16 @@ sufficient to catch 80% of all human misspellings. It can be specified as:
 
     quikc~1
 
+[[avoid-widlcards-fuzzy-searches]]
+[WARNING]
+.Avoid mixing fuzziness with wildcards
+====
+Mixing <<fuzziness,fuzzy>> and <<query-string-wildcard,wildcard>> operators is
+_not_ supported. When mixed, one of the operators is not applied. For example,
+you can search for `app~1` (fuzzy) or `app*` (wildcard), but searches for
+`app*~1` do not apply the fuzzy operator (`~1`).
+====
+
 ====== Proximity searches
 
 While a phrase query (eg `"john smith"`) expects all of the terms in exactly

From 1d76849291b9ec5b2b57105b5903de4448441d9e Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Tue, 7 Jan 2020 14:49:09 -0500
Subject: [PATCH 431/686] Support offset in composite aggs (#50609)

Adds support for the `offset` parameter to the `date_histogram` source
of composite aggs. The `offset` parameter is supported by the normal
`date_histogram` aggregation and is useful for folks that need to
measure things from, say, 6am one day to 6am the next day.

This is implemented by creating a new `Rounding` that knows how to
handle offsets and delegates to other rounding implementations. That
implementation doesn't fully implement the `Rounding` contract, namely
`nextRoundingValue`. That method isn't used by composite aggs so I can't
be sure that any implementation that I add will be correct. I propose to
leave it throwing `UnsupportedOperationException` until I need it.

Closes #48757
---
 .../bucket/composite-aggregation.asciidoc     |  66 ++++++++
 .../bucket/datehistogram-aggregation.asciidoc |   9 +-
 .../test/search.aggregation/230_composite.yml |  42 +++++-
 .../org/elasticsearch/common/Rounding.java    | 141 +++++++++++++-----
 .../DateHistogramValuesSourceBuilder.java     |  35 ++++-
 .../DateHistogramAggregationBuilder.java      |  10 +-
 .../bucket/histogram/DateIntervalWrapper.java |   3 +-
 .../elasticsearch/common/RoundingTests.java   |  12 ++
 .../common/RoundingWireTests.java             |  51 +++++++
 .../composite/CompositeAggregatorTests.java   |  35 ++++-
 x-pack/qa/rolling-upgrade/build.gradle        |   7 +
 .../mixed_cluster/80_transform_jobs_crud.yml  |   8 +
 12 files changed, 372 insertions(+), 47 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/common/RoundingWireTests.java

diff --git a/docs/reference/aggregations/bucket/composite-aggregation.asciidoc b/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
index ec253a5556059..4b50536d2ca51 100644
--- a/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
+++ b/docs/reference/aggregations/bucket/composite-aggregation.asciidoc
@@ -287,6 +287,72 @@ Time zones may either be specified as an ISO 8601 UTC offset (e.g. `+01:00` or
 `-08:00`)  or as a timezone id, an identifier used in the TZ database like
 `America/Los_Angeles`.
 
+*Offset*
+
+include::datehistogram-aggregation.asciidoc[tag=offset-explanation]
+
+[source,console,id=composite-aggregation-datehistogram-offset-example]
+----
+PUT my_index/_doc/1?refresh
+{
+  "date": "2015-10-01T05:30:00Z"
+}
+
+PUT my_index/_doc/2?refresh
+{
+  "date": "2015-10-01T06:30:00Z"
+}
+
+GET my_index/_search?size=0
+{
+  "aggs": {
+    "my_buckets": {
+      "composite" : {
+        "sources" : [
+          {
+            "date": {
+              "date_histogram" : {
+                "field": "date",
+                "calendar_interval": "day",
+                "offset": "+6h",
+                "format": "iso8601"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
+----
+
+include::datehistogram-aggregation.asciidoc[tag=offset-result-intro]
+
+[source,console-result]
+----
+{
+  ...
+  "aggregations": {
+    "my_buckets": {
+      "after_key": { "date": "2015-10-01T06:00:00.000Z" },
+      "buckets": [
+        {
+          "key": { "date": "2015-09-30T06:00:00.000Z" },
+          "doc_count": 1
+        },
+        {
+          "key": { "date": "2015-10-01T06:00:00.000Z" },
+          "doc_count": 1
+        }
+      ]
+    }
+  }
+}
+----
+// TESTRESPONSE[s/\.\.\./"took": $body.took,"timed_out": false,"_shards": $body._shards,"hits": $body.hits,/]
+
+include::datehistogram-aggregation.asciidoc[tag=offset-note]
+
 ===== Mixing different values source
 
 The `sources` parameter accepts an array of values source.
diff --git a/docs/reference/aggregations/bucket/datehistogram-aggregation.asciidoc b/docs/reference/aggregations/bucket/datehistogram-aggregation.asciidoc
index b4b4a77b32b2d..c925a63beed7d 100644
--- a/docs/reference/aggregations/bucket/datehistogram-aggregation.asciidoc
+++ b/docs/reference/aggregations/bucket/datehistogram-aggregation.asciidoc
@@ -461,16 +461,19 @@ the bucket covering that day will only hold data for 23 hours instead of the usu
 where you'll have only a 11h bucket on the morning of 27 March when the DST shift
 happens.
 
+[[search-aggregations-bucket-datehistogram-offset]]
 ===== Offset
 
+// tag::offset-explanation[]
 Use the `offset` parameter to change the start value of each bucket by the
 specified positive (`+`) or negative offset (`-`) duration, such as `1h` for
 an hour, or `1d` for a day. See <<time-units>> for more possible time
 duration options.
 
 For example, when using an interval of `day`, each bucket runs from midnight
-to midnight.  Setting the `offset` parameter to `+6h` changes each bucket
+to midnight. Setting the `offset` parameter to `+6h` changes each bucket
 to run from 6am to 6am:
+// end::offset-explanation[]
 
 [source,console,id=datehistogram-aggregation-offset-example]
 -----------------------------
@@ -498,8 +501,10 @@ GET my_index/_search?size=0
 }
 -----------------------------
 
+// tag::offset-result-intro[]
 Instead of a single bucket starting at midnight, the above request groups the
 documents into buckets starting at 6am:
+// end::offset-result-intro[]
 
 [source,console-result]
 -----------------------------
@@ -525,8 +530,10 @@ documents into buckets starting at 6am:
 -----------------------------
 // TESTRESPONSE[s/\.\.\./"took": $body.took,"timed_out": false,"_shards": $body._shards,"hits": $body.hits,/]
 
+// tag::offset-note[]
 NOTE: The start `offset` of each bucket is calculated after `time_zone`
 adjustments have been made.
+// end::offset-note[]
 
 ===== Keyed Response
 
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
index b5e5b8bf41712..1e9a2ac8df4c0 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
@@ -243,7 +243,7 @@ setup:
 ---
 "Composite aggregation with format":
   - skip:
-      version: " - 7.1.99"
+      version: " - 7.99.99" # after BWC merged revert to 7.1.99
       reason:  calendar_interval introduced in 7.2.0
       features: warnings
 
@@ -309,7 +309,7 @@ setup:
 ---
 "Composite aggregation with format and calendar_interval":
   - skip:
-      version: " - 7.1.99"
+      version: " - 7.99.99"  # after BWC merged revert to 7.1.99
       reason:  calendar_interval introduced in 7.2.0
 
   - do:
@@ -367,6 +367,40 @@ setup:
   - match: { aggregations.test.buckets.0.key.date: "2017-10-21" }
   - match: { aggregations.test.buckets.0.doc_count: 1 }
 
+---
+"Composite aggregation with date_histogram offset":
+  - skip:
+      version: " - 7.99.99" # after BWC merged revert to 7.5.99
+      reason:  offset introduced in 8.0.0
+
+  - do:
+      search:
+        rest_total_hits_as_int: true
+        index: test
+        body:
+          aggregations:
+            test:
+              composite:
+                sources: [
+                  {
+                    "date": {
+                      "date_histogram": {
+                        "field": "date",
+                        "calendar_interval": "1d",
+                        "offset": "4h",
+                        "format": "iso8601" # Format makes the comparisons a little more obvious
+                      }
+                    }
+                  }
+                ]
+
+  - match: {hits.total: 6}
+  - length: { aggregations.test.buckets: 2 }
+  - match: { aggregations.test.buckets.0.key.date: "2017-10-19T04:00:00.000Z" }
+  - match: { aggregations.test.buckets.0.doc_count: 1 }
+  - match: { aggregations.test.buckets.1.key.date: "2017-10-21T04:00:00.000Z" }
+  - match: { aggregations.test.buckets.1.doc_count: 1 }
+
 ---
 "Composite aggregation with after_key in the response":
   - do:
@@ -667,7 +701,6 @@ setup:
       reason: geotile_grid is not supported until 7.5.0
   - do:
       search:
-        rest_total_hits_as_int: true
         index: test
         body:
           aggregations:
@@ -690,7 +723,8 @@ setup:
                 ]
                 after: { "geo": "12/730/1590", "kw": "foo" }
 
-  - match: {hits.total: 6}
+  - match: { hits.total.value: 6 }
+  - match: { hits.total.relation: "eq" }
   - length: { aggregations.test.buckets: 3 }
   - match: { aggregations.test.buckets.0.key.geo: "12/1236/1533" }
   - match: { aggregations.test.buckets.0.key.kw: "bar" }
diff --git a/server/src/main/java/org/elasticsearch/common/Rounding.java b/server/src/main/java/org/elasticsearch/common/Rounding.java
index fa880fafafbe8..e36a8fa45d581 100644
--- a/server/src/main/java/org/elasticsearch/common/Rounding.java
+++ b/server/src/main/java/org/elasticsearch/common/Rounding.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.common;
 
 import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -183,6 +184,7 @@ public static class Builder {
         private final long interval;
 
         private ZoneId timeZone = ZoneOffset.UTC;
+        private long offset = 0;
 
         public Builder(DateTimeUnit unit) {
             this.unit = unit;
@@ -204,14 +206,28 @@ public Builder timeZone(ZoneId timeZone) {
             return this;
         }
 
+        /**
+         * Sets the offset of this rounding from the normal beginning of the interval. Use this
+         * to start days at 6am or months on the 15th.
+         * @param offset the offset, in milliseconds
+         */
+        public Builder offset(long offset) {
+            this.offset = offset;
+            return this;
+        }
+
+
         public Rounding build() {
-            Rounding timeZoneRounding;
+            Rounding rounding;
             if (unit != null) {
-                timeZoneRounding = new TimeUnitRounding(unit, timeZone);
+                rounding = new TimeUnitRounding(unit, timeZone);
             } else {
-                timeZoneRounding = new TimeIntervalRounding(interval, timeZone);
+                rounding = new TimeIntervalRounding(interval, timeZone);
+            }
+            if (offset != 0) {
+                rounding = new OffsetRounding(rounding, offset);
             }
-            return timeZoneRounding;
+            return rounding;
         }
     }
 
@@ -224,7 +240,7 @@ static class TimeUnitRounding extends Rounding {
         private final DateTimeUnit unit;
         private final ZoneId timeZone;
         private final boolean unitRoundsToMidnight;
-        /** For fixed offset timezones, this is the offset in milliseconds, otherwise TZ_OFFSET_NON_FIXED */
+        /** For fixed offset time zones, this is the offset in milliseconds, otherwise TZ_OFFSET_NON_FIXED */
         private final long fixedOffsetMillis;
 
         TimeUnitRounding(DateTimeUnit unit, ZoneId timeZone) {
@@ -236,7 +252,13 @@ static class TimeUnitRounding extends Rounding {
         }
 
         TimeUnitRounding(StreamInput in) throws IOException {
-            this(DateTimeUnit.resolve(in.readByte()), DateUtils.of(in.readString()));
+            this(DateTimeUnit.resolve(in.readByte()), in.readZoneId());
+        }
+
+        @Override
+        public void innerWriteTo(StreamOutput out) throws IOException {
+            out.writeByte(unit.getId());
+            out.writeZoneId(timeZone);
         }
 
         @Override
@@ -398,12 +420,6 @@ public long nextRoundingValue(long utcMillis) {
             }
         }
 
-        @Override
-        public void innerWriteTo(StreamOutput out) throws IOException {
-            out.writeByte(unit.getId());
-            out.writeString(timeZone.getId());
-        }
-
         @Override
         public int hashCode() {
             return Objects.hash(unit, timeZone);
@@ -423,19 +439,11 @@ public boolean equals(Object obj) {
 
         @Override
         public String toString() {
-            return "[" + timeZone + "][" + unit + "]";
+            return "Rounding[" + unit + " in " + timeZone + "]";
         }
     }
 
     static class TimeIntervalRounding extends Rounding {
-        @Override
-        public String toString() {
-            return "TimeIntervalRounding{" +
-                "interval=" + interval +
-                ", timeZone=" + timeZone +
-                '}';
-        }
-
         static final byte ID = 2;
         /** Since, there is no offset of -1 ms, it is safe to use -1 for non-fixed timezones */
         private static final long TZ_OFFSET_NON_FIXED = -1;
@@ -455,7 +463,13 @@ public String toString() {
         }
 
         TimeIntervalRounding(StreamInput in) throws IOException {
-            this(in.readVLong(), DateUtils.of(in.readString()));
+            this(in.readVLong(), in.readZoneId());
+        }
+
+        @Override
+        public void innerWriteTo(StreamOutput out) throws IOException {
+            out.writeVLong(interval);
+            out.writeZoneId(timeZone);
         }
 
         @Override
@@ -532,12 +546,6 @@ public long nextRoundingValue(long time) {
                 .toInstant().toEpochMilli();
         }
 
-        @Override
-        public void innerWriteTo(StreamOutput out) throws IOException {
-            out.writeVLong(interval);
-            out.writeString(timeZone.getId());
-        }
-
         @Override
         public int hashCode() {
             return Objects.hash(interval, timeZone);
@@ -554,21 +562,86 @@ public boolean equals(Object obj) {
             TimeIntervalRounding other = (TimeIntervalRounding) obj;
             return Objects.equals(interval, other.interval) && Objects.equals(timeZone, other.timeZone);
         }
+
+        @Override
+        public String toString() {
+            return "Rounding[" + interval + " in " + timeZone + "]";
+        }
+    }
+
+    static class OffsetRounding extends Rounding {
+        static final byte ID = 3;
+
+        private final Rounding delegate;
+        private final long offset;
+
+        OffsetRounding(Rounding delegate, long offset) {
+            this.delegate = delegate;
+            this.offset = offset;
+        }
+
+        OffsetRounding(StreamInput in) throws IOException {
+            // Versions before 7.6.0 will never send this type of rounding.
+            delegate = Rounding.read(in);
+            offset = in.readZLong();
+        }
+
+        @Override
+        public void innerWriteTo(StreamOutput out) throws IOException {
+            if (out.getVersion().before(Version.V_7_6_0)) {
+                throw new IllegalArgumentException("Offset rounding not supported before 7.6.0");
+            }
+            delegate.writeTo(out);
+            out.writeZLong(offset);
+        }
+
+        @Override
+        public byte id() {
+            return ID;
+        }
+
+        @Override
+        public long round(long value) {
+            return delegate.round(value - offset) + offset;
+        }
+
+        @Override
+        public long nextRoundingValue(long value) {
+            // This isn't needed by the current users. We'll implement it when we migrate other users to it.
+            throw new UnsupportedOperationException("not yet supported");
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(delegate, offset);
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (obj == null || getClass() != obj.getClass()) {
+                return false;
+            }
+            OffsetRounding other = (OffsetRounding) obj;
+            return delegate.equals(other.delegate) && offset == other.offset;
+        }
+
+        @Override
+        public String toString() {
+            return delegate + " offset by " + offset;
+        }
     }
 
     public static Rounding read(StreamInput in) throws IOException {
-        Rounding rounding;
         byte id = in.readByte();
         switch (id) {
             case TimeUnitRounding.ID:
-                rounding = new TimeUnitRounding(in);
-                break;
+                return new TimeUnitRounding(in);
             case TimeIntervalRounding.ID:
-                rounding = new TimeIntervalRounding(in);
-                break;
+                return new TimeIntervalRounding(in);
+            case OffsetRounding.ID:
+                return new OffsetRounding(in);
             default:
                 throw new ElasticsearchException("unknown rounding id [" + id + "]");
         }
-        return rounding;
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/DateHistogramValuesSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/DateHistogramValuesSourceBuilder.java
index 564399d4c2647..1e1f843406461 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/DateHistogramValuesSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/DateHistogramValuesSourceBuilder.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.search.aggregations.bucket.composite;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Rounding;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -31,9 +32,11 @@
 import org.elasticsearch.index.query.QueryShardContext;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.search.DocValueFormat;
+import org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval;
 import org.elasticsearch.search.aggregations.bucket.histogram.DateIntervalConsumer;
 import org.elasticsearch.search.aggregations.bucket.histogram.DateIntervalWrapper;
+import org.elasticsearch.search.aggregations.bucket.histogram.Histogram;
 import org.elasticsearch.search.aggregations.support.ValueType;
 import org.elasticsearch.search.aggregations.support.ValuesSource;
 import org.elasticsearch.search.aggregations.support.ValuesSourceConfig;
@@ -56,6 +59,13 @@ public class DateHistogramValuesSourceBuilder
         PARSER = new ObjectParser<>(DateHistogramValuesSourceBuilder.TYPE);
         PARSER.declareString(DateHistogramValuesSourceBuilder::format, new ParseField("format"));
         DateIntervalWrapper.declareIntervalFields(PARSER);
+        PARSER.declareField(DateHistogramValuesSourceBuilder::offset, p -> {
+            if (p.currentToken() == XContentParser.Token.VALUE_NUMBER) {
+                return p.longValue();
+            } else {
+                return DateHistogramAggregationBuilder.parseStringOffset(p.text());
+            }
+        }, Histogram.OFFSET_FIELD, ObjectParser.ValueType.LONG);
         PARSER.declareField(DateHistogramValuesSourceBuilder::timeZone, p -> {
             if (p.currentToken() == XContentParser.Token.VALUE_STRING) {
                 return ZoneId.of(p.text());
@@ -71,6 +81,7 @@ static DateHistogramValuesSourceBuilder parse(String name, XContentParser parser
 
     private ZoneId timeZone = null;
     private DateIntervalWrapper dateHistogramInterval = new DateIntervalWrapper();
+    private long offset = 0;
 
     public DateHistogramValuesSourceBuilder(String name) {
         super(name, ValueType.DATE);
@@ -80,12 +91,18 @@ protected DateHistogramValuesSourceBuilder(StreamInput in) throws IOException {
         super(in);
         dateHistogramInterval = new DateIntervalWrapper(in);
         timeZone = in.readOptionalZoneId();
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
+            offset = in.readLong();
+        }
     }
 
     @Override
     protected void innerWriteTo(StreamOutput out) throws IOException {
         dateHistogramInterval.writeTo(out);
         out.writeOptionalZoneId(timeZone);
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
+            out.writeLong(offset);
+        }
     }
 
     @Override
@@ -215,9 +232,25 @@ public ZoneId timeZone() {
         return timeZone;
     }
 
+    /**
+     * Get the offset to use when rounding, which is a number of milliseconds.
+     */
+    public long offset() {
+        return offset;
+    }
+
+    /**
+     * Set the offset on this builder, which is a number of milliseconds.
+     * @return this for chaining
+     */
+    public DateHistogramValuesSourceBuilder offset(long offset) {
+        this.offset = offset;
+        return this;
+    }
+
     @Override
     protected CompositeValuesSourceConfig innerBuild(QueryShardContext queryShardContext, ValuesSourceConfig<?> config) throws IOException {
-        Rounding rounding = dateHistogramInterval.createRounding(timeZone());
+        Rounding rounding = dateHistogramInterval.createRounding(timeZone(), offset);
         ValuesSource orig = config.toValuesSource(queryShardContext);
         if (orig == null) {
             orig = ValuesSource.Numeric.EMPTY;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
index 6d8afedbb2336..0c66e17add645 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
@@ -285,7 +285,10 @@ public DateHistogramAggregationBuilder offset(String offset) {
         return offset(parseStringOffset(offset));
     }
 
-    static long parseStringOffset(String offset) {
+    /**
+     * Parse the string specification of an offset. 
+     */
+    public static long parseStringOffset(String offset) {
         if (offset.charAt(0) == '-') {
             return -TimeValue
                     .parseTimeValue(offset.substring(1), null, DateHistogramAggregationBuilder.class.getSimpleName() + ".parseOffset")
@@ -490,13 +493,14 @@ protected ValuesSourceAggregatorFactory<ValuesSource> innerBuild(QueryShardConte
                                                                         AggregatorFactory parent,
                                                                         Builder subFactoriesBuilder) throws IOException {
         final ZoneId tz = timeZone();
-        final Rounding rounding = dateHistogramInterval.createRounding(tz);
+        // TODO use offset here rather than explicitly in the aggregation
+        final Rounding rounding = dateHistogramInterval.createRounding(tz, 0);
         final ZoneId rewrittenTimeZone = rewriteTimeZone(queryShardContext);
         final Rounding shardRounding;
         if (tz == rewrittenTimeZone) {
             shardRounding = rounding;
         } else {
-            shardRounding = dateHistogramInterval.createRounding(rewrittenTimeZone);
+            shardRounding = dateHistogramInterval.createRounding(rewrittenTimeZone, 0);
         }
 
         ExtendedBounds roundedBounds = null;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateIntervalWrapper.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateIntervalWrapper.java
index 229fa0d15bb30..13354dc87adda 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateIntervalWrapper.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateIntervalWrapper.java
@@ -275,7 +275,7 @@ TimeValue tryIntervalAsFixedUnit() {
         }
     }
 
-    public Rounding createRounding(ZoneId timeZone) {
+    public Rounding createRounding(ZoneId timeZone, long offset) {
         Rounding.Builder tzRoundingBuilder;
         if (isEmpty()) {
             throw new IllegalArgumentException("Invalid interval specified, must be non-null and non-empty");
@@ -302,6 +302,7 @@ public Rounding createRounding(ZoneId timeZone) {
         if (timeZone != null) {
             tzRoundingBuilder.timeZone(timeZone);
         }
+        tzRoundingBuilder.offset(offset);
         return tzRoundingBuilder.build();
     }
 
diff --git a/server/src/test/java/org/elasticsearch/common/RoundingTests.java b/server/src/test/java/org/elasticsearch/common/RoundingTests.java
index bee3f57764f32..7de894d081f21 100644
--- a/server/src/test/java/org/elasticsearch/common/RoundingTests.java
+++ b/server/src/test/java/org/elasticsearch/common/RoundingTests.java
@@ -195,6 +195,18 @@ public void testTimeUnitRoundingDST() {
         assertThat(tzRounding_chg.round(time("2014-11-02T06:01:01", chg)), isDate(time("2014-11-02T06:00:00", chg), chg));
     }
 
+    public void testOffsetRounding() {
+        long twoHours = TimeUnit.HOURS.toMillis(2);
+        long oneDay = TimeUnit.DAYS.toMillis(1);
+        Rounding rounding = Rounding.builder(Rounding.DateTimeUnit.DAY_OF_MONTH).offset(twoHours).build();
+        assertThat(rounding.round(0), equalTo(-oneDay + twoHours));
+        assertThat(rounding.round(twoHours), equalTo(twoHours));
+
+        rounding = Rounding.builder(Rounding.DateTimeUnit.DAY_OF_MONTH).offset(-twoHours).build();
+        assertThat(rounding.round(0), equalTo(-twoHours));
+        assertThat(rounding.round(oneDay - twoHours), equalTo(oneDay - twoHours));
+    }
+
     /**
      * Randomized test on TimeUnitRounding. Test uses random
      * {@link DateTimeUnit} and {@link ZoneId} and often (50% of the time)
diff --git a/server/src/test/java/org/elasticsearch/common/RoundingWireTests.java b/server/src/test/java/org/elasticsearch/common/RoundingWireTests.java
new file mode 100644
index 0000000000000..fb448c77e6e14
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/common/RoundingWireTests.java
@@ -0,0 +1,51 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.common;
+
+import org.elasticsearch.common.Rounding.DateTimeUnit;
+import org.elasticsearch.common.io.stream.Writeable.Reader;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+
+public class RoundingWireTests extends AbstractWireSerializingTestCase<Rounding> {
+    @Override
+    protected Rounding createTestInstance() {
+        Rounding.Builder builder;
+        if (randomBoolean()) {
+            builder = Rounding.builder(randomFrom(DateTimeUnit.values()));
+        } else {
+            // The time value's millisecond component must be > 0 so we're limited in the suffixes we can use.
+            final var tv = randomTimeValue(1, 1000, "d", "h", "ms", "s", "m");
+            builder = Rounding.builder(TimeValue.parseTimeValue(tv, "test"));
+        }
+        if (randomBoolean()) {
+            builder.timeZone(randomZone());
+        }
+        if (randomBoolean()) {
+            builder.offset(randomLong());
+        }
+        return builder.build();
+    }
+
+    @Override
+    protected Reader<Rounding> instanceReader() {
+        return Rounding::read;
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregatorTests.java
index 601154234e792..7769dee3c5833 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregatorTests.java
@@ -90,6 +90,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicLong;
 import java.util.function.Consumer;
@@ -1020,7 +1021,7 @@ public void testWithDateHistogram() throws IOException {
             () -> {
                 DateHistogramValuesSourceBuilder histo = new DateHistogramValuesSourceBuilder("date")
                     .field("date")
-                    .dateHistogramInterval(DateHistogramInterval.days(1));
+                    .calendarInterval(DateHistogramInterval.days(1));
                 return new CompositeAggregationBuilder("name", Collections.singletonList(histo));
             },
             (result) -> {
@@ -1044,7 +1045,7 @@ public void testWithDateHistogram() throws IOException {
             () -> {
                 DateHistogramValuesSourceBuilder histo = new DateHistogramValuesSourceBuilder("date")
                     .field("date")
-                    .dateHistogramInterval(DateHistogramInterval.days(1));
+                    .calendarInterval(DateHistogramInterval.days(1));
                 return new CompositeAggregationBuilder("name", Collections.singletonList(histo))
                     .aggregateAfter(createAfterKey("date", 1474329600000L));
 
@@ -1058,7 +1059,35 @@ public void testWithDateHistogram() throws IOException {
             }
         );
 
-        assertWarnings("[interval] on [date_histogram] is deprecated, use [fixed_interval] or [calendar_interval] in the future.");
+        /*
+         * Tests a four hour offset, which moves the document with
+         * date 2017-10-20T03:08:45 into 2017-10-19's bucket.
+         */
+        testSearchCase(Arrays.asList(new MatchAllDocsQuery(), new DocValuesFieldExistsQuery("date"),
+            LongPoint.newRangeQuery(
+                "date",
+                asLong("2016-09-20T09:00:34"),
+                asLong("2017-10-20T06:09:24")
+            )), dataset,
+            () -> {
+                DateHistogramValuesSourceBuilder histo = new DateHistogramValuesSourceBuilder("date")
+                    .field("date")
+                    .calendarInterval(DateHistogramInterval.days(1))
+                    .offset(TimeUnit.HOURS.toMillis(4));
+                return new CompositeAggregationBuilder("name", Collections.singletonList(histo))
+                    .aggregateAfter(createAfterKey("date", 1474329600000L));
+
+            }, (result) -> {
+                assertEquals(3, result.getBuckets().size());
+                assertEquals("{date=1508472000000}", result.afterKey().toString());
+                assertEquals("{date=1474344000000}", result.getBuckets().get(0).getKeyAsString());
+                assertEquals(2L, result.getBuckets().get(0).getDocCount());
+                assertEquals("{date=1508385600000}", result.getBuckets().get(1).getKeyAsString());
+                assertEquals(2L, result.getBuckets().get(1).getDocCount());
+                assertEquals("{date=1508472000000}", result.getBuckets().get(2).getKeyAsString());
+                assertEquals(1L, result.getBuckets().get(2).getDocCount());
+            }
+        );
     }
 
     public void testWithDateTerms() throws IOException {
diff --git a/x-pack/qa/rolling-upgrade/build.gradle b/x-pack/qa/rolling-upgrade/build.gradle
index dc7856a38e26d..527f594ce4174 100644
--- a/x-pack/qa/rolling-upgrade/build.gradle
+++ b/x-pack/qa/rolling-upgrade/build.gradle
@@ -161,6 +161,13 @@ for (Version bwcVersion : bwcVersions.wireCompatible) {
     nonInputProperties.systemProperty('tests.clustername', "${-> testClusters."${baseName}".getName()}")
     systemProperty 'tests.rest.suite', 'upgraded_cluster'
     systemProperty 'tests.upgrade_from_version', bwcVersion.toString().replace('-SNAPSHOT', '')
+    // disabled temporarily for backporting serialization change
+    if (bwcVersion.before('8.0.0')) {
+      systemProperty 'tests.rest.blacklist', [
+        'upgraded_cluster/80_transform_jobs_crud/Get start, stop mixed cluster batch transform',
+        'upgraded_cluster/80_transform_jobs_crud/Test GET, mixed continuous transforms',
+      ].join(',')
+    }
   }
 
   tasks.register("${baseName}#bwcTest") {
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/80_transform_jobs_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/80_transform_jobs_crud.yml
index 57d16baf58dad..1817984be7cd5 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/80_transform_jobs_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/80_transform_jobs_crud.yml
@@ -1,5 +1,9 @@
 ---
 "Test put batch transform on mixed cluster":
+  - skip:
+      version: " - 7.99.99" # after BWC merged then remove entirely
+      reason:  disabled temporarily for backporting serialization change
+
   - do:
       cluster.health:
         index: "transform-airline-data"
@@ -106,6 +110,10 @@
 
 ---
 "Test put continuous transform on mixed cluster":
+  - skip:
+      version: " - 7.99.99" # after BWC merged then remove entirely
+      reason:  disabled temporarily for backporting serialization change
+
   - do:
       cluster.health:
         index: "transform-airline-data-cont"

From c241318789b2f640330e31bde93dffc17308c88f Mon Sep 17 00:00:00 2001
From: Evgenia Badyanova <evgenia.badiyanova@elastic.co>
Date: Tue, 7 Jan 2020 17:19:15 -0500
Subject: [PATCH 432/686] [DOCS] Update reference documentation that mentions
 CMS (#50542)

Relates to https://github.com/elastic/elasticsearch/issues/46973
---
 docs/reference/setup/bootstrap-checks.asciidoc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/reference/setup/bootstrap-checks.asciidoc b/docs/reference/setup/bootstrap-checks.asciidoc
index f65526eb3612e..231de843549fa 100644
--- a/docs/reference/setup/bootstrap-checks.asciidoc
+++ b/docs/reference/setup/bootstrap-checks.asciidoc
@@ -187,7 +187,8 @@ you must not start Elasticsearch with the serial collector (whether it's
 from the defaults for the JVM that you're using, or you've explicitly
 specified it with `-XX:+UseSerialGC`). Note that the default JVM
 configuration that ships with Elasticsearch configures Elasticsearch to
-use the CMS collector.
+use the G1GC garbage collector with JDK14 and later versions. For earlier
+JDK versions, the configuration defaults to the CMS collector.
 
 === System call filter check
 Elasticsearch installs system call filters of various flavors depending

From 60a3314fdd9bd55596025fdfd82d6d05349c1f1a Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Wed, 8 Jan 2020 13:32:45 +1100
Subject: [PATCH 433/686] Populate OpenIDConnect metadata collections (#50521)

The OpenIdConnectRealm had a bug which would cause it not to populate
User metadata for collections contained in the user JWT claims.

This commit fixes that bug.

Resolves: #50250
---
 .../xpack/security/authc/oidc/OpenIdConnectRealm.java      | 4 ++--
 .../xpack/security/authc/oidc/OpenIdConnectRealmTests.java | 7 ++++++-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealm.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealm.java
index a3bc026e330f2..4e05d82db82f7 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealm.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealm.java
@@ -48,7 +48,7 @@
 
 import java.net.URI;
 import java.net.URISyntaxException;
-import java.util.Collections;
+import java.util.Collection;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -215,7 +215,7 @@ private void buildUserFromClaims(JWTClaimsSet claims, ActionListener<Authenticat
                  * We whitelist the Types that we want to parse as metadata from the Claims, explicitly filtering out {@link Date}s
                  */
                 Object v = entry.getValue();
-                return (v instanceof String || v instanceof Boolean || v instanceof Number || v instanceof Collections);
+                return (v instanceof String || v instanceof Boolean || v instanceof Number || v instanceof Collection);
             }).collect(Collectors.toUnmodifiableMap(entry -> "oidc(" + entry.getKey() + ")", Map.Entry::getValue));
         } else {
             userMetadata = Map.of();
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealmTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealmTests.java
index 58e3a69da5be4..5e69378bea0fc 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealmTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealmTests.java
@@ -16,7 +16,6 @@
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.TestEnvironment;
 import org.elasticsearch.license.XPackLicenseState;
-
 import org.elasticsearch.xpack.core.security.action.oidc.OpenIdConnectLogoutResponse;
 import org.elasticsearch.xpack.core.security.action.oidc.OpenIdConnectPrepareAuthenticationResponse;
 import org.elasticsearch.xpack.core.security.authc.AuthenticationResult;
@@ -31,6 +30,7 @@
 import org.junit.Before;
 
 import java.util.Arrays;
+import java.util.Collection;
 import java.util.Collections;
 import java.util.Date;
 import java.util.HashSet;
@@ -43,6 +43,7 @@
 import static org.elasticsearch.xpack.core.security.authc.RealmSettings.getFullSettingKey;
 import static org.elasticsearch.xpack.security.authc.oidc.OpenIdConnectRealm.CONTEXT_TOKEN_DATA;
 import static org.hamcrest.Matchers.arrayContainingInAnyOrder;
+import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.instanceOf;
@@ -91,6 +92,10 @@ public void testAuthentication() throws Exception {
         } else {
             assertThat(result.getUser().metadata().get("oidc(iss)"), equalTo("https://op.company.org"));
             assertThat(result.getUser().metadata().get("oidc(name)"), equalTo("Clinton Barton"));
+            final Object groups = result.getUser().metadata().get("oidc(groups)");
+            assertThat(groups, notNullValue());
+            assertThat(groups, instanceOf(Collection.class));
+            assertThat((Collection<?>) groups, contains("group1", "group2", "groups3"));
         }
     }
 

From 2f186f70afddfaade20f67a550e8bfe5a02b0ee1 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Wed, 8 Jan 2020 09:18:31 +0000
Subject: [PATCH 434/686] Remove type parameter from
 `CreateIndexRequest.mapping(type, XContentBuilder)` (#50586)

This continues the removal of type parameters from CreateIndexRequest.mapping
methods started in #50419. Here the removed methods are almost entirely in test
code, with the exception of a change to TransformIndex in the transform plugin.

Relates to #41059
---
 .../common/HighlighterWithAnalyzersTests.java |   8 +-
 .../expression/MoreExpressionTests.java       |   8 +-
 .../SearchAsYouTypeFieldMapperTests.java      |   2 +-
 .../TokenCountFieldMapperIntegrationIT.java   |   4 +-
 .../AbstractParentChildTestCase.java          |  10 +-
 .../join/aggregations/ChildrenIT.java         |   8 +-
 .../join/query/ChildQuerySearchIT.java        |  64 ++++-----
 .../elasticsearch/join/query/InnerHitsIT.java |  20 +--
 .../percolator/PercolatorQuerySearchIT.java   |   6 +-
 .../PercolatorQuerySearchTests.java           |   4 +-
 .../ICUCollationKeywordFieldMapperIT.java     |  30 ++--
 .../index/mapper/size/SizeMappingIT.java      |   6 +-
 .../indices/create/CreateIndexRequest.java    |  29 ++--
 .../create/CreateIndexRequestBuilder.java     |  10 +-
 .../indices/rollover/RolloverRequest.java     |   2 +-
 .../admin/indices/create/CreateIndexIT.java   |   8 +-
 .../create/CreateIndexRequestTests.java       |   6 +-
 .../rollover/RolloverRequestTests.java        |  20 ---
 .../indices/stats/IndicesStatsTests.java      |   4 +-
 .../AbstractTermVectorsTestCase.java          |   4 +-
 .../action/termvectors/GetTermVectorsIT.java  |  32 ++---
 .../termvectors/GetTermVectorsTests.java      |   4 +-
 .../cluster/SimpleClusterStateIT.java         |   4 +-
 .../gateway/GatewayIndexStateIT.java          |   2 +-
 .../org/elasticsearch/get/GetActionIT.java    |   4 +-
 .../org/elasticsearch/index/IndexSortIT.java  |   8 +-
 .../index/analysis/PreBuiltAnalyzerTests.java |   4 +-
 .../index/fielddata/FieldDataLoadingIT.java   |   2 +-
 .../index/mapper/BinaryFieldMapperTests.java  |   8 +-
 .../mapper/CompletionFieldMapperTests.java    |   4 +-
 .../mapper/CopyToMapperIntegrationIT.java     |   2 +-
 .../index/mapper/DocumentMapperTests.java     |   8 +-
 .../index/mapper/DynamicMappingTests.java     |   4 +-
 .../ExternalValuesMapperIntegrationIT.java    |  10 +-
 .../mapper/FieldFilterMapperPluginTests.java  |   6 +-
 .../mapper/MultiFieldsIntegrationIT.java      |  12 +-
 .../index/mapper/NestedObjectMapperTests.java |   4 +-
 .../index/mapper/UpdateMappingTests.java      |  14 +-
 .../index/search/NestedHelperTests.java       |   4 +-
 .../search/nested/NestedSortingTests.java     |   2 +-
 .../index/similarity/SimilarityTests.java     |  28 ++--
 .../termvectors/TermVectorsServiceTests.java  |   8 +-
 .../PreBuiltAnalyzerIntegrationIT.java        |   4 +-
 .../mapping/SimpleGetFieldMappingsIT.java     |  16 +--
 .../indices/mapping/SimpleGetMappingsIT.java  |  10 +-
 .../org/elasticsearch/mget/SimpleMgetIT.java  |   4 +-
 .../routing/SimpleRoutingIT.java              |  10 +-
 .../search/aggregations/CombiIT.java          |   4 +-
 .../search/aggregations/EquivalenceIT.java    |  16 +--
 .../search/aggregations/bucket/NestedIT.java  |   8 +-
 .../aggregations/bucket/ReverseNestedIT.java  |  10 +-
 .../aggregations/metrics/CardinalityIT.java   |   4 +-
 .../aggregations/metrics/TopHitsIT.java       |   4 +-
 .../aggregations/pipeline/MaxBucketIT.java    |   2 +-
 .../search/fetch/FetchSubPhasePluginIT.java   |   5 +-
 .../search/fetch/subphase/InnerHitsIT.java    |  12 +-
 .../highlight/HighlighterSearchIT.java        | 130 +++++++++---------
 .../search/fieldcaps/FieldCapabilitiesIT.java |   4 +-
 .../search/fields/SearchFieldsIT.java         |  20 +--
 .../functionscore/DecayFunctionScoreIT.java   |  69 ++++------
 .../FunctionScoreFieldValueIT.java            |   5 +-
 .../functionscore/FunctionScorePluginIT.java  |   5 +-
 .../search/functionscore/QueryRescorerIT.java |  27 ++--
 .../search/geo/GeoBoundingBoxQueryIT.java     |  12 +-
 .../search/geo/GeoDistanceIT.java             |   4 +-
 .../elasticsearch/search/geo/GeoFilterIT.java |   4 +-
 .../search/geo/GeoShapeQueryTests.java        |  18 +--
 .../search/morelikethis/MoreLikeThisIT.java   |  34 ++---
 .../search/nested/SimpleNestedIT.java         |  16 +--
 .../elasticsearch/search/query/ExistsIT.java  |  12 +-
 .../search/query/MultiMatchQueryIT.java       |   4 +-
 .../search/query/QueryStringIT.java           |   4 +-
 .../search/query/SearchQueryIT.java           |  14 +-
 .../search/query/SimpleQueryStringIT.java     |   8 +-
 .../scriptfilter/ScriptQuerySearchIT.java     |   4 +-
 .../search/scroll/DuelScrollIT.java           |   2 +-
 .../search/sort/FieldSortIT.java              |  28 ++--
 .../search/sort/GeoDistanceIT.java            |  20 +--
 .../search/sort/SimpleSortIT.java             |   8 +-
 .../suggest/CompletionSuggestSearchIT.java    |  25 ++--
 .../ContextCompletionSuggestSearchIT.java     |   9 +-
 .../search/suggest/SuggestSearchIT.java       |  52 +++----
 .../CategoryContextMappingTests.java          |   4 +-
 .../completion/GeoContextMappingTests.java    |  24 ++--
 .../similarity/SimilarityIT.java              |   4 +-
 .../index/RandomCreateIndexGenerator.java     |   4 +-
 .../test/ESSingleNodeTestCase.java            |   8 +-
 .../core/ml/annotations/AnnotationIndex.java  |   2 +-
 .../xpack/enrich/EnrichPolicyRunner.java      |   2 +-
 .../EnrichPolicyMaintenanceServiceTests.java  |  28 ++--
 .../xpack/enrich/EnrichPolicyRunnerTests.java |  12 +-
 .../index/engine/FrozenIndexTests.java        |   2 +-
 .../mapper/FlatObjectSearchTests.java         |   2 +-
 .../xpack/ml/MlConfigMigrator.java            |   3 +-
 .../ml/dataframe/DataFrameAnalyticsIndex.java |  13 +-
 .../xpack/ml/dataframe/MappingsMerger.java    |   9 +-
 .../job/persistence/JobResultsProvider.java   |   3 +-
 .../ml/dataframe/MappingsMergerTests.java     |  18 +--
 .../ml/job/persistence/MockClientBuilder.java |   2 +-
 .../PinnedQueryBuilderIT.java                 |   7 +-
 .../support/SecurityIndexManager.java         |   7 +-
 .../DocumentLevelSecurityTests.java           |   2 +-
 .../integration/FieldLevelSecurityTests.java  |   2 +-
 .../xpack/spatial/search/ShapeQueryTests.java |   4 +-
 .../transform/persistence/TransformIndex.java |   4 +-
 .../TransformConfigManagerTests.java          |   5 +-
 ...HistoryTemplateTransformMappingsTests.java |   2 +-
 .../AbstractWatcherIntegrationTestCase.java   |   3 +-
 108 files changed, 581 insertions(+), 669 deletions(-)

diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/HighlighterWithAnalyzersTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/HighlighterWithAnalyzersTests.java
index 8e0f2d32f3813..df297407f79ec 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/HighlighterWithAnalyzersTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/HighlighterWithAnalyzersTests.java
@@ -57,9 +57,9 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
 
     public void testNgramHighlightingWithBrokenPositions() throws IOException {
         assertAcked(prepareCreate("test")
-                .addMapping("test", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                            .startObject("test")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("name")
                                         .field("type", "text")
@@ -213,7 +213,7 @@ public void testPhrasePrefix() throws IOException {
             .put("index.analysis.filter.synonym.type", "synonym")
             .putList("index.analysis.filter.synonym.synonyms", "quick => fast");
 
-        assertAcked(prepareCreate("first_test_index").setSettings(builder.build()).addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("first_test_index").setSettings(builder.build()).setMapping(type1TermVectorMapping()));
 
         ensureGreen();
 
@@ -317,7 +317,7 @@ public void testPhrasePrefix() throws IOException {
     }
 
     public static XContentBuilder type1TermVectorMapping() throws IOException {
-        return XContentFactory.jsonBuilder().startObject().startObject("type1")
+        return XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field1").field("type", "text").field("term_vector", "with_positions_offsets").endObject()
             .startObject("field2").field("type", "text").field("term_vector", "with_positions_offsets").endObject()
diff --git a/modules/lang-expression/src/test/java/org/elasticsearch/script/expression/MoreExpressionTests.java b/modules/lang-expression/src/test/java/org/elasticsearch/script/expression/MoreExpressionTests.java
index ca15aa01e4c59..4af3bb35021ca 100644
--- a/modules/lang-expression/src/test/java/org/elasticsearch/script/expression/MoreExpressionTests.java
+++ b/modules/lang-expression/src/test/java/org/elasticsearch/script/expression/MoreExpressionTests.java
@@ -588,10 +588,10 @@ public void testPipelineAggregationScript() throws Exception {
     }
 
     public void testGeo() throws Exception {
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("location").field("type", "geo_point");
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").addMapping("type1", xContentBuilder));
+        assertAcked(prepareCreate("test").setMapping(xContentBuilder));
         ensureGreen();
         client().prepareIndex("test").setId("1").setSource(jsonBuilder().startObject()
                 .field("name", "test")
@@ -621,10 +621,10 @@ public void testGeo() throws Exception {
     }
 
     public void testBoolean() throws Exception {
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("doc")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("vip").field("type", "boolean");
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").addMapping("doc", xContentBuilder));
+        assertAcked(prepareCreate("test").setMapping(xContentBuilder));
         ensureGreen();
         indexRandom(true,
                 client().prepareIndex("test").setId("1").setSource("id", 1, "price", 1.0, "vip", true),
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/SearchAsYouTypeFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/SearchAsYouTypeFieldMapperTests.java
index dcd1ee63a0e89..b3c408cbd0ee8 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/SearchAsYouTypeFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/SearchAsYouTypeFieldMapperTests.java
@@ -257,7 +257,7 @@ public void testMultiFields() throws IOException {
             List<String> fields = new ArrayList<>();
             fields.add(path);
             final MapperService mapperService =
-                createIndex(index, Settings.EMPTY, "_doc", mapping).mapperService();
+                createIndex(index, Settings.EMPTY, mapping).mapperService();
             FieldType fieldType = mapperService.fullName(path + "._index_prefix");
             assertThat(fieldType, instanceOf(PrefixFieldType.class));
             PrefixFieldType prefixFieldType = (PrefixFieldType) fieldType;
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/TokenCountFieldMapperIntegrationIT.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/TokenCountFieldMapperIntegrationIT.java
index fb5419e319c11..9c5c3b76523f8 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/TokenCountFieldMapperIntegrationIT.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/TokenCountFieldMapperIntegrationIT.java
@@ -117,8 +117,8 @@ private void init() throws IOException {
         settings.put("index.analysis.analyzer.mock_english.filter", "stop");
         prepareCreate("test")
             .setSettings(settings)
-            .addMapping("test", jsonBuilder().startObject()
-                .startObject("test")
+            .setMapping(jsonBuilder().startObject()
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("foo")
                             .field("type", "text")
diff --git a/modules/parent-join/src/test/java/org/elasticsearch/join/aggregations/AbstractParentChildTestCase.java b/modules/parent-join/src/test/java/org/elasticsearch/join/aggregations/AbstractParentChildTestCase.java
index 3dc14b2f9c47b..daad8768ef2bb 100644
--- a/modules/parent-join/src/test/java/org/elasticsearch/join/aggregations/AbstractParentChildTestCase.java
+++ b/modules/parent-join/src/test/java/org/elasticsearch/join/aggregations/AbstractParentChildTestCase.java
@@ -19,7 +19,9 @@
 
 package org.elasticsearch.join.aggregations;
 
-import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+import org.elasticsearch.action.index.IndexRequestBuilder;
+import org.elasticsearch.join.query.ParentChildTestCase;
+import org.junit.Before;
 
 import java.util.ArrayList;
 import java.util.HashMap;
@@ -28,9 +30,7 @@
 import java.util.Map;
 import java.util.Set;
 
-import org.elasticsearch.action.index.IndexRequestBuilder;
-import org.elasticsearch.join.query.ParentChildTestCase;
-import org.junit.Before;
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 
 /**
  * Small base test-class which combines stuff used for Children and Parent aggregation tests
@@ -43,7 +43,7 @@ public abstract class AbstractParentChildTestCase extends ParentChildTestCase {
     public void setupCluster() throws Exception {
         assertAcked(
             prepareCreate("test")
-                .addMapping("doc",
+                .setMapping(
                     addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "article", "comment"),
                         "commenter", "keyword", "category", "keyword"))
         );
diff --git a/modules/parent-join/src/test/java/org/elasticsearch/join/aggregations/ChildrenIT.java b/modules/parent-join/src/test/java/org/elasticsearch/join/aggregations/ChildrenIT.java
index 150c1dc76afa5..daeeb5af4ab96 100644
--- a/modules/parent-join/src/test/java/org/elasticsearch/join/aggregations/ChildrenIT.java
+++ b/modules/parent-join/src/test/java/org/elasticsearch/join/aggregations/ChildrenIT.java
@@ -160,7 +160,7 @@ public void testWithDeletes() throws Exception {
         String indexName = "xyz";
         assertAcked(
                 prepareCreate(indexName)
-                    .addMapping("doc",
+                    .setMapping(
                         addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child"),
                             "name", "keyword"))
         );
@@ -222,7 +222,7 @@ public void testPostCollection() throws Exception {
                 prepareCreate(indexName)
                     .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                         .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0))
-                    .addMapping("doc",
+                    .setMapping(
                         addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
                             masterType, childType),
                             "brand", "text", "name", "keyword", "material", "text", "color", "keyword", "size", "keyword"))
@@ -285,7 +285,7 @@ public void testHierarchicalChildrenAggs() {
         String childType = "city";
         assertAcked(
                 prepareCreate(indexName)
-                    .addMapping("doc",
+                    .setMapping(
                         addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
                             grandParentType, parentType, parentType, childType),
                             "name", "keyword"))
@@ -328,7 +328,7 @@ public void testPostCollectAllLeafReaders() throws Exception {
         // us to miss to evaluate child docs in segments we didn't have parent matches for.
         assertAcked(
                 prepareCreate("index")
-                    .addMapping("doc",
+                    .setMapping(
                         addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
                             "parentType", "childType"),
                             "name", "keyword", "town", "keyword", "age", "integer"))
diff --git a/modules/parent-join/src/test/java/org/elasticsearch/join/query/ChildQuerySearchIT.java b/modules/parent-join/src/test/java/org/elasticsearch/join/query/ChildQuerySearchIT.java
index 2bb2528aceec4..75a4e74da515d 100644
--- a/modules/parent-join/src/test/java/org/elasticsearch/join/query/ChildQuerySearchIT.java
+++ b/modules/parent-join/src/test/java/org/elasticsearch/join/query/ChildQuerySearchIT.java
@@ -89,7 +89,7 @@ public class ChildQuerySearchIT extends ParentChildTestCase {
 
     public void testMultiLevelChild() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
                 "parent", "child", "child", "grandchild")));
         ensureGreen();
 
@@ -146,7 +146,7 @@ public void testMultiLevelChild() throws Exception {
     // see #2744
     public void test2744() throws IOException {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "foo", "test")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "foo", "test")));
         ensureGreen();
 
         // index simple data
@@ -164,7 +164,7 @@ public void test2744() throws IOException {
 
     public void testSimpleChildQuery() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+                .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         // index simple data
@@ -234,7 +234,7 @@ public void testSimpleChildQuery() throws Exception {
     // Issue #3290
     public void testCachingBugWithFqueryFilter() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
         List<IndexRequestBuilder> builders = new ArrayList<>();
         // index simple data
@@ -272,7 +272,7 @@ public void testCachingBugWithFqueryFilter() throws Exception {
 
     public void testHasParentFilter() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
         Map<String, Set<String>> parentToChildren = new HashMap<>();
         // Childless parent
@@ -320,7 +320,7 @@ public void testHasParentFilter() throws Exception {
 
     public void testSimpleChildQueryWithFlush() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         // index simple data with flushes, so we have many segments
@@ -388,7 +388,7 @@ public void testSimpleChildQueryWithFlush() throws Exception {
 
     public void testScopedFacet() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc",
+            .setMapping(
                 addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child"),
                     "c_field", "keyword")));
         ensureGreen();
@@ -428,7 +428,7 @@ public void testScopedFacet() throws Exception {
 
     public void testDeletedParent() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
         // index simple data
         createIndexRequest("test", "parent", "p1", null, "p_field", "p_value1").get();
@@ -462,7 +462,7 @@ public void testDeletedParent() throws Exception {
 
     public void testDfsSearchType() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         // index simple data
@@ -489,7 +489,7 @@ public void testDfsSearchType() throws Exception {
 
     public void testHasChildAndHasParentFailWhenSomeSegmentsDontContainAnyParentOrChildDocs() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         createIndexRequest("test", "parent", "1", null, "p_field", 1).get();
@@ -511,7 +511,7 @@ public void testHasChildAndHasParentFailWhenSomeSegmentsDontContainAnyParentOrCh
 
     public void testCountApiUsage() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         String parentId = "p1";
@@ -542,7 +542,7 @@ public void testCountApiUsage() throws Exception {
 
     public void testExplainUsage() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         String parentId = "p1";
@@ -606,7 +606,7 @@ List<IndexRequestBuilder> createDocBuilders() {
 
     public void testScoreForParentChildQueriesWithFunctionScore() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", jsonBuilder().startObject().startObject("doc").startObject("properties")
+            .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("join_field")
                     .field("type", "join")
                     .startObject("relations")
@@ -699,7 +699,7 @@ public void testScoreForParentChildQueriesWithFunctionScore() throws Exception {
     // Issue #2536
     public void testParentChildQueriesCanHandleNoRelevantTypesInIndex() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         SearchResponse response = client().prepareSearch("test")
@@ -733,7 +733,7 @@ public void testParentChildQueriesCanHandleNoRelevantTypesInIndex() throws Excep
 
     public void testHasChildAndHasParentFilter_withFilter() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         createIndexRequest("test", "parent", "1", null, "p_field", 1).get();
@@ -760,7 +760,7 @@ public void testHasChildAndHasParentFilter_withFilter() throws Exception {
 
     public void testHasChildInnerHitsHighlighting() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         createIndexRequest("test", "parent", "1", null, "p_field", 1).get();
@@ -784,7 +784,7 @@ public void testHasChildInnerHitsHighlighting() throws Exception {
 
     public void testHasChildAndHasParentWrappedInAQueryFilter() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         // query filter in case for p/c shouldn't execute per segment, but rather
@@ -816,7 +816,7 @@ public void testHasChildAndHasParentWrappedInAQueryFilter() throws Exception {
 
     public void testSimpleQueryRewrite() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child"),
+            .setMapping(addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child"),
                 "c_field", "keyword", "p_field", "keyword")));
         ensureGreen();
 
@@ -864,7 +864,7 @@ public void testSimpleQueryRewrite() throws Exception {
     // Issue #3144
     public void testReIndexingParentAndChildDocuments() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         // index simple data
@@ -925,7 +925,7 @@ public void testReIndexingParentAndChildDocuments() throws Exception {
     // Issue #3203
     public void testHasChildQueryWithMinimumScore() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         // index simple data
@@ -950,7 +950,7 @@ public void testHasChildQueryWithMinimumScore() throws Exception {
     public void testParentFieldQuery() throws Exception {
         assertAcked(prepareCreate("test")
             .setSettings(Settings.builder().put("index.refresh_interval", -1))
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         SearchResponse response = client().prepareSearch("test")
@@ -983,7 +983,7 @@ public void testParentIdQuery() throws Exception {
                 .put(indexSettings())
                 .put("index.refresh_interval", -1)
             )
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         createIndexRequest("test", "child", "c1", "p1").get();
@@ -1005,7 +1005,7 @@ public void testParentIdQuery() throws Exception {
 
     public void testHasChildNotBeingCached() throws IOException {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         // index simple data
@@ -1066,7 +1066,7 @@ private QueryBuilder randomHasParent(String type, String field, String value) {
     // Issue #3818
     public void testHasChildQueryOnlyReturnsSingleChildType() throws Exception {
         assertAcked(prepareCreate("grandissue")
-            .addMapping("doc", jsonBuilder().startObject().startObject("doc").startObject("properties")
+            .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("join_field")
                     .field("type", "join")
                     .startObject("relations")
@@ -1120,7 +1120,7 @@ public void testHasChildQueryOnlyReturnsSingleChildType() throws Exception {
 
     public void testHasChildQueryWithNestedInnerObjects() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc",
+            .setMapping(
                 addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child"),
                     "objects", "nested")));
         ensureGreen();
@@ -1162,7 +1162,7 @@ public void testHasChildQueryWithNestedInnerObjects() throws Exception {
 
     public void testNamedFilters() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         String parentId = "p1";
@@ -1259,7 +1259,7 @@ public void testParentChildQueriesNoParentType() throws Exception {
     public void testParentChildCaching() throws Exception {
         assertAcked(prepareCreate("test")
             .setSettings(Settings.builder().put("index.refresh_interval", -1))
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         // index simple data
@@ -1301,7 +1301,7 @@ public void testParentChildCaching() throws Exception {
 
     public void testParentChildQueriesViaScrollApi() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
         for (int i = 0; i < 10; i++) {
             createIndexRequest("test", "parent", "p" + i, null).get();
@@ -1389,7 +1389,7 @@ private SearchResponse minMaxQuery(ScoreMode scoreMode, int minChildren, Integer
 
     public void testMinMaxChildren() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         ensureGreen();
 
         indexRandom(true, createMinMaxDocBuilders().toArray(new IndexRequestBuilder[0]));
@@ -1662,7 +1662,7 @@ public void testMinMaxChildren() throws Exception {
 
     public void testHasParentInnerQueryType() {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent-type", "child-type")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent-type", "child-type")));
         createIndexRequest("test", "child-type", "child-id", "parent-id").get();
         createIndexRequest("test", "parent-type", "parent-id", null).get();
         refresh();
@@ -1679,7 +1679,7 @@ public void testHasParentInnerQueryType() {
 
     public void testHighlightersIgnoreParentChild() throws IOException {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", jsonBuilder().startObject().startObject("properties")
+            .setMapping(jsonBuilder().startObject().startObject("properties")
                 .startObject("join_field")
                     .field("type", "join")
                     .startObject("relations")
@@ -1728,7 +1728,7 @@ public void testHighlightersIgnoreParentChild() throws IOException {
 
     public void testAliasesFilterWithHasChildQuery() throws Exception {
         assertAcked(prepareCreate("my-index")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         createIndexRequest("my-index", "parent", "1", null).get();
         createIndexRequest("my-index", "child", "2", "1").get();
         refresh();
diff --git a/modules/parent-join/src/test/java/org/elasticsearch/join/query/InnerHitsIT.java b/modules/parent-join/src/test/java/org/elasticsearch/join/query/InnerHitsIT.java
index f6163eeca8aca..53d41f09c39a3 100644
--- a/modules/parent-join/src/test/java/org/elasticsearch/join/query/InnerHitsIT.java
+++ b/modules/parent-join/src/test/java/org/elasticsearch/join/query/InnerHitsIT.java
@@ -90,7 +90,7 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
 
     public void testSimpleParentChild() throws Exception {
         assertAcked(prepareCreate("articles")
-            .addMapping("doc", jsonBuilder().startObject().startObject("doc").startObject("properties")
+            .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("join_field")
                     .field("type", "join")
                     .startObject("relations")
@@ -188,7 +188,7 @@ public void testSimpleParentChild() throws Exception {
 
     public void testRandomParentChild() throws Exception {
         assertAcked(prepareCreate("idx")
-            .addMapping("doc", jsonBuilder().startObject().startObject("doc").startObject("properties")
+            .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("id")
                     .field("type", "keyword")
                 .endObject()
@@ -273,7 +273,7 @@ public void testRandomParentChild() throws Exception {
 
     public void testInnerHitsOnHasParent() throws Exception {
         assertAcked(prepareCreate("stack")
-            .addMapping("doc", addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "question", "answer"),
+            .setMapping(addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "question", "answer"),
                 "body", "text")));
         List<IndexRequestBuilder> requests = new ArrayList<>();
         requests.add(createIndexRequest("stack", "question", "1", null, "body", "I'm using HTTPS + Basic authentication "
@@ -308,7 +308,7 @@ public void testInnerHitsOnHasParent() throws Exception {
 
     public void testParentChildMultipleLayers() throws Exception {
         assertAcked(prepareCreate("articles")
-            .addMapping("doc",
+            .setMapping(
                 addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
                     "article", "comment", "comment", "remark"), "title", "text", "message", "text")));
 
@@ -362,7 +362,7 @@ public void testParentChildMultipleLayers() throws Exception {
 
     public void testRoyals() throws Exception {
         assertAcked(prepareCreate("royals")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
                 "king", "prince", "prince", "duke", "duke", "earl", "earl", "baron")));
 
         List<IndexRequestBuilder> requests = new ArrayList<>();
@@ -431,7 +431,7 @@ public void testRoyals() throws Exception {
 
     public void testMatchesQueriesParentChildInnerHits() throws Exception {
         assertAcked(prepareCreate("index")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         List<IndexRequestBuilder> requests = new ArrayList<>();
         requests.add(createIndexRequest("index", "parent", "1", null));
         requests.add(createIndexRequest("index", "child", "3", "1", "field", "value1"));
@@ -471,7 +471,7 @@ public void testMatchesQueriesParentChildInnerHits() throws Exception {
 
     public void testUseMaxDocInsteadOfSize() throws Exception {
         assertAcked(prepareCreate("index1")
-            .addMapping("doc", buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
+            .setMapping(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent", "child")));
         client().admin().indices().prepareUpdateSettings("index1")
             .setSettings(Collections.singletonMap(IndexSettings.MAX_INNER_RESULT_WINDOW_SETTING.getKey(), ArrayUtil.MAX_ARRAY_LENGTH))
             .get();
@@ -491,7 +491,7 @@ public void testUseMaxDocInsteadOfSize() throws Exception {
 
     public void testNestedInnerHitWrappedInParentChildInnerhit() {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
+            .setMapping(addFieldMappings(buildParentJoinFieldMappingFromSimplifiedDef("join_field", true,
                 "parent_type", "child_type"), "nested_type", "nested")));
         createIndexRequest("test", "parent_type", "1", null, "key", "value").get();
         createIndexRequest("test", "child_type", "2", "1", "nested_type", Collections.singletonMap("key", "value")).get();
@@ -510,7 +510,7 @@ public void testNestedInnerHitWrappedInParentChildInnerhit() {
 
     public void testInnerHitsWithIgnoreUnmapped() {
         assertAcked(prepareCreate("index1")
-            .addMapping("doc", addFieldMappings(
+            .setMapping(addFieldMappings(
                 buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent_type", "child_type"),
                 "nested_type", "nested"))
         );
@@ -534,7 +534,7 @@ public void testInnerHitsWithIgnoreUnmapped() {
 
     public void testTooHighResultWindow() {
         assertAcked(prepareCreate("index1")
-            .addMapping("doc", addFieldMappings(
+            .setMapping(addFieldMappings(
                 buildParentJoinFieldMappingFromSimplifiedDef("join_field", true, "parent_type", "child_type"),
                 "nested_type", "nested"))
         );
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
index 041073ebcfc3d..2c8f608830f40 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
@@ -642,7 +642,7 @@ public void testManyPercolatorFields() throws Exception {
             .addMapping("type", queryFieldName, "type=percolator", "second_query_field", "type=percolator", "field", "type=keyword")
         );
         assertAcked(client().admin().indices().prepareCreate("test3")
-            .addMapping("type", jsonBuilder().startObject().startObject("type").startObject("properties")
+            .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("field")
                 .field("type", "keyword")
                 .endObject()
@@ -664,7 +664,7 @@ public void testWithMultiplePercolatorFields() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test1")
                 .addMapping("type", queryFieldName, "type=percolator", "field", "type=keyword"));
         assertAcked(client().admin().indices().prepareCreate("test2")
-                .addMapping("type", jsonBuilder().startObject().startObject("type").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field")
                         .field("type", "keyword")
                         .endObject()
@@ -728,7 +728,7 @@ public void testPercolateQueryWithNestedDocuments() throws Exception {
                 .startObject("properties").startObject("name").field("type", "text").endObject().endObject().endObject().endObject()
                 .endObject();
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("employee", mapping)
+                .setMapping(mapping)
         );
         client().prepareIndex("test").setId("q1").setSource(jsonBuilder().startObject()
                 .field("query", QueryBuilders.nestedQuery("employee",
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchTests.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchTests.java
index a35e7daa077da..60bc92b8e550f 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchTests.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchTests.java
@@ -107,7 +107,7 @@ public void testPercolateQueryWithNestedDocuments_doNotLeakBitsetCacheEntries()
         createIndex("test", client().admin().indices().prepareCreate("test")
             // to avoid normal document from being cached by BitsetFilterCache
             .setSettings(Settings.builder().put(BitsetFilterCache.INDEX_LOAD_RANDOM_ACCESS_FILTERS_EAGERLY_SETTING.getKey(), false))
-            .addMapping("employee", mapping)
+            .setMapping(mapping)
         );
         client().prepareIndex("test").setId("q1").setSource(jsonBuilder().startObject()
             .field("query", QueryBuilders.nestedQuery("employee",
@@ -175,7 +175,7 @@ public void testPercolateQueryWithNestedDocuments_doLeakFieldDataCacheEntries()
         }
         mapping.endObject();
         createIndex("test", client().admin().indices().prepareCreate("test")
-            .addMapping("employee", mapping)
+            .setMapping(mapping)
         );
         Script script = new Script(ScriptType.INLINE, MockScriptPlugin.NAME, "use_fielddata_please", Collections.emptyMap());
         client().prepareIndex("test").setId("q1").setSource(jsonBuilder().startObject()
diff --git a/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperIT.java b/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperIT.java
index b87aa8673a197..534d77878f29b 100644
--- a/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperIT.java
+++ b/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperIT.java
@@ -59,7 +59,6 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
     */
     public void testBasicUsage() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         String[] equivalent = {"I WİLL USE TURKİSH CASING", "ı will use turkish casıng"};
 
@@ -75,7 +74,7 @@ public void testBasicUsage() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         // both values should collate to same value
         indexRandom(true,
@@ -103,7 +102,6 @@ public void testBasicUsage() throws Exception {
 
     public void testMultipleValues() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         String[] equivalent = {"a", "C", "a", "B"};
 
@@ -118,7 +116,7 @@ public void testMultipleValues() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         // everything should be indexed fine, no exceptions
         indexRandom(true,
@@ -166,7 +164,6 @@ public void testMultipleValues() throws Exception {
     */
     public void testNormalization() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         String[] equivalent = {"I W\u0049\u0307LL USE TURKİSH CASING", "ı will use turkish casıng"};
 
@@ -183,7 +180,7 @@ public void testNormalization() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         indexRandom(true,
             client().prepareIndex(index).setId("1")
@@ -213,7 +210,6 @@ public void testNormalization() throws Exception {
     */
     public void testSecondaryStrength() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         String[] equivalent = {"TESTING", "testing"};
 
@@ -230,7 +226,7 @@ public void testSecondaryStrength() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         indexRandom(true,
             client().prepareIndex(index).setId("1")
@@ -260,7 +256,6 @@ public void testSecondaryStrength() throws Exception {
     */
     public void testIgnorePunctuation() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         String[] equivalent = {"foo-bar", "foo bar"};
 
@@ -277,7 +272,7 @@ public void testIgnorePunctuation() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         indexRandom(true,
             client().prepareIndex(index).setId("1").setSource("{\"id\":\"1\",\"collate\":\"" + equivalent[0] + "\"}", XContentType.JSON),
@@ -305,7 +300,6 @@ public void testIgnorePunctuation() throws Exception {
     */
     public void testIgnoreWhitespace() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         XContentBuilder builder = jsonBuilder()
             .startObject().startObject("properties")
@@ -322,7 +316,7 @@ public void testIgnoreWhitespace() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         indexRandom(true,
             client().prepareIndex(index).setId("1").setSource("{\"id\":\"1\",\"collate\":\"foo bar\"}", XContentType.JSON),
@@ -350,7 +344,6 @@ public void testIgnoreWhitespace() throws Exception {
      */
     public void testNumerics() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         XContentBuilder builder = jsonBuilder()
             .startObject().startObject("properties")
@@ -362,7 +355,7 @@ public void testNumerics() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         indexRandom(true,
             client().prepareIndex(index).setId("1").setSource("{\"collate\":\"foobar-10\"}", XContentType.JSON),
@@ -388,7 +381,6 @@ public void testNumerics() throws Exception {
     */
     public void testIgnoreAccentsButNotCase() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         XContentBuilder builder = jsonBuilder()
             .startObject().startObject("properties")
@@ -404,7 +396,7 @@ public void testIgnoreAccentsButNotCase() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         indexRandom(true,
             client().prepareIndex(index).setId("1").setSource("{\"id\":\"1\",\"collate\":\"résumé\"}", XContentType.JSON),
@@ -433,7 +425,6 @@ public void testIgnoreAccentsButNotCase() throws Exception {
     */
     public void testUpperCaseFirst() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         XContentBuilder builder = jsonBuilder()
             .startObject().startObject("properties")
@@ -446,7 +437,7 @@ public void testUpperCaseFirst() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         indexRandom(true,
             client().prepareIndex(index).setId("1").setSource("{\"collate\":\"resume\"}", XContentType.JSON),
@@ -475,7 +466,6 @@ public void testUpperCaseFirst() throws Exception {
     */
     public void testCustomRules() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         RuleBasedCollator baseCollator = (RuleBasedCollator) Collator.getInstance(new ULocale("de_DE"));
         String DIN5007_2_tailorings =
@@ -500,7 +490,7 @@ public void testCustomRules() throws Exception {
             .endObject()
             .endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         indexRandom(true,
             client().prepareIndex(index).setId("1").setSource("{\"id\":\"1\",\"collate\":\"" + equivalent[0] + "\"}", XContentType.JSON),
diff --git a/plugins/mapper-size/src/test/java/org/elasticsearch/index/mapper/size/SizeMappingIT.java b/plugins/mapper-size/src/test/java/org/elasticsearch/index/mapper/size/SizeMappingIT.java
index fc46b4a917e06..f5ce504593085 100644
--- a/plugins/mapper-size/src/test/java/org/elasticsearch/index/mapper/size/SizeMappingIT.java
+++ b/plugins/mapper-size/src/test/java/org/elasticsearch/index/mapper/size/SizeMappingIT.java
@@ -49,11 +49,10 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
     // issue 5053
     public void testThatUpdatingMappingShouldNotRemoveSizeMappingConfiguration() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         XContentBuilder builder =
             jsonBuilder().startObject().startObject("_size").field("enabled", true).endObject().endObject();
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         // check mapping again
         assertSizeMappingEnabled(index, true);
@@ -72,11 +71,10 @@ public void testThatUpdatingMappingShouldNotRemoveSizeMappingConfiguration() thr
 
     public void testThatSizeCanBeSwitchedOnAndOff() throws Exception {
         String index = "foo";
-        String type = "mytype";
 
         XContentBuilder builder =
             jsonBuilder().startObject().startObject("_size").field("enabled", true).endObject().endObject();
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping(type, builder));
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping(builder));
 
         // check mapping again
         assertSizeMappingEnabled(index, true);
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
index 8ebf54d81b7c3..f30fc715e42e8 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
@@ -231,17 +231,10 @@ public CreateIndexRequest mapping(String mapping) {
         return this;
     }
 
-    /**
-     * Adds mapping that will be added when the index gets created.
-     *
-     * @param type   The mapping type
-     * @param source The mapping source
-     * @param xContentType the content type of the mapping source
-     */
-    private CreateIndexRequest mapping(String type, BytesReference source, XContentType xContentType) {
+    private CreateIndexRequest mapping(BytesReference source, XContentType xContentType) {
         Objects.requireNonNull(xContentType);
         Map<String, Object> mappingAsMap = XContentHelper.convertToMap(source, false, xContentType).v2();
-        return mapping(type, mappingAsMap);
+        return mapping(MapperService.SINGLE_MAPPING_NAME, mappingAsMap);
     }
 
     /**
@@ -253,22 +246,24 @@ public CreateIndexRequest cause(String cause) {
     }
 
     /**
-     * Adds mapping that will be added when the index gets created.
+     * Set the mapping for this index
      *
-     * @param type   The mapping type
      * @param source The mapping source
      */
-    public CreateIndexRequest mapping(String type, XContentBuilder source) {
-        return mapping(type, BytesReference.bytes(source), source.contentType());
+    public CreateIndexRequest mapping(XContentBuilder source) {
+        return mapping(BytesReference.bytes(source), source.contentType());
     }
 
     /**
-     * Adds mapping that will be added when the index gets created.
+     * Set the mapping for this index
      *
-     * @param type   The mapping type
      * @param source The mapping source
      */
-    public CreateIndexRequest mapping(String type, Map<String, ?> source) {
+    public CreateIndexRequest mapping(Map<String, ?> source) {
+        return mapping(MapperService.SINGLE_MAPPING_NAME, source);
+    }
+
+    private CreateIndexRequest mapping(String type, Map<String, ?> source) {
         // wrap it in a type map if its not
         if (source.size() != 1 || !source.containsKey(type)) {
             source = Map.of(MapperService.SINGLE_MAPPING_NAME, source);
@@ -291,7 +286,7 @@ else if (MapperService.SINGLE_MAPPING_NAME.equals(type) == false) {
      * ("field1", "type=string,store=true").
      */
     public CreateIndexRequest mapping(String type, Object... source) {
-        mapping(type, PutMappingRequest.buildFromSimplifiedDef(type, source));
+        mapping(PutMappingRequest.buildFromSimplifiedDef(MapperService.SINGLE_MAPPING_NAME, source));
         return this;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
index f1009f731d671..bf357c2b5b990 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
@@ -114,22 +114,20 @@ public CreateIndexRequestBuilder setCause(String cause) {
     /**
      * Adds mapping that will be added when the index gets created.
      *
-     * @param type   The mapping type
      * @param source The mapping source
      */
-    public CreateIndexRequestBuilder addMapping(String type, XContentBuilder source) {
-        request.mapping(type, source);
+    public CreateIndexRequestBuilder setMapping(XContentBuilder source) {
+        request.mapping(source);
         return this;
     }
 
     /**
      * Adds mapping that will be added when the index gets created.
      *
-     * @param type   The mapping type
      * @param source The mapping source
      */
-    public CreateIndexRequestBuilder addMapping(String type, Map<String, Object> source) {
-        request.mapping(type, source);
+    public CreateIndexRequestBuilder setMapping(Map<String, Object> source) {
+        request.mapping(source);
         return this;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequest.java
index 9a9ca89b2fe56..986a4e5b712fc 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequest.java
@@ -74,7 +74,7 @@ public class RolloverRequest extends AcknowledgedRequest<RolloverRequest> implem
             if (MapperService.isMappingSourceTyped(MapperService.SINGLE_MAPPING_NAME, mappings)) {
                 throw new IllegalArgumentException("The mapping definition cannot be nested under a type");
             }
-            request.createIndexRequest.mapping(MapperService.SINGLE_MAPPING_NAME, mappings);
+            request.createIndexRequest.mapping(mappings);
         }, CreateIndexRequest.MAPPINGS, ObjectParser.ValueType.OBJECT);
         PARSER.declareField((parser, request, context) -> request.createIndexRequest.aliases(parser.map()),
             CreateIndexRequest.ALIASES, ObjectParser.ValueType.OBJECT);
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexIT.java b/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexIT.java
index 8592964c766ed..c4ab6686c1c2d 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexIT.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexIT.java
@@ -93,7 +93,7 @@ public void testCreationDateGenerated() {
 
     public void testNonNestedMappings() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("_doc", XContentFactory.jsonBuilder().startObject()
+            .setMapping(XContentFactory.jsonBuilder().startObject()
                 .startObject("properties")
                     .startObject("date")
                         .field("type", "date")
@@ -110,7 +110,7 @@ public void testNonNestedMappings() throws Exception {
 
     public void testEmptyNestedMappings() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("_doc", XContentFactory.jsonBuilder().startObject().endObject()));
+            .setMapping(XContentFactory.jsonBuilder().startObject().endObject()));
 
         GetMappingsResponse response = client().admin().indices().prepareGetMappings("test").get();
 
@@ -121,7 +121,7 @@ public void testEmptyNestedMappings() throws Exception {
 
     public void testMappingParamAndNestedMismatch() throws Exception {
         MapperParsingException e = expectThrows(MapperParsingException.class, () -> prepareCreate("test")
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject()
+                .setMapping(XContentFactory.jsonBuilder().startObject()
                         .startObject("type2").endObject()
                     .endObject()).get());
         assertThat(e.getMessage(), startsWith("Failed to parse mapping: Root mapping definition has unsupported parameters"));
@@ -129,7 +129,7 @@ public void testMappingParamAndNestedMismatch() throws Exception {
 
     public void testEmptyMappings() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("_doc", XContentFactory.jsonBuilder().startObject()
+            .setMapping(XContentFactory.jsonBuilder().startObject()
                 .startObject("_doc").endObject()
             .endObject()));
 
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestTests.java
index 845e645079fc9..9dc7c1edd7e16 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestTests.java
@@ -97,9 +97,9 @@ public void testMappingKeyedByType() throws IOException {
                     .endObject()
                 .endObject()
             .endObject().endObject();
-            request1.mapping("type1", builder);
+            request1.mapping(builder);
             builder = XContentFactory.contentBuilder(randomFrom(XContentType.values()));
-            builder.startObject().startObject("type1")
+            builder.startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field1")
                         .field("type", "text")
@@ -113,7 +113,7 @@ public void testMappingKeyedByType() throws IOException {
                     .endObject()
                 .endObject()
             .endObject().endObject();
-            request2.mapping("type1", builder);
+            request2.mapping(builder);
             assertEquals(request1.mappings(), request2.mappings());
         }
     }
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestTests.java
index 11dadbac0eab4..7aa52f877e79a 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestTests.java
@@ -35,7 +35,6 @@
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentParseException;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.RandomCreateIndexGenerator;
 import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.indices.IndicesModule;
 import org.elasticsearch.test.ESTestCase;
@@ -201,23 +200,4 @@ public void testValidation() {
         conditionsGenerator.add((request) -> request.addMaxIndexAgeCondition(new TimeValue(randomNonNegativeLong())));
     }
 
-    private static RolloverRequest createTestItem() throws IOException {
-        RolloverRequest rolloverRequest = new RolloverRequest();
-        if (randomBoolean()) {
-            String type = randomAlphaOfLengthBetween(3, 10);
-            rolloverRequest.getCreateIndexRequest().mapping(type, RandomCreateIndexGenerator.randomMapping(type));
-        }
-        if (randomBoolean()) {
-            RandomCreateIndexGenerator.randomAliases(rolloverRequest.getCreateIndexRequest());
-        }
-        if (randomBoolean()) {
-            rolloverRequest.getCreateIndexRequest().settings(RandomCreateIndexGenerator.randomIndexSettings());
-        }
-        int numConditions = randomIntBetween(0, 3);
-        List<Consumer<RolloverRequest>> conditions = randomSubsetOf(numConditions, conditionsGenerator);
-        for (Consumer<RolloverRequest> consumer : conditions) {
-            consumer.accept(rolloverRequest);
-        }
-        return rolloverRequest;
-    }
 }
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/stats/IndicesStatsTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/stats/IndicesStatsTests.java
index 5603b573dd4fd..bfb8fa0ea3705 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/stats/IndicesStatsTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/stats/IndicesStatsTests.java
@@ -59,7 +59,7 @@ public void testSegmentStats() throws Exception {
         IndexModule.Type storeType = IndexModule.defaultStoreType(true);
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("doc")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("foo")
                             .field("type", "keyword")
@@ -76,7 +76,7 @@ public void testSegmentStats() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("doc", mapping)
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(mapping)
             .setSettings(Settings.builder().put("index.store.type", storeType.getSettingsKey())));
         ensureGreen("test");
         client().prepareIndex("test").setId("1").setSource("foo", "bar", "bar", "baz", "baz", 42).get();
diff --git a/server/src/test/java/org/elasticsearch/action/termvectors/AbstractTermVectorsTestCase.java b/server/src/test/java/org/elasticsearch/action/termvectors/AbstractTermVectorsTestCase.java
index f2eeb33041477..212ae30da6faf 100644
--- a/server/src/test/java/org/elasticsearch/action/termvectors/AbstractTermVectorsTestCase.java
+++ b/server/src/test/java/org/elasticsearch/action/termvectors/AbstractTermVectorsTestCase.java
@@ -200,7 +200,7 @@ public String toString() {
 
     protected void createIndexBasedOnFieldSettings(String index, String alias, TestFieldSetting[] fieldSettings) throws IOException {
         XContentBuilder mappingBuilder = jsonBuilder();
-        mappingBuilder.startObject().startObject("type1").startObject("properties");
+        mappingBuilder.startObject().startObject("_doc").startObject("properties");
         for (TestFieldSetting field : fieldSettings) {
             field.addToMappings(mappingBuilder);
         }
@@ -209,7 +209,7 @@ protected void createIndexBasedOnFieldSettings(String index, String alias, TestF
                 .put(indexSettings())
                 .put("index.analysis.analyzer.tv_test.tokenizer", "standard")
                 .putList("index.analysis.analyzer.tv_test.filter", "lowercase");
-        assertAcked(prepareCreate(index).addMapping("type1", mappingBuilder).setSettings(settings).addAlias(new Alias(alias)));
+        assertAcked(prepareCreate(index).setMapping(mappingBuilder).setSettings(settings).addAlias(new Alias(alias)));
     }
 
     /**
diff --git a/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsIT.java b/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsIT.java
index 3af96871c5424..6fc29a5f314c9 100644
--- a/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsIT.java
+++ b/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsIT.java
@@ -68,7 +68,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
     }
 
     public void testNoSuchDoc() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                         .startObject("field")
                             .field("type", "text")
@@ -76,7 +76,7 @@ public void testNoSuchDoc() throws Exception {
                         .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).addMapping("type1", mapping));
+        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).setMapping(mapping));
 
         client().prepareIndex("test").setId("666").setSource("field", "foo bar").execute().actionGet();
         refresh();
@@ -92,7 +92,7 @@ public void testNoSuchDoc() throws Exception {
     }
 
     public void testExistingFieldWithNoTermVectorsNoNPE() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                         .startObject("existingfield")
                             .field("type", "text")
@@ -100,7 +100,7 @@ public void testExistingFieldWithNoTermVectorsNoNPE() throws Exception {
                         .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).addMapping("type1", mapping));
+        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).setMapping(mapping));
 
         // when indexing a field that simply has a question mark, the term vectors will be null
         client().prepareIndex("test").setId("0").setSource("existingfield", "?").execute().actionGet();
@@ -117,7 +117,7 @@ public void testExistingFieldWithNoTermVectorsNoNPE() throws Exception {
     }
 
     public void testExistingFieldButNotInDocNPE() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                         .startObject("existingfield")
                             .field("type", "text")
@@ -125,7 +125,7 @@ public void testExistingFieldButNotInDocNPE() throws Exception {
                         .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).addMapping("type1", mapping));
+        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).setMapping(mapping));
 
         // when indexing a field that simply has a question mark, the term vectors will be null
         client().prepareIndex("test").setId("0").setSource("anotherexistingfield", 1).execute().actionGet();
@@ -183,7 +183,7 @@ public void testNotIndexedField() throws Exception {
     }
 
     public void testSimpleTermVectors() throws IOException {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                         .startObject("field")
                             .field("type", "text")
@@ -192,7 +192,7 @@ public void testSimpleTermVectors() throws IOException {
                         .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(prepareCreate("test").addMapping("type1", mapping)
+        assertAcked(prepareCreate("test").setMapping(mapping)
                 .addAlias(new Alias("alias"))
                 .setSettings(Settings.builder()
                         .put(indexSettings())
@@ -257,7 +257,7 @@ public void testRandomSingleTermVectors() throws IOException {
         ft.setStoreTermVectorPositions(storePositions);
 
         String optionString = FieldMapper.termVectorOptionsToString(ft);
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                         .startObject("field")
                             .field("type", "text")
@@ -266,7 +266,7 @@ public void testRandomSingleTermVectors() throws IOException {
                         .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(prepareCreate("test").addMapping("type1", mapping)
+        assertAcked(prepareCreate("test").setMapping(mapping)
                 .setSettings(Settings.builder()
                         .put("index.analysis.analyzer.tv_test.tokenizer", "standard")
                         .putList("index.analysis.analyzer.tv_test.filter", "lowercase")));
@@ -385,7 +385,7 @@ public void testSimpleTermVectorsWithGenerate() throws IOException {
             fieldNames[i] = "field" + String.valueOf(i);
         }
 
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1").startObject("properties");
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc").startObject("properties");
         XContentBuilder source = jsonBuilder().startObject();
         for (String field : fieldNames) {
             mapping.startObject(field)
@@ -399,7 +399,7 @@ public void testSimpleTermVectorsWithGenerate() throws IOException {
         source.endObject();
 
         assertAcked(prepareCreate("test")
-                .addMapping("type1", mapping)
+                .setMapping(mapping)
                 .setSettings(Settings.builder()
                         .put(indexSettings())
                         .put("index.analysis.analyzer.tv_test.tokenizer", "standard")
@@ -560,7 +560,7 @@ private void compareTermVectors(String fieldName, Fields fields0, Fields fields1
     public void testSimpleWildCards() throws IOException {
         int numFields = 25;
 
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1").startObject("properties");
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc").startObject("properties");
         XContentBuilder source = jsonBuilder().startObject();
         for (int i = 0; i < numFields; i++) {
             mapping.startObject("field" + i)
@@ -572,7 +572,7 @@ public void testSimpleWildCards() throws IOException {
         source.endObject();
         mapping.endObject().endObject().endObject();
 
-        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).addMapping("type1", mapping));
+        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).setMapping(mapping));
         ensureGreen();
 
         client().prepareIndex("test").setId("0").setSource(source).get();
@@ -682,7 +682,7 @@ public void testPerFieldAnalyzer() throws IOException {
 
         // setup mapping and document source
         Set<String> withTermVectors = new HashSet<>();
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1").startObject("properties");
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc").startObject("properties");
         XContentBuilder source = jsonBuilder().startObject();
         for (int i = 0; i < numFields; i++) {
             String fieldName = "field" + i;
@@ -705,7 +705,7 @@ public void testPerFieldAnalyzer() throws IOException {
         assertAcked(prepareCreate("test")
                 .addAlias(new Alias("alias"))
                 .setSettings(settings)
-                .addMapping("type1", mapping));
+                .setMapping(mapping));
         ensureGreen();
 
         // index a single document with prepared source
diff --git a/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsTests.java b/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsTests.java
index a64523946b87f..c8946964f19a3 100644
--- a/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsTests.java
+++ b/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsTests.java
@@ -155,7 +155,7 @@ public void testRandomPayloadWithDelimitedPayloadTokenFilter() throws IOExceptio
         String delimiter = createRandomDelimiter(tokens);
         String queryString = createString(tokens, payloads, encoding, delimiter.charAt(0));
         //create the mapping
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1").startObject("properties")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("field").field("type", "text").field("term_vector", "with_positions_offsets_payloads")
                 .field("analyzer", "payload_test").endObject().endObject().endObject().endObject();
         Settings setting =  Settings.builder()
@@ -164,7 +164,7 @@ public void testRandomPayloadWithDelimitedPayloadTokenFilter() throws IOExceptio
             .put("index.analysis.filter.my_delimited_payload.delimiter", delimiter)
             .put("index.analysis.filter.my_delimited_payload.encoding", encodingString)
             .put("index.analysis.filter.my_delimited_payload.type", "mock_payload_filter").build();
-        createIndex("test", setting, "type1", mapping);
+        createIndex("test", setting, mapping);
 
         client().prepareIndex("test").setId(Integer.toString(1))
                 .setSource(jsonBuilder().startObject().field("field", queryString).endObject()).execute().actionGet();
diff --git a/server/src/test/java/org/elasticsearch/cluster/SimpleClusterStateIT.java b/server/src/test/java/org/elasticsearch/cluster/SimpleClusterStateIT.java
index 72b1679ae10e9..01bef1d292597 100644
--- a/server/src/test/java/org/elasticsearch/cluster/SimpleClusterStateIT.java
+++ b/server/src/test/java/org/elasticsearch/cluster/SimpleClusterStateIT.java
@@ -219,7 +219,7 @@ public void testLargeClusterStatePublishing() throws Exception {
         int estimatedBytesSize = scaledRandomIntBetween(
             ByteSizeValue.parseBytesSizeValue("10k", "estimatedBytesSize").bytesAsInt(),
             ByteSizeValue.parseBytesSizeValue("256k", "estimatedBytesSize").bytesAsInt());
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties");
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties");
         int counter = 0;
         int numberOfFields = 0;
         while (true) {
@@ -240,7 +240,7 @@ public void testLargeClusterStatePublishing() throws Exception {
                         .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, numberOfShards)
                         .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                         .put(MapperService.INDEX_MAPPING_TOTAL_FIELDS_LIMIT_SETTING.getKey(), Long.MAX_VALUE))
-                .addMapping("type", mapping)
+                .setMapping(mapping)
                 .setTimeout("60s").get());
         ensureGreen(); // wait for green state, so its both green, and there are no more pending events
         MappingMetaData masterMappingMetaData = client().admin().indices()
diff --git a/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java b/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
index 1f736eaa3f74e..5cc73134bbcff 100644
--- a/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
@@ -93,7 +93,7 @@ public void testMappingMetaDataParsed() throws Exception {
 
         logger.info("--> creating test index, with meta routing");
         client().admin().indices().prepareCreate("test")
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("_routing")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("_routing")
                     .field("required", true).endObject().endObject().endObject())
                 .execute().actionGet();
 
diff --git a/server/src/test/java/org/elasticsearch/get/GetActionIT.java b/server/src/test/java/org/elasticsearch/get/GetActionIT.java
index 55e706601ddc4..36a2170e9f9f5 100644
--- a/server/src/test/java/org/elasticsearch/get/GetActionIT.java
+++ b/server/src/test/java/org/elasticsearch/get/GetActionIT.java
@@ -523,7 +523,7 @@ public void testMultiGetWithVersion() throws Exception {
 
     public void testGetFieldsNonLeafField() throws Exception {
         assertAcked(prepareCreate("test").addAlias(new Alias("alias"))
-                .addMapping("my-type1", jsonBuilder().startObject().startObject("my-type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").startObject("properties")
                         .startObject("field2").field("type", "text").endObject()
                         .endObject().endObject()
@@ -552,7 +552,7 @@ public void testGetFieldsComplexField() throws Exception {
         assertAcked(prepareCreate("my-index")
             // multi types in 5.6
             .setSettings(Settings.builder().put("index.refresh_interval", -1))
-                .addMapping("my-type", jsonBuilder().startObject().startObject("my-type").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").field("type", "object").startObject("properties")
                         .startObject("field2").field("type", "object").startObject("properties")
                                 .startObject("field3").field("type", "object").startObject("properties")
diff --git a/server/src/test/java/org/elasticsearch/index/IndexSortIT.java b/server/src/test/java/org/elasticsearch/index/IndexSortIT.java
index bfbc37872f79b..e9911298efb7c 100644
--- a/server/src/test/java/org/elasticsearch/index/IndexSortIT.java
+++ b/server/src/test/java/org/elasticsearch/index/IndexSortIT.java
@@ -80,7 +80,7 @@ public void testIndexSort() {
                 .put("index.number_of_replicas", "1")
                 .putList("index.sort.field", "date", "numeric_dv", "keyword_dv")
             )
-            .addMapping("test", TEST_MAPPING)
+            .setMapping(TEST_MAPPING)
             .get();
         for (int i = 0; i < 20; i++) {
             client().prepareIndex("test").setId(Integer.toString(i))
@@ -99,7 +99,7 @@ public void testInvalidIndexSort() {
                     .put(indexSettings())
                     .putList("index.sort.field", "invalid_field")
                 )
-                .addMapping("test", TEST_MAPPING)
+                .setMapping(TEST_MAPPING)
                 .get()
         );
         assertThat(exc.getMessage(), containsString("unknown index sort field:[invalid_field]"));
@@ -110,7 +110,7 @@ public void testInvalidIndexSort() {
                     .put(indexSettings())
                     .putList("index.sort.field", "numeric")
                 )
-                .addMapping("test", TEST_MAPPING)
+                .setMapping(TEST_MAPPING)
                 .get()
         );
         assertThat(exc.getMessage(), containsString("docvalues not found for index sort field:[numeric]"));
@@ -121,7 +121,7 @@ public void testInvalidIndexSort() {
                     .put(indexSettings())
                     .putList("index.sort.field", "keyword")
                 )
-                .addMapping("test", TEST_MAPPING)
+                .setMapping(TEST_MAPPING)
                 .get()
         );
         assertThat(exc.getMessage(), containsString("docvalues not found for index sort field:[keyword]"));
diff --git a/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java b/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
index 3ca1bec5a4b57..d69d835c0af1c 100644
--- a/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
+++ b/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
@@ -90,10 +90,10 @@ public void testThatAnalyzersAreUsedInMapping() throws IOException {
         NamedAnalyzer namedAnalyzer = new PreBuiltAnalyzerProvider(analyzerName, AnalyzerScope.INDEX,
             randomPreBuiltAnalyzer.getAnalyzer(randomVersion)).get();
 
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "text")
                 .field("analyzer", analyzerName).endObject().endObject().endObject().endObject();
-        MapperService mapperService = createIndex("test", indexSettings, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("test", indexSettings, mapping).mapperService();
 
         MappedFieldType fieldType = mapperService.fullName("field");
         assertThat(fieldType.searchAnalyzer(), instanceOf(NamedAnalyzer.class));
diff --git a/server/src/test/java/org/elasticsearch/index/fielddata/FieldDataLoadingIT.java b/server/src/test/java/org/elasticsearch/index/fielddata/FieldDataLoadingIT.java
index 42b27ea28fd52..ad9b44e8c704b 100644
--- a/server/src/test/java/org/elasticsearch/index/fielddata/FieldDataLoadingIT.java
+++ b/server/src/test/java/org/elasticsearch/index/fielddata/FieldDataLoadingIT.java
@@ -30,7 +30,7 @@ public class FieldDataLoadingIT extends ESIntegTestCase {
 
     public void testEagerGlobalOrdinalsFieldDataLoading() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type", jsonBuilder().startObject().startObject("type").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("name")
                         .field("type", "text")
                         .field("fielddata", true)
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/BinaryFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/BinaryFieldMapperTests.java
index 5e5eedbed28c5..61b1a445301cc 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/BinaryFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/BinaryFieldMapperTests.java
@@ -51,7 +51,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaultMapping() throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("field")
                 .field("type", "binary")
@@ -59,7 +59,7 @@ public void testDefaultMapping() throws Exception {
                 .endObject()
                 .endObject().endObject();
 
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping).mapperService();
         MappedFieldType fieldType = mapperService.fullName("field");
 
         assertThat(fieldType, instanceOf(BinaryFieldMapper.BinaryFieldType.class));
@@ -67,7 +67,7 @@ public void testDefaultMapping() throws Exception {
     }
 
     public void testStoredValue() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("field")
                 .field("type", "binary")
@@ -76,7 +76,7 @@ public void testStoredValue() throws IOException {
                 .endObject()
                 .endObject().endObject();
 
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping).mapperService();
 
         // case 1: a simple binary value
         final byte[] binaryValue1 = new byte[100];
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/CompletionFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/CompletionFieldMapperTests.java
index 29f7eeff2ac46..dfeb6d99768af 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/CompletionFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/CompletionFieldMapperTests.java
@@ -606,7 +606,7 @@ public void testParsingMultiValueWithWeight() throws Exception {
 
     public void testParsingWithGeoFieldAlias() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder().startObject()
-            .startObject("type1")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("completion")
                         .field("type", "completion")
@@ -627,7 +627,7 @@ public void testParsingWithGeoFieldAlias() throws Exception {
             .endObject()
         .endObject();
 
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type1", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping).mapperService();
         Mapper fieldMapper = mapperService.documentMapper().mappers().getMapper("completion");
 
         ParsedDocument parsedDocument = mapperService.documentMapper().parse(new SourceToParse("test", "1",
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperIntegrationIT.java b/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperIntegrationIT.java
index e91f216a76ea0..11f573b9ab807 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperIntegrationIT.java
@@ -39,7 +39,7 @@ public class CopyToMapperIntegrationIT extends ESIntegTestCase {
     public void testDynamicTemplateCopyTo() throws Exception {
         assertAcked(
                 client().admin().indices().prepareCreate("test-idx")
-                        .addMapping("_doc", createDynamicTemplateMapping())
+                        .setMapping(createDynamicTemplateMapping())
         );
 
         int recordCount = between(1, 200);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
index 89518201ce033..724c53d04f15b 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
@@ -107,14 +107,14 @@ public void testMergeObjectAndNested() throws Exception {
     }
 
     public void testMergeSearchAnalyzer() throws Exception {
-        XContentBuilder mapping1 = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping1 = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field")
                 .field("type", "text")
                 .field("analyzer", "standard")
                 .field("search_analyzer", "whitespace")
             .endObject().endObject()
         .endObject().endObject();
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type", mapping1).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping1).mapperService();
 
         assertThat(mapperService.fullName("field").searchAnalyzer().name(), equalTo("whitespace"));
 
@@ -131,14 +131,14 @@ public void testMergeSearchAnalyzer() throws Exception {
     }
 
     public void testChangeSearchAnalyzerToDefault() throws Exception {
-          XContentBuilder mapping1 = XContentFactory.jsonBuilder().startObject().startObject("type")
+          XContentBuilder mapping1 = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field")
                 .field("type", "text")
                 .field("analyzer", "standard")
                 .field("search_analyzer", "whitespace")
             .endObject().endObject()
         .endObject().endObject();
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type", mapping1).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping1).mapperService();
 
         assertThat(mapperService.fullName("field").searchAnalyzer().name(), equalTo("whitespace"));
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
index ca194be00531d..bff53081cbd86 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
@@ -650,7 +650,7 @@ public void testDateDetectionInheritsFormat() throws Exception {
     public void testDynamicTemplateOrder() throws IOException {
         // https://github.com/elastic/elasticsearch/issues/18625
         // elasticsearch used to apply templates that do not have a match_mapping_type first
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startArray("dynamic_templates")
                     .startObject()
                         .startObject("type-based")
@@ -670,7 +670,7 @@ public void testDynamicTemplateOrder() throws IOException {
                 .endObject()
                 .endArray()
                 .endObject().endObject();
-        IndexService index = createIndex("test", Settings.EMPTY, "type", mapping);
+        IndexService index = createIndex("test", Settings.EMPTY, mapping);
         client().prepareIndex("test").setId("1").setSource("foo", "abc").get();
         assertThat(index.mapperService().fullName("foo"), instanceOf(KeywordFieldMapper.KeywordFieldType.class));
     }
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/ExternalValuesMapperIntegrationIT.java b/server/src/test/java/org/elasticsearch/index/mapper/ExternalValuesMapperIntegrationIT.java
index d3cb44386050e..3aaf2a1eee43b 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/ExternalValuesMapperIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/ExternalValuesMapperIntegrationIT.java
@@ -42,8 +42,8 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
     }
 
     public void testHighlightingOnCustomString() throws Exception {
-        prepareCreate("test-idx").addMapping("type",
-            XContentFactory.jsonBuilder().startObject().startObject("type")
+        prepareCreate("test-idx").setMapping(
+            XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("field").field("type", FakeStringFieldMapper.CONTENT_TYPE).endObject()
                 .endObject()
@@ -89,8 +89,8 @@ public void testHighlightingOnCustomString() throws Exception {
     }
 
     public void testExternalValues() throws Exception {
-        prepareCreate("test-idx").addMapping("type",
-                XContentFactory.jsonBuilder().startObject().startObject("type")
+        prepareCreate("test-idx").setMapping(
+                XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject(ExternalMetadataMapper.CONTENT_TYPE)
                 .endObject()
                 .startObject("properties")
@@ -133,7 +133,7 @@ public void testExternalValues() throws Exception {
     }
 
     public void testExternalValuesWithMultifield() throws Exception {
-        prepareCreate("test-idx").addMapping("_doc",
+        prepareCreate("test-idx").setMapping(
                 XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("f")
                     .field("type", ExternalMapperPlugin.EXTERNAL_UPPER)
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/FieldFilterMapperPluginTests.java b/server/src/test/java/org/elasticsearch/index/mapper/FieldFilterMapperPluginTests.java
index 4b2d4228ab547..8d664e0c752d1 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/FieldFilterMapperPluginTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/FieldFilterMapperPluginTests.java
@@ -86,7 +86,7 @@ public void testGetFieldMappings() {
         //as the one coming from a filtered index with same mappings
         GetMappingsResponse getMappingsResponse = client().admin().indices().prepareGetMappings("filtered").get();
         MappingMetaData filtered = getMappingsResponse.getMappings().get("filtered");
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("_doc", filtered.getSourceAsMap()));
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(filtered.getSourceAsMap()));
         GetFieldMappingsResponse response = client().admin().indices().prepareGetFieldMappings("test").setFields("*").get();
         assertEquals(1, response.mappings().size());
         assertFieldMappings(response.mappings().get("test"), FILTERED_FLAT_FIELDS);
@@ -113,7 +113,7 @@ public void testFieldCapabilities() {
         //as the one coming from a filtered index with same mappings
         GetMappingsResponse getMappingsResponse = client().admin().indices().prepareGetMappings("filtered").get();
         MappingMetaData filteredMapping = getMappingsResponse.getMappings().get("filtered");
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("_doc", filteredMapping.getSourceAsMap()));
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(filteredMapping.getSourceAsMap()));
         FieldCapabilitiesResponse test = client().fieldCaps(new FieldCapabilitiesRequest().fields("*").indices("test")).actionGet();
         // properties.value is an object field in the new mapping
         filteredFields.add("properties.value");
@@ -159,7 +159,7 @@ private void assertExpectedMappings(ImmutableOpenMap<String, MappingMetaData> ma
 
     private void assertMappingsAreValid(Map<String, Object> sourceAsMap) {
         //check that the returned filtered mappings are still valid mappings by submitting them and retrieving them back
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("_doc", sourceAsMap));
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(sourceAsMap));
         GetMappingsResponse testMappingsResponse = client().admin().indices().prepareGetMappings("test").get();
         assertEquals(1, testMappingsResponse.getMappings().size());
         //the mappings are returned unfiltered for this index, yet they are the same as the previous ones that were returned filtered
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldsIntegrationIT.java b/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldsIntegrationIT.java
index 19bcc9553b69f..6a8ceb5080040 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldsIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldsIntegrationIT.java
@@ -47,7 +47,7 @@ public class MultiFieldsIntegrationIT extends ESIntegTestCase {
     public void testMultiFields() throws Exception {
         assertAcked(
             client().admin().indices().prepareCreate("my-index")
-                .addMapping("my-type", createTypeSource())
+                .setMapping(createTypeSource())
         );
 
         GetMappingsResponse getMappingsResponse = client().admin().indices().prepareGetMappings("my-index").get();
@@ -105,7 +105,7 @@ public void testMultiFields() throws Exception {
     public void testGeoPointMultiField() throws Exception {
         assertAcked(
                 client().admin().indices().prepareCreate("my-index")
-                        .addMapping("my-type", createMappingSource("geo_point"))
+                        .setMapping(createMappingSource("geo_point"))
         );
 
         GetMappingsResponse getMappingsResponse = client().admin().indices().prepareGetMappings("my-index").get();
@@ -136,7 +136,7 @@ public void testGeoPointMultiField() throws Exception {
     public void testCompletionMultiField() throws Exception {
         assertAcked(
                 client().admin().indices().prepareCreate("my-index")
-                        .addMapping("my-type", createMappingSource("completion"))
+                        .setMapping(createMappingSource("completion"))
         );
 
         GetMappingsResponse getMappingsResponse = client().admin().indices().prepareGetMappings("my-index").get();
@@ -161,7 +161,7 @@ public void testCompletionMultiField() throws Exception {
     public void testIpMultiField() throws Exception {
         assertAcked(
                 client().admin().indices().prepareCreate("my-index")
-                        .addMapping("my-type", createMappingSource("ip"))
+                        .setMapping(createMappingSource("ip"))
         );
 
         GetMappingsResponse getMappingsResponse = client().admin().indices().prepareGetMappings("my-index").get();
@@ -183,7 +183,7 @@ public void testIpMultiField() throws Exception {
     }
 
     private XContentBuilder createMappingSource(String fieldType) throws IOException {
-        return XContentFactory.jsonBuilder().startObject().startObject("my-type")
+        return XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("a")
                 .field("type", fieldType)
@@ -198,7 +198,7 @@ private XContentBuilder createMappingSource(String fieldType) throws IOException
     }
 
     private XContentBuilder createTypeSource() throws IOException {
-        return XContentFactory.jsonBuilder().startObject().startObject("my-type")
+        return XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("title")
                 .field("type", "text")
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/NestedObjectMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/NestedObjectMapperTests.java
index 84dee44f2fa7b..fd97055d9e028 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/NestedObjectMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/NestedObjectMapperTests.java
@@ -516,7 +516,7 @@ public void testLimitOfNestedFieldsPerIndex() throws Exception {
     }
 
     public void testParentObjectMapperAreNested() throws Exception {
-        MapperService mapperService = createIndex("index1", Settings.EMPTY, "_doc", jsonBuilder().startObject()
+        MapperService mapperService = createIndex("index1", Settings.EMPTY, jsonBuilder().startObject()
                 .startObject("properties")
                     .startObject("comments")
                         .field("type", "nested")
@@ -530,7 +530,7 @@ public void testParentObjectMapperAreNested() throws Exception {
         ObjectMapper objectMapper = mapperService.getObjectMapper("comments.messages");
         assertTrue(objectMapper.parentObjectMapperAreNested(mapperService));
 
-        mapperService = createIndex("index2", Settings.EMPTY, "_doc", jsonBuilder().startObject()
+        mapperService = createIndex("index2", Settings.EMPTY, jsonBuilder().startObject()
             .startObject("properties")
                 .startObject("comments")
                     .field("type", "object")
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/UpdateMappingTests.java b/server/src/test/java/org/elasticsearch/index/mapper/UpdateMappingTests.java
index 4f13017288ff4..fa0eb08ad4c31 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/UpdateMappingTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/UpdateMappingTests.java
@@ -51,7 +51,7 @@ public void testConflictFieldsMapping(String fieldName) throws Exception {
         //test store, ... all the parameters that are not to be changed just like in other fields
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject(fieldName)
                         .field("enabled", true)
                             .field("store", false)
@@ -60,7 +60,7 @@ public void testConflictFieldsMapping(String fieldName) throws Exception {
             .endObject();
         XContentBuilder mappingUpdate = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject(fieldName)
                         .field("enabled", true)
                         .field("store", true)
@@ -76,7 +76,7 @@ public void testConflictFieldsMapping(String fieldName) throws Exception {
     }
 
     protected void testConflictWhileMergingAndMappingUnchanged(XContentBuilder mapping, XContentBuilder mappingUpdate) throws IOException {
-        IndexService indexService = createIndex("test", Settings.builder().build(), "type", mapping);
+        IndexService indexService = createIndex("test", Settings.builder().build(), mapping);
         CompressedXContent mappingBeforeUpdate = indexService.mapperService().documentMapper().mappingSource();
         // simulate like in MetaDataMappingService#putMapping
         try {
@@ -92,10 +92,10 @@ protected void testConflictWhileMergingAndMappingUnchanged(XContentBuilder mappi
     }
 
     public void testConflictSameType() throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("foo").field("type", "long").endObject()
                 .endObject().endObject().endObject();
-        MapperService mapperService = createIndex("test", Settings.builder().build(), "type", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.builder().build(), mapping).mapperService();
 
         XContentBuilder update = XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("foo").field("type", "double").endObject()
@@ -120,10 +120,10 @@ public void testConflictSameType() throws Exception {
     }
 
     public void testConflictNewType() throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("foo").field("type", "long").endObject()
                 .endObject().endObject().endObject();
-        MapperService mapperService = createIndex("test", Settings.builder().build(), "type", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.builder().build(), mapping).mapperService();
 
         XContentBuilder update = XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("foo").field("type", "double").endObject()
diff --git a/server/src/test/java/org/elasticsearch/index/search/NestedHelperTests.java b/server/src/test/java/org/elasticsearch/index/search/NestedHelperTests.java
index 73dae83728582..1ef547ffbc342 100644
--- a/server/src/test/java/org/elasticsearch/index/search/NestedHelperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/search/NestedHelperTests.java
@@ -52,7 +52,7 @@ public class NestedHelperTests extends ESSingleNodeTestCase {
     public void setUp() throws Exception {
         super.setUp();
         XContentBuilder mapping = XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("foo")
                             .field("type", "keyword")
@@ -97,7 +97,7 @@ public void setUp() throws Exception {
                         .endObject()
                     .endObject()
                 .endObject().endObject();
-        indexService = createIndex("index", Settings.EMPTY, "type", mapping);
+        indexService = createIndex("index", Settings.EMPTY, mapping);
         mapperService = indexService.mapperService();
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/search/nested/NestedSortingTests.java b/server/src/test/java/org/elasticsearch/index/search/nested/NestedSortingTests.java
index 21c2f23d13876..46e308025bc18 100644
--- a/server/src/test/java/org/elasticsearch/index/search/nested/NestedSortingTests.java
+++ b/server/src/test/java/org/elasticsearch/index/search/nested/NestedSortingTests.java
@@ -436,7 +436,7 @@ public void testMultiLevelNestedSorting() throws IOException {
             mapping.endObject();
         }
         mapping.endObject();
-        IndexService indexService = createIndex("nested_sorting", Settings.EMPTY, "_doc", mapping);
+        IndexService indexService = createIndex("nested_sorting", Settings.EMPTY, mapping);
 
         List<List<Document>> books = new ArrayList<>();
         {
diff --git a/server/src/test/java/org/elasticsearch/index/similarity/SimilarityTests.java b/server/src/test/java/org/elasticsearch/index/similarity/SimilarityTests.java
index 01d97ea8824c5..9607bf4e6bda2 100644
--- a/server/src/test/java/org/elasticsearch/index/similarity/SimilarityTests.java
+++ b/server/src/test/java/org/elasticsearch/index/similarity/SimilarityTests.java
@@ -66,7 +66,7 @@ public void testResolveDefaultSimilarities() {
     }
 
     public void testResolveSimilaritiesFromMapping_bm25() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field1").field("type", "text").field("similarity", "my_similarity").endObject()
             .endObject()
@@ -78,7 +78,7 @@ public void testResolveSimilaritiesFromMapping_bm25() throws IOException {
             .put("index.similarity.my_similarity.b", 0.5f)
             .put("index.similarity.my_similarity.discount_overlaps", false)
             .build();
-        MapperService mapperService = createIndex("foo", indexSettings, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("foo", indexSettings, mapping).mapperService();
         assertThat(mapperService.fullName("field1").similarity().get(), instanceOf(LegacyBM25Similarity.class));
 
         LegacyBM25Similarity similarity = (LegacyBM25Similarity) mapperService.fullName("field1").similarity().get();
@@ -88,18 +88,18 @@ public void testResolveSimilaritiesFromMapping_bm25() throws IOException {
     }
 
     public void testResolveSimilaritiesFromMapping_boolean() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field1").field("type", "text").field("similarity", "boolean").endObject()
             .endObject()
             .endObject().endObject();
 
-        MapperService mapperService = createIndex("foo", Settings.EMPTY, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("foo", Settings.EMPTY, mapping).mapperService();
         assertThat(mapperService.fullName("field1").similarity().get(), instanceOf(BooleanSimilarity.class));
     }
 
     public void testResolveSimilaritiesFromMapping_DFR() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field1").field("type", "text").field("similarity", "my_similarity").endObject()
             .endObject()
@@ -112,7 +112,7 @@ public void testResolveSimilaritiesFromMapping_DFR() throws IOException {
             .put("index.similarity.my_similarity.normalization", "h2")
             .put("index.similarity.my_similarity.normalization.h2.c", 3f)
             .build();
-        MapperService mapperService = createIndex("foo", indexSettings, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("foo", indexSettings, mapping).mapperService();
         assertThat(mapperService.fullName("field1").similarity().get(), instanceOf(DFRSimilarity.class));
 
         DFRSimilarity similarity = (DFRSimilarity) mapperService.fullName("field1").similarity().get();
@@ -123,7 +123,7 @@ public void testResolveSimilaritiesFromMapping_DFR() throws IOException {
     }
 
     public void testResolveSimilaritiesFromMapping_IB() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field1").field("type", "text").field("similarity", "my_similarity").endObject()
             .endObject()
@@ -136,7 +136,7 @@ public void testResolveSimilaritiesFromMapping_IB() throws IOException {
             .put("index.similarity.my_similarity.normalization", "h2")
             .put("index.similarity.my_similarity.normalization.h2.c", 3f)
             .build();
-        MapperService mapperService = createIndex("foo", indexSettings, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("foo", indexSettings, mapping).mapperService();
         assertThat(mapperService.fullName("field1").similarity().get(), instanceOf(IBSimilarity.class));
 
         IBSimilarity similarity = (IBSimilarity) mapperService.fullName("field1").similarity().get();
@@ -147,7 +147,7 @@ public void testResolveSimilaritiesFromMapping_IB() throws IOException {
     }
 
     public void testResolveSimilaritiesFromMapping_DFI() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field1").field("type", "text").field("similarity", "my_similarity").endObject()
             .endObject()
@@ -157,7 +157,7 @@ public void testResolveSimilaritiesFromMapping_DFI() throws IOException {
             .put("index.similarity.my_similarity.type", "DFI")
             .put("index.similarity.my_similarity.independence_measure", "chisquared")
             .build();
-        MapperService mapperService = createIndex("foo", indexSettings, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("foo", indexSettings, mapping).mapperService();
         MappedFieldType fieldType = mapperService.fullName("field1");
 
         assertThat(fieldType.similarity().get(), instanceOf(DFISimilarity.class));
@@ -166,7 +166,7 @@ public void testResolveSimilaritiesFromMapping_DFI() throws IOException {
     }
 
     public void testResolveSimilaritiesFromMapping_LMDirichlet() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field1").field("type", "text").field("similarity", "my_similarity").endObject()
             .endObject()
@@ -177,7 +177,7 @@ public void testResolveSimilaritiesFromMapping_LMDirichlet() throws IOException
             .put("index.similarity.my_similarity.mu", 3000f)
             .build();
 
-        MapperService mapperService = createIndex("foo", indexSettings, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("foo", indexSettings, mapping).mapperService();
         assertThat(mapperService.fullName("field1").similarity().get(), instanceOf(LMDirichletSimilarity.class));
 
         LMDirichletSimilarity similarity = (LMDirichletSimilarity) mapperService.fullName("field1").similarity().get();
@@ -185,7 +185,7 @@ public void testResolveSimilaritiesFromMapping_LMDirichlet() throws IOException
     }
 
     public void testResolveSimilaritiesFromMapping_LMJelinekMercer() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field1").field("type", "text").field("similarity", "my_similarity").endObject()
             .endObject()
@@ -195,7 +195,7 @@ public void testResolveSimilaritiesFromMapping_LMJelinekMercer() throws IOExcept
             .put("index.similarity.my_similarity.type", "LMJelinekMercer")
             .put("index.similarity.my_similarity.lambda", 0.7f)
             .build();
-        MapperService mapperService = createIndex("foo", indexSettings, "type", mapping).mapperService();
+        MapperService mapperService = createIndex("foo", indexSettings, mapping).mapperService();
         assertThat(mapperService.fullName("field1").similarity().get(), instanceOf(LMJelinekMercerSimilarity.class));
 
         LMJelinekMercerSimilarity similarity = (LMJelinekMercerSimilarity) mapperService.fullName("field1").similarity().get();
diff --git a/server/src/test/java/org/elasticsearch/index/termvectors/TermVectorsServiceTests.java b/server/src/test/java/org/elasticsearch/index/termvectors/TermVectorsServiceTests.java
index b22714a0e51e5..0bea9a4b01fd3 100644
--- a/server/src/test/java/org/elasticsearch/index/termvectors/TermVectorsServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/index/termvectors/TermVectorsServiceTests.java
@@ -48,7 +48,7 @@ public class TermVectorsServiceTests extends ESSingleNodeTestCase {
     public void testTook() throws Exception {
         XContentBuilder mapping = jsonBuilder()
             .startObject()
-                .startObject("type1")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "text")
@@ -57,7 +57,7 @@ public void testTook() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        createIndex("test", Settings.EMPTY, "type1", mapping);
+        createIndex("test", Settings.EMPTY, mapping);
         ensureGreen();
 
         client().prepareIndex("test").setId("0").setSource("field", "foo bar").setRefreshPolicy(IMMEDIATE).get();
@@ -92,7 +92,7 @@ public void testDocFreqs() throws IOException {
         Settings settings = Settings.builder()
                 .put("number_of_shards", 1)
                 .build();
-        createIndex("test", settings, "_doc", mapping);
+        createIndex("test", settings, mapping);
         ensureGreen();
 
         int max = between(3, 10);
@@ -135,7 +135,7 @@ public void testWithIndexedPhrases() throws IOException {
         Settings settings = Settings.builder()
                 .put("number_of_shards", 1)
                 .build();
-        createIndex("test", settings, "_doc", mapping);
+        createIndex("test", settings, mapping);
         ensureGreen();
 
         int max = between(3, 10);
diff --git a/server/src/test/java/org/elasticsearch/indices/analysis/PreBuiltAnalyzerIntegrationIT.java b/server/src/test/java/org/elasticsearch/indices/analysis/PreBuiltAnalyzerIntegrationIT.java
index 2349225c1b160..7f9f2f4675b18 100644
--- a/server/src/test/java/org/elasticsearch/indices/analysis/PreBuiltAnalyzerIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/analysis/PreBuiltAnalyzerIntegrationIT.java
@@ -65,7 +65,7 @@ public void testThatPreBuiltAnalyzersAreNotClosedOnIndexClose() throws Exception
             loadedAnalyzers.get(preBuiltAnalyzer).add(randomVersion);
 
             final XContentBuilder mapping = jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("foo")
                             .field("type", "text")
@@ -76,7 +76,7 @@ public void testThatPreBuiltAnalyzersAreNotClosedOnIndexClose() throws Exception
                 .endObject();
 
             Settings versionSettings = settings(randomVersion).build();
-            client().admin().indices().prepareCreate(indexName).addMapping("type", mapping).setSettings(versionSettings).get();
+            client().admin().indices().prepareCreate(indexName).setMapping(mapping).setSettings(versionSettings).get();
         }
 
         ensureGreen();
diff --git a/server/src/test/java/org/elasticsearch/indices/mapping/SimpleGetFieldMappingsIT.java b/server/src/test/java/org/elasticsearch/indices/mapping/SimpleGetFieldMappingsIT.java
index f4213eb486f8d..48fdfea8dfbad 100644
--- a/server/src/test/java/org/elasticsearch/indices/mapping/SimpleGetFieldMappingsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/mapping/SimpleGetFieldMappingsIT.java
@@ -67,9 +67,9 @@ public void testGetMappingsWhereThereAreNone() {
         assertThat(response.fieldMappings("index", "field"), Matchers.nullValue());
     }
 
-    private XContentBuilder getMappingForType(String type) throws IOException {
+    private XContentBuilder getMappingForType() throws IOException {
         return jsonBuilder().startObject()
-            .startObject(type)
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field1")
                         .field("type", "text")
@@ -93,9 +93,9 @@ private XContentBuilder getMappingForType(String type) throws IOException {
     public void testGetFieldMappings() throws Exception {
 
         assertAcked(prepareCreate("indexa")
-            .addMapping("typeA", getMappingForType("typeA")));
+            .setMapping(getMappingForType()));
         assertAcked(client().admin().indices().prepareCreate("indexb")
-            .addMapping("typeB", getMappingForType("typeB")));
+            .setMapping(getMappingForType()));
 
 
         // Get mappings by full name
@@ -125,7 +125,7 @@ public void testGetFieldMappings() throws Exception {
 
     @SuppressWarnings("unchecked")
     public void testSimpleGetFieldMappingsWithDefaults() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type", getMappingForType("type")));
+        assertAcked(prepareCreate("test").setMapping(getMappingForType()));
         client().admin().indices().preparePutMapping("test").setSource("num", "type=long").get();
 
         GetFieldMappingsResponse response = client().admin().indices().prepareGetFieldMappings()
@@ -145,7 +145,7 @@ public void testSimpleGetFieldMappingsWithDefaults() throws Exception {
 
     @SuppressWarnings("unchecked")
     public void testGetFieldMappingsWithFieldAlias() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type", getMappingForType("type")));
+        assertAcked(prepareCreate("test").setMapping(getMappingForType()));
 
         GetFieldMappingsResponse response = client().admin().indices().prepareGetFieldMappings()
             .setFields("alias", "field1").get();
@@ -162,7 +162,7 @@ public void testGetFieldMappingsWithFieldAlias() throws Exception {
 
     //fix #6552
     public void testSimpleGetFieldMappingsWithPretty() throws Exception {
-        assertAcked(prepareCreate("index").addMapping("type", getMappingForType("type")));
+        assertAcked(prepareCreate("index").setMapping(getMappingForType()));
         Map<String, String> params = new HashMap<>();
         params.put("pretty", "true");
         GetFieldMappingsResponse response = client().admin().indices().prepareGetFieldMappings("index")
@@ -192,7 +192,7 @@ public void testSimpleGetFieldMappingsWithPretty() throws Exception {
 
     public void testGetFieldMappingsWithBlocks() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("_doc", getMappingForType("_doc")));
+                .setMapping(getMappingForType()));
 
         for (String block : Arrays.asList(SETTING_BLOCKS_READ, SETTING_BLOCKS_WRITE, SETTING_READ_ONLY)) {
             try {
diff --git a/server/src/test/java/org/elasticsearch/indices/mapping/SimpleGetMappingsIT.java b/server/src/test/java/org/elasticsearch/indices/mapping/SimpleGetMappingsIT.java
index 42d1b921481f6..83050a30eff3f 100644
--- a/server/src/test/java/org/elasticsearch/indices/mapping/SimpleGetMappingsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/mapping/SimpleGetMappingsIT.java
@@ -57,18 +57,18 @@ public void testGetMappingsWhereThereAreNone() {
         assertEquals(MappingMetaData.EMPTY_MAPPINGS, response.mappings().get("index"));
     }
 
-    private XContentBuilder getMappingForType(String type) throws IOException {
-        return jsonBuilder().startObject().startObject(type).startObject("properties")
+    private XContentBuilder getMappingForType() throws IOException {
+        return jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("field1").field("type", "text").endObject()
                 .endObject().endObject().endObject();
     }
 
     public void testSimpleGetMappings() throws Exception {
         client().admin().indices().prepareCreate("indexa")
-                .addMapping("typeA", getMappingForType("typeA"))
+                .setMapping(getMappingForType())
                 .execute().actionGet();
         client().admin().indices().prepareCreate("indexb")
-                .addMapping("typeA", getMappingForType("typeA"))
+                .setMapping(getMappingForType())
                 .execute().actionGet();
 
         ClusterHealthResponse clusterHealth = client().admin().cluster().prepareHealth()
@@ -95,7 +95,7 @@ public void testSimpleGetMappings() throws Exception {
 
     public void testGetMappingsWithBlocks() throws IOException {
         client().admin().indices().prepareCreate("test")
-                .addMapping("_doc", getMappingForType("_doc"))
+                .setMapping(getMappingForType())
                 .execute().actionGet();
         ensureGreen();
 
diff --git a/server/src/test/java/org/elasticsearch/mget/SimpleMgetIT.java b/server/src/test/java/org/elasticsearch/mget/SimpleMgetIT.java
index 33bdca6e8aab2..33e61a4c791a5 100644
--- a/server/src/test/java/org/elasticsearch/mget/SimpleMgetIT.java
+++ b/server/src/test/java/org/elasticsearch/mget/SimpleMgetIT.java
@@ -108,8 +108,8 @@ public void testThatMgetShouldWorkWithMultiIndexAlias() throws IOException {
 
     public void testThatMgetShouldWorkWithAliasRouting() throws IOException {
         assertAcked(prepareCreate("test").addAlias(new Alias("alias1").routing("abc"))
-            .addMapping("test", jsonBuilder()
-                .startObject().startObject("test").startObject("_routing").field("required", true).endObject().endObject().endObject()));
+            .setMapping(jsonBuilder()
+                .startObject().startObject("_doc").startObject("_routing").field("required", true).endObject().endObject().endObject()));
 
         client().prepareIndex("alias1").setId("1").setSource(jsonBuilder().startObject().field("foo", "bar").endObject())
             .setRefreshPolicy(IMMEDIATE).get();
diff --git a/server/src/test/java/org/elasticsearch/routing/SimpleRoutingIT.java b/server/src/test/java/org/elasticsearch/routing/SimpleRoutingIT.java
index 09c5209fe36d8..56d645b54eb33 100644
--- a/server/src/test/java/org/elasticsearch/routing/SimpleRoutingIT.java
+++ b/server/src/test/java/org/elasticsearch/routing/SimpleRoutingIT.java
@@ -332,9 +332,9 @@ public void testRequiredRoutingCrudApis() throws Exception {
                 .indices()
                 .prepareCreate("test")
                 .addAlias(new Alias("alias"))
-                .addMapping("type1", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                                                     .startObject()
-                                                    .startObject("type1")
+                                                    .startObject("_doc")
                                                     .startObject("_routing")
                                                     .field("required", true)
                                                     .endObject()
@@ -443,7 +443,7 @@ public void testRequiredRoutingCrudApis() throws Exception {
     public void testRequiredRoutingBulk() throws Exception {
         client().admin().indices().prepareCreate("test")
                 .addAlias(new Alias("alias"))
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                                                     .startObject("_routing").field("required", true).endObject()
                                                     .endObject().endObject())
                 .execute().actionGet();
@@ -532,9 +532,9 @@ public void testRequiredRoutingMappingVariousAPIs() throws Exception {
                 .indices()
                 .prepareCreate("test")
                 .addAlias(new Alias("alias"))
-                .addMapping("type1", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                                                     .startObject()
-                                                    .startObject("type1")
+                                                    .startObject("_doc")
                                                     .startObject("_routing")
                                                     .field("required", true)
                                                     .endObject()
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/CombiIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/CombiIT.java
index 6abb45c874de1..57910257079dd 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/CombiIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/CombiIT.java
@@ -111,9 +111,9 @@ public void testMultipleAggsOnSameField_WithDifferentRequiredValueSourceType() t
      */
     public void testSubAggregationForTopAggregationOnUnmappedField() throws Exception {
 
-        prepareCreate("idx").addMapping("type", jsonBuilder()
+        prepareCreate("idx").setMapping(jsonBuilder()
                 .startObject()
-                .startObject("type").startObject("properties")
+                .startObject("_doc").startObject("properties")
                     .startObject("name").field("type", "keyword").endObject()
                     .startObject("value").field("type", "integer").endObject()
                 .endObject().endObject()
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/EquivalenceIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/EquivalenceIT.java
index 8c392042a542c..3ee41120a7baa 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/EquivalenceIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/EquivalenceIT.java
@@ -121,9 +121,9 @@ public void testRandomRanges() throws Exception {
         }
 
         prepareCreate("idx")
-                .addMapping("type", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                            .startObject("type")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("values")
                                         .field("type", "double")
@@ -226,9 +226,9 @@ public void testDuelTerms() throws Exception {
         final IntHashSet valuesSet = new IntHashSet();
         cluster().wipeIndices("idx");
         prepareCreate("idx")
-                .addMapping("type", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                            .startObject("type")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("num")
                                         .field("type", "double")
@@ -351,9 +351,9 @@ public void testDuelTerms() throws Exception {
     // Duel between histograms and scripted terms
     public void testDuelTermsHistogram() throws Exception {
         prepareCreate("idx")
-                .addMapping("type", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                            .startObject("type")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("num")
                                         .field("type", "double")
@@ -422,9 +422,9 @@ public void testDuelTermsHistogram() throws Exception {
     public void testLargeNumbersOfPercentileBuckets() throws Exception {
         // test high numbers of percentile buckets to make sure paging and release work correctly
         prepareCreate("idx")
-                .addMapping("type", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                            .startObject("type")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("double_value")
                                         .field("type", "double")
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NestedIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NestedIT.java
index 16463a5f96e4d..8e741fcf223df 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NestedIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NestedIT.java
@@ -132,7 +132,7 @@ public void setupSuiteScopeCluster() throws Exception {
         }
 
         assertAcked(prepareCreate("idx_nested_nested_aggs")
-                .addMapping("type", jsonBuilder().startObject().startObject("type").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("nested1")
                             .field("type", "nested")
                             .startObject("properties")
@@ -368,7 +368,7 @@ public void testNestedOnObjectField() throws Exception {
 
     // Test based on: https://github.com/elastic/elasticsearch/issues/9280
     public void testParentFilterResolvedCorrectly() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("provider").startObject("properties")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc").startObject("properties")
                     .startObject("comments")
                         .field("type", "nested")
                         .startObject("properties")
@@ -400,7 +400,7 @@ public void testParentFilterResolvedCorrectly() throws Exception {
                 .endObject().endObject().endObject();
         assertAcked(prepareCreate("idx2")
                 .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("provider", mapping));
+                .setMapping(mapping));
         ensureGreen("idx2");
 
         List<IndexRequestBuilder> indexRequests = new ArrayList<>(2);
@@ -559,7 +559,7 @@ public void testNestedSameDocIdProcessedMultipleTime() throws Exception {
 
     public void testFilterAggInsideNestedAgg() throws Exception {
         assertAcked(prepareCreate("classes")
-                .addMapping("class", jsonBuilder().startObject().startObject("class").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("name").field("type", "text").endObject()
                         .startObject("methods")
                             .field("type", "nested")
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ReverseNestedIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ReverseNestedIT.java
index afb52b0c8aca0..13f114f023119 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ReverseNestedIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ReverseNestedIT.java
@@ -62,8 +62,7 @@ public class ReverseNestedIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(prepareCreate("idx1")
-                .addMapping(
-                        "type",
+                .setMapping(
                         jsonBuilder().startObject().startObject("properties")
                                 .startObject("field1").field("type", "keyword").endObject()
                                 .startObject("alias")
@@ -76,8 +75,7 @@ public void setupSuiteScopeCluster() throws Exception {
                                 .endObject().endObject()
                 ));
         assertAcked(prepareCreate("idx2")
-                .addMapping(
-                        "type",
+                .setMapping(
                         jsonBuilder().startObject().startObject("properties")
                                 .startObject("nested1").field("type", "nested").startObject("properties")
                                     .startObject("field1").field("type", "keyword").endObject()
@@ -497,7 +495,7 @@ public void testNonExistingNestedField() throws Exception {
     }
 
     public void testSameParentDocHavingMultipleBuckets() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("product").field("dynamic", "strict").startObject("properties")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc").field("dynamic", "strict").startObject("properties")
                 .startObject("id").field("type", "long").endObject()
                 .startObject("category")
                     .field("type", "nested")
@@ -521,7 +519,7 @@ public void testSameParentDocHavingMultipleBuckets() throws Exception {
         assertAcked(
                 prepareCreate("idx3")
                         .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                        .addMapping("product", mapping)
+                        .setMapping(mapping)
         );
 
         client().prepareIndex("idx3").setId("1").setRefreshPolicy(IMMEDIATE).setSource(
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
index b290d44a3e85d..ca03e1d893d7b 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
@@ -115,8 +115,8 @@ public Settings indexSettings() {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
 
-        prepareCreate("idx").addMapping("type",
-                jsonBuilder().startObject().startObject("type").startObject("properties")
+        prepareCreate("idx").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties")
                     .startObject("str_value")
                         .field("type", "keyword")
                     .endObject()
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
index 207060d05ce72..321a03d236c96 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
@@ -125,8 +125,8 @@ public void setupSuiteScopeCluster() throws Exception {
         assertAcked(prepareCreate("idx").addMapping("type", TERMS_AGGS_FIELD, "type=keyword"));
         assertAcked(prepareCreate("field-collapsing").addMapping("type", "group", "type=keyword"));
         createIndex("empty");
-        assertAcked(prepareCreate("articles").addMapping("article",
-            jsonBuilder().startObject().startObject("article").startObject("properties")
+        assertAcked(prepareCreate("articles").setMapping(
+            jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject(TERMS_AGGS_FIELD)
                     .field("type", "keyword")
                 .endObject()
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MaxBucketIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MaxBucketIT.java
index 1ad6ff1707af0..700baa5b00a91 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MaxBucketIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MaxBucketIT.java
@@ -511,7 +511,7 @@ public void testFieldIsntWrittenOutTwice() throws Exception {
             .endObject().endObject().endObject()
             .endObject().endObject().endObject().endObject();
         assertAcked(client().admin().indices().prepareCreate("foo_2")
-            .addMapping("doc", builder).get());
+            .setMapping(builder).get());
 
         XContentBuilder docBuilder = jsonBuilder().startObject()
             .startObject("license").field("partnumber", "foobar").field("count", 2).endObject()
diff --git a/server/src/test/java/org/elasticsearch/search/fetch/FetchSubPhasePluginIT.java b/server/src/test/java/org/elasticsearch/search/fetch/FetchSubPhasePluginIT.java
index 7122c17aecd58..b13d92cc18a56 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/FetchSubPhasePluginIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/FetchSubPhasePluginIT.java
@@ -69,10 +69,9 @@ public void testPlugin() throws Exception {
         client().admin()
                 .indices()
                 .prepareCreate("test")
-                .addMapping(
-                        "type1",
+                .setMapping(
                         jsonBuilder()
-                                .startObject().startObject("type1")
+                                .startObject().startObject("_doc")
                                 .startObject("properties")
                                 .startObject("test")
                                 .field("type", "text").field("term_vector", "yes")
diff --git a/server/src/test/java/org/elasticsearch/search/fetch/subphase/InnerHitsIT.java b/server/src/test/java/org/elasticsearch/search/fetch/subphase/InnerHitsIT.java
index 675d25c2836c6..c34d7c458ce12 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/subphase/InnerHitsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/subphase/InnerHitsIT.java
@@ -86,7 +86,7 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
     }
 
     public void testSimpleNested() throws Exception {
-        assertAcked(prepareCreate("articles").addMapping("article", jsonBuilder().startObject().startObject("article")
+        assertAcked(prepareCreate("articles").setMapping(jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("comments")
                     .field("type", "nested")
@@ -244,8 +244,8 @@ public void testRandomNested() throws Exception {
     }
 
     public void testNestedMultipleLayers() throws Exception {
-        assertAcked(prepareCreate("articles").addMapping("article", jsonBuilder().startObject()
-                .startObject("article").startObject("properties")
+        assertAcked(prepareCreate("articles").setMapping(jsonBuilder().startObject()
+                .startObject("_doc").startObject("properties")
                     .startObject("comments")
                         .field("type", "nested")
                         .startObject("properties")
@@ -387,7 +387,7 @@ public void testInnerHitsWithObjectFieldThatHasANestedField() throws Exception {
                         // number_of_shards = 1, because then we catch the expected exception in the same way.
                         // (See expectThrows(...) below)
                         .setSettings(Settings.builder().put("index.number_of_shards", 1))
-                        .addMapping("article", jsonBuilder().startObject()
+                        .setMapping(jsonBuilder().startObject()
                                         .startObject("properties")
                                             .startObject("comments")
                                                 .field("type", "object")
@@ -486,7 +486,7 @@ public void testInnerHitsWithObjectFieldThatHasANestedField() throws Exception {
 
     public void testMatchesQueriesNestedInnerHits() throws Exception {
         XContentBuilder builder = jsonBuilder().startObject()
-                .startObject("type1")
+                .startObject("_doc")
                 .startObject("properties")
                 .startObject("nested1")
                 .field("type", "nested")
@@ -502,7 +502,7 @@ public void testMatchesQueriesNestedInnerHits() throws Exception {
                 .endObject()
                 .endObject()
                 .endObject();
-        assertAcked(prepareCreate("test").addMapping("type1", builder));
+        assertAcked(prepareCreate("test").setMapping(builder));
         ensureGreen();
 
         List<IndexRequestBuilder> requests = new ArrayList<>();
diff --git a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
index d09e7d05fa6f0..2813f1a1e9757 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
@@ -123,7 +123,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
     public void testHighlightingWithKeywordIgnoreBoundaryScanner() throws IOException {
         XContentBuilder mappings = jsonBuilder();
         mappings.startObject();
-        mappings.startObject("type")
+        mappings.startObject("_doc")
             .startObject("properties")
                 .startObject("tags")
                     .field("type", "keyword")
@@ -134,7 +134,7 @@ public void testHighlightingWithKeywordIgnoreBoundaryScanner() throws IOExceptio
             .endObject().endObject();
         mappings.endObject();
         assertAcked(prepareCreate("test")
-            .addMapping("type", mappings));
+            .setMapping(mappings));
         client().prepareIndex("test").setId("1")
             .setSource(jsonBuilder()
                 .startObject()
@@ -165,7 +165,7 @@ public void testHighlightingWithKeywordIgnoreBoundaryScanner() throws IOExceptio
     public void testHighlightingWithStoredKeyword() throws IOException {
         XContentBuilder mappings = jsonBuilder();
         mappings.startObject();
-        mappings.startObject("type")
+        mappings.startObject("_doc")
             .startObject("properties")
                 .startObject("text")
                     .field("type", "keyword")
@@ -174,7 +174,7 @@ public void testHighlightingWithStoredKeyword() throws IOException {
             .endObject().endObject();
         mappings.endObject();
         assertAcked(prepareCreate("test")
-            .addMapping("type", mappings));
+            .setMapping(mappings));
         client().prepareIndex("test").setId("1")
             .setSource(jsonBuilder().startObject().field("text", "foo").endObject())
             .get();
@@ -188,7 +188,7 @@ public void testHighlightingWithWildcardName() throws IOException {
         // test the kibana case with * as fieldname that will try highlight all fields including meta fields
         XContentBuilder mappings = jsonBuilder();
         mappings.startObject();
-        mappings.startObject("type")
+        mappings.startObject("_doc")
                 .startObject("properties")
                     .startObject("text")
                         .field("type", "text")
@@ -199,7 +199,7 @@ public void testHighlightingWithWildcardName() throws IOException {
                 .endObject().endObject();
         mappings.endObject();
         assertAcked(prepareCreate("test")
-                .addMapping("type", mappings));
+                .setMapping(mappings));
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject().field("text", "text").endObject())
                 .get();
@@ -214,7 +214,7 @@ public void testHighlightingWithWildcardName() throws IOException {
     public void testFieldAlias() throws IOException {
         XContentBuilder mappings = jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("text")
                             .field("type", "text")
@@ -228,7 +228,7 @@ public void testFieldAlias() throws IOException {
                     .endObject()
             .endObject()
         .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mappings));
+        assertAcked(prepareCreate("test").setMapping(mappings));
 
         client().prepareIndex("test").setId("1").setSource("text", "foo").get();
         refresh();
@@ -248,7 +248,7 @@ public void testFieldAlias() throws IOException {
     public void testFieldAliasWithSourceLookup() throws IOException {
         XContentBuilder mappings = jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("text")
                             .field("type", "text")
@@ -263,7 +263,7 @@ public void testFieldAliasWithSourceLookup() throws IOException {
                     .endObject()
             .endObject()
         .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mappings));
+        assertAcked(prepareCreate("test").setMapping(mappings));
 
         client().prepareIndex("test").setId("1").setSource("text", "foo bar").get();
         refresh();
@@ -283,7 +283,7 @@ public void testFieldAliasWithSourceLookup() throws IOException {
     public void testFieldAliasWithWildcardField() throws IOException {
         XContentBuilder mappings = jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("keyword")
                             .field("type", "keyword")
@@ -295,7 +295,7 @@ public void testFieldAliasWithWildcardField() throws IOException {
                     .endObject()
             .endObject()
         .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mappings));
+        assertAcked(prepareCreate("test").setMapping(mappings));
 
         client().prepareIndex("test").setId("1").setSource("keyword", "foo").get();
         refresh();
@@ -314,7 +314,7 @@ public void testFieldAliasWithWildcardField() throws IOException {
     public void testHighlightingWhenFieldsAreNotStoredThereIsNoSource() throws IOException {
         XContentBuilder mappings = jsonBuilder();
         mappings.startObject();
-        mappings.startObject("type")
+        mappings.startObject("_doc")
                 .startObject("_source")
                     .field("enabled", false)
                 .endObject()
@@ -334,7 +334,7 @@ public void testHighlightingWhenFieldsAreNotStoredThereIsNoSource() throws IOExc
                 .endObject().endObject();
         mappings.endObject();
         assertAcked(prepareCreate("test")
-                .addMapping("type", mappings));
+                .setMapping(mappings));
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject().field("unstored_text", "text").field("text", "text").endObject())
                 .get();
@@ -401,7 +401,7 @@ public void testEnsureNoNegativeOffsets() throws Exception {
 
     public void testSourceLookupHighlightingUsingPlainHighlighter() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         // we don't store title and don't use term vector, now lets see if it works...
                         .startObject("title")
                             .field("type", "text")
@@ -451,7 +451,7 @@ public void testSourceLookupHighlightingUsingPlainHighlighter() throws Exception
 
     public void testSourceLookupHighlightingUsingFastVectorHighlighter() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         // we don't store title, now lets see if it works...
                         .startObject("title")
                             .field("type", "text")
@@ -503,7 +503,7 @@ public void testSourceLookupHighlightingUsingFastVectorHighlighter() throws Exce
 
     public void testSourceLookupHighlightingUsingPostingsHighlighter() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         // we don't store title, now lets see if it works...
                         .startObject("title")
                             .field("type", "text")
@@ -654,7 +654,7 @@ public void testHighlightingOnWildcardFields() throws Exception {
 
     public void testForceSourceWithSourceDisabled() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1")
+                .setMapping(jsonBuilder().startObject().startObject("_doc")
                         .startObject("_source").field("enabled", false).endObject()
                         .startObject("properties")
                         .startObject("field1").field("type", "text").field("store", true).field("index_options", "offsets")
@@ -714,7 +714,7 @@ public void testPlainHighlighter() throws Exception {
     }
 
     public void testFastVectorHighlighter() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         ensureGreen();
 
         indexRandom(true, client().prepareIndex("test")
@@ -749,7 +749,7 @@ public void testFastVectorHighlighter() throws Exception {
     }
 
     public void testHighlighterWithSentenceBoundaryScanner() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         ensureGreen();
 
         indexRandom(true, client().prepareIndex("test")
@@ -779,7 +779,7 @@ public void testHighlighterWithSentenceBoundaryScanner() throws Exception {
     }
 
     public void testHighlighterWithSentenceBoundaryScannerAndLocale() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         ensureGreen();
 
         indexRandom(true, client().prepareIndex("test")
@@ -811,7 +811,7 @@ public void testHighlighterWithSentenceBoundaryScannerAndLocale() throws Excepti
     }
 
     public void testHighlighterWithWordBoundaryScanner() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         ensureGreen();
 
         indexRandom(true, client().prepareIndex("test")
@@ -837,7 +837,7 @@ public void testHighlighterWithWordBoundaryScanner() throws Exception {
     }
 
     public void testHighlighterWithWordBoundaryScannerAndLocale() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         ensureGreen();
 
         indexRandom(true, client().prepareIndex("test")
@@ -867,7 +867,7 @@ public void testHighlighterWithWordBoundaryScannerAndLocale() throws Exception {
      * phraseLimit is not set. Its default is now reasonably low.
      */
     public void testFVHManyMatches() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         ensureGreen();
 
         // Index one megabyte of "t   " over and over and over again
@@ -917,7 +917,7 @@ private void checkMatchedFieldsCase(boolean requireFieldMatch) throws Exception
         settings.put("index.analysis.analyzer.mock_english.filter", "mock_snowball");
         assertAcked(prepareCreate("test")
             .setSettings(settings)
-            .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1")
+            .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("foo")
                         .field("type", "text")
@@ -1071,7 +1071,7 @@ private void checkMatchedFieldsCase(boolean requireFieldMatch) throws Exception
     }
 
     public void testFastVectorHighlighterManyDocs() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         ensureGreen();
 
         int COUNT = between(20, 100);
@@ -1096,7 +1096,7 @@ public void testFastVectorHighlighterManyDocs() throws Exception {
     }
 
     public XContentBuilder type1TermVectorMapping() throws IOException {
-        return XContentFactory.jsonBuilder().startObject().startObject("type1")
+        return XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("field1").field("type", "text").field("term_vector", "with_positions_offsets").endObject()
                 .startObject("field2").field("type", "text").field("term_vector", "with_positions_offsets").endObject()
@@ -1193,7 +1193,7 @@ public void testEscapeHtmlVector() throws Exception {
 
     public void testMultiMapperVectorWithStore() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("title")
                             .field("type", "text")
                             .field("store", true)
@@ -1231,7 +1231,7 @@ public void testMultiMapperVectorWithStore() throws Exception {
 
     public void testMultiMapperVectorFromSource() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("title")
                             .field("type", "text")
                             .field("store", false)
@@ -1270,7 +1270,7 @@ public void testMultiMapperVectorFromSource() throws Exception {
 
     public void testMultiMapperNoVectorWithStore() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("title")
                             .field("type", "text")
                             .field("store", true)
@@ -1311,7 +1311,7 @@ public void testMultiMapperNoVectorWithStore() throws Exception {
 
     public void testMultiMapperNoVectorFromSource() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("title")
                             .field("type", "text")
                             .field("store", false)
@@ -1463,7 +1463,7 @@ public void testBoostingQuery() {
     }
 
     public void testBoostingQueryTermVector() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         ensureGreen();
         client().prepareIndex("test").setSource(
                 "field1", "this is a test",
@@ -1945,7 +1945,7 @@ public void testHighlightNoMatchSizeNumberOfFragments() throws IOException {
     }
 
     public void testPostingsHighlighter() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test")
@@ -2003,7 +2003,7 @@ public void testPostingsHighlighter() throws Exception {
     }
 
     public void testPostingsHighlighterMultipleFields() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()).get());
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()).get());
         ensureGreen();
 
         indexDoc("test", "1",
@@ -2022,7 +2022,7 @@ public void testPostingsHighlighterMultipleFields() throws Exception {
     }
 
     public void testPostingsHighlighterNumberOfFragments() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test").setId("1").setSource(
@@ -2083,7 +2083,7 @@ public void testPostingsHighlighterNumberOfFragments() throws Exception {
     }
 
     public void testMultiMatchQueryHighlight() throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field1")
                         .field("type", "text")
@@ -2097,7 +2097,7 @@ public void testMultiMatchQueryHighlight() throws IOException {
                     .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(prepareCreate("test").addMapping("type1", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
         ensureGreen();
         client().prepareIndex("test")
                 .setSource("field1", "The quick brown fox jumps over",
@@ -2125,7 +2125,7 @@ public void testMultiMatchQueryHighlight() throws IOException {
     }
 
     public void testPostingsHighlighterOrderByScore() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test")
@@ -2183,7 +2183,7 @@ public void testPostingsHighlighterEscapeHtml() throws Exception {
 
     public void testPostingsHighlighterMultiMapperWithStore() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("title")
                             .field("type", "text")
                             .field("store", true)
@@ -2226,7 +2226,7 @@ public void testPostingsHighlighterMultiMapperWithStore() throws Exception {
 
     public void testPostingsHighlighterMultiMapperFromSource() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("title")
                             .field("type", "text")
                             .field("store", false)
@@ -2264,7 +2264,7 @@ public void testPostingsHighlighterMultiMapperFromSource() throws Exception {
 
     public void testPostingsHighlighterShouldFailIfNoOffsets() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("title").field("type", "text").field("store", true).field("index_options", "docs").endObject()
                         .endObject().endObject().endObject()));
         ensureGreen();
@@ -2284,7 +2284,7 @@ public void testPostingsHighlighterShouldFailIfNoOffsets() throws Exception {
     }
 
     public void testPostingsHighlighterBoostingQuery() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
         client().prepareIndex("test")
             .setSource("field1", "this is a test", "field2", "The quick brown fox jumps over the lazy dog! Second sentence.").get();
@@ -2301,7 +2301,7 @@ public void testPostingsHighlighterBoostingQuery() throws IOException {
     }
 
     private static XContentBuilder type1PostingsffsetsMapping() throws IOException {
-        return XContentFactory.jsonBuilder().startObject().startObject("type1")
+        return XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("field1").field("type", "text").field("index_options", "offsets").endObject()
                 .startObject("field2").field("type", "text").field("index_options", "offsets").endObject()
@@ -2310,7 +2310,7 @@ private static XContentBuilder type1PostingsffsetsMapping() throws IOException {
     }
 
     public void testPostingsHighlighterPrefixQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test")
@@ -2326,7 +2326,7 @@ public void testPostingsHighlighterPrefixQuery() throws Exception {
     }
 
     public void testPostingsHighlighterFuzzyQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test")
@@ -2343,7 +2343,7 @@ public void testPostingsHighlighterFuzzyQuery() throws Exception {
     }
 
     public void testPostingsHighlighterRegexpQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test")
@@ -2360,7 +2360,7 @@ public void testPostingsHighlighterRegexpQuery() throws Exception {
     }
 
     public void testPostingsHighlighterWildcardQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test")
@@ -2385,7 +2385,7 @@ public void testPostingsHighlighterWildcardQuery() throws Exception {
     }
 
     public void testPostingsHighlighterTermRangeQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test").setSource("field1", "this is a test", "field2", "aaab").get();
@@ -2400,7 +2400,7 @@ public void testPostingsHighlighterTermRangeQuery() throws Exception {
     }
 
     public void testPostingsHighlighterQueryString() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test")
@@ -2416,7 +2416,7 @@ public void testPostingsHighlighterQueryString() throws Exception {
     }
 
     public void testPostingsHighlighterRegexpQueryWithinConstantScoreQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test").setSource("field1", "The photography word will get highlighted").get();
@@ -2430,7 +2430,7 @@ public void testPostingsHighlighterRegexpQueryWithinConstantScoreQuery() throws
     }
 
     public void testPostingsHighlighterMultiTermQueryMultipleLevels() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test").setSource("field1", "The photography word will get highlighted").get();
@@ -2447,7 +2447,7 @@ public void testPostingsHighlighterMultiTermQueryMultipleLevels() throws Excepti
     }
 
     public void testPostingsHighlighterPrefixQueryWithinBooleanQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test").setSource("field1", "The photography word will get highlighted").get();
@@ -2462,7 +2462,7 @@ public void testPostingsHighlighterPrefixQueryWithinBooleanQuery() throws Except
     }
 
     public void testPostingsHighlighterQueryStringWithinFilteredQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         client().prepareIndex("test").setSource("field1", "The photography word will get highlighted").get();
@@ -2478,7 +2478,7 @@ public void testPostingsHighlighterQueryStringWithinFilteredQuery() throws Excep
     }
 
     public void testPostingsHighlighterManyDocs() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1PostingsffsetsMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1PostingsffsetsMapping()));
         ensureGreen();
 
         int COUNT = between(20, 100);
@@ -2512,12 +2512,12 @@ public void testPostingsHighlighterManyDocs() throws Exception {
     }
 
     public void testDoesNotHighlightTypeName() throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("typename").startObject("properties")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("foo").field("type", "text")
                     .field("index_options", "offsets")
                     .field("term_vector", "with_positions_offsets")
                 .endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").addMapping("typename", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
         ensureGreen();
 
         indexRandom(true, client().prepareIndex("test").setSource("foo", "test typename"));
@@ -2530,12 +2530,12 @@ public void testDoesNotHighlightTypeName() throws Exception {
     }
 
     public void testDoesNotHighlightAliasFilters() throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("typename").startObject("properties")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("foo").field("type", "text")
                     .field("index_options", "offsets")
                     .field("term_vector", "with_positions_offsets")
                 .endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").addMapping("typename", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
         assertAcked(client().admin().indices().prepareAliases().addAlias("test", "filtered_alias", matchQuery("foo", "japanese")));
         ensureGreen();
 
@@ -2549,7 +2549,7 @@ public void testDoesNotHighlightAliasFilters() throws Exception {
     }
 
     public void testFastVectorHighlighterPhraseBoost() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", type1TermVectorMapping()));
+        assertAcked(prepareCreate("test").setMapping(type1TermVectorMapping()));
         phraseBoostTestCase("fvh");
     }
 
@@ -2624,7 +2624,7 @@ public void testGeoFieldHighlightingWithDifferentHighlighters() throws IOExcepti
         // see https://github.com/elastic/elasticsearch/issues/17537
         XContentBuilder mappings = jsonBuilder();
         mappings.startObject();
-        mappings.startObject("type")
+        mappings.startObject("_doc")
             .startObject("properties")
             .startObject("geo_point")
             .field("type", "geo_point")
@@ -2638,7 +2638,7 @@ public void testGeoFieldHighlightingWithDifferentHighlighters() throws IOExcepti
             .endObject();
         mappings.endObject();
         assertAcked(prepareCreate("test")
-            .addMapping("type", mappings));
+            .setMapping(mappings));
 
         client().prepareIndex("test").setId("1")
             .setSource(jsonBuilder().startObject().field("text", "Arbitrary text field which will should not cause a failure").endObject())
@@ -2661,7 +2661,7 @@ public void testGeoFieldHighlightingWhenQueryGetsRewritten() throws IOException
         // see https://github.com/elastic/elasticsearch/issues/17537#issuecomment-244939633
         XContentBuilder mappings = jsonBuilder();
         mappings.startObject();
-        mappings.startObject("jobs")
+        mappings.startObject("_doc")
             .startObject("properties")
             .startObject("loc")
             .field("type", "geo_point")
@@ -2673,7 +2673,7 @@ public void testGeoFieldHighlightingWhenQueryGetsRewritten() throws IOException
             .endObject();
         mappings.endObject();
         assertAcked(prepareCreate("test")
-            .addMapping("jobs", mappings));
+            .setMapping(mappings));
         ensureYellow();
 
         client().prepareIndex("test").setId("1")
@@ -2696,7 +2696,7 @@ public void testKeywordFieldHighlighting() throws IOException {
         // check that keyword highlighting works
         XContentBuilder mappings = jsonBuilder();
         mappings.startObject();
-        mappings.startObject("type")
+        mappings.startObject("_doc")
             .startObject("properties")
             .startObject("keyword_field")
             .field("type", "keyword")
@@ -2705,7 +2705,7 @@ public void testKeywordFieldHighlighting() throws IOException {
             .endObject();
         mappings.endObject();
         assertAcked(prepareCreate("test")
-            .addMapping("type", mappings));
+            .setMapping(mappings));
 
         client().prepareIndex("test").setId("1")
             .setSource(jsonBuilder().startObject().field("keyword_field", "some text").endObject())
diff --git a/server/src/test/java/org/elasticsearch/search/fieldcaps/FieldCapabilitiesIT.java b/server/src/test/java/org/elasticsearch/search/fieldcaps/FieldCapabilitiesIT.java
index 254447abcf8eb..046d1a4eab202 100644
--- a/server/src/test/java/org/elasticsearch/search/fieldcaps/FieldCapabilitiesIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fieldcaps/FieldCapabilitiesIT.java
@@ -71,7 +71,7 @@ public void setUp() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(prepareCreate("old_index").addMapping("_doc", oldIndexMapping));
+        assertAcked(prepareCreate("old_index").setMapping(oldIndexMapping));
 
         XContentBuilder newIndexMapping = XContentFactory.jsonBuilder()
             .startObject()
@@ -89,7 +89,7 @@ public void setUp() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(prepareCreate("new_index").addMapping("_doc", newIndexMapping));
+        assertAcked(prepareCreate("new_index").setMapping(newIndexMapping));
         assertAcked(client().admin().indices().prepareAliases().addAlias("new_index", "current"));
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/fields/SearchFieldsIT.java b/server/src/test/java/org/elasticsearch/search/fields/SearchFieldsIT.java
index 2828e084c5c89..7eeb71e1f3c42 100644
--- a/server/src/test/java/org/elasticsearch/search/fields/SearchFieldsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fields/SearchFieldsIT.java
@@ -677,9 +677,9 @@ public void testSearchFieldsNonLeafField() throws Exception {
     public void testGetFieldsComplexField() throws Exception {
         client().admin().indices().prepareCreate("my-index")
                 .setSettings(Settings.builder().put("index.refresh_interval", -1))
-                .addMapping("doc", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                            .startObject("doc")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("field1")
                                         .field("type", "object")
@@ -994,7 +994,7 @@ public void testScriptFields() throws Exception {
     public void testDocValueFieldsWithFieldAlias() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("_source")
                         .field("enabled", false)
                     .endObject()
@@ -1018,7 +1018,7 @@ public void testDocValueFieldsWithFieldAlias() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
         ensureGreen("test");
 
         DateTime date = new DateTime(1990, 12, 29, 0, 0, DateTimeZone.UTC);
@@ -1057,7 +1057,7 @@ public void testDocValueFieldsWithFieldAlias() throws Exception {
     public void testWildcardDocValueFieldsWithFieldAlias() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-            .startObject("type")
+            .startObject("_doc")
             .startObject("_source")
             .field("enabled", false)
             .endObject()
@@ -1081,7 +1081,7 @@ public void testWildcardDocValueFieldsWithFieldAlias() throws Exception {
             .endObject()
             .endObject()
             .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
         ensureGreen("test");
 
         DateTime date = new DateTime(1990, 12, 29, 0, 0, DateTimeZone.UTC);
@@ -1120,7 +1120,7 @@ public void testWildcardDocValueFieldsWithFieldAlias() throws Exception {
     public void testStoredFieldsWithFieldAlias() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field1")
                             .field("type", "text")
@@ -1141,7 +1141,7 @@ public void testStoredFieldsWithFieldAlias() throws Exception {
                     .endObject()
             .endObject()
         .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
 
         indexDoc("test", "1", "field1", "value1", "field2", "value2");
         refresh("test");
@@ -1164,7 +1164,7 @@ public void testStoredFieldsWithFieldAlias() throws Exception {
     public void testWildcardStoredFieldsWithFieldAlias() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field1")
                             .field("type", "text")
@@ -1185,7 +1185,7 @@ public void testWildcardStoredFieldsWithFieldAlias() throws Exception {
                     .endObject()
             .endObject()
         .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
 
         indexDoc("test", "1", "field1", "value1", "field2", "value2");
         refresh("test");
diff --git a/server/src/test/java/org/elasticsearch/search/functionscore/DecayFunctionScoreIT.java b/server/src/test/java/org/elasticsearch/search/functionscore/DecayFunctionScoreIT.java
index bd2bd76d30649..36205f97c1373 100644
--- a/server/src/test/java/org/elasticsearch/search/functionscore/DecayFunctionScoreIT.java
+++ b/server/src/test/java/org/elasticsearch/search/functionscore/DecayFunctionScoreIT.java
@@ -79,9 +79,8 @@ protected boolean forbidPrivateIndexSettings() {
     private final QueryBuilder baseQuery = constantScoreQuery(termQuery("test", "value"));
 
     public void testDistanceScoreGeoLinGaussExp() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("loc").field("type", "geo_point").endObject().endObject().endObject().endObject()));
 
         List<IndexRequestBuilder> indexBuilders = new ArrayList<>();
@@ -173,9 +172,8 @@ public void testDistanceScoreGeoLinGaussExp() throws Exception {
     }
 
     public void testDistanceScoreGeoLinGaussExpWithOffset() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("num").field("type", "double").endObject().endObject().endObject().endObject()));
 
         // add tw docs within offset
@@ -248,11 +246,10 @@ public void testDistanceScoreGeoLinGaussExpWithOffset() throws Exception {
     public void testBoostModeSettingWorks() throws Exception {
         Settings settings = Settings.builder().put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1).build();
         assertAcked(prepareCreate("test").setSettings(settings)
-            .addMapping(
-                "type1",
+            .setMapping(
                 jsonBuilder()
                     .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                             .startObject("properties")
                                 .startObject("test").field("type", "text").endObject()
                                 .startObject("loc").field("type", "geo_point").endObject()
@@ -315,9 +312,8 @@ public void testBoostModeSettingWorks() throws Exception {
     }
 
     public void testParseGeoPoint() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("loc").field("type", "geo_point").endObject().endObject().endObject().endObject()));
 
         client().prepareIndex()
@@ -359,9 +355,8 @@ public void testParseGeoPoint() throws Exception {
     }
 
     public void testCombineModes() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("num").field("type", "double").endObject().endObject().endObject().endObject()));
 
         client().prepareIndex().setId("1").setIndex("test").setRefreshPolicy(IMMEDIATE)
@@ -439,9 +434,8 @@ public void testCombineModes() throws Exception {
     }
 
     public void testExceptionThrownIfScaleLE0() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("num1").field("type", "date").endObject().endObject().endObject().endObject()));
         client().index(
                 indexRequest("test").id("1")
@@ -464,10 +458,9 @@ public void testExceptionThrownIfScaleLE0() throws Exception {
     }
 
     public void testParseDateMath() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
+        assertAcked(prepareCreate("test").setMapping(
                 jsonBuilder().startObject()
-                    .startObject("type1")
+                    .startObject("_doc")
                         .startObject("properties")
                             .startObject("test")
                                 .field("type", "text")
@@ -505,9 +498,8 @@ public void testParseDateMath() throws Exception {
     }
 
     public void testValueMissingLin() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("num1").field("type", "date").endObject().startObject("num2").field("type", "double")
                         .endObject().endObject().endObject().endObject())
         );
@@ -555,9 +547,8 @@ public void testValueMissingLin() throws Exception {
     public void testDateWithoutOrigin() throws Exception {
         ZonedDateTime dt = ZonedDateTime.now(ZoneOffset.UTC);
 
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("num1").field("type", "date").endObject().endObject().endObject().endObject()));
 
         ZonedDateTime docDate = dt.minusDays(1);
@@ -606,13 +597,13 @@ public void testDateWithoutOrigin() throws Exception {
     public void testManyDocsLin() throws Exception {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        XContentBuilder xContentBuilder = jsonBuilder().startObject().startObject("type").startObject("properties")
+        XContentBuilder xContentBuilder = jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("test").field("type", "text").endObject().startObject("date").field("type", "date")
                 .field("doc_values", true).endObject().startObject("num").field("type", "double")
                 .field("doc_values", true).endObject().startObject("geo").field("type", "geo_point")
                 .field("ignore_malformed", true);
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").setSettings(settings).addMapping("type", xContentBuilder));
+        assertAcked(prepareCreate("test").setSettings(settings).setMapping(xContentBuilder));
         int numDocs = 200;
         List<IndexRequestBuilder> indexBuilders = new ArrayList<>();
 
@@ -657,9 +648,8 @@ public void testManyDocsLin() throws Exception {
     }
 
     public void testParsingExceptionIfFieldDoesNotExist() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type",
-                jsonBuilder().startObject().startObject("type").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("geo").field("type", "geo_point").endObject().endObject().endObject().endObject()));
         int numDocs = 2;
         client().index(
@@ -685,9 +675,8 @@ public void testParsingExceptionIfFieldDoesNotExist() throws Exception {
     }
 
     public void testParsingExceptionIfFieldTypeDoesNotMatch() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type",
-                jsonBuilder().startObject().startObject("type").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("num").field("type", "text").endObject().endObject().endObject().endObject()));
         client().index(
                 indexRequest("test").source(
@@ -706,9 +695,8 @@ public void testParsingExceptionIfFieldTypeDoesNotMatch() throws Exception {
     }
 
     public void testNoQueryGiven() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type",
-                jsonBuilder().startObject().startObject("type").startObject("properties").startObject("test").field("type", "text")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test").field("type", "text")
                         .endObject().startObject("num").field("type", "double").endObject().endObject().endObject().endObject()));
         client().index(
                 indexRequest("test").source(jsonBuilder().startObject().field("test", "value").field("num", 1.0).endObject()))
@@ -724,10 +712,9 @@ public void testNoQueryGiven() throws Exception {
     }
 
     public void testMultiFieldOptions() throws Exception {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
+        assertAcked(prepareCreate("test").setMapping(
                 jsonBuilder().startObject()
-                    .startObject("type1")
+                    .startObject("_doc")
                         .startObject("properties")
                             .startObject("test").field("type", "text").endObject()
                             .startObject("loc").field("type", "geo_point").endObject()
diff --git a/server/src/test/java/org/elasticsearch/search/functionscore/FunctionScoreFieldValueIT.java b/server/src/test/java/org/elasticsearch/search/functionscore/FunctionScoreFieldValueIT.java
index 9af24077a8649..61ea16ae41a51 100644
--- a/server/src/test/java/org/elasticsearch/search/functionscore/FunctionScoreFieldValueIT.java
+++ b/server/src/test/java/org/elasticsearch/search/functionscore/FunctionScoreFieldValueIT.java
@@ -40,11 +40,10 @@
  */
 public class FunctionScoreFieldValueIT extends ESIntegTestCase {
     public void testFieldValueFactor() throws IOException {
-        assertAcked(prepareCreate("test").addMapping(
-                "type1",
+        assertAcked(prepareCreate("test").setMapping(
                 jsonBuilder()
                         .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                         .startObject("properties")
                         .startObject("test")
                         .field("type", randomFrom(new String[]{"short", "float", "long", "integer", "double"}))
diff --git a/server/src/test/java/org/elasticsearch/search/functionscore/FunctionScorePluginIT.java b/server/src/test/java/org/elasticsearch/search/functionscore/FunctionScorePluginIT.java
index ba68cb6dac2a1..1c96d1f6d298f 100644
--- a/server/src/test/java/org/elasticsearch/search/functionscore/FunctionScorePluginIT.java
+++ b/server/src/test/java/org/elasticsearch/search/functionscore/FunctionScorePluginIT.java
@@ -63,9 +63,8 @@ public void testPlugin() throws Exception {
         client().admin()
                 .indices()
                 .prepareCreate("test")
-                .addMapping(
-                        "type1",
-                        jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("test")
+                .setMapping(
+                        jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("test")
                                 .field("type", "text").endObject().startObject("num1").field("type", "date").endObject().endObject()
                                 .endObject().endObject()).get();
         client().admin().cluster().prepareHealth().setWaitForEvents(Priority.LANGUID).setWaitForYellowStatus().get();
diff --git a/server/src/test/java/org/elasticsearch/search/functionscore/QueryRescorerIT.java b/server/src/test/java/org/elasticsearch/search/functionscore/QueryRescorerIT.java
index 493dd82af35b9..886bb3791f287 100644
--- a/server/src/test/java/org/elasticsearch/search/functionscore/QueryRescorerIT.java
+++ b/server/src/test/java/org/elasticsearch/search/functionscore/QueryRescorerIT.java
@@ -108,9 +108,8 @@ public void testEnforceWindowSize() {
 
     public void testRescorePhrase() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping(
-                        "type1",
-                        jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("field1")
+                .setMapping(
+                        jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field1")
                                 .field("analyzer", "whitespace").field("type", "text").endObject().endObject().endObject().endObject())
                 .setSettings(Settings.builder().put(indexSettings()).put("index.number_of_shards", 1)));
 
@@ -155,11 +154,11 @@ public void testRescorePhrase() throws Exception {
     public void testMoreDocs() throws Exception {
         Builder builder = Settings.builder();
 
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("field1").field("type", "text").field("analyzer", "whitespace")
                 .endObject().endObject().endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1", mapping)
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(mapping)
                 .setSettings(builder.put("index.number_of_shards", 1)));
 
         client().prepareIndex("test").setId("1").setSource("field1", "massachusetts avenue boston massachusetts").get();
@@ -228,11 +227,11 @@ public void testMoreDocs() throws Exception {
     public void testSmallRescoreWindow() throws Exception {
         Builder builder = Settings.builder();
 
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("field1").field("type", "text").field("analyzer", "whitespace")
                 .endObject().endObject().endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1", mapping)
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(mapping)
                 .setSettings(builder.put("index.number_of_shards", 1)));
 
         client().prepareIndex("test").setId("3").setSource("field1", "massachusetts").get();
@@ -295,11 +294,11 @@ public void testSmallRescoreWindow() throws Exception {
     public void testRescorerMadeScoresWorse() throws Exception {
         Builder builder = Settings.builder();
 
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("field1").field("type", "text").field("analyzer", "whitespace")
                 .endObject().endObject().endObject().endObject();
 
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1", mapping)
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(mapping)
                 .setSettings(builder.put("index.number_of_shards", 1)));
 
         client().prepareIndex("test").setId("3").setSource("field1", "massachusetts").get();
@@ -428,9 +427,8 @@ public void testEquivalence() throws Exception {
 
     public void testExplain() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping(
-                        "type1",
-                        jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("field1")
+                .setMapping(
+                        jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field1")
                                 .field("analyzer", "whitespace").field("type", "text").endObject().endObject().endObject().endObject())
         );
         ensureGreen();
@@ -650,9 +648,8 @@ private int indexRandomNumbers(String analyzer, int shards, boolean dummyDocs) t
         }
 
         assertAcked(prepareCreate("test")
-                .addMapping(
-                        "type1",
-                        jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("field1")
+                .setMapping(
+                        jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field1")
                                 .field("analyzer", analyzer).field("type", "text").endObject().endObject().endObject().endObject())
                 .setSettings(builder));
         int numDocs = randomIntBetween(100, 150);
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryIT.java b/server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryIT.java
index fe7800e137c9c..085ec80be18cf 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryIT.java
@@ -49,10 +49,10 @@ protected boolean forbidPrivateIndexSettings() {
     public void testSimpleBoundingBoxTest() throws Exception {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("location").field("type", "geo_point");
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").setSettings(settings).addMapping("type1", xContentBuilder));
+        assertAcked(prepareCreate("test").setSettings(settings).setMapping(xContentBuilder));
         ensureGreen();
 
         client().prepareIndex("test").setId("1").setSource(jsonBuilder().startObject()
@@ -120,10 +120,10 @@ public void testSimpleBoundingBoxTest() throws Exception {
     public void testLimit2BoundingBox() throws Exception {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("location").field("type", "geo_point");
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").setSettings(settings).addMapping("type1", xContentBuilder));
+        assertAcked(prepareCreate("test").setSettings(settings).setMapping(xContentBuilder));
         ensureGreen();
 
         client().prepareIndex("test").setId("1").setSource(jsonBuilder().startObject()
@@ -174,10 +174,10 @@ public void testLimit2BoundingBox() throws Exception {
     public void testCompleteLonRange() throws Exception {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("location").field("type", "geo_point");
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").setSettings(settings).addMapping("type1", xContentBuilder));
+        assertAcked(prepareCreate("test").setSettings(settings).setMapping(xContentBuilder));
         ensureGreen();
 
         client().prepareIndex("test").setId("1").setSource(jsonBuilder().startObject()
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoDistanceIT.java b/server/src/test/java/org/elasticsearch/search/geo/GeoDistanceIT.java
index 0e1ac2fdc2eaf..433e8ffaf12b0 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoDistanceIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoDistanceIT.java
@@ -106,10 +106,10 @@ protected boolean forbidPrivateIndexSettings() {
     public void setupTestIndex() throws IOException {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("location").field("type", "geo_point");
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").setSettings(settings).addMapping("type1", xContentBuilder));
+        assertAcked(prepareCreate("test").setSettings(settings).setMapping(xContentBuilder));
         ensureGreen();
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoFilterIT.java b/server/src/test/java/org/elasticsearch/search/geo/GeoFilterIT.java
index 0ce547ec14975..a35be58eebfd0 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoFilterIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoFilterIT.java
@@ -369,7 +369,7 @@ public void testBulk() throws Exception {
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
         XContentBuilder xContentBuilder = XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("country")
+                .startObject("_doc")
                 .startObject("properties")
                 .startObject("pin")
                 .field("type", "geo_point");
@@ -384,7 +384,7 @@ public void testBulk() throws Exception {
                 .endObject();
 
         client().admin().indices().prepareCreate("countries").setSettings(settings)
-                .addMapping("country", xContentBuilder).get();
+                .setMapping(xContentBuilder).get();
         BulkResponse bulk = client().prepareBulk().add(bulkAction, 0, bulkAction.length, null, xContentBuilder.contentType()).get();
 
         for (BulkItemResponse item : bulk.getItems()) {
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
index 612973c0b2362..d32d9f11bc3e7 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
@@ -77,14 +77,14 @@ public class GeoShapeQueryTests extends ESSingleNodeTestCase {
     };
 
     private XContentBuilder createMapping() throws Exception {
-        XContentBuilder xcb = XContentFactory.jsonBuilder().startObject()
+        XContentBuilder xcb = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("location")
             .field("type", "geo_shape");
         if (randomBoolean()) {
             xcb = xcb.field("tree", randomFrom(PREFIX_TREES))
             .field("strategy", randomFrom(SpatialStrategy.RECURSIVE, SpatialStrategy.TERM));
         }
-        xcb = xcb.endObject().endObject().endObject();
+        xcb = xcb.endObject().endObject().endObject().endObject();
 
         return xcb;
     }
@@ -217,7 +217,7 @@ public void testIndexedShapeReference() throws Exception {
 
     public void testIndexedShapeReferenceSourceDisabled() throws Exception {
         XContentBuilder mapping = createMapping();
-        client().admin().indices().prepareCreate("test").addMapping("type1", mapping).get();
+        client().admin().indices().prepareCreate("test").setMapping(mapping).get();
         createIndex("shapes", Settings.EMPTY, "shape_type", "_source", "enabled=false");
         ensureGreen();
 
@@ -652,7 +652,7 @@ public void testPointsOnlyExplicit() throws Exception {
 
     public void testFieldAlias() throws IOException {
         XContentBuilder mapping = XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("location")
                         .field("type", "geo_shape")
@@ -666,7 +666,7 @@ public void testFieldAlias() throws IOException {
             .endObject()
         .endObject();
 
-        createIndex("test", Settings.EMPTY, "type", mapping);
+        createIndex("test", Settings.EMPTY, mapping);
 
         ShapeBuilder shape = RandomShapeGenerator.createShape(random(), RandomShapeGenerator.ShapeType.MULTIPOINT);
         client().prepareIndex("test").setId("1")
@@ -682,14 +682,14 @@ public void testFieldAlias() throws IOException {
     // Test for issue #34418
     public void testEnvelopeSpanningDateline() throws IOException {
         XContentBuilder mapping = XContentFactory.jsonBuilder().startObject()
-            .startObject("doc")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("geo").field("type", "geo_shape").endObject()
                 .endObject()
             .endObject()
         .endObject();
 
-        createIndex("test", Settings.builder().put("index.number_of_shards", 1).build(), "doc", mapping);
+        createIndex("test", Settings.builder().put("index.number_of_shards", 1).build(), mapping);
 
         String doc1 = "{\"geo\": {\r\n" + "\"coordinates\": [\r\n" + "-33.918711,\r\n" + "18.847685\r\n" + "],\r\n" +
                 "\"type\": \"Point\"\r\n" + "}}";
@@ -750,14 +750,14 @@ public void testEnvelopeSpanningDateline() throws IOException {
 
     public void testGeometryCollectionRelations() throws IOException {
         XContentBuilder mapping = XContentFactory.jsonBuilder().startObject()
-            .startObject("doc")
+            .startObject("_doc")
             .startObject("properties")
             .startObject("geo").field("type", "geo_shape").endObject()
             .endObject()
             .endObject()
             .endObject();
 
-        createIndex("test", Settings.builder().put("index.number_of_shards", 1).build(), "doc", mapping);
+        createIndex("test", Settings.builder().put("index.number_of_shards", 1).build(), mapping);
 
         EnvelopeBuilder envelopeBuilder = new EnvelopeBuilder(new Coordinate(-10, 10), new Coordinate(10, -10));
 
diff --git a/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java b/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
index 34a9363d5a5b7..697ec825abaea 100644
--- a/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
+++ b/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
@@ -70,8 +70,8 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
 
     public void testSimpleMoreLikeThis() throws Exception {
         logger.info("Creating index test");
-        assertAcked(prepareCreate("test").addMapping("type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("text").field("type", "text").endObject()
                         .endObject().endObject().endObject()));
 
@@ -93,8 +93,8 @@ public void testSimpleMoreLikeThis() throws Exception {
 
     public void testSimpleMoreLikeThisWithTypes() throws Exception {
         logger.info("Creating index test");
-        assertAcked(prepareCreate("test").addMapping("type1",
-            jsonBuilder().startObject().startObject("type1").startObject("properties")
+        assertAcked(prepareCreate("test").setMapping(
+            jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("text").field("type", "text").endObject()
                 .endObject().endObject().endObject()));
 
@@ -118,8 +118,8 @@ public void testSimpleMoreLikeThisWithTypes() throws Exception {
     //Issue #30148
     public void testMoreLikeThisForZeroTokensInOneOfTheAnalyzedFields() throws Exception {
         CreateIndexRequestBuilder createIndexRequestBuilder = prepareCreate("test")
-            .addMapping("type", jsonBuilder()
-            .startObject().startObject("type")
+            .setMapping(jsonBuilder()
+            .startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("myField").field("type", "text").endObject()
                 .startObject("empty").field("type", "text").endObject()
@@ -170,8 +170,8 @@ public void testSimpleMoreLikeOnLongField() throws Exception {
 
     public void testMoreLikeThisWithAliases() throws Exception {
         logger.info("Creating index test");
-        assertAcked(prepareCreate("test").addMapping("type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("text").field("type", "text").endObject()
                         .endObject().endObject().endObject()));
         logger.info("Creating aliases alias release");
@@ -296,8 +296,8 @@ public void testMoreLikeThisIssueRoutingNotSerialized() throws Exception {
     // Issue #3252
     public void testNumericField() throws Exception {
         final String[] numericTypes = new String[]{"byte", "short", "integer", "long"};
-        prepareCreate("test").addMapping("type", jsonBuilder()
-                    .startObject().startObject("type")
+        prepareCreate("test").setMapping(jsonBuilder()
+                    .startObject().startObject("_doc")
                     .startObject("properties")
                         .startObject("int_value").field("type", randomFrom(numericTypes)).endObject()
                         .startObject("string_value").field("type", "text").endObject()
@@ -383,7 +383,7 @@ public void testMoreLikeThisWithFieldAlias() throws Exception {
             .endObject()
         .endObject();
 
-        assertAcked(prepareCreate("test").addMapping("_doc", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
         ensureGreen();
 
         indexDoc("test", "1", "text", "lucene");
@@ -400,8 +400,8 @@ public void testMoreLikeThisWithFieldAlias() throws Exception {
 
     public void testSimpleMoreLikeInclude() throws Exception {
         logger.info("Creating index test");
-        assertAcked(prepareCreate("test").addMapping("type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("text").field("type", "text").endObject()
                         .endObject().endObject().endObject()));
 
@@ -439,8 +439,8 @@ public void testSimpleMoreLikeInclude() throws Exception {
 
     public void testSimpleMoreLikeThisIds() throws Exception {
         logger.info("Creating index test");
-        assertAcked(prepareCreate("test").addMapping("type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("text").field("type", "text").endObject()
                         .endObject().endObject().endObject()));
 
@@ -715,8 +715,8 @@ public void testWithRouting() throws IOException {
     //Issue #29678
     public void testWithMissingRouting() throws IOException {
         logger.info("Creating index test with routing required for type1");
-        assertAcked(prepareCreate("test").addMapping("type1",
-            jsonBuilder().startObject().startObject("type1")
+        assertAcked(prepareCreate("test").setMapping(
+            jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("text").field("type", "text").endObject().endObject()
                 .startObject("_routing").field("required", true).endObject()
             .endObject().endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java b/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
index cca4d4e8e1a57..4658191c6baed 100644
--- a/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
+++ b/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
@@ -166,7 +166,7 @@ public void testSimpleNested() throws Exception {
 
     public void testMultiNested() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("nested1")
                         .field("type", "nested").startObject("properties")
                         .startObject("nested2").field("type", "nested").endObject()
@@ -246,7 +246,7 @@ public void testMultiNested() throws Exception {
     public void testDeleteNestedDocsWithAlias() throws Exception {
         assertAcked(prepareCreate("test")
                 .setSettings(Settings.builder().put(indexSettings()).put("index.refresh_interval", -1).build())
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1")
                         .field("type", "text")
                         .endObject()
@@ -297,7 +297,7 @@ public void testDeleteNestedDocsWithAlias() throws Exception {
 
     public void testExplain() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("nested1")
                         .field("type", "nested")
                         .endObject()
@@ -335,7 +335,7 @@ public void testSimpleNestedSorting() throws Exception {
                 .setSettings(Settings.builder()
                         .put(indexSettings())
                         .put("index.refresh_interval", -1))
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("nested1")
                         .field("type", "nested")
                         .startObject("properties")
@@ -419,7 +419,7 @@ public void testSimpleNestedSortingWithNestedFilterMissing() throws Exception {
                 .setSettings(Settings.builder()
                         .put(indexSettings())
                         .put("index.refresh_interval", -1))
-                .addMapping("type1", jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("nested1")
                         .field("type", "nested")
                             .startObject("properties")
@@ -807,9 +807,9 @@ public void testLeakingSortValues() throws Exception {
 
     public void testSortNestedWithNestedFilter() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                     .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                             .startObject("properties")
                                 .startObject("grand_parent_values")
                                     .field("type", "long")
@@ -1197,7 +1197,7 @@ public void testSortNestedWithNestedFilter() throws Exception {
 
     // Issue #9305
     public void testNestedSortingWithNestedFilterAsFilter() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type", jsonBuilder().startObject().startObject("properties")
+        assertAcked(prepareCreate("test").setMapping(jsonBuilder().startObject().startObject("properties")
                 .startObject("officelocation").field("type", "text").endObject()
                 .startObject("users")
                     .field("type", "nested")
diff --git a/server/src/test/java/org/elasticsearch/search/query/ExistsIT.java b/server/src/test/java/org/elasticsearch/search/query/ExistsIT.java
index c740922fc6c57..1b4aa52398bae 100644
--- a/server/src/test/java/org/elasticsearch/search/query/ExistsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/ExistsIT.java
@@ -58,7 +58,7 @@ public void testEmptyIndex() throws Exception {
     public void testExists() throws Exception {
         XContentBuilder mapping = XContentBuilder.builder(JsonXContent.jsonXContent)
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("foo")
                             .field("type", "text")
@@ -86,7 +86,7 @@ public void testExists() throws Exception {
                 .endObject()
             .endObject();
 
-        assertAcked(client().admin().indices().prepareCreate("idx").addMapping("type", mapping));
+        assertAcked(client().admin().indices().prepareCreate("idx").setMapping(mapping));
         Map<String, Object> barObject = new HashMap<>();
         barObject.put("foo", "bar");
         barObject.put("bar", singletonMap("bar", "foo"));
@@ -149,7 +149,7 @@ public void testExists() throws Exception {
     public void testFieldAlias() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("bar")
                             .field("type", "long")
@@ -169,7 +169,7 @@ public void testFieldAlias() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(prepareCreate("idx").addMapping("type", mapping));
+        assertAcked(prepareCreate("idx").setMapping(mapping));
         ensureGreen("idx");
 
         List<IndexRequestBuilder> indexRequests = new ArrayList<>();
@@ -201,7 +201,7 @@ public void testFieldAlias() throws Exception {
     public void testFieldAliasWithNoDocValues() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("foo")
                             .field("type", "long")
@@ -214,7 +214,7 @@ public void testFieldAliasWithNoDocValues() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(prepareCreate("idx").addMapping("type", mapping));
+        assertAcked(prepareCreate("idx").setMapping(mapping));
         ensureGreen("idx");
 
         List<IndexRequestBuilder> indexRequests = new ArrayList<>();
diff --git a/server/src/test/java/org/elasticsearch/search/query/MultiMatchQueryIT.java b/server/src/test/java/org/elasticsearch/search/query/MultiMatchQueryIT.java
index a15c33832b8df..82d09e83b7980 100644
--- a/server/src/test/java/org/elasticsearch/search/query/MultiMatchQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/MultiMatchQueryIT.java
@@ -92,7 +92,7 @@ public void init() throws Exception {
                 .put("index.analysis.analyzer.category.tokenizer", "standard")
                 .put("index.analysis.analyzer.category.filter", "lowercase")
         );
-        assertAcked(builder.addMapping("test", createMapping()));
+        assertAcked(builder.setMapping(createMapping()));
         ensureGreen();
         int numDocs = scaledRandomIntBetween(50, 100);
         List<IndexRequestBuilder> builders = new ArrayList<>();
@@ -163,7 +163,7 @@ public void init() throws Exception {
     }
 
     private XContentBuilder createMapping() throws IOException {
-        return XContentFactory.jsonBuilder().startObject().startObject("test")
+        return XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("id")
                 .field("type", "keyword")
diff --git a/server/src/test/java/org/elasticsearch/search/query/QueryStringIT.java b/server/src/test/java/org/elasticsearch/search/query/QueryStringIT.java
index 764b434e774e5..c901ab8270433 100644
--- a/server/src/test/java/org/elasticsearch/search/query/QueryStringIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/QueryStringIT.java
@@ -266,7 +266,7 @@ public void testAllFieldsWithSpecifiedLeniency() throws IOException {
     public void testLimitOnExpandedFields() throws Exception {
         XContentBuilder builder = jsonBuilder();
         builder.startObject();
-        builder.startObject("type1");
+        builder.startObject("_doc");
         builder.startObject("properties");
         for (int i = 0; i < CLUSTER_MAX_CLAUSE_COUNT + 1; i++) {
             builder.startObject("field" + i).field("type", "text").endObject();
@@ -278,7 +278,7 @@ public void testLimitOnExpandedFields() throws Exception {
         assertAcked(prepareCreate("toomanyfields")
                 .setSettings(Settings.builder().put(MapperService.INDEX_MAPPING_TOTAL_FIELDS_LIMIT_SETTING.getKey(),
                         CLUSTER_MAX_CLAUSE_COUNT + 100))
-                .addMapping("type1", builder));
+                .setMapping(builder));
 
         client().prepareIndex("toomanyfields").setId("1").setSource("field1", "foo bar baz").get();
         refresh();
diff --git a/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java b/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
index 395302bc4c7bb..0d848cf5dce30 100644
--- a/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
@@ -947,8 +947,8 @@ public void testTermsQuery() throws Exception {
 
     public void testTermsLookupFilter() throws Exception {
         assertAcked(prepareCreate("lookup").addMapping("type", "terms","type=text", "other", "type=text"));
-        assertAcked(prepareCreate("lookup2").addMapping("type",
-                jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertAcked(prepareCreate("lookup2").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("arr").startObject("properties").startObject("term").field("type", "text")
                         .endObject().endObject().endObject().endObject().endObject().endObject()));
         assertAcked(prepareCreate("lookup3").addMapping("type", "_source", "enabled=false", "terms","type=text"));
@@ -1334,7 +1334,7 @@ public void testSpanNot() throws IOException, ExecutionException, InterruptedExc
 
     public void testSimpleDFSQuery() throws IOException {
         assertAcked(prepareCreate("test")
-            .addMapping("_doc", jsonBuilder()
+            .setMapping(jsonBuilder()
                 .startObject()
                 .startObject("_doc")
                 .startObject("_routing")
@@ -1583,7 +1583,7 @@ public void testRangeQueryWithLocaleMapping() throws Exception {
         assert ("SPI,COMPAT".equals(System.getProperty("java.locale.providers"))) : "`-Djava.locale.providers=SPI,COMPAT` needs to be set";
 
         assertAcked(prepareCreate("test")
-            .addMapping("type1", jsonBuilder().startObject().startObject("properties").startObject("date_field")
+            .setMapping(jsonBuilder().startObject().startObject("properties").startObject("date_field")
                     .field("type", "date")
                     .field("format", "E, d MMM yyyy HH:mm:ss Z")
                     .field("locale", "de")
@@ -1693,7 +1693,7 @@ public void testNestedQueryWithFieldAlias() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(prepareCreate("index").addMapping("_doc", mapping));
+        assertAcked(prepareCreate("index").setMapping(mapping));
 
         XContentBuilder source = XContentFactory.jsonBuilder().startObject()
             .startObject("section")
@@ -1714,7 +1714,7 @@ public void testNestedQueryWithFieldAlias() throws Exception {
    public void testFieldAliasesForMetaFields() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("id-alias")
                             .field("type", "alias")
@@ -1727,7 +1727,7 @@ public void testFieldAliasesForMetaFields() throws Exception {
                     .endObject()
             .endObject()
         .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
 
         IndexRequestBuilder indexRequest = client().prepareIndex("test")
             .setId("1")
diff --git a/server/src/test/java/org/elasticsearch/search/query/SimpleQueryStringIT.java b/server/src/test/java/org/elasticsearch/search/query/SimpleQueryStringIT.java
index dde2dc53514a5..d46e7e0f9dfcd 100644
--- a/server/src/test/java/org/elasticsearch/search/query/SimpleQueryStringIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/SimpleQueryStringIT.java
@@ -212,9 +212,9 @@ public void testSimpleQueryStringMinimumShouldMatch() throws Exception {
 
     public void testNestedFieldSimpleQueryString() throws IOException {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                         .startObject("properties")
                         .startObject("body").field("type", "text")
                         .startObject("fields")
@@ -569,7 +569,7 @@ public void testAllFieldsWithSpecifiedLeniency() throws IOException {
     public void testLimitOnExpandedFields() throws Exception {
         XContentBuilder builder = jsonBuilder();
         builder.startObject();
-        builder.startObject("type1");
+        builder.startObject("_doc");
         builder.startObject("properties");
         for (int i = 0; i < CLUSTER_MAX_CLAUSE_COUNT + 1; i++) {
             builder.startObject("field" + i).field("type", "text").endObject();
@@ -581,7 +581,7 @@ public void testLimitOnExpandedFields() throws Exception {
         assertAcked(prepareCreate("toomanyfields")
                 .setSettings(Settings.builder().put(MapperService.INDEX_MAPPING_TOTAL_FIELDS_LIMIT_SETTING.getKey(),
                         CLUSTER_MAX_CLAUSE_COUNT + 100))
-                .addMapping("type1", builder));
+                .setMapping(builder));
 
         client().prepareIndex("toomanyfields").setId("1").setSource("field1", "foo bar baz").get();
         refresh();
diff --git a/server/src/test/java/org/elasticsearch/search/scriptfilter/ScriptQuerySearchIT.java b/server/src/test/java/org/elasticsearch/search/scriptfilter/ScriptQuerySearchIT.java
index e90b77822c5f5..7456706a8b81d 100644
--- a/server/src/test/java/org/elasticsearch/search/scriptfilter/ScriptQuerySearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/scriptfilter/ScriptQuerySearchIT.java
@@ -111,7 +111,7 @@ public void testCustomScriptBinaryField() throws Exception {
 
         assertAcked(
                 client().admin().indices().prepareCreate("my-index")
-                        .addMapping("my-type", createMappingSource("binary"))
+                        .setMapping(createMappingSource("binary"))
                         .setSettings(indexSettings())
         );
         client().prepareIndex("my-index").setId("1")
@@ -146,7 +146,7 @@ private byte[] getRandomBytes(int len) {
     }
 
     private XContentBuilder createMappingSource(String fieldType) throws IOException {
-        return XContentFactory.jsonBuilder().startObject().startObject("my-type")
+        return XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("binaryData")
                 .field("type", fieldType)
diff --git a/server/src/test/java/org/elasticsearch/search/scroll/DuelScrollIT.java b/server/src/test/java/org/elasticsearch/search/scroll/DuelScrollIT.java
index a94b251c00cd7..8424fe4ab80be 100644
--- a/server/src/test/java/org/elasticsearch/search/scroll/DuelScrollIT.java
+++ b/server/src/test/java/org/elasticsearch/search/scroll/DuelScrollIT.java
@@ -101,7 +101,7 @@ public void testDuelQueryThenFetch() throws Exception {
 
 
     private TestContext create(SearchType... searchTypes) throws Exception {
-        assertAcked(prepareCreate("index").addMapping("type", jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertAcked(prepareCreate("index").setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("field1")
                     .field("type", "long")
                 .endObject()
diff --git a/server/src/test/java/org/elasticsearch/search/sort/FieldSortIT.java b/server/src/test/java/org/elasticsearch/search/sort/FieldSortIT.java
index fb4e3c8e828e6..1bb3444d5ea54 100644
--- a/server/src/test/java/org/elasticsearch/search/sort/FieldSortIT.java
+++ b/server/src/test/java/org/elasticsearch/search/sort/FieldSortIT.java
@@ -253,10 +253,10 @@ public void testTrackScores() throws Exception {
     public void testRandomSorting() throws IOException, InterruptedException, ExecutionException {
         Random random = random();
         assertAcked(prepareCreate("test")
-                .addMapping("type",
+                .setMapping(
                         XContentFactory.jsonBuilder()
                                 .startObject()
-                                .startObject("type")
+                                .startObject("_doc")
                                 .startObject("properties")
                                 .startObject("sparse_bytes")
                                 .field("type", "keyword")
@@ -510,8 +510,8 @@ public void testIssue2991() {
     public void testSimpleSorts() throws Exception {
         Random random = random();
         assertAcked(prepareCreate("test")
-.addMapping("type1",
-                XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("str_value")
+            .setMapping(
+                XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("str_value")
                         .field("type", "keyword").endObject().startObject("boolean_value").field("type", "boolean").endObject()
                         .startObject("byte_value").field("type", "byte").endObject().startObject("short_value").field("type", "short")
                         .endObject().startObject("integer_value").field("type", "integer").endObject().startObject("long_value")
@@ -722,10 +722,10 @@ public void testSimpleSorts() throws Exception {
     }
 
     public void testSortMissingNumbers() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1",
+        assertAcked(prepareCreate("test").setMapping(
                 XContentFactory.jsonBuilder()
                         .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                         .startObject("properties")
                             .startObject("i_value")
                                 .field("type", "integer")
@@ -794,10 +794,10 @@ public void testSortMissingNumbers() throws Exception {
     }
 
     public void testSortMissingStrings() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1",
+        assertAcked(prepareCreate("test").setMapping(
                 XContentFactory.jsonBuilder()
                         .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                         .startObject("properties")
                         .startObject("value")
                         .field("type", "keyword")
@@ -927,8 +927,8 @@ public void testIgnoreUnmapped() throws Exception {
 
     public void testSortMVField() throws Exception {
         assertAcked(prepareCreate("test")
-                        .addMapping("type1",
-                XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("long_values")
+                        .setMapping(
+                XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("long_values")
                         .field("type", "long").endObject().startObject("int_values").field("type", "integer").endObject()
                         .startObject("short_values").field("type", "short").endObject().startObject("byte_values")
                         .field("type", "byte").endObject().startObject("float_values").field("type", "float").endObject()
@@ -1275,8 +1275,8 @@ public void testSortMVField() throws Exception {
     }
 
     public void testSortOnRareField() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1",
-                XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("string_values")
+        assertAcked(prepareCreate("test").setMapping(
+                XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("string_values")
                         .field("type", "keyword").endObject().endObject().endObject().endObject()));
         ensureGreen();
         client().prepareIndex("test").setId(Integer.toString(1)).setSource(jsonBuilder().startObject()
@@ -1419,10 +1419,10 @@ public void testSortMetaField() throws Exception {
      */
     public void testNestedSort() throws IOException, InterruptedException, ExecutionException {
         assertAcked(prepareCreate("test")
-                .addMapping("type",
+                .setMapping(
                         XContentFactory.jsonBuilder()
                                 .startObject()
-                                    .startObject("type")
+                                    .startObject("_doc")
                                         .startObject("properties")
                                             .startObject("nested")
                                                 .field("type", "nested")
diff --git a/server/src/test/java/org/elasticsearch/search/sort/GeoDistanceIT.java b/server/src/test/java/org/elasticsearch/search/sort/GeoDistanceIT.java
index 7968dbb93114e..262940af43aba 100644
--- a/server/src/test/java/org/elasticsearch/search/sort/GeoDistanceIT.java
+++ b/server/src/test/java/org/elasticsearch/search/sort/GeoDistanceIT.java
@@ -57,10 +57,10 @@ protected boolean forbidPrivateIndexSettings() {
     public void testDistanceSortingMVFields() throws Exception {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("locations").field("type", "geo_point");
         xContentBuilder.field("ignore_malformed", true).endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").setSettings(settings).addMapping("type1", xContentBuilder));
+        assertAcked(prepareCreate("test").setSettings(settings).setMapping(xContentBuilder));
         ensureGreen();
 
         client().prepareIndex("test").setId("1").setSource(jsonBuilder().startObject().field("names", "New York")
@@ -183,10 +183,10 @@ public void testDistanceSortingMVFields() throws Exception {
     public void testDistanceSortingWithMissingGeoPoint() throws Exception {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("locations").field("type", "geo_point");
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test").setSettings(settings).addMapping("type1", xContentBuilder));
+        assertAcked(prepareCreate("test").setSettings(settings).setMapping(xContentBuilder));
         ensureGreen();
 
         client().prepareIndex("test").setId("1")
@@ -225,13 +225,13 @@ public void testDistanceSortingWithMissingGeoPoint() throws Exception {
     public void testDistanceSortingNestedFields() throws Exception {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("company").startObject("properties")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("name").field("type", "text").endObject().startObject("branches").field("type", "nested")
                 .startObject("properties").startObject("name").field("type", "text").endObject().startObject("location")
                 .field("type", "geo_point");
         xContentBuilder.endObject().endObject().endObject().endObject().endObject().endObject();
 
-        assertAcked(prepareCreate("companies").setSettings(settings).addMapping("company", xContentBuilder));
+        assertAcked(prepareCreate("companies").setSettings(settings).setMapping(xContentBuilder));
         ensureGreen();
 
         indexRandom(true,
@@ -384,13 +384,13 @@ public void testGeoDistanceFilter() throws IOException {
         double lat = 40.720611;
         double lon = -73.998776;
 
-        XContentBuilder mapping = JsonXContent.contentBuilder().startObject().startObject("location").startObject("properties")
+        XContentBuilder mapping = JsonXContent.contentBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("pin").field("type", "geo_point");
         mapping.endObject().endObject().endObject().endObject();
 
         XContentBuilder source = JsonXContent.contentBuilder().startObject().field("pin", Geohash.stringEncode(lon, lat)).endObject();
 
-        assertAcked(prepareCreate("locations").setSettings(settings).addMapping("location", mapping));
+        assertAcked(prepareCreate("locations").setSettings(settings).setMapping(mapping));
         client().prepareIndex("locations").setId("1").setCreate(true).setSource(source).get();
         refresh();
         client().prepareGet("locations", "1").get();
@@ -402,10 +402,10 @@ public void testGeoDistanceFilter() throws IOException {
     }
 
     public void testDistanceSortingWithUnmappedField() throws Exception {
-        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+        XContentBuilder xContentBuilder = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
             .startObject("locations").field("type", "geo_point");
         xContentBuilder.endObject().endObject().endObject().endObject();
-        assertAcked(prepareCreate("test1").addMapping("type1", xContentBuilder));
+        assertAcked(prepareCreate("test1").setMapping(xContentBuilder));
         assertAcked(prepareCreate("test2"));
         ensureGreen();
 
diff --git a/server/src/test/java/org/elasticsearch/search/sort/SimpleSortIT.java b/server/src/test/java/org/elasticsearch/search/sort/SimpleSortIT.java
index 237235a0a230e..7b439bf44f947 100644
--- a/server/src/test/java/org/elasticsearch/search/sort/SimpleSortIT.java
+++ b/server/src/test/java/org/elasticsearch/search/sort/SimpleSortIT.java
@@ -118,9 +118,9 @@ static <T extends Comparable<T>> T getMinValueScript(Map<String, Object> vars, T
     public void testSimpleSorts() throws Exception {
         Random random = random();
         assertAcked(prepareCreate("test")
-                .addMapping("type1", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                            .startObject("type1")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("str_value")
                                         .field("type", "keyword")
@@ -445,9 +445,9 @@ public void testDocumentsWithNullValue() throws Exception {
 
     public void test2920() throws IOException {
         assertAcked(prepareCreate("test")
-                .addMapping("test", jsonBuilder()
+                .setMapping(jsonBuilder()
                         .startObject()
-                            .startObject("test")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("value")
                                         .field("type", "keyword")
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/CompletionSuggestSearchIT.java b/server/src/test/java/org/elasticsearch/search/suggest/CompletionSuggestSearchIT.java
index 10372f9354a0d..27d57532b06a2 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/CompletionSuggestSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/CompletionSuggestSearchIT.java
@@ -84,7 +84,6 @@
 @SuppressCodecs("*") // requires custom completion format
 public class CompletionSuggestSearchIT extends ESIntegTestCase {
     private final String INDEX = RandomStrings.randomAsciiOfLength(random(), 10).toLowerCase(Locale.ROOT);
-    private final String TYPE = "_doc";
     private final String FIELD = RandomStrings.randomAsciiOfLength(random(), 10).toLowerCase(Locale.ROOT);
     private final CompletionMappingBuilder completionMappingBuilder = new CompletionMappingBuilder();
 
@@ -570,7 +569,7 @@ public void testThatDisablingPositionIncrementsWorkForStopwords() throws Excepti
     public void testThatUpgradeToMultiFieldsWorks() throws Exception {
         final XContentBuilder mapping = jsonBuilder()
                 .startObject()
-                .startObject(TYPE)
+                .startObject("_doc")
                 .startObject("properties")
                 .startObject(FIELD)
                 .field("type", "text")
@@ -578,7 +577,7 @@ public void testThatUpgradeToMultiFieldsWorks() throws Exception {
                 .endObject()
                 .endObject()
                 .endObject();
-        assertAcked(prepareCreate(INDEX).addMapping(TYPE, mapping));
+        assertAcked(prepareCreate(INDEX).setMapping(mapping));
         client().prepareIndex(INDEX).setId("1").setRefreshPolicy(IMMEDIATE)
                 .setSource(jsonBuilder().startObject().field(FIELD, "Foo Fighters").endObject()).get();
         ensureGreen(INDEX);
@@ -1009,7 +1008,7 @@ private static List<String> getNames(Suggest.Suggestion.Entry<Suggest.Suggestion
 
     private void createIndexAndMappingAndSettings(Settings settings, CompletionMappingBuilder completionMappingBuilder) throws IOException {
         XContentBuilder mapping = jsonBuilder().startObject()
-                .startObject(TYPE).startObject("properties")
+                .startObject("_doc").startObject("properties")
                 .startObject("test_field")
                     .field("type", "keyword")
                 .endObject()
@@ -1051,7 +1050,7 @@ private void createIndexAndMappingAndSettings(Settings settings, CompletionMappi
 
         assertAcked(client().admin().indices().prepareCreate(INDEX)
                 .setSettings(Settings.builder().put(indexSettings()).put(settings))
-                .addMapping(TYPE, mapping)
+                .setMapping(mapping)
                 .get());
     }
 
@@ -1100,8 +1099,8 @@ public void testPrunedSegments() throws IOException {
 
     // see #3596
     public void testVeryLongInput() throws IOException {
-        assertAcked(client().admin().indices().prepareCreate(INDEX).addMapping(TYPE, jsonBuilder().startObject()
-                .startObject(TYPE).startObject("properties")
+        assertAcked(client().admin().indices().prepareCreate(INDEX).setMapping(jsonBuilder().startObject()
+                .startObject("_doc").startObject("properties")
                 .startObject(FIELD)
                 .field("type", "completion")
                 .endObject()
@@ -1119,8 +1118,8 @@ public void testVeryLongInput() throws IOException {
 
     // see #3648
     public void testReservedChars() throws IOException {
-        assertAcked(client().admin().indices().prepareCreate(INDEX).addMapping(TYPE, jsonBuilder().startObject()
-                .startObject(TYPE).startObject("properties")
+        assertAcked(client().admin().indices().prepareCreate(INDEX).setMapping(jsonBuilder().startObject()
+                .startObject("_doc").startObject("properties")
                 .startObject(FIELD)
                 .field("type", "completion")
                 .endObject()
@@ -1138,8 +1137,8 @@ public void testReservedChars() throws IOException {
 
     // see #5930
     public void testIssue5930() throws IOException {
-        assertAcked(client().admin().indices().prepareCreate(INDEX).addMapping(TYPE, jsonBuilder().startObject()
-                .startObject(TYPE).startObject("properties")
+        assertAcked(client().admin().indices().prepareCreate(INDEX).setMapping(jsonBuilder().startObject()
+                .startObject("_doc").startObject("properties")
                 .startObject(FIELD)
                 .field("type", "completion")
                 .endObject()
@@ -1182,7 +1181,7 @@ public void testMultiDocSuggestions() throws Exception {
     public void testSuggestWithFieldAlias() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject(TYPE)
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject(FIELD)
                             .field("type", "completion")
@@ -1194,7 +1193,7 @@ public void testSuggestWithFieldAlias() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(prepareCreate(INDEX).addMapping(TYPE, mapping));
+        assertAcked(prepareCreate(INDEX).setMapping(mapping));
 
         List<IndexRequestBuilder> builders = new ArrayList<>();
         builders.add(client().prepareIndex(INDEX).setSource(FIELD, "apple"));
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/ContextCompletionSuggestSearchIT.java b/server/src/test/java/org/elasticsearch/search/suggest/ContextCompletionSuggestSearchIT.java
index 69af26bf27abb..dab237c754b48 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/ContextCompletionSuggestSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/ContextCompletionSuggestSearchIT.java
@@ -58,7 +58,6 @@
 public class ContextCompletionSuggestSearchIT extends ESIntegTestCase {
 
     private final String INDEX = RandomStrings.randomAsciiOfLength(random(), 10).toLowerCase(Locale.ROOT);
-    private final String TYPE = RandomStrings.randomAsciiOfLength(random(), 10).toLowerCase(Locale.ROOT);
     private final String FIELD = RandomStrings.randomAsciiOfLength(random(), 10).toLowerCase(Locale.ROOT);
 
     @Override
@@ -500,7 +499,7 @@ public void testGeoNeighbours() throws Exception {
     public void testGeoField() throws Exception {
         XContentBuilder mapping = jsonBuilder();
         mapping.startObject();
-        mapping.startObject(TYPE);
+        mapping.startObject("_doc");
         mapping.startObject("properties");
         mapping.startObject("location");
         mapping.startObject("properties");
@@ -534,7 +533,7 @@ public void testGeoField() throws Exception {
         mapping.endObject();
         mapping.endObject();
 
-        assertAcked(prepareCreate(INDEX).addMapping(TYPE, mapping));
+        assertAcked(prepareCreate(INDEX).setMapping(mapping));
 
         XContentBuilder source1 = jsonBuilder()
                 .startObject()
@@ -624,7 +623,7 @@ private void createIndexAndMapping(CompletionMappingBuilder completionMappingBui
 
     private void createIndexAndMappingAndSettings(Settings settings, CompletionMappingBuilder completionMappingBuilder) throws IOException {
         XContentBuilder mapping = jsonBuilder().startObject()
-                .startObject(TYPE).startObject("properties")
+                .startObject("_doc").startObject("properties")
                 .startObject(FIELD)
                 .field("type", "completion")
                 .field("analyzer", completionMappingBuilder.indexAnalyzer)
@@ -671,7 +670,7 @@ private void createIndexAndMappingAndSettings(Settings settings, CompletionMappi
 
         assertAcked(client().admin().indices().prepareCreate(INDEX)
                 .setSettings(Settings.builder().put(indexSettings()).put(settings))
-                .addMapping(TYPE, mapping)
+                .setMapping(mapping)
                 .get());
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
index fc2826258a47a..f746484e26693 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
@@ -114,12 +114,12 @@ public void testSuggestAcrossMultipleIndices() throws IOException {
         searchSuggest("test", termSuggest);
 
 
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("text").field("type", "text").field("analyzer", "keyword").endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(prepareCreate("test_2").addMapping("type1", mapping));
+        assertAcked(prepareCreate("test_2").setMapping(mapping));
         ensureGreen();
 
         indexDoc("test_2", "1", "text", "ab cd");
@@ -180,7 +180,7 @@ public void testSuggestModes() throws IOException {
                 .put("index.analysis.filter.shingler.min_shingle_size", 2)
                 .put("index.analysis.filter.shingler.max_shingle_size", 3));
 
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("name")
                     .field("type", "text")
@@ -194,7 +194,7 @@ public void testSuggestModes() throws IOException {
                 .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(builder.addMapping("type1", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
 
@@ -259,7 +259,7 @@ public void testUnmappedField() throws IOException, InterruptedException, Execut
                 .put("index.analysis.filter.shingler.type", "shingle")
                 .put("index.analysis.filter.shingler.min_shingle_size", 2)
                 .put("index.analysis.filter.shingler.max_shingle_size", 3));
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("name")
                     .field("type", "text")
@@ -273,7 +273,7 @@ public void testUnmappedField() throws IOException, InterruptedException, Execut
                 .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(builder.addMapping("type1", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
         indexRandom(true, client().prepareIndex("test").setSource("name", "I like iced tea"),
@@ -481,13 +481,13 @@ public void testPrefixLength() throws IOException {
                 .put("index.analysis.filter.my_shingle.output_unigrams", false)
                 .put("index.analysis.filter.my_shingle.min_shingle_size", 2)
                 .put("index.analysis.filter.my_shingle.max_shingle_size", 2));
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                 .startObject("body").field("type", "text").field("analyzer", "body").endObject()
                 .startObject("bigram").field("type", "text").field("analyzer", "bigram").endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(builder.addMapping("type1", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
         indexDoc("test", "1", "body", "hello world");
@@ -520,7 +520,7 @@ public void testBasicPhraseSuggest() throws IOException, URISyntaxException {
                 .put("index.analysis.filter.my_shingle.min_shingle_size", 2)
                 .put("index.analysis.filter.my_shingle.max_shingle_size", 2)
                 .put("index.number_of_shards", 1));
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                     .startObject("properties")
                         .startObject("body").
                             field("type", "text").
@@ -532,7 +532,7 @@ public void testBasicPhraseSuggest() throws IOException, URISyntaxException {
                          .endObject()
                      .endObject()
                 .endObject().endObject();
-        assertAcked(builder.addMapping("type1", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
         String[] strings = new String[]{
@@ -655,7 +655,7 @@ public void testSizeParam() throws IOException {
 
         XContentBuilder mapping = XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("type1")
+                    .startObject("_doc")
                         .startObject("properties")
                             .startObject("body")
                                 .field("type", "text")
@@ -668,7 +668,7 @@ public void testSizeParam() throws IOException {
                      .endObject()
                  .endObject()
              .endObject();
-        assertAcked(builder.addMapping("type1", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
         String line = "xorr the god jewel";
@@ -722,7 +722,7 @@ public void testShardFailures() throws IOException, InterruptedException {
                 .put("index.analysis.filter.shingler.max_shingle_size", 5)
                 .put("index.analysis.filter.shingler.output_unigrams", true));
 
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type2")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("name")
                         .field("type", "text")
@@ -730,7 +730,7 @@ public void testShardFailures() throws IOException, InterruptedException {
                     .endObject()
                 .endObject()
                 .endObject().endObject();
-        assertAcked(builder.addMapping("type2", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
         indexDoc("test", "1", "foo", "bar");
@@ -764,7 +764,7 @@ public void testShardFailures() throws IOException, InterruptedException {
     public void testEmptyShards() throws IOException, InterruptedException {
         XContentBuilder mappingBuilder = XContentFactory.jsonBuilder().
                 startObject().
-                    startObject("type1").
+                    startObject("_doc").
                         startObject("properties").
                             startObject("name").
                                 field("type", "text").
@@ -782,7 +782,7 @@ public void testEmptyShards() throws IOException, InterruptedException {
                 .put("index.analysis.filter.shingler.type", "shingle")
                 .put("index.analysis.filter.shingler.min_shingle_size", 2)
                 .put("index.analysis.filter.shingler.max_shingle_size", 5)
-                .put("index.analysis.filter.shingler.output_unigrams", true)).addMapping("type1", mappingBuilder));
+                .put("index.analysis.filter.shingler.output_unigrams", true)).setMapping(mappingBuilder));
         ensureGreen();
 
         // test phrase suggestion on completely empty index
@@ -854,7 +854,7 @@ public void testSearchForRarePhrase() throws IOException {
 
         XContentBuilder mapping = XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("type1")
+                    .startObject("_doc")
                         .startObject("properties")
                             .startObject("body")
                                 .field("type", "text")
@@ -863,7 +863,7 @@ public void testSearchForRarePhrase() throws IOException {
                         .endObject()
                     .endObject()
                 .endObject();
-        assertAcked(builder.addMapping("type1", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
         NumShards test = getNumShards("test");
@@ -909,7 +909,7 @@ public void testSuggestWithManyCandidates() throws InterruptedException, Executi
 
         XContentBuilder mapping = XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("type1")
+                    .startObject("_doc")
                         .startObject("properties")
                             .startObject("title")
                                 .field("type", "text")
@@ -918,7 +918,7 @@ public void testSuggestWithManyCandidates() throws InterruptedException, Executi
                         .endObject()
                     .endObject()
                 .endObject();
-        assertAcked(builder.addMapping("type1", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
         List<String> titles = new ArrayList<>();
@@ -1041,7 +1041,7 @@ public void testSuggestWithManyCandidates() throws InterruptedException, Executi
     public void testSuggestWithFieldAlias() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("text")
                             .field("type", "keyword")
@@ -1053,7 +1053,7 @@ public void testSuggestWithFieldAlias() throws Exception {
                     .endObject()
                 .endObject()
             .endObject();
-        assertAcked(prepareCreate("test").addMapping("type", mapping));
+        assertAcked(prepareCreate("test").setMapping(mapping));
 
         List<IndexRequestBuilder> builders = new ArrayList<>();
         builders.add(client().prepareIndex("test").setSource("text", "apple"));
@@ -1070,7 +1070,7 @@ public void testSuggestWithFieldAlias() throws Exception {
     public void testPhraseSuggestMinDocFreq() throws Exception {
         XContentBuilder mapping = XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("text")
                             .field("type", "keyword")
@@ -1080,7 +1080,7 @@ public void testPhraseSuggestMinDocFreq() throws Exception {
             .endObject();
         assertAcked(prepareCreate("test")
             .setSettings(Settings.builder().put("index.number_of_shards", 1).build())
-            .addMapping("type", mapping));
+            .setMapping(mapping));
 
         List<IndexRequestBuilder> builders = new ArrayList<>();
         builders.add(client().prepareIndex("test").setSource("text", "apple"));
@@ -1181,7 +1181,7 @@ public void testPhraseSuggesterCollate() throws InterruptedException, ExecutionE
 
         XContentBuilder mapping = XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type1")
+                .startObject("_doc")
                 .startObject("properties")
                 .startObject("title")
                 .field("type", "text")
@@ -1190,7 +1190,7 @@ public void testPhraseSuggesterCollate() throws InterruptedException, ExecutionE
                 .endObject()
                 .endObject()
                 .endObject();
-        assertAcked(builder.addMapping("type1", mapping));
+        assertAcked(builder.setMapping(mapping));
         ensureGreen();
 
         List<String> titles = new ArrayList<>();
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/completion/CategoryContextMappingTests.java b/server/src/test/java/org/elasticsearch/search/suggest/completion/CategoryContextMappingTests.java
index 628f58e92548f..fa15fbcbc5e9b 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/completion/CategoryContextMappingTests.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/completion/CategoryContextMappingTests.java
@@ -701,7 +701,7 @@ public void testQueryContextParsingMixedHavingNULL() throws Exception {
     }
 
     public void testUnknownQueryContextParsing() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("completion")
                 .field("type", "completion")
                 .startArray("contexts")
@@ -717,7 +717,7 @@ public void testUnknownQueryContextParsing() throws Exception {
                 .endObject().endObject()
                 .endObject().endObject();
 
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type1", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping).mapperService();
         CompletionFieldType completionFieldType = (CompletionFieldType) mapperService.fullName("completion");
 
         Exception e = expectThrows(IllegalArgumentException.class, () -> completionFieldType.getContextMappings().get("brand"));
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/completion/GeoContextMappingTests.java b/server/src/test/java/org/elasticsearch/search/suggest/completion/GeoContextMappingTests.java
index eb5628425daea..3f156b9a3c97a 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/completion/GeoContextMappingTests.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/completion/GeoContextMappingTests.java
@@ -49,7 +49,7 @@
 public class GeoContextMappingTests extends ESSingleNodeTestCase {
 
     public void testIndexingWithNoContexts() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("completion")
                 .field("type", "completion")
                 .startArray("contexts")
@@ -61,7 +61,7 @@ public void testIndexingWithNoContexts() throws Exception {
                 .endObject().endObject()
                 .endObject().endObject();
 
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type1", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping).mapperService();
         MappedFieldType completionFieldType = mapperService.fullName("completion");
         ParsedDocument parsedDocument = mapperService.documentMapper().parse(new SourceToParse("test", "1",
             BytesReference.bytes(jsonBuilder()
@@ -87,7 +87,7 @@ public void testIndexingWithNoContexts() throws Exception {
     }
 
     public void testIndexingWithSimpleContexts() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("completion")
                 .field("type", "completion")
                 .startArray("contexts")
@@ -100,7 +100,7 @@ public void testIndexingWithSimpleContexts() throws Exception {
                 .endObject()
                 .endObject().endObject();
 
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type1", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping).mapperService();
         MappedFieldType completionFieldType = mapperService.fullName("completion");
         ParsedDocument parsedDocument = mapperService.documentMapper().parse(new SourceToParse("test", "1",
             BytesReference.bytes(jsonBuilder()
@@ -124,7 +124,7 @@ public void testIndexingWithSimpleContexts() throws Exception {
     }
 
     public void testIndexingWithContextList() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("completion")
                 .field("type", "completion")
                 .startArray("contexts")
@@ -136,7 +136,7 @@ public void testIndexingWithContextList() throws Exception {
                 .endObject().endObject()
                 .endObject().endObject();
 
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type1", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping).mapperService();
         MappedFieldType completionFieldType = mapperService.fullName("completion");
         ParsedDocument parsedDocument = mapperService.documentMapper().parse(new SourceToParse("test", "1",
             BytesReference.bytes(jsonBuilder()
@@ -164,7 +164,7 @@ public void testIndexingWithContextList() throws Exception {
     }
 
     public void testIndexingWithMultipleContexts() throws Exception {
-        XContentBuilder mapping = jsonBuilder().startObject().startObject("type1")
+        XContentBuilder mapping = jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("completion")
                 .field("type", "completion")
                 .startArray("contexts")
@@ -180,7 +180,7 @@ public void testIndexingWithMultipleContexts() throws Exception {
                 .endObject().endObject()
                 .endObject().endObject();
 
-        MapperService mapperService = createIndex("test", Settings.EMPTY, "type1", mapping).mapperService();
+        MapperService mapperService = createIndex("test", Settings.EMPTY, mapping).mapperService();
         MappedFieldType completionFieldType = mapperService.fullName("completion");
         XContentBuilder builder = jsonBuilder()
                 .startObject()
@@ -204,7 +204,7 @@ public void testIndexingWithMultipleContexts() throws Exception {
     public void testMalformedGeoField() throws Exception {
         XContentBuilder mapping = jsonBuilder();
         mapping.startObject();
-        mapping.startObject("type1");
+        mapping.startObject("_doc");
         mapping.startObject("properties");
         mapping.startObject("pin");
         String type = randomFrom("text", "keyword", "long");
@@ -230,7 +230,7 @@ public void testMalformedGeoField() throws Exception {
         mapping.endObject();
 
         ElasticsearchParseException ex = expectThrows(ElasticsearchParseException.class,
-            () ->  createIndex("test", Settings.EMPTY, "type1", mapping));
+            () ->  createIndex("test", Settings.EMPTY, mapping));
 
         assertThat(ex.getMessage(), equalTo("field [pin] referenced in context [st] must be mapped to geo_point, found [" + type + "]"));
     }
@@ -238,7 +238,7 @@ public void testMalformedGeoField() throws Exception {
     public void testMissingGeoField() throws Exception {
         XContentBuilder mapping = jsonBuilder();
         mapping.startObject();
-        mapping.startObject("type1");
+        mapping.startObject("_doc");
         mapping.startObject("properties");
         mapping.startObject("suggestion");
         mapping.field("type", "completion");
@@ -260,7 +260,7 @@ public void testMissingGeoField() throws Exception {
         mapping.endObject();
 
         ElasticsearchParseException ex = expectThrows(ElasticsearchParseException.class,
-            () ->  createIndex("test", Settings.EMPTY, "type1", mapping));
+            () ->  createIndex("test", Settings.EMPTY, mapping));
 
         assertThat(ex.getMessage(), equalTo("field [pin] referenced in context [st] is not defined in the mapping"));
     }
diff --git a/server/src/test/java/org/elasticsearch/similarity/SimilarityIT.java b/server/src/test/java/org/elasticsearch/similarity/SimilarityIT.java
index ba98f9708aecc..085d3d525dde4 100644
--- a/server/src/test/java/org/elasticsearch/similarity/SimilarityIT.java
+++ b/server/src/test/java/org/elasticsearch/similarity/SimilarityIT.java
@@ -38,8 +38,8 @@ public void testCustomBM25Similarity() throws Exception {
         }
 
         client().admin().indices().prepareCreate("test")
-                .addMapping("type1", jsonBuilder().startObject()
-                        .startObject("type1")
+                .setMapping(jsonBuilder().startObject()
+                        .startObject("_doc")
                             .startObject("properties")
                                 .startObject("field1")
                                     .field("similarity", "custom")
diff --git a/test/framework/src/main/java/org/elasticsearch/index/RandomCreateIndexGenerator.java b/test/framework/src/main/java/org/elasticsearch/index/RandomCreateIndexGenerator.java
index 9732504cac6d4..7f32973db04d2 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/RandomCreateIndexGenerator.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/RandomCreateIndexGenerator.java
@@ -25,6 +25,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.index.mapper.MapperService;
 
 import java.io.IOException;
 
@@ -50,8 +51,7 @@ public static CreateIndexRequest randomCreateIndexRequest() throws IOException {
         CreateIndexRequest request = new CreateIndexRequest(index);
         randomAliases(request);
         if (randomBoolean()) {
-            String type = randomAlphaOfLength(5);
-            request.mapping(type, randomMapping(type));
+            request.mapping(randomMapping(MapperService.SINGLE_MAPPING_NAME));
         }
         if (randomBoolean()) {
             request.settings(randomIndexSettings());
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
index a167419b9db3d..c60ee7f5da31c 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
@@ -267,16 +267,16 @@ protected IndexService createIndex(String index) {
      * Create a new index on the singleton node with the provided index settings.
      */
     protected IndexService createIndex(String index, Settings settings) {
-        return createIndex(index, settings, null, (XContentBuilder) null);
+        return createIndex(index, settings, null);
     }
 
     /**
      * Create a new index on the singleton node with the provided index settings.
      */
-    protected IndexService createIndex(String index, Settings settings, String type, XContentBuilder mappings) {
+    protected IndexService createIndex(String index, Settings settings, XContentBuilder mappings) {
         CreateIndexRequestBuilder createIndexRequestBuilder = client().admin().indices().prepareCreate(index).setSettings(settings);
-        if (type != null && mappings != null) {
-            createIndexRequestBuilder.addMapping(type, mappings);
+        if (mappings != null) {
+            createIndexRequestBuilder.setMapping(mappings);
         }
         return createIndex(index, createIndexRequestBuilder);
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/annotations/AnnotationIndex.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/annotations/AnnotationIndex.java
index ad72c82c8c3ee..4e2e735f9496a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/annotations/AnnotationIndex.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/annotations/AnnotationIndex.java
@@ -73,7 +73,7 @@ public static void createAnnotationsIndexIfNecessary(Settings settings, Client c
 
                 CreateIndexRequest createIndexRequest = new CreateIndexRequest(INDEX_NAME);
                 try (XContentBuilder annotationsMapping = AnnotationIndex.annotationsMapping()) {
-                    createIndexRequest.mapping(SINGLE_MAPPING_NAME, annotationsMapping);
+                    createIndexRequest.mapping(annotationsMapping);
                     createIndexRequest.settings(Settings.builder()
                         .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-1")
                         .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, "1")
diff --git a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/EnrichPolicyRunner.java b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/EnrichPolicyRunner.java
index 4401acae20a02..fc9bdbc79bdeb 100644
--- a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/EnrichPolicyRunner.java
+++ b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/EnrichPolicyRunner.java
@@ -295,7 +295,7 @@ private void prepareAndCreateEnrichIndex() {
             .put("index.warmer.enabled", false)
             .build();
         CreateIndexRequest createEnrichIndexRequest = new CreateIndexRequest(enrichIndexName, enrichIndexSettings);
-        createEnrichIndexRequest.mapping(MapperService.SINGLE_MAPPING_NAME, resolveEnrichMapping(policy));
+        createEnrichIndexRequest.mapping(resolveEnrichMapping(policy));
         logger.debug("Policy [{}]: Creating new enrich index [{}]", policyName, enrichIndexName);
         client.admin().indices().create(createEnrichIndexRequest, new ActionListener<>() {
             @Override
diff --git a/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/EnrichPolicyMaintenanceServiceTests.java b/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/EnrichPolicyMaintenanceServiceTests.java
index 2cff9124696bb..c26243fb9e40e 100644
--- a/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/EnrichPolicyMaintenanceServiceTests.java
+++ b/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/EnrichPolicyMaintenanceServiceTests.java
@@ -5,19 +5,6 @@
  */
 package org.elasticsearch.xpack.enrich;
 
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.HashSet;
-import java.util.List;
-import java.util.Locale;
-import java.util.Set;
-import java.util.concurrent.CountDownLatch;
-import java.util.concurrent.Phaser;
-import java.util.concurrent.atomic.AtomicReference;
-import java.util.function.BiConsumer;
-import java.util.function.Consumer;
-
 import org.elasticsearch.action.admin.indices.alias.IndicesAliasesRequest;
 import org.elasticsearch.action.admin.indices.alias.get.GetAliasesRequest;
 import org.elasticsearch.action.admin.indices.alias.get.GetAliasesResponse;
@@ -35,6 +22,19 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.enrich.EnrichPolicy;
 
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Set;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.Phaser;
+import java.util.concurrent.atomic.AtomicReference;
+import java.util.function.BiConsumer;
+import java.util.function.Consumer;
+
 import static org.elasticsearch.xpack.core.enrich.EnrichPolicy.MATCH_TYPE;
 import static org.elasticsearch.xpack.enrich.AbstractEnrichTestCase.createSourceIndices;
 import static org.hamcrest.CoreMatchers.equalTo;
@@ -163,7 +163,7 @@ private String fakeRunPolicy(String forPolicy) throws IOException {
         }
         source.endObject();
         String newIndexName = EnrichPolicy.getBaseName(forPolicy) + "-" + indexNameAutoIncrementingCounter++;
-        CreateIndexRequest request = new CreateIndexRequest(newIndexName).mapping(MapperService.SINGLE_MAPPING_NAME, source);
+        CreateIndexRequest request = new CreateIndexRequest(newIndexName).mapping(source);
         client().admin().indices().create(request).actionGet();
         promoteFakePolicyIndex(newIndexName, forPolicy);
         return newIndexName;
diff --git a/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/EnrichPolicyRunnerTests.java b/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/EnrichPolicyRunnerTests.java
index 91350cd03798c..a4c2bd5ce60f8 100644
--- a/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/EnrichPolicyRunnerTests.java
+++ b/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/EnrichPolicyRunnerTests.java
@@ -661,7 +661,7 @@ public void testRunnerKeyNestedSourceMapping() throws Exception {
             .endObject();
         CreateIndexResponse createResponse = client().admin()
             .indices()
-            .create(new CreateIndexRequest(sourceIndex).mapping(MapperService.SINGLE_MAPPING_NAME, mappingBuilder))
+            .create(new CreateIndexRequest(sourceIndex).mapping(mappingBuilder))
             .actionGet();
         assertTrue(createResponse.isAcknowledged());
 
@@ -724,7 +724,7 @@ public void testRunnerValueNestedSourceMapping() throws Exception {
             .endObject();
         CreateIndexResponse createResponse = client().admin()
             .indices()
-            .create(new CreateIndexRequest(sourceIndex).mapping(MapperService.SINGLE_MAPPING_NAME, mappingBuilder))
+            .create(new CreateIndexRequest(sourceIndex).mapping(mappingBuilder))
             .actionGet();
         assertTrue(createResponse.isAcknowledged());
 
@@ -790,7 +790,7 @@ public void testRunnerObjectSourceMapping() throws Exception {
             .endObject();
         CreateIndexResponse createResponse = client().admin()
             .indices()
-            .create(new CreateIndexRequest(sourceIndex).mapping(MapperService.SINGLE_MAPPING_NAME, mappingBuilder))
+            .create(new CreateIndexRequest(sourceIndex).mapping(mappingBuilder))
             .actionGet();
         assertTrue(createResponse.isAcknowledged());
 
@@ -908,7 +908,7 @@ public void testRunnerExplicitObjectSourceMapping() throws Exception {
             .endObject();
         CreateIndexResponse createResponse = client().admin()
             .indices()
-            .create(new CreateIndexRequest(sourceIndex).mapping(MapperService.SINGLE_MAPPING_NAME, mappingBuilder))
+            .create(new CreateIndexRequest(sourceIndex).mapping(mappingBuilder))
             .actionGet();
         assertTrue(createResponse.isAcknowledged());
 
@@ -1029,7 +1029,7 @@ public void testRunnerTwoObjectLevelsSourceMapping() throws Exception {
             .endObject();
         CreateIndexResponse createResponse = client().admin()
             .indices()
-            .create(new CreateIndexRequest(sourceIndex).mapping(MapperService.SINGLE_MAPPING_NAME, mappingBuilder))
+            .create(new CreateIndexRequest(sourceIndex).mapping(mappingBuilder))
             .actionGet();
         assertTrue(createResponse.isAcknowledged());
 
@@ -1160,7 +1160,7 @@ public void testRunnerDottedKeyNameSourceMapping() throws Exception {
             .endObject();
         CreateIndexResponse createResponse = client().admin()
             .indices()
-            .create(new CreateIndexRequest(sourceIndex).mapping(MapperService.SINGLE_MAPPING_NAME, mappingBuilder))
+            .create(new CreateIndexRequest(sourceIndex).mapping(mappingBuilder))
             .actionGet();
         assertTrue(createResponse.isAcknowledged());
 
diff --git a/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenIndexTests.java b/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenIndexTests.java
index 191285239a945..3d06431c554b9 100644
--- a/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenIndexTests.java
+++ b/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenIndexTests.java
@@ -112,7 +112,7 @@ public void testSearchAndGetAPIsAreThrottled() throws InterruptedException, IOEx
             .startObject("properties").startObject("field").field("type", "text").field("term_vector", "with_positions_offsets_payloads")
             .endObject().endObject()
             .endObject().endObject();
-        createIndex("index", Settings.builder().put("index.number_of_shards", 2).build(), "_doc", mapping);
+        createIndex("index", Settings.builder().put("index.number_of_shards", 2).build(), mapping);
         for (int i = 0; i < 10; i++) {
             client().prepareIndex("index").setId("" + i).setSource("field", "foo bar baz").get();
         }
diff --git a/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectSearchTests.java b/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectSearchTests.java
index 1c779a8ed2201..f82d7cf486ebc 100644
--- a/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectSearchTests.java
+++ b/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectSearchTests.java
@@ -75,7 +75,7 @@ public void setUpIndex() throws IOException {
                 .endObject()
            .endObject()
         .endObject();
-        createIndex("test", Settings.EMPTY, "_doc", mapping);
+        createIndex("test", Settings.EMPTY, mapping);
     }
 
     public void testMatchQuery() throws Exception {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MlConfigMigrator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MlConfigMigrator.java
index 94b3784a1e3e7..5f41d514c8729 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MlConfigMigrator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MlConfigMigrator.java
@@ -65,7 +65,6 @@
 import java.util.function.Function;
 import java.util.stream.Collectors;
 
-import static org.elasticsearch.index.mapper.MapperService.SINGLE_MAPPING_NAME;
 import static org.elasticsearch.xpack.core.ClientHelper.ML_ORIGIN;
 import static org.elasticsearch.xpack.core.ClientHelper.executeAsyncWithOrigin;
 
@@ -493,7 +492,7 @@ private void createConfigIndex(ActionListener<Boolean> listener) {
                             .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-1")
                             .put(IndexSettings.MAX_RESULT_WINDOW_SETTING.getKey(), AnomalyDetectorsIndex.CONFIG_INDEX_MAX_RESULTS_WINDOW)
             );
-            createIndexRequest.mapping(SINGLE_MAPPING_NAME, ElasticsearchMappings.configMapping());
+            createIndexRequest.mapping(ElasticsearchMappings.configMapping());
         } catch (Exception e) {
             logger.error("error writing the .ml-config mappings", e);
             listener.onFailure(e);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
index 7996f21da6453..47ecb0ec2b6b8 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
@@ -22,7 +22,6 @@
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MappingMetaData;
 import org.elasticsearch.common.Nullable;
-import org.elasticsearch.common.collect.ImmutableOpenMap;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.IndexSortConfig;
 import org.elasticsearch.search.sort.SortOrder;
@@ -87,7 +86,7 @@ private static void prepareCreateIndexRequest(Client client, Clock clock, DataFr
                                                   ActionListener<CreateIndexRequest> listener) {
         AtomicReference<Settings> settingsHolder = new AtomicReference<>();
 
-        ActionListener<ImmutableOpenMap<String, MappingMetaData>> mappingsListener = ActionListener.wrap(
+        ActionListener<MappingMetaData> mappingsListener = ActionListener.wrap(
             mappings -> listener.onResponse(createIndexRequest(clock, config, settingsHolder.get(), mappings)),
             listener::onFailure
         );
@@ -115,19 +114,15 @@ private static void prepareCreateIndexRequest(Client client, Clock clock, DataFr
     }
 
     private static CreateIndexRequest createIndexRequest(Clock clock, DataFrameAnalyticsConfig config, Settings settings,
-                                                         ImmutableOpenMap<String, MappingMetaData> mappings) {
-        // There should only be 1 type
-        assert mappings.size() == 1;
-
+                                                         MappingMetaData mappings) {
         String destinationIndex = config.getDest().getIndex();
-        String type = mappings.keysIt().next();
-        Map<String, Object> mappingsAsMap = mappings.valuesIt().next().sourceAsMap();
+        Map<String, Object> mappingsAsMap = mappings.sourceAsMap();
         Map<String, Object> properties = getOrPutDefault(mappingsAsMap, PROPERTIES, HashMap::new);
         checkResultsFieldIsNotPresentInProperties(config, properties);
         properties.putAll(createAdditionalMappings(config, Collections.unmodifiableMap(properties)));
         Map<String, Object> metadata = getOrPutDefault(mappingsAsMap, META, HashMap::new);
         metadata.putAll(createMetaData(config.getId(), clock));
-        return new CreateIndexRequest(destinationIndex, settings).mapping(type, mappingsAsMap);
+        return new CreateIndexRequest(destinationIndex, settings).mapping(mappingsAsMap);
     }
 
     private static Settings settings(GetSettingsResponse settingsResponse) {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/MappingsMerger.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/MappingsMerger.java
index 056f8239aef8d..bd88721d6de5f 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/MappingsMerger.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/MappingsMerger.java
@@ -34,7 +34,7 @@ public final class MappingsMerger {
     private MappingsMerger() {}
 
     public static void mergeMappings(Client client, Map<String, String> headers, DataFrameAnalyticsSource source,
-                                     ActionListener<ImmutableOpenMap<String, MappingMetaData>> listener) {
+                                     ActionListener<MappingMetaData> listener) {
         ActionListener<GetMappingsResponse> mappingsListener = ActionListener.wrap(
             getMappingsResponse -> listener.onResponse(MappingsMerger.mergeMappings(source, getMappingsResponse)),
             listener::onFailure
@@ -45,7 +45,7 @@ public static void mergeMappings(Client client, Map<String, String> headers, Dat
         ClientHelper.executeWithHeadersAsync(headers, ML_ORIGIN, client, GetMappingsAction.INSTANCE, getMappingsRequest, mappingsListener);
     }
 
-    static ImmutableOpenMap<String, MappingMetaData> mergeMappings(DataFrameAnalyticsSource source,
+    static MappingMetaData mergeMappings(DataFrameAnalyticsSource source,
                                                                    GetMappingsResponse getMappingsResponse) {
         ImmutableOpenMap<String, MappingMetaData> indexToMappings = getMappingsResponse.getMappings();
 
@@ -78,10 +78,7 @@ static ImmutableOpenMap<String, MappingMetaData> mergeMappings(DataFrameAnalytic
             }
         }
 
-        MappingMetaData mappingMetaData = createMappingMetaData(MapperService.SINGLE_MAPPING_NAME, mergedMappings);
-        ImmutableOpenMap.Builder<String, MappingMetaData> result = ImmutableOpenMap.builder();
-        result.put(MapperService.SINGLE_MAPPING_NAME, mappingMetaData);
-        return result.build();
+        return createMappingMetaData(MapperService.SINGLE_MAPPING_NAME, mergedMappings);
     }
 
     private static MappingMetaData createMappingMetaData(String type, Map<String, Object> mappings) {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProvider.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProvider.java
index b9698cbff792f..b9359d2b97cd6 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProvider.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProvider.java
@@ -129,7 +129,6 @@
 import java.util.function.Supplier;
 import java.util.stream.Collectors;
 
-import static org.elasticsearch.index.mapper.MapperService.SINGLE_MAPPING_NAME;
 import static org.elasticsearch.xpack.core.ClientHelper.ML_ORIGIN;
 import static org.elasticsearch.xpack.core.ClientHelper.clientWithOrigin;
 import static org.elasticsearch.xpack.core.ClientHelper.executeAsyncWithOrigin;
@@ -295,7 +294,7 @@ public void createJobResultIndex(Job job, ClusterState state, final ActionListen
             // This assumes the requested mapping will be merged with mappings from the template,
             // and may need to be revisited if template merging is ever refactored
             try (XContentBuilder termFieldsMapping = ElasticsearchMappings.termFieldsMapping(termFields)) {
-                createIndexRequest.mapping(SINGLE_MAPPING_NAME, termFieldsMapping);
+                createIndexRequest.mapping(termFieldsMapping);
             }
             executeAsyncWithOrigin(client.threadPool().getThreadContext(), ML_ORIGIN, createIndexRequest,
                     ActionListener.<CreateIndexResponse>wrap(
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/MappingsMergerTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/MappingsMergerTests.java
index e47b3e6934e80..3531946f277e4 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/MappingsMergerTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/MappingsMergerTests.java
@@ -35,11 +35,9 @@ public void testMergeMappings_GivenIndicesWithIdenticalMappings() {
 
         GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
 
-        ImmutableOpenMap<String, MappingMetaData> mergedMappings = MappingsMerger.mergeMappings(newSource(), getMappingsResponse);
+        MappingMetaData mergedMappings = MappingsMerger.mergeMappings(newSource(), getMappingsResponse);
 
-        assertThat(mergedMappings.size(), equalTo(1));
-        assertThat(mergedMappings.containsKey("_doc"), is(true));
-        assertThat(mergedMappings.valuesIt().next().getSourceAsMap(), equalTo(index1Mappings));
+        assertThat(mergedMappings.getSourceAsMap(), equalTo(index1Mappings));
     }
 
     public void testMergeMappings_GivenFieldWithDifferentMapping() {
@@ -76,11 +74,9 @@ public void testMergeMappings_GivenIndicesWithDifferentMappingsButNoConflicts()
 
         GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
 
-        ImmutableOpenMap<String, MappingMetaData> mergedMappings = MappingsMerger.mergeMappings(newSource(), getMappingsResponse);
+        MappingMetaData mergedMappings = MappingsMerger.mergeMappings(newSource(), getMappingsResponse);
 
-        assertThat(mergedMappings.size(), equalTo(1));
-        assertThat(mergedMappings.containsKey("_doc"), is(true));
-        Map<String, Object> mappingsAsMap = mergedMappings.valuesIt().next().getSourceAsMap();
+        Map<String, Object> mappingsAsMap = mergedMappings.getSourceAsMap();
         assertThat(mappingsAsMap.size(), equalTo(1));
         assertThat(mappingsAsMap.containsKey("properties"), is(true));
 
@@ -103,12 +99,10 @@ public void testMergeMappings_GivenSourceFiltering() {
 
         GetMappingsResponse getMappingsResponse = new GetMappingsResponse(mappings.build());
 
-        ImmutableOpenMap<String, MappingMetaData> mergedMappings = MappingsMerger.mergeMappings(
+        MappingMetaData mergedMappings = MappingsMerger.mergeMappings(
             newSourceWithExcludes("field_1"), getMappingsResponse);
 
-        assertThat(mergedMappings.size(), equalTo(1));
-        assertThat(mergedMappings.containsKey("_doc"), is(true));
-        Map<String, Object> mappingsAsMap = mergedMappings.valuesIt().next().getSourceAsMap();
+        Map<String, Object> mappingsAsMap = mergedMappings.getSourceAsMap();
         @SuppressWarnings("unchecked")
         Map<String, Object> fieldMappings = (Map<String, Object>) mappingsAsMap.get("properties");
 
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/MockClientBuilder.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/MockClientBuilder.java
index 5f5ac9246a222..72266c6ed6395 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/MockClientBuilder.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/MockClientBuilder.java
@@ -169,7 +169,7 @@ public MockClientBuilder prepareCreate(String index) {
         CreateIndexRequestBuilder createIndexRequestBuilder = mock(CreateIndexRequestBuilder.class);
         CreateIndexResponse response = mock(CreateIndexResponse.class);
         when(createIndexRequestBuilder.setSettings(any(Settings.Builder.class))).thenReturn(createIndexRequestBuilder);
-        when(createIndexRequestBuilder.addMapping(any(String.class), any(XContentBuilder.class))).thenReturn(createIndexRequestBuilder);
+        when(createIndexRequestBuilder.setMapping(any(XContentBuilder.class))).thenReturn(createIndexRequestBuilder);
         when(createIndexRequestBuilder.get()).thenReturn(response);
         when(indicesAdminClient.prepareCreate(eq(index))).thenReturn(createIndexRequestBuilder);
         return this;
diff --git a/x-pack/plugin/search-business-rules/src/test/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilderIT.java b/x-pack/plugin/search-business-rules/src/test/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilderIT.java
index 1ee50ceecee5c..9f80e1c8ec91d 100644
--- a/x-pack/plugin/search-business-rules/src/test/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilderIT.java
+++ b/x-pack/plugin/search-business-rules/src/test/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilderIT.java
@@ -59,8 +59,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
 
     public void testPinnedPromotions() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1",
-                        jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("field1")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field1")
                                 .field("analyzer", "whitespace").field("type", "text").endObject().endObject().endObject().endObject())
                 .setSettings(Settings.builder().put(indexSettings()).put("index.number_of_shards", randomIntBetween(2, 5))));
 
@@ -143,8 +142,8 @@ public void testPinnedPromotions() throws Exception {
     }
 
     public void testExplain() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1",
-                jsonBuilder().startObject().startObject("type1").startObject("properties").startObject("field1")
+        assertAcked(prepareCreate("test").setMapping(
+                jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field1")
                         .field("analyzer", "whitespace").field("type", "text").endObject().endObject().endObject().endObject()));
         ensureGreen();
         client().prepareIndex("test").setId("1").setSource("field1", "the quick brown fox").get();
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
index 4d7b22af1cd32..635294ff7e4d9 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
@@ -71,7 +71,6 @@
 
 import static org.elasticsearch.cluster.metadata.IndexMetaData.INDEX_FORMAT_SETTING;
 import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
-import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureFieldName;
 import static org.elasticsearch.xpack.core.ClientHelper.SECURITY_ORIGIN;
 import static org.elasticsearch.xpack.core.ClientHelper.executeAsyncWithOrigin;
 
@@ -360,7 +359,7 @@ public void prepareIndexIfNeededThenExecute(final Consumer<Exception> consumer,
                 final Tuple<String, Settings> mappingAndSettings = parseMappingAndSettingsFromTemplateBytes(mappingSource);
                 CreateIndexRequest request = new CreateIndexRequest(indexState.concreteIndexName)
                         .alias(new Alias(this.aliasName))
-                        .mapping("{\"_doc\":" + mappingAndSettings.v1() + "}")
+                        .mapping(mappingAndSettings.v1())
                         .waitForActiveShards(ActiveShardCount.ALL)
                         .settings(mappingAndSettings.v2());
                 executeAsyncWithOrigin(client.threadPool().getThreadContext(), SECURITY_ORIGIN, request,
@@ -433,11 +432,7 @@ private static Tuple<String, Settings> parseMappingAndSettingsFromTemplateBytes(
         final String mappingSource = request.mappings().get(MapperService.SINGLE_MAPPING_NAME);
         try (XContentParser parser = XContentType.JSON.xContent().createParser(NamedXContentRegistry.EMPTY,
                 DeprecationHandler.THROW_UNSUPPORTED_OPERATION, mappingSource)) {
-            // remove the type wrapping to get the mapping
             ensureExpectedToken(XContentParser.Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation); // {
-            ensureFieldName(parser, parser.nextToken(), MapperService.SINGLE_MAPPING_NAME); // _doc
-            ensureExpectedToken(XContentParser.Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation); // {
-
             XContentBuilder builder = JsonXContent.contentBuilder();
             builder.generator().copyCurrentStructure(parser);
             return new Tuple<>(Strings.toString(builder), request.settings());
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityTests.java
index f4b2556fb4816..1e255ee5ee495 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityTests.java
@@ -623,7 +623,7 @@ public void testParentChild() throws Exception {
                 .endObject()
                 .endObject();
         assertAcked(prepareCreate("test")
-                .addMapping("doc", mapping));
+                .setMapping(mapping));
         ensureGreen();
 
         // index simple data
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityTests.java
index 340cda716ff2f..bb6bb7cded759 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityTests.java
@@ -1346,7 +1346,7 @@ public void testParentChild() throws Exception {
             .endObject()
             .endObject();
         assertAcked(prepareCreate("test")
-              .addMapping("doc", mapping));
+              .setMapping(mapping));
         ensureGreen();
 
         // index simple data
diff --git a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
index 1d11c54b69e47..a9f491d29918e 100644
--- a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
+++ b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
@@ -264,14 +264,14 @@ public void testContainsShapeQuery() {
 
     public void testGeometryCollectionRelations() throws IOException {
         XContentBuilder mapping = XContentFactory.jsonBuilder().startObject()
-            .startObject("doc")
+            .startObject("_doc")
             .startObject("properties")
             .startObject("geometry").field("type", "shape").endObject()
             .endObject()
             .endObject()
             .endObject();
 
-        createIndex("test_collections", Settings.builder().put("index.number_of_shards", 1).build(), "doc", mapping);
+        createIndex("test_collections", Settings.builder().put("index.number_of_shards", 1).build(), mapping);
 
         EnvelopeBuilder envelopeBuilder = new EnvelopeBuilder(new Coordinate(-10, 10), new Coordinate(10, -10));
 
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformIndex.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformIndex.java
index d1d2e24f28e7c..90938fb693415 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformIndex.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformIndex.java
@@ -50,9 +50,7 @@ public static void createDestinationIndex(Client client,
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_AUTO_EXPAND_REPLICAS, "0-1"));
 
-        request.mapping(
-            SINGLE_MAPPING_NAME,
-            createMappingXContent(mappings, transformConfig.getId(), clock));
+        request.mapping(createMappingXContent(mappings, transformConfig.getId(), clock));
 
         client.execute(CreateIndexAction.INSTANCE, request, ActionListener.wrap(createIndexResponse -> {
             listener.onResponse(true);
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManagerTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManagerTests.java
index 818941bac5837..e8ffb7a562c60 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManagerTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/persistence/TransformConfigManagerTests.java
@@ -17,7 +17,6 @@
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.xpack.core.action.util.PageParams;
 import org.elasticsearch.xpack.core.transform.TransformMessages;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpoint;
@@ -351,7 +350,7 @@ public void testDeleteOldTransformConfigurations() throws Exception {
         TransformConfig transformConfig = TransformConfigTests.randomTransformConfig("transform_test_delete_old_configurations");
         client().admin()
             .indices()
-            .create(new CreateIndexRequest(oldIndex).mapping(MapperService.SINGLE_MAPPING_NAME, mappings()))
+            .create(new CreateIndexRequest(oldIndex).mapping(mappings()))
             .actionGet();
 
         try (XContentBuilder builder = XContentFactory.jsonBuilder()) {
@@ -387,7 +386,7 @@ public void testDeleteOldTransformStoredDocuments() throws Exception {
         TransformStoredDoc transformStoredDoc = TransformStoredDocTests.randomTransformStoredDoc(transformId);
         client().admin()
             .indices()
-            .create(new CreateIndexRequest(oldIndex).mapping(MapperService.SINGLE_MAPPING_NAME, mappings()))
+            .create(new CreateIndexRequest(oldIndex).mapping(mappings()))
             .actionGet();
 
         try (XContentBuilder builder = XContentFactory.jsonBuilder()) {
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/history/HistoryTemplateTransformMappingsTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/history/HistoryTemplateTransformMappingsTests.java
index 2c7524e861f9e..8984889e95c05 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/history/HistoryTemplateTransformMappingsTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/history/HistoryTemplateTransformMappingsTests.java
@@ -29,7 +29,7 @@
 public class HistoryTemplateTransformMappingsTests extends AbstractWatcherIntegrationTestCase {
 
     public void testTransformFields() throws Exception {
-        assertAcked(client().admin().indices().prepareCreate("idx").addMapping("doc",
+        assertAcked(client().admin().indices().prepareCreate("idx").setMapping(
                 jsonBuilder().startObject()
                         .startObject("properties")
                         .startObject("foo")
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
index d276718ce2f7a..415ad1adf6fc2 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/AbstractWatcherIntegrationTestCase.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
-import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.license.LicenseService;
 import org.elasticsearch.license.XPackLicenseState;
@@ -277,7 +276,7 @@ public void replaceWatcherIndexWithRandomlyNamedIndex(String originalIndexOrAlia
         newSettings.remove("index.version.created");
 
         CreateIndexResponse createIndexResponse = client().admin().indices().prepareCreate(to)
-            .addMapping(MapperService.SINGLE_MAPPING_NAME, mapping.sourceAsMap())
+            .setMapping(mapping.sourceAsMap())
             .setSettings(newSettings)
             .get();
         assertTrue(createIndexResponse.isAcknowledged());

From f9074b82a050ef7d352f862388a72bd0ed8416c5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Wed, 8 Jan 2020 10:34:41 +0100
Subject: [PATCH 435/686] Remove _reload_search_analyzer experimental status
 (#50696)

Removing the experimental status in the docs and the rest specs.
---
 docs/reference/indices/apis/reload-analyzers.asciidoc           | 2 --
 .../rest-api-spec/api/indices.reload_search_analyzers.json      | 2 +-
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/reference/indices/apis/reload-analyzers.asciidoc b/docs/reference/indices/apis/reload-analyzers.asciidoc
index a7b1764aa685a..9aae5cb99e4e3 100644
--- a/docs/reference/indices/apis/reload-analyzers.asciidoc
+++ b/docs/reference/indices/apis/reload-analyzers.asciidoc
@@ -6,8 +6,6 @@
 <titleabbrev>Reload search analyzers</titleabbrev>
 ++++
 
-experimental::[]
-
 Reloads an index's <<search-analyzer,search analyzers>> and their resources.
 
 [source,console]
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.reload_search_analyzers.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.reload_search_analyzers.json
index a62634046483c..a77f496015d6b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.reload_search_analyzers.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.reload_search_analyzers.json
@@ -3,7 +3,7 @@
     "documentation":{
       "url":"https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-reload-analyzers.html"
     },
-    "stability":"experimental",
+    "stability" : "stable",
     "url":{
       "paths":[
         {

From 22ff28e37308857f61da6d3d677b1aaf75806e01 Mon Sep 17 00:00:00 2001
From: Andrei Dan <andrei.dan@elastic.co>
Date: Wed, 8 Jan 2020 10:38:11 +0100
Subject: [PATCH 436/686] Make the UpdateRolloverLifecycleDateStep retryable
 (#50702)

This makes the "update-rollover-lifecycle-date" step, which is part of the
rollover action, retryable. It also adds an integration test to check the
step is retried and it eventually succeeds.
---
 .../ilm/UpdateRolloverLifecycleDateStep.java  |  5 ++
 .../ilm/TimeSeriesLifecycleActionsIT.java     | 63 ++++++++++++++++++-
 2 files changed, 67 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/UpdateRolloverLifecycleDateStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/UpdateRolloverLifecycleDateStep.java
index d0271633d4994..3c0acc371d26a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/UpdateRolloverLifecycleDateStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/UpdateRolloverLifecycleDateStep.java
@@ -33,6 +33,11 @@ public UpdateRolloverLifecycleDateStep(StepKey key, StepKey nextStepKey, LongSup
         this.fallbackTimeSupplier = fallbackTimeSupplier;
     }
 
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
+
     @Override
     public ClusterState performAction(Index index, ClusterState currentState) {
         IndexMetaData indexMetaData = currentState.metaData().getIndexSafe(index);
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 1560dbd5effe7..07e7ff405ded5 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -44,6 +44,7 @@
 import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
+import org.elasticsearch.xpack.core.ilm.UpdateRolloverLifecycleDateStep;
 import org.elasticsearch.xpack.core.ilm.WaitForRolloverReadyStep;
 import org.hamcrest.Matchers;
 import org.junit.Before;
@@ -1086,6 +1087,67 @@ public void testRolloverStepRetriesUntilRolledOverIndexIsDeleted() throws Except
         assertBusy(() -> assertThat(getStepKeyForIndex(index), equalTo(TerminalPolicyStep.KEY)));
     }
 
+    public void testUpdateRolloverLifecycleDateStepRetriesWhenRolloverInfoIsMissing() throws Exception {
+        String index = this.index + "-000001";
+
+        createNewSingletonPolicy("hot", new RolloverAction(null, null, 1L));
+
+        createIndexWithSettings(
+            index,
+            Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
+                .put(LifecycleSettings.LIFECYCLE_NAME, policy)
+                .put(RolloverAction.LIFECYCLE_ROLLOVER_ALIAS, "alias"),
+            true
+        );
+
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getName(), is(WaitForRolloverReadyStep.NAME)));
+
+        // moving ILM to the "update-rollover-lifecycle-date" without having gone through the actual rollover step
+        // the "update-rollover-lifecycle-date" step will fail as the index has no rollover information
+        Request moveToStepRequest = new Request("POST", "_ilm/move/" + index);
+        moveToStepRequest.setJsonEntity("{\n" +
+            "  \"current_step\": {\n" +
+            "    \"phase\": \"hot\",\n" +
+            "    \"action\": \"rollover\",\n" +
+            "    \"name\": \"check-rollover-ready\"\n" +
+            "  },\n" +
+            "  \"next_step\": {\n" +
+            "    \"phase\": \"hot\",\n" +
+            "    \"action\": \"rollover\",\n" +
+            "    \"name\": \"update-rollover-lifecycle-date\"\n" +
+            "  }\n" +
+            "}");
+        client().performRequest(moveToStepRequest);
+
+        waitUntil(() -> {
+            try {
+                Map<String, Object> explainIndexResponse = explainIndex(index);
+                String step = (String) explainIndexResponse.get("step");
+                Integer retryCount = (Integer) explainIndexResponse.get(FAILED_STEP_RETRY_COUNT_FIELD);
+                return step != null && step.equals(UpdateRolloverLifecycleDateStep.NAME) && retryCount != null && retryCount >= 1;
+            } catch (IOException e) {
+                return false;
+            }
+        });
+
+        index(client(), index, "1", "foo", "bar");
+        Request refreshIndex = new Request("POST", "/" + index + "/_refresh");
+        client().performRequest(refreshIndex);
+
+        // manual rollover the index so the "update-rollover-lifecycle-date" ILM step can continue and finish successfully as the index
+        // will have rollover information now
+        Request rolloverRequest = new Request("POST", "/alias/_rollover");
+        rolloverRequest.setJsonEntity("{\n" +
+            "  \"conditions\": {\n" +
+            "    \"max_docs\": \"1\"\n" +
+            "  }\n" +
+            "}"
+        );
+        client().performRequest(rolloverRequest);
+        assertBusy(() -> assertThat(getStepKeyForIndex(index), equalTo(TerminalPolicyStep.KEY)));
+    }
+
     public void testHistoryIsWrittenWithSuccess() throws Exception {
         String index = "success-index";
 
@@ -1130,7 +1192,6 @@ public void testHistoryIsWrittenWithSuccess() throws Exception {
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-000002", true, "check-rollover-ready"), 30, TimeUnit.SECONDS);
     }
 
-
     public void testHistoryIsWrittenWithFailure() throws Exception {
         String index = "failure-index";
 

From 6175a90e469cb986c6ed9335014348198eac3f3d Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Wed, 8 Jan 2020 11:35:30 +0100
Subject: [PATCH 437/686] Import replicated closed dangling indices (#50649)

Dangling replicated closed indices are not imported properly (they miss their routing table when imported).
---
 .../org/elasticsearch/cluster/routing/RoutingTable.java     | 2 +-
 .../elasticsearch/gateway/LocalAllocateDangledIndices.java  | 4 +++-
 .../elasticsearch/indices/recovery/DanglingIndicesIT.java   | 6 ++++++
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java b/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
index df5e32f9f1708..b595efb3a5b4b 100644
--- a/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
+++ b/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
@@ -511,7 +511,7 @@ public Builder addAsRecovery(IndexMetaData indexMetaData) {
         }
 
         public Builder addAsFromDangling(IndexMetaData indexMetaData) {
-            if (indexMetaData.getState() == IndexMetaData.State.OPEN) {
+            if (indexMetaData.getState() == IndexMetaData.State.OPEN || isIndexVerifiedBeforeClosed(indexMetaData)) {
                 IndexRoutingTable.Builder indexRoutingBuilder = new IndexRoutingTable.Builder(indexMetaData.getIndex())
                         .initializeAsFromDangling(indexMetaData);
                 add(indexRoutingBuilder);
diff --git a/server/src/main/java/org/elasticsearch/gateway/LocalAllocateDangledIndices.java b/server/src/main/java/org/elasticsearch/gateway/LocalAllocateDangledIndices.java
index a90e31ada1cf2..6d6273f5e7f62 100644
--- a/server/src/main/java/org/elasticsearch/gateway/LocalAllocateDangledIndices.java
+++ b/server/src/main/java/org/elasticsearch/gateway/LocalAllocateDangledIndices.java
@@ -51,6 +51,8 @@
 import java.util.Arrays;
 import java.util.Collection;
 
+import static org.elasticsearch.cluster.metadata.MetaDataIndexStateService.isIndexVerifiedBeforeClosed;
+
 public class LocalAllocateDangledIndices {
 
     private static final Logger logger = LogManager.getLogger(LocalAllocateDangledIndices.class);
@@ -149,7 +151,7 @@ public ClusterState execute(ClusterState currentState) {
                         }
                         metaData.put(upgradedIndexMetaData, false);
                         blocks.addBlocks(upgradedIndexMetaData);
-                        if (upgradedIndexMetaData.getState() == IndexMetaData.State.OPEN) {
+                        if (upgradedIndexMetaData.getState() == IndexMetaData.State.OPEN || isIndexVerifiedBeforeClosed(indexMetaData)) {
                             routingTableBuilder.addAsFromDangling(upgradedIndexMetaData);
                         }
                         sb.append("[").append(upgradedIndexMetaData.getIndex()).append("/").append(upgradedIndexMetaData.getState())
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java b/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java
index 31afef73ad450..ba77877f7f67d 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java
@@ -53,6 +53,11 @@ public void testDanglingIndicesAreRecoveredWhenSettingIsEnabled() throws Excepti
 
         createIndex(INDEX_NAME, Settings.builder().put("number_of_replicas", 2).build());
 
+        if (randomBoolean()) {
+            client().admin().indices().prepareClose(INDEX_NAME).get();
+        }
+        ensureGreen(INDEX_NAME);
+
         // Restart node, deleting the index in its absence, so that there is a dangling index to recover
         internalCluster().restartRandomDataNode(new InternalTestCluster.RestartCallback() {
 
@@ -64,6 +69,7 @@ public Settings onNodeStopped(String nodeName) throws Exception {
         });
 
         assertBusy(() -> assertTrue("Expected dangling index " + INDEX_NAME + " to be recovered", indexExists(INDEX_NAME)));
+        ensureGreen(INDEX_NAME);
     }
 
     /**

From 01cff0df7be8a6fb78997b529bf87b18353e870a Mon Sep 17 00:00:00 2001
From: Przemyslaw Gomulka <przemyslaw.gomulka@elastic.co>
Date: Wed, 8 Jan 2020 14:05:22 +0100
Subject: [PATCH 438/686] Allow parsing timezone without fully provided time
 (#50178)

strict_date_optional_time changes to have optional minute part. It already allowed optional second and fraction of second part. This allows parsing 2018-01-01T00+01 , 2018-01-01T00:00+01 , 2018-01-01T00:00:00+01 , 2018-01-01T00:00:00.000+01
It won't allow parsing a timezone without an hour part as this is not allowed by iso8601 spec

closes #49351
---
 .../common/time/DateFormatters.java           | 50 +++++-----
 .../joda/JavaJodaTimeDuellingTests.java       | 96 +++++++++++++++----
 2 files changed, 105 insertions(+), 41 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/time/DateFormatters.java b/server/src/main/java/org/elasticsearch/common/time/DateFormatters.java
index d09493849ce85..ac190241b0c9a 100644
--- a/server/src/main/java/org/elasticsearch/common/time/DateFormatters.java
+++ b/server/src/main/java/org/elasticsearch/common/time/DateFormatters.java
@@ -107,31 +107,31 @@ public class DateFormatters {
     private static final DateTimeFormatter STRICT_DATE_OPTIONAL_TIME_FORMATTER = new DateTimeFormatterBuilder()
         .append(STRICT_YEAR_MONTH_DAY_FORMATTER)
         .optionalStart()
-        .appendLiteral('T')
-        .optionalStart()
-        .appendValue(HOUR_OF_DAY, 2, 2, SignStyle.NOT_NEGATIVE)
-        .optionalStart()
-        .appendLiteral(':')
-        .appendValue(MINUTE_OF_HOUR, 2, 2, SignStyle.NOT_NEGATIVE)
-        .optionalStart()
-        .appendLiteral(':')
-        .appendValue(SECOND_OF_MINUTE, 2, 2, SignStyle.NOT_NEGATIVE)
-        .optionalStart()
-        .appendFraction(NANO_OF_SECOND, 1, 9, true)
-        .optionalEnd()
-        .optionalStart()
-        .appendLiteral(',')
-        .appendFraction(NANO_OF_SECOND, 1, 9, false)
-        .optionalEnd()
-        .optionalEnd()
-        .optionalStart()
-        .appendZoneOrOffsetId()
-        .optionalEnd()
-        .optionalStart()
-        .append(TIME_ZONE_FORMATTER_NO_COLON)
-        .optionalEnd()
-        .optionalEnd()
-        .optionalEnd()
+            .appendLiteral('T')
+            .optionalStart()
+                .appendValue(HOUR_OF_DAY, 2, 2, SignStyle.NOT_NEGATIVE)
+                .optionalStart()
+                    .appendLiteral(':')
+                    .appendValue(MINUTE_OF_HOUR, 2, 2, SignStyle.NOT_NEGATIVE)
+                    .optionalStart()
+                        .appendLiteral(':')
+                        .appendValue(SECOND_OF_MINUTE, 2, 2, SignStyle.NOT_NEGATIVE)
+                        .optionalStart()
+                            .appendFraction(NANO_OF_SECOND, 1, 9, true)
+                        .optionalEnd()
+                        .optionalStart()
+                            .appendLiteral(',')
+                            .appendFraction(NANO_OF_SECOND, 1, 9, false)
+                        .optionalEnd()
+                    .optionalEnd()
+                .optionalEnd()
+                .optionalStart()
+                    .appendZoneOrOffsetId()
+                .optionalEnd()
+                .optionalStart()
+                    .append(TIME_ZONE_FORMATTER_NO_COLON)
+                .optionalEnd()
+            .optionalEnd()
         .optionalEnd()
         .toFormatter(Locale.ROOT)
         .withResolverStyle(ResolverStyle.STRICT);
diff --git a/server/src/test/java/org/elasticsearch/common/joda/JavaJodaTimeDuellingTests.java b/server/src/test/java/org/elasticsearch/common/joda/JavaJodaTimeDuellingTests.java
index 1ead658ba7165..dc8e80660ce97 100644
--- a/server/src/test/java/org/elasticsearch/common/joda/JavaJodaTimeDuellingTests.java
+++ b/server/src/test/java/org/elasticsearch/common/joda/JavaJodaTimeDuellingTests.java
@@ -24,11 +24,14 @@
 import org.elasticsearch.common.time.DateFormatter;
 import org.elasticsearch.common.time.DateFormatters;
 import org.elasticsearch.common.time.DateMathParser;
+import org.elasticsearch.common.util.LocaleUtils;
 import org.elasticsearch.test.ESTestCase;
 import org.joda.time.DateTime;
 import org.joda.time.DateTimeZone;
 import org.joda.time.format.ISODateTimeFormat;
+import org.junit.BeforeClass;
 
+import java.time.Instant;
 import java.time.LocalDateTime;
 import java.time.ZoneId;
 import java.time.ZoneOffset;
@@ -46,9 +49,47 @@ public class JavaJodaTimeDuellingTests extends ESTestCase {
     protected boolean enableWarningsCheck() {
         return false;
     }
+    @BeforeClass
+    public static void checkJvmProperties(){
+        assert ("SPI,COMPAT".equals(System.getProperty("java.locale.providers")))
+            : "`-Djava.locale.providers=SPI,COMPAT` needs to be set";
+    }
+
+    public void testTimezoneParsing() {
+        /** this testcase won't work in joda. See comment in {@link #testPartialTimeParsing()}
+         *  assertSameDateAs("2016-11-30T+01", "strict_date_optional_time", "strict_date_optional_time");
+         */
+        assertSameDateAs("2016-11-30T00+01", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T00+0100", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T00+01:00", "strict_date_optional_time", "strict_date_optional_time");
+    }
+
+    public void testPartialTimeParsing() {
+         /*
+         This does not work in Joda as it reports 2016-11-30T01:00:00Z
+         because StrictDateOptionalTime confuses +01 with an hour (which is a signed fixed length digit)
+         assertSameDateAs("2016-11-30T+01", "strict_date_optional_time", "strict_date_optional_time");
+         ES java.time implementation does not suffer from this,
+         but we intentionally not allow parsing timezone without an time part as it is not allowed in iso8601
+  */
+        assertJavaTimeParseException("2016-11-30T+01","strict_date_optional_time");
+
+        assertSameDateAs("2016-11-30T12+01", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T12:00+01", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T12:00:00+01", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T12:00:00.000+01", "strict_date_optional_time", "strict_date_optional_time");
+
+        //without timezone
+        assertSameDateAs("2016-11-30T", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T12", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T12:00", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T12:00:00", "strict_date_optional_time", "strict_date_optional_time");
+        assertSameDateAs("2016-11-30T12:00:00.000", "strict_date_optional_time", "strict_date_optional_time");
+    }
+
     // date_optional part of a parser names "strict_date_optional_time" or "date_optional"time
     // means that date part can be partially parsed.
-    public void testPartialParsing() {
+    public void testPartialDateParsing() {
         assertSameDateAs("2001", "strict_date_optional_time_nanos", "strict_date_optional_time");
         assertSameDateAs("2001-01", "strict_date_optional_time_nanos", "strict_date_optional_time");
         assertSameDateAs("2001-01-01", "strict_date_optional_time_nanos", "strict_date_optional_time");
@@ -167,19 +208,17 @@ public void testCustomTimeFormats() {
         assertSameDate("Nov 24 01:29:01 -0800", "MMM dd HH:mm:ss Z");
     }
 
-    // this test requires tests to run with -Djava.locale.providers=COMPAT in order to work
-//    public void testCustomLocales() {
-//
-//        // also ensure that locale based dates are the same
-//        assertSameDate("Di., 05 Dez. 2000 02:55:00 -0800", "E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"));
-//        assertSameDate("Mi., 06 Dez. 2000 02:55:00 -0800", "E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"));
-//        assertSameDate("Do., 07 Dez. 2000 00:00:00 -0800", "E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"));
-//        assertSameDate("Fr., 08 Dez. 2000 00:00:00 -0800", "E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"));
-//
-//        DateTime dateTimeNow = DateTime.now(DateTimeZone.UTC);
-//        ZonedDateTime javaTimeNow = Instant.ofEpochMilli(dateTimeNow.getMillis()).atZone(ZoneOffset.UTC);
-//        assertSamePrinterOutput("E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"), javaTimeNow, dateTimeNow);
-//    }
+    public void testCustomLocales() {
+        // also ensure that locale based dates are the same
+        assertSameDate("Di, 05 Dez 2000 02:55:00 -0800", "E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"));
+        assertSameDate("Mi, 06 Dez 2000 02:55:00 -0800", "E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"));
+        assertSameDate("Do, 07 Dez 2000 00:00:00 -0800", "E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"));
+        assertSameDate("Fr, 08 Dez 2000 00:00:00 -0800", "E, d MMM yyyy HH:mm:ss Z", LocaleUtils.parse("de"));
+
+        DateTime dateTimeNow = DateTime.now(DateTimeZone.UTC);
+        ZonedDateTime javaTimeNow = Instant.ofEpochMilli(dateTimeNow.getMillis()).atZone(ZoneOffset.UTC);
+        assertSamePrinterOutput("E, d MMM yyyy HH:mm:ss Z", javaTimeNow, dateTimeNow, LocaleUtils.parse("de"));
+    }
 
     public void testDuellingFormatsValidParsing() {
         assertSameDate("1522332219", "epoch_second");
@@ -859,9 +898,28 @@ public void testParsingMissingTimezone() {
     }
 
     private void assertSamePrinterOutput(String format, ZonedDateTime javaDate, DateTime jodaDate) {
+        DateFormatter dateFormatter = DateFormatter.forPattern(format);
+        JodaDateFormatter jodaDateFormatter = Joda.forPattern(format);
+
+        assertSamePrinterOutput(format, javaDate, jodaDate, dateFormatter, jodaDateFormatter);
+    }
+
+    private void assertSamePrinterOutput(String format, ZonedDateTime javaDate, DateTime jodaDate, Locale locale) {
+        DateFormatter dateFormatter = DateFormatter.forPattern(format).withLocale(locale);
+        DateFormatter jodaDateFormatter = Joda.forPattern(format).withLocale(locale);
+
+        assertSamePrinterOutput(format, javaDate, jodaDate, dateFormatter, jodaDateFormatter);
+    }
+
+    private void assertSamePrinterOutput(String format,
+                                         ZonedDateTime javaDate,
+                                         DateTime jodaDate,
+                                         DateFormatter dateFormatter,
+                                         DateFormatter jodaDateFormatter) {
+        String javaTimeOut = dateFormatter.format(javaDate);
+        String jodaTimeOut = jodaDateFormatter.formatJoda(jodaDate);
+
         assertThat(jodaDate.getMillis(), is(javaDate.toInstant().toEpochMilli()));
-        String javaTimeOut = DateFormatter.forPattern(format).format(javaDate);
-        String jodaTimeOut = Joda.forPattern(format).formatJoda(jodaDate);
 
         if (JavaVersion.current().getVersion().get(0) == 8 && javaTimeOut.endsWith(".0")
             && (format.equals("epoch_second") || format.equals("epoch_millis"))) {
@@ -880,6 +938,12 @@ private void assertSameDate(String input, String format) {
         assertSameDate(input, format, jodaFormatter, javaFormatter);
     }
 
+    private void assertSameDate(String input, String format, Locale locale) {
+        DateFormatter jodaFormatter = Joda.forPattern(format).withLocale(locale);
+        DateFormatter javaFormatter = DateFormatter.forPattern(format).withLocale(locale);
+        assertSameDate(input, format, jodaFormatter, javaFormatter);
+    }
+
     private void assertSameDate(String input, String format, DateFormatter jodaFormatter, DateFormatter javaFormatter) {
         DateTime jodaDateTime = jodaFormatter.parseJoda(input);
 

From 5d25a0b3eccac7d002d005b182d0c2e21574aab4 Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Wed, 8 Jan 2020 14:38:39 +0100
Subject: [PATCH 439/686] Guess root cause support unwrap (#50525)

ElasticsearchException.guessRootCauses would return wrapper exception if
inner exception was not an ElasticsearchException. Fixed to never return
wrapper exceptions.

At least following APIs change root_cause.0.type as a result:

_update with bad script
_index with bad pipeline

Relates #50417
---
 .../test/ingest/210_pipeline_processor.yml             |  8 ++++----
 .../rest-api-spec/test/painless/15_update.yml          |  2 +-
 .../java/org/elasticsearch/ElasticsearchException.java |  2 +-
 .../org/elasticsearch/ElasticsearchExceptionTests.java | 10 ++++++++++
 4 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/210_pipeline_processor.yml b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/210_pipeline_processor.yml
index 76dbc180fa0e5..a012536c53bb4 100644
--- a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/210_pipeline_processor.yml
+++ b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/210_pipeline_processor.yml
@@ -106,8 +106,8 @@ teardown:
       id: 1
       pipeline: "outer"
       body: {}
-- match: { error.root_cause.0.type: "ingest_processor_exception" }
-- match: { error.root_cause.0.reason: "java.lang.IllegalStateException: Cycle detected for pipeline: outer" }
+- match: { error.root_cause.0.type: "illegal_state_exception" }
+- match: { error.root_cause.0.reason: "Cycle detected for pipeline: outer" }
 
 ---
 "Test Pipeline Processor with templating":
@@ -200,5 +200,5 @@ teardown:
           {
             "org": "legal"
           }
-  - match: { error.root_cause.0.type: "ingest_processor_exception" }
-  - match: { error.root_cause.0.reason: "java.lang.IllegalStateException: Pipeline processor configured for non-existent pipeline [legal-department]" }
+  - match: { error.root_cause.0.type: "illegal_state_exception" }
+  - match: { error.root_cause.0.reason: "Pipeline processor configured for non-existent pipeline [legal-department]" }
diff --git a/modules/lang-painless/src/test/resources/rest-api-spec/test/painless/15_update.yml b/modules/lang-painless/src/test/resources/rest-api-spec/test/painless/15_update.yml
index 15e93bf621c7e..cb118ed9d562f 100644
--- a/modules/lang-painless/src/test/resources/rest-api-spec/test/painless/15_update.yml
+++ b/modules/lang-painless/src/test/resources/rest-api-spec/test/painless/15_update.yml
@@ -120,6 +120,6 @@
               source: "ctx._source.ctx = ctx"
               params: { bar: 'xxx' }
 
-  - match: { error.root_cause.0.type: "remote_transport_exception" }
+  - match: { error.root_cause.0.type: "illegal_argument_exception" }
   - match: { error.type: "illegal_argument_exception" }
   - match: { error.reason: "Iterable object is self-referencing itself" }
diff --git a/server/src/main/java/org/elasticsearch/ElasticsearchException.java b/server/src/main/java/org/elasticsearch/ElasticsearchException.java
index abaceff4f4e73..f588823f699b3 100644
--- a/server/src/main/java/org/elasticsearch/ElasticsearchException.java
+++ b/server/src/main/java/org/elasticsearch/ElasticsearchException.java
@@ -641,7 +641,7 @@ public static ElasticsearchException[] guessRootCauses(Throwable t) {
                 }
             }
         }
-        return new ElasticsearchException[]{new ElasticsearchException(t.getMessage(), t) {
+        return new ElasticsearchException[]{new ElasticsearchException(ex.getMessage(), ex) {
             @Override
             protected String getExceptionName() {
                 return getExceptionName(getCause());
diff --git a/server/src/test/java/org/elasticsearch/ElasticsearchExceptionTests.java b/server/src/test/java/org/elasticsearch/ElasticsearchExceptionTests.java
index 9ed826de87cdd..570598831f944 100644
--- a/server/src/test/java/org/elasticsearch/ElasticsearchExceptionTests.java
+++ b/server/src/test/java/org/elasticsearch/ElasticsearchExceptionTests.java
@@ -163,6 +163,16 @@ public void testGuessRootCause() {
             assertEquals("illegal_argument_exception", foobars[0].getExceptionName());
         }
 
+        {
+            final ElasticsearchException[] foobars = ElasticsearchException.guessRootCauses(
+                new RemoteTransportException("abc", new IllegalArgumentException("foobar")));
+            assertEquals(foobars.length, 1);
+            assertThat(foobars[0], instanceOf(ElasticsearchException.class));
+            assertEquals("foobar", foobars[0].getMessage());
+            assertEquals(IllegalArgumentException.class, foobars[0].getCause().getClass());
+            assertEquals("illegal_argument_exception", foobars[0].getExceptionName());
+        }
+
         {
             XContentParseException inner = new XContentParseException(null, "inner");
             XContentParseException outer = new XContentParseException(null, "outer", inner);

From 80325c1e45a34cbcee869f6abafabc2b5c56fb2c Mon Sep 17 00:00:00 2001
From: Alexander Reelsen <alexander@reelsen.net>
Date: Wed, 8 Jan 2020 14:50:43 +0100
Subject: [PATCH 440/686] Sync grok patterns with logstash patterns (#50381)

In order to ensure that logstash and Elasticsearch are able to understand
the same patterns, this commit adapts to changes in logstash, adds a few
patterns and changes a few.
---
 libs/grok/src/main/java/org/elasticsearch/grok/Grok.java  | 6 +++---
 libs/grok/src/main/resources/patterns/aws                 | 2 ++
 libs/grok/src/main/resources/patterns/bind                | 3 +++
 libs/grok/src/main/resources/patterns/firewalls           | 8 +++++++-
 libs/grok/src/main/resources/patterns/grok-patterns       | 2 ++
 libs/grok/src/main/resources/patterns/java                | 4 ++--
 libs/grok/src/main/resources/patterns/linux-syslog        | 2 +-
 libs/grok/src/main/resources/patterns/maven               | 1 +
 libs/grok/src/main/resources/patterns/redis               | 2 +-
 libs/grok/src/main/resources/patterns/squid               | 4 ++++
 .../test/resources/rest-api-spec/test/ingest/120_grok.yml | 2 +-
 11 files changed, 27 insertions(+), 9 deletions(-)
 create mode 100644 libs/grok/src/main/resources/patterns/bind
 create mode 100644 libs/grok/src/main/resources/patterns/maven
 create mode 100644 libs/grok/src/main/resources/patterns/squid

diff --git a/libs/grok/src/main/java/org/elasticsearch/grok/Grok.java b/libs/grok/src/main/java/org/elasticsearch/grok/Grok.java
index f5f5a482bf493..5d5dc5d56f504 100644
--- a/libs/grok/src/main/java/org/elasticsearch/grok/Grok.java
+++ b/libs/grok/src/main/java/org/elasticsearch/grok/Grok.java
@@ -277,9 +277,9 @@ public static Map<String, String> getBuiltinPatterns() {
     private static Map<String, String> loadBuiltinPatterns() throws IOException {
         // Code for loading built-in grok patterns packaged with the jar file:
         String[] PATTERN_NAMES = new String[] {
-            "aws", "bacula", "bro", "exim", "firewalls", "grok-patterns", "haproxy",
-            "java", "junos", "linux-syslog", "mcollective-patterns", "mongodb", "nagios",
-            "postgresql", "rails", "redis", "ruby"
+            "aws", "bacula", "bind", "bro", "exim", "firewalls", "grok-patterns", "haproxy",
+            "java", "junos", "linux-syslog", "maven", "mcollective-patterns", "mongodb", "nagios",
+            "postgresql", "rails", "redis", "ruby", "squid"
         };
         Map<String, String> builtinPatterns = new HashMap<>();
         for (String pattern : PATTERN_NAMES) {
diff --git a/libs/grok/src/main/resources/patterns/aws b/libs/grok/src/main/resources/patterns/aws
index 71edbc9f2966d..2c6a2ca6d4a59 100644
--- a/libs/grok/src/main/resources/patterns/aws
+++ b/libs/grok/src/main/resources/patterns/aws
@@ -9,3 +9,5 @@ ELB_URI %{URIPROTO:proto}://(?:%{USER}(?::[^@]*)?@)?(?:%{URIHOST:urihost})?(?:%{
 ELB_REQUEST_LINE (?:%{WORD:verb} %{ELB_URI:request}(?: HTTP/%{NUMBER:httpversion})?|%{DATA:rawrequest})
 
 ELB_ACCESS_LOG %{TIMESTAMP_ISO8601:timestamp} %{NOTSPACE:elb} %{IP:clientip}:%{INT:clientport:int} (?:(%{IP:backendip}:?:%{INT:backendport:int})|-) %{NUMBER:request_processing_time:float} %{NUMBER:backend_processing_time:float} %{NUMBER:response_processing_time:float} %{INT:response:int} %{INT:backend_response:int} %{INT:received_bytes:int} %{INT:bytes:int} "%{ELB_REQUEST_LINE}"
+
+CLOUDFRONT_ACCESS_LOG (?<timestamp>%{YEAR}-%{MONTHNUM}-%{MONTHDAY}\t%{TIME})\t%{WORD:x_edge_location}\t(?:%{NUMBER:sc_bytes:int}|-)\t%{IPORHOST:clientip}\t%{WORD:cs_method}\t%{HOSTNAME:cs_host}\t%{NOTSPACE:cs_uri_stem}\t%{NUMBER:sc_status:int}\t%{GREEDYDATA:referrer}\t%{GREEDYDATA:agent}\t%{GREEDYDATA:cs_uri_query}\t%{GREEDYDATA:cookies}\t%{WORD:x_edge_result_type}\t%{NOTSPACE:x_edge_request_id}\t%{HOSTNAME:x_host_header}\t%{URIPROTO:cs_protocol}\t%{INT:cs_bytes:int}\t%{GREEDYDATA:time_taken:float}\t%{GREEDYDATA:x_forwarded_for}\t%{GREEDYDATA:ssl_protocol}\t%{GREEDYDATA:ssl_cipher}\t%{GREEDYDATA:x_edge_response_result_type}
diff --git a/libs/grok/src/main/resources/patterns/bind b/libs/grok/src/main/resources/patterns/bind
new file mode 100644
index 0000000000000..31e4414a350b6
--- /dev/null
+++ b/libs/grok/src/main/resources/patterns/bind
@@ -0,0 +1,3 @@
+BIND9_TIMESTAMP %{MONTHDAY}[-]%{MONTH}[-]%{YEAR} %{TIME}
+
+BIND9 %{BIND9_TIMESTAMP:timestamp} queries: %{LOGLEVEL:loglevel}: client %{IP:clientip}#%{POSINT:clientport} \(%{GREEDYDATA:query}\): query: %{GREEDYDATA:query} IN %{GREEDYDATA:querytype} \(%{IP:dns}\)
diff --git a/libs/grok/src/main/resources/patterns/firewalls b/libs/grok/src/main/resources/patterns/firewalls
index 03c3e5aff0cf7..0a0cbf67a6722 100644
--- a/libs/grok/src/main/resources/patterns/firewalls
+++ b/libs/grok/src/main/resources/patterns/firewalls
@@ -36,7 +36,7 @@ CISCOFW106006_106007_106010 %{CISCO_ACTION:action} %{CISCO_DIRECTION:direction}
 # ASA-3-106014
 CISCOFW106014 %{CISCO_ACTION:action} %{CISCO_DIRECTION:direction} %{WORD:protocol} src %{DATA:src_interface}:%{IP:src_ip}(\(%{DATA:src_fwuser}\))? dst %{DATA:dst_interface}:%{IP:dst_ip}(\(%{DATA:dst_fwuser}\))? \(type %{INT:icmp_type}, code %{INT:icmp_code}\)
 # ASA-6-106015
-CISCOFW106015 %{CISCO_ACTION:action} %{WORD:protocol} \(%{DATA:policy_id}\) from %{IP:src_ip}/%{INT:src_port} to %{IP:dst_ip}/%{INT:dst_port} flags %{DATA:tcp_flags}  on interface %{GREEDYDATA:interface}
+CISCOFW106015 %{CISCO_ACTION:action} %{WORD:protocol} \(%{DATA:policy_id}\) from %{IP:src_ip}/%{INT:src_port} to %{IP:dst_ip}/%{INT:dst_port} flags %{DATA:tcp_flags} on interface %{GREEDYDATA:interface}
 # ASA-1-106021
 CISCOFW106021 %{CISCO_ACTION:action} %{WORD:protocol} reverse path check from %{IP:src_ip} to %{IP:dst_ip} on interface %{GREEDYDATA:interface}
 # ASA-4-106023
@@ -45,6 +45,8 @@ CISCOFW106023 %{CISCO_ACTION:action}( protocol)? %{WORD:protocol} src %{DATA:src
 CISCOFW106100_2_3 access-list %{NOTSPACE:policy_id} %{CISCO_ACTION:action} %{WORD:protocol} for user '%{DATA:src_fwuser}' %{DATA:src_interface}/%{IP:src_ip}\(%{INT:src_port}\) -> %{DATA:dst_interface}/%{IP:dst_ip}\(%{INT:dst_port}\) hit-cnt %{INT:hit_count} %{CISCO_INTERVAL:interval} \[%{DATA:hashcode1}, %{DATA:hashcode2}\]
 # ASA-5-106100
 CISCOFW106100 access-list %{NOTSPACE:policy_id} %{CISCO_ACTION:action} %{WORD:protocol} %{DATA:src_interface}/%{IP:src_ip}\(%{INT:src_port}\)(\(%{DATA:src_fwuser}\))? -> %{DATA:dst_interface}/%{IP:dst_ip}\(%{INT:dst_port}\)(\(%{DATA:src_fwuser}\))? hit-cnt %{INT:hit_count} %{CISCO_INTERVAL:interval} \[%{DATA:hashcode1}, %{DATA:hashcode2}\]
+# ASA-5-304001
+CISCOFW304001 %{IP:src_ip}(\(%{DATA:src_fwuser}\))? Accessed URL %{IP:dst_ip}:%{GREEDYDATA:dst_url}
 # ASA-6-110002
 CISCOFW110002 %{CISCO_REASON:reason} for %{WORD:protocol} from %{DATA:src_interface}:%{IP:src_ip}/%{INT:src_port} to %{IP:dst_ip}/%{INT:dst_port}
 # ASA-6-302010
@@ -84,3 +86,7 @@ CISCOFW733100 \[\s*%{DATA:drop_type}\s*\] drop %{DATA:drop_rate_id} exceeded. Cu
 # Shorewall firewall logs
 SHOREWALL (%{SYSLOGTIMESTAMP:timestamp}) (%{WORD:nf_host}) kernel:.*Shorewall:(%{WORD:nf_action1})?:(%{WORD:nf_action2})?.*IN=(%{USERNAME:nf_in_interface})?.*(OUT= *MAC=(%{COMMONMAC:nf_dst_mac}):(%{COMMONMAC:nf_src_mac})?|OUT=%{USERNAME:nf_out_interface}).*SRC=(%{IPV4:nf_src_ip}).*DST=(%{IPV4:nf_dst_ip}).*LEN=(%{WORD:nf_len}).?*TOS=(%{WORD:nf_tos}).?*PREC=(%{WORD:nf_prec}).?*TTL=(%{INT:nf_ttl}).?*ID=(%{INT:nf_id}).?*PROTO=(%{WORD:nf_protocol}).?*SPT=(%{INT:nf_src_port}?.*DPT=%{INT:nf_dst_port}?.*)
 #== End Shorewall
+
+#== SuSE Firewall 2 ==
+SFW2 ((%{SYSLOGTIMESTAMP})|(%{TIMESTAMP_ISO8601}))\s*%{HOSTNAME}\s*kernel\S+\s*%{NAGIOSTIME}\s*SFW2\-INext\-%{NOTSPACE:nf_action}\s*IN=%{USERNAME:nf_in_interface}.*OUT=((\s*%{USERNAME:nf_out_interface})|(\s*))MAC=((%{COMMONMAC:nf_dst_mac}:%{COMMONMAC:nf_src_mac})|(\s*)).*SRC=%{IP:nf_src_ip}\s*DST=%{IP:nf_dst_ip}.*PROTO=%{WORD:nf_protocol}((.*SPT=%{INT:nf_src_port}.*DPT=%{INT:nf_dst_port}.*)|())
+#== End SuSE ==
diff --git a/libs/grok/src/main/resources/patterns/grok-patterns b/libs/grok/src/main/resources/patterns/grok-patterns
index 27bf6732790d6..d7e0afba91dee 100644
--- a/libs/grok/src/main/resources/patterns/grok-patterns
+++ b/libs/grok/src/main/resources/patterns/grok-patterns
@@ -18,6 +18,8 @@ DATA .*?
 GREEDYDATA .*
 QUOTEDSTRING (?>(?<!\\)(?>"(?>\\.|[^\\"]+)+"|""|(?>'(?>\\.|[^\\']+)+')|''|(?>`(?>\\.|[^\\`]+)+`)|``))
 UUID [A-Fa-f0-9]{8}-(?:[A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}
+# URN, allowing use of RFC 2141 section 2.3 reserved characters
+URN urn:[0-9A-Za-z][0-9A-Za-z-]{0,31}:(?:%[0-9a-fA-F]{2}|[0-9A-Za-z()+,.:=@;$_!*'/?#-])+
 
 # Networking
 MAC (?:%{CISCOMAC}|%{WINDOWSMAC}|%{COMMONMAC})
diff --git a/libs/grok/src/main/resources/patterns/java b/libs/grok/src/main/resources/patterns/java
index 01766b8ebd165..aedd615432fb5 100644
--- a/libs/grok/src/main/resources/patterns/java
+++ b/libs/grok/src/main/resources/patterns/java
@@ -1,8 +1,8 @@
 JAVACLASS (?:[a-zA-Z$_][a-zA-Z$_0-9]*\.)*[a-zA-Z$_][a-zA-Z$_0-9]*
 #Space is an allowed character to match special cases like 'Native Method' or 'Unknown Source'
 JAVAFILE (?:[A-Za-z0-9_. -]+)
-#Allow special <init> method
-JAVAMETHOD (?:(<init>)|[a-zA-Z$_][a-zA-Z$_0-9]*)
+#Allow special <init>, <clinit> methods
+JAVAMETHOD (?:(<(?:cl)?init>)|[a-zA-Z$_][a-zA-Z$_0-9]*)
 #Line number is optional in special cases 'Native method' or 'Unknown source'
 JAVASTACKTRACEPART %{SPACE}at %{JAVACLASS:class}\.%{JAVAMETHOD:method}\(%{JAVAFILE:file}(?::%{NUMBER:line})?\)
 # Java Logs
diff --git a/libs/grok/src/main/resources/patterns/linux-syslog b/libs/grok/src/main/resources/patterns/linux-syslog
index dcffb41ba8fef..a03a6536f9dee 100644
--- a/libs/grok/src/main/resources/patterns/linux-syslog
+++ b/libs/grok/src/main/resources/patterns/linux-syslog
@@ -11,6 +11,6 @@ SYSLOGLINE %{SYSLOGBASE2} %{GREEDYDATA:message}
 # IETF 5424 syslog(8) format (see http://www.rfc-editor.org/info/rfc5424)
 SYSLOG5424PRI <%{NONNEGINT:syslog5424_pri}>
 SYSLOG5424SD \[%{DATA}\]+
-SYSLOG5424BASE %{SYSLOG5424PRI}%{NONNEGINT:syslog5424_ver} +(?:%{TIMESTAMP_ISO8601:syslog5424_ts}|-) +(?:%{HOSTNAME:syslog5424_host}|-) +(-|%{SYSLOG5424PRINTASCII:syslog5424_app}) +(-|%{SYSLOG5424PRINTASCII:syslog5424_proc}) +(-|%{SYSLOG5424PRINTASCII:syslog5424_msgid}) +(?:%{SYSLOG5424SD:syslog5424_sd}|-|)
+SYSLOG5424BASE %{SYSLOG5424PRI}%{NONNEGINT:syslog5424_ver} +(?:%{TIMESTAMP_ISO8601:syslog5424_ts}|-) +(?:%{IPORHOST:syslog5424_host}|-) +(-|%{SYSLOG5424PRINTASCII:syslog5424_app}) +(-|%{SYSLOG5424PRINTASCII:syslog5424_proc}) +(-|%{SYSLOG5424PRINTASCII:syslog5424_msgid}) +(?:%{SYSLOG5424SD:syslog5424_sd}|-|)
 
 SYSLOG5424LINE %{SYSLOG5424BASE} +%{GREEDYDATA:syslog5424_msg}
diff --git a/libs/grok/src/main/resources/patterns/maven b/libs/grok/src/main/resources/patterns/maven
new file mode 100644
index 0000000000000..f1dc808871026
--- /dev/null
+++ b/libs/grok/src/main/resources/patterns/maven
@@ -0,0 +1 @@
+MAVEN_VERSION (?:(\d+)\.)?(?:(\d+)\.)?(\*|\d+)(?:[.-](RELEASE|SNAPSHOT))?
diff --git a/libs/grok/src/main/resources/patterns/redis b/libs/grok/src/main/resources/patterns/redis
index 8655c4f043e69..341a330665dc6 100644
--- a/libs/grok/src/main/resources/patterns/redis
+++ b/libs/grok/src/main/resources/patterns/redis
@@ -1,3 +1,3 @@
 REDISTIMESTAMP %{MONTHDAY} %{MONTH} %{TIME}
 REDISLOG \[%{POSINT:pid}\] %{REDISTIMESTAMP:timestamp} \* 
-
+REDISMONLOG %{NUMBER:timestamp} \[%{INT:database} %{IP:client}:%{NUMBER:port}\] "%{WORD:command}"\s?%{GREEDYDATA:params}
diff --git a/libs/grok/src/main/resources/patterns/squid b/libs/grok/src/main/resources/patterns/squid
new file mode 100644
index 0000000000000..238fff1fda2ff
--- /dev/null
+++ b/libs/grok/src/main/resources/patterns/squid
@@ -0,0 +1,4 @@
+# Pattern squid3
+# Documentation of squid3 logs formats can be found at the following link:
+# http://wiki.squid-cache.org/Features/LogFormat
+SQUID3 %{NUMBER:timestamp}\s+%{NUMBER:duration}\s%{IP:client_address}\s%{WORD:cache_result}/%{POSINT:status_code}\s%{NUMBER:bytes}\s%{WORD:request_method}\s%{NOTSPACE:url}\s(%{NOTSPACE:user}|-)\s%{WORD:hierarchy_code}/%{IPORHOST:server}\s%{NOTSPACE:content_type}
diff --git a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/120_grok.yml b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/120_grok.yml
index fa2280e0a11d1..c0aec0e3d7392 100644
--- a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/120_grok.yml
+++ b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/120_grok.yml
@@ -152,5 +152,5 @@ teardown:
 "Test Grok Patterns Retrieval":
   - do:
       ingest.processor_grok: {}
-  - length: { patterns: 303 }
+  - length: { patterns: 312 }
   - match: { patterns.PATH: "(?:%{UNIXPATH}|%{WINPATH})" }

From 8d218d703f88bdd6ba77e9cad25b29b789eff9e2 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 8 Jan 2020 07:55:21 -0600
Subject: [PATCH 441/686] [DOCS] Fix typo in mapping date format docs

---
 docs/reference/mapping/params/format.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/mapping/params/format.asciidoc b/docs/reference/mapping/params/format.asciidoc
index e89e037ea970d..15a792279300e 100644
--- a/docs/reference/mapping/params/format.asciidoc
+++ b/docs/reference/mapping/params/format.asciidoc
@@ -66,7 +66,7 @@ The following tables lists all the defaults ISO formats supported:
 
 [[strict-date-time]]`date_optional_time` or `strict_date_optional_time`::
 
-    A generic ISO datetime parser where the date, in `year_month_day format`, is
+    A generic ISO datetime parser where the date, in `year_month_day` format, is
     mandatory and the time, separated by `T`, is optional.
     Examples: `yyyy-MM-dd'T'HH:mm:ss.SSSZ` or  `yyyy-MM-dd`.
 

From a2d6ca4ae39462d36d6840e6d72f6345ec940fbc Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Wed, 8 Jan 2020 15:07:19 +0100
Subject: [PATCH 442/686] Fix and Reenable SnapshotTool Minio Tests (#50736)

This solves half of the problem in #46813 by moving the S3
tests to using the shared minio fixture so we at least have
some non-3rd-party, constantly running coverage on these tests.
---
 plugins/repository-s3/build.gradle            |  2 +-
 .../fixtures/minio-fixture/docker-compose.yml | 12 ++++++
 x-pack/snapshot-tool/qa/s3/build.gradle       | 39 ++++---------------
 x-pack/snapshot-tool/qa/s3/docker-compose.yml |  9 -----
 4 files changed, 21 insertions(+), 41 deletions(-)
 delete mode 100644 x-pack/snapshot-tool/qa/s3/docker-compose.yml

diff --git a/plugins/repository-s3/build.gradle b/plugins/repository-s3/build.gradle
index e26fa43188b44..34660f6b2b54b 100644
--- a/plugins/repository-s3/build.gradle
+++ b/plugins/repository-s3/build.gradle
@@ -141,7 +141,7 @@ task thirdPartyTest(type: Test) {
 }
 
 if (useFixture) {
-  testFixtures.useFixture(':test:fixtures:minio-fixture')
+  testFixtures.useFixture(':test:fixtures:minio-fixture', 'minio-fixture')
 
   def minioAddress = {
     int minioPort = project(':test:fixtures:minio-fixture').postProcessFixture.ext."test.fixtures.minio-fixture.tcp.9000"
diff --git a/test/fixtures/minio-fixture/docker-compose.yml b/test/fixtures/minio-fixture/docker-compose.yml
index 5cd14ceec8e29..e4df64ad75fcb 100644
--- a/test/fixtures/minio-fixture/docker-compose.yml
+++ b/test/fixtures/minio-fixture/docker-compose.yml
@@ -11,3 +11,15 @@ services:
     ports:
       - "9000"
     command: ["server", "/minio/data"]
+
+  minio-fixture-for-snapshot-tool:
+      build:
+        context: .
+        args:
+          bucket: "bucket"
+          accessKey: "sn_tool_access_key"
+          secretKey: "sn_tool_secret_key"
+        dockerfile: Dockerfile
+      ports:
+        - "9000"
+      command: ["server", "/minio/data"]
diff --git a/x-pack/snapshot-tool/qa/s3/build.gradle b/x-pack/snapshot-tool/qa/s3/build.gradle
index 7d4e04e13c6cc..9f97279b109cb 100644
--- a/x-pack/snapshot-tool/qa/s3/build.gradle
+++ b/x-pack/snapshot-tool/qa/s3/build.gradle
@@ -4,6 +4,7 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 apply plugin: 'elasticsearch.build'
+apply plugin: 'elasticsearch.test.fixtures'
 
 dependencies {
   compile project(":plugins:repository-s3")
@@ -26,9 +27,9 @@ String s3PermanentBucket = System.getenv("amazon_s3_bucket")
 String s3PermanentBasePath = System.getenv("amazon_s3_base_path")
 
 if (!s3PermanentAccessKey && !s3PermanentSecretKey && !s3PermanentBucket && !s3PermanentBasePath) {
-  s3PermanentAccessKey = 's3_integration_test_permanent_access_key'
-  s3PermanentSecretKey = 's3_integration_test_permanent_secret_key'
-  s3PermanentBucket = 'permanent-bucket-test'
+  s3PermanentAccessKey = 'sn_tool_access_key'
+  s3PermanentSecretKey = 'sn_tool_secret_key'
+  s3PermanentBucket = 'bucket'
   s3PermanentBasePath = 'integration_test'
 
   useS3Fixture = true
@@ -48,41 +49,17 @@ task thirdPartyTest(type: Test) {
 }
 
 if (useS3Fixture) {
-  thirdPartyTest.enabled = false;
   testingConventions.enabled = false;
-  /*
-
-  See: https://github.com/elastic/elasticsearch/issues/46813 Fails with --parallel
-
-  apply plugin: 'elasticsearch.test.fixtures'
-
-  testFixtures.useFixture()
-
-  task writeDockerFile {
-    File minioDockerfile = new File("${project.buildDir}/minio-docker/Dockerfile")
-    outputs.file(minioDockerfile)
-    doLast {
-      minioDockerfile.parentFile.mkdirs()
-      minioDockerfile.text =
-        "FROM minio/minio:RELEASE.2019-01-23T23-18-58Z\n" +
-          "RUN mkdir -p /minio/data/${s3PermanentBucket}\n" +
-          "ENV MINIO_ACCESS_KEY ${s3PermanentAccessKey}\n" +
-          "ENV MINIO_SECRET_KEY ${s3PermanentSecretKey}"
-    }
-  }
-
-  preProcessFixture {
-    dependsOn(writeDockerFile)
-  }
+  testFixtures.useFixture(':test:fixtures:minio-fixture', "minio-fixture-for-snapshot-tool")
 
   def minioAddress = {
-    int minioPort = postProcessFixture.ext."test.fixtures.minio-fixture.tcp.9000"
+    int minioPort = project(':test:fixtures:minio-fixture').postProcessFixture.ext."test.fixtures.minio-fixture-for-snapshot-tool.tcp.9000"
     assert minioPort > 0
     'http://127.0.0.1:' + minioPort
   }
 
   thirdPartyTest {
-    dependsOn tasks.postProcessFixture
+    dependsOn project(':test:fixtures:minio-fixture').postProcessFixture
     nonInputProperties.systemProperty 'test.s3.endpoint', "${-> minioAddress.call()}"
   }
 
@@ -91,7 +68,7 @@ if (useS3Fixture) {
       throw new IllegalStateException("Tried to run third party tests but not all of the necessary environment variables 'amazon_s3_access_key', " +
         "'amazon_s3_secret_key', 'amazon_s3_bucket', and 'amazon_s3_base_path' are set.");
     }
-  }*/
+  }
 }
 
 check.dependsOn(thirdPartyTest)
diff --git a/x-pack/snapshot-tool/qa/s3/docker-compose.yml b/x-pack/snapshot-tool/qa/s3/docker-compose.yml
deleted file mode 100644
index e44750550e271..0000000000000
--- a/x-pack/snapshot-tool/qa/s3/docker-compose.yml
+++ /dev/null
@@ -1,9 +0,0 @@
-version: '3'
-services:
-  minio-fixture:
-    build:
-      context: ./build/minio-docker
-      dockerfile: Dockerfile
-    ports:
-      - "9000"
-    command: ["server", "/minio/data"]
\ No newline at end of file

From ce24d7283d9b2a29018857589d75f731a9a8ca4f Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Wed, 8 Jan 2020 16:20:06 +0100
Subject: [PATCH 443/686] Disable BW compatibility tests for #49976. (#50744)

---
 build.gradle | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/build.gradle b/build.gradle
index b03bb7e5a3794..463634e1d78d4 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = true
-final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = false
+final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/50333" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")

From 3f3f4eecdc1d985c0154da02cca035d1ae463e48 Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Wed, 8 Jan 2020 17:10:38 +0100
Subject: [PATCH 444/686] Upgrade to Lucene 8.4.0. (#50518)

---
 buildSrc/version.properties                                     | 2 +-
 .../lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1      | 1 -
 .../lang-expression/licenses/lucene-expressions-8.4.0.jar.sha1  | 1 +
 .../lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1    | 1 -
 .../analysis-icu/licenses/lucene-analyzers-icu-8.4.0.jar.sha1   | 1 +
 ...ucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 .../licenses/lucene-analyzers-kuromoji-8.4.0.jar.sha1           | 1 +
 .../lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1   | 1 -
 .../analysis-nori/licenses/lucene-analyzers-nori-8.4.0.jar.sha1 | 1 +
 ...ucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 .../licenses/lucene-analyzers-phonetic-8.4.0.jar.sha1           | 1 +
 ...lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 .../licenses/lucene-analyzers-smartcn-8.4.0.jar.sha1            | 1 +
 ...lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 .../licenses/lucene-analyzers-stempel-8.4.0.jar.sha1            | 1 +
 ...ene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 .../licenses/lucene-analyzers-morfologik-8.4.0.jar.sha1         | 1 +
 .../lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 server/licenses/lucene-analyzers-common-8.4.0.jar.sha1          | 1 +
 .../lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1  | 1 -
 server/licenses/lucene-backward-codecs-8.4.0.jar.sha1           | 1 +
 server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 server/licenses/lucene-core-8.4.0.jar.sha1                      | 1 +
 .../lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1         | 1 -
 server/licenses/lucene-grouping-8.4.0.jar.sha1                  | 1 +
 .../lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1      | 1 -
 server/licenses/lucene-highlighter-8.4.0.jar.sha1               | 1 +
 server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 server/licenses/lucene-join-8.4.0.jar.sha1                      | 1 +
 .../licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1  | 1 -
 server/licenses/lucene-memory-8.4.0.jar.sha1                    | 1 +
 server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 server/licenses/lucene-misc-8.4.0.jar.sha1                      | 1 +
 .../licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 server/licenses/lucene-queries-8.4.0.jar.sha1                   | 1 +
 .../lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1      | 1 -
 server/licenses/lucene-queryparser-8.4.0.jar.sha1               | 1 +
 .../licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 server/licenses/lucene-sandbox-8.4.0.jar.sha1                   | 1 +
 .../licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 server/licenses/lucene-spatial-8.4.0.jar.sha1                   | 1 +
 .../lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1   | 1 -
 server/licenses/lucene-spatial-extras-8.4.0.jar.sha1            | 1 +
 .../lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1        | 1 -
 server/licenses/lucene-spatial3d-8.4.0.jar.sha1                 | 1 +
 .../licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1 | 1 -
 server/licenses/lucene-suggest-8.4.0.jar.sha1                   | 1 +
 .../licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1    | 1 -
 .../plugin/sql/sql-action/licenses/lucene-core-8.4.0.jar.sha1   | 1 +
 49 files changed, 25 insertions(+), 25 deletions(-)
 delete mode 100644 modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 modules/lang-expression/licenses/lucene-expressions-8.4.0.jar.sha1
 delete mode 100644 plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0.jar.sha1
 delete mode 100644 plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0.jar.sha1
 delete mode 100644 plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0.jar.sha1
 delete mode 100644 plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0.jar.sha1
 delete mode 100644 plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0.jar.sha1
 delete mode 100644 plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0.jar.sha1
 delete mode 100644 plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-analyzers-common-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-backward-codecs-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-core-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-grouping-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-highlighter-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-join-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-memory-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-misc-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-queries-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-queryparser-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-sandbox-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-spatial-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-spatial-extras-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-spatial3d-8.4.0.jar.sha1
 delete mode 100644 server/licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 server/licenses/lucene-suggest-8.4.0.jar.sha1
 delete mode 100644 x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
 create mode 100644 x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0.jar.sha1

diff --git a/buildSrc/version.properties b/buildSrc/version.properties
index c7e957939fc55..24eb62181aeee 100644
--- a/buildSrc/version.properties
+++ b/buildSrc/version.properties
@@ -1,5 +1,5 @@
 elasticsearch     = 8.0.0
-lucene            = 8.4.0-snapshot-08b8d116f8f
+lucene            = 8.4.0
 
 bundled_jdk_vendor = adoptopenjdk
 bundled_jdk = 13.0.1+9
diff --git a/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 0f2b32ad7ef61..0000000000000
--- a/modules/lang-expression/licenses/lucene-expressions-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-a02eaef7b91b383f7ca43f4a33726bd089c0a36e
\ No newline at end of file
diff --git a/modules/lang-expression/licenses/lucene-expressions-8.4.0.jar.sha1 b/modules/lang-expression/licenses/lucene-expressions-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..bbc690f1ea7fd
--- /dev/null
+++ b/modules/lang-expression/licenses/lucene-expressions-8.4.0.jar.sha1
@@ -0,0 +1 @@
+2aeb62a1a6278c2707b9a491c74a102c1f11f06e
\ No newline at end of file
diff --git a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 058b07b9dba7d..0000000000000
--- a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-7c7054c935661dde19afeb0b9c7b8bda65c0dafe
\ No newline at end of file
diff --git a/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0.jar.sha1 b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..93f8a6f96d956
--- /dev/null
+++ b/plugins/analysis-icu/licenses/lucene-analyzers-icu-8.4.0.jar.sha1
@@ -0,0 +1 @@
+8e02317f9253512b0d4fc8d5c41e2b8c647955d2
\ No newline at end of file
diff --git a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index decd6216aeece..0000000000000
--- a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-4dc8d6f78242fc384fd03a2a2e93d1737b0d3c11
\ No newline at end of file
diff --git a/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0.jar.sha1 b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..472361255ac22
--- /dev/null
+++ b/plugins/analysis-kuromoji/licenses/lucene-analyzers-kuromoji-8.4.0.jar.sha1
@@ -0,0 +1 @@
+5ccb38f67ac1895d25c7c84abe8805aef5526790
\ No newline at end of file
diff --git a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 3c34ab4664b7c..0000000000000
--- a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-40baaa81cb2b986d086b0ebc648415da84c15552
\ No newline at end of file
diff --git a/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0.jar.sha1 b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..4548545c03f77
--- /dev/null
+++ b/plugins/analysis-nori/licenses/lucene-analyzers-nori-8.4.0.jar.sha1
@@ -0,0 +1 @@
+7f57aff713c474ffb6aba1bae6d9374a1a184114
\ No newline at end of file
diff --git a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 623f9f1aefd26..0000000000000
--- a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-8739dcdb8ca9fdebb93f6e696626119d30d5cb58
\ No newline at end of file
diff --git a/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0.jar.sha1 b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..328edd2349da8
--- /dev/null
+++ b/plugins/analysis-phonetic/licenses/lucene-analyzers-phonetic-8.4.0.jar.sha1
@@ -0,0 +1 @@
+e47cb4efd4e9e071e0563dd44f1759ea1e712ca7
\ No newline at end of file
diff --git a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 4b4d838d03fbf..0000000000000
--- a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-74a27bf3c523156fadc0159cd1311388505d6cae
\ No newline at end of file
diff --git a/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0.jar.sha1 b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..8bfaf6afd1189
--- /dev/null
+++ b/plugins/analysis-smartcn/licenses/lucene-analyzers-smartcn-8.4.0.jar.sha1
@@ -0,0 +1 @@
+39a8ecf0d875630d04972208e00adf930500f52b
\ No newline at end of file
diff --git a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index f5510f6f731ee..0000000000000
--- a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-374d411635868394719f4d328a26dbc6a9b0eded
\ No newline at end of file
diff --git a/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0.jar.sha1 b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..d205dc486bd53
--- /dev/null
+++ b/plugins/analysis-stempel/licenses/lucene-analyzers-stempel-8.4.0.jar.sha1
@@ -0,0 +1 @@
+c9815fc970936940ab08880e0d34c8cff169ee4d
\ No newline at end of file
diff --git a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 5c9510b012765..0000000000000
--- a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-1cf79c772b6cfecc80137bcde48b7a5432ee5028
\ No newline at end of file
diff --git a/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0.jar.sha1 b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..df505b026a076
--- /dev/null
+++ b/plugins/analysis-ukrainian/licenses/lucene-analyzers-morfologik-8.4.0.jar.sha1
@@ -0,0 +1 @@
+f389d3873ee33b5dd432077e201a541c7a16772a
\ No newline at end of file
diff --git a/server/licenses/lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 03841938296d2..0000000000000
--- a/server/licenses/lucene-analyzers-common-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-dc14a70f44c2597e237f37f096d6b8c2db8cd335
\ No newline at end of file
diff --git a/server/licenses/lucene-analyzers-common-8.4.0.jar.sha1 b/server/licenses/lucene-analyzers-common-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..36284f82e001a
--- /dev/null
+++ b/server/licenses/lucene-analyzers-common-8.4.0.jar.sha1
@@ -0,0 +1 @@
+79d7792942fa009316de2d7d1a4d7e8b33548947
\ No newline at end of file
diff --git a/server/licenses/lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 76fbf985dc8c8..0000000000000
--- a/server/licenses/lucene-backward-codecs-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-535e6d650fe66ef8df9fd03ad48170f6c0e7c4cf
\ No newline at end of file
diff --git a/server/licenses/lucene-backward-codecs-8.4.0.jar.sha1 b/server/licenses/lucene-backward-codecs-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..ccbc05fbd616e
--- /dev/null
+++ b/server/licenses/lucene-backward-codecs-8.4.0.jar.sha1
@@ -0,0 +1 @@
+6604030f7da573a8c00641f9c7deef6c143b6022
\ No newline at end of file
diff --git a/server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index cb9ce3f8db761..0000000000000
--- a/server/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-2d20a2d0f96f4337665b3043e627df6ce83ed41c
\ No newline at end of file
diff --git a/server/licenses/lucene-core-8.4.0.jar.sha1 b/server/licenses/lucene-core-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..26c03c72e2b05
--- /dev/null
+++ b/server/licenses/lucene-core-8.4.0.jar.sha1
@@ -0,0 +1 @@
+2746f9ec96f9ce3a345b11f03751136073f7869f
\ No newline at end of file
diff --git a/server/licenses/lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 10b0df8788174..0000000000000
--- a/server/licenses/lucene-grouping-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-cb9218eb5a5c9ef84377f9533e8a2d13c55ed71b
\ No newline at end of file
diff --git a/server/licenses/lucene-grouping-8.4.0.jar.sha1 b/server/licenses/lucene-grouping-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..f528d62545a73
--- /dev/null
+++ b/server/licenses/lucene-grouping-8.4.0.jar.sha1
@@ -0,0 +1 @@
+f73773fc39d43df7661609b9f7a733ddfd091af7
\ No newline at end of file
diff --git a/server/licenses/lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 9ae147d34b61a..0000000000000
--- a/server/licenses/lucene-highlighter-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-0cbb63e519f3e0acf7bdbc6dcd6c2bc4bb003b70
\ No newline at end of file
diff --git a/server/licenses/lucene-highlighter-8.4.0.jar.sha1 b/server/licenses/lucene-highlighter-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..2aa1e48b6e83a
--- /dev/null
+++ b/server/licenses/lucene-highlighter-8.4.0.jar.sha1
@@ -0,0 +1 @@
+be8a20787124cf52c56c5928ef970df2d8a26f51
\ No newline at end of file
diff --git a/server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 59cb050fe465f..0000000000000
--- a/server/licenses/lucene-join-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-0f843b878752449f345d6fd5048f62b1c0688fca
\ No newline at end of file
diff --git a/server/licenses/lucene-join-8.4.0.jar.sha1 b/server/licenses/lucene-join-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..5602b21285cd0
--- /dev/null
+++ b/server/licenses/lucene-join-8.4.0.jar.sha1
@@ -0,0 +1 @@
+8ec1dce97ba5b616e165068225bba873179482e9
\ No newline at end of file
diff --git a/server/licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 78951b539c098..0000000000000
--- a/server/licenses/lucene-memory-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-e5583564c96d24d7293574efbd5d55d5e5d55f58
\ No newline at end of file
diff --git a/server/licenses/lucene-memory-8.4.0.jar.sha1 b/server/licenses/lucene-memory-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..47340d67173a6
--- /dev/null
+++ b/server/licenses/lucene-memory-8.4.0.jar.sha1
@@ -0,0 +1 @@
+dff1e225fe6bfdf7853663bc48831e9714bf035e
\ No newline at end of file
diff --git a/server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 86a36ef22e4b5..0000000000000
--- a/server/licenses/lucene-misc-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-1a20042a3c79e86b0c95f7bc19bdb835e4fba74e
\ No newline at end of file
diff --git a/server/licenses/lucene-misc-8.4.0.jar.sha1 b/server/licenses/lucene-misc-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..67ec2a5fdb020
--- /dev/null
+++ b/server/licenses/lucene-misc-8.4.0.jar.sha1
@@ -0,0 +1 @@
+ebe2549568386d5c289ec0eb738172f1a0445259
\ No newline at end of file
diff --git a/server/licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 8e7766918327b..0000000000000
--- a/server/licenses/lucene-queries-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-60f1ba706bde727fcbb333e8bc52d0cf53daa776
\ No newline at end of file
diff --git a/server/licenses/lucene-queries-8.4.0.jar.sha1 b/server/licenses/lucene-queries-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..f0efdfcd3ab8a
--- /dev/null
+++ b/server/licenses/lucene-queries-8.4.0.jar.sha1
@@ -0,0 +1 @@
+9d5fdc88f91586bf5d1afa13b9a77302c39b5e7c
\ No newline at end of file
diff --git a/server/licenses/lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index eec0b037dfebd..0000000000000
--- a/server/licenses/lucene-queryparser-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-a99fbcf01d2ee081b04ed7e173c71bcc1f2c4a83
\ No newline at end of file
diff --git a/server/licenses/lucene-queryparser-8.4.0.jar.sha1 b/server/licenses/lucene-queryparser-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..3ded202a1e7d3
--- /dev/null
+++ b/server/licenses/lucene-queryparser-8.4.0.jar.sha1
@@ -0,0 +1 @@
+ab7c7c3c823cb2f8fb1b54fdc82b3e133e8e8344
\ No newline at end of file
diff --git a/server/licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 66881bedef5da..0000000000000
--- a/server/licenses/lucene-sandbox-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-613057333e965ada682126b7e97d8d7fb6ab7db8
\ No newline at end of file
diff --git a/server/licenses/lucene-sandbox-8.4.0.jar.sha1 b/server/licenses/lucene-sandbox-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..e93ec706b0dc3
--- /dev/null
+++ b/server/licenses/lucene-sandbox-8.4.0.jar.sha1
@@ -0,0 +1 @@
+bc34429b8d1a620c58639f376bee9ba425a035d3
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 6b7f37fa76630..0000000000000
--- a/server/licenses/lucene-spatial-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-2727fc11cb9d503388a8fb09159de8db17772de9
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-8.4.0.jar.sha1 b/server/licenses/lucene-spatial-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..1fed70c1ead79
--- /dev/null
+++ b/server/licenses/lucene-spatial-8.4.0.jar.sha1
@@ -0,0 +1 @@
+0bc8d9f00bd34806bc82d01390855ef9dcbea85b
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 4c480aff42ae6..0000000000000
--- a/server/licenses/lucene-spatial-extras-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-7bd96ac0db2bf246e8a5636409201fa1ca1619fe
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial-extras-8.4.0.jar.sha1 b/server/licenses/lucene-spatial-extras-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..80d598292587d
--- /dev/null
+++ b/server/licenses/lucene-spatial-extras-8.4.0.jar.sha1
@@ -0,0 +1 @@
+a1e978879d35af3590549437b80679b5c00f27d6
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 1bb87cc3f586c..0000000000000
--- a/server/licenses/lucene-spatial3d-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-f4c57666b25335ff797c76932563b3f4e33f138d
\ No newline at end of file
diff --git a/server/licenses/lucene-spatial3d-8.4.0.jar.sha1 b/server/licenses/lucene-spatial3d-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..93e13df548a20
--- /dev/null
+++ b/server/licenses/lucene-spatial3d-8.4.0.jar.sha1
@@ -0,0 +1 @@
+1000c919125bb13f265b101341c34bb5af814fd3
\ No newline at end of file
diff --git a/server/licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/server/licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index 31d4b678e0536..0000000000000
--- a/server/licenses/lucene-suggest-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-2351b9abaa5fed697217853db44c038070660b75
\ No newline at end of file
diff --git a/server/licenses/lucene-suggest-8.4.0.jar.sha1 b/server/licenses/lucene-suggest-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..823223531e460
--- /dev/null
+++ b/server/licenses/lucene-suggest-8.4.0.jar.sha1
@@ -0,0 +1 @@
+488e5cfdd4d2d30b161fc45819a82a6984eb0f99
\ No newline at end of file
diff --git a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1 b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
deleted file mode 100644
index cb9ce3f8db761..0000000000000
--- a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0-snapshot-08b8d116f8f.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-2d20a2d0f96f4337665b3043e627df6ce83ed41c
\ No newline at end of file
diff --git a/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0.jar.sha1 b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0.jar.sha1
new file mode 100644
index 0000000000000..26c03c72e2b05
--- /dev/null
+++ b/x-pack/plugin/sql/sql-action/licenses/lucene-core-8.4.0.jar.sha1
@@ -0,0 +1 @@
+2746f9ec96f9ce3a345b11f03751136073f7869f
\ No newline at end of file

From 1d882c99fb5a64090f42bd3db96e33ae5226194c Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Wed, 8 Jan 2020 17:12:27 +0100
Subject: [PATCH 445/686] Reenable bw tests after merging #50333. (#50746)

PR #50333 has been merged.
---
 build.gradle                                                  | 4 ++--
 .../main/resources/rest-api-spec/test/field_caps/20_meta.yml  | 2 +-
 .../rest-api-spec/test/indices.put_mapping/10_basic.yml       | 2 +-
 .../org/elasticsearch/action/fieldcaps/FieldCapabilities.java | 4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/build.gradle b/build.gradle
index 463634e1d78d4..b03bb7e5a3794 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = false
-final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/50333" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = true
+final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/20_meta.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/20_meta.yml
index c2d565278717a..f299e72d00d0e 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/20_meta.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/field_caps/20_meta.yml
@@ -2,7 +2,7 @@
 "Merge metadata across multiple indices":
 
   - skip:
-      version: " - 7.99.99"
+      version: " - 7.5.99"
       reason: Metadata support was added in 7.6
 
   - do:
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.put_mapping/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.put_mapping/10_basic.yml
index 3a4044c8d71ad..6e089e3723079 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.put_mapping/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.put_mapping/10_basic.yml
@@ -113,7 +113,7 @@
 "Update per-field metadata":
 
   - skip:
-      version:     " - 7.99.99"
+      version:     " - 7.5.99"
       reason:      "Per-field meta was introduced in 7.6"
 
   - do:
diff --git a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
index 9631463c436c4..543a7dd396651 100644
--- a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
+++ b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilities.java
@@ -125,7 +125,7 @@ public FieldCapabilities(StreamInput in) throws IOException {
         this.indices = in.readOptionalStringArray();
         this.nonSearchableIndices = in.readOptionalStringArray();
         this.nonAggregatableIndices = in.readOptionalStringArray();
-        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
             meta = in.readMap(StreamInput::readString, i -> i.readSet(StreamInput::readString));
         } else {
             meta = Collections.emptyMap();
@@ -141,7 +141,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeOptionalStringArray(indices);
         out.writeOptionalStringArray(nonSearchableIndices);
         out.writeOptionalStringArray(nonAggregatableIndices);
-        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             out.writeMap(meta, StreamOutput::writeString, (o, set) -> o.writeCollection(set, StreamOutput::writeString));
         }
     }

From bca8790a0941d06c8a505fb3bca9b58175c70116 Mon Sep 17 00:00:00 2001
From: blueSky1825821 <1664637427@qq.com>
Date: Thu, 9 Jan 2020 00:47:11 +0800
Subject: [PATCH 446/686] =?UTF-8?q?[Docs]=C2=A0Update=20similarity.asciido?=
 =?UTF-8?q?c=20(#50719)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

DFRSimilarity -> DFR similarity
---
 docs/reference/index-modules/similarity.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/index-modules/similarity.asciidoc b/docs/reference/index-modules/similarity.asciidoc
index f5a1d41f6d67e..3fbbc746b2ed7 100644
--- a/docs/reference/index-modules/similarity.asciidoc
+++ b/docs/reference/index-modules/similarity.asciidoc
@@ -38,7 +38,7 @@ PUT /index
 }
 --------------------------------------------------
 
-Here we configure the DFRSimilarity so it can be referenced as
+Here we configure the DFR similarity so it can be referenced as
 `my_similarity` in mappings as is illustrate in the below example:
 
 [source,console]

From 3c37c164da2a1930b585ed2051ff8dc8e88d1cdb Mon Sep 17 00:00:00 2001
From: Valentin Crettaz <valentin.crettaz@consulthys.com>
Date: Wed, 8 Jan 2020 17:50:03 +0100
Subject: [PATCH 447/686] [DOCS] Fixed typos (_op => op) in Painless context
 docs (#50301)

---
 .../painless-contexts/painless-reindex-context.asciidoc     | 6 +++---
 .../painless-update-by-query-context.asciidoc               | 6 +++---
 .../painless-contexts/painless-update-context.asciidoc      | 6 +++---
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/painless/painless-contexts/painless-reindex-context.asciidoc b/docs/painless/painless-contexts/painless-reindex-context.asciidoc
index 54791f2fa50db..eea529bc3e7f5 100644
--- a/docs/painless/painless-contexts/painless-reindex-context.asciidoc
+++ b/docs/painless/painless-contexts/painless-reindex-context.asciidoc
@@ -10,7 +10,7 @@ reindexed into a target index.
 `params` (`Map`, read-only)::
         User-defined parameters passed in as part of the query.
 
-`ctx['_op']` (`String`)::
+`ctx['op']` (`String`)::
         The name of the operation.
 
 {ref}/mapping-routing-field.html[`ctx['_routing']`] (`String`)::
@@ -34,7 +34,7 @@ reindexed into a target index.
 
 *Side Effects*
 
-`ctx['_op']`::
+`ctx['op']`::
         Use the default of `index` to update a document. Set to `none` to
         specify no operation or `delete` to delete the current document from
         the index.
@@ -65,4 +65,4 @@ reindexed into a target index.
 
 *API*
 
-The standard <<painless-api-reference-shared, Painless API>> is available.
\ No newline at end of file
+The standard <<painless-api-reference-shared, Painless API>> is available.
diff --git a/docs/painless/painless-contexts/painless-update-by-query-context.asciidoc b/docs/painless/painless-contexts/painless-update-by-query-context.asciidoc
index 371e4b81d41d3..ff2409b704268 100644
--- a/docs/painless/painless-contexts/painless-update-by-query-context.asciidoc
+++ b/docs/painless/painless-contexts/painless-update-by-query-context.asciidoc
@@ -11,7 +11,7 @@ result of query.
 `params` (`Map`, read-only)::
         User-defined parameters passed in as part of the query.
 
-`ctx['_op']` (`String`)::
+`ctx['op']` (`String`)::
         The name of the operation.
 
 {ref}/mapping-routing-field.html[`ctx['_routing']`] (`String`, read-only)::
@@ -35,7 +35,7 @@ result of query.
 
 *Side Effects*
 
-`ctx['_op']`::
+`ctx['op']`::
         Use the default of `index` to update a document. Set to `none` to
         specify no operation or `delete` to delete the current document from
         the index.
@@ -91,4 +91,4 @@ POST /seats/_update_by_query
     }
 }
 --------------------------------------------------
-// TEST[setup:seats]
\ No newline at end of file
+// TEST[setup:seats]
diff --git a/docs/painless/painless-contexts/painless-update-context.asciidoc b/docs/painless/painless-contexts/painless-update-context.asciidoc
index 574e4dc322c0a..d7c4d67ffdc44 100644
--- a/docs/painless/painless-contexts/painless-update-context.asciidoc
+++ b/docs/painless/painless-contexts/painless-update-context.asciidoc
@@ -9,7 +9,7 @@ add, modify, or delete fields within a single document.
 `params` (`Map`, read-only)::
         User-defined parameters passed in as part of the query.
 
-`ctx['_op']` (`String`)::
+`ctx['op']` (`String`)::
         The name of the operation.
 
 {ref}/mapping-routing-field.html[`ctx['_routing']`] (`String`, read-only)::
@@ -36,7 +36,7 @@ add, modify, or delete fields within a single document.
 
 *Side Effects*
 
-`ctx['_op']`::
+`ctx['op']`::
         Use the default of `index` to update a document. Set to `none` to
         specify no operation or `delete` to delete the current document from
         the index.
@@ -75,4 +75,4 @@ POST /seats/_update/3
     }
 }
 --------------------------------------------------
-// TEST[setup:seats]
\ No newline at end of file
+// TEST[setup:seats]

From 61b69944a51f0c282af318822bb7fda54c62af2e Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 8 Jan 2020 11:06:54 -0600
Subject: [PATCH 448/686] [DOCS] Add default index-time analyzer example
 (#50501)

The Analysis docs mention including a default analyzer in the index settings. However, no example snippet is included.

This adds an example snippet that users can easily copy and adjust.
---
 docs/reference/analysis.asciidoc | 41 +++++++++++++++++++++++++++++---
 1 file changed, 38 insertions(+), 3 deletions(-)

diff --git a/docs/reference/analysis.asciidoc b/docs/reference/analysis.asciidoc
index 8370f92bb22d7..2ff88a38c6504 100644
--- a/docs/reference/analysis.asciidoc
+++ b/docs/reference/analysis.asciidoc
@@ -35,6 +35,19 @@ to the inverted index:
 [[specify-index-time-analyzer]]
 === Specifying an index time analyzer
 
+{es} determines which index-time analyzer to use by
+checking the following parameters in order:
+
+. The <<analyzer,`analyzer`>> mapping parameter of the field
+. The `default` analyzer parameter in the index settings
+
+If none of these parameters are specified, the
+<<analysis-standard-analyzer,`standard` analyzer>> is used.
+
+[discrete]
+[[specify-index-time-field-analyzer]]
+==== Specify the index-time analyzer for a field
+
 Each <<text,`text`>> field in a mapping can specify its own
 <<analyzer,`analyzer`>>:
 
@@ -53,10 +66,32 @@ PUT my_index
 }
 -------------------------
 
-At index time, if no `analyzer` has been specified, it looks for an analyzer
-in the index settings called `default`.  Failing that, it defaults to using
-the <<analysis-standard-analyzer,`standard` analyzer>>.
+[discrete]
+[[specify-index-time-default-analyzer]]
+==== Specify a default index-time analyzer
+
+When <<indices-create-index,creating an index>>, you can set a default
+index-time analyzer using the `default` analyzer setting:
+
+[source,console]
+----
+PUT my_index
+{
+  "settings": {
+    "analysis": {
+      "analyzer": {
+        "default": {
+          "type": "whitespace"
+        }
+      }
+    }
+  }
+}
+----
 
+A default index-time analyzer is useful when mapping multiple `text` fields that
+use the same analyzer. It's also used as a general fallback analyzer for both
+index-time and search-time analysis.
 
 [float]
 == Search time analysis

From 3594fb23a6701b05a9497ac6212ac83f0674722b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Wed, 8 Jan 2020 18:25:00 +0100
Subject: [PATCH 449/686] Make Multiplexer inherit filter chains analysis mode
 (#50662)

Currently, if an updateable synonym filter is included in a multiplexer filter, it is not reloaded via the
_reload_search_analyzers because the multiplexer itself doesn't pass on the analysis mode of the
filters it contains, so its not recognized as "updateable" in itself. Instead we can check and merge
the AnalysisMode settings of all filters in the multiplexer and use the resulting mode (e.g. search-time
only) for the multiplexer itself, thus making any synonym filters contained in it reloadable.
This, of course, will also make the analyzers using the multiplexer be usable at search-time only.

Closes #50554
---
 .../common/MultiplexerTokenFilterFactory.java |  11 ++
 .../index/analysis/AnalysisMode.java          |   2 +-
 .../action/ReloadSynonymAnalyzerTests.java    | 169 +++++++++++++-----
 3 files changed, 137 insertions(+), 45 deletions(-)

diff --git a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/MultiplexerTokenFilterFactory.java b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/MultiplexerTokenFilterFactory.java
index 122214aa89117..6a2918ddb45cf 100644
--- a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/MultiplexerTokenFilterFactory.java
+++ b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/MultiplexerTokenFilterFactory.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.analysis.AbstractTokenFilterFactory;
+import org.elasticsearch.index.analysis.AnalysisMode;
 import org.elasticsearch.index.analysis.CharFilterFactory;
 import org.elasticsearch.index.analysis.TokenFilterFactory;
 import org.elasticsearch.index.analysis.TokenizerFactory;
@@ -67,12 +68,15 @@ public TokenFilterFactory getChainAwareTokenFilterFactory(TokenizerFactory token
         if (preserveOriginal) {
             filters.add(IDENTITY_FILTER);
         }
+        // also merge and transfer token filter analysis modes with analyzer
+        AnalysisMode mode = AnalysisMode.ALL;
         for (String filter : filterNames) {
             String[] parts = Strings.tokenizeToStringArray(filter, ",");
             if (parts.length == 1) {
                 TokenFilterFactory factory = resolveFilterFactory(allFilters, parts[0]);
                 factory = factory.getChainAwareTokenFilterFactory(tokenizer, charFilters, previousTokenFilters, allFilters);
                 filters.add(factory);
+                mode = mode.merge(factory.getAnalysisMode());
             } else {
                 List<TokenFilterFactory> existingChain = new ArrayList<>(previousTokenFilters);
                 List<TokenFilterFactory> chain = new ArrayList<>();
@@ -81,10 +85,12 @@ public TokenFilterFactory getChainAwareTokenFilterFactory(TokenizerFactory token
                     factory = factory.getChainAwareTokenFilterFactory(tokenizer, charFilters, existingChain, allFilters);
                     chain.add(factory);
                     existingChain.add(factory);
+                    mode = mode.merge(factory.getAnalysisMode());
                 }
                 filters.add(chainFilters(filter, chain));
             }
         }
+        final AnalysisMode analysisMode = mode;
 
         return new TokenFilterFactory() {
             @Override
@@ -105,6 +111,11 @@ public TokenStream create(TokenStream tokenStream) {
             public TokenFilterFactory getSynonymFilter() {
                 throw new IllegalArgumentException("Token filter [" + name() + "] cannot be used to parse synonyms");
             }
+
+            @Override
+            public AnalysisMode getAnalysisMode() {
+                return analysisMode;
+            }
         };
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/analysis/AnalysisMode.java b/server/src/main/java/org/elasticsearch/index/analysis/AnalysisMode.java
index ea9e1e0c6aa7f..5b781ea7a2589 100644
--- a/server/src/main/java/org/elasticsearch/index/analysis/AnalysisMode.java
+++ b/server/src/main/java/org/elasticsearch/index/analysis/AnalysisMode.java
@@ -78,5 +78,5 @@ public String getReadableName() {
      * <li>INDEX_TIME.merge(SEARCH_TIME) throws an {@link IllegalStateException}</li>
      * </ul>
      */
-    abstract AnalysisMode merge(AnalysisMode other);
+    public abstract AnalysisMode merge(AnalysisMode other);
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/action/ReloadSynonymAnalyzerTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/action/ReloadSynonymAnalyzerTests.java
index d059ae1d0910d..da33f608623dc 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/action/ReloadSynonymAnalyzerTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/action/ReloadSynonymAnalyzerTests.java
@@ -43,35 +43,25 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
 
     public void testSynonymsUpdateable() throws FileNotFoundException, IOException {
         String synonymsFileName = "synonyms.txt";
-        Path configDir = node().getEnvironment().configFile();
-        if (Files.exists(configDir) == false) {
-            Files.createDirectory(configDir);
-        }
-        Path synonymsFile = configDir.resolve(synonymsFileName);
-        if (Files.exists(synonymsFile) == false) {
-            Files.createFile(synonymsFile);
-        }
-        try (PrintWriter out = new PrintWriter(
-                new OutputStreamWriter(Files.newOutputStream(synonymsFile, StandardOpenOption.WRITE), StandardCharsets.UTF_8))) {
-            out.println("foo, baz");
-        }
+        Path synonymsFile = setupSynonymsFile(synonymsFileName, "foo, baz");
 
         final String indexName = "test";
         final String synonymAnalyzerName = "synonym_analyzer";
         final String synonymGraphAnalyzerName = "synonym_graph_analyzer";
-        assertAcked(client().admin().indices().prepareCreate(indexName).setSettings(Settings.builder()
-                .put("index.number_of_shards", 5)
-                .put("index.number_of_replicas", 0)
-                .put("analysis.analyzer." + synonymAnalyzerName + ".tokenizer", "standard")
-                .putList("analysis.analyzer." + synonymAnalyzerName + ".filter", "lowercase", "synonym_filter")
-                .put("analysis.analyzer." + synonymGraphAnalyzerName + ".tokenizer", "standard")
-                .putList("analysis.analyzer." + synonymGraphAnalyzerName + ".filter", "lowercase", "synonym_graph_filter")
-                .put("analysis.filter.synonym_filter.type", "synonym")
-                .put("analysis.filter.synonym_filter.updateable", "true")
-                .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName)
-                .put("analysis.filter.synonym_graph_filter.type", "synonym_graph")
-                .put("analysis.filter.synonym_graph_filter.updateable", "true")
-                .put("analysis.filter.synonym_graph_filter.synonyms_path", synonymsFileName))
+        assertAcked(client().admin().indices().prepareCreate(indexName)
+                .setSettings(Settings.builder()
+                        .put("index.number_of_shards", 5)
+                        .put("index.number_of_replicas", 0)
+                        .put("analysis.analyzer." + synonymAnalyzerName + ".tokenizer", "standard")
+                        .putList("analysis.analyzer." + synonymAnalyzerName + ".filter", "lowercase", "synonym_filter")
+                        .put("analysis.analyzer." + synonymGraphAnalyzerName + ".tokenizer", "standard")
+                        .putList("analysis.analyzer." + synonymGraphAnalyzerName + ".filter", "lowercase", "synonym_graph_filter")
+                        .put("analysis.filter.synonym_filter.type", "synonym")
+                        .put("analysis.filter.synonym_filter.updateable", "true")
+                        .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName)
+                        .put("analysis.filter.synonym_graph_filter.type", "synonym_graph")
+                        .put("analysis.filter.synonym_graph_filter.updateable", "true")
+                        .put("analysis.filter.synonym_graph_filter.synonyms_path", synonymsFileName))
                 .addMapping("_doc", "field", "type=text,analyzer=standard,search_analyzer=" + synonymAnalyzerName));
 
         client().prepareIndex(indexName).setId("1").setSource("field", "Foo").get();
@@ -84,8 +74,7 @@ public void testSynonymsUpdateable() throws FileNotFoundException, IOException {
 
         {
             for (String analyzerName : new String[] { synonymAnalyzerName, synonymGraphAnalyzerName }) {
-                Response analyzeResponse = client().admin().indices().prepareAnalyze(indexName, "foo").setAnalyzer(analyzerName)
-                        .get();
+                Response analyzeResponse = client().admin().indices().prepareAnalyze(indexName, "foo").setAnalyzer(analyzerName).get();
                 assertEquals(2, analyzeResponse.getTokens().size());
                 Set<String> tokens = new HashSet<>();
                 analyzeResponse.getTokens().stream().map(AnalyzeToken::getTerm).forEach(t -> tokens.add(t));
@@ -109,8 +98,7 @@ public void testSynonymsUpdateable() throws FileNotFoundException, IOException {
 
         {
             for (String analyzerName : new String[] { synonymAnalyzerName, synonymGraphAnalyzerName }) {
-                Response analyzeResponse = client().admin().indices().prepareAnalyze(indexName, "foo").setAnalyzer(analyzerName)
-                        .get();
+                Response analyzeResponse = client().admin().indices().prepareAnalyze(indexName, "foo").setAnalyzer(analyzerName).get();
                 assertEquals(3, analyzeResponse.getTokens().size());
                 Set<String> tokens = new HashSet<>();
                 analyzeResponse.getTokens().stream().map(AnalyzeToken::getTerm).forEach(t -> tokens.add(t));
@@ -126,8 +114,69 @@ public void testSynonymsUpdateable() throws FileNotFoundException, IOException {
         assertHitCount(response, 1L);
     }
 
+    public void testSynonymsInMultiplexerUpdateable() throws FileNotFoundException, IOException {
+        String synonymsFileName = "synonyms.txt";
+        Path synonymsFile = setupSynonymsFile(synonymsFileName, "foo, baz");
+
+        final String indexName = "test";
+        final String synonymAnalyzerName = "synonym_in_multiplexer_analyzer";
+        assertAcked(client().admin().indices().prepareCreate(indexName)
+                .setSettings(Settings.builder()
+                        .put("index.number_of_shards", 5)
+                        .put("index.number_of_replicas", 0)
+                        .put("analysis.analyzer." + synonymAnalyzerName + ".tokenizer", "whitespace")
+                        .putList("analysis.analyzer." + synonymAnalyzerName + ".filter", "my_multiplexer")
+                        .put("analysis.filter.synonym_filter.type", "synonym")
+                        .put("analysis.filter.synonym_filter.updateable", "true")
+                        .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName)
+                        .put("analysis.filter.my_multiplexer.type", "multiplexer")
+                        .putList("analysis.filter.my_multiplexer.filters", "synonym_filter"))
+                .addMapping("_doc", "field", "type=text,analyzer=standard,search_analyzer=" + synonymAnalyzerName));
+
+        client().prepareIndex(indexName).setId("1").setSource("field", "foo").get();
+        assertNoFailures(client().admin().indices().prepareRefresh(indexName).execute().actionGet());
+
+        SearchResponse response = client().prepareSearch(indexName).setQuery(QueryBuilders.matchQuery("field", "baz")).get();
+        assertHitCount(response, 1L);
+        response = client().prepareSearch(indexName).setQuery(QueryBuilders.matchQuery("field", "buzz")).get();
+        assertHitCount(response, 0L);
+
+        Response analyzeResponse = client().admin().indices().prepareAnalyze(indexName, "foo").setAnalyzer(synonymAnalyzerName).get();
+        assertEquals(2, analyzeResponse.getTokens().size());
+        final Set<String> tokens = new HashSet<>();
+        analyzeResponse.getTokens().stream().map(AnalyzeToken::getTerm).forEach(t -> tokens.add(t));
+        assertTrue(tokens.contains("foo"));
+        assertTrue(tokens.contains("baz"));
+
+        // now update synonyms file and trigger reloading
+        try (PrintWriter out = new PrintWriter(
+                new OutputStreamWriter(Files.newOutputStream(synonymsFile, StandardOpenOption.WRITE), StandardCharsets.UTF_8))) {
+            out.println("foo, baz, buzz");
+        }
+        ReloadAnalyzersResponse reloadResponse = client().execute(ReloadAnalyzerAction.INSTANCE, new ReloadAnalyzersRequest(indexName))
+                .actionGet();
+        assertNoFailures(reloadResponse);
+        Set<String> reloadedAnalyzers = reloadResponse.getReloadDetails().get(indexName).getReloadedAnalyzers();
+        assertEquals(1, reloadedAnalyzers.size());
+        assertTrue(reloadedAnalyzers.contains(synonymAnalyzerName));
+
+        analyzeResponse = client().admin().indices().prepareAnalyze(indexName, "foo").setAnalyzer(synonymAnalyzerName).get();
+        assertEquals(3, analyzeResponse.getTokens().size());
+        tokens.clear();
+        analyzeResponse.getTokens().stream().map(AnalyzeToken::getTerm).forEach(t -> tokens.add(t));
+        assertTrue(tokens.contains("foo"));
+        assertTrue(tokens.contains("baz"));
+        assertTrue(tokens.contains("buzz"));
+
+        response = client().prepareSearch(indexName).setQuery(QueryBuilders.matchQuery("field", "baz")).get();
+        assertHitCount(response, 1L);
+        response = client().prepareSearch(indexName).setQuery(QueryBuilders.matchQuery("field", "buzz")).get();
+        assertHitCount(response, 1L);
+    }
+
     public void testUpdateableSynonymsRejectedAtIndexTime() throws FileNotFoundException, IOException {
         String synonymsFileName = "synonyms.txt";
+        setupSynonymsFile(synonymsFileName, "foo, baz");
         Path configDir = node().getEnvironment().configFile();
         if (Files.exists(configDir) == false) {
             Files.createDirectory(configDir);
@@ -143,20 +192,52 @@ public void testUpdateableSynonymsRejectedAtIndexTime() throws FileNotFoundExcep
 
         final String indexName = "test";
         final String analyzerName = "my_synonym_analyzer";
-        MapperException ex = expectThrows(MapperException.class, () -> client().admin().indices().prepareCreate(indexName)
-                .setSettings(Settings.builder()
-                .put("index.number_of_shards", 5)
-                .put("index.number_of_replicas", 0)
-                .put("analysis.analyzer." + analyzerName + ".tokenizer", "standard")
-                .putList("analysis.analyzer." + analyzerName + ".filter", "lowercase", "synonym_filter")
-                .put("analysis.filter.synonym_filter.type", "synonym")
-                .put("analysis.filter.synonym_filter.updateable", "true")
-                .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName))
-                .addMapping("_doc", "field", "type=text,analyzer=" + analyzerName).get());
-
-        assertEquals(
-                "Failed to parse mapping: analyzer [my_synonym_analyzer] "
-                + "contains filters [synonym_filter] that are not allowed to run in all mode.",
-                ex.getMessage());
+        MapperException ex = expectThrows(MapperException.class,
+                () -> client().admin().indices().prepareCreate(indexName).setSettings(Settings.builder()
+                        .put("index.number_of_shards", 5)
+                        .put("index.number_of_replicas", 0)
+                        .put("analysis.analyzer." + analyzerName + ".tokenizer", "standard")
+                        .putList("analysis.analyzer." + analyzerName + ".filter", "lowercase", "synonym_filter")
+                        .put("analysis.filter.synonym_filter.type", "synonym")
+                        .put("analysis.filter.synonym_filter.updateable", "true")
+                        .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName))
+                        .addMapping("_doc", "field", "type=text,analyzer=" + analyzerName).get());
+
+        assertEquals("Failed to parse mapping: analyzer [my_synonym_analyzer] "
+                + "contains filters [synonym_filter] that are not allowed to run in all mode.", ex.getMessage());
+
+        // same for synonym filters in multiplexer chain
+        ex = expectThrows(MapperException.class,
+                () -> client().admin().indices().prepareCreate(indexName).setSettings(Settings.builder()
+                        .put("index.number_of_shards", 5)
+                        .put("index.number_of_replicas", 0)
+                        .put("analysis.analyzer." + analyzerName + ".tokenizer", "whitespace")
+                        .putList("analysis.analyzer." + analyzerName + ".filter", "my_multiplexer")
+                        .put("analysis.filter.synonym_filter.type", "synonym")
+                        .put("analysis.filter.synonym_filter.updateable", "true")
+                        .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName)
+                        .put("analysis.filter.my_multiplexer.type", "multiplexer")
+                        .putList("analysis.filter.my_multiplexer.filters", "synonym_filter"))
+                        .addMapping("_doc", "field", "type=text,analyzer=" + analyzerName).get());
+
+        assertEquals("Failed to parse mapping: analyzer [my_synonym_analyzer] "
+                + "contains filters [my_multiplexer] that are not allowed to run in all mode.", ex.getMessage());
     }
+
+    private Path setupSynonymsFile(String synonymsFileName, String content) throws IOException {
+        Path configDir = node().getEnvironment().configFile();
+        if (Files.exists(configDir) == false) {
+            Files.createDirectory(configDir);
+        }
+        Path synonymsFile = configDir.resolve(synonymsFileName);
+        if (Files.exists(synonymsFile) == false) {
+            Files.createFile(synonymsFile);
+        }
+        try (PrintWriter out = new PrintWriter(
+                new OutputStreamWriter(Files.newOutputStream(synonymsFile, StandardOpenOption.WRITE), StandardCharsets.UTF_8))) {
+            out.println(content);
+        }
+        return synonymsFile;
+    }
+
 }

From 95b2a798bbcafc35de4dba69129f902a5d470d40 Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Wed, 8 Jan 2020 18:33:02 +0100
Subject: [PATCH 450/686] ElasticSearchExceptionTests guessRootCauses fix
 (#50752)

testFailureToAndFromXContentWithDetails had incorporated that
guessRootCauses returned the wrapper when the underlying exception
was not an ElasticsearchException, fixed.

Relates #50525
---
 .../java/org/elasticsearch/ElasticsearchExceptionTests.java   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/ElasticsearchExceptionTests.java b/server/src/test/java/org/elasticsearch/ElasticsearchExceptionTests.java
index 570598831f944..52c1bd7a24d24 100644
--- a/server/src/test/java/org/elasticsearch/ElasticsearchExceptionTests.java
+++ b/server/src/test/java/org/elasticsearch/ElasticsearchExceptionTests.java
@@ -805,9 +805,7 @@ public void testFailureToAndFromXContentWithDetails() throws IOException {
                 failure = new BroadcastShardOperationFailedException(new ShardId("_index", "_uuid", 5), "F", failureCause);
 
                 expected = new ElasticsearchException("Elasticsearch exception [type=file_already_exists_exception, reason=File exists]");
-                // strangely, the wrapped exception appears as the root cause...
-                suppressed = new ElasticsearchException("Elasticsearch exception [type=broadcast_shard_operation_failed_exception, " +
-                        "reason=F]");
+                suppressed = new ElasticsearchException("Elasticsearch exception [type=file_already_exists_exception, reason=File exists]");
                 expected.addSuppressed(suppressed);
                 break;
 

From cbf47d468d234765316bf4aa5e50ccc3416ba1fd Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Wed, 8 Jan 2020 10:34:27 -0700
Subject: [PATCH 451/686] Mute
 TimeSeriesLifecycleActionsIT.testHistoryIsWritten* (#50755)

Related to #50353
---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java  | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 07e7ff405ded5..d667aba146545 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1148,6 +1148,7 @@ public void testUpdateRolloverLifecycleDateStepRetriesWhenRolloverInfoIsMissing(
         assertBusy(() -> assertThat(getStepKeyForIndex(index), equalTo(TerminalPolicyStep.KEY)));
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithSuccess() throws Exception {
         String index = "success-index";
 
@@ -1192,6 +1193,7 @@ public void testHistoryIsWrittenWithSuccess() throws Exception {
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-000002", true, "check-rollover-ready"), 30, TimeUnit.SECONDS);
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithFailure() throws Exception {
         String index = "failure-index";
 
@@ -1222,6 +1224,7 @@ public void testHistoryIsWrittenWithFailure() throws Exception {
         assertBusy(() -> assertHistoryIsPresent(policy, index + "-1", false, "ERROR"), 30, TimeUnit.SECONDS);
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50353")
     public void testHistoryIsWrittenWithDeletion() throws Exception {
         String index = "delete-index";
 

From b45d9a1662d2a7d2a546f19565e88d1af7161dc0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Wed, 8 Jan 2020 18:53:57 +0100
Subject: [PATCH 452/686] [DOCS] Adds DFA resources as deleted page to
 redirects. (#50756)

---
 docs/reference/redirects.asciidoc | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 063be6616c9ac..803e3f112c5d5 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -277,6 +277,12 @@ This page was deleted.
 See <<put-transform>>, <<preview-transform>>, <<update-transform>>,
 <<get-transform>>.
 
+[role="exclude",id="ml-dfanalytics-resources"]
+=== {dfanalytics-cap} job resources
+
+This page was deleted.
+See <<put-dfanalytics>>.
+
 [role="exclude",id="ml-results-resource"]
 === Results resources
 

From 7fe8f0210ad9af6f097c623e76a39a58385ac5fb Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 8 Jan 2020 10:20:52 -0800
Subject: [PATCH 453/686] Fix java home environment variables for experimental
 jjbb job

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 .ci/build.sh            | 5 ++---
 .ci/jobs.t/defaults.yml | 4 +++-
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/.ci/build.sh b/.ci/build.sh
index b86acfd8cef1d..5938cbdde4de0 100755
--- a/.ci/build.sh
+++ b/.ci/build.sh
@@ -1,8 +1,7 @@
 #!/bin/bash
 
-JAVA_HOME=${JAVA_HOME:-$HOME/.java/openjdk13}
-RUNTIME_JAVA_HOME=${RUNTIME_JAVA_HOME:-$HOME/.java/openjdk11}
-
+JAVA_HOME=$HOME/.java/$ES_BUILD_JAVA
+RUNTIME_JAVA_HOME=$HOME/.java/$ES_RUNTIME_JAVA
 JAVA7_HOME=$HOME/.java/java7
 JAVA8_HOME=$HOME/.java/java8
 JAVA9_HOME=$HOME/.java/java9
diff --git a/.ci/jobs.t/defaults.yml b/.ci/jobs.t/defaults.yml
index 662a2798bb98a..fd56855c224e6 100644
--- a/.ci/jobs.t/defaults.yml
+++ b/.ci/jobs.t/defaults.yml
@@ -36,6 +36,8 @@
       - ansicolor
       - timestamps
       - gradle-build-scan
+      - inject:
+          properties-file: '.ci/java-versions.properties'
     properties:
         - github:
             url: https://github.com/elastic/elasticsearch/
@@ -76,4 +78,4 @@
 
 
 
-            
+

From 49a80486dfc6fcc2f5613ab4444d0ba2127f5c36 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 8 Jan 2020 10:35:29 -0800
Subject: [PATCH 454/686] Inject environment variables like we do in other CI
 builds

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 .ci/build.sh            | 11 -----------
 .ci/jobs.t/defaults.yml | 11 +++++++++++
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/.ci/build.sh b/.ci/build.sh
index 5938cbdde4de0..091f9582e0660 100755
--- a/.ci/build.sh
+++ b/.ci/build.sh
@@ -1,15 +1,5 @@
 #!/bin/bash
 
-JAVA_HOME=$HOME/.java/$ES_BUILD_JAVA
-RUNTIME_JAVA_HOME=$HOME/.java/$ES_RUNTIME_JAVA
-JAVA7_HOME=$HOME/.java/java7
-JAVA8_HOME=$HOME/.java/java8
-JAVA9_HOME=$HOME/.java/java9
-JAVA10_HOME=$HOME/.java/java10
-JAVA11_HOME=$HOME/.java/java11
-JAVA12_HOME=$HOME/.java/openjdk12
-JAVA13_HOME=$HOME/.java/openjdk13
-
 # drop page cache and kernel slab objects on linux
 [[ -x /usr/local/sbin/drop-caches ]] && sudo /usr/local/sbin/drop-caches
 
@@ -35,7 +25,6 @@ if pwd | grep -v -q ^/dev/shm ; then
    MAX_WORKERS=$(($MAX_WORKERS*2/3))
 fi
 
-export GRADLE_OPTS="-XX:+HeapDumpOnOutOfMemoryError -Xmx128m -Xms128m"
 set -e
 ./gradlew --parallel --scan \
   -Dorg.elasticsearch.build.cache.url=https://gradle-enterprise.elastic.co/cache/ \
diff --git a/.ci/jobs.t/defaults.yml b/.ci/jobs.t/defaults.yml
index fd56855c224e6..fdd16dd4900a9 100644
--- a/.ci/jobs.t/defaults.yml
+++ b/.ci/jobs.t/defaults.yml
@@ -38,6 +38,17 @@
       - gradle-build-scan
       - inject:
           properties-file: '.ci/java-versions.properties'
+          properties-content: |
+            JAVA_HOME=$HOME/.java/$ES_BUILD_JAVA
+            RUNTIME_JAVA_HOME=$HOME/.java/$ES_RUNTIME_JAVA
+            JAVA7_HOME=$HOME/.java/java7
+            JAVA8_HOME=$HOME/.java/java8
+            JAVA9_HOME=$HOME/.java/java9
+            JAVA10_HOME=$HOME/.java/java10
+            JAVA11_HOME=$HOME/.java/java11
+            JAVA12_HOME=$HOME/.java/openjdk12
+            JAVA13_HOME=$HOME/.java/openjdk13
+            GRADLE_OPTS=-XX:+HeapDumpOnOutOfMemoryError -Xmx128m -Xms128m
     properties:
         - github:
             url: https://github.com/elastic/elasticsearch/

From e796b5508f842fd20ba72ae8c8dfff40e4ee2bfd Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 8 Jan 2020 12:53:08 -0600
Subject: [PATCH 455/686] [DOCS] Add overview page to analysis topic (#50515)

Adds a 'text analysis overview' page to the analysis topic docs.

The goals of this page are:

* Concisely summarize the analysis process while avoiding in-depth concepts, tutorials, or API examples
* Explain why analysis is important, largely through highlighting problems with full-text searches missing analysis
* Highlight how analysis can be used to improve search results
---
 docs/reference/analysis.asciidoc          |  8 ++-
 docs/reference/analysis/overview.asciidoc | 78 +++++++++++++++++++++++
 2 files changed, 83 insertions(+), 3 deletions(-)
 create mode 100644 docs/reference/analysis/overview.asciidoc

diff --git a/docs/reference/analysis.asciidoc b/docs/reference/analysis.asciidoc
index 2ff88a38c6504..aaa40c01aea1f 100644
--- a/docs/reference/analysis.asciidoc
+++ b/docs/reference/analysis.asciidoc
@@ -1,11 +1,11 @@
 [[analysis]]
-= Analysis
+= Text analysis
 
 [partintro]
 --
 
-_Analysis_ is the process of converting text, like the body of any email, into
-_tokens_ or _terms_ which are added to the inverted index for searching.
+_Text analysis_ is the process of converting text, like the body of any email,
+into _tokens_ or _terms_ which are added to the inverted index for searching.
 Analysis is performed by an <<analysis-analyzers,_analyzer_>> which can be
 either a built-in analyzer or a <<analysis-custom-analyzer,`custom`>> analyzer
 defined per index.
@@ -142,6 +142,8 @@ looking for:
 
 --
 
+include::analysis/overview.asciidoc[]
+
 include::analysis/anatomy.asciidoc[]
 
 include::analysis/testing.asciidoc[]
diff --git a/docs/reference/analysis/overview.asciidoc b/docs/reference/analysis/overview.asciidoc
new file mode 100644
index 0000000000000..19f39a548bad5
--- /dev/null
+++ b/docs/reference/analysis/overview.asciidoc
@@ -0,0 +1,78 @@
+
+== Text analysis overview
+++++
+<titleabbrev>Overview</titleabbrev>
+++++
+
+Text analysis enables {es} to perform full-text search, where the search returns
+all _relevant_ results rather than just exact matches.
+
+If you search for `Quick fox jumps`, you probably want the document that
+contains `A quick brown fox jumps over the lazy dog`, and you might also want
+documents that contain related words like `fast fox` or `foxes leap`.
+
+[discrete]
+[[tokenization]]
+=== Tokenization
+
+Analysis makes full-text search possible through _tokenization_: breaking a text
+down into smaller chunks, called _tokens_. In most cases, these tokens are
+individual words.
+
+If you index the phrase `the quick brown fox jumps` as a single string and the
+user searches for `quick fox`, it isn't considered a match. However, if you
+tokenize the phrase and index each word separately, the terms in the query
+string can be looked up individually. This means they can be matched by searches
+for `quick fox`, `fox brown`, or other variations.
+
+[discrete]
+[[normalization]]
+=== Normalization
+
+Tokenization enables matching on individual terms, but each token is still
+matched literally. This means:
+
+*  A search for `Quick` would not match `quick`, even though you likely want
+either term to match the other
+
+* Although `fox` and `foxes` share the same root word, a search for `foxes`
+would not match `fox` or vice versa.
+
+* A search for `jumps` would not match `leaps`. While they don't share a root
+word, they are synonyms and have a similar meaning.
+
+To solve these problems, text analysis can _normalize_ these tokens into a
+standard format. This allows you to match tokens that are not exactly the same
+as the search terms, but similar enough to still be relevant. For example:
+
+* `Quick` can be lowercased: `quick`.
+
+* `foxes` can be _stemmed_, or reduced to its root word: `fox`.
+
+* `jump` and `leap` are synonyms and can be indexed as a single word: `jump`.
+
+To ensure search terms match these words as intended, you can apply the same
+tokenization and normalization rules to the query string. For example, a search
+for `Foxes leap` can be normalized to a search for `fox jump`.
+
+[discrete]
+[[analysis-customization]]
+=== Customize text analysis
+
+Text analysis is performed by an <<analyzer-anatomy,_analyzer_>>, a set of rules
+that govern the entire process.
+
+{es} includes a default analyzer, called the
+<<analysis-standard-analyzer,standard analyzer>>, which works well for most use
+cases right out of the box.
+
+If you want to tailor your search experience, you can choose a different
+<<analysis-analyzers,built-in analyzer>> or even
+<<analysis-custom-analyzer,configure a custom one>>. A custom analyzer gives you
+control over each step of the analysis process, including:
+
+* Changes to the text _before_ tokenization
+
+* How text is converted to tokens
+
+* Normalization changes made to tokens before indexing or search
\ No newline at end of file

From d4ea1a573acd3744b2bf2e9df5ebda12ec322b6b Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Wed, 8 Jan 2020 12:24:50 -0700
Subject: [PATCH 456/686] Make InitializePolicyContextStep retryable (#50685)

This commits makes the "init" ILM step retryable. It also adds a test
where an index is created with a non-parsable index name and then fails.

Related to #48183
---
 .../core/ilm/InitializePolicyContextStep.java |  5 ++
 .../ilm/TimeSeriesLifecycleActionsIT.java     | 47 +++++++++++++++++++
 2 files changed, 52 insertions(+)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/InitializePolicyContextStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/InitializePolicyContextStep.java
index 3e7ad7a6a07df..194dcaa2e1eb8 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/InitializePolicyContextStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/InitializePolicyContextStep.java
@@ -67,4 +67,9 @@ public ClusterState performAction(Index index, ClusterState clusterState) {
         );
         return newClusterStateBuilder.build();
     }
+
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
 }
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index d667aba146545..d90bee1d889ab 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.xpack.core.ilm.ErrorStep;
 import org.elasticsearch.xpack.core.ilm.ForceMergeAction;
 import org.elasticsearch.xpack.core.ilm.FreezeAction;
+import org.elasticsearch.xpack.core.ilm.InitializePolicyContextStep;
 import org.elasticsearch.xpack.core.ilm.LifecycleAction;
 import org.elasticsearch.xpack.core.ilm.LifecyclePolicy;
 import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
@@ -1256,6 +1257,52 @@ public void testHistoryIsWrittenWithDeletion() throws Exception {
         }, 30, TimeUnit.SECONDS);
     }
 
+    public void testRetryableInitializationStep() throws Exception {
+        String index = "retryinit-20xx-01-10";
+        Request stopReq = new Request("POST", "/_ilm/stop");
+        Request startReq = new Request("POST", "/_ilm/start");
+
+        createNewSingletonPolicy("hot", new SetPriorityAction(1));
+
+        // Stop ILM so that the initialize step doesn't run
+        assertOK(client().performRequest(stopReq));
+
+        // Create the index with the origination parsing turn *off* so it doesn't prevent creation
+        createIndexWithSettings(
+            index,
+            Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
+                .put(LifecycleSettings.LIFECYCLE_NAME, policy)
+                .put(LifecycleSettings.LIFECYCLE_PARSE_ORIGINATION_DATE, false));
+
+        updateIndexSettings(index, Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_PARSE_ORIGINATION_DATE, true));
+
+        assertOK(client().performRequest(startReq));
+
+        // Wait until an error has occurred.
+        waitUntil(() -> {
+            try {
+                Map<String, Object> explainIndexResponse = explainIndex(index);
+                String step = (String) explainIndexResponse.get("step");
+                Integer retryCount = (Integer) explainIndexResponse.get(FAILED_STEP_RETRY_COUNT_FIELD);
+                return step != null && step.equals(InitializePolicyContextStep.KEY.getAction()) && retryCount != null && retryCount >= 1;
+            } catch (IOException e) {
+                return false;
+            }
+        }, 30, TimeUnit.SECONDS);
+
+        // Turn origination date parsing back off
+        updateIndexSettings(index, Settings.builder()
+            .put(LifecycleSettings.LIFECYCLE_PARSE_ORIGINATION_DATE, false));
+
+        assertBusy(() -> {
+            Map<String, Object> explainResp = explainIndex(index);
+            String phase = (String) explainResp.get("phase");
+            assertThat(phase, equalTo(TerminalPolicyStep.COMPLETED_PHASE));
+        });
+    }
+
     // This method should be called inside an assertBusy, it has no retry logic of its own
     private void assertHistoryIsPresent(String policyName, String indexName, boolean success, String stepName) throws IOException {
         assertHistoryIsPresent(policyName, indexName, success, null, null, stepName);

From 5aff41d6406d43fab006c00ba41cf473c75c8dbc Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Wed, 8 Jan 2020 14:33:11 -0600
Subject: [PATCH 457/686] Fix open/close race in ConnectionManagerTests
 (#50621)

Currently we reuse the same test connection for all connection attempts
in the testConcurrentConnectsAndDisconnects test. This means that if the
connection fails due to a pre-existing connection, the connection will
be closed impacting the state of all connection attempts. This commit
fixes the test, by returning a unique connection for each attempt.

Fixes #49903.
---
 .../transport/ConnectionManagerTests.java     | 52 +++++++++++++++----
 1 file changed, 41 insertions(+), 11 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/transport/ConnectionManagerTests.java b/server/src/test/java/org/elasticsearch/transport/ConnectionManagerTests.java
index 37c0d92612fdc..e82158a3c1558 100644
--- a/server/src/test/java/org/elasticsearch/transport/ConnectionManagerTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/ConnectionManagerTests.java
@@ -33,8 +33,11 @@
 
 import java.net.InetAddress;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.List;
+import java.util.Set;
 import java.util.concurrent.BrokenBarrierException;
+import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.CyclicBarrier;
 import java.util.concurrent.TimeUnit;
@@ -124,16 +127,22 @@ public void onNodeDisconnected(DiscoveryNode node, Transport.Connection connecti
         assertEquals(1, nodeDisconnectedCount.get());
     }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/49903")
-    public void testConcurrentConnectsAndDisconnects() throws BrokenBarrierException, InterruptedException {
+    public void testConcurrentConnects() throws Exception {
+        Set<Transport.Connection> connections = Collections.newSetFromMap(new ConcurrentHashMap<>());
+
         DiscoveryNode node = new DiscoveryNode("", new TransportAddress(InetAddress.getLoopbackAddress(), 0), Version.CURRENT);
-        Transport.Connection connection = new TestConnect(node);
         doAnswer(invocationOnMock -> {
             ActionListener<Transport.Connection> listener = (ActionListener<Transport.Connection>) invocationOnMock.getArguments()[2];
-            if (rarely()) {
-                listener.onResponse(connection);
-            } else if (frequently()) {
-                threadPool.generic().execute(() -> listener.onResponse(connection));
+
+            boolean success = randomBoolean();
+            if (success) {
+                Transport.Connection connection = new TestConnect(node);
+                connections.add(connection);
+                if (randomBoolean()) {
+                    listener.onResponse(connection);
+                } else {
+                    threadPool.generic().execute(() -> listener.onResponse(connection));
+                }
             } else {
                 threadPool.generic().execute(() -> listener.onFailure(new IllegalStateException("dummy exception")));
             }
@@ -143,10 +152,13 @@ public void testConcurrentConnectsAndDisconnects() throws BrokenBarrierException
         assertFalse(connectionManager.nodeConnected(node));
 
         ConnectionManager.ConnectionValidator validator = (c, p, l) -> {
-            if (rarely()) {
-                l.onResponse(null);
-            } else if (frequently()) {
-                threadPool.generic().execute(() -> l.onResponse(null));
+            boolean success = randomBoolean();
+            if (success) {
+                if (randomBoolean()) {
+                    l.onResponse(null);
+                } else {
+                    threadPool.generic().execute(() -> l.onResponse(null));
+                }
             } else {
                 threadPool.generic().execute(() -> l.onFailure(new IllegalStateException("dummy exception")));
             }
@@ -198,6 +210,24 @@ public void testConcurrentConnectsAndDisconnects() throws BrokenBarrierException
         });
 
         assertEquals(10, nodeConnectedCount.get() + nodeFailureCount.get());
+
+        int managedConnections = connectionManager.size();
+        if (managedConnections != 0) {
+            assertEquals(1, managedConnections);
+
+            // Only a single connection attempt should be open.
+            assertEquals(1, connections.stream().filter(c -> c.isClosed() == false).count());
+        } else {
+            // No connections succeeded
+            assertEquals(0, connections.stream().filter(c -> c.isClosed() == false).count());
+        }
+
+
+        connectionManager.close();
+        // The connection manager will close all open connections
+        for (Transport.Connection connection : connections) {
+            assertTrue(connection.isClosed());
+        }
     }
 
     public void testConnectFailsDuringValidation() {

From 720ec8fad440038f416f7b7f46b803bc5c4f0b85 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 8 Jan 2020 14:39:28 -0600
Subject: [PATCH 458/686] [DOCS] Add section ID to analysis overview page

---
 docs/reference/analysis/overview.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/analysis/overview.asciidoc b/docs/reference/analysis/overview.asciidoc
index 19f39a548bad5..8cf5a10ae8af5 100644
--- a/docs/reference/analysis/overview.asciidoc
+++ b/docs/reference/analysis/overview.asciidoc
@@ -1,4 +1,4 @@
-
+[[analysis-overview]]
 == Text analysis overview
 ++++
 <titleabbrev>Overview</titleabbrev>

From e6fba667a583c3ecd5a06a6d34282c196a7bbfb8 Mon Sep 17 00:00:00 2001
From: Bogdan Pintea <bpintea@gmail.com>
Date: Wed, 8 Jan 2020 22:36:47 +0100
Subject: [PATCH 459/686] SQL: Optimisation fixes for conjunction merges
 (#50703)

* SQL: Optimisation fixes for conjunction merges

This commit fixes the following issues around the way comparisions are
merged with ranges in conjunctions:
* the decision to include the equality of the lower limit is corrected;
* the selection of the upper limit is corrected to use the upper bound
of the range;
* the list of terms in the conjunction is sorted to have the ranges at
the bottom; this allows subsequent binary comarisions to find compatible
ranges and potentially be merged away. The end guarantee being that the
optimisation takes place irrespective of the order of the conjunction
terms in the statement.

Some comments are also corrected.

* adress review observation on anon. comparator

Replace anonymous comparator of split AND Expressions with a lambda.
---
 .../xpack/sql/expression/Expression.java      |  2 +-
 .../xpack/sql/optimizer/Optimizer.java        | 29 +++++++----
 .../xpack/sql/optimizer/OptimizerTests.java   | 51 +++++++++++++++++++
 3 files changed, 72 insertions(+), 10 deletions(-)

diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java
index e2e3f99ca8790..166ccd72f711f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java
@@ -19,7 +19,7 @@
  * In a SQL statement, an Expression is whatever a user specifies inside an
  * action, so for instance:
  *
- * {@code SELECT a, b, MAX(c, d) FROM i}
+ * {@code SELECT a, b, ABS(c) FROM i}
  *
  * a, b, ABS(c), and i are all Expressions, with ABS(c) being a Function
  * (which is a type of expression) with a single child, c.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
index 0d7d9acc343d0..ce23010c8bd98 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
@@ -397,7 +397,7 @@ protected LogicalPlan rule(OrderBy ob) {
             return ob;
         }
     }
-    
+
     static class PruneOrderByForImplicitGrouping extends OptimizerRule<OrderBy> {
 
         @Override
@@ -1090,7 +1090,18 @@ private Expression combine(And and) {
 
             boolean changed = false;
 
-            for (Expression ex : Predicates.splitAnd(and)) {
+            List<Expression> andExps = Predicates.splitAnd(and);
+            // Ranges need to show up before BinaryComparisons in list, to allow the latter be optimized away into a Range, if possible
+            andExps.sort((o1, o2) -> {
+                if (o1 instanceof Range && o2 instanceof Range) {
+                    return 0; // keep ranges' order
+                } else if (o1 instanceof Range || o2 instanceof Range) {
+                    return o2 instanceof Range ? 1 : -1;
+                } else {
+                    return 0; // keep non-ranges' order
+                }
+            });
+            for (Expression ex : andExps) {
                 if (ex instanceof Range) {
                     Range r = (Range) ex;
                     if (findExistingRange(r, ranges, true)) {
@@ -1215,9 +1226,9 @@ private static boolean findExistingRange(Range main, List<Range> ranges, boolean
                             lowerEq = comp == 0 && main.includeLower() == other.includeLower();
                             // AND
                             if (conjunctive) {
-                                // (2 < a < 3) AND (1 < a < 3) -> (1 < a < 3)
+                                // (2 < a < 3) AND (1 < a < 3) -> (2 < a < 3)
                                 lower = comp > 0 ||
-                                // (2 < a < 3) AND (2 < a <= 3) -> (2 < a < 3)
+                                // (2 < a < 3) AND (2 <= a < 3) -> (2 < a < 3)
                                         (comp == 0 && !main.includeLower() && other.includeLower());
                             }
                             // OR
@@ -1316,7 +1327,7 @@ private boolean findConjunctiveComparisonInRange(BinaryComparison main, List<Ran
                                     ranges.remove(i);
                                     ranges.add(i,
                                             new Range(other.source(), other.value(),
-                                                    main.right(), lowerEq ? true : other.includeLower(),
+                                                    main.right(), lowerEq ? false : main instanceof GreaterThanOrEqual,
                                                     other.upper(), other.includeUpper()));
                                 }
 
@@ -1325,19 +1336,19 @@ private boolean findConjunctiveComparisonInRange(BinaryComparison main, List<Ran
                             }
                         }
                     } else if (main instanceof LessThan || main instanceof LessThanOrEqual) {
-                        if (other.lower().foldable()) {
-                            Integer comp = BinaryComparison.compare(value, other.lower().fold());
+                        if (other.upper().foldable()) {
+                            Integer comp = BinaryComparison.compare(value, other.upper().fold());
                             if (comp != null) {
                                 // a < 2 AND (1 < a <= 2) -> 1 < a < 2
                                 boolean upperEq = comp == 0 && other.includeUpper() && main instanceof LessThan;
                                 // a < 2 AND (1 < a < 3) -> 1 < a < 2
-                                boolean upper = comp > 0 || upperEq;
+                                boolean upper = comp < 0 || upperEq;
 
                                 if (upper) {
                                     ranges.remove(i);
                                     ranges.add(i, new Range(other.source(), other.value(),
                                             other.lower(), other.includeLower(),
-                                            main.right(), upperEq ? true : other.includeUpper()));
+                                            main.right(), upperEq ? false : main instanceof LessThanOrEqual));
                                 }
 
                                 // found a match
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
index 1f45d917dabd2..2b6378e2ee13c 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
@@ -1012,6 +1012,57 @@ public void testCombineBinaryComparisonsInclude() {
         assertEquals(FIVE, r.right());
     }
 
+    // 2 < a AND (2 <= a < 3) -> 2 < a < 3
+    public void testCombineBinaryComparisonsAndRangeLower() {
+        FieldAttribute fa = getFieldAttribute();
+
+        GreaterThan gt = new GreaterThan(EMPTY, fa, TWO);
+        Range range = new Range(EMPTY, fa, TWO, true, THREE, false);
+
+        CombineBinaryComparisons rule = new CombineBinaryComparisons();
+        Expression exp = rule.rule(new And(EMPTY, gt, range));
+        assertEquals(Range.class, exp.getClass());
+        Range r = (Range)exp;
+        assertEquals(TWO, r.lower());
+        assertFalse(r.includeLower());
+        assertEquals(THREE, r.upper());
+        assertFalse(r.includeUpper());
+    }
+
+    // a < 4 AND (1 < a < 3) -> 1 < a < 3
+    public void testCombineBinaryComparisonsAndRangeUpper() {
+        FieldAttribute fa = getFieldAttribute();
+
+        LessThan lt = new LessThan(EMPTY, fa, FOUR);
+        Range range = new Range(EMPTY, fa, ONE, false, THREE, false);
+
+        CombineBinaryComparisons rule = new CombineBinaryComparisons();
+        Expression exp = rule.rule(new And(EMPTY, range, lt));
+        assertEquals(Range.class, exp.getClass());
+        Range r = (Range)exp;
+        assertEquals(ONE, r.lower());
+        assertFalse(r.includeLower());
+        assertEquals(THREE, r.upper());
+        assertFalse(r.includeUpper());
+    }
+
+    // a <= 2 AND (1 < a < 3) -> 1 < a <= 2
+    public void testCombineBinaryComparisonsAndRangeUpperEqual() {
+        FieldAttribute fa = getFieldAttribute();
+
+        LessThanOrEqual lte = new LessThanOrEqual(EMPTY, fa, TWO);
+        Range range = new Range(EMPTY, fa, ONE, false, THREE, false);
+
+        CombineBinaryComparisons rule = new CombineBinaryComparisons();
+        Expression exp = rule.rule(new And(EMPTY, lte, range));
+        assertEquals(Range.class, exp.getClass());
+        Range r = (Range)exp;
+        assertEquals(ONE, r.lower());
+        assertFalse(r.includeLower());
+        assertEquals(TWO, r.upper());
+        assertTrue(r.includeUpper());
+    }
+
     // 3 <= a AND 4 < a AND a <= 7 AND a < 6 -> 4 < a < 6
     public void testCombineMultipleBinaryComparisons() {
         FieldAttribute fa = getFieldAttribute();

From 8cc63a02d9e0572f48b8d00e8db71b18b09a3734 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 8 Jan 2020 13:48:12 -0800
Subject: [PATCH 460/686] Add experimental build for identifying docker-compose
 issues in CI

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 ...elasticsearch+{branch}+docker-test-ramdisk.yml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 .ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml

diff --git a/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml b/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
new file mode 100644
index 0000000000000..79b5600582706
--- /dev/null
+++ b/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
@@ -0,0 +1,15 @@
+- job:
+    name: elastic+elasticsearch+%BRANCH%+docker-test-ramdisk
+    workspace: /dev/shm/elastic+elasticsearch+%BRANCH%+docker-test
+    display-name: "elastic / elasticsearch # %BRANCH% - docker test ramdisk (experimental)"
+    description: "Experimental test job to shake out issues with Docker in CI\n"
+    node: "(debian-10 || sles-12 || debian-8 || sles-15) && immutable"
+    triggers:
+      - timed: "H/10 * * * *"
+    builders:
+      - inject:
+          properties-content: |
+            WORKSPACE=/dev/shm/elastic+elasticsearch+%BRANCH%+docker-test
+      - shell: |
+          #!/usr/local/bin/runbld --redirect-stderr --last-good-commit elastic+elasticsearch+%BRANCH%+git+push
+          .ci/build.sh -Dbwc.checkout.align=true -p test.fixtures composeUp

From ab7c3b55df1809b378db691a58512d03db3bb2a7 Mon Sep 17 00:00:00 2001
From: Julie Tibshirani <julie.tibshirani@elastic.co>
Date: Wed, 8 Jan 2020 13:50:32 -0800
Subject: [PATCH 461/686] Ensure that field collapsing works with field
 aliases. (#50722)

Previously, the following situation would throw an error:
* A search contains a `collapse` on a particular field.
* The search spans multiple indices, and in one index the field is mapped as a
  concrete field, but in another it is a field alias.

The error occurs when we attempt to merge `CollapseTopFieldDocs` across shards.
When merging, we validate that the name of the collapse field is the same across
shards. But the name has already been resolved to the concrete field name, so it
will be different on shards where the field was mapped as an alias vs. shards
where it was a concrete field.

This PR updates the collapse field name in `CollapseTopFieldDocs` to the
original requested field, so that it will always be consistent across shards.

Note that in #32648, we already made a fix around collapsing on field aliases.
However, we didn't test this specific scenario where the field was mapped as an
alias in only one of the indices being searched.
---
 .../test/search/110_field_collapsing.yml      | 44 +++++++++++++------
 .../grouping/CollapsingDocValuesSource.java   |  9 ++--
 .../grouping/CollapsingTopDocsCollector.java  | 39 +++++++++-------
 .../search/collapse/CollapseContext.java      |  6 +--
 .../CollapsingTopDocsCollectorTests.java      | 28 +++++++++---
 5 files changed, 83 insertions(+), 43 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
index 5ebbb23cbd31b..91e2583dcc634 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
@@ -347,30 +347,48 @@ setup:
 
 ---
 "field collapsing on a field alias":
-
+  - skip:
+      version: " - 7.99.99"
+      reason: the bug fix is not yet backported to 7.x
   - do:
-      indices.put_mapping:
-        index: test
+      indices.create:
+        index:  alias-test
         body:
-          properties:
-            group_alias: { type: alias, path: numeric_group }
+          mappings:
+            properties:
+              numeric_group: { type: alias, path: other_numeric_group }
+              other_numeric_group: { type: integer }
+  - do:
+      index:
+        index:  alias-test
+        id:     1
+        body:   { other_numeric_group: 1, sort: 6 }
+  - do:
+      index:
+        index:  alias-test
+        id:     2
+        body:   { other_numeric_group: 25, sort: 10 }
+  - do:
+      indices.refresh:
+        index: alias-test
+
   - do:
       search:
         rest_total_hits_as_int: true
-        index: test
+        index: [alias-test, test]
         body:
-          collapse: { field: group_alias, inner_hits: { name: sub_hits } }
+          collapse: { field: numeric_group, inner_hits: { name: sub_hits } }
           sort: [{ sort: desc }]
 
-  - match: { hits.total: 6 }
+  - match: { hits.total: 8 }
   - length: { hits.hits: 3 }
 
-  - match: { hits.hits.0.fields.group_alias: [3] }
+  - match: { hits.hits.0.fields.numeric_group: [3] }
   - match: { hits.hits.0.inner_hits.sub_hits.hits.total: 1}
-  - match: { hits.hits.1.fields.group_alias: [1] }
-  - match: { hits.hits.1.inner_hits.sub_hits.hits.total: 3}
-  - match: { hits.hits.2.fields.group_alias: [25] }
-  - match: { hits.hits.2.inner_hits.sub_hits.hits.total: 2}
+  - match: { hits.hits.1.fields.numeric_group: [1] }
+  - match: { hits.hits.1.inner_hits.sub_hits.hits.total: 4}
+  - match: { hits.hits.2.fields.numeric_group: [25] }
+  - match: { hits.hits.2.inner_hits.sub_hits.hits.total: 3}
 
 ---
 "field collapsing, inner_hits and seq_no":
diff --git a/server/src/main/java/org/apache/lucene/search/grouping/CollapsingDocValuesSource.java b/server/src/main/java/org/apache/lucene/search/grouping/CollapsingDocValuesSource.java
index cbcd1e3a4117d..2164f9f2333de 100644
--- a/server/src/main/java/org/apache/lucene/search/grouping/CollapsingDocValuesSource.java
+++ b/server/src/main/java/org/apache/lucene/search/grouping/CollapsingDocValuesSource.java
@@ -30,6 +30,7 @@
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.index.fielddata.AbstractNumericDocValues;
 import org.elasticsearch.index.fielddata.AbstractSortedDocValues;
+import org.elasticsearch.index.mapper.MappedFieldType;
 
 import java.io.IOException;
 import java.util.Collection;
@@ -58,8 +59,8 @@ static class Numeric extends CollapsingDocValuesSource<Long> {
         private long value;
         private boolean hasValue;
 
-        Numeric(String field) {
-            super(field);
+        Numeric(MappedFieldType fieldType) {
+            super(fieldType.name());
         }
 
         @Override
@@ -148,8 +149,8 @@ static class Keyword extends CollapsingDocValuesSource<BytesRef> {
         private SortedDocValues values;
         private int ord;
 
-        Keyword(String field) {
-            super(field);
+        Keyword(MappedFieldType fieldType) {
+            super(fieldType.name());
         }
 
         @Override
diff --git a/server/src/main/java/org/apache/lucene/search/grouping/CollapsingTopDocsCollector.java b/server/src/main/java/org/apache/lucene/search/grouping/CollapsingTopDocsCollector.java
index e28d8990c91e3..90ed8773abd24 100644
--- a/server/src/main/java/org/apache/lucene/search/grouping/CollapsingTopDocsCollector.java
+++ b/server/src/main/java/org/apache/lucene/search/grouping/CollapsingTopDocsCollector.java
@@ -25,6 +25,7 @@
 import org.apache.lucene.search.Sort;
 import org.apache.lucene.search.SortField;
 import org.apache.lucene.search.TotalHits;
+import org.elasticsearch.index.mapper.MappedFieldType;
 
 import java.io.IOException;
 import java.util.Collection;
@@ -119,17 +120,19 @@ public void collect(int doc) throws IOException {
      * the collect will fail with an {@link IllegalStateException} if a document contains more than one value for the
      * field.
      *
-     * @param collapseField The sort field used to group
-     *                      documents.
-     * @param sort          The {@link Sort} used to sort the collapsed hits.
-     *                      The collapsing keeps only the top sorted document per collapsed key.
-     *                      This must be non-null, ie, if you want to groupSort by relevance
-     *                      use Sort.RELEVANCE.
-     * @param topN          How many top groups to keep.
+     * @param collapseField     The sort field used to group documents.
+     * @param collapseFieldType The {@link MappedFieldType} for this sort field.
+     * @param sort              The {@link Sort} used to sort the collapsed hits.
+     *                          The collapsing keeps only the top sorted document per collapsed key.
+     *                          This must be non-null, ie, if you want to groupSort by relevance
+     *                          use Sort.RELEVANCE.
+     * @param topN              How many top groups to keep.
      */
-    public static CollapsingTopDocsCollector<?> createNumeric(String collapseField, Sort sort,
+    public static CollapsingTopDocsCollector<?> createNumeric(String collapseField,
+                                                              MappedFieldType collapseFieldType,
+                                                              Sort sort,
                                                               int topN)  {
-        return new CollapsingTopDocsCollector<>(new CollapsingDocValuesSource.Numeric(collapseField),
+        return new CollapsingTopDocsCollector<>(new CollapsingDocValuesSource.Numeric(collapseFieldType),
                 collapseField, sort, topN);
     }
 
@@ -139,16 +142,18 @@ public static CollapsingTopDocsCollector<?> createNumeric(String collapseField,
      * the collect will fail with an {@link IllegalStateException} if a document contains more than one value for the
      * field.
      *
-     * @param collapseField The sort field used to group
-     *                      documents.
-     * @param sort          The {@link Sort} used to sort the collapsed hits. The collapsing keeps only the top sorted
-     *                      document per collapsed key.
-     *                      This must be non-null, ie, if you want to groupSort by relevance use Sort.RELEVANCE.
-     * @param topN          How many top groups to keep.
+     * @param collapseField     The sort field used to group documents.
+     * @param collapseFieldType The {@link MappedFieldType} for this sort field.
+     * @param sort              The {@link Sort} used to sort the collapsed hits. The collapsing keeps only the top sorted
+     *                          document per collapsed key.
+     *                          This must be non-null, ie, if you want to groupSort by relevance use Sort.RELEVANCE.
+     * @param topN              How many top groups to keep.
      */
-    public static CollapsingTopDocsCollector<?> createKeyword(String collapseField, Sort sort,
+    public static CollapsingTopDocsCollector<?> createKeyword(String collapseField,
+                                                              MappedFieldType collapseFieldType,
+                                                              Sort sort,
                                                               int topN)  {
-        return new CollapsingTopDocsCollector<>(new CollapsingDocValuesSource.Keyword(collapseField),
+        return new CollapsingTopDocsCollector<>(new CollapsingDocValuesSource.Keyword(collapseFieldType),
                 collapseField, sort, topN);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/collapse/CollapseContext.java b/server/src/main/java/org/elasticsearch/search/collapse/CollapseContext.java
index 4d8a1ba63ba15..b197d547913c0 100644
--- a/server/src/main/java/org/elasticsearch/search/collapse/CollapseContext.java
+++ b/server/src/main/java/org/elasticsearch/search/collapse/CollapseContext.java
@@ -62,11 +62,11 @@ public List<InnerHitBuilder> getInnerHit() {
 
     public CollapsingTopDocsCollector<?> createTopDocs(Sort sort, int topN) {
         if (fieldType instanceof KeywordFieldMapper.KeywordFieldType) {
-            return CollapsingTopDocsCollector.createKeyword(fieldType.name(), sort, topN);
+            return CollapsingTopDocsCollector.createKeyword(fieldName, fieldType, sort, topN);
         } else if (fieldType instanceof NumberFieldMapper.NumberFieldType) {
-            return CollapsingTopDocsCollector.createNumeric(fieldType.name(), sort, topN);
+            return CollapsingTopDocsCollector.createNumeric(fieldName, fieldType, sort, topN);
         } else {
-            throw new IllegalStateException("unknown type for collapse field " + fieldType.name() +
+            throw new IllegalStateException("unknown type for collapse field " + fieldName +
                 ", only keywords and numbers are accepted");
         }
     }
diff --git a/server/src/test/java/org/apache/lucene/grouping/CollapsingTopDocsCollectorTests.java b/server/src/test/java/org/apache/lucene/grouping/CollapsingTopDocsCollectorTests.java
index 50c80b8e4350d..bec14c973e92c 100644
--- a/server/src/test/java/org/apache/lucene/grouping/CollapsingTopDocsCollectorTests.java
+++ b/server/src/test/java/org/apache/lucene/grouping/CollapsingTopDocsCollectorTests.java
@@ -48,6 +48,8 @@
 import org.apache.lucene.store.Directory;
 import org.apache.lucene.util.BytesRef;
 import org.apache.lucene.util.NumericUtils;
+import org.elasticsearch.index.mapper.MappedFieldType;
+import org.elasticsearch.index.mapper.MockFieldMapper;
 import org.elasticsearch.test.ESTestCase;
 
 import java.io.IOException;
@@ -108,6 +110,7 @@ private <T extends Comparable<T>> void assertSearchCollapse(CollapsingDocValuesP
             w.addDocument(doc);
             totalHits++;
         }
+
         List<T> valueList = new ArrayList<>(values);
         Collections.sort(valueList);
         final IndexReader reader = w.getReader();
@@ -117,15 +120,18 @@ private <T extends Comparable<T>> void assertSearchCollapse(CollapsingDocValuesP
         final SortField sort2 = new SortField("sort2", SortField.Type.LONG);
         Sort sort = new Sort(sort1, sort2, collapseField);
 
+        MappedFieldType fieldType = new MockFieldMapper.FakeFieldType();
+        fieldType.setName(collapseField.getField());
+
         int expectedNumGroups = values.size();
 
         final CollapsingTopDocsCollector<?> collapsingCollector;
         if (numeric) {
             collapsingCollector =
-                CollapsingTopDocsCollector.createNumeric(collapseField.getField(), sort, expectedNumGroups);
+                CollapsingTopDocsCollector.createNumeric(collapseField.getField(), fieldType, sort, expectedNumGroups);
         } else {
             collapsingCollector =
-                CollapsingTopDocsCollector.createKeyword(collapseField.getField(), sort, expectedNumGroups);
+                CollapsingTopDocsCollector.createKeyword(collapseField.getField(), fieldType, sort, expectedNumGroups);
         }
 
         TopFieldCollector topFieldCollector =
@@ -195,9 +201,9 @@ private <T extends Comparable<T>> void assertSearchCollapse(CollapsingDocValuesP
             final SegmentSearcher subSearcher = subSearchers[shardIDX];
             final CollapsingTopDocsCollector<?> c;
             if (numeric) {
-                c = CollapsingTopDocsCollector.createNumeric(collapseField.getField(), sort, expectedNumGroups);
+                c = CollapsingTopDocsCollector.createNumeric(collapseField.getField(), fieldType, sort, expectedNumGroups);
             } else {
-                c = CollapsingTopDocsCollector.createKeyword(collapseField.getField(), sort, expectedNumGroups);
+                c = CollapsingTopDocsCollector.createKeyword(collapseField.getField(), fieldType, sort, expectedNumGroups);
             }
             subSearcher.search(weight, c);
             shardHits[shardIDX] = c.getTopDocs();
@@ -374,11 +380,16 @@ public void testEmptyNumericSegment() throws Exception {
         w.commit();
         final IndexReader reader = w.getReader();
         final IndexSearcher searcher = newSearcher(reader);
+
+        MappedFieldType fieldType = new MockFieldMapper.FakeFieldType();
+        fieldType.setName("group");
+
         SortField sortField = new SortField("group", SortField.Type.LONG);
         sortField.setMissingValue(Long.MAX_VALUE);
         Sort sort = new Sort(sortField);
+
         final CollapsingTopDocsCollector<?> collapsingCollector =
-                CollapsingTopDocsCollector.createNumeric("group", sort, 10);
+                CollapsingTopDocsCollector.createNumeric("group", fieldType, sort, 10);
         searcher.search(new MatchAllDocsQuery(), collapsingCollector);
         CollapseTopFieldDocs collapseTopFieldDocs = collapsingCollector.getTopDocs();
         assertEquals(4, collapseTopFieldDocs.scoreDocs.length);
@@ -412,9 +423,14 @@ public void testEmptySortedSegment() throws Exception {
         w.commit();
         final IndexReader reader = w.getReader();
         final IndexSearcher searcher = newSearcher(reader);
+
+        MappedFieldType fieldType = new MockFieldMapper.FakeFieldType();
+        fieldType.setName("group");
+
         Sort sort = new Sort(new SortField("group", SortField.Type.STRING_VAL));
+
         final CollapsingTopDocsCollector<?> collapsingCollector =
-            CollapsingTopDocsCollector.createKeyword("group", sort, 10);
+            CollapsingTopDocsCollector.createKeyword("group", fieldType, sort, 10);
         searcher.search(new MatchAllDocsQuery(), collapsingCollector);
         CollapseTopFieldDocs collapseTopFieldDocs = collapsingCollector.getTopDocs();
         assertEquals(4, collapseTopFieldDocs.scoreDocs.length);

From 6fcb6b4ee06bd60e8f5d436f8c6fd5982ff110dc Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Wed, 8 Jan 2020 16:51:41 -0500
Subject: [PATCH 462/686] Remove UBI-based Docker images (#50747)

This commit removes the UBI-based Docker images as we are not using this
work for now.
---
 distribution/docker/build.gradle              | 63 +++++++++----------
 .../docker/docker-build-context/build.gradle  |  2 +-
 .../oss-docker-build-context/build.gradle     |  2 +-
 distribution/docker/src/docker/Dockerfile     | 16 ++---
 .../ubi-docker-build-context/build.gradle     | 11 ----
 .../docker/ubi-docker-export/build.gradle     |  2 -
 settings.gradle                               |  2 -
 7 files changed, 39 insertions(+), 59 deletions(-)
 delete mode 100644 distribution/docker/ubi-docker-build-context/build.gradle
 delete mode 100644 distribution/docker/ubi-docker-export/build.gradle

diff --git a/distribution/docker/build.gradle b/distribution/docker/build.gradle
index 690299061c839..95755b1800630 100644
--- a/distribution/docker/build.gradle
+++ b/distribution/docker/build.gradle
@@ -22,31 +22,29 @@ dependencies {
   restSpec project(':rest-api-spec')
 }
 
-ext.expansions = { oss, ubi, local ->
+ext.expansions = { oss, local ->
   final String classifier = 'linux-x86_64'
   final String elasticsearch = oss ? "elasticsearch-oss-${VersionProperties.elasticsearch}-${classifier}.tar.gz" : "elasticsearch-${VersionProperties.elasticsearch}-${classifier}.tar.gz"
   return [
-    'base_image'          : ubi ? 'registry.access.redhat.com/ubi7/ubi-minimal:7.7' : 'centos:7',
     'build_date'          : BuildParams.buildDate,
     'elasticsearch'       : elasticsearch,
     'git_revision'        : BuildParams.gitRevision,
     'license'             : oss ? 'Apache-2.0' : 'Elastic-License',
-    'package_manager'     : ubi ? 'microdnf' : 'yum',
     'source_elasticsearch': local ? "COPY $elasticsearch /opt/" : "RUN cd /opt && curl --retry 8 -s -L -O https://artifacts.elastic.co/downloads/elasticsearch/${elasticsearch} && cd -",
     'version'             : VersionProperties.elasticsearch
   ]
 }
 
-private static String buildPath(final boolean oss, final boolean ubi) {
-  return "build/${oss ? 'oss-' : ''}${ubi ? 'ubi-' : ''}docker"
+private static String buildPath(final boolean oss) {
+  return "build/${oss ? 'oss-' : ''}docker"
 }
 
-private static String taskName(final String prefix, final boolean oss, final boolean ubi, final String suffix) {
-  return "${prefix}${oss ? 'Oss' : ''}${ubi ? 'Ubi' : ''}${suffix}"
+private static String taskName(final String prefix, final boolean oss, final String suffix) {
+  return "${prefix}${oss ? 'Oss' : ''}${suffix}"
 }
 
 project.ext {
-  dockerBuildContext = { boolean oss, boolean ubi, boolean local ->
+  dockerBuildContext = { boolean oss, boolean local ->
     copySpec {
       into('bin') {
         from project.projectDir.toPath().resolve("src/docker/bin")
@@ -64,20 +62,20 @@ project.ext {
       }
 
       from(project.projectDir.toPath().resolve("src/docker/Dockerfile")) {
-        expand(expansions(oss, ubi, local))
+        expand(expansions(oss, local))
       }
     }
   }
 }
 
-void addCopyDockerContextTask(final boolean oss, final boolean ubi) {
-  task(taskName("copy", oss, ubi, "DockerContext"), type: Sync) {
-    expansions(oss, ubi, true).findAll { it.key != 'build_date' }.each { k, v ->
+void addCopyDockerContextTask(final boolean oss) {
+  task(taskName("copy", oss, "DockerContext"), type: Sync) {
+    expansions(oss, true).findAll { it.key != 'build_date' }.each { k, v ->
       inputs.property(k, { v.toString() })
     }
-    into buildPath(oss, ubi)
+    into buildPath(oss)
 
-    with dockerBuildContext(oss, ubi, true)
+    with dockerBuildContext(oss, true)
 
     if (oss) {
       from configurations.ossDockerSource
@@ -149,25 +147,25 @@ task integTest(type: Test) {
 
 check.dependsOn integTest
 
-void addBuildDockerImage(final boolean oss, final boolean ubi) {
-  final Task buildDockerImageTask = task(taskName("build", oss, ubi, "DockerImage"), type: LoggedExec) {
-    inputs.files(tasks.named(taskName("copy", oss, ubi, "DockerContext")))
+void addBuildDockerImage(final boolean oss) {
+  final Task buildDockerImageTask = task(taskName("build", oss, "DockerImage"), type: LoggedExec) {
+    inputs.files(tasks.named(taskName("copy", oss, "DockerContext")))
     List<String> tags
     if (oss) {
       tags = [
-        "docker.elastic.co/elasticsearch/elasticsearch-oss${ubi ? '-ubi7' : ''}:${VersionProperties.elasticsearch}",
-        "elasticsearch-oss${ubi ? '-ubi7' : ''}:test"
+        "docker.elastic.co/elasticsearch/elasticsearch-oss:${VersionProperties.elasticsearch}",
+        "elasticsearch-oss:test"
       ]
     } else {
       tags = [
-        "elasticsearch${ubi ? '-ubi7' : ''}:${VersionProperties.elasticsearch}",
-        "docker.elastic.co/elasticsearch/elasticsearch${ubi ? '-ubi7' : ''}:${VersionProperties.elasticsearch}",
-        "docker.elastic.co/elasticsearch/elasticsearch${ubi ? '-ubi7' : ''}-full:${VersionProperties.elasticsearch}",
-        "elasticsearch${ubi ? '-ubi7' : ''}:test",
+        "elasticsearch:${VersionProperties.elasticsearch}",
+        "docker.elastic.co/elasticsearch/elasticsearch:${VersionProperties.elasticsearch}",
+        "docker.elastic.co/elasticsearch/elasticsearch-full:${VersionProperties.elasticsearch}",
+        "elasticsearch:test",
       ]
     }
     executable 'docker'
-    final List<String> dockerArgs = ['build', buildPath(oss, ubi), '--pull', '--no-cache']
+    final List<String> dockerArgs = ['build', buildPath(oss), '--pull', '--no-cache']
     for (final String tag : tags) {
       dockerArgs.add('--tag')
       dockerArgs.add(tag)
@@ -184,10 +182,8 @@ void addBuildDockerImage(final boolean oss, final boolean ubi) {
 }
 
 for (final boolean oss : [false, true]) {
-  for (final boolean ubi : [false, true]) {
-    addCopyDockerContextTask(oss, ubi)
-    addBuildDockerImage(oss, ubi)
-  }
+  addCopyDockerContextTask(oss)
+  addBuildDockerImage(oss)
 }
 
 // We build the images used in compose locally, but the pull command insists on using a repository
@@ -206,11 +202,10 @@ subprojects { Project subProject ->
     apply plugin: 'distribution'
 
     final boolean oss = subProject.name.contains('oss-')
-    final boolean ubi = subProject.name.contains('ubi-')
 
-    def exportTaskName = taskName("export", oss, ubi, "DockerImage")
-    def buildTaskName = taskName("build", oss, ubi, "DockerImage")
-    def tarFile = "${parent.projectDir}/build/elasticsearch${oss ? '-oss' : ''}${ubi ? '-ubi7' : ''}_test.${VersionProperties.elasticsearch}.docker.tar"
+    def exportTaskName = taskName("export", oss, "DockerImage")
+    def buildTaskName = taskName("build", oss, "DockerImage")
+    def tarFile = "${parent.projectDir}/build/elasticsearch${oss ? '-oss' : ''}_test.${VersionProperties.elasticsearch}.docker.tar"
 
     final Task exportDockerImageTask = task(exportTaskName, type: LoggedExec) {
       executable 'docker'
@@ -218,14 +213,14 @@ subprojects { Project subProject ->
       args "save",
         "-o",
         tarFile,
-        "elasticsearch${oss ? '-oss' : ''}${ubi ? '-ubi7' : ''}:test"
+        "elasticsearch${oss ? '-oss' : ''}:test"
     }
 
     exportDockerImageTask.dependsOn(parent.tasks.getByName(buildTaskName))
 
     artifacts.add('default', file(tarFile)) {
       type 'tar'
-      name "elasticsearch${oss ? '-oss' : ''}${ubi ? '-ubi7' : ''}"
+      name "elasticsearch${oss ? '-oss' : ''}"
       builtBy exportTaskName
     }
 
diff --git a/distribution/docker/docker-build-context/build.gradle b/distribution/docker/docker-build-context/build.gradle
index 56c76befc682d..50be407e566bc 100644
--- a/distribution/docker/docker-build-context/build.gradle
+++ b/distribution/docker/docker-build-context/build.gradle
@@ -5,7 +5,7 @@ task buildDockerBuildContext(type: Tar) {
   compression = Compression.GZIP
   archiveClassifier = "docker-build-context"
   archiveBaseName = "elasticsearch"
-  with dockerBuildContext(false, false, false)
+  with dockerBuildContext(false, false)
 }
 
 assemble.dependsOn buildDockerBuildContext
diff --git a/distribution/docker/oss-docker-build-context/build.gradle b/distribution/docker/oss-docker-build-context/build.gradle
index 2910ed3f7781f..b69f7dc620f53 100644
--- a/distribution/docker/oss-docker-build-context/build.gradle
+++ b/distribution/docker/oss-docker-build-context/build.gradle
@@ -5,7 +5,7 @@ task buildOssDockerBuildContext(type: Tar) {
   compression = Compression.GZIP
   archiveClassifier = "docker-build-context"
   archiveBaseName = "elasticsearch-oss"
-  with dockerBuildContext(true, false, false)
+  with dockerBuildContext(true, false)
 }
 
 assemble.dependsOn buildOssDockerBuildContext
diff --git a/distribution/docker/src/docker/Dockerfile b/distribution/docker/src/docker/Dockerfile
index 0f9087b143e3d..41113d1d59694 100644
--- a/distribution/docker/src/docker/Dockerfile
+++ b/distribution/docker/src/docker/Dockerfile
@@ -11,11 +11,11 @@
 # Set gid=0 and make group perms==owner perms
 ################################################################################
 
-FROM ${base_image} AS builder
+FROM centos:7 AS builder
 
-RUN for iter in {1..10}; do ${package_manager} update --setopt=tsflags=nodocs -y && \
-    ${package_manager} install --setopt=tsflags=nodocs -y gzip shadow-utils tar && \
-    ${package_manager} clean all && exit_code=0 && break || exit_code=\$? && echo "${package_manager} error: retry \$iter in 10s" && sleep 10; done; \
+RUN for iter in {1..10}; do yum update --setopt=tsflags=nodocs -y && \
+    yum install --setopt=tsflags=nodocs -y gzip shadow-utils tar && \
+    yum clean all && exit_code=0 && break || exit_code=\$? && echo "yum error: retry \$iter in 10s" && sleep 10; done; \
     (exit \$exit_code)
 
 ENV PATH /usr/share/elasticsearch/bin:\$PATH
@@ -41,13 +41,13 @@ RUN chmod 0660 config/elasticsearch.yml config/log4j2.properties
 # Add entrypoint
 ################################################################################
 
-FROM ${base_image}
+FROM centos:7
 
 ENV ELASTIC_CONTAINER true
 
-RUN for iter in {1..10}; do ${package_manager} update --setopt=tsflags=nodocs -y && \
-    ${package_manager} install --setopt=tsflags=nodocs -y nc shadow-utils zip unzip && \
-    ${package_manager} clean all && exit_code=0 && break || exit_code=\$? && echo "${package_manager} error: retry \$iter in 10s" && sleep 10; done; \
+RUN for iter in {1..10}; do yum update --setopt=tsflags=nodocs -y && \
+    yum install --setopt=tsflags=nodocs -y nc shadow-utils zip unzip && \
+    yum clean all && exit_code=0 && break || exit_code=\$? && echo "yum error: retry \$iter in 10s" && sleep 10; done; \
     (exit \$exit_code)
 
 RUN groupadd -g 1000 elasticsearch && \
diff --git a/distribution/docker/ubi-docker-build-context/build.gradle b/distribution/docker/ubi-docker-build-context/build.gradle
deleted file mode 100644
index e59e4ddc9abf3..0000000000000
--- a/distribution/docker/ubi-docker-build-context/build.gradle
+++ /dev/null
@@ -1,11 +0,0 @@
-apply plugin: 'base'
-
-task buildUbiDockerBuildContext(type: Tar) {
-  extension = 'tar.gz'
-  compression = Compression.GZIP
-  archiveClassifier = "docker-build-context"
-  archiveBaseName = "elasticsearch-ubi7"
-  with dockerBuildContext(false, true, false)
-}
-
-assemble.dependsOn buildUbiDockerBuildContext
diff --git a/distribution/docker/ubi-docker-export/build.gradle b/distribution/docker/ubi-docker-export/build.gradle
deleted file mode 100644
index 537b5a093683e..0000000000000
--- a/distribution/docker/ubi-docker-export/build.gradle
+++ /dev/null
@@ -1,2 +0,0 @@
-// This file is intentionally blank. All configuration of the
-// export is done in the parent project.
diff --git a/settings.gradle b/settings.gradle
index 0d3c40a00ff7f..e446e67f3ee7a 100644
--- a/settings.gradle
+++ b/settings.gradle
@@ -36,8 +36,6 @@ List projects = [
   'distribution:docker:docker-export',
   'distribution:docker:oss-docker-build-context',
   'distribution:docker:oss-docker-export',
-  'distribution:docker:ubi-docker-build-context',
-  'distribution:docker:ubi-docker-export',
   'distribution:packages:oss-deb',
   'distribution:packages:deb',
   'distribution:packages:oss-no-jdk-deb',

From e38de2eebb16199c7ca1413ddb62afae85910638 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 8 Jan 2020 13:56:36 -0800
Subject: [PATCH 463/686] Another attempt to work around the JJBB job workspace
 issue

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 .ci/jobs.t/defaults.yml                                        | 1 +
 .../elastic+elasticsearch+{branch}+docker-test-ramdisk.yml     | 3 ---
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/.ci/jobs.t/defaults.yml b/.ci/jobs.t/defaults.yml
index fdd16dd4900a9..f1a774538c1a3 100644
--- a/.ci/jobs.t/defaults.yml
+++ b/.ci/jobs.t/defaults.yml
@@ -39,6 +39,7 @@
       - inject:
           properties-file: '.ci/java-versions.properties'
           properties-content: |
+            WORKSPACE=/dev/shm/$JOB_NAME
             JAVA_HOME=$HOME/.java/$ES_BUILD_JAVA
             RUNTIME_JAVA_HOME=$HOME/.java/$ES_RUNTIME_JAVA
             JAVA7_HOME=$HOME/.java/java7
diff --git a/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml b/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
index 79b5600582706..4d1088823268a 100644
--- a/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
+++ b/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
@@ -7,9 +7,6 @@
     triggers:
       - timed: "H/10 * * * *"
     builders:
-      - inject:
-          properties-content: |
-            WORKSPACE=/dev/shm/elastic+elasticsearch+%BRANCH%+docker-test
       - shell: |
           #!/usr/local/bin/runbld --redirect-stderr --last-good-commit elastic+elasticsearch+%BRANCH%+git+push
           .ci/build.sh -Dbwc.checkout.align=true -p test.fixtures composeUp

From 3465efa60d9fcdc893debb9186321d4a2ac3b48d Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 8 Jan 2020 14:08:52 -0800
Subject: [PATCH 464/686] Disable the build trigger until we sort out the JJBB
 workspace issue

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 .../elastic+elasticsearch+{branch}+docker-test-ramdisk.yml   | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml b/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
index 4d1088823268a..d920109bdbd90 100644
--- a/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
+++ b/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
@@ -4,9 +4,8 @@
     display-name: "elastic / elasticsearch # %BRANCH% - docker test ramdisk (experimental)"
     description: "Experimental test job to shake out issues with Docker in CI\n"
     node: "(debian-10 || sles-12 || debian-8 || sles-15) && immutable"
-    triggers:
-      - timed: "H/10 * * * *"
+    triggers: []
     builders:
       - shell: |
           #!/usr/local/bin/runbld --redirect-stderr --last-good-commit elastic+elasticsearch+%BRANCH%+git+push
-          .ci/build.sh -Dbwc.checkout.align=true -p test.fixtures composeUp
+          .ci/build.sh -Dbwc.checkout.align=true -p test/fixtures composeUp

From 027546b91436b67e3de8d5c197a490eeda2ba225 Mon Sep 17 00:00:00 2001
From: Jake Landis <jake.landis@elastic.co>
Date: Wed, 8 Jan 2020 17:13:29 -0600
Subject: [PATCH 465/686] Foreach processor - fork recursive call (#50514)

A very large number of recursive calls can cause a stack overflow
exception. This commit forks the recursive calls for non-async
processors. Once forked, each thread will handle at most 10
recursive calls to help keep the stack size and thread count
down to a reasonable size.
---
 .../ingest/common/ForEachProcessor.java       |  28 +++-
 .../ingest/common/IngestCommonPlugin.java     |   2 +-
 .../common/ForEachProcessorFactoryTests.java  |  14 +-
 .../ingest/common/ForEachProcessorTests.java  | 143 ++++++++++++++++--
 .../rest-api-spec/test/ingest/80_foreach.yml  |  19 +++
 .../elasticsearch/ingest/IngestService.java   |   3 +-
 .../org/elasticsearch/ingest/Processor.java   |   6 +-
 .../ingest/IngestServiceTests.java            |  28 ++--
 ...sportGetTrainedModelsStatsActionTests.java |   4 +
 .../InferenceProcessorFactoryTests.java       |   4 +
 10 files changed, 213 insertions(+), 38 deletions(-)

diff --git a/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/ForEachProcessor.java b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/ForEachProcessor.java
index 681b167c828e1..11c1d3e2ea764 100644
--- a/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/ForEachProcessor.java
+++ b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/ForEachProcessor.java
@@ -23,6 +23,8 @@
 import org.elasticsearch.ingest.ConfigurationUtils;
 import org.elasticsearch.ingest.IngestDocument;
 import org.elasticsearch.ingest.Processor;
+import org.elasticsearch.ingest.WrappingProcessor;
+import org.elasticsearch.script.ScriptService;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -30,9 +32,7 @@
 import java.util.Set;
 import java.util.concurrent.CopyOnWriteArrayList;
 import java.util.function.BiConsumer;
-
-import org.elasticsearch.ingest.WrappingProcessor;
-import org.elasticsearch.script.ScriptService;
+import java.util.function.Consumer;
 
 import static org.elasticsearch.ingest.ConfigurationUtils.newConfigurationException;
 import static org.elasticsearch.ingest.ConfigurationUtils.readBooleanProperty;
@@ -50,16 +50,19 @@
 public final class ForEachProcessor extends AbstractProcessor implements WrappingProcessor {
 
     public static final String TYPE = "foreach";
+    static final int MAX_RECURSE_PER_THREAD = 10;
 
     private final String field;
     private final Processor processor;
     private final boolean ignoreMissing;
+    private final Consumer<Runnable> genericExecutor;
 
-    ForEachProcessor(String tag, String field, Processor processor, boolean ignoreMissing) {
+    ForEachProcessor(String tag, String field, Processor processor, boolean ignoreMissing, Consumer<Runnable> genericExecutor) {
         super(tag);
         this.field = field;
         this.processor = processor;
         this.ignoreMissing = ignoreMissing;
+        this.genericExecutor = genericExecutor;
     }
 
     boolean isIgnoreMissing() {
@@ -91,6 +94,7 @@ void innerExecute(int index, List<?> values, List<Object> newValues, IngestDocum
 
         Object value = values.get(index);
         Object previousValue = document.getIngestMetadata().put("_value", value);
+        final Thread thread = Thread.currentThread();
         processor.execute(document, (result, e) -> {
             if (e != null)  {
                 newValues.add(document.getIngestMetadata().put("_value", previousValue));
@@ -99,7 +103,15 @@ void innerExecute(int index, List<?> values, List<Object> newValues, IngestDocum
                 handler.accept(null, null);
             } else {
                 newValues.add(document.getIngestMetadata().put("_value", previousValue));
-                innerExecute(index + 1, values, newValues, document, handler);
+                if (thread == Thread.currentThread() && (index + 1) % MAX_RECURSE_PER_THREAD == 0) {
+                    // we are on the same thread and we need to fork to another thread to avoid recursive stack overflow on a single thread
+                    // only fork after 10 recursive calls, then fork every 10 to keep the number of threads down
+                    genericExecutor.accept(() -> innerExecute(index + 1, values, newValues, document, handler));
+                } else {
+                    // we are on a different thread (we went asynchronous), it's safe to recurse
+                    // or we have recursed less then 10 times with the same thread, it's safe to recurse
+                    innerExecute(index + 1, values, newValues, document, handler);
+                }
             }
         });
     }
@@ -125,9 +137,11 @@ public Processor getInnerProcessor() {
     public static final class Factory implements Processor.Factory {
 
         private final ScriptService scriptService;
+        private final Consumer<Runnable> genericExecutor;
 
-        Factory(ScriptService scriptService) {
+        Factory(ScriptService scriptService, Consumer<Runnable> genericExecutor) {
             this.scriptService = scriptService;
+            this.genericExecutor = genericExecutor;
         }
 
         @Override
@@ -143,7 +157,7 @@ public ForEachProcessor create(Map<String, Processor.Factory> factories, String
             Map.Entry<String, Map<String, Object>> entry = entries.iterator().next();
             Processor processor =
                 ConfigurationUtils.readProcessor(factories, scriptService, entry.getKey(), entry.getValue());
-            return new ForEachProcessor(tag, field, processor, ignoreMissing);
+            return new ForEachProcessor(tag, field, processor, ignoreMissing, genericExecutor);
         }
     }
 }
diff --git a/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/IngestCommonPlugin.java b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/IngestCommonPlugin.java
index b37e5d13e4602..22c76e6b01d73 100644
--- a/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/IngestCommonPlugin.java
+++ b/modules/ingest-common/src/main/java/org/elasticsearch/ingest/common/IngestCommonPlugin.java
@@ -75,7 +75,7 @@ public Map<String, Processor.Factory> getProcessors(Processor.Parameters paramet
                 entry(ConvertProcessor.TYPE, new ConvertProcessor.Factory()),
                 entry(GsubProcessor.TYPE, new GsubProcessor.Factory()),
                 entry(FailProcessor.TYPE, new FailProcessor.Factory(parameters.scriptService)),
-                entry(ForEachProcessor.TYPE, new ForEachProcessor.Factory(parameters.scriptService)),
+                entry(ForEachProcessor.TYPE, new ForEachProcessor.Factory(parameters.scriptService, parameters.genericExecutor)),
                 entry(DateIndexNameProcessor.TYPE, new DateIndexNameProcessor.Factory(parameters.scriptService)),
                 entry(SortProcessor.TYPE, new SortProcessor.Factory()),
                 entry(GrokProcessor.TYPE, new GrokProcessor.Factory(GROK_PATTERNS, createGrokThreadWatchdog(parameters))),
diff --git a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/ForEachProcessorFactoryTests.java b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/ForEachProcessorFactoryTests.java
index 65fee8ce19a7d..19b3966573f7f 100644
--- a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/ForEachProcessorFactoryTests.java
+++ b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/ForEachProcessorFactoryTests.java
@@ -29,6 +29,7 @@
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
+import java.util.function.Consumer;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.mockito.Mockito.mock;
@@ -36,12 +37,13 @@
 public class ForEachProcessorFactoryTests extends ESTestCase {
 
     private final ScriptService scriptService = mock(ScriptService.class);
+    private final Consumer<Runnable> genericExecutor = Runnable::run;
 
     public void testCreate() throws Exception {
         Processor processor = new TestProcessor(ingestDocument -> { });
         Map<String, Processor.Factory> registry = new HashMap<>();
         registry.put("_name", (r, t, c) -> processor);
-        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService);
+        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService, genericExecutor);
 
         Map<String, Object> config = new HashMap<>();
         config.put("field", "_field");
@@ -57,7 +59,7 @@ public void testSetIgnoreMissing() throws Exception {
         Processor processor = new TestProcessor(ingestDocument -> { });
         Map<String, Processor.Factory> registry = new HashMap<>();
         registry.put("_name", (r, t, c) -> processor);
-        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService);
+        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService, genericExecutor);
 
         Map<String, Object> config = new HashMap<>();
         config.put("field", "_field");
@@ -75,7 +77,7 @@ public void testCreateWithTooManyProcessorTypes() throws Exception {
         Map<String, Processor.Factory> registry = new HashMap<>();
         registry.put("_first", (r, t, c) -> processor);
         registry.put("_second", (r, t, c) -> processor);
-        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService);
+        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService, genericExecutor);
 
         Map<String, Object> config = new HashMap<>();
         config.put("field", "_field");
@@ -88,7 +90,7 @@ public void testCreateWithTooManyProcessorTypes() throws Exception {
     }
 
     public void testCreateWithNonExistingProcessorType() throws Exception {
-        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService);
+        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService, genericExecutor);
         Map<String, Object> config = new HashMap<>();
         config.put("field", "_field");
         config.put("processor", Collections.singletonMap("_name", Collections.emptyMap()));
@@ -101,7 +103,7 @@ public void testCreateWithMissingField() throws Exception {
         Processor processor = new TestProcessor(ingestDocument -> { });
         Map<String, Processor.Factory> registry = new HashMap<>();
         registry.put("_name", (r, t, c) -> processor);
-        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService);
+        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService, genericExecutor);
         Map<String, Object> config = new HashMap<>();
         config.put("processor", Collections.singletonList(Collections.singletonMap("_name", Collections.emptyMap())));
         Exception exception = expectThrows(Exception.class, () -> forEachFactory.create(registry, null, config));
@@ -109,7 +111,7 @@ public void testCreateWithMissingField() throws Exception {
     }
 
     public void testCreateWithMissingProcessor() {
-        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService);
+        ForEachProcessor.Factory forEachFactory = new ForEachProcessor.Factory(scriptService, genericExecutor);
         Map<String, Object> config = new HashMap<>();
         config.put("field", "_field");
         Exception exception = expectThrows(Exception.class, () -> forEachFactory.create(Collections.emptyMap(), null, config));
diff --git a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/ForEachProcessorTests.java b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/ForEachProcessorTests.java
index cda203f660093..713b4a355bdab 100644
--- a/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/ForEachProcessorTests.java
+++ b/modules/ingest-common/src/test/java/org/elasticsearch/ingest/common/ForEachProcessorTests.java
@@ -19,6 +19,9 @@
 
 package org.elasticsearch.ingest.common;
 
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.concurrent.EsExecutors;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.ingest.CompoundProcessor;
 import org.elasticsearch.ingest.IngestDocument;
 import org.elasticsearch.ingest.Processor;
@@ -26,6 +29,7 @@
 import org.elasticsearch.ingest.TestTemplateService;
 import org.elasticsearch.script.TemplateScript;
 import org.elasticsearch.test.ESTestCase;
+import org.junit.Before;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -34,32 +38,98 @@
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.ThreadPoolExecutor;
+import java.util.concurrent.TimeUnit;
+import java.util.function.BiConsumer;
+import java.util.function.Consumer;
+import java.util.stream.IntStream;
 
 import static org.elasticsearch.ingest.IngestDocumentMatcher.assertIngestDocument;
 import static org.hamcrest.Matchers.equalTo;
+import static org.mockito.Matchers.any;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyZeroInteractions;
 
 public class ForEachProcessorTests extends ESTestCase {
 
+    @SuppressWarnings("unchecked")
+    private Consumer<Runnable> genericExecutor = (Consumer<Runnable>) mock(Consumer.class);
+    private final ExecutorService direct = EsExecutors.newDirectExecutorService();
+
+    @Before
+    public void setup() {
+        //execute runnable on same thread for simplicity. some tests will override this and actually run async
+        doAnswer(invocationOnMock -> {
+            direct.execute((Runnable) invocationOnMock.getArguments()[0]);
+            return null;
+        }).when(genericExecutor).accept(any(Runnable.class));
+    }
+
     public void testExecute() throws Exception {
+        ThreadPoolExecutor asyncExecutor =
+            EsExecutors.newScaling(getClass().getName() + "/" + getTestName(), between(1, 2), between(3, 4), 10, TimeUnit.SECONDS,
+                EsExecutors.daemonThreadFactory("test"), new ThreadContext(Settings.EMPTY));
+        doAnswer(invocationOnMock -> {
+            asyncExecutor.execute((Runnable) invocationOnMock.getArguments()[0]);
+            return null;
+        }).when(genericExecutor).accept(any(Runnable.class));
+
         List<String> values = new ArrayList<>();
         values.add("foo");
         values.add("bar");
         values.add("baz");
+        IntStream.range(0, ForEachProcessor.MAX_RECURSE_PER_THREAD).forEach(value -> values.add("a"));
         IngestDocument ingestDocument = new IngestDocument(
             "_index", "_id", null, null, null, Collections.singletonMap("values", values)
         );
 
         ForEachProcessor processor = new ForEachProcessor(
             "_tag", "values", new UppercaseProcessor("_tag", "_ingest._value", false, "_ingest._value"),
-            false
+            false, genericExecutor
         );
         processor.execute(ingestDocument, (result, e) -> {});
 
+        assertBusy(() -> assertEquals(values.size() / ForEachProcessor.MAX_RECURSE_PER_THREAD, asyncExecutor.getCompletedTaskCount()));
+        asyncExecutor.shutdown();
+        asyncExecutor.awaitTermination(5, TimeUnit.SECONDS);
+
         @SuppressWarnings("unchecked")
         List<String> result = ingestDocument.getFieldValue("values", List.class);
         assertThat(result.get(0), equalTo("FOO"));
         assertThat(result.get(1), equalTo("BAR"));
         assertThat(result.get(2), equalTo("BAZ"));
+        IntStream.range(3, ForEachProcessor.MAX_RECURSE_PER_THREAD + 3).forEach(i -> assertThat(result.get(i), equalTo("A")));
+        verify(genericExecutor, times(values.size() / ForEachProcessor.MAX_RECURSE_PER_THREAD)).accept(any(Runnable.class));
+    }
+
+    public void testExecuteWithAsyncProcessor() throws Exception {
+        List<String> values = new ArrayList<>();
+        values.add("foo");
+        values.add("bar");
+        values.add("baz");
+        IngestDocument ingestDocument = new IngestDocument(
+            "_index", "_id", null, null, null, Collections.singletonMap("values", values)
+        );
+
+        ForEachProcessor processor = new ForEachProcessor("_tag", "values", new AsyncUpperCaseProcessor("_ingest._value"),
+            false, genericExecutor);
+        processor.execute(ingestDocument, (result, e) -> {
+        });
+
+        assertBusy(() -> {
+            @SuppressWarnings("unchecked")
+            List<String> result = ingestDocument.getFieldValue("values", List.class);
+            assertEquals(values.size(), result.size());
+            assertThat(result.get(0), equalTo("FOO"));
+            assertThat(result.get(1), equalTo("BAR"));
+            assertThat(result.get(2), equalTo("BAZ"));
+        });
+
+        verifyZeroInteractions(genericExecutor);
     }
 
     public void testExecuteWithFailure() throws Exception {
@@ -72,7 +142,7 @@ public void testExecuteWithFailure() throws Exception {
                 throw new RuntimeException("failure");
             }
         });
-        ForEachProcessor processor = new ForEachProcessor("_tag", "values", testProcessor, false);
+        ForEachProcessor processor = new ForEachProcessor("_tag", "values", testProcessor, false, genericExecutor);
         Exception[] exceptions = new Exception[1];
         processor.execute(ingestDocument, (result, e) -> {exceptions[0] = e;});
         assertThat(exceptions[0].getMessage(), equalTo("failure"));
@@ -90,7 +160,7 @@ public void testExecuteWithFailure() throws Exception {
         Processor onFailureProcessor = new TestProcessor(ingestDocument1 -> {});
         processor = new ForEachProcessor(
             "_tag", "values", new CompoundProcessor(false, Arrays.asList(testProcessor), Arrays.asList(onFailureProcessor)),
-            false
+            false, genericExecutor
         );
         processor.execute(ingestDocument, (result, e) -> {});
         assertThat(testProcessor.getInvokedCounter(), equalTo(3));
@@ -109,7 +179,7 @@ public void testMetaDataAvailable() throws Exception {
             id.setFieldValue("_ingest._value.index", id.getSourceAndMetadata().get("_index"));
             id.setFieldValue("_ingest._value.id", id.getSourceAndMetadata().get("_id"));
         });
-        ForEachProcessor processor = new ForEachProcessor("_tag", "values", innerProcessor, false);
+        ForEachProcessor processor = new ForEachProcessor("_tag", "values", innerProcessor, false, genericExecutor);
         processor.execute(ingestDocument, (result, e) -> {});
 
         assertThat(innerProcessor.getInvokedCounter(), equalTo(2));
@@ -135,7 +205,7 @@ public void testRestOfTheDocumentIsAvailable() throws Exception {
         ForEachProcessor processor = new ForEachProcessor(
             "_tag", "values", new SetProcessor("_tag",
             new TestTemplateService.MockTemplateScript.Factory("_ingest._value.new_field"),
-            (model) -> model.get("other")), false);
+            (model) -> model.get("other")), false, genericExecutor);
         processor.execute(ingestDocument, (result, e) -> {});
 
         assertThat(ingestDocument.getFieldValue("values.0.new_field", String.class), equalTo("value"));
@@ -146,6 +216,13 @@ public void testRestOfTheDocumentIsAvailable() throws Exception {
     }
 
     public void testRandom() throws Exception {
+        ThreadPoolExecutor asyncExecutor =
+            EsExecutors.newScaling(getClass().getName() + "/" + getTestName(), between(1, 2), between(3, 4), 10, TimeUnit.SECONDS,
+                EsExecutors.daemonThreadFactory("test"), new ThreadContext(Settings.EMPTY));
+        doAnswer(invocationOnMock -> {
+            asyncExecutor.execute((Runnable) invocationOnMock.getArguments()[0]);
+            return null;
+        }).when(genericExecutor).accept(any(Runnable.class));
         Processor innerProcessor = new Processor() {
                 @Override
                 public IngestDocument execute(IngestDocument ingestDocument) throws Exception {
@@ -164,7 +241,7 @@ public String getTag() {
                     return null;
                 }
         };
-        int numValues = randomIntBetween(1, 32);
+        int numValues = randomIntBetween(1, 10000);
         List<String> values = new ArrayList<>(numValues);
         for (int i = 0; i < numValues; i++) {
             values.add("");
@@ -173,14 +250,20 @@ public String getTag() {
             "_index", "_id", null, null, null, Collections.singletonMap("values", values)
         );
 
-        ForEachProcessor processor = new ForEachProcessor("_tag", "values", innerProcessor, false);
+        ForEachProcessor processor = new ForEachProcessor("_tag", "values", innerProcessor, false, genericExecutor);
         processor.execute(ingestDocument, (result, e) -> {});
+
+        assertBusy(() -> assertEquals(values.size() / ForEachProcessor.MAX_RECURSE_PER_THREAD, asyncExecutor.getCompletedTaskCount()));
+        asyncExecutor.shutdown();
+        asyncExecutor.awaitTermination(5, TimeUnit.SECONDS);
+
         @SuppressWarnings("unchecked")
         List<String> result = ingestDocument.getFieldValue("values", List.class);
         assertThat(result.size(), equalTo(numValues));
         for (String r : result) {
             assertThat(r, equalTo("."));
         }
+        verify(genericExecutor, times(values.size() / ForEachProcessor.MAX_RECURSE_PER_THREAD)).accept(any(Runnable.class));
     }
 
     public void testModifyFieldsOutsideArray() throws Exception {
@@ -198,7 +281,7 @@ public void testModifyFieldsOutsideArray() throws Exception {
                 "_tag", "values", new CompoundProcessor(false,
                 Collections.singletonList(new UppercaseProcessor("_tag_upper", "_ingest._value", false, "_ingest._value")),
                 Collections.singletonList(new AppendProcessor("_tag", template, (model) -> (Collections.singletonList("added"))))
-        ), false);
+        ), false, genericExecutor);
         processor.execute(ingestDocument, (result, e) -> {});
 
         List<?> result = ingestDocument.getFieldValue("values", List.class);
@@ -224,7 +307,7 @@ public void testScalarValueAllowsUnderscoreValueFieldToRemainAccessible() throws
 
         TestProcessor processor = new TestProcessor(doc -> doc.setFieldValue("_ingest._value",
                 doc.getFieldValue("_source._value", String.class)));
-        ForEachProcessor forEachProcessor = new ForEachProcessor("_tag", "values", processor, false);
+        ForEachProcessor forEachProcessor = new ForEachProcessor("_tag", "values", processor, false, genericExecutor);
         forEachProcessor.execute(ingestDocument, (result, e) -> {});
 
         List<?> result = ingestDocument.getFieldValue("values", List.class);
@@ -257,7 +340,8 @@ public void testNestedForEach() throws Exception {
                 doc -> doc.setFieldValue("_ingest._value", doc.getFieldValue("_ingest._value", String.class).toUpperCase(Locale.ENGLISH))
         );
         ForEachProcessor processor = new ForEachProcessor(
-                "_tag", "values1", new ForEachProcessor("_tag", "_ingest._value.values2", testProcessor, false), false);
+                "_tag", "values1", new ForEachProcessor("_tag", "_ingest._value.values2", testProcessor, false, genericExecutor),
+            false, genericExecutor);
         processor.execute(ingestDocument, (result, e) -> {});
 
         List<?> result = ingestDocument.getFieldValue("values1.0.values2", List.class);
@@ -275,10 +359,47 @@ public void testIgnoreMissing() throws Exception {
         );
         IngestDocument ingestDocument = new IngestDocument(originalIngestDocument);
         TestProcessor testProcessor = new TestProcessor(doc -> {});
-        ForEachProcessor processor = new ForEachProcessor("_tag", "_ingest._value", testProcessor, true);
+        ForEachProcessor processor = new ForEachProcessor("_tag", "_ingest._value", testProcessor, true, genericExecutor);
         processor.execute(ingestDocument, (result, e) -> {});
         assertIngestDocument(originalIngestDocument, ingestDocument);
         assertThat(testProcessor.getInvokedCounter(), equalTo(0));
     }
 
+    private class AsyncUpperCaseProcessor implements Processor {
+
+        private final String field;
+
+        private AsyncUpperCaseProcessor(String field) {
+            this.field = field;
+        }
+
+        @Override
+        public void execute(IngestDocument document, BiConsumer<IngestDocument, Exception> handler) {
+            new Thread(() -> {
+                try {
+                    String value = document.getFieldValue(field, String.class, false);
+                    document.setFieldValue(field, value.toUpperCase(Locale.ROOT));
+                    handler.accept(document, null);
+                } catch (Exception e) {
+                    handler.accept(null, e);
+                }
+            }).start();
+        }
+
+        @Override
+        public IngestDocument execute(IngestDocument ingestDocument) throws Exception {
+            throw new UnsupportedOperationException("this is an async processor, don't call this");
+        }
+
+        @Override
+        public String getType() {
+            return "uppercase-async";
+        }
+
+        @Override
+        public String getTag() {
+            return getType();
+        }
+    }
+
 }
diff --git a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/80_foreach.yml b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/80_foreach.yml
index df27e4279c8d4..9142317ce1507 100644
--- a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/80_foreach.yml
+++ b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/80_foreach.yml
@@ -43,3 +43,22 @@ teardown:
         index: test
         id: 1
   - match: { _source.values: ["FOO", "BAR", "BAZ"] }
+
+ #exceeds the recurse max per thread and will runs some of these on a different thread
+  - do:
+      index:
+        index: test
+        id: 1
+        pipeline: "my_pipeline"
+        body: >
+          {
+            "values": ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u",
+                       "v", "w", "x", "y", "z"]
+          }
+
+  - do:
+      get:
+        index: test
+        id: 1
+  - match: { _source.values: ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U",
+                              "V", "W", "X", "Y", "Z"] }
diff --git a/server/src/main/java/org/elasticsearch/ingest/IngestService.java b/server/src/main/java/org/elasticsearch/ingest/IngestService.java
index 56b899f068b1c..939443d05a856 100644
--- a/server/src/main/java/org/elasticsearch/ingest/IngestService.java
+++ b/server/src/main/java/org/elasticsearch/ingest/IngestService.java
@@ -101,9 +101,10 @@ public IngestService(ClusterService clusterService, ThreadPool threadPool,
                 threadPool.getThreadContext(), threadPool::relativeTimeInMillis,
                 (delay, command) -> threadPool.schedule(
                     command, TimeValue.timeValueMillis(delay), ThreadPool.Names.GENERIC
-                ), this, client
+                ), this, client, threadPool.generic()::execute
             )
         );
+
         this.threadPool = threadPool;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/ingest/Processor.java b/server/src/main/java/org/elasticsearch/ingest/Processor.java
index 029e80234e9e8..671670212ab0a 100644
--- a/server/src/main/java/org/elasticsearch/ingest/Processor.java
+++ b/server/src/main/java/org/elasticsearch/ingest/Processor.java
@@ -29,6 +29,7 @@
 import java.util.Map;
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
+import java.util.function.Consumer;
 import java.util.function.LongSupplier;
 
 /**
@@ -122,6 +123,8 @@ class Parameters {
 
         public final IngestService ingestService;
 
+        public final Consumer<Runnable> genericExecutor;
+
         /**
          * Provides scheduler support
          */
@@ -134,7 +137,7 @@ class Parameters {
 
         public Parameters(Environment env, ScriptService scriptService, AnalysisRegistry analysisRegistry,  ThreadContext threadContext,
                           LongSupplier relativeTimeSupplier, BiFunction<Long, Runnable, Scheduler.ScheduledCancellable> scheduler,
-                          IngestService ingestService, Client client) {
+                          IngestService ingestService, Client client, Consumer<Runnable> genericExecutor ) {
             this.env = env;
             this.scriptService = scriptService;
             this.threadContext = threadContext;
@@ -143,6 +146,7 @@ public Parameters(Environment env, ScriptService scriptService, AnalysisRegistry
             this.scheduler = scheduler;
             this.ingestService = ingestService;
             this.client = client;
+            this.genericExecutor = genericExecutor;
         }
 
     }
diff --git a/server/src/test/java/org/elasticsearch/ingest/IngestServiceTests.java b/server/src/test/java/org/elasticsearch/ingest/IngestServiceTests.java
index 7890d30f6c4e3..0a16d5001638a 100644
--- a/server/src/test/java/org/elasticsearch/ingest/IngestServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/ingest/IngestServiceTests.java
@@ -60,6 +60,7 @@
 import org.elasticsearch.test.MockLogAppender;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.hamcrest.CustomTypeSafeMatcher;
+import org.junit.Before;
 import org.mockito.ArgumentMatcher;
 import org.mockito.invocation.InvocationOnMock;
 
@@ -111,10 +112,18 @@ public Map<String, Processor.Factory> getProcessors(Processor.Parameters paramet
         }
     };
 
+    private ThreadPool threadPool;
+
+    @Before
+    public void setup(){
+        threadPool = mock(ThreadPool.class);
+        ExecutorService executorService = EsExecutors.newDirectExecutorService();
+        when(threadPool.generic()).thenReturn(executorService);
+        when(threadPool.executor(anyString())).thenReturn(executorService);
+    }
     public void testIngestPlugin() {
-        ThreadPool tp = mock(ThreadPool.class);
         Client client = mock(Client.class);
-        IngestService ingestService = new IngestService(mock(ClusterService.class), tp, null, null,
+        IngestService ingestService = new IngestService(mock(ClusterService.class), threadPool, null, null,
             null, Collections.singletonList(DUMMY_PLUGIN), client);
         Map<String, Processor.Factory> factories = ingestService.getProcessorFactories();
         assertTrue(factories.containsKey("foo"));
@@ -122,19 +131,15 @@ public void testIngestPlugin() {
     }
 
     public void testIngestPluginDuplicate() {
-        ThreadPool tp = mock(ThreadPool.class);
         Client client = mock(Client.class);
         IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () ->
-            new IngestService(mock(ClusterService.class), tp, null, null,
+            new IngestService(mock(ClusterService.class), threadPool, null, null,
             null, Arrays.asList(DUMMY_PLUGIN, DUMMY_PLUGIN), client));
         assertTrue(e.getMessage(), e.getMessage().contains("already registered"));
     }
 
     public void testExecuteIndexPipelineDoesNotExist() {
-        ThreadPool threadPool = mock(ThreadPool.class);
         Client client = mock(Client.class);
-        final ExecutorService executorService = EsExecutors.newDirectExecutorService();
-        when(threadPool.executor(anyString())).thenReturn(executorService);
         IngestService ingestService = new IngestService(mock(ClusterService.class), threadPool, null, null,
             null, Collections.singletonList(DUMMY_PLUGIN), client);
         final IndexRequest indexRequest =
@@ -1188,10 +1193,9 @@ public Map<String, Processor.Factory> getProcessors(Processor.Parameters paramet
         };
 
         // Create ingest service:
-        ThreadPool tp = mock(ThreadPool.class);
         Client client = mock(Client.class);
         IngestService ingestService =
-            new IngestService(mock(ClusterService.class), tp, null, null, null, List.of(testPlugin), client);
+            new IngestService(mock(ClusterService.class), threadPool, null, null, null, List.of(testPlugin), client);
         ingestService.addIngestClusterStateListener(ingestClusterStateListener);
 
         // Create pipeline and apply the resulting cluster state, which should update the counter in the right order:
@@ -1259,9 +1263,11 @@ private static IngestService createWithProcessors() {
     }
 
     private static IngestService createWithProcessors(Map<String, Processor.Factory> processors) {
-        ThreadPool threadPool = mock(ThreadPool.class);
+
         Client client = mock(Client.class);
-        final ExecutorService executorService = EsExecutors.newDirectExecutorService();
+        ThreadPool threadPool = mock(ThreadPool.class);
+        ExecutorService executorService = EsExecutors.newDirectExecutorService();
+        when(threadPool.generic()).thenReturn(executorService);
         when(threadPool.executor(anyString())).thenReturn(executorService);
         return new IngestService(mock(ClusterService.class), threadPool, null, null,
             null, Collections.singletonList(new IngestPlugin() {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/action/TransportGetTrainedModelsStatsActionTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/action/TransportGetTrainedModelsStatsActionTests.java
index 1a359f962b325..03a011c717292 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/action/TransportGetTrainedModelsStatsActionTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/action/TransportGetTrainedModelsStatsActionTests.java
@@ -19,6 +19,7 @@
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.concurrent.EsExecutors;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
@@ -44,6 +45,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.concurrent.ExecutorService;
 import java.util.stream.Collectors;
 import java.util.stream.IntStream;
 
@@ -105,6 +107,8 @@ public Map<String, Processor.Factory> getProcessors(Processor.Parameters paramet
     @Before
     public void setUpVariables() {
         ThreadPool tp = mock(ThreadPool.class);
+        ExecutorService executorService = EsExecutors.newDirectExecutorService();
+        when(tp.generic()).thenReturn(executorService);
         client = mock(Client.class);
         clusterService = mock(ClusterService.class);
         Settings settings = Settings.builder().put("node.name", "InferenceProcessorFactoryTests_node").build();
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorFactoryTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorFactoryTests.java
index f7216ab206e85..38c4f3f002b2d 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorFactoryTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/ingest/InferenceProcessorFactoryTests.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.transport.TransportAddress;
+import org.elasticsearch.common.util.concurrent.EsExecutors;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentType;
@@ -44,6 +45,7 @@
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Map;
+import java.util.concurrent.ExecutorService;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.mockito.Mockito.mock;
@@ -71,6 +73,8 @@ public Map<String, Processor.Factory> getProcessors(Processor.Parameters paramet
     @Before
     public void setUpVariables() {
         ThreadPool tp = mock(ThreadPool.class);
+        ExecutorService executorService = EsExecutors.newDirectExecutorService();
+        when(tp.generic()).thenReturn(executorService);
         client = mock(Client.class);
         Settings settings = Settings.builder().put("node.name", "InferenceProcessorFactoryTests_node").build();
         ClusterSettings clusterSettings = new ClusterSettings(settings,

From 8801ed0ddbedd4333494e2d76b74b939d59ce240 Mon Sep 17 00:00:00 2001
From: Julie Tibshirani <julie.tibshirani@elastic.co>
Date: Wed, 8 Jan 2020 15:57:52 -0800
Subject: [PATCH 466/686] Adjust the skip version in tests for field collapsing
 with aliases.

Follow-up to #50722, which was also backported to 7.5 and 7.6.
---
 .../rest-api-spec/test/search/110_field_collapsing.yml        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
index 91e2583dcc634..e5f6c64c6971f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
@@ -348,8 +348,8 @@ setup:
 ---
 "field collapsing on a field alias":
   - skip:
-      version: " - 7.99.99"
-      reason: the bug fix is not yet backported to 7.x
+      version: " - 7.4.99"
+      reason: the bug fix was introduced in 7.5
   - do:
       indices.create:
         index:  alias-test

From ee20767262e959dd03597c23a12871170fb4f47c Mon Sep 17 00:00:00 2001
From: Przemko Robakowski <przemko.robakowski@elastic.co>
Date: Thu, 9 Jan 2020 07:37:05 +0100
Subject: [PATCH 467/686] ILM action to wait for SLM policy execution (#50454)

This change add new ILM action to wait for SLM policy execution to ensure that index has snapshot before deletion.

Closes #45067
---
 .../reference/ilm/policy-definitions.asciidoc |  35 ++++
 .../xpack/core/XPackClientPlugin.java         |   2 +
 .../core/ilm/TimeseriesLifecycleType.java     |   2 +-
 .../xpack/core/ilm/WaitForSnapshotAction.java |  96 +++++++++++
 .../xpack/core/ilm/WaitForSnapshotStep.java   | 101 ++++++++++++
 .../ilm/LifecyclePolicyMetadataTests.java     |   3 +
 .../xpack/core/ilm/LifecyclePolicyTests.java  |   7 +
 .../ilm/TimeseriesLifecycleTypeTests.java     |   3 +
 .../core/ilm/WaitForSnapshotActionTests.java  |  56 +++++++
 .../core/ilm/WaitForSnapshotStepTests.java    | 149 ++++++++++++++++++
 .../ilm/action/PutLifecycleRequestTests.java  |   4 +
 .../ilm/TimeSeriesLifecycleActionsIT.java     |  76 +++++++++
 .../xpack/ilm/IndexLifecycle.java             |   4 +-
 .../ilm/IndexLifecycleMetadataTests.java      |   4 +
 14 files changed, 540 insertions(+), 2 deletions(-)
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotAction.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotStep.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotActionTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotStepTests.java

diff --git a/docs/reference/ilm/policy-definitions.asciidoc b/docs/reference/ilm/policy-definitions.asciidoc
index 7114516e4d2a9..65401a5c866d7 100644
--- a/docs/reference/ilm/policy-definitions.asciidoc
+++ b/docs/reference/ilm/policy-definitions.asciidoc
@@ -109,6 +109,7 @@ policy definition.
   - <<ilm-allocate-action,Allocate>>
   - <<ilm-freeze-action,Freeze>>
 * Delete
+  - <<ilm-delete-action,Wait For Snapshot>>
   - <<ilm-delete-action,Delete>>
 
 [[ilm-allocate-action]]
@@ -220,6 +221,40 @@ PUT _ilm/policy/my_policy
 }
 --------------------------------------------------
 
+[[ilm-wait-for-snapshot-action]]
+==== Wait For Snapshot
+
+Phases allowed: delete.
+
+The Wait For Snapshot Action waits for defined SLM policy to be executed to ensure that snapshot of index exists before
+deletion.
+
+[[ilm-wait-for-snapshot-options]]
+.Wait For Snapshot
+[options="header"]
+|======
+| Name                 | Required  | Default             | Description
+| `policy`             | yes       | -                   | SLM policy name that this action should wait for
+|======
+
+[source,console]
+--------------------------------------------------
+PUT _ilm/policy/my_policy
+{
+  "policy": {
+    "phases": {
+      "delete": {
+        "actions": {
+          "wait_for_snapshot" : {
+            "policy": "slm-policy-name"
+          }
+        }
+      }
+    }
+  }
+}
+--------------------------------------------------
+
 [[ilm-delete-action]]
 ==== Delete
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
index efdb5e31118ae..8798c41406b31 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
@@ -54,6 +54,7 @@
 import org.elasticsearch.xpack.core.ilm.RolloverAction;
 import org.elasticsearch.xpack.core.ilm.SetPriorityAction;
 import org.elasticsearch.xpack.core.ilm.ShrinkAction;
+import org.elasticsearch.xpack.core.ilm.WaitForSnapshotAction;
 import org.elasticsearch.xpack.core.ilm.TimeseriesLifecycleType;
 import org.elasticsearch.xpack.core.ilm.UnfollowAction;
 import org.elasticsearch.xpack.core.ilm.action.DeleteLifecycleAction;
@@ -541,6 +542,7 @@ public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, FreezeAction.NAME, FreezeAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, SetPriorityAction.NAME, SetPriorityAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, UnfollowAction.NAME, UnfollowAction::new),
+                new NamedWriteableRegistry.Entry(LifecycleAction.class, WaitForSnapshotAction.NAME, WaitForSnapshotAction::new),
                 // Data Frame
                 new NamedWriteableRegistry.Entry(XPackFeatureSet.Usage.class, XPackField.TRANSFORM, TransformFeatureSetUsage::new),
                 new NamedWriteableRegistry.Entry(PersistentTaskParams.class, TransformField.TASK_NAME, TransformTaskParams::new),
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleType.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleType.java
index b2948df6373b4..ac5b3f51287b5 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleType.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleType.java
@@ -37,7 +37,7 @@ public class TimeseriesLifecycleType implements LifecycleType {
         AllocateAction.NAME, ShrinkAction.NAME, ForceMergeAction.NAME);
     static final List<String> ORDERED_VALID_COLD_ACTIONS = Arrays.asList(SetPriorityAction.NAME, UnfollowAction.NAME, AllocateAction.NAME,
         FreezeAction.NAME);
-    static final List<String> ORDERED_VALID_DELETE_ACTIONS = Arrays.asList(DeleteAction.NAME);
+    static final List<String> ORDERED_VALID_DELETE_ACTIONS = Arrays.asList(WaitForSnapshotAction.NAME, DeleteAction.NAME);
     static final Set<String> VALID_HOT_ACTIONS = Sets.newHashSet(ORDERED_VALID_HOT_ACTIONS);
     static final Set<String> VALID_WARM_ACTIONS = Sets.newHashSet(ORDERED_VALID_WARM_ACTIONS);
     static final Set<String> VALID_COLD_ACTIONS = Sets.newHashSet(ORDERED_VALID_COLD_ACTIONS);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotAction.java
new file mode 100644
index 0000000000000..566b54b470c6d
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotAction.java
@@ -0,0 +1,96 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.client.Client;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.xpack.core.ilm.Step.StepKey;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * A {@link LifecycleAction} which waits for snapshot to be taken (by configured SLM policy).
+ */
+public class WaitForSnapshotAction implements LifecycleAction {
+
+    public static final String NAME = "wait_for_snapshot";
+    public static final ParseField POLICY_FIELD = new ParseField("policy");
+
+    private static final ConstructingObjectParser<WaitForSnapshotAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
+        a -> new WaitForSnapshotAction((String) a[0]));
+
+    static {
+        PARSER.declareString(ConstructingObjectParser.constructorArg(), POLICY_FIELD);
+    }
+
+    private final String policy;
+
+    public static WaitForSnapshotAction parse(XContentParser parser) {
+        return PARSER.apply(parser, null);
+    }
+
+    public WaitForSnapshotAction(String policy) {
+        if (Strings.hasText(policy) == false) {
+            throw new IllegalArgumentException("policy name must be specified");
+        }
+        this.policy = policy;
+    }
+
+    public WaitForSnapshotAction(StreamInput in) throws IOException {
+        this(in.readString());
+    }
+
+    @Override
+    public List<Step> toSteps(Client client, String phase, StepKey nextStepKey) {
+        StepKey waitForSnapshotKey = new StepKey(phase, NAME, WaitForSnapshotStep.NAME);
+        return Collections.singletonList(new WaitForSnapshotStep(waitForSnapshotKey, nextStepKey, policy));
+    }
+
+    @Override
+    public boolean isSafeAction() {
+        return true;
+    }
+
+    @Override
+    public String getWriteableName() {
+        return NAME;
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeString(policy);
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.field(POLICY_FIELD.getPreferredName(), policy);
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        WaitForSnapshotAction that = (WaitForSnapshotAction) o;
+        return policy.equals(that.policy);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(policy);
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotStep.java
new file mode 100644
index 0000000000000..2880de8ea3de5
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotStep.java
@@ -0,0 +1,101 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.xpack.core.slm.SnapshotLifecycleMetadata;
+import org.elasticsearch.xpack.core.slm.SnapshotLifecyclePolicyMetadata;
+
+import java.util.Date;
+import java.util.Locale;
+import java.util.Objects;
+
+/***
+ * A step that waits for snapshot to be taken by SLM to ensure we have backup before we delete the index.
+ * It will signal error if it can't get data needed to do the check (phase time from ILM and SLM metadata)
+ * and will only return success if execution of SLM policy took place after index entered deleted phase.
+ */
+public class WaitForSnapshotStep extends ClusterStateWaitStep {
+
+    static final String NAME = "wait-for-snapshot";
+
+    private static final String MESSAGE_FIELD = "message";
+    private static final String POLICY_NOT_EXECUTED_MESSAGE = "waiting for policy '%s' to be executed since %s";
+    private static final String POLICY_NOT_FOUND_MESSAGE = "configured policy '%s' not found";
+    private static final String NO_INDEX_METADATA_MESSAGE = "no index metadata found for index '%s'";
+    private static final String NO_PHASE_TIME_MESSAGE = "no information about ILM phase start in index metadata for index '%s'";
+
+    private final String policy;
+
+    WaitForSnapshotStep(StepKey key, StepKey nextStepKey, String policy) {
+        super(key, nextStepKey);
+        this.policy = policy;
+    }
+
+    @Override
+    public Result isConditionMet(Index index, ClusterState clusterState) {
+        IndexMetaData indexMetaData = clusterState.metaData().index(index);
+        if (indexMetaData == null) {
+            throw error(NO_INDEX_METADATA_MESSAGE, index.getName());
+        }
+
+        Long phaseTime = LifecycleExecutionState.fromIndexMetadata(indexMetaData).getPhaseTime();
+
+        if (phaseTime == null) {
+            throw error(NO_PHASE_TIME_MESSAGE, index.getName());
+        }
+
+        SnapshotLifecycleMetadata snapMeta = clusterState.metaData().custom(SnapshotLifecycleMetadata.TYPE);
+        if (snapMeta == null || snapMeta.getSnapshotConfigurations().containsKey(policy) == false) {
+            throw error(POLICY_NOT_FOUND_MESSAGE, policy);
+        }
+        SnapshotLifecyclePolicyMetadata snapPolicyMeta = snapMeta.getSnapshotConfigurations().get(policy);
+        if (snapPolicyMeta.getLastSuccess() == null || snapPolicyMeta.getLastSuccess().getTimestamp() < phaseTime) {
+            return new Result(false, notExecutedMessage(phaseTime));
+        }
+
+        return new Result(true, null);
+    }
+
+    public String getPolicy() {
+        return policy;
+    }
+
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
+
+    private ToXContentObject notExecutedMessage(long time) {
+        return (builder, params) -> {
+            builder.startObject();
+            builder.field(MESSAGE_FIELD, String.format(Locale.ROOT, POLICY_NOT_EXECUTED_MESSAGE, policy, new Date(time)));
+            builder.endObject();
+            return builder;
+        };
+    }
+
+    private IllegalStateException error(String message, Object... args) {
+        return new IllegalStateException(String.format(Locale.ROOT, message, args));
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        if (!super.equals(o)) return false;
+        WaitForSnapshotStep that = (WaitForSnapshotStep) o;
+        return policy.equals(that.policy);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(super.hashCode(), policy);
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicyMetadataTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicyMetadataTests.java
index b21b59049a3f4..9b50616a128dd 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicyMetadataTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicyMetadataTests.java
@@ -39,6 +39,7 @@ protected NamedWriteableRegistry getNamedWriteableRegistry() {
                 new NamedWriteableRegistry.Entry(LifecycleType.class, TimeseriesLifecycleType.TYPE,
                     (in) -> TimeseriesLifecycleType.INSTANCE),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, AllocateAction.NAME, AllocateAction::new),
+                new NamedWriteableRegistry.Entry(LifecycleAction.class, WaitForSnapshotAction.NAME, WaitForSnapshotAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, DeleteAction.NAME, DeleteAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, ForceMergeAction.NAME, ForceMergeAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, ReadOnlyAction.NAME, ReadOnlyAction::new),
@@ -57,6 +58,8 @@ protected NamedXContentRegistry xContentRegistry() {
             new NamedXContentRegistry.Entry(LifecycleType.class, new ParseField(TimeseriesLifecycleType.TYPE),
                 (p) -> TimeseriesLifecycleType.INSTANCE),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(AllocateAction.NAME), AllocateAction::parse),
+            new NamedXContentRegistry.Entry(LifecycleAction.class,
+                new ParseField(WaitForSnapshotAction.NAME), WaitForSnapshotAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(DeleteAction.NAME), DeleteAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(ForceMergeAction.NAME), ForceMergeAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(ReadOnlyAction.NAME), ReadOnlyAction::parse),
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicyTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicyTests.java
index 5470a6d31a586..37b268c499dbb 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicyTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/LifecyclePolicyTests.java
@@ -48,6 +48,7 @@ protected NamedWriteableRegistry getNamedWriteableRegistry() {
                 new NamedWriteableRegistry.Entry(LifecycleType.class, TimeseriesLifecycleType.TYPE,
                     (in) -> TimeseriesLifecycleType.INSTANCE),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, AllocateAction.NAME, AllocateAction::new),
+                new NamedWriteableRegistry.Entry(LifecycleAction.class, WaitForSnapshotAction.NAME, WaitForSnapshotAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, DeleteAction.NAME, DeleteAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, ForceMergeAction.NAME, ForceMergeAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, ReadOnlyAction.NAME, ReadOnlyAction::new),
@@ -66,6 +67,8 @@ protected NamedXContentRegistry xContentRegistry() {
             new NamedXContentRegistry.Entry(LifecycleType.class, new ParseField(TimeseriesLifecycleType.TYPE),
                 (p) -> TimeseriesLifecycleType.INSTANCE),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(AllocateAction.NAME), AllocateAction::parse),
+            new NamedXContentRegistry.Entry(LifecycleAction.class,
+                new ParseField(WaitForSnapshotAction.NAME), WaitForSnapshotAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(DeleteAction.NAME), DeleteAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(ForceMergeAction.NAME), ForceMergeAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(ReadOnlyAction.NAME), ReadOnlyAction::parse),
@@ -110,6 +113,8 @@ public static LifecyclePolicy randomTimeseriesLifecyclePolicyWithAllPhases(@Null
                     return AllocateActionTests.randomInstance();
                 case DeleteAction.NAME:
                     return new DeleteAction();
+                case WaitForSnapshotAction.NAME:
+                    return  WaitForSnapshotActionTests.randomInstance();
                 case ForceMergeAction.NAME:
                     return ForceMergeActionTests.randomInstance();
                 case ReadOnlyAction.NAME:
@@ -160,6 +165,8 @@ public static LifecyclePolicy randomTimeseriesLifecyclePolicy(@Nullable String l
             switch (action) {
                 case AllocateAction.NAME:
                     return AllocateActionTests.randomInstance();
+                case WaitForSnapshotAction.NAME:
+                    return WaitForSnapshotActionTests.randomInstance();
                 case DeleteAction.NAME:
                     return new DeleteAction();
                 case ForceMergeAction.NAME:
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index e1df27f09a44f..822b41f906f54 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -36,6 +36,7 @@ public class TimeseriesLifecycleTypeTests extends ESTestCase {
         new AllocateAction(2, Collections.singletonMap("node", "node1"),null, null);
     private static final DeleteAction TEST_DELETE_ACTION = new DeleteAction();
     private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, Codec.getDefault());
+    private static final WaitForSnapshotAction TEST_WAIT_FOR_SNAPSHOT_ACTION = new WaitForSnapshotAction("policy");
     private static final RolloverAction TEST_ROLLOVER_ACTION = new RolloverAction(new ByteSizeValue(1), null, null);
     private static final ShrinkAction TEST_SHRINK_ACTION = new ShrinkAction(1);
     private static final ReadOnlyAction TEST_READ_ONLY_ACTION = new ReadOnlyAction();
@@ -557,6 +558,8 @@ private LifecycleAction getTestAction(String actionName) {
         switch (actionName) {
             case AllocateAction.NAME:
                 return TEST_ALLOCATE_ACTION;
+            case WaitForSnapshotAction.NAME:
+                return TEST_WAIT_FOR_SNAPSHOT_ACTION;
             case DeleteAction.NAME:
                 return TEST_DELETE_ACTION;
             case ForceMergeAction.NAME:
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotActionTests.java
new file mode 100644
index 0000000000000..a35ac6b422dd6
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotActionTests.java
@@ -0,0 +1,56 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.List;
+
+public class WaitForSnapshotActionTests extends AbstractActionTestCase<WaitForSnapshotAction> {
+
+    @Override
+    public void testToSteps() {
+        WaitForSnapshotAction action = createTestInstance();
+        Step.StepKey nextStep = new Step.StepKey("", "", "");
+        List<Step> steps = action.toSteps(null, "delete", nextStep);
+        assertEquals(1, steps.size());
+        Step step = steps.get(0);
+        assertTrue(step instanceof WaitForSnapshotStep);
+        assertEquals(nextStep, step.getNextStepKey());
+
+        Step.StepKey key = step.getKey();
+        assertEquals("delete", key.getPhase());
+        assertEquals(WaitForSnapshotAction.NAME, key.getAction());
+        assertEquals(WaitForSnapshotStep.NAME, key.getName());
+    }
+
+    @Override
+    protected WaitForSnapshotAction doParseInstance(XContentParser parser) throws IOException {
+        return WaitForSnapshotAction.parse(parser);
+    }
+
+    @Override
+    protected WaitForSnapshotAction createTestInstance() {
+        return randomInstance();
+    }
+
+    @Override
+    protected Writeable.Reader<WaitForSnapshotAction> instanceReader() {
+        return WaitForSnapshotAction::new;
+    }
+
+    @Override
+    protected WaitForSnapshotAction mutateInstance(WaitForSnapshotAction instance) throws IOException {
+        return randomInstance();
+    }
+
+    static WaitForSnapshotAction randomInstance() {
+        return new WaitForSnapshotAction(randomAlphaOfLengthBetween(5, 10));
+    }
+
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotStepTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotStepTests.java
new file mode 100644
index 0000000000000..6c1822235ec97
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForSnapshotStepTests.java
@@ -0,0 +1,149 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ilm;
+
+import org.elasticsearch.Version;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.collect.ImmutableOpenMap;
+import org.elasticsearch.xpack.core.slm.SnapshotInvocationRecord;
+import org.elasticsearch.xpack.core.slm.SnapshotLifecycleMetadata;
+import org.elasticsearch.xpack.core.slm.SnapshotLifecyclePolicy;
+import org.elasticsearch.xpack.core.slm.SnapshotLifecyclePolicyMetadata;
+
+import java.io.IOException;
+import java.util.Map;
+
+public class WaitForSnapshotStepTests extends AbstractStepTestCase<WaitForSnapshotStep> {
+
+    @Override
+    protected WaitForSnapshotStep createRandomInstance() {
+        return new WaitForSnapshotStep(randomStepKey(), randomStepKey(), randomAlphaOfLengthBetween(1, 10));
+    }
+
+    @Override
+    protected WaitForSnapshotStep mutateInstance(WaitForSnapshotStep instance) {
+        Step.StepKey key = instance.getKey();
+        Step.StepKey nextKey = instance.getNextStepKey();
+        String policy = instance.getPolicy();
+
+        switch (between(0, 2)) {
+            case 0:
+                key = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 1:
+                nextKey = new Step.StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
+                break;
+            case 2:
+                policy = randomAlphaOfLengthBetween(1, 10);
+                break;
+            default:
+                throw new AssertionError("Illegal randomisation branch");
+        }
+
+        return new WaitForSnapshotStep(key, nextKey, policy);
+    }
+
+    @Override
+    protected WaitForSnapshotStep copyInstance(WaitForSnapshotStep instance) {
+        return new WaitForSnapshotStep(instance.getKey(), instance.getNextStepKey(), instance.getPolicy());
+    }
+
+    public void testNoSlmPolicies() {
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10))
+            .putCustom(LifecycleExecutionState.ILM_CUSTOM_METADATA_KEY, Map.of("phase_time", Long.toString(randomLong())))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
+        ImmutableOpenMap.Builder<String, IndexMetaData> indices =
+            ImmutableOpenMap.<String, IndexMetaData>builder().fPut(indexMetaData.getIndex().getName(), indexMetaData);
+        MetaData.Builder meta = MetaData.builder().indices(indices.build());
+        ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT).metaData(meta).build();
+        WaitForSnapshotStep instance = createRandomInstance();
+        IllegalStateException e = expectThrows(IllegalStateException.class, () -> instance.isConditionMet(indexMetaData.getIndex(),
+            clusterState));
+        assertTrue(e.getMessage().contains(instance.getPolicy()));
+    }
+
+    public void testSlmPolicyNotExecuted() throws IOException {
+        WaitForSnapshotStep instance = createRandomInstance();
+        SnapshotLifecyclePolicyMetadata slmPolicy = SnapshotLifecyclePolicyMetadata.builder()
+            .setModifiedDate(randomLong())
+            .setPolicy(new SnapshotLifecyclePolicy("", "", "", "", null, null))
+            .build();
+        SnapshotLifecycleMetadata smlMetaData = new SnapshotLifecycleMetadata(Map.of(instance.getPolicy(), slmPolicy),
+            OperationMode.RUNNING, null);
+
+
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10))
+            .putCustom(LifecycleExecutionState.ILM_CUSTOM_METADATA_KEY, Map.of("phase_time", Long.toString(randomLong())))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
+        ImmutableOpenMap.Builder<String, IndexMetaData> indices =
+            ImmutableOpenMap.<String, IndexMetaData>builder().fPut(indexMetaData.getIndex().getName(), indexMetaData);
+        MetaData.Builder meta = MetaData.builder().indices(indices.build()).putCustom(SnapshotLifecycleMetadata.TYPE, smlMetaData);
+        ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT).metaData(meta).build();
+        ClusterStateWaitStep.Result result = instance.isConditionMet(indexMetaData.getIndex(), clusterState);
+        assertFalse(result.isComplete());
+        assertTrue(getMessage(result).contains("to be executed"));
+    }
+
+    public void testSlmPolicyExecutedBeforeStep() throws IOException {
+        long phaseTime = randomLong();
+
+        WaitForSnapshotStep instance = createRandomInstance();
+        SnapshotLifecyclePolicyMetadata slmPolicy = SnapshotLifecyclePolicyMetadata.builder()
+            .setModifiedDate(randomLong())
+            .setPolicy(new SnapshotLifecyclePolicy("", "", "", "", null, null))
+            .setLastSuccess(new SnapshotInvocationRecord("", phaseTime - 10, ""))
+            .build();
+        SnapshotLifecycleMetadata smlMetaData = new SnapshotLifecycleMetadata(Map.of(instance.getPolicy(), slmPolicy),
+            OperationMode.RUNNING, null);
+
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10))
+            .putCustom(LifecycleExecutionState.ILM_CUSTOM_METADATA_KEY, Map.of("phase_time", Long.toString(phaseTime)))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
+        ImmutableOpenMap.Builder<String, IndexMetaData> indices =
+            ImmutableOpenMap.<String, IndexMetaData>builder().fPut(indexMetaData.getIndex().getName(), indexMetaData);
+        MetaData.Builder meta = MetaData.builder().indices(indices.build()).putCustom(SnapshotLifecycleMetadata.TYPE, smlMetaData);
+        ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT).metaData(meta).build();
+        ClusterStateWaitStep.Result result = instance.isConditionMet(indexMetaData.getIndex(), clusterState);
+        assertFalse(result.isComplete());
+        assertTrue(getMessage(result).contains("to be executed"));
+    }
+
+    public void testSlmPolicyExecutedAfterStep() throws IOException {
+        long phaseTime = randomLong();
+
+        WaitForSnapshotStep instance = createRandomInstance();
+        SnapshotLifecyclePolicyMetadata slmPolicy = SnapshotLifecyclePolicyMetadata.builder()
+            .setModifiedDate(randomLong())
+            .setPolicy(new SnapshotLifecyclePolicy("", "", "", "", null, null))
+            .setLastSuccess(new SnapshotInvocationRecord("", phaseTime + 10, ""))
+            .build();
+        SnapshotLifecycleMetadata smlMetaData = new SnapshotLifecycleMetadata(Map.of(instance.getPolicy(), slmPolicy),
+            OperationMode.RUNNING, null);
+
+        IndexMetaData indexMetaData = IndexMetaData.builder(randomAlphaOfLength(10))
+            .putCustom(LifecycleExecutionState.ILM_CUSTOM_METADATA_KEY, Map.of("phase_time", Long.toString(phaseTime)))
+            .settings(settings(Version.CURRENT))
+            .numberOfShards(randomIntBetween(1, 5)).numberOfReplicas(randomIntBetween(0, 5)).build();
+        ImmutableOpenMap.Builder<String, IndexMetaData> indices =
+            ImmutableOpenMap.<String, IndexMetaData>builder().fPut(indexMetaData.getIndex().getName(), indexMetaData);
+        MetaData.Builder meta = MetaData.builder().indices(indices.build()).putCustom(SnapshotLifecycleMetadata.TYPE, smlMetaData);
+        ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT).metaData(meta).build();
+        ClusterStateWaitStep.Result result = instance.isConditionMet(indexMetaData.getIndex(), clusterState);
+        assertTrue(result.isComplete());
+        assertNull(result.getInfomationContext());
+    }
+
+    private String getMessage(ClusterStateWaitStep.Result result) throws IOException {
+        return Strings.toString(result.getInfomationContext());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/action/PutLifecycleRequestTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/action/PutLifecycleRequestTests.java
index 137a81ba56f2d..f0fd2f7dd5d76 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/action/PutLifecycleRequestTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/action/PutLifecycleRequestTests.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.xpack.core.ilm.ShrinkAction;
 import org.elasticsearch.xpack.core.ilm.TimeseriesLifecycleType;
 import org.elasticsearch.xpack.core.ilm.UnfollowAction;
+import org.elasticsearch.xpack.core.ilm.WaitForSnapshotAction;
 import org.elasticsearch.xpack.core.ilm.action.PutLifecycleAction.Request;
 import org.junit.Before;
 
@@ -64,6 +65,7 @@ protected NamedWriteableRegistry getNamedWriteableRegistry() {
                 new NamedWriteableRegistry.Entry(LifecycleType.class, TimeseriesLifecycleType.TYPE,
                     (in) -> TimeseriesLifecycleType.INSTANCE),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, AllocateAction.NAME, AllocateAction::new),
+                new NamedWriteableRegistry.Entry(LifecycleAction.class, WaitForSnapshotAction.NAME, WaitForSnapshotAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, DeleteAction.NAME, DeleteAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, ForceMergeAction.NAME, ForceMergeAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, ReadOnlyAction.NAME, ReadOnlyAction::new),
@@ -82,6 +84,8 @@ protected NamedXContentRegistry xContentRegistry() {
             new NamedXContentRegistry.Entry(LifecycleType.class, new ParseField(TimeseriesLifecycleType.TYPE),
                 (p) -> TimeseriesLifecycleType.INSTANCE),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(AllocateAction.NAME), AllocateAction::parse),
+            new NamedXContentRegistry.Entry(LifecycleAction.class,
+                new ParseField(WaitForSnapshotAction.NAME), WaitForSnapshotAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(DeleteAction.NAME), DeleteAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(ForceMergeAction.NAME), ForceMergeAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(ReadOnlyAction.NAME), ReadOnlyAction::parse),
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index d90bee1d889ab..31bfd8c9203f5 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -42,6 +42,7 @@
 import org.elasticsearch.xpack.core.ilm.SetPriorityAction;
 import org.elasticsearch.xpack.core.ilm.ShrinkAction;
 import org.elasticsearch.xpack.core.ilm.ShrinkStep;
+import org.elasticsearch.xpack.core.ilm.WaitForSnapshotAction;
 import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
@@ -325,6 +326,50 @@ public void testAllocateActionOnlyReplicas() throws Exception {
         });
     }
 
+    public void testWaitForSnapshot() throws Exception {
+        createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
+        createNewSingletonPolicy("delete", new WaitForSnapshotAction("slm"));
+        updatePolicy(index, policy);
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("wait_for_snapshot")));
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getName(), equalTo("wait-for-snapshot")));
+        assertBusy(() -> assertThat(getFailedStepForIndex(index), equalTo("wait-for-snapshot")));
+
+        createSnapshotRepo();
+        createSlmPolicy();
+
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("wait_for_snapshot")));
+
+        Request request = new Request("PUT", "/_slm/policy/slm/_execute");
+        assertOK(client().performRequest(request));
+
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("completed")));
+    }
+
+    public void testWaitForSnapshotSlmExecutedBefore() throws Exception {
+        createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
+        createNewSingletonPolicy("delete", new WaitForSnapshotAction("slm"));
+
+        createSnapshotRepo();
+        createSlmPolicy();
+
+        Request request = new Request("PUT", "/_slm/policy/slm/_execute");
+        assertOK(client().performRequest(request));
+
+        updatePolicy(index, policy);
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("wait_for_snapshot")));
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getName(), equalTo("wait-for-snapshot")));
+        
+        request = new Request("PUT", "/_slm/policy/slm/_execute");
+        assertOK(client().performRequest(request));
+
+        request = new Request("PUT", "/_slm/policy/slm/_execute");
+        assertOK(client().performRequest(request));
+
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("completed")));
+    }
+
     public void testDelete() throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
@@ -1553,4 +1598,35 @@ private String getSnapshotState(String snapshot) throws IOException {
         assertThat(snapResponse.get("snapshot"), equalTo(snapshot));
         return (String) snapResponse.get("state");
     }
+
+    private void createSlmPolicy() throws IOException {
+        Request request;
+        request = new Request("PUT", "/_slm/policy/slm");
+        request.setJsonEntity(Strings
+            .toString(JsonXContent.contentBuilder()
+                .startObject()
+                .field("schedule", "59 59 23 31 12 ? 2099")
+                .field("repository", "repo")
+                .field("name", "snap" + randomAlphaOfLengthBetween(5, 10).toLowerCase(Locale.ROOT))
+                .startObject("config")
+                .endObject()
+                .endObject()));
+
+        assertOK(client().performRequest(request));
+    }
+
+    private void createSnapshotRepo() throws IOException {
+        Request request = new Request("PUT", "/_snapshot/repo");
+        request.setJsonEntity(Strings
+            .toString(JsonXContent.contentBuilder()
+                .startObject()
+                .field("type", "fs")
+                .startObject("settings")
+                .field("compress", randomBoolean())
+                .field("location", System.getProperty("tests.path.repo"))
+                .field("max_snapshot_bytes_per_sec", "256b")
+                .endObject()
+                .endObject()));
+        assertOK(client().performRequest(request));
+    }
 }
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
index 3e1ad336905eb..feb00972c35c1 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycle.java
@@ -50,6 +50,7 @@
 import org.elasticsearch.xpack.core.ilm.RolloverAction;
 import org.elasticsearch.xpack.core.ilm.SetPriorityAction;
 import org.elasticsearch.xpack.core.ilm.ShrinkAction;
+import org.elasticsearch.xpack.core.ilm.WaitForSnapshotAction;
 import org.elasticsearch.xpack.core.ilm.TimeseriesLifecycleType;
 import org.elasticsearch.xpack.core.ilm.UnfollowAction;
 import org.elasticsearch.xpack.core.ilm.action.DeleteLifecycleAction;
@@ -227,7 +228,8 @@ public List<org.elasticsearch.common.xcontent.NamedXContentRegistry.Entry> getNa
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(DeleteAction.NAME), DeleteAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(FreezeAction.NAME), FreezeAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(SetPriorityAction.NAME), SetPriorityAction::parse),
-            new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(UnfollowAction.NAME), UnfollowAction::parse)
+            new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(UnfollowAction.NAME), UnfollowAction::parse),
+            new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(WaitForSnapshotAction.NAME), WaitForSnapshotAction::parse)
         );
     }
 
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleMetadataTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleMetadataTests.java
index 2c8ac30f2a88c..dd8ea801cf06c 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleMetadataTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/IndexLifecycleMetadataTests.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.xpack.core.ilm.ShrinkAction;
 import org.elasticsearch.xpack.core.ilm.TimeseriesLifecycleType;
 import org.elasticsearch.xpack.core.ilm.UnfollowAction;
+import org.elasticsearch.xpack.core.ilm.WaitForSnapshotAction;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -81,6 +82,7 @@ protected NamedWriteableRegistry getNamedWriteableRegistry() {
                 new NamedWriteableRegistry.Entry(LifecycleType.class, TimeseriesLifecycleType.TYPE,
                     (in) -> TimeseriesLifecycleType.INSTANCE),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, AllocateAction.NAME, AllocateAction::new),
+                new NamedWriteableRegistry.Entry(LifecycleAction.class, WaitForSnapshotAction.NAME, WaitForSnapshotAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, DeleteAction.NAME, DeleteAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, ForceMergeAction.NAME, ForceMergeAction::new),
                 new NamedWriteableRegistry.Entry(LifecycleAction.class, ReadOnlyAction.NAME, ReadOnlyAction::new),
@@ -100,6 +102,8 @@ protected NamedXContentRegistry xContentRegistry() {
                 (p) -> TimeseriesLifecycleType.INSTANCE),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(AllocateAction.NAME), AllocateAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(DeleteAction.NAME), DeleteAction::parse),
+            new NamedXContentRegistry.Entry(LifecycleAction.class,
+                new ParseField(WaitForSnapshotAction.NAME), WaitForSnapshotAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(ForceMergeAction.NAME), ForceMergeAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(ReadOnlyAction.NAME), ReadOnlyAction::parse),
             new NamedXContentRegistry.Entry(LifecycleAction.class, new ParseField(RolloverAction.NAME), RolloverAction::parse),

From 2a372a9137e1369ae9996944a1f4e663e0e45f8d Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Thu, 9 Jan 2020 09:01:55 +0100
Subject: [PATCH 468/686] Wrap triggering of a watch inside an assertBusy(...)
 invocation

This test replaces the watch index after watcher got started.
This triggers watches being reloaded and while this happens the
trigger engine is paused, which disallows watches from being
triggered. At this time there are no watches in the .watches
index and I think this is just unlucky timing.

Reloading of watches happens in the background and
the watch state can be started when that happens.
For normal schedule trigger engines this is not an issue,
because watches that are meant to be triggered are triggered
when the engine triggers the next time. However for the
mock scheduled trigger engine this is different,
because watches are triggered programatically and
there is no retry in this test.

I think just adding `timeWarp().trigger("mywatch");` inside
a `assertBusy(...)`` is the right fix here.  If it fails
because the mock schedule trigger engine is paused then
the test will try again. In the mean time the the watches
can be reloaded, which then resumes the mock scheduled trigger engine.

Closes #50658
---
 .../elasticsearch/xpack/watcher/WatcherConcreteIndexTests.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/WatcherConcreteIndexTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/WatcherConcreteIndexTests.java
index 88db8ef8221a0..5ed05352c6edb 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/WatcherConcreteIndexTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/WatcherConcreteIndexTests.java
@@ -44,7 +44,7 @@ public void testCanUseAnyConcreteIndexName() throws Exception {
         assertTrue(putWatchResponse.isCreated());
         refresh();
 
-        timeWarp().trigger("mywatch");
+        assertBusy(() -> timeWarp().trigger("mywatch"));
 
         assertBusy(() -> {
             SearchResponse searchResult = client().prepareSearch(watchResultsIndex).setTrackTotalHits(true).get();

From d377298175cd8a864c69728a2ebbb9fd642384e1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 9 Jan 2020 09:31:30 +0100
Subject: [PATCH 469/686] [DOCS] Improves description for forecast_stats
 (#50729)

Co-Authored-By: Lisa Cawley <lcawley@elastic.co>
---
 .../apis/get-job-stats.asciidoc               | 25 +++++++++++--------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
index 9bf583595494d..f71a1964fdbca 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
@@ -148,8 +148,9 @@ expected number of data points. If your data contains many sparse buckets,
 consider using a longer `bucket_span`.
 
 [[forecastsstats]]`forecasts_stats`::
-(object) An object that provides statistical information about forecasts
-of this job. It has the following properties:
+(object) An object that provides statistical information about forecasts 
+belonging to this job. Some statistics are omitted if no forecasts have been 
+made. It has the following properties:
 +
 --
 NOTE: Unless there is at least one forecast, `memory_bytes`, `records`,
@@ -158,24 +159,28 @@ NOTE: Unless there is at least one forecast, `memory_bytes`, `records`,
 --
 
 `forecasts_stats`.`forecasted_jobs`:::
-(long) The number of jobs that have at least one forecast.
+(long) A value of `0` indicates that forecasts do not exist for this job. A 
+value of `1` indicates that at least one forecast exists.
 
 `forecasts_stats`.`memory_bytes`:::
-(object) Statistics about the memory usage: minimum, maximum, average and total.
+(object) The `avg`, `min`, `max` and `total` memory usage in bytes for forecasts 
+related to this job. If there are no forecasts, this property is omitted.
 
 `forecasts_stats`.`records`:::
-(object) Statistics about the number of forecast records: minimum, maximum,
-average and total.
+(object) The `avg`, `min`, `max` and `total` number of model_forecast documents 
+written for forecasts related to this job. If there are no forecasts, this property is omitted.
 
 `forecasts_stats`.`processing_time_ms`:::
-(object) Statistics about the forecast runtime in milliseconds: minimum, maximum,
-average and total.
+(object) The `avg`, `min`, `max` and `total` runtime in milliseconds for 
+forecasts related to this job. If there are no forecasts, this property is omitted.
 
 `forecasts_stats`.`status`:::
-(object) Counts per forecast status. For example: `{"finished" : 2}`. 
+(object) The count of forecasts by their status. For example: 
+{"finished" : 2, "started" : 1}. If there are no forecasts, this property is omitted.
 
 `forecasts_stats`.`total`:::
-(long) The number of forecasts currently available for this model.
+(long) The number of individual forecasts currently available for this job. A 
+value of `1` or more indicates that forecasts exist.
 
 `job_id`::
 (string)

From 1ecb19e0b424d82bf464af5d61d75100380f8163 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 9 Jan 2020 09:43:30 +0100
Subject: [PATCH 470/686] Enforce Logging of Errors in GCS Rest RetriesTests
 (#50761)

It's impossible to tell why #50754 fails without this change.
We're failing to close the `exchange` somewhere and there is no
write timeout in the GCS SDK (something to look into separately)
only a read timeout on the socket so if we're failing on an assertion without
reading the full request body (at least into the read-buffer) we're locking up
waiting forever on `write0`.

This change ensure the `exchange` is closed in the tests where we could lock up
on a write and logs the failure so we can find out what broke #50754.
---
 ...CloudStorageBlobContainerRetriesTests.java | 34 +++++++++++--------
 ...ESMockAPIBasedRepositoryIntegTestCase.java |  2 +-
 2 files changed, 20 insertions(+), 16 deletions(-)

diff --git a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainerRetriesTests.java b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainerRetriesTests.java
index 23203e8d4a9e0..cbbd7528d32c2 100644
--- a/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainerRetriesTests.java
+++ b/plugins/repository-gcs/src/test/java/org/elasticsearch/repositories/gcs/GoogleCloudStorageBlobContainerRetriesTests.java
@@ -23,6 +23,7 @@
 import com.google.cloud.storage.StorageException;
 import com.google.cloud.storage.StorageOptions;
 import com.sun.net.httpserver.HttpContext;
+import com.sun.net.httpserver.HttpHandler;
 import com.sun.net.httpserver.HttpServer;
 import fixture.gcs.FakeOAuth2HttpHandler;
 import org.apache.http.HttpStatus;
@@ -44,6 +45,7 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.util.concurrent.CountDown;
 import org.elasticsearch.mocksocket.MockHttpServer;
+import org.elasticsearch.repositories.blobstore.ESMockAPIBasedRepositoryIntegTestCase;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.rest.RestUtils;
 import org.elasticsearch.test.ESTestCase;
@@ -151,13 +153,12 @@ StorageOptions createStorageOptions(final GoogleCloudStorageClientSettings clien
             // Auth
             httpServer.createContext("/token", new FakeOAuth2HttpHandler()),
             // Does bucket exists?
-            httpServer.createContext("/storage/v1/b/bucket", exchange -> {
+            httpServer.createContext("/storage/v1/b/bucket", safeHandler(exchange -> {
                 byte[] response = ("{\"kind\":\"storage#bucket\",\"name\":\"bucket\",\"id\":\"0\"}").getBytes(UTF_8);
                 exchange.getResponseHeaders().add("Content-Type", "application/json; charset=utf-8");
                 exchange.sendResponseHeaders(HttpStatus.SC_OK, response.length);
                 exchange.getResponseBody().write(response);
-                exchange.close();
-            })
+            }))
         );
 
         final GoogleCloudStorageBlobStore blobStore = new GoogleCloudStorageBlobStore("bucket", client, service);
@@ -240,7 +241,7 @@ public void testWriteBlobWithRetries() throws Exception {
         final CountDown countDown = new CountDown(maxRetries);
 
         final byte[] bytes = randomBlobContent();
-        httpServer.createContext("/upload/storage/v1/b/bucket/o", exchange -> {
+        httpServer.createContext("/upload/storage/v1/b/bucket/o", safeHandler(exchange -> {
             assertThat(exchange.getRequestURI().getQuery(), containsString("uploadType=multipart"));
             if (countDown.countDown()) {
                 Optional<Tuple<String, BytesArray>> content = parseMultipartRequestBody(exchange.getRequestBody());
@@ -254,7 +255,6 @@ public void testWriteBlobWithRetries() throws Exception {
                 } else {
                     exchange.sendResponseHeaders(HttpStatus.SC_BAD_REQUEST, -1);
                 }
-                exchange.close();
                 return;
             }
             if (randomBoolean()) {
@@ -265,8 +265,7 @@ public void testWriteBlobWithRetries() throws Exception {
                     exchange.sendResponseHeaders(HttpStatus.SC_INTERNAL_SERVER_ERROR, -1);
                 }
             }
-            exchange.close();
-        });
+        }));
 
         final BlobContainer blobContainer = createBlobContainer(maxRetries, null);
         try (InputStream stream = new InputStreamIndexInput(new ByteArrayIndexInput("desc", bytes), bytes.length)) {
@@ -324,7 +323,7 @@ public void testWriteLargeBlob() throws IOException {
         final AtomicReference<String> sessionUploadId = new AtomicReference<>(UUIDs.randomBase64UUID());
         logger.debug("starting with resumable upload id [{}]", sessionUploadId.get());
 
-        httpServer.createContext("/upload/storage/v1/b/bucket/o", exchange -> {
+        httpServer.createContext("/upload/storage/v1/b/bucket/o", safeHandler(exchange -> {
             final Map<String, String> params = new HashMap<>();
             RestUtils.decodeQueryString(exchange.getRequestURI().getQuery(), 0, params);
             assertThat(params.get("uploadType"), equalTo("resumable"));
@@ -338,7 +337,6 @@ public void testWriteLargeBlob() throws IOException {
                         "/upload/storage/v1/b/bucket/o?uploadType=resumable&upload_id=" + sessionUploadId.get());
                     exchange.sendResponseHeaders(RestStatus.OK.getStatus(), response.length);
                     exchange.getResponseBody().write(response);
-                    exchange.close();
                     return;
                 }
                 if (allowReadTimeout.get()) {
@@ -353,7 +351,6 @@ public void testWriteLargeBlob() throws IOException {
                     assertThat(wrongChunk, greaterThan(0));
                     Streams.readFully(exchange.getRequestBody());
                     exchange.sendResponseHeaders(HttpStatus.SC_GONE, -1);
-                    exchange.close();
                     return;
                 }
 
@@ -373,7 +370,6 @@ public void testWriteLargeBlob() throws IOException {
 
                         Streams.readFully(exchange.getRequestBody());
                         exchange.sendResponseHeaders(HttpStatus.SC_GONE, -1);
-                        exchange.close();
                         return;
                     }
                 }
@@ -394,13 +390,11 @@ public void testWriteLargeBlob() throws IOException {
                     final Integer limit = getContentRangeLimit(range);
                     if (limit != null) {
                         exchange.sendResponseHeaders(RestStatus.OK.getStatus(), -1);
-                        exchange.close();
                         return;
                     } else {
                         exchange.getResponseHeaders().add("Range", String.format(Locale.ROOT, "bytes=%d/%d", rangeStart, rangeEnd));
                         exchange.getResponseHeaders().add("Content-Length", "0");
                         exchange.sendResponseHeaders(308 /* Resume Incomplete */, -1);
-                        exchange.close();
                         return;
                     }
                 }
@@ -411,8 +405,7 @@ public void testWriteLargeBlob() throws IOException {
             if (randomBoolean()) {
                 exchange.sendResponseHeaders(HttpStatus.SC_INTERNAL_SERVER_ERROR, -1);
             }
-            exchange.close();
-        });
+        }));
 
         final TimeValue readTimeout = allowReadTimeout.get() ? TimeValue.timeValueSeconds(3) : null;
 
@@ -426,6 +419,17 @@ public void testWriteLargeBlob() throws IOException {
         assertThat(allow410Gone.get(), is(false));
     }
 
+    private HttpHandler safeHandler(HttpHandler handler) {
+        final HttpHandler loggingHandler = ESMockAPIBasedRepositoryIntegTestCase.wrap(handler, logger);
+        return exchange -> {
+            try {
+                loggingHandler.handle(exchange);
+            } finally {
+                exchange.close();
+            }
+        };
+    }
+
     private static byte[] randomBlobContent() {
         return randomByteArrayOfLength(randomIntBetween(1, frequently() ? 512 : 1 << 20)); // rarely up to 1mb
     }
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESMockAPIBasedRepositoryIntegTestCase.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESMockAPIBasedRepositoryIntegTestCase.java
index 03f89125ad979..ce36027b81379 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESMockAPIBasedRepositoryIntegTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/ESMockAPIBasedRepositoryIntegTestCase.java
@@ -232,7 +232,7 @@ protected boolean canFailRequest(final HttpExchange exchange) {
     /**
      * Wrap a {@link HttpHandler} to log any thrown exception using the given {@link Logger}.
      */
-    private static HttpHandler wrap(final HttpHandler handler, final Logger logger) {
+    public static HttpHandler wrap(final HttpHandler handler, final Logger logger) {
         return exchange -> {
             try {
                 handler.handle(exchange);

From 2d27087e45e647ed7dd4b067473dac552bc64dc1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 9 Jan 2020 09:43:55 +0100
Subject: [PATCH 471/686] [DOCS] Clarifies
 model_size_stats.total_xxx_field_count objects and removes notes in GET job
 stats API docs. (#50728)

---
 .../apis/get-job-stats.asciidoc               | 21 ++++++-------------
 1 file changed, 6 insertions(+), 15 deletions(-)

diff --git a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
index f71a1964fdbca..22ff5372fc11d 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
@@ -230,25 +230,16 @@ this value indicates the latest size.
 (string) For internal use. The type of result.
 
 `model_size_stats`.`total_by_field_count`:::
-(long) The number of `by` field values that were analyzed by the models.
-+
---
-NOTE: The `by` field values are counted separately for each detector and
-partition.
-
---
+(long) The number of `by` field values that were analyzed by the models. This 
+value is cumulative for all detectors.
 
 `model_size_stats`.`total_over_field_count`:::
-(long) The number of `over` field values that were analyzed by the models.
-+
---
-NOTE: The `over` field values are counted separately for each detector and
-partition.
-
---
+(long) The number of `over` field values that were analyzed by the models. This 
+value is cumulative for all detectors.
 
 `model_size_stats`.`total_partition_field_count`:::
-(long) The number of `partition` field values that were analyzed by the models.
+(long) The number of `partition` field values that were analyzed by the models. 
+This value is cumulative for all detectors.
 
 `model_size_stats`.`timestamp`:::
 (date) The timestamp of the `model_size_stats` according to the timestamp of the

From 4f1a344806810e93a35094aca27cc6a30740b37d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 9 Jan 2020 10:44:07 +0100
Subject: [PATCH 472/686] [DOCS] Forms role and privilege requirements as
 bulleted lists in DFA API docs (#50732)

Co-Authored-By: Lisa Cawley <lcawley@elastic.co>
---
 .../apis/delete-dfanalytics.asciidoc             |  8 ++++++--
 .../apis/delete-inference-trained-model.asciidoc |  9 ++++++---
 .../apis/evaluate-dfanalytics.asciidoc           |  9 ++++++---
 .../apis/explain-dfanalytics.asciidoc            |  7 +++++--
 .../apis/get-dfanalytics-stats.asciidoc          |  7 +++++--
 .../df-analytics/apis/get-dfanalytics.asciidoc   |  7 +++++--
 .../get-inference-trained-model-stats.asciidoc   |  7 +++++--
 .../apis/get-inference-trained-model.asciidoc    |  7 +++++--
 .../df-analytics/apis/put-dfanalytics.asciidoc   | 15 +++++++++++----
 .../df-analytics/apis/start-dfanalytics.asciidoc | 16 ++++++++++++----
 .../df-analytics/apis/stop-dfanalytics.asciidoc  |  9 +++++++--
 11 files changed, 73 insertions(+), 28 deletions(-)

diff --git a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
index a7adad79185d2..dd3946971853a 100644
--- a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
@@ -21,8 +21,12 @@ experimental[]
 [[ml-delete-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `machine_learning_admin` built-in role to use this API. For more
-information, see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+
+* `machine_learning_admin`
+* `kibana_user` (UI only)
+
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-delete-dfanalytics-path-params]]
diff --git a/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc b/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
index f2fd703dd83da..086c093927bd9 100644
--- a/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
@@ -22,8 +22,12 @@ experimental[]
 [[ml-delete-inference-prereq]]
 ==== {api-prereq-title}
 
-* You must have `machine_learning_admin` built-in role to use this API. For more 
-information, see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+
+* `machine_learning_admin`
+* `kibana_user` (UI only)
+
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-delete-inference-path-params]]
@@ -64,4 +68,3 @@ The API returns the following result:
 }
 ----
 
-
diff --git a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
index bcba82992d154..0f4f5b222e56e 100644
--- a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
@@ -22,8 +22,11 @@ experimental[]
 [[ml-evaluate-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `monitor_ml` privilege to use this API. For more 
-information, see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following privileges:
+
+* cluster: `monitor_ml`
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-evaluate-dfanalytics-desc]]
@@ -426,4 +429,4 @@ predictions associated with the class.
 <4> The number of cats in the dataset that are correctly identified as cats.
 <5> The number of cats in the dataset that are incorrectly classified as dogs.
 <6> The number of documents that are classified as a class that is not listed as 
-a `predicted_class`.
\ No newline at end of file
+a `predicted_class`.
diff --git a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
index 980e2aa7d3fbb..f2f570cadafb7 100644
--- a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
@@ -28,8 +28,11 @@ experimental[]
 [[ml-explain-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `monitor_ml` privilege to use this API. For more
-information, see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following privileges:
+
+* cluster: `monitor_ml`
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-explain-dfanalytics-desc]]
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
index 91c022e9b64b1..508e1072349b4 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
@@ -28,8 +28,11 @@ experimental[]
 [[ml-get-dfanalytics-stats-prereq]]
 ==== {api-prereq-title}
 
-* You must have `monitor_ml` privilege to use this API. For more 
-information, see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following privileges:
+
+* cluster: `monitor_ml`
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-get-dfanalytics-stats-path-params]]
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
index 816135fb62263..dfcf647591226 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
@@ -27,8 +27,11 @@ experimental[]
 [[ml-get-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `monitor_ml` privilege to use this API. For more information, 
-see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following privileges:
+
+* cluster: `monitor_ml`
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-get-dfanalytics-desc]]
diff --git a/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
index a31dc071640bc..8bc882084332b 100644
--- a/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
@@ -29,8 +29,11 @@ experimental[]
 [[ml-get-inference-stats-prereq]]
 ==== {api-prereq-title}
 
-* You must have `monitor_ml` privilege to use this API. For more information, 
-see <<security-privileges>> and <<built-in-roles>>.
+Required privileges which should be added to a custom role:
+
+* cluster: `monitor_ml`
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-get-inference-stats-desc]]
diff --git a/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc b/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
index 8586962c835cc..e972cf040e222 100644
--- a/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
@@ -29,8 +29,11 @@ experimental[]
 [[ml-get-inference-prereq]]
 ==== {api-prereq-title}
 
-* You must have `monitor_ml` privilege to use this API. For more information, 
-see <<security-privileges>> and <<built-in-roles>>.
+Required privileges which should be added to a custom role:
+
+* cluster: `monitor_ml`
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-get-inference-desc]]
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index d549e6824002e..4cd48508a0e37 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -20,10 +20,17 @@ experimental[]
 [[ml-put-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `machine_learning_admin` built-in role to use this API. You must 
-also have `read` and `view_index_metadata` privileges on the source index and 
-`read`, `create_index`, and `index` privileges on the destination index. For 
-more information, see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following built-in roles and privileges:
+
+* `machine_learning_admin`
+* `kibana_user` (UI only)
+
+
+* source index: `read`, `view_index_metadata`
+* destination index: `read`, `create_index`, `manage` and `index`
+* cluster: `monitor` (UI only)
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 
 [[ml-put-dfanalytics-desc]]
diff --git a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
index 6e1fd7ffe1a44..f2b1586c31b28 100644
--- a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
@@ -20,10 +20,18 @@ experimental[]
 [[ml-start-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `machine_learning_admin` built-in role to use this API. You must 
-also have `read` and `view_index_metadata` privileges on the source index and 
-`read`, `create_index`, and `index` privileges on the destination index. For 
-more information, see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following built-in roles and privileges:
+
+* `machine_learning_admin`
+* `kibana_user` (UI only)
+
+
+* source index: `read`, `view_index_metadata`
+* destination index: `read`, `create_index`, `manage` and `index`
+* cluster: `monitor` (UI only)
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
+
 
 [[ml-start-dfanalytics-path-params]]
 ==== {api-path-parms-title}
diff --git a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
index 7ea707b9d1b7f..741e4551ceb66 100644
--- a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
@@ -24,8 +24,13 @@ experimental[]
 [[ml-stop-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-* You must have `machine_learning_admin` built-in role to use this API. For more 
-information, see <<security-privileges>> and <<built-in-roles>>.
+If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+
+* `machine_learning_admin`
+* `kibana_user` (UI only)
+  
+For more information, see <<security-privileges>> and <<built-in-roles>>.
+
 
 [[ml-stop-dfanalytics-desc]]
 ==== {api-description-title}

From 2f9db156f8d3a27d47f5a855cc613a568ca75635 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 9 Jan 2020 11:19:19 +0100
Subject: [PATCH 473/686] [DOCS] Improves find_file_structure documentation
 (#50743)

Co-authored-by: Lisa Cawley <lcawley@elastic.co>
---
 .../apis/find-file-structure.asciidoc         | 79 ++++++++++++++-----
 1 file changed, 58 insertions(+), 21 deletions(-)

diff --git a/docs/reference/ml/anomaly-detection/apis/find-file-structure.asciidoc b/docs/reference/ml/anomaly-detection/apis/find-file-structure.asciidoc
index 52afbab9c704d..4f85e39d60aa0 100644
--- a/docs/reference/ml/anomaly-detection/apis/find-file-structure.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/find-file-structure.asciidoc
@@ -11,11 +11,13 @@ experimental[]
 Finds the structure of a text file. The text file must contain data that is
 suitable to be ingested into {es}.
 
+
 [[ml-find-file-structure-request]]
 ==== {api-request-title}
 
 `POST _ml/find_file_structure`
 
+
 [[ml-find-file-structure-prereqs]]
 ==== {api-prereq-title}
 
@@ -23,6 +25,7 @@ suitable to be ingested into {es}.
 `monitor` cluster privileges to use this API. See
 <<security-privileges>>.
 
+
 [[ml-find-file-structure-desc]]
 ==== {api-description-title}
 
@@ -55,41 +58,42 @@ specify the `explain` query parameter. It causes an `explanation` to appear in
 the response, which should help in determining why the returned structure was
 chosen.
 
+
 [[ml-find-file-structure-query-parms]]
 ==== {api-query-parms-title}
 
 `charset`::
-  (string) Optional. The file's character set. It must be a character set that
+  (Optional, string) The file's character set. It must be a character set that
   is supported by the JVM that {es} uses. For example, `UTF-8`, `UTF-16LE`,
   `windows-1252`, or `EUC-JP`. If this parameter is not specified, the structure
   finder chooses an appropriate character set.
 
 `column_names`::
-  (string) Optional. If you have set `format` to `delimited`, you can specify
+  (Optional, string) If you have set `format` to `delimited`, you can specify
   the column names in a comma-separated list. If this parameter is not specified,
   the structure finder uses the column names from the header row of the file. If
   the file does not have a header role, columns are named "column1", "column2",
   "column3", etc.
 
 `delimiter`::
-  (string) Optional. If you have set `format` to `delimited`, you can specify
+  (Optional, string) If you have set `format` to `delimited`, you can specify
   the character used to delimit the values in each row. Only a single character
   is supported; the delimiter cannot have multiple characters. If this parameter
   is not specified, the structure finder considers the following possibilities:
   comma, tab, semi-colon, and pipe (`|`).
 
 `explain`::
-  (boolean) Optional. If this parameter is set to `true`, the response includes
+  (Optional, boolean) If this parameter is set to `true`, the response includes
   a field named `explanation`, which is an array of strings that indicate how
   the structure finder produced its result. The default value is `false`.
 
 `format`::
-  (string) Optional. The high level structure of the file. Valid values are
+  (Optional, string) The high level structure of the file. Valid values are
   `ndjson`, `xml`, `delimited`, and `semi_structured_text`. If this parameter is
   not specified, the structure finder chooses one.
 
 `grok_pattern`::
-  (string) Optional. If you have set `format` to `semi_structured_text`, you can
+  (Optional, string) If you have set `format` to `semi_structured_text`, you can
   specify a Grok pattern that is used to extract fields from every message in
   the file. The name of the timestamp field in the Grok pattern must match what
   is specified in the `timestamp_field` parameter. If that parameter is not
@@ -98,20 +102,20 @@ chosen.
   a Grok pattern.
 
 `has_header_row`::
-  (boolean) Optional. If you have set `format` to `delimited`, you can use this
+  (Optional, boolean) If you have set `format` to `delimited`, you can use this
   parameter to indicate whether the column names are in the first row of the
   file. If this parameter is not specified, the structure finder guesses based
   on the similarity of the first row of the file to other rows.
 
 `line_merge_size_limit`::
-  (unsigned integer) Optional. The maximum number of characters in a message
+  (Optional, unsigned integer) The maximum number of characters in a message
   when lines are merged to form messages while analyzing semi-structured files.
   The default is `10000`. If you have extremely long messages you may need to
   increase this, but be aware that this may lead to very long processing times
   if the way to group lines into messages is misdetected.
 
 `lines_to_sample`::
-  (unsigned integer) Optional. The number of lines to include in the structural
+  (Optional, unsigned integer) The number of lines to include in the structural
   analysis, starting from the beginning of the file. The minimum is 2; the
   default is `1000`. If the value of this parameter is greater than the number
   of lines in the file, the analysis proceeds (as long as there are at least two
@@ -127,7 +131,7 @@ to request analysis of 100000 lines to achieve some variety.
 --
 
 `quote`::
-  (string) Optional. If you have set `format` to `delimited`, you can specify
+  (Optional, string) If you have set `format` to `delimited`, you can specify
   the character used to quote the values in each row if they contain newlines or
   the delimiter character. Only a single character is supported. If this
   parameter is not specified, the default value is a double quote (`"`). If your
@@ -135,18 +139,18 @@ to request analysis of 100000 lines to achieve some variety.
   argument to a character that does not appear anywhere in the sample.
 
 `should_trim_fields`::
-  (boolean) Optional. If you have set `format` to `delimited`, you can specify
+  (Optional, boolean) If you have set `format` to `delimited`, you can specify
   whether values between delimiters should have whitespace trimmed from them. If
   this parameter is not specified and the delimiter is pipe (`|`), the default
   value is `true`. Otherwise, the default value is `false`.
 
 `timeout`::
-  (time) Optional. Sets the maximum amount of time that the structure analysis
-  make take. If the analysis is still running when the timeout expires then it
-  will be aborted. The default value is 25 seconds.
+  (Optional, <<time-units,time units>>) Sets the maximum amount of time that the 
+  structure analysis make take. If the analysis is still running when the 
+  timeout expires then it will be aborted. The default value is 25 seconds.
 
 `timestamp_field`::
-  (string) Optional. The name of the field that contains the primary timestamp
+  (Optional, string) The name of the field that contains the primary timestamp
   of each record in the file. In particular, if the file were ingested into an
   index, this is the field that would be used to populate the `@timestamp` field.
 +
@@ -159,16 +163,16 @@ also specified.
 For structured file formats, if you specify this parameter, the field must exist
 within the file.
 
-If this parameter is not specified, the structure finder makes a decision about which
-field (if any) is the primary timestamp field. For structured file formats, it
-is not compulsory to have a timestamp in the file.
+If this parameter is not specified, the structure finder makes a decision about 
+which field (if any) is the primary timestamp field. For structured file 
+formats, it is not compulsory to have a timestamp in the file.
 --
 
 `timestamp_format`::
-  (string) Optional. The Java time format of the timestamp field in the file. +
+  (Optional, string) The Java time format of the timestamp field in the file.
 +
 --
-NOTE: Only a subset of Java time format letter groups are supported:
+Only a subset of Java time format letter groups are supported:
 
 * `a`
 * `d`
@@ -206,6 +210,20 @@ structure finder does not consider by default.
 If this parameter is not specified, the structure finder chooses the best
 format from a built-in set.
 
+The following table provides the appropriate `timeformat` values for some example timestamps:
+
+|===
+| Timeformat                 | Presentation 
+
+| yyyy-MM-dd HH:mm:ssZ       | 2019-04-20 13:15:22+0000
+| EEE, d MMM yyyy HH:mm:ss Z | Sat, 20 Apr 2019 13:15:22 +0000    
+| dd.MM.yy HH:mm:ss.SSS      | 20.04.19 13:15:22.285
+|===
+
+See 
+https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html[the Java date/time format documentation]
+for more information about date and time format syntax.
+
 --
 
 [[ml-find-file-structure-request-body]]
@@ -219,6 +237,9 @@ size, which defaults to 100 Mb.
 [[ml-find-file-structure-examples]]
 ==== {api-examples-title}
 
+[[ml-find-file-structure-example-nld-json]]
+===== Ingesting newline-delimited JSON
+
 Suppose you have a newline-delimited JSON file that contains information about
 some books. You can send the contents to the `find_file_structure` endpoint:
 
@@ -527,6 +548,10 @@ If the request does not encounter errors, you receive the following result:
      may provide clues that the data needs to be cleaned or transformed prior
      to use by other {ml} functionality.
 
+
+[[ml-find-file-structure-example-nyc]]
+===== Finding the structure of NYC yellow cab example data
+
 The next example shows how it's possible to find the structure of some New York
 City yellow cab trip data. The first `curl` command downloads the data, the
 first 20000 lines of which are then piped into the `find_file_structure`
@@ -543,7 +568,7 @@ curl -s "s3.amazonaws.com/nyc-tlc/trip+data/yellow_tripdata_2018-06.csv" | head
 --
 NOTE: The `Content-Type: application/json` header must be set even though in
 this case the data is not JSON. (Alternatively the `Content-Type` can be set
-to any other supported by Elasticsearch, but it must be set.)
+to any other supported by {es}, but it must be set.)
 --
 
 If the request does not encounter errors, you receive the following result:
@@ -1333,6 +1358,10 @@ If the request does not encounter errors, you receive the following result:
      necessary to supply the timezone they relate to. `need_client_timezone`
      will be `false` for timestamp formats that include the timezone.
 
+
+[[ml-find-file-structure-example-timeout]]
+===== Setting the timeout parameter
+
 If you try to analyze a lot of data then the analysis will take a long time.
 If you want to limit the amount of processing your {es} cluster performs for
 a request, use the `timeout` query parameter. The analysis will be aborted and
@@ -1375,6 +1404,10 @@ and the timeout is measured from the time this endpoint starts to process the
 data.
 --
 
+
+[[ml-find-file-structure-example-eslog]]
+===== Analyzing {es} log files
+
 This is an example of analyzing {es}'s own log file:
 
 [source,js]
@@ -1523,6 +1556,10 @@ this:
     and recognizable fields that appear in every analyzed message. In this case
     the only field that was recognized beyond the timestamp was the log level.
 
+
+[[ml-find-file-structure-example-grok]]
+===== Specifying `grok_pattern` as query parameter
+
 If you recognize more fields than the simple `grok_pattern` produced by the
 structure finder unaided then you can resubmit the request specifying a more
 advanced `grok_pattern` as a query parameter and the structure finder will

From 76c6cd115cc80f45a839816e01f8cc132d083c28 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 9 Jan 2020 11:42:02 +0100
Subject: [PATCH 474/686] Remove Snapshot Tool from 8.0+ (#50784)

We are only using the snapshot tool with JDK8 and it only works until and excluding 7.4.0.
There is no point in continuing to have it in `master`. We should maintain it in `7.x` if
it ever needs any changes but its unused and just dead code in `master`.
---
 .../fixtures/minio-fixture/docker-compose.yml |  12 -
 .../blobstore/BlobStoreTestUtil.java          |  45 --
 x-pack/snapshot-tool/build.gradle             | 203 -----
 .../licenses/api-common-1.8.1.jar.sha1        |   1 -
 .../licenses/api-common-LICENSE.txt           |  27 -
 .../licenses/api-common-NOTICE.txt            |   0
 .../licenses/aws-java-sdk-LICENSE.txt         |  63 --
 .../licenses/aws-java-sdk-NOTICE.txt          |  15 -
 .../aws-java-sdk-core-1.11.636.jar.sha1       |   1 -
 .../aws-java-sdk-s3-1.11.636.jar.sha1         |   1 -
 .../licenses/commons-codec-1.11.jar.sha1      |   1 -
 .../licenses/commons-codec-LICENSE.txt        | 202 -----
 .../licenses/commons-codec-NOTICE.txt         |  17 -
 .../licenses/commons-logging-1.1.3.jar.sha1   |   1 -
 .../licenses/commons-logging-LICENSE.txt      | 202 -----
 .../licenses/commons-logging-NOTICE.txt       |   5 -
 .../licenses/gax-1.45.0.jar.sha1              |   1 -
 x-pack/snapshot-tool/licenses/gax-LICENSE.txt |  27 -
 x-pack/snapshot-tool/licenses/gax-NOTICE.txt  |   0
 .../licenses/gax-httpjson-0.62.0.jar.sha1     |   1 -
 .../licenses/gax-httpjson-LICENSE.txt         |  27 -
 .../licenses/gax-httpjson-NOTICE.txt          |   0
 .../google-api-client-1.28.0.jar.sha1         |   1 -
 .../licenses/google-api-client-LICENSE.txt    | 201 -----
 .../licenses/google-api-client-NOTICE.txt     |   0
 .../google-api-services-storage-LICENSE.txt   | 201 -----
 .../google-api-services-storage-NOTICE.txt    |   0
 ...ces-storage-v1-rev20190426-1.28.0.jar.sha1 |   1 -
 .../licenses/google-auth-LICENSE.txt          |  28 -
 .../licenses/google-auth-NOTICE.txt           |   0
 ...e-auth-library-credentials-0.16.1.jar.sha1 |   1 -
 ...e-auth-library-oauth2-http-0.16.1.jar.sha1 |   1 -
 .../licenses/google-cloud-LICENSE.txt         | 201 -----
 .../licenses/google-cloud-NOTICE.txt          |   0
 .../google-cloud-core-1.77.0.jar.sha1         |   1 -
 .../google-cloud-core-http-1.77.0.jar.sha1    |   1 -
 .../google-cloud-storage-1.77.0.jar.sha1      |   1 -
 .../licenses/google-http-LICENSE.txt          | 201 -----
 .../licenses/google-http-NOTICE.txt           |   0
 .../google-http-client-1.30.1.jar.sha1        |   1 -
 ...ogle-http-client-appengine-1.29.2.jar.sha1 |   1 -
 ...oogle-http-client-jackson2-1.29.2.jar.sha1 |   1 -
 .../google-oauth-client-1.28.0.jar.sha1       |   1 -
 .../licenses/google-oauth-client-LICENSE.txt  |  28 -
 .../licenses/google-oauth-client-NOTICE.txt   |   0
 .../licenses/grpc-context-1.12.0.jar.sha1     |   1 -
 .../licenses/grpc-context-LICENSE.txt         | 202 -----
 .../licenses/grpc-context-NOTICE.txt          |   0
 .../snapshot-tool/licenses/gson-2.7.jar.sha1  |   1 -
 .../snapshot-tool/licenses/gson-LICENSE.txt   | 202 -----
 x-pack/snapshot-tool/licenses/gson-NOTICE.txt |   0
 .../licenses/guava-26.0-jre.jar.sha1          |   1 -
 .../snapshot-tool/licenses/guava-LICENSE.txt  | 202 -----
 .../snapshot-tool/licenses/guava-NOTICE.txt   |   0
 .../licenses/httpclient-4.5.10.jar.sha1       |   1 -
 .../licenses/httpclient-LICENSE.txt           | 558 --------------
 .../licenses/httpclient-NOTICE.txt            |   5 -
 .../licenses/httpcore-4.4.12.jar.sha1         |   1 -
 x-pack/snapshot-tool/licenses/jackson-LICENSE |   8 -
 x-pack/snapshot-tool/licenses/jackson-NOTICE  |  20 -
 .../jackson-annotations-2.8.11.jar.sha1       |   1 -
 .../licenses/jackson-core-2.8.11.jar.sha1     |   1 -
 .../jackson-databind-2.8.11.4.jar.sha1        |   1 -
 .../snapshot-tool/licenses/jaxb-LICENSE.txt   | 705 ------------------
 x-pack/snapshot-tool/licenses/jaxb-NOTICE.txt |   1 -
 .../licenses/jaxb-api-2.2.2.jar.sha1          |   1 -
 .../licenses/jmespath-java-1.11.636.jar.sha1  |   1 -
 .../licenses/log4j-1.2-api-2.11.1.jar.sha1    |   1 -
 .../snapshot-tool/licenses/log4j-LICENSE.txt  | 202 -----
 .../snapshot-tool/licenses/log4j-NOTICE.txt   |   5 -
 .../licenses/opencensus-LICENSE.txt           | 202 -----
 .../licenses/opencensus-NOTICE.txt            |   0
 .../licenses/opencensus-api-0.18.0.jar.sha1   |   1 -
 ...encensus-contrib-http-util-0.18.0.jar.sha1 |   1 -
 .../licenses/proto-google-LICENSE.txt         | 202 -----
 .../licenses/proto-google-NOTICE.txt          |   0
 ...proto-google-common-protos-1.16.0.jar.sha1 |   1 -
 .../proto-google-iam-v1-0.12.0.jar.sha1       |   1 -
 .../licenses/protobuf-LICENSE.txt             |  32 -
 .../licenses/protobuf-NOTICE.txt              |  32 -
 .../licenses/protobuf-java-3.7.1.jar.sha1     |   1 -
 .../protobuf-java-util-3.7.1.jar.sha1         |   1 -
 .../licenses/threetenbp-1.3.3.jar.sha1        |   1 -
 .../licenses/threetenbp-LICENSE.txt           |  31 -
 .../licenses/threetenbp-NOTICE.txt            |   0
 x-pack/snapshot-tool/qa/build.gradle          |   1 -
 .../qa/google-cloud-storage/build.gradle      |  88 ---
 .../snapshots/GCSCleanupTests.java            | 109 ---
 x-pack/snapshot-tool/qa/s3/build.gradle       |  74 --
 .../snapshots/S3CleanupTests.java             | 136 ----
 .../src/bin/elasticsearch-snapshot            |  35 -
 .../snapshots/AbstractCleanupCommand.java     |  75 --
 .../snapshots/AbstractRepository.java         | 305 --------
 .../CleanupGCSRepositoryCommand.java          |  60 --
 .../snapshots/CleanupS3RepositoryCommand.java |  77 --
 .../snapshots/GCSRepository.java              | 220 ------
 .../elasticsearch/snapshots/S3Repository.java | 179 -----
 .../snapshots/SnapshotToolCli.java            |  25 -
 .../snapshots/AbstractCleanupTests.java       | 275 -------
 99 files changed, 6009 deletions(-)
 delete mode 100644 x-pack/snapshot-tool/build.gradle
 delete mode 100644 x-pack/snapshot-tool/licenses/api-common-1.8.1.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/api-common-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/api-common-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/aws-java-sdk-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/aws-java-sdk-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/aws-java-sdk-core-1.11.636.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/aws-java-sdk-s3-1.11.636.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/commons-codec-1.11.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/commons-codec-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/commons-codec-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/commons-logging-1.1.3.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/commons-logging-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/commons-logging-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/gax-1.45.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/gax-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/gax-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/gax-httpjson-0.62.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/gax-httpjson-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/gax-httpjson-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-api-client-1.28.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-api-client-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-api-client-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-api-services-storage-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-api-services-storage-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-api-services-storage-v1-rev20190426-1.28.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-auth-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-auth-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-auth-library-credentials-0.16.1.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-auth-library-oauth2-http-0.16.1.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-cloud-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-cloud-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-cloud-core-1.77.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-cloud-core-http-1.77.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-cloud-storage-1.77.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-http-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-http-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-http-client-1.30.1.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-http-client-appengine-1.29.2.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-http-client-jackson2-1.29.2.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-oauth-client-1.28.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/google-oauth-client-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/google-oauth-client-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/grpc-context-1.12.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/grpc-context-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/grpc-context-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/gson-2.7.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/gson-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/gson-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/guava-26.0-jre.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/guava-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/guava-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/httpclient-4.5.10.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/httpclient-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/httpclient-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/httpcore-4.4.12.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/jackson-LICENSE
 delete mode 100644 x-pack/snapshot-tool/licenses/jackson-NOTICE
 delete mode 100644 x-pack/snapshot-tool/licenses/jackson-annotations-2.8.11.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/jackson-core-2.8.11.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/jaxb-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/jaxb-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/jaxb-api-2.2.2.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/jmespath-java-1.11.636.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/log4j-1.2-api-2.11.1.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/log4j-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/log4j-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/opencensus-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/opencensus-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/opencensus-api-0.18.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/opencensus-contrib-http-util-0.18.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/proto-google-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/proto-google-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/proto-google-common-protos-1.16.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/proto-google-iam-v1-0.12.0.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/protobuf-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/protobuf-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/protobuf-java-3.7.1.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/protobuf-java-util-3.7.1.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/threetenbp-1.3.3.jar.sha1
 delete mode 100644 x-pack/snapshot-tool/licenses/threetenbp-LICENSE.txt
 delete mode 100644 x-pack/snapshot-tool/licenses/threetenbp-NOTICE.txt
 delete mode 100644 x-pack/snapshot-tool/qa/build.gradle
 delete mode 100644 x-pack/snapshot-tool/qa/google-cloud-storage/build.gradle
 delete mode 100644 x-pack/snapshot-tool/qa/google-cloud-storage/src/test/java/org/elasticsearch/snapshots/GCSCleanupTests.java
 delete mode 100644 x-pack/snapshot-tool/qa/s3/build.gradle
 delete mode 100644 x-pack/snapshot-tool/qa/s3/src/test/java/org/elasticsearch/snapshots/S3CleanupTests.java
 delete mode 100755 x-pack/snapshot-tool/src/bin/elasticsearch-snapshot
 delete mode 100644 x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/AbstractCleanupCommand.java
 delete mode 100644 x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/AbstractRepository.java
 delete mode 100644 x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/CleanupGCSRepositoryCommand.java
 delete mode 100644 x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/CleanupS3RepositoryCommand.java
 delete mode 100644 x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/GCSRepository.java
 delete mode 100644 x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/S3Repository.java
 delete mode 100644 x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/SnapshotToolCli.java
 delete mode 100644 x-pack/snapshot-tool/src/test/java/org/elasticsearch/snapshots/AbstractCleanupTests.java

diff --git a/test/fixtures/minio-fixture/docker-compose.yml b/test/fixtures/minio-fixture/docker-compose.yml
index e4df64ad75fcb..5cd14ceec8e29 100644
--- a/test/fixtures/minio-fixture/docker-compose.yml
+++ b/test/fixtures/minio-fixture/docker-compose.yml
@@ -11,15 +11,3 @@ services:
     ports:
       - "9000"
     command: ["server", "/minio/data"]
-
-  minio-fixture-for-snapshot-tool:
-      build:
-        context: .
-        args:
-          bucket: "bucket"
-          accessKey: "sn_tool_access_key"
-          secretKey: "sn_tool_secret_key"
-        dockerfile: Dockerfile
-      ports:
-        - "9000"
-      command: ["server", "/minio/data"]
diff --git a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
index 75f6a660fb13d..54ea0f26dcd0a 100644
--- a/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
+++ b/test/framework/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreTestUtil.java
@@ -38,7 +38,6 @@
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobMetaData;
 import org.elasticsearch.common.blobstore.BlobPath;
-import org.elasticsearch.common.blobstore.BlobStore;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -53,7 +52,6 @@
 import org.elasticsearch.test.InternalTestCluster;
 import org.elasticsearch.threadpool.ThreadPool;
 
-import java.io.ByteArrayInputStream;
 import java.io.DataInputStream;
 import java.io.IOException;
 import java.io.InputStream;
@@ -64,11 +62,8 @@
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
-import java.util.Set;
 import java.util.concurrent.CopyOnWriteArrayList;
-import java.util.concurrent.ExecutionException;
 import java.util.concurrent.Executor;
-import java.util.concurrent.atomic.AtomicLong;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.stream.Collectors;
 
@@ -246,46 +241,6 @@ private static void assertSnapshotUUIDs(BlobStoreRepository repository, Reposito
             count, lessThanOrEqualTo(maxShardCountsExpected.get(indexId)))));
     }
 
-    public static long createDanglingIndex(BlobStoreRepository repository, String name, Set<String> files)
-            throws InterruptedException, ExecutionException {
-        final PlainActionFuture<Void> future = PlainActionFuture.newFuture();
-        final AtomicLong totalSize = new AtomicLong();
-        repository.threadPool().generic().execute(ActionRunnable.run(future, () -> {
-            final BlobStore blobStore = repository.blobStore();
-            BlobContainer container =
-                blobStore.blobContainer(repository.basePath().add("indices").add(name));
-            for (String file : files) {
-                int size = randomIntBetween(0, 10);
-                totalSize.addAndGet(size);
-                container.writeBlob(file, new ByteArrayInputStream(new byte[size]), size, false);
-            }
-        }));
-        future.get();
-        return totalSize.get();
-    }
-
-    public static void assertCorruptionVisible(BlobStoreRepository repository, Map<String, Set<String>> indexToFiles) {
-        final PlainActionFuture<Boolean> future = PlainActionFuture.newFuture();
-        repository.threadPool().generic().execute(ActionRunnable.supply(future, () -> {
-            final BlobStore blobStore = repository.blobStore();
-            for (String index : indexToFiles.keySet()) {
-                if (blobStore.blobContainer(repository.basePath().add("indices"))
-                    .children().containsKey(index) == false) {
-                    return false;
-                }
-                for (String file : indexToFiles.get(index)) {
-                    try (InputStream ignored =
-                             blobStore.blobContainer(repository.basePath().add("indices").add(index)).readBlob(file)) {
-                    } catch (NoSuchFileException e) {
-                        return false;
-                    }
-                }
-            }
-            return true;
-        }));
-        assertTrue(future.actionGet());
-    }
-
     public static void assertBlobsByPrefix(BlobStoreRepository repository, BlobPath path, String prefix, Map<String, BlobMetaData> blobs) {
         final PlainActionFuture<Map<String, BlobMetaData>> future = PlainActionFuture.newFuture();
         repository.threadPool().generic().execute(
diff --git a/x-pack/snapshot-tool/build.gradle b/x-pack/snapshot-tool/build.gradle
deleted file mode 100644
index 5717dfd9cf230..0000000000000
--- a/x-pack/snapshot-tool/build.gradle
+++ /dev/null
@@ -1,203 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-import java.nio.file.Files
-import java.nio.file.Paths
-import org.elasticsearch.gradle.ElasticsearchDistribution
-
-apply plugin: 'elasticsearch.build'
-
-dependencies {
-  compile project(":server")
-  compile project(":libs:elasticsearch-cli")
-  testCompile project(":test:framework")
-
-  compile "com.amazonaws:aws-java-sdk-s3:${versions.aws}"
-  compile "com.amazonaws:aws-java-sdk-core:${versions.aws}"
-  compile "com.amazonaws:jmespath-java:${versions.aws}"
-  compile "org.apache.httpcomponents:httpclient:${versions.httpclient}"
-  compile "org.apache.httpcomponents:httpcore:${versions.httpcore}"
-  compile "commons-logging:commons-logging:${versions.commonslogging}"
-  compile "commons-codec:commons-codec:${versions.commonscodec}"
-  compile "org.apache.logging.log4j:log4j-1.2-api:${versions.log4j}"
-  compile "com.fasterxml.jackson.core:jackson-core:${versions.jackson}"
-  compile "com.fasterxml.jackson.core:jackson-databind:${versions.jacksondatabind}"
-  compile "com.fasterxml.jackson.core:jackson-annotations:${versions.jackson}"
-
-  // GCS dependencies
-  compile 'com.google.cloud:google-cloud-storage:1.77.0'
-  compile 'com.google.cloud:google-cloud-core:1.77.0'
-  compile 'com.google.guava:guava:26.0-jre'
-  compile 'com.google.http-client:google-http-client:1.30.1'
-  compile "org.apache.httpcomponents:httpclient:${versions.httpclient}"
-  compile "org.apache.httpcomponents:httpcore:${versions.httpcore}"
-  compile "commons-logging:commons-logging:${versions.commonslogging}"
-  compile "org.apache.logging.log4j:log4j-1.2-api:${versions.log4j}"
-  compile "commons-codec:commons-codec:${versions.commonscodec}"
-  compile 'com.google.api:api-common:1.8.1'
-  compile 'com.google.api:gax:1.45.0'
-  compile 'org.threeten:threetenbp:1.3.3'
-  compile 'com.google.protobuf:protobuf-java-util:3.7.1'
-  compile 'com.google.protobuf:protobuf-java:3.7.1'
-  compile 'com.google.code.gson:gson:2.7'
-  compile 'com.google.api.grpc:proto-google-common-protos:1.16.0'
-  compile 'com.google.api.grpc:proto-google-iam-v1:0.12.0'
-  compile 'com.google.cloud:google-cloud-core-http:1.77.0'
-  compile 'com.google.auth:google-auth-library-credentials:0.16.1'
-  compile 'com.google.auth:google-auth-library-oauth2-http:0.16.1'
-  compile 'com.google.oauth-client:google-oauth-client:1.28.0'
-  compile 'com.google.api-client:google-api-client:1.28.0'
-  compile 'com.google.http-client:google-http-client-appengine:1.29.2'
-  compile 'com.google.http-client:google-http-client-jackson2:1.29.2'
-  compile 'com.google.api:gax-httpjson:0.62.0'
-  compile 'io.grpc:grpc-context:1.12.0'
-  compile 'io.opencensus:opencensus-api:0.18.0'
-  compile 'io.opencensus:opencensus-contrib-http-util:0.18.0'
-  compile 'com.google.apis:google-api-services-storage:v1-rev20190426-1.28.0'
-
-  // HACK: javax.xml.bind was removed from default modules in java 9, so we pull the api in here,
-  // and whitelist this hack in JarHell
-  compile 'javax.xml.bind:jaxb-api:2.2.2'
-}
-
-dependencyLicenses {
-  mapping from: /aws-java-sdk-.*/, to: 'aws-java-sdk'
-  mapping from: /jmespath-java.*/, to: 'aws-java-sdk'
-  mapping from: /jackson-.*/, to: 'jackson'
-  mapping from: /jaxb-.*/, to: 'jaxb'
-
-  mapping from: /google-cloud-.*/, to: 'google-cloud'
-  mapping from: /google-auth-.*/, to: 'google-auth'
-  mapping from: /google-http-.*/, to: 'google-http'
-  mapping from: /opencensus.*/, to: 'opencensus'
-  mapping from: /http.*/, to: 'httpclient'
-  mapping from: /protobuf.*/, to: 'protobuf'
-  mapping from: /proto-google.*/, to: 'proto-google'
-}
-
-// TODO: Investigate using the new Gradle test-fixture plugin here after the upgrade to 5.6
-// There is only AbstractCleanupTests class in test directory and it's abstract
-test.enabled = false
-testingConventions.enabled = false
-
-task unpackArchive(dependsOn: tasks.assemble, type: Copy) {
-  from tarTree("${project.buildDir}/snapshot-tool-${project.version}.tgz")
-  into "${project.buildDir}"
-}
-
-task smokeTest(type: Exec) {
-  dependsOn unpackArchive
-  onlyIf { ElasticsearchDistribution.CURRENT_PLATFORM != ElasticsearchDistribution.Platform.WINDOWS }
-  commandLine "${project.buildDir}/snapshot-tool-${project.version}/bin/elasticsearch-snapshot", "-h"
-}
-
-check {
-  dependsOn smokeTest, 'qa:google-cloud-storage:check', 'qa:s3:check'
-}
-
-def vendorPath = Paths.get("${project.buildDir}/libs/vendor")
-
-task copyRuntimeLibs(type: Copy) {
-  doFirst {
-    Files.createDirectories(vendorPath)
-  }
-  into vendorPath.toString()
-  from configurations.compile, configurations.runtime
-}
-
-task buildTarArchive(dependsOn: copyRuntimeLibs, type: Tar) {
-  compression Compression.GZIP
-  archiveBaseName.set('snapshot-tool')
-  destinationDirectory.set(project.buildDir)
-  into "snapshot-tool-${version}", {
-    into "bin", {
-      from file("${project.projectDir}/src/bin")
-    }
-    into "libs", {
-      from jar.getArchiveFile()
-      from file("${project.buildDir}/libs")
-    }
-  }
-}
-
-assemble.dependsOn(buildTarArchive)
-
-thirdPartyAudit.ignoreMissingClasses(
-  // classes are missing
-  'javax.activation.DataHandler',
-  'javax.servlet.ServletContextEvent',
-  'javax.servlet.ServletContextListener',
-  'org.apache.avalon.framework.logger.Logger',
-  'org.apache.log.Hierarchy',
-  'org.apache.log.Logger',
-  'software.amazon.ion.IonReader',
-  'software.amazon.ion.IonSystem',
-  'software.amazon.ion.IonType',
-  'software.amazon.ion.IonWriter',
-  'software.amazon.ion.Timestamp',
-  'software.amazon.ion.system.IonBinaryWriterBuilder',
-  'software.amazon.ion.system.IonSystemBuilder',
-  'software.amazon.ion.system.IonTextWriterBuilder',
-  'software.amazon.ion.system.IonWriterBuilder',
-  // We don't use the kms dependency
-  'com.amazonaws.services.kms.AWSKMS',
-  'com.amazonaws.services.kms.AWSKMSClient',
-  'com.amazonaws.services.kms.model.DecryptRequest',
-  'com.amazonaws.services.kms.model.DecryptResult',
-  'com.amazonaws.services.kms.model.EncryptRequest',
-  'com.amazonaws.services.kms.model.EncryptResult',
-  'com.amazonaws.services.kms.model.GenerateDataKeyRequest',
-  'com.amazonaws.services.kms.model.GenerateDataKeyResult',
-
-  'com.google.appengine.api.datastore.Blob',
-  'com.google.appengine.api.datastore.DatastoreService',
-  'com.google.appengine.api.datastore.DatastoreServiceFactory',
-  'com.google.appengine.api.datastore.Entity',
-  'com.google.appengine.api.datastore.Key',
-  'com.google.appengine.api.datastore.KeyFactory',
-  'com.google.appengine.api.datastore.PreparedQuery',
-  'com.google.appengine.api.datastore.Query',
-  'com.google.appengine.api.memcache.Expiration',
-  'com.google.appengine.api.memcache.MemcacheService',
-  'com.google.appengine.api.memcache.MemcacheServiceFactory',
-  'com.google.appengine.api.urlfetch.FetchOptions$Builder',
-  'com.google.appengine.api.urlfetch.FetchOptions',
-  'com.google.appengine.api.urlfetch.HTTPHeader',
-  'com.google.appengine.api.urlfetch.HTTPMethod',
-  'com.google.appengine.api.urlfetch.HTTPRequest',
-  'com.google.appengine.api.urlfetch.HTTPResponse',
-  'com.google.appengine.api.urlfetch.URLFetchService',
-  'com.google.appengine.api.urlfetch.URLFetchServiceFactory',
-  // commons-logging optional dependencies
-  'org.apache.avalon.framework.logger.Logger',
-  'org.apache.log.Hierarchy',
-  'org.apache.log.Logger',
-  // commons-logging provided dependencies
-  'javax.servlet.ServletContextEvent',
-  'javax.servlet.ServletContextListener'
-)
-
-thirdPartyAudit.ignoreViolations(
-  // uses internal java api: sun.misc.Unsafe
-  'com.google.protobuf.UnsafeUtil',
-  'com.google.protobuf.UnsafeUtil$1',
-  'com.google.protobuf.UnsafeUtil$JvmMemoryAccessor',
-  'com.google.protobuf.UnsafeUtil$MemoryAccessor',
-  'com.google.common.cache.Striped64',
-  'com.google.common.cache.Striped64$1',
-  'com.google.common.cache.Striped64$Cell',
-  'com.google.common.hash.Striped64',
-  'com.google.common.hash.Striped64$1',
-  'com.google.common.hash.Striped64$Cell',
-  'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray',
-  'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray$1',
-  'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray$2',
-  'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray$3',
-  'com.google.common.util.concurrent.AbstractFuture$UnsafeAtomicHelper',
-  'com.google.common.util.concurrent.AbstractFuture$UnsafeAtomicHelper$1',
-  'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray',
-  'com.google.common.primitives.UnsignedBytes$LexicographicalComparatorHolder$UnsafeComparator',
-  'com.google.common.primitives.UnsignedBytes$LexicographicalComparatorHolder$UnsafeComparator$1',
-)
diff --git a/x-pack/snapshot-tool/licenses/api-common-1.8.1.jar.sha1 b/x-pack/snapshot-tool/licenses/api-common-1.8.1.jar.sha1
deleted file mode 100644
index 7a1c114c6c0fc..0000000000000
--- a/x-pack/snapshot-tool/licenses/api-common-1.8.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-e89befb19b08ad84b262b2f226ab79aefcaa9d7f
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/api-common-LICENSE.txt b/x-pack/snapshot-tool/licenses/api-common-LICENSE.txt
deleted file mode 100644
index 6d16b6578a2f0..0000000000000
--- a/x-pack/snapshot-tool/licenses/api-common-LICENSE.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-Copyright 2016, Google Inc.
-All rights reserved.
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-   * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-   * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-   * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/x-pack/snapshot-tool/licenses/api-common-NOTICE.txt b/x-pack/snapshot-tool/licenses/api-common-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/aws-java-sdk-LICENSE.txt b/x-pack/snapshot-tool/licenses/aws-java-sdk-LICENSE.txt
deleted file mode 100644
index 98d1f9319f374..0000000000000
--- a/x-pack/snapshot-tool/licenses/aws-java-sdk-LICENSE.txt
+++ /dev/null
@@ -1,63 +0,0 @@
-Apache License
-Version 2.0, January 2004
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
-
-"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
-
-"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
-
-"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
-
-"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
-
-"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
-
-"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
-
-"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
-
-"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
-
-"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
-
-   1.   You must give any other recipients of the Work or Derivative Works a copy of this License; and
-   2.   You must cause any modified files to carry prominent notices stating that You changed the files; and
-   3.   You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
-   4.   If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
-
-You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-Note: Other license terms may apply to certain, identified software files contained within or distributed with the accompanying software if such terms are included in the directory containing the accompanying software. Such other license terms will then apply in lieu of the terms of the software license above.
-
-JSON processing code subject to the JSON License from JSON.org:
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-The Software shall be used for Good, not Evil.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/x-pack/snapshot-tool/licenses/aws-java-sdk-NOTICE.txt b/x-pack/snapshot-tool/licenses/aws-java-sdk-NOTICE.txt
deleted file mode 100644
index 565bd6085c71a..0000000000000
--- a/x-pack/snapshot-tool/licenses/aws-java-sdk-NOTICE.txt
+++ /dev/null
@@ -1,15 +0,0 @@
-AWS SDK for Java
-Copyright 2010-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved.
-
-This product includes software developed by
-Amazon Technologies, Inc (http://www.amazon.com/).
-
-**********************
-THIRD PARTY COMPONENTS
-**********************
-This software includes third party software subject to the following copyrights:
-- XML parsing and utility functions from JetS3t - Copyright 2006-2009 James Murty.
-- JSON parsing and utility functions from JSON.org - Copyright 2002 JSON.org.
-- PKCS#1 PEM encoded private key parsing and utility functions from oauth.googlecode.com - Copyright 1998-2010 AOL Inc.
-
-The licenses for these third party components are included in LICENSE.txt
diff --git a/x-pack/snapshot-tool/licenses/aws-java-sdk-core-1.11.636.jar.sha1 b/x-pack/snapshot-tool/licenses/aws-java-sdk-core-1.11.636.jar.sha1
deleted file mode 100644
index b9ee9c102dbcb..0000000000000
--- a/x-pack/snapshot-tool/licenses/aws-java-sdk-core-1.11.636.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-84c9f180f8f60f6f1433c9c5253fcb704593b121
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/aws-java-sdk-s3-1.11.636.jar.sha1 b/x-pack/snapshot-tool/licenses/aws-java-sdk-s3-1.11.636.jar.sha1
deleted file mode 100644
index 1e05e98d240d2..0000000000000
--- a/x-pack/snapshot-tool/licenses/aws-java-sdk-s3-1.11.636.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-f86fc1993ac8122f6f02a8eb9b467b5f945cd76b
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/commons-codec-1.11.jar.sha1 b/x-pack/snapshot-tool/licenses/commons-codec-1.11.jar.sha1
deleted file mode 100644
index b08f71a5babf0..0000000000000
--- a/x-pack/snapshot-tool/licenses/commons-codec-1.11.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-3acb4705652e16236558f0f4f2192cc33c3bd189
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/commons-codec-LICENSE.txt b/x-pack/snapshot-tool/licenses/commons-codec-LICENSE.txt
deleted file mode 100644
index d645695673349..0000000000000
--- a/x-pack/snapshot-tool/licenses/commons-codec-LICENSE.txt
+++ /dev/null
@@ -1,202 +0,0 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/commons-codec-NOTICE.txt b/x-pack/snapshot-tool/licenses/commons-codec-NOTICE.txt
deleted file mode 100644
index 56916449bbe10..0000000000000
--- a/x-pack/snapshot-tool/licenses/commons-codec-NOTICE.txt
+++ /dev/null
@@ -1,17 +0,0 @@
-Apache Commons Codec
-Copyright 2002-2015 The Apache Software Foundation
-
-This product includes software developed at
-The Apache Software Foundation (http://www.apache.org/).
-
-src/test/org/apache/commons/codec/language/DoubleMetaphoneTest.java
-contains test data from http://aspell.net/test/orig/batch0.tab.
-Copyright (C) 2002 Kevin Atkinson (kevina@gnu.org)
-
-===============================================================================
-
-The content of package org.apache.commons.codec.language.bm has been translated
-from the original php source code available at http://stevemorse.org/phoneticinfo.htm
-with permission from the original authors.
-Original source copyright:
-Copyright (c) 2008 Alexander Beider & Stephen P. Morse.
diff --git a/x-pack/snapshot-tool/licenses/commons-logging-1.1.3.jar.sha1 b/x-pack/snapshot-tool/licenses/commons-logging-1.1.3.jar.sha1
deleted file mode 100644
index 5b8f029e58293..0000000000000
--- a/x-pack/snapshot-tool/licenses/commons-logging-1.1.3.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-f6f66e966c70a83ffbdb6f17a0919eaf7c8aca7f
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/commons-logging-LICENSE.txt b/x-pack/snapshot-tool/licenses/commons-logging-LICENSE.txt
deleted file mode 100644
index 57bc88a15a0ee..0000000000000
--- a/x-pack/snapshot-tool/licenses/commons-logging-LICENSE.txt
+++ /dev/null
@@ -1,202 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
-
diff --git a/x-pack/snapshot-tool/licenses/commons-logging-NOTICE.txt b/x-pack/snapshot-tool/licenses/commons-logging-NOTICE.txt
deleted file mode 100644
index 72eb32a902458..0000000000000
--- a/x-pack/snapshot-tool/licenses/commons-logging-NOTICE.txt
+++ /dev/null
@@ -1,5 +0,0 @@
-Apache Commons CLI
-Copyright 2001-2009 The Apache Software Foundation
-
-This product includes software developed by
-The Apache Software Foundation (http://www.apache.org/).
diff --git a/x-pack/snapshot-tool/licenses/gax-1.45.0.jar.sha1 b/x-pack/snapshot-tool/licenses/gax-1.45.0.jar.sha1
deleted file mode 100644
index 8c0cbc659aa60..0000000000000
--- a/x-pack/snapshot-tool/licenses/gax-1.45.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-2ade3e3502f9d14e3731347a82ea02372094211f
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/gax-LICENSE.txt b/x-pack/snapshot-tool/licenses/gax-LICENSE.txt
deleted file mode 100644
index 267561bb386de..0000000000000
--- a/x-pack/snapshot-tool/licenses/gax-LICENSE.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-Copyright 2016, Google Inc. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-    * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-    * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-    * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/x-pack/snapshot-tool/licenses/gax-NOTICE.txt b/x-pack/snapshot-tool/licenses/gax-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/gax-httpjson-0.62.0.jar.sha1 b/x-pack/snapshot-tool/licenses/gax-httpjson-0.62.0.jar.sha1
deleted file mode 100644
index 161ca85ccfc0c..0000000000000
--- a/x-pack/snapshot-tool/licenses/gax-httpjson-0.62.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-05a1a4736acd1c4f30304be953532be6aecdc2c9
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/gax-httpjson-LICENSE.txt b/x-pack/snapshot-tool/licenses/gax-httpjson-LICENSE.txt
deleted file mode 100644
index 267561bb386de..0000000000000
--- a/x-pack/snapshot-tool/licenses/gax-httpjson-LICENSE.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-Copyright 2016, Google Inc. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-    * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-    * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-    * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/x-pack/snapshot-tool/licenses/gax-httpjson-NOTICE.txt b/x-pack/snapshot-tool/licenses/gax-httpjson-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/google-api-client-1.28.0.jar.sha1 b/x-pack/snapshot-tool/licenses/google-api-client-1.28.0.jar.sha1
deleted file mode 100644
index c9b0efd4cdcbf..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-api-client-1.28.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-8fe155d766ed22480939e3a9db428151e0264d9e
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-api-client-LICENSE.txt b/x-pack/snapshot-tool/licenses/google-api-client-LICENSE.txt
deleted file mode 100644
index 4eedc0116add7..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-api-client-LICENSE.txt
+++ /dev/null
@@ -1,201 +0,0 @@
-Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "{}"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/google-api-client-NOTICE.txt b/x-pack/snapshot-tool/licenses/google-api-client-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/google-api-services-storage-LICENSE.txt b/x-pack/snapshot-tool/licenses/google-api-services-storage-LICENSE.txt
deleted file mode 100644
index 4eedc0116add7..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-api-services-storage-LICENSE.txt
+++ /dev/null
@@ -1,201 +0,0 @@
-Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "{}"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/google-api-services-storage-NOTICE.txt b/x-pack/snapshot-tool/licenses/google-api-services-storage-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/google-api-services-storage-v1-rev20190426-1.28.0.jar.sha1 b/x-pack/snapshot-tool/licenses/google-api-services-storage-v1-rev20190426-1.28.0.jar.sha1
deleted file mode 100644
index 84c68e6ffd528..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-api-services-storage-v1-rev20190426-1.28.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-34dd008901f382507a572f5242d0e5c5ea4ad713
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-auth-LICENSE.txt b/x-pack/snapshot-tool/licenses/google-auth-LICENSE.txt
deleted file mode 100644
index 12edf23c6711f..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-auth-LICENSE.txt
+++ /dev/null
@@ -1,28 +0,0 @@
-Copyright 2014, Google Inc. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-   * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-   * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-
-   * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/x-pack/snapshot-tool/licenses/google-auth-NOTICE.txt b/x-pack/snapshot-tool/licenses/google-auth-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/google-auth-library-credentials-0.16.1.jar.sha1 b/x-pack/snapshot-tool/licenses/google-auth-library-credentials-0.16.1.jar.sha1
deleted file mode 100644
index 6527ebec6da50..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-auth-library-credentials-0.16.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-9a15387cc0438ac3f3e625b6050cf39f4e981e13
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-auth-library-oauth2-http-0.16.1.jar.sha1 b/x-pack/snapshot-tool/licenses/google-auth-library-oauth2-http-0.16.1.jar.sha1
deleted file mode 100644
index e6467acf8f595..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-auth-library-oauth2-http-0.16.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-3407d434678faef3439a7012efa336e751ddc623
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-cloud-LICENSE.txt b/x-pack/snapshot-tool/licenses/google-cloud-LICENSE.txt
deleted file mode 100644
index 4eedc0116add7..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-cloud-LICENSE.txt
+++ /dev/null
@@ -1,201 +0,0 @@
-Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "{}"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/google-cloud-NOTICE.txt b/x-pack/snapshot-tool/licenses/google-cloud-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/google-cloud-core-1.77.0.jar.sha1 b/x-pack/snapshot-tool/licenses/google-cloud-core-1.77.0.jar.sha1
deleted file mode 100644
index d16477c5bd68f..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-cloud-core-1.77.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-7cd83a789fde368a999c1793c6297e7b4e56b2ac
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-cloud-core-http-1.77.0.jar.sha1 b/x-pack/snapshot-tool/licenses/google-cloud-core-http-1.77.0.jar.sha1
deleted file mode 100644
index 7efc3167589eb..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-cloud-core-http-1.77.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-e16acbc935a7762ba9b220860ae45c2c67d17d8c
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-cloud-storage-1.77.0.jar.sha1 b/x-pack/snapshot-tool/licenses/google-cloud-storage-1.77.0.jar.sha1
deleted file mode 100644
index de15e888520d9..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-cloud-storage-1.77.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-e368e1a8bbc0d0a4354f4e5eec076f38f6966050
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-http-LICENSE.txt b/x-pack/snapshot-tool/licenses/google-http-LICENSE.txt
deleted file mode 100644
index 980a15ac24eeb..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-http-LICENSE.txt
+++ /dev/null
@@ -1,201 +0,0 @@
-                                Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "{}"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright {yyyy} {name of copyright owner}
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/google-http-NOTICE.txt b/x-pack/snapshot-tool/licenses/google-http-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/google-http-client-1.30.1.jar.sha1 b/x-pack/snapshot-tool/licenses/google-http-client-1.30.1.jar.sha1
deleted file mode 100644
index 85323c108f99e..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-http-client-1.30.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-573aacbda8feb0d43f7056291fbce5496f42a6aa
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-http-client-appengine-1.29.2.jar.sha1 b/x-pack/snapshot-tool/licenses/google-http-client-appengine-1.29.2.jar.sha1
deleted file mode 100644
index 6973b62e9281c..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-http-client-appengine-1.29.2.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-d93f4d1d8c2496d75221e53173e4c503b7096a4d
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-http-client-jackson2-1.29.2.jar.sha1 b/x-pack/snapshot-tool/licenses/google-http-client-jackson2-1.29.2.jar.sha1
deleted file mode 100644
index 5a44d18d2aa1b..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-http-client-jackson2-1.29.2.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-d67891f5a438e1f339387a09628e0ab0af8b612a
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-oauth-client-1.28.0.jar.sha1 b/x-pack/snapshot-tool/licenses/google-oauth-client-1.28.0.jar.sha1
deleted file mode 100644
index 474df6e026570..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-oauth-client-1.28.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-9a9e5d0c33b663d6475c96ce79b2949545a113af
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/google-oauth-client-LICENSE.txt b/x-pack/snapshot-tool/licenses/google-oauth-client-LICENSE.txt
deleted file mode 100644
index 12edf23c6711f..0000000000000
--- a/x-pack/snapshot-tool/licenses/google-oauth-client-LICENSE.txt
+++ /dev/null
@@ -1,28 +0,0 @@
-Copyright 2014, Google Inc. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-   * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-   * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-
-   * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/x-pack/snapshot-tool/licenses/google-oauth-client-NOTICE.txt b/x-pack/snapshot-tool/licenses/google-oauth-client-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/grpc-context-1.12.0.jar.sha1 b/x-pack/snapshot-tool/licenses/grpc-context-1.12.0.jar.sha1
deleted file mode 100644
index 57f37a81c960f..0000000000000
--- a/x-pack/snapshot-tool/licenses/grpc-context-1.12.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-5b63a170b786051a42cce08118d5ea3c8f60f749
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/grpc-context-LICENSE.txt b/x-pack/snapshot-tool/licenses/grpc-context-LICENSE.txt
deleted file mode 100644
index d645695673349..0000000000000
--- a/x-pack/snapshot-tool/licenses/grpc-context-LICENSE.txt
+++ /dev/null
@@ -1,202 +0,0 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/grpc-context-NOTICE.txt b/x-pack/snapshot-tool/licenses/grpc-context-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/gson-2.7.jar.sha1 b/x-pack/snapshot-tool/licenses/gson-2.7.jar.sha1
deleted file mode 100644
index b3433f306eb3f..0000000000000
--- a/x-pack/snapshot-tool/licenses/gson-2.7.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-751f548c85fa49f330cecbb1875893f971b33c4e
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/gson-LICENSE.txt b/x-pack/snapshot-tool/licenses/gson-LICENSE.txt
deleted file mode 100644
index d645695673349..0000000000000
--- a/x-pack/snapshot-tool/licenses/gson-LICENSE.txt
+++ /dev/null
@@ -1,202 +0,0 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/gson-NOTICE.txt b/x-pack/snapshot-tool/licenses/gson-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/guava-26.0-jre.jar.sha1 b/x-pack/snapshot-tool/licenses/guava-26.0-jre.jar.sha1
deleted file mode 100644
index 63d05007650ce..0000000000000
--- a/x-pack/snapshot-tool/licenses/guava-26.0-jre.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-6a806eff209f36f635f943e16d97491f00f6bfab
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/guava-LICENSE.txt b/x-pack/snapshot-tool/licenses/guava-LICENSE.txt
deleted file mode 100644
index d645695673349..0000000000000
--- a/x-pack/snapshot-tool/licenses/guava-LICENSE.txt
+++ /dev/null
@@ -1,202 +0,0 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/guava-NOTICE.txt b/x-pack/snapshot-tool/licenses/guava-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/httpclient-4.5.10.jar.sha1 b/x-pack/snapshot-tool/licenses/httpclient-4.5.10.jar.sha1
deleted file mode 100644
index b708efd0dd57f..0000000000000
--- a/x-pack/snapshot-tool/licenses/httpclient-4.5.10.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-7ca2e4276f4ef95e4db725a8cd4a1d1e7585b9e5
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/httpclient-LICENSE.txt b/x-pack/snapshot-tool/licenses/httpclient-LICENSE.txt
deleted file mode 100644
index 32f01eda18fe9..0000000000000
--- a/x-pack/snapshot-tool/licenses/httpclient-LICENSE.txt
+++ /dev/null
@@ -1,558 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-=========================================================================
-
-This project includes Public Suffix List copied from
-<https://publicsuffix.org/list/effective_tld_names.dat>
-licensed under the terms of the Mozilla Public License, v. 2.0
-
-Full license text: <http://mozilla.org/MPL/2.0/>
-
-Mozilla Public License Version 2.0
-==================================
-
-1. Definitions
---------------
-
-1.1. "Contributor"
-    means each individual or legal entity that creates, contributes to
-    the creation of, or owns Covered Software.
-
-1.2. "Contributor Version"
-    means the combination of the Contributions of others (if any) used
-    by a Contributor and that particular Contributor's Contribution.
-
-1.3. "Contribution"
-    means Covered Software of a particular Contributor.
-
-1.4. "Covered Software"
-    means Source Code Form to which the initial Contributor has attached
-    the notice in Exhibit A, the Executable Form of such Source Code
-    Form, and Modifications of such Source Code Form, in each case
-    including portions thereof.
-
-1.5. "Incompatible With Secondary Licenses"
-    means
-
-    (a) that the initial Contributor has attached the notice described
-        in Exhibit B to the Covered Software; or
-
-    (b) that the Covered Software was made available under the terms of
-        version 1.1 or earlier of the License, but not also under the
-        terms of a Secondary License.
-
-1.6. "Executable Form"
-    means any form of the work other than Source Code Form.
-
-1.7. "Larger Work"
-    means a work that combines Covered Software with other material, in
-    a separate file or files, that is not Covered Software.
-
-1.8. "License"
-    means this document.
-
-1.9. "Licensable"
-    means having the right to grant, to the maximum extent possible,
-    whether at the time of the initial grant or subsequently, any and
-    all of the rights conveyed by this License.
-
-1.10. "Modifications"
-    means any of the following:
-
-    (a) any file in Source Code Form that results from an addition to,
-        deletion from, or modification of the contents of Covered
-        Software; or
-
-    (b) any new file in Source Code Form that contains any Covered
-        Software.
-
-1.11. "Patent Claims" of a Contributor
-    means any patent claim(s), including without limitation, method,
-    process, and apparatus claims, in any patent Licensable by such
-    Contributor that would be infringed, but for the grant of the
-    License, by the making, using, selling, offering for sale, having
-    made, import, or transfer of either its Contributions or its
-    Contributor Version.
-
-1.12. "Secondary License"
-    means either the GNU General Public License, Version 2.0, the GNU
-    Lesser General Public License, Version 2.1, the GNU Affero General
-    Public License, Version 3.0, or any later versions of those
-    licenses.
-
-1.13. "Source Code Form"
-    means the form of the work preferred for making modifications.
-
-1.14. "You" (or "Your")
-    means an individual or a legal entity exercising rights under this
-    License. For legal entities, "You" includes any entity that
-    controls, is controlled by, or is under common control with You. For
-    purposes of this definition, "control" means (a) the power, direct
-    or indirect, to cause the direction or management of such entity,
-    whether by contract or otherwise, or (b) ownership of more than
-    fifty percent (50%) of the outstanding shares or beneficial
-    ownership of such entity.
-
-2. License Grants and Conditions
---------------------------------
-
-2.1. Grants
-
-Each Contributor hereby grants You a world-wide, royalty-free,
-non-exclusive license:
-
-(a) under intellectual property rights (other than patent or trademark)
-    Licensable by such Contributor to use, reproduce, make available,
-    modify, display, perform, distribute, and otherwise exploit its
-    Contributions, either on an unmodified basis, with Modifications, or
-    as part of a Larger Work; and
-
-(b) under Patent Claims of such Contributor to make, use, sell, offer
-    for sale, have made, import, and otherwise transfer either its
-    Contributions or its Contributor Version.
-
-2.2. Effective Date
-
-The licenses granted in Section 2.1 with respect to any Contribution
-become effective for each Contribution on the date the Contributor first
-distributes such Contribution.
-
-2.3. Limitations on Grant Scope
-
-The licenses granted in this Section 2 are the only rights granted under
-this License. No additional rights or licenses will be implied from the
-distribution or licensing of Covered Software under this License.
-Notwithstanding Section 2.1(b) above, no patent license is granted by a
-Contributor:
-
-(a) for any code that a Contributor has removed from Covered Software;
-    or
-
-(b) for infringements caused by: (i) Your and any other third party's
-    modifications of Covered Software, or (ii) the combination of its
-    Contributions with other software (except as part of its Contributor
-    Version); or
-
-(c) under Patent Claims infringed by Covered Software in the absence of
-    its Contributions.
-
-This License does not grant any rights in the trademarks, service marks,
-or logos of any Contributor (except as may be necessary to comply with
-the notice requirements in Section 3.4).
-
-2.4. Subsequent Licenses
-
-No Contributor makes additional grants as a result of Your choice to
-distribute the Covered Software under a subsequent version of this
-License (see Section 10.2) or under the terms of a Secondary License (if
-permitted under the terms of Section 3.3).
-
-2.5. Representation
-
-Each Contributor represents that the Contributor believes its
-Contributions are its original creation(s) or it has sufficient rights
-to grant the rights to its Contributions conveyed by this License.
-
-2.6. Fair Use
-
-This License is not intended to limit any rights You have under
-applicable copyright doctrines of fair use, fair dealing, or other
-equivalents.
-
-2.7. Conditions
-
-Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
-in Section 2.1.
-
-3. Responsibilities
--------------------
-
-3.1. Distribution of Source Form
-
-All distribution of Covered Software in Source Code Form, including any
-Modifications that You create or to which You contribute, must be under
-the terms of this License. You must inform recipients that the Source
-Code Form of the Covered Software is governed by the terms of this
-License, and how they can obtain a copy of this License. You may not
-attempt to alter or restrict the recipients' rights in the Source Code
-Form.
-
-3.2. Distribution of Executable Form
-
-If You distribute Covered Software in Executable Form then:
-
-(a) such Covered Software must also be made available in Source Code
-    Form, as described in Section 3.1, and You must inform recipients of
-    the Executable Form how they can obtain a copy of such Source Code
-    Form by reasonable means in a timely manner, at a charge no more
-    than the cost of distribution to the recipient; and
-
-(b) You may distribute such Executable Form under the terms of this
-    License, or sublicense it under different terms, provided that the
-    license for the Executable Form does not attempt to limit or alter
-    the recipients' rights in the Source Code Form under this License.
-
-3.3. Distribution of a Larger Work
-
-You may create and distribute a Larger Work under terms of Your choice,
-provided that You also comply with the requirements of this License for
-the Covered Software. If the Larger Work is a combination of Covered
-Software with a work governed by one or more Secondary Licenses, and the
-Covered Software is not Incompatible With Secondary Licenses, this
-License permits You to additionally distribute such Covered Software
-under the terms of such Secondary License(s), so that the recipient of
-the Larger Work may, at their option, further distribute the Covered
-Software under the terms of either this License or such Secondary
-License(s).
-
-3.4. Notices
-
-You may not remove or alter the substance of any license notices
-(including copyright notices, patent notices, disclaimers of warranty,
-or limitations of liability) contained within the Source Code Form of
-the Covered Software, except that You may alter any license notices to
-the extent required to remedy known factual inaccuracies.
-
-3.5. Application of Additional Terms
-
-You may choose to offer, and to charge a fee for, warranty, support,
-indemnity or liability obligations to one or more recipients of Covered
-Software. However, You may do so only on Your own behalf, and not on
-behalf of any Contributor. You must make it absolutely clear that any
-such warranty, support, indemnity, or liability obligation is offered by
-You alone, and You hereby agree to indemnify every Contributor for any
-liability incurred by such Contributor as a result of warranty, support,
-indemnity or liability terms You offer. You may include additional
-disclaimers of warranty and limitations of liability specific to any
-jurisdiction.
-
-4. Inability to Comply Due to Statute or Regulation
----------------------------------------------------
-
-If it is impossible for You to comply with any of the terms of this
-License with respect to some or all of the Covered Software due to
-statute, judicial order, or regulation then You must: (a) comply with
-the terms of this License to the maximum extent possible; and (b)
-describe the limitations and the code they affect. Such description must
-be placed in a text file included with all distributions of the Covered
-Software under this License. Except to the extent prohibited by statute
-or regulation, such description must be sufficiently detailed for a
-recipient of ordinary skill to be able to understand it.
-
-5. Termination
---------------
-
-5.1. The rights granted under this License will terminate automatically
-if You fail to comply with any of its terms. However, if You become
-compliant, then the rights granted under this License from a particular
-Contributor are reinstated (a) provisionally, unless and until such
-Contributor explicitly and finally terminates Your grants, and (b) on an
-ongoing basis, if such Contributor fails to notify You of the
-non-compliance by some reasonable means prior to 60 days after You have
-come back into compliance. Moreover, Your grants from a particular
-Contributor are reinstated on an ongoing basis if such Contributor
-notifies You of the non-compliance by some reasonable means, this is the
-first time You have received notice of non-compliance with this License
-from such Contributor, and You become compliant prior to 30 days after
-Your receipt of the notice.
-
-5.2. If You initiate litigation against any entity by asserting a patent
-infringement claim (excluding declaratory judgment actions,
-counter-claims, and cross-claims) alleging that a Contributor Version
-directly or indirectly infringes any patent, then the rights granted to
-You by any and all Contributors for the Covered Software under Section
-2.1 of this License shall terminate.
-
-5.3. In the event of termination under Sections 5.1 or 5.2 above, all
-end user license agreements (excluding distributors and resellers) which
-have been validly granted by You or Your distributors under this License
-prior to termination shall survive termination.
-
-************************************************************************
-*                                                                      *
-*  6. Disclaimer of Warranty                                           *
-*  -------------------------                                           *
-*                                                                      *
-*  Covered Software is provided under this License on an "as is"       *
-*  basis, without warranty of any kind, either expressed, implied, or  *
-*  statutory, including, without limitation, warranties that the       *
-*  Covered Software is free of defects, merchantable, fit for a        *
-*  particular purpose or non-infringing. The entire risk as to the     *
-*  quality and performance of the Covered Software is with You.        *
-*  Should any Covered Software prove defective in any respect, You     *
-*  (not any Contributor) assume the cost of any necessary servicing,   *
-*  repair, or correction. This disclaimer of warranty constitutes an   *
-*  essential part of this License. No use of any Covered Software is   *
-*  authorized under this License except under this disclaimer.         *
-*                                                                      *
-************************************************************************
-
-************************************************************************
-*                                                                      *
-*  7. Limitation of Liability                                          *
-*  --------------------------                                          *
-*                                                                      *
-*  Under no circumstances and under no legal theory, whether tort      *
-*  (including negligence), contract, or otherwise, shall any           *
-*  Contributor, or anyone who distributes Covered Software as          *
-*  permitted above, be liable to You for any direct, indirect,         *
-*  special, incidental, or consequential damages of any character      *
-*  including, without limitation, damages for lost profits, loss of    *
-*  goodwill, work stoppage, computer failure or malfunction, or any    *
-*  and all other commercial damages or losses, even if such party      *
-*  shall have been informed of the possibility of such damages. This   *
-*  limitation of liability shall not apply to liability for death or   *
-*  personal injury resulting from such party's negligence to the       *
-*  extent applicable law prohibits such limitation. Some               *
-*  jurisdictions do not allow the exclusion or limitation of           *
-*  incidental or consequential damages, so this exclusion and          *
-*  limitation may not apply to You.                                    *
-*                                                                      *
-************************************************************************
-
-8. Litigation
--------------
-
-Any litigation relating to this License may be brought only in the
-courts of a jurisdiction where the defendant maintains its principal
-place of business and such litigation shall be governed by laws of that
-jurisdiction, without reference to its conflict-of-law provisions.
-Nothing in this Section shall prevent a party's ability to bring
-cross-claims or counter-claims.
-
-9. Miscellaneous
-----------------
-
-This License represents the complete agreement concerning the subject
-matter hereof. If any provision of this License is held to be
-unenforceable, such provision shall be reformed only to the extent
-necessary to make it enforceable. Any law or regulation which provides
-that the language of a contract shall be construed against the drafter
-shall not be used to construe this License against a Contributor.
-
-10. Versions of the License
----------------------------
-
-10.1. New Versions
-
-Mozilla Foundation is the license steward. Except as provided in Section
-10.3, no one other than the license steward has the right to modify or
-publish new versions of this License. Each version will be given a
-distinguishing version number.
-
-10.2. Effect of New Versions
-
-You may distribute the Covered Software under the terms of the version
-of the License under which You originally received the Covered Software,
-or under the terms of any subsequent version published by the license
-steward.
-
-10.3. Modified Versions
-
-If you create software not governed by this License, and you want to
-create a new license for such software, you may create and use a
-modified version of this License if you rename the license and remove
-any references to the name of the license steward (except to note that
-such modified license differs from this License).
-
-10.4. Distributing Source Code Form that is Incompatible With Secondary
-Licenses
-
-If You choose to distribute Source Code Form that is Incompatible With
-Secondary Licenses under the terms of this version of the License, the
-notice described in Exhibit B of this License must be attached.
-
-Exhibit A - Source Code Form License Notice
--------------------------------------------
-
-  This Source Code Form is subject to the terms of the Mozilla Public
-  License, v. 2.0. If a copy of the MPL was not distributed with this
-  file, You can obtain one at http://mozilla.org/MPL/2.0/.
-
-If it is not possible or desirable to put the notice in a particular
-file, then You may include the notice in a location (such as a LICENSE
-file in a relevant directory) where a recipient would be likely to look
-for such a notice.
-
-You may add additional accurate notices of copyright ownership.
-
-Exhibit B - "Incompatible With Secondary Licenses" Notice
----------------------------------------------------------
-
-  This Source Code Form is "Incompatible With Secondary Licenses", as
-  defined by the Mozilla Public License, v. 2.0.
diff --git a/x-pack/snapshot-tool/licenses/httpclient-NOTICE.txt b/x-pack/snapshot-tool/licenses/httpclient-NOTICE.txt
deleted file mode 100644
index 4f6058178b201..0000000000000
--- a/x-pack/snapshot-tool/licenses/httpclient-NOTICE.txt
+++ /dev/null
@@ -1,5 +0,0 @@
-Apache HttpComponents Client
-Copyright 1999-2015 The Apache Software Foundation
-
-This product includes software developed at
-The Apache Software Foundation (http://www.apache.org/).
diff --git a/x-pack/snapshot-tool/licenses/httpcore-4.4.12.jar.sha1 b/x-pack/snapshot-tool/licenses/httpcore-4.4.12.jar.sha1
deleted file mode 100644
index 3c046171b30da..0000000000000
--- a/x-pack/snapshot-tool/licenses/httpcore-4.4.12.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-21ebaf6d532bc350ba95bd81938fa5f0e511c132
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/jackson-LICENSE b/x-pack/snapshot-tool/licenses/jackson-LICENSE
deleted file mode 100644
index f5f45d26a49d6..0000000000000
--- a/x-pack/snapshot-tool/licenses/jackson-LICENSE
+++ /dev/null
@@ -1,8 +0,0 @@
-This copy of Jackson JSON processor streaming parser/generator is licensed under the
-Apache (Software) License, version 2.0 ("the License").
-See the License for details about distribution rights, and the
-specific rights regarding derivate works.
-
-You may obtain a copy of the License at:
-
-http://www.apache.org/licenses/LICENSE-2.0
diff --git a/x-pack/snapshot-tool/licenses/jackson-NOTICE b/x-pack/snapshot-tool/licenses/jackson-NOTICE
deleted file mode 100644
index 4c976b7b4cc58..0000000000000
--- a/x-pack/snapshot-tool/licenses/jackson-NOTICE
+++ /dev/null
@@ -1,20 +0,0 @@
-# Jackson JSON processor
-
-Jackson is a high-performance, Free/Open Source JSON processing library.
-It was originally written by Tatu Saloranta (tatu.saloranta@iki.fi), and has
-been in development since 2007.
-It is currently developed by a community of developers, as well as supported
-commercially by FasterXML.com.
-
-## Licensing
-
-Jackson core and extension components may licensed under different licenses.
-To find the details that apply to this artifact see the accompanying LICENSE file.
-For more information, including possible other licensing options, contact
-FasterXML.com (http://fasterxml.com).
-
-## Credits
-
-A list of contributors may be found from CREDITS file, which is included
-in some artifacts (usually source distributions); but is always available
-from the source code management (SCM) system project uses.
diff --git a/x-pack/snapshot-tool/licenses/jackson-annotations-2.8.11.jar.sha1 b/x-pack/snapshot-tool/licenses/jackson-annotations-2.8.11.jar.sha1
deleted file mode 100644
index 30e7d1a7b1a74..0000000000000
--- a/x-pack/snapshot-tool/licenses/jackson-annotations-2.8.11.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-391de20b4e29cb3fb07d2454ace64be2c82ac91f
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/jackson-core-2.8.11.jar.sha1 b/x-pack/snapshot-tool/licenses/jackson-core-2.8.11.jar.sha1
deleted file mode 100644
index e7ad1e74ed6b8..0000000000000
--- a/x-pack/snapshot-tool/licenses/jackson-core-2.8.11.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-876ead1db19f0c9e79c9789273a3ef8c6fd6c29b
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1 b/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1
deleted file mode 100644
index 5203969bcf5c0..0000000000000
--- a/x-pack/snapshot-tool/licenses/jackson-databind-2.8.11.4.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-596d6923ff4cf7ea72ded3ac32903b9c618ce9f1
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/jaxb-LICENSE.txt b/x-pack/snapshot-tool/licenses/jaxb-LICENSE.txt
deleted file mode 100644
index a3e62b0878766..0000000000000
--- a/x-pack/snapshot-tool/licenses/jaxb-LICENSE.txt
+++ /dev/null
@@ -1,705 +0,0 @@
-COMMON DEVELOPMENT AND DISTRIBUTION LICENSE (CDDL) Version 1.0
-
-1. Definitions.
-
-   1.1. Contributor. means each individual or  entity  that  creates  or
-contributes to the creation of Modifications.
-
-   1.2. Contributor Version.  means  the  combination  of  the  Original
-Software,  prior  Modifications  used by a Contributor (if any), and the
-Modifications made by that particular Contributor.
-
-   1.3. Covered Software.  means  (a)  the  Original  Software,  or  (b)
-Modifications,  or  (c)  the  combination  of  files containing Original
-Software with files containing Modifications,  in  each  case  including
-portions thereof.
-
-   1.4. Executable. means the Covered Software in any  form  other  than
-Source Code.
-
-   1.5. Initial Developer. means the individual  or  entity  that  first
-makes Original Software available under this License.
-
-   1.6. Larger Work. means a work which  combines  Covered  Software  or
-portions thereof with code not governed by the terms of this License.
-
-   1.7. License. means this document.
-
-   1.8. Licensable. means having the right  to  grant,  to  the  maximum
-extent   possible,   whether  at  the  time  of  the  initial  grant  or
-subsequently acquired, any and all of the rights conveyed herein.
-
-   1.9. Modifications. means the Source Code and Executable form of  any
-of the following:
-
-        A. Any file that results from an addition to, deletion  from  or
-modification  of  the contents of a file containing Original Software or
-previous Modifications;
-
-        B. Any new file that contains any part of the Original  Software
-or previous Modification; or
-
-        C. Any new file that is contributed or otherwise made  available
-under the terms of this License.
-
-   1.10. Original Software. means the Source Code and Executable form of
-computer software code that is originally released under this License.
-
-   1.11.  Patent  Claims.  means  any  patent  claim(s),  now  owned  or
-hereafter  acquired,  including without limitation, method, process, and
-apparatus claims, in any patent Licensable by grantor.
-
-   1.12. Source Code. means (a) the common  form  of  computer  software
-code  in  which  modifications are made and (b) associated documentation
-included in or with such code.
-
-   1.13. You.  (or  .Your.)  means  an  individual  or  a  legal  entity
-exercising  rights  under,  and complying with all of the terms of, this
-License. For legal entities, .You. includes any entity  which  controls,
-is  controlled  by, or is under common control with You. For purposes of
-this definition, .control. means (a) the power, direct or  indirect,  to
-cause the direction or management of such entity, whether by contract or
-otherwise,  or  (b)  ownership  of  more than fifty percent (50%) of the
-outstanding shares or beneficial ownership of such entity.
-
-2. License Grants.
-
-      2.1. The Initial Developer Grant.
-
-      Conditioned upon  Your  compliance  with  Section  3.1  below  and
-subject  to  third  party  intellectual  property  claims,  the  Initial
-Developer hereby grants You a  world-wide,  royalty-free,  non-exclusive
-license:
-
-         (a) under intellectual property rights (other  than  patent  or
-trademark)  Licensable  by Initial Developer, to use, reproduce, modify,
-display, perform, sublicense and distribute the  Original  Software  (or
-portions  thereof),  with  or without Modifications, and/or as part of a
-Larger Work; and
-
-         (b) under Patent Claims  infringed  by  the  making,  using  or
-selling  of  Original Software, to make, have made, use, practice, sell,
-and offer for sale, and/or otherwise dispose of  the  Original  Software
-(or portions thereof).
-
-        (c)  The  licenses  granted  in  Sections  2.1(a)  and  (b)  are
-effective  on  the date Initial Developer first distributes or otherwise
-makes the Original Software available to a third party under  the  terms
-of this License.
-
-        (d) Notwithstanding Section 2.1(b) above, no patent  license  is
-granted: (1) for code that You delete from the Original Software, or (2)
-for  infringements  caused  by:  (i)  the  modification  of the Original
-Software, or (ii) the combination of the Original  Software  with  other
-software or devices.
-
-    2.2. Contributor Grant.
-
-    Conditioned upon Your compliance with Section 3.1 below and  subject
-to  third  party  intellectual  property claims, each Contributor hereby
-grants You a world-wide, royalty-free, non-exclusive license:
-
-        (a) under intellectual property rights  (other  than  patent  or
-trademark) Licensable by Contributor to use, reproduce, modify, display,
-perform,  sublicense  and  distribute  the Modifications created by such
-Contributor (or portions thereof), either on an unmodified  basis,  with
-other Modifications, as Covered Software and/or as part of a Larger Work;
-and
-
-        (b) under Patent Claims  infringed  by  the  making,  using,  or
-selling of Modifications made by that Contributor either alone and/or in
-combination   with   its   Contributor  Version  (or  portions  of  such
-combination), to make, use, sell, offer  for  sale,  have  made,  and/or
-otherwise  dispose  of:  (1)  Modifications made by that Contributor (or
-portions thereof); and (2) the combination of Modifications made by that
-Contributor  with  its  Contributor  Version  (or   portions   of   such
-combination).
-
-        (c) The licenses granted  in  Sections  2.2(a)  and  2.2(b)  are
-effective  on  the date Contributor first distributes or otherwise makes
-the Modifications available to a third party.
-
-        (d) Notwithstanding Section 2.2(b) above, no patent  license  is
-granted:  (1)  for  any  code  that  Contributor  has  deleted  from the
-Contributor Version; (2) for infringements caused by:  (i)  third  party
-modifications  of  Contributor  Version,  or  (ii)  the  combination  of
-Modifications made by that Contributor with other  software  (except  as
-part  of  the Contributor Version) or other devices; or (3) under Patent
-Claims infringed by Covered Software in  the  absence  of  Modifications
-made by that Contributor.
-
-3. Distribution Obligations.
-
-      3.1. Availability of Source Code.
-      Any  Covered  Software  that  You  distribute  or  otherwise  make
-available  in Executable form must also be made available in Source Code
-form and that Source Code form must be distributed only under the  terms
-of this License. You must include a copy of this License with every copy
-of  the  Source  Code  form  of  the  Covered Software You distribute or
-otherwise make available. You must inform recipients of any such Covered
-Software in Executable form as to  how  they  can  obtain  such  Covered
-Software  in  Source  Code  form  in a reasonable manner on or through a
-medium customarily used for software exchange.
-
-      3.2. Modifications.
-      The Modifications that You create or to which You  contribute  are
-governed  by  the  terms of this License. You represent that You believe
-Your  Modifications  are  Your  original  creation(s)  and/or  You  have
-sufficient rights to grant the rights conveyed by this License.
-
-      3.3. Required Notices.
-      You must include a notice  in  each  of  Your  Modifications  that
-identifies  You  as  the  Contributor  of  the Modification. You may not
-remove or alter any copyright, patent  or  trademark  notices  contained
-within  the  Covered  Software,  or  any  notices  of  licensing  or any
-descriptive text giving attribution to any Contributor  or  the  Initial
-Developer.
-
-      3.4. Application of Additional Terms.
-      You may not offer or impose any terms on any Covered  Software  in
-Source Code form that alters or restricts the applicable version of this
-License  or  the  recipients. rights hereunder. You may choose to offer,
-and to charge a fee  for,  warranty,  support,  indemnity  or  liability
-obligations  to one or more recipients of Covered Software. However, you
-may do so only on Your own behalf, and not  on  behalf  of  the  Initial
-Developer or any Contributor. You must make it absolutely clear that any
-such  warranty, support, indemnity or liability obligation is offered by
-You alone, and You hereby agree to indemnify the Initial  Developer  and
-every Contributor for any liability incurred by the Initial Developer or
-such  Contributor  as  a  result  of  warranty,  support,  indemnity  or
-liability terms You offer.
-
-      3.5. Distribution of Executable Versions.
-      You may distribute the Executable form  of  the  Covered  Software
-under  the terms of this License or under the terms of a license of Your
-choice, which may contain terms different from  this  License,  provided
-that  You  are in compliance with the terms of this License and that the
-license for the Executable form does not attempt to limit or  alter  the
-recipient.s  rights in the Source Code form from the rights set forth in
-this License. If You distribute the Covered Software in Executable  form
-under  a  different  license, You must make it absolutely clear that any
-terms which differ from this License are offered by You  alone,  not  by
-the  Initial Developer or Contributor. You hereby agree to indemnify the
-Initial Developer and every Contributor for any  liability  incurred  by
-the  Initial Developer or such Contributor as a result of any such terms
-You offer.
-
-      3.6. Larger Works.
-      You may create a Larger Work by combining  Covered  Software  with
-other  code not governed by the terms of this License and distribute the
-Larger Work as a single product. In such a case, You must make sure  the
-requirements of this License are fulfilled for the Covered Software.
-
-4. Versions of the License.
-
-      4.1. New Versions.
-      Sun Microsystems, Inc. is the  initial  license  steward  and  may
-publish  revised  and/or new versions of this License from time to time.
-Each version will be given a distinguishing version  number.  Except  as
-provided  in  Section 4.3, no one other than the license steward has the
-right to modify this License.
-
-      4.2. Effect of New Versions.
-      You may always continue to use, distribute or otherwise  make  the
-Covered Software available under the terms of the version of the License
-under which You originally received the Covered Software. If the Initial
-Developer includes a notice in the Original Software prohibiting it from
-being  distributed  or  otherwise  made  available  under any subsequent
-version of the  License,  You  must  distribute  and  make  the  Covered
-Software  available  under the terms of the version of the License under
-which You originally received the Covered Software. Otherwise,  You  may
-also  choose  to  use, distribute or otherwise make the Covered Software
-available under the terms of  any  subsequent  version  of  the  License
-published by the license steward.
-
-      4.3. Modified Versions.
-      When You are an Initial Developer and You want  to  create  a  new
-license  for  Your  Original Software, You may create and use a modified
-version of this License if You: (a) rename the license  and  remove  any
-references  to  the name of the license steward (except to note that the
-license differs from this License); and (b) otherwise make it clear that
-the license contains terms which differ from this License.
-
-5. DISCLAIMER OF WARRANTY.
-
-   COVERED SOFTWARE IS PROVIDED UNDER THIS LICENSE ON AN .AS IS.  BASIS,
-WITHOUT  WARRANTY  OF  ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
-WITHOUT LIMITATION, WARRANTIES THAT THE  COVERED  SOFTWARE  IS  FREE  OF
-DEFECTS,  MERCHANTABLE,  FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING.
-THE ENTIRE RISK AS  TO  THE  QUALITY  AND  PERFORMANCE  OF  THE  COVERED
-SOFTWARE IS WITH YOU. SHOULD ANY COVERED SOFTWARE PROVE DEFECTIVE IN ANY
-RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR) ASSUME
-THE  COST  OF  ANY  NECESSARY  SERVICING,  REPAIR  OR  CORRECTION.  THIS
-DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO
-USE OF ANY COVERED SOFTWARE IS AUTHORIZED HEREUNDER  EXCEPT  UNDER  THIS
-DISCLAIMER.
-
-6. TERMINATION.
-
-      6.1. This License and the rights granted hereunder will  terminate
-automatically  if  You fail to comply with terms herein and fail to cure
-such breach within 30 days of becoming aware of the  breach.  Provisions
-which,  by their nature, must remain in effect beyond the termination of
-this License shall survive.
-
-      6.2.  If  You  assert  a  patent  infringement  claim   (excluding
-declaratory judgment actions) against Initial Developer or a Contributor
-(the Initial Developer or Contributor against whom You assert such claim
-is  referred to as .Participant.) alleging that the Participant Software
-(meaning the Contributor Version where the Participant is a  Contributor
-or the Original Software where the Participant is the Initial Developer)
-directly  or  indirectly  infringes  any patent, then any and all rights
-granted directly or indirectly to You by such Participant,  the  Initial
-Developer  (if  the  Initial  Developer  is not the Participant) and all
-Contributors under Sections 2.1 and/or 2.2 of this License  shall,  upon
-60   days   notice   from   Participant   terminate   prospectively  and
-automatically at the expiration of such 60 day notice period, unless  if
-within  such  60  day period You withdraw Your claim with respect to the
-Participant Software against such  Participant  either  unilaterally  or
-pursuant to a written agreement with Participant.
-
-      6.3. In the event of termination under Sections 6.1 or 6.2  above,
-all  end  user  licenses  that  have  been validly granted by You or any
-distributor hereunder prior to termination (excluding  licenses  granted
-to You by any distributor) shall survive termination.
-
-7. LIMITATION OF LIABILITY.
-
-   UNDER NO CIRCUMSTANCES  AND  UNDER  NO  LEGAL  THEORY,  WHETHER  TORT
-(INCLUDING  NEGLIGENCE),  CONTRACT, OR OTHERWISE, SHALL YOU, THE INITIAL
-DEVELOPER, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF COVERED SOFTWARE,
-OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR  ANY
-INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER
-INCLUDING,  WITHOUT  LIMITATION,  DAMAGES  FOR  LOST  PROFITS,  LOSS  OF
-GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL
-OTHER COMMERCIAL DAMAGES OR LOSSES, EVEN IF SUCH PARTY SHALL  HAVE  BEEN
-INFORMED  OF  THE  POSSIBILITY  OF  SUCH  DAMAGES.  THIS  LIMITATION  OF
-LIABILITY SHALL NOT APPLY TO LIABILITY  FOR  DEATH  OR  PERSONAL  INJURY
-RESULTING  FROM  SUCH  PARTY.S  NEGLIGENCE  TO THE EXTENT APPLICABLE LAW
-PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION
-OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS  EXCLUSION
-AND LIMITATION MAY NOT APPLY TO YOU.
-
-8. U.S. GOVERNMENT END USERS.
-
-   The Covered Software is a .commercial item,. as that term is  defined
-in  48  C.F.R.  2.101  (Oct.  1995),  consisting of .commercial computer
-software. (as that term is defined at 48  C.F.R.  º  252.227-7014(a)(1))
-and  .commercial computer software documentation. as such terms are used
-in 48 C.F.R. 12.212 (Sept. 1995). Consistent with 48 C.F.R.  12.212  and
-48 C.F.R. 227.7202-1 through 227.7202-4 (June 1995), all U.S. Government
-End  Users  acquire  Covered  Software  with only those rights set forth
-herein. This U.S. Government Rights clause is in lieu of, and supersedes,
-any other FAR,  DFAR,  or  other  clause  or  provision  that  addresses
-Government rights in computer software under this License.
-
-9. MISCELLANEOUS.
-
-   This License represents the  complete  agreement  concerning  subject
-matter  hereof.  If  any  provision  of  this  License  is  held  to  be
-unenforceable, such provision shall  be  reformed  only  to  the  extent
-necessary  to make it enforceable. This License shall be governed by the
-law of the jurisdiction specified  in  a  notice  contained  within  the
-Original Software (except to the extent applicable law, if any, provides
-otherwise),  excluding  such  jurisdiction.s conflict-of-law provisions.
-Any litigation  relating  to  this  License  shall  be  subject  to  the
-jurisdiction  of  the  courts  located  in  the  jurisdiction  and venue
-specified in a notice contained within the Original Software,  with  the
-losing party responsible for costs, including, without limitation, court
-costs  and  reasonable  attorneys. fees and expenses. The application of
-the United Nations Convention on Contracts for the International Sale of
-Goods is expressly excluded. Any law or regulation which  provides  that
-the  language of a contract shall be construed against the drafter shall
-not apply to this License. You agree that You alone are responsible  for
-compliance with the United States export administration regulations (and
-the  export control laws and regulation of any other countries) when You
-use, distribute or otherwise make available any Covered Software.
-
-10. RESPONSIBILITY FOR CLAIMS.
-
-   As between Initial Developer and  the  Contributors,  each  party  is
-responsible  for claims and damages arising, directly or indirectly, out
-of its utilization of rights under this License and You  agree  to  work
-with   Initial   Developer   and   Contributors   to   distribute   such
-responsibility on an equitable basis.  Nothing  herein  is  intended  or
-shall be deemed to constitute any admission of liability.
-
-   NOTICE  PURSUANT  TO  SECTION  9  OF  THE  COMMON   DEVELOPMENT   AND
-DISTRIBUTION LICENSE (CDDL)
-
-   The code released under the CDDL shall be governed by the laws of the
-State  of  California  (excluding   conflict-of-law   provisions).   Any
-litigation relating to this License shall be subject to the jurisdiction
-of  the  Federal  Courts  of the Northern District of California and the
-state courts of the State of California, with venue lying in Santa Clara
-County, California.
-
-
-The GNU General Public License (GPL) Version 2, June 1991
-
-
-Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place,
-Suite 330, Boston, MA 02111-1307 USA
-
-Everyone is permitted to copy and distribute  verbatim  copies  of  this
-license document, but changing it is not allowed.
-
-Preamble
-
-The licenses for most software are designed to take away your freedom to
-share and change it. By contrast, the  GNU  General  Public  License  is
-intended to guarantee your freedom to share and change free software--to
-make  sure  the  software is free for all its users. This General Public
-License applies to most of the Free Software Foundation's  software  and
-to  any other program whose authors commit to using it. (Some other Free
-Software Foundation software is  covered  by  the  GNU  Library  General
-Public License instead.) You can apply it to your programs, too.
-
-When we speak of free software, we are referring to freedom, not  price.
-Our  General Public Licenses are designed to make sure that you have the
-freedom to distribute copies of  free  software  (and  charge  for  this
-service  if you wish), that you receive source code or can get it if you
-want it, that you can change the software or use pieces  of  it  in  new
-free programs; and that you know you can do these things.
-
-To protect your rights, we need to make restrictions that forbid  anyone
-to  deny  you  these rights or to ask you to surrender the rights. These
-restrictions translate  to  certain  responsibilities  for  you  if  you
-distribute copies of the software, or if you modify it.
-
-For example, if you distribute copies of such a program, whether  gratis
-or for a fee, you must give the recipients all the rights that you have.
-You  must  make sure that they, too, receive or can get the source code.
-And you must show them these terms so they know their rights.
-
-We protect your rights with two steps: (1) copyright the  software,  and
-(2)  offer  you  this  license which gives you legal permission to copy,
-distribute and/or modify the software.
-
-Also, for each author's protection and ours, we  want  to  make  certain
-that  everyone  understands  that  there  is  no  warranty for this free
-software. If the software is modified by someone else and passed on,  we
-want  its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the  original
-authors' reputations.
-
-Finally, any free program is threatened constantly by software  patents.
-We  wish  to avoid the danger that redistributors of a free program will
-individually obtain  patent  licenses,  in  effect  making  the  program
-proprietary. To prevent this, we have made it clear that any patent must
-be licensed for everyone's free use or not licensed at all.
-
-The  precise  terms  and  conditions  for  copying,   distribution   and
-modification follow.
-
-
-TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-0. This License applies to any program or other work  which  contains  a
-notice placed by the copyright holder saying it may be distributed under
-the  terms  of this General Public License. The "Program", below, refers
-to any such program or work, and a "work based  on  the  Program"  means
-either  the  Program or any derivative work under copyright law: that is
-to say, a work containing  the  Program  or  a  portion  of  it,  either
-verbatim  or with modifications and/or translated into another language.
-(Hereinafter, translation is included without  limitation  in  the  term
-"modification".) Each licensee is addressed as "you".
-
-Activities other than copying, distribution  and  modification  are  not
-covered  by this License; they are outside its scope. The act of running
-the Program is not restricted,  and  the  output  from  the  Program  is
-covered  only  if  its  contents  constitute a work based on the Program
-(independent of having been made by running the Program).  Whether  that
-is true depends on what the Program does.
-
-1. You may copy and distribute verbatim copies of the  Program's  source
-code  as  you receive it, in any medium, provided that you conspicuously
-and appropriately publish on each copy an appropriate  copyright  notice
-and  disclaimer  of  warranty; keep intact all the notices that refer to
-this License and to the absence of any  warranty;  and  give  any  other
-recipients of the Program a copy of this License along with the Program.
-
-You may charge a fee for the physical act of transferring  a  copy,  and
-you may at your option offer warranty protection in exchange for a fee.
-
-2. You may modify your copy or copies of the Program or any  portion  of
-it,  thus  forming  a work based on the Program, and copy and distribute
-such modifications or work under the terms of Section 1 above,  provided
-that you also meet all of these conditions:
-
-   a) You must cause the  modified  files  to  carry  prominent  notices
-stating that you changed the files and the date of any change.
-
-   b) You must cause any work that you distribute or  publish,  that  in
-whole  or  in  part  contains or is derived from the Program or any part
-thereof, to be licensed as a whole at no charge  to  all  third  parties
-under the terms of this License.
-
-   c) If the modified program normally reads commands interactively when
-run, you must cause it, when started running for such interactive use in
-the most ordinary way, to print or display an announcement including  an
-appropriate  copyright notice and a notice that there is no warranty (or
-else,  saying  that  you  provide  a  warranty)  and  that   users   may
-redistribute  the  program  under these conditions, and telling the user
-how to view a copy of this License. (Exception: if the Program itself is
-interactive but does not normally print such an announcement, your  work
-based on the Program is not required to print an announcement.)
-
-These  requirements  apply  to  the  modified  work  as  a   whole.   If
-identifiable sections of that work are not derived from the Program, and
-can   be   reasonably  considered  independent  and  separate  works  in
-themselves, then this License, and its terms,  do  not  apply  to  those
-sections  when  you  distribute  them  as  separate  works. But when you
-distribute the same sections as part of a whole which is a work based on
-the Program, the distribution of the whole must be on the terms of  this
-License,  whose  permissions  for  other  licensees extend to the entire
-whole, and thus to each and every part regardless of who wrote it.
-
-Thus, it is not the intent of this section to claim  rights  or  contest
-your  rights  to  work written entirely by you; rather, the intent is to
-exercise  the  right  to  control  the  distribution  of  derivative  or
-collective works based on the Program.
-
-In addition, mere aggregation of another work not based on  the  Program
-with  the Program (or with a work based on the Program) on a volume of a
-storage or distribution medium does not bring the other work  under  the
-scope of this License.
-
-3. You may copy and distribute the Program (or a work based on it, under
-Section 2) in object code or executable form under the terms of Sections
-1 and 2 above provided that you also do one of the following:
-
-   a) Accompany it  with  the  complete  corresponding  machine-readable
-source code, which must be distributed under the terms of Sections 1 and
-2 above on a medium customarily used for software interchange; or,
-
-   b) Accompany it with a written offer, valid for at least three years,
-to give any third party,  for  a  charge  no  more  than  your  cost  of
-physically  performing  source distribution, a complete machine-readable
-copy of the corresponding source code, to be distributed under the terms
-of Sections 1 and 2 above on a  medium  customarily  used  for  software
-interchange; or,
-
-   c) Accompany it with the information you received as to the offer  to
-distribute  corresponding source code. (This alternative is allowed only
-for noncommercial distribution and only if you received the  program  in
-object  code  or  executable  form  with  such  an offer, in accord with
-Subsection b above.)
-
-The source code for a work means the preferred  form  of  the  work  for
-making modifications to it. For an executable work, complete source code
-means  all  the  source  code  for  all  modules  it  contains, plus any
-associated interface definition files, plus the scripts used to  control
-compilation  and  installation  of the executable. However, as a special
-exception, the source code distributed need not include anything that is
-normally distributed (in either source or binary form)  with  the  major
-components  (compiler,  kernel,  and  so  on) of the operating system on
-which the executable runs, unless that component itself accompanies  the
-executable.
-
-If distribution of executable or object code is made by offering  access
-to copy from a designated place, then offering equivalent access to copy
-the source code from the same place counts as distribution of the source
-code,  even  though  third  parties are not compelled to copy the source
-along with the object code.
-
-4. You may not copy,  modify,  sublicense,  or  distribute  the  Program
-except  as  expressly provided under this License. Any attempt otherwise
-to copy, modify, sublicense or distribute the Program is void, and  will
-automatically terminate your rights under this License. However, parties
-who  have  received  copies, or rights, from you under this License will
-not have their licenses terminated so long as  such  parties  remain  in
-full compliance.
-
-5. You are not required to accept  this  License,  since  you  have  not
-signed  it.  However,  nothing  else  grants you permission to modify or
-distribute the Program  or  its  derivative  works.  These  actions  are
-prohibited  by  law  if  you  do  not accept this License. Therefore, by
-modifying or distributing the Program (or any work based on the Program),
-you indicate your acceptance of this License to do so, and all its terms
-and conditions for copying, distributing or  modifying  the  Program  or
-works based on it.
-
-6. Each time you redistribute the Program (or  any  work  based  on  the
-Program),  the  recipient  automatically  receives  a  license  from the
-original licensor to copy, distribute or modify the Program  subject  to
-these  terms and conditions. You may not impose any further restrictions
-on the recipients' exercise of the rights granted herein.  You  are  not
-responsible for enforcing compliance by third parties to this License.
-
-7. If, as a consequence of a court  judgment  or  allegation  of  patent
-infringement  or  for  any  other reason (not limited to patent issues),
-conditions are imposed on you (whether  by  court  order,  agreement  or
-otherwise)  that  contradict the conditions of this License, they do not
-excuse you from the conditions of this License. If you cannot distribute
-so as to satisfy simultaneously your obligations under this License  and
-any  other  pertinent  obligations,  then  as  a consequence you may not
-distribute the Program at all. For example, if a  patent  license  would
-not  permit  royalty-free redistribution of the Program by all those who
-receive copies directly or indirectly through you, then the only way you
-could satisfy both it and this License would be to refrain entirely from
-distribution of the Program.
-
-If any portion of this section is held invalid  or  unenforceable  under
-any  particular  circumstance, the balance of the section is intended to
-apply and the  section  as  a  whole  is  intended  to  apply  in  other
-circumstances.
-
-It is not the purpose of this section to  induce  you  to  infringe  any
-patents  or  other  property  right claims or to contest validity of any
-such claims; this  section  has  the  sole  purpose  of  protecting  the
-integrity of the free software distribution system, which is implemented
-by   public   license   practices.   Many   people  have  made  generous
-contributions to the wide range of  software  distributed  through  that
-system in reliance on consistent application of that system; it is up to
-the  author/donor  to  decide  if  he  or  she  is willing to distribute
-software through any other system and  a  licensee  cannot  impose  that
-choice.
-
-This section is intended to make thoroughly clear what is believed to be
-a consequence of the rest of this License.
-
-8. If the distribution and/or  use  of  the  Program  is  restricted  in
-certain  countries  either  by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License  may
-add  an  explicit  geographical  distribution limitation excluding those
-countries, so that distribution is permitted only in or among  countries
-not   thus  excluded.  In  such  case,  this  License  incorporates  the
-limitation as if written in the body of this License.
-
-9. The Free Software Foundation may publish revised and/or new  versions
-of  the General Public License from time to time. Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-Each version is given a distinguishing version number.  If  the  Program
-specifies  a version number of this License which applies to it and "any
-later  version",  you  have  the  option  of  following  the  terms  and
-conditions  either  of that version or of any later version published by
-the Free Software Foundation. If the Program does not specify a  version
-number of this License, you may choose any version ever published by the
-Free Software Foundation.
-
-10. If you wish to incorporate parts of  the  Program  into  other  free
-programs  whose  distribution  conditions  are  different,  write to the
-author to ask for permission. For software which is copyrighted  by  the
-Free  Software  Foundation,  write  to  the Free Software Foundation; we
-sometimes make exceptions for this. Our decision will be guided  by  the
-two  goals  of preserving the free status of all derivatives of our free
-software and of promoting the sharing and reuse of software generally.
-
-NO WARRANTY
-
-11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT  WHEN
-OTHERWISE  STATED  IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-PROVIDE THE PROGRAM  "AS  IS"  WITHOUT  WARRANTY  OF  ANY  KIND,  EITHER
-EXPRESSED  OR  IMPLIED,  INCLUDING,  BUT  NOT  LIMITED  TO,  THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
-ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
-SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
-SERVICING, REPAIR OR CORRECTION.
-
-12. IN NO EVENT UNLESS REQUIRED  BY  APPLICABLE  LAW  OR  AGREED  TO  IN
-WRITING  WILL  ANY  COPYRIGHT  HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
-AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
-DAMAGES, INCLUDING ANY GENERAL,  SPECIAL,  INCIDENTAL  OR  CONSEQUENTIAL
-DAMAGES  ARISING  OUT  OF  THE  USE  OR  INABILITY  TO  USE  THE PROGRAM
-(INCLUDING BUT NOT LIMITED TO  LOSS  OF  DATA  OR  DATA  BEING  RENDERED
-INACCURATE  OR  LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF
-THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER  OR
-OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
-
-END OF TERMS AND CONDITIONS
-
-
-How to Apply These Terms to Your New Programs
-
-If you develop a new program, and you want it  to  be  of  the  greatest
-possible  use  to the public, the best way to achieve this is to make it
-free software which everyone can redistribute  and  change  under  these
-terms.
-
-To do so, attach the following notices to the program. It is  safest  to
-attach  them to the start of each source file to most effectively convey
-the exclusion of warranty; and  each  file  should  have  at  least  the
-"copyright" line and a pointer to where the full notice is found.
-
-   One line to give the program's name and a brief idea of what it does.
-
-   Copyright (C)
-
-   This program is free software; you can redistribute it and/or  modify
-it under the terms of the GNU General Public License as published by the
-Free  Software  Foundation; either version 2 of the License, or (at your
-option) any later version.
-
-   This program is distributed in the hope that it will be  useful,  but
-WITHOUT   ANY   WARRANTY;   without   even   the   implied  warranty  of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
-Public License for more details.
-
-   You should have received a copy of the  GNU  General  Public  License
-along  with this program; if not, write to the Free Software Foundation,
-Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-
-Also add information on how to contact you by electronic and paper mail.
-
-If the program is interactive, make it output a short notice  like  this
-when it starts in an interactive mode:
-
-   Gnomovision version 69, Copyright (C) year name of author
-   Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show
-w'. This is free software, and you are welcome to redistribute it  under
-certain conditions; type `show c' for details.
-
-The hypothetical  commands  `show  w'  and  `show  c'  should  show  the
-appropriate parts of the General Public License. Of course, the commands
-you  use  may be called something other than `show w' and `show c'; they
-could even be mouse-clicks or menu items--whatever suits your program.
-
-You should also get your employer (if you work as a programmer) or  your
-school,  if  any,  to  sign a "copyright disclaimer" for the program, if
-necessary. Here is a sample; alter the names:
-
-   Yoyodyne, Inc.,  hereby  disclaims  all  copyright  interest  in  the
-program `Gnomovision' (which makes passes at compilers) written by James
-Hacker.
-
-   signature of Ty Coon, 1 April 1989
-   Ty Coon, President of Vice
-
-This General Public License does not permit incorporating  your  program
-into  proprietary programs. If your program is a subroutine library, you
-may consider it more useful to permit linking  proprietary  applications
-with  the  library.  If this is what you want to do, use the GNU Library
-General Public License instead of this License.
-
-
-"CLASSPATH" EXCEPTION TO THE GPL VERSION 2
-
-Certain source files distributed by Sun Microsystems, Inc.  are  subject
-to  the following clarification and special exception to the GPL Version
-2, but only where Sun has expressly included in  the  particular  source
-file's header the words
-
-"Sun designates this particular  file  as  subject  to  the  "Classpath"
-exception  as  provided by Sun in the License file that accompanied this
-code."
-
-Linking this library statically or dynamically  with  other  modules  is
-making  a  combined  work  based  on  this  library. Thus, the terms and
-conditions of the GNU General Public License Version 2 cover  the  whole
-combination.
-
-As a special exception, the copyright holders of this library  give  you
-permission  to  link this library with independent modules to produce an
-executable, regardless of the license terms of these independent modules,
-and to copy and distribute the resulting executable under terms of  your
-choice, provided that you also meet, for each linked independent module,
-the  terms and conditions of the license of that module.? An independent
-module is a module which is not derived from or based on this  library.?
-If  you  modify  this  library,  you  may  extend this exception to your
-version of the library, but you are not obligated to do so.? If  you  do
-not wish to do so, delete this exception statement from your version.
-
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/jaxb-NOTICE.txt b/x-pack/snapshot-tool/licenses/jaxb-NOTICE.txt
deleted file mode 100644
index 8d1c8b69c3fce..0000000000000
--- a/x-pack/snapshot-tool/licenses/jaxb-NOTICE.txt
+++ /dev/null
@@ -1 +0,0 @@
- 
diff --git a/x-pack/snapshot-tool/licenses/jaxb-api-2.2.2.jar.sha1 b/x-pack/snapshot-tool/licenses/jaxb-api-2.2.2.jar.sha1
deleted file mode 100644
index a37e187238933..0000000000000
--- a/x-pack/snapshot-tool/licenses/jaxb-api-2.2.2.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-aeb3021ca93dde265796d82015beecdcff95bf09
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/jmespath-java-1.11.636.jar.sha1 b/x-pack/snapshot-tool/licenses/jmespath-java-1.11.636.jar.sha1
deleted file mode 100644
index 70c0d3633af07..0000000000000
--- a/x-pack/snapshot-tool/licenses/jmespath-java-1.11.636.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-e468c349ce410171a1d5df7fa0fa377d52c5d651
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/log4j-1.2-api-2.11.1.jar.sha1 b/x-pack/snapshot-tool/licenses/log4j-1.2-api-2.11.1.jar.sha1
deleted file mode 100644
index 575d75dbda8c5..0000000000000
--- a/x-pack/snapshot-tool/licenses/log4j-1.2-api-2.11.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-3aba3398fe064a3eab4331f88161c7480e848418
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/log4j-LICENSE.txt b/x-pack/snapshot-tool/licenses/log4j-LICENSE.txt
deleted file mode 100644
index 6279e5206de13..0000000000000
--- a/x-pack/snapshot-tool/licenses/log4j-LICENSE.txt
+++ /dev/null
@@ -1,202 +0,0 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright 1999-2005 The Apache Software Foundation
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/log4j-NOTICE.txt b/x-pack/snapshot-tool/licenses/log4j-NOTICE.txt
deleted file mode 100644
index 0375732360047..0000000000000
--- a/x-pack/snapshot-tool/licenses/log4j-NOTICE.txt
+++ /dev/null
@@ -1,5 +0,0 @@
-Apache log4j
-Copyright 2007 The Apache Software Foundation
-
-This product includes software developed at
-The Apache Software Foundation (http://www.apache.org/).
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/opencensus-LICENSE.txt b/x-pack/snapshot-tool/licenses/opencensus-LICENSE.txt
deleted file mode 100644
index d645695673349..0000000000000
--- a/x-pack/snapshot-tool/licenses/opencensus-LICENSE.txt
+++ /dev/null
@@ -1,202 +0,0 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/opencensus-NOTICE.txt b/x-pack/snapshot-tool/licenses/opencensus-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/opencensus-api-0.18.0.jar.sha1 b/x-pack/snapshot-tool/licenses/opencensus-api-0.18.0.jar.sha1
deleted file mode 100644
index 8b95ab4e4c49c..0000000000000
--- a/x-pack/snapshot-tool/licenses/opencensus-api-0.18.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-b89a8f8dfd1e1e0d68d83c82a855624814b19a6e
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/opencensus-contrib-http-util-0.18.0.jar.sha1 b/x-pack/snapshot-tool/licenses/opencensus-contrib-http-util-0.18.0.jar.sha1
deleted file mode 100644
index 1757e00591110..0000000000000
--- a/x-pack/snapshot-tool/licenses/opencensus-contrib-http-util-0.18.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-76a37e4a931d5801a9e25b0c0353e5f37c4d1e8e
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/proto-google-LICENSE.txt b/x-pack/snapshot-tool/licenses/proto-google-LICENSE.txt
deleted file mode 100644
index d645695673349..0000000000000
--- a/x-pack/snapshot-tool/licenses/proto-google-LICENSE.txt
+++ /dev/null
@@ -1,202 +0,0 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/x-pack/snapshot-tool/licenses/proto-google-NOTICE.txt b/x-pack/snapshot-tool/licenses/proto-google-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/licenses/proto-google-common-protos-1.16.0.jar.sha1 b/x-pack/snapshot-tool/licenses/proto-google-common-protos-1.16.0.jar.sha1
deleted file mode 100644
index 7762b7a3ebdc3..0000000000000
--- a/x-pack/snapshot-tool/licenses/proto-google-common-protos-1.16.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-2c5f022ea3b8e8df6a619c4cd8faf9af86022daa
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/proto-google-iam-v1-0.12.0.jar.sha1 b/x-pack/snapshot-tool/licenses/proto-google-iam-v1-0.12.0.jar.sha1
deleted file mode 100644
index 2bfae3456d499..0000000000000
--- a/x-pack/snapshot-tool/licenses/proto-google-iam-v1-0.12.0.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-ea312c0250a5d0a7cdd1b20bc2c3259938b79855
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/protobuf-LICENSE.txt b/x-pack/snapshot-tool/licenses/protobuf-LICENSE.txt
deleted file mode 100644
index 19b305b00060a..0000000000000
--- a/x-pack/snapshot-tool/licenses/protobuf-LICENSE.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-Copyright 2008 Google Inc.  All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-    * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-    * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-    * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-Code generated by the Protocol Buffer compiler is owned by the owner
-of the input file used when generating it.  This code is not
-standalone and requires a support library to be linked with it.  This
-support library is itself covered by the above license.
diff --git a/x-pack/snapshot-tool/licenses/protobuf-NOTICE.txt b/x-pack/snapshot-tool/licenses/protobuf-NOTICE.txt
deleted file mode 100644
index 19b305b00060a..0000000000000
--- a/x-pack/snapshot-tool/licenses/protobuf-NOTICE.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-Copyright 2008 Google Inc.  All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-    * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-    * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-    * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-Code generated by the Protocol Buffer compiler is owned by the owner
-of the input file used when generating it.  This code is not
-standalone and requires a support library to be linked with it.  This
-support library is itself covered by the above license.
diff --git a/x-pack/snapshot-tool/licenses/protobuf-java-3.7.1.jar.sha1 b/x-pack/snapshot-tool/licenses/protobuf-java-3.7.1.jar.sha1
deleted file mode 100644
index 51d30a4c18568..0000000000000
--- a/x-pack/snapshot-tool/licenses/protobuf-java-3.7.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-0bce1b6dc9e4531169542ab37a1c8641bcaa8afb
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/protobuf-java-util-3.7.1.jar.sha1 b/x-pack/snapshot-tool/licenses/protobuf-java-util-3.7.1.jar.sha1
deleted file mode 100644
index d08f6be735b84..0000000000000
--- a/x-pack/snapshot-tool/licenses/protobuf-java-util-3.7.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-45dc95896cfad26397675fdabef7b032d6db4bb6
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/threetenbp-1.3.3.jar.sha1 b/x-pack/snapshot-tool/licenses/threetenbp-1.3.3.jar.sha1
deleted file mode 100644
index 9273043e14520..0000000000000
--- a/x-pack/snapshot-tool/licenses/threetenbp-1.3.3.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-3ea31c96676ff12ab56be0b1af6fff61d1a4f1f2
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/licenses/threetenbp-LICENSE.txt b/x-pack/snapshot-tool/licenses/threetenbp-LICENSE.txt
deleted file mode 100644
index fcdfc8f0d0774..0000000000000
--- a/x-pack/snapshot-tool/licenses/threetenbp-LICENSE.txt
+++ /dev/null
@@ -1,31 +0,0 @@
-/*
- * Copyright (c) 2007-present, Stephen Colebourne & Michael Nascimento Santos
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  * Redistributions of source code must retain the above copyright notice,
- *    this list of conditions and the following disclaimer.
- *
- *  * Redistributions in binary form must reproduce the above copyright notice,
- *    this list of conditions and the following disclaimer in the documentation
- *    and/or other materials provided with the distribution.
- *
- *  * Neither the name of JSR-310 nor the names of its contributors
- *    may be used to endorse or promote products derived from this software
- *    without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
diff --git a/x-pack/snapshot-tool/licenses/threetenbp-NOTICE.txt b/x-pack/snapshot-tool/licenses/threetenbp-NOTICE.txt
deleted file mode 100644
index e69de29bb2d1d..0000000000000
diff --git a/x-pack/snapshot-tool/qa/build.gradle b/x-pack/snapshot-tool/qa/build.gradle
deleted file mode 100644
index f9897042c235d..0000000000000
--- a/x-pack/snapshot-tool/qa/build.gradle
+++ /dev/null
@@ -1 +0,0 @@
-group = "${group}.plugins.snapshot-tool.qa"
diff --git a/x-pack/snapshot-tool/qa/google-cloud-storage/build.gradle b/x-pack/snapshot-tool/qa/google-cloud-storage/build.gradle
deleted file mode 100644
index 50886cb3c27ff..0000000000000
--- a/x-pack/snapshot-tool/qa/google-cloud-storage/build.gradle
+++ /dev/null
@@ -1,88 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-import java.nio.file.Files
-
-apply plugin: 'elasticsearch.build'
-
-dependencies {
-  compile project(":plugins:repository-gcs")
-  testCompile project(":test:framework")
-  testCompile project(':x-pack:snapshot-tool')
-  testCompile files(project(':x-pack:snapshot-tool').sourceSets.test.output)
-}
-
-test.enabled = false
-
-task gcsThirdPartyTests {
-  dependsOn check
-}
-
-boolean useGCSFixture = false
-
-String gcsServiceAccount = System.getenv("google_storage_service_account")
-String gcsBucket = System.getenv("google_storage_bucket")
-String gcsBasePath = System.getenv("google_storage_base_path")
-
-if (!gcsServiceAccount && !gcsBucket && !gcsBasePath) {
-  gcsServiceAccount = new File(project(':plugins:repository-gcs:qa:google-cloud-storage').buildDir,
-    'generated-resources/service_account_test.json').path
-  gcsBucket = 'bucket_test'
-  gcsBasePath = 'integration_test'
-
-  useGCSFixture = true
-} else if (!gcsServiceAccount || !gcsBucket || !gcsBasePath) {
-  throw new IllegalArgumentException("not all options specified to run thirdPartyTestGCS against external GCS service are present")
-}
-
-def encodedCredentials = {
-  Base64.encoder.encodeToString(Files.readAllBytes(file(gcsServiceAccount).toPath()))
-}
-
-task thirdPartyTest(type: Test) {
-  include '**/GCSCleanupTests.class'
-
-  systemProperty 'tests.security.manager', false
-
-  systemProperty 'test.google.bucket', gcsBucket
-  systemProperty 'test.google.base', gcsBasePath
-  nonInputProperties.systemProperty 'test.google.account', "${-> encodedCredentials.call()}"
-}
-
-if (useGCSFixture) {
-  thirdPartyTest.enabled = false;
-  testingConventions.enabled = false;
-  /*
-
-  See: https://github.com/elastic/elasticsearch/issues/46813 Fails with --parallel
-
-  thirdPartyTest.dependsOn(':plugins:repository-gcs:qa:google-cloud-storage:createServiceAccountFile',
-
-          ':plugins:repository-gcs:qa:google-cloud-storage:googleCloudStorageFixture')
-  thirdPartyTest.finalizedBy(':plugins:repository-gcs:qa:google-cloud-storage:googleCloudStorageFixture#stop')
-
-  def fixtureEndpoint = {
-      "http://${project(':plugins:repository-gcs:qa:google-cloud-storage').googleCloudStorageFixture.addressAndPort}"
-  }
-
-  def tokenURI = {
-      "http://${project(':plugins:repository-gcs:qa:google-cloud-storage').googleCloudStorageFixture.addressAndPort}/o/oauth2/token"
-  }
-
-  thirdPartyTest {
-      nonInputProperties.systemProperty 'test.google.endpoint', "${-> fixtureEndpoint.call()}"
-      nonInputProperties.systemProperty 'test.google.tokenURI', "${-> tokenURI.call()}"
-  }
-
-  gradle.taskGraph.whenReady {
-      if (it.hasTask(gcsThirdPartyTests)) {
-          throw new IllegalStateException("Tried to run third party tests but not all of the necessary environment variables 'google_storage_service_account', " +
-                  "'google_storage_bucket', 'google_storage_base_path' are set.")
-      }
-  }
-  */
-}
-
-check.dependsOn(thirdPartyTest)
diff --git a/x-pack/snapshot-tool/qa/google-cloud-storage/src/test/java/org/elasticsearch/snapshots/GCSCleanupTests.java b/x-pack/snapshot-tool/qa/google-cloud-storage/src/test/java/org/elasticsearch/snapshots/GCSCleanupTests.java
deleted file mode 100644
index 274c22ab559c6..0000000000000
--- a/x-pack/snapshot-tool/qa/google-cloud-storage/src/test/java/org/elasticsearch/snapshots/GCSCleanupTests.java
+++ /dev/null
@@ -1,109 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import joptsimple.OptionSet;
-import org.elasticsearch.action.support.master.AcknowledgedResponse;
-import org.elasticsearch.cli.MockTerminal;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.settings.MockSecureSettings;
-import org.elasticsearch.common.settings.SecureSettings;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.plugins.Plugin;
-import org.elasticsearch.repositories.gcs.GoogleCloudStoragePlugin;
-
-import java.util.Base64;
-import java.util.Collection;
-import java.util.Map;
-
-import static org.hamcrest.Matchers.blankOrNullString;
-import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.not;
-
-public class GCSCleanupTests extends AbstractCleanupTests {
-    @Override
-    protected Collection<Class<? extends Plugin>> getPlugins() {
-        return pluginList(GoogleCloudStoragePlugin.class);
-    }
-
-    @Override
-    protected SecureSettings credentials() {
-        assertThat(getBucket(), not(blankOrNullString()));
-        assertThat(getBase64Credentials(), not(blankOrNullString()));
-
-        MockSecureSettings secureSettings = new MockSecureSettings();
-        secureSettings.setFile("gcs.client.default.credentials_file", Base64.getDecoder().decode(getBase64Credentials()));
-        return secureSettings;
-    }
-
-    @Override
-    protected Settings nodeSettings() {
-        Settings.Builder builder = Settings.builder().put(super.nodeSettings());
-
-        if (Strings.isNullOrEmpty(getEndpoint()) == false) {
-            builder.put("gcs.client.default.endpoint", getEndpoint());
-        }
-
-        if (Strings.isNullOrEmpty(getTokenUri()) == false) {
-            builder.put("gcs.client.default.token_uri", getTokenUri());
-        }
-
-        return builder.build();
-    }
-
-    @Override
-    protected void createRepository(final String repoName) {
-        AcknowledgedResponse putRepositoryResponse = client().admin().cluster().preparePutRepository("test-repo")
-                .setType("gcs")
-                .setSettings(Settings.builder()
-                        .put("bucket", getBucket())
-                        .put("base_path", getBasePath())
-                ).get();
-        assertThat(putRepositoryResponse.isAcknowledged(), equalTo(true));
-    }
-
-    private String getBucket() {
-        return System.getProperty("test.google.bucket");
-    }
-
-    private String getBasePath() {
-        return System.getProperty("test.google.base");
-    }
-
-    private String getEndpoint() {
-        return System.getProperty("test.google.endpoint", "");
-    }
-
-    private String getTokenUri() {
-        return System.getProperty("test.google.tokenURI", "");
-    }
-
-    private String getBase64Credentials() {
-        return System.getProperty("test.google.account");
-    }
-
-    @Override
-    protected ThrowingRunnable commandRunnable(MockTerminal terminal, Map<String, String> nonDefaultArguments) {
-        final CleanupGCSRepositoryCommand command = new CleanupGCSRepositoryCommand();
-        final OptionSet options = command.getParser().parse(
-                "--safety_gap_millis", nonDefaultArguments.getOrDefault("safety_gap_millis", "0"),
-                "--parallelism", nonDefaultArguments.getOrDefault("parallelism", "10"),
-                "--bucket", nonDefaultArguments.getOrDefault("bucket", getBucket()),
-                "--base_path", nonDefaultArguments.getOrDefault("base_path", getBasePath()),
-                "--base64_credentials", nonDefaultArguments.getOrDefault("base64_credentials", getBase64Credentials()),
-                "--endpoint", nonDefaultArguments.getOrDefault("endpoint", getEndpoint()),
-                "--token_uri", nonDefaultArguments.getOrDefault("token_uri", getTokenUri())
-                );
-        return () -> command.execute(terminal, options);
-    }
-
-    public void testNoCredentials() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("base64_credentials", "")),
-                "base64_credentials option is required for cleaning up GCS repository");
-    }
-
-}
diff --git a/x-pack/snapshot-tool/qa/s3/build.gradle b/x-pack/snapshot-tool/qa/s3/build.gradle
deleted file mode 100644
index 9f97279b109cb..0000000000000
--- a/x-pack/snapshot-tool/qa/s3/build.gradle
+++ /dev/null
@@ -1,74 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-apply plugin: 'elasticsearch.build'
-apply plugin: 'elasticsearch.test.fixtures'
-
-dependencies {
-  compile project(":plugins:repository-s3")
-  testCompile project(":test:framework")
-  testCompile project(':x-pack:snapshot-tool')
-  testCompile files(project(':x-pack:snapshot-tool').sourceSets.test.output)
-}
-
-test.enabled = false
-
-task s3ThirdPartyTests {
-  dependsOn check
-}
-
-boolean useS3Fixture = false
-
-String s3PermanentAccessKey = System.getenv("amazon_s3_access_key")
-String s3PermanentSecretKey = System.getenv("amazon_s3_secret_key")
-String s3PermanentBucket = System.getenv("amazon_s3_bucket")
-String s3PermanentBasePath = System.getenv("amazon_s3_base_path")
-
-if (!s3PermanentAccessKey && !s3PermanentSecretKey && !s3PermanentBucket && !s3PermanentBasePath) {
-  s3PermanentAccessKey = 'sn_tool_access_key'
-  s3PermanentSecretKey = 'sn_tool_secret_key'
-  s3PermanentBucket = 'bucket'
-  s3PermanentBasePath = 'integration_test'
-
-  useS3Fixture = true
-} else if (!s3PermanentAccessKey || !s3PermanentSecretKey || !s3PermanentBucket || !s3PermanentBasePath) {
-  throw new IllegalArgumentException("not all options specified to run against external S3 service as permanent credentials are present")
-}
-
-task thirdPartyTest(type: Test) {
-  include '**/*.class'
-
-  systemProperty 'tests.security.manager', false
-
-  systemProperty 'test.s3.account', s3PermanentAccessKey
-  systemProperty 'test.s3.key', s3PermanentSecretKey
-  systemProperty 'test.s3.bucket', s3PermanentBucket
-  systemProperty 'test.s3.base', s3PermanentBasePath
-}
-
-if (useS3Fixture) {
-  testingConventions.enabled = false;
-  testFixtures.useFixture(':test:fixtures:minio-fixture', "minio-fixture-for-snapshot-tool")
-
-  def minioAddress = {
-    int minioPort = project(':test:fixtures:minio-fixture').postProcessFixture.ext."test.fixtures.minio-fixture-for-snapshot-tool.tcp.9000"
-    assert minioPort > 0
-    'http://127.0.0.1:' + minioPort
-  }
-
-  thirdPartyTest {
-    dependsOn project(':test:fixtures:minio-fixture').postProcessFixture
-    nonInputProperties.systemProperty 'test.s3.endpoint', "${-> minioAddress.call()}"
-  }
-
-  gradle.taskGraph.whenReady {
-    if (it.hasTask(s3ThirdPartyTests)) {
-      throw new IllegalStateException("Tried to run third party tests but not all of the necessary environment variables 'amazon_s3_access_key', " +
-        "'amazon_s3_secret_key', 'amazon_s3_bucket', and 'amazon_s3_base_path' are set.");
-    }
-  }
-}
-
-check.dependsOn(thirdPartyTest)
diff --git a/x-pack/snapshot-tool/qa/s3/src/test/java/org/elasticsearch/snapshots/S3CleanupTests.java b/x-pack/snapshot-tool/qa/s3/src/test/java/org/elasticsearch/snapshots/S3CleanupTests.java
deleted file mode 100644
index 20724732fdd6f..0000000000000
--- a/x-pack/snapshot-tool/qa/s3/src/test/java/org/elasticsearch/snapshots/S3CleanupTests.java
+++ /dev/null
@@ -1,136 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import com.amazonaws.services.s3.internal.Constants;
-import joptsimple.OptionSet;
-import org.elasticsearch.action.support.master.AcknowledgedResponse;
-import org.elasticsearch.cli.MockTerminal;
-import org.elasticsearch.common.blobstore.BlobMetaData;
-import org.elasticsearch.common.blobstore.BlobPath;
-import org.elasticsearch.common.settings.MockSecureSettings;
-import org.elasticsearch.common.settings.SecureSettings;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.plugins.Plugin;
-import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-import org.elasticsearch.repositories.s3.S3RepositoryPlugin;
-
-import java.util.Collection;
-import java.util.Map;
-import java.util.Set;
-import java.util.concurrent.Executor;
-import java.util.concurrent.TimeUnit;
-
-import static org.hamcrest.Matchers.equalTo;
-
-public class S3CleanupTests extends AbstractCleanupTests {
-
-    @Override
-    protected void assertBlobsByPrefix(BlobStoreRepository repository, BlobPath path, String prefix, Map<String, BlobMetaData> blobs)
-            throws Exception {
-        assertBusy(() -> super.assertBlobsByPrefix(repository, path, prefix, blobs), 10, TimeUnit.MINUTES);
-    }
-
-    @Override
-    protected void assertCorruptionVisible(BlobStoreRepository repo, Map<String, Set<String>> indexToFiles) throws Exception {
-        assertBusy(() -> super.assertCorruptionVisible(repo, indexToFiles), 10, TimeUnit.MINUTES);
-    }
-
-    @Override
-    protected void assertConsistency(BlobStoreRepository repo, Executor executor) throws Exception {
-        assertBusy(() -> super.assertConsistency(repo, executor), 10, TimeUnit.MINUTES);
-    }
-
-    @Override
-    protected Collection<Class<? extends Plugin>> getPlugins() {
-        return pluginList(S3RepositoryPlugin.class);
-    }
-
-    @Override
-    protected SecureSettings credentials() {
-        MockSecureSettings secureSettings = new MockSecureSettings();
-        secureSettings.setString("s3.client.default.access_key", getAccessKey());
-        secureSettings.setString("s3.client.default.secret_key", getSecretKey());
-        return secureSettings;
-    }
-
-    @Override
-    protected void createRepository(String repoName) {
-        Settings.Builder settings = Settings.builder()
-                .put("bucket", getBucket())
-                .put("base_path", getBasePath())
-                .put("endpoint", getEndpoint());
-
-        AcknowledgedResponse putRepositoryResponse = client().admin().cluster()
-                .preparePutRepository(repoName)
-                .setType("s3")
-                .setSettings(settings).get();
-        assertThat(putRepositoryResponse.isAcknowledged(), equalTo(true));
-    }
-
-    private String getEndpoint() {
-        return System.getProperty("test.s3.endpoint", Constants.S3_HOSTNAME);
-    }
-
-    private String getRegion() {
-        return "";
-    }
-
-    private String getBucket() {
-        return System.getProperty("test.s3.bucket");
-    }
-
-    private String getBasePath() {
-        return System.getProperty("test.s3.base");
-    }
-
-    private String getAccessKey() {
-        return System.getProperty("test.s3.account");
-    }
-
-    private String getSecretKey() {
-        return System.getProperty("test.s3.key");
-    }
-
-    @Override
-    protected ThrowingRunnable commandRunnable(MockTerminal terminal, Map<String, String> nonDefaultArguments) {
-        final CleanupS3RepositoryCommand command = new CleanupS3RepositoryCommand();
-        final OptionSet options = command.getParser().parse(
-                "--safety_gap_millis", nonDefaultArguments.getOrDefault("safety_gap_millis", "0"),
-                "--parallelism", nonDefaultArguments.getOrDefault("parallelism", "10"),
-                "--endpoint", nonDefaultArguments.getOrDefault("endpoint", getEndpoint()),
-                "--region", nonDefaultArguments.getOrDefault("region", getRegion()),
-                "--bucket", nonDefaultArguments.getOrDefault("bucket", getBucket()),
-                "--base_path", nonDefaultArguments.getOrDefault("base_path", getBasePath()),
-                "--access_key", nonDefaultArguments.getOrDefault("access_key", getAccessKey()),
-                "--secret_key", nonDefaultArguments.getOrDefault("secret_key", getSecretKey()));
-        return () -> command.execute(terminal, options);
-    }
-
-    public void testNoRegionNoEndpoint() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("region", "", "endpoint", "")),
-                "region or endpoint option is required for cleaning up S3 repository");
-    }
-
-    public void testRegionAndEndpointSpecified() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("region", "test_region", "endpoint", "test_endpoint")),
-                "you must not specify both region and endpoint");
-    }
-
-    public void testNoAccessKey() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("access_key", "")),
-                "access_key option is required for cleaning up S3 repository");
-    }
-
-    public void testNoSecretKey() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("secret_key", "")),
-                "secret_key option is required for cleaning up S3 repository");
-    }
-}
diff --git a/x-pack/snapshot-tool/src/bin/elasticsearch-snapshot b/x-pack/snapshot-tool/src/bin/elasticsearch-snapshot
deleted file mode 100755
index c268f673c6b93..0000000000000
--- a/x-pack/snapshot-tool/src/bin/elasticsearch-snapshot
+++ /dev/null
@@ -1,35 +0,0 @@
-#!/bin/bash
-
-SCRIPT="$0"
-
-while [ -h "$SCRIPT" ] ; do
-  ls=`ls -ld "$SCRIPT"`
-  # Drop everything prior to ->
-  link=`expr "$ls" : '.*-> \(.*\)$'`
-  if expr "$link" : '/.*' > /dev/null; then
-    SCRIPT="$link"
-  else
-    SCRIPT=`dirname "$SCRIPT"`/"$link"
-  fi
-done
-
-JARS_PATH="$(dirname $(dirname $SCRIPT))/libs"
-
-unset CLASSPATH
-
-for J in $(cd "${JARS_PATH}"; ls *.jar); do
-  CLASSPATH=${CLASSPATH}${CLASSPATH:+:}${JARS_PATH}/${J}
-done
-
-for J in $(cd "${JARS_PATH}/vendor"; ls *.jar); do
-  CLASSPATH=${CLASSPATH}${CLASSPATH:+:}${JARS_PATH}/vendor/${J}
-done
-
-# Give JAVA_HOME precedence over the `java` on the PATH
-if [ ! -z "$JAVA_HOME" ]; then
-  JAVA="$JAVA_HOME/bin/java"
-else
-  JAVA=java
-fi
-
-exec ${JAVA} -cp "${CLASSPATH}" org.elasticsearch.snapshots.SnapshotToolCli "$@"
\ No newline at end of file
diff --git a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/AbstractCleanupCommand.java b/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/AbstractCleanupCommand.java
deleted file mode 100644
index f164ff5d78bb8..0000000000000
--- a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/AbstractCleanupCommand.java
+++ /dev/null
@@ -1,75 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import joptsimple.OptionParser;
-import joptsimple.OptionSet;
-import joptsimple.OptionSpec;
-import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.cli.Command;
-import org.elasticsearch.cli.CommandLoggingConfigurator;
-import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.common.Strings;
-
-public abstract class AbstractCleanupCommand extends Command {
-    protected final OptionSpec<Long> safetyGapMillisOption;
-    protected final OptionSpec<Integer> parallelismOption;
-    protected final OptionSpec<String> bucketOption;
-    protected final OptionSpec<String> basePathOption;
-
-    public AbstractCleanupCommand(String description) {
-        super(description, CommandLoggingConfigurator::configureLoggingWithoutConfig);
-
-        bucketOption = parser.accepts("bucket", "Bucket name").withRequiredArg();
-
-        basePathOption = parser.accepts("base_path", "Base path").withRequiredArg();
-
-        safetyGapMillisOption = parser.accepts("safety_gap_millis", "Safety gap to account for clock drift")
-                .withRequiredArg().ofType(Long.class);
-
-        parallelismOption = parser.accepts("parallelism", "How many threads to use to talk to cloud provider")
-                .withRequiredArg().ofType(Integer.class);
-    }
-
-    // package-private for testing
-    OptionParser getParser() {
-        return parser;
-    }
-
-    // public fo testing
-    @Override
-    public void execute(Terminal terminal, OptionSet options) throws Exception {
-        validate(options);
-        AbstractRepository repository = newRepository(terminal, options);
-
-        repository.cleanup();
-    }
-
-    protected abstract AbstractRepository newRepository(Terminal terminal, OptionSet options) throws Exception;
-
-    protected void validate(OptionSet options) {
-        String bucket = bucketOption.value(options);
-        if (Strings.isNullOrEmpty(bucket)) {
-            throw new ElasticsearchException("bucket option is required for cleaning up repository");
-        }
-
-        String basePath = basePathOption.value(options);
-        if (basePath.endsWith("/")) {
-            throw new ElasticsearchException("there should be no trailing slash in the base path");
-        }
-
-        Long safetyGapMillis = safetyGapMillisOption.value(options);
-
-        if (safetyGapMillis != null && safetyGapMillis < 0L) {
-            throw new ElasticsearchException("safety_gap_millis should be non-negative");
-        }
-
-        Integer parallelism = parallelismOption.value(options);
-        if (parallelism != null && parallelism < 1) {
-            throw new ElasticsearchException("parallelism should be at least 1");
-        }
-    }
-}
diff --git a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/AbstractRepository.java b/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/AbstractRepository.java
deleted file mode 100644
index 727a285f77219..0000000000000
--- a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/AbstractRepository.java
+++ /dev/null
@@ -1,305 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.ElasticsearchParseException;
-import org.elasticsearch.action.ActionRunnable;
-import org.elasticsearch.action.support.GroupedActionListener;
-import org.elasticsearch.action.support.PlainActionFuture;
-import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.common.collect.Tuple;
-import org.elasticsearch.common.io.stream.BytesStreamOutput;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.util.concurrent.EsExecutors;
-import org.elasticsearch.common.util.concurrent.ThreadContext;
-import org.elasticsearch.common.util.set.Sets;
-import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
-import org.elasticsearch.common.xcontent.XContentHelper;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.core.internal.io.Streams;
-import org.elasticsearch.repositories.IndexId;
-import org.elasticsearch.repositories.RepositoryData;
-import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.Collections;
-import java.util.Date;
-import java.util.List;
-import java.util.Objects;
-import java.util.Set;
-import java.util.TreeSet;
-import java.util.concurrent.ExecutorService;
-import java.util.concurrent.TimeUnit;
-import java.util.stream.Collectors;
-
-public abstract class AbstractRepository {
-    private static final long DEFAULT_SAFETY_GAP_MILLIS = 3600 * 1000;
-    private static final int DEFAULT_PARALLELISM = 100;
-
-    private static final String INCOMPATIBLE_SNAPSHOTS = "incompatible-snapshots";
-    private static final String NAME = "name";
-    private static final String UUID = "uuid";
-
-    protected final Terminal terminal;
-    private final long safetyGapMillis;
-    private final int parallelism;
-    protected final String basePath;
-
-    protected AbstractRepository(Terminal terminal, Long safetyGapMillis, Integer parallelism, String basePath) {
-        this.terminal = terminal;
-        this.safetyGapMillis = safetyGapMillis == null ? DEFAULT_SAFETY_GAP_MILLIS : safetyGapMillis;
-        this.parallelism = parallelism == null ? DEFAULT_PARALLELISM : parallelism;
-        this.basePath = basePath;
-    }
-
-    private void describeCollection(String start, Collection<?> elements) {
-        terminal.println(Terminal.Verbosity.VERBOSE,
-                start + " has " + elements.size() + " elements: " + elements);
-    }
-
-    private RepositoryData getRepositoryData(long indexFileGeneration) throws IOException {
-        final String snapshotsIndexBlobName = fullPath(BlobStoreRepository.INDEX_FILE_PREFIX + indexFileGeneration);
-
-        try (InputStream blob = getBlobInputStream(snapshotsIndexBlobName)) {
-            BytesStreamOutput out = new BytesStreamOutput();
-            Streams.copy(blob, out);
-            // EMPTY is safe here because RepositoryData#fromXContent calls namedObject
-            try (XContentParser parser = XContentHelper.createParser(NamedXContentRegistry.EMPTY,
-                    LoggingDeprecationHandler.INSTANCE, out.bytes(), XContentType.JSON)) {
-                return RepositoryData.snapshotsFromXContent(parser, indexFileGeneration);
-            }
-        } catch (IOException e) {
-            terminal.println("Failed to read " + snapshotsIndexBlobName + " file");
-            throw e;
-        }
-    }
-
-    private Collection<SnapshotId> getIncompatibleSnapshots() throws IOException {
-        final String incompatibleSnapshotsBlobName = fullPath("incompatible-snapshots");
-
-        try (InputStream blob = getBlobInputStream(incompatibleSnapshotsBlobName)) {
-            BytesStreamOutput out = new BytesStreamOutput();
-            Streams.copy(blob, out);
-            // EMPTY is safe here because RepositoryData#fromXContent calls namedObject
-            try (XContentParser parser = XContentHelper.createParser(NamedXContentRegistry.EMPTY,
-                    LoggingDeprecationHandler.INSTANCE, out.bytes(), XContentType.JSON)) {
-                return incompatibleSnapshotsFromXContent(parser);
-            }
-        } catch (IOException e) {
-            terminal.println("Failed to read [incompatible-snapshots] blob");
-            throw e;
-        } catch (Exception e) {
-            if (isBlobNotFoundException(e)) {
-                return Collections.emptyList();
-            }
-            throw e;
-        }
-    }
-
-    /**
-     * Reads the incompatible snapshot ids from x-content, loading them into a new instance of {@link RepositoryData}
-     * that is created from the invoking instance, plus the incompatible snapshots that are read from x-content.
-     */
-    static List<SnapshotId> incompatibleSnapshotsFromXContent(final XContentParser parser) throws IOException {
-        List<SnapshotId> incompatibleSnapshotIds = new ArrayList<>();
-        if (parser.nextToken() == XContentParser.Token.START_OBJECT) {
-            while (parser.nextToken() == XContentParser.Token.FIELD_NAME) {
-                String currentFieldName = parser.currentName();
-                if (INCOMPATIBLE_SNAPSHOTS.equals(currentFieldName)) {
-                    if (parser.nextToken() == XContentParser.Token.START_ARRAY) {
-                        while (parser.nextToken() != XContentParser.Token.END_ARRAY) {
-                            incompatibleSnapshotIds.add(snapshotIdFromXContent(parser));
-                        }
-                    } else {
-                        throw new ElasticsearchParseException("expected array for [" + currentFieldName + "]");
-                    }
-                } else {
-                    throw new ElasticsearchParseException("unknown field name  [" + currentFieldName + "]");
-                }
-            }
-        } else {
-            throw new ElasticsearchParseException("start object expected");
-        }
-        return incompatibleSnapshotIds;
-    }
-
-    private static SnapshotId snapshotIdFromXContent(XContentParser parser) throws IOException {
-        // the new format from 5.0 which contains the snapshot name and uuid
-        if (parser.currentToken() == XContentParser.Token.START_OBJECT) {
-            String name = null;
-            String uuid = null;
-            while (parser.nextToken() != XContentParser.Token.END_OBJECT) {
-                String currentFieldName = parser.currentName();
-                parser.nextToken();
-                if (NAME.equals(currentFieldName)) {
-                    name = parser.text();
-                } else if (UUID.equals(currentFieldName)) {
-                    uuid = parser.text();
-                }
-            }
-            return new SnapshotId(name, uuid);
-        } else {
-            // the old format pre 5.0 that only contains the snapshot name, use the name as the uuid too
-            final String name = parser.text();
-            return new SnapshotId(name, name);
-        }
-    }
-
-    public void cleanup() throws IOException {
-        terminal.println(Terminal.Verbosity.VERBOSE, "Obtaining latest index file generation and creation timestamp");
-        Tuple<Long, Date> latestIndexIdAndTimestamp = getLatestIndexIdAndTimestamp();
-        if (latestIndexIdAndTimestamp.v1() == -1) {
-            terminal.println(Terminal.Verbosity.NORMAL, "No index-N files found. Repository is empty or corrupted? Exiting");
-            return;
-        }
-        long latestIndexId = latestIndexIdAndTimestamp.v1();
-        terminal.println(Terminal.Verbosity.VERBOSE, "Latest index file generation is " + latestIndexId);
-        Date indexNTimestamp = latestIndexIdAndTimestamp.v2();
-        Date shiftedIndexNTimestamp = new Date(indexNTimestamp.getTime() - safetyGapMillis);
-        terminal.println(Terminal.Verbosity.VERBOSE, "Latest index file creation timestamp is " + indexNTimestamp);
-        terminal.println(Terminal.Verbosity.VERBOSE, "Shifted by safety gap creation timestamp is " + shiftedIndexNTimestamp);
-
-        terminal.println(Terminal.Verbosity.VERBOSE, "Reading latest index file");
-        final RepositoryData repositoryData = getRepositoryData(latestIndexId);
-        final Collection<SnapshotId> incompatibleSnapshots = getIncompatibleSnapshots();
-        if (incompatibleSnapshots.isEmpty() == false) {
-            throw new ElasticsearchException(
-                "Found incompatible snapshots which prevent a safe cleanup execution " + incompatibleSnapshots);
-        }
-        if (repositoryData.getIndices().isEmpty()) {
-            throw new ElasticsearchException(
-                "The repository data contains no references to any indices. Maybe it is from before version 5.x?");
-        }
-        Set<String> referencedIndexIds = repositoryData.getIndices().values().stream().map(IndexId::getId).collect(Collectors.toSet());
-
-        describeCollection("Set of indices referenced by index file", referencedIndexIds);
-
-        terminal.println(Terminal.Verbosity.VERBOSE, "Listing indices/ directory");
-        Set<String> allIndexIds = getAllIndexDirectoryNames();
-        describeCollection("Set of indices inside indices/ directory", allIndexIds);
-
-        Set<String> deletionCandidates = new TreeSet<>(Sets.difference(allIndexIds, referencedIndexIds));
-        describeCollection("Set of deletion candidates", deletionCandidates);
-        if (deletionCandidates.isEmpty()) {
-            terminal.println(Terminal.Verbosity.NORMAL, "Set of deletion candidates is empty. Exiting");
-            return;
-        }
-
-        ExecutorService executor = EsExecutors.newScaling("snapshot_cleanup", 0, parallelism, 10L, TimeUnit.SECONDS,
-            EsExecutors.daemonThreadFactory("snapshot_cleanup_tool"), new ThreadContext(Settings.EMPTY));
-        try {
-            PlainActionFuture<Collection<String>> orphanedIndicesFuture = new PlainActionFuture<>();
-            GroupedActionListener<String> groupedOrphanedIndicesListener = new GroupedActionListener<>(orphanedIndicesFuture,
-                    deletionCandidates.size());
-            for (String candidate : deletionCandidates) {
-                executor.submit(ActionRunnable.supply(
-                    groupedOrphanedIndicesListener, () -> isOrphaned(candidate, shiftedIndexNTimestamp) ? candidate : null));
-            }
-            Set<String> orphanedIndexIds =
-                    new TreeSet<>(orphanedIndicesFuture.actionGet().stream().filter(Objects::nonNull).collect(Collectors.toSet()));
-            describeCollection("Set of orphaned indices", orphanedIndexIds);
-            if (orphanedIndexIds.isEmpty()) {
-                terminal.println(Terminal.Verbosity.NORMAL, "Set of orphaned indices is empty. Exiting");
-                return;
-            }
-
-            confirm(terminal, orphanedIndexIds.size() + " indices have been found. Do you want to remove orphaned indices files? " +
-                    "This action is NOT REVERSIBLE");
-
-            terminal.println(Terminal.Verbosity.NORMAL, "Removing " + orphanedIndexIds.size() + " orphaned indices");
-            PlainActionFuture<Collection<Void>> removalFuture = new PlainActionFuture<>();
-            final List<Tuple<Integer, Long>> results = Collections.synchronizedList(new ArrayList<>());
-            GroupedActionListener<Void> groupedRemovalListener =
-                    new GroupedActionListener<>(removalFuture, orphanedIndexIds.size());
-            for (final String indexId : orphanedIndexIds) {
-                executor.submit(ActionRunnable.run(groupedRemovalListener, () -> {
-                    terminal.println(Terminal.Verbosity.NORMAL, "Removing orphaned index " + indexId);
-                    Tuple<Integer, Long> countSize = deleteIndex(indexId);
-                    terminal.println("Index directory " + indexId + ", files removed " + countSize.v1() +
-                        ", bytes freed " + countSize.v2());
-                    results.add(countSize);
-                }));
-            }
-            Exception ex = null;
-            try {
-                removalFuture.actionGet();
-            } catch (Exception e) {
-                ex = e;
-            }
-            int totalFilesRemoved = results.stream().mapToInt(Tuple::v1).sum();
-            long totalSpaceFreed = results.stream().mapToLong(Tuple::v2).sum();
-            terminal.println(Terminal.Verbosity.NORMAL, "Total files removed: " + totalFilesRemoved);
-            terminal.println(Terminal.Verbosity.NORMAL, "Total bytes freed: " + totalSpaceFreed);
-            terminal.println(Terminal.Verbosity.NORMAL,
-                "Finished removing " + results.size() + "/" + orphanedIndexIds.size() + " orphaned indices");
-            if (ex != null) {
-                throw new ElasticsearchException(ex);
-            }
-        } finally {
-            executor.shutdown();
-            try {
-                if (executor.awaitTermination(30, TimeUnit.SECONDS) == false) {
-                    terminal.println(Terminal.Verbosity.NORMAL, "Unexpectedly there are still tasks running on the executor");
-                }
-            } catch (InterruptedException e) {
-                throw new ElasticsearchException(e);
-            }
-        }
-    }
-
-    private boolean isOrphaned(String candidate, Date shiftedIndexNTimestamp) {
-        terminal.println(Terminal.Verbosity.VERBOSE, "Reading index " + candidate + " last modification timestamp");
-        Date indexTimestamp = getIndexTimestamp(candidate);
-
-        if (indexTimestamp != null) {
-            if (indexTimestamp.before(shiftedIndexNTimestamp)) {
-                terminal.println(Terminal.Verbosity.VERBOSE,
-                        "Index " + candidate + " is orphaned because its modification timestamp " + indexTimestamp +
-                                " is less than index-N shifted timestamp " + shiftedIndexNTimestamp);
-                return true;
-            } else {
-                terminal.println(Terminal.Verbosity.VERBOSE,
-                        "Index " + candidate + " might not be orphaned because its modification timestamp "
-                                + indexTimestamp +
-                                " is gte than index-N shifted timestamp " + shiftedIndexNTimestamp);
-            }
-        } else {
-            terminal.println(Terminal.Verbosity.VERBOSE, "Failed to find single file in index " + candidate + " directory. " +
-                    "Skipping");
-        }
-        return false;
-    }
-
-    private void confirm(Terminal terminal, String msg) {
-        terminal.println(Terminal.Verbosity.NORMAL, msg);
-        String text = terminal.readText("Confirm [y/N] ");
-        if (text.equalsIgnoreCase("y") == false) {
-            throw new ElasticsearchException("Aborted by user");
-        }
-    }
-
-    protected String fullPath(String path) {
-        return basePath + "/" + path;
-    }
-
-    protected abstract Tuple<Long, Date> getLatestIndexIdAndTimestamp() throws IOException;
-
-    protected abstract InputStream getBlobInputStream(String blobName);
-
-    protected abstract boolean isBlobNotFoundException(Exception e);
-
-    protected abstract Set<String> getAllIndexDirectoryNames();
-
-    protected abstract Date getIndexTimestamp(String indexDirectoryName);
-
-    protected abstract Tuple<Integer, Long> deleteIndex(String indexDirectoryName);
-}
diff --git a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/CleanupGCSRepositoryCommand.java b/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/CleanupGCSRepositoryCommand.java
deleted file mode 100644
index ff45a558623d1..0000000000000
--- a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/CleanupGCSRepositoryCommand.java
+++ /dev/null
@@ -1,60 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import joptsimple.OptionSet;
-import joptsimple.OptionSpec;
-import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.common.Strings;
-
-import java.io.IOException;
-import java.net.URISyntaxException;
-import java.security.GeneralSecurityException;
-
-public class CleanupGCSRepositoryCommand extends AbstractCleanupCommand {
-
-    private final OptionSpec<String> base64CredentialsOption;
-    private final OptionSpec<String> endpointOption;
-    private final OptionSpec<String> tokenURIOption;
-
-    public CleanupGCSRepositoryCommand() {
-        super("Command to cleanup orphaned segment files from the GCS repository");
-
-        base64CredentialsOption = parser
-                .accepts("base64_credentials", "Base64 encoded content of google service account credentials file")
-                .withRequiredArg();
-        endpointOption = parser.accepts("endpoint", "GCS endpoint")
-                .withRequiredArg();
-        tokenURIOption = parser.accepts("token_uri", "GCS URI to use for OAuth tokens")
-                .withRequiredArg();
-    }
-
-    @Override
-    protected void validate(OptionSet options) {
-        super.validate(options);
-
-        String encodedCredentials = base64CredentialsOption.value(options);
-        if (Strings.isNullOrEmpty(encodedCredentials)) {
-            throw new ElasticsearchException("base64_credentials option is required for cleaning up GCS repository");
-        }
-    }
-
-    @Override
-    protected AbstractRepository newRepository(Terminal terminal, OptionSet options)
-            throws IOException, GeneralSecurityException, URISyntaxException {
-        return new GCSRepository(
-                terminal,
-                safetyGapMillisOption.value(options),
-                parallelismOption.value(options),
-                bucketOption.value(options),
-                basePathOption.value(options),
-                base64CredentialsOption.value(options),
-                endpointOption.value(options),
-                tokenURIOption.value(options));
-    }
-
-}
diff --git a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/CleanupS3RepositoryCommand.java b/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/CleanupS3RepositoryCommand.java
deleted file mode 100644
index 0fb3e1d671bc5..0000000000000
--- a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/CleanupS3RepositoryCommand.java
+++ /dev/null
@@ -1,77 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import joptsimple.OptionSet;
-import joptsimple.OptionSpec;
-import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.common.Strings;
-
-public class CleanupS3RepositoryCommand extends AbstractCleanupCommand {
-
-    private final OptionSpec<String> regionOption;
-    private final OptionSpec<String> endpointOption;
-    private final OptionSpec<String> accessKeyOption;
-    private final OptionSpec<String> secretKeyOption;
-
-    public CleanupS3RepositoryCommand() {
-        super("Command to cleanup orphaned segment files from the S3 repository");
-
-        regionOption = parser.accepts("region", "S3 region")
-                .withRequiredArg();
-
-        endpointOption = parser.accepts("endpoint", "S3 endpoint")
-                .withRequiredArg();
-
-        accessKeyOption = parser.accepts("access_key", "Access key")
-                .withRequiredArg();
-
-        secretKeyOption = parser.accepts("secret_key", "Secret key")
-                .withRequiredArg();
-    }
-
-    @Override
-    protected AbstractRepository newRepository(Terminal terminal, OptionSet options) {
-        return new S3Repository(
-                terminal,
-                safetyGapMillisOption.value(options),
-                parallelismOption.value(options),
-                bucketOption.value(options),
-                basePathOption.value(options),
-                accessKeyOption.value(options),
-                secretKeyOption.value(options),
-                endpointOption.value(options),
-                regionOption.value(options));
-    }
-
-    @Override
-    protected void validate(OptionSet options) {
-        super.validate(options);
-
-        String region = regionOption.value(options);
-        String endpoint = endpointOption.value(options);
-
-        if (Strings.isNullOrEmpty(region) && Strings.isNullOrEmpty(endpoint)) {
-            throw new ElasticsearchException("region or endpoint option is required for cleaning up S3 repository");
-        }
-
-        if (Strings.isNullOrEmpty(region) == false && Strings.isNullOrEmpty(endpoint) == false) {
-            throw new ElasticsearchException("you must not specify both region and endpoint");
-        }
-
-        String accessKey = accessKeyOption.value(options);
-        if (Strings.isNullOrEmpty(accessKey)) {
-            throw new ElasticsearchException("access_key option is required for cleaning up S3 repository");
-        }
-
-        String secretKey = secretKeyOption.value(options);
-        if (Strings.isNullOrEmpty(secretKey)) {
-            throw new ElasticsearchException("secret_key option is required for cleaning up S3 repository");
-        }
-    }
-
-}
diff --git a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/GCSRepository.java b/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/GCSRepository.java
deleted file mode 100644
index daef5d07abf35..0000000000000
--- a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/GCSRepository.java
+++ /dev/null
@@ -1,220 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import com.google.api.client.googleapis.GoogleUtils;
-import com.google.api.client.http.HttpTransport;
-import com.google.api.client.http.javanet.NetHttpTransport;
-import com.google.api.gax.paging.Page;
-import com.google.auth.oauth2.ServiceAccountCredentials;
-import com.google.cloud.BatchResult;
-import com.google.cloud.http.HttpTransportOptions;
-import com.google.cloud.storage.Blob;
-import com.google.cloud.storage.BlobId;
-import com.google.cloud.storage.Storage;
-import com.google.cloud.storage.StorageBatch;
-import com.google.cloud.storage.StorageException;
-import com.google.cloud.storage.StorageOptions;
-import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.collect.Tuple;
-import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-
-import java.io.ByteArrayInputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.net.URI;
-import java.net.URISyntaxException;
-import java.nio.channels.Channels;
-import java.security.GeneralSecurityException;
-import java.util.ArrayList;
-import java.util.Base64;
-import java.util.Collections;
-import java.util.Date;
-import java.util.HashSet;
-import java.util.List;
-import java.util.Set;
-import java.util.concurrent.atomic.AtomicInteger;
-import java.util.concurrent.atomic.AtomicLong;
-import java.util.concurrent.atomic.AtomicReference;
-
-import static java.net.HttpURLConnection.HTTP_NOT_FOUND;
-
-public class GCSRepository extends AbstractRepository {
-    public static final String DEVSTORAGE_FULL_CONTROL = "https://www.googleapis.com/auth/devstorage.full_control";
-
-    private final String bucket;
-    private final Storage storage;
-
-    protected GCSRepository(Terminal terminal, Long safetyGapMillis, Integer parallelism, String bucket, String basePath,
-                            String base64Credentials, String endpoint, String tokenURI) throws IOException, GeneralSecurityException,
-            URISyntaxException {
-        super(terminal, safetyGapMillis, parallelism, basePath);
-        this.storage = buildGCSClient(base64Credentials, endpoint, tokenURI);
-        this.bucket = bucket;
-    }
-
-    private static Storage buildGCSClient(String base64Credentials, String endpoint, String tokenURI)
-            throws IOException, GeneralSecurityException, URISyntaxException {
-        final NetHttpTransport.Builder builder = new NetHttpTransport.Builder();
-        builder.trustCertificates(GoogleUtils.getCertificateTrustStore());
-        final HttpTransport httpTransport = builder.build();
-
-        final HttpTransportOptions httpTransportOptions = HttpTransportOptions.newBuilder()
-                .setHttpTransportFactory(() -> httpTransport)
-                .build();
-
-        final StorageOptions.Builder storageOptionsBuilder = StorageOptions.newBuilder()
-                .setTransportOptions(httpTransportOptions)
-                .setHeaderProvider(() -> Collections.singletonMap("user-agent", "gcs_cleanup_tool"));
-
-        if (Strings.hasLength(endpoint)) {
-            storageOptionsBuilder.setHost(endpoint);
-        }
-
-        byte[] decodedCredentials = Base64.getDecoder().decode(base64Credentials);
-        ServiceAccountCredentials serviceAccountCredentials =
-                ServiceAccountCredentials.fromStream(new ByteArrayInputStream(decodedCredentials));
-        if (Strings.hasLength(tokenURI)) {
-            serviceAccountCredentials = serviceAccountCredentials.toBuilder().setTokenServerUri(new URI(tokenURI)).build();
-        }
-
-        if (serviceAccountCredentials.createScopedRequired()) {
-            storageOptionsBuilder.setCredentials(serviceAccountCredentials.createScoped(Collections.singleton(DEVSTORAGE_FULL_CONTROL)));
-        } else {
-            storageOptionsBuilder.setCredentials(serviceAccountCredentials);
-        }
-
-        return storageOptionsBuilder.build().getService();
-    }
-
-    @Override
-    public Tuple<Long, Date> getLatestIndexIdAndTimestamp() {
-        long maxGeneration = -1;
-        Date timestamp = null;
-
-        final String indexFilePrefix = fullPath(BlobStoreRepository.INDEX_FILE_PREFIX);
-
-        for (Blob blob : storage.get(bucket).
-                list(Storage.BlobListOption.currentDirectory(), Storage.BlobListOption.prefix(indexFilePrefix)).iterateAll()) {
-            String generationStr = blob.getName().substring(indexFilePrefix.length());
-            try {
-                long generation = Long.parseLong(generationStr);
-                if (generation > maxGeneration) {
-                    maxGeneration = generation;
-                    timestamp = new Date(blob.getCreateTime());
-                }
-            } catch (NumberFormatException e) {
-                terminal.println(Terminal.Verbosity.VERBOSE,
-                        "Ignoring index file with unexpected name format " + blob.getName());
-            }
-        }
-
-        return Tuple.tuple(maxGeneration, timestamp);
-    }
-
-    @Override
-    public InputStream getBlobInputStream(String blobName) {
-        final BlobId blobId = BlobId.of(bucket, blobName);
-        return Channels.newInputStream(storage.reader(blobId));
-    }
-
-    @Override
-    protected boolean isBlobNotFoundException(Exception e) {
-        if (e instanceof StorageException) {
-            if (((StorageException)e).getCode() == HTTP_NOT_FOUND) {
-                return true;
-            }
-        }
-        return false;
-    }
-
-    @Override
-    public Set<String> getAllIndexDirectoryNames() {
-        final String pathPrefix = fullPath("indices/");
-
-        final Set<String> indices = new HashSet<>();
-        for (Blob blob :
-                storage.list(bucket, Storage.BlobListOption.currentDirectory(), Storage.BlobListOption.prefix(pathPrefix)).iterateAll()) {
-            if (blob.isDirectory()) {
-                final String blobName = blob.getName();
-                assert blobName.startsWith(pathPrefix);
-                indices.add(blobName.substring(pathPrefix.length(), blobName.length()-1));
-            }
-        }
-
-        return indices;
-    }
-
-    @Override
-    public Date getIndexTimestamp(String indexDirectoryName) {
-        final String pathPrefix = fullPath("indices/" + indexDirectoryName + "/");
-        for (Blob blob : storage.get(bucket).
-                list(Storage.BlobListOption.prefix(pathPrefix), Storage.BlobListOption.pageSize(1)).iterateAll()) {
-            return new Date(blob.getCreateTime());
-        }
-
-        return null;
-    }
-
-    private void deleteFiles(List<BlobId> blobIdsToDelete) {
-        terminal.println(Terminal.Verbosity.VERBOSE, "Batch removing the following files " + blobIdsToDelete);
-        if (blobIdsToDelete.isEmpty()) {
-            return;
-        }
-        final List<BlobId> failedBlobs = Collections.synchronizedList(new ArrayList<>());
-        final AtomicReference<StorageException> ioe = new AtomicReference<>();
-        final StorageBatch batch = storage.batch();
-        for (BlobId blob : blobIdsToDelete) {
-            batch.delete(blob).notify(
-                    new BatchResult.Callback<>() {
-                        @Override
-                        public void success(Boolean result) {
-                        }
-
-                        @Override
-                        public void error(StorageException exception) {
-                            if (exception.getCode() != HTTP_NOT_FOUND) {
-                                failedBlobs.add(blob);
-                                if (ioe.compareAndSet(null, exception) == false) {
-                                    ioe.get().addSuppressed(exception);
-                                }
-                            }
-                        }
-                    });
-        }
-        batch.submit();
-
-        if (ioe.get() != null) {
-            throw new ElasticsearchException("Exception when deleting blobs [" + failedBlobs + "]", ioe.get());
-        }
-        assert failedBlobs.isEmpty();
-    }
-
-    @Override
-    public Tuple<Integer, Long> deleteIndex(String indexDirectoryName) {
-        AtomicInteger removedFilesCount = new AtomicInteger();
-        AtomicLong filesSize = new AtomicLong();
-
-        final String prefix = fullPath("indices/" + indexDirectoryName);
-        Page<Blob> page = storage.get(bucket).list(Storage.BlobListOption.prefix(prefix));
-        do {
-            final List<BlobId> blobIdsToDelete = new ArrayList<>();
-
-            page.getValues().forEach(b -> {
-                blobIdsToDelete.add(BlobId.of(bucket, b.getName()));
-                removedFilesCount.getAndIncrement();
-                filesSize.getAndAdd(b.getSize());
-            });
-
-            deleteFiles(blobIdsToDelete);
-            page = page.getNextPage();
-        } while (page != null);
-
-        return Tuple.tuple(removedFilesCount.get(), filesSize.get());
-    }
-}
diff --git a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/S3Repository.java b/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/S3Repository.java
deleted file mode 100644
index 57c1b13051951..0000000000000
--- a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/S3Repository.java
+++ /dev/null
@@ -1,179 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import com.amazonaws.AmazonServiceException;
-import com.amazonaws.ClientConfiguration;
-import com.amazonaws.auth.AWSStaticCredentialsProvider;
-import com.amazonaws.auth.BasicAWSCredentials;
-import com.amazonaws.client.builder.AwsClientBuilder;
-import com.amazonaws.services.s3.AmazonS3;
-import com.amazonaws.services.s3.AmazonS3ClientBuilder;
-import com.amazonaws.services.s3.model.AmazonS3Exception;
-import com.amazonaws.services.s3.model.DeleteObjectsRequest;
-import com.amazonaws.services.s3.model.ListObjectsRequest;
-import com.amazonaws.services.s3.model.ObjectListing;
-import com.amazonaws.services.s3.model.S3ObjectSummary;
-import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.collect.Tuple;
-import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-
-import java.io.InputStream;
-import java.util.ArrayList;
-import java.util.Date;
-import java.util.List;
-import java.util.Set;
-import java.util.stream.Collectors;
-
-import static java.net.HttpURLConnection.HTTP_NOT_FOUND;
-
-public class S3Repository extends AbstractRepository {
-    private final AmazonS3 client;
-    private final String bucket;
-
-    S3Repository(Terminal terminal, Long safetyGapMillis, Integer parallelism, String bucket, String basePath,
-                 String accessKey, String secretKey, String endpoint, String region) {
-        super(terminal, safetyGapMillis, parallelism, basePath);
-        this.client = buildS3Client(endpoint, region, accessKey, secretKey);
-        this.bucket = bucket;
-    }
-
-    private static AmazonS3 buildS3Client(String endpoint, String region, String accessKey, String secretKey) {
-        final AmazonS3ClientBuilder builder = AmazonS3ClientBuilder.standard();
-        builder.withCredentials(new AWSStaticCredentialsProvider(new BasicAWSCredentials(accessKey, secretKey)));
-        if (Strings.isNullOrEmpty(region)) {
-            builder.withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration(endpoint, null));
-        } else {
-            builder.withRegion(region);
-        }
-        builder.setClientConfiguration(new ClientConfiguration().withUserAgentPrefix("s3_cleanup_tool"));
-
-        return builder.build();
-    }
-
-    @Override
-    public Tuple<Long, Date> getLatestIndexIdAndTimestamp() {
-        ObjectListing listing = client.listObjects(bucket, fullPath(BlobStoreRepository.INDEX_FILE_PREFIX));
-        int prefixLength = fullPath(BlobStoreRepository.INDEX_FILE_PREFIX).length();
-        long maxGeneration = -1;
-        Date timestamp = null;
-        while (true) {
-            for (S3ObjectSummary objectSummary : listing.getObjectSummaries()) {
-                String generationStr = objectSummary.getKey().substring(prefixLength);
-                try {
-                    long generation = Long.parseLong(generationStr);
-                    if (generation > maxGeneration) {
-                        maxGeneration = generation;
-                        timestamp = objectSummary.getLastModified();
-                    }
-                } catch (NumberFormatException e) {
-                    terminal.println(Terminal.Verbosity.VERBOSE,
-                            "Ignoring index file with unexpected name format " + objectSummary.getKey());
-                }
-            }
-
-            if (listing.isTruncated()) { //very unlikely that we have 1K+ index-N files, but let's make it bullet-proof
-                listing = client.listNextBatchOfObjects(listing);
-            } else {
-                return Tuple.tuple(maxGeneration, timestamp);
-            }
-        }
-    }
-
-    @Override
-    public InputStream getBlobInputStream(String blobName) {
-        return client.getObject(bucket, blobName).getObjectContent();
-    }
-
-    @Override
-    protected boolean isBlobNotFoundException(Exception e) {
-        if (e instanceof AmazonS3Exception) {
-            if (((AmazonS3Exception)e).getStatusCode() == HTTP_NOT_FOUND) {
-                return true;
-            }
-        }
-        return false;
-    }
-
-    @Override
-    public Set<String> getAllIndexDirectoryNames() {
-        try {
-            List<String> prefixes = new ArrayList<>();
-            ListObjectsRequest request = new ListObjectsRequest();
-            request.setBucketName(bucket);
-            request.setPrefix(fullPath("indices/"));
-            request.setDelimiter("/");
-            ObjectListing object_listing = client.listObjects(request);
-            prefixes.addAll(object_listing.getCommonPrefixes());
-
-            while (object_listing.isTruncated()) {
-                object_listing = client.listNextBatchOfObjects(object_listing);
-                prefixes.addAll(object_listing.getCommonPrefixes());
-            }
-            int indicesPrefixLength = fullPath("indices/").length();
-            assert prefixes.stream().allMatch(prefix -> prefix.startsWith(fullPath("indices/")));
-            return prefixes.stream().map(prefix -> prefix.substring(indicesPrefixLength, prefix.length() - 1)).collect(Collectors.toSet());
-        } catch (AmazonServiceException e) {
-            terminal.println("Failed to list indices");
-            throw e;
-        }
-    }
-
-    @Override
-    public Date getIndexTimestamp(String indexDirectoryName) {
-        /*
-         * There is shorter way to get modification timestamp of the index directory:
-         *
-         * S3Object index = client.getObject(bucket, fullPath("indices/" + indexDirectoryName + "/"));
-         * return index.getObjectMetadata().getLastModified();
-         *
-         * It also will work if the directory is empty.
-         * However, on Minio the code above returns some weird dates far in the past.
-         * So we use listing instead.
-         */
-        final ListObjectsRequest listRequest = new ListObjectsRequest();
-        listRequest.setBucketName(bucket);
-        listRequest.setPrefix(fullPath("indices/" + indexDirectoryName + "/"));
-        listRequest.setMaxKeys(1);
-        ObjectListing listing = client.listObjects(listRequest);
-        List<S3ObjectSummary> summaries = listing.getObjectSummaries();
-        if (summaries.isEmpty()) {
-            return null;
-        } else {
-            S3ObjectSummary any = summaries.get(0);
-            return any.getLastModified();
-        }
-    }
-
-    private void deleteFiles(List<String> files) {
-        // AWS has a limit of 1K elements when performing batch remove,
-        // However, list call never spits out more than 1K elements, so there is no need to partition
-        terminal.println(Terminal.Verbosity.VERBOSE, "Batch removing the following files " + files);
-        client.deleteObjects(new DeleteObjectsRequest(bucket).withKeys(Strings.toStringArray(files)));
-    }
-
-    @Override
-    public Tuple<Integer, Long> deleteIndex(String indexDirectoryName) {
-        int removedFilesCount = 0;
-        long filesSize = 0L;
-        String prefix = fullPath("indices/" + indexDirectoryName);
-
-        ObjectListing listing = client.listObjects(bucket, prefix);
-        while (true) {
-            List<String> files = listing.getObjectSummaries().stream().map(S3ObjectSummary::getKey).collect(Collectors.toList());
-            deleteFiles(files);
-            removedFilesCount += files.size();
-            filesSize += listing.getObjectSummaries().stream().mapToLong(S3ObjectSummary::getSize).sum();
-
-            if (listing.isTruncated()) {
-                listing = client.listNextBatchOfObjects(listing);
-            } else {
-                return Tuple.tuple(removedFilesCount, filesSize);
-            }
-        }
-    }
-}
diff --git a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/SnapshotToolCli.java b/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/SnapshotToolCli.java
deleted file mode 100644
index 89ccb57a8eb88..0000000000000
--- a/x-pack/snapshot-tool/src/main/java/org/elasticsearch/snapshots/SnapshotToolCli.java
+++ /dev/null
@@ -1,25 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import org.elasticsearch.cli.CommandLoggingConfigurator;
-import org.elasticsearch.cli.LoggingAwareMultiCommand;
-import org.elasticsearch.cli.Terminal;
-
-public class SnapshotToolCli extends LoggingAwareMultiCommand {
-
-    public SnapshotToolCli() {
-        super("Tool to work with repositories and snapshots");
-        CommandLoggingConfigurator.configureLoggingWithoutConfig();
-        subcommands.put("cleanup_s3", new CleanupS3RepositoryCommand());
-        subcommands.put("cleanup_gcs", new CleanupGCSRepositoryCommand());
-    }
-
-    public static void main(String[] args) throws Exception {
-        exit(new SnapshotToolCli().main(args, Terminal.DEFAULT));
-    }
-
-}
diff --git a/x-pack/snapshot-tool/src/test/java/org/elasticsearch/snapshots/AbstractCleanupTests.java b/x-pack/snapshot-tool/src/test/java/org/elasticsearch/snapshots/AbstractCleanupTests.java
deleted file mode 100644
index f51ee07ce56ed..0000000000000
--- a/x-pack/snapshot-tool/src/test/java/org/elasticsearch/snapshots/AbstractCleanupTests.java
+++ /dev/null
@@ -1,275 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.snapshots;
-
-import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.action.ActionRunnable;
-import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotResponse;
-import org.elasticsearch.action.support.PlainActionFuture;
-import org.elasticsearch.cli.MockTerminal;
-import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.common.blobstore.BlobMetaData;
-import org.elasticsearch.common.blobstore.BlobPath;
-import org.elasticsearch.common.settings.SecureSettings;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.repositories.RepositoriesService;
-import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-import org.elasticsearch.repositories.blobstore.BlobStoreTestUtil;
-import org.elasticsearch.test.ESSingleNodeTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
-
-import java.util.Collections;
-import java.util.Map;
-import java.util.Set;
-import java.util.TreeMap;
-import java.util.TreeSet;
-import java.util.concurrent.Executor;
-
-import static org.hamcrest.Matchers.containsString;
-import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.greaterThan;
-import static org.hamcrest.Matchers.not;
-
-public abstract class AbstractCleanupTests extends ESSingleNodeTestCase {
-
-    protected BlobStoreRepository repository;
-
-    protected void assertBlobsByPrefix(BlobStoreRepository repository, BlobPath path, String prefix, Map<String, BlobMetaData> blobs)
-            throws Exception {
-        BlobStoreTestUtil.assertBlobsByPrefix(repository, path, prefix, blobs);
-    }
-
-    protected void assertConsistency(BlobStoreRepository repo, Executor executor) throws Exception {
-        BlobStoreTestUtil.assertConsistency(repo, executor);
-    }
-
-    protected void assertCorruptionVisible(BlobStoreRepository repo, Map<String, Set<String>> indexToFiles) throws Exception {
-       BlobStoreTestUtil.assertCorruptionVisible(repo, indexToFiles);
-    }
-
-    @Override
-    public void setUp() throws Exception {
-        super.setUp();
-        createRepository("test-repo");
-        repository = (BlobStoreRepository) getInstanceFromNode(RepositoriesService.class).repository("test-repo");
-        cleanupRepository(repository);
-    }
-
-    private void cleanupRepository(BlobStoreRepository repository) throws Exception {
-        final PlainActionFuture<Void> future = PlainActionFuture.newFuture();
-        repository.threadPool().generic().execute(ActionRunnable.run(future,
-            () -> repository.blobStore().blobContainer(repository.basePath()).delete()));
-        future.actionGet();
-        assertBlobsByPrefix(repository, repository.basePath(), "", Collections.emptyMap());
-    }
-
-    @Override
-    protected Settings nodeSettings() {
-        return Settings.builder()
-                .put(super.nodeSettings())
-                .setSecureSettings(credentials())
-                .build();
-    }
-
-    protected abstract SecureSettings credentials();
-
-    protected abstract void createRepository(String repoName);
-
-    protected abstract ThrowingRunnable commandRunnable(MockTerminal terminal, Map<String, String> nonDefaultArguments);
-
-    private MockTerminal executeCommand(boolean abort) throws Throwable {
-        return executeCommand(abort, Collections.emptyMap());
-    }
-
-    protected MockTerminal executeCommand(boolean abort, Map<String, String> nonDefaultArguments) throws Throwable {
-        final MockTerminal terminal = new MockTerminal();
-        ThrowingRunnable command = commandRunnable(terminal, nonDefaultArguments);
-        terminal.setVerbosity(Terminal.Verbosity.VERBOSE);
-        final String input;
-
-        if (abort) {
-            input = randomValueOtherThanMany(c -> c.equalsIgnoreCase("y"), () -> randomAlphaOfLength(1));
-        } else {
-            input = randomBoolean() ? "y" : "Y";
-        }
-
-        terminal.addTextInput(input);
-
-        try {
-            command.run();
-        } catch (ElasticsearchException e) {
-            if (abort && e.getMessage().contains("Aborted by user")) {
-                return terminal;
-            } else {
-                throw e;
-            }
-        } finally {
-            logger.info("Cleanup command output:\n" + terminal.getOutput());
-            logger.info("Cleanup command standard error:\n" + terminal.getErrorOutput());
-        }
-
-        return terminal;
-    }
-
-    protected void expectThrows(ThrowingRunnable runnable, String message) {
-        ElasticsearchException ex = expectThrows(ElasticsearchException.class, runnable);
-        assertThat(ex.getMessage(), containsString(message));
-    }
-
-    public void testNoBucket() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("bucket", "")),
-                "bucket option is required for cleaning up repository");
-    }
-
-    public void testNegativeSafetyGap() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("safety_gap_millis", "-10")),
-                "safety_gap_millis should be non-negative");
-    }
-
-    public void testInvalidParallelism() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("parallelism", "0")),
-                "parallelism should be at least 1");
-    }
-
-    public void testBasePathTrailingSlash() {
-        expectThrows(() ->
-                        executeCommand(false, Map.of("base_path", "test/")),
-                "there should be no trailing slash in the base path");
-    }
-
-    public void testCleanup() throws Throwable {
-        logger.info("--> execute cleanup tool on empty repo, there is nothing to cleanup");
-        MockTerminal terminal = executeCommand(false);
-        assertThat(terminal.getOutput(), containsString("No index-N files found. Repository is empty or corrupted? Exiting"));
-        createIndex("test-idx-1");
-        createIndex("test-idx-2");
-        createIndex("test-idx-3");
-        ensureGreen();
-
-        logger.info("--> indexing some data");
-        for (int i = 0; i < 100; i++) {
-            client().prepareIndex("test-idx-1").setId(Integer.toString(i)).setSource("foo", "bar" + i).get();
-            client().prepareIndex("test-idx-2").setId(Integer.toString(i)).setSource("foo", "bar" + i).get();
-            client().prepareIndex("test-idx-3").setId(Integer.toString(i)).setSource("foo", "bar" + i).get();
-        }
-        client().admin().indices().prepareRefresh().get();
-
-        // We run multiple iterations of snapshot -> corrupt -> cleanup -> verify -> delete snapshot
-        // to make sure cleanup tool works correctly regardless of index.latest value
-        for (int i = 1; i <= randomIntBetween(1, 3); i++) {
-            logger.info("Iteration number {}", i);
-            logger.info("--> create first snapshot");
-            CreateSnapshotResponse createSnapshotResponse = client().admin()
-                    .cluster()
-                    .prepareCreateSnapshot("test-repo", "snap1")
-                    .setWaitForCompletion(true)
-                    .setIndices("test-idx-*", "-test-idx-3")
-                    .get();
-            assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(), greaterThan(0));
-            assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(),
-                    equalTo(createSnapshotResponse.getSnapshotInfo().totalShards()));
-
-            assertThat(client().admin()
-                            .cluster()
-                            .prepareGetSnapshots("test-repo")
-                            .setSnapshots("snap1")
-                            .get()
-                            .getSnapshots("test-repo")
-                            .get(0)
-                            .state(),
-                    equalTo(SnapshotState.SUCCESS));
-
-
-            logger.info("--> execute cleanup tool, there is nothing to cleanup");
-            terminal = executeCommand(false);
-            assertThat(terminal.getOutput(), containsString("Set of deletion candidates is empty. Exiting"));
-
-            logger.info("--> check that there is no inconsistencies after running the tool");
-            assertConsistency(repository, repository.threadPool().executor(ThreadPool.Names.GENERIC));
-
-            logger.info("--> create several dangling indices");
-            int numOfFiles = 0;
-            long size = 0L;
-            Map<String, Set<String>> indexToFiles = new TreeMap<>();
-            for (int j = 0; j < randomIntBetween(1, 5); j++) {
-                String name = randomValueOtherThanMany(n -> indexToFiles.containsKey(n), () -> randomAlphaOfLength(5));
-                Set<String> files = new TreeSet<>();
-                indexToFiles.put(name, files);
-                for (int k = 0; k < randomIntBetween(1, 5); k++) {
-                    String file = randomValueOtherThanMany(f -> files.contains(f), () -> randomAlphaOfLength(6));
-                    files.add(file);
-                    numOfFiles++;
-                }
-                size += BlobStoreTestUtil.createDanglingIndex(repository, name, files);
-            }
-            Set<String> danglingIndices = indexToFiles.keySet();
-
-            logger.info("--> ensure dangling index folders are visible");
-            assertCorruptionVisible(repository, indexToFiles);
-
-            logger.info("--> execute cleanup tool, corruption is created latter than snapshot, there is nothing to cleanup");
-            terminal = executeCommand(false);
-            assertThat(terminal.getOutput(), containsString("Set of orphaned indices is empty. Exiting"));
-
-            logger.info("--> create second snapshot");
-            createSnapshotResponse = client().admin()
-                    .cluster()
-                    .prepareCreateSnapshot("test-repo", "snap2")
-                    .setWaitForCompletion(true)
-                    .setIndices("test-idx-*", "-test-idx-3")
-                    .get();
-            assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(), greaterThan(0));
-            assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(),
-                    equalTo(createSnapshotResponse.getSnapshotInfo().totalShards()));
-
-            logger.info("--> execute cleanup tool again and abort");
-            terminal = executeCommand(true);
-            assertThat(terminal.getOutput(),
-                    containsString("Set of deletion candidates has " + danglingIndices.size() + " elements: " + danglingIndices));
-            assertThat(terminal.getOutput(),
-                    containsString("Set of orphaned indices has " + danglingIndices.size() + " elements: " + danglingIndices));
-            assertThat(terminal.getOutput(), containsString("This action is NOT REVERSIBLE"));
-            for (String index : indexToFiles.keySet()) {
-                assertThat(terminal.getOutput(), not(containsString("Removing orphaned index " + index)));
-            }
-
-            logger.info("--> execute cleanup tool again and confirm, dangling indices should go");
-            terminal = executeCommand(false);
-            assertThat(terminal.getOutput(),
-                    containsString("Set of deletion candidates has " + danglingIndices.size() + " elements: " + danglingIndices));
-            assertThat(terminal.getOutput(),
-                    containsString("Set of orphaned indices has " + danglingIndices.size() + " elements: " + danglingIndices));
-            assertThat(terminal.getOutput(), containsString("This action is NOT REVERSIBLE"));
-            for (String index : indexToFiles.keySet()) {
-                assertThat(terminal.getOutput(), containsString("Removing orphaned index " + index));
-                for (String file : indexToFiles.get(index)) {
-                    assertThat(terminal.getOutput(), containsString(index + "/" + file));
-                }
-            }
-            assertThat(terminal.getOutput(),
-                    containsString("Total files removed: " + numOfFiles));
-            assertThat(terminal.getOutput(),
-                    containsString("Total bytes freed: " + size));
-
-            logger.info("--> verify that there is no inconsistencies");
-            assertConsistency(repository, repository.threadPool().executor(ThreadPool.Names.GENERIC));
-            logger.info("--> perform cleanup by removing snapshots");
-            assertTrue(client().admin()
-                    .cluster()
-                    .prepareDeleteSnapshot("test-repo", "snap1")
-                    .get()
-                    .isAcknowledged());
-            assertTrue(client().admin()
-                    .cluster()
-                    .prepareDeleteSnapshot("test-repo", "snap2")
-                    .get()
-                    .isAcknowledged());
-        }
-    }
-}

From 323ea17cac9313f51f239456090706980a3f629b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 9 Jan 2020 13:57:11 +0100
Subject: [PATCH 475/686] [DOCS] Moves analysis resources to PUT DFA API docs
 (#50704)

Co-authored-by: Lisa Cawley <lcawley@elastic.co>
---
 .../apis/analysisobjects.asciidoc             | 217 ----------------
 .../ml/df-analytics/apis/index.asciidoc       |   2 -
 .../apis/put-dfanalytics.asciidoc             | 234 +++++++++++++-----
 docs/reference/ml/ml-shared.asciidoc          |  84 ++++---
 docs/reference/redirects.asciidoc             |   6 +
 docs/reference/rest-api/defs.asciidoc         |   9 +-
 6 files changed, 236 insertions(+), 316 deletions(-)
 delete mode 100644 docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc

diff --git a/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc b/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc
deleted file mode 100644
index 0004416c05cd7..0000000000000
--- a/docs/reference/ml/df-analytics/apis/analysisobjects.asciidoc
+++ /dev/null
@@ -1,217 +0,0 @@
-[role="xpack"]
-[testenv="platinum"]
-[[ml-dfa-analysis-objects]]
-=== Analysis configuration objects
-
-{dfanalytics-cap} resources contain `analysis` objects. For example, when you
-create a {dfanalytics-job}, you must define the type of analysis it performs. 
-This page lists all the available parameters that you can use in the `analysis` 
-object grouped by {dfanalytics} types.
-
-
-[discrete]
-[[oldetection-resources]]
-==== {oldetection-cap} configuration objects
-
-An `outlier_detection` configuration object has the following properties:
-
-`compute_feature_influence`::
-(Optional, boolean) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=compute-feature-influence]
-  
-`feature_influence_threshold`:: 
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-influence-threshold]
-
-`method`::
-(Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=method]
-  
-`n_neighbors`::
-(Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=n-neighbors]
-  
-`outlier_fraction`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=outlier-fraction]
-  
-`standardization_enabled`::
-(Optional, boolean) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=standardization-enabled]
-
-
-[discrete]
-[[reganalysis-resources]]
-==== {regression-cap} configuration objects
-
-[source,console]
---------------------------------------------------
-PUT _ml/data_frame/analytics/house_price_regression_analysis
-{
-  "source": {
-    "index": "houses_sold_last_10_yrs" <1>
-  },
-  "dest": {
-    "index": "house_price_predictions" <2>
-  },
-  "analysis": 
-    {
-      "regression": { <3>
-        "dependent_variable": "price" <4>
-      }
-    }
-}
---------------------------------------------------
-// TEST[skip:TBD]
-
-<1> Training data is taken from source index `houses_sold_last_10_yrs`.
-<2> Analysis results will be output to destination index 
-`house_price_predictions`.
-<3> The regression analysis configuration object.
-<4> Regression analysis will use field `price` to train on. As no other 
-parameters have been specified it will train on 100% of eligible data, store its 
-prediction in destination index field `price_prediction` and use in-built 
-hyperparameter optimization to give minimum validation errors.
-
-
-[float]
-[[regression-resources-standard]]
-===== Standard parameters
-
-`dependent_variable`::
-(Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
-+
---
-The data type of the field must be numeric.
---
-
-`prediction_field_name`::
-(Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
-
-`training_percent`::
-(Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
-
-`randomize_seed`::
-(Optional, long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
-
-
-[float]
-[[regression-resources-advanced]]
-===== Advanced parameters
-
-Advanced parameters are for fine-tuning {reganalysis}. They are set 
-automatically by <<ml-hyperparam-optimization,hyperparameter optimization>> 
-to give minimum validation error. It is highly recommended to use the default 
-values unless you fully understand the function of these parameters. If these 
-parameters are not supplied, their values are automatically tuned to give 
-minimum validation error.
-
-`eta`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
-
-`feature_bag_fraction`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
-
-`maximum_number_trees`::
-(Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=maximum-number-trees]
-
-`gamma`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
-
-`lambda`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
-
-
-[discrete]
-[[classanalysis-resources]]
-==== {classification-cap} configuration objects 
- 
- 
-[float]
-[[classification-resources-standard]]
-===== Standard parameters
- 
-`dependent_variable`::
-(Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
-+
---
-The data type of the field must be numeric (`integer`, `short`, `long`, `byte`), 
-categorical (`ip`, `keyword`, `text`), or boolean.
---
-  
-`num_top_classes`::
-(Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=num-top-classes]
- 
-`prediction_field_name`::
-(Optional, string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
-
-`training_percent`::
-(Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
-
-`randomize_seed`::
-(Optional, long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
-
-
-[float]
-[[classification-resources-advanced]]
-===== Advanced parameters
-
-Advanced parameters are for fine-tuning {classanalysis}. They are set 
-automatically by <<ml-hyperparam-optimization,hyperparameter optimization>> 
-to give minimum validation error. It is highly recommended to use the default 
-values unless you fully understand the function of these parameters. If these 
-parameters are not supplied, their values are automatically tuned to give 
-minimum validation error.
-
-`eta`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
-
-`feature_bag_fraction`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
-
-`maximum_number_trees`::
-(Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=maximum-number-trees]
-
-`gamma`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
-
-`lambda`::
-(Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
-
-[discrete]
-[[ml-hyperparam-optimization]]
-==== Hyperparameter optimization
-
-If you don't supply {regression} or {classification} parameters, hyperparameter 
-optimization will be performed by default to set a value for the undefined 
-parameters. The starting point is calculated for data dependent parameters by 
-examining the loss on the training data. Subject to the size constraint, this 
-operation provides an upper bound on the improvement in validation loss.
-
-A fixed number of rounds is used for optimization which depends on the number of 
-parameters being optimized. The optimization starts with random search, then 
-Bayesian optimization is performed that is targeting maximum expected 
-improvement. If you override any parameters, then the optimization will 
-calculate the value of the remaining parameters accordingly and use the value 
-you provided for the overridden parameter. The number of rounds are reduced 
-respectively. The validation error is estimated in each round by using 4-fold 
-cross validation.
diff --git a/docs/reference/ml/df-analytics/apis/index.asciidoc b/docs/reference/ml/df-analytics/apis/index.asciidoc
index cdad89f9bb4cd..396349ec857e0 100644
--- a/docs/reference/ml/df-analytics/apis/index.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/index.asciidoc
@@ -14,8 +14,6 @@ You can use the following APIs to perform {ml} {dfanalytics} activities.
 * <<evaluate-dfanalytics,Evaluate {dfanalytics}>>
 * <<explain-dfanalytics,Explain {dfanalytics}>>
 
-For the `analysis` object resources, check <<ml-dfa-analysis-objects>>.
-
 
 You can use the following APIs to perform {infer} operations.
 
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index 4cd48508a0e37..83b2ff4b65835 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -53,82 +53,200 @@ If the destination index already exists, then it will be use as is. This makes
 it possible to set up the destination index in advance with custom settings 
 and mappings.
 
-[[ml-put-dfanalytics-supported-fields]]
-===== Supported fields
+[discrete]
+[[ml-hyperparam-optimization]]
+===== Hyperparameter optimization
+
+If you don't supply {regression} or {classification} parameters, _hyperparameter 
+optimization_ occurs, which sets a value for the undefined parameters. The
+starting point is calculated for data dependent parameters by examining the loss
+on the training data. Subject to the size constraint, this operation provides an
+upper bound on the improvement in validation loss.
+
+A fixed number of rounds is used for optimization which depends on the number of 
+parameters being optimized. The optimization starts with random search, then 
+Bayesian optimization is performed that is targeting maximum expected 
+improvement. If you override any parameters,
+//TBD: What is meant by overriding them? Explicitly setting the parameter instead of letting it take the default? 
+the optimization calculates the value of the remaining parameters accordingly
+and uses the value you provided for the overridden parameter. The number of
+rounds are reduced respectively. The validation error is estimated in each round
+by using 4-fold cross validation.
 
-====== {oldetection-cap}
+[[ml-put-dfanalytics-path-params]]
+==== {api-path-parms-title}
 
-{oldetection-cap} requires numeric or boolean data to analyze. The algorithms 
-don't support missing values therefore fields that have data types other than 
-numeric or boolean are ignored. Documents where included fields contain missing 
-values, null values, or an array are also ignored. Therefore the `dest` index 
-may contain documents that don't have an {olscore}.
+`<data_frame_analytics_id>`::
+(Required, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
 
+[[ml-put-dfanalytics-request-body]]
+==== {api-request-body-title}
 
-====== {regression-cap}
+`allow_lazy_start`::
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-start]
+
+`analysis`::
+(Required, object)
+The analysis configuration, which contains the information necessary to perform
+one of the following types of analysis: {classification}, {oldetection}, or
+{regression}.
+//include::{docdir}/ml/ml-shared.asciidoc[tag=analysis]
+
+`analysis`.`classification`:::
+(Required^*^, object)
+The configuration information necessary to perform
+{ml-docs}/dfa-classification.html[{classification}].
++
+--
+TIP: Advanced parameters are for fine-tuning {classanalysis}. They are set 
+automatically by <<ml-hyperparam-optimization,hyperparameter optimization>> 
+to give minimum validation error. It is highly recommended to use the default 
+values unless you fully understand the function of these parameters.
+
+--
+
+`analysis`.`classification`.`dependent_variable`::::
+(Required, string)
++
+--
+include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
 
-{regression-cap} supports fields that are numeric, `boolean`, `text`, `keyword`, 
-and `ip`. It is also tolerant of missing values. Fields that are supported are 
-included in the analysis, other fields are ignored. Documents where included
-fields contain  an array with two or more values are also ignored. Documents in
-the `dest` index  that don’t contain a results field are not included in the
- {reganalysis}.
+The data type of the field must be numeric (`integer`, `short`, `long`, `byte`), 
+categorical (`ip`, `keyword`, `text`), or boolean.
+--
 
+`analysis`.`classification`.`eta`::::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
 
-====== {classification-cap}
+`analysis`.`classification`.`feature_bag_fraction`::::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
 
-{classification-cap} supports fields that are numeric, `boolean`, `text`,
-`keyword`, and `ip`. It is also tolerant of missing values. Fields that are 
-supported are included in the analysis, other fields are ignored. Documents
-where included fields contain an array with two or more values are also ignored. 
-Documents in the `dest` index that don’t contain a results field are not
-included in the {classanalysis}.
+`analysis`.`classification`.`maximum_number_trees`::::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=maximum-number-trees]
 
-{classanalysis-cap} can be improved by mapping ordinal variable values to a 
-single number. For example, in case of age ranges, you can model the values as 
-"0-14" = 0, "15-24" = 1, "25-34" = 2, and so on.
+`analysis`.`classification`.`gamma`::::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
 
+`analysis`.`classification`.`lambda`::::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
 
-[[ml-put-dfanalytics-path-params]]
-==== {api-path-parms-title}
+`analysis`.`classification`.`num_top_classes`::::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=num-top-classes]
 
-`<data_frame_analytics_id>`::
+`analysis`.`classification`.`prediction_field_name`::::
+(Optional, string) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
+
+`analysis`.`classification`.`randomize_seed`::::
+(Optional, long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
+
+`analysis`.`classification`.`training_percent`::::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
+
+`analysis`.`outlier_detection`:::
+(Required^*^, object)
+The configuration information necessary to perform
+{ml-docs}/dfa-outlier-detection.html[{oldetection}]:
+
+`analysis`.`outlier_detection`.`compute_feature_influence`::::
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=compute-feature-influence]
+  
+`analysis`.`outlier_detection`.`feature_influence_threshold`:::: 
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=feature-influence-threshold]
+
+`analysis`.`outlier_detection`.`method`::::
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=method]
+  
+`analysis`.`outlier_detection`.`n_neighbors`::::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=n-neighbors]
+  
+`analysis`.`outlier_detection`.`outlier_fraction`::::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=outlier-fraction]
+  
+`analysis`.`outlier_detection`.`standardization_enabled`::::
+(Optional, boolean) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=standardization-enabled]
+
+`analysis`.`regression`:::
+(Required^*^, object)
+The configuration information necessary to perform
+{ml-docs}/dfa-regression.html[{regression}].
++
+--
+TIP: Advanced parameters are for fine-tuning {reganalysis}. They are set 
+automatically by <<ml-hyperparam-optimization,hyperparameter optimization>> 
+to give minimum validation error. It is highly recommended to use the default 
+values unless you fully understand the function of these parameters.
+
+--
+
+`analysis`.`regression`.`dependent_variable`::::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
++
+--
+include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
 
-[[ml-put-dfanalytics-request-body]]
-==== {api-request-body-title}
+The data type of the field must be numeric.
+--
 
-`analysis`::
-(Required, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=analysis]
+`analysis`.`regression`.`eta`::::
+(Optional, double)
+include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
+
+`analysis`.`regression`.`feature_bag_fraction`::::
+(Optional, double)
+include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
+
+`analysis`.`regression`.`maximum_number_trees`::::
+(Optional, integer) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=maximum-number-trees]
+
+`analysis`.`regression`.`gamma`::::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
+
+`analysis`.`regression`.`lambda`::::
+(Optional, double) 
+include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
+
+`analysis`.`regression`.`prediction_field_name`::::
+(Optional, string)
+include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
+
+`analysis`.`regression`.`training_percent`::::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
+
+`analysis`.`regression`.`randomize_seed`::::
+(Optional, long)
+include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
   
 `analyzed_fields`::
 (Optional, object)
 include::{docdir}/ml/ml-shared.asciidoc[tag=analyzed-fields]
 
-[source,console]
---------------------------------------------------
-PUT _ml/data_frame/analytics/loganalytics
-{
-  "source": {
-    "index": "logdata"
-  },
-  "dest": {
-    "index": "logdata_out"
-  },
-  "analysis": {
-    "outlier_detection": {
-    }
-  },
-  "analyzed_fields": {
-        "includes": [ "request.bytes", "response.counts.error" ],
-        "excludes": [ "source.geo" ]
-  }
-}
---------------------------------------------------
-// TEST[setup:setup_logdata]
+`analyzed_fields`.`excludes`:::
+(Optional, array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=analyzed-fields-excludes]
 
+`analyzed_fields`.`includes`:::
+(Optional, array)
+include::{docdir}/ml/ml-shared.asciidoc[tag=analyzed-fields-includes]
 
 `description`::
 (Optional, string)
@@ -146,15 +264,9 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit-dfa]
 (object)
 include::{docdir}/ml/ml-shared.asciidoc[tag=source-put-dfa]
 
-`allow_lazy_start`::
-(Optional, boolean) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-start]
-
-
 [[ml-put-dfanalytics-example]]
 ==== {api-examples-title}
 
-
 [[ml-put-dfanalytics-example-preprocess]]
 ===== Preprocessing actions example
 
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 61e862486f12a..767bd134a0967 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -93,22 +93,46 @@ end::analysis-limits[]
 
 tag::analyzed-fields[]
 Specify `includes` and/or `excludes` patterns to select which fields will be 
-included in the analysis. If `analyzed_fields` is not set, only the relevant 
-fields will be included. For example, all the numeric fields for {oldetection}. 
-For the supported field types, see <<ml-put-dfanalytics-supported-fields>>. Also 
-see the <<explain-dfanalytics>> which helps understand field selection.
-
-`includes`:::
-  (Optional, array) An array of strings that defines the fields that will be 
-  included in the analysis.
-  
-`excludes`:::
-  (Optional, array) An array of strings that defines the fields that will be 
-  excluded from the analysis. You do not need to add fields with unsupported 
-  data types to `excludes`, these fields are excluded from the analysis 
-  automatically.
+included in the analysis.
++
+--
+The supported fields for each type of analysis are as follows:
+
+* {oldetection-cap} requires numeric or boolean data to analyze. The algorithms 
+don't support missing values therefore fields that have data types other than 
+numeric or boolean are ignored. Documents where included fields contain missing 
+values, null values, or an array are also ignored. Therefore the `dest` index 
+may contain documents that don't have an {olscore}.
+* {regression-cap} supports fields that are numeric, `boolean`, `text`, `keyword`, 
+and `ip`. It is also tolerant of missing values. Fields that are supported are 
+included in the analysis, other fields are ignored. Documents where included
+fields contain  an array with two or more values are also ignored. Documents in
+the `dest` index  that don’t contain a results field are not included in the
+ {reganalysis}.
+* {classification-cap} supports fields that are numeric, `boolean`, `text`,
+`keyword`, and `ip`. It is also tolerant of missing values. Fields that are 
+supported are included in the analysis, other fields are ignored. Documents
+where included fields contain an array with two or more values are also ignored. 
+Documents in the `dest` index that don’t contain a results field are not
+included in the {classanalysis}. {classanalysis-cap} can be improved by mapping
+ordinal variable values to a  single number. For example, in case of age ranges,
+you can model the values as "0-14" = 0, "15-24" = 1, "25-34" = 2, and so on.
+
+If `analyzed_fields` is not set, only the relevant fields will be included. For
+example, all the numeric fields for {oldetection}. For more information about
+field selection, see <<explain-dfanalytics>>.
+--
 end::analyzed-fields[]
 
+tag::analyzed-fields-excludes[]
+An array of strings that defines the fields that will be excluded from the
+analysis. You do not need to add fields with unsupported data types to
+`excludes`, these fields are excluded from the analysis automatically.
+end::analyzed-fields-excludes[]
+
+tag::analyzed-fields-includes[]
+An array of strings that defines the fields that will be included in the analysis.
+end::analyzed-fields-includes[]
 
 tag::background-persist-interval[]
 Advanced configuration option. The time between each periodic persistence of the 
@@ -513,11 +537,11 @@ identifier when you want to update a specific detector.
 end::detector-index[]
 
 tag::eta[]
-The shrinkage applied to the weights. Smaller values result 
-in larger forests which have better generalization error. However, the smaller 
-the value the longer the training will take. For more information, see 
-https://en.wikipedia.org/wiki/Gradient_boosting#Shrinkage[this wiki article] 
-about shrinkage.
+Advanced configuration option. The shrinkage applied to the weights. Smaller
+values result in larger forests which have better generalization error. However,
+the smaller the value the longer the training will take. For more information
+about shrinkage, see
+https://en.wikipedia.org/wiki/Gradient_boosting#Shrinkage[this wiki article].
 end::eta[]
 
 tag::exclude-frequent[]
@@ -534,8 +558,8 @@ included.
 end::exclude-interim-results[]
 
 tag::feature-bag-fraction[]
-Defines the fraction of features that will be used when 
-selecting a random bag for each candidate split. 
+Advanced configuration option. Defines the fraction of features that will be
+used when selecting a random bag for each candidate split. 
 end::feature-bag-fraction[]
 
 tag::feature-influence-threshold[]
@@ -596,10 +620,10 @@ The analysis function that is used. For example, `count`, `rare`, `mean`, `min`,
 end::function[]
 
 tag::gamma[]
-Regularization parameter to prevent overfitting on the 
-training dataset. Multiplies a linear penalty associated with the size of 
+Advanced configuration option. Regularization parameter to prevent overfitting
+on the training dataset. Multiplies a linear penalty associated with the size of 
 individual trees in the forest. The higher the value the more training will 
-prefer smaller trees. The smaller this parameter the larger individual trees 
+prefer smaller trees. The smaller this parameter the larger individual trees
 will be and the longer train will take.
 end::gamma[]
 
@@ -688,10 +712,10 @@ The unique identifier for the job to which the {dfeed} sends data.
 end::job-id-datafeed[]
 
 tag::lambda[]
-Regularization parameter to prevent overfitting on the 
-training dataset. Multiplies an L2 regularisation term which applies to leaf 
-weights of the individual trees in the forest. The higher the value the more 
-training will attempt to keep leaf weights small. This makes the prediction  
+Advanced configuration option. Regularization parameter to prevent overfitting
+on the training dataset. Multiplies an L2 regularisation term which applies to
+leaf weights of the individual trees in the forest. The higher the value the
+more training will attempt to keep leaf weights small. This makes the prediction  
 function smoother at the expense of potentially not being able to capture 
 relevant relationships between the features and the {depvar}. The smaller this 
 parameter the larger individual trees will be and the longer train will take.
@@ -720,8 +744,8 @@ until it is explicitly stopped. By default this setting is not set.
 end::max-empty-searches[]
 
 tag::maximum-number-trees[]
-Defines the maximum number of trees the forest is allowed 
-to contain. The maximum value is 2000.
+Advanced configuration option. Defines the maximum number of trees the forest is
+allowed to contain. The maximum value is 2000.
 end::maximum-number-trees[]
 
 tag::memory-estimation[]
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 803e3f112c5d5..cf8ab0b29f59f 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -299,3 +299,9 @@ See <<ml-get-bucket>>,
 <<ml-get-category>>, and
 [[ml-results-overall-buckets]]
 <<ml-get-overall-buckets>>.
+
+[role="exclude",id="ml-dfa-analysis-objects"]
+=== Analysis configuration objects
+
+This page was deleted. 
+See <<put-dfanalytics>>.
\ No newline at end of file
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index 85ffbae5925fd..d37d6dda8ee82 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -2,13 +2,10 @@
 [[api-definitions]]
 == Definitions
 
-These resource definitions are used in APIs related to {ml-features} and
-{security-features} and in {kib} advanced {ml} job configuration options.
+The role mappings resource definition you can find below is used in APIs related 
+to security features.
 
+  * <<role-mapping-resources,Role mappings>>
 
-* <<ml-dfa-analysis-objects>>
-* <<role-mapping-resources,Role mappings>>
 
-
-include::{es-repo-dir}/ml/df-analytics/apis/analysisobjects.asciidoc[]
 include::{xes-repo-dir}/rest-api/security/role-mapping-resources.asciidoc[]

From c093f7f623e6b64bf2485e7ead3f95e3eca89aa4 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 9 Jan 2020 14:06:19 +0100
Subject: [PATCH 476/686] Mute TimeSeriesLifecycleActionsIT.testWaitForSnapshot
 (#50790)

This one is failing a lot => mute
Relates #50781
---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 31bfd8c9203f5..cf96d99f7429a 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -326,6 +326,7 @@ public void testAllocateActionOnlyReplicas() throws Exception {
         });
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50781")
     public void testWaitForSnapshot() throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
@@ -360,7 +361,7 @@ public void testWaitForSnapshotSlmExecutedBefore() throws Exception {
         updatePolicy(index, policy);
         assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("wait_for_snapshot")));
         assertBusy(() -> assertThat(getStepKeyForIndex(index).getName(), equalTo("wait-for-snapshot")));
-        
+
         request = new Request("PUT", "/_slm/policy/slm/_execute");
         assertOK(client().performRequest(request));
 

From 6b9eba0dc21d452251f0cc69ca3323a4799b0935 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Thu, 9 Jan 2020 09:22:51 -0500
Subject: [PATCH 477/686] [ML][Inference][HLRC] Add necessary lang ident
 classes (#50705)

This adds the necessary named XContent classes to the HLRC for the lang ident model. This is so the HLRC can call `GET _ml/inference/lang_ident_model_1?include_definition=true` without XContent parsing errors.

The constructors are package private as since this classes are used exclusively within the pre-packaged model (and require the specific weights, etc. to be of any use).
---
 .../MlInferenceNamedXContentProvider.java     |   7 +
 .../preprocessing/CustomWordEmbedding.java    | 166 ++++++++++++++++++
 .../langident/LangIdentNeuralNetwork.java     | 108 ++++++++++++
 .../trainedmodel/langident/LangNetLayer.java  | 123 +++++++++++++
 .../client/MachineLearningIT.java             |  17 ++
 .../client/RestHighLevelClientTests.java      |  12 +-
 .../CustomWordEmbeddingTests.java             |  64 +++++++
 .../LangIdentNeuralNetworkTests.java          |  57 ++++++
 .../langident/LangNetLayerTests.java          |  55 ++++++
 .../xpack/ml/integration/TrainedModelIT.java  |  10 ++
 10 files changed, 614 insertions(+), 5 deletions(-)
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/preprocessing/CustomWordEmbedding.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangNetLayer.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/preprocessing/CustomWordEmbeddingTests.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangIdentNeuralNetworkTests.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangNetLayerTests.java

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/MlInferenceNamedXContentProvider.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/MlInferenceNamedXContentProvider.java
index 6b7fb6d3cd17c..0be0e8f6c588b 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/MlInferenceNamedXContentProvider.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/MlInferenceNamedXContentProvider.java
@@ -18,12 +18,14 @@
  */
 package org.elasticsearch.client.ml.inference;
 
+import org.elasticsearch.client.ml.inference.preprocessing.CustomWordEmbedding;
 import org.elasticsearch.client.ml.inference.trainedmodel.TrainedModel;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.Ensemble;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.LogisticRegression;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.OutputAggregator;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedMode;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedSum;
+import org.elasticsearch.client.ml.inference.trainedmodel.langident.LangIdentNeuralNetwork;
 import org.elasticsearch.client.ml.inference.trainedmodel.tree.Tree;
 import org.elasticsearch.client.ml.inference.preprocessing.FrequencyEncoding;
 import org.elasticsearch.client.ml.inference.preprocessing.OneHotEncoding;
@@ -49,10 +51,15 @@ public List<NamedXContentRegistry.Entry> getNamedXContentParsers() {
             TargetMeanEncoding::fromXContent));
         namedXContent.add(new NamedXContentRegistry.Entry(PreProcessor.class, new ParseField(FrequencyEncoding.NAME),
             FrequencyEncoding::fromXContent));
+        namedXContent.add(new NamedXContentRegistry.Entry(PreProcessor.class, new ParseField(CustomWordEmbedding.NAME),
+            CustomWordEmbedding::fromXContent));
 
         // Model
         namedXContent.add(new NamedXContentRegistry.Entry(TrainedModel.class, new ParseField(Tree.NAME), Tree::fromXContent));
         namedXContent.add(new NamedXContentRegistry.Entry(TrainedModel.class, new ParseField(Ensemble.NAME), Ensemble::fromXContent));
+        namedXContent.add(new NamedXContentRegistry.Entry(TrainedModel.class,
+            new ParseField(LangIdentNeuralNetwork.NAME),
+            LangIdentNeuralNetwork::fromXContent));
 
         // Aggregating output
         namedXContent.add(new NamedXContentRegistry.Entry(OutputAggregator.class,
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/preprocessing/CustomWordEmbedding.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/preprocessing/CustomWordEmbedding.java
new file mode 100644
index 0000000000000..841f715321b8a
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/preprocessing/CustomWordEmbedding.java
@@ -0,0 +1,166 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.inference.preprocessing;
+
+import org.elasticsearch.common.CheckedFunction;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * This is a pre-processor that embeds text into a numerical vector.
+ *
+ * It calculates a set of features based on script type, ngram hashes, and most common script values.
+ *
+ * The features are then concatenated with specific quantization scales and weights into a vector of length 80.
+ *
+ * This is a fork and a port of: https://github.com/google/cld3/blob/06f695f1c8ee530104416aab5dcf2d6a1414a56a/src/embedding_network.cc
+ */
+public class CustomWordEmbedding implements PreProcessor {
+
+    public static final String NAME = "custom_word_embedding";
+    static final ParseField FIELD = new ParseField("field");
+    static final ParseField DEST_FIELD = new ParseField("dest_field");
+    static final ParseField EMBEDDING_WEIGHTS = new ParseField("embedding_weights");
+    static final ParseField EMBEDDING_QUANT_SCALES = new ParseField("embedding_quant_scales");
+
+    public static final ConstructingObjectParser<CustomWordEmbedding, Void> PARSER = new ConstructingObjectParser<>(
+        NAME,
+        true,
+        a -> new CustomWordEmbedding((short[][])a[0], (byte[][])a[1], (String)a[2], (String)a[3]));
+    static {
+        PARSER.declareField(ConstructingObjectParser.constructorArg(),
+            (p, c) -> {
+                List<List<Short>> listOfListOfShorts = parseArrays(EMBEDDING_QUANT_SCALES.getPreferredName(),
+                    XContentParser::shortValue,
+                    p);
+                short[][] primitiveShorts = new short[listOfListOfShorts.size()][];
+                int i = 0;
+                for (List<Short> shorts : listOfListOfShorts) {
+                    short[] innerShorts = new short[shorts.size()];
+                    for (int j = 0; j < shorts.size(); j++) {
+                        innerShorts[j] = shorts.get(j);
+                    }
+                    primitiveShorts[i++] = innerShorts;
+                }
+                return primitiveShorts;
+            },
+            EMBEDDING_QUANT_SCALES,
+            ObjectParser.ValueType.VALUE_ARRAY);
+        PARSER.declareField(ConstructingObjectParser.constructorArg(),
+            (p, c) -> {
+                List<byte[]> values = new ArrayList<>();
+                while(p.nextToken() != XContentParser.Token.END_ARRAY) {
+                    values.add(p.binaryValue());
+                }
+                byte[][] primitiveBytes = new byte[values.size()][];
+                int i = 0;
+                for (byte[] bytes : values) {
+                    primitiveBytes[i++] = bytes;
+                }
+                return primitiveBytes;
+            },
+            EMBEDDING_WEIGHTS,
+            ObjectParser.ValueType.VALUE_ARRAY);
+        PARSER.declareString(ConstructingObjectParser.constructorArg(), FIELD);
+        PARSER.declareString(ConstructingObjectParser.constructorArg(), DEST_FIELD);
+    }
+
+    private static <T> List<List<T>> parseArrays(String fieldName,
+                                                 CheckedFunction<XContentParser, T, IOException> fromParser,
+                                                 XContentParser p) throws IOException {
+        if (p.currentToken() != XContentParser.Token.START_ARRAY) {
+            throw new IllegalArgumentException("unexpected token [" + p.currentToken() + "] for [" + fieldName + "]");
+        }
+        List<List<T>> values = new ArrayList<>();
+        while(p.nextToken() != XContentParser.Token.END_ARRAY) {
+            if (p.currentToken() != XContentParser.Token.START_ARRAY) {
+                throw new IllegalArgumentException("unexpected token [" + p.currentToken() + "] for [" + fieldName + "]");
+            }
+            List<T> innerList = new ArrayList<>();
+            while(p.nextToken() != XContentParser.Token.END_ARRAY) {
+                if(p.currentToken().isValue() == false) {
+                    throw new IllegalStateException("expected non-null value but got [" + p.currentToken() + "] " +
+                        "for [" + fieldName + "]");
+                }
+                innerList.add(fromParser.apply(p));
+            }
+            values.add(innerList);
+        }
+        return values;
+    }
+
+    public static CustomWordEmbedding fromXContent(XContentParser parser) {
+        return PARSER.apply(parser, null);
+    }
+
+    private final short[][] embeddingsQuantScales;
+    private final byte[][] embeddingsWeights;
+    private final String fieldName;
+    private final String destField;
+
+    CustomWordEmbedding(short[][] embeddingsQuantScales, byte[][] embeddingsWeights, String fieldName, String destField) {
+        this.embeddingsQuantScales = embeddingsQuantScales;
+        this.embeddingsWeights = embeddingsWeights;
+        this.fieldName = fieldName;
+        this.destField = destField;
+    }
+
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, ToXContent.Params params) throws IOException {
+        builder.startObject();
+        builder.field(FIELD.getPreferredName(), fieldName);
+        builder.field(DEST_FIELD.getPreferredName(), destField);
+        builder.field(EMBEDDING_QUANT_SCALES.getPreferredName(), embeddingsQuantScales);
+        builder.field(EMBEDDING_WEIGHTS.getPreferredName(), embeddingsWeights);
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        CustomWordEmbedding that = (CustomWordEmbedding) o;
+        return Objects.equals(fieldName, that.fieldName)
+            && Objects.equals(destField, that.destField)
+            && Arrays.deepEquals(embeddingsWeights, that.embeddingsWeights)
+            && Arrays.deepEquals(embeddingsQuantScales, that.embeddingsQuantScales);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(fieldName, destField, Arrays.deepHashCode(embeddingsQuantScales), Arrays.deepHashCode(embeddingsWeights));
+    }
+
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
new file mode 100644
index 0000000000000..85beea293d247
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
@@ -0,0 +1,108 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.inference.trainedmodel.langident;
+
+import org.elasticsearch.client.ml.inference.trainedmodel.TrainedModel;
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
+/**
+ * Shallow, fully connected, feed forward NN modeled after and ported from https://github.com/google/cld3
+ */
+public class LangIdentNeuralNetwork implements TrainedModel {
+
+    public static final String NAME = "lang_ident_neural_network";
+    public static final ParseField EMBEDDED_VECTOR_FEATURE_NAME = new ParseField("embedded_vector_feature_name");
+    public static final ParseField HIDDEN_LAYER = new ParseField("hidden_layer");
+    public static final ParseField SOFTMAX_LAYER = new ParseField("softmax_layer");
+    public static final ConstructingObjectParser<LangIdentNeuralNetwork, Void> PARSER = new ConstructingObjectParser<>(
+        NAME,
+        true,
+        a -> new LangIdentNeuralNetwork((String) a[0],
+            (LangNetLayer) a[1],
+            (LangNetLayer) a[2]));
+
+    static {
+        PARSER.declareString(constructorArg(), EMBEDDED_VECTOR_FEATURE_NAME);
+        PARSER.declareObject(constructorArg(), LangNetLayer.PARSER::apply, HIDDEN_LAYER);
+        PARSER.declareObject(constructorArg(), LangNetLayer.PARSER::apply, SOFTMAX_LAYER);
+    }
+
+    public static LangIdentNeuralNetwork fromXContent(XContentParser parser) {
+        return PARSER.apply(parser, null);
+    }
+
+    private final LangNetLayer hiddenLayer;
+    private final LangNetLayer softmaxLayer;
+    private final String embeddedVectorFeatureName;
+
+    LangIdentNeuralNetwork(String embeddedVectorFeatureName,
+                                  LangNetLayer hiddenLayer,
+                                  LangNetLayer softmaxLayer) {
+        this.embeddedVectorFeatureName = embeddedVectorFeatureName;
+        this.hiddenLayer = hiddenLayer;
+        this.softmaxLayer = softmaxLayer;
+    }
+
+    @Override
+    public List<String> getFeatureNames() {
+        return Collections.singletonList(embeddedVectorFeatureName);
+    }
+
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, ToXContent.Params params) throws IOException {
+        builder.startObject();
+        builder.field(EMBEDDED_VECTOR_FEATURE_NAME.getPreferredName(), embeddedVectorFeatureName);
+        builder.field(HIDDEN_LAYER.getPreferredName(), hiddenLayer);
+        builder.field(SOFTMAX_LAYER.getPreferredName(), softmaxLayer);
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        LangIdentNeuralNetwork that = (LangIdentNeuralNetwork) o;
+        return Objects.equals(embeddedVectorFeatureName, that.embeddedVectorFeatureName)
+            && Objects.equals(hiddenLayer, that.hiddenLayer)
+            && Objects.equals(softmaxLayer, that.softmaxLayer);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(embeddedVectorFeatureName, hiddenLayer, softmaxLayer);
+    }
+
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangNetLayer.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangNetLayer.java
new file mode 100644
index 0000000000000..d129e81eee3b7
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangNetLayer.java
@@ -0,0 +1,123 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.inference.trainedmodel.langident;
+
+import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Objects;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
+/**
+ * Represents a single layer in the compressed Lang Net
+ */
+public class LangNetLayer implements ToXContentObject {
+
+    public static final ParseField NAME = new ParseField("lang_net_layer");
+
+    private static final ParseField NUM_ROWS = new ParseField("num_rows");
+    private static final ParseField NUM_COLS = new ParseField("num_cols");
+    private static final ParseField WEIGHTS = new ParseField("weights");
+    private static final ParseField BIAS = new ParseField("bias");
+
+    @SuppressWarnings("unchecked")
+    public static final ConstructingObjectParser<LangNetLayer, Void> PARSER = new ConstructingObjectParser<>(
+        NAME.getPreferredName(),
+        true,
+        a -> new LangNetLayer(
+            (List<Double>) a[0],
+            (int) a[1],
+            (int) a[2],
+            (List<Double>) a[3]));
+
+    static {
+        PARSER.declareDoubleArray(constructorArg(), WEIGHTS);
+        PARSER.declareInt(constructorArg(), NUM_COLS);
+        PARSER.declareInt(constructorArg(), NUM_ROWS);
+        PARSER.declareDoubleArray(constructorArg(), BIAS);
+    }
+
+    private final double[] weights;
+    private final int weightRows;
+    private final int weightCols;
+    private final double[] bias;
+
+    private LangNetLayer(List<Double> weights, int numCols, int numRows, List<Double> bias) {
+        this(weights.stream().mapToDouble(Double::doubleValue).toArray(),
+            numCols,
+            numRows,
+            bias.stream().mapToDouble(Double::doubleValue).toArray());
+    }
+
+    LangNetLayer(double[] weights, int numCols, int numRows, double[] bias) {
+        this.weights = weights;
+        this.weightCols = numCols;
+        this.weightRows = numRows;
+        this.bias = bias;
+    }
+
+    double[] getWeights() {
+        return weights;
+    }
+
+    int getWeightRows() {
+        return weightRows;
+    }
+
+    int getWeightCols() {
+        return weightCols;
+    }
+
+    double[] getBias() {
+        return bias;
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.field(NUM_COLS.getPreferredName(), weightCols);
+        builder.field(NUM_ROWS.getPreferredName(), weightRows);
+        builder.field(WEIGHTS.getPreferredName(), weights);
+        builder.field(BIAS.getPreferredName(), bias);
+        builder.endObject();
+        return builder;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        LangNetLayer that = (LangNetLayer) o;
+        return Arrays.equals(weights, that.weights)
+            && Arrays.equals(bias, that.bias)
+            && Objects.equals(weightCols, that.weightCols)
+            && Objects.equals(weightRows, that.weightRows);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(Arrays.hashCode(weights), Arrays.hashCode(bias), weightCols, weightRows);
+    }
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index 0985cf4fd91a6..547521a089cc6 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -151,6 +151,7 @@
 import org.elasticsearch.client.ml.inference.TrainedModelDefinitionTests;
 import org.elasticsearch.client.ml.inference.TrainedModelStats;
 import org.elasticsearch.client.ml.inference.trainedmodel.TargetType;
+import org.elasticsearch.client.ml.inference.trainedmodel.langident.LangIdentNeuralNetwork;
 import org.elasticsearch.client.ml.job.config.AnalysisConfig;
 import org.elasticsearch.client.ml.job.config.DataDescription;
 import org.elasticsearch.client.ml.job.config.Detector;
@@ -201,6 +202,7 @@
 import static org.hamcrest.Matchers.hasItem;
 import static org.hamcrest.Matchers.hasItems;
 import static org.hamcrest.Matchers.hasSize;
+import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.lessThan;
 import static org.hamcrest.Matchers.not;
@@ -2278,6 +2280,21 @@ public void testDeleteTrainedModel() throws Exception {
         assertThat(getTrainedModelsResponse.getTrainedModels(), hasSize(0));
     }
 
+    public void testGetPrepackagedModels() throws Exception {
+        MachineLearningClient machineLearningClient = highLevelClient().machineLearning();
+
+        GetTrainedModelsResponse getTrainedModelsResponse = execute(
+            new GetTrainedModelsRequest("lang_ident_model_1").setIncludeDefinition(true),
+            machineLearningClient::getTrainedModels,
+            machineLearningClient::getTrainedModelsAsync);
+
+        assertThat(getTrainedModelsResponse.getCount(), equalTo(1L));
+        assertThat(getTrainedModelsResponse.getTrainedModels(), hasSize(1));
+        assertThat(getTrainedModelsResponse.getTrainedModels().get(0).getModelId(), equalTo("lang_ident_model_1"));
+        assertThat(getTrainedModelsResponse.getTrainedModels().get(0).getDefinition().getTrainedModel(),
+            instanceOf(LangIdentNeuralNetwork.class));
+    }
+
     public void testPutFilter() throws Exception {
         String filterId = "filter-job-test";
         MlFilter mlFilter = MlFilter.builder(filterId)
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
index b3457eedb5569..4ec048ad1e4f5 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
@@ -68,6 +68,7 @@
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.ConfusionMatrixMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.PrecisionMetric;
 import org.elasticsearch.client.ml.dataframe.evaluation.softclassification.RecallMetric;
+import org.elasticsearch.client.ml.inference.preprocessing.CustomWordEmbedding;
 import org.elasticsearch.client.ml.inference.preprocessing.FrequencyEncoding;
 import org.elasticsearch.client.ml.inference.preprocessing.OneHotEncoding;
 import org.elasticsearch.client.ml.inference.preprocessing.TargetMeanEncoding;
@@ -75,6 +76,7 @@
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.LogisticRegression;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedMode;
 import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedSum;
+import org.elasticsearch.client.ml.inference.trainedmodel.langident.LangIdentNeuralNetwork;
 import org.elasticsearch.client.ml.inference.trainedmodel.tree.Tree;
 import org.elasticsearch.client.transform.transforms.SyncConfig;
 import org.elasticsearch.client.transform.transforms.TimeSyncConfig;
@@ -688,7 +690,7 @@ public void testDefaultNamedXContents() {
 
     public void testProvidedNamedXContents() {
         List<NamedXContentRegistry.Entry> namedXContents = RestHighLevelClient.getProvidedNamedXContents();
-        assertEquals(55, namedXContents.size());
+        assertEquals(57, namedXContents.size());
         Map<Class<?>, Integer> categories = new HashMap<>();
         List<String> names = new ArrayList<>();
         for (NamedXContentRegistry.Entry namedXContent : namedXContents) {
@@ -760,10 +762,10 @@ public void testProvidedNamedXContents() {
                 registeredMetricName(Classification.NAME, MulticlassConfusionMatrixMetric.NAME),
                 registeredMetricName(Regression.NAME, MeanSquaredErrorMetric.NAME),
                 registeredMetricName(Regression.NAME, RSquaredMetric.NAME)));
-        assertEquals(Integer.valueOf(3), categories.get(org.elasticsearch.client.ml.inference.preprocessing.PreProcessor.class));
-        assertThat(names, hasItems(FrequencyEncoding.NAME, OneHotEncoding.NAME, TargetMeanEncoding.NAME));
-        assertEquals(Integer.valueOf(2), categories.get(org.elasticsearch.client.ml.inference.trainedmodel.TrainedModel.class));
-        assertThat(names, hasItems(Tree.NAME, Ensemble.NAME));
+        assertEquals(Integer.valueOf(4), categories.get(org.elasticsearch.client.ml.inference.preprocessing.PreProcessor.class));
+        assertThat(names, hasItems(FrequencyEncoding.NAME, OneHotEncoding.NAME, TargetMeanEncoding.NAME, CustomWordEmbedding.NAME));
+        assertEquals(Integer.valueOf(3), categories.get(org.elasticsearch.client.ml.inference.trainedmodel.TrainedModel.class));
+        assertThat(names, hasItems(Tree.NAME, Ensemble.NAME, LangIdentNeuralNetwork.NAME));
         assertEquals(Integer.valueOf(3),
             categories.get(org.elasticsearch.client.ml.inference.trainedmodel.ensemble.OutputAggregator.class));
         assertThat(names, hasItems(WeightedMode.NAME, WeightedSum.NAME, LogisticRegression.NAME));
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/preprocessing/CustomWordEmbeddingTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/preprocessing/CustomWordEmbeddingTests.java
new file mode 100644
index 0000000000000..f71dcc1f8566d
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/preprocessing/CustomWordEmbeddingTests.java
@@ -0,0 +1,64 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.inference.preprocessing;
+
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+
+import java.io.IOException;
+
+
+public class CustomWordEmbeddingTests extends AbstractXContentTestCase<CustomWordEmbedding> {
+
+    @Override
+    protected CustomWordEmbedding doParseInstance(XContentParser parser) throws IOException {
+        return CustomWordEmbedding.fromXContent(parser);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+
+    @Override
+    protected CustomWordEmbedding createTestInstance() {
+        return createRandom();
+    }
+
+    public static CustomWordEmbedding createRandom() {
+        int quantileSize = randomIntBetween(1, 10);
+        int internalQuantSize = randomIntBetween(1, 10);
+        short[][] quantiles = new short[quantileSize][internalQuantSize];
+        for (int i = 0; i < quantileSize; i++) {
+            for (int j = 0; j < internalQuantSize; j++) {
+                quantiles[i][j] = randomShort();
+            }
+        }
+        int weightsSize = randomIntBetween(1, 10);
+        int internalWeightsSize = randomIntBetween(1, 10);
+        byte[][] weights = new byte[weightsSize][internalWeightsSize];
+        for (int i = 0; i < weightsSize; i++) {
+            for (int j = 0; j < internalWeightsSize; j++) {
+                weights[i][j] = randomByte();
+            }
+        }
+        return new CustomWordEmbedding(quantiles, weights, randomAlphaOfLength(10), randomAlphaOfLength(10));
+    }
+
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangIdentNeuralNetworkTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangIdentNeuralNetworkTests.java
new file mode 100644
index 0000000000000..3ad262dc7a1a6
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangIdentNeuralNetworkTests.java
@@ -0,0 +1,57 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.inference.trainedmodel.langident;
+
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
+
+import java.io.IOException;
+
+
+public class LangIdentNeuralNetworkTests extends AbstractXContentTestCase<LangIdentNeuralNetwork> {
+
+    @Override
+    protected LangIdentNeuralNetwork doParseInstance(XContentParser parser) throws IOException {
+        return LangIdentNeuralNetwork.fromXContent(parser);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+
+    @Override
+    protected LangIdentNeuralNetwork createTestInstance() {
+        return createRandom();
+    }
+
+    public static LangIdentNeuralNetwork createRandom() {
+        return new LangIdentNeuralNetwork(randomAlphaOfLength(10),
+            LangNetLayerTests.createRandom(),
+            LangNetLayerTests.createRandom());
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
+
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangNetLayerTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangNetLayerTests.java
new file mode 100644
index 0000000000000..cb52ff15c9f85
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/langident/LangNetLayerTests.java
@@ -0,0 +1,55 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.inference.trainedmodel.langident;
+
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+import org.elasticsearch.test.ESTestCase;
+
+import java.io.IOException;
+import java.util.stream.Stream;
+
+
+public class LangNetLayerTests extends AbstractXContentTestCase<LangNetLayer> {
+
+    @Override
+    protected LangNetLayer doParseInstance(XContentParser parser) throws IOException {
+        return LangNetLayer.PARSER.apply(parser, null);
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return true;
+    }
+
+    @Override
+    protected LangNetLayer createTestInstance() {
+        return createRandom();
+    }
+
+    public static LangNetLayer createRandom() {
+        int numWeights = randomIntBetween(1, 1000);
+        return new LangNetLayer(
+            Stream.generate(ESTestCase::randomDouble).limit(numWeights).mapToDouble(Double::doubleValue).toArray(),
+            numWeights,
+            1,
+            Stream.generate(ESTestCase::randomDouble).limit(numWeights).mapToDouble(Double::doubleValue).toArray());
+    }
+
+}
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
index 5911732257e6a..72c677d1aa40d 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
@@ -198,6 +198,16 @@ public void testDeleteTrainedModels() throws IOException {
         assertThat(responseException.getResponse().getStatusLine().getStatusCode(), equalTo(404));
     }
 
+    public void testGetPrePackagedModels() throws IOException {
+        Response getModel = client().performRequest(new Request("GET",
+            MachineLearning.BASE_PATH + "inference/lang_ident_model_1?human=true&include_model_definition=true"));
+
+        assertThat(getModel.getStatusLine().getStatusCode(), equalTo(200));
+        String response = EntityUtils.toString(getModel.getEntity());
+        assertThat(response, containsString("lang_ident_model_1"));
+        assertThat(response, containsString("\"definition\""));
+    }
+
     private static String buildRegressionModel(String modelId) throws IOException {
         try(XContentBuilder builder = XContentFactory.jsonBuilder()) {
             TrainedModelConfig.builder()

From dcbe7bbadaae95c09ed16f2883c804b0bb7bbb6b Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 9 Jan 2020 15:31:21 +0100
Subject: [PATCH 478/686] Fix Snapshot Repository Corruption in Downgrade
 Scenarios (#50692)

This PR introduces test infrastructure for downgrading a cluster while interacting with a given repository.
It fixes the fact that repository metadata in the new format could be written while there's still older snapshots in the repository that require the old-format metadata to be restorable.
---
 qa/repository-multi-version/build.gradle      | 122 ++++++++
 .../MultiVersionRepositoryAccessIT.java       | 269 ++++++++++++++++++
 .../TransportCleanupRepositoryAction.java     |  12 +-
 .../repositories/RepositoryData.java          |  15 +
 .../snapshots/SnapshotsService.java           |  37 ++-
 .../CorruptedBlobStoreRepositoryIT.java       |  47 +++
 .../snapshots/SnapshotResiliencyTests.java    |   2 +-
 .../test/rest/ESRestTestCase.java             |   8 +-
 8 files changed, 503 insertions(+), 9 deletions(-)
 create mode 100644 qa/repository-multi-version/build.gradle
 create mode 100644 qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java

diff --git a/qa/repository-multi-version/build.gradle b/qa/repository-multi-version/build.gradle
new file mode 100644
index 0000000000000..ed062e59eee1a
--- /dev/null
+++ b/qa/repository-multi-version/build.gradle
@@ -0,0 +1,122 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import org.elasticsearch.gradle.Version
+import org.elasticsearch.gradle.info.BuildParams
+import org.elasticsearch.gradle.testclusters.RestTestRunnerTask
+
+apply plugin: 'elasticsearch.testclusters'
+apply plugin: 'elasticsearch.standalone-test'
+
+tasks.register("bwcTest") {
+  description = 'Runs backwards compatibility tests.'
+  group = 'verification'
+}
+
+dependencies {
+  testCompile project(':client:rest-high-level')
+}
+
+for (Version bwcVersion : bwcVersions.indexCompatible) {
+  String baseName = "v${bwcVersion}"
+  String oldClusterName = "${baseName}-old"
+  String newClusterName = "${baseName}-new"
+
+  def clusterSettings = { v ->
+    return {
+      version = v
+      numberOfNodes = 2
+      setting 'path.repo', "${buildDir}/cluster/shared/repo/${baseName}"
+      javaHome = BuildParams.runtimeJavaHome
+    }
+  }
+
+  testClusters {
+    "${oldClusterName}" clusterSettings(bwcVersion.toString())
+    "${newClusterName}" clusterSettings(project.version)
+  }
+
+  tasks.register("${baseName}#Step1OldClusterTest", RestTestRunnerTask) {
+    useCluster testClusters."${oldClusterName}"
+    mustRunAfter(precommit)
+    doFirst {
+      project.delete("${buildDir}/cluster/shared/repo/${baseName}")
+    }
+    systemProperty 'tests.rest.suite', 'step1'
+  }
+
+  tasks.register("${baseName}#Step2NewClusterTest", RestTestRunnerTask) {
+    useCluster testClusters."${newClusterName}"
+    dependsOn "${baseName}#Step1OldClusterTest"
+    systemProperty 'tests.rest.suite', 'step2'
+  }
+
+  tasks.register("${baseName}#Step3OldClusterTest", RestTestRunnerTask) {
+    useCluster testClusters."${oldClusterName}"
+    dependsOn "${baseName}#Step2NewClusterTest"
+    systemProperty 'tests.rest.suite', 'step3'
+  }
+
+  tasks.register("${baseName}#Step4NewClusterTest", RestTestRunnerTask) {
+    useCluster testClusters."${newClusterName}"
+    dependsOn "${baseName}#Step3OldClusterTest"
+    systemProperty 'tests.rest.suite', 'step4'
+  }
+
+  tasks.matching { it.name.startsWith(baseName) && it.name.endsWith("ClusterTest") }.configureEach {
+    it.systemProperty 'tests.old_cluster_version', bwcVersion.toString().minus("-SNAPSHOT")
+    it.systemProperty 'tests.path.repo', "${buildDir}/cluster/shared/repo/${baseName}"
+    def clusterName = it.name.contains("Step2") || it.name.contains("Step4") ? "${newClusterName}" : "${oldClusterName}"
+    it.nonInputProperties.systemProperty('tests.rest.cluster', "${-> testClusters."${clusterName}".allHttpSocketURI.join(",")}")
+    it.nonInputProperties.systemProperty('tests.clustername', "${-> testClusters."${clusterName}".getName()}")
+  }
+
+  if (project.bwc_tests_enabled) {
+    bwcTest.dependsOn(
+      tasks.register("${baseName}#bwcTest") {
+        dependsOn tasks.named("${baseName}#Step4NewClusterTest")
+      }
+    )
+  }
+}
+
+task bwcTestSnapshots {
+  if (project.bwc_tests_enabled) {
+    for (final def version : bwcVersions.unreleasedIndexCompatible) {
+      dependsOn "v${version}#bwcTest"
+    }
+  }
+}
+
+check.dependsOn(bwcTestSnapshots)
+
+configurations {
+  testArtifacts.extendsFrom testRuntime
+}
+
+task testJar(type: Jar) {
+  appendix 'test'
+  from sourceSets.test.output
+}
+
+artifacts {
+  testArtifacts testJar
+}
+
+test.enabled = false
diff --git a/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java b/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
new file mode 100644
index 0000000000000..f3effc8c01bec
--- /dev/null
+++ b/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
@@ -0,0 +1,269 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.upgrades;
+
+import org.elasticsearch.action.admin.cluster.repositories.put.PutRepositoryRequest;
+import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotRequest;
+import org.elasticsearch.action.admin.cluster.snapshots.delete.DeleteSnapshotRequest;
+import org.elasticsearch.action.admin.cluster.snapshots.restore.RestoreSnapshotRequest;
+import org.elasticsearch.action.admin.cluster.snapshots.status.SnapshotStatus;
+import org.elasticsearch.action.admin.cluster.snapshots.status.SnapshotsStatusRequest;
+import org.elasticsearch.action.admin.cluster.snapshots.status.SnapshotsStatusResponse;
+import org.elasticsearch.client.Node;
+import org.elasticsearch.client.Request;
+import org.elasticsearch.client.RequestOptions;
+import org.elasticsearch.client.Response;
+import org.elasticsearch.client.RestClient;
+import org.elasticsearch.client.RestHighLevelClient;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.DeprecationHandler;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.snapshots.RestoreInfo;
+import org.elasticsearch.test.rest.ESRestTestCase;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.hasItem;
+import static org.hamcrest.Matchers.hasSize;
+import static org.hamcrest.Matchers.is;
+
+/**
+ * Tests that verify that a snapshot repository is not getting corrupted and continues to function properly when accessed by multiple
+ * clusters of different versions. Concretely this test suite is simulating the following scenario:
+ * <ul>
+ *     <li>Start and run against a cluster in an old version: {@link TestStep#STEP1_OLD_CLUSTER}</li>
+ *     <li>Start and run against a cluster running the current version: {@link TestStep#STEP2_NEW_CLUSTER}</li>
+ *     <li>Run against the old version cluster from the first step: {@link TestStep#STEP3_OLD_CLUSTER}</li>
+ *     <li>Run against the current version cluster from the second step: {@link TestStep#STEP4_NEW_CLUSTER}</li>
+ * </ul>
+ * TODO: Add two more steps: delete all old version snapshots from the repository, then downgrade again and verify that the repository
+ *       is not being corrupted. This requires first merging the logic for reading the min_version field in RepositoryData back to 7.6.
+ */
+public class MultiVersionRepositoryAccessIT extends ESRestTestCase {
+
+    private enum TestStep {
+        STEP1_OLD_CLUSTER("step1"),
+        STEP2_NEW_CLUSTER("step2"),
+        STEP3_OLD_CLUSTER("step3"),
+        STEP4_NEW_CLUSTER("step4");
+
+        private final String name;
+
+        TestStep(String name) {
+            this.name = name;
+        }
+
+        @Override
+        public String toString() {
+            return name;
+        }
+
+        public static TestStep parse(String value) {
+            switch (value) {
+                case "step1":
+                    return STEP1_OLD_CLUSTER;
+                case "step2":
+                    return STEP2_NEW_CLUSTER;
+                case "step3":
+                    return STEP3_OLD_CLUSTER;
+                case "step4":
+                    return STEP4_NEW_CLUSTER;
+                default:
+                    throw new AssertionError("unknown test step: " + value);
+            }
+        }
+    }
+
+    protected static final TestStep TEST_STEP = TestStep.parse(System.getProperty("tests.rest.suite"));
+
+    @Override
+    protected boolean preserveSnapshotsUponCompletion() {
+        return true;
+    }
+
+    @Override
+    protected boolean preserveReposUponCompletion() {
+        return true;
+    }
+
+    public void testCreateAndRestoreSnapshot() throws IOException {
+        final String repoName = getTestName();
+        try (RestHighLevelClient client = new RestHighLevelClient(RestClient.builder(adminClient().getNodes().toArray(new Node[0])))) {
+            final int shards = 3;
+            createIndex(client, "test-index", shards);
+            createRepository(client, repoName, false);
+            createSnapshot(client, repoName, "snapshot-" + TEST_STEP);
+            final String snapshotToDeleteName = "snapshot-to-delete";
+            // Create a snapshot and delete it right away again to test the impact of each version's cleanup functionality that is run
+            // as part of the snapshot delete
+            createSnapshot(client, repoName, snapshotToDeleteName);
+            final List<Map<String, Object>> snapshotsIncludingToDelete = listSnapshots(repoName);
+            // Every step creates one snapshot and we have to add one more for the temporary snapshot
+            assertThat(snapshotsIncludingToDelete, hasSize(TEST_STEP.ordinal() + 1 + 1));
+            assertThat(snapshotsIncludingToDelete.stream().map(
+                sn -> (String) sn.get("snapshot")).collect(Collectors.toList()), hasItem(snapshotToDeleteName));
+            deleteSnapshot(client, repoName, snapshotToDeleteName);
+            final List<Map<String, Object>> snapshots = listSnapshots(repoName);
+            assertThat(snapshots, hasSize(TEST_STEP.ordinal() + 1));
+            assertSnapshotStatusSuccessful(client, repoName, snapshots);
+            if (TEST_STEP == TestStep.STEP3_OLD_CLUSTER) {
+                ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
+            } else if (TEST_STEP == TestStep.STEP4_NEW_CLUSTER) {
+                for (TestStep value : TestStep.values()) {
+                    ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + value, shards);
+                }
+            }
+        } finally {
+            deleteRepository(repoName);
+        }
+    }
+
+    public void testReadOnlyRepo() throws IOException {
+        final String repoName = getTestName();
+        try (RestHighLevelClient client = new RestHighLevelClient(RestClient.builder(adminClient().getNodes().toArray(new Node[0])))) {
+            final int shards = 3;
+            final boolean readOnly = TEST_STEP.ordinal() > 1; // only restore from read-only repo in steps 3 and 4
+            createRepository(client, repoName, readOnly);
+            if (readOnly == false) {
+                createIndex(client, "test-index", shards);
+                createSnapshot(client, repoName, "snapshot-" + TEST_STEP);
+            }
+            final List<Map<String, Object>> snapshots = listSnapshots(repoName);
+            switch (TEST_STEP) {
+                case STEP1_OLD_CLUSTER:
+                    assertThat(snapshots, hasSize(1));
+                    break;
+                case STEP2_NEW_CLUSTER:
+                case STEP4_NEW_CLUSTER:
+                case STEP3_OLD_CLUSTER:
+                    assertThat(snapshots, hasSize(2));
+                    break;
+            }
+            assertSnapshotStatusSuccessful(client, repoName, snapshots);
+            if (TEST_STEP == TestStep.STEP3_OLD_CLUSTER) {
+                ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
+            } else if (TEST_STEP == TestStep.STEP4_NEW_CLUSTER) {
+                ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
+                ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER, shards);
+            }
+        }
+    }
+
+    public void testUpgradeMovesRepoToNewMetaVersion() throws IOException {
+        if (TEST_STEP.ordinal() > 1) {
+            // Only testing the first 2 steps here
+            return;
+        }
+        final String repoName = getTestName();
+        try (RestHighLevelClient client = new RestHighLevelClient(RestClient.builder(adminClient().getNodes().toArray(new Node[0])))) {
+            final int shards = 3;
+            createIndex(client, "test-index", shards);
+            createRepository(client, repoName, false);
+            createSnapshot(client, repoName, "snapshot-" + TEST_STEP);
+            final List<Map<String, Object>> snapshots = listSnapshots(repoName);
+            // Every step creates one snapshot
+            assertThat(snapshots, hasSize(TEST_STEP.ordinal() + 1));
+            assertSnapshotStatusSuccessful(client, repoName, snapshots);
+            if (TEST_STEP == TestStep.STEP1_OLD_CLUSTER) {
+                ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
+            } else {
+                deleteSnapshot(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER);
+                ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER, shards);
+                createSnapshot(client, repoName, "snapshot-1");
+                ensureSnapshotRestoreWorks(client, repoName, "snapshot-1", shards);
+                deleteSnapshot(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER);
+                createSnapshot(client, repoName, "snapshot-2");
+                ensureSnapshotRestoreWorks(client, repoName, "snapshot-2", shards);
+            }
+        } finally {
+            deleteRepository(repoName);
+        }
+    }
+
+    private static void assertSnapshotStatusSuccessful(RestHighLevelClient client, String repoName,
+                                                     List<Map<String, Object>> snapshots) throws IOException {
+        final SnapshotsStatusResponse statusResponse = client.snapshot().status(new SnapshotsStatusRequest(repoName,
+            snapshots.stream().map(sn -> (String) sn.get("snapshot")).toArray(String[]::new)), RequestOptions.DEFAULT);
+        for (SnapshotStatus status : statusResponse.getSnapshots()) {
+            assertThat(status.getShardsStats().getFailedShards(), is(0));
+        }
+    }
+
+    private void deleteSnapshot(RestHighLevelClient client, String repoName, String name) throws IOException {
+        assertThat(client.snapshot().delete(new DeleteSnapshotRequest(repoName, name), RequestOptions.DEFAULT).isAcknowledged(), is(true));
+    }
+
+    @SuppressWarnings("unchecked")
+    private List<Map<String, Object>> listSnapshots(String repoName) throws IOException {
+        try (InputStream entity = client().performRequest(
+            new Request("GET", "/_snapshot/" + repoName + "/_all")).getEntity().getContent();
+             XContentParser parser = JsonXContent.jsonXContent.createParser(
+                 xContentRegistry(), DeprecationHandler.THROW_UNSUPPORTED_OPERATION, entity)) {
+            final Map<String, Object> raw = parser.map();
+            // Bwc lookup since the format of the snapshots response changed between versions
+            if (raw.containsKey("snapshots")) {
+                return (List<Map<String, Object>>) raw.get("snapshots");
+            } else {
+                return (List<Map<String, Object>>) ((List<Map<?, ?>>) raw.get("responses")).get(0).get("snapshots");
+            }
+        }
+    }
+
+    private static void ensureSnapshotRestoreWorks(RestHighLevelClient client, String repoName, String name,
+                                                   int shards) throws IOException {
+        wipeAllIndices();
+        final RestoreInfo restoreInfo =
+            client.snapshot().restore(new RestoreSnapshotRequest().repository(repoName).snapshot(name).waitForCompletion(true),
+                RequestOptions.DEFAULT).getRestoreInfo();
+        assertThat(restoreInfo.failedShards(), is(0));
+        assertThat(restoreInfo.successfulShards(), equalTo(shards));
+    }
+
+    private static void createRepository(RestHighLevelClient client, String repoName, boolean readOnly) throws IOException {
+        assertThat(client.snapshot().createRepository(new PutRepositoryRequest(repoName).type("fs").settings(
+            Settings.builder().put("location", "./" + repoName).put("readonly", readOnly)), RequestOptions.DEFAULT).isAcknowledged(),
+            is(true));
+    }
+
+    private static void createSnapshot(RestHighLevelClient client, String repoName, String name) throws IOException {
+        client.snapshot().create(new CreateSnapshotRequest(repoName, name).waitForCompletion(true), RequestOptions.DEFAULT);
+    }
+
+    private void createIndex(RestHighLevelClient client, String name, int shards) throws IOException {
+        final Request putIndexRequest = new Request("PUT", "/" + name);
+        putIndexRequest.setJsonEntity("{\n" +
+            "    \"settings\" : {\n" +
+            "        \"index\" : {\n" +
+            "            \"number_of_shards\" : " + shards + ", \n" +
+            "            \"number_of_replicas\" : 0 \n" +
+            "        }\n" +
+            "    }\n" +
+            "}");
+        final Response response = client.getLowLevelClient().performRequest(putIndexRequest);
+        assertThat(response.getStatusLine().getStatusCode(), is(HttpURLConnection.HTTP_OK));
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/repositories/cleanup/TransportCleanupRepositoryAction.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/repositories/cleanup/TransportCleanupRepositoryAction.java
index 1273485823f76..1b2381ed89ec5 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/repositories/cleanup/TransportCleanupRepositoryAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/repositories/cleanup/TransportCleanupRepositoryAction.java
@@ -77,6 +77,8 @@ public final class TransportCleanupRepositoryAction extends TransportMasterNodeA
 
     private final RepositoriesService repositoriesService;
 
+    private final SnapshotsService snapshotsService;
+
     @Override
     protected String executor() {
         return ThreadPool.Names.GENERIC;
@@ -84,11 +86,13 @@ protected String executor() {
 
     @Inject
     public TransportCleanupRepositoryAction(TransportService transportService, ClusterService clusterService,
-                                            RepositoriesService repositoriesService, ThreadPool threadPool, ActionFilters actionFilters,
+                                            RepositoriesService repositoriesService, SnapshotsService snapshotsService,
+                                            ThreadPool threadPool, ActionFilters actionFilters,
                                             IndexNameExpressionResolver indexNameExpressionResolver) {
         super(CleanupRepositoryAction.NAME, transportService, clusterService, threadPool, actionFilters,
             CleanupRepositoryRequest::new, indexNameExpressionResolver);
         this.repositoriesService = repositoriesService;
+        this.snapshotsService = snapshotsService;
         // We add a state applier that will remove any dangling repository cleanup actions on master failover.
         // This is safe to do since cleanups will increment the repository state id before executing any operations to prevent concurrent
         // operations from corrupting the repository. This is the same safety mechanism used by snapshot deletes.
@@ -216,8 +220,10 @@ public void clusterStateProcessed(String source, ClusterState oldState, ClusterS
                         threadPool.executor(ThreadPool.Names.SNAPSHOT).execute(ActionRunnable.wrap(listener,
                             l -> blobStoreRepository.cleanup(
                                 repositoryStateId,
-                                newState.nodes().getMinNodeVersion().onOrAfter(SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION),
-                                ActionListener.wrap(result -> after(null, result), e -> after(e, null)))));
+                                newState.nodes().getMinNodeVersion().onOrAfter(SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION)
+                                    && snapshotsService.hasOldVersionSnapshots(repositoryName, repositoryData, null) == false,
+                                ActionListener.wrap(result -> after(null, result), e -> after(e, null)))
+                        ));
                     }
 
                     private void after(@Nullable Exception failure, @Nullable RepositoryCleanupResult result) {
diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
index 63e2957aacc78..f41a28686e38b 100644
--- a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
@@ -21,6 +21,7 @@
 
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.ResourceNotFoundException;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -28,6 +29,7 @@
 import org.elasticsearch.common.xcontent.XContentParserUtils;
 import org.elasticsearch.snapshots.SnapshotId;
 import org.elasticsearch.snapshots.SnapshotState;
+import org.elasticsearch.snapshots.SnapshotsService;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -321,6 +323,7 @@ public List<IndexId> resolveNewIndices(final List<String> indicesToResolve) {
     private static final String NAME = "name";
     private static final String UUID = "uuid";
     private static final String STATE = "state";
+    private static final String MIN_VERSION = "min_version";
 
     /**
      * Writes the snapshots metadata and the related indices metadata to x-content.
@@ -361,6 +364,12 @@ public XContentBuilder snapshotsToXContent(final XContentBuilder builder, final
             builder.endObject();
         }
         builder.endObject();
+        if (shouldWriteShardGens) {
+            // TODO: write this field once 7.6 is able to read it and add tests to :qa:snapshot-repository-downgrade that make sure older
+            //       ES versions can't corrupt the repository by writing to it and all the snapshots in it are v7.6 or newer
+            // Add min version field to make it impossible for older ES versions to deserialize this object
+            // builder.field(MIN_VERSION, SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION.toString());
+        }
         builder.endObject();
         return builder;
     }
@@ -468,6 +477,12 @@ public static RepositoryData snapshotsFromXContent(final XContentParser parser,
                             shardGenerations.put(indexId, i, gens.get(i));
                         }
                     }
+                } else if (MIN_VERSION.equals(field)) {
+                    if (parser.nextToken() != XContentParser.Token.VALUE_STRING) {
+                        throw new ElasticsearchParseException("version string expected [min_version]");
+                    }
+                    final Version version = Version.fromString(parser.text());
+                    assert version.onOrAfter(SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION);
                 } else {
                     throw new ElasticsearchParseException("unknown field name  [" + field + "]");
                 }
diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
index cfb2112b4044d..9340e1508999c 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
@@ -80,6 +80,7 @@
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Collection;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
@@ -270,6 +271,7 @@ public void createSnapshot(final CreateSnapshotRequest request, final ActionList
         final StepListener<RepositoryData> repositoryDataListener = new StepListener<>();
         repositoriesService.repository(repositoryName).getRepositoryData(repositoryDataListener);
         repositoryDataListener.whenComplete(repositoryData -> {
+            final boolean hasOldFormatSnapshots = hasOldVersionSnapshots(repositoryName, repositoryData, null);
             clusterService.submitStateUpdateTask("create_snapshot [" + snapshotName + ']', new ClusterStateUpdateTask() {
 
                 private SnapshotsInProgress.Entry newSnapshot = null;
@@ -303,7 +305,8 @@ public ClusterState execute(ClusterState currentState) {
                             repositoryData.getGenId(),
                             null,
                             request.userMetadata(),
-                            clusterService.state().nodes().getMinNodeVersion().onOrAfter(SHARD_GEN_IN_REPO_DATA_VERSION));
+                            hasOldFormatSnapshots == false &&
+                                clusterService.state().nodes().getMinNodeVersion().onOrAfter(SHARD_GEN_IN_REPO_DATA_VERSION));
                         initializingSnapshots.add(newSnapshot.snapshot());
                         snapshots = new SnapshotsInProgress(newSnapshot);
                     } else {
@@ -351,6 +354,31 @@ public TimeValue timeout() {
         }, listener::onFailure);
     }
 
+    public boolean hasOldVersionSnapshots(String repositoryName, RepositoryData repositoryData, @Nullable SnapshotId excluded) {
+        final Collection<SnapshotId> snapshotIds = repositoryData.getSnapshotIds();
+        final boolean hasOldFormatSnapshots;
+        if (snapshotIds.isEmpty()) {
+            hasOldFormatSnapshots = false;
+        } else {
+            if (repositoryData.shardGenerations().totalShards() > 0) {
+                hasOldFormatSnapshots = false;
+            } else {
+                try {
+                    final Repository repository = repositoriesService.repository(repositoryName);
+                    hasOldFormatSnapshots = snapshotIds.stream().map(repository::getSnapshotInfo).anyMatch(
+                        snapshotInfo -> (excluded == null || snapshotInfo.snapshotId().equals(excluded) == false)
+                            && snapshotInfo.version().before(SHARD_GEN_IN_REPO_DATA_VERSION));
+                } catch (SnapshotMissingException e) {
+                    logger.warn("Failed to load snapshot metadata, assuming repository is in old format", e);
+                    return true;
+                }
+            }
+        }
+        assert hasOldFormatSnapshots == false || repositoryData.shardGenerations().totalShards() == 0 :
+            "Found non-empty shard generations [" + repositoryData.shardGenerations() + "] but repository contained old version snapshots";
+        return hasOldFormatSnapshots;
+    }
+
     /**
      * Validates snapshot request
      *
@@ -1402,12 +1430,15 @@ private void deleteSnapshotFromRepository(Snapshot snapshot, @Nullable ActionLis
                                               Version version) {
         threadPool.executor(ThreadPool.Names.SNAPSHOT).execute(ActionRunnable.wrap(listener, l -> {
             Repository repository = repositoriesService.repository(snapshot.getRepository());
-            repository.deleteSnapshot(snapshot.getSnapshotId(), repositoryStateId, version.onOrAfter(SHARD_GEN_IN_REPO_DATA_VERSION),
+            repository.getRepositoryData(ActionListener.wrap(repositoryData -> repository.deleteSnapshot(snapshot.getSnapshotId(),
+                repositoryStateId,
+                version.onOrAfter(SHARD_GEN_IN_REPO_DATA_VERSION) &&
+                    hasOldVersionSnapshots(snapshot.getRepository(), repositoryData, snapshot.getSnapshotId()) == false,
                 ActionListener.wrap(v -> {
                         logger.info("snapshot [{}] deleted", snapshot);
                         removeSnapshotDeletionFromClusterState(snapshot, null, l);
                     }, ex -> removeSnapshotDeletionFromClusterState(snapshot, ex, l)
-                ));
+                )), ex -> removeSnapshotDeletionFromClusterState(snapshot, ex, l)));
         }));
     }
 
diff --git a/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java b/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
index 2a860eda3f972..9abb107521042 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
@@ -18,6 +18,7 @@
  */
 package org.elasticsearch.snapshots;
 
+import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.client.Client;
@@ -33,9 +34,11 @@
 import org.elasticsearch.repositories.RepositoryData;
 import org.elasticsearch.repositories.RepositoryException;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
+import org.elasticsearch.threadpool.ThreadPool;
 
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.util.Locale;
 
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.containsString;
@@ -231,6 +234,50 @@ public void clusterStateProcessed(String source, ClusterState oldState, ClusterS
             .addSnapshots(snapshot).get().getSnapshots(repoName));
     }
 
+    public void testHandlingMissingRootLevelSnapshotMetadata() throws Exception {
+        Path repo = randomRepoPath();
+        final String repoName = "test-repo";
+        logger.info("-->  creating repository at {}", repo.toAbsolutePath());
+        assertAcked(client().admin().cluster().preparePutRepository(repoName)
+            .setType("fs").setSettings(Settings.builder()
+                .put("location", repo)
+                .put("compress", false)
+                .put("chunk_size", randomIntBetween(100, 1000), ByteSizeUnit.BYTES)));
+
+        final String snapshotPrefix = "test-snap-";
+        final int snapshots = randomIntBetween(1, 2);
+        logger.info("--> creating [{}] snapshots", snapshots);
+        for (int i = 0; i < snapshots; ++i) {
+            // Workaround to simulate BwC situation: taking a snapshot without indices here so that we don't create any new version shard
+            // generations (the existence of which would short-circuit checks for the repo containing old version snapshots)
+            CreateSnapshotResponse createSnapshotResponse = client().admin().cluster().prepareCreateSnapshot(repoName, snapshotPrefix + i)
+                .setIndices().setWaitForCompletion(true).get();
+            assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(), is(0));
+            assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(),
+                equalTo(createSnapshotResponse.getSnapshotInfo().totalShards()));
+        }
+        final Repository repository = internalCluster().getCurrentMasterNodeInstance(RepositoriesService.class).repository(repoName);
+        final RepositoryData repositoryData = getRepositoryData(repository);
+
+        final SnapshotId snapshotToCorrupt = randomFrom(repositoryData.getSnapshotIds());
+        logger.info("--> delete root level snapshot metadata blob for snapshot [{}]", snapshotToCorrupt);
+        Files.delete(repo.resolve(String.format(Locale.ROOT, BlobStoreRepository.SNAPSHOT_NAME_FORMAT, snapshotToCorrupt.getUUID())));
+
+        logger.info("--> verify that repo is assumed in old metadata format");
+        final SnapshotsService snapshotsService = internalCluster().getCurrentMasterNodeInstance(SnapshotsService.class);
+        final ThreadPool threadPool = internalCluster().getCurrentMasterNodeInstance(ThreadPool.class);
+        assertThat(PlainActionFuture.get(f -> threadPool.generic().execute(
+            ActionRunnable.supply(f, () -> snapshotsService.hasOldVersionSnapshots(repoName, repositoryData, null)))), is(true));
+
+        logger.info("--> verify that snapshot with missing root level metadata can be deleted");
+        assertAcked(client().admin().cluster().prepareDeleteSnapshot(repoName, snapshotToCorrupt.getName()).get());
+
+        logger.info("--> verify that repository is assumed in new metadata format after removing corrupted snapshot");
+        assertThat(PlainActionFuture.get(f -> threadPool.generic().execute(
+            ActionRunnable.supply(f, () -> snapshotsService.hasOldVersionSnapshots(repoName, getRepositoryData(repository), null)))),
+            is(false));
+    }
+
     private void assertRepositoryBlocked(Client client, String repo, String existingSnapshot) {
         logger.info("--> try to delete snapshot");
         final RepositoryException repositoryException3 = expectThrows(RepositoryException.class,
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
index 5fd6624d1d128..9b8950c813b4f 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
@@ -1276,7 +1276,7 @@ searchTransportService, new SearchPhaseController(searchService::createReduceCon
                         actionFilters, indexNameExpressionResolver
                     ));
                 actions.put(CleanupRepositoryAction.INSTANCE, new TransportCleanupRepositoryAction(transportService, clusterService,
-                    repositoriesService, threadPool, actionFilters, indexNameExpressionResolver));
+                    repositoriesService, snapshotsService, threadPool, actionFilters, indexNameExpressionResolver));
                 actions.put(CreateSnapshotAction.INSTANCE,
                     new TransportCreateSnapshotAction(
                         transportService, clusterService, threadPool,
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index b843ea7a3d2b5..a1968332c734b 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -620,13 +620,17 @@ protected static void wipeAllIndices() throws IOException {
                 }
             }
             if (preserveReposUponCompletion() == false) {
-                logger.debug("wiping snapshot repository [{}]", repoName);
-                adminClient().performRequest(new Request("DELETE", "_snapshot/" + repoName));
+                deleteRepository(repoName);
             }
         }
         return inProgressSnapshots;
     }
 
+    protected void deleteRepository(String repoName) throws IOException {
+        logger.debug("wiping snapshot repository [{}]", repoName);
+        adminClient().performRequest(new Request("DELETE", "_snapshot/" + repoName));
+    }
+
     /**
      * Remove any cluster settings.
      */

From 6ccef91f3dde2206b15306b0c26605fbe0cfd1fe Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Thu, 9 Jan 2020 09:31:44 -0500
Subject: [PATCH 479/686] [Transform] fail to start/put on missing pipeline
 (#50701)

If a pipeline referenced by a transform does not exist, we should not allow the transform to be created.

We do allow the pipeline existence check to be skipped with defer_validations, but if the pipeline still does not exist on `_start`, the pipeline will fail to start.

relates:  #50135
---
 .../TransformDocumentationIT.java             |  1 +
 docs/build.gradle                             | 18 +++++-
 .../transform/apis/put-transform.asciidoc     |  2 +-
 .../core/transform/TransformMessages.java     |  1 +
 .../test/transform/transforms_crud.yml        | 49 ++++++++++++++++
 .../test/transform/transforms_start_stop.yml  | 56 +++++++++++++++++++
 .../action/TransportPutTransformAction.java   | 22 +++++++-
 .../action/TransportStartTransformAction.java | 22 +++++++-
 ...TransportPutTransformActionDeprecated.java |  7 ++-
 ...ansportStartTransformActionDeprecated.java |  7 ++-
 10 files changed, 173 insertions(+), 12 deletions(-)

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/TransformDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/TransformDocumentationIT.java
index 5438d5dd554c5..861cdef8e5ac6 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/TransformDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/TransformDocumentationIT.java
@@ -134,6 +134,7 @@ public void testPutTransform() throws IOException, InterruptedException {
             .setIndex("pivot-destination")
             .setPipeline("my-pipeline").build();
         // end::put-transform-dest-config
+        destConfig = DestConfig.builder().setIndex("pivot-destination").build();
         // tag::put-transform-group-config
         GroupConfig groupConfig = GroupConfig.builder()
             .groupBy("reviewer", // <1>
diff --git a/docs/build.gradle b/docs/build.gradle
index 5d9b8ae0a73e8..80e1d49972e9f 100644
--- a/docs/build.gradle
+++ b/docs/build.gradle
@@ -1235,7 +1235,23 @@ buildRestTests.setups['kibana_sample_data_ecommerce'] = '''
               number_of_shards: 1
               number_of_replicas: 0
 '''
-buildRestTests.setups['simple_kibana_continuous_pivot'] = buildRestTests.setups['kibana_sample_data_ecommerce'] + '''
+buildRestTests.setups['add_timestamp_pipeline'] = '''
+  - do:
+      ingest.put_pipeline:
+        id: "add_timestamp_pipeline"
+        body:  >
+          {
+            "processors": [
+              {
+                "set" : {
+                  "field" : "@timestamp",
+                  "value" : "{{_ingest.timestamp}}"
+                }
+              }
+            ]
+          }
+'''
+buildRestTests.setups['simple_kibana_continuous_pivot'] = buildRestTests.setups['kibana_sample_data_ecommerce'] + buildRestTests.setups['add_timestamp_pipeline']  + '''
   - do:
       raw:
         method: PUT
diff --git a/docs/reference/transform/apis/put-transform.asciidoc b/docs/reference/transform/apis/put-transform.asciidoc
index dfe11c96f1d93..ff55af4addb0a 100644
--- a/docs/reference/transform/apis/put-transform.asciidoc
+++ b/docs/reference/transform/apis/put-transform.asciidoc
@@ -195,7 +195,7 @@ PUT _transform/ecommerce_transform
   }
 }
 --------------------------------------------------
-// TEST[setup:kibana_sample_data_ecommerce]
+// TEST[setup:kibana_sample_data_ecommerce,add_timestamp_pipeline]
 
 When the {transform} is created, you receive the following results:
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
index b1e9dffea5027..d0279d9aebd38 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
@@ -27,6 +27,7 @@ public class TransformMessages {
     public static final String REST_FAILED_TO_SERIALIZE_TRANSFORM = "Failed to serialise transform [{0}]";
     public static final String TRANSFORM_FAILED_TO_PERSIST_STATS = "Failed to persist transform statistics for transform [{0}]";
     public static final String UNKNOWN_TRANSFORM_STATS = "Statistics for transform [{0}] could not be found";
+    public static final String PIPELINE_MISSING = "Pipeline with id [{0}] could not be found";
 
     public static final String REST_DEPRECATED_ENDPOINT = "[_data_frame/transforms/] is deprecated, use [_transform/] in the future.";
 
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
index 1968e1fa431cc..b8dc88c3ae0c1 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
@@ -122,6 +122,22 @@ setup:
           }
   - match: { acknowledged: true }
 
+  - do:
+      ingest.put_pipeline:
+        id: "airline-pipeline"
+        body:  >
+          {
+            "processors": [
+              {
+                "set" : {
+                  "field" : "some_field",
+                  "value" : 42
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
   - do:
       transform.put_transform:
         transform_id: "airline-transform-dos"
@@ -631,3 +647,36 @@ setup:
         transform_id: "airline-transform-start-delete"
         force: true
   - match: { acknowledged: true }
+---
+"Test put transform with missing pipeline":
+  - do:
+      catch: /Pipeline with id \[missing-transform-pipeline\] could not be found/
+      transform.put_transform:
+        transform_id: "airline-transform-with-missing-pipeline-crud"
+        body: >
+          {
+            "source": { "index": "airline-data" },
+            "dest": { "index": "airline-data-by-airline-with-pipeline", "pipeline": "missing-transform-pipeline" },
+            "pivot": {
+              "group_by": { "airline": {"terms": {"field": "airline"}}},
+              "aggs": {"avg_response": {"avg": {"field": "responsetime"}}}
+            },
+            "description": "yaml test transform on airline-data"
+          }
+---
+"Test put transform with missing pipeline and defer validations":
+  - do:
+      transform.put_transform:
+        defer_validation: true
+        transform_id: "airline-transform-with-missing-pipeline-crud-defer"
+        body: >
+          {
+            "source": { "index": "airline-data" },
+            "dest": { "index": "airline-data-by-airline", "pipeline": "missing-transform-pipeline" },
+            "pivot": {
+              "group_by": { "airline": {"terms": {"field": "airline"}}},
+              "aggs": {"avg_response": {"avg": {"field": "responsetime"}}}
+            },
+            "description": "yaml test transform on airline-data"
+          }
+  - match: {acknowledged: true}
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_start_stop.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_start_stop.yml
index f3ed8351803b9..38268e499246e 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_start_stop.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_start_stop.yml
@@ -376,3 +376,59 @@ teardown:
         index: airline-data-time-alias
   - match: { airline-data-time-alias.mappings.properties.time.type: date }
   - match: { airline-data-time-alias.mappings.properties.avg_response.type: double }
+---
+"Test start transform with missing pipeline":
+  - do:
+      transform.put_transform:
+        defer_validation: true
+        transform_id: "airline-transform-with-missing-pipeline"
+        body: >
+          {
+            "source": { "index": "airline-data" },
+            "dest": { "index": "airline-data-by-airline-pipeline", "pipeline": "missing-transform-pipeline" },
+            "pivot": {
+              "group_by": { "airline": {"terms": {"field": "airline"}}},
+              "aggs": {"avg_response": {"avg": {"field": "responsetime"}}}
+            },
+            "description": "yaml test transform on airline-data"
+          }
+  - match: {acknowledged: true}
+  - do:
+      catch: /Pipeline with id \[missing-transform-pipeline\] could not be found/
+      transform.start_transform:
+        transform_id: "airline-transform-with-missing-pipeline"
+---
+"Test start transform with pipeline":
+  - do:
+      ingest.put_pipeline:
+        id: "transform-pipeline"
+        body:  >
+          {
+            "processors": [
+              {
+                "set" : {
+                  "field" : "some_field",
+                  "value" : 42
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      transform.put_transform:
+        transform_id: "airline-transform-with-pipeline"
+        body: >
+          {
+            "source": { "index": "airline-data" },
+            "dest": { "index": "airline-data-by-airline-pipeline", "pipeline": "transform-pipeline" },
+            "pivot": {
+              "group_by": { "airline": {"terms": {"field": "airline"}}},
+              "aggs": {"avg_response": {"avg": {"field": "responsetime"}}}
+            },
+            "description": "yaml test transform on airline-data"
+          }
+  - match: {acknowledged: true}
+  - do:
+      transform.start_transform:
+        transform_id: "airline-transform-with-pipeline"
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
index 856ac77a801ab..67d9454c98232 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.ingest.IngestService;
 import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.license.RemoteClusterLicenseChecker;
@@ -74,6 +75,7 @@ public class TransportPutTransformAction extends TransportMasterNodeAction<Reque
     private final SecurityContext securityContext;
     private final TransformAuditor auditor;
     private final SourceDestValidator sourceDestValidator;
+    private final IngestService ingestService;
 
     @Inject
     public TransportPutTransformAction(
@@ -85,7 +87,8 @@ public TransportPutTransformAction(
         ClusterService clusterService,
         XPackLicenseState licenseState,
         TransformServices transformServices,
-        Client client
+        Client client,
+        IngestService ingestService
     ) {
         this(
             PutTransformAction.NAME,
@@ -97,7 +100,8 @@ public TransportPutTransformAction(
             clusterService,
             licenseState,
             transformServices,
-            client
+            client,
+            ingestService
         );
     }
 
@@ -111,7 +115,8 @@ protected TransportPutTransformAction(
         ClusterService clusterService,
         XPackLicenseState licenseState,
         TransformServices transformServices,
-        Client client
+        Client client,
+        IngestService ingestService
     ) {
         super(
             name,
@@ -138,6 +143,7 @@ protected TransportPutTransformAction(
             clusterService.getNodeName(),
             License.OperationMode.BASIC.description()
         );
+        this.ingestService = ingestService;
     }
 
     static HasPrivilegesRequest buildPrivilegeCheck(
@@ -335,6 +341,16 @@ private void putTransform(Request request, ActionListener<AcknowledgedResponse>
         if (request.isDeferValidation()) {
             pivotValidationListener.onResponse(true);
         } else {
+            if (config.getDestination().getPipeline() != null) {
+                if (ingestService.getPipeline(config.getDestination().getPipeline()) == null) {
+                    listener.onFailure(new ElasticsearchStatusException(
+                        TransformMessages.getMessage(TransformMessages.PIPELINE_MISSING, config.getDestination().getPipeline()),
+                        RestStatus.BAD_REQUEST
+                        )
+                    );
+                    return;
+                }
+            }
             pivot.validateQuery(client, config.getSource(), pivotValidationListener);
         }
     }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
index f18c0712575e7..52337427c388f 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.ingest.IngestService;
 import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.license.RemoteClusterLicenseChecker;
@@ -71,6 +72,7 @@ public class TransportStartTransformAction extends TransportMasterNodeAction<Sta
     private final Client client;
     private final TransformAuditor auditor;
     private final SourceDestValidator sourceDestValidator;
+    private final IngestService ingestService;
 
     @Inject
     public TransportStartTransformAction(
@@ -83,7 +85,8 @@ public TransportStartTransformAction(
         TransformServices transformServices,
         PersistentTasksService persistentTasksService,
         Client client,
-        Settings settings
+        Settings settings,
+        IngestService ingestService
     ) {
         this(
             StartTransformAction.NAME,
@@ -96,7 +99,8 @@ public TransportStartTransformAction(
             transformServices,
             persistentTasksService,
             client,
-            settings
+            settings,
+            ingestService
         );
     }
 
@@ -111,7 +115,8 @@ protected TransportStartTransformAction(
         TransformServices transformServices,
         PersistentTasksService persistentTasksService,
         Client client,
-        Settings settings
+        Settings settings,
+        IngestService ingestService
     ) {
         super(
             name,
@@ -136,6 +141,7 @@ protected TransportStartTransformAction(
             clusterService.getNodeName(),
             License.OperationMode.BASIC.description()
         );
+        this.ingestService = ingestService;
     }
 
     @Override
@@ -258,6 +264,16 @@ protected void masterOperation(
             }
             transformTaskHolder.set(createTransform(config.getId(), config.getVersion(), config.getFrequency()));
             transformConfigHolder.set(config);
+            if (config.getDestination().getPipeline() != null) {
+                if (ingestService.getPipeline(config.getDestination().getPipeline()) == null) {
+                    listener.onFailure(new ElasticsearchStatusException(
+                        TransformMessages.getMessage(TransformMessages.PIPELINE_MISSING, config.getDestination().getPipeline()),
+                        RestStatus.BAD_REQUEST
+                        )
+                    );
+                    return;
+                }
+            }
 
             sourceDestValidator.validate(
                 clusterService.state(),
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportPutTransformActionDeprecated.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportPutTransformActionDeprecated.java
index 0b579a7384ce7..270684edabdfb 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportPutTransformActionDeprecated.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportPutTransformActionDeprecated.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.ingest.IngestService;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
@@ -31,7 +32,8 @@ public TransportPutTransformActionDeprecated(
         ClusterService clusterService,
         XPackLicenseState licenseState,
         TransformServices transformServices,
-        Client client
+        Client client,
+        IngestService ingestService
     ) {
         super(
             PutTransformActionDeprecated.NAME,
@@ -43,7 +45,8 @@ public TransportPutTransformActionDeprecated(
             clusterService,
             licenseState,
             transformServices,
-            client
+            client,
+            ingestService
         );
     }
 
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportStartTransformActionDeprecated.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportStartTransformActionDeprecated.java
index caef1b1edf1d3..a2476fe7ab6e7 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportStartTransformActionDeprecated.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/compat/TransportStartTransformActionDeprecated.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.ingest.IngestService;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.persistent.PersistentTasksService;
 import org.elasticsearch.threadpool.ThreadPool;
@@ -33,7 +34,8 @@ public TransportStartTransformActionDeprecated(
         TransformServices transformServices,
         PersistentTasksService persistentTasksService,
         Client client,
-        Settings settings
+        Settings settings,
+        IngestService ingestService
     ) {
         super(
             StartTransformActionDeprecated.NAME,
@@ -46,7 +48,8 @@ public TransportStartTransformActionDeprecated(
             transformServices,
             persistentTasksService,
             client,
-            settings
+            settings,
+            ingestService
         );
     }
 }

From ffba95201fe91e8f0844e966870c7246c874c8d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 9 Jan 2020 16:21:01 +0100
Subject: [PATCH 480/686] [DOCS] Fine-tunes data frame analytics API docs
 formatting. (#50799)

---
 .../df-analytics/apis/delete-dfanalytics.asciidoc |  3 ++-
 .../apis/delete-inference-trained-model.asciidoc  |  3 ++-
 .../apis/evaluate-dfanalytics.asciidoc            |  3 ++-
 .../apis/explain-dfanalytics.asciidoc             |  3 ++-
 .../apis/get-dfanalytics-stats.asciidoc           |  3 ++-
 .../ml/df-analytics/apis/get-dfanalytics.asciidoc |  3 ++-
 .../get-inference-trained-model-stats.asciidoc    |  3 ++-
 .../apis/get-inference-trained-model.asciidoc     |  3 ++-
 .../ml/df-analytics/apis/put-dfanalytics.asciidoc | 15 +++++++--------
 .../df-analytics/apis/start-dfanalytics.asciidoc  |  3 ++-
 .../df-analytics/apis/stop-dfanalytics.asciidoc   |  3 ++-
 docs/reference/rest-api/defs.asciidoc             |  2 +-
 12 files changed, 28 insertions(+), 19 deletions(-)

diff --git a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
index dd3946971853a..472c893ac28b4 100644
--- a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
@@ -21,7 +21,8 @@ experimental[]
 [[ml-delete-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles or equivalent privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)
diff --git a/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc b/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
index 086c093927bd9..8b9aad01c8f2a 100644
--- a/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
@@ -22,7 +22,8 @@ experimental[]
 [[ml-delete-inference-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles or equivalent privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)
diff --git a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
index 0f4f5b222e56e..c331d9bda7aab 100644
--- a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
@@ -22,7 +22,8 @@ experimental[]
 [[ml-evaluate-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following privileges:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   
diff --git a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
index f2f570cadafb7..ea3ed38d85c2f 100644
--- a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
@@ -28,7 +28,8 @@ experimental[]
 [[ml-explain-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following privileges:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
index 508e1072349b4..e302f808f6f5a 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
@@ -28,7 +28,8 @@ experimental[]
 [[ml-get-dfanalytics-stats-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following privileges:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
index dfcf647591226..df11cc686a613 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
@@ -27,7 +27,8 @@ experimental[]
 [[ml-get-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following privileges:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   
diff --git a/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
index 8bc882084332b..58dfb2e60ca08 100644
--- a/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
@@ -29,7 +29,8 @@ experimental[]
 [[ml-get-inference-stats-prereq]]
 ==== {api-prereq-title}
 
-Required privileges which should be added to a custom role:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   
diff --git a/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc b/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
index e972cf040e222..047ffd40332e2 100644
--- a/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
@@ -29,7 +29,8 @@ experimental[]
 [[ml-get-inference-prereq]]
 ==== {api-prereq-title}
 
-Required privileges which should be added to a custom role:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index 83b2ff4b65835..24149372e0e99 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -20,7 +20,8 @@ experimental[]
 [[ml-put-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles and privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles and privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)
@@ -66,12 +67,11 @@ upper bound on the improvement in validation loss.
 A fixed number of rounds is used for optimization which depends on the number of 
 parameters being optimized. The optimization starts with random search, then 
 Bayesian optimization is performed that is targeting maximum expected 
-improvement. If you override any parameters,
-//TBD: What is meant by overriding them? Explicitly setting the parameter instead of letting it take the default? 
-the optimization calculates the value of the remaining parameters accordingly
-and uses the value you provided for the overridden parameter. The number of
-rounds are reduced respectively. The validation error is estimated in each round
-by using 4-fold cross validation.
+improvement. If you override any parameters by explicitely setting it, the 
+optimization calculates the value of the remaining parameters accordingly and 
+uses the value you provided for the overridden parameter. The number of rounds 
+are reduced respectively. The validation error is estimated in each round by 
+using 4-fold cross validation.
 
 [[ml-put-dfanalytics-path-params]]
 ==== {api-path-parms-title}
@@ -104,7 +104,6 @@ TIP: Advanced parameters are for fine-tuning {classanalysis}. They are set
 automatically by <<ml-hyperparam-optimization,hyperparameter optimization>> 
 to give minimum validation error. It is highly recommended to use the default 
 values unless you fully understand the function of these parameters.
-
 --
 
 `analysis`.`classification`.`dependent_variable`::::
diff --git a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
index f2b1586c31b28..7b37719011bcf 100644
--- a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
@@ -20,7 +20,8 @@ experimental[]
 [[ml-start-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles and privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles and privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)
diff --git a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
index 741e4551ceb66..2f3087697213c 100644
--- a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
@@ -24,7 +24,8 @@ experimental[]
 [[ml-stop-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles or equivalent privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index d37d6dda8ee82..681ab746c193c 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -3,7 +3,7 @@
 == Definitions
 
 The role mappings resource definition you can find below is used in APIs related 
-to security features.
+to {security-features}.
 
   * <<role-mapping-resources,Role mappings>>
 

From 62b13fe235c63eb1232b7a9f1e263d7254b9f03b Mon Sep 17 00:00:00 2001
From: Sean Story <sean.story@elastic.co>
Date: Thu, 9 Jan 2020 09:48:20 -0600
Subject: [PATCH 481/686] Typo of ' instead of ` (#50767)

---
 x-pack/docs/en/security/authentication/saml-guide.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/docs/en/security/authentication/saml-guide.asciidoc b/x-pack/docs/en/security/authentication/saml-guide.asciidoc
index f69d24519f781..0776d314dfae5 100644
--- a/x-pack/docs/en/security/authentication/saml-guide.asciidoc
+++ b/x-pack/docs/en/security/authentication/saml-guide.asciidoc
@@ -932,7 +932,7 @@ POST /_security/saml/prepare
 --------------------------------------------------
 
 . Handle the response from `/_security/saml/prepare`. The response from {es} will contain 3 parameters:
-  `redirect`, `realm' and `id`. The custom web application would need to store the value for `id`
+  `redirect`, `realm` and `id`. The custom web application would need to store the value for `id`
  in the user's session (client side in a cookie or server side if session information is
 persisted this way). It must also redirect the user's browser to the URL that  was returned in the 
   `redirect` parameter. The `id` value should not be disregarded as it is used as a nonce in SAML in

From 31a29dfd89b3a08ab760912214fda8db84e2cefe Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Thu, 9 Jan 2020 16:02:28 +0000
Subject: [PATCH 482/686] Remove type parameter from CIR.mapping(type,
 object...) (#50739)

This commit removes the type parameter from `CreateIndexRequest.mapping(type, object...)`,
and the associated delegating method on `CreateIndexRequestBuilder`. To make migration
simpler, the method on `CreateIndexRequest` is renamed to `simpleMapping`, and
on `CreateIndexRequestBuilder` to `setMapping`; this should help the compiler catch all
necessary changes on upgrades.

Relates to #41059
---
 .../common/HighlighterWithAnalyzersTests.java |  6 +--
 .../common/QueryStringWithAnalyzersTests.java |  2 +-
 .../expression/MoreExpressionTests.java       | 12 ++---
 .../percolator/PercolatorQuerySearchIT.java   | 24 ++++-----
 .../PercolatorQuerySearchTests.java           |  2 +-
 .../index/mapper/size/SizeMappingIT.java      |  2 +-
 .../indices/create/CreateIndexRequest.java    | 36 ++++++-------
 .../create/CreateIndexRequestBuilder.java     |  4 +-
 .../rollover/RolloverRequestBuilder.java      |  4 +-
 .../admin/indices/create/ShrinkIndexIT.java   |  2 +-
 .../admin/indices/create/SplitIndexIT.java    |  8 +--
 .../action/termvectors/GetTermVectorsIT.java  | 22 ++++----
 .../elasticsearch/aliases/IndexAliasesIT.java | 32 ++++++------
 .../coordination/RareClusterStateIT.java      |  2 +-
 .../metadata/MetaDataMappingServiceTests.java |  8 +--
 .../AliasedIndexDocumentActionsIT.java        |  2 +-
 .../document/DocumentActionsIT.java           |  2 +-
 .../elasticsearch/document/ShardInfoIT.java   |  2 +-
 .../explain/ExplainActionIT.java              |  6 +--
 .../org/elasticsearch/get/GetActionIT.java    |  4 +-
 .../FieldStatsProviderRefreshTests.java       |  2 +-
 .../index/mapper/DynamicMappingTests.java     |  2 +-
 .../index/mapper/UpdateMappingTests.java      |  2 +-
 .../index/suggest/stats/SuggestStatsIT.java   |  4 +-
 .../indices/IndicesRequestCacheIT.java        | 20 ++++----
 .../indices/analyze/AnalyzeActionIT.java      |  6 +--
 .../breaker/CircuitBreakerServiceIT.java      |  2 +-
 .../recovery/IndexPrimaryRelocationIT.java    |  2 +-
 .../indices/stats/IndexStatsIT.java           |  4 +-
 .../template/SimpleIndexTemplateIT.java       |  6 +--
 .../recovery/TruncatedRecoveryIT.java         |  2 +-
 .../AggregationsIntegrationIT.java            |  2 +-
 .../search/aggregations/MetaDataIT.java       |  2 +-
 .../search/aggregations/MissingValueIT.java   |  2 +-
 .../bucket/AdjacencyMatrixIT.java             |  2 +-
 .../aggregations/bucket/DateHistogramIT.java  | 16 +++---
 .../bucket/DateHistogramOffsetIT.java         |  2 +-
 .../aggregations/bucket/DateRangeIT.java      |  8 +--
 .../bucket/DiversifiedSamplerIT.java          |  6 +--
 .../aggregations/bucket/DoubleTermsIT.java    |  6 +--
 .../search/aggregations/bucket/FilterIT.java  |  2 +-
 .../search/aggregations/bucket/FiltersIT.java |  2 +-
 .../aggregations/bucket/GeoDistanceIT.java    |  6 +--
 .../aggregations/bucket/GeoHashGridIT.java    |  4 +-
 .../aggregations/bucket/HistogramIT.java      |  8 +--
 .../search/aggregations/bucket/IpRangeIT.java |  2 +-
 .../search/aggregations/bucket/IpTermsIT.java |  6 +--
 .../aggregations/bucket/LongTermsIT.java      |  4 +-
 .../aggregations/bucket/MinDocCountIT.java    |  2 +-
 .../search/aggregations/bucket/MissingIT.java |  4 +-
 .../aggregations/bucket/NaNSortingIT.java     |  2 +-
 .../search/aggregations/bucket/NestedIT.java  | 10 ++--
 .../search/aggregations/bucket/RangeIT.java   |  8 +--
 .../search/aggregations/bucket/SamplerIT.java |  6 +--
 .../aggregations/bucket/ShardReduceIT.java    |  2 +-
 .../bucket/ShardSizeTestCase.java             |  2 +-
 .../SignificantTermsSignificanceScoreIT.java  |  9 ++--
 .../bucket/TermsDocCountErrorIT.java          | 10 ++--
 .../bucket/TermsShardMinDocCountIT.java       |  5 +-
 .../bucket/terms/StringTermsIT.java           | 10 ++--
 .../metrics/AbstractGeoTestCase.java          | 10 ++--
 .../aggregations/metrics/CardinalityIT.java   |  2 +-
 .../aggregations/metrics/ExtendedStatsIT.java |  2 +-
 .../metrics/HDRPercentileRanksIT.java         |  2 +-
 .../metrics/HDRPercentilesIT.java             |  2 +-
 .../metrics/MedianAbsoluteDeviationIT.java    |  4 +-
 .../metrics/ScriptedMetricIT.java             |  4 +-
 .../search/aggregations/metrics/StatsIT.java  |  2 +-
 .../search/aggregations/metrics/SumIT.java    |  6 +--
 .../metrics/TDigestPercentileRanksIT.java     |  2 +-
 .../metrics/TDigestPercentilesIT.java         |  2 +-
 .../aggregations/metrics/TopHitsIT.java       |  6 +--
 .../aggregations/metrics/ValueCountIT.java    |  2 +-
 .../aggregations/pipeline/AvgBucketIT.java    |  4 +-
 .../pipeline/DateDerivativeIT.java            |  2 +-
 .../aggregations/pipeline/DerivativeIT.java   |  4 +-
 .../pipeline/ExtendedStatsBucketIT.java       |  4 +-
 .../aggregations/pipeline/MaxBucketIT.java    |  4 +-
 .../aggregations/pipeline/MinBucketIT.java    |  4 +-
 .../pipeline/PercentilesBucketIT.java         |  4 +-
 .../aggregations/pipeline/StatsBucketIT.java  |  4 +-
 .../aggregations/pipeline/SumBucketIT.java    |  4 +-
 .../search/basic/SearchWhileRelocatingIT.java |  2 +-
 .../basic/TransportSearchFailuresIT.java      |  2 +-
 .../basic/TransportTwoNodesSearchIT.java      |  2 +-
 .../search/fetch/subphase/InnerHitsIT.java    | 12 ++---
 .../highlight/HighlighterSearchIT.java        | 50 +++++++++----------
 .../search/fields/SearchFieldsIT.java         |  6 +--
 .../functionscore/RandomScoreFunctionIT.java  |  2 +-
 .../search/geo/GeoPolygonIT.java              |  2 +-
 .../search/geo/GeoShapeIntegrationIT.java     |  4 +-
 .../search/geo/GeoShapeQueryTests.java        | 24 ++++-----
 .../geo/LegacyGeoShapeIntegrationIT.java      |  4 +-
 .../search/morelikethis/MoreLikeThisIT.java   | 10 ++--
 .../search/nested/SimpleNestedIT.java         |  3 +-
 .../aggregation/AggregationProfilerIT.java    |  2 +-
 .../search/query/MultiMatchQueryIT.java       |  2 +-
 .../search/query/ScriptScoreQueryIT.java      |  6 +--
 .../search/query/SearchQueryIT.java           | 38 +++++++-------
 .../search/scroll/SearchScrollIT.java         |  2 +-
 .../search/searchafter/SearchAfterIT.java     | 15 +++---
 .../search/simple/SimpleSearchIT.java         |  4 +-
 .../search/sort/FieldSortIT.java              | 40 +++++++--------
 .../search/sort/GeoDistanceSortBuilderIT.java | 12 ++---
 .../search/source/MetadataFetchingIT.java     |  2 +-
 .../search/suggest/SuggestSearchIT.java       | 14 +++---
 .../SharedSignificantTermsTestMethods.java    |  2 +-
 .../org/elasticsearch/update/UpdateIT.java    |  1 -
 .../validate/SimpleValidateQueryIT.java       |  8 +--
 .../metrics/AbstractNumericTestCase.java      |  2 +-
 .../test/ESSingleNodeTestCase.java            |  2 +-
 .../snapshots/SourceOnlySnapshotIT.java       |  2 +-
 .../action/ReloadSynonymAnalyzerTests.java    |  9 ++--
 .../rest/action/ReloadSynonymAnalyzerIT.java  |  2 +-
 .../xpack/enrich/AbstractEnrichTestCase.java  |  2 +-
 .../xpack/graph/test/GraphTests.java          |  2 +-
 .../ml/integration/BulkFailureRetryIT.java    |  2 +-
 .../ml/integration/CategorizationIT.java      |  5 +-
 .../ClassificationEvaluationIT.java           |  2 +-
 .../ml/integration/ClassificationIT.java      |  2 +-
 .../xpack/ml/integration/DatafeedJobsIT.java  | 12 ++---
 .../ml/integration/DatafeedWithAggsIT.java    |  2 +-
 .../ml/integration/DelayedDataDetectorIT.java |  2 +-
 .../ml/integration/DeleteExpiredDataIT.java   |  3 +-
 .../ExplainDataFrameAnalyticsIT.java          |  2 +-
 .../xpack/ml/integration/ModelPlotsIT.java    |  3 +-
 .../OutlierDetectionWithMissingFieldsIT.java  |  2 +-
 .../xpack/ml/integration/RegressionIT.java    |  2 +-
 .../integration/RunDataFrameAnalyticsIT.java  | 22 ++++----
 .../ml/integration/SetUpgradeModeIT.java      |  2 +-
 .../integration/BasicDistributedJobsIT.java   |  2 +-
 .../integration/MlDistributedFailureIT.java   |  8 +--
 .../DocumentAndFieldLevelSecurityTests.java   | 14 +++---
 .../DocumentLevelSecurityRandomTests.java     |  2 +-
 .../DocumentLevelSecurityTests.java           | 28 +++++------
 .../FieldLevelSecurityRandomTests.java        |  4 +-
 .../integration/FieldLevelSecurityTests.java  | 36 ++++++-------
 ...onsWithAliasesWildcardsAndRegexsTests.java |  2 +-
 .../xpack/spatial/search/ShapeQueryTests.java |  9 ++--
 .../ArrayCompareConditionSearchTests.java     |  2 -
 .../test/integration/BasicWatcherTests.java   |  2 +-
 141 files changed, 458 insertions(+), 470 deletions(-)

diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/HighlighterWithAnalyzersTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/HighlighterWithAnalyzersTests.java
index df297407f79ec..e54789c370327 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/HighlighterWithAnalyzersTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/HighlighterWithAnalyzersTests.java
@@ -121,7 +121,7 @@ public void testMultiPhraseCutoff() throws IOException {
          * query. We cut off and extract terms if there are more than 16 terms in the query
          */
         assertAcked(prepareCreate("test")
-                .addMapping("test", "body", "type=text,analyzer=custom_analyzer,"
+                .setMapping("body", "type=text,analyzer=custom_analyzer,"
                         + "search_analyzer=custom_analyzer,term_vector=with_positions_offsets")
                 .setSettings(
                         Settings.builder().put(indexSettings())
@@ -173,7 +173,7 @@ public void testSynonyms() throws IOException {
             .putList("index.analysis.filter.synonym.synonyms", "fast,quick");
 
         assertAcked(prepareCreate("test").setSettings(builder.build())
-            .addMapping("type1", "field1",
+            .setMapping("field1",
                 "type=text,term_vector=with_positions_offsets,search_analyzer=synonym," +
                     "analyzer=standard,index_options=offsets"));
         ensureGreen();
@@ -269,7 +269,7 @@ public void testPhrasePrefix() throws IOException {
             equalTo("The <x>quick</x> <x>browse</x> button is a fancy thing, right bro?"),
             equalTo("The <x>quick</x> <x>brown</x> fox jumps over the lazy dog")));
 
-        assertAcked(prepareCreate("second_test_index").setSettings(builder.build()).addMapping("doc",
+        assertAcked(prepareCreate("second_test_index").setSettings(builder.build()).setMapping(
             "field4", "type=text,term_vector=with_positions_offsets,analyzer=synonym",
             "field3", "type=text,analyzer=synonym"));
         // with synonyms
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/QueryStringWithAnalyzersTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/QueryStringWithAnalyzersTests.java
index 604270751e9c9..215bf3e9f0f2c 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/QueryStringWithAnalyzersTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/QueryStringWithAnalyzersTests.java
@@ -55,7 +55,7 @@ public void testCustomWordDelimiterQueryString() {
                         .put("analysis.filter.custom_word_delimiter.split_on_case_change", "false")
                         .put("analysis.filter.custom_word_delimiter.split_on_numerics", "false")
                         .put("analysis.filter.custom_word_delimiter.stem_english_possessive", "false"))
-                .addMapping("type1",
+                .setMapping(
                         "field1", "type=text,analyzer=my_analyzer",
                         "field2", "type=text,analyzer=my_analyzer"));
 
diff --git a/modules/lang-expression/src/test/java/org/elasticsearch/script/expression/MoreExpressionTests.java b/modules/lang-expression/src/test/java/org/elasticsearch/script/expression/MoreExpressionTests.java
index 4af3bb35021ca..09802d5ec3f2c 100644
--- a/modules/lang-expression/src/test/java/org/elasticsearch/script/expression/MoreExpressionTests.java
+++ b/modules/lang-expression/src/test/java/org/elasticsearch/script/expression/MoreExpressionTests.java
@@ -143,7 +143,7 @@ public void testScore() throws Exception {
     }
 
     public void testDateMethods() throws Exception {
-        ElasticsearchAssertions.assertAcked(prepareCreate("test").addMapping("doc", "date0", "type=date", "date1", "type=date"));
+        ElasticsearchAssertions.assertAcked(prepareCreate("test").setMapping("date0", "type=date", "date1", "type=date"));
         ensureGreen("test");
         indexRandom(true,
                 client().prepareIndex("test").setId("1")
@@ -173,7 +173,7 @@ public void testDateMethods() throws Exception {
     }
 
     public void testDateObjectMethods() throws Exception {
-        ElasticsearchAssertions.assertAcked(prepareCreate("test").addMapping("doc", "date0", "type=date", "date1", "type=date"));
+        ElasticsearchAssertions.assertAcked(prepareCreate("test").setMapping("date0", "type=date", "date1", "type=date"));
         ensureGreen("test");
         indexRandom(true,
                 client().prepareIndex("test").setId("1")
@@ -203,7 +203,7 @@ public void testDateObjectMethods() throws Exception {
     }
 
     public void testMultiValueMethods() throws Exception {
-        ElasticsearchAssertions.assertAcked(prepareCreate("test").addMapping("doc",
+        ElasticsearchAssertions.assertAcked(prepareCreate("test").setMapping(
                 "double0", "type=double",
                 "double1", "type=double",
                 "double2", "type=double"));
@@ -307,7 +307,7 @@ public void testMultiValueMethods() throws Exception {
     }
 
     public void testInvalidDateMethodCall() throws Exception {
-        ElasticsearchAssertions.assertAcked(prepareCreate("test").addMapping("doc", "double", "type=double"));
+        ElasticsearchAssertions.assertAcked(prepareCreate("test").setMapping("double", "type=double"));
         ensureGreen("test");
         indexRandom(true, client().prepareIndex("test").setId("1").setSource("double", "178000000.0"));
         try {
@@ -322,7 +322,7 @@ public void testInvalidDateMethodCall() throws Exception {
     }
 
     public void testSparseField() throws Exception {
-        ElasticsearchAssertions.assertAcked(prepareCreate("test").addMapping("doc", "x", "type=long", "y", "type=long"));
+        ElasticsearchAssertions.assertAcked(prepareCreate("test").setMapping("x", "type=long", "y", "type=long"));
         ensureGreen("test");
         indexRandom(true,
                 client().prepareIndex("test").setId("1").setSource("id", 1, "x", 4),
@@ -490,7 +490,7 @@ public void testSpecialValueVariable() throws Exception {
     public void testStringSpecialValueVariable() throws Exception {
         // i.e. expression script for term aggregations, which is not allowed
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("doc", "text", "type=keyword").get());
+                .setMapping("text", "type=keyword").get());
         ensureGreen("test");
         indexRandom(true,
                 client().prepareIndex("test").setId("1").setSource("text", "hello"),
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
index 2c8f608830f40..a56d74a397097 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
@@ -68,7 +68,7 @@ public class PercolatorQuerySearchIT extends ESIntegTestCase {
 
     public void testPercolatorQuery() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "id", "type=keyword", "field1", "type=keyword", "field2", "type=keyword", "query", "type=percolator")
+                .setMapping("id", "type=keyword", "field1", "type=keyword", "field2", "type=keyword", "query", "type=percolator")
         );
 
         client().prepareIndex("test").setId("1")
@@ -143,7 +143,7 @@ public void testPercolatorQuery() throws Exception {
 
     public void testPercolatorRangeQueries() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "field1", "type=long", "field2", "type=double", "field3", "type=ip", "field4", "type=date",
+                .setMapping("field1", "type=long", "field2", "type=double", "field3", "type=ip", "field4", "type=date",
                         "query", "type=percolator")
         );
 
@@ -253,7 +253,7 @@ public void testPercolatorRangeQueries() throws Exception {
 
     public void testPercolatorGeoQueries() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-            .addMapping("type", "id", "type=keyword",
+            .setMapping("id", "type=keyword",
                 "field1", "type=geo_point", "field2", "type=geo_shape", "query", "type=percolator"));
 
         client().prepareIndex("test").setId("1")
@@ -291,7 +291,7 @@ public void testPercolatorGeoQueries() throws Exception {
 
     public void testPercolatorQueryExistingDocument() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "id", "type=keyword", "field1", "type=keyword", "field2", "type=keyword", "query", "type=percolator")
+                .setMapping("id", "type=keyword", "field1", "type=keyword", "field2", "type=keyword", "query", "type=percolator")
         );
 
         client().prepareIndex("test").setId("1")
@@ -345,7 +345,7 @@ public void testPercolatorQueryExistingDocument() throws Exception {
 
     public void testPercolatorQueryExistingDocumentSourceDisabled() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-            .addMapping("type", "_source", "enabled=false", "field1", "type=keyword", "query", "type=percolator")
+            .setMapping("_source", "enabled=false", "field1", "type=keyword", "query", "type=percolator")
         );
 
         client().prepareIndex("test").setId("1")
@@ -366,7 +366,7 @@ public void testPercolatorQueryExistingDocumentSourceDisabled() throws Exception
 
     public void testPercolatorSpecificQueries()  throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "id", "type=keyword", "field1", "type=text", "field2", "type=text", "query", "type=percolator")
+                .setMapping("id", "type=keyword", "field1", "type=text", "field2", "type=text", "query", "type=percolator")
         );
 
         client().prepareIndex("test").setId("1")
@@ -447,7 +447,7 @@ public void testPercolatorQueryWithHighlighting() throws Exception {
             fieldMapping.append(",index_options=offsets");
         }
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "id", "type=keyword", "field1", fieldMapping, "query", "type=percolator")
+                .setMapping("id", "type=keyword", "field1", fieldMapping, "query", "type=percolator")
         );
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject()
@@ -613,7 +613,7 @@ public void testPercolatorQueryWithHighlighting() throws Exception {
 
     public void testTakePositionOffsetGapIntoAccount() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "field", "type=text,position_increment_gap=5", "query", "type=percolator")
+                .setMapping("field", "type=text,position_increment_gap=5", "query", "type=percolator")
         );
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject().field("query",
@@ -636,10 +636,10 @@ public void testTakePositionOffsetGapIntoAccount() throws Exception {
     public void testManyPercolatorFields() throws Exception {
         String queryFieldName = randomAlphaOfLength(8);
         assertAcked(client().admin().indices().prepareCreate("test1")
-                .addMapping("type", queryFieldName, "type=percolator", "field", "type=keyword")
+                .setMapping(queryFieldName, "type=percolator", "field", "type=keyword")
         );
         assertAcked(client().admin().indices().prepareCreate("test2")
-            .addMapping("type", queryFieldName, "type=percolator", "second_query_field", "type=percolator", "field", "type=keyword")
+            .setMapping(queryFieldName, "type=percolator", "second_query_field", "type=percolator", "field", "type=keyword")
         );
         assertAcked(client().admin().indices().prepareCreate("test3")
             .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
@@ -662,7 +662,7 @@ public void testManyPercolatorFields() throws Exception {
     public void testWithMultiplePercolatorFields() throws Exception {
         String queryFieldName = randomAlphaOfLength(8);
         assertAcked(client().admin().indices().prepareCreate("test1")
-                .addMapping("type", queryFieldName, "type=percolator", "field", "type=keyword"));
+                .setMapping(queryFieldName, "type=percolator", "field", "type=keyword"));
         assertAcked(client().admin().indices().prepareCreate("test2")
                 .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field")
@@ -802,7 +802,7 @@ public void testPercolateQueryWithNestedDocuments() throws Exception {
 
     public void testPercolatorQueryViaMultiSearch() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-            .addMapping("type", "field1", "type=text", "query", "type=percolator")
+            .setMapping("field1", "type=text", "query", "type=percolator")
         );
 
         client().prepareIndex("test").setId("1")
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchTests.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchTests.java
index 60bc92b8e550f..e91a8cf1783e7 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchTests.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchTests.java
@@ -83,7 +83,7 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
     }
 
     public void testPercolateScriptQuery() throws IOException {
-        client().admin().indices().prepareCreate("index").addMapping("type", "query", "type=percolator").get();
+        client().admin().indices().prepareCreate("index").setMapping("query", "type=percolator").get();
         client().prepareIndex("index").setId("1")
             .setSource(jsonBuilder().startObject().field("query", QueryBuilders.scriptQuery(
                 new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "1==1", Collections.emptyMap()))).endObject())
diff --git a/plugins/mapper-size/src/test/java/org/elasticsearch/index/mapper/size/SizeMappingIT.java b/plugins/mapper-size/src/test/java/org/elasticsearch/index/mapper/size/SizeMappingIT.java
index f5ce504593085..dff60f6d64282 100644
--- a/plugins/mapper-size/src/test/java/org/elasticsearch/index/mapper/size/SizeMappingIT.java
+++ b/plugins/mapper-size/src/test/java/org/elasticsearch/index/mapper/size/SizeMappingIT.java
@@ -103,7 +103,7 @@ private void assertSizeMappingEnabled(String index, boolean enabled) throws IOEx
     }
 
     public void testBasic() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type", "_size", "enabled=true"));
+        assertAcked(prepareCreate("test").setMapping("_size", "enabled=true"));
         final String source = "{\"f\":10}";
         indexRandom(true,
                 client().prepareIndex("test").setId("1").setSource(source, XContentType.JSON));
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
index f30fc715e42e8..74298b3960486 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
@@ -231,20 +231,6 @@ public CreateIndexRequest mapping(String mapping) {
         return this;
     }
 
-    private CreateIndexRequest mapping(BytesReference source, XContentType xContentType) {
-        Objects.requireNonNull(xContentType);
-        Map<String, Object> mappingAsMap = XContentHelper.convertToMap(source, false, xContentType).v2();
-        return mapping(MapperService.SINGLE_MAPPING_NAME, mappingAsMap);
-    }
-
-    /**
-     * The cause for this index creation.
-     */
-    public CreateIndexRequest cause(String cause) {
-        this.cause = cause;
-        return this;
-    }
-
     /**
      * Set the mapping for this index
      *
@@ -263,6 +249,21 @@ public CreateIndexRequest mapping(Map<String, ?> source) {
         return mapping(MapperService.SINGLE_MAPPING_NAME, source);
     }
 
+    /**
+     * A specialized simplified mapping source method, takes the form of simple properties definition:
+     * ("field1", "type=string,store=true").
+     */
+    public CreateIndexRequest simpleMapping(Object... source) {
+        mapping(PutMappingRequest.buildFromSimplifiedDef(MapperService.SINGLE_MAPPING_NAME, source));
+        return this;
+    }
+
+    private CreateIndexRequest mapping(BytesReference source, XContentType xContentType) {
+        Objects.requireNonNull(xContentType);
+        Map<String, Object> mappingAsMap = XContentHelper.convertToMap(source, false, xContentType).v2();
+        return mapping(MapperService.SINGLE_MAPPING_NAME, mappingAsMap);
+    }
+
     private CreateIndexRequest mapping(String type, Map<String, ?> source) {
         // wrap it in a type map if its not
         if (source.size() != 1 || !source.containsKey(type)) {
@@ -282,11 +283,10 @@ else if (MapperService.SINGLE_MAPPING_NAME.equals(type) == false) {
     }
 
     /**
-     * A specialized simplified mapping source method, takes the form of simple properties definition:
-     * ("field1", "type=string,store=true").
+     * The cause for this index creation.
      */
-    public CreateIndexRequest mapping(String type, Object... source) {
-        mapping(PutMappingRequest.buildFromSimplifiedDef(MapperService.SINGLE_MAPPING_NAME, source));
+    public CreateIndexRequest cause(String cause) {
+        this.cause = cause;
         return this;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
index bf357c2b5b990..829ddbe05caeb 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
@@ -135,8 +135,8 @@ public CreateIndexRequestBuilder setMapping(Map<String, Object> source) {
      * A specialized simplified mapping source method, takes the form of simple properties definition:
      * ("field1", "type=string,store=true").
      */
-    public CreateIndexRequestBuilder addMapping(String type, Object... source) {
-        request.mapping(type, source);
+    public CreateIndexRequestBuilder setMapping(Object... source) {
+        request.simpleMapping(source);
         return this;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestBuilder.java
index 85867b11ad618..4451c2b481bf7 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestBuilder.java
@@ -75,12 +75,12 @@ public RolloverRequestBuilder alias(Alias alias) {
     }
 
     public RolloverRequestBuilder mapping(String type, Object... source) {
-        this.request.getCreateIndexRequest().mapping(type, source);
+        this.request.getCreateIndexRequest().simpleMapping(source);
         return this;
     }
 
     public RolloverRequestBuilder mapping(String type, String source, XContentType xContentType) {
-        this.request.getCreateIndexRequest().mapping(type, source, xContentType);
+        this.request.getCreateIndexRequest().mapping(source);
         return this;
     }
 
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/create/ShrinkIndexIT.java b/server/src/test/java/org/elasticsearch/action/admin/indices/create/ShrinkIndexIT.java
index 88a090757d5bc..428ffa1e603cc 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/create/ShrinkIndexIT.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/create/ShrinkIndexIT.java
@@ -425,7 +425,7 @@ public void testCreateShrinkWithIndexSort() throws Exception {
                     .put("number_of_shards", 8)
                     .put("number_of_replicas", 0)
             )
-            .addMapping("_doc", "id", "type=keyword,doc_values=true")
+            .setMapping("id", "type=keyword,doc_values=true")
             .get();
         for (int i = 0; i < 20; i++) {
             client().prepareIndex("source").setId(Integer.toString(i))
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/create/SplitIndexIT.java b/server/src/test/java/org/elasticsearch/action/admin/indices/create/SplitIndexIT.java
index 37d20b4ae2481..966ee94ddeb94 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/create/SplitIndexIT.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/create/SplitIndexIT.java
@@ -122,12 +122,12 @@ private void splitToN(int sourceShards, int firstSplitShards, int secondSplitSha
             settings.put("index.routing_partition_size",
                 randomIntBetween(1, numRoutingShards));
             if (useNested) {
-                createInitialIndex.addMapping("_doc", "_routing", "required=true", "nested1", "type=nested");
+                createInitialIndex.setMapping("_routing", "required=true", "nested1", "type=nested");
             } else {
-                createInitialIndex.addMapping("_doc", "_routing", "required=true");
+                createInitialIndex.setMapping("_routing", "required=true");
             }
         } else if (useNested) {
-            createInitialIndex.addMapping("_doc", "nested1", "type=nested");
+            createInitialIndex.setMapping("nested1", "type=nested");
         }
         logger.info("use routing {} use mixed routing {} use nested {}", useRouting, useMixedRouting, useNested);
         createInitialIndex.setSettings(settings).get();
@@ -465,7 +465,7 @@ public void testCreateSplitWithIndexSort() throws Exception {
                     .put("number_of_shards", 2)
                     .put("number_of_replicas", 0)
             )
-            .addMapping("_doc", "id", "type=keyword,doc_values=true")
+            .setMapping("id", "type=keyword,doc_values=true")
             .get();
         for (int i = 0; i < 20; i++) {
             client().prepareIndex("source").setId(Integer.toString(i))
diff --git a/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsIT.java b/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsIT.java
index 6fc29a5f314c9..f030f0123e25a 100644
--- a/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsIT.java
+++ b/server/src/test/java/org/elasticsearch/action/termvectors/GetTermVectorsIT.java
@@ -147,7 +147,7 @@ public void testNotIndexedField() throws Exception {
         // must be of type string and indexed.
         assertAcked(prepareCreate("test")
                 .addAlias(new Alias("alias"))
-                .addMapping("type1",
+                .setMapping(
                         "field0", "type=integer,", // no tvs
                         "field1", "type=text,index=false", // no tvs
                         "field2", "type=text,index=false,store=true",  // no tvs
@@ -474,9 +474,9 @@ public void testDuelWithAndWithoutTermVectors() throws IOException, ExecutionExc
         // setup indices
         String[] indexNames = new String[] {"with_tv", "without_tv"};
         assertAcked(prepareCreate(indexNames[0])
-                .addMapping("type1", "field1", "type=text,term_vector=with_positions_offsets,analyzer=keyword"));
+                .setMapping("field1", "type=text,term_vector=with_positions_offsets,analyzer=keyword"));
         assertAcked(prepareCreate(indexNames[1])
-                .addMapping("type1", "field1", "type=text,term_vector=no,analyzer=keyword"));
+                .setMapping("field1", "type=text,term_vector=no,analyzer=keyword"));
         ensureGreen();
 
         // index documents with and without term vectors
@@ -591,7 +591,7 @@ public void testArtificialVsExisting() throws ExecutionException, InterruptedExc
                 .put("index.analysis.analyzer", "standard");
         assertAcked(prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type1", "field1", "type=text,term_vector=with_positions_offsets"));
+                .setMapping("field1", "type=text,term_vector=with_positions_offsets"));
         ensureGreen();
 
         // index documents existing document
@@ -647,7 +647,7 @@ public void testArtificialNoDoc() throws IOException {
                 .put("index.analysis.analyzer", "standard");
         assertAcked(prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type1", "field1", "type=text"));
+                .setMapping("field1", "type=text"));
         ensureGreen();
 
         // request tvs from artificial document
@@ -884,7 +884,7 @@ public void testFilterLength() throws ExecutionException, InterruptedException,
                 .put("index.analysis.analyzer", "keyword");
         assertAcked(prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type1", "tags", "type=text"));
+                .setMapping("tags", "type=text"));
 
         int numTerms = scaledRandomIntBetween(10, 50);
         logger.info("Indexing one document with tags of increasing length ...");
@@ -921,7 +921,7 @@ public void testFilterTermFreq() throws ExecutionException, InterruptedException
                 .put("index.analysis.analyzer", "keyword");
         assertAcked(prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type1", "tags", "type=text"));
+                .setMapping("tags", "type=text"));
 
         logger.info("Indexing one document with tags of increasing frequencies ...");
         int numTerms = scaledRandomIntBetween(10, 50);
@@ -961,7 +961,7 @@ public void testFilterDocFreq() throws ExecutionException, InterruptedException,
                 .put("index.number_of_shards", 1); // no dfs
         assertAcked(prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type1", "tags", "type=text"));
+                .setMapping("tags", "type=text"));
 
         int numDocs = scaledRandomIntBetween(10, 50); // as many terms as there are docs
         logger.info("Indexing {} documents with tags of increasing dfs ...", numDocs);
@@ -995,7 +995,7 @@ public void testArtificialDocWithPreference() throws ExecutionException, Interru
                 .put("index.analysis.analyzer", "standard");
         assertAcked(prepareCreate("test")
                 .setSettings(settings)
-                .addMapping("type1", "field1", "type=text,term_vector=with_positions_offsets"));
+                .setMapping("field1", "type=text,term_vector=with_positions_offsets"));
         ensureGreen();
 
         // index document
@@ -1038,10 +1038,10 @@ public void testWithKeywordAndNormalizer() throws IOException, ExecutionExceptio
             .putList("index.analysis.analyzer.my_analyzer.filter", "lowercase")
             .putList("index.analysis.normalizer.my_normalizer.filter", "lowercase");
         assertAcked(prepareCreate(indexNames[0]).setSettings(builder.build())
-            .addMapping("type1", "field1", "type=text,term_vector=with_positions_offsets,analyzer=my_analyzer",
+            .setMapping("field1", "type=text,term_vector=with_positions_offsets,analyzer=my_analyzer",
                 "field2", "type=text,term_vector=with_positions_offsets,analyzer=keyword"));
         assertAcked(prepareCreate(indexNames[1]).setSettings(builder.build())
-            .addMapping("type1", "field1", "type=keyword,normalizer=my_normalizer", "field2", "type=keyword"));
+            .setMapping("field1", "type=keyword,normalizer=my_normalizer", "field2", "type=keyword"));
         ensureGreen();
 
         // index documents with and without term vectors
diff --git a/server/src/test/java/org/elasticsearch/aliases/IndexAliasesIT.java b/server/src/test/java/org/elasticsearch/aliases/IndexAliasesIT.java
index b4e8553e60602..aa28c27d1a21a 100644
--- a/server/src/test/java/org/elasticsearch/aliases/IndexAliasesIT.java
+++ b/server/src/test/java/org/elasticsearch/aliases/IndexAliasesIT.java
@@ -193,7 +193,7 @@ public void testFailedFilter() throws Exception {
 
     public void testFilteringAliases() throws Exception {
         logger.info("--> creating index [test]");
-        assertAcked(prepareCreate("test").addMapping("type", "user", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("user", "type=text"));
 
         ensureGreen();
 
@@ -223,7 +223,7 @@ public void testEmptyFilter() throws Exception {
 
     public void testSearchingFilteringAliasesSingleIndex() throws Exception {
         logger.info("--> creating index [test]");
-        assertAcked(prepareCreate("test").addMapping("type1", "id", "type=text", "name", "type=text,fielddata=true"));
+        assertAcked(prepareCreate("test").setMapping("id", "type=text", "name", "type=text,fielddata=true"));
 
         ensureGreen();
 
@@ -314,9 +314,9 @@ public void testSearchingFilteringAliasesSingleIndex() throws Exception {
 
     public void testSearchingFilteringAliasesTwoIndices() throws Exception {
         logger.info("--> creating index [test1]");
-        assertAcked(prepareCreate("test1").addMapping("type1", "name", "type=text"));
+        assertAcked(prepareCreate("test1").setMapping("name", "type=text"));
         logger.info("--> creating index [test2]");
-        assertAcked(prepareCreate("test2").addMapping("type1", "name", "type=text"));
+        assertAcked(prepareCreate("test2").setMapping("name", "type=text"));
         ensureGreen();
 
         logger.info("--> adding filtering aliases to index [test1]");
@@ -468,8 +468,8 @@ public void testSearchingFilteringAliasesMultipleIndices() throws Exception {
 
     public void testDeletingByQueryFilteringAliases() throws Exception {
         logger.info("--> creating index [test1] and [test2");
-        assertAcked(prepareCreate("test1").addMapping("type1", "name", "type=text"));
-        assertAcked(prepareCreate("test2").addMapping("type1", "name", "type=text"));
+        assertAcked(prepareCreate("test1").setMapping("name", "type=text"));
+        assertAcked(prepareCreate("test2").setMapping("name", "type=text"));
         ensureGreen();
 
         logger.info("--> adding filtering aliases to index [test1]");
@@ -516,8 +516,8 @@ public void testDeletingByQueryFilteringAliases() throws Exception {
 
     public void testDeleteAliases() throws Exception {
         logger.info("--> creating index [test1] and [test2]");
-        assertAcked(prepareCreate("test1").addMapping("type", "name", "type=text"));
-        assertAcked(prepareCreate("test2").addMapping("type", "name", "type=text"));
+        assertAcked(prepareCreate("test1").setMapping("name", "type=text"));
+        assertAcked(prepareCreate("test2").setMapping("name", "type=text"));
         ensureGreen();
 
         logger.info("--> adding filtering aliases to index [test1]");
@@ -632,9 +632,9 @@ public void run() {
         }
     }
 
-    public void testSameAlias() throws Exception {
+    public void testSameAlias() {
         logger.info("--> creating index [test]");
-        assertAcked(prepareCreate("test").addMapping("type", "name", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("name", "type=text"));
         ensureGreen();
 
         logger.info("--> creating alias1 ");
@@ -904,9 +904,9 @@ public void testGetAllAliasesWorks() {
         assertThat(response.getAliases(), hasKey("index1"));
     }
 
-    public void testCreateIndexWithAliases() throws Exception {
+    public void testCreateIndexWithAliases() {
         assertAcked(prepareCreate("test")
-                .addMapping("type", "field", "type=text")
+                .setMapping("field", "type=text")
                 .addAlias(new Alias("alias1"))
                 .addAlias(new Alias("alias2").filter(QueryBuilders.boolQuery().mustNot(QueryBuilders.existsQuery("field"))))
                 .addAlias(new Alias("alias3").indexRouting("index").searchRouting("search")));
@@ -926,9 +926,9 @@ public void testCreateIndexWithAliasesInSource() throws Exception {
         checkAliases();
     }
 
-    public void testCreateIndexWithAliasesSource() throws Exception {
+    public void testCreateIndexWithAliasesSource() {
         assertAcked(prepareCreate("test")
-                .addMapping("type", "field", "type=text")
+                .setMapping("field", "type=text")
                 .setAliases("{\n" +
                         "        \"alias1\" : {},\n" +
                         "        \"alias2\" : {\"filter\" : {\"term\": {\"field\":\"value\"}}},\n" +
@@ -1005,8 +1005,8 @@ public void testAddAliasWithFilterNoMapping() throws Exception {
                         .get());
     }
 
-    public void testAliasFilterWithNowInRangeFilterAndQuery() throws Exception {
-        assertAcked(prepareCreate("my-index").addMapping("my-type", "timestamp", "type=date"));
+    public void testAliasFilterWithNowInRangeFilterAndQuery() {
+        assertAcked(prepareCreate("my-index").setMapping("timestamp", "type=date"));
         assertAliasesVersionIncreases(
                 "my-index",
                 () -> assertAcked(admin().indices()
diff --git a/server/src/test/java/org/elasticsearch/cluster/coordination/RareClusterStateIT.java b/server/src/test/java/org/elasticsearch/cluster/coordination/RareClusterStateIT.java
index 0b3798ac53fa8..fe330f1a9903b 100644
--- a/server/src/test/java/org/elasticsearch/cluster/coordination/RareClusterStateIT.java
+++ b/server/src/test/java/org/elasticsearch/cluster/coordination/RareClusterStateIT.java
@@ -152,7 +152,7 @@ public void testDeleteCreateInOneBulk() throws Exception {
         internalCluster().startMasterOnlyNode();
         String dataNode = internalCluster().startDataOnlyNode();
         assertFalse(client().admin().cluster().prepareHealth().setWaitForNodes("2").get().isTimedOut());
-        prepareCreate("test").setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)).addMapping("type").get();
+        prepareCreate("test").setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)).get();
         ensureGreen("test");
 
         // block none master node.
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataMappingServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataMappingServiceTests.java
index dce835bd651ea..d914e33a7865e 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataMappingServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataMappingServiceTests.java
@@ -44,7 +44,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testMappingClusterStateUpdateDoesntChangeExistingIndices() throws Exception {
-        final IndexService indexService = createIndex("test", client().admin().indices().prepareCreate("test").addMapping("type"));
+        final IndexService indexService = createIndex("test", client().admin().indices().prepareCreate("test").setMapping());
         final CompressedXContent currentMapping = indexService.mapperService().documentMapper().mappingSource();
 
         final MetaDataMappingService mappingService = getInstanceFromNode(MetaDataMappingService.class);
@@ -67,7 +67,7 @@ public void testMappingClusterStateUpdateDoesntChangeExistingIndices() throws Ex
     }
 
     public void testClusterStateIsNotChangedWithIdenticalMappings() throws Exception {
-        createIndex("test", client().admin().indices().prepareCreate("test").addMapping("type"));
+        createIndex("test", client().admin().indices().prepareCreate("test"));
 
         final MetaDataMappingService mappingService = getInstanceFromNode(MetaDataMappingService.class);
         final ClusterService clusterService = getInstanceFromNode(ClusterService.class);
@@ -85,7 +85,7 @@ public void testClusterStateIsNotChangedWithIdenticalMappings() throws Exception
     }
 
     public void testMappingVersion() throws Exception {
-        final IndexService indexService = createIndex("test", client().admin().indices().prepareCreate("test").addMapping("type"));
+        final IndexService indexService = createIndex("test", client().admin().indices().prepareCreate("test"));
         final long previousVersion = indexService.getMetaData().getMappingVersion();
         final MetaDataMappingService mappingService = getInstanceFromNode(MetaDataMappingService.class);
         final ClusterService clusterService = getInstanceFromNode(ClusterService.class);
@@ -100,7 +100,7 @@ public void testMappingVersion() throws Exception {
     }
 
     public void testMappingVersionUnchanged() throws Exception {
-        final IndexService indexService = createIndex("test", client().admin().indices().prepareCreate("test").addMapping("type"));
+        final IndexService indexService = createIndex("test", client().admin().indices().prepareCreate("test").setMapping());
         final long previousVersion = indexService.getMetaData().getMappingVersion();
         final MetaDataMappingService mappingService = getInstanceFromNode(MetaDataMappingService.class);
         final ClusterService clusterService = getInstanceFromNode(ClusterService.class);
diff --git a/server/src/test/java/org/elasticsearch/document/AliasedIndexDocumentActionsIT.java b/server/src/test/java/org/elasticsearch/document/AliasedIndexDocumentActionsIT.java
index 8d9cacd5f0ef7..88bc4cc11ee44 100644
--- a/server/src/test/java/org/elasticsearch/document/AliasedIndexDocumentActionsIT.java
+++ b/server/src/test/java/org/elasticsearch/document/AliasedIndexDocumentActionsIT.java
@@ -35,7 +35,7 @@ protected void createIndex() {
         }
         logger.info("--> creating index test");
         client().admin().indices().create(createIndexRequest("test1")
-                .mapping("type1", "name", "type=keyword,store=true")
+                .simpleMapping("name", "type=keyword,store=true")
                 .alias(new Alias("test"))).actionGet();
     }
 
diff --git a/server/src/test/java/org/elasticsearch/document/DocumentActionsIT.java b/server/src/test/java/org/elasticsearch/document/DocumentActionsIT.java
index 313335c3751b6..b83cf9188f06f 100644
--- a/server/src/test/java/org/elasticsearch/document/DocumentActionsIT.java
+++ b/server/src/test/java/org/elasticsearch/document/DocumentActionsIT.java
@@ -54,7 +54,7 @@
  */
 public class DocumentActionsIT extends ESIntegTestCase {
     protected void createIndex() {
-        ElasticsearchAssertions.assertAcked(prepareCreate(getConcreteIndexName()).addMapping("type1", "name", "type=keyword,store=true"));
+        ElasticsearchAssertions.assertAcked(prepareCreate(getConcreteIndexName()).setMapping("name", "type=keyword,store=true"));
     }
 
     protected String getConcreteIndexName() {
diff --git a/server/src/test/java/org/elasticsearch/document/ShardInfoIT.java b/server/src/test/java/org/elasticsearch/document/ShardInfoIT.java
index e7dde89ad6caa..75e406df76849 100644
--- a/server/src/test/java/org/elasticsearch/document/ShardInfoIT.java
+++ b/server/src/test/java/org/elasticsearch/document/ShardInfoIT.java
@@ -112,7 +112,7 @@ private void prepareIndex(int numberOfPrimaryShards, boolean routingRequired) th
                 Settings.builder()
                         .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, numberOfPrimaryShards)
                         .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, numCopies - 1))
-                .addMapping("type", "_routing", "required=" + routingRequired)
+                .setMapping("_routing", "required=" + routingRequired)
                 .get());
         for (int i = 0; i < numberOfPrimaryShards; i++) {
             ensureActiveShardCopies(i, numNodes);
diff --git a/server/src/test/java/org/elasticsearch/explain/ExplainActionIT.java b/server/src/test/java/org/elasticsearch/explain/ExplainActionIT.java
index 4c3af2123cb5c..0b227c264c218 100644
--- a/server/src/test/java/org/elasticsearch/explain/ExplainActionIT.java
+++ b/server/src/test/java/org/elasticsearch/explain/ExplainActionIT.java
@@ -107,7 +107,7 @@ public void testSimple() throws Exception {
 
     public void testExplainWithFields() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("test", "obj1.field1", "type=keyword,store=true", "obj1.field2", "type=keyword,store=true")
+                .setMapping("obj1.field1", "type=keyword,store=true", "obj1.field2", "type=keyword,store=true")
                 .addAlias(new Alias("alias")));
         ensureGreen("test");
 
@@ -201,7 +201,7 @@ public void testExplainWitSource() throws Exception {
 
     public void testExplainWithFilteredAlias() {
         assertAcked(prepareCreate("test")
-                .addMapping("test", "field2", "type=text")
+                .setMapping("field2", "type=text")
                 .addAlias(new Alias("alias1").filter(QueryBuilders.termQuery("field2", "value2"))));
         ensureGreen("test");
 
@@ -217,7 +217,7 @@ public void testExplainWithFilteredAlias() {
 
     public void testExplainWithFilteredAliasFetchSource() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("test", "field2", "type=text")
+                .setMapping("field2", "type=text")
                 .addAlias(new Alias("alias1").filter(QueryBuilders.termQuery("field2", "value2"))));
         ensureGreen("test");
 
diff --git a/server/src/test/java/org/elasticsearch/get/GetActionIT.java b/server/src/test/java/org/elasticsearch/get/GetActionIT.java
index 36a2170e9f9f5..cff716a651e95 100644
--- a/server/src/test/java/org/elasticsearch/get/GetActionIT.java
+++ b/server/src/test/java/org/elasticsearch/get/GetActionIT.java
@@ -70,7 +70,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
 
     public void testSimpleGet() {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "field1", "type=keyword,store=true", "field2", "type=keyword,store=true")
+                .setMapping("field1", "type=keyword,store=true", "field2", "type=keyword,store=true")
                 .setSettings(Settings.builder().put("index.refresh_interval", -1))
                 .addAlias(new Alias("alias").writeIndex(randomFrom(true, false, null))));
         ensureGreen();
@@ -219,7 +219,7 @@ static String indexOrAlias() {
 
     public void testSimpleMultiGet() throws Exception {
         assertAcked(prepareCreate("test").addAlias(new Alias("alias").writeIndex(randomFrom(true, false, null)))
-                .addMapping("type1", "field", "type=keyword,store=true")
+                .setMapping("field", "type=keyword,store=true")
                 .setSettings(Settings.builder().put("index.refresh_interval", -1)));
         ensureGreen();
 
diff --git a/server/src/test/java/org/elasticsearch/index/fieldstats/FieldStatsProviderRefreshTests.java b/server/src/test/java/org/elasticsearch/index/fieldstats/FieldStatsProviderRefreshTests.java
index daf68beaad83c..8af0cdfa931e0 100644
--- a/server/src/test/java/org/elasticsearch/index/fieldstats/FieldStatsProviderRefreshTests.java
+++ b/server/src/test/java/org/elasticsearch/index/fieldstats/FieldStatsProviderRefreshTests.java
@@ -38,7 +38,7 @@
 public class FieldStatsProviderRefreshTests extends ESSingleNodeTestCase {
 
     public void testQueryRewriteOnRefresh() throws Exception {
-        assertAcked(client().admin().indices().prepareCreate("index").addMapping("type", "s", "type=text")
+        assertAcked(client().admin().indices().prepareCreate("index").setMapping("s", "type=text")
                 .setSettings(Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)
                         .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1).put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0))
                 .get());
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
index bff53081cbd86..9e0d9155d43bd 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
@@ -676,7 +676,7 @@ public void testDynamicTemplateOrder() throws IOException {
     }
 
     public void testMappingVersionAfterDynamicMappingUpdate() {
-        createIndex("test", client().admin().indices().prepareCreate("test").addMapping("type"));
+        createIndex("test", client().admin().indices().prepareCreate("test"));
         final ClusterService clusterService = getInstanceFromNode(ClusterService.class);
         final long previousVersion = clusterService.state().metaData().index("test").getMappingVersion();
         client().prepareIndex("test").setId("1").setSource("field", "text").get();
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/UpdateMappingTests.java b/server/src/test/java/org/elasticsearch/index/mapper/UpdateMappingTests.java
index fa0eb08ad4c31..f948ad195110a 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/UpdateMappingTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/UpdateMappingTests.java
@@ -194,7 +194,7 @@ public void testRejectFieldDefinedTwice() throws IOException {
     }
 
     public void testMappingVersion() {
-        createIndex("test", client().admin().indices().prepareCreate("test").addMapping("type"));
+        createIndex("test", client().admin().indices().prepareCreate("test"));
         final ClusterService clusterService = getInstanceFromNode(ClusterService.class);
         {
             final long previousVersion = clusterService.state().metaData().index("test").getMappingVersion();
diff --git a/server/src/test/java/org/elasticsearch/index/suggest/stats/SuggestStatsIT.java b/server/src/test/java/org/elasticsearch/index/suggest/stats/SuggestStatsIT.java
index 429f22b3ea5f6..e41dd4d60dd8b 100644
--- a/server/src/test/java/org/elasticsearch/index/suggest/stats/SuggestStatsIT.java
+++ b/server/src/test/java/org/elasticsearch/index/suggest/stats/SuggestStatsIT.java
@@ -66,11 +66,11 @@ public void testSimpleStats() throws Exception {
         assertAcked(prepareCreate("test1").setSettings(Settings.builder()
                 .put(SETTING_NUMBER_OF_SHARDS, shardsIdx1)
                 .put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("type", "f", "type=text"));
+                .setMapping("f", "type=text"));
         assertAcked(prepareCreate("test2").setSettings(Settings.builder()
                 .put(SETTING_NUMBER_OF_SHARDS, shardsIdx2)
                 .put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("type", "f", "type=text"));
+                .setMapping("f", "type=text"));
         assertThat(shardsIdx1 + shardsIdx2, equalTo(numAssignedShards("test1", "test2")));
         assertThat(numAssignedShards("test1", "test2"), greaterThanOrEqualTo(2));
         ensureGreen();
diff --git a/server/src/test/java/org/elasticsearch/indices/IndicesRequestCacheIT.java b/server/src/test/java/org/elasticsearch/indices/IndicesRequestCacheIT.java
index 85e2cf9f2c891..3ea41962e4855 100644
--- a/server/src/test/java/org/elasticsearch/indices/IndicesRequestCacheIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/IndicesRequestCacheIT.java
@@ -56,7 +56,7 @@ public class IndicesRequestCacheIT extends ESIntegTestCase {
     public void testCacheAggs() throws Exception {
         Client client = client();
         assertAcked(client.admin().indices().prepareCreate("index")
-                .addMapping("type", "f", "type=date")
+                .setMapping("f", "type=date")
                 .setSettings(Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)).get());
         indexRandom(true,
                 client.prepareIndex("index").setSource("f", "2014-03-10T00:00:00.000Z"),
@@ -98,7 +98,7 @@ public void testCacheAggs() throws Exception {
 
     public void testQueryRewrite() throws Exception {
         Client client = client();
-        assertAcked(client.admin().indices().prepareCreate("index").addMapping("type", "s", "type=date")
+        assertAcked(client.admin().indices().prepareCreate("index").setMapping("s", "type=date")
                 .setSettings(Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 5).put("index.number_of_routing_shards", 5)
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)).get());
@@ -145,7 +145,7 @@ public void testQueryRewrite() throws Exception {
 
     public void testQueryRewriteMissingValues() throws Exception {
         Client client = client();
-        assertAcked(client.admin().indices().prepareCreate("index").addMapping("type", "s", "type=date")
+        assertAcked(client.admin().indices().prepareCreate("index").setMapping("s", "type=date")
                 .setSettings(Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1).put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)).get());
         indexRandom(true, client.prepareIndex("index").setId("1").setSource("s", "2016-03-19"),
@@ -189,7 +189,7 @@ public void testQueryRewriteMissingValues() throws Exception {
 
     public void testQueryRewriteDates() throws Exception {
         Client client = client();
-        assertAcked(client.admin().indices().prepareCreate("index").addMapping("type", "d", "type=date")
+        assertAcked(client.admin().indices().prepareCreate("index").setMapping("d", "type=date")
                 .setSettings(Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)
                         .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1).put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)).get());
         indexRandom(true, client.prepareIndex("index").setId("1").setSource("d", "2014-01-01T00:00:00"),
@@ -238,11 +238,11 @@ public void testQueryRewriteDatesWithNow() throws Exception {
         Client client = client();
         Settings settings = Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1).put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0).build();
-        assertAcked(client.admin().indices().prepareCreate("index-1").addMapping("type", "d", "type=date")
+        assertAcked(client.admin().indices().prepareCreate("index-1").setMapping("d", "type=date")
                 .setSettings(settings).get());
-        assertAcked(client.admin().indices().prepareCreate("index-2").addMapping("type", "d", "type=date")
+        assertAcked(client.admin().indices().prepareCreate("index-2").setMapping("d", "type=date")
                 .setSettings(settings).get());
-        assertAcked(client.admin().indices().prepareCreate("index-3").addMapping("type", "d", "type=date")
+        assertAcked(client.admin().indices().prepareCreate("index-3").setMapping("d", "type=date")
                 .setSettings(settings).get());
         ZonedDateTime now = ZonedDateTime.now(ZoneOffset.UTC);
         DateFormatter formatter = DateFormatter.forPattern("strict_date_optional_time");
@@ -304,7 +304,7 @@ public void testCanCache() throws Exception {
         Settings settings = Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 2).put("index.number_of_routing_shards", 2)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0).build();
-        assertAcked(client.admin().indices().prepareCreate("index").addMapping("type", "s", "type=date")
+        assertAcked(client.admin().indices().prepareCreate("index").setMapping("s", "type=date")
                 .setSettings(settings)
                 .get());
         indexRandom(true, client.prepareIndex("index").setId("1").setRouting("1").setSource("s", "2016-03-19"),
@@ -377,7 +377,7 @@ public void testCacheWithFilteredAlias() {
         Client client = client();
         Settings settings = Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1).put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0).build();
-        assertAcked(client.admin().indices().prepareCreate("index").addMapping("type", "created_at", "type=date")
+        assertAcked(client.admin().indices().prepareCreate("index").setMapping("created_at", "type=date")
             .setSettings(settings)
             .addAlias(new Alias("last_week").filter(QueryBuilders.rangeQuery("created_at").gte("now-7d/d")))
             .get());
@@ -418,7 +418,7 @@ public void testProfileDisableCache() throws Exception {
         Client client = client();
         assertAcked(
             client.admin().indices().prepareCreate("index")
-                .addMapping("_doc", "k", "type=keyword")
+                .setMapping("k", "type=keyword")
                 .setSettings(
                     Settings.builder()
                         .put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true)
diff --git a/server/src/test/java/org/elasticsearch/indices/analyze/AnalyzeActionIT.java b/server/src/test/java/org/elasticsearch/indices/analyze/AnalyzeActionIT.java
index e77c42cac9d98..6ead4dda5ef34 100644
--- a/server/src/test/java/org/elasticsearch/indices/analyze/AnalyzeActionIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/analyze/AnalyzeActionIT.java
@@ -85,7 +85,7 @@ public void testSimpleAnalyzerTests() throws Exception {
     }
 
     public void testAnalyzeNumericField() throws IOException {
-        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).addMapping("test", "long", "type=long", "double", "type=double"));
+        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).setMapping("long", "type=long", "double", "type=double"));
         ensureGreen("test");
 
         expectThrows(IllegalArgumentException.class,
@@ -358,7 +358,7 @@ public void testCustomTokenFilterInRequest() throws Exception {
     }
 
     public void testAnalyzeKeywordField() throws IOException {
-        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).addMapping("test", "keyword", "type=keyword"));
+        assertAcked(prepareCreate("test").addAlias(new Alias("alias")).setMapping("keyword", "type=keyword"));
         ensureGreen("test");
 
         AnalyzeAction.Response analyzeResponse = client().admin().indices().prepareAnalyze(indexOrAlias(), "ABC").setField("keyword").get();
@@ -376,7 +376,7 @@ public void testAnalyzeNormalizedKeywordField() throws IOException {
             .setSettings(Settings.builder().put(indexSettings())
                 .put("index.analysis.normalizer.my_normalizer.type", "custom")
                 .putList("index.analysis.normalizer.my_normalizer.filter", "lowercase"))
-            .addMapping("test", "keyword", "type=keyword,normalizer=my_normalizer"));
+            .setMapping("keyword", "type=keyword,normalizer=my_normalizer"));
         ensureGreen("test");
 
         AnalyzeAction.Response analyzeResponse = client().admin().indices().prepareAnalyze(indexOrAlias(), "ABC").setField("keyword").get();
diff --git a/server/src/test/java/org/elasticsearch/indices/memory/breaker/CircuitBreakerServiceIT.java b/server/src/test/java/org/elasticsearch/indices/memory/breaker/CircuitBreakerServiceIT.java
index 9a0ecca4f7830..4a5455faf3717 100644
--- a/server/src/test/java/org/elasticsearch/indices/memory/breaker/CircuitBreakerServiceIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/memory/breaker/CircuitBreakerServiceIT.java
@@ -129,7 +129,7 @@ public void testMemoryBreaker() throws Exception {
             return;
         }
         assertAcked(prepareCreate("cb-test", 1, Settings.builder().put(SETTING_NUMBER_OF_REPLICAS, between(0, 1)))
-                .addMapping("type", "test", "type=text,fielddata=true"));
+                .setMapping("test", "type=text,fielddata=true"));
         final Client client = client();
 
         // index some different terms so we have some field data for loading
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/IndexPrimaryRelocationIT.java b/server/src/test/java/org/elasticsearch/indices/recovery/IndexPrimaryRelocationIT.java
index 79147d3b302f5..3d010cd6a5f73 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/IndexPrimaryRelocationIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/IndexPrimaryRelocationIT.java
@@ -48,7 +48,7 @@ public void testPrimaryRelocationWhileIndexing() throws Exception {
         internalCluster().ensureAtLeastNumDataNodes(randomIntBetween(2, 3));
         client().admin().indices().prepareCreate("test")
             .setSettings(Settings.builder().put("index.number_of_shards", 1).put("index.number_of_replicas", 0))
-            .addMapping("type", "field", "type=text")
+            .setMapping("field", "type=text")
             .get();
         ensureGreen("test");
         AtomicInteger numAutoGenDocs = new AtomicInteger();
diff --git a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
index fd4bb6e41def2..816d941ac7ec0 100644
--- a/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/stats/IndexStatsIT.java
@@ -130,7 +130,7 @@ private Settings.Builder settingsBuilder() {
     public void testFieldDataStats() {
         assertAcked(client().admin().indices().prepareCreate("test")
                 .setSettings(settingsBuilder().put("index.number_of_shards", 2))
-                .addMapping("type", "field", "type=text,fielddata=true",
+                .setMapping("field", "type=text,fielddata=true",
                         "field2", "type=text,fielddata=true").get());
         ensureGreen();
         client().prepareIndex("test").setId("1").setSource("field", "value1", "field2", "value1").execute().actionGet();
@@ -193,7 +193,7 @@ public void testFieldDataStats() {
     public void testClearAllCaches() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
                 .setSettings(settingsBuilder().put("index.number_of_replicas", 0).put("index.number_of_shards", 2))
-                .addMapping("type", "field", "type=text,fielddata=true").get());
+                .setMapping("field", "type=text,fielddata=true").get());
         ensureGreen();
         client().admin().cluster().prepareHealth().setWaitForGreenStatus().execute().actionGet();
         client().prepareIndex("test").setId("1").setSource("field", "value1").execute().actionGet();
diff --git a/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java b/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
index 16924e43aa5a2..df30def2d0007 100644
--- a/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
@@ -446,8 +446,7 @@ public void testIndexTemplateWithAliasesInSource() {
                         "}"), XContentType.JSON).get();
 
 
-        assertAcked(prepareCreate("test_index")
-                .addMapping("_doc"));
+        assertAcked(prepareCreate("test_index"));
         ensureGreen();
 
         GetAliasesResponse getAliasesResponse = client().admin().indices().prepareGetAliases().setIndices("test_index").get();
@@ -482,8 +481,7 @@ public void testIndexTemplateWithAliasesSource() {
                         "        \"alias3\" : { \"routing\" : \"1\" }" +
                         "    }\n").get();
 
-        assertAcked(prepareCreate("test_index")
-                .addMapping("_doc"));
+        assertAcked(prepareCreate("test_index"));
         ensureGreen();
 
         GetAliasesResponse getAliasesResponse = client().admin().indices().prepareGetAliases().setIndices("test_index").get();
diff --git a/server/src/test/java/org/elasticsearch/recovery/TruncatedRecoveryIT.java b/server/src/test/java/org/elasticsearch/recovery/TruncatedRecoveryIT.java
index 204a655d3e497..661e15c6fabad 100644
--- a/server/src/test/java/org/elasticsearch/recovery/TruncatedRecoveryIT.java
+++ b/server/src/test/java/org/elasticsearch/recovery/TruncatedRecoveryIT.java
@@ -88,7 +88,7 @@ public void testCancelRecoveryAndResume() throws Exception {
         // create the index and prevent allocation on any other nodes than the lucky one
         // we have no replicas so far and make sure that we allocate the primary on the lucky node
         assertAcked(prepareCreate("test")
-            .addMapping("type1", "field1", "type=text", "the_id", "type=text")
+            .setMapping("field1", "type=text", "the_id", "type=text")
             .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, numberOfShards())
                 .put("index.routing.allocation.include._name", primariesNode.getNode().getName()))); // only allocate on the lucky node
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/AggregationsIntegrationIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/AggregationsIntegrationIT.java
index 118eee2e9b143..2b2324f7dac59 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/AggregationsIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/AggregationsIntegrationIT.java
@@ -40,7 +40,7 @@ public class AggregationsIntegrationIT extends ESIntegTestCase {
 
     @Override
     public void setupSuiteScopeCluster() throws Exception {
-        assertAcked(prepareCreate("index").addMapping("type", "f", "type=keyword").get());
+        assertAcked(prepareCreate("index").setMapping("f", "type=keyword").get());
         numDocs = randomIntBetween(1, 20);
         List<IndexRequestBuilder> docs = new ArrayList<>();
         for (int i = 0; i < numDocs; ++i) {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/MetaDataIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/MetaDataIT.java
index d0a7f70c7476d..4b784ac03eb90 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/MetaDataIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/MetaDataIT.java
@@ -42,7 +42,7 @@ public class MetaDataIT extends ESIntegTestCase {
 
     public void testMetaDataSetOnAggregationResult() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "name", "type=keyword").get());
+                .setMapping("name", "type=keyword").get());
         IndexRequestBuilder[] builders = new IndexRequestBuilder[randomInt(30)];
         for (int i = 0; i < builders.length; i++) {
             String name = "name_" + randomIntBetween(1, 10);
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/MissingValueIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/MissingValueIT.java
index 64d55fa010cb8..8c2a8f76f24ed 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/MissingValueIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/MissingValueIT.java
@@ -55,7 +55,7 @@ protected int maximumNumberOfShards() {
     @Override
     protected void setupSuiteScopeCluster() throws Exception {
         assertAcked(prepareCreate("idx")
-                .addMapping("type", "date", "type=date", "location", "type=geo_point", "str", "type=keyword").get());
+                .setMapping("date", "type=date", "location", "type=geo_point", "str", "type=keyword").get());
         indexRandom(true,
                 client().prepareIndex("idx").setId("1").setSource(),
                 client().prepareIndex("idx").setId("2")
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/AdjacencyMatrixIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/AdjacencyMatrixIT.java
index 7e078cf35185d..81c0b89efc3db 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/AdjacencyMatrixIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/AdjacencyMatrixIT.java
@@ -95,7 +95,7 @@ public void setupSuiteScopeCluster() throws Exception {
                 builders.add(client().prepareIndex("idx").setId("" + i).setSource(source));
             }
         }
-        prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer").get();
+        prepareCreate("empty_bucket_idx").setMapping("value", "type=integer").get();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i)
                     .setSource(jsonBuilder().startObject().field("value", i * 2).endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
index 19c48c9b32f9d..89f649afc769c 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramIT.java
@@ -121,7 +121,7 @@ private IndexRequestBuilder indexDoc(int month, int day, int value) throws Excep
     public void setupSuiteScopeCluster() throws Exception {
         createIndex("idx", "idx_unmapped");
         // TODO: would be nice to have more random data here
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping("value", "type=integer"));
         List<IndexRequestBuilder> builders = new ArrayList<>();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(jsonBuilder()
@@ -162,7 +162,7 @@ private void getMultiSortDocs(List<IndexRequestBuilder> builders) throws IOExcep
         addExpectedBucket(date(1, 7), 1, 5, 1);
 
         assertAcked(client().admin().indices().prepareCreate("sort_idx")
-            .addMapping("type", "date", "type=date").get());
+            .setMapping("date", "type=date").get());
         for (int i = 1; i <= 3; i++) {
             builders.add(client().prepareIndex("sort_idx").setSource(
                 jsonBuilder().startObject().timeField("date", date(1, 1)).field("l", 1).field("d", i).endObject()));
@@ -972,7 +972,7 @@ public void testEmptyAggregation() throws Exception {
     }
 
     public void testSingleValueWithTimeZone() throws Exception {
-        prepareCreate("idx2").addMapping("type", "date", "type=date").get();
+        prepareCreate("idx2").setMapping("date", "type=date").get();
         IndexRequestBuilder[] reqs = new IndexRequestBuilder[5];
         ZonedDateTime date = date("2014-03-11T00:00:00+00:00");
         for (int i = 0; i < reqs.length; i++) {
@@ -1308,7 +1308,7 @@ public void testIssue6965() {
     }
 
     public void testDSTBoundaryIssue9491() throws InterruptedException, ExecutionException {
-        assertAcked(client().admin().indices().prepareCreate("test9491").addMapping("type", "d", "type=date").get());
+        assertAcked(client().admin().indices().prepareCreate("test9491").setMapping("d", "type=date").get());
         indexRandom(true, client().prepareIndex("test9491").setSource("d", "2014-10-08T13:00:00Z"),
                 client().prepareIndex("test9491").setSource("d", "2014-11-08T13:00:00Z"));
         ensureSearchable("test9491");
@@ -1324,7 +1324,7 @@ public void testDSTBoundaryIssue9491() throws InterruptedException, ExecutionExc
     }
 
     public void testIssue8209() throws InterruptedException, ExecutionException {
-        assertAcked(client().admin().indices().prepareCreate("test8209").addMapping("type", "d", "type=date").get());
+        assertAcked(client().admin().indices().prepareCreate("test8209").setMapping("d", "type=date").get());
         indexRandom(true,
                 client().prepareIndex("test8209").setSource("d", "2014-01-01T00:00:00Z"),
                 client().prepareIndex("test8209").setSource("d", "2014-04-01T00:00:00Z"),
@@ -1394,7 +1394,7 @@ public void testFormatIndexUnmapped() throws InterruptedException, ExecutionExce
      */
     public void testRewriteTimeZone_EpochMillisFormat() throws InterruptedException, ExecutionException {
         String index = "test31392";
-        assertAcked(client().admin().indices().prepareCreate(index).addMapping("type", "d", "type=date,format=epoch_millis").get());
+        assertAcked(client().admin().indices().prepareCreate(index).setMapping("d", "type=date,format=epoch_millis").get());
         indexRandom(true, client().prepareIndex(index).setSource("d", "1477954800000"));
         ensureSearchable(index);
         SearchResponse response = client().prepareSearch(index).addAggregation(dateHistogram("histo").field("d")
@@ -1469,7 +1469,7 @@ public void testDSTEndTransition() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=date")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=date")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         String date = DateFieldMapper.DEFAULT_DATE_TIME_FORMATTER.format(date(1, 1));
@@ -1593,7 +1593,7 @@ private ZonedDateTime key(Histogram.Bucket bucket) {
      * timeZones.
      */
     public void testDateNanosHistogram() throws Exception {
-        assertAcked(prepareCreate("nanos").addMapping("_doc", "date", "type=date_nanos").get());
+        assertAcked(prepareCreate("nanos").setMapping("date", "type=date_nanos").get());
         indexRandom(true,
             client().prepareIndex("nanos").setId("1").setSource("date", "2000-01-01"));
         indexRandom(true,
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramOffsetIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramOffsetIT.java
index 90821d5f0e2a0..661b770727705 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramOffsetIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateHistogramOffsetIT.java
@@ -59,7 +59,7 @@ private ZonedDateTime date(String date) {
 
     @Before
     public void beforeEachTest() throws IOException {
-        prepareCreate("idx2").addMapping("type", "date", "type=date").get();
+        prepareCreate("idx2").setMapping("date", "type=date").get();
     }
 
     @After
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateRangeIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateRangeIT.java
index 4b6bdf96b891e..a149d357e0759 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateRangeIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DateRangeIT.java
@@ -104,7 +104,7 @@ public void setupSuiteScopeCluster() throws Exception {
         for (int i = docs.size(); i < numDocs; ++i) {
             docs.add(indexDoc(randomIntBetween(6, 10), randomIntBetween(1, 20), randomInt(100)));
         }
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping("value", "type=integer"));
         for (int i = 0; i < 2; i++) {
             docs.add(client().prepareIndex("empty_bucket_idx").setId(""+i).setSource(jsonBuilder()
                     .startObject()
@@ -888,7 +888,7 @@ public void testNoRangesInQuery()  {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "date", "type=date")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("date", "type=date")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true,
@@ -950,7 +950,7 @@ public void testScriptCaching() throws Exception {
      */
     public void testRangeWithFormatStringValue() throws Exception {
         String indexName = "dateformat_test_idx";
-        assertAcked(prepareCreate(indexName).addMapping("type", "date", "type=date,format=strict_hour_minute_second"));
+        assertAcked(prepareCreate(indexName).setMapping("date", "type=date,format=strict_hour_minute_second"));
         indexRandom(true,
                 client().prepareIndex(indexName).setId("1").setSource(jsonBuilder().startObject().field("date", "00:16:40").endObject()),
                 client().prepareIndex(indexName).setId("2").setSource(jsonBuilder().startObject().field("date", "00:33:20").endObject()),
@@ -1000,7 +1000,7 @@ public void testRangeWithFormatStringValue() throws Exception {
      */
     public void testRangeWithFormatNumericValue() throws Exception {
         String indexName = "dateformat_numeric_test_idx";
-        assertAcked(prepareCreate(indexName).addMapping("type", "date", "type=date,format=epoch_second"));
+        assertAcked(prepareCreate(indexName).setMapping("date", "type=date,format=epoch_second"));
         indexRandom(true,
                 client().prepareIndex(indexName).setId("1").setSource(jsonBuilder().startObject().field("date", 1002).endObject()),
                 client().prepareIndex(indexName).setId("2").setSource(jsonBuilder().startObject().field("date", 2000).endObject()),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DiversifiedSamplerIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DiversifiedSamplerIT.java
index bbb74ec5e8e1b..7c67f54c6b29d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DiversifiedSamplerIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DiversifiedSamplerIT.java
@@ -64,14 +64,14 @@ public String randomExecutionHint() {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(prepareCreate("test").setSettings(
-            Settings.builder().put(SETTING_NUMBER_OF_SHARDS, NUM_SHARDS).put(SETTING_NUMBER_OF_REPLICAS, 0)).addMapping(
-                "book", "author", "type=keyword", "name", "type=keyword", "genre",
+            Settings.builder().put(SETTING_NUMBER_OF_SHARDS, NUM_SHARDS).put(SETTING_NUMBER_OF_REPLICAS, 0)).setMapping(
+                "author", "type=keyword", "name", "type=keyword", "genre",
                 "type=keyword", "price", "type=float"));
         createIndex("idx_unmapped");
         // idx_unmapped_author is same as main index but missing author field
         assertAcked(prepareCreate("idx_unmapped_author").setSettings(
             Settings.builder().put(SETTING_NUMBER_OF_SHARDS, NUM_SHARDS).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("book", "name", "type=keyword", "genre", "type=keyword", "price",
+                .setMapping("name", "type=keyword", "genre", "type=keyword", "price",
                         "type=float"));
 
         ensureGreen();
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DoubleTermsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DoubleTermsIT.java
index c3a8c9b18d390..4ee2a8feeaa05 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DoubleTermsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/DoubleTermsIT.java
@@ -151,7 +151,7 @@ public void setupSuiteScopeCluster() throws Exception {
         }
 
         createIndex("idx_unmapped");
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId(""+i).setSource(jsonBuilder()
                     .startObject()
@@ -210,7 +210,7 @@ private void getMultiSortDocs(List<IndexRequestBuilder> builders) throws IOExcep
         bucketProps.put("sum_d", 1d);
         expectedMultiSortBuckets.put((Double) bucketProps.get("_term"), bucketProps);
 
-        assertAcked(prepareCreate("sort_idx").addMapping("multi_sort_type", SINGLE_VALUED_FIELD_NAME, "type=double"));
+        assertAcked(prepareCreate("sort_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=double"));
         for (int i = 1; i <= 3; i++) {
             builders.add(client().prepareIndex("sort_idx").setSource(jsonBuilder()
                     .startObject()
@@ -930,7 +930,7 @@ public void testOtherDocCount() {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=float")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=float")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1.5),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/FilterIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/FilterIT.java
index 41d37ff9c8860..229422159901a 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/FilterIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/FilterIT.java
@@ -78,7 +78,7 @@ public void setupSuiteScopeCluster() throws Exception {
                 builders.add(client().prepareIndex("idx").setId(""+i).setSource(source));
             }
         }
-        prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer").get();
+        prepareCreate("empty_bucket_idx").setMapping("value", "type=integer").get();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId(""+i).setSource(jsonBuilder()
                     .startObject()
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/FiltersIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/FiltersIT.java
index c3aca15af8c44..05ed7eb992a2b 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/FiltersIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/FiltersIT.java
@@ -98,7 +98,7 @@ public void setupSuiteScopeCluster() throws Exception {
                 builders.add(client().prepareIndex("idx").setId("" + i).setSource(source));
             }
         }
-        prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer").get();
+        prepareCreate("empty_bucket_idx").setMapping("value", "type=integer").get();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId(""+i).setSource(jsonBuilder()
                     .startObject()
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoDistanceIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoDistanceIT.java
index c4cad9097e380..fe6eb965ef06c 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoDistanceIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoDistanceIT.java
@@ -81,11 +81,11 @@ private IndexRequestBuilder indexCity(String idx, String name, String... latLons
     public void setupSuiteScopeCluster() throws Exception {
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
         prepareCreate("idx").setSettings(settings)
-                .addMapping("type", "location", "type=geo_point", "city", "type=keyword")
+                .setMapping("location", "type=geo_point", "city", "type=keyword")
                 .get();
 
         prepareCreate("idx-multi")
-                .addMapping("type", "location", "type=geo_point", "city", "type=keyword")
+                .setMapping("location", "type=geo_point", "city", "type=keyword")
                 .get();
 
         createIndex("idx_unmapped");
@@ -124,7 +124,7 @@ public void setupSuiteScopeCluster() throws Exception {
         }
         indexRandom(true, cities);
         prepareCreate("empty_bucket_idx")
-                .addMapping("type", "value", "type=integer", "location", "type=geo_point").get();
+                .setMapping("value", "type=integer", "location", "type=geo_point").get();
         List<IndexRequestBuilder> builders = new ArrayList<>();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(jsonBuilder()
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridIT.java
index 34cf0950c2384..61f6c60424671 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridIT.java
@@ -89,7 +89,7 @@ public void setupSuiteScopeCluster() throws Exception {
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
 
         assertAcked(prepareCreate("idx").setSettings(settings)
-                .addMapping("type", "location", "type=geo_point", "city", "type=keyword"));
+                .setMapping("location", "type=geo_point", "city", "type=keyword"));
 
         List<IndexRequestBuilder> cities = new ArrayList<>();
         Random random = random();
@@ -114,7 +114,7 @@ public void setupSuiteScopeCluster() throws Exception {
         indexRandom(true, cities);
 
         assertAcked(prepareCreate("multi_valued_idx").setSettings(settings)
-                .addMapping("type", "location", "type=geo_point", "city", "type=keyword"));
+                .setMapping("location", "type=geo_point", "city", "type=keyword"));
 
         cities = new ArrayList<>();
         multiValuedExpectedDocCountsForGeoHash = new ObjectIntHashMap<>(numDocs * 2);
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/HistogramIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/HistogramIT.java
index f8c5390de54cd..5a8e0cc6a17bf 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/HistogramIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/HistogramIT.java
@@ -160,7 +160,7 @@ public void setupSuiteScopeCluster() throws Exception {
 
         getMultiSortDocs(builders);
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(jsonBuilder()
                     .startObject()
@@ -191,7 +191,7 @@ private void getMultiSortDocs(List<IndexRequestBuilder> builders) throws IOExcep
         addExpectedBucket(7, 1, 5, 1);
 
         assertAcked(client().admin().indices().prepareCreate("sort_idx")
-            .addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=double").get());
+            .setMapping(SINGLE_VALUED_FIELD_NAME, "type=double").get());
         for (int i = 1; i <= 3; i++) {
             builders.add(client().prepareIndex("sort_idx").setSource(
                 jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, 1).field("l", 1).field("d", i).endObject()));
@@ -1091,7 +1091,7 @@ public void testExeptionOnNegativerInterval() {
     }
 
     public void testDecimalIntervalAndOffset() throws Exception {
-        assertAcked(prepareCreate("decimal_values").addMapping("type", "d", "type=float").get());
+        assertAcked(prepareCreate("decimal_values").setMapping("d", "type=float").get());
         indexRandom(true,
                 client().prepareIndex("decimal_values").setId("1").setSource("d", -0.6),
                 client().prepareIndex("decimal_values").setId("2").setSource("d", 0.1));
@@ -1115,7 +1115,7 @@ public void testDecimalIntervalAndOffset() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=float")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=float")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("d", -0.6),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/IpRangeIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/IpRangeIT.java
index c469c7145eeda..c7b78b0a524cd 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/IpRangeIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/IpRangeIT.java
@@ -58,7 +58,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(prepareCreate("idx")
-                .addMapping("type", "ip", "type=ip", "ips", "type=ip"));
+                .setMapping("ip", "type=ip", "ips", "type=ip"));
         waitForRelocation(ClusterHealthStatus.GREEN);
 
         indexRandom(true,
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/IpTermsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/IpTermsIT.java
index 1a00a5aebab57..40261364ee7c1 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/IpTermsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/IpTermsIT.java
@@ -63,7 +63,7 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
     }
 
     public void testScriptValue() throws Exception {
-        assertAcked(prepareCreate("index").addMapping("type", "ip", "type=ip"));
+        assertAcked(prepareCreate("index").setMapping("ip", "type=ip"));
         indexRandom(true,
                 client().prepareIndex("index").setId("1").setSource("ip", "192.168.1.7"),
                 client().prepareIndex("index").setId("2").setSource("ip", "192.168.1.7"),
@@ -89,7 +89,7 @@ public void testScriptValue() throws Exception {
     }
 
     public void testScriptValues() throws Exception {
-        assertAcked(prepareCreate("index").addMapping("type", "ip", "type=ip"));
+        assertAcked(prepareCreate("index").setMapping("ip", "type=ip"));
         indexRandom(true,
                 client().prepareIndex("index").setId("1").setSource("ip", "192.168.1.7"),
                 client().prepareIndex("index").setId("2").setSource("ip", "192.168.1.7"),
@@ -115,7 +115,7 @@ public void testScriptValues() throws Exception {
     }
 
     public void testMissingValue() throws Exception {
-        assertAcked(prepareCreate("index").addMapping("type", "ip", "type=ip"));
+        assertAcked(prepareCreate("index").setMapping("ip", "type=ip"));
         indexRandom(true,
             client().prepareIndex("index").setId("1").setSource("ip", "192.168.1.7"),
             client().prepareIndex("index").setId("2").setSource("ip", "192.168.1.7"),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/LongTermsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/LongTermsIT.java
index 2d5d7d33aefdf..1303796b7bdfb 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/LongTermsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/LongTermsIT.java
@@ -141,7 +141,7 @@ public void setupSuiteScopeCluster() throws Exception {
         indexRandom(true, highCardBuilders);
         createIndex("idx_unmapped");
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         List<IndexRequestBuilder> builders = new ArrayList<>();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId(""+i).setSource(jsonBuilder()
@@ -907,7 +907,7 @@ public void testOtherDocCount() {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/MinDocCountIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/MinDocCountIT.java
index 0bd65f63de6e9..29aa71774f592 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/MinDocCountIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/MinDocCountIT.java
@@ -106,7 +106,7 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "s", "type=keyword").get());
+                .setMapping("s", "type=keyword").get());
 
         cardinality = randomIntBetween(8, 30);
         final List<IndexRequestBuilder> indexRequests = new ArrayList<>();
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/MissingIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/MissingIT.java
index 83c480c990257..ddd8c1920b99e 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/MissingIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/MissingIT.java
@@ -49,7 +49,7 @@ public class MissingIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "tag", "type=keyword").get());
+                .setMapping("tag", "type=keyword").get());
         List<IndexRequestBuilder> builders = new ArrayList<>();
         numDocs = randomIntBetween(5, 20);
         numDocsMissing = randomIntBetween(1, numDocs - 1);
@@ -75,7 +75,7 @@ public void setupSuiteScopeCluster() throws Exception {
                     .endObject()));
         }
 
-        prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer").get();
+        prepareCreate("empty_bucket_idx").setMapping("value", "type=integer").get();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId(""+i).setSource(jsonBuilder()
                     .startObject()
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NaNSortingIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NaNSortingIT.java
index c8673afe5d468..82375b1bebfe1 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NaNSortingIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NaNSortingIT.java
@@ -112,7 +112,7 @@ public String sortKey() {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "string_value", "type=keyword").get());
+                .setMapping("string_value", "type=keyword").get());
         final int numDocs = randomIntBetween(2, 10);
         for (int i = 0; i < numDocs; ++i) {
             final long value = randomInt(5);
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NestedIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NestedIT.java
index 8e741fcf223df..82038da7b8dfa 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NestedIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/NestedIT.java
@@ -82,7 +82,7 @@ public class NestedIT extends ESIntegTestCase {
     public void setupSuiteScopeCluster() throws Exception {
 
         assertAcked(prepareCreate("idx")
-                .addMapping("type", "nested", "type=nested", "incorrect", "type=object"));
+                .setMapping("nested", "type=nested", "incorrect", "type=object"));
         ensureGreen("idx");
 
         List<IndexRequestBuilder> builders = new ArrayList<>();
@@ -115,7 +115,7 @@ public void setupSuiteScopeCluster() throws Exception {
             builders.add(client().prepareIndex("idx").setId(""+i+1).setSource(source));
         }
 
-        prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer", "nested", "type=nested").get();
+        prepareCreate("empty_bucket_idx").setMapping("value", "type=integer", "nested", "type=nested").get();
         ensureGreen("empty_bucket_idx");
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId(""+i).setSource(jsonBuilder()
@@ -475,7 +475,7 @@ public void testNestedSameDocIdProcessedMultipleTime() throws Exception {
         assertAcked(
                 prepareCreate("idx4")
                         .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                        .addMapping("product", "categories", "type=keyword", "name", "type=text", "property", "type=nested")
+                        .setMapping("categories", "type=keyword", "name", "type=text", "property", "type=nested")
         );
         ensureGreen("idx4");
 
@@ -684,7 +684,7 @@ public void testExtractInnerHitBuildersWithDuplicateHitName() throws Exception {
         assertAcked(
             prepareCreate("idxduplicatehitnames")
                 .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("product", "categories", "type=keyword", "name", "type=text", "property", "type=nested")
+                .setMapping("categories", "type=keyword", "name", "type=text", "property", "type=nested")
         );
         ensureGreen("idxduplicatehitnames");
 
@@ -705,7 +705,7 @@ public void testExtractInnerHitBuildersWithDuplicatePath() throws Exception {
         assertAcked(
             prepareCreate("idxnullhitnames")
                 .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("product", "categories", "type=keyword", "name", "type=text", "property", "type=nested")
+                .setMapping("categories", "type=keyword", "name", "type=text", "property", "type=nested")
         );
         ensureGreen("idxnullhitnames");
 
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/RangeIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/RangeIT.java
index 32e8516910ea8..09ed7aaee63a9 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/RangeIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/RangeIT.java
@@ -116,7 +116,7 @@ public void setupSuiteScopeCluster() throws Exception {
                     .endObject()));
         }
         createIndex("idx_unmapped");
-        prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer").get();
+        prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer").get();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(jsonBuilder()
                     .startObject()
@@ -128,10 +128,10 @@ public void setupSuiteScopeCluster() throws Exception {
         // Create two indices and add the field 'route_length_miles' as an alias in
         // one, and a concrete field in the other.
         prepareCreate("old_index")
-            .addMapping("_doc", "distance", "type=double", "route_length_miles", "type=alias,path=distance")
+            .setMapping("distance", "type=double", "route_length_miles", "type=alias,path=distance")
             .get();
         prepareCreate("new_index")
-            .addMapping("_doc", "route_length_miles", "type=double")
+            .setMapping("route_length_miles", "type=double")
             .get();
 
         builders.add(client().prepareIndex("old_index").setSource("distance", 42.0));
@@ -958,7 +958,7 @@ public void testEmptyAggregation() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "i", "type=integer")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("i", "type=integer")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true,
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SamplerIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SamplerIT.java
index 2ab98ee46e2ec..394d699799d64 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SamplerIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SamplerIT.java
@@ -63,14 +63,14 @@ public String randomExecutionHint() {
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(prepareCreate("test")
             .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, NUM_SHARDS).put(SETTING_NUMBER_OF_REPLICAS, 0))
-            .addMapping(
-                "book", "author", "type=keyword", "name", "type=text", "genre",
+            .setMapping(
+                "author", "type=keyword", "name", "type=text", "genre",
                 "type=keyword", "price", "type=float"));
         createIndex("idx_unmapped");
         // idx_unmapped_author is same as main index but missing author field
         assertAcked(prepareCreate("idx_unmapped_author")
             .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, NUM_SHARDS).put(SETTING_NUMBER_OF_REPLICAS, 0))
-            .addMapping("book", "name", "type=text", "genre", "type=keyword", "price", "type=float"));
+            .setMapping("name", "type=text", "genre", "type=keyword", "price", "type=float"));
 
         ensureGreen();
         String data[] = {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ShardReduceIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ShardReduceIT.java
index ff1040ad9dfbc..40ea2b12c2b1d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ShardReduceIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ShardReduceIT.java
@@ -79,7 +79,7 @@ private IndexRequestBuilder indexDoc(String date, int value) throws Exception {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(prepareCreate("idx")
-                .addMapping("type", "nested", "type=nested", "ip", "type=ip",
+                .setMapping("nested", "type=nested", "ip", "type=ip",
                         "location", "type=geo_point", "term-s", "type=keyword"));
 
         indexRandom(true,
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ShardSizeTestCase.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ShardSizeTestCase.java
index 98ce4d35567a5..d8ced7fa44633 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ShardSizeTestCase.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/ShardSizeTestCase.java
@@ -43,7 +43,7 @@ protected int numberOfShards() {
 
     protected void createIdx(String keyFieldMapping) {
         assertAcked(prepareCreate("idx")
-                .addMapping("type", "key", keyFieldMapping));
+                .setMapping("key", keyFieldMapping));
     }
 
     protected static String routing1; // routing key to shard 1
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
index 9e4717cb61991..2c7d1de83f7b5 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
@@ -83,7 +83,6 @@
 public class SignificantTermsSignificanceScoreIT extends ESIntegTestCase {
 
     static final String INDEX_NAME = "testidx";
-    static final String DOC_TYPE = "_doc";
     static final String TEXT_FIELD = "text";
     static final String CLASS_FIELD = "class";
 
@@ -340,7 +339,7 @@ public void testXContentResponse() throws Exception {
     public void testDeletesIssue7951() throws Exception {
         String settings = "{\"index.number_of_shards\": 1, \"index.number_of_replicas\": 0}";
         assertAcked(prepareCreate(INDEX_NAME).setSettings(settings, XContentType.JSON)
-                .addMapping("_doc", "text", "type=keyword", CLASS_FIELD, "type=keyword"));
+                .setMapping("text", "type=keyword", CLASS_FIELD, "type=keyword"));
         String[] cat1v1 = {"constant", "one"};
         String[] cat1v2 = {"constant", "uno"};
         String[] cat2v1 = {"constant", "two"};
@@ -575,7 +574,7 @@ public void testSubAggregations() throws Exception {
     private void indexEqualTestData() throws ExecutionException, InterruptedException {
         assertAcked(prepareCreate("test")
             .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0))
-            .addMapping("_doc", "text", "type=text,fielddata=true", "class", "type=keyword"));
+            .setMapping("text", "type=text,fielddata=true", "class", "type=keyword"));
         createIndex("idx_unmapped");
 
         ensureGreen();
@@ -657,7 +656,7 @@ private void indexRandomFrequencies01(String type) throws ExecutionException, In
         if (type.equals("text")) {
             textMappings += ",fielddata=true";
         }
-        assertAcked(prepareCreate(INDEX_NAME).addMapping(DOC_TYPE, TEXT_FIELD, textMappings, CLASS_FIELD, "type=keyword"));
+        assertAcked(prepareCreate(INDEX_NAME).setMapping(TEXT_FIELD, textMappings, CLASS_FIELD, "type=keyword"));
         String[] gb = {"0", "1"};
         List<IndexRequestBuilder> indexRequestBuilderList = new ArrayList<>();
         for (int i = 0; i < randomInt(20); i++) {
@@ -683,7 +682,7 @@ public void testReduceFromSeveralShards() throws IOException, ExecutionException
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsDocCountErrorIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsDocCountErrorIT.java
index f405f47e0ee2c..f663de00435d1 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsDocCountErrorIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsDocCountErrorIT.java
@@ -63,7 +63,7 @@ public static String randomExecutionHint() {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", STRING_FIELD_NAME, "type=keyword").get());
+                .setMapping(STRING_FIELD_NAME, "type=keyword").get());
         List<IndexRequestBuilder> builders = new ArrayList<>();
         int numDocs = between(10, 200);
         int numUniqueTerms = between(2,numDocs/2);
@@ -76,7 +76,7 @@ public void setupSuiteScopeCluster() throws Exception {
                     .endObject()));
         }
         assertAcked(prepareCreate("idx_single_shard")
-                .addMapping("type", STRING_FIELD_NAME, "type=keyword")
+                .setMapping(STRING_FIELD_NAME, "type=keyword")
                 .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)));
         for (int i = 0; i < numDocs; i++) {
             builders.add(client().prepareIndex("idx_single_shard").setId(""+i).setSource(jsonBuilder()
@@ -99,7 +99,7 @@ public void setupSuiteScopeCluster() throws Exception {
                     .field(DOUBLE_FIELD_NAME, 1.0 * randomInt(numUniqueTerms))
                     .endObject()));
         }
-        assertAcked(prepareCreate("idx_fixed_docs_0").addMapping("type", STRING_FIELD_NAME, "type=keyword")
+        assertAcked(prepareCreate("idx_fixed_docs_0").setMapping(STRING_FIELD_NAME, "type=keyword")
                 .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)));
         Map<String, Integer> shard0DocsPerTerm = new HashMap<>();
         shard0DocsPerTerm.put("A", 25);
@@ -120,7 +120,7 @@ public void setupSuiteScopeCluster() throws Exception {
             }
         }
 
-        assertAcked(prepareCreate("idx_fixed_docs_1").addMapping("type", STRING_FIELD_NAME, "type=keyword")
+        assertAcked(prepareCreate("idx_fixed_docs_1").setMapping(STRING_FIELD_NAME, "type=keyword")
                 .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)));
         Map<String, Integer> shard1DocsPerTerm = new HashMap<>();
         shard1DocsPerTerm.put("A", 30);
@@ -142,7 +142,7 @@ public void setupSuiteScopeCluster() throws Exception {
         }
 
         assertAcked(prepareCreate("idx_fixed_docs_2")
-                .addMapping("type", STRING_FIELD_NAME, "type=keyword")
+                .setMapping(STRING_FIELD_NAME, "type=keyword")
                 .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)));
         Map<String, Integer> shard2DocsPerTerm = new HashMap<>();
         shard2DocsPerTerm.put("A", 45);
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsShardMinDocCountIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsShardMinDocCountIT.java
index 6a596bc44f949..3ad98f2526205 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsShardMinDocCountIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/TermsShardMinDocCountIT.java
@@ -44,7 +44,6 @@
 
 public class TermsShardMinDocCountIT extends ESIntegTestCase {
     private static final String index = "someindex";
-    private static final String type = "testtype";
 
     private static String randomExecutionHint() {
         return randomBoolean() ? null : randomFrom(SignificantTermsAggregatorFactory.ExecutionMode.values()).toString();
@@ -59,7 +58,7 @@ public void testShardMinDocCountSignificantTermsTest() throws Exception {
             textMappings = "type=text,fielddata=true";
         }
         assertAcked(prepareCreate(index).setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping(type, "text", textMappings));
+                .setMapping("text", textMappings));
         List<IndexRequestBuilder> indexBuilders = new ArrayList<>();
 
         addTermsDocs("1", 1, 0, indexBuilders);//high score but low doc freq
@@ -118,7 +117,7 @@ public void testShardMinDocCountTermsTest() throws Exception {
             termMappings += ",fielddata=true";
         }
         assertAcked(prepareCreate(index).setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0))
-            .addMapping(type, "text", termMappings));
+            .setMapping("text", termMappings));
         List<IndexRequestBuilder> indexBuilders = new ArrayList<>();
 
         addTermsDocs("1", 1, indexBuilders);//low doc freq but high score
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/StringTermsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/StringTermsIT.java
index dda55c9e8f9df..d153234589afb 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/StringTermsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/terms/StringTermsIT.java
@@ -133,7 +133,7 @@ protected Map<String, Function<Map<String, Object>, Object>> nonDeterministicPlu
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=keyword",
+                .setMapping(SINGLE_VALUED_FIELD_NAME, "type=keyword",
                         MULTI_VALUED_FIELD_NAME, "type=keyword",
                         "tag", "type=keyword").get());
         List<IndexRequestBuilder> builders = new ArrayList<>();
@@ -154,7 +154,7 @@ public void setupSuiteScopeCluster() throws Exception {
         getMultiSortDocs(builders);
 
         assertAcked(client().admin().indices().prepareCreate("high_card_idx")
-                .addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=keyword",
+                .setMapping(SINGLE_VALUED_FIELD_NAME, "type=keyword",
                         MULTI_VALUED_FIELD_NAME, "type=keyword",
                         "tag", "type=keyword").get());
         for (int i = 0; i < 100; i++) {
@@ -163,7 +163,7 @@ public void setupSuiteScopeCluster() throws Exception {
                             .startArray(MULTI_VALUED_FIELD_NAME).value("val" + Strings.padStart(i + "", 3, '0'))
                             .value("val" + Strings.padStart((i + 1) + "", 3, '0')).endArray().endObject()));
         }
-        prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer").get();
+        prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer").get();
 
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
@@ -220,7 +220,7 @@ private void getMultiSortDocs(List<IndexRequestBuilder> builders) throws IOExcep
         expectedMultiSortBuckets.put((String) bucketProps.get("_term"), bucketProps);
 
         assertAcked(client().admin().indices().prepareCreate("sort_idx")
-                .addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=keyword",
+                .setMapping(SINGLE_VALUED_FIELD_NAME, "type=keyword",
                         MULTI_VALUED_FIELD_NAME, "type=keyword",
                         "tag", "type=keyword").get());
         for (int i = 1; i <= 3; i++) {
@@ -1128,7 +1128,7 @@ public void testOtherDocCount() {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=keyword")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=keyword")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", "foo"),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/AbstractGeoTestCase.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/AbstractGeoTestCase.java
index b50c5e29713b0..e9bef98f1f05f 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/AbstractGeoTestCase.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/AbstractGeoTestCase.java
@@ -74,7 +74,7 @@ public abstract class AbstractGeoTestCase extends ESIntegTestCase {
     public void setupSuiteScopeCluster() throws Exception {
         createIndex(UNMAPPED_IDX_NAME);
         assertAcked(prepareCreate(IDX_NAME)
-                .addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=geo_point",
+                .setMapping(SINGLE_VALUED_FIELD_NAME, "type=geo_point",
                         MULTI_VALUED_FIELD_NAME, "type=geo_point", NUMBER_FIELD_NAME, "type=long", "tag", "type=keyword"));
 
         singleTopLeft = new GeoPoint(Double.NEGATIVE_INFINITY, Double.POSITIVE_INFINITY);
@@ -133,10 +133,10 @@ public void setupSuiteScopeCluster() throws Exception {
                     multiCentroid.lon() + (newMVLon - multiCentroid.lon()) / (i+1));
         }
 
-        assertAcked(prepareCreate(EMPTY_IDX_NAME).addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=geo_point"));
+        assertAcked(prepareCreate(EMPTY_IDX_NAME).setMapping(SINGLE_VALUED_FIELD_NAME, "type=geo_point"));
 
         assertAcked(prepareCreate(DATELINE_IDX_NAME)
-                .addMapping("type", SINGLE_VALUED_FIELD_NAME,
+                .setMapping(SINGLE_VALUED_FIELD_NAME,
                     "type=geo_point", MULTI_VALUED_FIELD_NAME,
                     "type=geo_point", NUMBER_FIELD_NAME,
                     "type=long", "tag", "type=keyword"));
@@ -157,7 +157,7 @@ public void setupSuiteScopeCluster() throws Exception {
                     .endObject()));
         }
         assertAcked(prepareCreate(HIGH_CARD_IDX_NAME).setSettings(Settings.builder().put("number_of_shards", 2))
-                .addMapping("type", SINGLE_VALUED_FIELD_NAME,
+                .setMapping(SINGLE_VALUED_FIELD_NAME,
                     "type=geo_point", MULTI_VALUED_FIELD_NAME,
                     "type=geo_point", NUMBER_FIELD_NAME,
                     "type=long,store=true",
@@ -186,7 +186,7 @@ public void setupSuiteScopeCluster() throws Exception {
 
         builders.add(client().prepareIndex(IDX_ZERO_NAME).setSource(
                 jsonBuilder().startObject().array(SINGLE_VALUED_FIELD_NAME, 0.0, 1.0).endObject()));
-        assertAcked(prepareCreate(IDX_ZERO_NAME).addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=geo_point"));
+        assertAcked(prepareCreate(IDX_ZERO_NAME).setMapping(SINGLE_VALUED_FIELD_NAME, "type=geo_point"));
 
         indexRandom(true, builders);
         ensureSearchable();
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
index ca03e1d893d7b..34bbf8d2df0f5 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/CardinalityIT.java
@@ -462,7 +462,7 @@ public void testAsSubAgg() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ExtendedStatsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ExtendedStatsIT.java
index 58967969d54a0..9f16330d2d9e7 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ExtendedStatsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ExtendedStatsIT.java
@@ -643,7 +643,7 @@ private void checkUpperLowerBounds(ExtendedStats stats, double sigma) {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentileRanksIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentileRanksIT.java
index ae578208ae01b..69e1cc105c535 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentileRanksIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentileRanksIT.java
@@ -562,7 +562,7 @@ public void testOrderByEmptyAggregation() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentilesIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentilesIT.java
index 05ffe4ddc4638..3bab055161aee 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentilesIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/HDRPercentilesIT.java
@@ -527,7 +527,7 @@ public void testOrderByEmptyAggregation() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MedianAbsoluteDeviationIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MedianAbsoluteDeviationIT.java
index 7345e16c2fc1c..212ee4a3d25b0 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MedianAbsoluteDeviationIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/MedianAbsoluteDeviationIT.java
@@ -126,7 +126,7 @@ public void setupSuiteScopeCluster() throws Exception {
         indexRandom(true, builders);
 
         prepareCreate("empty_bucket_idx")
-            .addMapping("type", "value", "type=integer")
+            .setMapping("value", "type=integer")
             .get();
 
         builders = new ArrayList<>();
@@ -562,7 +562,7 @@ public void testOrderByEmptyAggregation() throws Exception {
     public void testScriptCaching() throws Exception {
         assertAcked(
             prepareCreate("cache_test_idx")
-                .addMapping("type", "d", "type=long")
+                .setMapping("d", "type=long")
                 .setSettings(Settings.builder()
                     .put("requests.cache.enable", true)
                     .put("number_of_shards", 1)
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
index 6c2981c4ad79d..c58800ce13755 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricIT.java
@@ -294,7 +294,7 @@ public void setupSuiteScopeCluster() throws Exception {
         // "1". then each test will have
         // to check that this bucket exists with the appropriate sub
         // aggregations.
-        prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer").get();
+        prepareCreate("empty_bucket_idx").setMapping("value", "type=integer").get();
         builders = new ArrayList<>();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
@@ -1052,7 +1052,7 @@ public void testScriptCaching() throws Exception {
         Script ndRandom = new Script(ScriptType.INLINE, CustomScriptPlugin.NAME, "return Math.random()",
                                      Collections.emptyMap());
 
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/StatsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/StatsIT.java
index bc3695edd9f0c..d393b4f0b2c64 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/StatsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/StatsIT.java
@@ -492,7 +492,7 @@ private void assertShardExecutionState(SearchResponse response, int expectedFail
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/SumIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/SumIT.java
index 87883852a615a..b63bd845c7a2c 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/SumIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/SumIT.java
@@ -71,13 +71,13 @@ public void setupSuiteScopeCluster() throws Exception {
         // Create two indices and add the field 'route_length_miles' as an alias in
         // one, and a concrete field in the other.
         prepareCreate("old_index")
-            .addMapping("_doc",
+            .setMapping(
                 "transit_mode", "type=keyword",
                 "distance", "type=double",
                 "route_length_miles", "type=alias,path=distance")
             .get();
         prepareCreate("new_index")
-            .addMapping("_doc",
+            .setMapping(
                 "transit_mode", "type=keyword",
                 "route_length_miles", "type=double")
             .get();
@@ -379,7 +379,7 @@ public void testOrderByEmptyAggregation() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentileRanksIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentileRanksIT.java
index 4974378d49010..734fe31e6bc98 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentileRanksIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentileRanksIT.java
@@ -488,7 +488,7 @@ public void testOrderByEmptyAggregation() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentilesIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentilesIT.java
index 7bd871e63fab4..88a2b450eac17 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentilesIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TDigestPercentilesIT.java
@@ -471,7 +471,7 @@ public void testOrderByEmptyAggregation() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
index 321a03d236c96..8cda3d796d51d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/TopHitsIT.java
@@ -122,8 +122,8 @@ public static String randomExecutionHint() {
 
     @Override
     public void setupSuiteScopeCluster() throws Exception {
-        assertAcked(prepareCreate("idx").addMapping("type", TERMS_AGGS_FIELD, "type=keyword"));
-        assertAcked(prepareCreate("field-collapsing").addMapping("type", "group", "type=keyword"));
+        assertAcked(prepareCreate("idx").setMapping(TERMS_AGGS_FIELD, "type=keyword"));
+        assertAcked(prepareCreate("field-collapsing").setMapping("group", "type=keyword"));
         createIndex("empty");
         assertAcked(prepareCreate("articles").setMapping(
             jsonBuilder().startObject().startObject("_doc").startObject("properties")
@@ -1096,7 +1096,7 @@ public void testNoStoredFields() throws Exception {
      */
     public void testScriptCaching() throws Exception {
         try {
-            assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+            assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(
                     Settings.builder()
                         .put("requests.cache.enable", true)
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ValueCountIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ValueCountIT.java
index 642326010a2f8..9f19b9286e41d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ValueCountIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/ValueCountIT.java
@@ -216,7 +216,7 @@ public void testMultiValuedScriptWithParams() throws Exception {
      * Ensure requests using nondeterministic scripts do not get cached.
      */
     public void testScriptCaching() throws Exception {
-        assertAcked(prepareCreate("cache_test_idx").addMapping("type", "d", "type=long")
+        assertAcked(prepareCreate("cache_test_idx").setMapping("d", "type=long")
                 .setSettings(Settings.builder().put("requests.cache.enable", true).put("number_of_shards", 1).put("number_of_replicas", 1))
                 .get());
         indexRandom(true, client().prepareIndex("cache_test_idx").setId("1").setSource("s", 1),
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/AvgBucketIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/AvgBucketIT.java
index 41ba019919997..b734e34d2cbf8 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/AvgBucketIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/AvgBucketIT.java
@@ -59,7 +59,7 @@ public class AvgBucketIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "tag", "type=keyword").get());
+                .setMapping("tag", "type=keyword").get());
         createIndex("idx_unmapped");
 
         numDocs = randomIntBetween(6, 20);
@@ -82,7 +82,7 @@ public void setupSuiteScopeCluster() throws Exception {
             valueCounts[bucket]++;
         }
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
                     jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, i * 2).endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/DateDerivativeIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/DateDerivativeIT.java
index db672620ce932..549815a29ac8b 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/DateDerivativeIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/DateDerivativeIT.java
@@ -83,7 +83,7 @@ public void setupSuiteScopeCluster() throws Exception {
         createIndex("idx");
         createIndex("idx_unmapped");
         // TODO: would be nice to have more random data here
-        prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer").get();
+        prepareCreate("empty_bucket_idx").setMapping("value", "type=integer").get();
         List<IndexRequestBuilder> builders = new ArrayList<>();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/DerivativeIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/DerivativeIT.java
index aa1efefccec86..a98269338b315 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/DerivativeIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/DerivativeIT.java
@@ -126,7 +126,7 @@ public void setupSuiteScopeCluster() throws Exception {
         valueCounts_empty = new Long[] { 1L, 1L, 2L, 0L, 2L, 2L, 0L, 0L, 0L, 3L, 2L, 1L };
         firstDerivValueCounts_empty = new Double[] { null, 0d, 1d, -2d, 2d, 0d, -2d, 0d, 0d, 3d, -1d, -1d };
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < valueCounts_empty.length; i++) {
             for (int docs = 0; docs < valueCounts_empty[i]; docs++) {
                 builders.add(client().prepareIndex("empty_bucket_idx").setSource(newDocBuilder(i)));
@@ -140,7 +140,7 @@ public void setupSuiteScopeCluster() throws Exception {
         firstDerivValueCounts_empty_rnd = new Double[numBuckets_empty_rnd];
         firstDerivValueCounts_empty_rnd[0] = null;
 
-        assertAcked(prepareCreate("empty_bucket_idx_rnd").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx_rnd").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < numBuckets_empty_rnd; i++) {
             valueCounts_empty_rnd[i] = (long) randomIntBetween(1, 10);
             // make approximately half of the buckets empty
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/ExtendedStatsBucketIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/ExtendedStatsBucketIT.java
index 2449a475ac892..507cc2ff5a288 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/ExtendedStatsBucketIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/ExtendedStatsBucketIT.java
@@ -62,7 +62,7 @@ public class ExtendedStatsBucketIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "tag", "type=keyword").get());
+                .setMapping("tag", "type=keyword").get());
         createIndex("idx_unmapped", "idx_gappy");
 
         numDocs = randomIntBetween(6, 20);
@@ -92,7 +92,7 @@ public void setupSuiteScopeCluster() throws Exception {
                     jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, i == 4 ? 3 : i).endObject()));
         }
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
                     jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, i * 2).endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MaxBucketIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MaxBucketIT.java
index 700baa5b00a91..941d2c0800fab 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MaxBucketIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MaxBucketIT.java
@@ -73,7 +73,7 @@ public class MaxBucketIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "tag", "type=keyword").get());
+                .setMapping("tag", "type=keyword").get());
         createIndex("idx_unmapped");
 
         numDocs = randomIntBetween(6, 20);
@@ -96,7 +96,7 @@ public void setupSuiteScopeCluster() throws Exception {
             valueCounts[bucket]++;
         }
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
                     jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, i * 2).endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MinBucketIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MinBucketIT.java
index 633afd3554e5d..22472df381d15 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MinBucketIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/MinBucketIT.java
@@ -59,7 +59,7 @@ public class MinBucketIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "tag", "type=keyword").get());
+                .setMapping("tag", "type=keyword").get());
         createIndex("idx_unmapped");
 
         numDocs = randomIntBetween(6, 20);
@@ -82,7 +82,7 @@ public void setupSuiteScopeCluster() throws Exception {
             valueCounts[bucket]++;
         }
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
                     jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, i * 2).endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/PercentilesBucketIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/PercentilesBucketIT.java
index c2ce4ba9a030a..50d06b13fa7df 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/PercentilesBucketIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/PercentilesBucketIT.java
@@ -63,7 +63,7 @@ public class PercentilesBucketIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "tag", "type=keyword").get());
+                .setMapping("tag", "type=keyword").get());
         createIndex("idx_unmapped");
 
         numDocs = randomIntBetween(6, 20);
@@ -86,7 +86,7 @@ public void setupSuiteScopeCluster() throws Exception {
             valueCounts[bucket]++;
         }
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
                     jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, i * 2).endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/StatsBucketIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/StatsBucketIT.java
index c25b69391d537..707e5dbd5aa87 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/StatsBucketIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/StatsBucketIT.java
@@ -59,7 +59,7 @@ public class StatsBucketIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "tag", "type=keyword").get());
+                .setMapping("tag", "type=keyword").get());
         createIndex("idx_unmapped");
 
         numDocs = randomIntBetween(6, 20);
@@ -82,7 +82,7 @@ public void setupSuiteScopeCluster() throws Exception {
             valueCounts[bucket]++;
         }
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
                     jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, i * 2).endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/SumBucketIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/SumBucketIT.java
index c49a46bdfb672..90743313f8e19 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/SumBucketIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/SumBucketIT.java
@@ -59,7 +59,7 @@ public class SumBucketIT extends ESIntegTestCase {
     @Override
     public void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", "tag", "type=keyword").get());
+                .setMapping("tag", "type=keyword").get());
         createIndex("idx_unmapped");
 
         numDocs = randomIntBetween(6, 20);
@@ -82,7 +82,7 @@ public void setupSuiteScopeCluster() throws Exception {
             valueCounts[bucket]++;
         }
 
-        assertAcked(prepareCreate("empty_bucket_idx").addMapping("type", SINGLE_VALUED_FIELD_NAME, "type=integer"));
+        assertAcked(prepareCreate("empty_bucket_idx").setMapping(SINGLE_VALUED_FIELD_NAME, "type=integer"));
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId("" + i).setSource(
                     jsonBuilder().startObject().field(SINGLE_VALUED_FIELD_NAME, i * 2).endObject()));
diff --git a/server/src/test/java/org/elasticsearch/search/basic/SearchWhileRelocatingIT.java b/server/src/test/java/org/elasticsearch/search/basic/SearchWhileRelocatingIT.java
index 505469eab38a6..320f4f8c780e3 100644
--- a/server/src/test/java/org/elasticsearch/search/basic/SearchWhileRelocatingIT.java
+++ b/server/src/test/java/org/elasticsearch/search/basic/SearchWhileRelocatingIT.java
@@ -50,7 +50,7 @@ private void testSearchAndRelocateConcurrently(final int numberOfReplicas) throw
         final int numShards = between(1, 20);
         client().admin().indices().prepareCreate("test")
                 .setSettings(Settings.builder().put("index.number_of_shards", numShards).put("index.number_of_replicas", numberOfReplicas))
-                .addMapping("type", "loc", "type=geo_point", "test", "type=text").get();
+                .setMapping("loc", "type=geo_point", "test", "type=text").get();
         ensureGreen();
         List<IndexRequestBuilder> indexBuilders = new ArrayList<>();
         final int numDocs = between(10, 20);
diff --git a/server/src/test/java/org/elasticsearch/search/basic/TransportSearchFailuresIT.java b/server/src/test/java/org/elasticsearch/search/basic/TransportSearchFailuresIT.java
index ca84dcbc4a640..756ea0e174ba6 100644
--- a/server/src/test/java/org/elasticsearch/search/basic/TransportSearchFailuresIT.java
+++ b/server/src/test/java/org/elasticsearch/search/basic/TransportSearchFailuresIT.java
@@ -52,7 +52,7 @@ protected int maximumNumberOfReplicas() {
 
     public void testFailedSearchWithWrongQuery() throws Exception {
         logger.info("Start Testing failed search with wrong query");
-        assertAcked(prepareCreate("test", 1).addMapping("type", "foo", "type=geo_point"));
+        assertAcked(prepareCreate("test", 1).setMapping("foo", "type=geo_point"));
 
         NumShards test = getNumShards("test");
 
diff --git a/server/src/test/java/org/elasticsearch/search/basic/TransportTwoNodesSearchIT.java b/server/src/test/java/org/elasticsearch/search/basic/TransportTwoNodesSearchIT.java
index bd9a1816c25b9..11500bb64f6cc 100644
--- a/server/src/test/java/org/elasticsearch/search/basic/TransportTwoNodesSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/basic/TransportTwoNodesSearchIT.java
@@ -85,7 +85,7 @@ private Set<String> prepareData(int numShards) throws Exception {
 
         client().admin().indices().create(createIndexRequest("test")
                 .settings(settingsBuilder)
-                .mapping("type", "foo", "type=geo_point"))
+                .simpleMapping("foo", "type=geo_point"))
                 .actionGet();
 
         ensureGreen();
diff --git a/server/src/test/java/org/elasticsearch/search/fetch/subphase/InnerHitsIT.java b/server/src/test/java/org/elasticsearch/search/fetch/subphase/InnerHitsIT.java
index c34d7c458ce12..93fbec203fe0a 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/subphase/InnerHitsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/subphase/InnerHitsIT.java
@@ -181,7 +181,7 @@ public void testSimpleNested() throws Exception {
     }
 
     public void testRandomNested() throws Exception {
-        assertAcked(prepareCreate("idx").addMapping("type", "field1", "type=nested", "field2", "type=nested"));
+        assertAcked(prepareCreate("idx").setMapping("field1", "type=nested", "field2", "type=nested"));
         int numDocs = scaledRandomIntBetween(25, 100);
         List<IndexRequestBuilder> requestBuilders = new ArrayList<>();
 
@@ -358,7 +358,7 @@ public void testNestedMultipleLayers() throws Exception {
 
     // Issue #9723
     public void testNestedDefinedAsObject() throws Exception {
-        assertAcked(prepareCreate("articles").addMapping("article", "comments", "type=nested", "title", "type=text"));
+        assertAcked(prepareCreate("articles").setMapping("comments", "type=nested", "title", "type=text"));
 
         List<IndexRequestBuilder> requests = new ArrayList<>();
         requests.add(client().prepareIndex("articles").setId("1").setSource(jsonBuilder().startObject()
@@ -589,7 +589,7 @@ public void testMatchesQueriesNestedInnerHits() throws Exception {
     }
 
     public void testNestedSource() throws Exception {
-        assertAcked(prepareCreate("index1").addMapping("message", "comments", "type=nested"));
+        assertAcked(prepareCreate("index1").setMapping("comments", "type=nested"));
         client().prepareIndex("index1").setId("1").setSource(jsonBuilder().startObject()
                 .field("message", "quick brown fox")
                 .startArray("comments")
@@ -648,7 +648,7 @@ public void testNestedSource() throws Exception {
 
     public void testInnerHitsWithIgnoreUnmapped() throws Exception {
         assertAcked(prepareCreate("index1")
-            .addMapping("_doc", "nested_type", "type=nested")
+            .setMapping("nested_type", "type=nested")
         );
         createIndex("index2");
         client().prepareIndex("index1").setId("1").setSource("nested_type", Collections.singletonMap("key", "value")).get();
@@ -668,7 +668,7 @@ public void testInnerHitsWithIgnoreUnmapped() throws Exception {
     }
 
     public void testUseMaxDocInsteadOfSize() throws Exception {
-        assertAcked(prepareCreate("index2").addMapping("type", "nested", "type=nested"));
+        assertAcked(prepareCreate("index2").setMapping("nested", "type=nested"));
         client().admin().indices().prepareUpdateSettings("index2")
             .setSettings(Collections.singletonMap(IndexSettings.MAX_INNER_RESULT_WINDOW_SETTING.getKey(), ArrayUtil.MAX_ARRAY_LENGTH))
             .get();
@@ -692,7 +692,7 @@ public void testUseMaxDocInsteadOfSize() throws Exception {
     }
 
     public void testTooHighResultWindow() throws Exception {
-        assertAcked(prepareCreate("index2").addMapping("type", "nested", "type=nested"));
+        assertAcked(prepareCreate("index2").setMapping("nested", "type=nested"));
         client().prepareIndex("index2").setId("1").setSource(jsonBuilder().startObject()
             .startArray("nested")
             .startObject()
diff --git a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
index 2813f1a1e9757..acc76ac4ef1a9 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java
@@ -353,7 +353,7 @@ public void testHighlightingWhenFieldsAreNotStoredThereIsNoSource() throws IOExc
     // see #3486
     public void testHighTermFrequencyDoc() throws IOException {
         assertAcked(prepareCreate("test")
-                .addMapping("test", "name", "type=text,term_vector=with_positions_offsets,store=" + randomBoolean()));
+                .setMapping("name", "type=text,term_vector=with_positions_offsets,store=" + randomBoolean()));
         StringBuilder builder = new StringBuilder();
         for (int i = 0; i < 6000; i++) {
             builder.append("abc").append(" ");
@@ -369,7 +369,7 @@ public void testHighTermFrequencyDoc() throws IOException {
 
     public void testEnsureNoNegativeOffsets() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1",
+                .setMapping(
                         "no_long_term", "type=text,term_vector=with_positions_offsets",
                         "long_term", "type=text,term_vector=with_positions_offsets"));
 
@@ -570,7 +570,7 @@ public void testSourceLookupHighlightingUsingPostingsHighlighter() throws Except
 
     public void testHighlightIssue1994() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1",
+                .setMapping(
                         "title", "type=text,store=false",
                         "titleTV", "type=text,store=false,term_vector=with_positions_offsets"));
 
@@ -626,7 +626,7 @@ public void testGlobalHighlightingSettingsOverriddenAtFieldLevel() {
     // Issue #5175
     public void testHighlightingOnWildcardFields() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1",
+                .setMapping(
                         "field-postings", "type=text,index_options=offsets",
                         "field-fvh", "type=text,term_vector=with_positions_offsets",
                         "field-plain", "type=text"));
@@ -1106,7 +1106,7 @@ public XContentBuilder type1TermVectorMapping() throws IOException {
 
     public void testSameContent() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "title", "type=text,store=true,term_vector=with_positions_offsets"));
+                .setMapping("title", "type=text,store=true,term_vector=with_positions_offsets"));
 
         IndexRequestBuilder[] indexRequestBuilders = new IndexRequestBuilder[5];
         for (int i = 0; i < 5; i++) {
@@ -1128,7 +1128,7 @@ public void testSameContent() throws Exception {
 
     public void testFastVectorHighlighterOffsetParameter() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "title", "type=text,store=true,term_vector=with_positions_offsets").get());
+                .setMapping("title", "type=text,store=true,term_vector=with_positions_offsets").get());
 
         IndexRequestBuilder[] indexRequestBuilders = new IndexRequestBuilder[5];
         for (int i = 0; i < 5; i++) {
@@ -1150,7 +1150,7 @@ public void testFastVectorHighlighterOffsetParameter() throws Exception {
 
     public void testEscapeHtml() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "title", "type=text,store=true"));
+                .setMapping("title", "type=text,store=true"));
 
         IndexRequestBuilder[] indexRequestBuilders = new IndexRequestBuilder[5];
         for (int i = 0; i < indexRequestBuilders.length; i++) {
@@ -1172,7 +1172,7 @@ public void testEscapeHtml() throws Exception {
 
     public void testEscapeHtmlVector() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "title", "type=text,store=true,term_vector=with_positions_offsets"));
+                .setMapping("title", "type=text,store=true,term_vector=with_positions_offsets"));
 
         IndexRequestBuilder[] indexRequestBuilders = new IndexRequestBuilder[5];
         for (int i = 0; i < 5; i++) {
@@ -1350,7 +1350,7 @@ public void testMultiMapperNoVectorFromSource() throws Exception {
 
     public void testFastVectorHighlighterShouldFailIfNoTermVectors() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "title", "type=text,store=true,term_vector=no"));
+                .setMapping("title", "type=text,store=true,term_vector=no"));
         ensureGreen();
 
         IndexRequestBuilder[] indexRequestBuilders = new IndexRequestBuilder[5];
@@ -1381,7 +1381,7 @@ public void testFastVectorHighlighterShouldFailIfNoTermVectors() throws Exceptio
 
     public void testDisableFastVectorHighlighter() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "title", "type=text,store=true,term_vector=with_positions_offsets,analyzer=classic"));
+                .setMapping("title", "type=text,store=true,term_vector=with_positions_offsets,analyzer=classic"));
         ensureGreen();
 
         IndexRequestBuilder[] indexRequestBuilders = new IndexRequestBuilder[5];
@@ -1428,7 +1428,7 @@ public void testDisableFastVectorHighlighter() throws Exception {
 
     public void testFSHHighlightAllMvFragments() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "tags", "type=text,term_vector=with_positions_offsets"));
+                .setMapping("tags", "type=text,term_vector=with_positions_offsets"));
         ensureGreen();
         client().prepareIndex("test").setId("1")
                 .setSource("tags", new String[] {
@@ -1482,7 +1482,7 @@ public void testBoostingQueryTermVector() throws IOException {
 
     public void testPlainHighlightDifferentFragmenter() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "tags", "type=text"));
+                .setMapping("tags", "type=text"));
         ensureGreen();
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject().array("tags",
@@ -1540,7 +1540,7 @@ public void testPlainHighlighterMultipleFields() {
     }
 
     public void testFastVectorHighlighterMultipleFields() {
-        assertAcked(prepareCreate("test").addMapping("type1",
+        assertAcked(prepareCreate("test").setMapping(
                 "field1", "type=text,term_vector=with_positions_offsets",
                 "field2", "type=text,term_vector=with_positions_offsets"));
         ensureGreen();
@@ -1561,7 +1561,7 @@ public void testFastVectorHighlighterMultipleFields() {
 
     public void testMissingStoredField() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "highlight_field", "type=text,store=true"));
+                .setMapping("highlight_field", "type=text,store=true"));
         ensureGreen();
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject()
@@ -1581,7 +1581,7 @@ public void testMissingStoredField() throws Exception {
     // Issue #3211
     public void testNumericHighlighting() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("test",
+                .setMapping(
                         "text", "type=text",
                         "byte", "type=byte",
                         "short", "type=short",
@@ -1613,7 +1613,7 @@ public void testResetTwice() throws Exception {
                         .put(indexSettings())
                         .put("analysis.analyzer.my_analyzer.type", "mock_whitespace")
                         .build())
-                .addMapping("type", "text", "type=text,analyzer=my_analyzer"));
+                .setMapping("text", "type=text,analyzer=my_analyzer"));
         ensureGreen();
         client().prepareIndex("test").setId("1")
                 .setSource("text", "elasticsearch test").get();
@@ -1627,7 +1627,7 @@ public void testResetTwice() throws Exception {
     }
 
     public void testHighlightUsesHighlightQuery() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1", "text",
+        assertAcked(prepareCreate("test").setMapping("text",
                 "type=text," + randomStoreField() + "term_vector=with_positions_offsets,index_options=offsets"));
         ensureGreen();
 
@@ -1668,7 +1668,7 @@ private static String randomStoreField() {
     }
 
     public void testHighlightNoMatchSize() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1", "text",
+        assertAcked(prepareCreate("test").setMapping("text",
                 "type=text," + randomStoreField() + "term_vector=with_positions_offsets,index_options=offsets"));
         ensureGreen();
 
@@ -1777,7 +1777,7 @@ public void testHighlightNoMatchSize() throws IOException {
     }
 
     public void testHighlightNoMatchSizeWithMultivaluedFields() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1",
+        assertAcked(prepareCreate("test").setMapping(
                 "text", "type=text," + randomStoreField() + "term_vector=with_positions_offsets,index_options=offsets"));
         ensureGreen();
 
@@ -1888,8 +1888,8 @@ public void testHighlightNoMatchSizeWithMultivaluedFields() throws IOException {
         assertNotHighlighted(response, 0, "text");
     }
 
-    public void testHighlightNoMatchSizeNumberOfFragments() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1",
+    public void testHighlightNoMatchSizeNumberOfFragments() {
+        assertAcked(prepareCreate("test").setMapping(
                 "text", "type=text," + randomStoreField() + "term_vector=with_positions_offsets,index_options=offsets"));
         ensureGreen();
 
@@ -2162,7 +2162,7 @@ public void testPostingsHighlighterOrderByScore() throws Exception {
 
     public void testPostingsHighlighterEscapeHtml() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "title", "type=text," + randomStoreField() + "index_options=offsets"));
+                .setMapping("title", "type=text," + randomStoreField() + "index_options=offsets"));
 
         IndexRequestBuilder[] indexRequestBuilders = new IndexRequestBuilder[5];
         for (int i = 0; i < 5; i++) {
@@ -2800,7 +2800,7 @@ public void testFiltersFunctionScoreQueryHighlight() throws Exception {
 
 
     public void testHighlightQueryRewriteDatesWithNow() throws Exception {
-        assertAcked(client().admin().indices().prepareCreate("index-1").addMapping("type", "d", "type=date",
+        assertAcked(client().admin().indices().prepareCreate("index-1").setMapping("d", "type=date",
             "field", "type=text,store=true,term_vector=with_positions_offsets")
             .setSettings(Settings.builder().put("index.number_of_replicas", 0).put("index.number_of_shards", 2))
             .get());
@@ -2913,7 +2913,7 @@ public void testWithNormalizer() throws Exception {
             .putList("index.analysis.normalizer.my_normalizer.filter", "lowercase");
 
         assertAcked(prepareCreate("test").setSettings(builder.build())
-            .addMapping("doc", "keyword",
+            .setMapping("keyword",
                 "type=keyword,normalizer=my_normalizer"));
         ensureGreen();
 
@@ -2937,7 +2937,7 @@ public void testWithNormalizer() throws Exception {
 
     public void testDisableHighlightIdField() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("doc", "keyword", "type=keyword"));
+            .setMapping("keyword", "type=keyword"));
         ensureGreen();
 
         client().prepareIndex("test").setId("d33f85bf1e51e84d9ab38948db9f3a068e1fe5294f1d8603914ac8c7bcc39ca1")
diff --git a/server/src/test/java/org/elasticsearch/search/fields/SearchFieldsIT.java b/server/src/test/java/org/elasticsearch/search/fields/SearchFieldsIT.java
index 7eeb71e1f3c42..f84cb29511b11 100644
--- a/server/src/test/java/org/elasticsearch/search/fields/SearchFieldsIT.java
+++ b/server/src/test/java/org/elasticsearch/search/fields/SearchFieldsIT.java
@@ -398,7 +398,7 @@ public void testScriptFieldWithNanos() throws Exception {
     }
 
     public void testIdBasedScriptFields() throws Exception {
-        prepareCreate("test").addMapping("type1", "num1", "type=long").get();
+        prepareCreate("test").setMapping("num1", "type=long").get();
 
         int numDocs = randomIntBetween(1, 30);
         IndexRequestBuilder[] indexRequestBuilders = new IndexRequestBuilder[numDocs];
@@ -744,7 +744,7 @@ public void testGetFieldsComplexField() throws Exception {
     // see #8203
     public void testSingleValueFieldDatatField() throws ExecutionException, InterruptedException {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "test_field", "type=keyword").get());
+                .setMapping("test_field", "type=keyword").get());
         indexRandom(true, client().prepareIndex("test").setId("1").setSource("test_field", "foobar"));
         refresh();
         SearchResponse searchResponse = client().prepareSearch("test")
@@ -952,7 +952,7 @@ public void testDocValueFields() throws Exception {
     }
 
     public void testScriptFields() throws Exception {
-        assertAcked(prepareCreate("index").addMapping("type",
+        assertAcked(prepareCreate("index").setMapping(
                 "s", "type=keyword",
                 "l", "type=long",
                 "d", "type=double",
diff --git a/server/src/test/java/org/elasticsearch/search/functionscore/RandomScoreFunctionIT.java b/server/src/test/java/org/elasticsearch/search/functionscore/RandomScoreFunctionIT.java
index 4c6cc661319bb..50d96d110b511 100644
--- a/server/src/test/java/org/elasticsearch/search/functionscore/RandomScoreFunctionIT.java
+++ b/server/src/test/java/org/elasticsearch/search/functionscore/RandomScoreFunctionIT.java
@@ -152,7 +152,7 @@ public void testConsistentHitsWithSameSeed() throws Exception {
     }
 
     public void testScoreAccessWithinScript() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type", "body", "type=text", "index",
+        assertAcked(prepareCreate("test").setMapping("body", "type=text", "index",
                 "type=" + randomFrom("short", "float", "long", "integer", "double")));
 
         int docCount = randomIntBetween(100, 200);
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoPolygonIT.java b/server/src/test/java/org/elasticsearch/search/geo/GeoPolygonIT.java
index 6b0bdc4695623..15615bc8c655b 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoPolygonIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoPolygonIT.java
@@ -52,7 +52,7 @@ protected void setupSuiteScopeCluster() throws Exception {
         Version version = VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
 
-        assertAcked(prepareCreate("test").setSettings(settings).addMapping("type1", "location",
+        assertAcked(prepareCreate("test").setSettings(settings).setMapping("location",
             "type=geo_point", "alias",
             "type=alias,path=location"));
         ensureGreen();
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeIntegrationIT.java b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeIntegrationIT.java
index fac3bda1c1935..a9916734247ef 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeIntegrationIT.java
@@ -100,7 +100,7 @@ public void testOrientationPersistence() throws Exception {
     public void testIgnoreMalformed() throws Exception {
         // create index
         assertAcked(client().admin().indices().prepareCreate("test")
-            .addMapping("geometry", "shape", "type=geo_shape,ignore_malformed=true").get());
+            .setMapping("shape", "type=geo_shape,ignore_malformed=true").get());
         ensureGreen();
 
         // test self crossing ccw poly not crossing dateline
@@ -127,7 +127,7 @@ public void testIgnoreMalformed() throws Exception {
     public void testMappingUpdate() throws Exception {
         // create index
         assertAcked(client().admin().indices().prepareCreate("test")
-            .addMapping("geometry", "shape", "type=geo_shape").get());
+            .setMapping("shape", "type=geo_shape").get());
         ensureGreen();
 
         String update ="{\n" +
diff --git a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
index d32d9f11bc3e7..a86d584256e27 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/GeoShapeQueryTests.java
@@ -252,7 +252,7 @@ private void assertUnmodified(ShapeBuilder builder) throws IOException {
 
     public void testShapeFetchingPath() throws Exception {
         createIndex("shapes");
-        client().admin().indices().prepareCreate("test").addMapping("_doc", "location", "type=geo_shape").get();
+        client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape").get();
 
         String location = "\"location\" : {\"type\":\"polygon\", \"coordinates\":[[[-10,-10],[10,-10],[10,10],[-10,10],[-10,-10]]]}";
 
@@ -344,10 +344,10 @@ public void testQueryRandomGeoCollection() throws Exception {
 
         if (randomBoolean()) {
             client().admin().indices().prepareCreate("test")
-                .addMapping("type", "location", "type=geo_shape").get();
+                .setMapping("location", "type=geo_shape").get();
         } else {
             client().admin().indices().prepareCreate("test")
-                .addMapping("type", "location", "type=geo_shape,tree=quadtree").get();
+                .setMapping("location", "type=geo_shape,tree=quadtree").get();
         }
 
         XContentBuilder docSource = gcb.toXContent(jsonBuilder().startObject().field("location"), null).endObject();
@@ -398,10 +398,10 @@ public void testRandomGeoCollectionQuery() throws Exception {
             usePrefixTrees ? "default" : "quadtree");
 
         if (usePrefixTrees == false) {
-            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape")
+            client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape")
                 .execute().actionGet();
         } else {
-            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape,tree=quadtree")
+            client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape,tree=quadtree")
                 .execute().actionGet();
         }
 
@@ -428,10 +428,10 @@ public void testPointQuery() throws Exception {
         PointBuilder pb = new PointBuilder(pt[0], pt[1]);
         gcb.shape(pb);
         if (randomBoolean()) {
-            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape")
+            client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape")
                 .execute().actionGet();
         } else {
-            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape,tree=quadtree")
+            client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape,tree=quadtree")
                 .execute().actionGet();
         }
         XContentBuilder docSource = gcb.toXContent(jsonBuilder().startObject().field("location"), null).endObject();
@@ -465,10 +465,10 @@ public void testContainsShapeQuery() throws Exception {
         }
 
         if (usePrefixTrees) {
-            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape,tree=quadtree")
+            client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape,tree=quadtree")
                 .execute().actionGet();
         } else {
-            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape")
+            client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape")
                 .execute().actionGet();
         }
 
@@ -497,10 +497,10 @@ public void testExistsQuery() throws Exception {
         logger.info("Created Random GeometryCollection containing {} shapes", gcb.numShapes());
 
         if (randomBoolean()) {
-            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape")
+            client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape")
                 .execute().actionGet();
         } else {
-            client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape,tree=quadtree")
+            client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape,tree=quadtree")
                 .execute().actionGet();
         }
 
@@ -515,7 +515,7 @@ public void testExistsQuery() throws Exception {
 
     public void testShapeFilterWithDefinedGeoCollection() throws Exception {
         createIndex("shapes");
-        client().admin().indices().prepareCreate("test").addMapping("type", "location", "type=geo_shape,tree=quadtree")
+        client().admin().indices().prepareCreate("test").setMapping("location", "type=geo_shape,tree=quadtree")
                 .get();
 
         XContentBuilder docSource = jsonBuilder().startObject().startObject("location")
diff --git a/server/src/test/java/org/elasticsearch/search/geo/LegacyGeoShapeIntegrationIT.java b/server/src/test/java/org/elasticsearch/search/geo/LegacyGeoShapeIntegrationIT.java
index 4e7ded64a2586..421eb36380551 100644
--- a/server/src/test/java/org/elasticsearch/search/geo/LegacyGeoShapeIntegrationIT.java
+++ b/server/src/test/java/org/elasticsearch/search/geo/LegacyGeoShapeIntegrationIT.java
@@ -102,7 +102,7 @@ public void testOrientationPersistence() throws Exception {
     public void testIgnoreMalformed() throws Exception {
         // create index
         assertAcked(client().admin().indices().prepareCreate("test")
-            .addMapping("geometry", "shape", "type=geo_shape,tree=quadtree,ignore_malformed=true").get());
+            .setMapping("shape", "type=geo_shape,tree=quadtree,ignore_malformed=true").get());
         ensureGreen();
 
         // test self crossing ccw poly not crossing dateline
@@ -169,7 +169,7 @@ public void testIndexShapeRouting() throws Exception {
     public void testLegacyCircle() throws Exception {
         // create index
         assertAcked(client().admin().indices().prepareCreate("test")
-            .addMapping("geometry", "shape", "type=geo_shape,strategy=recursive,tree=geohash").get());
+            .setMapping("shape", "type=geo_shape,strategy=recursive,tree=geohash").get());
         ensureGreen();
 
         indexRandom(true, client().prepareIndex("test").setId("0").setSource("shape", (ToXContent) (builder, params) -> {
diff --git a/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java b/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
index 697ec825abaea..12b86f2f7ee10 100644
--- a/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
+++ b/server/src/test/java/org/elasticsearch/search/morelikethis/MoreLikeThisIT.java
@@ -148,7 +148,7 @@ public void testMoreLikeThisForZeroTokensInOneOfTheAnalyzedFields() throws Excep
     public void testSimpleMoreLikeOnLongField() throws Exception {
         logger.info("Creating index test");
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "some_long", "type=long"));
+                .setMapping("some_long", "type=long"));
         logger.info("Running Cluster Health");
         assertThat(ensureGreen(), equalTo(ClusterHealthStatus.GREEN));
 
@@ -465,7 +465,7 @@ public void testSimpleMoreLikeThisIds() throws Exception {
     public void testMoreLikeThisMultiValueFields() throws Exception {
         logger.info("Creating the index ...");
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "text", "type=text,analyzer=keyword")
+                .setMapping("text", "type=text,analyzer=keyword")
                 .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1)));
         ensureGreen();
 
@@ -497,7 +497,7 @@ public void testMoreLikeThisMultiValueFields() throws Exception {
     public void testMinimumShouldMatch() throws ExecutionException, InterruptedException {
         logger.info("Creating the index ...");
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "text", "type=text,analyzer=whitespace")
+                .setMapping("text", "type=text,analyzer=whitespace")
                 .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1)));
         ensureGreen();
 
@@ -561,7 +561,7 @@ public void testMoreLikeThisArtificialDocs() throws Exception {
     public void testMoreLikeThisMalformedArtificialDocs() throws Exception {
         logger.info("Creating the index ...");
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "text", "type=text,analyzer=whitespace", "date", "type=date"));
+                .setMapping("text", "type=text,analyzer=whitespace", "date", "type=date"));
         ensureGreen("test");
 
         logger.info("Creating an index with a single document ...");
@@ -663,7 +663,7 @@ public void testMoreLikeThisUnlike() throws ExecutionException, InterruptedExcep
 
     public void testSelectFields() throws IOException, ExecutionException, InterruptedException {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "text", "type=text,analyzer=whitespace", "text1", "type=text,analyzer=whitespace"));
+                .setMapping("text", "type=text,analyzer=whitespace", "text1", "type=text,analyzer=whitespace"));
         ensureGreen("test");
 
         indexRandom(true, client().prepareIndex("test").setId("1").setSource(jsonBuilder()
diff --git a/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java b/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
index 4658191c6baed..feb1df13a071b 100644
--- a/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
+++ b/server/src/test/java/org/elasticsearch/search/nested/SimpleNestedIT.java
@@ -60,7 +60,7 @@
 public class SimpleNestedIT extends ESIntegTestCase {
     public void testSimpleNested() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "nested1", "type=nested"));
+                .setMapping("nested1", "type=nested"));
         ensureGreen();
 
         // check on no data, see it works
@@ -1345,7 +1345,6 @@ public void testCheckFixedBitSetCache() throws Exception {
         }
         assertAcked(prepareCreate("test")
                         .setSettings(settingsBuilder)
-                        .addMapping("type")
         );
 
         client().prepareIndex("test").setId("0").setSource("field", "value").get();
diff --git a/server/src/test/java/org/elasticsearch/search/profile/aggregation/AggregationProfilerIT.java b/server/src/test/java/org/elasticsearch/search/profile/aggregation/AggregationProfilerIT.java
index 1626ff1a24a6d..84944ca6b2a45 100644
--- a/server/src/test/java/org/elasticsearch/search/profile/aggregation/AggregationProfilerIT.java
+++ b/server/src/test/java/org/elasticsearch/search/profile/aggregation/AggregationProfilerIT.java
@@ -61,7 +61,7 @@ protected int numberOfShards() {
     @Override
     protected void setupSuiteScopeCluster() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("idx")
-                .addMapping("type", STRING_FIELD, "type=keyword", NUMBER_FIELD, "type=integer", TAG_FIELD, "type=keyword").get());
+                .setMapping(STRING_FIELD, "type=keyword", NUMBER_FIELD, "type=integer", TAG_FIELD, "type=keyword").get());
         List<IndexRequestBuilder> builders = new ArrayList<>();
 
         String[] randomStrings = new String[randomIntBetween(2, 10)];
diff --git a/server/src/test/java/org/elasticsearch/search/query/MultiMatchQueryIT.java b/server/src/test/java/org/elasticsearch/search/query/MultiMatchQueryIT.java
index 82d09e83b7980..adaf062563b5b 100644
--- a/server/src/test/java/org/elasticsearch/search/query/MultiMatchQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/MultiMatchQueryIT.java
@@ -626,7 +626,7 @@ public void testFuzzyFieldLevelBoosting() throws InterruptedException, Execution
                 .put(SETTING_NUMBER_OF_SHARDS, 3)
                 .put(SETTING_NUMBER_OF_REPLICAS, 0)
                 );
-        assertAcked(builder.addMapping("type", "title", "type=text", "body", "type=text"));
+        assertAcked(builder.setMapping("title", "type=text", "body", "type=text"));
         ensureGreen();
         List<IndexRequestBuilder> builders = new ArrayList<>();
         builders.add(client().prepareIndex(idx).setId("1").setSource(
diff --git a/server/src/test/java/org/elasticsearch/search/query/ScriptScoreQueryIT.java b/server/src/test/java/org/elasticsearch/search/query/ScriptScoreQueryIT.java
index 71380ce9fa303..48e8e9abfbb6b 100644
--- a/server/src/test/java/org/elasticsearch/search/query/ScriptScoreQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/ScriptScoreQueryIT.java
@@ -74,7 +74,7 @@ protected Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
     // 3) min score applied
     public void testScriptScore() {
         assertAcked(
-            prepareCreate("test-index").addMapping("_doc", "field1", "type=text", "field2", "type=double")
+            prepareCreate("test-index").setMapping("field1", "type=text", "field2", "type=double")
         );
         int docCount = 10;
         for (int i = 1; i <= docCount; i++) {
@@ -108,7 +108,7 @@ public void testScriptScore() {
 
     public void testScriptScoreBoolQuery() {
         assertAcked(
-            prepareCreate("test-index").addMapping("_doc", "field1", "type=text", "field2", "type=double")
+            prepareCreate("test-index").setMapping("field1", "type=text", "field2", "type=double")
         );
         int docCount = 10;
         for (int i = 1; i <= docCount; i++) {
@@ -138,7 +138,7 @@ public void testRewrittenQuery() {
         assertAcked(
             prepareCreate("test-index2")
             .setSettings(Settings.builder().put("index.number_of_shards", 1))
-            .addMapping("_doc", "field1", "type=date", "field2", "type=double")
+            .setMapping("field1", "type=date", "field2", "type=double")
         );
         client().prepareIndex("test-index2").setId("1").setSource("field1", "2019-09-01", "field2", 1).get();
         client().prepareIndex("test-index2").setId("2").setSource("field1", "2019-10-01", "field2", 2).get();
diff --git a/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java b/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
index 0d848cf5dce30..336a5500cfc71 100644
--- a/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/SearchQueryIT.java
@@ -176,7 +176,7 @@ public void testIssue3177() {
 
     public void testIndexOptions() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "field1", "type=text,index_options=docs"));
+                .setMapping("field1", "type=text,index_options=docs"));
         indexRandom(true,
                 client().prepareIndex("test").setId("1").setSource("field1", "quick brown fox", "field2", "quick brown fox"),
                 client().prepareIndex("test").setId("2").setSource("field1", "quick lazy huge brown fox",
@@ -316,8 +316,8 @@ public void testLowercaseExpandedTerms() {
     public void testDateRangeInQueryString() {
         //the mapping needs to be provided upfront otherwise we are not sure how many failures we get back
         //as with dynamic mappings some shards might be lacking behind and parse a different query
-        assertAcked(prepareCreate("test").addMapping(
-                "type", "past", "type=date", "future", "type=date"
+        assertAcked(prepareCreate("test").setMapping(
+            "past", "type=date", "future", "type=date"
         ));
 
         ZonedDateTime now = ZonedDateTime.now(ZoneOffset.UTC);
@@ -342,7 +342,7 @@ public void testDateRangeInQueryString() {
     public void testDateRangeInQueryStringWithTimeZone_7880() {
         //the mapping needs to be provided upfront otherwise we are not sure how many failures we get back
         //as with dynamic mappings some shards might be lacking behind and parse a different query
-        assertAcked(prepareCreate("test").addMapping("type", "past", "type=date"));
+        assertAcked(prepareCreate("test").setMapping("past", "type=date"));
 
         ZoneId timeZone = randomZone();
         String now = DateFormatter.forPattern("strict_date_optional_time").format(Instant.now().atZone(timeZone));
@@ -359,8 +359,8 @@ public void testDateRangeInQueryStringWithTimeZone_7880() {
     public void testDateRangeInQueryStringWithTimeZone_10477() {
         //the mapping needs to be provided upfront otherwise we are not sure how many failures we get back
         //as with dynamic mappings some shards might be lacking behind and parse a different query
-        assertAcked(prepareCreate("test").addMapping(
-                "type", "past", "type=date"
+        assertAcked(prepareCreate("test").setMapping(
+                "past", "type=date"
         ));
 
         client().prepareIndex("test").setId("1").setSource("past", "2015-04-05T23:00:00+0000").get();
@@ -536,7 +536,7 @@ public void testFiltersWithCustomCacheKey() throws Exception {
     }
 
     public void testMatchQueryNumeric() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", "long", "type=long", "double", "type=double"));
+        assertAcked(prepareCreate("test").setMapping("long", "type=long", "double", "type=double"));
 
         indexRandom(true, client().prepareIndex("test").setId("1").setSource("long", 1L, "double", 1.0d),
                 client().prepareIndex("test").setId("2").setSource("long", 2L, "double", 2.0d),
@@ -553,7 +553,7 @@ public void testMatchQueryNumeric() throws Exception {
     }
 
     public void testMatchQueryFuzzy() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("_doc", "text", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("text", "type=text"));
 
         indexRandom(true, client().prepareIndex("test").setId("1").setSource("text", "Unit"),
                 client().prepareIndex("test").setId("2").setSource("text", "Unity"));
@@ -657,7 +657,7 @@ public void testMultiMatchQuery() throws Exception {
 
     public void testMatchQueryZeroTermsQuery() {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "field1", "type=text,analyzer=classic", "field2", "type=text,analyzer=classic"));
+                .setMapping("field1", "type=text,analyzer=classic", "field2", "type=text,analyzer=classic"));
         client().prepareIndex("test").setId("1").setSource("field1", "value1").get();
         client().prepareIndex("test").setId("2").setSource("field1", "value2").get();
         refresh();
@@ -681,7 +681,7 @@ public void testMatchQueryZeroTermsQuery() {
 
     public void testMultiMatchQueryZeroTermsQuery() {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "field1", "type=text,analyzer=classic", "field2", "type=text,analyzer=classic"));
+                .setMapping("field1", "type=text,analyzer=classic", "field2", "type=text,analyzer=classic"));
         client().prepareIndex("test").setId("1").setSource("field1", "value1", "field2", "value2").get();
         client().prepareIndex("test").setId("2").setSource("field1", "value3", "field2", "value4").get();
         refresh();
@@ -863,7 +863,7 @@ public void testSpecialRangeSyntaxInQueryString() {
     }
 
     public void testEmptytermsQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type", "term", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("term", "type=text"));
 
         indexRandom(true, client().prepareIndex("test").setId("1").setSource("term", "1"),
                 client().prepareIndex("test").setId("2").setSource("term", "2"),
@@ -879,7 +879,7 @@ public void testEmptytermsQuery() throws Exception {
     }
 
     public void testTermsQuery() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type", "str", "type=text", "lng", "type=long", "dbl", "type=double"));
+        assertAcked(prepareCreate("test").setMapping("str", "type=text", "lng", "type=long", "dbl", "type=double"));
 
         indexRandom(true,
                 client().prepareIndex("test").setId("1").setSource("str", "1", "lng", 1L, "dbl", 1.0d),
@@ -946,13 +946,13 @@ public void testTermsQuery() throws Exception {
     }
 
     public void testTermsLookupFilter() throws Exception {
-        assertAcked(prepareCreate("lookup").addMapping("type", "terms","type=text", "other", "type=text"));
+        assertAcked(prepareCreate("lookup").setMapping("terms","type=text", "other", "type=text"));
         assertAcked(prepareCreate("lookup2").setMapping(
                 jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("arr").startObject("properties").startObject("term").field("type", "text")
                         .endObject().endObject().endObject().endObject().endObject().endObject()));
-        assertAcked(prepareCreate("lookup3").addMapping("type", "_source", "enabled=false", "terms","type=text"));
-        assertAcked(prepareCreate("test").addMapping("type", "term", "type=text"));
+        assertAcked(prepareCreate("lookup3").setMapping("_source", "enabled=false", "terms","type=text"));
+        assertAcked(prepareCreate("test").setMapping("term", "type=text"));
 
         indexRandom(true,
                 client().prepareIndex("lookup").setId("1").setSource("terms", new String[]{"1", "3"}),
@@ -1076,7 +1076,7 @@ public void testBasicQueryById() throws Exception {
 
     public void testNumericTermsAndRanges() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1",
+                .setMapping(
                         "num_byte", "type=byte", "num_short", "type=short",
                         "num_integer", "type=integer", "num_long", "type=long",
                         "num_float", "type=float", "num_double", "type=double"));
@@ -1175,7 +1175,7 @@ public void testNumericTermsAndRanges() throws Exception {
 
     public void testNumericRangeFilter_2826() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1",
+                .setMapping(
                         "num_byte", "type=byte", "num_short", "type=short",
                         "num_integer", "type=integer", "num_long", "type=long",
                         "num_float", "type=float", "num_double", "type=double"));
@@ -1496,7 +1496,7 @@ public void testDateProvidedAsNumber() throws InterruptedException {
 
     public void testRangeQueryWithTimeZone() throws Exception {
         assertAcked(prepareCreate("test")
-                .addMapping("type1", "date", "type=date", "num", "type=integer"));
+                .setMapping("date", "type=date", "num", "type=integer"));
 
         indexRandom(true,
                 client().prepareIndex("test").setId("1").setSource("date", "2014-01-01", "num", 1),
@@ -1662,7 +1662,7 @@ public void testQueryStringParserCache() throws Exception {
     }
 
     public void testRangeQueryRangeFields_24744() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", "int_range", "type=integer_range"));
+        assertAcked(prepareCreate("test").setMapping("int_range", "type=integer_range"));
 
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject().startObject("int_range").field("gte", 10).field("lte", 20).endObject().endObject())
diff --git a/server/src/test/java/org/elasticsearch/search/scroll/SearchScrollIT.java b/server/src/test/java/org/elasticsearch/search/scroll/SearchScrollIT.java
index 143fa3de4c3dc..94e661552b9d6 100644
--- a/server/src/test/java/org/elasticsearch/search/scroll/SearchScrollIT.java
+++ b/server/src/test/java/org/elasticsearch/search/scroll/SearchScrollIT.java
@@ -491,7 +491,7 @@ public void testStringSortMissingAscTerminates() throws Exception {
         assertAcked(prepareCreate("test")
                 .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                         .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("test", "no_field", "type=keyword", "some_field", "type=keyword"));
+                .setMapping("no_field", "type=keyword", "some_field", "type=keyword"));
         client().prepareIndex("test").setId("1").setSource("some_field", "test").get();
         refresh();
 
diff --git a/server/src/test/java/org/elasticsearch/search/searchafter/SearchAfterIT.java b/server/src/test/java/org/elasticsearch/search/searchafter/SearchAfterIT.java
index c2c2efd755d17..b379be435e529 100644
--- a/server/src/test/java/org/elasticsearch/search/searchafter/SearchAfterIT.java
+++ b/server/src/test/java/org/elasticsearch/search/searchafter/SearchAfterIT.java
@@ -46,12 +46,11 @@
 
 public class SearchAfterIT extends ESIntegTestCase {
     private static final String INDEX_NAME = "test";
-    private static final String TYPE_NAME = "type1";
     private static final int NUM_DOCS = 100;
 
     public void testsShouldFail() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-            .addMapping("type1", "field2", "type=keyword")
+            .setMapping("field2", "type=keyword")
             .get()
         );
         ensureGreen();
@@ -133,7 +132,7 @@ public void testsShouldFail() throws Exception {
 
     public void testWithNullStrings() throws InterruptedException {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "field2", "type=keyword").get());
+                .setMapping("field2", "type=keyword").get());
         ensureGreen();
         indexRandom(true,
                 client().prepareIndex("test").setId("0").setSource("field1", 0),
@@ -191,7 +190,7 @@ public void testWithSimpleTypes() throws Exception {
         if (reqSize == 0) {
             reqSize = 1;
         }
-        assertSearchFromWithSortValues(INDEX_NAME, TYPE_NAME, documents, reqSize);
+        assertSearchFromWithSortValues(INDEX_NAME, documents, reqSize);
     }
 
     private static class ListComparator implements Comparator<List> {
@@ -221,10 +220,10 @@ public int compare(List o1, List o2) {
     }
     private ListComparator LST_COMPARATOR = new ListComparator();
 
-    private void assertSearchFromWithSortValues(String indexName, String typeName, List<List> documents, int reqSize) throws Exception {
+    private void assertSearchFromWithSortValues(String indexName, List<List> documents, int reqSize) throws Exception {
         int numFields = documents.get(0).size();
         {
-            createIndexMappingsFromObjectType(indexName, typeName, documents.get(0));
+            createIndexMappingsFromObjectType(indexName, documents.get(0));
             List<IndexRequestBuilder> requests = new ArrayList<>();
             for (int i = 0; i < documents.size(); i++) {
                 XContentBuilder builder = jsonBuilder();
@@ -260,7 +259,7 @@ private void assertSearchFromWithSortValues(String indexName, String typeName, L
         }
     }
 
-    private void createIndexMappingsFromObjectType(String indexName, String typeName, List<Object> types) {
+    private void createIndexMappingsFromObjectType(String indexName, List<Object> types) {
         CreateIndexRequestBuilder indexRequestBuilder = client().admin().indices().prepareCreate(indexName);
         List<String> mappings = new ArrayList<> ();
         int numFields = types.size();
@@ -294,7 +293,7 @@ private void createIndexMappingsFromObjectType(String indexName, String typeName
                 fail("Can't match type [" + type + "]");
             }
         }
-        indexRequestBuilder.addMapping(typeName, mappings.toArray()).get();
+        indexRequestBuilder.setMapping(mappings.toArray()).get();
         ensureGreen();
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/simple/SimpleSearchIT.java b/server/src/test/java/org/elasticsearch/search/simple/SimpleSearchIT.java
index e3700bba0e70f..d2e6195a1674d 100644
--- a/server/src/test/java/org/elasticsearch/search/simple/SimpleSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/simple/SimpleSearchIT.java
@@ -260,7 +260,7 @@ public void testSimpleIndexSortEarlyTerminate() throws Exception {
                 .put(SETTING_NUMBER_OF_REPLICAS, 0)
                 .put("index.sort.field", "rank")
             )
-            .addMapping("type1", "rank", "type=integer")
+            .setMapping("rank", "type=integer")
             .get();
         ensureGreen();
         int max = randomIntBetween(3, 29);
@@ -415,7 +415,7 @@ public void testTooLargeRescoreOkByDynamicResultWindowSetting() throws Exception
     }
 
     public void testQueryNumericFieldWithRegex() throws Exception {
-        assertAcked(prepareCreate("idx").addMapping("type", "num", "type=integer"));
+        assertAcked(prepareCreate("idx").setMapping("num", "type=integer"));
         ensureGreen("idx");
 
         try {
diff --git a/server/src/test/java/org/elasticsearch/search/sort/FieldSortIT.java b/server/src/test/java/org/elasticsearch/search/sort/FieldSortIT.java
index 1bb3444d5ea54..9ab9ed960f730 100644
--- a/server/src/test/java/org/elasticsearch/search/sort/FieldSortIT.java
+++ b/server/src/test/java/org/elasticsearch/search/sort/FieldSortIT.java
@@ -122,7 +122,7 @@ public void testIssue8226() {
         final boolean useMapping = randomBoolean();
         for (int i = 0; i < numIndices; i++) {
             if (useMapping) {
-                assertAcked(prepareCreate("test_" + i).addAlias(new Alias("test")).addMapping("foo", "entry", "type=long"));
+                assertAcked(prepareCreate("test_" + i).addAlias(new Alias("test")).setMapping("entry", "type=long"));
             } else {
                 assertAcked(prepareCreate("test_" + i).addAlias(new Alias("test")));
             }
@@ -211,7 +211,7 @@ public void testIssue6614() throws ExecutionException, InterruptedException {
 
     public void testTrackScores() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "svalue", "type=keyword").get());
+                .setMapping("svalue", "type=keyword").get());
         ensureGreen();
         index("test", jsonBuilder().startObject()
                 .field("id", "1")
@@ -325,7 +325,7 @@ public void testRandomSorting() throws IOException, InterruptedException, Execut
 
     public void test3078() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "field", "type=keyword").get());
+                .setMapping("field", "type=keyword").get());
         ensureGreen();
 
         for (int i = 1; i < 101; i++) {
@@ -455,7 +455,7 @@ public void testScoreSortDirectionWithFunctionScore() throws Exception {
 
     public void testIssue2986() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("post", "field1", "type=keyword").get());
+                .setMapping("field1", "type=keyword").get());
 
         client().prepareIndex("test").setId("1").setSource("{\"field1\":\"value1\"}", XContentType.JSON).get();
         client().prepareIndex("test").setId("2").setSource("{\"field1\":\"value2\"}", XContentType.JSON).get();
@@ -477,7 +477,7 @@ public void testIssue2991() {
                 // ignore
             }
             assertAcked(client().admin().indices().prepareCreate("test")
-                    .addMapping("type", "tag", "type=keyword").get());
+                    .setMapping("tag", "type=keyword").get());
             ensureGreen();
             client().prepareIndex("test").setId("1").setSource("tag", "alpha").get();
             refresh();
@@ -1545,10 +1545,10 @@ public void testSortDuelBetweenSingleShardAndMultiShardIndex() throws Exception
         String sortField = "sortField";
         assertAcked(prepareCreate("test1")
                 .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, between(2, maximumNumberOfShards())))
-                .addMapping("type", sortField, "type=long").get());
+                .setMapping(sortField, "type=long").get());
         assertAcked(prepareCreate("test2")
                 .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1))
-                .addMapping("type", sortField, "type=long").get());
+                .setMapping(sortField, "type=long").get());
 
         for (String index : new String[]{"test1", "test2"}) {
             List<IndexRequestBuilder> docs = new ArrayList<>();
@@ -1581,7 +1581,7 @@ public void testCustomFormat() throws Exception {
         // representations of values, to make sure values are both correctly
         // rendered and parsed (search_after)
         assertAcked(prepareCreate("test")
-                .addMapping("type", "ip", "type=ip"));
+                .setMapping("ip", "type=ip"));
         indexRandom(true,
                 client().prepareIndex("test").setId("1").setSource("ip", "192.168.1.7"),
                 client().prepareIndex("test").setId("2").setSource("ip", "2001:db8::ff00:42:8329"));
@@ -1609,7 +1609,7 @@ public void testCustomFormat() throws Exception {
 
     public void testScriptFieldSort() throws Exception {
         assertAcked(prepareCreate("test")
-            .addMapping("t", "keyword", "type=keyword", "number", "type=integer"));
+            .setMapping("keyword", "type=keyword", "number", "type=integer"));
         ensureGreen();
         final int numDocs = randomIntBetween(10, 20);
         IndexRequestBuilder[] indexReqs = new IndexRequestBuilder[numDocs];
@@ -1661,9 +1661,9 @@ public void testFieldAlias() throws Exception {
         // Create two indices and add the field 'route_length_miles' as an alias in
         // one, and a concrete field in the other.
         assertAcked(prepareCreate("old_index")
-            .addMapping("_doc", "distance", "type=double", "route_length_miles", "type=alias,path=distance"));
+            .setMapping("distance", "type=double", "route_length_miles", "type=alias,path=distance"));
         assertAcked(prepareCreate("new_index")
-            .addMapping("_doc", "route_length_miles", "type=double"));
+            .setMapping("route_length_miles", "type=double"));
         ensureGreen("old_index", "new_index");
 
         List<IndexRequestBuilder> builders = new ArrayList<>();
@@ -1689,9 +1689,9 @@ public void testFieldAliasesWithMissingValues() throws Exception {
         // Create two indices and add the field 'route_length_miles' as an alias in
         // one, and a concrete field in the other.
         assertAcked(prepareCreate("old_index")
-            .addMapping("_doc", "distance", "type=double", "route_length_miles", "type=alias,path=distance"));
+            .setMapping("distance", "type=double", "route_length_miles", "type=alias,path=distance"));
         assertAcked(prepareCreate("new_index")
-            .addMapping("_doc", "route_length_miles", "type=double"));
+            .setMapping("route_length_miles", "type=double"));
         ensureGreen("old_index", "new_index");
 
         List<IndexRequestBuilder> builders = new ArrayList<>();
@@ -1715,11 +1715,11 @@ public void testFieldAliasesWithMissingValues() throws Exception {
 
     public void testCastNumericType() throws Exception {
         assertAcked(prepareCreate("index_double")
-            .addMapping("_doc", "field", "type=double"));
+            .setMapping("field", "type=double"));
         assertAcked(prepareCreate("index_long")
-            .addMapping("_doc", "field", "type=long"));
+            .setMapping("field", "type=long"));
         assertAcked(prepareCreate("index_float")
-            .addMapping("_doc", "field", "type=float"));
+            .setMapping("field", "type=float"));
         ensureGreen("index_double", "index_long", "index_float");
 
         List<IndexRequestBuilder> builders = new ArrayList<>();
@@ -1764,9 +1764,9 @@ public void testCastNumericType() throws Exception {
 
     public void testCastDate() throws Exception {
         assertAcked(prepareCreate("index_date")
-            .addMapping("_doc", "field", "type=date"));
+            .setMapping("field", "type=date"));
         assertAcked(prepareCreate("index_date_nanos")
-            .addMapping("_doc", "field", "type=date_nanos"));
+            .setMapping("field", "type=date_nanos"));
         ensureGreen("index_date", "index_date_nanos");
 
         List<IndexRequestBuilder> builders = new ArrayList<>();
@@ -1842,7 +1842,7 @@ public void testCastDate() throws Exception {
 
     public void testCastNumericTypeExceptions() throws Exception {
         assertAcked(prepareCreate("index")
-            .addMapping("_doc", "keyword", "type=keyword", "ip", "type=ip"));
+            .setMapping("keyword", "type=keyword", "ip", "type=ip"));
         ensureGreen("index");
         for (String invalidField : new String[] {"keyword", "ip"}) {
             for (String numericType : new String[]{"long", "double", "date", "date_nanos"}) {
@@ -1860,7 +1860,7 @@ public void testCastNumericTypeExceptions() throws Exception {
     public void testLongSortOptimizationCorrectResults() {
         assertAcked(prepareCreate("test1")
             .setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 2))
-            .addMapping("_doc", "long_field", "type=long").get());
+            .setMapping("long_field", "type=long").get());
 
         BulkRequestBuilder bulkBuilder = client().prepareBulk();
         for (int i = 1; i <= 7000; i++) {
diff --git a/server/src/test/java/org/elasticsearch/search/sort/GeoDistanceSortBuilderIT.java b/server/src/test/java/org/elasticsearch/search/sort/GeoDistanceSortBuilderIT.java
index 018d3601d6cb7..e86b64f28f7f9 100644
--- a/server/src/test/java/org/elasticsearch/search/sort/GeoDistanceSortBuilderIT.java
+++ b/server/src/test/java/org/elasticsearch/search/sort/GeoDistanceSortBuilderIT.java
@@ -71,7 +71,7 @@ public void testManyToManyGeoPoints() throws ExecutionException, InterruptedExce
         Version version = randomBoolean() ? Version.CURRENT
                 : VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        assertAcked(prepareCreate("index").setSettings(settings).addMapping("type", LOCATION_FIELD, "type=geo_point"));
+        assertAcked(prepareCreate("index").setSettings(settings).setMapping(LOCATION_FIELD, "type=geo_point"));
         XContentBuilder d1Builder = jsonBuilder();
         GeoPoint[] d1Points = {new GeoPoint(3, 2), new GeoPoint(4, 1)};
         createShuffeldJSONArray(d1Builder, d1Points);
@@ -145,7 +145,7 @@ public void testSingeToManyAvgMedian() throws ExecutionException, InterruptedExc
         Version version = randomBoolean() ? Version.CURRENT
                 : VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        assertAcked(prepareCreate("index").setSettings(settings).addMapping("type", LOCATION_FIELD, "type=geo_point"));
+        assertAcked(prepareCreate("index").setSettings(settings).setMapping(LOCATION_FIELD, "type=geo_point"));
         XContentBuilder d1Builder = jsonBuilder();
         GeoPoint[] d1Points = {new GeoPoint(0, 1), new GeoPoint(0, 4), new GeoPoint(0, 10)};
         createShuffeldJSONArray(d1Builder, d1Points);
@@ -210,7 +210,7 @@ public void testManyToManyGeoPointsWithDifferentFormats() throws ExecutionExcept
         Version version = randomBoolean() ? Version.CURRENT
                 : VersionUtils.randomIndexCompatibleVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        assertAcked(prepareCreate("index").setSettings(settings).addMapping("type", LOCATION_FIELD, "type=geo_point"));
+        assertAcked(prepareCreate("index").setSettings(settings).setMapping(LOCATION_FIELD, "type=geo_point"));
         XContentBuilder d1Builder = jsonBuilder();
         GeoPoint[] d1Points = {new GeoPoint(2.5, 1), new GeoPoint(2.75, 2), new GeoPoint(3, 3), new GeoPoint(3.25, 4)};
         createShuffeldJSONArray(d1Builder, d1Points);
@@ -258,7 +258,7 @@ public void testManyToManyGeoPointsWithDifferentFormats() throws ExecutionExcept
     }
 
     public void testSinglePointGeoDistanceSort() throws ExecutionException, InterruptedException, IOException {
-        assertAcked(prepareCreate("index").addMapping("type", LOCATION_FIELD, "type=geo_point"));
+        assertAcked(prepareCreate("index").setMapping(LOCATION_FIELD, "type=geo_point"));
         indexRandom(true,
                 client().prepareIndex("index").setId("d1")
                 .setSource(jsonBuilder().startObject().startObject(LOCATION_FIELD).field("lat", 1).field("lon", 1).endObject().endObject()),
@@ -330,8 +330,8 @@ private static void checkCorrectSortOrderForGeoSort(SearchResponse searchRespons
     }
 
     public void testCrossIndexIgnoreUnmapped() throws Exception {
-        assertAcked(prepareCreate("test1").addMapping(
-                "type", "str_field", "type=keyword",
+        assertAcked(prepareCreate("test1").setMapping(
+                "str_field", "type=keyword",
                 "long_field", "type=long",
                 "double_field", "type=double").get());
         assertAcked(prepareCreate("test2").get());
diff --git a/server/src/test/java/org/elasticsearch/search/source/MetadataFetchingIT.java b/server/src/test/java/org/elasticsearch/search/source/MetadataFetchingIT.java
index 674e5b381d77a..1f035a760752c 100644
--- a/server/src/test/java/org/elasticsearch/search/source/MetadataFetchingIT.java
+++ b/server/src/test/java/org/elasticsearch/search/source/MetadataFetchingIT.java
@@ -61,7 +61,7 @@ public void testSimple() {
     }
 
     public void testInnerHits() {
-        assertAcked(prepareCreate("test").addMapping("_doc", "nested", "type=nested"));
+        assertAcked(prepareCreate("test").setMapping("nested", "type=nested"));
         ensureGreen();
         client().prepareIndex("test").setId("1")
             .setSource("field", "value", "nested", Collections.singletonMap("title", "foo")).get();
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
index f746484e26693..8f88cccfce989 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/SuggestSearchIT.java
@@ -84,7 +84,7 @@ public class SuggestSearchIT extends ESIntegTestCase {
 
     // see #3196
     public void testSuggestAcrossMultipleIndices() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("type1", "text", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("text", "type=text"));
         ensureGreen();
 
         indexDoc("test", "1", "text", "abcd");
@@ -98,7 +98,7 @@ public void testSuggestAcrossMultipleIndices() throws IOException {
                 .text("abcd");
         logger.info("--> run suggestions with one index");
         searchSuggest("test", termSuggest);
-        assertAcked(prepareCreate("test_1").addMapping("type1", "text", "type=text"));
+        assertAcked(prepareCreate("test_1").setMapping("text", "type=text"));
         ensureGreen();
 
         indexDoc("test_1", "1", "text", "ab cd");
@@ -303,7 +303,7 @@ public void testUnmappedField() throws IOException, InterruptedException, Execut
     }
 
     public void testSimple() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", "text", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("text", "type=text"));
         ensureGreen();
 
         indexDoc("test", "1", "text", "abcd");
@@ -328,7 +328,7 @@ public void testSimple() throws Exception {
     }
 
     public void testEmpty() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", "text", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("text", "type=text"));
         ensureGreen();
 
         indexDoc("test", "1", "text", "bar");
@@ -347,7 +347,7 @@ public void testEmpty() throws Exception {
     }
 
     public void testEmptyIndex() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("type1", "text", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("text", "type=text"));
         ensureGreen();
 
         // use SuggestMode.ALWAYS, otherwise the results can vary between requests.
@@ -375,7 +375,7 @@ public void testEmptyIndex() throws Exception {
     }
 
     public void testWithMultipleCommands() throws Exception {
-        assertAcked(prepareCreate("test").addMapping("typ1", "field1", "type=text", "field2", "type=text"));
+        assertAcked(prepareCreate("test").setMapping("field1", "type=text", "field2", "type=text"));
         ensureGreen();
 
         indexDoc("test", "1", "field1", "prefix_abcd", "field2", "prefix_efgh");
@@ -454,7 +454,7 @@ public void testSizeAndSort() throws Exception {
 
     // see #2817
     public void testStopwordsOnlyPhraseSuggest() throws IOException {
-        assertAcked(prepareCreate("test").addMapping("typ1", "body", "type=text,analyzer=stopwd").setSettings(
+        assertAcked(prepareCreate("test").setMapping("body", "type=text,analyzer=stopwd").setSettings(
                 Settings.builder()
                         .put("index.analysis.analyzer.stopwd.tokenizer", "standard")
                         .putList("index.analysis.analyzer.stopwd.filter", "stop")
diff --git a/server/src/test/java/org/elasticsearch/test/search/aggregations/bucket/SharedSignificantTermsTestMethods.java b/server/src/test/java/org/elasticsearch/test/search/aggregations/bucket/SharedSignificantTermsTestMethods.java
index 6a62ac3da082c..a47859e808937 100644
--- a/server/src/test/java/org/elasticsearch/test/search/aggregations/bucket/SharedSignificantTermsTestMethods.java
+++ b/server/src/test/java/org/elasticsearch/test/search/aggregations/bucket/SharedSignificantTermsTestMethods.java
@@ -82,7 +82,7 @@ public static void index01Docs(String type, String settings, ESIntegTestCase tes
             textMappings += ",fielddata=true";
         }
         assertAcked(testCase.prepareCreate(INDEX_NAME).setSettings(settings, XContentType.JSON)
-                .addMapping("_doc", "text", textMappings, CLASS_FIELD, "type=keyword"));
+                .setMapping("text", textMappings, CLASS_FIELD, "type=keyword"));
         String[] gb = {"0", "1"};
         List<IndexRequestBuilder> indexRequestBuilderList = new ArrayList<>();
         indexRequestBuilderList.add(client().prepareIndex(INDEX_NAME).setId("1")
diff --git a/server/src/test/java/org/elasticsearch/update/UpdateIT.java b/server/src/test/java/org/elasticsearch/update/UpdateIT.java
index df561952b8841..d1cc7c8c2bb00 100644
--- a/server/src/test/java/org/elasticsearch/update/UpdateIT.java
+++ b/server/src/test/java/org/elasticsearch/update/UpdateIT.java
@@ -493,7 +493,6 @@ public void testUpdateRequestWithScriptAndShouldUpsertDoc() throws Exception {
     public void testContextVariables() throws Exception {
         assertAcked(prepareCreate("test")
                         .addAlias(new Alias("alias"))
-                        .addMapping("type1")
         );
         ensureGreen();
 
diff --git a/server/src/test/java/org/elasticsearch/validate/SimpleValidateQueryIT.java b/server/src/test/java/org/elasticsearch/validate/SimpleValidateQueryIT.java
index e364a91f0f719..4d20b1c5b1e6a 100644
--- a/server/src/test/java/org/elasticsearch/validate/SimpleValidateQueryIT.java
+++ b/server/src/test/java/org/elasticsearch/validate/SimpleValidateQueryIT.java
@@ -177,7 +177,7 @@ public void testExplainNoQuery() {
 
     public void testExplainFilteredAlias() {
         assertAcked(prepareCreate("test")
-                .addMapping("test", "field", "type=text")
+                .setMapping("field", "type=text")
                 .addAlias(new Alias("alias").filter(QueryBuilders.termQuery("field", "value1"))));
         ensureGreen();
 
@@ -191,7 +191,7 @@ public void testExplainFilteredAlias() {
 
     public void testExplainWithRewriteValidateQuery() {
         client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "field", "type=text,analyzer=whitespace")
+                .setMapping("field", "type=text,analyzer=whitespace")
                 .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 1)).get();
         client().prepareIndex("test").setId("1").setSource("field", "quick lazy huge brown pidgin").get();
         client().prepareIndex("test").setId("2").setSource("field", "the quick brown fox").get();
@@ -223,7 +223,7 @@ public void testExplainWithRewriteValidateQuery() {
 
     public void testExplainWithRewriteValidateQueryAllShards() {
         client().admin().indices().prepareCreate("test")
-            .addMapping("type1", "field", "type=text,analyzer=whitespace")
+            .setMapping("field", "type=text,analyzer=whitespace")
             .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 2).put("index.number_of_routing_shards", 2)).get();
         // We are relying on specific routing behaviors for the result to be right, so
         // we cannot randomize the number of shards or change ids here.
@@ -299,7 +299,7 @@ private static void assertExplanations(QueryBuilder queryBuilder,
 
     public void testExplainTermsQueryWithLookup() {
         client().admin().indices().prepareCreate("twitter")
-            .addMapping("_doc", "user", "type=integer", "followers", "type=integer")
+            .setMapping("user", "type=integer", "followers", "type=integer")
             .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 2).put("index.number_of_routing_shards", 2)).get();
         client().prepareIndex("twitter").setId("1")
             .setSource("followers", new int[] {1, 2, 3}).get();
diff --git a/test/framework/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractNumericTestCase.java b/test/framework/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractNumericTestCase.java
index 67abd8f762014..d3d54643f9461 100644
--- a/test/framework/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractNumericTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/search/aggregations/metrics/AbstractNumericTestCase.java
@@ -55,7 +55,7 @@ public void setupSuiteScopeCluster() throws Exception {
         // two docs {value: 0} and {value : 2}, then building a histogram agg with interval 1 and with empty
         // buckets computed.. the empty bucket is the one associated with key "1". then each test will have
         // to check that this bucket exists with the appropriate sub aggregations.
-        prepareCreate("empty_bucket_idx").addMapping("type", "value", "type=integer").execute().actionGet();
+        prepareCreate("empty_bucket_idx").setMapping("value", "type=integer").execute().actionGet();
         builders = new ArrayList<>();
         for (int i = 0; i < 2; i++) {
             builders.add(client().prepareIndex("empty_bucket_idx").setId(String.valueOf(i)).setSource(jsonBuilder()
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
index c60ee7f5da31c..4c371e8cebfd4 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
@@ -287,7 +287,7 @@ protected IndexService createIndex(String index, Settings settings, XContentBuil
     protected IndexService createIndex(String index, Settings settings, String type, Object... mappings) {
         CreateIndexRequestBuilder createIndexRequestBuilder = client().admin().indices().prepareCreate(index).setSettings(settings);
         if (type != null) {
-            createIndexRequestBuilder.addMapping(type, mappings);
+            createIndexRequestBuilder.setMapping(mappings);
         }
         return createIndex(index, createIndexRequestBuilder);
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
index 899c300493ab4..b2ec8e192fcc2 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
@@ -236,7 +236,7 @@ private IndexRequestBuilder[] snashotAndRestore(final String sourceIdx,
             mappings.addAll(Arrays.asList("nested", "type=nested", "incorrect", "type=object"));
         }
         if (mappings.isEmpty() == false) {
-            createIndexRequestBuilder.addMapping("_doc", mappings.toArray());
+            createIndexRequestBuilder.setMapping(mappings.toArray());
         }
         assertAcked(createIndexRequestBuilder);
         ensureGreen();
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/action/ReloadSynonymAnalyzerTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/action/ReloadSynonymAnalyzerTests.java
index da33f608623dc..d6d5336b63691 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/action/ReloadSynonymAnalyzerTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/action/ReloadSynonymAnalyzerTests.java
@@ -62,7 +62,7 @@ public void testSynonymsUpdateable() throws FileNotFoundException, IOException {
                         .put("analysis.filter.synonym_graph_filter.type", "synonym_graph")
                         .put("analysis.filter.synonym_graph_filter.updateable", "true")
                         .put("analysis.filter.synonym_graph_filter.synonyms_path", synonymsFileName))
-                .addMapping("_doc", "field", "type=text,analyzer=standard,search_analyzer=" + synonymAnalyzerName));
+                .setMapping("field", "type=text,analyzer=standard,search_analyzer=" + synonymAnalyzerName));
 
         client().prepareIndex(indexName).setId("1").setSource("field", "Foo").get();
         assertNoFailures(client().admin().indices().prepareRefresh(indexName).execute().actionGet());
@@ -131,7 +131,7 @@ public void testSynonymsInMultiplexerUpdateable() throws FileNotFoundException,
                         .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName)
                         .put("analysis.filter.my_multiplexer.type", "multiplexer")
                         .putList("analysis.filter.my_multiplexer.filters", "synonym_filter"))
-                .addMapping("_doc", "field", "type=text,analyzer=standard,search_analyzer=" + synonymAnalyzerName));
+                .setMapping("field", "type=text,analyzer=standard,search_analyzer=" + synonymAnalyzerName));
 
         client().prepareIndex(indexName).setId("1").setSource("field", "foo").get();
         assertNoFailures(client().admin().indices().prepareRefresh(indexName).execute().actionGet());
@@ -192,6 +192,7 @@ public void testUpdateableSynonymsRejectedAtIndexTime() throws FileNotFoundExcep
 
         final String indexName = "test";
         final String analyzerName = "my_synonym_analyzer";
+
         MapperException ex = expectThrows(MapperException.class,
                 () -> client().admin().indices().prepareCreate(indexName).setSettings(Settings.builder()
                         .put("index.number_of_shards", 5)
@@ -201,7 +202,7 @@ public void testUpdateableSynonymsRejectedAtIndexTime() throws FileNotFoundExcep
                         .put("analysis.filter.synonym_filter.type", "synonym")
                         .put("analysis.filter.synonym_filter.updateable", "true")
                         .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName))
-                        .addMapping("_doc", "field", "type=text,analyzer=" + analyzerName).get());
+                        .setMapping("field", "type=text,analyzer=" + analyzerName).get());
 
         assertEquals("Failed to parse mapping: analyzer [my_synonym_analyzer] "
                 + "contains filters [synonym_filter] that are not allowed to run in all mode.", ex.getMessage());
@@ -218,7 +219,7 @@ public void testUpdateableSynonymsRejectedAtIndexTime() throws FileNotFoundExcep
                         .put("analysis.filter.synonym_filter.synonyms_path", synonymsFileName)
                         .put("analysis.filter.my_multiplexer.type", "multiplexer")
                         .putList("analysis.filter.my_multiplexer.filters", "synonym_filter"))
-                        .addMapping("_doc", "field", "type=text,analyzer=" + analyzerName).get());
+                        .setMapping("field", "type=text,analyzer=" + analyzerName).get());
 
         assertEquals("Failed to parse mapping: analyzer [my_synonym_analyzer] "
                 + "contains filters [my_multiplexer] that are not allowed to run in all mode.", ex.getMessage());
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/rest/action/ReloadSynonymAnalyzerIT.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/rest/action/ReloadSynonymAnalyzerIT.java
index 8535c59cc90f4..6f3c21d1d74fc 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/rest/action/ReloadSynonymAnalyzerIT.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/rest/action/ReloadSynonymAnalyzerIT.java
@@ -78,7 +78,7 @@ public void testSynonymsUpdateable() throws FileNotFoundException, IOException,
                 .put("analysis.filter.my_synonym_filter.type", "synonym")
                 .put("analysis.filter.my_synonym_filter.updateable", "true")
                 .put("analysis.filter.my_synonym_filter.synonyms_path", synonymsFileName))
-                .addMapping("_doc", "field", "type=text,analyzer=standard,search_analyzer=my_synonym_analyzer"));
+                .setMapping("field", "type=text,analyzer=standard,search_analyzer=my_synonym_analyzer"));
 
         client().prepareIndex("test").setId("1").setSource("field", "foo").get();
         assertNoFailures(client().admin().indices().prepareRefresh("test").execute().actionGet());
diff --git a/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/AbstractEnrichTestCase.java b/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/AbstractEnrichTestCase.java
index a6519b894e98e..88fdafa4de415 100644
--- a/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/AbstractEnrichTestCase.java
+++ b/x-pack/plugin/enrich/src/test/java/org/elasticsearch/xpack/enrich/AbstractEnrichTestCase.java
@@ -62,7 +62,7 @@ protected void createSourceIndices(EnrichPolicy policy) {
     protected static void createSourceIndices(Client client, EnrichPolicy policy) {
         for (String sourceIndex : policy.getIndices()) {
             CreateIndexRequest createIndexRequest = new CreateIndexRequest(sourceIndex);
-            createIndexRequest.mapping("_doc", policy.getMatchField(), "type=keyword");
+            createIndexRequest.simpleMapping(policy.getMatchField(), "type=keyword");
             try {
                 client.admin().indices().create(createIndexRequest).actionGet();
             } catch (ResourceAlreadyExistsException e) {
diff --git a/x-pack/plugin/graph/src/test/java/org/elasticsearch/xpack/graph/test/GraphTests.java b/x-pack/plugin/graph/src/test/java/org/elasticsearch/xpack/graph/test/GraphTests.java
index 945fbd9d3f5c6..6b074f8175734 100644
--- a/x-pack/plugin/graph/src/test/java/org/elasticsearch/xpack/graph/test/GraphTests.java
+++ b/x-pack/plugin/graph/src/test/java/org/elasticsearch/xpack/graph/test/GraphTests.java
@@ -81,7 +81,7 @@ public void setUp() throws Exception {
         super.setUp();
         assertAcked(client().admin().indices().prepareCreate("test")
                 .setSettings(Settings.builder().put(SETTING_NUMBER_OF_SHARDS, 2).put(SETTING_NUMBER_OF_REPLICAS, 0))
-                .addMapping("type",
+                .setMapping(
                         "decade", "type=keyword",
                         "people", "type=keyword",
                         "description", "type=text,fielddata=true"));
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/BulkFailureRetryIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/BulkFailureRetryIT.java
index 6dcf306b04a39..6de79d875c305 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/BulkFailureRetryIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/BulkFailureRetryIT.java
@@ -48,7 +48,7 @@ public class BulkFailureRetryIT extends MlNativeAutodetectIntegTestCase {
     @Before
     public void putPastDataIntoIndex() {
         client().admin().indices().prepareCreate(index)
-            .addMapping("type", "time", "type=date", "value", "type=long")
+            .setMapping("time", "type=date", "value", "type=long")
             .get();
         long twoDaysAgo = now - DAY * 2;
         long threeDaysAgo = now - DAY * 3;
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/CategorizationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/CategorizationIT.java
index c873aadfd23dc..36d0b141093ee 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/CategorizationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/CategorizationIT.java
@@ -11,13 +11,13 @@
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.xpack.ml.MachineLearning;
 import org.elasticsearch.xpack.core.ml.datafeed.DatafeedConfig;
 import org.elasticsearch.xpack.core.ml.job.config.AnalysisConfig;
 import org.elasticsearch.xpack.core.ml.job.config.DataDescription;
 import org.elasticsearch.xpack.core.ml.job.config.Detector;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.ml.job.results.CategoryDefinition;
+import org.elasticsearch.xpack.ml.MachineLearning;
 import org.junit.After;
 import org.junit.Before;
 
@@ -26,7 +26,6 @@
 import java.util.List;
 import java.util.Locale;
 
-import static org.elasticsearch.index.mapper.MapperService.SINGLE_MAPPING_NAME;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 
@@ -42,7 +41,7 @@ public class CategorizationIT extends MlNativeAutodetectIntegTestCase {
     @Before
     public void setUpData() {
         client().admin().indices().prepareCreate(DATA_INDEX)
-                .addMapping(SINGLE_MAPPING_NAME, "time", "type=date,format=epoch_millis",
+                .setMapping("time", "type=date,format=epoch_millis",
                         "msg", "type=text")
                 .get();
 
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
index da5439f6298dc..ccf39aa8aa472 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationEvaluationIT.java
@@ -309,7 +309,7 @@ public void testEvaluate_ConfusionMatrixMetricWithUserProvidedSize() {
 
     private static void createAnimalsIndex(String indexName) {
         client().admin().indices().prepareCreate(indexName)
-            .addMapping("_doc",
+            .setMapping(
                 ANIMAL_NAME_FIELD, "type=keyword",
                 ANIMAL_NAME_PREDICTION_FIELD, "type=keyword",
                 NO_LEGS_FIELD, "type=integer",
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 0397eb7cc2363..32d8ad0b79845 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -430,7 +430,7 @@ private void initialize(String jobId) {
 
     private static void createIndex(String index) {
         client().admin().indices().prepareCreate(index)
-            .addMapping("_doc",
+            .setMapping(
                 BOOLEAN_FIELD, "type=boolean",
                 NUMERICAL_FIELD, "type=double",
                 DISCRETE_NUMERICAL_FIELD, "type=integer",
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DatafeedJobsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DatafeedJobsIT.java
index 6a47ca40db4e9..4c2fa67f3a72a 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DatafeedJobsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DatafeedJobsIT.java
@@ -56,7 +56,7 @@ public void cleanup() {
 
     public void testLookbackOnly() throws Exception {
         client().admin().indices().prepareCreate("data-1")
-            .addMapping("type", "time", "type=date")
+            .setMapping("time", "type=date")
             .get();
         long numDocs = randomIntBetween(32, 2048);
         long now = System.currentTimeMillis();
@@ -65,7 +65,7 @@ public void testLookbackOnly() throws Exception {
         indexDocs(logger, "data-1", numDocs, twoWeeksAgo, oneWeekAgo);
 
         client().admin().indices().prepareCreate("data-2")
-            .addMapping("type", "time", "type=date")
+            .setMapping("time", "type=date")
             .get();
         client().admin().cluster().prepareHealth("data-1", "data-2").setWaitForYellowStatus().get();
         long numDocs2 = randomIntBetween(32, 2048);
@@ -101,7 +101,7 @@ public void testLookbackOnly() throws Exception {
 
     public void testDatafeedTimingStats_DatafeedRecreated() throws Exception {
         client().admin().indices().prepareCreate("data")
-            .addMapping("type", "time", "type=date")
+            .setMapping("time", "type=date")
             .get();
         long numDocs = randomIntBetween(32, 2048);
         Instant now = Instant.now();
@@ -138,7 +138,7 @@ public void testDatafeedTimingStats_DatafeedRecreated() throws Exception {
 
     public void testDatafeedTimingStats_QueryDelayUpdated_TimingStatsNotReset() throws Exception {
         client().admin().indices().prepareCreate("data")
-            .addMapping("type", "time", "type=date")
+            .setMapping("time", "type=date")
             .get();
         long numDocs = randomIntBetween(32, 2048);
         Instant now = Instant.now();
@@ -334,7 +334,7 @@ public void testRealtime_GivenProcessIsKilled() throws Exception {
      */
     public void testStopLookbackFollowedByProcessKill() throws Exception {
         client().admin().indices().prepareCreate("data")
-                .addMapping("type", "time", "type=date")
+                .setMapping("time", "type=date")
                 .get();
         long numDocs = randomIntBetween(1024, 2048);
         long now = System.currentTimeMillis();
@@ -384,7 +384,7 @@ private void startRealtime(String jobId) throws Exception {
 
     private void startRealtime(String jobId, Integer maxEmptySearches) throws Exception {
         client().admin().indices().prepareCreate("data")
-                .addMapping("type", "time", "type=date")
+                .setMapping("time", "type=date")
                 .get();
         long now = System.currentTimeMillis();
         long numDocs1;
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DatafeedWithAggsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DatafeedWithAggsIT.java
index 3e89da92b6fd9..c93316afec169 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DatafeedWithAggsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DatafeedWithAggsIT.java
@@ -80,7 +80,7 @@ public void testRealtime() throws Exception {
 
         // Now let's index the data
         client().admin().indices().prepareCreate(dataIndex)
-            .addMapping("type", "time", "type=date")
+            .setMapping("time", "type=date")
             .get();
 
         // Index a doc per second from a minute ago to a minute later
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DelayedDataDetectorIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DelayedDataDetectorIT.java
index c6508d540b4ba..0729fcd4ae77c 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DelayedDataDetectorIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DelayedDataDetectorIT.java
@@ -50,7 +50,7 @@ public class DelayedDataDetectorIT extends MlNativeAutodetectIntegTestCase {
     @Before
     public void putDataintoIndex() {
         client().admin().indices().prepareCreate(index)
-            .addMapping("type", "time", "type=date", "value", "type=long")
+            .setMapping("time", "type=date", "value", "type=long")
             .get();
         numDocs = randomIntBetween(32, 128);
         long oneDayAgo = now - 86400000;
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DeleteExpiredDataIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DeleteExpiredDataIT.java
index 34bd7989f6a7b..25e2e3f50f3c3 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DeleteExpiredDataIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/DeleteExpiredDataIT.java
@@ -41,7 +41,6 @@
 import java.util.List;
 import java.util.concurrent.TimeUnit;
 
-import static org.elasticsearch.index.mapper.MapperService.SINGLE_MAPPING_NAME;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.greaterThan;
 import static org.hamcrest.Matchers.greaterThanOrEqualTo;
@@ -55,7 +54,7 @@ public class DeleteExpiredDataIT extends MlNativeAutodetectIntegTestCase {
     @Before
     public void setUpData() throws IOException {
         client().admin().indices().prepareCreate(DATA_INDEX)
-                .addMapping(SINGLE_MAPPING_NAME, "time", "type=date,format=epoch_millis")
+                .setMapping("time", "type=date,format=epoch_millis")
                 .get();
 
         // We are going to create data for last 2 days
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
index 32ee2d28c865e..b4b17fdd41d8b 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ExplainDataFrameAnalyticsIT.java
@@ -43,7 +43,7 @@ public void testSourceQueryIsApplied() throws IOException {
         String sourceIndex = "test-source-query-is-applied";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ModelPlotsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ModelPlotsIT.java
index 4041aa78e122e..5c80ce9034c33 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ModelPlotsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ModelPlotsIT.java
@@ -28,7 +28,6 @@
 import java.util.Set;
 import java.util.stream.Collectors;
 
-import static org.elasticsearch.index.mapper.MapperService.SINGLE_MAPPING_NAME;
 import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.greaterThanOrEqualTo;
 import static org.hamcrest.Matchers.is;
@@ -41,7 +40,7 @@ public class ModelPlotsIT extends MlNativeAutodetectIntegTestCase {
     @Before
     public void setUpData() {
         client().admin().indices().prepareCreate(DATA_INDEX)
-                .addMapping(SINGLE_MAPPING_NAME, "time", "type=date,format=epoch_millis", "user", "type=keyword")
+                .setMapping("time", "type=date,format=epoch_millis", "user", "type=keyword")
                 .get();
 
         List<String> users = Arrays.asList("user_1", "user_2", "user_3");
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/OutlierDetectionWithMissingFieldsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/OutlierDetectionWithMissingFieldsIT.java
index 26ae36be99f62..e32d923852038 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/OutlierDetectionWithMissingFieldsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/OutlierDetectionWithMissingFieldsIT.java
@@ -35,7 +35,7 @@ public void testMissingFields() throws Exception {
         String sourceIndex = "test-outlier-detection-with-missing-fields";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "numeric", "type=double", "categorical", "type=keyword")
+            .setMapping("numeric", "type=double", "categorical", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
index d9ad6d1e0a32e..2d790260dac12 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
@@ -314,7 +314,7 @@ private void initialize(String jobId) {
 
     private static void indexData(String sourceIndex, int numTrainingRows, int numNonTrainingRows) {
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", NUMERICAL_FEATURE_FIELD, "type=double", DEPENDENT_VARIABLE_FIELD, "type=double")
+            .setMapping(NUMERICAL_FEATURE_FIELD, "type=double", DEPENDENT_VARIABLE_FIELD, "type=double")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk()
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RunDataFrameAnalyticsIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RunDataFrameAnalyticsIT.java
index 2628a751bc112..9b51c963f1f45 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RunDataFrameAnalyticsIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RunDataFrameAnalyticsIT.java
@@ -54,7 +54,7 @@ public void testOutlierDetectionWithFewDocuments() throws Exception {
         String sourceIndex = "test-outlier-detection-with-few-docs";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
@@ -134,7 +134,7 @@ public void testOutlierDetectionWithEnoughDocumentsToScroll() throws Exception {
         String sourceIndex = "test-outlier-detection-with-enough-docs-to-scroll";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
@@ -270,7 +270,7 @@ public void testStopOutlierDetectionWithEnoughDocumentsToScroll() throws Excepti
         String sourceIndex = "test-stop-outlier-detection-with-enough-docs-to-scroll";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
@@ -331,11 +331,11 @@ public void testOutlierDetectionWithMultipleSourceIndices() throws Exception {
         String[] sourceIndex = new String[] { sourceIndex1, sourceIndex2 };
 
         client().admin().indices().prepareCreate(sourceIndex1)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         client().admin().indices().prepareCreate(sourceIndex2)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
@@ -396,11 +396,11 @@ public void testOutlierDetectionWithPreExistingDestIndex() throws Exception {
         String destIndex = "test-outlier-detection-with-pre-existing-dest-index-results";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         client().admin().indices().prepareCreate(destIndex)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
@@ -453,7 +453,7 @@ public void testModelMemoryLimitLowerThanEstimatedMemoryUsage() throws Exception
         String sourceIndex = "test-model-memory-limit";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "col_1", "type=double", "col_2", "type=float", "col_3", "type=keyword")
+            .setMapping("col_1", "type=double", "col_2", "type=float", "col_3", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk().setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
@@ -498,7 +498,7 @@ public void testLazyAssignmentWithModelMemoryLimitTooHighForAssignment() throws
         String sourceIndex = "test-lazy-assign-model-memory-limit-too-high";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "col_1", "type=double", "col_2", "type=float", "col_3", "type=keyword")
+            .setMapping("col_1", "type=double", "col_2", "type=float", "col_3", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk().setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
@@ -552,7 +552,7 @@ public void testOutlierDetectionStopAndRestart() throws Exception {
         String sourceIndex = "test-outlier-detection-stop-and-restart";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
@@ -618,7 +618,7 @@ public void testOutlierDetectionWithCustomParams() throws Exception {
         String sourceIndex = "test-outlier-detection-with-custom-params";
 
         client().admin().indices().prepareCreate(sourceIndex)
-            .addMapping("_doc", "numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
+            .setMapping("numeric_1", "type=double", "numeric_2", "type=float", "categorical_1", "type=keyword")
             .get();
 
         BulkRequestBuilder bulkRequestBuilder = client().prepareBulk();
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/SetUpgradeModeIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/SetUpgradeModeIT.java
index f97c27e4ccca4..11fb715ff81fa 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/SetUpgradeModeIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/SetUpgradeModeIT.java
@@ -135,7 +135,7 @@ public void testEnableUpgradeMode() throws Exception {
 
     private void startRealtime(String jobId) throws Exception {
         client().admin().indices().prepareCreate("data")
-            .addMapping("type", "time", "type=date")
+            .setMapping("time", "type=date")
             .get();
         long numDocs1 = randomIntBetween(32, 2048);
         long now = System.currentTimeMillis();
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/BasicDistributedJobsIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/BasicDistributedJobsIT.java
index 1306b9b0abe51..c4faf4fc2b7bc 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/BasicDistributedJobsIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/BasicDistributedJobsIT.java
@@ -148,7 +148,7 @@ public void testJobAutoClose() throws Exception {
         internalCluster().startNode(Settings.builder().put(MachineLearning.ML_ENABLED.getKey(), true));
 
         client().admin().indices().prepareCreate("data")
-                .addMapping("type", "time", "type=date")
+                .setMapping("time", "type=date")
                 .get();
 
         IndexRequest indexRequest = new IndexRequest("data");
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
index 4cb66b44b5fd5..dcddb842d21b6 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
@@ -139,7 +139,7 @@ public void testCloseUnassignedJobAndDatafeed() throws Exception {
 
         // index some datafeed data
         client().admin().indices().prepareCreate("data")
-                .addMapping("type", "time", "type=date")
+                .setMapping("time", "type=date")
                 .get();
         long numDocs1 = randomIntBetween(32, 2048);
         long now = System.currentTimeMillis();
@@ -200,7 +200,7 @@ public void testCloseUnassignedFailedJobAndStopUnassignedStoppingDatafeed() thro
 
         // index some datafeed data
         client().admin().indices().prepareCreate("data")
-            .addMapping("type", "time", "type=date")
+            .setMapping("time", "type=date")
             .get();
         long numDocs1 = randomIntBetween(32, 2048);
         long now = System.currentTimeMillis();
@@ -293,7 +293,7 @@ public void testStopAndForceStopDatafeed() throws Exception {
 
         // index some datafeed data
         client().admin().indices().prepareCreate("data")
-            .addMapping("type", "time", "type=date")
+            .setMapping("time", "type=date")
             .get();
         long numDocs1 = randomIntBetween(32, 2048);
         long now = System.currentTimeMillis();
@@ -424,7 +424,7 @@ private void setupJobAndDatafeed(String jobId, String datafeedId, TimeValue data
 
     private void run(String jobId, CheckedRunnable<Exception> disrupt) throws Exception {
         client().admin().indices().prepareCreate("data")
-                .addMapping("type", "time", "type=date")
+                .setMapping("time", "type=date")
                 .get();
         long numDocs1 = randomIntBetween(32, 2048);
         long now = System.currentTimeMillis();
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentAndFieldLevelSecurityTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentAndFieldLevelSecurityTests.java
index da60e053f0815..f1355907c1f72 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentAndFieldLevelSecurityTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentAndFieldLevelSecurityTests.java
@@ -106,7 +106,7 @@ public Settings nodeSettings(int nodeOrdinal) {
 
     public void testSimpleQuery() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "id", "type=keyword", "field1", "type=text", "field2", "type=text")
+                        .setMapping("id", "type=keyword", "field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("id", "1", "field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -146,7 +146,7 @@ public void testSimpleQuery() {
 
     public void testDLSIsAppliedBeforeFLS() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1", "field2", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -174,7 +174,7 @@ public void testDLSIsAppliedBeforeFLS() {
     public void testQueryCache() {
         assertAcked(client().admin().indices().prepareCreate("test")
                         .setSettings(Settings.builder().put(IndexModule.INDEX_QUERY_CACHE_EVERYTHING_SETTING.getKey(), true))
-                        .addMapping("type1", "id", "type=keyword", "field1", "type=text", "field2", "type=text")
+                        .setMapping("id", "type=keyword", "field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("id", "1", "field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -235,7 +235,7 @@ public void testQueryCache() {
 
     public void testGetMappingsIsFiltered() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -275,7 +275,7 @@ public void testGetMappingsIsFiltered() {
 
     public void testGetIndexMappingsIsFiltered() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -312,7 +312,7 @@ public void testGetIndexMappingsIsFiltered() {
 
     public void testGetFieldMappingsIsFiltered() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -365,7 +365,7 @@ public void testGetFieldMappingsIsFiltered() {
 
     public void testFieldCapabilitiesIsFiltered() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityRandomTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityRandomTests.java
index 6f12634d58586..2ff4e918f8e1e 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityRandomTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityRandomTests.java
@@ -91,7 +91,7 @@ public Settings nodeSettings(int nodeOrdinal) {
 
     public void testDuelWithAliasFilters() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text")
         );
 
         List<IndexRequestBuilder> requests = new ArrayList<>(numberOfRoles);
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityTests.java
index 1e255ee5ee495..72d09aec8a140 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/DocumentLevelSecurityTests.java
@@ -149,7 +149,7 @@ public Settings nodeSettings(int nodeOrdinal) {
 
     public void testSimpleQuery() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -190,7 +190,7 @@ public void testSimpleQuery() throws Exception {
 
     public void testGetApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
 
         client().prepareIndex("test").setId("1").setSource("field1", "value1").get();
@@ -255,7 +255,7 @@ public void testGetApi() throws Exception {
 
     public void testMGetApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
 
         client().prepareIndex("test").setId("1").setSource("field1", "value1").get();
@@ -328,10 +328,10 @@ public void testMGetApi() throws Exception {
 
     public void testMSearch() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test1")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text", "id", "type=integer")
+                .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text", "id", "type=integer")
         );
         assertAcked(client().admin().indices().prepareCreate("test2")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text", "id", "type=integer")
+                .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text", "id", "type=integer")
         );
 
         client().prepareIndex("test1").setId("1").setSource("field1", "value1", "id", 1).get();
@@ -407,7 +407,7 @@ public void testMSearch() throws Exception {
 
     public void testTVApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text,term_vector=with_positions_offsets_payloads",
+                        .setMapping("field1", "type=text,term_vector=with_positions_offsets_payloads",
                                 "field2", "type=text,term_vector=with_positions_offsets_payloads",
                                 "field3", "type=text,term_vector=with_positions_offsets_payloads")
         );
@@ -472,7 +472,7 @@ public void testTVApi() throws Exception {
 
     public void testMTVApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text,term_vector=with_positions_offsets_payloads",
+                        .setMapping("field1", "type=text,term_vector=with_positions_offsets_payloads",
                                 "field2", "type=text,term_vector=with_positions_offsets_payloads",
                                 "field3", "type=text,term_vector=with_positions_offsets_payloads")
         );
@@ -538,7 +538,7 @@ public void testMTVApi() throws Exception {
 
     public void testGlobalAggregation() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text,fielddata=true", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text,fielddata=true", "field3", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -709,7 +709,7 @@ private void verifyParentChild() {
     public void testScroll() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
                 .setSettings(Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true))
-                .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
         final int numVisible = scaledRandomIntBetween(2, 10);
         final int numInVisible = scaledRandomIntBetween(2, 10);
@@ -762,7 +762,7 @@ public void testScroll() throws Exception {
     public void testRequestCache() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
                 .setSettings(Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true))
-                .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1")
                 .get();
@@ -805,7 +805,7 @@ public void testRequestCache() throws Exception {
 
     public void testUpdateApiIsBlocked() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type", "field1", "type=text", "field2", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1")
                 .setRefreshPolicy(IMMEDIATE)
@@ -853,7 +853,7 @@ public void testUpdateApiIsBlocked() throws Exception {
 
     public void testNestedInnerHits() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                .addMapping("type1", "field1", "type=text", "nested_field", "type=nested")
+                .setMapping("field1", "type=text", "nested_field", "type=nested")
         );
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject()
@@ -903,7 +903,7 @@ public void testSuggesters() throws Exception {
                         .put("index.number_of_shards", 1)
                         .put("index.number_of_replicas", 0)
                 )
-                .addMapping("type1", "field1", "type=text", "suggest_field1", "type=text", "suggest_field2", "type=completion")
+                .setMapping("field1", "type=text", "suggest_field1", "type=text", "suggest_field2", "type=completion")
         );
 
         client().prepareIndex("test").setId("1")
@@ -1001,7 +1001,7 @@ public void testProfile() throws Exception {
                         .put("index.number_of_shards", 1)
                         .put("index.number_of_replicas", 0)
                 )
-                .addMapping("type1", "field1", "type=text", "other_field", "type=text")
+                .setMapping("field1", "type=text", "other_field", "type=text")
         );
 
         client().prepareIndex("test").setId("1")
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityRandomTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityRandomTests.java
index a802c97a4647f..041de70e07229 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityRandomTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityRandomTests.java
@@ -141,7 +141,7 @@ public void testRandom() throws Exception {
             doc.put(field, "value");
         }
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", (Object[])fieldMappers)
+                        .setMapping((Object[])fieldMappers)
         );
         client().prepareIndex("test").setId("1").setSource(doc).setRefreshPolicy(IMMEDIATE).get();
 
@@ -167,7 +167,7 @@ public void testRandom() throws Exception {
 
     public void testDuel() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "id", "type=keyword", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("id", "type=keyword", "field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
 
         int numDocs = scaledRandomIntBetween(32, 128);
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityTests.java
index bb6bb7cded759..a4fe2e9a2cee0 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityTests.java
@@ -156,7 +156,7 @@ public Settings nodeSettings(int nodeOrdinal) {
     }
 
     public void testQuery() {
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1",
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(
             "field1", "type=text",
             "field2", "type=text",
             "field3", "type=text",
@@ -313,7 +313,7 @@ public void testQuery() {
 
     public void testGetApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
 
         client().prepareIndex("test").setId("1").setSource("field1", "value1", "field2", "value2", "field3", "value3")
@@ -411,7 +411,7 @@ public void testGetApi() throws Exception {
 
     public void testMGetApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1", "field2", "value2", "field3", "value3").get();
 
@@ -523,10 +523,10 @@ public void testMGetApi() throws Exception {
 
     public void testMSearchApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test1")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
         assertAcked(client().admin().indices().prepareCreate("test2")
-                .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
 
         client().prepareIndex("test1").setId("1")
@@ -673,7 +673,7 @@ public void testMSearchApi() throws Exception {
     public void testScroll() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
                 .setSettings(Settings.builder().put(IndexModule.INDEX_QUERY_CACHE_EVERYTHING_SETTING.getKey(), true))
-                .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
 
         final int numDocs = scaledRandomIntBetween(2, 10);
@@ -725,7 +725,7 @@ public void testScroll() throws Exception {
     public void testQueryCache() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
                         .setSettings(Settings.builder().put(IndexModule.INDEX_QUERY_CACHE_EVERYTHING_SETTING.getKey(), true))
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1", "field2", "value2", "field3", "value3")
                 .setRefreshPolicy(IMMEDIATE)
@@ -763,7 +763,7 @@ public void testQueryCache() throws Exception {
     public void testRequestCache() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
                         .setSettings(Settings.builder().put(IndicesRequestCache.INDEX_CACHE_REQUEST_ENABLED_SETTING.getKey(), true))
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1", "field2", "value2")
                 .setRefreshPolicy(IMMEDIATE)
@@ -803,7 +803,7 @@ public void testRequestCache() throws Exception {
     }
 
     public void testFields() throws Exception {
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1",
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(
             "field1", "type=text,store=true",
             "field2", "type=text,store=true",
             "field3", "type=text,store=true",
@@ -919,7 +919,7 @@ public void testFields() throws Exception {
 
     public void testSource() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text", "field3", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text", "field3", "type=text")
         );
         client().prepareIndex("test").setId("1").setSource("field1", "value1", "field2", "value2", "field3", "value3")
                 .setRefreshPolicy(IMMEDIATE)
@@ -991,7 +991,7 @@ public void testSource() throws Exception {
     }
 
     public void testSort() {
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1",
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(
             "field1", "type=long",
             "field2", "type=long",
             "alias", "type=alias,path=field1"));
@@ -1045,7 +1045,7 @@ public void testSort() {
     }
 
      public void testHighlighting() {
-         assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1",
+         assertAcked(client().admin().indices().prepareCreate("test").setMapping(
              "field1", "type=text",
              "field2", "type=text",
              "field3", "type=text",
@@ -1098,7 +1098,7 @@ public void testHighlighting() {
      }
 
     public void testAggs() {
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1",
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(
             "field1", "type=text,fielddata=true",
             "field2", "type=text,fielddata=true",
             "alias", "type=alias,path=field1"));
@@ -1153,7 +1153,7 @@ public void testAggs() {
 
     public void testTVApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text,term_vector=with_positions_offsets_payloads",
+                        .setMapping("field1", "type=text,term_vector=with_positions_offsets_payloads",
                                 "field2", "type=text,term_vector=with_positions_offsets_payloads",
                                 "field3", "type=text,term_vector=with_positions_offsets_payloads")
         );
@@ -1237,7 +1237,7 @@ public void testTVApi() throws Exception {
 
     public void testMTVApi() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text,term_vector=with_positions_offsets_payloads",
+                        .setMapping("field1", "type=text,term_vector=with_positions_offsets_payloads",
                                 "field2", "type=text,term_vector=with_positions_offsets_payloads",
                                 "field3", "type=text,term_vector=with_positions_offsets_payloads")
         );
@@ -1403,7 +1403,7 @@ private void verifyParentChild() {
 
     public void testUpdateApiIsBlocked() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type", "field1", "type=text", "field2", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text")
         );
         client().prepareIndex("test").setId("1")
                 .setSource("field1", "value1", "field2", "value1")
@@ -1452,7 +1452,7 @@ public void testUpdateApiIsBlocked() throws Exception {
 
     public void testQuery_withRoleWithFieldWildcards() {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text"));
+                        .setMapping("field1", "type=text", "field2", "type=text"));
         client().prepareIndex("test").setId("1").setSource("field1", "value1", "field2", "value2")
                 .setRefreshPolicy(IMMEDIATE)
                 .get();
@@ -1479,7 +1479,7 @@ public void testQuery_withRoleWithFieldWildcards() {
     }
 
     public void testExistQuery() {
-        assertAcked(client().admin().indices().prepareCreate("test").addMapping("type1",
+        assertAcked(client().admin().indices().prepareCreate("test").setMapping(
             "field1", "type=text",
             "field2", "type=text",
             "field3", "type=text",
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/IndicesPermissionsWithAliasesWildcardsAndRegexsTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/IndicesPermissionsWithAliasesWildcardsAndRegexsTests.java
index f9506e07e1128..de86290cbb515 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/IndicesPermissionsWithAliasesWildcardsAndRegexsTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/IndicesPermissionsWithAliasesWildcardsAndRegexsTests.java
@@ -67,7 +67,7 @@ public Settings nodeSettings(int nodeOrdinal) {
 
     public void testResolveWildcardsRegexs() throws Exception {
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .addMapping("type1", "field1", "type=text", "field2", "type=text")
+                        .setMapping("field1", "type=text", "field2", "type=text")
                         .addAlias(new Alias("my_alias"))
                         .addAlias(new Alias("an_alias"))
         );
diff --git a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
index a9f491d29918e..7f36cd6d2c82d 100644
--- a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
+++ b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/search/ShapeQueryTests.java
@@ -47,7 +47,6 @@ public class ShapeQueryTests extends ESSingleNodeTestCase {
 
     private static String INDEX = "test";
     private static String IGNORE_MALFORMED_INDEX = INDEX + "_ignore_malformed";
-    private static String FIELD_TYPE = "geometry";
     private static String FIELD = "shape";
     private static Geometry queryGeometry = null;
 
@@ -59,10 +58,10 @@ public void setUp() throws Exception {
 
         // create test index
         assertAcked(client().admin().indices().prepareCreate(INDEX)
-            .addMapping(FIELD_TYPE, FIELD, "type=shape", "alias", "type=alias,path=" + FIELD).get());
+            .setMapping(FIELD, "type=shape", "alias", "type=alias,path=" + FIELD).get());
         // create index that ignores malformed geometry
         assertAcked(client().admin().indices().prepareCreate(IGNORE_MALFORMED_INDEX)
-            .addMapping(FIELD_TYPE, FIELD, "type=shape,ignore_malformed=true", "_source", "enabled=false").get());
+            .setMapping(FIELD, "type=shape,ignore_malformed=true", "_source", "enabled=false").get());
         ensureGreen();
 
         // index random shapes
@@ -109,7 +108,7 @@ public void testShapeFetchingPath() throws Exception {
         String indexName = "shapes_index";
         String searchIndex = "search_index";
         createIndex(indexName);
-        client().admin().indices().prepareCreate(searchIndex).addMapping("type", "location", "type=shape").get();
+        client().admin().indices().prepareCreate(searchIndex).setMapping("location", "type=shape").get();
 
         String location = "\"location\" : {\"type\":\"polygon\", \"coordinates\":[[[-10,-10],[10,-10],[10,10],[-10,10],[-10,-10]]]}";
 
@@ -247,7 +246,7 @@ public void testFieldAlias() {
 
     public void testContainsShapeQuery() {
 
-        client().admin().indices().prepareCreate("test_contains").addMapping("type", "location", "type=shape")
+        client().admin().indices().prepareCreate("test_contains").setMapping("location", "type=shape")
             .execute().actionGet();
 
         String doc = "{\"location\" : {\"type\":\"envelope\", \"coordinates\":[ [-100.0, 100.0], [100.0, -100.0]]}}";
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/condition/ArrayCompareConditionSearchTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/condition/ArrayCompareConditionSearchTests.java
index 46f5f3d899622..adc0e5a6df220 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/condition/ArrayCompareConditionSearchTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/condition/ArrayCompareConditionSearchTests.java
@@ -30,9 +30,7 @@ public class ArrayCompareConditionSearchTests extends AbstractWatcherIntegration
 
     public void testExecuteWithAggs() throws Exception {
         String index = "test-index";
-        String type = "test-type";
         client().admin().indices().prepareCreate(index)
-                .addMapping(type)
                 .get();
 
         ArrayCompareCondition.Op op = randomFrom(ArrayCompareCondition.Op.values());
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/integration/BasicWatcherTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/integration/BasicWatcherTests.java
index 4ed83dfac5c5f..9b401a57c5f44 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/integration/BasicWatcherTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/integration/BasicWatcherTests.java
@@ -336,7 +336,7 @@ private void testConditionSearch(WatcherSearchTemplateRequest request) throws Ex
         timeWarp().clock().setTime(ZonedDateTime.now(Clock.systemUTC()));
 
         String watchName = "_name";
-        assertAcked(prepareCreate("events").addMapping("event", "level", "type=text"));
+        assertAcked(prepareCreate("events").setMapping("level", "type=text"));
 
         new PutWatchRequestBuilder(client()).setId(watchName)
                 .setSource(watchBuilder()

From 5b7f001f8b45852af6533cddd62ee5d9d7cc7e0a Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Thu, 9 Jan 2020 08:12:53 -0800
Subject: [PATCH 483/686] [DOCS] Clarify detector_index property in ML APIs
 (#50723)

---
 docs/build.gradle                             |  1 +
 .../anomaly-detection/apis/put-job.asciidoc   |  4 +
 .../apis/update-job.asciidoc                  | 89 +++++++------------
 docs/reference/ml/ml-shared.asciidoc          |  3 +-
 4 files changed, 38 insertions(+), 59 deletions(-)

diff --git a/docs/build.gradle b/docs/build.gradle
index 80e1d49972e9f..73553be6104fc 100644
--- a/docs/build.gradle
+++ b/docs/build.gradle
@@ -36,6 +36,7 @@ buildRestTests.expectedUnconvertedCandidates = [
   'reference/ml/anomaly-detection/apis/post-data.asciidoc',
   'reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc',
   'reference/ml/anomaly-detection/apis/update-snapshot.asciidoc',
+  'reference/ml/anomaly-detection/apis/update-job.asciidoc'
 ]
 
 testClusters.integTest {
diff --git a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
index 1c4e59e1341be..a4661a19c435d 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
@@ -122,8 +122,12 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
 include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
 
 `analysis_config`.`detectors`.`detector_index`::::
++
+--
 (integer)
 include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+If you specify a value for this property, it is ignored.
+--
 
 `analysis_config`.`detectors`.`exclude_frequent`::::
 (string)
diff --git a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
index 1fd3a6e620379..ba8182cee6237 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
@@ -120,9 +120,15 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
 `detectors`.`description`:::
 (string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
+
 `detectors`.`detector_index`:::
++
+--
 (integer)
 include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+If you want to update a specific detector, you must use this identifier. You
+cannot, however, change the `detector_index` value for a detector.
+--
 
 `groups`::
 (array of strings)
@@ -164,83 +170,52 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=results-retention-days]
 
 [source,console]
 --------------------------------------------------
-POST _ml/anomaly_detectors/total-requests/_update
+POST _ml/anomaly_detectors/low_request_rate/_update
 {
   "description":"An updated job",
-  "groups": ["group1","group2"],
+  "detectors": {
+    "detector_index": 0,
+    "description": "An updated detector description"
+  },
+  "groups": ["kibana_sample_data","kibana_sample_web_logs"],
   "model_plot_config": {
     "enabled": true
   },
-  "analysis_limits": {
-    "model_memory_limit": "1024mb"
-  },
   "renormalization_window_days": 30,
   "background_persist_interval": "2h",
   "model_snapshot_retention_days": 7,
-  "results_retention_days": 60,
-  "custom_settings": {
-    "custom_urls" : [{
-      "url_name" : "Lookup IP",
-      "url_value" : "http://geoiplookup.net/ip/$clientip$"
-    }]
-  }
+  "results_retention_days": 60
 }
 --------------------------------------------------
-// TEST[skip:setup:server_metrics_job]
+// TEST[skip:setup:Kibana sample data]
 
 When the {anomaly-job} is updated, you receive a summary of the job
 configuration information, including the updated property values. For example:
 
-[source,console-result]
+[source,js]
 ----
 {
-  "job_id": "total-requests",
-  "job_type": "anomaly_detector",
-  "job_version": "7.0.0-alpha1",
-  "groups": [
-    "group1",
-    "group2"
+  "job_id" : "low_request_rate",
+  "job_type" : "anomaly_detector",
+  "job_version" : "8.0.0",
+  "groups" : [
+    "kibana_sample_data",
+    "kibana_sample_web_logs"
   ],
-  "description": "An updated job",
-  "create_time": 1518808660505,
-  "analysis_config": {
-    "bucket_span": "10m",
-    "detectors": [
+  "description" : "An updated job",
+  "create_time" : 1576623023709,
+  "analysis_config" : {
+    "bucket_span" : "1h",
+    "summary_count_field_name" : "doc_count",
+    "detectors" : [
       {
-        "detector_description": "Sum of total",
-        "function": "sum",
-        "field_name": "total",
-        "detector_index": 0
+        "detector_description" : "An updated detector description",
+        "function" : "low_count",
+        "detector_index" : 0
       }
     ],
-    "influencers": []
-  },
-  "analysis_limits": {
-    "model_memory_limit": "1024mb",
-    "categorization_examples_limit": 4
-  },
-  "data_description": {
-    "time_field": "timestamp",
-    "time_format": "epoch_ms"
-  },
-  "model_plot_config": {
-    "enabled": true
-  },
-  "renormalization_window_days": 30,
-  "background_persist_interval": "2h",
-  "model_snapshot_retention_days": 7,
-  "results_retention_days": 60,
-  "custom_settings": {
-    "custom_urls": [
-      {
-        "url_name": "Lookup IP",
-        "url_value": "http://geoiplookup.net/ip/$clientip$"
-      }
-    ]
+    "influencers" : [ ]
   },
-  "results_index_name": "shared",
-  "allow_lazy_open": false
+  ...
 }
 ----
-// TESTRESPONSE[s/"job_version": "7.0.0-alpha1"/"job_version": $body.job_version/]
-// TESTRESPONSE[s/"create_time": 1518808660505/"create_time": $body.create_time/]
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 767bd134a0967..5454939af1e24 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -532,8 +532,7 @@ end::detector-field-name[]
 
 tag::detector-index[]
 A unique identifier for the detector. This identifier is based on the order of 
-the detectors in the `analysis_config`, starting at zero. You can use this 
-identifier when you want to update a specific detector.
+the detectors in the `analysis_config`, starting at zero.
 end::detector-index[]
 
 tag::eta[]

From 10ebe8ccdf6ebe0bdbe5a12b2c1f36c64357cc07 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Thu, 9 Jan 2020 13:19:02 -0500
Subject: [PATCH 484/686] Move scripted metric to ObjectParser (#50708)

This replaces the hand rolled parsing code for scripted metric with
`ObjectParser` which is simpler to work with because it is declarative.
---
 .../java/org/elasticsearch/script/Script.java | 17 +++-
 .../elasticsearch/search/SearchModule.java    |  2 +-
 .../ScriptedMetricAggregationBuilder.java     | 77 +++++--------------
 3 files changed, 32 insertions(+), 64 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/script/Script.java b/server/src/main/java/org/elasticsearch/script/Script.java
index dc5dd600ba2d3..a4b2dfb8b29a6 100644
--- a/server/src/main/java/org/elasticsearch/script/Script.java
+++ b/server/src/main/java/org/elasticsearch/script/Script.java
@@ -50,8 +50,6 @@
 import java.util.Objects;
 import java.util.function.BiConsumer;
 
-import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
-
 /**
  * {@link Script} represents used-defined input that can be used to
  * compile and execute a script from the {@link ScriptService}
@@ -274,13 +272,24 @@ private Script build(String defaultLang) {
     }
 
     /**
-     * Declare a script field on an {@link ObjectParser}.
+     * Declare a script field on an {@link ObjectParser} with the standard name ({@code script}).
      * @param <T> Whatever type the {@linkplain ObjectParser} is parsing.
      * @param parser the parser itself
      * @param consumer the consumer for the script
      */
     public static <T> void declareScript(AbstractObjectParser<T, ?> parser, BiConsumer<T, Script> consumer) {
-        parser.declareField(constructorArg(), (p, c) -> Script.parse(p), Script.SCRIPT_PARSE_FIELD, ValueType.OBJECT_OR_STRING);
+        declareScript(parser, consumer, Script.SCRIPT_PARSE_FIELD);
+    }
+
+    /**
+     * Declare a script field on an {@link ObjectParser}.
+     * @param <T> Whatever type the {@linkplain ObjectParser} is parsing.
+     * @param parser the parser itself
+     * @param consumer the consumer for the script
+     * @param parseField the field name
+     */
+    public static <T> void declareScript(AbstractObjectParser<T, ?> parser, BiConsumer<T, Script> consumer, ParseField parseField) {
+        parser.declareField(consumer, (p, c) -> Script.parse(p), parseField, ValueType.OBJECT_OR_STRING);
     }
 
     /**
diff --git a/server/src/main/java/org/elasticsearch/search/SearchModule.java b/server/src/main/java/org/elasticsearch/search/SearchModule.java
index 44886f947cd4a..a0749332bf27b 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchModule.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchModule.java
@@ -422,7 +422,7 @@ private void registerAggregations(List<SearchPlugin> plugins) {
         registerAggregation(new AggregationSpec(GeoCentroidAggregationBuilder.NAME, GeoCentroidAggregationBuilder::new,
                 GeoCentroidAggregationBuilder::parse).addResultReader(InternalGeoCentroid::new));
         registerAggregation(new AggregationSpec(ScriptedMetricAggregationBuilder.NAME, ScriptedMetricAggregationBuilder::new,
-                ScriptedMetricAggregationBuilder::parse).addResultReader(InternalScriptedMetric::new));
+                (name, p) -> ScriptedMetricAggregationBuilder.PARSER.parse(p, name)).addResultReader(InternalScriptedMetric::new));
         registerAggregation((new AggregationSpec(CompositeAggregationBuilder.NAME, CompositeAggregationBuilder::new,
             CompositeAggregationBuilder::parse).addResultReader(InternalComposite::new)));
         registerFromPlugin(plugins, SearchPlugin::getAggregations, this::registerAggregation);
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricAggregationBuilder.java
index accee6fcb5250..f8ec27a7d6b16 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/metrics/ScriptedMetricAggregationBuilder.java
@@ -20,14 +20,13 @@
 package org.elasticsearch.search.aggregations.metrics;
 
 import org.elasticsearch.common.ParseField;
-import org.elasticsearch.common.ParsingException;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.QueryShardContext;
-import org.elasticsearch.script.ScriptedMetricAggContexts;
 import org.elasticsearch.script.Script;
+import org.elasticsearch.script.ScriptedMetricAggContexts;
 import org.elasticsearch.search.aggregations.AbstractAggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregatorFactories.Builder;
@@ -38,6 +37,8 @@
 import java.util.Map;
 import java.util.Objects;
 
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
 public class ScriptedMetricAggregationBuilder extends AbstractAggregationBuilder<ScriptedMetricAggregationBuilder> {
     public static final String NAME = "scripted_metric";
 
@@ -47,6 +48,20 @@ public class ScriptedMetricAggregationBuilder extends AbstractAggregationBuilder
     private static final ParseField REDUCE_SCRIPT_FIELD = new ParseField("reduce_script");
     private static final ParseField PARAMS_FIELD = new ParseField("params");
 
+    public static final ConstructingObjectParser<ScriptedMetricAggregationBuilder, String> PARSER =
+            new ConstructingObjectParser<>(NAME, false, (args, name) -> {
+                ScriptedMetricAggregationBuilder builder = new ScriptedMetricAggregationBuilder(name);
+                builder.mapScript((Script) args[0]);
+                return builder;
+            });
+    static {
+        Script.declareScript(PARSER, ScriptedMetricAggregationBuilder::initScript, INIT_SCRIPT_FIELD);
+        Script.declareScript(PARSER, constructorArg(), MAP_SCRIPT_FIELD);
+        Script.declareScript(PARSER, ScriptedMetricAggregationBuilder::combineScript, COMBINE_SCRIPT_FIELD);
+        Script.declareScript(PARSER, ScriptedMetricAggregationBuilder::reduceScript, REDUCE_SCRIPT_FIELD);
+        PARSER.declareObject(ScriptedMetricAggregationBuilder::params, (p, name) -> p.map(), PARAMS_FIELD);
+    }
+
     private Script initScript;
     private Script mapScript;
     private Script combineScript;
@@ -260,62 +275,6 @@ protected XContentBuilder internalXContent(XContentBuilder builder, Params build
         return builder;
     }
 
-    public static ScriptedMetricAggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
-        Script initScript = null;
-        Script mapScript = null;
-        Script combineScript = null;
-        Script reduceScript = null;
-        Map<String, Object> params = null;
-        XContentParser.Token token;
-        String currentFieldName = null;
-
-        while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {
-            if (token == XContentParser.Token.FIELD_NAME) {
-                currentFieldName = parser.currentName();
-            } else if (token == XContentParser.Token.START_OBJECT || token == XContentParser.Token.VALUE_STRING) {
-                if (INIT_SCRIPT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    initScript = Script.parse(parser);
-                } else if (MAP_SCRIPT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    mapScript = Script.parse(parser);
-                } else if (COMBINE_SCRIPT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    combineScript = Script.parse(parser);
-                } else if (REDUCE_SCRIPT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    reduceScript = Script.parse(parser);
-                } else if (token == XContentParser.Token.START_OBJECT &&
-                        PARAMS_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    params = parser.map();
-                } else {
-                    throw new ParsingException(parser.getTokenLocation(),
-                            "Unknown key for a " + token + " in [" + aggregationName + "]: [" + currentFieldName + "].");
-                }
-            } else {
-                throw new ParsingException(parser.getTokenLocation(), "Unexpected token " + token + " in [" + aggregationName + "].");
-            }
-        }
-
-        if (mapScript == null) {
-            throw new ParsingException(parser.getTokenLocation(), "map_script field is required in [" + aggregationName + "].");
-        }
-
-        ScriptedMetricAggregationBuilder factory = new ScriptedMetricAggregationBuilder(aggregationName);
-        if (initScript != null) {
-            factory.initScript(initScript);
-        }
-        if (mapScript != null) {
-            factory.mapScript(mapScript);
-        }
-        if (combineScript != null) {
-            factory.combineScript(combineScript);
-        }
-        if (reduceScript != null) {
-            factory.reduceScript(reduceScript);
-        }
-        if (params != null) {
-            factory.params(params);
-        }
-        return factory;
-    }
-
     @Override
     public String getType() {
         return NAME;

From a357a0e8fcf7efad05d152932b4dbffd54b0d22e Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Thu, 9 Jan 2020 13:32:46 -0500
Subject: [PATCH 485/686] Drop "funny" functions building parsers (#50715)

Replaces the "funny"
`Function<String, ConstructingObjectParser<T, Void>>` with a much
simpler `ConstructingObjectParser<T, String>`. This makes pretty much
all of our object parsers static.
---
 .../client/rollup/GetRollupCapsResponse.java  |  2 +-
 .../rollup/GetRollupIndexCapsResponse.java    |  2 +-
 .../client/rollup/RollableIndexCaps.java      | 22 ++++-----
 .../elasticsearch/search/SearchModule.java    | 12 ++---
 .../CompositeAggregationBuilder.java          | 34 +++++---------
 ...ucketScriptPipelineAggregationBuilder.java | 39 ++++++---------
 .../MovFnPipelineAggregationBuilder.java      | 34 +++++---------
 .../aggregations/pipeline/BucketScriptIT.java |  6 +--
 .../pipeline/BucketScriptTests.java           |  9 ++--
 .../xpack/analytics/AnalyticsPlugin.java      |  2 +-
 ...CardinalityPipelineAggregationBuilder.java | 47 ++++++++-----------
 .../transform/transforms/pivot/Pivot.java     |  2 +-
 12 files changed, 88 insertions(+), 123 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/GetRollupCapsResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/GetRollupCapsResponse.java
index f4c516d015d78..63ad2e281e7e4 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/GetRollupCapsResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/GetRollupCapsResponse.java
@@ -46,7 +46,7 @@ public static GetRollupCapsResponse fromXContent(final XContentParser parser) th
                 if (token.equals(XContentParser.Token.FIELD_NAME)) {
                     String pattern = parser.currentName();
 
-                    RollableIndexCaps cap = RollableIndexCaps.PARSER.apply(pattern).apply(parser, null);
+                    RollableIndexCaps cap = RollableIndexCaps.PARSER.parse(parser, pattern);
                     jobs.put(pattern, cap);
                 }
             }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/GetRollupIndexCapsResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/GetRollupIndexCapsResponse.java
index 831e10f174794..3f489afb2d171 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/GetRollupIndexCapsResponse.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/GetRollupIndexCapsResponse.java
@@ -46,7 +46,7 @@ public static GetRollupIndexCapsResponse fromXContent(final XContentParser parse
                 if (token.equals(XContentParser.Token.FIELD_NAME)) {
                     String pattern = parser.currentName();
 
-                    RollableIndexCaps cap = RollableIndexCaps.PARSER.apply(pattern).apply(parser, null);
+                    RollableIndexCaps cap = RollableIndexCaps.PARSER.apply(parser, pattern);
                     jobs.put(pattern, cap);
                 }
             }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/RollableIndexCaps.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/RollableIndexCaps.java
index 8e0bea0996bbd..48967b1195b2f 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/RollableIndexCaps.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/rollup/RollableIndexCaps.java
@@ -28,9 +28,10 @@
 import java.util.Comparator;
 import java.util.List;
 import java.util.Objects;
-import java.util.function.Function;
 import java.util.stream.Collectors;
 
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
+
 /**
  * Represents the rollup capabilities of a non-rollup index.  E.g. what values/aggregations
  * were rolled up for this index, in what rollup jobs that data is stored and where those
@@ -41,16 +42,15 @@
 public class RollableIndexCaps implements ToXContentFragment {
     private static final ParseField ROLLUP_JOBS = new ParseField("rollup_jobs");
 
-    public static final Function<String, ConstructingObjectParser<RollableIndexCaps, Void>> PARSER = indexName -> {
-        @SuppressWarnings("unchecked")
-        ConstructingObjectParser<RollableIndexCaps, Void> p
-            = new ConstructingObjectParser<>(indexName, true,
-            a -> new RollableIndexCaps(indexName, (List<RollupJobCaps>) a[0]));
-
-        p.declareObjectArray(ConstructingObjectParser.constructorArg(), RollupJobCaps.PARSER::apply,
-            ROLLUP_JOBS);
-        return p;
-    };
+    public static final ConstructingObjectParser<RollableIndexCaps, String> PARSER = new ConstructingObjectParser<>(
+            ROLLUP_JOBS.getPreferredName(), true, (Object[] args, String indexName) -> {
+                @SuppressWarnings("unchecked")
+                var caps = (List<RollupJobCaps>) args[0];
+                return new RollableIndexCaps(indexName, caps);
+            });
+    static {
+        PARSER.declareObjectArray(constructorArg(), (p, name) -> RollupJobCaps.PARSER.parse(p, null), ROLLUP_JOBS);
+    }
 
     private final String indexName;
     private final List<RollupJobCaps> jobCaps;
diff --git a/server/src/main/java/org/elasticsearch/search/SearchModule.java b/server/src/main/java/org/elasticsearch/search/SearchModule.java
index a0749332bf27b..089132a6ef744 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchModule.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchModule.java
@@ -424,7 +424,7 @@ private void registerAggregations(List<SearchPlugin> plugins) {
         registerAggregation(new AggregationSpec(ScriptedMetricAggregationBuilder.NAME, ScriptedMetricAggregationBuilder::new,
                 (name, p) -> ScriptedMetricAggregationBuilder.PARSER.parse(p, name)).addResultReader(InternalScriptedMetric::new));
         registerAggregation((new AggregationSpec(CompositeAggregationBuilder.NAME, CompositeAggregationBuilder::new,
-            CompositeAggregationBuilder::parse).addResultReader(InternalComposite::new)));
+                (name, p) -> CompositeAggregationBuilder.PARSER.parse(p, name)).addResultReader(InternalComposite::new)));
         registerFromPlugin(plugins, SearchPlugin::getAggregations, this::registerAggregation);
     }
 
@@ -502,7 +502,7 @@ private void registerPipelineAggregations(List<SearchPlugin> plugins) {
                 BucketScriptPipelineAggregationBuilder.NAME,
                 BucketScriptPipelineAggregationBuilder::new,
                 BucketScriptPipelineAggregator::new,
-                BucketScriptPipelineAggregationBuilder::parse));
+                (name, p) -> BucketScriptPipelineAggregationBuilder.PARSER.parse(p, name)));
         registerPipelineAggregation(new PipelineAggregationSpec(
                 BucketSelectorPipelineAggregationBuilder.NAME,
                 BucketSelectorPipelineAggregationBuilder::new,
@@ -519,10 +519,10 @@ private void registerPipelineAggregations(List<SearchPlugin> plugins) {
                 SerialDiffPipelineAggregator::new,
                 SerialDiffPipelineAggregationBuilder::parse));
         registerPipelineAggregation(new PipelineAggregationSpec(
-            MovFnPipelineAggregationBuilder.NAME,
-            MovFnPipelineAggregationBuilder::new,
-            MovFnPipelineAggregator::new,
-            MovFnPipelineAggregationBuilder::parse));
+                MovFnPipelineAggregationBuilder.NAME,
+                MovFnPipelineAggregationBuilder::new,
+                MovFnPipelineAggregator::new,
+                (name, p) -> MovFnPipelineAggregationBuilder.PARSER.parse(p, name)));
 
         registerFromPlugin(plugins, SearchPlugin::getPipelineAggregations, this::registerPipelineAggregation);
     }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilder.java
index 243d1057bbf4a..c79cb3d05d498 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilder.java
@@ -24,7 +24,6 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.QueryShardContext;
 import org.elasticsearch.search.aggregations.AbstractAggregationBuilder;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
@@ -39,7 +38,8 @@
 import java.util.Map;
 import java.util.Objects;
 import java.util.Set;
-import java.util.function.Function;
+
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 
 public class CompositeAggregationBuilder extends AbstractAggregationBuilder<CompositeAggregationBuilder> {
     public static final String NAME = "composite";
@@ -48,27 +48,17 @@ public class CompositeAggregationBuilder extends AbstractAggregationBuilder<Comp
     public static final ParseField SIZE_FIELD_NAME = new ParseField("size");
     public static final ParseField SOURCES_FIELD_NAME = new ParseField("sources");
 
-    private static final Function<String, ConstructingObjectParser<CompositeAggregationBuilder, Void>> PARSER = name -> {
-        @SuppressWarnings("unchecked")
-        ConstructingObjectParser<CompositeAggregationBuilder, Void> parser = new ConstructingObjectParser<>(NAME, a -> {
-            CompositeAggregationBuilder builder = new CompositeAggregationBuilder(name, (List<CompositeValuesSourceBuilder<?>>)a[0]);
-            if (a[1] != null) {
-                builder.size((Integer)a[1]);
-            }
-            if (a[2] != null) {
-                builder.aggregateAfter((Map<String, Object>)a[2]);
-            }
-            return builder;
-        });
-        parser.declareObjectArray(ConstructingObjectParser.constructorArg(),
+    public static final ConstructingObjectParser<CompositeAggregationBuilder, String> PARSER = new ConstructingObjectParser<>(
+            NAME, false, (args, name) -> {
+                @SuppressWarnings("unchecked")
+                List<CompositeValuesSourceBuilder<?>> sources = (List<CompositeValuesSourceBuilder<?>>) args[0];
+                return new CompositeAggregationBuilder(name, sources);
+            });
+    static {
+        PARSER.declareObjectArray(constructorArg(),
             (p, c) -> CompositeValuesSourceParserHelper.fromXContent(p), SOURCES_FIELD_NAME);
-        parser.declareInt(ConstructingObjectParser.optionalConstructorArg(), SIZE_FIELD_NAME);
-        parser.declareObject(ConstructingObjectParser.optionalConstructorArg(), (p, context) -> p.map(), AFTER_FIELD_NAME);
-        return parser;
-    };
-
-    public static CompositeAggregationBuilder parse(String aggregationName, XContentParser parser) throws IOException {
-        return PARSER.apply(aggregationName).parse(parser, null);
+        PARSER.declareInt(CompositeAggregationBuilder::size, SIZE_FIELD_NAME);
+        PARSER.declareObject(CompositeAggregationBuilder::aggregateAfter, (p, context) -> p.map(), AFTER_FIELD_NAME);
     }
 
     private List<CompositeValuesSourceBuilder<?>> sources;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptPipelineAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptPipelineAggregationBuilder.java
index ba2114c1152a3..5fddd5f1a9e1c 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptPipelineAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptPipelineAggregationBuilder.java
@@ -37,8 +37,8 @@
 import java.util.Map.Entry;
 import java.util.Objects;
 import java.util.TreeMap;
-import java.util.function.Function;
 
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 import static org.elasticsearch.search.aggregations.pipeline.PipelineAggregator.Parser.BUCKETS_PATH;
 import static org.elasticsearch.search.aggregations.pipeline.PipelineAggregator.Parser.FORMAT;
 import static org.elasticsearch.search.aggregations.pipeline.PipelineAggregator.Parser.GAP_POLICY;
@@ -51,31 +51,24 @@ public class BucketScriptPipelineAggregationBuilder extends AbstractPipelineAggr
     private String format = null;
     private GapPolicy gapPolicy = GapPolicy.SKIP;
 
-    private static final Function<String, ConstructingObjectParser<BucketScriptPipelineAggregationBuilder, Void>> PARSER
-        = name -> {
-
-        @SuppressWarnings("unchecked")
-        ConstructingObjectParser<BucketScriptPipelineAggregationBuilder, Void> parser = new ConstructingObjectParser<>(
-            BucketScriptPipelineAggregationBuilder.NAME,
-            false,
-            o -> new BucketScriptPipelineAggregationBuilder(name, (Map<String, String>) o[0], (Script) o[1]));
-
-        parser.declareField(ConstructingObjectParser.constructorArg()
-            , BucketScriptPipelineAggregationBuilder::extractBucketPath
-            , BUCKETS_PATH_FIELD
-            , ObjectParser.ValueType.OBJECT_ARRAY_OR_STRING);
-        parser.declareField(ConstructingObjectParser.constructorArg(),
-            (p, c) -> Script.parse(p), Script.SCRIPT_PARSE_FIELD, ObjectParser.ValueType.OBJECT_OR_STRING);
-
-        parser.declareString(BucketScriptPipelineAggregationBuilder::format, FORMAT);
-        parser.declareField(BucketScriptPipelineAggregationBuilder::gapPolicy, p -> {
+    public static final ConstructingObjectParser<BucketScriptPipelineAggregationBuilder, String> PARSER = new ConstructingObjectParser<>(
+            NAME, false, (args, name) -> {
+                @SuppressWarnings("unchecked")
+                var bucketsPathsMap = (Map<String, String>) args[0];
+                return new BucketScriptPipelineAggregationBuilder(name, bucketsPathsMap, (Script) args[1]);
+            });
+    static {
+        PARSER.declareField(constructorArg(), BucketScriptPipelineAggregationBuilder::extractBucketPath,
+                BUCKETS_PATH_FIELD, ObjectParser.ValueType.OBJECT_ARRAY_OR_STRING);
+        Script.declareScript(PARSER, constructorArg());
+
+        PARSER.declareString(BucketScriptPipelineAggregationBuilder::format, FORMAT);
+        PARSER.declareField(BucketScriptPipelineAggregationBuilder::gapPolicy, p -> {
             if (p.currentToken() == XContentParser.Token.VALUE_STRING) {
                 return GapPolicy.parse(p.text().toLowerCase(Locale.ROOT), p.getTokenLocation());
             }
             throw new IllegalArgumentException("Unsupported token [" + p.currentToken() + "]");
         }, GAP_POLICY, ObjectParser.ValueType.STRING);
-
-        return parser;
     };
 
 
@@ -205,10 +198,6 @@ protected XContentBuilder internalXContent(XContentBuilder builder, Params param
         return builder;
     }
 
-    public static BucketScriptPipelineAggregationBuilder parse(String aggName, XContentParser parser) {
-        return PARSER.apply(aggName).apply(parser, null);
-    }
-
     @Override
     protected boolean overrideBucketsPath() {
         return true;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/MovFnPipelineAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/MovFnPipelineAggregationBuilder.java
index 132eaf7ddf931..d24710631d8fd 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/MovFnPipelineAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/pipeline/MovFnPipelineAggregationBuilder.java
@@ -40,8 +40,8 @@
 import java.util.Locale;
 import java.util.Map;
 import java.util.Objects;
-import java.util.function.Function;
 
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 import static org.elasticsearch.search.aggregations.pipeline.PipelineAggregator.Parser.BUCKETS_PATH;
 import static org.elasticsearch.search.aggregations.pipeline.PipelineAggregator.Parser.FORMAT;
 import static org.elasticsearch.search.aggregations.pipeline.PipelineAggregator.Parser.GAP_POLICY;
@@ -58,29 +58,23 @@ public class MovFnPipelineAggregationBuilder extends AbstractPipelineAggregation
     private int window;
     private int shift;
 
-    private static final Function<String, ConstructingObjectParser<MovFnPipelineAggregationBuilder, Void>> PARSER
-        = name -> {
-
-        ConstructingObjectParser<MovFnPipelineAggregationBuilder, Void> parser = new ConstructingObjectParser<>(
-            MovFnPipelineAggregationBuilder.NAME,
-            false,
-            o -> new MovFnPipelineAggregationBuilder(name, (String) o[0], (Script) o[1], (int)o[2]));
-
-        parser.declareString(ConstructingObjectParser.constructorArg(), BUCKETS_PATH_FIELD);
-        parser.declareField(ConstructingObjectParser.constructorArg(),
+    public static final ConstructingObjectParser<MovFnPipelineAggregationBuilder, String> PARSER = new ConstructingObjectParser<>(
+            NAME, false,
+            (args, name) -> new MovFnPipelineAggregationBuilder(name, (String) args[0], (Script) args[1], (int)args[2]));
+    static {
+        PARSER.declareString(constructorArg(), BUCKETS_PATH_FIELD);
+        PARSER.declareField(constructorArg(),
             (p, c) -> Script.parse(p), Script.SCRIPT_PARSE_FIELD, ObjectParser.ValueType.OBJECT_OR_STRING);
-        parser.declareInt(ConstructingObjectParser.constructorArg(), WINDOW);
+        PARSER.declareInt(constructorArg(), WINDOW);
 
-        parser.declareInt(MovFnPipelineAggregationBuilder::setShift, SHIFT);
-        parser.declareString(MovFnPipelineAggregationBuilder::format, FORMAT);
-        parser.declareField(MovFnPipelineAggregationBuilder::gapPolicy, p -> {
+        PARSER.declareInt(MovFnPipelineAggregationBuilder::setShift, SHIFT);
+        PARSER.declareString(MovFnPipelineAggregationBuilder::format, FORMAT);
+        PARSER.declareField(MovFnPipelineAggregationBuilder::gapPolicy, p -> {
             if (p.currentToken() == XContentParser.Token.VALUE_STRING) {
                 return GapPolicy.parse(p.text().toLowerCase(Locale.ROOT), p.getTokenLocation());
             }
             throw new IllegalArgumentException("Unsupported token [" + p.currentToken() + "]");
         }, GAP_POLICY, ObjectParser.ValueType.STRING);
-
-        return parser;
     };
 
 
@@ -212,10 +206,6 @@ protected XContentBuilder internalXContent(XContentBuilder builder, Params param
         return builder;
     }
 
-    public static MovFnPipelineAggregationBuilder parse(String aggName, XContentParser parser) {
-        return PARSER.apply(aggName).apply(parser, null);
-    }
-
     /**
      * Used for serialization testing, since pipeline aggs serialize themselves as a named object but are parsed
      * as a regular object with the name passed in.
@@ -228,7 +218,7 @@ static MovFnPipelineAggregationBuilder parse(XContentParser parser) throws IOExc
                 String aggName = parser.currentName();
                 parser.nextToken(); // "moving_fn"
                 parser.nextToken(); // start_object
-                return PARSER.apply(aggName).apply(parser, null);
+                return PARSER.apply(parser, aggName);
             }
         }
 
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptIT.java
index 338a0ccefdb9c..4ad87cdb5a423 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptIT.java
@@ -645,7 +645,7 @@ public void testSingleBucketPathAgg() throws Exception {
             .endObject()
             .endObject();
         BucketScriptPipelineAggregationBuilder bucketScriptAgg =
-            BucketScriptPipelineAggregationBuilder.parse("seriesArithmetic", createParser(content));
+            BucketScriptPipelineAggregationBuilder.PARSER.parse(createParser(content), "seriesArithmetic");
 
         SearchResponse response = client()
             .prepareSearch("idx", "idx_unmapped")
@@ -690,7 +690,7 @@ public void testArrayBucketPathAgg() throws Exception {
             .endObject()
             .endObject();
         BucketScriptPipelineAggregationBuilder bucketScriptAgg =
-            BucketScriptPipelineAggregationBuilder.parse("seriesArithmetic", createParser(content));
+            BucketScriptPipelineAggregationBuilder.PARSER.parse(createParser(content), "seriesArithmetic");
 
         SearchResponse response = client()
             .prepareSearch("idx", "idx_unmapped")
@@ -747,7 +747,7 @@ public void testObjectBucketPathAgg() throws Exception {
             .endObject()
             .endObject();
         BucketScriptPipelineAggregationBuilder bucketScriptAgg =
-            BucketScriptPipelineAggregationBuilder.parse("seriesArithmetic", createParser(content));
+            BucketScriptPipelineAggregationBuilder.PARSER.parse(createParser(content), "seriesArithmetic");
 
         SearchResponse response = client()
             .prepareSearch("idx", "idx_unmapped")
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptTests.java
index 0746fa1782f59..fb2c65bc166f1 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/BucketScriptTests.java
@@ -71,7 +71,8 @@ public void testParseBucketPath() throws IOException  {
                    .field("lang", "expression")
               .endObject()
             .endObject();
-        BucketScriptPipelineAggregationBuilder builder1 = BucketScriptPipelineAggregationBuilder.parse("count", createParser(content));
+        BucketScriptPipelineAggregationBuilder builder1 = BucketScriptPipelineAggregationBuilder.PARSER.parse(
+                createParser(content), "count");
         assertEquals(builder1.getBucketsPaths().length , 1);
         assertEquals(builder1.getBucketsPaths()[0], "_count");
 
@@ -86,7 +87,8 @@ public void testParseBucketPath() throws IOException  {
                 .field("lang", "expression")
               .endObject()
             .endObject();
-        BucketScriptPipelineAggregationBuilder builder2 = BucketScriptPipelineAggregationBuilder.parse("count", createParser(content));
+        BucketScriptPipelineAggregationBuilder builder2 = BucketScriptPipelineAggregationBuilder.PARSER.parse(
+                createParser(content), "count");
         assertEquals(builder2.getBucketsPaths().length , 2);
         assertEquals(builder2.getBucketsPaths()[0], "_count1");
         assertEquals(builder2.getBucketsPaths()[1], "_count2");
@@ -99,7 +101,8 @@ public void testParseBucketPath() throws IOException  {
                 .field("lang", "expression")
                .endObject()
             .endObject();
-        BucketScriptPipelineAggregationBuilder builder3 = BucketScriptPipelineAggregationBuilder.parse("count", createParser(content));
+        BucketScriptPipelineAggregationBuilder builder3 = BucketScriptPipelineAggregationBuilder.PARSER.parse(
+                createParser(content), "count");
         assertEquals(builder3.getBucketsPaths().length , 2);
         assertEquals(builder3.getBucketsPaths()[0], "_count1");
         assertEquals(builder3.getBucketsPaths()[1], "_count2");
diff --git a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/AnalyticsPlugin.java b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/AnalyticsPlugin.java
index c7128e3e93dca..40f8ac55be89c 100644
--- a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/AnalyticsPlugin.java
+++ b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/AnalyticsPlugin.java
@@ -50,7 +50,7 @@ public List<PipelineAggregationSpec> getPipelineAggregations() {
                 CumulativeCardinalityPipelineAggregationBuilder.NAME,
                 CumulativeCardinalityPipelineAggregationBuilder::new,
                 CumulativeCardinalityPipelineAggregator::new,
-                CumulativeCardinalityPipelineAggregationBuilder::parse)
+                (name, p) -> CumulativeCardinalityPipelineAggregationBuilder.PARSER.parse(p, name))
         );
     }
 
diff --git a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/cumulativecardinality/CumulativeCardinalityPipelineAggregationBuilder.java b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/cumulativecardinality/CumulativeCardinalityPipelineAggregationBuilder.java
index 236745ddfad14..3ad9173abec79 100644
--- a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/cumulativecardinality/CumulativeCardinalityPipelineAggregationBuilder.java
+++ b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/cumulativecardinality/CumulativeCardinalityPipelineAggregationBuilder.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.search.DocValueFormat;
 import org.elasticsearch.search.aggregations.AggregationBuilder;
@@ -18,35 +17,40 @@
 import org.elasticsearch.search.aggregations.pipeline.AbstractPipelineAggregationBuilder;
 import org.elasticsearch.search.aggregations.pipeline.BucketMetricsParser;
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
-import org.elasticsearch.xpack.core.XPackField;
 import org.elasticsearch.xpack.analytics.AnalyticsPlugin;
+import org.elasticsearch.xpack.core.XPackField;
 
 import java.io.IOException;
 import java.util.Collection;
 import java.util.Map;
 import java.util.Objects;
-import java.util.function.Function;
 
+import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 import static org.elasticsearch.search.aggregations.pipeline.PipelineAggregator.Parser.BUCKETS_PATH;
 import static org.elasticsearch.search.aggregations.pipeline.PipelineAggregator.Parser.FORMAT;
 
 public class CumulativeCardinalityPipelineAggregationBuilder
-    extends AbstractPipelineAggregationBuilder<CumulativeCardinalityPipelineAggregationBuilder> {
+        extends AbstractPipelineAggregationBuilder<CumulativeCardinalityPipelineAggregationBuilder> {
     public static final String NAME = "cumulative_cardinality";
 
-    private String format;
-
-    private static final Function<String, ConstructingObjectParser<CumulativeCardinalityPipelineAggregationBuilder, Void>> PARSER
-        = name -> {
-        ConstructingObjectParser<CumulativeCardinalityPipelineAggregationBuilder, Void> parser = new ConstructingObjectParser<>(
-            CumulativeCardinalityPipelineAggregationBuilder.NAME,
-            false,
-            o -> new CumulativeCardinalityPipelineAggregationBuilder(name, (String) o[0]));
+    public static final ConstructingObjectParser<CumulativeCardinalityPipelineAggregationBuilder, String> PARSER =
+            new ConstructingObjectParser<>(NAME, false, (args, name) -> {
+                if (AnalyticsPlugin.getLicenseState().isDataScienceAllowed() == false) {
+                    throw LicenseUtils.newComplianceException(XPackField.ANALYTICS);
+                }
+
+                // Increment usage here since it is a good boundary between internal and external, and should correlate 1:1 with
+                // usage and not internal instantiations
+                AnalyticsPlugin.cumulativeCardUsage.incrementAndGet();
+
+                return new CumulativeCardinalityPipelineAggregationBuilder(name, (String) args[0]);
+            });
+    static {
+        PARSER.declareString(constructorArg(), BUCKETS_PATH_FIELD);
+        PARSER.declareString(CumulativeCardinalityPipelineAggregationBuilder::format, FORMAT);
+    }
 
-        parser.declareString(ConstructingObjectParser.constructorArg(), BUCKETS_PATH_FIELD);
-        parser.declareString(CumulativeCardinalityPipelineAggregationBuilder::format, FORMAT);
-        return parser;
-    };
+    private String format;
 
     public CumulativeCardinalityPipelineAggregationBuilder(String name, String bucketsPath) {
         super(name, NAME, new String[] { bucketsPath });
@@ -115,17 +119,6 @@ protected final XContentBuilder internalXContent(XContentBuilder builder, Params
         return builder;
     }
 
-    public static CumulativeCardinalityPipelineAggregationBuilder parse(String aggName, XContentParser parser) {
-        if (AnalyticsPlugin.getLicenseState().isDataScienceAllowed() == false) {
-            throw LicenseUtils.newComplianceException(XPackField.ANALYTICS);
-        }
-
-        // Increment usage here since it is a good boundary between internal and external, and should correlate 1:1 with
-        // usage and not internal instantiations
-        AnalyticsPlugin.cumulativeCardUsage.incrementAndGet();
-        return PARSER.apply(aggName).apply(parser, null);
-    }
-
     @Override
     public int hashCode() {
         return Objects.hash(super.hashCode(), format);
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/pivot/Pivot.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/pivot/Pivot.java
index 33611cbb3a5bc..78036ec3a80ca 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/pivot/Pivot.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/transforms/pivot/Pivot.java
@@ -237,7 +237,7 @@ private static CompositeAggregationBuilder createCompositeAggregationSources(Piv
             config.toCompositeAggXContent(builder, forChangeDetection);
             XContentParser parser = builder.generator().contentType().xContent().createParser(NamedXContentRegistry.EMPTY,
                     LoggingDeprecationHandler.INSTANCE, BytesReference.bytes(builder).streamInput());
-            compositeAggregation = CompositeAggregationBuilder.parse(COMPOSITE_AGGREGATION_NAME, parser);
+            compositeAggregation = CompositeAggregationBuilder.PARSER.parse(parser, COMPOSITE_AGGREGATION_NAME);
         } catch (IOException e) {
             throw new RuntimeException(TransformMessages.TRANSFORM_PIVOT_FAILED_TO_CREATE_COMPOSITE_AGGREGATION, e);
         }

From 933a1bf2b63e4829fb0b2591fc594e6df1780e26 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Thu, 9 Jan 2020 11:26:34 -0800
Subject: [PATCH 486/686] [DOCS] Update license expiry links (#50812)

---
 docs/reference/licensing/delete-license.asciidoc | 3 ++-
 docs/reference/licensing/update-license.asciidoc | 5 +++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/reference/licensing/delete-license.asciidoc b/docs/reference/licensing/delete-license.asciidoc
index 6b70cfde7c948..447f79d9574d9 100644
--- a/docs/reference/licensing/delete-license.asciidoc
+++ b/docs/reference/licensing/delete-license.asciidoc
@@ -17,7 +17,8 @@ This API enables you to delete licensing information.
 ==== Description
 
 When your license expires, {xpack} operates in a degraded mode.  For more
-information, see {stack-ov}/license-expiration.html[License Expiration].
+information, see
+{kibana-ref}/managing-licenses.html#license-expiration[License expiration].
 
 [float]
 ==== Authorization
diff --git a/docs/reference/licensing/update-license.asciidoc b/docs/reference/licensing/update-license.asciidoc
index e286107ef6ca0..e738260d1e629 100644
--- a/docs/reference/licensing/update-license.asciidoc
+++ b/docs/reference/licensing/update-license.asciidoc
@@ -161,5 +161,6 @@ curl -XPUT -u elastic 'http://<host>:<port>/_license?acknowledge=true' -H "Conte
 ------------------------------------------------------------
 // NOTCONSOLE
 
-For more information about the features that are disabled when you downgrade
-your license, see {stack-ov}/license-expiration.html[License Expiration].
+For more information about the features that are disabled when your license
+expires, see
+{kibana-ref}/managing-licenses.html#license-expiration[License expiration].

From e8602cf2815c9ff461d9826d9b86a00b0cbde011 Mon Sep 17 00:00:00 2001
From: Matt Braymer-Hayes <matt.hayes91@gmail.com>
Date: Thu, 9 Jan 2020 14:35:05 -0500
Subject: [PATCH 487/686] Fix typo in refresh API docs (#50759)

---
 docs/reference/indices/refresh.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/indices/refresh.asciidoc b/docs/reference/indices/refresh.asciidoc
index a6a8b1d6ef18d..205cd69fd9df3 100644
--- a/docs/reference/indices/refresh.asciidoc
+++ b/docs/reference/indices/refresh.asciidoc
@@ -42,7 +42,7 @@ using the <<index-refresh-interval-setting,`index.refresh_interval`>> setting.
 
 [IMPORTANT]
 ====
-Refreshes are a resource-intensive.
+Refreshes are resource-intensive.
 To ensure good cluster performance,
 we recommend waiting for {es}'s periodic refresh 
 rather than performing an explicit refresh

From fa60d927a6faa5413cb2bf659720be8fe35ae46b Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Thu, 9 Jan 2020 18:18:23 -0500
Subject: [PATCH 488/686] Do not force refresh when write indexing buffer
 (#50769)

Today we periodically check the indexing buffer memory every 5 seconds
or after we have used 1/30 of the configured memory. If the total used
memory is over the threshold, then we refresh the "largest" shards. If
refreshing takes longer these intervals (i.e., 5s or 1/30 buffer), then
we continue to enqueue refreshes to these shards. This leads to two
issues:

- The refresh thread pool can be exhausted and other shards can't refresh
- Execute too many refreshes for the "largest" shards

With this change, we only refresh the largest shards if they are not refreshing.
Here we rely on the periodic check to trigger another refresh if needed. We can
harden this by making the ongoing refresh triggers the memory check when
it's completed. I opted out this option in this PR for simplicity.

See: https://discuss.elastic.co/t/write-queue-continue-to-rise/213652/
---
 .../index/engine/InternalEngine.java          |   4 +-
 .../indices/IndexingMemoryControllerIT.java   | 101 ++++++++
 .../IndexingMemoryControllerTests.java        | 232 +++++++++---------
 3 files changed, 213 insertions(+), 124 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerIT.java

diff --git a/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java b/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
index 0ea50322b173b..abdead30ff87a 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/InternalEngine.java
@@ -1612,9 +1612,7 @@ final boolean refresh(String source, SearcherScope scope, boolean block) throws
 
     @Override
     public void writeIndexingBuffer() throws EngineException {
-        // we obtain a read lock here, since we don't want a flush to happen while we are writing
-        // since it flushes the index as well (though, in terms of concurrency, we are allowed to do it)
-        refresh("write indexing buffer", SearcherScope.INTERNAL, true);
+        refresh("write indexing buffer", SearcherScope.INTERNAL, false);
     }
 
     @Override
diff --git a/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerIT.java b/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerIT.java
new file mode 100644
index 0000000000000..5d5786e992d86
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerIT.java
@@ -0,0 +1,101 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.indices;
+
+import org.apache.logging.log4j.LogManager;
+import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeResponse;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.IndexService;
+import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.index.codec.CodecService;
+import org.elasticsearch.index.engine.EngineConfig;
+import org.elasticsearch.index.engine.EngineFactory;
+import org.elasticsearch.index.engine.InternalEngine;
+import org.elasticsearch.index.refresh.RefreshStats;
+import org.elasticsearch.index.shard.IndexShard;
+import org.elasticsearch.plugins.EnginePlugin;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.test.ESSingleNodeTestCase;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+import java.util.Optional;
+
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertNoFailures;
+import static org.hamcrest.Matchers.greaterThan;
+
+public class IndexingMemoryControllerIT extends ESSingleNodeTestCase {
+
+    @Override
+    protected Settings nodeSettings() {
+        return Settings.builder().put(super.nodeSettings())
+            // small indexing buffer so that we can trigger refresh after buffering 100 deletes
+            .put("indices.memory.index_buffer_size", "1kb").build();
+    }
+
+    @Override
+    protected Collection<Class<? extends Plugin>> getPlugins() {
+        final List<Class<? extends Plugin>> plugins = new ArrayList<>(super.getPlugins());
+        plugins.add(TestEnginePlugin.class);
+        return plugins;
+    }
+
+    public static class TestEnginePlugin extends Plugin implements EnginePlugin {
+
+        EngineConfig engineConfigWithLargerIndexingMemory(EngineConfig config) {
+            // We need to set a larger buffer for the IndexWriter; otherwise, it will flush before the IndexingMemoryController.
+            Settings settings = Settings.builder().put(config.getIndexSettings().getSettings())
+                .put("indices.memory.index_buffer_size", "10mb").build();
+            IndexSettings indexSettings = new IndexSettings(config.getIndexSettings().getIndexMetaData(), settings);
+            return new EngineConfig(config.getShardId(), config.getAllocationId(), config.getThreadPool(),
+                indexSettings, config.getWarmer(), config.getStore(), config.getMergePolicy(), config.getAnalyzer(),
+                config.getSimilarity(), new CodecService(null, LogManager.getLogger(IndexingMemoryControllerIT.class)),
+                config.getEventListener(), config.getQueryCache(),
+                config.getQueryCachingPolicy(), config.getTranslogConfig(), config.getFlushMergesAfter(),
+                config.getExternalRefreshListener(), config.getInternalRefreshListener(), config.getIndexSort(),
+                config.getCircuitBreakerService(), config.getGlobalCheckpointSupplier(), config.retentionLeasesSupplier(),
+                config.getPrimaryTermSupplier(), config.getTombstoneDocSupplier());
+        }
+
+        @Override
+        public Optional<EngineFactory> getEngineFactory(IndexSettings indexSettings) {
+            return Optional.of(config -> new InternalEngine(engineConfigWithLargerIndexingMemory(config)));
+        }
+    }
+
+    // #10312
+    public void testDeletesAloneCanTriggerRefresh() throws Exception {
+        IndexService indexService = createIndex("index", Settings.builder().put("index.number_of_shards", 1)
+            .put("index.number_of_replicas", 0).put("index.refresh_interval", -1).build());
+        IndexShard shard = indexService.getShard(0);
+        for (int i = 0; i < 100; i++) {
+            client().prepareIndex("index").setId(Integer.toString(i)).setSource("field", "value").get();
+        }
+        // Force merge so we know all merges are done before we start deleting:
+        ForceMergeResponse r = client().admin().indices().prepareForceMerge().setMaxNumSegments(1).execute().actionGet();
+        assertNoFailures(r);
+        final RefreshStats refreshStats = shard.refreshStats();
+        for (int i = 0; i < 100; i++) {
+            client().prepareDelete("index", Integer.toString(i)).get();
+        }
+        // need to assert busily as IndexingMemoryController refreshes in background
+        assertBusy(() -> assertThat(shard.refreshStats().getTotal(), greaterThan(refreshStats.getTotal() + 1)));
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerTests.java b/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerTests.java
index 3609ef0aad0f7..5a4fc6e07a873 100644
--- a/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerTests.java
@@ -18,26 +18,24 @@
  */
 package org.elasticsearch.indices;
 
-import org.apache.lucene.index.DirectoryReader;
+import org.apache.lucene.search.ReferenceManager;
+import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.Version;
-import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeResponse;
 import org.elasticsearch.cluster.node.DiscoveryNode;
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.common.CheckedFunction;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.engine.Engine;
+import org.elasticsearch.index.codec.CodecService;
+import org.elasticsearch.index.engine.EngineConfig;
+import org.elasticsearch.index.engine.InternalEngine;
+import org.elasticsearch.index.refresh.RefreshStats;
 import org.elasticsearch.index.shard.IndexShard;
-import org.elasticsearch.index.shard.IndexShardIT;
 import org.elasticsearch.index.shard.IndexShardTestCase;
-import org.elasticsearch.indices.breaker.NoneCircuitBreakerService;
 import org.elasticsearch.indices.recovery.RecoveryState;
-import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.threadpool.Scheduler.Cancellable;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.threadpool.ThreadPoolStats;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -47,15 +45,16 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.concurrent.atomic.AtomicReference;
 
 import static java.util.Collections.emptyMap;
 import static java.util.Collections.emptySet;
-import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertNoFailures;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.greaterThanOrEqualTo;
 
-public class IndexingMemoryControllerTests extends ESSingleNodeTestCase {
+public class IndexingMemoryControllerTests extends IndexShardTestCase {
 
     static class MockController extends IndexingMemoryController {
 
@@ -168,19 +167,16 @@ protected Cancellable scheduleTask(ThreadPool threadPool) {
         }
     }
 
-    public void testShardAdditionAndRemoval() {
-        createIndex("test", Settings.builder().put("index.number_of_shards", 3).put("index.number_of_replicas", 0).build());
-        IndicesService indicesService = getInstanceFromNode(IndicesService.class);
-        IndexService test = indicesService.indexService(resolveIndex("test"));
+    public void testShardAdditionAndRemoval() throws IOException {
 
         MockController controller = new MockController(Settings.builder()
                                                        .put("indices.memory.index_buffer_size", "4mb").build());
-        IndexShard shard0 = test.getShard(0);
+        IndexShard shard0 = newStartedShard();
         controller.simulateIndexing(shard0);
         controller.assertBuffer(shard0, 1);
 
         // add another shard
-        IndexShard shard1 = test.getShard(1);
+        IndexShard shard1 = newStartedShard();
         controller.simulateIndexing(shard1);
         controller.assertBuffer(shard0, 1);
         controller.assertBuffer(shard1, 1);
@@ -195,24 +191,21 @@ public void testShardAdditionAndRemoval() {
         controller.forceCheck();
 
         // add a new one
-        IndexShard shard2 = test.getShard(2);
+        IndexShard shard2 = newStartedShard();
         controller.simulateIndexing(shard2);
         controller.assertBuffer(shard2, 1);
+        closeShards(shard0, shard1, shard2);
     }
 
-    public void testActiveInactive() {
-
-        createIndex("test", Settings.builder().put("index.number_of_shards", 2).put("index.number_of_replicas", 0).build());
-        IndicesService indicesService = getInstanceFromNode(IndicesService.class);
-        IndexService test = indicesService.indexService(resolveIndex("test"));
+    public void testActiveInactive() throws IOException {
 
         MockController controller = new MockController(Settings.builder()
                                                        .put("indices.memory.index_buffer_size", "5mb")
                                                        .build());
 
-        IndexShard shard0 = test.getShard(0);
+        IndexShard shard0 = newStartedShard();
         controller.simulateIndexing(shard0);
-        IndexShard shard1 = test.getShard(1);
+        IndexShard shard1 = newStartedShard();
         controller.simulateIndexing(shard1);
 
         controller.assertBuffer(shard0, 1);
@@ -237,6 +230,7 @@ public void testActiveInactive() {
         controller.simulateIndexing(shard1);
         // shard1 crossed 5 mb and is now cleared:
         controller.assertBuffer(shard1, 0);
+        closeShards(shard0, shard1);
     }
 
     public void testMinBufferSizes() {
@@ -288,14 +282,11 @@ public void testMaxBufferSizes() {
     }
 
     public void testThrottling() throws Exception {
-        createIndex("test", Settings.builder().put("index.number_of_shards", 3).put("index.number_of_replicas", 0).build());
-        IndicesService indicesService = getInstanceFromNode(IndicesService.class);
-        IndexService test = indicesService.indexService(resolveIndex("test"));
 
         MockController controller = new MockController(Settings.builder()
                                                        .put("indices.memory.index_buffer_size", "4mb").build());
-        IndexShard shard0 = test.getShard(0);
-        IndexShard shard1 = test.getShard(1);
+        IndexShard shard0 = newStartedShard();
+        IndexShard shard1 = newStartedShard();
         controller.simulateIndexing(shard0);
         controller.simulateIndexing(shard0);
         controller.simulateIndexing(shard0);
@@ -346,117 +337,116 @@ public void testThrottling() throws Exception {
         controller.forceCheck();
         controller.assertNotThrottled(shard0);
         controller.assertNotThrottled(shard1);
+        closeShards(shard0, shard1);
     }
 
-    // #10312
-    public void testDeletesAloneCanTriggerRefresh() throws Exception {
-        createIndex("index",
-                    Settings.builder().put("index.number_of_shards", 1)
-                                      .put("index.number_of_replicas", 0)
-                                      .put("index.refresh_interval", -1)
-                                      .build());
-        ensureGreen();
-
-        IndicesService indicesService = getInstanceFromNode(IndicesService.class);
-        IndexService indexService = indicesService.indexService(resolveIndex("index"));
-        IndexShard shard = indexService.getShardOrNull(0);
-        assertNotNull(shard);
-
+    public void testTranslogRecoveryWorksWithIMC() throws IOException {
+        IndexShard shard = newStartedShard(true);
         for (int i = 0; i < 100; i++) {
-            String id = Integer.toString(i);
-            client().prepareIndex("index").setId(id).setSource("field", "value").get();
+            indexDoc(shard, Integer.toString(i), "{\"foo\" : \"bar\"}", XContentType.JSON, null);
         }
-
-        // Force merge so we know all merges are done before we start deleting:
-        ForceMergeResponse r = client().admin().indices().prepareForceMerge().setMaxNumSegments(1).execute().actionGet();
-        assertNoFailures(r);
-
-        // Make a shell of an IMC to check up on indexing buffer usage:
-        Settings settings = Settings.builder().put("indices.memory.index_buffer_size", "1kb").build();
-
-        // TODO: would be cleaner if I could pass this 1kb setting to the single node this test created....
-        IndexingMemoryController imc = new IndexingMemoryController(settings, null, null) {
+        shard.close("simon says", false);
+        AtomicReference<IndexShard> shardRef = new AtomicReference<>();
+        Settings settings = Settings.builder().put("indices.memory.index_buffer_size", "50kb").build();
+        Iterable<IndexShard> iterable = () -> (shardRef.get() == null) ? Collections.emptyIterator()
+            : Collections.singleton(shardRef.get()).iterator();
+        AtomicInteger flushes = new AtomicInteger();
+        IndexingMemoryController imc = new IndexingMemoryController(settings, threadPool, iterable) {
             @Override
-            protected List<IndexShard> availableShards() {
-                return Collections.singletonList(shard);
+            protected void writeIndexingBufferAsync(IndexShard shard) {
+                assertEquals(shard, shardRef.get());
+                flushes.incrementAndGet();
+                shard.writeIndexingBuffer();
             }
+        };
+        shard = reinitShard(shard, imc);
+        shardRef.set(shard);
+        assertEquals(0, imc.availableShards().size());
+        DiscoveryNode localNode = new DiscoveryNode("foo", buildNewFakeTransportAddress(), emptyMap(), emptySet(), Version.CURRENT);
+        shard.markAsRecovering("store", new RecoveryState(shard.routingEntry(), localNode, null));
+
+        assertEquals(1, imc.availableShards().size());
+        assertTrue(recoverFromStore(shard));
+        assertThat("we should have flushed in IMC at least once", flushes.get(), greaterThanOrEqualTo(1));
+        closeShards(shard);
+    }
 
-            @Override
-            protected long getIndexBufferRAMBytesUsed(IndexShard shard) {
-                return shard.getIndexBufferRAMBytesUsed();
+    EngineConfig configWithRefreshListener(EngineConfig config, ReferenceManager.RefreshListener listener) {
+        final List<ReferenceManager.RefreshListener> internalRefreshListener = new ArrayList<>(config.getInternalRefreshListener());;
+        internalRefreshListener.add(listener);
+        return new EngineConfig(config.getShardId(), config.getAllocationId(), config.getThreadPool(),
+            config.getIndexSettings(), config.getWarmer(), config.getStore(), config.getMergePolicy(), config.getAnalyzer(),
+            config.getSimilarity(), new CodecService(null, logger), config.getEventListener(), config.getQueryCache(),
+            config.getQueryCachingPolicy(), config.getTranslogConfig(), config.getFlushMergesAfter(),
+            config.getExternalRefreshListener(), internalRefreshListener, config.getIndexSort(),
+            config.getCircuitBreakerService(), config.getGlobalCheckpointSupplier(), config.retentionLeasesSupplier(),
+            config.getPrimaryTermSupplier(), config.getTombstoneDocSupplier());
+    }
+
+    ThreadPoolStats.Stats getRefreshThreadPoolStats() {
+        final ThreadPoolStats stats = threadPool.stats();
+        for (ThreadPoolStats.Stats s : stats) {
+            if (s.getName().equals(ThreadPool.Names.REFRESH)) {
+                return s;
             }
+        }
+        throw new AssertionError("refresh thread pool stats not found [" + stats + "]");
+    }
 
+    public void testSkipRefreshIfShardIsRefreshingAlready() throws Exception {
+        SetOnce<CountDownLatch> refreshLatch = new SetOnce<>();
+        ReferenceManager.RefreshListener refreshListener = new ReferenceManager.RefreshListener() {
             @Override
-            protected void writeIndexingBufferAsync(IndexShard shard) {
-                // just do it sync'd for this test
-                shard.writeIndexingBuffer();
+            public void beforeRefresh() {
+                if (refreshLatch.get() != null) {
+                    try {
+                        refreshLatch.get().await();
+                    } catch (InterruptedException e) {
+                        throw new AssertionError(e);
+                    }
+                }
             }
 
             @Override
-            protected Cancellable scheduleTask(ThreadPool threadPool) {
-                return null;
+            public void afterRefresh(boolean didRefresh) {
+
             }
         };
-
-        for (int i = 0; i < 100; i++) {
-            String id = Integer.toString(i);
-            client().prepareDelete("index", id).get();
-        }
-
-        final long indexingBufferBytes1 = shard.getIndexBufferRAMBytesUsed();
-
-        imc.forceCheck();
-
-        // We must assertBusy because the writeIndexingBufferAsync is done in background (REFRESH) thread pool:
-        assertBusy(() -> {
-            try (Engine.Searcher s2 = shard.acquireSearcher("index")) {
-                // 100 buffered deletes will easily exceed our 1 KB indexing buffer so it should trigger a write:
-                final long indexingBufferBytes2 = shard.getIndexBufferRAMBytesUsed();
-                assertTrue(indexingBufferBytes2 < indexingBufferBytes1);
+        IndexShard shard = newStartedShard(randomBoolean(), Settings.EMPTY,
+            config -> new InternalEngine(configWithRefreshListener(config, refreshListener)));
+        refreshLatch.set(new CountDownLatch(1)); // block refresh
+        final RefreshStats refreshStats = shard.refreshStats();
+        final IndexingMemoryController controller = new IndexingMemoryController(
+            Settings.builder().put("indices.memory.interval", "200h") // disable it
+                .put("indices.memory.index_buffer_size", "1024b").build(),
+            threadPool,
+            Collections.singleton(shard)) {
+            @Override
+            protected long getIndexBufferRAMBytesUsed(IndexShard shard) {
+                return randomLongBetween(1025, 10 * 1024 * 1024);
             }
-        });
-    }
-
-    public void testTranslogRecoveryWorksWithIMC() throws IOException {
-        createIndex("test");
-        ensureGreen();
-        IndicesService indicesService = getInstanceFromNode(IndicesService.class);
-        IndexService indexService = indicesService.indexService(resolveIndex("test"));
-        IndexShard shard = indexService.getShardOrNull(0);
-        for (int i = 0; i < 100; i++) {
-            client().prepareIndex("test").setId(Integer.toString(i)).setSource("{\"foo\" : \"bar\"}", XContentType.JSON).get();
-        }
 
-        CheckedFunction<DirectoryReader, DirectoryReader, IOException> wrapper = directoryReader -> directoryReader;
-        shard.close("simon says", false);
-        AtomicReference<IndexShard> shardRef = new AtomicReference<>();
-        Settings settings = Settings.builder().put("indices.memory.index_buffer_size", "50kb").build();
-        Iterable<IndexShard> iterable = () -> (shardRef.get() == null) ? Collections.<IndexShard>emptyList().iterator()
-            : Collections.singleton(shardRef.get()).iterator();
-        AtomicInteger flushes = new AtomicInteger();
-        IndexingMemoryController imc = new IndexingMemoryController(settings, client().threadPool(), iterable) {
             @Override
-            protected void writeIndexingBufferAsync(IndexShard shard) {
-                assertEquals(shard, shardRef.get());
-                flushes.incrementAndGet();
-                shard.writeIndexingBuffer();
+            protected long getShardWritingBytes(IndexShard shard) {
+                return 0L;
             }
         };
-        final IndexShard newShard = IndexShardIT.newIndexShard(indexService, shard, wrapper, new NoneCircuitBreakerService(), imc);
-        shardRef.set(newShard);
-        try {
-            assertEquals(0, imc.availableShards().size());
-            ShardRouting routing = newShard.routingEntry();
-            DiscoveryNode localNode = new DiscoveryNode("foo", buildNewFakeTransportAddress(), emptyMap(), emptySet(), Version.CURRENT);
-            newShard.markAsRecovering("store", new RecoveryState(routing, localNode, null));
-
-            assertEquals(1, imc.availableShards().size());
-            assertTrue(IndexShardTestCase.recoverFromStore(newShard));
-            assertTrue("we should have flushed in IMC at least once but did: " + flushes.get(), flushes.get() >= 1);
-            IndexShardTestCase.updateRoutingEntry(newShard, routing.moveToStarted());
-        } finally {
-            newShard.close("simon says", false);
+        int iterations = randomIntBetween(10, 100);
+        for (int i = 0; i < iterations; i++) {
+            controller.forceCheck();
         }
+        assertBusy(() -> {
+            ThreadPoolStats.Stats stats = getRefreshThreadPoolStats();
+            assertThat(stats.getQueue(), equalTo(0));
+            assertThat(stats.getActive(), equalTo(1));
+        });
+        refreshLatch.get().countDown(); // allow refresh
+        assertBusy(() -> {
+            ThreadPoolStats.Stats stats = getRefreshThreadPoolStats();
+            assertThat(stats.getQueue(), equalTo(0));
+            assertThat(stats.getActive(), equalTo(0));
+        });
+        assertThat(shard.refreshStats().getTotal(), equalTo(refreshStats.getTotal() + 1));
+        closeShards(shard);
     }
-
 }

From 2a2992178ef545dcb1d8410ebbf59f869be0b8a4 Mon Sep 17 00:00:00 2001
From: Julie Tibshirani <julie.tibshirani@elastic.co>
Date: Thu, 9 Jan 2020 15:25:46 -0800
Subject: [PATCH 489/686] Correct the skip version in tests for field
 collapsing on an alias.

---
 .../rest-api-spec/test/search/110_field_collapsing.yml        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
index e5f6c64c6971f..eafb5e088085a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search/110_field_collapsing.yml
@@ -348,8 +348,8 @@ setup:
 ---
 "field collapsing on a field alias":
   - skip:
-      version: " - 7.4.99"
-      reason: the bug fix was introduced in 7.5
+      version: " - 7.5.1"
+      reason: the bug fix was introduced in 7.5.2
   - do:
       indices.create:
         index:  alias-test

From 4f7352223ebb9a2e0672d6e72f7536ec4e693890 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Thu, 9 Jan 2020 15:43:44 -0800
Subject: [PATCH 490/686] Skip test suite entirely for non-applicable
 distribution types (#50824)

---
 .../org/elasticsearch/packaging/test/DebMetadataTests.java  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/DebMetadataTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/DebMetadataTests.java
index 897b5c37bf59c..c42806140fedc 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/DebMetadataTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/DebMetadataTests.java
@@ -23,7 +23,7 @@
 import org.elasticsearch.packaging.util.Distribution;
 import org.elasticsearch.packaging.util.FileUtils;
 import org.elasticsearch.packaging.util.Shell;
-import org.junit.Before;
+import org.junit.BeforeClass;
 
 import java.util.regex.Pattern;
 
@@ -32,8 +32,8 @@
 
 public class DebMetadataTests extends PackagingTestCase {
 
-    @Before
-    public void filterDistros() {
+    @BeforeClass
+    public static void filterDistros() {
         assumeTrue("only deb", distribution.packaging == Distribution.Packaging.DEB);
     }
 

From c1437be06dac3b19e4a01046ca93d0b72b163aab Mon Sep 17 00:00:00 2001
From: debadair <debadair@elastic.co>
Date: Thu, 9 Jan 2020 16:12:02 -0800
Subject: [PATCH 491/686] [DOCS] Move snapshot-restore out of modules. (#49618)

* [DOCS] Move snapshot-restore docs out of modules.

* [DOCS] Incorporates comments from @jrodewig.

* [DOCS] Fix snippet tests
---
 docs/reference/glossary.asciidoc              |   2 +-
 .../backup-cluster-data.asciidoc              |   2 +-
 .../high-availability/backup-cluster.asciidoc |   2 +-
 .../restore-cluster-data.asciidoc             |   2 +-
 .../ilm/getting-started-slm.asciidoc          |   4 +-
 docs/reference/index.asciidoc                 |   2 +
 docs/reference/indices/recovery.asciidoc      |   2 +-
 docs/reference/modules.asciidoc               |   2 -
 docs/reference/modules/snapshots.asciidoc     | 804 ------------------
 docs/reference/redirects.asciidoc             |  17 +-
 .../reference/snapshot-restore/index.asciidoc |  90 ++
 .../monitor-snapshot-restore.asciidoc         |  89 ++
 .../register-repository.asciidoc              | 290 +++++++
 .../restore-snapshot.asciidoc                 | 205 +++++
 .../snapshot-restore/take-snapshot.asciidoc   | 207 +++++
 15 files changed, 906 insertions(+), 814 deletions(-)
 delete mode 100644 docs/reference/modules/snapshots.asciidoc
 create mode 100644 docs/reference/snapshot-restore/index.asciidoc
 create mode 100644 docs/reference/snapshot-restore/monitor-snapshot-restore.asciidoc
 create mode 100644 docs/reference/snapshot-restore/register-repository.asciidoc
 create mode 100644 docs/reference/snapshot-restore/restore-snapshot.asciidoc
 create mode 100644 docs/reference/snapshot-restore/take-snapshot.asciidoc

diff --git a/docs/reference/glossary.asciidoc b/docs/reference/glossary.asciidoc
index 09b743b07e2ef..07270228bace9 100644
--- a/docs/reference/glossary.asciidoc
+++ b/docs/reference/glossary.asciidoc
@@ -223,7 +223,7 @@ during the following processes:
   This type of recovery is called a *local store recovery*.
 * <<glossary-replica-shard,Primary shard replication>>.
 * Relocation of a shard to a different node in the same cluster.
-* {ref}/modules-snapshots.html#restore-snapshot[Snapshot restoration].
+* {ref}/snapshots-restore-snapshot.html[Snapshot restoration].
 // end::recovery-triggers[]
 // end::recovery-def[]
 --
diff --git a/docs/reference/high-availability/backup-cluster-data.asciidoc b/docs/reference/high-availability/backup-cluster-data.asciidoc
index 485e047acd255..4053d6e47b691 100644
--- a/docs/reference/high-availability/backup-cluster-data.asciidoc
+++ b/docs/reference/high-availability/backup-cluster-data.asciidoc
@@ -6,7 +6,7 @@
 
 To back up your cluster's data, you can use the <<modules-snapshots,snapshot API>>.
 
-include::{es-repo-dir}/modules/snapshots.asciidoc[tag=snapshot-intro]
+include::../snapshot-restore/index.asciidoc[tag=snapshot-intro]
 
 [TIP]
 ====
diff --git a/docs/reference/high-availability/backup-cluster.asciidoc b/docs/reference/high-availability/backup-cluster.asciidoc
index 5544af65bc172..3749029355453 100644
--- a/docs/reference/high-availability/backup-cluster.asciidoc
+++ b/docs/reference/high-availability/backup-cluster.asciidoc
@@ -1,7 +1,7 @@
 [[backup-cluster]]
 == Back up a cluster
 
-include::{es-repo-dir}/modules/snapshots.asciidoc[tag=backup-warning]
+include::../snapshot-restore/index.asciidoc[tag=backup-warning]
 
 To have a complete backup for your cluster:
 
diff --git a/docs/reference/high-availability/restore-cluster-data.asciidoc b/docs/reference/high-availability/restore-cluster-data.asciidoc
index c9ae6da339fd4..da58e8c4f3e7f 100644
--- a/docs/reference/high-availability/restore-cluster-data.asciidoc
+++ b/docs/reference/high-availability/restore-cluster-data.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Restore the data</titleabbrev>
 ++++
 
-include::{es-repo-dir}/modules/snapshots.asciidoc[tag=restore-intro]
+include::../snapshot-restore/index.asciidoc[tag=restore-intro]
 
 [TIP]
 ====
diff --git a/docs/reference/ilm/getting-started-slm.asciidoc b/docs/reference/ilm/getting-started-slm.asciidoc
index f09a631e8abe1..24c1b8ca284f4 100644
--- a/docs/reference/ilm/getting-started-slm.asciidoc
+++ b/docs/reference/ilm/getting-started-slm.asciidoc
@@ -5,7 +5,7 @@
 
 Let's get started with snapshot lifecycle management (SLM) by working through a
 hands-on scenario. The goal of this example is to automatically back up {es}
-indices using the <<modules-snapshots,snapshots>> every day at a particular
+indices using the <<snapshot-restore,snapshots>> every day at a particular
 time. Once these snapshots have been created, they are kept for a configured
 amount of time and then deleted per a configured retention policy.
 
@@ -59,7 +59,7 @@ POST /_security/role/slm-read-only
 === Setting up a repository
 
 Before we can set up an SLM policy, we'll need to set up a
-<<snapshots-repositories,snapshot repository>> where the snapshots will be
+snapshot repository where the snapshots will be
 stored. Repositories can use {plugins}/repository.html[many different backends],
 including cloud storage providers. You'll probably want to use one of these in
 production, but for this example we'll use a shared file system repository:
diff --git a/docs/reference/index.asciidoc b/docs/reference/index.asciidoc
index e283ac84ab753..e203b1d4e8730 100644
--- a/docs/reference/index.asciidoc
+++ b/docs/reference/index.asciidoc
@@ -50,6 +50,8 @@ include::data-rollup-transform.asciidoc[]
 
 include::high-availability.asciidoc[]
 
+include::snapshot-restore/index.asciidoc[]
+
 include::{xes-repo-dir}/security/index.asciidoc[]
 
 include::{xes-repo-dir}/watcher/index.asciidoc[]
diff --git a/docs/reference/indices/recovery.asciidoc b/docs/reference/indices/recovery.asciidoc
index 13a3e3788320c..884f7d2fd3122 100644
--- a/docs/reference/indices/recovery.asciidoc
+++ b/docs/reference/indices/recovery.asciidoc
@@ -77,7 +77,7 @@ This type of recovery is called a local store recovery.
 
 `SNAPSHOT`::
 The recovery is related to
-a <<restore-snapshot,snapshot restoration>>.
+a <<snapshots-restore-snapshot,snapshot restoration>>.
 
 `REPLICA`::
 The recovery is related to
diff --git a/docs/reference/modules.asciidoc b/docs/reference/modules.asciidoc
index 51f458c010e6d..23f7f7692142d 100644
--- a/docs/reference/modules.asciidoc
+++ b/docs/reference/modules.asciidoc
@@ -91,8 +91,6 @@ include::modules/node.asciidoc[]
 
 include::modules/plugins.asciidoc[]
 
-include::modules/snapshots.asciidoc[]
-
 include::modules/threadpool.asciidoc[]
 
 include::modules/transport.asciidoc[]
diff --git a/docs/reference/modules/snapshots.asciidoc b/docs/reference/modules/snapshots.asciidoc
deleted file mode 100644
index 666b8b4495fe5..0000000000000
--- a/docs/reference/modules/snapshots.asciidoc
+++ /dev/null
@@ -1,804 +0,0 @@
-[[modules-snapshots]]
-== Snapshot And Restore
-
-// tag::snapshot-intro[]
-A snapshot is a backup taken from a running Elasticsearch cluster. You can take
-a snapshot of individual indices or of the entire cluster and store it in a
-repository on a shared filesystem, and there are plugins that support remote
-repositories on S3, HDFS, Azure, Google Cloud Storage and more.
-
-Snapshots are taken incrementally. This means that when it creates a snapshot of
-an index, Elasticsearch avoids copying any data that is already stored in the
-repository as part of an earlier snapshot of the same index. Therefore it can be
-efficient to take snapshots of your cluster quite frequently.
-// end::snapshot-intro[]
-
-// tag::restore-intro[]
-You can restore snapshots into a running cluster via the
-<<restore-snapshot,restore API>>. When you restore an index, you can alter the
-name of the restored index as well as some of its settings. There is a great
-deal of flexibility in how the snapshot and restore functionality can be used.
-// end::restore-intro[]
-
-You can automate your snapshot backup and restore process by using
-<<getting-started-snapshot-lifecycle-management, snapshot lifecycle management>>.
-
-// tag::backup-warning[]
-WARNING: You cannot back up an Elasticsearch cluster by simply taking a copy of
-the data directories of all of its nodes. Elasticsearch may be making changes to
-the contents of its data directories while it is running; copying its data
-directories cannot be expected to capture a consistent picture of their contents.
-If you try to restore a cluster from such a backup, it may fail and report
-corruption and/or missing files. Alternatively, it may appear to have succeeded
-though it silently lost some of its data. The only reliable way to back up a
-cluster is by using the snapshot and restore functionality.
-
-// end::backup-warning[]
-
-[float]
-=== Version compatibility
-
-IMPORTANT: Version compatibility refers to the underlying Lucene index
-compatibility. Follow the <<setup-upgrade,Upgrade documentation>>
-when migrating between versions.
-
-A snapshot contains a copy of the on-disk data structures that make up an
-index. This means that snapshots can only be restored to versions of
-Elasticsearch that can read the indices:
-
-* A snapshot of an index created in 6.x can be restored to 7.x.
-* A snapshot of an index created in 5.x can be restored to 6.x.
-* A snapshot of an index created in 2.x can be restored to 5.x.
-* A snapshot of an index created in 1.x can be restored to 2.x.
-
-Conversely, snapshots of indices created in 1.x **cannot** be restored to 5.x
-or 6.x, snapshots of indices created in 2.x **cannot** be restored to 6.x
-or 7.x, and snapshots of indices created in 5.x **cannot** be restored to 7.x
-or 8.x.
-
-Each snapshot can contain indices created in various versions of Elasticsearch,
-and when restoring a snapshot it must be possible to restore all of the indices
-into the target cluster. If any indices in a snapshot were created in an
-incompatible version, you will not be able restore the snapshot.
-
-IMPORTANT: When backing up your data prior to an upgrade, keep in mind that you
-won't be able to restore snapshots after you upgrade if they contain indices
-created in a version that's incompatible with the upgrade version.
-
-If you end up in a situation where you need to restore a snapshot of an index
-that is incompatible with the version of the cluster you are currently running,
-you can restore it on the latest compatible version and use
-<<reindex-from-remote,reindex-from-remote>> to rebuild the index on the current
-version. Reindexing from remote is only possible if the original index has
-source enabled. Retrieving and reindexing the data can take significantly
-longer than simply restoring a snapshot. If you have a large amount of data, we
-recommend testing the reindex from remote process with a subset of your data to
-understand the time requirements before proceeding.
-
-[float]
-[[snapshots-repositories]]
-=== Repositories
-
-You must register a snapshot repository before you can perform snapshot and
-restore operations. We recommend creating a new snapshot repository for each
-major version. The valid repository settings depend on the repository type.
-
-If you register same snapshot repository with multiple clusters, only
-one cluster should have write access to the repository. All other clusters
-connected to that repository should set the repository to `readonly` mode.
-
-IMPORTANT: The snapshot format can change across major versions, so if you have
-clusters on different versions trying to write the same repository, snapshots
-written by one version may not be visible to the other and the repository could
-be corrupted. While setting the repository to `readonly` on all but one of the
-clusters should work with multiple clusters differing by one major version, it
-is not a supported configuration.
-
-[source,console]
------------------------------------
-PUT /_snapshot/my_backup
-{
-  "type": "fs",
-  "settings": {
-    "location": "my_backup_location"
-  }
-}
------------------------------------
-// TESTSETUP
-
-To retrieve information about a registered repository, use a GET request:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup
------------------------------------
-
-which returns:
-
-[source,console-result]
------------------------------------
-{
-  "my_backup": {
-    "type": "fs",
-    "settings": {
-      "location": "my_backup_location"
-    }
-  }
-}
------------------------------------
-
-To retrieve information about multiple repositories, specify a comma-delimited
-list of repositories. You can also use the * wildcard when
-specifying repository names. For example, the following request retrieves
-information about all of the snapshot repositories that start with `repo` or
-contain `backup`:
-
-[source,console]
------------------------------------
-GET /_snapshot/repo*,*backup*
------------------------------------
-
-To retrieve information about all registered snapshot repositories, omit the
-repository name or specify `_all`:
-
-[source,console]
------------------------------------
-GET /_snapshot
------------------------------------
-
-or
-
-[source,console]
------------------------------------
-GET /_snapshot/_all
------------------------------------
-
-[float]
-===== Shared File System Repository
-
-The shared file system repository (`"type": "fs"`) uses the shared file system to store snapshots. In order to register
-the shared file system repository it is necessary to mount the same shared filesystem to the same location on all
-master and data nodes. This location (or one of its parent directories) must be registered in the `path.repo`
-setting on all master and data nodes.
-
-Assuming that the shared filesystem is mounted to `/mount/backups/my_fs_backup_location`, the following setting should
-be added to `elasticsearch.yml` file:
-
-[source,yaml]
---------------
-path.repo: ["/mount/backups", "/mount/longterm_backups"]
---------------
-
-The `path.repo` setting supports Microsoft Windows UNC paths as long as at least server name and share are specified as
-a prefix and back slashes are properly escaped:
-
-[source,yaml]
---------------
-path.repo: ["\\\\MY_SERVER\\Snapshots"]
---------------
-
-After all nodes are restarted, the following command can be used to register the shared file system repository with
-the name `my_fs_backup`:
-
-[source,console]
------------------------------------
-PUT /_snapshot/my_fs_backup
-{
-    "type": "fs",
-    "settings": {
-        "location": "/mount/backups/my_fs_backup_location",
-        "compress": true
-    }
-}
------------------------------------
-// TEST[skip:no access to absolute path]
-
-If the repository location is specified as a relative path this path will be resolved against the first path specified
-in `path.repo`:
-
-[source,console]
------------------------------------
-PUT /_snapshot/my_fs_backup
-{
-    "type": "fs",
-    "settings": {
-        "location": "my_fs_backup_location",
-        "compress": true
-    }
-}
------------------------------------
-// TEST[continued]
-
-The following settings are supported:
-
-[horizontal]
-`location`:: Location of the snapshots. Mandatory.
-`compress`:: Turns on compression of the snapshot files. Compression is applied only to metadata files (index mapping and settings). Data files are not compressed. Defaults to `true`.
-`chunk_size`:: Big files can be broken down into chunks during snapshotting if needed. Specify the chunk size as a value and
-unit, for example: `1GB`, `10MB`, `5KB`, `500B`. Defaults to `null` (unlimited chunk size).
-`max_restore_bytes_per_sec`:: Throttles per node restore rate. Defaults to `40mb` per second.
-`max_snapshot_bytes_per_sec`:: Throttles per node snapshot rate. Defaults to `40mb` per second.
-`readonly`:: Makes repository read-only.  Defaults to `false`.
-
-[float]
-===== Read-only URL Repository
-
-The URL repository (`"type": "url"`) can be used as an alternative read-only way to access data created by the shared file
-system repository. The URL specified in the `url` parameter should point to the root of the shared filesystem repository.
-The following settings are supported:
-
-[horizontal]
-`url`:: Location of the snapshots. Mandatory.
-
-URL Repository supports the following protocols: "http", "https", "ftp", "file" and "jar". URL repositories with `http:`,
-`https:`, and `ftp:` URLs has to be whitelisted by specifying allowed URLs in the `repositories.url.allowed_urls` setting.
-This setting supports wildcards in the place of host, path, query, and fragment. For example:
-
-[source,yaml]
------------------------------------
-repositories.url.allowed_urls: ["http://www.example.org/root/*", "https://*.mydomain.com/*?*#*"]
------------------------------------
-
-URL repositories with `file:` URLs can only point to locations registered in the `path.repo` setting similar to
-shared file system repository.
-
-[float]
-[role="xpack"]
-[testenv="basic"]
-===== Source Only Repository
-
-A source repository enables you to create minimal, source-only snapshots that take up to 50% less space on disk.
-Source only snapshots contain stored fields and index metadata. They do not include index or doc values structures
-and are not searchable when restored. After restoring a source-only snapshot, you must <<docs-reindex,reindex>>
-the data into a new index.
-
-Source repositories delegate to another snapshot repository for storage.
-
-
-[IMPORTANT]
-==================================================
-
-Source only snapshots are only supported if the `_source` field is enabled and no source-filtering is applied.
-When you restore a source only snapshot:
-
- * The restored index is read-only and can only serve `match_all` search or scroll requests to enable reindexing.
-
- * Queries other than `match_all` and `_get` requests are not supported.
-
- * The mapping of the restored index is empty, but the original mapping is available from the types top
-   level `meta` element.
-
-==================================================
-
-When you create a source repository, you must specify the type and name of the delegate repository
-where the snapshots will be stored:
-
-[source,console]
------------------------------------
-PUT _snapshot/my_src_only_repository
-{
-  "type": "source",
-  "settings": {
-    "delegate_type": "fs",
-    "location": "my_backup_location"
-  }
-}
------------------------------------
-// TEST[continued]
-
-[float]
-===== Repository plugins
-
-Other repository backends are available in these official plugins:
-
-* {plugins}/repository-s3.html[repository-s3] for S3 repository support
-* {plugins}/repository-hdfs.html[repository-hdfs] for HDFS repository support in Hadoop environments
-* {plugins}/repository-azure.html[repository-azure] for Azure storage repositories
-* {plugins}/repository-gcs.html[repository-gcs] for Google Cloud Storage repositories
-
-[float]
-===== Repository Verification
-When a repository is registered, it's immediately verified on all master and data nodes to make sure that it is functional
-on all nodes currently present in the cluster. The `verify` parameter can be used to explicitly disable the repository
-verification when registering or updating a repository:
-
-[source,console]
------------------------------------
-PUT /_snapshot/my_unverified_backup?verify=false
-{
-  "type": "fs",
-  "settings": {
-    "location": "my_unverified_backup_location"
-  }
-}
------------------------------------
-// TEST[continued]
-
-The verification process can also be executed manually by running the following command:
-
-[source,console]
------------------------------------
-POST /_snapshot/my_unverified_backup/_verify
------------------------------------
-// TEST[continued]
-
-It returns a list of nodes where repository was successfully verified or an error message if verification process failed.
-
-[float]
-===== Repository Cleanup
-Repositories can over time accumulate data that is not referenced by any existing snapshot. This is a result of the data safety guarantees
-the snapshot functionality provides in failure scenarios during snapshot creation and the decentralized nature of the snapshot creation
-process. This unreferenced data does in no way negatively impact the performance or safety of a snapshot repository but leads to higher
-than necessary storage use. In order to clean up this unreferenced data, users can call the cleanup endpoint for a repository which will
-trigger a complete accounting of the repositories contents and subsequent deletion of all unreferenced data that was found.
-
-[source,console]
------------------------------------
-POST /_snapshot/my_repository/_cleanup
------------------------------------
-// TEST[continued]
-
-The response to a cleanup request looks as follows:
-
-[source,console-result]
---------------------------------------------------
-{
-  "results": {
-    "deleted_bytes": 20,
-    "deleted_blobs": 5
-  }
-}
---------------------------------------------------
-
-Depending on the concrete repository implementation the numbers shown for bytes free as well as the number of blobs removed will either
-be an approximation or an exact result. Any non-zero value for the number of blobs removed implies that unreferenced blobs were found and
-subsequently cleaned up.
-
-Please note that most of the cleanup operations executed by this endpoint are automatically executed when deleting any snapshot from a
-repository. If you regularly delete snapshots, you will in most cases not get any or only minor space savings from using this functionality
-and should lower your frequency of invoking it accordingly.
-
-[float]
-[[snapshots-take-snapshot]]
-=== Snapshot
-
-A repository can contain multiple snapshots of the same cluster. Snapshots are identified by unique names within the
-cluster. A snapshot with the name `snapshot_1` in the repository `my_backup` can be created by executing the following
-command:
-
-[source,console]
------------------------------------
-PUT /_snapshot/my_backup/snapshot_1?wait_for_completion=true
------------------------------------
-// TEST[continued]
-
-The `wait_for_completion` parameter specifies whether or not the request should return immediately after snapshot
-initialization (default) or wait for snapshot completion. During snapshot initialization, information about all
-previous snapshots is loaded into the memory, which means that in large repositories it may take several seconds (or
-even minutes) for this command to return even if the `wait_for_completion` parameter is set to `false`.
-
-By default a snapshot of all open and started indices in the cluster is created. This behavior can be changed by
-specifying the list of indices in the body of the snapshot request.
-
-[source,console]
------------------------------------
-PUT /_snapshot/my_backup/snapshot_2?wait_for_completion=true
-{
-  "indices": "index_1,index_2",
-  "ignore_unavailable": true,
-  "include_global_state": false,
-  "metadata": {
-    "taken_by": "kimchy",
-    "taken_because": "backup before upgrading"
-  }
-}
------------------------------------
-// TEST[continued]
-
-The list of indices that should be included into the snapshot can be specified using the `indices` parameter that
-supports <<multi-index,multi index syntax>>. The snapshot request also supports the
-`ignore_unavailable` option. Setting it to `true` will cause indices that do not exist to be ignored during snapshot
-creation. By default, when `ignore_unavailable` option is not set and an index is missing the snapshot request will fail.
-By setting `include_global_state` to false it's possible to prevent the cluster global state to be stored as part of
-the snapshot. By default, the entire snapshot will fail if one or more indices participating in the snapshot don't have
-all primary shards available. This behaviour can be changed by setting `partial` to `true`.
-
-The `metadata` field can be used to attach arbitrary metadata to the snapshot. This may be a record of who took the snapshot,
-why it was taken, or any other data that might be useful.
-
-Snapshot names can be automatically derived using <<date-math-index-names,date math expressions>>, similarly as when creating
-new indices. Note that special characters need to be URI encoded.
-
-For example, creating a snapshot with the current day in the name, like `snapshot-2018.05.11`, can be achieved with
-the following command:
-
-[source,console]
------------------------------------
-# PUT /_snapshot/my_backup/<snapshot-{now/d}>
-PUT /_snapshot/my_backup/%3Csnapshot-%7Bnow%2Fd%7D%3E
------------------------------------
-// TEST[continued]
-
-
-The index snapshot process is incremental. In the process of making the index snapshot Elasticsearch analyses
-the list of the index files that are already stored in the repository and copies only files that were created or
-changed since the last snapshot. That allows multiple snapshots to be preserved in the repository in a compact form.
-Snapshotting process is executed in non-blocking fashion. All indexing and searching operation can continue to be
-executed against the index that is being snapshotted. However, a snapshot represents the point-in-time view of the index
-at the moment when snapshot was created, so no records that were added to the index after the snapshot process was started
-will be present in the snapshot. The snapshot process starts immediately for the primary shards that has been started
-and are not relocating at the moment. Before version 1.2.0, the snapshot operation fails if the cluster has any relocating or
-initializing primaries of indices participating in the snapshot. Starting with version 1.2.0, Elasticsearch waits for
-relocation or initialization of shards to complete before snapshotting them.
-
-Besides creating a copy of each index the snapshot process can also store global cluster metadata, which includes persistent
-cluster settings and templates. The transient settings and registered snapshot repositories are not stored as part of
-the snapshot.
-
-Only one snapshot process can be executed in the cluster at any time. While snapshot of a particular shard is being
-created this shard cannot be moved to another node, which can interfere with rebalancing process and allocation
-filtering. Elasticsearch will only be able to move a shard to another node (according to the current allocation
-filtering settings and rebalancing algorithm) once the snapshot is finished.
-
-Once a snapshot is created information about this snapshot can be obtained using the following command:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/snapshot_1
------------------------------------
-// TEST[continued]
-
-This command returns basic information about the snapshot including start and end time, version of
-Elasticsearch that created the snapshot, the list of included indices, the current state of the
-snapshot and the list of failures that occurred during the snapshot. The snapshot `state` can be
-
-[horizontal]
-`IN_PROGRESS`::
-
-  The snapshot is currently running.
-
-`SUCCESS`::
-
-  The snapshot finished and all shards were stored successfully.
-
-`FAILED`::
-
-  The snapshot finished with an error and failed to store any data.
-
-`PARTIAL`::
-
-  The global cluster state was stored, but data of at least one shard wasn't stored successfully.
-  The `failure` section in this case should contain more detailed information about shards
-  that were not processed correctly.
-
-`INCOMPATIBLE`::
-
-  The snapshot was created with an old version of Elasticsearch and therefore is incompatible with
-  the current version of the cluster.
-
-
-Similar as for repositories, information about multiple snapshots can be queried in one go, supporting wildcards as well:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/snapshot_*,some_other_snapshot
------------------------------------
-// TEST[continued]
-
-All snapshots currently stored in the repository can be listed using the following command:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/_all
------------------------------------
-// TEST[continued]
-
-The command fails if some of the snapshots are unavailable. The boolean parameter `ignore_unavailable` can be used to
-return all snapshots that are currently available.
-
-Getting all snapshots in the repository can be costly on cloud-based repositories,
-both from a cost and performance perspective.  If the only information required is
-the snapshot names/uuids in the repository and the indices in each snapshot, then
-the optional boolean parameter `verbose` can be set to `false` to execute a more
-performant and cost-effective retrieval of the snapshots in the repository.  Note
-that setting `verbose` to `false` will omit all other information about the snapshot
-such as status information, the number of snapshotted shards, etc.  The default
-value of the `verbose` parameter is `true`.
-
-It is also possible to retrieve snapshots from multiple repositories in one go, for example:
-
-[source,console]
------------------------------------
-GET /_snapshot/_all
-GET /_snapshot/my_backup,my_fs_backup
-GET /_snapshot/my*/snap*
------------------------------------
-// TEST[skip:no my_fs_backup]
-
-A currently running snapshot can be retrieved using the following command:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/_current
------------------------------------
-// TEST[continued]
-
-A snapshot can be deleted from the repository using the following command:
-
-[source,console]
------------------------------------
-DELETE /_snapshot/my_backup/snapshot_2
------------------------------------
-// TEST[continued]
-
-When a snapshot is deleted from a repository, Elasticsearch deletes all files that are associated with the deleted
-snapshot and not used by any other snapshots. If the deleted snapshot operation is executed while the snapshot is being
-created the snapshotting process will be aborted and all files created as part of the snapshotting process will be
-cleaned. Therefore, the delete snapshot operation can be used to cancel long running snapshot operations that were
-started by mistake.
-
-A repository can be unregistered using the following command:
-
-[source,console]
------------------------------------
-DELETE /_snapshot/my_backup
------------------------------------
-// TEST[continued]
-
-When a repository is unregistered, Elasticsearch only removes the reference to the location where the repository is storing
-the snapshots. The snapshots themselves are left untouched and in place.
-
-[float]
-[[restore-snapshot]]
-=== Restore
-
-A snapshot can be restored using the following command:
-
-[source,console]
------------------------------------
-POST /_snapshot/my_backup/snapshot_1/_restore
------------------------------------
-// TEST[continued]
-
-By default, all indices in the snapshot are restored, and the cluster state is
-*not* restored. It's possible to select indices that should be restored as well
-as to allow the global cluster state from being restored by using `indices` and
-`include_global_state` options in the restore request body. The list of indices
-supports <<multi-index,multi index syntax>>. The `rename_pattern`
-and `rename_replacement` options can be also used to rename indices on restore
-using regular expression that supports referencing the original text as
-explained
-http://docs.oracle.com/javase/6/docs/api/java/util/regex/Matcher.html#appendReplacement(java.lang.StringBuffer,%20java.lang.String)[here].
-Set `include_aliases` to `false` to prevent aliases from being restored together
-with associated indices
-
-[source,console]
------------------------------------
-POST /_snapshot/my_backup/snapshot_1/_restore
-{
-  "indices": "index_1,index_2",
-  "ignore_unavailable": true,
-  "include_global_state": true,
-  "rename_pattern": "index_(.+)",
-  "rename_replacement": "restored_index_$1"
-}
------------------------------------
-// TEST[continued]
-
-The restore operation can be performed on a functioning cluster. However, an
-existing index can be only restored if it's <<indices-open-close,closed>> and
-has the same number of shards as the index in the snapshot. The restore
-operation automatically opens restored indices if they were closed and creates
-new indices if they didn't exist in the cluster. If cluster state is restored
-with `include_global_state` (defaults to `false`), the restored templates that
-don't currently exist in the cluster are added and existing templates with the
-same name are replaced by the restored templates. The restored persistent
-settings are added to the existing persistent settings.
-
-[float]
-==== Partial restore
-
-By default, the entire restore operation will fail if one or more indices participating in the operation don't have
-snapshots of all shards available. It can occur if some shards failed to snapshot for example. It is still possible to
-restore such indices by setting `partial` to `true`. Please note, that only successfully snapshotted shards will be
-restored in this case and all missing shards will be recreated empty.
-
-
-[float]
-==== Changing index settings during restore
-
-Most of index settings can be overridden during the restore process. For example, the following command will restore
-the index `index_1` without creating any replicas while switching back to default refresh interval:
-
-[source,console]
------------------------------------
-POST /_snapshot/my_backup/snapshot_1/_restore
-{
-  "indices": "index_1",
-  "index_settings": {
-    "index.number_of_replicas": 0
-  },
-  "ignore_index_settings": [
-    "index.refresh_interval"
-  ]
-}
------------------------------------
-// TEST[continued]
-
-Please note, that some settings such as `index.number_of_shards` cannot be changed during restore operation.
-
-[float]
-==== Restoring to a different cluster
-
-The information stored in a snapshot is not tied to a particular cluster or a cluster name. Therefore it's possible to
-restore a snapshot made from one cluster into another cluster. All that is required is registering the repository
-containing the snapshot in the new cluster and starting the restore process. The new cluster doesn't have to have the
-same size or topology.  However, the version of the new cluster should be the same or newer (only 1 major version newer) than the cluster that was used to create the snapshot.  For example, you can restore a 1.x snapshot to a 2.x cluster, but not a 1.x snapshot to a 5.x cluster.
-
-If the new cluster has a smaller size additional considerations should be made. First of all it's necessary to make sure
-that new cluster have enough capacity to store all indices in the snapshot. It's possible to change indices settings
-during restore to reduce the number of replicas, which can help with restoring snapshots into smaller cluster. It's also
-possible to select only subset of the indices using the `indices` parameter.
-
-If indices in the original cluster were assigned to particular nodes using
-<<shard-allocation-filtering,shard allocation filtering>>, the same rules will be enforced in the new cluster. Therefore
-if the new cluster doesn't contain nodes with appropriate attributes that a restored index can be allocated on, such
-index will not be successfully restored unless these index allocation settings are changed during restore operation.
-
-The restore operation also checks that restored persistent settings are compatible with the current cluster to avoid accidentally
-restoring incompatible settings. If you need to restore a snapshot with incompatible persistent settings, try restoring it without
-the global cluster state.
-
-[float]
-=== Snapshot status
-
-A list of currently running snapshots with their detailed status information can be obtained using the following command:
-
-[source,console]
------------------------------------
-GET /_snapshot/_status
------------------------------------
-// TEST[continued]
-
-In this format, the command will return information about all currently running snapshots. By specifying a repository name, it's possible
-to limit the results to a particular repository:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/_status
------------------------------------
-// TEST[continued]
-
-If both repository name and snapshot id are specified, this command will return detailed status information for the given snapshot even
-if it's not currently running:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/snapshot_1/_status
------------------------------------
-// TEST[continued]
-
-The output looks similar to the following:
-
-[source,console-result]
---------------------------------------------------
-{
-  "snapshots": [
-    {
-      "snapshot": "snapshot_1",
-      "repository": "my_backup",
-      "uuid": "XuBo4l4ISYiVg0nYUen9zg",
-      "state": "SUCCESS",
-      "include_global_state": true,
-      "shards_stats": {
-        "initializing": 0,
-        "started": 0,
-        "finalizing": 0,
-        "done": 5,
-        "failed": 0,
-        "total": 5
-      },
-      "stats": {
-        "incremental": {
-          "file_count": 8,
-          "size_in_bytes": 4704
-        },
-        "processed": {
-          "file_count": 7,
-          "size_in_bytes": 4254
-        },
-        "total": {
-          "file_count": 8,
-          "size_in_bytes": 4704
-        },
-        "start_time_in_millis": 1526280280355,
-        "time_in_millis": 358
-      }
-    }
-  ]
-}
---------------------------------------------------
-
-The output is composed of different sections. The `stats` sub-object provides details on the number and size of files that were
-snapshotted. As snapshots are incremental, copying only the Lucene segments that are not already in the repository,
-the `stats` object contains a `total` section for all the files that are referenced by the snapshot, as well as an `incremental` section
-for those files that actually needed to be copied over as part of the incremental snapshotting. In case of a snapshot that's still
-in progress, there's also a `processed` section that contains information about the files that are in the process of being copied.
-
-Multiple ids are also supported:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/snapshot_1,snapshot_2/_status
------------------------------------
-// TEST[continued]
-
-[float]
-[[monitor-snapshot-restore-progress]]
-=== Monitoring snapshot/restore progress
-
-There are several ways to monitor the progress of the snapshot and restores processes while they are running. Both
-operations support `wait_for_completion` parameter that would block client until the operation is completed. This is
-the simplest method that can be used to get notified about operation completion.
-
-The snapshot operation can be also monitored by periodic calls to the snapshot info:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/snapshot_1
------------------------------------
-// TEST[continued]
-
-Please note that snapshot info operation uses the same resources and thread pool as the snapshot operation. So,
-executing a snapshot info operation while large shards are being snapshotted can cause the snapshot info operation to wait
-for available resources before returning the result. On very large shards the wait time can be significant.
-
-To get more immediate and complete information about snapshots the snapshot status command can be used instead:
-
-[source,console]
------------------------------------
-GET /_snapshot/my_backup/snapshot_1/_status
------------------------------------
-// TEST[continued]
-
-While snapshot info method returns only basic information about the snapshot in progress, the snapshot status returns
-complete breakdown of the current state for each shard participating in the snapshot.
-
-The restore process piggybacks on the standard recovery mechanism of the Elasticsearch. As a result, standard recovery
-monitoring services can be used to monitor the state of restore. When restore operation is executed the cluster
-typically goes into `red` state. It happens because the restore operation starts with "recovering" primary shards of the
-restored indices. During this operation the primary shards become unavailable which manifests itself in the `red` cluster
-state. Once recovery of primary shards is completed Elasticsearch is switching to standard replication process that
-creates the required number of replicas at this moment cluster switches to the `yellow` state. Once all required replicas
-are created, the cluster switches to the `green` states.
-
-The cluster health operation provides only a high level status of the restore process. It's possible to get more
-detailed insight into the current state of the recovery process by using <<indices-recovery, index recovery>> and
-<<cat-recovery, cat recovery>> APIs.
-
-[float]
-=== Stopping currently running snapshot and restore operations
-
-The snapshot and restore framework allows running only one snapshot or one restore operation at a time. If a currently
-running snapshot was executed by mistake, or takes unusually long, it can be terminated using the snapshot delete operation.
-The snapshot delete operation checks if the deleted snapshot is currently running and if it does, the delete operation stops
-that snapshot before deleting the snapshot data from the repository.
-
-[source,console]
------------------------------------
-DELETE /_snapshot/my_backup/snapshot_1
------------------------------------
-// TEST[continued]
-
-The restore operation uses the standard shard recovery mechanism. Therefore, any currently running restore operation can
-be canceled by deleting indices that are being restored. Please note that data for all deleted indices will be removed
-from the cluster as a result of this operation.
-
-[float]
-=== Effect of cluster blocks on snapshot and restore operations
-Many snapshot and restore operations are affected by cluster and index blocks. For example, registering and unregistering
-repositories require write global metadata access. The snapshot operation requires that all indices and their metadata as
-well as the global metadata were readable. The restore operation requires the global metadata to be writable, however
-the index level blocks are ignored during restore because indices are essentially recreated during restore.
-Please note that a repository content is not part of the cluster and therefore cluster blocks don't affect internal
-repository operations such as listing or deleting snapshots from an already registered repository.
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index cf8ab0b29f59f..266fc39aa9dcf 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -300,8 +300,23 @@ See <<ml-get-bucket>>,
 [[ml-results-overall-buckets]]
 <<ml-get-overall-buckets>>.
 
+[role="exclude",id="modules-snapshots"]
+=== Snapshot module
+
+See <<snapshot-restore>>.
+
+[role="exclude",id="restore-snapshot"]
+=== Restore snapshot
+
+See <<snapshots-restore-snapshot>>.
+
+[role="exclude",id="snapshots-repositories"]
+=== Snapshot repositories
+
+See <<snapshots-register-repository>>.
+
 [role="exclude",id="ml-dfa-analysis-objects"]
 === Analysis configuration objects
 
 This page was deleted. 
-See <<put-dfanalytics>>.
\ No newline at end of file
+See <<put-dfanalytics>>.
diff --git a/docs/reference/snapshot-restore/index.asciidoc b/docs/reference/snapshot-restore/index.asciidoc
new file mode 100644
index 0000000000000..3752fd36a6d3b
--- /dev/null
+++ b/docs/reference/snapshot-restore/index.asciidoc
@@ -0,0 +1,90 @@
+[[snapshot-restore]]
+= Snapshot and restore
+
+[partintro]
+--
+
+// tag::snapshot-intro[]
+A _snapshot_ is a backup taken from a running {es} cluster. 
+You can take snapshots of individual indices or of the entire cluster. 
+Snapshots can be stored in either local or remote repositories. 
+Remote repositories can reside on S3, HDFS, Azure, Google Cloud Storage, 
+and other platforms supported by a repository plugin.
+
+Snapshots are incremental: each snapshot of an index only stores data that 
+is not part of an earlier snapshot.  
+This enables you to take frequent snapshots with minimal overhead.
+// end::snapshot-intro[] 
+
+// tag::restore-intro[]
+You can restore snapshots to a running cluster with the <<snapshots-restore-snapshot,restore API>>. 
+By default, all indices in the snapshot are restored. 
+Alternatively, you can restore specific indices or restore the cluster state from a snapshot. 
+When restoring indices, you can modify the index name and selected index settings. 
+// end::restore-intro[]
+
+You must <<snapshots-register-repository, register a snapshot repository>> 
+before you can <<snapshots-take-snapshot, take snapshots>>.
+
+You can use <<getting-started-snapshot-lifecycle-management, snapshot lifecycle management>>
+to automatically take and manage snapshots.
+
+// tag::backup-warning[]
+WARNING: You cannot back up an {es} cluster by simply copying
+the data directories of all of its nodes. {es} may be making changes to
+the contents of its data directories while it is running; copying its data
+directories cannot be expected to capture a consistent picture of their contents.
+If you try to restore a cluster from such a backup, it may fail and report
+corruption and/or missing files. Alternatively, it may appear to have succeeded
+though it silently lost some of its data. The only reliable way to back up a
+cluster is by using the snapshot and restore functionality.
+
+// end::backup-warning[]
+
+[float]
+=== Version compatibility
+
+IMPORTANT: Version compatibility refers to the underlying Lucene index
+compatibility. Follow the <<setup-upgrade,Upgrade documentation>>
+when migrating between versions.
+
+A snapshot contains a copy of the on-disk data structures that make up an
+index. This means that snapshots can only be restored to versions of
+{es} that can read the indices:
+
+* A snapshot of an index created in 6.x can be restored to 7.x.
+* A snapshot of an index created in 5.x can be restored to 6.x.
+* A snapshot of an index created in 2.x can be restored to 5.x.
+* A snapshot of an index created in 1.x can be restored to 2.x.
+
+Conversely, snapshots of indices created in 1.x **cannot** be restored to 5.x
+or 6.x, snapshots of indices created in 2.x **cannot** be restored to 6.x
+or 7.x, and snapshots of indices created in 5.x **cannot** be restored to 7.x
+or 8.x.
+
+Each snapshot can contain indices created in various versions of {es},
+and when restoring a snapshot it must be possible to restore all of the indices
+into the target cluster. If any indices in a snapshot were created in an
+incompatible version, you will not be able restore the snapshot.
+
+IMPORTANT: When backing up your data prior to an upgrade, keep in mind that you
+won't be able to restore snapshots after you upgrade if they contain indices
+created in a version that's incompatible with the upgrade version.
+
+If you end up in a situation where you need to restore a snapshot of an index
+that is incompatible with the version of the cluster you are currently running,
+you can restore it on the latest compatible version and use
+<<reindex-from-remote,reindex-from-remote>> to rebuild the index on the current
+version. Reindexing from remote is only possible if the original index has
+source enabled. Retrieving and reindexing the data can take significantly
+longer than simply restoring a snapshot. If you have a large amount of data, we
+recommend testing the reindex from remote process with a subset of your data to
+understand the time requirements before proceeding.
+
+--
+
+include::register-repository.asciidoc[]
+include::take-snapshot.asciidoc[]
+include::restore-snapshot.asciidoc[]
+include::monitor-snapshot-restore.asciidoc[]
+
diff --git a/docs/reference/snapshot-restore/monitor-snapshot-restore.asciidoc b/docs/reference/snapshot-restore/monitor-snapshot-restore.asciidoc
new file mode 100644
index 0000000000000..326ba9cba93fb
--- /dev/null
+++ b/docs/reference/snapshot-restore/monitor-snapshot-restore.asciidoc
@@ -0,0 +1,89 @@
+[[snapshots-monitor-snapshot-restore]]
+== Monitor snapshot and restore progress
+
+++++
+<titleabbrev>Monitor snapshot and restore</titleabbrev>
+++++
+
+There are several ways to monitor the progress of the snapshot and restore processes while they are running. Both
+operations support `wait_for_completion` parameter that would block client until the operation is completed. This is
+the simplest method that can be used to get notified about operation completion.
+
+////
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_backup
+{
+  "type": "fs",
+  "settings": {
+    "location": "my_backup_location"
+  }
+}
+
+PUT /_snapshot/my_backup/snapshot_1?wait_for_completion=true
+-----------------------------------
+// TESTSETUP
+
+////
+
+The snapshot operation can be also monitored by periodic calls to the snapshot info:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/snapshot_1
+-----------------------------------
+
+Please note that snapshot info operation uses the same resources and thread pool as the snapshot operation. So,
+executing a snapshot info operation while large shards are being snapshotted can cause the snapshot info operation to wait
+for available resources before returning the result. On very large shards the wait time can be significant.
+
+To get more immediate and complete information about snapshots the snapshot status command can be used instead:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/snapshot_1/_status
+-----------------------------------
+// TEST[continued]
+
+While snapshot info method returns only basic information about the snapshot in progress, the snapshot status returns
+complete breakdown of the current state for each shard participating in the snapshot.
+
+The restore process piggybacks on the standard recovery mechanism of the Elasticsearch. As a result, standard recovery
+monitoring services can be used to monitor the state of restore. When restore operation is executed the cluster
+typically goes into `red` state. It happens because the restore operation starts with "recovering" primary shards of the
+restored indices. During this operation the primary shards become unavailable which manifests itself in the `red` cluster
+state. Once recovery of primary shards is completed Elasticsearch is switching to standard replication process that
+creates the required number of replicas at this moment cluster switches to the `yellow` state. Once all required replicas
+are created, the cluster switches to the `green` states.
+
+The cluster health operation provides only a high level status of the restore process. It's possible to get more
+detailed insight into the current state of the recovery process by using <<indices-recovery, index recovery>> and
+<<cat-recovery, cat recovery>> APIs.
+
+[float]
+=== Stop snapshot and restore operations
+
+The snapshot and restore framework allows running only one snapshot or one restore operation at a time. If a currently
+running snapshot was executed by mistake, or takes unusually long, it can be terminated using the snapshot delete operation.
+The snapshot delete operation checks if the deleted snapshot is currently running and if it does, the delete operation stops
+that snapshot before deleting the snapshot data from the repository.
+
+[source,console]
+-----------------------------------
+DELETE /_snapshot/my_backup/snapshot_1
+-----------------------------------
+// TEST[continued]
+
+The restore operation uses the standard shard recovery mechanism. Therefore, any currently running restore operation can
+be canceled by deleting indices that are being restored. Please note that data for all deleted indices will be removed
+from the cluster as a result of this operation.
+
+[float]
+=== Effect of cluster blocks on snapshot and restore 
+
+Many snapshot and restore operations are affected by cluster and index blocks. For example, registering and unregistering
+repositories require write global metadata access. The snapshot operation requires that all indices and their metadata as
+well as the global metadata were readable. The restore operation requires the global metadata to be writable, however
+the index level blocks are ignored during restore because indices are essentially recreated during restore.
+Please note that a repository content is not part of the cluster and therefore cluster blocks don't affect internal
+repository operations such as listing or deleting snapshots from an already registered repository.
\ No newline at end of file
diff --git a/docs/reference/snapshot-restore/register-repository.asciidoc b/docs/reference/snapshot-restore/register-repository.asciidoc
new file mode 100644
index 0000000000000..85f1c40ebeb58
--- /dev/null
+++ b/docs/reference/snapshot-restore/register-repository.asciidoc
@@ -0,0 +1,290 @@
+[[snapshots-register-repository]]
+== Register a snapshot repository
+
+++++
+<titleabbrev>Register repository</titleabbrev>
+++++
+
+You must register a snapshot repository before you can perform snapshot and
+restore operations. We recommend creating a new snapshot repository for each
+major version. The valid repository settings depend on the repository type.
+
+If you register same snapshot repository with multiple clusters, only
+one cluster should have write access to the repository. All other clusters
+connected to that repository should set the repository to `readonly` mode.
+
+IMPORTANT: The snapshot format can change across major versions, so if you have
+clusters on different versions trying to write the same repository, snapshots
+written by one version may not be visible to the other and the repository could
+be corrupted. While setting the repository to `readonly` on all but one of the
+clusters should work with multiple clusters differing by one major version, it
+is not a supported configuration.
+
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_backup
+{
+  "type": "fs",
+  "settings": {
+    "location": "my_backup_location"
+  }
+}
+-----------------------------------
+// TESTSETUP
+
+To retrieve information about a registered repository, use a GET request:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup
+-----------------------------------
+
+which returns:
+
+[source,console-result]
+-----------------------------------
+{
+  "my_backup": {
+    "type": "fs",
+    "settings": {
+      "location": "my_backup_location"
+    }
+  }
+}
+-----------------------------------
+
+To retrieve information about multiple repositories, specify a comma-delimited
+list of repositories. You can also use the * wildcard when
+specifying repository names. For example, the following request retrieves
+information about all of the snapshot repositories that start with `repo` or
+contain `backup`:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/repo*,*backup*
+-----------------------------------
+
+To retrieve information about all registered snapshot repositories, omit the
+repository name or specify `_all`:
+
+[source,console]
+-----------------------------------
+GET /_snapshot
+-----------------------------------
+
+or
+
+[source,console]
+-----------------------------------
+GET /_snapshot/_all
+-----------------------------------
+
+[float]
+[[snapshots-filesystem-repository]]
+=== Shared file system repository
+
+The shared file system repository (`"type": "fs"`) uses the shared file system to store snapshots. In order to register
+the shared file system repository it is necessary to mount the same shared filesystem to the same location on all
+master and data nodes. This location (or one of its parent directories) must be registered in the `path.repo`
+setting on all master and data nodes.
+
+Assuming that the shared filesystem is mounted to `/mount/backups/my_fs_backup_location`, the following setting should
+be added to `elasticsearch.yml` file:
+
+[source,yaml]
+--------------
+path.repo: ["/mount/backups", "/mount/longterm_backups"]
+--------------
+
+The `path.repo` setting supports Microsoft Windows UNC paths as long as at least server name and share are specified as
+a prefix and back slashes are properly escaped:
+
+[source,yaml]
+--------------
+path.repo: ["\\\\MY_SERVER\\Snapshots"]
+--------------
+
+After all nodes are restarted, the following command can be used to register the shared file system repository with
+the name `my_fs_backup`:
+
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_fs_backup
+{
+    "type": "fs",
+    "settings": {
+        "location": "/mount/backups/my_fs_backup_location",
+        "compress": true
+    }
+}
+-----------------------------------
+// TEST[skip:no access to absolute path]
+
+If the repository location is specified as a relative path this path will be resolved against the first path specified
+in `path.repo`:
+
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_fs_backup
+{
+    "type": "fs",
+    "settings": {
+        "location": "my_fs_backup_location",
+        "compress": true
+    }
+}
+-----------------------------------
+// TEST[continued]
+
+The following settings are supported:
+
+[horizontal]
+`location`:: Location of the snapshots. Mandatory.
+`compress`:: Turns on compression of the snapshot files. Compression is applied only to metadata files (index mapping and settings). Data files are not compressed. Defaults to `true`.
+`chunk_size`:: Big files can be broken down into chunks during snapshotting if needed. Specify the chunk size as a value and
+unit, for example: `1GB`, `10MB`, `5KB`, `500B`. Defaults to `null` (unlimited chunk size).
+`max_restore_bytes_per_sec`:: Throttles per node restore rate. Defaults to `40mb` per second.
+`max_snapshot_bytes_per_sec`:: Throttles per node snapshot rate. Defaults to `40mb` per second.
+`readonly`:: Makes repository read-only.  Defaults to `false`.
+
+[float]
+[[snapshots-read-only-repository]]
+=== Read-only URL repository
+
+The URL repository (`"type": "url"`) can be used as an alternative read-only way to access data created by the shared file
+system repository. The URL specified in the `url` parameter should point to the root of the shared filesystem repository.
+The following settings are supported:
+
+[horizontal]
+`url`:: Location of the snapshots. Mandatory.
+
+URL Repository supports the following protocols: "http", "https", "ftp", "file" and "jar". URL repositories with `http:`,
+`https:`, and `ftp:` URLs has to be whitelisted by specifying allowed URLs in the `repositories.url.allowed_urls` setting.
+This setting supports wildcards in the place of host, path, query, and fragment. For example:
+
+[source,yaml]
+-----------------------------------
+repositories.url.allowed_urls: ["http://www.example.org/root/*", "https://*.mydomain.com/*?*#*"]
+-----------------------------------
+
+URL repositories with `file:` URLs can only point to locations registered in the `path.repo` setting similar to
+shared file system repository.
+
+[float]
+[role="xpack"]
+[testenv="basic"]
+[[snapshots-source-only-repository]]
+=== Source only repository
+
+A source repository enables you to create minimal, source-only snapshots that take up to 50% less space on disk.
+Source only snapshots contain stored fields and index metadata. They do not include index or doc values structures
+and are not searchable when restored. After restoring a source-only snapshot, you must <<docs-reindex,reindex>>
+the data into a new index.
+
+Source repositories delegate to another snapshot repository for storage.
+
+[IMPORTANT]
+==================================================
+
+Source only snapshots are only supported if the `_source` field is enabled and no source-filtering is applied.
+When you restore a source only snapshot:
+
+ * The restored index is read-only and can only serve `match_all` search or scroll requests to enable reindexing.
+
+ * Queries other than `match_all` and `_get` requests are not supported.
+
+ * The mapping of the restored index is empty, but the original mapping is available from the types top
+   level `meta` element.
+
+==================================================
+
+When you create a source repository, you must specify the type and name of the delegate repository
+where the snapshots will be stored:
+
+[source,console]
+-----------------------------------
+PUT _snapshot/my_src_only_repository
+{
+  "type": "source",
+  "settings": {
+    "delegate_type": "fs",
+    "location": "my_backup_location"
+  }
+}
+-----------------------------------
+// TEST[continued]
+
+[float]
+[[snapshots-repository-plugins]]
+=== Repository plugins
+
+Other repository backends are available in these official plugins:
+
+* {plugins}/repository-s3.html[repository-s3] for S3 repository support
+* {plugins}/repository-hdfs.html[repository-hdfs] for HDFS repository support in Hadoop environments
+* {plugins}/repository-azure.html[repository-azure] for Azure storage repositories
+* {plugins}/repository-gcs.html[repository-gcs] for Google Cloud Storage repositories
+
+[float]
+[[snapshots-repository-verification]]
+=== Repository verification
+When a repository is registered, it's immediately verified on all master and data nodes to make sure that it is functional
+on all nodes currently present in the cluster. The `verify` parameter can be used to explicitly disable the repository
+verification when registering or updating a repository:
+
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_unverified_backup?verify=false
+{
+  "type": "fs",
+  "settings": {
+    "location": "my_unverified_backup_location"
+  }
+}
+-----------------------------------
+// TEST[continued]
+
+The verification process can also be executed manually by running the following command:
+
+[source,console]
+-----------------------------------
+POST /_snapshot/my_unverified_backup/_verify
+-----------------------------------
+// TEST[continued]
+
+It returns a list of nodes where repository was successfully verified or an error message if verification process failed.
+
+[float]
+[[snapshots-repository-cleanup]]
+=== Repository cleanup
+Repositories can over time accumulate data that is not referenced by any existing snapshot. This is a result of the data safety guarantees
+the snapshot functionality provides in failure scenarios during snapshot creation and the decentralized nature of the snapshot creation
+process. This unreferenced data does in no way negatively impact the performance or safety of a snapshot repository but leads to higher
+than necessary storage use. In order to clean up this unreferenced data, users can call the cleanup endpoint for a repository which will
+trigger a complete accounting of the repositories contents and subsequent deletion of all unreferenced data that was found.
+
+[source,console]
+-----------------------------------
+POST /_snapshot/my_repository/_cleanup
+-----------------------------------
+// TEST[continued]
+
+The response to a cleanup request looks as follows:
+
+[source,console-result]
+--------------------------------------------------
+{
+  "results": {
+    "deleted_bytes": 20,
+    "deleted_blobs": 5
+  }
+}
+--------------------------------------------------
+
+Depending on the concrete repository implementation the numbers shown for bytes free as well as the number of blobs removed will either
+be an approximation or an exact result. Any non-zero value for the number of blobs removed implies that unreferenced blobs were found and
+subsequently cleaned up.
+
+Please note that most of the cleanup operations executed by this endpoint are automatically executed when deleting any snapshot from a
+repository. If you regularly delete snapshots, you will in most cases not get any or only minor space savings from using this functionality
+and should lower your frequency of invoking it accordingly.
diff --git a/docs/reference/snapshot-restore/restore-snapshot.asciidoc b/docs/reference/snapshot-restore/restore-snapshot.asciidoc
new file mode 100644
index 0000000000000..1e1d8b914bb63
--- /dev/null
+++ b/docs/reference/snapshot-restore/restore-snapshot.asciidoc
@@ -0,0 +1,205 @@
+[[snapshots-restore-snapshot]]
+== Restore indices from a snapshot
+
+++++
+<titleabbrev>Restore a snapshot</titleabbrev>
+++++
+
+////
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_backup
+{
+  "type": "fs",
+  "settings": {
+    "location": "my_backup_location"
+  }
+}
+
+PUT /_snapshot/my_backup/snapshot_1?wait_for_completion=true
+-----------------------------------
+// TESTSETUP
+
+////
+
+A snapshot can be restored using the following command:
+
+[source,console]
+-----------------------------------
+POST /_snapshot/my_backup/snapshot_1/_restore
+-----------------------------------
+
+By default, all indices in the snapshot are restored, and the cluster state is
+*not* restored. It's possible to select indices that should be restored as well
+as to allow the global cluster state from being restored by using `indices` and
+`include_global_state` options in the restore request body. The list of indices
+supports <<multi-index,multi index syntax>>. The `rename_pattern`
+and `rename_replacement` options can be also used to rename indices on restore
+using regular expression that supports referencing the original text as
+explained
+http://docs.oracle.com/javase/6/docs/api/java/util/regex/Matcher.html#appendReplacement(java.lang.StringBuffer,%20java.lang.String)[here].
+Set `include_aliases` to `false` to prevent aliases from being restored together
+with associated indices
+
+[source,console]
+-----------------------------------
+POST /_snapshot/my_backup/snapshot_1/_restore
+{
+  "indices": "index_1,index_2",
+  "ignore_unavailable": true,
+  "include_global_state": true,
+  "rename_pattern": "index_(.+)",
+  "rename_replacement": "restored_index_$1"
+}
+-----------------------------------
+// TEST[continued]
+
+The restore operation can be performed on a functioning cluster. However, an
+existing index can be only restored if it's <<indices-open-close,closed>> and
+has the same number of shards as the index in the snapshot. The restore
+operation automatically opens restored indices if they were closed and creates
+new indices if they didn't exist in the cluster. If cluster state is restored
+with `include_global_state` (defaults to `false`), the restored templates that
+don't currently exist in the cluster are added and existing templates with the
+same name are replaced by the restored templates. The restored persistent
+settings are added to the existing persistent settings.
+
+[float]
+=== Partial restore
+
+By default, the entire restore operation will fail if one or more indices participating in the operation don't have
+snapshots of all shards available. It can occur if some shards failed to snapshot for example. It is still possible to
+restore such indices by setting `partial` to `true`. Please note, that only successfully snapshotted shards will be
+restored in this case and all missing shards will be recreated empty.
+
+
+[float]
+=== Changing index settings during restore
+
+Most of index settings can be overridden during the restore process. For example, the following command will restore
+the index `index_1` without creating any replicas while switching back to default refresh interval:
+
+[source,console]
+-----------------------------------
+POST /_snapshot/my_backup/snapshot_1/_restore
+{
+  "indices": "index_1",
+  "ignore_unavailable": true,
+  "index_settings": {
+    "index.number_of_replicas": 0
+  },
+  "ignore_index_settings": [
+    "index.refresh_interval"
+  ]
+}
+-----------------------------------
+// TEST[continued]
+
+Please note, that some settings such as `index.number_of_shards` cannot be changed during restore operation.
+
+[float]
+=== Restoring to a different cluster
+
+The information stored in a snapshot is not tied to a particular cluster or a cluster name. Therefore it's possible to
+restore a snapshot made from one cluster into another cluster. All that is required is registering the repository
+containing the snapshot in the new cluster and starting the restore process. The new cluster doesn't have to have the
+same size or topology.  However, the version of the new cluster should be the same or newer (only 1 major version newer) than the cluster that was used to create the snapshot.  For example, you can restore a 1.x snapshot to a 2.x cluster, but not a 1.x snapshot to a 5.x cluster.
+
+If the new cluster has a smaller size additional considerations should be made. First of all it's necessary to make sure
+that new cluster have enough capacity to store all indices in the snapshot. It's possible to change indices settings
+during restore to reduce the number of replicas, which can help with restoring snapshots into smaller cluster. It's also
+possible to select only subset of the indices using the `indices` parameter.
+
+If indices in the original cluster were assigned to particular nodes using
+<<shard-allocation-filtering,shard allocation filtering>>, the same rules will be enforced in the new cluster. Therefore
+if the new cluster doesn't contain nodes with appropriate attributes that a restored index can be allocated on, such
+index will not be successfully restored unless these index allocation settings are changed during restore operation.
+
+The restore operation also checks that restored persistent settings are compatible with the current cluster to avoid accidentally
+restoring incompatible settings. If you need to restore a snapshot with incompatible persistent settings, try restoring it without
+the global cluster state.
+
+[float]
+=== Snapshot status
+
+A list of currently running snapshots with their detailed status information can be obtained using the following command:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/_status
+-----------------------------------
+// TEST[continued]
+
+In this format, the command will return information about all currently running snapshots. By specifying a repository name, it's possible
+to limit the results to a particular repository:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/_status
+-----------------------------------
+// TEST[continued]
+
+If both repository name and snapshot id are specified, this command will return detailed status information for the given snapshot even
+if it's not currently running:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/snapshot_1/_status
+-----------------------------------
+// TEST[continued]
+
+The output looks similar to the following:
+
+[source,console-result]
+--------------------------------------------------
+{
+  "snapshots": [
+    {
+      "snapshot": "snapshot_1",
+      "repository": "my_backup",
+      "uuid": "XuBo4l4ISYiVg0nYUen9zg",
+      "state": "SUCCESS",
+      "include_global_state": true,
+      "shards_stats": {
+        "initializing": 0,
+        "started": 0,
+        "finalizing": 0,
+        "done": 5,
+        "failed": 0,
+        "total": 5
+      },
+      "stats": {
+        "incremental": {
+          "file_count": 8,
+          "size_in_bytes": 4704
+        },
+        "processed": {
+          "file_count": 7,
+          "size_in_bytes": 4254
+        },
+        "total": {
+          "file_count": 8,
+          "size_in_bytes": 4704
+        },
+        "start_time_in_millis": 1526280280355,
+        "time_in_millis": 358
+      }
+    }
+  ]
+}
+--------------------------------------------------
+// TESTRESPONSE[skip: No snapshot status to validate.]
+
+The output is composed of different sections. The `stats` sub-object provides details on the number and size of files that were
+snapshotted. As snapshots are incremental, copying only the Lucene segments that are not already in the repository,
+the `stats` object contains a `total` section for all the files that are referenced by the snapshot, as well as an `incremental` section
+for those files that actually needed to be copied over as part of the incremental snapshotting. In case of a snapshot that's still
+in progress, there's also a `processed` section that contains information about the files that are in the process of being copied.
+
+Multiple ids are also supported:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/snapshot_1,snapshot_2/_status
+-----------------------------------
+// TEST[skip: no snapshot_2 to get]
diff --git a/docs/reference/snapshot-restore/take-snapshot.asciidoc b/docs/reference/snapshot-restore/take-snapshot.asciidoc
new file mode 100644
index 0000000000000..20c2b4837306b
--- /dev/null
+++ b/docs/reference/snapshot-restore/take-snapshot.asciidoc
@@ -0,0 +1,207 @@
+[[snapshots-take-snapshot]]
+== Take a snapshot of one or more indices
+
+++++
+<titleabbrev>Take a snapshot</titleabbrev>
+++++
+
+A repository can contain multiple snapshots of the same cluster. Snapshots are identified by unique names within the
+cluster. A snapshot with the name `snapshot_1` in the repository `my_backup` can be created by executing the following
+command:
+
+////
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_backup
+{
+  "type": "fs",
+  "settings": {
+    "location": "my_backup_location"
+  }
+}
+-----------------------------------
+// TESTSETUP
+////
+
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_backup/snapshot_1?wait_for_completion=true
+-----------------------------------
+
+The `wait_for_completion` parameter specifies whether or not the request should return immediately after snapshot
+initialization (default) or wait for snapshot completion. During snapshot initialization, information about all
+previous snapshots is loaded into the memory, which means that in large repositories it may take several seconds (or
+even minutes) for this command to return even if the `wait_for_completion` parameter is set to `false`.
+
+By default a snapshot of all open and started indices in the cluster is created. This behavior can be changed by
+specifying the list of indices in the body of the snapshot request.
+
+[source,console]
+-----------------------------------
+PUT /_snapshot/my_backup/snapshot_2?wait_for_completion=true
+{
+  "indices": "index_1,index_2",
+  "ignore_unavailable": true,
+  "include_global_state": false,
+  "metadata": {
+    "taken_by": "kimchy",
+    "taken_because": "backup before upgrading"
+  }
+}
+-----------------------------------
+// TEST[skip:cannot complete subsequent snapshot]
+
+The list of indices that should be included into the snapshot can be specified using the `indices` parameter that
+supports <<multi-index,multi index syntax>>. The snapshot request also supports the
+`ignore_unavailable` option. Setting it to `true` will cause indices that do not exist to be ignored during snapshot
+creation. By default, when `ignore_unavailable` option is not set and an index is missing the snapshot request will fail.
+By setting `include_global_state` to false it's possible to prevent the cluster global state to be stored as part of
+the snapshot. By default, the entire snapshot will fail if one or more indices participating in the snapshot don't have
+all primary shards available. This behaviour can be changed by setting `partial` to `true`.
+
+The `metadata` field can be used to attach arbitrary metadata to the snapshot. This may be a record of who took the snapshot,
+why it was taken, or any other data that might be useful.
+
+Snapshot names can be automatically derived using <<date-math-index-names,date math expressions>>, similarly as when creating
+new indices. Note that special characters need to be URI encoded.
+
+For example, creating a snapshot with the current day in the name, like `snapshot-2018.05.11`, can be achieved with
+the following command:
+
+[source,console]
+-----------------------------------
+# PUT /_snapshot/my_backup/<snapshot-{now/d}>
+PUT /_snapshot/my_backup/%3Csnapshot-%7Bnow%2Fd%7D%3E
+-----------------------------------
+// TEST[continued]
+
+
+The index snapshot process is incremental. In the process of making the index snapshot Elasticsearch analyses
+the list of the index files that are already stored in the repository and copies only files that were created or
+changed since the last snapshot. That allows multiple snapshots to be preserved in the repository in a compact form.
+Snapshotting process is executed in non-blocking fashion. All indexing and searching operation can continue to be
+executed against the index that is being snapshotted. However, a snapshot represents the point-in-time view of the index
+at the moment when snapshot was created, so no records that were added to the index after the snapshot process was started
+will be present in the snapshot. The snapshot process starts immediately for the primary shards that has been started
+and are not relocating at the moment. Before version 1.2.0, the snapshot operation fails if the cluster has any relocating or
+initializing primaries of indices participating in the snapshot. Starting with version 1.2.0, Elasticsearch waits for
+relocation or initialization of shards to complete before snapshotting them.
+
+Besides creating a copy of each index the snapshot process can also store global cluster metadata, which includes persistent
+cluster settings and templates. The transient settings and registered snapshot repositories are not stored as part of
+the snapshot.
+
+Only one snapshot process can be executed in the cluster at any time. While snapshot of a particular shard is being
+created this shard cannot be moved to another node, which can interfere with rebalancing process and allocation
+filtering. Elasticsearch will only be able to move a shard to another node (according to the current allocation
+filtering settings and rebalancing algorithm) once the snapshot is finished.
+
+Once a snapshot is created information about this snapshot can be obtained using the following command:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/snapshot_1
+-----------------------------------
+// TEST[continued]
+
+This command returns basic information about the snapshot including start and end time, version of
+Elasticsearch that created the snapshot, the list of included indices, the current state of the
+snapshot and the list of failures that occurred during the snapshot. The snapshot `state` can be
+
+[horizontal]
+`IN_PROGRESS`::
+
+  The snapshot is currently running.
+
+`SUCCESS`::
+
+  The snapshot finished and all shards were stored successfully.
+
+`FAILED`::
+
+  The snapshot finished with an error and failed to store any data.
+
+`PARTIAL`::
+
+  The global cluster state was stored, but data of at least one shard wasn't stored successfully.
+  The `failure` section in this case should contain more detailed information about shards
+  that were not processed correctly.
+
+`INCOMPATIBLE`::
+
+  The snapshot was created with an old version of Elasticsearch and therefore is incompatible with
+  the current version of the cluster.
+
+
+Similar as for repositories, information about multiple snapshots can be queried in one go, supporting wildcards as well:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/snapshot_*,some_other_snapshot
+-----------------------------------
+// TEST[continued]
+
+All snapshots currently stored in the repository can be listed using the following command:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/_all
+-----------------------------------
+// TEST[continued]
+
+The command fails if some of the snapshots are unavailable. The boolean parameter `ignore_unavailable` can be used to
+return all snapshots that are currently available.
+
+Getting all snapshots in the repository can be costly on cloud-based repositories,
+both from a cost and performance perspective.  If the only information required is
+the snapshot names/uuids in the repository and the indices in each snapshot, then
+the optional boolean parameter `verbose` can be set to `false` to execute a more
+performant and cost-effective retrieval of the snapshots in the repository.  Note
+that setting `verbose` to `false` will omit all other information about the snapshot
+such as status information, the number of snapshotted shards, etc.  The default
+value of the `verbose` parameter is `true`.
+
+It is also possible to retrieve snapshots from multiple repositories in one go, for example:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/_all
+GET /_snapshot/my_backup,my_fs_backup
+GET /_snapshot/my*/snap*
+-----------------------------------
+// TEST[skip:no my_fs_backup]
+
+A currently running snapshot can be retrieved using the following command:
+
+[source,console]
+-----------------------------------
+GET /_snapshot/my_backup/_current
+-----------------------------------
+// TEST[continued]
+
+A snapshot can be deleted from the repository using the following command:
+
+[source,console]
+-----------------------------------
+DELETE /_snapshot/my_backup/snapshot_2
+-----------------------------------
+// TEST[continued]
+
+When a snapshot is deleted from a repository, Elasticsearch deletes all files that are associated with the deleted
+snapshot and not used by any other snapshots. If the deleted snapshot operation is executed while the snapshot is being
+created the snapshotting process will be aborted and all files created as part of the snapshotting process will be
+cleaned. Therefore, the delete snapshot operation can be used to cancel long running snapshot operations that were
+started by mistake.
+
+A repository can be unregistered using the following command:
+
+[source,console]
+-----------------------------------
+DELETE /_snapshot/my_backup
+-----------------------------------
+// TEST[continued]
+
+When a repository is unregistered, Elasticsearch only removes the reference to the location where the repository is storing
+the snapshots. The snapshots themselves are left untouched and in place.
+
+

From 8f48f79eac182adefd5b1ccdc58124e5a926826a Mon Sep 17 00:00:00 2001
From: Julie Tibshirani <julie.tibshirani@elastic.co>
Date: Thu, 9 Jan 2020 17:07:58 -0800
Subject: [PATCH 492/686] Remove the 'template' field in index templates.
 (#49460)

The `template` field was deprecated in 6.0 in favor of `index_patterns`, and can
now be removed.

Relates to #21009.
---
 .../client/indices/PutIndexTemplateRequest.java     |  8 ++------
 .../migration/migrate_8_0/indices.asciidoc          |  7 +++++++
 .../template/put/PutIndexTemplateRequest.java       | 10 ++--------
 .../admin/indices/RestPutIndexTemplateAction.java   | 13 +------------
 .../indices/template/SimpleIndexTemplateIT.java     |  2 +-
 5 files changed, 13 insertions(+), 27 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/indices/PutIndexTemplateRequest.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/indices/PutIndexTemplateRequest.java
index 2d03a08d2d42c..c5be421ed6fb4 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/indices/PutIndexTemplateRequest.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/indices/PutIndexTemplateRequest.java
@@ -278,18 +278,14 @@ public PutIndexTemplateRequest source(Map<String, Object> templateSource) {
         Map<String, Object> source = templateSource;
         for (Map.Entry<String, Object> entry : source.entrySet()) {
             String name = entry.getKey();
-            if (name.equals("template")) {
-                if(entry.getValue() instanceof String) {
-                    patterns(Collections.singletonList((String) entry.getValue()));
-                }
-            } else if (name.equals("index_patterns")) {
+            if (name.equals("index_patterns")) {
                 if(entry.getValue() instanceof String) {
                     patterns(Collections.singletonList((String) entry.getValue()));
                 } else if (entry.getValue() instanceof List) {
                     List<String> elements = ((List<?>) entry.getValue()).stream().map(Object::toString).collect(Collectors.toList());
                     patterns(elements);
                 } else {
-                    throw new IllegalArgumentException("Malformed [template] value, should be a string or a list of strings");
+                    throw new IllegalArgumentException("Malformed [index_patterns] value, should be a string or a list of strings");
                 }
             } else if (name.equals("order")) {
                 order(XContentMapValues.nodeIntegerValue(entry.getValue(), order()));
diff --git a/docs/reference/migration/migrate_8_0/indices.asciidoc b/docs/reference/migration/migrate_8_0/indices.asciidoc
index 49a72352e6354..5b1d5a10df090 100644
--- a/docs/reference/migration/migrate_8_0/indices.asciidoc
+++ b/docs/reference/migration/migrate_8_0/indices.asciidoc
@@ -20,3 +20,10 @@ The `index.force_memory_term_dictionary` setting was introduced in 7.0 as a
 temporary measure to allow users to opt-out of the optimization that leaves the
 term dictionary on disk when appropriate. This optimization is now mandatory
 and the setting is removed.
+
+[float]
+==== Remove support for `template` in put index template requests
+
+In 6.0, we deprecated the `template` field in put index template requests
+in favor of using `index_patterns`. Support for the `template` field is now
+removed in 8.0.
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
index 0703d567fd024..d1c4c70961136 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
@@ -323,14 +323,8 @@ public PutIndexTemplateRequest source(Map<String, Object> templateSource) {
         Map<String, Object> source = templateSource;
         for (Map.Entry<String, Object> entry : source.entrySet()) {
             String name = entry.getKey();
-            if (name.equals("template")) {
-                // This is needed to allow for bwc (beats, logstash) with pre-5.0 templates (#21009)
-                if(entry.getValue() instanceof String) {
-                    deprecationLogger.deprecated("Deprecated field [template] used, replaced by [index_patterns]");
-                    patterns(Collections.singletonList((String) entry.getValue()));
-                }
-            } else if (name.equals("index_patterns")) {
-                if(entry.getValue() instanceof String) {
+            if (name.equals("index_patterns")) {
+                if (entry.getValue() instanceof String) {
                     patterns(Collections.singletonList((String) entry.getValue()));
                 } else if (entry.getValue() instanceof List) {
                     List<String> elements = ((List<?>) entry.getValue()).stream().map(Object::toString).collect(Collectors.toList());
diff --git a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestPutIndexTemplateAction.java b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestPutIndexTemplateAction.java
index 7fe68839d068b..68e62ac3c684f 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestPutIndexTemplateAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestPutIndexTemplateAction.java
@@ -19,11 +19,9 @@
 
 package org.elasticsearch.rest.action.admin.indices;
 
-import org.apache.logging.log4j.LogManager;
 import org.elasticsearch.action.admin.indices.template.put.PutIndexTemplateRequest;
 import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.rest.BaseRestHandler;
 import org.elasticsearch.rest.RestController;
@@ -32,14 +30,10 @@
 
 import java.io.IOException;
 import java.util.Arrays;
-import java.util.Collections;
 import java.util.Map;
 
 public class RestPutIndexTemplateAction extends BaseRestHandler {
 
-    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(
-            LogManager.getLogger(RestPutIndexTemplateAction.class));
-
     public RestPutIndexTemplateAction(RestController controller) {
         controller.registerHandler(RestRequest.Method.PUT, "/_template/{name}", this);
         controller.registerHandler(RestRequest.Method.POST, "/_template/{name}", this);
@@ -54,12 +48,7 @@ public String getName() {
     public RestChannelConsumer prepareRequest(final RestRequest request, final NodeClient client) throws IOException {
 
         PutIndexTemplateRequest putRequest = new PutIndexTemplateRequest(request.param("name"));
-        if (request.hasParam("template")) {
-            deprecationLogger.deprecated("Deprecated parameter[template] used, replaced by [index_patterns]");
-            putRequest.patterns(Collections.singletonList(request.param("template")));
-        } else {
-            putRequest.patterns(Arrays.asList(request.paramAsStringArray("index_patterns", Strings.EMPTY_ARRAY)));
-        }
+        putRequest.patterns(Arrays.asList(request.paramAsStringArray("index_patterns", Strings.EMPTY_ARRAY)));
         putRequest.order(request.paramAsInt("order", putRequest.order()));
         putRequest.masterNodeTimeout(request.paramAsTime("master_timeout", putRequest.masterNodeTimeout()));
         putRequest.create(request.paramAsBoolean("create", false));
diff --git a/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java b/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
index df30def2d0007..a3c3c1e25001f 100644
--- a/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
@@ -433,7 +433,7 @@ public void testIndexTemplateWithAliases() throws Exception {
     public void testIndexTemplateWithAliasesInSource() {
         client().admin().indices().preparePutTemplate("template_1")
                 .setSource(new BytesArray("{\n" +
-                        "    \"template\" : \"*\",\n" +
+                        "    \"index_patterns\" : \"*\",\n" +
                         "    \"aliases\" : {\n" +
                         "        \"my_alias\" : {\n" +
                         "            \"filter\" : {\n" +

From 833448746450aa4493e3562187972d503f020f20 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 9 Jan 2020 21:40:56 -0800
Subject: [PATCH 493/686] Review comments

---
 .../xpack/core/ilm/CloseIndexStep.java        |  9 +++++++--
 .../xpack/core/ilm/ForceMergeAction.java      | 19 +++++++++++++------
 .../xpack/core/ilm/OpenIndexStep.java         | 11 +++++++++--
 .../xpack/core/ilm/WaitForIndexColorStep.java |  7 ++++++-
 .../xpack/core/ilm/ForceMergeActionTests.java |  2 +-
 .../ilm/TimeseriesLifecycleTypeTests.java     |  3 +--
 .../ilm/TimeSeriesLifecycleActionsIT.java     |  2 +-
 7 files changed, 38 insertions(+), 15 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index 994ddf2590b58..c5bdb620ddcca 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -31,7 +31,9 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             CloseIndexRequest request = new CloseIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
                 .close(request, ActionListener.wrap(closeIndexResponse -> {
-                    assert closeIndexResponse.isAcknowledged() : "close index response is not acknowledged";
+                    if (closeIndexResponse.isAcknowledged() == false) {
+                       new ErrorStep(getKey());
+                    }
                     listener.onResponse(true);
                 }, listener::onFailure));
         }
@@ -40,5 +42,8 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
         }
     }
 
-
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index c3c0288c9b315..502ad7722d105 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -62,7 +62,7 @@ public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
         }
         this.maxNumSegments = maxNumSegments;
         if (codec != null && CodecService.BEST_COMPRESSION_CODEC.equals(codec.getName()) == false) {
-            throw new IllegalArgumentException("Compression type not found instead " + codec.getName() + " is used.");
+            throw new IllegalArgumentException("unknown index codec: [" + codec.getName() + "]");
         }
         this.codec = codec;
     }
@@ -70,7 +70,12 @@ public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
         if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
-            this.codec = Codec.forName(in.readOptionalString());
+            String codecStr = in.readOptionalString();
+            if (codecStr == null) {
+                this.codec = null;
+            } else {
+                this.codec = Codec.forName(codecStr);
+            }
         } else {
             this.codec = null;
         }
@@ -88,9 +93,11 @@ public Codec getCodec() {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
         if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
-            out.writeOptionalString(codec.getName());
-        } else {
-            out.writeString(null);
+            if (codec == null) {
+                out.writeOptionalString(null);
+            } else {
+                out.writeOptionalString(codec.getName());
+            }
         }
     }
 
@@ -170,7 +177,7 @@ public boolean equals(Object obj) {
         }
         ForceMergeAction other = (ForceMergeAction) obj;
         return Objects.equals(maxNumSegments, other.maxNumSegments)
-            && ((codec == null && other.codec == null) || Objects.equals(codec, other.codec));
+            && Objects.equals(codec, other.codec);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index 907750e212332..86e58815712d7 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -32,8 +32,10 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             OpenIndexRequest request = new OpenIndexRequest(indexMetaData.getIndex().getName());
             getClient().admin().indices()
                 .open(request,
-                    ActionListener.wrap(openIndexResponse-> {
-                        assert openIndexResponse.isAcknowledged() : "open Index response is not acknowledged";
+                    ActionListener.wrap(openIndexResponse -> {
+                        if (openIndexResponse.isAcknowledged() == false) {
+                            new ErrorStep(getKey());
+                        }
                         listener.onResponse(true);
                     }, listener::onFailure));
 
@@ -41,4 +43,9 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             listener.onResponse(true);
         }
     }
+
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
index bfaf6ab5bfcb1..fd02a69999c73 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
@@ -27,7 +27,7 @@
 
 class WaitForIndexColorStep extends ClusterStateWaitStep {
 
-    static final String NAME = "wait-for-index-color-step";
+    static final String NAME = "wait-for-index-color";
 
     private final ClusterHealthStatus color;
 
@@ -79,6 +79,11 @@ public Result isConditionMet(Index index, ClusterState clusterState) {
         return result;
     }
 
+    @Override
+    public boolean isRetryable() {
+        return true;
+    }
+
     private Result waitForRed(IndexRoutingTable indexRoutingTable) {
         if (indexRoutingTable == null) {
             return new Result(true, new Info("index is red"));
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index a81a6e1350da6..e581237177b17 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -40,7 +40,7 @@ static ForceMergeAction randomInstance() {
     }
 
     static Codec createRandomCompressionSettings() {
-        if(randomBoolean()) {
+        if (randomBoolean()) {
             return null;
         }
         return Codec.forName(CodecService.BEST_COMPRESSION_CODEC);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
index 822b41f906f54..ddc0837ed2c43 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/TimeseriesLifecycleTypeTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
-import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.test.ESTestCase;
@@ -35,8 +34,8 @@ public class TimeseriesLifecycleTypeTests extends ESTestCase {
     private static final AllocateAction TEST_ALLOCATE_ACTION =
         new AllocateAction(2, Collections.singletonMap("node", "node1"),null, null);
     private static final DeleteAction TEST_DELETE_ACTION = new DeleteAction();
-    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, Codec.getDefault());
     private static final WaitForSnapshotAction TEST_WAIT_FOR_SNAPSHOT_ACTION = new WaitForSnapshotAction("policy");
+    private static final ForceMergeAction TEST_FORCE_MERGE_ACTION = new ForceMergeAction(1, null);
     private static final RolloverAction TEST_ROLLOVER_ACTION = new RolloverAction(new ByteSizeValue(1), null, null);
     private static final ShrinkAction TEST_SHRINK_ACTION = new ShrinkAction(1);
     private static final ReadOnlyAction TEST_READ_ONLY_ACTION = new ReadOnlyAction();
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index cf96d99f7429a..3097813c1a30f 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1448,7 +1448,7 @@ private void createFullPolicy(TimeValue hotTime) throws IOException {
         hotActions.put(RolloverAction.NAME,  new RolloverAction(null, null, 1L));
         Map<String, LifecycleAction> warmActions = new HashMap<>();
         warmActions.put(SetPriorityAction.NAME, new SetPriorityAction(50));
-        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, Codec.getDefault()));
+        warmActions.put(ForceMergeAction.NAME, new ForceMergeAction(1, null));
         warmActions.put(AllocateAction.NAME, new AllocateAction(1, singletonMap("_name", "integTest-1,integTest-2"), null, null));
         warmActions.put(ShrinkAction.NAME, new ShrinkAction(1));
         Map<String, LifecycleAction> coldActions = new HashMap<>();

From 61a61d753b927af3b112d1c4dce96465846aaf05 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 10 Jan 2020 09:32:48 +0100
Subject: [PATCH 494/686] Fix Snapshot Shard Status Request Deduplication
 (#50788)

* Fix Snapshot Shard Status Request Deduplication

The request deduplication didn't actually work for these requests
since they had no `equals` and `hashCode` so the deduplicator wouldn't
actually recognize equal requests.
---
 .../snapshots/SnapshotShardsService.java      | 24 +++++++--
 .../snapshots/SnapshotShardsServiceTests.java | 53 +++++++++++++++++++
 2 files changed, 74 insertions(+), 3 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/snapshots/SnapshotShardsServiceTests.java

diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotShardsService.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotShardsService.java
index 96bc4969d9d91..18a9e99c791d3 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotShardsService.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotShardsService.java
@@ -78,6 +78,7 @@
 import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
+import java.util.Objects;
 import java.util.function.Function;
 import java.util.stream.Collectors;
 
@@ -392,9 +393,9 @@ private void syncShardStatsOnNewMaster(ClusterChangedEvent event) {
      * Internal request that is used to send changes in snapshot status to master
      */
     public static class UpdateIndexShardSnapshotStatusRequest extends MasterNodeRequest<UpdateIndexShardSnapshotStatusRequest> {
-        private Snapshot snapshot;
-        private ShardId shardId;
-        private ShardSnapshotStatus status;
+        private final Snapshot snapshot;
+        private final ShardId shardId;
+        private final ShardSnapshotStatus status;
 
         public UpdateIndexShardSnapshotStatusRequest(StreamInput in) throws IOException {
             super(in);
@@ -440,6 +441,23 @@ public ShardSnapshotStatus status() {
         public String toString() {
             return snapshot + ", shardId [" + shardId + "], status [" + status.state() + "]";
         }
+
+        @Override
+        public boolean equals(final Object o) {
+            if (this == o) {
+                return true;
+            }
+            if (o == null || getClass() != o.getClass()) {
+                return false;
+            }
+            final UpdateIndexShardSnapshotStatusRequest that = (UpdateIndexShardSnapshotStatusRequest) o;
+            return snapshot.equals(that.snapshot) && shardId.equals(that.shardId) && status.equals(that.status);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(snapshot, shardId, status);
+        }
     }
 
     /** Notify the master node that the given shard has been successfully snapshotted **/
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotShardsServiceTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotShardsServiceTests.java
new file mode 100644
index 0000000000000..f1b4928c0e254
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotShardsServiceTests.java
@@ -0,0 +1,53 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.snapshots;
+
+import org.elasticsearch.cluster.SnapshotsInProgress;
+import org.elasticsearch.common.UUIDs;
+import org.elasticsearch.index.shard.ShardId;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.EqualsHashCodeTestUtils;
+
+public class SnapshotShardsServiceTests extends ESTestCase {
+
+    public void testEqualsAndHashcodeUpdateIndexShardSnapshotStatusRequest() {
+        EqualsHashCodeTestUtils.checkEqualsAndHashCode(
+            new SnapshotShardsService.UpdateIndexShardSnapshotStatusRequest(
+                new Snapshot(randomAlphaOfLength(10),
+                    new SnapshotId(randomAlphaOfLength(10), UUIDs.randomBase64UUID(random()))),
+                new ShardId(randomAlphaOfLength(10), UUIDs.randomBase64UUID(random()), randomInt(5)),
+                new SnapshotsInProgress.ShardSnapshotStatus(randomAlphaOfLength(10), UUIDs.randomBase64UUID(random()))),
+            request ->
+                new SnapshotShardsService.UpdateIndexShardSnapshotStatusRequest(request.snapshot(), request.shardId(), request.status()),
+            request -> {
+                final boolean mutateSnapshot = randomBoolean();
+                final boolean mutateShardId = randomBoolean();
+                final boolean mutateStatus = (mutateSnapshot || mutateShardId) == false || randomBoolean();
+                return new SnapshotShardsService.UpdateIndexShardSnapshotStatusRequest(
+                    mutateSnapshot ? new Snapshot(randomAlphaOfLength(10),
+                        new SnapshotId(randomAlphaOfLength(10), UUIDs.randomBase64UUID(random()))) : request.snapshot(),
+                    mutateShardId ?
+                        new ShardId(randomAlphaOfLength(10), UUIDs.randomBase64UUID(random()), randomInt(5)) : request.shardId(),
+                    mutateStatus ? new SnapshotsInProgress.ShardSnapshotStatus(randomAlphaOfLength(10), UUIDs.randomBase64UUID(random()))
+                        : request.status()
+                );
+            });
+    }
+
+}

From 331c6c823238440f055753c48b3cb191070cca5b Mon Sep 17 00:00:00 2001
From: Przemko Robakowski <przemko.robakowski@elastic.co>
Date: Fri, 10 Jan 2020 10:05:44 +0100
Subject: [PATCH 495/686] Mute
 TimeSeriesLifecycleActionsIT.testWaitForSnapshotSlmExecutedBefore (#50842)

Muting the test while I work on fixing its flakiness.
Relates #50781
---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 3097813c1a30f..749a7354ac99c 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -347,6 +347,7 @@ public void testWaitForSnapshot() throws Exception {
         assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("completed")));
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50781")
     public void testWaitForSnapshotSlmExecutedBefore() throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));

From 8cec7b1eae5de8e93c4875f538b93e1660acbbb6 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 10 Jan 2020 13:17:38 +0200
Subject: [PATCH 496/686] [ML] Reuse SourceDestValidator for data frame
 analytics (#50841)

This commit removes validation logic of source and dest indices
for data frame analytics and replaces it with using the common
`SourceDestValidator` class which is already used by transforms.
This way the validations and their messages become consistent
while we reduce code.

This means that where these validations fail the error messages
will be slightly different for data frame analytics.
---
 .../validation/SourceDestValidator.java       |  37 ++--
 .../action/PutDataFrameAnalyticsAction.java   |  21 +-
 .../ml/dataframe/DataFrameAnalyticsDest.java  |  13 --
 .../validation/SourceDestValidatorTests.java  |  74 +++----
 .../DataFrameAnalyticsDestTests.java          |  19 --
 .../ml/qa/ml-with-security/build.gradle       |   2 +
 .../TransportPutDataFrameAnalyticsAction.java |  44 ++--
 ...ransportStartDataFrameAnalyticsAction.java |  47 +++--
 .../ml/dataframe/SourceDestValidations.java   |  28 +++
 .../ml/dataframe/SourceDestValidator.java     |  68 -------
 .../dataframe/SourceDestValidatorTests.java   | 188 ------------------
 .../test/ml/data_frame_analytics_crud.yml     |  46 ++++-
 .../test/ml/start_data_frame_analytics.yml    |   2 +-
 .../TransportPreviewTransformAction.java      |   3 +-
 .../action/TransportPutTransformAction.java   |   3 +-
 .../action/TransportStartTransformAction.java |   3 +-
 .../TransportUpdateTransformAction.java       |   3 +-
 .../utils/SourceDestValidations.java          |  40 ++++
 18 files changed, 256 insertions(+), 385 deletions(-)
 create mode 100644 x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidations.java
 delete mode 100644 x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidator.java
 delete mode 100644 x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidatorTests.java
 create mode 100644 x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/utils/SourceDestValidations.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidator.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidator.java
index ef28fed54cf48..1a292bbebeadd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidator.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidator.java
@@ -46,7 +46,6 @@ public final class SourceDestValidator {
 
     // messages
     public static final String SOURCE_INDEX_MISSING = "Source index [{0}] does not exist";
-    public static final String SOURCE_LOWERCASE = "Source index [{0}] must be lowercase";
     public static final String DEST_IN_SOURCE = "Destination index [{0}] is included in source expression [{1}]";
     public static final String DEST_LOWERCASE = "Destination index [{0}] must be lowercase";
     public static final String NEEDS_REMOTE_CLUSTER_SEARCH = "Source index is configured with a remote index pattern(s) [{0}]"
@@ -59,6 +58,7 @@ public final class SourceDestValidator {
         + "alias [{0}], at least a [{1}] license is required, found license [{2}]";
     public static final String REMOTE_CLUSTER_LICENSE_INACTIVE = "License check failed for remote cluster "
         + "alias [{0}], license is not active";
+    public static final String REMOTE_SOURCE_INDICES_NOT_SUPPORTED = "remote source indices are not supported";
 
     private final IndexNameExpressionResolver indexNameExpressionResolver;
     private final RemoteClusterService remoteClusterService;
@@ -216,7 +216,7 @@ private void resolveLocalAndRemoteSource() {
         }
     }
 
-    interface SourceDestValidation {
+    public interface SourceDestValidation {
         void validate(Context context, ActionListener<Context> listener);
     }
 
@@ -228,18 +228,7 @@ interface SourceDestValidation {
     public static final SourceDestValidation REMOTE_SOURCE_VALIDATION = new RemoteSourceEnabledAndRemoteLicenseValidation();
     public static final SourceDestValidation DESTINATION_IN_SOURCE_VALIDATION = new DestinationInSourceValidation();
     public static final SourceDestValidation DESTINATION_SINGLE_INDEX_VALIDATION = new DestinationSingleIndexValidation();
-
-    // set of default validation collections, if you want to automatically benefit from new validators, use those
-    public static final List<SourceDestValidation> PREVIEW_VALIDATIONS = Arrays.asList(SOURCE_MISSING_VALIDATION, REMOTE_SOURCE_VALIDATION);
-
-    public static final List<SourceDestValidation> ALL_VALIDATIONS = Arrays.asList(
-        SOURCE_MISSING_VALIDATION,
-        REMOTE_SOURCE_VALIDATION,
-        DESTINATION_IN_SOURCE_VALIDATION,
-        DESTINATION_SINGLE_INDEX_VALIDATION
-    );
-
-    public static final List<SourceDestValidation> NON_DEFERABLE_VALIDATIONS = Arrays.asList(DESTINATION_SINGLE_INDEX_VALIDATION);
+    public static final SourceDestValidation REMOTE_SOURCE_NOT_SUPPORTED_VALIDATION = new RemoteSourceNotSupportedValidation();
 
     /**
      * Create a new Source Dest Validator
@@ -299,10 +288,11 @@ public void validate(
             }
         }, listener::onFailure);
 
+        // We traverse the validations in reverse order as we chain the listeners from back to front
         for (int i = validations.size() - 1; i >= 0; i--) {
-            final SourceDestValidation validation = validations.get(i);
+            SourceDestValidation validation = validations.get(i);
             final ActionListener<Context> previousValidationListener = validationListener;
-            validationListener = ActionListener.wrap(c -> { validation.validate(c, previousValidationListener); }, listener::onFailure);
+            validationListener = ActionListener.wrap(c -> validation.validate(c, previousValidationListener), listener::onFailure);
         }
 
         validationListener.onResponse(context);
@@ -427,13 +417,13 @@ public void validate(Context context, ActionListener<Context> listener) {
                 return;
             }
 
-            if (context.resolvedSource.contains(destIndex)) {
+            if (context.resolveSource().contains(destIndex)) {
                 context.addValidationError(DEST_IN_SOURCE, destIndex, Strings.arrayToCommaDelimitedString(context.getSource()));
                 listener.onResponse(context);
                 return;
             }
 
-            if (context.resolvedSource.contains(context.resolveDest())) {
+            if (context.resolveSource().contains(context.resolveDest())) {
                 context.addValidationError(
                     DEST_IN_SOURCE,
                     context.resolveDest(),
@@ -454,6 +444,17 @@ public void validate(Context context, ActionListener<Context> listener) {
         }
     }
 
+    static class RemoteSourceNotSupportedValidation implements SourceDestValidation {
+
+        @Override
+        public void validate(Context context, ActionListener<Context> listener) {
+            if (context.resolveRemoteSource().isEmpty() == false) {
+                context.addValidationError(REMOTE_SOURCE_INDICES_NOT_SUPPORTED);
+            }
+            listener.onResponse(context);
+        }
+    }
+
     private static String getMessage(String message, Object... args) {
         return new MessageFormat(message, Locale.ROOT).format(args);
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsAction.java
index 4f4ddc388aed7..7ce5be3b980bd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutDataFrameAnalyticsAction.java
@@ -18,9 +18,11 @@
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsSource;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
+import org.elasticsearch.xpack.core.ml.utils.MlStrings;
 
 import java.io.IOException;
 import java.util.Objects;
@@ -90,14 +92,29 @@ public DataFrameAnalyticsConfig getConfig() {
         @Override
         public ActionRequestValidationException validate() {
             ActionRequestValidationException error = null;
+            error = checkConfigIdIsValid(config, error);
+            error = SourceDestValidator.validateRequest(error, config.getDest().getIndex());
             error = checkNoIncludedAnalyzedFieldsAreExcludedBySourceFiltering(config, error);
             return error;
         }
 
+        private ActionRequestValidationException checkConfigIdIsValid(DataFrameAnalyticsConfig config,
+                                                                      ActionRequestValidationException error) {
+            if (MlStrings.isValidId(config.getId()) == false) {
+                error = ValidateActions.addValidationError(Messages.getMessage(Messages.INVALID_ID, DataFrameAnalyticsConfig.ID,
+                    config.getId()), error);
+            }
+            if (!MlStrings.hasValidLengthForId(config.getId())) {
+                error = ValidateActions.addValidationError(Messages.getMessage(Messages.ID_TOO_LONG, DataFrameAnalyticsConfig.ID,
+                    config.getId(), MlStrings.ID_LENGTH_LIMIT), error);
+            }
+            return error;
+        }
+
         private ActionRequestValidationException checkNoIncludedAnalyzedFieldsAreExcludedBySourceFiltering(
                 DataFrameAnalyticsConfig config, ActionRequestValidationException error) {
             if (config.getAnalyzedFields() == null) {
-                return null;
+                return error;
             }
             for (String analyzedInclude : config.getAnalyzedFields().includes()) {
                 if (config.getSource().isFieldExcluded(analyzedInclude)) {
@@ -107,7 +124,7 @@ private ActionRequestValidationException checkNoIncludedAnalyzedFieldsAreExclude
                         + DataFrameAnalyticsSource._SOURCE.getPreferredName() + "]", error);
                 }
             }
-            return null;
+            return error;
         }
 
         @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsDest.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsDest.java
index 3bc435336f062..98f1bdeb19189 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsDest.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsDest.java
@@ -13,15 +13,11 @@
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.indices.InvalidIndexNameException;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
 import java.io.IOException;
-import java.util.Locale;
 import java.util.Objects;
 
-import static org.elasticsearch.cluster.metadata.MetaDataCreateIndexService.validateIndexOrAliasName;
-
 public class DataFrameAnalyticsDest implements Writeable, ToXContentObject {
 
     public static final ParseField INDEX = new ParseField("index");
@@ -94,13 +90,4 @@ public String getIndex() {
     public String getResultsField() {
         return resultsField;
     }
-
-    public void validate() {
-        if (index != null) {
-            validateIndexOrAliasName(index, InvalidIndexNameException::new);
-            if (index.toLowerCase(Locale.ROOT).equals(index) == false) {
-                throw new InvalidIndexNameException(index, "dest.index must be lowercase");
-            }
-        }
-    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidatorTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidatorTests.java
index 566925258c879..4eab68271b7e1 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidatorTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/common/validation/SourceDestValidatorTests.java
@@ -41,7 +41,9 @@
 import org.junit.After;
 import org.junit.Before;
 
+import java.util.Arrays;
 import java.util.Collections;
+import java.util.List;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
@@ -52,6 +54,10 @@
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_VERSION_CREATED;
 import static org.elasticsearch.mock.orig.Mockito.when;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.DESTINATION_IN_SOURCE_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.DESTINATION_SINGLE_INDEX_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.REMOTE_SOURCE_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.SOURCE_MISSING_VALIDATION;
 import static org.hamcrest.Matchers.equalTo;
 import static org.mockito.Mockito.spy;
 
@@ -67,6 +73,14 @@ public class SourceDestValidatorTests extends ESTestCase {
     private static final String REMOTE_PLATINUM = "remote-platinum";
 
     private static final ClusterState CLUSTER_STATE;
+
+    private static final List<SourceDestValidator.SourceDestValidation> TEST_VALIDATIONS = Arrays.asList(
+        SOURCE_MISSING_VALIDATION,
+        DESTINATION_IN_SOURCE_VALIDATION,
+        DESTINATION_SINGLE_INDEX_VALIDATION,
+        REMOTE_SOURCE_VALIDATION
+    );
+
     private Client clientWithBasicLicense;
     private Client clientWithExpiredBasicLicense;
     private Client clientWithPlatinumLicense;
@@ -184,13 +198,13 @@ public void closeComponents() throws Exception {
         ThreadPool.terminate(threadPool, 10, TimeUnit.SECONDS);
     }
 
-    public void testCheck_GivenSimpleSourceIndexAndValidDestIndex() throws InterruptedException {
+    public void testValidate_GivenSimpleSourceIndexAndValidDestIndex() throws InterruptedException {
         assertValidation(
             listener -> simpleNonRemoteValidator.validate(
                 CLUSTER_STATE,
                 new String[] { SOURCE_1 },
                 "dest",
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             true,
@@ -204,7 +218,7 @@ public void testCheck_GivenNoSourceIndexAndValidDestIndex() throws InterruptedEx
                 CLUSTER_STATE,
                 new String[] {},
                 "dest",
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -221,7 +235,7 @@ public void testCheck_GivenMissingConcreteSourceIndex() throws InterruptedExcept
                 CLUSTER_STATE,
                 new String[] { "missing" },
                 "dest",
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -236,7 +250,7 @@ public void testCheck_GivenMissingConcreteSourceIndex() throws InterruptedExcept
                 CLUSTER_STATE,
                 new String[] { "missing" },
                 "dest",
-                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                Collections.emptyList(),
                 listener
             ),
             true,
@@ -250,7 +264,7 @@ public void testCheck_GivenMixedMissingAndExistingConcreteSourceIndex() throws I
                 CLUSTER_STATE,
                 new String[] { SOURCE_1, "missing" },
                 "dest",
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -265,7 +279,7 @@ public void testCheck_GivenMixedMissingAndExistingConcreteSourceIndex() throws I
                 CLUSTER_STATE,
                 new String[] { SOURCE_1, "missing" },
                 "dest",
-                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                Collections.emptyList(),
                 listener
             ),
             true,
@@ -279,7 +293,7 @@ public void testCheck_GivenMixedMissingWildcardExistingConcreteSourceIndex() thr
                 CLUSTER_STATE,
                 new String[] { SOURCE_1, "wildcard*", "missing" },
                 "dest",
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -294,7 +308,7 @@ public void testCheck_GivenMixedMissingWildcardExistingConcreteSourceIndex() thr
                 CLUSTER_STATE,
                 new String[] { SOURCE_1, "wildcard*", "missing" },
                 "dest",
-                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                Collections.emptyList(),
                 listener
             ),
             true,
@@ -308,7 +322,7 @@ public void testCheck_GivenWildcardSourceIndex() throws InterruptedException {
                 CLUSTER_STATE,
                 new String[] { "wildcard*" },
                 "dest",
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             true,
@@ -322,7 +336,7 @@ public void testCheck_GivenDestIndexSameAsSourceIndex() throws InterruptedExcept
                 CLUSTER_STATE,
                 new String[] { SOURCE_1 },
                 SOURCE_1,
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -340,7 +354,7 @@ public void testCheck_GivenDestIndexSameAsSourceIndex() throws InterruptedExcept
                 CLUSTER_STATE,
                 new String[] { SOURCE_1 },
                 SOURCE_1,
-                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                Collections.emptyList(),
                 listener
             ),
             true,
@@ -354,7 +368,7 @@ public void testCheck_GivenDestIndexMatchesSourceIndex() throws InterruptedExcep
                 CLUSTER_STATE,
                 new String[] { "source-*" },
                 SOURCE_2,
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -372,7 +386,7 @@ public void testCheck_GivenDestIndexMatchesSourceIndex() throws InterruptedExcep
                 CLUSTER_STATE,
                 new String[] { "source-*" },
                 SOURCE_2,
-                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                Collections.emptyList(),
                 listener
             ),
             true,
@@ -386,7 +400,7 @@ public void testCheck_GivenDestIndexMatchesOneOfSourceIndices() throws Interrupt
                 CLUSTER_STATE,
                 new String[] { "source-1", "source-*" },
                 SOURCE_2,
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -404,7 +418,7 @@ public void testCheck_GivenDestIndexMatchesOneOfSourceIndices() throws Interrupt
                 CLUSTER_STATE,
                 new String[] { "source-1", "source-*" },
                 SOURCE_2,
-                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                Collections.emptyList(),
                 listener
             ),
             true,
@@ -418,7 +432,7 @@ public void testCheck_GivenDestIndexMatchesMultipleSourceIndices() throws Interr
                 CLUSTER_STATE,
                 new String[] { "source-1", "source-*", "sou*" },
                 SOURCE_2,
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -442,7 +456,7 @@ public void testCheck_GivenDestIndexIsAliasThatMatchesMultipleIndices() throws I
                 CLUSTER_STATE,
                 new String[] { SOURCE_1 },
                 DEST_ALIAS,
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -464,21 +478,11 @@ public void testCheck_GivenDestIndexIsAliasThatMatchesMultipleIndices() throws I
                 CLUSTER_STATE,
                 new String[] { SOURCE_1 },
                 DEST_ALIAS,
-                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                Collections.emptyList(),
                 listener
             ),
-            (Boolean) null,
-            e -> {
-                assertEquals(1, e.validationErrors().size());
-                assertThat(
-                    e.validationErrors().get(0),
-                    equalTo(
-                        "no write index is defined for alias [dest-alias]. "
-                            + "The write index may be explicitly disabled using is_write_index=false or the alias points "
-                            + "to multiple indices without one being designated as a write index"
-                    )
-                );
-            }
+            true,
+            null
         );
     }
 
@@ -488,7 +492,7 @@ public void testCheck_GivenDestIndexIsAliasThatMatchesMultipleIndicesButHasSingl
                 CLUSTER_STATE,
                 new String[] { SOURCE_1 },
                 ALIAS_READ_WRITE_DEST,
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -514,7 +518,7 @@ public void testCheck_GivenDestIndexIsAliasThatIsIncludedInSource() throws Inter
                 CLUSTER_STATE,
                 new String[] { SOURCE_1 },
                 SOURCE_1_ALIAS,
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
@@ -532,7 +536,7 @@ public void testCheck_GivenDestIndexIsAliasThatIsIncludedInSource() throws Inter
                 CLUSTER_STATE,
                 new String[] { SOURCE_1 },
                 SOURCE_1_ALIAS,
-                SourceDestValidator.NON_DEFERABLE_VALIDATIONS,
+                Collections.emptyList(),
                 listener
             ),
             true,
@@ -546,7 +550,7 @@ public void testCheck_MultipleValidationErrors() throws InterruptedException {
                 CLUSTER_STATE,
                 new String[] { SOURCE_1, "missing" },
                 SOURCE_1_ALIAS,
-                SourceDestValidator.ALL_VALIDATIONS,
+                TEST_VALIDATIONS,
                 listener
             ),
             (Boolean) null,
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsDestTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsDestTests.java
index bf8ce4c8a99b0..7332687723805 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsDestTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsDestTests.java
@@ -7,14 +7,10 @@
 
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.indices.InvalidIndexNameException;
-import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 
 import java.io.IOException;
 
-import static org.hamcrest.Matchers.equalTo;
-
 public class DataFrameAnalyticsDestTests extends AbstractSerializingTestCase<DataFrameAnalyticsDest> {
 
     @Override
@@ -37,19 +33,4 @@ public static DataFrameAnalyticsDest createRandom() {
     protected Writeable.Reader<DataFrameAnalyticsDest> instanceReader() {
         return DataFrameAnalyticsDest::new;
     }
-
-    public void testValidate_GivenIndexWithFunkyChars() {
-        expectThrows(InvalidIndexNameException.class, () -> new DataFrameAnalyticsDest("<script>foo", null).validate());
-    }
-
-    public void testValidate_GivenIndexWithUppercaseChars() {
-        InvalidIndexNameException e = expectThrows(InvalidIndexNameException.class,
-            () -> new DataFrameAnalyticsDest("Foo", null).validate());
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Invalid index name [Foo], dest.index must be lowercase"));
-    }
-
-    public void testValidate_GivenValidIndexName() {
-        new DataFrameAnalyticsDest("foo_bar_42", null).validate();
-    }
 }
diff --git a/x-pack/plugin/ml/qa/ml-with-security/build.gradle b/x-pack/plugin/ml/qa/ml-with-security/build.gradle
index fe53f1ca39ff5..8c9ba6df7f009 100644
--- a/x-pack/plugin/ml/qa/ml-with-security/build.gradle
+++ b/x-pack/plugin/ml/qa/ml-with-security/build.gradle
@@ -50,6 +50,7 @@ integTest.runner {
     'ml/data_frame_analytics_crud/Test put config with dest index same as source index',
     'ml/data_frame_analytics_crud/Test put config with dest index matching multiple indices',
     'ml/data_frame_analytics_crud/Test put config with dest index included in source via alias',
+    'ml/data_frame_analytics_crud/Test put config with remote source index',
     'ml/data_frame_analytics_crud/Test put config with unknown top level field',
     'ml/data_frame_analytics_crud/Test put config with unknown field in outlier detection analysis',
     'ml/data_frame_analytics_crud/Test put config given analyzed_fields include field excluded by source',
@@ -58,6 +59,7 @@ integTest.runner {
     'ml/data_frame_analytics_crud/Test put config given source with empty string in index array',
     'ml/data_frame_analytics_crud/Test put config given source without index',
     'ml/data_frame_analytics_crud/Test put config given missing dest',
+    'ml/data_frame_analytics_crud/Test put config given dest index contains uppercase chars',
     'ml/data_frame_analytics_crud/Test put config given dest with empty index',
     'ml/data_frame_analytics_crud/Test put config given dest without index',
     'ml/data_frame_analytics_crud/Test put config given missing analysis',
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutDataFrameAnalyticsAction.java
index 1cbed7ed76613..c35a5c9a9d4a9 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutDataFrameAnalyticsAction.java
@@ -25,6 +25,7 @@
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.tasks.Task;
@@ -32,14 +33,13 @@
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.XPackField;
 import org.elasticsearch.xpack.core.XPackSettings;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.ml.MachineLearningField;
 import org.elasticsearch.xpack.core.ml.action.PutDataFrameAnalyticsAction;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.elasticsearch.xpack.core.ml.job.persistence.ElasticsearchMappings;
-import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
-import org.elasticsearch.xpack.core.ml.utils.MlStrings;
 import org.elasticsearch.xpack.core.security.SecurityContext;
 import org.elasticsearch.xpack.core.security.action.user.HasPrivilegesAction;
 import org.elasticsearch.xpack.core.security.action.user.HasPrivilegesRequest;
@@ -47,7 +47,7 @@
 import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
 import org.elasticsearch.xpack.core.security.authz.permission.ResourcePrivileges;
 import org.elasticsearch.xpack.core.security.support.Exceptions;
-import org.elasticsearch.xpack.ml.dataframe.SourceDestValidator;
+import org.elasticsearch.xpack.ml.dataframe.SourceDestValidations;
 import org.elasticsearch.xpack.ml.dataframe.persistence.DataFrameAnalyticsConfigProvider;
 import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
 
@@ -66,6 +66,7 @@ public class TransportPutDataFrameAnalyticsAction
     private final SecurityContext securityContext;
     private final Client client;
     private final DataFrameAnalyticsAuditor auditor;
+    private final SourceDestValidator sourceDestValidator;
 
     private volatile ByteSizeValue maxModelMemoryLimit;
 
@@ -86,6 +87,14 @@ public TransportPutDataFrameAnalyticsAction(Settings settings, TransportService
         maxModelMemoryLimit = MachineLearningField.MAX_MODEL_MEMORY_LIMIT.get(settings);
         clusterService.getClusterSettings()
             .addSettingsUpdateConsumer(MachineLearningField.MAX_MODEL_MEMORY_LIMIT, this::setMaxModelMemoryLimit);
+
+        this.sourceDestValidator = new SourceDestValidator(
+            indexNameExpressionResolver,
+            transportService.getRemoteClusterService(),
+            null,
+            clusterService.getNodeName(),
+            License.OperationMode.PLATINUM.description()
+        );
     }
 
     private void setMaxModelMemoryLimit(ByteSizeValue maxModelMemoryLimit) {
@@ -110,9 +119,21 @@ protected ClusterBlockException checkBlock(PutDataFrameAnalyticsAction.Request r
     @Override
     protected void masterOperation(Task task, PutDataFrameAnalyticsAction.Request request, ClusterState state,
                                    ActionListener<PutDataFrameAnalyticsAction.Response> listener) {
-        validateConfig(request.getConfig());
+
+        final DataFrameAnalyticsConfig config = request.getConfig();
+
+        ActionListener<Boolean> sourceDestValidationListener = ActionListener.wrap(
+            aBoolean -> putValidatedConfig(config, listener),
+            listener::onFailure
+        );
+
+        sourceDestValidator.validate(clusterService.state(), config.getSource().getIndex(), config.getDest().getIndex(),
+            SourceDestValidations.ALL_VALIDATIONS, sourceDestValidationListener);
+    }
+
+    private void putValidatedConfig(DataFrameAnalyticsConfig config, ActionListener<PutDataFrameAnalyticsAction.Response> listener) {
         DataFrameAnalyticsConfig preparedForPutConfig =
-            new DataFrameAnalyticsConfig.Builder(request.getConfig(), maxModelMemoryLimit)
+            new DataFrameAnalyticsConfig.Builder(config, maxModelMemoryLimit)
                 .setCreateTime(Instant.now())
                 .setVersion(Version.CURRENT)
                 .build();
@@ -202,19 +223,6 @@ private void updateDocMappingAndPutConfig(DataFrameAnalyticsConfig config,
                 listener::onFailure));
     }
 
-    private void validateConfig(DataFrameAnalyticsConfig config) {
-        if (MlStrings.isValidId(config.getId()) == false) {
-            throw ExceptionsHelper.badRequestException(Messages.getMessage(Messages.INVALID_ID, DataFrameAnalyticsConfig.ID,
-                config.getId()));
-        }
-        if (!MlStrings.hasValidLengthForId(config.getId())) {
-            throw ExceptionsHelper.badRequestException("id [{}] is too long; must not contain more than {} characters", config.getId(),
-                MlStrings.ID_LENGTH_LIMIT);
-        }
-        config.getDest().validate();
-        new SourceDestValidator(clusterService.state(), indexNameExpressionResolver).check(config);
-    }
-
     @Override
     protected void doExecute(Task task, PutDataFrameAnalyticsAction.Request request,
                              ActionListener<PutDataFrameAnalyticsAction.Response> listener) {
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
index 14130402a0baa..b203ea95630a1 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportStartDataFrameAnalyticsAction.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.IndexNotFoundException;
+import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.persistent.AllocatedPersistentTask;
@@ -47,6 +48,7 @@
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.XPackField;
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
 import org.elasticsearch.xpack.core.ml.MlMetadata;
 import org.elasticsearch.xpack.core.ml.MlTasks;
 import org.elasticsearch.xpack.core.ml.action.ExplainDataFrameAnalyticsAction;
@@ -64,7 +66,7 @@
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsManager;
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask;
 import org.elasticsearch.xpack.ml.dataframe.MappingsMerger;
-import org.elasticsearch.xpack.ml.dataframe.SourceDestValidator;
+import org.elasticsearch.xpack.ml.dataframe.SourceDestValidations;
 import org.elasticsearch.xpack.ml.dataframe.extractor.DataFrameDataExtractorFactory;
 import org.elasticsearch.xpack.ml.dataframe.extractor.ExtractedFieldsDetectorFactory;
 import org.elasticsearch.xpack.ml.dataframe.persistence.DataFrameAnalyticsConfigProvider;
@@ -101,6 +103,7 @@ public class TransportStartDataFrameAnalyticsAction
     private final DataFrameAnalyticsConfigProvider configProvider;
     private final MlMemoryTracker memoryTracker;
     private final DataFrameAnalyticsAuditor auditor;
+    private final SourceDestValidator sourceDestValidator;
 
     @Inject
     public TransportStartDataFrameAnalyticsAction(TransportService transportService, Client client, ClusterService clusterService,
@@ -117,6 +120,14 @@ public TransportStartDataFrameAnalyticsAction(TransportService transportService,
         this.configProvider = configProvider;
         this.memoryTracker = memoryTracker;
         this.auditor = Objects.requireNonNull(auditor);
+
+        this.sourceDestValidator = new SourceDestValidator(
+            indexNameExpressionResolver,
+            transportService.getRemoteClusterService(),
+            null,
+            clusterService.getNodeName(),
+            License.OperationMode.PLATINUM.description()
+        );
     }
 
     @Override
@@ -228,13 +239,13 @@ private void estimateMemoryUsageAndUpdateMemoryTracker(StartContext startContext
 
     private void getStartContext(String id, ActionListener<StartContext> finalListener) {
 
-        // Step 6. Validate that there are analyzable data in the source index
+        // Step 7. Validate that there are analyzable data in the source index
         ActionListener<StartContext> validateMappingsMergeListener = ActionListener.wrap(
             startContext -> validateSourceIndexHasRows(startContext, finalListener),
             finalListener::onFailure
         );
 
-        // Step 5. Validate mappings can be merged
+        // Step 6. Validate mappings can be merged
         ActionListener<StartContext> toValidateMappingsListener = ActionListener.wrap(
             startContext -> MappingsMerger.mergeMappings(client, startContext.config.getHeaders(),
                 startContext.config.getSource(), ActionListener.wrap(
@@ -242,7 +253,7 @@ private void getStartContext(String id, ActionListener<StartContext> finalListen
             finalListener::onFailure
         );
 
-        // Step 4. Validate dest index is empty if task is starting for first time
+        // Step 5. Validate dest index is empty if task is starting for first time
         ActionListener<StartContext> toValidateDestEmptyListener = ActionListener.wrap(
             startContext -> {
                 switch (startContext.startingState) {
@@ -266,22 +277,30 @@ private void getStartContext(String id, ActionListener<StartContext> finalListen
             finalListener::onFailure
         );
 
-        // Step 3. Validate source and dest; check data extraction is possible
-        ActionListener<StartContext> startContextListener = ActionListener.wrap(
+        // Step 4. Check data extraction is possible
+        ActionListener<StartContext> toValidateExtractionPossibleListener = ActionListener.wrap(
             startContext -> {
-                // Validate the query parses
-                startContext.config.getSource().getParsedQuery();
-
-                // Validate source/dest are valid
-                new SourceDestValidator(clusterService.state(), indexNameExpressionResolver).check(startContext.config);
-
-                // Validate extraction is possible
                 new ExtractedFieldsDetectorFactory(client).createFromSource(startContext.config, ActionListener.wrap(
                     extractedFieldsDetector -> {
                         startContext.extractedFields = extractedFieldsDetector.detect().v1();
                         toValidateDestEmptyListener.onResponse(startContext);
                     },
-                    finalListener::onFailure));
+                    finalListener::onFailure)
+                );
+            },
+            finalListener::onFailure
+        );
+
+        // Step 3. Validate source and dest
+        ActionListener<StartContext> startContextListener = ActionListener.wrap(
+            startContext -> {
+                // Validate the query parses
+                startContext.config.getSource().getParsedQuery();
+
+                // Validate source/dest are valid
+                sourceDestValidator.validate(clusterService.state(), startContext.config.getSource().getIndex(),
+                    startContext.config.getDest().getIndex(), SourceDestValidations.ALL_VALIDATIONS, ActionListener.wrap(
+                        aBoolean -> toValidateExtractionPossibleListener.onResponse(startContext), finalListener::onFailure));
             },
             finalListener::onFailure
         );
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidations.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidations.java
new file mode 100644
index 0000000000000..2372cfeaced88
--- /dev/null
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidations.java
@@ -0,0 +1,28 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.dataframe;
+
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
+
+import java.util.Arrays;
+import java.util.List;
+
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.DESTINATION_IN_SOURCE_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.DESTINATION_SINGLE_INDEX_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.REMOTE_SOURCE_NOT_SUPPORTED_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.SOURCE_MISSING_VALIDATION;
+
+public final class SourceDestValidations {
+
+    private SourceDestValidations() {}
+
+    public static final List<SourceDestValidator.SourceDestValidation> ALL_VALIDATIONS = Arrays.asList(
+        SOURCE_MISSING_VALIDATION,
+        DESTINATION_SINGLE_INDEX_VALIDATION,
+        DESTINATION_IN_SOURCE_VALIDATION,
+        REMOTE_SOURCE_NOT_SUPPORTED_VALIDATION
+    );
+}
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidator.java
deleted file mode 100644
index 01803dc4359d5..0000000000000
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidator.java
+++ /dev/null
@@ -1,68 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.ml.dataframe;
-
-import org.elasticsearch.action.support.IndicesOptions;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.regex.Regex;
-import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
-import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
-
-import java.util.Arrays;
-import java.util.HashSet;
-import java.util.Objects;
-import java.util.Set;
-
-public class SourceDestValidator {
-
-    private final ClusterState clusterState;
-    private final IndexNameExpressionResolver indexNameExpressionResolver;
-
-    public SourceDestValidator(ClusterState clusterState, IndexNameExpressionResolver indexNameExpressionResolver) {
-        this.clusterState = Objects.requireNonNull(clusterState);
-        this.indexNameExpressionResolver = Objects.requireNonNull(indexNameExpressionResolver);
-    }
-
-    public void check(DataFrameAnalyticsConfig config) {
-        String[] sourceIndex = config.getSource().getIndex();
-        String destIndex = config.getDest().getIndex();
-
-        String[] sourceExpressions = Arrays.stream(sourceIndex)
-            .map(index -> Strings.tokenizeToStringArray(index, ","))
-            .flatMap(Arrays::stream)
-            .toArray(String[]::new);
-
-        for (String sourceExpression : sourceExpressions) {
-            if (Regex.simpleMatch(sourceExpression, destIndex)) {
-                throw ExceptionsHelper.badRequestException("Destination index [{}] must not be included in source index [{}]",
-                    destIndex, sourceExpression);
-            }
-        }
-
-        Set<String> concreteSourceIndexNames = new HashSet<>(Arrays.asList(indexNameExpressionResolver.concreteIndexNames(clusterState,
-            IndicesOptions.lenientExpandOpen(), sourceExpressions)));
-
-        if (concreteSourceIndexNames.isEmpty()) {
-            throw ExceptionsHelper.badRequestException("No index matches source index {}", Arrays.toString(sourceIndex));
-        }
-
-        final String[] concreteDestIndexNames = indexNameExpressionResolver.concreteIndexNames(clusterState,
-            IndicesOptions.lenientExpandOpen(), destIndex);
-
-        if (concreteDestIndexNames.length > 1) {
-            // In case it is an alias, it may match multiple indices
-            throw ExceptionsHelper.badRequestException("Destination index [{}] should match a single index; matches {}", destIndex,
-                Arrays.toString(concreteDestIndexNames));
-        }
-        if (concreteDestIndexNames.length == 1 && concreteSourceIndexNames.contains(concreteDestIndexNames[0])) {
-            // In case the dest index is an alias, we need to check the concrete index is not matched by source
-            throw ExceptionsHelper.badRequestException("Destination index [{}], which is an alias for [{}], " +
-                    "must not be included in source index {}", destIndex, concreteDestIndexNames[0], Arrays.toString(sourceIndex));
-        }
-    }
-}
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidatorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidatorTests.java
deleted file mode 100644
index ec8b97942ac0a..0000000000000
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/SourceDestValidatorTests.java
+++ /dev/null
@@ -1,188 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.ml.dataframe;
-
-import org.elasticsearch.ElasticsearchStatusException;
-import org.elasticsearch.Version;
-import org.elasticsearch.cluster.ClusterName;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.metadata.AliasMetaData;
-import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
-import org.elasticsearch.cluster.metadata.MetaData;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
-import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsDest;
-import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsSource;
-import org.elasticsearch.xpack.core.ml.dataframe.analyses.OutlierDetection;
-
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_CREATION_DATE;
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_REPLICAS;
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
-import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_VERSION_CREATED;
-import static org.hamcrest.Matchers.equalTo;
-
-public class SourceDestValidatorTests extends ESTestCase {
-
-    private static final String SOURCE_1 = "source-1";
-    private static final String SOURCE_2 = "source-2";
-    private static final String ALIASED_DEST = "aliased-dest";
-
-    private static final ClusterState CLUSTER_STATE;
-
-    static {
-        IndexMetaData source1 = IndexMetaData.builder(SOURCE_1).settings(Settings.builder()
-            .put(SETTING_VERSION_CREATED, Version.CURRENT)
-            .put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(SETTING_CREATION_DATE, System.currentTimeMillis()))
-            .putAlias(AliasMetaData.builder("source-1-alias").build())
-            .build();
-        IndexMetaData source2 = IndexMetaData.builder(SOURCE_2).settings(Settings.builder()
-            .put(SETTING_VERSION_CREATED, Version.CURRENT)
-            .put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(SETTING_CREATION_DATE, System.currentTimeMillis()))
-            .putAlias(AliasMetaData.builder("dest-alias").build())
-            .build();
-        IndexMetaData aliasedDest = IndexMetaData.builder(ALIASED_DEST).settings(Settings.builder()
-            .put(SETTING_VERSION_CREATED, Version.CURRENT)
-            .put(SETTING_NUMBER_OF_SHARDS, 1).put(SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(SETTING_CREATION_DATE, System.currentTimeMillis()))
-            .putAlias(AliasMetaData.builder("dest-alias").build())
-            .build();
-        ClusterState.Builder state = ClusterState.builder(new ClusterName("test"));
-        state.metaData(MetaData.builder()
-            .put(IndexMetaData.builder(source1).build(), false)
-            .put(IndexMetaData.builder(source2).build(), false)
-            .put(IndexMetaData.builder(aliasedDest).build(), false));
-        CLUSTER_STATE = state.build();
-    }
-
-    public void testCheck_GivenSimpleSourceIndexAndValidDestIndex() {
-        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
-            .setId("test")
-            .setSource(createSource("source-1"))
-            .setDest(new DataFrameAnalyticsDest("dest", null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
-
-        SourceDestValidator validator = new SourceDestValidator(CLUSTER_STATE, new IndexNameExpressionResolver());
-        validator.check(config);
-    }
-
-    public void testCheck_GivenMissingConcreteSourceIndex() {
-        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
-            .setId("test")
-            .setSource(createSource("missing"))
-            .setDest(new DataFrameAnalyticsDest("dest", null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
-
-        SourceDestValidator validator = new SourceDestValidator(CLUSTER_STATE, new IndexNameExpressionResolver());
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> validator.check(config));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("No index matches source index [missing]"));
-    }
-
-    public void testCheck_GivenMissingWildcardSourceIndex() {
-        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
-            .setId("test")
-            .setSource(createSource("missing*"))
-            .setDest(new DataFrameAnalyticsDest("dest", null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
-
-        SourceDestValidator validator = new SourceDestValidator(CLUSTER_STATE, new IndexNameExpressionResolver());
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> validator.check(config));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("No index matches source index [missing*]"));
-    }
-
-    public void testCheck_GivenDestIndexSameAsSourceIndex() {
-        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
-            .setId("test")
-            .setSource(createSource("source-1"))
-            .setDest(new DataFrameAnalyticsDest("source-1", null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
-
-        SourceDestValidator validator = new SourceDestValidator(CLUSTER_STATE, new IndexNameExpressionResolver());
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> validator.check(config));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Destination index [source-1] must not be included in source index [source-1]"));
-    }
-
-    public void testCheck_GivenDestIndexMatchesSourceIndex() {
-        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
-            .setId("test")
-            .setSource(createSource("source-*"))
-            .setDest(new DataFrameAnalyticsDest(SOURCE_2, null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
-
-        SourceDestValidator validator = new SourceDestValidator(CLUSTER_STATE, new IndexNameExpressionResolver());
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> validator.check(config));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Destination index [source-2] must not be included in source index [source-*]"));
-    }
-
-    public void testCheck_GivenDestIndexMatchesOneOfSourceIndices() {
-        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
-            .setId("test")
-            .setSource(createSource("source-1,source-*"))
-            .setDest(new DataFrameAnalyticsDest(SOURCE_2, null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
-
-        SourceDestValidator validator = new SourceDestValidator(CLUSTER_STATE, new IndexNameExpressionResolver());
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> validator.check(config));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(), equalTo("Destination index [source-2] must not be included in source index [source-*]"));
-    }
-
-    public void testCheck_GivenDestIndexIsAliasThatMatchesMultipleIndices() {
-        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
-            .setId("test")
-            .setSource(createSource(SOURCE_1))
-            .setDest(new DataFrameAnalyticsDest("dest-alias", null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
-
-        SourceDestValidator validator = new SourceDestValidator(CLUSTER_STATE, new IndexNameExpressionResolver());
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> validator.check(config));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(),
-            equalTo("Destination index [dest-alias] should match a single index; matches [source-2, aliased-dest]"));
-    }
-
-    public void testCheck_GivenDestIndexIsAliasThatIsIncludedInSource() {
-        DataFrameAnalyticsConfig config = new DataFrameAnalyticsConfig.Builder()
-            .setId("test")
-            .setSource(createSource("source-1"))
-            .setDest(new DataFrameAnalyticsDest("source-1-alias", null))
-            .setAnalysis(new OutlierDetection.Builder().build())
-            .build();
-
-        SourceDestValidator validator = new SourceDestValidator(CLUSTER_STATE, new IndexNameExpressionResolver());
-
-        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, () -> validator.check(config));
-        assertThat(e.status(), equalTo(RestStatus.BAD_REQUEST));
-        assertThat(e.getMessage(),
-            equalTo("Destination index [source-1-alias], which is an alias for [source-1], " +
-                "must not be included in source index [source-1]"));
-    }
-
-    private static DataFrameAnalyticsSource createSource(String... index) {
-        return new DataFrameAnalyticsSource(index, null, null);
-    }
-}
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
index 4335a50382a94..6dc8c800bd414 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
@@ -268,6 +268,24 @@ setup:
             "analysis": {"outlier_detection":{}}
           }
 
+---
+"Test put config given dest index contains uppercase chars":
+
+  - do:
+      catch: /.*reason=Validation Failed.* Destination index \[Foo\] must be lowercase;.*/
+      ml.put_data_frame_analytics:
+        id: "config-given-dest-index-uppercase"
+        body: >
+          {
+            "source": {
+              "index": "index-source"
+            },
+            "dest": {
+              "index": "Foo"
+            },
+            "analysis": {"outlier_detection":{}}
+          }
+
 ---
 "Test put config with pattern dest index name":
 
@@ -290,7 +308,7 @@ setup:
 "Test put config with missing concrete source index":
 
   - do:
-      catch: /No index matches source index \[missing]/
+      catch: /.*reason=Validation Failed.* no such index \[missing\]/
       ml.put_data_frame_analytics:
         id: "config-with-missing-concrete-source-index"
         body: >
@@ -308,7 +326,6 @@ setup:
 "Test put config with missing wildcard source index":
 
   - do:
-      catch: /No index matches source index \[missing\*\]/
       ml.put_data_frame_analytics:
         id: "config-with-missing-wildcard-source-index"
         body: >
@@ -321,12 +338,13 @@ setup:
             },
             "analysis": {"outlier_detection":{}}
           }
+  - match: { id: "config-with-missing-wildcard-source-index" }
 
 ---
 "Test put config with dest index same as source index":
 
   - do:
-      catch: /Destination index \[index-source\] must not be included in source index \[index-source\]/
+      catch: /.*reason=Validation Failed.* Destination index \[index-source\] is included in source expression \[index-source\]/
       ml.put_data_frame_analytics:
         id: "config-with-same-source-dest-index"
         body: >
@@ -362,7 +380,7 @@ setup:
         name: multiple-dest-index
 
   - do:
-      catch: /Destination index \[multiple-dest-index\] should match a single index; matches \[multiple-dest-index-[12], multiple-dest-index-[12]\]/
+      catch: /.*reason=Validation Failed.* no write index is defined for alias \[multiple-dest-index\].*/
       ml.put_data_frame_analytics:
         id: "config-with-dest-index-matching-multiple-indices"
         body: >
@@ -389,7 +407,7 @@ setup:
         name: dest-alias
 
   - do:
-      catch: /Destination index \[dest-alias\], which is an alias for \[another-source-index\], must not be included in source index \[another-source-index\]/
+      catch: /.*reason=Validation Failed.* Destination index \[another-source-index\] is included in source expression \[another-source-index\]/
       ml.put_data_frame_analytics:
         id: "config-with-dest-index-included-in-source-via-alias"
         body: >
@@ -403,6 +421,24 @@ setup:
             "analysis": {"outlier_detection":{}}
           }
 
+---
+"Test put config with remote source index":
+
+  - do:
+      catch: /.*reason=Validation Failed.* remote source indices are not supported/
+      ml.put_data_frame_analytics:
+        id: "config-with-missing-concrete-source-index"
+        body: >
+          {
+            "source": {
+              "index": "remote_cluster:foo"
+            },
+            "dest": {
+              "index": "index-dest"
+            },
+            "analysis": {"outlier_detection":{}}
+          }
+
 ---
 "Test put config with unknown top level field":
 
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/start_data_frame_analytics.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/start_data_frame_analytics.yml
index 0172a83f58ef2..8cae555a201f5 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/start_data_frame_analytics.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/start_data_frame_analytics.yml
@@ -31,7 +31,7 @@
         index: missing
 
   - do:
-      catch: /No index matches source index \[missing]/
+      catch: /.*reason=Validation Failed.* no such index \[missing\]/
       ml.start_data_frame_analytics:
         id: "missing_index"
 
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPreviewTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPreviewTransformAction.java
index 5ae62d0890ea9..4896194279e46 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPreviewTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPreviewTransformAction.java
@@ -51,6 +51,7 @@
 import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerStats;
 import org.elasticsearch.xpack.transform.transforms.pivot.AggregationResultUtils;
 import org.elasticsearch.xpack.transform.transforms.pivot.Pivot;
+import org.elasticsearch.xpack.transform.utils.SourceDestValidations;
 
 import java.util.ArrayList;
 import java.util.HashMap;
@@ -138,7 +139,7 @@ protected void doExecute(Task task, PreviewTransformAction.Request request, Acti
             clusterState,
             config.getSource().getIndex(),
             config.getDestination().getIndex(),
-            SourceDestValidator.PREVIEW_VALIDATIONS,
+            SourceDestValidations.PREVIEW_VALIDATIONS,
             ActionListener.wrap(r -> {
 
                 Pivot pivot = new Pivot(config.getPivotConfig());
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
index 67d9454c98232..23bd53e4efd30 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportPutTransformAction.java
@@ -57,6 +57,7 @@
 import org.elasticsearch.xpack.transform.notifications.TransformAuditor;
 import org.elasticsearch.xpack.transform.persistence.TransformConfigManager;
 import org.elasticsearch.xpack.transform.transforms.pivot.Pivot;
+import org.elasticsearch.xpack.transform.utils.SourceDestValidations;
 
 import java.io.IOException;
 import java.time.Instant;
@@ -232,7 +233,7 @@ protected void masterOperation(Task task, Request request, ClusterState clusterS
             clusterState,
             config.getSource().getIndex(),
             config.getDestination().getIndex(),
-            request.isDeferValidation() ? SourceDestValidator.NON_DEFERABLE_VALIDATIONS : SourceDestValidator.ALL_VALIDATIONS,
+            request.isDeferValidation() ? SourceDestValidations.NON_DEFERABLE_VALIDATIONS : SourceDestValidations.ALL_VALIDATIONS,
             ActionListener.wrap(
                 validationResponse -> {
                     // Early check to verify that the user can create the destination index and can read from the source
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
index 52337427c388f..a4204d2191417 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStartTransformAction.java
@@ -52,6 +52,7 @@
 import org.elasticsearch.xpack.transform.persistence.TransformConfigManager;
 import org.elasticsearch.xpack.transform.persistence.TransformIndex;
 import org.elasticsearch.xpack.transform.transforms.pivot.Pivot;
+import org.elasticsearch.xpack.transform.utils.SourceDestValidations;
 
 import java.io.IOException;
 import java.time.Clock;
@@ -279,7 +280,7 @@ protected void masterOperation(
                 clusterService.state(),
                 config.getSource().getIndex(),
                 config.getDestination().getIndex(),
-                SourceDestValidator.ALL_VALIDATIONS,
+                SourceDestValidations.ALL_VALIDATIONS,
                 validationListener
             );
         }, listener::onFailure);
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportUpdateTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportUpdateTransformAction.java
index e98360fb453ca..9764a2ddbac5f 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportUpdateTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportUpdateTransformAction.java
@@ -56,6 +56,7 @@
 import org.elasticsearch.xpack.transform.persistence.TransformConfigManager;
 import org.elasticsearch.xpack.transform.persistence.TransformIndex;
 import org.elasticsearch.xpack.transform.transforms.pivot.Pivot;
+import org.elasticsearch.xpack.transform.utils.SourceDestValidations;
 
 import java.io.IOException;
 import java.time.Clock;
@@ -177,7 +178,7 @@ protected void masterOperation(Task task, Request request, ClusterState clusterS
                 clusterState,
                 updatedConfig.getSource().getIndex(),
                 updatedConfig.getDestination().getIndex(),
-                request.isDeferValidation() ? SourceDestValidator.NON_DEFERABLE_VALIDATIONS : SourceDestValidator.ALL_VALIDATIONS,
+                request.isDeferValidation() ? SourceDestValidations.NON_DEFERABLE_VALIDATIONS : SourceDestValidations.ALL_VALIDATIONS,
                 ActionListener.wrap(
                     validationResponse -> {
                         checkPriviledgesAndUpdateTransform(request, clusterState, updatedConfig, configAndVersion.v2(), listener);
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/utils/SourceDestValidations.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/utils/SourceDestValidations.java
new file mode 100644
index 0000000000000..0941a28fc85a2
--- /dev/null
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/utils/SourceDestValidations.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.transform.utils;
+
+import org.elasticsearch.xpack.core.common.validation.SourceDestValidator;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.DESTINATION_IN_SOURCE_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.DESTINATION_SINGLE_INDEX_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.REMOTE_SOURCE_VALIDATION;
+import static org.elasticsearch.xpack.core.common.validation.SourceDestValidator.SOURCE_MISSING_VALIDATION;
+
+/**
+ * Packs together useful sets of validations in the context transforms
+ */
+public final class SourceDestValidations {
+
+    private SourceDestValidations() {}
+
+    public static final List<SourceDestValidator.SourceDestValidation> PREVIEW_VALIDATIONS = Arrays.asList(
+        SOURCE_MISSING_VALIDATION, REMOTE_SOURCE_VALIDATION);
+
+    public static final List<SourceDestValidator.SourceDestValidation> ALL_VALIDATIONS = Arrays.asList(
+        SOURCE_MISSING_VALIDATION,
+        REMOTE_SOURCE_VALIDATION,
+        DESTINATION_IN_SOURCE_VALIDATION,
+        DESTINATION_SINGLE_INDEX_VALIDATION
+    );
+
+    public static final List<SourceDestValidator.SourceDestValidation> NON_DEFERABLE_VALIDATIONS = Collections.singletonList(
+        DESTINATION_SINGLE_INDEX_VALIDATION
+    );
+}

From c63d440b4910cf6d224ffb795f7e838124e1694b Mon Sep 17 00:00:00 2001
From: Costin Leau <costin@users.noreply.github.com>
Date: Fri, 10 Jan 2020 13:43:49 +0200
Subject: [PATCH 497/686] Introduce reusable QL plugin for SQL and EQL (#50815)

Extract reusable functionality from SQL into its own dedicated project QL.
Implemented as a plugin, it provides common components across SQL and the upcoming EQL.

While this commit is fairly large, for the most part it's just a big file move from sql package to the newly introduced ql.
---
 x-pack/plugin/ql/build.gradle                 |  36 +
 .../xpack/ql/ParsingException.java            |  61 ++
 .../xpack/ql/QlClientException.java           |  29 +
 .../elasticsearch/xpack/ql/QlException.java}  |  14 +-
 .../xpack/ql/QlIllegalArgumentException.java  |  32 +
 .../xpack/ql/QlServerException.java           |  29 +
 .../xpack/ql}/capabilities/Resolvable.java    |   2 +-
 .../xpack/ql}/capabilities/Resolvables.java   |   2 +-
 .../xpack/ql}/capabilities/Unresolvable.java  |   2 +-
 .../ql}/capabilities/UnresolvedException.java |   6 +-
 .../xpack/ql}/execution/search/AggRef.java    |   4 +-
 .../ql}/execution/search/FieldExtraction.java |   4 +-
 .../ql/execution/search/QlSourceBuilder.java} |  16 +-
 .../extractor/AbstractFieldHitExtractor.java  | 314 +++++++++
 .../search/extractor/BucketExtractor.java     |   2 +-
 .../search/extractor/BucketExtractors.java    |  28 +
 .../search/extractor/ComputingExtractor.java  |   9 +-
 .../search/extractor/ConstantExtractor.java   |   2 +-
 .../search/extractor/HitExtractor.java        |   2 +-
 .../search/extractor/HitExtractors.java       |   4 +-
 .../xpack/ql}/expression/Alias.java           |   8 +-
 .../xpack/ql}/expression/Attribute.java       |   6 +-
 .../xpack/ql}/expression/AttributeMap.java    |   2 +-
 .../xpack/ql}/expression/AttributeSet.java    |   2 +-
 .../xpack/ql}/expression/Expression.java      |  18 +-
 .../xpack/ql}/expression/ExpressionSet.java   |   2 +-
 .../xpack/ql}/expression/Expressions.java     |  18 +-
 .../xpack/ql}/expression/FieldAttribute.java  |  12 +-
 .../xpack/ql}/expression/Foldables.java       |  12 +-
 .../xpack/ql}/expression/LeafExpression.java  |   4 +-
 .../xpack/ql}/expression/Literal.java         |  16 +-
 .../xpack/ql}/expression/NameId.java          |   2 +-
 .../xpack/ql}/expression/NamedExpression.java |   4 +-
 .../xpack/ql}/expression/Nullability.java     |   2 +-
 .../xpack/ql}/expression/Order.java           |  10 +-
 .../ql}/expression/ReferenceAttribute.java    |   8 +-
 .../xpack/ql}/expression/TypeResolutions.java |  20 +-
 .../xpack/ql}/expression/TypedAttribute.java  |   6 +-
 .../xpack/ql}/expression/UnaryExpression.java |   6 +-
 .../xpack/ql}/expression/UnresolvedAlias.java |   8 +-
 .../ql}/expression/UnresolvedAttribute.java   |  16 +-
 .../expression/UnresolvedNamedExpression.java |  10 +-
 .../xpack/ql}/expression/UnresolvedStar.java  |   8 +-
 .../function/DefaultFunctionTypeRegistry.java |  38 +
 .../ql}/expression/function/Function.java     |  18 +-
 .../function/FunctionDefinition.java          |  20 +-
 .../expression/function/FunctionRegistry.java | 420 +++++++++++
 .../function/FunctionTypeRegistry.java}       |   8 +-
 .../ql}/expression/function/Functions.java    |   8 +-
 .../expression/function/OptionalArgument.java |  15 +
 .../function/UnresolvedFunction.java          |  26 +-
 .../function/aggregate/AggregateFunction.java |  24 +-
 .../function/aggregate/CompoundAggregate.java |  21 +
 .../expression/function/aggregate/Count.java  |  10 +-
 .../function/aggregate/EnclosedAgg.java       |   2 +-
 .../function/aggregate/InnerAggregate.java    |  21 +-
 .../function/grouping/GroupingFunction.java   |  20 +-
 .../function/scalar/BinaryScalarFunction.java |  10 +-
 .../function/scalar/ScalarFunction.java       |  10 +-
 .../function/scalar/UnaryScalarFunction.java  |  16 +-
 .../function/scalar/geo/GeoShape.java         |  16 +-
 .../whitelist/InternalQlScriptUtils.java      | 108 +++
 .../gen/pipeline/AggExtractorInput.java       |  20 +-
 .../expression/gen/pipeline/AggNameInput.java |   8 +-
 .../expression/gen/pipeline/AggPathInput.java |  12 +-
 .../gen/pipeline/AttributeInput.java          |  14 +-
 .../expression/gen/pipeline/BinaryPipe.java   |  10 +-
 .../pipeline/CommonNonExecutableInput.java    |  16 +-
 .../gen/pipeline/ConstantInput.java           |  16 +-
 .../gen/pipeline/HitExtractorInput.java       |  18 +-
 .../expression/gen/pipeline/LeafInput.java    |   6 +-
 .../expression/gen/pipeline/MultiPipe.java    |   8 +-
 .../gen/pipeline/NonExecutableInput.java      |  12 +-
 .../ql}/expression/gen/pipeline/Pipe.java     |  22 +-
 .../gen/pipeline/ReferenceInput.java          |  14 +-
 .../expression/gen/pipeline/UnaryPipe.java    |  16 +-
 .../gen/processor/BinaryProcessor.java        |   2 +-
 .../processor/BucketExtractorProcessor.java   |   8 +-
 .../gen/processor/ChainingProcessor.java      |   2 +-
 .../gen/processor/ConstantProcessor.java      |   2 +-
 .../processor/FunctionalBinaryProcessor.java  |   2 +-
 .../gen/processor/HitExtractorProcessor.java  |   8 +-
 .../expression/gen/processor/Processor.java   |   2 +-
 .../gen/processor/UnaryProcessor.java         |   2 +-
 .../xpack/ql}/expression/gen/script/Agg.java  |  13 +-
 .../ql}/expression/gen/script/Grouping.java   |   4 +-
 .../ql}/expression/gen/script/Param.java      |   2 +-
 .../ql}/expression/gen/script/Params.java     |   6 +-
 .../expression/gen/script/ParamsBuilder.java  |   6 +-
 .../ql}/expression/gen/script/Script.java     |   2 +-
 .../expression/gen/script/ScriptTemplate.java |   6 +-
 .../expression/gen/script/ScriptWeaver.java   |  32 +-
 .../ql}/expression/gen/script/Scripts.java    |  15 +-
 .../xpack/ql}/expression/gen/script/Var.java  |   2 +-
 .../ql}/expression/literal/Interval.java      |   8 +-
 .../expression/literal/IntervalDayTime.java   |   6 +-
 .../expression/literal/IntervalYearMonth.java |   8 +-
 .../ql}/expression/literal/Intervals.java     |  34 +-
 .../ql}/expression/literal/Literals.java      |   4 +-
 .../expression/predicate/BinaryOperator.java  |  10 +-
 .../expression/predicate/BinaryPredicate.java |   8 +-
 .../ql}/expression/predicate/Negatable.java   |   4 +-
 .../predicate/PredicateBiFunction.java        |   2 +-
 .../ql}/expression/predicate/Predicates.java  |  14 +-
 .../xpack/ql}/expression/predicate/Range.java |  36 +-
 .../ArbitraryConditionalFunction.java         |  18 +-
 .../predicate/conditional/Case.java           |  39 +-
 .../predicate/conditional/CasePipe.java       |  16 +-
 .../predicate/conditional/CaseProcessor.java  |   4 +-
 .../predicate/conditional/Coalesce.java       |  10 +-
 .../conditional/ConditionalFunction.java      |  24 +-
 .../conditional/ConditionalPipe.java          |  18 +-
 .../conditional/ConditionalProcessor.java     |   4 +-
 .../predicate/conditional/Conditionals.java   |   6 +-
 .../predicate/conditional/Greatest.java       |  12 +-
 .../predicate/conditional/IfConditional.java  |  12 +-
 .../predicate/conditional/IfNull.java         |   8 +-
 .../expression/predicate/conditional/Iif.java |  27 +-
 .../predicate/conditional/Least.java          |  12 +-
 .../predicate/conditional/NullIf.java         |  18 +-
 .../predicate/conditional/NullIfPipe.java     |  14 +-
 .../conditional/NullIfProcessor.java          |   6 +-
 .../predicate/fulltext/FullTextPredicate.java |  10 +-
 .../predicate/fulltext/FullTextUtils.java     |   8 +-
 .../fulltext/MatchQueryPredicate.java         |  13 +-
 .../fulltext/MultiMatchQueryPredicate.java    |  13 +-
 .../fulltext/StringQueryPredicate.java        |  12 +-
 .../ql}/expression/predicate/logical/And.java |  12 +-
 .../predicate/logical/BinaryLogic.java        |  24 +-
 .../predicate/logical/BinaryLogicPipe.java    |  16 +-
 .../logical/BinaryLogicProcessor.java         |  14 +-
 .../ql}/expression/predicate/logical/Not.java |  22 +-
 .../predicate/logical/NotProcessor.java       |   8 +-
 .../ql}/expression/predicate/logical/Or.java  |  12 +-
 .../predicate/nulls/CheckNullProcessor.java   |   4 +-
 .../expression/predicate/nulls/IsNotNull.java |  22 +-
 .../expression/predicate/nulls/IsNull.java    |  22 +-
 .../predicate/operator/arithmetic/Add.java    |  10 +-
 .../arithmetic/ArithmeticOperation.java       |  24 +-
 .../operator/arithmetic/Arithmetics.java      |   6 +-
 .../arithmetic/BinaryArithmeticPipe.java      |  16 +-
 .../arithmetic/BinaryArithmeticProcessor.java |  32 +-
 .../DateTimeArithmeticOperation.java          |  12 +-
 .../predicate/operator/arithmetic/Div.java    |  14 +-
 .../predicate/operator/arithmetic/Mod.java    |  10 +-
 .../predicate/operator/arithmetic/Mul.java    |  12 +-
 .../predicate/operator/arithmetic/Neg.java    |  26 +-
 .../predicate/operator/arithmetic/Sub.java    |  12 +-
 .../arithmetic/UnaryArithmeticProcessor.java  |   8 +-
 .../operator/comparison/BinaryComparison.java |  20 +-
 .../comparison/BinaryComparisonPipe.java      |  16 +-
 .../comparison/BinaryComparisonProcessor.java |  10 +-
 .../operator/comparison/Comparisons.java      |   2 +-
 .../predicate/operator/comparison/Equals.java |  12 +-
 .../operator/comparison/GreaterThan.java      |  12 +-
 .../comparison/GreaterThanOrEqual.java        |  12 +-
 .../predicate/operator/comparison/In.java     |  38 +-
 .../predicate/operator/comparison/InPipe.java |  16 +-
 .../operator/comparison/InProcessor.java      |  24 +-
 .../operator/comparison/LessThan.java         |  12 +-
 .../operator/comparison/LessThanOrEqual.java  |  12 +-
 .../operator/comparison/NotEquals.java        |  12 +-
 .../operator/comparison/NullEquals.java       |  12 +-
 .../ql}/expression/predicate/regex/Like.java  |  12 +-
 .../predicate/regex/LikePattern.java          |   4 +-
 .../ql}/expression/predicate/regex/RLike.java |  12 +-
 .../predicate/regex/RegexMatch.java           |  16 +-
 .../predicate/regex/RegexProcessor.java       |   4 +-
 .../ql/expression/processor/Processors.java   |  66 ++
 .../xpack/ql}/index/EsIndex.java              |   4 +-
 .../xpack/ql}/index/IndexResolution.java      |   2 +-
 .../xpack/ql}/index/IndexResolver.java        |  30 +-
 .../xpack/ql}/index/MappingException.java     |   6 +-
 .../xpack/ql}/plan/QueryPlan.java             |  16 +-
 .../xpack/ql}/plan/TableIdentifier.java       |   4 +-
 .../xpack/ql}/plan/logical/Aggregate.java     |  16 +-
 .../xpack/ql}/plan/logical/BinaryPlan.java    |  12 +-
 .../xpack/ql}/plan/logical/EsRelation.java    |  16 +-
 .../xpack/ql}/plan/logical/Filter.java        |  10 +-
 .../xpack/ql}/plan/logical/LeafPlan.java      |   6 +-
 .../xpack/ql}/plan/logical/Limit.java         |  10 +-
 .../xpack/ql}/plan/logical/LogicalPlan.java   |  10 +-
 .../xpack/ql}/plan/logical/OrderBy.java       |  12 +-
 .../xpack/ql}/plan/logical/Project.java       |  18 +-
 .../xpack/ql}/plan/logical/UnaryPlan.java     |  11 +-
 .../ql}/plan/logical/UnresolvedRelation.java  |  12 +-
 .../xpack/ql/plugin/QlPlugin.java             |  14 +
 .../elasticsearch/xpack/ql}/rule/Rule.java    |  10 +-
 .../ql}/rule/RuleExecutionException.java      |   6 +-
 .../xpack/ql}/rule/RuleExecutor.java          |   6 +-
 .../xpack/ql/session/Configuration.java       |  41 ++
 .../xpack/ql}/tree/Location.java              |   2 +-
 .../elasticsearch/xpack/ql}/tree/Node.java    |   6 +-
 .../xpack/ql}/tree/NodeInfo.java              |   2 +-
 .../xpack/ql}/tree/NodeUtils.java             |   2 +-
 .../elasticsearch/xpack/ql}/tree/Source.java  |   6 +-
 .../xpack/ql}/type/DataType.java              |  45 +-
 .../xpack/ql}/type/DataTypeConversion.java    |  45 +-
 .../xpack/ql}/type/DataTypes.java             |  43 +-
 .../xpack/ql}/type/DateEsField.java           |   2 +-
 .../xpack/ql/type/DateUtils.java              |  91 +++
 .../elasticsearch/xpack/ql}/type/EsField.java |   2 +-
 .../xpack/ql}/type/ExtTypes.java              |   2 +-
 .../xpack/ql}/type/InvalidMappedField.java    |   6 +-
 .../xpack/ql}/type/KeywordEsField.java        |   2 +-
 .../elasticsearch/xpack/ql}/type/Schema.java  |  11 +-
 .../xpack/ql/type/StringUtils.java            | 145 ++++
 .../xpack/ql}/type/TextEsField.java           |   6 +-
 .../elasticsearch/xpack/ql}/type/Types.java   |   2 +-
 .../xpack/ql}/type/UnsupportedEsField.java    |   2 +-
 .../elasticsearch/xpack/ql/util/Check.java    |  38 +
 .../xpack/ql}/util/CollectionUtils.java       |   2 +-
 .../xpack/ql/util/DateUtils.java              | 150 ++++
 .../xpack/ql}/util/Graphviz.java              |   6 +-
 .../elasticsearch/xpack/ql}/util/Holder.java  |   2 +-
 .../xpack/ql}/util/ReflectionUtils.java       |  10 +-
 .../xpack/ql}/util/StringUtils.java           |  30 +-
 x-pack/plugin/ql/src/main/resources/file.txt  |   0
 .../org/elasticsearch/xpack/ql/TestUtils.java |  35 +
 .../extractor/ConstantExtractorTests.java     |   2 +-
 .../ql}/expression/AttributeMapTests.java     |   4 +-
 .../ql}/expression/ExpressionIdTests.java     |   3 +-
 .../xpack/ql}/expression/LiteralTests.java    |  14 +-
 .../ql}/expression/NullabilityTests.java      |   8 +-
 .../ql}/expression/TyperResolutionTests.java  |  12 +-
 .../expression/UnresolvedAttributeTests.java  |   8 +-
 .../function/FunctionRegistryTests.java       |  48 +-
 .../function/NamedExpressionTests.java        |  28 +-
 .../function/TestFunctionRegistry.java        |  14 +
 .../function/UnresolvedFunctionTests.java     |  12 +-
 .../function/scalar/FunctionTestUtils.java    |   6 +-
 .../gen/pipeline/AttributeInputTests.java     |  10 +-
 .../gen/pipeline/BinaryPipesTests.java        |  22 +-
 .../gen/pipeline/UnaryPipeTests.java          |  16 +-
 .../gen/processor/ChainingProcessorTests.java |  24 +-
 .../gen/processor/ConstantProcessorTests.java |   6 +-
 .../expression/literal/IntervalsTests.java    |  40 +-
 .../predicate/conditional/CaseTests.java      |  32 +-
 .../predicate/conditional/IifTests.java       |  28 +-
 .../fulltext/FullTextUtilsTests.java          |  10 +-
 .../logical/BinaryLogicProcessorTests.java    |   8 +-
 .../nulls/CheckNullProcessorTests.java        |  10 +-
 .../BinaryArithmeticProcessorTests.java       |  21 +-
 .../arithmetic/BinaryArithmeticTests.java     |  38 +-
 .../BinaryComparisonProcessorTests.java       |  12 +-
 .../operator/comparison/InProcessorTests.java |  12 +-
 .../operator/comparison/InTests.java          |   8 +-
 .../xpack/ql}/tree/AbstractNodeTestCase.java  |   2 +-
 .../xpack/ql}/tree/NodeSubclassTests.java     | 119 ++--
 .../xpack/ql}/tree/NodeTests.java             |   4 +-
 .../xpack/ql}/tree/SourceTests.java           |   2 +-
 .../xpack/ql/tree/TestCompoundAggregate.java  |  39 ++
 .../xpack/ql/tree/TestEnclosedAgg.java        |  44 ++
 .../ql}/type/DataTypeConversionTests.java     | 152 ++--
 .../xpack/ql}/type/DataTypesTests.java        |  50 +-
 .../xpack/ql}/type/TypesTests.java            |  22 +-
 .../resources/mapping-basic-incompatible.json |   0
 .../resources/mapping-basic-nodocvalues.json  |   0
 .../src/test/resources/mapping-basic.json     |   0
 .../test/resources/mapping-date-multi.json    |   0
 .../resources/mapping-date-no-format.json     |   0
 .../src/test/resources/mapping-date.json      |   0
 .../resources/mapping-default-string.json     |   0
 .../src/test/resources/mapping-docvalues.json |   0
 .../test/resources/mapping-dotted-field.json  |   0
 .../src/test/resources/mapping-geo.json       |   0
 .../src/test/resources/mapping-ip.json        |   0
 .../src/test/resources/mapping-keyword.json   |   0
 .../mapping-multi-field-options.json          |   0
 .../mapping-multi-field-variation.json        |   0
 .../mapping-multi-field-with-nested.json      |   0
 .../test/resources/mapping-multi-field.json   |   0
 .../src/test/resources/mapping-nested.json    |   0
 .../src/test/resources/mapping-numeric.json   |   0
 .../src/test/resources/mapping-object.json    |   0
 .../test/resources/mapping-parent-child.json  |   0
 .../src/test/resources/mapping-text.json      |   0
 .../test/resources/mapping-unsupported.json   |   0
 x-pack/plugin/sql/build.gradle                |   7 +-
 .../xpack/sql/proto/StringUtils.java          |  40 +-
 ...Exception.java => SqlClientException.java} |  14 +-
 .../sql/SqlIllegalArgumentException.java      |   4 +-
 ...Exception.java => SqlServerException.java} |  14 +-
 .../xpack/sql/analysis/AnalysisException.java |   8 +-
 .../xpack/sql/analysis/analyzer/Analyzer.java |  86 +--
 .../sql/analysis/analyzer/PreAnalyzer.java    |   4 +-
 .../sql/analysis/analyzer/TableInfo.java      |   2 +-
 .../analyzer/VerificationException.java       |   4 +-
 .../xpack/sql/analysis/analyzer/Verifier.java |  70 +-
 .../xpack/sql/execution/PlanExecutor.java     |   7 +-
 .../execution/search/CompositeAggCursor.java  |   6 +-
 .../execution/search/CompositeAggRowSet.java  |   2 +-
 .../sql/execution/search/PivotCursor.java     |   4 +-
 .../sql/execution/search/PivotRowSet.java     |   4 +-
 .../xpack/sql/execution/search/Querier.java   | 108 ++-
 .../search/SchemaCompositeAggRowSet.java      |   4 +-
 .../search/SchemaDelegatingRowSet.java        |   2 +-
 .../search/SchemaSearchHitRowSet.java         |   4 +-
 .../sql/execution/search/ScrollCursor.java    |   4 +-
 .../sql/execution/search/SearchHitRowSet.java |   2 +-
 .../sql/execution/search/SourceGenerator.java |  15 +-
 .../extractor/CompositeKeyExtractor.java      |   1 +
 .../search/extractor/FieldHitExtractor.java   | 319 ++-------
 .../search/extractor/MetricAggExtractor.java  |   3 +-
 .../search/extractor/PivotExtractor.java      |   1 +
 .../search/extractor/ScoreExtractor.java      |   1 +
 ...tractors.java => SqlBucketExtractors.java} |  13 +-
 .../search/extractor/SqlHitExtractors.java    |  31 +
 .../search/extractor/TopHitsAggExtractor.java |   3 +-
 .../xpack/sql/expression/Exists.java          |  10 +-
 .../xpack/sql/expression/ScalarSubquery.java  |  10 +-
 .../sql/expression/SubQueryExpression.java    |   6 +-
 .../expression/function/FunctionRegistry.java | 653 ------------------
 .../sql/expression/function/FunctionType.java |  37 -
 .../xpack/sql/expression/function/Score.java  |  13 +-
 .../function/SqlFunctionRegistry.java         | 265 +++++++
 .../function/SqlFunctionTypeRegistry.java     |  38 +
 .../expression/function/aggregate/Avg.java    |   9 +-
 .../aggregate/CompoundNumericAggregate.java   |   7 +-
 .../function/aggregate/ExtendedStats.java     |   7 +-
 .../aggregate/ExtendedStatsEnclosed.java      |   2 +
 .../expression/function/aggregate/First.java  |   6 +-
 .../function/aggregate/Kurtosis.java          |   7 +-
 .../expression/function/aggregate/Last.java   |   6 +-
 .../function/aggregate/MatrixStats.java       |   7 +-
 .../aggregate/MatrixStatsEnclosed.java        |   2 +
 .../expression/function/aggregate/Max.java    |  15 +-
 .../aggregate/MedianAbsoluteDeviation.java    |   8 +-
 .../expression/function/aggregate/Min.java    |  15 +-
 .../function/aggregate/NumericAggregate.java  |  11 +-
 .../function/aggregate/Percentile.java        |  17 +-
 .../function/aggregate/PercentileRank.java    |  18 +-
 .../function/aggregate/PercentileRanks.java   |   7 +-
 .../function/aggregate/Percentiles.java       |   7 +-
 .../function/aggregate/Skewness.java          |   7 +-
 .../expression/function/aggregate/Stats.java  |   7 +-
 .../function/aggregate/StddevPop.java         |   7 +-
 .../expression/function/aggregate/Sum.java    |  10 +-
 .../function/aggregate/SumOfSquares.java      |   7 +-
 .../function/aggregate/TopHits.java           |  16 +-
 .../expression/function/aggregate/VarPop.java |   7 +-
 .../function/grouping/Histogram.java          |  19 +-
 .../sql/expression/function/scalar/Cast.java  |  19 +-
 .../function/scalar/CastProcessor.java        |   4 +-
 .../scalar/ConfigurationFunction.java         |  13 +-
 .../expression/function/scalar/Database.java  |   8 +-
 .../function/scalar/Processors.java           |  53 +-
 .../sql/expression/function/scalar/User.java  |   8 +-
 .../scalar/datetime/BaseDateTimeFunction.java |  12 +-
 .../datetime/BaseDateTimeProcessor.java       |   2 +-
 .../datetime/BinaryDateTimeFunction.java      |  18 +-
 .../scalar/datetime/BinaryDateTimePipe.java   |  10 +-
 .../datetime/BinaryDateTimeProcessor.java     |   4 +-
 .../function/scalar/datetime/CurrentDate.java |   8 +-
 .../scalar/datetime/CurrentDateTime.java      |  10 +-
 .../scalar/datetime/CurrentFunction.java      |   6 +-
 .../function/scalar/datetime/CurrentTime.java |  10 +-
 .../function/scalar/datetime/DateAdd.java     |  18 +-
 .../function/scalar/datetime/DateAddPipe.java |  10 +-
 .../scalar/datetime/DateAddProcessor.java     |   2 +-
 .../function/scalar/datetime/DateDiff.java    |  18 +-
 .../scalar/datetime/DateDiffPipe.java         |  10 +-
 .../scalar/datetime/DateDiffProcessor.java    |   2 +-
 .../function/scalar/datetime/DatePart.java    |  15 +-
 .../scalar/datetime/DatePartPipe.java         |  10 +-
 .../scalar/datetime/DatePartProcessor.java    |   5 +-
 .../scalar/datetime/DateTimeField.java        |   2 +-
 .../scalar/datetime/DateTimeFunction.java     |  14 +-
 .../datetime/DateTimeHistogramFunction.java   |   4 +-
 .../function/scalar/datetime/DateTrunc.java   |  12 +-
 .../scalar/datetime/DateTruncPipe.java        |  10 +-
 .../scalar/datetime/DateTruncProcessor.java   |   5 +-
 .../function/scalar/datetime/DayName.java     |   6 +-
 .../function/scalar/datetime/DayOfMonth.java  |   6 +-
 .../function/scalar/datetime/DayOfWeek.java   |   6 +-
 .../function/scalar/datetime/DayOfYear.java   |   8 +-
 .../function/scalar/datetime/HourOfDay.java   |   6 +-
 .../scalar/datetime/IsoDayOfWeek.java         |   6 +-
 .../scalar/datetime/IsoWeekOfYear.java        |   6 +-
 .../function/scalar/datetime/MinuteOfDay.java |   6 +-
 .../scalar/datetime/MinuteOfHour.java         |   6 +-
 .../function/scalar/datetime/MonthName.java   |   6 +-
 .../function/scalar/datetime/MonthOfYear.java |   6 +-
 .../datetime/NamedDateTimeFunction.java       |  16 +-
 .../datetime/NonIsoDateTimeFunction.java      |  16 +-
 .../function/scalar/datetime/Quarter.java     |  16 +-
 .../scalar/datetime/SecondOfMinute.java       |   6 +-
 .../datetime/ThreeArgsDateTimeFunction.java   |  14 +-
 .../datetime/ThreeArgsDateTimePipe.java       |   8 +-
 .../datetime/ThreeArgsDateTimeProcessor.java  |   2 +-
 .../scalar/datetime/TimeFunction.java         |  10 +-
 .../function/scalar/datetime/WeekOfYear.java  |   6 +-
 .../function/scalar/datetime/Year.java        |   6 +-
 .../function/scalar/geo/GeoProcessor.java     |   3 +-
 .../function/scalar/geo/StAswkt.java          |   8 +-
 .../function/scalar/geo/StDistance.java       |  22 +-
 .../scalar/geo/StDistanceFunction.java        |   2 +-
 .../function/scalar/geo/StDistancePipe.java   |  10 +-
 .../scalar/geo/StDistanceProcessor.java       |   5 +-
 .../function/scalar/geo/StGeometryType.java   |   8 +-
 .../function/scalar/geo/StWkttosql.java       |  18 +-
 .../scalar/geo/StWkttosqlProcessor.java       |   3 +-
 .../expression/function/scalar/geo/StX.java   |   8 +-
 .../expression/function/scalar/geo/StY.java   |   8 +-
 .../expression/function/scalar/geo/StZ.java   |   8 +-
 .../function/scalar/geo/UnaryGeoFunction.java |  20 +-
 .../expression/function/scalar/math/ACos.java |   6 +-
 .../expression/function/scalar/math/ASin.java |   6 +-
 .../expression/function/scalar/math/ATan.java |   6 +-
 .../function/scalar/math/ATan2.java           |   6 +-
 .../expression/function/scalar/math/Abs.java  |   8 +-
 .../function/scalar/math/BinaryMathPipe.java  |  10 +-
 .../scalar/math/BinaryMathProcessor.java      |   6 +-
 .../scalar/math/BinaryNumericFunction.java    |  16 +-
 .../scalar/math/BinaryOptionalMathPipe.java   |  12 +-
 .../math/BinaryOptionalMathProcessor.java     |   2 +-
 .../math/BinaryOptionalNumericFunction.java   |  22 +-
 .../expression/function/scalar/math/Cbrt.java |   6 +-
 .../expression/function/scalar/math/Ceil.java |  10 +-
 .../expression/function/scalar/math/Cos.java  |   6 +-
 .../expression/function/scalar/math/Cosh.java |   6 +-
 .../expression/function/scalar/math/Cot.java  |   6 +-
 .../function/scalar/math/Degrees.java         |   6 +-
 .../expression/function/scalar/math/E.java    |  14 +-
 .../expression/function/scalar/math/Exp.java  |   6 +-
 .../function/scalar/math/Expm1.java           |   6 +-
 .../function/scalar/math/Floor.java           |  10 +-
 .../expression/function/scalar/math/Log.java  |   6 +-
 .../function/scalar/math/Log10.java           |   6 +-
 .../function/scalar/math/MathFunction.java    |  14 +-
 .../function/scalar/math/MathProcessor.java   |   2 +-
 .../expression/function/scalar/math/Pi.java   |  14 +-
 .../function/scalar/math/Power.java           |   6 +-
 .../function/scalar/math/Radians.java         |   6 +-
 .../function/scalar/math/Random.java          |   6 +-
 .../function/scalar/math/Round.java           |   9 +-
 .../expression/function/scalar/math/Sign.java |   8 +-
 .../expression/function/scalar/math/Sin.java  |   6 +-
 .../expression/function/scalar/math/Sinh.java |   6 +-
 .../expression/function/scalar/math/Sqrt.java |   6 +-
 .../expression/function/scalar/math/Tan.java  |   6 +-
 .../function/scalar/math/Truncate.java        |   9 +-
 .../function/scalar/string/Ascii.java         |   8 +-
 .../scalar/string/BinaryStringFunction.java   |  16 +-
 .../string/BinaryStringNumericFunction.java   |  12 +-
 .../string/BinaryStringNumericPipe.java       |  10 +-
 .../string/BinaryStringNumericProcessor.java  |   4 +-
 .../string/BinaryStringStringFunction.java    |  10 +-
 .../scalar/string/BinaryStringStringPipe.java |  10 +-
 .../string/BinaryStringStringProcessor.java   |   4 +-
 .../function/scalar/string/BitLength.java     |   8 +-
 .../function/scalar/string/Char.java          |   8 +-
 .../function/scalar/string/CharLength.java    |   8 +-
 .../function/scalar/string/Concat.java        |  26 +-
 .../scalar/string/ConcatFunctionPipe.java     |  10 +-
 .../string/ConcatFunctionProcessor.java       |   6 +-
 .../function/scalar/string/Insert.java        |  26 +-
 .../scalar/string/InsertFunctionPipe.java     |  12 +-
 .../string/InsertFunctionProcessor.java       |   2 +-
 .../function/scalar/string/LCase.java         |   8 +-
 .../function/scalar/string/LTrim.java         |   8 +-
 .../function/scalar/string/Left.java          |   6 +-
 .../function/scalar/string/Length.java        |   8 +-
 .../function/scalar/string/Locate.java        |  29 +-
 .../scalar/string/LocateFunctionPipe.java     |  12 +-
 .../string/LocateFunctionProcessor.java       |   2 +-
 .../function/scalar/string/OctetLength.java   |   8 +-
 .../function/scalar/string/Position.java      |  10 +-
 .../function/scalar/string/RTrim.java         |   8 +-
 .../function/scalar/string/Repeat.java        |   6 +-
 .../function/scalar/string/Replace.java       |  24 +-
 .../scalar/string/ReplaceFunctionPipe.java    |  12 +-
 .../string/ReplaceFunctionProcessor.java      |   2 +-
 .../function/scalar/string/Right.java         |   6 +-
 .../function/scalar/string/Space.java         |   8 +-
 .../scalar/string/StringProcessor.java        |   2 +-
 .../function/scalar/string/Substring.java     |  26 +-
 .../scalar/string/SubstringFunctionPipe.java  |  12 +-
 .../string/SubstringFunctionProcessor.java    |   2 +-
 .../function/scalar/string/UCase.java         |   8 +-
 .../scalar/string/UnaryStringFunction.java    |  20 +-
 .../scalar/string/UnaryStringIntFunction.java |  18 +-
 .../scalar/whitelist/InternalScriptUtils.java |  11 +
 .../whitelist/InternalSqlScriptUtils.java     | 120 +---
 .../expression/gen/pipeline/ScorePipe.java    |  15 +-
 .../sql/expression/literal/SqlLiterals.java   |  31 +
 .../xpack/sql/optimizer/Optimizer.java        | 126 ++--
 .../elasticsearch/xpack/sql/package-info.java |  10 +-
 .../xpack/sql/parser/AbstractBuilder.java     |   6 +-
 .../xpack/sql/parser/AstBuilder.java          |   2 +-
 .../xpack/sql/parser/CommandBuilder.java      |  10 +-
 .../xpack/sql/parser/ExpressionBuilder.java   | 108 +--
 .../xpack/sql/parser/IdentifierBuilder.java   |   4 +-
 .../xpack/sql/parser/LogicalPlanBuilder.java  |  34 +-
 .../xpack/sql/parser/ParsingException.java    |   6 +-
 .../xpack/sql/parser/SqlParser.java           |   4 +-
 .../xpack/sql/plan/logical/Distinct.java      |   6 +-
 .../xpack/sql/plan/logical/Join.java          |  16 +-
 .../xpack/sql/plan/logical/LocalRelation.java |  11 +-
 .../xpack/sql/plan/logical/Pivot.java         |  26 +-
 .../xpack/sql/plan/logical/SubQueryAlias.java |   8 +-
 .../xpack/sql/plan/logical/With.java          |   8 +-
 .../sql/plan/logical/command/Command.java     |  16 +-
 .../xpack/sql/plan/logical/command/Debug.java |  24 +-
 .../sql/plan/logical/command/Explain.java     |  16 +-
 .../sql/plan/logical/command/ShowColumns.java |  18 +-
 .../plan/logical/command/ShowFunctions.java   |  20 +-
 .../sql/plan/logical/command/ShowSchemas.java |  10 +-
 .../sql/plan/logical/command/ShowTables.java  |  10 +-
 .../plan/logical/command/sys/SysColumns.java  |  28 +-
 .../plan/logical/command/sys/SysTables.java   |  16 +-
 .../plan/logical/command/sys/SysTypes.java    |  22 +-
 .../sql/plan/physical/AggregateExec.java      |  13 +-
 .../xpack/sql/plan/physical/BinaryExec.java   |   4 +-
 .../xpack/sql/plan/physical/CommandExec.java  |   6 +-
 .../xpack/sql/plan/physical/EsQueryExec.java  |   6 +-
 .../xpack/sql/plan/physical/FilterExec.java   |  10 +-
 .../xpack/sql/plan/physical/LeafExec.java     |  18 +-
 .../xpack/sql/plan/physical/LimitExec.java    |   8 +-
 .../xpack/sql/plan/physical/LocalExec.java    |   6 +-
 .../xpack/sql/plan/physical/OrderExec.java    |   8 +-
 .../xpack/sql/plan/physical/PhysicalPlan.java |  10 +-
 .../xpack/sql/plan/physical/PivotExec.java    |   6 +-
 .../xpack/sql/plan/physical/ProjectExec.java  |  12 +-
 .../xpack/sql/plan/physical/UnaryExec.java    |  11 +-
 .../xpack/sql/plan/physical/Unexecutable.java |   4 +-
 .../sql/plan/physical/UnplannedExec.java      |  19 +-
 .../xpack/sql/planner/FoldingException.java   |   8 +-
 .../xpack/sql/planner/Mapper.java             |  22 +-
 .../xpack/sql/planner/Planner.java            |   4 +-
 .../xpack/sql/planner/PlanningException.java  |   6 +-
 .../xpack/sql/planner/QueryFolder.java        |  64 +-
 .../xpack/sql/planner/QueryTranslator.java    |  82 +--
 .../xpack/sql/planner/Verifier.java           |   4 +-
 .../xpack/sql/plugin/SqlPlugin.java           |   2 +-
 .../xpack/sql/plugin/TextFormat.java          |   2 +-
 .../plugin/TransportSqlClearCursorAction.java |   2 +-
 .../sql/plugin/TransportSqlQueryAction.java   |   6 +-
 .../plugin/TransportSqlTranslateAction.java   |   2 +-
 .../xpack/sql/querydsl/agg/AggFilter.java     |   4 +-
 .../xpack/sql/querydsl/agg/Aggs.java          |   6 +-
 .../xpack/sql/querydsl/agg/AndAggFilter.java  |   2 +-
 .../querydsl/agg/GroupByDateHistogram.java    |   2 +-
 .../xpack/sql/querydsl/agg/GroupByKey.java    |   4 +-
 .../querydsl/agg/GroupByNumericHistogram.java |   2 +-
 .../xpack/sql/querydsl/agg/GroupByValue.java  |   2 +-
 .../xpack/sql/querydsl/agg/OrAggFilter.java   |   2 +-
 .../xpack/sql/querydsl/agg/TopHitsAgg.java    |   6 +-
 .../sql/querydsl/container/AggregateSort.java |   2 +-
 .../sql/querydsl/container/AttributeSort.java |   2 +-
 .../sql/querydsl/container/ComputedRef.java   |   8 +-
 .../querydsl/container/FieldReference.java    |   2 +-
 .../querydsl/container/GlobalCountRef.java    |   2 +-
 .../sql/querydsl/container/GroupByRef.java    |   2 +-
 .../sql/querydsl/container/MetricAggRef.java  |   2 +-
 .../querydsl/container/PivotColumnRef.java    |   4 +-
 .../querydsl/container/QueryContainer.java    |  26 +-
 .../querydsl/container/ScriptFieldRef.java    |   6 +-
 .../sql/querydsl/container/ScriptSort.java    |   4 +-
 .../querydsl/container/SearchHitFieldRef.java |   6 +-
 .../xpack/sql/querydsl/container/Sort.java    |   4 +-
 .../sql/querydsl/container/TopHitsAggRef.java |   6 +-
 .../xpack/sql/querydsl/query/BoolQuery.java   |   2 +-
 .../xpack/sql/querydsl/query/ExistsQuery.java |   2 +-
 .../sql/querydsl/query/GeoDistanceQuery.java  |   2 +-
 .../xpack/sql/querydsl/query/LeafQuery.java   |   2 +-
 .../xpack/sql/querydsl/query/MatchAll.java    |   2 +-
 .../xpack/sql/querydsl/query/MatchQuery.java  |   4 +-
 .../sql/querydsl/query/MultiMatchQuery.java   |   4 +-
 .../xpack/sql/querydsl/query/NestedQuery.java |   2 +-
 .../xpack/sql/querydsl/query/NotQuery.java    |   2 +-
 .../xpack/sql/querydsl/query/Query.java       |   2 +-
 .../sql/querydsl/query/QueryStringQuery.java  |   4 +-
 .../xpack/sql/querydsl/query/RangeQuery.java  |   6 +-
 .../xpack/sql/querydsl/query/RegexQuery.java  |   6 +-
 .../xpack/sql/querydsl/query/ScriptQuery.java |   6 +-
 .../xpack/sql/querydsl/query/TermQuery.java   |   6 +-
 .../xpack/sql/querydsl/query/TermsQuery.java  |   6 +-
 .../sql/querydsl/query/WildcardQuery.java     |   6 +-
 .../xpack/sql/session/Configuration.java      |  31 +-
 .../xpack/sql/session/Cursors.java            |  12 +-
 .../xpack/sql/session/EmptyExecutable.java    |   4 +-
 .../xpack/sql/session/EmptyRowSet.java        |   2 +-
 .../xpack/sql/session/Executable.java         |   5 +-
 .../xpack/sql/session/ListCursor.java         |   2 +-
 .../xpack/sql/session/ListRowSet.java         |   2 +-
 .../elasticsearch/xpack/sql/session/Rows.java |   6 +-
 .../xpack/sql/session/SchemaRowSet.java       |   2 +-
 .../xpack/sql/session/Session.java            |  11 +
 .../sql/session/SingletonExecutable.java      |   4 +-
 .../xpack/sql/session/SingletonRowSet.java    |   2 +-
 .../xpack/sql/session/SqlExecutable.java      |  19 +
 .../xpack/sql/session/SqlSession.java         |  16 +-
 .../xpack/sql/stats/QueryMetric.java          |   1 +
 .../xpack/sql/util/DateUtils.java             |   5 +-
 .../xpack/sql/plugin/sql_whitelist.txt        |  11 +-
 .../analyzer/FieldAttributeTests.java         |  35 +-
 .../analysis/analyzer/PreAnalyzerTests.java   |   2 +-
 .../analyzer/VerifierErrorMessagesTests.java  |  28 +-
 .../analysis/index/IndexResolverTests.java    |  17 +-
 .../CompositeAggregationCursorTests.java      |   4 +-
 .../execution/search/ScrollCursorTests.java   |   4 +-
 .../search/SourceGeneratorTests.java          |  14 +-
 .../search/SqlSourceBuilderTests.java         |   3 +-
 .../extractor/CompositeKeyExtractorTests.java |   1 +
 .../extractor/ComputingExtractorTests.java    |  14 +-
 .../extractor/FieldHitExtractorTests.java     |  34 +-
 .../extractor/MetricAggExtractorTests.java    |   5 +-
 .../extractor/TopHitsAggExtractorTests.java   |   6 +-
 .../xpack/sql/expression/ProcessorTests.java  |  22 +-
 .../function/scalar/CastProcessorTests.java   |   6 +-
 .../scalar/DatabaseFunctionTests.java         |  16 +-
 .../function/scalar/UserFunctionTests.java    |  16 +-
 .../scalar/datetime/CurrentDateTests.java     |   6 +-
 .../scalar/datetime/CurrentDateTimeTests.java |  20 +-
 .../scalar/datetime/CurrentTimeTests.java     |  20 +-
 .../scalar/datetime/DateAddPipeTests.java     |  22 +-
 .../datetime/DateAddProcessorTests.java       |  14 +-
 .../scalar/datetime/DateDiffPipeTests.java    |  20 +-
 .../datetime/DateDiffProcessorTests.java      |  12 +-
 .../scalar/datetime/DatePartPipeTests.java    |  22 +-
 .../datetime/DatePartProcessorTests.java      |  12 +-
 .../scalar/datetime/DateTimeTestUtils.java    |   4 -
 .../scalar/datetime/DateTruncPipeTests.java   |  22 +-
 .../datetime/DateTruncProcessorTests.java     |  12 +-
 .../scalar/datetime/DayOfYearTests.java       |   6 +-
 .../scalar/geo/GeoProcessorTests.java         |   1 +
 .../scalar/geo/StDistanceProcessorTests.java  |  17 +-
 .../scalar/geo/StWkttosqlProcessorTests.java  |  11 +-
 .../scalar/math/BinaryMathProcessorTests.java |   8 +-
 .../string/BinaryStringNumericPipeTests.java  |  18 +-
 .../BinaryStringNumericProcessorTests.java    |   6 +-
 .../string/BinaryStringStringPipeTests.java   |  16 +-
 .../BinaryStringStringProcessorTests.java     |   6 +-
 .../string/ConcatFunctionPipeTests.java       |  16 +-
 .../scalar/string/ConcatProcessorTests.java   |   6 +-
 .../string/InsertFunctionPipeTests.java       |  18 +-
 .../scalar/string/InsertProcessorTests.java   |   6 +-
 .../string/LocateFunctionPipeTests.java       |  18 +-
 .../scalar/string/LocateProcessorTests.java   |   6 +-
 .../string/ReplaceFunctionPipeTests.java      |  16 +-
 .../scalar/string/ReplaceProcessorTests.java  |   6 +-
 .../string/SubstringFunctionPipeTests.java    |  18 +-
 .../string/SubstringProcessorTests.java       |   6 +-
 .../{ => parser}/ParameterTests.java          |  30 +-
 .../expression/{ => parser}/QuotingTests.java |  14 +-
 .../sql/optimizer/OptimizerRunTests.java      |  12 +-
 .../xpack/sql/optimizer/OptimizerTests.java   | 150 ++--
 .../sql/parser/EscapedFunctionsTests.java     |  26 +-
 .../xpack/sql/parser/ExpressionTests.java     |  28 +-
 .../sql/parser/LikeEscapingParsingTests.java  |  10 +-
 .../xpack/sql/parser/SqlParserTests.java      |  30 +-
 .../plan/logical/UnresolvedRelationTests.java |   7 +-
 .../logical/command/ShowFunctionsTests.java   |  32 +
 .../logical/command/sys/SysColumnsTests.java  |  16 +-
 .../logical/command/sys/SysTablesTests.java   |  20 +-
 .../logical/command/sys/SysTypesTests.java    |  12 +-
 .../planner/PostOptimizerVerifierTests.java   |  12 +-
 .../xpack/sql/planner/QueryFolderTests.java   |  16 +-
 .../sql/planner/QueryTranslatorTests.java     |  32 +-
 .../xpack/sql/plugin/CursorTests.java         |   5 +-
 .../container/QueryContainerTests.java        |  18 +-
 .../sql/querydsl/query/BoolQueryTests.java    |   6 +-
 .../sql/querydsl/query/LeafQueryTests.java    |   6 +-
 .../sql/querydsl/query/MatchQueryTests.java   |  16 +-
 .../querydsl/query/MultiMatchQueryTests.java  |   6 +-
 .../sql/querydsl/query/NestedQueryTests.java  |   6 +-
 .../querydsl/query/QueryStringQueryTests.java |   6 +-
 .../xpack/sql/stats/VerifierMetricsTests.java |  12 +-
 .../xpack/sql/tree/SqlNodeSubclassTests.java  |  91 +++
 .../xpack/sql/util/LikeConversionTests.java   |   6 +-
 671 files changed, 6144 insertions(+), 4739 deletions(-)
 create mode 100644 x-pack/plugin/ql/build.gradle
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/ParsingException.java
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlClientException.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql/SqlException.java => ql/src/main/java/org/elasticsearch/xpack/ql/QlException.java} (53%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlIllegalArgumentException.java
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlServerException.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/capabilities/Resolvable.java (85%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/capabilities/Resolvables.java (91%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/capabilities/Unresolvable.java (89%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/capabilities/UnresolvedException.java (75%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/execution/search/AggRef.java (82%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/execution/search/FieldExtraction.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SqlSourceBuilder.java => ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/QlSourceBuilder.java} (84%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/AbstractFieldHitExtractor.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/execution/search/extractor/BucketExtractor.java (89%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/BucketExtractors.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/execution/search/extractor/ComputingExtractor.java (90%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/execution/search/extractor/ConstantExtractor.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/execution/search/extractor/HitExtractor.java (92%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/execution/search/extractor/HitExtractors.java (78%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/Alias.java (93%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/Attribute.java (97%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/AttributeMap.java (99%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/AttributeSet.java (98%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/Expression.java (87%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/ExpressionSet.java (98%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/Expressions.java (91%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/FieldAttribute.java (93%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/Foldables.java (81%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/LeafExpression.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/Literal.java (85%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/NameId.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/NamedExpression.java (95%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/Nullability.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/Order.java (90%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/ReferenceAttribute.java (87%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/TypeResolutions.java (91%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/TypedAttribute.java (87%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/UnaryExpression.java (92%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/UnresolvedAlias.java (90%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/UnresolvedAttribute.java (90%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/UnresolvedNamedExpression.java (78%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/UnresolvedStar.java (91%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/DefaultFunctionTypeRegistry.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/Function.java (81%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/FunctionDefinition.java (72%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionRegistry.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql/expression/NullIntolerant.java => ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionTypeRegistry.java} (57%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/Functions.java (63%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/OptionalArgument.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/UnresolvedFunction.java (92%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/aggregate/AggregateFunction.java (73%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/CompoundAggregate.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/aggregate/Count.java (85%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/aggregate/EnclosedAgg.java (85%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/aggregate/InnerAggregate.java (78%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/grouping/GroupingFunction.java (73%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/scalar/BinaryScalarFunction.java (85%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/scalar/ScalarFunction.java (78%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/scalar/UnaryScalarFunction.java (76%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/function/scalar/geo/GeoShape.java (92%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/whitelist/InternalQlScriptUtils.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/AggExtractorInput.java (63%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/AggNameInput.java (78%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/AggPathInput.java (84%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/AttributeInput.java (71%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/BinaryPipe.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/CommonNonExecutableInput.java (59%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/ConstantInput.java (65%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/HitExtractorInput.java (62%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/LeafInput.java (89%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/MultiPipe.java (76%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/NonExecutableInput.java (59%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/Pipe.java (75%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/ReferenceInput.java (67%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/UnaryPipe.java (83%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/processor/BinaryProcessor.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/processor/BucketExtractorProcessor.java (86%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/processor/ChainingProcessor.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/processor/ConstantProcessor.java (97%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/processor/FunctionalBinaryProcessor.java (97%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/processor/HitExtractorProcessor.java (86%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/processor/Processor.java (91%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/processor/UnaryProcessor.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/Agg.java (74%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/Grouping.java (78%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/Param.java (94%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/Params.java (95%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/ParamsBuilder.java (82%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/Script.java (87%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/ScriptTemplate.java (93%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/ScriptWeaver.java (81%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/Scripts.java (83%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/gen/script/Var.java (87%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/literal/Interval.java (91%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/literal/IntervalDayTime.java (92%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/literal/IntervalYearMonth.java (90%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/literal/Intervals.java (93%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/literal/Literals.java (83%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/BinaryOperator.java (80%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/BinaryPredicate.java (89%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/Negatable.java (70%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/PredicateBiFunction.java (92%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/Predicates.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/Range.java (81%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/ArbitraryConditionalFunction.java (70%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/Case.java (82%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/CasePipe.java (66%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/CaseProcessor.java (94%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/Coalesce.java (78%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/ConditionalFunction.java (76%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/ConditionalPipe.java (72%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/ConditionalProcessor.java (95%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/Conditionals.java (91%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/Greatest.java (69%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/IfConditional.java (87%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/IfNull.java (80%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/Iif.java (69%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/Least.java (69%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/NullIf.java (74%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/NullIfPipe.java (67%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/NullIfProcessor.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/fulltext/FullTextPredicate.java (87%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/fulltext/FullTextUtils.java (91%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/fulltext/MatchQueryPredicate.java (87%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/fulltext/MultiMatchQueryPredicate.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/fulltext/StringQueryPredicate.java (83%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/logical/And.java (71%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/logical/BinaryLogic.java (63%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/logical/BinaryLogicPipe.java (75%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/logical/BinaryLogicProcessor.java (82%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/logical/Not.java (69%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/logical/NotProcessor.java (82%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/logical/Or.java (71%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/nulls/CheckNullProcessor.java (94%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/nulls/IsNotNull.java (66%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/nulls/IsNull.java (65%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/Add.java (67%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/ArithmeticOperation.java (63%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/Arithmetics.java (97%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/BinaryArithmeticPipe.java (75%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/BinaryArithmeticProcessor.java (81%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java (82%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/Div.java (65%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/Mod.java (71%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/Mul.java (81%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/Neg.java (62%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/Sub.java (74%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/UnaryArithmeticProcessor.java (85%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/BinaryComparison.java (67%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/BinaryComparisonPipe.java (75%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/BinaryComparisonProcessor.java (84%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/Comparisons.java (97%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/Equals.java (69%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/GreaterThan.java (70%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/GreaterThanOrEqual.java (71%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/In.java (79%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/InPipe.java (76%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/InProcessor.java (72%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/LessThan.java (70%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/LessThanOrEqual.java (71%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/NotEquals.java (70%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/NullEquals.java (70%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/regex/Like.java (71%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/regex/LikePattern.java (94%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/regex/RLike.java (70%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/regex/RegexMatch.java (73%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/expression/predicate/regex/RegexProcessor.java (94%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/processor/Processors.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql/analysis => ql/src/main/java/org/elasticsearch/xpack/ql}/index/EsIndex.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql/analysis => ql/src/main/java/org/elasticsearch/xpack/ql}/index/IndexResolution.java (97%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql/analysis => ql/src/main/java/org/elasticsearch/xpack/ql}/index/IndexResolver.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql/analysis => ql/src/main/java/org/elasticsearch/xpack/ql}/index/MappingException.java (77%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/QueryPlan.java (92%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/TableIdentifier.java (94%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/Aggregate.java (81%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/BinaryPlan.java (77%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/EsRelation.java (90%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/Filter.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/LeafPlan.java (86%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/Limit.java (86%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/LogicalPlan.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/OrderBy.java (84%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/Project.java (80%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/UnaryPlan.java (88%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/plan/logical/UnresolvedRelation.java (89%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plugin/QlPlugin.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/rule/Rule.java (90%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/rule/RuleExecutionException.java (68%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/rule/RuleExecutor.java (97%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/session/Configuration.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/tree/Location.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/tree/Node.java (98%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/tree/NodeInfo.java (99%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/tree/NodeUtils.java (98%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/tree/Source.java (91%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/DataType.java (97%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/DataTypeConversion.java (92%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/DataTypes.java (83%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/DateEsField.java (92%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DateUtils.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/EsField.java (99%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/ExtTypes.java (96%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/InvalidMappedField.java (86%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/KeywordEsField.java (97%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/Schema.java (91%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/StringUtils.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/TextEsField.java (92%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/Types.java (99%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/type/UnsupportedEsField.java (96%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Check.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/util/CollectionUtils.java (98%)
 create mode 100644 x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/DateUtils.java
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/util/Graphviz.java (99%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/util/Holder.java (93%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/util/ReflectionUtils.java (81%)
 rename x-pack/plugin/{sql/src/main/java/org/elasticsearch/xpack/sql => ql/src/main/java/org/elasticsearch/xpack/ql}/util/StringUtils.java (89%)
 create mode 100644 x-pack/plugin/ql/src/main/resources/file.txt
 create mode 100644 x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/TestUtils.java
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/execution/search/extractor/ConstantExtractorTests.java (96%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/AttributeMapTests.java (98%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/ExpressionIdTests.java (93%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/LiteralTests.java (93%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/NullabilityTests.java (81%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/TyperResolutionTests.java (77%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/UnresolvedAttributeTests.java (95%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/function/FunctionRegistryTests.java (87%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/function/NamedExpressionTests.java (63%)
 create mode 100644 x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/TestFunctionRegistry.java
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/function/UnresolvedFunctionTests.java (93%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/function/scalar/FunctionTestUtils.java (92%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/AttributeInputTests.java (69%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/BinaryPipesTests.java (88%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/gen/pipeline/UnaryPipeTests.java (74%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/gen/processor/ChainingProcessorTests.java (58%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/gen/processor/ConstantProcessorTests.java (89%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/literal/IntervalsTests.java (88%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/CaseTests.java (82%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/conditional/IifTests.java (76%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/fulltext/FullTextUtilsTests.java (83%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/logical/BinaryLogicProcessorTests.java (93%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/nulls/CheckNullProcessorTests.java (78%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/BinaryArithmeticProcessorTests.java (76%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java (87%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/BinaryComparisonProcessorTests.java (91%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/InProcessorTests.java (83%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/expression/predicate/operator/comparison/InTests.java (84%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/tree/AbstractNodeTestCase.java (97%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/tree/NodeSubclassTests.java (87%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/tree/NodeTests.java (97%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/tree/SourceTests.java (97%)
 create mode 100644 x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/TestCompoundAggregate.java
 create mode 100644 x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/TestEnclosedAgg.java
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/type/DataTypeConversionTests.java (82%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/type/DataTypesTests.java (76%)
 rename x-pack/plugin/{sql/src/test/java/org/elasticsearch/xpack/sql => ql/src/test/java/org/elasticsearch/xpack/ql}/type/TypesTests.java (92%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-basic-incompatible.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-basic-nodocvalues.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-basic.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-date-multi.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-date-no-format.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-date.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-default-string.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-docvalues.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-dotted-field.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-geo.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-ip.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-keyword.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-multi-field-options.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-multi-field-variation.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-multi-field-with-nested.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-multi-field.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-nested.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-numeric.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-object.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-parent-child.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-text.json (100%)
 rename x-pack/plugin/{sql => ql}/src/test/resources/mapping-unsupported.json (100%)
 rename x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/{ClientSqlException.java => SqlClientException.java} (57%)
 rename x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/{ServerSqlException.java => SqlServerException.java} (57%)
 rename x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/{BucketExtractors.java => SqlBucketExtractors.java} (80%)
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/SqlHitExtractors.java
 delete mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionRegistry.java
 delete mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionType.java
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/SqlFunctionRegistry.java
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/SqlFunctionTypeRegistry.java
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalScriptUtils.java
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/SqlLiterals.java
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Session.java
 create mode 100644 x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SqlExecutable.java
 rename x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/{ => parser}/ParameterTests.java (74%)
 rename x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/{ => parser}/QuotingTests.java (91%)
 create mode 100644 x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowFunctionsTests.java
 create mode 100644 x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SqlNodeSubclassTests.java

diff --git a/x-pack/plugin/ql/build.gradle b/x-pack/plugin/ql/build.gradle
new file mode 100644
index 0000000000000..c74b8a8bcb4a3
--- /dev/null
+++ b/x-pack/plugin/ql/build.gradle
@@ -0,0 +1,36 @@
+evaluationDependsOn(xpackModule('core'))
+
+apply plugin: 'elasticsearch.esplugin'
+esplugin {
+  name 'x-pack-ql'
+  description 'Elasticsearch infrastructure plugin for EQL and SQL for Elasticsearch'
+  classname 'org.elasticsearch.xpack.ql.plugin.QlPlugin'
+  extendedPlugins = ['x-pack-core']
+}
+
+archivesBaseName = 'x-pack-ql'
+
+dependencies {
+  compileOnly project(path: xpackModule('core'), configuration: 'default')
+  testCompile project(':test:framework')
+  testCompile project(path: xpackModule('core'), configuration: 'testArtifacts')
+}
+
+configurations {
+  testArtifacts.extendsFrom testRuntime
+}
+
+task testJar(type: Jar) {
+  appendix 'test'
+  from sourceSets.test.output
+}
+
+artifacts {
+  // normal es plugins do not publish the jar but we need to since users need it for extensions
+  archives jar
+  testArtifacts testJar
+}
+
+
+// disable integration tests for now
+integTest.enabled = false
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/ParsingException.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/ParsingException.java
new file mode 100644
index 0000000000000..d2ffd5fe21c00
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/ParsingException.java
@@ -0,0 +1,61 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql;
+
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.xpack.ql.tree.Source;
+
+import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
+
+public class ParsingException extends QlClientException {
+    private final int line;
+    private final int charPositionInLine;
+
+    public ParsingException(String message, Exception cause, int line, int charPositionInLine) {
+        super(message, cause);
+        this.line = line;
+        this.charPositionInLine = charPositionInLine;
+    }
+
+    public ParsingException(String message, Object... args) {
+        this(Source.EMPTY, message, args);
+    }
+
+    public ParsingException(Source source, String message, Object... args) {
+        super(message, args);
+        this.line = source.source().getLineNumber();
+        this.charPositionInLine = source.source().getColumnNumber();
+    }
+
+    public ParsingException(Exception cause, Source source, String message, Object... args) {
+        super(cause, message, args);
+        this.line = source.source().getLineNumber();
+        this.charPositionInLine = source.source().getColumnNumber();
+    }
+
+    public int getLineNumber() {
+        return line;
+    }
+
+    public int getColumnNumber() {
+        return charPositionInLine + 1;
+    }
+
+    public String getErrorMessage() {
+        return super.getMessage();
+    }
+
+    @Override
+    public RestStatus status() {
+        return RestStatus.BAD_REQUEST;
+    }
+
+    @Override
+    public String getMessage() {
+        return format("line {}:{}: {}", getLineNumber(), getColumnNumber(), getErrorMessage());
+    }
+}
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlClientException.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlClientException.java
new file mode 100644
index 0000000000000..684091229be5a
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlClientException.java
@@ -0,0 +1,29 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql;
+
+public abstract class QlClientException extends QlException {
+
+    protected QlClientException(String message, Object... args) {
+        super(message, args);
+    }
+
+    protected QlClientException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
+        super(message, cause, enableSuppression, writableStackTrace);
+    }
+
+    protected QlClientException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+    protected QlClientException(Throwable cause, String message, Object... args) {
+        super(cause, message, args);
+    }
+
+    protected QlClientException(Throwable cause) {
+        super(cause);
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlException.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlException.java
similarity index 53%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlException.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlException.java
index 84b40b221d9ea..2262e6f414a5b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlException.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlException.java
@@ -3,28 +3,28 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql;
+package org.elasticsearch.xpack.ql;
 
 import org.elasticsearch.ElasticsearchException;
 
-public abstract class SqlException extends ElasticsearchException {
-    public SqlException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
+public abstract class QlException extends ElasticsearchException {
+    public QlException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
         super(message, cause, enableSuppression, writableStackTrace);
     }
 
-    public SqlException(String message, Throwable cause) {
+    public QlException(String message, Throwable cause) {
         super(message, cause);
     }
 
-    public SqlException(String message, Object... args) {
+    public QlException(String message, Object... args) {
         super(message, args);
     }
 
-    public SqlException(Throwable cause, String message, Object... args) {
+    public QlException(Throwable cause, String message, Object... args) {
         super(message, cause, args);
     }
 
-    public SqlException(Throwable cause) {
+    public QlException(Throwable cause) {
         super(cause);
     }
 }
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlIllegalArgumentException.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlIllegalArgumentException.java
new file mode 100644
index 0000000000000..2c7013422e8ed
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlIllegalArgumentException.java
@@ -0,0 +1,32 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql;
+
+public class QlIllegalArgumentException extends QlServerException {
+    public QlIllegalArgumentException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
+        super(message, cause, enableSuppression, writableStackTrace);
+    }
+
+    public QlIllegalArgumentException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+    public QlIllegalArgumentException(String message, Object... args) {
+        super(message, args);
+    }
+
+    public QlIllegalArgumentException(Throwable cause, String message, Object... args) {
+        super(cause, message, args);
+    }
+
+    public QlIllegalArgumentException(String message) {
+        super(message);
+    }
+
+    public QlIllegalArgumentException(Throwable cause) {
+        super(cause);
+    }
+}
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlServerException.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlServerException.java
new file mode 100644
index 0000000000000..8ab942dc71e5d
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/QlServerException.java
@@ -0,0 +1,29 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql;
+
+public abstract class QlServerException extends QlException {
+
+    protected QlServerException(String message, Object... args) {
+        super(message, args);
+    }
+
+    protected QlServerException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
+        super(message, cause, enableSuppression, writableStackTrace);
+    }
+
+    protected QlServerException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+    protected QlServerException(Throwable cause, String message, Object... args) {
+        super(cause, message, args);
+    }
+
+    protected QlServerException(Throwable cause) {
+        super(cause);
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Resolvable.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Resolvable.java
similarity index 85%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Resolvable.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Resolvable.java
index a627f06165573..ba0edfb4ad195 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Resolvable.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Resolvable.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.capabilities;
+package org.elasticsearch.xpack.ql.capabilities;
 
 public interface Resolvable {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Resolvables.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Resolvables.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Resolvables.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Resolvables.java
index 222ba7a87c068..6e3ebc1a2081f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Resolvables.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Resolvables.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.capabilities;
+package org.elasticsearch.xpack.ql.capabilities;
 
 public abstract class Resolvables {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Unresolvable.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Unresolvable.java
similarity index 89%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Unresolvable.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Unresolvable.java
index 9cd2e6416974c..e9cda9c7cfa1e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/Unresolvable.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/Unresolvable.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.capabilities;
+package org.elasticsearch.xpack.ql.capabilities;
 
 
 public interface Unresolvable extends Resolvable {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/UnresolvedException.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/UnresolvedException.java
similarity index 75%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/UnresolvedException.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/UnresolvedException.java
index 0db87c6b944e4..4aad197aade3f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/capabilities/UnresolvedException.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/capabilities/UnresolvedException.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.capabilities;
+package org.elasticsearch.xpack.ql.capabilities;
 
-import org.elasticsearch.xpack.sql.ServerSqlException;
+import org.elasticsearch.xpack.ql.QlServerException;
 
 /**
  * Thrown when we accidentally attempt to resolve something on on an unresolved entity. Throwing this
  * is always a bug.
  */
-public class UnresolvedException extends ServerSqlException {
+public class UnresolvedException extends QlServerException {
     public UnresolvedException(String action, Object target) {
         super("Invalid call to {} on an unresolved object {}", action, target);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/AggRef.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/AggRef.java
similarity index 82%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/AggRef.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/AggRef.java
index 5c9ec6dc623e5..565d465fa25eb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/AggRef.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/AggRef.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search;
+package org.elasticsearch.xpack.ql.execution.search;
 
 /**
  * Reference to a ES aggregation (which can be either a GROUP BY or Metric agg).
@@ -11,7 +11,7 @@
 public abstract class AggRef implements FieldExtraction {
 
     @Override
-    public void collectFields(SqlSourceBuilder sourceBuilder) {
+    public void collectFields(QlSourceBuilder sourceBuilder) {
         // Aggregations do not need any special fields
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/FieldExtraction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/FieldExtraction.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/FieldExtraction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/FieldExtraction.java
index 71e8db18d5094..a1756c7439a09 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/FieldExtraction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/FieldExtraction.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search;
+package org.elasticsearch.xpack.ql.execution.search;
 
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 
@@ -17,7 +17,7 @@ public interface FieldExtraction {
      * in order to fetch the field. This can include tracking the score,
      * {@code _source} fields, doc values fields, and script fields.
      */
-    void collectFields(SqlSourceBuilder sourceBuilder);
+    void collectFields(QlSourceBuilder sourceBuilder);
 
     /**
      * Is this aggregation supported in an "aggregation only" query
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SqlSourceBuilder.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/QlSourceBuilder.java
similarity index 84%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SqlSourceBuilder.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/QlSourceBuilder.java
index 1872748c328fa..06bc216b812a7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SqlSourceBuilder.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/QlSourceBuilder.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search;
+package org.elasticsearch.xpack.ql.execution.search;
 
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.script.Script;
@@ -20,15 +20,15 @@
  * {@link FieldExtraction} that can "build" whatever needs to be extracted from
  * the resulting ES document as a field.
  */
-public class SqlSourceBuilder {
+public class QlSourceBuilder {
     // The LinkedHashMaps preserve the order of the fields in the response
-    final Set<String> sourceFields = new LinkedHashSet<>();
-    final Set<FieldAndFormat> docFields = new LinkedHashSet<>();
-    final Map<String, Script> scriptFields = new LinkedHashMap<>();
+    private final Set<String> sourceFields = new LinkedHashSet<>();
+    private final Set<FieldAndFormat> docFields = new LinkedHashSet<>();
+    private final Map<String, Script> scriptFields = new LinkedHashMap<>();
 
     boolean trackScores = false;
 
-    public SqlSourceBuilder() {
+    public QlSourceBuilder() {
     }
 
     /**
@@ -71,4 +71,8 @@ public void build(SearchSourceBuilder sourceBuilder) {
         docFields.forEach(field -> sourceBuilder.docValueField(field.field, field.format));
         scriptFields.forEach(sourceBuilder::scriptField);
     }
+
+    public boolean noSource() {
+        return sourceFields.isEmpty();
+    }
 }
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/AbstractFieldHitExtractor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/AbstractFieldHitExtractor.java
new file mode 100644
index 0000000000000..9be92337c2545
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/AbstractFieldHitExtractor.java
@@ -0,0 +1,314 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql.execution.search.extractor;
+
+import org.elasticsearch.Version;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.document.DocumentField;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.index.mapper.IgnoredFieldMapper;
+import org.elasticsearch.search.SearchHit;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.type.DataType;
+
+import java.io.IOException;
+import java.time.ZoneId;
+import java.util.ArrayDeque;
+import java.util.Deque;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.StringJoiner;
+
+/**
+ * Extractor for ES fields. Works for both 'normal' fields but also nested ones (which require hitName to be set).
+ * The latter is used as metadata in assembling the results in the tabular response.
+ */
+public abstract class AbstractFieldHitExtractor implements HitExtractor {
+
+    private static final Version SWITCHED_FROM_DOCVALUES_TO_SOURCE_EXTRACTION = Version.V_7_4_0;
+
+    /**
+     * Source extraction requires only the (relative) field name, without its parent path.
+     */
+    private static String[] sourcePath(String name, boolean useDocValue, String hitName) {
+        return useDocValue ? Strings.EMPTY_ARRAY : Strings
+                .tokenizeToStringArray(hitName == null ? name : name.substring(hitName.length() + 1), ".");
+    }
+
+    private final String fieldName, hitName;
+    private final String fullFieldName; // used to look at the _ignored section of the query response for the actual full field name
+    private final DataType dataType;
+    private final ZoneId zoneId;
+    private final boolean useDocValue;
+    private final boolean arrayLeniency;
+    private final String[] path;
+
+    protected AbstractFieldHitExtractor(String name, DataType dataType, ZoneId zoneId, boolean useDocValue) {
+        this(name, null, dataType, zoneId, useDocValue, null, false);
+    }
+
+    protected AbstractFieldHitExtractor(String name, DataType dataType, ZoneId zoneId, boolean useDocValue, boolean arrayLeniency) {
+        this(name, null, dataType, zoneId, useDocValue, null, arrayLeniency);
+    }
+
+    protected AbstractFieldHitExtractor(String name, String fullFieldName, DataType dataType, ZoneId zoneId, boolean useDocValue,
+            String hitName, boolean arrayLeniency) {
+        this.fieldName = name;
+        this.fullFieldName = fullFieldName;
+        this.dataType = dataType;
+        this.zoneId = zoneId;
+        this.useDocValue = useDocValue;
+        this.arrayLeniency = arrayLeniency;
+        this.hitName = hitName;
+
+        if (hitName != null) {
+            if (!name.contains(hitName)) {
+                throw new QlIllegalArgumentException("Hitname [{}] specified but not part of the name [{}]", hitName, name);
+            }
+        }
+
+        this.path = sourcePath(fieldName, useDocValue, hitName);
+    }
+
+    protected AbstractFieldHitExtractor(StreamInput in) throws IOException {
+        fieldName = in.readString();
+        if (in.getVersion().onOrAfter(SWITCHED_FROM_DOCVALUES_TO_SOURCE_EXTRACTION)) {
+            fullFieldName = in.readOptionalString();
+        } else {
+            fullFieldName = null;
+        }
+        String esType = in.readOptionalString();
+        dataType = esType != null ? DataType.fromTypeName(esType) : null;
+        useDocValue = in.readBoolean();
+        hitName = in.readOptionalString();
+        arrayLeniency = in.readBoolean();
+        path = sourcePath(fieldName, useDocValue, hitName);
+        zoneId = readZoneId(in);
+    }
+
+    protected abstract ZoneId readZoneId(StreamInput in) throws IOException;
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeString(fieldName);
+        if (out.getVersion().onOrAfter(SWITCHED_FROM_DOCVALUES_TO_SOURCE_EXTRACTION)) {
+            out.writeOptionalString(fullFieldName);
+        }
+        out.writeOptionalString(dataType == null ? null : dataType.typeName());
+        out.writeBoolean(useDocValue);
+        out.writeOptionalString(hitName);
+        out.writeBoolean(arrayLeniency);
+    }
+
+    @Override
+    public Object extract(SearchHit hit) {
+        Object value = null;
+        if (useDocValue) {
+            DocumentField field = hit.field(fieldName);
+            if (field != null) {
+                value = unwrapMultiValue(field.getValues());
+            }
+        } else {
+            // if the field was ignored because it was malformed and ignore_malformed was turned on
+            if (fullFieldName != null
+                    && hit.getFields().containsKey(IgnoredFieldMapper.NAME)
+                    && dataType.isFromDocValuesOnly() == false
+                    && dataType.isNumeric()) {
+                /*
+                 * ignore_malformed makes sense for extraction from _source for numeric fields only.
+                 * And we check here that the data type is actually a numeric one to rule out
+                 * any non-numeric sub-fields (for which the "parent" field should actually be extracted from _source).
+                 * For example, in the case of a malformed number, a "byte" field with "ignore_malformed: true"
+                 * with a "text" sub-field should return "null" for the "byte" parent field and the actual malformed
+                 * data for the "text" sub-field. Also, the _ignored section of the response contains the full field
+                 * name, thus the need to do the comparison with that and not only the field name.
+                 */
+                if (hit.getFields().get(IgnoredFieldMapper.NAME).getValues().contains(fullFieldName)) {
+                    return null;
+                }
+            }
+            Map<String, Object> source = hit.getSourceAsMap();
+            if (source != null) {
+                value = extractFromSource(source);
+            }
+        }
+        return value;
+    }
+
+    protected Object unwrapMultiValue(Object values) {
+        if (values == null) {
+            return null;
+        }
+        if (values instanceof List) {
+            List<?> list = (List<?>) values;
+            if (list.isEmpty()) {
+                return null;
+            } else {
+                if (isPrimitive(list) == false) {
+                    if (list.size() == 1 || arrayLeniency) {
+                        return unwrapMultiValue(list.get(0));
+                    } else {
+                        throw new QlIllegalArgumentException("Arrays (returned by [{}]) are not supported", fieldName);
+                    }
+                }
+            }
+        }
+
+        Object unwrapped = unwrapCustomValue(values);
+        if (unwrapped != null) {
+            return unwrapped;
+        }
+
+        // The Jackson json parser can generate for numerics - Integers, Longs, BigIntegers (if Long is not enough)
+        // and BigDecimal (if Double is not enough)
+        if (values instanceof Number || values instanceof String || values instanceof Boolean) {
+            if (dataType == null) {
+                return values;
+            }
+            if (dataType.isNumeric() && dataType.isFromDocValuesOnly() == false) {
+                if (dataType == DataType.DOUBLE || dataType == DataType.FLOAT || dataType == DataType.HALF_FLOAT) {
+                    Number result = null;
+                    try {
+                        result = dataType.numberType().parse(values, true);
+                    } catch(IllegalArgumentException iae) {
+                        return null;
+                    }
+                    // docvalue_fields is always returning a Double value even if the underlying floating point data type is not Double
+                    // even if we don't extract from docvalue_fields anymore, the behavior should be consistent
+                    return result.doubleValue();
+                } else {
+                    Number result = null;
+                    try {
+                        result = dataType.numberType().parse(values, true);
+                    } catch(IllegalArgumentException iae) {
+                        return null;
+                    }
+                    return result;
+                }
+            } else if (dataType.isString()) {
+                return values.toString();
+            } else {
+                return values;
+            }
+        }
+        throw new QlIllegalArgumentException("Type {} (returned by [{}]) is not supported", values.getClass().getSimpleName(), fieldName);
+    }
+
+    protected abstract Object unwrapCustomValue(Object values);
+
+    protected abstract boolean isPrimitive(List<?> list);
+
+    @SuppressWarnings({ "unchecked", "rawtypes" })
+    protected Object extractFromSource(Map<String, Object> map) {
+        Object value = null;
+
+        // Used to avoid recursive method calls
+        // Holds the sub-maps in the document hierarchy that are pending to be inspected along with the current index of the `path`.
+        Deque<Tuple<Integer, Map<String, Object>>> queue = new ArrayDeque<>();
+        queue.add(new Tuple<>(-1, map));
+
+        while (!queue.isEmpty()) {
+            Tuple<Integer, Map<String, Object>> tuple = queue.removeLast();
+            int idx = tuple.v1();
+            Map<String, Object> subMap = tuple.v2();
+
+            // Find all possible entries by examining all combinations under the current level ("idx") of the "path"
+            // e.g.: If the path == "a.b.c.d" and the idx == 0, we need to check the current subMap against the keys:
+            //       "b", "b.c" and "b.c.d"
+            StringJoiner sj = new StringJoiner(".");
+            for (int i = idx + 1; i < path.length; i++) {
+                sj.add(path[i]);
+                Object node = subMap.get(sj.toString());
+
+                if (node instanceof List) {
+                    List listOfValues = (List) node;
+                    // we can only do this optimization until the last element of our pass since geo points are using arrays
+                    // and we don't want to blindly ignore the second element of array if arrayLeniency is enabled
+                    if ((i < path.length - 1) && (listOfValues.size() == 1 || arrayLeniency)) {
+                        // this is a List with a size of 1 e.g.: {"a" : [{"b" : "value"}]} meaning the JSON is a list with one element
+                        // or a list of values with one element e.g.: {"a": {"b" : ["value"]}}
+                        // in case of being lenient about arrays, just extract the first value in the array
+                        node = listOfValues.get(0);
+                    } else {
+                        // a List of elements with more than one value. Break early and let unwrapMultiValue deal with the list
+                        return unwrapMultiValue(node);
+                    }
+                }
+
+                if (node instanceof Map) {
+                    if (i < path.length - 1) {
+                        // Add the sub-map to the queue along with the current path index
+                        queue.add(new Tuple<>(i, (Map<String, Object>) node));
+                    } else {
+                        // We exhausted the path and got a map
+                        // If it is an object - it will be handled in the value extractor
+                        value = node;
+                    }
+                } else if (node != null) {
+                    if (i < path.length - 1) {
+                        // If we reach a concrete value without exhausting the full path, something is wrong with the mapping
+                        // e.g.: map is {"a" : { "b" : "value }} and we are looking for a path: "a.b.c.d"
+                        throw new QlIllegalArgumentException("Cannot extract value [{}] from source", fieldName);
+                    }
+                    if (value != null) {
+                        // A value has already been found so this means that there are more than one
+                        // values in the document for the same path but different hierarchy.
+                        // e.g.: {"a" : {"b" : {"c" : "value"}}}, {"a.b" : {"c" : "value"}}, ...
+                        throw new QlIllegalArgumentException("Multiple values (returned by [{}]) are not supported", fieldName);
+                    }
+                    value = node;
+                }
+            }
+        }
+        return unwrapMultiValue(value);
+    }
+
+    @Override
+    public String hitName() {
+        return hitName;
+    }
+
+    public String fieldName() {
+        return fieldName;
+    }
+
+    public String fullFieldName() {
+        return fullFieldName;
+    }
+
+    public ZoneId zoneId() {
+        return zoneId;
+    }
+
+    protected DataType dataType() {
+        return dataType;
+    }
+
+    @Override
+    public String toString() {
+        return fieldName + "@" + hitName + "@" + zoneId;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (obj == null || obj.getClass() != getClass()) {
+            return false;
+        }
+        AbstractFieldHitExtractor other = (AbstractFieldHitExtractor) obj;
+        return fieldName.equals(other.fieldName)
+                && hitName.equals(other.hitName)
+                && useDocValue == other.useDocValue
+                && arrayLeniency == other.arrayLeniency;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(fieldName, useDocValue, hitName, arrayLeniency);
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/BucketExtractor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/BucketExtractor.java
similarity index 89%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/BucketExtractor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/BucketExtractor.java
index 230ad88eea59c..05c7446d9e7d4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/BucketExtractor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/BucketExtractor.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search.extractor;
+package org.elasticsearch.xpack.ql.execution.search.extractor;
 
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/BucketExtractors.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/BucketExtractors.java
new file mode 100644
index 0000000000000..18f0725fdaa94
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/BucketExtractors.java
@@ -0,0 +1,28 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql.execution.search.extractor;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry.Entry;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public final class BucketExtractors {
+
+    private BucketExtractors() {}
+
+    /**
+     * All of the named writeables needed to deserialize the instances of
+     * {@linkplain BucketExtractor}s.
+     */
+    public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
+        List<NamedWriteableRegistry.Entry> entries = new ArrayList<>();
+        entries.add(new Entry(BucketExtractor.class, ComputingExtractor.NAME, ComputingExtractor::new));
+        entries.add(new Entry(BucketExtractor.class, ConstantExtractor.NAME, ConstantExtractor::new));
+        return entries;
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ComputingExtractor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/ComputingExtractor.java
similarity index 90%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ComputingExtractor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/ComputingExtractor.java
index 92f81b6ac4308..7ad48a30a047d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ComputingExtractor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/ComputingExtractor.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search.extractor;
+package org.elasticsearch.xpack.ql.execution.search.extractor;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
-import org.elasticsearch.xpack.sql.expression.gen.processor.HitExtractorProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.HitExtractorProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
@@ -44,7 +44,8 @@ public ComputingExtractor(Processor processor, String hitName) {
         this.hitName = hitName;
     }
 
-    ComputingExtractor(StreamInput in) throws IOException {
+    // Visibility required for tests
+    public ComputingExtractor(StreamInput in) throws IOException {
         processor = in.readNamedWriteable(Processor.class);
         hitName = in.readOptionalString();
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ConstantExtractor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/ConstantExtractor.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ConstantExtractor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/ConstantExtractor.java
index e9bd3b2a6768e..54b083eb583f7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ConstantExtractor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/ConstantExtractor.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search.extractor;
+package org.elasticsearch.xpack.ql.execution.search.extractor;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/HitExtractor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/HitExtractor.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/HitExtractor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/HitExtractor.java
index c0de33c812819..db68d130e7dbb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/HitExtractor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/HitExtractor.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search.extractor;
+package org.elasticsearch.xpack.ql.execution.search.extractor;
 
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.io.stream.NamedWriteable;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/HitExtractors.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/HitExtractors.java
similarity index 78%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/HitExtractors.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/HitExtractors.java
index 1036829902e50..b43320160039c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/HitExtractors.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/execution/search/extractor/HitExtractors.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search.extractor;
+package org.elasticsearch.xpack.ql.execution.search.extractor;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry.Entry;
@@ -22,9 +22,7 @@ private HitExtractors() {}
     public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
         List<NamedWriteableRegistry.Entry> entries = new ArrayList<>();
         entries.add(new Entry(HitExtractor.class, ConstantExtractor.NAME, ConstantExtractor::new));
-        entries.add(new Entry(HitExtractor.class, FieldHitExtractor.NAME, FieldHitExtractor::new));
         entries.add(new Entry(HitExtractor.class, ComputingExtractor.NAME, ComputingExtractor::new));
-        entries.add(new Entry(HitExtractor.class, ScoreExtractor.NAME, in -> ScoreExtractor.INSTANCE));
         return entries;
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Alias.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Alias.java
similarity index 93%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Alias.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Alias.java
index ef8611b49690f..de31a7d82a2d7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Alias.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Alias.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Attribute.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Attribute.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Attribute.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Attribute.java
index bda8287115e0f..2b5d1e4df1842 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Attribute.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Attribute.java
@@ -3,10 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeMap.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/AttributeMap.java
similarity index 99%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeMap.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/AttributeMap.java
index b513671a21d37..cdfd4d20bc71c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeMap.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/AttributeMap.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import java.util.AbstractSet;
 import java.util.Collection;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeSet.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/AttributeSet.java
similarity index 98%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeSet.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/AttributeSet.java
index f8b89ac4b08fc..585d3d5da10c9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/AttributeSet.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/AttributeSet.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import java.util.Collection;
 import java.util.Iterator;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Expression.java
similarity index 87%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Expression.java
index 166ccd72f711f..7e12acec9fbab 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expression.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Expression.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.capabilities.Resolvable;
-import org.elasticsearch.xpack.sql.capabilities.Resolvables;
-import org.elasticsearch.xpack.sql.tree.Node;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.capabilities.Resolvable;
+import org.elasticsearch.xpack.ql.capabilities.Resolvables;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.List;
 
@@ -69,7 +69,7 @@ public boolean foldable() {
     }
 
     public Object fold() {
-        throw new SqlIllegalArgumentException("Should not fold expression");
+        throw new QlIllegalArgumentException("Should not fold expression");
     }
 
     public abstract Nullability nullable();
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ExpressionSet.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/ExpressionSet.java
similarity index 98%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ExpressionSet.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/ExpressionSet.java
index 3adea47c6b853..925e595cbed7c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ExpressionSet.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/ExpressionSet.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import java.util.Collection;
 import java.util.Iterator;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expressions.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Expressions.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expressions.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Expressions.java
index 92703f4768f70..7bdf244e4cf6e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Expressions.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Expressions.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AttributeInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.ConstantInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.AttributeInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.ConstantInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypes;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -192,7 +192,7 @@ public static Pipe pipe(Expression e) {
         if (e instanceof Function) {
             return ((Function) e).asPipe();
         }
-        throw new SqlIllegalArgumentException("Cannot create pipe for {}", e);
+        throw new QlIllegalArgumentException("Cannot create pipe for {}", e);
     }
 
     public static List<Pipe> pipe(List<Expression> expressions) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/FieldAttribute.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/FieldAttribute.java
similarity index 93%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/FieldAttribute.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/FieldAttribute.java
index f802c9a940dd1..5ab482fbfd4c3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/FieldAttribute.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/FieldAttribute.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Foldables.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Foldables.java
similarity index 81%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Foldables.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Foldables.java
index c7297edb126ad..f70f6423497f7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Foldables.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Foldables.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -22,14 +22,14 @@ public static <T> T valueOf(Expression e, DataType to) {
         if (e.foldable()) {
             return (T) DataTypeConversion.conversionFor(e.dataType(), to).convert(e.fold());
         }
-        throw new SqlIllegalArgumentException("Cannot determine value for {}", e);
+        throw new QlIllegalArgumentException("Cannot determine value for {}", e);
     }
 
     public static Object valueOf(Expression e) {
         if (e.foldable()) {
             return e.fold();
         }
-        throw new SqlIllegalArgumentException("Cannot determine value for {}", e);
+        throw new QlIllegalArgumentException("Cannot determine value for {}", e);
     }
 
     public static Integer intValueOf(Expression e) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/LeafExpression.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/LeafExpression.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/LeafExpression.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/LeafExpression.java
index 16646452a31ad..15f30599d56ba 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/LeafExpression.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/LeafExpression.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Literal.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Literal.java
similarity index 85%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Literal.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Literal.java
index 315b1bb308eb7..1813799aad19b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Literal.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Literal.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
-import org.elasticsearch.xpack.sql.type.DataTypes;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.type.DataTypes;
 
 import java.util.Objects;
 
@@ -110,7 +110,7 @@ public static Literal of(Source source, Object value) {
      */
     public static Literal of(Expression foldable) {
         if (!foldable.foldable()) {
-            throw new SqlIllegalArgumentException("Foldable expression required for Literal creation; received unfoldable " + foldable);
+            throw new QlIllegalArgumentException("Foldable expression required for Literal creation; received unfoldable " + foldable);
         }
 
         if (foldable instanceof Literal) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NameId.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/NameId.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NameId.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/NameId.java
index bc74a506d77af..59a775742b798 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NameId.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/NameId.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import java.util.Objects;
 import java.util.concurrent.atomic.AtomicLong;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NamedExpression.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/NamedExpression.java
similarity index 95%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NamedExpression.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/NamedExpression.java
index 633e230393049..96680c39c7a84 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NamedExpression.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/NamedExpression.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Nullability.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Nullability.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Nullability.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Nullability.java
index ac46bdf2aa92b..6a6fd9eae2718 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Nullability.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Nullability.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 public enum Nullability {
     TRUE,    // Whether the expression can become null
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Order.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Order.java
similarity index 90%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Order.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Order.java
index 3642ac94d8e79..19b198865d9b2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Order.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Order.java
@@ -3,17 +3,17 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 import java.util.Objects;
 
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isExact;
 
 public class Order extends Expression {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ReferenceAttribute.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/ReferenceAttribute.java
similarity index 87%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ReferenceAttribute.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/ReferenceAttribute.java
index 03330bc1148f5..6387c79194518 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ReferenceAttribute.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/ReferenceAttribute.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 /**
  * Attribute based on a reference to an expression.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypeResolutions.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/TypeResolutions.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypeResolutions.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/TypeResolutions.java
index 30041ea12224b..f59415e990341 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypeResolutions.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/TypeResolutions.java
@@ -3,20 +3,20 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.expression.Expression.TypeResolution;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
+import org.elasticsearch.xpack.ql.expression.Expression.TypeResolution;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
 
 import java.util.Locale;
 import java.util.StringJoiner;
 import java.util.function.Predicate;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.Expressions.name;
-import static org.elasticsearch.xpack.sql.type.DataType.BOOLEAN;
+import static org.elasticsearch.xpack.ql.expression.Expressions.name;
+import static org.elasticsearch.xpack.ql.type.DataType.BOOLEAN;
 
 public final class TypeResolutions {
 
@@ -64,7 +64,7 @@ public static TypeResolution isExact(Expression e, String message) {
         if (e instanceof FieldAttribute) {
             EsField.Exact exact = ((FieldAttribute) e).getExactInfo();
             if (exact.hasExact() == false) {
-                return new TypeResolution(format(null, message, e.dataType().typeName, exact.errorMsg()));
+                return new TypeResolution(format(null, message, e.dataType().typeName(), exact.errorMsg()));
             }
         }
         return TypeResolution.TYPE_RESOLVED;
@@ -78,7 +78,7 @@ public static TypeResolution isExact(Expression e, String operationName, ParamOr
                     operationName,
                     paramOrd == null || paramOrd == ParamOrdinal.DEFAULT ?
                         "" : paramOrd.name().toLowerCase(Locale.ROOT) + " argument ",
-                    e.dataType().typeName, exact.errorMsg()));
+                    e.dataType().typeName(), exact.errorMsg()));
             }
         }
         return TypeResolution.TYPE_RESOLVED;
@@ -125,7 +125,7 @@ public static TypeResolution isType(Expression e,
                 operationName,
                 acceptedTypesForErrorMsg(acceptedTypes),
                 name(e),
-                e.dataType().typeName));
+                e.dataType().typeName()));
     }
 
     private static String acceptedTypesForErrorMsg(String... acceptedTypes) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypedAttribute.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/TypedAttribute.java
similarity index 87%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypedAttribute.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/TypedAttribute.java
index 98f91d4dca158..613e030aed8f7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/TypedAttribute.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/TypedAttribute.java
@@ -3,10 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnaryExpression.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnaryExpression.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnaryExpression.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnaryExpression.java
index 69cb510704288..48c7b7bd11388 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnaryExpression.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnaryExpression.java
@@ -3,10 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAlias.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedAlias.java
similarity index 90%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAlias.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedAlias.java
index 67bbee18b392e..b86d0d017176d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAlias.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedAlias.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.capabilities.UnresolvedException;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttribute.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedAttribute.java
similarity index 90%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttribute.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedAttribute.java
index 34b8eca1c3551..3fb6be16ba82a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttribute.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedAttribute.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
-
-import org.elasticsearch.xpack.sql.capabilities.Unresolvable;
-import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.CollectionUtils;
+package org.elasticsearch.xpack.ql.expression;
+
+import org.elasticsearch.xpack.ql.capabilities.Unresolvable;
+import org.elasticsearch.xpack.ql.capabilities.UnresolvedException;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedNamedExpression.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedNamedExpression.java
similarity index 78%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedNamedExpression.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedNamedExpression.java
index 5e27180541dfa..b0d36a8d1cc48 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedNamedExpression.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedNamedExpression.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.capabilities.Unresolvable;
-import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.capabilities.Unresolvable;
+import org.elasticsearch.xpack.ql.capabilities.UnresolvedException;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedStar.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedStar.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedStar.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedStar.java
index 0f38a12d7963a..c2d25dc31fcb8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/UnresolvedStar.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/UnresolvedStar.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.capabilities.UnresolvedException;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/DefaultFunctionTypeRegistry.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/DefaultFunctionTypeRegistry.java
new file mode 100644
index 0000000000000..c9feab80c3d18
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/DefaultFunctionTypeRegistry.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql.expression.function;
+
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalFunction;
+
+
+public class DefaultFunctionTypeRegistry implements FunctionTypeRegistry {
+
+    public static final DefaultFunctionTypeRegistry INSTANCE = new DefaultFunctionTypeRegistry();
+
+    private enum Types {
+        AGGREGATE(AggregateFunction.class),
+        CONDITIONAL(ConditionalFunction.class),
+        SCALAR(ScalarFunction.class);
+
+        private Class<? extends Function> baseClass;
+
+        Types(Class<? extends Function> base) {
+            this.baseClass = base;
+        }
+    }
+
+    @Override
+    public String type(Class<? extends Function> clazz) {
+        for (Types type : Types.values()) {
+            if (type.baseClass.isAssignableFrom(clazz)) {
+                return type.name();
+            }
+        }
+        return "UNKNOWN";
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Function.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/Function.java
similarity index 81%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Function.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/Function.java
index 47e160df57853..a3738f313d63d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Function.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/Function.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.ConstantInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
+package org.elasticsearch.xpack.ql.expression.function;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.ConstantInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Locale;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionDefinition.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionDefinition.java
similarity index 72%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionDefinition.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionDefinition.java
index 6811963d3d18a..dc7a2eee7ee4b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionDefinition.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionDefinition.java
@@ -3,14 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function;
+package org.elasticsearch.xpack.ql.expression.function;
 
-import org.elasticsearch.xpack.sql.session.Configuration;
+import org.elasticsearch.xpack.ql.session.Configuration;
 
 import java.util.List;
-import java.util.Locale;
 
-import static java.lang.String.format;
+import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 
 public class FunctionDefinition {
     /**
@@ -29,16 +28,13 @@ public interface Builder {
      */
     private final boolean extractViable;
     private final Builder builder;
-    private final FunctionType type;
 
-    FunctionDefinition(String name, List<String> aliases, Class<? extends Function> clazz,
-            boolean datetime, Builder builder) {
+    FunctionDefinition(String name, List<String> aliases, Class<? extends Function> clazz, boolean datetime, Builder builder) {
         this.name = name;
         this.aliases = aliases;
         this.clazz = clazz;
         this.extractViable = datetime;
         this.builder = builder;
-        this.type = FunctionType.of(clazz);
     }
 
     public String name() {
@@ -49,11 +45,7 @@ public List<String> aliases() {
         return aliases;
     }
 
-    public FunctionType type() {
-        return type;
-    }
-
-    Class<? extends Function> clazz() {
+    public Class<? extends Function> clazz() {
         return clazz;
     }
 
@@ -70,6 +62,6 @@ boolean extractViable() {
 
     @Override
     public String toString() {
-        return format(Locale.ROOT, "%s(%s)", name, aliases.isEmpty() ? "" : aliases.size() == 1 ? aliases.get(0) : aliases );
+        return format(null, "{}({})", name, aliases.isEmpty() ? "" : aliases.size() == 1 ? aliases.get(0) : aliases);
     }
 }
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionRegistry.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionRegistry.java
new file mode 100644
index 0000000000000..04ecf703908d9
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionRegistry.java
@@ -0,0 +1,420 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql.expression.function;
+
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.xpack.ql.ParsingException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.Check;
+
+import java.time.ZoneId;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Map.Entry;
+import java.util.function.BiFunction;
+import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+
+import static java.util.Collections.emptyList;
+import static java.util.Collections.unmodifiableList;
+import static java.util.stream.Collectors.toList;
+
+public class FunctionRegistry {
+
+    // list of functions grouped by type of functions (aggregate, statistics, math etc) and ordered alphabetically inside each group
+    // a single function will have one entry for itself with its name associated to its instance and, also, one entry for each alias
+    // it has with the alias name associated to the FunctionDefinition instance
+    private final Map<String, FunctionDefinition> defs = new LinkedHashMap<>();
+    private final Map<String, String> aliases = new HashMap<>();
+
+    public FunctionRegistry() {}
+
+    /**
+     * Register the given function definitions with this registry.
+     */
+    public FunctionRegistry(FunctionDefinition... functions) {
+        register(functions);
+    }
+
+    public FunctionRegistry(FunctionDefinition[]... groupFunctions) {
+        for (FunctionDefinition[] group : groupFunctions) {
+            register(group);
+        }
+    }
+
+    protected void register(FunctionDefinition... functions) {
+        // temporary map to hold [function_name/alias_name : function instance]
+        Map<String, FunctionDefinition> batchMap = new HashMap<>();
+        for (FunctionDefinition f : functions) {
+            batchMap.put(f.name(), f);
+            for (String alias : f.aliases()) {
+                Object old = batchMap.put(alias, f);
+                if (old != null || defs.containsKey(alias)) {
+                    throw new QlIllegalArgumentException("alias [" + alias + "] is used by "
+                            + "[" + (old != null ? old : defs.get(alias).name()) + "] and [" + f.name() + "]");
+                }
+                aliases.put(alias, f.name());
+            }
+        }
+        // sort the temporary map by key name and add it to the global map of functions
+        defs.putAll(batchMap.entrySet().stream()
+                .sorted(Map.Entry.comparingByKey())
+                .collect(Collectors.<Entry<String, FunctionDefinition>, String,
+                        FunctionDefinition, LinkedHashMap<String, FunctionDefinition>> toMap(Map.Entry::getKey, Map.Entry::getValue,
+                (oldValue, newValue) -> oldValue, LinkedHashMap::new)));
+    }
+
+    public FunctionDefinition resolveFunction(String functionName) {
+        FunctionDefinition def = defs.get(functionName);
+        if (def == null) {
+            throw new QlIllegalArgumentException(
+                "Cannot find function {}; this should have been caught during analysis",
+                functionName);
+        }
+        return def;
+    }
+
+    public String resolveAlias(String alias) {
+        String upperCase = alias.toUpperCase(Locale.ROOT);
+        return aliases.getOrDefault(upperCase, upperCase);
+    }
+
+    public boolean functionExists(String functionName) {
+        return defs.containsKey(functionName);
+    }
+
+    public Collection<FunctionDefinition> listFunctions() {
+        // It is worth double checking if we need this copy. These are immutable anyway.
+        return defs.values();
+    }
+
+    public Collection<FunctionDefinition> listFunctions(String pattern) {
+        // It is worth double checking if we need this copy. These are immutable anyway.
+        Pattern p = Strings.hasText(pattern) ? Pattern.compile(pattern.toUpperCase(Locale.ROOT)) : null;
+        return defs.entrySet().stream()
+                .filter(e -> p == null || p.matcher(e.getKey()).matches())
+                .map(e -> new FunctionDefinition(e.getKey(), emptyList(),
+                        e.getValue().clazz(), e.getValue().extractViable(), e.getValue().builder()))
+                .collect(toList());
+    }
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for a no-argument function that
+     * is not aware of time zone and does not support {@code DISTINCT}.
+     */
+    protected static <T extends Function> FunctionDefinition def(Class<T> function,
+            java.util.function.Function<Source, T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (false == children.isEmpty()) {
+                throw new QlIllegalArgumentException("expects no arguments");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.apply(source);
+        };
+        return def(function, builder, false, names);
+    }
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for a no-argument function that
+     * is not aware of time zone, does not support {@code DISTINCT} and needs
+     * the cluster name (DATABASE()) or the user name (USER()).
+     */
+    @SuppressWarnings("overloads")
+    protected static <T extends Function> FunctionDefinition def(Class<T> function,
+            ConfigurationAwareFunctionBuilder<T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (false == children.isEmpty()) {
+                throw new QlIllegalArgumentException("expects no arguments");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.build(source, cfg);
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface ConfigurationAwareFunctionBuilder<T> {
+        T build(Source source, Configuration configuration);
+    }
+
+    /**
+    * Build a {@linkplain FunctionDefinition} for a one-argument function that
+    * is not aware of time zone, does not support {@code DISTINCT} and needs
+    * the configuration object.
+    */
+    @SuppressWarnings("overloads")
+    protected static <T extends Function> FunctionDefinition def(Class<T> function,
+            UnaryConfigurationAwareFunctionBuilder<T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (children.size() > 1) {
+                throw new QlIllegalArgumentException("expects exactly one argument");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            Expression ex = children.size() == 1 ? children.get(0) : null;
+            return ctorRef.build(source, ex, cfg);
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface UnaryConfigurationAwareFunctionBuilder<T> {
+        T build(Source source, Expression exp, Configuration configuration);
+    }
+
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for a unary function that is not
+     * aware of time zone and does not support {@code DISTINCT}.
+     */
+    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
+    protected static <T extends Function> FunctionDefinition def(Class<T> function,
+            BiFunction<Source, Expression, T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (children.size() != 1) {
+                throw new QlIllegalArgumentException("expects exactly one argument");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.apply(source, children.get(0));
+        };
+        return def(function, builder, false, names);
+    }
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for multi-arg function that
+     * is not aware of time zone and does not support {@code DISTINCT}.
+     */
+    @SuppressWarnings("overloads") // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function,
+            MultiFunctionBuilder<T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.build(source, children);
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface MultiFunctionBuilder<T> {
+        T build(Source source, List<Expression> children);
+    }
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for a unary function that is not
+     * aware of time zone but does support {@code DISTINCT}.
+     */
+    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function,
+            DistinctAwareUnaryFunctionBuilder<T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (children.size() != 1) {
+                throw new QlIllegalArgumentException("expects exactly one argument");
+            }
+            return ctorRef.build(source, children.get(0), distinct);
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface DistinctAwareUnaryFunctionBuilder<T> {
+        T build(Source source, Expression target, boolean distinct);
+    }
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for a unary function that
+     * operates on a datetime.
+     */
+    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function,
+            DatetimeUnaryFunctionBuilder<T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (children.size() != 1) {
+                throw new QlIllegalArgumentException("expects exactly one argument");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.build(source, children.get(0), cfg.zoneId());
+        };
+        return def(function, builder, true, names);
+    }
+
+    protected interface DatetimeUnaryFunctionBuilder<T> {
+        T build(Source source, Expression target, ZoneId zi);
+    }
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for a binary function that
+     * requires a timezone.
+     */
+    @SuppressWarnings("overloads") // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function, DatetimeBinaryFunctionBuilder<T> ctorRef,
+            String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (children.size() != 2) {
+                throw new QlIllegalArgumentException("expects exactly two arguments");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.build(source, children.get(0), children.get(1), cfg.zoneId());
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface DatetimeBinaryFunctionBuilder<T> {
+        T build(Source source, Expression lhs, Expression rhs, ZoneId zi);
+    }
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for a three-args function that
+     * requires a timezone.
+     */
+    @SuppressWarnings("overloads") // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function, DatetimeThreeArgsFunctionBuilder<T> ctorRef,
+            String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (children.size() != 3) {
+                throw new QlIllegalArgumentException("expects three arguments");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.build(source, children.get(0), children.get(1), children.get(2), cfg.zoneId());
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface DatetimeThreeArgsFunctionBuilder<T> {
+        T build(Source source, Expression first, Expression second, Expression third, ZoneId zi);
+    }
+
+    /**
+     * Build a {@linkplain FunctionDefinition} for a binary function that is
+     * not aware of time zone and does not support {@code DISTINCT}.
+     */
+    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function,
+            BinaryFunctionBuilder<T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            boolean isBinaryOptionalParamFunction = OptionalArgument.class.isAssignableFrom(function);
+            if (isBinaryOptionalParamFunction && (children.size() > 2 || children.size() < 1)) {
+                throw new QlIllegalArgumentException("expects one or two arguments");
+            } else if (!isBinaryOptionalParamFunction && children.size() != 2) {
+                throw new QlIllegalArgumentException("expects exactly two arguments");
+            }
+
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.build(source, children.get(0), children.size() == 2 ? children.get(1) : null);
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface BinaryFunctionBuilder<T> {
+        T build(Source source, Expression lhs, Expression rhs);
+    }
+
+    /**
+     * Main method to register a function/
+     * @param names Must always have at least one entry which is the method's primary name
+     *
+     */
+    @SuppressWarnings("overloads")
+    public static FunctionDefinition def(Class<? extends Function> function, FunctionBuilder builder,
+                                          boolean datetime, String... names) {
+        Check.isTrue(names.length > 0, "At least one name must be provided for the function");
+        String primaryName = names[0];
+        List<String> aliases = Arrays.asList(names).subList(1, names.length);
+        FunctionDefinition.Builder realBuilder = (uf, distinct, cfg) -> {
+            try {
+                return builder.build(uf.source(), uf.children(), distinct, cfg);
+            } catch (QlIllegalArgumentException e) {
+                throw new ParsingException(uf.source(), "error building [" + primaryName + "]: " + e.getMessage(), e);
+            }
+        };
+        return new FunctionDefinition(primaryName, unmodifiableList(aliases), function, datetime, realBuilder);
+    }
+
+    protected interface FunctionBuilder {
+        Function build(Source source, List<Expression> children, boolean distinct, Configuration cfg);
+    }
+
+    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function,
+            ThreeParametersFunctionBuilder<T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            boolean hasMinimumTwo = OptionalArgument.class.isAssignableFrom(function);
+            if (hasMinimumTwo && (children.size() > 3 || children.size() < 2)) {
+                throw new QlIllegalArgumentException("expects two or three arguments");
+            } else if (!hasMinimumTwo && children.size() != 3) {
+                throw new QlIllegalArgumentException("expects exactly three arguments");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.build(source, children.get(0), children.get(1), children.size() == 3 ? children.get(2) : null);
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface ThreeParametersFunctionBuilder<T> {
+        T build(Source source, Expression src, Expression exp1, Expression exp2);
+    }
+
+    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function,
+            FourParametersFunctionBuilder<T> ctorRef, String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) -> {
+            if (children.size() != 4) {
+                throw new QlIllegalArgumentException("expects exactly four arguments");
+            }
+            if (distinct) {
+                throw new QlIllegalArgumentException("does not support DISTINCT yet it was specified");
+            }
+            return ctorRef.build(source, children.get(0), children.get(1), children.get(2), children.get(3));
+        };
+        return def(function, builder, false, names);
+    }
+
+    protected interface FourParametersFunctionBuilder<T> {
+        T build(Source source, Expression src, Expression exp1, Expression exp2, Expression exp3);
+    }
+
+    /**
+     * Special method to create function definition for Cast as its
+     * signature is not compatible with {@link UnresolvedFunction}
+     *
+     * @return Cast function definition
+     */
+    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
+    public static <T extends Function> FunctionDefinition def(Class<T> function,
+                                                               CastFunctionBuilder<T> ctorRef,
+                                                               String... names) {
+        FunctionBuilder builder = (source, children, distinct, cfg) ->
+            ctorRef.build(source, children.get(0), children.get(0).dataType());
+        return def(function, builder, false, names);
+    }
+
+    protected interface CastFunctionBuilder<T> {
+        T build(Source source, Expression expression, DataType dataType);
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NullIntolerant.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionTypeRegistry.java
similarity index 57%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NullIntolerant.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionTypeRegistry.java
index d3e62db81ad43..67729e90462d5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/NullIntolerant.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/FunctionTypeRegistry.java
@@ -3,10 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
 
-// marker interface for expressions that are do not support null
-// and thus are eliminated by it
-public interface NullIntolerant {
+package org.elasticsearch.xpack.ql.expression.function;
 
+public interface FunctionTypeRegistry {
+
+    String type(Class<? extends Function> clazz);
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Functions.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/Functions.java
similarity index 63%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Functions.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/Functions.java
index 47ca821f4b5b4..6da5f05303401 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Functions.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/Functions.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function;
+package org.elasticsearch.xpack.ql.expression.function;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.grouping.GroupingFunction;
 
 public abstract class Functions {
 
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/OptionalArgument.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/OptionalArgument.java
new file mode 100644
index 0000000000000..6a7e86345b4d9
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/OptionalArgument.java
@@ -0,0 +1,15 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.expression.function;
+
+/**
+ * Marker interface indicating that a function accepts one optional argument (typically the last one).
+ * This is used by the {@link FunctionRegistry} to perform validation of function declaration.
+ */
+public interface OptionalArgument {
+
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunction.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunction.java
index 920d030ddfd99..7f0ee174554c1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunction.java
@@ -3,20 +3,20 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function;
+package org.elasticsearch.xpack.ql.expression.function;
 
-import org.elasticsearch.xpack.sql.capabilities.Unresolvable;
-import org.elasticsearch.xpack.sql.capabilities.UnresolvedException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.capabilities.Unresolvable;
+import org.elasticsearch.xpack.ql.capabilities.UnresolvedException;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.Count;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.LinkedHashSet;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/AggregateFunction.java
similarity index 73%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/AggregateFunction.java
index 91ac02dc83785..ba274f744bfe0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/AggregateFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/AggregateFunction.java
@@ -3,18 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.aggregate;
+package org.elasticsearch.xpack.ql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.TypeResolutions;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggNameInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.util.CollectionUtils;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.TypeResolutions;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.AggNameInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
 
 import java.util.List;
 import java.util.Objects;
@@ -61,7 +61,7 @@ protected Pipe makePipe() {
 
     @Override
     public ScriptTemplate asScript() {
-        throw new SqlIllegalArgumentException("Aggregate functions cannot be scripted");
+        throw new QlIllegalArgumentException("Aggregate functions cannot be scripted");
     }
 
     @Override
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/CompoundAggregate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/CompoundAggregate.java
new file mode 100644
index 0000000000000..bab1cd7c3e3cf
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/CompoundAggregate.java
@@ -0,0 +1,21 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.expression.function.aggregate;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+
+import java.util.List;
+
+/**
+ * Marker type for compound aggregates, that is an aggregate that provides multiple values (like Stats or Matrix)
+ */
+public interface CompoundAggregate {
+
+    Expression field();
+
+    List<Expression> arguments();
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Count.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/Count.java
similarity index 85%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Count.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/Count.java
index 951144f5b2eb6..60ffd1aed9975 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Count.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/Count.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.aggregate;
+package org.elasticsearch.xpack.ql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/EnclosedAgg.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/EnclosedAgg.java
similarity index 85%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/EnclosedAgg.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/EnclosedAgg.java
index 146cc68ba14a4..4f74d18dd50aa 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/EnclosedAgg.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/EnclosedAgg.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.aggregate;
+package org.elasticsearch.xpack.ql.expression.function.aggregate;
 
 // Agg 'enclosed' by another agg. Used for agg that return multiple embedded aggs (like MatrixStats)
 public interface EnclosedAgg {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/InnerAggregate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/InnerAggregate.java
similarity index 78%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/InnerAggregate.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/InnerAggregate.java
index c9d18b83c156d..45c647a099a2e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/InnerAggregate.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/aggregate/InnerAggregate.java
@@ -3,12 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.aggregate;
+package org.elasticsearch.xpack.ql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.Check;
 
 import java.util.List;
 import java.util.Objects;
@@ -16,19 +17,21 @@
 public class InnerAggregate extends AggregateFunction {
 
     private final AggregateFunction inner;
-    private final CompoundNumericAggregate outer;
+    private final CompoundAggregate outer;
     private final String innerName;
     // used when the result needs to be extracted from a map (like in MatrixAggs or Percentiles)
     private final Expression innerKey;
 
-    public InnerAggregate(AggregateFunction inner, CompoundNumericAggregate outer) {
+    public InnerAggregate(AggregateFunction inner, CompoundAggregate outer) {
         this(inner.source(), inner, outer, null);
     }
 
-    public InnerAggregate(Source source, AggregateFunction inner, CompoundNumericAggregate outer, Expression innerKey) {
+    public InnerAggregate(Source source, AggregateFunction inner, CompoundAggregate outer, Expression innerKey) {
         super(source, outer.field(), outer.arguments());
         this.inner = inner;
         this.outer = outer;
+        Check.isTrue(inner instanceof EnclosedAgg, "Inner function is not marked as Enclosed");
+        Check.isTrue(outer instanceof Expression, "CompoundAggregate is not an Expression");
         this.innerName = ((EnclosedAgg) inner).innerName();
         this.innerKey = innerKey;
     }
@@ -51,7 +54,7 @@ public AggregateFunction inner() {
         return inner;
     }
 
-    public CompoundNumericAggregate outer() {
+    public CompoundAggregate outer() {
         return outer;
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/grouping/GroupingFunction.java
similarity index 73%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/grouping/GroupingFunction.java
index 327c4ef382db0..319954e3973c2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/GroupingFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/grouping/GroupingFunction.java
@@ -3,16 +3,16 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.grouping;
+package org.elasticsearch.xpack.ql.expression.function.grouping;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggNameInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.util.CollectionUtils;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.AggNameInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
 
 import java.util.List;
 import java.util.Objects;
@@ -54,7 +54,7 @@ protected Pipe makePipe() {
 
     @Override
     public ScriptTemplate asScript() {
-        throw new SqlIllegalArgumentException("Grouping functions cannot be scripted");
+        throw new QlIllegalArgumentException("Grouping functions cannot be scripted");
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/BinaryScalarFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/BinaryScalarFunction.java
similarity index 85%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/BinaryScalarFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/BinaryScalarFunction.java
index 0a21fa83606d1..c06a5060d829b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/BinaryScalarFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/BinaryScalarFunction.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.scalar;
+package org.elasticsearch.xpack.ql.expression.function.scalar;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/ScalarFunction.java
similarity index 78%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/ScalarFunction.java
index b764b4b0a6ac8..49e620fa5aa03 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ScalarFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/ScalarFunction.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.scalar;
+package org.elasticsearch.xpack.ql.expression.function.scalar;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptWeaver;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptWeaver;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/UnaryScalarFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/UnaryScalarFunction.java
similarity index 76%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/UnaryScalarFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/UnaryScalarFunction.java
index d10d18b83a1dd..905359996132b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/UnaryScalarFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/UnaryScalarFunction.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.scalar;
+package org.elasticsearch.xpack.ql.expression.function.scalar;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.UnaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.UnaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoShape.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/geo/GeoShape.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoShape.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/geo/GeoShape.java
index a43ffe745d263..7762d65c16464 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoShape.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/geo/GeoShape.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
+package org.elasticsearch.xpack.ql.expression.function.scalar.geo;
 
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.geo.GeoUtils;
@@ -29,10 +29,10 @@
 import org.elasticsearch.geometry.Point;
 import org.elasticsearch.geometry.Polygon;
 import org.elasticsearch.geometry.Rectangle;
-import org.elasticsearch.geometry.utils.StandardValidator;
 import org.elasticsearch.geometry.utils.GeometryValidator;
+import org.elasticsearch.geometry.utils.StandardValidator;
 import org.elasticsearch.geometry.utils.WellKnownText;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 
 import java.io.IOException;
 import java.io.InputStream;
@@ -65,7 +65,7 @@ public GeoShape(Object value) throws IOException {
         try {
             shape = parse(value);
         } catch (ParseException ex) {
-            throw new SqlIllegalArgumentException("Cannot parse [" + value + "] as a geo_shape or shape value", ex);
+            throw new QlIllegalArgumentException("Cannot parse [" + value + "] as a geo_shape or shape value", ex);
         }
     }
 
@@ -74,7 +74,7 @@ public GeoShape(StreamInput in) throws IOException {
         try {
             shape = parse(value);
         } catch (ParseException ex) {
-            throw new SqlIllegalArgumentException("Cannot parse [" + value + "] as a geo_shape or shape value", ex);
+            throw new QlIllegalArgumentException("Cannot parse [" + value + "] as a geo_shape or shape value", ex);
         }
     }
 
@@ -178,10 +178,10 @@ public String getGeometryType() {
 
     public static double distance(GeoShape shape1, GeoShape shape2) {
         if (shape1.shape instanceof Point == false) {
-            throw new SqlIllegalArgumentException("distance calculation is only supported for points; received [{}]", shape1);
+            throw new QlIllegalArgumentException("distance calculation is only supported for points; received [{}]", shape1);
         }
         if (shape2.shape instanceof Point == false) {
-            throw new SqlIllegalArgumentException("distance calculation is only supported for points; received [{}]", shape2);
+            throw new QlIllegalArgumentException("distance calculation is only supported for points; received [{}]", shape2);
         }
         double srcLat = ((Point) shape1.shape).getY();
         double srcLon = ((Point) shape1.shape).getX();
@@ -227,4 +227,4 @@ private static Geometry parse(Object value) throws IOException, ParseException {
             return GEOMETRY_PARSER.parse(parser);
         }
     }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/whitelist/InternalQlScriptUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/whitelist/InternalQlScriptUtils.java
new file mode 100644
index 0000000000000..f5b0992d9ebf5
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/scalar/whitelist/InternalQlScriptUtils.java
@@ -0,0 +1,108 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.expression.function.scalar.whitelist;
+
+import org.elasticsearch.index.fielddata.ScriptDocValues;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.NotProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.CheckNullProcessor.CheckNullOperation;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.InProcessor;
+import org.elasticsearch.xpack.ql.util.StringUtils;
+
+import java.util.List;
+import java.util.Map;
+
+public abstract class InternalQlScriptUtils {
+
+    //
+    // Utilities
+    //
+
+    // safe missing mapping/value extractor
+    public static <T> Object docValue(Map<String, ScriptDocValues<T>> doc, String fieldName) {
+        if (doc.containsKey(fieldName)) {
+            ScriptDocValues<T> docValues = doc.get(fieldName);
+            if (!docValues.isEmpty()) {
+                return docValues.get(0);
+            }
+        }
+        return null;
+    }
+
+    public static boolean nullSafeFilter(Boolean filter) {
+        return filter == null ? false : filter.booleanValue();
+    }
+
+    public static double nullSafeSortNumeric(Number sort) {
+        return sort == null ? 0.0d : sort.doubleValue();
+    }
+
+    public static String nullSafeSortString(Object sort) {
+        return sort == null ? StringUtils.EMPTY : sort.toString();
+    }
+
+
+    //
+    // Operators
+    //
+
+    //
+    // Logical
+    //
+    public static Boolean eq(Object left, Object right) {
+        return BinaryComparisonOperation.EQ.apply(left, right);
+    }
+
+    public static Boolean nulleq(Object left, Object right) {
+        return BinaryComparisonOperation.NULLEQ.apply(left, right);
+    }
+
+    public static Boolean neq(Object left, Object right) {
+        return BinaryComparisonOperation.NEQ.apply(left, right);
+    }
+
+    public static Boolean lt(Object left, Object right) {
+        return BinaryComparisonOperation.LT.apply(left, right);
+    }
+
+    public static Boolean lte(Object left, Object right) {
+        return BinaryComparisonOperation.LTE.apply(left, right);
+    }
+
+    public static Boolean gt(Object left, Object right) {
+        return BinaryComparisonOperation.GT.apply(left, right);
+    }
+
+    public static Boolean gte(Object left, Object right) {
+        return BinaryComparisonOperation.GTE.apply(left, right);
+    }
+
+    public static Boolean and(Boolean left, Boolean right) {
+        return BinaryLogicOperation.AND.apply(left, right);
+    }
+
+    public static Boolean or(Boolean left, Boolean right) {
+        return BinaryLogicOperation.OR.apply(left, right);
+    }
+
+    public static Boolean not(Boolean expression) {
+        return NotProcessor.apply(expression);
+    }
+
+    public static Boolean isNull(Object expression) {
+        return CheckNullOperation.IS_NULL.apply(expression);
+    }
+
+    public static Boolean isNotNull(Object expression) {
+        return CheckNullOperation.IS_NOT_NULL.apply(expression);
+    }
+
+    public static Boolean in(Object value, List<Object> values) {
+        return InProcessor.apply(value, values);
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggExtractorInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggExtractorInput.java
similarity index 63%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggExtractorInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggExtractorInput.java
index 554b7d3e3c885..c676bf0e22444 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggExtractorInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggExtractorInput.java
@@ -3,16 +3,16 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.BucketExtractorProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ChainingProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.BucketExtractorProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ChainingProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class AggExtractorInput extends LeafInput<BucketExtractor> {
 
@@ -45,7 +45,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         // Nothing to collect
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggNameInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggNameInput.java
similarity index 78%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggNameInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggNameInput.java
index 7f3a12b560cf2..3b32cca28d8a9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggNameInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggNameInput.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class AggNameInput extends CommonNonExecutableInput<String> {
     public AggNameInput(Source source, Expression expression, String context) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggPathInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggPathInput.java
similarity index 84%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggPathInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggPathInput.java
index 30c0968b9ef23..4e82853d5bcf5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AggPathInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AggPathInput.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.AggRef;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.execution.search.AggRef;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AttributeInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AttributeInput.java
similarity index 71%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AttributeInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AttributeInput.java
index 72f2396582894..dcbc3861a315f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AttributeInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AttributeInput.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 /**
  * An input that must first be rewritten against the rest of the query
@@ -36,7 +36,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         // Nothing to extract
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/BinaryPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/BinaryPipe.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/BinaryPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/BinaryPipe.java
index 64f81f4f5b3ad..4256f6491bffe 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/BinaryPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/BinaryPipe.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
@@ -66,7 +66,7 @@ public boolean resolved() {
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         left.collectFields(sourceBuilder);
         right.collectFields(sourceBuilder);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/CommonNonExecutableInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/CommonNonExecutableInput.java
similarity index 59%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/CommonNonExecutableInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/CommonNonExecutableInput.java
index cb1072bc6b884..bc8469fc9d7fa 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/CommonNonExecutableInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/CommonNonExecutableInput.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 /**
  * Implementation common to most subclasses of
@@ -22,7 +22,7 @@ abstract class CommonNonExecutableInput<T> extends NonExecutableInput<T> {
 
     @Override
     public final Processor asProcessor() {
-        throw new SqlIllegalArgumentException("Unresolved input - needs resolving first");
+        throw new QlIllegalArgumentException("Unresolved input - needs resolving first");
     }
 
     @Override
@@ -31,7 +31,7 @@ public final Pipe resolveAttributes(AttributeResolver resolver) {
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         // Nothing to extract
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ConstantInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/ConstantInput.java
similarity index 65%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ConstantInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/ConstantInput.java
index 21a8a86566881..49b6a16c598f5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ConstantInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/ConstantInput.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class ConstantInput extends LeafInput<Object> {
 
@@ -39,7 +39,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         // Nothing to collect
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/HitExtractorInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/HitExtractorInput.java
similarity index 62%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/HitExtractorInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/HitExtractorInput.java
index e58c97e883717..3f977fbc3755c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/HitExtractorInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/HitExtractorInput.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.execution.search.extractor.HitExtractor;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.HitExtractorProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.HitExtractorProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class HitExtractorInput extends LeafInput<HitExtractor> {
 
@@ -40,7 +40,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         // No fields to collect
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/LeafInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/LeafInput.java
similarity index 89%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/LeafInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/LeafInput.java
index ff5ed1ced6d6b..b81b166a28fa7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/LeafInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/LeafInput.java
@@ -3,10 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/MultiPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/MultiPipe.java
similarity index 76%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/MultiPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/MultiPipe.java
index f0fc3e075895b..be3e84d2ea044 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/MultiPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/MultiPipe.java
@@ -4,11 +4,11 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/NonExecutableInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/NonExecutableInput.java
similarity index 59%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/NonExecutableInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/NonExecutableInput.java
index eae0f56df7be4..cb34ee3ba6e95 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/NonExecutableInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/NonExecutableInput.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public abstract class NonExecutableInput<T> extends LeafInput<T> {
     NonExecutableInput(Source source, Expression expression, T context) {
@@ -22,6 +22,6 @@ public boolean resolved() {
 
     @Override
     public Processor asProcessor() {
-        throw new SqlIllegalArgumentException("Unresolved input - needs resolving first");
+        throw new QlIllegalArgumentException("Unresolved input - needs resolving first");
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/Pipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/Pipe.java
similarity index 75%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/Pipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/Pipe.java
index 675cde43c450d..8f6480435919c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/Pipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/Pipe.java
@@ -3,17 +3,17 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.capabilities.Resolvable;
-import org.elasticsearch.xpack.sql.capabilities.Resolvables;
-import org.elasticsearch.xpack.sql.execution.search.FieldExtraction;
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Node;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.capabilities.Resolvable;
+import org.elasticsearch.xpack.ql.capabilities.Resolvables;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -47,7 +47,7 @@ public boolean resolved() {
     }
 
     @Override
-    public void collectFields(SqlSourceBuilder sourceBuilder) {
+    public void collectFields(QlSourceBuilder sourceBuilder) {
         children().forEach(c -> c.collectFields(sourceBuilder));
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ReferenceInput.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/ReferenceInput.java
similarity index 67%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ReferenceInput.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/ReferenceInput.java
index d9bbdb8631b43..c54f4f7d48313 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ReferenceInput.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/ReferenceInput.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.FieldExtraction;
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class ReferenceInput extends NonExecutableInput<FieldExtraction> {
     public ReferenceInput(Source source, Expression expression, FieldExtraction context) {
@@ -32,7 +32,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         context().collectFields(sourceBuilder);
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/UnaryPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/UnaryPipe.java
similarity index 83%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/UnaryPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/UnaryPipe.java
index 4920c3935bbb1..ef361e605cad2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/UnaryPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/UnaryPipe.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ChainingProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ChainingProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
@@ -74,7 +74,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     }
 
     @Override
-    public void collectFields(SqlSourceBuilder sourceBuilder) {
+    public void collectFields(QlSourceBuilder sourceBuilder) {
         child.collectFields(sourceBuilder);
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/BinaryProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/BinaryProcessor.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/BinaryProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/BinaryProcessor.java
index b504c2072fec6..7fe911e4acad3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/BinaryProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/BinaryProcessor.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/BucketExtractorProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/BucketExtractorProcessor.java
similarity index 86%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/BucketExtractorProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/BucketExtractorProcessor.java
index e3e8a2c9c8313..8dccffb83f474 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/BucketExtractorProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/BucketExtractorProcessor.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
 
 import java.io.IOException;
 import java.util.Objects;
@@ -45,7 +45,7 @@ public String getWriteableName() {
     @Override
     public Object process(Object input) {
         if (!(input instanceof Bucket)) {
-            throw new SqlIllegalArgumentException("Expected an agg bucket but received {}", input);
+            throw new QlIllegalArgumentException("Expected an agg bucket but received {}", input);
         }
         return extractor.extract((Bucket) input);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/ChainingProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/ChainingProcessor.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/ChainingProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/ChainingProcessor.java
index e9c1385818364..05e54d3467575 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/ChainingProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/ChainingProcessor.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/ConstantProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/ConstantProcessor.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/ConstantProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/ConstantProcessor.java
index 826cf1816ae6b..7230d21919297 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/ConstantProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/ConstantProcessor.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.common.io.stream.StreamInput;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/FunctionalBinaryProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/FunctionalBinaryProcessor.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/FunctionalBinaryProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/FunctionalBinaryProcessor.java
index 7e5d3a6089ca5..e0c28f4f44f4a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/FunctionalBinaryProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/FunctionalBinaryProcessor.java
@@ -4,7 +4,7 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/HitExtractorProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/HitExtractorProcessor.java
similarity index 86%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/HitExtractorProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/HitExtractorProcessor.java
index 9f58b00898978..fe0dd638a9845 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/HitExtractorProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/HitExtractorProcessor.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.search.SearchHit;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
 
 import java.io.IOException;
 import java.util.Objects;
@@ -45,7 +45,7 @@ public String getWriteableName() {
     @Override
     public Object process(Object input) {
         if (!(input instanceof SearchHit)) {
-            throw new SqlIllegalArgumentException("Expected a SearchHit but received {}", input);
+            throw new QlIllegalArgumentException("Expected a SearchHit but received {}", input);
         }
         return extractor.extract((SearchHit) input);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/Processor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/Processor.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/Processor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/Processor.java
index 2b8433191e395..d95d0623670af 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/Processor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/Processor.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.NamedWriteable;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/UnaryProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/UnaryProcessor.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/UnaryProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/UnaryProcessor.java
index 7c1a5dd7d3594..9fc6d01bdb0f8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/processor/UnaryProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/processor/UnaryProcessor.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Agg.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Agg.java
similarity index 74%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Agg.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Agg.java
index ad4ff617cce49..aabbd607b94e7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Agg.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Agg.java
@@ -3,12 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.Count;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.InnerAggregate;
 
 class Agg extends Param<AggregateFunction> {
 
@@ -27,7 +28,7 @@ public String aggProperty() {
 
         if (agg instanceof InnerAggregate) {
             InnerAggregate inner = (InnerAggregate) agg;
-            return Expressions.id(inner.outer()) + "." + inner.innerName();
+            return Expressions.id((Expression) inner.outer()) + "." + inner.innerName();
         }
         // Count needs special handling since in most cases it is not a dedicated aggregation
         else if (agg instanceof Count) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Grouping.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Grouping.java
similarity index 78%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Grouping.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Grouping.java
index f34e1c8798f9e..f7f6bfcd30fec 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Grouping.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Grouping.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.ql.expression.function.grouping.GroupingFunction;
 
 class Grouping extends Param<GroupingFunction> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Param.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Param.java
similarity index 94%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Param.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Param.java
index 63b92be20a3d6..a7725b4faa06c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Param.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Param.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Params.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Params.java
similarity index 95%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Params.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Params.java
index 073df0329d9c8..cc57863a7d589 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Params.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Params.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 
 import java.util.ArrayList;
 import java.util.LinkedHashMap;
@@ -113,7 +113,7 @@ else if (p instanceof Var) {
                     flatten.add(p);
                 }
                 else {
-                    throw new SqlIllegalArgumentException("Unsupported field {}", p);
+                    throw new QlIllegalArgumentException("Unsupported field {}", p);
                 }
             }
         }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ParamsBuilder.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ParamsBuilder.java
similarity index 82%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ParamsBuilder.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ParamsBuilder.java
index 2e13682b70e7a..c869036da6b87 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ParamsBuilder.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ParamsBuilder.java
@@ -3,10 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.grouping.GroupingFunction;
 
 import java.util.ArrayList;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Script.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Script.java
similarity index 87%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Script.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Script.java
index 85c436cf69ec8..006dc78b79494 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Script.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Script.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
 class Script extends Param<Params> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptTemplate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ScriptTemplate.java
similarity index 93%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptTemplate.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ScriptTemplate.java
index aeefa5c78f0e3..6e6d2104ef324 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptTemplate.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ScriptTemplate.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
 import org.elasticsearch.script.Script;
 import org.elasticsearch.script.ScriptType;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.List;
 import java.util.Locale;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptWeaver.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ScriptWeaver.java
similarity index 81%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptWeaver.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ScriptWeaver.java
index e468a2801ce6c..3a2007328307c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/ScriptWeaver.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/ScriptWeaver.java
@@ -4,25 +4,25 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.gen.script;
-
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalDayTime;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.DateUtils;
+package org.elasticsearch.xpack.ql.expression.gen.script;
+
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalDayTime;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalYearMonth;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.DateUtils;
 
 import java.time.OffsetTime;
 import java.time.ZonedDateTime;
 
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Mixin-like interface for customizing the default script generation.
@@ -49,7 +49,7 @@ default ScriptTemplate asScript(Expression exp) {
         if (exp instanceof FieldAttribute) {
             return scriptWithField((FieldAttribute) exp);
         }
-        throw new SqlIllegalArgumentException("Cannot evaluate script for expression {}", exp);
+        throw new QlIllegalArgumentException("Cannot evaluate script for expression {}", exp);
     }
 
     /*
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Scripts.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Scripts.java
similarity index 83%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Scripts.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Scripts.java
index 21ac12e51da89..6a57e33d87837 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Scripts.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Scripts.java
@@ -4,13 +4,11 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
-import org.elasticsearch.xpack.sql.expression.function.scalar.whitelist.InternalSqlScriptUtils;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.AbstractMap.SimpleEntry;
-import java.util.Collections;
 import java.util.LinkedHashMap;
 import java.util.Locale;
 import java.util.Map;
@@ -19,20 +17,23 @@
 import java.util.stream.Stream;
 
 import static java.lang.String.format;
+import static java.util.Collections.unmodifiableMap;
 import static java.util.stream.Collectors.toMap;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 public final class Scripts {
 
     public static final String DOC_VALUE = "doc[{}].value";
     public static final String SQL_SCRIPTS = "{sql}";
     public static final String PARAM = "{}";
+    // FIXME: this needs to be either renamed (drop Sql) or find a pluggable approach (through ScriptWeaver)
+    public static final String INTERNAL_SCRIPT_UTILS = "InternalSqlScriptUtils";
 
     private Scripts() {}
 
-    private static final Map<Pattern, String> FORMATTING_PATTERNS = Collections.unmodifiableMap(Stream.of(
+    static final Map<Pattern, String> FORMATTING_PATTERNS = unmodifiableMap(Stream.of(
             new SimpleEntry<>(DOC_VALUE, SQL_SCRIPTS + ".docValue(doc,{})"),
-            new SimpleEntry<>(SQL_SCRIPTS, InternalSqlScriptUtils.class.getSimpleName()),
+            new SimpleEntry<>(SQL_SCRIPTS, INTERNAL_SCRIPT_UTILS),
             new SimpleEntry<>(PARAM, "params.%s"))
             .collect(toMap(e -> Pattern.compile(e.getKey(), Pattern.LITERAL), Map.Entry::getValue, (a, b) -> a, LinkedHashMap::new)));
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Var.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Var.java
similarity index 87%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Var.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Var.java
index f22e510fdc4e2..e359581026e0b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/script/Var.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/gen/script/Var.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.script;
+package org.elasticsearch.xpack.ql.expression.gen.script;
 
 class Var extends Param<Object> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Interval.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Interval.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Interval.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Interval.java
index fe83b9b0099b4..dc29f075e7f83 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Interval.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Interval.java
@@ -4,13 +4,13 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.literal;
+package org.elasticsearch.xpack.ql.expression.literal;
 
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.xpack.sql.proto.StringUtils;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.DateUtils;
 
 import java.io.IOException;
 import java.time.temporal.TemporalAmount;
@@ -76,6 +76,6 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
 
     @Override
     public String toString() {
-        return StringUtils.toString(interval);
+        return DateUtils.toString(interval);
     }
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/IntervalDayTime.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/IntervalDayTime.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/IntervalDayTime.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/IntervalDayTime.java
index 4f370bc313fa0..66f3ce7238f6a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/IntervalDayTime.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/IntervalDayTime.java
@@ -4,12 +4,12 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.literal;
+package org.elasticsearch.xpack.ql.expression.literal;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypes;
 
 import java.io.IOException;
 import java.time.Duration;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/IntervalYearMonth.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/IntervalYearMonth.java
similarity index 90%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/IntervalYearMonth.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/IntervalYearMonth.java
index cb4346428ae70..ec93819bb93fb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/IntervalYearMonth.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/IntervalYearMonth.java
@@ -4,13 +4,13 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.literal;
+package org.elasticsearch.xpack.ql.expression.literal;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
-import org.elasticsearch.xpack.sql.type.DataTypes;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.type.DataTypes;
 
 import java.io.IOException;
 import java.time.Period;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Intervals.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Intervals.java
similarity index 93%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Intervals.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Intervals.java
index ed7dc9da77543..0cd3e6371bcdf 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Intervals.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Intervals.java
@@ -4,17 +4,17 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.literal;
+package org.elasticsearch.xpack.ql.expression.literal;
 
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.parser.ParsingException;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.Check;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.ParsingException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.Check;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.time.Duration;
 import java.time.Period;
@@ -24,13 +24,13 @@
 import java.util.List;
 import java.util.Map;
 
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_HOUR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR_TO_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MINUTE_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR_TO_MONTH;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_HOUR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR_TO_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MINUTE_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR_TO_MONTH;
 
 public final class Intervals {
 
@@ -274,7 +274,7 @@ TemporalAmount parse(Source source, String string) {
                                     v);
                         }
                         values[unitIndex++] = v;
-                    } catch (SqlIllegalArgumentException siae) {
+                    } catch (QlIllegalArgumentException siae) {
                         throw new ParsingException(source, invalidIntervalMessage(string), siae.getMessage());
                     }
                     startToken = endToken;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Literals.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Literals.java
similarity index 83%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Literals.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Literals.java
index d6bdeeb0fe46b..0a2cc37db1e0d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/Literals.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/literal/Literals.java
@@ -4,10 +4,9 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.literal;
+package org.elasticsearch.xpack.ql.expression.literal;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -31,7 +30,6 @@ public static Collection<? extends NamedWriteableRegistry.Entry> getNamedWriteab
 
         entries.add(new NamedWriteableRegistry.Entry(IntervalDayTime.class, IntervalDayTime.NAME, IntervalDayTime::new));
         entries.add(new NamedWriteableRegistry.Entry(IntervalYearMonth.class, IntervalYearMonth.NAME, IntervalYearMonth::new));
-        entries.add(new NamedWriteableRegistry.Entry(GeoShape.class, GeoShape.NAME, GeoShape::new));
 
         return entries;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryOperator.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/BinaryOperator.java
similarity index 80%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryOperator.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/BinaryOperator.java
index 318cfd9b62475..6e9ac5ae371d7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryOperator.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/BinaryOperator.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate;
+package org.elasticsearch.xpack.ql.expression.predicate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 /**
  * Operator is a specialized binary predicate where both sides have the compatible types
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryPredicate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/BinaryPredicate.java
similarity index 89%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryPredicate.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/BinaryPredicate.java
index 8705f9c58e578..bd67f335c8fbe 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/BinaryPredicate.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/BinaryPredicate.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate;
+package org.elasticsearch.xpack.ql.expression.predicate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.BinaryScalarFunction;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Negatable.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Negatable.java
similarity index 70%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Negatable.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Negatable.java
index 138f901d516f8..da46a0624479f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Negatable.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Negatable.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate;
+package org.elasticsearch.xpack.ql.expression.predicate;
 
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
 
 public interface Negatable<T extends ScalarFunction> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/PredicateBiFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/PredicateBiFunction.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/PredicateBiFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/PredicateBiFunction.java
index 4966d0c9ab659..7ca124f515203 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/PredicateBiFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/PredicateBiFunction.java
@@ -4,7 +4,7 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate;
+package org.elasticsearch.xpack.ql.expression.predicate;
 
 import java.util.Locale;
 import java.util.function.BiFunction;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Predicates.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Predicates.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Predicates.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Predicates.java
index 83a4b96f8295b..04582ff91a7f5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Predicates.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Predicates.java
@@ -3,12 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate;
+package org.elasticsearch.xpack.ql.expression.predicate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.And;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Or;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.And;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Or;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -113,9 +112,4 @@ public static List<Expression> subtract(List<Expression> from, List<Expression>
         }
         return diff.isEmpty() ? emptyList() : diff;
     }
-
-
-    public static boolean canEvaluate(Expression exp, LogicalPlan plan) {
-        return exp.references().subsetOf(plan.outputSet());
-    }
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Range.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Range.java
similarity index 81%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Range.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Range.java
index 8405b0b436ad4..c5bdb7c8a5754 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/Range.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/Range.java
@@ -3,23 +3,23 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.Params;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicPipe;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparison;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonPipe;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+package org.elasticsearch.xpack.ql.expression.predicate;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.Params;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicPipe;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparison;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonPipe;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 import java.util.Locale;
@@ -27,7 +27,7 @@
 
 import static java.lang.String.format;
 import static java.util.Arrays.asList;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 // BETWEEN or range - is a mix of gt(e) AND lt(e)
 public class Range extends ScalarFunction {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ArbitraryConditionalFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ArbitraryConditionalFunction.java
similarity index 70%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ArbitraryConditionalFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ArbitraryConditionalFunction.java
index b2bea979acda7..85c0dc484cbdb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ArbitraryConditionalFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ArbitraryConditionalFunction.java
@@ -4,21 +4,21 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.List;
 import java.util.StringJoiner;
 
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Base class for conditional predicates with arbitrary number of arguments
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Case.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Case.java
similarity index 82%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Case.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Case.java
index 84f17283e061e..80bd5620c04a7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Case.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Case.java
@@ -3,26 +3,25 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.optimizer.Optimizer;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
-import org.elasticsearch.xpack.sql.type.DataTypes;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.type.DataTypes;
 
 import java.util.ArrayList;
 import java.util.List;
 import java.util.StringJoiner;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Implements the CASE WHEN ... THEN ... ELSE ... END expression
@@ -92,23 +91,23 @@ protected TypeResolution resolveType() {
                 return new TypeResolution(format(null, "condition of [{}] must be [boolean], found value [{}] type [{}]",
                     conditional.sourceText(),
                     Expressions.name(conditional.condition()),
-                    conditional.condition().dataType().typeName));
+                    conditional.condition().dataType().typeName()));
             }
             if (DataTypes.areTypesCompatible(expectedResultDataType, conditional.dataType()) == false) {
                 return new TypeResolution(format(null, "result of [{}] must be [{}], found value [{}] type [{}]",
                     conditional.sourceText(),
-                    expectedResultDataType.typeName,
+                    expectedResultDataType.typeName(),
                     Expressions.name(conditional.result()),
-                    conditional.dataType().typeName));
+                    conditional.dataType().typeName()));
             }
         }
 
         if (DataTypes.areTypesCompatible(expectedResultDataType, elseResult.dataType()) == false) {
             return new TypeResolution(format(null, "ELSE clause of [{}] must be [{}], found value [{}] type [{}]",
                 elseResult.sourceText(),
-                expectedResultDataType.typeName,
+                expectedResultDataType.typeName(),
                 Expressions.name(elseResult),
-                elseResult.dataType().typeName));
+                elseResult.dataType().typeName()));
         }
 
         return TypeResolution.TYPE_RESOLVED;
@@ -116,7 +115,7 @@ protected TypeResolution resolveType() {
 
     /**
      * All foldable conditions that fold to FALSE should have
-     * been removed by the {@link Optimizer}#SimplifyCase.
+     * been removed by the Optimizer.
      */
     @Override
     public boolean foldable() {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CasePipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CasePipe.java
similarity index 66%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CasePipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CasePipe.java
index f3beb755c347b..96f18487585e7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CasePipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CasePipe.java
@@ -4,14 +4,14 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.MultiPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.MultiPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CaseProcessor.java
similarity index 94%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CaseProcessor.java
index 269faba3dc9e1..fc3d0417fb506 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CaseProcessor.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Coalesce.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Coalesce.java
similarity index 78%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Coalesce.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Coalesce.java
index faaa6ec1802da..898ce160a2baf 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Coalesce.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Coalesce.java
@@ -4,15 +4,15 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation.COALESCE;
+import static org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation.COALESCE;
 
 public class Coalesce extends ArbitraryConditionalFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalFunction.java
similarity index 76%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalFunction.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalFunction.java
index 79c3f906b4045..27b5c779c6b01 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalFunction.java
@@ -4,22 +4,22 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 
 import java.util.List;
 import java.util.Objects;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.type.DataTypes.areTypesCompatible;
-import static org.elasticsearch.xpack.sql.util.StringUtils.ordinal;
+import static org.elasticsearch.xpack.ql.type.DataTypes.areTypesCompatible;
+import static org.elasticsearch.xpack.ql.util.StringUtils.ordinal;
 
 /**
  * Base class for conditional predicates.
@@ -63,9 +63,9 @@ protected TypeResolution resolveType() {
                     return new TypeResolution(format(null, "{} argument of [{}] must be [{}], found value [{}] type [{}]",
                         ordinal(i + 1),
                         sourceText(),
-                        dt.typeName,
+                        dt.typeName(),
                         Expressions.name(child),
-                        child.dataType().typeName));
+                        child.dataType().typeName()));
                 }
             }
         }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalPipe.java
similarity index 72%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalPipe.java
index d543a87aef083..1d0e595f294a2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalPipe.java
@@ -4,15 +4,15 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.MultiPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.MultiPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalProcessor.java
similarity index 95%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalProcessor.java
index 82b3b4b5c3852..cd329efef5fbe 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/ConditionalProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/ConditionalProcessor.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Collection;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Conditionals.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Conditionals.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Conditionals.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Conditionals.java
index cf2576a3780eb..18121147d4e32 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Conditionals.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Conditionals.java
@@ -4,10 +4,10 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Comparisons;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Comparisons;
 
 import java.util.ArrayList;
 import java.util.Collection;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Greatest.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Greatest.java
similarity index 69%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Greatest.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Greatest.java
index 60df99e27e05f..6191cde4c1337 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Greatest.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Greatest.java
@@ -4,18 +4,18 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.LinkedHashSet;
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation.GREATEST;
+import static org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation.GREATEST;
 
 public class Greatest extends ArbitraryConditionalFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfConditional.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IfConditional.java
similarity index 87%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfConditional.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IfConditional.java
index 96d40f094a168..3316bb35d5ff4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfConditional.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IfConditional.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.Arrays;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfNull.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IfNull.java
similarity index 80%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfNull.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IfNull.java
index 2133a6b421336..1fc50f7d3613a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IfNull.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IfNull.java
@@ -4,11 +4,11 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Iif.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Iif.java
similarity index 69%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Iif.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Iif.java
index ac6a7d342939b..af55e86e1c17e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Iif.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Iif.java
@@ -3,24 +3,25 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.function.OptionalArgument;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypes;
 
 import java.util.Arrays;
 import java.util.List;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isBoolean;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isBoolean;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 
-public class Iif extends Case {
+public class Iif extends Case implements OptionalArgument {
 
     public Iif(Source source, Expression condition, Expression thenResult, Expression elseResult) {
         super(source, Arrays.asList(new IfConditional(source, condition, thenResult), elseResult != null ? elseResult : Literal.NULL));
@@ -55,9 +56,9 @@ protected TypeResolution resolveType() {
         if (DataTypes.areTypesCompatible(resultDataType, elseResult().dataType()) == false) {
             return new TypeResolution(format(null, "third argument of [{}] must be [{}], found value [{}] type [{}]",
                 sourceText(),
-                resultDataType.typeName,
+                resultDataType.typeName(),
                 Expressions.name(elseResult()),
-                elseResult().dataType().typeName));
+                elseResult().dataType().typeName()));
         }
         return TypeResolution.TYPE_RESOLVED;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Least.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Least.java
similarity index 69%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Least.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Least.java
index 7eec55b265f91..017d87beadb91 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/Least.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/Least.java
@@ -4,18 +4,18 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.LinkedHashSet;
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation.LEAST;
+import static org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation.LEAST;
 
 public class Least extends ArbitraryConditionalFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIf.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIf.java
similarity index 74%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIf.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIf.java
index 50692edb40e39..e1b85cde3feec 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIf.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIf.java
@@ -4,20 +4,20 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Accepts 2 arguments of any data type and returns null if they are equal,
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIfPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIfPipe.java
similarity index 67%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIfPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIfPipe.java
index 3d52d232e1262..d151960230293 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIfPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIfPipe.java
@@ -4,14 +4,14 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class NullIfPipe extends BinaryPipe {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIfProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIfProcessor.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIfProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIfProcessor.java
index 06bc04eae2469..11b5adadd41d4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/NullIfProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/NullIfProcessor.java
@@ -3,16 +3,16 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation.EQ;
+import static org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation.EQ;
 
 public class NullIfProcessor implements Processor {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextPredicate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextPredicate.java
similarity index 87%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextPredicate.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextPredicate.java
index 7af299b97f5d5..8bd00c1bf3ac8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextPredicate.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextPredicate.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.fulltext;
+package org.elasticsearch.xpack.ql.expression.predicate.fulltext;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextUtils.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextUtils.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextUtils.java
index f1191e07d3a06..8258ad87b4e9e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextUtils.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextUtils.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.fulltext;
+package org.elasticsearch.xpack.ql.expression.predicate.fulltext;
 
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.FullTextPredicate.Operator;
-import org.elasticsearch.xpack.sql.parser.ParsingException;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.ParsingException;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.FullTextPredicate.Operator;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.LinkedHashMap;
 import java.util.Locale;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/MatchQueryPredicate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/MatchQueryPredicate.java
similarity index 87%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/MatchQueryPredicate.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/MatchQueryPredicate.java
index eaab089d98877..d2725088feab5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/MatchQueryPredicate.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/MatchQueryPredicate.java
@@ -3,18 +3,17 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.fulltext;
+package org.elasticsearch.xpack.ql.expression.predicate.fulltext;
 
-import java.util.Objects;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import java.util.List;
+import java.util.Objects;
 
 import static java.util.Collections.singletonList;
 
-import java.util.List;
-
 public class MatchQueryPredicate extends FullTextPredicate {
 
     private final Expression field;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/MultiMatchQueryPredicate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/MultiMatchQueryPredicate.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/MultiMatchQueryPredicate.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/MultiMatchQueryPredicate.java
index 785cb4883334c..b75f32c222b5f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/MultiMatchQueryPredicate.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/MultiMatchQueryPredicate.java
@@ -3,19 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.fulltext;
+package org.elasticsearch.xpack.ql.expression.predicate.fulltext;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
+import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-
 import static java.util.Collections.emptyList;
 
-import java.util.List;
-
 public class MultiMatchQueryPredicate extends FullTextPredicate {
 
     private final String fieldString;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/StringQueryPredicate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/StringQueryPredicate.java
similarity index 83%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/StringQueryPredicate.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/StringQueryPredicate.java
index 02364f6f8b25f..8f3407a87c9eb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/StringQueryPredicate.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/StringQueryPredicate.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.fulltext;
+package org.elasticsearch.xpack.ql.expression.predicate.fulltext;
 
-import java.util.Map;
-import java.util.List;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import java.util.List;
+import java.util.Map;
 
 import static java.util.Collections.emptyList;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/And.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/And.java
similarity index 71%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/And.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/And.java
index 1508cfab91cf8..f173dcc4cd8b2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/And.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/And.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.logical;
+package org.elasticsearch.xpack.ql.expression.predicate.logical;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class And extends BinaryLogic implements Negatable<BinaryLogic> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogic.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogic.java
similarity index 63%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogic.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogic.java
index dfc5232cddd2d..1e370d9d7b292 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogic.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogic.java
@@ -3,18 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.logical;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.predicate.BinaryOperator;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isBoolean;
+package org.elasticsearch.xpack.ql.expression.predicate.logical;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.predicate.BinaryOperator;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isBoolean;
 
 public abstract class BinaryLogic extends BinaryOperator<Boolean, Boolean, Boolean, BinaryLogicOperation> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicPipe.java
similarity index 75%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicPipe.java
index 4dd51d6adea9f..a1b0c0737e994 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicPipe.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.logical;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+package org.elasticsearch.xpack.ql.expression.predicate.logical;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicProcessor.java
similarity index 82%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicProcessor.java
index 15f024b4f539e..1301b43a3ae8d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicProcessor.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.logical;
+package org.elasticsearch.xpack.ql.expression.predicate.logical;
 
 import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.FunctionalBinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.PredicateBiFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.gen.processor.FunctionalBinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.PredicateBiFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
 
 import java.io.IOException;
 import java.util.function.BiFunction;
@@ -85,7 +85,7 @@ public String getWriteableName() {
     @Override
     protected void checkParameter(Object param) {
         if (param != null && !(param instanceof Boolean)) {
-            throw new SqlIllegalArgumentException("A boolean is required; received {}", param);
+            throw new QlIllegalArgumentException("A boolean is required; received {}", param);
         }
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/Not.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/Not.java
similarity index 69%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/Not.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/Not.java
index 88e20d187f343..e32b2594010ac 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/Not.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/Not.java
@@ -3,19 +3,19 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.logical;
+package org.elasticsearch.xpack.ql.expression.predicate.logical;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isBoolean;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isBoolean;
 
 public class Not extends UnaryScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/NotProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/NotProcessor.java
similarity index 82%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/NotProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/NotProcessor.java
index 3480854d5015e..5691df019cbc5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/NotProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/NotProcessor.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.logical;
+package org.elasticsearch.xpack.ql.expression.predicate.logical;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 
@@ -41,7 +41,7 @@ public static Boolean apply(Object input) {
         }
         
         if (!(input instanceof Boolean)) {
-            throw new SqlIllegalArgumentException("A boolean is required; received {}", input);
+            throw new QlIllegalArgumentException("A boolean is required; received {}", input);
         }
 
         return ((Boolean) input).booleanValue() ? Boolean.FALSE : Boolean.TRUE;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/Or.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/Or.java
similarity index 71%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/Or.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/Or.java
index 01b85bf4a9b47..071af47ea59b2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/logical/Or.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/logical/Or.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.logical;
+package org.elasticsearch.xpack.ql.expression.predicate.logical;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class Or extends BinaryLogic implements Negatable<BinaryLogic> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/CheckNullProcessor.java
similarity index 94%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/CheckNullProcessor.java
index 73fff2c9c475f..eb12134858212 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/CheckNullProcessor.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.nulls;
+package org.elasticsearch.xpack.ql.expression.predicate.nulls;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNotNull.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/IsNotNull.java
similarity index 66%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNotNull.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/IsNotNull.java
index 53bf9bcc80504..5cae27d85f237 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNotNull.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/IsNotNull.java
@@ -3,18 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.nulls;
+package org.elasticsearch.xpack.ql.expression.predicate.nulls;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.CheckNullProcessor.CheckNullOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.CheckNullProcessor.CheckNullOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 public class IsNotNull extends UnaryScalarFunction implements Negatable<UnaryScalarFunction> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNull.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/IsNull.java
similarity index 65%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNull.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/IsNull.java
index c1d98dbe1b5c5..208160b66df39 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/IsNull.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/IsNull.java
@@ -3,18 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.nulls;
+package org.elasticsearch.xpack.ql.expression.predicate.nulls;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.CheckNullProcessor.CheckNullOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.CheckNullProcessor.CheckNullOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 public class IsNull extends UnaryScalarFunction implements Negatable<UnaryScalarFunction> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Add.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Add.java
similarity index 67%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Add.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Add.java
index 85b468b9a5b30..2ce2730afd5de 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Add.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Add.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 /**
  * Addition function ({@code a + b}).
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/ArithmeticOperation.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/ArithmeticOperation.java
similarity index 63%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/ArithmeticOperation.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/ArithmeticOperation.java
index 157f34dc404a2..584718b5f8085 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/ArithmeticOperation.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/ArithmeticOperation.java
@@ -3,18 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.predicate.BinaryOperator;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
-
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.predicate.BinaryOperator;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
+
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
 
 public abstract class ArithmeticOperation extends BinaryOperator<Object, Object, Object, BinaryArithmeticOperation> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Arithmetics.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Arithmetics.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Arithmetics.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Arithmetics.java
index 33a4f8c0e5603..03e514d636f34 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Arithmetics.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Arithmetics.java
@@ -3,21 +3,21 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
 import java.time.Duration;
 import java.time.OffsetTime;
 import java.time.Period;
 import java.time.temporal.Temporal;
 
-import static org.elasticsearch.xpack.sql.util.DateUtils.DAY_IN_MILLIS;
-
 /**
  * Arithmetic operation using the type widening rules of the JLS 5.6.2 namely
  * widen to double or float or long or int in this order.
  */
 public final class Arithmetics {
 
+    public static final long DAY_IN_MILLIS = 60 * 60 * 24 * 1000L;
+
     private Arithmetics() {}
 
     private enum IntervalOperation {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticPipe.java
similarity index 75%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticPipe.java
index 1a5b12229ff2e..1492d7d37fe52 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticPipe.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessor.java
similarity index 81%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessor.java
index 5705bb4d85ab4..382f2e3eeeeff 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessor.java
@@ -3,18 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.script.JodaCompatibleZonedDateTime;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.FunctionalBinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.literal.Interval;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalDayTime;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
-import org.elasticsearch.xpack.sql.expression.predicate.PredicateBiFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.gen.processor.FunctionalBinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.literal.Interval;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalDayTime;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalYearMonth;
+import org.elasticsearch.xpack.ql.expression.predicate.PredicateBiFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
 
 import java.io.IOException;
 import java.time.OffsetTime;
@@ -56,7 +56,7 @@ public enum BinaryArithmeticOperation implements PredicateBiFunction<Object, Obj
                 return Arithmetics.add((Temporal) r, ((IntervalDayTime) l).interval());
             }
 
-            throw new SqlIllegalArgumentException("Cannot compute [+] between [{}] [{}]", l.getClass().getSimpleName(),
+            throw new QlIllegalArgumentException("Cannot compute [+] between [{}] [{}]", l.getClass().getSimpleName(),
                     r.getClass().getSimpleName());
         }, "+"),
         SUB((Object l, Object r) -> {
@@ -78,10 +78,10 @@ public enum BinaryArithmeticOperation implements PredicateBiFunction<Object, Obj
                 return Arithmetics.sub((Temporal) l, ((IntervalDayTime) r).interval());
             }
             if ((r instanceof ZonedDateTime  || r instanceof OffsetTime) && l instanceof Interval<?>) {
-                throw new SqlIllegalArgumentException("Cannot subtract a date from an interval; do you mean the reverse?");
+                throw new QlIllegalArgumentException("Cannot subtract a date from an interval; do you mean the reverse?");
             }
 
-            throw new SqlIllegalArgumentException("Cannot compute [-] between [{}] [{}]", l.getClass().getSimpleName(),
+            throw new QlIllegalArgumentException("Cannot compute [-] between [{}] [{}]", l.getClass().getSimpleName(),
                     r.getClass().getSimpleName());
         }, "-"),
         MUL((Object l, Object r) -> {
@@ -103,7 +103,7 @@ public enum BinaryArithmeticOperation implements PredicateBiFunction<Object, Obj
                 return ((IntervalDayTime) l).mul(((Number) r).longValue());
             }
 
-            throw new SqlIllegalArgumentException("Cannot compute [*] between [{}] [{}]", l.getClass().getSimpleName(),
+            throw new QlIllegalArgumentException("Cannot compute [*] between [{}] [{}]", l.getClass().getSimpleName(),
                     r.getClass().getSimpleName());
         }, "*"),
         DIV(Arithmetics::div, "/"),
@@ -166,11 +166,11 @@ protected Object doProcess(Object left, Object right) {
 
         if (f == BinaryArithmeticOperation.DIV || f == BinaryArithmeticOperation.MOD) {
             if (!(left instanceof Number)) {
-                throw new SqlIllegalArgumentException("A number is required; received {}", left);
+                throw new QlIllegalArgumentException("A number is required; received {}", left);
             }
 
             if (!(right instanceof Number)) {
-                throw new SqlIllegalArgumentException("A number is required; received {}", right);
+                throw new QlIllegalArgumentException("A number is required; received {}", right);
             }
 
             return f.apply(left, right);
@@ -181,6 +181,6 @@ protected Object doProcess(Object left, Object right) {
         }
 
         // this should not occur
-        throw new SqlIllegalArgumentException("Cannot perform arithmetic operation due to arguments");
+        throw new QlIllegalArgumentException("Cannot perform arithmetic operation due to arguments");
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java
similarity index 82%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java
index 39797a7351627..2e1f03666b3e9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/DateTimeArithmeticOperation.java
@@ -4,13 +4,13 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Div.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Div.java
similarity index 65%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Div.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Div.java
index c0431f268ba56..2045c094d436a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Div.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Div.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 
 /**
  * Division function ({@code a / b}).
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mod.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Mod.java
similarity index 71%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mod.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Mod.java
index 907ef1dab4f19..68688fc6b83a6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mod.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Mod.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Modulo_operation">Modulo</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mul.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Mul.java
similarity index 81%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mul.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Mul.java
index f1e90c2dbd668..5868355a0a828 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Mul.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Mul.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Neg.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Neg.java
similarity index 62%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Neg.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Neg.java
index a8c7f87d6380d..dc62f62122ab2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Neg.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Neg.java
@@ -3,19 +3,19 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.UnaryArithmeticProcessor.UnaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.UnaryArithmeticProcessor.UnaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
 
 /**
  * Negation function (@{code -x}).
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Sub.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Sub.java
similarity index 74%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Sub.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Sub.java
index affb02a4009c0..61e7e24787884 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/Sub.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/Sub.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 
@@ -39,7 +39,7 @@ protected TypeResolution resolveWithIntervals() {
         }
         if ((right().dataType().isDateOrTimeBased()) && left().dataType().isInterval()) {
             return new TypeResolution(format(null, "Cannot subtract a {}[{}] from an interval[{}]; do you mean the reverse?",
-                right().dataType().typeName, right().source().text(), left().source().text()));
+                right().dataType().typeName(), right().source().text(), left().source().text()));
         }
         return TypeResolution.TYPE_RESOLVED;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/UnaryArithmeticProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/UnaryArithmeticProcessor.java
similarity index 85%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/UnaryArithmeticProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/UnaryArithmeticProcessor.java
index e75ca47b7f453..82726328782ff 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/UnaryArithmeticProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/UnaryArithmeticProcessor.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.function.Function;
@@ -65,7 +65,7 @@ public Object process(Object input) {
         if (input instanceof Number) {
             return operation.apply((Number) input);
         }
-        throw new SqlIllegalArgumentException("A number is required; received {}", input);
+        throw new QlIllegalArgumentException("A number is required; received {}", input);
     }
 
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparison.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparison.java
similarity index 67%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparison.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparison.java
index fdd33af077b40..322c3f86e6553 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparison.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparison.java
@@ -3,16 +3,16 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.TypeResolutions;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.predicate.BinaryOperator;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.TypeResolutions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.predicate.BinaryOperator;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 // marker class to indicate operations that rely on values
 public abstract class BinaryComparison extends BinaryOperator<Object, Object, Boolean, BinaryComparisonOperation> {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonPipe.java
similarity index 75%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonPipe.java
index 0ffebadff9e53..43f2c4956a495 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonPipe.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonProcessor.java
similarity index 84%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonProcessor.java
index 7064562e65fb4..c7867e0ffdd5a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonProcessor.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
 import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.FunctionalBinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.PredicateBiFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.expression.gen.processor.FunctionalBinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.PredicateBiFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
 
 import java.io.IOException;
 import java.util.function.BiFunction;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/Comparisons.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/Comparisons.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/Comparisons.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/Comparisons.java
index 37d6983d927b4..4a375252c99a3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/Comparisons.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/Comparisons.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
 import java.util.Set;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/Equals.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/Equals.java
similarity index 69%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/Equals.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/Equals.java
index a8d609ac9020d..93c7f809d3179 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/Equals.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/Equals.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class Equals extends BinaryComparison implements Negatable<BinaryComparison> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/GreaterThan.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/GreaterThan.java
similarity index 70%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/GreaterThan.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/GreaterThan.java
index 9388a26fe886f..996a3eb573fbd 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/GreaterThan.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/GreaterThan.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class GreaterThan extends BinaryComparison implements Negatable<BinaryComparison> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/GreaterThanOrEqual.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/GreaterThanOrEqual.java
similarity index 71%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/GreaterThanOrEqual.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/GreaterThanOrEqual.java
index 51b5e926bef7d..b43727a99cf13 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/GreaterThanOrEqual.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/GreaterThanOrEqual.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class GreaterThanOrEqual extends BinaryComparison implements Negatable<BinaryComparison> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/In.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/In.java
similarity index 79%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/In.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/In.java
index 4be6d76b8c8f9..435a3447f46cc 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/In.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/In.java
@@ -3,20 +3,20 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.TypeResolutions;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.CollectionUtils;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.TypeResolutions;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
 
 import java.util.ArrayList;
 import java.util.LinkedHashSet;
@@ -25,9 +25,9 @@
 import java.util.stream.Collectors;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
-import static org.elasticsearch.xpack.sql.type.DataTypes.areTypesCompatible;
-import static org.elasticsearch.xpack.sql.util.StringUtils.ordinal;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.type.DataTypes.areTypesCompatible;
+import static org.elasticsearch.xpack.ql.util.StringUtils.ordinal;
 
 public class In extends ScalarFunction {
 
@@ -130,9 +130,9 @@ protected TypeResolution resolveType() {
                 return new TypeResolution(format(null, "{} argument of [{}] must be [{}], found value [{}] type [{}]",
                     ordinal(i + 1),
                     sourceText(),
-                    dt.typeName,
+                    dt.typeName(),
                     Expressions.name(listValue),
-                    listValue.dataType().typeName));
+                    listValue.dataType().typeName()));
             }
         }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InPipe.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InPipe.java
similarity index 76%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InPipe.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InPipe.java
index fa7c06a5e3f67..993bd1d80019a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InPipe.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InPipe.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.MultiPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.MultiPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InProcessor.java
similarity index 72%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InProcessor.java
index 82233e250e364..2ceb90a39de5e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InProcessor.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
+import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
 
@@ -41,7 +41,15 @@ public final void writeTo(StreamOutput out) throws IOException {
     @Override
     public Object process(Object input) {
         Object leftValue = processsors.get(processsors.size() - 1).process(input);
-        return apply(leftValue, Processors.process(processsors.subList(0, processsors.size() - 1), leftValue));
+        return apply(leftValue, process(processsors.subList(0, processsors.size() - 1), leftValue));
+    }
+
+    private static List<Object> process(List<Processor> processors, Object input) {
+        List<Object> values = new ArrayList<>(processors.size());
+        for (Processor p : processors) {
+            values.add(p.process(input));
+        }
+        return values;
     }
 
     public static Boolean apply(Object input, List<Object> values) {
@@ -59,8 +67,12 @@ public static Boolean apply(Object input, List<Object> values) {
 
     @Override
     public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
         InProcessor that = (InProcessor) o;
         return Objects.equals(processsors, that.processsors);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/LessThan.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/LessThan.java
similarity index 70%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/LessThan.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/LessThan.java
index d1d7b414ea5fe..bbbf712ee27dc 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/LessThan.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/LessThan.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class LessThan extends BinaryComparison implements Negatable<BinaryComparison> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/LessThanOrEqual.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/LessThanOrEqual.java
similarity index 71%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/LessThanOrEqual.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/LessThanOrEqual.java
index 00f4f01937eaa..0e136a5ca4648 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/LessThanOrEqual.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/LessThanOrEqual.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class LessThanOrEqual extends BinaryComparison implements Negatable<BinaryComparison> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/NotEquals.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/NotEquals.java
similarity index 70%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/NotEquals.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/NotEquals.java
index 8d88e851dce86..330549b1d47e2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/NotEquals.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/NotEquals.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class NotEquals extends BinaryComparison implements Negatable<BinaryComparison> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/NullEquals.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/NullEquals.java
similarity index 70%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/NullEquals.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/NullEquals.java
index 70479e2d704e8..51b97fc5b0362 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/NullEquals.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/NullEquals.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 /**
  * Implements the MySQL {@code <=>} operator
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/Like.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/Like.java
similarity index 71%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/Like.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/Like.java
index e67f4943445af..dbe751276be0d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/Like.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/Like.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.regex;
+package org.elasticsearch.xpack.ql.expression.predicate.regex;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RegexProcessor.RegexOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.RegexProcessor.RegexOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class Like extends RegexMatch<LikePattern> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/LikePattern.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/LikePattern.java
similarity index 94%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/LikePattern.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/LikePattern.java
index d07df617df9f0..fd6663b4b5ac3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/LikePattern.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/LikePattern.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.regex;
+package org.elasticsearch.xpack.ql.expression.predicate.regex;
 
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RLike.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RLike.java
similarity index 70%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RLike.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RLike.java
index 187eda3fdece1..9ec70bc79d1d8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RLike.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RLike.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.regex;
+package org.elasticsearch.xpack.ql.expression.predicate.regex;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RegexProcessor.RegexOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.RegexProcessor.RegexOperation;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class RLike extends RegexMatch<String> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RegexMatch.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RegexMatch.java
similarity index 73%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RegexMatch.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RegexMatch.java
index 82c6d570f39f5..c1b9cd4db937c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RegexMatch.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RegexMatch.java
@@ -4,18 +4,18 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.regex;
+package org.elasticsearch.xpack.ql.expression.predicate.regex;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
 
 public abstract class RegexMatch<T> extends UnaryScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RegexProcessor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RegexProcessor.java
similarity index 94%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RegexProcessor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RegexProcessor.java
index 7f9a2ed76235a..c23219a58e248 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/predicate/regex/RegexProcessor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/regex/RegexProcessor.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.regex;
+package org.elasticsearch.xpack.ql.expression.predicate.regex;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/processor/Processors.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/processor/Processors.java
new file mode 100644
index 0000000000000..ac954a67e5aad
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/processor/Processors.java
@@ -0,0 +1,66 @@
+/*
+* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql.expression.processor;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry.Entry;
+import org.elasticsearch.xpack.ql.expression.gen.processor.BucketExtractorProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ChainingProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.HitExtractorProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.CaseProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.NullIfProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.NotProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.CheckNullProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.UnaryArithmeticProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.InProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.RegexProcessor;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public final class Processors {
+
+    private Processors() {}
+
+    /**
+     * All of the named writeables needed to deserialize the instances of
+     * {@linkplain Processors}.
+     */
+    public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
+        List<NamedWriteableRegistry.Entry> entries = new ArrayList<>();
+        // base
+        entries.add(new Entry(Processor.class, ConstantProcessor.NAME, ConstantProcessor::new));
+        entries.add(new Entry(Processor.class, HitExtractorProcessor.NAME, HitExtractorProcessor::new));
+        entries.add(new Entry(Processor.class, BucketExtractorProcessor.NAME, BucketExtractorProcessor::new));
+        entries.add(new Entry(Processor.class, ChainingProcessor.NAME, ChainingProcessor::new));
+
+        // logical
+        entries.add(new Entry(Processor.class, BinaryLogicProcessor.NAME, BinaryLogicProcessor::new));
+        entries.add(new Entry(Processor.class, NotProcessor.NAME, NotProcessor::new));
+        // conditionals
+        entries.add(new Entry(Processor.class, CaseProcessor.NAME, CaseProcessor::new));
+        entries.add(new Entry(Processor.class, CheckNullProcessor.NAME, CheckNullProcessor::new));
+        entries.add(new Entry(Processor.class, ConditionalProcessor.NAME, ConditionalProcessor::new));
+        entries.add(new Entry(Processor.class, NullIfProcessor.NAME, NullIfProcessor::new));
+
+        // arithmetic
+        entries.add(new Entry(Processor.class, BinaryArithmeticProcessor.NAME, BinaryArithmeticProcessor::new));
+        entries.add(new Entry(Processor.class, UnaryArithmeticProcessor.NAME, UnaryArithmeticProcessor::new));
+        // comparators
+        entries.add(new Entry(Processor.class, BinaryComparisonProcessor.NAME, BinaryComparisonProcessor::new));
+        entries.add(new Entry(Processor.class, InProcessor.NAME, InProcessor::new));
+        // regex
+        entries.add(new Entry(Processor.class, RegexProcessor.NAME, RegexProcessor::new));
+
+        return entries;
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/EsIndex.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/EsIndex.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/EsIndex.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/EsIndex.java
index 790bb67c22cf6..1481199cecf99 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/EsIndex.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/EsIndex.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.analysis.index;
+package org.elasticsearch.xpack.ql.index;
 
-import org.elasticsearch.xpack.sql.type.EsField;
+import org.elasticsearch.xpack.ql.type.EsField;
 
 import java.util.Map;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolution.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolution.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolution.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolution.java
index 4e796ecd8957a..9822c9633b7e8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolution.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolution.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.analysis.index;
+package org.elasticsearch.xpack.ql.index;
 
 import org.elasticsearch.common.Nullable;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolver.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolver.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolver.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolver.java
index f4acf809c98c3..17442da04138b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolver.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolver.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.analysis.index;
+package org.elasticsearch.xpack.ql.index;
 
 import com.carrotsearch.hppc.cursors.ObjectCursor;
 
@@ -24,16 +24,16 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.index.IndexNotFoundException;
 import org.elasticsearch.index.IndexSettings;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DateEsField;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.InvalidMappedField;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
-import org.elasticsearch.xpack.sql.type.TextEsField;
-import org.elasticsearch.xpack.sql.type.UnsupportedEsField;
-import org.elasticsearch.xpack.sql.util.CollectionUtils;
-import org.elasticsearch.xpack.sql.util.Holder;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DateEsField;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.InvalidMappedField;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
+import org.elasticsearch.xpack.ql.type.TextEsField;
+import org.elasticsearch.xpack.ql.type.UnsupportedEsField;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
+import org.elasticsearch.xpack.ql.util.Holder;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -278,7 +278,9 @@ public void resolveAsMergedMapping(String indexWildcard, String javaRegex, boole
                         listener::onFailure));
     }
 
-    static IndexResolution mergedMappings(String indexPattern, String[] indexNames, Map<String, Map<String, FieldCapabilities>> fieldCaps) {
+    public static IndexResolution mergedMappings(String indexPattern, String[] indexNames, 
+            Map<String, Map<String, FieldCapabilities>> fieldCaps) {
+
         if (fieldCaps == null || fieldCaps.isEmpty()) {
             return IndexResolution.notFound(indexPattern);
         }
@@ -339,7 +341,7 @@ static IndexResolution mergedMappings(String indexPattern, String[] indexNames,
         });
 
         if (indices.size() > 1) {
-            throw new SqlIllegalArgumentException(
+            throw new QlIllegalArgumentException(
                     "Incorrect merging of mappings (likely due to a bug) - expect at most one but found [{}]",
                     indices.size());
         }
@@ -435,7 +437,7 @@ public void resolveAsSeparateMappings(String indexWildcard, String javaRegex, bo
 
     }
     
-    static List<EsIndex> separateMappings(String indexPattern, String javaRegex, String[] indexNames,
+    public static List<EsIndex> separateMappings(String indexPattern, String javaRegex, String[] indexNames,
             Map<String, Map<String, FieldCapabilities>> fieldCaps) {
         return buildIndices(indexNames, javaRegex, fieldCaps, Function.identity(), (s, cap) -> null);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/MappingException.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/MappingException.java
similarity index 77%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/MappingException.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/MappingException.java
index b510aa0483093..e88c86d42ed43 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/index/MappingException.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/MappingException.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.analysis.index;
+package org.elasticsearch.xpack.ql.index;
 
 import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.xpack.sql.ClientSqlException;
+import org.elasticsearch.xpack.ql.QlClientException;
 
-public class MappingException extends ClientSqlException {
+public class MappingException extends QlClientException {
 
     public MappingException(String message, Object... args) {
         super(message, args);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/QueryPlan.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/QueryPlan.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/QueryPlan.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/QueryPlan.java
index 35b85da028341..3e7c5c921593e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/QueryPlan.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/QueryPlan.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan;
-
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeSet;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.Node;
-import org.elasticsearch.xpack.sql.type.DataType;
+package org.elasticsearch.xpack.ql.plan;
+
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeSet;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.ArrayList;
 import java.util.Collection;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/TableIdentifier.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/TableIdentifier.java
similarity index 94%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/TableIdentifier.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/TableIdentifier.java
index 9d17d766c2f96..07ffac36a2081 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/TableIdentifier.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/TableIdentifier.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan;
+package org.elasticsearch.xpack.ql.plan;
 
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Aggregate.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Aggregate.java
similarity index 81%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Aggregate.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Aggregate.java
index 39fef8188b27d..7d5ec59e2b30b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Aggregate.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Aggregate.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
 
-import org.elasticsearch.xpack.sql.capabilities.Resolvables;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.capabilities.Resolvables;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/BinaryPlan.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/BinaryPlan.java
similarity index 77%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/BinaryPlan.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/BinaryPlan.java
index 8763336d3c671..ba576e0fe0cb6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/BinaryPlan.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/BinaryPlan.java
@@ -3,18 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
+
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.tree.Source;
-
-abstract class BinaryPlan extends LogicalPlan {
+public abstract class BinaryPlan extends LogicalPlan {
 
     private final LogicalPlan left, right;
 
-    BinaryPlan(Source source, LogicalPlan left, LogicalPlan right) {
+    protected BinaryPlan(Source source, LogicalPlan left, LogicalPlan right) {
         super(source, Arrays.asList(left, right));
         this.left = left;
         this.right = right;
@@ -39,7 +39,7 @@ public boolean equals(Object obj) {
 
         BinaryPlan other = (BinaryPlan) obj;
 
-        return Objects.equals(left(), other.left()) 
+        return Objects.equals(left(), other.left())
                 && Objects.equals(right(), other.right());
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/EsRelation.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/EsRelation.java
similarity index 90%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/EsRelation.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/EsRelation.java
index 01a88ef06fcec..c16c5319da5e0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/EsRelation.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/EsRelation.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
-
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.EsField;
+package org.elasticsearch.xpack.ql.plan.logical;
+
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.EsField;
 
 import java.util.ArrayList;
 import java.util.Collection;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Filter.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Filter.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Filter.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Filter.java
index beeb97c563f0a..94f17bb68d460 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Filter.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Filter.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
 
-import java.util.Objects;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import java.util.Objects;
 
 /**
  * A {@code Filter} is a type of Plan that performs filtering of results. In
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LeafPlan.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/LeafPlan.java
similarity index 86%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LeafPlan.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/LeafPlan.java
index 9612d8786e3f7..8b1ef29c8755c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LeafPlan.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/LeafPlan.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
+
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Collections;
 import java.util.List;
 
-import org.elasticsearch.xpack.sql.tree.Source;
-
 abstract class LeafPlan extends LogicalPlan {
 
     protected LeafPlan(Source source) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Limit.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Limit.java
similarity index 86%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Limit.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Limit.java
index 85735a071e7d0..4d36def488d3d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Limit.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Limit.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
 
-import java.util.Objects;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import java.util.Objects;
 
 public class Limit extends UnaryPlan {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LogicalPlan.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/LogicalPlan.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LogicalPlan.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/LogicalPlan.java
index 79614242012f7..bc8b2216ababd 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LogicalPlan.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/LogicalPlan.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
 
-import org.elasticsearch.xpack.sql.capabilities.Resolvable;
-import org.elasticsearch.xpack.sql.capabilities.Resolvables;
-import org.elasticsearch.xpack.sql.plan.QueryPlan;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.capabilities.Resolvable;
+import org.elasticsearch.xpack.ql.capabilities.Resolvables;
+import org.elasticsearch.xpack.ql.plan.QueryPlan;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/OrderBy.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/OrderBy.java
similarity index 84%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/OrderBy.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/OrderBy.java
index a3e3d9576b0d5..93482a2d5b7f4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/OrderBy.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/OrderBy.java
@@ -3,16 +3,16 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
+
+import org.elasticsearch.xpack.ql.capabilities.Resolvables;
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.capabilities.Resolvables;
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-
 public class OrderBy extends UnaryPlan {
 
     private final List<Order> order;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Project.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Project.java
similarity index 80%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Project.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Project.java
index e57b2cdce4657..45bf1533cfb9b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Project.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/Project.java
@@ -3,19 +3,19 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
+
+import org.elasticsearch.xpack.ql.capabilities.Resolvables;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.function.Functions;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.capabilities.Resolvables;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.function.Functions;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-
 /**
  * A {@code Project} is a {@code Plan} with one child. In {@code SELECT x FROM y}, the "SELECT" statement is a Project.
  */
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/UnaryPlan.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/UnaryPlan.java
similarity index 88%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/UnaryPlan.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/UnaryPlan.java
index f81a48d64fd5b..44f59a9aff6c0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/UnaryPlan.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/UnaryPlan.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
+
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Collections;
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.tree.Source;
-
 /**
  * A {@code UnaryPlan} is a {@code LogicalPlan} with exactly one child, for example, {@code WHERE x} in a
  * SQL statement is an {@code UnaryPlan}.
@@ -20,7 +20,7 @@ public abstract class UnaryPlan extends LogicalPlan {
 
     private final LogicalPlan child;
 
-    UnaryPlan(Source source, LogicalPlan child) {
+    protected UnaryPlan(Source source, LogicalPlan child) {
         super(source, Collections.singletonList(child));
         this.child = child;
     }
@@ -32,6 +32,7 @@ public final UnaryPlan replaceChildren(List<LogicalPlan> newChildren) {
         }
         return replaceChild(newChildren.get(0));
     }
+
     protected abstract UnaryPlan replaceChild(LogicalPlan newChild);
 
     public LogicalPlan child() {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/UnresolvedRelation.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/UnresolvedRelation.java
similarity index 89%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/UnresolvedRelation.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/UnresolvedRelation.java
index 09ce8023f25ba..e0c569af21b1b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/UnresolvedRelation.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plan/logical/UnresolvedRelation.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.plan.logical;
+package org.elasticsearch.xpack.ql.plan.logical;
 
-import org.elasticsearch.xpack.sql.capabilities.Unresolvable;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.plan.TableIdentifier;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.capabilities.Unresolvable;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.plan.TableIdentifier;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Collections;
 import java.util.List;
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plugin/QlPlugin.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plugin/QlPlugin.java
new file mode 100644
index 0000000000000..110e5fbffc65c
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/plugin/QlPlugin.java
@@ -0,0 +1,14 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.plugin;
+
+import org.elasticsearch.plugins.ExtensiblePlugin;
+import org.elasticsearch.plugins.Plugin;
+
+public class QlPlugin extends Plugin implements ExtensiblePlugin {
+
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/Rule.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/Rule.java
similarity index 90%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/Rule.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/Rule.java
index 5bdd74fefc3df..852f00952245e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/Rule.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/Rule.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.rule;
-
-import java.util.function.UnaryOperator;
+package org.elasticsearch.xpack.ql.rule;
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-import org.elasticsearch.xpack.sql.tree.Node;
-import org.elasticsearch.xpack.sql.util.ReflectionUtils;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.ql.util.ReflectionUtils;
+
+import java.util.function.UnaryOperator;
 
 /**
  * Rules that apply transformation to a tree. In addition, performs
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/RuleExecutionException.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/RuleExecutionException.java
similarity index 68%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/RuleExecutionException.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/RuleExecutionException.java
index ab5bf8ec4ce2d..5b26a537ad026 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/RuleExecutionException.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/RuleExecutionException.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.rule;
+package org.elasticsearch.xpack.ql.rule;
 
-import org.elasticsearch.xpack.sql.ServerSqlException;
+import org.elasticsearch.xpack.ql.QlServerException;
 
-public class RuleExecutionException extends ServerSqlException {
+public class RuleExecutionException extends QlServerException {
 
     public RuleExecutionException(String message, Object... args) {
         super(message, args);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/RuleExecutor.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/RuleExecutor.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/RuleExecutor.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/RuleExecutor.java
index 689b0b338a99e..5280aad3d78b8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/rule/RuleExecutor.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/rule/RuleExecutor.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.rule;
+package org.elasticsearch.xpack.ql.rule;
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.xpack.sql.tree.Node;
-import org.elasticsearch.xpack.sql.tree.NodeUtils;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.ql.tree.NodeUtils;
 
 import java.util.ArrayList;
 import java.util.LinkedHashMap;
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/session/Configuration.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/session/Configuration.java
new file mode 100644
index 0000000000000..d5d0445898625
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/session/Configuration.java
@@ -0,0 +1,41 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.session;
+
+import java.time.ZoneId;
+import java.time.ZonedDateTime;
+
+public class Configuration {
+
+    private final String clusterName;
+    private final String username;
+    private final ZonedDateTime now;
+    private final ZoneId zoneId;
+
+    public Configuration(ZoneId zi, String username, String clusterName) {
+        this.zoneId = zi.normalized();
+        this.now = ZonedDateTime.now(zoneId);
+        this.username = username;
+        this.clusterName = clusterName;
+    }
+
+    public ZoneId zoneId() {
+        return zoneId;
+    }
+
+    public ZonedDateTime now() {
+        return now;
+    }
+
+    public String clusterName() {
+        return clusterName;
+    }
+
+    public String username() {
+        return username;
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Location.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Location.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Location.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Location.java
index 6a5543a69db70..a621a007c7fcb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Location.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Location.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.tree;
+package org.elasticsearch.xpack.ql.tree;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Node.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Node.java
similarity index 98%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Node.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Node.java
index 0d686fc5cf16a..1d2a65d9a4a85 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Node.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Node.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.tree;
+package org.elasticsearch.xpack.ql.tree;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 
 import java.util.ArrayList;
 import java.util.BitSet;
@@ -41,7 +41,7 @@ public abstract class Node<T extends Node<T>> {
     public Node(Source source, List<T> children) {
         this.source = (source != null ? source : Source.EMPTY);
         if (children.contains(null)) {
-            throw new SqlIllegalArgumentException("Null children are not allowed");
+            throw new QlIllegalArgumentException("Null children are not allowed");
         }
         this.children = children;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/NodeInfo.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/NodeInfo.java
similarity index 99%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/NodeInfo.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/NodeInfo.java
index d23c93b31beea..191150dba87f9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/NodeInfo.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/NodeInfo.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.tree;
+package org.elasticsearch.xpack.ql.tree;
 
 import java.util.Arrays;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/NodeUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/NodeUtils.java
similarity index 98%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/NodeUtils.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/NodeUtils.java
index f2cb74f6abcb4..3e2b67a9e79c8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/NodeUtils.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/NodeUtils.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.tree;
+package org.elasticsearch.xpack.ql.tree;
 
 public abstract class NodeUtils {
     public static <A extends Node<A>, B extends Node<B>> String diffString(A left, B right) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Source.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Source.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Source.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Source.java
index d689a7f31dd8e..459526ddab764 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/tree/Source.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/tree/Source.java
@@ -4,15 +4,13 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.tree;
-
-import org.elasticsearch.xpack.sql.proto.StringUtils;
+package org.elasticsearch.xpack.ql.tree;
 
 import java.util.Objects;
 
 public final class Source {
 
-    public static final Source EMPTY = new Source(Location.EMPTY, StringUtils.EMPTY);
+    public static final Source EMPTY = new Source(Location.EMPTY, "");
 
     private final Location location;
     private final String text;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataType.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataType.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataType.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataType.java
index 19fda28f76ffd..80dae7dd13366 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataType.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataType.java
@@ -3,10 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import org.elasticsearch.index.mapper.NumberFieldMapper.NumberType;
-import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.sql.JDBCType;
 import java.sql.SQLType;
@@ -152,27 +151,17 @@ public enum DataType {
         SQL_TO_ES.put("STRING", DataType.KEYWORD);
     }
 
-    /**
-     * Type's name used for error messages and column info for the clients
-     */
-    public final String typeName;
 
-    /**
-     * Elasticsearch data type that it maps to
-     */
-    public final String esType;
+    private final String typeName;
+
+    private final String esType;
 
     /**
      * Compatible JDBC type
      */
-    public final SQLType sqlType;
+    private final SQLType sqlType;
 
-    /**
-     * Size of the type in bytes
-     * <p>
-     * -1 if the size can vary
-     */
-    public final int size;
+    private final int size;
 
     /**
      * Precision
@@ -223,6 +212,27 @@ public enum DataType {
         this.defaultDocValues = defaultDocValues;
     }
 
+    public String typeName() {
+        return typeName;
+    }
+
+    public String esType() {
+        return esType;
+    }
+
+    public SQLType sqlType() {
+        return sqlType;
+    }
+
+    /**
+     * Size of the type in bytes
+     * <p>
+     * -1 if the size can vary
+     */
+    public int size() {
+        return size;
+    }
+
     public String sqlName() {
         return sqlType.getName();
     }
@@ -333,6 +343,7 @@ public static DataType fromTypeName(String esType) {
     }
 
     public String format() {
+
         return isDateOrTimeBased() ? DateUtils.DATE_PARSE_FORMAT : null;
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypeConversion.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypeConversion.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypeConversion.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypeConversion.java
index 8e3158c3e6a8a..cff0e13cfb846 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypeConversion.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypeConversion.java
@@ -3,12 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import org.elasticsearch.common.Booleans;
 import org.elasticsearch.common.network.InetAddresses;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.util.DateUtils;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 
 import java.time.OffsetTime;
 import java.time.ZonedDateTime;
@@ -18,18 +17,18 @@
 import java.util.function.Function;
 import java.util.function.LongFunction;
 
-import static org.elasticsearch.xpack.sql.type.DataType.BOOLEAN;
-import static org.elasticsearch.xpack.sql.type.DataType.DATE;
-import static org.elasticsearch.xpack.sql.type.DataType.DATETIME;
-import static org.elasticsearch.xpack.sql.type.DataType.LONG;
-import static org.elasticsearch.xpack.sql.type.DataType.NULL;
-import static org.elasticsearch.xpack.sql.type.DataType.TEXT;
-import static org.elasticsearch.xpack.sql.type.DataType.TIME;
+import static org.elasticsearch.xpack.ql.type.DataType.BOOLEAN;
+import static org.elasticsearch.xpack.ql.type.DataType.DATE;
+import static org.elasticsearch.xpack.ql.type.DataType.DATETIME;
+import static org.elasticsearch.xpack.ql.type.DataType.LONG;
+import static org.elasticsearch.xpack.ql.type.DataType.NULL;
+import static org.elasticsearch.xpack.ql.type.DataType.TEXT;
+import static org.elasticsearch.xpack.ql.type.DataType.TIME;
 
 /**
  * Conversions from one Elasticsearch data type to another Elasticsearch data types.
  * <p>
- * This class throws {@link SqlIllegalArgumentException} to differentiate between validation
+ * This class throws {@link QlIllegalArgumentException} to differentiate between validation
  * errors inside SQL as oppose to the rest of ES.
  */
 public abstract class DataTypeConversion {
@@ -62,7 +61,7 @@ public static DataType commonType(DataType left, DataType right) {
             if (left.isInteger()) {
                 // promote the highest int
                 if (right.isInteger()) {
-                    return left.size > right.size ? left : right;
+                    return left.size() > right.size() ? left : right;
                 }
                 // promote the rational
                 return right;
@@ -72,7 +71,7 @@ public static DataType commonType(DataType left, DataType right) {
                 return left;
             }
             // promote the highest rational
-            return left.size > right.size ? left : right;
+            return left.size() > right.size() ? left : right;
         }
         if (left.isString()) {
             if (right.isNumeric()) {
@@ -180,7 +179,7 @@ public static Conversion conversionFor(DataType from, DataType to) {
         
         Conversion conversion = conversion(from, to);
         if (conversion == null) {
-            throw new SqlIllegalArgumentException("cannot convert from [" + from.typeName + "] to [" + to.typeName + "]");
+            throw new QlIllegalArgumentException("cannot convert from [" + from.typeName() + "] to [" + to.typeName() + "]");
         }
         return conversion;
     }
@@ -469,28 +468,28 @@ private static Conversion conversionToBoolean(DataType from) {
 
     public static byte safeToByte(long x) {
         if (x > Byte.MAX_VALUE || x < Byte.MIN_VALUE) {
-            throw new SqlIllegalArgumentException("[" + x + "] out of [byte] range");
+            throw new QlIllegalArgumentException("[" + x + "] out of [byte] range");
         }
         return (byte) x;
     }
 
     public static short safeToShort(long x) {
         if (x > Short.MAX_VALUE || x < Short.MIN_VALUE) {
-            throw new SqlIllegalArgumentException("[" + x + "] out of [short] range");
+            throw new QlIllegalArgumentException("[" + x + "] out of [short] range");
         }
         return (short) x;
     }
 
     public static int safeToInt(long x) {
         if (x > Integer.MAX_VALUE || x < Integer.MIN_VALUE) {
-            throw new SqlIllegalArgumentException("[" + x + "] out of [integer] range");
+            throw new QlIllegalArgumentException("[" + x + "] out of [integer] range");
         }
         return (int) x;
     }
 
     public static long safeToLong(double x) {
         if (x > Long.MAX_VALUE || x < Long.MIN_VALUE) {
-            throw new SqlIllegalArgumentException("[" + x + "] out of [long] range");
+            throw new QlIllegalArgumentException("[" + x + "] out of [long] range");
         }
         return Math.round(x);
     }
@@ -513,7 +512,7 @@ public static Number toInteger(double x, DataType dataType) {
     public static boolean convertToBoolean(String val) {
         String lowVal = val.toLowerCase(Locale.ROOT);
         if (Booleans.isBoolean(lowVal) == false) {
-            throw new SqlIllegalArgumentException("cannot cast [" + val + "] to [boolean]");
+            throw new QlIllegalArgumentException("cannot cast [" + val + "] to [boolean]");
         }
         return Booleans.parseBoolean(lowVal);
     }
@@ -521,7 +520,7 @@ public static boolean convertToBoolean(String val) {
     /**
      * Converts arbitrary object to the desired data type.
      * <p>
-     * Throws SqlIllegalArgumentException if such conversion is not possible
+     * Throws QlIllegalArgumentException if such conversion is not possible
      */
     public static Object convert(Object value, DataType dataType) {
         DataType detectedType = DataTypes.fromJava(value);
@@ -621,7 +620,7 @@ public enum Conversion {
 
         STRING_TO_IP(o -> {
             if (!InetAddresses.isInetAddress(o.toString())) {
-                throw new SqlIllegalArgumentException( "[" + o + "] is not a valid IPv4 or IPv6 address");
+                throw new QlIllegalArgumentException("[" + o + "] is not a valid IPv4 or IPv6 address");
             }
             return o;
         });
@@ -645,9 +644,9 @@ private static Function<Object, Object> fromString(Function<String, Object> conv
                 try {
                     return converter.apply(value.toString());
                 } catch (NumberFormatException e) {
-                    throw new SqlIllegalArgumentException(e, "cannot cast [{}] to [{}]", value, to);
+                    throw new QlIllegalArgumentException(e, "cannot cast [{}] to [{}]", value, to);
                 } catch (DateTimeParseException | IllegalArgumentException e) {
-                    throw new SqlIllegalArgumentException(e, "cannot cast [{}] to [{}]: {}", value, to, e.getMessage());
+                    throw new QlIllegalArgumentException(e, "cannot cast [{}] to [{}]: {}", value, to, e.getMessage());
                 }
             };
         }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypes.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypes.java
similarity index 83%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypes.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypes.java
index 1faf19e1d0996..24bb42ef54b77 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DataTypes.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypes.java
@@ -3,29 +3,29 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
-import org.elasticsearch.xpack.sql.expression.literal.Interval;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.literal.Interval;
 
 import java.time.OffsetTime;
 import java.time.ZonedDateTime;
 
-import static org.elasticsearch.xpack.sql.type.DataType.BOOLEAN;
-import static org.elasticsearch.xpack.sql.type.DataType.BYTE;
-import static org.elasticsearch.xpack.sql.type.DataType.DATETIME;
-import static org.elasticsearch.xpack.sql.type.DataType.DOUBLE;
-import static org.elasticsearch.xpack.sql.type.DataType.FLOAT;
-import static org.elasticsearch.xpack.sql.type.DataType.INTEGER;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR_TO_MONTH;
-import static org.elasticsearch.xpack.sql.type.DataType.KEYWORD;
-import static org.elasticsearch.xpack.sql.type.DataType.LONG;
-import static org.elasticsearch.xpack.sql.type.DataType.NULL;
-import static org.elasticsearch.xpack.sql.type.DataType.SHORT;
-import static org.elasticsearch.xpack.sql.type.DataType.TIME;
-import static org.elasticsearch.xpack.sql.type.DataType.UNSUPPORTED;
-import static org.elasticsearch.xpack.sql.type.DataType.fromTypeName;
+import static org.elasticsearch.xpack.ql.type.DataType.BOOLEAN;
+import static org.elasticsearch.xpack.ql.type.DataType.BYTE;
+import static org.elasticsearch.xpack.ql.type.DataType.DATETIME;
+import static org.elasticsearch.xpack.ql.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.ql.type.DataType.FLOAT;
+import static org.elasticsearch.xpack.ql.type.DataType.INTEGER;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR_TO_MONTH;
+import static org.elasticsearch.xpack.ql.type.DataType.KEYWORD;
+import static org.elasticsearch.xpack.ql.type.DataType.LONG;
+import static org.elasticsearch.xpack.ql.type.DataType.NULL;
+import static org.elasticsearch.xpack.ql.type.DataType.SHORT;
+import static org.elasticsearch.xpack.ql.type.DataType.TIME;
+import static org.elasticsearch.xpack.ql.type.DataType.UNSUPPORTED;
+import static org.elasticsearch.xpack.ql.type.DataType.fromTypeName;
 
 public final class DataTypes {
 
@@ -75,7 +75,8 @@ public static DataType fromJava(Object value) {
         if (value instanceof GeoShape) {
             return DataType.GEO_SHAPE;
         }
-        throw new SqlIllegalArgumentException("No idea what's the DataType for {}", value.getClass());
+
+        throw new QlIllegalArgumentException("No idea what's the DataType for {}", value.getClass());
     }
 
     // return the compatible interval between the two - it is assumed the types are intervals
@@ -130,7 +131,7 @@ private static String intervalUnit(char unitChar) {
             case 'S':
                 return "SECOND";
             default:
-                throw new SqlIllegalArgumentException("Unknown unit {}", unitChar);
+                throw new QlIllegalArgumentException("Unknown unit {}", unitChar);
         }
     }
 
@@ -148,7 +149,7 @@ public static Integer metaSqlDataType(DataType t) {
             return Integer.valueOf(9);
         }
         // this is safe since the vendor SQL types are short despite the return value
-        return t.sqlType.getVendorTypeNumber();
+        return t.sqlType().getVendorTypeNumber();
     }
 
     // https://github.com/elastic/elasticsearch/issues/30386
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DateEsField.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DateEsField.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DateEsField.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DateEsField.java
index fc2d10448c152..5186a2c2b5494 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/DateEsField.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DateEsField.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import java.util.Map;
 
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DateUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DateUtils.java
new file mode 100644
index 0000000000000..7e10560aa0330
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DateUtils.java
@@ -0,0 +1,91 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.type;
+
+import org.elasticsearch.common.time.DateFormatter;
+import org.elasticsearch.common.time.DateFormatters;
+
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.OffsetTime;
+import java.time.ZoneId;
+import java.time.ZonedDateTime;
+
+import static java.time.format.DateTimeFormatter.ISO_LOCAL_DATE;
+import static java.time.format.DateTimeFormatter.ISO_TIME;
+
+//FIXME: Taken from sql-proto.
+//Ideally it should be shared but the dependencies across projects and and SQL-client make it tricky.
+//Maybe a gradle task would fix that...
+public final class DateUtils {
+
+    public static final ZoneId UTC = ZoneId.of("Z");
+    // In Java 8 LocalDate.EPOCH is not available, introduced with later Java versions
+    public static final LocalDate EPOCH = LocalDate.of(1970, 1, 1);
+    public static final long DAY_IN_MILLIS = 60 * 60 * 24 * 1000L;
+
+    private static final DateFormatter UTC_DATE_TIME_FORMATTER = DateFormatter.forPattern("date_optional_time").withZone(UTC);
+
+    static final String DATE_PARSE_FORMAT = "epoch_millis";
+
+    private DateUtils() {}
+
+    /**
+     * Creates an date for SQL DATE type from the millis since epoch.
+     */
+    public static ZonedDateTime asDateOnly(long millis) {
+        return ZonedDateTime.ofInstant(Instant.ofEpochMilli(millis), UTC).toLocalDate().atStartOfDay(UTC);
+    }
+
+    /**
+     * Creates an date for SQL TIME type from the millis since epoch.
+     */
+    public static OffsetTime asTimeOnly(long millis) {
+        return OffsetTime.ofInstant(Instant.ofEpochMilli(millis % DAY_IN_MILLIS), UTC);
+    }
+
+    /**
+     * Creates a datetime from the millis since epoch (thus the time-zone is UTC).
+     */
+    public static ZonedDateTime asDateTime(long millis) {
+        return ZonedDateTime.ofInstant(Instant.ofEpochMilli(millis), UTC);
+    }
+
+    /**
+     * Parses the given string into a Date (SQL DATE type) using UTC as a default timezone.
+     */
+    public static ZonedDateTime asDateOnly(String dateFormat) {
+        return LocalDate.parse(dateFormat, ISO_LOCAL_DATE).atStartOfDay(UTC);
+    }
+
+    public static ZonedDateTime asDateOnly(ZonedDateTime zdt) {
+        return zdt.toLocalDate().atStartOfDay(zdt.getZone());
+    }
+
+    public static OffsetTime asTimeOnly(String timeFormat) {
+        return DateFormatters.from(ISO_TIME.parse(timeFormat)).toOffsetDateTime().toOffsetTime();
+    }
+
+    /**
+     * Parses the given string into a DateTime using UTC as a default timezone.
+     */
+    public static ZonedDateTime asDateTime(String dateFormat) {
+        return DateFormatters.from(UTC_DATE_TIME_FORMATTER.parse(dateFormat)).withZoneSameInstant(UTC);
+    }
+
+    public static String toString(ZonedDateTime dateTime) {
+        return StringUtils.toString(dateTime);
+    }
+
+    public static String toDateString(ZonedDateTime date) {
+        return date.format(ISO_LOCAL_DATE);
+    }
+
+    public static String toTimeString(OffsetTime time) {
+        return StringUtils.toString(time);
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/EsField.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/EsField.java
similarity index 99%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/EsField.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/EsField.java
index b54510e48642d..694c7c1c1b1cf 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/EsField.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/EsField.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import org.elasticsearch.common.Nullable;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/ExtTypes.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/ExtTypes.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/ExtTypes.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/ExtTypes.java
index 2c07be3eb620d..85dec87145666 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/ExtTypes.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/ExtTypes.java
@@ -4,7 +4,7 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import java.sql.JDBCType;
 import java.sql.SQLType;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/InvalidMappedField.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/InvalidMappedField.java
similarity index 86%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/InvalidMappedField.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/InvalidMappedField.java
index 79f8eb1c20c1f..796fe4a37ef71 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/InvalidMappedField.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/InvalidMappedField.java
@@ -4,9 +4,9 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 
 import java.util.Objects;
 
@@ -46,7 +46,7 @@ public boolean equals(Object obj) {
 
     @Override
     public EsField getExactField() {
-        throw new SqlIllegalArgumentException("Field [" + getName() + "] is invalid, cannot access it");
+        throw new QlIllegalArgumentException("Field [" + getName() + "] is invalid, cannot access it");
 
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/KeywordEsField.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/KeywordEsField.java
similarity index 97%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/KeywordEsField.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/KeywordEsField.java
index f44c5de0adb0e..1ac4f26077770 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/KeywordEsField.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/KeywordEsField.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import java.util.Collections;
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/Schema.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Schema.java
similarity index 91%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/Schema.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Schema.java
index 6faf2e5b224f4..9f77fe088274e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/Schema.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Schema.java
@@ -3,10 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
-import org.elasticsearch.xpack.sql.type.Schema.Entry;
-import org.elasticsearch.xpack.sql.util.Check;
+import org.elasticsearch.xpack.ql.util.Check;
 
 import java.util.Iterator;
 import java.util.List;
@@ -18,7 +17,7 @@
 
 import static java.util.Collections.emptyList;
 
-public class Schema implements Iterable<Entry> {
+public class Schema implements Iterable<Schema.Entry> {
 
     public interface Entry {
         String name();
@@ -82,7 +81,7 @@ public DataType type(String name) {
 
     @Override
     public Iterator<Entry> iterator() {
-        return new Iterator<Entry>() {
+        return new Iterator<>() {
             private final int size = size();
             private int pos = -1;
             
@@ -120,7 +119,7 @@ public String toString() {
             }
             sb.append(names.get(i));
             sb.append(":");
-            sb.append(types.get(i).typeName);
+            sb.append(types.get(i).typeName());
         }
         sb.append("]");
         return sb.toString();
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/StringUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/StringUtils.java
new file mode 100644
index 0000000000000..c92026ed5b35d
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/StringUtils.java
@@ -0,0 +1,145 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.type;
+
+import java.sql.Timestamp;
+import java.time.Duration;
+import java.time.OffsetTime;
+import java.time.Period;
+import java.time.ZonedDateTime;
+import java.time.format.DateTimeFormatter;
+import java.time.format.DateTimeFormatterBuilder;
+import java.util.Locale;
+import java.util.Objects;
+import java.util.concurrent.TimeUnit;
+
+import static java.time.format.DateTimeFormatter.ISO_LOCAL_DATE;
+import static java.time.temporal.ChronoField.HOUR_OF_DAY;
+import static java.time.temporal.ChronoField.MILLI_OF_SECOND;
+import static java.time.temporal.ChronoField.MINUTE_OF_HOUR;
+import static java.time.temporal.ChronoField.NANO_OF_SECOND;
+import static java.time.temporal.ChronoField.SECOND_OF_MINUTE;
+
+//FIXME: this class comes from sql-proto
+// find a way to share it across or potentially just copy it over
+final class StringUtils {
+
+    public static final String EMPTY = "";
+    
+    public static final DateTimeFormatter ISO_DATE_WITH_MILLIS = new DateTimeFormatterBuilder()
+            .parseCaseInsensitive()
+            .append(ISO_LOCAL_DATE)
+            .appendLiteral('T')
+            .appendValue(HOUR_OF_DAY, 2)
+            .appendLiteral(':')
+            .appendValue(MINUTE_OF_HOUR, 2)
+            .appendLiteral(':')
+            .appendValue(SECOND_OF_MINUTE, 2)
+            .appendFraction(MILLI_OF_SECOND, 3, 3, true)
+            .appendOffsetId()
+            .toFormatter(Locale.ROOT);
+
+    public static final DateTimeFormatter ISO_DATE_WITH_NANOS = new DateTimeFormatterBuilder()
+            .parseCaseInsensitive()
+            .append(ISO_LOCAL_DATE)
+            .appendLiteral('T')
+            .appendValue(HOUR_OF_DAY, 2)
+            .appendLiteral(':')
+            .appendValue(MINUTE_OF_HOUR, 2)
+            .appendLiteral(':')
+            .appendValue(SECOND_OF_MINUTE, 2)
+            .appendFraction(NANO_OF_SECOND, 3, 9, true)
+            .appendOffsetId()
+            .toFormatter(Locale.ROOT);
+
+    public static final DateTimeFormatter ISO_TIME_WITH_MILLIS = new DateTimeFormatterBuilder()
+            .parseCaseInsensitive()
+            .appendValue(HOUR_OF_DAY, 2)
+            .appendLiteral(':')
+            .appendValue(MINUTE_OF_HOUR, 2)
+            .appendLiteral(':')
+            .appendValue(SECOND_OF_MINUTE, 2)
+            .appendFraction(MILLI_OF_SECOND, 3, 3, true)
+            .appendOffsetId()
+            .toFormatter(Locale.ROOT);
+
+    private static final int SECONDS_PER_MINUTE = 60;
+    private static final int SECONDS_PER_HOUR = SECONDS_PER_MINUTE * 60;
+    private static final int SECONDS_PER_DAY = SECONDS_PER_HOUR * 24;
+
+    private StringUtils() {}
+
+    public static String toString(Object value) {
+        if (value == null) {
+            return "null";
+        }
+        
+        if (value instanceof ZonedDateTime) {
+            return ((ZonedDateTime) value).format(ISO_DATE_WITH_MILLIS);
+        }
+        if (value instanceof OffsetTime) {
+            return ((OffsetTime) value).format(ISO_TIME_WITH_MILLIS);
+        }
+        if (value instanceof Timestamp) {
+            Timestamp ts = (Timestamp) value;
+            return ts.toInstant().toString();
+        }
+
+        // handle intervals
+        // YEAR/MONTH/YEAR TO MONTH -> YEAR TO MONTH
+        if (value instanceof Period) {
+            // +yyy-mm - 7 chars
+            StringBuilder sb = new StringBuilder(7);
+            Period p = (Period) value;
+            if (p.isNegative()) {
+                sb.append("-");
+                p = p.negated();
+            } else {
+                sb.append("+");
+            }
+            sb.append(p.getYears());
+            sb.append("-");
+            sb.append(p.getMonths());
+            return sb.toString();
+        }
+
+        // DAY/HOUR/MINUTE/SECOND (and variations) -> DAY_TO_SECOND
+        if (value instanceof Duration) {
+            // +ddd hh:mm:ss.mmmmmmmmm - 23 chars
+            StringBuilder sb = new StringBuilder(23);
+            Duration d = (Duration) value;
+            if (d.isNegative()) {
+                sb.append("-");
+                d = d.negated();
+            } else {
+                sb.append("+");
+            }
+
+            long durationInSec = d.getSeconds();
+
+            sb.append(durationInSec / SECONDS_PER_DAY);
+            sb.append(" ");
+            durationInSec = durationInSec % SECONDS_PER_DAY;
+            sb.append(indent(durationInSec / SECONDS_PER_HOUR));
+            sb.append(":");
+            durationInSec = durationInSec % SECONDS_PER_HOUR;
+            sb.append(indent(durationInSec / SECONDS_PER_MINUTE));
+            sb.append(":");
+            durationInSec = durationInSec % SECONDS_PER_MINUTE;
+            sb.append(indent(durationInSec));
+            sb.append(".");
+            sb.append(TimeUnit.NANOSECONDS.toMillis(d.getNano()));
+            return sb.toString();
+        }
+
+        return Objects.toString(value);
+    }
+
+    private static String indent(long timeUnit) {
+        return timeUnit < 10 ? "0" + timeUnit : Long.toString(timeUnit);
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/TextEsField.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/TextEsField.java
similarity index 92%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/TextEsField.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/TextEsField.java
index f74757137e3c2..d203430f09be0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/TextEsField.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/TextEsField.java
@@ -3,10 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import org.elasticsearch.common.collect.Tuple;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 
 import java.util.Map;
 import java.util.function.Function;
@@ -28,7 +28,7 @@ public TextEsField(String name, Map<String, EsField> properties, boolean hasDocV
     public EsField getExactField() {
         Tuple<EsField, String> findExact = findExact();
         if (findExact.v1() == null) {
-            throw new SqlIllegalArgumentException(findExact.v2());
+            throw new QlIllegalArgumentException(findExact.v2());
         }
         return findExact.v1();
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/Types.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Types.java
similarity index 99%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/Types.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Types.java
index 317d3ccb9176d..957f5deed19e6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/Types.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Types.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import org.elasticsearch.common.Booleans;
 import org.elasticsearch.common.Strings;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/UnsupportedEsField.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/UnsupportedEsField.java
similarity index 96%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/UnsupportedEsField.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/UnsupportedEsField.java
index 2909c5f199053..b41f9458864c2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/type/UnsupportedEsField.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/UnsupportedEsField.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import java.util.Collections;
 import java.util.Objects;
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Check.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Check.java
new file mode 100644
index 0000000000000..ae50379a47aca
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Check.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ql.util;
+
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+
+/**
+ * Utility class used for checking various conditions at runtime, with minimum amount of code.
+ */
+public abstract class Check {
+
+    public static void isTrue(boolean expression, String message, Object... values) {
+        if (!expression) {
+            throw new QlIllegalArgumentException(message, values);
+        }
+    }
+
+    public static void isTrue(boolean expression, String message) {
+        if (!expression) {
+            throw new QlIllegalArgumentException(message);
+        }
+    }
+
+    public static void notNull(Object object, String message) {
+        if (object == null) {
+            throw new QlIllegalArgumentException(message);
+        }
+    }
+
+    public static void notNull(Object object, String message, Object... values) {
+        if (object == null) {
+            throw new QlIllegalArgumentException(message, values);
+        }
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/CollectionUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/CollectionUtils.java
similarity index 98%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/CollectionUtils.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/CollectionUtils.java
index 24ed7b979f63c..9d140eb550dae 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/CollectionUtils.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/CollectionUtils.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.util;
+package org.elasticsearch.xpack.ql.util;
 
 import java.util.ArrayList;
 import java.util.Collection;
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/DateUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/DateUtils.java
new file mode 100644
index 0000000000000..934c6c8ca9208
--- /dev/null
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/DateUtils.java
@@ -0,0 +1,150 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.util;
+
+import java.sql.Timestamp;
+import java.time.Duration;
+import java.time.OffsetTime;
+import java.time.Period;
+import java.time.ZoneId;
+import java.time.ZonedDateTime;
+import java.time.format.DateTimeFormatter;
+import java.time.format.DateTimeFormatterBuilder;
+import java.util.Locale;
+import java.util.Objects;
+import java.util.concurrent.TimeUnit;
+
+import static java.time.format.DateTimeFormatter.ISO_LOCAL_DATE;
+import static java.time.temporal.ChronoField.HOUR_OF_DAY;
+import static java.time.temporal.ChronoField.MILLI_OF_SECOND;
+import static java.time.temporal.ChronoField.MINUTE_OF_HOUR;
+import static java.time.temporal.ChronoField.NANO_OF_SECOND;
+import static java.time.temporal.ChronoField.SECOND_OF_MINUTE;
+
+
+//FIXME: Taken from sql-proto. 
+//Ideally it should be shared but the dependencies across projects and and SQL-client make it tricky.
+// Maybe a gradle task would fix that...
+public class DateUtils {
+
+    public static final ZoneId UTC = ZoneId.of("Z");
+
+    public static final String EMPTY = "";
+    
+    public static final DateTimeFormatter ISO_DATE_WITH_MILLIS = new DateTimeFormatterBuilder()
+            .parseCaseInsensitive()
+            .append(ISO_LOCAL_DATE)
+            .appendLiteral('T')
+            .appendValue(HOUR_OF_DAY, 2)
+            .appendLiteral(':')
+            .appendValue(MINUTE_OF_HOUR, 2)
+            .appendLiteral(':')
+            .appendValue(SECOND_OF_MINUTE, 2)
+            .appendFraction(MILLI_OF_SECOND, 3, 3, true)
+            .appendOffsetId()
+            .toFormatter(Locale.ROOT);
+
+    public static final DateTimeFormatter ISO_DATE_WITH_NANOS = new DateTimeFormatterBuilder()
+            .parseCaseInsensitive()
+            .append(ISO_LOCAL_DATE)
+            .appendLiteral('T')
+            .appendValue(HOUR_OF_DAY, 2)
+            .appendLiteral(':')
+            .appendValue(MINUTE_OF_HOUR, 2)
+            .appendLiteral(':')
+            .appendValue(SECOND_OF_MINUTE, 2)
+            .appendFraction(NANO_OF_SECOND, 3, 9, true)
+            .appendOffsetId()
+            .toFormatter(Locale.ROOT);
+
+    public static final DateTimeFormatter ISO_TIME_WITH_MILLIS = new DateTimeFormatterBuilder()
+            .parseCaseInsensitive()
+            .appendValue(HOUR_OF_DAY, 2)
+            .appendLiteral(':')
+            .appendValue(MINUTE_OF_HOUR, 2)
+            .appendLiteral(':')
+            .appendValue(SECOND_OF_MINUTE, 2)
+            .appendFraction(MILLI_OF_SECOND, 3, 3, true)
+            .appendOffsetId()
+            .toFormatter(Locale.ROOT);
+
+    private static final int SECONDS_PER_MINUTE = 60;
+    private static final int SECONDS_PER_HOUR = SECONDS_PER_MINUTE * 60;
+    private static final int SECONDS_PER_DAY = SECONDS_PER_HOUR * 24;
+
+    private DateUtils() {}
+
+    public static String toString(Object value) {
+        if (value == null) {
+            return "null";
+        }
+        
+        if (value instanceof ZonedDateTime) {
+            return ((ZonedDateTime) value).format(ISO_DATE_WITH_MILLIS);
+        }
+        if (value instanceof OffsetTime) {
+            return ((OffsetTime) value).format(ISO_TIME_WITH_MILLIS);
+        }
+        if (value instanceof Timestamp) {
+            Timestamp ts = (Timestamp) value;
+            return ts.toInstant().toString();
+        }
+
+        // handle intervals
+        // YEAR/MONTH/YEAR TO MONTH -> YEAR TO MONTH
+        if (value instanceof Period) {
+            // +yyy-mm - 7 chars
+            StringBuilder sb = new StringBuilder(7);
+            Period p = (Period) value;
+            if (p.isNegative()) {
+                sb.append("-");
+                p = p.negated();
+            } else {
+                sb.append("+");
+            }
+            sb.append(p.getYears());
+            sb.append("-");
+            sb.append(p.getMonths());
+            return sb.toString();
+        }
+
+        // DAY/HOUR/MINUTE/SECOND (and variations) -> DAY_TO_SECOND
+        if (value instanceof Duration) {
+            // +ddd hh:mm:ss.mmmmmmmmm - 23 chars
+            StringBuilder sb = new StringBuilder(23);
+            Duration d = (Duration) value;
+            if (d.isNegative()) {
+                sb.append("-");
+                d = d.negated();
+            } else {
+                sb.append("+");
+            }
+
+            long durationInSec = d.getSeconds();
+
+            sb.append(durationInSec / SECONDS_PER_DAY);
+            sb.append(" ");
+            durationInSec = durationInSec % SECONDS_PER_DAY;
+            sb.append(indent(durationInSec / SECONDS_PER_HOUR));
+            sb.append(":");
+            durationInSec = durationInSec % SECONDS_PER_HOUR;
+            sb.append(indent(durationInSec / SECONDS_PER_MINUTE));
+            sb.append(":");
+            durationInSec = durationInSec % SECONDS_PER_MINUTE;
+            sb.append(indent(durationInSec));
+            sb.append(".");
+            sb.append(TimeUnit.NANOSECONDS.toMillis(d.getNano()));
+            return sb.toString();
+        }
+
+        return Objects.toString(value);
+    }
+
+    private static String indent(long timeUnit) {
+        return timeUnit < 10 ? "0" + timeUnit : Long.toString(timeUnit);
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/Graphviz.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Graphviz.java
similarity index 99%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/Graphviz.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Graphviz.java
index ad6a97f5862c9..96e2c0767b6cd 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/Graphviz.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Graphviz.java
@@ -3,7 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.util;
+package org.elasticsearch.xpack.ql.util;
+
+import org.elasticsearch.xpack.ql.tree.Node;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -12,8 +14,6 @@
 import java.util.Map.Entry;
 import java.util.concurrent.atomic.AtomicInteger;
 
-import org.elasticsearch.xpack.sql.tree.Node;
-
 // use the awesome http://mdaines.github.io/viz.js/ to visualize and play around with the various options
 public abstract class Graphviz {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/Holder.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Holder.java
similarity index 93%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/Holder.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Holder.java
index 85f34f4e1ea63..121b05dfe07d2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/Holder.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/Holder.java
@@ -4,7 +4,7 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.util;
+package org.elasticsearch.xpack.ql.util;
 
 /**
  * Simply utility class used for setting a state, typically
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/ReflectionUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/ReflectionUtils.java
similarity index 81%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/ReflectionUtils.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/ReflectionUtils.java
index 13a859d516105..1b79d6836b03d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/ReflectionUtils.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/ReflectionUtils.java
@@ -3,9 +3,9 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.util;
+package org.elasticsearch.xpack.ql.util;
 
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 
 import java.lang.reflect.ParameterizedType;
 import java.lang.reflect.Type;
@@ -20,7 +20,7 @@ public static <E> Class<E> detectSuperTypeForRuleLike(Class<?> c) {
             if (type instanceof ParameterizedType) {
                 Type[] typeArguments = ((ParameterizedType) type).getActualTypeArguments();
                 if (typeArguments.length != 2 && typeArguments.length != 1) {
-                    throw new SqlIllegalArgumentException("Unexpected number of type arguments {} for {}", Arrays.toString(typeArguments),
+                    throw new QlIllegalArgumentException("Unexpected number of type arguments {} for {}", Arrays.toString(typeArguments),
                             c);
                 }
 
@@ -34,11 +34,11 @@ public static <E> Class<E> detectSuperTypeForRuleLike(Class<?> c) {
                         return (Class<E>) rawType;
                     }
                 }
-                throw new SqlIllegalArgumentException("Unexpected class structure for class {}", c);
+                throw new QlIllegalArgumentException("Unexpected class structure for class {}", c);
             }
             clazz = clazz.getSuperclass();
         }
-        throw new SqlIllegalArgumentException("Unexpected class structure for class {}", c);
+        throw new QlIllegalArgumentException("Unexpected class structure for class {}", c);
     }
     
     // remove packaging from the name - strategy used for naming rules by default
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/StringUtils.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/StringUtils.java
similarity index 89%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/StringUtils.java
rename to x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/StringUtils.java
index adfd3996e9fb2..9dd3debccf7a8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/StringUtils.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/util/StringUtils.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.util;
+package org.elasticsearch.xpack.ql.util;
 
 import org.apache.lucene.search.spell.LevenshteinDistance;
 import org.apache.lucene.util.CollectionUtil;
@@ -13,7 +13,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 
 import java.io.IOException;
 import java.math.BigInteger;
@@ -104,7 +104,7 @@ public static String likeToJavaPattern(String pattern, char escape) {
             if (!escaped && (curr == escape) && escape != 0) {
                 escaped = true;
                 if (i + 1 == pattern.length()) {
-                    throw new SqlIllegalArgumentException(
+                    throw new QlIllegalArgumentException(
                             "Invalid sequence - escape character is not followed by special wildcard char");
                 }
             }
@@ -118,7 +118,7 @@ public static String likeToJavaPattern(String pattern, char escape) {
                         break;
                     default:
                         if (escaped) {
-                            throw new SqlIllegalArgumentException(
+                            throw new QlIllegalArgumentException(
                                     "Invalid sequence - escape character is not followed by special wildcard char");
                         }
                         // escape special regex characters
@@ -168,7 +168,7 @@ public static String likeToLuceneWildcard(String pattern, char escape) {
 
             if (!escaped && (curr == escape) && escape != 0) {
                 if (i + 1 == pattern.length()) {
-                    throw new SqlIllegalArgumentException("Invalid sequence - escape character is not followed by special wildcard char");
+                    throw new QlIllegalArgumentException("Invalid sequence - escape character is not followed by special wildcard char");
                 }
                 escaped = true;
             } else {
@@ -181,7 +181,7 @@ public static String likeToLuceneWildcard(String pattern, char escape) {
                         break;
                     default:
                         if (escaped) {
-                            throw new SqlIllegalArgumentException(
+                            throw new QlIllegalArgumentException(
                                     "Invalid sequence - escape character is not followed by special wildcard char");
                         }
                         // escape special regex characters
@@ -214,7 +214,7 @@ public static String likeToIndexWildcard(String pattern, char escape) {
 
             if (!escaped && (curr == escape) && escape != 0) {
                 if (i + 1 == pattern.length()) {
-                    throw new SqlIllegalArgumentException("Invalid sequence - escape character is not followed by special wildcard char");
+                    throw new QlIllegalArgumentException("Invalid sequence - escape character is not followed by special wildcard char");
                 }
                 escaped = true;
             } else {
@@ -227,7 +227,7 @@ public static String likeToIndexWildcard(String pattern, char escape) {
                         break;
                     default:
                         if (escaped) {
-                            throw new SqlIllegalArgumentException(
+                            throw new QlIllegalArgumentException(
                                     "Invalid sequence - escape character is not followed by special wildcard char");
                         }
                         // the resolver doesn't support escaping...
@@ -291,24 +291,24 @@ public static List<String> findSimilar(String match, Iterable<String> potentialM
                 .collect(toList());
     }
 
-    public static double parseDouble(String string) throws SqlIllegalArgumentException {
+    public static double parseDouble(String string) throws QlIllegalArgumentException {
         double value;
         try {
             value = Double.parseDouble(string);
         } catch (NumberFormatException nfe) {
-            throw new SqlIllegalArgumentException("Cannot parse number [{}]", string);
+            throw new QlIllegalArgumentException("Cannot parse number [{}]", string);
         }
 
         if (Double.isInfinite(value)) {
-            throw new SqlIllegalArgumentException("Number [{}] is too large", string);
+            throw new QlIllegalArgumentException("Number [{}] is too large", string);
         }
         if (Double.isNaN(value)) {
-            throw new SqlIllegalArgumentException("[{}] cannot be parsed as a number (NaN)", string);
+            throw new QlIllegalArgumentException("[{}] cannot be parsed as a number (NaN)", string);
         }
         return value;
     }
 
-    public static long parseLong(String string) throws SqlIllegalArgumentException {
+    public static long parseLong(String string) throws QlIllegalArgumentException {
         try {
             return Long.parseLong(string);
         } catch (NumberFormatException nfe) {
@@ -317,12 +317,12 @@ public static long parseLong(String string) throws SqlIllegalArgumentException {
                 try {
                     bi.longValueExact();
                 } catch (ArithmeticException ae) {
-                    throw new SqlIllegalArgumentException("Number [{}] is too large", string);
+                    throw new QlIllegalArgumentException("Number [{}] is too large", string);
                 }
             } catch (NumberFormatException ex) {
                 // parsing fails, go through
             }
-            throw new SqlIllegalArgumentException("Cannot parse number [{}]", string);
+            throw new QlIllegalArgumentException("Cannot parse number [{}]", string);
         }
     }
 
diff --git a/x-pack/plugin/ql/src/main/resources/file.txt b/x-pack/plugin/ql/src/main/resources/file.txt
new file mode 100644
index 0000000000000..e69de29bb2d1d
diff --git a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/TestUtils.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/TestUtils.java
new file mode 100644
index 0000000000000..3cf1d920514fb
--- /dev/null
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/TestUtils.java
@@ -0,0 +1,35 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql;
+
+import org.elasticsearch.xpack.ql.session.Configuration;
+
+import java.time.ZoneId;
+
+import static org.elasticsearch.test.ESTestCase.randomAlphaOfLength;
+import static org.elasticsearch.test.ESTestCase.randomZone;
+
+public final class TestUtils {
+
+    public static final ZoneId UTC = ZoneId.of("Z");
+
+    public static final Configuration TEST_CFG = new Configuration(UTC, null, null);
+
+    private TestUtils() {}
+
+    public static Configuration randomConfiguration() {
+        return new Configuration(randomZone(),
+                randomAlphaOfLength(10),
+                randomAlphaOfLength(10));
+    }
+
+    public static Configuration randomConfiguration(ZoneId zoneId) {
+        return new Configuration(zoneId,
+                randomAlphaOfLength(10),
+                randomAlphaOfLength(10));
+    }
+}
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/ConstantExtractorTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/execution/search/extractor/ConstantExtractorTests.java
similarity index 96%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/ConstantExtractorTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/execution/search/extractor/ConstantExtractorTests.java
index 7c1e5258b7655..78dcc0be4a3b8 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/ConstantExtractorTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/execution/search/extractor/ConstantExtractorTests.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.execution.search.extractor;
+package org.elasticsearch.xpack.ql.execution.search.extractor;
 
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.search.SearchHit;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/AttributeMapTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/AttributeMapTests.java
similarity index 98%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/AttributeMapTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/AttributeMapTests.java
index ee977687d902d..f9cb180a2224d 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/AttributeMapTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/AttributeMapTests.java
@@ -3,10 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Collection;
 import java.util.LinkedHashMap;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ExpressionIdTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/ExpressionIdTests.java
similarity index 93%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ExpressionIdTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/ExpressionIdTests.java
index dfbe34104342b..2d9c96057e969 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ExpressionIdTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/ExpressionIdTests.java
@@ -3,9 +3,10 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import org.elasticsearch.test.ESTestCase;
+
 import java.util.concurrent.atomic.AtomicLong;
 
 public class ExpressionIdTests extends ESTestCase {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/LiteralTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/LiteralTests.java
similarity index 93%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/LiteralTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/LiteralTests.java
index cd5e736c47c40..01e0a2ba5f4f0 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/LiteralTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/LiteralTests.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -120,7 +120,7 @@ private List<DataType> validReplacementDataTypes(Object value, DataType type) {
                 DataTypeConversion.Conversion c = DataTypeConversion.conversionFor(type, candidate);
                 c.convert(value);
                 validDataTypes.add(candidate);
-            } catch (SqlIllegalArgumentException e) {
+            } catch (QlIllegalArgumentException e) {
                 // invalid conversion then....
             }
         }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/NullabilityTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/NullabilityTests.java
similarity index 81%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/NullabilityTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/NullabilityTests.java
index 1b493de6b4c1b..28f52faa48c94 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/NullabilityTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/NullabilityTests.java
@@ -3,13 +3,13 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import org.elasticsearch.test.ESTestCase;
 
-import static org.elasticsearch.xpack.sql.expression.Nullability.FALSE;
-import static org.elasticsearch.xpack.sql.expression.Nullability.TRUE;
-import static org.elasticsearch.xpack.sql.expression.Nullability.UNKNOWN;
+import static org.elasticsearch.xpack.ql.expression.Nullability.FALSE;
+import static org.elasticsearch.xpack.ql.expression.Nullability.TRUE;
+import static org.elasticsearch.xpack.ql.expression.Nullability.UNKNOWN;
 
 public class NullabilityTests extends ESTestCase {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/TyperResolutionTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/TyperResolutionTests.java
similarity index 77%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/TyperResolutionTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/TyperResolutionTests.java
index 1340332505444..c8efccbae2b6b 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/TyperResolutionTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/TyperResolutionTests.java
@@ -4,17 +4,17 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression.TypeResolution;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mul;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression.TypeResolution;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalYearMonth;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mul;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.Period;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class TyperResolutionTests extends ESTestCase {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttributeTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/UnresolvedAttributeTests.java
similarity index 95%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttributeTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/UnresolvedAttributeTests.java
index a40e7661dc03d..515e40e953db6 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/UnresolvedAttributeTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/UnresolvedAttributeTests.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.ql.expression;
 
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
 
 import java.util.Arrays;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/FunctionRegistryTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/FunctionRegistryTests.java
similarity index 87%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/FunctionRegistryTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/FunctionRegistryTests.java
index 56767d7e3195e..b3d82995cb7b9 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/FunctionRegistryTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/FunctionRegistryTests.java
@@ -3,31 +3,31 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function;
+package org.elasticsearch.xpack.ql.expression.function;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.parser.ParsingException;
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.ParsingException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.ZoneId;
 import java.util.Arrays;
 import java.util.List;
 
 import static java.util.Collections.emptyList;
-import static org.elasticsearch.xpack.sql.TestUtils.randomConfiguration;
-import static org.elasticsearch.xpack.sql.expression.function.FunctionRegistry.def;
-import static org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction.ResolutionType.DISTINCT;
-import static org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction.ResolutionType.EXTRACT;
-import static org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction.ResolutionType.STANDARD;
+import static org.elasticsearch.xpack.ql.TestUtils.randomConfiguration;
+import static org.elasticsearch.xpack.ql.expression.function.FunctionRegistry.def;
+import static org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction.ResolutionType.DISTINCT;
+import static org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction.ResolutionType.EXTRACT;
+import static org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction.ResolutionType.STANDARD;
 import static org.hamcrest.Matchers.endsWith;
 import static org.hamcrest.Matchers.is;
 import static org.mockito.Mockito.mock;
@@ -165,13 +165,13 @@ public void testBinaryFunction() {
     
     public void testAliasNameIsTheSameAsAFunctionName() {
         FunctionRegistry r = new FunctionRegistry(def(DummyFunction.class, DummyFunction::new, "DUMMY_FUNCTION", "ALIAS"));
-        SqlIllegalArgumentException iae = expectThrows(SqlIllegalArgumentException.class, () ->
-                r.addToMap(def(DummyFunction2.class, DummyFunction2::new, "DUMMY_FUNCTION2", "DUMMY_FUNCTION")));
+        QlIllegalArgumentException iae = expectThrows(QlIllegalArgumentException.class, () ->
+                r.register(def(DummyFunction2.class, DummyFunction2::new, "DUMMY_FUNCTION2", "DUMMY_FUNCTION")));
         assertEquals("alias [DUMMY_FUNCTION] is used by [DUMMY_FUNCTION] and [DUMMY_FUNCTION2]", iae.getMessage());
     }
     
     public void testDuplicateAliasInTwoDifferentFunctionsFromTheSameBatch() {
-        SqlIllegalArgumentException iae = expectThrows(SqlIllegalArgumentException.class, () ->
+        QlIllegalArgumentException iae = expectThrows(QlIllegalArgumentException.class, () ->
                 new FunctionRegistry(def(DummyFunction.class, DummyFunction::new, "DUMMY_FUNCTION", "ALIAS"),
                         def(DummyFunction2.class, DummyFunction2::new, "DUMMY_FUNCTION2", "ALIAS")));
         assertEquals("alias [ALIAS] is used by [DUMMY_FUNCTION(ALIAS)] and [DUMMY_FUNCTION2]", iae.getMessage());
@@ -179,8 +179,8 @@ public void testDuplicateAliasInTwoDifferentFunctionsFromTheSameBatch() {
     
     public void testDuplicateAliasInTwoDifferentFunctionsFromTwoDifferentBatches() {
         FunctionRegistry r = new FunctionRegistry(def(DummyFunction.class, DummyFunction::new, "DUMMY_FUNCTION", "ALIAS"));
-        SqlIllegalArgumentException iae = expectThrows(SqlIllegalArgumentException.class, () ->
-                r.addToMap(def(DummyFunction2.class, DummyFunction2::new, "DUMMY_FUNCTION2", "ALIAS")));
+        QlIllegalArgumentException iae = expectThrows(QlIllegalArgumentException.class, () ->
+                r.register(def(DummyFunction2.class, DummyFunction2::new, "DUMMY_FUNCTION2", "ALIAS")));
         assertEquals("alias [ALIAS] is used by [DUMMY_FUNCTION] and [DUMMY_FUNCTION2]", iae.getMessage());
     }
 
@@ -215,12 +215,12 @@ public void testFunctionResolving() {
         assertEquals(ur.source(), ur.buildResolved(randomConfiguration(), def).source());
 
         // Not resolved
-        SqlIllegalArgumentException e = expectThrows(SqlIllegalArgumentException.class,
+        QlIllegalArgumentException e = expectThrows(QlIllegalArgumentException.class,
             () -> r.resolveFunction(r.resolveAlias("DummyFunction")));
         assertThat(e.getMessage(),
             is("Cannot find function DUMMYFUNCTION; this should have been caught during analysis"));
 
-        e = expectThrows(SqlIllegalArgumentException.class,
+        e = expectThrows(QlIllegalArgumentException.class,
             () -> r.resolveFunction(r.resolveAlias("dummyFunction")));
         assertThat(e.getMessage(),
             is("Cannot find function DUMMYFUNCTION; this should have been caught during analysis"));
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/NamedExpressionTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/NamedExpressionTests.java
similarity index 63%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/NamedExpressionTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/NamedExpressionTests.java
index 4ac4450620626..d9250bc53a0ef 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/NamedExpressionTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/NamedExpressionTests.java
@@ -3,24 +3,24 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function;
+package org.elasticsearch.xpack.ql.expression.function;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Add;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Div;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mod;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mul;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Neg;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Sub;
-import org.elasticsearch.xpack.sql.tree.Location;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Add;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Div;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mod;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mul;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Neg;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Sub;
+import org.elasticsearch.xpack.ql.tree.Location;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
 
 import static java.util.Collections.emptyMap;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class NamedExpressionTests extends ESTestCase {
 
diff --git a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/TestFunctionRegistry.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/TestFunctionRegistry.java
new file mode 100644
index 0000000000000..88d5599db8617
--- /dev/null
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/TestFunctionRegistry.java
@@ -0,0 +1,14 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.expression.function;
+
+public class TestFunctionRegistry extends FunctionRegistry {
+
+    public TestFunctionRegistry(FunctionDefinition... definitions) {
+        super(definitions);
+    }
+}
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunctionTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunctionTests.java
similarity index 93%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunctionTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunctionTests.java
index a165694f00d91..3331b116bb7dc 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/UnresolvedFunctionTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunctionTests.java
@@ -3,11 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.function;
+package org.elasticsearch.xpack.ql.expression.function;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.Collections;
@@ -16,8 +16,8 @@
 import java.util.function.Supplier;
 
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.expression.UnresolvedAttributeTests.randomUnresolvedAttribute;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.UnresolvedAttributeTests.randomUnresolvedAttribute;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class UnresolvedFunctionTests extends AbstractNodeTestCase<UnresolvedFunction, Expression> {
     public static UnresolvedFunction randomUnresolvedFunction() {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/FunctionTestUtils.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/scalar/FunctionTestUtils.java
similarity index 92%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/FunctionTestUtils.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/scalar/FunctionTestUtils.java
index 8c0abf815c2a2..7713bb1a70b48 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/FunctionTestUtils.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/function/scalar/FunctionTestUtils.java
@@ -4,17 +4,17 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.function.scalar;
+package org.elasticsearch.xpack.ql.expression.function.scalar;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.Literal;
 
 import java.time.Instant;
 import java.time.ZonedDateTime;
 import java.util.BitSet;
 import java.util.Iterator;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public final class FunctionTestUtils {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AttributeInputTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AttributeInputTests.java
similarity index 69%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AttributeInputTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AttributeInputTests.java
index 19164d388de60..c9f05f53c9d00 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/AttributeInputTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/AttributeInputTests.java
@@ -3,14 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.execution.search.FieldExtraction;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AttributeInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.ReferenceInput;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expression;
 
 import static org.mockito.Mockito.mock;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/BinaryPipesTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/BinaryPipesTests.java
similarity index 88%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/BinaryPipesTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/BinaryPipesTests.java
index a4b8a27f13e3c..61e96cc99509e 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/BinaryPipesTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/BinaryPipesTests.java
@@ -3,16 +3,16 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe.AttributeResolver;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe.AttributeResolver;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
@@ -58,7 +58,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     public void testCollectFields() {
         DummyPipe wantsScore = new DummyPipe(randomBoolean()) {
             @Override
-            public void collectFields(SqlSourceBuilder sourceBuilder) {
+            public void collectFields(QlSourceBuilder sourceBuilder) {
                 sourceBuilder.trackScores();
             }
         };
@@ -71,10 +71,10 @@ public void collectFields(SqlSourceBuilder sourceBuilder) {
     /**
      * Returns {@code true} if the processor defintion builds a query that
      * tracks scores, {@code false} otherwise. Used for testing
-     * {@link Pipe#collectFields(SqlSourceBuilder)}.
+     * {@link Pipe#collectFields(QlSourceBuilder)}.
      */
     static boolean tracksScores(Pipe d) {
-        SqlSourceBuilder b = new SqlSourceBuilder();
+        QlSourceBuilder b = new QlSourceBuilder();
         d.collectFields(b);
         SearchSourceBuilder source = new SearchSourceBuilder();
         b.build(source);
@@ -157,7 +157,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
         }
 
         @Override
-        public void collectFields(SqlSourceBuilder sourceBuilder) {
+        public void collectFields(QlSourceBuilder sourceBuilder) {
         }
     }
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/UnaryPipeTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/UnaryPipeTests.java
similarity index 74%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/UnaryPipeTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/UnaryPipeTests.java
index 9c927aed7f4b9..97d84a8318ff8 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/UnaryPipeTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/pipeline/UnaryPipeTests.java
@@ -3,17 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.pipeline;
+package org.elasticsearch.xpack.ql.expression.gen.pipeline;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.UnaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipesTests.DummyPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe.AttributeResolver;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipesTests.DummyPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe.AttributeResolver;
+import org.elasticsearch.xpack.ql.tree.Source;
 
-import static org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipesTests.tracksScores;
+import static org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipesTests.tracksScores;
 
 public class UnaryPipeTests extends ESTestCase {
     public void testSupportedByAggsOnlyQuery() {
@@ -49,7 +47,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     public void testCollectFields() {
         DummyPipe wantsScore = new DummyPipe(randomBoolean()) {
             @Override
-            public void collectFields(SqlSourceBuilder sourceBuilder) {
+            public void collectFields(QlSourceBuilder sourceBuilder) {
                 sourceBuilder.trackScores();
             }
         };
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/processor/ChainingProcessorTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/processor/ChainingProcessorTests.java
similarity index 58%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/processor/ChainingProcessorTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/processor/ChainingProcessorTests.java
index fc7c59836d275..f9d557c5f9e84 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/processor/ChainingProcessorTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/processor/ChainingProcessorTests.java
@@ -3,19 +3,22 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
-import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogicProcessorTests;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessorTests;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparisonProcessorTests;
+import org.elasticsearch.xpack.ql.expression.processor.Processors;
 
 import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
 import java.util.function.Supplier;
 
-import static org.elasticsearch.xpack.sql.execution.search.extractor.ComputingExtractorTests.randomProcessor;
-
-public class ChainingProcessorTests extends AbstractSqlWireSerializingTestCase<ChainingProcessor> {
+public class ChainingProcessorTests extends AbstractWireSerializingTestCase<ChainingProcessor> {
     public static ChainingProcessor randomComposeProcessor() {
         return new ChainingProcessor(randomProcessor(), randomProcessor());
     }
@@ -45,4 +48,13 @@ protected ChainingProcessor mutateInstance(ChainingProcessor instance) throws IO
                     randomValueOtherThan(instance.first(), () -> randomProcessor()), instance.second()));
         return supplier.get();
     }
+
+    public static Processor randomProcessor() {
+        List<Supplier<Processor>> options = new ArrayList<>();
+        options.add(ChainingProcessorTests::randomComposeProcessor);
+        options.add(BinaryLogicProcessorTests::randomProcessor);
+        options.add(BinaryArithmeticProcessorTests::randomProcessor);
+        options.add(BinaryComparisonProcessorTests::randomProcessor);
+        return randomFrom(options).get();
+    }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/processor/ConstantProcessorTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/processor/ConstantProcessorTests.java
similarity index 89%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/processor/ConstantProcessorTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/processor/ConstantProcessorTests.java
index 06daed00a537c..e2f249d082652 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/gen/processor/ConstantProcessorTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/gen/processor/ConstantProcessorTests.java
@@ -3,12 +3,12 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.gen.processor;
+package org.elasticsearch.xpack.ql.expression.gen.processor;
 
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalDayTime;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalDayTime;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.io.IOException;
 import java.time.Duration;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/literal/IntervalsTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/literal/IntervalsTests.java
similarity index 88%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/literal/IntervalsTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/literal/IntervalsTests.java
index 2140e27c8c2ff..6a04242f4ad3a 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/literal/IntervalsTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/literal/IntervalsTests.java
@@ -4,13 +4,13 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.literal;
+package org.elasticsearch.xpack.ql.expression.literal;
 
 import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.literal.Intervals.TimeUnit;
-import org.elasticsearch.xpack.sql.parser.ParsingException;
+import org.elasticsearch.xpack.ql.ParsingException;
+import org.elasticsearch.xpack.ql.expression.literal.Intervals.TimeUnit;
 
 import java.time.Duration;
 import java.time.Period;
@@ -20,23 +20,23 @@
 
 import static java.lang.String.format;
 import static java.util.stream.Collectors.toList;
-import static org.elasticsearch.xpack.sql.expression.literal.Intervals.intervalType;
-import static org.elasticsearch.xpack.sql.expression.literal.Intervals.of;
-import static org.elasticsearch.xpack.sql.expression.literal.Intervals.parseInterval;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_HOUR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR_TO_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MINUTE_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MONTH;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR_TO_MONTH;
+import static org.elasticsearch.xpack.ql.expression.literal.Intervals.intervalType;
+import static org.elasticsearch.xpack.ql.expression.literal.Intervals.of;
+import static org.elasticsearch.xpack.ql.expression.literal.Intervals.parseInterval;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_HOUR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR_TO_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MINUTE_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MONTH;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR_TO_MONTH;
 
 public class IntervalsTests extends ESTestCase {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CaseTests.java
similarity index 82%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CaseTests.java
index 899da8049b915..1d6477b0ebf05 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/CaseTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/CaseTests.java
@@ -3,18 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
-
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expression.TypeResolution;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.NodeSubclassTests;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.type.DataType;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression.TypeResolution;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.NodeSubclassTests;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -22,10 +22,10 @@
 import java.util.List;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 /**
  * Needed to override tests in {@link NodeSubclassTests} as Case is special since its children are not usual
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IifTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IifTests.java
similarity index 76%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IifTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IifTests.java
index 6b468fcb8fbf2..778b775061412 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/conditional/IifTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/conditional/IifTests.java
@@ -3,17 +3,17 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.conditional;
+package org.elasticsearch.xpack.ql.expression.predicate.conditional;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.NodeSubclassTests;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.NodeSubclassTests;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -21,10 +21,10 @@
 import java.util.List;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 /**
  * Needed to override tests in {@link NodeSubclassTests} as If is special since its children are not usual
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextUtilsTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextUtilsTests.java
similarity index 83%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextUtilsTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextUtilsTests.java
index 8341abee22fac..fdbac0bf3c81d 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/fulltext/FullTextUtilsTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/fulltext/FullTextUtilsTests.java
@@ -3,13 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.fulltext;
-
-import io.netty.util.internal.StringUtil;
+package org.elasticsearch.xpack.ql.expression.predicate.fulltext;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.parser.ParsingException;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.ParsingException;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Map;
 
@@ -18,7 +16,7 @@
 
 public class FullTextUtilsTests extends ESTestCase {
 
-    private final Source source = new Source(1, 1, StringUtil.EMPTY_STRING);
+    private final Source source = new Source(1, 1, "");
 
     public void testColonDelimited() {
         Map<String, String> options = FullTextUtils.parseSettings("k1=v1;k2=v2", source);
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicProcessorTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicProcessorTests.java
similarity index 93%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicProcessorTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicProcessorTests.java
index ec29e912a2c90..6cfda143982d6 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/logical/BinaryLogicProcessorTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/logical/BinaryLogicProcessorTests.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.logical;
+package org.elasticsearch.xpack.ql.expression.predicate.logical;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.processor.Processors;
 
 public class BinaryLogicProcessorTests extends AbstractWireSerializingTestCase<BinaryLogicProcessor> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessorTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/CheckNullProcessorTests.java
similarity index 78%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessorTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/CheckNullProcessorTests.java
index 4ed35e2f9caa7..912b1b025f8e6 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/nulls/CheckNullProcessorTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/nulls/CheckNullProcessorTests.java
@@ -3,15 +3,21 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.nulls;
+package org.elasticsearch.xpack.ql.expression.predicate.nulls;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.processor.Processors;
 
 public class CheckNullProcessorTests extends AbstractWireSerializingTestCase<CheckNullProcessor> {
 
+    private static final Processor FALSE = new ConstantProcessor(false);
+    private static final Processor TRUE = new ConstantProcessor(true);
+    private static final Processor NULL = new ConstantProcessor((Object) null);
+
     public static CheckNullProcessor randomProcessor() {
         return new CheckNullProcessor(randomFrom(CheckNullProcessor.CheckNullOperation.values()));
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessorTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessorTests.java
similarity index 76%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessorTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessorTests.java
index 03e1774c1fc52..099985fc5aebe 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessorTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticProcessorTests.java
@@ -3,25 +3,18 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Add;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Div;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mod;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mul;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Neg;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Sub;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.processor.Processors;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class BinaryArithmeticProcessorTests extends AbstractWireSerializingTestCase<BinaryArithmeticProcessor> {
     public static BinaryArithmeticProcessor randomProcessor() {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java
similarity index 87%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java
index 1b877cb75f377..6ba08c3933d90 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/arithmetic/BinaryArithmeticTests.java
@@ -4,15 +4,15 @@
  * you may not use this file except in compliance with the Elastic License.
  */
 
-package org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalDayTime;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.DateUtils;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalDayTime;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalYearMonth;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.DateUtils;
 
 import java.time.Duration;
 import java.time.OffsetTime;
@@ -20,14 +20,14 @@
 import java.time.ZonedDateTime;
 import java.time.temporal.TemporalAmount;
 
-import static org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Arithmetics.mod;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_HOUR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MONTH;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR_TO_MONTH;
+import static org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Arithmetics.mod;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_HOUR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MONTH;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR_TO_MONTH;
 
 public class BinaryArithmeticTests extends ESTestCase {
 
@@ -134,7 +134,7 @@ public void testAddDayTimeIntervalToTimeReverse() {
 
     public void testAddNumberToIntervalIllegal() {
         Literal r = interval(Duration.ofHours(2), INTERVAL_HOUR);
-        SqlIllegalArgumentException expect = expectThrows(SqlIllegalArgumentException.class, () -> add(r, L(1)));
+        QlIllegalArgumentException expect = expectThrows(QlIllegalArgumentException.class, () -> add(r, L(1)));
         assertEquals("Cannot compute [+] between [IntervalDayTime] [Integer]", expect.getMessage());
     }
 
@@ -166,7 +166,7 @@ public void testSubYearMonthIntervalToDateTimeIllegal() {
         Literal l = L(now);
         TemporalAmount t = Period.ofYears(100).plusMonths(50);
         Literal r = interval(t, INTERVAL_HOUR);
-        SqlIllegalArgumentException ex = expectThrows(SqlIllegalArgumentException.class, () -> sub(r, l));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> sub(r, l));
         assertEquals("Cannot subtract a date from an interval; do you mean the reverse?", ex.getMessage());
     }
 
@@ -193,7 +193,7 @@ public void testSubYearMonthIntervalToTimeIllegal() {
         Literal l = L(now);
         TemporalAmount t = Period.ofYears(100).plusMonths(50);
         Literal r = interval(t, INTERVAL_HOUR);
-        SqlIllegalArgumentException ex = expectThrows(SqlIllegalArgumentException.class, () -> sub(r, l));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> sub(r, l));
         assertEquals("Cannot subtract a date from an interval; do you mean the reverse?", ex.getMessage());
     }
 
@@ -208,7 +208,7 @@ public void testSubDayTimeIntervalToTime() {
 
     public void testSubNumberFromIntervalIllegal() {
         Literal r = interval(Duration.ofHours(2), INTERVAL_HOUR);
-        SqlIllegalArgumentException expect = expectThrows(SqlIllegalArgumentException.class, () -> sub(r, L(1)));
+        QlIllegalArgumentException expect = expectThrows(QlIllegalArgumentException.class, () -> sub(r, L(1)));
         assertEquals("Cannot compute [-] between [IntervalDayTime] [Integer]", expect.getMessage());
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonProcessorTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonProcessorTests.java
similarity index 91%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonProcessorTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonProcessorTests.java
index d082fbd371f79..97088971ac9be 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/BinaryComparisonProcessorTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/BinaryComparisonProcessorTests.java
@@ -3,17 +3,17 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.processor.Processors;
 
-import static org.elasticsearch.xpack.sql.expression.Literal.NULL;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.expression.Literal.NULL;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class BinaryComparisonProcessorTests extends AbstractWireSerializingTestCase<BinaryComparisonProcessor> {
     public static BinaryComparisonProcessor randomProcessor() {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InProcessorTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InProcessorTests.java
similarity index 83%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InProcessorTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InProcessorTests.java
index e5b9bb23052bd..d35feadd1eedf 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InProcessorTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InProcessorTests.java
@@ -3,19 +3,19 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.processor.Processors;
 
 import java.util.Arrays;
 
-import static org.elasticsearch.xpack.sql.expression.Literal.NULL;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.expression.Literal.NULL;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class InProcessorTests extends AbstractWireSerializingTestCase<InProcessor> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InTests.java
similarity index 84%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InTests.java
index 49fa8bed9dd9c..4faf583279e8e 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/predicate/operator/comparison/InTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/InTests.java
@@ -3,15 +3,15 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression.predicate.operator.comparison;
+package org.elasticsearch.xpack.ql.expression.predicate.operator.comparison;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.Literal;
 
 import java.util.Arrays;
 
-import static org.elasticsearch.xpack.sql.expression.Literal.NULL;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.expression.Literal.NULL;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class InTests extends ESTestCase {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/AbstractNodeTestCase.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/AbstractNodeTestCase.java
similarity index 97%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/AbstractNodeTestCase.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/AbstractNodeTestCase.java
index b5b0adfb0e6a9..7fa9264091c13 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/AbstractNodeTestCase.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/AbstractNodeTestCase.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.tree;
+package org.elasticsearch.xpack.ql.tree;
 
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.EqualsHashCodeTestUtils;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeSubclassTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeSubclassTests.java
similarity index 87%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeSubclassTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeSubclassTests.java
index d3a4870c24857..836450cff5cf2 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeSubclassTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeSubclassTests.java
@@ -3,42 +3,36 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.tree;
+package org.elasticsearch.xpack.ql.tree;
 
 import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.PathUtils;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.LiteralTests;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAttributeTests;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Avg;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Percentile;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.PercentileRanks;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Percentiles;
-import org.elasticsearch.xpack.sql.expression.function.grouping.Histogram;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.CurrentDateTime;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggExtractorInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipesTests;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfConditional;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfNull;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Iif;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.FullTextPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.In;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.InPipe;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.Like;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
-import org.elasticsearch.xpack.sql.tree.NodeTests.ChildrenAreAProperty;
-import org.elasticsearch.xpack.sql.tree.NodeTests.Dummy;
-import org.elasticsearch.xpack.sql.tree.NodeTests.NoChildren;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttributeTests;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.CompoundAggregate;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.InnerAggregate;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.AggExtractorInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipesTests;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfConditional;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfNull;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Iif;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.FullTextPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.In;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.InPipe;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.Like;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.tree.NodeTests.ChildrenAreAProperty;
+import org.elasticsearch.xpack.ql.tree.NodeTests.Dummy;
+import org.elasticsearch.xpack.ql.tree.NodeTests.NoChildren;
 import org.mockito.exceptions.base.MockitoException;
 
 import java.io.IOException;
@@ -93,8 +87,8 @@
  */
 public class NodeSubclassTests<T extends B, B extends Node<B>> extends ESTestCase {
 
-    private static final List<Class<?>> CLASSES_WITH_MIN_TWO_CHILDREN = Arrays.asList(Iif.class, IfConditional.class,
-        IfNull.class, In.class, InPipe.class, Percentile.class, Percentiles.class, PercentileRanks.class);
+    protected static final List<Class<?>> CLASSES_WITH_MIN_TWO_CHILDREN = Arrays.asList(Iif.class, IfConditional.class, IfNull.class,
+            In.class, InPipe.class);
 
     private final Class<T> subclass;
 
@@ -318,7 +312,7 @@ public static List<Object[]> nodeSubclasses() throws IOException {
      * {@code ctor} that make sense when {@code ctor}
      * builds subclasses of {@link Node}.
      */
-    private static Object[] ctorArgs(Constructor<? extends Node<?>> ctor) throws Exception {
+    private Object[] ctorArgs(Constructor<? extends Node<?>> ctor) throws Exception {
         Type[] argTypes = ctor.getGenericParameterTypes();
         Object[] args = new Object[argTypes.length];
         for (int i = 0; i < argTypes.length; i++) {
@@ -344,7 +338,7 @@ private static Object[] ctorArgs(Constructor<? extends Node<?>> ctor) throws Exc
     /**
      * Make an argument to feed the {@link #subclass}'s ctor.
      */
-    private Object makeArg(Type argType) {
+    protected Object makeArg(Type argType) {
         try {
             return makeArg(subclass, argType);
         } catch (Exception e) {
@@ -357,7 +351,7 @@ private Object makeArg(Type argType) {
      * Make an argument to feed to the constructor for {@code toBuildClass}.
      */
     @SuppressWarnings("unchecked")
-    private static Object makeArg(Class<? extends Node<?>> toBuildClass, Type argType) throws Exception {
+    private Object makeArg(Class<? extends Node<?>> toBuildClass, Type argType) throws Exception {
 
         if (argType instanceof ParameterizedType) {
             ParameterizedType pt = (ParameterizedType) argType;
@@ -377,7 +371,7 @@ private static Object makeArg(Class<? extends Node<?>> toBuildClass, Type argTyp
                     // AggValueInput just needs a valid java type in a supplier
                     Object o = randomBoolean() ? null : randomAlphaOfLength(5);
                     // But the supplier has to implement equals for randomValueOtherThan
-                    return new Supplier<Object>() {
+                    return new Supplier<>() {
                         @Override
                         public Object get() {
                             return o;
@@ -416,11 +410,15 @@ public boolean equals(Object obj) {
          * so we have to hard code it here.
          */
         if (toBuildClass == InnerAggregate.class) {
-            // InnerAggregate's AggregateFunction must be an EnclosedAgg. Avg is.
+            // InnerAggregate's AggregateFunction must be an EnclosedAgg.
             if (argClass == AggregateFunction.class) {
-                return makeNode(Avg.class);
+                return makeEnclosedAgg();
+            }
+            else if (argClass == CompoundAggregate.class) {
+                return makeCompoundAgg();
             }
-        } else if (toBuildClass == FieldAttribute.class) {
+        }
+        else if (toBuildClass == FieldAttribute.class) {
             // `parent` is nullable.
             if (argClass == FieldAttribute.class && randomBoolean()) {
                 return null;
@@ -455,13 +453,10 @@ public boolean equals(Object obj) {
                 return new LikePattern(randomAlphaOfLength(16), randomFrom('\\', '|', '/', '`'));
             }
 
-        } else if (toBuildClass == Histogram.class) {
-            if (argClass == Expression.class) {
-                return LiteralTests.randomLiteral();
-            }
-        } else if (toBuildClass == CurrentDateTime.class) {
-            if (argClass == Expression.class) {
-                return Literal.of(SourceTests.randomSource(), randomInt(9));
+        } else {
+            Object postProcess = pluggableMakeArg(toBuildClass, argClass);
+            if (postProcess != null) {
+                return postProcess;
             }
         }
         if (Expression.class == argClass) {
@@ -526,11 +521,23 @@ public boolean equals(Object obj) {
         }
     }
 
-    private static List<?> makeList(Class<? extends Node<?>> toBuildClass, ParameterizedType listType) throws Exception {
+    protected Object makeCompoundAgg() throws Exception {
+        return makeArg(TestCompoundAggregate.class);
+    }
+
+    protected Object makeEnclosedAgg() throws Exception {
+        return makeArg(TestEnclosedAgg.class);
+    }
+
+    protected Object pluggableMakeArg(Class<? extends Node<?>> toBuildClass, Class<?> argClass) {
+        return null;
+    }
+
+    private List<?> makeList(Class<? extends Node<?>> toBuildClass, ParameterizedType listType) throws Exception {
         return makeList(toBuildClass, listType, randomSizeForCollection(toBuildClass));
     }
 
-    private static List<?> makeList(Class<? extends Node<?>> toBuildClass, ParameterizedType listType, int size) throws Exception {
+    private List<?> makeList(Class<? extends Node<?>> toBuildClass, ParameterizedType listType, int size) throws Exception {
         List<Object> list = new ArrayList<>();
         for (int i = 0; i < size; i++) {
             list.add(makeArg(toBuildClass, listType.getActualTypeArguments()[0]));
@@ -538,7 +545,7 @@ private static List<?> makeList(Class<? extends Node<?>> toBuildClass, Parameter
         return list;
     }
 
-    private static Object makeMap(Class<? extends Node<?>> toBuildClass, ParameterizedType pt) throws Exception {
+    private Object makeMap(Class<? extends Node<?>> toBuildClass, ParameterizedType pt) throws Exception {
         Map<Object, Object> map = new HashMap<>();
         int size = randomSizeForCollection(toBuildClass);
         while (map.size() < size) {
@@ -549,16 +556,20 @@ private static Object makeMap(Class<? extends Node<?>> toBuildClass, Parameteriz
         return map;
     }
 
-    private static int randomSizeForCollection(Class<? extends Node<?>> toBuildClass) {
+    private int randomSizeForCollection(Class<? extends Node<?>> toBuildClass) {
         int minCollectionLength = 0;
         int maxCollectionLength = 10;
 
-        if (CLASSES_WITH_MIN_TWO_CHILDREN.stream().anyMatch(c -> c == toBuildClass)) {
+        if (hasAtLeastTwoChildren(toBuildClass)) {
             minCollectionLength = 2;
         }
         return between(minCollectionLength, maxCollectionLength);
     }
 
+    protected boolean hasAtLeastTwoChildren(Class<? extends Node<?>> toBuildClass) {
+        return CLASSES_WITH_MIN_TWO_CHILDREN.stream().anyMatch(toBuildClass::equals);
+    }
+
     private List<?> makeListOfSameSizeOtherThan(Type listType, List<?> original) throws Exception {
         if (original.isEmpty()) {
             throw new IllegalArgumentException("Can't make a different empty list");
@@ -573,7 +584,7 @@ private List<?> makeListOfSameSizeOtherThan(Type listType, List<?> original) thr
 
     }
 
-    public static <T extends Node<?>> T makeNode(Class<? extends T> nodeClass) throws Exception {
+    public <T extends Node<?>> T makeNode(Class<? extends T> nodeClass) throws Exception {
         if (Modifier.isAbstract(nodeClass.getModifiers())) {
             nodeClass = randomFrom(subclassesOf(nodeClass));
         }
@@ -620,7 +631,7 @@ public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IO
 
                         // filter the class that are not interested
                         // (and IDE folders like eclipse)
-                        if (!className.startsWith("org.elasticsearch.xpack.sql")) {
+                        if (!className.startsWith("org.elasticsearch.xpack.ql") && !className.startsWith("org.elasticsearch.xpack.sql")) {
                             return FileVisitResult.CONTINUE;
                         }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeTests.java
similarity index 97%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeTests.java
index f73597bc0c4f8..46e3751a751d6 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/NodeTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeTests.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.tree;
+package org.elasticsearch.xpack.ql.tree;
 
 import org.elasticsearch.test.ESTestCase;
 
@@ -13,7 +13,7 @@
 
 import static java.util.Collections.emptyList;
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class NodeTests extends ESTestCase {
     public void testToString() {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SourceTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/SourceTests.java
similarity index 97%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SourceTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/SourceTests.java
index bd9855377193c..f24636d34e06c 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SourceTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/SourceTests.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.tree;
+package org.elasticsearch.xpack.ql.tree;
 
 import org.elasticsearch.test.ESTestCase;
 
diff --git a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/TestCompoundAggregate.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/TestCompoundAggregate.java
new file mode 100644
index 0000000000000..737d1d0950074
--- /dev/null
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/TestCompoundAggregate.java
@@ -0,0 +1,39 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.tree;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.CompoundAggregate;
+import org.elasticsearch.xpack.ql.type.DataType;
+
+import java.util.List;
+
+public class TestCompoundAggregate extends AggregateFunction implements CompoundAggregate {
+
+    public TestCompoundAggregate(Source source, Expression field) {
+        super(source, field);
+    }
+
+    @Override
+    protected NodeInfo<TestCompoundAggregate> info() {
+        return NodeInfo.create(this, TestCompoundAggregate::new, field());
+    }
+
+    @Override
+    public TestCompoundAggregate replaceChildren(List<Expression> newChildren) {
+        if (newChildren.size() != 1) {
+            throw new IllegalArgumentException("expected [1] child but received [" + newChildren.size() + "]");
+        }
+        return new TestCompoundAggregate(source(), newChildren.get(0));
+    }
+
+    @Override
+    public DataType dataType() {
+        return DataType.DOUBLE;
+    }
+}
diff --git a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/TestEnclosedAgg.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/TestEnclosedAgg.java
new file mode 100644
index 0000000000000..a19b43fa2e9cb
--- /dev/null
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/TestEnclosedAgg.java
@@ -0,0 +1,44 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ql.tree;
+
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+import org.elasticsearch.xpack.ql.type.DataType;
+
+import java.util.List;
+
+public class TestEnclosedAgg extends AggregateFunction implements EnclosedAgg {
+
+    public TestEnclosedAgg(Source source, Expression field) {
+        super(source, field);
+    }
+
+    @Override
+    protected NodeInfo<TestEnclosedAgg> info() {
+        return NodeInfo.create(this, TestEnclosedAgg::new, field());
+    }
+
+    @Override
+    public TestEnclosedAgg replaceChildren(List<Expression> newChildren) {
+        if (newChildren.size() != 1) {
+            throw new IllegalArgumentException("expected [1] child but received [" + newChildren.size() + "]");
+        }
+        return new TestEnclosedAgg(source(), newChildren.get(0));
+    }
+
+    @Override
+    public String innerName() {
+        return "testEnclosed";
+    }
+
+    @Override
+    public DataType dataType() {
+        return DataType.DOUBLE;
+    }
+}
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/DataTypeConversionTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypeConversionTests.java
similarity index 82%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/DataTypeConversionTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypeConversionTests.java
index c553be208ab11..77c5f097131fa 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/DataTypeConversionTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypeConversionTests.java
@@ -3,14 +3,14 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.tree.Location;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion.Conversion;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.tree.Location;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion.Conversion;
 
 import java.time.OffsetTime;
 import java.time.ZoneOffset;
@@ -18,38 +18,34 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeTestUtils.date;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeTestUtils.dateTime;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeTestUtils.time;
-import static org.elasticsearch.xpack.sql.type.DataType.BOOLEAN;
-import static org.elasticsearch.xpack.sql.type.DataType.BYTE;
-import static org.elasticsearch.xpack.sql.type.DataType.DATE;
-import static org.elasticsearch.xpack.sql.type.DataType.DATETIME;
-import static org.elasticsearch.xpack.sql.type.DataType.DOUBLE;
-import static org.elasticsearch.xpack.sql.type.DataType.FLOAT;
-import static org.elasticsearch.xpack.sql.type.DataType.INTEGER;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR_TO_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MONTH;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR_TO_MONTH;
-import static org.elasticsearch.xpack.sql.type.DataType.IP;
-import static org.elasticsearch.xpack.sql.type.DataType.KEYWORD;
-import static org.elasticsearch.xpack.sql.type.DataType.LONG;
-import static org.elasticsearch.xpack.sql.type.DataType.NULL;
-import static org.elasticsearch.xpack.sql.type.DataType.SHORT;
-import static org.elasticsearch.xpack.sql.type.DataType.TEXT;
-import static org.elasticsearch.xpack.sql.type.DataType.TIME;
-import static org.elasticsearch.xpack.sql.type.DataType.UNSUPPORTED;
-import static org.elasticsearch.xpack.sql.type.DataType.fromTypeName;
-import static org.elasticsearch.xpack.sql.type.DataType.values;
-import static org.elasticsearch.xpack.sql.type.DataTypeConversion.commonType;
-import static org.elasticsearch.xpack.sql.type.DataTypeConversion.conversionFor;
-import static org.elasticsearch.xpack.sql.util.DateUtils.asDateOnly;
-import static org.elasticsearch.xpack.sql.util.DateUtils.asDateTime;
-import static org.elasticsearch.xpack.sql.util.DateUtils.asTimeOnly;
-
+import static org.elasticsearch.xpack.ql.type.DataType.BOOLEAN;
+import static org.elasticsearch.xpack.ql.type.DataType.BYTE;
+import static org.elasticsearch.xpack.ql.type.DataType.DATE;
+import static org.elasticsearch.xpack.ql.type.DataType.DATETIME;
+import static org.elasticsearch.xpack.ql.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.ql.type.DataType.FLOAT;
+import static org.elasticsearch.xpack.ql.type.DataType.INTEGER;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR_TO_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MONTH;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR_TO_MONTH;
+import static org.elasticsearch.xpack.ql.type.DataType.IP;
+import static org.elasticsearch.xpack.ql.type.DataType.KEYWORD;
+import static org.elasticsearch.xpack.ql.type.DataType.LONG;
+import static org.elasticsearch.xpack.ql.type.DataType.NULL;
+import static org.elasticsearch.xpack.ql.type.DataType.SHORT;
+import static org.elasticsearch.xpack.ql.type.DataType.TEXT;
+import static org.elasticsearch.xpack.ql.type.DataType.TIME;
+import static org.elasticsearch.xpack.ql.type.DataType.UNSUPPORTED;
+import static org.elasticsearch.xpack.ql.type.DataType.fromTypeName;
+import static org.elasticsearch.xpack.ql.type.DataType.values;
+import static org.elasticsearch.xpack.ql.type.DataTypeConversion.commonType;
+import static org.elasticsearch.xpack.ql.type.DataTypeConversion.conversionFor;
+import static org.elasticsearch.xpack.ql.type.DateUtils.asDateOnly;
+import static org.elasticsearch.xpack.ql.type.DateUtils.asDateTime;
+import static org.elasticsearch.xpack.ql.type.DateUtils.asTimeOnly;
 
 public class DataTypeConversionTests extends ESTestCase {
 
@@ -93,7 +89,7 @@ public void testConversionToLong() {
             assertEquals(10L, conversion.convert(10.0));
             assertEquals(10L, conversion.convert(10.1));
             assertEquals(11L, conversion.convert(10.6));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(Double.MAX_VALUE));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(Double.MAX_VALUE));
             assertEquals("[" + Double.MAX_VALUE + "] out of [long] range", e.getMessage());
         }
         {
@@ -133,7 +129,7 @@ public void testConversionToLong() {
             assertNull(conversion.convert(null));
             assertEquals(1L, conversion.convert("1"));
             assertEquals(0L, conversion.convert("-0"));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("0xff"));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("0xff"));
             assertEquals("cannot cast [0xff] to [long]", e.getMessage());
         }
     }
@@ -146,7 +142,7 @@ public void testConversionToDate() {
             assertEquals(date(10L), conversion.convert(10.0));
             assertEquals(date(10L), conversion.convert(10.1));
             assertEquals(date(11L), conversion.convert(10.6));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(Double.MAX_VALUE));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(Double.MAX_VALUE));
             assertEquals("[" + Double.MAX_VALUE + "] out of [long] range", e.getMessage());
         }
         {
@@ -162,7 +158,7 @@ public void testConversionToDate() {
             assertEquals(date(0), conversion.convert(false));
         }
         {
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversionFor(TIME, to));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversionFor(TIME, to));
             assertEquals("cannot convert from [time] to [date]", e.getMessage());
         }
         {
@@ -186,7 +182,7 @@ public void testConversionToDate() {
             Conversion forward = conversionFor(DATE, KEYWORD);
             Conversion back = conversionFor(KEYWORD, DATE);
             assertEquals(asDateOnly(zdt), back.convert(forward.convert(zdt)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("0xff"));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("0xff"));
             assertEquals("cannot cast [0xff] to [date]: Text '0xff' could not be parsed at index 0", e.getMessage());
         }
     }
@@ -199,7 +195,7 @@ public void testConversionToTime() {
             assertEquals(time(10L), conversion.convert(10.0));
             assertEquals(time(10L), conversion.convert(10.1));
             assertEquals(time(11L), conversion.convert(10.6));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(Double.MAX_VALUE));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(Double.MAX_VALUE));
             assertEquals("[" + Double.MAX_VALUE + "] out of [long] range", e.getMessage());
         }
         {
@@ -240,7 +236,7 @@ public void testConversionToTime() {
             Conversion forward = conversionFor(TIME, KEYWORD);
             Conversion back = conversionFor(KEYWORD, TIME);
             assertEquals(ot, back.convert(forward.convert(ot)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("0xff"));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("0xff"));
             assertEquals("cannot cast [0xff] to [time]: Text '0xff' could not be parsed at index 0",
                 e.getMessage());
         }
@@ -254,7 +250,7 @@ public void testConversionToDateTime() {
             assertEquals(dateTime(10L), conversion.convert(10.0));
             assertEquals(dateTime(10L), conversion.convert(10.1));
             assertEquals(dateTime(11L), conversion.convert(10.6));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(Double.MAX_VALUE));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(Double.MAX_VALUE));
             assertEquals("[" + Double.MAX_VALUE + "] out of [long] range", e.getMessage());
         }
         {
@@ -276,7 +272,7 @@ public void testConversionToDateTime() {
             assertEquals(dateTime(-123465600000L), conversion.convert(asDateOnly(-123456789101L)));
         }
         {
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversionFor(TIME, to));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversionFor(TIME, to));
             assertEquals("cannot convert from [time] to [datetime]", e.getMessage());
         }
         {
@@ -295,7 +291,7 @@ public void testConversionToDateTime() {
             Conversion forward = conversionFor(DATETIME, KEYWORD);
             Conversion back = conversionFor(KEYWORD, DATETIME);
             assertEquals(dt, back.convert(forward.convert(dt)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("0xff"));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("0xff"));
             assertEquals("cannot cast [0xff] to [datetime]: failed to parse date field [0xff] with format [date_optional_time]",
                 e.getMessage());
         }
@@ -348,7 +344,7 @@ public void testConversionToFloat() {
             assertEquals(1.0f, (float) conversion.convert("1"), 0);
             assertEquals(0.0f, (float) conversion.convert("-0"), 0);
             assertEquals(12.776f, (float) conversion.convert("12.776"), 0.00001);
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("0xff"));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("0xff"));
             assertEquals("cannot cast [0xff] to [float]", e.getMessage());
         }
     }
@@ -400,7 +396,7 @@ public void testConversionToDouble() {
             assertEquals(1.0, (double) conversion.convert("1"), 0);
             assertEquals(0.0, (double) conversion.convert("-0"), 0);
             assertEquals(12.776, (double) conversion.convert("12.776"), 0.00001);
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("0xff"));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("0xff"));
             assertEquals("cannot cast [0xff] to [double]", e.getMessage());
         }
     }
@@ -465,17 +461,17 @@ public void testConversionToBoolean() {
             assertEquals(true, conversion.convert("True"));
             assertEquals(false, conversion.convert("fAlSe"));
             // Everything else should fail
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("10"));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("10"));
             assertEquals("cannot cast [10] to [boolean]", e.getMessage());
-            e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("-1"));
+            e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("-1"));
             assertEquals("cannot cast [-1] to [boolean]", e.getMessage());
-            e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("0"));
+            e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("0"));
             assertEquals("cannot cast [0] to [boolean]", e.getMessage());
-            e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("blah"));
+            e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("blah"));
             assertEquals("cannot cast [blah] to [boolean]", e.getMessage());
-            e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("Yes"));
+            e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("Yes"));
             assertEquals("cannot cast [Yes] to [boolean]", e.getMessage());
-            e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("nO"));
+            e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("nO"));
             assertEquals("cannot cast [nO] to [boolean]", e.getMessage());
         }
     }
@@ -488,7 +484,7 @@ public void testConversionToInt() {
             assertEquals(10, conversion.convert(10.0));
             assertEquals(10, conversion.convert(10.1));
             assertEquals(11, conversion.convert(10.6));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(Long.MAX_VALUE));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(Long.MAX_VALUE));
             assertEquals("[" + Long.MAX_VALUE + "] out of [integer] range", e.getMessage());
         }
         {
@@ -498,7 +494,7 @@ public void testConversionToInt() {
             assertEquals(86400000, conversion.convert(asDateOnly(123456789L)));
             assertEquals(172800000, conversion.convert(asDateOnly(223456789L)));
             assertEquals(-172800000, conversion.convert(asDateOnly(-123456789L)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(asDateOnly(Long.MAX_VALUE)));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(asDateOnly(Long.MAX_VALUE)));
             assertEquals("[9223372036828800000] out of [integer] range", e.getMessage());
         }
         {
@@ -516,7 +512,7 @@ public void testConversionToInt() {
             assertEquals(12345678, conversion.convert(asDateTime(12345678L)));
             assertEquals(223456789, conversion.convert(asDateTime(223456789L)));
             assertEquals(-123456789, conversion.convert(asDateTime(-123456789L)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(asDateTime(Long.MAX_VALUE)));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(asDateTime(Long.MAX_VALUE)));
             assertEquals("[" + Long.MAX_VALUE + "] out of [integer] range", e.getMessage());
         }
     }
@@ -529,23 +525,23 @@ public void testConversionToShort() {
             assertEquals((short) 10, conversion.convert(10.0));
             assertEquals((short) 10, conversion.convert(10.1));
             assertEquals((short) 11, conversion.convert(10.6));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(Integer.MAX_VALUE));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(Integer.MAX_VALUE));
             assertEquals("[" + Integer.MAX_VALUE + "] out of [short] range", e.getMessage());
         }
         {
             Conversion conversion = conversionFor(DATE, to);
             assertNull(conversion.convert(null));
             assertEquals((short) 0, conversion.convert(asDateOnly(12345678L)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(asDateOnly(123456789L)));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(asDateOnly(123456789L)));
             assertEquals("[86400000] out of [short] range", e.getMessage());
         }
         {
             Conversion conversion = conversionFor(TIME, to);
             assertNull(conversion.convert(null));
             assertEquals((short) 12345, conversion.convert(asTimeOnly(12345L)));
-            Exception e1 = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(asTimeOnly(-123456789L)));
+            Exception e1 = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(asTimeOnly(-123456789L)));
             assertEquals("[49343211] out of [short] range", e1.getMessage());
-            Exception e2 = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(asTimeOnly(123456789L)));
+            Exception e2 = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(asTimeOnly(123456789L)));
             assertEquals("[37056789] out of [short] range", e2.getMessage());
         }
         {
@@ -553,7 +549,7 @@ public void testConversionToShort() {
             assertNull(conversion.convert(null));
             assertEquals((short) 12345, conversion.convert(asDateTime(12345L)));
             assertEquals((short) -12345, conversion.convert(asDateTime(-12345L)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class,
+            Exception e = expectThrows(QlIllegalArgumentException.class,
                 () -> conversion.convert(asDateTime(Integer.MAX_VALUE)));
             assertEquals("[" + Integer.MAX_VALUE + "] out of [short] range", e.getMessage());
         }
@@ -567,23 +563,23 @@ public void testConversionToByte() {
             assertEquals((byte) 10, conversion.convert(10.0));
             assertEquals((byte) 10, conversion.convert(10.1));
             assertEquals((byte) 11, conversion.convert(10.6));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(Short.MAX_VALUE));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(Short.MAX_VALUE));
             assertEquals("[" + Short.MAX_VALUE + "] out of [byte] range", e.getMessage());
         }
         {
             Conversion conversion = conversionFor(DATE, to);
             assertNull(conversion.convert(null));
             assertEquals((byte) 0, conversion.convert(asDateOnly(12345678L)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(asDateOnly(123456789L)));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(asDateOnly(123456789L)));
             assertEquals("[86400000] out of [byte] range", e.getMessage());
         }
         {
             Conversion conversion = conversionFor(TIME, to);
             assertNull(conversion.convert(null));
             assertEquals((byte) 123, conversion.convert(asTimeOnly(123L)));
-            Exception e1 = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(asTimeOnly(-123L)));
+            Exception e1 = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(asTimeOnly(-123L)));
             assertEquals("[86399877] out of [byte] range", e1.getMessage());
-            Exception e2 = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert(asTimeOnly(123456789L)));
+            Exception e2 = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert(asTimeOnly(123456789L)));
             assertEquals("[37056789] out of [byte] range", e2.getMessage());
         }
         {
@@ -591,7 +587,7 @@ public void testConversionToByte() {
             assertNull(conversion.convert(null));
             assertEquals((byte) 123, conversion.convert(asDateTime(123L)));
             assertEquals((byte) -123, conversion.convert(asDateTime(-123L)));
-            Exception e = expectThrows(SqlIllegalArgumentException.class,
+            Exception e = expectThrows(QlIllegalArgumentException.class,
                 () -> conversion.convert(asDateTime(Integer.MAX_VALUE)));
             assertEquals("[" + Integer.MAX_VALUE + "] out of [byte] range", e.getMessage());
         }
@@ -657,13 +653,13 @@ public void testCommonType() {
     public void testEsDataTypes() {
         for (DataType type : values()) {
             if (type != DATE) { // Doesn't have a corresponding type in ES
-                assertEquals(type, fromTypeName(type.typeName));
+                assertEquals(type, fromTypeName(type.typeName()));
             }
         }
     }
 
     public void testConversionToUnsupported() {
-            Exception e = expectThrows(SqlIllegalArgumentException.class,
+        Exception e = expectThrows(QlIllegalArgumentException.class,
                 () -> conversionFor(INTEGER, UNSUPPORTED));
             assertEquals("cannot convert from [integer] to [unsupported]", e.getMessage());
     }
@@ -672,7 +668,7 @@ public void testStringToIp() {
         Conversion conversion = conversionFor(KEYWORD, IP);
         assertNull(conversion.convert(null));
         assertEquals("192.168.1.1", conversion.convert("192.168.1.1"));
-        Exception e = expectThrows(SqlIllegalArgumentException.class, () -> conversion.convert("10.1.1.300"));
+        Exception e = expectThrows(QlIllegalArgumentException.class, () -> conversion.convert("10.1.1.300"));
         assertEquals("[10.1.1.300] is not a valid IPv4 or IPv6 address", e.getMessage());
     }
 
@@ -687,4 +683,16 @@ public void testIpToString() {
     private DataType randomInterval() {
         return randomFrom(Stream.of(DataType.values()).filter(DataType::isInterval).collect(Collectors.toList()));
     }
+
+    static ZonedDateTime date(long millisSinceEpoch) {
+        return DateUtils.asDateOnly(millisSinceEpoch);
+    }
+
+    static ZonedDateTime dateTime(long millisSinceEpoch) {
+        return DateUtils.asDateTime(millisSinceEpoch);
+    }
+
+    static OffsetTime time(long millisSinceEpoch) {
+        return DateUtils.asTimeOnly(millisSinceEpoch);
+    }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/DataTypesTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypesTests.java
similarity index 76%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/DataTypesTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypesTests.java
index 5b0111b5998a7..bfc6282340ecd 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/DataTypesTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypesTests.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import org.elasticsearch.test.ESTestCase;
 
@@ -14,36 +14,36 @@
 import java.util.stream.Stream;
 
 import static java.util.stream.Collectors.toList;
-import static org.elasticsearch.xpack.sql.type.DataType.DATETIME;
-import static org.elasticsearch.xpack.sql.type.DataType.FLOAT;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_HOUR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_DAY_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR_TO_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_HOUR_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MINUTE;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MINUTE_TO_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_MONTH;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_SECOND;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR;
-import static org.elasticsearch.xpack.sql.type.DataType.INTERVAL_YEAR_TO_MONTH;
-import static org.elasticsearch.xpack.sql.type.DataType.KEYWORD;
-import static org.elasticsearch.xpack.sql.type.DataType.LONG;
-import static org.elasticsearch.xpack.sql.type.DataTypes.compatibleInterval;
-import static org.elasticsearch.xpack.sql.type.DataTypes.metaSqlDataType;
-import static org.elasticsearch.xpack.sql.type.DataTypes.metaSqlDateTimeSub;
-import static org.elasticsearch.xpack.sql.type.DataTypes.metaSqlMaximumScale;
-import static org.elasticsearch.xpack.sql.type.DataTypes.metaSqlMinimumScale;
-import static org.elasticsearch.xpack.sql.type.DataTypes.metaSqlRadix;
+import static org.elasticsearch.xpack.ql.type.DataType.DATETIME;
+import static org.elasticsearch.xpack.ql.type.DataType.FLOAT;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_HOUR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_DAY_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR_TO_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_HOUR_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MINUTE;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MINUTE_TO_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_MONTH;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_SECOND;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR;
+import static org.elasticsearch.xpack.ql.type.DataType.INTERVAL_YEAR_TO_MONTH;
+import static org.elasticsearch.xpack.ql.type.DataType.KEYWORD;
+import static org.elasticsearch.xpack.ql.type.DataType.LONG;
+import static org.elasticsearch.xpack.ql.type.DataTypes.compatibleInterval;
+import static org.elasticsearch.xpack.ql.type.DataTypes.metaSqlDataType;
+import static org.elasticsearch.xpack.ql.type.DataTypes.metaSqlDateTimeSub;
+import static org.elasticsearch.xpack.ql.type.DataTypes.metaSqlMaximumScale;
+import static org.elasticsearch.xpack.ql.type.DataTypes.metaSqlMinimumScale;
+import static org.elasticsearch.xpack.ql.type.DataTypes.metaSqlRadix;
 
 public class DataTypesTests extends ESTestCase {
 
     public void testMetaDataType() {
         assertEquals(Integer.valueOf(9), metaSqlDataType(DATETIME));
         DataType t = randomDataTypeNoDateTime();
-        assertEquals(t.sqlType.getVendorTypeNumber(), metaSqlDataType(t));
+        assertEquals(t.sqlType().getVendorTypeNumber(), metaSqlDataType(t));
     }
 
     public void testMetaDateTypeSub() {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/TypesTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/TypesTests.java
similarity index 92%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/TypesTests.java
rename to x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/TypesTests.java
index 997de6e2f5c53..9fc3fdb0b7594 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/type/TypesTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/TypesTests.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.type;
+package org.elasticsearch.xpack.ql.type;
 
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
@@ -13,12 +13,12 @@
 import java.util.Map;
 
 import static java.util.Collections.emptyMap;
-import static org.elasticsearch.xpack.sql.type.DataType.DATETIME;
-import static org.elasticsearch.xpack.sql.type.DataType.INTEGER;
-import static org.elasticsearch.xpack.sql.type.DataType.KEYWORD;
-import static org.elasticsearch.xpack.sql.type.DataType.NESTED;
-import static org.elasticsearch.xpack.sql.type.DataType.OBJECT;
-import static org.elasticsearch.xpack.sql.type.DataType.TEXT;
+import static org.elasticsearch.xpack.ql.type.DataType.DATETIME;
+import static org.elasticsearch.xpack.ql.type.DataType.INTEGER;
+import static org.elasticsearch.xpack.ql.type.DataType.KEYWORD;
+import static org.elasticsearch.xpack.ql.type.DataType.NESTED;
+import static org.elasticsearch.xpack.ql.type.DataType.OBJECT;
+import static org.elasticsearch.xpack.ql.type.DataType.TEXT;
 import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.is;
 
@@ -172,22 +172,22 @@ public void testGeoField() {
         Map<String, EsField> mapping = loadMapping("mapping-geo.json");
         assertThat(mapping.size(), is(2));
         EsField gp = mapping.get("location");
-        assertThat(gp.getDataType().typeName, is("geo_point"));
+        assertThat(gp.getDataType().typeName(), is("geo_point"));
         EsField gs = mapping.get("site");
-        assertThat(gs.getDataType().typeName, is("geo_shape"));
+        assertThat(gs.getDataType().typeName(), is("geo_shape"));
     }
 
     public void testIpField() {
         Map<String, EsField> mapping = loadMapping("mapping-ip.json");
         assertThat(mapping.size(), is(1));
         EsField dt = mapping.get("ip_addr");
-        assertThat(dt.getDataType().typeName, is("ip"));
+        assertThat(dt.getDataType().typeName(), is("ip"));
     }
 
     public void testUnsupportedTypes() {
         Map<String, EsField> mapping = loadMapping("mapping-unsupported.json");
         EsField dt = mapping.get("range");
-        assertThat(dt.getDataType().typeName, is("unsupported"));
+        assertThat(dt.getDataType().typeName(), is("unsupported"));
     }
 
     public static Map<String, EsField> loadMapping(String name) {
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-basic-incompatible.json b/x-pack/plugin/ql/src/test/resources/mapping-basic-incompatible.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-basic-incompatible.json
rename to x-pack/plugin/ql/src/test/resources/mapping-basic-incompatible.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-basic-nodocvalues.json b/x-pack/plugin/ql/src/test/resources/mapping-basic-nodocvalues.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-basic-nodocvalues.json
rename to x-pack/plugin/ql/src/test/resources/mapping-basic-nodocvalues.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-basic.json b/x-pack/plugin/ql/src/test/resources/mapping-basic.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-basic.json
rename to x-pack/plugin/ql/src/test/resources/mapping-basic.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-date-multi.json b/x-pack/plugin/ql/src/test/resources/mapping-date-multi.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-date-multi.json
rename to x-pack/plugin/ql/src/test/resources/mapping-date-multi.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-date-no-format.json b/x-pack/plugin/ql/src/test/resources/mapping-date-no-format.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-date-no-format.json
rename to x-pack/plugin/ql/src/test/resources/mapping-date-no-format.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-date.json b/x-pack/plugin/ql/src/test/resources/mapping-date.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-date.json
rename to x-pack/plugin/ql/src/test/resources/mapping-date.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-default-string.json b/x-pack/plugin/ql/src/test/resources/mapping-default-string.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-default-string.json
rename to x-pack/plugin/ql/src/test/resources/mapping-default-string.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-docvalues.json b/x-pack/plugin/ql/src/test/resources/mapping-docvalues.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-docvalues.json
rename to x-pack/plugin/ql/src/test/resources/mapping-docvalues.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-dotted-field.json b/x-pack/plugin/ql/src/test/resources/mapping-dotted-field.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-dotted-field.json
rename to x-pack/plugin/ql/src/test/resources/mapping-dotted-field.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-geo.json b/x-pack/plugin/ql/src/test/resources/mapping-geo.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-geo.json
rename to x-pack/plugin/ql/src/test/resources/mapping-geo.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-ip.json b/x-pack/plugin/ql/src/test/resources/mapping-ip.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-ip.json
rename to x-pack/plugin/ql/src/test/resources/mapping-ip.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-keyword.json b/x-pack/plugin/ql/src/test/resources/mapping-keyword.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-keyword.json
rename to x-pack/plugin/ql/src/test/resources/mapping-keyword.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-multi-field-options.json b/x-pack/plugin/ql/src/test/resources/mapping-multi-field-options.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-multi-field-options.json
rename to x-pack/plugin/ql/src/test/resources/mapping-multi-field-options.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-multi-field-variation.json b/x-pack/plugin/ql/src/test/resources/mapping-multi-field-variation.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-multi-field-variation.json
rename to x-pack/plugin/ql/src/test/resources/mapping-multi-field-variation.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-multi-field-with-nested.json b/x-pack/plugin/ql/src/test/resources/mapping-multi-field-with-nested.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-multi-field-with-nested.json
rename to x-pack/plugin/ql/src/test/resources/mapping-multi-field-with-nested.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-multi-field.json b/x-pack/plugin/ql/src/test/resources/mapping-multi-field.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-multi-field.json
rename to x-pack/plugin/ql/src/test/resources/mapping-multi-field.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-nested.json b/x-pack/plugin/ql/src/test/resources/mapping-nested.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-nested.json
rename to x-pack/plugin/ql/src/test/resources/mapping-nested.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-numeric.json b/x-pack/plugin/ql/src/test/resources/mapping-numeric.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-numeric.json
rename to x-pack/plugin/ql/src/test/resources/mapping-numeric.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-object.json b/x-pack/plugin/ql/src/test/resources/mapping-object.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-object.json
rename to x-pack/plugin/ql/src/test/resources/mapping-object.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-parent-child.json b/x-pack/plugin/ql/src/test/resources/mapping-parent-child.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-parent-child.json
rename to x-pack/plugin/ql/src/test/resources/mapping-parent-child.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-text.json b/x-pack/plugin/ql/src/test/resources/mapping-text.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-text.json
rename to x-pack/plugin/ql/src/test/resources/mapping-text.json
diff --git a/x-pack/plugin/sql/src/test/resources/mapping-unsupported.json b/x-pack/plugin/ql/src/test/resources/mapping-unsupported.json
similarity index 100%
rename from x-pack/plugin/sql/src/test/resources/mapping-unsupported.json
rename to x-pack/plugin/ql/src/test/resources/mapping-unsupported.json
diff --git a/x-pack/plugin/sql/build.gradle b/x-pack/plugin/sql/build.gradle
index d9889dafc266b..e93099ec4b7a4 100644
--- a/x-pack/plugin/sql/build.gradle
+++ b/x-pack/plugin/sql/build.gradle
@@ -5,7 +5,7 @@ esplugin {
   name 'x-pack-sql'
   description 'The Elasticsearch plugin that powers SQL for Elasticsearch'
   classname 'org.elasticsearch.xpack.sql.plugin.SqlPlugin'
-  extendedPlugins = ['x-pack-core', 'lang-painless']
+  extendedPlugins = ['x-pack-ql', 'lang-painless']
 }
 
 ext {
@@ -44,14 +44,15 @@ dependencies {
   }
   compile project('sql-action')
   compile project(':modules:aggs-matrix-stats')
-  compile "org.antlr:antlr4-runtime:4.5.3"
+  compile "org.antlr:antlr4-runtime:${antlrVersion}"
+  compileOnly project(path: xpackModule('ql'), configuration: 'default')
   testCompile project(':test:framework')
   testCompile project(path: xpackModule('core'), configuration: 'testArtifacts')
   testCompile project(path: xpackModule('security'), configuration: 'testArtifacts')
+  testCompile project(path: xpackModule('ql'), configuration: 'testArtifacts')
   testCompile project(path: ':modules:reindex', configuration: 'runtime')
   testCompile project(path: ':modules:parent-join', configuration: 'runtime')
   testCompile project(path: ':modules:analysis-common', configuration: 'runtime')
-
   bin(project(path: xpackModule('sql:sql-cli'), configuration: 'shadow'))
 }
 
diff --git a/x-pack/plugin/sql/sql-proto/src/main/java/org/elasticsearch/xpack/sql/proto/StringUtils.java b/x-pack/plugin/sql/sql-proto/src/main/java/org/elasticsearch/xpack/sql/proto/StringUtils.java
index 780fce2604c04..d0c4c0f0b35ee 100644
--- a/x-pack/plugin/sql/sql-proto/src/main/java/org/elasticsearch/xpack/sql/proto/StringUtils.java
+++ b/x-pack/plugin/sql/sql-proto/src/main/java/org/elasticsearch/xpack/sql/proto/StringUtils.java
@@ -42,28 +42,28 @@ public final class StringUtils {
             .toFormatter(Locale.ROOT);
 
     public static final DateTimeFormatter ISO_DATE_WITH_NANOS = new DateTimeFormatterBuilder()
-        .parseCaseInsensitive()
-        .append(ISO_LOCAL_DATE)
-        .appendLiteral('T')
-        .appendValue(HOUR_OF_DAY, 2)
-        .appendLiteral(':')
-        .appendValue(MINUTE_OF_HOUR, 2)
-        .appendLiteral(':')
-        .appendValue(SECOND_OF_MINUTE, 2)
-        .appendFraction(NANO_OF_SECOND, 3, 9, true)
-        .appendOffsetId()
-        .toFormatter(Locale.ROOT);
+            .parseCaseInsensitive()
+            .append(ISO_LOCAL_DATE)
+            .appendLiteral('T')
+            .appendValue(HOUR_OF_DAY, 2)
+            .appendLiteral(':')
+            .appendValue(MINUTE_OF_HOUR, 2)
+            .appendLiteral(':')
+            .appendValue(SECOND_OF_MINUTE, 2)
+            .appendFraction(NANO_OF_SECOND, 3, 9, true)
+            .appendOffsetId()
+            .toFormatter(Locale.ROOT);
 
     public static final DateTimeFormatter ISO_TIME_WITH_MILLIS = new DateTimeFormatterBuilder()
-        .parseCaseInsensitive()
-        .appendValue(HOUR_OF_DAY, 2)
-        .appendLiteral(':')
-        .appendValue(MINUTE_OF_HOUR, 2)
-        .appendLiteral(':')
-        .appendValue(SECOND_OF_MINUTE, 2)
-        .appendFraction(MILLI_OF_SECOND, 3, 3, true)
-        .appendOffsetId()
-        .toFormatter(Locale.ROOT);
+            .parseCaseInsensitive()
+            .appendValue(HOUR_OF_DAY, 2)
+            .appendLiteral(':')
+            .appendValue(MINUTE_OF_HOUR, 2)
+            .appendLiteral(':')
+            .appendValue(SECOND_OF_MINUTE, 2)
+            .appendFraction(MILLI_OF_SECOND, 3, 3, true)
+            .appendOffsetId()
+            .toFormatter(Locale.ROOT);
 
     private static final int SECONDS_PER_MINUTE = 60;
     private static final int SECONDS_PER_HOUR = SECONDS_PER_MINUTE * 60;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/ClientSqlException.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlClientException.java
similarity index 57%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/ClientSqlException.java
rename to x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlClientException.java
index accca2a6a45b6..0e177c4fd3d2a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/ClientSqlException.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlClientException.java
@@ -5,25 +5,27 @@
  */
 package org.elasticsearch.xpack.sql;
 
-public abstract class ClientSqlException extends SqlException {
+import org.elasticsearch.xpack.ql.QlClientException;
 
-    protected ClientSqlException(String message, Object... args) {
+public abstract class SqlClientException extends QlClientException {
+
+    protected SqlClientException(String message, Object... args) {
         super(message, args);
     }
 
-    protected ClientSqlException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
+    protected SqlClientException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
         super(message, cause, enableSuppression, writableStackTrace);
     }
 
-    protected ClientSqlException(String message, Throwable cause) {
+    protected SqlClientException(String message, Throwable cause) {
         super(message, cause);
     }
 
-    protected ClientSqlException(Throwable cause, String message, Object... args) {
+    protected SqlClientException(Throwable cause, String message, Object... args) {
         super(cause, message, args);
     }
 
-    protected ClientSqlException(Throwable cause) {
+    protected SqlClientException(Throwable cause) {
         super(cause);
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlIllegalArgumentException.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlIllegalArgumentException.java
index be121a0ace4df..27ad608c80f06 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlIllegalArgumentException.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlIllegalArgumentException.java
@@ -5,7 +5,9 @@
  */
 package org.elasticsearch.xpack.sql;
 
-public class SqlIllegalArgumentException extends ServerSqlException {
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+
+public class SqlIllegalArgumentException extends QlIllegalArgumentException {
     public SqlIllegalArgumentException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
         super(message, cause, enableSuppression, writableStackTrace);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/ServerSqlException.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlServerException.java
similarity index 57%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/ServerSqlException.java
rename to x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlServerException.java
index e8548ab7f93ce..319e2b065d9ff 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/ServerSqlException.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/SqlServerException.java
@@ -5,25 +5,27 @@
  */
 package org.elasticsearch.xpack.sql;
 
-public abstract class ServerSqlException extends SqlException {
+import org.elasticsearch.xpack.ql.QlServerException;
 
-    protected ServerSqlException(String message, Object... args) {
+public abstract class SqlServerException extends QlServerException {
+
+    protected SqlServerException(String message, Object... args) {
         super(message, args);
     }
 
-    protected ServerSqlException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
+    protected SqlServerException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
         super(message, cause, enableSuppression, writableStackTrace);
     }
 
-    protected ServerSqlException(String message, Throwable cause) {
+    protected SqlServerException(String message, Throwable cause) {
         super(message, cause);
     }
 
-    protected ServerSqlException(Throwable cause, String message, Object... args) {
+    protected SqlServerException(Throwable cause, String message, Object... args) {
         super(cause, message, args);
     }
 
-    protected ServerSqlException(Throwable cause) {
+    protected SqlServerException(Throwable cause) {
         super(cause);
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/AnalysisException.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/AnalysisException.java
index 262d62814e164..4d3a799467ea8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/AnalysisException.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/AnalysisException.java
@@ -6,13 +6,13 @@
 package org.elasticsearch.xpack.sql.analysis;
 
 import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.xpack.sql.ClientSqlException;
-import org.elasticsearch.xpack.sql.tree.Location;
-import org.elasticsearch.xpack.sql.tree.Node;
+import org.elasticsearch.xpack.ql.tree.Location;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.sql.SqlClientException;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 
-public class AnalysisException extends ClientSqlException {
+public class AnalysisException extends SqlClientException {
 
     private final int line;
     private final int column;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
index 030d059ccfbd2..5119378d6462b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
@@ -6,55 +6,55 @@
 package org.elasticsearch.xpack.sql.analysis.analyzer;
 
 import org.elasticsearch.common.logging.LoggerMessageFormat;
+import org.elasticsearch.xpack.ql.capabilities.Resolvables;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeMap;
+import org.elasticsearch.xpack.ql.expression.AttributeSet;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.expression.ReferenceAttribute;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAlias;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.expression.UnresolvedStar;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.FunctionDefinition;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.expression.function.Functions;
+import org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.ArithmeticOperation;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.plan.TableIdentifier;
+import org.elasticsearch.xpack.ql.plan.logical.Aggregate;
+import org.elasticsearch.xpack.ql.plan.logical.EsRelation;
+import org.elasticsearch.xpack.ql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.OrderBy;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.plan.logical.UnaryPlan;
+import org.elasticsearch.xpack.ql.plan.logical.UnresolvedRelation;
+import org.elasticsearch.xpack.ql.rule.Rule;
+import org.elasticsearch.xpack.ql.rule.RuleExecutor;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.type.DataTypes;
+import org.elasticsearch.xpack.ql.type.InvalidMappedField;
+import org.elasticsearch.xpack.ql.type.UnsupportedEsField;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
+import org.elasticsearch.xpack.ql.util.Holder;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier.Failure;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.capabilities.Resolvables;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.AttributeSet;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
 import org.elasticsearch.xpack.sql.expression.SubQueryExpression;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAlias;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
-import org.elasticsearch.xpack.sql.expression.UnresolvedStar;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.FunctionDefinition;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
-import org.elasticsearch.xpack.sql.expression.function.Functions;
-import org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.ArithmeticOperation;
-import org.elasticsearch.xpack.sql.plan.TableIdentifier;
-import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
-import org.elasticsearch.xpack.sql.plan.logical.EsRelation;
-import org.elasticsearch.xpack.sql.plan.logical.Filter;
 import org.elasticsearch.xpack.sql.plan.logical.Join;
 import org.elasticsearch.xpack.sql.plan.logical.LocalRelation;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.plan.logical.SubQueryAlias;
-import org.elasticsearch.xpack.sql.plan.logical.UnaryPlan;
-import org.elasticsearch.xpack.sql.plan.logical.UnresolvedRelation;
 import org.elasticsearch.xpack.sql.plan.logical.With;
-import org.elasticsearch.xpack.sql.rule.Rule;
-import org.elasticsearch.xpack.sql.rule.RuleExecutor;
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
-import org.elasticsearch.xpack.sql.type.DataTypes;
-import org.elasticsearch.xpack.sql.type.InvalidMappedField;
-import org.elasticsearch.xpack.sql.type.UnsupportedEsField;
-import org.elasticsearch.xpack.sql.util.CollectionUtils;
-import org.elasticsearch.xpack.sql.util.Holder;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -70,7 +70,7 @@
 import static java.util.Collections.emptyList;
 import static java.util.Collections.singletonList;
 import static java.util.stream.Collectors.toList;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 
 public class Analyzer extends RuleExecutor<LogicalPlan> {
     /**
@@ -223,7 +223,7 @@ else if (DataTypes.isUnsupported(fa.dataType())) {
             // compound fields
             else if (allowCompound == false && fa.dataType().isPrimitive() == false) {
                 named = u.withUnresolvedMessage(
-                        "Cannot use field [" + fa.name() + "] type [" + fa.dataType().typeName + "] only its subfields");
+                        "Cannot use field [" + fa.name() + "] type [" + fa.dataType().typeName() + "] only its subfields");
             }
         }
         return named;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/PreAnalyzer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/PreAnalyzer.java
index 16e35cd8638a2..efe044f64f77d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/PreAnalyzer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/PreAnalyzer.java
@@ -5,8 +5,8 @@
  */
 package org.elasticsearch.xpack.sql.analysis.analyzer;
 
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.UnresolvedRelation;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.UnresolvedRelation;
 
 import java.util.ArrayList;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/TableInfo.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/TableInfo.java
index 479b094fad5bc..e12659c2c2ab7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/TableInfo.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/TableInfo.java
@@ -6,7 +6,7 @@
 
 package org.elasticsearch.xpack.sql.analysis.analyzer;
 
-import org.elasticsearch.xpack.sql.plan.TableIdentifier;
+import org.elasticsearch.xpack.ql.plan.TableIdentifier;
 
 public class TableInfo {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerificationException.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerificationException.java
index 14281a628b163..0eba4126ba850 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerificationException.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerificationException.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.analysis.analyzer;
 
+import org.elasticsearch.xpack.ql.tree.Location;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.analysis.AnalysisException;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier.Failure;
-import org.elasticsearch.xpack.sql.tree.Location;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.util.Collection;
 import java.util.stream.Collectors;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Verifier.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Verifier.java
index 34def1238d00f..d71ff27eaa0f9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Verifier.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Verifier.java
@@ -5,46 +5,46 @@
  */
 package org.elasticsearch.xpack.sql.analysis.analyzer;
 
-import org.elasticsearch.xpack.sql.capabilities.Unresolvable;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.AttributeSet;
+import org.elasticsearch.xpack.ql.capabilities.Unresolvable;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeMap;
+import org.elasticsearch.xpack.ql.expression.AttributeSet;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.ReferenceAttribute;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.Functions;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.plan.logical.Aggregate;
+import org.elasticsearch.xpack.ql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.plan.logical.Limit;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.OrderBy;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypes;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.util.Holder;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.expression.Exists;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.Functions;
 import org.elasticsearch.xpack.sql.expression.function.Score;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Max;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Min;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
 import org.elasticsearch.xpack.sql.plan.logical.Distinct;
-import org.elasticsearch.xpack.sql.plan.logical.Filter;
-import org.elasticsearch.xpack.sql.plan.logical.Limit;
 import org.elasticsearch.xpack.sql.plan.logical.LocalRelation;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.stats.FeatureMetric;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.tree.Node;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.util.Holder;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.util.ArrayList;
 import java.util.BitSet;
@@ -60,6 +60,9 @@
 
 import static java.util.stream.Collectors.toMap;
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
+import static org.elasticsearch.xpack.ql.type.DataType.GEO_SHAPE;
+import static org.elasticsearch.xpack.ql.type.DataType.SHAPE;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 import static org.elasticsearch.xpack.sql.stats.FeatureMetric.COMMAND;
 import static org.elasticsearch.xpack.sql.stats.FeatureMetric.GROUPBY;
 import static org.elasticsearch.xpack.sql.stats.FeatureMetric.HAVING;
@@ -67,9 +70,6 @@
 import static org.elasticsearch.xpack.sql.stats.FeatureMetric.LOCAL;
 import static org.elasticsearch.xpack.sql.stats.FeatureMetric.ORDERBY;
 import static org.elasticsearch.xpack.sql.stats.FeatureMetric.WHERE;
-import static org.elasticsearch.xpack.sql.type.DataType.GEO_SHAPE;
-import static org.elasticsearch.xpack.sql.type.DataType.SHAPE;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
 
 /**
  * The verifier has the role of checking the analyzed tree for failures and build a list of failures following this check.
@@ -490,7 +490,7 @@ private static boolean onlyExactFields(List<Expression> expressions, Set<Failure
                 EsField.Exact exact = c.getExactInfo();
                 if (exact.hasExact() == false) {
                 localFailures.add(fail(c, "Field [{}] of data type [{}] cannot be used for grouping; {}", c.sourceText(),
-                        c.dataType().typeName, exact.errorMsg()));
+                        c.dataType().typeName(), exact.errorMsg()));
                 onlyExact.set(Boolean.FALSE);
                 }
             }, FieldAttribute.class));
@@ -522,7 +522,7 @@ private static boolean checkGroupByTime(LogicalPlan p, Set<Failure> localFailure
             // https://github.com/elastic/elasticsearch/issues/40639
             a.groupings().forEach(f -> {
                 if (f.dataType().isTimeBased()) {
-                    localFailures.add(fail(f, "Function [" + f.sourceText()  + "] with data type [" + f.dataType().typeName +
+                    localFailures.add(fail(f, "Function [" + f.sourceText() + "] with data type [" + f.dataType().typeName() +
                         "] " + "cannot be used for grouping"));
                 }
             });
@@ -812,7 +812,7 @@ else if (ex.foldable() && ex.fold() == null) {
                 // and that their type is compatible with that of the column
                 else if (DataTypes.areTypesCompatible(colType, v.dataType()) == false) {
                     localFailures.add(fail(v, "Literal [{}] of type [{}] does not match type [{}] of PIVOT column [{}]", v.name(),
-                            v.dataType().typeName, colType.typeName, pv.column().sourceText()));
+                            v.dataType().typeName(), colType.typeName(), pv.column().sourceText()));
                 }
             }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/PlanExecutor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/PlanExecutor.java
index ca394bf11d881..d43f43da39206 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/PlanExecutor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/PlanExecutor.java
@@ -9,11 +9,12 @@
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.index.IndexResolver;
 import org.elasticsearch.xpack.sql.analysis.analyzer.PreAnalyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver;
 import org.elasticsearch.xpack.sql.execution.search.SourceGenerator;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer;
 import org.elasticsearch.xpack.sql.plan.physical.CommandExec;
 import org.elasticsearch.xpack.sql.plan.physical.EsQueryExec;
@@ -51,7 +52,7 @@ public PlanExecutor(Client client, IndexResolver indexResolver, NamedWriteableRe
         this.writableRegistry = writeableRegistry;
 
         this.indexResolver = indexResolver;
-        this.functionRegistry = new FunctionRegistry();
+        this.functionRegistry = new SqlFunctionRegistry();
         
         this.metrics = new Metrics();
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggCursor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggCursor.java
index 4f448f049f9bb..c165343f20371 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggCursor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggCursor.java
@@ -22,14 +22,14 @@
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeAggregation;
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeAggregationBuilder;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.type.Schema;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
 import org.elasticsearch.xpack.sql.querydsl.agg.Aggs;
 import org.elasticsearch.xpack.sql.session.Configuration;
 import org.elasticsearch.xpack.sql.session.Cursor;
 import org.elasticsearch.xpack.sql.session.Rows;
-import org.elasticsearch.xpack.sql.type.Schema;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.io.IOException;
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggRowSet.java
index 1262e80e06636..0385ba34de229 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggRowSet.java
@@ -7,7 +7,7 @@
 
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeAggregation;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
 import org.elasticsearch.xpack.sql.session.RowSet;
 
 import java.util.BitSet;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/PivotCursor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/PivotCursor.java
index a815602d950bb..356f2bc4ad950 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/PivotCursor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/PivotCursor.java
@@ -9,8 +9,8 @@
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
-import org.elasticsearch.xpack.sql.type.Schema;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.type.Schema;
 
 import java.io.IOException;
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/PivotRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/PivotRowSet.java
index 3d7e12b3d9b09..082b9f920fd62 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/PivotRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/PivotRowSet.java
@@ -8,8 +8,8 @@
 
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeAggregation;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
-import org.elasticsearch.xpack.sql.type.Schema;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.type.Schema;
 
 import java.util.ArrayList;
 import java.util.BitSet;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
index d8cf81b539427..0645f274b4342 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
@@ -26,24 +26,27 @@
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
 import org.elasticsearch.search.aggregations.bucket.filter.Filters;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.ComputingExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.ConstantExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.AggExtractorInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.AggPathInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.HitExtractorInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.ReferenceInput;
+import org.elasticsearch.xpack.ql.index.IndexResolver;
+import org.elasticsearch.xpack.ql.type.Schema;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver;
 import org.elasticsearch.xpack.sql.execution.PlanExecutor;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
 import org.elasticsearch.xpack.sql.execution.search.extractor.CompositeKeyExtractor;
-import org.elasticsearch.xpack.sql.execution.search.extractor.ComputingExtractor;
-import org.elasticsearch.xpack.sql.execution.search.extractor.ConstantExtractor;
 import org.elasticsearch.xpack.sql.execution.search.extractor.FieldHitExtractor;
-import org.elasticsearch.xpack.sql.execution.search.extractor.HitExtractor;
 import org.elasticsearch.xpack.sql.execution.search.extractor.MetricAggExtractor;
 import org.elasticsearch.xpack.sql.execution.search.extractor.PivotExtractor;
 import org.elasticsearch.xpack.sql.execution.search.extractor.TopHitsAggExtractor;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggExtractorInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggPathInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.HitExtractorInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.ReferenceInput;
 import org.elasticsearch.xpack.sql.planner.PlanningException;
 import org.elasticsearch.xpack.sql.querydsl.agg.Aggs;
 import org.elasticsearch.xpack.sql.querydsl.container.ComputedRef;
@@ -63,8 +66,6 @@
 import org.elasticsearch.xpack.sql.session.Rows;
 import org.elasticsearch.xpack.sql.session.SchemaRowSet;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.type.Schema;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -81,6 +82,7 @@
 
 import static java.util.Collections.singletonList;
 import static org.elasticsearch.action.ActionListener.wrap;
+
 // TODO: add retry/back-off
 public class Querier {
 
@@ -138,14 +140,11 @@ public void query(List<Attribute> output, QueryContainer query, String index, Ac
         client.search(search, l);
     }
 
-    public static SearchRequest prepareRequest(Client client, SearchSourceBuilder source, TimeValue timeout, boolean includeFrozen,
+    public static SearchRequest prepareRequest(Client client, SearchSourceBuilder source, TimeValue timeout, boolean includeFrozen, 
             String... indices) {
         return client.prepareSearch(indices)
                 // always track total hits accurately
-                .setTrackTotalHits(true)
-                .setAllowPartialSearchResults(false)
-                .setSource(source)
-                .setTimeout(timeout)
+                .setTrackTotalHits(true).setAllowPartialSearchResults(false).setSource(source).setTimeout(timeout)
                 .setIndicesOptions(
                         includeFrozen ? IndexResolver.FIELD_CAPS_FROZEN_INDICES_OPTIONS : IndexResolver.FIELD_CAPS_INDICES_OPTIONS)
                 .request();
@@ -226,7 +225,7 @@ private void consumeRowSet(RowSet rowSet) {
                 // if the queue overflows and no limit was specified, throw an error
                 if (data.insertWithOverflow(new Tuple<>(row, counter.getAndIncrement())) != null && noLimit) {
                     onFailure(new SqlIllegalArgumentException(
-                        "The default limit [{}] for aggregate sorting has been reached; please specify a LIMIT", MAXIMUM_SIZE));
+                            "The default limit [{}] for aggregate sorting has been reached; please specify a LIMIT", MAXIMUM_SIZE));
                 }
             }
         }
@@ -319,7 +318,7 @@ private void handleBuckets(List<? extends Bucket> buckets, SearchResponse respon
         }
     }
 
-        
+
     /**
      * Dedicated listener for composite aggs/group-by results.
      */
@@ -327,8 +326,8 @@ static class CompositeActionListener extends BaseAggActionListener {
 
         private final boolean isPivot;
 
-        CompositeActionListener(ActionListener<Page> listener, Client client, Configuration cfg,
-                List<Attribute> output, QueryContainer query, SearchRequest request) {
+        CompositeActionListener(ActionListener<Page> listener, Client client, Configuration cfg, List<Attribute> output,
+                QueryContainer query, SearchRequest request) {
             super(listener, client, cfg, output, query, request);
 
             isPivot = query.fields().stream().anyMatch(t -> t.v1() instanceof PivotColumnRef);
@@ -336,27 +335,19 @@ static class CompositeActionListener extends BaseAggActionListener {
 
         @Override
         protected void handleResponse(SearchResponse response, ActionListener<Page> listener) {
-            
-            Supplier<CompositeAggRowSet> makeRowSet = isPivot ?
-                    () -> new PivotRowSet(schema, initBucketExtractors(response), mask, response,
-                            query.sortingColumns().isEmpty() ? query.limit() : -1, null) :
-                    () -> new SchemaCompositeAggRowSet(schema, initBucketExtractors(response), mask, response,
-                            query.sortingColumns().isEmpty() ? query.limit() : -1);
-                    
-            BiFunction<byte[], CompositeAggRowSet, CompositeAggCursor> makeCursor = isPivot ?
-                    (q, r) -> {
-                        Map<String, Object> lastAfterKey = r instanceof PivotRowSet ? ((PivotRowSet) r).lastAfterKey() : null;
-                        return new PivotCursor(lastAfterKey, q, r.extractors(), r.mask(), r.remainingData(), query.shouldIncludeFrozen(),
-                                request.indices());
-                    } :
-                    (q, r) -> new CompositeAggCursor(q, r.extractors(), r.mask(), r.remainingData, query.shouldIncludeFrozen(),
-                            request.indices());
-                    
-            CompositeAggCursor.handle(response, request.source(),
-                    makeRowSet,
-                    makeCursor,
-                    () -> client.search(request, this),
-                    listener,
+
+            Supplier<CompositeAggRowSet> makeRowSet = isPivot ? () -> new PivotRowSet(schema, initBucketExtractors(response), mask,
+                    response, query.sortingColumns().isEmpty() ? query.limit() : -1, null) : () -> new SchemaCompositeAggRowSet(schema,
+                            initBucketExtractors(response), mask, response, query.sortingColumns().isEmpty() ? query.limit() : -1);
+
+            BiFunction<byte[], CompositeAggRowSet, CompositeAggCursor> makeCursor = isPivot ? (q, r) -> {
+                Map<String, Object> lastAfterKey = r instanceof PivotRowSet ? ((PivotRowSet) r).lastAfterKey() : null;
+                return new PivotCursor(lastAfterKey, q, r.extractors(), r.mask(), r.remainingData(), query.shouldIncludeFrozen(),
+                        request.indices());
+            } : (q, r) -> new CompositeAggCursor(q, r.extractors(), r.mask(), r.remainingData, query.shouldIncludeFrozen(),
+                    request.indices());
+
+            CompositeAggCursor.handle(response, request.source(), makeRowSet, makeCursor, () -> client.search(request, this), listener,
                     schema);
         }
     }
@@ -366,8 +357,8 @@ abstract static class BaseAggActionListener extends BaseActionListener {
         final SearchRequest request;
         final BitSet mask;
 
-        BaseAggActionListener(ActionListener<Page> listener, Client client, Configuration cfg, List<Attribute> output,
-                QueryContainer query, SearchRequest request) {
+        BaseAggActionListener(ActionListener<Page> listener, Client client, Configuration cfg, List<Attribute> output, QueryContainer query,
+                SearchRequest request) {
             super(listener, client, cfg, output);
 
             this.query = query;
@@ -436,8 +427,8 @@ static class ScrollActionListener extends BaseActionListener {
         private final BitSet mask;
         private final boolean multiValueFieldLeniency;
 
-        ScrollActionListener(ActionListener<Page> listener, Client client, Configuration cfg,
-                List<Attribute> output, QueryContainer query) {
+        ScrollActionListener(ActionListener<Page> listener, Client client, Configuration cfg, List<Attribute> output,
+                QueryContainer query) {
             super(listener, client, cfg, output);
             this.query = query;
             this.mask = query.columnMask(output);
@@ -456,15 +447,14 @@ protected void handleResponse(SearchResponse response, ActionListener<Page> list
 
             ScrollCursor.handle(response, () -> new SchemaSearchHitRowSet(schema, exts, mask, query.limit(), response),
                     p -> listener.onResponse(p),
-                    p -> clear(response.getScrollId(), wrap(success -> listener.onResponse(p), listener::onFailure)),
-                    schema);
+                    p -> clear(response.getScrollId(), wrap(success -> listener.onResponse(p), listener::onFailure)), schema);
         }
 
         private HitExtractor createExtractor(FieldExtraction ref) {
             if (ref instanceof SearchHitFieldRef) {
                 SearchHitFieldRef f = (SearchHitFieldRef) ref;
-                return new FieldHitExtractor(f.name(), f.fullFieldName(), f.getDataType(), cfg.zoneId(),
-                    f.useDocValue(), f.hitName(), multiValueFieldLeniency);
+                return new FieldHitExtractor(f.name(), f.fullFieldName(), f.getDataType(), cfg.zoneId(), f.useDocValue(), f.hitName(),
+                        multiValueFieldLeniency);
             }
 
             if (ref instanceof ScriptFieldRef) {
@@ -540,11 +530,11 @@ public void onResponse(final SearchResponse response) {
         protected final void cleanup(SearchResponse response, Exception ex) {
             if (response != null && response.getScrollId() != null) {
                 client.prepareClearScroll().addScrollId(response.getScrollId())
-                    // in case of failure, report the initial exception instead of the one resulting from cleaning the scroll
-                    .execute(ActionListener.wrap(r -> listener.onFailure(ex), e -> {
-                        ex.addSuppressed(e);
-                        listener.onFailure(ex);
-                    }));
+                        // in case of failure, report the initial exception instead of the one resulting from cleaning the scroll
+                        .execute(ActionListener.wrap(r -> listener.onFailure(ex), e -> {
+                            ex.addSuppressed(e);
+                            listener.onFailure(ex);
+                        }));
             } else {
                 listener.onFailure(ex);
             }
@@ -552,10 +542,8 @@ protected final void cleanup(SearchResponse response, Exception ex) {
 
         protected final void clear(String scrollId, ActionListener<Boolean> listener) {
             if (scrollId != null) {
-                client.prepareClearScroll().addScrollId(scrollId).execute(
-                        ActionListener.wrap(
-                                clearScrollResponse -> listener.onResponse(clearScrollResponse.isSucceeded()),
-                                listener::onFailure));
+                client.prepareClearScroll().addScrollId(scrollId).execute(ActionListener
+                        .wrap(clearScrollResponse -> listener.onResponse(clearScrollResponse.isSucceeded()), listener::onFailure));
             } else {
                 listener.onResponse(false);
             }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaCompositeAggRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaCompositeAggRowSet.java
index eb4d568f55707..40e3b5011b82a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaCompositeAggRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaCompositeAggRowSet.java
@@ -6,10 +6,10 @@
 package org.elasticsearch.xpack.sql.execution.search;
 
 import org.elasticsearch.action.search.SearchResponse;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.type.Schema;
 import org.elasticsearch.xpack.sql.session.RowSet;
 import org.elasticsearch.xpack.sql.session.SchemaRowSet;
-import org.elasticsearch.xpack.sql.type.Schema;
 
 import java.util.BitSet;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaDelegatingRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaDelegatingRowSet.java
index ccfe1ad55f25e..a1c39a3845c5e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaDelegatingRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaDelegatingRowSet.java
@@ -6,9 +6,9 @@
 
 package org.elasticsearch.xpack.sql.execution.search;
 
+import org.elasticsearch.xpack.ql.type.Schema;
 import org.elasticsearch.xpack.sql.session.RowSet;
 import org.elasticsearch.xpack.sql.session.SchemaRowSet;
-import org.elasticsearch.xpack.sql.type.Schema;
 
 class SchemaDelegatingRowSet implements SchemaRowSet {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaSearchHitRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaSearchHitRowSet.java
index 7ba7a06fd8a37..e142f8213bd3b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaSearchHitRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SchemaSearchHitRowSet.java
@@ -6,9 +6,9 @@
 package org.elasticsearch.xpack.sql.execution.search;
 
 import org.elasticsearch.action.search.SearchResponse;
-import org.elasticsearch.xpack.sql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.type.Schema;
 import org.elasticsearch.xpack.sql.session.SchemaRowSet;
-import org.elasticsearch.xpack.sql.type.Schema;
 
 import java.util.BitSet;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursor.java
index 55f78db40739d..5df6752198f3b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursor.java
@@ -19,11 +19,11 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.search.SearchHit;
-import org.elasticsearch.xpack.sql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.type.Schema;
 import org.elasticsearch.xpack.sql.session.Configuration;
 import org.elasticsearch.xpack.sql.session.Cursor;
 import org.elasticsearch.xpack.sql.session.Rows;
-import org.elasticsearch.xpack.sql.type.Schema;
 
 import java.io.IOException;
 import java.util.BitSet;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SearchHitRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SearchHitRowSet.java
index 5a11bfde64561..9db03f291a3ae 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SearchHitRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SearchHitRowSet.java
@@ -10,8 +10,8 @@
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.search.SearchHits;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.execution.search.extractor.HitExtractor;
 
 import java.util.ArrayList;
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SourceGenerator.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SourceGenerator.java
index 868dd2dcfffc0..453cdcde377ec 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SourceGenerator.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/SourceGenerator.java
@@ -15,8 +15,9 @@
 import org.elasticsearch.search.sort.NestedSortBuilder;
 import org.elasticsearch.search.sort.ScriptSortBuilder.ScriptSortType;
 import org.elasticsearch.search.sort.SortBuilder;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
 import org.elasticsearch.xpack.sql.querydsl.container.AttributeSort;
 import org.elasticsearch.xpack.sql.querydsl.container.QueryContainer;
 import org.elasticsearch.xpack.sql.querydsl.container.ScoreSort;
@@ -55,7 +56,7 @@ public static SearchSourceBuilder sourceBuilder(QueryContainer container, QueryB
         final SearchSourceBuilder source = new SearchSourceBuilder();
         source.query(finalQuery);
 
-        SqlSourceBuilder sortBuilder = new SqlSourceBuilder();
+        QlSourceBuilder sortBuilder = new QlSourceBuilder();
         // Iterate through all the columns requested, collecting the fields that
         // need to be retrieved from the result documents
 
@@ -122,12 +123,12 @@ private static void sorting(QueryContainer container, SearchSourceBuilder source
 
                     sortBuilder = fieldSort(fa.name())
                             .missing(as.missing().position())
-                            .unmappedType(fa.dataType().esType);
+                            .unmappedType(fa.dataType().esType());
                     
                     if (fa.isNested()) {
                         FieldSortBuilder fieldSort = fieldSort(fa.name())
                                 .missing(as.missing().position())
-                                .unmappedType(fa.dataType().esType);
+                                .unmappedType(fa.dataType().esType());
 
                         NestedSortBuilder newSort = new NestedSortBuilder(fa.nestedParent().name());
                         NestedSortBuilder nestedSort = fieldSort.getNestedSort();
@@ -164,8 +165,8 @@ private static void sorting(QueryContainer container, SearchSourceBuilder source
         }
     }
 
-    private static void optimize(SqlSourceBuilder sqlSource, SearchSourceBuilder builder) {
-        if (sqlSource.sourceFields.isEmpty()) {
+    private static void optimize(QlSourceBuilder sqlSource, SearchSourceBuilder builder) {
+        if (sqlSource.noSource()) {
             disableSource(builder);
         }
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/CompositeKeyExtractor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/CompositeKeyExtractor.java
index c4584eb80dc52..b70208c40ebd5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/CompositeKeyExtractor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/CompositeKeyExtractor.java
@@ -8,6 +8,7 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
 import org.elasticsearch.xpack.sql.querydsl.container.GroupByRef.Property;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/FieldHitExtractor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/FieldHitExtractor.java
index 9f61775cedc2c..046cf8401e5b6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/FieldHitExtractor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/FieldHitExtractor.java
@@ -6,102 +6,55 @@
 package org.elasticsearch.xpack.sql.execution.search.extractor;
 
 import org.elasticsearch.ElasticsearchParseException;
-import org.elasticsearch.Version;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.collect.Tuple;
-import org.elasticsearch.common.document.DocumentField;
 import org.elasticsearch.common.geo.GeoPoint;
 import org.elasticsearch.common.geo.GeoUtils;
 import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.index.mapper.IgnoredFieldMapper;
-import org.elasticsearch.search.SearchHit;
+import org.elasticsearch.xpack.ql.execution.search.extractor.AbstractFieldHitExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
-import org.elasticsearch.xpack.sql.type.DataType;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.io.IOException;
 import java.time.ZoneId;
-import java.util.ArrayDeque;
-import java.util.Deque;
 import java.util.List;
 import java.util.Map;
-import java.util.Objects;
-import java.util.StringJoiner;
 
 /**
  * Extractor for ES fields. Works for both 'normal' fields but also nested ones (which require hitName to be set).
  * The latter is used as metadata in assembling the results in the tabular response.
  */
-public class FieldHitExtractor implements HitExtractor {
+public class FieldHitExtractor extends AbstractFieldHitExtractor {
 
-    private static final Version SWITCHED_FROM_DOCVALUES_TO_SOURCE_EXTRACTION = Version.V_7_4_0;
     /**
      * Stands for {@code field}. We try to use short names for {@link HitExtractor}s
      * to save a few bytes when when we send them back to the user.
      */
     static final String NAME = "f";
 
-    /**
-     * Source extraction requires only the (relative) field name, without its parent path.
-     */
-    private static String[] sourcePath(String name, boolean useDocValue, String hitName) {
-        return useDocValue ? Strings.EMPTY_ARRAY : Strings
-                .tokenizeToStringArray(hitName == null ? name : name.substring(hitName.length() + 1), ".");
+    public FieldHitExtractor(String name, DataType dataType, ZoneId zoneId, boolean useDocValue, boolean arrayLeniency) {
+        super(name, dataType, zoneId, useDocValue, arrayLeniency);
     }
 
-    private final String fieldName, hitName;
-    private final String fullFieldName; // used to look at the _ignored section of the query response for the actual full field name
-    private final DataType dataType;
-    private final ZoneId zoneId;
-    private final boolean useDocValue;
-    private final boolean arrayLeniency;
-    private final String[] path;
-
     public FieldHitExtractor(String name, DataType dataType, ZoneId zoneId, boolean useDocValue) {
-        this(name, null, dataType, zoneId, useDocValue, null, false);
-    }
-
-    public FieldHitExtractor(String name, DataType dataType, ZoneId zoneId, boolean useDocValue, boolean arrayLeniency) {
-        this(name, null, dataType, zoneId, useDocValue, null, arrayLeniency);
+        super(name, dataType, zoneId, useDocValue);
     }
 
     public FieldHitExtractor(String name, String fullFieldName, DataType dataType, ZoneId zoneId, boolean useDocValue, String hitName,
             boolean arrayLeniency) {
-        this.fieldName = name;
-        this.fullFieldName = fullFieldName;
-        this.dataType = dataType;
-        this.zoneId = zoneId;
-        this.useDocValue = useDocValue;
-        this.arrayLeniency = arrayLeniency;
-        this.hitName = hitName;
-
-        if (hitName != null) {
-            if (!name.contains(hitName)) {
-                throw new SqlIllegalArgumentException("Hitname [{}] specified but not part of the name [{}]", hitName, name);
-            }
-        }
+        super(name, fullFieldName, dataType, zoneId, useDocValue, hitName, arrayLeniency);
+    }
 
-        this.path = sourcePath(fieldName, useDocValue, hitName);
+    public FieldHitExtractor(StreamInput in) throws IOException {
+        super(in);
     }
 
-    FieldHitExtractor(StreamInput in) throws IOException {
-        fieldName = in.readString();
-        if (in.getVersion().onOrAfter(SWITCHED_FROM_DOCVALUES_TO_SOURCE_EXTRACTION)) {
-            fullFieldName = in.readOptionalString();
-        } else {
-            fullFieldName = null;
-        }
-        String esType = in.readOptionalString();
-        dataType = esType != null ? DataType.fromTypeName(esType) : null;
-        useDocValue = in.readBoolean();
-        hitName = in.readOptionalString();
-        arrayLeniency = in.readBoolean();
-        path = sourcePath(fieldName, useDocValue, hitName);
 
-        zoneId = SqlStreamInput.asSqlStream(in).zoneId();
+    @Override
+    protected ZoneId readZoneId(StreamInput in) throws IOException {
+        return SqlStreamInput.asSqlStream(in).zoneId();
     }
 
     @Override
@@ -109,254 +62,68 @@ public String getWriteableName() {
         return NAME;
     }
 
+    // let's make sure first that we are not dealing with an geo_point represented as an array
     @Override
-    public void writeTo(StreamOutput out) throws IOException {
-        out.writeString(fieldName);
-        if (out.getVersion().onOrAfter(SWITCHED_FROM_DOCVALUES_TO_SOURCE_EXTRACTION)) {
-            out.writeOptionalString(fullFieldName);
+    protected boolean isPrimitive(List<?> list) {
+        return isGeoPointArray(list);
+    }
+
+    private boolean isGeoPointArray(List<?> list) {
+        if (dataType() != DataType.GEO_POINT) {
+            return false;
+        }
+        // we expect the point in [lon lat] or [lon lat alt] formats
+        if (list.size() > 3 || list.size() < 1) {
+            return false;
         }
-        out.writeOptionalString(dataType == null ? null : dataType.typeName);
-        out.writeBoolean(useDocValue);
-        out.writeOptionalString(hitName);
-        out.writeBoolean(arrayLeniency);
+        return list.get(0) instanceof Number;
     }
 
     @Override
-    public Object extract(SearchHit hit) {
-        Object value = null;
-        if (useDocValue) {
-            DocumentField field = hit.field(fieldName);
-            if (field != null) {
-                value = unwrapMultiValue(field.getValues());
-            }
-        } else {
-            // if the field was ignored because it was malformed and ignore_malformed was turned on
-            if (fullFieldName != null
-                    && hit.getFields().containsKey(IgnoredFieldMapper.NAME)
-                    && dataType.isFromDocValuesOnly() == false
-                    && dataType.isNumeric()) {
-                /*
-                 * ignore_malformed makes sense for extraction from _source for numeric fields only.
-                 * And we check here that the data type is actually a numeric one to rule out
-                 * any non-numeric sub-fields (for which the "parent" field should actually be extracted from _source).
-                 * For example, in the case of a malformed number, a "byte" field with "ignore_malformed: true"
-                 * with a "text" sub-field should return "null" for the "byte" parent field and the actual malformed
-                 * data for the "text" sub-field. Also, the _ignored section of the response contains the full field
-                 * name, thus the need to do the comparison with that and not only the field name.
-                 */
-                if (hit.getFields().get(IgnoredFieldMapper.NAME).getValues().contains(fullFieldName)) {
-                    return null;
-                }
-            }
-            Map<String, Object> source = hit.getSourceAsMap();
-            if (source != null) {
-                value = extractFromSource(source);
-            }
-        }
-        return value;
+    protected Object extractFromSource(Map<String, Object> map) {
+        return super.extractFromSource(map);
     }
 
-    private Object unwrapMultiValue(Object values) {
-        if (values == null) {
-            return null;
-        }
-        if (values instanceof List) {
-            List<?> list = (List<?>) values;
-            if (list.isEmpty()) {
-                return null;
-            } else {
-                // let's make sure first that we are not dealing with an geo_point represented as an array
-                if (isGeoPointArray(list) == false) {
-                    if (list.size() == 1 || arrayLeniency) {
-                        return unwrapMultiValue(list.get(0));
-                    } else {
-                        throw new SqlIllegalArgumentException("Arrays (returned by [{}]) are not supported", fieldName);
-                    }
-                }
-            }
-        }
+    @Override
+    protected Object unwrapCustomValue(Object values) {
+        DataType dataType = dataType();
+
         if (dataType == DataType.GEO_POINT) {
             try {
                 GeoPoint geoPoint = GeoUtils.parseGeoPoint(values, true);
                 return new GeoShape(geoPoint.lon(), geoPoint.lat());
             } catch (ElasticsearchParseException ex) {
-                throw new SqlIllegalArgumentException("Cannot parse geo_point value [{}] (returned by [{}])", values, fieldName);
+                throw new SqlIllegalArgumentException("Cannot parse geo_point value [{}] (returned by [{}])", values, fieldName());
             }
         }
         if (dataType == DataType.GEO_SHAPE) {
             try {
                 return new GeoShape(values);
             } catch (IOException ex) {
-                throw new SqlIllegalArgumentException("Cannot read geo_shape value [{}] (returned by [{}])", values, fieldName);
+                throw new SqlIllegalArgumentException("Cannot read geo_shape value [{}] (returned by [{}])", values, fieldName());
             }
         }
         if (dataType == DataType.SHAPE) {
             try {
                 return new GeoShape(values);
             } catch (IOException ex) {
-                throw new SqlIllegalArgumentException("Cannot read shape value [{}] (returned by [{}])", values, fieldName);
+                throw new SqlIllegalArgumentException("Cannot read shape value [{}] (returned by [{}])", values, fieldName());
             }
         }
         if (values instanceof Map) {
-            throw new SqlIllegalArgumentException("Objects (returned by [{}]) are not supported", fieldName);
+            throw new SqlIllegalArgumentException("Objects (returned by [{}]) are not supported", fieldName());
         }
         if (dataType == DataType.DATETIME) {
             if (values instanceof String) {
-                return DateUtils.asDateTime(Long.parseLong(values.toString()), zoneId);
-            }
-        }
-
-        // The Jackson json parser can generate for numerics - Integers, Longs, BigIntegers (if Long is not enough)
-        // and BigDecimal (if Double is not enough)
-        if (values instanceof Number || values instanceof String || values instanceof Boolean) {
-            if (dataType == null) {
-                return values;
-            }
-            if (dataType.isNumeric() && dataType.isFromDocValuesOnly() == false) {
-                if (dataType == DataType.DOUBLE || dataType == DataType.FLOAT || dataType == DataType.HALF_FLOAT) {
-                    Number result = null;
-                    try {
-                        result = dataType.numberType().parse(values, true);
-                    } catch(IllegalArgumentException iae) {
-                        return null;
-                    }
-                    // docvalue_fields is always returning a Double value even if the underlying floating point data type is not Double
-                    // even if we don't extract from docvalue_fields anymore, the behavior should be consistent
-                    return result.doubleValue();
-                } else {
-                    Number result = null;
-                    try {
-                        result = dataType.numberType().parse(values, true);
-                    } catch(IllegalArgumentException iae) {
-                        return null;
-                    }
-                    return result;
-                }
-            } else if (dataType.isString()) {
-                return values.toString();
-            } else {
-                return values;
-            }
-        }
-        throw new SqlIllegalArgumentException("Type {} (returned by [{}]) is not supported", values.getClass().getSimpleName(), fieldName);
-    }
-
-    private boolean isGeoPointArray(List<?> list) {
-        if (dataType != DataType.GEO_POINT) {
-            return false;
-        }
-        // we expect the point in [lon lat] or [lon lat alt] formats
-        if (list.size() > 3 || list.size() < 1) {
-            return false;
-        }
-        return list.get(0) instanceof Number;
-    }
-
-    @SuppressWarnings({ "unchecked", "rawtypes" })
-    Object extractFromSource(Map<String, Object> map) {
-        Object value = null;
-
-        // Used to avoid recursive method calls
-        // Holds the sub-maps in the document hierarchy that are pending to be inspected along with the current index of the `path`.
-        Deque<Tuple<Integer, Map<String, Object>>> queue = new ArrayDeque<>();
-        queue.add(new Tuple<>(-1, map));
-
-        while (!queue.isEmpty()) {
-            Tuple<Integer, Map<String, Object>> tuple = queue.removeLast();
-            int idx = tuple.v1();
-            Map<String, Object> subMap = tuple.v2();
-
-            // Find all possible entries by examining all combinations under the current level ("idx") of the "path"
-            // e.g.: If the path == "a.b.c.d" and the idx == 0, we need to check the current subMap against the keys:
-            //       "b", "b.c" and "b.c.d"
-            StringJoiner sj = new StringJoiner(".");
-            for (int i = idx + 1; i < path.length; i++) {
-                sj.add(path[i]);
-                Object node = subMap.get(sj.toString());
-
-                if (node instanceof List) {
-                    List listOfValues = (List) node;
-                    // we can only do this optimization until the last element of our pass since geo points are using arrays
-                    // and we don't want to blindly ignore the second element of array if arrayLeniency is enabled
-                    if ((i < path.length - 1) && (listOfValues.size() == 1 || arrayLeniency)) {
-                        // this is a List with a size of 1 e.g.: {"a" : [{"b" : "value"}]} meaning the JSON is a list with one element
-                        // or a list of values with one element e.g.: {"a": {"b" : ["value"]}}
-                        // in case of being lenient about arrays, just extract the first value in the array
-                        node = listOfValues.get(0);
-                    } else {
-                        // a List of elements with more than one value. Break early and let unwrapMultiValue deal with the list
-                        return unwrapMultiValue(node);
-                    }
-                }
-
-                if (node instanceof Map) {
-                    if (i < path.length - 1) {
-                        // Add the sub-map to the queue along with the current path index
-                        queue.add(new Tuple<>(i, (Map<String, Object>) node));
-                    } else {
-                        // We exhausted the path and got a map
-                        // If it is an object - it will be handled in the value extractor
-                        value = node;
-                    }
-                } else if (node != null) {
-                    if (i < path.length - 1) {
-                        // If we reach a concrete value without exhausting the full path, something is wrong with the mapping
-                        // e.g.: map is {"a" : { "b" : "value }} and we are looking for a path: "a.b.c.d"
-                        throw new SqlIllegalArgumentException("Cannot extract value [{}] from source", fieldName);
-                    }
-                    if (value != null) {
-                        // A value has already been found so this means that there are more than one
-                        // values in the document for the same path but different hierarchy.
-                        // e.g.: {"a" : {"b" : {"c" : "value"}}}, {"a.b" : {"c" : "value"}}, ...
-                        throw new SqlIllegalArgumentException("Multiple values (returned by [{}]) are not supported", fieldName);
-                    }
-                    value = node;
-                }
+                return DateUtils.asDateTime(Long.parseLong(values.toString()), zoneId());
             }
         }
-        return unwrapMultiValue(value);
-    }
-
-    @Override
-    public String hitName() {
-        return hitName;
-    }
-
-    public String fieldName() {
-        return fieldName;
-    }
-
-    public String fullFieldName() {
-        return fullFieldName;
-    }
-
-    public ZoneId zoneId() {
-        return zoneId;
-    }
-
-    DataType dataType() {
-        return dataType;
-    }
 
-    @Override
-    public String toString() {
-        return fieldName + "@" + hitName + "@" + zoneId;
-    }
-
-    @Override
-    public boolean equals(Object obj) {
-        if (obj == null || obj.getClass() != getClass()) {
-            return false;
-        }
-        FieldHitExtractor other = (FieldHitExtractor) obj;
-        return fieldName.equals(other.fieldName)
-                && hitName.equals(other.hitName)
-                && useDocValue == other.useDocValue
-                && arrayLeniency == other.arrayLeniency;
+        return null;
     }
 
     @Override
-    public int hashCode() {
-        return Objects.hash(fieldName, useDocValue, hitName, arrayLeniency);
+    protected DataType dataType() {
+        return super.dataType();
     }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractor.java
index 007c7a26c4966..3b3eaaffa16a4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractor.java
@@ -19,6 +19,7 @@
 import org.elasticsearch.search.aggregations.metrics.InternalSum;
 import org.elasticsearch.search.aggregations.metrics.InternalTDigestPercentileRanks;
 import org.elasticsearch.search.aggregations.metrics.InternalTDigestPercentiles;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
 import org.elasticsearch.xpack.sql.querydsl.agg.Aggs;
@@ -46,7 +47,7 @@ public MetricAggExtractor(String name, String property, String innerKey, ZoneId
         this.name = name;
         this.property = property;
         this.innerKey = innerKey;
-        this. isDateTimeBased =isDateTimeBased;
+        this.isDateTimeBased = isDateTimeBased;
         this.zoneId = zoneId;
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/PivotExtractor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/PivotExtractor.java
index e7c1b8dfa302c..c3cb199c63dee 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/PivotExtractor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/PivotExtractor.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ScoreExtractor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ScoreExtractor.java
index d46c543037f35..c37fb3dd35c63 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ScoreExtractor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/ScoreExtractor.java
@@ -7,6 +7,7 @@
 
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.search.SearchHit;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
 
 import java.io.IOException;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/BucketExtractors.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/SqlBucketExtractors.java
similarity index 80%
rename from x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/BucketExtractors.java
rename to x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/SqlBucketExtractors.java
index bcbbce8e4576a..8b711b87578ec 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/BucketExtractors.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/SqlBucketExtractors.java
@@ -3,29 +3,30 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
+
 package org.elasticsearch.xpack.sql.execution.search.extractor;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry.Entry;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractors;
 
 import java.util.ArrayList;
 import java.util.List;
 
-public final class BucketExtractors {
-
-    private BucketExtractors() {}
+public class SqlBucketExtractors {
+ 
+    private SqlBucketExtractors() {}
 
     /**
      * All of the named writeables needed to deserialize the instances of
      * {@linkplain BucketExtractor}s.
      */
     public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
-        List<NamedWriteableRegistry.Entry> entries = new ArrayList<>();
+        List<NamedWriteableRegistry.Entry> entries = new ArrayList<>(BucketExtractors.getNamedWriteables());
         entries.add(new Entry(BucketExtractor.class, CompositeKeyExtractor.NAME, CompositeKeyExtractor::new));
-        entries.add(new Entry(BucketExtractor.class, ComputingExtractor.NAME, ComputingExtractor::new));
         entries.add(new Entry(BucketExtractor.class, MetricAggExtractor.NAME, MetricAggExtractor::new));
         entries.add(new Entry(BucketExtractor.class, TopHitsAggExtractor.NAME, TopHitsAggExtractor::new));
-        entries.add(new Entry(BucketExtractor.class, ConstantExtractor.NAME, ConstantExtractor::new));
         entries.add(new Entry(BucketExtractor.class, PivotExtractor.NAME, PivotExtractor::new));
         return entries;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/SqlHitExtractors.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/SqlHitExtractors.java
new file mode 100644
index 0000000000000..d0938fa261f6c
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/SqlHitExtractors.java
@@ -0,0 +1,31 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.sql.execution.search.extractor;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry.Entry;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractors;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public final class SqlHitExtractors {
+
+    private SqlHitExtractors() {}
+
+    /**
+     * All of the named writeables needed to deserialize the instances of
+     * {@linkplain HitExtractor}.
+     */
+    public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
+        List<NamedWriteableRegistry.Entry> entries = new ArrayList<>(HitExtractors.getNamedWriteables());
+        entries.add(new Entry(HitExtractor.class, FieldHitExtractor.NAME, FieldHitExtractor::new));
+        entries.add(new Entry(HitExtractor.class, ScoreExtractor.NAME, in -> ScoreExtractor.INSTANCE));
+        return entries;
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/TopHitsAggExtractor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/TopHitsAggExtractor.java
index b315b4ce16b5a..3b705ee6b5cdc 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/TopHitsAggExtractor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/extractor/TopHitsAggExtractor.java
@@ -9,9 +9,10 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
 import org.elasticsearch.search.aggregations.metrics.InternalTopHits;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
-import org.elasticsearch.xpack.sql.type.DataType;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.io.IOException;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Exists.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Exists.java
index d481d8e115fd3..cebe50b9f6d56 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Exists.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/Exists.java
@@ -5,10 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression;
 
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.NameId;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 public class Exists extends SubQueryExpression {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ScalarSubquery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ScalarSubquery.java
index cba61814e8f51..36fa3d3ffa019 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ScalarSubquery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/ScalarSubquery.java
@@ -5,10 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression;
 
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.NameId;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 public class ScalarSubquery extends SubQueryExpression {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/SubQueryExpression.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/SubQueryExpression.java
index 250e5de721846..6ac29ff493d0d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/SubQueryExpression.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/SubQueryExpression.java
@@ -5,8 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression;
 
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.NameId;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Collections;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionRegistry.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionRegistry.java
deleted file mode 100644
index cff6fd13a0733..0000000000000
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionRegistry.java
+++ /dev/null
@@ -1,653 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.sql.expression.function;
-
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Avg;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.First;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Kurtosis;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Last;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Max;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.MedianAbsoluteDeviation;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Min;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Percentile;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.PercentileRank;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Skewness;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.StddevPop;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Sum;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.SumOfSquares;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.VarPop;
-import org.elasticsearch.xpack.sql.expression.function.grouping.Histogram;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
-import org.elasticsearch.xpack.sql.expression.function.scalar.Database;
-import org.elasticsearch.xpack.sql.expression.function.scalar.User;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.CurrentDate;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.CurrentDateTime;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.CurrentTime;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateAdd;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateDiff;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DatePart;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTrunc;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DayName;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DayOfMonth;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DayOfWeek;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DayOfYear;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.HourOfDay;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.IsoDayOfWeek;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.IsoWeekOfYear;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.MinuteOfDay;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.MinuteOfHour;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.MonthName;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.MonthOfYear;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.Quarter;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.SecondOfMinute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.WeekOfYear;
-import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.Year;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StAswkt;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StDistance;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StGeometryType;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StWkttosql;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StX;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StY;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StZ;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.ACos;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.ASin;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.ATan;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.ATan2;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Abs;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Cbrt;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Ceil;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Cos;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Cosh;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Cot;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Degrees;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.E;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Exp;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Expm1;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Floor;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Log;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Log10;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Pi;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Power;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Radians;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Random;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Round;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Sign;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Sin;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Sinh;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Sqrt;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Tan;
-import org.elasticsearch.xpack.sql.expression.function.scalar.math.Truncate;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Ascii;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.BitLength;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Char;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.CharLength;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Concat;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Insert;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.LCase;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.LTrim;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Left;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Length;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Locate;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.OctetLength;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Position;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.RTrim;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Repeat;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Replace;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Right;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Space;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.Substring;
-import org.elasticsearch.xpack.sql.expression.function.scalar.string.UCase;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Case;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Coalesce;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Greatest;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfNull;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Iif;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Least;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.NullIf;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mod;
-import org.elasticsearch.xpack.sql.parser.ParsingException;
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.Check;
-
-import java.time.ZoneId;
-import java.util.Arrays;
-import java.util.Collection;
-import java.util.HashMap;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Locale;
-import java.util.Map;
-import java.util.Map.Entry;
-import java.util.function.BiFunction;
-import java.util.regex.Pattern;
-import java.util.stream.Collectors;
-
-import static java.util.Collections.emptyList;
-import static java.util.Collections.unmodifiableList;
-import static java.util.stream.Collectors.toList;
-
-public class FunctionRegistry {
-
-    // list of functions grouped by type of functions (aggregate, statistics, math etc) and ordered alphabetically inside each group
-    // a single function will have one entry for itself with its name associated to its instance and, also, one entry for each alias
-    // it has with the alias name associated to the FunctionDefinition instance
-    private final Map<String, FunctionDefinition> defs = new LinkedHashMap<>();
-    private final Map<String, String> aliases = new HashMap<>();
-
-    /**
-     * Constructor to build with the default list of functions.
-     */
-    public FunctionRegistry() {
-        defineDefaultFunctions();
-    }
-
-    /**
-     * Constructor specifying alternate functions for testing.
-     */
-    FunctionRegistry(FunctionDefinition... functions) {
-        addToMap(functions);
-    }
-
-    private void defineDefaultFunctions() {
-        // Aggregate functions
-        addToMap(def(Avg.class, Avg::new, "AVG"),
-                def(Count.class, Count::new, "COUNT"),
-                def(First.class, First::new, "FIRST", "FIRST_VALUE"),
-                def(Last.class, Last::new, "LAST", "LAST_VALUE"),
-                def(Max.class, Max::new, "MAX"),
-                def(Min.class, Min::new, "MIN"),
-                def(Sum.class, Sum::new, "SUM"));
-        // Statistics
-        addToMap(
-                def(Kurtosis.class, Kurtosis::new, "KURTOSIS"),
-                def(MedianAbsoluteDeviation.class, MedianAbsoluteDeviation::new, "MAD"),
-                def(Percentile.class, Percentile::new, "PERCENTILE"),
-                def(PercentileRank.class, PercentileRank::new, "PERCENTILE_RANK"),
-                def(Skewness.class, Skewness::new, "SKEWNESS"),
-                def(StddevPop.class, StddevPop::new, "STDDEV_POP"),
-                def(SumOfSquares.class, SumOfSquares::new, "SUM_OF_SQUARES"),
-                def(VarPop.class, VarPop::new,"VAR_POP")
-                );
-        // histogram
-        addToMap(def(Histogram.class, Histogram::new, "HISTOGRAM"));
-        // Scalar functions
-        // Conditional
-        addToMap(def(Case.class, Case::new, "CASE"),
-                def(Coalesce.class, Coalesce::new, "COALESCE"),
-                def(Iif.class, Iif::new, "IIF"),
-                def(IfNull.class, IfNull::new, "IFNULL", "ISNULL", "NVL"),
-                def(NullIf.class, NullIf::new, "NULLIF"),
-                def(Greatest.class, Greatest::new, "GREATEST"),
-                def(Least.class, Least::new, "LEAST"));
-        // Date
-        addToMap(def(CurrentDate.class, CurrentDate::new, "CURRENT_DATE", "CURDATE", "TODAY"),
-                def(CurrentTime.class, CurrentTime::new, "CURRENT_TIME", "CURTIME"),
-                def(CurrentDateTime.class, CurrentDateTime::new, "CURRENT_TIMESTAMP", "NOW"),
-                def(DayName.class, DayName::new, "DAY_NAME", "DAYNAME"),
-                def(DayOfMonth.class, DayOfMonth::new, "DAY_OF_MONTH", "DAYOFMONTH", "DAY", "DOM"),
-                def(DayOfWeek.class, DayOfWeek::new, "DAY_OF_WEEK", "DAYOFWEEK", "DOW"),
-                def(DayOfYear.class, DayOfYear::new, "DAY_OF_YEAR", "DAYOFYEAR", "DOY"),
-                def(DateAdd.class, DateAdd::new, "DATEADD", "DATE_ADD", "TIMESTAMPADD", "TIMESTAMP_ADD"),
-                def(DateDiff.class, DateDiff::new, "DATEDIFF", "DATE_DIFF", "TIMESTAMPDIFF", "TIMESTAMP_DIFF"),
-                def(DatePart.class, DatePart::new, "DATEPART", "DATE_PART"),
-                def(DateTrunc.class, DateTrunc::new, "DATETRUNC", "DATE_TRUNC"),
-                def(HourOfDay.class, HourOfDay::new, "HOUR_OF_DAY", "HOUR"),
-                def(IsoDayOfWeek.class, IsoDayOfWeek::new, "ISO_DAY_OF_WEEK", "ISODAYOFWEEK", "ISODOW", "IDOW"),
-                def(IsoWeekOfYear.class, IsoWeekOfYear::new, "ISO_WEEK_OF_YEAR", "ISOWEEKOFYEAR", "ISOWEEK", "IWOY", "IW"),
-                def(MinuteOfDay.class, MinuteOfDay::new, "MINUTE_OF_DAY"),
-                def(MinuteOfHour.class, MinuteOfHour::new, "MINUTE_OF_HOUR", "MINUTE"),
-                def(MonthName.class, MonthName::new, "MONTH_NAME", "MONTHNAME"),
-                def(MonthOfYear.class, MonthOfYear::new, "MONTH_OF_YEAR", "MONTH"),
-                def(SecondOfMinute.class, SecondOfMinute::new, "SECOND_OF_MINUTE", "SECOND"),
-                def(Quarter.class, Quarter::new, "QUARTER"),
-                def(Year.class, Year::new, "YEAR"),
-                def(WeekOfYear.class, WeekOfYear::new, "WEEK_OF_YEAR", "WEEK"));
-        // Math
-        addToMap(def(Abs.class, Abs::new, "ABS"),
-                def(ACos.class, ACos::new, "ACOS"),
-                def(ASin.class, ASin::new, "ASIN"),
-                def(ATan.class, ATan::new, "ATAN"),
-                def(ATan2.class, ATan2::new, "ATAN2"),
-                def(Cbrt.class, Cbrt::new, "CBRT"),
-                def(Ceil.class, Ceil::new, "CEIL", "CEILING"),
-                def(Cos.class, Cos::new, "COS"),
-                def(Cosh.class, Cosh::new, "COSH"),
-                def(Cot.class, Cot::new, "COT"),
-                def(Degrees.class, Degrees::new, "DEGREES"),
-                def(E.class, E::new, "E"),
-                def(Exp.class, Exp::new, "EXP"),
-                def(Expm1.class, Expm1::new, "EXPM1"),
-                def(Floor.class, Floor::new, "FLOOR"),
-                def(Log.class, Log::new, "LOG"),
-                def(Log10.class, Log10::new, "LOG10"),
-                // SQL and ODBC require MOD as a _function_
-                def(Mod.class, Mod::new, "MOD"),
-                def(Pi.class, Pi::new, "PI"),
-                def(Power.class, Power::new, "POWER"),
-                def(Radians.class, Radians::new, "RADIANS"),
-                def(Random.class, Random::new, "RANDOM", "RAND"),
-                def(Round.class, Round::new, "ROUND"),
-                def(Sign.class, Sign::new, "SIGN", "SIGNUM"),
-                def(Sin.class, Sin::new, "SIN"),
-                def(Sinh.class, Sinh::new, "SINH"),
-                def(Sqrt.class, Sqrt::new, "SQRT"),
-                def(Tan.class, Tan::new, "TAN"),
-                def(Truncate.class, Truncate::new, "TRUNCATE", "TRUNC"));
-        // String
-        addToMap(def(Ascii.class, Ascii::new, "ASCII"),
-                def(BitLength.class, BitLength::new, "BIT_LENGTH"),
-                def(Char.class, Char::new, "CHAR"),
-                def(CharLength.class, CharLength::new, "CHAR_LENGTH", "CHARACTER_LENGTH"),
-                def(Concat.class, Concat::new, "CONCAT"),
-                def(Insert.class, Insert::new, "INSERT"),
-                def(LCase.class, LCase::new, "LCASE"),
-                def(Left.class, Left::new, "LEFT"),
-                def(Length.class, Length::new, "LENGTH"),
-                def(Locate.class, Locate::new, "LOCATE"),
-                def(LTrim.class, LTrim::new, "LTRIM"),
-                def(OctetLength.class, OctetLength::new, "OCTET_LENGTH"),
-                def(Position.class, Position::new, "POSITION"),
-                def(Repeat.class, Repeat::new, "REPEAT"),
-                def(Replace.class, Replace::new, "REPLACE"),
-                def(Right.class, Right::new, "RIGHT"),
-                def(RTrim.class, RTrim::new, "RTRIM"),
-                def(Space.class, Space::new, "SPACE"),
-                def(Substring.class, Substring::new, "SUBSTRING"),
-                def(UCase.class, UCase::new, "UCASE"));
-
-        // DataType conversion
-        addToMap(def(Cast.class, Cast::new, "CAST", "CONVERT"));
-        // Scalar "meta" functions
-        addToMap(def(Database.class, Database::new, "DATABASE"),
-                def(User.class, User::new, "USER"));
-
-        // Geo Functions
-        addToMap(def(StAswkt.class, StAswkt::new, "ST_ASWKT", "ST_ASTEXT"),
-                def(StDistance.class, StDistance::new, "ST_DISTANCE"),
-                def(StWkttosql.class, StWkttosql::new, "ST_WKTTOSQL", "ST_GEOMFROMTEXT"),
-                def(StGeometryType.class, StGeometryType::new, "ST_GEOMETRYTYPE"),
-                def(StX.class, StX::new, "ST_X"),
-                def(StY.class, StY::new, "ST_Y"),
-                def(StZ.class, StZ::new, "ST_Z")
-        );
-
-        // Special
-        addToMap(def(Score.class, Score::new, "SCORE"));
-    }
-
-    void addToMap(FunctionDefinition...functions) {
-        // temporary map to hold [function_name/alias_name : function instance]
-        Map<String, FunctionDefinition> batchMap = new HashMap<>();
-        for (FunctionDefinition f : functions) {
-            batchMap.put(f.name(), f);
-            for (String alias : f.aliases()) {
-                Object old = batchMap.put(alias, f);
-                if (old != null || defs.containsKey(alias)) {
-                    throw new SqlIllegalArgumentException("alias [" + alias + "] is used by "
-                            + "[" + (old != null ? old : defs.get(alias).name()) + "] and [" + f.name() + "]");
-                }
-                aliases.put(alias, f.name());
-            }
-        }
-        // sort the temporary map by key name and add it to the global map of functions
-        defs.putAll(batchMap.entrySet().stream()
-                .sorted(Map.Entry.comparingByKey())
-                .collect(Collectors.<Entry<String, FunctionDefinition>, String,
-                        FunctionDefinition, LinkedHashMap<String, FunctionDefinition>> toMap(Map.Entry::getKey, Map.Entry::getValue,
-                (oldValue, newValue) -> oldValue, LinkedHashMap::new)));
-    }
-
-    public FunctionDefinition resolveFunction(String functionName) {
-        FunctionDefinition def = defs.get(functionName);
-        if (def == null) {
-            throw new SqlIllegalArgumentException(
-                "Cannot find function {}; this should have been caught during analysis",
-                functionName);
-        }
-        return def;
-    }
-
-    public String resolveAlias(String alias) {
-        String upperCase = alias.toUpperCase(Locale.ROOT);
-        return aliases.getOrDefault(upperCase, upperCase);
-    }
-
-    public boolean functionExists(String functionName) {
-        return defs.containsKey(functionName);
-    }
-
-    public Collection<FunctionDefinition> listFunctions() {
-        // It is worth double checking if we need this copy. These are immutable anyway.
-        return defs.entrySet().stream()
-                .map(e -> new FunctionDefinition(e.getKey(), emptyList(),
-                        e.getValue().clazz(), e.getValue().extractViable(), e.getValue().builder()))
-                .collect(toList());
-    }
-
-    public Collection<FunctionDefinition> listFunctions(String pattern) {
-        // It is worth double checking if we need this copy. These are immutable anyway.
-        Pattern p = Strings.hasText(pattern) ? Pattern.compile(pattern.toUpperCase(Locale.ROOT)) : null;
-        return defs.entrySet().stream()
-                .filter(e -> p == null || p.matcher(e.getKey()).matches())
-                .map(e -> new FunctionDefinition(e.getKey(), emptyList(),
-                        e.getValue().clazz(), e.getValue().extractViable(), e.getValue().builder()))
-                .collect(toList());
-    }
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for a no-argument function that
-     * is not aware of time zone and does not support {@code DISTINCT}.
-     */
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            java.util.function.Function<Source, T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (false == children.isEmpty()) {
-                throw new SqlIllegalArgumentException("expects no arguments");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.apply(source);
-        };
-        return def(function, builder, false, names);
-    }
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for a no-argument function that
-     * is not aware of time zone, does not support {@code DISTINCT} and needs
-     * the cluster name (DATABASE()) or the user name (USER()).
-     */
-    @SuppressWarnings("overloads")
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            ConfigurationAwareFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (false == children.isEmpty()) {
-                throw new SqlIllegalArgumentException("expects no arguments");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.build(source, cfg);
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface ConfigurationAwareFunctionBuilder<T> {
-        T build(Source source, Configuration configuration);
-    }
-
-    /**
-    * Build a {@linkplain FunctionDefinition} for a one-argument function that
-    * is not aware of time zone, does not support {@code DISTINCT} and needs
-    * the configuration object.
-    */
-    @SuppressWarnings("overloads")
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            UnaryConfigurationAwareFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (children.size() > 1) {
-                throw new SqlIllegalArgumentException("expects exactly one argument");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            Expression ex = children.size() == 1 ? children.get(0) : null;
-            return ctorRef.build(source, ex, cfg);
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface UnaryConfigurationAwareFunctionBuilder<T> {
-        T build(Source source, Expression exp, Configuration configuration);
-    }
-
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for a unary function that is not
-     * aware of time zone and does not support {@code DISTINCT}.
-     */
-    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            BiFunction<Source, Expression, T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (children.size() != 1) {
-                throw new SqlIllegalArgumentException("expects exactly one argument");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.apply(source, children.get(0));
-        };
-        return def(function, builder, false, names);
-    }
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for multi-arg function that
-     * is not aware of time zone and does not support {@code DISTINCT}.
-     */
-    @SuppressWarnings("overloads") // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            MultiFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.build(source, children);
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface MultiFunctionBuilder<T> {
-        T build(Source source, List<Expression> children);
-    }
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for a unary function that is not
-     * aware of time zone but does support {@code DISTINCT}.
-     */
-    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            DistinctAwareUnaryFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (children.size() != 1) {
-                throw new SqlIllegalArgumentException("expects exactly one argument");
-            }
-            return ctorRef.build(source, children.get(0), distinct);
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface DistinctAwareUnaryFunctionBuilder<T> {
-        T build(Source source, Expression target, boolean distinct);
-    }
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for a unary function that
-     * operates on a datetime.
-     */
-    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            DatetimeUnaryFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (children.size() != 1) {
-                throw new SqlIllegalArgumentException("expects exactly one argument");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.build(source, children.get(0), cfg.zoneId());
-        };
-        return def(function, builder, true, names);
-    }
-
-    interface DatetimeUnaryFunctionBuilder<T> {
-        T build(Source source, Expression target, ZoneId zi);
-    }
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for a binary function that
-     * requires a timezone.
-     */
-    @SuppressWarnings("overloads") // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function, DatetimeBinaryFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (children.size() != 2) {
-                throw new SqlIllegalArgumentException("expects exactly two arguments");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.build(source, children.get(0), children.get(1), cfg.zoneId());
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface DatetimeBinaryFunctionBuilder<T> {
-        T build(Source source, Expression lhs, Expression rhs, ZoneId zi);
-    }
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for a three-args function that
-     * requires a timezone.
-     */
-    @SuppressWarnings("overloads") // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function, DatetimeThreeArgsFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (children.size() != 3) {
-                throw new SqlIllegalArgumentException("expects three arguments");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.build(source, children.get(0), children.get(1), children.get(2), cfg.zoneId());
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface DatetimeThreeArgsFunctionBuilder<T> {
-        T build(Source source, Expression first, Expression second, Expression third, ZoneId zi);
-    }
-
-    /**
-     * Build a {@linkplain FunctionDefinition} for a binary function that is
-     * not aware of time zone and does not support {@code DISTINCT}.
-     */
-    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            BinaryFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            boolean isBinaryOptionalParamFunction = function.isAssignableFrom(Round.class) || function.isAssignableFrom(Truncate.class)
-                    || TopHits.class.isAssignableFrom(function);
-            if (isBinaryOptionalParamFunction && (children.size() > 2 || children.size() < 1)) {
-                throw new SqlIllegalArgumentException("expects one or two arguments");
-            } else if (!isBinaryOptionalParamFunction && children.size() != 2) {
-                throw new SqlIllegalArgumentException("expects exactly two arguments");
-            }
-
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.build(source, children.get(0), children.size() == 2 ? children.get(1) : null);
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface BinaryFunctionBuilder<T> {
-        T build(Source source, Expression lhs, Expression rhs);
-    }
-
-    /**
-     * Main method to register a function/
-     * @param names Must always have at least one entry which is the method's primary name
-     *
-     */
-    @SuppressWarnings("overloads")
-    private static FunctionDefinition def(Class<? extends Function> function, FunctionBuilder builder,
-                                          boolean datetime, String... names) {
-        Check.isTrue(names.length > 0, "At least one name must be provided for the function");
-        String primaryName = names[0];
-        List<String> aliases = Arrays.asList(names).subList(1, names.length);
-        FunctionDefinition.Builder realBuilder = (uf, distinct, cfg) -> {
-            try {
-                return builder.build(uf.source(), uf.children(), distinct, cfg);
-            } catch (SqlIllegalArgumentException e) {
-                throw new ParsingException(uf.source(), "error building [" + primaryName + "]: " + e.getMessage(), e);
-            }
-        };
-        return new FunctionDefinition(primaryName, unmodifiableList(aliases), function, datetime, realBuilder);
-    }
-
-    private interface FunctionBuilder {
-        Function build(Source source, List<Expression> children, boolean distinct, Configuration cfg);
-    }
-
-    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            ThreeParametersFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            boolean hasMinimumTwo = function.isAssignableFrom(Locate.class) || function.isAssignableFrom(Iif.class);
-            if (hasMinimumTwo && (children.size() > 3 || children.size() < 2)) {
-                throw new SqlIllegalArgumentException("expects two or three arguments");
-            } else if (!hasMinimumTwo && children.size() != 3) {
-                throw new SqlIllegalArgumentException("expects exactly three arguments");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.build(source, children.get(0), children.get(1), children.size() == 3 ? children.get(2) : null);
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface ThreeParametersFunctionBuilder<T> {
-        T build(Source source, Expression src, Expression exp1, Expression exp2);
-    }
-
-    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
-    static <T extends Function> FunctionDefinition def(Class<T> function,
-            FourParametersFunctionBuilder<T> ctorRef, String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) -> {
-            if (children.size() != 4) {
-                throw new SqlIllegalArgumentException("expects exactly four arguments");
-            }
-            if (distinct) {
-                throw new SqlIllegalArgumentException("does not support DISTINCT yet it was specified");
-            }
-            return ctorRef.build(source, children.get(0), children.get(1), children.get(2), children.get(3));
-        };
-        return def(function, builder, false, names);
-    }
-
-    interface FourParametersFunctionBuilder<T> {
-        T build(Source source, Expression src, Expression exp1, Expression exp2, Expression exp3);
-    }
-
-    /**
-     * Special method to create function definition for {@link Cast} as its
-     * signature is not compatible with {@link UnresolvedFunction}
-     *
-     * @return Cast function definition
-     */
-    @SuppressWarnings("overloads")  // These are ambiguous if you aren't using ctor references but we always do
-    private static <T extends Function> FunctionDefinition def(Class<T> function,
-                                                               CastFunctionBuilder<T> ctorRef,
-                                                               String... names) {
-        FunctionBuilder builder = (source, children, distinct, cfg) ->
-            ctorRef.build(source, children.get(0), children.get(0).dataType());
-        return def(function, builder, false, names);
-    }
-
-    private interface CastFunctionBuilder<T> {
-        T build(Source source, Expression expression, DataType dataType);
-    }
-}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionType.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionType.java
deleted file mode 100644
index 22b6a50d8ee21..0000000000000
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/FunctionType.java
+++ /dev/null
@@ -1,37 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License;
- * you may not use this file except in compliance with the Elastic License.
- */
-package org.elasticsearch.xpack.sql.expression.function;
-
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalFunction;
-
-
-public enum FunctionType {
-
-    AGGREGATE(AggregateFunction.class),
-    CONDITIONAL(ConditionalFunction.class),
-    GROUPING(GroupingFunction.class),
-    SCALAR(ScalarFunction.class),
-    SCORE(Score.class);
-
-    private final Class<? extends Function> baseClass;
-
-    FunctionType(Class<? extends Function> base) {
-        this.baseClass = base;
-    }
-
-    public static FunctionType of(Class<? extends Function> clazz) {
-        for (FunctionType type : values()) {
-            if (type.baseClass.isAssignableFrom(clazz)) {
-                return type;
-            }
-        }
-        throw new SqlIllegalArgumentException("Cannot identify the function type for {}", clazz);
-    }
-}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Score.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Score.java
index d5cee6449807d..af575b18f8fa1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Score.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/Score.java
@@ -5,13 +5,14 @@
  */
 package org.elasticsearch.xpack.sql.expression.function;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/SqlFunctionRegistry.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/SqlFunctionRegistry.java
new file mode 100644
index 0000000000000..17ded961b605a
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/SqlFunctionRegistry.java
@@ -0,0 +1,265 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.sql.expression.function;
+
+import org.elasticsearch.xpack.ql.expression.function.FunctionDefinition;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.Count;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Case;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Coalesce;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Greatest;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfNull;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Iif;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Least;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.NullIf;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mod;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Avg;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.First;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Kurtosis;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Last;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Max;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.MedianAbsoluteDeviation;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Min;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Percentile;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.PercentileRank;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Skewness;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.StddevPop;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Sum;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.SumOfSquares;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.VarPop;
+import org.elasticsearch.xpack.sql.expression.function.grouping.Histogram;
+import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
+import org.elasticsearch.xpack.sql.expression.function.scalar.Database;
+import org.elasticsearch.xpack.sql.expression.function.scalar.User;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.CurrentDate;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.CurrentDateTime;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.CurrentTime;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateAdd;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateDiff;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DatePart;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTrunc;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DayName;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DayOfMonth;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DayOfWeek;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DayOfYear;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.HourOfDay;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.IsoDayOfWeek;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.IsoWeekOfYear;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.MinuteOfDay;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.MinuteOfHour;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.MonthName;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.MonthOfYear;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.Quarter;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.SecondOfMinute;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.WeekOfYear;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.Year;
+import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StAswkt;
+import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StDistance;
+import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StGeometryType;
+import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StWkttosql;
+import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StX;
+import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StY;
+import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StZ;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.ACos;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.ASin;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.ATan;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.ATan2;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Abs;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Cbrt;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Ceil;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Cos;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Cosh;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Cot;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Degrees;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.E;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Exp;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Expm1;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Floor;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Log;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Log10;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Pi;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Power;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Radians;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Random;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Round;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Sign;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Sin;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Sinh;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Sqrt;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Tan;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.Truncate;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Ascii;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.BitLength;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Char;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.CharLength;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Concat;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Insert;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.LCase;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.LTrim;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Left;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Length;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Locate;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.OctetLength;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Position;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.RTrim;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Repeat;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Replace;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Right;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Space;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.Substring;
+import org.elasticsearch.xpack.sql.expression.function.scalar.string.UCase;
+
+public class SqlFunctionRegistry extends FunctionRegistry {
+
+    public SqlFunctionRegistry() {
+        super(functions());
+    }
+
+    private static FunctionDefinition[][] functions() {
+        return new FunctionDefinition[][] {
+        // Aggregate functions
+            new FunctionDefinition[] {
+                def(Avg.class, Avg::new, "AVG"),
+                def(Count.class, Count::new, "COUNT"),
+                def(First.class, First::new, "FIRST", "FIRST_VALUE"),
+                def(Last.class, Last::new, "LAST", "LAST_VALUE"),
+                def(Max.class, Max::new, "MAX"),
+                def(Min.class, Min::new, "MIN"),
+                def(Sum.class, Sum::new, "SUM")
+                },
+        // Statistics
+            new FunctionDefinition[] {
+                def(Kurtosis.class, Kurtosis::new, "KURTOSIS"),
+                def(MedianAbsoluteDeviation.class, MedianAbsoluteDeviation::new, "MAD"),
+                def(Percentile.class, Percentile::new, "PERCENTILE"),
+                def(PercentileRank.class, PercentileRank::new, "PERCENTILE_RANK"),
+                def(Skewness.class, Skewness::new, "SKEWNESS"),
+                def(StddevPop.class, StddevPop::new, "STDDEV_POP"),
+                def(SumOfSquares.class, SumOfSquares::new, "SUM_OF_SQUARES"),
+                def(VarPop.class, VarPop::new, "VAR_POP")
+                },
+        // histogram
+            new FunctionDefinition[] {
+                def(Histogram.class, Histogram::new, "HISTOGRAM")
+                },
+        // Scalar functions
+        // Conditional
+            new FunctionDefinition[] {
+                def(Case.class, Case::new, "CASE"),
+                def(Coalesce.class, Coalesce::new, "COALESCE"),
+                def(Iif.class, Iif::new, "IIF"),
+                def(IfNull.class, IfNull::new, "IFNULL", "ISNULL", "NVL"),
+                def(NullIf.class, NullIf::new, "NULLIF"),
+                def(Greatest.class, Greatest::new, "GREATEST"),
+                def(Least.class, Least::new, "LEAST")
+                },
+        // Date
+            new FunctionDefinition[] {
+                def(CurrentDate.class, CurrentDate::new, "CURRENT_DATE", "CURDATE", "TODAY"),
+                def(CurrentTime.class, CurrentTime::new, "CURRENT_TIME", "CURTIME"),
+                def(CurrentDateTime.class, CurrentDateTime::new, "CURRENT_TIMESTAMP", "NOW"),
+                def(DayName.class, DayName::new, "DAY_NAME", "DAYNAME"),
+                def(DayOfMonth.class, DayOfMonth::new, "DAY_OF_MONTH", "DAYOFMONTH", "DAY", "DOM"),
+                def(DayOfWeek.class, DayOfWeek::new, "DAY_OF_WEEK", "DAYOFWEEK", "DOW"),
+                def(DayOfYear.class, DayOfYear::new, "DAY_OF_YEAR", "DAYOFYEAR", "DOY"),
+                def(DateAdd.class, DateAdd::new, "DATEADD", "DATE_ADD", "TIMESTAMPADD", "TIMESTAMP_ADD"),
+                def(DateDiff.class, DateDiff::new, "DATEDIFF", "DATE_DIFF", "TIMESTAMPDIFF", "TIMESTAMP_DIFF"),
+                def(DatePart.class, DatePart::new, "DATEPART", "DATE_PART"),
+                def(DateTrunc.class, DateTrunc::new, "DATETRUNC", "DATE_TRUNC"),
+                def(HourOfDay.class, HourOfDay::new, "HOUR_OF_DAY", "HOUR"),
+                def(IsoDayOfWeek.class, IsoDayOfWeek::new, "ISO_DAY_OF_WEEK", "ISODAYOFWEEK", "ISODOW", "IDOW"),
+                def(IsoWeekOfYear.class, IsoWeekOfYear::new, "ISO_WEEK_OF_YEAR", "ISOWEEKOFYEAR", "ISOWEEK", "IWOY", "IW"),
+                def(MinuteOfDay.class, MinuteOfDay::new, "MINUTE_OF_DAY"),
+                def(MinuteOfHour.class, MinuteOfHour::new, "MINUTE_OF_HOUR", "MINUTE"),
+                def(MonthName.class, MonthName::new, "MONTH_NAME", "MONTHNAME"),
+                def(MonthOfYear.class, MonthOfYear::new, "MONTH_OF_YEAR", "MONTH"),
+                def(SecondOfMinute.class, SecondOfMinute::new, "SECOND_OF_MINUTE", "SECOND"),
+                def(Quarter.class, Quarter::new, "QUARTER"),
+                def(Year.class, Year::new, "YEAR"),
+                def(WeekOfYear.class, WeekOfYear::new, "WEEK_OF_YEAR", "WEEK")
+            },
+        // Math
+            new FunctionDefinition[] {
+                def(Abs.class, Abs::new, "ABS"),
+                def(ACos.class, ACos::new, "ACOS"),
+                def(ASin.class, ASin::new, "ASIN"),
+                def(ATan.class, ATan::new, "ATAN"),
+                def(ATan2.class, ATan2::new, "ATAN2"),
+                def(Cbrt.class, Cbrt::new, "CBRT"),
+                def(Ceil.class, Ceil::new, "CEIL", "CEILING"),
+                def(Cos.class, Cos::new, "COS"),
+                def(Cosh.class, Cosh::new, "COSH"),
+                def(Cot.class, Cot::new, "COT"),
+                def(Degrees.class, Degrees::new, "DEGREES"),
+                def(E.class, E::new, "E"),
+                def(Exp.class, Exp::new, "EXP"),
+                def(Expm1.class, Expm1::new, "EXPM1"),
+                def(Floor.class, Floor::new, "FLOOR"),
+                def(Log.class, Log::new, "LOG"),
+                def(Log10.class, Log10::new, "LOG10"),
+                // SQL and ODBC require MOD as a _function_
+                def(Mod.class, Mod::new, "MOD"),
+                def(Pi.class, Pi::new, "PI"),
+                def(Power.class, Power::new, "POWER"),
+                def(Radians.class, Radians::new, "RADIANS"),
+                def(Random.class, Random::new, "RANDOM", "RAND"),
+                def(Round.class, Round::new, "ROUND"),
+                def(Sign.class, Sign::new, "SIGN", "SIGNUM"),
+                def(Sin.class, Sin::new, "SIN"),
+                def(Sinh.class, Sinh::new, "SINH"),
+                def(Sqrt.class, Sqrt::new, "SQRT"),
+                def(Tan.class, Tan::new, "TAN"),
+                def(Truncate.class, Truncate::new, "TRUNCATE", "TRUNC")
+            },
+        // String
+            new FunctionDefinition[] {
+                def(Ascii.class, Ascii::new, "ASCII"),
+                def(BitLength.class, BitLength::new, "BIT_LENGTH"),
+                def(Char.class, Char::new, "CHAR"),
+                def(CharLength.class, CharLength::new, "CHAR_LENGTH", "CHARACTER_LENGTH"),
+                def(Concat.class, Concat::new, "CONCAT"),
+                def(Insert.class, Insert::new, "INSERT"),
+                def(LCase.class, LCase::new, "LCASE"),
+                def(Left.class, Left::new, "LEFT"),
+                def(Length.class, Length::new, "LENGTH"),
+                def(Locate.class, Locate::new, "LOCATE"),
+                def(LTrim.class, LTrim::new, "LTRIM"),
+                def(OctetLength.class, OctetLength::new, "OCTET_LENGTH"),
+                def(Position.class, Position::new, "POSITION"),
+                def(Repeat.class, Repeat::new, "REPEAT"),
+                def(Replace.class, Replace::new, "REPLACE"),
+                def(Right.class, Right::new, "RIGHT"),
+                def(RTrim.class, RTrim::new, "RTRIM"),
+                def(Space.class, Space::new, "SPACE"),
+                def(Substring.class, Substring::new, "SUBSTRING"),
+                def(UCase.class, UCase::new, "UCASE")
+            },
+        // DataType conversion
+            new FunctionDefinition[] {
+                def(Cast.class, Cast::new, "CAST", "CONVERT")
+            },
+        // Scalar "meta" functions
+            new FunctionDefinition[] {
+                def(Database.class, Database::new, "DATABASE"),
+                def(User.class, User::new, "USER")
+            },
+        // Geo Functions
+            new FunctionDefinition[] {
+                def(StAswkt.class, StAswkt::new, "ST_ASWKT", "ST_ASTEXT"),
+                def(StDistance.class, StDistance::new, "ST_DISTANCE"),
+                def(StWkttosql.class, StWkttosql::new, "ST_WKTTOSQL", "ST_GEOMFROMTEXT"),
+                def(StGeometryType.class, StGeometryType::new, "ST_GEOMETRYTYPE"),
+                def(StX.class, StX::new, "ST_X"),
+                def(StY.class, StY::new, "ST_Y"),
+                def(StZ.class, StZ::new, "ST_Z")
+            },
+        // Special
+            new FunctionDefinition[] {
+                def(Score.class, Score::new, "SCORE")
+            }
+        };
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/SqlFunctionTypeRegistry.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/SqlFunctionTypeRegistry.java
new file mode 100644
index 0000000000000..e98addfa14cc7
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/SqlFunctionTypeRegistry.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.sql.expression.function;
+
+import org.elasticsearch.xpack.ql.expression.function.DefaultFunctionTypeRegistry;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.grouping.GroupingFunction;
+
+public class SqlFunctionTypeRegistry extends DefaultFunctionTypeRegistry {
+
+    public static final SqlFunctionTypeRegistry INSTANCE = new SqlFunctionTypeRegistry();
+
+    private enum Types {
+        GROUPING(GroupingFunction.class),
+        SCORE(Score.class);
+
+        private Class<? extends Function> baseClass;
+
+        Types(Class<? extends Function> base) {
+            this.baseClass = base;
+        }
+    }
+
+    @Override
+    public String type(Class<? extends Function> clazz) {
+        for (Types type : Types.values()) {
+            if (type.baseClass.isAssignableFrom(clazz)) {
+                return type.name();
+            }
+        }
+        return super.type(clazz);
+    }
+
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Avg.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Avg.java
index b74be4810ed60..e6940009dba79 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Avg.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Avg.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/CompoundNumericAggregate.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/CompoundNumericAggregate.java
index 9585b55ce3b8d..4582a06e6311b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/CompoundNumericAggregate.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/CompoundNumericAggregate.java
@@ -5,14 +5,15 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.CompoundAggregate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
 // marker type for compound aggregates, that is aggregate that provide multiple values (like Stats or Matrix)
 // and thus cannot be used directly in SQL and are mainly for internal use
-public abstract class CompoundNumericAggregate extends NumericAggregate {
+public abstract class CompoundNumericAggregate extends NumericAggregate implements CompoundAggregate {
 
     CompoundNumericAggregate(Source source, Expression field, List<Expression> arguments) {
         super(source, field, arguments);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/ExtendedStats.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/ExtendedStats.java
index a1245104858f3..04589d1f4f2de 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/ExtendedStats.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/ExtendedStats.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class ExtendedStats extends CompoundNumericAggregate {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/ExtendedStatsEnclosed.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/ExtendedStatsEnclosed.java
index 3e51fa4ef1adf..6ce0ad2084a47 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/ExtendedStatsEnclosed.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/ExtendedStatsEnclosed.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+
 public interface ExtendedStatsEnclosed extends StatsEnclosed, EnclosedAgg {
 
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/First.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/First.java
index 527d299fa3c58..6ef0ffb12b07c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/First.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/First.java
@@ -5,9 +5,9 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Kurtosis.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Kurtosis.java
index 29b09187b5dea..aef566f6dd7d4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Kurtosis.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Kurtosis.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class Kurtosis extends NumericAggregate implements MatrixStatsEnclosed {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Last.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Last.java
index 93b893e510ceb..77ca1adf5dba7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Last.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Last.java
@@ -5,9 +5,9 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MatrixStats.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MatrixStats.java
index fb4d86501dbf1..d6a523dcab056 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MatrixStats.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MatrixStats.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class MatrixStats extends CompoundNumericAggregate {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MatrixStatsEnclosed.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MatrixStatsEnclosed.java
index 67d60ae1a640e..c35eacb1618ac 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MatrixStatsEnclosed.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MatrixStatsEnclosed.java
@@ -5,6 +5,8 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+
 public interface MatrixStatsEnclosed extends EnclosedAgg {
 
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Max.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Max.java
index eaf2d798f6d2d..90117255dba46 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Max.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Max.java
@@ -5,16 +5,17 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isExact;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumericOrDateOrTime;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumericOrDateOrTime;
 
 /**
  * Find the maximum value in matching documents.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MedianAbsoluteDeviation.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MedianAbsoluteDeviation.java
index afdb7dd40fd3c..858f128e8dd68 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MedianAbsoluteDeviation.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/MedianAbsoluteDeviation.java
@@ -6,10 +6,10 @@
 
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Min.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Min.java
index f195517335883..7eb6cc49df7ae 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Min.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Min.java
@@ -5,16 +5,17 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isExact;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumericOrDateOrTime;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumericOrDateOrTime;
 
 /**
  * Find the minimum value in matched documents.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/NumericAggregate.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/NumericAggregate.java
index 21d5c23d23a5a..1bda9abf0edf7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/NumericAggregate.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/NumericAggregate.java
@@ -5,14 +5,15 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
 
 abstract class NumericAggregate extends AggregateFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Percentile.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Percentile.java
index a0585f4c02176..082a15da6a355 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Percentile.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Percentile.java
@@ -5,18 +5,19 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isFoldable;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isFoldable;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
 
 public class Percentile extends NumericAggregate implements EnclosedAgg {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/PercentileRank.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/PercentileRank.java
index da8c487ff31f9..146bcc9324689 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/PercentileRank.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/PercentileRank.java
@@ -5,18 +5,20 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isFoldable;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isFoldable;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
 
 public class PercentileRank extends AggregateFunction implements EnclosedAgg {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/PercentileRanks.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/PercentileRanks.java
index 5cda86e7f1634..25cad378a1bcd 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/PercentileRanks.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/PercentileRanks.java
@@ -5,9 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
 
 public class PercentileRanks extends CompoundNumericAggregate {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Percentiles.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Percentiles.java
index e4238831536ff..6440c669f55c7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Percentiles.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Percentiles.java
@@ -5,9 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
 
 public class Percentiles extends CompoundNumericAggregate {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Skewness.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Skewness.java
index 07e857f1eb8f5..dc4fb515d4f33 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Skewness.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Skewness.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class Skewness extends NumericAggregate implements MatrixStatsEnclosed {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Stats.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Stats.java
index 4da3fdd2ac573..533cb7254e73a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Stats.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Stats.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class Stats extends CompoundNumericAggregate {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/StddevPop.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/StddevPop.java
index a0521b886153c..c9c0405c615a1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/StddevPop.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/StddevPop.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class StddevPop extends NumericAggregate implements ExtendedStatsEnclosed {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Sum.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Sum.java
index 271cda6630be7..9b0a2106d3496 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Sum.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/Sum.java
@@ -5,11 +5,13 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.EnclosedAgg;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Sum all values of a field in matching documents.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/SumOfSquares.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/SumOfSquares.java
index c936d3472a7fd..757ad1c1fbf4c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/SumOfSquares.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/SumOfSquares.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class SumOfSquares extends NumericAggregate implements ExtendedStatsEnclosed {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/TopHits.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/TopHits.java
index 9364f5f4fc53f..fcbb7c120ef26 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/TopHits.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/TopHits.java
@@ -5,21 +5,23 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.TypeResolutions;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.TypeResolutions;
+import org.elasticsearch.xpack.ql.expression.function.OptionalArgument;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.Collections;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNotFoldable;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNotFoldable;
 
 /**
  * Super class of Aggregation functions on field types other than numeric, that need to be
  * translated into an ES {@link org.elasticsearch.search.aggregations.metrics.TopHits} aggregation.
  */
-public abstract class TopHits extends AggregateFunction {
+public abstract class TopHits extends AggregateFunction implements OptionalArgument {
 
     TopHits(Source source, Expression field, Expression sortField) {
         super(source, field, sortField != null ? Collections.singletonList(sortField) : Collections.emptyList());
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/VarPop.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/VarPop.java
index eec44e828db9c..81a2ed5dd24b8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/VarPop.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/aggregate/VarPop.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.aggregate;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class VarPop extends NumericAggregate implements ExtendedStatsEnclosed {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/Histogram.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/Histogram.java
index 38ded7cb09152..3937641b5b9e5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/Histogram.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/grouping/Histogram.java
@@ -6,21 +6,22 @@
 
 package org.elasticsearch.xpack.sql.expression.function.grouping;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.ZoneId;
 import java.util.Collections;
 import java.util.List;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumericOrDate;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isType;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumericOrDate;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isType;
 
 public class Histogram extends GroupingFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
index 35bc87eabd7b2..c437b704035d0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
@@ -5,19 +5,20 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 
 import java.util.Objects;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 public class Cast extends UnaryScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/CastProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/CastProcessor.java
index 6d0173c23b8f5..f381485aa5410 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/CastProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/CastProcessor.java
@@ -7,8 +7,8 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion.Conversion;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion.Conversion;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ConfigurationFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ConfigurationFunction.java
index dc49d2a950a63..d68f40ccfff6d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ConfigurationFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/ConfigurationFunction.java
@@ -6,12 +6,13 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Database.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Database.java
index 4a6836d4856e9..eb4d25bdbb520 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Database.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Database.java
@@ -6,10 +6,10 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar;
 
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 public class Database extends ConfigurationFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Processors.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Processors.java
index 64958b0cdbaaf..d324413577883 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Processors.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Processors.java
@@ -7,6 +7,7 @@
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry.Entry;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateAddProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateDiffProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DatePartProcessor;
@@ -30,22 +31,6 @@
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.ReplaceFunctionProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.SubstringFunctionProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.BucketExtractorProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ChainingProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.HitExtractorProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.CaseProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.NullIfProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.NotProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.CheckNullProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.UnaryArithmeticProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.InProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RegexProcessor;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -60,31 +45,11 @@ private Processors() {}
      */
     public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
         List<NamedWriteableRegistry.Entry> entries = new ArrayList<>();
+        
+        entries.addAll(org.elasticsearch.xpack.ql.expression.processor.Processors.getNamedWriteables());
+
         // base
-        entries.add(new Entry(Processor.class, ConstantProcessor.NAME, ConstantProcessor::new));
-        entries.add(new Entry(Processor.class, HitExtractorProcessor.NAME, HitExtractorProcessor::new));
-        entries.add(new Entry(Processor.class, BucketExtractorProcessor.NAME, BucketExtractorProcessor::new));
         entries.add(new Entry(Processor.class, CastProcessor.NAME, CastProcessor::new));
-        entries.add(new Entry(Processor.class, ChainingProcessor.NAME, ChainingProcessor::new));
-
-        // logical
-        entries.add(new Entry(Processor.class, BinaryLogicProcessor.NAME, BinaryLogicProcessor::new));
-        entries.add(new Entry(Processor.class, NotProcessor.NAME, NotProcessor::new));
-        // conditionals
-        entries.add(new Entry(Processor.class, CaseProcessor.NAME, CaseProcessor::new));
-        entries.add(new Entry(Processor.class, CheckNullProcessor.NAME, CheckNullProcessor::new));
-        entries.add(new Entry(Processor.class, ConditionalProcessor.NAME, ConditionalProcessor::new));
-        entries.add(new Entry(Processor.class, NullIfProcessor.NAME, NullIfProcessor::new));
-
-        // arithmetic
-        entries.add(new Entry(Processor.class, BinaryArithmeticProcessor.NAME, BinaryArithmeticProcessor::new));
-        entries.add(new Entry(Processor.class, UnaryArithmeticProcessor.NAME, UnaryArithmeticProcessor::new));
-        // comparators
-        entries.add(new Entry(Processor.class, BinaryComparisonProcessor.NAME, BinaryComparisonProcessor::new));
-        entries.add(new Entry(Processor.class, InProcessor.NAME, InProcessor::new));
-        // regex
-        entries.add(new Entry(Processor.class, RegexProcessor.NAME, RegexProcessor::new));
-
 
         // datetime
         entries.add(new Entry(Processor.class, DateTimeProcessor.NAME, DateTimeProcessor::new));
@@ -115,12 +80,4 @@ public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
         entries.add(new Entry(Processor.class, StDistanceProcessor.NAME, StDistanceProcessor::new));
         return entries;
     }
-
-    public static List<Object> process(List<Processor> processors, Object input) {
-        List<Object> values = new ArrayList<>(processors.size());
-        for (Processor p : processors) {
-            values.add(p.process(input));
-        }
-        return values;
-    }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/User.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/User.java
index f8b3beb1d8f52..737d10430fb7e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/User.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/User.java
@@ -6,10 +6,10 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar;
 
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 public class User extends ConfigurationFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeFunction.java
index 0cce7521a2992..66cd1b1a3add2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeFunction.java
@@ -6,16 +6,16 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isDate;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isDate;
 
 abstract class BaseDateTimeFunction extends UnaryScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeProcessor.java
index 3a4a5709e4f5f..a4a755aff4420 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BaseDateTimeProcessor.java
@@ -7,9 +7,9 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.time.ZoneId;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimeFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimeFunction.java
index f0583f57a5e21..dc68e04fcd758 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimeFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimeFunction.java
@@ -5,21 +5,21 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.function.scalar.BinaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 import java.util.List;
 import java.util.Objects;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isDate;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isString;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isDate;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isString;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 public abstract class BinaryDateTimeFunction extends BinaryScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimePipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimePipe.java
index 86209e593653c..3cc4722e2d17f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimePipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimePipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimeProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimeProcessor.java
index 2cd7b5e2de1ac..7731aba48b930 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimeProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/BinaryDateTimeProcessor.java
@@ -7,9 +7,9 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.BinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.BinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.time.ZoneId;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDate.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDate.java
index 544788da245cf..284e0601658e2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDate.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDate.java
@@ -6,10 +6,10 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.time.ZonedDateTime;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTime.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTime.java
index 16791421eb69b..0ecf891c4797e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTime.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTime.java
@@ -6,11 +6,11 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.ZonedDateTime;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentFunction.java
index 198ff03a9e6cd..30b18548ef341 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentFunction.java
@@ -6,10 +6,10 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.ConfigurationFunction;
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.time.temporal.Temporal;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentTime.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentTime.java
index dac8216e0c5af..4603941db52f4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentTime.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentTime.java
@@ -6,11 +6,11 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.session.Configuration;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.OffsetTime;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAdd.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAdd.java
index 0d737cb1d166f..fc4694c5a70b5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAdd.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAdd.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
@@ -21,9 +21,9 @@
 import java.util.function.BiFunction;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isDate;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isInteger;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isString;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isDate;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isInteger;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isString;
 
 public class DateAdd extends ThreeArgsDateTimeFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddPipe.java
index 6dbda129ecde0..fa8701c4b9d42 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddProcessor.java
index dba298aad2b99..d4ef925bfc33e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddProcessor.java
@@ -6,9 +6,9 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateAdd.Part;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.time.ZoneId;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiff.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiff.java
index b9521cbf1880d..76a461d294dec 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiff.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiff.java
@@ -5,14 +5,14 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
@@ -23,8 +23,8 @@
 import java.util.function.BiFunction;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isDate;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isString;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isDate;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isString;
 import static org.elasticsearch.xpack.sql.util.DateUtils.DAY_IN_MILLIS;
 import static org.elasticsearch.xpack.sql.util.DateUtils.UTC;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffPipe.java
index 7f12eecb9063c..d8e168a1b8057 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessor.java
index 2479148b1435f..f01fb093353ff 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessor.java
@@ -6,9 +6,9 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateDiff.Part;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.time.ZoneId;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePart.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePart.java
index 5bea85ee254b0..b84115444529b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePart.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePart.java
@@ -5,13 +5,14 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NonIsoDateTimeProcessor.NonIsoDateTimeExtractor;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
@@ -21,8 +22,6 @@
 import java.util.Set;
 import java.util.function.ToIntFunction;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NonIsoDateTimeProcessor.NonIsoDateTimeExtractor;
-
 public class DatePart extends BinaryDateTimeFunction {
 
     public enum Part implements DateTimeField {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartPipe.java
index 9eca90f845bf9..3279ba67202b1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartProcessor.java
index 616e953588f8d..80c86fdea44c7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartProcessor.java
@@ -6,16 +6,15 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DatePart.Part;
 
 import java.io.IOException;
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DatePart.Part;
-
 public class DatePartProcessor extends BinaryDateTimeProcessor {
 
     public static final String NAME = "dtpart";
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeField.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeField.java
index 9cbb6ab7f2020..f6232e80df39b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeField.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeField.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.Arrays;
 import java.util.Collections;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeFunction.java
index f4cccb9e7fd58..d4fbb998a3fc4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeFunction.java
@@ -5,20 +5,20 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
 import java.time.temporal.ChronoField;
 import java.time.temporal.Temporal;
 
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 public abstract class DateTimeFunction extends BaseDateTimeFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeHistogramFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeHistogramFunction.java
index 0cf95169d38f9..f7aeecc2d0af6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeHistogramFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeHistogramFunction.java
@@ -5,9 +5,9 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTrunc.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTrunc.java
index 695b190a1ec36..ed600286856fe 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTrunc.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTrunc.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.BinaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncPipe.java
index 3a51f25ab63f9..b06b76c15327e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncProcessor.java
index 447e2ca410c3b..23cc096878ef5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncProcessor.java
@@ -6,16 +6,15 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTrunc.Part;
 
 import java.io.IOException;
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
 import java.util.List;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTrunc.Part;
-
 public class DateTruncProcessor extends BinaryDateTimeProcessor {
 
     public static final String NAME = "dtrunc";
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayName.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayName.java
index 28972eb241844..00df7e0618dc1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayName.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayName.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NamedDateTimeProcessor.NameExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfMonth.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfMonth.java
index a228f4fe79bde..3230a721c8ac1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfMonth.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfMonth.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfWeek.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfWeek.java
index c8c0a1d568d2b..d22624192dfbc 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfWeek.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfWeek.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NonIsoDateTimeProcessor.NonIsoDateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfYear.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfYear.java
index 6a54b53802a61..436dcd5e1d7fc 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfYear.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfYear.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/HourOfDay.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/HourOfDay.java
index c15a730e25b3f..038e14d868b45 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/HourOfDay.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/HourOfDay.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/IsoDayOfWeek.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/IsoDayOfWeek.java
index 8bc5903834a0e..b18d2a45a8522 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/IsoDayOfWeek.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/IsoDayOfWeek.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/IsoWeekOfYear.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/IsoWeekOfYear.java
index 04a45b1732693..d1deeca0ecf24 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/IsoWeekOfYear.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/IsoWeekOfYear.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MinuteOfDay.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MinuteOfDay.java
index 823de40034feb..e5c1bddb6931f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MinuteOfDay.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MinuteOfDay.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MinuteOfHour.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MinuteOfHour.java
index 1136b858a7227..e72033491e96c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MinuteOfHour.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MinuteOfHour.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MonthName.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MonthName.java
index 17fbe374aacc3..b85c0e976753b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MonthName.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MonthName.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NamedDateTimeProcessor.NameExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MonthOfYear.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MonthOfYear.java
index 8265dedb7ba2e..c8c99dfa762a7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MonthOfYear.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/MonthOfYear.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NamedDateTimeFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NamedDateTimeFunction.java
index 0dada3f3c0e19..c9752052bc6d2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NamedDateTimeFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NamedDateTimeFunction.java
@@ -5,18 +5,18 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NamedDateTimeProcessor.NameExtractor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.time.ZoneId;
 
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /*
  * Base class for "named" date/time functions like month_name and day_name
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeFunction.java
index 576ed6bc9ab92..b9e8618ee2dab 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/NonIsoDateTimeFunction.java
@@ -5,18 +5,18 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NonIsoDateTimeProcessor.NonIsoDateTimeExtractor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.time.ZoneId;
 
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /*
  * Base class for date/time functions that behave differently in a non-ISO format
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/Quarter.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/Quarter.java
index f23082c7e0358..0f272e9c82425 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/Quarter.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/Quarter.java
@@ -6,17 +6,17 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.ZoneId;
 
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 public class Quarter extends BaseDateTimeFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/SecondOfMinute.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/SecondOfMinute.java
index fb83191f5bcbd..ff0f53bc891c3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/SecondOfMinute.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/SecondOfMinute.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimeFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimeFunction.java
index 6b7c0c30ae7bc..ff58acfe8fbe7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimeFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimeFunction.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 import java.util.Arrays;
@@ -18,7 +18,7 @@
 import java.util.Locale;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 public abstract class ThreeArgsDateTimeFunction extends ScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimePipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimePipe.java
index e1d60b1232b3d..2b0d951b2a261 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimePipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimePipe.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.time.ZoneId;
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimeProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimeProcessor.java
index bc22c83c325b5..3caa68b4bbd9a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimeProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/ThreeArgsDateTimeProcessor.java
@@ -7,8 +7,8 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.time.ZoneId;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/TimeFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/TimeFunction.java
index 857d8fada5bd4..dd865f33ac240 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/TimeFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/TimeFunction.java
@@ -5,17 +5,17 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.OffsetTime;
 import java.time.ZoneId;
 import java.time.temporal.ChronoField;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isDateOrTime;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isDateOrTime;
 import static org.elasticsearch.xpack.sql.util.DateUtils.asTimeAtZone;
 
 public abstract class TimeFunction extends DateTimeFunction {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/WeekOfYear.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/WeekOfYear.java
index 566d3c4443c5e..c17f7285860ea 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/WeekOfYear.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/WeekOfYear.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.NonIsoDateTimeProcessor.NonIsoDateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/Year.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/Year.java
index 0720706de226d..e97689c6b9e22 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/Year.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/Year.java
@@ -6,10 +6,10 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval;
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo.NodeCtor2;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
-import org.elasticsearch.xpack.sql.tree.NodeInfo.NodeCtor2;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessor.java
index 519e4c0c74092..f12521934d103 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessor.java
@@ -7,8 +7,9 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.function.Function;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StAswkt.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StAswkt.java
index 5c4b6edbe87eb..c7cf15b7ac830 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StAswkt.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StAswkt.java
@@ -7,11 +7,11 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoProcessor.GeoOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * ST_AsWKT function that takes a geometry and returns its Well Known Text representation
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistance.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistance.java
index fd14e90dd9d93..4c7c2dead19a9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistance.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistance.java
@@ -6,18 +6,18 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.predicate.BinaryOperator;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.predicate.BinaryOperator;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isGeo;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isGeo;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Calculates the distance between two points
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceFunction.java
index d1c15c1e2a1b2..bc4def54930fd 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceFunction.java
@@ -6,7 +6,7 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
-import org.elasticsearch.xpack.sql.expression.predicate.PredicateBiFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.PredicateBiFunction;
 
 class StDistanceFunction  implements PredicateBiFunction<Object, Object, Double> {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistancePipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistancePipe.java
index c944266482651..27c1d0c8e7c16 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistancePipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistancePipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceProcessor.java
index d6c9026b982d9..4ca6b89916eaa 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceProcessor.java
@@ -8,9 +8,10 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.gen.processor.BinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.BinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StGeometryType.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StGeometryType.java
index 15215bd9201de..6a81f4c7ce109 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StGeometryType.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StGeometryType.java
@@ -7,11 +7,11 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoProcessor.GeoOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * ST_GEOMETRY_TYPE function that takes a geometry and returns its type
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosql.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosql.java
index 04006d4a28b51..b35eef4c3150b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosql.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosql.java
@@ -6,16 +6,16 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isString;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isString;
 
 /**
  * Constructs geometric objects from their WTK representations
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessor.java
index f17ee2315befe..d2965bd6a0168 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessor.java
@@ -9,8 +9,9 @@
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StX.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StX.java
index f3cdafbe70dab..f6e348e0f0c85 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StX.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StX.java
@@ -7,11 +7,11 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoProcessor.GeoOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * ST_X function that takes a geometry and returns the X coordinate of its first point
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StY.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StY.java
index 0a9bc3aa1a40b..483292f682b26 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StY.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StY.java
@@ -7,11 +7,11 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoProcessor.GeoOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * ST_Y function that takes a geometry and returns the Y coordinate of its first point
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StZ.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StZ.java
index b6c0c9466bbe1..567e801b48482 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StZ.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StZ.java
@@ -7,11 +7,11 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoProcessor.GeoOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * ST_Z function that takes a geometry and returns the Z coordinate of its first point
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/UnaryGeoFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/UnaryGeoFunction.java
index 50c05b7fbedb7..1ff4fcc6040b2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/UnaryGeoFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/UnaryGeoFunction.java
@@ -6,21 +6,21 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.Locale;
 import java.util.Objects;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isGeo;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isGeo;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Base class for functions that get a single geo shape or geo point as an argument
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ACos.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ACos.java
index 692535019e229..0d9b750cd8c47 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ACos.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ACos.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 
 /**
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ASin.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ASin.java
index b4698bad48cc7..f642c57d0d6c4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ASin.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ASin.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Inverse_trigonometric_functions">Arc sine</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ATan.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ATan.java
index 06f5f140ac27b..5e2ff129b16d0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ATan.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ATan.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Inverse_trigonometric_functions">Arc tangent</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ATan2.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ATan2.java
index 9b15b2a67b470..16c3a5f235c8c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ATan2.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/ATan2.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryMathProcessor.BinaryMathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Atan2">Multi-valued inverse tangent</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Abs.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Abs.java
index d0c889db66f4c..9a192b0a67e96 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Abs.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Abs.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Absolute_value">Absolute value</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathPipe.java
index 5e266639d0d6b..fbbdbf6b061c3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathPipe.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryMathProcessor.BinaryMathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathProcessor.java
index f66dcf185fcb7..c5adab6bb7f3e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathProcessor.java
@@ -6,12 +6,12 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.FunctionalBinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Arithmetics;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryMathProcessor.BinaryMathOperation;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.FunctionalBinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Arithmetics;
 
 import java.io.IOException;
 import java.util.function.BiFunction;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryNumericFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryNumericFunction.java
index 98bb36d175d61..862282387b528 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryNumericFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryNumericFunction.java
@@ -5,18 +5,18 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryMathProcessor.BinaryMathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
 
 public abstract class BinaryNumericFunction extends BinaryScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalMathPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalMathPipe.java
index 0897050c97be3..d471950315c78 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalMathPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalMathPipe.java
@@ -6,12 +6,12 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryOptionalMathProcessor.BinaryOptionalMathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
@@ -63,7 +63,7 @@ protected Pipe replaceChildren(Pipe newLeft, Pipe newRight) {
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         left.collectFields(sourceBuilder);
         if (right != null) {
             right.collectFields(sourceBuilder);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalMathProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalMathProcessor.java
index dc89b6ce5cff1..7ad197c8a1071 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalMathProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalMathProcessor.java
@@ -8,8 +8,8 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalNumericFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalNumericFunction.java
index 8b6996ab64e26..bd0afb2d2ac1c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalNumericFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryOptionalNumericFunction.java
@@ -6,15 +6,15 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryOptionalMathProcessor.BinaryOptionalMathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.Arrays;
 import java.util.List;
@@ -22,9 +22,9 @@
 import java.util.Objects;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isInteger;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isInteger;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 public abstract class BinaryOptionalNumericFunction extends ScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cbrt.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cbrt.java
index d6cc7e85dcedc..5b506d9fe7a27 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cbrt.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cbrt.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Cube_root">Cube root</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Ceil.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Ceil.java
index 5c9438c677221..7d709c49123e0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Ceil.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Ceil.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Floor_and_ceiling_functions">Ceiling</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cos.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cos.java
index 48cb486121d44..f5e1c25ba2fba 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cos.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cos.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Trigonometric_functions#cosine">Cosine</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cosh.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cosh.java
index ce5bd2bcc45ff..788a0d1da4b3a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cosh.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cosh.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Hyperbolic_function">Hyperbolic cosine</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cot.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cot.java
index 060702bd62d6a..2c9d585c03911 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cot.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Cot.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Trigonometric_functions#Cosecant,_secant,_and_cotangent">Cotangent</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Degrees.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Degrees.java
index f4b9ec6080e09..0015553965052 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Degrees.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Degrees.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * Convert from <a href="https://en.wikipedia.org/wiki/Radian">radians</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/E.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/E.java
index b1b731fe91be9..b07cb57c33d67 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/E.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/E.java
@@ -6,14 +6,14 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.script.Params;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.script.Params;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 public class E extends MathFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Exp.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Exp.java
index 8eab843d17028..95e67c80a55da 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Exp.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Exp.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Exponential_function">e<sup>x</sup></a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Expm1.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Expm1.java
index 6f362fe63b864..3a8928cee4975 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Expm1.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Expm1.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Math.html#expm1-double-">e<sup>x</sup> + 1</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Floor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Floor.java
index a77a4e497d31a..e1ba4bdd3c7b4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Floor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Floor.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Floor_and_ceiling_functions">Floor</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Log.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Log.java
index 7c0f3e46bedb1..55eaaafc0784a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Log.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Log.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Natural_logarithm">Natural logarithm</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Log10.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Log10.java
index e4583d1eb8ecf..2e8e4c255226b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Log10.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Log10.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Logarithm">Logarithm</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathFunction.java
index 4389e1ac814a9..ec084f70def67 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathFunction.java
@@ -5,19 +5,19 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.Locale;
 import java.util.Objects;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
 
 public abstract class MathFunction extends UnaryScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathProcessor.java
index 2f71f63484792..7e1e13b60e9f0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathProcessor.java
@@ -8,8 +8,8 @@
 import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Random;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Pi.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Pi.java
index 79492bac3c12e..d0855016969bb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Pi.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Pi.java
@@ -6,14 +6,14 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.script.Params;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.script.Params;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 public class Pi extends MathFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Power.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Power.java
index ec4261d3f07a6..3f8acdeca0c57 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Power.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Power.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryMathProcessor.BinaryMathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 public class Power extends BinaryNumericFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Radians.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Radians.java
index ee63bfa3b0332..f61ebadcea792 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Radians.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Radians.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * Convert from <a href="https://en.wikipedia.org/wiki/Degree_(angle)">degrees</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Random.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Random.java
index 70dff7d1ccd44..11c4374024e79 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Random.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Random.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * Returns a random double (using the given seed).
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Round.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Round.java
index 98c2e75906ce0..9b353dfbe5776 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Round.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Round.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.OptionalArgument;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryOptionalMathProcessor.BinaryOptionalMathOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.List;
 
@@ -18,7 +19,7 @@
  * count digits after the decimal point. If negative, it will round the number till that paramter count
  * digits before the decimal point, starting at the decimal point.
  */
-public class Round extends BinaryOptionalNumericFunction {
+public class Round extends BinaryOptionalNumericFunction implements OptionalArgument {
     
     public Round(Source source, Expression left, Expression right) {
         super(source, left, right);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sign.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sign.java
index d9ebe34e3594c..5c70470b0e73b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sign.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sign.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Returns the sign of the given expression:
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sin.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sin.java
index 8fff2be48b3a8..e4030ad4c44b2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sin.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sin.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Trigonometric_functions#sine">Sine</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sinh.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sinh.java
index 80830af0d5cd3..0264f03224de6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sinh.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sinh.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Hyperbolic_function">Hyperbolic sine</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sqrt.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sqrt.java
index 30778a8f9791e..6eb559eeb87ca 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sqrt.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Sqrt.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Square_root">Square root</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Tan.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Tan.java
index 2c8a7ef142f15..f71fec91da003 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Tan.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Tan.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * <a href="https://en.wikipedia.org/wiki/Trigonometric_functions#sine">Tangent</a>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Truncate.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Truncate.java
index cf08c6c6eaa1f..dee6306f94bc1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Truncate.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/Truncate.java
@@ -5,10 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.math;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.OptionalArgument;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryOptionalMathProcessor.BinaryOptionalMathOperation;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.List;
 
@@ -18,7 +19,7 @@
  * parameter count digits after the decimal point. If negative, it will truncate the number till that parameter
  * count digits before the decimal point, starting at the decimal point.
  */
-public class Truncate extends BinaryOptionalNumericFunction {
+public class Truncate extends BinaryOptionalNumericFunction implements OptionalArgument {
     
     public Truncate(Source source, Expression left, Expression right) {
         super(source, left, right);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Ascii.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Ascii.java
index 65c173cb9035f..6edad9dc48930 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Ascii.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Ascii.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Returns the ASCII code of the leftmost character of the given (char) expression.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringFunction.java
index 611e86507ee5b..57a1abe58d077 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringFunction.java
@@ -5,19 +5,19 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.BinaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Locale;
 import java.util.Objects;
 import java.util.function.BiFunction;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Base class for binary functions that have the first parameter a string, the second parameter a number
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericFunction.java
index fac0646c2c611..687b49561d33f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericFunction.java
@@ -5,14 +5,14 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringNumericProcessor.BinaryStringNumericOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
 
 /**
  * A binary string function with a numeric second parameter and a string result
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericPipe.java
index f64dea2a8a081..05a8ce22b3c28 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericPipe.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringNumericProcessor.BinaryStringNumericOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericProcessor.java
index 2296b46c4b4a8..2c7e77d69c222 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericProcessor.java
@@ -6,10 +6,10 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.FunctionalBinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringNumericProcessor.BinaryStringNumericOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.FunctionalBinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.function.BiFunction;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringFunction.java
index eaa6ac428c85f..3f3db4fdaf2b9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringFunction.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
 
 /**
  * A binary string function with two string parameters and a numeric result
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringPipe.java
index 23f3940d73d08..82d5956f4b27d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringPipe.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringStringProcessor.BinaryStringStringOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringProcessor.java
index 00836d2c28441..f3ca9344c8cc2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringProcessor.java
@@ -6,10 +6,10 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.FunctionalBinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringStringProcessor.BinaryStringStringOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.FunctionalBinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.function.BiFunction;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BitLength.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BitLength.java
index 11806d4ab9951..ce308b361a119 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BitLength.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BitLength.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Returns the number of bits contained within the value expression.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Char.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Char.java
index 2216d211cd264..4a0a44b501e38 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Char.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Char.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Converts an int ASCII code to a character value.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/CharLength.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/CharLength.java
index 45f0c1e781a0a..8b6df6a5cbafb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/CharLength.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/CharLength.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Returns the length (in characters) of the string expression.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Concat.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Concat.java
index 15602bc53c880..ec9656eeb8e48 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Concat.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Concat.java
@@ -5,21 +5,21 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.function.scalar.BinaryScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.function.scalar.BinaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.string.ConcatFunctionProcessor.process;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Returns a string that is the result of concatenating the two strings received as parameters.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionPipe.java
index 03be678709459..db2e83795bea0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionProcessor.java
index 55dc1ea213f45..0effd1e1f5441 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionProcessor.java
@@ -7,10 +7,10 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.BinaryProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.BinaryProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Insert.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Insert.java
index 8cff98d4c7c80..8be5b2b24535a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Insert.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Insert.java
@@ -5,26 +5,26 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.Arrays;
 import java.util.List;
 import java.util.Locale;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.string.InsertFunctionProcessor.doProcess;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Returns a character string where length characters have been deleted from the source string, beginning at start,
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionPipe.java
index 592fbdafb5a26..764eacf757b59 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
@@ -73,7 +73,7 @@ protected Pipe replaceChildren(Pipe newSource,
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         source.collectFields(sourceBuilder);
         start.collectFields(sourceBuilder);
         length.collectFields(sourceBuilder);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionProcessor.java
index 5202ab64065ef..d40ea6177f2d3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionProcessor.java
@@ -7,8 +7,8 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LCase.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LCase.java
index 6648694929e07..74e8a51757f48 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LCase.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LCase.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Lowercases all uppercase letters in a string.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LTrim.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LTrim.java
index 92f05fa6783c3..d3339f7a8bec9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LTrim.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LTrim.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Trims the leading whitespaces.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Left.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Left.java
index 8db48e415f1a2..09f5cf9831cc8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Left.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Left.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringNumericProcessor.BinaryStringNumericOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * Returns the leftmost count characters of a string.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Length.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Length.java
index 193660e9fc4b6..4c713c8e6b8ed 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Length.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Length.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Returns the length (number of characters) in a string, excluding the trailing blanks.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Locate.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Locate.java
index 9d7f43a3e6c0b..5ac8afc7fb51a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Locate.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Locate.java
@@ -5,26 +5,27 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.OptionalArgument;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.Arrays;
 import java.util.List;
 import java.util.Locale;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isNumeric;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isNumeric;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.string.LocateFunctionProcessor.doProcess;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Returns the starting position of the first occurrence of the pattern within the source string.
@@ -33,7 +34,7 @@
  * position indicated by the value of start. The first character position in the source string is indicated by the value 1.
  * If the pattern is not found within the source string, the value 0 is returned.
  */
-public class Locate extends ScalarFunction {
+public class Locate extends ScalarFunction implements OptionalArgument {
 
     private final Expression pattern, source, start;
     
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipe.java
index b33138297a607..caa5b5cbb1958 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
@@ -64,7 +64,7 @@ protected Pipe replaceChildren(Pipe newPattern, Pipe newSource,
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         pattern.collectFields(sourceBuilder);
         source.collectFields(sourceBuilder);
         if (start != null) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionProcessor.java
index 0509efa04a766..7dd48dc1d1a6a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionProcessor.java
@@ -7,8 +7,8 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/OctetLength.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/OctetLength.java
index 63e2424708679..0f7ab3fc5f027 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/OctetLength.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/OctetLength.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Returns the number of bytes contained within the value expression.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Position.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Position.java
index 916328a2d0704..89356dbb96cd6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Position.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Position.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringStringProcessor.BinaryStringStringOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 import java.util.function.BiFunction;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/RTrim.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/RTrim.java
index 8f1f3f3f552f6..53f65067cfd54 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/RTrim.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/RTrim.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Trims the trailing whitespaces.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Repeat.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Repeat.java
index 956d2857bc6ac..f2d75bc19d0f5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Repeat.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Repeat.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringNumericProcessor.BinaryStringNumericOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * Creates a string composed of a string repeated count times.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Replace.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Replace.java
index a1150fc5d38af..b7cd60c29f9e2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Replace.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Replace.java
@@ -5,25 +5,25 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.Arrays;
 import java.util.List;
 import java.util.Locale;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.string.ReplaceFunctionProcessor.doProcess;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Search the source string for occurrences of the pattern, and replace with the replacement string.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionPipe.java
index 087dfc0bb703a..4924d5ad47d9c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
@@ -62,7 +62,7 @@ protected Pipe replaceChildren(Pipe newSource, Pipe newPattern,
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         source.collectFields(sourceBuilder);
         pattern.collectFields(sourceBuilder);
         replacement.collectFields(sourceBuilder);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionProcessor.java
index 1745874469fcd..630d0852fa1f6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionProcessor.java
@@ -8,8 +8,8 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Right.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Right.java
index 3ab7c9c8dafe3..855033f7f32cb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Right.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Right.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringNumericProcessor.BinaryStringNumericOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 /**
  * Returns the rightmost count characters of a string.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Space.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Space.java
index bad23a8ea526f..450a8f8f4caf7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Space.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Space.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Generates a string consisting of count spaces.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/StringProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/StringProcessor.java
index 6f8d7c93fc633..6767d4bc2085f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/StringProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/StringProcessor.java
@@ -8,8 +8,8 @@
 import org.apache.lucene.util.UnicodeUtil;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Substring.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Substring.java
index a341a6bb8c203..ec663bbe313e9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Substring.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/Substring.java
@@ -5,26 +5,26 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.Arrays;
 import java.util.List;
 import java.util.Locale;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isInteger;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isInteger;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.string.SubstringFunctionProcessor.doProcess;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Returns a character string that is derived from the source string, beginning at the character position specified by start
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionPipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionPipe.java
index 0805e9e325f4c..db00060bb31fb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionPipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionPipe.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Arrays;
 import java.util.List;
@@ -62,7 +62,7 @@ protected Pipe replaceChildren(Pipe newSource, Pipe newStart,
     }
 
     @Override
-    public final void collectFields(SqlSourceBuilder sourceBuilder) {
+    public final void collectFields(QlSourceBuilder sourceBuilder) {
         source.collectFields(sourceBuilder);
         start.collectFields(sourceBuilder);
         length.collectFields(sourceBuilder);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionProcessor.java
index ca30a7804c454..3501b1c18c81c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionProcessor.java
@@ -7,8 +7,8 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
 import java.io.IOException;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UCase.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UCase.java
index 1b0ad36ebf022..8011b51d62a9f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UCase.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UCase.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 /**
  * Uppercases all lowercase letters in a string.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UnaryStringFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UnaryStringFunction.java
index b2c72f0f5b6d7..e52874b5715ad 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UnaryStringFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UnaryStringFunction.java
@@ -5,22 +5,22 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.util.Locale;
 import java.util.Objects;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isStringAndExact;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isStringAndExact;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 public abstract class UnaryStringFunction extends UnaryScalarFunction {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UnaryStringIntFunction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UnaryStringIntFunction.java
index 7d9a64e59cdc2..16709bf2dc3d4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UnaryStringIntFunction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/UnaryStringIntFunction.java
@@ -5,21 +5,21 @@
  */
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions.ParamOrdinal;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions.ParamOrdinal;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.Locale;
 import java.util.Objects;
 
 import static java.lang.String.format;
-import static org.elasticsearch.xpack.sql.expression.TypeResolutions.isInteger;
-import static org.elasticsearch.xpack.sql.expression.gen.script.ParamsBuilder.paramsBuilder;
+import static org.elasticsearch.xpack.ql.expression.TypeResolutions.isInteger;
+import static org.elasticsearch.xpack.ql.expression.gen.script.ParamsBuilder.paramsBuilder;
 
 /**
  * Base unary function for text manipulating SQL functions that receive as parameter a number
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalScriptUtils.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalScriptUtils.java
new file mode 100644
index 0000000000000..de404e5c30a5c
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalScriptUtils.java
@@ -0,0 +1,11 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.sql.expression.function.scalar.whitelist;
+
+public final class InternalScriptUtils extends InternalSqlScriptUtils {
+
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalSqlScriptUtils.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalSqlScriptUtils.java
index 6b5b8c686eb1e..6778cbfcc8d2c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalSqlScriptUtils.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalSqlScriptUtils.java
@@ -8,6 +8,18 @@
 import org.elasticsearch.common.geo.GeoPoint;
 import org.elasticsearch.index.fielddata.ScriptDocValues;
 import org.elasticsearch.script.JodaCompatibleZonedDateTime;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.function.scalar.whitelist.InternalQlScriptUtils;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalDayTime;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalYearMonth;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.CaseProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.NullIfProcessor;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.UnaryArithmeticProcessor.UnaryArithmeticOperation;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.RegexProcessor.RegexOperation;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateAddProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateDiffProcessor;
@@ -19,7 +31,6 @@
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.QuarterProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.TimeFunction;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoProcessor;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StDistanceProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StWkttosqlProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.BinaryMathProcessor.BinaryMathOperation;
@@ -33,23 +44,7 @@
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.ReplaceFunctionProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.StringProcessor.StringOperation;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.SubstringFunctionProcessor;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalDayTime;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.CaseProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalProcessor.ConditionalOperation;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.NullIfProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogicProcessor.BinaryLogicOperation;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.NotProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.CheckNullProcessor.CheckNullOperation;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.BinaryArithmeticProcessor.BinaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.UnaryArithmeticProcessor.UnaryArithmeticOperation;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparisonProcessor.BinaryComparisonOperation;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.InProcessor;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RegexProcessor.RegexOperation;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion;
 import org.elasticsearch.xpack.sql.util.DateUtils;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.time.Duration;
 import java.time.OffsetTime;
@@ -65,96 +60,9 @@
  * (to simplify the whitelist definition).
  */
 @SuppressWarnings("unused")
-public final class InternalSqlScriptUtils {
+public class InternalSqlScriptUtils extends InternalQlScriptUtils {
 
-    private InternalSqlScriptUtils() {}
-
-    //
-    // Utilities
-    //
-
-    // safe missing mapping/value extractor
-    public static <T> Object docValue(Map<String, ScriptDocValues<T>> doc, String fieldName) {
-        if (doc.containsKey(fieldName)) {
-            ScriptDocValues<T> docValues = doc.get(fieldName);
-            if (!docValues.isEmpty()) {
-                return docValues.get(0);
-            }
-        }
-        return null;
-    }
-
-    public static boolean nullSafeFilter(Boolean filter) {
-        return filter == null ? false : filter.booleanValue();
-    }
-
-    public static double nullSafeSortNumeric(Number sort) {
-        return sort == null ? 0.0d : sort.doubleValue();
-    }
-
-    public static String nullSafeSortString(Object sort) {
-        return sort == null ? StringUtils.EMPTY : sort.toString();
-    }
-
-
-    //
-    // Operators
-    //
-
-    //
-    // Logical
-    //
-    public static Boolean eq(Object left, Object right) {
-        return BinaryComparisonOperation.EQ.apply(left, right);
-    }
-
-    public static Boolean nulleq(Object left, Object right) {
-        return BinaryComparisonOperation.NULLEQ.apply(left, right);
-    }
-
-    public static Boolean neq(Object left, Object right) {
-        return BinaryComparisonOperation.NEQ.apply(left, right);
-    }
-
-    public static Boolean lt(Object left, Object right) {
-        return BinaryComparisonOperation.LT.apply(left, right);
-    }
-
-    public static Boolean lte(Object left, Object right) {
-        return BinaryComparisonOperation.LTE.apply(left, right);
-    }
-
-    public static Boolean gt(Object left, Object right) {
-        return BinaryComparisonOperation.GT.apply(left, right);
-    }
-
-    public static Boolean gte(Object left, Object right) {
-        return BinaryComparisonOperation.GTE.apply(left, right);
-    }
-
-    public static Boolean and(Boolean left, Boolean right) {
-        return BinaryLogicOperation.AND.apply(left, right);
-    }
-
-    public static Boolean or(Boolean left, Boolean right) {
-        return BinaryLogicOperation.OR.apply(left, right);
-    }
-
-    public static Boolean not(Boolean expression) {
-        return NotProcessor.apply(expression);
-    }
-
-    public static Boolean isNull(Object expression) {
-        return CheckNullOperation.IS_NULL.apply(expression);
-    }
-
-    public static Boolean isNotNull(Object expression) {
-        return CheckNullOperation.IS_NOT_NULL.apply(expression);
-    }
-
-    public static Boolean in(Object value, List<Object> values) {
-        return InProcessor.apply(value, values);
-    }
+    InternalSqlScriptUtils() {}
 
     //
     // Conditional
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ScorePipe.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ScorePipe.java
index c8bf1463f10dd..aa2ce6f8a7ee8 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ScorePipe.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/gen/pipeline/ScorePipe.java
@@ -5,13 +5,14 @@
  */
 package org.elasticsearch.xpack.sql.expression.gen.pipeline;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.HitExtractorProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.execution.search.extractor.ScoreExtractor;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.processor.HitExtractorProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
 
 import java.util.List;
 
@@ -53,7 +54,7 @@ public Pipe resolveAttributes(AttributeResolver resolver) {
     }
 
     @Override
-    public void collectFields(SqlSourceBuilder sourceBuilder) {
+    public void collectFields(QlSourceBuilder sourceBuilder) {
         sourceBuilder.trackScores();
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/SqlLiterals.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/SqlLiterals.java
new file mode 100644
index 0000000000000..affc0c86e9d88
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/literal/SqlLiterals.java
@@ -0,0 +1,31 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.sql.expression.literal;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.literal.Literals;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+
+public final class SqlLiterals {
+
+    private SqlLiterals() {}
+
+    /**
+     * All custom types that are not serializable by default can be be serialized as a part of Cursor (i.e as constant in ConstantProcessor)
+     * should implement NamedWriteables interface and register their de-serialization methods here.
+     */
+    public static Collection<? extends NamedWriteableRegistry.Entry> getNamedWriteables() {
+        List<NamedWriteableRegistry.Entry> entries = new ArrayList<>(Literals.getNamedWriteables());
+        entries.add(new NamedWriteableRegistry.Entry(GeoShape.class, GeoShape.NAME, GeoShape::new));
+
+        return entries;
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
index ce23010c8bd98..5c947ebce5829 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
@@ -5,27 +5,64 @@
  */
 package org.elasticsearch.xpack.sql.optimizer;
 
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeMap;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.ExpressionSet;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.expression.ReferenceAttribute;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.InnerAggregate;
+import org.elasticsearch.xpack.ql.expression.predicate.BinaryOperator;
+import org.elasticsearch.xpack.ql.expression.predicate.BinaryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.Negatable;
+import org.elasticsearch.xpack.ql.expression.predicate.Predicates;
+import org.elasticsearch.xpack.ql.expression.predicate.Range;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.ArbitraryConditionalFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Case;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Coalesce;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfConditional;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.And;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Not;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Or;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.IsNotNull;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.IsNull;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparison;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.GreaterThan;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.GreaterThanOrEqual;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.In;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.LessThan;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.LessThanOrEqual;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NotEquals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NullEquals;
+import org.elasticsearch.xpack.ql.plan.logical.Aggregate;
+import org.elasticsearch.xpack.ql.plan.logical.EsRelation;
+import org.elasticsearch.xpack.ql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.plan.logical.Limit;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.OrderBy;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.plan.logical.UnaryPlan;
+import org.elasticsearch.xpack.ql.rule.Rule;
+import org.elasticsearch.xpack.ql.rule.RuleExecutor;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
+import org.elasticsearch.xpack.ql.util.Holder;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer.CleanAliases;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.ExpressionSet;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.ExtendedStats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.ExtendedStatsEnclosed;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.First;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Last;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.MatrixStats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.MatrixStatsEnclosed;
@@ -38,48 +75,11 @@
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Stats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
-import org.elasticsearch.xpack.sql.expression.predicate.BinaryOperator;
-import org.elasticsearch.xpack.sql.expression.predicate.BinaryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.Negatable;
-import org.elasticsearch.xpack.sql.expression.predicate.Predicates;
-import org.elasticsearch.xpack.sql.expression.predicate.Range;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.ArbitraryConditionalFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Case;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Coalesce;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfConditional;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.And;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Not;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Or;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.IsNotNull;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.IsNull;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparison;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.GreaterThan;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.GreaterThanOrEqual;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.In;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.LessThan;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.LessThanOrEqual;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NotEquals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NullEquals;
-import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
-import org.elasticsearch.xpack.sql.plan.logical.EsRelation;
-import org.elasticsearch.xpack.sql.plan.logical.Filter;
-import org.elasticsearch.xpack.sql.plan.logical.Limit;
 import org.elasticsearch.xpack.sql.plan.logical.LocalRelation;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.plan.logical.SubQueryAlias;
-import org.elasticsearch.xpack.sql.plan.logical.UnaryPlan;
-import org.elasticsearch.xpack.sql.rule.Rule;
-import org.elasticsearch.xpack.sql.rule.RuleExecutor;
 import org.elasticsearch.xpack.sql.session.EmptyExecutable;
 import org.elasticsearch.xpack.sql.session.SingletonExecutable;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.util.CollectionUtils;
-import org.elasticsearch.xpack.sql.util.Holder;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -94,16 +94,16 @@
 import java.util.function.Consumer;
 
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.expression.Expressions.equalsAsAttribute;
-import static org.elasticsearch.xpack.sql.expression.Literal.FALSE;
-import static org.elasticsearch.xpack.sql.expression.Literal.TRUE;
-import static org.elasticsearch.xpack.sql.expression.predicate.Predicates.combineAnd;
-import static org.elasticsearch.xpack.sql.expression.predicate.Predicates.combineOr;
-import static org.elasticsearch.xpack.sql.expression.predicate.Predicates.inCommon;
-import static org.elasticsearch.xpack.sql.expression.predicate.Predicates.splitAnd;
-import static org.elasticsearch.xpack.sql.expression.predicate.Predicates.splitOr;
-import static org.elasticsearch.xpack.sql.expression.predicate.Predicates.subtract;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
+import static org.elasticsearch.xpack.ql.expression.Expressions.equalsAsAttribute;
+import static org.elasticsearch.xpack.ql.expression.Literal.FALSE;
+import static org.elasticsearch.xpack.ql.expression.Literal.TRUE;
+import static org.elasticsearch.xpack.ql.expression.predicate.Predicates.combineAnd;
+import static org.elasticsearch.xpack.ql.expression.predicate.Predicates.combineOr;
+import static org.elasticsearch.xpack.ql.expression.predicate.Predicates.inCommon;
+import static org.elasticsearch.xpack.ql.expression.predicate.Predicates.splitAnd;
+import static org.elasticsearch.xpack.ql.expression.predicate.Predicates.splitOr;
+import static org.elasticsearch.xpack.ql.expression.predicate.Predicates.subtract;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 
 
 public class Optimizer extends RuleExecutor<LogicalPlan> {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/package-info.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/package-info.java
index 2a55be6e8163f..635af54eb0ef4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/package-info.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/package-info.java
@@ -56,9 +56,9 @@
  * <h2>Concepts</h2>
  *
  * The building operation of the SQL engine is defined by an action,
- * namely a rule (defined in {@link org.elasticsearch.xpack.sql.rule rule}
+ * namely a rule (defined in {@link org.elasticsearch.xpack.ql.rule rule}
  * package that accepts one <i>immutable</i> tree (defined in
- * {@link org.elasticsearch.xpack.sql.tree tree} package) and transforms
+ * {@link org.elasticsearch.xpack.ql.tree tree} package) and transforms
  * it to another <i>immutable</i> tree.
  * Each rules looks for a certain <i>pattern</i> that it can identify and
  * then transform.
@@ -118,9 +118,9 @@
  * To implement the above concepts, several choices have been made in the
  * engine (which are not common in the rest of the XPack code base). In
  * particular the conventions/signatures of
- * {@link org.elasticsearch.xpack.sql.tree.Node tree}s and usage of
+ * {@link org.elasticsearch.xpack.ql.tree.Node tree}s and usage of
  * {@code instanceof} inside
- * {@link org.elasticsearch.xpack.sql.rule.Rule rule}s).
+ * {@link org.elasticsearch.xpack.ql.rule.Rule rule}s).
  * Java doesn't provide any utilities for tree abstractions or pattern
  * matching for that matter. Typically for tree traversal one would employ
  * the <a href="https://en.wikipedia.org/wiki/Visitor_pattern">Visitor</a>
@@ -143,7 +143,7 @@
  * {@code instanceof} checks. Which is how many rules are implemented in
  * the SQL engine as well. Where possible though, one can use <i>typed</i>
  * traversal by passing a {@code Class} token to the lambdas (i.e.
- * {@link org.elasticsearch.xpack.sql.tree.Node#transformDown(java.util.function.Function, Class)
+ * {@link org.elasticsearch.xpack.ql.tree.Node#transformDown(java.util.function.Function, Class)
  * pre-order transformation}).
  *
  * <h2>Components</h2>
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/AbstractBuilder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/AbstractBuilder.java
index aa5af5389a796..734b0fa5c7f61 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/AbstractBuilder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/AbstractBuilder.java
@@ -10,9 +10,9 @@
 import org.antlr.v4.runtime.misc.Interval;
 import org.antlr.v4.runtime.tree.ParseTree;
 import org.antlr.v4.runtime.tree.TerminalNode;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.tree.Location;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.Location;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.util.Check;
 
 import java.util.ArrayList;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/AstBuilder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/AstBuilder.java
index 48aa2cf1fa79b..e61333989a65c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/AstBuilder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/AstBuilder.java
@@ -6,8 +6,8 @@
 package org.elasticsearch.xpack.sql.parser;
 
 import org.antlr.v4.runtime.Token;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.SingleStatementContext;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
 
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/CommandBuilder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/CommandBuilder.java
index 6de27b7776338..d64359128752a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/CommandBuilder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/CommandBuilder.java
@@ -7,8 +7,11 @@
 
 import org.antlr.v4.runtime.Token;
 import org.elasticsearch.common.Booleans;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver.IndexType;
-import org.elasticsearch.xpack.sql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.index.IndexResolver.IndexType;
+import org.elasticsearch.xpack.ql.plan.TableIdentifier;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.DebugContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.ExplainContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.ShowColumnsContext;
@@ -19,7 +22,6 @@
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.SysColumnsContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.SysTablesContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.SysTypesContext;
-import org.elasticsearch.xpack.sql.plan.TableIdentifier;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.plan.logical.command.Debug;
 import org.elasticsearch.xpack.sql.plan.logical.command.Explain;
@@ -31,8 +33,6 @@
 import org.elasticsearch.xpack.sql.plan.logical.command.sys.SysTables;
 import org.elasticsearch.xpack.sql.plan.logical.command.sys.SysTypes;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.util.ArrayList;
 import java.util.EnumSet;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ExpressionBuilder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ExpressionBuilder.java
index 524d4e8b75a8e..3a00de63c1732 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ExpressionBuilder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ExpressionBuilder.java
@@ -12,54 +12,58 @@
 import org.elasticsearch.common.Booleans;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.collect.Tuple;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Alias;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.expression.Order.NullsPosition;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAlias;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.expression.UnresolvedStar;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction;
+import org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction.ResolutionType;
+import org.elasticsearch.xpack.ql.expression.literal.Interval;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalDayTime;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalYearMonth;
+import org.elasticsearch.xpack.ql.expression.literal.Intervals;
+import org.elasticsearch.xpack.ql.expression.literal.Intervals.TimeUnit;
+import org.elasticsearch.xpack.ql.expression.predicate.Range;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Case;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfConditional;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MatchQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MultiMatchQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.StringQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.And;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Not;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Or;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.IsNotNull;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.IsNull;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Add;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Div;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mod;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mul;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Neg;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Sub;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.GreaterThan;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.GreaterThanOrEqual;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.In;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.LessThan;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.LessThanOrEqual;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NotEquals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NullEquals;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.Like;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.RLike;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypes;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.expression.Exists;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.expression.Order.NullsPosition;
 import org.elasticsearch.xpack.sql.expression.ScalarSubquery;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAlias;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
-import org.elasticsearch.xpack.sql.expression.UnresolvedStar;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction;
-import org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction.ResolutionType;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
-import org.elasticsearch.xpack.sql.expression.literal.Interval;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalDayTime;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
-import org.elasticsearch.xpack.sql.expression.literal.Intervals;
-import org.elasticsearch.xpack.sql.expression.literal.Intervals.TimeUnit;
-import org.elasticsearch.xpack.sql.expression.predicate.Range;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Case;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfConditional;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MatchQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MultiMatchQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.StringQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.And;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Not;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Or;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.IsNotNull;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.IsNull;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Add;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Div;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mod;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mul;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Neg;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Sub;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.GreaterThan;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.GreaterThanOrEqual;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.In;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.LessThan;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.LessThanOrEqual;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NotEquals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NullEquals;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.Like;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RLike;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.ArithmeticBinaryContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.ArithmeticUnaryContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.BooleanLiteralContext;
@@ -110,10 +114,6 @@
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.TimestampEscapedLiteralContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.ValueExpressionDefaultContext;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.time.Duration;
 import java.time.Period;
@@ -128,7 +128,7 @@
 
 import static java.util.Collections.emptyList;
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.type.DataTypeConversion.conversionFor;
+import static org.elasticsearch.xpack.ql.type.DataTypeConversion.conversionFor;
 import static org.elasticsearch.xpack.sql.util.DateUtils.asDateOnly;
 import static org.elasticsearch.xpack.sql.util.DateUtils.asTimeOnly;
 import static org.elasticsearch.xpack.sql.util.DateUtils.ofEscapedLiteral;
@@ -668,7 +668,7 @@ public Literal visitDecimalLiteral(DecimalLiteralContext ctx) {
 
         try {
             return new Literal(tuple.v1(), Double.valueOf(StringUtils.parseDouble(tuple.v2())), DataType.DOUBLE);
-        } catch (SqlIllegalArgumentException siae) {
+        } catch (QlIllegalArgumentException siae) {
             throw new ParsingException(tuple.v1(), siae.getMessage());
         }
     }
@@ -680,7 +680,7 @@ public Literal visitIntegerLiteral(IntegerLiteralContext ctx) {
         long value;
         try {
             value = Long.valueOf(StringUtils.parseLong(tuple.v2()));
-        } catch (SqlIllegalArgumentException siae) {
+        } catch (QlIllegalArgumentException siae) {
             throw new ParsingException(tuple.v1(), siae.getMessage());
         }
 
@@ -706,7 +706,7 @@ public Literal visitParamLiteral(ParamLiteralContext ctx) {
         final DataType sourceType;
         try {
             sourceType = DataTypes.fromJava(param.value);
-        } catch (SqlIllegalArgumentException ex) {
+        } catch (QlIllegalArgumentException ex) {
             throw new ParsingException(ex, source, "Unexpected actual parameter type [{}] for type [{}]", param.value.getClass().getName(),
                     param.type);
         }
@@ -717,7 +717,7 @@ public Literal visitParamLiteral(ParamLiteralContext ctx) {
         // otherwise we need to make sure that xcontent-serialized value is converted to the correct type
         try {
             return new Literal(source, conversionFor(sourceType, dataType).convert(param.value), dataType);
-        } catch (SqlIllegalArgumentException ex) {
+        } catch (QlIllegalArgumentException ex) {
             throw new ParsingException(ex, source, "Unexpected actual parameter type [{}] for type [{}]", sourceType, param.type);
         }
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/IdentifierBuilder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/IdentifierBuilder.java
index e391850dd1776..027b80bbe8bf7 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/IdentifierBuilder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/IdentifierBuilder.java
@@ -7,11 +7,11 @@
 
 import org.antlr.v4.runtime.tree.ParseTree;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.xpack.ql.plan.TableIdentifier;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.IdentifierContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.QualifiedNameContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.TableIdentifierContext;
-import org.elasticsearch.xpack.sql.plan.TableIdentifier;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 abstract class IdentifierBuilder extends AbstractBuilder {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/LogicalPlanBuilder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/LogicalPlanBuilder.java
index 9a663994ccf16..2d3b2d0dfbc67 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/LogicalPlanBuilder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/LogicalPlanBuilder.java
@@ -8,13 +8,23 @@
 import org.antlr.v4.runtime.ParserRuleContext;
 import org.antlr.v4.runtime.Token;
 import org.antlr.v4.runtime.tree.TerminalNode;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAlias;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAlias;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.plan.TableIdentifier;
+import org.elasticsearch.xpack.ql.plan.logical.Aggregate;
+import org.elasticsearch.xpack.ql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.plan.logical.Limit;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.OrderBy;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.plan.logical.UnresolvedRelation;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.AliasedQueryContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.AliasedRelationContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.FromClauseContext;
@@ -35,24 +45,14 @@
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.SetQuantifierContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.SubqueryContext;
 import org.elasticsearch.xpack.sql.parser.SqlBaseParser.TableNameContext;
-import org.elasticsearch.xpack.sql.plan.TableIdentifier;
-import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
 import org.elasticsearch.xpack.sql.plan.logical.Distinct;
-import org.elasticsearch.xpack.sql.plan.logical.Filter;
 import org.elasticsearch.xpack.sql.plan.logical.Join;
-import org.elasticsearch.xpack.sql.plan.logical.Limit;
 import org.elasticsearch.xpack.sql.plan.logical.LocalRelation;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.plan.logical.SubQueryAlias;
-import org.elasticsearch.xpack.sql.plan.logical.UnresolvedRelation;
 import org.elasticsearch.xpack.sql.plan.logical.With;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
 import org.elasticsearch.xpack.sql.session.SingletonExecutable;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.ArrayList;
 import java.util.LinkedHashMap;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ParsingException.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ParsingException.java
index a4a2a8df94089..74f5e0a033266 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ParsingException.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/ParsingException.java
@@ -6,12 +6,12 @@
 package org.elasticsearch.xpack.sql.parser;
 
 import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.xpack.sql.ClientSqlException;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.sql.SqlClientException;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 
-public class ParsingException extends ClientSqlException {
+public class ParsingException extends SqlClientException {
     private final int line;
     private final int charPositionInLine;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/SqlParser.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/SqlParser.java
index 6166d87703ead..b61d07078eeca 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/SqlParser.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/parser/SqlParser.java
@@ -24,8 +24,8 @@
 import org.antlr.v4.runtime.tree.TerminalNode;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
 
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Distinct.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Distinct.java
index 92282045f8a6c..d8a0eed8300b6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Distinct.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Distinct.java
@@ -5,8 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.plan.logical;
 
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.UnaryPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 public class Distinct extends UnaryPlan {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Join.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Join.java
index f09b43ec41ddb..80103bcea0080 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Join.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Join.java
@@ -5,18 +5,20 @@
  */
 package org.elasticsearch.xpack.sql.plan.logical;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.plan.logical.BinaryPlan;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.List;
 import java.util.Objects;
 
 import static java.util.stream.Collectors.toList;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 
 public class Join extends BinaryPlan {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LocalRelation.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LocalRelation.java
index 9abe6fef3d4bb..442ef99e3778b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LocalRelation.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/LocalRelation.java
@@ -6,12 +6,13 @@
 package org.elasticsearch.xpack.sql.plan.logical;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.Executable;
-import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.sql.session.Session;
 
 import java.util.List;
 import java.util.Objects;
@@ -52,7 +53,7 @@ public List<Attribute> output() {
     }
 
     @Override
-    public void execute(SqlSession session, ActionListener<Page> listener) {
+    public void execute(Session session, ActionListener<Page> listener) {
         executable.execute(session, listener);
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Pivot.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Pivot.java
index 35447ecb40510..55cec8d80a6fd 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Pivot.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/Pivot.java
@@ -6,19 +6,21 @@
 
 package org.elasticsearch.xpack.sql.plan.logical;
 
+import org.elasticsearch.xpack.ql.capabilities.Resolvables;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeMap;
+import org.elasticsearch.xpack.ql.expression.AttributeSet;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.UnaryPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.capabilities.Resolvables;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.AttributeSet;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.LinkedHashMap;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/SubQueryAlias.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/SubQueryAlias.java
index dd8fa5bec430e..f86051d986e64 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/SubQueryAlias.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/SubQueryAlias.java
@@ -5,9 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.plan.logical;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.UnaryPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/With.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/With.java
index 6c30aab11b994..f2167169fe232 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/With.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/With.java
@@ -5,12 +5,14 @@
  */
 package org.elasticsearch.xpack.sql.plan.logical;
 
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.UnaryPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.Map;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-
 public class With extends UnaryPlan {
     private final Map<String, SubQueryAlias> subQueries;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Command.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Command.java
index 0b9766345869d..30511f78f7714 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Command.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Command.java
@@ -5,24 +5,24 @@
  */
 package org.elasticsearch.xpack.sql.plan.logical.command;
 
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
-import org.elasticsearch.xpack.sql.session.Executable;
 import org.elasticsearch.xpack.sql.session.ListCursor;
 import org.elasticsearch.xpack.sql.session.Rows;
+import org.elasticsearch.xpack.sql.session.SqlExecutable;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
 
 import java.util.List;
 
 import static java.util.Collections.emptyList;
 import static java.util.Collections.emptyMap;
 
-public abstract class Command extends LogicalPlan implements Executable {
+public abstract class Command extends LogicalPlan implements SqlExecutable {
 
     protected Command(Source source) {
         super(source, emptyList());
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Debug.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Debug.java
index eda730e8adbb0..a8ed20a1c6d6c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Debug.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Debug.java
@@ -6,21 +6,21 @@
 package org.elasticsearch.xpack.sql.plan.logical.command;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.rule.RuleExecutor.Batch;
-import org.elasticsearch.xpack.sql.rule.RuleExecutor.ExecutionInfo;
-import org.elasticsearch.xpack.sql.rule.RuleExecutor.Transformation;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.rule.RuleExecutor.Batch;
+import org.elasticsearch.xpack.ql.rule.RuleExecutor.ExecutionInfo;
+import org.elasticsearch.xpack.ql.rule.RuleExecutor.Transformation;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.NodeUtils;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
+import org.elasticsearch.xpack.ql.util.Graphviz;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.Rows;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.Node;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.NodeUtils;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
-import org.elasticsearch.xpack.sql.util.Graphviz;
 
 import java.util.LinkedHashMap;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Explain.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Explain.java
index d3eac1cd6bbb3..7f7d5c9a0528f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Explain.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/Explain.java
@@ -7,19 +7,19 @@
 
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.plan.QueryPlan;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.plan.QueryPlan;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
+import org.elasticsearch.xpack.ql.util.Graphviz;
 import org.elasticsearch.xpack.sql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.sql.planner.Planner;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.Rows;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
-import org.elasticsearch.xpack.sql.util.Graphviz;
 
 import java.util.HashMap;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowColumns.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowColumns.java
index 33643fa0f9ff0..80795323b485c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowColumns.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowColumns.java
@@ -6,16 +6,16 @@
 package org.elasticsearch.xpack.sql.plan.logical.command;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -84,7 +84,7 @@ private void fillInRows(Map<String, EsField> mapping, String prefix, List<List<?
             String name = e.getKey();
             if (dt != null) {
                 // show only fields that exist in ES
-                rows.add(asList(prefix != null ? prefix + "." + name : name, dt.sqlName(), dt.typeName));
+                rows.add(asList(prefix != null ? prefix + "." + name : name, dt.sqlName(), dt.typeName()));
                 if (field.getProperties().isEmpty() == false) {
                     String newPrefix = prefix != null ? prefix + "." + name : name;
                     fillInRows(field.getProperties(), newPrefix, rows);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowFunctions.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowFunctions.java
index e30c252fe3247..ebd7f7112f4be 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowFunctions.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowFunctions.java
@@ -6,16 +6,17 @@
 package org.elasticsearch.xpack.sql.plan.logical.command;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.function.FunctionDefinition;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.FunctionDefinition;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionTypeRegistry;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
 
 import java.util.Collection;
 import java.util.List;
@@ -52,9 +53,8 @@ public List<Attribute> output() {
     public void execute(SqlSession session, ActionListener<Page> listener) {
         FunctionRegistry registry = session.functionRegistry();
         Collection<FunctionDefinition> functions = registry.listFunctions(pattern != null ? pattern.asJavaRegex() : null);
-
         listener.onResponse(of(session, functions.stream()
-                .map(f -> asList(f.name(), f.type().name()))
+                .map(f -> asList(f.name(), SqlFunctionTypeRegistry.INSTANCE.type(f.clazz())))
                 .collect(toList())));
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowSchemas.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowSchemas.java
index 6ebcfb2b16b20..c4d70301a5b2e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowSchemas.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowSchemas.java
@@ -6,14 +6,14 @@
 package org.elasticsearch.xpack.sql.plan.logical.command;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.Rows;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowTables.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowTables.java
index 4cdeae3ef5010..5f5f6498f2bed 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowTables.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowTables.java
@@ -6,13 +6,13 @@
 package org.elasticsearch.xpack.sql.plan.logical.command;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver.IndexType;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.index.IndexResolver.IndexType;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.EnumSet;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumns.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumns.java
index a1bb62b00215f..790028385e5b3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumns.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumns.java
@@ -8,20 +8,20 @@
 import org.apache.lucene.util.Counter;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypes;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.proto.Mode;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.Rows;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.sql.DatabaseMetaData;
 import java.util.ArrayList;
@@ -31,8 +31,8 @@
 import java.util.regex.Pattern;
 
 import static java.util.Arrays.asList;
-import static org.elasticsearch.xpack.sql.type.DataType.INTEGER;
-import static org.elasticsearch.xpack.sql.type.DataType.SHORT;
+import static org.elasticsearch.xpack.ql.type.DataType.INTEGER;
+import static org.elasticsearch.xpack.ql.type.DataType.SHORT;
 
 /**
  * System command designed to be used by JDBC / ODBC for column metadata, such as
@@ -167,11 +167,11 @@ private static void fillInRows(String clusterName, String indexName, Map<String,
                             null,
                             indexName,
                             name,
-                            odbcCompatible(type.sqlType.getVendorTypeNumber(), isOdbcClient),
+                            odbcCompatible(type.sqlType().getVendorTypeNumber(), isOdbcClient),
                             type.toString(),
                             type.displaySize,
                             // TODO: is the buffer_length correct?
-                            type.size,
+                            type.size(),
                             // no DECIMAL support
                             null,
                             odbcCompatible(DataTypes.metaSqlRadix(type), isOdbcClient),
@@ -186,7 +186,7 @@ private static void fillInRows(String clusterName, String indexName, Map<String,
                             // SQL_DATETIME_SUB ?
                             odbcCompatible(DataTypes.metaSqlDateTimeSub(type), isOdbcClient),
                             // char octet length
-                            type.isString() || type == DataType.BINARY ? type.size : null,
+                            type.isString() || type == DataType.BINARY ? type.size() : null,
                             // position
                             (int) position.get(),
                             "YES",
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTables.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTables.java
index 190224c583c0b..1c5597042dcb3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTables.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTables.java
@@ -6,16 +6,16 @@
 package org.elasticsearch.xpack.sql.plan.logical.command.sys;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver.IndexInfo;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver.IndexType;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.index.IndexResolver.IndexInfo;
+import org.elasticsearch.xpack.ql.index.IndexResolver.IndexType;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.Rows;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.Comparator;
@@ -27,8 +27,8 @@
 
 import static java.util.Arrays.asList;
 import static java.util.stream.Collectors.toList;
-import static org.elasticsearch.xpack.sql.util.StringUtils.EMPTY;
-import static org.elasticsearch.xpack.sql.util.StringUtils.SQL_WILDCARD;
+import static org.elasticsearch.xpack.ql.util.StringUtils.EMPTY;
+import static org.elasticsearch.xpack.ql.util.StringUtils.SQL_WILDCARD;
 
 public class SysTables extends Command {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTypes.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTypes.java
index 95ba2346c3ef4..45b2c09759e57 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTypes.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTypes.java
@@ -6,14 +6,14 @@
 package org.elasticsearch.xpack.sql.plan.logical.command.sys;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataTypes;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.DataTypes;
 
 import java.sql.DatabaseMetaData;
 import java.util.Comparator;
@@ -22,9 +22,9 @@
 
 import static java.util.Arrays.asList;
 import static java.util.stream.Collectors.toList;
-import static org.elasticsearch.xpack.sql.type.DataType.BOOLEAN;
-import static org.elasticsearch.xpack.sql.type.DataType.INTEGER;
-import static org.elasticsearch.xpack.sql.type.DataType.SHORT;
+import static org.elasticsearch.xpack.ql.type.DataType.BOOLEAN;
+import static org.elasticsearch.xpack.ql.type.DataType.INTEGER;
+import static org.elasticsearch.xpack.ql.type.DataType.SHORT;
 
 /**
  * System command designed to be used by JDBC / ODBC for column metadata.
@@ -74,13 +74,13 @@ public List<Attribute> output() {
     public final void execute(SqlSession session, ActionListener<Page> listener) {
         Stream<DataType> values = Stream.of(DataType.values());
         if (type.intValue() != 0) {
-            values = values.filter(t -> type.equals(t.sqlType.getVendorTypeNumber()));
+            values = values.filter(t -> type.equals(t.sqlType().getVendorTypeNumber()));
         }
         List<List<?>> rows = values
                 // sort by SQL int type (that's what the JDBC/ODBC specs want) followed by name
-                .sorted(Comparator.comparing((DataType t) -> t.sqlType.getVendorTypeNumber()).thenComparing(DataType::sqlName))
+                .sorted(Comparator.comparing((DataType t) -> t.sqlType().getVendorTypeNumber()).thenComparing(DataType::sqlName))
                 .map(t -> asList(t.toString(),
-                        t.sqlType.getVendorTypeNumber(),
+                        t.sqlType().getVendorTypeNumber(),
                         DataTypes.precision(t),
                         "'",
                         "'",
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/AggregateExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/AggregateExec.java
index 763744f1abab0..ec3b04d36b95d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/AggregateExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/AggregateExec.java
@@ -5,12 +5,13 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/BinaryExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/BinaryExec.java
index 0510e840eea1d..923fff1385777 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/BinaryExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/BinaryExec.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.Arrays;
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.tree.Source;
-
 abstract class BinaryExec extends PhysicalPlan {
 
     private final PhysicalPlan left, right;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/CommandExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/CommandExec.java
index 43a7bfac4628b..3da3949e09a16 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/CommandExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/CommandExec.java
@@ -6,12 +6,12 @@
 package org.elasticsearch.xpack.sql.plan.physical;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/EsQueryExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/EsQueryExec.java
index 6e132fb687110..a4b210c8b5af4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/EsQueryExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/EsQueryExec.java
@@ -6,13 +6,13 @@
 package org.elasticsearch.xpack.sql.plan.physical;
 
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.execution.search.Querier;
-import org.elasticsearch.xpack.sql.expression.Attribute;
 import org.elasticsearch.xpack.sql.querydsl.container.QueryContainer;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/FilterExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/FilterExec.java
index f8ea6eac37c84..fd0fa82f895a1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/FilterExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/FilterExec.java
@@ -5,14 +5,14 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-
 public class FilterExec extends UnaryExec implements Unexecutable {
 
     private final Expression condition;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LeafExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LeafExec.java
index 515915820d82f..6f3ad370ea214 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LeafExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LeafExec.java
@@ -5,13 +5,18 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.sql.session.Cursor.Page;
+import org.elasticsearch.xpack.sql.session.Session;
+import org.elasticsearch.xpack.sql.session.SqlSession;
+
 import java.util.Collections;
 import java.util.List;
 
-import org.elasticsearch.xpack.sql.tree.Source;
+public abstract class LeafExec extends PhysicalPlan {
 
-abstract class LeafExec extends PhysicalPlan {
-    LeafExec(Source source) {
+    protected LeafExec(Source source) {
         super(source, Collections.emptyList());
     }
 
@@ -19,4 +24,11 @@ abstract class LeafExec extends PhysicalPlan {
     public final LeafExec replaceChildren(List<PhysicalPlan> newChildren) {
         throw new UnsupportedOperationException("this type of node doesn't have any children to replace");
     }
+
+    @Override
+    public void execute(Session session, ActionListener<Page> listener) {
+        execute((SqlSession) session, listener);
+    }
+
+    abstract void execute(SqlSession session, ActionListener<Page> listener);
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LimitExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LimitExec.java
index 25795296d5ae0..cca353f5d522e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LimitExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LimitExec.java
@@ -5,11 +5,11 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
-import java.util.Objects;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
+import java.util.Objects;
 
 public class LimitExec extends UnaryExec implements Unexecutable {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LocalExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LocalExec.java
index c0adb1a98659a..65de11cd9b53c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LocalExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/LocalExec.java
@@ -6,13 +6,13 @@
 package org.elasticsearch.xpack.sql.plan.physical;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.EmptyExecutable;
 import org.elasticsearch.xpack.sql.session.Executable;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/OrderExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/OrderExec.java
index 5311ce21b9c31..e7c82c4f4651d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/OrderExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/OrderExec.java
@@ -5,13 +5,13 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-
 public class OrderExec extends UnaryExec implements Unexecutable {
 
     private final List<Order> order;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/PhysicalPlan.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/PhysicalPlan.java
index e1cef71d36520..9df80ef5b7117 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/PhysicalPlan.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/PhysicalPlan.java
@@ -5,13 +5,13 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
-import java.util.List;
-
-import org.elasticsearch.xpack.sql.plan.QueryPlan;
+import org.elasticsearch.xpack.ql.plan.QueryPlan;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.Schema;
 import org.elasticsearch.xpack.sql.session.Executable;
 import org.elasticsearch.xpack.sql.session.Rows;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.Schema;
+
+import java.util.List;
 
 /**
  * A PhysicalPlan is "how" a LogicalPlan (the "what") actually gets translated into one or more queries.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/PivotExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/PivotExec.java
index 579a53696eec1..3133147020609 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/PivotExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/PivotExec.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.List;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/ProjectExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/ProjectExec.java
index bb498e0261224..caafe83660376 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/ProjectExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/ProjectExec.java
@@ -5,15 +5,15 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-
 public class ProjectExec extends UnaryExec implements Unexecutable {
 
     private final List<? extends NamedExpression> projections;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/UnaryExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/UnaryExec.java
index b057c38f16e41..d474d55d773df 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/UnaryExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/UnaryExec.java
@@ -5,18 +5,18 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.tree.Source;
+
 import java.util.Collections;
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.tree.Source;
-
-abstract class UnaryExec extends PhysicalPlan {
+public abstract class UnaryExec extends PhysicalPlan {
 
     private final PhysicalPlan child;
 
-    UnaryExec(Source source, PhysicalPlan child) {
+    protected UnaryExec(Source source, PhysicalPlan child) {
         super(source, Collections.singletonList(child));
         this.child = child;
     }
@@ -28,6 +28,7 @@ public final PhysicalPlan replaceChildren(List<PhysicalPlan> newChildren) {
         }
         return replaceChild(newChildren.get(0));
     }
+
     protected abstract UnaryExec replaceChild(PhysicalPlan newChild);
 
     public PhysicalPlan child() {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/Unexecutable.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/Unexecutable.java
index a32d2f889909c..3aa2441e6ef1b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/Unexecutable.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/Unexecutable.java
@@ -9,14 +9,14 @@
 import org.elasticsearch.xpack.sql.planner.PlanningException;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.session.Executable;
-import org.elasticsearch.xpack.sql.session.SqlSession;
+import org.elasticsearch.xpack.sql.session.Session;
 
 
 // this is mainly a marker interface to validate a plan before being executed
 public interface Unexecutable extends Executable {
 
     @Override
-    default void execute(SqlSession session, ActionListener<Page> listener) {
+    default void execute(Session session, ActionListener<Page> listener) {
         throw new PlanningException("Current plan {} is not executable", this);
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/UnplannedExec.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/UnplannedExec.java
index b8c909fc1c374..db0e7d05f4827 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/UnplannedExec.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plan/physical/UnplannedExec.java
@@ -5,14 +5,18 @@
  */
 package org.elasticsearch.xpack.sql.plan.physical;
 
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.sql.planner.PlanningException;
+import org.elasticsearch.xpack.sql.session.Cursor.Page;
+import org.elasticsearch.xpack.sql.session.SqlSession;
+
 import java.util.List;
 import java.util.Objects;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-
 public class UnplannedExec extends LeafExec implements Unexecutable {
 
     private final LogicalPlan plan;
@@ -36,6 +40,11 @@ public List<Attribute> output() {
         return plan.output();
     }
 
+    @Override
+    void execute(SqlSession session, ActionListener<Page> listener) {
+        throw new PlanningException("Current plan {} is not executable", this);
+    }
+
     @Override
     public int hashCode() {
         return plan.hashCode();
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/FoldingException.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/FoldingException.java
index 7cdd26d540432..ce7b550dfe259 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/FoldingException.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/FoldingException.java
@@ -6,13 +6,13 @@
 package org.elasticsearch.xpack.sql.planner;
 
 import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.xpack.sql.ClientSqlException;
-import org.elasticsearch.xpack.sql.tree.Location;
-import org.elasticsearch.xpack.sql.tree.Node;
+import org.elasticsearch.xpack.ql.tree.Location;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.sql.SqlClientException;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 
-public class FoldingException extends ClientSqlException {
+public class FoldingException extends SqlClientException {
 
     private final int line;
     private final int column;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Mapper.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Mapper.java
index 522d5a944dc50..b3a1f10317f6f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Mapper.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Mapper.java
@@ -5,17 +5,20 @@
  */
 package org.elasticsearch.xpack.sql.planner;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
-import org.elasticsearch.xpack.sql.plan.logical.EsRelation;
-import org.elasticsearch.xpack.sql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.plan.logical.Aggregate;
+import org.elasticsearch.xpack.ql.plan.logical.EsRelation;
+import org.elasticsearch.xpack.ql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.plan.logical.Limit;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.OrderBy;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.rule.Rule;
+import org.elasticsearch.xpack.ql.rule.RuleExecutor;
+import org.elasticsearch.xpack.ql.util.ReflectionUtils;
 import org.elasticsearch.xpack.sql.plan.logical.Join;
-import org.elasticsearch.xpack.sql.plan.logical.Limit;
 import org.elasticsearch.xpack.sql.plan.logical.LocalRelation;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.plan.logical.With;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.plan.physical.AggregateExec;
@@ -30,9 +33,6 @@
 import org.elasticsearch.xpack.sql.plan.physical.ProjectExec;
 import org.elasticsearch.xpack.sql.plan.physical.UnplannedExec;
 import org.elasticsearch.xpack.sql.querydsl.container.QueryContainer;
-import org.elasticsearch.xpack.sql.rule.Rule;
-import org.elasticsearch.xpack.sql.rule.RuleExecutor;
-import org.elasticsearch.xpack.sql.util.ReflectionUtils;
 
 import java.util.Arrays;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Planner.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Planner.java
index b6651821a9b64..ac293fd3384d9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Planner.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Planner.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.planner;
 
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.tree.Node;
 import org.elasticsearch.xpack.sql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.sql.planner.Verifier.Failure;
-import org.elasticsearch.xpack.sql.tree.Node;
 
 import java.util.List;
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/PlanningException.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/PlanningException.java
index 8b5f282973c18..8a013fee2f951 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/PlanningException.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/PlanningException.java
@@ -6,14 +6,14 @@
 package org.elasticsearch.xpack.sql.planner;
 
 import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.xpack.sql.ClientSqlException;
+import org.elasticsearch.xpack.ql.tree.Location;
+import org.elasticsearch.xpack.sql.SqlClientException;
 import org.elasticsearch.xpack.sql.planner.Verifier.Failure;
-import org.elasticsearch.xpack.sql.tree.Location;
 
 import java.util.Collection;
 import java.util.stream.Collectors;
 
-public class PlanningException extends ClientSqlException {
+public class PlanningException extends SqlClientException {
     public PlanningException(String message, Object... args) {
         super(message, args);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryFolder.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryFolder.java
index 72e4ca380fd33..663ef503cc16c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryFolder.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryFolder.java
@@ -6,40 +6,42 @@
 package org.elasticsearch.xpack.sql.planner;
 
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.xpack.ql.execution.search.AggRef;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeMap;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.expression.ReferenceAttribute;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.Functions;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.Count;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.InnerAggregate;
+import org.elasticsearch.xpack.ql.expression.function.grouping.GroupingFunction;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.AggPathInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.UnaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.literal.IntervalYearMonth;
+import org.elasticsearch.xpack.ql.expression.literal.Intervals;
+import org.elasticsearch.xpack.ql.rule.Rule;
+import org.elasticsearch.xpack.ql.rule.RuleExecutor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.execution.search.AggRef;
-import org.elasticsearch.xpack.sql.execution.search.FieldExtraction;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.Functions;
 import org.elasticsearch.xpack.sql.expression.function.Score;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.CompoundNumericAggregate;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
-import org.elasticsearch.xpack.sql.expression.function.grouping.GroupingFunction;
 import org.elasticsearch.xpack.sql.expression.function.grouping.Histogram;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeHistogramFunction;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.Year;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.AggPathInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.UnaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth;
-import org.elasticsearch.xpack.sql.expression.literal.Intervals;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
 import org.elasticsearch.xpack.sql.plan.physical.AggregateExec;
 import org.elasticsearch.xpack.sql.plan.physical.EsQueryExec;
@@ -73,8 +75,6 @@
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Missing;
 import org.elasticsearch.xpack.sql.querydsl.container.TopHitsAggRef;
 import org.elasticsearch.xpack.sql.querydsl.query.Query;
-import org.elasticsearch.xpack.sql.rule.Rule;
-import org.elasticsearch.xpack.sql.rule.RuleExecutor;
 import org.elasticsearch.xpack.sql.session.EmptyExecutable;
 import org.elasticsearch.xpack.sql.util.Check;
 import org.elasticsearch.xpack.sql.util.DateUtils;
@@ -88,11 +88,11 @@
 import java.util.Map.Entry;
 import java.util.concurrent.atomic.AtomicReference;
 
+import static org.elasticsearch.xpack.ql.type.DataType.DATE;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 import static org.elasticsearch.xpack.sql.planner.QueryTranslator.and;
 import static org.elasticsearch.xpack.sql.planner.QueryTranslator.toAgg;
 import static org.elasticsearch.xpack.sql.planner.QueryTranslator.toQuery;
-import static org.elasticsearch.xpack.sql.type.DataType.DATE;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
 
 /**
  * Folds the PhysicalPlan into a {@link Query}.
@@ -625,7 +625,7 @@ private static Tuple<QueryContainer, AggPathInput> addAggFunction(GroupByKey gro
 
             if (f instanceof InnerAggregate) {
                 InnerAggregate ia = (InnerAggregate) f;
-                CompoundNumericAggregate outer = ia.outer();
+                CompoundNumericAggregate outer = (CompoundNumericAggregate) ia.outer();
                 String cAggPath = compoundAggMap.get(outer);
 
                 // the compound agg hasn't been seen before so initialize it
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryTranslator.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryTranslator.java
index 149999a880214..434b338020899 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryTranslator.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/QueryTranslator.java
@@ -9,17 +9,45 @@
 import org.elasticsearch.geometry.Geometry;
 import org.elasticsearch.geometry.Point;
 import org.elasticsearch.search.sort.SortOrder;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.Count;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.predicate.Range;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MatchQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MultiMatchQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.StringQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.And;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Not;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Or;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.IsNotNull;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.IsNull;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.BinaryComparison;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.GreaterThan;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.GreaterThanOrEqual;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.In;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.LessThan;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.LessThanOrEqual;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NotEquals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NullEquals;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.Like;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.RLike;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.RegexMatch;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.util.Holder;
+import org.elasticsearch.xpack.ql.util.ReflectionUtils;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Avg;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.CompoundNumericAggregate;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.Count;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.ExtendedStats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.First;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Last;
@@ -32,33 +60,8 @@
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Stats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Sum;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.TopHits;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.StDistance;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.predicate.Range;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MatchQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MultiMatchQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.StringQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.And;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Not;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Or;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.IsNotNull;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.IsNull;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.BinaryComparison;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.GreaterThan;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.GreaterThanOrEqual;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.In;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.LessThan;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.LessThanOrEqual;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NotEquals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NullEquals;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.Like;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RLike;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RegexMatch;
 import org.elasticsearch.xpack.sql.querydsl.agg.AggFilter;
 import org.elasticsearch.xpack.sql.querydsl.agg.AndAggFilter;
 import org.elasticsearch.xpack.sql.querydsl.agg.AvgAgg;
@@ -91,10 +94,7 @@
 import org.elasticsearch.xpack.sql.querydsl.query.TermQuery;
 import org.elasticsearch.xpack.sql.querydsl.query.TermsQuery;
 import org.elasticsearch.xpack.sql.querydsl.query.WildcardQuery;
-import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.util.Check;
-import org.elasticsearch.xpack.sql.util.Holder;
-import org.elasticsearch.xpack.sql.util.ReflectionUtils;
 
 import java.time.OffsetTime;
 import java.time.ZonedDateTime;
@@ -104,9 +104,9 @@
 import java.util.function.Supplier;
 
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.expression.Expressions.id;
-import static org.elasticsearch.xpack.sql.expression.Foldables.doubleValuesOf;
-import static org.elasticsearch.xpack.sql.expression.Foldables.valueOf;
+import static org.elasticsearch.xpack.ql.expression.Expressions.id;
+import static org.elasticsearch.xpack.ql.expression.Foldables.doubleValuesOf;
+import static org.elasticsearch.xpack.ql.expression.Foldables.valueOf;
 
 final class QueryTranslator {
 
@@ -373,10 +373,10 @@ protected QueryTranslation asQuery(MultiMatchQueryPredicate q, boolean onAggs) {
         }
     }
 
-    static class BinaryLogic extends ExpressionTranslator<org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogic> {
+    static class BinaryLogic extends ExpressionTranslator<org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogic> {
 
         @Override
-        protected QueryTranslation asQuery(org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogic e, boolean onAggs) {
+        protected QueryTranslation asQuery(org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogic e, boolean onAggs) {
             if (e instanceof And) {
                 return and(e.source(), toQuery(e.left(), onAggs), toQuery(e.right(), onAggs));
             }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Verifier.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Verifier.java
index fe4ec05ab33a8..6b9683d439db1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Verifier.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/planner/Verifier.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.planner;
 
-import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.InnerAggregate;
+import org.elasticsearch.xpack.ql.tree.Node;
 import org.elasticsearch.xpack.sql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.sql.plan.physical.PivotExec;
 import org.elasticsearch.xpack.sql.plan.physical.Unexecutable;
 import org.elasticsearch.xpack.sql.plan.physical.UnplannedExec;
-import org.elasticsearch.xpack.sql.tree.Node;
 
 import java.util.ArrayList;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/SqlPlugin.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/SqlPlugin.java
index 7e5b8cedff32f..59ebc6547d995 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/SqlPlugin.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/SqlPlugin.java
@@ -33,12 +33,12 @@
 import org.elasticsearch.xpack.core.XPackSettings;
 import org.elasticsearch.xpack.core.action.XPackInfoFeatureAction;
 import org.elasticsearch.xpack.core.action.XPackUsageFeatureAction;
+import org.elasticsearch.xpack.ql.index.IndexResolver;
 import org.elasticsearch.xpack.sql.SqlInfoTransportAction;
 import org.elasticsearch.xpack.sql.SqlUsageTransportAction;
 import org.elasticsearch.xpack.sql.action.SqlClearCursorAction;
 import org.elasticsearch.xpack.sql.action.SqlQueryAction;
 import org.elasticsearch.xpack.sql.action.SqlTranslateAction;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver;
 import org.elasticsearch.xpack.sql.execution.PlanExecutor;
 
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TextFormat.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TextFormat.java
index 5a415703bb785..dd837e65315aa 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TextFormat.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TextFormat.java
@@ -8,6 +8,7 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.action.BasicFormatter;
 import org.elasticsearch.xpack.sql.action.SqlQueryResponse;
@@ -15,7 +16,6 @@
 import org.elasticsearch.xpack.sql.session.Cursor;
 import org.elasticsearch.xpack.sql.session.Cursors;
 import org.elasticsearch.xpack.sql.util.DateUtils;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlClearCursorAction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlClearCursorAction.java
index 6d3802c341f1d..55224edbc8a2a 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlClearCursorAction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlClearCursorAction.java
@@ -11,6 +11,7 @@
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.action.SqlClearCursorRequest;
 import org.elasticsearch.xpack.sql.action.SqlClearCursorResponse;
 import org.elasticsearch.xpack.sql.execution.PlanExecutor;
@@ -19,7 +20,6 @@
 import org.elasticsearch.xpack.sql.session.Cursor;
 import org.elasticsearch.xpack.sql.session.Cursors;
 import org.elasticsearch.xpack.sql.util.DateUtils;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import static org.elasticsearch.xpack.sql.action.SqlClearCursorAction.NAME;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlQueryAction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlQueryAction.java
index 97da20902a0d3..0ed2baea42572 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlQueryAction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlQueryAction.java
@@ -17,6 +17,7 @@
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.XPackSettings;
 import org.elasticsearch.xpack.core.security.SecurityContext;
+import org.elasticsearch.xpack.ql.type.Schema;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.action.SqlQueryAction;
 import org.elasticsearch.xpack.sql.action.SqlQueryRequest;
@@ -29,7 +30,6 @@
 import org.elasticsearch.xpack.sql.session.Cursors;
 import org.elasticsearch.xpack.sql.session.RowSet;
 import org.elasticsearch.xpack.sql.session.SchemaRowSet;
-import org.elasticsearch.xpack.sql.type.Schema;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -95,9 +95,9 @@ static SqlQueryResponse createResponseWithSchema(SqlQueryRequest request, Page p
         List<ColumnInfo> columns = new ArrayList<>(rowSet.columnCount());
         for (Schema.Entry entry : rowSet.schema()) {
             if (Mode.isDriver(request.mode())) {
-                columns.add(new ColumnInfo("", entry.name(), entry.type().typeName, entry.type().displaySize));
+                columns.add(new ColumnInfo("", entry.name(), entry.type().typeName(), entry.type().displaySize));
             } else {
-                columns.add(new ColumnInfo("", entry.name(), entry.type().typeName));
+                columns.add(new ColumnInfo("", entry.name(), entry.type().typeName()));
             }
         }
         columns = unmodifiableList(columns);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlTranslateAction.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlTranslateAction.java
index b37c25fcab933..57f8fdefd45d0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlTranslateAction.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/plugin/TransportSqlTranslateAction.java
@@ -55,7 +55,7 @@ protected void doExecute(Task task, SqlTranslateRequest request, ActionListener<
         Configuration cfg = new Configuration(request.zoneId(), request.fetchSize(),
                 request.requestTimeout(), request.pageTimeout(), request.filter(),
                 request.mode(), request.clientId(),
-                username(securityContext), clusterName(clusterService), Protocol.FIELD_MULTI_VALUE_LENIENCY, 
+                username(securityContext), clusterName(clusterService), Protocol.FIELD_MULTI_VALUE_LENIENCY,
                 Protocol.INDEX_INCLUDE_FROZEN);
 
         planExecutor.searchSource(cfg, request.query(), request.params(), ActionListener.wrap(
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/AggFilter.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/AggFilter.java
index 1f972989e3782..ca69d52a39964 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/AggFilter.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/AggFilter.java
@@ -7,8 +7,8 @@
 
 import org.elasticsearch.script.Script;
 import org.elasticsearch.search.aggregations.PipelineAggregationBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
 import org.elasticsearch.xpack.sql.util.Check;
 
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/Aggs.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/Aggs.java
index 94f854c29f0b8..eb85965007895 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/Aggs.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/Aggs.java
@@ -9,10 +9,10 @@
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeValuesSourceBuilder;
 import org.elasticsearch.search.aggregations.bucket.filter.FiltersAggregationBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Direction;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -21,7 +21,7 @@
 
 import static java.util.Collections.emptyList;
 import static org.elasticsearch.index.query.QueryBuilders.matchAllQuery;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 
 /**
  * SQL Aggregations associated with a query.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/AndAggFilter.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/AndAggFilter.java
index 503c88ea7fc0c..cf822a127fbcc 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/AndAggFilter.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/AndAggFilter.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.agg;
 
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
 
 public class AndAggFilter extends AggFilter {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByDateHistogram.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByDateHistogram.java
index 3d1cf5649ed3b..7319027ea4783 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByDateHistogram.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByDateHistogram.java
@@ -8,8 +8,8 @@
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeValuesSourceBuilder;
 import org.elasticsearch.search.aggregations.bucket.composite.DateHistogramValuesSourceBuilder;
 import org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Direction;
 
 import java.time.ZoneId;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByKey.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByKey.java
index df207269eec0f..cf2f7c56c03e4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByKey.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByKey.java
@@ -7,9 +7,9 @@
 
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeValuesSourceBuilder;
 import org.elasticsearch.search.aggregations.support.ValueType;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Direction;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByNumericHistogram.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByNumericHistogram.java
index a03faede75f37..e8b9a262da5a4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByNumericHistogram.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByNumericHistogram.java
@@ -7,7 +7,7 @@
 
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeValuesSourceBuilder;
 import org.elasticsearch.search.aggregations.bucket.composite.HistogramValuesSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Direction;
 
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByValue.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByValue.java
index 12e09dbc52d24..7612fa1d2ccbb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByValue.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/GroupByValue.java
@@ -7,7 +7,7 @@
 
 import org.elasticsearch.search.aggregations.bucket.composite.CompositeValuesSourceBuilder;
 import org.elasticsearch.search.aggregations.bucket.composite.TermsValuesSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Direction;
 
 /**
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/OrAggFilter.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/OrAggFilter.java
index 4c5ab50b2627e..ebc0c086c0a2d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/OrAggFilter.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/OrAggFilter.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.agg;
 
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
 
 public class OrAggFilter extends AggFilter {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/TopHitsAgg.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/TopHitsAgg.java
index 741d83aab5123..efc9aebf98dc1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/TopHitsAgg.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/agg/TopHitsAgg.java
@@ -9,7 +9,7 @@
 import org.elasticsearch.search.sort.FieldSortBuilder;
 import org.elasticsearch.search.sort.SortBuilder;
 import org.elasticsearch.search.sort.SortOrder;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -44,13 +44,13 @@ AggregationBuilder toBuilder() {
                 new FieldSortBuilder(sortField)
                     .order(sortOrder)
                     .missing(LAST.position())
-                    .unmappedType(sortFieldDataType.esType));
+                    .unmappedType(sortFieldDataType.esType()));
         }
         sortBuilderList.add(
                 new FieldSortBuilder(fieldName())
                     .order(sortOrder)
                     .missing(LAST.position())
-                    .unmappedType(fieldDataType.esType));
+                    .unmappedType(fieldDataType.esType()));
 
         return topHits(id()).docValueField(fieldName(), fieldDataType.format()).sorts(sortBuilderList).size(1);
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AggregateSort.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AggregateSort.java
index 966f5c5079664..50eb7efb4b1bc 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AggregateSort.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AggregateSort.java
@@ -6,7 +6,7 @@
 
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AttributeSort.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AttributeSort.java
index d1dd2d17a94e4..cb6a42745b580 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AttributeSort.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/AttributeSort.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ComputedRef.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ComputedRef.java
index e1aa6032c0501..6b109d39799cf 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ComputedRef.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ComputedRef.java
@@ -5,9 +5,9 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.FieldExtraction;
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
 
 public class ComputedRef implements FieldExtraction {
 
@@ -27,7 +27,7 @@ public boolean supportedByAggsOnlyQuery() {
     }
 
     @Override
-    public void collectFields(SqlSourceBuilder sourceBuilder) {
+    public void collectFields(QlSourceBuilder sourceBuilder) {
         processor.collectFields(sourceBuilder);
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/FieldReference.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/FieldReference.java
index 271fbfd57d2fa..18fd5776b5a11 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/FieldReference.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/FieldReference.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
 
 public abstract class FieldReference implements FieldExtraction {
     /**
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/GlobalCountRef.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/GlobalCountRef.java
index 8c16f6dd545f2..ebd484ea60678 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/GlobalCountRef.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/GlobalCountRef.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.AggRef;
+import org.elasticsearch.xpack.ql.execution.search.AggRef;
 
 /**
  * Aggregation reference pointing to the (so called) global count, meaning
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/GroupByRef.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/GroupByRef.java
index 1dc8d1ae60ad6..8c07200086341 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/GroupByRef.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/GroupByRef.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.AggRef;
+import org.elasticsearch.xpack.ql.execution.search.AggRef;
 
 /**
  * Reference to a GROUP BY agg (typically this gets translated to a composite key).
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/MetricAggRef.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/MetricAggRef.java
index f1602df4c0e79..fa91428e47f88 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/MetricAggRef.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/MetricAggRef.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.AggRef;
+import org.elasticsearch.xpack.ql.execution.search.AggRef;
 import org.elasticsearch.xpack.sql.querydsl.agg.Aggs;
 
 /**
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/PivotColumnRef.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/PivotColumnRef.java
index 60ee3b7409c09..5ab78c09cbdec 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/PivotColumnRef.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/PivotColumnRef.java
@@ -6,8 +6,8 @@
 
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.AggRef;
-import org.elasticsearch.xpack.sql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.execution.search.AggRef;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
 
 public class PivotColumnRef extends AggRef {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainer.java
index 2e388f94af3e5..a049e7de145b9 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainer.java
@@ -11,19 +11,21 @@
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.xpack.ql.execution.search.FieldExtraction;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeMap;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.scalar.ScalarFunction;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.ConstantInput;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.execution.search.FieldExtraction;
 import org.elasticsearch.xpack.sql.execution.search.SourceGenerator;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
 import org.elasticsearch.xpack.sql.expression.function.Score;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
-import org.elasticsearch.xpack.sql.expression.function.scalar.ScalarFunction;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.ConstantInput;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
 import org.elasticsearch.xpack.sql.expression.gen.pipeline.ScorePipe;
 import org.elasticsearch.xpack.sql.querydsl.agg.Aggs;
 import org.elasticsearch.xpack.sql.querydsl.agg.GroupByKey;
@@ -32,8 +34,6 @@
 import org.elasticsearch.xpack.sql.querydsl.query.MatchAll;
 import org.elasticsearch.xpack.sql.querydsl.query.NestedQuery;
 import org.elasticsearch.xpack.sql.querydsl.query.Query;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.io.IOException;
 import java.util.AbstractMap;
@@ -52,7 +52,7 @@
 import static java.util.Collections.emptyMap;
 import static java.util.Collections.emptySet;
 import static java.util.Collections.singletonMap;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 
 /**
  * Container for various references of the built ES query.
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ScriptFieldRef.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ScriptFieldRef.java
index c89b986a4f2bf..6b763690ef5f4 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ScriptFieldRef.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ScriptFieldRef.java
@@ -5,8 +5,8 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
 
 public class ScriptFieldRef extends FieldReference {
 
@@ -28,7 +28,7 @@ public ScriptTemplate script() {
     }
 
     @Override
-    public void collectFields(SqlSourceBuilder sourceBuilder) {
+    public void collectFields(QlSourceBuilder sourceBuilder) {
         sourceBuilder.addScriptField(name, script.toPainless());
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ScriptSort.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ScriptSort.java
index 604bb3b8a0c61..284b60f1c1478 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ScriptSort.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/ScriptSort.java
@@ -5,8 +5,8 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/SearchHitFieldRef.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/SearchHitFieldRef.java
index 6ecf189d99a54..7dec3498a465c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/SearchHitFieldRef.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/SearchHitFieldRef.java
@@ -5,8 +5,8 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.SqlSourceBuilder;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 public class SearchHitFieldRef extends FieldReference {
     private final String name;
@@ -52,7 +52,7 @@ public boolean useDocValue() {
     }
 
     @Override
-    public void collectFields(SqlSourceBuilder sourceBuilder) {
+    public void collectFields(QlSourceBuilder sourceBuilder) {
         // nested fields are handled by inner hits
         if (hitName != null) {
             return;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/Sort.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/Sort.java
index 33a9865b64f3c..c37677cb74f97 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/Sort.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/Sort.java
@@ -6,8 +6,8 @@
 package org.elasticsearch.xpack.sql.querydsl.container;
 
 import org.elasticsearch.search.sort.SortOrder;
-import org.elasticsearch.xpack.sql.expression.Order.NullsPosition;
-import org.elasticsearch.xpack.sql.expression.Order.OrderDirection;
+import org.elasticsearch.xpack.ql.expression.Order.NullsPosition;
+import org.elasticsearch.xpack.ql.expression.Order.OrderDirection;
 
 public abstract class Sort {
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/TopHitsAggRef.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/TopHitsAggRef.java
index 740c655c5069b..4d1e105c70011 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/TopHitsAggRef.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/container/TopHitsAggRef.java
@@ -5,8 +5,8 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.container;
 
-import org.elasticsearch.xpack.sql.execution.search.AggRef;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.execution.search.AggRef;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 /**
  * Reference to a TopHits aggregation.
@@ -33,6 +33,6 @@ public DataType fieldDataType() {
 
     @Override
     public String toString() {
-        return ">" + name + "[" + fieldDataType.typeName + "]";
+        return ">" + name + "[" + fieldDataType.typeName() + "]";
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/BoolQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/BoolQuery.java
index 2b7033309cf85..446a7d12737f0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/BoolQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/BoolQuery.java
@@ -8,7 +8,7 @@
 import org.elasticsearch.index.query.BoolQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.search.sort.NestedSortBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/ExistsQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/ExistsQuery.java
index 07aad6d260af3..e639e1cfe3a82 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/ExistsQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/ExistsQuery.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.sql.querydsl.query;
 
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import static org.elasticsearch.index.query.QueryBuilders.existsQuery;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/GeoDistanceQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/GeoDistanceQuery.java
index dd1a1171c1603..351bde8d9f182 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/GeoDistanceQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/GeoDistanceQuery.java
@@ -8,7 +8,7 @@
 import org.elasticsearch.common.unit.DistanceUnit;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/LeafQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/LeafQuery.java
index f1252d90fa42e..c96d53c909c64 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/LeafQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/LeafQuery.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.sql.querydsl.query;
 
 import org.elasticsearch.search.sort.NestedSortBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 abstract class LeafQuery extends Query {
     LeafQuery(Source source) {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MatchAll.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MatchAll.java
index 260bb34b27a89..82d5a12d23547 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MatchAll.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MatchAll.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.sql.querydsl.query;
 
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import static org.elasticsearch.index.query.QueryBuilders.matchAllQuery;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MatchQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MatchQuery.java
index 3fca7630bd5a6..86a7004eb449d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MatchQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MatchQuery.java
@@ -11,8 +11,8 @@
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MatchQueryPredicate;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MatchQueryPredicate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Collections;
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MultiMatchQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MultiMatchQuery.java
index ab6190ad6eee1..0704d1fb3310b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MultiMatchQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/MultiMatchQuery.java
@@ -11,8 +11,8 @@
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MultiMatchQueryPredicate;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MultiMatchQueryPredicate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Map;
 import java.util.Objects;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/NestedQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/NestedQuery.java
index 59703da23abc4..91aa7211cdd93 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/NestedQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/NestedQuery.java
@@ -12,7 +12,7 @@
 import org.elasticsearch.search.fetch.StoredFieldsContext;
 import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.search.sort.NestedSortBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.AbstractMap;
 import java.util.ArrayList;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/NotQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/NotQuery.java
index 3115ab26a07f8..19e978f6e89b1 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/NotQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/NotQuery.java
@@ -7,7 +7,7 @@
 
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.search.sort.NestedSortBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/Query.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/Query.java
index de7ff8e0f648c..6d35823b20bcb 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/Query.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/Query.java
@@ -7,7 +7,7 @@
 
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.search.sort.NestedSortBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 /**
  * Intermediate representation of queries that is rewritten to fetch
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/QueryStringQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/QueryStringQuery.java
index a81d1d1c9dae7..b774e95bf86aa 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/QueryStringQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/QueryStringQuery.java
@@ -13,8 +13,8 @@
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.index.query.QueryStringQueryBuilder;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.StringQueryPredicate;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.StringQueryPredicate;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Collections;
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/RangeQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/RangeQuery.java
index 3b7bc21bb0079..e64993c3202a5 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/RangeQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/RangeQuery.java
@@ -5,12 +5,12 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.query;
 
-import java.util.Objects;
-
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.RangeQueryBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
+
+import java.util.Objects;
 
 import static org.elasticsearch.index.query.QueryBuilders.rangeQuery;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/RegexQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/RegexQuery.java
index c8459791eb404..eaa166aa3a10c 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/RegexQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/RegexQuery.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.query;
 
-import java.util.Objects;
-
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
+
+import java.util.Objects;
 
 import static org.elasticsearch.index.query.QueryBuilders.regexpQuery;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/ScriptQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/ScriptQuery.java
index 396ea283951e0..af1919efab391 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/ScriptQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/ScriptQuery.java
@@ -6,9 +6,9 @@
 package org.elasticsearch.xpack.sql.querydsl.query;
 
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
-import org.elasticsearch.xpack.sql.expression.gen.script.Scripts;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.expression.gen.script.Scripts;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Objects;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermQuery.java
index 5d488338b8642..2c10ae8d666a2 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermQuery.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.query;
 
-import java.util.Objects;
-
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
+
+import java.util.Objects;
 
 import static org.elasticsearch.index.query.QueryBuilders.termQuery;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermsQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermsQuery.java
index 9b7f59c011ed5..116b69ce7213b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermsQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/TermsQuery.java
@@ -6,9 +6,9 @@
 package org.elasticsearch.xpack.sql.querydsl.query;
 
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.Collections;
 import java.util.LinkedHashSet;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/WildcardQuery.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/WildcardQuery.java
index 11b776e90fbef..337d3339614b6 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/WildcardQuery.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/querydsl/query/WildcardQuery.java
@@ -5,10 +5,10 @@
  */
 package org.elasticsearch.xpack.sql.querydsl.query;
 
-import java.util.Objects;
-
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.Source;
+
+import java.util.Objects;
 
 import static org.elasticsearch.index.query.QueryBuilders.wildcardQuery;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Configuration.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Configuration.java
index 5b9901ccae447..39f1606624643 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Configuration.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Configuration.java
@@ -11,20 +11,16 @@
 import org.elasticsearch.xpack.sql.proto.Mode;
 
 import java.time.ZoneId;
-import java.time.ZonedDateTime;
 
 // Typed object holding properties for a given query
-public class Configuration {
-    private final ZoneId zoneId;
+public class Configuration extends org.elasticsearch.xpack.ql.session.Configuration {
+    
     private final int pageSize;
     private final TimeValue requestTimeout;
     private final TimeValue pageTimeout;
     private final Mode mode;
     private final String clientId;
-    private final String username;
-    private final String clusterName;
     private final boolean multiValueFieldLeniency;
-    private final ZonedDateTime now;
     private final boolean includeFrozenIndices;
 
     @Nullable
@@ -35,24 +31,19 @@ public Configuration(ZoneId zi, int pageSize, TimeValue requestTimeout, TimeValu
                          String username, String clusterName,
                          boolean multiValueFieldLeniency,
                          boolean includeFrozen) {
-        this.zoneId = zi.normalized();
+
+        super(zi, username, clusterName);
+
         this.pageSize = pageSize;
         this.requestTimeout = requestTimeout;
         this.pageTimeout = pageTimeout;
         this.filter = filter;
         this.mode = mode == null ? Mode.PLAIN : mode;
         this.clientId = clientId;
-        this.username = username;
-        this.clusterName = clusterName;
         this.multiValueFieldLeniency = multiValueFieldLeniency;
-        this.now = ZonedDateTime.now(zoneId);
         this.includeFrozenIndices = includeFrozen;
     }
 
-    public ZoneId zoneId() {
-        return zoneId;
-    }
-
     public int pageSize() {
         return pageSize;
     }
@@ -76,18 +67,6 @@ public String clientId() {
         return clientId;
     }
 
-    public String username() {
-        return username;
-    }
-
-    public String clusterName() {
-        return clusterName;
-    }
-
-    public ZonedDateTime now() {
-        return now;
-    }
-    
     public boolean multiValueFieldLeniency() {
         return multiValueFieldLeniency;
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Cursors.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Cursors.java
index 6f1ee47f4da34..fd7ab2990da16 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Cursors.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Cursors.java
@@ -9,18 +9,18 @@
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.xpack.ql.expression.literal.Literals;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamOutput;
 import org.elasticsearch.xpack.sql.execution.search.CompositeAggCursor;
 import org.elasticsearch.xpack.sql.execution.search.PivotCursor;
 import org.elasticsearch.xpack.sql.execution.search.ScrollCursor;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractors;
-import org.elasticsearch.xpack.sql.execution.search.extractor.HitExtractors;
+import org.elasticsearch.xpack.sql.execution.search.extractor.SqlBucketExtractors;
+import org.elasticsearch.xpack.sql.execution.search.extractor.SqlHitExtractors;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.literal.Literals;
 import org.elasticsearch.xpack.sql.plugin.TextFormatterCursor;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.io.IOException;
 import java.time.ZoneId;
@@ -53,8 +53,8 @@ public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
 
         // plus all their dependencies
         entries.addAll(Processors.getNamedWriteables());
-        entries.addAll(HitExtractors.getNamedWriteables());
-        entries.addAll(BucketExtractors.getNamedWriteables());
+        entries.addAll(SqlHitExtractors.getNamedWriteables());
+        entries.addAll(SqlBucketExtractors.getNamedWriteables());
 
         // and custom types
         entries.addAll(Literals.getNamedWriteables());
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/EmptyExecutable.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/EmptyExecutable.java
index 93a7e51c39b74..b8da81fc8d873 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/EmptyExecutable.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/EmptyExecutable.java
@@ -6,13 +6,13 @@
 package org.elasticsearch.xpack.sql.session;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 
 import java.util.List;
 import java.util.Objects;
 
-public class EmptyExecutable implements Executable {
+public class EmptyExecutable implements SqlExecutable {
 
     private final List<Attribute> output;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/EmptyRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/EmptyRowSet.java
index 9b6fa2aa3a06a..2ef8e25660b9e 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/EmptyRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/EmptyRowSet.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.session;
 
-import org.elasticsearch.xpack.sql.type.Schema;
+import org.elasticsearch.xpack.ql.type.Schema;
 
 class EmptyRowSet extends AbstractRowSet implements SchemaRowSet {
     private final Schema schema;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Executable.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Executable.java
index d1d78194ebe62..2654d06750415 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Executable.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Executable.java
@@ -3,10 +3,11 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
+
 package org.elasticsearch.xpack.sql.session;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 
 import java.util.List;
@@ -15,5 +16,5 @@ public interface Executable {
 
     List<Attribute> output();
 
-    void execute(SqlSession session, ActionListener<Page> listener);
+    void execute(Session session, ActionListener<Page> listener);
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/ListCursor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/ListCursor.java
index a07b7adfe37d5..927eeff8fa1d3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/ListCursor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/ListCursor.java
@@ -11,7 +11,7 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.xpack.sql.type.Schema;
+import org.elasticsearch.xpack.ql.type.Schema;
 
 import java.io.IOException;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/ListRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/ListRowSet.java
index 6bbbbaa462d05..520e9b23423f3 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/ListRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/ListRowSet.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.session;
 
-import org.elasticsearch.xpack.sql.type.Schema;
+import org.elasticsearch.xpack.ql.type.Schema;
 
 import java.util.List;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Rows.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Rows.java
index dac192318a209..19f56ba4a35d0 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Rows.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Rows.java
@@ -5,9 +5,9 @@
  */
 package org.elasticsearch.xpack.sql.session;
 
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.Schema;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.Schema;
 import org.elasticsearch.xpack.sql.util.Check;
 
 import java.util.ArrayList;
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SchemaRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SchemaRowSet.java
index fb12c6e6529b5..218e6d406997f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SchemaRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SchemaRowSet.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.session;
 
-import org.elasticsearch.xpack.sql.type.Schema;
+import org.elasticsearch.xpack.ql.type.Schema;
 
 /**
  * A {@linkplain RowSet} with the {@link Schema} for the results
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Session.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Session.java
new file mode 100644
index 0000000000000..2e80a20ea0047
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Session.java
@@ -0,0 +1,11 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.sql.session;
+
+public interface Session {
+
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SingletonExecutable.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SingletonExecutable.java
index d86ac5fe00814..0f7531983f93b 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SingletonExecutable.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SingletonExecutable.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.sql.session;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.xpack.sql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 import org.elasticsearch.xpack.sql.util.Check;
 
@@ -35,7 +35,7 @@ public List<Attribute> output() {
     }
 
     @Override
-    public void execute(SqlSession session, ActionListener<Page> listener) {
+    public void execute(Session session, ActionListener<Page> listener) {
         listener.onResponse(Page.last(Rows.singleton(output, values)));
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SingletonRowSet.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SingletonRowSet.java
index 649caafc9be2b..ebc5986feb737 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SingletonRowSet.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SingletonRowSet.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.sql.session;
 
-import org.elasticsearch.xpack.sql.type.Schema;
+import org.elasticsearch.xpack.ql.type.Schema;
 
 //TODO is it worth keeping this when we have ListRowSet?
 class SingletonRowSet extends AbstractRowSet implements SchemaRowSet {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SqlExecutable.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SqlExecutable.java
new file mode 100644
index 0000000000000..f815580dc6bd7
--- /dev/null
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SqlExecutable.java
@@ -0,0 +1,19 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.sql.session;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.xpack.sql.session.Cursor.Page;
+
+public interface SqlExecutable extends Executable {
+
+    void execute(SqlSession session, ActionListener<Page> listener);
+
+    @Override
+    default void execute(Session session, ActionListener<Page> listener) {
+        execute((SqlSession) session, listener);
+    }
+}
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SqlSession.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SqlSession.java
index 023b443850c16..4d6a772615686 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SqlSession.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/SqlSession.java
@@ -8,24 +8,24 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.index.IndexResolver;
+import org.elasticsearch.xpack.ql.index.MappingException;
+import org.elasticsearch.xpack.ql.plan.TableIdentifier;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.rule.RuleExecutor;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.PreAnalyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.PreAnalyzer.PreAnalysis;
 import org.elasticsearch.xpack.sql.analysis.analyzer.TableInfo;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver;
-import org.elasticsearch.xpack.sql.analysis.index.MappingException;
 import org.elasticsearch.xpack.sql.execution.PlanExecutor;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.TableIdentifier;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.sql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.sql.planner.Planner;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
-import org.elasticsearch.xpack.sql.rule.RuleExecutor;
 import org.elasticsearch.xpack.sql.session.Cursor.Page;
 
 import java.util.List;
@@ -33,7 +33,7 @@
 
 import static org.elasticsearch.action.ActionListener.wrap;
 
-public class SqlSession {
+public class SqlSession implements Session {
 
     private final Client client;
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/stats/QueryMetric.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/stats/QueryMetric.java
index c461254558425..26cd1bdb4ee14 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/stats/QueryMetric.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/stats/QueryMetric.java
@@ -10,6 +10,7 @@
 import org.elasticsearch.xpack.sql.proto.RequestInfo;
 
 import java.util.Locale;
+
 import static org.elasticsearch.xpack.sql.proto.RequestInfo.ODBC_CLIENT_IDS;
 
 public enum QueryMetric {
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/DateUtils.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/DateUtils.java
index 0f8afdd155215..9485c854d8671 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/DateUtils.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/util/DateUtils.java
@@ -8,8 +8,8 @@
 
 import org.elasticsearch.common.time.DateFormatter;
 import org.elasticsearch.common.time.DateFormatters;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Foldables;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Foldables;
 import org.elasticsearch.xpack.sql.parser.ParsingException;
 import org.elasticsearch.xpack.sql.proto.StringUtils;
 
@@ -28,7 +28,6 @@
 public final class DateUtils {
 
     public static final ZoneId UTC = ZoneId.of("Z");
-    public static final String DATE_PARSE_FORMAT = "epoch_millis";
     // In Java 8 LocalDate.EPOCH is not available, introduced with later Java versions
     public static final LocalDate EPOCH = LocalDate.of(1970, 1, 1);
     public static final long DAY_IN_MILLIS = 60 * 60 * 24 * 1000L;
diff --git a/x-pack/plugin/sql/src/main/resources/org/elasticsearch/xpack/sql/plugin/sql_whitelist.txt b/x-pack/plugin/sql/src/main/resources/org/elasticsearch/xpack/sql/plugin/sql_whitelist.txt
index ae3472133aa1b..771b5aa9046e1 100644
--- a/x-pack/plugin/sql/src/main/resources/org/elasticsearch/xpack/sql/plugin/sql_whitelist.txt
+++ b/x-pack/plugin/sql/src/main/resources/org/elasticsearch/xpack/sql/plugin/sql_whitelist.txt
@@ -8,20 +8,21 @@
 
 #### Classes
 
-class org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape {
-
+class org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape {
 }
 
-
-class org.elasticsearch.xpack.sql.expression.literal.IntervalDayTime {
+class org.elasticsearch.xpack.ql.expression.literal.IntervalDayTime {
 }
 
-class org.elasticsearch.xpack.sql.expression.literal.IntervalYearMonth {
+class org.elasticsearch.xpack.ql.expression.literal.IntervalYearMonth {
 }
 
 class java.time.OffsetTime {
 }
 
+class org.elasticsearch.xpack.ql.expression.function.scalar.whitelist.InternalQlScriptUtils {
+}
+
 class org.elasticsearch.xpack.sql.expression.function.scalar.whitelist.InternalSqlScriptUtils {
 
 #
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/FieldAttributeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/FieldAttributeTests.java
index b36111ffac3bb..1d60cae0e6740 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/FieldAttributeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/FieldAttributeTests.java
@@ -6,28 +6,29 @@
 package org.elasticsearch.xpack.sql.analysis.analyzer;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.util.List;
 import java.util.Map;
 
-import static org.elasticsearch.xpack.sql.type.DataType.BOOLEAN;
-import static org.elasticsearch.xpack.sql.type.DataType.KEYWORD;
+import static org.elasticsearch.xpack.ql.type.DataType.BOOLEAN;
+import static org.elasticsearch.xpack.ql.type.DataType.KEYWORD;
 import static org.hamcrest.CoreMatchers.instanceOf;
 import static org.hamcrest.Matchers.hasItem;
 import static org.hamcrest.Matchers.hasItems;
@@ -45,7 +46,7 @@ public class FieldAttributeTests extends ESTestCase {
 
     public FieldAttributeTests() {
         parser = new SqlParser();
-        functionRegistry = new FunctionRegistry();
+        functionRegistry = new SqlFunctionRegistry();
         verifier = new Verifier(new Metrics());
 
         Map<String, EsField> mapping = TypesTests.loadMapping("mapping-multi-field-variation.json");
@@ -128,7 +129,7 @@ public void testAmbiguousExactKeyword() {
         assertFalse(attr.getExactInfo().hasExact());
         assertThat(attr.getExactInfo().errorMsg(),
             is("Multiple exact keyword candidates available for [ambiguous]; specify which one to use"));
-        SqlIllegalArgumentException e = expectThrows(SqlIllegalArgumentException.class, () -> attr.exactAttribute());
+        QlIllegalArgumentException e = expectThrows(QlIllegalArgumentException.class, () -> attr.exactAttribute());
         assertThat(e.getMessage(),
                 is("Multiple exact keyword candidates available for [ambiguous]; specify which one to use"));
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/PreAnalyzerTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/PreAnalyzerTests.java
index ca3b2f14ebc80..6ffdd600ab7c6 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/PreAnalyzerTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/PreAnalyzerTests.java
@@ -6,9 +6,9 @@
 package org.elasticsearch.xpack.sql.analysis.analyzer;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.sql.analysis.analyzer.PreAnalyzer.PreAnalysis;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
 
 import static org.hamcrest.CoreMatchers.nullValue;
 import static org.hamcrest.Matchers.hasSize;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
index 08c2548a41ba3..b6bedfe02b86e 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
@@ -6,26 +6,26 @@
 package org.elasticsearch.xpack.sql.analysis.analyzer;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Coalesce;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Greatest;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfNull;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Least;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.NullIf;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
 import org.elasticsearch.xpack.sql.analysis.index.IndexResolverTests;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.Round;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.Truncate;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.Char;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.Space;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Coalesce;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Greatest;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfNull;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Least;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.NullIf;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.util.Arrays;
 import java.util.LinkedHashMap;
@@ -46,7 +46,7 @@ private String error(String sql) {
     }
 
     private String error(IndexResolution getIndexResult, String sql) {
-        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new FunctionRegistry(), getIndexResult, new Verifier(new Metrics()));
+        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new SqlFunctionRegistry(), getIndexResult, new Verifier(new Metrics()));
         VerificationException e = expectThrows(VerificationException.class, () -> analyzer.analyze(parser.createStatement(sql), true));
         assertTrue(e.getMessage().startsWith("Found "));
         String header = "Found 1 problem(s)\nline ";
@@ -64,7 +64,7 @@ private EsIndex getTestEsIndex() {
     }
 
     private LogicalPlan accept(IndexResolution resolution, String sql) {
-        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new FunctionRegistry(), resolution, new Verifier(new Metrics()));
+        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new SqlFunctionRegistry(), resolution, new Verifier(new Metrics()));
         return analyzer.analyze(parser.createStatement(sql), true);
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
index 045f2b8928f33..f58925c16d828 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
@@ -7,11 +7,14 @@
 
 import org.elasticsearch.action.fieldcaps.FieldCapabilities;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.InvalidMappedField;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.index.IndexResolver;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.InvalidMappedField;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 
 import java.util.ArrayList;
 import java.util.Collections;
@@ -248,7 +251,7 @@ public static Map<String, Map<String, FieldCapabilities>> fromMappings(EsIndex..
             if (entry.getValue().size() > 1) {
                 for (EsIndex index : indices) {
                     EsField field = index.mapping().get(fieldName);
-                    UpdateableFieldCapabilities fieldCaps = (UpdateableFieldCapabilities) caps.get(field.getDataType().typeName);
+                    UpdateableFieldCapabilities fieldCaps = (UpdateableFieldCapabilities) caps.get(field.getDataType().typeName());
                     fieldCaps.indices.add(index.name());
                 }
                 //TODO: what about nonAgg/SearchIndices?
@@ -265,7 +268,7 @@ private static void addFieldCaps(String parent, EsField field, String indexName,
             map = new HashMap<>();
             merged.put(fieldName, map);
         }
-        FieldCapabilities caps = map.computeIfAbsent(field.getDataType().typeName,
+        FieldCapabilities caps = map.computeIfAbsent(field.getDataType().typeName(),
                 esType -> new UpdateableFieldCapabilities(fieldName, esType,
                         isSearchable(field.getDataType()),
                         isAggregatable(field.getDataType())));
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggregationCursorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggregationCursorTests.java
index 195d11be434d7..ae17b00f3400f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggregationCursorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggregationCursorTests.java
@@ -6,10 +6,10 @@
 package org.elasticsearch.xpack.sql.execution.search;
 
 import org.elasticsearch.common.io.stream.Writeable.Reader;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.ConstantExtractorTests;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.execution.search.extractor.BucketExtractor;
 import org.elasticsearch.xpack.sql.execution.search.extractor.CompositeKeyExtractorTests;
-import org.elasticsearch.xpack.sql.execution.search.extractor.ConstantExtractorTests;
 import org.elasticsearch.xpack.sql.execution.search.extractor.MetricAggExtractorTests;
 
 import java.io.IOException;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursorTests.java
index ca135d5170fd4..e45e030054dc8 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursorTests.java
@@ -8,10 +8,10 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
+import org.elasticsearch.xpack.ql.execution.search.extractor.ConstantExtractorTests;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractor;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
 import org.elasticsearch.xpack.sql.execution.search.extractor.ComputingExtractorTests;
-import org.elasticsearch.xpack.sql.execution.search.extractor.ConstantExtractorTests;
-import org.elasticsearch.xpack.sql.execution.search.extractor.HitExtractor;
 import org.elasticsearch.xpack.sql.session.Cursors;
 
 import java.io.IOException;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SourceGeneratorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SourceGeneratorTests.java
index 7efbea74241e0..3fc5d96765ad9 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SourceGeneratorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SourceGeneratorTests.java
@@ -14,11 +14,13 @@
 import org.elasticsearch.search.sort.FieldSortBuilder;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeMap;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.ReferenceAttribute;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.KeywordEsField;
 import org.elasticsearch.xpack.sql.expression.function.Score;
 import org.elasticsearch.xpack.sql.querydsl.agg.AvgAgg;
 import org.elasticsearch.xpack.sql.querydsl.agg.GroupByValue;
@@ -28,8 +30,6 @@
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Direction;
 import org.elasticsearch.xpack.sql.querydsl.container.Sort.Missing;
 import org.elasticsearch.xpack.sql.querydsl.query.MatchQuery;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.KeywordEsField;
 
 import java.util.LinkedHashMap;
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SqlSourceBuilderTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SqlSourceBuilderTests.java
index 6ee843c2c6371..5851178b1d445 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SqlSourceBuilderTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/SqlSourceBuilderTests.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.execution.search.QlSourceBuilder;
 
 import java.util.Arrays;
 import java.util.Map;
@@ -19,7 +20,7 @@
 
 public class SqlSourceBuilderTests extends ESTestCase {
     public void testSqlSourceBuilder() {
-        final SqlSourceBuilder ssb = new SqlSourceBuilder();
+        final QlSourceBuilder ssb = new QlSourceBuilder();
         final SearchSourceBuilder source = new SearchSourceBuilder();
         ssb.trackScores();
         ssb.addSourceField("foo");
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/CompositeKeyExtractorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/CompositeKeyExtractorTests.java
index 0edf46c934553..bd8b427339b3e 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/CompositeKeyExtractorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/CompositeKeyExtractorTests.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.search.aggregations.Aggregations;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.querydsl.container.GroupByRef.Property;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/ComputingExtractorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/ComputingExtractorTests.java
index 909fdf831e13f..832bda0570e86 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/ComputingExtractorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/ComputingExtractorTests.java
@@ -9,6 +9,13 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.search.SearchHit;
+import org.elasticsearch.xpack.ql.execution.search.extractor.ComputingExtractor;
+import org.elasticsearch.xpack.ql.execution.search.extractor.HitExtractors;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ChainingProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ChainingProcessorTests;
+import org.elasticsearch.xpack.ql.expression.gen.processor.HitExtractorProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
 import org.elasticsearch.xpack.sql.expression.function.scalar.CastProcessorTests;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
@@ -16,11 +23,6 @@
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathFunctionProcessorTests;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ChainingProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ChainingProcessorTests;
-import org.elasticsearch.xpack.sql.expression.gen.processor.HitExtractorProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -29,7 +31,7 @@
 
 import static java.util.Collections.singletonList;
 import static java.util.Collections.singletonMap;
-import static org.elasticsearch.xpack.sql.util.CollectionUtils.combine;
+import static org.elasticsearch.xpack.ql.util.CollectionUtils.combine;
 import static org.elasticsearch.xpack.sql.util.DateUtils.UTC;
 
 public class ComputingExtractorTests extends AbstractSqlWireSerializingTestCase<ComputingExtractor> {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/FieldHitExtractorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/FieldHitExtractorTests.java
index 2544a02926089..47242a2249233 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/FieldHitExtractorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/FieldHitExtractorTests.java
@@ -12,10 +12,10 @@
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.SqlException;
-import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoShape;
-import org.elasticsearch.xpack.sql.type.DataType;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.io.IOException;
@@ -194,7 +194,7 @@ public void testGetSource() throws IOException {
 
     public void testToString() {
         assertEquals("hit.field@hit@Europe/Berlin",
-            new FieldHitExtractor("hit.field", null, null, ZoneId.of("Europe/Berlin"), true, "hit", false).toString());
+                new FieldHitExtractor("hit.field", null, null, ZoneId.of("Europe/Berlin"), true, "hit", false).toString());
     }
 
     public void testMultiValuedDocValue() {
@@ -203,7 +203,7 @@ public void testMultiValuedDocValue() {
         SearchHit hit = new SearchHit(1);
         DocumentField field = new DocumentField(fieldName, asList("a", "b"));
         hit.fields(singletonMap(fieldName, field));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extract(hit));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extract(hit));
         assertThat(ex.getMessage(), is("Arrays (returned by [" + fieldName + "]) are not supported"));
     }
 
@@ -218,7 +218,7 @@ public void testMultiValuedSourceValue() throws IOException {
         source.endObject();
         BytesReference sourceRef = BytesReference.bytes(source);
         hit.sourceRef(sourceRef);
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extract(hit));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extract(hit));
         assertThat(ex.getMessage(), is("Arrays (returned by [" + fieldName + "]) are not supported"));
     }
 
@@ -248,7 +248,7 @@ public void testExtractSourceIncorrectPath() {
         FieldHitExtractor fe = getFieldHitExtractor("a.b.c.d", false);
         Object value = randomNonNullValue();
         Map<String, Object> map = singletonMap("a", singletonMap("b", singletonMap("c", value)));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extractFromSource(map));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extractFromSource(map));
         assertThat(ex.getMessage(), is("Cannot extract value [a.b.c.d] from source"));
     }
 
@@ -256,7 +256,7 @@ public void testMultiValuedSource() {
         FieldHitExtractor fe = getFieldHitExtractor("a", false);
         Object value = randomValue();
         Map<String, Object> map = singletonMap("a", asList(value, value));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extractFromSource(map));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extractFromSource(map));
         assertThat(ex.getMessage(), is("Arrays (returned by [a]) are not supported"));
     }
 
@@ -352,7 +352,7 @@ public void testNestedFieldsWithDotsAndRandomHierarchy() {
         } else {
             // if we have an array with more than one value in it, check that we throw the correct exception and exception message
             final Map<String, Object> map2 = Collections.unmodifiableMap(map);
-            SqlException ex = expectThrows(SqlException.class, () -> fe.extractFromSource(map2));
+            QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extractFromSource(map2));
             assertThat(ex.getMessage(), is("Arrays (returned by [" + expected + "]) are not supported"));
         }
     }
@@ -361,7 +361,7 @@ public void testExtractSourceIncorrectPathWithFieldWithDots() {
         FieldHitExtractor fe = getFieldHitExtractor("a.b.c.d.e", false);
         Object value = randomNonNullValue();
         Map<String, Object> map = singletonMap("a", singletonMap("b.c", singletonMap("d", value)));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extractFromSource(map));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extractFromSource(map));
         assertThat(ex.getMessage(), is("Cannot extract value [a.b.c.d.e] from source"));
     }
 
@@ -393,7 +393,7 @@ public void testFieldWithDotsAndSamePathButDifferentHierarchy() {
         Map<String, Object> map = new HashMap<>();
         map.put("a.b", singletonMap("c", singletonMap("d.e", singletonMap("f.g", value))));
         map.put("a", singletonMap("b.c", singletonMap("d.e", singletonMap("f", singletonMap("g", value)))));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extractFromSource(map));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extractFromSource(map));
         assertThat(ex.getMessage(), is("Multiple values (returned by [a.b.c.d.e.f.g]) are not supported"));
     }
 
@@ -411,7 +411,7 @@ public void testFieldsWithMultiValueArrayAsSubfield() {
         Map<String, Object> map = new HashMap<>();
         // "a" : [{"b" : "value1"}, {"b" : "value2"}]
         map.put("a", asList(singletonMap("b", randomNonNullValue()), singletonMap("b", randomNonNullValue())));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extractFromSource(map));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extractFromSource(map));
         assertThat(ex.getMessage(), is("Arrays (returned by [a.b]) are not supported"));
     }
 
@@ -429,7 +429,7 @@ public void testFieldsWithMultiValueArrayAsSubfield_ThreeNestedLists() {
         Map<String, Object> map = new HashMap<>();
         // "a" : [{"b" : [{"c" : ["value1", "value2"]}]}]
         map.put("a", singletonList(singletonMap("b", singletonList(singletonMap("c", asList("value1", "value2"))))));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extractFromSource(map));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extractFromSource(map));
         assertThat(ex.getMessage(), is("Arrays (returned by [a.b.c]) are not supported"));
     }
 
@@ -456,7 +456,7 @@ public void testObjectsForSourceValue() throws IOException {
         source.endObject();
         BytesReference sourceRef = BytesReference.bytes(source);
         hit.sourceRef(sourceRef);
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extract(hit));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extract(hit));
         assertThat(ex.getMessage(), is("Objects (returned by [" + fieldName + "]) are not supported"));
     }
 
@@ -484,7 +484,7 @@ public void testMultipleGeoShapeExtraction() {
 
         Map<String, Object> map2 = new HashMap<>();
         map2.put(fieldName, Arrays.asList("POINT (1 2)", "POINT (3 4)"));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extractFromSource(map2));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extractFromSource(map2));
         assertThat(ex.getMessage(), is("Arrays (returned by [" + fieldName + "]) are not supported"));
 
         FieldHitExtractor lenientFe = new FieldHitExtractor(fieldName,
@@ -549,7 +549,7 @@ public void testMultipleGeoPointExtractionFromSource() throws IOException {
         hit.sourceRef(sourceRef);
 
         FieldHitExtractor fe = new FieldHitExtractor(fieldName, DataType.GEO_POINT, UTC, false);
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extract(hit));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extract(hit));
         assertThat(ex.getMessage(), is("Arrays (returned by [" + fieldName + "]) are not supported"));
 
         FieldHitExtractor lenientFe = new FieldHitExtractor(fieldName, DataType.GEO_POINT, UTC, false, true);
@@ -573,7 +573,7 @@ public void testGeoPointExtractionFromMultipleDocValues() {
         FieldHitExtractor fe = new FieldHitExtractor(fieldName, DataType.GEO_POINT, UTC, true);
 
         hit.fields(singletonMap(fieldName, new DocumentField(fieldName, Arrays.asList("2,1", "3,4"))));
-        SqlException ex = expectThrows(SqlException.class, () -> fe.extract(hit));
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> fe.extract(hit));
         assertThat(ex.getMessage(), is("Arrays (returned by [" + fieldName + "]) are not supported"));
 
         FieldHitExtractor lenientFe = new FieldHitExtractor(fieldName, DataType.GEO_POINT, UTC, true, true);
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractorTests.java
index 53e9fdc53664c..9a058ef30830a 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/MetricAggExtractorTests.java
@@ -10,8 +10,9 @@
 import org.elasticsearch.search.aggregations.Aggregations;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.execution.search.extractor.BucketExtractor;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.SqlException;
+import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.io.IOException;
@@ -61,7 +62,7 @@ protected MetricAggExtractor mutateInstance(MetricAggExtractor instance) throws
     public void testNoAggs() {
         Bucket bucket = new TestBucket(emptyMap(), 0, new Aggregations(emptyList()));
         MetricAggExtractor extractor = randomMetricAggExtractor();
-        SqlException exception = expectThrows(SqlException.class, () -> extractor.extract(bucket));
+        SqlIllegalArgumentException exception = expectThrows(SqlIllegalArgumentException.class, () -> extractor.extract(bucket));
         assertEquals("Cannot find an aggregation named " + extractor.name(), exception.getMessage());
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TopHitsAggExtractorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TopHitsAggExtractorTests.java
index 0dacdb665e77e..5f770f1027307 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TopHitsAggExtractorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/execution/search/extractor/TopHitsAggExtractorTests.java
@@ -15,9 +15,9 @@
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
 import org.elasticsearch.search.aggregations.metrics.InternalTopHits;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.SqlException;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.time.ZoneId;
@@ -60,7 +60,7 @@ protected TopHitsAggExtractor mutateInstance(TopHitsAggExtractor instance) {
     public void testNoAggs() {
         Bucket bucket = new TestBucket(emptyMap(), 0, new Aggregations(emptyList()));
         TopHitsAggExtractor extractor = randomTopHitsAggExtractor();
-        SqlException exception = expectThrows(SqlException.class, () -> extractor.extract(bucket));
+        SqlIllegalArgumentException exception = expectThrows(SqlIllegalArgumentException.class, () -> extractor.extract(bucket));
         assertEquals("Cannot find an aggregation named " + extractor.name(), exception.getMessage());
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ProcessorTests.java
index a01178fbc5b79..c46be2d9a8448 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ProcessorTests.java
@@ -6,28 +6,30 @@
 
 package org.elasticsearch.xpack.sql.expression;
 
+import org.apache.lucene.util.LuceneTestCase.AwaitsFix;
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
-import org.elasticsearch.xpack.sql.tree.NodeSubclassTests;
+import org.elasticsearch.xpack.sql.tree.SqlNodeSubclassTests;
 import org.junit.BeforeClass;
 
 import java.lang.reflect.Field;
 import java.util.ArrayList;
 import java.util.LinkedHashSet;
 import java.util.List;
+import java.util.Set;
 
 import static java.util.stream.Collectors.toCollection;
 
-
+@AwaitsFix(bugUrl = "classpath inside tests is different")
 public class ProcessorTests extends ESTestCase {
 
     private static List<Class<? extends Processor>> processors;
 
     @BeforeClass
     public static void init() throws Exception {
-        processors = NodeSubclassTests.subclassesOf(Processor.class);
+        processors = SqlNodeSubclassTests.subclassesOf(Processor.class);
     }
 
     public void testProcessorRegistration() throws Exception {
@@ -39,6 +41,7 @@ public void testProcessorRegistration() throws Exception {
         int missing = processors.size() - registered.size();
 
         List<String> notRegistered = new ArrayList<>();
+        Set<String> processorNames = new LinkedHashSet<>();
         for (Class<? extends Processor> proc : processors) {
             String procName = proc.getName();
             assertTrue(procName + " does NOT implement NamedWriteable", NamedWriteable.class.isAssignableFrom(proc));
@@ -54,6 +57,7 @@ public void testProcessorRegistration() throws Exception {
             } catch (Exception ex) {
                 fail(procName + " does NOT provide a static NAME field\n" + ex);
             }
+            processorNames.add(value);
             if (!registered.contains(value)) {
                 notRegistered.add(procName);
             }
@@ -61,10 +65,16 @@ public void testProcessorRegistration() throws Exception {
             assertEquals("Processor: " + proc + " doesn't override getWriteableName", proc, declaringClass);
         }
 
-        if (missing > 0) {
+        if (notRegistered.isEmpty() == false) {
             fail(missing + " processor(s) not registered : " + notRegistered);
         } else {
-            assertEquals("Detection failed: discovered more registered processors than classes", 0, missing);
+            // FIXME: the project split causes different behaviour between Gradle vs IDEs
+            // Eclipse considers classes from both projects, Gradle does not
+            // hence why this is disabled for now
+            registered.removeAll(processorNames);
+            if (registered.isEmpty() == false) {
+                fail("Detection failed: discovered more registered processors than actual classes; extra " + registered);
+            }
         }
     }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/CastProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/CastProcessorTests.java
index 7e9cb64b01950..5061d42e7947e 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/CastProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/CastProcessorTests.java
@@ -8,8 +8,8 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.type.DataTypeConversion.Conversion;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion.Conversion;
 
 import java.io.IOException;
 
@@ -38,7 +38,7 @@ public void testApply() {
             CastProcessor proc = new CastProcessor(Conversion.STRING_TO_INT);
             assertEquals(null, proc.process(null));
             assertEquals(1, proc.process("1"));
-            Exception e = expectThrows(SqlIllegalArgumentException.class, () -> proc.process("1.2"));
+            Exception e = expectThrows(QlIllegalArgumentException.class, () -> proc.process("1.2"));
             assertEquals("cannot cast [1.2] to [integer]", e.getMessage());
         }
         {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/DatabaseFunctionTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/DatabaseFunctionTests.java
index 8ad04d83c4c45..ab0b5dd06718c 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/DatabaseFunctionTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/DatabaseFunctionTests.java
@@ -7,20 +7,20 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.proto.Mode;
 import org.elasticsearch.xpack.sql.proto.Protocol;
 import org.elasticsearch.xpack.sql.session.Configuration;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 public class DatabaseFunctionTests extends ESTestCase {
@@ -34,7 +34,7 @@ public void testDatabaseFunctionOutput() {
                                   Protocol.PAGE_TIMEOUT, null,
                                   randomFrom(Mode.values()), randomAlphaOfLength(10),
                                   null, clusterName, randomBoolean(), randomBoolean()),
-                new FunctionRegistry(),
+                new SqlFunctionRegistry(),
                 IndexResolution.valid(test),
                 new Verifier(new Metrics())
         );
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/UserFunctionTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/UserFunctionTests.java
index a6e8d83a336f7..657d4d9e33ed1 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/UserFunctionTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/UserFunctionTests.java
@@ -7,20 +7,20 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.proto.Mode;
 import org.elasticsearch.xpack.sql.proto.Protocol;
 import org.elasticsearch.xpack.sql.session.Configuration;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 public class UserFunctionTests extends ESTestCase {
@@ -34,7 +34,7 @@ public void testNoUsernameFunctionOutput() {
                                   randomFrom(Mode.values()), randomAlphaOfLength(10),
                                   null, randomAlphaOfLengthBetween(1, 15),
                                   randomBoolean(), randomBoolean()),
-                new FunctionRegistry(),
+                new SqlFunctionRegistry(),
                 IndexResolution.valid(test),
                 new Verifier(new Metrics())
         );
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTests.java
index ff65414bf58ca..1c6dcc19eb791 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTests.java
@@ -6,10 +6,10 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.TestUtils;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTimeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTimeTests.java
index 166490699bb97..8b2894c172c89 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTimeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentDateTimeTests.java
@@ -7,27 +7,27 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.ParsingException;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.session.Configuration;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
 import java.time.temporal.ChronoField;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class CurrentDateTimeTests extends AbstractNodeTestCase<CurrentDateTime, Expression> {
 
@@ -91,7 +91,7 @@ public void testInvalidPrecision() {
         IndexResolution indexResolution = IndexResolution.valid(new EsIndex("test",
             TypesTests.loadMapping("mapping-multi-field-with-nested.json")));
 
-        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new FunctionRegistry(), indexResolution, new Verifier(new Metrics()));
+        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new SqlFunctionRegistry(), indexResolution, new Verifier(new Metrics()));
         ParsingException e = expectThrows(ParsingException.class, () ->
             analyzer.analyze(parser.createStatement("SELECT CURRENT_TIMESTAMP(100000000000000)"), true));
         assertEquals("line 1:27: invalid precision; [100000000000000] out of [integer] range", e.getMessage());
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentTimeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentTimeTests.java
index 8603a3c6dd9c1..3c71b495ce0ec 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentTimeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/CurrentTimeTests.java
@@ -7,20 +7,20 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.session.Configuration;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.ParsingException;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.session.Configuration;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.time.OffsetTime;
 import java.time.ZoneId;
@@ -28,7 +28,7 @@
 import java.time.temporal.ChronoField;
 import java.util.Objects;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class CurrentTimeTests extends AbstractNodeTestCase<CurrentTime, Expression> {
 
@@ -92,7 +92,7 @@ public void testInvalidPrecision() {
         IndexResolution indexResolution = IndexResolution.valid(new EsIndex("test",
             TypesTests.loadMapping("mapping-multi-field-with-nested.json")));
 
-        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new FunctionRegistry(), indexResolution, new Verifier(new Metrics()));
+        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new SqlFunctionRegistry(), indexResolution, new Verifier(new Metrics()));
         ParsingException e = expectThrows(ParsingException.class, () ->
             analyzer.analyze(parser.createStatement("SELECT CURRENT_TIME(100000000000000)"), true));
         assertEquals("line 1:22: invalid precision; [100000000000000] out of [integer] range", e.getMessage());
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddPipeTests.java
index 6e2d2ca62dbf5..ed49dca2f884d 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddPipeTests.java
@@ -7,12 +7,12 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
 
 import java.time.ZoneId;
 import java.util.ArrayList;
@@ -20,11 +20,11 @@
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class DateAddPipeTests extends AbstractNodeTestCase<DateAddPipe, Pipe> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddProcessorTests.java
index 1902c7f5953c5..81cce0585fe3f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateAddProcessorTests.java
@@ -8,19 +8,19 @@
 
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
 
-import static org.elasticsearch.xpack.sql.expression.Literal.NULL;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
+import static org.elasticsearch.xpack.ql.expression.Literal.NULL;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeTestUtils.dateTime;
 import static org.elasticsearch.xpack.sql.proto.StringUtils.ISO_DATE_WITH_NANOS;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffPipeTests.java
index a80eb47b21db0..d95da899726b6 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffPipeTests.java
@@ -7,12 +7,12 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
 
 import java.time.ZoneId;
 import java.util.ArrayList;
@@ -20,10 +20,10 @@
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class DateDiffPipeTests extends AbstractNodeTestCase<DateDiffPipe, Pipe> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessorTests.java
index 19d329cc42415..a2d3ab658154a 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateDiffProcessorTests.java
@@ -8,17 +8,17 @@
 
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 
-import static org.elasticsearch.xpack.sql.expression.Literal.NULL;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
+import static org.elasticsearch.xpack.ql.expression.Literal.NULL;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeTestUtils.dateTime;
 import static org.elasticsearch.xpack.sql.util.DateUtils.UTC;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartPipeTests.java
index e6a5b3c9d142b..16c5d259d0743 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartPipeTests.java
@@ -7,13 +7,13 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
 
 import java.time.ZoneId;
 import java.util.ArrayList;
@@ -21,10 +21,10 @@
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class DatePartPipeTests extends AbstractNodeTestCase<DatePartPipe, Pipe> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartProcessorTests.java
index fca8c27cc8751..48dd62c034b13 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DatePartProcessorTests.java
@@ -8,17 +8,17 @@
 
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.time.ZoneId;
 
-import static org.elasticsearch.xpack.sql.expression.Literal.NULL;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
+import static org.elasticsearch.xpack.ql.expression.Literal.NULL;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeTestUtils.dateTime;
 
 public class DatePartProcessorTests extends AbstractSqlWireSerializingTestCase<DatePartProcessor> {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeTestUtils.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeTestUtils.java
index 6570e108666f4..515ac3ac826d5 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeTestUtils.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTimeTestUtils.java
@@ -36,10 +36,6 @@ public static ZonedDateTime dateTime(long millisSinceEpoch) {
         return DateUtils.asDateTime(millisSinceEpoch);
     }
 
-    public static ZonedDateTime date(long millisSinceEpoch) {
-        return DateUtils.asDateOnly(millisSinceEpoch);
-    }
-
     public static OffsetTime time(long millisSinceEpoch) {
         return DateUtils.asTimeOnly(millisSinceEpoch);
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncPipeTests.java
index 08836f98afc76..8b250c86d0ac5 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncPipeTests.java
@@ -7,13 +7,13 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
 
 import java.time.ZoneId;
 import java.util.ArrayList;
@@ -21,10 +21,10 @@
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class DateTruncPipeTests extends AbstractNodeTestCase<DateTruncPipe, Pipe> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncProcessorTests.java
index cbc76419c58c6..9c7f11499a9dd 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DateTruncProcessorTests.java
@@ -8,19 +8,19 @@
 
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.AbstractSqlWireSerializingTestCase;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.tree.Source;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
 
-import static org.elasticsearch.xpack.sql.expression.Literal.NULL;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
+import static org.elasticsearch.xpack.ql.expression.Literal.NULL;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomDatetimeLiteral;
 import static org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeTestUtils.dateTime;
 import static org.elasticsearch.xpack.sql.proto.StringUtils.ISO_DATE_WITH_NANOS;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfYearTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfYearTests.java
index 7168716b529ea..44a7ca59e09a1 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfYearTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/datetime/DayOfYearTests.java
@@ -6,9 +6,9 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.datetime;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
 
 import java.time.ZoneId;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessorTests.java
index b14a61945cf41..8382e2648af38 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/GeoProcessorTests.java
@@ -7,6 +7,7 @@
 
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.geo.GeoProcessor.GeoOperation;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceProcessorTests.java
index 9f78f8b3df43b..0016c67d99c5e 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StDistanceProcessorTests.java
@@ -9,18 +9,21 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ChainingProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.type.DataTypes;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ChainingProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 import static org.hamcrest.Matchers.instanceOf;
 
 public class StDistanceProcessorTests extends AbstractWireSerializingTestCase<StDistanceProcessor> {
 
+    @Override
     public StDistanceProcessor createTestInstance() {
         return new StDistanceProcessor(
             constantPoint(randomDoubleBetween(-180, 180, true), randomDoubleBetween(-90, 90, true)),
@@ -44,6 +47,10 @@ public void testApply() {
         assertEquals(GeoUtils.arcDistance(20, 10, 40, 30), (double) result, 0.000001);
     }
 
+    public static Literal l(Object value) {
+        return new Literal(EMPTY, value, DataTypes.fromJava(value));
+    }
+
     public void testNullHandling() {
         assertNull(new StDistance(EMPTY, l(new GeoShape(1, 2)), l(null)).makePipe().asProcessor().process(null));
         assertNull(new StDistance(EMPTY, l(null), l(new GeoShape(1, 2))).makePipe().asProcessor().process(null));
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessorTests.java
index 8c2d61ed80094..86a8b75131796 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/geo/StWkttosqlProcessorTests.java
@@ -6,7 +6,8 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar.geo;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.function.scalar.geo.GeoShape;
 
 import static org.hamcrest.Matchers.instanceOf;
 
@@ -26,17 +27,17 @@ public void testApply() {
 
     public void testTypeCheck() {
         StWkttosqlProcessor procPoint = new StWkttosqlProcessor();
-        SqlIllegalArgumentException siae = expectThrows(SqlIllegalArgumentException.class, () -> procPoint.process(42));
+        QlIllegalArgumentException siae = expectThrows(QlIllegalArgumentException.class, () -> procPoint.process(42));
         assertEquals("A string is required; received [42]", siae.getMessage());
 
-        siae = expectThrows(SqlIllegalArgumentException.class, () -> procPoint.process("some random string"));
+        siae = expectThrows(QlIllegalArgumentException.class, () -> procPoint.process("some random string"));
         assertEquals("Cannot parse [some random string] as a geo_shape value", siae.getMessage());
 
-        siae = expectThrows(SqlIllegalArgumentException.class, () -> procPoint.process("point (foo bar)"));
+        siae = expectThrows(QlIllegalArgumentException.class, () -> procPoint.process("point (foo bar)"));
         assertEquals("Cannot parse [point (foo bar)] as a geo_shape or shape value", siae.getMessage());
 
 
-        siae = expectThrows(SqlIllegalArgumentException.class, () -> procPoint.process("point (10 10"));
+        siae = expectThrows(QlIllegalArgumentException.class, () -> procPoint.process("point (10 10"));
         assertEquals("Cannot parse [point (10 10] as a geo_shape or shape value", siae.getMessage());
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathProcessorTests.java
index ab1a9bf1f5cea..45704b2c07573 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/BinaryMathProcessorTests.java
@@ -8,13 +8,13 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
+import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
-import org.elasticsearch.xpack.sql.expression.Literal;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
-import org.elasticsearch.xpack.sql.expression.gen.processor.Processor;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class BinaryMathProcessorTests extends AbstractWireSerializingTestCase<BinaryMathProcessor> {
     public static BinaryMathProcessor randomProcessor() {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericPipeTests.java
index e35403eabbafe..e9e92126e9081 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericPipeTests.java
@@ -6,22 +6,22 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringNumericProcessor.BinaryStringNumericOperation;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class BinaryStringNumericPipeTests
         extends AbstractNodeTestCase<BinaryStringNumericPipe, Pipe> {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericProcessorTests.java
index 42e6c4694255f..4b9f89016625f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringNumericProcessorTests.java
@@ -9,13 +9,13 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringNumericProcessor.BinaryStringNumericOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class BinaryStringNumericProcessorTests extends AbstractWireSerializingTestCase<BinaryStringNumericProcessor> {
     
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringPipeTests.java
index ef878fce39550..a12f909754631 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringPipeTests.java
@@ -6,20 +6,20 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class BinaryStringStringPipeTests
         extends AbstractNodeTestCase<BinaryStringStringPipe, Pipe> {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringProcessorTests.java
index 3422d5bddefc6..63778e3cf016f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/BinaryStringStringProcessorTests.java
@@ -9,13 +9,13 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.BinaryStringStringProcessor.BinaryStringStringOperation;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class BinaryStringStringProcessorTests extends AbstractWireSerializingTestCase<BinaryStringStringProcessor> {
     
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionPipeTests.java
index 931fd11b0340b..54e0c262cdbf9 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatFunctionPipeTests.java
@@ -6,20 +6,20 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.BinaryPipe;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.BinaryPipe;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class ConcatFunctionPipeTests extends AbstractNodeTestCase<ConcatFunctionPipe, Pipe> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatProcessorTests.java
index 891428587d19c..a0fb5607c9f50 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ConcatProcessorTests.java
@@ -9,12 +9,12 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
 
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class ConcatProcessorTests extends AbstractWireSerializingTestCase<ConcatFunctionProcessor> {
     
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionPipeTests.java
index fbb8c33061d93..cef922936796a 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertFunctionPipeTests.java
@@ -6,11 +6,11 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.Combinations;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.Combinations;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.BitSet;
@@ -18,10 +18,10 @@
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class InsertFunctionPipeTests extends AbstractNodeTestCase<InsertFunctionPipe, Pipe> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertProcessorTests.java
index b9ffdf59e82fd..c617e5b435b01 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/InsertProcessorTests.java
@@ -9,12 +9,12 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class InsertProcessorTests extends AbstractWireSerializingTestCase<InsertFunctionProcessor> {
     
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipeTests.java
index 3795aab2cd18f..8ee073a291205 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateFunctionPipeTests.java
@@ -6,11 +6,11 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.Combinations;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.Combinations;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.BitSet;
@@ -18,10 +18,10 @@
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class LocateFunctionPipeTests extends AbstractNodeTestCase<LocateFunctionPipe, Pipe> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateProcessorTests.java
index 7a43dd8bf3824..ba7787b4727e9 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/LocateProcessorTests.java
@@ -9,12 +9,12 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class LocateProcessorTests extends AbstractWireSerializingTestCase<LocateFunctionProcessor> {
     
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionPipeTests.java
index 3c352669a0637..b06f65ad3895f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceFunctionPipeTests.java
@@ -6,11 +6,11 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.Combinations;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.Combinations;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.BitSet;
@@ -18,9 +18,9 @@
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class ReplaceFunctionPipeTests extends AbstractNodeTestCase<ReplaceFunctionPipe, Pipe> {
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceProcessorTests.java
index 66b6af11d1f91..aae6f38ee925f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/ReplaceProcessorTests.java
@@ -9,12 +9,12 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class ReplaceProcessorTests extends AbstractWireSerializingTestCase<ReplaceFunctionProcessor> {
     
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionPipeTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionPipeTests.java
index 22199fab0b4d8..2bc69b33f1d82 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionPipeTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringFunctionPipeTests.java
@@ -6,11 +6,11 @@
 
 package org.elasticsearch.xpack.sql.expression.function.scalar.string;
 
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.Combinations;
-import org.elasticsearch.xpack.sql.expression.gen.pipeline.Pipe;
-import org.elasticsearch.xpack.sql.tree.AbstractNodeTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.Combinations;
+import org.elasticsearch.xpack.ql.expression.gen.pipeline.Pipe;
+import org.elasticsearch.xpack.ql.tree.AbstractNodeTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.BitSet;
@@ -18,10 +18,10 @@
 import java.util.Objects;
 import java.util.function.Function;
 
-import static org.elasticsearch.xpack.sql.expression.Expressions.pipe;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
-import static org.elasticsearch.xpack.sql.tree.SourceTests.randomSource;
+import static org.elasticsearch.xpack.ql.expression.Expressions.pipe;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomIntLiteral;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.randomStringLiteral;
+import static org.elasticsearch.xpack.ql.tree.SourceTests.randomSource;
 
 public class SubstringFunctionPipeTests
     extends AbstractNodeTestCase<SubstringFunctionPipe, Pipe> {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringProcessorTests.java
index 839817fb2103b..17a4a6e9261da 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/string/SubstringProcessorTests.java
@@ -9,12 +9,12 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.ql.expression.gen.processor.ConstantProcessor;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
-import org.elasticsearch.xpack.sql.expression.gen.processor.ConstantProcessor;
 
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
-import static org.elasticsearch.xpack.sql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.expression.function.scalar.FunctionTestUtils.l;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 
 public class SubstringProcessorTests extends AbstractWireSerializingTestCase<SubstringFunctionProcessor> {
     
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ParameterTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/parser/ParameterTests.java
similarity index 74%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ParameterTests.java
rename to x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/parser/ParameterTests.java
index 97b7415786341..195bf35ada227 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ParameterTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/parser/ParameterTests.java
@@ -3,17 +3,19 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.sql.expression.parser;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Add;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mul;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Sub;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Add;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mul;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Sub;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.parser.ParsingException;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.util.Arrays;
 import java.util.Collections;
@@ -28,7 +30,7 @@ public class ParameterTests extends ESTestCase {
     public void testSingleParameter() {
         Expression expression = new SqlParser().createExpression("a = \n?",
                 Collections.singletonList(
-                        new SqlTypedParamValue(DataType.KEYWORD.typeName, "foo")
+                        new SqlTypedParamValue(DataType.KEYWORD.typeName(), "foo")
                 ));
         logger.info(expression);
         assertThat(expression, instanceOf(Equals.class));
@@ -42,10 +44,10 @@ public void testSingleParameter() {
 
     public void testMultipleParameters() {
         Expression expression = new SqlParser().createExpression("(? + ? * ?) - ?", Arrays.asList(
-                new SqlTypedParamValue(DataType.LONG.typeName, 1L),
-                new SqlTypedParamValue(DataType.LONG.typeName, 2L),
-                new SqlTypedParamValue(DataType.LONG.typeName, 3L),
-                new SqlTypedParamValue(DataType.LONG.typeName, 4L)
+                new SqlTypedParamValue(DataType.LONG.typeName(), 1L),
+                new SqlTypedParamValue(DataType.LONG.typeName(), 2L),
+                new SqlTypedParamValue(DataType.LONG.typeName(), 3L),
+                new SqlTypedParamValue(DataType.LONG.typeName(), 4L)
                 ));
         assertThat(expression, instanceOf(Sub.class));
         Sub sub = (Sub) expression;
@@ -62,9 +64,9 @@ public void testMultipleParameters() {
     public void testNotEnoughParameters() {
         ParsingException ex = expectThrows(ParsingException.class,
                 () -> new SqlParser().createExpression("(? + ? * ?) - ?", Arrays.asList(
-                        new SqlTypedParamValue(DataType.LONG.typeName, 1L),
-                        new SqlTypedParamValue(DataType.LONG.typeName, 2L),
-                        new SqlTypedParamValue(DataType.LONG.typeName, 3L)
+                        new SqlTypedParamValue(DataType.LONG.typeName(), 1L),
+                        new SqlTypedParamValue(DataType.LONG.typeName(), 2L),
+                        new SqlTypedParamValue(DataType.LONG.typeName(), 3L)
                 )));
         assertThat(ex.getMessage(), containsString("Not enough actual parameters"));
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/QuotingTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/parser/QuotingTests.java
similarity index 91%
rename from x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/QuotingTests.java
rename to x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/parser/QuotingTests.java
index a7cae7df4312b..aef9525058b3a 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/QuotingTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/parser/QuotingTests.java
@@ -3,26 +3,28 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.sql.expression;
+package org.elasticsearch.xpack.sql.expression.parser;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.OrderBy;
+import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.sql.parser.ParsingException;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
-import org.elasticsearch.xpack.sql.tree.Source;
 
 import java.util.ArrayList;
 import java.util.List;
 
+import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.nullValue;
 
-import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-
 public class QuotingTests extends ESTestCase {
 
     private static UnresolvedAttribute from(String s) {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerRunTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerRunTests.java
index bec0ddc9caff8..91737e05f5784 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerRunTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerRunTests.java
@@ -6,17 +6,17 @@
 package org.elasticsearch.xpack.sql.optimizer;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.util.Map;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
index 2b6378e2ee13c..349c644fb43f7 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
@@ -6,26 +6,76 @@
 package org.elasticsearch.xpack.sql.optimizer;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expression.TypeResolution;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Foldables;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.Nullability;
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.expression.Order.OrderDirection;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
+import org.elasticsearch.xpack.ql.expression.function.aggregate.InnerAggregate;
+import org.elasticsearch.xpack.ql.expression.predicate.BinaryOperator;
+import org.elasticsearch.xpack.ql.expression.predicate.Range;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.ArbitraryConditionalFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Case;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Coalesce;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.ConditionalFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Greatest;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfConditional;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfNull;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Iif;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Least;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.NullIf;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.FullTextPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MatchQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MultiMatchQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.StringQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.And;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.BinaryLogic;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Not;
+import org.elasticsearch.xpack.ql.expression.predicate.logical.Or;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.IsNotNull;
+import org.elasticsearch.xpack.ql.expression.predicate.nulls.IsNull;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Add;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Div;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mod;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mul;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Sub;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.GreaterThan;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.GreaterThanOrEqual;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.In;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.LessThan;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.LessThanOrEqual;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NotEquals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NullEquals;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.Like;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.RLike;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.plan.logical.Aggregate;
+import org.elasticsearch.xpack.ql.plan.logical.EsRelation;
+import org.elasticsearch.xpack.ql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.OrderBy;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.tree.NodeInfo;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer.PruneSubqueryAliases;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Expression.TypeResolution;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Foldables;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.Nullability;
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.expression.Order.OrderDirection;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Avg;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.ExtendedStats;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.First;
-import org.elasticsearch.xpack.sql.expression.function.aggregate.InnerAggregate;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Last;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Max;
 import org.elasticsearch.xpack.sql.expression.function.aggregate.Min;
@@ -55,44 +105,6 @@
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.Ascii;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.Concat;
 import org.elasticsearch.xpack.sql.expression.function.scalar.string.Repeat;
-import org.elasticsearch.xpack.sql.expression.predicate.BinaryOperator;
-import org.elasticsearch.xpack.sql.expression.predicate.Range;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.ArbitraryConditionalFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Case;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Coalesce;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.ConditionalFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Greatest;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfConditional;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfNull;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Iif;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Least;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.NullIf;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.FullTextPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MatchQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MultiMatchQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.StringQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.And;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.BinaryLogic;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Not;
-import org.elasticsearch.xpack.sql.expression.predicate.logical.Or;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.IsNotNull;
-import org.elasticsearch.xpack.sql.expression.predicate.nulls.IsNull;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Add;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Div;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mod;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mul;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Sub;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.GreaterThan;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.GreaterThanOrEqual;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.In;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.LessThan;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.LessThanOrEqual;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NotEquals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NullEquals;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.Like;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.RLike;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.BinaryComparisonSimplification;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.BooleanLiteralsOnTheRight;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.BooleanSimplification;
@@ -110,23 +122,11 @@
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.SimplifyCase;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.SimplifyConditional;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer.SortAggregateOnOrderBy;
-import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
-import org.elasticsearch.xpack.sql.plan.logical.EsRelation;
-import org.elasticsearch.xpack.sql.plan.logical.Filter;
 import org.elasticsearch.xpack.sql.plan.logical.LocalRelation;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
 import org.elasticsearch.xpack.sql.plan.logical.Pivot;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.plan.logical.SubQueryAlias;
 import org.elasticsearch.xpack.sql.plan.logical.command.ShowTables;
 import org.elasticsearch.xpack.sql.session.EmptyExecutable;
-import org.elasticsearch.xpack.sql.tree.NodeInfo;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.util.CollectionUtils;
-import org.elasticsearch.xpack.sql.util.StringUtils;
 
 import java.lang.reflect.Constructor;
 import java.util.Arrays;
@@ -137,11 +137,11 @@
 import static java.util.Collections.emptyList;
 import static java.util.Collections.emptyMap;
 import static java.util.Collections.singletonList;
-import static org.elasticsearch.xpack.sql.expression.Literal.FALSE;
-import static org.elasticsearch.xpack.sql.expression.Literal.NULL;
-import static org.elasticsearch.xpack.sql.expression.Literal.TRUE;
-import static org.elasticsearch.xpack.sql.expression.Literal.of;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.expression.Literal.FALSE;
+import static org.elasticsearch.xpack.ql.expression.Literal.NULL;
+import static org.elasticsearch.xpack.ql.expression.Literal.TRUE;
+import static org.elasticsearch.xpack.ql.expression.Literal.of;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 import static org.elasticsearch.xpack.sql.util.DateUtils.UTC;
 import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.is;
@@ -447,8 +447,8 @@ public void testNullFoldingIsNullWithCast() {
         final IsNull isNullOpt = (IsNull) foldNull.rule(isNull);
         assertEquals(isNull, isNullOpt);
 
-        SqlIllegalArgumentException sqlIAE =
-                expectThrows(SqlIllegalArgumentException.class, () -> isNullOpt.asPipe().asProcessor().process(null));
+        QlIllegalArgumentException sqlIAE = expectThrows(QlIllegalArgumentException.class,
+                () -> isNullOpt.asPipe().asProcessor().process(null));
         assertEquals("cannot cast [foo] to [date]: Text 'foo' could not be parsed at index 0", sqlIAE.getMessage());
 
         isNull = new IsNull(EMPTY, new Cast(EMPTY, NULL, randomFrom(DataType.values())));
@@ -473,8 +473,8 @@ public void testNullFoldingIsNotNullWithCast() {
         final IsNotNull isNotNullOpt = (IsNotNull) foldNull.rule(isNotNull);
         assertEquals(isNotNull, isNotNullOpt);
 
-        SqlIllegalArgumentException sqlIAE =
-                expectThrows(SqlIllegalArgumentException.class, () -> isNotNullOpt.asPipe().asProcessor().process(null));
+        QlIllegalArgumentException sqlIAE = expectThrows(QlIllegalArgumentException.class,
+                () -> isNotNullOpt.asPipe().asProcessor().process(null));
         assertEquals("cannot cast [foo] to [date]: Text 'foo' could not be parsed at index 0", sqlIAE.getMessage());
 
         isNotNull = new IsNotNull(EMPTY, new Cast(EMPTY, NULL, randomFrom(DataType.values())));
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/EscapedFunctionsTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/EscapedFunctionsTests.java
index baf4de8641af0..e5fdeaa6be705 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/EscapedFunctionsTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/EscapedFunctionsTests.java
@@ -6,18 +6,18 @@
 package org.elasticsearch.xpack.sql.parser;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
-import org.elasticsearch.xpack.sql.expression.function.Function;
-import org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.Like;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
-import org.elasticsearch.xpack.sql.plan.logical.Limit;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.expression.function.Function;
+import org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.Like;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.plan.logical.Limit;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.plan.logical.With;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
-import org.elasticsearch.xpack.sql.type.DataType;
 import org.junit.Assert;
 
 import java.util.List;
@@ -157,9 +157,9 @@ public void testFunctionWithFunctionWithArg() {
     public void testFunctionWithFunctionWithArgAndParams() {
         String e = "POWER(?, {fn POWER({fn ABS(?)}, {fN ABS(?)})})";
         Function f = (Function) parser.createExpression(e,
-                asList(new SqlTypedParamValue(DataType.LONG.typeName, 1),
-                       new SqlTypedParamValue(DataType.LONG.typeName, 1),
-                       new SqlTypedParamValue(DataType.LONG.typeName, 1)));
+                asList(new SqlTypedParamValue(DataType.LONG.typeName(), 1),
+                       new SqlTypedParamValue(DataType.LONG.typeName(), 1),
+                       new SqlTypedParamValue(DataType.LONG.typeName(), 1)));
 
         assertEquals(e, f.sourceText());
         assertEquals(2, f.arguments().size());
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/ExpressionTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/ExpressionTests.java
index 8d25901650b65..220d770717ac7 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/ExpressionTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/ExpressionTests.java
@@ -6,22 +6,22 @@
 package org.elasticsearch.xpack.sql.parser;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction;
+import org.elasticsearch.xpack.ql.expression.literal.Interval;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.Case;
+import org.elasticsearch.xpack.ql.expression.predicate.conditional.IfConditional;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Add;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Mul;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Neg;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.arithmetic.Sub;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NotEquals;
+import org.elasticsearch.xpack.ql.expression.predicate.operator.comparison.NullEquals;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.TestUtils;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
-import org.elasticsearch.xpack.sql.expression.literal.Interval;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.Case;
-import org.elasticsearch.xpack.sql.expression.predicate.conditional.IfConditional;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Add;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Mul;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Neg;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.arithmetic.Sub;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.Equals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NotEquals;
-import org.elasticsearch.xpack.sql.expression.predicate.operator.comparison.NullEquals;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import java.time.Duration;
 import java.time.Period;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/LikeEscapingParsingTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/LikeEscapingParsingTests.java
index a9b9723c8cc1f..1bdd8d897ae93 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/LikeEscapingParsingTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/LikeEscapingParsingTests.java
@@ -6,11 +6,11 @@
 package org.elasticsearch.xpack.sql.parser;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.Like;
-import org.elasticsearch.xpack.sql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.Like;
+import org.elasticsearch.xpack.ql.expression.predicate.regex.LikePattern;
+import org.elasticsearch.xpack.ql.type.DataType;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
-import org.elasticsearch.xpack.sql.type.DataType;
 
 import static java.util.Collections.singletonList;
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
@@ -32,7 +32,7 @@ private LikePattern like(String pattern) {
         Expression exp = null;
         boolean parameterized = randomBoolean();
         if (parameterized) {
-            exp = parser.createExpression("exp LIKE ?", singletonList(new SqlTypedParamValue(DataType.KEYWORD.typeName, pattern)));
+            exp = parser.createExpression("exp LIKE ?", singletonList(new SqlTypedParamValue(DataType.KEYWORD.typeName(), pattern)));
         } else {
             exp = parser.createExpression(format(null, "exp LIKE '{}'", pattern));
         }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/SqlParserTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/SqlParserTests.java
index 1dc9567016ec5..a82144840b83d 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/SqlParserTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/parser/SqlParserTests.java
@@ -8,21 +8,21 @@
 import com.google.common.base.Joiner;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.NamedExpression;
-import org.elasticsearch.xpack.sql.expression.Order;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAlias;
-import org.elasticsearch.xpack.sql.expression.UnresolvedAttribute;
-import org.elasticsearch.xpack.sql.expression.function.UnresolvedFunction;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MatchQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MultiMatchQueryPredicate;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.StringQueryPredicate;
-import org.elasticsearch.xpack.sql.plan.logical.Filter;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.OrderBy;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
-import org.elasticsearch.xpack.sql.plan.logical.UnresolvedRelation;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.NamedExpression;
+import org.elasticsearch.xpack.ql.expression.Order;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAlias;
+import org.elasticsearch.xpack.ql.expression.UnresolvedAttribute;
+import org.elasticsearch.xpack.ql.expression.function.UnresolvedFunction;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MatchQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MultiMatchQueryPredicate;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.StringQueryPredicate;
+import org.elasticsearch.xpack.ql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.OrderBy;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.plan.logical.UnresolvedRelation;
 
 import java.util.ArrayList;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/UnresolvedRelationTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/UnresolvedRelationTests.java
index 8dda75b889576..51ea33ed22a86 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/UnresolvedRelationTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/UnresolvedRelationTests.java
@@ -6,9 +6,10 @@
 package org.elasticsearch.xpack.sql.plan.logical;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.plan.TableIdentifier;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.plan.TableIdentifier;
+import org.elasticsearch.xpack.ql.plan.logical.UnresolvedRelation;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
 
 import java.util.ArrayList;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowFunctionsTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowFunctionsTests.java
new file mode 100644
index 0000000000000..fac4cfb9fd75d
--- /dev/null
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/ShowFunctionsTests.java
@@ -0,0 +1,32 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.sql.plan.logical.command;
+
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.sql.TestUtils;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
+import org.elasticsearch.xpack.sql.session.SchemaRowSet;
+import org.elasticsearch.xpack.sql.session.SqlSession;
+
+import static org.elasticsearch.action.ActionListener.wrap;
+
+public class ShowFunctionsTests extends ESTestCase {
+
+    public void testShowFunctions() throws Exception {
+        ShowFunctions showFunctions = new ShowFunctions(Source.EMPTY, null);
+        SqlSession session = new SqlSession(TestUtils.TEST_CFG, null, new SqlFunctionRegistry(), null, null, null, null, null, null);
+
+        showFunctions.execute(session, wrap(p -> {
+            SchemaRowSet r = (SchemaRowSet) p.rowSet();
+            assertTrue(150 <= r.size());
+            assertEquals(2, r.columnCount());
+            assertEquals("AVG", r.column(0));
+            assertEquals("AGGREGATE", r.column(1));
+        }, ex -> fail(ex.getMessage())));
+    }
+}
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumnsTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumnsTests.java
index 509e8e954f353..cfadd61828e23 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumnsTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumnsTests.java
@@ -8,15 +8,17 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.index.IndexResolver;
+import org.elasticsearch.xpack.ql.index.IndexResolver.IndexInfo;
+import org.elasticsearch.xpack.ql.index.IndexResolver.IndexType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver.IndexInfo;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver.IndexType;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.proto.Mode;
@@ -24,8 +26,6 @@
 import org.elasticsearch.xpack.sql.session.SchemaRowSet;
 import org.elasticsearch.xpack.sql.session.SqlSession;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.sql.Types;
 import java.util.ArrayList;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTablesTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTablesTests.java
index 834c5808b707f..73b4f349790d1 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTablesTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTablesTests.java
@@ -8,15 +8,18 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.index.IndexResolver;
+import org.elasticsearch.xpack.ql.index.IndexResolver.IndexInfo;
+import org.elasticsearch.xpack.ql.index.IndexResolver.IndexType;
+import org.elasticsearch.xpack.ql.type.DataTypes;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver.IndexInfo;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver.IndexType;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.proto.Mode;
@@ -26,9 +29,6 @@
 import org.elasticsearch.xpack.sql.session.SchemaRowSet;
 import org.elasticsearch.xpack.sql.session.SqlSession;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.DataTypes;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 
 import java.util.Comparator;
@@ -345,7 +345,7 @@ public void testSysTablesWithInvalidType() throws Exception {
 
 
     private SqlTypedParamValue param(Object value) {
-        return new SqlTypedParamValue(DataTypes.fromJava(value).typeName, value);
+        return new SqlTypedParamValue(DataTypes.fromJava(value).typeName(), value);
     }
 
     private Tuple<Command, SqlSession> sql(String sql, List<SqlTypedParamValue> params, Configuration cfg) {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTypesTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTypesTests.java
index adf1ad5b4d1e6..1f1fe89fde903 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTypesTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysTypesTests.java
@@ -7,18 +7,18 @@
 
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.index.IndexResolver;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolver;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.plan.logical.command.Command;
 import org.elasticsearch.xpack.sql.session.SchemaRowSet;
 import org.elasticsearch.xpack.sql.session.SqlSession;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.sql.JDBCType;
 import java.util.List;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/PostOptimizerVerifierTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/PostOptimizerVerifierTests.java
index 4e89fdb215445..d47fe7c4813d5 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/PostOptimizerVerifierTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/PostOptimizerVerifierTests.java
@@ -7,18 +7,18 @@
 package org.elasticsearch.xpack.sql.planner;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 import org.junit.After;
 import org.junit.Before;
 
@@ -39,7 +39,7 @@ public void init() {
         Map<String, EsField> mapping = TypesTests.loadMapping("mapping-multi-field-variation.json");
         EsIndex test = new EsIndex("test", mapping);
         indexResolution = IndexResolution.valid(test);
-        analyzer = new Analyzer(TestUtils.TEST_CFG, new FunctionRegistry(), indexResolution, new Verifier(new Metrics()));
+        analyzer = new Analyzer(TestUtils.TEST_CFG, new SqlFunctionRegistry(), indexResolution, new Verifier(new Metrics()));
         optimizer = new Optimizer();
         planner = new Planner();
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryFolderTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryFolderTests.java
index 18afb92b27361..101cdbc827fc8 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryFolderTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryFolderTests.java
@@ -6,14 +6,16 @@
 package org.elasticsearch.xpack.sql.planner;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Expressions;
+import org.elasticsearch.xpack.ql.expression.ReferenceAttribute;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.Expressions;
-import org.elasticsearch.xpack.sql.expression.ReferenceAttribute;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
 import org.elasticsearch.xpack.sql.plan.physical.EsQueryExec;
@@ -22,8 +24,6 @@
 import org.elasticsearch.xpack.sql.session.EmptyExecutable;
 import org.elasticsearch.xpack.sql.session.SingletonExecutable;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 import org.junit.AfterClass;
 import org.junit.BeforeClass;
 
@@ -48,7 +48,7 @@ public static void init() {
         Map<String, EsField> mapping = TypesTests.loadMapping("mapping-multi-field-variation.json");
         EsIndex test = new EsIndex("test", mapping);
         IndexResolution getIndexResult = IndexResolution.valid(test);
-        analyzer = new Analyzer(TestUtils.TEST_CFG, new FunctionRegistry(), getIndexResult, new Verifier(new Metrics()));
+        analyzer = new Analyzer(TestUtils.TEST_CFG, new SqlFunctionRegistry(), getIndexResult, new Verifier(new Metrics()));
         optimizer = new Optimizer();
         planner = new Planner();
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
index 0007398fbb83a..5037b74885d80 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
@@ -12,29 +12,32 @@
 import org.elasticsearch.search.aggregations.metrics.AvgAggregationBuilder;
 import org.elasticsearch.search.aggregations.metrics.CardinalityAggregationBuilder;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.gen.script.ScriptTemplate;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.plan.logical.Aggregate;
+import org.elasticsearch.xpack.ql.plan.logical.Filter;
+import org.elasticsearch.xpack.ql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.ql.plan.logical.Project;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.Literal;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.expression.function.grouping.Histogram;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Cast;
 import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.DateTimeProcessor.DateTimeExtractor;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
 import org.elasticsearch.xpack.sql.expression.function.scalar.math.Round;
-import org.elasticsearch.xpack.sql.expression.gen.script.ScriptTemplate;
 import org.elasticsearch.xpack.sql.optimizer.Optimizer;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.plan.logical.Aggregate;
-import org.elasticsearch.xpack.sql.plan.logical.Filter;
-import org.elasticsearch.xpack.sql.plan.logical.LogicalPlan;
-import org.elasticsearch.xpack.sql.plan.logical.Project;
 import org.elasticsearch.xpack.sql.plan.physical.EsQueryExec;
 import org.elasticsearch.xpack.sql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.sql.planner.QueryFolder.FoldAggregate.GroupingContext;
@@ -53,9 +56,6 @@
 import org.elasticsearch.xpack.sql.querydsl.query.TermsQuery;
 import org.elasticsearch.xpack.sql.querydsl.query.WildcardQuery;
 import org.elasticsearch.xpack.sql.stats.Metrics;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 import org.elasticsearch.xpack.sql.util.DateUtils;
 import org.junit.AfterClass;
 import org.junit.BeforeClass;
@@ -90,7 +90,7 @@ public static void init() {
         Map<String, EsField> mapping = TypesTests.loadMapping("mapping-multi-field-variation.json");
         EsIndex test = new EsIndex("test", mapping);
         IndexResolution getIndexResult = IndexResolution.valid(test);
-        analyzer = new Analyzer(TestUtils.TEST_CFG, new FunctionRegistry(), getIndexResult, new Verifier(new Metrics()));
+        analyzer = new Analyzer(TestUtils.TEST_CFG, new SqlFunctionRegistry(), getIndexResult, new Verifier(new Metrics()));
         optimizer = new Optimizer();
         planner = new Planner();
     }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plugin/CursorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plugin/CursorTests.java
index 28d9c278ed163..47d90fafc11a1 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plugin/CursorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plugin/CursorTests.java
@@ -12,7 +12,7 @@
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.logging.LoggerMessageFormat;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.SqlException;
+import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.action.BasicFormatter;
 import org.elasticsearch.xpack.sql.action.SqlQueryResponse;
@@ -109,7 +109,8 @@ public void testVersionHandling() {
         Version nextMinorVersion = Version.fromId(Version.CURRENT.id + 10000);
 
         String encodedWithWrongVersion = CursorsTestUtil.encodeToString(cursor, nextMinorVersion, randomZone());
-        SqlException exception = expectThrows(SqlException.class, () -> Cursors.decodeFromString(encodedWithWrongVersion));
+        SqlIllegalArgumentException exception = expectThrows(SqlIllegalArgumentException.class,
+                () -> Cursors.decodeFromString(encodedWithWrongVersion));
 
         assertEquals(LoggerMessageFormat.format("Unsupported cursor version [{}], expected [{}]", nextMinorVersion, Version.CURRENT),
                 exception.getMessage());
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainerTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainerTests.java
index 432be5fea4a8f..91abbe7935135 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainerTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/container/QueryContainerTests.java
@@ -6,20 +6,20 @@
 package org.elasticsearch.xpack.sql.querydsl.container;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.Alias;
-import org.elasticsearch.xpack.sql.expression.Attribute;
-import org.elasticsearch.xpack.sql.expression.AttributeMap;
-import org.elasticsearch.xpack.sql.expression.Expression;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.Alias;
+import org.elasticsearch.xpack.ql.expression.Attribute;
+import org.elasticsearch.xpack.ql.expression.AttributeMap;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
 import org.elasticsearch.xpack.sql.querydsl.query.BoolQuery;
 import org.elasticsearch.xpack.sql.querydsl.query.MatchAll;
 import org.elasticsearch.xpack.sql.querydsl.query.NestedQuery;
 import org.elasticsearch.xpack.sql.querydsl.query.Query;
 import org.elasticsearch.xpack.sql.querydsl.query.RangeQuery;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
 
 import java.util.AbstractMap.SimpleImmutableEntry;
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/BoolQueryTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/BoolQueryTests.java
index ac6b85538805c..43f49630e4b2a 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/BoolQueryTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/BoolQueryTests.java
@@ -7,9 +7,9 @@
 
 import org.elasticsearch.search.sort.NestedSortBuilder;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.AbstractMap.SimpleImmutableEntry;
 import java.util.Arrays;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/LeafQueryTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/LeafQueryTests.java
index 29ede49d98248..58bd29f8593fa 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/LeafQueryTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/LeafQueryTests.java
@@ -8,9 +8,9 @@
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.search.sort.NestedSortBuilder;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import static org.elasticsearch.test.EqualsHashCodeTestUtils.checkEqualsAndHashCode;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/MatchQueryTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/MatchQueryTests.java
index 1660ea3b8e8cb..6c36d46dc1a15 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/MatchQueryTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/MatchQueryTests.java
@@ -8,13 +8,13 @@
 import org.elasticsearch.index.query.MatchQueryBuilder;
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.FieldAttribute;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MatchQueryPredicate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.type.DataType;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.expression.FieldAttribute;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MatchQueryPredicate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.type.DataType;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.Arrays;
 import java.util.List;
@@ -22,7 +22,7 @@
 
 import static java.util.Collections.emptyMap;
 import static org.elasticsearch.test.EqualsHashCodeTestUtils.checkEqualsAndHashCode;
-import static org.elasticsearch.xpack.sql.tree.Source.EMPTY;
+import static org.elasticsearch.xpack.ql.tree.Source.EMPTY;
 import static org.hamcrest.Matchers.equalTo;
 
 public class MatchQueryTests extends ESTestCase {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/MultiMatchQueryTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/MultiMatchQueryTests.java
index fb9c8d805cd18..6fddc2eabc975 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/MultiMatchQueryTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/MultiMatchQueryTests.java
@@ -8,9 +8,9 @@
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.index.query.MultiMatchQueryBuilder;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.MultiMatchQueryPredicate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.MultiMatchQueryPredicate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.HashMap;
 import java.util.Map;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/NestedQueryTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/NestedQueryTests.java
index a1d1c7c93f561..4975ac6326ec0 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/NestedQueryTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/NestedQueryTests.java
@@ -7,9 +7,9 @@
 
 import org.elasticsearch.search.sort.NestedSortBuilder;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.tree.SourceTests;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.AbstractMap.SimpleImmutableEntry;
 import java.util.ArrayList;
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/QueryStringQueryTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/QueryStringQueryTests.java
index 89e88b3e9af1f..c97e6b678d353 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/QueryStringQueryTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/querydsl/query/QueryStringQueryTests.java
@@ -9,9 +9,9 @@
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.index.query.QueryStringQueryBuilder;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.sql.expression.predicate.fulltext.StringQueryPredicate;
-import org.elasticsearch.xpack.sql.tree.Source;
-import org.elasticsearch.xpack.sql.util.StringUtils;
+import org.elasticsearch.xpack.ql.expression.predicate.fulltext.StringQueryPredicate;
+import org.elasticsearch.xpack.ql.tree.Source;
+import org.elasticsearch.xpack.ql.util.StringUtils;
 
 import java.util.Collections;
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/stats/VerifierMetricsTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/stats/VerifierMetricsTests.java
index 5d263ec458523..ffb3e9ff04ade 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/stats/VerifierMetricsTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/stats/VerifierMetricsTests.java
@@ -8,15 +8,15 @@
 
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.core.watcher.common.stats.Counters;
+import org.elasticsearch.xpack.ql.index.EsIndex;
+import org.elasticsearch.xpack.ql.index.IndexResolution;
+import org.elasticsearch.xpack.ql.type.EsField;
+import org.elasticsearch.xpack.ql.type.TypesTests;
 import org.elasticsearch.xpack.sql.TestUtils;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Analyzer;
 import org.elasticsearch.xpack.sql.analysis.analyzer.Verifier;
-import org.elasticsearch.xpack.sql.analysis.index.EsIndex;
-import org.elasticsearch.xpack.sql.analysis.index.IndexResolution;
-import org.elasticsearch.xpack.sql.expression.function.FunctionRegistry;
+import org.elasticsearch.xpack.sql.expression.function.SqlFunctionRegistry;
 import org.elasticsearch.xpack.sql.parser.SqlParser;
-import org.elasticsearch.xpack.sql.type.EsField;
-import org.elasticsearch.xpack.sql.type.TypesTests;
 
 import java.util.Map;
 
@@ -239,7 +239,7 @@ private Counters sql(String sql, Verifier v) {
             verifier = new Verifier(metrics);
         }
 
-        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new FunctionRegistry(), IndexResolution.valid(test), verifier);
+        Analyzer analyzer = new Analyzer(TestUtils.TEST_CFG, new SqlFunctionRegistry(), IndexResolution.valid(test), verifier);
         analyzer.analyze(parser.createStatement(sql), true);
         
         return metrics == null ? null : metrics.stats();
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SqlNodeSubclassTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SqlNodeSubclassTests.java
new file mode 100644
index 0000000000000..56576198173a9
--- /dev/null
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SqlNodeSubclassTests.java
@@ -0,0 +1,91 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.sql.tree;
+
+import org.apache.lucene.util.LuceneTestCase.AwaitsFix;
+import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Literal;
+import org.elasticsearch.xpack.ql.expression.LiteralTests;
+import org.elasticsearch.xpack.ql.tree.Node;
+import org.elasticsearch.xpack.ql.tree.NodeSubclassTests;
+import org.elasticsearch.xpack.ql.tree.SourceTests;
+import org.elasticsearch.xpack.ql.util.CollectionUtils;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Avg;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.CompoundNumericAggregate;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Percentile;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.PercentileRanks;
+import org.elasticsearch.xpack.sql.expression.function.aggregate.Percentiles;
+import org.elasticsearch.xpack.sql.expression.function.grouping.Histogram;
+import org.elasticsearch.xpack.sql.expression.function.scalar.datetime.CurrentDateTime;
+
+import java.util.Arrays;
+import java.util.List;
+
+/**
+ * Looks for all subclasses of {@link Node} and verifies that they
+ * implement {@link Node#info()} and
+ * {@link Node#replaceChildren(List)} sanely. It'd be better if
+ * each subclass had its own test case that verified those methods
+ * and any other interesting things that that they do but we're a
+ * long way from that and this gets the job done for now.
+ * <p>
+ * This test attempts to use reflection to create believeable nodes
+ * and manipulate them in believeable ways with as little knowledge
+ * of the actual subclasses as possible. This is problematic because
+ * it is possible, for example, for nodes to stackoverflow because
+ * they <strong>can</strong> contain themselves. So this class
+ * <strong>does</strong> have some {@link Node}-subclass-specific
+ * knowledge. As little as I could get away with though.
+ * <p>
+ * When there are actual tests for a subclass of {@linkplain Node}
+ * then this class will do two things:
+ * <ul>
+ * <li>Skip running any tests for that subclass entirely.
+ * <li>Delegate to that test to build nodes of that type when a
+ * node of that type is called for.
+ * </ul>
+ */
+@AwaitsFix(bugUrl = "classpath inside tests is different")
+public class SqlNodeSubclassTests<T extends B, B extends Node<B>> extends NodeSubclassTests<T, B> {
+
+    private static final List<Class<?>> CLASSES_WITH_MIN_TWO_CHILDREN = CollectionUtils.combine(
+            NodeSubclassTests.CLASSES_WITH_MIN_TWO_CHILDREN, Arrays.asList(Percentile.class, Percentiles.class, PercentileRanks.class));
+
+
+    public SqlNodeSubclassTests(Class<T> subclass) {
+        super(subclass);
+    }
+
+    @Override
+    protected boolean hasAtLeastTwoChildren(Class<? extends Node<?>> toBuildClass) {
+        return CLASSES_WITH_MIN_TWO_CHILDREN.stream().anyMatch(toBuildClass::equals);
+    }
+
+    @Override
+    protected Object makeCompoundAgg() throws Exception {
+        return makeNode(CompoundNumericAggregate.class);
+    }
+
+    @Override
+    protected Object makeEnclosedAgg() {
+        return makeArg(Avg.class);
+    }
+
+    @Override
+    protected Object pluggableMakeArg(Class<? extends Node<?>> toBuildClass, Class<?> argClass) {
+        if (toBuildClass == Histogram.class) {
+            if (argClass == Expression.class) {
+                return LiteralTests.randomLiteral();
+            }
+        } else if (toBuildClass == CurrentDateTime.class) {
+            if (argClass == Expression.class) {
+                return Literal.of(SourceTests.randomSource(), randomInt(9));
+            }
+        }
+
+        return null;
+    }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/util/LikeConversionTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/util/LikeConversionTests.java
index 29cbb9b985ffd..860bc2d759d93 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/util/LikeConversionTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/util/LikeConversionTests.java
@@ -7,9 +7,9 @@
 
 import org.elasticsearch.test.ESTestCase;
 
-import static org.elasticsearch.xpack.sql.util.StringUtils.likeToJavaPattern;
-import static org.elasticsearch.xpack.sql.util.StringUtils.likeToLuceneWildcard;
-import static org.elasticsearch.xpack.sql.util.StringUtils.likeToUnescaped;
+import static org.elasticsearch.xpack.ql.util.StringUtils.likeToJavaPattern;
+import static org.elasticsearch.xpack.ql.util.StringUtils.likeToLuceneWildcard;
+import static org.elasticsearch.xpack.ql.util.StringUtils.likeToUnescaped;
 
 public class LikeConversionTests extends ESTestCase {
 

From c7f6de9656d33d8f00079fc07b845a739ce731ee Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 10 Jan 2020 13:01:28 +0100
Subject: [PATCH 498/686] Fix MultiVersionRepositoryAccessIT Tests (#50848)

We need the same fix we did in `7.x` (#50797) and only get snapshot status
for the current version or older. Otherwise these tests break for
e.g.`7.0.1` due to the same index metadata incompatibility.

Closes #50819
---
 .../MultiVersionRepositoryAccessIT.java       | 31 +++++++++++++++----
 1 file changed, 25 insertions(+), 6 deletions(-)

diff --git a/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java b/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
index f3effc8c01bec..ec2a70c6f84cd 100644
--- a/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
+++ b/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
@@ -129,7 +129,20 @@ public void testCreateAndRestoreSnapshot() throws IOException {
             deleteSnapshot(client, repoName, snapshotToDeleteName);
             final List<Map<String, Object>> snapshots = listSnapshots(repoName);
             assertThat(snapshots, hasSize(TEST_STEP.ordinal() + 1));
-            assertSnapshotStatusSuccessful(client, repoName, snapshots);
+            switch (TEST_STEP) {
+                case STEP2_NEW_CLUSTER:
+                case STEP4_NEW_CLUSTER:
+                    assertSnapshotStatusSuccessful(client, repoName,
+                        snapshots.stream().map(sn -> (String) sn.get("snapshot")).toArray(String[]::new));
+                    break;
+                case STEP1_OLD_CLUSTER:
+                    assertSnapshotStatusSuccessful(client, repoName, "snapshot-" + TEST_STEP);
+                    break;
+                case STEP3_OLD_CLUSTER:
+                    assertSnapshotStatusSuccessful(
+                        client, repoName, "snapshot-" + TEST_STEP, "snapshot-" + TestStep.STEP3_OLD_CLUSTER);
+                    break;
+            }
             if (TEST_STEP == TestStep.STEP3_OLD_CLUSTER) {
                 ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
             } else if (TEST_STEP == TestStep.STEP4_NEW_CLUSTER) {
@@ -163,7 +176,12 @@ public void testReadOnlyRepo() throws IOException {
                     assertThat(snapshots, hasSize(2));
                     break;
             }
-            assertSnapshotStatusSuccessful(client, repoName, snapshots);
+            if (TEST_STEP == TestStep.STEP1_OLD_CLUSTER || TEST_STEP == TestStep.STEP3_OLD_CLUSTER) {
+                assertSnapshotStatusSuccessful(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER);
+            } else {
+                assertSnapshotStatusSuccessful(client, repoName,
+                    "snapshot-" + TestStep.STEP1_OLD_CLUSTER, "snapshot-" + TestStep.STEP2_NEW_CLUSTER);
+            }
             if (TEST_STEP == TestStep.STEP3_OLD_CLUSTER) {
                 ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
             } else if (TEST_STEP == TestStep.STEP4_NEW_CLUSTER) {
@@ -187,7 +205,8 @@ public void testUpgradeMovesRepoToNewMetaVersion() throws IOException {
             final List<Map<String, Object>> snapshots = listSnapshots(repoName);
             // Every step creates one snapshot
             assertThat(snapshots, hasSize(TEST_STEP.ordinal() + 1));
-            assertSnapshotStatusSuccessful(client, repoName, snapshots);
+            assertSnapshotStatusSuccessful(client, repoName,
+                snapshots.stream().map(sn -> (String) sn.get("snapshot")).toArray(String[]::new));
             if (TEST_STEP == TestStep.STEP1_OLD_CLUSTER) {
                 ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
             } else {
@@ -205,9 +224,9 @@ public void testUpgradeMovesRepoToNewMetaVersion() throws IOException {
     }
 
     private static void assertSnapshotStatusSuccessful(RestHighLevelClient client, String repoName,
-                                                     List<Map<String, Object>> snapshots) throws IOException {
-        final SnapshotsStatusResponse statusResponse = client.snapshot().status(new SnapshotsStatusRequest(repoName,
-            snapshots.stream().map(sn -> (String) sn.get("snapshot")).toArray(String[]::new)), RequestOptions.DEFAULT);
+                                                       String... snapshots) throws IOException {
+        final SnapshotsStatusResponse statusResponse = client.snapshot()
+            .status(new SnapshotsStatusRequest(repoName, snapshots), RequestOptions.DEFAULT);
         for (SnapshotStatus status : statusResponse.getSnapshots()) {
             assertThat(status.getShardsStats().getFailedShards(), is(0));
         }

From f04f7aa129e998b790ee75d350790f7cc5b41905 Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Fri, 10 Jan 2020 13:54:32 +0100
Subject: [PATCH 499/686] GlobalBuildInfo support packed-refs with work-tree
 (#50791)

The packed-refs support was using the original .git path, changed to use
the real .git directory after reference from worktree has been followed.

Relates #47464
---
 .../org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java
index 746a06374ace0..7c3c4ab8e8083 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java
@@ -271,10 +271,10 @@ public static String gitRevision(File rootDir) {
                 Path refFile = gitDir.resolve(refName);
                 if (Files.exists(refFile)) {
                     revision = readFirstLine(refFile);
-                } else if (Files.exists(dotGit.resolve("packed-refs"))) {
+                } else if (Files.exists(gitDir.resolve("packed-refs"))) {
                     // Check packed references for commit ID
                     Pattern p = Pattern.compile("^([a-f0-9]{40}) " + refName + "$");
-                    try (Stream<String> lines = Files.lines(dotGit.resolve("packed-refs"))) {
+                    try (Stream<String> lines = Files.lines(gitDir.resolve("packed-refs"))) {
                         revision = lines.map(p::matcher)
                             .filter(Matcher::matches)
                             .map(m -> m.group(1))

From a68e8dabb61bc637cbdf99affb54dfefbc6434f6 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Fri, 10 Jan 2020 07:23:25 -0600
Subject: [PATCH 500/686] [DOCS] Fix time_zone example in range query docs
 (#50830)

One of the example snippets in the range query docs was missing a
required 'T' in the `date` format. This adds the required 'T'.
---
 docs/reference/query-dsl/range-query.asciidoc | 21 ++++++++++---------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/docs/reference/query-dsl/range-query.asciidoc b/docs/reference/query-dsl/range-query.asciidoc
index 52972fe4b3842..79da96110b1ac 100644
--- a/docs/reference/query-dsl/range-query.asciidoc
+++ b/docs/reference/query-dsl/range-query.asciidoc
@@ -214,19 +214,20 @@ UTC offset. For example:
 ----
 GET _search
 {
-    "query": {
-        "range" : {
-            "timestamp" : {
-                "time_zone": "+01:00", <1>
-                "gte": "2015-01-01 00:00:00", <2>
-                "lte": "now" <3>
-            }
-        }
+  "query": {
+    "range": {
+      "timestamp": {
+        "time_zone": "+01:00",        <1>
+        "gte": "2020-01-01T00:00:00", <2>
+        "lte": "now"                  <3>
+      }
     }
+  }
 }
 ----
+// TEST[continued]
 
 <1> Indicates that `date` values use a UTC offset of `+01:00`.
 <2> With a UTC offset of `+01:00`, {es} converts this date to
-`2014-12-31T23:00:00 UTC`.
-<3> The `time_zone` parameter does not affect the `now` value.
+`2019-12-31T23:00:00 UTC`.
+<3> The `time_zone` parameter does not affect the `now` value.
\ No newline at end of file

From a2e8f67a25d234f1d7022112b9c1dc3626dc5df7 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Fri, 10 Jan 2020 13:29:19 +0000
Subject: [PATCH 501/686] Remove type parameter from
 PutMappingRequest.buildFromSimplifiedDef() (#50844)

Mappings built by this method should all be wrapped with _doc, so there's no need
to pass the type any more. This also renames the method to simpleMapping, in line
with CreateIndexRequest, to help migration by causing compilation errors; and changes
the signature to take a String... rather than an Object....

Relates to #41059
---
 .../query/RankFeatureQueryBuilderTests.java   |  2 +-
 .../PercolateQueryBuilderTests.java           |  4 ++--
 .../PercolateWithNestedQueryBuilderTests.java |  4 ++--
 .../percolator/PercolatorQuerySearchIT.java   |  2 +-
 .../indices/create/CreateIndexRequest.java    |  4 ++--
 .../create/CreateIndexRequestBuilder.java     |  2 +-
 .../mapping/put/PutMappingRequest.java        | 22 ++++++-------------
 .../mapping/put/PutMappingRequestBuilder.java |  2 +-
 .../rollover/RolloverRequestBuilder.java      |  5 ++---
 .../template/put/PutIndexTemplateRequest.java |  5 +++--
 .../put/PutIndexTemplateRequestBuilder.java   |  4 ++--
 .../mapping/put/PutMappingRequestTests.java   |  4 ++--
 ...angeFieldQueryStringQueryBuilderTests.java |  2 +-
 .../index/query/MatchQueryBuilderTests.java   |  3 +--
 .../index/query/NestedQueryBuilderTests.java  |  2 +-
 .../query/TermsSetQueryBuilderTests.java      |  2 +-
 .../template/SimpleIndexTemplateIT.java       |  6 ++---
 .../search/searchafter/SearchAfterIT.java     |  2 +-
 .../test/AbstractBuilderTestCase.java         |  6 ++---
 .../test/ESSingleNodeTestCase.java            |  2 +-
 .../snapshots/SourceOnlySnapshotIT.java       |  4 ++--
 .../FieldLevelSecurityRandomTests.java        |  4 ++--
 .../index/query/ShapeQueryBuilderTests.java   |  2 +-
 23 files changed, 43 insertions(+), 52 deletions(-)

diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/query/RankFeatureQueryBuilderTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/query/RankFeatureQueryBuilderTests.java
index 0cd048184b968..78e130b0d00fe 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/query/RankFeatureQueryBuilderTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/query/RankFeatureQueryBuilderTests.java
@@ -44,7 +44,7 @@ public class RankFeatureQueryBuilderTests extends AbstractQueryTestCase<RankFeat
 
     @Override
     protected void initializeAdditionalMappings(MapperService mapperService) throws IOException {
-        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef("_doc",
+        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
             "my_feature_field", "type=rank_feature",
             "my_negative_feature_field", "type=rank_feature,positive_score_impact=false",
             "my_feature_vector_field", "type=rank_features"))), MapperService.MergeReason.MAPPING_UPDATE);
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolateQueryBuilderTests.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolateQueryBuilderTests.java
index f78aad3d3c38a..0c914295f9fc8 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolateQueryBuilderTests.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolateQueryBuilderTests.java
@@ -89,10 +89,10 @@ protected void initializeAdditionalMappings(MapperService mapperService) throws
         aliasField = randomAlphaOfLength(4);
 
         docType = "_doc";
-        mapperService.merge(docType, new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef(docType,
+        mapperService.merge(docType, new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
                 queryField, "type=percolator", aliasField, "type=alias,path=" + queryField
         ))), MapperService.MergeReason.MAPPING_UPDATE);
-        mapperService.merge(docType, new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef(docType,
+        mapperService.merge(docType, new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
                 STRING_FIELD_NAME, "type=text"
         ))), MapperService.MergeReason.MAPPING_UPDATE);
     }
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolateWithNestedQueryBuilderTests.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolateWithNestedQueryBuilderTests.java
index e58b6c6ad6a70..9e4d100830fb7 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolateWithNestedQueryBuilderTests.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolateWithNestedQueryBuilderTests.java
@@ -35,8 +35,8 @@ public class PercolateWithNestedQueryBuilderTests extends PercolateQueryBuilderT
     @Override
     protected void initializeAdditionalMappings(MapperService mapperService) throws IOException {
         super.initializeAdditionalMappings(mapperService);
-        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef(
-                "_doc", "some_nested_object", "type=nested"))), MapperService.MergeReason.MAPPING_UPDATE);
+        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
+                "some_nested_object", "type=nested"))), MapperService.MergeReason.MAPPING_UPDATE);
     }
 
     public void testDetectsNestedDocuments() throws IOException {
diff --git a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
index a56d74a397097..c726d203087ed 100644
--- a/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
+++ b/modules/percolator/src/test/java/org/elasticsearch/percolator/PercolatorQuerySearchIT.java
@@ -447,7 +447,7 @@ public void testPercolatorQueryWithHighlighting() throws Exception {
             fieldMapping.append(",index_options=offsets");
         }
         assertAcked(client().admin().indices().prepareCreate("test")
-                .setMapping("id", "type=keyword", "field1", fieldMapping, "query", "type=percolator")
+                .setMapping("id", "type=keyword", "field1", fieldMapping.toString(), "query", "type=percolator")
         );
         client().prepareIndex("test").setId("1")
                 .setSource(jsonBuilder().startObject()
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
index 74298b3960486..58b65a80b3844 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequest.java
@@ -253,8 +253,8 @@ public CreateIndexRequest mapping(Map<String, ?> source) {
      * A specialized simplified mapping source method, takes the form of simple properties definition:
      * ("field1", "type=string,store=true").
      */
-    public CreateIndexRequest simpleMapping(Object... source) {
-        mapping(PutMappingRequest.buildFromSimplifiedDef(MapperService.SINGLE_MAPPING_NAME, source));
+    public CreateIndexRequest simpleMapping(String... source) {
+        mapping(PutMappingRequest.simpleMapping(source));
         return this;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
index 829ddbe05caeb..602ee85461bf3 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/create/CreateIndexRequestBuilder.java
@@ -135,7 +135,7 @@ public CreateIndexRequestBuilder setMapping(Map<String, Object> source) {
      * A specialized simplified mapping source method, takes the form of simple properties definition:
      * ("field1", "type=string,store=true").
      */
-    public CreateIndexRequestBuilder setMapping(Object... source) {
+    public CreateIndexRequestBuilder setMapping(String... source) {
         request.simpleMapping(source);
         return this;
     }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequest.java
index f3cc641fb071c..158b8cfd0b1e4 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequest.java
@@ -172,8 +172,8 @@ public String source() {
      * Also supports metadata mapping fields such as `_all` and `_parent` as property definition, these metadata
      * mapping fields will automatically be put on the top level mapping object.
      */
-    public PutMappingRequest source(Object... source) {
-        return source(buildFromSimplifiedDef(MapperService.SINGLE_MAPPING_NAME, source));
+    public PutMappingRequest source(String... source) {
+        return source(simpleMapping(source));
     }
 
     public String origin() {
@@ -187,8 +187,6 @@ public PutMappingRequest origin(String origin) {
     }
 
     /**
-     * @param type
-     *            the mapping type
      * @param source
      *            consisting of field/properties pairs (e.g. "field1",
      *            "type=string,store=true")
@@ -196,22 +194,19 @@ public PutMappingRequest origin(String origin) {
      *             if the number of the source arguments is not divisible by two
      * @return the mappings definition
      */
-    public static XContentBuilder buildFromSimplifiedDef(String type, Object... source) {
+    public static XContentBuilder simpleMapping(String... source) {
         if (source.length % 2 != 0) {
             throw new IllegalArgumentException("mapping source must be pairs of fieldnames and properties definition.");
         }
         try {
             XContentBuilder builder = XContentFactory.jsonBuilder();
             builder.startObject();
-            if (type != null) {
-                builder.startObject(type);
-            }
 
             for (int i = 0; i < source.length; i++) {
-                String fieldName = source[i++].toString();
+                String fieldName = source[i++];
                 if (RESERVED_FIELDS.contains(fieldName)) {
                     builder.startObject(fieldName);
-                    String[] s1 = Strings.splitStringByCommaToArray(source[i].toString());
+                    String[] s1 = Strings.splitStringByCommaToArray(source[i]);
                     for (String s : s1) {
                         String[] s2 = Strings.split(s, "=");
                         if (s2.length != 2) {
@@ -225,13 +220,13 @@ public static XContentBuilder buildFromSimplifiedDef(String type, Object... sour
 
             builder.startObject("properties");
             for (int i = 0; i < source.length; i++) {
-                String fieldName = source[i++].toString();
+                String fieldName = source[i++];
                 if (RESERVED_FIELDS.contains(fieldName)) {
                     continue;
                 }
 
                 builder.startObject(fieldName);
-                String[] s1 = Strings.splitStringByCommaToArray(source[i].toString());
+                String[] s1 = Strings.splitStringByCommaToArray(source[i]);
                 for (String s : s1) {
                     String[] s2 = Strings.split(s, "=");
                     if (s2.length != 2) {
@@ -242,9 +237,6 @@ public static XContentBuilder buildFromSimplifiedDef(String type, Object... sour
                 builder.endObject();
             }
             builder.endObject();
-            if (type != null) {
-                builder.endObject();
-            }
             builder.endObject();
             return builder;
         } catch (Exception e) {
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequestBuilder.java
index 5eebe4321fcef..f32d60e2d1883 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequestBuilder.java
@@ -87,7 +87,7 @@ public PutMappingRequestBuilder setSource(String mappingSource, XContentType xCo
      * A specialized simplified mapping source method, takes the form of simple properties definition:
      * ("field1", "type=string,store=true").
      */
-    public PutMappingRequestBuilder setSource(Object... source) {
+    public PutMappingRequestBuilder setSource(String... source) {
         request.source(source);
         return this;
     }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestBuilder.java
index 4451c2b481bf7..242685d93bec9 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/RolloverRequestBuilder.java
@@ -25,7 +25,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.common.xcontent.XContentType;
 
 
 public class RolloverRequestBuilder extends MasterNodeOperationRequestBuilder<RolloverRequest, RolloverResponse,
@@ -74,12 +73,12 @@ public RolloverRequestBuilder alias(Alias alias) {
         return this;
     }
 
-    public RolloverRequestBuilder mapping(String type, Object... source) {
+    public RolloverRequestBuilder simpleMapping(String... source) {
         this.request.getCreateIndexRequest().simpleMapping(source);
         return this;
     }
 
-    public RolloverRequestBuilder mapping(String type, String source, XContentType xContentType) {
+    public RolloverRequestBuilder mapping(String source) {
         this.request.getCreateIndexRequest().mapping(source);
         return this;
     }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
index d1c4c70961136..3e6b4f5bc45d2 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
@@ -43,6 +43,7 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
+import org.elasticsearch.index.mapper.MapperService;
 
 import java.io.IOException;
 import java.util.Collections;
@@ -295,8 +296,8 @@ public PutIndexTemplateRequest mapping(String type, Map<String, Object> source)
      * A specialized simplified mapping source method, takes the form of simple properties definition:
      * ("field1", "type=string,store=true").
      */
-    public PutIndexTemplateRequest mapping(String type, Object... source) {
-        mapping(type, PutMappingRequest.buildFromSimplifiedDef(type, source));
+    public PutIndexTemplateRequest mapping(String... source) {
+        mapping(MapperService.SINGLE_MAPPING_NAME, PutMappingRequest.simpleMapping(source));
         return this;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestBuilder.java
index d4d1e9f299e69..b4d998c6e6770 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestBuilder.java
@@ -122,8 +122,8 @@ public PutIndexTemplateRequestBuilder addMapping(String type, String source, XCo
      * A specialized simplified mapping source method, takes the form of simple properties definition:
      * ("field1", "type=string,store=true").
      */
-    public PutIndexTemplateRequestBuilder addMapping(String type, Object... source) {
-        request.mapping(type, source);
+    public PutIndexTemplateRequestBuilder setMapping(String... source) {
+        request.mapping(source);
         return this;
     }
 
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequestTests.java
index 64b04d6adfbd2..44b12217616e6 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingRequestTests.java
@@ -50,13 +50,13 @@ public void testValidation() {
     }
 
     /**
-     * Test that {@link PutMappingRequest#buildFromSimplifiedDef(String, Object...)}
+     * Test that {@link PutMappingRequest#simpleMapping(String...)}
      * rejects inputs where the {@code Object...} varargs of field name and properties are not
      * paired correctly
      */
     public void testBuildFromSimplifiedDef() {
         IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                () -> PutMappingRequest.buildFromSimplifiedDef("type", "only_field"));
+                () -> PutMappingRequest.simpleMapping("only_field"));
         assertEquals("mapping source must be pairs of fieldnames and properties definition.", e.getMessage());
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldQueryStringQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldQueryStringQueryBuilderTests.java
index 535f27c5aa3db..b61e3ae1f42ce 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldQueryStringQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldQueryStringQueryBuilderTests.java
@@ -54,7 +54,7 @@ public class RangeFieldQueryStringQueryBuilderTests extends AbstractQueryTestCas
 
     @Override
     protected void initializeAdditionalMappings(MapperService mapperService) throws IOException {
-        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef("_doc",
+        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
             INTEGER_RANGE_FIELD_NAME, "type=integer_range",
             LONG_RANGE_FIELD_NAME, "type=long_range",
             FLOAT_RANGE_FIELD_NAME, "type=float_range",
diff --git a/server/src/test/java/org/elasticsearch/index/query/MatchQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/MatchQueryBuilderTests.java
index 3425ce0a5e268..36d39fa3406ed 100644
--- a/server/src/test/java/org/elasticsearch/index/query/MatchQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/MatchQueryBuilderTests.java
@@ -348,8 +348,7 @@ public void testExceptionUsingAnalyzerOnNumericField() {
 
     @Override
     protected void initializeAdditionalMappings(MapperService mapperService) throws IOException {
-        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef(
-            "_doc",
+        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
             "string_boost", "type=text,boost=4", "string_no_pos",
             "type=text,index_options=docs"))
             ),
diff --git a/server/src/test/java/org/elasticsearch/index/query/NestedQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/NestedQueryBuilderTests.java
index e2d4c4b4a0ac3..4f4aff6d10cdf 100644
--- a/server/src/test/java/org/elasticsearch/index/query/NestedQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/NestedQueryBuilderTests.java
@@ -60,7 +60,7 @@ public class NestedQueryBuilderTests extends AbstractQueryTestCase<NestedQueryBu
 
     @Override
     protected void initializeAdditionalMappings(MapperService mapperService) throws IOException {
-        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef("_doc",
+        mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
                 STRING_FIELD_NAME, "type=text",
                 INT_FIELD_NAME, "type=integer",
                 DOUBLE_FIELD_NAME, "type=double",
diff --git a/server/src/test/java/org/elasticsearch/index/query/TermsSetQueryBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/TermsSetQueryBuilderTests.java
index 3f7b8c38a8d4f..0244709388b08 100644
--- a/server/src/test/java/org/elasticsearch/index/query/TermsSetQueryBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/TermsSetQueryBuilderTests.java
@@ -77,7 +77,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     @Override
     protected void initializeAdditionalMappings(MapperService mapperService) throws IOException {
         String docType = "_doc";
-        mapperService.merge(docType, new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef(docType,
+        mapperService.merge(docType, new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
                 "m_s_m", "type=long"
         ))), MapperService.MergeReason.MAPPING_UPDATE);
     }
diff --git a/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java b/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
index a3c3c1e25001f..8367791d4748d 100644
--- a/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
@@ -382,7 +382,7 @@ public void testIndexTemplateWithAliases() throws Exception {
 
         client().admin().indices().preparePutTemplate("template_with_aliases")
                 .setPatterns(Collections.singletonList("te*"))
-                .addMapping("_doc", "type", "type=keyword", "field", "type=text")
+                .setMapping("type", "type=keyword", "field", "type=text")
                 .addAlias(new Alias("simple_alias"))
                 .addAlias(new Alias("templated_alias-{index}"))
                 .addAlias(new Alias("filtered_alias").filter("{\"term\":{\"type\":\"type2\"}}"))
@@ -622,7 +622,7 @@ public void testStrictAliasParsingInIndicesCreatedViaTemplates() throws Exceptio
         client().admin().indices().preparePutTemplate("template1")
                 .setPatterns(Collections.singletonList("a*"))
                 .setOrder(0)
-                .addMapping("test", "field", "type=text")
+                .setMapping("field", "type=text")
                 .addAlias(new Alias("alias1").filter(termQuery("field", "value"))).get();
         // Indexing into b index should fail, since there is field with name 'field' in the mapping
         client().admin().indices().preparePutTemplate("template4")
@@ -706,7 +706,7 @@ public void testOrderAndVersion() {
                                               .setPatterns(Collections.singletonList("te*"))
                                               .setVersion(version)
                                               .setOrder(order)
-                                              .addMapping("test", "field", "type=text")
+                                              .setMapping("field", "type=text")
                                               .get());
 
         GetIndexTemplatesResponse response = client().admin().indices().prepareGetTemplates("versioned_template").get();
diff --git a/server/src/test/java/org/elasticsearch/search/searchafter/SearchAfterIT.java b/server/src/test/java/org/elasticsearch/search/searchafter/SearchAfterIT.java
index b379be435e529..726e1f7e718a6 100644
--- a/server/src/test/java/org/elasticsearch/search/searchafter/SearchAfterIT.java
+++ b/server/src/test/java/org/elasticsearch/search/searchafter/SearchAfterIT.java
@@ -293,7 +293,7 @@ private void createIndexMappingsFromObjectType(String indexName, List<Object> ty
                 fail("Can't match type [" + type + "]");
             }
         }
-        indexRequestBuilder.setMapping(mappings.toArray()).get();
+        indexRequestBuilder.setMapping(mappings.toArray(new String[0])).get();
         ensureGreen();
     }
 
diff --git a/test/framework/src/main/java/org/elasticsearch/test/AbstractBuilderTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/AbstractBuilderTestCase.java
index 07420ce2d3f7b..a682cf4ea490d 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/AbstractBuilderTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/AbstractBuilderTestCase.java
@@ -374,7 +374,7 @@ public void onRemoval(ShardId shardId, Accountable accountable) {
             });
 
             if (registerType) {
-                mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef("_doc",
+                mapperService.merge("_doc", new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
                     STRING_FIELD_NAME, "type=text",
                     STRING_FIELD_NAME_2, "type=keyword",
                     STRING_ALIAS_FIELD_NAME, "type=alias,path=" + STRING_FIELD_NAME,
@@ -400,11 +400,11 @@ public void onRemoval(ShardId shardId, Accountable accountable) {
                 testCase.initializeAdditionalMappings(mapperService);
             }
         }
-                
+
         public static Predicate<String> indexNameMatcher() {
             // Simplistic index name matcher used for testing
             return pattern -> Regex.simpleMatch(pattern, index.getName());
-        }                 
+        }
 
         @Override
         public void close() throws IOException {
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
index 4c371e8cebfd4..6265dbe559fa5 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
@@ -284,7 +284,7 @@ protected IndexService createIndex(String index, Settings settings, XContentBuil
     /**
      * Create a new index on the singleton node with the provided index settings.
      */
-    protected IndexService createIndex(String index, Settings settings, String type, Object... mappings) {
+    protected IndexService createIndex(String index, Settings settings, String type, String... mappings) {
         CreateIndexRequestBuilder createIndexRequestBuilder = client().admin().indices().prepareCreate(index).setSettings(settings);
         if (type != null) {
             createIndexRequestBuilder.setMapping(mappings);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
index b2ec8e192fcc2..ef4d35401675b 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/snapshots/SourceOnlySnapshotIT.java
@@ -227,7 +227,7 @@ private IndexRequestBuilder[] snashotAndRestore(final String sourceIdx,
 
         CreateIndexRequestBuilder createIndexRequestBuilder = prepareCreate(sourceIdx, 0, Settings.builder()
             .put("number_of_shards", numShards).put("number_of_replicas", 0));
-        List<Object> mappings = new ArrayList<>();
+        List<String> mappings = new ArrayList<>();
         if (requireRouting) {
             mappings.addAll(Arrays.asList("_routing", "required=true"));
         }
@@ -236,7 +236,7 @@ private IndexRequestBuilder[] snashotAndRestore(final String sourceIdx,
             mappings.addAll(Arrays.asList("nested", "type=nested", "incorrect", "type=object"));
         }
         if (mappings.isEmpty() == false) {
-            createIndexRequestBuilder.setMapping(mappings.toArray());
+            createIndexRequestBuilder.setMapping(mappings.toArray(new String[0]));
         }
         assertAcked(createIndexRequestBuilder);
         ensureGreen();
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityRandomTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityRandomTests.java
index 041de70e07229..2666fd49cbaa7 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityRandomTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/integration/FieldLevelSecurityRandomTests.java
@@ -126,7 +126,7 @@ public Settings nodeSettings(int nodeOrdinal) {
                 .build();
     }
 
-    public void testRandom() throws Exception {
+    public void testRandom() {
         int j = 0;
         Map<String, Object> doc = new HashMap<>();
         String[] fieldMappers = new String[(allowedFields.size() + disAllowedFields.size()) * 2];
@@ -141,7 +141,7 @@ public void testRandom() throws Exception {
             doc.put(field, "value");
         }
         assertAcked(client().admin().indices().prepareCreate("test")
-                        .setMapping((Object[])fieldMappers)
+                        .setMapping(fieldMappers)
         );
         client().prepareIndex("test").setId("1").setSource(doc).setRefreshPolicy(IMMEDIATE).get();
 
diff --git a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryBuilderTests.java b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryBuilderTests.java
index fb0d7fbbe7557..c28189548d045 100644
--- a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryBuilderTests.java
+++ b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/query/ShapeQueryBuilderTests.java
@@ -67,7 +67,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
 
     @Override
     protected void initializeAdditionalMappings(MapperService mapperService) throws IOException {
-        mapperService.merge(docType, new CompressedXContent(Strings.toString(PutMappingRequest.buildFromSimplifiedDef(docType,
+        mapperService.merge(docType, new CompressedXContent(Strings.toString(PutMappingRequest.simpleMapping(
             fieldName(), "type=shape"))), MapperService.MergeReason.MAPPING_UPDATE);
     }
 

From 853d52817b61dfbbdf90acb5027f4baa8e0ee604 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Fri, 10 Jan 2020 11:09:00 -0500
Subject: [PATCH 502/686] [ML][Inference] Unify top_classes object field names
 with analytics (#50858)

---
 .../results/ClassificationInferenceResults.java      | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
index 526b37314b56b..226a9c1104346 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
@@ -110,15 +110,15 @@ public String getWriteableName() {
 
     public static class TopClassEntry implements Writeable {
 
-        public final ParseField CLASSIFICATION = new ParseField("classification");
-        public final ParseField PROBABILITY = new ParseField("probability");
+        public final ParseField CLASS_NAME = new ParseField("class_name");
+        public final ParseField CLASS_PROBABILITY = new ParseField("class_probability");
 
         private final String classification;
         private final double probability;
 
         public TopClassEntry(String classification, Double probability) {
-            this.classification = ExceptionsHelper.requireNonNull(classification, CLASSIFICATION);
-            this.probability = ExceptionsHelper.requireNonNull(probability, PROBABILITY);
+            this.classification = ExceptionsHelper.requireNonNull(classification, CLASS_NAME);
+            this.probability = ExceptionsHelper.requireNonNull(probability, CLASS_PROBABILITY);
         }
 
         public TopClassEntry(StreamInput in) throws IOException {
@@ -136,8 +136,8 @@ public double getProbability() {
 
         public Map<String, Object> asValueMap() {
             Map<String, Object> map = new HashMap<>(2);
-            map.put(CLASSIFICATION.getPreferredName(), classification);
-            map.put(PROBABILITY.getPreferredName(), probability);
+            map.put(CLASS_NAME.getPreferredName(), classification);
+            map.put(CLASS_PROBABILITY.getPreferredName(), probability);
             return map;
         }
 

From 0b67fa169b2e100913cca322c278ba9ff6fea6dd Mon Sep 17 00:00:00 2001
From: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
Date: Fri, 10 Jan 2020 17:29:00 +0100
Subject: [PATCH 503/686] Fix testSkipRefreshIfShardIsRefreshingAlready
 (#50856)

The test checked queue size and active count, however,
ThreadPoolExecutor pulls out the request from the queue before marking
the worker active, risking that we think all tasks are done when they
are not. Now check on completed-tasks metric instead, which is
guaranteed to be monotonic.

Relates #50769
---
 .../indices/IndexingMemoryControllerTests.java             | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerTests.java b/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerTests.java
index 5a4fc6e07a873..9d7a77583f48d 100644
--- a/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/IndexingMemoryControllerTests.java
@@ -432,19 +432,18 @@ protected long getShardWritingBytes(IndexShard shard) {
             }
         };
         int iterations = randomIntBetween(10, 100);
+        ThreadPoolStats.Stats beforeStats = getRefreshThreadPoolStats();
         for (int i = 0; i < iterations; i++) {
             controller.forceCheck();
         }
         assertBusy(() -> {
             ThreadPoolStats.Stats stats = getRefreshThreadPoolStats();
-            assertThat(stats.getQueue(), equalTo(0));
-            assertThat(stats.getActive(), equalTo(1));
+            assertThat(stats.getCompleted(), equalTo(beforeStats.getCompleted() + iterations - 1));
         });
         refreshLatch.get().countDown(); // allow refresh
         assertBusy(() -> {
             ThreadPoolStats.Stats stats = getRefreshThreadPoolStats();
-            assertThat(stats.getQueue(), equalTo(0));
-            assertThat(stats.getActive(), equalTo(0));
+            assertThat(stats.getCompleted(), equalTo(beforeStats.getCompleted() + iterations));
         });
         assertThat(shard.refreshStats().getTotal(), equalTo(refreshStats.getTotal() + 1));
         closeShards(shard);

From 617b4a00166bebd21cf21171ea7a980642ff1ff4 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Fri, 10 Jan 2020 17:51:56 +0100
Subject: [PATCH 504/686] Fix upgrade of custom similarity (#50851)

This change fixes the upgrade of index metadata that contain
a custom similarity with options that are not compatible with BM25.
The upgrade doesn't need a real similarity service so we fake one that
resolves all custom similarity to BM25 but this logic fails because the
BM25 provider checks that all options are compatible. This commit removes
the verification step as it is not needed during the upgrade (the verification
is done when the index is restored/opened).

Closes #50763
---
 .../metadata/MetaDataIndexUpgradeService.java        |  3 ++-
 .../metadata/MetaDataIndexUpgradeServiceTests.java   | 12 ++++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexUpgradeService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexUpgradeService.java
index 52ee0be49ef65..9c4696bfa70f5 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexUpgradeService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexUpgradeService.java
@@ -22,6 +22,7 @@
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.apache.lucene.analysis.Analyzer;
+import org.apache.lucene.search.similarities.BM25Similarity;
 import org.apache.lucene.search.similarities.Similarity;
 import org.elasticsearch.Version;
 import org.elasticsearch.common.TriFunction;
@@ -145,7 +146,7 @@ public boolean containsKey(Object key) {
                 @Override
                 public TriFunction<Settings, Version, ScriptService, Similarity> get(Object key) {
                     assert key instanceof String : "key must be a string but was: " + key.getClass();
-                    return SimilarityService.BUILT_IN.get(SimilarityService.DEFAULT_SIMILARITY);
+                    return (settings, version, scriptService) -> new BM25Similarity();
                 }
 
                 // this entrySet impl isn't fully correct but necessary as SimilarityService will iterate
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataIndexUpgradeServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataIndexUpgradeServiceTests.java
index 32e7a3bcbd873..20deb39c72322 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataIndexUpgradeServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataIndexUpgradeServiceTests.java
@@ -82,6 +82,18 @@ public void testUpgrade() {
         assertSame(src, service.upgradeIndexMetaData(src, Version.CURRENT.minimumIndexCompatibilityVersion())); // no double upgrade
     }
 
+    public void testUpgradeCustomSimilarity() {
+        MetaDataIndexUpgradeService service = getMetaDataIndexUpgradeService();
+        IndexMetaData src = newIndexMeta("foo",
+            Settings.builder()
+                .put("index.similarity.my_similarity.type", "DFR")
+                .put("index.similarity.my_similarity.after_effect", "l")
+                .build());
+        assertFalse(service.isUpgraded(src));
+        src = service.upgradeIndexMetaData(src, Version.CURRENT.minimumIndexCompatibilityVersion());
+        assertTrue(service.isUpgraded(src));
+    }
+
     public void testIsUpgraded() {
         MetaDataIndexUpgradeService service = getMetaDataIndexUpgradeService();
         IndexMetaData src = newIndexMeta("foo", Settings.builder().put("index.refresh_interval", "-200").build());

From adb135fa7b6f1ad258e9cfa3a96d93361c29db26 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 10 Jan 2020 12:13:56 -0500
Subject: [PATCH 505/686] Drop BWC suppressions for composite aggs (#50857)

When I implemented #50609 I suppressed a few backwards compatibility
checks until I finished the backport. I've now finished the backport so
this enables the tests.
---
 .../test/search.aggregation/230_composite.yml             | 8 ++++----
 x-pack/qa/rolling-upgrade/build.gradle                    | 7 -------
 .../test/mixed_cluster/80_transform_jobs_crud.yml         | 8 --------
 3 files changed, 4 insertions(+), 19 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
index 1e9a2ac8df4c0..087cf7e092fa3 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
@@ -243,7 +243,7 @@ setup:
 ---
 "Composite aggregation with format":
   - skip:
-      version: " - 7.99.99" # after BWC merged revert to 7.1.99
+      version: " - 7.1.99"
       reason:  calendar_interval introduced in 7.2.0
       features: warnings
 
@@ -309,7 +309,7 @@ setup:
 ---
 "Composite aggregation with format and calendar_interval":
   - skip:
-      version: " - 7.99.99"  # after BWC merged revert to 7.1.99
+      version: " - 7.1.99"
       reason:  calendar_interval introduced in 7.2.0
 
   - do:
@@ -370,8 +370,8 @@ setup:
 ---
 "Composite aggregation with date_histogram offset":
   - skip:
-      version: " - 7.99.99" # after BWC merged revert to 7.5.99
-      reason:  offset introduced in 8.0.0
+      version: " - 7.5.99"
+      reason:  offset introduced in 7.6.0
 
   - do:
       search:
diff --git a/x-pack/qa/rolling-upgrade/build.gradle b/x-pack/qa/rolling-upgrade/build.gradle
index 527f594ce4174..dc7856a38e26d 100644
--- a/x-pack/qa/rolling-upgrade/build.gradle
+++ b/x-pack/qa/rolling-upgrade/build.gradle
@@ -161,13 +161,6 @@ for (Version bwcVersion : bwcVersions.wireCompatible) {
     nonInputProperties.systemProperty('tests.clustername', "${-> testClusters."${baseName}".getName()}")
     systemProperty 'tests.rest.suite', 'upgraded_cluster'
     systemProperty 'tests.upgrade_from_version', bwcVersion.toString().replace('-SNAPSHOT', '')
-    // disabled temporarily for backporting serialization change
-    if (bwcVersion.before('8.0.0')) {
-      systemProperty 'tests.rest.blacklist', [
-        'upgraded_cluster/80_transform_jobs_crud/Get start, stop mixed cluster batch transform',
-        'upgraded_cluster/80_transform_jobs_crud/Test GET, mixed continuous transforms',
-      ].join(',')
-    }
   }
 
   tasks.register("${baseName}#bwcTest") {
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/80_transform_jobs_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/80_transform_jobs_crud.yml
index 1817984be7cd5..57d16baf58dad 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/80_transform_jobs_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/80_transform_jobs_crud.yml
@@ -1,9 +1,5 @@
 ---
 "Test put batch transform on mixed cluster":
-  - skip:
-      version: " - 7.99.99" # after BWC merged then remove entirely
-      reason:  disabled temporarily for backporting serialization change
-
   - do:
       cluster.health:
         index: "transform-airline-data"
@@ -110,10 +106,6 @@
 
 ---
 "Test put continuous transform on mixed cluster":
-  - skip:
-      version: " - 7.99.99" # after BWC merged then remove entirely
-      reason:  disabled temporarily for backporting serialization change
-
   - do:
       cluster.health:
         index: "transform-airline-data-cont"

From f40bd308e881f69c6614d9d5ceeda939a736f0c0 Mon Sep 17 00:00:00 2001
From: Julie Tibshirani <julie.tibshirani@elastic.co>
Date: Fri, 10 Jan 2020 09:36:02 -0800
Subject: [PATCH 506/686] Adjust the skip version in flattened field telemetry
 tests.

It can be lowered to 7.5.99 now that the functionality was backported in #48972.
---
 .../rest-api-spec/test/flattened/20_flattened_stats.yml       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/flattened/20_flattened_stats.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/flattened/20_flattened_stats.yml
index a2a670769976a..88c32d76b0b7b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/flattened/20_flattened_stats.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/flattened/20_flattened_stats.yml
@@ -1,7 +1,7 @@
 setup:
   - skip:
-      version: " - 7.99.99"
-      reason: "telemetry for flattened fields was added in 8.0"
+      version: " - 7.5.99"
+      reason: "telemetry for flattened fields was added in 7.6.0"
 
 ---
 "Usage stats for flattened fields":

From c5d240267a0ceb3f3e8fb56343ac5a172b34f23a Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 10 Jan 2020 15:12:40 -0500
Subject: [PATCH 507/686] Fix format problem in composite of unmapped (#50869)

When a composite aggregation is reduced using the results from an
index that has one of the fields unmapped we were throwing away the
formatter. This is mildly annoying, except in the case of IP addresses
which were coming out as non-utf-8-characters. And tripping assertions.

This carefully preserves the formatter from the working bucket.

Closes #50600
---
 .../test/search.aggregation/230_composite.yml | 47 +++++++++++++++++++
 .../elasticsearch/search/DocValueFormat.java  | 10 ++++
 .../bucket/composite/InternalComposite.java   | 34 ++++++++++++--
 .../composite/InternalCompositeTests.java     | 34 +++++++++++++-
 4 files changed, 120 insertions(+), 5 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
index 087cf7e092fa3..adc61f1204fa9 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
@@ -694,6 +694,7 @@ setup:
   - match: { aggregations.test.buckets.3.key.geo: "12/2048/0" }
   - match: { aggregations.test.buckets.3.key.kw: "bar" }
   - match: { aggregations.test.buckets.3.doc_count: 1 }
+
 ---
 "Simple Composite aggregation with geotile grid add aggregate after":
   - skip:
@@ -735,3 +736,49 @@ setup:
   - match: { aggregations.test.buckets.2.key.geo: "12/2048/0" }
   - match: { aggregations.test.buckets.2.key.kw: "bar" }
   - match: { aggregations.test.buckets.2.doc_count: 1 }
+
+---
+"Mixed ip and unmapped fields":
+  - skip:
+      version: " - 7.99.99"
+      reason: This will fail against 7.x until the fix is backported there
+  # It is important that the index *without* the ip field be sorted *before*
+  # the index *with* the ip field because that has caused bugs in the past.
+  - do:
+      indices.create:
+        index: test_1
+  - do:
+      indices.create:
+        index: test_2
+        body:
+          mappings:
+            properties:
+              f:
+                type: ip
+  - do:
+      index:
+        index:   test_2
+        id:      1
+        body:    { "f": "192.168.0.1" }
+        refresh: true
+
+  - do:
+      search:
+        index: test_*
+        body:
+          aggregations:
+            test:
+              composite:
+                sources: [
+                  "f": {
+                    "terms": {
+                      "field": "f"
+                    }
+                  }
+                ]
+
+  - match: { hits.total.value: 1 }
+  - match: { hits.total.relation: eq }
+  - length: { aggregations.test.buckets: 1 }
+  - match: { aggregations.test.buckets.0.key.f: "192.168.0.1" }
+  - match: { aggregations.test.buckets.0.doc_count: 1 }
diff --git a/server/src/main/java/org/elasticsearch/search/DocValueFormat.java b/server/src/main/java/org/elasticsearch/search/DocValueFormat.java
index bf0f876704148..b09c8983c1394 100644
--- a/server/src/main/java/org/elasticsearch/search/DocValueFormat.java
+++ b/server/src/main/java/org/elasticsearch/search/DocValueFormat.java
@@ -139,6 +139,11 @@ public double parseDouble(String value, boolean roundUp, LongSupplier now) {
         public BytesRef parseBytesRef(String value) {
             return new BytesRef(value);
         }
+
+        @Override
+        public String toString() {
+            return "raw";
+        }
     };
 
     DocValueFormat BINARY = new DocValueFormat() {
@@ -335,6 +340,11 @@ public String format(BytesRef value) {
         public BytesRef parseBytesRef(String value) {
             return new BytesRef(InetAddressPoint.encode(InetAddresses.forString(value)));
         }
+
+        @Override
+        public String toString() {
+            return "ip";
+        }
     };
 
     final class Decimal implements DocValueFormat {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
index 503c1780d22f0..9dd179fa79702 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/InternalComposite.java
@@ -134,6 +134,13 @@ public List<InternalBucket> getBuckets() {
         return buckets;
     }
 
+    /**
+     * The formats used when writing the keys. Package private for testing.
+     */
+    List<DocValueFormat> getFormats() {
+        return formats;
+    }
+
     @Override
     public Map<String, Object> afterKey() {
         if (afterKey != null) {
@@ -189,8 +196,17 @@ public InternalAggregation reduce(List<InternalAggregation> aggregations, Reduce
             reduceContext.consumeBucketsAndMaybeBreak(1);
             result.add(reduceBucket);
         }
-        final CompositeKey lastKey = result.size() > 0 ? result.get(result.size()-1).getRawKey() : null;
-        return new InternalComposite(name, size, sourceNames, formats, result, lastKey, reverseMuls,
+
+        List<DocValueFormat> reducedFormats = formats;
+        CompositeKey lastKey = null;
+        if (result.size() > 0) {
+            lastBucket = result.get(result.size() - 1);
+            /* Attach the formats from the last bucket to the reduced composite
+             * so that we can properly format the after key. */
+            reducedFormats = lastBucket.formats;
+            lastKey = lastBucket.getRawKey();
+        }
+        return new InternalComposite(name, size, sourceNames, reducedFormats, result, lastKey, reverseMuls,
             earlyTerminated, pipelineAggregators(), metaData);
     }
 
@@ -204,7 +220,12 @@ protected InternalBucket reduceBucket(List<InternalBucket> buckets, ReduceContex
             aggregations.add(bucket.aggregations);
         }
         InternalAggregations aggs = InternalAggregations.reduce(aggregations, context);
-        return new InternalBucket(sourceNames, formats, buckets.get(0).key, reverseMuls, docCount, aggs);
+        /* Use the formats from the bucket because they'll be right to format
+         * the key. The formats on the InternalComposite doing the reducing are
+         * just whatever formats make sense for *its* index. This can be real
+         * trouble when the index doing the reducing is unmapped. */
+        var reducedFormats = buckets.get(0).formats;
+        return new InternalBucket(sourceNames, reducedFormats, buckets.get(0).key, reverseMuls, docCount, aggs);
     }
 
     @Override
@@ -334,6 +355,13 @@ public Aggregations getAggregations() {
             return aggregations;
         }
 
+        /**
+         * The formats used when writing the keys. Package private for testing.
+         */
+        List<DocValueFormat> getFormats() {
+            return formats;
+        }
+
         @Override
         public int compareKey(InternalBucket other) {
             for (int i = 0; i < key.size(); i++) {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/InternalCompositeTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/InternalCompositeTests.java
index 4edd694a3ac03..67ac4d9163dcb 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/InternalCompositeTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/InternalCompositeTests.java
@@ -47,6 +47,9 @@
 import java.util.stream.IntStream;
 
 import static com.carrotsearch.randomizedtesting.RandomizedTest.randomAsciiLettersOfLengthBetween;
+import static java.util.Collections.emptyList;
+import static java.util.Collections.emptyMap;
+import static java.util.stream.Collectors.toList;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.greaterThan;
@@ -238,8 +241,7 @@ public void testReduceSame() throws IOException {
         for (int i = 0; i < numSame; i++) {
             toReduce.add(result);
         }
-        InternalComposite finalReduce = (InternalComposite) result.reduce(toReduce,
-            new InternalAggregation.ReduceContext(BigArrays.NON_RECYCLING_INSTANCE, null, true));
+        InternalComposite finalReduce = (InternalComposite) result.reduce(toReduce, reduceContext());
         assertThat(finalReduce.getBuckets().size(), equalTo(result.getBuckets().size()));
         Iterator<InternalComposite.InternalBucket> expectedIt = result.getBuckets().iterator();
         for (InternalComposite.InternalBucket bucket : finalReduce.getBuckets()) {
@@ -249,6 +251,30 @@ public void testReduceSame() throws IOException {
         }
     }
 
+    /**
+     * Check that reducing with an unmapped index produces useful formats.
+     */
+    public void testReduceUnmapped() throws IOException {
+        var mapped = createTestInstance(randomAlphaOfLength(10), emptyList(), emptyMap(), InternalAggregations.EMPTY);
+        var rawFormats = formats.stream().map(f -> DocValueFormat.RAW).collect(toList());
+        var unmapped = new InternalComposite(mapped.getName(), mapped.getSize(), sourceNames,
+                rawFormats, emptyList(), null, reverseMuls, true, emptyList(), emptyMap());
+        List<InternalAggregation> toReduce = Arrays.asList(unmapped, mapped);
+        Collections.shuffle(toReduce, random());
+        InternalComposite finalReduce = (InternalComposite) unmapped.reduce(toReduce, reduceContext());
+        assertThat(finalReduce.getBuckets().size(), equalTo(mapped.getBuckets().size()));
+        if (false == mapped.getBuckets().isEmpty()) {
+            assertThat(finalReduce.getFormats(), equalTo(mapped.getFormats()));
+        }
+        var expectedIt = mapped.getBuckets().iterator();
+        for (var bucket : finalReduce.getBuckets()) {
+            InternalComposite.InternalBucket expectedBucket = expectedIt.next();
+            assertThat(bucket.getRawKey(), equalTo(expectedBucket.getRawKey()));
+            assertThat(bucket.getDocCount(), equalTo(expectedBucket.getDocCount()));
+            assertThat(bucket.getFormats(), equalTo(expectedBucket.getFormats()));
+        }
+    }
+
     public void testCompareCompositeKeyBiggerFieldName() {
         InternalComposite.ArrayMap key1 = createMap(
             Arrays.asList("field1", "field2"),
@@ -381,4 +407,8 @@ private InternalComposite.ArrayMap createMap(List<String> fields, Comparable[] v
             values
         );
     }
+
+    private InternalAggregation.ReduceContext reduceContext() {
+        return new InternalAggregation.ReduceContext(BigArrays.NON_RECYCLING_INSTANCE, null, true);
+    }
 }

From c56637dd5a7759f19b566935996c0d166a334190 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Fri, 10 Jan 2020 13:34:16 -0700
Subject: [PATCH 508/686] Fix SLM check for restore in progress (#50868)

* Fix SLM check for restore in progress

This commit fixes the check in SLM where the `RestoreInProgress`
metadata was checked for existence. Rather than check existence we
should instead check the `isEmpty` method. Prior to this, a successful
restore for a repository that used SLM retention would prevent SLM
retention from running in subsequent invocations, due to SLM thinking
that a restore was still running.
---
 .../xpack/slm/SnapshotRetentionTask.java      |  3 +-
 .../slm/SLMSnapshotBlockingIntegTests.java    | 73 +++++++++++++++++++
 .../xpack/slm/SnapshotRetentionTaskTests.java | 17 ++++-
 3 files changed, 88 insertions(+), 5 deletions(-)

diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/slm/SnapshotRetentionTask.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/slm/SnapshotRetentionTask.java
index 25de192e76d04..689141b2cf235 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/slm/SnapshotRetentionTask.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/slm/SnapshotRetentionTask.java
@@ -446,7 +446,7 @@ public static boolean okayToDeleteSnapshots(ClusterState state) {
 
         // Cannot delete during a restore
         final RestoreInProgress restoreInProgress = state.custom(RestoreInProgress.TYPE);
-        if (restoreInProgress != null) {
+        if (restoreInProgress != null && restoreInProgress.isEmpty() == false) {
             return false;
         }
 
@@ -480,6 +480,7 @@ public void onNewClusterState(ClusterState state) {
                     logger.debug("retrying SLM snapshot retention deletion after snapshot operation has completed");
                     reRun.accept(state);
                 } else {
+                    logger.trace("received new cluster state but a snapshot operation is still running");
                     observer.waitForNextChange(this);
                 }
             } catch (Exception e) {
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SLMSnapshotBlockingIntegTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SLMSnapshotBlockingIntegTests.java
index 16f388fa49481..0b3c2d2dbd58f 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SLMSnapshotBlockingIntegTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SLMSnapshotBlockingIntegTests.java
@@ -8,6 +8,9 @@
 
 import org.elasticsearch.action.ActionFuture;
 import org.elasticsearch.action.admin.cluster.snapshots.get.GetSnapshotsResponse;
+import org.elasticsearch.action.admin.cluster.snapshots.restore.RestoreSnapshotAction;
+import org.elasticsearch.action.admin.cluster.snapshots.restore.RestoreSnapshotRequest;
+import org.elasticsearch.action.admin.cluster.snapshots.restore.RestoreSnapshotResponse;
 import org.elasticsearch.action.admin.cluster.snapshots.status.SnapshotStatus;
 import org.elasticsearch.action.admin.cluster.snapshots.status.SnapshotsStatusResponse;
 import org.elasticsearch.action.index.IndexRequestBuilder;
@@ -22,6 +25,7 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.repositories.RepositoriesService;
 import org.elasticsearch.repositories.RepositoryException;
+import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.snapshots.ConcurrentSnapshotExecutionException;
 import org.elasticsearch.snapshots.SnapshotInfo;
 import org.elasticsearch.snapshots.SnapshotMissingException;
@@ -30,6 +34,7 @@
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
 import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
+import org.elasticsearch.xpack.core.slm.SnapshotInvocationRecord;
 import org.elasticsearch.xpack.core.slm.SnapshotLifecyclePolicy;
 import org.elasticsearch.xpack.core.slm.SnapshotLifecyclePolicyItem;
 import org.elasticsearch.xpack.core.slm.SnapshotRetentionConfiguration;
@@ -385,6 +390,74 @@ private void testUnsuccessfulSnapshotRetention(boolean partialSuccess) throws Ex
         }
     }
 
+    public void testSLMRetentionAfterRestore() throws Exception {
+        final String indexName = "test";
+        final String policyName = "test-policy";
+        int docCount = 20;
+        for (int i = 0; i < docCount; i++) {
+            index(indexName, i + "", Collections.singletonMap("foo", "bar"));
+        }
+
+        // Create a snapshot repo
+        initializeRepo(REPO);
+
+        logger.info("--> creating policy {}", policyName);
+        createSnapshotPolicy(policyName, "snap", NEVER_EXECUTE_CRON_SCHEDULE, REPO, indexName, true, false,
+            new SnapshotRetentionConfiguration(TimeValue.ZERO, null, null));
+
+        logger.info("--> executing snapshot lifecycle");
+        final String snapshotName = executePolicy(policyName);
+
+        // Check that the executed snapshot shows up in the SLM output
+        assertBusy(() -> {
+            GetSnapshotLifecycleAction.Response getResp =
+                client().execute(GetSnapshotLifecycleAction.INSTANCE, new GetSnapshotLifecycleAction.Request(policyName)).get();
+            logger.info("--> checking for in progress snapshot...");
+
+            assertThat(getResp.getPolicies().size(), greaterThan(0));
+            SnapshotLifecyclePolicyItem item = getResp.getPolicies().get(0);
+            SnapshotInvocationRecord lastSuccess = item.getLastSuccess();
+            assertNotNull(lastSuccess);
+            assertThat(lastSuccess.getSnapshotName(), equalTo(snapshotName));
+        });
+
+        logger.info("--> restoring index");
+        RestoreSnapshotRequest restoreReq = new RestoreSnapshotRequest(REPO, snapshotName);
+        restoreReq.indices(indexName);
+        restoreReq.renamePattern("(.+)");
+        restoreReq.renameReplacement("restored_$1");
+        restoreReq.waitForCompletion(true);
+        RestoreSnapshotResponse resp = client().execute(RestoreSnapshotAction.INSTANCE, restoreReq).get();
+        assertThat(resp.status(), equalTo(RestStatus.OK));
+
+        logger.info("--> executing SLM retention");
+        assertAcked(client().execute(ExecuteSnapshotRetentionAction.INSTANCE, new ExecuteSnapshotRetentionAction.Request()).get());
+        logger.info("--> waiting for {} snapshot to be deleted", snapshotName);
+        assertBusy(() -> {
+            try {
+                try {
+                    GetSnapshotsResponse snapshotsStatusResponse = client().admin().cluster()
+                        .prepareGetSnapshots(REPO).setSnapshots(snapshotName).get();
+                    assertThat(snapshotsStatusResponse.getSnapshots(REPO), empty());
+                } catch (SnapshotMissingException e) {
+                    // This is what we want to happen
+                }
+                logger.info("--> snapshot [{}] has been deleted", snapshotName);
+            } catch (RepositoryException re) {
+                // Concurrent status calls and write operations may lead to failures in determining the current repository generation
+                // TODO: Remove this hack once tracking the current repository generation has been made consistent
+                throw new AssertionError(re);
+            }
+        });
+
+        // Cancel/delete the snapshot
+        try {
+            client().admin().cluster().prepareDeleteSnapshot(REPO, snapshotName).get();
+        } catch (SnapshotMissingException e) {
+            // ignore
+        }
+    }
+
     private SnapshotsStatusResponse getSnapshotStatus(String snapshotName) {
         try {
             return client().admin().cluster().prepareSnapshotStatus(REPO).setSnapshots(snapshotName).get();
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SnapshotRetentionTaskTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SnapshotRetentionTaskTests.java
index ede01f35b04b0..91887f3146aec 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SnapshotRetentionTaskTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/slm/SnapshotRetentionTaskTests.java
@@ -67,6 +67,7 @@
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.not;
 import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
 
 public class SnapshotRetentionTaskTests extends ESTestCase {
 
@@ -363,6 +364,14 @@ public void testOkToDeleteSnapshots() {
             .build();
 
         assertThat(SnapshotRetentionTask.okayToDeleteSnapshots(state), equalTo(false));
+
+        restoreInProgress = mock(RestoreInProgress.class);
+        when(restoreInProgress.isEmpty()).thenReturn(true);
+        state = ClusterState.builder(new ClusterName("cluster"))
+            .putCustom(RestoreInProgress.TYPE, restoreInProgress)
+            .build();
+
+        assertThat(SnapshotRetentionTask.okayToDeleteSnapshots(state), equalTo(true));
     }
 
     public void testSkipWhileStopping() throws Exception {
@@ -420,10 +429,10 @@ private void doTestRunManuallyDuringMode(OperationMode mode) throws Exception {
             final String repoId = "repo";
             SnapshotLifecyclePolicy policy = new SnapshotLifecyclePolicy(policyId, "snap", "1 * * * * ?",
                 repoId, null, new SnapshotRetentionConfiguration(TimeValue.timeValueDays(30), null, null));
-    
+
             ClusterState state = createState(mode, policy);
             ClusterServiceUtils.setState(clusterService, state);
-    
+
             AtomicBoolean retentionWasRun = new AtomicBoolean(false);
             MockSnapshotRetentionTask task = new MockSnapshotRetentionTask(noOpClient, clusterService,
                 new SnapshotLifecycleTaskTests.VerifyingHistoryStore(noOpClient, ZoneOffset.UTC, (historyItem) -> {
@@ -436,10 +445,10 @@ private void doTestRunManuallyDuringMode(OperationMode mode) throws Exception {
                 (deletionPolicyId, repo, snapId, slmStats, listener) -> {
                 },
                 System::nanoTime);
-    
+
             long time = System.currentTimeMillis();
             task.triggered(new SchedulerEngine.Event(SnapshotRetentionService.SLM_RETENTION_MANUAL_JOB_ID, time, time));
-    
+
             assertTrue("retention should be run manually even if SLM is disabled", retentionWasRun.get());
         } finally {
             threadPool.shutdownNow();

From d1adea6dcfc05bc0569d2c37fae74a2c38cedd75 Mon Sep 17 00:00:00 2001
From: Larry Gregory <larry.gregory@elastic.co>
Date: Fri, 10 Jan 2020 15:47:21 -0500
Subject: [PATCH 509/686] Adding GET/PUT ILM cluster privileges to
 `kibana_system` role (#49451)

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
---
 .../security/authz/store/ReservedRolesStore.java     |  4 +++-
 .../authz/store/ReservedRolesStoreTests.java         | 12 ++++++++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
index d9db50678c160..a86f213e2488c 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
@@ -9,6 +9,8 @@
 import org.elasticsearch.action.admin.cluster.remote.RemoteInfoAction;
 import org.elasticsearch.action.admin.cluster.repositories.get.GetRepositoriesAction;
 import org.elasticsearch.common.collect.MapBuilder;
+import org.elasticsearch.xpack.core.ilm.action.GetLifecycleAction;
+import org.elasticsearch.xpack.core.ilm.action.PutLifecycleAction;
 import org.elasticsearch.xpack.core.monitoring.action.MonitoringBulkAction;
 import org.elasticsearch.xpack.core.security.action.privilege.GetBuiltinPrivilegesAction;
 import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
@@ -113,7 +115,7 @@ private static Map<String, RoleDescriptor> initializeReservedRoles() {
                 .put(KibanaUser.ROLE_NAME, new RoleDescriptor(KibanaUser.ROLE_NAME,
                         new String[] {
                             "monitor", "manage_index_templates", MonitoringBulkAction.NAME, "manage_saml", "manage_token", "manage_oidc",
-                            GetBuiltinPrivilegesAction.NAME, "delegate_pki"
+                            GetBuiltinPrivilegesAction.NAME, "delegate_pki", GetLifecycleAction.NAME,  PutLifecycleAction.NAME
                         },
                         new RoleDescriptor.IndicesPrivileges[] {
                                 RoleDescriptor.IndicesPrivileges.builder()
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
index b2d32e871e15b..f90f6b7b17009 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
@@ -50,6 +50,11 @@
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.transport.TransportRequest;
 import org.elasticsearch.xpack.core.action.XPackInfoAction;
+import org.elasticsearch.xpack.core.ilm.action.GetLifecycleAction;
+import org.elasticsearch.xpack.core.ilm.action.DeleteLifecycleAction;
+import org.elasticsearch.xpack.core.ilm.action.PutLifecycleAction;
+import org.elasticsearch.xpack.core.ilm.action.StartILMAction;
+import org.elasticsearch.xpack.core.ilm.action.StopILMAction;
 import org.elasticsearch.xpack.core.ml.MlMetaIndex;
 import org.elasticsearch.xpack.core.ml.action.CloseJobAction;
 import org.elasticsearch.xpack.core.ml.action.DeleteCalendarAction;
@@ -300,6 +305,13 @@ public void testKibanaSystemRole() {
         assertThat(kibanaRole.cluster().check(ClusterUpdateSettingsAction.NAME, request, authentication), is(false));
         assertThat(kibanaRole.cluster().check(MonitoringBulkAction.NAME, request, authentication), is(true));
 
+        // ILM
+        assertThat(kibanaRole.cluster().check(GetLifecycleAction.NAME, request, authentication), is(true));
+        assertThat(kibanaRole.cluster().check(PutLifecycleAction.NAME, request, authentication), is(true));
+        assertThat(kibanaRole.cluster().check(DeleteLifecycleAction.NAME, request, authentication), is(false));
+        assertThat(kibanaRole.cluster().check(StartILMAction.NAME, request, authentication), is(false));
+        assertThat(kibanaRole.cluster().check(StopILMAction.NAME, request, authentication), is(false));
+
         // SAML and token
         assertThat(kibanaRole.cluster().check(SamlPrepareAuthenticationAction.NAME, request, authentication), is(true));
         assertThat(kibanaRole.cluster().check(SamlAuthenticateAction.NAME, request, authentication), is(true));

From 51b11a0a93072da6c635ad56fe0c35fe765cda40 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Fri, 10 Jan 2020 14:51:25 -0800
Subject: [PATCH 510/686] Improve build scan tags and values for Jenkins matrix
 jobs (#50881)

---
 gradle/build-scan.gradle | 29 ++++++++++++++++++++---------
 1 file changed, 20 insertions(+), 9 deletions(-)

diff --git a/gradle/build-scan.gradle b/gradle/build-scan.gradle
index 9bfc26130b95f..9e726adb046b6 100644
--- a/gradle/build-scan.gradle
+++ b/gradle/build-scan.gradle
@@ -3,8 +3,7 @@ import org.gradle.initialization.BuildRequestMetaData
 
 import java.util.concurrent.TimeUnit
 
-
-long startTime = project.gradle.services.get(BuildRequestMetaData.class).getStartTime()
+long startTime = project.gradle.services.get(BuildRequestMetaData).getStartTime()
 
 buildScan {
   URL jenkinsUrl = System.getenv('JENKINS_URL') ? new URL(System.getenv('JENKINS_URL')) : null
@@ -14,18 +13,14 @@ buildScan {
   String nodeName = System.getenv('NODE_NAME')
 
   tag OS.current().name()
-  if (jobName) {
-    value 'Job name', jobName
-  }
-  if (buildNumber) {
-    value 'Job number', buildNumber
-  }
 
+  // Automatically publish scans from Elasticsearch CI
   if (jenkinsUrl?.host?.endsWith('elastic.co')) {
     publishAlways()
     buildScan.server = 'https://gradle-enterprise.elastic.co'
   }
 
+  // Link to Jenkins worker logs and system metrics
   if (nodeName) {
     link 'System logs', "https://infra-stats.elastic.co/app/infra#/logs?" +
       "&logFilter=(expression:'host.name:${nodeName}',kind:kuery)"
@@ -39,10 +34,26 @@ buildScan {
 
   // Jenkins-specific build scan metadata
   if (jenkinsUrl) {
+    // Parse job name in the case of matrix builds
+    // Matrix job names come in the form of "base-job-name/matrix_param1=value1,matrix_param2=value2"
+    def splitJobName = jobName.split('/')
+    if (splitJobName.length == 2) {
+      tag splitJobName[0]
+      tag splitJobName[1]
+      value 'Job Name', splitJobName[0]
+      def matrixParams = splitJobName[1].split(',')
+      matrixParams.collect { it.split('=') }.each { param ->
+        value "MATRIX_${param[0].toUpperCase()}", param[1]
+      }
+    } else {
+      tag jobName
+      value 'Job Name', jobName
+    }
+
     tag 'CI'
-    tag jobName
     link 'Jenkins Build', buildUrl
     link 'GCP Upload', "https://console.cloud.google.com/storage/elasticsearch-ci-artifacts/jobs/${jobName}/build/${buildNumber}.tar.bz2"
+    value 'Job Number', buildNumber
 
     System.getenv().getOrDefault('NODE_LABELS', '').split(' ').each {
       value 'Jenkins Worker Label', it

From 0ff99b06932814b12174cfd427c9971a29cb3f66 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Fri, 10 Jan 2020 15:05:52 -0800
Subject: [PATCH 511/686] Delete experimental JJBB job

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 ...tic+elasticsearch+{branch}+docker-test-ramdisk.yml | 11 -----------
 1 file changed, 11 deletions(-)
 delete mode 100644 .ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml

diff --git a/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml b/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
deleted file mode 100644
index d920109bdbd90..0000000000000
--- a/.ci/jobs.t/elastic+elasticsearch+{branch}+docker-test-ramdisk.yml
+++ /dev/null
@@ -1,11 +0,0 @@
-- job:
-    name: elastic+elasticsearch+%BRANCH%+docker-test-ramdisk
-    workspace: /dev/shm/elastic+elasticsearch+%BRANCH%+docker-test
-    display-name: "elastic / elasticsearch # %BRANCH% - docker test ramdisk (experimental)"
-    description: "Experimental test job to shake out issues with Docker in CI\n"
-    node: "(debian-10 || sles-12 || debian-8 || sles-15) && immutable"
-    triggers: []
-    builders:
-      - shell: |
-          #!/usr/local/bin/runbld --redirect-stderr --last-good-commit elastic+elasticsearch+%BRANCH%+git+push
-          .ci/build.sh -Dbwc.checkout.align=true -p test/fixtures composeUp

From 842a208f23b4e23636b5a6c9a939f6d8ac0d19e7 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Sat, 11 Jan 2020 16:02:56 -0500
Subject: [PATCH 512/686] [ML][Inference] PUT API (#50852)

This adds the `PUT` API for creating trained models that support our format.

This includes

* HLRC change for the API
* API creation
* Validations of model format and call
---
 .../client/MLRequestConverters.java           |  11 +
 .../client/MachineLearningClient.java         |  44 ++++
 .../client/ml/PutTrainedModelRequest.java     |  66 ++++++
 .../client/ml/PutTrainedModelResponse.java    |  63 ++++++
 .../InferenceToXContentCompressor.java        |  81 ++++++++
 .../inference/SimpleBoundedInputStream.java   |  68 +++++++
 .../ml/inference/TrainedModelConfig.java      |  19 +-
 .../ml/inference/TrainedModelInput.java       |   5 +
 .../client/MLRequestConvertersTests.java      |  19 ++
 .../client/MachineLearningIT.java             | 118 +++++------
 .../MlClientDocumentationIT.java              | 145 ++++++++-----
 .../ml/PutTrainedModelActionRequestTests.java |  52 +++++
 .../PutTrainedModelActionResponseTests.java   |  52 +++++
 .../InferenceToXContentCompressorTests.java   |  70 +++++++
 .../ml/inference/TrainedModelConfigTests.java |  35 ++--
 .../trainedmodel/ensemble/EnsembleTests.java  |  14 +-
 .../trainedmodel/tree/TreeTests.java          |   2 +-
 .../high-level/ml/put-trained-model.asciidoc  |  53 +++++
 .../high-level/supported-apis.asciidoc        |   2 +
 .../core/ml/action/PutTrainedModelAction.java | 137 +++++++++++++
 .../core/ml/inference/TrainedModelConfig.java | 124 +++++++++---
 .../ml/inference/TrainedModelDefinition.java  |   6 +
 .../xpack/core/ml/job/messages/Messages.java  |   4 +
 .../PutTrainedModelActionRequestTests.java    |  45 +++++
 .../PutTrainedModelActionResponseTests.java   |  45 +++++
 .../ml/inference/TrainedModelConfigTests.java |  40 ++--
 .../ml/qa/ml-with-security/build.gradle       |   1 -
 .../ml/integration/InferenceIngestIT.java     |  81 ++++----
 .../xpack/ml/integration/TrainedModelIT.java  | 129 ++++++------
 .../xpack/ml/MachineLearning.java             |   7 +-
 .../TransportPutTrainedModelAction.java       | 190 ++++++++++++++++++
 .../persistence/TrainedModelProvider.java     |   2 +
 .../inference/RestPutTrainedModelAction.java  |  42 ++++
 .../MachineLearningLicensingTests.java        | 106 +++-------
 .../integration/TrainedModelProviderIT.java   |   1 -
 .../api/ml.put_trained_model.json             |  28 +++
 .../rest-api-spec/test/ml/inference_crud.yml  | 143 +++++++++----
 37 files changed, 1638 insertions(+), 412 deletions(-)
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/PutTrainedModelRequest.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/PutTrainedModelResponse.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/InferenceToXContentCompressor.java
 create mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/SimpleBoundedInputStream.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PutTrainedModelActionRequestTests.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PutTrainedModelActionResponseTests.java
 create mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/InferenceToXContentCompressorTests.java
 create mode 100644 docs/java-rest/high-level/ml/put-trained-model.asciidoc
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelAction.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelActionRequestTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelActionResponseTests.java
 create mode 100644 x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutTrainedModelAction.java
 create mode 100644 x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/rest/inference/RestPutTrainedModelAction.java
 create mode 100644 x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_trained_model.json

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/MLRequestConverters.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/MLRequestConverters.java
index 4967d8091c961..2e077f547e34f 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/MLRequestConverters.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/MLRequestConverters.java
@@ -73,6 +73,7 @@
 import org.elasticsearch.client.ml.PutDatafeedRequest;
 import org.elasticsearch.client.ml.PutFilterRequest;
 import org.elasticsearch.client.ml.PutJobRequest;
+import org.elasticsearch.client.ml.PutTrainedModelRequest;
 import org.elasticsearch.client.ml.RevertModelSnapshotRequest;
 import org.elasticsearch.client.ml.SetUpgradeModeRequest;
 import org.elasticsearch.client.ml.StartDataFrameAnalyticsRequest;
@@ -792,6 +793,16 @@ static Request deleteTrainedModel(DeleteTrainedModelRequest deleteRequest) {
         return new Request(HttpDelete.METHOD_NAME, endpoint);
     }
 
+    static Request putTrainedModel(PutTrainedModelRequest putTrainedModelRequest) throws IOException {
+        String endpoint = new EndpointBuilder()
+            .addPathPartAsIs("_ml", "inference")
+            .addPathPart(putTrainedModelRequest.getTrainedModelConfig().getModelId())
+            .build();
+        Request request = new Request(HttpPut.METHOD_NAME, endpoint);
+        request.setEntity(createEntity(putTrainedModelRequest, REQUEST_BODY_CONTENT_TYPE));
+        return request;
+    }
+
     static Request putFilter(PutFilterRequest putFilterRequest) throws IOException {
         String endpoint = new EndpointBuilder()
             .addPathPartAsIs("_ml")
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/MachineLearningClient.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/MachineLearningClient.java
index 0a71b8ddb0172..bdb2f22f3b3fa 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/MachineLearningClient.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/MachineLearningClient.java
@@ -100,6 +100,8 @@
 import org.elasticsearch.client.ml.PutFilterResponse;
 import org.elasticsearch.client.ml.PutJobRequest;
 import org.elasticsearch.client.ml.PutJobResponse;
+import org.elasticsearch.client.ml.PutTrainedModelRequest;
+import org.elasticsearch.client.ml.PutTrainedModelResponse;
 import org.elasticsearch.client.ml.RevertModelSnapshotRequest;
 import org.elasticsearch.client.ml.RevertModelSnapshotResponse;
 import org.elasticsearch.client.ml.SetUpgradeModeRequest;
@@ -2340,6 +2342,48 @@ public Cancellable getTrainedModelsAsync(GetTrainedModelsRequest request,
             Collections.emptySet());
     }
 
+    /**
+     * Put trained model config
+     * <p>
+     * For additional info
+     * see <a href="TODO">
+     *     PUT Trained Model Config documentation</a>
+     *
+     * @param request The {@link PutTrainedModelRequest}
+     * @param options Additional request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
+     * @return {@link PutTrainedModelResponse} response object
+     */
+    public PutTrainedModelResponse putTrainedModel(PutTrainedModelRequest request, RequestOptions options) throws IOException {
+        return restHighLevelClient.performRequestAndParseEntity(request,
+            MLRequestConverters::putTrainedModel,
+            options,
+            PutTrainedModelResponse::fromXContent,
+            Collections.emptySet());
+    }
+
+    /**
+     * Put trained model config asynchronously and notifies listener upon completion
+     * <p>
+     * For additional info
+     * see <a href="TODO">
+     *     PUT Trained Model Config documentation</a>
+     *
+     * @param request The {@link PutTrainedModelRequest}
+     * @param options Additional request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
+     * @param listener Listener to be notified upon request completion
+     * @return cancellable that may be used to cancel the request
+     */
+    public Cancellable putTrainedModelAsync(PutTrainedModelRequest request,
+                                            RequestOptions options,
+                                            ActionListener<PutTrainedModelResponse> listener) {
+        return restHighLevelClient.performRequestAsyncAndParseEntity(request,
+            MLRequestConverters::putTrainedModel,
+            options,
+            PutTrainedModelResponse::fromXContent,
+            listener,
+            Collections.emptySet());
+    }
+
     /**
      * Gets trained model stats
      * <p>
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/PutTrainedModelRequest.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/PutTrainedModelRequest.java
new file mode 100644
index 0000000000000..780ec31771baa
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/PutTrainedModelRequest.java
@@ -0,0 +1,66 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml;
+
+import org.elasticsearch.client.Validatable;
+import org.elasticsearch.client.ml.inference.TrainedModelConfig;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+
+import java.io.IOException;
+import java.util.Objects;
+
+
+public class PutTrainedModelRequest implements Validatable, ToXContentObject {
+
+    private final TrainedModelConfig config;
+
+    public PutTrainedModelRequest(TrainedModelConfig config) {
+        this.config = config;
+    }
+
+    public TrainedModelConfig getTrainedModelConfig() {
+        return config;
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, ToXContent.Params params) throws IOException {
+        return config.toXContent(builder, params);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        PutTrainedModelRequest request = (PutTrainedModelRequest) o;
+        return Objects.equals(config, request.config);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(config);
+    }
+
+    @Override
+    public final String toString() {
+        return Strings.toString(config);
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/PutTrainedModelResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/PutTrainedModelResponse.java
new file mode 100644
index 0000000000000..3bc81f1812940
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/PutTrainedModelResponse.java
@@ -0,0 +1,63 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml;
+
+import org.elasticsearch.client.ml.inference.TrainedModelConfig;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.Objects;
+
+
+public class PutTrainedModelResponse implements ToXContentObject {
+
+    private final TrainedModelConfig trainedModelConfig;
+
+    public static PutTrainedModelResponse fromXContent(XContentParser parser) throws IOException {
+        return new PutTrainedModelResponse(TrainedModelConfig.PARSER.parse(parser, null).build());
+    }
+
+    public PutTrainedModelResponse(TrainedModelConfig trainedModelConfig) {
+        this.trainedModelConfig = trainedModelConfig;
+    }
+
+    public TrainedModelConfig getResponse() {
+        return trainedModelConfig;
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        return trainedModelConfig.toXContent(builder, params);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        PutTrainedModelResponse response = (PutTrainedModelResponse) o;
+        return Objects.equals(trainedModelConfig, response.trainedModelConfig);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(trainedModelConfig);
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/InferenceToXContentCompressor.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/InferenceToXContentCompressor.java
new file mode 100644
index 0000000000000..9bec4c4eb5d52
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/InferenceToXContentCompressor.java
@@ -0,0 +1,81 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.client.ml.inference;
+
+import org.elasticsearch.common.CheckedFunction;
+import org.elasticsearch.common.bytes.BytesArray;
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.io.Streams;
+import org.elasticsearch.common.io.stream.BytesStreamOutput;
+import org.elasticsearch.common.xcontent.DeprecationHandler;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentType;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.nio.charset.StandardCharsets;
+import java.util.Base64;
+import java.util.zip.GZIPInputStream;
+import java.util.zip.GZIPOutputStream;
+
+/**
+ * Collection of helper methods. Similar to CompressedXContent, but this utilizes GZIP.
+ */
+public final class InferenceToXContentCompressor {
+    private static final int BUFFER_SIZE = 4096;
+    private static final long MAX_INFLATED_BYTES = 1_000_000_000; // 1 gb maximum
+
+    private InferenceToXContentCompressor() {}
+
+    public static <T extends ToXContentObject> String deflate(T objectToCompress) throws IOException {
+        BytesReference reference = XContentHelper.toXContent(objectToCompress, XContentType.JSON, false);
+        return deflate(reference);
+    }
+
+    public static <T> T inflate(String compressedString,
+                         CheckedFunction<XContentParser, T, IOException> parserFunction,
+                         NamedXContentRegistry xContentRegistry) throws IOException {
+        try(XContentParser parser = XContentHelper.createParser(xContentRegistry,
+            DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
+            inflate(compressedString, MAX_INFLATED_BYTES),
+            XContentType.JSON)) {
+            return parserFunction.apply(parser);
+        }
+    }
+
+    static BytesReference inflate(String compressedString, long streamSize) throws IOException {
+        byte[] compressedBytes = Base64.getDecoder().decode(compressedString.getBytes(StandardCharsets.UTF_8));
+        InputStream gzipStream = new GZIPInputStream(new BytesArray(compressedBytes).streamInput(), BUFFER_SIZE);
+        InputStream inflateStream = new SimpleBoundedInputStream(gzipStream, streamSize);
+        return Streams.readFully(inflateStream);
+    }
+
+    private static String deflate(BytesReference reference) throws IOException {
+        BytesStreamOutput out = new BytesStreamOutput();
+        try (OutputStream compressedOutput = new GZIPOutputStream(out, BUFFER_SIZE)) {
+            reference.writeTo(compressedOutput);
+        }
+        return new String(Base64.getEncoder().encode(BytesReference.toBytes(out.bytes())), StandardCharsets.UTF_8);
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/SimpleBoundedInputStream.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/SimpleBoundedInputStream.java
new file mode 100644
index 0000000000000..683e23dc9d7cf
--- /dev/null
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/SimpleBoundedInputStream.java
@@ -0,0 +1,68 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.inference;
+
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.util.Objects;
+
+/**
+ * This is a pared down bounded input stream.
+ * Only read is specifically enforced.
+ */
+final class SimpleBoundedInputStream extends InputStream {
+
+    private final InputStream in;
+    private final long maxBytes;
+    private long numBytes;
+
+    SimpleBoundedInputStream(InputStream inputStream, long maxBytes) {
+        this.in = Objects.requireNonNull(inputStream, "inputStream");
+        if (maxBytes < 0) {
+            throw new IllegalArgumentException("[maxBytes] must be greater than or equal to 0");
+        }
+        this.maxBytes = maxBytes;
+    }
+
+
+    /**
+     * A simple wrapper around the injected input stream that restricts the total number of bytes able to be read.
+     * @return The byte read. -1 on internal stream completion or when maxBytes is exceeded.
+     * @throws IOException on failure
+     */
+    @Override
+    public int read() throws IOException {
+        // We have reached the maximum, signal stream completion.
+        if (numBytes >= maxBytes) {
+            return -1;
+        }
+        numBytes++;
+        return in.read();
+    }
+
+    /**
+     * Delegates `close` to the wrapped InputStream
+     * @throws IOException on failure
+     */
+    @Override
+    public void close() throws IOException {
+        in.close();
+    }
+}
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/TrainedModelConfig.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/TrainedModelConfig.java
index 23eb01fb3b153..9d2b323cf4880 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/TrainedModelConfig.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/TrainedModelConfig.java
@@ -30,6 +30,7 @@
 
 import java.io.IOException;
 import java.time.Instant;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
@@ -111,7 +112,7 @@ public static TrainedModelConfig fromXContent(XContentParser parser) throws IOEx
         this.modelId = modelId;
         this.createdBy = createdBy;
         this.version = version;
-        this.createTime = Instant.ofEpochMilli(createTime.toEpochMilli());
+        this.createTime = createTime == null ? null : Instant.ofEpochMilli(createTime.toEpochMilli());
         this.definition = definition;
         this.compressedDefinition = compressedDefinition;
         this.description = description;
@@ -293,12 +294,12 @@ public Builder setModelId(String modelId) {
             return this;
         }
 
-        public Builder setCreatedBy(String createdBy) {
+        private Builder setCreatedBy(String createdBy) {
             this.createdBy = createdBy;
             return this;
         }
 
-        public Builder setVersion(Version version) {
+        private Builder setVersion(Version version) {
             this.version = version;
             return this;
         }
@@ -312,7 +313,7 @@ public Builder setDescription(String description) {
             return this;
         }
 
-        public Builder setCreateTime(Instant createTime) {
+        private Builder setCreateTime(Instant createTime) {
             this.createTime = createTime;
             return this;
         }
@@ -322,6 +323,10 @@ public Builder setTags(List<String> tags) {
             return this;
         }
 
+        public Builder setTags(String... tags) {
+            return setTags(Arrays.asList(tags));
+        }
+
         public Builder setMetadata(Map<String, Object> metadata) {
             this.metadata = metadata;
             return this;
@@ -347,17 +352,17 @@ public Builder setInput(TrainedModelInput input) {
             return this;
         }
 
-        public Builder setEstimatedHeapMemory(Long estimatedHeapMemory) {
+        private Builder setEstimatedHeapMemory(Long estimatedHeapMemory) {
             this.estimatedHeapMemory = estimatedHeapMemory;
             return this;
         }
 
-        public Builder setEstimatedOperations(Long estimatedOperations) {
+        private Builder setEstimatedOperations(Long estimatedOperations) {
             this.estimatedOperations = estimatedOperations;
             return this;
         }
 
-        public Builder setLicenseLevel(String licenseLevel) {
+        private Builder setLicenseLevel(String licenseLevel) {
             this.licenseLevel = licenseLevel;
             return this;
         }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/TrainedModelInput.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/TrainedModelInput.java
index 10f849cac481a..9b19323023d81 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/TrainedModelInput.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/TrainedModelInput.java
@@ -25,6 +25,7 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 
 import java.io.IOException;
+import java.util.Arrays;
 import java.util.List;
 import java.util.Objects;
 
@@ -48,6 +49,10 @@ public TrainedModelInput(List<String> fieldNames) {
         this.fieldNames = fieldNames;
     }
 
+    public TrainedModelInput(String... fieldNames) {
+        this(Arrays.asList(fieldNames));
+    }
+
     public static TrainedModelInput fromXContent(XContentParser parser) throws IOException {
         return PARSER.parse(parser, null);
     }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MLRequestConvertersTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MLRequestConvertersTests.java
index 475dda254448f..c137fbc464d56 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MLRequestConvertersTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MLRequestConvertersTests.java
@@ -71,6 +71,7 @@
 import org.elasticsearch.client.ml.PutDatafeedRequest;
 import org.elasticsearch.client.ml.PutFilterRequest;
 import org.elasticsearch.client.ml.PutJobRequest;
+import org.elasticsearch.client.ml.PutTrainedModelRequest;
 import org.elasticsearch.client.ml.RevertModelSnapshotRequest;
 import org.elasticsearch.client.ml.SetUpgradeModeRequest;
 import org.elasticsearch.client.ml.StartDataFrameAnalyticsRequest;
@@ -91,6 +92,9 @@
 import org.elasticsearch.client.ml.dataframe.MlDataFrameAnalysisNamedXContentProvider;
 import org.elasticsearch.client.ml.dataframe.evaluation.MlEvaluationNamedXContentProvider;
 import org.elasticsearch.client.ml.filestructurefinder.FileStructure;
+import org.elasticsearch.client.ml.inference.MlInferenceNamedXContentProvider;
+import org.elasticsearch.client.ml.inference.TrainedModelConfig;
+import org.elasticsearch.client.ml.inference.TrainedModelConfigTests;
 import org.elasticsearch.client.ml.job.config.AnalysisConfig;
 import org.elasticsearch.client.ml.job.config.Detector;
 import org.elasticsearch.client.ml.job.config.Job;
@@ -874,6 +878,20 @@ public void testDeleteTrainedModel() {
         assertNull(request.getEntity());
     }
 
+    public void testPutTrainedModel() throws IOException {
+        TrainedModelConfig trainedModelConfig = TrainedModelConfigTests.createTestTrainedModelConfig();
+        PutTrainedModelRequest putTrainedModelRequest = new PutTrainedModelRequest(trainedModelConfig);
+
+        Request request = MLRequestConverters.putTrainedModel(putTrainedModelRequest);
+
+        assertEquals(HttpPut.METHOD_NAME, request.getMethod());
+        assertThat(request.getEndpoint(), equalTo("/_ml/inference/" + trainedModelConfig.getModelId()));
+        try (XContentParser parser = createParser(JsonXContent.jsonXContent, request.getEntity().getContent())) {
+            TrainedModelConfig parsedTrainedModelConfig = TrainedModelConfig.PARSER.apply(parser, null).build();
+            assertThat(parsedTrainedModelConfig, equalTo(trainedModelConfig));
+        }
+    }
+
     public void testPutFilter() throws IOException {
         MlFilter filter = MlFilterTests.createRandomBuilder("foo").build();
         PutFilterRequest putFilterRequest = new PutFilterRequest(filter);
@@ -1046,6 +1064,7 @@ protected NamedXContentRegistry xContentRegistry() {
         namedXContent.addAll(new SearchModule(Settings.EMPTY, Collections.emptyList()).getNamedXContents());
         namedXContent.addAll(new MlDataFrameAnalysisNamedXContentProvider().getNamedXContentParsers());
         namedXContent.addAll(new MlEvaluationNamedXContentProvider().getNamedXContentParsers());
+        namedXContent.addAll(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
         return new NamedXContentRegistry(namedXContent);
     }
 
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index 547521a089cc6..0664d49f76841 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -101,6 +101,8 @@
 import org.elasticsearch.client.ml.PutFilterResponse;
 import org.elasticsearch.client.ml.PutJobRequest;
 import org.elasticsearch.client.ml.PutJobResponse;
+import org.elasticsearch.client.ml.PutTrainedModelRequest;
+import org.elasticsearch.client.ml.PutTrainedModelResponse;
 import org.elasticsearch.client.ml.RevertModelSnapshotRequest;
 import org.elasticsearch.client.ml.RevertModelSnapshotResponse;
 import org.elasticsearch.client.ml.SetUpgradeModeRequest;
@@ -146,9 +148,12 @@
 import org.elasticsearch.client.ml.dataframe.explain.FieldSelection;
 import org.elasticsearch.client.ml.dataframe.explain.MemoryEstimation;
 import org.elasticsearch.client.ml.filestructurefinder.FileStructure;
+import org.elasticsearch.client.ml.inference.InferenceToXContentCompressor;
+import org.elasticsearch.client.ml.inference.MlInferenceNamedXContentProvider;
 import org.elasticsearch.client.ml.inference.TrainedModelConfig;
 import org.elasticsearch.client.ml.inference.TrainedModelDefinition;
 import org.elasticsearch.client.ml.inference.TrainedModelDefinitionTests;
+import org.elasticsearch.client.ml.inference.TrainedModelInput;
 import org.elasticsearch.client.ml.inference.TrainedModelStats;
 import org.elasticsearch.client.ml.inference.trainedmodel.TargetType;
 import org.elasticsearch.client.ml.inference.trainedmodel.langident.LangIdentNeuralNetwork;
@@ -162,14 +167,12 @@
 import org.elasticsearch.client.ml.job.process.ModelSnapshot;
 import org.elasticsearch.client.ml.job.stats.JobStats;
 import org.elasticsearch.common.bytes.BytesArray;
-import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.MatchAllQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -178,11 +181,9 @@
 import org.junit.After;
 
 import java.io.IOException;
-import java.io.OutputStream;
 import java.nio.charset.StandardCharsets;
 import java.util.ArrayList;
 import java.util.Arrays;
-import java.util.Base64;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
@@ -190,7 +191,6 @@
 import java.util.Map;
 import java.util.concurrent.TimeUnit;
 import java.util.stream.Collectors;
-import java.util.zip.GZIPOutputStream;
 
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.anyOf;
@@ -2192,6 +2192,50 @@ public void testGetTrainedModels() throws Exception {
         }
     }
 
+    public void testPutTrainedModel() throws Exception {
+        String modelId = "test-put-trained-model";
+        String modelIdCompressed = "test-put-trained-model-compressed-definition";
+
+        MachineLearningClient machineLearningClient = highLevelClient().machineLearning();
+
+        TrainedModelDefinition definition = TrainedModelDefinitionTests.createRandomBuilder(TargetType.REGRESSION).build();
+        TrainedModelConfig trainedModelConfig = TrainedModelConfig.builder()
+            .setDefinition(definition)
+            .setModelId(modelId)
+            .setInput(new TrainedModelInput(Arrays.asList("col1", "col2", "col3", "col4")))
+            .setDescription("test model")
+            .build();
+        PutTrainedModelResponse putTrainedModelResponse = execute(new PutTrainedModelRequest(trainedModelConfig),
+            machineLearningClient::putTrainedModel,
+            machineLearningClient::putTrainedModelAsync);
+        TrainedModelConfig createdModel = putTrainedModelResponse.getResponse();
+        assertThat(createdModel.getModelId(), equalTo(modelId));
+
+        definition = TrainedModelDefinitionTests.createRandomBuilder(TargetType.REGRESSION).build();
+        trainedModelConfig = TrainedModelConfig.builder()
+            .setCompressedDefinition(InferenceToXContentCompressor.deflate(definition))
+            .setModelId(modelIdCompressed)
+            .setInput(new TrainedModelInput(Arrays.asList("col1", "col2", "col3", "col4")))
+            .setDescription("test model")
+            .build();
+        putTrainedModelResponse = execute(new PutTrainedModelRequest(trainedModelConfig),
+            machineLearningClient::putTrainedModel,
+            machineLearningClient::putTrainedModelAsync);
+        createdModel = putTrainedModelResponse.getResponse();
+        assertThat(createdModel.getModelId(), equalTo(modelIdCompressed));
+
+        GetTrainedModelsResponse getTrainedModelsResponse = execute(
+            new GetTrainedModelsRequest(modelIdCompressed).setDecompressDefinition(true).setIncludeDefinition(true),
+            machineLearningClient::getTrainedModels,
+            machineLearningClient::getTrainedModelsAsync);
+
+        assertThat(getTrainedModelsResponse.getCount(), equalTo(1L));
+        assertThat(getTrainedModelsResponse.getTrainedModels(), hasSize(1));
+        assertThat(getTrainedModelsResponse.getTrainedModels().get(0).getCompressedDefinition(), is(nullValue()));
+        assertThat(getTrainedModelsResponse.getTrainedModels().get(0).getDefinition(), is(not(nullValue())));
+        assertThat(getTrainedModelsResponse.getTrainedModels().get(0).getModelId(), equalTo(modelIdCompressed));
+    }
+
     public void testGetTrainedModelsStats() throws Exception {
         MachineLearningClient machineLearningClient = highLevelClient().machineLearning();
         String modelIdPrefix = "a-get-trained-model-stats-";
@@ -2474,56 +2518,13 @@ private void openJob(Job job) throws IOException {
 
     private void putTrainedModel(String modelId) throws IOException {
         TrainedModelDefinition definition = TrainedModelDefinitionTests.createRandomBuilder(TargetType.REGRESSION).build();
-        highLevelClient().index(
-            new IndexRequest(".ml-inference-000001")
-                .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-                .source(modelConfigString(modelId), XContentType.JSON)
-                .id(modelId),
-            RequestOptions.DEFAULT);
-
-        highLevelClient().index(
-            new IndexRequest(".ml-inference-000001")
-                .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-                .source(modelDocString(compressDefinition(definition), modelId), XContentType.JSON)
-                .id("trained_model_definition_doc-" + modelId + "-0"),
-            RequestOptions.DEFAULT);
-    }
-
-    private String compressDefinition(TrainedModelDefinition definition) throws IOException {
-        BytesReference reference = XContentHelper.toXContent(definition, XContentType.JSON, false);
-        BytesStreamOutput out = new BytesStreamOutput();
-        try (OutputStream compressedOutput = new GZIPOutputStream(out, 4096)) {
-            reference.writeTo(compressedOutput);
-        }
-        return new String(Base64.getEncoder().encode(BytesReference.toBytes(out.bytes())), StandardCharsets.UTF_8);
-    }
-
-    private static String modelConfigString(String modelId) {
-        return "{\n" +
-            "  \"doc_type\": \"trained_model_config\",\n" +
-            "  \"model_id\": \"" + modelId + "\",\n" +
-            "  \"input\":{\"field_names\":[\"col1\",\"col2\",\"col3\",\"col4\"]}," +
-            "  \"description\": \"test model\",\n" +
-            "  \"version\": \"7.6.0\",\n" +
-            "  \"license_level\": \"platinum\",\n" +
-            "  \"created_by\": \"ml_test\",\n" +
-            "  \"estimated_heap_memory_usage_bytes\": 0," +
-            "  \"estimated_operations\": 0," +
-            "  \"created_time\": 0\n" +
-            "}";
-    }
-
-    private static String modelDocString(String compressedDefinition, String modelId) {
-        return "" +
-            "{" +
-            "\"model_id\": \"" + modelId + "\",\n" +
-            "\"doc_num\": 0,\n" +
-            "\"doc_type\": \"trained_model_definition_doc\",\n" +
-            "  \"compression_version\": " + 1 + ",\n" +
-            "  \"total_definition_length\": " + compressedDefinition.length() + ",\n" +
-            "  \"definition_length\": " + compressedDefinition.length() + ",\n" +
-            "\"definition\": \"" + compressedDefinition + "\"\n" +
-            "}";
+        TrainedModelConfig trainedModelConfig = TrainedModelConfig.builder()
+            .setDefinition(definition)
+            .setModelId(modelId)
+            .setInput(new TrainedModelInput(Arrays.asList("col1", "col2", "col3", "col4")))
+            .setDescription("test model")
+            .build();
+        highLevelClient().machineLearning().putTrainedModel(new PutTrainedModelRequest(trainedModelConfig), RequestOptions.DEFAULT);
     }
 
     private void waitForJobToClose(String jobId) throws Exception {
@@ -2768,4 +2769,9 @@ public void testEnableUpgradeMode() throws Exception {
         mlInfoResponse = machineLearningClient.getMlInfo(new MlInfoRequest(), RequestOptions.DEFAULT);
         assertThat(mlInfoResponse.getInfo().get("upgrade_mode"), equalTo(false));
     }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
index 37ae59e9b992a..0db9dbf222f49 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
@@ -114,6 +114,8 @@
 import org.elasticsearch.client.ml.PutFilterResponse;
 import org.elasticsearch.client.ml.PutJobRequest;
 import org.elasticsearch.client.ml.PutJobResponse;
+import org.elasticsearch.client.ml.PutTrainedModelRequest;
+import org.elasticsearch.client.ml.PutTrainedModelResponse;
 import org.elasticsearch.client.ml.RevertModelSnapshotRequest;
 import org.elasticsearch.client.ml.RevertModelSnapshotResponse;
 import org.elasticsearch.client.ml.SetUpgradeModeRequest;
@@ -162,10 +164,14 @@
 import org.elasticsearch.client.ml.dataframe.explain.FieldSelection;
 import org.elasticsearch.client.ml.dataframe.explain.MemoryEstimation;
 import org.elasticsearch.client.ml.filestructurefinder.FileStructure;
+import org.elasticsearch.client.ml.inference.InferenceToXContentCompressor;
+import org.elasticsearch.client.ml.inference.MlInferenceNamedXContentProvider;
 import org.elasticsearch.client.ml.inference.TrainedModelConfig;
 import org.elasticsearch.client.ml.inference.TrainedModelDefinition;
 import org.elasticsearch.client.ml.inference.TrainedModelDefinitionTests;
+import org.elasticsearch.client.ml.inference.TrainedModelInput;
 import org.elasticsearch.client.ml.inference.TrainedModelStats;
+import org.elasticsearch.client.ml.inference.trainedmodel.TargetType;
 import org.elasticsearch.client.ml.job.config.AnalysisConfig;
 import org.elasticsearch.client.ml.job.config.AnalysisLimits;
 import org.elasticsearch.client.ml.job.config.DataDescription;
@@ -186,12 +192,11 @@
 import org.elasticsearch.client.ml.job.results.OverallBucket;
 import org.elasticsearch.client.ml.job.stats.JobStats;
 import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.MatchAllQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -202,12 +207,10 @@
 import org.junit.After;
 
 import java.io.IOException;
-import java.io.OutputStream;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.Arrays;
-import java.util.Base64;
 import java.util.Collections;
 import java.util.Date;
 import java.util.HashMap;
@@ -216,7 +219,6 @@
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
 import java.util.stream.Collectors;
-import java.util.zip.GZIPOutputStream;
 
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.closeTo;
@@ -3625,6 +3627,79 @@ public void onFailure(Exception e) {
         }
     }
 
+    public void testPutTrainedModel() throws Exception {
+        TrainedModelDefinition definition = TrainedModelDefinitionTests.createRandomBuilder(TargetType.REGRESSION).build();
+        // tag::put-trained-model-config
+        TrainedModelConfig trainedModelConfig = TrainedModelConfig.builder()
+            .setDefinition(definition) // <1>
+            .setCompressedDefinition(InferenceToXContentCompressor.deflate(definition)) // <2>
+            .setModelId("my-new-trained-model") // <3>
+            .setInput(new TrainedModelInput("col1", "col2", "col3", "col4")) // <4>
+            .setDescription("test model") // <5>
+            .setMetadata(new HashMap<>()) // <6>
+            .setTags("my_regression_models") // <7>
+            .build();
+        // end::put-trained-model-config
+
+        trainedModelConfig = TrainedModelConfig.builder()
+            .setDefinition(definition)
+            .setModelId("my-new-trained-model")
+            .setInput(new TrainedModelInput("col1", "col2", "col3", "col4"))
+            .setDescription("test model")
+            .setMetadata(new HashMap<>())
+            .setTags("my_regression_models")
+            .build();
+
+        RestHighLevelClient client = highLevelClient();
+        {
+            // tag::put-trained-model-request
+            PutTrainedModelRequest request = new PutTrainedModelRequest(trainedModelConfig); // <1>
+            // end::put-trained-model-request
+
+            // tag::put-trained-model-execute
+            PutTrainedModelResponse response = client.machineLearning().putTrainedModel(request, RequestOptions.DEFAULT);
+            // end::put-trained-model-execute
+
+            // tag::put-trained-model-response
+            TrainedModelConfig model = response.getResponse();
+            // end::put-trained-model-response
+
+            assertThat(model.getModelId(), equalTo(trainedModelConfig.getModelId()));
+            highLevelClient().machineLearning()
+                .deleteTrainedModel(new DeleteTrainedModelRequest("my-new-trained-model"), RequestOptions.DEFAULT);
+        }
+        {
+            PutTrainedModelRequest request = new PutTrainedModelRequest(trainedModelConfig);
+            
+            // tag::put-trained-model-execute-listener
+            ActionListener<PutTrainedModelResponse> listener = new ActionListener<>() {
+                @Override
+                public void onResponse(PutTrainedModelResponse response) {
+                    // <1>
+                }
+
+                @Override
+                public void onFailure(Exception e) {
+                    // <2>
+                }
+            };
+            // end::put-trained-model-execute-listener
+
+            // Replace the empty listener by a blocking listener in test
+            CountDownLatch latch = new CountDownLatch(1);
+            listener = new LatchedActionListener<>(listener, latch);
+
+            // tag::put-trained-model-execute-async
+            client.machineLearning().putTrainedModelAsync(request, RequestOptions.DEFAULT, listener); // <1>
+            // end::put-trained-model-execute-async
+
+            assertTrue(latch.await(30L, TimeUnit.SECONDS));
+
+            highLevelClient().machineLearning()
+                .deleteTrainedModel(new DeleteTrainedModelRequest("my-new-trained-model"), RequestOptions.DEFAULT);
+        }
+    }
+
     public void testGetTrainedModelsStats() throws Exception {
         putTrainedModel("my-trained-model");
         RestHighLevelClient client = highLevelClient();
@@ -4088,57 +4163,19 @@ private DataFrameAnalyticsState getAnalyticsState(String configId) throws IOExce
     }
 
     private void putTrainedModel(String modelId) throws IOException {
-        TrainedModelDefinition definition = TrainedModelDefinitionTests.createRandomBuilder().build();
-        highLevelClient().index(
-            new IndexRequest(".ml-inference-000001")
-                .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-                .source(modelConfigString(modelId), XContentType.JSON)
-                .id(modelId),
-            RequestOptions.DEFAULT);
-
-        highLevelClient().index(
-            new IndexRequest(".ml-inference-000001")
-                .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-                .source(modelDocString(compressDefinition(definition), modelId), XContentType.JSON)
-                .id("trained_model_definition_doc-" + modelId + "-0"),
-            RequestOptions.DEFAULT);
-    }
-
-    private String compressDefinition(TrainedModelDefinition definition) throws IOException {
-        BytesReference reference = XContentHelper.toXContent(definition, XContentType.JSON, false);
-        BytesStreamOutput out = new BytesStreamOutput();
-        try (OutputStream compressedOutput = new GZIPOutputStream(out, 4096)) {
-            reference.writeTo(compressedOutput);
-        }
-        return new String(Base64.getEncoder().encode(BytesReference.toBytes(out.bytes())), StandardCharsets.UTF_8);
-    }
-
-    private static String modelConfigString(String modelId) {
-        return "{\n" +
-            "  \"doc_type\": \"trained_model_config\",\n" +
-            "  \"model_id\": \"" + modelId + "\",\n" +
-            "  \"input\":{\"field_names\":[\"col1\",\"col2\",\"col3\",\"col4\"]}," +
-            "  \"description\": \"test model for\",\n" +
-            "  \"version\": \"7.6.0\",\n" +
-            "  \"license_level\": \"platinum\",\n" +
-            "  \"created_by\": \"ml_test\",\n" +
-            "  \"estimated_heap_memory_usage_bytes\": 0," +
-            "  \"estimated_operations\": 0," +
-            "  \"created_time\": 0\n" +
-            "}";
+        TrainedModelDefinition definition = TrainedModelDefinitionTests.createRandomBuilder(TargetType.REGRESSION).build();
+        TrainedModelConfig trainedModelConfig = TrainedModelConfig.builder()
+            .setDefinition(definition)
+            .setModelId(modelId)
+            .setInput(new TrainedModelInput(Arrays.asList("col1", "col2", "col3", "col4")))
+            .setDescription("test model")
+            .build();
+        highLevelClient().machineLearning().putTrainedModel(new PutTrainedModelRequest(trainedModelConfig), RequestOptions.DEFAULT);
     }
 
-    private static String modelDocString(String compressedDefinition, String modelId) {
-        return "" +
-            "{" +
-            "\"model_id\": \"" + modelId + "\",\n" +
-            "\"doc_num\": 0,\n" +
-            "\"doc_type\": \"trained_model_definition_doc\",\n" +
-            "  \"compression_version\": " + 1 + ",\n" +
-            "  \"total_definition_length\": " + compressedDefinition.length() + ",\n" +
-            "  \"definition_length\": " + compressedDefinition.length() + ",\n" +
-            "\"definition\": \"" + compressedDefinition + "\"\n" +
-            "}";
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
     }
 
     private static final DataFrameAnalyticsConfig DF_ANALYTICS_CONFIG =
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PutTrainedModelActionRequestTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PutTrainedModelActionRequestTests.java
new file mode 100644
index 0000000000000..b3956c5c6afe0
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PutTrainedModelActionRequestTests.java
@@ -0,0 +1,52 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml;
+
+import org.elasticsearch.client.ml.inference.MlInferenceNamedXContentProvider;
+import org.elasticsearch.client.ml.inference.TrainedModelConfig;
+import org.elasticsearch.client.ml.inference.TrainedModelConfigTests;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+
+import java.io.IOException;
+
+public class PutTrainedModelActionRequestTests extends AbstractXContentTestCase<PutTrainedModelRequest> {
+
+    @Override
+    protected PutTrainedModelRequest createTestInstance() {
+        return new PutTrainedModelRequest(TrainedModelConfigTests.createTestTrainedModelConfig());
+    }
+
+    @Override
+    protected PutTrainedModelRequest doParseInstance(XContentParser parser) throws IOException {
+        return new PutTrainedModelRequest(TrainedModelConfig.PARSER.apply(parser, null).build());
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return false;
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
+
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PutTrainedModelActionResponseTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PutTrainedModelActionResponseTests.java
new file mode 100644
index 0000000000000..61e1638547b3f
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/PutTrainedModelActionResponseTests.java
@@ -0,0 +1,52 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml;
+
+import org.elasticsearch.client.ml.inference.MlInferenceNamedXContentProvider;
+import org.elasticsearch.client.ml.inference.TrainedModelConfig;
+import org.elasticsearch.client.ml.inference.TrainedModelConfigTests;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.test.AbstractXContentTestCase;
+
+import java.io.IOException;
+
+public class PutTrainedModelActionResponseTests extends AbstractXContentTestCase<PutTrainedModelResponse> {
+
+    @Override
+    protected PutTrainedModelResponse createTestInstance() {
+        return new PutTrainedModelResponse(TrainedModelConfigTests.createTestTrainedModelConfig());
+    }
+
+    @Override
+    protected PutTrainedModelResponse doParseInstance(XContentParser parser) throws IOException {
+        return new PutTrainedModelResponse(TrainedModelConfig.PARSER.apply(parser, null).build());
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return false;
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
+
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/InferenceToXContentCompressorTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/InferenceToXContentCompressorTests.java
new file mode 100644
index 0000000000000..11747638a2c15
--- /dev/null
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/InferenceToXContentCompressorTests.java
@@ -0,0 +1,70 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.client.ml.inference;
+
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.test.ESTestCase;
+
+import java.io.IOException;
+
+import static org.hamcrest.Matchers.equalTo;
+
+public class InferenceToXContentCompressorTests extends ESTestCase {
+
+    public void testInflateAndDeflate() throws IOException {
+        for(int i = 0; i < 10; i++) {
+            TrainedModelDefinition definition = TrainedModelDefinitionTests.createRandomBuilder().build();
+            String firstDeflate = InferenceToXContentCompressor.deflate(definition);
+            TrainedModelDefinition inflatedDefinition = InferenceToXContentCompressor.inflate(firstDeflate,
+                parser -> TrainedModelDefinition.fromXContent(parser).build(),
+                xContentRegistry());
+
+            // Did we inflate to the same object?
+            assertThat(inflatedDefinition, equalTo(definition));
+        }
+    }
+
+    public void testInflateTooLargeStream() throws IOException {
+        TrainedModelDefinition definition = TrainedModelDefinitionTests.createRandomBuilder().build();
+        String firstDeflate = InferenceToXContentCompressor.deflate(definition);
+        BytesReference inflatedBytes = InferenceToXContentCompressor.inflate(firstDeflate, 10L);
+        assertThat(inflatedBytes.length(), equalTo(10));
+        try(XContentParser parser = XContentHelper.createParser(xContentRegistry(),
+            LoggingDeprecationHandler.INSTANCE,
+            inflatedBytes,
+            XContentType.JSON)) {
+            expectThrows(IOException.class, () -> TrainedModelConfig.fromXContent(parser));
+        }
+    }
+
+    public void testInflateGarbage() {
+        expectThrows(IOException.class, () -> InferenceToXContentCompressor.inflate(randomAlphaOfLength(10), 100L));
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
+
+}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/TrainedModelConfigTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/TrainedModelConfigTests.java
index 95ebbad837d69..43ab2e5993fde 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/TrainedModelConfigTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/TrainedModelConfigTests.java
@@ -37,6 +37,24 @@
 
 public class TrainedModelConfigTests extends AbstractXContentTestCase<TrainedModelConfig> {
 
+    public static TrainedModelConfig createTestTrainedModelConfig() {
+        return new TrainedModelConfig(
+            randomAlphaOfLength(10),
+            randomAlphaOfLength(10),
+            Version.CURRENT,
+            randomBoolean() ? null : randomAlphaOfLength(100),
+            Instant.ofEpochMilli(randomNonNegativeLong()),
+            randomBoolean() ? null : TrainedModelDefinitionTests.createRandomBuilder().build(),
+            randomBoolean() ? null : randomAlphaOfLength(100),
+            randomBoolean() ? null :
+                Stream.generate(() -> randomAlphaOfLength(10)).limit(randomIntBetween(0, 5)).collect(Collectors.toList()),
+            randomBoolean() ? null : Collections.singletonMap(randomAlphaOfLength(10), randomAlphaOfLength(10)),
+            randomBoolean() ? null : TrainedModelInputTests.createRandomInput(),
+            randomBoolean() ? null : randomNonNegativeLong(),
+            randomBoolean() ? null : randomNonNegativeLong(),
+            randomBoolean() ? null : randomFrom("platinum", "basic"));
+    }
+
     @Override
     protected TrainedModelConfig doParseInstance(XContentParser parser) throws IOException {
         return TrainedModelConfig.fromXContent(parser);
@@ -54,22 +72,7 @@ protected Predicate<String> getRandomFieldsExcludeFilter() {
 
     @Override
     protected TrainedModelConfig createTestInstance() {
-        return new TrainedModelConfig(
-            randomAlphaOfLength(10),
-            randomAlphaOfLength(10),
-            Version.CURRENT,
-            randomBoolean() ? null : randomAlphaOfLength(100),
-            Instant.ofEpochMilli(randomNonNegativeLong()),
-            randomBoolean() ? null : TrainedModelDefinitionTests.createRandomBuilder().build(),
-            randomBoolean() ? null : randomAlphaOfLength(100),
-            randomBoolean() ? null :
-                Stream.generate(() -> randomAlphaOfLength(10)).limit(randomIntBetween(0, 5)).collect(Collectors.toList()),
-            randomBoolean() ? null : Collections.singletonMap(randomAlphaOfLength(10), randomAlphaOfLength(10)),
-            randomBoolean() ? null : TrainedModelInputTests.createRandomInput(),
-            randomBoolean() ? null : randomNonNegativeLong(),
-            randomBoolean() ? null : randomNonNegativeLong(),
-            randomBoolean() ? null : randomFrom("platinum", "basic"));
-
+        return createTestTrainedModelConfig();
     }
 
     @Override
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/EnsembleTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/EnsembleTests.java
index f2448cbf4c8bb..a26adf5f09c71 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/EnsembleTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/EnsembleTests.java
@@ -67,15 +67,17 @@ public static Ensemble createRandom(TargetType targetType) {
             .collect(Collectors.toList());
         int numberOfModels = randomIntBetween(1, 10);
         List<TrainedModel> models = Stream.generate(() -> TreeTests.buildRandomTree(featureNames, 6, targetType))
-            .limit(numberOfFeatures)
+            .limit(numberOfModels)
             .collect(Collectors.toList());
-        OutputAggregator outputAggregator = null;
-        if (randomBoolean()) {
-            List<Double> weights = Stream.generate(ESTestCase::randomDouble).limit(numberOfModels).collect(Collectors.toList());
-            outputAggregator = randomFrom(new WeightedMode(weights), new WeightedSum(weights), new LogisticRegression(weights));
+        List<Double> weights = Stream.generate(ESTestCase::randomDouble).limit(numberOfModels).collect(Collectors.toList());
+        List<OutputAggregator> possibleAggregators = new ArrayList<>(Arrays.asList(new WeightedMode(weights),
+            new LogisticRegression(weights)));
+        if (targetType.equals(TargetType.REGRESSION)) {
+            possibleAggregators.add(new WeightedSum(weights));
         }
+        OutputAggregator outputAggregator = randomFrom(possibleAggregators.toArray(new OutputAggregator[0]));
         List<String> categoryLabels = null;
-        if (randomBoolean()) {
+        if (randomBoolean() && targetType.equals(TargetType.CLASSIFICATION)) {
             categoryLabels = Arrays.asList(generateRandomStringArray(randomIntBetween(1, 10), randomIntBetween(1, 10), false, false));
         }
         return new Ensemble(featureNames,
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/tree/TreeTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/tree/TreeTests.java
index febd1b98c2765..57cb2ba664d77 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/tree/TreeTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/tree/TreeTests.java
@@ -84,7 +84,7 @@ public static Tree buildRandomTree(List<String> featureNames, int depth, TargetT
             childNodes = nextNodes;
         }
         List<String> categoryLabels = null;
-        if (randomBoolean()) {
+        if (randomBoolean() && targetType.equals(TargetType.CLASSIFICATION)) {
             categoryLabels = Arrays.asList(generateRandomStringArray(randomIntBetween(1, 10), randomIntBetween(1, 10), false, false));
         }
         return builder.setClassificationLabels(categoryLabels)
diff --git a/docs/java-rest/high-level/ml/put-trained-model.asciidoc b/docs/java-rest/high-level/ml/put-trained-model.asciidoc
new file mode 100644
index 0000000000000..dadc8dcf65a4f
--- /dev/null
+++ b/docs/java-rest/high-level/ml/put-trained-model.asciidoc
@@ -0,0 +1,53 @@
+--
+:api: put-trained-model
+:request: PutTrainedModelRequest
+:response: PutTrainedModelResponse
+--
+[role="xpack"]
+[id="{upid}-{api}"]
+=== Put Trained Model API
+
+Creates a new trained model for inference.
+The API accepts a +{request}+ object as a request and returns a +{response}+.
+
+[id="{upid}-{api}-request"]
+==== Put Trained Model request
+
+A +{request}+ requires the following argument:
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-request]
+--------------------------------------------------
+<1> The configuration of the {infer} Trained Model to create
+
+[id="{upid}-{api}-config"]
+==== Trained Model configuration
+
+The `TrainedModelConfig` object contains all the details about the trained model
+configuration and contains the following arguments:
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-config]
+--------------------------------------------------
+<1> The {infer} definition for the model
+<2> Optionally, if the {infer} definition is large, you may choose to compress it for transport.
+    Do not supply both the compressed and uncompressed definitions.
+<3> The unique model id
+<4> The input field names for the model definition
+<5> Optionally, a human-readable description
+<6> Optionally, an object map contain metadata about the model
+<7> Optionally, an array of tags to organize the model
+
+include::../execution.asciidoc[]
+
+[id="{upid}-{api}-response"]
+==== Response
+
+The returned +{response}+ contains the newly created trained model.
+
+["source","java",subs="attributes,callouts,macros"]
+--------------------------------------------------
+include-tagged::{doc-tests-file}[{api}-response]
+--------------------------------------------------
diff --git a/docs/java-rest/high-level/supported-apis.asciidoc b/docs/java-rest/high-level/supported-apis.asciidoc
index e0d228b5d1e4b..4b848819702b4 100644
--- a/docs/java-rest/high-level/supported-apis.asciidoc
+++ b/docs/java-rest/high-level/supported-apis.asciidoc
@@ -304,6 +304,7 @@ The Java High Level REST Client supports the following Machine Learning APIs:
 * <<{upid}-evaluate-data-frame>>
 * <<{upid}-explain-data-frame-analytics>>
 * <<{upid}-get-trained-models>>
+* <<{upid}-put-trained-model>>
 * <<{upid}-get-trained-models-stats>>
 * <<{upid}-delete-trained-model>>
 * <<{upid}-put-filter>>
@@ -359,6 +360,7 @@ include::ml/stop-data-frame-analytics.asciidoc[]
 include::ml/evaluate-data-frame.asciidoc[]
 include::ml/explain-data-frame-analytics.asciidoc[]
 include::ml/get-trained-models.asciidoc[]
+include::ml/put-trained-model.asciidoc[]
 include::ml/get-trained-models-stats.asciidoc[]
 include::ml/delete-trained-model.asciidoc[]
 include::ml/put-filter.asciidoc[]
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelAction.java
new file mode 100644
index 0000000000000..06fbb6401a082
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelAction.java
@@ -0,0 +1,137 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.action;
+
+import org.elasticsearch.action.ActionRequestValidationException;
+import org.elasticsearch.action.ActionResponse;
+import org.elasticsearch.action.ActionType;
+import org.elasticsearch.action.support.master.AcknowledgedRequest;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ToXContentObject;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
+import org.elasticsearch.xpack.core.ml.job.messages.Messages;
+
+import java.io.IOException;
+import java.util.Objects;
+
+
+public class PutTrainedModelAction extends ActionType<PutTrainedModelAction.Response> {
+
+    public static final PutTrainedModelAction INSTANCE = new PutTrainedModelAction();
+    public static final String NAME = "cluster:monitor/xpack/ml/inference/put";
+    private PutTrainedModelAction() {
+        super(NAME, Response::new);
+    }
+
+    public static class Request extends AcknowledgedRequest<Request> {
+
+        public static Request parseRequest(String modelId, XContentParser parser) {
+            TrainedModelConfig.Builder builder = TrainedModelConfig.STRICT_PARSER.apply(parser, null);
+
+            if (builder.getModelId() == null) {
+                builder.setModelId(modelId).build();
+            } else if (!Strings.isNullOrEmpty(modelId) && !modelId.equals(builder.getModelId())) {
+                // If we have model_id in both URI and body, they must be identical
+                throw new IllegalArgumentException(Messages.getMessage(Messages.INCONSISTENT_ID,
+                    TrainedModelConfig.MODEL_ID.getPreferredName(),
+                    builder.getModelId(),
+                    modelId));
+            }
+            // Validations are done against the builder so we can build the full config object.
+            // This allows us to not worry about serializing a builder class between nodes.
+            return new Request(builder.validate(true).build());
+        }
+
+        private final TrainedModelConfig config;
+
+        public Request(TrainedModelConfig config) {
+            this.config = config;
+        }
+
+        public Request(StreamInput in) throws IOException {
+            super(in);
+            this.config = new TrainedModelConfig(in);
+        }
+
+        public TrainedModelConfig getTrainedModelConfig() {
+            return config;
+        }
+
+        @Override
+        public ActionRequestValidationException validate() {
+            return null;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            super.writeTo(out);
+            config.writeTo(out);
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Request request = (Request) o;
+            return Objects.equals(config, request.config);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(config);
+        }
+
+        @Override
+        public final String toString() {
+            return Strings.toString(config);
+        }
+    }
+
+    public static class Response extends ActionResponse implements ToXContentObject {
+
+        private final TrainedModelConfig trainedModelConfig;
+
+        public Response(TrainedModelConfig trainedModelConfig) {
+            this.trainedModelConfig = trainedModelConfig;
+        }
+
+        public Response(StreamInput in) throws IOException {
+            super(in);
+            trainedModelConfig = new TrainedModelConfig(in);
+        }
+
+        public TrainedModelConfig getResponse() {
+            return trainedModelConfig;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            trainedModelConfig.writeTo(out);
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            return trainedModelConfig.toXContent(builder, params);
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Response response = (Response) o;
+            return Objects.equals(trainedModelConfig, response.trainedModelConfig);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(trainedModelConfig);
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
index be4d40efc8501..95589ac8b61fe 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfig.java
@@ -7,6 +7,7 @@
 
 import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
@@ -34,6 +35,9 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
+import java.util.stream.Collectors;
+
+import static org.elasticsearch.action.ValidateActions.addValidationError;
 
 
 public class TrainedModelConfig implements ToXContentObject, Writeable {
@@ -352,13 +356,31 @@ public static class Builder {
         private Long estimatedHeapMemory;
         private Long estimatedOperations;
         private LazyModelDefinition definition;
-        private String licenseLevel = License.OperationMode.PLATINUM.description();
+        private String licenseLevel;
+
+        public Builder() {}
+
+        public Builder(TrainedModelConfig config) {
+            this.modelId = config.getModelId();
+            this.createdBy = config.getCreatedBy();
+            this.version = config.getVersion();
+            this.createTime = config.getCreateTime();
+            this.definition = config.definition == null ? null : new LazyModelDefinition(config.definition);
+            this.description = config.getDescription();
+            this.tags = config.getTags();
+            this.metadata = config.getMetadata();
+            this.input = config.getInput();
+        }
 
         public Builder setModelId(String modelId) {
             this.modelId = modelId;
             return this;
         }
 
+        public String getModelId() {
+            return this.modelId;
+        }
+
         public Builder setCreatedBy(String createdBy) {
             this.createdBy = createdBy;
             return this;
@@ -466,51 +488,96 @@ public Builder setLicenseLevel(String licenseLevel) {
             return this;
         }
 
-        // TODO move to REST level instead of here in the builder
-        public void validate() {
-            // We require a definition to be available here even though it will be stored in a different doc
-            ExceptionsHelper.requireNonNull(definition, DEFINITION);
-            ExceptionsHelper.requireNonNull(modelId, MODEL_ID);
+        public Builder validate() {
+            return validate(false);
+        }
 
-            if (MlStrings.isValidId(modelId) == false) {
-                throw ExceptionsHelper.badRequestException(Messages.getMessage(Messages.INVALID_ID, MODEL_ID.getPreferredName(), modelId));
+        /**
+         * Runs validations against the builder.
+         * @return The current builder object if validations are successful
+         * @throws ActionRequestValidationException when there are validation failures.
+         */
+        public Builder validate(boolean forCreation) {
+            // We require a definition to be available here even though it will be stored in a different doc
+            ActionRequestValidationException validationException = null;
+            if (definition == null) {
+                validationException = addValidationError("[" + DEFINITION.getPreferredName() + "] must not be null.", validationException);
+            }
+            if (modelId == null) {
+                validationException = addValidationError("[" + MODEL_ID.getPreferredName() + "] must not be null.", validationException);
             }
 
-            if (MlStrings.hasValidLengthForId(modelId) == false) {
-                throw ExceptionsHelper.badRequestException(Messages.getMessage(Messages.ID_TOO_LONG,
-                    MODEL_ID.getPreferredName(),
+            if (modelId != null && MlStrings.isValidId(modelId) == false) {
+                validationException = addValidationError(Messages.getMessage(Messages.INVALID_ID,
+                    TrainedModelConfig.MODEL_ID.getPreferredName(),
+                    modelId),
+                    validationException);
+            }
+            if (modelId != null && MlStrings.hasValidLengthForId(modelId) == false) {
+                validationException = addValidationError(Messages.getMessage(Messages.ID_TOO_LONG,
+                    TrainedModelConfig.MODEL_ID.getPreferredName(),
                     modelId,
-                    MlStrings.ID_LENGTH_LIMIT));
+                    MlStrings.ID_LENGTH_LIMIT), validationException);
+            }
+            List<String> badTags = tags.stream()
+                .filter(tag -> (MlStrings.isValidId(tag) && MlStrings.hasValidLengthForId(tag)) == false)
+                .collect(Collectors.toList());
+            if (badTags.isEmpty() == false) {
+                validationException = addValidationError(Messages.getMessage(Messages.INFERENCE_INVALID_TAGS,
+                    badTags,
+                    MlStrings.ID_LENGTH_LIMIT),
+                    validationException);
+            }
+
+            for(String tag : tags) {
+                if (tag.equals(modelId)) {
+                    validationException = addValidationError("none of the tags must equal the model_id", validationException);
+                    break;
+                }
+            }
+            if (forCreation) {
+                validationException = checkIllegalSetting(version, VERSION.getPreferredName(), validationException);
+                validationException = checkIllegalSetting(createdBy, CREATED_BY.getPreferredName(), validationException);
+                validationException = checkIllegalSetting(createTime, CREATE_TIME.getPreferredName(), validationException);
+                validationException = checkIllegalSetting(estimatedHeapMemory,
+                    ESTIMATED_HEAP_MEMORY_USAGE_BYTES.getPreferredName(),
+                    validationException);
+                validationException = checkIllegalSetting(estimatedOperations,
+                    ESTIMATED_OPERATIONS.getPreferredName(),
+                    validationException);
+                validationException = checkIllegalSetting(licenseLevel, LICENSE_LEVEL.getPreferredName(), validationException);
             }
 
-            checkIllegalSetting(version, VERSION.getPreferredName());
-            checkIllegalSetting(createdBy, CREATED_BY.getPreferredName());
-            checkIllegalSetting(createTime, CREATE_TIME.getPreferredName());
-            checkIllegalSetting(estimatedHeapMemory, ESTIMATED_HEAP_MEMORY_USAGE_BYTES.getPreferredName());
-            checkIllegalSetting(estimatedOperations, ESTIMATED_OPERATIONS.getPreferredName());
-            checkIllegalSetting(licenseLevel, LICENSE_LEVEL.getPreferredName());
+            if (validationException != null) {
+                throw validationException;
+            }
+
+            return this;
         }
 
-        private static void checkIllegalSetting(Object value, String setting) {
+        private static ActionRequestValidationException checkIllegalSetting(Object value,
+                                                                            String setting,
+                                                                            ActionRequestValidationException validationException) {
             if (value != null) {
-                throw ExceptionsHelper.badRequestException("illegal to set [{}] at inference model creation", setting);
+                return addValidationError("illegal to set [" + setting + "] at inference model creation", validationException);
             }
+            return validationException;
         }
 
         public TrainedModelConfig build() {
             return new TrainedModelConfig(
                 modelId,
-                createdBy,
-                version,
+                createdBy == null ? "user" : createdBy,
+                version == null ? Version.CURRENT : version,
                 description,
                 createTime == null ? Instant.now() : createTime,
                 definition,
                 tags,
                 metadata,
                 input,
-                estimatedHeapMemory,
-                estimatedOperations,
-                licenseLevel);
+                estimatedHeapMemory == null ? 0 : estimatedHeapMemory,
+                estimatedOperations == null ? 0 : estimatedOperations,
+                licenseLevel == null ? License.OperationMode.PLATINUM.description() : licenseLevel);
         }
     }
 
@@ -531,6 +598,13 @@ public static LazyModelDefinition fromStreamInput(StreamInput input) throws IOEx
             return new LazyModelDefinition(input.readString(), null);
         }
 
+        private LazyModelDefinition(LazyModelDefinition definition) {
+            if (definition != null) {
+                this.compressedString = definition.compressedString;
+                this.parsedDefinition = definition.parsedDefinition;
+            }
+        }
+
         private LazyModelDefinition(String compressedString, TrainedModelDefinition trainedModelDefinition) {
             if (compressedString == null && trainedModelDefinition == null) {
                 throw new IllegalArgumentException("unexpected null model definition");
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelDefinition.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelDefinition.java
index e176d9a288568..cf7a8b7d224c5 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelDefinition.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelDefinition.java
@@ -179,6 +179,12 @@ public Builder() {
             this(true);
         }
 
+        public Builder(TrainedModelDefinition definition) {
+            this(true);
+            this.preProcessors = new ArrayList<>(definition.getPreProcessors());
+            this.trainedModel = definition.trainedModel;
+        }
+
         public Builder setPreProcessors(List<PreProcessor> preProcessors) {
             this.preProcessors = preProcessors;
             return this;
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
index 1b80d1963598e..ef0fcd4fdb172 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
@@ -95,6 +95,10 @@ public final class Messages {
     public static final String INFERENCE_TOO_MANY_DEFINITIONS_REQUESTED =
         "Getting model definition is not supported when getting more than one model";
     public static final String INFERENCE_WARNING_ALL_FIELDS_MISSING = "Model [{0}] could not be inferred as all fields were missing";
+    public static final String INFERENCE_INVALID_TAGS = "Invalid tags {0}; must only can contain lowercase alphanumeric (a-z and 0-9), " +
+        "hyphens or underscores, must start and end with alphanumeric, and must be less than {1} characters.";
+    public static final String INFERENCE_TAGS_AND_MODEL_IDS_UNIQUE = "The provided tags {0} must not match existing model_ids.";
+    public static final String INFERENCE_MODEL_ID_AND_TAGS_UNIQUE = "The provided model_id {0} must not match existing tags.";
 
     public static final String JOB_AUDIT_DATAFEED_DATA_SEEN_AGAIN = "Datafeed has started retrieving data again";
     public static final String JOB_AUDIT_CREATED = "Job created";
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelActionRequestTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelActionRequestTests.java
new file mode 100644
index 0000000000000..0c39469c9029e
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelActionRequestTests.java
@@ -0,0 +1,45 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.action;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction.Request;
+import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfigTests;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinitionTests;
+
+public class PutTrainedModelActionRequestTests extends AbstractWireSerializingTestCase<Request> {
+
+    @Override
+    protected Request createTestInstance() {
+        String modelId = randomAlphaOfLength(10);
+        return new Request(TrainedModelConfigTests.createTestInstance(modelId)
+            .setParsedDefinition(TrainedModelDefinitionTests.createRandomBuilder())
+            .build());
+    }
+
+    @Override
+    protected Writeable.Reader<Request> instanceReader() {
+        return (in) -> {
+            Request request = new Request(in);
+            request.getTrainedModelConfig().ensureParsedDefinition(xContentRegistry());
+            return request;
+        };
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(new MlInferenceNamedXContentProvider().getNamedWriteables());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelActionResponseTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelActionResponseTests.java
new file mode 100644
index 0000000000000..5813b13c8ad55
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelActionResponseTests.java
@@ -0,0 +1,45 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.core.ml.action;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction.Response;
+import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfigTests;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinitionTests;
+
+public class PutTrainedModelActionResponseTests extends AbstractWireSerializingTestCase<Response> {
+
+    @Override
+    protected Response createTestInstance() {
+        String modelId = randomAlphaOfLength(10);
+        return new Response(TrainedModelConfigTests.createTestInstance(modelId)
+            .setParsedDefinition(TrainedModelDefinitionTests.createRandomBuilder())
+            .build());
+    }
+
+    @Override
+    protected Writeable.Reader<Response> instanceReader() {
+        return (in) -> {
+            Response response = new Response(in);
+            response.getResponse().ensureParsedDefinition(xContentRegistry());
+            return response;
+        };
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(new MlInferenceNamedXContentProvider().getNamedWriteables());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfigTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfigTests.java
index 8b267e10ca429..67b67a45500f1 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfigTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/TrainedModelConfigTests.java
@@ -5,8 +5,8 @@
  */
 package org.elasticsearch.xpack.core.ml.inference;
 
-import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable;
@@ -56,14 +56,16 @@ public static TrainedModelConfig.Builder createTestInstance(String modelId) {
         return TrainedModelConfig.builder()
             .setInput(TrainedModelInputTests.createRandomInput())
             .setMetadata(randomBoolean() ? null : Collections.singletonMap(randomAlphaOfLength(10), randomAlphaOfLength(10)))
-            .setCreateTime(Instant.ofEpochMilli(randomNonNegativeLong()))
+            .setCreateTime(Instant.ofEpochMilli(randomLongBetween(Instant.MIN.getEpochSecond(), Instant.MAX.getEpochSecond())))
             .setVersion(Version.CURRENT)
             .setModelId(modelId)
             .setCreatedBy(randomAlphaOfLength(10))
             .setDescription(randomBoolean() ? null : randomAlphaOfLength(100))
             .setEstimatedHeapMemory(randomNonNegativeLong())
             .setEstimatedOperations(randomNonNegativeLong())
-            .setLicenseLevel(License.OperationMode.PLATINUM.description())
+            .setLicenseLevel(randomFrom(License.OperationMode.PLATINUM.description(),
+                License.OperationMode.GOLD.description(),
+                License.OperationMode.BASIC.description()))
             .setTags(tags);
     }
 
@@ -191,50 +193,52 @@ public void testParseWithBothDefinitionAndCompressedSupplied() throws IOExceptio
     }
 
     public void testValidateWithNullDefinition() {
-        IllegalArgumentException ex = expectThrows(IllegalArgumentException.class, () -> TrainedModelConfig.builder().validate());
-        assertThat(ex.getMessage(), equalTo("[definition] must not be null."));
+        ActionRequestValidationException ex = expectThrows(ActionRequestValidationException.class,
+            () -> TrainedModelConfig.builder().validate());
+        assertThat(ex.getMessage(), containsString("[definition] must not be null."));
     }
 
     public void testValidateWithInvalidID() {
         String modelId = "InvalidID-";
-        ElasticsearchException ex = expectThrows(ElasticsearchException.class,
+        ActionRequestValidationException ex = expectThrows(ActionRequestValidationException.class,
             () -> TrainedModelConfig.builder()
                 .setParsedDefinition(TrainedModelDefinitionTests.createRandomBuilder())
                 .setModelId(modelId).validate());
-        assertThat(ex.getMessage(), equalTo(Messages.getMessage(Messages.INVALID_ID, "model_id", modelId)));
+        assertThat(ex.getMessage(), containsString(Messages.getMessage(Messages.INVALID_ID, "model_id", modelId)));
     }
 
     public void testValidateWithLongID() {
         String modelId = IntStream.range(0, 100).mapToObj(x -> "a").collect(Collectors.joining());
-        ElasticsearchException ex = expectThrows(ElasticsearchException.class,
+        ActionRequestValidationException ex = expectThrows(ActionRequestValidationException.class,
             () -> TrainedModelConfig.builder()
                 .setParsedDefinition(TrainedModelDefinitionTests.createRandomBuilder())
                 .setModelId(modelId).validate());
-        assertThat(ex.getMessage(), equalTo(Messages.getMessage(Messages.ID_TOO_LONG, "model_id", modelId, MlStrings.ID_LENGTH_LIMIT)));
+        assertThat(ex.getMessage(),
+            containsString(Messages.getMessage(Messages.ID_TOO_LONG, "model_id", modelId, MlStrings.ID_LENGTH_LIMIT)));
     }
 
     public void testValidateWithIllegallyUserProvidedFields() {
         String modelId = "simplemodel";
-        ElasticsearchException ex = expectThrows(ElasticsearchException.class,
+        ActionRequestValidationException ex = expectThrows(ActionRequestValidationException.class,
             () -> TrainedModelConfig.builder()
                 .setParsedDefinition(TrainedModelDefinitionTests.createRandomBuilder())
                 .setCreateTime(Instant.now())
-                .setModelId(modelId).validate());
-        assertThat(ex.getMessage(), equalTo("illegal to set [create_time] at inference model creation"));
+                .setModelId(modelId).validate(true));
+        assertThat(ex.getMessage(), containsString("illegal to set [create_time] at inference model creation"));
 
-        ex = expectThrows(ElasticsearchException.class,
+        ex = expectThrows(ActionRequestValidationException.class,
             () -> TrainedModelConfig.builder()
                 .setParsedDefinition(TrainedModelDefinitionTests.createRandomBuilder())
                 .setVersion(Version.CURRENT)
-                .setModelId(modelId).validate());
-        assertThat(ex.getMessage(), equalTo("illegal to set [version] at inference model creation"));
+                .setModelId(modelId).validate(true));
+        assertThat(ex.getMessage(), containsString("illegal to set [version] at inference model creation"));
 
-        ex = expectThrows(ElasticsearchException.class,
+        ex = expectThrows(ActionRequestValidationException.class,
             () -> TrainedModelConfig.builder()
                 .setParsedDefinition(TrainedModelDefinitionTests.createRandomBuilder())
                 .setCreatedBy("ml_user")
-                .setModelId(modelId).validate());
-        assertThat(ex.getMessage(), equalTo("illegal to set [created_by] at inference model creation"));
+                .setModelId(modelId).validate(true));
+        assertThat(ex.getMessage(), containsString("illegal to set [created_by] at inference model creation"));
     }
 
     public void testSerializationWithLazyDefinition() throws IOException {
diff --git a/x-pack/plugin/ml/qa/ml-with-security/build.gradle b/x-pack/plugin/ml/qa/ml-with-security/build.gradle
index 8c9ba6df7f009..7e19a4d606d25 100644
--- a/x-pack/plugin/ml/qa/ml-with-security/build.gradle
+++ b/x-pack/plugin/ml/qa/ml-with-security/build.gradle
@@ -133,7 +133,6 @@ integTest.runner {
     'ml/get_datafeed_stats/Test get datafeed stats given missing datafeed_id',
     'ml/get_datafeeds/Test get datafeed given missing datafeed_id',
     'ml/inference_crud/Test delete given used trained model',
-    'ml/inference_crud/Test delete given unused trained model',
     'ml/inference_crud/Test delete with missing model',
     'ml/inference_crud/Test get given missing trained model',
     'ml/inference_crud/Test get given expression without matches and allow_no_match is false',
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
index 27e83e04b412b..216eac723115f 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
@@ -9,15 +9,19 @@
 import org.elasticsearch.action.ingest.SimulateDocumentBaseResult;
 import org.elasticsearch.action.ingest.SimulatePipelineResponse;
 import org.elasticsearch.action.search.SearchRequest;
-import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.common.bytes.BytesArray;
+import org.elasticsearch.common.xcontent.DeprecationHandler;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.query.QueryBuilders;
-import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
-import org.elasticsearch.xpack.core.ml.inference.persistence.InferenceIndexConstants;
-import org.elasticsearch.xpack.core.ml.inference.InferenceToXContentCompressor;
-import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelDefinitionDoc;
+import org.elasticsearch.xpack.core.ml.action.DeleteTrainedModelAction;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction;
+import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
+import org.junit.After;
 import org.junit.Before;
 
 import java.io.IOException;
@@ -34,26 +38,14 @@ public class InferenceIngestIT extends MlNativeAutodetectIntegTestCase {
 
     @Before
     public void createBothModels() throws Exception {
-        assertThat(client().prepareIndex(InferenceIndexConstants.LATEST_INDEX_NAME)
-            .setId("test_classification")
-            .setSource(CLASSIFICATION_CONFIG, XContentType.JSON)
-            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-            .get().status(), equalTo(RestStatus.CREATED));
-        assertThat(client().prepareIndex(InferenceIndexConstants.LATEST_INDEX_NAME)
-            .setId(TrainedModelDefinitionDoc.docId("test_classification", 0))
-            .setSource(buildClassificationModelDoc(), XContentType.JSON)
-            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-            .get().status(), equalTo(RestStatus.CREATED));
-        assertThat(client().prepareIndex(InferenceIndexConstants.LATEST_INDEX_NAME)
-            .setId("test_regression")
-            .setSource(REGRESSION_CONFIG, XContentType.JSON)
-            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-            .get().status(), equalTo(RestStatus.CREATED));
-        assertThat(client().prepareIndex(InferenceIndexConstants.LATEST_INDEX_NAME)
-            .setId(TrainedModelDefinitionDoc.docId("test_regression", 0))
-            .setSource(buildRegressionModelDoc(), XContentType.JSON)
-            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-            .get().status(), equalTo(RestStatus.CREATED));
+        client().execute(PutTrainedModelAction.INSTANCE, new PutTrainedModelAction.Request(buildClassificationModel())).actionGet();
+        client().execute(PutTrainedModelAction.INSTANCE, new PutTrainedModelAction.Request(buildRegressionModel())).actionGet();
+    }
+
+    @After
+    public void deleteBothModels() {
+        client().execute(DeleteTrainedModelAction.INSTANCE, new DeleteTrainedModelAction.Request("test_classification")).actionGet();
+        client().execute(DeleteTrainedModelAction.INSTANCE, new DeleteTrainedModelAction.Request("test_regression")).actionGet();
     }
 
     public void testPipelineCreationAndDeletion() throws Exception {
@@ -391,6 +383,7 @@ private Map<String, Object> generateSourceDoc() {
         "  \"input\":{\"field_names\":[\"col1\",\"col2\",\"col3\",\"col4\"]}," +
         "  \"description\": \"test model for regression\",\n" +
         "  \"version\": \"8.0.0\",\n" +
+        "  \"definition\": " + REGRESSION_DEFINITION + ","+
         "  \"license_level\": \"platinum\",\n" +
         "  \"created_by\": \"ml_test\",\n" +
         "  \"estimated_heap_memory_usage_bytes\": 0," +
@@ -518,28 +511,27 @@ private Map<String, Object> generateSourceDoc() {
         "  }\n" +
         "}";
 
-    private static String buildClassificationModelDoc() throws IOException {
-        String compressed =
-            InferenceToXContentCompressor.deflate(new BytesArray(CLASSIFICATION_DEFINITION.getBytes(StandardCharsets.UTF_8)));
-        return modelDocString(compressed, "test_classification");
+    private TrainedModelConfig buildClassificationModel() throws IOException {
+        try (XContentParser parser = XContentHelper.createParser(xContentRegistry(),
+            DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
+            new BytesArray(CLASSIFICATION_CONFIG),
+            XContentType.JSON)) {
+            return TrainedModelConfig.LENIENT_PARSER.apply(parser, null).build();
+        }
     }
 
-    private static String buildRegressionModelDoc() throws IOException {
-        String compressed = InferenceToXContentCompressor.deflate(new BytesArray(REGRESSION_DEFINITION.getBytes(StandardCharsets.UTF_8)));
-        return modelDocString(compressed, "test_regression");
+    private TrainedModelConfig buildRegressionModel() throws IOException {
+        try (XContentParser parser = XContentHelper.createParser(xContentRegistry(),
+            DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
+            new BytesArray(REGRESSION_CONFIG),
+            XContentType.JSON)) {
+            return TrainedModelConfig.LENIENT_PARSER.apply(parser, null).build();
+        }
     }
 
-    private static String modelDocString(String compressedDefinition, String modelId) {
-        return "" +
-            "{" +
-            "\"model_id\": \"" + modelId + "\",\n" +
-            "\"doc_num\": 0,\n" +
-            "\"doc_type\": \"trained_model_definition_doc\",\n" +
-            "  \"compression_version\": " + 1 + ",\n" +
-            "  \"total_definition_length\": " + compressedDefinition.length() + ",\n" +
-            "  \"definition_length\": " + compressedDefinition.length() + ",\n" +
-            "\"definition\": \"" + compressedDefinition + "\"\n" +
-            "}";
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
     }
 
     private static final String CLASSIFICATION_CONFIG = "" +
@@ -547,9 +539,10 @@ private static String modelDocString(String compressedDefinition, String modelId
         "  \"model_id\": \"test_classification\",\n" +
         "  \"input\":{\"field_names\":[\"col1\",\"col2\",\"col3\",\"col4\"]}," +
         "  \"description\": \"test model for classification\",\n" +
+        "  \"definition\": " + CLASSIFICATION_DEFINITION + ","+
         "  \"version\": \"8.0.0\",\n" +
         "  \"license_level\": \"platinum\",\n" +
-        "  \"created_by\": \"benwtrent\",\n" +
+        "  \"created_by\": \"es_test\",\n" +
         "  \"estimated_heap_memory_usage_bytes\": 0," +
         "  \"estimated_operations\": 0," +
         "  \"created_time\": 0\n" +
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
index 72c677d1aa40d..0aec6bc337412 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelIT.java
@@ -6,10 +6,18 @@
 package org.elasticsearch.xpack.ml.integration;
 
 import org.apache.http.util.EntityUtils;
-import org.elasticsearch.Version;
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.Response;
 import org.elasticsearch.client.ResponseException;
+import org.elasticsearch.client.ml.inference.TrainedModelConfig;
+import org.elasticsearch.client.ml.inference.TrainedModelDefinition;
+import org.elasticsearch.client.ml.inference.TrainedModelInput;
+import org.elasticsearch.client.ml.inference.trainedmodel.TargetType;
+import org.elasticsearch.client.ml.inference.trainedmodel.TrainedModel;
+import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.Ensemble;
+import org.elasticsearch.client.ml.inference.trainedmodel.ensemble.WeightedSum;
+import org.elasticsearch.client.ml.inference.trainedmodel.tree.Tree;
+import org.elasticsearch.client.ml.inference.trainedmodel.tree.TreeNode;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
@@ -18,26 +26,19 @@
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.license.License;
 import org.elasticsearch.test.SecuritySettingsSourceField;
 import org.elasticsearch.test.rest.ESRestTestCase;
-import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
-import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
-import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
 import org.elasticsearch.xpack.core.ml.inference.persistence.InferenceIndexConstants;
-import org.elasticsearch.xpack.core.ml.inference.InferenceToXContentCompressor;
 import org.elasticsearch.xpack.core.ml.integration.MlRestTestStateCleaner;
 import org.elasticsearch.xpack.core.ml.job.messages.Messages;
-import org.elasticsearch.xpack.core.ml.utils.ToXContentParams;
 import org.elasticsearch.xpack.ml.MachineLearning;
-import org.elasticsearch.xpack.ml.inference.loadingservice.LocalModelTests;
 import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelDefinitionDoc;
 import org.junit.After;
 
 import java.io.IOException;
-import java.time.Instant;
 import java.util.Arrays;
 import java.util.Collections;
+import java.util.List;
 
 import static org.elasticsearch.xpack.core.security.authc.support.UsernamePasswordToken.basicAuthHeaderValue;
 import static org.hamcrest.Matchers.containsString;
@@ -62,22 +63,8 @@ protected boolean preserveTemplatesUponCompletion() {
     public void testGetTrainedModels() throws IOException {
         String modelId = "a_test_regression_model";
         String modelId2 = "a_test_regression_model-2";
-        Request model1 = new Request("PUT",
-            InferenceIndexConstants.LATEST_INDEX_NAME + "/_doc/" + modelId);
-        model1.setJsonEntity(buildRegressionModel(modelId));
-        assertThat(client().performRequest(model1).getStatusLine().getStatusCode(), equalTo(201));
-
-        Request modelDefinition1 = new Request("PUT",
-            InferenceIndexConstants.LATEST_INDEX_NAME + "/_doc/" + TrainedModelDefinitionDoc.docId(modelId, 0));
-        modelDefinition1.setJsonEntity(buildRegressionModelDefinitionDoc(modelId));
-        assertThat(client().performRequest(modelDefinition1).getStatusLine().getStatusCode(), equalTo(201));
-
-        Request model2 = new Request("PUT",
-            InferenceIndexConstants.LATEST_INDEX_NAME + "/_doc/" + modelId2);
-        model2.setJsonEntity(buildRegressionModel(modelId2));
-        assertThat(client().performRequest(model2).getStatusLine().getStatusCode(), equalTo(201));
-
-        adminClient().performRequest(new Request("POST", InferenceIndexConstants.LATEST_INDEX_NAME + "/_refresh"));
+        putRegressionModel(modelId);
+        putRegressionModel(modelId2);
         Response getModel = client().performRequest(new Request("GET",
             MachineLearning.BASE_PATH + "inference/" + modelId));
 
@@ -164,17 +151,7 @@ public void testGetTrainedModels() throws IOException {
 
     public void testDeleteTrainedModels() throws IOException {
         String modelId = "test_delete_regression_model";
-        Request model1 = new Request("PUT",
-            InferenceIndexConstants.LATEST_INDEX_NAME + "/_doc/" + modelId);
-        model1.setJsonEntity(buildRegressionModel(modelId));
-        assertThat(client().performRequest(model1).getStatusLine().getStatusCode(), equalTo(201));
-
-        Request modelDefinition1 = new Request("PUT",
-            InferenceIndexConstants.LATEST_INDEX_NAME + "/_doc/" + TrainedModelDefinitionDoc.docId(modelId, 0));
-        modelDefinition1.setJsonEntity(buildRegressionModelDefinitionDoc(modelId));
-        assertThat(client().performRequest(modelDefinition1).getStatusLine().getStatusCode(), equalTo(201));
-
-        adminClient().performRequest(new Request("POST", InferenceIndexConstants.LATEST_INDEX_NAME + "/_refresh"));
+        putRegressionModel(modelId);
 
         Response delModel = client().performRequest(new Request("DELETE",
             MachineLearning.BASE_PATH + "inference/" + modelId));
@@ -208,42 +185,68 @@ public void testGetPrePackagedModels() throws IOException {
         assertThat(response, containsString("\"definition\""));
     }
 
-    private static String buildRegressionModel(String modelId) throws IOException {
+    private void putRegressionModel(String modelId) throws IOException {
         try(XContentBuilder builder = XContentFactory.jsonBuilder()) {
+            TrainedModelDefinition.Builder definition = new TrainedModelDefinition.Builder()
+                .setPreProcessors(Collections.emptyList())
+                .setTrainedModel(buildRegression());
             TrainedModelConfig.builder()
+                .setDefinition(definition)
                 .setModelId(modelId)
                 .setInput(new TrainedModelInput(Arrays.asList("col1", "col2", "col3")))
-                .setCreatedBy("ml_test")
-                .setVersion(Version.CURRENT)
-                .setCreateTime(Instant.now())
-                .setEstimatedOperations(0)
-                .setLicenseLevel(License.OperationMode.PLATINUM.description())
-                .setEstimatedHeapMemory(0)
-                .build()
-                .toXContent(builder, new ToXContent.MapParams(Collections.singletonMap(ToXContentParams.FOR_INTERNAL_STORAGE, "true")));
-            return XContentHelper.convertToJson(BytesReference.bytes(builder), false, XContentType.JSON);
+                .build().toXContent(builder, ToXContent.EMPTY_PARAMS);
+            Request model = new Request("PUT", "_ml/inference/" + modelId);
+            model.setJsonEntity(XContentHelper.convertToJson(BytesReference.bytes(builder), false, XContentType.JSON));
+            assertThat(client().performRequest(model).getStatusLine().getStatusCode(), equalTo(200));
         }
     }
 
-    private static String buildRegressionModelDefinitionDoc(String modelId) throws IOException {
-        try(XContentBuilder builder = XContentFactory.jsonBuilder()) {
-            TrainedModelDefinition definition = new TrainedModelDefinition.Builder()
-                .setPreProcessors(Collections.emptyList())
-                .setTrainedModel(LocalModelTests.buildRegression())
-                .build();
-            String compressedString = InferenceToXContentCompressor.deflate(definition);
-            TrainedModelDefinitionDoc doc = new TrainedModelDefinitionDoc.Builder().setDocNum(0)
-                .setCompressedString(compressedString)
-                .setTotalDefinitionLength(compressedString.length())
-                .setDefinitionLength(compressedString.length())
-                .setCompressionVersion(1)
-                .setModelId(modelId).build();
-            doc.toXContent(builder, new ToXContent.MapParams(Collections.singletonMap(ToXContentParams.FOR_INTERNAL_STORAGE, "true")));
-            return XContentHelper.convertToJson(BytesReference.bytes(builder), false, XContentType.JSON);
-        }
+    private static TrainedModel buildRegression() {
+        List<String> featureNames = Arrays.asList("field.foo", "field.bar", "animal_cat", "animal_dog");
+        Tree tree1 = Tree.builder()
+            .setFeatureNames(featureNames)
+            .setNodes(TreeNode.builder(0)
+                .setLeftChild(1)
+                .setRightChild(2)
+                .setSplitFeature(0)
+                .setThreshold(0.5),
+                TreeNode.builder(1).setLeafValue(0.3),
+                TreeNode.builder(2)
+                .setThreshold(0.0)
+                .setSplitFeature(3)
+                .setLeftChild(3)
+                .setRightChild(4),
+                TreeNode.builder(3).setLeafValue(0.1),
+                TreeNode.builder(4).setLeafValue(0.2))
+            .build();
+        Tree tree2 = Tree.builder()
+            .setFeatureNames(featureNames)
+            .setNodes(TreeNode.builder(0)
+                .setLeftChild(1)
+                .setRightChild(2)
+                .setSplitFeature(2)
+                .setThreshold(1.0),
+                TreeNode.builder(1).setLeafValue(1.5),
+                TreeNode.builder(2).setLeafValue(0.9))
+            .build();
+        Tree tree3 = Tree.builder()
+            .setFeatureNames(featureNames)
+            .setNodes(TreeNode.builder(0)
+                .setLeftChild(1)
+                .setRightChild(2)
+                .setSplitFeature(1)
+                .setThreshold(0.2),
+                TreeNode.builder(1).setLeafValue(1.5),
+                TreeNode.builder(2).setLeafValue(0.9))
+            .build();
+        return Ensemble.builder()
+            .setTargetType(TargetType.REGRESSION)
+            .setFeatureNames(featureNames)
+            .setTrainedModels(Arrays.asList(tree1, tree2, tree3))
+            .setOutputAggregator(new WeightedSum(Arrays.asList(0.5, 0.5, 0.5)))
+            .build();
     }
 
-
     @After
     public void clearMlState() throws Exception {
         new MlRestTestStateCleaner(logger, adminClient()).clearMlMetadata();
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
index 5216cf6a267fc..b933ea65caed7 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/MachineLearning.java
@@ -113,6 +113,7 @@
 import org.elasticsearch.xpack.core.ml.action.PutDatafeedAction;
 import org.elasticsearch.xpack.core.ml.action.PutFilterAction;
 import org.elasticsearch.xpack.core.ml.action.PutJobAction;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction;
 import org.elasticsearch.xpack.core.ml.action.RevertModelSnapshotAction;
 import org.elasticsearch.xpack.core.ml.action.SetUpgradeModeAction;
 import org.elasticsearch.xpack.core.ml.action.StartDataFrameAnalyticsAction;
@@ -184,6 +185,7 @@
 import org.elasticsearch.xpack.ml.action.TransportPutDatafeedAction;
 import org.elasticsearch.xpack.ml.action.TransportPutFilterAction;
 import org.elasticsearch.xpack.ml.action.TransportPutJobAction;
+import org.elasticsearch.xpack.ml.action.TransportPutTrainedModelAction;
 import org.elasticsearch.xpack.ml.action.TransportRevertModelSnapshotAction;
 import org.elasticsearch.xpack.ml.action.TransportSetUpgradeModeAction;
 import org.elasticsearch.xpack.ml.action.TransportStartDataFrameAnalyticsAction;
@@ -276,6 +278,7 @@
 import org.elasticsearch.xpack.ml.rest.inference.RestDeleteTrainedModelAction;
 import org.elasticsearch.xpack.ml.rest.inference.RestGetTrainedModelsAction;
 import org.elasticsearch.xpack.ml.rest.inference.RestGetTrainedModelsStatsAction;
+import org.elasticsearch.xpack.ml.rest.inference.RestPutTrainedModelAction;
 import org.elasticsearch.xpack.ml.rest.job.RestCloseJobAction;
 import org.elasticsearch.xpack.ml.rest.job.RestDeleteForecastAction;
 import org.elasticsearch.xpack.ml.rest.job.RestDeleteJobAction;
@@ -761,7 +764,8 @@ public List<RestHandler> getRestHandlers(Settings settings, RestController restC
             new RestExplainDataFrameAnalyticsAction(restController),
             new RestGetTrainedModelsAction(restController),
             new RestDeleteTrainedModelAction(restController),
-            new RestGetTrainedModelsStatsAction(restController)
+            new RestGetTrainedModelsStatsAction(restController),
+            new RestPutTrainedModelAction(restController)
         );
     }
 
@@ -837,6 +841,7 @@ public List<RestHandler> getRestHandlers(Settings settings, RestController restC
                 new ActionHandler<>(GetTrainedModelsAction.INSTANCE, TransportGetTrainedModelsAction.class),
                 new ActionHandler<>(DeleteTrainedModelAction.INSTANCE, TransportDeleteTrainedModelAction.class),
                 new ActionHandler<>(GetTrainedModelsStatsAction.INSTANCE, TransportGetTrainedModelsStatsAction.class),
+                new ActionHandler<>(PutTrainedModelAction.INSTANCE, TransportPutTrainedModelAction.class),
                 usageAction,
                 infoAction);
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutTrainedModelAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutTrainedModelAction.java
new file mode 100644
index 0000000000000..575b8ac00dfb5
--- /dev/null
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportPutTrainedModelAction.java
@@ -0,0 +1,190 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.action;
+
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.search.SearchRequest;
+import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.action.support.master.TransportMasterNodeAction;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.block.ClusterBlockException;
+import org.elasticsearch.cluster.block.ClusterBlockLevel;
+import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.inject.Inject;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.license.License;
+import org.elasticsearch.license.LicenseUtils;
+import org.elasticsearch.license.XPackLicenseState;
+import org.elasticsearch.search.builder.SearchSourceBuilder;
+import org.elasticsearch.tasks.Task;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.XPackField;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction.Request;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction.Response;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
+import org.elasticsearch.xpack.core.ml.inference.persistence.InferenceIndexConstants;
+import org.elasticsearch.xpack.core.ml.job.messages.Messages;
+import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelProvider;
+
+import java.io.IOException;
+import java.time.Instant;
+import java.util.List;
+
+import static org.elasticsearch.xpack.core.ClientHelper.ML_ORIGIN;
+import static org.elasticsearch.xpack.core.ClientHelper.executeAsyncWithOrigin;
+
+public class TransportPutTrainedModelAction extends TransportMasterNodeAction<Request, Response> {
+
+    private final TrainedModelProvider trainedModelProvider;
+    private final XPackLicenseState licenseState;
+    private final NamedXContentRegistry xContentRegistry;
+    private final Client client;
+
+    @Inject
+    public TransportPutTrainedModelAction(TransportService transportService, ClusterService clusterService,
+                                          ThreadPool threadPool, XPackLicenseState licenseState, ActionFilters actionFilters,
+                                          IndexNameExpressionResolver indexNameExpressionResolver, Client client,
+                                          TrainedModelProvider trainedModelProvider, NamedXContentRegistry xContentRegistry) {
+        super(PutTrainedModelAction.NAME, transportService, clusterService, threadPool, actionFilters, Request::new,
+            indexNameExpressionResolver);
+        this.licenseState = licenseState;
+        this.trainedModelProvider = trainedModelProvider;
+        this.xContentRegistry = xContentRegistry;
+        this.client = client;
+    }
+
+    @Override
+    protected String executor() {
+        return ThreadPool.Names.SAME;
+    }
+
+    @Override
+    protected Response read(StreamInput in) throws IOException {
+        return new Response(in);
+    }
+
+    @Override
+    protected void masterOperation(Task task,
+                                   PutTrainedModelAction.Request request,
+                                   ClusterState state,
+                                   ActionListener<Response> listener) {
+        try {
+            request.getTrainedModelConfig().ensureParsedDefinition(xContentRegistry);
+            request.getTrainedModelConfig().getModelDefinition().getTrainedModel().validate();
+        } catch (IOException ex) {
+            listener.onFailure(ExceptionsHelper.badRequestException("Failed to parse definition for [{}]",
+                ex,
+                request.getTrainedModelConfig().getModelId()));
+            return;
+        } catch (ElasticsearchException ex) {
+            listener.onFailure(ExceptionsHelper.badRequestException("Definition for [{}] has validation failures.",
+                ex,
+                request.getTrainedModelConfig().getModelId()));
+            return;
+        }
+
+        TrainedModelConfig trainedModelConfig = new TrainedModelConfig.Builder(request.getTrainedModelConfig())
+            .setVersion(Version.CURRENT)
+            .setCreateTime(Instant.now())
+            .setCreatedBy("api_user")
+            .setLicenseLevel(License.OperationMode.PLATINUM.description())
+            .setEstimatedHeapMemory(request.getTrainedModelConfig().getModelDefinition().ramBytesUsed())
+            .setEstimatedOperations(request.getTrainedModelConfig().getModelDefinition().getTrainedModel().estimatedNumOperations())
+            .build();
+
+        ActionListener<Void> tagsModelIdCheckListener = ActionListener.wrap(
+            r -> trainedModelProvider.storeTrainedModel(trainedModelConfig, ActionListener.wrap(
+                storedConfig -> listener.onResponse(new PutTrainedModelAction.Response(trainedModelConfig)),
+                listener::onFailure
+            )),
+            listener::onFailure
+        );
+
+        ActionListener<Void> modelIdTagCheckListener = ActionListener.wrap(
+            r -> checkTagsAgainstModelIds(request.getTrainedModelConfig().getTags(), tagsModelIdCheckListener),
+            listener::onFailure
+        );
+
+        checkModelIdAgainstTags(request.getTrainedModelConfig().getModelId(), modelIdTagCheckListener);
+    }
+
+    private void checkModelIdAgainstTags(String modelId, ActionListener<Void> listener) {
+        QueryBuilder builder = QueryBuilders.constantScoreQuery(
+            QueryBuilders.boolQuery()
+                .filter(QueryBuilders.termQuery(TrainedModelConfig.TAGS.getPreferredName(), modelId)));
+        SearchSourceBuilder sourceBuilder = new SearchSourceBuilder().query(builder).size(0).trackTotalHitsUpTo(1);
+        SearchRequest searchRequest = new SearchRequest(InferenceIndexConstants.INDEX_PATTERN).source(sourceBuilder);
+        executeAsyncWithOrigin(client.threadPool().getThreadContext(),
+            ML_ORIGIN,
+            searchRequest,
+            ActionListener.<SearchResponse>wrap(
+                response -> {
+                    if (response.getHits().getTotalHits().value > 0) {
+                        listener.onFailure(
+                            ExceptionsHelper.badRequestException(
+                                Messages.getMessage(Messages.INFERENCE_MODEL_ID_AND_TAGS_UNIQUE, modelId)));
+                        return;
+                    }
+                    listener.onResponse(null);
+                },
+                listener::onFailure
+            ),
+            client::search);
+    }
+
+    private void checkTagsAgainstModelIds(List<String> tags, ActionListener<Void> listener) {
+        if (tags.isEmpty()) {
+            listener.onResponse(null);
+            return;
+        }
+
+        QueryBuilder builder = QueryBuilders.constantScoreQuery(
+            QueryBuilders.boolQuery()
+                .filter(QueryBuilders.termsQuery(TrainedModelConfig.MODEL_ID.getPreferredName(), tags)));
+        SearchSourceBuilder sourceBuilder = new SearchSourceBuilder().query(builder).size(0).trackTotalHitsUpTo(1);
+        SearchRequest searchRequest = new SearchRequest(InferenceIndexConstants.INDEX_PATTERN).source(sourceBuilder);
+        executeAsyncWithOrigin(client.threadPool().getThreadContext(),
+            ML_ORIGIN,
+            searchRequest,
+            ActionListener.<SearchResponse>wrap(
+                response -> {
+                    if (response.getHits().getTotalHits().value > 0) {
+                        listener.onFailure(
+                            ExceptionsHelper.badRequestException(Messages.getMessage(Messages.INFERENCE_TAGS_AND_MODEL_IDS_UNIQUE, tags)));
+                        return;
+                    }
+                    listener.onResponse(null);
+                },
+                listener::onFailure
+            ),
+            client::search);
+    }
+
+    @Override
+    protected ClusterBlockException checkBlock(Request request, ClusterState state) {
+        return state.blocks().globalBlockedException(ClusterBlockLevel.METADATA_WRITE);
+    }
+
+    @Override
+    protected void doExecute(Task task, Request request, ActionListener<Response> listener) {
+        if (licenseState.isMachineLearningAllowed()) {
+            super.doExecute(task, request, listener);
+        } else {
+            listener.onFailure(LicenseUtils.newComplianceException(XPackField.MACHINE_LEARNING));
+        }
+    }
+}
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProvider.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProvider.java
index 993de87b07193..7ae8004f14a25 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProvider.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/persistence/TrainedModelProvider.java
@@ -174,10 +174,12 @@ private void storeTrainedModelAndDefinition(TrainedModelConfig trainedModelConfi
             r -> {
                 assert r.getItems().length == 2;
                 if (r.getItems()[0].isFailed()) {
+
                     logger.error(new ParameterizedMessage(
                             "[{}] failed to store trained model config for inference",
                             trainedModelConfig.getModelId()),
                         r.getItems()[0].getFailure().getCause());
+
                     wrappedListener.onFailure(r.getItems()[0].getFailure().getCause());
                     return;
                 }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/rest/inference/RestPutTrainedModelAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/rest/inference/RestPutTrainedModelAction.java
new file mode 100644
index 0000000000000..cb3f4e0eddee2
--- /dev/null
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/rest/inference/RestPutTrainedModelAction.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.xpack.ml.rest.inference;
+
+import org.elasticsearch.client.node.NodeClient;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.rest.BaseRestHandler;
+import org.elasticsearch.rest.RestController;
+import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.rest.action.RestToXContentListener;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
+import org.elasticsearch.xpack.ml.MachineLearning;
+
+import java.io.IOException;
+
+public class RestPutTrainedModelAction extends BaseRestHandler {
+
+    public RestPutTrainedModelAction(RestController controller) {
+        controller.registerHandler(RestRequest.Method.PUT,
+            MachineLearning.BASE_PATH + "inference/{" + TrainedModelConfig.MODEL_ID.getPreferredName() + "}",
+            this);
+    }
+
+    @Override
+    public String getName() {
+        return "xpack_ml_put_trained_model_action";
+    }
+
+    @Override
+    protected RestChannelConsumer prepareRequest(RestRequest restRequest, NodeClient client) throws IOException {
+        String id = restRequest.param(TrainedModelConfig.MODEL_ID.getPreferredName());
+        XContentParser parser = restRequest.contentParser();
+        PutTrainedModelAction.Request putRequest = PutTrainedModelAction.Request.parseRequest(id, parser);
+        putRequest.timeout(restRequest.paramAsTime("timeout", putRequest.timeout()));
+
+        return channel -> client.execute(PutTrainedModelAction.INSTANCE, putRequest, new RestToXContentListener<>(channel));
+    }
+}
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
index f819cff871637..a80e8ed709673 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/license/MachineLearningLicensingTests.java
@@ -13,7 +13,6 @@
 import org.elasticsearch.action.ingest.SimulatePipelineRequest;
 import org.elasticsearch.action.ingest.SimulatePipelineResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
-import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.common.bytes.BytesArray;
@@ -32,24 +31,28 @@
 import org.elasticsearch.xpack.core.ml.action.OpenJobAction;
 import org.elasticsearch.xpack.core.ml.action.PutDatafeedAction;
 import org.elasticsearch.xpack.core.ml.action.PutJobAction;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction;
 import org.elasticsearch.xpack.core.ml.action.StartDatafeedAction;
 import org.elasticsearch.xpack.core.ml.action.StopDatafeedAction;
 import org.elasticsearch.xpack.core.ml.datafeed.DatafeedState;
-import org.elasticsearch.xpack.core.ml.inference.persistence.InferenceIndexConstants;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
+import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
 import org.elasticsearch.xpack.core.ml.inference.trainedmodel.RegressionConfig;
-import org.elasticsearch.xpack.core.ml.inference.InferenceToXContentCompressor;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.TargetType;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.tree.Tree;
+import org.elasticsearch.xpack.core.ml.inference.trainedmodel.tree.TreeNode;
 import org.elasticsearch.xpack.core.ml.job.config.JobState;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
-import org.elasticsearch.xpack.ml.inference.persistence.TrainedModelDefinitionDoc;
 import org.elasticsearch.xpack.ml.support.BaseMlIntegTestCase;
 import org.junit.Before;
 
 import java.nio.charset.StandardCharsets;
+import java.util.Arrays;
 import java.util.Collections;
 
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.empty;
-import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasItem;
 import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.is;
@@ -481,12 +484,7 @@ public void testMachineLearningCreateInferenceProcessorRestricted() throws Excep
             "          \"target_field\": \"regression_value\",\n" +
             "          \"model_id\": \"modelprocessorlicensetest\",\n" +
             "          \"inference_config\": {\"regression\": {}},\n" +
-            "          \"field_mappings\": {\n" +
-            "            \"col1\": \"col1\",\n" +
-            "            \"col2\": \"col2\",\n" +
-            "            \"col3\": \"col3\",\n" +
-            "            \"col4\": \"col4\"\n" +
-            "          }\n" +
+            "          \"field_mappings\": {}\n" +
             "        }\n" +
             "      }]}\n";
         // Creating a pipeline should work
@@ -668,76 +666,22 @@ public void testMachineLearningInferModelRestricted() throws Exception {
         assertThat(listener.actionGet().getInferenceResults(), is(not(empty())));
     }
 
-    private void putInferenceModel(String modelId) throws Exception {
-        String config = "" +
-            "{\n" +
-            "  \"model_id\": \"" + modelId + "\",\n" +
-            "  \"input\":{\"field_names\":[\"col1\",\"col2\",\"col3\",\"col4\"]}," +
-            "  \"description\": \"test model for classification\",\n" +
-            "  \"version\": \"8.0.0\",\n" +
-            "  \"created_by\": \"benwtrent\",\n" +
-            "  \"license_level\": \"platinum\",\n" +
-            "  \"estimated_heap_memory_usage_bytes\": 0,\n" +
-            "  \"estimated_operations\": 0,\n" +
-            "  \"created_time\": 0\n" +
-            "}";
-        String definition = "" +
-            "{" +
-            "  \"trained_model\": {\n" +
-            "    \"tree\": {\n" +
-            "      \"feature_names\": [\n" +
-            "        \"col1_male\",\n" +
-            "        \"col1_female\",\n" +
-            "        \"col2_encoded\",\n" +
-            "        \"col3_encoded\",\n" +
-            "        \"col4\"\n" +
-            "      ],\n" +
-            "      \"tree_structure\": [\n" +
-            "        {\n" +
-            "          \"node_index\": 0,\n" +
-            "            \"split_feature\": 0,\n" +
-            "            \"split_gain\": 12.0,\n" +
-            "            \"threshold\": 10.0,\n" +
-            "            \"decision_type\": \"lte\",\n" +
-            "            \"default_left\": true,\n" +
-            "            \"left_child\": 1,\n" +
-            "            \"right_child\": 2\n" +
-            "         },\n" +
-            "         {\n" +
-            "           \"node_index\": 1,\n" +
-            "           \"leaf_value\": 1\n" +
-            "         },\n" +
-            "         {\n" +
-            "           \"node_index\": 2,\n" +
-            "           \"leaf_value\": 2\n" +
-            "         }\n" +
-            "      ],\n" +
-            "     \"target_type\": \"regression\"\n" +
-            "    }\n" +
-            "  }" +
-            "}";
-        String compressedDefinitionString =
-            InferenceToXContentCompressor.deflate(new BytesArray(definition.getBytes(StandardCharsets.UTF_8)));
-        String compressedDefinition = "" +
-            "{" +
-            "  \"model_id\": \"" + modelId + "\",\n" +
-            "  \"doc_type\": \"" + TrainedModelDefinitionDoc.NAME + "\",\n" +
-            "  \"doc_num\": " + 0 + ",\n" +
-            "  \"compression_version\": " + 1 + ",\n" +
-            "  \"total_definition_length\": " + compressedDefinitionString.length() + ",\n" +
-            "  \"definition_length\": " + compressedDefinitionString.length() + ",\n" +
-            "  \"definition\": \"" + compressedDefinitionString + "\"\n" +
-            "}";
-        assertThat(client().prepareIndex(InferenceIndexConstants.LATEST_INDEX_NAME)
-            .setId(modelId)
-            .setSource(config, XContentType.JSON)
-            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-            .get().status(), equalTo(RestStatus.CREATED));
-        assertThat(client().prepareIndex(InferenceIndexConstants.LATEST_INDEX_NAME)
-            .setId(TrainedModelDefinitionDoc.docId(modelId, 0))
-            .setSource(compressedDefinition, XContentType.JSON)
-            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-            .get().status(), equalTo(RestStatus.CREATED));
+    private void putInferenceModel(String modelId) {
+        TrainedModelConfig config = TrainedModelConfig.builder()
+            .setParsedDefinition(
+            new TrainedModelDefinition.Builder()
+            .setTrainedModel(
+            Tree.builder()
+                .setTargetType(TargetType.REGRESSION)
+                .setFeatureNames(Arrays.asList("feature1"))
+                .setNodes(TreeNode.builder(0).setLeafValue(1.0))
+                .build())
+            .setPreProcessors(Collections.emptyList()))
+            .setModelId(modelId)
+            .setDescription("test model for classification")
+            .setInput(new TrainedModelInput(Arrays.asList("feature1")))
+            .build();
+        client().execute(PutTrainedModelAction.INSTANCE, new PutTrainedModelAction.Request(config)).actionGet();
     }
 
     private static OperationMode randomInvalidLicenseType() {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelProviderIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelProviderIT.java
index bfd92beefddad..a687124066d5c 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelProviderIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/TrainedModelProviderIT.java
@@ -199,7 +199,6 @@ private static TrainedModelConfig.Builder buildTrainedModelConfigBuilder(String
         return TrainedModelConfig.builder()
             .setCreatedBy("ml_test")
             .setParsedDefinition(TrainedModelDefinitionTests.createRandomBuilder())
-
             .setDescription("trained model config for test")
             .setModelId(modelId)
             .setVersion(Version.CURRENT)
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_trained_model.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_trained_model.json
new file mode 100644
index 0000000000000..a58fa13540748
--- /dev/null
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_trained_model.json
@@ -0,0 +1,28 @@
+{
+  "ml.put_trained_model":{
+    "documentation":{
+      "url":"TODO"
+    },
+    "stability":"experimental",
+    "url":{
+      "paths":[
+        {
+          "path":"/_ml/inference/{model_id}",
+          "methods":[
+            "PUT"
+          ],
+          "parts":{
+            "model_id":{
+              "type":"string",
+              "description":"The ID of the trained models to store"
+            }
+          }
+        }
+      ]
+    },
+    "body": {
+      "description":"The trained model configuration",
+      "required":true
+    }
+  }
+}
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_crud.yml
index f72fd1120d81e..f5f9a56bab8d8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/inference_crud.yml
@@ -1,3 +1,74 @@
+setup:
+  - skip:
+      features: headers
+  - do:
+      headers:
+        Authorization: "Basic eF9wYWNrX3Jlc3RfdXNlcjp4LXBhY2stdGVzdC1wYXNzd29yZA==" # run as x_pack_rest_user, i.e. the test setup superuser
+      ml.put_trained_model:
+        model_id: a-regression-model-0
+        body: >
+          {
+            "description": "empty model for tests",
+            "input": {"field_names": ["field1", "field2"]},
+            "definition": {
+               "preprocessors": [],
+               "trained_model": {
+                  "tree": {
+                     "feature_names": ["field1", "field2"],
+                     "tree_structure": [
+                        {"node_index": 0, "leaf_value": 1}
+                     ],
+                     "target_type": "regression"
+                  }
+               }
+            }
+          }
+
+  - do:
+      headers:
+        Authorization: "Basic eF9wYWNrX3Jlc3RfdXNlcjp4LXBhY2stdGVzdC1wYXNzd29yZA==" # run as x_pack_rest_user, i.e. the test setup superuser
+      ml.put_trained_model:
+        model_id: a-regression-model-1
+        body: >
+          {
+            "description": "empty model for tests",
+            "input": {"field_names": ["field1", "field2"]},
+            "definition": {
+               "preprocessors": [],
+               "trained_model": {
+                  "tree": {
+                     "feature_names": ["field1", "field2"],
+                     "tree_structure": [
+                        {"node_index": 0, "leaf_value": 1}
+                     ],
+                     "target_type": "regression"
+                  }
+               }
+            }
+          }
+  - do:
+      headers:
+        Authorization: "Basic eF9wYWNrX3Jlc3RfdXNlcjp4LXBhY2stdGVzdC1wYXNzd29yZA==" # run as x_pack_rest_user, i.e. the test setup superuser
+      ml.put_trained_model:
+        model_id: a-classification-model
+        body: >
+          {
+            "description": "empty model for tests",
+            "input": {"field_names": ["field1", "field2"]},
+            "definition": {
+               "preprocessors": [],
+               "trained_model": {
+                  "tree": {
+                     "feature_names": ["field1", "field2"],
+                     "tree_structure": [
+                        {"node_index": 0, "leaf_value": 1}
+                     ],
+                     "target_type": "classification",
+                     "classification_labels": ["no", "yes"]
+                  }
+               }
+            }
+          }
 ---
 "Test get given missing trained model":
 
@@ -24,56 +95,52 @@
   - match: { count: 0 }
   - match: { trained_model_configs: [] }
 ---
-"Test delete given unused trained model":
+"Test get models":
+  - do:
+      ml.get_trained_models:
+        model_id: "*"
+  - match: { count: 4 }
+  - match: { trained_model_configs.0.model_id: "a-classification-model" }
+  - match: { trained_model_configs.1.model_id: "a-regression-model-0" }
+  - match: { trained_model_configs.2.model_id: "a-regression-model-1" }
 
   - do:
-      index:
-        id: trained_model_config-unused-regression-model-0
-        index: .ml-inference-000001
-        body: >
-          {
-            "model_id": "unused-regression-model",
-            "created_by": "ml_tests",
-            "version": "8.0.0",
-            "description": "empty model for tests",
-            "create_time": 0,
-            "model_version": 0,
-            "model_type": "local"
-          }
+      ml.get_trained_models:
+        model_id: "a-regression*"
+  - match: { count: 2 }
+  - match: { trained_model_configs.0.model_id: "a-regression-model-0" }
+  - match: { trained_model_configs.1.model_id: "a-regression-model-1" }
+
   - do:
-      indices.refresh: {}
+      ml.get_trained_models:
+        model_id: "*"
+        from: 0
+        size: 2
+  - match: { count: 4 }
+  - match: { trained_model_configs.0.model_id: "a-classification-model" }
+  - match: { trained_model_configs.1.model_id: "a-regression-model-0" }
 
+  - do:
+      ml.get_trained_models:
+        model_id: "*"
+        from: 1
+        size: 1
+  - match: { count: 4 }
+  - match: { trained_model_configs.0.model_id: "a-regression-model-0" }
+---
+"Test delete given unused trained model":
   - do:
       ml.delete_trained_model:
-        model_id: "unused-regression-model"
+        model_id: "a-classification-model"
   - match: { acknowledged: true }
-
 ---
 "Test delete with missing model":
   - do:
       catch: missing
       ml.delete_trained_model:
         model_id: "missing-trained-model"
-
 ---
 "Test delete given used trained model":
-  - do:
-      index:
-        id: trained_model_config-used-regression-model-0
-        index: .ml-inference-000001
-        body: >
-          {
-            "model_id": "used-regression-model",
-            "created_by": "ml_tests",
-            "version": "8.0.0",
-            "description": "empty model for tests",
-            "create_time": 0,
-            "model_version": 0,
-            "model_type": "local"
-          }
-  - do:
-      indices.refresh: {}
-
   - do:
       ingest.put_pipeline:
         id: "regression-model-pipeline"
@@ -82,7 +149,7 @@
             "processors": [
               {
                 "inference" : {
-                  "model_id" : "used-regression-model",
+                  "model_id" : "a-regression-model-0",
                   "inference_config": {"regression": {}},
                   "target_field": "regression_field",
                   "field_mappings": {}
@@ -95,12 +162,12 @@
   - do:
       catch: conflict
       ml.delete_trained_model:
-        model_id: "used-regression-model"
+        model_id: "a-regression-model-0"
 ---
 "Test get pre-packaged trained models":
   - do:
       ml.get_trained_models:
-        model_id: "_all"
+        model_id: "lang_ident_model_1"
         allow_no_match: false
   - match: { count: 1 }
   - match: { trained_model_configs.0.model_id: "lang_ident_model_1" }

From c289beb0e509987be43e749a0735a700249e4f00 Mon Sep 17 00:00:00 2001
From: David Turner <david.turner@elastic.co>
Date: Sun, 12 Jan 2020 12:37:52 +0000
Subject: [PATCH 513/686] Fix non-corruption in testCurrentHeaderVersion
 (#50883)

Today we make multiple attempts to corrupt the translog header in
`TranslogHeaderTests#testCurrentHeaderVersion`, but if we are extraordinarily
unlucky then this sequence of corruptions may restore the file to its original
state. This change adjusts the test to only corrupt the file once, which is
certain not to leave the file in its original state.
---
 .../elasticsearch/index/translog/TranslogHeaderTests.java  | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/translog/TranslogHeaderTests.java b/server/src/test/java/org/elasticsearch/index/translog/TranslogHeaderTests.java
index 342ac746b9d31..11684445dcee8 100644
--- a/server/src/test/java/org/elasticsearch/index/translog/TranslogHeaderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/translog/TranslogHeaderTests.java
@@ -52,14 +52,11 @@ public void testCurrentHeaderVersion() throws Exception {
         }
         final TranslogCorruptedException mismatchUUID = expectThrows(TranslogCorruptedException.class, () -> {
             try (FileChannel channel = FileChannel.open(translogFile, StandardOpenOption.READ)) {
-                TranslogHeader.read(UUIDs.randomBase64UUID(), translogFile, channel);
+                TranslogHeader.read(randomValueOtherThan(translogUUID, UUIDs::randomBase64UUID), translogFile, channel);
             }
         });
         assertThat(mismatchUUID.getMessage(), containsString("this translog file belongs to a different translog"));
-        int corruptions = between(1, 10);
-        for (int i = 0; i < corruptions && Files.size(translogFile) > 0; i++) {
-            TestTranslog.corruptFile(logger, random(), translogFile, false);
-        }
+        TestTranslog.corruptFile(logger, random(), translogFile, false);
         final TranslogCorruptedException corruption = expectThrows(TranslogCorruptedException.class, () -> {
             try (FileChannel channel = FileChannel.open(translogFile, StandardOpenOption.READ)) {
                 TranslogHeader.read(randomBoolean() ? outHeader.getTranslogUUID() : UUIDs.randomBase64UUID(), translogFile, channel);

From 0265ba470140008e085f2bcdf60c52318701a2b1 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Mon, 13 Jan 2020 16:37:04 +1100
Subject: [PATCH 514/686] Fix memory leak in DLS bitset cache (#50635)

The Document Level Security BitSet cache stores a secondary "lookup
map" so that it can determine which cache entries to invalidate when
a Lucene index is closed (merged, etc).

There was a memory leak because this secondary map was not cleared
when entries were naturally evicted from the cache (due to size/ttl
limits).

This has been solved by adding a cache removal listener and processing
those removal events asyncronously.
---
 .../DocumentSubsetBitsetCache.java            | 135 +++++++--
 .../DocumentSubsetBitsetCacheTests.java       | 268 ++++++++++++++++--
 .../DocumentSubsetReaderTests.java            |   3 +-
 ...ityIndexReaderWrapperIntegrationTests.java |   5 +-
 .../xpack/security/Security.java              |   2 +-
 .../authz/store/CompositeRolesStoreTests.java |  39 +--
 6 files changed, 385 insertions(+), 67 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCache.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCache.java
index 6b47c3da2fb58..0a24f12aa2380 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCache.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCache.java
@@ -23,13 +23,16 @@
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.cache.Cache;
 import org.elasticsearch.common.cache.CacheBuilder;
+import org.elasticsearch.common.cache.RemovalNotification;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Setting.Property;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.util.concurrent.ReleasableLock;
 import org.elasticsearch.common.util.set.Sets;
+import org.elasticsearch.threadpool.ThreadPool;
 
 import java.io.Closeable;
 import java.util.List;
@@ -38,6 +41,8 @@
 import java.util.Set;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.ExecutionException;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.locks.ReentrantReadWriteLock;
 
 /**
  * This is a cache for {@link BitSet} instances that are used with the {@link DocumentSubsetReader}.
@@ -64,17 +69,48 @@ public final class DocumentSubsetBitsetCache implements IndexReader.ClosedListen
     private static final BitSet NULL_MARKER = new FixedBitSet(0);
 
     private final Logger logger;
+
+    /**
+     * When a {@link BitSet} is evicted from {@link #bitsetCache}, we need to also remove it from {@link #keysByIndex}.
+     * We use a {@link ReentrantReadWriteLock} to control atomicity here - the "read" side represents potential insertions to the
+     * {@link #bitsetCache}, the "write" side represents removals from {@link #keysByIndex}.
+     * The risk (that {@link Cache} does not provide protection for) is that an entry is removed from the cache, and then immediately
+     * re-populated, before we process the removal event. To protect against that we need to check the state of the {@link #bitsetCache}
+     * but we need exclusive ("write") access while performing that check and updating the values in {@link #keysByIndex}.
+     */
+    private final ReleasableLock cacheEvictionLock;
+    private final ReleasableLock cacheModificationLock;
+    private final ExecutorService cleanupExecutor;
+
     private final Cache<BitsetCacheKey, BitSet> bitsetCache;
     private final Map<IndexReader.CacheKey, Set<BitsetCacheKey>> keysByIndex;
 
-    public DocumentSubsetBitsetCache(Settings settings) {
+    public DocumentSubsetBitsetCache(Settings settings, ThreadPool threadPool) {
+        this(settings, threadPool.executor(ThreadPool.Names.GENERIC));
+    }
+
+    /**
+     * @param settings The global settings object for this node
+     * @param cleanupExecutor An executor on which the cache cleanup tasks can be run. Due to the way the cache is structured internally,
+     *                        it is sometimes necessary to run an asynchronous task to synchronize the internal state.
+     */
+    protected DocumentSubsetBitsetCache(Settings settings, ExecutorService cleanupExecutor) {
         this.logger = LogManager.getLogger(getClass());
+
+        final ReentrantReadWriteLock readWriteLock = new ReentrantReadWriteLock();
+        this.cacheEvictionLock = new ReleasableLock(readWriteLock.writeLock());
+        this.cacheModificationLock = new ReleasableLock(readWriteLock.readLock());
+        this.cleanupExecutor = cleanupExecutor;
+
         final TimeValue ttl = CACHE_TTL_SETTING.get(settings);
         final ByteSizeValue size = CACHE_SIZE_SETTING.get(settings);
         this.bitsetCache = CacheBuilder.<BitsetCacheKey, BitSet>builder()
             .setExpireAfterAccess(ttl)
             .setMaximumWeight(size.getBytes())
-            .weigher((key, bitSet) -> bitSet == NULL_MARKER ? 0 : bitSet.ramBytesUsed()).build();
+            .weigher((key, bitSet) -> bitSet == NULL_MARKER ? 0 : bitSet.ramBytesUsed())
+            .removalListener(this::onCacheEviction)
+            .build();
+
         this.keysByIndex = new ConcurrentHashMap<>();
     }
 
@@ -88,6 +124,31 @@ public void onClose(IndexReader.CacheKey ownerCoreCacheKey) {
         }
     }
 
+    /**
+     * Cleanup (synchronize) the internal state when an object is removed from the primary cache
+     */
+    private void onCacheEviction(RemovalNotification<BitsetCacheKey, BitSet> notification) {
+        final BitsetCacheKey bitsetKey = notification.getKey();
+        final IndexReader.CacheKey indexKey = bitsetKey.index;
+        if (keysByIndex.getOrDefault(indexKey, Set.of()).contains(bitsetKey) == false) {
+            // If the bitsetKey isn't in the lookup map, then there's nothing to synchronize
+            return;
+        }
+        // We push this to a background thread, so that it reduces the risk of blocking searches, but also so that the lock management is
+        // simpler - this callback is likely to take place on a thread that is actively adding something to the cache, and is therefore
+        // holding the read ("update") side of the lock. It is not possible to upgrade a read lock to a write ("eviction") lock, but we
+        // need to acquire that lock here.
+        cleanupExecutor.submit(() -> {
+            try (ReleasableLock ignored = cacheEvictionLock.acquire()) {
+                // it's possible for the key to be back in the cache if it was immediately repopulated after it was evicted, so check
+                if (bitsetCache.get(bitsetKey) == null) {
+                    // key is no longer in the cache, make sure it is no longer in the lookup map either.
+                    keysByIndex.getOrDefault(indexKey, Set.of()).remove(bitsetKey);
+                }
+            }
+        });
+    }
+
     @Override
     public void close() {
         clear("close");
@@ -96,7 +157,8 @@ public void close() {
     public void clear(String reason) {
         logger.debug("clearing all DLS bitsets because [{}]", reason);
         // Due to the order here, it is possible than a new entry could be added _after_ the keysByIndex map is cleared
-        // but _before_ the cache is cleared. This would mean it sits orphaned in keysByIndex, but this is not a issue.
+        // but _before_ the cache is cleared. This should get fixed up in the "onCacheEviction" callback, but if anything slips through
+        // and sits orphaned in keysByIndex, it will not be a significant issue.
         // When the index is closed, the key will be removed from the map, and there will not be a corresponding item
         // in the cache, which will make the cache-invalidate a no-op.
         // Since the entry is not in the cache, if #getBitSet is called, it will be loaded, and the new key will be added
@@ -130,31 +192,33 @@ public BitSet getBitSet(final Query query, final LeafReaderContext context) thro
         final IndexReader.CacheKey indexKey = coreCacheHelper.getKey();
         final BitsetCacheKey cacheKey = new BitsetCacheKey(indexKey, query);
 
-        final BitSet bitSet = bitsetCache.computeIfAbsent(cacheKey, ignore1 -> {
-            // This ensures all insertions into the set are guarded by ConcurrentHashMap's atomicity guarantees.
-            keysByIndex.compute(indexKey, (ignore2, set) -> {
-                if (set == null) {
-                    set = Sets.newConcurrentHashSet();
+        try (ReleasableLock ignored = cacheModificationLock.acquire()) {
+            final BitSet bitSet = bitsetCache.computeIfAbsent(cacheKey, ignore1 -> {
+                // This ensures all insertions into the set are guarded by ConcurrentHashMap's atomicity guarantees.
+                keysByIndex.compute(indexKey, (ignore2, set) -> {
+                    if (set == null) {
+                        set = Sets.newConcurrentHashSet();
+                    }
+                    set.add(cacheKey);
+                    return set;
+                });
+                final IndexReaderContext topLevelContext = ReaderUtil.getTopLevelContext(context);
+                final IndexSearcher searcher = new IndexSearcher(topLevelContext);
+                searcher.setQueryCache(null);
+                final Weight weight = searcher.createWeight(searcher.rewrite(query), ScoreMode.COMPLETE_NO_SCORES, 1f);
+                Scorer s = weight.scorer(context);
+                if (s == null) {
+                    // A cache loader is not allowed to return null, return a marker object instead.
+                    return NULL_MARKER;
+                } else {
+                    return BitSet.of(s.iterator(), context.reader().maxDoc());
                 }
-                set.add(cacheKey);
-                return set;
             });
-            final IndexReaderContext topLevelContext = ReaderUtil.getTopLevelContext(context);
-            final IndexSearcher searcher = new IndexSearcher(topLevelContext);
-            searcher.setQueryCache(null);
-            final Weight weight = searcher.createWeight(searcher.rewrite(query), ScoreMode.COMPLETE_NO_SCORES, 1f);
-            Scorer s = weight.scorer(context);
-            if (s == null) {
-                // A cache loader is not allowed to return null, return a marker object instead.
-                return NULL_MARKER;
+            if (bitSet == NULL_MARKER) {
+                return null;
             } else {
-                return BitSet.of(s.iterator(), context.reader().maxDoc());
+                return bitSet;
             }
-        });
-        if (bitSet == NULL_MARKER) {
-            return null;
-        } else {
-            return bitSet;
         }
     }
 
@@ -203,4 +267,27 @@ public String toString() {
             return getClass().getSimpleName() + "(" + index + "," + query + ")";
         }
     }
+
+    /**
+     * This method verifies that the two internal data structures ({@link #bitsetCache} and {@link #keysByIndex}) are consistent with one
+     * another. This method is only called by tests.
+     */
+    void verifyInternalConsistency() {
+        this.bitsetCache.keys().forEach(bck -> {
+            final Set<BitsetCacheKey> set = this.keysByIndex.get(bck.index);
+            if (set == null) {
+                throw new IllegalStateException("Key [" + bck + "] is in the cache, but there is no entry for [" + bck.index +
+                    "] in the lookup map");
+            }
+            if (set.contains(bck) == false) {
+                throw new IllegalStateException("Key [" + bck + "] is in the cache, but the lookup entry for [" + bck.index +
+                    "] does not contain that key");
+            }
+        });
+        this.keysByIndex.values().stream().flatMap(Set::stream).forEach(bck -> {
+            if (this.bitsetCache.get(bck) == null) {
+                throw new IllegalStateException("Key [" + bck + "] is in the lookup map, but is not in the cache");
+            }
+        });
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCacheTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCacheTests.java
index a8bf5272e94fb..206dbf328735e 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCacheTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCacheTests.java
@@ -21,6 +21,7 @@
 import org.apache.lucene.util.BitSet;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.CheckedBiConsumer;
+import org.elasticsearch.common.CheckedConsumer;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.index.IndexSettings;
@@ -32,22 +33,51 @@
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
 import org.hamcrest.Matchers;
-
+import org.junit.After;
+import org.junit.Before;
+import org.mockito.Mockito;
+
+import java.io.Closeable;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.IdentityHashMap;
+import java.util.List;
+import java.util.Set;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicInteger;
+import java.util.concurrent.atomic.AtomicReference;
 
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.nullValue;
 import static org.hamcrest.Matchers.sameInstance;
+import static org.mockito.Matchers.any;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
 public class DocumentSubsetBitsetCacheTests extends ESTestCase {
 
+    private static final int FIELD_COUNT = 10;
+    private ExecutorService singleThreadExecutor;
+
+    @Before
+    public void setUpExecutor() throws Exception {
+        singleThreadExecutor = Executors.newSingleThreadExecutor();
+    }
+
+    @After
+    public void cleanUpExecutor() throws Exception {
+        singleThreadExecutor.shutdown();
+    }
+
     public void testSameBitSetIsReturnedForIdenticalQuery() throws Exception {
-        final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache cache = newCache(Settings.EMPTY);
         runTestOnIndex((shardContext, leafContext) -> {
             final Query query1 = QueryBuilders.termQuery("field-1", "value-1").toQuery(shardContext);
             final BitSet bitSet1 = cache.getBitSet(query1, leafContext);
@@ -62,7 +92,7 @@ public void testSameBitSetIsReturnedForIdenticalQuery() throws Exception {
     }
 
     public void testNullBitSetIsReturnedForNonMatchingQuery() throws Exception {
-        final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache cache = newCache(Settings.EMPTY);
         runTestOnIndex((shardContext, leafContext) -> {
             final Query query = QueryBuilders.termQuery("does-not-exist", "any-value").toQuery(shardContext);
             final BitSet bitSet = cache.getBitSet(query, leafContext);
@@ -71,7 +101,7 @@ public void testNullBitSetIsReturnedForNonMatchingQuery() throws Exception {
     }
 
     public void testNullEntriesAreNotCountedInMemoryUsage() throws Exception {
-        final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache cache = newCache(Settings.EMPTY);
         assertThat(cache.ramBytesUsed(), equalTo(0L));
 
         runTestOnIndex((shardContext, leafContext) -> {
@@ -95,7 +125,7 @@ public void testCacheRespectsMemoryLimit() throws Exception {
         final Settings settings = Settings.builder()
             .put(DocumentSubsetBitsetCache.CACHE_SIZE_SETTING.getKey(), maxCacheBytes + "b")
             .build();
-        final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(settings);
+        final DocumentSubsetBitsetCache cache = newCache(settings);
         assertThat(cache.entryCount(), equalTo(0));
         assertThat(cache.ramBytesUsed(), equalTo(0L));
 
@@ -142,7 +172,7 @@ public void testCacheRespectsAccessTimeExpiry() throws Exception {
         final Settings settings = Settings.builder()
             .put(DocumentSubsetBitsetCache.CACHE_TTL_SETTING.getKey(), "10ms")
             .build();
-        final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(settings);
+        final DocumentSubsetBitsetCache cache = newCache(settings);
         assertThat(cache.entryCount(), equalTo(0));
         assertThat(cache.ramBytesUsed(), equalTo(0L));
 
@@ -167,8 +197,131 @@ public void testCacheRespectsAccessTimeExpiry() throws Exception {
         });
     }
 
+    public void testIndexLookupIsClearedWhenBitSetIsEvicted() throws Exception {
+        // This value is based on the internal implementation details of lucene's FixedBitSet
+        // If the implementation changes, this can be safely updated to match the new ram usage for a single bitset
+        final long expectedBytesPerBitSet = 56;
+
+        // Enough to hold slightly more than 1 bit-set in the cache
+        final long maxCacheBytes = expectedBytesPerBitSet + expectedBytesPerBitSet/2;
+        final Settings settings = Settings.builder()
+            .put(DocumentSubsetBitsetCache.CACHE_SIZE_SETTING.getKey(), maxCacheBytes + "b")
+            .build();
+
+        final ExecutorService executor = mock(ExecutorService.class);
+        final AtomicReference<Runnable> runnableRef = new AtomicReference<>();
+        when(executor.submit(any(Runnable.class))).thenAnswer(inv -> {
+            final Runnable r = (Runnable) inv.getArguments()[0];
+            runnableRef.set(r);
+            return null;
+        });
+
+        final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(settings, executor);
+        assertThat(cache.entryCount(), equalTo(0));
+        assertThat(cache.ramBytesUsed(), equalTo(0L));
+
+        runTestOnIndex((shardContext, leafContext) -> {
+            final Query query1 = QueryBuilders.termQuery("field-1", "value-1").toQuery(shardContext);
+            final BitSet bitSet1 = cache.getBitSet(query1, leafContext);
+            assertThat(bitSet1, notNullValue());
+
+            final Query query2 = QueryBuilders.termQuery("field-2", "value-2").toQuery(shardContext);
+            final BitSet bitSet2 = cache.getBitSet(query2, leafContext);
+            assertThat(bitSet2, notNullValue());
+
+            // BitSet1 has been evicted now, run the cleanup...
+            final Runnable runnable1 = runnableRef.get();
+            assertThat(runnable1, notNullValue());
+            runnable1.run();
+            cache.verifyInternalConsistency();
+
+            // Check that the original bitset is no longer in the cache (a new instance is returned)
+            assertThat(cache.getBitSet(query1, leafContext), not(sameInstance(bitSet1)));
+
+            // BitSet2 has been evicted now, run the cleanup...
+            final Runnable runnable2 = runnableRef.get();
+            assertThat(runnable2, not(sameInstance(runnable1)));
+            runnable2.run();
+            cache.verifyInternalConsistency();
+        });
+    }
+    public void testCacheUnderConcurrentAccess() throws Exception {
+        // This value is based on the internal implementation details of lucene's FixedBitSet
+        // If the implementation changes, this can be safely updated to match the new ram usage for a single bitset
+        final long expectedBytesPerBitSet = 56;
+
+        final int concurrentThreads = randomIntBetween(5, 15);
+        final int numberOfIndices = randomIntBetween(3, 8);
+
+        // Force cache evictions by setting the size to be less than the number of distinct queries we search on.
+        final int maxCacheCount = randomIntBetween(FIELD_COUNT / 2, FIELD_COUNT * 3 / 4);
+        final long maxCacheBytes = expectedBytesPerBitSet * maxCacheCount;
+        final Settings settings = Settings.builder()
+            .put(DocumentSubsetBitsetCache.CACHE_SIZE_SETTING.getKey(), maxCacheBytes + "b")
+            .build();
+
+        final ExecutorService threads = Executors.newFixedThreadPool(concurrentThreads + 1);
+        final ExecutorService cleanupExecutor = Mockito.mock(ExecutorService.class);
+        when(cleanupExecutor.submit(any(Runnable.class))).thenAnswer(inv -> {
+            final Runnable runnable = (Runnable) inv.getArguments()[0];
+            return threads.submit(() -> {
+                // Sleep for a small (random) length of time.
+                // This increases the likelihood that cache could have been modified between the eviction & the cleanup
+                Thread.sleep(randomIntBetween(1, 10));
+                runnable.run();
+                return null;
+            });
+        });
+        try {
+            final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(settings, cleanupExecutor);
+            assertThat(cache.entryCount(), equalTo(0));
+            assertThat(cache.ramBytesUsed(), equalTo(0L));
+
+            runTestOnIndices(numberOfIndices, contexts -> {
+                final CountDownLatch start = new CountDownLatch(concurrentThreads);
+                final CountDownLatch end = new CountDownLatch(concurrentThreads);
+                final Set<BitSet> uniqueBitSets = Collections.synchronizedSet(Collections.newSetFromMap(new IdentityHashMap<>()));
+                for (int thread = 0; thread < concurrentThreads; thread++) {
+                    threads.submit(() -> {
+                        start.countDown();
+                        start.await(100, TimeUnit.MILLISECONDS);
+                        for (int loop = 0; loop < 15; loop++) {
+                            for (int field = 1; field <= FIELD_COUNT; field++) {
+                                final TermQueryBuilder queryBuilder = QueryBuilders.termQuery("field-" + field, "value-" + field);
+                                final TestIndexContext randomContext = randomFrom(contexts);
+                                final Query query = queryBuilder.toQuery(randomContext.queryShardContext);
+                                final BitSet bitSet = cache.getBitSet(query, randomContext.leafReaderContext);
+                                assertThat(bitSet, notNullValue());
+                                assertThat(bitSet.ramBytesUsed(), equalTo(expectedBytesPerBitSet));
+                                uniqueBitSets.add(bitSet);
+                            }
+                        }
+                        end.countDown();
+                        return null;
+                    });
+                }
+
+                assertTrue("Query threads did not complete in expected time", end.await(1, TimeUnit.SECONDS));
+
+                threads.shutdown();
+                assertTrue("Cleanup thread did not complete in expected time", threads.awaitTermination(3, TimeUnit.SECONDS));
+                cache.verifyInternalConsistency();
+
+                // Due to cache evictions, we must get more bitsets than fields
+                assertThat(uniqueBitSets.size(), Matchers.greaterThan(FIELD_COUNT));
+                // Due to cache evictions, we must have seen more bitsets than the cache currently holds
+                assertThat(uniqueBitSets.size(), Matchers.greaterThan(cache.entryCount()));
+                // Even under concurrent pressure, the cache should hit the expected size
+                assertThat(cache.entryCount(), is(maxCacheCount));
+                assertThat(cache.ramBytesUsed(), is(maxCacheBytes));
+            });
+        } finally {
+            threads.shutdown();
+        }
+    }
+
     public void testCacheIsPerIndex() throws Exception {
-        final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache cache = newCache(Settings.EMPTY);
         assertThat(cache.entryCount(), equalTo(0));
         assertThat(cache.ramBytesUsed(), equalTo(0L));
 
@@ -195,7 +348,7 @@ public void accept(QueryShardContext shardContext, LeafReaderContext leafContext
     }
 
     public void testCacheClearEntriesWhenIndexIsClosed() throws Exception {
-        final DocumentSubsetBitsetCache cache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache cache = newCache(Settings.EMPTY);
         assertThat(cache.entryCount(), equalTo(0));
         assertThat(cache.ramBytesUsed(), equalTo(0L));
 
@@ -215,35 +368,106 @@ public void testCacheClearEntriesWhenIndexIsClosed() throws Exception {
     }
 
     private void runTestOnIndex(CheckedBiConsumer<QueryShardContext, LeafReaderContext, Exception> body) throws Exception {
+        runTestOnIndices(1, ctx -> {
+            final TestIndexContext indexContext = ctx.get(0);
+            body.accept(indexContext.queryShardContext, indexContext.leafReaderContext);
+        });
+    }
+
+    private static final class TestIndexContext implements Closeable {
+        private final Directory directory;
+        private final IndexWriter indexWriter;
+        private final DirectoryReader directoryReader;
+        private final QueryShardContext queryShardContext;
+        private final LeafReaderContext leafReaderContext;
+
+        private TestIndexContext(Directory directory, IndexWriter indexWriter, DirectoryReader directoryReader,
+                                 QueryShardContext queryShardContext, LeafReaderContext leafReaderContext) {
+            this.directory = directory;
+            this.indexWriter = indexWriter;
+            this.directoryReader = directoryReader;
+            this.queryShardContext = queryShardContext;
+            this.leafReaderContext = leafReaderContext;
+        }
+
+        @Override
+        public void close() throws IOException {
+            directoryReader.close();
+            indexWriter.close();
+            directory.close();
+        }
+    }
+
+    private TestIndexContext testIndex(MapperService mapperService, Client client) throws IOException {
+        TestIndexContext context = null;
+
+        final long nowInMillis = randomNonNegativeLong();
         final ShardId shardId = new ShardId("idx_" + randomAlphaOfLengthBetween(2, 8), randomAlphaOfLength(12), 0);
         final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(shardId.getIndex(), Settings.EMPTY);
-        final MapperService mapperService = mock(MapperService.class);
-        final long nowInMillis = randomNonNegativeLong();
+        final IndexWriterConfig writerConfig = new IndexWriterConfig(new StandardAnalyzer()).setMergePolicy(NoMergePolicy.INSTANCE);
 
-        final Client client = mock(Client.class);
-        when(client.settings()).thenReturn(Settings.EMPTY);
+        Directory directory = null;
+        IndexWriter iw = null;
+        DirectoryReader directoryReader = null;
+        try {
+            directory = newDirectory();
 
-        final IndexWriterConfig writerConfig = new IndexWriterConfig(new StandardAnalyzer()).setMergePolicy(NoMergePolicy.INSTANCE);
-        try (Directory directory = newDirectory();
-             IndexWriter iw = new IndexWriter(directory, writerConfig)) {
+            iw = new IndexWriter(directory, writerConfig);
             for (int i = 1; i <= 100; i++) {
                 Document document = new Document();
-                for (int j = 1; j <= 10; j++) {
+                for (int j = 1; j <= FIELD_COUNT; j++) {
                     document.add(new StringField("field-" + j, "value-" + i, Field.Store.NO));
                 }
                 iw.addDocument(document);
             }
             iw.commit();
 
-            try (DirectoryReader directoryReader = DirectoryReader.open(directory)) {
-                final LeafReaderContext leaf = directoryReader.leaves().get(0);
+            directoryReader = DirectoryReader.open(directory);
+            final LeafReaderContext leaf = directoryReader.leaves().get(0);
+
+            final QueryShardContext shardContext = new QueryShardContext(shardId.id(), indexSettings, BigArrays.NON_RECYCLING_INSTANCE,
+                null, null, mapperService, null, null, xContentRegistry(), writableRegistry(),
+                client, new IndexSearcher(directoryReader), () -> nowInMillis, null, null);
+
+            context = new TestIndexContext(directory, iw, directoryReader, shardContext, leaf);
+            return context;
+        } finally {
+            if (context == null) {
+                if (directoryReader != null) {
+                    directoryReader.close();
+                }
+                if (iw != null) {
+                    iw.close();
+                }
+                if (directory != null) {
+                    directory.close();
+                }
+            }
+        }
+    }
+
+    private void runTestOnIndices(int numberIndices, CheckedConsumer<List<TestIndexContext>, Exception> body) throws Exception {
+        final MapperService mapperService = mock(MapperService.class);
 
-                final QueryShardContext context = new QueryShardContext(shardId.id(), indexSettings, BigArrays.NON_RECYCLING_INSTANCE,
-                    null, null, mapperService, null, null, xContentRegistry(), writableRegistry(),
-                        client, new IndexSearcher(directoryReader), () -> nowInMillis, null, null);
-                body.accept(context, leaf);
+        final Client client = mock(Client.class);
+        when(client.settings()).thenReturn(Settings.EMPTY);
+
+        final List<TestIndexContext> context = new ArrayList<>(numberIndices);
+        try {
+            for (int i = 0; i < numberIndices; i++) {
+                context.add(testIndex(mapperService, client));
+            }
+
+            body.accept(context);
+        } finally {
+            for (TestIndexContext indexContext : context) {
+                indexContext.close();
             }
         }
     }
 
+    private DocumentSubsetBitsetCache newCache(Settings settings) {
+        return new DocumentSubsetBitsetCache(settings, singleThreadExecutor);
+    }
+
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetReaderTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetReaderTests.java
index c84c0027302e6..3fae0c26ea76d 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetReaderTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetReaderTests.java
@@ -32,6 +32,7 @@
 import org.junit.Before;
 
 import java.io.IOException;
+import java.util.concurrent.Executors;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
@@ -50,7 +51,7 @@ public void setUpDirectory() {
         assertTrue(DocumentSubsetReader.NUM_DOCS_CACHE.toString(),
                 DocumentSubsetReader.NUM_DOCS_CACHE.isEmpty());
         directory = newDirectory();
-        bitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        bitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY, Executors.newSingleThreadExecutor());
     }
 
     @After
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/SecurityIndexReaderWrapperIntegrationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/SecurityIndexReaderWrapperIntegrationTests.java
index ca2b38318a06f..1f8ba70426366 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/SecurityIndexReaderWrapperIntegrationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/SecurityIndexReaderWrapperIntegrationTests.java
@@ -48,6 +48,7 @@
 import java.util.Collections;
 import java.util.HashSet;
 import java.util.Set;
+import java.util.concurrent.Executors;
 
 import static java.util.Collections.singleton;
 import static java.util.Collections.singletonMap;
@@ -80,7 +81,7 @@ public void testDLS() throws Exception {
                 null, null, mapperService, null, null, xContentRegistry(), writableRegistry(),
                 client, null, () -> nowInMillis, null, null);
         QueryShardContext queryShardContext = spy(realQueryShardContext);
-        DocumentSubsetBitsetCache bitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        DocumentSubsetBitsetCache bitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY, Executors.newSingleThreadExecutor());
         XPackLicenseState licenseState = mock(XPackLicenseState.class);
         when(licenseState.isDocumentAndFieldLevelSecurityAllowed()).thenReturn(true);
 
@@ -202,7 +203,7 @@ public void testDLSWithLimitedPermissions() throws Exception {
                 null, null, mapperService, null, null, xContentRegistry(), writableRegistry(),
                 client, null, () -> nowInMillis, null, null);
         QueryShardContext queryShardContext = spy(realQueryShardContext);
-        DocumentSubsetBitsetCache bitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        DocumentSubsetBitsetCache bitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY, Executors.newSingleThreadExecutor());
 
         XPackLicenseState licenseState = mock(XPackLicenseState.class);
         when(licenseState.isDocumentAndFieldLevelSecurityAllowed()).thenReturn(true);
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
index 3b24042f47efb..0211aa429a8a9 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
@@ -412,7 +412,7 @@ Collection<Object> createComponents(Client client, ThreadPool threadPool, Cluste
         final NativePrivilegeStore privilegeStore = new NativePrivilegeStore(settings, client, securityIndex.get());
         components.add(privilegeStore);
 
-        dlsBitsetCache.set(new DocumentSubsetBitsetCache(settings));
+        dlsBitsetCache.set(new DocumentSubsetBitsetCache(settings, threadPool));
         final FieldPermissionsCache fieldPermissionsCache = new FieldPermissionsCache(settings);
         final FileRolesStore fileRolesStore = new FileRolesStore(settings, env, resourceWatcherService, getLicenseState(),
             xContentRegistry);
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStoreTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStoreTests.java
index 7da88f0231b8c..53c1b816b19d9 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStoreTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStoreTests.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.license.TestUtils.UpdatableLicenseState;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportRequest;
 import org.elasticsearch.transport.TransportRequest.Empty;
 import org.elasticsearch.xpack.core.XPackSettings;
@@ -152,7 +153,7 @@ public void testRolesWhenDlsFlsUnlicensed() throws IOException {
         when(fileRolesStore.roleDescriptors(Collections.singleton("fls_dls"))).thenReturn(Collections.singleton(flsDlsRole));
         when(fileRolesStore.roleDescriptors(Collections.singleton("no_fls_dls"))).thenReturn(Collections.singleton(noFlsDlsRole));
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         CompositeRolesStore compositeRolesStore = new CompositeRolesStore(Settings.EMPTY, fileRolesStore, nativeRolesStore,
                 reservedRolesStore, mock(NativePrivilegeStore.class), Collections.emptyList(),
                 new ThreadContext(Settings.EMPTY), licenseState, cache, mock(ApiKeyService.class), documentSubsetBitsetCache,
@@ -228,7 +229,7 @@ public void testRolesWhenDlsFlsLicensed() throws IOException {
         when(fileRolesStore.roleDescriptors(Collections.singleton("fls_dls"))).thenReturn(Collections.singleton(flsDlsRole));
         when(fileRolesStore.roleDescriptors(Collections.singleton("no_fls_dls"))).thenReturn(Collections.singleton(noFlsDlsRole));
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         CompositeRolesStore compositeRolesStore = new CompositeRolesStore(Settings.EMPTY, fileRolesStore, nativeRolesStore,
                 reservedRolesStore, mock(NativePrivilegeStore.class), Collections.emptyList(),
                 new ThreadContext(Settings.EMPTY), licenseState, cache, mock(ApiKeyService.class), documentSubsetBitsetCache,
@@ -280,7 +281,7 @@ public void testNegativeLookupsAreCached() {
         }).when(nativePrivilegeStore).getPrivileges(isA(Set.class), isA(Set.class), any(ActionListener.class));
 
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final CompositeRolesStore compositeRolesStore =
                 new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
                         nativePrivilegeStore, Collections.emptyList(), new ThreadContext(SECURITY_ENABLED_SETTINGS),
@@ -343,7 +344,7 @@ public void testNegativeLookupsCacheDisabled() {
             .put("xpack.security.authz.store.roles.negative_lookup_cache.max_size", 0)
             .build();
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final CompositeRolesStore compositeRolesStore = new CompositeRolesStore(settings, fileRolesStore, nativeRolesStore,
             reservedRolesStore, mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(settings),
             new XPackLicenseState(settings), cache, mock(ApiKeyService.class), documentSubsetBitsetCache,
@@ -381,7 +382,7 @@ public void testNegativeLookupsAreNotCachedWithFailures() {
         final ReservedRolesStore reservedRolesStore = spy(new ReservedRolesStore());
 
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
                 mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(SECURITY_ENABLED_SETTINGS),
@@ -421,6 +422,10 @@ public void testNegativeLookupsAreNotCachedWithFailures() {
         verifyNoMoreInteractions(fileRolesStore, reservedRolesStore, nativeRolesStore);
     }
 
+    private DocumentSubsetBitsetCache buildBitsetCache() {
+        return new DocumentSubsetBitsetCache(Settings.EMPTY, mock(ThreadPool.class));
+    }
+
     public void testCustomRolesProviders() {
         final FileRolesStore fileRolesStore = mock(FileRolesStore.class);
         doCallRealMethod().when(fileRolesStore).accept(any(Set.class), any(ActionListener.class));
@@ -467,7 +472,7 @@ public void testCustomRolesProviders() {
         }));
 
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final CompositeRolesStore compositeRolesStore =
                 new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
                                 mock(NativePrivilegeStore.class), Arrays.asList(inMemoryProvider1, inMemoryProvider2),
@@ -696,7 +701,7 @@ public void testCustomRolesProviderFailures() throws Exception {
             (roles, listener) -> listener.onFailure(new Exception("fake failure"));
 
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
                 mock(NativePrivilegeStore.class), Arrays.asList(inMemoryProvider1, failingProvider),
@@ -744,7 +749,7 @@ public void testCustomRolesProvidersLicensing() {
         // these licenses don't allow custom role providers
         xPackLicenseState.update(randomFrom(OperationMode.BASIC, OperationMode.GOLD, OperationMode.STANDARD), true, null);
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         CompositeRolesStore compositeRolesStore = new CompositeRolesStore(
             Settings.EMPTY, fileRolesStore, nativeRolesStore, reservedRolesStore, mock(NativePrivilegeStore.class),
             Arrays.asList(inMemoryProvider), new ThreadContext(Settings.EMPTY), xPackLicenseState, cache,
@@ -808,7 +813,7 @@ public void testCacheClearOnIndexHealthChange() {
         doCallRealMethod().when(reservedRolesStore).accept(any(Set.class), any(ActionListener.class));
         NativeRolesStore nativeRolesStore = mock(NativeRolesStore.class);
         doCallRealMethod().when(nativeRolesStore).accept(any(Set.class), any(ActionListener.class));
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         CompositeRolesStore compositeRolesStore = new CompositeRolesStore(
                 Settings.EMPTY, fileRolesStore, nativeRolesStore, reservedRolesStore,
                 mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(Settings.EMPTY),
@@ -862,7 +867,7 @@ public void testCacheClearOnIndexOutOfDateChange() {
         doCallRealMethod().when(reservedRolesStore).accept(any(Set.class), any(ActionListener.class));
         NativeRolesStore nativeRolesStore = mock(NativeRolesStore.class);
         doCallRealMethod().when(nativeRolesStore).accept(any(Set.class), any(ActionListener.class));
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         CompositeRolesStore compositeRolesStore = new CompositeRolesStore(SECURITY_ENABLED_SETTINGS,
                 fileRolesStore, nativeRolesStore, reservedRolesStore,
                 mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(SECURITY_ENABLED_SETTINGS),
@@ -894,7 +899,7 @@ public void testDefaultRoleUserWithoutRoles() {
         }).when(nativeRolesStore).getRoleDescriptors(isA(Set.class), any(ActionListener.class));
         final ReservedRolesStore reservedRolesStore = spy(new ReservedRolesStore());
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
                 mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(SECURITY_ENABLED_SETTINGS),
@@ -935,7 +940,7 @@ public void testAnonymousUserEnabledRoleAdded() {
         }).when(nativeRolesStore).getRoleDescriptors(isA(Set.class), any(ActionListener.class));
         final ReservedRolesStore reservedRolesStore = spy(new ReservedRolesStore());
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(settings, fileRolesStore, nativeRolesStore, reservedRolesStore,
                 mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(settings),
@@ -963,7 +968,7 @@ public void testDoesNotUseRolesStoreForXPackUser() {
         }).when(nativeRolesStore).getRoleDescriptors(isA(Set.class), any(ActionListener.class));
         final ReservedRolesStore reservedRolesStore = spy(new ReservedRolesStore());
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
@@ -994,7 +999,7 @@ public void testGetRolesForSystemUserThrowsException() {
         }).when(nativeRolesStore).getRoleDescriptors(isA(Set.class), any(ActionListener.class));
         final ReservedRolesStore reservedRolesStore = spy(new ReservedRolesStore());
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
@@ -1030,7 +1035,7 @@ public void testApiKeyAuthUsesApiKeyService() throws IOException {
             return Void.TYPE;
         }).when(nativePrivStore).getPrivileges(any(Collection.class), any(Collection.class), any(ActionListener.class));
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
@@ -1076,7 +1081,7 @@ public void testApiKeyAuthUsesApiKeyServiceWithScopedRole() throws IOException {
             return Void.TYPE;
         }).when(nativePrivStore).getPrivileges(any(Collection.class), any(Collection.class), any(ActionListener.class));
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
@@ -1117,7 +1122,7 @@ public void testUsageStats() {
         }).when(nativeRolesStore).usageStats(any(ActionListener.class));
         final ReservedRolesStore reservedRolesStore = spy(new ReservedRolesStore());
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY);
+        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
 
         final CompositeRolesStore compositeRolesStore =
             new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,

From 7f0fe96d07c45d873b220c70418178b73586880e Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Mon, 13 Jan 2020 17:24:32 +1100
Subject: [PATCH 515/686] Validate field permissions when creating a role
 (#50212)

When creating a role, we do not check if the exceptions for
the field permissions are a subset of granted fields. If such
a role is assigned to a user then that user's authentication fails
for this reason.

We added a check to validate role query in #46275 and on the same lines,
this commit adds check if the exceptions for the field
permissions is a subset of granted fields when parsing the
index privileges from the role descriptor.

Co-authored-by: Yogesh Gaikwad <bizybot@users.noreply.github.com>
---
 .../core/security/authz/RoleDescriptor.java   | 11 +++++++
 .../authz/permission/FieldPermissions.java    |  8 +++--
 .../security/authz/RoleDescriptorTests.java   | 29 +++++++++++++++++++
 3 files changed, 46 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/RoleDescriptor.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/RoleDescriptor.java
index 6dfc2204c008c..832e9c9365e94 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/RoleDescriptor.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/RoleDescriptor.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.core.security.authz;
 
 import org.elasticsearch.ElasticsearchParseException;
+import org.elasticsearch.ElasticsearchSecurityException;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
@@ -23,6 +24,7 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.xpack.core.security.authz.permission.FieldPermissions;
 import org.elasticsearch.xpack.core.security.authz.privilege.ConfigurableClusterPrivilege;
 import org.elasticsearch.xpack.core.security.authz.privilege.ConfigurableClusterPrivileges;
 import org.elasticsearch.xpack.core.security.support.Validation;
@@ -532,6 +534,7 @@ private static RoleDescriptor.IndicesPrivileges parseIndex(String roleName, XCon
             throw new ElasticsearchParseException("failed to parse indices privileges for role [{}]. {} requires {} if {} is given",
                     roleName, Fields.FIELD_PERMISSIONS, Fields.GRANT_FIELDS, Fields.EXCEPT_FIELDS);
         }
+        checkIfExceptFieldsIsSubsetOfGrantedFields(roleName, grantedFields, deniedFields);
         return RoleDescriptor.IndicesPrivileges.builder()
                 .indices(names)
                 .privileges(privileges)
@@ -542,6 +545,14 @@ private static RoleDescriptor.IndicesPrivileges parseIndex(String roleName, XCon
                 .build();
     }
 
+    private static void checkIfExceptFieldsIsSubsetOfGrantedFields(String roleName, String[] grantedFields, String[] deniedFields) {
+        try {
+            FieldPermissions.buildPermittedFieldsAutomaton(grantedFields, deniedFields);
+        } catch (ElasticsearchSecurityException e) {
+            throw new ElasticsearchParseException("failed to parse indices privileges for role [{}] - {}", e, roleName, e.getMessage());
+        }
+    }
+
     private static ApplicationResourcePrivileges[] parseApplicationPrivileges(String roleName, XContentParser parser)
             throws IOException {
         if (parser.currentToken() != XContentParser.Token.START_ARRAY) {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/FieldPermissions.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/FieldPermissions.java
index f58367dc43886..f745629b60199 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/FieldPermissions.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/FieldPermissions.java
@@ -119,12 +119,16 @@ public static Automaton initializePermittedFieldsAutomaton(FieldPermissionsDefin
         assert groups.size() > 0 : "there must always be a single group for field inclusion/exclusion";
         List<Automaton> automatonList =
                 groups.stream()
-                        .map(g -> FieldPermissions.initializePermittedFieldsAutomaton(g.getGrantedFields(), g.getExcludedFields()))
+                        .map(g -> FieldPermissions.buildPermittedFieldsAutomaton(g.getGrantedFields(), g.getExcludedFields()))
                         .collect(Collectors.toList());
         return Automatons.unionAndMinimize(automatonList);
     }
 
-    private static Automaton initializePermittedFieldsAutomaton(final String[] grantedFields, final String[] deniedFields) {
+    /**
+     * Construct a single automaton to represent the set of {@code grantedFields} except for the {@code deniedFields}.
+     * @throws ElasticsearchSecurityException If {@code deniedFields} is not a subset of {@code grantedFields}.
+     */
+    public static Automaton buildPermittedFieldsAutomaton(final String[] grantedFields, final String[] deniedFields) {
         Automaton grantedFieldsAutomaton;
         if (grantedFields == null || Arrays.stream(grantedFields).anyMatch(Regex::isMatchAllPattern)) {
             grantedFieldsAutomaton = Automatons.MATCH_ALL;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RoleDescriptorTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RoleDescriptorTests.java
index 0c20a7c20d09c..66161ee27ec19 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RoleDescriptorTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RoleDescriptorTests.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.security.authz;
 
+import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.Version;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesArray;
@@ -19,6 +20,7 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.TestMatchers;
 import org.elasticsearch.test.VersionUtils;
 import org.elasticsearch.xpack.core.XPackClientPlugin;
 import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
@@ -27,6 +29,7 @@
 import org.elasticsearch.xpack.core.security.support.MetadataUtils;
 import org.hamcrest.Matchers;
 
+import java.io.IOException;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.LinkedHashSet;
@@ -296,4 +299,30 @@ public void testParseIgnoresTransientMetadata() throws Exception {
         assertEquals(true, parsed.getTransientMetadata().get("enabled"));
     }
 
+    public void testParseIndicesPrivilegesSucceedsWhenExceptFieldsIsSubsetOfGrantedFields() throws IOException {
+        final boolean grantAll = randomBoolean();
+        final String grant = grantAll ? "\"*\"" : "\"f1\",\"f2\"";
+        final String except = grantAll ? "\"_fx\",\"f8\"" : "\"f1\"";
+
+        final String json = "{ \"indices\": [{\"names\": [\"idx1\",\"idx2\"], \"privileges\": [\"p1\", \"p2\"], \"field_security\" : { " +
+            "\"grant\" : [" + grant + "], \"except\" : [" + except + "] } }] }";
+        final RoleDescriptor rd = RoleDescriptor.parse("test",
+            new BytesArray(json), false, XContentType.JSON);
+        assertEquals("test", rd.getName());
+        assertEquals(1, rd.getIndicesPrivileges().length);
+        assertArrayEquals(new String[]{"idx1", "idx2"}, rd.getIndicesPrivileges()[0].getIndices());
+        assertArrayEquals((grantAll) ? new String[]{"*"} : new String[]{"f1", "f2"}, rd.getIndicesPrivileges()[0].getGrantedFields());
+        assertArrayEquals((grantAll) ? new String[]{"_fx", "f8"} : new String[]{"f1"}, rd.getIndicesPrivileges()[0].getDeniedFields());
+    }
+
+    public void testParseIndicesPrivilegesFailsWhenExceptFieldsAreNotSubsetOfGrantedFields() {
+        final String json = "{ \"indices\": [{\"names\": [\"idx1\",\"idx2\"], \"privileges\": [\"p1\", \"p2\"], \"field_security\" : { " +
+            "\"grant\" : [\"f1\",\"f2\"], \"except\" : [\"f3\"] } }] }";
+        final ElasticsearchParseException epe = expectThrows(ElasticsearchParseException.class, () -> RoleDescriptor.parse("test",
+            new BytesArray(json), false, XContentType.JSON));
+        assertThat(epe, TestMatchers.throwableWithMessage(containsString("must be a subset of the granted fields ")));
+        assertThat(epe, TestMatchers.throwableWithMessage(containsString("f1")));
+        assertThat(epe, TestMatchers.throwableWithMessage(containsString("f2")));
+        assertThat(epe, TestMatchers.throwableWithMessage(containsString("f3")));
+    }
 }

From bfd44b73e0d40653826e46fac7b6eda80d4d0f17 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Mon, 13 Jan 2020 18:04:48 +1100
Subject: [PATCH 516/686] Increase Size and lower TTL on DLS BitSet Cache
 (#50535)

The Document Level Security BitSet Cache (see #43669) had a default
configuration of "small size, long lifetime". However, this is not
a very useful default as the cache is most valuable for BitSets that
take a long time to construct, which is (generally speaking) the same
ones that operate over a large number of documents and contain many
bytes.

This commit changes the cache to be "large size, short lifetime" so
that it can hold bitsets representing billions of documents, but
releases memory quickly.

The new defaults are 10% of heap, and 2 hours.

This also adds some logging when a single BitSet exceeds the size of
the cache and when the cache is full.

Resolves: #49260
---
 .../DocumentSubsetBitsetCache.java            | 73 ++++++++++++---
 .../DocumentSubsetBitsetCacheTests.java       | 92 +++++++++++++++++++
 2 files changed, 153 insertions(+), 12 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCache.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCache.java
index 0a24f12aa2380..d99303bafc473 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCache.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCache.java
@@ -42,29 +42,51 @@
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.ExecutorService;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicLong;
 import java.util.concurrent.locks.ReentrantReadWriteLock;
 
 /**
  * This is a cache for {@link BitSet} instances that are used with the {@link DocumentSubsetReader}.
  * It is bounded by memory size and access time.
  *
+ * DLS uses {@link BitSet} instances to track which documents should be visible to the user ("live") and which should not ("dead").
+ * This means that there is a bit for each document in a Lucene index (ES shard).
+ * Consequently, an index with 10 million document will use more than 1Mb of bitset memory for every unique DLS query, and an index
+ * with 1 billion documents will use more than 100Mb of memory per DLS query.
+ * Because DLS supports templating queries based on user metadata, there may be many distinct queries in use for each index, even if
+ * there is only a single active role.
+ *
+ * The primary benefit of the cache is to avoid recalculating the "live docs" (visible documents) when a user performs multiple
+ * consecutive queries across one or more large indices. Given the memory examples above, the cache is only useful if it can hold at
+ * least 1 large (100Mb or more ) {@code BitSet} during a user's active session, and ideally should be capable of support multiple
+ * simultaneous users with distinct DLS queries.
+ *
+ * For this reason the default memory usage (weight) for the cache set to 10% of JVM heap ({@link #CACHE_SIZE_SETTING}), so that it
+ * automatically scales with the size of the Elasticsearch deployment, and can provide benefit to most use cases without needing
+ * customisation. On a 32Gb heap, a 10% cache would be 3.2Gb which is large enough to store BitSets representing 25 billion docs.
+ *
+ * However, because queries can be templated by user metadata and that metadata can change frequently, it is common for the
+ * effetively lifetime of a single DLS query to be relatively short. We do not want to sacrifice 10% of heap to a cache that is storing
+ * BitSets that are not longer needed, so we set the TTL on this cache to be 2 hours ({@link #CACHE_TTL_SETTING}). This time has been
+ * chosen so that it will retain BitSets that are in active use during a user's session, but not be an ongoing drain on memory.
+ *
  * @see org.elasticsearch.index.cache.bitset.BitsetFilterCache
  */
 public final class DocumentSubsetBitsetCache implements IndexReader.ClosedListener, Closeable, Accountable {
 
     /**
-     * The TTL defaults to 1 week. We depend on the {@code max_bytes} setting to keep the cache to a sensible size, by evicting LRU
-     * entries, however there is benefit in reclaiming memory by expiring bitsets that have not be used for some period of time.
-     * Because {@link org.elasticsearch.xpack.core.security.authz.permission.IndicesPermission.Group#query} can be templated, it is
-     * not uncommon for a query to only be used for a relatively short period of time (e.g. because a user's metadata changed, or because
-     * that user is an infrequent user of Elasticsearch). This access time expiry helps free up memory in those circumstances even if the
-     * cache is never filled.
+     * The TTL defaults to 2 hours. We default to a large cache size ({@link #CACHE_SIZE_SETTING}), and aggressively
+     * expire unused entries so that the cache does not hold on to memory unnecessarily.
      */
     static final Setting<TimeValue> CACHE_TTL_SETTING =
-        Setting.timeSetting("xpack.security.dls.bitset.cache.ttl", TimeValue.timeValueHours(24 * 7), Property.NodeScope);
+        Setting.timeSetting("xpack.security.dls.bitset.cache.ttl", TimeValue.timeValueHours(2), Property.NodeScope);
 
-    static final Setting<ByteSizeValue> CACHE_SIZE_SETTING = Setting.byteSizeSetting("xpack.security.dls.bitset.cache.size",
-            new ByteSizeValue(50, ByteSizeUnit.MB), Property.NodeScope);
+    /**
+     * The size defaults to 10% of heap so that it automatically scales up with larger node size
+     */
+    static final Setting<ByteSizeValue> CACHE_SIZE_SETTING = Setting.memorySizeSetting("xpack.security.dls.bitset.cache.size",
+            "10%", Property.NodeScope);
 
     private static final BitSet NULL_MARKER = new FixedBitSet(0);
 
@@ -82,8 +104,10 @@ public final class DocumentSubsetBitsetCache implements IndexReader.ClosedListen
     private final ReleasableLock cacheModificationLock;
     private final ExecutorService cleanupExecutor;
 
+    private final long maxWeightBytes;
     private final Cache<BitsetCacheKey, BitSet> bitsetCache;
     private final Map<IndexReader.CacheKey, Set<BitsetCacheKey>> keysByIndex;
+    private final AtomicLong cacheFullWarningTime;
 
     public DocumentSubsetBitsetCache(Settings settings, ThreadPool threadPool) {
         this(settings, threadPool.executor(ThreadPool.Names.GENERIC));
@@ -103,15 +127,16 @@ protected DocumentSubsetBitsetCache(Settings settings, ExecutorService cleanupEx
         this.cleanupExecutor = cleanupExecutor;
 
         final TimeValue ttl = CACHE_TTL_SETTING.get(settings);
-        final ByteSizeValue size = CACHE_SIZE_SETTING.get(settings);
+        this.maxWeightBytes = CACHE_SIZE_SETTING.get(settings).getBytes();
         this.bitsetCache = CacheBuilder.<BitsetCacheKey, BitSet>builder()
             .setExpireAfterAccess(ttl)
-            .setMaximumWeight(size.getBytes())
+            .setMaximumWeight(maxWeightBytes)
             .weigher((key, bitSet) -> bitSet == NULL_MARKER ? 0 : bitSet.ramBytesUsed())
             .removalListener(this::onCacheEviction)
             .build();
 
         this.keysByIndex = new ConcurrentHashMap<>();
+        this.cacheFullWarningTime = new AtomicLong(0);
     }
 
     @Override
@@ -211,7 +236,17 @@ public BitSet getBitSet(final Query query, final LeafReaderContext context) thro
                     // A cache loader is not allowed to return null, return a marker object instead.
                     return NULL_MARKER;
                 } else {
-                    return BitSet.of(s.iterator(), context.reader().maxDoc());
+                    final BitSet bs = BitSet.of(s.iterator(), context.reader().maxDoc());
+                    final long bitSetBytes = bs.ramBytesUsed();
+                    if (bitSetBytes > this.maxWeightBytes) {
+                        logger.warn("built a DLS BitSet that uses [{}] bytes; the DLS BitSet cache has a maximum size of [{}] bytes;" +
+                                " this object cannot be cached and will need to be rebuilt for each use;" +
+                                " consider increasing the value of [{}]",
+                            bitSetBytes, maxWeightBytes, CACHE_SIZE_SETTING.getKey());
+                    } else if (bitSetBytes + bitsetCache.weight() > maxWeightBytes) {
+                        maybeLogCacheFullWarning();
+                    }
+                    return bs;
                 }
             });
             if (bitSet == NULL_MARKER) {
@@ -222,6 +257,20 @@ public BitSet getBitSet(final Query query, final LeafReaderContext context) thro
         }
     }
 
+    private void maybeLogCacheFullWarning() {
+        final long nextLogTime = cacheFullWarningTime.get();
+        final long now = System.currentTimeMillis();
+        if (nextLogTime > now) {
+            return;
+        }
+        final long nextCheck = now + TimeUnit.MINUTES.toMillis(30);
+        if (cacheFullWarningTime.compareAndSet(nextLogTime, nextCheck)) {
+            logger.info(
+                "the Document Level Security BitSet cache is full which may impact performance; consider increasing the value of [{}]",
+                CACHE_SIZE_SETTING.getKey());
+        }
+    }
+
     public static List<Setting<?>> getSettings() {
         return List.of(CACHE_TTL_SETTING, CACHE_SIZE_SETTING);
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCacheTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCacheTests.java
index 206dbf328735e..be83ab37c7628 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCacheTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/DocumentSubsetBitsetCacheTests.java
@@ -6,6 +6,9 @@
 
 package org.elasticsearch.xpack.core.security.authz.accesscontrol;
 
+import org.apache.logging.log4j.Level;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.apache.lucene.analysis.standard.StandardAnalyzer;
 import org.apache.lucene.document.Document;
 import org.apache.lucene.document.Field;
@@ -21,6 +24,7 @@
 import org.apache.lucene.util.BitSet;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.CheckedBiConsumer;
+import org.elasticsearch.common.logging.Loggers;
 import org.elasticsearch.common.CheckedConsumer;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.BigArrays;
@@ -32,6 +36,7 @@
 import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
+import org.elasticsearch.test.MockLogAppender;
 import org.hamcrest.Matchers;
 import org.junit.After;
 import org.junit.Before;
@@ -168,6 +173,93 @@ public void testCacheRespectsMemoryLimit() throws Exception {
         });
     }
 
+    public void testLogWarningIfBitSetExceedsCacheSize() throws Exception {
+        // This value is based on the internal implementation details of lucene's FixedBitSet
+        // If the implementation changes, this can be safely updated to match the new ram usage for a single bitset
+        final long expectedBytesPerBitSet = 56;
+
+        // Enough to hold less than 1 bit-sets in the cache
+        final long maxCacheBytes = expectedBytesPerBitSet - expectedBytesPerBitSet/3;
+        final Settings settings = Settings.builder()
+            .put(DocumentSubsetBitsetCache.CACHE_SIZE_SETTING.getKey(), maxCacheBytes + "b")
+            .build();
+        final DocumentSubsetBitsetCache cache = newCache(settings);
+        assertThat(cache.entryCount(), equalTo(0));
+        assertThat(cache.ramBytesUsed(), equalTo(0L));
+
+        final Logger cacheLogger = LogManager.getLogger(cache.getClass());
+        final MockLogAppender mockAppender = new MockLogAppender();
+        mockAppender.start();
+        try {
+            Loggers.addAppender(cacheLogger, mockAppender);
+            mockAppender.addExpectation(new MockLogAppender.SeenEventExpectation(
+                "[bitset too big]",
+                cache.getClass().getName(),
+                Level.WARN,
+                "built a DLS BitSet that uses [" + expectedBytesPerBitSet + "] bytes; the DLS BitSet cache has a maximum size of [" +
+                    maxCacheBytes + "] bytes; this object cannot be cached and will need to be rebuilt for each use;" +
+                    " consider increasing the value of [xpack.security.dls.bitset.cache.size]"
+            ));
+
+            runTestOnIndex((shardContext, leafContext) -> {
+                final TermQueryBuilder queryBuilder = QueryBuilders.termQuery("field-1", "value-1");
+                final Query query = queryBuilder.toQuery(shardContext);
+                final BitSet bitSet = cache.getBitSet(query, leafContext);
+                assertThat(bitSet, notNullValue());
+                assertThat(bitSet.ramBytesUsed(), equalTo(expectedBytesPerBitSet));
+            });
+
+            mockAppender.assertAllExpectationsMatched();
+        } finally {
+            Loggers.removeAppender(cacheLogger, mockAppender);
+            mockAppender.stop();
+        }
+    }
+
+    public void testLogMessageIfCacheFull() throws Exception {
+        // This value is based on the internal implementation details of lucene's FixedBitSet
+        // If the implementation changes, this can be safely updated to match the new ram usage for a single bitset
+        final long expectedBytesPerBitSet = 56;
+
+        // Enough to hold slightly more than 1 bit-sets in the cache
+        final long maxCacheBytes = expectedBytesPerBitSet + expectedBytesPerBitSet/3;
+        final Settings settings = Settings.builder()
+            .put(DocumentSubsetBitsetCache.CACHE_SIZE_SETTING.getKey(), maxCacheBytes + "b")
+            .build();
+        final DocumentSubsetBitsetCache cache = newCache(settings);
+        assertThat(cache.entryCount(), equalTo(0));
+        assertThat(cache.ramBytesUsed(), equalTo(0L));
+
+        final Logger cacheLogger = LogManager.getLogger(cache.getClass());
+        final MockLogAppender mockAppender = new MockLogAppender();
+        mockAppender.start();
+        try {
+            Loggers.addAppender(cacheLogger, mockAppender);
+            mockAppender.addExpectation(new MockLogAppender.SeenEventExpectation(
+                "[cache full]",
+                cache.getClass().getName(),
+                Level.INFO,
+                "the Document Level Security BitSet cache is full which may impact performance;" +
+                    " consider increasing the value of [xpack.security.dls.bitset.cache.size]"
+            ));
+
+            runTestOnIndex((shardContext, leafContext) -> {
+                for (int i = 1; i <= 3; i++) {
+                    final TermQueryBuilder queryBuilder = QueryBuilders.termQuery("field-" + i, "value-" + i);
+                    final Query query = queryBuilder.toQuery(shardContext);
+                    final BitSet bitSet = cache.getBitSet(query, leafContext);
+                    assertThat(bitSet, notNullValue());
+                    assertThat(bitSet.ramBytesUsed(), equalTo(expectedBytesPerBitSet));
+                }
+            });
+
+            mockAppender.assertAllExpectationsMatched();
+        } finally {
+            Loggers.removeAppender(cacheLogger, mockAppender);
+            mockAppender.stop();
+        }
+    }
+
     public void testCacheRespectsAccessTimeExpiry() throws Exception {
         final Settings settings = Settings.builder()
             .put(DocumentSubsetBitsetCache.CACHE_TTL_SETTING.getKey(), "10ms")

From 34401a2c087b1fd4e33d96fe0a17ac41c689e403 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Mon, 13 Jan 2020 18:13:20 +1100
Subject: [PATCH 517/686] Add max_resource_units to enterprise license (#50735)

The enterprise license type must has "max_resource_units" and may not
have "max_nodes".

This change adds support for this new field, validation that the field
is present if-and-only-if the license is enterprise and bumps the
license version number to reflect the new field.
---
 docs/reference/licensing/get-license.asciidoc |   1 +
 .../org/elasticsearch/license/License.java    | 129 +++++++++----
 .../elasticsearch/license/LicenseService.java |   8 +-
 .../elasticsearch/license/LicenseUtils.java   |  17 +-
 .../license/StartTrialClusterTask.java        |   6 +-
 .../AbstractLicenseServiceTestCase.java       |   1 +
 .../LicenseOperationModeUpdateTests.java      |  22 ++-
 .../license/LicenseServiceTests.java          |   3 +-
 .../elasticsearch/license/LicenseTests.java   | 172 ++++++++++++++++--
 .../license/LicenseUtilsTests.java            |   5 +
 .../ClusterStatsMonitoringDocTests.java       |   1 +
 .../test/license/20_put_license.yml           |  12 +-
 .../test/license/30_enterprise_license.yml    |  12 +-
 13 files changed, 307 insertions(+), 82 deletions(-)

diff --git a/docs/reference/licensing/get-license.asciidoc b/docs/reference/licensing/get-license.asciidoc
index 807a40729f9fd..34f12ef514406 100644
--- a/docs/reference/licensing/get-license.asciidoc
+++ b/docs/reference/licensing/get-license.asciidoc
@@ -60,6 +60,7 @@ GET /_license
     "expiry_date" : "2018-11-19T22:05:12.332Z",
     "expiry_date_in_millis" : 1542665112332,
     "max_nodes" : 1000,
+    "max_resource_units" : null,
     "issued_to" : "test",
     "issuer" : "elasticsearch",
     "start_date_in_millis" : -1
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/License.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/License.java
index 004c9ff987764..210beaaedecaf 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/License.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/License.java
@@ -113,13 +113,19 @@ static boolean isBasic(String typeName) {
         static boolean isTrial(String typeName) {
             return TRIAL.getTypeName().equals(typeName);
         }
+
+        static boolean isEnterprise(String typeName) {
+            return ENTERPRISE.getTypeName().equals(typeName);
+        }
+
     }
 
     public static final int VERSION_START = 1;
     public static final int VERSION_NO_FEATURE_TYPE = 2;
     public static final int VERSION_START_DATE = 3;
     public static final int VERSION_CRYPTO_ALGORITHMS = 4;
-    public static final int VERSION_CURRENT = VERSION_CRYPTO_ALGORITHMS;
+    public static final int VERSION_ENTERPRISE = 5;
+    public static final int VERSION_CURRENT = VERSION_ENTERPRISE;
 
     /**
      * XContent param name to deserialize license(s) with
@@ -153,13 +159,14 @@ static boolean isTrial(String typeName) {
     private final long expiryDate;
     private final long startDate;
     private final int maxNodes;
+    private final int maxResourceUnits;
     private final OperationMode operationMode;
 
     /**
      * Decouples operation mode of a license from the license type value.
      * <p>
      * Note: The mode indicates features that should be made available, but it does not indicate whether the license is active!
-     *
+     * <p>
      * The id byte is used for ordering operation modes
      */
     public enum OperationMode {
@@ -176,13 +183,16 @@ public enum OperationMode {
             this.id = id;
         }
 
-        /** Returns non-zero positive number when <code>opMode1</code> is greater than <code>opMode2</code> */
+        /**
+         * Returns non-zero positive number when <code>opMode1</code> is greater than <code>opMode2</code>
+         */
         public static int compare(OperationMode opMode1, OperationMode opMode2) {
             return Integer.compare(opMode1.id, opMode2.id);
         }
 
         /**
          * Determine the operating mode for a license type
+         *
          * @see LicenseType#resolve(License)
          * @see #parse(String)
          */
@@ -211,6 +221,7 @@ public static OperationMode resolve(LicenseType type) {
          * Parses an {@code OperatingMode} from a String.
          * The string must name an operating mode, and not a licensing level (that is, it cannot parse old style license levels
          * such as "dev" or "silver").
+         *
          * @see #description()
          */
         public static OperationMode parse(String mode) {
@@ -227,8 +238,8 @@ public String description() {
         }
     }
 
-    private License(int version, String uid, String issuer, String issuedTo, long issueDate, String type,
-                    String subscriptionType, String feature, String signature, long expiryDate, int maxNodes, long startDate) {
+    private License(int version, String uid, String issuer, String issuedTo, long issueDate, String type, String subscriptionType,
+                    String feature, String signature, long expiryDate, int maxNodes, int maxResourceUnits, long startDate) {
         this.version = version;
         this.uid = uid;
         this.issuer = issuer;
@@ -246,6 +257,7 @@ private License(int version, String uid, String issuer, String issuedTo, long is
             this.expiryDate = expiryDate;
         }
         this.maxNodes = maxNodes;
+        this.maxResourceUnits = maxResourceUnits;
         this.startDate = startDate;
         this.operationMode = OperationMode.resolve(LicenseType.resolve(this));
         validate();
@@ -294,12 +306,21 @@ public long expiryDate() {
     }
 
     /**
-     * @return the maximum number of nodes this license has been issued for
+     * @return the maximum number of nodes this license has been issued for, or {@code -1} if this license is not node based.
      */
     public int maxNodes() {
         return maxNodes;
     }
 
+    /**
+     * @return the maximum number of "resource units" this license has been issued for, or {@code -1} if this license is not resource based.
+     * A "resource unit" is a measure of computing power (RAM/CPU), the definition of which is maintained outside of the license format,
+     * or this class.
+     */
+    public int maxResourceUnits() {
+        return maxResourceUnits;
+    }
+
     /**
      * @return a string representing the entity this licenses has been issued to
      */
@@ -386,20 +407,39 @@ private void validate() {
             throw new IllegalStateException("uid can not be null");
         } else if (feature == null && version == VERSION_START) {
             throw new IllegalStateException("feature can not be null");
-        } else if (maxNodes == -1) {
-            throw new IllegalStateException("maxNodes has to be set");
         } else if (expiryDate == -1) {
             throw new IllegalStateException("expiryDate has to be set");
         } else if (expiryDate == LicenseService.BASIC_SELF_GENERATED_LICENSE_EXPIRATION_MILLIS && LicenseType.isBasic(type) == false) {
             throw new IllegalStateException("only basic licenses are allowed to have no expiration");
         }
+
+        if (LicenseType.isEnterprise(type) && version < VERSION_ENTERPRISE) {
+            throw new IllegalStateException("license type [" + type + "] is not a valid for version [" + version + "] licenses");
+        }
+        validateLimits(type, maxNodes, maxResourceUnits);
+    }
+
+    private static void validateLimits(String type, int maxNodes, int maxResourceUnits) {
+        if (LicenseType.isEnterprise(type)) {
+            if (maxResourceUnits == -1) {
+                throw new IllegalStateException("maxResourceUnits must be set for enterprise licenses (type=[" + type + "])");
+            } else if (maxNodes != -1) {
+                throw new IllegalStateException("maxNodes may not be set for enterprise licenses (type=[" + type + "])");
+            }
+        } else {
+            if (maxNodes == -1) {
+                throw new IllegalStateException("maxNodes has to be set");
+            } else if (maxResourceUnits != -1) {
+                throw new IllegalStateException("maxResourceUnits may only be set for enterprise licenses (not permitted for type=[" +
+                    type + "])");
+            }
+        }
     }
 
     public static License readLicense(StreamInput in) throws IOException {
         int version = in.readVInt(); // Version for future extensibility
         if (version > VERSION_CURRENT) {
-            throw new ElasticsearchException("Unknown license version found, please upgrade all nodes to the latest elasticsearch-license" +
-                    " plugin");
+            throw new ElasticsearchException("Unknown license version found, please upgrade all nodes to the latest elasticsearch release");
         }
         Builder builder = builder();
         builder.version(version);
@@ -414,6 +454,9 @@ public static License readLicense(StreamInput in) throws IOException {
         }
         builder.expiryDate(in.readLong());
         builder.maxNodes(in.readInt());
+        if (version >= VERSION_ENTERPRISE) {
+            builder.maxResourceUnits(in.readInt());
+        }
         builder.issuedTo(in.readString());
         builder.issuer(in.readString());
         builder.signature(in.readOptionalString());
@@ -436,6 +479,9 @@ public void writeTo(StreamOutput out) throws IOException {
         }
         out.writeLong(expiryDate);
         out.writeInt(maxNodes);
+        if (version >= VERSION_ENTERPRISE) {
+            out.writeInt(maxResourceUnits);
+        }
         out.writeString(issuedTo);
         out.writeString(issuer);
         out.writeOptionalString(signature);
@@ -496,7 +542,14 @@ public XContentBuilder toInnerXContent(XContentBuilder builder, Params params) t
         if (expiryDate != LicenseService.BASIC_SELF_GENERATED_LICENSE_EXPIRATION_MILLIS) {
             builder.timeField(Fields.EXPIRY_DATE_IN_MILLIS, Fields.EXPIRY_DATE, expiryDate);
         }
-        builder.field(Fields.MAX_NODES, maxNodes);
+
+        if (version >= VERSION_ENTERPRISE) {
+            builder.field(Fields.MAX_NODES, maxNodes == -1 ? null : maxNodes);
+            builder.field(Fields.MAX_RESOURCE_UNITS, maxResourceUnits == -1 ? null : maxResourceUnits);
+        } else {
+            builder.field(Fields.MAX_NODES, maxNodes);
+        }
+
         builder.field(Fields.ISSUED_TO, issuedTo);
         builder.field(Fields.ISSUER, issuer);
         if (!licenseSpecMode && !restViewMode && signature != null) {
@@ -541,6 +594,8 @@ public static License fromXContent(XContentParser parser) throws IOException {
                         builder.startDate(parser.longValue());
                     } else if (Fields.MAX_NODES.equals(currentFieldName)) {
                         builder.maxNodes(parser.intValue());
+                    } else if (Fields.MAX_RESOURCE_UNITS.equals(currentFieldName)) {
+                        builder.maxResourceUnits(parser.intValue());
                     } else if (Fields.ISSUED_TO.equals(currentFieldName)) {
                         builder.issuedTo(parser.text());
                     } else if (Fields.ISSUER.equals(currentFieldName)) {
@@ -583,7 +638,7 @@ public static License fromXContent(XContentParser parser) throws IOException {
                 throw new ElasticsearchException("malformed signature for license [" + builder.uid + "]");
             } else if (version > VERSION_CURRENT) {
                 throw new ElasticsearchException("Unknown license version found, please upgrade all nodes to the latest " +
-                        "elasticsearch-license plugin");
+                    "elasticsearch-license plugin");
             }
             // signature version is the source of truth
             builder.version(version);
@@ -615,8 +670,7 @@ public static License fromSource(BytesReference bytes, XContentType xContentType
         // EMPTY is safe here because we don't call namedObject
         try (InputStream byteStream = bytes.streamInput();
              XContentParser parser = xContentType.xContent()
-                .createParser(NamedXContentRegistry.EMPTY, LoggingDeprecationHandler.INSTANCE, byteStream))
-        {
+                 .createParser(NamedXContentRegistry.EMPTY, LoggingDeprecationHandler.INSTANCE, byteStream)) {
             License license = null;
             if (parser.nextToken() == XContentParser.Token.START_OBJECT) {
                 if (parser.nextToken() == XContentParser.Token.FIELD_NAME) {
@@ -665,7 +719,7 @@ public boolean equals(Object o) {
 
         if (issueDate != license.issueDate) return false;
         if (expiryDate != license.expiryDate) return false;
-        if (startDate!= license.startDate) return false;
+        if (startDate != license.startDate) return false;
         if (maxNodes != license.maxNodes) return false;
         if (version != license.version) return false;
         if (uid != null ? !uid.equals(license.uid) : license.uid != null) return false;
@@ -690,7 +744,7 @@ public int hashCode() {
         result = 31 * result + (feature != null ? feature.hashCode() : 0);
         result = 31 * result + (signature != null ? signature.hashCode() : 0);
         result = 31 * result + (int) (expiryDate ^ (expiryDate >>> 32));
-        result = 31 * result + (int) (startDate ^ (startDate>>> 32));
+        result = 31 * result + (int) (startDate ^ (startDate >>> 32));
         result = 31 * result + maxNodes;
         result = 31 * result + version;
         return result;
@@ -709,6 +763,7 @@ public static final class Fields {
         public static final String START_DATE_IN_MILLIS = "start_date_in_millis";
         public static final String START_DATE = "start_date";
         public static final String MAX_NODES = "max_nodes";
+        public static final String MAX_RESOURCE_UNITS = "max_resource_units";
         public static final String ISSUED_TO = "issued_to";
         public static final String ISSUER = "issuer";
         public static final String VERSION = "version";
@@ -752,6 +807,7 @@ public static class Builder {
         private long expiryDate = -1;
         private long startDate = -1;
         private int maxNodes = -1;
+        private int maxResourceUnits = -1;
 
         public Builder uid(String uid) {
             this.uid = uid;
@@ -807,6 +863,11 @@ public Builder maxNodes(int maxNodes) {
             return this;
         }
 
+        public Builder maxResourceUnits(int maxUnits) {
+            this.maxResourceUnits = maxUnits;
+            return this;
+        }
+
         public Builder signature(String signature) {
             if (signature != null) {
                 this.signature = signature;
@@ -821,17 +882,18 @@ public Builder startDate(long startDate) {
 
         public Builder fromLicenseSpec(License license, String signature) {
             return uid(license.uid())
-                    .version(license.version())
-                    .issuedTo(license.issuedTo())
-                    .issueDate(license.issueDate())
-                    .startDate(license.startDate())
-                    .type(license.type())
-                    .subscriptionType(license.subscriptionType)
-                    .feature(license.feature)
-                    .maxNodes(license.maxNodes())
-                    .expiryDate(license.expiryDate())
-                    .issuer(license.issuer())
-                    .signature(signature);
+                .version(license.version())
+                .issuedTo(license.issuedTo())
+                .issueDate(license.issueDate())
+                .startDate(license.startDate())
+                .type(license.type())
+                .subscriptionType(license.subscriptionType)
+                .feature(license.feature)
+                .maxNodes(license.maxNodes())
+                .maxResourceUnits(license.maxResourceUnits())
+                .expiryDate(license.expiryDate())
+                .issuer(license.issuer())
+                .signature(signature);
         }
 
         /**
@@ -840,15 +902,15 @@ public Builder fromLicenseSpec(License license, String signature) {
          */
         public Builder fromPre20LicenseSpec(License pre20License) {
             return uid(pre20License.uid())
-                    .issuedTo(pre20License.issuedTo())
-                    .issueDate(pre20License.issueDate())
-                    .maxNodes(pre20License.maxNodes())
-                    .expiryDate(pre20License.expiryDate());
+                .issuedTo(pre20License.issuedTo())
+                .issueDate(pre20License.issueDate())
+                .maxNodes(pre20License.maxNodes())
+                .expiryDate(pre20License.expiryDate());
         }
 
         public License build() {
             return new License(version, uid, issuer, issuedTo, issueDate, type,
-                    subscriptionType, feature, signature, expiryDate, maxNodes, startDate);
+                subscriptionType, feature, signature, expiryDate, maxNodes, maxResourceUnits, startDate);
         }
 
         public Builder validate() {
@@ -864,11 +926,10 @@ public Builder validate() {
                 throw new IllegalStateException("uid can not be null");
             } else if (signature == null) {
                 throw new IllegalStateException("signature can not be null");
-            } else if (maxNodes == -1) {
-                throw new IllegalStateException("maxNodes has to be set");
             } else if (expiryDate == -1) {
                 throw new IllegalStateException("expiryDate has to be set");
             }
+            validateLimits(type, maxNodes, maxResourceUnits);
             return this;
         }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
index 8168445f8c3ad..515f8462f98aa 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseService.java
@@ -121,6 +121,7 @@ public class LicenseService extends AbstractLifecycleComponent implements Cluste
      * Max number of nodes licensed by generated trial license
      */
     static final int SELF_GENERATED_LICENSE_MAX_NODES = 1000;
+    static final int SELF_GENERATED_LICENSE_MAX_RESOURCE_UNITS = SELF_GENERATED_LICENSE_MAX_NODES;
 
     public static final String LICENSE_JOB = "licenseJob";
 
@@ -291,11 +292,8 @@ public ClusterState execute(ClusterState currentState) throws Exception {
     }
 
     private static boolean licenseIsCompatible(License license, Version version) {
-        if (License.LicenseType.ENTERPRISE.getTypeName().equalsIgnoreCase(license.type())) {
-            return version.onOrAfter(Version.V_7_6_0);
-        } else {
-            return true;
-        }
+        final int maxVersion = LicenseUtils.getMaxLicenseVersion(version);
+        return license.version() <= maxVersion;
     }
 
     private boolean isAllowedLicenseType(License.LicenseType type) {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseUtils.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseUtils.java
index dd4cb1ae6a589..66fd005614017 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseUtils.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/LicenseUtils.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.license;
 
 import org.elasticsearch.ElasticsearchSecurityException;
+import org.elasticsearch.Version;
 import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.license.License.LicenseType;
 import org.elasticsearch.rest.RestStatus;
@@ -46,18 +47,26 @@ public static boolean licenseNeedsExtended(License license) {
      * recreated with the new key
      */
     public static boolean signatureNeedsUpdate(License license, DiscoveryNodes currentNodes) {
-        assert License.VERSION_CRYPTO_ALGORITHMS == License.VERSION_CURRENT : "update this method when adding a new version";
+        assert License.VERSION_ENTERPRISE == License.VERSION_CURRENT : "update this method when adding a new version";
 
         String typeName = license.type();
         return (LicenseType.isBasic(typeName) || LicenseType.isTrial(typeName)) &&
                 // only upgrade signature when all nodes are ready to deserialize the new signature
                 (license.version() < License.VERSION_CRYPTO_ALGORITHMS &&
-                    compatibleLicenseVersion(currentNodes) == License.VERSION_CRYPTO_ALGORITHMS
+                    compatibleLicenseVersion(currentNodes) >= License.VERSION_CRYPTO_ALGORITHMS
                 );
     }
 
     public static int compatibleLicenseVersion(DiscoveryNodes currentNodes) {
-        assert License.VERSION_CRYPTO_ALGORITHMS == License.VERSION_CURRENT : "update this method when adding a new version";
-        return License.VERSION_CRYPTO_ALGORITHMS;
+        return getMaxLicenseVersion(currentNodes.getMinNodeVersion());
+    }
+
+    public static int getMaxLicenseVersion(Version version) {
+        if (version != null && version.before(Version.V_7_6_0)) {
+            return License.VERSION_CRYPTO_ALGORITHMS;
+        } else {
+            assert License.VERSION_ENTERPRISE == License.VERSION_CURRENT : "update this method when adding a new version";
+            return License.VERSION_ENTERPRISE;
+        }
     }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/StartTrialClusterTask.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/StartTrialClusterTask.java
index 98fb6115710e3..c2d23ebf47aa7 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/license/StartTrialClusterTask.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/license/StartTrialClusterTask.java
@@ -75,10 +75,14 @@ public ClusterState execute(ClusterState currentState) throws Exception {
             License.Builder specBuilder = License.builder()
                     .uid(UUID.randomUUID().toString())
                     .issuedTo(clusterName)
-                    .maxNodes(LicenseService.SELF_GENERATED_LICENSE_MAX_NODES)
                     .issueDate(issueDate)
                     .type(request.getType())
                     .expiryDate(expiryDate);
+            if (License.LicenseType.isEnterprise(request.getType())) {
+                specBuilder.maxResourceUnits(LicenseService.SELF_GENERATED_LICENSE_MAX_RESOURCE_UNITS);
+            } else {
+                specBuilder.maxNodes(LicenseService.SELF_GENERATED_LICENSE_MAX_NODES);
+            }
             License selfGeneratedLicense = SelfGeneratedLicense.create(specBuilder, currentState.nodes());
             LicensesMetaData newLicensesMetaData = new LicensesMetaData(selfGeneratedLicense, Version.CURRENT);
             mdBuilder.putCustom(LicensesMetaData.TYPE, newLicensesMetaData);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/AbstractLicenseServiceTestCase.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/AbstractLicenseServiceTestCase.java
index 5bc33ae330a18..aa482707e286c 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/AbstractLicenseServiceTestCase.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/AbstractLicenseServiceTestCase.java
@@ -70,6 +70,7 @@ protected void setInitialState(License license, XPackLicenseState licenseState,
         when(discoveryNodes.getMasterNode()).thenReturn(mockNode);
         when(discoveryNodes.spliterator()).thenReturn(Arrays.asList(mockNode).spliterator());
         when(discoveryNodes.isLocalNodeElectedMaster()).thenReturn(false);
+        when(discoveryNodes.getMinNodeVersion()).thenReturn(mockNode.getVersion());
         when(state.nodes()).thenReturn(discoveryNodes);
         when(state.getNodes()).thenReturn(discoveryNodes); // it is really ridiculous we have nodes() and getNodes()...
         when(clusterService.state()).thenReturn(state);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeUpdateTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeUpdateTests.java
index 20df885261fed..2ef2438123650 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeUpdateTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseOperationModeUpdateTests.java
@@ -35,15 +35,19 @@ public void init() throws Exception {
 
     public void testLicenseOperationModeUpdate() throws Exception {
         License.LicenseType type = randomFrom(License.LicenseType.values());
-        License license = License.builder()
-                .uid("id")
-                .expiryDate(0)
-                .issueDate(0)
-                .issuedTo("elasticsearch")
-                .issuer("issuer")
-                .type(type)
-                .maxNodes(1)
-                .build();
+        final License.Builder licenseBuilder = License.builder()
+            .uid("id")
+            .expiryDate(0)
+            .issueDate(0)
+            .issuedTo("elasticsearch")
+            .issuer("issuer")
+            .type(type);
+        if (type == License.LicenseType.ENTERPRISE) {
+            licenseBuilder.maxResourceUnits(1);
+        } else {
+            licenseBuilder.maxNodes(1);
+        }
+        License license = licenseBuilder.build();
 
         assertThat(license.operationMode(), equalTo(License.OperationMode.resolve(type)));
         OperationModeFileWatcherTests.writeMode("gold", licenseModeFile);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseServiceTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseServiceTests.java
index b1b22f15c259f..0f465834ad553 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseServiceTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseServiceTests.java
@@ -190,7 +190,8 @@ private License buildLicense(License.LicenseType type, TimeValue expires) {
             .issuer(randomAlphaOfLengthBetween(5, 60))
             .issuedTo(randomAlphaOfLengthBetween(5, 60))
             .issueDate(System.currentTimeMillis() - TimeUnit.MINUTES.toMillis(randomLongBetween(1, 5000)))
-            .maxNodes(randomIntBetween(1, 500))
+            .maxNodes(type == License.LicenseType.ENTERPRISE ? -1 : randomIntBetween(1, 500))
+            .maxResourceUnits(type == License.LicenseType.ENTERPRISE ? randomIntBetween(10, 500) : -1)
             .signature(null)
             .build();
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseTests.java
index aa209f9a520ac..05f54383eedd3 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseTests.java
@@ -6,13 +6,18 @@
 package org.elasticsearch.license;
 
 import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.bytes.BytesArray;
+import org.elasticsearch.common.io.stream.BytesStreamOutput;
+import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.TestMatchers;
+import org.hamcrest.Matchers;
 
 import java.nio.BufferUnderflowException;
 import java.nio.charset.StandardCharsets;
@@ -27,7 +32,7 @@
 
 public class LicenseTests extends ESTestCase {
 
-    public void testFromXContent() throws Exception {
+    public void testFromXContentForGoldLicenseWithVersion2Signature() throws Exception {
         String licenseString = "{\"license\":" +
             "{\"uid\":\"4056779d-b823-4c12-a9cb-efa4a8d8c422\"," +
             "\"type\":\"gold\"," +
@@ -51,27 +56,107 @@ public void testFromXContent() throws Exception {
         assertThat(license.issuedTo(), equalTo("customer"));
         assertThat(license.expiryDate(), equalTo(1546596340459L));
         assertThat(license.issueDate(), equalTo(1546589020459L));
+        assertThat(license.maxNodes(), equalTo(5));
+        assertThat(license.maxResourceUnits(), equalTo(-1));
+        assertThat(license.version(), equalTo(2));
+    }
+
+    public void testFromXContentForGoldLicenseWithVersion4Signature() throws Exception {
+        String licenseString = "{\"license\":{" +
+            "\"uid\":\"4056779d-b823-4c12-a9cb-efa4a8d8c422\"," +
+            "\"type\":\"gold\"," +
+            "\"issue_date_in_millis\":1546589020459," +
+            "\"expiry_date_in_millis\":1546596340459," +
+            "\"max_nodes\":5," +
+            "\"issued_to\":\"customer\"," +
+            "\"issuer\":\"elasticsearch\"," +
+            "\"signature\":\"AAAABAAAAA22vXffI41oM4jLCwZ6AAAAIAo5/x6hrsGh1GqqrJmy4qgmEC7gK0U4zQ6q5ZEMhm4jAAABAH3oL4weubwYGjLGNZsz90" +
+            "EerX6yOX3Dh6wswG9EfqCiyv6lcjuC7aeKKuOkqhMRTHZ9vHnfMuakHWVlpuGC14WyGqaMwSmgTZ9jVAzt/W3sIotRxM/3rtlCXUc1rOUXNFcii1i3Kkrc" +
+            "kTzhENTKjdkOmUN3qZlTEmHkp93eYpx8++iIukHYU9K9Vm2VKgydFfxvYaN/Qr+iPfJSbHJB8+DmS2ywdrmdqW+ScE+1ZNouPNhnP3RKTleNvixXPG9l5B" +
+            "qZ2So1IlCrxVDByA1E6JH5AvjbOucpcGiWCm7IzvfpkzphKHMyxhUaIByoHl9UAf4AdPLhowWAQk0eHMRDDlo=\"," +
+            "\"start_date_in_millis\":-1}}\n";
+        License license = License.fromSource(new BytesArray(licenseString.getBytes(StandardCharsets.UTF_8)),
+            XContentType.JSON);
+        assertThat(license.type(), equalTo("gold"));
+        assertThat(license.uid(), equalTo("4056779d-b823-4c12-a9cb-efa4a8d8c422"));
+        assertThat(license.issuer(), equalTo("elasticsearch"));
+        assertThat(license.issuedTo(), equalTo("customer"));
+        assertThat(license.expiryDate(), equalTo(1546596340459L));
+        assertThat(license.issueDate(), equalTo(1546589020459L));
+        assertThat(license.maxNodes(), equalTo(5));
+        assertThat(license.maxResourceUnits(), equalTo(-1));
+        assertThat(license.version(), equalTo(4));
+    }
+
+    public void testFromXContentForEnterpriseLicenseWithV5Signature() throws Exception {
+        String licenseString = "{\"license\":{" +
+            "\"uid\":\"4056779d-b823-4c12-a9cb-efa4a8d8c422\"," +
+            "\"type\":\"enterprise\"," +
+            "\"issue_date_in_millis\":1546589020459," +
+            "\"expiry_date_in_millis\":1546596340459," +
+            "\"max_nodes\":null," +
+            "\"max_resource_units\":15," +
+            "\"issued_to\":\"customer\"," +
+            "\"issuer\":\"elasticsearch\"," +
+            "\"signature\":\"AAAABQAAAA2MUoEqXb9K9Ie5d6JJAAAAIAo5/x6hrsGh1GqqrJmy4qgmEC7gK0U4zQ6q5ZEMhm4jAAABAAAwVZKGAmDELUlS5PScBkhQsZa" +
+            "DaQTtJ4ZP5EnZ/nLpmCt9Dj7d/FRsgMtHmSJLrr2CdrIo4Vx5VuhmbwzZvXMttLz2lrJzG7770PX3TnC9e7F9GdnE9ec0FP2U0ZlLOBOtPuirX0q+j6GfB+DLyE" +
+            "5D+Lo1NQ3eLJGvbd3DBYPWJxkb+EBVHczCH2OrIEVWnN/TafmkdZCPX5PcultkNOs3j7d3s7b51EXHKoye8UTcB/RGmzZwMah+E6I/VJkqu7UHL8bB01wJeqo6W" +
+            "xI4LC/9+f5kpmHrUu3CHe5pHbmMGDk7O6/cwt1pw/hnJXKIFCi36IGaKcHLgORxQdN0uzE=\"," +
+            "\"start_date_in_millis\":-1}}";
+        License license = License.fromSource(new BytesArray(licenseString.getBytes(StandardCharsets.UTF_8)),
+            XContentType.JSON);
+        assertThat(license.type(), equalTo("enterprise"));
+        assertThat(license.uid(), equalTo("4056779d-b823-4c12-a9cb-efa4a8d8c422"));
+        assertThat(license.issuer(), equalTo("elasticsearch"));
+        assertThat(license.issuedTo(), equalTo("customer"));
+        assertThat(license.expiryDate(), equalTo(1546596340459L));
+        assertThat(license.issueDate(), equalTo(1546589020459L));
+        assertThat(license.maxNodes(), equalTo(-1));
+        assertThat(license.maxResourceUnits(), equalTo(15));
+        assertThat(license.version(), equalTo(5));
+    }
+
+    public void testThatEnterpriseLicenseMayNotHaveMaxNodes() throws Exception {
+        License.Builder builder = randomLicense(License.LicenseType.ENTERPRISE)
+            .maxNodes(randomIntBetween(1, 50))
+            .maxResourceUnits(randomIntBetween(10, 500));
+        final IllegalStateException ex = expectThrows(IllegalStateException.class, builder::build);
+        assertThat(ex, TestMatchers.throwableWithMessage("maxNodes may not be set for enterprise licenses (type=[enterprise])"));
+    }
+
+    public void testThatEnterpriseLicenseMustHaveMaxResourceUnits() throws Exception {
+        License.Builder builder = randomLicense(License.LicenseType.ENTERPRISE)
+            .maxResourceUnits(-1);
+        final IllegalStateException ex = expectThrows(IllegalStateException.class, builder::build);
+        assertThat(ex, TestMatchers.throwableWithMessage("maxResourceUnits must be set for enterprise licenses (type=[enterprise])"));
+    }
+
+    public void testThatRegularLicensesMustHaveMaxNodes() throws Exception {
+        License.LicenseType type = randomValueOtherThan(License.LicenseType.ENTERPRISE, () -> randomFrom(License.LicenseType.values()));
+        License.Builder builder = randomLicense(type)
+            .maxNodes(-1);
+        final IllegalStateException ex = expectThrows(IllegalStateException.class, builder::build);
+        assertThat(ex, TestMatchers.throwableWithMessage("maxNodes has to be set"));
+    }
+
+    public void testThatRegularLicensesMayNotHaveMaxResourceUnits() throws Exception {
+        License.LicenseType type = randomValueOtherThan(License.LicenseType.ENTERPRISE, () -> randomFrom(License.LicenseType.values()));
+        License.Builder builder = randomLicense(type)
+            .maxResourceUnits(randomIntBetween(10, 500))
+            .maxNodes(randomIntBetween(1, 50));
+        final IllegalStateException ex = expectThrows(IllegalStateException.class, builder::build);
+        assertThat(ex, TestMatchers.throwableWithMessage("maxResourceUnits may only be set for enterprise licenses (not permitted " +
+            "for type=[" + type.getTypeName() + "])"));
     }
 
     public void testLicenseToAndFromXContentForEveryLicenseType() throws Exception {
         for (License.LicenseType type : License.LicenseType.values()) {
-            final License license1 = License.builder()
-                .uid(UUIDs.randomBase64UUID(random()))
-                .type(type)
-                .issueDate(System.currentTimeMillis() - TimeUnit.DAYS.toMillis(randomIntBetween(1, 10)))
-                .expiryDate(System.currentTimeMillis() + TimeUnit.DAYS.toMillis(randomIntBetween(1, 1000)))
-                .maxNodes(randomIntBetween(1, 100))
-                .issuedTo(randomAlphaOfLengthBetween(5, 50))
-                .issuer(randomAlphaOfLengthBetween(5, 50))
+            final License license1 = randomLicense(type)
                 // We need a signature that parses correctly, but it doesn't need to verify
-                .signature("AAAAAgAAAA34V2kfTJVtvdL2LttwAAABmFJ6NGRnbEM3WVQrZVQwNkdKQmR1VytlMTMyM1J0dTZ1WGwyY2ZCVFhqMGtJU2gzZ3pnNTVpOW" +
-                    "F5Y1NaUkwyN2VsTEtCYnlZR2c5WWtjQ0phaDlhRjlDUXViUmUwMWhjSkE2TFcwSGdneTJHbUV4N2RHUWJxV20ybjRsZHRzV2xkN0ZmdDlYblJmNVc" +
-                    "xMlBWeU81V1hLUm1EK0V1dmF3cFdlSGZzTU5SZE1qUmFra3JkS1hCanBWVmVTaFFwV3BVZERzeG9Sci9rYnlJK2toODZXY09tNmFHUVNUL3IyUHEx" +
-                    "V3VSTlBneWNJcFQ0bXl0cmhNNnRwbE1CWE4zWjJ5eGFuWFo0NGhsb3B5WFd1eTdYbFFWQkxFVFFPSlBERlB0eVVJYXVSZ0lsR2JpRS9rN1h4MSsvN" +
-                    "UpOcGN6cU1NOHN1cHNtSTFIUGN1bWNGNEcxekhrblhNOXZ2VEQvYmRzQUFwbytUZEpRR3l6QU5oS2ZFSFdSbGxxNDZyZ0xvUHIwRjdBL2JqcnJnNG" +
-                    "FlK09Cek9pYlJ5Umc9PQAAAQAth77fQLF7CCEL7wA6Z0/UuRm/weECcsjW/50kBnPLO8yEs+9/bPa5LSU0bF6byEXOVeO0ebUQfztpjulbXh8TrBD" +
-                    "SG+6VdxGtohPo2IYPBaXzGs3LOOor6An/lhptxBWdwYmfbcp0m8mnXZh1vN9rmbTsZXnhBIoPTaRDwUBi3vJ3Ms3iLaEm4S8Slrfmtht2jUjgGZ2v" +
-                    "AeZ9OHU2YsGtrSpz6f")
+                .signature("AAAABQAAAA2MUoEqXb9K9Ie5d6JJAAAAIAo5/x6hrsGh1GqqrJmy4qgmEC7gK0U4zQ6q5ZEMhm4jAAABAAAwVZKGAmDELUlS5PScBkhQsZa" +
+                    "DaQTtJ4ZP5EnZ/nLpmCt9Dj7d/FRsgMtHmSJLrr2CdrIo4Vx5VuhmbwzZvXMttLz2lrJzG7770PX3TnC9e7F9GdnE9ec0FP2U0ZlLOBOtPuirX0q+j" +
+                    "6GfB+DLyE5D+Lo1NQ3eLJGvbd3DBYPWJxkb+EBVHczCH2OrIEVWnN/TafmkdZCPX5PcultkNOs3j7d3s7b51EXHKoye8UTcB/RGmzZwMah+E6I/VJk" +
+                    "qu7UHL8bB01wJeqo6WxI4LC/9+f5kpmHrUu3CHe5pHbmMGDk7O6/cwt1pw/hnJXKIFCi36IGaKcHLgORxQdN0uzE=")
                 .build();
             XContentParser parser = XContentType.JSON.xContent().createParser(NamedXContentRegistry.EMPTY, THROW_UNSUPPORTED_OPERATION,
                 Strings.toString(license1));
@@ -83,6 +168,46 @@ public void testLicenseToAndFromXContentForEveryLicenseType() throws Exception {
             assertThat(license2.issuedTo(), equalTo(license1.issuedTo()));
             assertThat(license2.expiryDate(), equalTo(license1.expiryDate()));
             assertThat(license2.issueDate(), equalTo(license1.issueDate()));
+            assertThat(license2.maxNodes(), equalTo(license1.maxNodes()));
+            assertThat(license2.maxResourceUnits(), equalTo(license1.maxResourceUnits()));
+        }
+    }
+
+    public void testSerializationOfLicenseForEveryLicenseType() throws Exception {
+        for (License.LicenseType type : License.LicenseType.values()) {
+            final String signature = randomBoolean() ? null : "AAAABQAAAA2MUoEqXb9K9Ie5d6JJAAAAIAo5/x6hrsGh1GqqrJmy4qgmEC7gK0U4zQ6q5ZEM" +
+                "hm4jAAABAAAwVZKGAmDELUlS5PScBkhQsZaDaQTtJ4ZP5EnZ/nLpmCt9Dj7d/FRsgMtHmSJLrr2CdrIo4Vx5VuhmbwzZvXMttLz2lrJzG7770PX3TnC9e7" +
+                "F9GdnE9ec0FP2U0ZlLOBOtPuirX0q+j6GfB+DLyE5D+Lo1NQ3eLJGvbd3DBYPWJxkb+EBVHczCH2OrIEVWnN/TafmkdZCPX5PcultkNOs3j7d3s7b51EXH" +
+                "Koye8UTcB/RGmzZwMah+E6I/VJkqu7UHL8bB01wJeqo6WxI4LC/9+f5kpmHrUu3CHe5pHbmMGDk7O6/cwt1pw/hnJXKIFCi36IGaKcHLgORxQdN0uzE=";
+            final int version;
+            if (type == License.LicenseType.ENTERPRISE) {
+                version = randomIntBetween(License.VERSION_ENTERPRISE, License.VERSION_CURRENT);
+            } else {
+                version = randomIntBetween(License.VERSION_NO_FEATURE_TYPE, License.VERSION_CURRENT);
+            }
+
+            final License license1 = randomLicense(type).signature(signature).version(version).build();
+
+            final BytesStreamOutput out = new BytesStreamOutput();
+            out.setVersion(Version.CURRENT);
+            license1.writeTo(out);
+
+            final StreamInput in = out.bytes().streamInput();
+            in.setVersion(Version.CURRENT);
+            final License license2 = License.readLicense(in);
+            assertThat(in.read(), Matchers.equalTo(-1));
+
+            assertThat(license2, notNullValue());
+            assertThat(license2.type(), equalTo(type.getTypeName()));
+            assertThat(license2.version(), equalTo(version));
+            assertThat(license2.signature(), equalTo(signature));
+            assertThat(license2.uid(), equalTo(license1.uid()));
+            assertThat(license2.issuer(), equalTo(license1.issuer()));
+            assertThat(license2.issuedTo(), equalTo(license1.issuedTo()));
+            assertThat(license2.expiryDate(), equalTo(license1.expiryDate()));
+            assertThat(license2.issueDate(), equalTo(license1.issueDate()));
+            assertThat(license2.maxNodes(), equalTo(license1.maxNodes()));
+            assertThat(license2.maxResourceUnits(), equalTo(license1.maxResourceUnits()));
         }
     }
 
@@ -158,4 +283,17 @@ public void testUnableToBase64DecodeFromXContent() throws Exception {
         assertThat(exception.getMessage(), containsString("malformed signature for license [4056779d-b823-4c12-a9cb-efa4a8d8c422]"));
         assertThat(exception.getCause(), instanceOf(IllegalArgumentException.class));
     }
+
+    private License.Builder randomLicense(License.LicenseType type) {
+        return License.builder()
+            .uid(UUIDs.randomBase64UUID(random()))
+            .type(type)
+            .issueDate(System.currentTimeMillis() - TimeUnit.DAYS.toMillis(randomIntBetween(1, 10)))
+            .expiryDate(System.currentTimeMillis() + TimeUnit.DAYS.toMillis(randomIntBetween(1, 1000)))
+            .maxNodes(type == License.LicenseType.ENTERPRISE ? -1 : randomIntBetween(1, 100))
+            .maxResourceUnits(type == License.LicenseType.ENTERPRISE ? randomIntBetween(1, 100) : -1)
+            .issuedTo(randomAlphaOfLengthBetween(5, 50))
+            .issuer(randomAlphaOfLengthBetween(5, 50));
+    }
+
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseUtilsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseUtilsTests.java
index 26ed6f5e446db..1c96fef045a64 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseUtilsTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/license/LicenseUtilsTests.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.license;
 
 import org.elasticsearch.ElasticsearchSecurityException;
+import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.test.ESTestCase;
 
 import java.util.Arrays;
@@ -33,4 +34,8 @@ public void testIsLicenseExpiredException() {
         exception = new ElasticsearchSecurityException("msg");
         assertFalse(LicenseUtils.isLicenseExpiredException(exception));
     }
+
+    public void testVersionsUpToDate() {
+        assertThat(LicenseUtils.compatibleLicenseVersion(DiscoveryNodes.EMPTY_NODES), equalTo(License.VERSION_CURRENT));
+    }
 }
diff --git a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/collector/cluster/ClusterStatsMonitoringDocTests.java b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/collector/cluster/ClusterStatsMonitoringDocTests.java
index f7da3118c5e29..7dd46eb460cea 100644
--- a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/collector/cluster/ClusterStatsMonitoringDocTests.java
+++ b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/collector/cluster/ClusterStatsMonitoringDocTests.java
@@ -367,6 +367,7 @@ public void testToXContent() throws IOException {
                     + "\"expiry_date\":\"2017-08-07T12:03:22.133Z\","
                     + "\"expiry_date_in_millis\":1502107402133,"
                     + "\"max_nodes\":2,"
+                    + "\"max_resource_units\":null,"
                     + "\"issued_to\":\"customer\","
                     + "\"issuer\":\"elasticsearch\","
                     + "\"start_date_in_millis\":-1"
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/license/20_put_license.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/license/20_put_license.yml
index 0a3b2bc135b57..8b24d73fcb476 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/license/20_put_license.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/license/20_put_license.yml
@@ -20,8 +20,8 @@ teardown:
   - do:
       license.get: {}
 
-  ## a license object has 11 attributes
-  - length: { license: 11 }
+  ## a v5 license object has 12 attributes & the Rest API always outputs in current version
+  - length: { license: 12 }
 
   ## bwc for licenses format
   - do:
@@ -35,7 +35,7 @@ teardown:
   - do:
       license.get: {}
 
-  - length: { license: 11 }
+  - length: { license: 12 }
 
   ## license version: 1.x
   - do:
@@ -49,7 +49,7 @@ teardown:
   - do:
       license.get: {}
 
-  - length: { license: 11 }
+  - length: { license: 12 }
 
   ## multiple licenses version: 1.x
   - do:
@@ -63,7 +63,7 @@ teardown:
   - do:
       license.get: {}
 
-  - length: { license: 11 }
+  - length: { license: 12 }
   - match: { license.uid: "893361dc-9749-4997-93cb-802e3dofh7aa" }
 ---
 "Should throw 404 after license deletion":
@@ -91,7 +91,7 @@ teardown:
   - do:
       license.get: {}
 
-  - length: { license: 11 }
+  - length: { license: 12 }
 ---
 "Cannot start basic":
 
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/license/30_enterprise_license.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/license/30_enterprise_license.yml
index 5f4582c747b5b..9b0fd906f2930 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/license/30_enterprise_license.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/license/30_enterprise_license.yml
@@ -15,18 +15,20 @@ teardown:
       license.post:
         acknowledge: true
         body: |
-          {"license":{"uid":"6e57906b-a8d1-4c1f-acb7-73a16edc3934","type":"enterprise","issue_date_in_millis":1523456691721,"expiry_date_in_millis":1838816691721,"max_nodes":50,"issued_to":"rest-test","issuer":"elasticsearch","signature":"AAAABAAAAA03e8BZRVXaCV4CpPGRAAAAIAo5/x6hrsGh1GqqrJmy4qgmEC7gK0U4zQ6q5ZEMhm4jAAABAAZNhjABV6PRfa7P7sJgn70XCGoKtAVT75yU13JvKBd/UjD4TPhuZcztqZ/tcLEPxm/TSvGlogWmnw/Rw8xs8jMpBpKsJ+LOXjHhDdvXb2y7JJhCH8nlSEblMDRXysNvWpKe60Z/hb7hS4JynEUt0EBb6ji7BL42O07PNll1EGmkfsHazfs46iV91BG1VxXksI78XgWSaA0F/h7tvrNW9PTgsUaLo06InlQ8jA1dal90AoXp+MVDOHWQjVFZzUnO87/7lEb+VXt0IwchaW17ahihJqkCtGvKpWFwpuhx9xiFvkySN/g5LIVjYCvgBkiWExQ9p0Zzg3VoSlMBnVy0BWo=","start_date_in_millis":-1}}
+          {"license":{"uid":"6e57906b-a8d1-4c1f-acb7-73a16edc3934","type":"enterprise","issue_date_in_millis":1523456691721,"expiry_date_in_millis":1838816691721,"max_nodes":null,"max_resource_units":50,"issued_to":"rest-test","issuer":"elasticsearch","signature":"AAAABQAAAA0sKPJdf9T6DItbXVJKAAAAIAo5/x6hrsGh1GqqrJmy4qgmEC7gK0U4zQ6q5ZEMhm4jAAABAKFCHrix7w/xPG14+wdhld1RmphDmXmHfL1xeuI33Ahr1mOUYZ30eR6GZuh7CnK8BQhfq+z63lgctJepWlvwDSgkOvXWLHrJun7YSCrzz1bism0ZHWw7Swb9DO7vePomVBo/Hm9+eX0pV4/cFQNMmbFaX11tqJZYBEO6sNASVAFL7A1ZcVoB2evweGU9pUQYvFvmyzzySf99miDo3NH0XYdownEdtoNgFfmqa3+koCP7onmRZ1h9jhsDOi30RX/DTDXQKW+XoREnOHCoOAJFxwip/c1qaQAOqp1H6+P20ZGr2sIPiU97OVEU9kulm+E+jgiVW3LwGheOXsUOd1B8Mp0=","start_date_in_millis":-1}}
 
   - match: { license_status:  "valid" }
 
   - do:
       license.get: {}
 
-  ## a license object has 11 attributes
-  - length: { license: 11 }
+  ## a v5 (enterprise) license object has 12 attributes
+  - length: { license: 12 }
 
   ## In 8.0, the enterprise license is always reports truthfully
   - match: { license.type: "enterprise" }
+  - match: { license.max_resource_units: 50 }
+  - match: { license.max_nodes: null }
 
   - do:
       warnings:
@@ -34,8 +36,8 @@ teardown:
       license.get:
         accept_enterprise: "true"
 
-  ## a license object has 11 attributes
-  - length: { license: 11 }
+  ## a v5 license object has 12 attributes
+  - length: { license: 12 }
 
   ## Always returns real type
   - match: { license.type: "enterprise" }

From 913e285aa692b1e3ea1815f69d29fe2d04f779f8 Mon Sep 17 00:00:00 2001
From: Albert Zaharovits <albert.zaharovits@elastic.co>
Date: Mon, 13 Jan 2020 11:16:31 +0200
Subject: [PATCH 518/686] Make .async-search-* a restricted namespace (#50294)

Hide the `.async-search-*` in Security by making it a restricted index namespace.
The namespace is hard-coded.
To grant privileges on restricted indices, one must explicitly toggle the
`allow_restricted_indices` flag in the indices permission in the role definition.
As is the case with any other index, if a certain user lacks all permissions for an
index, that index is effectively nonexistent for that user.
---
 .../mapper/expressiondsl/FieldExpression.java |   6 +-
 .../authz/permission/IndicesPermission.java   |  16 ++-
 .../index/RestrictedIndicesNames.java         |  13 +-
 .../core/security/support/Automatons.java     |   7 ++
 .../authz/store/ReservedRolesStoreTests.java  |  47 +++++++-
 .../xpack/security/authz/RBACEngineTests.java | 111 ++++++++++++++++++
 .../accesscontrol/IndicesPermissionTests.java |  26 ++++
 .../xpack/security/user/XPackUserTests.java   |   1 +
 .../sql/qa/security/SqlSecurityTestCase.java  |   4 +-
 9 files changed, 218 insertions(+), 13 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/mapper/expressiondsl/FieldExpression.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/mapper/expressiondsl/FieldExpression.java
index bea4bbb1cc8fa..ec524420cdffe 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/mapper/expressiondsl/FieldExpression.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/mapper/expressiondsl/FieldExpression.java
@@ -119,17 +119,13 @@ public FieldValue(Object value) {
         private static CharacterRunAutomaton buildAutomaton(Object value) {
             if (value instanceof String) {
                 final String str = (String) value;
-                if (Regex.isSimpleMatchPattern(str) || isLuceneRegex(str)) {
+                if (Regex.isSimpleMatchPattern(str) || Automatons.isLuceneRegex(str)) {
                     return new CharacterRunAutomaton(Automatons.patterns(str));
                 }
             }
             return null;
         }
 
-        private static boolean isLuceneRegex(String str) {
-            return str.length() > 1 && str.charAt(0) == '/' && str.charAt(str.length() - 1) == '/';
-        }
-
         public Object getValue() {
             return value;
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/IndicesPermission.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/IndicesPermission.java
index 2e51e07bc7676..b68b9dd79204a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/IndicesPermission.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/IndicesPermission.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.regex.Regex;
 import org.elasticsearch.xpack.core.security.authz.accesscontrol.IndicesAccessControl;
 import org.elasticsearch.xpack.core.security.authz.privilege.IndexPrivilege;
 import org.elasticsearch.xpack.core.security.index.RestrictedIndicesNames;
@@ -139,7 +140,7 @@ public ResourcePrivilegesMap checkResourcePrivileges(Set<String> checkForIndexPa
         final Map<IndicesPermission.Group, Automaton> predicateCache = new HashMap<>();
         for (String forIndexPattern : checkForIndexPatterns) {
             Automaton checkIndexAutomaton = Automatons.patterns(forIndexPattern);
-            if (false == allowRestrictedIndices && false == RestrictedIndicesNames.RESTRICTED_NAMES.contains(forIndexPattern)) {
+            if (false == allowRestrictedIndices && false == isConcreteRestrictedIndex(forIndexPattern)) {
                 checkIndexAutomaton = Automatons.minusAndMinimize(checkIndexAutomaton, RestrictedIndicesNames.NAMES_AUTOMATON);
             }
             if (false == Operations.isEmpty(checkIndexAutomaton)) {
@@ -268,6 +269,13 @@ public Map<String, IndicesAccessControl.IndexAccessControl> authorize(String act
         return unmodifiableMap(indexPermissions);
     }
 
+    private boolean isConcreteRestrictedIndex(String indexPattern) {
+        if (Regex.isSimpleMatchPattern(indexPattern) || Automatons.isLuceneRegex(indexPattern)) {
+            return false;
+        }
+        return RestrictedIndicesNames.isRestricted(indexPattern);
+    }
+
     public static class Group {
         private final IndexPrivilege privilege;
         private final Predicate<String> actionMatcher;
@@ -316,7 +324,7 @@ private boolean check(String action) {
         private boolean check(String action, String index) {
             assert index != null;
             return check(action) && indexNameMatcher.test(index)
-                    && (allowRestrictedIndices || (false == RestrictedIndicesNames.RESTRICTED_NAMES.contains(index)));
+                    && (allowRestrictedIndices || (false == RestrictedIndicesNames.isRestricted(index)));
         }
 
         boolean hasQuery() {
@@ -351,13 +359,13 @@ private static Predicate<String> buildIndexMatcherPredicateForAction(String acti
             final Predicate<String> predicate;
             if (restrictedIndices.isEmpty()) {
                 predicate = indexMatcher(ordinaryIndices)
-                    .and(index -> false == RestrictedIndicesNames.RESTRICTED_NAMES.contains(index));
+                    .and(index -> false == RestrictedIndicesNames.isRestricted(index));
             } else if (ordinaryIndices.isEmpty()) {
                 predicate = indexMatcher(restrictedIndices);
             } else {
                 predicate = indexMatcher(restrictedIndices)
                     .or(indexMatcher(ordinaryIndices)
-                         .and(index -> false == RestrictedIndicesNames.RESTRICTED_NAMES.contains(index)));
+                         .and(index -> false == RestrictedIndicesNames.isRestricted(index)));
             }
             return predicate;
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/index/RestrictedIndicesNames.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/index/RestrictedIndicesNames.java
index 80c17c484739c..77f6c537b6f81 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/index/RestrictedIndicesNames.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/index/RestrictedIndicesNames.java
@@ -10,6 +10,7 @@
 import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.xpack.core.security.support.Automatons;
 
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.Set;
 
@@ -21,10 +22,20 @@ public final class RestrictedIndicesNames {
     public static final String INTERNAL_SECURITY_TOKENS_INDEX_7 = ".security-tokens-7";
     public static final String SECURITY_TOKENS_ALIAS = ".security-tokens";
 
+    // public for tests
+    public static final String ASYNC_SEARCH_PREFIX = ".async-search-";
+    private static final Automaton ASYNC_SEARCH_AUTOMATON = Automatons.patterns(ASYNC_SEARCH_PREFIX + "*");
+
+    // public for tests
     public static final Set<String> RESTRICTED_NAMES = Collections.unmodifiableSet(Sets.newHashSet(SECURITY_MAIN_ALIAS,
             INTERNAL_SECURITY_MAIN_INDEX_6, INTERNAL_SECURITY_MAIN_INDEX_7, INTERNAL_SECURITY_TOKENS_INDEX_7, SECURITY_TOKENS_ALIAS));
 
-    public static final Automaton NAMES_AUTOMATON = Automatons.patterns(RESTRICTED_NAMES);
+    public static boolean isRestricted(String concreteIndexName) {
+        return RESTRICTED_NAMES.contains(concreteIndexName) || concreteIndexName.startsWith(ASYNC_SEARCH_PREFIX);
+    }
+
+    public static final Automaton NAMES_AUTOMATON = Automatons.unionAndMinimize(Arrays.asList(Automatons.patterns(RESTRICTED_NAMES),
+            ASYNC_SEARCH_AUTOMATON));
 
     private RestrictedIndicesNames() {
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/support/Automatons.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/support/Automatons.java
index 7e6fd7ca46283..c0e4af238b1bd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/support/Automatons.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/support/Automatons.java
@@ -107,6 +107,13 @@ static Automaton pattern(String pattern) {
         }
     }
 
+    /**
+     * Is the str a lucene type of pattern
+     */
+    public static boolean isLuceneRegex(String str) {
+        return str.length() > 1 && str.charAt(0) == '/' && str.charAt(str.length() - 1) == '/';
+    }
+
     private static Automaton buildAutomaton(String pattern) {
         if (pattern.startsWith("/")) { // it's a lucene regexp
             if (pattern.length() == 1 || !pattern.endsWith("/")) {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
index f90f6b7b17009..e7166f0c94fef 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
@@ -254,8 +254,11 @@ public void testSnapshotUserRole() {
             // but that depends on how users are supposed to perform snapshots of those new indices.
             assertThat(snapshotUserRole.indices().allowedIndicesMatcher(GetIndexAction.NAME).test(index), is(true));
         }
+        assertThat(snapshotUserRole.indices().allowedIndicesMatcher(GetIndexAction.NAME).test(
+                RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(true));
 
         assertNoAccessAllowed(snapshotUserRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(snapshotUserRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testIngestAdminRole() {
@@ -285,6 +288,7 @@ public void testIngestAdminRole() {
                 is(false));
 
         assertNoAccessAllowed(ingestAdminRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(ingestAdminRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testKibanaSystemRole() {
@@ -402,6 +406,7 @@ public void testKibanaSystemRole() {
         assertThat(kibanaRole.indices().allowedIndicesMatcher(READ_CROSS_CLUSTER_NAME).test(index), is(false));
 
         assertNoAccessAllowed(kibanaRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(kibanaRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testKibanaUserRole() {
@@ -441,6 +446,7 @@ public void testKibanaUserRole() {
             "*"), is(false));
 
         assertNoAccessAllowed(kibanaUserRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(kibanaUserRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testMonitoringUserRole() {
@@ -488,6 +494,7 @@ public void testMonitoringUserRole() {
         assertThat(monitoringUserRole.indices().allowedIndicesMatcher(READ_CROSS_CLUSTER_NAME).test(index), is(true));
 
         assertNoAccessAllowed(monitoringUserRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(monitoringUserRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
 
         final String kibanaApplicationWithRandomIndex = "kibana-" + randomFrom(randomAlphaOfLengthBetween(8, 24), ".kibana");
         assertThat(monitoringUserRole.application().grants(
@@ -562,6 +569,7 @@ public void testRemoteMonitoringAgentRole() {
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(GetAction.NAME).test(metricbeatIndex), is(false));
 
         assertNoAccessAllowed(remoteMonitoringAgentRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(remoteMonitoringAgentRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testRemoteMonitoringCollectorRole() {
@@ -615,29 +623,50 @@ public void testRemoteMonitoringCollectorRole() {
         // (but ideally, the monitoring user should see all indices).
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(GetSettingsAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(true));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(GetSettingsAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(true));
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(IndicesShardStoresAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(true));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(IndicesShardStoresAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(true));
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(UpgradeStatusAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(true));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(UpgradeStatusAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(true));
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(RecoveryAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(true));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(RecoveryAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(true));
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(IndicesStatsAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(true));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(IndicesStatsAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(true));
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(IndicesSegmentsAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(true));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(IndicesSegmentsAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(true));
 
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(SearchAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(false));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(SearchAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(false));
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(GetAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(false));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(GetAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(false));
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(DeleteAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(false));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(DeleteAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(false));
         assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(IndexAction.NAME)
                 .test(randomFrom(RestrictedIndicesNames.RESTRICTED_NAMES)), is(false));
+        assertThat(remoteMonitoringAgentRole.indices().allowedIndicesMatcher(IndexAction.NAME)
+                .test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), is(false));
 
         assertMonitoringOnRestrictedIndices(remoteMonitoringAgentRole);
 
         assertNoAccessAllowed(remoteMonitoringAgentRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(remoteMonitoringAgentRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     private void assertMonitoringOnRestrictedIndices(Role role) {
@@ -656,11 +685,13 @@ private void assertMonitoringOnRestrictedIndices(Role role) {
         final List<String> indexMonitoringActionNamesList = Arrays.asList(IndicesStatsAction.NAME, IndicesSegmentsAction.NAME,
                 GetSettingsAction.NAME, IndicesShardStoresAction.NAME, UpgradeStatusAction.NAME, RecoveryAction.NAME);
         for (final String indexMonitoringActionName : indexMonitoringActionNamesList) {
+            String asyncSearchIndex = RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2);
             final Map<String, IndexAccessControl> authzMap = role.indices().authorize(indexMonitoringActionName,
-                Sets.newHashSet(internalSecurityIndex, RestrictedIndicesNames.SECURITY_MAIN_ALIAS),
+                Sets.newHashSet(internalSecurityIndex, RestrictedIndicesNames.SECURITY_MAIN_ALIAS, asyncSearchIndex),
                 metaData.getAliasAndIndexLookup(), fieldPermissionsCache);
             assertThat(authzMap.get(internalSecurityIndex).isGranted(), is(true));
             assertThat(authzMap.get(RestrictedIndicesNames.SECURITY_MAIN_ALIAS).isGranted(), is(true));
+            assertThat(authzMap.get(asyncSearchIndex).isGranted(), is(true));
         }
     }
 
@@ -704,6 +735,7 @@ public void testReportingUserRole() {
         assertThat(reportingUserRole.indices().allowedIndicesMatcher(BulkAction.NAME).test(index), is(false));
 
         assertNoAccessAllowed(reportingUserRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(reportingUserRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testKibanaDashboardOnlyUserRole() {
@@ -740,6 +772,7 @@ public void testKibanaDashboardOnlyUserRole() {
             new ApplicationPrivilege(applicationWithRandomIndex, "app-random-index", "all"), "*"), is(false));
 
         assertNoAccessAllowed(dashboardsOnlyUserRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(dashboardsOnlyUserRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testSuperuserRole() {
@@ -840,6 +873,7 @@ public void testLogstashSystemRole() {
                 is(false));
 
         assertNoAccessAllowed(logstashSystemRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(logstashSystemRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testBeatsAdminRole() {
@@ -880,6 +914,7 @@ public void testBeatsAdminRole() {
         assertThat(beatsAdminRole.indices().allowedIndicesMatcher(GetAction.NAME).test(index), is(true));
 
         assertNoAccessAllowed(beatsAdminRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(beatsAdminRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testBeatsSystemRole() {
@@ -915,6 +950,7 @@ public void testBeatsSystemRole() {
         assertThat(beatsSystemRole.indices().allowedIndicesMatcher(BulkAction.NAME).test(index), is(true));
 
         assertNoAccessAllowed(beatsSystemRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(beatsSystemRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testAPMSystemRole() {
@@ -955,7 +991,7 @@ public void testAPMSystemRole() {
             "indices:data/write/index:op_type/" + randomAlphaOfLengthBetween(3,5)).test(index), is(false));
 
         assertNoAccessAllowed(APMSystemRole, RestrictedIndicesNames.RESTRICTED_NAMES);
-
+        assertNoAccessAllowed(APMSystemRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testAPMUserRole() {
@@ -1049,6 +1085,7 @@ public void testMachineLearningAdminRole() {
         assertReadWriteDocsButNotDeleteIndexAllowed(role, AnnotationIndex.INDEX_NAME);
 
         assertNoAccessAllowed(role, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(role, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
 
         final String kibanaApplicationWithRandomIndex = "kibana-" + randomFrom(randomAlphaOfLengthBetween(8, 24), ".kibana");
         assertThat(role.application().grants(
@@ -1135,6 +1172,7 @@ public void testMachineLearningUserRole() {
         assertReadWriteDocsButNotDeleteIndexAllowed(role, AnnotationIndex.INDEX_NAME);
 
         assertNoAccessAllowed(role, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(role, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
 
 
         final String kibanaApplicationWithRandomIndex = "kibana-" + randomFrom(randomAlphaOfLengthBetween(8, 24), ".kibana");
@@ -1182,6 +1220,7 @@ public void testTransformAdminRole() {
             assertNoAccessAllowed(role, TransformInternalIndexConstants.LATEST_INDEX_NAME); // internal use only
 
             assertNoAccessAllowed(role, RestrictedIndicesNames.RESTRICTED_NAMES);
+            assertNoAccessAllowed(role, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
 
             final String kibanaApplicationWithRandomIndex = "kibana-" + randomFrom(randomAlphaOfLengthBetween(8, 24), ".kibana");
             assertThat(role.application().grants(
@@ -1234,6 +1273,7 @@ public void testDataFrameTransformsUserRole() {
             assertNoAccessAllowed(role, TransformInternalIndexConstants.LATEST_INDEX_NAME);
 
             assertNoAccessAllowed(role, RestrictedIndicesNames.RESTRICTED_NAMES);
+            assertNoAccessAllowed(role, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
 
             final String kibanaApplicationWithRandomIndex = "kibana-" + randomFrom(randomAlphaOfLengthBetween(8, 24), ".kibana");
             assertThat(role.application().grants(
@@ -1284,6 +1324,7 @@ public void testWatcherAdminRole() {
         }
 
         assertNoAccessAllowed(role, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(role, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     public void testWatcherUserRole() {
@@ -1317,6 +1358,7 @@ public void testWatcherUserRole() {
         }
 
         assertNoAccessAllowed(role, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(role, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     private void assertReadWriteDocsButNotDeleteIndexAllowed(Role role, String index) {
@@ -1341,6 +1383,7 @@ private void assertOnlyReadAllowed(Role role, String index) {
         assertThat(role.indices().allowedIndicesMatcher(BulkAction.NAME).test(index), is(false));
 
         assertNoAccessAllowed(role, RestrictedIndicesNames.RESTRICTED_NAMES);
+        assertNoAccessAllowed(role, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
     private void assertNoAccessAllowed(Role role, Collection<String> indices) {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
index fd84afea365be..06a5d646d7a81 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
@@ -544,6 +544,117 @@ public void testCheckingIndexPermissionsDefinedOnDifferentPatterns() throws Exce
         ));
     }
 
+    public void testCheckRestrictedIndexPatternPermission() throws Exception {
+        User user = new User(randomAlphaOfLengthBetween(4, 12));
+        Authentication authentication = mock(Authentication.class);
+        when(authentication.getUser()).thenReturn(user);
+        final String patternPrefix = RestrictedIndicesNames.ASYNC_SEARCH_PREFIX.substring(0,
+                randomIntBetween(1, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX.length() - 2));
+        Role role = Role.builder("role")
+                .add(FieldPermissions.DEFAULT, null, IndexPrivilege.INDEX, false, patternPrefix + "*")
+                .build();
+        RBACAuthorizationInfo authzInfo = new RBACAuthorizationInfo(role, null);
+
+        String prePatternPrefix = patternPrefix.substring(0, randomIntBetween(1, patternPrefix.length() - 1)) + "*";
+        HasPrivilegesResponse response = hasPrivileges(RoleDescriptor.IndicesPrivileges.builder()
+                .indices(prePatternPrefix)
+                .allowRestrictedIndices(randomBoolean())
+                .privileges("index")
+                .build(), authentication, authzInfo, Collections.emptyList(), Strings.EMPTY_ARRAY);
+        assertThat(response.isCompleteMatch(), is(false));
+        assertThat(response.getIndexPrivileges(), Matchers.iterableWithSize(1));
+        assertThat(response.getIndexPrivileges(), containsInAnyOrder(
+                ResourcePrivileges.builder(prePatternPrefix)
+                        .addPrivileges(MapBuilder.newMapBuilder(new LinkedHashMap<String, Boolean>())
+                                .put("index", false).map()).build()));
+
+        String matchesPatternPrefix = RestrictedIndicesNames.ASYNC_SEARCH_PREFIX.substring(0, patternPrefix.length() + 1);
+        response = hasPrivileges(RoleDescriptor.IndicesPrivileges.builder()
+                .indices(matchesPatternPrefix + "*")
+                .allowRestrictedIndices(false)
+                .privileges("index")
+                .build(), authentication, authzInfo, Collections.emptyList(), Strings.EMPTY_ARRAY);
+        assertThat(response.isCompleteMatch(), is(true));
+        assertThat(response.getIndexPrivileges(), Matchers.iterableWithSize(1));
+        assertThat(response.getIndexPrivileges(), containsInAnyOrder(
+                ResourcePrivileges.builder(matchesPatternPrefix + "*")
+                        .addPrivileges(MapBuilder.newMapBuilder(new LinkedHashMap<String, Boolean>())
+                                .put("index", true).map()).build()));
+        response = hasPrivileges(RoleDescriptor.IndicesPrivileges.builder()
+                .indices(matchesPatternPrefix + "*")
+                .allowRestrictedIndices(true)
+                .privileges("index")
+                .build(), authentication, authzInfo, Collections.emptyList(), Strings.EMPTY_ARRAY);
+        assertThat(response.isCompleteMatch(), is(false));
+        assertThat(response.getIndexPrivileges(), Matchers.iterableWithSize(1));
+        assertThat(response.getIndexPrivileges(), containsInAnyOrder(
+                ResourcePrivileges.builder(matchesPatternPrefix + "*")
+                        .addPrivileges(MapBuilder.newMapBuilder(new LinkedHashMap<String, Boolean>())
+                                .put("index", false).map()).build()));
+        response = hasPrivileges(RoleDescriptor.IndicesPrivileges.builder()
+                .indices(matchesPatternPrefix)
+                .allowRestrictedIndices(randomBoolean())
+                .privileges("index")
+                .build(), authentication, authzInfo, Collections.emptyList(), Strings.EMPTY_ARRAY);
+        assertThat(response.isCompleteMatch(), is(true));
+        assertThat(response.getIndexPrivileges(), Matchers.iterableWithSize(1));
+        assertThat(response.getIndexPrivileges(), containsInAnyOrder(
+                ResourcePrivileges.builder(matchesPatternPrefix)
+                        .addPrivileges(MapBuilder.newMapBuilder(new LinkedHashMap<String, Boolean>())
+                                .put("index", true).map()).build()));
+
+        final String restrictedIndexMatchingWildcard = RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2);
+        response = hasPrivileges(RoleDescriptor.IndicesPrivileges.builder()
+                .indices(restrictedIndexMatchingWildcard + "*")
+                .allowRestrictedIndices(true)
+                .privileges("index")
+                .build(), authentication, authzInfo, Collections.emptyList(), Strings.EMPTY_ARRAY);
+        assertThat(response.isCompleteMatch(), is(false));
+        assertThat(response.getIndexPrivileges(), Matchers.iterableWithSize(1));
+        assertThat(response.getIndexPrivileges(), containsInAnyOrder(
+                ResourcePrivileges.builder(restrictedIndexMatchingWildcard + "*")
+                        .addPrivileges(MapBuilder.newMapBuilder(new LinkedHashMap<String, Boolean>())
+                                .put("index", false).map()).build()));
+        response = hasPrivileges(RoleDescriptor.IndicesPrivileges.builder()
+                .indices(restrictedIndexMatchingWildcard + "*")
+                .allowRestrictedIndices(false)
+                .privileges("index")
+                .build(), authentication, authzInfo, Collections.emptyList(), Strings.EMPTY_ARRAY);
+        assertThat(response.isCompleteMatch(), is(false));
+        assertThat(response.getIndexPrivileges(), Matchers.iterableWithSize(1));
+        assertThat(response.getIndexPrivileges(), containsInAnyOrder(
+                ResourcePrivileges.builder(restrictedIndexMatchingWildcard + "*")
+                        .addPrivileges(MapBuilder.newMapBuilder(new LinkedHashMap<String, Boolean>())
+                                .put("index", false).map()).build()));
+        response = hasPrivileges(RoleDescriptor.IndicesPrivileges.builder()
+                .indices(restrictedIndexMatchingWildcard)
+                .allowRestrictedIndices(randomBoolean())
+                .privileges("index")
+                .build(), authentication, authzInfo, Collections.emptyList(), Strings.EMPTY_ARRAY);
+        assertThat(response.isCompleteMatch(), is(false));
+        assertThat(response.getIndexPrivileges(), Matchers.iterableWithSize(1));
+        assertThat(response.getIndexPrivileges(), containsInAnyOrder(
+                ResourcePrivileges.builder(restrictedIndexMatchingWildcard)
+                        .addPrivileges(MapBuilder.newMapBuilder(new LinkedHashMap<String, Boolean>())
+                                .put("index", false).map()).build()));
+
+        role = Role.builder("role")
+                .add(FieldPermissions.DEFAULT, null, IndexPrivilege.INDEX, true, patternPrefix + "*")
+                .build();
+        authzInfo = new RBACAuthorizationInfo(role, null);
+        response = hasPrivileges(RoleDescriptor.IndicesPrivileges.builder()
+                .indices(matchesPatternPrefix + "*")
+                .allowRestrictedIndices(randomBoolean())
+                .privileges("index")
+                .build(), authentication, authzInfo, Collections.emptyList(), Strings.EMPTY_ARRAY);
+        assertThat(response.isCompleteMatch(), is(true));
+        assertThat(response.getIndexPrivileges(), Matchers.iterableWithSize(1));
+        assertThat(response.getIndexPrivileges(), containsInAnyOrder(
+                ResourcePrivileges.builder(matchesPatternPrefix + "*")
+                        .addPrivileges(MapBuilder.newMapBuilder(new LinkedHashMap<String, Boolean>())
+                                .put("index", true).map()).build()));
+    }
+
     public void testCheckExplicitRestrictedIndexPermissions() throws Exception {
         User user = new User(randomAlphaOfLengthBetween(4, 12));
         Authentication authentication = mock(Authentication.class);
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/accesscontrol/IndicesPermissionTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/accesscontrol/IndicesPermissionTests.java
index be73972f3a1e3..ee10a29083ad3 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/accesscontrol/IndicesPermissionTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/accesscontrol/IndicesPermissionTests.java
@@ -322,6 +322,32 @@ public void testSecurityIndicesPermissions() {
         assertThat(authzMap.get(RestrictedIndicesNames.SECURITY_MAIN_ALIAS).isGranted(), is(true));
     }
 
+    public void testAsyncSearchIndicesPermissions() {
+        final Settings indexSettings = Settings.builder().put("index.version.created", Version.CURRENT).build();
+        final String asyncSearchIndex = RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2);
+        final MetaData metaData = new MetaData.Builder()
+                .put(new IndexMetaData.Builder(asyncSearchIndex)
+                        .settings(indexSettings)
+                        .numberOfShards(1)
+                        .numberOfReplicas(0)
+                        .build(), true)
+                .build();
+        FieldPermissionsCache fieldPermissionsCache = new FieldPermissionsCache(Settings.EMPTY);
+        SortedMap<String, AliasOrIndex> lookup = metaData.getAliasAndIndexLookup();
+
+        // allow_restricted_indices: false
+        IndicesPermission.Group group = new IndicesPermission.Group(IndexPrivilege.ALL, new FieldPermissions(), null, false, "*");
+        Map<String, IndicesAccessControl.IndexAccessControl> authzMap = new IndicesPermission(group).authorize(SearchAction.NAME,
+                Sets.newHashSet(asyncSearchIndex), lookup, fieldPermissionsCache);
+        assertThat(authzMap.get(asyncSearchIndex).isGranted(), is(false));
+
+        // allow_restricted_indices: true
+        group = new IndicesPermission.Group(IndexPrivilege.ALL, new FieldPermissions(), null, true, "*");
+        authzMap = new IndicesPermission(group).authorize(SearchAction.NAME,
+                Sets.newHashSet(asyncSearchIndex), lookup, fieldPermissionsCache);
+        assertThat(authzMap.get(asyncSearchIndex).isGranted(), is(true));
+    }
+
     private static FieldPermissionsDefinition fieldPermissionDef(String[] granted, String[] denied) {
         return new FieldPermissionsDefinition(granted, denied);
     }
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/user/XPackUserTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/user/XPackUserTests.java
index c8b20e1b4604c..6c7fb2abdabf6 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/user/XPackUserTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/user/XPackUserTests.java
@@ -34,6 +34,7 @@ public void testXPackUserCannotAccessRestrictedIndices() {
         for (String index : RestrictedIndicesNames.RESTRICTED_NAMES) {
             assertThat(predicate.test(index), Matchers.is(false));
         }
+        assertThat(predicate.test(RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2)), Matchers.is(false));
     }
 
     public void testXPackUserCanReadAuditTrail() {
diff --git a/x-pack/plugin/sql/qa/security/src/test/java/org/elasticsearch/xpack/sql/qa/security/SqlSecurityTestCase.java b/x-pack/plugin/sql/qa/security/src/test/java/org/elasticsearch/xpack/sql/qa/security/SqlSecurityTestCase.java
index 7340a1ab9332e..abd2026d437af 100644
--- a/x-pack/plugin/sql/qa/security/src/test/java/org/elasticsearch/xpack/sql/qa/security/SqlSecurityTestCase.java
+++ b/x-pack/plugin/sql/qa/security/src/test/java/org/elasticsearch/xpack/sql/qa/security/SqlSecurityTestCase.java
@@ -41,6 +41,7 @@
 import java.util.Map;
 import java.util.TreeMap;
 import java.util.function.Function;
+import java.util.stream.Collectors;
 
 import static java.util.Arrays.asList;
 import static java.util.Collections.singletonMap;
@@ -650,7 +651,8 @@ public void assertLogs() throws Exception {
                                          * SQL drops them from the interface. So we might have access to them, but we
                                          * don't show them.
                                          */
-                                        indices.removeAll(RestrictedIndicesNames.RESTRICTED_NAMES);
+                                        indices = indices.stream().filter(
+                                                idx -> false == RestrictedIndicesNames.isRestricted(idx)).collect(Collectors.toList());
                                     }
                                 }
                                 // Use a sorted list for indices for consistent error reporting

From 40c522bd8d7898b2f6661c139a9f12f4e641773b Mon Sep 17 00:00:00 2001
From: Albert Zaharovits <albert.zaharovits@elastic.co>
Date: Mon, 13 Jan 2020 13:25:05 +0200
Subject: [PATCH 519/686] Nit fix test randomInt bound

Relates a62052504e2adaa38e6140127f5
---
 .../org/elasticsearch/xpack/security/authz/RBACEngineTests.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
index 06a5d646d7a81..eee0af46097a0 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
@@ -549,7 +549,7 @@ public void testCheckRestrictedIndexPatternPermission() throws Exception {
         Authentication authentication = mock(Authentication.class);
         when(authentication.getUser()).thenReturn(user);
         final String patternPrefix = RestrictedIndicesNames.ASYNC_SEARCH_PREFIX.substring(0,
-                randomIntBetween(1, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX.length() - 2));
+                randomIntBetween(2, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX.length() - 2));
         Role role = Role.builder("role")
                 .add(FieldPermissions.DEFAULT, null, IndexPrivilege.INDEX, false, patternPrefix + "*")
                 .build();

From 760405515f9d0b9409869f1508495988956a4c24 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Mon, 13 Jan 2020 07:16:08 -0500
Subject: [PATCH 520/686] [ML][Inference] minor fixes for created_by, and
 action permission (#50890)

The system created and models we provide now use the `_xpack` user for uniformity with our other features

The `PUT` action is now an admin cluster action

And XPackClient class now references the action instance.
---
 .../java/org/elasticsearch/xpack/core/XPackClientPlugin.java   | 2 ++
 .../xpack/core/ml/action/PutTrainedModelAction.java            | 2 +-
 .../xpack/ml/dataframe/process/AnalyticsResultProcessor.java   | 3 ++-
 .../xpack/ml/inference/persistence/lang_ident_model_1.json     | 2 +-
 .../ml/dataframe/process/AnalyticsResultProcessorTests.java    | 3 ++-
 5 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
index 8798c41406b31..82daf97cb0b54 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
@@ -116,6 +116,7 @@
 import org.elasticsearch.xpack.core.ml.action.PutDatafeedAction;
 import org.elasticsearch.xpack.core.ml.action.PutFilterAction;
 import org.elasticsearch.xpack.core.ml.action.PutJobAction;
+import org.elasticsearch.xpack.core.ml.action.PutTrainedModelAction;
 import org.elasticsearch.xpack.core.ml.action.RevertModelSnapshotAction;
 import org.elasticsearch.xpack.core.ml.action.SetUpgradeModeAction;
 import org.elasticsearch.xpack.core.ml.action.StartDataFrameAnalyticsAction;
@@ -342,6 +343,7 @@ public List<ActionType<? extends ActionResponse>> getClientActions() {
                 GetTrainedModelsAction.INSTANCE,
                 DeleteTrainedModelAction.INSTANCE,
                 GetTrainedModelsStatsAction.INSTANCE,
+                PutTrainedModelAction.INSTANCE,
                 // security
                 ClearRealmCacheAction.INSTANCE,
                 ClearRolesCacheAction.INSTANCE,
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelAction.java
index 06fbb6401a082..8821e47023ebb 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/PutTrainedModelAction.java
@@ -25,7 +25,7 @@
 public class PutTrainedModelAction extends ActionType<PutTrainedModelAction.Response> {
 
     public static final PutTrainedModelAction INSTANCE = new PutTrainedModelAction();
-    public static final String NAME = "cluster:monitor/xpack/ml/inference/put";
+    public static final String NAME = "cluster:admin/xpack/ml/inference/put";
     private PutTrainedModelAction() {
         super(NAME, Response::new);
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessor.java
index 00fea87a05b20..5168c9296d2f9 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessor.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelInput;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
+import org.elasticsearch.xpack.core.security.user.XPackUser;
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask.ProgressTracker;
 import org.elasticsearch.xpack.ml.dataframe.process.results.AnalyticsResult;
 import org.elasticsearch.xpack.ml.dataframe.process.results.RowResults;
@@ -173,7 +174,7 @@ private TrainedModelConfig createTrainedModelConfig(TrainedModelDefinition.Build
             .collect(toList());
         return TrainedModelConfig.builder()
             .setModelId(modelId)
-            .setCreatedBy("data-frame-analytics")
+            .setCreatedBy(XPackUser.NAME)
             .setVersion(Version.CURRENT)
             .setCreateTime(createTime)
             .setTags(Collections.singletonList(analytics.getId()))
diff --git a/x-pack/plugin/ml/src/main/resources/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json b/x-pack/plugin/ml/src/main/resources/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json
index 63af5fe0ffaec..30b4d9673fb32 100644
--- a/x-pack/plugin/ml/src/main/resources/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json
+++ b/x-pack/plugin/ml/src/main/resources/org/elasticsearch/xpack/ml/inference/persistence/lang_ident_model_1.json
@@ -1,6 +1,6 @@
 {
   "model_id" : "lang_ident_model_1",
-  "created_by" : "ml_admin",
+  "created_by" : "_xpack",
   "version" : "7.6.0",
   "description" : "Model used for identifying language from arbitrary input text.",
   "create_time" : 1575548914594,
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
index 036023eb8c9aa..09969817374cd 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/process/AnalyticsResultProcessorTests.java
@@ -20,6 +20,7 @@
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelConfig;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinition;
 import org.elasticsearch.xpack.core.ml.inference.TrainedModelDefinitionTests;
+import org.elasticsearch.xpack.core.security.user.XPackUser;
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask.ProgressTracker;
 import org.elasticsearch.xpack.ml.dataframe.process.results.AnalyticsResult;
 import org.elasticsearch.xpack.ml.dataframe.process.results.RowResults;
@@ -167,7 +168,7 @@ public void testProcess_GivenInferenceModelIsStoredSuccessfully() {
         assertThat(storedModel.getLicenseLevel(), equalTo(License.OperationMode.PLATINUM));
         assertThat(storedModel.getModelId(), containsString(JOB_ID));
         assertThat(storedModel.getVersion(), equalTo(Version.CURRENT));
-        assertThat(storedModel.getCreatedBy(), equalTo("data-frame-analytics"));
+        assertThat(storedModel.getCreatedBy(), equalTo(XPackUser.NAME));
         assertThat(storedModel.getTags(), contains(JOB_ID));
         assertThat(storedModel.getDescription(), equalTo(JOB_DESCRIPTION));
         assertThat(storedModel.getModelDefinition(), equalTo(inferenceModel.build()));

From 997dd5cb4f47cceb0ebea82cc41626613ab89ae6 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 13 Jan 2020 13:32:22 +0100
Subject: [PATCH 521/686] Prevent Old Version Clusters From Corrupting Snapshot
 Repositories (#50853)

Follow up to #50692 that starts writing a `min_version` field to
the `RepositoryData` so that pre-7.6 ES versions can not read it
(and potentially corrupt it if they attempt to modify the repo contents)
after the repository moved to the new metadata format.
---
 .../MultiVersionRepositoryAccessIT.java       | 60 ++++++++++++-------
 .../repositories/RepositoryData.java          |  4 +-
 2 files changed, 39 insertions(+), 25 deletions(-)

diff --git a/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java b/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
index ec2a70c6f84cd..57c38e5cff267 100644
--- a/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
+++ b/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.upgrades;
 
+import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.admin.cluster.repositories.put.PutRepositoryRequest;
 import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotRequest;
 import org.elasticsearch.action.admin.cluster.snapshots.delete.DeleteSnapshotRequest;
@@ -30,6 +31,7 @@
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.RequestOptions;
 import org.elasticsearch.client.Response;
+import org.elasticsearch.client.ResponseException;
 import org.elasticsearch.client.RestClient;
 import org.elasticsearch.client.RestHighLevelClient;
 import org.elasticsearch.common.settings.Settings;
@@ -37,6 +39,7 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.snapshots.RestoreInfo;
+import org.elasticsearch.snapshots.SnapshotsService;
 import org.elasticsearch.test.rest.ESRestTestCase;
 
 import java.io.IOException;
@@ -60,8 +63,6 @@
  *     <li>Run against the old version cluster from the first step: {@link TestStep#STEP3_OLD_CLUSTER}</li>
  *     <li>Run against the current version cluster from the second step: {@link TestStep#STEP4_NEW_CLUSTER}</li>
  * </ul>
- * TODO: Add two more steps: delete all old version snapshots from the repository, then downgrade again and verify that the repository
- *       is not being corrupted. This requires first merging the logic for reading the min_version field in RepositoryData back to 7.6.
  */
 public class MultiVersionRepositoryAccessIT extends ESRestTestCase {
 
@@ -98,7 +99,7 @@ public static TestStep parse(String value) {
         }
     }
 
-    protected static final TestStep TEST_STEP = TestStep.parse(System.getProperty("tests.rest.suite"));
+    private static final TestStep TEST_STEP = TestStep.parse(System.getProperty("tests.rest.suite"));
 
     @Override
     protected boolean preserveSnapshotsUponCompletion() {
@@ -192,31 +193,46 @@ public void testReadOnlyRepo() throws IOException {
     }
 
     public void testUpgradeMovesRepoToNewMetaVersion() throws IOException {
-        if (TEST_STEP.ordinal() > 1) {
-            // Only testing the first 2 steps here
-            return;
-        }
         final String repoName = getTestName();
         try (RestHighLevelClient client = new RestHighLevelClient(RestClient.builder(adminClient().getNodes().toArray(new Node[0])))) {
             final int shards = 3;
             createIndex(client, "test-index", shards);
             createRepository(client, repoName, false);
-            createSnapshot(client, repoName, "snapshot-" + TEST_STEP);
-            final List<Map<String, Object>> snapshots = listSnapshots(repoName);
-            // Every step creates one snapshot
-            assertThat(snapshots, hasSize(TEST_STEP.ordinal() + 1));
-            assertSnapshotStatusSuccessful(client, repoName,
-                snapshots.stream().map(sn -> (String) sn.get("snapshot")).toArray(String[]::new));
-            if (TEST_STEP == TestStep.STEP1_OLD_CLUSTER) {
-                ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
+            // only create some snapshots in the first two steps
+            if (TEST_STEP == TestStep.STEP1_OLD_CLUSTER || TEST_STEP == TestStep.STEP2_NEW_CLUSTER) {
+                createSnapshot(client, repoName, "snapshot-" + TEST_STEP);
+                final List<Map<String, Object>> snapshots = listSnapshots(repoName);
+                // Every step creates one snapshot
+                assertThat(snapshots, hasSize(TEST_STEP.ordinal() + 1));
+                assertSnapshotStatusSuccessful(client, repoName,
+                    snapshots.stream().map(sn -> (String) sn.get("snapshot")).toArray(String[]::new));
+                if (TEST_STEP == TestStep.STEP1_OLD_CLUSTER) {
+                    ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER, shards);
+                } else {
+                    deleteSnapshot(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER);
+                    ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER, shards);
+                    createSnapshot(client, repoName, "snapshot-1");
+                    ensureSnapshotRestoreWorks(client, repoName, "snapshot-1", shards);
+                    deleteSnapshot(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER);
+                    createSnapshot(client, repoName, "snapshot-2");
+                    ensureSnapshotRestoreWorks(client, repoName, "snapshot-2", shards);
+                }
             } else {
-                deleteSnapshot(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER);
-                ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER, shards);
-                createSnapshot(client, repoName, "snapshot-1");
-                ensureSnapshotRestoreWorks(client, repoName, "snapshot-1", shards);
-                deleteSnapshot(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER);
-                createSnapshot(client, repoName, "snapshot-2");
-                ensureSnapshotRestoreWorks(client, repoName, "snapshot-2", shards);
+                if (minimumNodeVersion().before(SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION)) {
+                    assertThat(TEST_STEP, is(TestStep.STEP3_OLD_CLUSTER));
+                    final List<Class<? extends Exception>> expectedExceptions =
+                        List.of(ResponseException.class, ElasticsearchStatusException.class);
+                    expectThrowsAnyOf(expectedExceptions, () -> listSnapshots(repoName));
+                    expectThrowsAnyOf(expectedExceptions, () -> deleteSnapshot(client, repoName, "snapshot-1"));
+                    expectThrowsAnyOf(expectedExceptions, () -> deleteSnapshot(client, repoName, "snapshot-2"));
+                    expectThrowsAnyOf(expectedExceptions, () -> createSnapshot(client, repoName, "snapshot-impossible"));
+                } else {
+                    assertThat(listSnapshots(repoName), hasSize(2));
+                    if (TEST_STEP == TestStep.STEP4_NEW_CLUSTER) {
+                        ensureSnapshotRestoreWorks(client, repoName, "snapshot-1", shards);
+                        ensureSnapshotRestoreWorks(client, repoName, "snapshot-2", shards);
+                    }
+                }
             }
         } finally {
             deleteRepository(repoName);
diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
index f41a28686e38b..82c41251c586a 100644
--- a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
@@ -365,10 +365,8 @@ public XContentBuilder snapshotsToXContent(final XContentBuilder builder, final
         }
         builder.endObject();
         if (shouldWriteShardGens) {
-            // TODO: write this field once 7.6 is able to read it and add tests to :qa:snapshot-repository-downgrade that make sure older
-            //       ES versions can't corrupt the repository by writing to it and all the snapshots in it are v7.6 or newer
             // Add min version field to make it impossible for older ES versions to deserialize this object
-            // builder.field(MIN_VERSION, SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION.toString());
+            builder.field(MIN_VERSION, SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION.toString());
         }
         builder.endObject();
         return builder;

From 581640fa157da6e37a5b60553ee7ed467eba3533 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Tue, 14 Jan 2020 00:02:26 +1100
Subject: [PATCH 522/686] Add certutil http command (#49827)

This adds a new "http" sub-command to the certutil CLI tool.

The http command generates certificates/CSRs for use on the http
interface of an elasticsearch node/cluster.
It is designed to be a guided tool that provides explanations and
sugestions for each of the configuration options. The generated zip
file output includes extensive "readme" documentation and sample
configuration files for core Elastic products.
---
 .../xpack/core/ssl/CertParsingUtils.java      |   16 +-
 .../org/elasticsearch/test/FileMatchers.java  |   90 ++
 .../org/elasticsearch/test/TestMatchers.java  |    4 +
 x-pack/plugin/security/cli/build.gradle       |    5 +
 .../xpack/security/cli/CertGenUtils.java      |    8 +
 .../xpack/security/cli/CertificateTool.java   |    7 +-
 .../security/cli/HttpCertificateCommand.java  | 1201 +++++++++++++++++
 .../cli/certutil-http/ca-readme-p12.txt       |   33 +
 .../cli/certutil-http/es-readme-csr.txt       |   56 +
 .../cli/certutil-http/es-readme-p12.txt       |   38 +
 .../cli/certutil-http/es-sample-csr.yml       |   32 +
 .../cli/certutil-http/es-sample-p12.yml       |   22 +
 .../cli/certutil-http/kibana-readme.txt       |   62 +
 .../cli/certutil-http/kibana-sample.yml       |   25 +
 .../cli/HttpCertificateCommandTests.java      |  781 +++++++++++
 .../xpack/security/cli/PemToKeystore.java     |   52 +
 .../elasticsearch/xpack/security/cli/ca.crt   |   20 +
 .../elasticsearch/xpack/security/cli/ca.key   |   30 +
 .../elasticsearch/xpack/security/cli/ca.p12   |  Bin 0 -> 2529 bytes
 19 files changed, 2477 insertions(+), 5 deletions(-)
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/test/FileMatchers.java
 create mode 100644 x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommand.java
 create mode 100644 x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/ca-readme-p12.txt
 create mode 100644 x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-readme-csr.txt
 create mode 100644 x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-readme-p12.txt
 create mode 100644 x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-sample-csr.yml
 create mode 100644 x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-sample-p12.yml
 create mode 100644 x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/kibana-readme.txt
 create mode 100644 x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/kibana-sample.yml
 create mode 100644 x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
 create mode 100644 x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/PemToKeystore.java
 create mode 100644 x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.crt
 create mode 100644 x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.key
 create mode 100644 x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.p12

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/CertParsingUtils.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/CertParsingUtils.java
index 30b75aadf5fbb..bba67d6809abe 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/CertParsingUtils.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/CertParsingUtils.java
@@ -120,8 +120,20 @@ public static List<Certificate> readCertificates(InputStream input) throws Certi
      *                    return the password for that key. If it returns {@code null}, then the key-pair for that alias is not read.
      */
     public static Map<Certificate, Key> readPkcs12KeyPairs(Path path, char[] password, Function<String, char[]> keyPassword)
-        throws CertificateException, NoSuchAlgorithmException, KeyStoreException, IOException, UnrecoverableKeyException {
-        final KeyStore store = readKeyStore(path, "PKCS12", password);
+            throws CertificateException, NoSuchAlgorithmException, KeyStoreException, IOException, UnrecoverableKeyException {
+        return readKeyPairsFromKeystore(path, "PKCS12", password, keyPassword);
+    }
+
+    public static Map<Certificate, Key> readKeyPairsFromKeystore(Path path, String storeType, char[] password,
+                                                                  Function<String, char[]> keyPassword)
+        throws IOException, KeyStoreException, CertificateException, NoSuchAlgorithmException, UnrecoverableKeyException {
+
+        final KeyStore store = readKeyStore(path, storeType, password);
+        return readKeyPairsFromKeystore(store, keyPassword);
+    }
+
+    static Map<Certificate, Key> readKeyPairsFromKeystore(KeyStore store, Function<String, char[]> keyPassword)
+        throws KeyStoreException, NoSuchAlgorithmException, UnrecoverableKeyException {
         final Enumeration<String> enumeration = store.aliases();
         final Map<Certificate, Key> map = new HashMap<>(store.size());
         while (enumeration.hasMoreElements()) {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/test/FileMatchers.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/test/FileMatchers.java
new file mode 100644
index 0000000000000..a18e1bab94123
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/test/FileMatchers.java
@@ -0,0 +1,90 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.test;
+
+import org.hamcrest.CustomMatcher;
+import org.hamcrest.Description;
+import org.hamcrest.Matcher;
+
+import java.nio.file.Files;
+import java.nio.file.LinkOption;
+import java.nio.file.Path;
+
+public class FileMatchers {
+    public static Matcher<Path> pathExists(LinkOption... options) {
+        return new CustomMatcher<>("Path exists") {
+            @Override
+            public boolean matches(Object item) {
+                if (item instanceof Path) {
+                    Path path = (Path) item;
+                    return Files.exists(path, options);
+                } else {
+                    return false;
+                }
+
+            }
+        };
+    }
+
+    public static Matcher<Path> isDirectory(LinkOption... options) {
+        return new FileTypeMatcher("directory", options) {
+            @Override
+            protected boolean matchPath(Path path) {
+                return Files.isDirectory(path, options);
+            }
+        };
+    }
+
+    public static Matcher<Path> isRegularFile(LinkOption... options) {
+        return new FileTypeMatcher("regular file", options) {
+            @Override
+            protected boolean matchPath(Path path) {
+                return Files.isRegularFile(path, options);
+            }
+        };
+    }
+
+    private abstract static class FileTypeMatcher extends CustomMatcher<Path> {
+        private final LinkOption[] options;
+
+        FileTypeMatcher(String typeName, LinkOption... options) {
+            super("Path is " + typeName);
+            this.options = options;
+        }
+
+        @Override
+        public boolean matches(Object item) {
+            if (item instanceof Path) {
+                Path path = (Path) item;
+                return matchPath(path);
+            } else {
+                return false;
+            }
+        }
+
+        protected abstract boolean matchPath(Path path);
+
+        @Override
+        public void describeMismatch(Object item, Description description) {
+            super.describeMismatch(item, description);
+            if (item instanceof Path) {
+                Path path = (Path) item;
+                if (Files.exists(path, options) == false) {
+                    description.appendText(" (file not found)");
+                } else if (Files.isDirectory(path, options)) {
+                    description.appendText(" (directory)");
+                } else if (Files.isSymbolicLink(path)) {
+                    description.appendText(" (symlink)");
+                } else if (Files.isRegularFile(path, options)) {
+                    description.appendText(" (regular file)");
+                } else {
+                    description.appendText(" (unknown file type)");
+                }
+            }
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/test/TestMatchers.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/test/TestMatchers.java
index 452805c859838..c1a290f509a58 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/test/TestMatchers.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/test/TestMatchers.java
@@ -20,6 +20,10 @@
 
 public class TestMatchers extends Matchers {
 
+    /**
+     * @deprecated Use {@link FileMatchers#pathExists}
+     */
+    @Deprecated
     public static Matcher<Path> pathExists(Path path, LinkOption... options) {
         return new CustomMatcher<Path>("Path " + path + " exists") {
             @Override
diff --git a/x-pack/plugin/security/cli/build.gradle b/x-pack/plugin/security/cli/build.gradle
index 82dda5ffa3998..116f089d70b46 100644
--- a/x-pack/plugin/security/cli/build.gradle
+++ b/x-pack/plugin/security/cli/build.gradle
@@ -19,6 +19,11 @@ dependencyLicenses {
   mapping from: /bc.*/, to: 'bouncycastle'
 }
 
+forbiddenPatterns {
+  exclude '**/*.p12'
+  exclude '**/*.jks'
+}
+
 if (BuildParams.inFipsJvm) {
   test.enabled = false
   testingConventions.enabled = false
diff --git a/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertGenUtils.java b/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertGenUtils.java
index bc2b27df58047..876fcfbf992fd 100644
--- a/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertGenUtils.java
+++ b/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertGenUtils.java
@@ -157,6 +157,14 @@ private static X509Certificate generateSignedCertificate(X500Principal principal
             throw new IllegalArgumentException("the certificate must be valid for at least one day");
         }
         final ZonedDateTime notAfter = notBefore.plusDays(days);
+        return generateSignedCertificate(principal, subjectAltNames, keyPair, caCert, caPrivKey, isCa, notBefore, notAfter,
+            signatureAlgorithm);
+    }
+
+    public static X509Certificate generateSignedCertificate(X500Principal principal, GeneralNames subjectAltNames, KeyPair keyPair,
+                                                             X509Certificate caCert, PrivateKey caPrivKey, boolean isCa,
+                                                             ZonedDateTime notBefore, ZonedDateTime notAfter, String signatureAlgorithm)
+        throws NoSuchAlgorithmException, CertIOException, OperatorCreationException, CertificateException {
         final BigInteger serial = CertGenUtils.getSerial();
         JcaX509ExtensionUtils extUtils = new JcaX509ExtensionUtils();
 
diff --git a/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertificateTool.java b/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertificateTool.java
index e3a0f4e7112c4..4ae1f313ce152 100644
--- a/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertificateTool.java
+++ b/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertificateTool.java
@@ -142,6 +142,7 @@ public static void main(String[] args) throws Exception {
         subcommands.put("csr", new SigningRequestCommand());
         subcommands.put("cert", new GenerateCertificateCommand());
         subcommands.put("ca", new CertificateAuthorityCommand());
+        subcommands.put("http", new HttpCertificateCommand());
     }
 
 
@@ -920,7 +921,7 @@ static Collection<CertificateInformation> parseFile(Path file) throws Exception
         }
     }
 
-    private static PEMEncryptor getEncrypter(char[] password) {
+    static PEMEncryptor getEncrypter(char[] password) {
         return new JcePEMEncryptorBuilder("DES-EDE3-CBC").setProvider(BC_PROV).build(password);
     }
 
@@ -1036,7 +1037,7 @@ private static PrivateKey readPrivateKey(Path path, char[] password, Terminal te
         }
     }
 
-    private static GeneralNames getSubjectAlternativeNamesValue(List<String> ipAddresses, List<String> dnsNames, List<String> commonNames) {
+    static GeneralNames getSubjectAlternativeNamesValue(List<String> ipAddresses, List<String> dnsNames, List<String> commonNames) {
         Set<GeneralName> generalNameList = new HashSet<>();
         for (String ip : ipAddresses) {
             generalNameList.add(new GeneralName(GeneralName.iPAddress, ip));
@@ -1056,7 +1057,7 @@ private static GeneralNames getSubjectAlternativeNamesValue(List<String> ipAddre
         return new GeneralNames(generalNameList.toArray(new GeneralName[0]));
     }
 
-    private static boolean isAscii(char[] str) {
+    static boolean isAscii(char[] str) {
         return ASCII_ENCODER.canEncode(CharBuffer.wrap(str));
     }
 
diff --git a/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommand.java b/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommand.java
new file mode 100644
index 0000000000000..604482ffb6f77
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommand.java
@@ -0,0 +1,1201 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.security.cli;
+
+import joptsimple.OptionParser;
+import joptsimple.OptionSet;
+import org.bouncycastle.asn1.DERIA5String;
+import org.bouncycastle.asn1.x509.GeneralNames;
+import org.bouncycastle.cert.CertIOException;
+import org.bouncycastle.openssl.jcajce.JcaMiscPEMGenerator;
+import org.bouncycastle.openssl.jcajce.JcaPEMWriter;
+import org.bouncycastle.operator.OperatorCreationException;
+import org.bouncycastle.operator.OperatorException;
+import org.bouncycastle.pkcs.PKCS10CertificationRequest;
+import org.bouncycastle.util.io.pem.PemObjectGenerator;
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.Version;
+import org.elasticsearch.cli.EnvironmentAwareCommand;
+import org.elasticsearch.cli.ExitCodes;
+import org.elasticsearch.cli.SuppressForbidden;
+import org.elasticsearch.cli.Terminal;
+import org.elasticsearch.cli.UserException;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.io.PathUtils;
+import org.elasticsearch.common.io.Streams;
+import org.elasticsearch.common.network.InetAddresses;
+import org.elasticsearch.common.util.set.Sets;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.xpack.core.ssl.CertParsingUtils;
+import org.elasticsearch.xpack.core.ssl.PemUtils;
+
+import javax.security.auth.x500.X500Principal;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.io.OutputStreamWriter;
+import java.io.PrintWriter;
+import java.io.UncheckedIOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.StandardOpenOption;
+import java.nio.file.attribute.PosixFileAttributeView;
+import java.nio.file.attribute.PosixFilePermission;
+import java.security.GeneralSecurityException;
+import java.security.Key;
+import java.security.KeyPair;
+import java.security.KeyStore;
+import java.security.KeyStoreException;
+import java.security.NoSuchAlgorithmException;
+import java.security.PrivateKey;
+import java.security.cert.Certificate;
+import java.security.cert.CertificateException;
+import java.security.cert.X509Certificate;
+import java.time.Period;
+import java.time.ZoneOffset;
+import java.time.ZonedDateTime;
+import java.time.format.DateTimeFormatter;
+import java.time.format.DateTimeParseException;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+import java.util.zip.ZipEntry;
+import java.util.zip.ZipOutputStream;
+
+import static org.elasticsearch.xpack.security.cli.CertGenUtils.generateSignedCertificate;
+
+/**
+ * This command is the "elasticsearch-certutil http" command. It provides a guided process for creating
+ * certificates or CSRs for the Rest (http/s) interface of Elasticsearch and configuring other stack products
+ * to trust this certificate.
+ */
+class HttpCertificateCommand extends EnvironmentAwareCommand {
+
+    static final int DEFAULT_CERT_KEY_SIZE = 2048;
+    static final Period DEFAULT_CERT_VALIDITY = Period.ofYears(5);
+
+    static final X500Principal DEFAULT_CA_NAME = new X500Principal("CN=Elasticsearch HTTP CA");
+    static final int DEFAULT_CA_KEY_SIZE = DEFAULT_CERT_KEY_SIZE;
+    static final Period DEFAULT_CA_VALIDITY = DEFAULT_CERT_VALIDITY;
+
+    private static final String ES_README_CSR = "es-readme-csr.txt";
+    private static final String ES_YML_CSR = "es-sample-csr.yml";
+    private static final String ES_README_P12 = "es-readme-p12.txt";
+    private static final String ES_YML_P12 = "es-sample-p12.yml";
+    private static final String CA_README_P12 = "ca-readme-p12.txt";
+    private static final String KIBANA_README = "kibana-readme.txt";
+    private static final String KIBANA_YML = "kibana-sample.yml";
+
+    /**
+     * Magic bytes for a non-empty PKCS#12 file
+     */
+    private static final byte[] MAGIC_BYTES1_PKCS12 = new byte[] { (byte) 0x30, (byte) 0x82 };
+    /**
+     * Magic bytes for an empty PKCS#12 file
+     */
+    private static final byte[] MAGIC_BYTES2_PKCS12 = new byte[] { (byte) 0x30, (byte) 0x56 };
+    /**
+     * Magic bytes for a JKS keystore
+     */
+    private static final byte[] MAGIC_BYTES_JKS = new byte[] { (byte) 0xFE, (byte) 0xED };
+
+    enum FileType {
+        PKCS12,
+        JKS,
+        PEM_CERT,
+        PEM_KEY,
+        PEM_CERT_CHAIN,
+        UNRECOGNIZED;
+    }
+
+    private class CertOptions {
+        final String name;
+        final X500Principal subject;
+        final List<String> dnsNames;
+        final List<String> ipNames;
+        final int keySize;
+        final Period validity;
+
+        private CertOptions(String name, X500Principal subject, List<String> dnsNames, List<String> ipNames, int keySize, Period validity) {
+            this.name = name;
+            this.subject = subject;
+            this.dnsNames = dnsNames;
+            this.ipNames = ipNames;
+            this.keySize = keySize;
+            this.validity = validity;
+        }
+    }
+
+    HttpCertificateCommand() {
+        super("generate a new certificate (or certificate request) for the Elasticsearch HTTP interface");
+    }
+
+    @Override
+    protected void execute(Terminal terminal, OptionSet options, Environment env) throws Exception {
+        printHeader("Elasticsearch HTTP Certificate Utility", terminal);
+
+        terminal.println("The 'http' command guides you through the process of generating certificates");
+        terminal.println("for use on the HTTP (Rest) interface for Elasticsearch.");
+        terminal.println("");
+        terminal.println("This tool will ask you a number of questions in order to generate the right");
+        terminal.println("set of files for your needs.");
+
+        final CertificateTool.CAInfo caInfo;
+        final Period validity;
+        final boolean csr = askCertSigningRequest(terminal);
+        if (csr) {
+            caInfo = null;
+            validity = null;
+        } else {
+            final boolean existingCa = askExistingCertificateAuthority(terminal);
+            if (existingCa) {
+                caInfo = findExistingCA(terminal, env);
+            } else {
+                caInfo = createNewCA(terminal);
+            }
+            terminal.println(Terminal.Verbosity.VERBOSE, "Using the following CA:");
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tSubject: " + caInfo.certAndKey.cert.getSubjectX500Principal());
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tIssuer: " + caInfo.certAndKey.cert.getIssuerX500Principal());
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tSerial: " + caInfo.certAndKey.cert.getSerialNumber());
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tExpiry: " + caInfo.certAndKey.cert.getNotAfter());
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tSignature Algorithm: " + caInfo.certAndKey.cert.getSigAlgName());
+
+            validity = getCertificateValidityPeriod(terminal);
+        }
+
+        final boolean multipleCertificates = askMultipleCertificates(terminal);
+        final List<CertOptions> certificates = new ArrayList<>();
+
+        String nodeDescription = multipleCertificates ? "node #1" : "your nodes";
+        while (true) {
+            final CertOptions cert = getCertificateConfiguration(terminal, multipleCertificates, nodeDescription, validity, csr);
+            terminal.println(Terminal.Verbosity.VERBOSE, "Generating the following " + (csr ? "CSR" : "Certificate") + ":");
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tName: " + cert.name);
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tSubject: " + cert.subject);
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tDNS Names: " + Strings.collectionToCommaDelimitedString(cert.dnsNames));
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tIP Names: " + Strings.collectionToCommaDelimitedString(cert.ipNames));
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tKey Size: " + cert.keySize);
+            terminal.println(Terminal.Verbosity.VERBOSE, "\tValidity: " + toString(cert.validity));
+            certificates.add(cert);
+
+            if (multipleCertificates && terminal.promptYesNo("Generate additional certificates?", true)) {
+                nodeDescription = "node #" + (certificates.size() + 1);
+            } else {
+                break;
+            }
+        }
+
+        printHeader("What password do you want for your private key(s)?", terminal);
+        char[] password;
+        if (csr) {
+            terminal.println("Your private key(s) will be stored as a PEM formatted file.");
+            terminal.println("We recommend that you protect your private keys with a password");
+            terminal.println("");
+            terminal.println("If you do not wish to use a password, simply press <enter> at the prompt below.");
+            password = readPassword(terminal, "Provide a password for the private key: ", true);
+        } else {
+            terminal.println("Your private key(s) will be stored in a PKCS#12 keystore file named \"http.p12\".");
+            terminal.println("This type of keystore is always password protected, but it is possible to use a");
+            terminal.println("blank password.");
+            terminal.println("");
+            terminal.println("If you wish to use a blank password, simply press <enter> at the prompt below.");
+            password = readPassword(terminal, "Provide a password for the \"http.p12\" file: ", true);
+        }
+
+        printHeader("Where should we save the generated files?", terminal);
+        if (csr) {
+            terminal.println("A number of files will be generated including your private key(s),");
+            terminal.println("certificate request(s), and sample configuration options for Elastic Stack products.");
+        } else {
+            terminal.println("A number of files will be generated including your private key(s),");
+            terminal.println("public certificate(s), and sample configuration options for Elastic Stack products.");
+        }
+        terminal.println("");
+        terminal.println("These files will be included in a single zip archive.");
+        terminal.println("");
+        Path output = resolvePath("elasticsearch-ssl-http.zip");
+        output = tryReadInput(terminal, "What filename should be used for the output zip file?", output, this::resolvePath);
+
+        writeZip(output, password, caInfo, certificates, env);
+        terminal.println("");
+        terminal.println("Zip file written to " + output);
+    }
+
+    /**
+     * Resolve a filename as a Path (suppressing forbidden APIs).
+     * Protected so tests can map String path-names to real path objects
+     */
+    @SuppressForbidden(reason = "CLI tool resolves files against working directory")
+    protected Path resolvePath(String name) {
+        return PathUtils.get(name).normalize().toAbsolutePath();
+    }
+
+    private void writeZip(Path file, char[] password, CertificateTool.CAInfo caInfo, List<CertOptions> certificates,
+                          Environment env) throws UserException {
+        if (Files.exists(file)) {
+            throw new UserException(ExitCodes.IO_ERROR, "Output file '" + file + "' already exists");
+        }
+
+        boolean success = false;
+        try {
+            try (OutputStream fileStream = Files.newOutputStream(file, StandardOpenOption.CREATE_NEW);
+                 ZipOutputStream zipStream = new ZipOutputStream(fileStream, StandardCharsets.UTF_8)) {
+
+                createZipDirectory(zipStream, "elasticsearch");
+                if (certificates.size() == 1) {
+                    writeCertificateAndKeyDetails(zipStream, "elasticsearch", certificates.get(0), caInfo, password, env);
+                } else {
+                    for (CertOptions cert : certificates) {
+                        final String dirName = "elasticsearch/" + cert.name;
+                        createZipDirectory(zipStream, dirName);
+                        writeCertificateAndKeyDetails(zipStream, dirName, cert, caInfo, password, env);
+                    }
+                }
+
+                if (caInfo != null && caInfo.generated) {
+                    createZipDirectory(zipStream, "ca");
+                    writeCertificateAuthority(zipStream, "ca", caInfo, env);
+                }
+
+                createZipDirectory(zipStream, "kibana");
+                writeKibanaInfo(zipStream, "kibana", caInfo, env);
+
+                /* TODO
+                createZipDirectory(zipStream, "beats");
+                writeBeatsInfo(zipStream, "beats", caInfo);
+
+                createZipDirectory(zipStream, "logstash");
+                writeLogstashInfo(zipStream, "logstash", caInfo);
+
+                createZipDirectory(zipStream, "lang-clients");
+                writeLangClientInfo(zipStream, "lang-clients", caInfo);
+
+                createZipDirectory(zipStream, "other");
+                writeMiscellaneousInfo(zipStream, "other", caInfo);
+                */
+
+                // set permissions to 600
+                PosixFileAttributeView view = Files.getFileAttributeView(file, PosixFileAttributeView.class);
+                if (view != null) {
+                    view.setPermissions(Sets.newHashSet(PosixFilePermission.OWNER_READ, PosixFilePermission.OWNER_WRITE));
+                }
+
+                success = true;
+            } finally {
+                if (success == false) {
+                    Files.deleteIfExists(file);
+                }
+            }
+        } catch (IOException e) {
+            throw new ElasticsearchException("Failed to write ZIP file '" + file + "'", e);
+        }
+    }
+
+    private void createZipDirectory(ZipOutputStream zip, String name) throws IOException {
+        ZipEntry entry = new ZipEntry(name + "/");
+        assert entry.isDirectory();
+        zip.putNextEntry(entry);
+    }
+
+    private void writeCertificateAndKeyDetails(ZipOutputStream zip, String dirName, CertOptions cert, CertificateTool.CAInfo ca,
+                                               char[] password, Environment env) {
+        // TODO : Should we add support for configuring PKI in ES?
+        try {
+            final KeyPair keyPair = CertGenUtils.generateKeyPair(cert.keySize);
+            final GeneralNames sanList = CertificateTool.getSubjectAlternativeNamesValue(cert.ipNames, cert.dnsNames, List.of());
+            final boolean hasPassword = password != null && password.length > 0;
+            // TODO Add info to the READMEs so that the user could regenerate these certs if needed.
+            // (i.e. show them the certutil cert command that they would need).
+            if (ca == null) {
+                // No local CA, generate a CSR instead
+                final PKCS10CertificationRequest csr = CertGenUtils.generateCSR(keyPair, cert.subject, sanList);
+                final String csrFile = "http-" + cert.name + ".csr";
+                final String keyFile = "http-" + cert.name + ".key";
+                final String certName = "http-" + cert.name + ".crt";
+                final String ymlFile = "sample-elasticsearch.yml";
+                final Map<String, String> substitutions = buildSubstitutions(env, Map.ofEntries(
+                    Map.entry("CSR", csrFile),
+                    Map.entry("KEY", keyFile),
+                    Map.entry("CERT", certName),
+                    Map.entry("YML", ymlFile),
+                    Map.entry("PASSWORD", hasPassword ? "*" : "")));
+                writeTextFile(zip, dirName + "/README.txt", ES_README_CSR, substitutions);
+                writePemEntry(zip, dirName + "/" + csrFile, new JcaMiscPEMGenerator(csr));
+                writePemEntry(zip, dirName + "/" + keyFile, generator(keyPair.getPrivate(), password));
+                writeTextFile(zip, dirName + "/" + ymlFile, ES_YML_CSR, substitutions);
+            } else {
+                final ZonedDateTime notBefore = ZonedDateTime.now(ZoneOffset.UTC);
+                final ZonedDateTime notAfter = notBefore.plus(cert.validity);
+                Certificate certificate = CertGenUtils.generateSignedCertificate(cert.subject, sanList, keyPair, ca.certAndKey.cert,
+                    ca.certAndKey.key, false, notBefore, notAfter, null);
+
+                final String p12Name = "http.p12";
+                final String ymlFile = "sample-elasticsearch.yml";
+                final Map<String, String> substitutions = buildSubstitutions(env, Map.ofEntries(
+                    Map.entry("P12", p12Name),
+                    Map.entry("YML", ymlFile),
+                    Map.entry("PASSWORD", hasPassword ? "*" : "")));
+                writeTextFile(zip, dirName + "/README.txt", ES_README_P12, substitutions);
+                writeKeyStore(zip, dirName + "/" + p12Name, certificate, keyPair.getPrivate(), password, ca.certAndKey.cert);
+                writeTextFile(zip, dirName + "/" + ymlFile, ES_YML_P12, substitutions);
+            }
+        } catch (OperatorException | IOException | GeneralSecurityException e) {
+            throw new ElasticsearchException("Failed to write certificate to ZIP file", e);
+        }
+    }
+
+    private void writeCertificateAuthority(ZipOutputStream zip, String dirName, CertificateTool.CAInfo ca, Environment env) {
+        assert ca != null;
+        assert ca.generated;
+
+        try {
+            writeTextFile(zip, dirName + "/README.txt", CA_README_P12,
+                buildSubstitutions(env, Map.of(
+                    "P12", "ca.p12",
+                    "DN", ca.certAndKey.cert.getSubjectX500Principal().getName(),
+                    "PASSWORD", ca.password == null || ca.password.length == 0 ? "" : "*"
+                )));
+            final KeyStore pkcs12 = KeyStore.getInstance("PKCS12");
+            pkcs12.load(null);
+            pkcs12.setKeyEntry("ca", ca.certAndKey.key, ca.password, new Certificate[] { ca.certAndKey.cert });
+            try (ZipEntryStream entry = new ZipEntryStream(zip, dirName + "/ca.p12")) {
+                pkcs12.store(entry, ca.password);
+            }
+        } catch (KeyStoreException | IOException | CertificateException | NoSuchAlgorithmException e) {
+            throw new ElasticsearchException("Failed to write CA to ZIP file", e);
+        }
+    }
+
+    private void writeKibanaInfo(ZipOutputStream zip, String dirName, CertificateTool.CAInfo ca, Environment env) {
+        final String caCertName = "elasticsearch-ca.pem";
+        final String caCert = ca == null ? "" : caCertName;
+        final String ymlFile = "sample-kibana.yml";
+
+        final Map<String, String> substitutions = buildSubstitutions(env, Map.ofEntries(
+            Map.entry("CA_CERT_NAME", caCertName),
+            Map.entry("CA_CERT", caCert),
+            Map.entry("YML", ymlFile)
+        ));
+
+        // TODO : Should we add support for client certs from Kibana to ES?
+
+        try {
+            writeTextFile(zip, dirName + "/README.txt", KIBANA_README, substitutions);
+            if (ca != null) {
+                writePemEntry(zip, dirName + "/" + caCert, new JcaMiscPEMGenerator(ca.certAndKey.cert));
+            }
+            writeTextFile(zip, dirName + "/" + ymlFile, KIBANA_YML, substitutions);
+        } catch (IOException e) {
+            throw new ElasticsearchException("Failed to write Kibana details ZIP file", e);
+        }
+    }
+
+    /**
+     * Loads {@code resource} from the classpath, performs variable substitution on it, and then writes it to {@code writer}.
+     */
+    private void writeTextFile(ZipOutputStream zip, String outputName, String resource, Map<String, String> substitutions) {
+        try (InputStream stream = getClass().getResourceAsStream("certutil-http/" + resource);
+             ZipEntryStream entry = new ZipEntryStream(zip, outputName);
+             PrintWriter writer = new PrintWriter(entry, false, StandardCharsets.UTF_8)) {
+            if (stream == null) {
+                throw new IllegalStateException("Cannot find internal resource " + resource);
+            }
+            copyWithSubstitutions(stream, writer, substitutions);
+            writer.flush();
+        } catch (IOException e) {
+            throw new UncheckedIOException("Cannot add resource " + resource + " to zip file", e);
+        }
+    }
+
+    /**
+     * Copies the input stream to the writer, while performing variable substitutions.
+     * The variable substitution processing supports 2 constructs
+     * <ol>
+     * <li>
+     * For each key in @{code substitutions}, any sequence of <code>${key}</code> in the input is replaced with the
+     * substitution value.
+     * </li>
+     * <li>
+     * Any line in the input that has the form <code>#if KEY</code> causes the following block to be output
+     * if-only-if KEY exists with a non-empty value in {@code substitutions}.
+     * A block is terminated with {@code #endif}. Lines with {@code #else} are also supported. Nested blocks are not supported.
+     * </li>
+     * </ol>
+     */
+    static void copyWithSubstitutions(InputStream stream, PrintWriter writer, Map<String, String> substitutions) throws IOException {
+        boolean skip = false;
+        for (String line : Streams.readAllLines(stream)) {
+            for (Map.Entry<String, String> subst : substitutions.entrySet()) {
+                line = line.replace("${" + subst.getKey() + "}", subst.getValue());
+            }
+            if (line.startsWith("#if ")) {
+                final String key = line.substring(4).trim();
+                skip = Strings.isNullOrEmpty(substitutions.get(key));
+                continue;
+            } else if (line.equals("#else")) {
+                skip = !skip;
+                continue;
+            } else if (line.equals("#endif")) {
+                skip = false;
+                continue;
+            } else if (skip) {
+                continue;
+            }
+            writer.println(line);
+        }
+    }
+
+    private Map<String, String> buildSubstitutions(Environment env, Map<String, String> entries) {
+        final Map<String, String> map = new HashMap<>(entries.size() + 4);
+        ZonedDateTime now = ZonedDateTime.now().withNano(0);
+        map.put("DATE", now.format(DateTimeFormatter.ISO_LOCAL_DATE));
+        map.put("TIME", now.format(DateTimeFormatter.ISO_OFFSET_TIME));
+        map.put("VERSION", Version.CURRENT.toString());
+        map.put("CONF_DIR", env.configFile().toAbsolutePath().toString());
+        map.putAll(entries);
+        return map;
+    }
+
+    private void writeKeyStore(ZipOutputStream zip, String name, Certificate certificate, PrivateKey key, char[] password,
+                               X509Certificate caCert) throws IOException, GeneralSecurityException {
+        final KeyStore pkcs12 = KeyStore.getInstance("PKCS12");
+        pkcs12.load(null);
+        pkcs12.setKeyEntry("http", key, password, new Certificate[] { certificate });
+        if (caCert != null) {
+            pkcs12.setCertificateEntry("ca", caCert);
+        }
+        try (ZipEntryStream entry = new ZipEntryStream(zip, name)) {
+            pkcs12.store(entry, password);
+        }
+    }
+
+    private void writePemEntry(ZipOutputStream zip, String name, PemObjectGenerator generator) throws IOException {
+        try (ZipEntryStream entry = new ZipEntryStream(zip, name);
+             JcaPEMWriter pem = new JcaPEMWriter(new OutputStreamWriter(entry, StandardCharsets.UTF_8))) {
+            pem.writeObject(generator);
+            pem.flush();
+        }
+    }
+
+    private JcaMiscPEMGenerator generator(PrivateKey privateKey, char[] password) throws IOException {
+        if (password == null || password.length == 0) {
+            return new JcaMiscPEMGenerator(privateKey);
+        }
+        return new JcaMiscPEMGenerator(privateKey, CertificateTool.getEncrypter(password));
+    }
+
+    private Period getCertificateValidityPeriod(Terminal terminal) {
+        printHeader("How long should your certificates be valid?", terminal);
+        terminal.println("Every certificate has an expiry date. When the expiry date is reached clients");
+        terminal.println("will stop trusting your certificate and TLS connections will fail.");
+        terminal.println("");
+        terminal.println("Best practice suggests that you should either:");
+        terminal.println("(a) set this to a short duration (90 - 120 days) and have automatic processes");
+        terminal.println("to generate a new certificate before the old one expires, or");
+        terminal.println("(b) set it to a longer duration (3 - 5 years) and then perform a manual update");
+        terminal.println("a few months before it expires.");
+        terminal.println("");
+        terminal.println("You may enter the validity period in years (e.g. 3Y), months (e.g. 18M), or days (e.g. 90D)");
+        terminal.println("");
+
+        return readPeriodInput(terminal, "For how long should your certificate be valid?", DEFAULT_CERT_VALIDITY, 60);
+    }
+
+    private boolean askMultipleCertificates(Terminal terminal) {
+        printHeader("Do you wish to generate one certificate per node?", terminal);
+        terminal.println("If you have multiple nodes in your cluster, then you may choose to generate a");
+        terminal.println("separate certificate for each of these nodes. Each certificate will have its");
+        terminal.println("own private key, and will be issued for a specific hostname or IP address.");
+        terminal.println("");
+        terminal.println("Alternatively, you may wish to generate a single certificate that is valid");
+        terminal.println("across all the hostnames or addresses in your cluster.");
+        terminal.println("");
+        terminal.println("If all of your nodes will be accessed through a single domain");
+        terminal.println("(e.g. node01.es.example.com, node02.es.example.com, etc) then you may find it");
+        terminal.println("simpler to generate one certificate with a wildcard hostname (*.es.example.com)");
+        terminal.println("and use that across all of your nodes.");
+        terminal.println("");
+        terminal.println("However, if you do not have a common domain name, and you expect to add");
+        terminal.println("additional nodes to your cluster in the future, then you should generate a");
+        terminal.println("certificate per node so that you can more easily generate new certificates when");
+        terminal.println("you provision new nodes.");
+        terminal.println("");
+        return terminal.promptYesNo("Generate a certificate per node?", false);
+    }
+
+    private CertOptions getCertificateConfiguration(Terminal terminal, boolean multipleCertificates, String nodeDescription,
+                                                    Period validity, boolean csr) {
+
+        String certName = null;
+        if (multipleCertificates) {
+            printHeader("What is the name of " + nodeDescription + "?", terminal);
+            terminal.println("This name will be used as part of the certificate file name, and as a");
+            terminal.println("descriptive name within the certificate.");
+            terminal.println("");
+            terminal.println("You can use any descriptive name that you like, but we recommend using the name");
+            terminal.println("of the Elasticsearch node.");
+            terminal.println("");
+            certName = terminal.readText(nodeDescription + " name: ");
+            nodeDescription = certName;
+        }
+
+        printHeader("Which hostnames will be used to connect to " + nodeDescription + "?", terminal);
+        terminal.println("These hostnames will be added as \"DNS\" names in the \"Subject Alternative Name\"");
+        terminal.println("(SAN) field in your certificate.");
+        terminal.println("");
+        terminal.println("You should list every hostname and variant that people will use to connect to");
+        terminal.println("your cluster over http.");
+        terminal.println("Do not list IP addresses here, you will be asked to enter them later.");
+        terminal.println("");
+        terminal.println("If you wish to use a wildcard certificate (for example *.es.example.com) you");
+        terminal.println("can enter that here.");
+
+        final List<String> dnsNames = new ArrayList<>();
+        while (true) {
+            terminal.println("");
+            terminal.println("Enter all the hostnames that you need, one per line." );
+            terminal.println("When you are done, press <ENTER> once more to move on to the next step.");
+            terminal.println("");
+
+            dnsNames.addAll(readMultiLineInput(terminal, this::validateHostname));
+            if (dnsNames.isEmpty()) {
+                terminal.println(Terminal.Verbosity.SILENT, "You did not enter any hostnames.");
+                terminal.println("Clients are likely to encounter TLS hostname verification errors if they");
+                terminal.println("connect to your cluster using a DNS name.");
+            } else {
+                terminal.println(Terminal.Verbosity.SILENT, "You entered the following hostnames.");
+                terminal.println(Terminal.Verbosity.SILENT, "");
+                dnsNames.forEach(s -> terminal.println(Terminal.Verbosity.SILENT, " - " + s));
+            }
+            terminal.println("");
+            if (terminal.promptYesNo("Is this correct", true)) {
+                break;
+            } else {
+                dnsNames.clear();
+            }
+        }
+
+        printHeader("Which IP addresses will be used to connect to " + nodeDescription + "?", terminal);
+        terminal.println("If your clients will ever connect to your nodes by numeric IP address, then you");
+        terminal.println("can list these as valid IP \"Subject Alternative Name\" (SAN) fields in your");
+        terminal.println("certificate.");
+        terminal.println("");
+        terminal.println("If you do not have fixed IP addresses, or not wish to support direct IP access");
+        terminal.println("to your cluster then you can just press <ENTER> to skip this step.");
+
+        final List<String> ipNames = new ArrayList<>();
+        while (true) {
+            terminal.println("");
+            terminal.println("Enter all the IP addresses that you need, one per line.");
+            terminal.println("When you are done, press <ENTER> once more to move on to the next step.");
+            terminal.println("");
+
+            ipNames.addAll(readMultiLineInput(terminal, this::validateIpAddress));
+            if (ipNames.isEmpty()) {
+                terminal.println(Terminal.Verbosity.SILENT, "You did not enter any IP addresses.");
+            } else {
+                terminal.println(Terminal.Verbosity.SILENT, "You entered the following IP addresses.");
+                terminal.println(Terminal.Verbosity.SILENT, "");
+                ipNames.forEach(s -> terminal.println(Terminal.Verbosity.SILENT, " - " + s));
+            }
+            terminal.println("");
+            if (terminal.promptYesNo("Is this correct", true)) {
+                break;
+            } else {
+                ipNames.clear();
+            }
+        }
+
+        printHeader("Other certificate options", terminal);
+        terminal.println("The generated certificate will have the following additional configuration");
+        terminal.println("values. These values have been selected based on a combination of the");
+        terminal.println("information you have provided above and secure defaults. You should not need to");
+        terminal.println("change these values unless you have specific requirements.");
+        terminal.println("");
+
+        if (certName == null) {
+            certName = dnsNames.stream().filter(n -> n.indexOf('*') == -1).findFirst()
+                .or(() -> dnsNames.stream().map(s -> s.replace("*.", "")).findFirst())
+                .orElse("elasticsearch");
+        }
+        X500Principal dn = buildDistinguishedName(certName);
+        int keySize = DEFAULT_CERT_KEY_SIZE;
+        while (true) {
+            terminal.println(Terminal.Verbosity.SILENT, "Key Name: " + certName);
+            terminal.println(Terminal.Verbosity.SILENT, "Subject DN: " + dn);
+            terminal.println(Terminal.Verbosity.SILENT, "Key Size: " + keySize);
+            terminal.println(Terminal.Verbosity.SILENT, "");
+            if (terminal.promptYesNo("Do you wish to change any of these options?", false) == false) {
+                break;
+            }
+
+            printHeader("What should your key be named?", terminal);
+            if (csr) {
+                terminal.println("This will be included in the name of the files that are generated");
+            } else {
+                terminal.println("This will be the entry name in the PKCS#12 keystore that is generated");
+            }
+            terminal.println("It is helpful to have a meaningful name for this key");
+            terminal.println("");
+            certName = tryReadInput(terminal, "Key Name", certName, Function.identity());
+
+            printHeader("What subject DN should be used for your certificate?", terminal);
+            terminal.println("This will be visible to clients.");
+            terminal.println("It is helpful to have a meaningful name for each certificate");
+            terminal.println("");
+            dn = tryReadInput(terminal, "Subject DN", dn, name -> {
+                try {
+                    if (name.contains("=")) {
+                        return new X500Principal(name);
+                    } else {
+                        return new X500Principal("CN=" + name);
+                    }
+                } catch (IllegalArgumentException e) {
+                    terminal.println(Terminal.Verbosity.SILENT, "'" + name + "' is not a valid DN (" + e.getMessage() + ")");
+                    return null;
+                }
+            });
+
+            printHeader("What key size should your certificate have?", terminal);
+            terminal.println("The RSA private key for your certificate has a fixed 'key size' (in bits).");
+            terminal.println("Larger key sizes are generally more secure, but are also slower.");
+            terminal.println("");
+            terminal.println("We recommend that you use one of 2048, 3072 or 4096 bits for your key.");
+
+            keySize = readKeySize(terminal, keySize);
+            terminal.println("");
+        }
+
+        return new CertOptions(certName, dn, dnsNames, ipNames, keySize, validity);
+    }
+
+    private String validateHostname(String name) {
+        if (DERIA5String.isIA5String(name)) {
+            return null;
+        } else {
+            return name + " is not a valid DNS name";
+        }
+    }
+
+    private String validateIpAddress(String ip) {
+        if (InetAddresses.isInetAddress(ip)) {
+            return null;
+        } else {
+            return ip + " is not a valid IP address";
+        }
+    }
+
+    private X500Principal buildDistinguishedName(String name) {
+        return new X500Principal("CN=" + name.replace(".", ",DC="));
+    }
+
+    private List<String> readMultiLineInput(Terminal terminal, Function<String, String> validator) {
+        final List<String> lines = new ArrayList<>();
+        while (true) {
+            String input = terminal.readText("");
+            if (Strings.isEmpty(input)) {
+                break;
+            } else {
+                final String error = validator.apply(input);
+                if (error == null) {
+                    lines.add(input);
+                } else {
+                    terminal.println("Error: " + error);
+                }
+            }
+        }
+        return lines;
+    }
+
+
+    private boolean askCertSigningRequest(Terminal terminal) {
+        printHeader("Do you wish to generate a Certificate Signing Request (CSR)?", terminal);
+
+        terminal.println("A CSR is used when you want your certificate to be created by an existing");
+        terminal.println("Certificate Authority (CA) that you do not control (that is, you don't have");
+        terminal.println("access to the keys for that CA). ");
+        terminal.println("");
+        terminal.println("If you are in a corporate environment with a central security team, then you");
+        terminal.println("may have an existing Corporate CA that can generate your certificate for you.");
+        terminal.println("Infrastructure within your organisation may already be configured to trust this");
+        terminal.println("CA, so it may be easier for clients to connect to Elasticsearch if you use a");
+        terminal.println("CSR and send that request to the team that controls your CA.");
+        terminal.println("");
+        terminal.println("If you choose not to generate a CSR, this tool will generate a new certificate");
+        terminal.println("for you. That certificate will be signed by a CA under your control. This is a");
+        terminal.println("quick and easy way to secure your cluster with TLS, but you will need to");
+        terminal.println("configure all your clients to trust that custom CA.");
+
+        terminal.println("");
+        return terminal.promptYesNo("Generate a CSR?", false);
+    }
+
+    private CertificateTool.CAInfo findExistingCA(Terminal terminal, Environment env) throws UserException {
+        printHeader("What is the path to your CA?", terminal);
+
+        terminal.println("Please enter the full pathname to the Certificate Authority that you wish to");
+        terminal.println("use for signing your new http certificate. This can be in PKCS#12 (.p12), JKS");
+        terminal.println("(.jks) or PEM (.crt, .key, .pem) format.");
+
+        final Path caPath = requestPath("CA Path: ", terminal, env, true);
+        final FileType fileType = guessFileType(caPath, terminal);
+        switch (fileType) {
+
+            case PKCS12:
+            case JKS:
+                terminal.println(Terminal.Verbosity.VERBOSE, "CA file " + caPath + " appears to be a " + fileType + " keystore");
+                return readKeystoreCA(caPath, fileType, terminal);
+
+            case PEM_KEY:
+                printHeader("What is the path to your CA certificate?", terminal);
+                terminal.println(caPath + " appears to be a PEM formatted private key file.");
+                terminal.println("In order to use it for signing we also need access to the certificate");
+                terminal.println("that corresponds to that key.");
+                terminal.println("");
+                final Path caCertPath = requestPath("CA Certificate: ", terminal, env, true);
+                return readPemCA(caCertPath, caPath, terminal);
+
+            case PEM_CERT:
+                printHeader("What is the path to your CA key?", terminal);
+                terminal.println(caPath + " appears to be a PEM formatted certificate file.");
+                terminal.println("In order to use it for signing we also need access to the private key");
+                terminal.println("that corresponds to that certificate.");
+                terminal.println("");
+                final Path caKeyPath = requestPath("CA Key: ", terminal, env, true);
+                return readPemCA(caPath, caKeyPath, terminal);
+
+            case PEM_CERT_CHAIN:
+                terminal.println(Terminal.Verbosity.SILENT, "The file at " + caPath + " contains multiple certificates.");
+                terminal.println("That type of file typically represents a certificate-chain");
+                terminal.println("This tool requires a single certificate for the CA");
+                throw new UserException(ExitCodes.DATA_ERROR, caPath + ": Unsupported file type (certificate chain)");
+
+
+            case UNRECOGNIZED:
+            default:
+                terminal.println(Terminal.Verbosity.SILENT, "The file at " + caPath + " isn't a file type that this tool recognises.");
+                terminal.println("Please try again with a CA in PKCS#12, JKS or PEM format");
+                throw new UserException(ExitCodes.DATA_ERROR, caPath + ": Unrecognized file type");
+        }
+    }
+
+    private CertificateTool.CAInfo createNewCA(Terminal terminal) {
+        terminal.println("A new Certificate Authority will be generated for you");
+
+        printHeader("CA Generation Options", terminal);
+        terminal.println("The generated certificate authority will have the following configuration values.");
+        terminal.println("These values have been selected based on secure defaults.");
+        terminal.println("You should not need to change these values unless you have specific requirements.");
+        terminal.println("");
+
+        X500Principal dn = DEFAULT_CA_NAME;
+        Period validity = DEFAULT_CA_VALIDITY;
+        int keySize = DEFAULT_CA_KEY_SIZE;
+        while (true) {
+            terminal.println(Terminal.Verbosity.SILENT, "Subject DN: " + dn);
+            terminal.println(Terminal.Verbosity.SILENT, "Validity: " + toString(validity));
+            terminal.println(Terminal.Verbosity.SILENT, "Key Size: " + keySize);
+            terminal.println(Terminal.Verbosity.SILENT, "");
+            if (terminal.promptYesNo("Do you wish to change any of these options?", false) == false) {
+                break;
+            }
+
+            printHeader("What should your CA be named?", terminal);
+            terminal.println("Every client that connects to your Elasticsearch cluster will need to trust");
+            terminal.println("this custom Certificate Authority.");
+            terminal.println("It is helpful to have a meaningful name for this CA");
+            terminal.println("");
+            dn = tryReadInput(terminal, "CA Name", dn, name -> {
+                try {
+                    if (name.contains("=")) {
+                        return new X500Principal(name);
+                    } else {
+                        return new X500Principal("CN=" + name);
+                    }
+                } catch (IllegalArgumentException e) {
+                    terminal.println(Terminal.Verbosity.SILENT, "'" + name + "' is not a valid CA name (" + e.getMessage() + ")");
+                    return null;
+                }
+            });
+
+            printHeader("How long should your CA be valid?", terminal);
+            terminal.println("Every certificate has an expiry date. When the expiry date is reached, clients");
+            terminal.println("will stop trusting your Certificate Authority and TLS connections will fail.");
+            terminal.println("");
+            terminal.println("We recommend that you set this to a long duration (3 - 5 years) and then perform a");
+            terminal.println("manual update a few months before it expires.");
+            terminal.println("You may enter the validity period in years (e.g. 3Y), months (e.g. 18M), or days (e.g. 90D)");
+
+            validity = readPeriodInput(terminal, "CA Validity", validity, 90);
+
+            printHeader("What key size should your CA have?", terminal);
+            terminal.println("The RSA private key for your Certificate Authority has a fixed 'key size' (in bits).");
+            terminal.println("Larger key sizes are generally more secure, but are also slower.");
+            terminal.println("");
+            terminal.println("We recommend that you use one of 2048, 3072 or 4096 bits for your key.");
+
+            keySize = readKeySize(terminal, keySize);
+            terminal.println("");
+        }
+
+        try {
+            final KeyPair keyPair = CertGenUtils.generateKeyPair(keySize);
+            final ZonedDateTime notBefore = ZonedDateTime.now(ZoneOffset.UTC);
+            final ZonedDateTime notAfter = notBefore.plus(validity);
+            X509Certificate caCert = generateSignedCertificate(dn, null, keyPair, null, null, true, notBefore, notAfter, null);
+
+            printHeader("CA password", terminal);
+            terminal.println("We recommend that you protect your CA private key with a strong password.");
+            terminal.println("If your key does not have a password (or the password can be easily guessed)");
+            terminal.println("then anyone who gets a copy of the key file will be able to generate new certificates");
+            terminal.println("and impersonate your Elasticsearch cluster.");
+            terminal.println("");
+            terminal.println("IT IS IMPORTANT THAT YOU REMEMBER THIS PASSWORD AND KEEP IT SECURE");
+            terminal.println("");
+            final char[] password = readPassword(terminal, "CA password: ", true);
+            return new CertificateTool.CAInfo(caCert, keyPair.getPrivate(), true, password.length == 0 ? null : password);
+        } catch (GeneralSecurityException | CertIOException | OperatorCreationException e) {
+            throw new IllegalArgumentException("Cannot generate CA key pair", e);
+        }
+    }
+
+    /**
+     * Read input from the terminal as a {@link Period}.
+     * Package protected for testing purposes.
+     */
+    Period readPeriodInput(Terminal terminal, String prompt, Period defaultValue, int recommendedMinimumDays) {
+        Period period = tryReadInput(terminal, prompt, defaultValue, input -> {
+            String periodInput = input.replaceAll("[,\\s]", "");
+            if (input.charAt(0) != 'P') {
+                periodInput = "P" + periodInput;
+            }
+            try {
+                final Period parsed = Period.parse(periodInput);
+                final long approxDays = 30 * parsed.toTotalMonths() + parsed.getDays();
+                if (approxDays < recommendedMinimumDays) {
+                    terminal.println("The period '" + toString(parsed) + "' is less than the recommended period");
+                    if (terminal.promptYesNo("Are you sure?", false) == false) {
+                        return null;
+                    }
+                }
+                return parsed;
+            } catch (DateTimeParseException e) {
+                terminal.println("Sorry, I do not understand '" + input + "' (" + e.getMessage() + ")");
+                return null;
+            }
+        });
+        return period;
+    }
+
+    private Integer readKeySize(Terminal terminal, int keySize) {
+        return tryReadInput(terminal, "Key Size", keySize, input -> {
+            try {
+                final int size = Integer.parseInt(input);
+                if (size < 1024) {
+                    terminal.println("Keys must be at least 1024 bits");
+                    return null;
+                }
+                if (size > 8192) {
+                    terminal.println("Keys cannot be larger than 8192 bits");
+                    return null;
+                }
+                if (size % 1024 != 0) {
+                    terminal.println("The key size should be a multiple of 1024 bits");
+                    return null;
+                }
+                return size;
+            } catch (NumberFormatException e) {
+                terminal.println("The key size must be a positive integer");
+                return null;
+            }
+        });
+    }
+
+    private char[] readPassword(Terminal terminal, String prompt, boolean confirm) {
+        while (true) {
+            final char[] password = terminal.readSecret(prompt + " [<ENTER> for none]");
+            if (password.length == 0) {
+                return password;
+            }
+            if (CertificateTool.isAscii(password)) {
+                if (confirm) {
+                    final char[] again = terminal.readSecret("Repeat password to confirm: ");
+                    if (Arrays.equals(password, again) == false) {
+                        terminal.println("Passwords do not match");
+                        continue;
+                    }
+                }
+                return password;
+            } else {
+                terminal.println(Terminal.Verbosity.SILENT, "Passwords must be plain ASCII");
+            }
+        }
+    }
+
+    private CertificateTool.CAInfo readKeystoreCA(Path ksPath, FileType fileType, Terminal terminal) throws UserException {
+        final String storeType = fileType == FileType.PKCS12 ? "PKCS12" : "jks";
+        terminal.println("Reading a " + storeType + " keystore requires a password.");
+        terminal.println("It is possible for the keystore's password to be blank,");
+        terminal.println("in which case you can simply press <ENTER> at the prompt");
+        final char[] password = terminal.readSecret("Password for " + ksPath.getFileName() + ":");
+        try {
+            final Map<Certificate, Key> keys = CertParsingUtils.readKeyPairsFromKeystore(ksPath, storeType, password, alias -> password);
+
+            if (keys.size() != 1) {
+                if (keys.isEmpty()) {
+                    terminal.println(Terminal.Verbosity.SILENT, "The keystore at " + ksPath + " does not contain any keys ");
+                } else {
+                    terminal.println(Terminal.Verbosity.SILENT, "The keystore at " + ksPath + " contains " + keys.size() + " keys,");
+                    terminal.println(Terminal.Verbosity.SILENT, "but this command requires a keystore with a single key");
+                }
+                terminal.println("Please try again with a keystore that contains exactly 1 private key entry");
+                throw new UserException(ExitCodes.DATA_ERROR, "The CA keystore " + ksPath + " contains " + keys.size() + " keys");
+            }
+            final Map.Entry<Certificate, Key> pair = keys.entrySet().iterator().next();
+            return new CertificateTool.CAInfo((X509Certificate) pair.getKey(), (PrivateKey) pair.getValue());
+        } catch (IOException | GeneralSecurityException e) {
+            throw new ElasticsearchException("Failed to read keystore " + ksPath, e);
+        }
+    }
+
+    private CertificateTool.CAInfo readPemCA(Path certPath, Path keyPath, Terminal terminal) throws UserException {
+        final X509Certificate cert = readCertificate(certPath, terminal);
+        final PrivateKey key = readPrivateKey(keyPath, terminal);
+        return new CertificateTool.CAInfo(cert, key);
+    }
+
+    private X509Certificate readCertificate(Path path, Terminal terminal) throws UserException {
+        try {
+            final X509Certificate[] certificates = CertParsingUtils.readX509Certificates(List.of(path));
+            switch (certificates.length) {
+                case 0:
+                    terminal.errorPrintln("Could not read any certificates from " + path);
+                    throw new UserException(ExitCodes.DATA_ERROR, path + ": No certificates found");
+                case 1:
+                    return certificates[0];
+                default:
+                    terminal.errorPrintln("Read [" + certificates.length + "] certificates from " + path + " but expected 1");
+                    throw new UserException(ExitCodes.DATA_ERROR, path + ": Multiple certificates found");
+            }
+        } catch (CertificateException | IOException e) {
+            throw new ElasticsearchException("Failed to read certificates from " + path, e);
+        }
+    }
+
+    private PrivateKey readPrivateKey(Path path, Terminal terminal) {
+        try {
+            return PemUtils.readPrivateKey(path, () -> {
+                terminal.println("");
+                terminal.println("The PEM key stored in " + path + " requires a password.");
+                terminal.println("");
+                return terminal.readSecret("Password for " + path.getFileName() + ":");
+            });
+        } catch (IOException e) {
+            throw new ElasticsearchException("Failed to read private key from " + path, e);
+        }
+    }
+
+
+    private boolean askExistingCertificateAuthority(Terminal terminal) {
+        printHeader("Do you have an existing Certificate Authority (CA) key-pair that you wish to use to sign your certificate?", terminal);
+        terminal.println("If you have an existing CA certificate and key, then you can use that CA to");
+        terminal.println("sign your new http certificate. This allows you to use the same CA across");
+        terminal.println("multiple Elasticsearch clusters which can make it easier to configure clients,");
+        terminal.println("and may be easier for you to manage.");
+        terminal.println("");
+        terminal.println("If you do not have an existing CA, one will be generated for you.");
+        terminal.println("");
+
+        return terminal.promptYesNo("Use an existing CA?", false);
+    }
+
+    private <T> T tryReadInput(Terminal terminal, String prompt, T defaultValue, Function<String, T> parser) {
+        final String defaultStr = defaultValue instanceof Period ? toString((Period) defaultValue) : String.valueOf(defaultValue);
+        while (true) {
+            final String input = terminal.readText(prompt + " [" + defaultStr + "] ");
+            if (Strings.isEmpty(input)) {
+                return defaultValue;
+            }
+            T parsed = parser.apply(input);
+            if (parsed != null) {
+                return parsed;
+            }
+        }
+    }
+
+    static String toString(Period period) {
+        if (period == null) {
+            return "N/A";
+        }
+        if (period.isZero()) {
+            return "0d";
+        }
+        List<String> parts = new ArrayList<>(3);
+        if (period.getYears() != 0) {
+            parts.add(period.getYears() + "y");
+        }
+        if (period.getMonths() != 0) {
+            parts.add(period.getMonths() + "m");
+        }
+        if (period.getDays() != 0) {
+            parts.add(period.getDays() + "d");
+        }
+        return Strings.collectionToCommaDelimitedString(parts);
+    }
+
+    private Path requestPath(String prompt, Terminal terminal, Environment env, boolean requireExisting) {
+        for (; ; ) {
+            final String input = terminal.readText(prompt);
+            final Path path = env.configFile().resolve(input).toAbsolutePath();
+
+            if (path.getFileName() == null) {
+                terminal.println(Terminal.Verbosity.SILENT, input + " is not a valid file");
+                continue;
+            }
+            if (requireExisting == false || Files.isReadable(path)) {
+                return path;
+            }
+
+            if (Files.notExists(path)) {
+                terminal.println(Terminal.Verbosity.SILENT, "The file " + path + " does not exist");
+            } else {
+                terminal.println(Terminal.Verbosity.SILENT, "The file " + path + " cannot be read");
+            }
+        }
+    }
+
+    static FileType guessFileType(Path path, Terminal terminal) {
+        // trust the extension for some file-types rather than inspecting the contents
+        // we don't rely on filename for PEM files because
+        // (a) users have a tendency to get things mixed up (e.g. naming something "key.crt")
+        // (b) we need to distinguish between Certs & Keys, so a ".pem" file is ambiguous
+        final String fileName = path == null ? "" : path.getFileName().toString().toLowerCase(Locale.ROOT);
+        if (fileName.endsWith(".p12") || fileName.endsWith(".pfx") || fileName.endsWith(".pkcs12")) {
+            return FileType.PKCS12;
+        }
+        if (fileName.endsWith(".jks")) {
+            return FileType.JKS;
+        }
+        // Sniff the file. We could just try loading them, but then we need to catch a variety of exceptions
+        // and guess what they mean. For example, loading a PKCS#12 needs a password, so we would need to
+        // distinguish between a "wrong/missing password" exception and a "not a PKCS#12 file" exception.
+        try (InputStream in = Files.newInputStream(path)) {
+            byte[] leadingBytes = new byte[2];
+            final int read = in.read(leadingBytes);
+            if (read < leadingBytes.length) {
+                // No supported file type has less than 2 bytes
+                return FileType.UNRECOGNIZED;
+            }
+            if (Arrays.equals(leadingBytes, MAGIC_BYTES1_PKCS12) || Arrays.equals(leadingBytes, MAGIC_BYTES2_PKCS12)) {
+                return FileType.PKCS12;
+            }
+            if (Arrays.equals(leadingBytes, MAGIC_BYTES_JKS)) {
+                return FileType.JKS;
+            }
+        } catch (IOException e) {
+            terminal.errorPrintln("Failed to read from file " + path);
+            terminal.errorPrintln(e.toString());
+            return FileType.UNRECOGNIZED;
+        }
+        // Probably a PEM file, but we need to know what type of object(s) it holds
+        try (Stream<String> lines = Files.lines(path, StandardCharsets.UTF_8)) {
+            final List<FileType> types = lines.filter(s -> s.startsWith("-----BEGIN")).map(s -> {
+                if (s.contains("BEGIN CERTIFICATE")) {
+                    return FileType.PEM_CERT;
+                } else if (s.contains("PRIVATE KEY")) {
+                    return FileType.PEM_KEY;
+                } else {
+                    return null;
+                }
+            }).filter(ft -> ft != null).collect(Collectors.toList());
+            switch (types.size()) {
+                case 0:
+                    // Not a PEM
+                    return FileType.UNRECOGNIZED;
+                case 1:
+                    return types.get(0);
+                default:
+                    if (types.contains(FileType.PEM_KEY)) {
+                        // A Key and something else. Could be a cert + key pair, but we don't support that
+                        terminal.errorPrintln("Cannot determine a type for the PEM file " + path + " because it contains: ["
+                            + Strings.collectionToCommaDelimitedString(types) + "]");
+                    } else {
+                        // Multiple certificates = chain
+                        return FileType.PEM_CERT_CHAIN;
+                    }
+            }
+        } catch (UncheckedIOException | IOException e) {
+            terminal.errorPrintln("Cannot determine the file type for " + path);
+            terminal.errorPrintln(e.toString());
+            return FileType.UNRECOGNIZED;
+        }
+        return FileType.UNRECOGNIZED;
+    }
+
+    private void printHeader(String text, Terminal terminal) {
+        terminal.println("");
+        terminal.println(Terminal.Verbosity.SILENT, "## " + text);
+        terminal.println("");
+    }
+
+    /**
+     * The standard zip output stream cannot be wrapped safely in another stream, because its close method closes the
+     * zip file, not just the entry.
+     * This class handles close correctly for a single entry
+     */
+    private class ZipEntryStream extends OutputStream {
+
+        private final ZipOutputStream zip;
+
+        ZipEntryStream(ZipOutputStream zip, String name) throws IOException {
+            this(zip, new ZipEntry(name));
+        }
+
+        ZipEntryStream(ZipOutputStream zip, ZipEntry entry) throws IOException {
+            this.zip = zip;
+            assert entry.isDirectory() == false;
+            zip.putNextEntry(entry);
+        }
+
+        @Override
+        public void write(int b) throws IOException {
+            zip.write(b);
+        }
+
+        @Override
+        public void write(byte[] b) throws IOException {
+            zip.write(b);
+        }
+
+        @Override
+        public void write(byte[] b, int off, int len) throws IOException {
+            zip.write(b, off, len);
+        }
+
+        @Override
+        public void flush() throws IOException {
+            zip.flush();
+        }
+
+        @Override
+        public void close() throws IOException {
+            zip.closeEntry();
+        }
+    }
+
+    // For testing
+    OptionParser getParser() {
+        return parser;
+    }
+}
diff --git a/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/ca-readme-p12.txt b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/ca-readme-p12.txt
new file mode 100644
index 0000000000000..dcd9c7c189811
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/ca-readme-p12.txt
@@ -0,0 +1,33 @@
+There are two files in this directory:
+
+1. This README file
+2. ${P12}
+
+## ${P12}
+
+The "${P12}" file is a PKCS#12 format keystore.
+It contains a copy of the certificate and private key for your Certificate Authority.
+
+You should keep this file secure, and should not provide it to anyone else.
+
+The sole purpose for this keystore is to generate new certificates if you add additional nodes to your Elasticsearch cluster, or need to
+update the server names (hostnames or IP addresses) of your nodes.
+
+This keystore is not required in order to operate any Elastic product or client.
+We recommended that you keep the file somewhere safe, and do not deploy it to your production servers.
+
+#if PASSWORD
+Your keystore is protected by a password.
+Your password has not been stored anywhere - it is your responsibility to keep it safe.
+#else
+Your keystore has a blank password.
+It is important that you protect this file - if someone else gains access to your private key they can impersonate your Elasticsearch node.
+#endif
+
+
+If you wish to create additional certificates for the nodes in your cluster you can provide this keystore to the "elasticsearch-certutil"
+utility as shown in the example below:
+
+    elasticsearch-certutil cert --ca ${P12} --dns "hostname.of.your.node" --pass
+
+See the elasticsearch-certutil documentation for additional options.
diff --git a/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-readme-csr.txt b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-readme-csr.txt
new file mode 100644
index 0000000000000..d6e1fce20275a
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-readme-csr.txt
@@ -0,0 +1,56 @@
+There are four files in this directory:
+
+1. This README file
+2. ${CSR}
+3. ${KEY}
+4. ${YML}
+
+## ${CSR}
+
+The "${CSR}" file is a Certificate Signing Request.
+You should provide a copy this file to a Certificate Authority ("CA"), and they will provide you with a signed Certificate.
+
+In many large organisations there is a central security team that operates an internal Certificate Authority that can generate your
+certificate for you. Alternatively, it may be possible to have a your certificate generated by a commercial Certificate Authority.
+
+In either case, you need to provide the ${CSR} file to the certificate authority, and they will provide you with your signed certificate.
+For the purposes of this document, we assume that when they send you your certificate, you will save it as a file named "${CERT}".
+
+The certificate authority might also provide you with a copy of their signing certificate. If they do, you should keep a copy of that
+certificate, as you may need it when configuring clients such as Kibana.
+
+## ${KEY}
+
+The "${KEY}" file is your private key.
+You should keep this file secure, and should not provide it to anyone else (not even the CA).
+
+Once you have a copy of your certificate (from the CA), you will configure your Elasticsearch nodes to use the certificate
+and this private key.
+You will need to copy both of those files to your elasticsearch configuration directory.
+
+#if PASSWORD
+Your private key is protected by a passphrase.
+Your password has not been stored anywhere - it is your responsibility to keep it safe.
+
+When you configure elasticsearch to enable SSL (but not before then), you will need to provide the key's password as a secure
+configuration setting in Elasticsearch so that it can decrypt your private key.
+
+The command for this is:
+
+   elasticsearch-keystore add "xpack.security.http.ssl.secure_key_passphrase"
+
+#else
+Your private key is not password protected.
+It is important that you protect this file - if someone else gains access to your private key they can impersonate your Elasticsearch node.
+#endif
+
+## ${YML}
+
+This is a sample configuration for Elasticsearch to enable SSL on the http interface.
+You can use this sample to update the "elasticsearch.yml" configuration file in your config directory.
+The location of this directory can vary depending on how you installed Elasticsearch, but based on your system it appears that your config
+directory is ${CONF_DIR}
+
+You will not be able to configure Elasticsearch until the Certificate Authority processes your CSR and provides you with a copy of your
+certificate. When you have a copy of the certificate you should copy it and the private key ("${KEY}") to the config directory.
+The sample config assumes that the certificate is named "${CERT}".
diff --git a/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-readme-p12.txt b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-readme-p12.txt
new file mode 100644
index 0000000000000..06f435116e3a0
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-readme-p12.txt
@@ -0,0 +1,38 @@
+There are three files in this directory:
+
+1. This README file
+2. ${P12}
+3. ${YML}
+
+## ${P12}
+
+The "${P12}" file is a PKCS#12 format keystore.
+It contains a copy of your certificate and the associated private key.
+You should keep this file secure, and should not provide it to anyone else.
+
+You will need to copy this file to your elasticsearch configuration directory.
+
+#if PASSWORD
+Your keystore is protected by a password.
+Your password has not been stored anywhere - it is your responsibility to keep it safe.
+
+When you configure elasticsearch to enable SSL (but not before then), you will need to provide the keystore's password as a secure
+configuration setting in Elasticsearch so that it can access your private key.
+
+The command for this is:
+
+   elasticsearch-keystore add "xpack.security.http.ssl.keystore.secure_password"
+
+#else
+Your keystore has a blank password.
+It is important that you protect this file - if someone else gains access to your private key they can impersonate your Elasticsearch node.
+#endif
+
+## ${YML}
+
+This is a sample configuration for Elasticsearch to enable SSL on the http interface.
+You can use this sample to update the "elasticsearch.yml" configuration file in your config directory.
+The location of this directory can vary depending on how you installed Elasticsearch, but based on your system it appears that your config
+directory is ${CONF_DIR}
+
+This sample configuration assumes that you have copied your ${P12} file directly into the config directory without renaming it.
\ No newline at end of file
diff --git a/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-sample-csr.yml b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-sample-csr.yml
new file mode 100644
index 0000000000000..9ce1624430ad8
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-sample-csr.yml
@@ -0,0 +1,32 @@
+#
+# SAMPLE ELASTICSEARCH CONFIGURATION FOR ENABLING SSL ON THE HTTP INTERFACE
+#
+# This is a sample configuration snippet for Elasticsearch that enables and configures SSL for the HTTP (Rest) interface
+#
+# This was automatically generated at: ${DATE} ${TIME}
+# This configuration was intended for Elasticsearch version ${VERSION}
+#
+# You should review these settings, and then update the main configuration file at
+#   ${CONF_DIR}/elasticsearch.yml
+#
+
+# This turns on SSL for the HTTP (Rest) interface
+xpack.security.http.ssl.enabled: true
+
+# This configures the certificate to use.
+# This certificate will be generated by your Certificate Authority, based on the CSR that you sent to them.
+xpack.security.http.ssl.certificate: "${CERT}"
+
+# This configures the private key for your certificate.
+#if PASSWORD
+# Because your private key is encrypted, you will also need to add the passphrase to the Elasticsearch keystore
+#    elasticsearch-keystore add "xpack.security.http.ssl.secure_key_passphrase"
+#endif
+xpack.security.http.ssl.key: "${KEY}"
+
+# If your Certificate Authorities provides you with a copy of their certificate you can configure it here.
+# This is not strictly necessary, but can make it easier when running other elasticsearch utilities such as the "setup-passwords" tool.
+#
+#xpack.security.http.ssl.certificate_authorities: [ "ca.crt" ]
+#
+
diff --git a/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-sample-p12.yml b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-sample-p12.yml
new file mode 100644
index 0000000000000..7658f56b47ddc
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/es-sample-p12.yml
@@ -0,0 +1,22 @@
+#
+# SAMPLE ELASTICSEARCH CONFIGURATION FOR ENABLING SSL ON THE HTTP INTERFACE
+#
+# This is a sample configuration snippet for Elasticsearch that enables and configures SSL for the HTTP (Rest) interface
+#
+# This was automatically generated at: ${DATE} ${TIME}
+# This configuration was intended for Elasticsearch version ${VERSION}
+#
+# You should review these settings, and then update the main configuration file at
+#   ${CONF_DIR}/elasticsearch.yml
+#
+
+# This turns on SSL for the HTTP (Rest) interface
+xpack.security.http.ssl.enabled: true
+
+# This configures the keystore to use for SSL on HTTP
+#if PASSWORD
+# Because your keystore has a password, you will also need to add the password to the Elasticsearch keystore
+#    elasticsearch-keystore add "xpack.security.http.ssl.keystore.secure_password"
+#endif
+xpack.security.http.ssl.keystore.path: "${P12}"
+
diff --git a/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/kibana-readme.txt b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/kibana-readme.txt
new file mode 100644
index 0000000000000..28d308b10a661
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/kibana-readme.txt
@@ -0,0 +1,62 @@
+#if CA_CERT
+There are three files in this directory:
+
+1. This README file
+2. ${CA_CERT}
+3. ${YML}
+
+#else
+There are two files in this directory:
+
+1. This README file
+2. ${YML}
+
+#endif
+#if CA_CERT
+## ${CA_CERT}
+
+The "${CA_CERT}" file is a PEM format X.509 Certificate for the Elasticsearch Certificate Authority.
+
+You need to configure Kibana to trust this certificate as an issuing CA for TLS connections to your Elasticsearch cluster.
+The "${YML}" file, and the instructions below, explain how to do this.
+
+#else
+Because your Elasticsearch certificates are being generated by an external CA (via a Certificate Signing Request), this directory does not
+contain a copy of the CA's issuing certificate (we don't know where you will send your CSRs and who will sign them).
+
+If you are using a public (commercial) CA then it is likely that Kibana will already be configured to trust this CA and you will not need
+to do any special configuration.
+
+However, if you are using a CA that is specific to your organisation, then you will need to configure Kibana to trust that CA.
+When your CA issues your certificate, you should ask them for a copy of their certificate chain in PEM format.
+
+The "${YML}" file, and the instructions below, explain what to do this with this file.
+
+#endif
+## ${YML}
+
+This is a sample configuration for Kibana to enable SSL for connections to Elasticsearch.
+You can use this sample to update the "kibana.yml" configuration file in your Kibana config directory.
+
+-------------------------------------------------------------------------------------------------
+NOTE:
+ You also need to update the URLs in your "elasticsearch.hosts" setting to use the "https" URL.
+ e.g. If your kibana.yml file currently has
+
+    elasticsearch.hosts: [ "http://localhost:9200" ]
+
+  then you should change this to:
+
+    elasticsearch.hosts: [ "https://localhost:9200" ]
+
+-------------------------------------------------------------------------------------------------
+
+#if CA_CERT
+The sample configuration assumes that you have copied the "${CA_CERT}" file directly into the Kibana config
+directory without renaming it.
+#else
+The sample configuration assumes that you have a file named "${CA_CERT_NAME}" which contains your CA's certificate
+chain, and have copied that file into the Kibana config directory.
+#endif
+
+
diff --git a/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/kibana-sample.yml b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/kibana-sample.yml
new file mode 100644
index 0000000000000..78a92782bdd1d
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/main/resources/org/elasticsearch/xpack/security/cli/certutil-http/kibana-sample.yml
@@ -0,0 +1,25 @@
+#
+# SAMPLE KIBANA CONFIGURATION FOR ENABLING SSL TO ELASTICSEARCH
+#
+# This is a sample configuration snippet for Kibana that configures SSL for connections to Elasticsearch
+#
+# This was automatically generated at: ${DATE} ${TIME}
+# This configuration was intended for version ${VERSION}
+#
+# You should review these settings, and then update the main kibana.yml configuration file.
+#
+#-------------------------------------------------------------------------------------------------
+#  You also need to update the URLs in your "elasticsearch.hosts" setting to use the "https" URL.
+#  e.g. If your kibana.yml file currently has
+#
+#  elasticsearch.hosts: [ "http://localhost:9200" ]
+#
+#  then you should change this to:
+#
+#  elasticsearch.hosts: [ "https://localhost:9200" ]
+#
+#-------------------------------------------------------------------------------------------------
+
+# This configures Kibana to trust a specific Certificate Authority for connections to Elasticsearch
+elasticsearch.ssl.certificateAuthorities: [ "config/${CA_CERT_NAME}" ]
+
diff --git a/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
new file mode 100644
index 0000000000000..891c4257666c1
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
@@ -0,0 +1,781 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.security.cli;
+
+import com.google.common.jimfs.Configuration;
+import com.google.common.jimfs.Jimfs;
+import joptsimple.OptionSet;
+import org.bouncycastle.asn1.DERIA5String;
+import org.bouncycastle.asn1.DEROctetString;
+import org.bouncycastle.asn1.DERSequence;
+import org.bouncycastle.asn1.pkcs.Attribute;
+import org.bouncycastle.asn1.pkcs.PKCSObjectIdentifiers;
+import org.bouncycastle.asn1.x509.Extension;
+import org.bouncycastle.asn1.x509.Extensions;
+import org.bouncycastle.asn1.x509.GeneralName;
+import org.bouncycastle.asn1.x509.GeneralNames;
+import org.bouncycastle.pkcs.PKCS10CertificationRequest;
+import org.bouncycastle.pkcs.jcajce.JcaPKCS10CertificationRequest;
+import org.bouncycastle.util.io.pem.PemObject;
+import org.bouncycastle.util.io.pem.PemReader;
+import org.elasticsearch.cli.MockTerminal;
+import org.elasticsearch.common.CheckedBiFunction;
+import org.elasticsearch.common.CheckedFunction;
+import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.network.NetworkAddress;
+import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ssl.CertParsingUtils;
+import org.elasticsearch.xpack.core.ssl.PemUtils;
+import org.elasticsearch.xpack.security.cli.HttpCertificateCommand.FileType;
+import org.hamcrest.Matchers;
+import org.junit.Before;
+import org.junit.BeforeClass;
+
+import javax.security.auth.x500.X500Principal;
+import java.io.ByteArrayInputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import java.net.InetAddress;
+import java.net.URI;
+import java.net.URISyntaxException;
+import java.net.UnknownHostException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.FileSystem;
+import java.nio.file.FileSystems;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.security.GeneralSecurityException;
+import java.security.Key;
+import java.security.KeyStore;
+import java.security.PrivateKey;
+import java.security.PublicKey;
+import java.security.Signature;
+import java.security.cert.Certificate;
+import java.security.cert.CertificateException;
+import java.security.cert.CertificateParsingException;
+import java.security.cert.X509Certificate;
+import java.security.interfaces.RSAKey;
+import java.time.Instant;
+import java.time.Period;
+import java.time.ZoneOffset;
+import java.time.ZonedDateTime;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+import static org.elasticsearch.test.FileMatchers.isDirectory;
+import static org.elasticsearch.test.FileMatchers.isRegularFile;
+import static org.elasticsearch.test.FileMatchers.pathExists;
+import static org.elasticsearch.xpack.security.cli.HttpCertificateCommand.guessFileType;
+import static org.hamcrest.Matchers.arrayWithSize;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.hasSize;
+import static org.hamcrest.Matchers.in;
+import static org.hamcrest.Matchers.instanceOf;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.notNullValue;
+import static org.hamcrest.Matchers.oneOf;
+
+public class HttpCertificateCommandTests extends ESTestCase {
+    private static final String CA_PASSWORD = "ca-password";
+    private FileSystem jimfs;
+    private Path testRoot;
+
+    @Before
+    public void createTestDir() throws Exception {
+        Configuration conf = Configuration.unix().toBuilder().setAttributeViews("posix").build();
+        jimfs = Jimfs.newFileSystem(conf);
+        testRoot = jimfs.getPath(getClass().getSimpleName() + "-" + getTestName());
+        IOUtils.rm(testRoot);
+        Files.createDirectories(testRoot);
+    }
+
+    @BeforeClass
+    public static void muteInFips() {
+        assumeFalse("Can't run in a FIPS JVM", inFipsJvm());
+    }
+
+    public void testGenerateSingleCertificateSigningRequest() throws Exception {
+        final Path outFile = testRoot.resolve("csr.zip").toAbsolutePath();
+
+        final List<String> hostNames = randomHostNames();
+        final List<String> ipAddresses = randomIpAddresses();
+        final String certificateName = hostNames.get(0);
+
+        final HttpCertificateCommand command = new PathAwareHttpCertificateCommand(outFile);
+
+        final MockTerminal terminal = new MockTerminal();
+
+        terminal.addTextInput("y"); // generate CSR
+
+        terminal.addTextInput(randomBoolean() ? "n" : ""); // cert-per-node
+
+        // enter hostnames
+        hostNames.forEach(terminal::addTextInput);
+        terminal.addTextInput(""); // end-of-hosts
+        terminal.addTextInput(randomBoolean() ? "y" : ""); // yes, correct
+
+        // enter ip names
+        ipAddresses.forEach(terminal::addTextInput);
+        terminal.addTextInput(""); // end-of-ips
+        terminal.addTextInput(randomBoolean() ? "y" : ""); // yes, correct
+
+        terminal.addTextInput(randomBoolean() ? "n" : ""); // don't change advanced settings
+
+        final String password = randomPassword();
+        terminal.addSecretInput(password);
+        terminal.addSecretInput(password); // confirm
+
+        terminal.addTextInput(outFile.toString());
+
+        final Environment env = newEnvironment();
+        final OptionSet options = command.getParser().parse(new String[0]);
+        command.execute(terminal, options, env);
+
+        Path zipRoot = getZipRoot(outFile);
+
+        assertThat(zipRoot.resolve("elasticsearch"), isDirectory());
+
+        final Path csrPath = zipRoot.resolve("elasticsearch/http-" + certificateName + ".csr");
+        final PKCS10CertificationRequest csr = readPemObject(csrPath, "CERTIFICATE REQUEST", PKCS10CertificationRequest::new);
+
+        final Path keyPath = zipRoot.resolve("elasticsearch/http-" + certificateName + ".key");
+        final AtomicBoolean wasEncrypted = new AtomicBoolean(false);
+        final PrivateKey privateKey = PemUtils.readPrivateKey(keyPath, () -> {
+            wasEncrypted.set(true);
+            return password.toCharArray();
+        });
+        assertTrue("Password should have been required to decrypted key", wasEncrypted.get());
+
+        final Path esReadmePath = zipRoot.resolve("elasticsearch/README.txt");
+        assertThat(esReadmePath, isRegularFile());
+        final String esReadme = Files.readString(esReadmePath);
+
+        final Path ymlPath = zipRoot.resolve("elasticsearch/sample-elasticsearch.yml");
+        assertThat(ymlPath, isRegularFile());
+        final String yml = Files.readString(ymlPath);
+
+        // Verify the CSR was built correctly
+        verifyCertificationRequest(csr, certificateName, hostNames, ipAddresses);
+
+        // Verify the key
+        assertMatchingPair(getPublicKey(csr), privateKey);
+
+        final String crtName = keyPath.getFileName().toString().replace(".csr", ".crt");
+
+        // Verify the README
+        assertThat(esReadme, containsString(csrPath.getFileName().toString()));
+        assertThat(esReadme, containsString(crtName));
+        assertThat(esReadme, containsString(keyPath.getFileName().toString()));
+        assertThat(esReadme, containsString(ymlPath.getFileName().toString()));
+        assertThat(esReadme, not(containsString(password)));
+
+        // Verify the yml
+        assertThat(yml, not(containsString(csrPath.getFileName().toString())));
+        assertThat(yml, containsString(crtName));
+        assertThat(yml, containsString(keyPath.getFileName().toString()));
+        assertThat(yml, not(containsString(password)));
+
+        // Should not be a CA directory in CSR mode
+        assertThat(zipRoot.resolve("ca"), not(pathExists()));
+
+        // No CA in CSR mode
+        verifyKibanaDirectory(zipRoot, false, List.of("Certificate Signing Request"), List.of(password, csrPath.getFileName().toString()));
+    }
+
+    public void testGenerateSingleCertificateWithExistingCA() throws Exception {
+        final Path outFile = testRoot.resolve("certs.zip").toAbsolutePath();
+
+        final List<String> hostNames = randomHostNames();
+        final List<String> ipAddresses = randomIpAddresses();
+        final String certificateName = hostNames.get(0);
+
+        final Path caCertPath = getDataPath("ca.crt");
+        assertThat(caCertPath, isRegularFile());
+        final Path caKeyPath = getDataPath("ca.key");
+        assertThat(caKeyPath, isRegularFile());
+        final String caPassword = CA_PASSWORD;
+
+        final int years = randomIntBetween(1, 8);
+
+        final HttpCertificateCommand command = new PathAwareHttpCertificateCommand(outFile);
+
+        final MockTerminal terminal = new MockTerminal();
+
+        terminal.addTextInput(randomBoolean() ? "n" : ""); // don't generate CSR
+        terminal.addTextInput("y"); // existing CA
+
+        // randomise between cert+key, key+cert, PKCS12 : the tool is smart enough to handle any of those.
+        switch (randomFrom(FileType.PEM_CERT, FileType.PEM_KEY, FileType.PKCS12)) {
+            case PEM_CERT:
+                terminal.addTextInput(caCertPath.toAbsolutePath().toString());
+                terminal.addTextInput(caKeyPath.toAbsolutePath().toString());
+                break;
+            case PEM_KEY:
+                terminal.addTextInput(caKeyPath.toAbsolutePath().toString());
+                terminal.addTextInput(caCertPath.toAbsolutePath().toString());
+                break;
+            case PKCS12:
+                terminal.addTextInput(getDataPath("ca.p12").toAbsolutePath().toString());
+                break;
+        }
+        terminal.addSecretInput(caPassword);
+
+        terminal.addTextInput(years + "y"); // validity period
+
+        terminal.addTextInput(randomBoolean() ? "n" : ""); // don't use cert-per-node
+
+        // enter hostnames
+        hostNames.forEach(terminal::addTextInput);
+        terminal.addTextInput(""); // end-of-hosts
+        terminal.addTextInput(randomBoolean() ? "y" : ""); // yes, correct
+
+        // enter ip names
+        ipAddresses.forEach(terminal::addTextInput);
+        terminal.addTextInput(""); // end-of-ips
+        terminal.addTextInput(randomBoolean() ? "y" : ""); // yes, correct
+
+        terminal.addTextInput(randomBoolean() ? "n" : ""); // don't change advanced settings
+
+        final String password = randomPassword();
+        terminal.addSecretInput(password);
+        terminal.addSecretInput(password); // confirm
+
+        terminal.addTextInput(outFile.toString());
+
+        final Environment env = newEnvironment();
+        final OptionSet options = command.getParser().parse(new String[0]);
+        command.execute(terminal, options, env);
+
+        Path zipRoot = getZipRoot(outFile);
+
+        assertThat(zipRoot.resolve("elasticsearch"), isDirectory());
+
+        final Path p12Path = zipRoot.resolve("elasticsearch/http.p12");
+
+        final Path readmePath = zipRoot.resolve("elasticsearch/README.txt");
+        assertThat(readmePath, isRegularFile());
+        final String readme = Files.readString(readmePath);
+
+        final Path ymlPath = zipRoot.resolve("elasticsearch/sample-elasticsearch.yml");
+        assertThat(ymlPath, isRegularFile());
+        final String yml = Files.readString(ymlPath);
+
+        final Tuple<X509Certificate, PrivateKey> certAndKey = readCertificateAndKey(p12Path, password.toCharArray());
+
+        // Verify the Cert was built correctly
+        verifyCertificate(certAndKey.v1(), certificateName, years, hostNames, ipAddresses);
+        assertThat(getRSAKeySize(certAndKey.v1().getPublicKey()), is(HttpCertificateCommand.DEFAULT_CERT_KEY_SIZE));
+        assertThat(getRSAKeySize(certAndKey.v2()), is(HttpCertificateCommand.DEFAULT_CERT_KEY_SIZE));
+
+        final X509Certificate caCert = readPemCertificate(caCertPath);
+        verifyChain(certAndKey.v1(), caCert);
+
+        // Verify the README
+        assertThat(readme, containsString(p12Path.getFileName().toString()));
+        assertThat(readme, containsString(ymlPath.getFileName().toString()));
+        assertThat(readme, not(containsString(password)));
+        assertThat(readme, not(containsString(caPassword)));
+
+        // Verify the yml
+        assertThat(yml, containsString(p12Path.getFileName().toString()));
+        assertThat(yml, not(containsString(password)));
+        assertThat(yml, not(containsString(caPassword)));
+
+        // Should not be a CA directory when using an existing CA.
+        assertThat(zipRoot.resolve("ca"), not(pathExists()));
+
+        verifyKibanaDirectory(zipRoot, true, List.of("2. elasticsearch-ca.pem"),
+            List.of(password, caPassword, caKeyPath.getFileName().toString()));
+    }
+
+    public void testGenerateMultipleCertificateWithNewCA() throws Exception {
+        final Path outFile = testRoot.resolve("certs.zip").toAbsolutePath();
+
+        final int numberCerts = randomIntBetween(3, 6);
+        final String[] certNames = new String[numberCerts];
+        final String[] hostNames = new String[numberCerts];
+        for (int i = 0; i < numberCerts; i++) {
+            certNames[i] = randomAlphaOfLengthBetween(6, 12);
+            hostNames[i] = randomAlphaOfLengthBetween(4, 8);
+        }
+
+        final HttpCertificateCommand command = new PathAwareHttpCertificateCommand(outFile);
+
+        final MockTerminal terminal = new MockTerminal();
+
+        terminal.addTextInput(randomBoolean() ? "n" : ""); // don't generate CSR
+        terminal.addTextInput(randomBoolean() ? "n" : ""); // no existing CA
+
+        final String caDN;
+        final int caYears;
+        final int caKeySize;
+        // randomise whether to change CA defaults.
+        if (randomBoolean()) {
+            terminal.addTextInput("y"); // Change defaults
+            caDN = "CN=" + randomAlphaOfLengthBetween(3, 8);
+            caYears = randomIntBetween(1, 3);
+            caKeySize = randomFrom(2048, 3072, 4096);
+            terminal.addTextInput(caDN);
+            terminal.addTextInput(caYears + "y");
+            terminal.addTextInput(Integer.toString(caKeySize));
+            terminal.addTextInput("n"); // Don't change values
+        } else {
+            terminal.addTextInput(randomBoolean() ? "n" : ""); // Don't change defaults
+            caDN = HttpCertificateCommand.DEFAULT_CA_NAME.toString();
+            caYears = HttpCertificateCommand.DEFAULT_CA_VALIDITY.getYears();
+            caKeySize = HttpCertificateCommand.DEFAULT_CA_KEY_SIZE;
+        }
+
+        final String caPassword = randomPassword();
+        terminal.addSecretInput(caPassword);
+        terminal.addSecretInput(caPassword); // confirm
+
+        final int certYears = randomIntBetween(1, 8);
+        terminal.addTextInput(certYears + "y"); // node cert validity period
+
+        terminal.addTextInput("y"); // cert-per-node
+
+        for (int i = 0; i < numberCerts; i++) {
+            if (i != 0) {
+                terminal.addTextInput(randomBoolean() ? "y" : ""); // another cert
+            }
+
+            // certificate / node name
+            terminal.addTextInput(certNames[i]);
+
+            // enter hostname
+            terminal.addTextInput(hostNames[i]); // end-of-hosts
+            terminal.addTextInput(""); // end-of-hosts
+            terminal.addTextInput(randomBoolean() ? "y" : ""); // yes, correct
+
+            // no ip
+            terminal.addTextInput(""); // end-of-ip
+            terminal.addTextInput(randomBoolean() ? "y" : ""); // yes, correct
+
+            terminal.addTextInput(randomBoolean() ? "n" : ""); // don't change advanced settings
+        }
+        terminal.addTextInput("n"); // no more certs
+
+
+        final String password = randomPassword();
+        terminal.addSecretInput(password);
+        terminal.addSecretInput(password); // confirm
+
+        terminal.addTextInput(outFile.toString());
+
+        final Environment env = newEnvironment();
+        final OptionSet options = command.getParser().parse(new String[0]);
+        command.execute(terminal, options, env);
+
+        Path zipRoot = getZipRoot(outFile);
+
+        // Should have a CA directory with the generated CA.
+        assertThat(zipRoot.resolve("ca"), isDirectory());
+        final Path caPath = zipRoot.resolve("ca/ca.p12");
+        final Tuple<X509Certificate, PrivateKey> caCertKey = readCertificateAndKey(caPath, caPassword.toCharArray());
+        verifyCertificate(caCertKey.v1(), caDN.replaceFirst("CN=", ""), caYears, List.of(), List.of());
+        assertThat(getRSAKeySize(caCertKey.v1().getPublicKey()), is(caKeySize));
+        assertThat(getRSAKeySize(caCertKey.v2()), is(caKeySize));
+
+        assertThat(zipRoot.resolve("elasticsearch"), isDirectory());
+
+        for (int i = 0; i < numberCerts; i++) {
+            assertThat(zipRoot.resolve("elasticsearch/" + certNames[i]), isDirectory());
+            final Path p12Path = zipRoot.resolve("elasticsearch/" + certNames[i] + "/http.p12");
+            assertThat(p12Path, isRegularFile());
+
+            final Path readmePath = zipRoot.resolve("elasticsearch/" + certNames[i] + "/README.txt");
+            assertThat(readmePath, isRegularFile());
+            final String readme = Files.readString(readmePath);
+
+            final Path ymlPath = zipRoot.resolve("elasticsearch/" + certNames[i] + "/sample-elasticsearch.yml");
+            assertThat(ymlPath, isRegularFile());
+            final String yml = Files.readString(ymlPath);
+
+            final Tuple<X509Certificate, PrivateKey> certAndKey = readCertificateAndKey(p12Path, password.toCharArray());
+
+            // Verify the Cert was built correctly
+            verifyCertificate(certAndKey.v1(), certNames[i], certYears, List.of(hostNames[i]), List.of());
+            verifyChain(certAndKey.v1(), caCertKey.v1());
+            assertThat(getRSAKeySize(certAndKey.v1().getPublicKey()), is(HttpCertificateCommand.DEFAULT_CERT_KEY_SIZE));
+            assertThat(getRSAKeySize(certAndKey.v2()), is(HttpCertificateCommand.DEFAULT_CERT_KEY_SIZE));
+
+            // Verify the README
+            assertThat(readme, containsString(p12Path.getFileName().toString()));
+            assertThat(readme, containsString(ymlPath.getFileName().toString()));
+            assertThat(readme, not(containsString(password)));
+            assertThat(readme, not(containsString(caPassword)));
+
+            // Verify the yml
+            assertThat(yml, containsString(p12Path.getFileName().toString()));
+            assertThat(yml, not(containsString(password)));
+            assertThat(yml, not(containsString(caPassword)));
+        }
+
+        verifyKibanaDirectory(zipRoot, true, List.of("2. elasticsearch-ca.pem"),
+            List.of(password, caPassword, caPath.getFileName().toString()));
+    }
+
+    public void testParsingValidityPeriod() throws Exception {
+        final HttpCertificateCommand command = new HttpCertificateCommand();
+        final MockTerminal terminal = new MockTerminal();
+
+        terminal.addTextInput("2y");
+        assertThat(command.readPeriodInput(terminal, "", null, 1), is(Period.ofYears(2)));
+
+        terminal.addTextInput("18m");
+        assertThat(command.readPeriodInput(terminal, "", null, 1), is(Period.ofMonths(18)));
+
+        terminal.addTextInput("90d");
+        assertThat(command.readPeriodInput(terminal, "", null, 1), is(Period.ofDays(90)));
+
+        terminal.addTextInput("1y, 6m");
+        assertThat(command.readPeriodInput(terminal, "", null, 1), is(Period.ofYears(1).withMonths(6)));
+
+        // Test: Re-prompt on bad input.
+        terminal.addTextInput("2m & 4d");
+        terminal.addTextInput("2m 4d");
+        assertThat(command.readPeriodInput(terminal, "", null, 1), is(Period.ofMonths(2).withDays(4)));
+
+        terminal.addTextInput("1y, 6m");
+        assertThat(command.readPeriodInput(terminal, "", null, 1), is(Period.ofYears(1).withMonths(6)));
+
+        // Test: Accept default value
+        final Period p = Period.of(randomIntBetween(1, 5), randomIntBetween(0, 11), randomIntBetween(0, 30));
+        terminal.addTextInput("");
+        assertThat(command.readPeriodInput(terminal, "", p, 1), is(p));
+
+        final int y = randomIntBetween(1, 5);
+        final int m = randomIntBetween(1, 11);
+        final int d = randomIntBetween(1, 30);
+        terminal.addTextInput(y + "y " + m + "m " + d + "d");
+        assertThat(command.readPeriodInput(terminal, "", null, 1), is(Period.of(y, m, d)));
+
+        // Test: Minimum Days
+        final int shortDays = randomIntBetween(1, 20);
+
+        terminal.addTextInput(shortDays + "d");
+        terminal.addTextInput("y"); // I'm sure
+        assertThat(command.readPeriodInput(terminal, "", null, 21), is(Period.ofDays(shortDays)));
+
+        terminal.addTextInput(shortDays + "d");
+        terminal.addTextInput("n"); // I'm not sure
+        terminal.addTextInput("30d");
+        assertThat(command.readPeriodInput(terminal, "", null, 21), is(Period.ofDays(30)));
+
+        terminal.addTextInput("2m");
+        terminal.addTextInput("n"); // I'm not sure
+        terminal.addTextInput("2y");
+        assertThat(command.readPeriodInput(terminal, "", null, 90), is(Period.ofYears(2)));
+    }
+
+    public void testValidityPeriodToString() throws Exception {
+        assertThat(HttpCertificateCommand.toString(Period.ofYears(2)), is("2y"));
+        assertThat(HttpCertificateCommand.toString(Period.ofMonths(5)), is("5m"));
+        assertThat(HttpCertificateCommand.toString(Period.ofDays(60)), is("60d"));
+        assertThat(HttpCertificateCommand.toString(Period.ZERO), is("0d"));
+        assertThat(HttpCertificateCommand.toString(null), is("N/A"));
+
+        final int y = randomIntBetween(1, 5);
+        final int m = randomIntBetween(1, 11);
+        final int d = randomIntBetween(1, 30);
+        assertThat(HttpCertificateCommand.toString(Period.of(y, m, d)), is(y + "y," + m + "m," + d + "d"));
+    }
+
+    public void testGuessFileType() throws Exception {
+        MockTerminal terminal = new MockTerminal();
+
+        final Path caCert = getDataPath("ca.crt");
+        final Path caKey = getDataPath("ca.key");
+        assertThat(guessFileType(caCert, terminal), is(FileType.PEM_CERT));
+        assertThat(guessFileType(caKey, terminal), is(FileType.PEM_KEY));
+
+        final Path certChain = testRoot.resolve("ca.pem");
+        try (OutputStream out = Files.newOutputStream(certChain)) {
+            Files.copy(getDataPath("testnode.crt"), out);
+            Files.copy(caCert, out);
+        }
+        assertThat(guessFileType(certChain, terminal), is(FileType.PEM_CERT_CHAIN));
+
+        final Path tmpP12 = testRoot.resolve("tmp.p12");
+        assertThat(guessFileType(tmpP12, terminal), is(FileType.PKCS12));
+        final Path tmpJks = testRoot.resolve("tmp.jks");
+        assertThat(guessFileType(tmpJks, terminal), is(FileType.JKS));
+
+        final Path tmpKeystore = testRoot.resolve("tmp.keystore");
+        writeDummyKeystore(tmpKeystore, "PKCS12");
+        assertThat(guessFileType(tmpKeystore, terminal), is(FileType.PKCS12));
+        writeDummyKeystore(tmpKeystore, "jks");
+        assertThat(guessFileType(tmpKeystore, terminal), is(FileType.JKS));
+    }
+
+    public void testTextFileSubstitutions() throws Exception {
+        CheckedBiFunction<String, Map<String, String>, String, Exception> copy = (source, subs) -> {
+            try (InputStream in = new ByteArrayInputStream(source.getBytes(StandardCharsets.UTF_8));
+                 StringWriter out = new StringWriter();
+                 PrintWriter writer = new PrintWriter(out)) {
+                HttpCertificateCommand.copyWithSubstitutions(in, writer, subs);
+                return out.toString();
+            }
+        };
+        assertThat(copy.apply("abc\n", Map.of()), is("abc\n"));
+        assertThat(copy.apply("${not_a_var}\n", Map.of()), is("${not_a_var}\n"));
+        assertThat(copy.apply("${var}\n", Map.of("var", "xyz")), is("xyz\n"));
+        assertThat(copy.apply("#if not\nbody\n#endif\n", Map.of()), is(""));
+        assertThat(copy.apply("#if blank\nbody\n#endif\n", Map.of("blank", "")), is(""));
+        assertThat(copy.apply("#if yes\nbody\n#endif\n", Map.of("yes", "true")), is("body\n"));
+        assertThat(copy.apply("#if yes\ntrue\n#else\nfalse\n#endif\n", Map.of("yes", "*")), is("true\n"));
+        assertThat(copy.apply("#if blank\ntrue\n#else\nfalse\n#endif\n", Map.of("blank", "")), is("false\n"));
+        assertThat(copy.apply("#if var\n--> ${var} <--\n#else\n(${var})\n#endif\n", Map.of("var", "foo")), is("--> foo <--\n"));
+    }
+
+    private Path getZipRoot(Path outFile) throws IOException, URISyntaxException {
+        assertThat(outFile, isRegularFile());
+
+        FileSystem fileSystem = FileSystems.newFileSystem(new URI("jar:" + outFile.toUri()), Collections.emptyMap());
+        return fileSystem.getPath("/");
+    }
+
+    private List<String> randomIpAddresses() throws UnknownHostException {
+        final int ipCount = randomIntBetween(0, 3);
+        final List<String> ipAddresses = new ArrayList<>(ipCount);
+        for (int i = 0; i < ipCount; i++) {
+            String ip = randomIpAddress();
+            ipAddresses.add(ip);
+        }
+        return ipAddresses;
+    }
+
+    private String randomIpAddress() throws UnknownHostException {
+        return formatIpAddress(randomByteArrayOfLength(4));
+    }
+
+    private String formatIpAddress(byte[] addr) throws UnknownHostException {
+        return NetworkAddress.format(InetAddress.getByAddress(addr));
+    }
+
+    private List<String> randomHostNames() {
+        final int hostCount = randomIntBetween(1, 5);
+        final List<String> hostNames = new ArrayList<>(hostCount);
+        for (int i = 0; i < hostCount; i++) {
+            String host = String.join(".", randomArray(1, 4, String[]::new, () -> randomAlphaOfLengthBetween(3, 8)));
+            if (i > 0 && randomBoolean()) {
+                host = "*." + host;
+            }
+            hostNames.add(host);
+        }
+        return hostNames;
+    }
+
+    private String randomPassword() {
+        // We want to assert that this password doesn't end up in any output files, so we need to make sure we
+        // don't randomly generate a real word.
+        return randomAlphaOfLength(4) + randomFrom('~', '*', '%', '$', '|') + randomAlphaOfLength(4);
+    }
+
+    private void verifyCertificationRequest(PKCS10CertificationRequest csr, String certificateName, List<String> hostNames,
+                                            List<String> ipAddresses) throws IOException {
+        // We rebuild the DN from the encoding because BC uses openSSL style toString, but we use LDAP style.
+        assertThat(new X500Principal(csr.getSubject().getEncoded()).toString(), is("CN=" + certificateName.replaceAll("\\.", ", DC=")));
+        final Attribute[] extensionAttributes = csr.getAttributes(PKCSObjectIdentifiers.pkcs_9_at_extensionRequest);
+        assertThat(extensionAttributes, arrayWithSize(1));
+        assertThat(extensionAttributes[0].getAttributeValues(), arrayWithSize(1));
+        assertThat(extensionAttributes[0].getAttributeValues()[0], instanceOf(DERSequence.class));
+
+        // We register 1 extension - the subject alternative names
+        final Extensions extensions = Extensions.getInstance(extensionAttributes[0].getAttributeValues()[0]);
+        assertThat(extensions, notNullValue());
+        final GeneralNames names = GeneralNames.fromExtensions(extensions, Extension.subjectAlternativeName);
+        assertThat(names.getNames(), arrayWithSize(hostNames.size() + ipAddresses.size()));
+        for (GeneralName name : names.getNames()) {
+            assertThat(name.getTagNo(), oneOf(GeneralName.dNSName, GeneralName.iPAddress));
+            if (name.getTagNo() == GeneralName.dNSName) {
+                final String dns = DERIA5String.getInstance(name.getName()).getString();
+                assertThat(dns, in(hostNames));
+            } else if (name.getTagNo() == GeneralName.iPAddress) {
+                final String ip = formatIpAddress(DEROctetString.getInstance(name.getName()).getOctets());
+                assertThat(ip, in(ipAddresses));
+            }
+        }
+    }
+
+    private void verifyCertificate(X509Certificate cert, String certificateName, int years,
+                                   List<String> hostNames, List<String> ipAddresses) throws CertificateParsingException {
+        assertThat(cert.getSubjectX500Principal().toString(), is("CN=" + certificateName.replaceAll("\\.", ", DC=")));
+        final Collection<List<?>> san = cert.getSubjectAlternativeNames();
+        final int expectedSanEntries = hostNames.size() + ipAddresses.size();
+        if (expectedSanEntries > 0) {
+            assertThat(san, hasSize(expectedSanEntries));
+            for (List<?> name : san) {
+                assertThat(name, hasSize(2));
+                assertThat(name.get(0), Matchers.instanceOf(Integer.class));
+                assertThat(name.get(1), Matchers.instanceOf(String.class));
+                final Integer tag = (Integer) name.get(0);
+                final String value = (String) name.get(1);
+                assertThat(tag, oneOf(GeneralName.dNSName, GeneralName.iPAddress));
+                if (tag.intValue() == GeneralName.dNSName) {
+                    assertThat(value, in(hostNames));
+                } else if (tag.intValue() == GeneralName.iPAddress) {
+                    assertThat(value, in(ipAddresses));
+                }
+            }
+        } else if (san != null) {
+            assertThat(san, hasSize(0));
+        }
+
+        // We don't know exactly when the certificate was generated, but it should have been in the last 10 minutes
+        long now = System.currentTimeMillis();
+        long nowMinus10Minutes = now - TimeUnit.MINUTES.toMillis(10);
+        assertThat(cert.getNotBefore().getTime(), Matchers.lessThanOrEqualTo(now));
+        assertThat(cert.getNotBefore().getTime(), Matchers.greaterThanOrEqualTo(nowMinus10Minutes));
+
+        final ZonedDateTime expiry = Instant.ofEpochMilli(cert.getNotBefore().getTime()).atZone(ZoneOffset.UTC).plusYears(years);
+        assertThat(cert.getNotAfter().getTime(), is(expiry.toInstant().toEpochMilli()));
+    }
+
+    private void verifyChain(X509Certificate... chain) throws GeneralSecurityException {
+        for (int i = 1; i < chain.length; i++) {
+            assertThat(chain[i - 1].getIssuerX500Principal(), is(chain[i].getSubjectX500Principal()));
+            chain[i - 1].verify(chain[i].getPublicKey());
+        }
+        final X509Certificate root = chain[chain.length - 1];
+        assertThat(root.getIssuerX500Principal(), is(root.getSubjectX500Principal()));
+    }
+
+    /**
+     * Checks that a public + private key are a matching pair.
+     */
+    private void assertMatchingPair(PublicKey publicKey, PrivateKey privateKey) throws GeneralSecurityException {
+        final byte[] bytes = randomByteArrayOfLength(128);
+        final Signature rsa = Signature.getInstance("SHA512withRSA");
+
+        rsa.initSign(privateKey);
+        rsa.update(bytes);
+        final byte[] signature = rsa.sign();
+
+        rsa.initVerify(publicKey);
+        rsa.update(bytes);
+        assertTrue("PublicKey and PrivateKey are not a matching pair", rsa.verify(signature));
+    }
+
+    private void verifyKibanaDirectory(Path zipRoot, boolean expectCAFile, Iterable<String> readmeShouldContain,
+                                       Iterable<String> shouldNotContain) throws IOException {
+        assertThat(zipRoot.resolve("kibana"), isDirectory());
+        if (expectCAFile) {
+            assertThat(zipRoot.resolve("kibana/elasticsearch-ca.pem"), isRegularFile());
+        } else {
+            assertThat(zipRoot.resolve("kibana/elasticsearch-ca.pem"), not(pathExists()));
+        }
+
+        final Path kibanaReadmePath = zipRoot.resolve("kibana/README.txt");
+        assertThat(kibanaReadmePath, isRegularFile());
+        final String kibanaReadme = Files.readString(kibanaReadmePath);
+
+        final Path kibanaYmlPath = zipRoot.resolve("kibana/sample-kibana.yml");
+        assertThat(kibanaYmlPath, isRegularFile());
+        final String kibanaYml = Files.readString(kibanaYmlPath);
+
+        assertThat(kibanaReadme, containsString(kibanaYmlPath.getFileName().toString()));
+        assertThat(kibanaReadme, containsString("elasticsearch.hosts"));
+        assertThat(kibanaReadme, containsString("https://"));
+        assertThat(kibanaReadme, containsString("elasticsearch-ca.pem"));
+        readmeShouldContain.forEach(s -> assertThat(kibanaReadme, containsString(s)));
+        shouldNotContain.forEach(s -> assertThat(kibanaReadme, not(containsString(s))));
+
+        assertThat(kibanaYml, containsString("elasticsearch.ssl.certificateAuthorities: [ \"config/elasticsearch-ca.pem\" ]"));
+        assertThat(kibanaYml, containsString("https://"));
+        shouldNotContain.forEach(s -> assertThat(kibanaYml, not(containsString(s))));
+    }
+
+    private PublicKey getPublicKey(PKCS10CertificationRequest pkcs) throws GeneralSecurityException {
+        return new JcaPKCS10CertificationRequest(pkcs).getPublicKey();
+    }
+
+    private int getRSAKeySize(Key key) {
+        assertThat(key, instanceOf(RSAKey.class));
+        final RSAKey rsa = (RSAKey) key;
+        return rsa.getModulus().bitLength();
+    }
+
+    private Tuple<X509Certificate, PrivateKey> readCertificateAndKey(Path pkcs12,
+                                                                     char[] password) throws IOException, GeneralSecurityException {
+
+        final Map<Certificate, Key> entries = CertParsingUtils.readPkcs12KeyPairs(pkcs12, password, alias -> password);
+        assertThat(entries.entrySet(), Matchers.hasSize(1));
+
+        Certificate cert = entries.keySet().iterator().next();
+        Key key = entries.get(cert);
+
+        assertThat(cert, instanceOf(X509Certificate.class));
+        assertThat(key, instanceOf(PrivateKey.class));
+        assertMatchingPair(cert.getPublicKey(), (PrivateKey) key);
+        return new Tuple<>((X509Certificate) cert, (PrivateKey) key);
+    }
+
+    private X509Certificate readPemCertificate(Path caCertPath) throws CertificateException, IOException {
+        final Certificate[] certificates = CertParsingUtils.readCertificates(List.of(caCertPath));
+        assertThat(certificates, arrayWithSize(1));
+        final Certificate cert = certificates[0];
+        assertThat(cert, instanceOf(X509Certificate.class));
+        return (X509Certificate) cert;
+    }
+
+    private <T> T readPemObject(Path path, String expectedType,
+                                CheckedFunction<? super byte[], T, IOException> factory) throws IOException {
+        assertThat(path, isRegularFile());
+        final PemReader csrReader = new PemReader(Files.newBufferedReader(path));
+        final PemObject csrPem = csrReader.readPemObject();
+        assertThat(csrPem.getType(), is(expectedType));
+        return factory.apply(csrPem.getContent());
+    }
+
+    private void writeDummyKeystore(Path path, String type) throws GeneralSecurityException, IOException {
+        Files.deleteIfExists(path);
+        KeyStore ks = KeyStore.getInstance(type);
+        ks.load(null);
+        if (randomBoolean()) {
+            final X509Certificate cert = readPemCertificate(getDataPath("ca.crt"));
+            ks.setCertificateEntry(randomAlphaOfLength(4), cert);
+        }
+        try (OutputStream out = Files.newOutputStream(path)) {
+            ks.store(out, randomAlphaOfLength(8).toCharArray());
+        }
+    }
+
+    /**
+     * A special version of {@link HttpCertificateCommand} that can resolve input strings back to JIMFS paths
+     */
+    private class PathAwareHttpCertificateCommand extends HttpCertificateCommand {
+
+        final Map<String, Path> paths;
+
+        PathAwareHttpCertificateCommand(Path... configuredPaths) {
+            paths = Stream.of(configuredPaths).collect(Collectors.toUnmodifiableMap(Path::toString, Function.identity()));
+        }
+
+        @Override
+        protected Path resolvePath(String name) {
+            return Optional.ofNullable(this.paths.get(name)).orElseGet(() -> super.resolvePath(name));
+        }
+    }
+
+}
diff --git a/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/PemToKeystore.java b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/PemToKeystore.java
new file mode 100644
index 0000000000000..52974071dcfa8
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/PemToKeystore.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.security.cli;
+
+import org.elasticsearch.cli.SuppressForbidden;
+import org.elasticsearch.xpack.core.ssl.CertParsingUtils;
+import org.elasticsearch.xpack.core.ssl.PemUtils;
+
+import java.io.IOException;
+import java.io.OutputStream;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.security.GeneralSecurityException;
+import java.security.KeyStore;
+import java.security.PrivateKey;
+import java.security.cert.Certificate;
+import java.util.List;
+
+@SuppressForbidden(reason = "CLI utility for testing only")
+public class PemToKeystore {
+
+    public static void main(String[] args) throws IOException, GeneralSecurityException {
+        if (args.length != 5) {
+            System.out.println("Usage: <java> " + PemToKeystore.class.getName() + " <keystore> <PKCS12|jks> <cert> <key> <password>");
+            return;
+        }
+        Path keystorePath = Paths.get(args[0]).toAbsolutePath();
+        String keystoreType = args[1];
+        Path certPath = Paths.get(args[2]).toAbsolutePath();
+        Path keyPath = Paths.get(args[3]).toAbsolutePath();
+        char[] password = args[4].toCharArray();
+
+        final Certificate[] certificates = CertParsingUtils.readCertificates(List.of(certPath));
+        if (certificates.length == 0) {
+            throw new IllegalArgumentException("No certificates found in " + certPath);
+        }
+        final PrivateKey key = PemUtils.readPrivateKey(keyPath, () -> password);
+
+        KeyStore keyStore = KeyStore.getInstance(keystoreType);
+        keyStore.load(null);
+        keyStore.setKeyEntry("key", key, password, certificates);
+        try (OutputStream out = Files.newOutputStream(keystorePath)) {
+            keyStore.store(out, password);
+        }
+    }
+
+}
diff --git a/x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.crt b/x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.crt
new file mode 100644
index 0000000000000..111cf4d2af582
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.crt
@@ -0,0 +1,20 @@
+-----BEGIN CERTIFICATE-----
+MIIDSTCCAjGgAwIBAgIUe3y1qDBsjh2w16BBfPQjg5bAgjYwDQYJKoZIhvcNAQEL
+BQAwNDEyMDAGA1UEAxMpRWxhc3RpYyBDZXJ0aWZpY2F0ZSBUb29sIEF1dG9nZW5l
+cmF0ZWQgQ0EwHhcNMTkxMjAxMTEzNTUwWhcNMzMwODA5MTEzNTUwWjA0MTIwMAYD
+VQQDEylFbGFzdGljIENlcnRpZmljYXRlIFRvb2wgQXV0b2dlbmVyYXRlZCBDQTCC
+ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJdB/0UGumX8QsWAnhnadnza
+HsE0WMB50j6uHgqNh/QieIw7iQGmhbwG2V+O7263j74+YOUcrjvEuR3el1+cjJIU
+SP0Zl9wV2cWdltW3N/GhvU4QVnJS13w146yB3JEQROsD/hdtGP6vBGjzpjIcmKPa
+pSOqJEzG113CYX260FQK86o/9kAk07kce4sx8RW+Xda/e2eLF5siIH7/7eju9OiF
+RvQC1bABj0UpccuWwJWjIr93v5egTmQFHuX/Tlq44hhCKFa+0xh+LxdiAlbaeUGG
+e3sd1I20veMJAOTftGCOx6Psatcw0P2+FGsliQh8MIMwkcBwkxauuUNvWZpAd+UC
+AwEAAaNTMFEwHQYDVR0OBBYEFB1nLSbpN2TgSed4DBuhpwvC1CNqMB8GA1UdIwQY
+MBaAFB1nLSbpN2TgSed4DBuhpwvC1CNqMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZI
+hvcNAQELBQADggEBABPMW7mpIi8VyA2QwwBnUo8a3OdHdospwoHm5GIbxpOHILq/
+LWosNiJL/gFDVldt6nubIz/rkVqHjUf5H9DeMtlKdPCYJVZ1Cu9peEG3qPVhnTf6
+G6qwt7a6/a1/AwWIc+2EaC9t6VgqVN+Dbn4dH6uI0m+ZwfsTAVCCn4tQYf9/QcRw
+YHyl/C8nlWP0YwH0NDYug+J+MRewTpU+BYZPswH99HG954ZVylK00ZlQbeD6hj2w
+T/P8sHl9U2vkRiGeLDhP2ygI4glXFNU5VJQGqv2GWxo9XTHCkAjGovzU8D1wYdfX
+dWXUwN+qtcVdX3Ur/MowjzRumc6uWZjqEm12Vu4=
+-----END CERTIFICATE-----
diff --git a/x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.key b/x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.key
new file mode 100644
index 0000000000000..08ae669ce9908
--- /dev/null
+++ b/x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.key
@@ -0,0 +1,30 @@
+-----BEGIN RSA PRIVATE KEY-----
+Proc-Type: 4,ENCRYPTED
+DEK-Info: DES-EDE3-CBC,A4FFEDABB4598123
+
+Dx7CtxcKyx2clKjaj/c66anbFznGXnueMkWk4FLh9nYiSQmiTqzaE/ajSzH1Fdxm
+1/xBvbfFsUT6bdiGkxPEdGpgBCLnsebgjbQWv3lB0wtquhQkTfd8HoyShInnsPAb
+Hu5DSHkjvjIABl1MUyHiaZVskBEj/vYKsMil2GinrpWUxwOqg0HKyrKlzb/I7Gph
+Hc1NuzbRobtmQgi/JLVnOeVEIJFt3ekVQnEYQxM5+ZUsP85M6WoPOa7q8soGGLnO
+OFZ20kihb20/5xaA9SUadpYWFLSwZQYN2471MXj1uWz7mEJjei81mIjdTOem486P
+uIqNY1BBHzljjTq+r2mO/RKer5PRR+pbI+cNkRyESQZqitOHWWWPwXSo3K3RhhDK
+gaSOSMBLv2qoYjoswafIISIMvSbcnYzNa+p1T/U62Q95STMV1ch2Ulv+20xo4nVG
+3Mkr6oESB7MOcRm9XwPYZAb60MbaaFRUOagoId0AM7efLYTIpT6GXbnS0K6PPf2z
+cP/LKDh3pOgzjRIAN18+nZBY7D3r6fejWsBonMPlzgEX2hBPjmOLIBgpgO3/Kg2q
++PuSE+F53fPu3t5mxsEdPtM9yJTxfughvrNCxvaxfmajmZfHaMpta1Q2H9iEhv99
+L4nG1UtMJa9MMBPlTsJnkunvLcGQ8KfUMBHtlHwTwd5bP7vSs5aNGJKrdlOoKk3v
+O5DGbpfw/UIw2t+2dnqwc1epkYvMJbFc7S9hYMYwJZ1BC3zHxRvBJTJ6LbCxulWC
+SLUy/TZVsHSmRNftUJA48ioDSkA/inMziLmb/aqmWfvojiNmSJy/GkPJKyv1C9IK
+zPqE+7noy32Cf9hztu933YBBNWPPz9Xh8WC4AluQY9Lg2H8NjBjFadL0Re0QzdBF
+ZXEXT5otDthKqZpD5aRQGoleQcTYlIeJkODSgH+Ti7LvuiNJToG0iREyQRXpcsdj
+iVBP3jYe4nurHRnozQIfIF0BzArSRi0aRi9PHnregS4gkLtbyKx27T61bB47TYXk
+oIPm6qV7wWmVAklBz4+s3UXsTfyiqckdNxDDO+IyGEnEjpml/XePAy52hmGoQ9uI
+BCAst7JC0VuKcnad9u/2BL3WN+tyhNQ1zA3OcuNLiMT3mgAghadQq2hBiO2y2cT7
+b9OZLYwA4zLEzacIvo/0X1XtjiRANgZoUaMluyF5yVgnk9X9MmixBOT0pENV8GYx
+WbN0xDZPPigynnQTapnLgzOzci/MQZzuWfh1wvnkiKL7y8TXGtl6AvMtYX85yrUE
+Fakpleb8clKbSX2RQYlS/7+muO68e/m+svKaIS6ZupAlmu5rhlDsZAK6if+AEPpz
+C4AGsV7R9aDn+TZ+Zt+cxd7s+L8rexoMthblCprv3PwCSZ75Q52iLZeajfMhcI9A
+KWEra9QFT8kvIX2yuYFItuc9NL8s15zqNcaeUMyiw6gL28yBd7aQLbMj/zADOQGg
+qsb5QypRsxV/neh63I7PIQfIsFOJhM3+h9xAFK48nQzc39S7b2SMYdKPOfmEOFLi
+ln/q63+Bobl5EotOxb9gsQ0nWmKpQqFHsMzYQSwcJg+gGeBXy6RwIw==
+-----END RSA PRIVATE KEY-----
diff --git a/x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.p12 b/x-pack/plugin/security/cli/src/test/resources/org/elasticsearch/xpack/security/cli/ca.p12
new file mode 100644
index 0000000000000000000000000000000000000000..02114990b417f2e161be0f080ba5091daec07d90
GIT binary patch
literal 2529
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

literal 0
HcmV?d00001


From af8574331ea0bf5f4d385f6e975b32fac89c9757 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Mon, 13 Jan 2020 14:10:02 +0100
Subject: [PATCH 523/686] Move metadata storage to Lucene (#50907)

Today we split the on-disk cluster metadata across many files: one file for the metadata of each
index, plus one file for the global metadata and another for the manifest. Most metadata updates
only touch a few of these files, but some must write them all. If a node holds a large number of
indices then it's possible its disks are not fast enough to process a complete metadata update before timing out. In severe cases affecting master-eligible nodes this can prevent an election
from succeeding.

This commit uses Lucene as a metadata storage for the cluster state, and is a squashed version
of the following PRs that were targeting a feature branch:


* Introduce Lucene-based metadata persistence (#48733)

This commit introduces `LucenePersistedState` which master-eligible nodes
can use to persist the cluster metadata in a Lucene index rather than in
many separate files.

Relates #48701

* Remove per-index metadata without assigned shards (#49234)

Today on master-eligible nodes we maintain per-index metadata files for every
index. However, we also keep this metadata in the `LucenePersistedState`, and
only use the per-index metadata files for importing dangling indices. However
there is no point in importing a dangling index without any shard data, so we
do not need to maintain these extra files any more.

This commit removes per-index metadata files from nodes which do not hold any
shards of those indices.

Relates #48701

* Use Lucene exclusively for metadata storage (#50144)

This moves metadata persistence to Lucene for all node types. It also reenables BWC and adds
an interoperability layer for upgrades from prior versions.

This commit disables a number of tests related to dangling indices and command-line tools.
Those will be addressed in follow-ups.

Relates #48701

* Add command-line tool support for Lucene-based metadata storage (#50179)

Adds command-line tool support (unsafe-bootstrap, detach-cluster, repurpose, & shard
commands) for the Lucene-based metadata storage.

Relates #48701

* Use single directory for metadata (#50639)

Earlier PRs for #48701 introduced a separate directory for the cluster state. This is not needed
though, and introduces an additional unnecessary cognitive burden to the users.

Co-Authored-By: David Turner <david.turner@elastic.co>

* Add async dangling indices support (#50642)

Adds support for writing out dangling indices in an asynchronous way. Also provides an option to
avoid writing out dangling indices at all.

Relates #48701

* Fold node metadata into new node storage (#50741)

Moves node metadata to uses the new storage mechanism (see #48701) as the authoritative source.

* Write CS asynchronously on data-only nodes (#50782)

Writes cluster states out asynchronously on data-only nodes. The main reason for writing out
the cluster state at all is so that the data-only nodes can snap into a cluster, that they can do a
bit of bootstrap validation and so that the shard recovery tools work.
Cluster states that are written asynchronously have their voting configuration adapted to a non
existing configuration so that these nodes cannot mistakenly become master even if their node
role is changed back and forth.

Relates #48701

* Remove persistent cluster settings tool (#50694)

Adds the elasticsearch-node remove-settings tool to remove persistent settings from the on
disk cluster state in case where it contains incompatible settings that prevent the cluster from
forming.

Relates #48701

* Make cluster state writer resilient to disk issues (#50805)

Adds handling to make the cluster state writer resilient to disk issues. Relates to #48701

* Omit writing global metadata if no change (#50901)

Uses the same optimization for the new cluster state storage layer as the old one, writing global
metadata only when changed. Avoids writing out the global metadata if none of the persistent
fields changed. Speeds up server:integTest by ~10%.

Relates #48701

* DanglingIndicesIT should ensure node removed first (#50896)

These tests occasionally failed because the deletion was submitted before the
restarting node was removed from the cluster, causing the deletion not to be
fully acked. This commit fixes this by checking the restarting node has been
removed from the cluster.

Co-authored-by: David Turner <david.turner@elastic.co>
---
 docs/reference/commands/node-tool.asciidoc    |  73 +-
 .../coordination/CoordinationState.java       |  10 +-
 .../cluster/coordination/Coordinator.java     |   3 +-
 .../coordination/DetachClusterCommand.java    |  22 +-
 .../ElasticsearchNodeCommand.java             | 120 ++-
 .../cluster/coordination/NodeToolCli.java     |   1 +
 .../coordination/RemoveSettingsCommand.java   | 104 +++
 .../UnsafeBootstrapMasterCommand.java         |  79 +-
 .../metadata/MetaDataCreateIndexService.java  |   2 +-
 .../metadata/MetaDataIndexAliasesService.java |   2 +-
 .../MetaDataIndexTemplateService.java         |   2 +-
 .../metadata/MetaDataMappingService.java      |   2 +-
 .../common/settings/ClusterSettings.java      |   1 +
 .../elasticsearch/env/NodeEnvironment.java    |  67 +-
 .../env/NodeRepurposeCommand.java             | 113 ++-
 .../env/OverrideNodeVersionCommand.java       |  14 +-
 .../gateway/GatewayMetaState.java             | 467 +++++++----
 .../IncrementalClusterStateWriter.java        |  39 +-
 .../gateway/MetaStateService.java             |  47 +-
 .../gateway/PersistedClusterStateService.java | 770 +++++++++++++++++
 .../org/elasticsearch/index/IndexService.java |  42 +-
 .../RemoveCorruptedShardDataCommand.java      | 125 ++-
 .../translog/TruncateTranslogAction.java      |   9 +-
 .../elasticsearch/indices/IndicesService.java | 113 ++-
 .../cluster/IndicesClusterStateService.java   |   6 +-
 .../java/org/elasticsearch/node/Node.java     |  27 +-
 .../coordination/CoordinatorTests.java        |  11 +-
 .../coordination/RemoveSettingsCommandIT.java | 135 +++
 .../UnsafeBootstrapAndDetachCommandIT.java    | 162 +---
 .../elasticsearch/env/NodeEnvironmentIT.java  |  51 +-
 .../env/NodeEnvironmentTests.java             |   4 +-
 .../env/NodeRepurposeCommandIT.java           |  22 +-
 .../env/NodeRepurposeCommandTests.java        | 127 ++-
 .../env/OverrideNodeVersionCommandTests.java  | 125 +--
 .../gateway/GatewayIndexStateIT.java          |  68 +-
 .../GatewayMetaStatePersistedStateTests.java  | 458 +++++++---
 .../IncrementalClusterStateWriterTests.java   |   2 +-
 .../gateway/MetaDataWriteDataNodesIT.java     |  34 +-
 .../gateway/MetaStateServiceTests.java        |  12 +-
 .../PersistedClusterStateServiceTests.java    | 791 ++++++++++++++++++
 .../PeerRecoveryRetentionLeaseCreationIT.java |   1 +
 .../RemoveCorruptedShardDataCommandIT.java    |  12 +-
 .../RemoveCorruptedShardDataCommandTests.java |  38 +-
 ...dicesLifecycleListenerSingleNodeTests.java |   2 +-
 .../indices/IndicesServiceTests.java          |  38 +-
 ...actIndicesClusterStateServiceTestCase.java |   3 +-
 .../indices/cluster/ClusterStateChanges.java  |   3 +-
 .../indices/recovery/DanglingIndicesIT.java   |  59 +-
 .../AbstractCoordinatorTestCase.java          |  25 +-
 .../gateway/MockGatewayMetaState.java         |  21 +-
 .../test/InternalTestCluster.java             |   5 +-
 51 files changed, 3388 insertions(+), 1081 deletions(-)
 create mode 100644 server/src/main/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommand.java
 create mode 100644 server/src/main/java/org/elasticsearch/gateway/PersistedClusterStateService.java
 create mode 100644 server/src/test/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommandIT.java
 create mode 100644 server/src/test/java/org/elasticsearch/gateway/PersistedClusterStateServiceTests.java

diff --git a/docs/reference/commands/node-tool.asciidoc b/docs/reference/commands/node-tool.asciidoc
index 4dd2b0dfe0b6a..862420ba30b5e 100644
--- a/docs/reference/commands/node-tool.asciidoc
+++ b/docs/reference/commands/node-tool.asciidoc
@@ -3,9 +3,9 @@
 
 The `elasticsearch-node` command enables you to perform certain unsafe
 operations on a node that are only possible while it is shut down. This command
-allows you to adjust the <<modules-node,role>> of a node and may be able to
-recover some data after a disaster or start a node even if it is incompatible
-with the data on disk.
+allows you to adjust the <<modules-node,role>> of a node, unsafely edit cluster
+settings and may be able to recover some data after a disaster or start a node
+even if it is incompatible with the data on disk.
 
 [float]
 === Synopsis
@@ -20,13 +20,17 @@ bin/elasticsearch-node repurpose|unsafe-bootstrap|detach-cluster|override-versio
 [float]
 === Description
 
-This tool has four modes:
+This tool has five modes:
 
 * `elasticsearch-node repurpose` can be used to delete unwanted data from a
   node if it used to be a <<data-node,data node>> or a
   <<master-node,master-eligible node>> but has been repurposed not to have one
   or other of these roles.
 
+* `elasticsearch-node remove-settings` can be used to remove persistent settings
+   from the cluster state in case where it contains incompatible settings that
+   prevent the cluster from forming.
+
 * `elasticsearch-node unsafe-bootstrap` can be used to perform _unsafe cluster
   bootstrapping_.  It forces one of the nodes to form a brand-new cluster on
   its own, using its local copy of the cluster metadata.
@@ -76,6 +80,26 @@ The tool provides a summary of the data to be deleted and asks for confirmation
 before making any changes. You can get detailed information about the affected
 indices and shards by passing the verbose (`-v`) option.
 
+[float]
+==== Removing persistent cluster settings
+
+There may be situations where a node contains persistent cluster
+settings that prevent the cluster from forming. Since the cluster cannot form,
+it is not possible to remove these settings using the
+<<cluster-update-settings>> API.
+
+The `elasticsearch-node remove-settings` tool allows you to forcefully remove
+those persistent settings from the on-disk cluster state. The tool takes a
+list of settings as parameters that should be removed, and also supports
+wildcard patterns.
+
+The intended use is:
+
+* Stop the node
+* Run `elasticsearch-node remove-settings name-of-setting-to-remove` on the node
+* Repeat for all other master-eligible nodes
+* Start the nodes
+
 [float]
 ==== Recovering data after a disaster
 
@@ -143,9 +167,9 @@ If there is at least one remaining master-eligible node, but it is not possible
 to restart a majority of them, then the `elasticsearch-node unsafe-bootstrap`
 command will unsafely override the cluster's <<modules-discovery-voting,voting
 configuration>> as if performing another
-<<modules-discovery-bootstrap-cluster,cluster bootstrapping process>>. 
+<<modules-discovery-bootstrap-cluster,cluster bootstrapping process>>.
 The target node can then form a new cluster on its own by using
-the cluster metadata held locally on the target node. 
+the cluster metadata held locally on the target node.
 
 [WARNING]
 These steps can lead to arbitrary data loss since the target node may not hold the latest cluster
@@ -290,6 +314,9 @@ it can join a different cluster.
 `override-version`:: Overwrites the version number stored in the data path so
 that a node can start despite being incompatible with the on-disk data.
 
+`remove-settings`:: Forcefully removes the provided persistent cluster settings
+from the on-disk cluster state.
+
 `-E <KeyValuePair>`:: Configures a setting.
 
 `-h, --help`:: Returns all of the command parameters.
@@ -346,6 +373,40 @@ Confirm [y/N] y
 Node successfully repurposed to no-master and no-data.
 ----
 
+[float]
+==== Removing persistent cluster settings
+
+If your nodes contain persistent cluster settings that prevent the cluster
+from forming, i.e., can't be removed using the <<cluster-update-settings>> API,
+you can run the following commands to remove one or more cluster settings.
+
+[source,txt]
+----
+node$ ./bin/elasticsearch-node remove-settings xpack.monitoring.exporters.my_exporter.host
+
+    WARNING: Elasticsearch MUST be stopped before running this tool.
+
+The following settings will be removed:
+xpack.monitoring.exporters.my_exporter.host: "10.1.2.3"
+
+You should only run this tool if you have incompatible settings in the
+cluster state that prevent the cluster from forming.
+This tool can cause data loss and its use should be your last resort.
+
+Do you want to proceed?
+
+Confirm [y/N] y
+
+Settings were successfully removed from the cluster state
+----
+
+You can also use wildcards to remove multiple settings, for example using
+
+[source,txt]
+----
+node$ ./bin/elasticsearch-node remove-settings xpack.monitoring.*
+----
+
 [float]
 ==== Unsafe cluster bootstrapping
 
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/CoordinationState.java b/server/src/main/java/org/elasticsearch/cluster/coordination/CoordinationState.java
index 6973f165e7d4b..4862e9e4c0862 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/CoordinationState.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/CoordinationState.java
@@ -25,6 +25,8 @@
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 
+import java.io.Closeable;
+import java.io.IOException;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.HashMap;
@@ -432,15 +434,14 @@ public void invariant() {
         assert publishVotes.isEmpty() || electionWon();
     }
 
-    public void close() {
+    public void close() throws IOException {
         persistedState.close();
     }
 
     /**
      * Pluggable persistence layer for {@link CoordinationState}.
-     *
      */
-    public interface PersistedState {
+    public interface PersistedState extends Closeable {
 
         /**
          * Returns the current term
@@ -497,7 +498,8 @@ default void markLastAcceptedStateAsCommitted() {
             }
         }
 
-        default void close() {}
+        default void close() throws IOException {
+        }
     }
 
     /**
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/Coordinator.java b/server/src/main/java/org/elasticsearch/cluster/coordination/Coordinator.java
index d664a3de193e5..20b3637680fb9 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/Coordinator.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/Coordinator.java
@@ -72,6 +72,7 @@
 import org.elasticsearch.transport.TransportResponse.Empty;
 import org.elasticsearch.transport.TransportService;
 
+import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.Collections;
@@ -702,7 +703,7 @@ protected void doStop() {
     }
 
     @Override
-    protected void doClose() {
+    protected void doClose() throws IOException {
         final CoordinationState coordinationState = this.coordinationState.get();
         if (coordinationState != null) {
             // This looks like a race that might leak an unclosed CoordinationState if it's created while execution is here, but this method
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/DetachClusterCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/DetachClusterCommand.java
index dff7ae5a2ee03..527a1b3f69cb3 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/DetachClusterCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/DetachClusterCommand.java
@@ -18,11 +18,12 @@
  */
 package org.elasticsearch.cluster.coordination;
 
+import joptsimple.OptionSet;
 import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.cluster.metadata.Manifest;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.MetaData;
-import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.env.Environment;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 
 import java.io.IOException;
 import java.nio.file.Path;
@@ -48,14 +49,21 @@ public DetachClusterCommand() {
 
 
     @Override
-    protected void processNodePaths(Terminal terminal, Path[] dataPaths, Environment env) throws IOException {
-        final Tuple<Manifest, MetaData> manifestMetaDataTuple = loadMetaData(terminal, dataPaths);
-        final Manifest manifest = manifestMetaDataTuple.v1();
-        final MetaData metaData = manifestMetaDataTuple.v2();
+    protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env) throws IOException {
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+
+        terminal.println(Terminal.Verbosity.VERBOSE, "Loading cluster state");
+        final ClusterState oldClusterState = loadTermAndClusterState(persistedClusterStateService, env).v2();
+        final ClusterState newClusterState = ClusterState.builder(oldClusterState)
+            .metaData(updateMetaData(oldClusterState.metaData())).build();
+        terminal.println(Terminal.Verbosity.VERBOSE,
+            "[old cluster state = " + oldClusterState + ", new cluster state = " + newClusterState + "]");
 
         confirm(terminal, CONFIRMATION_MSG);
 
-        writeNewMetaData(terminal, manifest, updateCurrentTerm(), metaData, updateMetaData(metaData), dataPaths);
+        try (PersistedClusterStateService.Writer writer = persistedClusterStateService.createWriter()) {
+            writer.writeFullStateAndCommit(updateCurrentTerm(), newClusterState);
+        }
 
         terminal.println(NODE_DETACHED_MSG);
     }
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
index 800269520e366..5c4089a2e35bf 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
@@ -26,42 +26,79 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.cli.EnvironmentAwareCommand;
 import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.cluster.metadata.Manifest;
-import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cli.UserException;
+import org.elasticsearch.cluster.ClusterModule;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
+import org.elasticsearch.env.NodeMetaData;
+import org.elasticsearch.gateway.PersistedClusterStateService;
+import org.elasticsearch.indices.IndicesModule;
 
 import java.io.IOException;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.Arrays;
 import java.util.Objects;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 public abstract class ElasticsearchNodeCommand extends EnvironmentAwareCommand {
     private static final Logger logger = LogManager.getLogger(ElasticsearchNodeCommand.class);
     protected static final String DELIMITER = "------------------------------------------------------------------------\n";
-
     static final String STOP_WARNING_MSG =
             DELIMITER +
                     "\n" +
                     "    WARNING: Elasticsearch MUST be stopped before running this tool." +
                     "\n";
     protected static final String FAILED_TO_OBTAIN_NODE_LOCK_MSG = "failed to lock node's directory, is Elasticsearch still running?";
-    static final String NO_NODE_FOLDER_FOUND_MSG = "no node folder is found in data folder(s), node has not been started yet?";
-    static final String NO_MANIFEST_FILE_FOUND_MSG = "no manifest file is found, do you run pre 7.0 Elasticsearch?";
-    protected static final String GLOBAL_GENERATION_MISSING_MSG =
-        "no metadata is referenced from the manifest file, cluster has never been bootstrapped?";
-    static final String NO_GLOBAL_METADATA_MSG = "failed to find global metadata, metadata corrupted?";
-    static final String WRITE_METADATA_EXCEPTION_MSG = "exception occurred when writing new metadata to disk";
     protected static final String ABORTED_BY_USER_MSG = "aborted by user";
+    static final String NO_NODE_FOLDER_FOUND_MSG = "no node folder is found in data folder(s), node has not been started yet?";
+    static final String NO_NODE_METADATA_FOUND_MSG = "no node meta data is found, node has not been started yet?";
+    protected static final String CS_MISSING_MSG =
+        "cluster state is empty, cluster has never been bootstrapped?";
+
+    protected static final NamedXContentRegistry namedXContentRegistry = new NamedXContentRegistry(
+        Stream.of(ClusterModule.getNamedXWriteables().stream(), IndicesModule.getNamedXContents().stream())
+            .flatMap(Function.identity())
+            .collect(Collectors.toList()));
 
     public ElasticsearchNodeCommand(String description) {
         super(description);
     }
 
-    protected void processNodePaths(Terminal terminal, OptionSet options, Environment env) throws IOException {
+    public static PersistedClusterStateService createPersistedClusterStateService(Path[] dataPaths) throws IOException {
+        final NodeMetaData nodeMetaData = PersistedClusterStateService.nodeMetaData(dataPaths);
+        if (nodeMetaData == null) {
+            throw new ElasticsearchException(NO_NODE_METADATA_FOUND_MSG);
+        }
+
+        String nodeId = nodeMetaData.nodeId();
+        return new PersistedClusterStateService(dataPaths, nodeId, namedXContentRegistry, BigArrays.NON_RECYCLING_INSTANCE, true);
+    }
+
+    public static ClusterState clusterState(Environment environment, PersistedClusterStateService.OnDiskState onDiskState) {
+        return ClusterState.builder(ClusterName.CLUSTER_NAME_SETTING.get(environment.settings()))
+            .version(onDiskState.lastAcceptedVersion)
+            .metaData(onDiskState.metaData)
+            .build();
+    }
+
+    public static Tuple<Long, ClusterState> loadTermAndClusterState(PersistedClusterStateService psf,
+                                                                    Environment env) throws IOException {
+        final PersistedClusterStateService.OnDiskState bestOnDiskState = psf.loadBestOnDiskState();
+        if (bestOnDiskState.empty()) {
+            throw new ElasticsearchException(CS_MISSING_MSG);
+        }
+        return Tuple.tuple(bestOnDiskState.currentTerm, clusterState(env, bestOnDiskState));
+    }
+
+    protected void processNodePaths(Terminal terminal, OptionSet options, Environment env) throws IOException, UserException {
         terminal.println(Terminal.Verbosity.VERBOSE, "Obtaining lock for node");
         try (NodeEnvironment.NodeLock lock = new NodeEnvironment.NodeLock(logger, env, Files::exists)) {
             final Path[] dataPaths =
@@ -69,32 +106,12 @@ protected void processNodePaths(Terminal terminal, OptionSet options, Environmen
             if (dataPaths.length == 0) {
                 throw new ElasticsearchException(NO_NODE_FOLDER_FOUND_MSG);
             }
-            processNodePaths(terminal, dataPaths, env);
+            processNodePaths(terminal, dataPaths, options, env);
         } catch (LockObtainFailedException e) {
             throw new ElasticsearchException(FAILED_TO_OBTAIN_NODE_LOCK_MSG, e);
         }
     }
 
-    protected Tuple<Manifest, MetaData> loadMetaData(Terminal terminal, Path[] dataPaths) throws IOException {
-        terminal.println(Terminal.Verbosity.VERBOSE, "Loading manifest file");
-        final Manifest manifest = Manifest.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, dataPaths);
-
-        if (manifest == null) {
-            throw new ElasticsearchException(NO_MANIFEST_FILE_FOUND_MSG);
-        }
-        if (manifest.isGlobalGenerationMissing()) {
-            throw new ElasticsearchException(GLOBAL_GENERATION_MISSING_MSG);
-        }
-        terminal.println(Terminal.Verbosity.VERBOSE, "Loading global metadata file");
-        final MetaData metaData = MetaData.FORMAT_PRESERVE_CUSTOMS.loadGeneration(
-            logger, NamedXContentRegistry.EMPTY, manifest.getGlobalGeneration(), dataPaths);
-        if (metaData == null) {
-            throw new ElasticsearchException(NO_GLOBAL_METADATA_MSG + " [generation = " + manifest.getGlobalGeneration() + "]");
-        }
-
-        return Tuple.tuple(manifest, metaData);
-    }
-
     protected void confirm(Terminal terminal, String msg) {
         terminal.println(msg);
         String text = terminal.readText("Confirm [y/N] ");
@@ -104,7 +121,7 @@ protected void confirm(Terminal terminal, String msg) {
     }
 
     @Override
-    protected final void execute(Terminal terminal, OptionSet options, Environment env) throws Exception {
+    public final void execute(Terminal terminal, OptionSet options, Environment env) throws Exception {
         terminal.println(STOP_WARNING_MSG);
         if (validateBeforeLock(terminal, env)) {
             processNodePaths(terminal, options, env);
@@ -126,44 +143,11 @@ protected boolean validateBeforeLock(Terminal terminal, Environment env) {
      * Process the paths. Locks for the paths is held during this method invocation.
      * @param terminal the terminal to use for messages
      * @param dataPaths the paths of the node to process
+     * @param options the command line options
      * @param env the env of the node to process
      */
-    protected abstract void processNodePaths(Terminal terminal, Path[] dataPaths, Environment env) throws IOException;
-
-
-    protected void writeNewMetaData(Terminal terminal, Manifest oldManifest, long newCurrentTerm,
-                                    MetaData oldMetaData, MetaData newMetaData, Path[] dataPaths) {
-        long newGeneration;
-        try {
-            terminal.println(Terminal.Verbosity.VERBOSE,
-                    "[clusterUUID = " + oldMetaData.clusterUUID() + ", committed = " + oldMetaData.clusterUUIDCommitted() + "] => " +
-                         "[clusterUUID = " + newMetaData.clusterUUID() + ", committed = " + newMetaData.clusterUUIDCommitted() + "]");
-            terminal.println(Terminal.Verbosity.VERBOSE, "New coordination metadata is " + newMetaData.coordinationMetaData());
-            terminal.println(Terminal.Verbosity.VERBOSE, "Writing new global metadata to disk");
-            newGeneration = MetaData.FORMAT.write(newMetaData, dataPaths);
-            Manifest newManifest = new Manifest(newCurrentTerm, oldManifest.getClusterStateVersion(), newGeneration,
-                    oldManifest.getIndexGenerations());
-            terminal.println(Terminal.Verbosity.VERBOSE, "New manifest is " + newManifest);
-            terminal.println(Terminal.Verbosity.VERBOSE, "Writing new manifest file to disk");
-            Manifest.FORMAT.writeAndCleanup(newManifest, dataPaths);
-        } catch (Exception e) {
-            terminal.println(Terminal.Verbosity.VERBOSE, "Cleaning up new metadata");
-            MetaData.FORMAT.cleanupOldFiles(oldManifest.getGlobalGeneration(), dataPaths);
-            throw new ElasticsearchException(WRITE_METADATA_EXCEPTION_MSG, e);
-        }
-        // if cleaning old files fail, we still succeeded.
-        try {
-            cleanUpOldMetaData(terminal, dataPaths, newGeneration);
-        } catch (Exception e) {
-            terminal.println(Terminal.Verbosity.SILENT,
-                "Warning: Cleaning up old metadata failed, but operation was otherwise successful (message: " + e.getMessage() + ")");
-        }
-    }
-
-    protected void cleanUpOldMetaData(Terminal terminal, Path[] dataPaths, long newGeneration) {
-        terminal.println(Terminal.Verbosity.VERBOSE, "Cleaning up old metadata");
-        MetaData.FORMAT.cleanupOldFiles(newGeneration, dataPaths);
-    }
+    protected abstract void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env)
+        throws IOException, UserException;
 
     protected NodeEnvironment.NodePath[] toNodePaths(Path[] dataPaths) {
         return Arrays.stream(dataPaths).map(ElasticsearchNodeCommand::createNodePath).toArray(NodeEnvironment.NodePath[]::new);
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/NodeToolCli.java b/server/src/main/java/org/elasticsearch/cluster/coordination/NodeToolCli.java
index ff054e71eee3a..29c03dbb8c46c 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/NodeToolCli.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/NodeToolCli.java
@@ -41,6 +41,7 @@ public NodeToolCli() {
         subcommands.put("unsafe-bootstrap", new UnsafeBootstrapMasterCommand());
         subcommands.put("detach-cluster", new DetachClusterCommand());
         subcommands.put("override-version", new OverrideNodeVersionCommand());
+        subcommands.put("remove-settings", new RemoveSettingsCommand());
     }
 
     public static void main(String[] args) throws Exception {
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommand.java
new file mode 100644
index 0000000000000..aa23488ccaa4e
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommand.java
@@ -0,0 +1,104 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.cluster.coordination;
+
+import joptsimple.OptionSet;
+import joptsimple.OptionSpec;
+import org.elasticsearch.cli.ExitCodes;
+import org.elasticsearch.cli.Terminal;
+import org.elasticsearch.cli.UserException;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.regex.Regex;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.gateway.PersistedClusterStateService;
+
+import java.io.IOException;
+import java.nio.file.Path;
+import java.util.List;
+
+public class RemoveSettingsCommand extends ElasticsearchNodeCommand {
+
+    static final String SETTINGS_REMOVED_MSG = "Settings were successfully removed from the cluster state";
+    static final String CONFIRMATION_MSG =
+        DELIMITER +
+            "\n" +
+            "You should only run this tool if you have incompatible settings in the\n" +
+            "cluster state that prevent the cluster from forming.\n" +
+            "This tool can cause data loss and its use should be your last resort.\n" +
+            "\n" +
+            "Do you want to proceed?\n";
+
+    private final OptionSpec<String> arguments;
+
+    public RemoveSettingsCommand() {
+        super("Removes persistent settings from the cluster state");
+        arguments = parser.nonOptions("setting names");
+    }
+
+    @Override
+    protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env)
+        throws IOException, UserException {
+        final List<String> settingsToRemove = arguments.values(options);
+        if (settingsToRemove.isEmpty()) {
+            throw new UserException(ExitCodes.USAGE, "Must supply at least one setting to remove");
+        }
+
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+
+        terminal.println(Terminal.Verbosity.VERBOSE, "Loading cluster state");
+        final Tuple<Long, ClusterState> termAndClusterState = loadTermAndClusterState(persistedClusterStateService, env);
+        final ClusterState oldClusterState = termAndClusterState.v2();
+        final Settings oldPersistentSettings = oldClusterState.metaData().persistentSettings();
+        terminal.println(Terminal.Verbosity.VERBOSE, "persistent settings: " + oldPersistentSettings);
+        final Settings.Builder newPersistentSettingsBuilder = Settings.builder().put(oldPersistentSettings);
+        for (String settingToRemove : settingsToRemove) {
+            boolean matched = false;
+            for (String settingKey : oldPersistentSettings.keySet()) {
+                if (Regex.simpleMatch(settingToRemove, settingKey)) {
+                    newPersistentSettingsBuilder.remove(settingKey);
+                    if (matched == false) {
+                        terminal.println("The following settings will be removed:");
+                    }
+                    matched = true;
+                    terminal.println(settingKey + ": " + oldPersistentSettings.get(settingKey));
+                }
+            }
+            if (matched == false) {
+                throw new UserException(ExitCodes.USAGE,
+                    "No persistent cluster settings matching [" + settingToRemove + "] were found on this node");
+            }
+        }
+        final ClusterState newClusterState = ClusterState.builder(oldClusterState)
+            .metaData(MetaData.builder(oldClusterState.metaData()).persistentSettings(newPersistentSettingsBuilder.build()).build())
+            .build();
+        terminal.println(Terminal.Verbosity.VERBOSE,
+            "[old cluster state = " + oldClusterState + ", new cluster state = " + newClusterState + "]");
+
+        confirm(terminal, CONFIRMATION_MSG);
+
+        try (PersistedClusterStateService.Writer writer = persistedClusterStateService.createWriter()) {
+            writer.writeFullStateAndCommit(termAndClusterState.v1(), newClusterState);
+        }
+
+        terminal.println(SETTINGS_REMOVED_MSG);
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
index 05bc0116c13c6..2b9e7db1e98bd 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
@@ -18,19 +18,17 @@
  */
 package org.elasticsearch.cluster.coordination;
 
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
+import joptsimple.OptionSet;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.cluster.metadata.Manifest;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
-import org.elasticsearch.env.NodeMetaData;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.node.Node;
 
 import java.io.IOException;
@@ -40,8 +38,6 @@
 
 public class UnsafeBootstrapMasterCommand extends ElasticsearchNodeCommand {
 
-    private static final Logger logger = LogManager.getLogger(UnsafeBootstrapMasterCommand.class);
-
     static final String CLUSTER_STATE_TERM_VERSION_MSG_FORMAT =
             "Current node cluster state (term, version) pair is (%s, %s)";
     static final String CONFIRMATION_MSG =
@@ -58,8 +54,6 @@ public class UnsafeBootstrapMasterCommand extends ElasticsearchNodeCommand {
 
     static final String NOT_MASTER_NODE_MSG = "unsafe-bootstrap tool can only be run on master eligible node";
 
-    static final String NO_NODE_METADATA_FOUND_MSG = "no node meta data is found, node has not been started yet?";
-
     static final String EMPTY_LAST_COMMITTED_VOTING_CONFIG_MSG =
             "last committed voting voting configuration is empty, cluster has never been bootstrapped?";
 
@@ -83,49 +77,54 @@ protected boolean validateBeforeLock(Terminal terminal, Environment env) {
         return true;
     }
 
-    protected void processNodePaths(Terminal terminal, Path[] dataPaths, Environment env) throws IOException {
-        terminal.println(Terminal.Verbosity.VERBOSE, "Loading node metadata");
-        final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, dataPaths);
-        if (nodeMetaData == null) {
-            throw new ElasticsearchException(NO_NODE_METADATA_FOUND_MSG);
-        }
+    protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env) throws IOException {
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
 
-        String nodeId = nodeMetaData.nodeId();
-        terminal.println(Terminal.Verbosity.VERBOSE, "Current nodeId is " + nodeId);
+        final Tuple<Long, ClusterState> state = loadTermAndClusterState(persistedClusterStateService, env);
+        final ClusterState oldClusterState = state.v2();
+
+        final MetaData metaData = oldClusterState.metaData();
 
-        final Tuple<Manifest, MetaData> manifestMetaDataTuple = loadMetaData(terminal, dataPaths);
-        final Manifest manifest = manifestMetaDataTuple.v1();
-        final MetaData metaData = manifestMetaDataTuple.v2();
         final CoordinationMetaData coordinationMetaData = metaData.coordinationMetaData();
         if (coordinationMetaData == null ||
-                coordinationMetaData.getLastCommittedConfiguration() == null ||
-                coordinationMetaData.getLastCommittedConfiguration().isEmpty()) {
+            coordinationMetaData.getLastCommittedConfiguration() == null ||
+            coordinationMetaData.getLastCommittedConfiguration().isEmpty()) {
             throw new ElasticsearchException(EMPTY_LAST_COMMITTED_VOTING_CONFIG_MSG);
         }
         terminal.println(String.format(Locale.ROOT, CLUSTER_STATE_TERM_VERSION_MSG_FORMAT, coordinationMetaData.term(),
-                metaData.version()));
-
-        confirm(terminal, CONFIRMATION_MSG);
+            metaData.version()));
 
         CoordinationMetaData newCoordinationMetaData = CoordinationMetaData.builder(coordinationMetaData)
-                .clearVotingConfigExclusions()
-                .lastAcceptedConfiguration(new CoordinationMetaData.VotingConfiguration(Collections.singleton(nodeId)))
-                .lastCommittedConfiguration(new CoordinationMetaData.VotingConfiguration(Collections.singleton(nodeId)))
-                .build();
+            .clearVotingConfigExclusions()
+            .lastAcceptedConfiguration(new CoordinationMetaData.VotingConfiguration(
+                Collections.singleton(persistedClusterStateService.getNodeId())))
+            .lastCommittedConfiguration(new CoordinationMetaData.VotingConfiguration(
+                Collections.singleton(persistedClusterStateService.getNodeId())))
+            .build();
 
         Settings persistentSettings = Settings.builder()
-                .put(metaData.persistentSettings())
-                .put(UNSAFE_BOOTSTRAP.getKey(), true)
-                .build();
+            .put(metaData.persistentSettings())
+            .put(UNSAFE_BOOTSTRAP.getKey(), true)
+            .build();
         MetaData newMetaData = MetaData.builder(metaData)
-                .clusterUUID(MetaData.UNKNOWN_CLUSTER_UUID)
-                .generateClusterUuidIfNeeded()
-                .clusterUUIDCommitted(true)
-                .persistentSettings(persistentSettings)
-                .coordinationMetaData(newCoordinationMetaData)
-                .build();
-
-        writeNewMetaData(terminal, manifest, manifest.getCurrentTerm(), metaData, newMetaData, dataPaths);
+            .clusterUUID(MetaData.UNKNOWN_CLUSTER_UUID)
+            .generateClusterUuidIfNeeded()
+            .clusterUUIDCommitted(true)
+            .persistentSettings(persistentSettings)
+            .coordinationMetaData(newCoordinationMetaData)
+            .build();
+
+        final ClusterState newClusterState = ClusterState.builder(oldClusterState)
+            .metaData(newMetaData).build();
+
+        terminal.println(Terminal.Verbosity.VERBOSE,
+            "[old cluster state = " + oldClusterState + ", new cluster state = " + newClusterState + "]");
+
+        confirm(terminal, CONFIRMATION_MSG);
+
+        try (PersistedClusterStateService.Writer writer = persistedClusterStateService.createWriter()) {
+            writer.writeFullStateAndCommit(state.v1(), newClusterState);
+        }
 
         terminal.println(MASTER_NODE_BOOTSTRAPPED_MSG);
     }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
index 1ed7fb04407f1..ded77ce4287d6 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
@@ -649,7 +649,7 @@ private static IndexService validateActiveShardCountAndCreateIndexService(String
                 "]: cannot be greater than number of shard copies [" +
                 (tmpImd.getNumberOfReplicas() + 1) + "]");
         }
-        return indicesService.createIndex(tmpImd, Collections.emptyList());
+        return indicesService.createIndex(tmpImd, Collections.emptyList(), false);
     }
 
     private void validate(CreateIndexClusterStateUpdateRequest request, ClusterState state) {
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesService.java
index 5efd4b6eae8bc..c6149682a203a 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexAliasesService.java
@@ -140,7 +140,7 @@ public ClusterState applyAliasActions(ClusterState currentState, Iterable<AliasA
                             if (indexService == null) {
                                 // temporarily create the index and add mappings so we can parse the filter
                                 try {
-                                    indexService = indicesService.createIndex(index, emptyList());
+                                    indexService = indicesService.createIndex(index, emptyList(), false);
                                     indicesToClose.add(index.getIndex());
                                 } catch (IOException e) {
                                     throw new ElasticsearchException("Failed to create temporary index for parsing the alias", e);
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
index 31a612341d76a..825e6758e5df0 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
@@ -232,7 +232,7 @@ private static void validateAndAddTemplate(final PutRequest request, IndexTempla
                 .build();
 
             final IndexMetaData tmpIndexMetadata = IndexMetaData.builder(temporaryIndexName).settings(dummySettings).build();
-            IndexService dummyIndexService = indicesService.createIndex(tmpIndexMetadata, Collections.emptyList());
+            IndexService dummyIndexService = indicesService.createIndex(tmpIndexMetadata, Collections.emptyList(), false);
             createdIndex = dummyIndexService.index();
 
             templateBuilder.order(request.order);
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataMappingService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataMappingService.java
index 5271d401d2410..140423577751f 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataMappingService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataMappingService.java
@@ -143,7 +143,7 @@ ClusterState executeRefresh(final ClusterState currentState, final List<RefreshT
             IndexService indexService = indicesService.indexService(indexMetaData.getIndex());
             if (indexService == null) {
                 // we need to create the index here, and add the current mapping to it, so we can merge
-                indexService = indicesService.createIndex(indexMetaData, Collections.emptyList());
+                indexService = indicesService.createIndex(indexMetaData, Collections.emptyList(), false);
                 removeIndex = true;
                 indexService.mapperService().merge(indexMetaData, MergeReason.MAPPING_RECOVERY);
             }
diff --git a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
index 928de4a0cb5e3..8ab85abf6d74e 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
@@ -199,6 +199,7 @@ public void apply(Settings value, Settings current, Settings previous) {
             IndicesQueryCache.INDICES_CACHE_QUERY_COUNT_SETTING,
             IndicesQueryCache.INDICES_QUERIES_CACHE_ALL_SEGMENTS_SETTING,
             IndicesService.INDICES_ID_FIELD_DATA_ENABLED_SETTING,
+            IndicesService.WRITE_DANGLING_INDICES_INFO_SETTING,
             MappingUpdatedAction.INDICES_MAPPING_DYNAMIC_TIMEOUT_SETTING,
             MetaData.SETTING_READ_ONLY_SETTING,
             MetaData.SETTING_READ_ONLY_ALLOW_DELETE_SETTING,
diff --git a/server/src/main/java/org/elasticsearch/env/NodeEnvironment.java b/server/src/main/java/org/elasticsearch/env/NodeEnvironment.java
index ec5b4fe43c8fe..9164f6f23a8cd 100644
--- a/server/src/main/java/org/elasticsearch/env/NodeEnvironment.java
+++ b/server/src/main/java/org/elasticsearch/env/NodeEnvironment.java
@@ -51,6 +51,7 @@
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.gateway.MetaDataStateFormat;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.shard.ShardId;
@@ -301,7 +302,7 @@ public NodeEnvironment(Settings settings, Environment environment) throws IOExce
                 ensureNoShardData(nodePaths);
             }
 
-            this.nodeMetaData = loadOrCreateNodeMetaData(settings, logger, nodePaths);
+            this.nodeMetaData = loadNodeMetaData(settings, logger, nodePaths);
 
             success = true;
         } finally {
@@ -381,6 +382,13 @@ private static boolean upgradeLegacyNodeFolders(Logger logger, Settings settings
 
                 // determine folders to move and check that there are no extra files/folders
                 final Set<String> folderNames = new HashSet<>();
+                final Set<String> expectedFolderNames = new HashSet<>(Arrays.asList(
+
+                    // node state directory, containing MetaDataStateFormat-based node metadata as well as cluster state
+                    MetaDataStateFormat.STATE_DIR_NAME,
+
+                    // indices
+                    INDICES_FOLDER));
 
                 try (DirectoryStream<Path> stream = Files.newDirectoryStream(legacyNodePath.path)) {
                     for (Path subFolderPath : stream) {
@@ -388,8 +396,7 @@ private static boolean upgradeLegacyNodeFolders(Logger logger, Settings settings
                         if (FileSystemUtils.isDesktopServicesStore(subFolderPath)) {
                             // ignore
                         } else if (FileSystemUtils.isAccessibleDirectory(subFolderPath, logger)) {
-                            if (fileName.equals(INDICES_FOLDER) == false && // indices folder
-                                fileName.equals(MetaDataStateFormat.STATE_DIR_NAME) == false) { // global metadata & node state folder
+                            if (expectedFolderNames.contains(fileName) == false) {
                                 throw new IllegalStateException("unexpected folder encountered during data folder upgrade: " +
                                     subFolderPath);
                             }
@@ -407,7 +414,7 @@ private static boolean upgradeLegacyNodeFolders(Logger logger, Settings settings
                     }
                 }
 
-                assert Sets.difference(folderNames, Sets.newHashSet(INDICES_FOLDER, MetaDataStateFormat.STATE_DIR_NAME)).isEmpty() :
+                assert Sets.difference(folderNames, expectedFolderNames).isEmpty() :
                     "expected indices and/or state dir folder but was " + folderNames;
 
                 upgradeActions.add(() -> {
@@ -422,7 +429,7 @@ private static boolean upgradeLegacyNodeFolders(Logger logger, Settings settings
             }
             // now do the actual upgrade. start by upgrading the node metadata file before moving anything, since a downgrade in an
             // intermediate state would be pretty disastrous
-            loadOrCreateNodeMetaData(settings, logger, legacyNodeLock.getNodePaths());
+            loadNodeMetaData(settings, logger, legacyNodeLock.getNodePaths());
             for (CheckedRunnable<IOException> upgradeAction : upgradeActions) {
                 upgradeAction.run();
             }
@@ -491,36 +498,36 @@ private void maybeLogHeapDetails() {
 
     /**
      * scans the node paths and loads existing metaData file. If not found a new meta data will be generated
-     * and persisted into the nodePaths
      */
-    private static NodeMetaData loadOrCreateNodeMetaData(Settings settings, Logger logger,
-                                                         NodePath... nodePaths) throws IOException {
+    private static NodeMetaData loadNodeMetaData(Settings settings, Logger logger,
+                                                 NodePath... nodePaths) throws IOException {
         final Path[] paths = Arrays.stream(nodePaths).map(np -> np.path).toArray(Path[]::new);
-
-        final Set<String> nodeIds = new HashSet<>();
-        for (final Path path : paths) {
-            final NodeMetaData metaData = NodeMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, path);
-            if (metaData != null) {
-                nodeIds.add(metaData.nodeId());
-            }
-        }
-        if (nodeIds.size() > 1) {
-            throw new IllegalStateException(
-                "data paths " + Arrays.toString(paths) + " belong to multiple nodes with IDs " + nodeIds);
-        }
-
-        NodeMetaData metaData = NodeMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, paths);
+        NodeMetaData metaData = PersistedClusterStateService.nodeMetaData(paths);
         if (metaData == null) {
-            assert nodeIds.isEmpty() : nodeIds;
-            metaData = new NodeMetaData(generateNodeId(settings), Version.CURRENT);
-        } else {
-            assert nodeIds.equals(Collections.singleton(metaData.nodeId())) : nodeIds + " doesn't match " + metaData;
-            metaData = metaData.upgradeToCurrentVersion();
+            // load legacy metadata
+            final Set<String> nodeIds = new HashSet<>();
+            for (final Path path : paths) {
+                final NodeMetaData oldStyleMetaData = NodeMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, path);
+                if (oldStyleMetaData != null) {
+                    nodeIds.add(oldStyleMetaData.nodeId());
+                }
+            }
+            if (nodeIds.size() > 1) {
+                throw new IllegalStateException(
+                    "data paths " + Arrays.toString(paths) + " belong to multiple nodes with IDs " + nodeIds);
+            }
+            // load legacy metadata
+            final NodeMetaData legacyMetaData = NodeMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, paths);
+            if (legacyMetaData == null) {
+                assert nodeIds.isEmpty() : nodeIds;
+                metaData = new NodeMetaData(generateNodeId(settings), Version.CURRENT);
+            } else {
+                assert nodeIds.equals(Collections.singleton(legacyMetaData.nodeId())) : nodeIds + " doesn't match " + legacyMetaData;
+                metaData = legacyMetaData;
+            }
         }
-
-        // we write again to make sure all paths have the latest state file
+        metaData = metaData.upgradeToCurrentVersion();
         assert metaData.nodeVersion().equals(Version.CURRENT) : metaData.nodeVersion() + " != " + Version.CURRENT;
-        NodeMetaData.FORMAT.writeAndCleanup(metaData, paths);
 
         return metaData;
     }
diff --git a/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java b/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
index 25b4f79866eaa..5281b21449187 100644
--- a/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
+++ b/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
@@ -18,42 +18,41 @@
  */
 package org.elasticsearch.env;
 
+import com.carrotsearch.hppc.cursors.ObjectObjectCursor;
 import joptsimple.OptionParser;
 import joptsimple.OptionSet;
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.cli.Terminal;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.coordination.ElasticsearchNodeCommand;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.Manifest;
+import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.core.internal.io.IOUtils;
-import org.elasticsearch.gateway.WriteStateException;
+import org.elasticsearch.gateway.MetaDataStateFormat;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 
 import java.io.IOException;
 import java.nio.file.Path;
 import java.util.Arrays;
 import java.util.Collection;
-import java.util.HashMap;
 import java.util.List;
 import java.util.Set;
 import java.util.stream.Collectors;
+import java.util.stream.Stream;
+import java.util.stream.StreamSupport;
 
-public class NodeRepurposeCommand extends ElasticsearchNodeCommand {
+import static org.elasticsearch.env.NodeEnvironment.INDICES_FOLDER;
 
-    private static final Logger logger = LogManager.getLogger(NodeRepurposeCommand.class);
+public class NodeRepurposeCommand extends ElasticsearchNodeCommand {
 
     static final String ABORTED_BY_USER_MSG = ElasticsearchNodeCommand.ABORTED_BY_USER_MSG;
     static final String FAILED_TO_OBTAIN_NODE_LOCK_MSG = ElasticsearchNodeCommand.FAILED_TO_OBTAIN_NODE_LOCK_MSG;
     static final String NO_CLEANUP = "Node has node.data=true -> no clean up necessary";
     static final String NO_DATA_TO_CLEAN_UP_FOUND = "No data to clean-up found";
     static final String NO_SHARD_DATA_TO_CLEAN_UP_FOUND = "No shard data to clean-up found";
-    static final String PRE_V7_MESSAGE =
-        "No manifest file found. If you were previously running this node on Elasticsearch version 6, please proceed.\n" +
-            "If this node was ever started on Elasticsearch version 7 or higher, it might mean metadata corruption, please abort.";
 
     public NodeRepurposeCommand() {
         super("Repurpose this node to another master/data role, cleaning up any excess persisted data");
@@ -75,17 +74,17 @@ protected boolean validateBeforeLock(Terminal terminal, Environment env) {
     }
 
     @Override
-    protected void processNodePaths(Terminal terminal, Path[] dataPaths, Environment env) throws IOException {
+    protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env) throws IOException {
         assert DiscoveryNode.isDataNode(env.settings()) == false;
 
         if (DiscoveryNode.isMasterNode(env.settings()) == false) {
-            processNoMasterNoDataNode(terminal, dataPaths);
+            processNoMasterNoDataNode(terminal, dataPaths, env);
         } else {
-            processMasterNoDataNode(terminal, dataPaths);
+            processMasterNoDataNode(terminal, dataPaths, env);
         }
     }
 
-    private void processNoMasterNoDataNode(Terminal terminal, Path[] dataPaths) throws IOException {
+    private void processNoMasterNoDataNode(Terminal terminal, Path[] dataPaths, Environment env) throws IOException {
         NodeEnvironment.NodePath[] nodePaths = toNodePaths(dataPaths);
 
         terminal.println(Terminal.Verbosity.VERBOSE, "Collecting shard data paths");
@@ -95,32 +94,36 @@ private void processNoMasterNoDataNode(Terminal terminal, Path[] dataPaths) thro
         List<Path> indexMetaDataPaths = NodeEnvironment.collectIndexMetaDataPaths(nodePaths);
 
         Set<Path> indexPaths = uniqueParentPaths(shardDataPaths, indexMetaDataPaths);
-        if (indexPaths.isEmpty()) {
+
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+
+        final MetaData metaData = loadClusterState(terminal, env, persistedClusterStateService).metaData();
+        if (indexPaths.isEmpty() && metaData.indices().isEmpty()) {
             terminal.println(Terminal.Verbosity.NORMAL, NO_DATA_TO_CLEAN_UP_FOUND);
             return;
         }
 
-        Set<String> indexUUIDs = indexUUIDsFor(indexPaths);
-        outputVerboseInformation(terminal, nodePaths, indexPaths, indexUUIDs);
+        final Set<String> indexUUIDs = Sets.union(indexUUIDsFor(indexPaths),
+            StreamSupport.stream(metaData.indices().values().spliterator(), false)
+                .map(imd -> imd.value.getIndexUUID()).collect(Collectors.toSet()));
+
+        outputVerboseInformation(terminal, indexPaths, indexUUIDs, metaData);
 
         terminal.println(noMasterMessage(indexUUIDs.size(), shardDataPaths.size(), indexMetaDataPaths.size()));
         outputHowToSeeVerboseInformation(terminal);
 
-        final Manifest manifest = loadManifest(terminal, dataPaths);
-
         terminal.println("Node is being re-purposed as no-master and no-data. Clean-up of index data will be performed.");
         confirm(terminal, "Do you want to proceed?");
 
-        if (manifest != null) {
-            rewriteManifest(terminal, manifest, dataPaths);
-        }
-
-        removePaths(terminal, indexPaths);
+        removePaths(terminal, indexPaths); // clean-up shard dirs
+        // clean-up all metadata dirs
+        MetaDataStateFormat.deleteMetaState(dataPaths);
+        IOUtils.rm(Stream.of(dataPaths).map(path -> path.resolve(INDICES_FOLDER)).toArray(Path[]::new));
 
         terminal.println("Node successfully repurposed to no-master and no-data.");
     }
 
-    private void processMasterNoDataNode(Terminal terminal, Path[] dataPaths) throws IOException {
+    private void processMasterNoDataNode(Terminal terminal, Path[] dataPaths, Environment env) throws IOException {
         NodeEnvironment.NodePath[] nodePaths = toNodePaths(dataPaths);
 
         terminal.println(Terminal.Verbosity.VERBOSE, "Collecting shard data paths");
@@ -130,9 +133,14 @@ private void processMasterNoDataNode(Terminal terminal, Path[] dataPaths) throws
             return;
         }
 
-        Set<Path> indexPaths = uniqueParentPaths(shardDataPaths);
-        Set<String> indexUUIDs = indexUUIDsFor(indexPaths);
-        outputVerboseInformation(terminal, nodePaths, shardDataPaths, indexUUIDs);
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+
+        final MetaData metaData = loadClusterState(terminal, env, persistedClusterStateService).metaData();
+
+        final Set<Path> indexPaths = uniqueParentPaths(shardDataPaths);
+        final Set<String> indexUUIDs = indexUUIDsFor(indexPaths);
+
+        outputVerboseInformation(terminal, shardDataPaths, indexUUIDs, metaData);
 
         terminal.println(shardMessage(shardDataPaths.size(), indexUUIDs.size()));
         outputHowToSeeVerboseInformation(terminal);
@@ -140,18 +148,22 @@ private void processMasterNoDataNode(Terminal terminal, Path[] dataPaths) throws
         terminal.println("Node is being re-purposed as master and no-data. Clean-up of shard data will be performed.");
         confirm(terminal, "Do you want to proceed?");
 
-        removePaths(terminal, shardDataPaths);
+        removePaths(terminal, shardDataPaths); // clean-up shard dirs
 
         terminal.println("Node successfully repurposed to master and no-data.");
     }
 
-    private void outputVerboseInformation(Terminal terminal, NodeEnvironment.NodePath[] nodePaths,
-                                          Collection<Path> pathsToCleanup, Set<String> indexUUIDs) {
+    private ClusterState loadClusterState(Terminal terminal, Environment env, PersistedClusterStateService psf) throws IOException {
+        terminal.println(Terminal.Verbosity.VERBOSE, "Loading cluster state");
+        return clusterState(env, psf.loadBestOnDiskState());
+    }
+
+    private void outputVerboseInformation(Terminal terminal, Collection<Path> pathsToCleanup, Set<String> indexUUIDs, MetaData metaData) {
         if (terminal.isPrintable(Terminal.Verbosity.VERBOSE)) {
             terminal.println(Terminal.Verbosity.VERBOSE, "Paths to clean up:");
             pathsToCleanup.forEach(p -> terminal.println(Terminal.Verbosity.VERBOSE, "  " + p.toString()));
             terminal.println(Terminal.Verbosity.VERBOSE, "Indices affected:");
-            indexUUIDs.forEach(uuid -> terminal.println(Terminal.Verbosity.VERBOSE, "  " + toIndexName(nodePaths, uuid)));
+            indexUUIDs.forEach(uuid -> terminal.println(Terminal.Verbosity.VERBOSE, "  " + toIndexName(uuid, metaData)));
         }
     }
 
@@ -160,17 +172,15 @@ private void outputHowToSeeVerboseInformation(Terminal terminal) {
             terminal.println("Use -v to see list of paths and indices affected");
         }
     }
-    private String toIndexName(NodeEnvironment.NodePath[] nodePaths, String uuid) {
-        Path[] indexPaths = new Path[nodePaths.length];
-        for (int i = 0; i < nodePaths.length; i++) {
-            indexPaths[i] = nodePaths[i].resolve(uuid);
-        }
-        try {
-            IndexMetaData metaData = IndexMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, indexPaths);
-            return metaData.getIndex().getName();
-        } catch (Exception e) {
-            return "no name for uuid: " + uuid + ": " + e;
+    private String toIndexName(String uuid, MetaData metaData) {
+        if (metaData != null) {
+            for (ObjectObjectCursor<String, IndexMetaData> indexMetaData : metaData.indices()) {
+                if (indexMetaData.value.getIndexUUID().equals(uuid)) {
+                    return indexMetaData.value.getIndex().getName();
+                }
+            }
         }
+        return "no name for uuid: " + uuid;
     }
 
     private Set<String> indexUUIDsFor(Set<Path> indexPaths) {
@@ -186,23 +196,6 @@ static String shardMessage(int shards, int indices) {
         return "Found " + shards + " shards in " + indices + " indices to clean up";
     }
 
-    private void rewriteManifest(Terminal terminal, Manifest manifest, Path[] dataPaths) throws WriteStateException {
-        terminal.println(Terminal.Verbosity.VERBOSE, "Re-writing manifest");
-        Manifest newManifest = new Manifest(manifest.getCurrentTerm(), manifest.getClusterStateVersion(), manifest.getGlobalGeneration(),
-            new HashMap<>());
-        Manifest.FORMAT.writeAndCleanup(newManifest, dataPaths);
-    }
-
-    private Manifest loadManifest(Terminal terminal, Path[] dataPaths) throws IOException {
-        terminal.println(Terminal.Verbosity.VERBOSE, "Loading manifest");
-        final Manifest manifest = Manifest.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY, dataPaths);
-
-        if (manifest == null) {
-            terminal.println(Terminal.Verbosity.SILENT, PRE_V7_MESSAGE);
-        }
-        return manifest;
-    }
-
     private void removePaths(Terminal terminal, Collection<Path> paths) {
         terminal.println(Terminal.Verbosity.VERBOSE, "Removing data");
         paths.forEach(this::removePath);
diff --git a/server/src/main/java/org/elasticsearch/env/OverrideNodeVersionCommand.java b/server/src/main/java/org/elasticsearch/env/OverrideNodeVersionCommand.java
index f50bdf081ef85..52c2a9cb366d5 100644
--- a/server/src/main/java/org/elasticsearch/env/OverrideNodeVersionCommand.java
+++ b/server/src/main/java/org/elasticsearch/env/OverrideNodeVersionCommand.java
@@ -19,21 +19,18 @@
 package org.elasticsearch.env;
 
 import joptsimple.OptionParser;
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
+import joptsimple.OptionSet;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.Version;
 import org.elasticsearch.cli.Terminal;
 import org.elasticsearch.cluster.coordination.ElasticsearchNodeCommand;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 
 import java.io.IOException;
 import java.nio.file.Path;
 import java.util.Arrays;
 
 public class OverrideNodeVersionCommand extends ElasticsearchNodeCommand {
-    private static final Logger logger = LogManager.getLogger(OverrideNodeVersionCommand.class);
-
     private static final String TOO_NEW_MESSAGE =
         DELIMITER +
             "\n" +
@@ -72,10 +69,9 @@ public OverrideNodeVersionCommand() {
     }
 
     @Override
-    protected void processNodePaths(Terminal terminal, Path[] dataPaths, Environment env) throws IOException {
+    protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env) throws IOException {
         final Path[] nodePaths = Arrays.stream(toNodePaths(dataPaths)).map(p -> p.path).toArray(Path[]::new);
-        final NodeMetaData nodeMetaData
-            = new NodeMetaData.NodeMetaDataStateFormat(true).loadLatestState(logger, NamedXContentRegistry.EMPTY, nodePaths);
+        final NodeMetaData nodeMetaData = PersistedClusterStateService.nodeMetaData(nodePaths);
         if (nodeMetaData == null) {
             throw new ElasticsearchException(NO_METADATA_MESSAGE);
         }
@@ -93,7 +89,7 @@ protected void processNodePaths(Terminal terminal, Path[] dataPaths, Environment
             .replace("V_NEW", nodeMetaData.nodeVersion().toString())
             .replace("V_CUR", Version.CURRENT.toString()));
 
-        NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(nodeMetaData.nodeId(), Version.CURRENT), nodePaths);
+        PersistedClusterStateService.overrideVersion(Version.CURRENT, dataPaths);
 
         terminal.println(SUCCESS_MESSAGE);
     }
diff --git a/server/src/main/java/org/elasticsearch/gateway/GatewayMetaState.java b/server/src/main/java/org/elasticsearch/gateway/GatewayMetaState.java
index c60f5d6b7d40c..1a1d9beb85613 100644
--- a/server/src/main/java/org/elasticsearch/gateway/GatewayMetaState.java
+++ b/server/src/main/java/org/elasticsearch/gateway/GatewayMetaState.java
@@ -22,14 +22,14 @@
 import com.carrotsearch.hppc.cursors.ObjectObjectCursor;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.apache.lucene.store.AlreadyClosedException;
 import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.Version;
-import org.elasticsearch.cluster.ClusterChangedEvent;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.ClusterStateApplier;
+import org.elasticsearch.cluster.coordination.CoordinationMetaData;
 import org.elasticsearch.cluster.coordination.CoordinationState.PersistedState;
 import org.elasticsearch.cluster.coordination.InMemoryPersistedState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
@@ -42,19 +42,33 @@
 import org.elasticsearch.common.collect.ImmutableOpenMap;
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.unit.TimeValue;
-import org.elasticsearch.index.Index;
+import org.elasticsearch.common.util.concurrent.AbstractRunnable;
+import org.elasticsearch.common.util.concurrent.EsExecutors;
+import org.elasticsearch.common.util.concurrent.EsRejectedExecutionException;
+import org.elasticsearch.common.util.concurrent.EsThreadPoolExecutor;
+import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.env.NodeMetaData;
+import org.elasticsearch.node.Node;
 import org.elasticsearch.plugins.MetaDataUpgrader;
+import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
 
+import java.io.Closeable;
 import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
+import java.util.Objects;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.BiConsumer;
 import java.util.function.Consumer;
 import java.util.function.Function;
 import java.util.function.UnaryOperator;
 
+import static org.elasticsearch.common.util.concurrent.EsExecutors.daemonThreadFactory;
+
 /**
  * Loads (and maybe upgrades) cluster metadata at startup, and persistently stores cluster metadata for future restarts.
  *
@@ -63,8 +77,7 @@
  * ClusterState#metaData()} because it might be stale or incomplete. Master-eligible nodes must perform an election to find a complete and
  * non-stale state, and master-ineligible nodes receive the real cluster state from the elected master after joining the cluster.
  */
-public class GatewayMetaState {
-    private static final Logger logger = LogManager.getLogger(GatewayMetaState.class);
+public class GatewayMetaState implements Closeable {
 
     // Set by calling start()
     private final SetOnce<PersistedState> persistedState = new SetOnce<>();
@@ -81,49 +94,83 @@ public MetaData getMetaData() {
 
     public void start(Settings settings, TransportService transportService, ClusterService clusterService,
                       MetaStateService metaStateService, MetaDataIndexUpgradeService metaDataIndexUpgradeService,
-                      MetaDataUpgrader metaDataUpgrader) {
+                      MetaDataUpgrader metaDataUpgrader, PersistedClusterStateService persistedClusterStateService) {
         assert persistedState.get() == null : "should only start once, but already have " + persistedState.get();
 
-        final Tuple<Manifest, ClusterState> manifestClusterStateTuple;
-        try {
-            upgradeMetaData(settings, metaStateService, metaDataIndexUpgradeService, metaDataUpgrader);
-            manifestClusterStateTuple = loadStateAndManifest(ClusterName.CLUSTER_NAME_SETTING.get(settings), metaStateService);
-        } catch (IOException e) {
-            throw new ElasticsearchException("failed to load metadata", e);
-        }
+        if (DiscoveryNode.isMasterNode(settings) || DiscoveryNode.isDataNode(settings)) {
+            try {
+                final PersistedClusterStateService.OnDiskState onDiskState = persistedClusterStateService.loadBestOnDiskState();
+
+                MetaData metaData = onDiskState.metaData;
+                long lastAcceptedVersion = onDiskState.lastAcceptedVersion;
+                long currentTerm = onDiskState.currentTerm;
+
+                if (onDiskState.empty()) {
+                    assert Version.CURRENT.major <= Version.V_7_0_0.major + 1 :
+                        "legacy metadata loader is not needed anymore from v9 onwards";
+                    final Tuple<Manifest, MetaData> legacyState = metaStateService.loadFullState();
+                    if (legacyState.v1().isEmpty() == false) {
+                        metaData = legacyState.v2();
+                        lastAcceptedVersion = legacyState.v1().getClusterStateVersion();
+                        currentTerm = legacyState.v1().getCurrentTerm();
+                    }
+                }
 
-        final IncrementalClusterStateWriter incrementalClusterStateWriter
-            = new IncrementalClusterStateWriter(settings, clusterService.getClusterSettings(), metaStateService,
-                manifestClusterStateTuple.v1(),
-                prepareInitialClusterState(transportService, clusterService, manifestClusterStateTuple.v2()),
-                transportService.getThreadPool()::relativeTimeInMillis);
-        if (DiscoveryNode.isMasterNode(settings) == false) {
-            if (DiscoveryNode.isDataNode(settings)) {
-                // Master-eligible nodes persist index metadata for all indices regardless of whether they hold any shards or not. It's
-                // vitally important to the safety of the cluster coordination system that master-eligible nodes persist this metadata when
-                // _accepting_ the cluster state (i.e. before it is committed). This persistence happens on the generic threadpool.
-                //
-                // In contrast, master-ineligible data nodes only persist the index metadata for shards that they hold. When all shards of
-                // an index are moved off such a node the IndicesStore is responsible for removing the corresponding index directory,
-                // including the metadata, and does so on the cluster applier thread.
-                //
-                // This presents a problem: if a shard is unassigned from a node and then reassigned back to it again then there is a race
-                // between the IndicesStore deleting the index folder and the CoordinationState concurrently trying to write the updated
-                // metadata into it. We could probably solve this with careful synchronization, but in fact there is no need.  The persisted
-                // state on master-ineligible data nodes is mostly ignored - it's only there to support dangling index imports, which is
-                // inherently unsafe anyway. Thus we can safely delay metadata writes on master-ineligible data nodes until applying the
-                // cluster state, which is what this does:
-                clusterService.addLowPriorityApplier(new GatewayClusterApplier(incrementalClusterStateWriter));
-            }
+                PersistedState persistedState = null;
+                boolean success = false;
+                try {
+                    final ClusterState clusterState = prepareInitialClusterState(transportService, clusterService,
+                        ClusterState.builder(ClusterName.CLUSTER_NAME_SETTING.get(settings))
+                            .version(lastAcceptedVersion)
+                            .metaData(upgradeMetaDataForNode(metaData, metaDataIndexUpgradeService, metaDataUpgrader))
+                            .build());
+                    if (DiscoveryNode.isMasterNode(settings)) {
+                        persistedState = new LucenePersistedState(persistedClusterStateService, currentTerm, clusterState);
+                    } else {
+                        persistedState = new AsyncLucenePersistedState(settings, transportService.getThreadPool(),
+                            new LucenePersistedState(persistedClusterStateService, currentTerm, clusterState));
+                    }
+                    if (DiscoveryNode.isDataNode(settings)) {
+                        metaStateService.unreferenceAll(); // unreference legacy files (only keep them for dangling indices functionality)
+                    } else {
+                        metaStateService.deleteAll(); // delete legacy files
+                    }
+                    // write legacy node metadata to prevent accidental downgrades from spawning empty cluster state
+                    NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(persistedClusterStateService.getNodeId(), Version.CURRENT),
+                        persistedClusterStateService.getDataPaths());
+                    success = true;
+                } finally {
+                    if (success == false) {
+                        IOUtils.closeWhileHandlingException(persistedState);
+                    }
+                }
 
-            // Master-ineligible nodes do not need to persist the cluster state when accepting it because they are not in the voting
-            // configuration, so it's ok if they have a stale or incomplete cluster state when restarted. We track the latest cluster state
-            // in memory instead.
-            persistedState.set(new InMemoryPersistedState(manifestClusterStateTuple.v1().getCurrentTerm(), manifestClusterStateTuple.v2()));
+                this.persistedState.set(persistedState);
+            } catch (IOException e) {
+                throw new ElasticsearchException("failed to load metadata", e);
+            }
         } else {
-            // Master-ineligible nodes must persist the cluster state when accepting it because they must reload the (complete, fresh)
-            // last-accepted cluster state when restarted.
-            persistedState.set(new GatewayPersistedState(incrementalClusterStateWriter));
+            final long currentTerm = 0L;
+            final ClusterState clusterState = ClusterState.builder(ClusterName.CLUSTER_NAME_SETTING.get(settings)).build();
+            if (persistedClusterStateService.getDataPaths().length > 0) {
+                // write empty cluster state just so that we have a persistent node id. There is no need to write out global metadata with
+                // cluster uuid as coordinating-only nodes do not snap into a cluster as they carry no state
+                try (PersistedClusterStateService.Writer persistenceWriter = persistedClusterStateService.createWriter()) {
+                    persistenceWriter.writeFullStateAndCommit(currentTerm, clusterState);
+                } catch (IOException e) {
+                    throw new ElasticsearchException("failed to load metadata", e);
+                }
+                try {
+                    // delete legacy cluster state files
+                    metaStateService.deleteAll();
+                    // write legacy node metadata to prevent downgrades from spawning empty cluster state
+                    NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(persistedClusterStateService.getNodeId(), Version.CURRENT),
+                        persistedClusterStateService.getDataPaths());
+                } catch (IOException e) {
+                    throw new UncheckedIOException(e);
+                }
+            }
+            persistedState.set(new InMemoryPersistedState(currentTerm, clusterState));
         }
     }
 
@@ -140,67 +187,10 @@ ClusterState prepareInitialClusterState(TransportService transportService, Clust
     }
 
     // exposed so it can be overridden by tests
-    void upgradeMetaData(Settings settings, MetaStateService metaStateService, MetaDataIndexUpgradeService metaDataIndexUpgradeService,
-                         MetaDataUpgrader metaDataUpgrader) throws IOException {
-        if (isMasterOrDataNode(settings)) {
-            try {
-                final Tuple<Manifest, MetaData> metaStateAndData = metaStateService.loadFullState();
-                final Manifest manifest = metaStateAndData.v1();
-                final MetaData metaData = metaStateAndData.v2();
-
-                // We finished global state validation and successfully checked all indices for backward compatibility
-                // and found no non-upgradable indices, which means the upgrade can continue.
-                // Now it's safe to overwrite global and index metadata.
-                // We don't re-write metadata if it's not upgraded by upgrade plugins, because
-                // if there is manifest file, it means metadata is properly persisted to all data paths
-                // if there is no manifest file (upgrade from 6.x to 7.x) metadata might be missing on some data paths,
-                // but anyway we will re-write it as soon as we receive first ClusterState
-                final IncrementalClusterStateWriter.AtomicClusterStateWriter writer
-                    = new IncrementalClusterStateWriter.AtomicClusterStateWriter(metaStateService, manifest);
-                final MetaData upgradedMetaData = upgradeMetaData(metaData, metaDataIndexUpgradeService, metaDataUpgrader);
-
-                final long globalStateGeneration;
-                if (MetaData.isGlobalStateEquals(metaData, upgradedMetaData) == false) {
-                    globalStateGeneration = writer.writeGlobalState("upgrade", upgradedMetaData);
-                } else {
-                    globalStateGeneration = manifest.getGlobalGeneration();
-                }
-
-                Map<Index, Long> indices = new HashMap<>(manifest.getIndexGenerations());
-                for (IndexMetaData indexMetaData : upgradedMetaData) {
-                    if (metaData.hasIndexMetaData(indexMetaData) == false) {
-                        final long generation = writer.writeIndex("upgrade", indexMetaData);
-                        indices.put(indexMetaData.getIndex(), generation);
-                    }
-                }
-
-                final Manifest newManifest = new Manifest(manifest.getCurrentTerm(), manifest.getClusterStateVersion(),
-                        globalStateGeneration, indices);
-                writer.writeManifestAndCleanup("startup", newManifest);
-            } catch (Exception e) {
-                logger.error("failed to read or upgrade local state, exiting...", e);
-                throw e;
-            }
-        }
-    }
-
-    private static Tuple<Manifest,ClusterState> loadStateAndManifest(ClusterName clusterName,
-                                                                     MetaStateService metaStateService) throws IOException {
-        final long startNS = System.nanoTime();
-        final Tuple<Manifest, MetaData> manifestAndMetaData = metaStateService.loadFullState();
-        final Manifest manifest = manifestAndMetaData.v1();
-
-        final ClusterState clusterState = ClusterState.builder(clusterName)
-            .version(manifest.getClusterStateVersion())
-            .metaData(manifestAndMetaData.v2()).build();
-
-        logger.debug("took {} to load state", TimeValue.timeValueMillis(TimeValue.nsecToMSec(System.nanoTime() - startNS)));
-
-        return Tuple.tuple(manifest, clusterState);
-    }
-
-    private static boolean isMasterOrDataNode(Settings settings) {
-        return DiscoveryNode.isMasterNode(settings) || DiscoveryNode.isDataNode(settings);
+    MetaData upgradeMetaDataForNode(MetaData metaData,
+                                    MetaDataIndexUpgradeService metaDataIndexUpgradeService,
+                                    MetaDataUpgrader metaDataUpgrader) {
+        return upgradeMetaData(metaData, metaDataIndexUpgradeService, metaDataUpgrader);
     }
 
     /**
@@ -252,81 +242,270 @@ private static boolean applyPluginUpgraders(ImmutableOpenMap<String, IndexTempla
         return false;
     }
 
+    @Override
+    public void close() throws IOException {
+        IOUtils.close(persistedState.get());
+    }
+
+    // visible for testing
+    public boolean allPendingAsyncStatesWritten() {
+        final PersistedState ps = persistedState.get();
+        if (ps instanceof AsyncLucenePersistedState) {
+            return ((AsyncLucenePersistedState) ps).allPendingAsyncStatesWritten();
+        } else {
+            return true;
+        }
+    }
+
+    static class AsyncLucenePersistedState extends InMemoryPersistedState {
+
+        private static final Logger logger = LogManager.getLogger(AsyncLucenePersistedState.class);
+
+        static final String THREAD_NAME = "AsyncLucenePersistedState#updateTask";
 
-    private static class GatewayClusterApplier implements ClusterStateApplier {
+        private final EsThreadPoolExecutor threadPoolExecutor;
+        private final PersistedState persistedState;
 
-        private final IncrementalClusterStateWriter incrementalClusterStateWriter;
+        boolean newCurrentTermQueued = false;
+        boolean newStateQueued = false;
 
-        private GatewayClusterApplier(IncrementalClusterStateWriter incrementalClusterStateWriter) {
-            this.incrementalClusterStateWriter = incrementalClusterStateWriter;
+        private final Object mutex = new Object();
+
+        AsyncLucenePersistedState(Settings settings, ThreadPool threadPool, PersistedState persistedState) {
+            super(persistedState.getCurrentTerm(), persistedState.getLastAcceptedState());
+            final String nodeName = Objects.requireNonNull(Node.NODE_NAME_SETTING.get(settings));
+            threadPoolExecutor = EsExecutors.newFixed(
+                nodeName + "/" + THREAD_NAME,
+                1, 1,
+                daemonThreadFactory(nodeName, THREAD_NAME),
+                threadPool.getThreadContext());
+            this.persistedState = persistedState;
         }
 
         @Override
-        public void applyClusterState(ClusterChangedEvent event) {
-            if (event.state().blocks().disableStatePersistence()) {
-                incrementalClusterStateWriter.setIncrementalWrite(false);
-                return;
+        public void setCurrentTerm(long currentTerm) {
+            synchronized (mutex) {
+                super.setCurrentTerm(currentTerm);
+                if (newCurrentTermQueued) {
+                    logger.trace("term update already queued (setting term to {})", currentTerm);
+                } else {
+                    logger.trace("queuing term update (setting term to {})", currentTerm);
+                    newCurrentTermQueued = true;
+                    scheduleUpdate();
+                }
             }
+        }
 
-            try {
-                // Hack: This is to ensure that non-master-eligible Zen2 nodes always store a current term
-                // that's higher than the last accepted term.
-                // TODO: can we get rid of this hack?
-                if (event.state().term() > incrementalClusterStateWriter.getPreviousManifest().getCurrentTerm()) {
-                    incrementalClusterStateWriter.setCurrentTerm(event.state().term());
+        @Override
+        public void setLastAcceptedState(ClusterState clusterState) {
+            synchronized (mutex) {
+                super.setLastAcceptedState(clusterState);
+                if (newStateQueued) {
+                    logger.trace("cluster state update already queued (setting cluster state to {})", clusterState.version());
+                } else {
+                    logger.trace("queuing cluster state update (setting cluster state to {})", clusterState.version());
+                    newStateQueued = true;
+                    scheduleUpdate();
                 }
+            }
+        }
+
+        private void scheduleUpdate() {
+            assert Thread.holdsLock(mutex);
+            try {
+                threadPoolExecutor.execute(new AbstractRunnable() {
+
+                    @Override
+                    public void onFailure(Exception e) {
+                        logger.error("Exception occurred when storing new meta data", e);
+                    }
 
-                incrementalClusterStateWriter.updateClusterState(event.state());
-                incrementalClusterStateWriter.setIncrementalWrite(true);
-            } catch (WriteStateException e) {
-                logger.warn("Exception occurred when storing new meta data", e);
+                    @Override
+                    protected void doRun() {
+                        final Long term;
+                        final ClusterState clusterState;
+                        synchronized (mutex) {
+                            if (newCurrentTermQueued) {
+                                term = getCurrentTerm();
+                                newCurrentTermQueued = false;
+                            } else {
+                                term = null;
+                            }
+                            if (newStateQueued) {
+                                clusterState = getLastAcceptedState();
+                                newStateQueued = false;
+                            } else {
+                                clusterState = null;
+                            }
+                        }
+                        // write current term before last accepted state so that it is never below term in last accepted state
+                        if (term != null) {
+                            persistedState.setCurrentTerm(term);
+                        }
+                        if (clusterState != null) {
+                            persistedState.setLastAcceptedState(resetVotingConfiguration(clusterState));
+                        }
+                    }
+                });
+            } catch (EsRejectedExecutionException e) {
+                // ignore cases where we are shutting down..., there is really nothing interesting to be done here...
+                if (threadPoolExecutor.isShutdown() == false) {
+                    assert false : "only expect rejections when shutting down";
+                    throw e;
+                }
             }
         }
 
-    }
+        static final CoordinationMetaData.VotingConfiguration staleStateConfiguration =
+            new CoordinationMetaData.VotingConfiguration(Collections.singleton("STALE_STATE_CONFIG"));
 
-    private static class GatewayPersistedState implements PersistedState {
+        static ClusterState resetVotingConfiguration(ClusterState clusterState) {
+            CoordinationMetaData newCoordinationMetaData = CoordinationMetaData.builder(clusterState.coordinationMetaData())
+                .lastAcceptedConfiguration(staleStateConfiguration)
+                .lastCommittedConfiguration(staleStateConfiguration)
+                .build();
+            return ClusterState.builder(clusterState).metaData(MetaData.builder(clusterState.metaData())
+                .coordinationMetaData(newCoordinationMetaData).build()).build();
+        }
+
+        @Override
+        public void close() throws IOException {
+            try {
+                ThreadPool.terminate(threadPoolExecutor, 10, TimeUnit.SECONDS);
+            } finally {
+                persistedState.close();
+            }
+        }
 
-        private final IncrementalClusterStateWriter incrementalClusterStateWriter;
+        boolean allPendingAsyncStatesWritten() {
+            synchronized (mutex) {
+                if (newCurrentTermQueued || newStateQueued) {
+                    return false;
+                }
+                return threadPoolExecutor.getActiveCount() == 0;
+            }
+        }
+    }
 
-        GatewayPersistedState(IncrementalClusterStateWriter incrementalClusterStateWriter) {
-            this.incrementalClusterStateWriter = incrementalClusterStateWriter;
+    /**
+     * Encapsulates the incremental writing of metadata to a {@link PersistedClusterStateService.Writer}.
+     */
+    static class LucenePersistedState implements PersistedState {
+
+        private long currentTerm;
+        private ClusterState lastAcceptedState;
+        private final PersistedClusterStateService persistedClusterStateService;
+
+        // As the close method can be concurrently called to the other PersistedState methods, this class has extra protection in place.
+        private final AtomicReference<PersistedClusterStateService.Writer> persistenceWriter = new AtomicReference<>();
+        boolean writeNextStateFully;
+
+        LucenePersistedState(PersistedClusterStateService persistedClusterStateService, long currentTerm, ClusterState lastAcceptedState)
+            throws IOException {
+            this.persistedClusterStateService = persistedClusterStateService;
+            this.currentTerm = currentTerm;
+            this.lastAcceptedState = lastAcceptedState;
+            // Write the whole state out to be sure it's fresh and using the latest format. Called during initialisation, so that
+            // (1) throwing an IOException is enough to halt the node, and
+            // (2) the index is currently empty since it was opened with IndexWriterConfig.OpenMode.CREATE
+
+            // In the common case it's actually sufficient to commit() the existing state and not do any indexing. For instance,
+            // this is true if there's only one data path on this master node, and the commit we just loaded was already written out
+            // by this version of Elasticsearch. TODO TBD should we avoid indexing when possible?
+            final PersistedClusterStateService.Writer writer = persistedClusterStateService.createWriter();
+            try {
+                writer.writeFullStateAndCommit(currentTerm, lastAcceptedState);
+            } catch (Exception e) {
+                try {
+                    writer.close();
+                } catch (Exception e2) {
+                    e.addSuppressed(e2);
+                }
+                throw e;
+            }
+            persistenceWriter.set(writer);
         }
 
         @Override
         public long getCurrentTerm() {
-            return incrementalClusterStateWriter.getPreviousManifest().getCurrentTerm();
+            return currentTerm;
         }
 
         @Override
         public ClusterState getLastAcceptedState() {
-            final ClusterState previousClusterState = incrementalClusterStateWriter.getPreviousClusterState();
-            assert previousClusterState.nodes().getLocalNode() != null : "Cluster state is not fully built yet";
-            return previousClusterState;
+            return lastAcceptedState;
         }
 
         @Override
         public void setCurrentTerm(long currentTerm) {
             try {
-                incrementalClusterStateWriter.setCurrentTerm(currentTerm);
-            } catch (WriteStateException e) {
-                logger.error(new ParameterizedMessage("Failed to set current term to {}", currentTerm), e);
-                e.rethrowAsErrorOrUncheckedException();
+                if (writeNextStateFully) {
+                    getWriterSafe().writeFullStateAndCommit(currentTerm, lastAcceptedState);
+                    writeNextStateFully = false;
+                } else {
+                    getWriterSafe().commit(currentTerm, lastAcceptedState.version());
+                }
+            } catch (Exception e) {
+                handleExceptionOnWrite(e);
             }
+            this.currentTerm = currentTerm;
         }
 
         @Override
         public void setLastAcceptedState(ClusterState clusterState) {
             try {
-                incrementalClusterStateWriter.setIncrementalWrite(
-                    incrementalClusterStateWriter.getPreviousClusterState().term() == clusterState.term());
-                incrementalClusterStateWriter.updateClusterState(clusterState);
-            } catch (WriteStateException e) {
-                logger.error(new ParameterizedMessage("Failed to set last accepted state with version {}", clusterState.version()), e);
-                e.rethrowAsErrorOrUncheckedException();
+                if (writeNextStateFully) {
+                    getWriterSafe().writeFullStateAndCommit(currentTerm, clusterState);
+                    writeNextStateFully = false;
+                } else {
+                    if (clusterState.term() != lastAcceptedState.term()) {
+                        assert clusterState.term() > lastAcceptedState.term() : clusterState.term() + " vs " + lastAcceptedState.term();
+                        // In a new currentTerm, we cannot compare the persisted metadata's lastAcceptedVersion to those in the new state,
+                        // so it's simplest to write everything again.
+                        getWriterSafe().writeFullStateAndCommit(currentTerm, clusterState);
+                    } else {
+                        // Within the same currentTerm, we _can_ use metadata versions to skip unnecessary writing.
+                        getWriterSafe().writeIncrementalStateAndCommit(currentTerm, lastAcceptedState, clusterState);
+                    }
+                }
+            } catch (Exception e) {
+                handleExceptionOnWrite(e);
             }
+
+            lastAcceptedState = clusterState;
         }
 
-    }
+        private PersistedClusterStateService.Writer getWriterSafe() {
+            final PersistedClusterStateService.Writer writer = persistenceWriter.get();
+            if (writer == null) {
+                throw new AlreadyClosedException("persisted state has been closed");
+            }
+            if (writer.isOpen()) {
+                return writer;
+            } else {
+                try {
+                    final PersistedClusterStateService.Writer newWriter = persistedClusterStateService.createWriter();
+                    if (persistenceWriter.compareAndSet(writer, newWriter)) {
+                        return newWriter;
+                    } else {
+                        assert persistenceWriter.get() == null : "expected no concurrent calls to getWriterSafe";
+                        newWriter.close();
+                        throw new AlreadyClosedException("persisted state has been closed");
+                    }
+                } catch (Exception e) {
+                    throw ExceptionsHelper.convertToRuntime(e);
+                }
+            }
+        }
+
+        private void handleExceptionOnWrite(Exception e) {
+            writeNextStateFully = true;
+            throw ExceptionsHelper.convertToRuntime(e);
+        }
 
+        @Override
+        public void close() throws IOException {
+            IOUtils.close(persistenceWriter.getAndSet(null));
+        }
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/gateway/IncrementalClusterStateWriter.java b/server/src/main/java/org/elasticsearch/gateway/IncrementalClusterStateWriter.java
index eb0d243d74fab..6ff97b6a9d2a5 100644
--- a/server/src/main/java/org/elasticsearch/gateway/IncrementalClusterStateWriter.java
+++ b/server/src/main/java/org/elasticsearch/gateway/IncrementalClusterStateWriter.java
@@ -33,7 +33,6 @@
 import org.elasticsearch.index.Index;
 
 import java.util.ArrayList;
-import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
@@ -53,9 +52,7 @@ public class IncrementalClusterStateWriter {
 
     private final MetaStateService metaStateService;
 
-    // On master-eligible nodes we call updateClusterState under the Coordinator's mutex; on master-ineligible data nodes we call
-    // updateClusterState on the (unique) cluster applier thread; on other nodes we never call updateClusterState. In all cases there's
-    // no need to synchronize access to these fields.
+    // We call updateClusterState on the (unique) cluster applier thread so there's no need to synchronize access to these fields.
     private Manifest previousManifest;
     private ClusterState previousClusterState;
     private final LongSupplier relativeTimeMillisSupplier;
@@ -89,10 +86,6 @@ Manifest getPreviousManifest() {
         return previousManifest;
     }
 
-    ClusterState getPreviousClusterState() {
-        return previousClusterState;
-    }
-
     void setIncrementalWrite(boolean incrementalWrite) {
         this.incrementalWrite = incrementalWrite;
     }
@@ -206,38 +199,20 @@ static List<IndexMetaDataAction> resolveIndexMetaDataActions(Map<Index, Long> pr
         return actions;
     }
 
-    private static Set<Index> getRelevantIndicesOnDataOnlyNode(ClusterState state) {
-        RoutingNode newRoutingNode = state.getRoutingNodes().node(state.nodes().getLocalNodeId());
+    // exposed for tests
+    static Set<Index> getRelevantIndices(ClusterState state) {
+        assert state.nodes().getLocalNode().isDataNode();
+        final RoutingNode newRoutingNode = state.getRoutingNodes().node(state.nodes().getLocalNodeId());
         if (newRoutingNode == null) {
             throw new IllegalStateException("cluster state does not contain this node - cannot write index meta state");
         }
-        Set<Index> indices = new HashSet<>();
-        for (ShardRouting routing : newRoutingNode) {
+        final Set<Index> indices = new HashSet<>();
+        for (final ShardRouting routing : newRoutingNode) {
             indices.add(routing.index());
         }
         return indices;
     }
 
-    private static Set<Index> getRelevantIndicesForMasterEligibleNode(ClusterState state) {
-        Set<Index> relevantIndices = new HashSet<>();
-        // we have to iterate over the metadata to make sure we also capture closed indices
-        for (IndexMetaData indexMetaData : state.metaData()) {
-            relevantIndices.add(indexMetaData.getIndex());
-        }
-        return relevantIndices;
-    }
-
-    // exposed for tests
-    static Set<Index> getRelevantIndices(ClusterState state) {
-        if (state.nodes().getLocalNode().isMasterNode()) {
-            return getRelevantIndicesForMasterEligibleNode(state);
-        } else if (state.nodes().getLocalNode().isDataNode()) {
-            return getRelevantIndicesOnDataOnlyNode(state);
-        } else {
-            return Collections.emptySet();
-        }
-    }
-
     /**
      * Action to perform with index metadata.
      */
diff --git a/server/src/main/java/org/elasticsearch/gateway/MetaStateService.java b/server/src/main/java/org/elasticsearch/gateway/MetaStateService.java
index 3ce3f8918a190..0fb631813cbb2 100644
--- a/server/src/main/java/org/elasticsearch/gateway/MetaStateService.java
+++ b/server/src/main/java/org/elasticsearch/gateway/MetaStateService.java
@@ -68,7 +68,7 @@ public MetaStateService(NodeEnvironment nodeEnv, NamedXContentRegistry namedXCon
      * meta state with globalGeneration -1 and empty meta data is returned.
      * @throws IOException if some IOException when loading files occurs or there is no metadata referenced by manifest file.
      */
-    Tuple<Manifest, MetaData> loadFullState() throws IOException {
+    public Tuple<Manifest, MetaData> loadFullState() throws IOException {
         final Manifest manifest = MANIFEST_FORMAT.loadLatestState(logger, namedXContentRegistry, nodeEnv.nodeDataPaths());
         if (manifest == null) {
             return loadFullStateBWC();
@@ -184,17 +184,6 @@ List<IndexMetaData> loadIndicesStates(Predicate<String> excludeIndexPathIdsPredi
         return indexMetaDataList;
     }
 
-    /**
-     * Loads Manifest file from disk, returns <code>Manifest.empty()</code> if there is no manifest file.
-     */
-    public Manifest loadManifestOrEmpty() throws IOException {
-        Manifest manifest = MANIFEST_FORMAT.loadLatestState(logger, namedXContentRegistry, nodeEnv.nodeDataPaths());
-        if (manifest == null) {
-            manifest = Manifest.empty();
-        }
-        return manifest;
-    }
-
     /**
      * Loads the global state, *without* index state, see {@link #loadFullState()} for that.
      */
@@ -276,28 +265,26 @@ public void cleanupIndex(Index index, long currentGeneration) {
     }
 
     /**
-     * Writes index metadata and updates manifest file accordingly.
-     * Used by tests.
+     * Creates empty cluster state file on disk, deleting global metadata and unreferencing all index metadata
+     * (only used for dangling indices at that point).
      */
-    public void writeIndexAndUpdateManifest(String reason, IndexMetaData metaData) throws IOException {
-        long generation = writeIndex(reason, metaData);
-        Manifest manifest = loadManifestOrEmpty();
-        Map<Index, Long> indices = new HashMap<>(manifest.getIndexGenerations());
-        indices.put(metaData.getIndex(), generation);
-        manifest = new Manifest(manifest.getCurrentTerm(), manifest.getClusterStateVersion(), manifest.getGlobalGeneration(), indices);
-        writeManifestAndCleanup(reason, manifest);
-        cleanupIndex(metaData.getIndex(), generation);
+    public void unreferenceAll() throws IOException {
+        MANIFEST_FORMAT.writeAndCleanup(Manifest.empty(), nodeEnv.nodeDataPaths()); // write empty file so that indices become unreferenced
+        META_DATA_FORMAT.cleanupOldFiles(Long.MAX_VALUE, nodeEnv.nodeDataPaths());
     }
 
     /**
-     * Writes global metadata and updates manifest file accordingly.
-     * Used by tests.
+     * Removes manifest file, global metadata and all index metadata
      */
-    public void writeGlobalStateAndUpdateManifest(String reason, MetaData metaData) throws IOException {
-        long generation = writeGlobalState(reason, metaData);
-        Manifest manifest = loadManifestOrEmpty();
-        manifest = new Manifest(manifest.getCurrentTerm(), manifest.getClusterStateVersion(), generation, manifest.getIndexGenerations());
-        writeManifestAndCleanup(reason, manifest);
-        cleanupGlobalState(generation);
+    public void deleteAll() throws IOException {
+        // To ensure that the metadata is never reimported by loadFullStateBWC in case where the deletions here fail mid-way through,
+        // we first write an empty manifest file so that the indices become unreferenced, then clean up the indices, and only then delete
+        // the manifest file.
+        unreferenceAll();
+        for (String indexFolderName : nodeEnv.availableIndexFolders()) {
+            // delete meta state directories of indices
+            MetaDataStateFormat.deleteMetaState(nodeEnv.resolveIndexFolder(indexFolderName));
+        }
+        MANIFEST_FORMAT.cleanupOldFiles(Long.MAX_VALUE, nodeEnv.nodeDataPaths()); // finally delete manifest
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/gateway/PersistedClusterStateService.java b/server/src/main/java/org/elasticsearch/gateway/PersistedClusterStateService.java
new file mode 100644
index 0000000000000..09eeab049c685
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/gateway/PersistedClusterStateService.java
@@ -0,0 +1,770 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.gateway;
+
+import com.carrotsearch.hppc.cursors.ObjectCursor;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.apache.lucene.analysis.core.KeywordAnalyzer;
+import org.apache.lucene.document.Document;
+import org.apache.lucene.document.Field;
+import org.apache.lucene.document.StoredField;
+import org.apache.lucene.document.StringField;
+import org.apache.lucene.index.DirectoryReader;
+import org.apache.lucene.index.IndexNotFoundException;
+import org.apache.lucene.index.IndexWriter;
+import org.apache.lucene.index.IndexWriterConfig;
+import org.apache.lucene.index.LeafReaderContext;
+import org.apache.lucene.index.SerialMergeScheduler;
+import org.apache.lucene.index.Term;
+import org.apache.lucene.search.DocIdSetIterator;
+import org.apache.lucene.search.IndexSearcher;
+import org.apache.lucene.search.Query;
+import org.apache.lucene.search.ScoreMode;
+import org.apache.lucene.search.Scorer;
+import org.apache.lucene.search.TermQuery;
+import org.apache.lucene.search.Weight;
+import org.apache.lucene.store.AlreadyClosedException;
+import org.apache.lucene.store.Directory;
+import org.apache.lucene.store.SimpleFSDirectory;
+import org.apache.lucene.util.Bits;
+import org.apache.lucene.util.BytesRef;
+import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.Version;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.CheckedConsumer;
+import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.io.stream.ReleasableBytesStreamOutput;
+import org.elasticsearch.common.lease.Releasable;
+import org.elasticsearch.common.logging.Loggers;
+import org.elasticsearch.common.lucene.Lucene;
+import org.elasticsearch.common.util.BigArrays;
+import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentFactory;
+import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.env.NodeEnvironment;
+import org.elasticsearch.env.NodeMetaData;
+import org.elasticsearch.index.Index;
+
+import java.io.Closeable;
+import java.io.FilterOutputStream;
+import java.io.IOError;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.function.IntPredicate;
+
+/**
+ * Stores cluster metadata in a bare Lucene index (per data path) split across a number of documents. This is used by master-eligible nodes
+ * to record the last-accepted cluster state during publication. The metadata is written incrementally where possible, leaving alone any
+ * documents that have not changed. The index has the following fields:
+ *
+ * +------------------------------+-----------------------------+----------------------------------------------+
+ * | "type" (string field)        | "index_uuid" (string field) | "data" (stored binary field in SMILE format) |
+ * +------------------------------+-----------------------------+----------------------------------------------+
+ * | GLOBAL_TYPE_NAME == "global" | (omitted)                   | Global metadata                              |
+ * | INDEX_TYPE_NAME  == "index"  | Index UUID                  | Index metadata                               |
+ * +------------------------------+-----------------------------+----------------------------------------------+
+ *
+ * Additionally each commit has the following user data:
+ *
+ * +---------------------------+-------------------------+-------------------------------------------------------------------------------+
+ * |        Key symbol         |       Key literal       |                                     Value                                     |
+ * +---------------------------+-------------------------+-------------------------------------------------------------------------------+
+ * | CURRENT_TERM_KEY          | "current_term"          | Node's "current" term (≥ last-accepted term and the terms of all sent joins)  |
+ * | LAST_ACCEPTED_VERSION_KEY | "last_accepted_version" | The cluster state version corresponding with the persisted metadata           |
+ * | NODE_ID_KEY               | "node_id"               | The (persistent) ID of the node that wrote this metadata                      |
+ * | NODE_VERSION_KEY          | "node_version"          | The (ID of the) version of the node that wrote this metadata                  |
+ * +---------------------------+-------------------------+-------------------------------------------------------------------------------+
+ *
+ * (the last-accepted term is recorded in MetaData → CoordinationMetaData so does not need repeating here)
+ */
+public class PersistedClusterStateService {
+    private static final Logger logger = LogManager.getLogger(PersistedClusterStateService.class);
+    private static final String CURRENT_TERM_KEY = "current_term";
+    private static final String LAST_ACCEPTED_VERSION_KEY = "last_accepted_version";
+    private static final String NODE_ID_KEY = "node_id";
+    private static final String NODE_VERSION_KEY = "node_version";
+    private static final String TYPE_FIELD_NAME = "type";
+    private static final String DATA_FIELD_NAME = "data";
+    private static final String GLOBAL_TYPE_NAME = "global";
+    private static final String INDEX_TYPE_NAME = "index";
+    private static final String INDEX_UUID_FIELD_NAME = "index_uuid";
+    private static final int COMMIT_DATA_SIZE = 4;
+
+    public static final String METADATA_DIRECTORY_NAME = MetaDataStateFormat.STATE_DIR_NAME;
+
+    private final Path[] dataPaths;
+    private final String nodeId;
+    private final NamedXContentRegistry namedXContentRegistry;
+    private final BigArrays bigArrays;
+    private final boolean preserveUnknownCustoms;
+
+    public PersistedClusterStateService(NodeEnvironment nodeEnvironment, NamedXContentRegistry namedXContentRegistry, BigArrays bigArrays) {
+        this(nodeEnvironment.nodeDataPaths(), nodeEnvironment.nodeId(), namedXContentRegistry, bigArrays, false);
+    }
+
+    public PersistedClusterStateService(Path[] dataPaths, String nodeId, NamedXContentRegistry namedXContentRegistry, BigArrays bigArrays,
+                                        boolean preserveUnknownCustoms) {
+        this.dataPaths = dataPaths;
+        this.nodeId = nodeId;
+        this.namedXContentRegistry = namedXContentRegistry;
+        this.bigArrays = bigArrays;
+        this.preserveUnknownCustoms = preserveUnknownCustoms;
+    }
+
+    public String getNodeId() {
+        return nodeId;
+    }
+
+    /**
+     * Creates a new disk-based writer for cluster states
+     */
+    public Writer createWriter() throws IOException {
+        final List<MetaDataIndexWriter> metaDataIndexWriters = new ArrayList<>();
+        final List<Closeable> closeables = new ArrayList<>();
+        boolean success = false;
+        try {
+            for (final Path path : dataPaths) {
+                final Directory directory = createDirectory(path.resolve(METADATA_DIRECTORY_NAME));
+                closeables.add(directory);
+
+                final IndexWriter indexWriter = createIndexWriter(directory, false);
+                closeables.add(indexWriter);
+                metaDataIndexWriters.add(new MetaDataIndexWriter(directory, indexWriter));
+            }
+            success = true;
+        } finally {
+            if (success == false) {
+                IOUtils.closeWhileHandlingException(closeables);
+            }
+        }
+        return new Writer(metaDataIndexWriters, nodeId, bigArrays);
+    }
+
+    private static IndexWriter createIndexWriter(Directory directory, boolean openExisting) throws IOException {
+        final IndexWriterConfig indexWriterConfig = new IndexWriterConfig(new KeywordAnalyzer());
+        // start empty since we re-write the whole cluster state to ensure it is all using the same format version
+        indexWriterConfig.setOpenMode(openExisting ? IndexWriterConfig.OpenMode.APPEND : IndexWriterConfig.OpenMode.CREATE);
+        // only commit when specifically instructed, we must not write any intermediate states
+        indexWriterConfig.setCommitOnClose(false);
+        // most of the data goes into stored fields which are not buffered, so we only really need a tiny buffer
+        indexWriterConfig.setRAMBufferSizeMB(1.0);
+        // merge on the write thread (e.g. while flushing)
+        indexWriterConfig.setMergeScheduler(new SerialMergeScheduler());
+
+        return new IndexWriter(directory, indexWriterConfig);
+    }
+
+    /**
+     * Remove all persisted cluster states from the given data paths, for use in tests. Should only be called when there is no open
+     * {@link Writer} on these paths.
+     */
+    public static void deleteAll(Path[] dataPaths) throws IOException {
+        for (Path dataPath : dataPaths) {
+            Lucene.cleanLuceneIndex(new SimpleFSDirectory(dataPath.resolve(METADATA_DIRECTORY_NAME)));
+        }
+    }
+
+    // exposed for tests
+    Directory createDirectory(Path path) throws IOException {
+        // it is possible to disable the use of MMapDirectory for indices, and it may be surprising to users that have done so if we still
+        // use a MMapDirectory here, which might happen with FSDirectory.open(path). Concurrency is of no concern here so a
+        // SimpleFSDirectory is fine:
+        return new SimpleFSDirectory(path);
+    }
+
+    public Path[] getDataPaths() {
+        return dataPaths;
+    }
+
+    public static class OnDiskState {
+        private static final OnDiskState NO_ON_DISK_STATE = new OnDiskState(null, null, 0L, 0L, MetaData.EMPTY_META_DATA);
+
+        private final String nodeId;
+        private final Path dataPath;
+        public final long currentTerm;
+        public final long lastAcceptedVersion;
+        public final MetaData metaData;
+
+        private OnDiskState(String nodeId, Path dataPath, long currentTerm, long lastAcceptedVersion, MetaData metaData) {
+            this.nodeId = nodeId;
+            this.dataPath = dataPath;
+            this.currentTerm = currentTerm;
+            this.lastAcceptedVersion = lastAcceptedVersion;
+            this.metaData = metaData;
+        }
+
+        public boolean empty() {
+            return this == NO_ON_DISK_STATE;
+        }
+    }
+
+    /**
+     * Returns the node metadata for the given data paths, and checks if the node ids are unique
+     * @param dataPaths the data paths to scan
+     */
+    @Nullable
+    public static NodeMetaData nodeMetaData(Path... dataPaths) throws IOException {
+        String nodeId = null;
+        Version version = null;
+        for (final Path dataPath : dataPaths) {
+            final Path indexPath = dataPath.resolve(METADATA_DIRECTORY_NAME);
+            if (Files.exists(indexPath)) {
+                try (DirectoryReader reader = DirectoryReader.open(new SimpleFSDirectory(dataPath.resolve(METADATA_DIRECTORY_NAME)))) {
+                    final Map<String, String> userData = reader.getIndexCommit().getUserData();
+                    assert userData.get(NODE_VERSION_KEY) != null;
+
+                    final String thisNodeId = userData.get(NODE_ID_KEY);
+                    assert thisNodeId != null;
+                    if (nodeId != null && nodeId.equals(thisNodeId) == false) {
+                        throw new IllegalStateException("unexpected node ID in metadata, found [" + thisNodeId +
+                            "] in [" + dataPath + "] but expected [" + nodeId + "]");
+                    } else if (nodeId == null) {
+                        nodeId = thisNodeId;
+                        version = Version.fromId(Integer.parseInt(userData.get(NODE_VERSION_KEY)));
+                    }
+                } catch (IndexNotFoundException e) {
+                    logger.debug(new ParameterizedMessage("no on-disk state at {}", indexPath), e);
+                }
+            }
+        }
+        if (nodeId == null) {
+            return null;
+        }
+        return new NodeMetaData(nodeId, version);
+    }
+
+    /**
+     * Overrides the version field for the metadata in the given data path
+     */
+    public static void overrideVersion(Version newVersion, Path... dataPaths) throws IOException {
+        for (final Path dataPath : dataPaths) {
+            final Path indexPath = dataPath.resolve(METADATA_DIRECTORY_NAME);
+            if (Files.exists(indexPath)) {
+                try (DirectoryReader reader = DirectoryReader.open(new SimpleFSDirectory(dataPath.resolve(METADATA_DIRECTORY_NAME)))) {
+                    final Map<String, String> userData = reader.getIndexCommit().getUserData();
+                    assert userData.get(NODE_VERSION_KEY) != null;
+
+                    try (IndexWriter indexWriter =
+                             createIndexWriter(new SimpleFSDirectory(dataPath.resolve(METADATA_DIRECTORY_NAME)), true)) {
+                        final Map<String, String> commitData = new HashMap<>(userData);
+                        commitData.put(NODE_VERSION_KEY, Integer.toString(newVersion.id));
+                        indexWriter.setLiveCommitData(commitData.entrySet());
+                        indexWriter.commit();
+                    }
+                } catch (IndexNotFoundException e) {
+                    logger.debug(new ParameterizedMessage("no on-disk state at {}", indexPath), e);
+                }
+            }
+        }
+    }
+
+    /**
+     * Loads the best available on-disk cluster state. Returns {@link OnDiskState#NO_ON_DISK_STATE} if no such state was found.
+     */
+    public OnDiskState loadBestOnDiskState() throws IOException {
+        String committedClusterUuid = null;
+        Path committedClusterUuidPath = null;
+        OnDiskState bestOnDiskState = OnDiskState.NO_ON_DISK_STATE;
+        OnDiskState maxCurrentTermOnDiskState = bestOnDiskState;
+
+        // We use a write-all-read-one strategy: metadata is written to every data path when accepting it, which means it is mostly
+        // sufficient to read _any_ copy. "Mostly" sufficient because the user can change the set of data paths when restarting, and may
+        // add a data path containing a stale copy of the metadata. We deal with this by using the freshest copy we can find.
+        for (final Path dataPath : dataPaths) {
+            final Path indexPath = dataPath.resolve(METADATA_DIRECTORY_NAME);
+            if (Files.exists(indexPath)) {
+                try (Directory directory = createDirectory(indexPath);
+                     DirectoryReader directoryReader = DirectoryReader.open(directory)) {
+                    final OnDiskState onDiskState = loadOnDiskState(dataPath, directoryReader);
+
+                    if (nodeId.equals(onDiskState.nodeId) == false) {
+                        throw new IllegalStateException("unexpected node ID in metadata, found [" + onDiskState.nodeId +
+                            "] in [" + dataPath + "] but expected [" + nodeId + "]");
+                    }
+
+                    if (onDiskState.metaData.clusterUUIDCommitted()) {
+                        if (committedClusterUuid == null) {
+                            committedClusterUuid = onDiskState.metaData.clusterUUID();
+                            committedClusterUuidPath = dataPath;
+                        } else if (committedClusterUuid.equals(onDiskState.metaData.clusterUUID()) == false) {
+                            throw new IllegalStateException("mismatched cluster UUIDs in metadata, found [" + committedClusterUuid +
+                                "] in [" + committedClusterUuidPath + "] and [" + onDiskState.metaData.clusterUUID() + "] in ["
+                                + dataPath + "]");
+                        }
+                    }
+
+                    if (maxCurrentTermOnDiskState.empty() || maxCurrentTermOnDiskState.currentTerm < onDiskState.currentTerm) {
+                        maxCurrentTermOnDiskState = onDiskState;
+                    }
+
+                    long acceptedTerm = onDiskState.metaData.coordinationMetaData().term();
+                    long maxAcceptedTerm = bestOnDiskState.metaData.coordinationMetaData().term();
+                    if (bestOnDiskState.empty()
+                        || acceptedTerm > maxAcceptedTerm
+                        || (acceptedTerm == maxAcceptedTerm
+                            && (onDiskState.lastAcceptedVersion > bestOnDiskState.lastAcceptedVersion
+                                || (onDiskState.lastAcceptedVersion == bestOnDiskState.lastAcceptedVersion)
+                                    && onDiskState.currentTerm > bestOnDiskState.currentTerm))) {
+                        bestOnDiskState = onDiskState;
+                    }
+                } catch (IndexNotFoundException e) {
+                    logger.debug(new ParameterizedMessage("no on-disk state at {}", indexPath), e);
+                }
+            }
+        }
+
+        if (bestOnDiskState.currentTerm != maxCurrentTermOnDiskState.currentTerm) {
+            throw new IllegalStateException("inconsistent terms found: best state is from [" + bestOnDiskState.dataPath +
+                "] in term [" + bestOnDiskState.currentTerm + "] but there is a stale state in [" + maxCurrentTermOnDiskState.dataPath +
+                "] with greater term [" + maxCurrentTermOnDiskState.currentTerm + "]");
+        }
+
+        return bestOnDiskState;
+    }
+
+    private OnDiskState loadOnDiskState(Path dataPath, DirectoryReader reader) throws IOException {
+        final IndexSearcher searcher = new IndexSearcher(reader);
+        searcher.setQueryCache(null);
+
+        final SetOnce<MetaData.Builder> builderReference = new SetOnce<>();
+        consumeFromType(searcher, GLOBAL_TYPE_NAME, bytes ->
+        {
+            final MetaData metaData = MetaData.Builder.fromXContent(XContentFactory.xContent(XContentType.SMILE)
+                .createParser(namedXContentRegistry, LoggingDeprecationHandler.INSTANCE, bytes.bytes, bytes.offset, bytes.length),
+                preserveUnknownCustoms);
+            logger.trace("found global metadata with last-accepted term [{}]", metaData.coordinationMetaData().term());
+            if (builderReference.get() != null) {
+                throw new IllegalStateException("duplicate global metadata found in [" + dataPath + "]");
+            }
+            builderReference.set(MetaData.builder(metaData));
+        });
+
+        final MetaData.Builder builder = builderReference.get();
+        if (builder == null) {
+            throw new IllegalStateException("no global metadata found in [" + dataPath + "]");
+        }
+
+        logger.trace("got global metadata, now reading index metadata");
+
+        final Set<String> indexUUIDs = new HashSet<>();
+        consumeFromType(searcher, INDEX_TYPE_NAME, bytes ->
+        {
+            final IndexMetaData indexMetaData = IndexMetaData.fromXContent(XContentFactory.xContent(XContentType.SMILE)
+                .createParser(namedXContentRegistry, LoggingDeprecationHandler.INSTANCE, bytes.bytes, bytes.offset, bytes.length));
+            logger.trace("found index metadata for {}", indexMetaData.getIndex());
+            if (indexUUIDs.add(indexMetaData.getIndexUUID()) == false) {
+                throw new IllegalStateException("duplicate metadata found for " + indexMetaData.getIndex() + " in [" + dataPath + "]");
+            }
+            builder.put(indexMetaData, false);
+        });
+
+        final Map<String, String> userData = reader.getIndexCommit().getUserData();
+        logger.trace("loaded metadata [{}] from [{}]", userData, reader.directory());
+        assert userData.size() == COMMIT_DATA_SIZE : userData;
+        assert userData.get(CURRENT_TERM_KEY) != null;
+        assert userData.get(LAST_ACCEPTED_VERSION_KEY) != null;
+        assert userData.get(NODE_ID_KEY) != null;
+        assert userData.get(NODE_VERSION_KEY) != null;
+        return new OnDiskState(userData.get(NODE_ID_KEY), dataPath, Long.parseLong(userData.get(CURRENT_TERM_KEY)),
+            Long.parseLong(userData.get(LAST_ACCEPTED_VERSION_KEY)), builder.build());
+    }
+
+    private static void consumeFromType(IndexSearcher indexSearcher, String type,
+                                        CheckedConsumer<BytesRef, IOException> bytesRefConsumer) throws IOException {
+
+        final Query query = new TermQuery(new Term(TYPE_FIELD_NAME, type));
+        final Weight weight = indexSearcher.createWeight(query, ScoreMode.COMPLETE_NO_SCORES, 0.0f);
+        logger.trace("running query [{}]", query);
+
+        for (LeafReaderContext leafReaderContext : indexSearcher.getIndexReader().leaves()) {
+            logger.trace("new leafReaderContext: {}", leafReaderContext);
+            final Scorer scorer = weight.scorer(leafReaderContext);
+            if (scorer != null) {
+                final Bits liveDocs = leafReaderContext.reader().getLiveDocs();
+                final IntPredicate isLiveDoc = liveDocs == null ? i -> true : liveDocs::get;
+                final DocIdSetIterator docIdSetIterator = scorer.iterator();
+                while (docIdSetIterator.nextDoc() != DocIdSetIterator.NO_MORE_DOCS) {
+                    if (isLiveDoc.test(docIdSetIterator.docID())) {
+                        logger.trace("processing doc {}", docIdSetIterator.docID());
+                        bytesRefConsumer.accept(
+                            leafReaderContext.reader().document(docIdSetIterator.docID()).getBinaryValue(DATA_FIELD_NAME));
+                    }
+                }
+            }
+        }
+    }
+
+    private static final ToXContent.Params FORMAT_PARAMS;
+
+    static {
+        Map<String, String> params = new HashMap<>(2);
+        params.put("binary", "true");
+        params.put(MetaData.CONTEXT_MODE_PARAM, MetaData.CONTEXT_MODE_GATEWAY);
+        FORMAT_PARAMS = new ToXContent.MapParams(params);
+    }
+
+    /**
+     * A {@link Document} with a stored field containing serialized metadata written to a {@link ReleasableBytesStreamOutput} which must be
+     * released when no longer needed.
+     */
+    private static class ReleasableDocument implements Releasable {
+        private final Document document;
+        private final Releasable releasable;
+
+        ReleasableDocument(Document document, Releasable releasable) {
+            this.document = document;
+            this.releasable = releasable;
+        }
+
+        Document getDocument() {
+            return document;
+        }
+
+        @Override
+        public void close() {
+            releasable.close();
+        }
+    }
+
+    /**
+     * Encapsulates a single {@link IndexWriter} with its {@link Directory} for ease of closing, and a {@link Logger}. There is one of these
+     * for each data path.
+     */
+    private static class MetaDataIndexWriter implements Closeable {
+
+        private final Logger logger;
+        private final Directory directory;
+        private final IndexWriter indexWriter;
+
+        MetaDataIndexWriter(Directory directory, IndexWriter indexWriter) {
+            this.directory = directory;
+            this.indexWriter = indexWriter;
+            this.logger = Loggers.getLogger(MetaDataIndexWriter.class, directory.toString());
+        }
+
+        void deleteAll() throws IOException {
+            this.logger.trace("clearing existing metadata");
+            this.indexWriter.deleteAll();
+        }
+
+        void updateIndexMetaDataDocument(Document indexMetaDataDocument, Index index) throws IOException {
+            this.logger.trace("updating metadata for [{}]", index);
+            indexWriter.updateDocument(new Term(INDEX_UUID_FIELD_NAME, index.getUUID()), indexMetaDataDocument);
+        }
+
+        void updateGlobalMetaData(Document globalMetaDataDocument) throws IOException {
+            this.logger.trace("updating global metadata doc");
+            indexWriter.updateDocument(new Term(TYPE_FIELD_NAME, GLOBAL_TYPE_NAME), globalMetaDataDocument);
+        }
+
+        void deleteIndexMetaData(String indexUUID) throws IOException {
+            this.logger.trace("removing metadata for [{}]", indexUUID);
+            indexWriter.deleteDocuments(new Term(INDEX_UUID_FIELD_NAME, indexUUID));
+        }
+
+        void flush() throws IOException {
+            this.logger.trace("flushing");
+            this.indexWriter.flush();
+        }
+
+        void prepareCommit(String nodeId, long currentTerm, long lastAcceptedVersion) throws IOException {
+            final Map<String, String> commitData = new HashMap<>(COMMIT_DATA_SIZE);
+            commitData.put(CURRENT_TERM_KEY, Long.toString(currentTerm));
+            commitData.put(LAST_ACCEPTED_VERSION_KEY, Long.toString(lastAcceptedVersion));
+            commitData.put(NODE_VERSION_KEY, Integer.toString(Version.CURRENT.id));
+            commitData.put(NODE_ID_KEY, nodeId);
+            indexWriter.setLiveCommitData(commitData.entrySet());
+            indexWriter.prepareCommit();
+        }
+
+        void commit() throws IOException {
+            indexWriter.commit();
+        }
+
+        @Override
+        public void close() throws IOException {
+            IOUtils.close(indexWriter, directory);
+        }
+    }
+
+    public static class Writer implements Closeable {
+
+        private final List<MetaDataIndexWriter> metaDataIndexWriters;
+        private final String nodeId;
+        private final BigArrays bigArrays;
+
+        boolean fullStateWritten = false;
+        private final AtomicBoolean closed = new AtomicBoolean();
+
+        private Writer(List<MetaDataIndexWriter> metaDataIndexWriters, String nodeId, BigArrays bigArrays) {
+            this.metaDataIndexWriters = metaDataIndexWriters;
+            this.nodeId = nodeId;
+            this.bigArrays = bigArrays;
+        }
+
+        private void ensureOpen() {
+            if (closed.get()) {
+                throw new AlreadyClosedException("cluster state writer is closed already");
+            }
+        }
+
+        public boolean isOpen() {
+            return closed.get() == false;
+        }
+
+        private void closeIfAnyIndexWriterHasTragedyOrIsClosed() {
+            if (metaDataIndexWriters.stream().map(writer -> writer.indexWriter)
+                .anyMatch(iw -> iw.getTragicException() != null || iw.isOpen() == false)) {
+                try {
+                    close();
+                } catch (Exception e) {
+                    logger.warn("failed on closing cluster state writer", e);
+                }
+            }
+        }
+
+        /**
+         * Overrides and commits the given current term and cluster state
+         */
+        public void writeFullStateAndCommit(long currentTerm, ClusterState clusterState) throws IOException {
+            ensureOpen();
+            try {
+                overwriteMetaData(clusterState.metaData());
+                commit(currentTerm, clusterState.version());
+                fullStateWritten = true;
+            } finally {
+                closeIfAnyIndexWriterHasTragedyOrIsClosed();
+            }
+        }
+
+        /**
+         * Updates and commits the given cluster state update
+         */
+        void writeIncrementalStateAndCommit(long currentTerm, ClusterState previousClusterState,
+                                            ClusterState clusterState) throws IOException {
+            ensureOpen();
+            assert fullStateWritten : "Need to write full state first before doing incremental writes";
+            try {
+                updateMetaData(previousClusterState.metaData(), clusterState.metaData());
+                commit(currentTerm, clusterState.version());
+            } finally {
+                closeIfAnyIndexWriterHasTragedyOrIsClosed();
+            }
+        }
+
+        /**
+         * Update the persisted metadata to match the given cluster state by removing any stale or unnecessary documents and adding any
+         * updated documents.
+         */
+        private void updateMetaData(MetaData previouslyWrittenMetaData, MetaData metaData) throws IOException {
+            assert previouslyWrittenMetaData.coordinationMetaData().term() == metaData.coordinationMetaData().term();
+            logger.trace("currentTerm [{}] matches previous currentTerm, writing changes only",
+                metaData.coordinationMetaData().term());
+
+            if (MetaData.isGlobalStateEquals(previouslyWrittenMetaData, metaData) == false) {
+                try (ReleasableDocument globalMetaDataDocument = makeGlobalMetaDataDocument(metaData)) {
+                    for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                        metaDataIndexWriter.updateGlobalMetaData(globalMetaDataDocument.getDocument());
+                    }
+                }
+            }
+
+            final Map<String, Long> indexMetaDataVersionByUUID = new HashMap<>(previouslyWrittenMetaData.indices().size());
+            for (ObjectCursor<IndexMetaData> cursor : previouslyWrittenMetaData.indices().values()) {
+                final IndexMetaData indexMetaData = cursor.value;
+                final Long previousValue = indexMetaDataVersionByUUID.putIfAbsent(indexMetaData.getIndexUUID(), indexMetaData.getVersion());
+                assert previousValue == null : indexMetaData.getIndexUUID() + " already mapped to " + previousValue;
+            }
+
+            for (ObjectCursor<IndexMetaData> cursor : metaData.indices().values()) {
+                final IndexMetaData indexMetaData = cursor.value;
+                final Long previousVersion = indexMetaDataVersionByUUID.get(indexMetaData.getIndexUUID());
+                if (previousVersion == null || indexMetaData.getVersion() != previousVersion) {
+                    logger.trace("updating metadata for [{}], changing version from [{}] to [{}]",
+                        indexMetaData.getIndex(), previousVersion, indexMetaData.getVersion());
+                    try (ReleasableDocument indexMetaDataDocument = makeIndexMetaDataDocument(indexMetaData)) {
+                        for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                            metaDataIndexWriter.updateIndexMetaDataDocument(indexMetaDataDocument.getDocument(), indexMetaData.getIndex());
+                        }
+                    }
+                } else {
+                    logger.trace("no action required for [{}]", indexMetaData.getIndex());
+                }
+                indexMetaDataVersionByUUID.remove(indexMetaData.getIndexUUID());
+            }
+
+            for (String removedIndexUUID : indexMetaDataVersionByUUID.keySet()) {
+                for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                    metaDataIndexWriter.deleteIndexMetaData(removedIndexUUID);
+                }
+            }
+
+            // Flush, to try and expose a failure (e.g. out of disk space) before committing, because we can handle a failure here more
+            // gracefully than one that occurs during the commit process.
+            for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                metaDataIndexWriter.flush();
+            }
+        }
+
+        /**
+         * Update the persisted metadata to match the given cluster state by removing all existing documents and then adding new documents.
+         */
+        private void overwriteMetaData(MetaData metaData) throws IOException {
+            for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                metaDataIndexWriter.deleteAll();
+            }
+            addMetaData(metaData);
+        }
+
+        /**
+         * Add documents for the metadata of the given cluster state, assuming that there are currently no documents.
+         */
+        private void addMetaData(MetaData metaData) throws IOException {
+            try (ReleasableDocument globalMetaDataDocument = makeGlobalMetaDataDocument(metaData)) {
+                for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                    metaDataIndexWriter.updateGlobalMetaData(globalMetaDataDocument.getDocument());
+                }
+            }
+
+            for (ObjectCursor<IndexMetaData> cursor : metaData.indices().values()) {
+                final IndexMetaData indexMetaData = cursor.value;
+                try (ReleasableDocument indexMetaDataDocument = makeIndexMetaDataDocument(indexMetaData)) {
+                    for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                        metaDataIndexWriter.updateIndexMetaDataDocument(indexMetaDataDocument.getDocument(), indexMetaData.getIndex());
+                    }
+                }
+            }
+
+            // Flush, to try and expose a failure (e.g. out of disk space) before committing, because we can handle a failure here more
+            // gracefully than one that occurs during the commit process.
+            for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                metaDataIndexWriter.flush();
+            }
+        }
+
+        public void commit(long currentTerm, long lastAcceptedVersion) throws IOException {
+            ensureOpen();
+            try {
+                for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                    metaDataIndexWriter.prepareCommit(nodeId, currentTerm, lastAcceptedVersion);
+                }
+            } catch (Exception e) {
+                try {
+                    close();
+                } catch (Exception e2) {
+                    logger.warn("failed on closing cluster state writer", e2);
+                    e.addSuppressed(e2);
+                }
+                throw e;
+            } finally {
+                closeIfAnyIndexWriterHasTragedyOrIsClosed();
+            }
+            try {
+                for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
+                    metaDataIndexWriter.commit();
+                }
+            } catch (IOException e) {
+                // The commit() call has similar semantics to a fsync(): although it's atomic, if it fails then we've no idea whether the
+                // data on disk is now the old version or the new version, and this is a disaster. It's safest to fail the whole node and
+                // retry from the beginning.
+                try {
+                    close();
+                } catch (Exception e2) {
+                    e.addSuppressed(e2);
+                }
+                throw new IOError(e);
+            } finally {
+                closeIfAnyIndexWriterHasTragedyOrIsClosed();
+            }
+        }
+
+        @Override
+        public void close() throws IOException {
+            logger.trace("closing PersistedClusterStateService.Writer");
+            if (closed.compareAndSet(false, true)) {
+                IOUtils.close(metaDataIndexWriters);
+            }
+        }
+
+        private ReleasableDocument makeIndexMetaDataDocument(IndexMetaData indexMetaData) throws IOException {
+            final ReleasableDocument indexMetaDataDocument = makeDocument(INDEX_TYPE_NAME, indexMetaData);
+            boolean success = false;
+            try {
+                final String indexUUID = indexMetaData.getIndexUUID();
+                assert indexUUID.equals(IndexMetaData.INDEX_UUID_NA_VALUE) == false;
+                indexMetaDataDocument.getDocument().add(new StringField(INDEX_UUID_FIELD_NAME, indexUUID, Field.Store.NO));
+                success = true;
+                return indexMetaDataDocument;
+            } finally {
+                if (success == false) {
+                    IOUtils.closeWhileHandlingException(indexMetaDataDocument);
+                }
+            }
+        }
+
+        private ReleasableDocument makeGlobalMetaDataDocument(MetaData metaData) throws IOException {
+            return makeDocument(GLOBAL_TYPE_NAME, metaData);
+        }
+
+        private ReleasableDocument makeDocument(String typeName, ToXContent metaData) throws IOException {
+            final Document document = new Document();
+            document.add(new StringField(TYPE_FIELD_NAME, typeName, Field.Store.NO));
+
+            boolean success = false;
+            final ReleasableBytesStreamOutput releasableBytesStreamOutput = new ReleasableBytesStreamOutput(bigArrays);
+            try {
+                final FilterOutputStream outputStream = new FilterOutputStream(releasableBytesStreamOutput) {
+                    @Override
+                    public void close() {
+                        // closing the XContentBuilder should not release the bytes yet
+                    }
+                };
+                try (XContentBuilder xContentBuilder = XContentFactory.contentBuilder(XContentType.SMILE, outputStream)) {
+                    xContentBuilder.startObject();
+                    metaData.toXContent(xContentBuilder, FORMAT_PARAMS);
+                    xContentBuilder.endObject();
+                }
+                document.add(new StoredField(DATA_FIELD_NAME, releasableBytesStreamOutput.bytes().toBytesRef()));
+                final ReleasableDocument releasableDocument = new ReleasableDocument(document, releasableBytesStreamOutput);
+                success = true;
+                return releasableDocument;
+            } finally {
+                if (success == false) {
+                    IOUtils.closeWhileHandlingException(releasableBytesStreamOutput);
+                }
+            }
+        }
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/index/IndexService.java b/server/src/main/java/org/elasticsearch/index/IndexService.java
index 15fd0de2760a6..d7cf228e526a7 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexService.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexService.java
@@ -48,6 +48,8 @@
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.env.ShardLock;
 import org.elasticsearch.env.ShardLockObtainFailedException;
+import org.elasticsearch.gateway.MetaDataStateFormat;
+import org.elasticsearch.gateway.WriteStateException;
 import org.elasticsearch.index.analysis.IndexAnalyzers;
 import org.elasticsearch.index.cache.IndexCache;
 import org.elasticsearch.index.cache.bitset.BitsetFilterCache;
@@ -90,6 +92,7 @@
 import java.util.Map;
 import java.util.Objects;
 import java.util.Set;
+import java.util.concurrent.CopyOnWriteArrayList;
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.BooleanSupplier;
@@ -324,6 +327,29 @@ public synchronized void close(final String reason, boolean delete) throws IOExc
         }
     }
 
+    // method is synchronized so that IndexService can't be closed while we're writing out dangling indices information
+    public synchronized void writeDanglingIndicesInfo() {
+        if (closed.get()) {
+            return;
+        }
+        try {
+            IndexMetaData.FORMAT.writeAndCleanup(getMetaData(), nodeEnv.indexPaths(index()));
+        } catch (WriteStateException e) {
+            logger.warn(() -> new ParameterizedMessage("failed to write dangling indices state for index {}", index()), e);
+        }
+    }
+
+    // method is synchronized so that IndexService can't be closed while we're deleting dangling indices information
+    public synchronized void deleteDanglingIndicesInfo() {
+        if (closed.get()) {
+            return;
+        }
+        try {
+            MetaDataStateFormat.deleteMetaState(nodeEnv.indexPaths(index()));
+        } catch (IOException e) {
+            logger.warn(() -> new ParameterizedMessage("failed to delete dangling indices state for index {}", index()), e);
+        }
+    }
 
     public String indexUUID() {
         return indexSettings.getUUID();
@@ -669,24 +695,30 @@ public IndexMetaData getMetaData() {
         return indexSettings.getIndexMetaData();
     }
 
+    private final CopyOnWriteArrayList<Consumer<IndexMetaData>> metaDataListeners = new CopyOnWriteArrayList<>();
+
+    public void addMetaDataListener(Consumer<IndexMetaData> listener) {
+        metaDataListeners.add(listener);
+    }
+
     @Override
     public synchronized void updateMetaData(final IndexMetaData currentIndexMetaData, final IndexMetaData newIndexMetaData) {
-        final boolean updateIndexMetaData = indexSettings.updateIndexMetaData(newIndexMetaData);
+        final boolean updateIndexSettings = indexSettings.updateIndexMetaData(newIndexMetaData);
 
         if (Assertions.ENABLED && currentIndexMetaData != null) {
             final long currentSettingsVersion = currentIndexMetaData.getSettingsVersion();
             final long newSettingsVersion = newIndexMetaData.getSettingsVersion();
             if (currentSettingsVersion == newSettingsVersion) {
-                assert updateIndexMetaData == false;
+                assert updateIndexSettings == false;
             } else {
-                assert updateIndexMetaData;
+                assert updateIndexSettings;
                 assert currentSettingsVersion < newSettingsVersion :
                         "expected current settings version [" + currentSettingsVersion + "] "
                                 + "to be less than new settings version [" + newSettingsVersion + "]";
             }
         }
 
-        if (updateIndexMetaData) {
+        if (updateIndexSettings) {
             for (final IndexShard shard : this.shards.values()) {
                 try {
                     shard.onSettingsChanged();
@@ -722,6 +754,8 @@ public boolean isForceExecution() {
             }
             updateFsyncTaskIfNecessary();
         }
+
+        metaDataListeners.forEach(c -> c.accept(newIndexMetaData));
     }
 
     private void updateFsyncTaskIfNecessary() {
diff --git a/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java b/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
index b7a178972fa72..32e1b84c43131 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
@@ -21,7 +21,6 @@
 import joptsimple.OptionParser;
 import joptsimple.OptionSet;
 import joptsimple.OptionSpec;
-
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.lucene.index.IndexWriter;
@@ -33,9 +32,9 @@
 import org.apache.lucene.store.LockObtainFailedException;
 import org.apache.lucene.store.NativeFSLockFactory;
 import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.cli.EnvironmentAwareCommand;
 import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.cluster.ClusterModule;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.coordination.ElasticsearchNodeCommand;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.routing.AllocationId;
 import org.elasticsearch.cluster.routing.allocation.command.AllocateEmptyPrimaryAllocationCommand;
@@ -49,35 +48,30 @@
 import org.elasticsearch.common.io.PathUtils;
 import org.elasticsearch.common.lucene.Lucene;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.env.NodeMetaData;
-import org.elasticsearch.gateway.MetaDataStateFormat;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.engine.Engine;
 import org.elasticsearch.index.seqno.SequenceNumbers;
 import org.elasticsearch.index.store.Store;
 import org.elasticsearch.index.translog.TruncateTranslogAction;
-import org.elasticsearch.indices.IndicesModule;
 
 import java.io.IOException;
 import java.io.OutputStream;
 import java.io.PrintStream;
 import java.io.PrintWriter;
-import java.nio.file.DirectoryStream;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.Arrays;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Objects;
-import java.util.function.Function;
-import java.util.stream.Collectors;
-import java.util.stream.Stream;
+import java.util.stream.StreamSupport;
 
-public class RemoveCorruptedShardDataCommand extends EnvironmentAwareCommand {
+public class RemoveCorruptedShardDataCommand extends ElasticsearchNodeCommand {
 
     private static final Logger logger = LogManager.getLogger(RemoveCorruptedShardDataCommand.class);
 
@@ -88,7 +82,6 @@ public class RemoveCorruptedShardDataCommand extends EnvironmentAwareCommand {
 
     private final RemoveCorruptedLuceneSegmentsAction removeCorruptedLuceneSegmentsAction;
     private final TruncateTranslogAction truncateTranslogAction;
-    private final NamedXContentRegistry namedXContentRegistry;
 
     public RemoveCorruptedShardDataCommand() {
         super("Removes corrupted shard files");
@@ -106,11 +99,6 @@ public RemoveCorruptedShardDataCommand() {
 
         parser.accepts(TRUNCATE_CLEAN_TRANSLOG_FLAG, "Truncate the translog even if it is not corrupt");
 
-        namedXContentRegistry = new NamedXContentRegistry(
-                Stream.of(ClusterModule.getNamedXWriteables().stream(), IndicesModule.getNamedXContents().stream())
-                        .flatMap(Function.identity())
-                        .collect(Collectors.toList()));
-
         removeCorruptedLuceneSegmentsAction = new RemoveCorruptedLuceneSegmentsAction();
         truncateTranslogAction = new TruncateTranslogAction(namedXContentRegistry);
     }
@@ -130,11 +118,12 @@ protected Path getPath(String dirValue) {
         return PathUtils.get(dirValue, "", "");
     }
 
-    protected void findAndProcessShardPath(OptionSet options, Environment environment, CheckedConsumer<ShardPath, IOException> consumer)
+    protected void findAndProcessShardPath(OptionSet options, Environment environment, Path[] dataPaths, ClusterState clusterState,
+                                           CheckedConsumer<ShardPath, IOException> consumer)
     throws IOException {
         final Settings settings = environment.settings();
 
-        final String indexName;
+        final IndexMetaData indexMetaData;
         final int shardId;
 
         if (options.has(folderOption)) {
@@ -146,65 +135,48 @@ protected void findAndProcessShardPath(OptionSet options, Environment environmen
                 throw new ElasticsearchException("index directory [" + indexPath + "], must exist and be a directory");
             }
 
-            final IndexMetaData indexMetaData =
-                IndexMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry, shardParent);
-
             final String shardIdFileName = path.getFileName().toString();
+            final String indexUUIDFolderName = shardParent.getFileName().toString();
             if (Files.isDirectory(path) && shardIdFileName.chars().allMatch(Character::isDigit) // SHARD-ID path element check
                 && NodeEnvironment.INDICES_FOLDER.equals(shardParentParent.getFileName().toString()) // `indices` check
             ) {
                 shardId = Integer.parseInt(shardIdFileName);
-                indexName = indexMetaData.getIndex().getName();
+                indexMetaData = StreamSupport.stream(clusterState.metaData().indices().values().spliterator(), false)
+                    .map(imd -> imd.value)
+                    .filter(imd -> imd.getIndexUUID().equals(indexUUIDFolderName)).findFirst()
+                    .orElse(null);
             } else {
                 throw new ElasticsearchException("Unable to resolve shard id. Wrong folder structure at [ " + path.toString()
                     + " ], expected .../indices/[INDEX-UUID]/[SHARD-ID]");
             }
         } else {
             // otherwise resolve shardPath based on the index name and shard id
-            indexName = Objects.requireNonNull(indexNameOption.value(options), "Index name is required");
+            String indexName = Objects.requireNonNull(indexNameOption.value(options), "Index name is required");
             shardId = Objects.requireNonNull(shardIdOption.value(options), "Shard ID is required");
+            indexMetaData = clusterState.metaData().index(indexName);
         }
 
-        try (NodeEnvironment.NodeLock nodeLock = new NodeEnvironment.NodeLock(logger, environment, Files::exists)) {
-            final NodeEnvironment.NodePath[] nodePaths = nodeLock.getNodePaths();
-            for (NodeEnvironment.NodePath nodePath : nodePaths) {
-                if (Files.exists(nodePath.indicesPath)) {
-                    // have to scan all index uuid folders to resolve from index name
-                    try (DirectoryStream<Path> stream = Files.newDirectoryStream(nodePath.indicesPath)) {
-                        for (Path file : stream) {
-                            if (Files.exists(file.resolve(MetaDataStateFormat.STATE_DIR_NAME)) == false) {
-                                continue;
-                            }
-
-                            final IndexMetaData indexMetaData =
-                                IndexMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry, file);
-                            if (indexMetaData == null) {
-                                continue;
-                            }
-                            final IndexSettings indexSettings = new IndexSettings(indexMetaData, settings);
-                            final Index index = indexMetaData.getIndex();
-                            if (indexName.equals(index.getName()) == false) {
-                                continue;
-                            }
-                            final ShardId shId = new ShardId(index, shardId);
-
-                            final Path shardPathLocation = nodePath.resolve(shId);
-                            if (Files.exists(shardPathLocation) == false) {
-                                continue;
-                            }
-                            final ShardPath shardPath = ShardPath.loadShardPath(logger, shId, indexSettings.customDataPath(),
-                                new Path[]{shardPathLocation}, nodePath.path);
-                            if (shardPath != null) {
-                                consumer.accept(shardPath);
-                                return;
-                            }
-                        }
-                    }
+        if (indexMetaData == null) {
+            throw new ElasticsearchException("Unable to find index in cluster state");
+        }
+
+        final IndexSettings indexSettings = new IndexSettings(indexMetaData, settings);
+        final Index index = indexMetaData.getIndex();
+        final ShardId shId = new ShardId(index, shardId);
+
+        for (Path dataPath : dataPaths) {
+            final Path shardPathLocation = dataPath
+                .resolve(NodeEnvironment.INDICES_FOLDER)
+                .resolve(index.getUUID())
+                .resolve(Integer.toString(shId.id()));
+            if (Files.exists(shardPathLocation)) {
+                final ShardPath shardPath = ShardPath.loadShardPath(logger, shId, indexSettings.customDataPath(),
+                    new Path[]{shardPathLocation}, dataPath);
+                if (shardPath != null) {
+                    consumer.accept(shardPath);
+                    return;
                 }
             }
-        } catch (LockObtainFailedException lofe) {
-            throw new ElasticsearchException("Failed to lock node's directory [" + lofe.getMessage()
-                + "], is Elasticsearch still running ?");
         }
     }
 
@@ -256,11 +228,9 @@ private static void confirm(String msg, Terminal terminal) {
         }
     }
 
-    private void warnAboutESShouldBeStopped(Terminal terminal) {
+    private void warnAboutIndexBackup(Terminal terminal) {
         terminal.println("-----------------------------------------------------------------------");
         terminal.println("");
-        terminal.println("    WARNING: Elasticsearch MUST be stopped before running this tool.");
-        terminal.println("");
         terminal.println("  Please make a complete backup of your index before using this tool.");
         terminal.println("");
         terminal.println("-----------------------------------------------------------------------");
@@ -268,10 +238,12 @@ private void warnAboutESShouldBeStopped(Terminal terminal) {
 
     // Visible for testing
     @Override
-    public void execute(Terminal terminal, OptionSet options, Environment environment) throws Exception {
-        warnAboutESShouldBeStopped(terminal);
+    public void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment environment) throws IOException {
+        warnAboutIndexBackup(terminal);
 
-        findAndProcessShardPath(options, environment, shardPath -> {
+        final ClusterState clusterState = loadTermAndClusterState(createPersistedClusterStateService(dataPaths), environment).v2();
+
+        findAndProcessShardPath(options, environment, dataPaths, clusterState, shardPath -> {
             final Path indexPath = shardPath.resolveIndex();
             final Path translogPath = shardPath.resolveTranslog();
             if (Files.exists(translogPath) == false || Files.isDirectory(translogPath) == false) {
@@ -320,7 +292,7 @@ public void write(int b) {
                         terminal.println("Opening translog at " + translogPath);
                         terminal.println("");
                         try {
-                            translogCleanStatus = truncateTranslogAction.getCleanStatus(shardPath, indexDir);
+                            translogCleanStatus = truncateTranslogAction.getCleanStatus(shardPath, clusterState, indexDir);
                         } catch (Exception e) {
                             terminal.println(e.getMessage());
                             throw e;
@@ -464,21 +436,17 @@ private void newAllocationId(ShardPath shardPath, Terminal terminal) throws IOEx
         printRerouteCommand(shardPath, terminal, true);
     }
 
-    private void printRerouteCommand(ShardPath shardPath, Terminal terminal, boolean allocateStale) throws IOException {
-        final IndexMetaData indexMetaData =
-            IndexMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry,
-                shardPath.getDataPath().getParent());
-
+    private void printRerouteCommand(ShardPath shardPath, Terminal terminal, boolean allocateStale)
+        throws IOException {
         final Path nodePath = getNodePath(shardPath);
-        final NodeMetaData nodeMetaData =
-            NodeMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry, nodePath);
+        final NodeMetaData nodeMetaData = PersistedClusterStateService.nodeMetaData(nodePath);
 
         if (nodeMetaData == null) {
             throw new ElasticsearchException("No node meta data at " + nodePath);
         }
 
         final String nodeId = nodeMetaData.nodeId();
-        final String index = indexMetaData.getIndex().getName();
+        final String index = shardPath.getShardId().getIndexName();
         final int id = shardPath.getShardId().id();
         final AllocationCommands commands = new AllocationCommands(
             allocateStale
@@ -494,7 +462,8 @@ private void printRerouteCommand(ShardPath shardPath, Terminal terminal, boolean
 
     private Path getNodePath(ShardPath shardPath) {
         final Path nodePath = shardPath.getDataPath().getParent().getParent().getParent();
-        if (Files.exists(nodePath) == false || Files.exists(nodePath.resolve(MetaDataStateFormat.STATE_DIR_NAME)) == false) {
+        if (Files.exists(nodePath) == false ||
+            Files.exists(nodePath.resolve(PersistedClusterStateService.METADATA_DIRECTORY_NAME)) == false) {
             throw new ElasticsearchException("Unable to resolve node path for " + shardPath);
         }
         return nodePath;
diff --git a/server/src/main/java/org/elasticsearch/index/translog/TruncateTranslogAction.java b/server/src/main/java/org/elasticsearch/index/translog/TruncateTranslogAction.java
index e6581d0359d11..9480ee3c1e1f3 100644
--- a/server/src/main/java/org/elasticsearch/index/translog/TruncateTranslogAction.java
+++ b/server/src/main/java/org/elasticsearch/index/translog/TruncateTranslogAction.java
@@ -26,6 +26,7 @@
 import org.apache.lucene.store.Directory;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.cli.Terminal;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.collect.Tuple;
@@ -63,6 +64,7 @@ public TruncateTranslogAction(NamedXContentRegistry namedXContentRegistry) {
     }
 
     public Tuple<RemoveCorruptedShardDataCommand.CleanStatus, String> getCleanStatus(ShardPath shardPath,
+                                                                                     ClusterState clusterState,
                                                                                      Directory indexDirectory) throws IOException {
         final Path indexPath = shardPath.resolveIndex();
         final Path translogPath = shardPath.resolveTranslog();
@@ -83,7 +85,7 @@ public Tuple<RemoveCorruptedShardDataCommand.CleanStatus, String> getCleanStatus
             throw new ElasticsearchException("shard must have a valid translog UUID but got: [null]");
         }
 
-        final boolean clean = isTranslogClean(shardPath, translogUUID);
+        final boolean clean = isTranslogClean(shardPath, clusterState, translogUUID);
 
         if (clean) {
             return Tuple.tuple(RemoveCorruptedShardDataCommand.CleanStatus.CLEAN, null);
@@ -166,13 +168,12 @@ public void execute(Terminal terminal, ShardPath shardPath, Directory indexDirec
         IOUtils.fsync(translogPath, true);
     }
 
-    private boolean isTranslogClean(ShardPath shardPath, String translogUUID) throws IOException {
+    private boolean isTranslogClean(ShardPath shardPath, ClusterState clusterState, String translogUUID) throws IOException {
         // perform clean check of translog instead of corrupted marker file
         try {
             final Path translogPath = shardPath.resolveTranslog();
             final long translogGlobalCheckpoint = Translog.readGlobalCheckpoint(translogPath, translogUUID);
-            final IndexMetaData indexMetaData =
-                IndexMetaData.FORMAT.loadLatestState(logger, namedXContentRegistry, shardPath.getDataPath().getParent());
+            final IndexMetaData indexMetaData = clusterState.metaData().getIndexSafe(shardPath.getShardId().getIndex());
             final IndexSettings indexSettings = new IndexSettings(indexMetaData, Settings.EMPTY);
             final TranslogConfig translogConfig = new TranslogConfig(shardPath.getShardId(), translogPath,
                 indexSettings, BigArrays.NON_RECYCLING_INSTANCE);
diff --git a/server/src/main/java/org/elasticsearch/indices/IndicesService.java b/server/src/main/java/org/elasticsearch/indices/IndicesService.java
index deba07bc76139..62be919485669 100644
--- a/server/src/main/java/org/elasticsearch/indices/IndicesService.java
+++ b/server/src/main/java/org/elasticsearch/indices/IndicesService.java
@@ -41,6 +41,7 @@
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.routing.RecoverySource;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.service.ClusterService;
@@ -65,8 +66,12 @@
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.util.Maps;
 import org.elasticsearch.common.util.concurrent.AbstractRefCounted;
+import org.elasticsearch.common.util.concurrent.AbstractRunnable;
 import org.elasticsearch.common.util.concurrent.EsExecutors;
+import org.elasticsearch.common.util.concurrent.EsRejectedExecutionException;
+import org.elasticsearch.common.util.concurrent.EsThreadPoolExecutor;
 import org.elasticsearch.common.util.iterable.Iterables;
+import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentFactory;
@@ -116,6 +121,7 @@
 import org.elasticsearch.indices.mapper.MapperRegistry;
 import org.elasticsearch.indices.recovery.PeerRecoveryTargetService;
 import org.elasticsearch.indices.recovery.RecoveryState;
+import org.elasticsearch.node.Node;
 import org.elasticsearch.plugins.IndexStorePlugin;
 import org.elasticsearch.plugins.PluginsService;
 import org.elasticsearch.repositories.RepositoriesService;
@@ -158,6 +164,7 @@
 import static java.util.Collections.emptyMap;
 import static java.util.Collections.unmodifiableMap;
 import static org.elasticsearch.common.util.CollectionUtils.arrayAsArrayList;
+import static org.elasticsearch.common.util.concurrent.EsExecutors.daemonThreadFactory;
 import static org.elasticsearch.index.IndexService.IndexCreationContext.CREATE_INDEX;
 import static org.elasticsearch.index.IndexService.IndexCreationContext.META_DATA_VERIFICATION;
 import static org.elasticsearch.index.query.AbstractQueryBuilder.parseInnerQueryBuilder;
@@ -172,6 +179,11 @@ public class IndicesService extends AbstractLifecycleComponent
     public static final Setting<Boolean> INDICES_ID_FIELD_DATA_ENABLED_SETTING =
         Setting.boolSetting("indices.id_field_data.enabled", false, Property.Dynamic, Property.NodeScope);
 
+    public static final Setting<Boolean> WRITE_DANGLING_INDICES_INFO_SETTING = Setting.boolSetting(
+        "gateway.write_dangling_indices_info",
+        true,
+        Setting.Property.NodeScope
+    );
 
     /**
      * The node's settings.
@@ -209,6 +221,12 @@ public class IndicesService extends AbstractLifecycleComponent
     private final CountDownLatch closeLatch = new CountDownLatch(1);
     private volatile boolean idFieldDataEnabled;
 
+    @Nullable
+    private final EsThreadPoolExecutor danglingIndicesThreadPoolExecutor;
+    private final Set<Index> danglingIndicesToWrite = Sets.newConcurrentHashSet();
+    private final boolean nodeWriteDanglingIndicesInfo;
+
+
     @Override
     protected void doStart() {
         // Start thread that will manage cleaning the field data cache periodically
@@ -289,12 +307,25 @@ protected void closeInternal() {
                 }
             }
         };
+
+        final String nodeName = Objects.requireNonNull(Node.NODE_NAME_SETTING.get(settings));
+        nodeWriteDanglingIndicesInfo = WRITE_DANGLING_INDICES_INFO_SETTING.get(settings);
+        danglingIndicesThreadPoolExecutor = nodeWriteDanglingIndicesInfo ? EsExecutors.newScaling(
+            nodeName + "/" + DANGLING_INDICES_UPDATE_THREAD_NAME,
+            1, 1,
+            0, TimeUnit.MILLISECONDS,
+            daemonThreadFactory(nodeName, DANGLING_INDICES_UPDATE_THREAD_NAME),
+            threadPool.getThreadContext()) : null;
     }
 
+    private static final String DANGLING_INDICES_UPDATE_THREAD_NAME = "DanglingIndices#updateTask";
+
     @Override
     protected void doStop() {
+        ThreadPool.terminate(danglingIndicesThreadPoolExecutor, 10, TimeUnit.SECONDS);
+
         ExecutorService indicesStopExecutor =
-            Executors.newFixedThreadPool(5, EsExecutors.daemonThreadFactory(settings, "indices_shutdown"));
+            Executors.newFixedThreadPool(5, daemonThreadFactory(settings, "indices_shutdown"));
 
         // Copy indices because we modify it asynchronously in the body of the loop
         final Set<Index> indices = this.indices.values().stream().map(s -> s.index()).collect(Collectors.toSet());
@@ -455,6 +486,7 @@ public boolean hasIndex(Index index) {
     public IndexService indexService(Index index) {
         return indices.get(index.getUUID());
     }
+
     /**
      * Returns an IndexService for the specified index if exists otherwise a {@link IndexNotFoundException} is thrown.
      */
@@ -478,7 +510,8 @@ public IndexService indexServiceSafe(Index index) {
      */
     @Override
     public synchronized IndexService createIndex(
-            final IndexMetaData indexMetaData, final List<IndexEventListener> builtInListeners) throws IOException {
+            final IndexMetaData indexMetaData, final List<IndexEventListener> builtInListeners,
+            final boolean writeDanglingIndices) throws IOException {
         ensureChangesAllowed();
         if (indexMetaData.getIndexUUID().equals(IndexMetaData.INDEX_UUID_NA_VALUE)) {
             throw new IllegalArgumentException("index must have a real UUID found value: [" + indexMetaData.getIndexUUID() + "]");
@@ -514,8 +547,18 @@ public void onStoreClosed(ShardId shardId) {
                         indexingMemoryController);
         boolean success = false;
         try {
+            if (writeDanglingIndices && nodeWriteDanglingIndicesInfo) {
+                indexService.addMetaDataListener(imd -> updateDanglingIndicesInfo(index));
+            }
             indexService.getIndexEventListener().afterIndexCreated(indexService);
             indices = Maps.copyMapWithAddedEntry(indices, index.getUUID(), indexService);
+            if (writeDanglingIndices) {
+                if (nodeWriteDanglingIndicesInfo) {
+                    updateDanglingIndicesInfo(index);
+                } else {
+                    indexService.deleteDanglingIndicesInfo();
+                }
+            }
             success = true;
             return indexService;
         } finally {
@@ -761,7 +804,7 @@ public void deleteUnassignedIndex(String reason, IndexMetaData metaData, Cluster
                     throw new IllegalStateException("Can't delete unassigned index store for [" + indexName + "] - it's still part of " +
                                                     "the cluster state [" + index.getIndexUUID() + "] [" + metaData.getIndexUUID() + "]");
                 }
-                deleteIndexStore(reason, metaData, clusterState);
+                deleteIndexStore(reason, metaData);
             } catch (Exception e) {
                 logger.warn(() -> new ParameterizedMessage("[{}] failed to delete unassigned index (reason [{}])",
                     metaData.getIndex(), reason), e);
@@ -775,7 +818,7 @@ public void deleteUnassignedIndex(String reason, IndexMetaData metaData, Cluster
      *
      * Package private for testing
      */
-    void deleteIndexStore(String reason, IndexMetaData metaData, ClusterState clusterState) throws IOException {
+    void deleteIndexStore(String reason, IndexMetaData metaData) throws IOException {
         if (nodeEnv.hasNodeFile()) {
             synchronized (this) {
                 Index index = metaData.getIndex();
@@ -784,15 +827,6 @@ void deleteIndexStore(String reason, IndexMetaData metaData, ClusterState cluste
                     throw new IllegalStateException("Can't delete index store for [" + index.getName() +
                         "] - it's still part of the indices service [" + localUUid + "] [" + metaData.getIndexUUID() + "]");
                 }
-
-                if (clusterState.metaData().hasIndex(index.getName()) && (clusterState.nodes().getLocalNode().isMasterNode() == true)) {
-                    // we do not delete the store if it is a master eligible node and the index is still in the cluster state
-                    // because we want to keep the meta data for indices around even if no shards are left here
-                    final IndexMetaData idxMeta = clusterState.metaData().index(index.getName());
-                    throw new IllegalStateException("Can't delete index store for [" + index.getName() + "] - it's still part of the " +
-                                                    "cluster state [" + idxMeta.getIndexUUID() + "] [" + metaData.getIndexUUID() + "], " +
-                                                    "we are master eligible, so will keep the index metadata even if no shards are left.");
-                }
             }
             final IndexSettings indexSettings = buildIndexSettings(metaData);
             deleteIndexStore(reason, indexSettings.getIndex(), indexSettings);
@@ -870,13 +904,11 @@ public void deleteShardStore(String reason, ShardId shardId, ClusterState cluste
         nodeEnv.deleteShardDirectorySafe(shardId, indexSettings);
         logger.debug("{} deleted shard reason [{}]", shardId, reason);
 
-        // master nodes keep the index meta data, even if having no shards..
-        if (clusterState.nodes().getLocalNode().isMasterNode() == false &&
-                canDeleteIndexContents(shardId.getIndex(), indexSettings)) {
+        if (canDeleteIndexContents(shardId.getIndex(), indexSettings)) {
             if (nodeEnv.findAllShardIds(shardId.getIndex()).isEmpty()) {
                 try {
                     // note that deleteIndexStore have more safety checks and may throw an exception if index was concurrently created.
-                    deleteIndexStore("no longer used", metaData, clusterState);
+                    deleteIndexStore("no longer used", metaData);
                 } catch (Exception e) {
                     // wrap the exception to indicate we already deleted the shard
                     throw new ElasticsearchException("failed to delete unused index after deleting its last shard (" + shardId + ")", e);
@@ -1498,4 +1530,51 @@ public static Optional<String> checkShardLimit(int newShards, ClusterState state
         }
         return Optional.empty();
     }
+
+    private void updateDanglingIndicesInfo(Index index) {
+        assert DiscoveryNode.isDataNode(settings) : "dangling indices information should only be persisted on data nodes";
+        assert nodeWriteDanglingIndicesInfo : "writing dangling indices info is not enabled";
+        assert danglingIndicesThreadPoolExecutor != null : "executor for dangling indices info is not available";
+        if (danglingIndicesToWrite.add(index)) {
+            logger.trace("triggered dangling indices update for {}", index);
+            final long triggeredTimeMillis = threadPool.relativeTimeInMillis();
+            try {
+                danglingIndicesThreadPoolExecutor.execute(new AbstractRunnable() {
+                    @Override
+                    public void onFailure(Exception e) {
+                        logger.warn(() -> new ParameterizedMessage("failed to write dangling indices state for index {}", index), e);
+                    }
+
+                    @Override
+                    protected void doRun() {
+                        final boolean exists = danglingIndicesToWrite.remove(index);
+                        assert exists : "removed non-existing item for " + index;
+                        final IndexService indexService = indices.get(index.getUUID());
+                        if (indexService != null) {
+                            final long executedTimeMillis = threadPool.relativeTimeInMillis();
+                            logger.trace("writing out dangling indices state for index {}, triggered {} ago", index,
+                                TimeValue.timeValueMillis(Math.min(0L, executedTimeMillis - triggeredTimeMillis)));
+                            indexService.writeDanglingIndicesInfo();
+                            final long completedTimeMillis = threadPool.relativeTimeInMillis();
+                            logger.trace("writing out of dangling indices state for index {} completed after {}", index,
+                                TimeValue.timeValueMillis(Math.min(0L, completedTimeMillis - executedTimeMillis)));
+                        } else {
+                            logger.trace("omit writing dangling indices state for index {} as index is deallocated on this node", index);
+                        }
+                    }
+                });
+            } catch (EsRejectedExecutionException e) {
+                // ignore cases where we are shutting down..., there is really nothing interesting to be done here...
+                assert danglingIndicesThreadPoolExecutor.isShutdown();
+            }
+        } else {
+            logger.trace("dangling indices update already pending for {}", index);
+        }
+    }
+
+    // visible for testing
+    public boolean allPendingDanglingIndicesWritten() {
+        return nodeWriteDanglingIndicesInfo == false ||
+            (danglingIndicesToWrite.isEmpty() && danglingIndicesThreadPoolExecutor.getActiveCount() == 0);
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java b/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
index 23c8c26230c87..e7e6d954aa1c4 100644
--- a/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
+++ b/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
@@ -499,7 +499,7 @@ private void createIndices(final ClusterState state) {
 
             AllocatedIndex<? extends Shard> indexService = null;
             try {
-                indexService = indicesService.createIndex(indexMetaData, buildInIndexListener);
+                indexService = indicesService.createIndex(indexMetaData, buildInIndexListener, true);
                 if (indexService.updateMapping(null, indexMetaData) && sendRefreshMapping) {
                     nodeMappingRefreshAction.nodeMappingRefresh(state.nodes().getMasterNode(),
                         new NodeMappingRefreshAction.NodeMappingRefreshRequest(indexMetaData.getIndex().getName(),
@@ -863,10 +863,12 @@ public interface AllocatedIndices<T extends Shard, U extends AllocatedIndex<T>>
          * @param indexMetaData          the index metadata to create the index for
          * @param builtInIndexListener   a list of built-in lifecycle {@link IndexEventListener} that should should be used along side with
          *                               the per-index listeners
+         * @param writeDanglingIndices   whether dangling indices information should be written
          * @throws ResourceAlreadyExistsException if the index already exists.
          */
         U createIndex(IndexMetaData indexMetaData,
-                      List<IndexEventListener> builtInIndexListener) throws IOException;
+                      List<IndexEventListener> builtInIndexListener,
+                      boolean writeDanglingIndices) throws IOException;
 
         /**
          * Verify that the contents on disk for the given index is deleted; if not, delete the contents.
diff --git a/server/src/main/java/org/elasticsearch/node/Node.java b/server/src/main/java/org/elasticsearch/node/Node.java
index 347e8a8c79389..64041e85d897a 100644
--- a/server/src/main/java/org/elasticsearch/node/Node.java
+++ b/server/src/main/java/org/elasticsearch/node/Node.java
@@ -23,9 +23,11 @@
 import org.apache.logging.log4j.Logger;
 import org.apache.lucene.util.Constants;
 import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.Assertions;
 import org.elasticsearch.Build;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ElasticsearchTimeoutException;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionModule;
 import org.elasticsearch.action.ActionType;
 import org.elasticsearch.action.search.SearchExecutionStatsCollector;
@@ -89,10 +91,12 @@
 import org.elasticsearch.discovery.DiscoveryModule;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
+import org.elasticsearch.env.NodeMetaData;
 import org.elasticsearch.gateway.GatewayAllocator;
 import org.elasticsearch.gateway.GatewayMetaState;
 import org.elasticsearch.gateway.GatewayModule;
 import org.elasticsearch.gateway.GatewayService;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.gateway.MetaStateService;
 import org.elasticsearch.http.HttpServerTransport;
 import org.elasticsearch.index.IndexSettings;
@@ -405,6 +409,8 @@ protected Node(
                 ClusterModule.getNamedXWriteables().stream())
                 .flatMap(Function.identity()).collect(toList()));
             final MetaStateService metaStateService = new MetaStateService(nodeEnvironment, xContentRegistry);
+            final PersistedClusterStateService lucenePersistedStateFactory
+                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry, bigArrays);
 
             // collect engine factory providers from server and from plugins
             final Collection<EnginePlugin> enginePlugins = pluginsService.filterPlugins(EnginePlugin.class);
@@ -542,6 +548,7 @@ protected Node(
                     b.bind(NamedWriteableRegistry.class).toInstance(namedWriteableRegistry);
                     b.bind(MetaDataUpgrader.class).toInstance(metaDataUpgrader);
                     b.bind(MetaStateService.class).toInstance(metaStateService);
+                    b.bind(PersistedClusterStateService.class).toInstance(lucenePersistedStateFactory);
                     b.bind(IndicesService.class).toInstance(indicesService);
                     b.bind(AliasValidator.class).toInstance(aliasValidator);
                     b.bind(MetaDataCreateIndexService.class).toInstance(metaDataCreateIndexService);
@@ -688,7 +695,20 @@ public Node start() throws NodeValidationException {
         // Load (and maybe upgrade) the metadata stored on disk
         final GatewayMetaState gatewayMetaState = injector.getInstance(GatewayMetaState.class);
         gatewayMetaState.start(settings(), transportService, clusterService, injector.getInstance(MetaStateService.class),
-            injector.getInstance(MetaDataIndexUpgradeService.class), injector.getInstance(MetaDataUpgrader.class));
+            injector.getInstance(MetaDataIndexUpgradeService.class), injector.getInstance(MetaDataUpgrader.class),
+            injector.getInstance(PersistedClusterStateService.class));
+        if (Assertions.ENABLED) {
+            try {
+                assert injector.getInstance(MetaStateService.class).loadFullState().v1().isEmpty();
+                final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, NamedXContentRegistry.EMPTY,
+                    nodeEnvironment.nodeDataPaths());
+                assert nodeMetaData != null;
+                assert nodeMetaData.nodeVersion().equals(Version.CURRENT);
+                assert nodeMetaData.nodeId().equals(localNodeFactory.getNode().getId());
+            } catch (IOException e) {
+                assert false : e;
+            }
+        }
         // we load the global state here (the persistent part of the cluster state stored on disk) to
         // pass it to the bootstrap checks to allow plugins to enforce certain preconditions based on the recovered state.
         final MetaData onDiskMetadata = gatewayMetaState.getPersistedState().getLastAcceptedState().metaData();
@@ -860,8 +880,11 @@ public synchronized void close() throws IOException {
         // Don't call shutdownNow here, it might break ongoing operations on Lucene indices.
         // See https://issues.apache.org/jira/browse/LUCENE-7248. We call shutdownNow in
         // awaitClose if the node doesn't finish closing within the specified time.
-        toClose.add(() -> stopWatch.stop().start("node_environment"));
 
+        toClose.add(() -> stopWatch.stop().start("gateway_meta_state"));
+        toClose.add(injector.getInstance(GatewayMetaState.class));
+
+        toClose.add(() -> stopWatch.stop().start("node_environment"));
         toClose.add(injector.getInstance(NodeEnvironment.class));
         toClose.add(stopWatch::stop);
 
diff --git a/server/src/test/java/org/elasticsearch/cluster/coordination/CoordinatorTests.java b/server/src/test/java/org/elasticsearch/cluster/coordination/CoordinatorTests.java
index e4560d0613ccd..3004dc99ac360 100644
--- a/server/src/test/java/org/elasticsearch/cluster/coordination/CoordinatorTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/coordination/CoordinatorTests.java
@@ -991,17 +991,18 @@ public void testCannotJoinClusterWithDifferentUUID() throws IllegalAccessExcepti
             cluster1.runRandomly();
             cluster1.stabilise();
 
-            final ClusterNode newNode;
+            final ClusterNode nodeInOtherCluster;
             try (Cluster cluster2 = new Cluster(3)) {
                 cluster2.runRandomly();
                 cluster2.stabilise();
 
-                final ClusterNode nodeInOtherCluster = randomFrom(cluster2.clusterNodes);
-                newNode = cluster1.new ClusterNode(nextNodeIndex.getAndIncrement(),
-                    nodeInOtherCluster.getLocalNode(), n -> cluster1.new MockPersistedState(n, nodeInOtherCluster.persistedState,
-                    Function.identity(), Function.identity()), nodeInOtherCluster.nodeSettings);
+                nodeInOtherCluster = randomFrom(cluster2.clusterNodes);
             }
 
+            final ClusterNode newNode = cluster1.new ClusterNode(nextNodeIndex.getAndIncrement(),
+                nodeInOtherCluster.getLocalNode(), n -> cluster1.new MockPersistedState(n, nodeInOtherCluster.persistedState,
+                Function.identity(), Function.identity()), nodeInOtherCluster.nodeSettings);
+
             cluster1.clusterNodes.add(newNode);
 
             MockLogAppender mockAppender = new MockLogAppender();
diff --git a/server/src/test/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommandIT.java b/server/src/test/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommandIT.java
new file mode 100644
index 0000000000000..b3f37a9b17a7a
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommandIT.java
@@ -0,0 +1,135 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.cluster.coordination;
+
+import joptsimple.OptionSet;
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.cli.MockTerminal;
+import org.elasticsearch.cli.UserException;
+import org.elasticsearch.cluster.routing.allocation.DiskThresholdSettings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.env.TestEnvironment;
+import org.elasticsearch.test.ESIntegTestCase;
+
+import static org.hamcrest.Matchers.contains;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.not;
+
+@ESIntegTestCase.ClusterScope(scope = ESIntegTestCase.Scope.TEST, numDataNodes = 0, autoManageMasterNodes = false)
+public class RemoveSettingsCommandIT extends ESIntegTestCase {
+
+    public void testRemoveSettingsAbortedByUser() throws Exception {
+        internalCluster().setBootstrapMasterNodeIndex(0);
+        String node = internalCluster().startNode();
+        client().admin().cluster().prepareUpdateSettings().setPersistentSettings(Settings.builder()
+            .put(DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey(), false).build()).get();
+        Settings dataPathSettings = internalCluster().dataPathSettings(node);
+        ensureStableCluster(1);
+        internalCluster().stopRandomDataNode();
+
+        Environment environment = TestEnvironment.newEnvironment(
+            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
+        expectThrows(() -> removeSettings(environment, true,
+            new String[]{ DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey() }),
+            ElasticsearchNodeCommand.ABORTED_BY_USER_MSG);
+    }
+
+    public void testRemoveSettingsSuccessful() throws Exception {
+        internalCluster().setBootstrapMasterNodeIndex(0);
+        String node = internalCluster().startNode();
+        client().admin().cluster().prepareUpdateSettings().setPersistentSettings(Settings.builder()
+            .put(DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey(), false).build()).get();
+        assertThat(client().admin().cluster().prepareState().get().getState().metaData().persistentSettings().keySet(),
+            contains(DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey()));
+        Settings dataPathSettings = internalCluster().dataPathSettings(node);
+        ensureStableCluster(1);
+        internalCluster().stopRandomDataNode();
+
+        Environment environment = TestEnvironment.newEnvironment(
+            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
+        MockTerminal terminal = removeSettings(environment, false,
+            randomBoolean() ?
+                new String[]{ DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey() } :
+                new String[]{ "cluster.routing.allocation.disk.*" }
+            );
+        assertThat(terminal.getOutput(), containsString(RemoveSettingsCommand.SETTINGS_REMOVED_MSG));
+        assertThat(terminal.getOutput(), containsString("The following settings will be removed:"));
+        assertThat(terminal.getOutput(), containsString(
+            DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey() + ": "  + false));
+
+        internalCluster().startNode(dataPathSettings);
+        assertThat(client().admin().cluster().prepareState().get().getState().metaData().persistentSettings().keySet(),
+            not(contains(DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey())));
+    }
+
+    public void testSettingDoesNotMatch() throws Exception {
+        internalCluster().setBootstrapMasterNodeIndex(0);
+        String node = internalCluster().startNode();
+        client().admin().cluster().prepareUpdateSettings().setPersistentSettings(Settings.builder()
+            .put(DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey(), false).build()).get();
+        assertThat(client().admin().cluster().prepareState().get().getState().metaData().persistentSettings().keySet(),
+            contains(DiskThresholdSettings.CLUSTER_ROUTING_ALLOCATION_DISK_THRESHOLD_ENABLED_SETTING.getKey()));
+        Settings dataPathSettings = internalCluster().dataPathSettings(node);
+        ensureStableCluster(1);
+        internalCluster().stopRandomDataNode();
+
+        Environment environment = TestEnvironment.newEnvironment(
+            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
+        UserException ex = expectThrows(UserException.class, () -> removeSettings(environment, false,
+            new String[]{ "cluster.routing.allocation.disk.bla.*" }));
+        assertThat(ex.getMessage(), containsString("No persistent cluster settings matching [cluster.routing.allocation.disk.bla.*] were " +
+            "found on this node"));
+    }
+
+    private MockTerminal executeCommand(ElasticsearchNodeCommand command, Environment environment, boolean abort, String... args)
+        throws Exception {
+        final MockTerminal terminal = new MockTerminal();
+        final OptionSet options = command.getParser().parse(args);
+        final String input;
+
+        if (abort) {
+            input = randomValueOtherThanMany(c -> c.equalsIgnoreCase("y"), () -> randomAlphaOfLength(1));
+        } else {
+            input = randomBoolean() ? "y" : "Y";
+        }
+
+        terminal.addTextInput(input);
+
+        try {
+            command.execute(terminal, options, environment);
+        } finally {
+            assertThat(terminal.getOutput(), containsString(ElasticsearchNodeCommand.STOP_WARNING_MSG));
+        }
+
+        return terminal;
+    }
+
+    private MockTerminal removeSettings(Environment environment, boolean abort, String... args) throws Exception {
+        final MockTerminal terminal = executeCommand(new RemoveSettingsCommand(), environment, abort, args);
+        assertThat(terminal.getOutput(), containsString(RemoveSettingsCommand.CONFIRMATION_MSG));
+        assertThat(terminal.getOutput(), containsString(RemoveSettingsCommand.SETTINGS_REMOVED_MSG));
+        return terminal;
+    }
+
+    private void expectThrows(ThrowingRunnable runnable, String message) {
+        ElasticsearchException ex = expectThrows(ElasticsearchException.class, runnable);
+        assertThat(ex.getMessage(), containsString(message));
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapAndDetachCommandIT.java b/server/src/test/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapAndDetachCommandIT.java
index 55fc91b943640..807da1e77cb99 100644
--- a/server/src/test/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapAndDetachCommandIT.java
+++ b/server/src/test/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapAndDetachCommandIT.java
@@ -22,23 +22,20 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.cli.MockTerminal;
-import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.cluster.ClusterModule;
 import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.metadata.Manifest;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
-import org.elasticsearch.env.NodeMetaData;
 import org.elasticsearch.env.TestEnvironment;
+import org.elasticsearch.gateway.GatewayMetaState;
+import org.elasticsearch.gateway.PersistedClusterStateService;
+import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.node.Node;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.InternalTestCluster;
 
 import java.io.IOException;
-import java.nio.file.Path;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Locale;
@@ -49,7 +46,6 @@
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertHitCount;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.greaterThan;
 
 @ESIntegTestCase.ClusterScope(scope = ESIntegTestCase.Scope.TEST, numDataNodes = 0, autoManageMasterNodes = false)
 public class UnsafeBootstrapAndDetachCommandIT extends ESIntegTestCase {
@@ -138,44 +134,20 @@ public void testDetachNodeLocked() throws IOException {
         }
     }
 
-    public void testBootstrapNoNodeMetaData() throws IOException {
+    public void testBootstrapNoNodeMetaData() {
         Settings envSettings = buildEnvSettings(Settings.EMPTY);
         Environment environment = TestEnvironment.newEnvironment(envSettings);
-        try (NodeEnvironment nodeEnvironment = new NodeEnvironment(envSettings, environment)) {
-            NodeMetaData.FORMAT.cleanupOldFiles(-1, nodeEnvironment.nodeDataPaths());
-        }
-
-        expectThrows(() -> unsafeBootstrap(environment), UnsafeBootstrapMasterCommand.NO_NODE_METADATA_FOUND_MSG);
+        expectThrows(() -> unsafeBootstrap(environment), ElasticsearchNodeCommand.NO_NODE_METADATA_FOUND_MSG);
     }
 
     public void testBootstrapNotBootstrappedCluster() throws Exception {
         String node = internalCluster().startNode(
-                Settings.builder()
-                        .put(Node.INITIAL_STATE_TIMEOUT_SETTING.getKey(), "0s") // to ensure quick node startup
-                        .build());
-        assertBusy(() -> {
-            ClusterState state = client().admin().cluster().prepareState().setLocal(true)
-                    .execute().actionGet().getState();
-            assertTrue(state.blocks().hasGlobalBlockWithId(NoMasterBlockService.NO_MASTER_BLOCK_ID));
-        });
-
-        Settings dataPathSettings = internalCluster().dataPathSettings(node);
-
-        internalCluster().stopRandomDataNode();
-
-        Environment environment = TestEnvironment.newEnvironment(
-            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
-        expectThrows(() -> unsafeBootstrap(environment), ElasticsearchNodeCommand.GLOBAL_GENERATION_MISSING_MSG);
-    }
-
-    public void testDetachNotBootstrappedCluster() throws Exception {
-        String node = internalCluster().startNode(
-                Settings.builder()
-                        .put(Node.INITIAL_STATE_TIMEOUT_SETTING.getKey(), "0s") // to ensure quick node startup
-                        .build());
+            Settings.builder()
+                .put(Node.INITIAL_STATE_TIMEOUT_SETTING.getKey(), "0s") // to ensure quick node startup
+                .build());
         assertBusy(() -> {
             ClusterState state = client().admin().cluster().prepareState().setLocal(true)
-                    .execute().actionGet().getState();
+                .execute().actionGet().getState();
             assertTrue(state.blocks().hasGlobalBlockWithId(NoMasterBlockService.NO_MASTER_BLOCK_ID));
         });
 
@@ -185,65 +157,35 @@ public void testDetachNotBootstrappedCluster() throws Exception {
 
         Environment environment = TestEnvironment.newEnvironment(
             Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
-        expectThrows(() -> detachCluster(environment), ElasticsearchNodeCommand.GLOBAL_GENERATION_MISSING_MSG);
-    }
-
-    public void testBootstrapNoManifestFile() throws IOException {
-        internalCluster().setBootstrapMasterNodeIndex(0);
-        String node = internalCluster().startNode();
-        Settings dataPathSettings = internalCluster().dataPathSettings(node);
-        ensureStableCluster(1);
-        NodeEnvironment nodeEnvironment = internalCluster().getMasterNodeInstance(NodeEnvironment.class);
-        internalCluster().stopRandomDataNode();
-        Environment environment = TestEnvironment.newEnvironment(
-            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
-        Manifest.FORMAT.cleanupOldFiles(-1, nodeEnvironment.nodeDataPaths());
-
-        expectThrows(() -> unsafeBootstrap(environment), ElasticsearchNodeCommand.NO_MANIFEST_FILE_FOUND_MSG);
-    }
-
-    public void testDetachNoManifestFile() throws IOException {
-        internalCluster().setBootstrapMasterNodeIndex(0);
-        String node = internalCluster().startNode();
-        Settings dataPathSettings = internalCluster().dataPathSettings(node);
-        ensureStableCluster(1);
-        NodeEnvironment nodeEnvironment = internalCluster().getMasterNodeInstance(NodeEnvironment.class);
-        internalCluster().stopRandomDataNode();
-        Environment environment = TestEnvironment.newEnvironment(
-            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
-        Manifest.FORMAT.cleanupOldFiles(-1, nodeEnvironment.nodeDataPaths());
-
-        expectThrows(() -> detachCluster(environment), ElasticsearchNodeCommand.NO_MANIFEST_FILE_FOUND_MSG);
+        expectThrows(() -> unsafeBootstrap(environment), UnsafeBootstrapMasterCommand.EMPTY_LAST_COMMITTED_VOTING_CONFIG_MSG);
     }
 
-    public void testBootstrapNoMetaData() throws IOException {
+    public void testBootstrapNoClusterState() throws IOException {
         internalCluster().setBootstrapMasterNodeIndex(0);
         String node = internalCluster().startNode();
         Settings dataPathSettings = internalCluster().dataPathSettings(node);
         ensureStableCluster(1);
         NodeEnvironment nodeEnvironment = internalCluster().getMasterNodeInstance(NodeEnvironment.class);
         internalCluster().stopRandomDataNode();
-
         Environment environment = TestEnvironment.newEnvironment(
             Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
-        MetaData.FORMAT.cleanupOldFiles(-1, nodeEnvironment.nodeDataPaths());
+        PersistedClusterStateService.deleteAll(nodeEnvironment.nodeDataPaths());
 
-        expectThrows(() -> unsafeBootstrap(environment), ElasticsearchNodeCommand.NO_GLOBAL_METADATA_MSG);
+        expectThrows(() -> unsafeBootstrap(environment), ElasticsearchNodeCommand.NO_NODE_METADATA_FOUND_MSG);
     }
 
-    public void testDetachNoMetaData() throws IOException {
+    public void testDetachNoClusterState() throws IOException {
         internalCluster().setBootstrapMasterNodeIndex(0);
         String node = internalCluster().startNode();
         Settings dataPathSettings = internalCluster().dataPathSettings(node);
         ensureStableCluster(1);
         NodeEnvironment nodeEnvironment = internalCluster().getMasterNodeInstance(NodeEnvironment.class);
         internalCluster().stopRandomDataNode();
-
         Environment environment = TestEnvironment.newEnvironment(
             Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
-        MetaData.FORMAT.cleanupOldFiles(-1, nodeEnvironment.nodeDataPaths());
+        PersistedClusterStateService.deleteAll(nodeEnvironment.nodeDataPaths());
 
-        expectThrows(() -> detachCluster(environment), ElasticsearchNodeCommand.NO_GLOBAL_METADATA_MSG);
+        expectThrows(() -> detachCluster(environment), ElasticsearchNodeCommand.NO_NODE_METADATA_FOUND_MSG);
     }
 
     public void testBootstrapAbortedByUser() throws IOException {
@@ -318,14 +260,16 @@ public void test3MasterNodes2Failed() throws Exception {
         logger.info("--> stop 1st master-eligible node and data-only node");
         NodeEnvironment nodeEnvironment = internalCluster().getMasterNodeInstance(NodeEnvironment.class);
         internalCluster().stopRandomNode(InternalTestCluster.nameFilter(masterNodes.get(0)));
+        assertBusy(() -> internalCluster().getInstance(GatewayMetaState.class, dataNode).allPendingAsyncStatesWritten());
         internalCluster().stopRandomDataNode();
 
         logger.info("--> unsafely-bootstrap 1st master-eligible node");
         MockTerminal terminal = unsafeBootstrap(environmentMaster1);
-        MetaData metaData = MetaData.FORMAT.loadLatestState(logger, xContentRegistry(), nodeEnvironment.nodeDataPaths());
+        MetaData metaData = ElasticsearchNodeCommand.createPersistedClusterStateService(nodeEnvironment.nodeDataPaths())
+            .loadBestOnDiskState().metaData;
         assertThat(terminal.getOutput(), containsString(
-                String.format(Locale.ROOT, UnsafeBootstrapMasterCommand.CLUSTER_STATE_TERM_VERSION_MSG_FORMAT,
-                        metaData.coordinationMetaData().term(), metaData.version())));
+            String.format(Locale.ROOT, UnsafeBootstrapMasterCommand.CLUSTER_STATE_TERM_VERSION_MSG_FORMAT,
+                metaData.coordinationMetaData().term(), metaData.version())));
 
         logger.info("--> start 1st master-eligible node");
         internalCluster().startMasterOnlyNode(master1DataPathSettings);
@@ -376,6 +320,8 @@ public void testAllMasterEligibleNodesFailedDanglingIndexImport() throws Excepti
         logger.info("--> index 1 doc and ensure index is green");
         client().prepareIndex("test").setId("1").setSource("field1", "value1").setRefreshPolicy(IMMEDIATE).get();
         ensureGreen("test");
+        assertBusy(() -> internalCluster().getInstances(IndicesService.class).forEach(
+            indicesService -> assertTrue(indicesService.allPendingDanglingIndicesWritten())));
 
         logger.info("--> verify 1 doc in the index");
         assertHitCount(client().prepareSearch().setQuery(matchAllQuery()).get(), 1L);
@@ -383,6 +329,7 @@ public void testAllMasterEligibleNodesFailedDanglingIndexImport() throws Excepti
 
         logger.info("--> stop data-only node and detach it from the old cluster");
         Settings dataNodeDataPathSettings = internalCluster().dataPathSettings(dataNode);
+        assertBusy(() -> internalCluster().getInstance(GatewayMetaState.class, dataNode).allPendingAsyncStatesWritten());
         internalCluster().stopRandomNode(InternalTestCluster.nameFilter(dataNode));
         final Environment environment = TestEnvironment.newEnvironment(
             Settings.builder().put(internalCluster().getDefaultSettings()).put(dataNodeDataPathSettings).build());
@@ -459,65 +406,4 @@ public void testCanRunUnsafeBootstrapAfterErroneousDetachWithoutLoosingMetaData(
         assertThat(state.metaData().settings().get(INDICES_RECOVERY_MAX_BYTES_PER_SEC_SETTING.getKey()),
                 equalTo("1234kb"));
     }
-
-    private static class SimulatedDeleteFailureException extends RuntimeException {
-    }
-
-    public void testCleanupOldMetaDataFails() throws Exception {
-        // establish some metadata.
-        internalCluster().setBootstrapMasterNodeIndex(0);
-        String node = internalCluster().startNode();
-        Settings dataPathSettings = internalCluster().dataPathSettings(node);
-        final Environment environment = TestEnvironment.newEnvironment(
-            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
-        internalCluster().stopRandomDataNode();
-
-        // find data paths
-        Path[] dataPaths;
-        try (NodeEnvironment nodeEnvironment = new NodeEnvironment(environment.settings(), environment)) {
-            dataPaths = nodeEnvironment.nodeDataPaths();
-        }
-
-        NamedXContentRegistry namedXContentRegistry = new NamedXContentRegistry(ClusterModule.getNamedXWriteables());
-
-        final Manifest originalManifest = loadLatestManifest(dataPaths, namedXContentRegistry);
-        final MetaData originalMetaData = loadMetaData(dataPaths, namedXContentRegistry, originalManifest);
-
-        executeCommand(new UnsafeBootstrapMasterCommand() {
-            @Override
-            protected void cleanUpOldMetaData(Terminal terminal, Path[] dataPaths, long newGeneration) {
-                throw new SimulatedDeleteFailureException();
-            }
-        }, environment, false);
-
-
-        // check original meta-data left untouched.
-        assertEquals(loadMetaData(dataPaths, namedXContentRegistry, originalManifest).clusterUUID(), originalMetaData.clusterUUID());
-
-        // check that we got new clusterUUID despite deletion failing
-        final Manifest secondManifest = loadLatestManifest(dataPaths, namedXContentRegistry);
-        final MetaData secondMetaData = loadMetaData(dataPaths, namedXContentRegistry, secondManifest);
-        assertThat(secondManifest.getGlobalGeneration(), greaterThan(originalManifest.getGlobalGeneration()));
-        assertNotEquals(originalMetaData.clusterUUID(), secondMetaData.clusterUUID());
-
-        // check that a new run will cleanup.
-        executeCommand(new UnsafeBootstrapMasterCommand(), environment, false);
-
-        assertNull(loadMetaData(dataPaths, namedXContentRegistry, originalManifest));
-        assertNull(loadMetaData(dataPaths, namedXContentRegistry, secondManifest));
-
-        final Manifest finalManifest = loadLatestManifest(dataPaths, namedXContentRegistry);
-        final MetaData finalMetaData = loadMetaData(dataPaths, namedXContentRegistry, finalManifest);
-
-        assertNotNull(finalMetaData);
-        assertNotEquals(secondMetaData.clusterUUID(), finalMetaData.clusterUUID());
-    }
-
-    private Manifest loadLatestManifest(Path[] dataPaths, NamedXContentRegistry namedXContentRegistry) throws IOException {
-        return Manifest.FORMAT.loadLatestState(logger, namedXContentRegistry, dataPaths);
-    }
-
-    private MetaData loadMetaData(Path[] dataPaths, NamedXContentRegistry namedXContentRegistry, Manifest manifest) {
-        return MetaData.FORMAT.loadGeneration(logger, namedXContentRegistry, manifest.getGlobalGeneration(), dataPaths);
-    }
 }
diff --git a/server/src/test/java/org/elasticsearch/env/NodeEnvironmentIT.java b/server/src/test/java/org/elasticsearch/env/NodeEnvironmentIT.java
index 85d2f7e654f1f..40ef3a48c048f 100644
--- a/server/src/test/java/org/elasticsearch/env/NodeEnvironmentIT.java
+++ b/server/src/test/java/org/elasticsearch/env/NodeEnvironmentIT.java
@@ -24,6 +24,8 @@
 import org.elasticsearch.common.io.PathUtils;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.gateway.PersistedClusterStateService;
+import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.node.Node;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.InternalTestCluster;
@@ -47,11 +49,13 @@
 
 @ESIntegTestCase.ClusterScope(scope = ESIntegTestCase.Scope.TEST, numDataNodes = 0)
 public class NodeEnvironmentIT extends ESIntegTestCase {
-    public void testStartFailureOnDataForNonDataNode() {
+    public void testStartFailureOnDataForNonDataNode() throws Exception {
         final String indexName = "test-fail-on-data";
 
         logger.info("--> starting one node");
-        String node = internalCluster().startNode();
+        final boolean writeDanglingIndices = randomBoolean();
+        String node = internalCluster().startNode(Settings.builder()
+            .put(IndicesService.WRITE_DANGLING_INDICES_INFO_SETTING.getKey(), writeDanglingIndices).build());
         Settings dataPathSettings = internalCluster().dataPathSettings(node);
 
         logger.info("--> creating index");
@@ -60,6 +64,10 @@ public void testStartFailureOnDataForNonDataNode() {
             .put("index.number_of_replicas", 0)
         ).get();
         final String indexUUID = resolveIndex(indexName).getUUID();
+        if (writeDanglingIndices) {
+            assertBusy(() -> internalCluster().getInstances(IndicesService.class).forEach(
+                indicesService -> assertTrue(indicesService.allPendingDanglingIndicesWritten())));
+        }
 
         logger.info("--> restarting the node with node.data=false and node.master=false");
         IllegalStateException ex = expectThrows(IllegalStateException.class,
@@ -74,13 +82,19 @@ public Settings onNodeStopped(String nodeName) {
                             .build();
                     }
                 }));
-        assertThat(ex.getMessage(), containsString(indexUUID));
-        assertThat(ex.getMessage(),
-            startsWith("Node is started with "
-                + Node.NODE_DATA_SETTING.getKey()
-                + "=false and "
-                + Node.NODE_MASTER_SETTING.getKey()
-                + "=false, but has index metadata"));
+        if (writeDanglingIndices) {
+            assertThat(ex.getMessage(),
+                startsWith("Node is started with "
+                    + Node.NODE_DATA_SETTING.getKey()
+                    + "=false and "
+                    + Node.NODE_MASTER_SETTING.getKey()
+                    + "=false, but has index metadata"));
+        } else {
+            assertThat(ex.getMessage(),
+                startsWith("Node is started with "
+                    + Node.NODE_DATA_SETTING.getKey()
+                    + "=false, but has shard data"));
+        }
 
         logger.info("--> start the node again with node.data=true and node.master=true");
         internalCluster().startNode(dataPathSettings);
@@ -124,14 +138,14 @@ public Settings onNodeStopped(String nodeName) {
 
     public void testFailsToStartIfDowngraded() {
         final IllegalStateException illegalStateException = expectThrowsOnRestart(dataPaths ->
-            NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(randomAlphaOfLength(10), NodeMetaDataTests.tooNewVersion()), dataPaths));
+            PersistedClusterStateService.overrideVersion(NodeMetaDataTests.tooNewVersion(), dataPaths));
         assertThat(illegalStateException.getMessage(),
             allOf(startsWith("cannot downgrade a node from version ["), endsWith("] to version [" + Version.CURRENT + "]")));
     }
 
     public void testFailsToStartIfUpgradedTooFar() {
         final IllegalStateException illegalStateException = expectThrowsOnRestart(dataPaths ->
-            NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(randomAlphaOfLength(10), NodeMetaDataTests.tooOldVersion()), dataPaths));
+            PersistedClusterStateService.overrideVersion(NodeMetaDataTests.tooOldVersion(), dataPaths));
         assertThat(illegalStateException.getMessage(),
             allOf(startsWith("cannot upgrade a node from version ["), endsWith("] directly to version [" + Version.CURRENT + "]")));
     }
@@ -191,8 +205,10 @@ public void testUpgradeDataFolder() throws IOException, InterruptedException {
             assertThat(ise.getMessage(), containsString("unexpected folder encountered during data folder upgrade"));
             Files.delete(badFolder);
 
-            final Path conflictingFolder = randomFrom(dataPaths).resolve("indices");
-            if (Files.exists(conflictingFolder) == false) {
+            final Path randomDataPath = randomFrom(dataPaths);
+            final Path conflictingFolder = randomDataPath.resolve("indices");
+            final Path sourceFolder = randomDataPath.resolve("nodes").resolve("0").resolve("indices");
+            if (Files.exists(sourceFolder) && Files.exists(conflictingFolder) == false) {
                 Files.createDirectories(conflictingFolder);
                 ise = expectThrows(IllegalStateException.class, () -> internalCluster().startNode(dataPathSettings));
                 assertThat(ise.getMessage(), containsString("target folder already exists during data folder upgrade"));
@@ -223,10 +239,15 @@ public void testFailsToStartOnDataPathsFromMultipleNodes() throws IOException {
         internalCluster().stopRandomNode(InternalTestCluster.nameFilter(nodes.get(1)));
         internalCluster().stopRandomNode(InternalTestCluster.nameFilter(nodes.get(0)));
 
-        final IllegalStateException illegalStateException = expectThrows(IllegalStateException.class,
+        IllegalStateException illegalStateException = expectThrows(IllegalStateException.class,
+            () -> PersistedClusterStateService.nodeMetaData(allDataPaths.stream().map(PathUtils::get).toArray(Path[]::new)));
+
+        assertThat(illegalStateException.getMessage(), containsString("unexpected node ID in metadata"));
+
+        illegalStateException = expectThrows(IllegalStateException.class,
             () -> internalCluster().startNode(Settings.builder().putList(Environment.PATH_DATA_SETTING.getKey(), allDataPaths)));
 
-        assertThat(illegalStateException.getMessage(), containsString("belong to multiple nodes with IDs"));
+        assertThat(illegalStateException.getMessage(), containsString("unexpected node ID in metadata"));
 
         final List<String> node0DataPathsPlusOne = new ArrayList<>(node0DataPaths);
         node0DataPathsPlusOne.add(createTempDir().toString());
diff --git a/server/src/test/java/org/elasticsearch/env/NodeEnvironmentTests.java b/server/src/test/java/org/elasticsearch/env/NodeEnvironmentTests.java
index 19100343d2b15..e273acfafc812 100644
--- a/server/src/test/java/org/elasticsearch/env/NodeEnvironmentTests.java
+++ b/server/src/test/java/org/elasticsearch/env/NodeEnvironmentTests.java
@@ -384,7 +384,7 @@ public void testCustomDataPaths() throws Exception {
         env.close();
     }
 
-    public void testPersistentNodeId() throws IOException {
+    public void testNodeIdNotPersistedAtInitialization() throws IOException {
         NodeEnvironment env = newNodeEnvironment(new String[0], Settings.builder()
             .put("node.local_storage", false)
             .put("node.master", false)
@@ -398,7 +398,7 @@ public void testPersistentNodeId() throws IOException {
         nodeID = env.nodeId();
         env.close();
         env = newNodeEnvironment(paths, Settings.EMPTY);
-        assertThat(env.nodeId(), equalTo(nodeID));
+        assertThat(env.nodeId(), not(equalTo(nodeID)));
         env.close();
         env = newNodeEnvironment(Settings.EMPTY);
         assertThat(env.nodeId(), not(equalTo(nodeID)));
diff --git a/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandIT.java b/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandIT.java
index 7520a214f9e20..300191d3f2f3f 100644
--- a/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandIT.java
+++ b/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandIT.java
@@ -21,14 +21,13 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.NoShardAvailableActionException;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.node.Node;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.hamcrest.Matcher;
 
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.containsString;
-import static org.hamcrest.Matchers.not;
-import static org.mockito.Matchers.contains;
 
 @ESIntegTestCase.ClusterScope(scope = ESIntegTestCase.Scope.TEST, numDataNodes = 0)
 public class NodeRepurposeCommandIT extends ESIntegTestCase {
@@ -38,14 +37,14 @@ public void testRepurpose() throws Exception {
 
         logger.info("--> starting two nodes");
         final String masterNode = internalCluster().startMasterOnlyNode();
-        final String dataNode = internalCluster().startDataOnlyNode();
+        final String dataNode = internalCluster().startDataOnlyNode(
+            Settings.builder().put(IndicesService.WRITE_DANGLING_INDICES_INFO_SETTING.getKey(), false).build());
 
         logger.info("--> creating index");
         prepareCreate(indexName, Settings.builder()
             .put("index.number_of_shards", 1)
             .put("index.number_of_replicas", 0)
         ).get();
-        final String indexUUID = resolveIndex(indexName).getUUID();
 
         logger.info("--> indexing a simple document");
         client().prepareIndex(indexName).setId("1").setSource("field1", "value1").get();
@@ -82,10 +81,10 @@ public void testRepurpose() throws Exception {
         );
 
         logger.info("--> Repurposing node 1");
-        executeRepurposeCommand(noMasterNoDataSettingsForDataNode, indexUUID, 1);
+        executeRepurposeCommand(noMasterNoDataSettingsForDataNode, 1, 1);
 
         ElasticsearchException lockedException = expectThrows(ElasticsearchException.class,
-            () -> executeRepurposeCommand(noMasterNoDataSettingsForMasterNode, indexUUID, 1)
+            () -> executeRepurposeCommand(noMasterNoDataSettingsForMasterNode, 1, 1)
         );
 
         assertThat(lockedException.getMessage(), containsString(NodeRepurposeCommand.FAILED_TO_OBTAIN_NODE_LOCK_MSG));
@@ -101,7 +100,7 @@ public void testRepurpose() throws Exception {
         internalCluster().stopRandomNode(s -> true);
         internalCluster().stopRandomNode(s -> true);
 
-        executeRepurposeCommand(noMasterNoDataSettingsForMasterNode, indexUUID, 0);
+        executeRepurposeCommand(noMasterNoDataSettingsForMasterNode, 1, 0);
 
         // by restarting as master and data node, we can check that the index definition was really deleted and also that the tool
         // does not mess things up so much that the nodes cannot boot as master or data node any longer.
@@ -114,14 +113,13 @@ public void testRepurpose() throws Exception {
         assertFalse(indexExists(indexName));
     }
 
-    private void executeRepurposeCommand(Settings settings, String indexUUID, int expectedShardCount) throws Exception {
+    private void executeRepurposeCommand(Settings settings, int expectedIndexCount,
+                                         int expectedShardCount) throws Exception {
         boolean verbose = randomBoolean();
         Settings settingsWithPath = Settings.builder().put(internalCluster().getDefaultSettings()).put(settings).build();
-        int expectedIndexCount = TestEnvironment.newEnvironment(settingsWithPath).dataFiles().length;
         Matcher<String> matcher = allOf(
-            containsString(NodeRepurposeCommand.noMasterMessage(1, expectedShardCount, expectedIndexCount)),
-            not(contains(NodeRepurposeCommand.PRE_V7_MESSAGE)),
-            NodeRepurposeCommandTests.conditionalNot(containsString(indexUUID), verbose == false));
+            containsString(NodeRepurposeCommand.noMasterMessage(expectedIndexCount, expectedShardCount, 0)),
+            NodeRepurposeCommandTests.conditionalNot(containsString("test-repurpose"), verbose == false));
         NodeRepurposeCommandTests.verifySuccess(settingsWithPath, matcher,
             verbose);
     }
diff --git a/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandTests.java b/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandTests.java
index 8f713e57bf4da..c88a3f36da7a8 100644
--- a/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandTests.java
+++ b/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandTests.java
@@ -23,13 +23,16 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.cli.MockTerminal;
 import org.elasticsearch.cli.Terminal;
-import org.elasticsearch.cluster.ClusterModule;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.coordination.ElasticsearchNodeCommand;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.Manifest;
+import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.common.CheckedConsumer;
 import org.elasticsearch.common.CheckedRunnable;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.util.BigArrays;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.node.Node;
 import org.elasticsearch.test.ESTestCase;
@@ -40,16 +43,13 @@
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.Arrays;
-import java.util.Collections;
 import java.util.stream.Stream;
 
 import static org.elasticsearch.env.NodeRepurposeCommand.NO_CLEANUP;
 import static org.elasticsearch.env.NodeRepurposeCommand.NO_DATA_TO_CLEAN_UP_FOUND;
 import static org.elasticsearch.env.NodeRepurposeCommand.NO_SHARD_DATA_TO_CLEAN_UP_FOUND;
-import static org.elasticsearch.env.NodeRepurposeCommand.PRE_V7_MESSAGE;
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.containsString;
-import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.not;
 
 public class NodeRepurposeCommandTests extends ESTestCase {
@@ -68,6 +68,11 @@ public void createNodePaths() throws IOException {
         environment = TestEnvironment.newEnvironment(dataMasterSettings);
         try (NodeEnvironment nodeEnvironment = new NodeEnvironment(dataMasterSettings, environment)) {
             nodePaths = nodeEnvironment.nodeDataPaths();
+            final String nodeId = randomAlphaOfLength(10);
+            try (PersistedClusterStateService.Writer writer = new PersistedClusterStateService(nodePaths, nodeId,
+                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE, true).createWriter()) {
+                writer.writeFullStateAndCommit(1L, ClusterState.EMPTY_STATE);
+            }
         }
         dataNoMasterSettings = Settings.builder()
             .put(dataMasterSettings)
@@ -86,27 +91,32 @@ public void createNodePaths() throws IOException {
     }
 
     public void testEarlyExitNoCleanup() throws Exception {
-        createIndexDataFiles(dataMasterSettings, randomInt(10));
+        createIndexDataFiles(dataMasterSettings, randomInt(10), randomBoolean());
 
         verifyNoQuestions(dataMasterSettings, containsString(NO_CLEANUP));
         verifyNoQuestions(dataNoMasterSettings, containsString(NO_CLEANUP));
     }
 
     public void testNothingToCleanup() throws Exception {
-        verifyNoQuestions(noDataNoMasterSettings, allOf(containsString(NO_DATA_TO_CLEAN_UP_FOUND), not(containsString(PRE_V7_MESSAGE))));
-        verifyNoQuestions(noDataMasterSettings,
-            allOf(containsString(NO_SHARD_DATA_TO_CLEAN_UP_FOUND), not(containsString(PRE_V7_MESSAGE))));
-
-        createManifest(null);
+        verifyNoQuestions(noDataNoMasterSettings, containsString(NO_DATA_TO_CLEAN_UP_FOUND));
+        verifyNoQuestions(noDataMasterSettings, containsString(NO_SHARD_DATA_TO_CLEAN_UP_FOUND));
+
+        Environment environment = TestEnvironment.newEnvironment(noDataMasterSettings);
+        if (randomBoolean()) {
+            try (NodeEnvironment env = new NodeEnvironment(noDataMasterSettings, environment)) {
+                try (PersistedClusterStateService.Writer writer =
+                         ElasticsearchNodeCommand.createPersistedClusterStateService(env.nodeDataPaths()).createWriter()) {
+                    writer.writeFullStateAndCommit(1L, ClusterState.EMPTY_STATE);
+                }
+            }
+        }
 
-        verifyNoQuestions(noDataNoMasterSettings, allOf(containsString(NO_DATA_TO_CLEAN_UP_FOUND), not(containsString(PRE_V7_MESSAGE))));
-        verifyNoQuestions(noDataMasterSettings,
-            allOf(containsString(NO_SHARD_DATA_TO_CLEAN_UP_FOUND), not(containsString(PRE_V7_MESSAGE))));
+        verifyNoQuestions(noDataNoMasterSettings, containsString(NO_DATA_TO_CLEAN_UP_FOUND));
+        verifyNoQuestions(noDataMasterSettings, containsString(NO_SHARD_DATA_TO_CLEAN_UP_FOUND));
 
-        createIndexDataFiles(dataMasterSettings, 0);
+        createIndexDataFiles(dataMasterSettings, 0, randomBoolean());
 
-        verifyNoQuestions(noDataMasterSettings,
-            allOf(containsString(NO_SHARD_DATA_TO_CLEAN_UP_FOUND), not(containsString(PRE_V7_MESSAGE))));
+        verifyNoQuestions(noDataMasterSettings, containsString(NO_SHARD_DATA_TO_CLEAN_UP_FOUND));
 
     }
 
@@ -119,33 +129,20 @@ public void testLocked() throws IOException {
     }
 
     public void testCleanupAll() throws Exception {
-        Manifest oldManifest = createManifest(INDEX);
-        checkCleanupAll(not(containsString(PRE_V7_MESSAGE)));
-
-        Manifest newManifest = loadManifest();
-        assertThat(newManifest.getIndexGenerations().entrySet(), hasSize(0));
-        assertManifestIdenticalExceptIndices(oldManifest, newManifest);
-    }
-
-    public void testCleanupAllPreV7() throws Exception {
-        checkCleanupAll(containsString(PRE_V7_MESSAGE));
-    }
-
-    private void checkCleanupAll(Matcher<String> additionalOutputMatcher) throws Exception {
-        int shardCount = randomInt(10);
+        int shardCount = randomIntBetween(1, 10);
         boolean verbose = randomBoolean();
-        createIndexDataFiles(dataMasterSettings, shardCount);
+        boolean hasClusterState = randomBoolean();
+        createIndexDataFiles(dataMasterSettings, shardCount, hasClusterState);
 
         String messageText = NodeRepurposeCommand.noMasterMessage(
             1,
             environment.dataFiles().length*shardCount,
-            environment.dataFiles().length);
+            0);
 
         Matcher<String> outputMatcher = allOf(
             containsString(messageText),
-            additionalOutputMatcher,
-            conditionalNot(containsString("testUUID"), verbose == false),
-            conditionalNot(containsString("testIndex"), verbose == false)
+            conditionalNot(containsString("testIndex"), verbose == false || hasClusterState == false),
+            conditionalNot(containsString("no name for uuid: testUUID"), verbose == false || hasClusterState)
         );
 
         verifyUnchangedOnAbort(noDataNoMasterSettings, outputMatcher, verbose);
@@ -162,18 +159,17 @@ private void checkCleanupAll(Matcher<String> additionalOutputMatcher) throws Exc
     public void testCleanupShardData() throws Exception {
         int shardCount = randomIntBetween(1, 10);
         boolean verbose = randomBoolean();
-        Manifest manifest = randomBoolean() ? createManifest(INDEX) : null;
-
-        createIndexDataFiles(dataMasterSettings, shardCount);
+        boolean hasClusterState = randomBoolean();
+        createIndexDataFiles(dataMasterSettings, shardCount, hasClusterState);
 
         Matcher<String> matcher = allOf(
             containsString(NodeRepurposeCommand.shardMessage(environment.dataFiles().length * shardCount, 1)),
             conditionalNot(containsString("testUUID"), verbose == false),
-            conditionalNot(containsString("testIndex"), verbose == false)
+            conditionalNot(containsString("testIndex"), verbose == false || hasClusterState == false),
+            conditionalNot(containsString("no name for uuid: testUUID"), verbose == false || hasClusterState)
         );
 
-        verifyUnchangedOnAbort(noDataMasterSettings,
-            matcher, verbose);
+        verifyUnchangedOnAbort(noDataMasterSettings, matcher, verbose);
 
         // verify test setup
         expectThrows(IllegalStateException.class, () -> new NodeEnvironment(noDataMasterSettings, environment).close());
@@ -182,12 +178,6 @@ public void testCleanupShardData() throws Exception {
 
         //verify clean.
         new NodeEnvironment(noDataMasterSettings, environment).close();
-
-        if (manifest != null) {
-            Manifest newManifest = loadManifest();
-            assertThat(newManifest.getIndexGenerations().entrySet(), hasSize(1));
-            assertManifestIdenticalExceptIndices(manifest, newManifest);
-        }
     }
 
     static void verifySuccess(Settings settings, Matcher<String> outputMatcher, boolean verbose) throws Exception {
@@ -237,31 +227,22 @@ private static void executeRepurposeCommand(MockTerminal terminal, Settings sett
         nodeRepurposeCommand.testExecute(terminal, options, env);
     }
 
-    private Manifest createManifest(Index index) throws org.elasticsearch.gateway.WriteStateException {
-        Manifest manifest = new Manifest(randomIntBetween(1,100), randomIntBetween(1,100), randomIntBetween(1,100),
-            index != null ? Collections.singletonMap(index, randomLongBetween(1,100)) : Collections.emptyMap());
-        Manifest.FORMAT.writeAndCleanup(manifest, nodePaths);
-        return manifest;
-    }
-
-    private Manifest loadManifest() throws IOException {
-        return Manifest.FORMAT.loadLatestState(logger, new NamedXContentRegistry(ClusterModule.getNamedXWriteables()), nodePaths);
-    }
-
-    private void assertManifestIdenticalExceptIndices(Manifest oldManifest, Manifest newManifest) {
-        assertEquals(oldManifest.getGlobalGeneration(), newManifest.getGlobalGeneration());
-        assertEquals(oldManifest.getClusterStateVersion(), newManifest.getClusterStateVersion());
-        assertEquals(oldManifest.getCurrentTerm(), newManifest.getCurrentTerm());
-    }
-
-    private void createIndexDataFiles(Settings settings, int shardCount) throws IOException {
+    private void createIndexDataFiles(Settings settings, int shardCount, boolean writeClusterState) throws IOException {
         int shardDataDirNumber = randomInt(10);
-        try (NodeEnvironment env = new NodeEnvironment(settings, TestEnvironment.newEnvironment(settings))) {
-            IndexMetaData.FORMAT.write(IndexMetaData.builder(INDEX.getName())
-                .settings(Settings.builder().put("index.version.created", Version.CURRENT))
-                .numberOfShards(1)
-                .numberOfReplicas(1)
-                .build(), env.indexPaths(INDEX));
+        Environment environment = TestEnvironment.newEnvironment(settings);
+        try (NodeEnvironment env = new NodeEnvironment(settings, environment)) {
+            if (writeClusterState) {
+                try (PersistedClusterStateService.Writer writer =
+                         ElasticsearchNodeCommand.createPersistedClusterStateService(env.nodeDataPaths()).createWriter()) {
+                    writer.writeFullStateAndCommit(1L, ClusterState.builder(ClusterName.DEFAULT)
+                        .metaData(MetaData.builder().put(IndexMetaData.builder(INDEX.getName())
+                            .settings(Settings.builder().put("index.version.created", Version.CURRENT)
+                                .put(IndexMetaData.SETTING_INDEX_UUID, INDEX.getUUID()))
+                            .numberOfShards(1)
+                            .numberOfReplicas(1)).build())
+                        .build());
+                }
+            }
             for (Path path : env.indexPaths(INDEX)) {
                 for (int i = 0; i < shardCount; ++i) {
                     Files.createDirectories(path.resolve(Integer.toString(shardDataDirNumber)));
diff --git a/server/src/test/java/org/elasticsearch/env/OverrideNodeVersionCommandTests.java b/server/src/test/java/org/elasticsearch/env/OverrideNodeVersionCommandTests.java
index e7eb4c53dfec9..620a8a365ec05 100644
--- a/server/src/test/java/org/elasticsearch/env/OverrideNodeVersionCommandTests.java
+++ b/server/src/test/java/org/elasticsearch/env/OverrideNodeVersionCommandTests.java
@@ -18,23 +18,24 @@
  */
 package org.elasticsearch.env;
 
+import joptsimple.OptionParser;
+import joptsimple.OptionSet;
 import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.Version;
 import org.elasticsearch.cli.MockTerminal;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.gateway.MetaDataStateFormat;
-import org.elasticsearch.gateway.WriteStateException;
+import org.elasticsearch.common.util.BigArrays;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.test.ESTestCase;
+import org.junit.After;
 import org.junit.Before;
 
 import java.io.IOException;
 import java.nio.file.Path;
 
-import static org.elasticsearch.env.NodeMetaData.NODE_ID_KEY;
-import static org.elasticsearch.env.NodeMetaData.NODE_VERSION_KEY;
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
@@ -43,6 +44,8 @@ public class OverrideNodeVersionCommandTests extends ESTestCase {
 
     private Environment environment;
     private Path[] nodePaths;
+    private String nodeId;
+    private final OptionSet noOptions = new OptionParser().parse();
 
     @Before
     public void createNodePaths() throws IOException {
@@ -50,24 +53,38 @@ public void createNodePaths() throws IOException {
         environment = TestEnvironment.newEnvironment(settings);
         try (NodeEnvironment nodeEnvironment = new NodeEnvironment(settings, environment)) {
             nodePaths = nodeEnvironment.nodeDataPaths();
+            nodeId = nodeEnvironment.nodeId();
+
+            try (PersistedClusterStateService.Writer writer = new PersistedClusterStateService(nodePaths, nodeId,
+                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE, true).createWriter()) {
+                writer.writeFullStateAndCommit(1L, ClusterState.builder(ClusterName.DEFAULT).metaData(MetaData.builder()
+                    .persistentSettings(Settings.builder().put(MetaData.SETTING_READ_ONLY_SETTING.getKey(), true).build()).build())
+                    .build());
+            }
         }
     }
 
+    @After
+    public void checkClusterStateIntact() throws IOException {
+        assertTrue(MetaData.SETTING_READ_ONLY_SETTING.get(new PersistedClusterStateService(nodePaths, nodeId,
+            xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE, true).loadBestOnDiskState().metaData.persistentSettings()));
+    }
+
     public void testFailsOnEmptyPath() {
         final Path emptyPath = createTempDir();
         final MockTerminal mockTerminal = new MockTerminal();
         final ElasticsearchException elasticsearchException = expectThrows(ElasticsearchException.class, () ->
-            new OverrideNodeVersionCommand().processNodePaths(mockTerminal, new Path[]{emptyPath}, environment));
+            new OverrideNodeVersionCommand().processNodePaths(mockTerminal, new Path[]{emptyPath}, noOptions, environment));
         assertThat(elasticsearchException.getMessage(), equalTo(OverrideNodeVersionCommand.NO_METADATA_MESSAGE));
         expectThrows(IllegalStateException.class, () -> mockTerminal.readText(""));
     }
 
-    public void testFailsIfUnnecessary() throws WriteStateException {
+    public void testFailsIfUnnecessary() throws IOException {
         final Version nodeVersion = Version.fromId(between(Version.CURRENT.minimumIndexCompatibilityVersion().id, Version.CURRENT.id));
-        NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(randomAlphaOfLength(10), nodeVersion), nodePaths);
+        PersistedClusterStateService.overrideVersion(nodeVersion, nodePaths);
         final MockTerminal mockTerminal = new MockTerminal();
         final ElasticsearchException elasticsearchException = expectThrows(ElasticsearchException.class, () ->
-            new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, environment));
+            new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, noOptions, environment));
         assertThat(elasticsearchException.getMessage(), allOf(
             containsString("compatible with current version"),
             containsString(Version.CURRENT.toString()),
@@ -76,13 +93,12 @@ public void testFailsIfUnnecessary() throws WriteStateException {
     }
 
     public void testWarnsIfTooOld() throws Exception {
-        final String nodeId = randomAlphaOfLength(10);
         final Version nodeVersion = NodeMetaDataTests.tooOldVersion();
-        NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(nodeId, nodeVersion), nodePaths);
+        PersistedClusterStateService.overrideVersion(nodeVersion, nodePaths);
         final MockTerminal mockTerminal = new MockTerminal();
         mockTerminal.addTextInput("n\n");
         final ElasticsearchException elasticsearchException = expectThrows(ElasticsearchException.class, () ->
-            new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, environment));
+            new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, noOptions, environment));
         assertThat(elasticsearchException.getMessage(), equalTo("aborted by user"));
         assertThat(mockTerminal.getOutput(), allOf(
             containsString("too old"),
@@ -92,19 +108,17 @@ public void testWarnsIfTooOld() throws Exception {
             containsString(nodeVersion.toString())));
         expectThrows(IllegalStateException.class, () -> mockTerminal.readText(""));
 
-        final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, xContentRegistry(), nodePaths);
-        assertThat(nodeMetaData.nodeId(), equalTo(nodeId));
+        final NodeMetaData nodeMetaData = PersistedClusterStateService.nodeMetaData(nodePaths);
         assertThat(nodeMetaData.nodeVersion(), equalTo(nodeVersion));
     }
 
     public void testWarnsIfTooNew() throws Exception {
-        final String nodeId = randomAlphaOfLength(10);
         final Version nodeVersion = NodeMetaDataTests.tooNewVersion();
-        NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(nodeId, nodeVersion), nodePaths);
+        PersistedClusterStateService.overrideVersion(nodeVersion, nodePaths);
         final MockTerminal mockTerminal = new MockTerminal();
         mockTerminal.addTextInput(randomFrom("yy", "Yy", "n", "yes", "true", "N", "no"));
         final ElasticsearchException elasticsearchException = expectThrows(ElasticsearchException.class, () ->
-            new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, environment));
+            new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, noOptions, environment));
         assertThat(elasticsearchException.getMessage(), equalTo("aborted by user"));
         assertThat(mockTerminal.getOutput(), allOf(
             containsString("data loss"),
@@ -113,18 +127,16 @@ public void testWarnsIfTooNew() throws Exception {
             containsString(nodeVersion.toString())));
         expectThrows(IllegalStateException.class, () -> mockTerminal.readText(""));
 
-        final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, xContentRegistry(), nodePaths);
-        assertThat(nodeMetaData.nodeId(), equalTo(nodeId));
+        final NodeMetaData nodeMetaData = PersistedClusterStateService.nodeMetaData(nodePaths);
         assertThat(nodeMetaData.nodeVersion(), equalTo(nodeVersion));
     }
 
     public void testOverwritesIfTooOld() throws Exception {
-        final String nodeId = randomAlphaOfLength(10);
         final Version nodeVersion = NodeMetaDataTests.tooOldVersion();
-        NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(nodeId, nodeVersion), nodePaths);
+        PersistedClusterStateService.overrideVersion(nodeVersion, nodePaths);
         final MockTerminal mockTerminal = new MockTerminal();
         mockTerminal.addTextInput(randomFrom("y", "Y"));
-        new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, environment);
+        new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, noOptions, environment);
         assertThat(mockTerminal.getOutput(), allOf(
             containsString("too old"),
             containsString("data loss"),
@@ -134,45 +146,16 @@ public void testOverwritesIfTooOld() throws Exception {
             containsString(OverrideNodeVersionCommand.SUCCESS_MESSAGE)));
         expectThrows(IllegalStateException.class, () -> mockTerminal.readText(""));
 
-        final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, xContentRegistry(), nodePaths);
-        assertThat(nodeMetaData.nodeId(), equalTo(nodeId));
+        final NodeMetaData nodeMetaData = PersistedClusterStateService.nodeMetaData(nodePaths);
         assertThat(nodeMetaData.nodeVersion(), equalTo(Version.CURRENT));
     }
 
     public void testOverwritesIfTooNew() throws Exception {
-        final String nodeId = randomAlphaOfLength(10);
-        final Version nodeVersion = NodeMetaDataTests.tooNewVersion();
-        NodeMetaData.FORMAT.writeAndCleanup(new NodeMetaData(nodeId, nodeVersion), nodePaths);
-        final MockTerminal mockTerminal = new MockTerminal();
-        mockTerminal.addTextInput(randomFrom("y", "Y"));
-        new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, environment);
-        assertThat(mockTerminal.getOutput(), allOf(
-            containsString("data loss"),
-            containsString("You should not use this tool"),
-            containsString(Version.CURRENT.toString()),
-            containsString(nodeVersion.toString()),
-            containsString(OverrideNodeVersionCommand.SUCCESS_MESSAGE)));
-        expectThrows(IllegalStateException.class, () -> mockTerminal.readText(""));
-
-        final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, xContentRegistry(), nodePaths);
-        assertThat(nodeMetaData.nodeId(), equalTo(nodeId));
-        assertThat(nodeMetaData.nodeVersion(), equalTo(Version.CURRENT));
-    }
-
-    public void testLenientlyIgnoresExtraFields() throws Exception {
-        final String nodeId = randomAlphaOfLength(10);
         final Version nodeVersion = NodeMetaDataTests.tooNewVersion();
-        FutureNodeMetaData.FORMAT.writeAndCleanup(new FutureNodeMetaData(nodeId, nodeVersion, randomLong()), nodePaths);
-        try {
-            NodeMetaData.FORMAT.loadLatestState(logger, xContentRegistry(), nodePaths);
-            fail("An exception should have been thrown");
-        } catch (ElasticsearchException e) {
-            assertThat(ExceptionsHelper.stackTrace(e), containsString("unknown field [future_field]"));
-        }
-
+        PersistedClusterStateService.overrideVersion(nodeVersion, nodePaths);
         final MockTerminal mockTerminal = new MockTerminal();
         mockTerminal.addTextInput(randomFrom("y", "Y"));
-        new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, environment);
+        new OverrideNodeVersionCommand().processNodePaths(mockTerminal, nodePaths, noOptions, environment);
         assertThat(mockTerminal.getOutput(), allOf(
             containsString("data loss"),
             containsString("You should not use this tool"),
@@ -181,35 +164,7 @@ public void testLenientlyIgnoresExtraFields() throws Exception {
             containsString(OverrideNodeVersionCommand.SUCCESS_MESSAGE)));
         expectThrows(IllegalStateException.class, () -> mockTerminal.readText(""));
 
-        final NodeMetaData nodeMetaData = NodeMetaData.FORMAT.loadLatestState(logger, xContentRegistry(), nodePaths);
-        assertThat(nodeMetaData.nodeId(), equalTo(nodeId));
+        final NodeMetaData nodeMetaData = PersistedClusterStateService.nodeMetaData(nodePaths);
         assertThat(nodeMetaData.nodeVersion(), equalTo(Version.CURRENT));
     }
-
-    private static class FutureNodeMetaData {
-        private final String nodeId;
-        private final Version nodeVersion;
-        private final long futureValue;
-
-        FutureNodeMetaData(String nodeId, Version nodeVersion, long futureValue) {
-            this.nodeId = nodeId;
-            this.nodeVersion = nodeVersion;
-            this.futureValue = futureValue;
-        }
-
-        static final MetaDataStateFormat<FutureNodeMetaData> FORMAT
-            = new MetaDataStateFormat<FutureNodeMetaData>(NodeMetaData.FORMAT.getPrefix()) {
-            @Override
-            public void toXContent(XContentBuilder builder, FutureNodeMetaData state) throws IOException {
-                builder.field(NODE_ID_KEY, state.nodeId);
-                builder.field(NODE_VERSION_KEY, state.nodeVersion.id);
-                builder.field("future_field", state.futureValue);
-            }
-
-            @Override
-            public FutureNodeMetaData fromXContent(XContentParser parser) {
-                throw new AssertionError("shouldn't be loading a FutureNodeMetaData");
-            }
-        };
-    }
 }
diff --git a/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java b/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
index 5cc73134bbcff..56d059f7278d1 100644
--- a/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/GatewayIndexStateIT.java
@@ -30,10 +30,8 @@
 import org.elasticsearch.client.Client;
 import org.elasticsearch.client.Requests;
 import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.coordination.CoordinationMetaData;
 import org.elasticsearch.cluster.metadata.IndexGraveyard;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.Manifest;
 import org.elasticsearch.cluster.metadata.MappingMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.routing.IndexRoutingTable;
@@ -42,11 +40,9 @@
 import org.elasticsearch.cluster.routing.ShardRoutingState;
 import org.elasticsearch.cluster.routing.UnassignedInfo;
 import org.elasticsearch.cluster.service.ClusterService;
-import org.elasticsearch.common.CheckedConsumer;
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentFactory;
-import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.mapper.MapperParsingException;
 import org.elasticsearch.indices.IndexClosedException;
@@ -57,7 +53,6 @@
 import org.elasticsearch.test.InternalTestCluster.RestartCallback;
 
 import java.io.IOException;
-import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.List;
 import java.util.Map;
@@ -377,14 +372,13 @@ public void testRecoverBrokenIndexMetadata() throws Exception {
         ClusterState state = client().admin().cluster().prepareState().get().getState();
 
         final IndexMetaData metaData = state.getMetaData().index("test");
-        final IndexMetaData brokenMeta = IndexMetaData.builder(metaData).settings(Settings.builder().put(metaData.getSettings())
+        final IndexMetaData.Builder brokenMeta = IndexMetaData.builder(metaData).settings(Settings.builder().put(metaData.getSettings())
                 .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT.minimumIndexCompatibilityVersion().id)
                 // this is invalid but should be archived
                 .put("index.similarity.BM25.type", "boolean")
                 // this one is not validated ahead of time and breaks allocation
-                .put("index.analysis.filter.myCollator.type", "icu_collation")
-        ).build();
-        writeBrokenMeta(metaStateService -> metaStateService.writeIndexAndUpdateManifest("broken metadata", brokenMeta));
+                .put("index.analysis.filter.myCollator.type", "icu_collation"));
+        restartNodesOnBrokenClusterState(ClusterState.builder(state).metaData(MetaData.builder(state.getMetaData()).put(brokenMeta)));
 
         // check that the cluster does not keep reallocating shards
         assertBusy(() -> {
@@ -447,9 +441,9 @@ public void testRecoverMissingAnalyzer() throws Exception {
         ClusterState state = client().admin().cluster().prepareState().get().getState();
 
         final IndexMetaData metaData = state.getMetaData().index("test");
-        final IndexMetaData brokenMeta = IndexMetaData.builder(metaData).settings(metaData.getSettings()
-                .filter((s) -> "index.analysis.analyzer.test.tokenizer".equals(s) == false)).build();
-        writeBrokenMeta(metaStateService -> metaStateService.writeIndexAndUpdateManifest("broken metadata", brokenMeta));
+        final IndexMetaData.Builder brokenMeta = IndexMetaData.builder(metaData).settings(metaData.getSettings()
+                .filter((s) -> "index.analysis.analyzer.test.tokenizer".equals(s) == false));
+        restartNodesOnBrokenClusterState(ClusterState.builder(state).metaData(MetaData.builder(state.getMetaData()).put(brokenMeta)));
 
         // check that the cluster does not keep reallocating shards
         assertBusy(() -> {
@@ -494,7 +488,7 @@ public void testArchiveBrokenClusterSettings() throws Exception {
         final MetaData brokenMeta = MetaData.builder(metaData).persistentSettings(Settings.builder()
                 .put(metaData.persistentSettings()).put("this.is.unknown", true)
                 .put(MetaData.SETTING_CLUSTER_MAX_SHARDS_PER_NODE.getKey(), "broken").build()).build();
-        writeBrokenMeta(metaStateService -> metaStateService.writeGlobalStateAndUpdateManifest("broken metadata", brokenMeta));
+        restartNodesOnBrokenClusterState(ClusterState.builder(state).metaData(brokenMeta));
 
         ensureYellow("test"); // wait for state recovery
         state = client().admin().cluster().prepareState().get().getState();
@@ -512,6 +506,8 @@ public void testArchiveBrokenClusterSettings() throws Exception {
         assertHitCount(client().prepareSearch().setQuery(matchAllQuery()).get(), 1L);
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/48701")
+    // This test relates to loading a broken state that was written by a 6.x node, but for now we do not load state from old nodes.
     public void testHalfDeletedIndexImport() throws Exception {
         // It's possible for a 6.x node to add a tombstone for an index but not actually delete the index metadata from disk since that
         // deletion is slightly deferred and may race against the node being shut down; if you upgrade to 7.x when in this state then the
@@ -526,36 +522,40 @@ public void testHalfDeletedIndexImport() throws Exception {
 
         final MetaData metaData = internalCluster().getInstance(ClusterService.class).state().metaData();
         final Path[] paths = internalCluster().getInstance(NodeEnvironment.class).nodeDataPaths();
-        writeBrokenMeta(metaStateService -> {
-            metaStateService.writeGlobalState("test", MetaData.builder(metaData)
-                // we remove the manifest file, resetting the term and making this look like an upgrade from 6.x, so must also reset the
-                // term in the coordination metadata
-                .coordinationMetaData(CoordinationMetaData.builder(metaData.coordinationMetaData()).term(0L).build())
-                // add a tombstone but do not delete the index metadata from disk
-                .putCustom(IndexGraveyard.TYPE, IndexGraveyard.builder().addTombstone(metaData.index("test").getIndex()).build()).build());
-            for (final Path path : paths) {
-                try (Stream<Path> stateFiles = Files.list(path.resolve(MetaDataStateFormat.STATE_DIR_NAME))) {
-                    for (final Path manifestPath : stateFiles
-                        .filter(p -> p.getFileName().toString().startsWith(Manifest.FORMAT.getPrefix())).collect(Collectors.toList())) {
-                        IOUtils.rm(manifestPath);
-                    }
-                }
-            }
-        });
+//        writeBrokenMeta(metaStateService -> {
+//            metaStateService.writeGlobalState("test", MetaData.builder(metaData)
+//                // we remove the manifest file, resetting the term and making this look like an upgrade from 6.x, so must also reset the
+//                // term in the coordination metadata
+//                .coordinationMetaData(CoordinationMetaData.builder(metaData.coordinationMetaData()).term(0L).build())
+//                // add a tombstone but do not delete the index metadata from disk
+//               .putCustom(IndexGraveyard.TYPE, IndexGraveyard.builder().addTombstone(metaData.index("test").getIndex()).build()).build());
+//            for (final Path path : paths) {
+//                try (Stream<Path> stateFiles = Files.list(path.resolve(MetaDataStateFormat.STATE_DIR_NAME))) {
+//                    for (final Path manifestPath : stateFiles
+//                        .filter(p -> p.getFileName().toString().startsWith(Manifest.FORMAT.getPrefix())).collect(Collectors.toList())) {
+//                        IOUtils.rm(manifestPath);
+//                    }
+//                }
+//            }
+//        });
 
         ensureGreen();
 
         assertBusy(() -> assertThat(internalCluster().getInstance(NodeEnvironment.class).availableIndexFolders(), empty()));
     }
 
-    private void writeBrokenMeta(CheckedConsumer<MetaStateService, IOException> writer) throws Exception {
-        Map<String, MetaStateService> metaStateServices = Stream.of(internalCluster().getNodeNames())
-            .collect(Collectors.toMap(Function.identity(), nodeName -> internalCluster().getInstance(MetaStateService.class, nodeName)));
+    private void restartNodesOnBrokenClusterState(ClusterState.Builder clusterStateBuilder) throws Exception {
+        Map<String, PersistedClusterStateService> lucenePersistedStateFactories = Stream.of(internalCluster().getNodeNames())
+            .collect(Collectors.toMap(Function.identity(),
+                nodeName -> internalCluster().getInstance(PersistedClusterStateService.class, nodeName)));
+        final ClusterState clusterState = clusterStateBuilder.build();
         internalCluster().fullRestart(new RestartCallback(){
             @Override
             public Settings onNodeStopped(String nodeName) throws Exception {
-                final MetaStateService metaStateService = metaStateServices.get(nodeName);
-                writer.accept(metaStateService);
+                final PersistedClusterStateService lucenePersistedStateFactory = lucenePersistedStateFactories.get(nodeName);
+                try (PersistedClusterStateService.Writer writer = lucenePersistedStateFactory.createWriter()) {
+                    writer.writeFullStateAndCommit(clusterState.term(), clusterState);
+                }
                 return super.onNodeStopped(nodeName);
             }
         });
diff --git a/server/src/test/java/org/elasticsearch/gateway/GatewayMetaStatePersistedStateTests.java b/server/src/test/java/org/elasticsearch/gateway/GatewayMetaStatePersistedStateTests.java
index e723d08d7352c..04b58ee04e219 100644
--- a/server/src/test/java/org/elasticsearch/gateway/GatewayMetaStatePersistedStateTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/GatewayMetaStatePersistedStateTests.java
@@ -19,29 +19,50 @@
 
 package org.elasticsearch.gateway;
 
+import org.apache.lucene.store.Directory;
+import org.apache.lucene.store.MockDirectoryWrapper;
+import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.Version;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.coordination.CoordinationMetaData;
 import org.elasticsearch.cluster.coordination.CoordinationMetaData.VotingConfigExclusion;
 import org.elasticsearch.cluster.coordination.CoordinationState;
-import org.elasticsearch.cluster.coordination.InMemoryPersistedState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.Manifest;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.node.DiscoveryNodeRole;
 import org.elasticsearch.cluster.node.DiscoveryNodes;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.util.set.Sets;
+import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
+import org.elasticsearch.env.TestEnvironment;
+import org.elasticsearch.node.Node;
 import org.elasticsearch.test.ESTestCase;
-
+import org.elasticsearch.threadpool.TestThreadPool;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.TransportService;
+
+import java.io.IOError;
+import java.io.IOException;
+import java.nio.file.Path;
+import java.util.ArrayList;
 import java.util.Collections;
+import java.util.List;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicReference;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.not;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
 
 public class GatewayMetaStatePersistedStateTests extends ESTestCase {
     private NodeEnvironment nodeEnvironment;
@@ -53,7 +74,7 @@ public class GatewayMetaStatePersistedStateTests extends ESTestCase {
     public void setUp() throws Exception {
         nodeEnvironment = newNodeEnvironment();
         localNode = new DiscoveryNode("node1", buildNewFakeTransportAddress(), Collections.emptyMap(),
-                Sets.newHashSet(DiscoveryNodeRole.MASTER_ROLE), Version.CURRENT);
+            Sets.newHashSet(DiscoveryNodeRole.MASTER_ROLE), Version.CURRENT);
         clusterName = new ClusterName(randomAlphaOfLength(10));
         settings = Settings.builder().put(ClusterName.CLUSTER_NAME_SETTING.getKey(), clusterName.value()).build();
         super.setUp();
@@ -69,57 +90,68 @@ private CoordinationState.PersistedState newGatewayPersistedState() {
         final MockGatewayMetaState gateway = new MockGatewayMetaState(localNode);
         gateway.start(settings, nodeEnvironment, xContentRegistry());
         final CoordinationState.PersistedState persistedState = gateway.getPersistedState();
-        assertThat(persistedState, not(instanceOf(InMemoryPersistedState.class)));
+        assertThat(persistedState, instanceOf(GatewayMetaState.LucenePersistedState.class));
         return persistedState;
     }
 
-    private CoordinationState.PersistedState maybeNew(CoordinationState.PersistedState persistedState) {
+    private CoordinationState.PersistedState maybeNew(CoordinationState.PersistedState persistedState) throws IOException {
         if (randomBoolean()) {
+            persistedState.close();
             return newGatewayPersistedState();
         }
         return persistedState;
     }
 
-    public void testInitialState() {
-        CoordinationState.PersistedState gateway = newGatewayPersistedState();
-        ClusterState state = gateway.getLastAcceptedState();
-        assertThat(state.getClusterName(), equalTo(clusterName));
-        assertTrue(MetaData.isGlobalStateEquals(state.metaData(), MetaData.EMPTY_META_DATA));
-        assertThat(state.getVersion(), equalTo(Manifest.empty().getClusterStateVersion()));
-        assertThat(state.getNodes().getLocalNode(), equalTo(localNode));
-
-        long currentTerm = gateway.getCurrentTerm();
-        assertThat(currentTerm, equalTo(Manifest.empty().getCurrentTerm()));
+    public void testInitialState() throws IOException {
+        CoordinationState.PersistedState gateway = null;
+        try {
+            gateway = newGatewayPersistedState();
+            ClusterState state = gateway.getLastAcceptedState();
+            assertThat(state.getClusterName(), equalTo(clusterName));
+            assertTrue(MetaData.isGlobalStateEquals(state.metaData(), MetaData.EMPTY_META_DATA));
+            assertThat(state.getVersion(), equalTo(Manifest.empty().getClusterStateVersion()));
+            assertThat(state.getNodes().getLocalNode(), equalTo(localNode));
+
+            long currentTerm = gateway.getCurrentTerm();
+            assertThat(currentTerm, equalTo(Manifest.empty().getCurrentTerm()));
+        } finally {
+            IOUtils.close(gateway);
+        }
     }
 
-    public void testSetCurrentTerm() {
-        CoordinationState.PersistedState gateway = newGatewayPersistedState();
-
-        for (int i = 0; i < randomIntBetween(1, 5); i++) {
-            final long currentTerm = randomNonNegativeLong();
-            gateway.setCurrentTerm(currentTerm);
-            gateway = maybeNew(gateway);
-            assertThat(gateway.getCurrentTerm(), equalTo(currentTerm));
+    public void testSetCurrentTerm() throws IOException {
+        CoordinationState.PersistedState gateway = null;
+        try {
+            gateway = newGatewayPersistedState();
+
+            for (int i = 0; i < randomIntBetween(1, 5); i++) {
+                final long currentTerm = randomNonNegativeLong();
+                gateway.setCurrentTerm(currentTerm);
+                gateway = maybeNew(gateway);
+                assertThat(gateway.getCurrentTerm(), equalTo(currentTerm));
+            }
+        } finally {
+            IOUtils.close(gateway);
         }
     }
 
     private ClusterState createClusterState(long version, MetaData metaData) {
         return ClusterState.builder(clusterName).
-                nodes(DiscoveryNodes.builder().add(localNode).localNodeId(localNode.getId()).build()).
-                version(version).
-                metaData(metaData).
-                build();
+            nodes(DiscoveryNodes.builder().add(localNode).localNodeId(localNode.getId()).build()).
+            version(version).
+            metaData(metaData).
+            build();
     }
 
     private CoordinationMetaData createCoordinationMetaData(long term) {
         CoordinationMetaData.Builder builder = CoordinationMetaData.builder();
         builder.term(term);
         builder.lastAcceptedConfiguration(
-                new CoordinationMetaData.VotingConfiguration(
-                        Sets.newHashSet(generateRandomStringArray(10, 10, false))));
+            new CoordinationMetaData.VotingConfiguration(
+                Sets.newHashSet(generateRandomStringArray(10, 10, false))));
         builder.lastCommittedConfiguration(
-                new CoordinationMetaData.VotingConfiguration(
-                        Sets.newHashSet(generateRandomStringArray(10, 10, false))));
+            new CoordinationMetaData.VotingConfiguration(
+                Sets.newHashSet(generateRandomStringArray(10, 10, false))));
         for (int i = 0; i < randomIntBetween(0, 5); i++) {
             builder.addVotingConfigExclusion(new VotingConfigExclusion(randomAlphaOfLength(10), randomAlphaOfLength(10)));
         }
@@ -129,12 +161,12 @@ private CoordinationMetaData createCoordinationMetaData(long term) {
 
     private IndexMetaData createIndexMetaData(String indexName, int numberOfShards, long version) {
         return IndexMetaData.builder(indexName).settings(
-                Settings.builder()
-                        .put(IndexMetaData.SETTING_INDEX_UUID, indexName)
-                        .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, numberOfShards)
-                        .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
-                        .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
-                        .build()
+            Settings.builder()
+                .put(IndexMetaData.SETTING_INDEX_UUID, indexName)
+                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, numberOfShards)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
+                .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
+                .build()
         ).version(version).build();
     }
 
@@ -146,70 +178,171 @@ private void assertClusterStateEqual(ClusterState expected, ClusterState actual)
         }
     }
 
-    public void testSetLastAcceptedState() {
-        CoordinationState.PersistedState gateway = newGatewayPersistedState();
-        final long term = randomNonNegativeLong();
-
-        for (int i = 0; i < randomIntBetween(1, 5); i++) {
-            final long version = randomNonNegativeLong();
-            final String indexName = randomAlphaOfLength(10);
-            final IndexMetaData indexMetaData = createIndexMetaData(indexName, randomIntBetween(1,5), randomNonNegativeLong());
-            final MetaData metaData = MetaData.builder().
+    public void testSetLastAcceptedState() throws IOException {
+        CoordinationState.PersistedState gateway = null;
+        try {
+            gateway = newGatewayPersistedState();
+            final long term = randomNonNegativeLong();
+
+            for (int i = 0; i < randomIntBetween(1, 5); i++) {
+                final long version = randomNonNegativeLong();
+                final String indexName = randomAlphaOfLength(10);
+                final IndexMetaData indexMetaData = createIndexMetaData(indexName, randomIntBetween(1, 5), randomNonNegativeLong());
+                final MetaData metaData = MetaData.builder().
                     persistentSettings(Settings.builder().put(randomAlphaOfLength(10), randomAlphaOfLength(10)).build()).
                     coordinationMetaData(createCoordinationMetaData(term)).
                     put(indexMetaData, false).
                     build();
-            ClusterState state = createClusterState(version, metaData);
+                ClusterState state = createClusterState(version, metaData);
 
-            gateway.setLastAcceptedState(state);
-            gateway = maybeNew(gateway);
+                gateway.setLastAcceptedState(state);
+                gateway = maybeNew(gateway);
 
-            ClusterState lastAcceptedState = gateway.getLastAcceptedState();
-            assertClusterStateEqual(state, lastAcceptedState);
+                ClusterState lastAcceptedState = gateway.getLastAcceptedState();
+                assertClusterStateEqual(state, lastAcceptedState);
+            }
+        } finally {
+            IOUtils.close(gateway);
         }
     }
 
-    public void testSetLastAcceptedStateTermChanged() {
-        CoordinationState.PersistedState gateway = newGatewayPersistedState();
+    public void testSetLastAcceptedStateTermChanged() throws IOException {
+        CoordinationState.PersistedState gateway = null;
+        try {
+            gateway = newGatewayPersistedState();
 
-        final String indexName = randomAlphaOfLength(10);
-        final int numberOfShards = randomIntBetween(1, 5);
-        final long version = randomNonNegativeLong();
-        final long term = randomNonNegativeLong();
-        final IndexMetaData indexMetaData = createIndexMetaData(indexName, numberOfShards, version);
-        final ClusterState state = createClusterState(randomNonNegativeLong(),
+            final String indexName = randomAlphaOfLength(10);
+            final int numberOfShards = randomIntBetween(1, 5);
+            final long version = randomNonNegativeLong();
+            final long term = randomValueOtherThan(Long.MAX_VALUE, ESTestCase::randomNonNegativeLong);
+            final IndexMetaData indexMetaData = createIndexMetaData(indexName, numberOfShards, version);
+            final ClusterState state = createClusterState(randomNonNegativeLong(),
                 MetaData.builder().coordinationMetaData(createCoordinationMetaData(term)).put(indexMetaData, false).build());
-        gateway.setLastAcceptedState(state);
+            gateway.setLastAcceptedState(state);
 
-        gateway = maybeNew(gateway);
-        final long newTerm = randomValueOtherThan(term, ESTestCase::randomNonNegativeLong);
-        final int newNumberOfShards = randomValueOtherThan(numberOfShards, () -> randomIntBetween(1,5));
-        final IndexMetaData newIndexMetaData = createIndexMetaData(indexName, newNumberOfShards, version);
-        final ClusterState newClusterState = createClusterState(randomNonNegativeLong(),
+            gateway = maybeNew(gateway);
+            final long newTerm = randomLongBetween(term + 1, Long.MAX_VALUE);
+            final int newNumberOfShards = randomValueOtherThan(numberOfShards, () -> randomIntBetween(1, 5));
+            final IndexMetaData newIndexMetaData = createIndexMetaData(indexName, newNumberOfShards, version);
+            final ClusterState newClusterState = createClusterState(randomNonNegativeLong(),
                 MetaData.builder().coordinationMetaData(createCoordinationMetaData(newTerm)).put(newIndexMetaData, false).build());
-        gateway.setLastAcceptedState(newClusterState);
+            gateway.setLastAcceptedState(newClusterState);
 
-        gateway = maybeNew(gateway);
-        assertThat(gateway.getLastAcceptedState().metaData().index(indexName), equalTo(newIndexMetaData));
+            gateway = maybeNew(gateway);
+            assertThat(gateway.getLastAcceptedState().metaData().index(indexName), equalTo(newIndexMetaData));
+        } finally {
+            IOUtils.close(gateway);
+        }
     }
 
-    public void testCurrentTermAndTermAreDifferent() {
-        CoordinationState.PersistedState gateway = newGatewayPersistedState();
+    public void testCurrentTermAndTermAreDifferent() throws IOException {
+        CoordinationState.PersistedState gateway = null;
+        try {
+            gateway = newGatewayPersistedState();
 
-        long currentTerm = randomNonNegativeLong();
-        long term  = randomValueOtherThan(currentTerm, ESTestCase::randomNonNegativeLong);
+            long currentTerm = randomNonNegativeLong();
+            long term = randomValueOtherThan(currentTerm, ESTestCase::randomNonNegativeLong);
 
-        gateway.setCurrentTerm(currentTerm);
-        gateway.setLastAcceptedState(createClusterState(randomNonNegativeLong(),
+            gateway.setCurrentTerm(currentTerm);
+            gateway.setLastAcceptedState(createClusterState(randomNonNegativeLong(),
                 MetaData.builder().coordinationMetaData(CoordinationMetaData.builder().term(term).build()).build()));
 
-        gateway = maybeNew(gateway);
-        assertThat(gateway.getCurrentTerm(), equalTo(currentTerm));
-        assertThat(gateway.getLastAcceptedState().coordinationMetaData().term(), equalTo(term));
+            gateway = maybeNew(gateway);
+            assertThat(gateway.getCurrentTerm(), equalTo(currentTerm));
+            assertThat(gateway.getLastAcceptedState().coordinationMetaData().term(), equalTo(term));
+        } finally {
+            IOUtils.close(gateway);
+        }
+    }
+
+    public void testMarkAcceptedConfigAsCommitted() throws IOException {
+        CoordinationState.PersistedState gateway = null;
+        try {
+            gateway = newGatewayPersistedState();
+
+            // generate random coordinationMetaData with different lastAcceptedConfiguration and lastCommittedConfiguration
+            CoordinationMetaData coordinationMetaData;
+            do {
+                coordinationMetaData = createCoordinationMetaData(randomNonNegativeLong());
+            } while (coordinationMetaData.getLastAcceptedConfiguration().equals(coordinationMetaData.getLastCommittedConfiguration()));
+
+            ClusterState state = createClusterState(randomNonNegativeLong(),
+                MetaData.builder().coordinationMetaData(coordinationMetaData)
+                    .clusterUUID(randomAlphaOfLength(10)).build());
+            gateway.setLastAcceptedState(state);
+
+            gateway = maybeNew(gateway);
+            assertThat(gateway.getLastAcceptedState().getLastAcceptedConfiguration(),
+                not(equalTo(gateway.getLastAcceptedState().getLastCommittedConfiguration())));
+            gateway.markLastAcceptedStateAsCommitted();
+
+            CoordinationMetaData expectedCoordinationMetaData = CoordinationMetaData.builder(coordinationMetaData)
+                .lastCommittedConfiguration(coordinationMetaData.getLastAcceptedConfiguration()).build();
+            ClusterState expectedClusterState =
+                ClusterState.builder(state).metaData(MetaData.builder().coordinationMetaData(expectedCoordinationMetaData)
+                    .clusterUUID(state.metaData().clusterUUID()).clusterUUIDCommitted(true).build()).build();
+
+            gateway = maybeNew(gateway);
+            assertClusterStateEqual(expectedClusterState, gateway.getLastAcceptedState());
+            gateway.markLastAcceptedStateAsCommitted();
+
+            gateway = maybeNew(gateway);
+            assertClusterStateEqual(expectedClusterState, gateway.getLastAcceptedState());
+        } finally {
+            IOUtils.close(gateway);
+        }
     }
 
-    public void testMarkAcceptedConfigAsCommitted() {
-        CoordinationState.PersistedState gateway = newGatewayPersistedState();
+    public void testStatePersistedOnLoad() throws IOException {
+        // open LucenePersistedState to make sure that cluster state is written out to each data path
+        final PersistedClusterStateService persistedClusterStateService =
+            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE);
+        final ClusterState state = createClusterState(randomNonNegativeLong(),
+            MetaData.builder().clusterUUID(randomAlphaOfLength(10)).build());
+        try (GatewayMetaState.LucenePersistedState ignored = new GatewayMetaState.LucenePersistedState(
+            persistedClusterStateService, 42L, state)) {
+
+        }
+
+        nodeEnvironment.close();
+
+        // verify that the freshest state was rewritten to each data path
+        for (Path path : nodeEnvironment.nodeDataPaths()) {
+            Settings settings = Settings.builder()
+                .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toAbsolutePath())
+                .put(Environment.PATH_DATA_SETTING.getKey(), path.toString()).build();
+            try (NodeEnvironment nodeEnvironment = new NodeEnvironment(settings, TestEnvironment.newEnvironment(settings))) {
+                final PersistedClusterStateService newPersistedClusterStateService =
+                    new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE);
+                final PersistedClusterStateService.OnDiskState onDiskState = newPersistedClusterStateService.loadBestOnDiskState();
+                assertFalse(onDiskState.empty());
+                assertThat(onDiskState.currentTerm, equalTo(42L));
+                assertClusterStateEqual(state,
+                    ClusterState.builder(ClusterName.DEFAULT)
+                        .version(onDiskState.lastAcceptedVersion)
+                        .metaData(onDiskState.metaData).build());
+            }
+        }
+    }
+
+    public void testDataOnlyNodePersistence() throws Exception {
+        DiscoveryNode localNode = new DiscoveryNode("node1", buildNewFakeTransportAddress(), Collections.emptyMap(),
+            Sets.newHashSet(DiscoveryNodeRole.DATA_ROLE), Version.CURRENT);
+        Settings settings = Settings.builder().put(ClusterName.CLUSTER_NAME_SETTING.getKey(), clusterName.value()).put(
+            Node.NODE_MASTER_SETTING.getKey(), false).put(Node.NODE_NAME_SETTING.getKey(), "test").build();
+        final MockGatewayMetaState gateway = new MockGatewayMetaState(localNode);
+        final TransportService transportService = mock(TransportService.class);
+        TestThreadPool threadPool = new TestThreadPool("testMarkAcceptedConfigAsCommittedOnDataOnlyNode");
+        when(transportService.getThreadPool()).thenReturn(threadPool);
+        ClusterService clusterService = mock(ClusterService.class);
+        when(clusterService.getClusterSettings()).thenReturn(
+            new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS));
+        final PersistedClusterStateService persistedClusterStateService =
+            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE);
+        gateway.start(settings, transportService, clusterService,
+            new MetaStateService(nodeEnvironment, xContentRegistry()), null, null, persistedClusterStateService);
+        final CoordinationState.PersistedState persistedState = gateway.getPersistedState();
+        assertThat(persistedState, instanceOf(GatewayMetaState.AsyncLucenePersistedState.class));
 
         //generate random coordinationMetaData with different lastAcceptedConfiguration and lastCommittedConfiguration
         CoordinationMetaData coordinationMetaData;
@@ -218,26 +351,161 @@ public void testMarkAcceptedConfigAsCommitted() {
         } while (coordinationMetaData.getLastAcceptedConfiguration().equals(coordinationMetaData.getLastCommittedConfiguration()));
 
         ClusterState state = createClusterState(randomNonNegativeLong(),
-                MetaData.builder().coordinationMetaData(coordinationMetaData)
-                    .clusterUUID(randomAlphaOfLength(10)).build());
-        gateway.setLastAcceptedState(state);
-
-        gateway = maybeNew(gateway);
-        assertThat(gateway.getLastAcceptedState().getLastAcceptedConfiguration(),
-                not(equalTo(gateway.getLastAcceptedState().getLastCommittedConfiguration())));
-        gateway.markLastAcceptedStateAsCommitted();
+            MetaData.builder().coordinationMetaData(coordinationMetaData)
+                .clusterUUID(randomAlphaOfLength(10)).build());
+        persistedState.setLastAcceptedState(state);
+        assertBusy(() -> assertTrue(gateway.allPendingAsyncStatesWritten()));
+
+        assertThat(persistedState.getLastAcceptedState().getLastAcceptedConfiguration(),
+            not(equalTo(persistedState.getLastAcceptedState().getLastCommittedConfiguration())));
+        CoordinationMetaData persistedCoordinationMetaData =
+            persistedClusterStateService.loadBestOnDiskState().metaData.coordinationMetaData();
+        assertThat(persistedCoordinationMetaData.getLastAcceptedConfiguration(),
+            equalTo(GatewayMetaState.AsyncLucenePersistedState.staleStateConfiguration));
+        assertThat(persistedCoordinationMetaData.getLastCommittedConfiguration(),
+            equalTo(GatewayMetaState.AsyncLucenePersistedState.staleStateConfiguration));
+
+        persistedState.markLastAcceptedStateAsCommitted();
+        assertBusy(() -> assertTrue(gateway.allPendingAsyncStatesWritten()));
 
         CoordinationMetaData expectedCoordinationMetaData = CoordinationMetaData.builder(coordinationMetaData)
-                .lastCommittedConfiguration(coordinationMetaData.getLastAcceptedConfiguration()).build();
+            .lastCommittedConfiguration(coordinationMetaData.getLastAcceptedConfiguration()).build();
         ClusterState expectedClusterState =
-                ClusterState.builder(state).metaData(MetaData.builder().coordinationMetaData(expectedCoordinationMetaData)
-                    .clusterUUID(state.metaData().clusterUUID()).clusterUUIDCommitted(true).build()).build();
+            ClusterState.builder(state).metaData(MetaData.builder().coordinationMetaData(expectedCoordinationMetaData)
+                .clusterUUID(state.metaData().clusterUUID()).clusterUUIDCommitted(true).build()).build();
+
+        assertClusterStateEqual(expectedClusterState, persistedState.getLastAcceptedState());
+        persistedCoordinationMetaData = persistedClusterStateService.loadBestOnDiskState().metaData.coordinationMetaData();
+        assertThat(persistedCoordinationMetaData.getLastAcceptedConfiguration(),
+            equalTo(GatewayMetaState.AsyncLucenePersistedState.staleStateConfiguration));
+        assertThat(persistedCoordinationMetaData.getLastCommittedConfiguration(),
+            equalTo(GatewayMetaState.AsyncLucenePersistedState.staleStateConfiguration));
+        assertTrue(persistedClusterStateService.loadBestOnDiskState().metaData.clusterUUIDCommitted());
+
+        // generate a series of updates and check if batching works
+        final String indexName = randomAlphaOfLength(10);
+        long currentTerm = state.term();
+        for (int i = 0; i < 1000; i++) {
+            if (rarely()) {
+                // bump term
+                currentTerm = currentTerm + (rarely() ? randomIntBetween(1, 5) : 0L);
+                persistedState.setCurrentTerm(currentTerm);
+            } else {
+                // update cluster state
+                final int numberOfShards = randomIntBetween(1, 5);
+                final long term = Math.min(state.term() + (rarely() ? randomIntBetween(1, 5) : 0L), currentTerm);
+                final IndexMetaData indexMetaData = createIndexMetaData(indexName, numberOfShards, i);
+                state = createClusterState(state.version() + 1,
+                    MetaData.builder().coordinationMetaData(createCoordinationMetaData(term)).put(indexMetaData, false).build());
+                persistedState.setLastAcceptedState(state);
+            }
+        }
+        assertEquals(currentTerm, persistedState.getCurrentTerm());
+        assertClusterStateEqual(state, persistedState.getLastAcceptedState());
+        assertBusy(() -> assertTrue(gateway.allPendingAsyncStatesWritten()));
+
+        gateway.close();
+
+        try (CoordinationState.PersistedState reloadedPersistedState = newGatewayPersistedState()) {
+            assertEquals(currentTerm, reloadedPersistedState.getCurrentTerm());
+            assertClusterStateEqual(GatewayMetaState.AsyncLucenePersistedState.resetVotingConfiguration(state),
+                reloadedPersistedState.getLastAcceptedState());
+            assertNotNull(reloadedPersistedState.getLastAcceptedState().metaData().index(indexName));
+        }
+
+        ThreadPool.terminate(threadPool, 10, TimeUnit.SECONDS);
+    }
 
-        gateway = maybeNew(gateway);
-        assertClusterStateEqual(expectedClusterState, gateway.getLastAcceptedState());
-        gateway.markLastAcceptedStateAsCommitted();
+    public void testStatePersistenceWithIOIssues() throws IOException {
+        final AtomicReference<Double> ioExceptionRate = new AtomicReference<>(0.01d);
+        final List<MockDirectoryWrapper> list = new ArrayList<>();
+        final PersistedClusterStateService persistedClusterStateService =
+            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE) {
+                @Override
+                Directory createDirectory(Path path) {
+                    final MockDirectoryWrapper wrapper = newMockFSDirectory(path);
+                    wrapper.setAllowRandomFileNotFoundException(randomBoolean());
+                    wrapper.setRandomIOExceptionRate(ioExceptionRate.get());
+                    wrapper.setRandomIOExceptionRateOnOpen(ioExceptionRate.get());
+                    list.add(wrapper);
+                    return wrapper;
+                }
+            };
+        ClusterState state = createClusterState(randomNonNegativeLong(),
+            MetaData.builder().clusterUUID(randomAlphaOfLength(10)).build());
+        long currentTerm = 42L;
+        try (GatewayMetaState.LucenePersistedState persistedState = new GatewayMetaState.LucenePersistedState(
+            persistedClusterStateService, currentTerm, state)) {
+
+            try {
+                if (randomBoolean()) {
+                    final ClusterState newState = createClusterState(randomNonNegativeLong(),
+                        MetaData.builder().clusterUUID(randomAlphaOfLength(10)).build());
+                    persistedState.setLastAcceptedState(newState);
+                    state = newState;
+                } else {
+                    final long newTerm = currentTerm + 1;
+                    persistedState.setCurrentTerm(newTerm);
+                    currentTerm = newTerm;
+                }
+            } catch (IOError | Exception e) {
+                assertNotNull(ExceptionsHelper.unwrap(e, IOException.class));
+            }
+
+            ioExceptionRate.set(0.0d);
+            for (MockDirectoryWrapper wrapper : list) {
+                wrapper.setRandomIOExceptionRate(ioExceptionRate.get());
+                wrapper.setRandomIOExceptionRateOnOpen(ioExceptionRate.get());
+            }
+
+            for (int i = 0; i < randomIntBetween(1, 5); i++) {
+                if (randomBoolean()) {
+                    final long version = randomNonNegativeLong();
+                    final String indexName = randomAlphaOfLength(10);
+                    final IndexMetaData indexMetaData = createIndexMetaData(indexName, randomIntBetween(1, 5), randomNonNegativeLong());
+                    final MetaData metaData = MetaData.builder().
+                        persistentSettings(Settings.builder().put(randomAlphaOfLength(10), randomAlphaOfLength(10)).build()).
+                        coordinationMetaData(createCoordinationMetaData(1L)).
+                        put(indexMetaData, false).
+                        build();
+                    state = createClusterState(version, metaData);
+                    persistedState.setLastAcceptedState(state);
+                } else {
+                    currentTerm += 1;
+                    persistedState.setCurrentTerm(currentTerm);
+                }
+            }
+
+            assertEquals(state, persistedState.getLastAcceptedState());
+            assertEquals(currentTerm, persistedState.getCurrentTerm());
+
+        } catch (IOError | Exception e) {
+            if (ioExceptionRate.get() == 0.0d) {
+                throw e;
+            }
+            assertNotNull(ExceptionsHelper.unwrap(e, IOException.class));
+            return;
+        }
 
-        gateway = maybeNew(gateway);
-        assertClusterStateEqual(expectedClusterState, gateway.getLastAcceptedState());
+        nodeEnvironment.close();
+
+        // verify that the freshest state was rewritten to each data path
+        for (Path path : nodeEnvironment.nodeDataPaths()) {
+            Settings settings = Settings.builder()
+                .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toAbsolutePath())
+                .put(Environment.PATH_DATA_SETTING.getKey(), path.toString()).build();
+            try (NodeEnvironment nodeEnvironment = new NodeEnvironment(settings, TestEnvironment.newEnvironment(settings))) {
+                final PersistedClusterStateService newPersistedClusterStateService =
+                    new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE);
+                final PersistedClusterStateService.OnDiskState onDiskState = newPersistedClusterStateService.loadBestOnDiskState();
+                assertFalse(onDiskState.empty());
+                assertThat(onDiskState.currentTerm, equalTo(currentTerm));
+                assertClusterStateEqual(state,
+                    ClusterState.builder(ClusterName.DEFAULT)
+                        .version(onDiskState.lastAcceptedVersion)
+                        .metaData(onDiskState.metaData).build());
+            }
+        }
     }
+
 }
diff --git a/server/src/test/java/org/elasticsearch/gateway/IncrementalClusterStateWriterTests.java b/server/src/test/java/org/elasticsearch/gateway/IncrementalClusterStateWriterTests.java
index 65432466c61a1..86fe94587093a 100644
--- a/server/src/test/java/org/elasticsearch/gateway/IncrementalClusterStateWriterTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/IncrementalClusterStateWriterTests.java
@@ -173,7 +173,7 @@ private IndexMetaData createIndexMetaData(String name) {
     public void testGetRelevantIndicesWithUnassignedShardsOnMasterEligibleNode() {
         IndexMetaData indexMetaData = createIndexMetaData("test");
         Set<Index> indices = IncrementalClusterStateWriter.getRelevantIndices(clusterStateWithUnassignedIndex(indexMetaData, true));
-        assertThat(indices.size(), equalTo(1));
+        assertThat(indices.size(), equalTo(0));
     }
 
     public void testGetRelevantIndicesWithUnassignedShardsOnDataOnlyNode() {
diff --git a/server/src/test/java/org/elasticsearch/gateway/MetaDataWriteDataNodesIT.java b/server/src/test/java/org/elasticsearch/gateway/MetaDataWriteDataNodesIT.java
index 2d629c9ca1ee2..6cadf896453c3 100644
--- a/server/src/test/java/org/elasticsearch/gateway/MetaDataWriteDataNodesIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/MetaDataWriteDataNodesIT.java
@@ -21,10 +21,11 @@
 
 import org.elasticsearch.action.admin.cluster.state.ClusterStateResponse;
 import org.elasticsearch.action.admin.indices.mapping.get.GetMappingsResponse;
+import org.elasticsearch.cluster.coordination.Coordinator;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.common.collect.ImmutableOpenMap;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.discovery.Discovery;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.test.ESIntegTestCase;
@@ -55,8 +56,8 @@ public void testMetaWrittenAlsoOnDataNode() throws Exception {
         assertIndexInMetaState(masterNode, "test");
     }
 
-    public void testMetaIsRemovedIfAllShardsFromIndexRemoved() throws Exception {
-        // this test checks that the index state is removed from a data only node once all shards have been allocated away from it
+    public void testIndexFilesAreRemovedIfAllShardsFromIndexRemoved() throws Exception {
+        // this test checks that the index data is removed from a data only node once all shards have been allocated away from it
         String masterNode = internalCluster().startMasterOnlyNode(Settings.EMPTY);
         List<String> nodeNames= internalCluster().startDataOnlyNodes(2);
         String node1 = nodeNames.get(0);
@@ -69,8 +70,10 @@ public void testMetaIsRemovedIfAllShardsFromIndexRemoved() throws Exception {
         ensureGreen();
         assertIndexInMetaState(node1, index);
         Index resolveIndex = resolveIndex(index);
+        assertIndexDirectoryExists(node1, resolveIndex);
         assertIndexDirectoryDeleted(node2, resolveIndex);
         assertIndexInMetaState(masterNode, index);
+        assertIndexDirectoryDeleted(masterNode, resolveIndex);
 
         logger.debug("relocating index...");
         client().admin().indices().prepareUpdateSettings(index).setSettings(Settings.builder()
@@ -79,7 +82,13 @@ public void testMetaIsRemovedIfAllShardsFromIndexRemoved() throws Exception {
         ensureGreen();
         assertIndexDirectoryDeleted(node1, resolveIndex);
         assertIndexInMetaState(node2, index);
+        assertIndexDirectoryExists(node2, resolveIndex);
         assertIndexInMetaState(masterNode, index);
+        assertIndexDirectoryDeleted(masterNode, resolveIndex);
+
+        client().admin().indices().prepareDelete(index).get();
+        assertIndexDirectoryDeleted(node1, resolveIndex);
+        assertIndexDirectoryDeleted(node2, resolveIndex);
     }
 
     @SuppressWarnings("unchecked")
@@ -156,17 +165,19 @@ public void testMetaWrittenWhenIndexIsClosedAndMetaUpdated() throws Exception {
     }
 
     protected void assertIndexDirectoryDeleted(final String nodeName, final Index index) throws Exception {
-        assertBusy(() -> {
-            logger.info("checking if index directory exists...");
-            assertFalse("Expecting index directory of " + index + " to be deleted from node " + nodeName,
-                indexDirectoryExists(nodeName, index));
-        }
+        assertBusy(() -> assertFalse("Expecting index directory of " + index + " to be deleted from node " + nodeName,
+            indexDirectoryExists(nodeName, index))
+        );
+    }
+
+    protected void assertIndexDirectoryExists(final String nodeName, final Index index) throws Exception {
+        assertBusy(() -> assertTrue("Expecting index directory of " + index + " to exist on node " + nodeName,
+            indexDirectoryExists(nodeName, index))
         );
     }
 
     protected void assertIndexInMetaState(final String nodeName, final String indexName) throws Exception {
         assertBusy(() -> {
-            logger.info("checking if meta state exists...");
             try {
                 assertTrue("Expecting meta state of index " + indexName + " to be on node " + nodeName,
                     getIndicesMetaDataOnNode(nodeName).containsKey(indexName));
@@ -190,8 +201,7 @@ private boolean indexDirectoryExists(String nodeName, Index index) {
     }
 
     private ImmutableOpenMap<String, IndexMetaData> getIndicesMetaDataOnNode(String nodeName) {
-        GatewayMetaState nodeMetaState = ((InternalTestCluster) cluster()).getInstance(GatewayMetaState.class, nodeName);
-        MetaData nodeMetaData = nodeMetaState.getMetaData();
-        return nodeMetaData.getIndices();
+        final Coordinator coordinator = (Coordinator) internalCluster().getInstance(Discovery.class, nodeName);
+        return coordinator.getApplierState().getMetaData().getIndices();
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/gateway/MetaStateServiceTests.java b/server/src/test/java/org/elasticsearch/gateway/MetaStateServiceTests.java
index 2f34cc4300d2d..97b29327b9d3b 100644
--- a/server/src/test/java/org/elasticsearch/gateway/MetaStateServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/MetaStateServiceTests.java
@@ -155,7 +155,7 @@ public void testLoadFullStateMissingGlobalMetaData() throws IOException {
         assertThat(loadedMetaData.index("test1"), equalTo(index));
     }
 
-    public void testLoadFullStateAndUpdate() throws IOException {
+    public void testLoadFullStateAndUpdateAndClean() throws IOException {
         IndexMetaData index = indexMetaData("test1");
         MetaData metaData = MetaData.builder()
                 .persistentSettings(Settings.builder().put("test1", "value1").build())
@@ -201,5 +201,15 @@ public void testLoadFullStateAndUpdate() throws IOException {
         assertThat(loadedMetaData.persistentSettings(), equalTo(newMetaData.persistentSettings()));
         assertThat(loadedMetaData.hasIndex("test1"), equalTo(true));
         assertThat(loadedMetaData.index("test1"), equalTo(index));
+
+        if (randomBoolean()) {
+            metaStateService.unreferenceAll();
+        } else {
+            metaStateService.deleteAll();
+        }
+        manifestAndMetaData = metaStateService.loadFullState();
+        assertTrue(manifestAndMetaData.v1().isEmpty());
+        metaData = manifestAndMetaData.v2();
+        assertTrue(MetaData.isGlobalStateEquals(metaData, MetaData.EMPTY_META_DATA));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/gateway/PersistedClusterStateServiceTests.java b/server/src/test/java/org/elasticsearch/gateway/PersistedClusterStateServiceTests.java
new file mode 100644
index 0000000000000..a05dc9fc560a8
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/gateway/PersistedClusterStateServiceTests.java
@@ -0,0 +1,791 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.gateway;
+
+import org.apache.lucene.index.IndexWriter;
+import org.apache.lucene.index.IndexWriterConfig;
+import org.apache.lucene.index.Term;
+import org.apache.lucene.store.Directory;
+import org.apache.lucene.store.FilterDirectory;
+import org.apache.lucene.store.IOContext;
+import org.apache.lucene.store.IndexOutput;
+import org.apache.lucene.store.SimpleFSDirectory;
+import org.elasticsearch.Version;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.coordination.CoordinationMetaData;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.UUIDs;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.BigArrays;
+import org.elasticsearch.common.util.MockBigArrays;
+import org.elasticsearch.common.util.MockPageCacheRecycler;
+import org.elasticsearch.core.internal.io.IOUtils;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.env.NodeEnvironment;
+import org.elasticsearch.env.NodeMetaData;
+import org.elasticsearch.gateway.PersistedClusterStateService.Writer;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.indices.breaker.NoneCircuitBreakerService;
+import org.elasticsearch.test.ESTestCase;
+
+import java.io.IOError;
+import java.io.IOException;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.HashSet;
+import java.util.List;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+import static org.hamcrest.Matchers.allOf;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.nullValue;
+
+public class PersistedClusterStateServiceTests extends ESTestCase {
+
+    private PersistedClusterStateService newPersistedClusterStateService(NodeEnvironment nodeEnvironment) {
+        return new PersistedClusterStateService(nodeEnvironment, xContentRegistry(),
+            usually()
+                ? BigArrays.NON_RECYCLING_INSTANCE
+                : new MockBigArrays(new MockPageCacheRecycler(Settings.EMPTY), new NoneCircuitBreakerService()));
+    }
+
+    public void testPersistsAndReloadsTerm() throws IOException {
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            final PersistedClusterStateService persistedClusterStateService = newPersistedClusterStateService(nodeEnvironment);
+            final long newTerm = randomNonNegativeLong();
+
+            assertThat(persistedClusterStateService.loadBestOnDiskState().currentTerm, equalTo(0L));
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                writer.writeFullStateAndCommit(newTerm, ClusterState.EMPTY_STATE);
+                assertThat(persistedClusterStateService.loadBestOnDiskState().currentTerm, equalTo(newTerm));
+            }
+
+            assertThat(persistedClusterStateService.loadBestOnDiskState().currentTerm, equalTo(newTerm));
+        }
+    }
+
+    public void testPersistsAndReloadsGlobalMetadata() throws IOException {
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            final PersistedClusterStateService persistedClusterStateService = newPersistedClusterStateService(nodeEnvironment);
+            final String clusterUUID = UUIDs.randomBase64UUID(random());
+            final long version = randomLongBetween(1L, Long.MAX_VALUE);
+
+            ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                writer.writeFullStateAndCommit(0L, ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .clusterUUID(clusterUUID)
+                        .clusterUUIDCommitted(true)
+                        .version(version))
+                    .incrementVersion().build());
+                clusterState = loadPersistedClusterState(persistedClusterStateService);
+                assertThat(clusterState.metaData().clusterUUID(), equalTo(clusterUUID));
+                assertTrue(clusterState.metaData().clusterUUIDCommitted());
+                assertThat(clusterState.metaData().version(), equalTo(version));
+            }
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                writer.writeFullStateAndCommit(0L, ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .clusterUUID(clusterUUID)
+                        .clusterUUIDCommitted(true)
+                        .version(version + 1))
+                    .incrementVersion().build());
+            }
+
+            clusterState = loadPersistedClusterState(persistedClusterStateService);
+            assertThat(clusterState.metaData().clusterUUID(), equalTo(clusterUUID));
+            assertTrue(clusterState.metaData().clusterUUIDCommitted());
+            assertThat(clusterState.metaData().version(), equalTo(version + 1));
+        }
+    }
+
+    private static void writeState(Writer writer, long currentTerm, ClusterState clusterState,
+                                   ClusterState previousState) throws IOException {
+        if (randomBoolean() || clusterState.term() != previousState.term() || writer.fullStateWritten == false) {
+            writer.writeFullStateAndCommit(currentTerm, clusterState);
+        } else {
+            writer.writeIncrementalStateAndCommit(currentTerm, previousState, clusterState);
+        }
+    }
+
+    public void testLoadsFreshestState() throws IOException {
+        final Path[] dataPaths = createDataPaths();
+        final long freshTerm = randomLongBetween(1L, Long.MAX_VALUE);
+        final long staleTerm = randomBoolean() ? freshTerm : randomLongBetween(1L, freshTerm);
+        final long freshVersion = randomLongBetween(2L, Long.MAX_VALUE);
+        final long staleVersion = staleTerm == freshTerm ? randomLongBetween(1L, freshVersion - 1) : randomLongBetween(1L, Long.MAX_VALUE);
+
+        final HashSet<Path> unimportantPaths = Arrays.stream(dataPaths).collect(Collectors.toCollection(HashSet::new));
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(dataPaths)) {
+            final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                writeState(writer, staleTerm,
+                    ClusterState.builder(clusterState).version(staleVersion)
+                        .metaData(MetaData.builder(clusterState.metaData()).coordinationMetaData(
+                            CoordinationMetaData.builder(clusterState.coordinationMetaData()).term(staleTerm).build())).build(),
+                    clusterState);
+            }
+        }
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(new Path[]{randomFrom(dataPaths)})) {
+            unimportantPaths.remove(nodeEnvironment.nodeDataPaths()[0]);
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                writeState(writer, freshTerm,
+                    ClusterState.builder(clusterState).version(freshVersion)
+                        .metaData(MetaData.builder(clusterState.metaData()).coordinationMetaData(
+                            CoordinationMetaData.builder(clusterState.coordinationMetaData()).term(freshTerm).build())).build(),
+                    clusterState);
+            }
+        }
+
+        if (randomBoolean() && unimportantPaths.isEmpty() == false) {
+            IOUtils.rm(randomFrom(unimportantPaths));
+        }
+
+        // verify that the freshest state is chosen
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(dataPaths)) {
+            final PersistedClusterStateService.OnDiskState onDiskState = newPersistedClusterStateService(nodeEnvironment)
+                .loadBestOnDiskState();
+            final ClusterState clusterState = clusterStateFromMetadata(onDiskState.lastAcceptedVersion, onDiskState.metaData);
+            assertThat(clusterState.term(), equalTo(freshTerm));
+            assertThat(clusterState.version(), equalTo(freshVersion));
+        }
+    }
+
+    public void testFailsOnMismatchedNodeIds() throws IOException {
+        final Path[] dataPaths1 = createDataPaths();
+        final Path[] dataPaths2 = createDataPaths();
+
+        final String[] nodeIds = new String[2];
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(dataPaths1)) {
+            nodeIds[0] = nodeEnvironment.nodeId();
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                writer.writeFullStateAndCommit(0L,
+                    ClusterState.builder(clusterState).version(randomLongBetween(1L, Long.MAX_VALUE)).build());
+            }
+        }
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(dataPaths2)) {
+            nodeIds[1] = nodeEnvironment.nodeId();
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                writer.writeFullStateAndCommit(0L,
+                    ClusterState.builder(clusterState).version(randomLongBetween(1L, Long.MAX_VALUE)).build());
+            }
+        }
+
+        NodeMetaData.FORMAT.cleanupOldFiles(Long.MAX_VALUE, dataPaths2);
+
+        final Path[] combinedPaths = Stream.concat(Arrays.stream(dataPaths1), Arrays.stream(dataPaths2)).toArray(Path[]::new);
+
+        final String failure = expectThrows(IllegalStateException.class, () -> newNodeEnvironment(combinedPaths)).getMessage();
+        assertThat(failure,
+            allOf(containsString("unexpected node ID in metadata"), containsString(nodeIds[0]), containsString(nodeIds[1])));
+        assertTrue("[" + failure + "] should match " + Arrays.toString(dataPaths2),
+            Arrays.stream(dataPaths2).anyMatch(p -> failure.contains(p.toString())));
+
+        // verify that loadBestOnDiskState has same check
+        final String message = expectThrows(IllegalStateException.class,
+            () -> new PersistedClusterStateService(combinedPaths, nodeIds[0], xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                randomBoolean()).loadBestOnDiskState()).getMessage();
+        assertThat(message,
+            allOf(containsString("unexpected node ID in metadata"), containsString(nodeIds[0]), containsString(nodeIds[1])));
+        assertTrue("[" + message + "] should match " + Arrays.toString(dataPaths2),
+            Arrays.stream(dataPaths2).anyMatch(p -> message.contains(p.toString())));
+    }
+
+    public void testFailsOnMismatchedCommittedClusterUUIDs() throws IOException {
+        final Path[] dataPaths1 = createDataPaths();
+        final Path[] dataPaths2 = createDataPaths();
+        final Path[] combinedPaths = Stream.concat(Arrays.stream(dataPaths1), Arrays.stream(dataPaths2)).toArray(Path[]::new);
+
+        final String clusterUUID1 = UUIDs.randomBase64UUID(random());
+        final String clusterUUID2 = UUIDs.randomBase64UUID(random());
+
+        // first establish consistent node IDs and write initial metadata
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(combinedPaths)) {
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                assertFalse(clusterState.metaData().clusterUUIDCommitted());
+                writer.writeFullStateAndCommit(0L, clusterState);
+            }
+        }
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(dataPaths1)) {
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                assertFalse(clusterState.metaData().clusterUUIDCommitted());
+                writer.writeFullStateAndCommit(0L, ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .clusterUUID(clusterUUID1)
+                        .clusterUUIDCommitted(true)
+                        .version(1))
+                    .incrementVersion().build());
+            }
+        }
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(dataPaths2)) {
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                assertFalse(clusterState.metaData().clusterUUIDCommitted());
+                writer.writeFullStateAndCommit(0L, ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .clusterUUID(clusterUUID2)
+                        .clusterUUIDCommitted(true)
+                        .version(1))
+                    .incrementVersion().build());
+            }
+        }
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(combinedPaths)) {
+            final String message = expectThrows(IllegalStateException.class,
+                () -> newPersistedClusterStateService(nodeEnvironment).loadBestOnDiskState()).getMessage();
+            assertThat(message,
+                allOf(containsString("mismatched cluster UUIDs in metadata"), containsString(clusterUUID1), containsString(clusterUUID2)));
+            assertTrue("[" + message + "] should match " + Arrays.toString(dataPaths1),
+                Arrays.stream(dataPaths1).anyMatch(p -> message.contains(p.toString())));
+            assertTrue("[" + message + "] should match " + Arrays.toString(dataPaths2),
+                Arrays.stream(dataPaths2).anyMatch(p -> message.contains(p.toString())));
+        }
+    }
+
+    public void testFailsIfFreshestStateIsInStaleTerm() throws IOException {
+        final Path[] dataPaths1 = createDataPaths();
+        final Path[] dataPaths2 = createDataPaths();
+        final Path[] combinedPaths = Stream.concat(Arrays.stream(dataPaths1), Arrays.stream(dataPaths2)).toArray(Path[]::new);
+
+        final long staleCurrentTerm = randomLongBetween(1L, Long.MAX_VALUE - 1);
+        final long freshCurrentTerm = randomLongBetween(staleCurrentTerm + 1, Long.MAX_VALUE);
+
+        final long freshTerm = randomLongBetween(1L, Long.MAX_VALUE);
+        final long staleTerm = randomBoolean() ? freshTerm : randomLongBetween(1L, freshTerm);
+        final long freshVersion = randomLongBetween(2L, Long.MAX_VALUE);
+        final long staleVersion = staleTerm == freshTerm ? randomLongBetween(1L, freshVersion - 1) : randomLongBetween(1L, Long.MAX_VALUE);
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(combinedPaths)) {
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                assertFalse(clusterState.metaData().clusterUUIDCommitted());
+                writeState(writer, staleCurrentTerm, ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData()).version(1)
+                        .coordinationMetaData(CoordinationMetaData.builder(clusterState.coordinationMetaData()).term(staleTerm).build()))
+                    .version(staleVersion)
+                    .build(),
+                    clusterState);
+            }
+        }
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(dataPaths1)) {
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                writeState(writer, freshCurrentTerm, clusterState, clusterState);
+            }
+        }
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(dataPaths2)) {
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final PersistedClusterStateService.OnDiskState onDiskState = newPersistedClusterStateService(nodeEnvironment)
+                    .loadBestOnDiskState();
+                final ClusterState clusterState = clusterStateFromMetadata(onDiskState.lastAcceptedVersion, onDiskState.metaData);
+                writeState(writer, onDiskState.currentTerm, ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData()).version(2)
+                        .coordinationMetaData(CoordinationMetaData.builder(clusterState.coordinationMetaData()).term(freshTerm).build()))
+                    .version(freshVersion)
+                    .build(), clusterState);
+            }
+        }
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(combinedPaths)) {
+            final String message = expectThrows(IllegalStateException.class,
+                () -> newPersistedClusterStateService(nodeEnvironment).loadBestOnDiskState()).getMessage();
+            assertThat(message, allOf(
+                    containsString("inconsistent terms found"),
+                    containsString(Long.toString(staleCurrentTerm)),
+                    containsString(Long.toString(freshCurrentTerm))));
+            assertTrue("[" + message + "] should match " + Arrays.toString(dataPaths1),
+                Arrays.stream(dataPaths1).anyMatch(p -> message.contains(p.toString())));
+            assertTrue("[" + message + "] should match " + Arrays.toString(dataPaths2),
+                Arrays.stream(dataPaths2).anyMatch(p -> message.contains(p.toString())));
+        }
+    }
+
+    public void testFailsGracefullyOnExceptionDuringFlush() throws IOException {
+        final AtomicBoolean throwException = new AtomicBoolean();
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            final PersistedClusterStateService persistedClusterStateService
+                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE) {
+                @Override
+                Directory createDirectory(Path path) throws IOException {
+                    return new FilterDirectory(super.createDirectory(path)) {
+                        @Override
+                        public IndexOutput createOutput(String name, IOContext context) throws IOException {
+                            if (throwException.get()) {
+                                throw new IOException("simulated");
+                            }
+                            return super.createOutput(name, context);
+                        }
+                    };
+                }
+            };
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+                final long newTerm = randomNonNegativeLong();
+                final ClusterState newState = ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .clusterUUID(UUIDs.randomBase64UUID(random()))
+                        .clusterUUIDCommitted(true)
+                        .version(randomLongBetween(1L, Long.MAX_VALUE)))
+                    .incrementVersion().build();
+                throwException.set(true);
+                assertThat(expectThrows(IOException.class, () ->
+                        writeState(writer, newTerm, newState, clusterState)).getMessage(),
+                    containsString("simulated"));
+            }
+        }
+    }
+
+    public void testClosesWriterOnFatalError() throws IOException {
+        final AtomicBoolean throwException = new AtomicBoolean();
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            final PersistedClusterStateService persistedClusterStateService
+                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE) {
+                @Override
+                Directory createDirectory(Path path) throws IOException {
+                    return new FilterDirectory(super.createDirectory(path)) {
+                        @Override
+                        public void sync(Collection<String> names) {
+                            throw new OutOfMemoryError("simulated");
+                        }
+                    };
+                }
+            };
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+                final long newTerm = randomNonNegativeLong();
+                final ClusterState newState = ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .clusterUUID(UUIDs.randomBase64UUID(random()))
+                        .clusterUUIDCommitted(true)
+                        .version(randomLongBetween(1L, Long.MAX_VALUE)))
+                    .incrementVersion().build();
+                throwException.set(true);
+                assertThat(expectThrows(OutOfMemoryError.class, () -> {
+                        if (randomBoolean()) {
+                            writeState(writer, newTerm, newState, clusterState);
+                        } else {
+                            writer.commit(newTerm, newState.version());
+                        }
+                    }).getMessage(),
+                    containsString("simulated"));
+                assertFalse(writer.isOpen());
+            }
+
+            // check if we can open writer again
+            try (Writer ignored = persistedClusterStateService.createWriter()) {
+
+            }
+        }
+    }
+
+    public void testCrashesWithIOErrorOnCommitFailure() throws IOException {
+        final AtomicBoolean throwException = new AtomicBoolean();
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            final PersistedClusterStateService persistedClusterStateService
+                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE) {
+                @Override
+                Directory createDirectory(Path path) throws IOException {
+                    return new FilterDirectory(super.createDirectory(path)) {
+                        @Override
+                        public void rename(String source, String dest) throws IOException {
+                            if (throwException.get() && dest.startsWith("segments")) {
+                                throw new IOException("simulated");
+                            }
+                        }
+                    };
+                }
+            };
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+                final long newTerm = randomNonNegativeLong();
+                final ClusterState newState = ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .clusterUUID(UUIDs.randomBase64UUID(random()))
+                        .clusterUUIDCommitted(true)
+                        .version(randomLongBetween(1L, Long.MAX_VALUE)))
+                    .incrementVersion().build();
+                throwException.set(true);
+                assertThat(expectThrows(IOError.class, () -> {
+                        if (randomBoolean()) {
+                            writeState(writer, newTerm, newState, clusterState);
+                        } else {
+                            writer.commit(newTerm, newState.version());
+                        }
+                    }).getMessage(),
+                    containsString("simulated"));
+                assertFalse(writer.isOpen());
+            }
+
+            // check if we can open writer again
+            try (Writer ignored = persistedClusterStateService.createWriter()) {
+
+            }
+        }
+    }
+
+    public void testFailsIfGlobalMetadataIsMissing() throws IOException {
+        // if someone attempted surgery on the metadata index by hand, e.g. deleting broken segments, then maybe the global metadata
+        // isn't there any more
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                writeState(writer, 0L, ClusterState.builder(clusterState).version(randomLongBetween(1L, Long.MAX_VALUE)).build(),
+                    clusterState);
+            }
+
+            final Path brokenPath = randomFrom(nodeEnvironment.nodeDataPaths());
+            try (Directory directory = new SimpleFSDirectory(brokenPath.resolve(PersistedClusterStateService.METADATA_DIRECTORY_NAME))) {
+                final IndexWriterConfig indexWriterConfig = new IndexWriterConfig();
+                indexWriterConfig.setOpenMode(IndexWriterConfig.OpenMode.CREATE);
+                try (IndexWriter indexWriter = new IndexWriter(directory, indexWriterConfig)) {
+                    indexWriter.commit();
+                }
+            }
+
+            final String message = expectThrows(IllegalStateException.class,
+                () -> newPersistedClusterStateService(nodeEnvironment).loadBestOnDiskState()).getMessage();
+            assertThat(message, allOf(containsString("no global metadata found"), containsString(brokenPath.toString())));
+        }
+    }
+
+    public void testFailsIfGlobalMetadataIsDuplicated() throws IOException {
+        // if someone attempted surgery on the metadata index by hand, e.g. deleting broken segments, then maybe the global metadata
+        // is duplicated
+
+        final Path[] dataPaths1 = createDataPaths();
+        final Path[] dataPaths2 = createDataPaths();
+        final Path[] combinedPaths = Stream.concat(Arrays.stream(dataPaths1), Arrays.stream(dataPaths2)).toArray(Path[]::new);
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(combinedPaths)) {
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                writeState(writer, 0L, ClusterState.builder(clusterState).version(randomLongBetween(1L, Long.MAX_VALUE)).build(),
+                    clusterState);
+            }
+
+            final Path brokenPath = randomFrom(nodeEnvironment.nodeDataPaths());
+            final Path dupPath = randomValueOtherThan(brokenPath, () -> randomFrom(nodeEnvironment.nodeDataPaths()));
+            try (Directory directory = new SimpleFSDirectory(brokenPath.resolve(PersistedClusterStateService.METADATA_DIRECTORY_NAME));
+                 Directory dupDirectory = new SimpleFSDirectory(dupPath.resolve(PersistedClusterStateService.METADATA_DIRECTORY_NAME))) {
+                try (IndexWriter indexWriter = new IndexWriter(directory, new IndexWriterConfig())) {
+                    indexWriter.addIndexes(dupDirectory);
+                    indexWriter.commit();
+                }
+            }
+
+            final String message = expectThrows(IllegalStateException.class,
+                () -> newPersistedClusterStateService(nodeEnvironment).loadBestOnDiskState()).getMessage();
+            assertThat(message, allOf(containsString("duplicate global metadata found"), containsString(brokenPath.toString())));
+        }
+    }
+
+    public void testFailsIfIndexMetadataIsDuplicated() throws IOException {
+        // if someone attempted surgery on the metadata index by hand, e.g. deleting broken segments, then maybe some index metadata
+        // is duplicated
+
+        final Path[] dataPaths1 = createDataPaths();
+        final Path[] dataPaths2 = createDataPaths();
+        final Path[] combinedPaths = Stream.concat(Arrays.stream(dataPaths1), Arrays.stream(dataPaths2)).toArray(Path[]::new);
+
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(combinedPaths)) {
+            final String indexUUID = UUIDs.randomBase64UUID(random());
+            final String indexName = randomAlphaOfLength(10);
+
+            try (Writer writer = newPersistedClusterStateService(nodeEnvironment).createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(newPersistedClusterStateService(nodeEnvironment));
+                writeState(writer, 0L, ClusterState.builder(clusterState)
+                        .metaData(MetaData.builder(clusterState.metaData())
+                            .version(1L)
+                            .coordinationMetaData(CoordinationMetaData.builder(clusterState.coordinationMetaData()).term(1L).build())
+                            .put(IndexMetaData.builder(indexName)
+                                .version(1L)
+                                .settings(Settings.builder()
+                                    .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                                    .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
+                                    .put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), Version.CURRENT)
+                                    .put(IndexMetaData.SETTING_INDEX_UUID, indexUUID))))
+                        .incrementVersion().build(),
+                    clusterState);
+            }
+
+            final Path brokenPath = randomFrom(nodeEnvironment.nodeDataPaths());
+            final Path dupPath = randomValueOtherThan(brokenPath, () -> randomFrom(nodeEnvironment.nodeDataPaths()));
+            try (Directory directory = new SimpleFSDirectory(brokenPath.resolve(PersistedClusterStateService.METADATA_DIRECTORY_NAME));
+                 Directory dupDirectory = new SimpleFSDirectory(dupPath.resolve(PersistedClusterStateService.METADATA_DIRECTORY_NAME))) {
+                try (IndexWriter indexWriter = new IndexWriter(directory, new IndexWriterConfig())) {
+                    indexWriter.deleteDocuments(new Term("type", "global")); // do not duplicate global metadata
+                    indexWriter.addIndexes(dupDirectory);
+                    indexWriter.commit();
+                }
+            }
+
+            final String message = expectThrows(IllegalStateException.class,
+                () -> newPersistedClusterStateService(nodeEnvironment).loadBestOnDiskState()).getMessage();
+            assertThat(message, allOf(
+                containsString("duplicate metadata found"),
+                containsString(brokenPath.toString()),
+                containsString(indexName),
+                containsString(indexUUID)));
+        }
+    }
+
+    public void testPersistsAndReloadsIndexMetadataIffVersionOrTermChanges() throws IOException {
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            final PersistedClusterStateService persistedClusterStateService = newPersistedClusterStateService(nodeEnvironment);
+            final long globalVersion = randomLongBetween(1L, Long.MAX_VALUE);
+            final String indexUUID = UUIDs.randomBase64UUID(random());
+            final long indexMetaDataVersion = randomLongBetween(1L, Long.MAX_VALUE);
+
+            final long oldTerm = randomLongBetween(1L, Long.MAX_VALUE - 1);
+            final long newTerm = randomLongBetween(oldTerm + 1, Long.MAX_VALUE);
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+                writeState(writer, 0L, ClusterState.builder(clusterState)
+                        .metaData(MetaData.builder(clusterState.metaData())
+                            .version(globalVersion)
+                            .coordinationMetaData(CoordinationMetaData.builder(clusterState.coordinationMetaData()).term(oldTerm).build())
+                            .put(IndexMetaData.builder("test")
+                                .version(indexMetaDataVersion - 1) // -1 because it's incremented in .put()
+                                .settings(Settings.builder()
+                                    .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                                    .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
+                                    .put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), Version.CURRENT)
+                                    .put(IndexMetaData.SETTING_INDEX_UUID, indexUUID))))
+                        .incrementVersion().build(),
+                    clusterState);
+
+
+                clusterState = loadPersistedClusterState(persistedClusterStateService);
+                IndexMetaData indexMetaData = clusterState.metaData().index("test");
+                assertThat(indexMetaData.getIndexUUID(), equalTo(indexUUID));
+                assertThat(indexMetaData.getVersion(), equalTo(indexMetaDataVersion));
+                assertThat(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.get(indexMetaData.getSettings()), equalTo(0));
+                // ensure we do not wastefully persist the same index metadata version by making a bad update with the same version
+                writer.writeIncrementalStateAndCommit(0L, clusterState, ClusterState.builder(clusterState)
+                        .metaData(MetaData.builder(clusterState.metaData())
+                            .put(IndexMetaData.builder(indexMetaData).settings(Settings.builder()
+                                .put(indexMetaData.getSettings())
+                                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 1)).build(), false))
+                        .incrementVersion().build());
+
+                clusterState = loadPersistedClusterState(persistedClusterStateService);
+                indexMetaData = clusterState.metaData().index("test");
+                assertThat(indexMetaData.getIndexUUID(), equalTo(indexUUID));
+                assertThat(indexMetaData.getVersion(), equalTo(indexMetaDataVersion));
+                assertThat(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.get(indexMetaData.getSettings()), equalTo(0));
+                // ensure that we do persist the same index metadata version by making an update with a higher version
+                writeState(writer, 0L, ClusterState.builder(clusterState)
+                        .metaData(MetaData.builder(clusterState.metaData())
+                            .put(IndexMetaData.builder(indexMetaData).settings(Settings.builder()
+                                .put(indexMetaData.getSettings())
+                                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 2)).build(), true))
+                        .incrementVersion().build(),
+                    clusterState);
+
+                clusterState = loadPersistedClusterState(persistedClusterStateService);
+                indexMetaData = clusterState.metaData().index("test");
+                assertThat(indexMetaData.getVersion(), equalTo(indexMetaDataVersion + 1));
+                assertThat(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.get(indexMetaData.getSettings()), equalTo(2));
+                // ensure that we also persist the index metadata when the term changes
+                writeState(writer, 0L, ClusterState.builder(clusterState)
+                        .metaData(MetaData.builder(clusterState.metaData())
+                            .coordinationMetaData(CoordinationMetaData.builder(clusterState.coordinationMetaData()).term(newTerm).build())
+                            .put(IndexMetaData.builder(indexMetaData).settings(Settings.builder()
+                                .put(indexMetaData.getSettings())
+                                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 3)).build(), false))
+                        .incrementVersion().build(),
+                    clusterState);
+            }
+
+            final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+            final IndexMetaData indexMetaData = clusterState.metaData().index("test");
+            assertThat(indexMetaData.getIndexUUID(), equalTo(indexUUID));
+            assertThat(indexMetaData.getVersion(), equalTo(indexMetaDataVersion + 1));
+            assertThat(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.get(indexMetaData.getSettings()), equalTo(3));
+        }
+    }
+
+    public void testPersistsAndReloadsIndexMetadataForMultipleIndices() throws IOException {
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            final PersistedClusterStateService persistedClusterStateService = newPersistedClusterStateService(nodeEnvironment);
+
+            final long term = randomLongBetween(1L, Long.MAX_VALUE);
+            final String addedIndexUuid = UUIDs.randomBase64UUID(random());
+            final String updatedIndexUuid = UUIDs.randomBase64UUID(random());
+            final String deletedIndexUuid = UUIDs.randomBase64UUID(random());
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+                writeState(writer, 0L, ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .version(clusterState.metaData().version() + 1)
+                        .coordinationMetaData(CoordinationMetaData.builder(clusterState.coordinationMetaData()).term(term).build())
+                        .put(IndexMetaData.builder("updated")
+                            .version(randomLongBetween(0L, Long.MAX_VALUE - 1) - 1) // -1 because it's incremented in .put()
+                            .settings(Settings.builder()
+                                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 1)
+                                .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                                .put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), Version.CURRENT)
+                                .put(IndexMetaData.SETTING_INDEX_UUID, updatedIndexUuid)))
+                    .put(IndexMetaData.builder("deleted")
+                        .version(randomLongBetween(0L, Long.MAX_VALUE - 1) - 1) // -1 because it's incremented in .put()
+                        .settings(Settings.builder()
+                            .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 1)
+                            .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                            .put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), Version.CURRENT)
+                            .put(IndexMetaData.SETTING_INDEX_UUID, deletedIndexUuid))))
+                    .incrementVersion().build(),
+                    clusterState);
+            }
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+
+                assertThat(clusterState.metaData().indices().size(), equalTo(2));
+                assertThat(clusterState.metaData().index("updated").getIndexUUID(), equalTo(updatedIndexUuid));
+                assertThat(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.get(clusterState.metaData().index("updated").getSettings()),
+                    equalTo(1));
+                assertThat(clusterState.metaData().index("deleted").getIndexUUID(), equalTo(deletedIndexUuid));
+
+                writeState(writer, 0L, ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .version(clusterState.metaData().version() + 1)
+                        .remove("deleted")
+                        .put(IndexMetaData.builder("updated")
+                            .settings(Settings.builder()
+                                .put(clusterState.metaData().index("updated").getSettings())
+                                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 2)))
+                        .put(IndexMetaData.builder("added")
+                            .version(randomLongBetween(0L, Long.MAX_VALUE - 1) - 1) // -1 because it's incremented in .put()
+                            .settings(Settings.builder()
+                                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 1)
+                                .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                                .put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), Version.CURRENT)
+                                .put(IndexMetaData.SETTING_INDEX_UUID, addedIndexUuid))))
+                    .incrementVersion().build(),
+                    clusterState);
+            }
+
+            final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+
+            assertThat(clusterState.metaData().indices().size(), equalTo(2));
+            assertThat(clusterState.metaData().index("updated").getIndexUUID(), equalTo(updatedIndexUuid));
+            assertThat(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.get(clusterState.metaData().index("updated").getSettings()),
+                equalTo(2));
+            assertThat(clusterState.metaData().index("added").getIndexUUID(), equalTo(addedIndexUuid));
+            assertThat(clusterState.metaData().index("deleted"), nullValue());
+        }
+    }
+
+    public void testReloadsMetadataAcrossMultipleSegments() throws IOException {
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            final PersistedClusterStateService persistedClusterStateService = newPersistedClusterStateService(nodeEnvironment);
+
+            final int writes = between(5, 20);
+            final List<Index> indices = new ArrayList<>(writes);
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                for (int i = 0; i < writes; i++) {
+                    final Index index = new Index("test-" + i, UUIDs.randomBase64UUID(random()));
+                    indices.add(index);
+                    final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+                    writeState(writer, 0L, ClusterState.builder(clusterState)
+                        .metaData(MetaData.builder(clusterState.metaData())
+                            .version(i + 2)
+                            .put(IndexMetaData.builder(index.getName())
+                                .settings(Settings.builder()
+                                    .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                                    .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
+                                    .put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), Version.CURRENT)
+                                    .put(IndexMetaData.SETTING_INDEX_UUID, index.getUUID()))))
+                        .incrementVersion().build(),
+                        clusterState);
+                }
+            }
+
+            final ClusterState clusterState = loadPersistedClusterState(persistedClusterStateService);
+            for (Index index : indices) {
+                final IndexMetaData indexMetaData = clusterState.metaData().index(index.getName());
+                assertThat(indexMetaData.getIndexUUID(), equalTo(index.getUUID()));
+            }
+        }
+    }
+
+    @Override
+    public Settings buildEnvSettings(Settings settings) {
+        assertTrue(settings.hasValue(Environment.PATH_DATA_SETTING.getKey()));
+        return Settings.builder()
+            .put(settings)
+            .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toAbsolutePath()).build();
+    }
+
+    public static Path[] createDataPaths() {
+        final Path[] dataPaths = new Path[randomIntBetween(1, 4)];
+        for (int i = 0; i < dataPaths.length; i++) {
+            dataPaths[i] = createTempDir();
+        }
+        return dataPaths;
+    }
+
+    private NodeEnvironment newNodeEnvironment(Path[] dataPaths) throws IOException {
+        return newNodeEnvironment(Settings.builder()
+            .putList(Environment.PATH_DATA_SETTING.getKey(), Arrays.stream(dataPaths).map(Path::toString).collect(Collectors.toList()))
+            .build());
+    }
+
+    private static ClusterState loadPersistedClusterState(PersistedClusterStateService persistedClusterStateService) throws IOException {
+        final PersistedClusterStateService.OnDiskState onDiskState = persistedClusterStateService.loadBestOnDiskState();
+        return clusterStateFromMetadata(onDiskState.lastAcceptedVersion, onDiskState.metaData);
+    }
+
+    private static ClusterState clusterStateFromMetadata(long version, MetaData metaData) {
+        return ClusterState.builder(ClusterName.DEFAULT).version(version).metaData(metaData).build();
+    }
+
+
+}
diff --git a/server/src/test/java/org/elasticsearch/index/seqno/PeerRecoveryRetentionLeaseCreationIT.java b/server/src/test/java/org/elasticsearch/index/seqno/PeerRecoveryRetentionLeaseCreationIT.java
index 03842d11b1a40..1d1455348e051 100644
--- a/server/src/test/java/org/elasticsearch/index/seqno/PeerRecoveryRetentionLeaseCreationIT.java
+++ b/server/src/test/java/org/elasticsearch/index/seqno/PeerRecoveryRetentionLeaseCreationIT.java
@@ -42,6 +42,7 @@ protected boolean forbidPrivateIndexSettings() {
         return false;
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/48701")
     public void testCanRecoverFromStoreWithoutPeerRecoveryRetentionLease() throws Exception {
         /*
          * In a full cluster restart from a version without peer-recovery retention leases, the leases on disk will not include a lease for
diff --git a/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandIT.java b/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandIT.java
index b3cee099984c8..fa1c070b28277 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandIT.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandIT.java
@@ -56,6 +56,7 @@
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.env.TestEnvironment;
+import org.elasticsearch.gateway.GatewayMetaState;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.MergePolicyConfig;
@@ -155,8 +156,8 @@ public void testCorruptIndex() throws Exception {
             fail("expected the command to fail as node is locked");
         } catch (Exception e) {
             assertThat(e.getMessage(),
-                allOf(containsString("Failed to lock node's directory"),
-                    containsString("is Elasticsearch still running ?")));
+                allOf(containsString("failed to lock node's directory"),
+                    containsString("is Elasticsearch still running?")));
         }
 
         final Path indexDir = getPathToShardData(indexName, ShardPath.INDEX_FOLDER_NAME);
@@ -478,6 +479,9 @@ public void testCorruptTranslogTruncationOfReplica() throws Exception {
         final Settings node1PathSettings = internalCluster().dataPathSettings(node1);
         final Settings node2PathSettings = internalCluster().dataPathSettings(node2);
 
+        assertBusy(() -> internalCluster().getInstances(GatewayMetaState.class)
+            .forEach(gw -> assertTrue(gw.allPendingAsyncStatesWritten())));
+
         // stop data nodes
         internalCluster().stopRandomDataNode();
         internalCluster().stopRandomDataNode();
@@ -573,8 +577,8 @@ public void testResolvePath() throws Exception {
         for (String nodeName : nodeNames) {
             final Path indexPath = indexPathByNodeName.get(nodeName);
             final OptionSet options = parser.parse("--dir", indexPath.toAbsolutePath().toString());
-            command.findAndProcessShardPath(options, environmentByNodeName.get(nodeName),
-                shardPath -> assertThat(shardPath.resolveIndex(), equalTo(indexPath)));
+            command.findAndProcessShardPath(options, environmentByNodeName.get(nodeName), environmentByNodeName.get(nodeName).dataFiles(),
+                state, shardPath -> assertThat(shardPath.resolveIndex(), equalTo(indexPath)));
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandTests.java b/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandTests.java
index df7423fc8577e..4911ff934377a 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandTests.java
@@ -30,19 +30,25 @@
 import org.elasticsearch.action.admin.indices.rollover.RolloverInfo;
 import org.elasticsearch.cli.MockTerminal;
 import org.elasticsearch.cli.Terminal;
+import org.elasticsearch.cluster.ClusterName;
+import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.routing.RecoverySource;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.routing.ShardRoutingHelper;
 import org.elasticsearch.cluster.routing.ShardRoutingState;
 import org.elasticsearch.cluster.routing.TestShardRouting;
 import org.elasticsearch.common.CheckedFunction;
+import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.env.TestEnvironment;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.MergePolicyConfig;
 import org.elasticsearch.index.engine.EngineException;
@@ -60,6 +66,7 @@
 import java.nio.file.Path;
 import java.util.Arrays;
 import java.util.Collections;
+import java.util.Objects;
 import java.util.Set;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
@@ -80,7 +87,9 @@ public class RemoveCorruptedShardDataCommandTests extends IndexShardTestCase {
     private Environment environment;
     private ShardPath shardPath;
     private IndexMetaData indexMetaData;
+    private ClusterState clusterState;
     private IndexShard indexShard;
+    private Path[] dataPaths;
     private Path translogPath;
     private Path indexPath;
 
@@ -89,7 +98,7 @@ public class RemoveCorruptedShardDataCommandTests extends IndexShardTestCase {
 
     @Before
     public void setup() throws IOException {
-        shardId = new ShardId("index0", "_na_", 0);
+        shardId = new ShardId("index0", UUIDs.randomBase64UUID(), 0);
         final String nodeId = randomAlphaOfLength(10);
         routing = TestShardRouting.newShardRouting(shardId, nodeId, true, ShardRoutingState.INITIALIZING,
             RecoverySource.EmptyStoreRecoverySource.INSTANCE);
@@ -103,11 +112,13 @@ public void setup() throws IOException {
 
         // create same directory structure as prod does
         Files.createDirectories(dataDir);
+        dataPaths = new Path[] {dataDir};
         final Settings settings = Settings.builder()
             .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(MergePolicyConfig.INDEX_MERGE_ENABLED, false)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
+            .put(IndexMetaData.SETTING_INDEX_UUID, shardId.getIndex().getUUID())
             .build();
 
         final NodeEnvironment.NodePath nodePath = new NodeEnvironment.NodePath(dataDir);
@@ -135,6 +146,16 @@ public void setup() throws IOException {
             .putMapping("{ \"properties\": {} }");
         indexMetaData = metaData.build();
 
+        clusterState = ClusterState.builder(ClusterName.DEFAULT).metaData(MetaData.builder().put(indexMetaData, false).build()).build();
+
+        try (NodeEnvironment.NodeLock lock = new NodeEnvironment.NodeLock(logger, environment, Files::exists)) {
+            final Path[] dataPaths = Arrays.stream(lock.getNodePaths()).filter(Objects::nonNull).map(p -> p.path).toArray(Path[]::new);
+            try (PersistedClusterStateService.Writer writer = new PersistedClusterStateService(dataPaths, nodeId,
+                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE, true).createWriter()) {
+                writer.writeFullStateAndCommit(1L, clusterState);
+            }
+        }
+
         indexShard = newStartedShard(p -> newShard(routing, shardPath, indexMetaData, null, null,
             new InternalEngineFactory(), () -> { }, RetentionLeaseSyncer.EMPTY, EMPTY_EVENT_LISTENER), true);
 
@@ -355,7 +376,6 @@ public void testResolveIndexDirectory() throws Exception {
         // index a single doc to have files on a disk
         indexDoc(indexShard, "_doc", "0", "{}");
         flushShard(indexShard, true);
-        writeIndexState();
 
         // close shard
         closeShards(indexShard);
@@ -367,11 +387,11 @@ public void testResolveIndexDirectory() throws Exception {
         final OptionSet options = parser.parse("--index", shardId.getIndex().getName(),
             "--shard-id", Integer.toString(shardId.id()));
 
-        command.findAndProcessShardPath(options, environment,
+        command.findAndProcessShardPath(options, environment, dataPaths, clusterState,
             shardPath -> assertThat(shardPath.resolveIndex(), equalTo(indexPath)));
 
         final OptionSet options2 = parser.parse("--dir", indexPath.toAbsolutePath().toString());
-        command.findAndProcessShardPath(options2, environment,
+        command.findAndProcessShardPath(options2, environment, dataPaths, clusterState,
             shardPath -> assertThat(shardPath.resolveIndex(), equalTo(indexPath)));
     }
 
@@ -509,17 +529,7 @@ private int indexDocs(IndexShard indexShard, boolean flushLast) throws IOExcepti
 
         logger.info("--> indexed {} docs, {} to keep", numDocs, numDocsToKeep);
 
-        writeIndexState();
         return numDocsToKeep;
     }
 
-    private void writeIndexState() throws IOException {
-        // create _state of IndexMetaData
-        try(NodeEnvironment nodeEnvironment = new NodeEnvironment(environment.settings(), environment)) {
-            final Path[] paths = nodeEnvironment.indexPaths(indexMetaData.getIndex());
-            IndexMetaData.FORMAT.writeAndCleanup(indexMetaData, paths);
-            logger.info("--> index metadata persisted to {} ", Arrays.toString(paths));
-        }
-    }
-
 }
diff --git a/server/src/test/java/org/elasticsearch/indices/IndicesLifecycleListenerSingleNodeTests.java b/server/src/test/java/org/elasticsearch/indices/IndicesLifecycleListenerSingleNodeTests.java
index 436126930e3d1..b3fdd53ee8f15 100644
--- a/server/src/test/java/org/elasticsearch/indices/IndicesLifecycleListenerSingleNodeTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/IndicesLifecycleListenerSingleNodeTests.java
@@ -122,7 +122,7 @@ public void afterIndexRemoved(Index index, IndexSettings indexSettings, IndexRem
         };
         indicesService.removeIndex(idx, DELETED, "simon says");
         try {
-            IndexService index = indicesService.createIndex(metaData, Arrays.asList(countingListener));
+            IndexService index = indicesService.createIndex(metaData, Arrays.asList(countingListener), false);
             assertEquals(3, counter.get());
             idx = index.index();
             ShardRouting newRouting = shardRouting;
diff --git a/server/src/test/java/org/elasticsearch/indices/IndicesServiceTests.java b/server/src/test/java/org/elasticsearch/indices/IndicesServiceTests.java
index bd35f0f1783ca..ea41f14a53af3 100644
--- a/server/src/test/java/org/elasticsearch/indices/IndicesServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/IndicesServiceTests.java
@@ -223,13 +223,11 @@ public void testDeleteIndexStore() throws Exception {
         ClusterService clusterService = getInstanceFromNode(ClusterService.class);
         IndexMetaData firstMetaData = clusterService.state().metaData().index("test");
         assertTrue(test.hasShard(0));
+        ShardPath firstPath = ShardPath.loadShardPath(logger, getNodeEnvironment(), new ShardId(test.index(), 0),
+            test.getIndexSettings().customDataPath());
 
-        try {
-            indicesService.deleteIndexStore("boom", firstMetaData, clusterService.state());
-            fail();
-        } catch (IllegalStateException ex) {
-            // all good
-        }
+        expectThrows(IllegalStateException.class, () -> indicesService.deleteIndexStore("boom", firstMetaData));
+        assertTrue(firstPath.exists());
 
         GatewayMetaState gwMetaState = getInstanceFromNode(GatewayMetaState.class);
         MetaData meta = gwMetaState.getMetaData();
@@ -237,37 +235,25 @@ public void testDeleteIndexStore() throws Exception {
         assertNotNull(meta.index("test"));
         assertAcked(client().admin().indices().prepareDelete("test"));
 
+        assertFalse(firstPath.exists());
+
         meta = gwMetaState.getMetaData();
         assertNotNull(meta);
         assertNull(meta.index("test"));
 
-
         test = createIndex("test");
         client().prepareIndex("test").setId("1").setSource("field", "value").setRefreshPolicy(IMMEDIATE).get();
         client().admin().indices().prepareFlush("test").get();
         assertHitCount(client().prepareSearch("test").get(), 1);
         IndexMetaData secondMetaData = clusterService.state().metaData().index("test");
         assertAcked(client().admin().indices().prepareClose("test"));
-        ShardPath path = ShardPath.loadShardPath(logger, getNodeEnvironment(), new ShardId(test.index(), 0),
+        ShardPath secondPath = ShardPath.loadShardPath(logger, getNodeEnvironment(), new ShardId(test.index(), 0),
             test.getIndexSettings().customDataPath());
-        assertTrue(path.exists());
+        assertTrue(secondPath.exists());
 
-        try {
-            indicesService.deleteIndexStore("boom", secondMetaData, clusterService.state());
-            fail();
-        } catch (IllegalStateException ex) {
-            // all good
-        }
-
-        assertTrue(path.exists());
+        expectThrows(IllegalStateException.class, () -> indicesService.deleteIndexStore("boom", secondMetaData));
+        assertTrue(secondPath.exists());
 
-        // now delete the old one and make sure we resolve against the name
-        try {
-            indicesService.deleteIndexStore("boom", firstMetaData, clusterService.state());
-            fail();
-        } catch (IllegalStateException ex) {
-            // all good
-        }
         assertAcked(client().admin().indices().prepareOpen("test"));
         ensureGreen("test");
     }
@@ -563,7 +549,7 @@ public void testGetEngineFactory() throws IOException {
                     .numberOfShards(1)
                     .numberOfReplicas(0)
                     .build();
-            final IndexService indexService = indicesService.createIndex(indexMetaData, Collections.emptyList());
+            final IndexService indexService = indicesService.createIndex(indexMetaData, Collections.emptyList(), false);
             if (value != null && value) {
                 assertThat(indexService.getEngineFactory(), instanceOf(FooEnginePlugin.FooEngineFactory.class));
             } else {
@@ -589,7 +575,7 @@ public void testConflictingEngineFactories() {
 
         final IndicesService indicesService = getIndicesService();
         final IllegalStateException e =
-                expectThrows(IllegalStateException.class, () -> indicesService.createIndex(indexMetaData, Collections.emptyList()));
+                expectThrows(IllegalStateException.class, () -> indicesService.createIndex(indexMetaData, Collections.emptyList(), false));
         final String pattern =
                 ".*multiple engine factories provided for \\[foobar/.*\\]: \\[.*FooEngineFactory\\],\\[.*BarEngineFactory\\].*";
         assertThat(e, hasToString(new RegexMatcher(pattern)));
diff --git a/server/src/test/java/org/elasticsearch/indices/cluster/AbstractIndicesClusterStateServiceTestCase.java b/server/src/test/java/org/elasticsearch/indices/cluster/AbstractIndicesClusterStateServiceTestCase.java
index 80cf443e5007e..d7b94e26eff9e 100644
--- a/server/src/test/java/org/elasticsearch/indices/cluster/AbstractIndicesClusterStateServiceTestCase.java
+++ b/server/src/test/java/org/elasticsearch/indices/cluster/AbstractIndicesClusterStateServiceTestCase.java
@@ -195,7 +195,8 @@ protected class MockIndicesService implements AllocatedIndices<MockIndexShard, M
         @Override
         public synchronized MockIndexService createIndex(
                 IndexMetaData indexMetaData,
-                List<IndexEventListener> buildInIndexListener) throws IOException {
+                List<IndexEventListener> buildInIndexListener,
+                boolean writeDanglingIndices) throws IOException {
             MockIndexService indexService = new MockIndexService(new IndexSettings(indexMetaData, Settings.EMPTY));
             indices = Maps.copyMapWithAddedEntry(indices, indexMetaData.getIndexUUID(), indexService);
             return indexService;
diff --git a/server/src/test/java/org/elasticsearch/indices/cluster/ClusterStateChanges.java b/server/src/test/java/org/elasticsearch/indices/cluster/ClusterStateChanges.java
index 74b94ad3a16b4..901409739c1d6 100644
--- a/server/src/test/java/org/elasticsearch/indices/cluster/ClusterStateChanges.java
+++ b/server/src/test/java/org/elasticsearch/indices/cluster/ClusterStateChanges.java
@@ -110,6 +110,7 @@
 import static org.hamcrest.Matchers.notNullValue;
 import static org.junit.Assert.assertThat;
 import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.anyBoolean;
 import static org.mockito.Matchers.anyList;
 import static org.mockito.Matchers.anyString;
 import static org.mockito.Mockito.doAnswer;
@@ -163,7 +164,7 @@ public ClusterStateChanges(NamedXContentRegistry xContentRegistry, ThreadPool th
         // MetaDataCreateIndexService creates indices using its IndicesService instance to check mappings -> fake it here
         try {
             @SuppressWarnings("unchecked") final List<IndexEventListener> listeners = anyList();
-            when(indicesService.createIndex(any(IndexMetaData.class), listeners))
+            when(indicesService.createIndex(any(IndexMetaData.class), listeners, anyBoolean()))
                 .then(invocationOnMock -> {
                     IndexService indexService = mock(IndexService.class);
                     IndexMetaData indexMetaData = (IndexMetaData)invocationOnMock.getArguments()[0];
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java b/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java
index ba77877f7f67d..5dbb34df24a54 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/DanglingIndicesIT.java
@@ -20,6 +20,7 @@
 package org.elasticsearch.indices.recovery;
 
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.ESIntegTestCase.ClusterScope;
 import org.elasticsearch.test.InternalTestCluster;
@@ -29,16 +30,18 @@
 import static org.elasticsearch.cluster.metadata.IndexGraveyard.SETTING_MAX_TOMBSTONES;
 import static org.elasticsearch.gateway.DanglingIndicesState.AUTO_IMPORT_DANGLING_INDICES_SETTING;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+import static org.hamcrest.Matchers.equalTo;
 
 @ClusterScope(numDataNodes = 0, scope = ESIntegTestCase.Scope.TEST)
 public class DanglingIndicesIT extends ESIntegTestCase {
     private static final String INDEX_NAME = "test-idx-1";
 
-    private Settings buildSettings(boolean importDanglingIndices) {
+    private Settings buildSettings(boolean writeDanglingIndices, boolean importDanglingIndices) {
         return Settings.builder()
             // Don't keep any indices in the graveyard, so that when we delete an index,
             // it's definitely considered to be dangling.
             .put(SETTING_MAX_TOMBSTONES.getKey(), 0)
+            .put(IndicesService.WRITE_DANGLING_INDICES_INFO_SETTING.getKey(), writeDanglingIndices)
             .put(AUTO_IMPORT_DANGLING_INDICES_SETTING.getKey(), importDanglingIndices)
             .build();
     }
@@ -48,10 +51,21 @@ private Settings buildSettings(boolean importDanglingIndices) {
      * the cluster, so long as the recovery setting is enabled.
      */
     public void testDanglingIndicesAreRecoveredWhenSettingIsEnabled() throws Exception {
-        final Settings settings = buildSettings(true);
+        final Settings settings = buildSettings(true, true);
         internalCluster().startNodes(3, settings);
 
         createIndex(INDEX_NAME, Settings.builder().put("number_of_replicas", 2).build());
+        ensureGreen(INDEX_NAME);
+        assertBusy(() -> internalCluster().getInstances(IndicesService.class).forEach(
+            indicesService -> assertTrue(indicesService.allPendingDanglingIndicesWritten())));
+
+        boolean refreshIntervalChanged = randomBoolean();
+        if (refreshIntervalChanged) {
+            client().admin().indices().prepareUpdateSettings(INDEX_NAME).setSettings(
+                Settings.builder().put("index.refresh_interval", "42s").build()).get();
+            assertBusy(() -> internalCluster().getInstances(IndicesService.class).forEach(
+                indicesService -> assertTrue(indicesService.allPendingDanglingIndicesWritten())));
+        }
 
         if (randomBoolean()) {
             client().admin().indices().prepareClose(INDEX_NAME).get();
@@ -63,12 +77,17 @@ public void testDanglingIndicesAreRecoveredWhenSettingIsEnabled() throws Excepti
 
             @Override
             public Settings onNodeStopped(String nodeName) throws Exception {
+                ensureClusterSizeConsistency();
                 assertAcked(client().admin().indices().prepareDelete(INDEX_NAME));
                 return super.onNodeStopped(nodeName);
             }
         });
 
         assertBusy(() -> assertTrue("Expected dangling index " + INDEX_NAME + " to be recovered", indexExists(INDEX_NAME)));
+        if (refreshIntervalChanged) {
+            assertThat(client().admin().indices().prepareGetSettings(INDEX_NAME).get().getSetting(INDEX_NAME, "index.refresh_interval"),
+                equalTo("42s"));
+        }
         ensureGreen(INDEX_NAME);
     }
 
@@ -77,15 +96,49 @@ public Settings onNodeStopped(String nodeName) throws Exception {
      * the cluster when the recovery setting is disabled.
      */
     public void testDanglingIndicesAreNotRecoveredWhenSettingIsDisabled() throws Exception {
-        internalCluster().startNodes(3, buildSettings(false));
+        internalCluster().startNodes(3, buildSettings(true, false));
+
+        createIndex(INDEX_NAME, Settings.builder().put("number_of_replicas", 2).build());
+        ensureGreen(INDEX_NAME);
+        assertBusy(() -> internalCluster().getInstances(IndicesService.class).forEach(
+            indicesService -> assertTrue(indicesService.allPendingDanglingIndicesWritten())));
+
+        // Restart node, deleting the index in its absence, so that there is a dangling index to recover
+        internalCluster().restartRandomDataNode(new InternalTestCluster.RestartCallback() {
+
+            @Override
+            public Settings onNodeStopped(String nodeName) throws Exception {
+                ensureClusterSizeConsistency();
+                assertAcked(client().admin().indices().prepareDelete(INDEX_NAME));
+                return super.onNodeStopped(nodeName);
+            }
+        });
+
+        // Since index recovery is async, we can't prove index recovery will never occur, just that it doesn't occur within some reasonable
+        // amount of time
+        assertFalse(
+            "Did not expect dangling index " + INDEX_NAME + " to be recovered",
+            waitUntil(() -> indexExists(INDEX_NAME), 1, TimeUnit.SECONDS)
+        );
+    }
+
+    /**
+     * Check that when dangling indices are not written, then they cannot be recovered into the cluster.
+     */
+    public void testDanglingIndicesAreNotRecoveredWhenNotWritten() throws Exception {
+        internalCluster().startNodes(3, buildSettings(false, true));
 
         createIndex(INDEX_NAME, Settings.builder().put("number_of_replicas", 2).build());
+        ensureGreen(INDEX_NAME);
+        internalCluster().getInstances(IndicesService.class).forEach(
+            indicesService -> assertTrue(indicesService.allPendingDanglingIndicesWritten()));
 
         // Restart node, deleting the index in its absence, so that there is a dangling index to recover
         internalCluster().restartRandomDataNode(new InternalTestCluster.RestartCallback() {
 
             @Override
             public Settings onNodeStopped(String nodeName) throws Exception {
+                ensureClusterSizeConsistency();
                 assertAcked(client().admin().indices().prepareDelete(INDEX_NAME));
                 return super.onNodeStopped(nodeName);
             }
diff --git a/test/framework/src/main/java/org/elasticsearch/cluster/coordination/AbstractCoordinatorTestCase.java b/test/framework/src/main/java/org/elasticsearch/cluster/coordination/AbstractCoordinatorTestCase.java
index df9638d17835a..415c292142bba 100644
--- a/test/framework/src/main/java/org/elasticsearch/cluster/coordination/AbstractCoordinatorTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/cluster/coordination/AbstractCoordinatorTestCase.java
@@ -35,7 +35,6 @@
 import org.elasticsearch.cluster.coordination.CoordinationMetaData.VotingConfiguration;
 import org.elasticsearch.cluster.coordination.LinearizabilityChecker.History;
 import org.elasticsearch.cluster.coordination.LinearizabilityChecker.SequentialSpec;
-import org.elasticsearch.cluster.metadata.Manifest;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.node.DiscoveryNodeRole;
@@ -57,14 +56,15 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.transport.TransportAddress;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.util.concurrent.PrioritizedEsThreadPoolExecutor;
 import org.elasticsearch.discovery.DiscoveryModule;
 import org.elasticsearch.discovery.SeedHostsProvider;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.gateway.ClusterStateUpdaters;
 import org.elasticsearch.gateway.GatewayService;
-import org.elasticsearch.gateway.MetaStateService;
 import org.elasticsearch.gateway.MockGatewayMetaState;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.node.Node;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.disruption.DisruptableMockTransport;
@@ -741,17 +741,15 @@ class MockPersistedState implements CoordinationState.PersistedState {
                 try {
                     if (oldState.nodeEnvironment != null) {
                         nodeEnvironment = oldState.nodeEnvironment;
-                        final MetaStateService metaStateService = new MetaStateService(nodeEnvironment, xContentRegistry());
                         final MetaData updatedMetaData = adaptGlobalMetaData.apply(oldState.getLastAcceptedState().metaData());
-                        if (updatedMetaData != oldState.getLastAcceptedState().metaData()) {
-                            metaStateService.writeGlobalStateAndUpdateManifest("update global state", updatedMetaData);
-                        }
                         final long updatedTerm = adaptCurrentTerm.apply(oldState.getCurrentTerm());
-                        if (updatedTerm != oldState.getCurrentTerm()) {
-                            final Manifest manifest = metaStateService.loadManifestOrEmpty();
-                            metaStateService.writeManifestAndCleanup("update term",
-                                new Manifest(updatedTerm, manifest.getClusterStateVersion(), manifest.getGlobalGeneration(),
-                                    manifest.getIndexGenerations()));
+                        if (updatedMetaData != oldState.getLastAcceptedState().metaData() || updatedTerm != oldState.getCurrentTerm()) {
+                            try (PersistedClusterStateService.Writer writer =
+                                     new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE)
+                                         .createWriter()) {
+                                writer.writeFullStateAndCommit(updatedTerm,
+                                    ClusterState.builder(oldState.getLastAcceptedState()).metaData(updatedMetaData).build());
+                            }
                         }
                         final MockGatewayMetaState gatewayMetaState = new MockGatewayMetaState(newLocalNode);
                         gatewayMetaState.start(Settings.EMPTY, nodeEnvironment, xContentRegistry());
@@ -854,6 +852,11 @@ public void setLastAcceptedState(ClusterState clusterState) {
             @Override
             public void close() {
                 assertTrue(openPersistedStates.remove(this));
+                try {
+                    delegate.close();
+                } catch (IOException e) {
+                    throw new AssertionError("unexpected", e);
+                }
             }
         }
 
diff --git a/test/framework/src/main/java/org/elasticsearch/gateway/MockGatewayMetaState.java b/test/framework/src/main/java/org/elasticsearch/gateway/MockGatewayMetaState.java
index b73a90b428485..25f43e28ca88c 100644
--- a/test/framework/src/main/java/org/elasticsearch/gateway/MockGatewayMetaState.java
+++ b/test/framework/src/main/java/org/elasticsearch/gateway/MockGatewayMetaState.java
@@ -20,17 +20,23 @@
 package org.elasticsearch.gateway;
 
 import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.Manifest;
+import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.MetaDataIndexUpgradeService;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.plugins.MetaDataUpgrader;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
 
+import java.io.IOException;
+
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
@@ -48,9 +54,10 @@ public MockGatewayMetaState(DiscoveryNode localNode) {
     }
 
     @Override
-    void upgradeMetaData(Settings settings, MetaStateService metaStateService, MetaDataIndexUpgradeService metaDataIndexUpgradeService,
-                         MetaDataUpgrader metaDataUpgrader) {
+    MetaData upgradeMetaDataForNode(MetaData metaData, MetaDataIndexUpgradeService metaDataIndexUpgradeService,
+                                    MetaDataUpgrader metaDataUpgrader) {
         // MetaData upgrade is tested in GatewayMetaStateTests, we override this method to NOP to make mocking easier
+        return metaData;
     }
 
     @Override
@@ -65,7 +72,13 @@ public void start(Settings settings, NodeEnvironment nodeEnvironment, NamedXCont
         final ClusterService clusterService = mock(ClusterService.class);
         when(clusterService.getClusterSettings())
             .thenReturn(new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS));
-        start(settings, transportService, clusterService, new MetaStateService(nodeEnvironment, xContentRegistry),
-            null, null);
+        final MetaStateService metaStateService = mock(MetaStateService.class);
+        try {
+            when(metaStateService.loadFullState()).thenReturn(new Tuple<>(Manifest.empty(), MetaData.builder().build()));
+        } catch (IOException e) {
+            throw new AssertionError(e);
+        }
+        start(settings, transportService, clusterService, metaStateService,
+            null, null, new PersistedClusterStateService(nodeEnvironment, xContentRegistry, BigArrays.NON_RECYCLING_INSTANCE));
     }
 }
diff --git a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
index fe9cc9f8449f6..98911fe3f4cb1 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
@@ -69,6 +69,7 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.util.PageCacheRecycler;
 import org.elasticsearch.common.util.concurrent.EsExecutors;
+import org.elasticsearch.common.util.concurrent.FutureUtils;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.core.internal.io.IOUtils;
@@ -1548,7 +1549,9 @@ private synchronized void startAndPublishNodesAndClients(List<NodeAndClient> nod
             } catch (InterruptedException e) {
                 throw new AssertionError("interrupted while starting nodes", e);
             } catch (ExecutionException e) {
-                throw new RuntimeException("failed to start nodes", e);
+                RuntimeException re = FutureUtils.rethrowExecutionException(e);
+                re.addSuppressed(new RuntimeException("failed to start nodes"));
+                throw re;
             }
             nodeAndClients.forEach(this::publishNode);
 

From 3f83985128d7285d3aaad86982b9ac89f2a6efea Mon Sep 17 00:00:00 2001
From: junmuz <mjunaidmuzammil@gmail.com>
Date: Mon, 13 Jan 2020 19:47:36 +0500
Subject: [PATCH 524/686] [DOCS] Correct typo in `ignore_malformed` mapping
 parm docs (#50780)

---
 docs/reference/mapping/params/ignore-malformed.asciidoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/mapping/params/ignore-malformed.asciidoc b/docs/reference/mapping/params/ignore-malformed.asciidoc
index 9ea5be72bdb28..ab0869bd558fb 100644
--- a/docs/reference/mapping/params/ignore-malformed.asciidoc
+++ b/docs/reference/mapping/params/ignore-malformed.asciidoc
@@ -95,7 +95,7 @@ Malformed fields are silently ignored at indexing time when `ignore_malformed`
 is turned on. Whenever possible it is recommended to keep the number of
 documents that have a malformed field contained, or queries on this field will
 become meaningless. Elasticsearch makes it easy to check how many documents
-have malformed fields by using `exist` or `term` queries on the special
+have malformed fields by using `exists`,`term` or `terms` queries on the special
 <<mapping-ignored-field,`_ignored`>> field.
 
 [[json-object-limits]]
@@ -111,4 +111,4 @@ of the wrong datatype. A JSON object is any data surrounded by curly brackets
 `"{}"` and includes data mapped to the nested, object, and range datatypes.
 
 If you submit a JSON object to an unsupported field, {es} will return an error
-and reject the entire document regardless of the `ignore_malformed` setting.
\ No newline at end of file
+and reject the entire document regardless of the `ignore_malformed` setting.

From 8327fc8d3e524aa02ea7f27ecf03b8ac5be30924 Mon Sep 17 00:00:00 2001
From: Ioannis Kakavas <ioannis@elastic.co>
Date: Mon, 13 Jan 2020 17:09:47 +0200
Subject: [PATCH 525/686] Disallow Password Change when authenticated by Token
 (#49694)

Password changes are only allowed when the user is currently
authenticated by a realm (that permits the password to be changed)
and not when authenticated by a bearer token or an API key.
---
 .../xpack/security/authz/RBACEngine.java      |  9 ++-
 .../xpack/security/authz/RBACEngineTests.java | 53 ++++++++++++++-
 .../test/change_password/11_token.yml         | 67 +++++++++++++++++++
 3 files changed, 123 insertions(+), 6 deletions(-)
 create mode 100644 x-pack/plugin/src/test/resources/rest-api-spec/test/change_password/11_token.yml

diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/RBACEngine.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/RBACEngine.java
index 4b0e99d7290fd..b61716462637e 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/RBACEngine.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/RBACEngine.java
@@ -524,9 +524,12 @@ private static boolean checkChangePasswordAction(Authentication authentication)
         }
 
         assert realmType != null;
-        // ensure the user was authenticated by a realm that we can change a password for. The native realm is an internal realm and
-        // right now only one can exist in the realm configuration - if this changes we should update this check
-        return ReservedRealm.TYPE.equals(realmType) || NativeRealmSettings.TYPE.equals(realmType);
+        // Ensure that the user is not authenticated with an access token or an API key.
+        // Also ensure that the user was authenticated by a realm that we can change a password for. The native realm is an internal realm
+        // and right now only one can exist in the realm configuration - if this changes we should update this check
+        final Authentication.AuthenticationType authType = authentication.getAuthenticationType();
+        return (authType.equals(Authentication.AuthenticationType.REALM)
+            && (ReservedRealm.TYPE.equals(realmType) || NativeRealmSettings.TYPE.equals(realmType)));
     }
 
     static class RBACAuthorizationInfo implements AuthorizationInfo {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
index eee0af46097a0..3066ee2732a5a 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/RBACEngineTests.java
@@ -103,6 +103,7 @@ public void testSameUserPermission() {
         final String action = changePasswordRequest ? ChangePasswordAction.NAME : AuthenticateAction.NAME;
         final Authentication authentication = mock(Authentication.class);
         final Authentication.RealmRef authenticatedBy = mock(Authentication.RealmRef.class);
+        when(authentication.getAuthenticationType()).thenReturn(Authentication.AuthenticationType.REALM);
         when(authentication.getUser()).thenReturn(user);
         when(authentication.getAuthenticatedBy()).thenReturn(authenticatedBy);
         when(authenticatedBy.getType())
@@ -126,9 +127,10 @@ public void testSameUserPermissionDoesNotAllowNonMatchingUsername() {
         final Authentication.RealmRef authenticatedBy = mock(Authentication.RealmRef.class);
         when(authentication.getUser()).thenReturn(user);
         when(authentication.getAuthenticatedBy()).thenReturn(authenticatedBy);
-        when(authenticatedBy.getType())
-            .thenReturn(changePasswordRequest ? randomFrom(ReservedRealm.TYPE, NativeRealmSettings.TYPE) :
-                randomAlphaOfLengthBetween(4, 12));
+        final String authenticationType = changePasswordRequest ? randomFrom(ReservedRealm.TYPE, NativeRealmSettings.TYPE) :
+            randomAlphaOfLengthBetween(4, 12);
+        when(authenticatedBy.getType()).thenReturn(authenticationType);
+        when(authentication.getAuthenticationType()).thenReturn(Authentication.AuthenticationType.REALM);
 
         assertThat(request, instanceOf(UserRequest.class));
         assertFalse(engine.checkSameUserPermissions(action, request, authentication));
@@ -181,6 +183,7 @@ public void testSameUserPermissionRunAsChecksAuthenticatedBy() {
         final Authentication authentication = mock(Authentication.class);
         final Authentication.RealmRef authenticatedBy = mock(Authentication.RealmRef.class);
         final Authentication.RealmRef lookedUpBy = mock(Authentication.RealmRef.class);
+        when(authentication.getAuthenticationType()).thenReturn(Authentication.AuthenticationType.REALM);
         when(authentication.getUser()).thenReturn(user);
         when(authentication.getAuthenticatedBy()).thenReturn(authenticatedBy);
         when(authentication.getLookedUpBy()).thenReturn(lookedUpBy);
@@ -199,6 +202,7 @@ public void testSameUserPermissionDoesNotAllowChangePasswordForOtherRealms() {
         final String action = ChangePasswordAction.NAME;
         final Authentication authentication = mock(Authentication.class);
         final Authentication.RealmRef authenticatedBy = mock(Authentication.RealmRef.class);
+        when(authentication.getAuthenticationType()).thenReturn(Authentication.AuthenticationType.REALM);
         when(authentication.getUser()).thenReturn(user);
         when(authentication.getAuthenticatedBy()).thenReturn(authenticatedBy);
         when(authenticatedBy.getType()).thenReturn(randomFrom(LdapRealmSettings.LDAP_TYPE, FileRealmSettings.TYPE,
@@ -210,6 +214,47 @@ public void testSameUserPermissionDoesNotAllowChangePasswordForOtherRealms() {
         verify(authenticatedBy).getType();
         verify(authentication).getAuthenticatedBy();
         verify(authentication, times(2)).getUser();
+        verify(authentication).getAuthenticationType();
+        verifyNoMoreInteractions(authenticatedBy, authentication);
+    }
+
+    public void testSameUserPermissionDoesNotAllowChangePasswordForApiKey() {
+        final User user = new User("joe");
+        final ChangePasswordRequest request = new ChangePasswordRequestBuilder(mock(Client.class)).username(user.principal()).request();
+        final String action = ChangePasswordAction.NAME;
+        final Authentication authentication = mock(Authentication.class);
+        final Authentication.RealmRef authenticatedBy = mock(Authentication.RealmRef.class);
+        when(authentication.getUser()).thenReturn(user);
+        when(authentication.getAuthenticatedBy()).thenReturn(authenticatedBy);
+        when(authentication.getAuthenticationType()).thenReturn(Authentication.AuthenticationType.API_KEY);
+        when(authenticatedBy.getType()).thenReturn(ApiKeyService.API_KEY_REALM_TYPE);
+
+        assertThat(request, instanceOf(UserRequest.class));
+        assertFalse(engine.checkSameUserPermissions(action, request, authentication));
+        verify(authenticatedBy).getType();
+        verify(authentication).getAuthenticatedBy();
+        verify(authentication, times(2)).getUser();
+        verify(authentication).getAuthenticationType();
+        verifyNoMoreInteractions(authenticatedBy, authentication);
+    }
+
+    public void testSameUserPermissionDoesNotAllowChangePasswordForAccessToken() {
+        final User user = new User("joe");
+        final ChangePasswordRequest request = new ChangePasswordRequestBuilder(mock(Client.class)).username(user.principal()).request();
+        final String action = ChangePasswordAction.NAME;
+        final Authentication authentication = mock(Authentication.class);
+        final Authentication.RealmRef authenticatedBy = mock(Authentication.RealmRef.class);
+        when(authentication.getUser()).thenReturn(user);
+        when(authentication.getAuthenticatedBy()).thenReturn(authenticatedBy);
+        when(authentication.getAuthenticationType()).thenReturn(Authentication.AuthenticationType.TOKEN);
+        when(authenticatedBy.getType()).thenReturn(NativeRealmSettings.TYPE);
+
+        assertThat(request, instanceOf(UserRequest.class));
+        assertFalse(engine.checkSameUserPermissions(action, request, authentication));
+        verify(authenticatedBy).getType();
+        verify(authentication).getAuthenticatedBy();
+        verify(authentication, times(2)).getUser();
+        verify(authentication).getAuthenticationType();
         verifyNoMoreInteractions(authenticatedBy, authentication);
     }
 
@@ -221,6 +266,7 @@ public void testSameUserPermissionDoesNotAllowChangePasswordForLookedUpByOtherRe
         final Authentication authentication = mock(Authentication.class);
         final Authentication.RealmRef authenticatedBy = mock(Authentication.RealmRef.class);
         final Authentication.RealmRef lookedUpBy = mock(Authentication.RealmRef.class);
+        when(authentication.getAuthenticationType()).thenReturn(Authentication.AuthenticationType.REALM);
         when(authentication.getUser()).thenReturn(user);
         when(authentication.getAuthenticatedBy()).thenReturn(authenticatedBy);
         when(authentication.getLookedUpBy()).thenReturn(lookedUpBy);
@@ -233,6 +279,7 @@ public void testSameUserPermissionDoesNotAllowChangePasswordForLookedUpByOtherRe
         verify(authentication).getLookedUpBy();
         verify(authentication, times(2)).getUser();
         verify(lookedUpBy).getType();
+        verify(authentication).getAuthenticationType();
         verifyNoMoreInteractions(authentication, lookedUpBy, authenticatedBy);
     }
 
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/change_password/11_token.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/change_password/11_token.yml
new file mode 100644
index 0000000000000..fcbbb1c257bbe
--- /dev/null
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/change_password/11_token.yml
@@ -0,0 +1,67 @@
+---
+setup:
+  - skip:
+      features: headers
+  - do:
+      cluster.health:
+        wait_for_status: yellow
+  - do:
+      security.put_user:
+        username: "token_joe"
+        body:  >
+          {
+            "password": "s3krit",
+            "roles" : [ "token_admin" ]
+          }
+  - do:
+      security.put_role:
+        name: "token_admin"
+        body:  >
+          {
+            "cluster": ["manage_token"],
+            "indices": [
+              {
+                "names": "*",
+                "privileges": ["all"]
+              }
+            ]
+          }
+---
+teardown:
+  - do:
+      security.delete_user:
+        username: "token_joe"
+        ignore: 404
+  - do:
+      security.delete_role:
+        name: "token_admin"
+        ignore: 404
+
+---
+"Test user changing their password authenticating with token not allowed":
+
+  - do:
+      headers:
+        Authorization: "Basic dG9rZW5fam9lOnMza3JpdA=="
+      security.get_token:
+        body:
+          grant_type: "password"
+          username: "token_joe"
+          password: "s3krit"
+
+  - match: { type: "Bearer" }
+  - is_true: access_token
+  - set: { access_token: token }
+  - match: { expires_in: 1200 }
+  - is_false: scope
+
+  - do:
+      headers:
+        Authorization: Bearer ${token}
+      catch: forbidden
+      security.change_password:
+        username: "joe"
+        body:  >
+          {
+            "password" : "s3krit2"
+          }

From d970d3f8bcd63f2ff701eb239dd2eb4ac22311aa Mon Sep 17 00:00:00 2001
From: Darren Foong <darrenfoong@gmail.com>
Date: Mon, 13 Jan 2020 16:11:52 +0000
Subject: [PATCH 526/686] Improve warning value extraction performance in
 Response (#50208)

This commit improves the performance of warning value extraction in the
low-level REST client, and is similar to the approach taken in
#24114. There are some differences since the low-level REST client might
be connected to Elasticsearch through a proxy that injects its own
warnings.
---
 .../org/elasticsearch/client/Response.java    | 85 ++++++++++++++++++-
 .../client/RestClientSingleHostTests.java     | 12 ++-
 2 files changed, 92 insertions(+), 5 deletions(-)

diff --git a/client/rest/src/main/java/org/elasticsearch/client/Response.java b/client/rest/src/main/java/org/elasticsearch/client/Response.java
index c5a159eb39da5..7abe24aa59eb5 100644
--- a/client/rest/src/main/java/org/elasticsearch/client/Response.java
+++ b/client/rest/src/main/java/org/elasticsearch/client/Response.java
@@ -116,6 +116,86 @@ public HttpEntity getEntity() {
             "GMT" + // GMT
             "\")?"); // closing quote (optional, since an older version can still send a warn-date)
 
+    /**
+     * Optimized regular expression to test if a string matches the RFC 1123 date
+     * format (with quotes and leading space). Start/end of line characters and
+     * atomic groups are used to prevent backtracking.
+     */
+    private static final Pattern WARNING_HEADER_DATE_PATTERN = Pattern.compile(
+            "^ " + // start of line, leading space
+            // quoted RFC 1123 date format
+            "\"" + // opening quote
+            "(?>Mon|Tue|Wed|Thu|Fri|Sat|Sun), " + // day of week, atomic group to prevent backtracking
+            "\\d{2} " + // 2-digit day
+            "(?>Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) " + // month, atomic group to prevent backtracking
+            "\\d{4} " + // 4-digit year
+            "\\d{2}:\\d{2}:\\d{2} " + // (two-digit hour):(two-digit minute):(two-digit second)
+            "GMT" + // GMT
+            "\"$"); // closing quote (optional, since an older version can still send a warn-date), end of line
+
+    /**
+     * Length of RFC 1123 format (with quotes and leading space), used in
+     * matchWarningHeaderPatternByPrefix(String).
+     */
+    private static final int WARNING_HEADER_DATE_LENGTH = 0
+            + 1
+            + 1
+            + 3 + 1 + 1
+            + 2 + 1
+            + 3 + 1
+            + 4 + 1
+            + 2 + 1 + 2 + 1 + 2 + 1
+            + 3
+            + 1;
+
+    /**
+     * Tests if a string matches the RFC 7234 specification for warning headers.
+     * This assumes that the warn code is always 299 and the warn agent is always
+     * Elasticsearch.
+     *
+     * @param s the value of a warning header formatted according to RFC 7234
+     * @return {@code true} if the input string matches the specification
+     */
+    private static boolean matchWarningHeaderPatternByPrefix(final String s) {
+        return s.startsWith("299 Elasticsearch-");
+    }
+
+    /**
+     * Refer to org.elasticsearch.common.logging.DeprecationLogger
+     */
+    private static String extractWarningValueFromWarningHeader(final String s) {
+        String warningHeader = s;
+
+        /*
+         * The following block tests for the existence of a RFC 1123 date in the warning header. If the date exists, it is removed for
+         * extractWarningValueFromWarningHeader(String) to work properly (as it does not handle dates).
+         */
+        if (s.length() > WARNING_HEADER_DATE_LENGTH) {
+            final String possibleDateString = s.substring(s.length() - WARNING_HEADER_DATE_LENGTH);
+            final Matcher matcher = WARNING_HEADER_DATE_PATTERN.matcher(possibleDateString);
+
+            if (matcher.matches()) {
+                warningHeader = warningHeader.substring(0, s.length() - WARNING_HEADER_DATE_LENGTH);
+            }
+        }
+
+        final int firstQuote = warningHeader.indexOf('\"');
+        final int lastQuote = warningHeader.length() - 1;
+        final String warningValue = warningHeader.substring(firstQuote + 1, lastQuote);
+        assert assertWarningValue(s, warningValue);
+        return warningValue;
+    }
+
+    /**
+     * Refer to org.elasticsearch.common.logging.DeprecationLogger
+     */
+    private static boolean assertWarningValue(final String s, final String warningValue) {
+        final Matcher matcher = WARNING_HEADER_PATTERN.matcher(s);
+        final boolean matches = matcher.matches();
+        assert matches;
+        return matcher.group(1).equals(warningValue);
+    }
+
     /**
      * Returns a list of all warning headers returned in the response.
      */
@@ -123,9 +203,8 @@ public List<String> getWarnings() {
         List<String> warnings = new ArrayList<>();
         for (Header header : response.getHeaders("Warning")) {
             String warning = header.getValue();
-            final Matcher matcher = WARNING_HEADER_PATTERN.matcher(warning);
-            if (matcher.matches()) {
-                warnings.add(matcher.group(1));
+            if (matchWarningHeaderPatternByPrefix(warning)) {
+                warnings.add(extractWarningValueFromWarningHeader(warning));
             } else {
                 warnings.add(warning);
             }
diff --git a/client/rest/src/test/java/org/elasticsearch/client/RestClientSingleHostTests.java b/client/rest/src/test/java/org/elasticsearch/client/RestClientSingleHostTests.java
index dd133f90daadb..fa5e9bcc6b43c 100644
--- a/client/rest/src/test/java/org/elasticsearch/client/RestClientSingleHostTests.java
+++ b/client/rest/src/test/java/org/elasticsearch/client/RestClientSingleHostTests.java
@@ -424,6 +424,7 @@ public void testHeaders() throws Exception {
     public void testDeprecationWarnings() throws Exception {
         String chars = randomAsciiAlphanumOfLength(5);
         assertDeprecationWarnings(singletonList("poorly formatted " + chars), singletonList("poorly formatted " + chars));
+        assertDeprecationWarnings(singletonList(formatWarningWithoutDate(chars)), singletonList(chars));
         assertDeprecationWarnings(singletonList(formatWarning(chars)), singletonList(chars));
         assertDeprecationWarnings(
                 Arrays.asList(formatWarning(chars), "another one", "and another"),
@@ -433,6 +434,9 @@ public void testDeprecationWarnings() throws Exception {
                 Arrays.asList("ignorable one", "and another"));
         assertDeprecationWarnings(singletonList("exact"), singletonList("exact"));
         assertDeprecationWarnings(Collections.<String>emptyList(), Collections.<String>emptyList());
+
+        String proxyWarning = "112 - \"network down\" \"Sat, 25 Aug 2012 23:34:45 GMT\"";
+        assertDeprecationWarnings(singletonList(proxyWarning), singletonList(proxyWarning));
     }
 
     private enum DeprecationWarningOption {
@@ -518,9 +522,13 @@ private void assertDeprecationWarnings(List<String> warningHeaderTexts, List<Str
      * Emulates Elasticsearch's DeprecationLogger.formatWarning in simple
      * cases. We don't have that available because we're testing against 1.7.
      */
-    private static String formatWarning(String warningBody) {
+    private static String formatWarningWithoutDate(String warningBody) {
         final String hash = new String(new byte[40], StandardCharsets.UTF_8).replace('\0', 'e');
-        return "299 Elasticsearch-1.2.2-SNAPSHOT-" + hash + " \"" + warningBody + "\" \"Mon, 01 Jan 2001 00:00:00 GMT\"";
+        return "299 Elasticsearch-1.2.2-SNAPSHOT-" + hash + " \"" + warningBody + "\"";
+    }
+
+    private static String formatWarning(String warningBody) {
+        return formatWarningWithoutDate(warningBody) + " \"Mon, 01 Jan 2001 00:00:00 GMT\"";
     }
 
     private HttpUriRequest performRandomRequest(String method) throws Exception {

From 3e82852ef1ac00e69117daa3955f541e21c2129b Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Mon, 13 Jan 2020 10:51:42 -0600
Subject: [PATCH 527/686] Use default profile for remote connections (#50828)

Currently, the connection manager is configured with a default profile
for both the sniff and proxy connection stratgies. This profile
correctly reflects the expected number of connection (6 for sniff, 18
for proxy). This commit removes the proxy strategy usages of the per
connection attempt profile configuration.

Additionally, it refactors other unnecessary code around the connection
manager. The connection manager now can always be built inside the
remote connection.
---
 .../transport/ProxyConnectionStrategy.java    |  8 +---
 .../transport/RemoteClusterConnection.java    | 11 ++---
 .../RemoteClusterConnectionTests.java         | 47 ++++---------------
 3 files changed, 13 insertions(+), 53 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
index 14ca217ade1b8..00971252a3311 100644
--- a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
@@ -94,7 +94,6 @@ public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
     private final boolean includeServerName;
     private final Supplier<TransportAddress> address;
     private final AtomicReference<ClusterName> remoteClusterName = new AtomicReference<>();
-    private final ConnectionProfile profile;
     private final ConnectionManager.ConnectionValidator clusterNameValidator;
 
     ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
@@ -129,11 +128,6 @@ public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
         this.includeServerName = includeServerName;
         assert Strings.isEmpty(configuredAddress) == false : "Cannot use proxy connection strategy with no configured addresses";
         this.address = address;
-        // TODO: Move into the ConnectionManager
-        this.profile = new ConnectionProfile.Builder()
-            .addConnections(1, TransportRequestOptions.Type.REG, TransportRequestOptions.Type.PING)
-            .addConnections(0, TransportRequestOptions.Type.BULK, TransportRequestOptions.Type.STATE, TransportRequestOptions.Type.RECOVERY)
-            .build();
         this.clusterNameValidator = (newConnection, actualProfile, listener) ->
             transportService.handshake(newConnection, actualProfile.getHandshakeTimeout().millis(), cn -> true,
                 ActionListener.map(listener, resp -> {
@@ -231,7 +225,7 @@ public void onFailure(Exception e) {
                 DiscoveryNode node = new DiscoveryNode(id, resolved, attributes, DiscoveryNodeRole.BUILT_IN_ROLES,
                     Version.CURRENT.minimumCompatibilityVersion());
 
-                connectionManager.connectToNode(node, profile, clusterNameValidator, new ActionListener<>() {
+                connectionManager.connectToNode(node, null, clusterNameValidator, new ActionListener<>() {
                     @Override
                     public void onResponse(Void v) {
                         compositeListener.onResponse(v);
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteClusterConnection.java b/server/src/main/java/org/elasticsearch/transport/RemoteClusterConnection.java
index ae697bba95b49..c87872317de8a 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteClusterConnection.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteClusterConnection.java
@@ -66,18 +66,13 @@ final class RemoteClusterConnection implements Closeable {
      * @param transportService the local nodes transport service
      */
     RemoteClusterConnection(Settings settings, String clusterAlias, TransportService transportService) {
-        this(settings, clusterAlias, transportService,
-            createConnectionManager(RemoteConnectionStrategy.buildConnectionProfile(clusterAlias, settings), transportService));
-    }
-
-    RemoteClusterConnection(Settings settings, String clusterAlias, TransportService transportService,
-                            ConnectionManager connectionManager) {
         this.transportService = transportService;
         this.clusterAlias = clusterAlias;
-        this.remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
+        ConnectionProfile profile = RemoteConnectionStrategy.buildConnectionProfile(clusterAlias, settings);
+        this.remoteConnectionManager = new RemoteConnectionManager(clusterAlias, createConnectionManager(profile, transportService));
         this.connectionStrategy = RemoteConnectionStrategy.buildStrategy(clusterAlias, transportService, remoteConnectionManager, settings);
         // we register the transport service here as a listener to make sure we notify handlers on disconnect etc.
-        connectionManager.addListener(transportService);
+        this.remoteConnectionManager.getConnectionManager().addListener(transportService);
         this.skipUnavailable = RemoteClusterService.REMOTE_CLUSTER_SKIP_UNAVAILABLE
             .getConcreteSettingForNamespace(clusterAlias).get(settings);
         this.threadPool = transportService.threadPool;
diff --git a/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java b/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
index 195e979c56dc5..8e061a06ec823 100644
--- a/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/RemoteClusterConnectionTests.java
@@ -56,7 +56,6 @@
 import org.elasticsearch.search.internal.InternalSearchResponse;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.transport.MockTransportService;
-import org.elasticsearch.test.transport.StubbableConnectionManager;
 import org.elasticsearch.threadpool.TestThreadPool;
 import org.elasticsearch.threadpool.ThreadPool;
 
@@ -84,7 +83,6 @@
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.instanceOf;
-import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.sameInstance;
 
 public class RemoteClusterConnectionTests extends ESTestCase {
@@ -546,51 +544,24 @@ public void testConnectedNodesConcurrentAccess() throws IOException, Interrupted
     public void testGetConnection() throws Exception {
         List<DiscoveryNode> knownNodes = new CopyOnWriteArrayList<>();
         try (MockTransportService seedTransport = startTransport("seed_node", knownNodes, Version.CURRENT);
-             MockTransportService discoverableTransport = startTransport("discoverable_node", knownNodes, Version.CURRENT)) {
+             MockTransportService disconnectedTransport = startTransport("disconnected_node", knownNodes, Version.CURRENT)) {
 
-            DiscoveryNode connectedNode = seedTransport.getLocalDiscoNode();
-            assertThat(connectedNode, notNullValue());
-            knownNodes.add(connectedNode);
+            DiscoveryNode seedNode = seedTransport.getLocalNode();
+            knownNodes.add(seedNode);
 
-            DiscoveryNode disconnectedNode = discoverableTransport.getLocalDiscoNode();
-            assertThat(disconnectedNode, notNullValue());
-            knownNodes.add(disconnectedNode);
+            DiscoveryNode disconnectedNode = disconnectedTransport.getLocalNode();
 
             try (MockTransportService service = MockTransportService.createNewService(Settings.EMPTY, Version.CURRENT, threadPool, null)) {
-                Transport.Connection seedConnection = new CloseableConnection() {
-                    @Override
-                    public DiscoveryNode getNode() {
-                        return connectedNode;
-                    }
-
-                    @Override
-                    public void sendRequest(long requestId, String action, TransportRequest request, TransportRequestOptions options)
-                        throws TransportException {
-                        // no-op
-                    }
-                };
-
-                ConnectionManager delegate = new ConnectionManager(Settings.EMPTY, service.transport);
-                StubbableConnectionManager connectionManager = new StubbableConnectionManager(delegate, Settings.EMPTY, service.transport);
-
-                connectionManager.setDefaultNodeConnectedBehavior((cm, node) -> connectedNode.equals(node));
-
-                connectionManager.addGetConnectionBehavior(connectedNode.getAddress(), (cm, discoveryNode) -> seedConnection);
-
-                connectionManager.addGetConnectionBehavior(disconnectedNode.getAddress(), (cm, discoveryNode) -> {
-                    throw new NodeNotConnectedException(discoveryNode, "");
-                });
-
                 service.start();
                 service.acceptIncomingRequests();
                 String clusterAlias = "test-cluster";
-                Settings settings = buildRandomSettings(clusterAlias, addresses(connectedNode));
-                try (RemoteClusterConnection connection = new RemoteClusterConnection(settings, clusterAlias, service, connectionManager)) {
+                Settings settings = buildRandomSettings(clusterAlias, addresses(seedNode));
+                try (RemoteClusterConnection connection = new RemoteClusterConnection(settings, clusterAlias, service)) {
                     PlainActionFuture.get(fut -> connection.ensureConnected(ActionListener.map(fut, x -> null)));
                     for (int i = 0; i < 10; i++) {
                         //always a direct connection as the remote node is already connected
-                        Transport.Connection remoteConnection = connection.getConnection(connectedNode);
-                        assertSame(seedConnection, remoteConnection);
+                        Transport.Connection remoteConnection = connection.getConnection(seedNode);
+                        assertEquals(seedNode, remoteConnection.getNode());
                     }
                     for (int i = 0; i < 10; i++) {
                         // we don't use the transport service connection manager so we will get a proxy connection for the local node
@@ -599,7 +570,7 @@ public void sendRequest(long requestId, String action, TransportRequest request,
                         assertThat(remoteConnection.getNode(), equalTo(service.getLocalNode()));
                     }
                     for (int i = 0; i < 10; i++) {
-                        //always a proxy connection as the target node is not connected
+                        // always a proxy connection as the target node is not connected
                         Transport.Connection remoteConnection = connection.getConnection(disconnectedNode);
                         assertThat(remoteConnection, instanceOf(RemoteConnectionManager.ProxyConnection.class));
                         assertThat(remoteConnection.getNode(), sameInstance(disconnectedNode));

From 1d6ab13b52f55ee24800df735884f7d01e6b3694 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Mon, 13 Jan 2020 09:31:39 -0800
Subject: [PATCH 528/686] Fix build scan logic to support folder nested Jenkins
 job names

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 gradle/build-scan.gradle | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/gradle/build-scan.gradle b/gradle/build-scan.gradle
index 9e726adb046b6..4281b794e760f 100644
--- a/gradle/build-scan.gradle
+++ b/gradle/build-scan.gradle
@@ -37,11 +37,11 @@ buildScan {
     // Parse job name in the case of matrix builds
     // Matrix job names come in the form of "base-job-name/matrix_param1=value1,matrix_param2=value2"
     def splitJobName = jobName.split('/')
-    if (splitJobName.length == 2) {
-      tag splitJobName[0]
-      tag splitJobName[1]
-      value 'Job Name', splitJobName[0]
-      def matrixParams = splitJobName[1].split(',')
+    if (splitJobName.length > 1 && splitJobName.last() ==~ /^([a-zA-Z0-9_\-]+=[a-zA-Z0-9_\-]+,?)+$/) {
+      def baseJobName = splitJobName.dropRight(1).join('/')
+      tag baseJobName
+      value 'Job Name', baseJobName
+      def matrixParams = splitJobName.last().split(',')
       matrixParams.collect { it.split('=') }.each { param ->
         value "MATRIX_${param[0].toUpperCase()}", param[1]
       }

From 21499b6820f729cae5142f5820303426420d656d Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Mon, 13 Jan 2020 10:38:25 -0800
Subject: [PATCH 529/686] Add protection in windows for slow file lock
 releasing (#50884)

This commit adds retries for windows cleanup after tests, which may fail
due to file locks not being immediately released after a windows process
exits.

closes #50825
---
 .../elasticsearch/packaging/util/Cleanup.java | 10 ++++----
 .../packaging/util/FileUtils.java             | 24 +++++++++++++++++++
 2 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Cleanup.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Cleanup.java
index f9b98d58ccacc..77384a38d2737 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Cleanup.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Cleanup.java
@@ -20,10 +20,12 @@
 package org.elasticsearch.packaging.util;
 
 import java.nio.file.Files;
+import java.nio.file.Path;
 import java.nio.file.Paths;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
+import java.util.function.Consumer;
 
 import static org.elasticsearch.packaging.util.FileUtils.getTempDir;
 import static org.elasticsearch.packaging.util.FileUtils.lsGlob;
@@ -79,13 +81,13 @@ public static void cleanEverything() throws Exception {
 
         // delete files that may still exist
         lsGlob(getTempDir(), "elasticsearch*").forEach(FileUtils::rm);
-        final List<String> filesToDelete = Platforms.WINDOWS
-            ? ELASTICSEARCH_FILES_WINDOWS
-            : ELASTICSEARCH_FILES_LINUX;
+        final List<String> filesToDelete = Platforms.WINDOWS ? ELASTICSEARCH_FILES_WINDOWS : ELASTICSEARCH_FILES_LINUX;
+        // windows needs leniency due to asinine releasing of file locking async from a process exiting
+        Consumer<? super Path> rm = Platforms.WINDOWS ? FileUtils::rmWithRetries : FileUtils::rm;
         filesToDelete.stream()
             .map(Paths::get)
             .filter(Files::exists)
-            .forEach(FileUtils::rm);
+            .forEach(rm);
 
         // disable elasticsearch service
         // todo add this for windows when adding tests for service intallation
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/FileUtils.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/FileUtils.java
index efd2c85bf9e3a..2efb757037c90 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/FileUtils.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/FileUtils.java
@@ -84,6 +84,30 @@ public static void rm(Path... paths) {
         }
     }
 
+    public static void rmWithRetries(Path... paths) {
+        int tries = 10;
+        Exception exception = null;
+        while (tries-- > 0) {
+            try {
+                IOUtils.rm(paths);
+                return;
+            } catch (IOException e) {
+                if (exception == null) {
+                    exception = e;
+                } else {
+                    exception.addSuppressed(e);
+                }
+            }
+            try {
+                Thread.sleep(1000);
+            } catch (InterruptedException interrupted) {
+                Thread.currentThread().interrupt();
+                return;
+            }
+        }
+        throw new RuntimeException(exception);
+    }
+
     public static Path mktempDir(Path path) {
         try {
             return Files.createTempDirectory(path,"tmp");

From 8b367c9559f76079433238b18fd6a79673fa7903 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Mon, 13 Jan 2020 12:27:20 -0800
Subject: [PATCH 530/686] Migrate certgen packaging test from bats (#50880)

This commit moves the packaging tests for elasticsearch-certgen
to java from bats. Although certgen is deprecated, the tests are
moved rather than just deleted, and the tests themselves should be
easily adaptable to certutil. One note is that the test is simplified to
use a single node, rather than the two node test from bats, which was
problematic given how the newer distro tests only operate with a single
distribution.

relates #46005
---
 qa/os/bats/default/40_tar_certgen.bats        |   1 -
 qa/os/bats/default/45_package_certgen.bats    |   1 -
 qa/os/bats/default/certgen.bash               | 436 ------------------
 .../packaging/test/CertGenCliTests.java       | 119 +++++
 .../packaging/test/PackagingTestCase.java     |   6 +
 .../packaging/test/PasswordToolsTests.java    |   8 +-
 .../packaging/test/WindowsServiceTests.java   |   6 +-
 .../elasticsearch/packaging/util/Docker.java  |   3 +-
 .../packaging/util/FileMatcher.java           |  14 +-
 .../packaging/util/FileUtils.java             |  13 +-
 .../packaging/util/Installation.java          |  16 +-
 .../packaging/util/Packages.java              |   4 +-
 .../packaging/util/ServerUtils.java           |  81 +++-
 .../elasticsearch/packaging/util/Shell.java   |   7 +-
 14 files changed, 243 insertions(+), 472 deletions(-)
 delete mode 120000 qa/os/bats/default/40_tar_certgen.bats
 delete mode 120000 qa/os/bats/default/45_package_certgen.bats
 delete mode 100644 qa/os/bats/default/certgen.bash
 create mode 100644 qa/os/src/test/java/org/elasticsearch/packaging/test/CertGenCliTests.java

diff --git a/qa/os/bats/default/40_tar_certgen.bats b/qa/os/bats/default/40_tar_certgen.bats
deleted file mode 120000
index c9a929d829edd..0000000000000
--- a/qa/os/bats/default/40_tar_certgen.bats
+++ /dev/null
@@ -1 +0,0 @@
-certgen.bash
\ No newline at end of file
diff --git a/qa/os/bats/default/45_package_certgen.bats b/qa/os/bats/default/45_package_certgen.bats
deleted file mode 120000
index c9a929d829edd..0000000000000
--- a/qa/os/bats/default/45_package_certgen.bats
+++ /dev/null
@@ -1 +0,0 @@
-certgen.bash
\ No newline at end of file
diff --git a/qa/os/bats/default/certgen.bash b/qa/os/bats/default/certgen.bash
deleted file mode 100644
index 0f637f7c34090..0000000000000
--- a/qa/os/bats/default/certgen.bash
+++ /dev/null
@@ -1,436 +0,0 @@
-#!/usr/bin/env bats
-
-# Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
-# or more contributor license agreements. Licensed under the Elastic License;
-# you may not use this file except in compliance with the Elastic License.
-
-load $BATS_UTILS/utils.bash
-load $BATS_UTILS/plugins.bash
-load $BATS_UTILS/xpack.bash
-
-# Description of the nodes instances
-instances="/tmp/instances.yml"
-
-# Destination for generated certificates
-certificates="/tmp/certificates.zip"
-
-setup() {
-    if [ $BATS_TEST_NUMBER == 1 ]; then
-        clean_before_test
-    fi
-}
-
-DEFAULT_ARCHIVE_USER=elasticsearch
-DEFAULT_ARCHIVE_ESHOME="/tmp/elasticsearch"
-DEFAULT_ARCHIVE_UTILS=$BATS_UTILS/tar.bash
-
-DEFAULT_PACKAGE_USER=root
-DEFAULT_PACKAGE_ESHOME="/usr/share/elasticsearch"
-DEFAULT_PACKAGE_UTILS=$BATS_UTILS/packages.bash
-
-if [[ "$BATS_TEST_FILENAME" =~ 40_tar_certgen.bats$ ]]; then
-    GROUP='TAR CERTGEN'
-
-    MASTER_USER=$DEFAULT_ARCHIVE_USER
-    MASTER_GROUP=$DEFAULT_ARCHIVE_USER
-    MASTER_DPERMS=755
-    MASTER_HOME=$DEFAULT_ARCHIVE_ESHOME
-    MASTER_UTILS=$DEFAULT_ARCHIVE_UTILS
-
-    DATA_USER=$DEFAULT_PACKAGE_USER
-    DATA_GROUP=elasticsearch
-    DATA_DPERMS=2755
-    DATA_HOME=$DEFAULT_PACKAGE_ESHOME
-    DATA_UTILS=$DEFAULT_PACKAGE_UTILS
-
-    install_master_node() {
-	    install_node_using_archive
-    }
-    start_master_node() {
-	    start_node_using_archive
-    }
-    install_data_node() {
-	    install_node_using_package
-    }
-    start_data_node() {
-	    start_node_using_package
-    }
-else
-    if is_rpm; then
-        GROUP='RPM CERTGEN'
-    elif is_dpkg; then
-        GROUP='DEB CERTGEN'
-    fi
-
-    MASTER_USER=$DEFAULT_PACKAGE_USER
-    MASTER_GROUP=elasticsearch
-    MASTER_DPERMS=2755
-    MASTER_HOME=$DEFAULT_PACKAGE_ESHOME
-    MASTER_UTILS=$DEFAULT_PACKAGE_UTILS
-
-    DATA_USER=$DEFAULT_ARCHIVE_USER
-    DATA_GROUP=$DEFAULT_ARCHIVE_USER
-    DATA_DPERMS=755
-    DATA_HOME=$DEFAULT_ARCHIVE_ESHOME
-    DATA_UTILS=$DEFAULT_ARCHIVE_UTILS
-
-    install_master_node() {
-	    install_node_using_package
-    }
-    start_master_node() {
-	    start_node_using_package
-    }
-    install_data_node() {
-	    install_node_using_archive
-    }
-    start_data_node() {
-	    start_node_using_archive
-    }
-fi
-
-# Install a node with x-pack using the archive file
-install_node_using_archive() {
-    load $BATS_UTILS/tar.bash
-    export ESHOME="$DEFAULT_ARCHIVE_ESHOME"
-    export_elasticsearch_paths
-
-    assert_file_not_exist "/home/elasticsearch"
-    install_archive
-    set_debug_logging
-    verify_archive_installation
-    assert_file_not_exist "/home/elasticsearch"
-
-    export ESPLUGIN_COMMAND_USER=$DEFAULT_ARCHIVE_USER
-    generate_trial_license
-    verify_xpack_installation
-}
-
-# Starts a node installed using the archive
-start_node_using_archive() {
-    load $BATS_UTILS/tar.bash
-    export ESHOME="$DEFAULT_ARCHIVE_ESHOME"
-    export_elasticsearch_paths
-
-    run sudo -u $DEFAULT_ARCHIVE_USER "$ESHOME/bin/elasticsearch" -d -p $ESHOME/elasticsearch.pid
-    [ "$status" -eq "0" ] || {
-	echo "Failed to start node using archive: $output"
-	false
-    }
-}
-
-# Install a node with x-pack using a package file
-install_node_using_package() {
-    load $BATS_UTILS/packages.bash
-    export ESHOME="$DEFAULT_PACKAGE_ESHOME"
-    export_elasticsearch_paths
-
-    assert_file_not_exist "/home/elasticsearch"
-    install_package
-    set_debug_logging
-    verify_package_installation
-
-    export ESPLUGIN_COMMAND_USER=$DEFAULT_PACKAGE_USER
-    generate_trial_license
-    verify_xpack_installation
-}
-
-# Starts a node installed using a package
-start_node_using_package() {
-    if is_systemd; then
-	run systemctl daemon-reload
-        [ "$status" -eq 0 ]
-
-        run sudo systemctl start elasticsearch.service
-        [ "$status" -eq "0" ]
-
-    elif is_sysvinit; then
-        run sudo service elasticsearch start
-        [ "$status" -eq "0" ]
-    fi
-}
-
-
-@test "[$GROUP] install master node" {
-    install_master_node
-}
-
-@test "[$GROUP] add bootstrap password" {
-    load $MASTER_UTILS
-    export ESHOME="$MASTER_HOME"
-    export_elasticsearch_paths
-
-    # For the sake of simplicity we use a bootstrap password in this test. The
-    # alternative would be to start the master node, use
-    # elasticsearch-setup-passwords and restart the node once ssl/tls is
-    # configured. Or use elasticsearch-setup-passwords over HTTPS with the right
-    # cacerts imported into a Java keystore.
-    run sudo -E -u $MASTER_USER bash <<"NEW_PASS"
-if [[ ! -f $ESCONFIG/elasticsearch.keystore ]]; then
-    $ESHOME/bin/elasticsearch-keystore create
-fi
-echo "changeme" | $ESHOME/bin/elasticsearch-keystore add --stdin bootstrap.password
-NEW_PASS
-    [ "$status" -eq 0 ] || {
-        echo "Expected elasticsearch-keystore tool exit code to be zero"
-        echo "$output"
-        false
-    }
-}
-
-@test "[$GROUP] create instances file" {
-    rm -f /tmp/instances.yml
-    run sudo -E -u $MASTER_USER bash <<"CREATE_INSTANCES_FILE"
-cat > /tmp/instances.yml <<- EOF
-instances:
-  - name: "node-master"
-    ip:
-      - "127.0.0.1"
-  - name: "node-data"
-    ip:
-      - "127.0.0.1"
-EOF
-CREATE_INSTANCES_FILE
-
-    [ "$status" -eq 0 ] || {
-        echo "Failed to create instances file [$instances]: $output"
-        false
-    }
-}
-
-@test "[$GROUP] create certificates" {
-    if [[ -f "$certificates" ]]; then
-	    sudo rm -f "$certificates"
-    fi
-
-    run sudo -E -u $MASTER_USER "$MASTER_HOME/bin/elasticsearch-certgen" --in "$instances" --out "$certificates"
-    [ "$status" -eq 0 ] || {
-        echo "Expected elasticsearch-certgen tool exit code to be zero"
-        echo "$output"
-        false
-    }
-
-    echo "$output" | grep "Certificates written to $certificates"
-    assert_file "$certificates" f $MASTER_USER $MASTER_USER 600
-}
-
-@test "[$GROUP] install certificates on master node" {
-    load $MASTER_UTILS
-    export ESHOME="$MASTER_HOME"
-    export_elasticsearch_paths
-
-    certs="$ESCONFIG/certs"
-    if [[ -d "$certs" ]]; then
-	    sudo rm -rf "$certs"
-    fi
-
-    run sudo -E -u $MASTER_USER "unzip" $certificates -d $certs
-    [ "$status" -eq 0 ] || {
-	    echo "Failed to unzip certificates in $certs: $output"
-	    false
-    }
-
-    assert_file "$certs/ca/ca.key" f $MASTER_USER $MASTER_GROUP 644
-    assert_file "$certs/ca/ca.crt" f $MASTER_USER $MASTER_GROUP 644
-
-    assert_file "$certs/node-master" d $MASTER_USER $MASTER_GROUP $MASTER_DPERMS
-    assert_file "$certs/node-master/node-master.key" f $MASTER_USER $MASTER_GROUP 644
-    assert_file "$certs/node-master/node-master.crt" f $MASTER_USER $MASTER_GROUP 644
-
-    assert_file "$certs/node-data" d $MASTER_USER $MASTER_GROUP $MASTER_DPERMS
-    assert_file "$certs/node-data/node-data.key" f $MASTER_USER $MASTER_GROUP 644
-    assert_file "$certs/node-data/node-data.crt" f $MASTER_USER $MASTER_GROUP 644
-}
-
-@test "[$GROUP] update master node settings" {
-    load $MASTER_UTILS
-    export ESHOME="$MASTER_HOME"
-    export_elasticsearch_paths
-
-    run sudo -E -u $MASTER_USER bash <<"MASTER_SETTINGS"
-cat >> $ESCONFIG/elasticsearch.yml <<- EOF
-node.name: "node-master"
-node.master: true
-node.data: false
-discovery.seed_hosts: ["127.0.0.1:9301"]
-cluster.initial_master_nodes: ["node-master"]
-
-xpack.security.transport.ssl.key: $ESCONFIG/certs/node-master/node-master.key
-xpack.security.transport.ssl.certificate: $ESCONFIG/certs/node-master/node-master.crt
-xpack.security.transport.ssl.certificate_authorities: ["$ESCONFIG/certs/ca/ca.crt"]
-xpack.security.http.ssl.key: $ESCONFIG/certs/node-master/node-master.key
-xpack.security.http.ssl.certificate: $ESCONFIG/certs/node-master/node-master.crt
-xpack.security.http.ssl.certificate_authorities: ["$ESCONFIG/certs/ca/ca.crt"]
-
-xpack.security.transport.ssl.enabled: true
-transport.port: 9300
-
-xpack.security.http.ssl.enabled: true
-http.port: 9200
-
-EOF
-MASTER_SETTINGS
-
-    start_master_node
-        wait_for_xpack 127.0.0.1 9200
-}
-
-@test "[$GROUP] test connection to master node using HTTPS" {
-    load $MASTER_UTILS
-    export ESHOME="$MASTER_HOME"
-    export_elasticsearch_paths
-
-    run sudo -E -u $MASTER_USER curl -u "elastic:changeme" --cacert "$ESCONFIG/certs/ca/ca.crt" -XGET "https://127.0.0.1:9200"
-    [ "$status" -eq 0 ] || {
-	    echo "Failed to connect to master node using HTTPS:"
-	    echo "$output"
-	    debug_collect_logs
-	    false
-    }
-    echo "$output" | grep "node-master"
-}
-
-@test "[$GROUP] install data node" {
-    install_data_node
-}
-
-@test "[$GROUP] install certificates on data node" {
-    load $DATA_UTILS
-    export ESHOME="$DATA_HOME"
-    export_elasticsearch_paths
-
-    sudo chown $DATA_USER:$DATA_USER "$certificates"
-    [ -f "$certificates" ] || {
-	    echo "Could not find certificates: $certificates"
-	    false
-    }
-
-    certs="$ESCONFIG/certs"
-    if [[ -d "$certs" ]]; then
-	    sudo rm -rf "$certs"
-    fi
-
-    run sudo -E -u $DATA_USER "unzip" $certificates -d $certs
-    [ "$status" -eq 0 ] || {
-	    echo "Failed to unzip certificates in $certs: $output"
-	    false
-    }
-
-    assert_file "$certs/ca" d $DATA_USER $DATA_GROUP
-    assert_file "$certs/ca/ca.key" f $DATA_USER $DATA_GROUP 644
-    assert_file "$certs/ca/ca.crt" f $DATA_USER $DATA_GROUP 644
-
-    assert_file "$certs/node-master" d $DATA_USER $DATA_GROUP
-    assert_file "$certs/node-master/node-master.key" f $DATA_USER $DATA_GROUP 644
-    assert_file "$certs/node-master/node-master.crt" f $DATA_USER $DATA_GROUP 644
-
-    assert_file "$certs/node-data" d $DATA_USER $DATA_GROUP
-    assert_file "$certs/node-data/node-data.key" f $DATA_USER $DATA_GROUP 644
-    assert_file "$certs/node-data/node-data.crt" f $DATA_USER $DATA_GROUP 644
-}
-
-@test "[$GROUP] update data node settings" {
-    load $DATA_UTILS
-    export ESHOME="$DATA_HOME"
-    export_elasticsearch_paths
-
-    run sudo -E -u $DATA_USER bash <<"DATA_SETTINGS"
-cat >> $ESCONFIG/elasticsearch.yml <<- EOF
-node.name: "node-data"
-node.master: false
-node.data: true
-discovery.seed_hosts: ["127.0.0.1:9300"]
-
-xpack.security.transport.ssl.key: $ESCONFIG/certs/node-data/node-data.key
-xpack.security.transport.ssl.certificate: $ESCONFIG/certs/node-data/node-data.crt
-xpack.security.transport.ssl.certificate_authorities: ["$ESCONFIG/certs/ca/ca.crt"]
-xpack.security.http.ssl.key: $ESCONFIG/certs/node-data/node-data.key
-xpack.security.http.ssl.certificate: $ESCONFIG/certs//node-data/node-data.crt
-xpack.security.http.ssl.certificate_authorities: ["$ESCONFIG/certs/ca/ca.crt"]
-
-xpack.security.transport.ssl.enabled: true
-transport.port: 9301
-
-xpack.security.http.ssl.enabled: true
-http.port: 9201
-
-EOF
-DATA_SETTINGS
-
-    start_data_node
-    wait_for_xpack 127.0.0.1 9201
-}
-
-@test "[$GROUP] test connection to data node using HTTPS" {
-    load $DATA_UTILS
-    export ESHOME="$DATA_HOME"
-    export_elasticsearch_paths
-
-    run sudo -E -u $DATA_USER curl --cacert "$ESCONFIG/certs/ca/ca.crt" -XGET "https://127.0.0.1:9201"
-    [ "$status" -eq 0 ] || {
-	    echo "Failed to connect to data node using HTTPS:"
-	    echo "$output"
-	    false
-    }
-    echo "$output" | grep "missing authentication credentials"
-}
-
-@test "[$GROUP] test node to node communication" {
-    load $MASTER_UTILS
-    export ESHOME="$MASTER_HOME"
-    export_elasticsearch_paths
-
-    testIndex=$(sudo curl -u "elastic:changeme" \
-        -H "Content-Type: application/json" \
-        --cacert "$ESCONFIG/certs/ca/ca.crt" \
-        -XPOST "https://127.0.0.1:9200/books/_doc/0?refresh" \
-        -d '{"title": "Elasticsearch The Definitive Guide"}')
-
-    debug_collect_logs
-    echo "$testIndex" | grep '"result":"created"'
-
-    masterSettings=$(sudo curl -u "elastic:changeme" \
-        -H "Content-Type: application/json" \
-        --cacert "$ESCONFIG/certs/ca/ca.crt" \
-        -XGET "https://127.0.0.1:9200/_nodes/node-master?filter_path=nodes.*.settings.xpack,nodes.*.settings.http.type,nodes.*.settings.transport.type")
-
-    echo "$masterSettings" | grep '"http":{"ssl":{"enabled":"true"}'
-    echo "$masterSettings" | grep '"http":{"type":"security4"}'
-    echo "$masterSettings" | grep '"transport":{"ssl":{"enabled":"true"}'
-    echo "$masterSettings" | grep '"transport":{"type":"security4"}'
-
-    load $DATA_UTILS
-    export ESHOME="$DATA_HOME"
-    export_elasticsearch_paths
-
-    dataSettings=$(curl -u "elastic:changeme" \
-        -H "Content-Type: application/json" \
-        --cacert "$ESCONFIG/certs/ca/ca.crt" \
-        -XGET "https://127.0.0.1:9200/_nodes/node-data?filter_path=nodes.*.settings.xpack,nodes.*.settings.http.type,nodes.*.settings.transport.type")
-
-    echo "$dataSettings" | grep '"http":{"ssl":{"enabled":"true"}'
-    echo "$dataSettings" | grep '"http":{"type":"security4"}'
-    echo "$dataSettings" | grep '"transport":{"ssl":{"enabled":"true"}'
-    echo "$dataSettings" | grep '"transport":{"type":"security4"}'
-
-    testSearch=$(curl -u "elastic:changeme" \
-        -H "Content-Type: application/json" \
-        --cacert "$ESCONFIG/certs/ca/ca.crt" \
-        -XGET "https://127.0.0.1:9200/_search?q=title:guide")
-
-    echo "$testSearch" | grep '"_index":"books"'
-    echo "$testSearch" | grep '"_id":"0"'
-}
-
-@test "[$GROUP] exit code on failure" {
-    run sudo -E -u $MASTER_USER "$MASTER_HOME/bin/elasticsearch-certgen" --not-a-valid-option
-    [ "$status" -ne 0 ] || {
-        echo "Expected elasticsearch-certgen tool exit code to be non-zero"
-        echo "$output"
-        false
-    }
-}
-
-@test "[$GROUP] remove Elasticsearch" {
-    # NOTE: this must be the last test, so that running oss tests does not already have the default distro still installed
-    clean_before_test
-}
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/CertGenCliTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/CertGenCliTests.java
new file mode 100644
index 0000000000000..1893e5f682f7d
--- /dev/null
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/CertGenCliTests.java
@@ -0,0 +1,119 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.packaging.test;
+
+import org.apache.http.client.fluent.Request;
+import org.elasticsearch.packaging.util.Distribution;
+import org.elasticsearch.packaging.util.FileUtils;
+import org.elasticsearch.packaging.util.Platforms;
+import org.elasticsearch.packaging.util.ServerUtils;
+import org.elasticsearch.packaging.util.Shell;
+import org.junit.Before;
+import org.junit.BeforeClass;
+
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.Arrays;
+
+import static com.carrotsearch.randomizedtesting.RandomizedTest.assumeFalse;
+import static org.elasticsearch.packaging.util.FileMatcher.Fileness.File;
+import static org.elasticsearch.packaging.util.FileMatcher.file;
+import static org.elasticsearch.packaging.util.FileMatcher.p600;
+import static org.elasticsearch.packaging.util.FileUtils.append;
+import static org.elasticsearch.packaging.util.FileUtils.escapePath;
+import static org.elasticsearch.packaging.util.FileUtils.getTempDir;
+import static org.hamcrest.CoreMatchers.containsString;
+import static org.junit.Assume.assumeTrue;
+
+public class CertGenCliTests extends PackagingTestCase {
+    private static final Path instancesFile = getTempDir().resolve("instances.yml");
+    private static final Path certificatesFile = getTempDir().resolve("certificates.zip");
+
+    @Before
+    public void filterDistros() {
+        assumeTrue("only default distro", distribution.flavor == Distribution.Flavor.DEFAULT);
+        assumeTrue("no docker", distribution.packaging != Distribution.Packaging.DOCKER);
+    }
+
+    @BeforeClass
+    public static void cleanupFiles() {
+        FileUtils.rm(instancesFile, certificatesFile);
+    }
+
+    public void test10Install() throws Exception {
+        install();
+    }
+
+    public void test20Help() throws Exception {
+        Shell.Result result = installation.executables().certgenTool.run("--help");
+        assertThat(result.stdout, containsString("Simplifies certificate creation"));
+    }
+
+    public void test30Generate() throws Exception {
+        Files.write(instancesFile, Arrays.asList(
+            "instances:",
+            "  - name: \"mynode\"",
+            "    ip:",
+            "      - \"127.0.0.1\""));
+
+        installation.executables().certgenTool.run("--in " + instancesFile + " --out " + certificatesFile);
+
+        String owner = installation.getOwner();
+        assertThat(certificatesFile, file(File, owner, owner, p600));
+    }
+
+    public void test31ExtractCerts() throws Exception {
+        // windows 2012 r2 has powershell 4.0, which lacks Expand-Archive
+        assumeFalse(Platforms.OS_NAME.equals("Windows Server 2012 R2"));
+
+        Path certsDir = installation.config("certs");
+        sh.extractZip(certificatesFile, certsDir);
+
+        Path caDir = certsDir.resolve("ca");
+        assertThat(caDir.resolve("ca.key"), file(File, null, null, null));
+        assertThat(caDir.resolve("ca.crt"), file(File, null, null, null));
+
+        Path nodeDir = certsDir.resolve("mynode");
+        assertThat(nodeDir.resolve("mynode.key"), file(File, null, null, null));
+        assertThat(nodeDir.resolve("mynode.crt"), file(File, null, null, null));
+
+        FileUtils.cp(certsDir, installation.config("certs"));
+    }
+
+    public void test40RunWithCert() throws Exception {
+        // windows 2012 r2 has powershell 4.0, which lacks Expand-Archive
+        assumeFalse(Platforms.OS_NAME.equals("Windows Server 2012 R2"));
+        
+        append(installation.config("elasticsearch.yml"), String.join("\n",
+            "node.name: mynode",
+            "xpack.security.transport.ssl.key: " + escapePath(installation.config("certs/mynode/mynode.key")),
+            "xpack.security.transport.ssl.certificate: " + escapePath(installation.config("certs/mynode/mynode.crt")),
+            "xpack.security.transport.ssl.certificate_authorities: [\"" + escapePath(installation.config("certs/ca/ca.crt")) + "\"]",
+            "xpack.security.http.ssl.key: " + escapePath(installation.config("certs/mynode/mynode.key")),
+            "xpack.security.http.ssl.certificate: "+ escapePath(installation.config("certs/mynode/mynode.crt")),
+            "xpack.security.http.ssl.certificate_authorities: [\"" + escapePath(installation.config("certs/ca/ca.crt")) + "\"]",
+            "xpack.security.transport.ssl.enabled: true",
+            "xpack.security.http.ssl.enabled: true"));
+
+        assertWhileRunning(() -> {
+            ServerUtils.makeRequest(Request.Get("https://127.0.0.1:9200"), null, null, installation.config("certs/ca/ca.crt"));
+        });
+    }
+}
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
index da3f55daae035..c66bb3cb7f329 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/PackagingTestCase.java
@@ -175,6 +175,12 @@ protected void assertWhileRunning(Platforms.PlatformAction assertions) throws Ex
                 logger.warn("Elasticsearch log:\n" +
                     FileUtils.slurpAllLogs(installation.logs, "elasticsearch.log", "*.log.gz"));
             }
+            if (Files.exists(installation.logs.resolve("output.out"))) {
+                logger.warn("Stdout:\n" + FileUtils.slurpTxtorGz(installation.logs.resolve("output.out")));
+            }
+            if (Files.exists(installation.logs.resolve("output.err"))) {
+                logger.warn("Stderr:\n" + FileUtils.slurpTxtorGz(installation.logs.resolve("output.err")));
+            }
             throw e;
         }
 
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/PasswordToolsTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/PasswordToolsTests.java
index b08b3bfe52987..edec71a12a063 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/PasswordToolsTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/PasswordToolsTests.java
@@ -62,7 +62,8 @@ public void test20GeneratePasswords() throws Exception {
             Shell.Result result = installation.executables().setupPasswordsTool.run("auto --batch", null);
             Map<String, String> userpasses = parseUsersAndPasswords(result.stdout);
             for (Map.Entry<String, String> userpass : userpasses.entrySet()) {
-                String response = ServerUtils.makeRequest(Request.Get("http://localhost:9200"), userpass.getKey(), userpass.getValue());
+                String response = ServerUtils.makeRequest(
+                    Request.Get("http://localhost:9200"), userpass.getKey(), userpass.getValue(), null);
                 assertThat(response, containsString("You Know, for Search"));
             }
         });
@@ -111,7 +112,7 @@ public void test30AddBootstrapPassword() throws Exception {
         assertWhileRunning(() -> {
             String response = ServerUtils.makeRequest(
                 Request.Get("http://localhost:9200/_cluster/health?wait_for_status=green&timeout=180s"),
-                "elastic", BOOTSTRAP_PASSWORD);
+                "elastic", BOOTSTRAP_PASSWORD, null);
             assertThat(response, containsString("\"status\":\"green\""));
         });
     }
@@ -123,7 +124,8 @@ public void test40GeneratePasswordsBootstrapAlreadySet() throws Exception {
             Map<String, String> userpasses = parseUsersAndPasswords(result.stdout);
             assertThat(userpasses, hasKey("elastic"));
             for (Map.Entry<String, String> userpass : userpasses.entrySet()) {
-                String response = ServerUtils.makeRequest(Request.Get("http://localhost:9200"), userpass.getKey(), userpass.getValue());
+                String response = ServerUtils.makeRequest(
+                    Request.Get("http://localhost:9200"), userpass.getKey(), userpass.getValue(), null);
                 assertThat(response, containsString("You Know, for Search"));
             }
         });
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/WindowsServiceTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/WindowsServiceTests.java
index 5f4fac5f5352c..d261a2627a622 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/WindowsServiceTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/WindowsServiceTests.java
@@ -160,7 +160,7 @@ public void test21CustomizeServiceDisplayName() {
     }
 
     // NOTE: service description is not attainable through any powershell api, so checking it is not possible...
-    public void assertStartedAndStop() throws IOException {
+    public void assertStartedAndStop() throws Exception {
         ServerUtils.waitForElasticsearch(installation);
         ServerUtils.runElasticsearchTests();
 
@@ -191,7 +191,7 @@ public void assertStartedAndStop() throws IOException {
             "}");
     }
 
-    public void test30StartStop() throws IOException {
+    public void test30StartStop() throws Exception {
         sh.run(serviceScript + " install");
         assertCommand(serviceScript + " start");
         assertStartedAndStop();
@@ -209,7 +209,7 @@ public void test32StopNotStarted() throws IOException {
         assertThat(result.stdout, containsString("The service '" + DEFAULT_ID + "' has been stopped"));
     }
 
-    public void test33JavaChanged() throws IOException {
+    public void test33JavaChanged() throws Exception {
         final Path relocatedJdk = installation.bundledJdk.getParent().resolve("jdk.relocated");
 
         try {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
index ef3382cd86eff..8cbe7a7c6a987 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Docker.java
@@ -26,7 +26,6 @@
 import org.apache.http.client.fluent.Request;
 import org.elasticsearch.common.CheckedRunnable;
 
-import java.io.IOException;
 import java.nio.file.Path;
 import java.nio.file.Paths;
 import java.nio.file.attribute.PosixFileAttributes;
@@ -503,7 +502,7 @@ private static <E extends Exception> void withLogging(CheckedRunnable<E> r) thro
         }
     }
 
-    public static JsonNode getJson(String path) throws IOException {
+    public static JsonNode getJson(String path) throws Exception {
         final String pluginsResponse = makeRequest(Request.Get("http://localhost:9200/" + path));
 
         ObjectMapper mapper = new ObjectMapper();
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/FileMatcher.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/FileMatcher.java
index 57c74a8c68e01..90edb42829db1 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/FileMatcher.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/FileMatcher.java
@@ -62,7 +62,7 @@ public enum Fileness { File, Directory }
 
     public FileMatcher(Fileness fileness, String owner, String group, Set<PosixFilePermission> posixPermissions) {
         this.fileness = Objects.requireNonNull(fileness);
-        this.owner = Objects.requireNonNull(owner);
+        this.owner = owner;
         this.group = group;
         this.posixPermissions = posixPermissions;
     }
@@ -76,16 +76,18 @@ protected boolean matchesSafely(Path path) {
 
         if (Platforms.WINDOWS) {
             final BasicFileAttributes attributes = getBasicFileAttributes(path);
-            final String attributeViewOwner = getFileOwner(path);
 
             if (fileness.equals(Fileness.Directory) != attributes.isDirectory()) {
                 mismatch = "Is " + (attributes.isDirectory() ? "a directory" : "a file");
                 return false;
             }
 
-            if (attributeViewOwner.contains(owner) == false) {
-                mismatch = "Owned by " + attributeViewOwner;
-                return false;
+            if (owner != null) {
+                final String attributeViewOwner = getFileOwner(path);
+                if (attributeViewOwner.contains(owner) == false) {
+                    mismatch = "Owned by " + attributeViewOwner;
+                    return false;
+                }
             }
         } else {
             final PosixFileAttributes attributes = getPosixFileAttributes(path);
@@ -95,7 +97,7 @@ protected boolean matchesSafely(Path path) {
                 return false;
             }
 
-            if (owner.equals(attributes.owner().getName()) == false) {
+            if (owner != null && owner.equals(attributes.owner().getName()) == false) {
                 mismatch = "Owned by " + attributes.owner().getName();
                 return false;
             }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/FileUtils.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/FileUtils.java
index 2efb757037c90..eb57e66239eec 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/FileUtils.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/FileUtils.java
@@ -286,7 +286,7 @@ public static Map<String, Integer> getNumericUnixPathOwnership(Path path) {
 
     // vagrant creates /tmp for us in windows so we use that to avoid long paths
     public static Path getTempDir() {
-        return Paths.get("/tmp");
+        return Paths.get("/tmp").toAbsolutePath();
     }
 
     public static Path getDefaultArchiveInstallPath() {
@@ -339,4 +339,15 @@ public static void deleteIfExists(Path path) {
             }
         }
     }
+
+    /**
+     * Return the given path a string suitable for using on the host system.
+     */
+    public static String escapePath(Path path) {
+        if (Platforms.WINDOWS) {
+            // replace single backslash with forward slash, to avoid unintended escapes in scripts
+            return path.toString().replace('\\', '/');
+        }
+        return path.toString();
+    }
 }
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
index a237da3ea1962..717f15aebc6d9 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
@@ -114,6 +114,19 @@ public static Installation ofContainer(Shell sh, Distribution distribution) {
         );
     }
 
+    /**
+     * Returns the user that owns this installation.
+     *
+     * For packages this is root, and for archives it is the user doing the installation.
+     */
+    public String getOwner() {
+        if (Platforms.WINDOWS) {
+            // windows is always administrator, since there is no sudo
+            return "BUILTIN\\Administrators";
+        }
+        return distribution.isArchive() ? ARCHIVE_OWNER : "root";
+    }
+
     public Path bin(String executableName) {
         return bin.resolve(executableName);
     }
@@ -147,7 +160,7 @@ public Shell.Result run(String args) {
 
         public Shell.Result run(String args, String input) {
             String command = path + " " + args;
-            if (distribution.isArchive() && distribution.platform != Distribution.Platform.WINDOWS) {
+            if (distribution.isArchive() && Platforms.WINDOWS == false) {
                 command = "sudo -E -u " + ARCHIVE_OWNER + " " + command;
             }
             if (input != null) {
@@ -163,6 +176,7 @@ public class Executables {
         public final Executable pluginTool = new Executable("elasticsearch-plugin");
         public final Executable keystoreTool = new Executable("elasticsearch-keystore");
         public final Executable certutilTool = new Executable("elasticsearch-certutil");
+        public final Executable certgenTool = new Executable("elasticsearch-certgen");
         public final Executable shardTool = new Executable("elasticsearch-shard");
         public final Executable nodeTool = new Executable("elasticsearch-node");
         public final Executable setupPasswordsTool = new Executable("elasticsearch-setup-passwords");
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
index 036358696d21d..26817a60889fe 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Packages.java
@@ -305,7 +305,7 @@ public static void clearJournal(Shell sh) {
         }
     }
 
-    public static void assertElasticsearchStarted(Shell sh, Installation installation) throws IOException {
+    public static void assertElasticsearchStarted(Shell sh, Installation installation) throws Exception {
         waitForElasticsearch(installation);
 
         if (isSystemd()) {
@@ -324,7 +324,7 @@ public static void stopElasticsearch(Shell sh) {
         }
     }
 
-    public static void restartElasticsearch(Shell sh, Installation installation) throws IOException {
+    public static void restartElasticsearch(Shell sh, Installation installation) throws Exception {
         if (isSystemd()) {
             sh.run("systemctl restart elasticsearch.service");
         } else {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/ServerUtils.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/ServerUtils.java
index 40aee0a014175..6ba33b56b30d4 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/ServerUtils.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/ServerUtils.java
@@ -23,17 +23,32 @@
 import org.apache.http.HttpResponse;
 import org.apache.http.client.fluent.Executor;
 import org.apache.http.client.fluent.Request;
+import org.apache.http.config.Registry;
+import org.apache.http.config.RegistryBuilder;
+import org.apache.http.conn.socket.ConnectionSocketFactory;
+import org.apache.http.conn.socket.LayeredConnectionSocketFactory;
+import org.apache.http.conn.socket.PlainConnectionSocketFactory;
+import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
 import org.apache.http.entity.ContentType;
+import org.apache.http.impl.client.HttpClientBuilder;
+import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
 import org.apache.http.util.EntityUtils;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 
+import javax.net.ssl.KeyManagerFactory;
+import javax.net.ssl.SSLContext;
+import javax.net.ssl.TrustManagerFactory;
 import java.io.IOException;
+import java.io.InputStream;
 import java.net.InetAddress;
 import java.net.Socket;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.security.KeyStore;
+import java.security.cert.CertificateFactory;
+import java.security.cert.X509Certificate;
 import java.util.Objects;
 import java.util.concurrent.TimeUnit;
 
@@ -45,24 +60,25 @@ public class ServerUtils {
     private static final Logger logger =  LogManager.getLogger(ServerUtils.class);
 
     private static String SECURITY_ENABLED = "xpack.security.enabled: true";
+    private static String SSL_ENABLED = "xpack.security.http.ssl.enabled: true";
 
     // generous timeout  as nested virtualization can be quite slow ...
     private static final long waitTime = TimeUnit.MINUTES.toMillis(3);
     private static final long timeoutLength = TimeUnit.SECONDS.toMillis(30);
     private static final long requestInterval = TimeUnit.SECONDS.toMillis(5);
 
-    public static void waitForElasticsearch(Installation installation) throws IOException {
-        boolean securityEnabled = false;
+    public static void waitForElasticsearch(Installation installation) throws Exception {
+        boolean xpackEnabled = false;
 
         // TODO: need a way to check if docker has security enabled, the yml config is not bind mounted so can't look from here
         if (installation.distribution.packaging != Distribution.Packaging.DOCKER) {
             Path configFilePath = installation.config("elasticsearch.yml");
             // this is fragile, but currently doesn't deviate from a single line enablement and not worth the parsing effort
             String configFile = Files.readString(configFilePath, StandardCharsets.UTF_8);
-            securityEnabled = configFile.contains(SECURITY_ENABLED);
+            xpackEnabled = configFile.contains(SECURITY_ENABLED) || configFile.contains(SSL_ENABLED);
         }
 
-        if (securityEnabled) {
+        if (xpackEnabled) {
             // with security enabled, we may or may not have setup a user/pass, so we use a more generic port being available check.
             // this isn't as good as a health check, but long term all this waiting should go away when node startup does not
             // make the http port available until the system is really ready to serve requests
@@ -78,17 +94,46 @@ public static void waitForElasticsearch(Installation installation) throws IOExce
      * @param request the request to execute
      * @param username the username to supply, or null
      * @param password the password to supply, or null
+     * @param caCert path to the ca certificate the server side ssl cert was generated from, or no if not using ssl
      * @return the response from the server
      * @throws IOException if an error occurs
      */
-    private static HttpResponse execute(Request request, String username, String password) throws IOException {
-        final Executor executor = Executor.newInstance();
+    private static HttpResponse execute(Request request, String username, String password, Path caCert) throws Exception {
+        final Executor executor;
+        if (caCert != null) {
+            try (InputStream inStream = Files.newInputStream(caCert)) {
+                CertificateFactory cf = CertificateFactory.getInstance("X.509");
+                X509Certificate cert = (X509Certificate) cf.generateCertificate(inStream);
+                KeyStore truststore = KeyStore.getInstance(KeyStore.getDefaultType());
+                truststore.load(null, null);
+                truststore.setCertificateEntry("myClusterCA", cert);
+                KeyManagerFactory kmf = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());
+                kmf.init(truststore, null);
+                TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
+                tmf.init(truststore);
+                SSLContext context = SSLContext.getInstance("TLSv1.2");
+                context.init(kmf.getKeyManagers(), tmf.getTrustManagers(), null);
+                final LayeredConnectionSocketFactory ssl = new SSLConnectionSocketFactory(context);
+                final Registry<ConnectionSocketFactory> sfr = RegistryBuilder.<ConnectionSocketFactory>create()
+                    .register("http", PlainConnectionSocketFactory.getSocketFactory())
+                    .register("https", ssl)
+                    .build();
+                PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager(sfr);
+                connectionManager.setDefaultMaxPerRoute(100);
+                connectionManager.setMaxTotal(200);
+                connectionManager.setValidateAfterInactivity(1000);
+                executor = Executor.newInstance(HttpClientBuilder.create()
+                    .setConnectionManager(connectionManager)
+                    .build());
+            }
+        } else {
+            executor = Executor.newInstance();
+        }
 
         if (username != null && password != null) {
             executor.auth(username, password);
             executor.authPreemptive(new HttpHost("localhost", 9200));
         }
-
         return executor.execute(request).returnResponse();
     }
 
@@ -118,7 +163,7 @@ public static void waitForElasticsearch(
         Installation installation,
         String username,
         String password
-    ) throws IOException {
+    ) throws Exception {
 
         Objects.requireNonNull(status);
 
@@ -129,6 +174,11 @@ public static void waitForElasticsearch(
         boolean started = false;
         Throwable thrownException = null;
 
+        Path caCert = installation.config("certs/ca/ca.crt");
+        if (Files.exists(caCert) == false) {
+            caCert = null; // no cert, so don't use ssl
+        }
+
         while (started == false && timeElapsed < waitTime) {
             if (System.currentTimeMillis() - lastRequest > requestInterval) {
                 try {
@@ -139,7 +189,8 @@ public static void waitForElasticsearch(
                             .connectTimeout((int) timeoutLength)
                             .socketTimeout((int) timeoutLength),
                         username,
-                        password
+                        password,
+                        caCert
                     );
 
                     if (response.getStatusLine().getStatusCode() >= 300) {
@@ -179,11 +230,11 @@ public static void waitForElasticsearch(
             url = "http://localhost:9200/_cluster/health/" + index + "?wait_for_status=" + status + "&timeout=60s&pretty";
         }
 
-        final String body = makeRequest(Request.Get(url), username, password);
+        final String body = makeRequest(Request.Get(url), username, password, caCert);
         assertThat("cluster health response must contain desired status", body, containsString(status));
     }
 
-    public static void runElasticsearchTests() throws IOException {
+    public static void runElasticsearchTests() throws Exception {
         makeRequest(
             Request.Post("http://localhost:9200/library/_doc/1?refresh=true&pretty")
                 .bodyString("{ \"title\": \"Book #1\", \"pages\": 123 }", ContentType.APPLICATION_JSON));
@@ -198,12 +249,12 @@ public static void runElasticsearchTests() throws IOException {
         makeRequest(Request.Delete("http://localhost:9200/_all"));
     }
 
-    public static String makeRequest(Request request) throws IOException {
-        return makeRequest(request, null, null);
+    public static String makeRequest(Request request) throws Exception {
+        return makeRequest(request, null, null, null);
     }
 
-    public static String makeRequest(Request request, String username, String password) throws IOException {
-        final HttpResponse response = execute(request, username, password);
+    public static String makeRequest(Request request, String username, String password, Path caCert) throws Exception {
+        final HttpResponse response = execute(request, username, password, caCert);
         final String body = EntityUtils.toString(response.getEntity());
 
         if (response.getStatusLine().getStatusCode() >= 300) {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
index e0fae3d095578..18988a7310fb4 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
@@ -98,7 +98,12 @@ public void chown(Path path) throws Exception {
         ));
     }
 
-    public Result run( String command, Object... args) {
+    public void extractZip(Path zipPath, Path destinationDir) throws Exception {
+        Platforms.onLinux(() -> run("unzip \"" + zipPath + "\" -d \"" + destinationDir + "\""));
+        Platforms.onWindows(() -> run("Expand-Archive -Path \"" + zipPath + "\" -DestinationPath \"" + destinationDir + "\""));
+    }
+
+    public Result run(String command, Object... args) {
         String formattedCommand = String.format(Locale.ROOT, command, args);
         return run(formattedCommand);
     }

From 559e56b0eac7c717536140a790f5a0aa5e1b93fe Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Mon, 13 Jan 2020 13:44:56 -0700
Subject: [PATCH 531/686] =?UTF-8?q?Refresh=20cached=20phase=20policy=20def?=
 =?UTF-8?q?inition=20if=20possible=20on=20new=20poli=E2=80=A6=20(#50820)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Refresh cached phase policy definition if possible on new policy

There are some cases when updating a policy does not change the
structure in a significant way. In these cases, we can reread the
policy definition for any indices using the updated policy.

This commit adds this refreshing to the `TransportPutLifecycleAction`
to allow this. It allows us to do things like change the configuration
values for a particular step, even when on that step (for example,
changing the rollover criteria while on the `check-rollover-ready` step).

There are more cases where the phase definition can be reread that just
the ones checked here (for example, removing an action that has already
been passed), and those will be added in subsequent work.

Relates to #48431
---
 .../reference/ilm/policy-definitions.asciidoc |  14 +-
 .../ilm/TimeSeriesLifecycleActionsIT.java     |  35 ++
 .../xpack/ilm/IndexLifecycleTransition.java   |   4 +-
 .../action/TransportPutLifecycleAction.java   | 215 +++++++-
 .../TransportPutLifecycleActionTests.java     | 499 ++++++++++++++++++
 5 files changed, 756 insertions(+), 11 deletions(-)
 create mode 100644 x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java

diff --git a/docs/reference/ilm/policy-definitions.asciidoc b/docs/reference/ilm/policy-definitions.asciidoc
index 65401a5c866d7..b8c4121278e16 100644
--- a/docs/reference/ilm/policy-definitions.asciidoc
+++ b/docs/reference/ilm/policy-definitions.asciidoc
@@ -55,7 +55,7 @@ PUT _ilm/policy/my_policy
 }
 --------------------------------------------------
 
-The Above example configures a policy that moves the index into the warm
+The above example configures a policy that moves the index into the warm
 phase after one day. Until then, the index is in a waiting state. After
 moving into the warm phase, it will wait until 30 days have elapsed before
 moving to the delete phase and deleting the index.
@@ -76,10 +76,14 @@ check occurs.
 === Phase Execution
 
 The current phase definition, of an index's policy being executed, is stored
-in the index's metadata. The phase and its actions are compiled into a series
-of discrete steps that are executed sequentially. Since some {ilm-init} actions
-are more complex and involve multiple operations against an index, each of these
-operations are done in isolation in a unit called a "step". The
+in the index's metadata. This phase definition is cached to prevent changes to
+the policy from putting the index in a state where it cannot proceed from its
+current step. When the policy is updated we check to see if this phase
+definition can be safely updated, and if so, update the cached definition in
+indices using the updated policy. The phase and its actions are compiled into a
+series of discrete steps that are executed sequentially. Since some {ilm-init}
+actions are more complex and involve multiple operations against an index, each
+of these operations are done in isolation in a unit called a "step". The
 <<ilm-explain-lifecycle,Explain Lifecycle API>> exposes this information to us
 to see which step our index is either to execute next, or is currently
 executing.
diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 749a7354ac99c..9b0b759bdc667 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -1350,6 +1350,41 @@ public void testRetryableInitializationStep() throws Exception {
         });
     }
 
+    public void testRefreshablePhaseJson() throws Exception {
+        String index = "refresh-index";
+
+        createNewSingletonPolicy("hot", new RolloverAction(null, null, 100L));
+        Request createIndexTemplate = new Request("PUT", "_template/rolling_indexes");
+        createIndexTemplate.setJsonEntity("{" +
+            "\"index_patterns\": [\""+ index + "-*\"], \n" +
+            "  \"settings\": {\n" +
+            "    \"number_of_shards\": 1,\n" +
+            "    \"number_of_replicas\": 0,\n" +
+            "    \"index.lifecycle.name\": \"" + policy+ "\",\n" +
+            "    \"index.lifecycle.rollover_alias\": \"alias\"\n" +
+            "  }\n" +
+            "}");
+        client().performRequest(createIndexTemplate);
+
+        createIndexWithSettings(index + "-1",
+            Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0),
+            true);
+
+        // Index a document
+        index(client(), index + "-1", "1", "foo", "bar");
+
+        // Wait for the index to enter the check-rollover-ready step
+        assertBusy(() -> assertThat(getStepKeyForIndex(index + "-1").getName(), equalTo(WaitForRolloverReadyStep.NAME)));
+
+        // Update the policy to allow rollover at 1 document instead of 100
+        createNewSingletonPolicy("hot", new RolloverAction(null, null, 1L));
+
+        // Index should now have been able to roll over, creating the new index and proceeding to the "complete" step
+        assertBusy(() -> assertThat(indexExists(index + "-000002"), is(true)));
+        assertBusy(() -> assertThat(getStepKeyForIndex(index + "-1").getName(), equalTo(TerminalPolicyStep.KEY.getName())));
+    }
+
     // This method should be called inside an assertBusy, it has no retry logic of its own
     private void assertHistoryIsPresent(String policyName, String indexName, boolean success, String stepName) throws IOException {
         assertHistoryIsPresent(policyName, indexName, success, null, null, stepName);
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransition.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransition.java
index 816186882927c..0f6696b0be537 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransition.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/IndexLifecycleTransition.java
@@ -251,8 +251,8 @@ private static LifecycleExecutionState updateExecutionStateToStep(LifecyclePolic
     /**
      * Given a cluster state and lifecycle state, return a new state using the new lifecycle state for the given index.
      */
-    private static ClusterState.Builder newClusterStateWithLifecycleState(Index index, ClusterState clusterState,
-                                                                          LifecycleExecutionState lifecycleState) {
+    public static ClusterState.Builder newClusterStateWithLifecycleState(Index index, ClusterState clusterState,
+                                                                         LifecycleExecutionState lifecycleState) {
         ClusterState.Builder newClusterStateBuilder = ClusterState.builder(clusterState);
         newClusterStateBuilder.metaData(MetaData.builder(clusterState.getMetaData())
             .put(IndexMetaData.builder(clusterState.getMetaData().index(index))
diff --git a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleAction.java b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleAction.java
index e5139c1b02f2a..a05768cc72a32 100644
--- a/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleAction.java
+++ b/x-pack/plugin/ilm/src/main/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleAction.java
@@ -8,35 +8,55 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.message.ParameterizedMessage;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.master.TransportMasterNodeAction;
+import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.AckedClusterStateUpdateTask;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.block.ClusterBlockException;
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.xcontent.DeprecationHandler;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.ClientHelper;
+import org.elasticsearch.xpack.core.ilm.ErrorStep;
 import org.elasticsearch.xpack.core.ilm.IndexLifecycleMetadata;
+import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
 import org.elasticsearch.xpack.core.ilm.LifecyclePolicy;
 import org.elasticsearch.xpack.core.ilm.LifecyclePolicyMetadata;
+import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
+import org.elasticsearch.xpack.core.ilm.PhaseExecutionInfo;
+import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.action.PutLifecycleAction;
 import org.elasticsearch.xpack.core.ilm.action.PutLifecycleAction.Request;
 import org.elasticsearch.xpack.core.ilm.action.PutLifecycleAction.Response;
+import org.elasticsearch.xpack.ilm.IndexLifecycleTransition;
 
 import java.io.IOException;
 import java.time.Instant;
+import java.util.LinkedHashSet;
+import java.util.List;
 import java.util.Map;
+import java.util.Set;
 import java.util.SortedMap;
+import java.util.Spliterators;
 import java.util.TreeMap;
 import java.util.stream.Collectors;
+import java.util.stream.StreamSupport;
 
 /**
  * This class is responsible for bootstrapping {@link IndexLifecycleMetadata} into the cluster-state, as well
@@ -45,12 +65,17 @@
 public class TransportPutLifecycleAction extends TransportMasterNodeAction<Request, Response> {
 
     private static final Logger logger = LogManager.getLogger(TransportPutLifecycleAction.class);
+    private final NamedXContentRegistry xContentRegistry;
+    private final Client client;
 
     @Inject
     public TransportPutLifecycleAction(TransportService transportService, ClusterService clusterService, ThreadPool threadPool,
-                                       ActionFilters actionFilters, IndexNameExpressionResolver indexNameExpressionResolver) {
+                                       ActionFilters actionFilters, IndexNameExpressionResolver indexNameExpressionResolver,
+                                       NamedXContentRegistry namedXContentRegistry, Client client) {
         super(PutLifecycleAction.NAME, transportService, clusterService, threadPool, actionFilters, Request::new,
             indexNameExpressionResolver);
+        this.xContentRegistry = namedXContentRegistry;
+        this.client = client;
     }
 
     @Override
@@ -82,7 +107,7 @@ protected Response newResponse(boolean acknowledged) {
 
                     @Override
                     public ClusterState execute(ClusterState currentState) throws Exception {
-                        ClusterState.Builder newState = ClusterState.builder(currentState);
+                        ClusterState.Builder stateBuilder = ClusterState.builder(currentState);
                         IndexLifecycleMetadata currentMetadata = currentState.metaData().custom(IndexLifecycleMetadata.TYPE);
                         if (currentMetadata == null) { // first time using index-lifecycle feature, bootstrap metadata
                             currentMetadata = IndexLifecycleMetadata.EMPTY;
@@ -100,13 +125,195 @@ public ClusterState execute(ClusterState currentState) throws Exception {
                             logger.info("updating index lifecycle policy [{}]", request.getPolicy().getName());
                         }
                         IndexLifecycleMetadata newMetadata = new IndexLifecycleMetadata(newPolicies, currentMetadata.getOperationMode());
-                        newState.metaData(MetaData.builder(currentState.getMetaData())
+                        stateBuilder.metaData(MetaData.builder(currentState.getMetaData())
                                 .putCustom(IndexLifecycleMetadata.TYPE, newMetadata).build());
-                        return newState.build();
+                        ClusterState nonRefreshedState = stateBuilder.build();
+                        if (oldPolicy == null) {
+                            return nonRefreshedState;
+                        } else {
+                            try {
+                                return updateIndicesForPolicy(nonRefreshedState, xContentRegistry, client,
+                                    oldPolicy.getPolicy(), lifecyclePolicyMetadata);
+                            } catch (Exception e) {
+                                logger.warn(new ParameterizedMessage("unable to refresh indices phase JSON for updated policy [{}]",
+                                    oldPolicy.getName()), e);
+                                // Revert to the non-refreshed state
+                                return nonRefreshedState;
+                            }
+                        }
                     }
                 });
     }
 
+    /**
+     * Ensure that we have the minimum amount of metadata necessary to check for cache phase
+     * refresh. This includes:
+     * - An execution state
+     * - Existing phase definition JSON
+     * - A current step key
+     * - A current phase in the step key
+     * - Not currently in the ERROR step
+     */
+    static boolean eligibleToCheckForRefresh(final IndexMetaData metaData) {
+        LifecycleExecutionState executionState = LifecycleExecutionState.fromIndexMetadata(metaData);
+        if (executionState == null || executionState.getPhaseDefinition() == null) {
+            return false;
+        }
+
+        Step.StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(executionState);
+        if (currentStepKey == null || currentStepKey.getPhase() == null) {
+            return false;
+        }
+
+        return ErrorStep.NAME.equals(currentStepKey.getName()) == false;
+    }
+
+    /**
+     * Parse the {@code phaseDef} phase definition to get the stepkeys for the given phase.
+     * If there is an error parsing or if the phase definition is missing the required
+     * information, returns null.
+     */
+    @Nullable
+    static Set<Step.StepKey> readStepKeys(final NamedXContentRegistry xContentRegistry, final Client client,
+                                          final String phaseDef, final String currentPhase) {
+        final PhaseExecutionInfo phaseExecutionInfo;
+        try (XContentParser parser = JsonXContent.jsonXContent.createParser(xContentRegistry,
+            DeprecationHandler.THROW_UNSUPPORTED_OPERATION, phaseDef)) {
+            phaseExecutionInfo = PhaseExecutionInfo.parse(parser, currentPhase);
+        } catch (Exception e) {
+            logger.trace(new ParameterizedMessage("exception reading step keys checking for refreshability, phase definition: {}",
+                phaseDef), e);
+            return null;
+        }
+
+        if (phaseExecutionInfo == null || phaseExecutionInfo.getPhase() == null) {
+            return null;
+        }
+
+        return phaseExecutionInfo.getPhase().getActions().values().stream()
+            .flatMap(a -> a.toSteps(client, phaseExecutionInfo.getPhase().getName(), null).stream())
+            .map(Step::getKey)
+            .collect(Collectors.toCollection(LinkedHashSet::new));
+    }
+
+    /**
+     * Returns 'true' if the index's cached phase JSON can be safely reread, 'false' otherwise.
+     */
+    static boolean isIndexPhaseDefinitionUpdatable(final NamedXContentRegistry xContentRegistry, final Client client,
+                                                   final IndexMetaData metaData, final LifecyclePolicy newPolicy) {
+        final String index = metaData.getIndex().getName();
+        if (eligibleToCheckForRefresh(metaData) == false) {
+            logger.debug("[{}] does not contain enough information to check for eligibility of refreshing phase", index);
+            return false;
+        }
+        final String policyId = newPolicy.getName();
+
+        final LifecycleExecutionState executionState = LifecycleExecutionState.fromIndexMetadata(metaData);
+        final Step.StepKey currentStepKey = LifecycleExecutionState.getCurrentStepKey(executionState);
+        final String currentPhase = currentStepKey.getPhase();
+
+        final Set<Step.StepKey> newStepKeys = newPolicy.toSteps(client).stream()
+            .map(Step::getKey)
+            .collect(Collectors.toCollection(LinkedHashSet::new));
+
+        if (newStepKeys.contains(currentStepKey) == false) {
+            // The index is on a step that doesn't exist in the new policy, we
+            // can't safely re-read the JSON
+            logger.debug("[{}] updated policy [{}] does not contain the current step key [{}], so the policy phase will not be refreshed",
+                index, policyId, currentStepKey);
+            return false;
+        }
+
+        final String phaseDef = executionState.getPhaseDefinition();
+        final Set<Step.StepKey> oldStepKeys = readStepKeys(xContentRegistry, client, phaseDef, currentPhase);
+        if (oldStepKeys == null) {
+            logger.debug("[{}] unable to parse phase definition for cached policy [{}], policy phase will not be refreshed",
+                index, policyId);
+            return false;
+        }
+
+        final Set<Step.StepKey> oldPhaseStepKeys = oldStepKeys.stream()
+            .filter(sk -> currentPhase.equals(sk.getPhase()))
+            .collect(Collectors.toCollection(LinkedHashSet::new));
+
+        final PhaseExecutionInfo phaseExecutionInfo = new PhaseExecutionInfo(policyId, newPolicy.getPhases().get(currentPhase), 1L, 1L);
+        final String peiJson = Strings.toString(phaseExecutionInfo);
+
+        final Set<Step.StepKey> newPhaseStepKeys = readStepKeys(xContentRegistry, client, peiJson, currentPhase);
+        if (newPhaseStepKeys == null) {
+            logger.debug(new ParameterizedMessage("[{}] unable to parse phase definition for policy [{}] " +
+                "to determine if it could be refreshed", index, policyId));
+            return false;
+        }
+
+        if (newPhaseStepKeys.equals(oldPhaseStepKeys)) {
+            // The new and old phase have the same stepkeys for this current phase, so we can
+            // refresh the definition because we know it won't change the execution flow.
+            logger.debug("[{}] updated policy [{}] contains the same phase step keys and can be refreshed", index, policyId);
+            return true;
+        } else {
+            logger.debug("[{}] updated policy [{}] has different phase step keys and will NOT refresh phase " +
+                    "definition as it differs too greatly. old: {}, new: {}",
+                index, policyId, oldPhaseStepKeys, newPhaseStepKeys);
+            return false;
+        }
+    }
+
+    /**
+     * Rereads the phase JSON for the given index, returning a new cluster state.
+     */
+    static ClusterState refreshPhaseDefinition(final ClusterState state, final String index, final LifecyclePolicyMetadata updatedPolicy) {
+        final IndexMetaData idxMeta = state.metaData().index(index);
+        assert eligibleToCheckForRefresh(idxMeta) : "index " + index + " is missing crucial information needed to refresh phase definition";
+
+        logger.trace("[{}] updating cached phase definition for policy [{}]", index, updatedPolicy.getName());
+        LifecycleExecutionState currentExState = LifecycleExecutionState.fromIndexMetadata(idxMeta);
+
+        String currentPhase = currentExState.getPhase();
+        PhaseExecutionInfo pei = new PhaseExecutionInfo(updatedPolicy.getName(),
+            updatedPolicy.getPolicy().getPhases().get(currentPhase), updatedPolicy.getVersion(), updatedPolicy.getModifiedDate());
+
+        LifecycleExecutionState newExState = LifecycleExecutionState.builder(currentExState)
+            .setPhaseDefinition(Strings.toString(pei, false, false))
+            .build();
+
+        return IndexLifecycleTransition.newClusterStateWithLifecycleState(idxMeta.getIndex(), state, newExState).build();
+    }
+
+    /**
+     * For the given new policy, returns a new cluster with all updateable indices' phase JSON refreshed.
+     */
+    static ClusterState updateIndicesForPolicy(final ClusterState state, final NamedXContentRegistry xContentRegistry, final Client client,
+                                               final LifecyclePolicy oldPolicy, final LifecyclePolicyMetadata newPolicy) {
+        assert oldPolicy.getName().equals(newPolicy.getName()) : "expected both policies to have the same id but they were: [" +
+            oldPolicy.getName() + "] vs. [" + newPolicy.getName() + "]";
+
+        // No need to update anything if the policies are identical in contents
+        if (oldPolicy.equals(newPolicy.getPolicy())) {
+            logger.debug("policy [{}] is unchanged and no phase definition refresh is needed", oldPolicy.getName());
+            return state;
+        }
+
+        final List<String> indicesThatCanBeUpdated =
+            StreamSupport.stream(Spliterators.spliteratorUnknownSize(state.metaData().indices().valuesIt(), 0), false)
+                .filter(meta -> newPolicy.getName().equals(LifecycleSettings.LIFECYCLE_NAME_SETTING.get(meta.getSettings())))
+                .filter(meta -> isIndexPhaseDefinitionUpdatable(xContentRegistry, client, meta, newPolicy.getPolicy()))
+                .map(meta -> meta.getIndex().getName())
+                .collect(Collectors.toList());
+
+        ClusterState updatedState = state;
+        for (String index : indicesThatCanBeUpdated) {
+            try {
+                updatedState = refreshPhaseDefinition(updatedState, index, newPolicy);
+            } catch (Exception e) {
+                logger.warn(new ParameterizedMessage("[{}] unable to refresh phase definition for updated policy [{}]",
+                    index, newPolicy.getName()), e);
+            }
+        }
+
+        return updatedState;
+    }
+
     @Override
     protected ClusterBlockException checkBlock(Request request, ClusterState state) {
         return state.blocks().globalBlockedException(ClusterBlockLevel.METADATA_WRITE);
diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java
new file mode 100644
index 0000000000000..f2f67fa281f90
--- /dev/null
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java
@@ -0,0 +1,499 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ilm.action;
+
+import org.elasticsearch.Version;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ilm.AllocateAction;
+import org.elasticsearch.xpack.core.ilm.AllocationRoutedStep;
+import org.elasticsearch.xpack.core.ilm.ErrorStep;
+import org.elasticsearch.xpack.core.ilm.ForceMergeAction;
+import org.elasticsearch.xpack.core.ilm.FreezeAction;
+import org.elasticsearch.xpack.core.ilm.LifecycleAction;
+import org.elasticsearch.xpack.core.ilm.LifecycleExecutionState;
+import org.elasticsearch.xpack.core.ilm.LifecyclePolicy;
+import org.elasticsearch.xpack.core.ilm.LifecyclePolicyMetadata;
+import org.elasticsearch.xpack.core.ilm.LifecycleSettings;
+import org.elasticsearch.xpack.core.ilm.Phase;
+import org.elasticsearch.xpack.core.ilm.PhaseExecutionInfo;
+import org.elasticsearch.xpack.core.ilm.ReadOnlyAction;
+import org.elasticsearch.xpack.core.ilm.RolloverAction;
+import org.elasticsearch.xpack.core.ilm.RolloverStep;
+import org.elasticsearch.xpack.core.ilm.SegmentCountStep;
+import org.elasticsearch.xpack.core.ilm.SetPriorityAction;
+import org.elasticsearch.xpack.core.ilm.Step;
+import org.elasticsearch.xpack.core.ilm.UpdateRolloverLifecycleDateStep;
+import org.elasticsearch.xpack.core.ilm.WaitForRolloverReadyStep;
+import org.elasticsearch.xpack.ilm.IndexLifecycle;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.elasticsearch.xpack.core.ilm.LifecycleExecutionState.ILM_CUSTOM_METADATA_KEY;
+import static org.hamcrest.Matchers.contains;
+import static org.hamcrest.Matchers.equalTo;
+import static org.mockito.Mockito.mock;
+
+public class TransportPutLifecycleActionTests extends ESTestCase {
+    private static final NamedXContentRegistry REGISTRY;
+    private static final Client client = mock(Client.class);
+    private static final String index = "eggplant";
+
+    static {
+        try (IndexLifecycle indexLifecycle = new IndexLifecycle(Settings.EMPTY)) {
+            List<NamedXContentRegistry.Entry> entries = new ArrayList<>(indexLifecycle.getNamedXContent());
+            REGISTRY = new NamedXContentRegistry(entries);
+        }
+    }
+
+    public void testEligibleForRefresh() {
+        IndexMetaData meta = mkMeta().build();
+        assertFalse(TransportPutLifecycleAction.eligibleToCheckForRefresh(meta));
+
+        LifecycleExecutionState state = LifecycleExecutionState.builder().build();
+        meta = mkMeta().putCustom(ILM_CUSTOM_METADATA_KEY, state.asMap()).build();
+        assertFalse(TransportPutLifecycleAction.eligibleToCheckForRefresh(meta));
+
+        state = LifecycleExecutionState.builder()
+            .setPhase("phase")
+            .setAction("action")
+            .setStep("step")
+            .build();
+        meta = mkMeta().putCustom(ILM_CUSTOM_METADATA_KEY, state.asMap()).build();
+        assertFalse(TransportPutLifecycleAction.eligibleToCheckForRefresh(meta));
+
+        state = LifecycleExecutionState.builder()
+            .setPhaseDefinition("{}")
+            .build();
+        meta = mkMeta().putCustom(ILM_CUSTOM_METADATA_KEY, state.asMap()).build();
+        assertFalse(TransportPutLifecycleAction.eligibleToCheckForRefresh(meta));
+
+        state = LifecycleExecutionState.builder()
+            .setPhase("phase")
+            .setAction("action")
+            .setStep(ErrorStep.NAME)
+            .setPhaseDefinition("{}")
+            .build();
+        meta = mkMeta().putCustom(ILM_CUSTOM_METADATA_KEY, state.asMap()).build();
+        assertFalse(TransportPutLifecycleAction.eligibleToCheckForRefresh(meta));
+
+        state = LifecycleExecutionState.builder()
+            .setPhase("phase")
+            .setAction("action")
+            .setStep("step")
+            .setPhaseDefinition("{}")
+            .build();
+        meta = mkMeta().putCustom(ILM_CUSTOM_METADATA_KEY, state.asMap()).build();
+        assertTrue(TransportPutLifecycleAction.eligibleToCheckForRefresh(meta));
+    }
+
+    public void testReadStepKeys() {
+        assertNull(TransportPutLifecycleAction.readStepKeys(REGISTRY, client, "{}", "phase"));
+        assertNull(TransportPutLifecycleAction.readStepKeys(REGISTRY, client, "aoeu", "phase"));
+        assertNull(TransportPutLifecycleAction.readStepKeys(REGISTRY, client, "", "phase"));
+
+        assertThat(TransportPutLifecycleAction.readStepKeys(REGISTRY, client, "{\n" +
+            "        \"policy\": \"my_lifecycle3\",\n" +
+            "        \"phase_definition\": { \n" +
+            "          \"min_age\": \"0ms\",\n" +
+            "          \"actions\": {\n" +
+            "            \"rollover\": {\n" +
+            "              \"max_age\": \"30s\"\n" +
+            "            }\n" +
+            "          }\n" +
+            "        },\n" +
+            "        \"version\": 3, \n" +
+            "        \"modified_date_in_millis\": 1539609701576 \n" +
+            "      }", "phase"),
+            contains(new Step.StepKey("phase", "rollover", WaitForRolloverReadyStep.NAME),
+                new Step.StepKey("phase", "rollover", RolloverStep.NAME),
+                new Step.StepKey("phase", "rollover", UpdateRolloverLifecycleDateStep.NAME),
+                new Step.StepKey("phase", "rollover", RolloverAction.INDEXING_COMPLETE_STEP_NAME)));
+
+        assertThat(TransportPutLifecycleAction.readStepKeys(REGISTRY, client, "{\n" +
+                "        \"policy\" : \"my_lifecycle3\",\n" +
+                "        \"phase_definition\" : {\n" +
+                "          \"min_age\" : \"20m\",\n" +
+                "          \"actions\" : {\n" +
+                "            \"rollover\" : {\n" +
+                "              \"max_age\" : \"5s\"\n" +
+                "            },\n" +
+                "            \"set_priority\" : {\n" +
+                "              \"priority\" : 150\n" +
+                "            }\n" +
+                "          }\n" +
+                "        },\n" +
+                "        \"version\" : 1,\n" +
+                "        \"modified_date_in_millis\" : 1578521007076\n" +
+                "      }", "phase"),
+            contains(new Step.StepKey("phase", "rollover", WaitForRolloverReadyStep.NAME),
+                new Step.StepKey("phase", "rollover", RolloverStep.NAME),
+                new Step.StepKey("phase", "rollover", UpdateRolloverLifecycleDateStep.NAME),
+                new Step.StepKey("phase", "rollover", RolloverAction.INDEXING_COMPLETE_STEP_NAME),
+                new Step.StepKey("phase", "set_priority", SetPriorityAction.NAME)));
+
+        Map<String, LifecycleAction> actions = new HashMap<>();
+        actions.put("forcemerge", new ForceMergeAction(5));
+        actions.put("freeze", new FreezeAction());
+        actions.put("allocate", new AllocateAction(1, null, null, null));
+        PhaseExecutionInfo pei = new PhaseExecutionInfo("policy", new Phase("wonky", TimeValue.ZERO, actions), 1, 1);
+        String phaseDef = Strings.toString(pei);
+        logger.info("--> phaseDef: {}", phaseDef);
+
+        assertThat(TransportPutLifecycleAction.readStepKeys(REGISTRY, client, phaseDef, "phase"),
+            contains(new Step.StepKey("phase", "freeze", FreezeAction.NAME),
+                new Step.StepKey("phase", "allocate", AllocateAction.NAME),
+                new Step.StepKey("phase", "allocate", AllocationRoutedStep.NAME),
+                new Step.StepKey("phase", "forcemerge", ReadOnlyAction.NAME),
+                new Step.StepKey("phase", "forcemerge", ForceMergeAction.NAME),
+                new Step.StepKey("phase", "forcemerge", SegmentCountStep.NAME)));
+    }
+
+    public void testIndexCanBeSafelyUpdated() {
+
+        // Success case, it can be updated even though the configuration for the
+        // rollover and set_priority actions has changed
+        {
+            LifecycleExecutionState exState = LifecycleExecutionState.builder()
+                .setPhase("hot")
+                .setAction("rollover")
+                .setStep("check-rollover-ready")
+                .setPhaseDefinition("{\n" +
+                    "        \"policy\" : \"my-policy\",\n" +
+                    "        \"phase_definition\" : {\n" +
+                    "          \"min_age\" : \"20m\",\n" +
+                    "          \"actions\" : {\n" +
+                    "            \"rollover\" : {\n" +
+                    "              \"max_age\" : \"5s\"\n" +
+                    "            },\n" +
+                    "            \"set_priority\" : {\n" +
+                    "              \"priority\" : 150\n" +
+                    "            }\n" +
+                    "          }\n" +
+                    "        },\n" +
+                    "        \"version\" : 1,\n" +
+                    "        \"modified_date_in_millis\" : 1578521007076\n" +
+                    "      }")
+                .build();
+
+            IndexMetaData meta = mkMeta()
+                .putCustom(ILM_CUSTOM_METADATA_KEY, exState.asMap())
+                .build();
+
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            actions.put("rollover", new RolloverAction(null, null, 1L));
+            actions.put("set_priority", new SetPriorityAction(100));
+            Phase hotPhase = new Phase("hot", TimeValue.ZERO, actions);
+            Map<String, Phase> phases = Collections.singletonMap("hot", hotPhase);
+            LifecyclePolicy newPolicy = new LifecyclePolicy("my-policy", phases);
+
+            assertTrue(TransportPutLifecycleAction.isIndexPhaseDefinitionUpdatable(REGISTRY, client, meta, newPolicy));
+        }
+
+        // Failure case, can't update because the step we're currently on has been removed in the new policy
+        {
+            LifecycleExecutionState exState = LifecycleExecutionState.builder()
+                .setPhase("hot")
+                .setAction("rollover")
+                .setStep("check-rollover-ready")
+                .setPhaseDefinition("{\n" +
+                    "        \"policy\" : \"my-policy\",\n" +
+                    "        \"phase_definition\" : {\n" +
+                    "          \"min_age\" : \"20m\",\n" +
+                    "          \"actions\" : {\n" +
+                    "            \"rollover\" : {\n" +
+                    "              \"max_age\" : \"5s\"\n" +
+                    "            },\n" +
+                    "            \"set_priority\" : {\n" +
+                    "              \"priority\" : 150\n" +
+                    "            }\n" +
+                    "          }\n" +
+                    "        },\n" +
+                    "        \"version\" : 1,\n" +
+                    "        \"modified_date_in_millis\" : 1578521007076\n" +
+                    "      }")
+                .build();
+
+            IndexMetaData meta = mkMeta()
+                .putCustom(ILM_CUSTOM_METADATA_KEY, exState.asMap())
+                .build();
+
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            actions.put("set_priority", new SetPriorityAction(150));
+            Phase hotPhase = new Phase("hot", TimeValue.ZERO, actions);
+            Map<String, Phase> phases = Collections.singletonMap("hot", hotPhase);
+            LifecyclePolicy newPolicy = new LifecyclePolicy("my-policy", phases);
+
+            assertFalse(TransportPutLifecycleAction.isIndexPhaseDefinitionUpdatable(REGISTRY, client, meta, newPolicy));
+        }
+
+        // Failure case, can't update because the future step has been deleted
+        {
+            LifecycleExecutionState exState = LifecycleExecutionState.builder()
+                .setPhase("hot")
+                .setAction("rollover")
+                .setStep("check-rollover-ready")
+                .setPhaseDefinition("{\n" +
+                    "        \"policy\" : \"my-policy\",\n" +
+                    "        \"phase_definition\" : {\n" +
+                    "          \"min_age\" : \"20m\",\n" +
+                    "          \"actions\" : {\n" +
+                    "            \"rollover\" : {\n" +
+                    "              \"max_age\" : \"5s\"\n" +
+                    "            },\n" +
+                    "            \"set_priority\" : {\n" +
+                    "              \"priority\" : 150\n" +
+                    "            }\n" +
+                    "          }\n" +
+                    "        },\n" +
+                    "        \"version\" : 1,\n" +
+                    "        \"modified_date_in_millis\" : 1578521007076\n" +
+                    "      }")
+                .build();
+
+            IndexMetaData meta = mkMeta()
+                .putCustom(ILM_CUSTOM_METADATA_KEY, exState.asMap())
+                .build();
+
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            actions.put("rollover", new RolloverAction(null, TimeValue.timeValueSeconds(5), null));
+            Phase hotPhase = new Phase("hot", TimeValue.ZERO, actions);
+            Map<String, Phase> phases = Collections.singletonMap("hot", hotPhase);
+            LifecyclePolicy newPolicy = new LifecyclePolicy("my-policy", phases);
+
+            assertFalse(TransportPutLifecycleAction.isIndexPhaseDefinitionUpdatable(REGISTRY, client, meta, newPolicy));
+        }
+
+        // Failure case, index doesn't have enough info to check
+        {
+            LifecycleExecutionState exState = LifecycleExecutionState.builder()
+                .setPhaseDefinition("{\n" +
+                    "        \"policy\" : \"my-policy\",\n" +
+                    "        \"phase_definition\" : {\n" +
+                    "          \"min_age\" : \"20m\",\n" +
+                    "          \"actions\" : {\n" +
+                    "            \"rollover\" : {\n" +
+                    "              \"max_age\" : \"5s\"\n" +
+                    "            },\n" +
+                    "            \"set_priority\" : {\n" +
+                    "              \"priority\" : 150\n" +
+                    "            }\n" +
+                    "          }\n" +
+                    "        },\n" +
+                    "        \"version\" : 1,\n" +
+                    "        \"modified_date_in_millis\" : 1578521007076\n" +
+                    "      }")
+                .build();
+
+            IndexMetaData meta = mkMeta()
+                .putCustom(ILM_CUSTOM_METADATA_KEY, exState.asMap())
+                .build();
+
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            actions.put("rollover", new RolloverAction(null, null, 1L));
+            actions.put("set_priority", new SetPriorityAction(100));
+            Phase hotPhase = new Phase("hot", TimeValue.ZERO, actions);
+            Map<String, Phase> phases = Collections.singletonMap("hot", hotPhase);
+            LifecyclePolicy newPolicy = new LifecyclePolicy("my-policy", phases);
+
+            assertFalse(TransportPutLifecycleAction.isIndexPhaseDefinitionUpdatable(REGISTRY, client, meta, newPolicy));
+        }
+
+        // Failure case, the phase JSON is unparseable
+        {
+            LifecycleExecutionState exState = LifecycleExecutionState.builder()
+                .setPhase("hot")
+                .setAction("rollover")
+                .setStep("check-rollover-ready")
+                .setPhaseDefinition("potato")
+                .build();
+
+            IndexMetaData meta = mkMeta()
+                .putCustom(ILM_CUSTOM_METADATA_KEY, exState.asMap())
+                .build();
+
+            Map<String, LifecycleAction> actions = new HashMap<>();
+            actions.put("rollover", new RolloverAction(null, null, 1L));
+            actions.put("set_priority", new SetPriorityAction(100));
+            Phase hotPhase = new Phase("hot", TimeValue.ZERO, actions);
+            Map<String, Phase> phases = Collections.singletonMap("hot", hotPhase);
+            LifecyclePolicy newPolicy = new LifecyclePolicy("my-policy", phases);
+
+            assertFalse(TransportPutLifecycleAction.isIndexPhaseDefinitionUpdatable(REGISTRY, client, meta, newPolicy));
+        }
+    }
+
+    public void testRefreshPhaseJson() {
+        LifecycleExecutionState exState = LifecycleExecutionState.builder()
+            .setPhase("hot")
+            .setAction("rollover")
+            .setStep("check-rollover-ready")
+            .setPhaseDefinition("{\n" +
+                "        \"policy\" : \"my-policy\",\n" +
+                "        \"phase_definition\" : {\n" +
+                "          \"min_age\" : \"20m\",\n" +
+                "          \"actions\" : {\n" +
+                "            \"rollover\" : {\n" +
+                "              \"max_age\" : \"5s\"\n" +
+                "            },\n" +
+                "            \"set_priority\" : {\n" +
+                "              \"priority\" : 150\n" +
+                "            }\n" +
+                "          }\n" +
+                "        },\n" +
+                "        \"version\" : 1,\n" +
+                "        \"modified_date_in_millis\" : 1578521007076\n" +
+                "      }")
+            .build();
+
+        IndexMetaData meta = mkMeta()
+            .putCustom(ILM_CUSTOM_METADATA_KEY, exState.asMap())
+            .build();
+
+        Map<String, LifecycleAction> actions = new HashMap<>();
+        actions.put("rollover", new RolloverAction(null, null, 1L));
+        actions.put("set_priority", new SetPriorityAction(100));
+        Phase hotPhase = new Phase("hot", TimeValue.ZERO, actions);
+        Map<String, Phase> phases = Collections.singletonMap("hot", hotPhase);
+        LifecyclePolicy newPolicy = new LifecyclePolicy("my-policy", phases);
+        LifecyclePolicyMetadata policyMetadata = new LifecyclePolicyMetadata(newPolicy, Collections.emptyMap(), 2L, 2L);
+
+        ClusterState existingState = ClusterState.builder(ClusterState.EMPTY_STATE)
+            .metaData(MetaData.builder(MetaData.EMPTY_META_DATA)
+                .put(meta, false)
+                .build())
+            .build();
+
+        ClusterState changedState = TransportPutLifecycleAction.refreshPhaseDefinition(existingState, index, policyMetadata);
+
+        IndexMetaData newIdxMeta = changedState.metaData().index(index);
+        LifecycleExecutionState afterExState = LifecycleExecutionState.fromIndexMetadata(newIdxMeta);
+        Map<String, String> beforeState = new HashMap<>(exState.asMap());
+        beforeState.remove("phase_definition");
+        Map<String, String> afterState = new HashMap<>(afterExState.asMap());
+        afterState.remove("phase_definition");
+        // Check that no other execution state changes have been made
+        assertThat(beforeState, equalTo(afterState));
+
+        // Check that the phase definition has been refreshed
+        assertThat(afterExState.getPhaseDefinition(),
+            equalTo("{\"policy\":\"my-policy\",\"phase_definition\":{\"min_age\":\"0ms\",\"actions\":{\"rollover\":{\"max_docs\":1}," +
+                "\"set_priority\":{\"priority\":100}}},\"version\":2,\"modified_date_in_millis\":2}"));
+    }
+
+    public void testUpdateIndicesForPolicy() {
+        LifecycleExecutionState exState = LifecycleExecutionState.builder()
+            .setPhase("hot")
+            .setAction("rollover")
+            .setStep("check-rollover-ready")
+            .setPhaseDefinition("{\"policy\":\"my-policy\",\"phase_definition\":{\"min_age\":\"0ms\",\"actions\":{\"rollover\":" +
+                "{\"max_docs\":1},\"set_priority\":{\"priority\":100}}},\"version\":1,\"modified_date_in_millis\":1578521007076}")
+            .build();
+
+        IndexMetaData meta = mkMeta()
+            .putCustom(ILM_CUSTOM_METADATA_KEY, exState.asMap())
+            .build();
+
+        assertTrue(TransportPutLifecycleAction.eligibleToCheckForRefresh(meta));
+
+        Map<String, LifecycleAction> oldActions = new HashMap<>();
+        oldActions.put("rollover", new RolloverAction(null, null, 1L));
+        oldActions.put("set_priority", new SetPriorityAction(100));
+        Phase oldHotPhase = new Phase("hot", TimeValue.ZERO, oldActions);
+        Map<String, Phase> oldPhases = Collections.singletonMap("hot", oldHotPhase);
+        LifecyclePolicy oldPolicy = new LifecyclePolicy("my-policy", oldPhases);
+
+        Map<String, LifecycleAction> actions = new HashMap<>();
+        actions.put("rollover", new RolloverAction(null, null, 1L));
+        actions.put("set_priority", new SetPriorityAction(100));
+        Phase hotPhase = new Phase("hot", TimeValue.ZERO, actions);
+        Map<String, Phase> phases = Collections.singletonMap("hot", hotPhase);
+        LifecyclePolicy newPolicy = new LifecyclePolicy("my-policy", phases);
+        LifecyclePolicyMetadata policyMetadata = new LifecyclePolicyMetadata(newPolicy, Collections.emptyMap(), 2L, 2L);
+
+        assertTrue(TransportPutLifecycleAction.isIndexPhaseDefinitionUpdatable(REGISTRY, client, meta, newPolicy));
+
+        ClusterState existingState = ClusterState.builder(ClusterState.EMPTY_STATE)
+            .metaData(MetaData.builder(MetaData.EMPTY_META_DATA)
+                .put(meta, false)
+                .build())
+            .build();
+
+        logger.info("--> update for unchanged policy");
+        ClusterState updatedState = TransportPutLifecycleAction.updateIndicesForPolicy(existingState, REGISTRY,
+            client, oldPolicy, policyMetadata);
+
+        // No change, because the policies were identical
+        assertThat(updatedState, equalTo(existingState));
+
+        actions = new HashMap<>();
+        actions.put("rollover", new RolloverAction(null, null, 2L));
+        actions.put("set_priority", new SetPriorityAction(150));
+        hotPhase = new Phase("hot", TimeValue.ZERO, actions);
+        phases = Collections.singletonMap("hot", hotPhase);
+        newPolicy = new LifecyclePolicy("my-policy", phases);
+        policyMetadata = new LifecyclePolicyMetadata(newPolicy, Collections.emptyMap(), 2L, 2L);
+
+        logger.info("--> update with changed policy, but not configured in settings");
+        updatedState = TransportPutLifecycleAction.updateIndicesForPolicy(existingState, REGISTRY, client, oldPolicy, policyMetadata);
+
+        // No change, because the index doesn't have a lifecycle.name setting for this policy
+        assertThat(updatedState, equalTo(existingState));
+
+        meta = IndexMetaData.builder(index)
+            .settings(Settings.builder()
+                .put(LifecycleSettings.LIFECYCLE_NAME, "my-policy")
+                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, randomIntBetween(1, 10))
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, randomIntBetween(0, 5))
+                .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
+                .put(IndexMetaData.SETTING_INDEX_UUID, randomAlphaOfLength(5)))
+            .putCustom(ILM_CUSTOM_METADATA_KEY, exState.asMap())
+            .build();
+        existingState = ClusterState.builder(ClusterState.EMPTY_STATE)
+            .metaData(MetaData.builder(MetaData.EMPTY_META_DATA)
+                .put(meta, false)
+                .build())
+            .build();
+
+        logger.info("--> update with changed policy and this index has the policy");
+        updatedState = TransportPutLifecycleAction.updateIndicesForPolicy(existingState, REGISTRY, client, oldPolicy, policyMetadata);
+
+        IndexMetaData newIdxMeta = updatedState.metaData().index(index);
+        LifecycleExecutionState afterExState = LifecycleExecutionState.fromIndexMetadata(newIdxMeta);
+        Map<String, String> beforeState = new HashMap<>(exState.asMap());
+        beforeState.remove("phase_definition");
+        Map<String, String> afterState = new HashMap<>(afterExState.asMap());
+        afterState.remove("phase_definition");
+        // Check that no other execution state changes have been made
+        assertThat(beforeState, equalTo(afterState));
+
+        // Check that the phase definition has been refreshed
+        assertThat(afterExState.getPhaseDefinition(),
+            equalTo("{\"policy\":\"my-policy\",\"phase_definition\":{\"min_age\":\"0ms\",\"actions\":{\"rollover\":{\"max_docs\":2}," +
+                "\"set_priority\":{\"priority\":150}}},\"version\":2,\"modified_date_in_millis\":2}"));
+    }
+
+    private static IndexMetaData.Builder mkMeta() {
+        return IndexMetaData.builder(index)
+            .settings(Settings.builder()
+                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, randomIntBetween(1, 10))
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, randomIntBetween(0, 5))
+                .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
+                .put(IndexMetaData.SETTING_INDEX_UUID, randomAlphaOfLength(5)));
+    }
+}

From 8910197d5b009346e88aa24d796e63eba8f70bfa Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Mon, 13 Jan 2020 13:02:06 -0800
Subject: [PATCH 532/686] [DOCS] Adds elasticsearch-keystore command reference
 (#50872)

---
 docs/reference/commands/index.asciidoc        |   2 +
 docs/reference/commands/keystore.asciidoc     | 149 ++++++++++++++++++
 docs/reference/setup/secure-settings.asciidoc | 133 +++-------------
 3 files changed, 174 insertions(+), 110 deletions(-)
 create mode 100644 docs/reference/commands/keystore.asciidoc

diff --git a/docs/reference/commands/index.asciidoc b/docs/reference/commands/index.asciidoc
index 81e9000c9bb13..7b49a9de873ef 100644
--- a/docs/reference/commands/index.asciidoc
+++ b/docs/reference/commands/index.asciidoc
@@ -10,6 +10,7 @@ tasks from the command line:
 * <<certgen>>
 * <<certutil>>
 * <<elasticsearch-croneval>>
+* <<elasticsearch-keystore>>
 * <<node-tool>>
 * <<saml-metadata>>
 * <<setup-passwords>>
@@ -22,6 +23,7 @@ tasks from the command line:
 include::certgen.asciidoc[]
 include::certutil.asciidoc[]
 include::croneval.asciidoc[]
+include::keystore.asciidoc[]
 include::node-tool.asciidoc[]
 include::saml-metadata.asciidoc[]
 include::setup-passwords.asciidoc[]
diff --git a/docs/reference/commands/keystore.asciidoc b/docs/reference/commands/keystore.asciidoc
new file mode 100644
index 0000000000000..f9ce718d3b35f
--- /dev/null
+++ b/docs/reference/commands/keystore.asciidoc
@@ -0,0 +1,149 @@
+[[elasticsearch-keystore]]
+== elasticsearch-keystore
+
+The `elasticsearch-keystore` command manages <<secure-settings,secure settings>>
+in the {es} keystore.
+
+[discrete]
+[[elasticsearch-keystore-synopsis]]
+=== Synopsis
+
+[source,shell]
+--------------------------------------------------
+bin/elasticsearch-keystore
+([add <setting>] [--stdin] |
+[add-file <setting> <path>] | [create] |
+[list] | [remove <setting>] | [upgrade])
+[-h, --help] ([-s, --silent] | [-v, --verbose])
+--------------------------------------------------
+
+[discrete]
+[[elasticsearch-keystore-description]]
+=== Description
+
+IMPORTANT: This command should be run as the user that will run {es}.
+
+Currently, all secure settings are node-specific settings that must have the
+same value on every node. Therefore you must run this command on every node.
+
+Modifications to the keystore do not take effect until you restart {es}.
+
+Only some settings are designed to be read from the keystore. However, there
+is no validation to block unsupported settings from the keystore and they can
+cause {es} to fail to start. To see whether a setting is supported in the
+keystore, see the setting reference.
+
+[discrete]
+[[elasticsearch-keystore-parameters]]
+=== Parameters
+
+`add <setting>`:: Adds settings to the keystore. By default, you are prompted
+for the value of the setting.
+
+`add-file <setting> <path>`:: Adds a file to the keystore.
+
+`create`:: Creates the keystore.
+
+`-h, --help`:: Returns all of the command parameters.
+
+`list`:: Lists the settings in the keystore.
+
+`remove <setting>:: Removes a setting from the keystore.
+
+`-s, --silent`:: Shows minimal output.
+
+`--stdin`:: When used with the `add` parameter, you can pass the setting value
+through standard input (stdin). See <<add-string-to-keystore>>.
+
+`upgrade`:: Upgrades the internal format of the keystore.
+
+`-v, --verbose`:: Shows verbose output.
+
+[discrete]
+[[elasticsearch-keystore-examples]]
+=== Examples
+
+[discrete]
+[[creating-keystore]]
+==== Create the keystore
+
+To create the `elasticsearch.keystore`, use the `create` command:
+
+[source,sh]
+----------------------------------------------------------------
+bin/elasticsearch-keystore create
+----------------------------------------------------------------
+
+A `elasticsearch.keystore` file is created alongside the `elasticsearch.yml`
+file.
+
+[discrete]
+[[list-settings]]
+==== List settings in the keystore
+
+To list the settings in the keystore, use the `list` command.
+
+[source,sh]
+----------------------------------------------------------------
+bin/elasticsearch-keystore list
+----------------------------------------------------------------
+
+[discrete]
+[[add-string-to-keystore]]
+==== Add settings to the keystore
+
+Sensitive string settings, like authentication credentials for Cloud plugins,
+can be added with the `add` command:
+
+[source,sh]
+----------------------------------------------------------------
+bin/elasticsearch-keystore add the.setting.name.to.set
+----------------------------------------------------------------
+
+You are prompted to enter the value of the setting. To pass the value
+through standard input (stdin), use the `--stdin` flag:
+
+[source,sh]
+----------------------------------------------------------------
+cat /file/containing/setting/value | bin/elasticsearch-keystore add --stdin the.setting.name.to.set
+----------------------------------------------------------------
+
+[discrete]
+[[add-file-to-keystore]]
+==== Add files to the keystore
+
+You can add sensitive files, like authentication key files for Cloud plugins,
+using the `add-file` command. Be sure to include your file path as an argument
+after the setting name.
+
+[source,sh]
+----------------------------------------------------------------
+bin/elasticsearch-keystore add-file the.setting.name.to.set /path/example-file.json
+----------------------------------------------------------------
+
+[discrete]
+[[remove-settings]]
+==== Remove settings from the keystore
+
+To remove a setting from the keystore, use the `remove` command:
+
+[source,sh]
+----------------------------------------------------------------
+bin/elasticsearch-keystore remove the.setting.name.to.remove
+----------------------------------------------------------------
+
+[discrete]
+[[keystore-upgrade]]
+==== Upgrade the keystore
+
+Occasionally, the internal format of the keystore changes. When {es} is
+installed from a package manager, an upgrade of the on-disk keystore to the new
+format is done during package upgrade. In other cases, {es} performs the upgrade
+during node startup. This requires that {es} has write permissions to the
+directory that contains the keystore. Alternatively, you can manually perform
+such an upgrade by using the `upgrade` command:
+
+[source,sh]
+----------------------------------------------------------------
+bin/elasticsearch-keystore upgrade
+----------------------------------------------------------------
diff --git a/docs/reference/setup/secure-settings.asciidoc b/docs/reference/setup/secure-settings.asciidoc
index d355d64d40d50..e565877f22f5e 100644
--- a/docs/reference/setup/secure-settings.asciidoc
+++ b/docs/reference/setup/secure-settings.asciidoc
@@ -2,120 +2,33 @@
 === Secure settings
 
 Some settings are sensitive, and relying on filesystem permissions to protect
-their values is not sufficient. For this use case, Elasticsearch provides a
-keystore and the `elasticsearch-keystore` tool to manage the settings in the keystore.
-
-NOTE: All commands here should be run as the user which will run Elasticsearch.
+their values is not sufficient. For this use case, {es} provides a
+keystore and the <<elasticsearch-keystore,`elasticsearch-keystore` tool>> to
+manage the settings in the keystore.
 
 IMPORTANT: Only some settings are designed to be read from the keystore. However,
-the keystore has no validation to block unsupported settings.
-Adding unsupported settings to the keystore will cause {es}
-to fail to start. See documentation for each setting to see if it is supported
-as part of the keystore.
+the keystore has no validation to block unsupported settings. Adding unsupported
+settings to the keystore causes {es} to fail to start. To see whether a setting
+is supported in the keystore, look for a "Secure" qualifier the setting
+reference.
 
-NOTE: All the modifications to the keystore take affect only after restarting
-Elasticsearch.
+All the modifications to the keystore take affect only after restarting {es}.
 
-NOTE: The elasticsearch keystore currently only provides obfuscation. In the future,
+NOTE: The {es} keystore currently only provides obfuscation. In the future,
 password protection will be added.
 
 These settings, just like the regular ones in the `elasticsearch.yml` config file,
 need to be specified on each node in the cluster. Currently, all secure settings
 are node-specific settings that must have the same value on every node.
 
-[float]
-[[creating-keystore]]
-=== Creating the keystore
-
-To create the `elasticsearch.keystore`, use the `create` command:
-
-[source,sh]
-----------------------------------------------------------------
-bin/elasticsearch-keystore create
-----------------------------------------------------------------
-
-The file `elasticsearch.keystore` will be created alongside `elasticsearch.yml`.
-
-[float]
-[[list-settings]]
-=== Listing settings in the keystore
-
-A list of the settings in the keystore is available with the `list` command:
-
-[source,sh]
-----------------------------------------------------------------
-bin/elasticsearch-keystore list
-----------------------------------------------------------------
-
-[float]
-[[add-string-to-keystore]]
-=== Adding string settings
-
-Sensitive string settings, like authentication credentials for cloud
-plugins, can be added using the `add` command:
-
-[source,sh]
-----------------------------------------------------------------
-bin/elasticsearch-keystore add the.setting.name.to.set
-----------------------------------------------------------------
-
-The tool will prompt for the value of the setting. To pass the value
-through stdin, use the `--stdin` flag:
-
-[source,sh]
-----------------------------------------------------------------
-cat /file/containing/setting/value | bin/elasticsearch-keystore add --stdin the.setting.name.to.set
-----------------------------------------------------------------
-
-[float]
-[[add-file-to-keystore]]
-=== Adding file settings
-You can add sensitive files, like authentication key files for cloud plugins,
-using the `add-file` command. Be sure to include your file path as an argument
-after the setting name.
-
-[source,sh]
-----------------------------------------------------------------
-bin/elasticsearch-keystore add-file the.setting.name.to.set /path/example-file.json
-----------------------------------------------------------------
-
-[float]
-[[remove-settings]]
-=== Removing settings
-
-To remove a setting from the keystore, use the `remove` command:
-
-[source,sh]
-----------------------------------------------------------------
-bin/elasticsearch-keystore remove the.setting.name.to.remove
-----------------------------------------------------------------
-
-[float]
-[[keystore-upgrade]]
-=== Upgrading the keystore
-
-Occasionally, the internal format of the keystore changes. When Elasticsearch is
-installed from a package manager, an upgrade of the on-disk keystore to the new
-format is done during package upgrade. In other cases, Elasticsearch will
-perform such an upgrade during node startup. This requires that Elasticsearch
-have write permissions to the directory that contains the keystore.
-Alternatively, you can manually perform such an upgrade by using the `upgrade`
-command:
-
-[source,sh]
-----------------------------------------------------------------
-bin/elasticsearch-keystore upgrade
-----------------------------------------------------------------
-
-[float]
+[discrete]
 [[reloadable-secure-settings]]
 === Reloadable secure settings
 
-Just like the settings values in `elasticsearch.yml`, changes to the
-keystore contents are not automatically applied to the running
-elasticsearch node. Re-reading settings requires a node restart.
-However, certain secure settings are marked as *reloadable*. Such settings
-can be re-read and applied on a running node.
+Just like the settings values in `elasticsearch.yml`, changes to the keystore
+contents are not automatically applied to the running {es} node. Re-reading
+settings requires a node restart. However, certain secure settings are marked as
+*reloadable*. Such settings can be re-read and applied on a running node.
 
 The values of all secure settings, *reloadable* or not, must be identical
 across all cluster nodes. After making the desired secure settings changes,
@@ -126,16 +39,16 @@ using the `bin/elasticsearch-keystore add` command, call:
 POST _nodes/reload_secure_settings
 ----
 
-This API will decrypt and re-read the entire keystore, on every cluster node,
-but only the *reloadable* secure settings will be applied. Changes to other
-settings will not go into effect until the next restart. Once the call returns,
-the reload has been completed, meaning that all internal datastructures dependent
-on these settings have been changed. Everything should look as if the settings
-had the new value from the start.
+This API decrypts and re-reads the entire keystore, on every cluster node,
+but only the *reloadable* secure settings are applied. Changes to other
+settings do not go into effect until the next restart. Once the call returns,
+the reload has been completed, meaning that all internal data structures
+dependent on these settings have been changed. Everything should look as if the
+settings had the new value from the start.
 
-When changing multiple *reloadable* secure settings, modify all of them, on
-each cluster node, and then issue a `reload_secure_settings` call, instead
-of reloading after each modification.
+When changing multiple *reloadable* secure settings, modify all of them on each
+cluster node, then issue a `reload_secure_settings` call instead of reloading
+after each modification.
 
 There are reloadable secure settings for:
 

From f0bc90060695976c5a18501aec0f963e7c169a98 Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Mon, 13 Jan 2020 15:07:09 -0600
Subject: [PATCH 533/686] Allow proxy mode server name to be configured
 (#50774)

Currently, proxy mode allows a remote cluster connection to be setup by
expecting all open connections to be routed through an intermediate
proxy. The proxy must use some logic to ensure that the connections end
up on the correct remote cluster. One mechanism provided is that the
default distribution TLS implementations will forward the host component
of the configured address to the remote connection using the SNI
extension. This is limiting as it requires that the proxy be configured
in a way that always uses a valid hostname as the proxy address.

Instead, this commit adds an additional setting to allow the server_name
to be configured independently. This allows the proxy address to be
specified as a IP literal, but the server_name specified as an arbitrary
string which still must be a valid hostname. It also decouples the
server_name from the requirement of being a DNS resolvable domain.
---
 .../common/settings/ClusterSettings.java      |  2 +-
 .../transport/ProxyConnectionStrategy.java    | 38 +++++++------------
 .../transport/RemoteClusterAware.java         |  2 +-
 .../transport/RemoteConnectionStrategy.java   | 15 +++-----
 .../transport/SniffConnectionStrategy.java    | 10 +----
 .../ProxyConnectionStrategyTests.java         | 10 ++---
 6 files changed, 27 insertions(+), 50 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
index 8ab85abf6d74e..d3b110de4f9a9 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
@@ -296,7 +296,7 @@ public void apply(Settings value, Settings current, Settings previous) {
             RemoteConnectionStrategy.REMOTE_CONNECTION_MODE,
             ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES,
             ProxyConnectionStrategy.REMOTE_SOCKET_CONNECTIONS,
-            ProxyConnectionStrategy.INCLUDE_SERVER_NAME,
+            ProxyConnectionStrategy.SERVER_NAME,
             SniffConnectionStrategy.REMOTE_CLUSTERS_PROXY,
             SniffConnectionStrategy.REMOTE_CLUSTER_SEEDS,
             SniffConnectionStrategy.REMOTE_NODE_CONNECTIONS,
diff --git a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
index 00971252a3311..cd3983781d0f8 100644
--- a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
@@ -39,16 +39,13 @@
 
 import java.io.IOException;
 import java.util.Collections;
-import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 import java.util.concurrent.atomic.AtomicInteger;
-import java.util.concurrent.atomic.AtomicLong;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Supplier;
 import java.util.stream.Stream;
 
-import static org.elasticsearch.common.settings.Setting.boolSetting;
 import static org.elasticsearch.common.settings.Setting.intSetting;
 
 public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
@@ -75,12 +72,12 @@ public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
             Setting.Property.Dynamic, Setting.Property.NodeScope));
 
     /**
-     * Whether to include the hostname as a server_name attribute
+     * A configurable server_name attribute
      */
-    public static final Setting.AffixSetting<Boolean> INCLUDE_SERVER_NAME = Setting.affixKeySetting(
+    public static final Setting.AffixSetting<String> SERVER_NAME = Setting.affixKeySetting(
         "cluster.remote.",
-        "include_server_name",
-        (ns, key) -> boolSetting(key, false, new StrategyValidator<>(ns, key, ConnectionStrategy.PROXY),
+        "server_name",
+        (ns, key) -> Setting.simpleString(key, new StrategyValidator<>(ns, key, ConnectionStrategy.PROXY),
             Setting.Property.Dynamic, Setting.Property.NodeScope));
 
     static final int CHANNELS_PER_CONNECTION = 1;
@@ -89,9 +86,8 @@ public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
     private static final Logger logger = LogManager.getLogger(ProxyConnectionStrategy.class);
 
     private final int maxNumConnections;
-    private final AtomicLong counter = new AtomicLong(0);
     private final String configuredAddress;
-    private final boolean includeServerName;
+    private final String configuredServerName;
     private final Supplier<TransportAddress> address;
     private final AtomicReference<ClusterName> remoteClusterName = new AtomicReference<>();
     private final ConnectionManager.ConnectionValidator clusterNameValidator;
@@ -104,28 +100,28 @@ public class ProxyConnectionStrategy extends RemoteConnectionStrategy {
             connectionManager,
             REMOTE_SOCKET_CONNECTIONS.getConcreteSettingForNamespace(clusterAlias).get(settings),
             REMOTE_CLUSTER_ADDRESSES.getConcreteSettingForNamespace(clusterAlias).get(settings),
-            INCLUDE_SERVER_NAME.getConcreteSettingForNamespace(clusterAlias).get(settings));
+            SERVER_NAME.getConcreteSettingForNamespace(clusterAlias).get(settings));
     }
 
     ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
                             int maxNumConnections, String configuredAddress) {
         this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddress,
-            () -> resolveAddress(configuredAddress), false);
+            () -> resolveAddress(configuredAddress), null);
     }
 
     ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
-                            int maxNumConnections, String configuredAddress, boolean includeServerName) {
+                            int maxNumConnections, String configuredAddress, String configuredServerName) {
         this(clusterAlias, transportService, connectionManager, maxNumConnections, configuredAddress,
-            () -> resolveAddress(configuredAddress), includeServerName);
+            () -> resolveAddress(configuredAddress), configuredServerName);
     }
 
     ProxyConnectionStrategy(String clusterAlias, TransportService transportService, RemoteConnectionManager connectionManager,
                             int maxNumConnections, String configuredAddress, Supplier<TransportAddress> address,
-                            boolean includeServerName) {
+                            String configuredServerName) {
         super(clusterAlias, transportService, connectionManager);
         this.maxNumConnections = maxNumConnections;
         this.configuredAddress = configuredAddress;
-        this.includeServerName = includeServerName;
+        this.configuredServerName = configuredServerName;
         assert Strings.isEmpty(configuredAddress) == false : "Cannot use proxy connection strategy with no configured addresses";
         this.address = address;
         this.clusterNameValidator = (newConnection, actualProfile, listener) ->
@@ -217,10 +213,10 @@ public void onFailure(Exception e) {
             for (int i = 0; i < remaining; ++i) {
                 String id = clusterAlias + "#" + resolved;
                 Map<String, String> attributes;
-                if (includeServerName) {
-                    attributes = Collections.singletonMap("server_name", resolved.address().getHostString());
-                } else {
+                if (Strings.isNullOrEmpty(configuredServerName)) {
                     attributes = Collections.emptyMap();
+                } else {
+                    attributes = Collections.singletonMap("server_name", configuredServerName);
                 }
                 DiscoveryNode node = new DiscoveryNode(id, resolved, attributes, DiscoveryNodeRole.BUILT_IN_ROLES,
                     Version.CURRENT.minimumCompatibilityVersion());
@@ -252,12 +248,6 @@ public void onFailure(Exception e) {
         }
     }
 
-    private TransportAddress nextAddress(List<TransportAddress> resolvedAddresses) {
-        long curr;
-        while ((curr = counter.getAndIncrement()) == Long.MIN_VALUE) ;
-        return resolvedAddresses.get(Math.floorMod(curr, resolvedAddresses.size()));
-    }
-
     private static TransportAddress resolveAddress(String address) {
         return new TransportAddress(parseConfiguredAddress(address));
     }
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java b/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
index ba4f98d0d09a3..08c819c70a47c 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteClusterAware.java
@@ -111,7 +111,7 @@ public void listenForUpdates(ClusterSettings clusterSettings) {
             SniffConnectionStrategy.REMOTE_NODE_CONNECTIONS,
             ProxyConnectionStrategy.REMOTE_CLUSTER_ADDRESSES,
             ProxyConnectionStrategy.REMOTE_SOCKET_CONNECTIONS,
-            ProxyConnectionStrategy.INCLUDE_SERVER_NAME);
+            ProxyConnectionStrategy.SERVER_NAME);
         clusterSettings.addAffixGroupUpdateConsumer(remoteClusterSettings, this::validateAndUpdateRemoteCluster);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
index 1ee8fba2bd7eb..dff596f7c1112 100644
--- a/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/RemoteConnectionStrategy.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.action.support.ContextPreservingActionListener;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
@@ -170,11 +169,9 @@ private static <T> Stream<String> getClusterAlias(Settings settings, Setting.Aff
         return allConcreteSettings.map(affixSetting::getNamespace);
     }
 
-    static InetSocketAddress parseConfiguredAddress(String remoteHost) {
-        final Tuple<String, Integer> hostPort = parseHostPort(remoteHost);
-        final String host = hostPort.v1();
-        assert hostPort.v2() != null : remoteHost;
-        final int port = hostPort.v2();
+    static InetSocketAddress parseConfiguredAddress(String configuredAddress) {
+        final String host = parseHost(configuredAddress);
+        final int port = parsePort(configuredAddress);
         InetAddress hostAddress;
         try {
             hostAddress = InetAddress.getByName(host);
@@ -184,10 +181,8 @@ static InetSocketAddress parseConfiguredAddress(String remoteHost) {
         return new InetSocketAddress(hostAddress, port);
     }
 
-    private static Tuple<String, Integer> parseHostPort(final String remoteHost) {
-        final String host = remoteHost.substring(0, indexOfPortSeparator(remoteHost));
-        final int port = parsePort(remoteHost);
-        return Tuple.tuple(host, port);
+    static String parseHost(final String configuredAddress) {
+        return configuredAddress.substring(0, indexOfPortSeparator(configuredAddress));
     }
 
     static int parsePort(String remoteHost) {
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index fcc4bde951dd0..8ce03e9997527 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -412,7 +412,7 @@ private static DiscoveryNode resolveSeedNode(String clusterAlias, String address
                 Version.CURRENT.minimumCompatibilityVersion());
         } else {
             TransportAddress transportAddress = new TransportAddress(parseConfiguredAddress(proxyAddress));
-            String hostName = address.substring(0, indexOfPortSeparator(address));
+            String hostName = RemoteConnectionStrategy.parseHost(proxyAddress);
             return new DiscoveryNode("", clusterAlias + "#" + address, UUIDs.randomBase64UUID(), hostName, address,
                 transportAddress, Collections.singletonMap("server_name", hostName), DiscoveryNodeRole.BUILT_IN_ROLES,
                 Version.CURRENT.minimumCompatibilityVersion());
@@ -429,14 +429,6 @@ static Predicate<DiscoveryNode> getNodePredicate(Settings settings) {
         return DEFAULT_NODE_PREDICATE;
     }
 
-    private static int indexOfPortSeparator(String remoteHost) {
-        int portSeparator = remoteHost.lastIndexOf(':'); // in case we have a IPv6 address ie. [::1]:9300
-        if (portSeparator == -1 || portSeparator == remoteHost.length()) {
-            throw new IllegalArgumentException("remote hosts need to be configured as [host:port], found [" + remoteHost + "] instead");
-        }
-        return portSeparator;
-    }
-
     private static DiscoveryNode maybeAddProxyAddress(String proxyAddress, DiscoveryNode node) {
         if (proxyAddress == null || proxyAddress.isEmpty()) {
             return node;
diff --git a/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java b/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
index 0aa2c88142945..4654918d898f5 100644
--- a/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
+++ b/server/src/test/java/org/elasticsearch/transport/ProxyConnectionStrategyTests.java
@@ -126,7 +126,7 @@ public void testProxyStrategyWillOpenNewConnectionsOnDisconnect() throws Excepti
 
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, address1.toString(), alternatingResolver(address1, address2, useAddress1), false)) {
+                         numOfConnections, address1.toString(), alternatingResolver(address1, address2, useAddress1), null)) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
 
@@ -206,7 +206,7 @@ public void testClusterNameValidationPreventConnectingToDifferentClusters() thro
 
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, address1.toString(), alternatingResolver(address1, address2, useAddress1), false)) {
+                         numOfConnections, address1.toString(), alternatingResolver(address1, address2, useAddress1), null)) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address2)));
 
@@ -255,7 +255,7 @@ public void testProxyStrategyWillResolveAddressesEachConnect() throws Exception
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, address.toString(), addressSupplier, false)) {
+                         numOfConnections, address.toString(), addressSupplier, null)) {
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();
                     strategy.connect(connectFuture);
                     connectFuture.actionGet();
@@ -357,13 +357,13 @@ public void testServerNameAttributes() {
                 localService.start();
                 localService.acceptIncomingRequests();
 
-                String serverName = "localhost:" + address1.getPort();
+                String address = "localhost:" + address1.getPort();
 
                 ConnectionManager connectionManager = new ConnectionManager(profile, localService.transport);
                 int numOfConnections = randomIntBetween(4, 8);
                 try (RemoteConnectionManager remoteConnectionManager = new RemoteConnectionManager(clusterAlias, connectionManager);
                      ProxyConnectionStrategy strategy = new ProxyConnectionStrategy(clusterAlias, localService, remoteConnectionManager,
-                         numOfConnections, serverName, true)) {
+                         numOfConnections, address, "localhost")) {
                     assertFalse(connectionManager.getAllConnectedNodes().stream().anyMatch(n -> n.getAddress().equals(address1)));
 
                     PlainActionFuture<Void> connectFuture = PlainActionFuture.newFuture();

From 8bdd29ae22d0ecb4786c59c54616a7ba44a5a54e Mon Sep 17 00:00:00 2001
From: Peter Dyson <peter.dyson@geekpete.com>
Date: Tue, 14 Jan 2020 09:44:35 +1000
Subject: [PATCH 534/686] [DOCS] Array of index patterns is also valid source
 indices with transform (#50777)

---
 docs/reference/rest-api/common-parms.asciidoc | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/reference/rest-api/common-parms.asciidoc b/docs/reference/rest-api/common-parms.asciidoc
index 36b9791ebfdf0..0703260414716 100644
--- a/docs/reference/rest-api/common-parms.asciidoc
+++ b/docs/reference/rest-api/common-parms.asciidoc
@@ -764,8 +764,9 @@ end::source-transforms[]
 
 tag::source-index-transforms[]
 The _source indices_ for the {transform}. It can be a single index, an index
-pattern (for example, `"myindex*"`), or an array of indices (for example,
-`["index1", "index2"]`).
+pattern (for example, `"myindex*"`), an array of indices (for example,
+`["index1", "index2"]`), or an array of index patterns (for example,
+`["myindex1-*", "myindex2-*"]`.
 end::source-index-transforms[]
 
 tag::source-query-transforms[]

From 80b9d6ab5bc2ab39d54638bf9b16f772d9e7aafc Mon Sep 17 00:00:00 2001
From: Przemko Robakowski <przemko.robakowski@elastic.co>
Date: Tue, 14 Jan 2020 01:07:59 +0100
Subject: [PATCH 535/686] Increase timeouts in
 TimeSeriesLifecycleActionsIT#testWaitForSnapshot and
 testWaitForSnapshotSlmExecutedBefore test (#50818)

* Fix flaky TimeSeriesLifecycleActionsIT#testWaitForSnapshot test

This change adds some randomness and cleanup step to TimeSeriesLifecycleActionsIT#testWaitForSnapshot and testWaitForSnapshotSlmExecutedBefore tests in attempt to make them stable.

Reletes to #50781

* Formatting changes

* Longer timeout
---
 .../ilm/TimeSeriesLifecycleActionsIT.java     | 59 ++++++++++++-------
 1 file changed, 37 insertions(+), 22 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 9b0b759bdc667..e33a413f9f208 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -42,12 +42,12 @@
 import org.elasticsearch.xpack.core.ilm.SetPriorityAction;
 import org.elasticsearch.xpack.core.ilm.ShrinkAction;
 import org.elasticsearch.xpack.core.ilm.ShrinkStep;
-import org.elasticsearch.xpack.core.ilm.WaitForSnapshotAction;
 import org.elasticsearch.xpack.core.ilm.Step;
 import org.elasticsearch.xpack.core.ilm.Step.StepKey;
 import org.elasticsearch.xpack.core.ilm.TerminalPolicyStep;
 import org.elasticsearch.xpack.core.ilm.UpdateRolloverLifecycleDateStep;
 import org.elasticsearch.xpack.core.ilm.WaitForRolloverReadyStep;
+import org.elasticsearch.xpack.core.ilm.WaitForSnapshotAction;
 import org.hamcrest.Matchers;
 import org.junit.Before;
 
@@ -326,50 +326,62 @@ public void testAllocateActionOnlyReplicas() throws Exception {
         });
     }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50781")
     public void testWaitForSnapshot() throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
-        createNewSingletonPolicy("delete", new WaitForSnapshotAction("slm"));
+        String smlPolicy = randomAlphaOfLengthBetween(4, 10);
+        createNewSingletonPolicy("delete", new WaitForSnapshotAction(smlPolicy));
         updatePolicy(index, policy);
         assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("wait_for_snapshot")));
-        assertBusy(() -> assertThat(getStepKeyForIndex(index).getName(), equalTo("wait-for-snapshot")));
         assertBusy(() -> assertThat(getFailedStepForIndex(index), equalTo("wait-for-snapshot")));
 
-        createSnapshotRepo();
-        createSlmPolicy();
+        String repo = createSnapshotRepo();
+        createSlmPolicy(smlPolicy, repo);
 
         assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("wait_for_snapshot")));
 
-        Request request = new Request("PUT", "/_slm/policy/slm/_execute");
+        Request request = new Request("PUT", "/_slm/policy/" + smlPolicy + "/_execute");
         assertOK(client().performRequest(request));
 
-        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("completed")));
-    }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50781")
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("completed")), 2, TimeUnit.MINUTES);
+
+        request = new Request("DELETE", "/_slm/policy/" + smlPolicy);
+        assertOK(client().performRequest(request));
+
+        request = new Request("DELETE", "/_snapshot/" + repo);
+        assertOK(client().performRequest(request));
+    }
+    
     public void testWaitForSnapshotSlmExecutedBefore() throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
-        createNewSingletonPolicy("delete", new WaitForSnapshotAction("slm"));
+        String smlPolicy = randomAlphaOfLengthBetween(4, 10);
+        createNewSingletonPolicy("delete", new WaitForSnapshotAction(smlPolicy));
 
-        createSnapshotRepo();
-        createSlmPolicy();
+        String repo = createSnapshotRepo();
+        createSlmPolicy(smlPolicy, repo);
 
-        Request request = new Request("PUT", "/_slm/policy/slm/_execute");
+        Request request = new Request("PUT", "/_slm/policy/" + smlPolicy + "/_execute");
         assertOK(client().performRequest(request));
 
         updatePolicy(index, policy);
         assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("wait_for_snapshot")));
         assertBusy(() -> assertThat(getStepKeyForIndex(index).getName(), equalTo("wait-for-snapshot")));
 
-        request = new Request("PUT", "/_slm/policy/slm/_execute");
+        request = new Request("PUT", "/_slm/policy/" + smlPolicy + "/_execute");
         assertOK(client().performRequest(request));
 
-        request = new Request("PUT", "/_slm/policy/slm/_execute");
+        request = new Request("PUT", "/_slm/policy/" + smlPolicy + "/_execute");
         assertOK(client().performRequest(request));
 
-        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("completed")));
+        assertBusy(() -> assertThat(getStepKeyForIndex(index).getAction(), equalTo("completed")), 2, TimeUnit.MINUTES);
+
+        request = new Request("DELETE", "/_slm/policy/" + smlPolicy);
+        assertOK(client().performRequest(request));
+
+        request = new Request("DELETE", "/_snapshot/" + repo);
+        assertOK(client().performRequest(request));
     }
 
     public void testDelete() throws Exception {
@@ -1636,24 +1648,26 @@ private String getSnapshotState(String snapshot) throws IOException {
         return (String) snapResponse.get("state");
     }
 
-    private void createSlmPolicy() throws IOException {
+    private void createSlmPolicy(String smlPolicy, String repo) throws IOException {
         Request request;
-        request = new Request("PUT", "/_slm/policy/slm");
+        request = new Request("PUT", "/_slm/policy/" + smlPolicy);
         request.setJsonEntity(Strings
             .toString(JsonXContent.contentBuilder()
                 .startObject()
                 .field("schedule", "59 59 23 31 12 ? 2099")
-                .field("repository", "repo")
+                .field("repository", repo)
                 .field("name", "snap" + randomAlphaOfLengthBetween(5, 10).toLowerCase(Locale.ROOT))
                 .startObject("config")
+                    .field("include_global_state", false)
                 .endObject()
                 .endObject()));
 
         assertOK(client().performRequest(request));
     }
 
-    private void createSnapshotRepo() throws IOException {
-        Request request = new Request("PUT", "/_snapshot/repo");
+    private String createSnapshotRepo() throws IOException {
+        String repo = randomAlphaOfLengthBetween(4, 10);
+        Request request = new Request("PUT", "/_snapshot/" + repo);
         request.setJsonEntity(Strings
             .toString(JsonXContent.contentBuilder()
                 .startObject()
@@ -1665,5 +1679,6 @@ private void createSnapshotRepo() throws IOException {
                 .endObject()
                 .endObject()));
         assertOK(client().performRequest(request));
+        return repo;
     }
 }

From 276b0edcb6c1cab15f954b9d9eafa34ac8674ebc Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Mon, 13 Jan 2020 10:58:29 -0500
Subject: [PATCH 536/686] Deprecate synced flush (#50835)

A normal flush has the same effect as a synced flush on Elasticsearch
7.6 or later. It's deprecated in 7.6 and will be removed in 8.0.

Relates #50776
---
 .../elasticsearch/client/IndicesClient.java   |  6 +++
 .../elasticsearch/client/IndicesClientIT.java |  7 ++-
 .../client/RestHighLevelClientTests.java      |  3 +-
 .../IndicesClientDocumentationIT.java         |  8 +++-
 docs/reference/indices/synced-flush.asciidoc  |  4 ++
 docs/reference/upgrade/synced-flush.asciidoc  |  4 ++
 .../upgrades/FullClusterRestartIT.java        |  2 +-
 .../elasticsearch/upgrades/RecoveryIT.java    |  2 +-
 .../api/indices.flush_synced.json             |  2 +-
 .../test/cat.shards/10_basic.yml              | 48 -------------------
 .../test/indices.flush/10_basic.yml           | 40 +++++++++-------
 .../indices/flush/SyncedFlushService.java     |  7 +++
 .../test/rest/ESRestTestCase.java             | 16 +++++++
 13 files changed, 76 insertions(+), 73 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java
index 4cdc59dd3bd35..e00a9c0da8d50 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java
@@ -423,7 +423,10 @@ public Cancellable flushAsync(FlushRequest flushRequest, RequestOptions options,
      * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
      * @return the response
      * @throws IOException in case there is a problem sending the request or parsing back the response
+     * @deprecated synced flush is deprecated and will be removed in 8.0.
+     * Use {@link #flush(FlushRequest, RequestOptions)} instead.
      */
+    @Deprecated
     public SyncedFlushResponse flushSynced(SyncedFlushRequest syncedFlushRequest, RequestOptions options) throws IOException {
         return restHighLevelClient.performRequestAndParseEntity(syncedFlushRequest, IndicesRequestConverters::flushSynced, options,
                 SyncedFlushResponse::fromXContent, emptySet());
@@ -437,7 +440,10 @@ public SyncedFlushResponse flushSynced(SyncedFlushRequest syncedFlushRequest, Re
      * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
      * @param listener the listener to be notified upon request completion
      * @return cancellable that may be used to cancel the request
+     * @deprecated synced flush is deprecated and will be removed in 8.0.
+     * Use {@link #flushAsync(FlushRequest, RequestOptions, ActionListener)} instead.
      */
+    @Deprecated
     public Cancellable flushSyncedAsync(SyncedFlushRequest syncedFlushRequest, RequestOptions options,
                                         ActionListener<SyncedFlushResponse> listener) {
         return restHighLevelClient.performRequestAsyncAndParseEntity(syncedFlushRequest, IndicesRequestConverters::flushSynced, options,
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesClientIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesClientIT.java
index e712604266a31..842d348115845 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesClientIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesClientIT.java
@@ -97,6 +97,7 @@
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.indices.flush.SyncedFlushService;
 import org.elasticsearch.rest.RestStatus;
 
 import java.io.IOException;
@@ -768,7 +769,8 @@ public void testSyncedFlush() throws IOException {
             createIndex(index, settings);
             SyncedFlushRequest syncedFlushRequest = new SyncedFlushRequest(index);
             SyncedFlushResponse flushResponse =
-                    execute(syncedFlushRequest, highLevelClient().indices()::flushSynced, highLevelClient().indices()::flushSyncedAsync);
+                    execute(syncedFlushRequest, highLevelClient().indices()::flushSynced, highLevelClient().indices()::flushSyncedAsync,
+                        expectWarnings(SyncedFlushService.SYNCED_FLUSH_DEPRECATION_MESSAGE));
             assertThat(flushResponse.totalShards(), equalTo(1));
             assertThat(flushResponse.successfulShards(), equalTo(1));
             assertThat(flushResponse.failedShards(), equalTo(0));
@@ -783,7 +785,8 @@ public void testSyncedFlush() throws IOException {
                     execute(
                         syncedFlushRequest,
                         highLevelClient().indices()::flushSynced,
-                        highLevelClient().indices()::flushSyncedAsync
+                        highLevelClient().indices()::flushSyncedAsync,
+                        expectWarnings(SyncedFlushService.SYNCED_FLUSH_DEPRECATION_MESSAGE)
                     )
             );
             assertEquals(RestStatus.NOT_FOUND, exception.status());
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
index 4ec048ad1e4f5..c33c7212388ad 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/RestHighLevelClientTests.java
@@ -839,7 +839,8 @@ public void testApiNamingConventions() throws Exception {
         // looking like it doesn't have a valid implementatation when it does.
         apiUnsupported.remove("indices.get_template");
 
-
+        // Synced flush is deprecated
+        apiUnsupported.remove("indices.flush_synced");
 
         for (Map.Entry<String, Set<Method>> entry : methods.entrySet()) {
             String apiName = entry.getKey();
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/IndicesClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/IndicesClientDocumentationIT.java
index 480091e1e4a03..02d426e4b6c6d 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/IndicesClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/IndicesClientDocumentationIT.java
@@ -1018,7 +1018,9 @@ public void testSyncedFlushIndex() throws Exception {
             // end::flush-synced-request-indicesOptions
 
             // tag::flush-synced-execute
-            SyncedFlushResponse flushSyncedResponse = client.indices().flushSynced(request, RequestOptions.DEFAULT);
+            SyncedFlushResponse flushSyncedResponse = client.indices().flushSynced(request, expectWarnings(
+                "Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead."
+            ));
             // end::flush-synced-execute
 
             // tag::flush-synced-response
@@ -1062,7 +1064,9 @@ public void onFailure(Exception e) {
             listener = new LatchedActionListener<>(listener, latch);
 
             // tag::flush-synced-execute-async
-            client.indices().flushSyncedAsync(request, RequestOptions.DEFAULT, listener); // <1>
+            client.indices().flushSyncedAsync(request, expectWarnings(
+                "Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead."
+            ), listener); // <1>
             // end::flush-synced-execute-async
 
             assertTrue(latch.await(30L, TimeUnit.SECONDS));
diff --git a/docs/reference/indices/synced-flush.asciidoc b/docs/reference/indices/synced-flush.asciidoc
index cb2c40793091a..8e3a85aceca33 100644
--- a/docs/reference/indices/synced-flush.asciidoc
+++ b/docs/reference/indices/synced-flush.asciidoc
@@ -4,6 +4,10 @@
 <titleabbrev>Synced flush</titleabbrev>
 ++++
 
+deprecated::[7.6, synced-flush is deprecated and will be removed in 8.0.
+Use <<indices-flush,flush>> instead. A <<indices-flush,flush>> has the
+same effect as a synced flush on Elasticsearch 7.6 or later]
+
 Performs a synced flush on one or more indices.
 
 [source,console]
diff --git a/docs/reference/upgrade/synced-flush.asciidoc b/docs/reference/upgrade/synced-flush.asciidoc
index 59bdea15ba742..a67c171f99875 100644
--- a/docs/reference/upgrade/synced-flush.asciidoc
+++ b/docs/reference/upgrade/synced-flush.asciidoc
@@ -3,8 +3,12 @@
 --------------------------------------------------
 POST _flush/synced
 --------------------------------------------------
+// TEST[skip: will fail as synced flush is deprecated]
 
 When you perform a synced flush, check the response to make sure there are
 no failures. Synced flush operations that fail due to pending indexing
 operations are listed in the response body, although the request itself
 still returns a 200 OK status. If there are failures, reissue the request.
+
+Note that synced flush is deprecated and will be removed in 8.0. A flush
+has the same effect as a synced flush on Elasticsearch 7.6 or later.
diff --git a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
index 21ae48e9c77d4..9c7d7af4ca6c8 100644
--- a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
+++ b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
@@ -684,7 +684,7 @@ public void testRecovery() throws Exception {
                 // We had a bug before where we failed to perform peer recovery with sync_id from 5.x to 6.x.
                 // We added this synced flush so we can exercise different paths of recovery code.
                 try {
-                    client().performRequest(new Request("POST", index + "/_flush/synced"));
+                    performSyncedFlush(index);
                 } catch (ResponseException ignored) {
                     // synced flush is optional here
                 }
diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index 88dabadbd09fd..f29bfddde0420 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -562,7 +562,7 @@ private void syncedFlush(String index) throws Exception {
         // A synced-flush request considers the global checkpoint sync as an going operation because it acquires a shard permit.
         assertBusy(() -> {
             try {
-                Response resp = client().performRequest(new Request("POST", index + "/_flush/synced"));
+                Response resp = performSyncedFlush(index);
                 Map<String, Object> result = ObjectPath.createFromResponse(resp).evaluate("_shards");
                 assertThat(result.get("failed"), equalTo(0));
             } catch (ResponseException ex) {
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
index e7c98d66451bd..a7b4541c9623a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
@@ -2,7 +2,7 @@
   "indices.flush_synced":{
     "documentation":{
       "url":"https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-synced-flush-api.html",
-      "description":"Performs a synced flush operation on one or more indices."
+      "description":"Performs a synced flush operation on one or more indices. Synced flush is deprecated and will be removed in 8.0. Use flush instead"
     },
     "stability":"stable",
     "url":{
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/cat.shards/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/cat.shards/10_basic.yml
index 6632d912cd57e..de5e632975752 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/cat.shards/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/cat.shards/10_basic.yml
@@ -88,54 +88,6 @@
   - match:
       $body: |
                /^$/
-
-  - do:
-      indices.create:
-        index: sync_id_test
-        body:
-          settings:
-            number_of_shards: 5
-            number_of_replicas: 0
-
-  - do:
-      indices.flush_synced:
-        index: sync_id_test
-
-  - is_false: _shards.failed
-
-  - do:
-      cat.shards:
-        index: sync_id_test
-        h: index,state,sync_id
-# 20 chars for sync ids with 5.x which uses time-based uuids and 22 with 6.x which uses random uuids
-  - match:
-      $body: |
-               /^(sync_id_test\s+STARTED\s+[A-Za-z0-9_\-]{20,22}\n){5}$/
-
-  - do:
-      indices.delete:
-        index: sync_id_test
-
-  - do:
-      indices.create:
-        index: sync_id_no_flush_test
-        body:
-          settings:
-            number_of_shards: 5
-            number_of_replicas: 0
-
-  - do:
-      cat.shards:
-        index: sync_id_no_flush_test
-        h: index,state,sync_id
-  - match:
-      $body: |
-               /^(sync_id_no_flush_test\s+STARTED\s+\n){5}$/
-
-  - do:
-      indices.delete:
-        index: sync_id_no_flush_test
-
   - do:
       indices.create:
         index: index1
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.flush/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.flush/10_basic.yml
index ff99d20e9b761..e3681c834dbad 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.flush/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.flush/10_basic.yml
@@ -1,26 +1,32 @@
 ---
 "Index synced flush rest test":
-    - do:
-       indices.create:
-          index: testing
-          body:
-            settings:
-              index:
-                number_of_replicas: 0
+  - skip:
+      version: " - 7.5.99"
+      reason: "synced flush is deprecated in 7.6"
+      features: "warnings"
+  - do:
+      indices.create:
+        index: testing
+        body:
+          settings:
+            index:
+              number_of_replicas: 0
 
-    - do:
-       cluster.health:
-          wait_for_status: green
-    - do:
-       indices.flush_synced:
-          index: testing
+  - do:
+      cluster.health:
+        wait_for_status: green
+  - do:
+      warnings:
+        - Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead.
+      indices.flush_synced:
+        index: testing
 
-    - is_false: _shards.failed
+  - is_false: _shards.failed
 
-    - do:
-       indices.stats: {level: shards}
+  - do:
+      indices.stats: {level: shards}
 
-    - is_true: indices.testing.shards.0.0.commit.user_data.sync_id
+  - is_true: indices.testing.shards.0.0.commit.user_data.sync_id
 
 ---
 "Flush stats":
diff --git a/server/src/main/java/org/elasticsearch/indices/flush/SyncedFlushService.java b/server/src/main/java/org/elasticsearch/indices/flush/SyncedFlushService.java
index c0e0d513b33d7..a0fc2e153b90e 100644
--- a/server/src/main/java/org/elasticsearch/indices/flush/SyncedFlushService.java
+++ b/server/src/main/java/org/elasticsearch/indices/flush/SyncedFlushService.java
@@ -40,6 +40,7 @@
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.util.concurrent.ConcurrentCollections;
 import org.elasticsearch.common.util.concurrent.CountDown;
 import org.elasticsearch.index.Index;
@@ -74,6 +75,11 @@ public class SyncedFlushService {
 
     private static final Logger logger = LogManager.getLogger(SyncedFlushService.class);
 
+    private static final DeprecationLogger DEPRECATION_LOGGER = new DeprecationLogger(logger);
+
+    public static final String SYNCED_FLUSH_DEPRECATION_MESSAGE =
+        "Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead.";
+
     private static final String PRE_SYNCED_FLUSH_ACTION_NAME = "internal:indices/flush/synced/pre";
     private static final String SYNCED_FLUSH_ACTION_NAME = "internal:indices/flush/synced/sync";
     private static final String IN_FLIGHT_OPS_ACTION_NAME = "internal:indices/flush/synced/in_flight";
@@ -109,6 +115,7 @@ public void attemptSyncedFlush(final String[] aliasesOrIndices,
                                    IndicesOptions indicesOptions,
                                    final ActionListener<SyncedFlushResponse> listener) {
         final ClusterState state = clusterService.state();
+        DEPRECATION_LOGGER.deprecatedAndMaybeLog("synced_flush", SYNCED_FLUSH_DEPRECATION_MESSAGE);
         final Index[] concreteIndices = indexNameExpressionResolver.concreteIndices(state, indicesOptions, aliasesOrIndices);
         final Map<String, List<ShardsSyncedFlushResult>> results = ConcurrentCollections.newConcurrentMap();
         int numberOfShards = 0;
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index a1968332c734b..988975619fd89 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -54,6 +54,7 @@
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.seqno.ReplicationTracker;
+import org.elasticsearch.indices.flush.SyncedFlushService;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.snapshots.SnapshotState;
 import org.elasticsearch.test.ESTestCase;
@@ -1212,4 +1213,19 @@ protected static Version minimumNodeVersion() throws IOException {
         assertNotNull(minVersion);
         return minVersion;
     }
+
+    protected static Response performSyncedFlush(String indexName) throws IOException {
+        final Request request = new Request("POST", indexName + "/_flush/synced");
+        final List<String> expectedWarnings = Collections.singletonList(SyncedFlushService.SYNCED_FLUSH_DEPRECATION_MESSAGE);
+        if (nodeVersions.stream().allMatch(version -> version.onOrAfter(Version.V_7_6_0))) {
+            final Builder options = RequestOptions.DEFAULT.toBuilder();
+            options.setWarningsHandler(warnings -> warnings.equals(expectedWarnings) == false);
+            request.setOptions(options);
+        } else if (nodeVersions.stream().anyMatch(version -> version.onOrAfter(Version.V_7_6_0))) {
+            final Builder options = RequestOptions.DEFAULT.toBuilder();
+            options.setWarningsHandler(warnings -> warnings.isEmpty() == false && warnings.equals(expectedWarnings) == false);
+            request.setOptions(options);
+        }
+        return client().performRequest(request);
+    }
 }

From 6b2a46db3fb508b6776515022d5852f5bfc0ca7f Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Mon, 13 Jan 2020 19:59:50 -0500
Subject: [PATCH 537/686] Remove outdated requirement of CCR (#50859)

With retention leases, users do not need to set
index.soft_deletes.retention.operations. This change removes it from the
requirements of CCR
---
 docs/reference/ccr/requirements.asciidoc | 55 ------------------------
 1 file changed, 55 deletions(-)

diff --git a/docs/reference/ccr/requirements.asciidoc b/docs/reference/ccr/requirements.asciidoc
index 2e92d75707ba5..5e3b188849aa6 100644
--- a/docs/reference/ccr/requirements.asciidoc
+++ b/docs/reference/ccr/requirements.asciidoc
@@ -41,58 +41,3 @@ to a follower the following process will fail due to incomplete history on the l
 The default value is `12h`.
 
 For more information about index settings, see {ref}/index-modules.html[Index modules].
-
-
-[[ccr-overview-beats]]
-==== Setting soft deletes on indices created by APM Server or Beats
-
-If you want to replicate indices created by APM Server or Beats, and are
-allowing APM Server or Beats to manage index templates, you need to configure
-soft deletes on the underlying index templates. To configure soft deletes on the
-underlying index templates, incorporate the following changes to the relevant
-APM Server or Beats configuration file.
-
-["source","yaml"]
-----------------------------------------------------------------------
-setup.template.overwrite: true
-setup.template.settings:
-  index.soft_deletes.retention.operations: 1024
-----------------------------------------------------------------------
-
-For additional information on controlling the index templates managed by APM
-Server or Beats, see the relevant documentation on loading the Elasticsearch
-index template.
-
-
-[[ccr-overview-logstash]]
-==== Setting soft deletes on indices created by Logstash
-
-If you want to replicate indices created by Logstash, and are using Logstash to
-manage index templates, you need to configure soft deletes on a custom Logstash
-index template. To configure soft deletes on the underlying index template,
-incorporate the following change to a custom Logstash template.
-
-["source","js"]
-----------------------------------------------------------------------
-{
-  "settings" : {
-    "index.soft_deletes.retention.operations" : 1024
-  }
-}
-----------------------------------------------------------------------
-// NOTCONSOLE
-
-Additionally, you will need to configure the Elasticsearch output plugin to use
-this custom template.
-
-["source","ruby"]
-----------------------------------------------------------------------
-output {
-  elasticsearch {
-    template => "/path/to/custom/logstash/template.json"
-  }
-}
-----------------------------------------------------------------------
-
-For additional information on controlling the index templates managed by
-Logstash, see the relevant documentation on the Elasticsearch output plugin.

From 9760f2d9fead3fff6d48e781d11c82ef892f89d9 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Tue, 14 Jan 2020 12:41:31 +1100
Subject: [PATCH 538/686] Support Client and RoleMapping in custom Realms
 (#50534)

Previously custom realms were limited in what services and components
they had easy access to. It was possible to work around this because a
security extension is packaged within a Plugin, so there were ways to
store this components in static/SetOnce variables and access them from
the realm, but those techniques were fragile, undocumented and
difficult to discover.

This change includes key services as an argument to most of the methods
on SecurityExtension so that custom realm / role provider authors can
have easy access to them.

Resolves: #48369
---
 .../core/security/SecurityExtension.java      | 38 ++++++--
 .../security/authc/support/CachingRealm.java  |  2 +-
 .../authc/support/UserRoleMapper.java         |  2 +-
 .../xpack/security/Security.java              | 14 ++-
 .../realm/TransportClearRealmCacheAction.java |  2 +-
 .../authc/kerberos/KerberosRealm.java         |  4 +-
 .../xpack/security/authc/ldap/LdapRealm.java  |  4 +-
 .../authc/oidc/OpenIdConnectRealm.java        |  2 +-
 .../xpack/security/authc/pki/PkiRealm.java    |  4 +-
 .../xpack/security/authc/saml/SamlRealm.java  |  2 +-
 .../support/CachingUsernamePasswordRealm.java |  1 +
 .../security/authc/support/DnRoleMapper.java  |  2 +
 .../support/mapper/CompositeRoleMapper.java   |  4 +-
 .../mapper/NativeRoleMappingStore.java        |  4 +-
 .../security/support/ExtensionComponents.java | 71 ++++++++++++++
 .../xpack/security/SecurityTests.java         |  2 +-
 ...ansportOpenIdConnectLogoutActionTests.java |  2 +-
 .../saml/TransportSamlLogoutActionTests.java  |  2 +-
 .../kerberos/KerberosRealmCacheTests.java     |  2 +-
 .../authc/kerberos/KerberosRealmTestCase.java |  2 +-
 .../authc/kerberos/KerberosRealmTests.java    |  2 +-
 .../authc/oidc/OpenIdConnectRealmTests.java   |  2 +-
 .../security/authc/pki/PkiRealmTests.java     |  2 +-
 .../authc/saml/SamlRealmTestHelper.java       |  2 +-
 .../security/authc/saml/SamlRealmTests.java   |  2 +-
 .../DistinguishedNamePredicateTests.java      |  3 +-
 .../mapper/ExpressionRoleMappingTests.java    |  2 +-
 .../mapper/NativeRoleMappingStoreTests.java   |  2 +-
 .../build.gradle                              |  1 +
 .../example/ExampleSecurityExtension.java     | 18 ++--
 .../example/SpiExtensionPlugin.java           |  2 +
 .../example/realm/CustomRoleMappingRealm.java | 96 +++++++++++++++++++
 .../realm/CustomRoleMappingRealmIT.java       | 69 +++++++++++++
 .../realm/CustomRoleMappingRealmTests.java    | 68 +++++++++++++
 34 files changed, 390 insertions(+), 47 deletions(-)
 rename x-pack/plugin/{security/src/main/java/org/elasticsearch/xpack => core/src/main/java/org/elasticsearch/xpack/core}/security/authc/support/CachingRealm.java (93%)
 rename x-pack/plugin/{security/src/main/java/org/elasticsearch/xpack => core/src/main/java/org/elasticsearch/xpack/core}/security/authc/support/UserRoleMapper.java (99%)
 create mode 100644 x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/ExtensionComponents.java
 create mode 100644 x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/realm/CustomRoleMappingRealm.java
 create mode 100644 x-pack/qa/security-example-spi-extension/src/test/java/org/elasticsearch/example/realm/CustomRoleMappingRealmIT.java
 create mode 100644 x-pack/qa/security-example-spi-extension/src/test/java/org/elasticsearch/example/realm/CustomRoleMappingRealmTests.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityExtension.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityExtension.java
index 9f0eb474a59c8..b45d4ad99ccbd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityExtension.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityExtension.java
@@ -7,10 +7,15 @@
 
 import org.apache.lucene.util.SPIClassIterator;
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.watcher.ResourceWatcherService;
 import org.elasticsearch.xpack.core.security.authc.AuthenticationFailureHandler;
 import org.elasticsearch.xpack.core.security.authc.Realm;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.core.security.authz.AuthorizationEngine;
 import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
 import org.elasticsearch.xpack.core.security.authz.store.RoleRetrievalResult;
@@ -28,6 +33,26 @@
  */
 public interface SecurityExtension {
 
+    /**
+     * This interface provides access to components (clients and services) that may be used
+     * within custom realms and role providers.
+     */
+    interface SecurityComponents {
+        /** Global settings for the current node */
+        Settings settings();
+        /** Provides access to key filesystem paths */
+        Environment environment();
+        /** An internal client for retrieving information/data from this cluster */
+        Client client();
+        /** The Elasticsearch thread pools */
+        ThreadPool threadPool();
+        /** Provides the ability to monitor files for changes */
+        ResourceWatcherService resourceWatcherService();
+        /** Access to listen to changes in cluster state and settings  */
+        ClusterService clusterService();
+        /** Provides support for mapping users' roles from groups and metadata */
+        UserRoleMapper roleMapper();
+    }
     /**
      * Returns authentication realm implementations added by this extension.
      *
@@ -35,9 +60,9 @@ public interface SecurityExtension {
      * is a {@link Realm.Factory} which will construct
      * that realm for use in authentication when that realm type is configured.
      *
-     * @param resourceWatcherService Use to watch configuration files for changes
+     * @param components Access to components that may be used to build realms
      */
-    default Map<String, Realm.Factory> getRealms(ResourceWatcherService resourceWatcherService) {
+    default Map<String, Realm.Factory> getRealms(SecurityComponents components) {
         return Collections.emptyMap();
     }
 
@@ -46,8 +71,10 @@ default Map<String, Realm.Factory> getRealms(ResourceWatcherService resourceWatc
      *
      * Only one installed extension may have an authentication failure handler. If more than
      * one extension returns a non-null handler, an error is raised.
+     *
+     * @param components Access to components that may be used to build the handler
      */
-    default AuthenticationFailureHandler getAuthenticationFailureHandler() {
+    default AuthenticationFailureHandler getAuthenticationFailureHandler(SecurityComponents components) {
         return null;
     }
 
@@ -72,11 +99,10 @@ default AuthenticationFailureHandler getAuthenticationFailureHandler() {
      *
      * By default, an empty list is returned.
      *
-     * @param settings The configured settings for the node
-     * @param resourceWatcherService Use to watch configuration files for changes
+     * @param components Access to components that may be used to build roles
      */
     default List<BiConsumer<Set<String>, ActionListener<RoleRetrievalResult>>>
-        getRolesProviders(Settings settings, ResourceWatcherService resourceWatcherService) {
+        getRolesProviders(SecurityComponents components) {
         return Collections.emptyList();
     }
 
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/CachingRealm.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/CachingRealm.java
similarity index 93%
rename from x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/CachingRealm.java
rename to x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/CachingRealm.java
index 6089c8f9a70fb..9f561956b9106 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/CachingRealm.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/CachingRealm.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.security.authc.support;
+package org.elasticsearch.xpack.core.security.authc.support;
 
 import org.elasticsearch.xpack.core.security.authc.Realm;
 
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/UserRoleMapper.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/UserRoleMapper.java
similarity index 99%
rename from x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/UserRoleMapper.java
rename to x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/UserRoleMapper.java
index 6ceb9629d6b4f..8a1b14cef483d 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/UserRoleMapper.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/UserRoleMapper.java
@@ -3,7 +3,7 @@
  * or more contributor license agreements. Licensed under the Elastic License;
  * you may not use this file except in compliance with the Elastic License.
  */
-package org.elasticsearch.xpack.security.authc.support;
+package org.elasticsearch.xpack.core.security.authc.support;
 
 import com.unboundid.ldap.sdk.DN;
 import com.unboundid.ldap.sdk.LDAPException;
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
index 0211aa429a8a9..e295dfd696bc3 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
@@ -232,6 +232,7 @@
 import org.elasticsearch.xpack.security.rest.action.user.RestHasPrivilegesAction;
 import org.elasticsearch.xpack.security.rest.action.user.RestPutUserAction;
 import org.elasticsearch.xpack.security.rest.action.user.RestSetEnabledAction;
+import org.elasticsearch.xpack.security.support.ExtensionComponents;
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 import org.elasticsearch.xpack.security.support.SecurityStatusChangeListener;
 import org.elasticsearch.xpack.security.transport.SecurityHttpSettings;
@@ -391,10 +392,12 @@ Collection<Object> createComponents(Client client, ThreadPool threadPool, Cluste
         final AnonymousUser anonymousUser = new AnonymousUser(settings);
         final ReservedRealm reservedRealm = new ReservedRealm(env, settings, nativeUsersStore,
                 anonymousUser, securityIndex.get(), threadPool);
+        final SecurityExtension.SecurityComponents extensionComponents = new ExtensionComponents(env, client, clusterService,
+            resourceWatcherService, nativeRoleMappingStore);
         Map<String, Realm.Factory> realmFactories = new HashMap<>(InternalRealms.getFactories(threadPool, resourceWatcherService,
                 getSslService(), nativeUsersStore, nativeRoleMappingStore, securityIndex.get()));
         for (SecurityExtension extension : securityExtensions) {
-            Map<String, Realm.Factory> newRealms = extension.getRealms(resourceWatcherService);
+            Map<String, Realm.Factory> newRealms = extension.getRealms(extensionComponents);
             for (Map.Entry<String, Realm.Factory> entry : newRealms.entrySet()) {
                 if (realmFactories.put(entry.getKey(), entry.getValue()) != null) {
                     throw new IllegalArgumentException("Realm type [" + entry.getKey() + "] is already registered");
@@ -420,7 +423,7 @@ Collection<Object> createComponents(Client client, ThreadPool threadPool, Cluste
         final ReservedRolesStore reservedRolesStore = new ReservedRolesStore();
         List<BiConsumer<Set<String>, ActionListener<RoleRetrievalResult>>> rolesProviders = new ArrayList<>();
         for (SecurityExtension extension : securityExtensions) {
-            rolesProviders.addAll(extension.getRolesProviders(settings, resourceWatcherService));
+            rolesProviders.addAll(extension.getRolesProviders(extensionComponents));
         }
 
         final ApiKeyService apiKeyService = new ApiKeyService(settings, Clock.systemUTC(), client, getLicenseState(), securityIndex.get(),
@@ -436,7 +439,7 @@ Collection<Object> createComponents(Client client, ThreadPool threadPool, Cluste
         getLicenseState().addListener(allRolesStore::invalidateAll);
         getLicenseState().addListener(new SecurityStatusChangeListener(getLicenseState()));
 
-        final AuthenticationFailureHandler failureHandler = createAuthenticationFailureHandler(realms);
+        final AuthenticationFailureHandler failureHandler = createAuthenticationFailureHandler(realms, extensionComponents);
         authcService.set(new AuthenticationService(settings, realms, auditTrailService, failureHandler, threadPool,
                 anonymousUser, tokenService, apiKeyService));
         components.add(authcService.get());
@@ -496,11 +499,12 @@ private AuthorizationEngine getAuthorizationEngine() {
         return authorizationEngine;
     }
 
-    private AuthenticationFailureHandler createAuthenticationFailureHandler(final Realms realms) {
+    private AuthenticationFailureHandler createAuthenticationFailureHandler(final Realms realms,
+                                                                            final SecurityExtension.SecurityComponents components) {
         AuthenticationFailureHandler failureHandler = null;
         String extensionName = null;
         for (SecurityExtension extension : securityExtensions) {
-            AuthenticationFailureHandler extensionFailureHandler = extension.getAuthenticationFailureHandler();
+            AuthenticationFailureHandler extensionFailureHandler = extension.getAuthenticationFailureHandler(components);
             if (extensionFailureHandler != null && failureHandler != null) {
                 throw new IllegalStateException("Extensions [" + extensionName + "] and [" + extension.toString() + "] "
                         + "both set an authentication failure handler");
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/realm/TransportClearRealmCacheAction.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/realm/TransportClearRealmCacheAction.java
index 8acc6631920fc..74ce788322293 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/realm/TransportClearRealmCacheAction.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/realm/TransportClearRealmCacheAction.java
@@ -21,7 +21,7 @@
 import org.elasticsearch.xpack.core.security.authc.Realm;
 import org.elasticsearch.xpack.security.authc.AuthenticationService;
 import org.elasticsearch.xpack.security.authc.Realms;
-import org.elasticsearch.xpack.security.authc.support.CachingRealm;
+import org.elasticsearch.xpack.core.security.authc.support.CachingRealm;
 
 import java.io.IOException;
 import java.util.List;
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealm.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealm.java
index 2ca8efd4cd5e5..297cb9f500f3a 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealm.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealm.java
@@ -21,9 +21,9 @@
 import org.elasticsearch.xpack.core.security.authc.RealmConfig;
 import org.elasticsearch.xpack.core.security.authc.kerberos.KerberosRealmSettings;
 import org.elasticsearch.xpack.core.security.user.User;
-import org.elasticsearch.xpack.security.authc.support.CachingRealm;
+import org.elasticsearch.xpack.core.security.authc.support.CachingRealm;
 import org.elasticsearch.xpack.security.authc.support.DelegatedAuthorizationSupport;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.security.authc.support.mapper.NativeRoleMappingStore;
 import org.ietf.jgss.GSSException;
 
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ldap/LdapRealm.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ldap/LdapRealm.java
index 2f104c98cbdc6..388c12076c76f 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ldap/LdapRealm.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ldap/LdapRealm.java
@@ -35,8 +35,8 @@
 import org.elasticsearch.xpack.security.authc.ldap.support.SessionFactory;
 import org.elasticsearch.xpack.security.authc.support.CachingUsernamePasswordRealm;
 import org.elasticsearch.xpack.security.authc.support.DelegatedAuthorizationSupport;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper.UserData;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper.UserData;
 import org.elasticsearch.xpack.security.authc.support.mapper.CompositeRoleMapper;
 import org.elasticsearch.xpack.security.authc.support.mapper.NativeRoleMappingStore;
 
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealm.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealm.java
index 4e05d82db82f7..8f3f05ea30d39 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealm.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealm.java
@@ -44,7 +44,7 @@
 import org.elasticsearch.xpack.core.ssl.SSLService;
 import org.elasticsearch.xpack.security.authc.TokenService;
 import org.elasticsearch.xpack.security.authc.support.DelegatedAuthorizationSupport;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 
 import java.net.URI;
 import java.net.URISyntaxException;
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/pki/PkiRealm.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/pki/PkiRealm.java
index ca6e4e09c2d28..525c79379f3d5 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/pki/PkiRealm.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/pki/PkiRealm.java
@@ -32,9 +32,9 @@
 import org.elasticsearch.xpack.core.ssl.SSLConfigurationSettings;
 import org.elasticsearch.xpack.security.authc.BytesKey;
 import org.elasticsearch.xpack.security.authc.TokenService;
-import org.elasticsearch.xpack.security.authc.support.CachingRealm;
+import org.elasticsearch.xpack.core.security.authc.support.CachingRealm;
 import org.elasticsearch.xpack.security.authc.support.DelegatedAuthorizationSupport;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.security.authc.support.mapper.CompositeRoleMapper;
 import org.elasticsearch.xpack.security.authc.support.mapper.NativeRoleMappingStore;
 
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/saml/SamlRealm.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/saml/SamlRealm.java
index b9508ecd97815..4f8677364dcf7 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/saml/SamlRealm.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/saml/SamlRealm.java
@@ -50,7 +50,7 @@
 import org.elasticsearch.xpack.security.authc.Realms;
 import org.elasticsearch.xpack.security.authc.TokenService;
 import org.elasticsearch.xpack.security.authc.support.DelegatedAuthorizationSupport;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.opensaml.core.criterion.EntityIdCriterion;
 import org.opensaml.saml.common.xml.SAMLConstants;
 import org.opensaml.saml.criterion.EntityRoleCriterion;
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/CachingUsernamePasswordRealm.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/CachingUsernamePasswordRealm.java
index fed4e1fb13ee6..1ac41e1c411c8 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/CachingUsernamePasswordRealm.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/CachingUsernamePasswordRealm.java
@@ -17,6 +17,7 @@
 import org.elasticsearch.xpack.core.security.authc.AuthenticationResult;
 import org.elasticsearch.xpack.core.security.authc.AuthenticationToken;
 import org.elasticsearch.xpack.core.security.authc.RealmConfig;
+import org.elasticsearch.xpack.core.security.authc.support.CachingRealm;
 import org.elasticsearch.xpack.core.security.authc.support.CachingUsernamePasswordRealmSettings;
 import org.elasticsearch.xpack.core.security.authc.support.Hasher;
 import org.elasticsearch.xpack.core.security.authc.support.UsernamePasswordToken;
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapper.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapper.java
index f62c8521a69ff..edfad1f443465 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapper.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/DnRoleMapper.java
@@ -20,7 +20,9 @@
 import org.elasticsearch.watcher.ResourceWatcherService;
 import org.elasticsearch.xpack.core.XPackPlugin;
 import org.elasticsearch.xpack.core.security.authc.RealmConfig;
+import org.elasticsearch.xpack.core.security.authc.support.CachingRealm;
 import org.elasticsearch.xpack.core.security.authc.support.DnRoleMapperSettings;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 
 import java.io.IOException;
 import java.nio.file.Files;
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/mapper/CompositeRoleMapper.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/mapper/CompositeRoleMapper.java
index 21f6a1e2a8cda..d6aaf838374dd 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/mapper/CompositeRoleMapper.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/mapper/CompositeRoleMapper.java
@@ -15,9 +15,9 @@
 import org.elasticsearch.action.support.GroupedActionListener;
 import org.elasticsearch.watcher.ResourceWatcherService;
 import org.elasticsearch.xpack.core.security.authc.RealmConfig;
-import org.elasticsearch.xpack.security.authc.support.CachingRealm;
+import org.elasticsearch.xpack.core.security.authc.support.CachingRealm;
 import org.elasticsearch.xpack.security.authc.support.DnRoleMapper;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 
 /**
  * A {@link UserRoleMapper} that composes one or more <i>delegate</i> role-mappers.
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/mapper/NativeRoleMappingStore.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/mapper/NativeRoleMappingStore.java
index f00c48b9d8288..2bd02e6decb1f 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/mapper/NativeRoleMappingStore.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/support/mapper/NativeRoleMappingStore.java
@@ -36,8 +36,8 @@
 import org.elasticsearch.xpack.core.security.authc.support.mapper.ExpressionRoleMapping;
 import org.elasticsearch.xpack.core.security.authc.support.mapper.expressiondsl.ExpressionModel;
 import org.elasticsearch.xpack.core.security.index.RestrictedIndicesNames;
-import org.elasticsearch.xpack.security.authc.support.CachingRealm;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.CachingRealm;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 
 import java.io.IOException;
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/ExtensionComponents.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/ExtensionComponents.java
new file mode 100644
index 0000000000000..4a074540e6190
--- /dev/null
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/ExtensionComponents.java
@@ -0,0 +1,71 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.security.support;
+
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.watcher.ResourceWatcherService;
+import org.elasticsearch.xpack.core.security.SecurityExtension;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
+
+/**
+ * Immutable implementation of {@link SecurityExtension.SecurityComponents}.
+ */
+public final class ExtensionComponents implements SecurityExtension.SecurityComponents {
+    private final Environment environment;
+    private final Client client;
+    private final ClusterService clusterService;
+    private final ResourceWatcherService resourceWatcherService;
+    private final UserRoleMapper roleMapper;
+
+    public ExtensionComponents(Environment environment, Client client, ClusterService clusterService,
+                               ResourceWatcherService resourceWatcherService, UserRoleMapper roleMapper) {
+        this.environment = environment;
+        this.client = client;
+        this.clusterService = clusterService;
+        this.resourceWatcherService = resourceWatcherService;
+        this.roleMapper = roleMapper;
+    }
+
+    @Override
+    public Settings settings() {
+        return environment.settings();
+    }
+
+    @Override
+    public Environment environment() {
+        return environment;
+    }
+
+    @Override
+    public Client client() {
+        return client;
+    }
+
+    @Override
+    public ThreadPool threadPool() {
+        return client.threadPool();
+    }
+
+    @Override
+    public ResourceWatcherService resourceWatcherService() {
+        return resourceWatcherService;
+    }
+
+    @Override
+    public ClusterService clusterService() {
+        return clusterService;
+    }
+
+    @Override
+    public UserRoleMapper roleMapper() {
+        return roleMapper;
+    }
+}
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/SecurityTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/SecurityTests.java
index d5b513284510f..6dff631adc462 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/SecurityTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/SecurityTests.java
@@ -89,7 +89,7 @@ public static class DummyExtension implements SecurityExtension {
         }
 
         @Override
-        public Map<String, Realm.Factory> getRealms(ResourceWatcherService resourceWatcherService) {
+        public Map<String, Realm.Factory> getRealms(SecurityComponents components) {
             return Collections.singletonMap(realmType, config -> null);
         }
     }
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/oidc/TransportOpenIdConnectLogoutActionTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/oidc/TransportOpenIdConnectLogoutActionTests.java
index d2ed6500036c4..9a750409e9aeb 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/oidc/TransportOpenIdConnectLogoutActionTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/oidc/TransportOpenIdConnectLogoutActionTests.java
@@ -51,7 +51,7 @@
 import org.elasticsearch.xpack.security.authc.TokenService;
 import org.elasticsearch.xpack.security.authc.oidc.OpenIdConnectRealm;
 import org.elasticsearch.xpack.security.authc.oidc.OpenIdConnectTestCase;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 import org.junit.After;
 import org.junit.Before;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/saml/TransportSamlLogoutActionTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/saml/TransportSamlLogoutActionTests.java
index f86f01ec4acc5..e24f38824adc8 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/saml/TransportSamlLogoutActionTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/action/saml/TransportSamlLogoutActionTests.java
@@ -61,7 +61,7 @@
 import org.elasticsearch.xpack.security.authc.saml.SamlRealm;
 import org.elasticsearch.xpack.security.authc.saml.SamlRealmTests;
 import org.elasticsearch.xpack.security.authc.saml.SamlTestCase;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 import org.junit.After;
 import org.junit.Before;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmCacheTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmCacheTests.java
index c3d6c5ae07e0e..88c9fd69d7639 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmCacheTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmCacheTests.java
@@ -12,7 +12,7 @@
 import org.elasticsearch.xpack.core.security.authc.AuthenticationResult;
 import org.elasticsearch.xpack.core.security.authc.kerberos.KerberosRealmSettings;
 import org.elasticsearch.xpack.core.security.user.User;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper.UserData;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper.UserData;
 import org.ietf.jgss.GSSException;
 
 import javax.security.auth.login.LoginException;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmTestCase.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmTestCase.java
index fe8220dad4e6e..aa09db07d20ad 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmTestCase.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmTestCase.java
@@ -27,7 +27,7 @@
 import org.elasticsearch.xpack.core.security.authc.kerberos.KerberosRealmSettings;
 import org.elasticsearch.xpack.core.security.support.Exceptions;
 import org.elasticsearch.xpack.core.security.user.User;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.security.authc.support.mapper.NativeRoleMappingStore;
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 import org.junit.After;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmTests.java
index 8d6869404bbaf..3e4d69a2f7f3f 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/kerberos/KerberosRealmTests.java
@@ -22,7 +22,7 @@
 import org.elasticsearch.xpack.core.security.authc.support.UsernamePasswordToken;
 import org.elasticsearch.xpack.core.security.user.User;
 import org.elasticsearch.xpack.security.authc.support.MockLookupRealm;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper.UserData;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper.UserData;
 import org.ietf.jgss.GSSException;
 
 import javax.security.auth.login.LoginException;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealmTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealmTests.java
index 5e69378bea0fc..61177719679b8 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealmTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectRealmTests.java
@@ -25,7 +25,7 @@
 import org.elasticsearch.xpack.core.security.authc.support.DelegatedAuthorizationSettings;
 import org.elasticsearch.xpack.core.security.user.User;
 import org.elasticsearch.xpack.security.authc.support.MockLookupRealm;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.hamcrest.Matchers;
 import org.junit.Before;
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/pki/PkiRealmTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/pki/PkiRealmTests.java
index 5b5d45b1d41fc..f9123c231cd9a 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/pki/PkiRealmTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/pki/PkiRealmTests.java
@@ -29,7 +29,7 @@
 import org.elasticsearch.xpack.core.security.user.User;
 import org.elasticsearch.xpack.security.authc.BytesKey;
 import org.elasticsearch.xpack.security.authc.support.MockLookupRealm;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.junit.Before;
 import org.mockito.Mockito;
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTestHelper.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTestHelper.java
index 9e1414b438d34..e737e189e9395 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTestHelper.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTestHelper.java
@@ -13,7 +13,7 @@
 
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.xpack.core.security.authc.RealmConfig;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.opensaml.saml.common.xml.SAMLConstants;
 import org.opensaml.saml.saml2.metadata.EntityDescriptor;
 import org.opensaml.saml.saml2.metadata.IDPSSODescriptor;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTests.java
index 9b86075107876..020b58422f13f 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/saml/SamlRealmTests.java
@@ -35,7 +35,7 @@
 import org.elasticsearch.xpack.core.ssl.TestsSSLService;
 import org.elasticsearch.xpack.security.authc.Realms;
 import org.elasticsearch.xpack.security.authc.support.MockLookupRealm;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.hamcrest.Matchers;
 import org.junit.Before;
 import org.mockito.Mockito;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/DistinguishedNamePredicateTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/DistinguishedNamePredicateTests.java
index 51ea82fc0e431..07d75079a2588 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/DistinguishedNamePredicateTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/DistinguishedNamePredicateTests.java
@@ -7,6 +7,7 @@
 
 import com.unboundid.ldap.sdk.DN;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.core.security.authc.support.mapper.expressiondsl.FieldExpression.FieldValue;
 
 import java.util.Locale;
@@ -73,4 +74,4 @@ public void testParsingMalformedInput() {
     private void assertPredicate(Predicate<FieldValue> predicate, Object value, boolean expected) {
         assertThat("Predicate [" + predicate + "] match [" + value + "]", predicate.test(new FieldValue(value)), equalTo(expected));
     }
-}
\ No newline at end of file
+}
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/mapper/ExpressionRoleMappingTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/mapper/ExpressionRoleMappingTests.java
index 6f78435a47c14..3b67fb1954c2e 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/mapper/ExpressionRoleMappingTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/mapper/ExpressionRoleMappingTests.java
@@ -33,7 +33,7 @@
 import org.elasticsearch.xpack.core.security.authc.support.mapper.expressiondsl.AllExpression;
 import org.elasticsearch.xpack.core.security.authc.support.mapper.expressiondsl.AnyExpression;
 import org.elasticsearch.xpack.core.security.authc.support.mapper.expressiondsl.FieldExpression;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.hamcrest.Matchers;
 import org.junit.Before;
 import org.mockito.Mockito;
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/mapper/NativeRoleMappingStoreTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/mapper/NativeRoleMappingStoreTests.java
index 787d4069c1e1e..a7af38a05379a 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/mapper/NativeRoleMappingStoreTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/support/mapper/NativeRoleMappingStoreTests.java
@@ -34,7 +34,7 @@
 import org.elasticsearch.xpack.core.security.index.RestrictedIndicesNames;
 import org.elasticsearch.xpack.core.security.user.User;
 import org.elasticsearch.xpack.security.authc.support.CachingUsernamePasswordRealm;
-import org.elasticsearch.xpack.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 import org.hamcrest.Matchers;
 
diff --git a/x-pack/qa/security-example-spi-extension/build.gradle b/x-pack/qa/security-example-spi-extension/build.gradle
index 96f189ffc3ac0..26fd474da9020 100644
--- a/x-pack/qa/security-example-spi-extension/build.gradle
+++ b/x-pack/qa/security-example-spi-extension/build.gradle
@@ -28,6 +28,7 @@ testClusters.integTest {
   setting 'xpack.security.authc.realms.custom.custom.filtered_setting', 'should be filtered'
   setting 'xpack.security.authc.realms.file.esusers.order', '1'
   setting 'xpack.security.authc.realms.native.native.order', '2'
+  setting 'xpack.security.authc.realms.custom_role_mapping.role_map.order', '3'
   setting 'xpack.security.enabled', 'true'
   setting 'xpack.ilm.enabled', 'false'
   setting 'xpack.ml.enabled', 'false'
diff --git a/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/ExampleSecurityExtension.java b/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/ExampleSecurityExtension.java
index 3f85d8086d678..764f044a01154 100644
--- a/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/ExampleSecurityExtension.java
+++ b/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/ExampleSecurityExtension.java
@@ -6,14 +6,13 @@
 package org.elasticsearch.example;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.example.realm.CustomAuthenticationFailureHandler;
 import org.elasticsearch.example.realm.CustomRealm;
+import org.elasticsearch.example.realm.CustomRoleMappingRealm;
 import org.elasticsearch.example.role.CustomInMemoryRolesProvider;
-import org.elasticsearch.watcher.ResourceWatcherService;
+import org.elasticsearch.xpack.core.security.SecurityExtension;
 import org.elasticsearch.xpack.core.security.authc.AuthenticationFailureHandler;
 import org.elasticsearch.xpack.core.security.authc.Realm;
-import org.elasticsearch.xpack.core.security.SecurityExtension;
 import org.elasticsearch.xpack.core.security.authz.store.RoleRetrievalResult;
 
 import java.security.AccessController;
@@ -43,19 +42,22 @@ public class ExampleSecurityExtension implements SecurityExtension {
     }
 
     @Override
-    public Map<String, Realm.Factory> getRealms(ResourceWatcherService resourceWatcherService) {
-        return Collections.singletonMap(CustomRealm.TYPE, CustomRealm::new);
+    public Map<String, Realm.Factory> getRealms(SecurityComponents components) {
+        return Map.ofEntries(
+            Map.entry(CustomRealm.TYPE, CustomRealm::new),
+            Map.entry(CustomRoleMappingRealm.TYPE,
+                config -> new CustomRoleMappingRealm(config, components.roleMapper()))
+        );
     }
 
     @Override
-    public AuthenticationFailureHandler getAuthenticationFailureHandler() {
+    public AuthenticationFailureHandler getAuthenticationFailureHandler(SecurityComponents components) {
         return new CustomAuthenticationFailureHandler();
     }
 
-
     @Override
     public List<BiConsumer<Set<String>, ActionListener<RoleRetrievalResult>>>
-    getRolesProviders(Settings settings, ResourceWatcherService resourceWatcherService) {
+    getRolesProviders(SecurityComponents components) {
         CustomInMemoryRolesProvider rp1 = new CustomInMemoryRolesProvider(Collections.singletonMap(ROLE_A, "read"));
         Map<String, String> roles = new HashMap<>();
         roles.put(ROLE_A, "all");
diff --git a/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/SpiExtensionPlugin.java b/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/SpiExtensionPlugin.java
index eedb06f2c1bad..ee47fa0bf7b5b 100644
--- a/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/SpiExtensionPlugin.java
+++ b/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/SpiExtensionPlugin.java
@@ -7,6 +7,7 @@
 
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.example.realm.CustomRealm;
+import org.elasticsearch.example.realm.CustomRoleMappingRealm;
 import org.elasticsearch.plugins.ActionPlugin;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.rest.RestHeaderDefinition;
@@ -33,6 +34,7 @@ public Collection<RestHeaderDefinition> getRestHeaders() {
     public List<Setting<?>> getSettings() {
         List<Setting<?>> list = new ArrayList<>(RealmSettings.getStandardSettings(CustomRealm.TYPE));
         list.add(RealmSettings.simpleString(CustomRealm.TYPE, "filtered_setting", Setting.Property.NodeScope, Setting.Property.Filtered));
+        list.addAll(RealmSettings.getStandardSettings(CustomRoleMappingRealm.TYPE));
         return list;
     }
 }
diff --git a/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/realm/CustomRoleMappingRealm.java b/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/realm/CustomRoleMappingRealm.java
new file mode 100644
index 0000000000000..2b277d39b1364
--- /dev/null
+++ b/x-pack/qa/security-example-spi-extension/src/main/java/org/elasticsearch/example/realm/CustomRoleMappingRealm.java
@@ -0,0 +1,96 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.example.realm;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.common.cache.Cache;
+import org.elasticsearch.common.cache.CacheBuilder;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.xpack.core.security.authc.AuthenticationResult;
+import org.elasticsearch.xpack.core.security.authc.AuthenticationToken;
+import org.elasticsearch.xpack.core.security.authc.Realm;
+import org.elasticsearch.xpack.core.security.authc.RealmConfig;
+import org.elasticsearch.xpack.core.security.authc.support.CachingRealm;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.authc.support.UsernamePasswordToken;
+import org.elasticsearch.xpack.core.security.user.User;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * An example realm with specific behaviours:
+ * (1) It only supports lookup (that is, "run-as" and "authorization_realms") but not authentication
+ * (2) It performs role mapping to determine the roles for the looked-up user
+ * (3) It caches the looked-up User objects
+ */
+public class CustomRoleMappingRealm extends Realm implements CachingRealm {
+
+    public static final String TYPE = "custom_role_mapping";
+
+    static final String USERNAME = "role_mapped_user";
+    static final String USER_GROUP = "user_group";
+
+    private final Cache<String, User> cache;
+    private final UserRoleMapper roleMapper;
+
+    public CustomRoleMappingRealm(RealmConfig config, UserRoleMapper roleMapper) {
+        super(config);
+        this.cache = CacheBuilder.<String, User>builder().build();
+        this.roleMapper = roleMapper;
+        this.roleMapper.refreshRealmOnChange(this);
+    }
+
+    @Override
+    public boolean supports(AuthenticationToken token) {
+        return false;
+    }
+
+    @Override
+    public UsernamePasswordToken token(ThreadContext threadContext) {
+        return null;
+    }
+
+    @Override
+    public void authenticate(AuthenticationToken authToken, ActionListener<AuthenticationResult> listener) {
+        listener.onResponse(AuthenticationResult.notHandled());
+    }
+
+    @Override
+    public void lookupUser(String username, ActionListener<User> listener) {
+        final User user = cache.get(username);
+        if (user != null) {
+            listener.onResponse(user);
+            return;
+        }
+        if (USERNAME.equals(username)) {
+            buildUser(username, ActionListener.wrap(
+                u -> listener.onResponse(cache.computeIfAbsent(username, k -> u)),
+                listener::onFailure
+            ));
+        } else {
+            listener.onResponse(null);
+        }
+    }
+
+    private void buildUser(String username, ActionListener<User> listener) {
+        final UserRoleMapper.UserData data = new UserRoleMapper.UserData(username, null, List.of(USER_GROUP), Map.of(), super.config);
+        roleMapper.resolveRoles(data, ActionListener.wrap(
+            roles -> listener.onResponse(new User(username, roles.toArray(String[]::new))),
+            listener::onFailure
+        ));
+    }
+
+    @Override
+    public void expire(String username) {
+        this.cache.invalidate(username);
+    }
+
+    @Override
+    public void expireAll() {
+        this.cache.invalidateAll();
+    }
+}
diff --git a/x-pack/qa/security-example-spi-extension/src/test/java/org/elasticsearch/example/realm/CustomRoleMappingRealmIT.java b/x-pack/qa/security-example-spi-extension/src/test/java/org/elasticsearch/example/realm/CustomRoleMappingRealmIT.java
new file mode 100644
index 0000000000000..4eee89d0d6ce5
--- /dev/null
+++ b/x-pack/qa/security-example-spi-extension/src/test/java/org/elasticsearch/example/realm/CustomRoleMappingRealmIT.java
@@ -0,0 +1,69 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.example.realm;
+
+import org.elasticsearch.client.Request;
+import org.elasticsearch.client.RequestOptions;
+import org.elasticsearch.client.Response;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.test.rest.ESRestTestCase;
+import org.junit.Before;
+
+import java.util.List;
+import java.util.Map;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.instanceOf;
+import static org.hamcrest.Matchers.is;
+
+/**
+ * Integration test to test authentication with the custom role-mapping realm
+ */
+public class CustomRoleMappingRealmIT extends ESRestTestCase {
+
+    private String expectedRole;
+
+    @Override
+    protected Settings restClientSettings() {
+        return Settings.builder()
+            .put(ThreadContext.PREFIX + "." + CustomRealm.USER_HEADER, CustomRealm.KNOWN_USER)
+            .put(ThreadContext.PREFIX + "." + CustomRealm.PW_HEADER, CustomRealm.KNOWN_PW.toString())
+            .build();
+    }
+
+    @Before
+    public void setupRoleMapping() throws Exception {
+        expectedRole = randomAlphaOfLengthBetween(4, 16);
+        Request request = new Request("PUT", "/_security/role_mapping/test");
+        request.setJsonEntity("{" +
+            "\"enabled\": true," +
+            "\"roles\":[\"" +
+            expectedRole +
+            "\"]," +
+            "\"rules\":{\"field\":{\"groups\":\"" + CustomRoleMappingRealm.USER_GROUP + "\"} }" +
+            "}");
+        adminClient().performRequest(request);
+    }
+
+    public void testUserWithRoleMapping() throws Exception {
+        Request request = new Request("GET", "/_security/_authenticate");
+        RequestOptions.Builder options = request.getOptions().toBuilder();
+        // Authenticate as the custom realm superuser
+        options.addHeader(CustomRealm.USER_HEADER, CustomRealm.KNOWN_USER);
+        options.addHeader(CustomRealm.PW_HEADER, CustomRealm.KNOWN_PW.toString());
+        // But "run-as" the role mapped user
+        options.addHeader("es-security-runas-user", CustomRoleMappingRealm.USERNAME);
+        request.setOptions(options);
+
+        final Response response = client().performRequest(request);
+        final Map<String, Object> authenticate = entityAsMap(response);
+        assertThat(authenticate.get("username"), is(CustomRoleMappingRealm.USERNAME));
+        assertThat(authenticate.get("roles"), instanceOf(List.class));
+        assertThat(authenticate.get("roles"), equalTo(List.of(expectedRole)));
+    }
+
+}
diff --git a/x-pack/qa/security-example-spi-extension/src/test/java/org/elasticsearch/example/realm/CustomRoleMappingRealmTests.java b/x-pack/qa/security-example-spi-extension/src/test/java/org/elasticsearch/example/realm/CustomRoleMappingRealmTests.java
new file mode 100644
index 0000000000000..4057f2636d08f
--- /dev/null
+++ b/x-pack/qa/security-example-spi-extension/src/test/java/org/elasticsearch/example/realm/CustomRoleMappingRealmTests.java
@@ -0,0 +1,68 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+package org.elasticsearch.example.realm;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.security.authc.RealmConfig;
+import org.elasticsearch.xpack.core.security.authc.support.UserRoleMapper;
+import org.elasticsearch.xpack.core.security.user.User;
+
+import java.util.Set;
+import java.util.concurrent.atomic.AtomicInteger;
+import java.util.function.Supplier;
+
+import static org.hamcrest.Matchers.arrayContainingInAnyOrder;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.sameInstance;
+import static org.mockito.Matchers.any;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.mock;
+
+public class CustomRoleMappingRealmTests extends ESTestCase {
+
+    public void testCachingOfUserLookup() throws Exception {
+        final Environment env = super.newEnvironment();
+        final UserRoleMapper roleMapper = mock(UserRoleMapper.class);
+        final RealmConfig realmConfig = new RealmConfig(
+            new RealmConfig.RealmIdentifier(CustomRoleMappingRealm.TYPE, "test"),
+            env.settings(), env, new ThreadContext(env.settings())
+        );
+        CustomRoleMappingRealm realm = new CustomRoleMappingRealm(realmConfig, roleMapper);
+
+        final AtomicInteger roleMappingCounter = new AtomicInteger(0);
+        mockRoleMapping(roleMapper, () -> {
+            roleMappingCounter.incrementAndGet();
+            return Set.of("role1", "role2");
+        });
+
+        PlainActionFuture<User> future = new PlainActionFuture<>();
+        realm.lookupUser(CustomRoleMappingRealm.USERNAME, future);
+        final User user1 = future.get();
+        assertThat(user1.principal(), is(CustomRoleMappingRealm.USERNAME));
+        assertThat(user1.roles(), arrayContainingInAnyOrder("role1", "role2"));
+        assertThat(roleMappingCounter.get(), is(1));
+
+        future = new PlainActionFuture<>();
+        realm.lookupUser(CustomRoleMappingRealm.USERNAME, future);
+        final User user2 = future.get();
+        assertThat(user2, sameInstance(user1));
+        assertThat(roleMappingCounter.get(), is(1));
+    }
+
+    @SuppressWarnings("unchecked")
+    private void mockRoleMapping(UserRoleMapper roleMapper, Supplier<Set<String>> supplier) {
+        doAnswer(inv -> {
+            ActionListener<Set<String>> listener = (ActionListener<Set<String>>) inv.getArguments()[1];
+            listener.onResponse(supplier.get());
+            return null;
+        }).when(roleMapper).resolveRoles(any(UserRoleMapper.UserData.class), any(ActionListener.class));
+    }
+
+}

From 44c658c6eff5d77954f5d464284f2450b693b420 Mon Sep 17 00:00:00 2001
From: Larry Gregory <larry.gregory@elastic.co>
Date: Tue, 14 Jan 2020 02:08:44 -0500
Subject: [PATCH 539/686] Deprecating kibana_user and
 kibana_dashboard_only_user roles (#46456)

This change adds a new `kibana_admin` role, and deprecates
the old `kibana_user` and`kibana_dashboard_only_user`roles.

The deprecation is implemented via a new reserved metadata
attribute, which can be consumed from the API and also triggers
deprecation logging when used (by a user authenticating to
Elasticsearch).

Some docs have been updated to avoid references to these
deprecated roles.

Co-authored-by: Tim Vernum <tim@adjective.org>
Co-authored-by: Larry Gregory <legrego@users.noreply.github.com>
---
 .../SecurityDocumentationIT.java              |   4 +-
 .../monitoring/configuring-filebeat.asciidoc  |   2 +-
 .../authentication/oidc-guide.asciidoc        |  10 +-
 .../authentication/saml-guide.asciidoc        |  10 +-
 .../authorization/built-in-roles.asciidoc     |  30 ++-
 .../cross-cluster-kibana.asciidoc             |   5 +-
 .../en/security/get-started-security.asciidoc |   9 +-
 .../authz/store/ReservedRolesStore.java       |  20 +-
 .../core/security/support/MetadataUtils.java  |  10 +
 .../authz/store/ReservedRolesStoreTests.java  |  52 ++++++
 .../authz/store/CompositeRolesStore.java      |  15 ++
 .../authz/store/CompositeRolesStoreTests.java | 173 +++++++++++++-----
 .../authc/oidc/OpenIdConnectAuthIT.java       |   4 +-
 13 files changed, 267 insertions(+), 77 deletions(-)

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/SecurityDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/SecurityDocumentationIT.java
index ec2043d3da296..ce1636987cce8 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/SecurityDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/SecurityDocumentationIT.java
@@ -694,8 +694,8 @@ public void testGetRoles() throws Exception {
 
             List<Role> roles = response.getRoles();
             assertNotNull(response);
-            // 28 system roles plus the three we created
-            assertThat(roles.size(), equalTo(28 + 3));
+            // 29 system roles plus the three we created
+            assertThat(roles.size(), equalTo(29 + 3));
         }
 
         {
diff --git a/docs/reference/monitoring/configuring-filebeat.asciidoc b/docs/reference/monitoring/configuring-filebeat.asciidoc
index d51c65bbac8d4..6f4b5eee8ec53 100644
--- a/docs/reference/monitoring/configuring-filebeat.asciidoc
+++ b/docs/reference/monitoring/configuring-filebeat.asciidoc
@@ -117,7 +117,7 @@ If {security-features} are enabled, you must provide a valid user ID and
 password so that {filebeat} can connect to {kib}: 
 
 .. Create a user on the monitoring cluster that has the 
-<<built-in-roles,`kibana_user` built-in role>> or equivalent
+<<built-in-roles,`kibana_admin` built-in role>> or equivalent
 privileges.
 
 .. Add the `username` and `password` settings to the {es} output information in 
diff --git a/x-pack/docs/en/security/authentication/oidc-guide.asciidoc b/x-pack/docs/en/security/authentication/oidc-guide.asciidoc
index 1e8f4f1c2f50b..b4e647b4a3c97 100644
--- a/x-pack/docs/en/security/authentication/oidc-guide.asciidoc
+++ b/x-pack/docs/en/security/authentication/oidc-guide.asciidoc
@@ -420,14 +420,14 @@ through either the
 NOTE: You cannot use <<mapping-roles-file,role mapping files>>
 to grant roles to users authenticating via OpenID Connect.
 
-This is an example of a simple role mapping that grants the `kibana_user` role
+This is an example of a simple role mapping that grants the `example_role` role
 to any user who authenticates against the `oidc1` OpenID Connect realm:
 
 [source,console]
 --------------------------------------------------
-PUT /_security/role_mapping/oidc-kibana
+PUT /_security/role_mapping/oidc-example
 {
-  "roles": [ "kibana_user" ],
+  "roles": [ "example_role" ], <1>
   "enabled": true,
   "rules": {
     "field": { "realm.name": "oidc1" }
@@ -435,6 +435,10 @@ PUT /_security/role_mapping/oidc-kibana
 }
 --------------------------------------------------
 
+<1> The `example_role` role is *not* a builtin Elasticsearch role.
+This example assumes that you have created a custom role of your own, with
+appropriate access to your <<roles-indices-priv,indices>> and
+{kibana-ref}/kibana-privileges.html#kibana-feature-privileges[Kibana features].
 
 The user properties that are mapped via the realm configuration are used to process
 role mapping rules, and these rules determine which roles a user is granted.
diff --git a/x-pack/docs/en/security/authentication/saml-guide.asciidoc b/x-pack/docs/en/security/authentication/saml-guide.asciidoc
index 0776d314dfae5..c100ef161c755 100644
--- a/x-pack/docs/en/security/authentication/saml-guide.asciidoc
+++ b/x-pack/docs/en/security/authentication/saml-guide.asciidoc
@@ -639,14 +639,14 @@ through either the
 NOTE: You cannot use <<mapping-roles-file,role mapping files>>
 to grant roles to users authenticating via SAML.
 
-This is an example of a simple role mapping that grants the `kibana_user` role
+This is an example of a simple role mapping that grants the `example_role` role
 to any user who authenticates against the `saml1` realm:
 
 [source,console]
 --------------------------------------------------
-PUT /_security/role_mapping/saml-kibana
+PUT /_security/role_mapping/saml-example
 {
-  "roles": [ "kibana_user" ],
+  "roles": [ "example_role" ], <1>
   "enabled": true,
   "rules": {
     "field": { "realm.name": "saml1" }
@@ -654,6 +654,10 @@ PUT /_security/role_mapping/saml-kibana
 }
 --------------------------------------------------
 
+<1> The `example_role` role is *not* a builtin Elasticsearch role.
+This example assumes that you have created a custom role of your own, with
+appropriate access to your <<roles-indices-priv,indices>> and
+{kibana-ref}/kibana-privileges.html#kibana-feature-privileges[Kibana features].
 
 The attributes that are mapped via the realm configuration are used to process
 role mapping rules, and these rules determine which roles a user is granted.
diff --git a/x-pack/docs/en/security/authorization/built-in-roles.asciidoc b/x-pack/docs/en/security/authorization/built-in-roles.asciidoc
index 55d12709124f4..60043e62f94ed 100644
--- a/x-pack/docs/en/security/authorization/built-in-roles.asciidoc
+++ b/x-pack/docs/en/security/authorization/built-in-roles.asciidoc
@@ -72,10 +72,12 @@ NOTE: This role does *not* provide the ability to create indices; those privileg
 must be defined in a separate role.
 
 [[built-in-roles-kibana-dashboard]] `kibana_dashboard_only_user` ::
-Grants access to the {kib} Dashboard and read-only permissions to Kibana.
-This role does not have access to editing tools in {kib}. For more
-information, see
-{kibana-ref}/xpack-dashboard-only-mode.html[{kib} Dashboard Only Mode].
+(This role is deprecated, please use 
+{kibana-ref}/kibana-privileges.html#kibana-feature-privileges[{kib} feature privileges]
+instead).
+Grants read-only access to the {kib} Dashboard in every 
+{kibana-ref}/xpack-spaces.html[space in {kib}].
+This role does not have access to editing tools in {kib}. 
 
 [[built-in-roles-kibana-system]] `kibana_system` ::
 Grants access necessary for the {kib} system user to read from and write to the
@@ -87,9 +89,15 @@ see {kibana-ref}/using-kibana-with-security.html[Configuring Security in {kib}].
 NOTE: This role should not be assigned to users as the granted permissions may
 change between releases.
 
+[[built-in-roles-kibana-admin]] `kibana_admin`::
+Grants access to all features in {kib}. For more information on {kib} authorization,
+see {kibana-ref}/xpack-security-authorization.html[Kibana authorization].
+
 [[built-in-roles-kibana-user]] `kibana_user`::
-Grants access to all features in {kib}. For more information on Kibana authorization,
-see {kibana-ref}/xpack-security-authorization.html[Kibana Authorization].
+(This role is deprecated, please use the
+<<built-in-roles-kibana-admin,`kibana_admin`>> role instead.)
+Grants access to all features in {kib}. For more information on {kib} authorization,
+see {kibana-ref}/xpack-security-authorization.html[Kibana authorization].
 
 [[built-in-roles-logstash-admin]] `logstash_admin` ::
 Grants access to the `.logstash*` indices for managing configurations.
@@ -127,7 +135,8 @@ Grants the minimum privileges required for any user of {monitoring} other than t
 required to use {kib}. This role grants access to the monitoring indices and grants
 privileges necessary for reading basic cluster information. This role also includes
 all {kibana-ref}/kibana-privileges.html[Kibana privileges] for the {stack-monitor-features}.
-Monitoring users should also be assigned the `kibana_user` role.
+Monitoring users should also be assigned the `kibana_admin` role, or another role
+with {kibana-ref}/xpack-security-authorization.html[access to the {kib} instance].
 
 [[built-in-roles-remote-monitoring-agent]] `remote_monitoring_agent`::
 Grants the minimum privileges required to write data into the monitoring indices
@@ -140,9 +149,10 @@ Grants the minimum privileges required to collect monitoring data for the {stack
 [[built-in-roles-reporting-user]] `reporting_user`::
 Grants the specific privileges required for users of {reporting} other than those
 required to use {kib}. This role grants access to the reporting indices; each 
-user has access to only their own reports. Reporting users should also be 
-assigned the `kibana_user` role and a role that grants them access to the data 
-that will be used to generate reports.
+user has access to only their own reports.
+Reporting users should also be assigned additional roles that grant 
+{kibana-ref}/xpack-security-authorization.html[access to {kib}] as well as read
+access to the <<roles-indices-priv,indices>> that will be used to generate reports.
 
 [[built-in-roles-snapshot-user]] `snapshot_user`::
 Grants the necessary privileges to create snapshots of **all** the indices and
diff --git a/x-pack/docs/en/security/ccs-clients-integrations/cross-cluster-kibana.asciidoc b/x-pack/docs/en/security/ccs-clients-integrations/cross-cluster-kibana.asciidoc
index 95e5d188f0084..f9bcd86889c17 100644
--- a/x-pack/docs/en/security/ccs-clients-integrations/cross-cluster-kibana.asciidoc
+++ b/x-pack/docs/en/security/ccs-clients-integrations/cross-cluster-kibana.asciidoc
@@ -31,8 +31,9 @@ NOTE: If you configure the local cluster as another remote in {es}, the
 `logstash_reader` role on your local cluster also needs to grant the
 `read_cross_cluster` privilege.
 
-. Assign your {kib} users the `kibana_user` role and your `logstash_reader`
-role.
+. Assign your {kib} users a role that grants
+{kibana-ref}/xpack-security-authorization.html[access to {kib}]
+as well as your `logstash_reader` role.
 
 . On the remote cluster, create a `logstash_reader` role that grants the
 `read_cross_cluster` privilege and `read` and `view_index_metadata` privileges
diff --git a/x-pack/docs/en/security/get-started-security.asciidoc b/x-pack/docs/en/security/get-started-security.asciidoc
index dca72e6e1d4ba..82f443016021f 100644
--- a/x-pack/docs/en/security/get-started-security.asciidoc
+++ b/x-pack/docs/en/security/get-started-security.asciidoc
@@ -168,15 +168,16 @@ Select a role to see more information about its privileges. For example, select
 the `kibana_system` role to see its list of cluster and index privileges. To
 learn more, see <<privileges-list-indices>>. 
 
-Let's assign the `kibana_user` role to your user. Go back to the 
-*Management / Security / Users* page and select your user. Add the `kibana_user` 
+Let's assign the `kibana_admin` role to your user. Go back to the 
+*Management / Security / Users* page and select your user. Add the `kibana_admin` 
 role and save the change. For example:
 
 [role="screenshot"]
 image::security/images/assign-role.jpg["Assigning a role to a user in Kibana"]
 
-This user now has access to all features in {kib}. For more information about granting
-access to Kibana see {kibana-ref}/xpack-security-authorization.html[Kibana Authorization].
+This user now has administrative access to all features in {kib}.
+For more information about granting access to Kibana see
+{kibana-ref}/xpack-security-authorization.html[Kibana authorization].
 
 If you completed all of the steps in 
 {stack-gs}/get-started-elastic-stack.html[Getting started with the {stack}], you should 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
index a86f213e2488c..7899797b890d9 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStore.java
@@ -52,11 +52,9 @@ private static Map<String, RoleDescriptor> initializeReservedRoles() {
                 .put("superuser", SUPERUSER_ROLE_DESCRIPTOR)
                 .put("transport_client", new RoleDescriptor("transport_client", new String[] { "transport_client" }, null, null,
                         MetadataUtils.DEFAULT_RESERVED_METADATA))
-                .put("kibana_user", new RoleDescriptor("kibana_user", null, null, new RoleDescriptor.ApplicationResourcePrivileges[] {
-                        RoleDescriptor.ApplicationResourcePrivileges.builder()
-                            .application("kibana-.kibana").resources("*").privileges("all").build() },
-                        null, null,
-                        MetadataUtils.DEFAULT_RESERVED_METADATA, null))
+                .put("kibana_admin", kibanaAdminUser("kibana_admin", MetadataUtils.DEFAULT_RESERVED_METADATA))
+                .put("kibana_user", kibanaAdminUser("kibana_user",
+                    MetadataUtils.getDeprecatedReservedMetadata("Please use the [kibana_admin] role instead")))
                 .put("monitoring_user", new RoleDescriptor("monitoring_user",
                         new String[] { "cluster:monitor/main", "cluster:monitor/xpack/info", RemoteInfoAction.NAME },
                         new RoleDescriptor.IndicesPrivileges[] {
@@ -110,7 +108,7 @@ private static Map<String, RoleDescriptor> initializeReservedRoles() {
                             RoleDescriptor.ApplicationResourcePrivileges.builder()
                             .application("kibana-.kibana").resources("*").privileges("read").build() },
                         null, null,
-                        MetadataUtils.DEFAULT_RESERVED_METADATA,
+                        MetadataUtils.getDeprecatedReservedMetadata("Please use Kibana feature privileges instead"),
                         null))
                 .put(KibanaUser.ROLE_NAME, new RoleDescriptor(KibanaUser.ROLE_NAME,
                         new String[] {
@@ -266,6 +264,16 @@ private static Map<String, RoleDescriptor> initializeReservedRoles() {
                 .immutableMap();
     }
 
+    private static RoleDescriptor kibanaAdminUser(String name, Map<String, Object> metadata) {
+        return new RoleDescriptor(name, null, null,
+            new RoleDescriptor.ApplicationResourcePrivileges[] {
+                RoleDescriptor.ApplicationResourcePrivileges.builder()
+                    .application("kibana-.kibana")
+                    .resources("*").privileges("all")
+                    .build() },
+            null, null, metadata, null);
+    }
+
     public static boolean isReserved(String role) {
         return RESERVED_ROLES.containsKey(role) || UsernamesField.SYSTEM_ROLE.equals(role) || UsernamesField.XPACK_ROLE.equals(role);
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/support/MetadataUtils.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/support/MetadataUtils.java
index 72388a8fdbcb5..e85417b1d94f1 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/support/MetadataUtils.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/support/MetadataUtils.java
@@ -11,6 +11,8 @@ public class MetadataUtils {
 
     public static final String RESERVED_PREFIX = "_";
     public static final String RESERVED_METADATA_KEY = RESERVED_PREFIX + "reserved";
+    public static final String DEPRECATED_METADATA_KEY = RESERVED_PREFIX + "deprecated";
+    public static final String DEPRECATED_REASON_METADATA_KEY = RESERVED_PREFIX + "deprecated_reason";
     public static final Map<String, Object> DEFAULT_RESERVED_METADATA = Map.of(RESERVED_METADATA_KEY, true);
 
     private MetadataUtils() {
@@ -24,4 +26,12 @@ public static boolean containsReservedMetadata(Map<String, Object> metadata) {
         }
         return false;
     }
+
+    public static Map<String, Object> getDeprecatedReservedMetadata(String reason) {
+        return Map.of(
+            RESERVED_METADATA_KEY, true,
+            DEPRECATED_METADATA_KEY, true,
+            DEPRECATED_REASON_METADATA_KEY, reason
+        );
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
index e7166f0c94fef..11cc52a970f72 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
@@ -169,6 +169,7 @@
 
 import static org.hamcrest.Matchers.hasEntry;
 import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.not;
 import static org.mockito.Mockito.mock;
 
 /**
@@ -184,6 +185,7 @@ public void testIsReserved() {
         assertThat(ReservedRolesStore.isReserved("foobar"), is(false));
         assertThat(ReservedRolesStore.isReserved(SystemUser.ROLE_NAME), is(true));
         assertThat(ReservedRolesStore.isReserved("transport_client"), is(true));
+        assertThat(ReservedRolesStore.isReserved("kibana_admin"), is(true));
         assertThat(ReservedRolesStore.isReserved("kibana_user"), is(true));
         assertThat(ReservedRolesStore.isReserved("ingest_admin"), is(true));
         assertThat(ReservedRolesStore.isReserved("monitoring_user"), is(true));
@@ -409,6 +411,54 @@ public void testKibanaSystemRole() {
         assertNoAccessAllowed(kibanaRole, RestrictedIndicesNames.ASYNC_SEARCH_PREFIX + randomAlphaOfLengthBetween(0, 2));
     }
 
+    public void testKibanaAdminRole() {
+        final TransportRequest request = mock(TransportRequest.class);
+        final Authentication authentication = mock(Authentication.class);
+
+        RoleDescriptor roleDescriptor = new ReservedRolesStore().roleDescriptor("kibana_admin");
+        assertNotNull(roleDescriptor);
+        assertThat(roleDescriptor.getMetadata(), hasEntry("_reserved", true));
+        assertThat(roleDescriptor.getMetadata(), not(hasEntry("_deprecated", true)));
+
+        Role kibanaAdminRole = Role.builder(roleDescriptor, null).build();
+        assertThat(kibanaAdminRole.cluster().check(ClusterHealthAction.NAME, request, authentication), is(false));
+        assertThat(kibanaAdminRole.cluster().check(ClusterStateAction.NAME, request, authentication), is(false));
+        assertThat(kibanaAdminRole.cluster().check(ClusterStatsAction.NAME, request, authentication), is(false));
+        assertThat(kibanaAdminRole.cluster().check(PutIndexTemplateAction.NAME, request, authentication), is(false));
+        assertThat(kibanaAdminRole.cluster().check(ClusterRerouteAction.NAME, request, authentication), is(false));
+        assertThat(kibanaAdminRole.cluster().check(ClusterUpdateSettingsAction.NAME, request, authentication),
+                is(false));
+        assertThat(kibanaAdminRole.cluster().check(MonitoringBulkAction.NAME, request, authentication), is(false));
+        assertThat(kibanaAdminRole.cluster().check(DelegatePkiAuthenticationAction.NAME, request, authentication),
+                is(false));
+
+        assertThat(kibanaAdminRole.runAs().check(randomAlphaOfLengthBetween(1, 12)), is(false));
+
+        assertThat(kibanaAdminRole.indices().allowedIndicesMatcher(IndexAction.NAME).test("foo"), is(false));
+        assertThat(kibanaAdminRole.indices().allowedIndicesMatcher(IndexAction.NAME).test(".reporting"), is(false));
+        assertThat(
+                kibanaAdminRole.indices().allowedIndicesMatcher("indices:foo").test(randomAlphaOfLengthBetween(8, 24)),
+                is(false));
+
+        final String randomApplication = "kibana-" + randomAlphaOfLengthBetween(8, 24);
+        assertThat(kibanaAdminRole.application().grants(new ApplicationPrivilege(randomApplication, "app-random", "all"),
+                "*"), is(false));
+
+        final String application = "kibana-.kibana";
+        assertThat(kibanaAdminRole.application().grants(new ApplicationPrivilege(application, "app-foo", "foo"), "*"),
+                is(false));
+        assertThat(kibanaAdminRole.application().grants(new ApplicationPrivilege(application, "app-all", "all"), "*"),
+                is(true));
+
+        final String applicationWithRandomIndex = "kibana-.kibana_" + randomAlphaOfLengthBetween(8, 24);
+        assertThat(
+                kibanaAdminRole.application()
+                        .grants(new ApplicationPrivilege(applicationWithRandomIndex, "app-random-index", "all"), "*"),
+                is(false));
+
+        assertNoAccessAllowed(kibanaAdminRole, RestrictedIndicesNames.RESTRICTED_NAMES);
+    }
+
     public void testKibanaUserRole() {
         final TransportRequest request = mock(TransportRequest.class);
         final Authentication authentication = mock(Authentication.class);
@@ -416,6 +466,7 @@ public void testKibanaUserRole() {
         RoleDescriptor roleDescriptor = new ReservedRolesStore().roleDescriptor("kibana_user");
         assertNotNull(roleDescriptor);
         assertThat(roleDescriptor.getMetadata(), hasEntry("_reserved", true));
+        assertThat(roleDescriptor.getMetadata(), hasEntry("_deprecated", true));
 
         Role kibanaUserRole = Role.builder(roleDescriptor, null).build();
         assertThat(kibanaUserRole.cluster().check(ClusterHealthAction.NAME, request, authentication), is(false));
@@ -745,6 +796,7 @@ public void testKibanaDashboardOnlyUserRole() {
         RoleDescriptor roleDescriptor = new ReservedRolesStore().roleDescriptor("kibana_dashboard_only_user");
         assertNotNull(roleDescriptor);
         assertThat(roleDescriptor.getMetadata(), hasEntry("_reserved", true));
+        assertThat(roleDescriptor.getMetadata(), hasEntry("_deprecated", true));
 
         Role dashboardsOnlyUserRole = Role.builder(roleDescriptor, null).build();
         assertThat(dashboardsOnlyUserRole.cluster().check(ClusterHealthAction.NAME, request, authentication), is(false));
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStore.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStore.java
index 667b53c1c3328..6ff549cbf957a 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStore.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStore.java
@@ -17,6 +17,7 @@
 import org.elasticsearch.common.cache.Cache;
 import org.elasticsearch.common.cache.CacheBuilder;
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Setting.Property;
 import org.elasticsearch.common.settings.Settings;
@@ -41,6 +42,7 @@
 import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
 import org.elasticsearch.xpack.core.security.authz.store.RoleRetrievalResult;
 import org.elasticsearch.xpack.core.security.support.CacheIteratorHelper;
+import org.elasticsearch.xpack.core.security.support.MetadataUtils;
 import org.elasticsearch.xpack.core.security.user.AnonymousUser;
 import org.elasticsearch.xpack.core.security.user.SystemUser;
 import org.elasticsearch.xpack.core.security.user.User;
@@ -83,6 +85,7 @@ public class CompositeRolesStore {
         Setting.intSetting("xpack.security.authz.store.roles.negative_lookup_cache.max_size", 10000, Property.NodeScope);
     private static final Logger logger = LogManager.getLogger(CompositeRolesStore.class);
 
+    private final DeprecationLogger deprecationLogger = new DeprecationLogger(logger);
 
     private final FileRolesStore fileRolesStore;
     private final NativeRolesStore nativeRolesStore;
@@ -154,6 +157,7 @@ public void roles(Set<String> roleNames, ActionListener<Role> roleActionListener
             final long invalidationCounter = numInvalidation.get();
             roleDescriptors(roleNames, ActionListener.wrap(
                     rolesRetrievalResult -> {
+                        logDeprecatedRoles(rolesRetrievalResult.roleDescriptors);
                         final boolean missingRoles = rolesRetrievalResult.getMissingRoles().isEmpty() == false;
                         if (missingRoles) {
                             logger.debug(() -> new ParameterizedMessage("Could not find roles with names {}",
@@ -179,6 +183,17 @@ public void roles(Set<String> roleNames, ActionListener<Role> roleActionListener
         }
     }
 
+    void logDeprecatedRoles(Set<RoleDescriptor> roleDescriptors) {
+        roleDescriptors.stream()
+            .filter(rd -> Boolean.TRUE.equals(rd.getMetadata().get(MetadataUtils.DEPRECATED_METADATA_KEY)))
+            .forEach(rd -> {
+                String reason = Objects.toString(
+                    rd.getMetadata().get(MetadataUtils.DEPRECATED_REASON_METADATA_KEY), "Please check the documentation");
+                deprecationLogger.deprecatedAndMaybeLog("deprecated_role-" + rd.getName(), "The role [" + rd.getName() +
+                    "] is deprecated and will be removed in a future version of Elasticsearch. " + reason);
+            });
+    }
+
     public void getRoles(User user, Authentication authentication, ActionListener<Role> roleActionListener) {
         // we need to special case the internal users in this method, if we apply the anonymous roles to every user including these system
         // user accounts then we run into the chance of a deadlock because then we need to get a role that we may be trying to get as the
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStoreTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStoreTests.java
index 53c1b816b19d9..4b453c77691b2 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStoreTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/CompositeRolesStoreTests.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.settings.Settings;
@@ -53,6 +54,7 @@
 import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
 import org.elasticsearch.xpack.core.security.authz.store.RoleRetrievalResult;
 import org.elasticsearch.xpack.core.security.index.RestrictedIndicesNames;
+import org.elasticsearch.xpack.core.security.support.MetadataUtils;
 import org.elasticsearch.xpack.core.security.user.AnonymousUser;
 import org.elasticsearch.xpack.core.security.user.SystemUser;
 import org.elasticsearch.xpack.core.security.user.User;
@@ -64,10 +66,14 @@
 
 import java.io.IOException;
 import java.time.Instant;
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
+import java.util.HashMap;
 import java.util.HashSet;
+import java.util.LinkedHashSet;
+import java.util.List;
 import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.ExecutionException;
@@ -84,6 +90,7 @@
 import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasItem;
+import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.nullValue;
 import static org.mockito.Matchers.any;
@@ -143,21 +150,14 @@ public void testRolesWhenDlsFlsUnlicensed() throws IOException {
         }, null);
         FileRolesStore fileRolesStore = mock(FileRolesStore.class);
         doCallRealMethod().when(fileRolesStore).accept(any(Set.class), any(ActionListener.class));
-        ReservedRolesStore reservedRolesStore = mock(ReservedRolesStore.class);
-        doCallRealMethod().when(reservedRolesStore).accept(any(Set.class), any(ActionListener.class));
-        NativeRolesStore nativeRolesStore = mock(NativeRolesStore.class);
-        doCallRealMethod().when(nativeRolesStore).accept(any(Set.class), any(ActionListener.class));
 
         when(fileRolesStore.roleDescriptors(Collections.singleton("fls"))).thenReturn(Collections.singleton(flsRole));
         when(fileRolesStore.roleDescriptors(Collections.singleton("dls"))).thenReturn(Collections.singleton(dlsRole));
         when(fileRolesStore.roleDescriptors(Collections.singleton("fls_dls"))).thenReturn(Collections.singleton(flsDlsRole));
         when(fileRolesStore.roleDescriptors(Collections.singleton("no_fls_dls"))).thenReturn(Collections.singleton(noFlsDlsRole));
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
-        CompositeRolesStore compositeRolesStore = new CompositeRolesStore(Settings.EMPTY, fileRolesStore, nativeRolesStore,
-                reservedRolesStore, mock(NativePrivilegeStore.class), Collections.emptyList(),
-                new ThreadContext(Settings.EMPTY), licenseState, cache, mock(ApiKeyService.class), documentSubsetBitsetCache,
-                rds -> effectiveRoleDescriptors.set(rds));
+        CompositeRolesStore compositeRolesStore = buildCompositeRolesStore(Settings.EMPTY, fileRolesStore, null,
+            null, null, licenseState, null, null, rds -> effectiveRoleDescriptors.set(rds));
 
         PlainActionFuture<Role> roleFuture = new PlainActionFuture<>();
         compositeRolesStore.roles(Collections.singleton("fls"), roleFuture);
@@ -220,20 +220,13 @@ public void testRolesWhenDlsFlsLicensed() throws IOException {
         }, null);
         FileRolesStore fileRolesStore = mock(FileRolesStore.class);
         doCallRealMethod().when(fileRolesStore).accept(any(Set.class), any(ActionListener.class));
-        ReservedRolesStore reservedRolesStore = mock(ReservedRolesStore.class);
-        doCallRealMethod().when(reservedRolesStore).accept(any(Set.class), any(ActionListener.class));
-        NativeRolesStore nativeRolesStore = mock(NativeRolesStore.class);
-        doCallRealMethod().when(nativeRolesStore).accept(any(Set.class), any(ActionListener.class));
         when(fileRolesStore.roleDescriptors(Collections.singleton("fls"))).thenReturn(Collections.singleton(flsRole));
         when(fileRolesStore.roleDescriptors(Collections.singleton("dls"))).thenReturn(Collections.singleton(dlsRole));
         when(fileRolesStore.roleDescriptors(Collections.singleton("fls_dls"))).thenReturn(Collections.singleton(flsDlsRole));
         when(fileRolesStore.roleDescriptors(Collections.singleton("no_fls_dls"))).thenReturn(Collections.singleton(noFlsDlsRole));
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
-        CompositeRolesStore compositeRolesStore = new CompositeRolesStore(Settings.EMPTY, fileRolesStore, nativeRolesStore,
-                reservedRolesStore, mock(NativePrivilegeStore.class), Collections.emptyList(),
-                new ThreadContext(Settings.EMPTY), licenseState, cache, mock(ApiKeyService.class), documentSubsetBitsetCache,
-                rds -> effectiveRoleDescriptors.set(rds));
+        CompositeRolesStore compositeRolesStore = buildCompositeRolesStore(Settings.EMPTY, fileRolesStore, null,
+            null, null, licenseState, null, null, rds -> effectiveRoleDescriptors.set(rds));
 
         PlainActionFuture<Role> roleFuture = new PlainActionFuture<>();
         compositeRolesStore.roles(Collections.singleton("fls"), roleFuture);
@@ -266,6 +259,7 @@ public void testNegativeLookupsAreCached() {
         final NativeRolesStore nativeRolesStore = mock(NativeRolesStore.class);
         doCallRealMethod().when(nativeRolesStore).accept(any(Set.class), any(ActionListener.class));
         when(fileRolesStore.roleDescriptors(anySetOf(String.class))).thenReturn(Collections.emptySet());
+
         doAnswer((invocationOnMock) -> {
             ActionListener<RoleRetrievalResult> callback = (ActionListener<RoleRetrievalResult>) invocationOnMock.getArguments()[1];
             callback.onResponse(RoleRetrievalResult.success(Collections.emptySet()));
@@ -281,12 +275,9 @@ public void testNegativeLookupsAreCached() {
         }).when(nativePrivilegeStore).getPrivileges(isA(Set.class), isA(Set.class), any(ActionListener.class));
 
         final AtomicReference<Collection<RoleDescriptor>> effectiveRoleDescriptors = new AtomicReference<Collection<RoleDescriptor>>();
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
-        final CompositeRolesStore compositeRolesStore =
-                new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
-                        nativePrivilegeStore, Collections.emptyList(), new ThreadContext(SECURITY_ENABLED_SETTINGS),
-                        new XPackLicenseState(SECURITY_ENABLED_SETTINGS), cache, mock(ApiKeyService.class),
-                        documentSubsetBitsetCache, rds -> effectiveRoleDescriptors.set(rds));
+        final CompositeRolesStore compositeRolesStore = buildCompositeRolesStore(SECURITY_ENABLED_SETTINGS,
+            fileRolesStore, nativeRolesStore, reservedRolesStore, nativePrivilegeStore, null, null, null,
+            rds -> effectiveRoleDescriptors.set(rds));
         verify(fileRolesStore).addListener(any(Consumer.class)); // adds a listener in ctor
 
         final String roleName = randomAlphaOfLengthBetween(1, 10);
@@ -322,7 +313,7 @@ public void testNegativeLookupsAreCached() {
         if (getSuperuserRole && numberOfTimesToCall > 0) {
             // the superuser role was requested so we get the role descriptors again
             verify(reservedRolesStore, times(2)).accept(anySetOf(String.class), any(ActionListener.class));
-            verify(nativePrivilegeStore).getPrivileges(isA(Set.class),isA(Set.class), any(ActionListener.class));
+            verify(nativePrivilegeStore).getPrivileges(isA(Set.class), isA(Set.class), any(ActionListener.class));
         }
         verifyNoMoreInteractions(fileRolesStore, reservedRolesStore, nativeRolesStore, nativePrivilegeStore);
     }
@@ -422,9 +413,6 @@ public void testNegativeLookupsAreNotCachedWithFailures() {
         verifyNoMoreInteractions(fileRolesStore, reservedRolesStore, nativeRolesStore);
     }
 
-    private DocumentSubsetBitsetCache buildBitsetCache() {
-        return new DocumentSubsetBitsetCache(Settings.EMPTY, mock(ThreadPool.class));
-    }
 
     public void testCustomRolesProviders() {
         final FileRolesStore fileRolesStore = mock(FileRolesStore.class);
@@ -899,12 +887,9 @@ public void testDefaultRoleUserWithoutRoles() {
         }).when(nativeRolesStore).getRoleDescriptors(isA(Set.class), any(ActionListener.class));
         final ReservedRolesStore reservedRolesStore = spy(new ReservedRolesStore());
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
-        final CompositeRolesStore compositeRolesStore =
-            new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
-                mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(SECURITY_ENABLED_SETTINGS),
-                new XPackLicenseState(SECURITY_ENABLED_SETTINGS), cache, mock(ApiKeyService.class), documentSubsetBitsetCache,
-                rds -> {});
+        final CompositeRolesStore compositeRolesStore = buildCompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore,
+            nativeRolesStore, reservedRolesStore, mock(NativePrivilegeStore.class), null, mock(ApiKeyService.class),
+            null, null);
         verify(fileRolesStore).addListener(any(Consumer.class)); // adds a listener in ctor
 
         PlainActionFuture<Role> rolesFuture = new PlainActionFuture<>();
@@ -940,11 +925,8 @@ public void testAnonymousUserEnabledRoleAdded() {
         }).when(nativeRolesStore).getRoleDescriptors(isA(Set.class), any(ActionListener.class));
         final ReservedRolesStore reservedRolesStore = spy(new ReservedRolesStore());
 
-        final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
-        final CompositeRolesStore compositeRolesStore =
-            new CompositeRolesStore(settings, fileRolesStore, nativeRolesStore, reservedRolesStore,
-                mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(settings),
-                new XPackLicenseState(settings), cache, mock(ApiKeyService.class), documentSubsetBitsetCache, rds -> {});
+        final CompositeRolesStore compositeRolesStore = buildCompositeRolesStore(settings, fileRolesStore, nativeRolesStore,
+            reservedRolesStore, mock(NativePrivilegeStore.class), null, mock(ApiKeyService.class), null, null);
         verify(fileRolesStore).addListener(any(Consumer.class)); // adds a listener in ctor
 
         PlainActionFuture<Role> rolesFuture = new PlainActionFuture<>();
@@ -1124,11 +1106,9 @@ public void testUsageStats() {
 
         final DocumentSubsetBitsetCache documentSubsetBitsetCache = buildBitsetCache();
 
-        final CompositeRolesStore compositeRolesStore =
-            new CompositeRolesStore(SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore,
-                mock(NativePrivilegeStore.class), Collections.emptyList(), new ThreadContext(SECURITY_ENABLED_SETTINGS),
-                new XPackLicenseState(SECURITY_ENABLED_SETTINGS), cache, mock(ApiKeyService.class), documentSubsetBitsetCache, rds -> {
-            });
+        final CompositeRolesStore compositeRolesStore = buildCompositeRolesStore(
+            SECURITY_ENABLED_SETTINGS, fileRolesStore, nativeRolesStore, reservedRolesStore, null, null, mock(ApiKeyService.class),
+            documentSubsetBitsetCache, null);
 
         PlainActionFuture<Map<String, Object>> usageStatsListener = new PlainActionFuture<>();
         compositeRolesStore.usageStats(usageStatsListener);
@@ -1138,6 +1118,111 @@ public void testUsageStats() {
         assertThat(usageStats.get("dls"), is(Map.of("bit_set_cache", documentSubsetBitsetCache.usageStats())));
     }
 
+    public void testLoggingOfDeprecatedRoles() {
+        List<RoleDescriptor> descriptors = new ArrayList<>();
+        Function<Map<String, Object>, RoleDescriptor> newRole = metadata -> new RoleDescriptor(
+            randomAlphaOfLengthBetween(4, 9), generateRandomStringArray(5, 5, false, true),
+            null, null, null, null, metadata, null);
+
+        RoleDescriptor deprecated1 = newRole.apply(MetadataUtils.getDeprecatedReservedMetadata("some reason"));
+        RoleDescriptor deprecated2 = newRole.apply(MetadataUtils.getDeprecatedReservedMetadata("a different reason"));
+
+        // Can't use getDeprecatedReservedMetadata because `Map.of` doesn't accept null values,
+        // so we clone metadata with a real value and then remove that key
+        final Map<String, Object> nullReasonMetadata = new HashMap<>(deprecated2.getMetadata());
+        nullReasonMetadata.remove(MetadataUtils.DEPRECATED_REASON_METADATA_KEY);
+        assertThat(nullReasonMetadata.keySet(), hasSize(deprecated2.getMetadata().size() -1));
+        RoleDescriptor deprecated3 = newRole.apply(nullReasonMetadata);
+
+        descriptors.add(deprecated1);
+        descriptors.add(deprecated2);
+        descriptors.add(deprecated3);
+
+        for (int i = randomIntBetween(2, 10); i > 0; i--) {
+            // the non-deprecated metadata is randomly one of:
+            // {}, {_deprecated:null}, {_deprecated:false},
+            // {_reserved:true}, {_reserved:true,_deprecated:null}, {_reserved:true,_deprecated:false}
+            Map<String, Object> metadata = randomBoolean() ? Map.of() : MetadataUtils.DEFAULT_RESERVED_METADATA;
+            if (randomBoolean()) {
+                metadata = new HashMap<>(metadata);
+                metadata.put(MetadataUtils.DEPRECATED_METADATA_KEY, randomBoolean() ? null : false);
+            }
+            descriptors.add(newRole.apply(metadata));
+        }
+        Collections.shuffle(descriptors, random());
+
+        final CompositeRolesStore compositeRolesStore =
+            buildCompositeRolesStore(SECURITY_ENABLED_SETTINGS, null, null, null, null, null, null, null, null);
+
+        // Use a LHS so that the random-shufle-order of the list is preserved
+        compositeRolesStore.logDeprecatedRoles(new LinkedHashSet<>(descriptors));
+
+        assertWarnings(
+            "The role [" + deprecated1.getName() + "] is deprecated and will be removed in a future version of Elasticsearch." +
+                " some reason",
+            "The role [" + deprecated2.getName() + "] is deprecated and will be removed in a future version of Elasticsearch." +
+                " a different reason",
+            "The role [" + deprecated3.getName() + "] is deprecated and will be removed in a future version of Elasticsearch." +
+                " Please check the documentation"
+        );
+    }
+
+    private CompositeRolesStore buildCompositeRolesStore(Settings settings,
+                                                         @Nullable FileRolesStore fileRolesStore,
+                                                         @Nullable NativeRolesStore nativeRolesStore,
+                                                         @Nullable ReservedRolesStore reservedRolesStore,
+                                                         @Nullable NativePrivilegeStore privilegeStore,
+                                                         @Nullable XPackLicenseState licenseState,
+                                                         @Nullable ApiKeyService apiKeyService,
+                                                         @Nullable DocumentSubsetBitsetCache documentSubsetBitsetCache,
+                                                         @Nullable Consumer<Collection<RoleDescriptor>> roleConsumer) {
+        if (fileRolesStore == null) {
+            fileRolesStore = mock(FileRolesStore.class);
+            doCallRealMethod().when(fileRolesStore).accept(any(Set.class), any(ActionListener.class));
+            when(fileRolesStore.roleDescriptors(anySetOf(String.class))).thenReturn(Collections.emptySet());
+        }
+        if (nativeRolesStore == null) {
+            nativeRolesStore = mock(NativeRolesStore.class);
+            doCallRealMethod().when(nativeRolesStore).accept(any(Set.class), any(ActionListener.class));
+            doAnswer((invocationOnMock) -> {
+                ActionListener<RoleRetrievalResult> callback = (ActionListener<RoleRetrievalResult>) invocationOnMock.getArguments()[1];
+                callback.onResponse(RoleRetrievalResult.failure(new RuntimeException("intentionally failed!")));
+                return null;
+            }).when(nativeRolesStore).getRoleDescriptors(isA(Set.class), any(ActionListener.class));
+        }
+        if (reservedRolesStore == null) {
+            reservedRolesStore = mock(ReservedRolesStore.class);
+            doCallRealMethod().when(reservedRolesStore).accept(any(Set.class), any(ActionListener.class));
+        }
+        if (privilegeStore == null) {
+            privilegeStore = mock(NativePrivilegeStore.class);
+            doAnswer((invocationOnMock) -> {
+                ActionListener<Collection<ApplicationPrivilegeDescriptor>> callback = null;
+                callback = (ActionListener<Collection<ApplicationPrivilegeDescriptor>>) invocationOnMock.getArguments()[2];
+                callback.onResponse(Collections.emptyList());
+                return null;
+            }).when(privilegeStore).getPrivileges(isA(Set.class), isA(Set.class), any(ActionListener.class));
+        }
+        if (licenseState == null) {
+            licenseState = new XPackLicenseState(settings);
+        }
+        if (apiKeyService == null) {
+            apiKeyService = mock(ApiKeyService.class);
+        }
+        if (documentSubsetBitsetCache == null) {
+            documentSubsetBitsetCache = buildBitsetCache();
+        }
+        if (roleConsumer == null) {
+            roleConsumer = rds -> { };
+        }
+        return new CompositeRolesStore(settings, fileRolesStore, nativeRolesStore, reservedRolesStore, privilegeStore,
+            Collections.emptyList(), new ThreadContext(settings), licenseState, cache, apiKeyService, documentSubsetBitsetCache,
+            roleConsumer);
+    }
+
+    private DocumentSubsetBitsetCache buildBitsetCache() {
+        return new DocumentSubsetBitsetCache(Settings.EMPTY, mock(ThreadPool.class));
+    }
     private static class InMemoryRolesProvider implements BiConsumer<Set<String>, ActionListener<RoleRetrievalResult>> {
         private final Function<Set<String>, RoleRetrievalResult> roleDescriptorsFunc;
 
diff --git a/x-pack/qa/oidc-op-tests/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectAuthIT.java b/x-pack/qa/oidc-op-tests/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectAuthIT.java
index 67643af723894..4b0e3afc813ad 100644
--- a/x-pack/qa/oidc-op-tests/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectAuthIT.java
+++ b/x-pack/qa/oidc-op-tests/src/test/java/org/elasticsearch/xpack/security/authc/oidc/OpenIdConnectAuthIT.java
@@ -276,7 +276,7 @@ private void verifyElasticsearchAccessTokenForCodeFlow(String accessToken) throw
         final Map<String, Object> map = callAuthenticateApiUsingAccessToken(accessToken);
         logger.info("Authentication with token Response: " + map);
         assertThat(map.get("username"), equalTo("alice"));
-        assertThat((List<?>) map.get("roles"), containsInAnyOrder("kibana_user", "auditor"));
+        assertThat((List<?>) map.get("roles"), containsInAnyOrder("kibana_admin", "auditor"));
 
         assertThat(map.get("metadata"), instanceOf(Map.class));
         final Map<?, ?> metadata = (Map<?, ?>) map.get("metadata");
@@ -374,7 +374,7 @@ private void setFacilitatorUser() throws IOException {
 
     private void setRoleMappings() throws IOException {
         Request createRoleMappingRequest = new Request("PUT", "/_security/role_mapping/oidc_kibana");
-        createRoleMappingRequest.setJsonEntity("{ \"roles\" : [\"kibana_user\"]," +
+        createRoleMappingRequest.setJsonEntity("{ \"roles\" : [\"kibana_admin\"]," +
             "\"enabled\": true," +
             "\"rules\": {" +
             "\"field\": { \"realm.name\": \"" + REALM_NAME + "\"}" +

From d76283df6558a789413e49bfeefb588f195039fa Mon Sep 17 00:00:00 2001
From: Philip Krauss <35487337+philkra@users.noreply.github.com>
Date: Tue, 14 Jan 2020 09:22:50 +0100
Subject: [PATCH 540/686] Add notice about official Rust client (#50897)

---
 docs/community-clients/index.asciidoc | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/docs/community-clients/index.asciidoc b/docs/community-clients/index.asciidoc
index d931a33a937f7..97e0996712640 100644
--- a/docs/community-clients/index.asciidoc
+++ b/docs/community-clients/index.asciidoc
@@ -41,9 +41,9 @@ a number of clients that have been contributed by the community for various lang
 [[clojure]]
 == Clojure
 
-* https://github.com/mpenet/spandex[Spandex]: 
+* https://github.com/mpenet/spandex[Spandex]:
   Clojure client, based on the new official low level rest-client.
-  
+
 * http://github.com/clojurewerkz/elastisch[Elastisch]:
   Clojure client.
 
@@ -75,7 +75,7 @@ Also see the {client}/go-api/current/index.html[official Elasticsearch Go client
 
 * https://github.com/olivere/elastic[elastic]:
   Elasticsearch client for Google Go.
-  
+
 * https://github.com/softctrl/elk[elk]
   Golang lib for Elasticsearch client.
 
@@ -106,8 +106,8 @@ Also see the {client}/javascript-api/current/index.html[official Elasticsearch J
 
 * https://github.com/mbuhot/eskotlin[ES Kotlin]:
   Elasticsearch Query DSL for kotlin based on the {client}/java-api/current/index.html[official Elasticsearch Java client].
-  
-* https://github.com/jillesvangurp/es-kotlin-wrapper-client[ES Kotlin Wrapper Client]: 
+
+* https://github.com/jillesvangurp/es-kotlin-wrapper-client[ES Kotlin Wrapper Client]:
   Kotlin extension functions and abstractions for the {client}/java-api/current/index.html[official Elasticsearch Highlevel Client]. Aims to reduce the amount of boilerplate needed to do searches, bulk indexing and other common things users do with the client.
 
 [[lua]]
@@ -154,7 +154,7 @@ Also see the {client}/python-api/current/index.html[official Elasticsearch Pytho
 
 * https://github.com/ropensci/elasticdsl[elasticdsl]:
   A high-level R DSL for Elasticsearch, wrapping the elastic R client.
-  
+
 * https://github.com/uptake/uptasticsearch[uptasticsearch]:
   An R client tailored to data science workflows.
 
@@ -178,12 +178,14 @@ Also see the {client}/ruby-api/current/index.html[official Elasticsearch Ruby cl
 [[rust]]
 == Rust
 
+Also see the {client}/rust-api/current/index.html[official Elasticsearch Rust client].
+
 * https://github.com/benashford/rs-es[rs-es]:
   A REST API client with a strongly-typed Query DSL.
 
 * https://github.com/elastic-rs/elastic[elastic]:
   A modular REST API client that supports freeform queries.
-  
+
 [[scala]]
 == Scala
 
@@ -192,7 +194,7 @@ Also see the {client}/ruby-api/current/index.html[official Elasticsearch Ruby cl
 
 * https://github.com/gphat/wabisabi[wabisabi]:
   Asynchronous REST API Scala client.
-  
+
 * https://github.com/workday/escalar[escalar]:
   Type-safe Scala wrapper for the REST API.
 

From 30e9bfbb085ab3d36df841f99002b655ab310aa6 Mon Sep 17 00:00:00 2001
From: Costin Leau <costin.leau@gmail.com>
Date: Tue, 14 Jan 2020 10:34:52 +0200
Subject: [PATCH 541/686] SQL: Fix incomplete registration of geo
 NamedWritables

---
 .../java/org/elasticsearch/xpack/sql/session/Cursors.java     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Cursors.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Cursors.java
index fd7ab2990da16..1141d665e87bf 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Cursors.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/session/Cursors.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
-import org.elasticsearch.xpack.ql.expression.literal.Literals;
 import org.elasticsearch.xpack.ql.util.StringUtils;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 import org.elasticsearch.xpack.sql.common.io.SqlStreamInput;
@@ -20,6 +19,7 @@
 import org.elasticsearch.xpack.sql.execution.search.extractor.SqlBucketExtractors;
 import org.elasticsearch.xpack.sql.execution.search.extractor.SqlHitExtractors;
 import org.elasticsearch.xpack.sql.expression.function.scalar.Processors;
+import org.elasticsearch.xpack.sql.expression.literal.SqlLiterals;
 import org.elasticsearch.xpack.sql.plugin.TextFormatterCursor;
 
 import java.io.IOException;
@@ -57,7 +57,7 @@ public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
         entries.addAll(SqlBucketExtractors.getNamedWriteables());
 
         // and custom types
-        entries.addAll(Literals.getNamedWriteables());
+        entries.addAll(SqlLiterals.getNamedWriteables());
 
         return entries;
     }

From 1e3fdcfced770cc24b27abbe05e65639df0e878c Mon Sep 17 00:00:00 2001
From: Daniel Mitterdorfer <danielmitterdorfer@users.noreply.github.com>
Date: Tue, 14 Jan 2020 12:20:07 +0100
Subject: [PATCH 542/686] Mute
 HttpCertificateCommandTests.testTextFileSubstitutions (#50965)

Relates #50964
---
 .../xpack/security/cli/HttpCertificateCommandTests.java         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
index 891c4257666c1..cb9ec6fe7c5ab 100644
--- a/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
+++ b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
@@ -9,6 +9,7 @@
 import com.google.common.jimfs.Configuration;
 import com.google.common.jimfs.Jimfs;
 import joptsimple.OptionSet;
+import org.apache.lucene.util.Constants;
 import org.bouncycastle.asn1.DERIA5String;
 import org.bouncycastle.asn1.DEROctetString;
 import org.bouncycastle.asn1.DERSequence;
@@ -529,6 +530,7 @@ public void testGuessFileType() throws Exception {
     }
 
     public void testTextFileSubstitutions() throws Exception {
+        assumeFalse("https://github.com/elastic/elasticsearch/issues/50964", Constants.WINDOWS);
         CheckedBiFunction<String, Map<String, String>, String, Exception> copy = (source, subs) -> {
             try (InputStream in = new ByteArrayInputStream(source.getBytes(StandardCharsets.UTF_8));
                  StringWriter out = new StringWriter();

From 8e10736edf31f701c4ea6ab00ade193ba1fa0c80 Mon Sep 17 00:00:00 2001
From: Florian Kelbert <florian.kelbert@elastic.co>
Date: Tue, 14 Jan 2020 11:28:19 +0100
Subject: [PATCH 543/686] [DOCS] Correctly read total hits inside watcher
 config

Relates to #50611 and #50612
---
 x-pack/docs/en/watcher/actions/email.asciidoc     | 2 +-
 x-pack/docs/en/watcher/condition/compare.asciidoc | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/docs/en/watcher/actions/email.asciidoc b/x-pack/docs/en/watcher/actions/email.asciidoc
index adda53b810d15..373904af0669b 100644
--- a/x-pack/docs/en/watcher/actions/email.asciidoc
+++ b/x-pack/docs/en/watcher/actions/email.asciidoc
@@ -31,7 +31,7 @@ the watch payload in the email body:
     "email" : { <2>
       "to" : "username@example.org", <3>
       "subject" : "Watcher Notification", <4>
-      "body" : "{{ctx.payload.hits.total.value}} error logs found" <5>
+      "body" : "{{ctx.payload.hits.total}} error logs found" <5>
     }
   }
 }
diff --git a/x-pack/docs/en/watcher/condition/compare.asciidoc b/x-pack/docs/en/watcher/condition/compare.asciidoc
index f6fd06a11beec..466cbe05ef659 100644
--- a/x-pack/docs/en/watcher/condition/compare.asciidoc
+++ b/x-pack/docs/en/watcher/condition/compare.asciidoc
@@ -44,7 +44,7 @@ condition returns `true` if the number of the total hits in the
 {
   "condition" : {
     "compare" : {
-      "ctx.payload.hits.total.value" : { <1>
+      "ctx.payload.hits.total" : { <1>
         "gte" : 5 <2>
       }
     }

From 9ecbbaf343475d35cb9ea3b3877ff89ff5721af0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Tue, 14 Jan 2020 13:00:25 +0100
Subject: [PATCH 544/686] Handle nested and aliased fields correctly when
 copying mapping. (#50918)

---
 .../ml/integration/ClassificationIT.java      | 86 ++++++++++++++--
 .../ml/dataframe/DataFrameAnalyticsIndex.java | 25 ++++-
 .../DataFrameAnalyticsIndexTests.java         | 98 ++++++++++++++-----
 3 files changed, 175 insertions(+), 34 deletions(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 32d8ad0b79845..d1e49169d75e7 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -63,6 +63,9 @@ public class ClassificationIT extends MlNativeDataFrameAnalyticsIntegTestCase {
     private static final String NUMERICAL_FIELD = "numerical-field";
     private static final String DISCRETE_NUMERICAL_FIELD = "discrete-numerical-field";
     private static final String KEYWORD_FIELD = "keyword-field";
+    private static final String NESTED_FIELD = "outer-field.inner-field";
+    private static final String ALIAS_TO_KEYWORD_FIELD = "alias-to-keyword-field";
+    private static final String ALIAS_TO_NESTED_FIELD = "alias-to-nested-field";
     private static final List<Boolean> BOOLEAN_FIELD_VALUES = Collections.unmodifiableList(Arrays.asList(false, true));
     private static final List<Double> NUMERICAL_FIELD_VALUES = Collections.unmodifiableList(Arrays.asList(1.0, 2.0));
     private static final List<Integer> DISCRETE_NUMERICAL_FIELD_VALUES = Collections.unmodifiableList(Arrays.asList(10, 20));
@@ -301,7 +304,6 @@ public void testStopAndRestart() throws Exception {
         assertInferenceModelPersisted(jobId);
         assertMlResultsFieldMappings(predictedClassField, "keyword");
         assertEvaluation(KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml." + predictedClassField);
-
     }
 
     public void testDependentVariableCardinalityTooHighError() throws Exception {
@@ -343,6 +345,63 @@ public void testDependentVariableCardinalityTooHighButWithQueryMakesItWithinRang
         assertProgress(jobId, 100, 100, 100, 100);
     }
 
+    public void testDependentVariableIsNested() throws Exception {
+        initialize("dependent_variable_is_nested");
+        String predictedClassField = NESTED_FIELD + "_prediction";
+        indexData(sourceIndex, 100, 0, NESTED_FIELD);
+
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(NESTED_FIELD));
+        registerAnalytics(config);
+        putAnalytics(config);
+        startAnalytics(jobId);
+        waitUntilAnalyticsIsStopped(jobId);
+
+        assertProgress(jobId, 100, 100, 100, 100);
+        assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
+        assertInferenceModelPersisted(jobId);
+        assertMlResultsFieldMappings(predictedClassField, "keyword");
+        assertEvaluation(NESTED_FIELD, KEYWORD_FIELD_VALUES, "ml." + predictedClassField);
+    }
+
+    public void testDependentVariableIsAliasToKeyword() throws Exception {
+        initialize("dependent_variable_is_alias");
+        String predictedClassField = ALIAS_TO_KEYWORD_FIELD + "_prediction";
+        indexData(sourceIndex, 100, 0, KEYWORD_FIELD);
+
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(ALIAS_TO_KEYWORD_FIELD));
+        registerAnalytics(config);
+        putAnalytics(config);
+        startAnalytics(jobId);
+        waitUntilAnalyticsIsStopped(jobId);
+
+        assertProgress(jobId, 100, 100, 100, 100);
+        assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
+        assertInferenceModelPersisted(jobId);
+        assertMlResultsFieldMappings(predictedClassField, "keyword");
+        assertEvaluation(ALIAS_TO_KEYWORD_FIELD, KEYWORD_FIELD_VALUES, "ml." + predictedClassField);
+    }
+
+    public void testDependentVariableIsAliasToNested() throws Exception {
+        initialize("dependent_variable_is_alias_to_nested");
+        String predictedClassField = ALIAS_TO_NESTED_FIELD + "_prediction";
+        indexData(sourceIndex, 100, 0, NESTED_FIELD);
+
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(ALIAS_TO_NESTED_FIELD));
+        registerAnalytics(config);
+        putAnalytics(config);
+        startAnalytics(jobId);
+        waitUntilAnalyticsIsStopped(jobId);
+
+        assertProgress(jobId, 100, 100, 100, 100);
+        assertThat(searchStoredProgress(jobId).getHits().getTotalHits().value, equalTo(1L));
+        assertModelStatePersisted(stateDocId());
+        assertInferenceModelPersisted(jobId);
+        assertMlResultsFieldMappings(predictedClassField, "keyword");
+        assertEvaluation(ALIAS_TO_NESTED_FIELD, KEYWORD_FIELD_VALUES, "ml." + predictedClassField);
+    }
+
     public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exception {
         String sourceIndex = "classification_two_jobs_with_same_randomize_seed_source";
         String dependentVariable = KEYWORD_FIELD;
@@ -434,7 +493,10 @@ private static void createIndex(String index) {
                 BOOLEAN_FIELD, "type=boolean",
                 NUMERICAL_FIELD, "type=double",
                 DISCRETE_NUMERICAL_FIELD, "type=integer",
-                KEYWORD_FIELD, "type=keyword")
+                KEYWORD_FIELD, "type=keyword",
+                NESTED_FIELD, "type=keyword",
+                ALIAS_TO_KEYWORD_FIELD, "type=alias,path=" + KEYWORD_FIELD,
+                ALIAS_TO_NESTED_FIELD, "type=alias,path=" + NESTED_FIELD)
             .get();
     }
 
@@ -446,7 +508,8 @@ private static void indexData(String sourceIndex, int numTrainingRows, int numNo
                 BOOLEAN_FIELD, BOOLEAN_FIELD_VALUES.get(i % BOOLEAN_FIELD_VALUES.size()),
                 NUMERICAL_FIELD, NUMERICAL_FIELD_VALUES.get(i % NUMERICAL_FIELD_VALUES.size()),
                 DISCRETE_NUMERICAL_FIELD, DISCRETE_NUMERICAL_FIELD_VALUES.get(i % DISCRETE_NUMERICAL_FIELD_VALUES.size()),
-                KEYWORD_FIELD, KEYWORD_FIELD_VALUES.get(i % KEYWORD_FIELD_VALUES.size()));
+                KEYWORD_FIELD, KEYWORD_FIELD_VALUES.get(i % KEYWORD_FIELD_VALUES.size()),
+                NESTED_FIELD, KEYWORD_FIELD_VALUES.get(i % KEYWORD_FIELD_VALUES.size()));
             IndexRequest indexRequest = new IndexRequest(sourceIndex).source(source.toArray());
             bulkRequestBuilder.add(indexRequest);
         }
@@ -465,6 +528,9 @@ private static void indexData(String sourceIndex, int numTrainingRows, int numNo
             if (KEYWORD_FIELD.equals(dependentVariable) == false) {
                 source.addAll(List.of(KEYWORD_FIELD, KEYWORD_FIELD_VALUES.get(i % KEYWORD_FIELD_VALUES.size())));
             }
+            if (NESTED_FIELD.equals(dependentVariable) == false) {
+                source.addAll(List.of(NESTED_FIELD, KEYWORD_FIELD_VALUES.get(i % KEYWORD_FIELD_VALUES.size())));
+            }
             IndexRequest indexRequest = new IndexRequest(sourceIndex).source(source.toArray());
             bulkRequestBuilder.add(indexRequest);
         }
@@ -487,10 +553,12 @@ private static Map<String, Object> getDestDoc(DataFrameAnalyticsConfig config, S
     }
 
     /**
-     * Wrapper around extractValue with implicit casting to the appropriate type.
+     * Wrapper around extractValue that:
+     * - allows dots (".") in the path elements provided as arguments
+     * - supports implicit casting to the appropriate type
      */
     private static <T> T getFieldValue(Map<String, Object> doc, String... path) {
-        return (T)extractValue(doc, path);
+        return (T)extractValue(String.join(".", path), doc);
     }
 
     private static <T> void assertTopClasses(Map<String, Object> resultsObject,
@@ -582,8 +650,14 @@ private void assertMlResultsFieldMappings(String predictedClassField, String exp
                 .mappings()
                 .get(destIndex)
                 .sourceAsMap();
-        assertThat(getFieldValue(mappings, "properties", "ml", "properties", predictedClassField, "type"), equalTo(expectedType));
         assertThat(
+            mappings.toString(),
+            getFieldValue(
+                mappings,
+                "properties", "ml", "properties", String.join(".properties.", predictedClassField.split("\\.")), "type"),
+            equalTo(expectedType));
+        assertThat(
+            mappings.toString(),
             getFieldValue(mappings, "properties", "ml", "properties", "top_classes", "properties", "class_name", "type"),
             equalTo(expectedType));
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
index 47ecb0ec2b6b8..ec3e192ab4ceb 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndex.java
@@ -24,6 +24,8 @@
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.IndexSortConfig;
+import org.elasticsearch.index.mapper.FieldAliasMapper;
+import org.elasticsearch.index.mapper.KeywordFieldMapper;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
@@ -38,6 +40,7 @@
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Supplier;
 
+import static org.elasticsearch.common.xcontent.support.XContentMapValues.extractValue;
 import static org.elasticsearch.xpack.core.ClientHelper.ML_ORIGIN;
 
 /**
@@ -155,21 +158,36 @@ private static Integer findMaxSettingValue(GetSettingsResponse settingsResponse,
         return maxValue;
     }
 
+    @SuppressWarnings("unchecked")
     private static Map<String, Object> createAdditionalMappings(DataFrameAnalyticsConfig config, Map<String, Object> mappingsProperties) {
         Map<String, Object> properties = new HashMap<>();
-        properties.put(ID_COPY, Map.of("type", "keyword"));
+        properties.put(ID_COPY, Map.of("type", KeywordFieldMapper.CONTENT_TYPE));
         for (Map.Entry<String, String> entry
                 : config.getAnalysis().getExplicitlyMappedFields(config.getDest().getResultsField()).entrySet()) {
             String destFieldPath = entry.getKey();
             String sourceFieldPath = entry.getValue();
-            Object sourceFieldMapping = mappingsProperties.get(sourceFieldPath);
-            if (sourceFieldMapping != null) {
+            Object sourceFieldMapping = extractMapping(sourceFieldPath, mappingsProperties);
+            if (sourceFieldMapping instanceof Map) {
+                Map<String, Object> sourceFieldMappingAsMap = (Map) sourceFieldMapping;
+                // If the source field is an alias, fetch the concrete field that the alias points to.
+                if (FieldAliasMapper.CONTENT_TYPE.equals(sourceFieldMappingAsMap.get("type"))) {
+                    String path = (String) sourceFieldMappingAsMap.get(FieldAliasMapper.Names.PATH);
+                    sourceFieldMapping = extractMapping(path, mappingsProperties);
+                }
+            }
+            // We may have updated the value of {@code sourceFieldMapping} in the "if" block above.
+            // Hence, we need to check the "instanceof" condition again.
+            if (sourceFieldMapping instanceof Map) {
                 properties.put(destFieldPath, sourceFieldMapping);
             }
         }
         return properties;
     }
 
+    private static Object extractMapping(String path, Map<String, Object> mappingsProperties) {
+        return extractValue(String.join("." + PROPERTIES + ".", path.split("\\.")), mappingsProperties);
+    }
+
     private static Map<String, Object> createMetaData(String analyticsId, Clock clock) {
         Map<String, Object> metadata = new HashMap<>();
         metadata.put(CREATION_DATE_MILLIS, clock.millis());
@@ -227,4 +245,3 @@ private static void checkResultsFieldIsNotPresentInProperties(DataFrameAnalytics
         }
     }
 }
-
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
index 7cd00f68e4b8f..a4a9bfffab818 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsIndexTests.java
@@ -71,7 +71,11 @@ public class DataFrameAnalyticsIndexTests extends ESTestCase {
     private static final String ANALYTICS_ID = "some-analytics-id";
     private static final String[] SOURCE_INDEX = new String[] {"source-index"};
     private static final String DEST_INDEX = "dest-index";
-    private static final String DEPENDENT_VARIABLE = "dep_var";
+    private static final String NUMERICAL_FIELD = "numerical-field";
+    private static final String OUTER_FIELD = "outer-field";
+    private static final String INNER_FIELD = "inner-field";
+    private static final String ALIAS_TO_NUMERICAL_FIELD = "alias-to-numerical-field";
+    private static final String ALIAS_TO_NESTED_FIELD = "alias-to-nested-field";
     private static final int CURRENT_TIME_MILLIS = 123456789;
     private static final String CREATED_BY = "data-frame-analytics";
 
@@ -116,17 +120,18 @@ private Map<String, Object> testCreateDestinationIndex(DataFrameAnalysis analysi
         doAnswer(callListenerOnResponse(getSettingsResponse))
             .when(client).execute(eq(GetSettingsAction.INSTANCE), getSettingsRequestCaptor.capture(), any());
 
-        Map<String, Object> index1Mappings =
+        Map<String, Object> indexMappings =
             Map.of(
                 "properties",
-                Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings", DEPENDENT_VARIABLE, Map.of("type", "integer")));
-        MappingMetaData index1MappingMetaData = new MappingMetaData("_doc", index1Mappings);
-
-        Map<String, Object> index2Mappings =
-            Map.of(
-                "properties",
-                Map.of("field_1", "field_1_mappings", "field_2", "field_2_mappings", DEPENDENT_VARIABLE, Map.of("type", "integer")));
-        MappingMetaData index2MappingMetaData = new MappingMetaData("_doc", index2Mappings);
+                Map.of(
+                    "field_1", "field_1_mappings",
+                    "field_2", "field_2_mappings",
+                    NUMERICAL_FIELD, Map.of("type", "integer"),
+                    OUTER_FIELD, Map.of("properties", Map.of(INNER_FIELD, Map.of("type", "integer"))),
+                    ALIAS_TO_NUMERICAL_FIELD, Map.of("type", "alias", "path", NUMERICAL_FIELD),
+                    ALIAS_TO_NESTED_FIELD, Map.of("type", "alias", "path", "outer-field.inner-field")));
+        MappingMetaData index1MappingMetaData = new MappingMetaData("_doc", indexMappings);
+        MappingMetaData index2MappingMetaData = new MappingMetaData("_doc", indexMappings);
 
         ImmutableOpenMap.Builder<String, MappingMetaData> mappings = ImmutableOpenMap.builder();
         mappings.put("index_1", index1MappingMetaData);
@@ -143,7 +148,9 @@ private Map<String, Object> testCreateDestinationIndex(DataFrameAnalysis analysi
             config,
             ActionListener.wrap(
                 response -> {},
-                e -> fail(e.getMessage())));
+                e -> fail(e.getMessage())
+            )
+        );
 
         GetSettingsRequest capturedGetSettingsRequest = getSettingsRequestCaptor.getValue();
         assertThat(capturedGetSettingsRequest.indices(), equalTo(SOURCE_INDEX));
@@ -166,6 +173,10 @@ private Map<String, Object> testCreateDestinationIndex(DataFrameAnalysis analysi
             assertThat(extractValue("_doc.properties.ml__id_copy.type", map), equalTo("keyword"));
             assertThat(extractValue("_doc.properties.field_1", map), equalTo("field_1_mappings"));
             assertThat(extractValue("_doc.properties.field_2", map), equalTo("field_2_mappings"));
+            assertThat(extractValue("_doc.properties.numerical-field.type", map), equalTo("integer"));
+            assertThat(extractValue("_doc.properties.outer-field.properties.inner-field.type", map), equalTo("integer"));
+            assertThat(extractValue("_doc.properties.alias-to-numerical-field.type", map), equalTo("alias"));
+            assertThat(extractValue("_doc.properties.alias-to-nested-field.type", map), equalTo("alias"));
             assertThat(extractValue("_doc._meta.analytics", map), equalTo(ANALYTICS_ID));
             assertThat(extractValue("_doc._meta.creation_date_in_millis", map), equalTo(CURRENT_TIME_MILLIS));
             assertThat(extractValue("_doc._meta.created_by", map), equalTo(CREATED_BY));
@@ -178,13 +189,31 @@ public void testCreateDestinationIndex_OutlierDetection() throws IOException {
     }
 
     public void testCreateDestinationIndex_Regression() throws IOException {
-        Map<String, Object> map = testCreateDestinationIndex(new Regression(DEPENDENT_VARIABLE));
-        assertThat(extractValue("_doc.properties.ml.dep_var_prediction.type", map), equalTo("integer"));
+        Map<String, Object> map = testCreateDestinationIndex(new Regression(NUMERICAL_FIELD));
+        assertThat(extractValue("_doc.properties.ml.numerical-field_prediction.type", map), equalTo("integer"));
     }
 
     public void testCreateDestinationIndex_Classification() throws IOException {
-        Map<String, Object> map = testCreateDestinationIndex(new Classification(DEPENDENT_VARIABLE));
-        assertThat(extractValue("_doc.properties.ml.dep_var_prediction.type", map), equalTo("integer"));
+        Map<String, Object> map = testCreateDestinationIndex(new Classification(NUMERICAL_FIELD));
+        assertThat(extractValue("_doc.properties.ml.numerical-field_prediction.type", map), equalTo("integer"));
+        assertThat(extractValue("_doc.properties.ml.top_classes.class_name.type", map), equalTo("integer"));
+    }
+
+    public void testCreateDestinationIndex_Classification_DependentVariableIsNested() throws IOException {
+        Map<String, Object> map = testCreateDestinationIndex(new Classification(OUTER_FIELD + "." + INNER_FIELD));
+        assertThat(extractValue("_doc.properties.ml.outer-field.inner-field_prediction.type", map), equalTo("integer"));
+        assertThat(extractValue("_doc.properties.ml.top_classes.class_name.type", map), equalTo("integer"));
+    }
+
+    public void testCreateDestinationIndex_Classification_DependentVariableIsAlias() throws IOException {
+        Map<String, Object> map = testCreateDestinationIndex(new Classification(ALIAS_TO_NUMERICAL_FIELD));
+        assertThat(extractValue("_doc.properties.ml.alias-to-numerical-field_prediction.type", map), equalTo("integer"));
+        assertThat(extractValue("_doc.properties.ml.top_classes.class_name.type", map), equalTo("integer"));
+    }
+
+    public void testCreateDestinationIndex_Classification_DependentVariableIsAliasToNested() throws IOException {
+        Map<String, Object> map = testCreateDestinationIndex(new Classification(ALIAS_TO_NESTED_FIELD));
+        assertThat(extractValue("_doc.properties.ml.alias-to-nested-field_prediction.type", map), equalTo("integer"));
         assertThat(extractValue("_doc.properties.ml.top_classes.class_name.type", map), equalTo("integer"));
     }
 
@@ -213,10 +242,15 @@ public void testCreateDestinationIndex_ResultsFieldsExistsInSourceIndex() {
         );
     }
 
-    private Map<String, Object> testUpdateMappingsToDestIndex(DataFrameAnalysis analysis,
-                                                              Map<String, Object> properties) throws IOException {
+    private Map<String, Object> testUpdateMappingsToDestIndex(DataFrameAnalysis analysis) throws IOException {
         DataFrameAnalyticsConfig config = createConfig(analysis);
 
+        Map<String, Object> properties = Map.of(
+            NUMERICAL_FIELD, Map.of("type", "integer"),
+            OUTER_FIELD, Map.of("properties", Map.of(INNER_FIELD, Map.of("type", "integer"))),
+            ALIAS_TO_NUMERICAL_FIELD, Map.of("type", "alias", "path", NUMERICAL_FIELD),
+            ALIAS_TO_NESTED_FIELD, Map.of("type", "alias", "path", OUTER_FIELD + "." + INNER_FIELD)
+        );
         ImmutableOpenMap.Builder<String, MappingMetaData> mappings = ImmutableOpenMap.builder();
         mappings.put("", new MappingMetaData("_doc", Map.of("properties", properties)));
         GetIndexResponse getIndexResponse =
@@ -252,19 +286,35 @@ private Map<String, Object> testUpdateMappingsToDestIndex(DataFrameAnalysis anal
     }
 
     public void testUpdateMappingsToDestIndex_OutlierDetection() throws IOException {
-        testUpdateMappingsToDestIndex(new OutlierDetection.Builder().build(), Map.of(DEPENDENT_VARIABLE, Map.of("type", "integer")));
+        testUpdateMappingsToDestIndex(new OutlierDetection.Builder().build());
     }
 
     public void testUpdateMappingsToDestIndex_Regression() throws IOException {
-        Map<String, Object> map =
-            testUpdateMappingsToDestIndex(new Regression(DEPENDENT_VARIABLE), Map.of(DEPENDENT_VARIABLE, Map.of("type", "integer")));
-        assertThat(extractValue("properties.ml.dep_var_prediction.type", map), equalTo("integer"));
+        Map<String, Object> map = testUpdateMappingsToDestIndex(new Regression(NUMERICAL_FIELD));
+        assertThat(extractValue("properties.ml.numerical-field_prediction.type", map), equalTo("integer"));
     }
 
     public void testUpdateMappingsToDestIndex_Classification() throws IOException {
-        Map<String, Object> map =
-            testUpdateMappingsToDestIndex(new Classification(DEPENDENT_VARIABLE), Map.of(DEPENDENT_VARIABLE, Map.of("type", "integer")));
-        assertThat(extractValue("properties.ml.dep_var_prediction.type", map), equalTo("integer"));
+        Map<String, Object> map = testUpdateMappingsToDestIndex(new Classification(NUMERICAL_FIELD));
+        assertThat(extractValue("properties.ml.numerical-field_prediction.type", map), equalTo("integer"));
+        assertThat(extractValue("properties.ml.top_classes.class_name.type", map), equalTo("integer"));
+    }
+
+    public void testUpdateMappingsToDestIndex_Classification_DependentVariableIsNested() throws IOException {
+        Map<String, Object> map = testUpdateMappingsToDestIndex(new Classification(OUTER_FIELD + "." + INNER_FIELD));
+        assertThat(extractValue("properties.ml.outer-field.inner-field_prediction.type", map), equalTo("integer"));
+        assertThat(extractValue("properties.ml.top_classes.class_name.type", map), equalTo("integer"));
+    }
+
+    public void testUpdateMappingsToDestIndex_Classification_DependentVariableIsAlias() throws IOException {
+        Map<String, Object> map = testUpdateMappingsToDestIndex(new Classification(ALIAS_TO_NUMERICAL_FIELD));
+        assertThat(extractValue("properties.ml.alias-to-numerical-field_prediction.type", map), equalTo("integer"));
+        assertThat(extractValue("properties.ml.top_classes.class_name.type", map), equalTo("integer"));
+    }
+
+    public void testUpdateMappingsToDestIndex_Classification_DependentVariableIsAliasToNested() throws IOException {
+        Map<String, Object> map = testUpdateMappingsToDestIndex(new Classification(ALIAS_TO_NESTED_FIELD));
+        assertThat(extractValue("properties.ml.alias-to-nested-field_prediction.type", map), equalTo("integer"));
         assertThat(extractValue("properties.ml.top_classes.class_name.type", map), equalTo("integer"));
     }
 

From dfd6a20b231512c1330e8270ff5ce1a0060d1499 Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Tue, 14 Jan 2020 13:21:52 +0100
Subject: [PATCH 545/686] [Transform] correctly retrieve checkpoints from
 remote indices (#50903)

uses remote client(s) to correctly retrieve index checkpoints from remote clusters
---
 .../xpack/transform/Transform.java            |  8 +-
 .../checkpoint/DefaultCheckpointProvider.java | 79 ++++++++++++++++---
 .../checkpoint/RemoteClusterResolver.java     | 69 ++++++++++++++++
 .../TimeBasedCheckpointProvider.java          |  3 +-
 .../TransformCheckpointService.java           | 17 +++-
 .../DefaultCheckpointProviderTests.java       |  5 ++
 .../TransformCheckpointServiceNodeTests.java  | 11 ++-
 .../TransformsCheckpointServiceTests.java     | 40 ++++++----
 ...TransformPersistentTasksExecutorTests.java |  2 +
 .../transforms/TransformTaskTests.java        | 12 ++-
 10 files changed, 211 insertions(+), 35 deletions(-)
 create mode 100644 x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/RemoteClusterResolver.java

diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/Transform.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/Transform.java
index b7d57595b232a..2f9bae329a813 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/Transform.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/Transform.java
@@ -244,7 +244,13 @@ public Collection<Object> createComponents(
 
         TransformConfigManager configManager = new IndexBasedTransformConfigManager(client, xContentRegistry);
         TransformAuditor auditor = new TransformAuditor(client, clusterService.getNodeName());
-        TransformCheckpointService checkpointService = new TransformCheckpointService(client, configManager, auditor);
+        TransformCheckpointService checkpointService = new TransformCheckpointService(
+            client,
+            settings,
+            clusterService,
+            configManager,
+            auditor
+        );
         SchedulerEngine scheduler = new SchedulerEngine(settings, Clock.systemUTC());
 
         transformServices.set(new TransformServices(configManager, checkpointService, auditor, scheduler));
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProvider.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProvider.java
index a7bda6886fd58..63205fd44cae9 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProvider.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProvider.java
@@ -16,9 +16,11 @@
 import org.elasticsearch.action.admin.indices.stats.IndicesStatsAction;
 import org.elasticsearch.action.admin.indices.stats.IndicesStatsRequest;
 import org.elasticsearch.action.admin.indices.stats.ShardStats;
+import org.elasticsearch.action.support.GroupedActionListener;
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.util.set.Sets;
+import org.elasticsearch.transport.RemoteClusterService;
 import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpoint;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo;
@@ -26,16 +28,20 @@
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
 import org.elasticsearch.xpack.core.transform.transforms.TransformIndexerPosition;
 import org.elasticsearch.xpack.core.transform.transforms.TransformProgress;
+import org.elasticsearch.xpack.transform.checkpoint.RemoteClusterResolver.ResolvedIndices;
 import org.elasticsearch.xpack.transform.notifications.TransformAuditor;
 import org.elasticsearch.xpack.transform.persistence.TransformConfigManager;
 
 import java.time.Instant;
 import java.util.Arrays;
+import java.util.Collection;
 import java.util.Collections;
 import java.util.HashSet;
+import java.util.List;
 import java.util.Map;
 import java.util.Set;
 import java.util.TreeMap;
+import java.util.stream.Collectors;
 
 public class DefaultCheckpointProvider implements CheckpointProvider {
 
@@ -45,17 +51,20 @@ public class DefaultCheckpointProvider implements CheckpointProvider {
     private static final Logger logger = LogManager.getLogger(DefaultCheckpointProvider.class);
 
     protected final Client client;
+    protected final RemoteClusterResolver remoteClusterResolver;
     protected final TransformConfigManager transformConfigManager;
     protected final TransformAuditor transformAuditor;
     protected final TransformConfig transformConfig;
 
     public DefaultCheckpointProvider(
         final Client client,
+        final RemoteClusterResolver remoteClusterResolver,
         final TransformConfigManager transformConfigManager,
         final TransformAuditor transformAuditor,
         final TransformConfig transformConfig
     ) {
         this.client = client;
+        this.remoteClusterResolver = remoteClusterResolver;
         this.transformConfigManager = transformConfigManager;
         this.transformAuditor = transformAuditor;
         this.transformConfig = transformConfig;
@@ -84,13 +93,61 @@ public void createNextCheckpoint(final TransformCheckpoint lastCheckpoint, final
     }
 
     protected void getIndexCheckpoints(ActionListener<Map<String, long[]>> listener) {
+        try {
+            ResolvedIndices resolvedIndexes = remoteClusterResolver.resolve(transformConfig.getSource().getIndex());
+            ActionListener<Map<String, long[]>> groupedListener = listener;
+
+            if (resolvedIndexes.numClusters() > 1) {
+                ActionListener<Collection<Map<String, long[]>>> mergeMapsListener = ActionListener.wrap(indexCheckpoints -> {
+                    listener.onResponse(
+                        indexCheckpoints.stream()
+                            .flatMap(m -> m.entrySet().stream())
+                            .collect(Collectors.toMap(entry -> entry.getKey(), entry -> entry.getValue()))
+                    );
+                }, listener::onFailure);
+
+                groupedListener = new GroupedActionListener<>(mergeMapsListener, resolvedIndexes.numClusters());
+            }
+
+            if (resolvedIndexes.getLocalIndices().isEmpty() == false) {
+                getCheckpointsFromOneCluster(
+                    client,
+                    transformConfig.getHeaders(),
+                    resolvedIndexes.getLocalIndices().toArray(new String[0]),
+                    RemoteClusterService.LOCAL_CLUSTER_GROUP_KEY,
+                    groupedListener
+                );
+            }
+
+            for (Map.Entry<String, List<String>> remoteIndex : resolvedIndexes.getRemoteIndicesPerClusterAlias().entrySet()) {
+                Client remoteClient = client.getRemoteClusterClient(remoteIndex.getKey());
+                getCheckpointsFromOneCluster(
+                    remoteClient,
+                    transformConfig.getHeaders(),
+                    remoteIndex.getValue().toArray(new String[0]),
+                    remoteIndex.getKey() + RemoteClusterService.REMOTE_CLUSTER_INDEX_SEPARATOR,
+                    groupedListener
+                );
+            }
+        } catch (Exception e) {
+            listener.onFailure(e);
+        }
+    }
+
+    private static void getCheckpointsFromOneCluster(
+        Client client,
+        Map<String, String> headers,
+        String[] indices,
+        String prefix,
+        ActionListener<Map<String, long[]>> listener
+    ) {
         // 1st get index to see the indexes the user has access to
-        GetIndexRequest getIndexRequest = new GetIndexRequest().indices(transformConfig.getSource().getIndex())
+        GetIndexRequest getIndexRequest = new GetIndexRequest().indices(indices)
             .features(new GetIndexRequest.Feature[0])
             .indicesOptions(IndicesOptions.LENIENT_EXPAND_OPEN);
 
         ClientHelper.executeWithHeadersAsync(
-            transformConfig.getHeaders(),
+            headers,
             ClientHelper.TRANSFORM_ORIGIN,
             client,
             GetIndexAction.INSTANCE,
@@ -104,23 +161,20 @@ protected void getIndexCheckpoints(ActionListener<Map<String, long[]>> listener)
                     client,
                     ClientHelper.TRANSFORM_ORIGIN,
                     IndicesStatsAction.INSTANCE,
-                    new IndicesStatsRequest().indices(transformConfig.getSource().getIndex())
-                        .clear()
-                        .indicesOptions(IndicesOptions.LENIENT_EXPAND_OPEN),
+                    new IndicesStatsRequest().indices(indices).clear().indicesOptions(IndicesOptions.LENIENT_EXPAND_OPEN),
                     ActionListener.wrap(response -> {
                         if (response.getFailedShards() != 0) {
                             listener.onFailure(new CheckpointException("Source has [" + response.getFailedShards() + "] failed shards"));
                             return;
                         }
-
-                        listener.onResponse(extractIndexCheckPoints(response.getShards(), userIndices));
+                        listener.onResponse(extractIndexCheckPoints(response.getShards(), userIndices, prefix));
                     }, e -> listener.onFailure(new CheckpointException("Failed to create checkpoint", e)))
                 );
             }, e -> listener.onFailure(new CheckpointException("Failed to create checkpoint", e)))
         );
     }
 
-    static Map<String, long[]> extractIndexCheckPoints(ShardStats[] shards, Set<String> userIndices) {
+    static Map<String, long[]> extractIndexCheckPoints(ShardStats[] shards, Set<String> userIndices, String prefix) {
         Map<String, TreeMap<Integer, Long>> checkpointsByIndex = new TreeMap<>();
 
         for (ShardStats shard : shards) {
@@ -129,9 +183,10 @@ static Map<String, long[]> extractIndexCheckPoints(ShardStats[] shards, Set<Stri
             if (userIndices.contains(indexName)) {
                 // SeqNoStats could be `null`, assume the global checkpoint to be -1 in this case
                 long globalCheckpoint = shard.getSeqNoStats() == null ? -1L : shard.getSeqNoStats().getGlobalCheckpoint();
-                if (checkpointsByIndex.containsKey(indexName)) {
+                String fullIndexName = prefix + indexName;
+                if (checkpointsByIndex.containsKey(fullIndexName)) {
                     // we have already seen this index, just check/add shards
-                    TreeMap<Integer, Long> checkpoints = checkpointsByIndex.get(indexName);
+                    TreeMap<Integer, Long> checkpoints = checkpointsByIndex.get(fullIndexName);
                     // 1st time we see this shard for this index, add the entry for the shard
                     // or there is already a checkpoint entry for this index/shard combination
                     // but with a higher global checkpoint. This is by design(not a problem) and
@@ -142,8 +197,8 @@ static Map<String, long[]> extractIndexCheckPoints(ShardStats[] shards, Set<Stri
                     }
                 } else {
                     // 1st time we see this index, create an entry for the index and add the shard checkpoint
-                    checkpointsByIndex.put(indexName, new TreeMap<>());
-                    checkpointsByIndex.get(indexName).put(shard.getShardRouting().getId(), globalCheckpoint);
+                    checkpointsByIndex.put(fullIndexName, new TreeMap<>());
+                    checkpointsByIndex.get(fullIndexName).put(shard.getShardRouting().getId(), globalCheckpoint);
                 }
             }
         }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/RemoteClusterResolver.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/RemoteClusterResolver.java
new file mode 100644
index 0000000000000..34cc3d95f47af
--- /dev/null
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/RemoteClusterResolver.java
@@ -0,0 +1,69 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.transform.checkpoint;
+
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.transport.RemoteClusterAware;
+import org.elasticsearch.transport.RemoteConnectionStrategy;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.CopyOnWriteArraySet;
+
+/**
+ * Maintain a list of remote clusters (aliases) and provide the ability to resolve.
+ */
+class RemoteClusterResolver extends RemoteClusterAware {
+
+    private final CopyOnWriteArraySet<String> clusters;
+
+    class ResolvedIndices {
+        private final Map<String, List<String>> remoteIndicesPerClusterAlias;
+        private final List<String> localIndices;
+
+        ResolvedIndices(Map<String, List<String>> remoteIndicesPerClusterAlias, List<String> localIndices) {
+            this.localIndices = localIndices;
+            this.remoteIndicesPerClusterAlias = remoteIndicesPerClusterAlias;
+        }
+
+        public Map<String, List<String>> getRemoteIndicesPerClusterAlias() {
+            return remoteIndicesPerClusterAlias;
+        }
+
+        public List<String> getLocalIndices() {
+            return localIndices;
+        }
+
+        public int numClusters() {
+            return remoteIndicesPerClusterAlias.size() + (localIndices.isEmpty() ? 0 : 1);
+        }
+    }
+
+    RemoteClusterResolver(Settings settings, ClusterSettings clusterSettings) {
+        super(settings);
+        clusters = new CopyOnWriteArraySet<>(getEnabledRemoteClusters(settings));
+        listenForUpdates(clusterSettings);
+    }
+
+    @Override
+    protected void updateRemoteCluster(String clusterAlias, Settings settings) {
+        if (RemoteConnectionStrategy.isConnectionEnabled(clusterAlias, settings)) {
+            clusters.add(clusterAlias);
+        } else {
+            clusters.remove(clusterAlias);
+        }
+    }
+
+    ResolvedIndices resolve(String... indices) {
+        Map<String, List<String>> resolvedClusterIndices = groupClusterIndices(clusters, indices);
+        List<String> localIndices = resolvedClusterIndices.getOrDefault(LOCAL_CLUSTER_GROUP_KEY, Collections.emptyList());
+        resolvedClusterIndices.remove(LOCAL_CLUSTER_GROUP_KEY);
+        return new ResolvedIndices(resolvedClusterIndices, localIndices);
+    }
+}
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TimeBasedCheckpointProvider.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TimeBasedCheckpointProvider.java
index 96f2ff181cf83..552a1e5e5c814 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TimeBasedCheckpointProvider.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TimeBasedCheckpointProvider.java
@@ -32,11 +32,12 @@ public class TimeBasedCheckpointProvider extends DefaultCheckpointProvider {
 
     TimeBasedCheckpointProvider(
         final Client client,
+        final RemoteClusterResolver remoteClusterResolver,
         final TransformConfigManager transformConfigManager,
         final TransformAuditor transformAuditor,
         final TransformConfig transformConfig
     ) {
-        super(client, transformConfigManager, transformAuditor, transformConfig);
+        super(client, remoteClusterResolver, transformConfigManager, transformAuditor, transformConfig);
         timeSyncConfig = (TimeSyncConfig) transformConfig.getSyncConfig();
     }
 
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointService.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointService.java
index 64faf41462589..492073b111c21 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointService.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointService.java
@@ -10,6 +10,8 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.xpack.core.transform.transforms.TimeSyncConfig;
 import org.elasticsearch.xpack.core.transform.transforms.TransformCheckpointingInfo.TransformCheckpointingInfoBuilder;
 import org.elasticsearch.xpack.core.transform.transforms.TransformConfig;
@@ -33,23 +35,33 @@ public class TransformCheckpointService {
     private final Client client;
     private final TransformConfigManager transformConfigManager;
     private final TransformAuditor transformAuditor;
+    private final RemoteClusterResolver remoteClusterResolver;
 
     public TransformCheckpointService(
         final Client client,
+        final Settings settings,
+        final ClusterService clusterService,
         final TransformConfigManager transformConfigManager,
         TransformAuditor transformAuditor
     ) {
         this.client = client;
         this.transformConfigManager = transformConfigManager;
         this.transformAuditor = transformAuditor;
+        this.remoteClusterResolver = new RemoteClusterResolver(settings, clusterService.getClusterSettings());
     }
 
     public CheckpointProvider getCheckpointProvider(final TransformConfig transformConfig) {
         if (transformConfig.getSyncConfig() instanceof TimeSyncConfig) {
-            return new TimeBasedCheckpointProvider(client, transformConfigManager, transformAuditor, transformConfig);
+            return new TimeBasedCheckpointProvider(
+                client,
+                remoteClusterResolver,
+                transformConfigManager,
+                transformAuditor,
+                transformConfig
+            );
         }
 
-        return new DefaultCheckpointProvider(client, transformConfigManager, transformAuditor, transformConfig);
+        return new DefaultCheckpointProvider(client, remoteClusterResolver, transformConfigManager, transformAuditor, transformConfig);
     }
 
     /**
@@ -82,5 +94,4 @@ public void getCheckpointingInfo(
             listener.onFailure(new CheckpointException("Failed to retrieve configuration", transformError));
         }));
     }
-
 }
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProviderTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProviderTests.java
index 02fa4765ff637..b7eca07108518 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProviderTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/DefaultCheckpointProviderTests.java
@@ -11,6 +11,8 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.logging.Loggers;
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.set.Sets;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.MockLogAppender;
@@ -48,6 +50,7 @@ public void testReportSourceIndexChangesRunsEmpty() throws Exception {
 
         DefaultCheckpointProvider provider = new DefaultCheckpointProvider(
             client,
+            new RemoteClusterResolver(Settings.EMPTY, new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS)),
             transformConfigManager,
             transformAuditor,
             transformConfig
@@ -92,6 +95,7 @@ public void testReportSourceIndexChangesAddDelete() throws Exception {
 
         DefaultCheckpointProvider provider = new DefaultCheckpointProvider(
             client,
+            new RemoteClusterResolver(Settings.EMPTY, new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS)),
             transformConfigManager,
             transformAuditor,
             transformConfig
@@ -151,6 +155,7 @@ public void testReportSourceIndexChangesAddDeleteMany() throws Exception {
 
         DefaultCheckpointProvider provider = new DefaultCheckpointProvider(
             client,
+            new RemoteClusterResolver(Settings.EMPTY, new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS)),
             transformConfigManager,
             transformAuditor,
             transformConfig
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointServiceNodeTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointServiceNodeTests.java
index 7af774f4a6faf..1552178b7dc39 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointServiceNodeTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformCheckpointServiceNodeTests.java
@@ -19,7 +19,10 @@
 import org.elasticsearch.cluster.routing.RecoverySource;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.cluster.routing.UnassignedInfo;
+import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.UUIDs;
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.cache.query.QueryCacheStats;
 import org.elasticsearch.index.cache.request.RequestCacheStats;
@@ -138,7 +141,13 @@ public void createComponents() {
 
         // use a mock for the checkpoint service
         TransformAuditor mockAuditor = mock(TransformAuditor.class);
-        transformCheckpointService = new TransformCheckpointService(mockClientForCheckpointing, transformsConfigManager, mockAuditor);
+        transformCheckpointService = new TransformCheckpointService(
+            mockClientForCheckpointing,
+            Settings.EMPTY,
+            new ClusterService(Settings.EMPTY, new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), null),
+            transformsConfigManager,
+            mockAuditor
+        );
     }
 
     @AfterClass
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformsCheckpointServiceTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformsCheckpointServiceTests.java
index d62a242d8fe16..d4b30eb833051 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformsCheckpointServiceTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/checkpoint/TransformsCheckpointServiceTests.java
@@ -51,7 +51,7 @@ public void testExtractIndexCheckpoints() {
 
         ShardStats[] shardStatsArray = createRandomShardStats(expectedCheckpoints, indices, false, false, false);
 
-        Map<String, long[]> checkpoints = DefaultCheckpointProvider.extractIndexCheckPoints(shardStatsArray, indices);
+        Map<String, long[]> checkpoints = DefaultCheckpointProvider.extractIndexCheckPoints(shardStatsArray, indices, "");
 
         assertEquals(expectedCheckpoints.size(), checkpoints.size());
         assertEquals(expectedCheckpoints.keySet(), checkpoints.keySet());
@@ -68,7 +68,7 @@ public void testExtractIndexCheckpointsMissingSeqNoStats() {
 
         ShardStats[] shardStatsArray = createRandomShardStats(expectedCheckpoints, indices, false, false, true);
 
-        Map<String, long[]> checkpoints = DefaultCheckpointProvider.extractIndexCheckPoints(shardStatsArray, indices);
+        Map<String, long[]> checkpoints = DefaultCheckpointProvider.extractIndexCheckPoints(shardStatsArray, indices, "");
 
         assertEquals(expectedCheckpoints.size(), checkpoints.size());
         assertEquals(expectedCheckpoints.keySet(), checkpoints.keySet());
@@ -85,7 +85,7 @@ public void testExtractIndexCheckpointsLostPrimaries() {
 
         ShardStats[] shardStatsArray = createRandomShardStats(expectedCheckpoints, indices, true, false, false);
 
-        Map<String, long[]> checkpoints = DefaultCheckpointProvider.extractIndexCheckPoints(shardStatsArray, indices);
+        Map<String, long[]> checkpoints = DefaultCheckpointProvider.extractIndexCheckPoints(shardStatsArray, indices, "");
 
         assertEquals(expectedCheckpoints.size(), checkpoints.size());
         assertEquals(expectedCheckpoints.keySet(), checkpoints.keySet());
@@ -102,7 +102,7 @@ public void testExtractIndexCheckpointsInconsistentGlobalCheckpoints() {
 
         ShardStats[] shardStatsArray = createRandomShardStats(expectedCheckpoints, indices, randomBoolean(), true, false);
 
-        Map<String, long[]> checkpoints = DefaultCheckpointProvider.extractIndexCheckPoints(shardStatsArray, indices);
+        Map<String, long[]> checkpoints = DefaultCheckpointProvider.extractIndexCheckPoints(shardStatsArray, indices, "");
 
         assertEquals(expectedCheckpoints.size(), checkpoints.size());
         assertEquals(expectedCheckpoints.keySet(), checkpoints.keySet());
@@ -142,8 +142,13 @@ private static Set<String> randomUserIndices() {
      * @param missingSeqNoStats whether some indices miss SeqNoStats
      * @return array of ShardStats
      */
-    private static ShardStats[] createRandomShardStats(Map<String, long[]> expectedCheckpoints, Set<String> userIndices,
-            boolean skipPrimaries, boolean inconsistentGlobalCheckpoints, boolean missingSeqNoStats) {
+    private static ShardStats[] createRandomShardStats(
+        Map<String, long[]> expectedCheckpoints,
+        Set<String> userIndices,
+        boolean skipPrimaries,
+        boolean inconsistentGlobalCheckpoints,
+        boolean missingSeqNoStats
+    ) {
 
         // always create the full list
         List<Index> indices = new ArrayList<>();
@@ -192,15 +197,17 @@ private static ShardStats[] createRandomShardStats(Map<String, long[]> expectedC
                     checkpoints.add(globalCheckpoint);
                 }
 
-                for (int replica = 0;  replica < numShardCopies; replica++) {
+                for (int replica = 0; replica < numShardCopies; replica++) {
                     ShardId shardId = new ShardId(index, shardIndex);
                     boolean primary = (replica == primaryShard);
 
                     Path path = createTempDir().resolve("indices").resolve(index.getUUID()).resolve(String.valueOf(shardIndex));
-                    ShardRouting shardRouting = ShardRouting.newUnassigned(shardId, primary,
+                    ShardRouting shardRouting = ShardRouting.newUnassigned(
+                        shardId,
+                        primary,
                         primary ? RecoverySource.EmptyStoreRecoverySource.INSTANCE : PeerRecoverySource.INSTANCE,
                         new UnassignedInfo(UnassignedInfo.Reason.INDEX_CREATED, null)
-                        );
+                    );
                     shardRouting = shardRouting.initialize("node-0", null, ShardRouting.UNAVAILABLE_EXPECTED_SHARD_SIZE);
                     shardRouting = shardRouting.moveToStarted();
 
@@ -222,15 +229,18 @@ private static ShardStats[] createRandomShardStats(Map<String, long[]> expectedC
 
                     if (inconsistentReplica == replica) {
                         // overwrite
-                        SeqNoStats invalidSeqNoStats =
-                            new SeqNoStats(maxSeqNo, localCheckpoint, globalCheckpoint - randomLongBetween(10L, 100L));
+                        SeqNoStats invalidSeqNoStats = new SeqNoStats(
+                            maxSeqNo,
+                            localCheckpoint,
+                            globalCheckpoint - randomLongBetween(10L, 100L)
+                        );
                         shardStats.add(
-                            new ShardStats(shardRouting,
-                                new ShardPath(false, path, path, shardId), stats, null, invalidSeqNoStats, null));
+                            new ShardStats(shardRouting, new ShardPath(false, path, path, shardId), stats, null, invalidSeqNoStats, null)
+                        );
                     } else {
                         shardStats.add(
-                            new ShardStats(shardRouting,
-                                new ShardPath(false, path, path, shardId), stats, null, validSeqNoStats, null));
+                            new ShardStats(shardRouting, new ShardPath(false, path, path, shardId), stats, null, validSeqNoStats, null)
+                        );
                     }
                 }
             }
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/TransformPersistentTasksExecutorTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/TransformPersistentTasksExecutorTests.java
index 8947559c849c5..200e7d5f2527f 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/TransformPersistentTasksExecutorTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/TransformPersistentTasksExecutorTests.java
@@ -126,6 +126,8 @@ public void testNodeVersionAssignment() {
         IndexBasedTransformConfigManager transformsConfigManager = new IndexBasedTransformConfigManager(client, xContentRegistry());
         TransformCheckpointService transformCheckpointService = new TransformCheckpointService(
             client,
+            Settings.EMPTY,
+            new ClusterService(Settings.EMPTY, new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), null),
             transformsConfigManager,
             mockAuditor
         );
diff --git a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/TransformTaskTests.java b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/TransformTaskTests.java
index 4b1c2cb2f9b12..a4eff60768773 100644
--- a/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/TransformTaskTests.java
+++ b/x-pack/plugin/transform/src/test/java/org/elasticsearch/xpack/transform/transforms/TransformTaskTests.java
@@ -10,6 +10,9 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.persistent.PersistentTasksService;
 import org.elasticsearch.rest.RestStatus;
@@ -69,8 +72,13 @@ public void testStopOnFailedTaskWithStoppedIndexer() {
         TransformConfig transformConfig = TransformConfigTests.randomDataFrameTransformConfigWithoutHeaders();
         TransformAuditor auditor = new MockTransformAuditor();
         TransformConfigManager transformsConfigManager = new InMemoryTransformConfigManager();
-
-        TransformCheckpointService transformsCheckpointService = new TransformCheckpointService(client, transformsConfigManager, auditor);
+        TransformCheckpointService transformsCheckpointService = new TransformCheckpointService(
+            client,
+            Settings.EMPTY,
+            new ClusterService(Settings.EMPTY, new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), null),
+            transformsConfigManager,
+            auditor
+        );
 
         TransformState transformState = new TransformState(
             TransformTaskState.FAILED,

From 7d1e640bbc17ad387d43c3047d614d951d12bef8 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Tue, 14 Jan 2020 15:01:47 +0200
Subject: [PATCH 546/686] =?UTF-8?q?[ML]=20Add=20num=5Ftop=5Ffeature=5Fimpo?=
 =?UTF-8?q?rtance=5Fvalues=20param=20to=20regression=20and=20classi?=
 =?UTF-8?q?=E2=80=A6=20(#50914)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds a new parameter to regression and classification that enables computation
of importance for the top most important features. The computation of the importance
is based on SHAP (SHapley Additive exPlanations) method.
---
 .../client/ml/dataframe/Classification.java   | 38 ++++++--
 .../client/ml/dataframe/Regression.java       | 38 ++++++--
 .../client/MachineLearningIT.java             | 12 +++
 .../MlClientDocumentationIT.java              | 18 ++--
 .../ml/dataframe/ClassificationTests.java     |  1 +
 .../client/ml/dataframe/RegressionTests.java  |  1 +
 .../ml/put-data-frame-analytics.asciidoc      | 16 ++--
 .../apis/put-dfanalytics.asciidoc             |  8 ++
 docs/reference/ml/ml-shared.asciidoc          |  8 ++
 .../dataframe/analyses/BoostedTreeParams.java | 91 +++++++++++++++++--
 .../ml/dataframe/analyses/Classification.java | 12 +--
 .../ml/dataframe/analyses/Regression.java     | 10 +-
 .../persistence/ElasticsearchMappings.java    |  6 ++
 .../ml/job/results/ReservedFieldNames.java    |  1 +
 .../analyses/BoostedTreeParamsTests.java      | 39 +++++---
 .../analyses/ClassificationTests.java         |  2 +-
 .../dataframe/analyses/RegressionTests.java   |  2 +-
 .../ml/integration/ClassificationIT.java      | 22 ++++-
 .../xpack/ml/integration/RegressionIT.java    | 21 ++++-
 19 files changed, 266 insertions(+), 80 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Classification.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Classification.java
index 9d384e6d86786..02861adc73845 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Classification.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Classification.java
@@ -46,6 +46,7 @@ public static Builder builder(String dependentVariable) {
     static final ParseField ETA = new ParseField("eta");
     static final ParseField MAXIMUM_NUMBER_TREES = new ParseField("maximum_number_trees");
     static final ParseField FEATURE_BAG_FRACTION = new ParseField("feature_bag_fraction");
+    static final ParseField NUM_TOP_FEATURE_IMPORTANCE_VALUES = new ParseField("num_top_feature_importance_values");
     static final ParseField PREDICTION_FIELD_NAME = new ParseField("prediction_field_name");
     static final ParseField TRAINING_PERCENT = new ParseField("training_percent");
     static final ParseField NUM_TOP_CLASSES = new ParseField("num_top_classes");
@@ -62,10 +63,11 @@ public static Builder builder(String dependentVariable) {
                 (Double) a[3],
                 (Integer) a[4],
                 (Double) a[5],
-                (String) a[6],
-                (Double) a[7],
-                (Integer) a[8],
-                (Long) a[9]));
+                (Integer) a[6],
+                (String) a[7],
+                (Double) a[8],
+                (Integer) a[9],
+                (Long) a[10]));
 
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), DEPENDENT_VARIABLE);
@@ -74,6 +76,7 @@ public static Builder builder(String dependentVariable) {
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), ETA);
         PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), MAXIMUM_NUMBER_TREES);
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), FEATURE_BAG_FRACTION);
+        PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), NUM_TOP_FEATURE_IMPORTANCE_VALUES);
         PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), PREDICTION_FIELD_NAME);
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), TRAINING_PERCENT);
         PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), NUM_TOP_CLASSES);
@@ -86,13 +89,15 @@ public static Builder builder(String dependentVariable) {
     private final Double eta;
     private final Integer maximumNumberTrees;
     private final Double featureBagFraction;
+    private final Integer numTopFeatureImportanceValues;
     private final String predictionFieldName;
     private final Double trainingPercent;
     private final Integer numTopClasses;
     private final Long randomizeSeed;
 
     private Classification(String dependentVariable, @Nullable Double lambda, @Nullable Double gamma, @Nullable Double eta,
-                           @Nullable Integer maximumNumberTrees, @Nullable Double featureBagFraction, @Nullable String predictionFieldName,
+                           @Nullable Integer maximumNumberTrees, @Nullable Double featureBagFraction,
+                           @Nullable Integer numTopFeatureImportanceValues, @Nullable String predictionFieldName,
                            @Nullable Double trainingPercent, @Nullable Integer numTopClasses, @Nullable Long randomizeSeed) {
         this.dependentVariable = Objects.requireNonNull(dependentVariable);
         this.lambda = lambda;
@@ -100,6 +105,7 @@ private Classification(String dependentVariable, @Nullable Double lambda, @Nulla
         this.eta = eta;
         this.maximumNumberTrees = maximumNumberTrees;
         this.featureBagFraction = featureBagFraction;
+        this.numTopFeatureImportanceValues = numTopFeatureImportanceValues;
         this.predictionFieldName = predictionFieldName;
         this.trainingPercent = trainingPercent;
         this.numTopClasses = numTopClasses;
@@ -135,6 +141,10 @@ public Double getFeatureBagFraction() {
         return featureBagFraction;
     }
 
+    public Integer getNumTopFeatureImportanceValues() {
+        return numTopFeatureImportanceValues;
+    }
+
     public String getPredictionFieldName() {
         return predictionFieldName;
     }
@@ -170,6 +180,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (featureBagFraction != null) {
             builder.field(FEATURE_BAG_FRACTION.getPreferredName(), featureBagFraction);
         }
+        if (numTopFeatureImportanceValues != null) {
+            builder.field(NUM_TOP_FEATURE_IMPORTANCE_VALUES.getPreferredName(), numTopFeatureImportanceValues);
+        }
         if (predictionFieldName != null) {
             builder.field(PREDICTION_FIELD_NAME.getPreferredName(), predictionFieldName);
         }
@@ -188,8 +201,8 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
 
     @Override
     public int hashCode() {
-        return Objects.hash(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, predictionFieldName,
-            trainingPercent, randomizeSeed, numTopClasses);
+        return Objects.hash(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, numTopFeatureImportanceValues,
+            predictionFieldName, trainingPercent, randomizeSeed, numTopClasses);
     }
 
     @Override
@@ -203,6 +216,7 @@ public boolean equals(Object o) {
             && Objects.equals(eta, that.eta)
             && Objects.equals(maximumNumberTrees, that.maximumNumberTrees)
             && Objects.equals(featureBagFraction, that.featureBagFraction)
+            && Objects.equals(numTopFeatureImportanceValues, that.numTopFeatureImportanceValues)
             && Objects.equals(predictionFieldName, that.predictionFieldName)
             && Objects.equals(trainingPercent, that.trainingPercent)
             && Objects.equals(randomizeSeed, that.randomizeSeed)
@@ -221,6 +235,7 @@ public static class Builder {
         private Double eta;
         private Integer maximumNumberTrees;
         private Double featureBagFraction;
+        private Integer numTopFeatureImportanceValues;
         private String predictionFieldName;
         private Double trainingPercent;
         private Integer numTopClasses;
@@ -255,6 +270,11 @@ public Builder setFeatureBagFraction(Double featureBagFraction) {
             return this;
         }
 
+        public Builder setNumTopFeatureImportanceValues(Integer numTopFeatureImportanceValues) {
+            this.numTopFeatureImportanceValues = numTopFeatureImportanceValues;
+            return this;
+        }
+
         public Builder setPredictionFieldName(String predictionFieldName) {
             this.predictionFieldName = predictionFieldName;
             return this;
@@ -276,8 +296,8 @@ public Builder setNumTopClasses(Integer numTopClasses) {
         }
 
         public Classification build() {
-            return new Classification(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, predictionFieldName,
-                trainingPercent, numTopClasses, randomizeSeed);
+            return new Classification(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction,
+                numTopFeatureImportanceValues, predictionFieldName, trainingPercent, numTopClasses, randomizeSeed);
         }
     }
 }
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Regression.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Regression.java
index fa55ee40b27fb..d7e374a2563a1 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Regression.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/dataframe/Regression.java
@@ -46,6 +46,7 @@ public static Builder builder(String dependentVariable) {
     static final ParseField ETA = new ParseField("eta");
     static final ParseField MAXIMUM_NUMBER_TREES = new ParseField("maximum_number_trees");
     static final ParseField FEATURE_BAG_FRACTION = new ParseField("feature_bag_fraction");
+    static final ParseField NUM_TOP_FEATURE_IMPORTANCE_VALUES = new ParseField("num_top_feature_importance_values");
     static final ParseField PREDICTION_FIELD_NAME = new ParseField("prediction_field_name");
     static final ParseField TRAINING_PERCENT = new ParseField("training_percent");
     static final ParseField RANDOMIZE_SEED = new ParseField("randomize_seed");
@@ -61,9 +62,10 @@ public static Builder builder(String dependentVariable) {
                 (Double) a[3],
                 (Integer) a[4],
                 (Double) a[5],
-                (String) a[6],
-                (Double) a[7],
-                (Long) a[8]));
+                (Integer) a[6],
+                (String) a[7],
+                (Double) a[8],
+                (Long) a[9]));
 
     static {
         PARSER.declareString(ConstructingObjectParser.constructorArg(), DEPENDENT_VARIABLE);
@@ -72,6 +74,7 @@ public static Builder builder(String dependentVariable) {
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), ETA);
         PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), MAXIMUM_NUMBER_TREES);
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), FEATURE_BAG_FRACTION);
+        PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), NUM_TOP_FEATURE_IMPORTANCE_VALUES);
         PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), PREDICTION_FIELD_NAME);
         PARSER.declareDouble(ConstructingObjectParser.optionalConstructorArg(), TRAINING_PERCENT);
         PARSER.declareLong(ConstructingObjectParser.optionalConstructorArg(), RANDOMIZE_SEED);
@@ -83,12 +86,14 @@ public static Builder builder(String dependentVariable) {
     private final Double eta;
     private final Integer maximumNumberTrees;
     private final Double featureBagFraction;
+    private final Integer numTopFeatureImportanceValues;
     private final String predictionFieldName;
     private final Double trainingPercent;
     private final Long randomizeSeed;
 
-    private Regression(String dependentVariable,  @Nullable Double lambda, @Nullable Double gamma, @Nullable Double eta,
-                       @Nullable Integer maximumNumberTrees, @Nullable Double featureBagFraction, @Nullable String predictionFieldName,
+    private Regression(String dependentVariable, @Nullable Double lambda, @Nullable Double gamma, @Nullable Double eta,
+                       @Nullable Integer maximumNumberTrees, @Nullable Double featureBagFraction,
+                       @Nullable Integer numTopFeatureImportanceValues, @Nullable String predictionFieldName,
                        @Nullable Double trainingPercent, @Nullable Long randomizeSeed) {
         this.dependentVariable = Objects.requireNonNull(dependentVariable);
         this.lambda = lambda;
@@ -96,6 +101,7 @@ private Regression(String dependentVariable,  @Nullable Double lambda, @Nullable
         this.eta = eta;
         this.maximumNumberTrees = maximumNumberTrees;
         this.featureBagFraction = featureBagFraction;
+        this.numTopFeatureImportanceValues = numTopFeatureImportanceValues;
         this.predictionFieldName = predictionFieldName;
         this.trainingPercent = trainingPercent;
         this.randomizeSeed = randomizeSeed;
@@ -130,6 +136,10 @@ public Double getFeatureBagFraction() {
         return featureBagFraction;
     }
 
+    public Integer getNumTopFeatureImportanceValues() {
+        return numTopFeatureImportanceValues;
+    }
+
     public String getPredictionFieldName() {
         return predictionFieldName;
     }
@@ -161,6 +171,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (featureBagFraction != null) {
             builder.field(FEATURE_BAG_FRACTION.getPreferredName(), featureBagFraction);
         }
+        if (numTopFeatureImportanceValues != null) {
+            builder.field(NUM_TOP_FEATURE_IMPORTANCE_VALUES.getPreferredName(), numTopFeatureImportanceValues);
+        }
         if (predictionFieldName != null) {
             builder.field(PREDICTION_FIELD_NAME.getPreferredName(), predictionFieldName);
         }
@@ -176,8 +189,8 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
 
     @Override
     public int hashCode() {
-        return Objects.hash(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, predictionFieldName,
-            trainingPercent, randomizeSeed);
+        return Objects.hash(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, numTopFeatureImportanceValues,
+            predictionFieldName, trainingPercent, randomizeSeed);
     }
 
     @Override
@@ -191,6 +204,7 @@ public boolean equals(Object o) {
             && Objects.equals(eta, that.eta)
             && Objects.equals(maximumNumberTrees, that.maximumNumberTrees)
             && Objects.equals(featureBagFraction, that.featureBagFraction)
+            && Objects.equals(numTopFeatureImportanceValues, that.numTopFeatureImportanceValues)
             && Objects.equals(predictionFieldName, that.predictionFieldName)
             && Objects.equals(trainingPercent, that.trainingPercent)
             && Objects.equals(randomizeSeed, that.randomizeSeed);
@@ -208,6 +222,7 @@ public static class Builder {
         private Double eta;
         private Integer maximumNumberTrees;
         private Double featureBagFraction;
+        private Integer numTopFeatureImportanceValues;
         private String predictionFieldName;
         private Double trainingPercent;
         private Long randomizeSeed;
@@ -241,6 +256,11 @@ public Builder setFeatureBagFraction(Double featureBagFraction) {
             return this;
         }
 
+        public Builder setNumTopFeatureImportanceValues(Integer numTopFeatureImportanceValues) {
+            this.numTopFeatureImportanceValues = numTopFeatureImportanceValues;
+            return this;
+        }
+
         public Builder setPredictionFieldName(String predictionFieldName) {
             this.predictionFieldName = predictionFieldName;
             return this;
@@ -257,8 +277,8 @@ public Builder setRandomizeSeed(Long randomizeSeed) {
         }
 
         public Regression build() {
-            return new Regression(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction, predictionFieldName,
-                trainingPercent, randomizeSeed);
+            return new Regression(dependentVariable, lambda, gamma, eta, maximumNumberTrees, featureBagFraction,
+                numTopFeatureImportanceValues, predictionFieldName, trainingPercent, randomizeSeed);
         }
     }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
index 0664d49f76841..6fe08f8a507de 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/MachineLearningIT.java
@@ -1294,6 +1294,12 @@ public void testPutDataFrameAnalyticsConfig_GivenRegression() throws Exception {
                 .setPredictionFieldName("my_dependent_variable_prediction")
                 .setTrainingPercent(80.0)
                 .setRandomizeSeed(42L)
+                .setLambda(1.0)
+                .setGamma(1.0)
+                .setEta(1.0)
+                .setMaximumNumberTrees(10)
+                .setFeatureBagFraction(0.5)
+                .setNumTopFeatureImportanceValues(3)
                 .build())
             .setDescription("this is a regression")
             .build();
@@ -1331,6 +1337,12 @@ public void testPutDataFrameAnalyticsConfig_GivenClassification() throws Excepti
                 .setTrainingPercent(80.0)
                 .setRandomizeSeed(42L)
                 .setNumTopClasses(1)
+                .setLambda(1.0)
+                .setGamma(1.0)
+                .setEta(1.0)
+                .setMaximumNumberTrees(10)
+                .setFeatureBagFraction(0.5)
+                .setNumTopFeatureImportanceValues(3)
                 .build())
             .setDescription("this is a classification")
             .build();
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
index 0db9dbf222f49..b850b2e8b9f1a 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/MlClientDocumentationIT.java
@@ -2975,10 +2975,11 @@ public void testPutDataFrameAnalytics() throws Exception {
                 .setEta(5.5) // <4>
                 .setMaximumNumberTrees(50) // <5>
                 .setFeatureBagFraction(0.4) // <6>
-                .setPredictionFieldName("my_prediction_field_name") // <7>
-                .setTrainingPercent(50.0) // <8>
-                .setRandomizeSeed(1234L) // <9>
-                .setNumTopClasses(1) // <10>
+                .setNumTopFeatureImportanceValues(3) // <7>
+                .setPredictionFieldName("my_prediction_field_name") // <8>
+                .setTrainingPercent(50.0) // <9>
+                .setRandomizeSeed(1234L) // <10>
+                .setNumTopClasses(1) // <11>
                 .build();
             // end::put-data-frame-analytics-classification
 
@@ -2989,9 +2990,10 @@ public void testPutDataFrameAnalytics() throws Exception {
                 .setEta(5.5) // <4>
                 .setMaximumNumberTrees(50) // <5>
                 .setFeatureBagFraction(0.4) // <6>
-                .setPredictionFieldName("my_prediction_field_name") // <7>
-                .setTrainingPercent(50.0) // <8>
-                .setRandomizeSeed(1234L) // <9>
+                .setNumTopFeatureImportanceValues(3) // <7>
+                .setPredictionFieldName("my_prediction_field_name") // <8>
+                .setTrainingPercent(50.0) // <9>
+                .setRandomizeSeed(1234L) // <10>
                 .build();
             // end::put-data-frame-analytics-regression
 
@@ -3670,7 +3672,7 @@ public void testPutTrainedModel() throws Exception {
         }
         {
             PutTrainedModelRequest request = new PutTrainedModelRequest(trainedModelConfig);
-            
+
             // tag::put-trained-model-execute-listener
             ActionListener<PutTrainedModelResponse> listener = new ActionListener<>() {
                 @Override
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/ClassificationTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/ClassificationTests.java
index 5ef8fdaef5a27..79d78c888880f 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/ClassificationTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/ClassificationTests.java
@@ -32,6 +32,7 @@ public static Classification randomClassification() {
             .setEta(randomBoolean() ? null : randomDoubleBetween(0.001, 1.0, true))
             .setMaximumNumberTrees(randomBoolean() ? null : randomIntBetween(1, 2000))
             .setFeatureBagFraction(randomBoolean() ? null : randomDoubleBetween(0.0, 1.0, false))
+            .setNumTopFeatureImportanceValues(randomBoolean() ? null : randomIntBetween(0, Integer.MAX_VALUE))
             .setPredictionFieldName(randomBoolean() ? null : randomAlphaOfLength(10))
             .setTrainingPercent(randomBoolean() ? null : randomDoubleBetween(1.0, 100.0, true))
             .setRandomizeSeed(randomBoolean() ? null : randomLong())
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/RegressionTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/RegressionTests.java
index 02e41ecdff333..eedffb4740d78 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/RegressionTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/dataframe/RegressionTests.java
@@ -32,6 +32,7 @@ public static Regression randomRegression() {
             .setEta(randomBoolean() ? null : randomDoubleBetween(0.001, 1.0, true))
             .setMaximumNumberTrees(randomBoolean() ? null : randomIntBetween(1, 2000))
             .setFeatureBagFraction(randomBoolean() ? null : randomDoubleBetween(0.0, 1.0, false))
+            .setNumTopFeatureImportanceValues(randomBoolean() ? null : randomIntBetween(0, Integer.MAX_VALUE))
             .setPredictionFieldName(randomBoolean() ? null : randomAlphaOfLength(10))
             .setTrainingPercent(randomBoolean() ? null : randomDoubleBetween(1.0, 100.0, true))
             .build();
diff --git a/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc b/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
index 2152eff5c0850..4be2011340210 100644
--- a/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
+++ b/docs/java-rest/high-level/ml/put-data-frame-analytics.asciidoc
@@ -117,10 +117,11 @@ include-tagged::{doc-tests-file}[{api}-classification]
 <4> The applied shrinkage. A double in [0.001, 1].
 <5> The maximum number of trees the forest is allowed to contain. An integer in [1, 2000].
 <6> The fraction of features which will be used when selecting a random bag for each candidate split. A double in (0, 1].
-<7> The name of the prediction field in the results object.
-<8> The percentage of training-eligible rows to be used in training. Defaults to 100%.
-<9> The seed to be used by the random generator that picks which rows are used in training.
-<10> The number of top classes to be reported in the results. Defaults to 2.
+<7> If set, feature importance for the top most important features will be computed.
+<8> The name of the prediction field in the results object.
+<9> The percentage of training-eligible rows to be used in training. Defaults to 100%.
+<10> The seed to be used by the random generator that picks which rows are used in training.
+<11> The number of top classes to be reported in the results. Defaults to 2.
 
 ===== Regression
 
@@ -137,9 +138,10 @@ include-tagged::{doc-tests-file}[{api}-regression]
 <4> The applied shrinkage. A double in [0.001, 1].
 <5> The maximum number of trees the forest is allowed to contain. An integer in [1, 2000].
 <6> The fraction of features which will be used when selecting a random bag for each candidate split. A double in (0, 1].
-<7> The name of the prediction field in the results object.
-<8> The percentage of training-eligible rows to be used in training. Defaults to 100%.
-<9> The seed to be used by the random generator that picks which rows are used in training.
+<7> If set, feature importance for the top most important features will be computed.
+<8> The name of the prediction field in the results object.
+<9> The percentage of training-eligible rows to be used in training. Defaults to 100%.
+<10> The seed to be used by the random generator that picks which rows are used in training.
 
 ==== Analyzed fields
 
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index 24149372e0e99..18b3446bca56c 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -148,6 +148,10 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
 (Optional, long)
 include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
 
+`analysis`.`classification`.`num_top_feature_importance_values`::::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=num-top-feature-importance-values]
+
 `analysis`.`classification`.`training_percent`::::
 (Optional, integer)
 include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
@@ -227,6 +231,10 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
 (Optional, string)
 include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
 
+`analysis`.`regression`.`num_top_feature_importance_values`::::
+(Optional, integer)
+include::{docdir}/ml/ml-shared.asciidoc[tag=num-top-feature-importance-values]
+
 `analysis`.`regression`.`training_percent`::::
 (Optional, integer)
 include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 5454939af1e24..f25cfb94e8bed 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -639,6 +639,14 @@ end::include-model-definition[]
 tag::indices[]
 An array of index names. Wildcards are supported. For example:
 `["it_ops_metrics", "server*"]`.
+
+tag::num-top-feature-importance-values[]
+Advanced configuration option. If set, feature importance for the top
+most important features will be computed. Importance is calculated
+using the SHAP (SHapley Additive exPlanations) method as described in
+https://papers.nips.cc/paper/7062-a-unified-approach-to-interpreting-model-predictions.pdf[Lundberg, S. M., & Lee, S.-I. A Unified Approach to Interpreting Model Predictions. In NeurIPS 2017.].
+end::num-top-feature-importance-values[]
+
 +
 --
 NOTE: If any indices are in remote clusters then `cluster.remote.connect` must
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
index 0f06b08444f53..ec563af73f520 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
@@ -5,6 +5,7 @@
  */
 package org.elasticsearch.xpack.core.ml.dataframe.analyses;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -34,6 +35,7 @@ public class BoostedTreeParams implements ToXContentFragment, Writeable {
     public static final ParseField ETA = new ParseField("eta");
     public static final ParseField MAXIMUM_NUMBER_TREES = new ParseField("maximum_number_trees");
     public static final ParseField FEATURE_BAG_FRACTION = new ParseField("feature_bag_fraction");
+    public static final ParseField NUM_TOP_FEATURE_IMPORTANCE_VALUES = new ParseField("num_top_feature_importance_values");
 
     static void declareFields(AbstractObjectParser<?, Void> parser) {
         parser.declareDouble(optionalConstructorArg(), LAMBDA);
@@ -41,6 +43,7 @@ static void declareFields(AbstractObjectParser<?, Void> parser) {
         parser.declareDouble(optionalConstructorArg(), ETA);
         parser.declareInt(optionalConstructorArg(), MAXIMUM_NUMBER_TREES);
         parser.declareDouble(optionalConstructorArg(), FEATURE_BAG_FRACTION);
+        parser.declareInt(optionalConstructorArg(), NUM_TOP_FEATURE_IMPORTANCE_VALUES);
     }
 
     private final Double lambda;
@@ -48,12 +51,14 @@ static void declareFields(AbstractObjectParser<?, Void> parser) {
     private final Double eta;
     private final Integer maximumNumberTrees;
     private final Double featureBagFraction;
+    private final Integer numTopFeatureImportanceValues;
 
     public BoostedTreeParams(@Nullable Double lambda,
-                      @Nullable Double gamma,
-                      @Nullable Double eta,
-                      @Nullable Integer maximumNumberTrees,
-                      @Nullable Double featureBagFraction) {
+                             @Nullable Double gamma,
+                             @Nullable Double eta,
+                             @Nullable Integer maximumNumberTrees,
+                             @Nullable Double featureBagFraction,
+                             @Nullable Integer numTopFeatureImportanceValues) {
         if (lambda != null && lambda < 0) {
             throw ExceptionsHelper.badRequestException("[{}] must be a non-negative double", LAMBDA.getPreferredName());
         }
@@ -69,15 +74,16 @@ public BoostedTreeParams(@Nullable Double lambda,
         if (featureBagFraction != null && (featureBagFraction <= 0 || featureBagFraction > 1.0)) {
             throw ExceptionsHelper.badRequestException("[{}] must be a double in (0, 1]", FEATURE_BAG_FRACTION.getPreferredName());
         }
+        if (numTopFeatureImportanceValues != null && numTopFeatureImportanceValues < 0) {
+            throw ExceptionsHelper.badRequestException("[{}] must be a non-negative integer",
+                NUM_TOP_FEATURE_IMPORTANCE_VALUES.getPreferredName());
+        }
         this.lambda = lambda;
         this.gamma = gamma;
         this.eta = eta;
         this.maximumNumberTrees = maximumNumberTrees;
         this.featureBagFraction = featureBagFraction;
-    }
-
-    public BoostedTreeParams() {
-        this(null, null, null, null, null);
+        this.numTopFeatureImportanceValues = numTopFeatureImportanceValues;
     }
 
     BoostedTreeParams(StreamInput in) throws IOException {
@@ -86,6 +92,11 @@ public BoostedTreeParams() {
         eta = in.readOptionalDouble();
         maximumNumberTrees = in.readOptionalVInt();
         featureBagFraction = in.readOptionalDouble();
+        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            numTopFeatureImportanceValues = in.readOptionalInt();
+        } else {
+            numTopFeatureImportanceValues = null;
+        }
     }
 
     @Override
@@ -95,6 +106,9 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeOptionalDouble(eta);
         out.writeOptionalVInt(maximumNumberTrees);
         out.writeOptionalDouble(featureBagFraction);
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            out.writeOptionalInt(numTopFeatureImportanceValues);
+        }
     }
 
     @Override
@@ -114,6 +128,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (featureBagFraction != null) {
             builder.field(FEATURE_BAG_FRACTION.getPreferredName(), featureBagFraction);
         }
+        if (numTopFeatureImportanceValues != null) {
+            builder.field(NUM_TOP_FEATURE_IMPORTANCE_VALUES.getPreferredName(), numTopFeatureImportanceValues);
+        }
         return builder;
     }
 
@@ -134,6 +151,9 @@ Map<String, Object> getParams() {
         if (featureBagFraction != null) {
             params.put(FEATURE_BAG_FRACTION.getPreferredName(), featureBagFraction);
         }
+        if (numTopFeatureImportanceValues != null) {
+            params.put(NUM_TOP_FEATURE_IMPORTANCE_VALUES.getPreferredName(), numTopFeatureImportanceValues);
+        }
         return params;
     }
 
@@ -146,11 +166,62 @@ public boolean equals(Object o) {
             && Objects.equals(gamma, that.gamma)
             && Objects.equals(eta, that.eta)
             && Objects.equals(maximumNumberTrees, that.maximumNumberTrees)
-            && Objects.equals(featureBagFraction, that.featureBagFraction);
+            && Objects.equals(featureBagFraction, that.featureBagFraction)
+            && Objects.equals(numTopFeatureImportanceValues, that.numTopFeatureImportanceValues);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(lambda, gamma, eta, maximumNumberTrees, featureBagFraction);
+        return Objects.hash(lambda, gamma, eta, maximumNumberTrees, featureBagFraction, numTopFeatureImportanceValues);
+    }
+
+    public static Builder builder() {
+        return new Builder();
+    }
+
+    public static class Builder {
+
+        private Double lambda;
+        private Double gamma;
+        private Double eta;
+        private Integer maximumNumberTrees;
+        private Double featureBagFraction;
+        private Integer numTopFeatureImportanceValues;
+
+        private Builder() {}
+
+        public Builder setLambda(Double lambda) {
+            this.lambda = lambda;
+            return this;
+        }
+
+        public Builder setGamma(Double gamma) {
+            this.gamma = gamma;
+            return this;
+        }
+
+        public Builder setEta(Double eta) {
+            this.eta = eta;
+            return this;
+        }
+
+        public Builder setMaximumNumberTrees(Integer maximumNumberTrees) {
+            this.maximumNumberTrees = maximumNumberTrees;
+            return this;
+        }
+
+        public Builder setFeatureBagFraction(Double featureBagFraction) {
+            this.featureBagFraction = featureBagFraction;
+            return this;
+        }
+
+        public Builder setNumTopFeatureImportanceValues(Integer numTopFeatureImportanceValues) {
+            this.numTopFeatureImportanceValues = numTopFeatureImportanceValues;
+            return this;
+        }
+
+        public BoostedTreeParams build() {
+            return new BoostedTreeParams(lambda, gamma, eta, maximumNumberTrees, featureBagFraction, numTopFeatureImportanceValues);
+        }
     }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
index 0e68d13895e25..47a02786f5d07 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Classification.java
@@ -50,11 +50,11 @@ private static ConstructingObjectParser<Classification, Void> createParser(boole
             lenient,
             a -> new Classification(
                 (String) a[0],
-                new BoostedTreeParams((Double) a[1], (Double) a[2], (Double) a[3], (Integer) a[4], (Double) a[5]),
-                (String) a[6],
-                (Integer) a[7],
-                (Double) a[8],
-                (Long) a[9]));
+                new BoostedTreeParams((Double) a[1], (Double) a[2], (Double) a[3], (Integer) a[4], (Double) a[5], (Integer) a[6]),
+                (String) a[7],
+                (Integer) a[8],
+                (Double) a[9],
+                (Long) a[10]));
         parser.declareString(constructorArg(), DEPENDENT_VARIABLE);
         BoostedTreeParams.declareFields(parser);
         parser.declareString(optionalConstructorArg(), PREDICTION_FIELD_NAME);
@@ -112,7 +112,7 @@ public Classification(String dependentVariable,
     }
 
     public Classification(String dependentVariable) {
-        this(dependentVariable, new BoostedTreeParams(), null, null, null, null);
+        this(dependentVariable, BoostedTreeParams.builder().build(), null, null, null, null);
     }
 
     public Classification(StreamInput in) throws IOException {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
index fe2927591312a..83174a9aebfe3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/Regression.java
@@ -47,10 +47,10 @@ private static ConstructingObjectParser<Regression, Void> createParser(boolean l
             lenient,
             a -> new Regression(
                 (String) a[0],
-                new BoostedTreeParams((Double) a[1], (Double) a[2], (Double) a[3], (Integer) a[4], (Double) a[5]),
-                (String) a[6],
-                (Double) a[7],
-                (Long) a[8]));
+                new BoostedTreeParams((Double) a[1], (Double) a[2], (Double) a[3], (Integer) a[4], (Double) a[5], (Integer) a[6]),
+                (String) a[7],
+                (Double) a[8],
+                (Long) a[9]));
         parser.declareString(constructorArg(), DEPENDENT_VARIABLE);
         BoostedTreeParams.declareFields(parser);
         parser.declareString(optionalConstructorArg(), PREDICTION_FIELD_NAME);
@@ -85,7 +85,7 @@ public Regression(String dependentVariable,
     }
 
     public Regression(String dependentVariable) {
-        this(dependentVariable, new BoostedTreeParams(), null, null, null);
+        this(dependentVariable, BoostedTreeParams.builder().build(), null, null, null);
     }
 
     public Regression(StreamInput in) throws IOException {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/persistence/ElasticsearchMappings.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/persistence/ElasticsearchMappings.java
index b9de87ef93de0..b64a12e087ea9 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/persistence/ElasticsearchMappings.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/persistence/ElasticsearchMappings.java
@@ -471,6 +471,9 @@ public static void addDataFrameAnalyticsFields(XContentBuilder builder) throws I
                         .startObject(BoostedTreeParams.FEATURE_BAG_FRACTION.getPreferredName())
                             .field(TYPE, DOUBLE)
                         .endObject()
+                        .startObject(BoostedTreeParams.NUM_TOP_FEATURE_IMPORTANCE_VALUES.getPreferredName())
+                            .field(TYPE, INTEGER)
+                        .endObject()
                         .startObject(Regression.PREDICTION_FIELD_NAME.getPreferredName())
                             .field(TYPE, KEYWORD)
                         .endObject()
@@ -499,6 +502,9 @@ public static void addDataFrameAnalyticsFields(XContentBuilder builder) throws I
                         .startObject(BoostedTreeParams.FEATURE_BAG_FRACTION.getPreferredName())
                             .field(TYPE, DOUBLE)
                         .endObject()
+                        .startObject(BoostedTreeParams.NUM_TOP_FEATURE_IMPORTANCE_VALUES.getPreferredName())
+                            .field(TYPE, INTEGER)
+                        .endObject()
                         .startObject(Classification.PREDICTION_FIELD_NAME.getPreferredName())
                             .field(TYPE, KEYWORD)
                         .endObject()
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ReservedFieldNames.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ReservedFieldNames.java
index 8eacdcb0e78e4..968df76d5ed91 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ReservedFieldNames.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/results/ReservedFieldNames.java
@@ -322,6 +322,7 @@ public final class ReservedFieldNames {
             BoostedTreeParams.ETA.getPreferredName(),
             BoostedTreeParams.MAXIMUM_NUMBER_TREES.getPreferredName(),
             BoostedTreeParams.FEATURE_BAG_FRACTION.getPreferredName(),
+            BoostedTreeParams.NUM_TOP_FEATURE_IMPORTANCE_VALUES.getPreferredName(),
 
             ElasticsearchMappings.CONFIG_TYPE,
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParamsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParamsTests.java
index 145533df407cd..6f3aff88846d9 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParamsTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParamsTests.java
@@ -23,7 +23,7 @@ protected BoostedTreeParams doParseInstance(XContentParser parser) throws IOExce
             new ConstructingObjectParser<>(
                 BoostedTreeParams.NAME,
                 true,
-                a -> new BoostedTreeParams((Double) a[0], (Double) a[1], (Double) a[2], (Integer) a[3], (Double) a[4]));
+                a -> new BoostedTreeParams((Double) a[0], (Double) a[1], (Double) a[2], (Integer) a[3], (Double) a[4], (Integer) a[5]));
         BoostedTreeParams.declareFields(objParser);
         return objParser.apply(parser, null);
     }
@@ -34,12 +34,14 @@ protected BoostedTreeParams createTestInstance() {
     }
 
     public static BoostedTreeParams createRandom() {
-        Double lambda = randomBoolean() ? null : randomDoubleBetween(0.0, Double.MAX_VALUE, true);
-        Double gamma = randomBoolean() ? null : randomDoubleBetween(0.0, Double.MAX_VALUE, true);
-        Double eta = randomBoolean() ? null : randomDoubleBetween(0.001, 1.0, true);
-        Integer maximumNumberTrees = randomBoolean() ? null : randomIntBetween(1, 2000);
-        Double featureBagFraction = randomBoolean() ? null : randomDoubleBetween(0.0, 1.0, false);
-        return new BoostedTreeParams(lambda, gamma, eta, maximumNumberTrees, featureBagFraction);
+        return BoostedTreeParams.builder()
+            .setLambda(randomBoolean() ? null : randomDoubleBetween(0.0, Double.MAX_VALUE, true))
+            .setGamma(randomBoolean() ? null : randomDoubleBetween(0.0, Double.MAX_VALUE, true))
+            .setEta(randomBoolean() ? null : randomDoubleBetween(0.001, 1.0, true))
+            .setMaximumNumberTrees(randomBoolean() ? null : randomIntBetween(1, 2000))
+            .setFeatureBagFraction(randomBoolean() ? null : randomDoubleBetween(0.0, 1.0, false))
+            .setNumTopFeatureImportanceValues(randomBoolean() ? null : randomIntBetween(0, Integer.MAX_VALUE))
+            .build();
     }
 
     @Override
@@ -49,57 +51,64 @@ protected Writeable.Reader<BoostedTreeParams> instanceReader() {
 
     public void testConstructor_GivenNegativeLambda() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new BoostedTreeParams(-0.00001, 0.0, 0.5, 500, 0.3));
+            () -> BoostedTreeParams.builder().setLambda(-0.00001).build());
 
         assertThat(e.getMessage(), equalTo("[lambda] must be a non-negative double"));
     }
 
     public void testConstructor_GivenNegativeGamma() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new BoostedTreeParams(0.0, -0.00001, 0.5, 500, 0.3));
+            () -> BoostedTreeParams.builder().setGamma(-0.00001).build());
 
         assertThat(e.getMessage(), equalTo("[gamma] must be a non-negative double"));
     }
 
     public void testConstructor_GivenEtaIsZero() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new BoostedTreeParams(0.0, 0.0, 0.0, 500, 0.3));
+            () -> BoostedTreeParams.builder().setEta(0.0).build());
 
         assertThat(e.getMessage(), equalTo("[eta] must be a double in [0.001, 1]"));
     }
 
     public void testConstructor_GivenEtaIsGreaterThanOne() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new BoostedTreeParams(0.0, 0.0, 1.00001, 500, 0.3));
+            () -> BoostedTreeParams.builder().setEta(1.00001).build());
 
         assertThat(e.getMessage(), equalTo("[eta] must be a double in [0.001, 1]"));
     }
 
     public void testConstructor_GivenMaximumNumberTreesIsZero() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new BoostedTreeParams(0.0, 0.0, 0.5, 0, 0.3));
+            () -> BoostedTreeParams.builder().setMaximumNumberTrees(0).build());
 
         assertThat(e.getMessage(), equalTo("[maximum_number_trees] must be an integer in [1, 2000]"));
     }
 
     public void testConstructor_GivenMaximumNumberTreesIsGreaterThan2k() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new BoostedTreeParams(0.0, 0.0, 0.5, 2001, 0.3));
+            () -> BoostedTreeParams.builder().setMaximumNumberTrees(2001).build());
 
         assertThat(e.getMessage(), equalTo("[maximum_number_trees] must be an integer in [1, 2000]"));
     }
 
     public void testConstructor_GivenFeatureBagFractionIsLessThanZero() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new BoostedTreeParams(0.0, 0.0, 0.5, 500, -0.00001));
+            () -> BoostedTreeParams.builder().setFeatureBagFraction(-0.00001).build());
 
         assertThat(e.getMessage(), equalTo("[feature_bag_fraction] must be a double in (0, 1]"));
     }
 
     public void testConstructor_GivenFeatureBagFractionIsGreaterThanOne() {
         ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
-            () -> new BoostedTreeParams(0.0, 0.0, 0.5, 500, 1.00001));
+            () -> BoostedTreeParams.builder().setFeatureBagFraction(1.00001).build());
 
         assertThat(e.getMessage(), equalTo("[feature_bag_fraction] must be a double in (0, 1]"));
     }
+
+    public void testConstructor_GivenTopFeatureImportanceValuesIsNegative() {
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class,
+            () -> BoostedTreeParams.builder().setNumTopFeatureImportanceValues(-1).build());
+
+        assertThat(e.getMessage(), equalTo("[num_top_feature_importance_values] must be a non-negative integer"));
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
index 1b988379fc218..64b14157cf613 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/ClassificationTests.java
@@ -34,7 +34,7 @@
 
 public class ClassificationTests extends AbstractSerializingTestCase<Classification> {
 
-    private static final BoostedTreeParams BOOSTED_TREE_PARAMS = new BoostedTreeParams(0.0, 0.0, 0.5, 500, 1.0);
+    private static final BoostedTreeParams BOOSTED_TREE_PARAMS = BoostedTreeParams.builder().build();
 
     @Override
     protected Classification doParseInstance(XContentParser parser) throws IOException {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
index c7f89cc0413b5..83df5b44ced25 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/RegressionTests.java
@@ -30,7 +30,7 @@
 
 public class RegressionTests extends AbstractSerializingTestCase<Regression> {
 
-    private static final BoostedTreeParams BOOSTED_TREE_PARAMS = new BoostedTreeParams(0.0, 0.0, 0.5, 500, 1.0);
+    private static final BoostedTreeParams BOOSTED_TREE_PARAMS = BoostedTreeParams.builder().build();
 
     @Override
     protected Regression doParseInstance(XContentParser parser) throws IOException {
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index d1e49169d75e7..ab130089df3f0 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -6,7 +6,6 @@
 package org.elasticsearch.xpack.ml.integration;
 
 import com.google.common.collect.Ordering;
-
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.admin.indices.get.GetIndexAction;
 import org.elasticsearch.action.admin.indices.get.GetIndexRequest;
@@ -28,7 +27,6 @@
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsState;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParams;
-import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParamsTests;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Classification;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.Accuracy;
 import org.elasticsearch.xpack.core.ml.dataframe.evaluation.classification.MulticlassConfusionMatrix;
@@ -86,7 +84,14 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
         String predictedClassField = KEYWORD_FIELD + "_prediction";
         indexData(sourceIndex, 300, 50, KEYWORD_FIELD);
 
-        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Classification(KEYWORD_FIELD));
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null,
+            new Classification(
+                KEYWORD_FIELD,
+                BoostedTreeParams.builder().setNumTopFeatureImportanceValues(1).build(),
+                null,
+                null,
+                null,
+                null));
         registerAnalytics(config);
         putAnalytics(config);
 
@@ -104,6 +109,7 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
             assertThat(getFieldValue(resultsObject, predictedClassField), is(in(KEYWORD_FIELD_VALUES)));
             assertThat(getFieldValue(resultsObject, "is_training"), is(destDoc.containsKey(KEYWORD_FIELD)));
             assertTopClasses(resultsObject, 2, KEYWORD_FIELD, KEYWORD_FIELD_VALUES);
+            assertThat(resultsObject.keySet().stream().filter(k -> k.startsWith("feature_importance.")).findAny().isPresent(), is(true));
         }
 
         assertProgress(jobId, 100, 100, 100, 100);
@@ -178,7 +184,7 @@ public <T> void testWithOnlyTrainingRowsAndTrainingPercentIsFifty(String jobId,
                 sourceIndex,
                 destIndex,
                 null,
-                new Classification(dependentVariable, BoostedTreeParamsTests.createRandom(), null, numTopClasses, 50.0, null));
+                new Classification(dependentVariable, BoostedTreeParams.builder().build(), null, numTopClasses, 50.0, null));
         registerAnalytics(config);
         putAnalytics(config);
 
@@ -414,7 +420,13 @@ public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exceptio
         String firstJobId = "classification_two_jobs_with_same_randomize_seed_1";
         String firstJobDestIndex = firstJobId + "_dest";
 
-        BoostedTreeParams boostedTreeParams = new BoostedTreeParams(1.0, 1.0, 1.0, 1, 1.0);
+        BoostedTreeParams boostedTreeParams = BoostedTreeParams.builder()
+            .setLambda(1.0)
+            .setGamma(1.0)
+            .setEta(1.0)
+            .setFeatureBagFraction(1.0)
+            .setMaximumNumberTrees(1)
+            .build();
 
         DataFrameAnalyticsConfig firstJob = buildAnalytics(firstJobId, sourceIndex, firstJobDestIndex, null,
             new Classification(dependentVariable, boostedTreeParams, null, 1, 50.0, null));
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
index 2d790260dac12..3315727df57c6 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/RegressionIT.java
@@ -18,7 +18,6 @@
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsState;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParams;
-import org.elasticsearch.xpack.core.ml.dataframe.analyses.BoostedTreeParamsTests;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.Regression;
 import org.junit.After;
 
@@ -53,7 +52,14 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
         initialize("regression_single_numeric_feature_and_mixed_data_set");
         indexData(sourceIndex, 300, 50);
 
-        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null, new Regression(DEPENDENT_VARIABLE_FIELD));
+        DataFrameAnalyticsConfig config = buildAnalytics(jobId, sourceIndex, destIndex, null,
+            new Regression(
+                DEPENDENT_VARIABLE_FIELD,
+                BoostedTreeParams.builder().setNumTopFeatureImportanceValues(1).build(),
+                null,
+                null,
+                null)
+        );
         registerAnalytics(config);
         putAnalytics(config);
 
@@ -78,6 +84,7 @@ public void testSingleNumericFeatureAndMixedTrainingAndNonTrainingRows() throws
             assertThat(resultsObject.containsKey("variable_prediction"), is(true));
             assertThat(resultsObject.containsKey("is_training"), is(true));
             assertThat(resultsObject.get("is_training"), is(destDoc.containsKey(DEPENDENT_VARIABLE_FIELD)));
+            assertThat(resultsObject.containsKey("feature_importance." + NUMERICAL_FEATURE_FIELD), is(true));
         }
 
         assertProgress(jobId, 100, 100, 100, 100);
@@ -141,7 +148,7 @@ public void testWithOnlyTrainingRowsAndTrainingPercentIsFifty() throws Exception
                 sourceIndex,
                 destIndex,
                 null,
-                new Regression(DEPENDENT_VARIABLE_FIELD, BoostedTreeParamsTests.createRandom(), null, 50.0, null));
+                new Regression(DEPENDENT_VARIABLE_FIELD, BoostedTreeParams.builder().build(), null, 50.0, null));
         registerAnalytics(config);
         putAnalytics(config);
 
@@ -244,7 +251,13 @@ public void testTwoJobsWithSameRandomizeSeedUseSameTrainingSet() throws Exceptio
         String firstJobId = "regression_two_jobs_with_same_randomize_seed_1";
         String firstJobDestIndex = firstJobId + "_dest";
 
-        BoostedTreeParams boostedTreeParams = new BoostedTreeParams(1.0, 1.0, 1.0, 1, 1.0);
+        BoostedTreeParams boostedTreeParams = BoostedTreeParams.builder()
+            .setLambda(1.0)
+            .setGamma(1.0)
+            .setEta(1.0)
+            .setFeatureBagFraction(1.0)
+            .setMaximumNumberTrees(1)
+            .build();
 
         DataFrameAnalyticsConfig firstJob = buildAnalytics(firstJobId, sourceIndex, firstJobDestIndex, null,
             new Regression(DEPENDENT_VARIABLE_FIELD, boostedTreeParams, null, 50.0, null));

From 11c3dcdfcb11810467333945f2903ed1352217cb Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 14 Jan 2020 14:07:52 +0100
Subject: [PATCH 547/686] Warn on slow metadata performance (#50956)

Has the new cluster state storage layer emit warnings in case metadata performance is very
slow.

Relates #48701
---
 .../coordination/DetachClusterCommand.java    |   2 +-
 .../ElasticsearchNodeCommand.java             |   7 +-
 .../coordination/RemoveSettingsCommand.java   |   2 +-
 .../UnsafeBootstrapMasterCommand.java         |   2 +-
 .../common/settings/ClusterSettings.java      |   6 +-
 .../env/NodeRepurposeCommand.java             |   4 +-
 .../IncrementalClusterStateWriter.java        |   9 +-
 .../gateway/PersistedClusterStateService.java |  94 ++++++++++--
 .../RemoveCorruptedShardDataCommand.java      |   3 +-
 .../java/org/elasticsearch/node/Node.java     |   3 +-
 .../UnsafeBootstrapAndDetachCommandIT.java    |   2 +-
 .../env/NodeRepurposeCommandTests.java        |   8 +-
 .../env/OverrideNodeVersionCommandTests.java  |   8 +-
 .../GatewayMetaStatePersistedStateTests.java  |  15 +-
 .../IncrementalClusterStateWriterTests.java   |   6 +-
 .../PersistedClusterStateServiceTests.java    | 144 +++++++++++++++++-
 .../RemoveCorruptedShardDataCommandTests.java |   4 +-
 .../AbstractCoordinatorTestCase.java          |   4 +-
 .../gateway/MockGatewayMetaState.java         |   3 +-
 19 files changed, 275 insertions(+), 51 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/DetachClusterCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/DetachClusterCommand.java
index 527a1b3f69cb3..c1cf496711f92 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/DetachClusterCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/DetachClusterCommand.java
@@ -50,7 +50,7 @@ public DetachClusterCommand() {
 
     @Override
     protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env) throws IOException {
-        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(env.settings(), dataPaths);
 
         terminal.println(Terminal.Verbosity.VERBOSE, "Loading cluster state");
         final ClusterState oldClusterState = loadTermAndClusterState(persistedClusterStateService, env).v2();
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
index 5c4089a2e35bf..754dacab0c003 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/ElasticsearchNodeCommand.java
@@ -31,6 +31,8 @@
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.env.Environment;
@@ -72,14 +74,15 @@ public ElasticsearchNodeCommand(String description) {
         super(description);
     }
 
-    public static PersistedClusterStateService createPersistedClusterStateService(Path[] dataPaths) throws IOException {
+    public static PersistedClusterStateService createPersistedClusterStateService(Settings settings, Path[] dataPaths) throws IOException {
         final NodeMetaData nodeMetaData = PersistedClusterStateService.nodeMetaData(dataPaths);
         if (nodeMetaData == null) {
             throw new ElasticsearchException(NO_NODE_METADATA_FOUND_MSG);
         }
 
         String nodeId = nodeMetaData.nodeId();
-        return new PersistedClusterStateService(dataPaths, nodeId, namedXContentRegistry, BigArrays.NON_RECYCLING_INSTANCE, true);
+        return new PersistedClusterStateService(dataPaths, nodeId, namedXContentRegistry, BigArrays.NON_RECYCLING_INSTANCE,
+            new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L, true);
     }
 
     public static ClusterState clusterState(Environment environment, PersistedClusterStateService.OnDiskState onDiskState) {
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommand.java
index aa23488ccaa4e..5781e2bdf5a54 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveSettingsCommand.java
@@ -62,7 +62,7 @@ protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet o
             throw new UserException(ExitCodes.USAGE, "Must supply at least one setting to remove");
         }
 
-        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(env.settings(), dataPaths);
 
         terminal.println(Terminal.Verbosity.VERBOSE, "Loading cluster state");
         final Tuple<Long, ClusterState> termAndClusterState = loadTermAndClusterState(persistedClusterStateService, env);
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
index 2b9e7db1e98bd..30dfe5f1722d1 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapMasterCommand.java
@@ -78,7 +78,7 @@ protected boolean validateBeforeLock(Terminal terminal, Environment env) {
     }
 
     protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env) throws IOException {
-        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(env.settings(), dataPaths);
 
         final Tuple<Long, ClusterState> state = loadTermAndClusterState(persistedClusterStateService, env);
         final ClusterState oldClusterState = state.v2();
diff --git a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
index d3b110de4f9a9..6cb2bbd3eaafd 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
@@ -72,7 +72,7 @@
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.gateway.DanglingIndicesState;
 import org.elasticsearch.gateway.GatewayService;
-import org.elasticsearch.gateway.IncrementalClusterStateWriter;
+import org.elasticsearch.gateway.PersistedClusterStateService;
 import org.elasticsearch.http.HttpTransportSettings;
 import org.elasticsearch.index.IndexModule;
 import org.elasticsearch.index.IndexSettings;
@@ -102,9 +102,9 @@
 import org.elasticsearch.search.aggregations.MultiBucketConsumerService;
 import org.elasticsearch.search.fetch.subphase.highlight.FastVectorHighlighter;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.ProxyConnectionStrategy;
 import org.elasticsearch.transport.RemoteClusterService;
 import org.elasticsearch.transport.RemoteConnectionStrategy;
-import org.elasticsearch.transport.ProxyConnectionStrategy;
 import org.elasticsearch.transport.SniffConnectionStrategy;
 import org.elasticsearch.transport.TransportSettings;
 import org.elasticsearch.watcher.ResourceWatcherService;
@@ -232,7 +232,7 @@ public void apply(Settings value, Settings current, Settings previous) {
             GatewayService.RECOVER_AFTER_MASTER_NODES_SETTING,
             GatewayService.RECOVER_AFTER_NODES_SETTING,
             GatewayService.RECOVER_AFTER_TIME_SETTING,
-            IncrementalClusterStateWriter.SLOW_WRITE_LOGGING_THRESHOLD,
+            PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD,
             NetworkModule.HTTP_DEFAULT_TYPE_SETTING,
             NetworkModule.TRANSPORT_DEFAULT_TYPE_SETTING,
             NetworkModule.HTTP_TYPE_SETTING,
diff --git a/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java b/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
index 5281b21449187..bf91f87109a87 100644
--- a/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
+++ b/server/src/main/java/org/elasticsearch/env/NodeRepurposeCommand.java
@@ -95,7 +95,7 @@ private void processNoMasterNoDataNode(Terminal terminal, Path[] dataPaths, Envi
 
         Set<Path> indexPaths = uniqueParentPaths(shardDataPaths, indexMetaDataPaths);
 
-        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(env.settings(), dataPaths);
 
         final MetaData metaData = loadClusterState(terminal, env, persistedClusterStateService).metaData();
         if (indexPaths.isEmpty() && metaData.indices().isEmpty()) {
@@ -133,7 +133,7 @@ private void processMasterNoDataNode(Terminal terminal, Path[] dataPaths, Enviro
             return;
         }
 
-        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(env.settings(), dataPaths);
 
         final MetaData metaData = loadClusterState(terminal, env, persistedClusterStateService).metaData();
 
diff --git a/server/src/main/java/org/elasticsearch/gateway/IncrementalClusterStateWriter.java b/server/src/main/java/org/elasticsearch/gateway/IncrementalClusterStateWriter.java
index 6ff97b6a9d2a5..dea3c629450a3 100644
--- a/server/src/main/java/org/elasticsearch/gateway/IncrementalClusterStateWriter.java
+++ b/server/src/main/java/org/elasticsearch/gateway/IncrementalClusterStateWriter.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.cluster.routing.RoutingNode;
 import org.elasticsearch.cluster.routing.ShardRouting;
 import org.elasticsearch.common.settings.ClusterSettings;
-import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.Index;
@@ -47,9 +46,6 @@ public class IncrementalClusterStateWriter {
 
     private static final Logger logger = LogManager.getLogger(IncrementalClusterStateWriter.class);
 
-    public static final Setting<TimeValue> SLOW_WRITE_LOGGING_THRESHOLD = Setting.timeSetting("gateway.slow_write_logging_threshold",
-        TimeValue.timeValueSeconds(10), TimeValue.ZERO, Setting.Property.NodeScope, Setting.Property.Dynamic);
-
     private final MetaStateService metaStateService;
 
     // We call updateClusterState on the (unique) cluster applier thread so there's no need to synchronize access to these fields.
@@ -67,8 +63,9 @@ public class IncrementalClusterStateWriter {
         this.previousClusterState = clusterState;
         this.relativeTimeMillisSupplier = relativeTimeMillisSupplier;
         this.incrementalWrite = false;
-        this.slowWriteLoggingThreshold = SLOW_WRITE_LOGGING_THRESHOLD.get(settings);
-        clusterSettings.addSettingsUpdateConsumer(SLOW_WRITE_LOGGING_THRESHOLD, this::setSlowWriteLoggingThreshold);
+        this.slowWriteLoggingThreshold = PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD.get(settings);
+        clusterSettings.addSettingsUpdateConsumer(PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD,
+            this::setSlowWriteLoggingThreshold);
     }
 
     private void setSlowWriteLoggingThreshold(TimeValue slowWriteLoggingThreshold) {
diff --git a/server/src/main/java/org/elasticsearch/gateway/PersistedClusterStateService.java b/server/src/main/java/org/elasticsearch/gateway/PersistedClusterStateService.java
index 09eeab049c685..ffef170754075 100644
--- a/server/src/main/java/org/elasticsearch/gateway/PersistedClusterStateService.java
+++ b/server/src/main/java/org/elasticsearch/gateway/PersistedClusterStateService.java
@@ -57,6 +57,9 @@
 import org.elasticsearch.common.lease.Releasable;
 import org.elasticsearch.common.logging.Loggers;
 import org.elasticsearch.common.lucene.Lucene;
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.Setting;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -83,6 +86,8 @@
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.IntPredicate;
+import java.util.function.LongSupplier;
+import java.util.function.Supplier;
 
 /**
  * Stores cluster metadata in a bare Lucene index (per data path) split across a number of documents. This is used by master-eligible nodes
@@ -124,23 +129,39 @@ public class PersistedClusterStateService {
 
     public static final String METADATA_DIRECTORY_NAME = MetaDataStateFormat.STATE_DIR_NAME;
 
+    public static final Setting<TimeValue> SLOW_WRITE_LOGGING_THRESHOLD = Setting.timeSetting("gateway.slow_write_logging_threshold",
+        TimeValue.timeValueSeconds(10), TimeValue.ZERO, Setting.Property.NodeScope, Setting.Property.Dynamic);
+
     private final Path[] dataPaths;
     private final String nodeId;
     private final NamedXContentRegistry namedXContentRegistry;
     private final BigArrays bigArrays;
     private final boolean preserveUnknownCustoms;
+    private final LongSupplier relativeTimeMillisSupplier;
+
+    private volatile TimeValue slowWriteLoggingThreshold;
 
-    public PersistedClusterStateService(NodeEnvironment nodeEnvironment, NamedXContentRegistry namedXContentRegistry, BigArrays bigArrays) {
-        this(nodeEnvironment.nodeDataPaths(), nodeEnvironment.nodeId(), namedXContentRegistry, bigArrays, false);
+    public PersistedClusterStateService(NodeEnvironment nodeEnvironment, NamedXContentRegistry namedXContentRegistry, BigArrays bigArrays,
+                                        ClusterSettings clusterSettings, LongSupplier relativeTimeMillisSupplier) {
+        this(nodeEnvironment.nodeDataPaths(), nodeEnvironment.nodeId(), namedXContentRegistry, bigArrays, clusterSettings,
+            relativeTimeMillisSupplier, false);
     }
 
     public PersistedClusterStateService(Path[] dataPaths, String nodeId, NamedXContentRegistry namedXContentRegistry, BigArrays bigArrays,
+                                        ClusterSettings clusterSettings, LongSupplier relativeTimeMillisSupplier,
                                         boolean preserveUnknownCustoms) {
         this.dataPaths = dataPaths;
         this.nodeId = nodeId;
         this.namedXContentRegistry = namedXContentRegistry;
         this.bigArrays = bigArrays;
+        this.relativeTimeMillisSupplier = relativeTimeMillisSupplier;
         this.preserveUnknownCustoms = preserveUnknownCustoms;
+        this.slowWriteLoggingThreshold = clusterSettings.get(SLOW_WRITE_LOGGING_THRESHOLD);
+        clusterSettings.addSettingsUpdateConsumer(SLOW_WRITE_LOGGING_THRESHOLD, this::setSlowWriteLoggingThreshold);
+    }
+
+    private void setSlowWriteLoggingThreshold(TimeValue slowWriteLoggingThreshold) {
+        this.slowWriteLoggingThreshold = slowWriteLoggingThreshold;
     }
 
     public String getNodeId() {
@@ -169,7 +190,7 @@ public Writer createWriter() throws IOException {
                 IOUtils.closeWhileHandlingException(closeables);
             }
         }
-        return new Writer(metaDataIndexWriters, nodeId, bigArrays);
+        return new Writer(metaDataIndexWriters, nodeId, bigArrays, relativeTimeMillisSupplier, () -> slowWriteLoggingThreshold);
     }
 
     private static IndexWriter createIndexWriter(Directory directory, boolean openExisting) throws IOException {
@@ -524,14 +545,19 @@ public static class Writer implements Closeable {
         private final List<MetaDataIndexWriter> metaDataIndexWriters;
         private final String nodeId;
         private final BigArrays bigArrays;
+        private final LongSupplier relativeTimeMillisSupplier;
+        private final Supplier<TimeValue> slowWriteLoggingThresholdSupplier;
 
         boolean fullStateWritten = false;
         private final AtomicBoolean closed = new AtomicBoolean();
 
-        private Writer(List<MetaDataIndexWriter> metaDataIndexWriters, String nodeId, BigArrays bigArrays) {
+        private Writer(List<MetaDataIndexWriter> metaDataIndexWriters, String nodeId, BigArrays bigArrays,
+                       LongSupplier relativeTimeMillisSupplier, Supplier<TimeValue> slowWriteLoggingThresholdSupplier) {
             this.metaDataIndexWriters = metaDataIndexWriters;
             this.nodeId = nodeId;
             this.bigArrays = bigArrays;
+            this.relativeTimeMillisSupplier = relativeTimeMillisSupplier;
+            this.slowWriteLoggingThresholdSupplier = slowWriteLoggingThresholdSupplier;
         }
 
         private void ensureOpen() {
@@ -561,9 +587,21 @@ private void closeIfAnyIndexWriterHasTragedyOrIsClosed() {
         public void writeFullStateAndCommit(long currentTerm, ClusterState clusterState) throws IOException {
             ensureOpen();
             try {
-                overwriteMetaData(clusterState.metaData());
+                final long startTimeMillis = relativeTimeMillisSupplier.getAsLong();
+                final WriterStats stats = overwriteMetaData(clusterState.metaData());
                 commit(currentTerm, clusterState.version());
                 fullStateWritten = true;
+                final long durationMillis = relativeTimeMillisSupplier.getAsLong() - startTimeMillis;
+                final TimeValue finalSlowWriteLoggingThreshold = slowWriteLoggingThresholdSupplier.get();
+                if (durationMillis >= finalSlowWriteLoggingThreshold.getMillis()) {
+                    logger.warn("writing cluster state took [{}ms] which is above the warn threshold of [{}]; " +
+                            "wrote full state with [{}] indices",
+                        durationMillis, finalSlowWriteLoggingThreshold, stats.numIndicesUpdated);
+                } else {
+                    logger.debug("writing cluster state took [{}ms]; " +
+                            "wrote full state with [{}] indices",
+                        durationMillis, stats.numIndicesUpdated);
+                }
             } finally {
                 closeIfAnyIndexWriterHasTragedyOrIsClosed();
             }
@@ -577,8 +615,21 @@ void writeIncrementalStateAndCommit(long currentTerm, ClusterState previousClust
             ensureOpen();
             assert fullStateWritten : "Need to write full state first before doing incremental writes";
             try {
-                updateMetaData(previousClusterState.metaData(), clusterState.metaData());
+                final long startTimeMillis = relativeTimeMillisSupplier.getAsLong();
+                final WriterStats stats = updateMetaData(previousClusterState.metaData(), clusterState.metaData());
                 commit(currentTerm, clusterState.version());
+                final long durationMillis = relativeTimeMillisSupplier.getAsLong() - startTimeMillis;
+                final TimeValue finalSlowWriteLoggingThreshold = slowWriteLoggingThresholdSupplier.get();
+                if (durationMillis >= finalSlowWriteLoggingThreshold.getMillis()) {
+                    logger.warn("writing cluster state took [{}ms] which is above the warn threshold of [{}]; " +
+                            "wrote global metadata [{}] and metadata for [{}] indices and skipped [{}] unchanged indices",
+                        durationMillis, finalSlowWriteLoggingThreshold, stats.globalMetaUpdated, stats.numIndicesUpdated,
+                        stats.numIndicesUnchanged);
+                } else {
+                    logger.debug("writing cluster state took [{}ms]; " +
+                            "wrote global metadata [{}] and metadata for [{}] indices and skipped [{}] unchanged indices",
+                        durationMillis, stats.globalMetaUpdated, stats.numIndicesUpdated, stats.numIndicesUnchanged);
+                }
             } finally {
                 closeIfAnyIndexWriterHasTragedyOrIsClosed();
             }
@@ -588,12 +639,13 @@ void writeIncrementalStateAndCommit(long currentTerm, ClusterState previousClust
          * Update the persisted metadata to match the given cluster state by removing any stale or unnecessary documents and adding any
          * updated documents.
          */
-        private void updateMetaData(MetaData previouslyWrittenMetaData, MetaData metaData) throws IOException {
+        private WriterStats updateMetaData(MetaData previouslyWrittenMetaData, MetaData metaData) throws IOException {
             assert previouslyWrittenMetaData.coordinationMetaData().term() == metaData.coordinationMetaData().term();
             logger.trace("currentTerm [{}] matches previous currentTerm, writing changes only",
                 metaData.coordinationMetaData().term());
 
-            if (MetaData.isGlobalStateEquals(previouslyWrittenMetaData, metaData) == false) {
+            final boolean updateGlobalMeta = MetaData.isGlobalStateEquals(previouslyWrittenMetaData, metaData) == false;
+            if (updateGlobalMeta) {
                 try (ReleasableDocument globalMetaDataDocument = makeGlobalMetaDataDocument(metaData)) {
                     for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
                         metaDataIndexWriter.updateGlobalMetaData(globalMetaDataDocument.getDocument());
@@ -608,18 +660,22 @@ private void updateMetaData(MetaData previouslyWrittenMetaData, MetaData metaDat
                 assert previousValue == null : indexMetaData.getIndexUUID() + " already mapped to " + previousValue;
             }
 
+            int numIndicesUpdated = 0;
+            int numIndicesUnchanged = 0;
             for (ObjectCursor<IndexMetaData> cursor : metaData.indices().values()) {
                 final IndexMetaData indexMetaData = cursor.value;
                 final Long previousVersion = indexMetaDataVersionByUUID.get(indexMetaData.getIndexUUID());
                 if (previousVersion == null || indexMetaData.getVersion() != previousVersion) {
                     logger.trace("updating metadata for [{}], changing version from [{}] to [{}]",
                         indexMetaData.getIndex(), previousVersion, indexMetaData.getVersion());
+                    numIndicesUpdated++;
                     try (ReleasableDocument indexMetaDataDocument = makeIndexMetaDataDocument(indexMetaData)) {
                         for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
                             metaDataIndexWriter.updateIndexMetaDataDocument(indexMetaDataDocument.getDocument(), indexMetaData.getIndex());
                         }
                     }
                 } else {
+                    numIndicesUnchanged++;
                     logger.trace("no action required for [{}]", indexMetaData.getIndex());
                 }
                 indexMetaDataVersionByUUID.remove(indexMetaData.getIndexUUID());
@@ -636,22 +692,24 @@ private void updateMetaData(MetaData previouslyWrittenMetaData, MetaData metaDat
             for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
                 metaDataIndexWriter.flush();
             }
+
+            return new WriterStats(updateGlobalMeta, numIndicesUpdated, numIndicesUnchanged);
         }
 
         /**
          * Update the persisted metadata to match the given cluster state by removing all existing documents and then adding new documents.
          */
-        private void overwriteMetaData(MetaData metaData) throws IOException {
+        private WriterStats overwriteMetaData(MetaData metaData) throws IOException {
             for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
                 metaDataIndexWriter.deleteAll();
             }
-            addMetaData(metaData);
+            return addMetaData(metaData);
         }
 
         /**
          * Add documents for the metadata of the given cluster state, assuming that there are currently no documents.
          */
-        private void addMetaData(MetaData metaData) throws IOException {
+        private WriterStats addMetaData(MetaData metaData) throws IOException {
             try (ReleasableDocument globalMetaDataDocument = makeGlobalMetaDataDocument(metaData)) {
                 for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
                     metaDataIndexWriter.updateGlobalMetaData(globalMetaDataDocument.getDocument());
@@ -672,6 +730,8 @@ private void addMetaData(MetaData metaData) throws IOException {
             for (MetaDataIndexWriter metaDataIndexWriter : metaDataIndexWriters) {
                 metaDataIndexWriter.flush();
             }
+
+            return new WriterStats(true, metaData.indices().size(), 0);
         }
 
         public void commit(long currentTerm, long lastAcceptedVersion) throws IOException {
@@ -718,6 +778,18 @@ public void close() throws IOException {
             }
         }
 
+        static class WriterStats {
+            final boolean globalMetaUpdated;
+            final long numIndicesUpdated;
+            final long numIndicesUnchanged;
+
+            WriterStats(boolean globalMetaUpdated, long numIndicesUpdated, long numIndicesUnchanged) {
+                this.globalMetaUpdated = globalMetaUpdated;
+                this.numIndicesUpdated = numIndicesUpdated;
+                this.numIndicesUnchanged = numIndicesUnchanged;
+            }
+        }
+
         private ReleasableDocument makeIndexMetaDataDocument(IndexMetaData indexMetaData) throws IOException {
             final ReleasableDocument indexMetaDataDocument = makeDocument(INDEX_TYPE_NAME, indexMetaData);
             boolean success = false;
diff --git a/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java b/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
index 32e1b84c43131..4ed1e9d63b174 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommand.java
@@ -241,7 +241,8 @@ private void warnAboutIndexBackup(Terminal terminal) {
     public void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment environment) throws IOException {
         warnAboutIndexBackup(terminal);
 
-        final ClusterState clusterState = loadTermAndClusterState(createPersistedClusterStateService(dataPaths), environment).v2();
+        final ClusterState clusterState =
+            loadTermAndClusterState(createPersistedClusterStateService(environment.settings(), dataPaths), environment).v2();
 
         findAndProcessShardPath(options, environment, dataPaths, clusterState, shardPath -> {
             final Path indexPath = shardPath.resolveIndex();
diff --git a/server/src/main/java/org/elasticsearch/node/Node.java b/server/src/main/java/org/elasticsearch/node/Node.java
index 64041e85d897a..5c4890ad90ca1 100644
--- a/server/src/main/java/org/elasticsearch/node/Node.java
+++ b/server/src/main/java/org/elasticsearch/node/Node.java
@@ -410,7 +410,8 @@ protected Node(
                 .flatMap(Function.identity()).collect(toList()));
             final MetaStateService metaStateService = new MetaStateService(nodeEnvironment, xContentRegistry);
             final PersistedClusterStateService lucenePersistedStateFactory
-                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry, bigArrays);
+                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry, bigArrays, clusterService.getClusterSettings(),
+                threadPool::relativeTimeInMillis);
 
             // collect engine factory providers from server and from plugins
             final Collection<EnginePlugin> enginePlugins = pluginsService.filterPlugins(EnginePlugin.class);
diff --git a/server/src/test/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapAndDetachCommandIT.java b/server/src/test/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapAndDetachCommandIT.java
index 807da1e77cb99..0ca28bac60e84 100644
--- a/server/src/test/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapAndDetachCommandIT.java
+++ b/server/src/test/java/org/elasticsearch/cluster/coordination/UnsafeBootstrapAndDetachCommandIT.java
@@ -265,7 +265,7 @@ public void test3MasterNodes2Failed() throws Exception {
 
         logger.info("--> unsafely-bootstrap 1st master-eligible node");
         MockTerminal terminal = unsafeBootstrap(environmentMaster1);
-        MetaData metaData = ElasticsearchNodeCommand.createPersistedClusterStateService(nodeEnvironment.nodeDataPaths())
+        MetaData metaData = ElasticsearchNodeCommand.createPersistedClusterStateService(Settings.EMPTY, nodeEnvironment.nodeDataPaths())
             .loadBestOnDiskState().metaData;
         assertThat(terminal.getOutput(), containsString(
             String.format(Locale.ROOT, UnsafeBootstrapMasterCommand.CLUSTER_STATE_TERM_VERSION_MSG_FORMAT,
diff --git a/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandTests.java b/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandTests.java
index c88a3f36da7a8..783d4131f83db 100644
--- a/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandTests.java
+++ b/server/src/test/java/org/elasticsearch/env/NodeRepurposeCommandTests.java
@@ -30,6 +30,7 @@
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.common.CheckedConsumer;
 import org.elasticsearch.common.CheckedRunnable;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.gateway.PersistedClusterStateService;
@@ -70,7 +71,8 @@ public void createNodePaths() throws IOException {
             nodePaths = nodeEnvironment.nodeDataPaths();
             final String nodeId = randomAlphaOfLength(10);
             try (PersistedClusterStateService.Writer writer = new PersistedClusterStateService(nodePaths, nodeId,
-                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE, true).createWriter()) {
+                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(dataMasterSettings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L, true).createWriter()) {
                 writer.writeFullStateAndCommit(1L, ClusterState.EMPTY_STATE);
             }
         }
@@ -105,7 +107,7 @@ public void testNothingToCleanup() throws Exception {
         if (randomBoolean()) {
             try (NodeEnvironment env = new NodeEnvironment(noDataMasterSettings, environment)) {
                 try (PersistedClusterStateService.Writer writer =
-                         ElasticsearchNodeCommand.createPersistedClusterStateService(env.nodeDataPaths()).createWriter()) {
+                         ElasticsearchNodeCommand.createPersistedClusterStateService(Settings.EMPTY, env.nodeDataPaths()).createWriter()) {
                     writer.writeFullStateAndCommit(1L, ClusterState.EMPTY_STATE);
                 }
             }
@@ -233,7 +235,7 @@ private void createIndexDataFiles(Settings settings, int shardCount, boolean wri
         try (NodeEnvironment env = new NodeEnvironment(settings, environment)) {
             if (writeClusterState) {
                 try (PersistedClusterStateService.Writer writer =
-                         ElasticsearchNodeCommand.createPersistedClusterStateService(env.nodeDataPaths()).createWriter()) {
+                         ElasticsearchNodeCommand.createPersistedClusterStateService(Settings.EMPTY, env.nodeDataPaths()).createWriter()) {
                     writer.writeFullStateAndCommit(1L, ClusterState.builder(ClusterName.DEFAULT)
                         .metaData(MetaData.builder().put(IndexMetaData.builder(INDEX.getName())
                             .settings(Settings.builder().put("index.version.created", Version.CURRENT)
diff --git a/server/src/test/java/org/elasticsearch/env/OverrideNodeVersionCommandTests.java b/server/src/test/java/org/elasticsearch/env/OverrideNodeVersionCommandTests.java
index 620a8a365ec05..742c052a07b96 100644
--- a/server/src/test/java/org/elasticsearch/env/OverrideNodeVersionCommandTests.java
+++ b/server/src/test/java/org/elasticsearch/env/OverrideNodeVersionCommandTests.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.gateway.PersistedClusterStateService;
@@ -56,7 +57,8 @@ public void createNodePaths() throws IOException {
             nodeId = nodeEnvironment.nodeId();
 
             try (PersistedClusterStateService.Writer writer = new PersistedClusterStateService(nodePaths, nodeId,
-                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE, true).createWriter()) {
+                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L, true).createWriter()) {
                 writer.writeFullStateAndCommit(1L, ClusterState.builder(ClusterName.DEFAULT).metaData(MetaData.builder()
                     .persistentSettings(Settings.builder().put(MetaData.SETTING_READ_ONLY_SETTING.getKey(), true).build()).build())
                     .build());
@@ -67,7 +69,9 @@ public void createNodePaths() throws IOException {
     @After
     public void checkClusterStateIntact() throws IOException {
         assertTrue(MetaData.SETTING_READ_ONLY_SETTING.get(new PersistedClusterStateService(nodePaths, nodeId,
-            xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE, true).loadBestOnDiskState().metaData.persistentSettings()));
+            xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+            new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L, true)
+            .loadBestOnDiskState().metaData.persistentSettings()));
     }
 
     public void testFailsOnEmptyPath() {
diff --git a/server/src/test/java/org/elasticsearch/gateway/GatewayMetaStatePersistedStateTests.java b/server/src/test/java/org/elasticsearch/gateway/GatewayMetaStatePersistedStateTests.java
index 04b58ee04e219..5015f74efeeaf 100644
--- a/server/src/test/java/org/elasticsearch/gateway/GatewayMetaStatePersistedStateTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/GatewayMetaStatePersistedStateTests.java
@@ -296,7 +296,8 @@ public void testMarkAcceptedConfigAsCommitted() throws IOException {
     public void testStatePersistedOnLoad() throws IOException {
         // open LucenePersistedState to make sure that cluster state is written out to each data path
         final PersistedClusterStateService persistedClusterStateService =
-            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE);
+            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L);
         final ClusterState state = createClusterState(randomNonNegativeLong(),
             MetaData.builder().clusterUUID(randomAlphaOfLength(10)).build());
         try (GatewayMetaState.LucenePersistedState ignored = new GatewayMetaState.LucenePersistedState(
@@ -313,7 +314,8 @@ public void testStatePersistedOnLoad() throws IOException {
                 .put(Environment.PATH_DATA_SETTING.getKey(), path.toString()).build();
             try (NodeEnvironment nodeEnvironment = new NodeEnvironment(settings, TestEnvironment.newEnvironment(settings))) {
                 final PersistedClusterStateService newPersistedClusterStateService =
-                    new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE);
+                    new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                        new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L);
                 final PersistedClusterStateService.OnDiskState onDiskState = newPersistedClusterStateService.loadBestOnDiskState();
                 assertFalse(onDiskState.empty());
                 assertThat(onDiskState.currentTerm, equalTo(42L));
@@ -338,7 +340,8 @@ public void testDataOnlyNodePersistence() throws Exception {
         when(clusterService.getClusterSettings()).thenReturn(
             new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS));
         final PersistedClusterStateService persistedClusterStateService =
-            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE);
+            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L);
         gateway.start(settings, transportService, clusterService,
             new MetaStateService(nodeEnvironment, xContentRegistry()), null, null, persistedClusterStateService);
         final CoordinationState.PersistedState persistedState = gateway.getPersistedState();
@@ -420,7 +423,8 @@ public void testStatePersistenceWithIOIssues() throws IOException {
         final AtomicReference<Double> ioExceptionRate = new AtomicReference<>(0.01d);
         final List<MockDirectoryWrapper> list = new ArrayList<>();
         final PersistedClusterStateService persistedClusterStateService =
-            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE) {
+            new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L) {
                 @Override
                 Directory createDirectory(Path path) {
                     final MockDirectoryWrapper wrapper = newMockFSDirectory(path);
@@ -496,7 +500,8 @@ Directory createDirectory(Path path) {
                 .put(Environment.PATH_DATA_SETTING.getKey(), path.toString()).build();
             try (NodeEnvironment nodeEnvironment = new NodeEnvironment(settings, TestEnvironment.newEnvironment(settings))) {
                 final PersistedClusterStateService newPersistedClusterStateService =
-                    new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE);
+                    new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                        new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L);
                 final PersistedClusterStateService.OnDiskState onDiskState = newPersistedClusterStateService.loadBestOnDiskState();
                 assertFalse(onDiskState.empty());
                 assertThat(onDiskState.currentTerm, equalTo(currentTerm));
diff --git a/server/src/test/java/org/elasticsearch/gateway/IncrementalClusterStateWriterTests.java b/server/src/test/java/org/elasticsearch/gateway/IncrementalClusterStateWriterTests.java
index 86fe94587093a..5903326551ca7 100644
--- a/server/src/test/java/org/elasticsearch/gateway/IncrementalClusterStateWriterTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/IncrementalClusterStateWriterTests.java
@@ -443,12 +443,12 @@ public void testSlowLogging() throws WriteStateException, IllegalAccessException
         final long slowWriteLoggingThresholdMillis;
         final Settings settings;
         if (randomBoolean()) {
-            slowWriteLoggingThresholdMillis = IncrementalClusterStateWriter.SLOW_WRITE_LOGGING_THRESHOLD.get(Settings.EMPTY).millis();
+            slowWriteLoggingThresholdMillis = PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD.get(Settings.EMPTY).millis();
             settings = Settings.EMPTY;
         } else {
             slowWriteLoggingThresholdMillis = randomLongBetween(2, 100000);
             settings = Settings.builder()
-                .put(IncrementalClusterStateWriter.SLOW_WRITE_LOGGING_THRESHOLD.getKey(), slowWriteLoggingThresholdMillis + "ms")
+                .put(PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD.getKey(), slowWriteLoggingThresholdMillis + "ms")
                 .build();
         }
 
@@ -489,7 +489,7 @@ public void testSlowLogging() throws WriteStateException, IllegalAccessException
             "*"));
 
         clusterSettings.applySettings(Settings.builder()
-            .put(IncrementalClusterStateWriter.SLOW_WRITE_LOGGING_THRESHOLD.getKey(), writeDurationMillis.get() + "ms")
+            .put(PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD.getKey(), writeDurationMillis.get() + "ms")
             .build());
         assertExpectedLogs(clusterState, incrementalClusterStateWriter, new MockLogAppender.SeenEventExpectation(
             "should see warning at reduced threshold",
diff --git a/server/src/test/java/org/elasticsearch/gateway/PersistedClusterStateServiceTests.java b/server/src/test/java/org/elasticsearch/gateway/PersistedClusterStateServiceTests.java
index a05dc9fc560a8..ef4b5f6f7ec9e 100644
--- a/server/src/test/java/org/elasticsearch/gateway/PersistedClusterStateServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/PersistedClusterStateServiceTests.java
@@ -18,6 +18,9 @@
  */
 package org.elasticsearch.gateway;
 
+import org.apache.logging.log4j.Level;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.apache.lucene.index.IndexWriter;
 import org.apache.lucene.index.IndexWriterConfig;
 import org.apache.lucene.index.Term;
@@ -32,7 +35,11 @@
 import org.elasticsearch.cluster.coordination.CoordinationMetaData;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.common.UUIDs;
+import org.elasticsearch.common.logging.Loggers;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.util.MockBigArrays;
@@ -45,6 +52,8 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.indices.breaker.NoneCircuitBreakerService;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.MockLogAppender;
+import org.elasticsearch.test.junit.annotations.TestLogging;
 
 import java.io.IOError;
 import java.io.IOException;
@@ -55,12 +64,14 @@
 import java.util.HashSet;
 import java.util.List;
 import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.concurrent.atomic.AtomicLong;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.lessThan;
 import static org.hamcrest.Matchers.nullValue;
 
 public class PersistedClusterStateServiceTests extends ESTestCase {
@@ -69,7 +80,9 @@ private PersistedClusterStateService newPersistedClusterStateService(NodeEnviron
         return new PersistedClusterStateService(nodeEnvironment, xContentRegistry(),
             usually()
                 ? BigArrays.NON_RECYCLING_INSTANCE
-                : new MockBigArrays(new MockPageCacheRecycler(Settings.EMPTY), new NoneCircuitBreakerService()));
+                : new MockBigArrays(new MockPageCacheRecycler(Settings.EMPTY), new NoneCircuitBreakerService()),
+            new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS),
+            () -> 0L);
     }
 
     public void testPersistsAndReloadsTerm() throws IOException {
@@ -215,7 +228,8 @@ public void testFailsOnMismatchedNodeIds() throws IOException {
         // verify that loadBestOnDiskState has same check
         final String message = expectThrows(IllegalStateException.class,
             () -> new PersistedClusterStateService(combinedPaths, nodeIds[0], xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
-                randomBoolean()).loadBestOnDiskState()).getMessage();
+                new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS),
+                () -> 0L, randomBoolean()).loadBestOnDiskState()).getMessage();
         assertThat(message,
             allOf(containsString("unexpected node ID in metadata"), containsString(nodeIds[0]), containsString(nodeIds[1])));
         assertTrue("[" + message + "] should match " + Arrays.toString(dataPaths2),
@@ -342,7 +356,8 @@ public void testFailsGracefullyOnExceptionDuringFlush() throws IOException {
 
         try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
             final PersistedClusterStateService persistedClusterStateService
-                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE) {
+                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L) {
                 @Override
                 Directory createDirectory(Path path) throws IOException {
                     return new FilterDirectory(super.createDirectory(path)) {
@@ -379,7 +394,8 @@ public void testClosesWriterOnFatalError() throws IOException {
 
         try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
             final PersistedClusterStateService persistedClusterStateService
-                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE) {
+                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L) {
                 @Override
                 Directory createDirectory(Path path) throws IOException {
                     return new FilterDirectory(super.createDirectory(path)) {
@@ -424,7 +440,8 @@ public void testCrashesWithIOErrorOnCommitFailure() throws IOException {
 
         try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
             final PersistedClusterStateService persistedClusterStateService
-                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE) {
+                = new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L) {
                 @Override
                 Directory createDirectory(Path path) throws IOException {
                     return new FilterDirectory(super.createDirectory(path)) {
@@ -756,6 +773,123 @@ public void testReloadsMetadataAcrossMultipleSegments() throws IOException {
         }
     }
 
+    @TestLogging(value = "org.elasticsearch.gateway:WARN", reason = "to ensure that we log gateway events on WARN level")
+    public void testSlowLogging() throws IOException, IllegalAccessException {
+        final long slowWriteLoggingThresholdMillis;
+        final Settings settings;
+        if (randomBoolean()) {
+            slowWriteLoggingThresholdMillis = PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD.get(Settings.EMPTY).millis();
+            settings = Settings.EMPTY;
+        } else {
+            slowWriteLoggingThresholdMillis = randomLongBetween(2, 100000);
+            settings = Settings.builder()
+                .put(PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD.getKey(), slowWriteLoggingThresholdMillis + "ms")
+                .build();
+        }
+
+        final DiscoveryNode localNode = new DiscoveryNode("node", buildNewFakeTransportAddress(), Version.CURRENT);
+        final ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT)
+            .nodes(DiscoveryNodes.builder().add(localNode).localNodeId(localNode.getId())).build();
+
+        final long startTimeMillis = randomLongBetween(0L, Long.MAX_VALUE - slowWriteLoggingThresholdMillis * 10);
+        final AtomicLong currentTime = new AtomicLong(startTimeMillis);
+        final AtomicLong writeDurationMillis = new AtomicLong(slowWriteLoggingThresholdMillis);
+
+        final ClusterSettings clusterSettings = new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS);
+        try (NodeEnvironment nodeEnvironment = newNodeEnvironment(createDataPaths())) {
+            PersistedClusterStateService persistedClusterStateService = new PersistedClusterStateService(nodeEnvironment,
+                xContentRegistry(),
+                usually()
+                    ? BigArrays.NON_RECYCLING_INSTANCE
+                    : new MockBigArrays(new MockPageCacheRecycler(Settings.EMPTY), new NoneCircuitBreakerService()),
+                clusterSettings,
+                () -> currentTime.getAndAdd(writeDurationMillis.get()));
+
+            try (Writer writer = persistedClusterStateService.createWriter()) {
+                assertExpectedLogs(1L, null, clusterState, writer, new MockLogAppender.SeenEventExpectation(
+                    "should see warning at threshold",
+                    PersistedClusterStateService.class.getCanonicalName(),
+                    Level.WARN,
+                    "writing cluster state took [*] which is above the warn threshold of [*]; " +
+                        "wrote full state with [0] indices"));
+
+                writeDurationMillis.set(randomLongBetween(slowWriteLoggingThresholdMillis, slowWriteLoggingThresholdMillis * 2));
+                assertExpectedLogs(1L, null, clusterState, writer, new MockLogAppender.SeenEventExpectation(
+                    "should see warning above threshold",
+                    PersistedClusterStateService.class.getCanonicalName(),
+                    Level.WARN,
+                    "writing cluster state took [*] which is above the warn threshold of [*]; " +
+                        "wrote full state with [0] indices"));
+
+                writeDurationMillis.set(randomLongBetween(1, slowWriteLoggingThresholdMillis - 1));
+                assertExpectedLogs(1L, null, clusterState, writer, new MockLogAppender.UnseenEventExpectation(
+                    "should not see warning below threshold",
+                    PersistedClusterStateService.class.getCanonicalName(),
+                    Level.WARN,
+                    "*"));
+
+                clusterSettings.applySettings(Settings.builder()
+                    .put(PersistedClusterStateService.SLOW_WRITE_LOGGING_THRESHOLD.getKey(), writeDurationMillis.get() + "ms")
+                    .build());
+                assertExpectedLogs(1L, null, clusterState, writer, new MockLogAppender.SeenEventExpectation(
+                    "should see warning at reduced threshold",
+                    PersistedClusterStateService.class.getCanonicalName(),
+                    Level.WARN,
+                    "writing cluster state took [*] which is above the warn threshold of [*]; " +
+                        "wrote full state with [0] indices"));
+
+                final ClusterState newClusterState = ClusterState.builder(clusterState)
+                    .metaData(MetaData.builder(clusterState.metaData())
+                        .version(clusterState.version())
+                        .put(IndexMetaData.builder("test")
+                            .settings(Settings.builder()
+                                .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
+                                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
+                                .put(IndexMetaData.SETTING_INDEX_VERSION_CREATED.getKey(), Version.CURRENT)
+                                .put(IndexMetaData.SETTING_INDEX_UUID, "test-uuid"))))
+                    .incrementVersion().build();
+
+                assertExpectedLogs(1L, clusterState, newClusterState, writer, new MockLogAppender.SeenEventExpectation(
+                    "should see warning at threshold",
+                    PersistedClusterStateService.class.getCanonicalName(),
+                    Level.WARN,
+                    "writing cluster state took [*] which is above the warn threshold of [*]; " +
+                        "wrote global metadata [false] and metadata for [1] indices and skipped [0] unchanged indices"));
+
+                writeDurationMillis.set(randomLongBetween(1, writeDurationMillis.get() - 1));
+                assertExpectedLogs(1L, clusterState, newClusterState, writer, new MockLogAppender.UnseenEventExpectation(
+                    "should not see warning below threshold",
+                    PersistedClusterStateService.class.getCanonicalName(),
+                    Level.WARN,
+                    "*"));
+
+                assertThat(currentTime.get(), lessThan(startTimeMillis + 14 * slowWriteLoggingThresholdMillis)); // ensure no overflow
+            }
+        }
+    }
+
+    private void assertExpectedLogs(long currentTerm, ClusterState previousState, ClusterState clusterState,
+                                    PersistedClusterStateService.Writer writer, MockLogAppender.LoggingExpectation expectation)
+        throws IllegalAccessException, IOException {
+        MockLogAppender mockAppender = new MockLogAppender();
+        mockAppender.start();
+        mockAppender.addExpectation(expectation);
+        Logger classLogger = LogManager.getLogger(PersistedClusterStateService.class);
+        Loggers.addAppender(classLogger, mockAppender);
+
+        try {
+            if (previousState == null) {
+                writer.writeFullStateAndCommit(currentTerm, clusterState);
+            } else {
+                writer.writeIncrementalStateAndCommit(currentTerm, previousState, clusterState);
+            }
+        } finally {
+            Loggers.removeAppender(classLogger, mockAppender);
+            mockAppender.stop();
+        }
+        mockAppender.assertAllExpectationsMatched();
+    }
+
     @Override
     public Settings buildEnvSettings(Settings settings) {
         assertTrue(settings.hasValue(Environment.PATH_DATA_SETTING.getKey()));
diff --git a/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandTests.java b/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandTests.java
index 4911ff934377a..c16e0262b3a3b 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/RemoveCorruptedShardDataCommandTests.java
@@ -41,6 +41,7 @@
 import org.elasticsearch.cluster.routing.TestShardRouting;
 import org.elasticsearch.common.CheckedFunction;
 import org.elasticsearch.common.UUIDs;
+import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
@@ -151,7 +152,8 @@ public void setup() throws IOException {
         try (NodeEnvironment.NodeLock lock = new NodeEnvironment.NodeLock(logger, environment, Files::exists)) {
             final Path[] dataPaths = Arrays.stream(lock.getNodePaths()).filter(Objects::nonNull).map(p -> p.path).toArray(Path[]::new);
             try (PersistedClusterStateService.Writer writer = new PersistedClusterStateService(dataPaths, nodeId,
-                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE, true).createWriter()) {
+                xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L, true).createWriter()) {
                 writer.writeFullStateAndCommit(1L, clusterState);
             }
         }
diff --git a/test/framework/src/main/java/org/elasticsearch/cluster/coordination/AbstractCoordinatorTestCase.java b/test/framework/src/main/java/org/elasticsearch/cluster/coordination/AbstractCoordinatorTestCase.java
index 415c292142bba..5f034dea82de0 100644
--- a/test/framework/src/main/java/org/elasticsearch/cluster/coordination/AbstractCoordinatorTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/cluster/coordination/AbstractCoordinatorTestCase.java
@@ -745,7 +745,9 @@ class MockPersistedState implements CoordinationState.PersistedState {
                         final long updatedTerm = adaptCurrentTerm.apply(oldState.getCurrentTerm());
                         if (updatedMetaData != oldState.getLastAcceptedState().metaData() || updatedTerm != oldState.getCurrentTerm()) {
                             try (PersistedClusterStateService.Writer writer =
-                                     new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE)
+                                     new PersistedClusterStateService(nodeEnvironment, xContentRegistry(), BigArrays.NON_RECYCLING_INSTANCE,
+                                         new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS),
+                                         deterministicTaskQueue::getCurrentTimeMillis)
                                          .createWriter()) {
                                 writer.writeFullStateAndCommit(updatedTerm,
                                     ClusterState.builder(oldState.getLastAcceptedState()).metaData(updatedMetaData).build());
diff --git a/test/framework/src/main/java/org/elasticsearch/gateway/MockGatewayMetaState.java b/test/framework/src/main/java/org/elasticsearch/gateway/MockGatewayMetaState.java
index 25f43e28ca88c..e224c2bb40603 100644
--- a/test/framework/src/main/java/org/elasticsearch/gateway/MockGatewayMetaState.java
+++ b/test/framework/src/main/java/org/elasticsearch/gateway/MockGatewayMetaState.java
@@ -79,6 +79,7 @@ public void start(Settings settings, NodeEnvironment nodeEnvironment, NamedXCont
             throw new AssertionError(e);
         }
         start(settings, transportService, clusterService, metaStateService,
-            null, null, new PersistedClusterStateService(nodeEnvironment, xContentRegistry, BigArrays.NON_RECYCLING_INSTANCE));
+            null, null, new PersistedClusterStateService(nodeEnvironment, xContentRegistry, BigArrays.NON_RECYCLING_INSTANCE,
+                new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS), () -> 0L));
     }
 }

From 249d04074d55cc369c9ccf2ca8078d20ff6ea89e Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 14 Jan 2020 14:08:31 +0100
Subject: [PATCH 548/686] Fix queuing in AsyncLucenePersistedState (#50958)

The logic in AsyncLucenePersistedState was flawed, unexpectedly queuing up two update tasks
in parallel.
---
 .../gateway/GatewayMetaState.java             | 81 ++++++++++---------
 1 file changed, 42 insertions(+), 39 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/gateway/GatewayMetaState.java b/server/src/main/java/org/elasticsearch/gateway/GatewayMetaState.java
index 1a1d9beb85613..6fdc0b43aaa2d 100644
--- a/server/src/main/java/org/elasticsearch/gateway/GatewayMetaState.java
+++ b/server/src/main/java/org/elasticsearch/gateway/GatewayMetaState.java
@@ -44,7 +44,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
 import org.elasticsearch.common.util.concurrent.EsExecutors;
-import org.elasticsearch.common.util.concurrent.EsRejectedExecutionException;
 import org.elasticsearch.common.util.concurrent.EsThreadPoolExecutor;
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.env.NodeMetaData;
@@ -291,7 +290,9 @@ public void setCurrentTerm(long currentTerm) {
                 } else {
                     logger.trace("queuing term update (setting term to {})", currentTerm);
                     newCurrentTermQueued = true;
-                    scheduleUpdate();
+                    if (newStateQueued == false) {
+                        scheduleUpdate();
+                    }
                 }
             }
         }
@@ -305,55 +306,57 @@ public void setLastAcceptedState(ClusterState clusterState) {
                 } else {
                     logger.trace("queuing cluster state update (setting cluster state to {})", clusterState.version());
                     newStateQueued = true;
-                    scheduleUpdate();
+                    if (newCurrentTermQueued == false) {
+                        scheduleUpdate();
+                    }
                 }
             }
         }
 
         private void scheduleUpdate() {
             assert Thread.holdsLock(mutex);
-            try {
-                threadPoolExecutor.execute(new AbstractRunnable() {
+            assert threadPoolExecutor.getQueue().isEmpty() : "threadPoolExecutor queue not empty";
+            threadPoolExecutor.execute(new AbstractRunnable() {
 
-                    @Override
-                    public void onFailure(Exception e) {
-                        logger.error("Exception occurred when storing new meta data", e);
-                    }
+                @Override
+                public void onFailure(Exception e) {
+                    logger.error("Exception occurred when storing new meta data", e);
+                }
 
-                    @Override
-                    protected void doRun() {
-                        final Long term;
-                        final ClusterState clusterState;
-                        synchronized (mutex) {
-                            if (newCurrentTermQueued) {
-                                term = getCurrentTerm();
-                                newCurrentTermQueued = false;
-                            } else {
-                                term = null;
-                            }
-                            if (newStateQueued) {
-                                clusterState = getLastAcceptedState();
-                                newStateQueued = false;
-                            } else {
-                                clusterState = null;
-                            }
-                        }
-                        // write current term before last accepted state so that it is never below term in last accepted state
-                        if (term != null) {
-                            persistedState.setCurrentTerm(term);
+                @Override
+                public void onRejection(Exception e) {
+                    assert threadPoolExecutor.isShutdown() : "only expect rejections when shutting down";
+                }
+
+                @Override
+                protected void doRun() {
+                    final Long term;
+                    final ClusterState clusterState;
+                    synchronized (mutex) {
+                        if (newCurrentTermQueued) {
+                            term = getCurrentTerm();
+                            logger.trace("resetting newCurrentTermQueued");
+                            newCurrentTermQueued = false;
+                        } else {
+                            term = null;
                         }
-                        if (clusterState != null) {
-                            persistedState.setLastAcceptedState(resetVotingConfiguration(clusterState));
+                        if (newStateQueued) {
+                            clusterState = getLastAcceptedState();
+                            logger.trace("resetting newStateQueued");
+                            newStateQueued = false;
+                        } else {
+                            clusterState = null;
                         }
                     }
-                });
-            } catch (EsRejectedExecutionException e) {
-                // ignore cases where we are shutting down..., there is really nothing interesting to be done here...
-                if (threadPoolExecutor.isShutdown() == false) {
-                    assert false : "only expect rejections when shutting down";
-                    throw e;
+                    // write current term before last accepted state so that it is never below term in last accepted state
+                    if (term != null) {
+                        persistedState.setCurrentTerm(term);
+                    }
+                    if (clusterState != null) {
+                        persistedState.setLastAcceptedState(resetVotingConfiguration(clusterState));
+                    }
                 }
-            }
+            });
         }
 
         static final CoordinationMetaData.VotingConfiguration staleStateConfiguration =

From 5de2d0fc6b275fb47cd71faa8fa2205ad1382626 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Tue, 14 Jan 2020 13:12:25 +0000
Subject: [PATCH 549/686] Check for deprecations when analyzers are built
 (#50908)

Generally speaking, deprecated analysis components in elasticsearch will issue deprecation
warnings when they are first used. However, this means that no warnings are emitted when
indexes are created with deprecated components, and users have to actually index a document
to see warnings. This makes it much harder to see these warnings and act on them at
appropriate times.

This is worse in the case where components throw exceptions on upgrade. In this case, users
will not be aware of a problem until a document is indexed, instead of at index creation time.

This commit adds a new check that pushes an empty string through all user-defined analyzers
and normalizers when an IndexAnalyzers object is built for each index; deprecation warnings
and exceptions are now emitted when indexes are created or opened.

Fixes #42349
---
 .../common/CommonAnalysisPluginTests.java     |  38 +----
 .../index/analysis/AnalysisRegistry.java      |  22 +++
 .../indices/TransportAnalyzeActionTests.java  |  46 +++++-
 .../elasticsearch/index/IndexModuleTests.java |   3 +-
 .../index/analysis/AnalysisRegistryTests.java | 135 +++++++++++++++++-
 .../indices/analysis/AnalysisModuleTests.java |   5 +-
 6 files changed, 208 insertions(+), 41 deletions(-)

diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
index 90190e42f2f85..607450b9322d6 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
@@ -19,20 +19,15 @@
 
 package org.elasticsearch.analysis.common;
 
-import org.apache.lucene.analysis.MockTokenizer;
-import org.apache.lucene.analysis.Tokenizer;
 import org.elasticsearch.Version;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.env.Environment;
-import org.elasticsearch.index.analysis.TokenFilterFactory;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
 import org.elasticsearch.test.VersionUtils;
 
 import java.io.IOException;
-import java.io.StringReader;
-import java.util.Map;
 
 public class CommonAnalysisPluginTests extends ESTestCase {
 
@@ -51,13 +46,8 @@ public void testNGramFilterInCustomAnalyzerDeprecationError() throws IOException
             .build();
 
         try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
-            Map<String, TokenFilterFactory> tokenFilters = createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings),
-                    settings, commonAnalysisPlugin).tokenFilter;
-            TokenFilterFactory tokenFilterFactory = tokenFilters.get("nGram");
-            Tokenizer tokenizer = new MockTokenizer();
-            tokenizer.setReader(new StringReader("foo bar"));
-
-            IllegalArgumentException ex = expectThrows(IllegalArgumentException.class, () -> tokenFilterFactory.create(tokenizer));
+            IllegalArgumentException ex = expectThrows(IllegalArgumentException.class,
+                () -> createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings), settings, commonAnalysisPlugin));
             assertEquals("The [nGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
                     + "Please change the filter name to [ngram] instead.", ex.getMessage());
         }
@@ -69,12 +59,7 @@ public void testNGramFilterInCustomAnalyzerDeprecationError() throws IOException
                 .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram").put("index.analysis.filter.my_ngram.type", "nGram")
                 .build();
         try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
-            Map<String, TokenFilterFactory> tokenFilters = createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settingsPre7),
-                    settingsPre7, commonAnalysisPlugin).tokenFilter;
-            TokenFilterFactory tokenFilterFactory = tokenFilters.get("nGram");
-            Tokenizer tokenizer = new MockTokenizer();
-            tokenizer.setReader(new StringReader("foo bar"));
-            assertNotNull(tokenFilterFactory.create(tokenizer));
+            createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settingsPre7), settingsPre7, commonAnalysisPlugin);
             assertWarnings("The [nGram] token filter name is deprecated and will be removed in a future version. "
                     + "Please change the filter name to [ngram] instead.");
         }
@@ -95,13 +80,8 @@ public void testEdgeNGramFilterInCustomAnalyzerDeprecationError() throws IOExcep
             .build();
 
         try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
-            Map<String, TokenFilterFactory> tokenFilters = createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings),
-                    settings, commonAnalysisPlugin).tokenFilter;
-            TokenFilterFactory tokenFilterFactory = tokenFilters.get("edgeNGram");
-            Tokenizer tokenizer = new MockTokenizer();
-            tokenizer.setReader(new StringReader("foo bar"));
-
-            IllegalArgumentException ex = expectThrows(IllegalArgumentException.class, () -> tokenFilterFactory.create(tokenizer));
+            IllegalArgumentException ex = expectThrows(IllegalArgumentException.class,
+                () -> createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings), settings, commonAnalysisPlugin));
             assertEquals("The [edgeNGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
                     + "Please change the filter name to [edge_ngram] instead.", ex.getMessage());
         }
@@ -116,12 +96,8 @@ public void testEdgeNGramFilterInCustomAnalyzerDeprecationError() throws IOExcep
                 .build();
 
         try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
-            Map<String, TokenFilterFactory> tokenFilters = createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settingsPre7),
-                    settingsPre7, commonAnalysisPlugin).tokenFilter;
-            TokenFilterFactory tokenFilterFactory = tokenFilters.get("edgeNGram");
-            Tokenizer tokenizer = new MockTokenizer();
-            tokenizer.setReader(new StringReader("foo bar"));
-            assertNotNull(tokenFilterFactory.create(tokenizer));
+           createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settingsPre7),
+                    settingsPre7, commonAnalysisPlugin);
             assertWarnings("The [edgeNGram] token filter name is deprecated and will be removed in a future version. "
                     + "Please change the filter name to [edge_ngram] instead.");
         }
diff --git a/server/src/main/java/org/elasticsearch/index/analysis/AnalysisRegistry.java b/server/src/main/java/org/elasticsearch/index/analysis/AnalysisRegistry.java
index 882dcf6bb6cd9..31b343f300880 100644
--- a/server/src/main/java/org/elasticsearch/index/analysis/AnalysisRegistry.java
+++ b/server/src/main/java/org/elasticsearch/index/analysis/AnalysisRegistry.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.index.analysis;
 
 import org.apache.lucene.analysis.Analyzer;
+import org.apache.lucene.analysis.TokenStream;
 import org.apache.lucene.analysis.core.KeywordTokenizer;
 import org.apache.lucene.analysis.core.WhitespaceTokenizer;
 import org.elasticsearch.ElasticsearchException;
@@ -536,6 +537,10 @@ public IndexAnalyzers build(IndexSettings indexSettings,
                 tokenFilterFactoryFactories, charFilterFactoryFactories);
         }
 
+        for (Analyzer analyzer : normalizers.values()) {
+            analyzer.normalize("", ""); // check for deprecations
+        }
+
         if (!analyzers.containsKey(DEFAULT_ANALYZER_NAME)) {
             analyzers.put(DEFAULT_ANALYZER_NAME,
                     produceAnalyzer(DEFAULT_ANALYZER_NAME,
@@ -599,6 +604,7 @@ private static NamedAnalyzer produceAnalyzer(String name,
         } else {
             analyzer = new NamedAnalyzer(name, analyzerFactory.scope(), analyzerF, overridePositionIncrementGap);
         }
+        checkVersions(analyzer);
         return analyzer;
     }
 
@@ -626,4 +632,20 @@ private void processNormalizerFactory(
         NamedAnalyzer normalizer = new NamedAnalyzer(name, normalizerFactory.scope(), normalizerF);
         normalizers.put(name, normalizer);
     }
+
+    // Some analysis components emit deprecation warnings or throw exceptions when used
+    // with the wrong version of elasticsearch.  These exceptions and warnings are
+    // normally thrown when tokenstreams are constructed, which unless we build a
+    // tokenstream up-front does not happen until a document is indexed.  In order to
+    // surface these warnings or exceptions as early as possible, we build an empty
+    // tokenstream and pull it through an Analyzer at construction time.
+    private static void checkVersions(Analyzer analyzer) {
+        try (TokenStream ts = analyzer.tokenStream("", "")) {
+            ts.reset();
+            while (ts.incrementToken()) {}
+            ts.end();
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/TransportAnalyzeActionTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/TransportAnalyzeActionTests.java
index 23129ae546fe6..7b344bf335c88 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/TransportAnalyzeActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/TransportAnalyzeActionTests.java
@@ -38,6 +38,7 @@
 import org.elasticsearch.index.analysis.AnalysisRegistry;
 import org.elasticsearch.index.analysis.CharFilterFactory;
 import org.elasticsearch.index.analysis.IndexAnalyzers;
+import org.elasticsearch.index.analysis.NormalizingTokenFilterFactory;
 import org.elasticsearch.index.analysis.PreConfiguredCharFilter;
 import org.elasticsearch.index.analysis.TokenFilterFactory;
 import org.elasticsearch.index.analysis.TokenizerFactory;
@@ -108,6 +109,25 @@ public TokenStream create(TokenStream tokenStream) {
                 }
             }
 
+            class DeprecatedTokenFilterFactory extends AbstractTokenFilterFactory implements NormalizingTokenFilterFactory {
+
+                DeprecatedTokenFilterFactory(IndexSettings indexSettings, Environment env, String name, Settings settings) {
+                    super(indexSettings, name, settings);
+                }
+
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    deprecationLogger.deprecated("Using deprecated token filter [deprecated]");
+                    return tokenStream;
+                }
+
+                @Override
+                public TokenStream normalize(TokenStream tokenStream) {
+                    deprecationLogger.deprecated("Using deprecated token filter [deprecated]");
+                    return tokenStream;
+                }
+            }
+
             class AppendCharFilterFactory extends AbstractCharFilterFactory {
 
                 final String suffix;
@@ -136,7 +156,7 @@ public Map<String, AnalysisProvider<TokenizerFactory>> getTokenizers() {
 
             @Override
             public Map<String, AnalysisProvider<TokenFilterFactory>> getTokenFilters() {
-                return singletonMap("mock", MockFactory::new);
+                return Map.of("mock", MockFactory::new, "deprecated", DeprecatedTokenFilterFactory::new);
             }
 
             @Override
@@ -492,4 +512,28 @@ public void testExceedSetMaxTokenLimit() {
         assertEquals(e.getMessage(), "The number of tokens produced by calling _analyze has exceeded the allowed maximum of ["
             + idxMaxTokenCount + "]." + " This limit can be set by changing the [index.analyze.max_token_count] index level setting.");
     }
+
+    public void testDeprecationWarnings() throws IOException {
+        AnalyzeAction.Request req = new AnalyzeAction.Request();
+        req.tokenizer("standard");
+        req.addTokenFilter("lowercase");
+        req.addTokenFilter("deprecated");
+        req.text("test text");
+
+        AnalyzeAction.Response analyze =
+            TransportAnalyzeAction.analyze(req, registry, mockIndexService(), maxTokenCount);
+        assertEquals(2, analyze.getTokens().size());
+        assertWarnings("Using deprecated token filter [deprecated]");
+
+        // normalizer
+        req = new AnalyzeAction.Request();
+        req.addTokenFilter("lowercase");
+        req.addTokenFilter("deprecated");
+        req.text("text");
+
+        analyze =
+            TransportAnalyzeAction.analyze(req, registry, mockIndexService(), maxTokenCount);
+        assertEquals(1, analyze.getTokens().size());
+        assertWarnings("Using deprecated token filter [deprecated]");
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/IndexModuleTests.java b/server/src/test/java/org/elasticsearch/index/IndexModuleTests.java
index adeb49faa8941..2c11b26580f3d 100644
--- a/server/src/test/java/org/elasticsearch/index/IndexModuleTests.java
+++ b/server/src/test/java/org/elasticsearch/index/IndexModuleTests.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.index;
 
 import org.apache.lucene.analysis.Analyzer;
+import org.apache.lucene.analysis.standard.StandardTokenizer;
 import org.apache.lucene.index.AssertingDirectoryReader;
 import org.apache.lucene.index.DirectoryReader;
 import org.apache.lucene.index.FieldInvertState;
@@ -442,7 +443,7 @@ public Analyzer get() {
                 final Analyzer analyzer = new Analyzer() {
                     @Override
                     protected TokenStreamComponents createComponents(String fieldName) {
-                        throw new AssertionError("should not be here");
+                        return new TokenStreamComponents(new StandardTokenizer());
                     }
 
                     @Override
diff --git a/server/src/test/java/org/elasticsearch/index/analysis/AnalysisRegistryTests.java b/server/src/test/java/org/elasticsearch/index/analysis/AnalysisRegistryTests.java
index f7df2ee97f932..4a156db4f2101 100644
--- a/server/src/test/java/org/elasticsearch/index/analysis/AnalysisRegistryTests.java
+++ b/server/src/test/java/org/elasticsearch/index/analysis/AnalysisRegistryTests.java
@@ -20,12 +20,13 @@
 package org.elasticsearch.index.analysis;
 
 import com.carrotsearch.randomizedtesting.generators.RandomPicks;
-
 import org.apache.lucene.analysis.Analyzer;
 import org.apache.lucene.analysis.MockTokenFilter;
 import org.apache.lucene.analysis.TokenStream;
+import org.apache.lucene.analysis.Tokenizer;
 import org.apache.lucene.analysis.en.EnglishAnalyzer;
 import org.apache.lucene.analysis.standard.StandardAnalyzer;
+import org.apache.lucene.analysis.standard.StandardTokenizer;
 import org.apache.lucene.analysis.tokenattributes.CharTermAttribute;
 import org.elasticsearch.Version;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
@@ -108,8 +109,8 @@ public void testOverrideDefaultAnalyzer() throws IOException {
     public void testOverrideDefaultAnalyzerWithoutAnalysisModeAll() throws IOException {
         Version version = VersionUtils.randomVersion(random());
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
-        TokenFilterFactory tokenFilter = new AbstractTokenFilterFactory(IndexSettingsModule.newIndexSettings("index", settings),
-                "my_filter", Settings.EMPTY) {
+        IndexSettings indexSettings = IndexSettingsModule.newIndexSettings("index", settings);
+        TokenFilterFactory tokenFilter = new AbstractTokenFilterFactory(indexSettings, "my_filter", Settings.EMPTY) {
             @Override
             public AnalysisMode getAnalysisMode() {
                 return randomFrom(AnalysisMode.SEARCH_TIME, AnalysisMode.INDEX_TIME);
@@ -117,10 +118,16 @@ public AnalysisMode getAnalysisMode() {
 
             @Override
             public TokenStream create(TokenStream tokenStream) {
-                return null;
+                return tokenStream;
             }
         };
-        Analyzer analyzer = new CustomAnalyzer(null, new CharFilterFactory[0], new TokenFilterFactory[] { tokenFilter });
+        TokenizerFactory tokenizer = new AbstractTokenizerFactory(indexSettings, Settings.EMPTY, "my_tokenizer") {
+            @Override
+            public Tokenizer create() {
+                return new StandardTokenizer();
+            }
+        };
+        Analyzer analyzer = new CustomAnalyzer(tokenizer, new CharFilterFactory[0], new TokenFilterFactory[] { tokenFilter });
         MapperException ex = expectThrows(MapperException.class,
                 () -> emptyRegistry.build(IndexSettingsModule.newIndexSettings("index", settings),
                         singletonMap("default", new PreBuiltAnalyzerProvider("default", AnalyzerScope.INDEX, analyzer)), emptyMap(),
@@ -264,4 +271,122 @@ public void testEnsureCloseInvocationProperlyDelegated() throws IOException {
         registry.close();
         verify(mock).close();
     }
+
+    public void testDeprecationsAndExceptions() throws IOException {
+
+        AnalysisPlugin plugin = new AnalysisPlugin() {
+
+            class MockFactory extends AbstractTokenFilterFactory {
+                MockFactory(IndexSettings indexSettings, Environment env, String name, Settings settings) {
+                    super(indexSettings, name, settings);
+                }
+
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    if (indexSettings.getIndexVersionCreated().equals(Version.CURRENT)) {
+                        deprecationLogger.deprecated("Using deprecated token filter [deprecated]");
+                    }
+                    return tokenStream;
+                }
+            }
+
+            class ExceptionFactory extends AbstractTokenFilterFactory {
+
+                ExceptionFactory(IndexSettings indexSettings, Environment env, String name, Settings settings) {
+                    super(indexSettings, name, settings);
+                }
+
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    if (indexSettings.getIndexVersionCreated().equals(Version.CURRENT)) {
+                        throw new IllegalArgumentException("Cannot use token filter [exception]");
+                    }
+                    return tokenStream;
+                }
+            }
+
+            class UnusedMockFactory extends AbstractTokenFilterFactory {
+                UnusedMockFactory(IndexSettings indexSettings, Environment env, String name, Settings settings) {
+                    super(indexSettings, name, settings);
+                }
+
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    deprecationLogger.deprecated("Using deprecated token filter [unused]");
+                    return tokenStream;
+                }
+            }
+
+            class NormalizerFactory extends AbstractTokenFilterFactory implements NormalizingTokenFilterFactory {
+
+                NormalizerFactory(IndexSettings indexSettings, Environment env, String name, Settings settings) {
+                    super(indexSettings, name, settings);
+                }
+
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    deprecationLogger.deprecated("Using deprecated token filter [deprecated_normalizer]");
+                    return tokenStream;
+                }
+
+            }
+
+            @Override
+            public Map<String, AnalysisProvider<TokenFilterFactory>> getTokenFilters() {
+                return Map.of("deprecated", MockFactory::new, "unused", UnusedMockFactory::new,
+                    "deprecated_normalizer", NormalizerFactory::new, "exception", ExceptionFactory::new);
+            }
+        };
+
+        Settings settings = Settings.builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString()).build();
+        Settings indexSettings = Settings.builder()
+            .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
+            .put("index.analysis.filter.deprecated.type", "deprecated")
+            .put("index.analysis.analyzer.custom.tokenizer", "standard")
+            .putList("index.analysis.analyzer.custom.filter", "lowercase", "deprecated")
+            .build();
+
+        IndexSettings idxSettings = IndexSettingsModule.newIndexSettings("index", indexSettings);
+
+        new AnalysisModule(TestEnvironment.newEnvironment(settings),
+            singletonList(plugin)).getAnalysisRegistry().build(idxSettings);
+
+        // We should only get a warning from the token filter that is referenced in settings
+        assertWarnings("Using deprecated token filter [deprecated]");
+
+        indexSettings = Settings.builder()
+            .put(IndexMetaData.SETTING_VERSION_CREATED, VersionUtils.getPreviousVersion())
+            .put("index.analysis.filter.deprecated.type", "deprecated_normalizer")
+            .putList("index.analysis.normalizer.custom.filter", "lowercase", "deprecated_normalizer")
+            .put("index.analysis.filter.deprecated.type", "deprecated")
+            .put("index.analysis.filter.exception.type", "exception")
+            .put("index.analysis.analyzer.custom.tokenizer", "standard")
+            // exception will not throw because we're not on Version.CURRENT
+            .putList("index.analysis.analyzer.custom.filter", "lowercase", "deprecated", "exception")
+            .build();
+        idxSettings = IndexSettingsModule.newIndexSettings("index", indexSettings);
+
+        new AnalysisModule(TestEnvironment.newEnvironment(settings),
+            singletonList(plugin)).getAnalysisRegistry().build(idxSettings);
+
+        // We should only get a warning from the normalizer, because we're on a version where 'deprecated'
+        // works fine
+        assertWarnings("Using deprecated token filter [deprecated_normalizer]");
+
+        indexSettings = Settings.builder()
+            .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
+            .put("index.analysis.filter.exception.type", "exception")
+            .put("index.analysis.analyzer.custom.tokenizer", "standard")
+            // exception will not throw because we're not on Version.LATEST
+            .putList("index.analysis.analyzer.custom.filter", "lowercase", "exception")
+            .build();
+        IndexSettings exceptionSettings = IndexSettingsModule.newIndexSettings("index", indexSettings);
+
+        IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> {
+            new AnalysisModule(TestEnvironment.newEnvironment(settings),
+                singletonList(plugin)).getAnalysisRegistry().build(exceptionSettings);
+        });
+        assertEquals("Cannot use token filter [exception]", e.getMessage());
+
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/indices/analysis/AnalysisModuleTests.java b/server/src/test/java/org/elasticsearch/indices/analysis/AnalysisModuleTests.java
index 675305a17cce6..3c8455224e646 100644
--- a/server/src/test/java/org/elasticsearch/indices/analysis/AnalysisModuleTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/analysis/AnalysisModuleTests.java
@@ -228,14 +228,13 @@ public void testUnderscoreInAnalyzerName() throws IOException {
         }
     }
 
-    public void testStandardFilterBWC() throws IOException {
+    public void testStandardFilterBWC() {
         Version version = VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.CURRENT);
         final Settings settings = Settings.builder().put("index.analysis.analyzer.my_standard.tokenizer", "standard")
                 .put("index.analysis.analyzer.my_standard.filter", "standard")
                 .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString()).put(IndexMetaData.SETTING_VERSION_CREATED, version)
                 .build();
-        IndexAnalyzers analyzers = getIndexAnalyzers(settings);
-        IllegalArgumentException exc = expectThrows(IllegalArgumentException.class, () -> analyzers.get("my_standard").tokenStream("", ""));
+        IllegalArgumentException exc = expectThrows(IllegalArgumentException.class, () -> getIndexAnalyzers(settings));
         assertThat(exc.getMessage(), equalTo("The [standard] token filter has been removed."));
     }
 

From 830e61652fd30160c2ddbe023a62fe8494168e26 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Tue, 14 Jan 2020 15:18:13 +0200
Subject: [PATCH 550/686] [ML] Mute data frame analytics BWC tests (#50972)

Until #50914 is backported to 7.x
---
 .../test/mixed_cluster/90_ml_data_frame_analytics_crud.yml   | 5 +++++
 .../test/old_cluster/90_ml_data_frame_analytics_crud.yml     | 3 +++
 .../upgraded_cluster/90_ml_data_frame_analytics_crud.yml     | 5 +++++
 3 files changed, 13 insertions(+)

diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
index af304afc57db6..053ebf77984ae 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,3 +1,8 @@
+setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/pull/50914"
+
 ---
 "Get old outlier_detection job":
 
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
index fe160bba15f23..de24432b4d091 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,4 +1,7 @@
 setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/pull/50914"
 
   - do:
       index:
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
index 14438883f0da1..7a3d44fff1aa7 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,3 +1,8 @@
+setup:
+  - skip:
+      version: "all"
+      reason:  "Until backport of https://github.com/elastic/elasticsearch/pull/50914"
+
 ---
 "Get old cluster outlier_detection job":
 

From 9fa42ab6b563f6094f30ddd4ce822eded9696a50 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Tue, 14 Jan 2020 08:21:32 -0500
Subject: [PATCH 551/686] [DOCS] Use `s` parameter in cat API overview example
 (#50616)

Updates a snippet to use the `s` query string parameter rather than
piping the output to a separate `sort` command.

This ensures the snippet is tested and available in clients other than
curl (Kibana console, etc.).

Issue was originally raised by @hackaholic in #40926.
---
 docs/reference/cat.asciidoc | 31 +++++++++++++++++++++----------
 1 file changed, 21 insertions(+), 10 deletions(-)

diff --git a/docs/reference/cat.asciidoc b/docs/reference/cat.asciidoc
index 50d3028101dd0..1d6601ed3b7b1 100644
--- a/docs/reference/cat.asciidoc
+++ b/docs/reference/cat.asciidoc
@@ -102,19 +102,30 @@ order is important, you can change it.
 
 Say you want to find the largest index in your cluster (storage used
 by all the shards, not number of documents).  The `/_cat/indices` API
-is ideal.  We only need to tweak two things.  First, we want to turn
-off human mode.  We'll use a byte-level resolution.  Then we'll pipe
-our output into `sort` using the appropriate column, which in this
-case is the eighth one.
+is ideal.  You only need to add three things to the API request:
 
-[source,sh]
+. The `bytes` query string parameter with a value of `b` to get byte-level resolution.
+. The `s` (sort) parameter with a value of `store.size:desc` to sort the output
+by shard storage in descending order.
+. The `v` (verbose) parameter to include column headings in the response.
+
+[source,console]
 --------------------------------------------------
-% curl '192.168.56.10:9200/_cat/indices?bytes=b' | sort -rnk8
-green wiki2 3 0 10000   0 105274918 105274918
-green wiki1 3 0 10000 413 103776272 103776272
-green foo   1 0   227   0   2065131   2065131
+GET /_cat/indices?bytes=b&s=store.size:desc&v
 --------------------------------------------------
-// NOTCONSOLE
+// TEST[setup:huge_twitter]
+// TEST[s/^/PUT twitter2\n{"settings": {"number_of_replicas": 0}}\n/]
+
+The API returns the following response:
+
+[source,txt]
+--------------------------------------------------
+health status index    uuid                   pri rep docs.count docs.deleted store.size pri.store.size
+yellow open   twitter  u8FNjxh8Rfy_awN11oDKYQ   1   1       1200            0      72171         72171
+green  open   twitter2 nYFWZEO7TUiOjLQXBaYJpA   1   0          0            0        230          230
+--------------------------------------------------
+// TESTRESPONSE[s/72171|230/\\d+/]
+// TESTRESPONSE[s/u8FNjxh8Rfy_awN11oDKYQ|nYFWZEO7TUiOjLQXBaYJpA/.+/ non_json]
 
 If you want to change the <<time-units,time units>>, use `time` parameter.
 

From cd5ac8e3eb4fb4728a2d512f1c1766538ce855d8 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 14 Jan 2020 14:38:33 +0100
Subject: [PATCH 552/686] Work around JVM Bug in LongGCDisruptionTests (#50731)

There is a JVM bug causing `Thread#suspend` calls to randomly take
multiple seconds breaking these tests that call the method numerous times
in a loop. Increasing the timeout would will not work since we may call
`suspend` tens if not hundreds of times and even a small number of them
experiencing the blocking will lead to multiple minutes of waiting.

This PR detects the specific issue by timing the `Thread#suspend` calls and
skips the remainder of the test if it timed out because of the JVM bug.

Closes #50047
---
 .../test/disruption/LongGCDisruption.java      | 18 ++++++++++++++++++
 .../test/disruption/LongGCDisruptionTests.java | 13 +++++++++----
 2 files changed, 27 insertions(+), 4 deletions(-)

diff --git a/test/framework/src/main/java/org/elasticsearch/test/disruption/LongGCDisruption.java b/test/framework/src/main/java/org/elasticsearch/test/disruption/LongGCDisruption.java
index 61b4349ba3fe3..d9fe62b8f478c 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/disruption/LongGCDisruption.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/disruption/LongGCDisruption.java
@@ -32,6 +32,8 @@
 import java.util.Random;
 import java.util.Set;
 import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.regex.Pattern;
 import java.util.stream.Collectors;
@@ -56,11 +58,23 @@ public class LongGCDisruption extends SingleNodeDisruption {
     private Set<Thread> suspendedThreads;
     private Thread blockDetectionThread;
 
+    private final AtomicBoolean sawSlowSuspendBug = new AtomicBoolean(false);
+
     public LongGCDisruption(Random random, String disruptedNode) {
         super(random);
         this.disruptedNode = disruptedNode;
     }
 
+    /**
+     * Checks if during disruption we ran into a known JVM issue that makes {@link Thread#suspend()} calls block for multiple seconds
+     * was observed.
+     * @see <a href=https://bugs.openjdk.java.net/browse/JDK-8218446>JDK-8218446</a>
+     * @return true if during thread suspending a call to {@link Thread#suspend()} took more than 3s
+     */
+    public boolean sawSlowSuspendBug() {
+        return sawSlowSuspendBug.get();
+    }
+
     @Override
     public synchronized void startDisrupting() {
         if (suspendedThreads == null) {
@@ -251,7 +265,11 @@ protected boolean suspendThreads(Set<Thread> nodeThreads) {
                          * assuming that it is safe.
                          */
                         boolean definitelySafe = true;
+                        final long startTime = System.nanoTime();
                         thread.suspend();
+                        if (System.nanoTime() - startTime > TimeUnit.SECONDS.toNanos(3L)) {
+                            sawSlowSuspendBug.set(true);
+                        }
                         // double check the thread is not in a shared resource like logging; if so, let it go and come back
                         safe:
                         for (StackTraceElement stackElement : thread.getStackTrace()) {
diff --git a/test/framework/src/test/java/org/elasticsearch/test/disruption/LongGCDisruptionTests.java b/test/framework/src/test/java/org/elasticsearch/test/disruption/LongGCDisruptionTests.java
index 2021c1d7fab08..992b9617fb9d9 100644
--- a/test/framework/src/test/java/org/elasticsearch/test/disruption/LongGCDisruptionTests.java
+++ b/test/framework/src/test/java/org/elasticsearch/test/disruption/LongGCDisruptionTests.java
@@ -18,7 +18,6 @@
  */
 package org.elasticsearch.test.disruption;
 
-import org.elasticsearch.bootstrap.JavaVersion;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.test.ESTestCase;
 
@@ -115,8 +114,6 @@ protected long getSuspendingTimeoutInMillis() {
      * but does keep retrying until all threads can be safely paused
      */
     public void testNotBlockingUnsafeStackTraces() throws Exception {
-        assumeFalse("https://github.com/elastic/elasticsearch/issues/50047",
-            JavaVersion.current().equals(JavaVersion.parse("11")) || JavaVersion.current().equals(JavaVersion.parse("12")));
         final String nodeName = "test_node";
         LongGCDisruption disruption = new LongGCDisruption(random(), nodeName) {
             @Override
@@ -149,7 +146,14 @@ protected Pattern[] getUnsafeClasses() {
                 threads[i].start();
             }
             // make sure some threads are under lock
-            disruption.startDisrupting();
+            try {
+                disruption.startDisrupting();
+            } catch (RuntimeException e) {
+                if (e.getMessage().contains("suspending node threads took too long") && disruption.sawSlowSuspendBug()) {
+                    return;
+                }
+                throw new AssertionError(e);
+            }
             long first = ops.get();
             assertThat(lockedExecutor.lock.isLocked(), equalTo(false)); // no threads should own the lock
             Thread.sleep(100);
@@ -157,6 +161,7 @@ protected Pattern[] getUnsafeClasses() {
             disruption.stopDisrupting();
             assertBusy(() -> assertThat(ops.get(), greaterThan(first)));
         } finally {
+            disruption.stopDisrupting();
             stop.set(true);
             for (final Thread thread : threads) {
                 thread.join();

From 91d7e328f47dd32dade4a99ad46b7082c5d3e234 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Tue, 14 Jan 2020 09:23:15 -0500
Subject: [PATCH 553/686] Begin moving date_histogram to offset rounding
 (#50873)

We added a new rounding in #50609 that handles offsets to the start and
end of the rounding so that we could support `offset` in the `composite`
aggregation. This starts moving `date_histogram` to that new offset.
---
 .../org/elasticsearch/common/Rounding.java    | 46 ++++++++++++++++++-
 .../DateHistogramAggregationBuilder.java      |  6 +--
 .../histogram/DateHistogramAggregator.java    | 12 ++---
 .../DateHistogramAggregatorFactory.java       |  8 ++--
 .../DateRangeHistogramAggregator.java         | 18 +++-----
 .../bucket/histogram/ExtendedBounds.java      |  6 ++-
 .../histogram/InternalDateHistogram.java      |  2 +-
 .../elasticsearch/common/RoundingTests.java   |  8 ++++
 .../PipelineAggregationHelperTests.java       |  2 +-
 .../CumulativeCardinalityAggregatorTests.java |  2 +-
 10 files changed, 77 insertions(+), 33 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/common/Rounding.java b/server/src/main/java/org/elasticsearch/common/Rounding.java
index e36a8fa45d581..37e89389bba92 100644
--- a/server/src/main/java/org/elasticsearch/common/Rounding.java
+++ b/server/src/main/java/org/elasticsearch/common/Rounding.java
@@ -164,6 +164,19 @@ public void writeTo(StreamOutput out) throws IOException {
      */
     public abstract long nextRoundingValue(long value);
 
+    /**
+     * How "offset" this rounding is from the traditional "start" of the period.
+     * @deprecated We're in the process of abstracting offset *into* Rounding
+     *             so keep any usage to migratory shims
+     */
+    @Deprecated
+    public abstract long offset();
+
+    /**
+     * Strip the {@code offset} from these bounds.
+     */
+    public abstract Rounding withoutOffset();
+
     @Override
     public abstract boolean equals(Object obj);
 
@@ -420,6 +433,16 @@ public long nextRoundingValue(long utcMillis) {
             }
         }
 
+        @Override
+        public long offset() {
+            return 0;
+        }
+
+        @Override
+        public Rounding withoutOffset() {
+            return this;
+        }
+
         @Override
         public int hashCode() {
             return Objects.hash(unit, timeZone);
@@ -546,6 +569,16 @@ public long nextRoundingValue(long time) {
                 .toInstant().toEpochMilli();
         }
 
+        @Override
+        public long offset() {
+            return 0;
+        }
+
+        @Override
+        public Rounding withoutOffset() {
+            return this;
+        }
+
         @Override
         public int hashCode() {
             return Objects.hash(interval, timeZone);
@@ -607,8 +640,17 @@ public long round(long value) {
 
         @Override
         public long nextRoundingValue(long value) {
-            // This isn't needed by the current users. We'll implement it when we migrate other users to it.
-            throw new UnsupportedOperationException("not yet supported");
+            return delegate.nextRoundingValue(value - offset) + offset;
+        }
+
+        @Override
+        public long offset() {
+            return offset;
+        }
+
+        @Override
+        public Rounding withoutOffset() {
+            return delegate;
         }
 
         @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
index 0c66e17add645..861e3269ace6c 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregationBuilder.java
@@ -494,13 +494,13 @@ protected ValuesSourceAggregatorFactory<ValuesSource> innerBuild(QueryShardConte
                                                                         Builder subFactoriesBuilder) throws IOException {
         final ZoneId tz = timeZone();
         // TODO use offset here rather than explicitly in the aggregation
-        final Rounding rounding = dateHistogramInterval.createRounding(tz, 0);
+        final Rounding rounding = dateHistogramInterval.createRounding(tz, offset);
         final ZoneId rewrittenTimeZone = rewriteTimeZone(queryShardContext);
         final Rounding shardRounding;
         if (tz == rewrittenTimeZone) {
             shardRounding = rounding;
         } else {
-            shardRounding = dateHistogramInterval.createRounding(rewrittenTimeZone, 0);
+            shardRounding = dateHistogramInterval.createRounding(rewrittenTimeZone, offset);
         }
 
         ExtendedBounds roundedBounds = null;
@@ -508,7 +508,7 @@ protected ValuesSourceAggregatorFactory<ValuesSource> innerBuild(QueryShardConte
             // parse any string bounds to longs and round
             roundedBounds = this.extendedBounds.parseAndValidate(name, queryShardContext, config.format()).round(rounding);
         }
-        return new DateHistogramAggregatorFactory(name, config, offset, order, keyed, minDocCount,
+        return new DateHistogramAggregatorFactory(name, config, order, keyed, minDocCount,
                 rounding, shardRounding, roundedBounds, queryShardContext, parent, subFactoriesBuilder, metaData);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregator.java
index 0c7a91505ae88..8479ea066aa50 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregator.java
@@ -64,10 +64,9 @@ class DateHistogramAggregator extends BucketsAggregator {
     private final ExtendedBounds extendedBounds;
 
     private final LongHash bucketOrds;
-    private long offset;
 
     DateHistogramAggregator(String name, AggregatorFactories factories, Rounding rounding, Rounding shardRounding,
-            long offset, BucketOrder order, boolean keyed,
+            BucketOrder order, boolean keyed,
             long minDocCount, @Nullable ExtendedBounds extendedBounds, @Nullable ValuesSource.Numeric valuesSource,
             DocValueFormat formatter, SearchContext aggregationContext,
             Aggregator parent, List<PipelineAggregator> pipelineAggregators, Map<String, Object> metaData) throws IOException {
@@ -75,7 +74,6 @@ class DateHistogramAggregator extends BucketsAggregator {
         super(name, factories, aggregationContext, parent, pipelineAggregators, metaData);
         this.rounding = rounding;
         this.shardRounding = shardRounding;
-        this.offset = offset;
         this.order = InternalOrder.validate(order, this);
         this.keyed = keyed;
         this.minDocCount = minDocCount;
@@ -113,7 +111,7 @@ public void collect(int doc, long bucket) throws IOException {
                         long value = values.nextValue();
                         // We can use shardRounding here, which is sometimes more efficient
                         // if daylight saving times are involved.
-                        long rounded = shardRounding.round(value - offset) + offset;
+                        long rounded = shardRounding.round(value);
                         assert rounded >= previousRounded;
                         if (rounded == previousRounded) {
                             continue;
@@ -150,7 +148,7 @@ public InternalAggregation buildAggregation(long owningBucketOrdinal) throws IOE
         InternalDateHistogram.EmptyBucketInfo emptyBucketInfo = minDocCount == 0
                 ? new InternalDateHistogram.EmptyBucketInfo(rounding, buildEmptySubAggregations(), extendedBounds)
                 : null;
-        return new InternalDateHistogram(name, buckets, order, minDocCount, offset, emptyBucketInfo, formatter, keyed,
+        return new InternalDateHistogram(name, buckets, order, minDocCount, rounding.offset(), emptyBucketInfo, formatter, keyed,
                 pipelineAggregators(), metaData());
     }
 
@@ -159,8 +157,8 @@ public InternalAggregation buildEmptyAggregation() {
         InternalDateHistogram.EmptyBucketInfo emptyBucketInfo = minDocCount == 0
                 ? new InternalDateHistogram.EmptyBucketInfo(rounding, buildEmptySubAggregations(), extendedBounds)
                 : null;
-        return new InternalDateHistogram(name, Collections.emptyList(), order, minDocCount, offset, emptyBucketInfo, formatter, keyed,
-                pipelineAggregators(), metaData());
+        return new InternalDateHistogram(name, Collections.emptyList(), order, minDocCount, rounding.offset(), emptyBucketInfo, formatter,
+                keyed, pipelineAggregators(), metaData());
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorFactory.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorFactory.java
index 86555767e25ea..d68cf814f32bc 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorFactory.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorFactory.java
@@ -39,7 +39,6 @@
 public final class DateHistogramAggregatorFactory
         extends ValuesSourceAggregatorFactory<ValuesSource> {
 
-    private final long offset;
     private final BucketOrder order;
     private final boolean keyed;
     private final long minDocCount;
@@ -48,12 +47,11 @@ public final class DateHistogramAggregatorFactory
     private final Rounding shardRounding;
 
     public DateHistogramAggregatorFactory(String name, ValuesSourceConfig<ValuesSource> config,
-            long offset, BucketOrder order, boolean keyed, long minDocCount,
+            BucketOrder order, boolean keyed, long minDocCount,
             Rounding rounding, Rounding shardRounding, ExtendedBounds extendedBounds, QueryShardContext queryShardContext,
             AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder,
             Map<String, Object> metaData) throws IOException {
         super(name, config, queryShardContext, parent, subFactoriesBuilder, metaData);
-        this.offset = offset;
         this.order = order;
         this.keyed = keyed;
         this.minDocCount = minDocCount;
@@ -104,7 +102,7 @@ protected Aggregator doCreateInternal(ValuesSource valuesSource,
     private Aggregator createAggregator(ValuesSource.Numeric valuesSource, SearchContext searchContext,
                                         Aggregator parent, List<PipelineAggregator> pipelineAggregators,
             Map<String, Object> metaData) throws IOException {
-        return new DateHistogramAggregator(name, factories, rounding, shardRounding, offset, order, keyed, minDocCount, extendedBounds,
+        return new DateHistogramAggregator(name, factories, rounding, shardRounding, order, keyed, minDocCount, extendedBounds,
                 valuesSource, config.format(), searchContext, parent, pipelineAggregators, metaData);
     }
 
@@ -113,7 +111,7 @@ private Aggregator createRangeAggregator(ValuesSource.Range valuesSource,
                                              Aggregator parent,
                                              List<PipelineAggregator> pipelineAggregators,
                                              Map<String, Object> metaData) throws IOException {
-        return new DateRangeHistogramAggregator(name, factories, rounding, shardRounding, offset, order, keyed, minDocCount, extendedBounds,
+        return new DateRangeHistogramAggregator(name, factories, rounding, shardRounding, order, keyed, minDocCount, extendedBounds,
             valuesSource, config.format(), searchContext, parent, pipelineAggregators, metaData);
     }
 
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateRangeHistogramAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateRangeHistogramAggregator.java
index 9eed2a542f9dd..9c6417165ab30 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateRangeHistogramAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateRangeHistogramAggregator.java
@@ -67,10 +67,9 @@ class DateRangeHistogramAggregator extends BucketsAggregator {
     private final ExtendedBounds extendedBounds;
 
     private final LongHash bucketOrds;
-    private long offset;
 
     DateRangeHistogramAggregator(String name, AggregatorFactories factories, Rounding rounding, Rounding shardRounding,
-                                 long offset, BucketOrder order, boolean keyed,
+                                 BucketOrder order, boolean keyed,
                                  long minDocCount, @Nullable ExtendedBounds extendedBounds, @Nullable ValuesSource.Range valuesSource,
                                  DocValueFormat formatter, SearchContext aggregationContext,
                                  Aggregator parent, List<PipelineAggregator> pipelineAggregators,
@@ -79,7 +78,6 @@ class DateRangeHistogramAggregator extends BucketsAggregator {
         super(name, factories, aggregationContext, parent, pipelineAggregators, metaData);
         this.rounding = rounding;
         this.shardRounding = shardRounding;
-        this.offset = offset;
         this.order = InternalOrder.validate(order, this);
         this.keyed = keyed;
         this.minDocCount = minDocCount;
@@ -126,8 +124,8 @@ public void collect(int doc, long bucket) throws IOException {
                             // The encoding should ensure that this assert is always true.
                             assert from >= previousFrom : "Start of range not >= previous start";
                             final Long to = (Long) range.getTo();
-                            final long startKey = offsetAwareRounding(shardRounding, from, offset);
-                            final long endKey = offsetAwareRounding(shardRounding, to, offset);
+                            final long startKey = shardRounding.round(from);
+                            final long endKey = shardRounding.round(to);
                             for (long  key = startKey > previousKey ? startKey : previousKey; key <= endKey;
                                  key = shardRounding.nextRoundingValue(key)) {
                                 if (key == previousKey) {
@@ -153,10 +151,6 @@ public void collect(int doc, long bucket) throws IOException {
         };
     }
 
-    private long offsetAwareRounding(Rounding rounding, long value, long offset) {
-        return rounding.round(value - offset) + offset;
-    }
-
     @Override
     public InternalAggregation buildAggregation(long owningBucketOrdinal) throws IOException {
         assert owningBucketOrdinal == 0;
@@ -175,7 +169,7 @@ public InternalAggregation buildAggregation(long owningBucketOrdinal) throws IOE
         InternalDateHistogram.EmptyBucketInfo emptyBucketInfo = minDocCount == 0
                 ? new InternalDateHistogram.EmptyBucketInfo(rounding, buildEmptySubAggregations(), extendedBounds)
                 : null;
-        return new InternalDateHistogram(name, buckets, order, minDocCount, offset, emptyBucketInfo, formatter, keyed,
+        return new InternalDateHistogram(name, buckets, order, minDocCount, rounding.offset(), emptyBucketInfo, formatter, keyed,
                 pipelineAggregators(), metaData());
     }
 
@@ -184,8 +178,8 @@ public InternalAggregation buildEmptyAggregation() {
         InternalDateHistogram.EmptyBucketInfo emptyBucketInfo = minDocCount == 0
                 ? new InternalDateHistogram.EmptyBucketInfo(rounding, buildEmptySubAggregations(), extendedBounds)
                 : null;
-        return new InternalDateHistogram(name, Collections.emptyList(), order, minDocCount, offset, emptyBucketInfo, formatter, keyed,
-                pipelineAggregators(), metaData());
+        return new InternalDateHistogram(name, Collections.emptyList(), order, minDocCount, rounding.offset(), emptyBucketInfo, formatter,
+                keyed, pipelineAggregators(), metaData());
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ExtendedBounds.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ExtendedBounds.java
index dc20ff291e0d1..4a9deb9bdedfc 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ExtendedBounds.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/ExtendedBounds.java
@@ -166,7 +166,11 @@ ExtendedBounds parseAndValidate(String aggName, QueryShardContext queryShardCont
     }
 
     ExtendedBounds round(Rounding rounding) {
-        return new ExtendedBounds(min != null ? rounding.round(min) : null, max != null ? rounding.round(max) : null);
+        // Extended bounds shouldn't be effected by the offset
+        Rounding effectiveRounding = rounding.withoutOffset();
+        return new ExtendedBounds(
+                min != null ? effectiveRounding.round(min) : null,
+                max != null ? effectiveRounding.round(max) : null);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalDateHistogram.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalDateHistogram.java
index 1f1775ede7535..9db524bd3d6ba 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalDateHistogram.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/InternalDateHistogram.java
@@ -497,7 +497,7 @@ public Number getKey(MultiBucketsAggregation.Bucket bucket) {
 
     @Override
     public Number nextKey(Number key) {
-        return emptyBucketInfo.rounding.nextRoundingValue(key.longValue() - offset) + offset;
+        return emptyBucketInfo.rounding.nextRoundingValue(key.longValue());
     }
 
     @Override
diff --git a/server/src/test/java/org/elasticsearch/common/RoundingTests.java b/server/src/test/java/org/elasticsearch/common/RoundingTests.java
index 7de894d081f21..8e19bdaf5547a 100644
--- a/server/src/test/java/org/elasticsearch/common/RoundingTests.java
+++ b/server/src/test/java/org/elasticsearch/common/RoundingTests.java
@@ -201,10 +201,18 @@ public void testOffsetRounding() {
         Rounding rounding = Rounding.builder(Rounding.DateTimeUnit.DAY_OF_MONTH).offset(twoHours).build();
         assertThat(rounding.round(0), equalTo(-oneDay + twoHours));
         assertThat(rounding.round(twoHours), equalTo(twoHours));
+        assertThat(rounding.nextRoundingValue(-oneDay), equalTo(-oneDay + twoHours));
+        assertThat(rounding.nextRoundingValue(0), equalTo(twoHours));
+        assertThat(rounding.withoutOffset().round(0), equalTo(0L));
+        assertThat(rounding.withoutOffset().nextRoundingValue(0), equalTo(oneDay));
 
         rounding = Rounding.builder(Rounding.DateTimeUnit.DAY_OF_MONTH).offset(-twoHours).build();
         assertThat(rounding.round(0), equalTo(-twoHours));
         assertThat(rounding.round(oneDay - twoHours), equalTo(oneDay - twoHours));
+        assertThat(rounding.nextRoundingValue(-oneDay), equalTo(-twoHours));
+        assertThat(rounding.nextRoundingValue(0), equalTo(oneDay - twoHours));
+        assertThat(rounding.withoutOffset().round(0), equalTo(0L));
+        assertThat(rounding.withoutOffset().nextRoundingValue(0), equalTo(oneDay));
     }
 
     /**
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/PipelineAggregationHelperTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/PipelineAggregationHelperTests.java
index ddfd2c8c82c31..9a2d5a411d4ad 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/PipelineAggregationHelperTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/pipeline/PipelineAggregationHelperTests.java
@@ -164,7 +164,7 @@ static AggregatorFactory getRandomSequentiallyOrderedParentAgg() throws IOExcept
                     new AggregatorFactories.Builder(), Collections.emptyMap());
                 break;
             case 1:
-                factory = new DateHistogramAggregatorFactory("name", mock(ValuesSourceConfig.class), 0L,
+                factory = new DateHistogramAggregatorFactory("name", mock(ValuesSourceConfig.class),
                     mock(InternalOrder.class), false, 0L, mock(Rounding.class), mock(Rounding.class),
                     mock(ExtendedBounds.class), mock(QueryShardContext.class), mock(AggregatorFactory.class),
                     new AggregatorFactories.Builder(), Collections.emptyMap());
diff --git a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/cumulativecardinality/CumulativeCardinalityAggregatorTests.java b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/cumulativecardinality/CumulativeCardinalityAggregatorTests.java
index 98f5600b245e7..e5b4b2ce0bf07 100644
--- a/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/cumulativecardinality/CumulativeCardinalityAggregatorTests.java
+++ b/x-pack/plugin/analytics/src/test/java/org/elasticsearch/xpack/analytics/cumulativecardinality/CumulativeCardinalityAggregatorTests.java
@@ -131,7 +131,7 @@ public void testParentValidations() throws IOException {
         // Date Histogram
         aggBuilders.clear();
         aggBuilders.add(new CumulativeCardinalityPipelineAggregationBuilder("cumulative_card", "sum"));
-        parent = new DateHistogramAggregatorFactory("name", valuesSource, 0L,
+        parent = new DateHistogramAggregatorFactory("name", valuesSource,
             mock(InternalOrder.class), false, 0L, mock(Rounding.class), mock(Rounding.class),
             mock(ExtendedBounds.class), mock(QueryShardContext.class), mock(AggregatorFactory.class),
             new AggregatorFactories.Builder(), Collections.emptyMap());

From 500aaab9e35c7022ef9e9bc8c0be91a3b9418337 Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Tue, 14 Jan 2020 14:37:39 +0000
Subject: [PATCH 554/686] Explicitly require a OriginSettingClient in ML
 results iterators (#50802)

In classes where the client is used directly rather than through a call to
executeAsyncWithOrigin explicitly require the client to be OriginSettingClient
rather than using the Client interface.

Also remove calls to deprecated ClientHelper.clientWithOrigin() method.
---
 .../TransportDeleteExpiredDataAction.java     |  5 +-
 .../persistence/BatchedBucketsIterator.java   |  4 +-
 .../BatchedInfluencersIterator.java           |  4 +-
 .../job/persistence/BatchedJobsIterator.java  |  4 +-
 .../persistence/BatchedRecordsIterator.java   |  4 +-
 .../persistence/BatchedResultsIterator.java   |  4 +-
 .../BatchedStateDocIdsIterator.java           |  4 +-
 .../job/persistence/JobResultsProvider.java   |  8 +-
 .../AbstractExpiredJobDataRemover.java        |  6 +-
 .../retention/ExpiredForecastsRemover.java    |  6 +-
 .../ExpiredModelSnapshotsRemover.java         |  6 +-
 .../job/retention/ExpiredResultsRemover.java  |  6 +-
 .../ml/job/retention/UnusedStateRemover.java  |  6 +-
 .../persistence/BatchedDocumentsIterator.java |  6 +-
 .../DocIdBatchedDocumentIterator.java         |  4 +-
 .../MockBatchedDocumentsIterator.java         |  4 +-
 .../normalizer/ScoresUpdaterTests.java        |  4 +-
 .../AbstractExpiredJobDataRemoverTests.java   | 57 ++++++++----
 .../ExpiredModelSnapshotsRemoverTests.java    | 93 +++++++++----------
 .../retention/ExpiredResultsRemoverTests.java | 63 +++++--------
 .../ml/test/MockOriginSettingClient.java      | 48 ++++++++++
 .../BatchedDocumentsIteratorTests.java        | 64 +++++++------
 22 files changed, 229 insertions(+), 181 deletions(-)
 create mode 100644 x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/test/MockOriginSettingClient.java

diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteExpiredDataAction.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteExpiredDataAction.java
index bc4bb6e16e53c..1ff0cf2208853 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteExpiredDataAction.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/action/TransportDeleteExpiredDataAction.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.action.support.HandledTransportAction;
 import org.elasticsearch.action.support.ThreadedActionListener;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.tasks.Task;
@@ -46,7 +47,7 @@ public class TransportDeleteExpiredDataAction extends HandledTransportAction<Del
 
     private final ThreadPool threadPool;
     private final String executor;
-    private final Client client;
+    private final OriginSettingClient client;
     private final ClusterService clusterService;
     private final Clock clock;
 
@@ -62,7 +63,7 @@ public TransportDeleteExpiredDataAction(ThreadPool threadPool, TransportService
         super(DeleteExpiredDataAction.NAME, transportService, actionFilters, DeleteExpiredDataAction.Request::new, executor);
         this.threadPool = threadPool;
         this.executor = executor;
-        this.client = ClientHelper.clientWithOrigin(client, ClientHelper.ML_ORIGIN);
+        this.client = new OriginSettingClient(client, ClientHelper.ML_ORIGIN);
         this.clusterService = clusterService;
         this.clock = clock;
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedBucketsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedBucketsIterator.java
index 53526e2a4753d..2598177ce7c10 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedBucketsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedBucketsIterator.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.ml.job.persistence;
 
 import org.elasticsearch.ElasticsearchParseException;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -22,7 +22,7 @@
 
 class BatchedBucketsIterator extends BatchedResultsIterator<Bucket> {
 
-    BatchedBucketsIterator(Client client, String jobId) {
+    BatchedBucketsIterator(OriginSettingClient client, String jobId) {
         super(client, jobId, Bucket.RESULT_TYPE_VALUE);
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedInfluencersIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedInfluencersIterator.java
index fe8bd3aaa3af7..35a88ed0f3e14 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedInfluencersIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedInfluencersIterator.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.ml.job.persistence;
 
 import org.elasticsearch.ElasticsearchParseException;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -21,7 +21,7 @@
 import java.io.InputStream;
 
 class BatchedInfluencersIterator extends BatchedResultsIterator<Influencer> {
-    BatchedInfluencersIterator(Client client, String jobId) {
+    BatchedInfluencersIterator(OriginSettingClient client, String jobId) {
         super(client, jobId, Influencer.RESULT_TYPE_VALUE);
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedJobsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedJobsIterator.java
index 1b72c1901d9bb..f933769c9454f 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedJobsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedJobsIterator.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.ml.job.persistence;
 
 import org.elasticsearch.ElasticsearchParseException;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentFactory;
@@ -23,7 +23,7 @@
 
 public class BatchedJobsIterator extends BatchedDocumentsIterator<Job.Builder> {
 
-    public BatchedJobsIterator(Client client, String index) {
+    public BatchedJobsIterator(OriginSettingClient client, String index) {
         super(client, index);
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedRecordsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedRecordsIterator.java
index 22c107f771ba5..989dd61c72d8b 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedRecordsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedRecordsIterator.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.ml.job.persistence;
 
 import org.elasticsearch.ElasticsearchParseException;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -22,7 +22,7 @@
 
 class BatchedRecordsIterator extends BatchedResultsIterator<AnomalyRecord> {
 
-    BatchedRecordsIterator(Client client, String jobId) {
+    BatchedRecordsIterator(OriginSettingClient client, String jobId) {
         super(client, jobId, AnomalyRecord.RESULT_TYPE_VALUE);
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedResultsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedResultsIterator.java
index 1c0fdbe08c9c6..61ca1dcc2c8af 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedResultsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedResultsIterator.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.ml.job.persistence;
 
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.TermsQueryBuilder;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
@@ -16,7 +16,7 @@ public abstract class BatchedResultsIterator<T> extends BatchedDocumentsIterator
 
     private final ResultsFilterBuilder filterBuilder;
 
-    public BatchedResultsIterator(Client client, String jobId, String resultType) {
+    public BatchedResultsIterator(OriginSettingClient client, String jobId, String resultType) {
         super(client, AnomalyDetectorsIndex.jobResultsAliasedName(jobId));
         this.filterBuilder = new ResultsFilterBuilder(new TermsQueryBuilder(Result.RESULT_TYPE.getPreferredName(), resultType));
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedStateDocIdsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedStateDocIdsIterator.java
index 65e8b75671151..4c147f3431b28 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedStateDocIdsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/BatchedStateDocIdsIterator.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.ml.job.persistence;
 
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.SearchHit;
@@ -16,7 +16,7 @@
  */
 public class BatchedStateDocIdsIterator extends BatchedDocumentsIterator<String> {
 
-    public BatchedStateDocIdsIterator(Client client, String index) {
+    public BatchedStateDocIdsIterator(OriginSettingClient client, String index) {
         super(client, index);
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProvider.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProvider.java
index b9359d2b97cd6..38e3e037ab024 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProvider.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProvider.java
@@ -37,6 +37,7 @@
 import org.elasticsearch.action.update.UpdateRequest;
 import org.elasticsearch.action.update.UpdateResponse;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.block.ClusterBlock;
 import org.elasticsearch.cluster.block.ClusterBlockException;
@@ -130,7 +131,6 @@
 import java.util.stream.Collectors;
 
 import static org.elasticsearch.xpack.core.ClientHelper.ML_ORIGIN;
-import static org.elasticsearch.xpack.core.ClientHelper.clientWithOrigin;
 import static org.elasticsearch.xpack.core.ClientHelper.executeAsyncWithOrigin;
 
 public class JobResultsProvider {
@@ -715,7 +715,7 @@ private void expandBuckets(String jobId, BucketsQueryBuilder query, QueryPage<Bu
      * @return a bucket {@link BatchedResultsIterator}
      */
     public BatchedResultsIterator<Bucket> newBatchedBucketsIterator(String jobId) {
-        return new BatchedBucketsIterator(clientWithOrigin(client, ML_ORIGIN), jobId);
+        return new BatchedBucketsIterator(new OriginSettingClient(client, ML_ORIGIN), jobId);
     }
 
     /**
@@ -727,7 +727,7 @@ public BatchedResultsIterator<Bucket> newBatchedBucketsIterator(String jobId) {
      * @return a record {@link BatchedResultsIterator}
      */
     public BatchedResultsIterator<AnomalyRecord> newBatchedRecordsIterator(String jobId) {
-        return new BatchedRecordsIterator(clientWithOrigin(client, ML_ORIGIN), jobId);
+        return new BatchedRecordsIterator(new OriginSettingClient(client, ML_ORIGIN), jobId);
     }
 
     /**
@@ -924,7 +924,7 @@ public void influencers(String jobId, InfluencersQuery query, Consumer<QueryPage
      * @return an influencer {@link BatchedResultsIterator}
      */
     public BatchedResultsIterator<Influencer> newBatchedInfluencersIterator(String jobId) {
-        return new BatchedInfluencersIterator(clientWithOrigin(client, ML_ORIGIN), jobId);
+        return new BatchedInfluencersIterator(new OriginSettingClient(client, ML_ORIGIN), jobId);
     }
 
     /**
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/AbstractExpiredJobDataRemover.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/AbstractExpiredJobDataRemover.java
index 2650f3018d951..c6e3fe9dbf670 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/AbstractExpiredJobDataRemover.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/AbstractExpiredJobDataRemover.java
@@ -6,7 +6,7 @@
 package org.elasticsearch.xpack.ml.job.retention;
 
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.query.BoolQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -34,9 +34,9 @@
  */
 abstract class AbstractExpiredJobDataRemover implements MlDataRemover {
 
-    private final Client client;
+    private final OriginSettingClient client;
 
-    AbstractExpiredJobDataRemover(Client client) {
+    AbstractExpiredJobDataRemover(OriginSettingClient client) {
         this.client = client;
     }
 
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredForecastsRemover.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredForecastsRemover.java
index a80b00aaa0792..40611438fda59 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredForecastsRemover.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredForecastsRemover.java
@@ -13,7 +13,7 @@
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.ThreadedActionListener;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentFactory;
@@ -62,11 +62,11 @@ public class ExpiredForecastsRemover implements MlDataRemover {
     private static final int MAX_FORECASTS = 10000;
     private static final String RESULTS_INDEX_PATTERN =  AnomalyDetectorsIndex.jobResultsIndexPrefix() + "*";
 
-    private final Client client;
+    private final OriginSettingClient client;
     private final ThreadPool threadPool;
     private final long cutoffEpochMs;
 
-    public ExpiredForecastsRemover(Client client, ThreadPool threadPool) {
+    public ExpiredForecastsRemover(OriginSettingClient client, ThreadPool threadPool) {
         this.client = Objects.requireNonNull(client);
         this.threadPool = Objects.requireNonNull(threadPool);
         this.cutoffEpochMs = Instant.now(Clock.systemDefaultZone()).toEpochMilli();
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredModelSnapshotsRemover.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredModelSnapshotsRemover.java
index 1153407d5125e..221f9d9debf87 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredModelSnapshotsRemover.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredModelSnapshotsRemover.java
@@ -14,7 +14,7 @@
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.ThreadedActionListener;
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.search.SearchHit;
@@ -55,10 +55,10 @@ public class ExpiredModelSnapshotsRemover extends AbstractExpiredJobDataRemover
      */
     private static final int MODEL_SNAPSHOT_SEARCH_SIZE = 10000;
 
-    private final Client client;
+    private final OriginSettingClient client;
     private final ThreadPool threadPool;
 
-    public ExpiredModelSnapshotsRemover(Client client, ThreadPool threadPool) {
+    public ExpiredModelSnapshotsRemover(OriginSettingClient client, ThreadPool threadPool) {
         super(client);
         this.client = Objects.requireNonNull(client);
         this.threadPool = Objects.requireNonNull(threadPool);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredResultsRemover.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredResultsRemover.java
index 6a17382db0e8c..fff2c23ab75a6 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredResultsRemover.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/ExpiredResultsRemover.java
@@ -9,7 +9,7 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.index.reindex.AbstractBulkByScrollRequest;
@@ -46,10 +46,10 @@ public class ExpiredResultsRemover extends AbstractExpiredJobDataRemover {
 
     private static final Logger LOGGER = LogManager.getLogger(ExpiredResultsRemover.class);
 
-    private final Client client;
+    private final OriginSettingClient client;
     private final AnomalyDetectionAuditor auditor;
 
-    public ExpiredResultsRemover(Client client, AnomalyDetectionAuditor auditor) {
+    public ExpiredResultsRemover(OriginSettingClient client, AnomalyDetectionAuditor auditor) {
         super(client);
         this.client = Objects.requireNonNull(client);
         this.auditor = Objects.requireNonNull(auditor);
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/UnusedStateRemover.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/UnusedStateRemover.java
index 8a1d30382489f..cf1a9aaae4ede 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/UnusedStateRemover.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/retention/UnusedStateRemover.java
@@ -9,7 +9,7 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.IndicesOptions;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -49,10 +49,10 @@ public class UnusedStateRemover implements MlDataRemover {
 
     private static final Logger LOGGER = LogManager.getLogger(UnusedStateRemover.class);
 
-    private final Client client;
+    private final OriginSettingClient client;
     private final ClusterService clusterService;
 
-    public UnusedStateRemover(Client client, ClusterService clusterService) {
+    public UnusedStateRemover(OriginSettingClient client, ClusterService clusterService) {
         this.client = Objects.requireNonNull(client);
         this.clusterService = Objects.requireNonNull(clusterService);
     }
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIterator.java
index 119dcbdb42822..9b8c1345af1ea 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIterator.java
@@ -10,7 +10,7 @@
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.search.SearchScrollRequest;
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
@@ -34,14 +34,14 @@ public abstract class BatchedDocumentsIterator<T>  {
     private static final String CONTEXT_ALIVE_DURATION = "5m";
     private static final int BATCH_SIZE = 10000;
 
-    private final Client client;
+    private final OriginSettingClient client;
     private final String index;
     private volatile long count;
     private volatile long totalHits;
     private volatile String scrollId;
     private volatile boolean isScrollInitialised;
 
-    protected BatchedDocumentsIterator(Client client, String index) {
+    protected BatchedDocumentsIterator(OriginSettingClient client, String index) {
         this.client = Objects.requireNonNull(client);
         this.index = Objects.requireNonNull(index);
         this.totalHits = 0;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/DocIdBatchedDocumentIterator.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/DocIdBatchedDocumentIterator.java
index 55b2cee2ff16d..3dcee716f11af 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/DocIdBatchedDocumentIterator.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/utils/persistence/DocIdBatchedDocumentIterator.java
@@ -5,7 +5,7 @@
  */
 package org.elasticsearch.xpack.ml.utils.persistence;
 
-import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.search.SearchHit;
 
@@ -18,7 +18,7 @@ public class DocIdBatchedDocumentIterator extends BatchedDocumentsIterator<Strin
 
     private final QueryBuilder query;
 
-    public DocIdBatchedDocumentIterator(Client client, String index, QueryBuilder query) {
+    public DocIdBatchedDocumentIterator(OriginSettingClient client, String index, QueryBuilder query) {
         super(client, index);
         this.query = Objects.requireNonNull(query);
     }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/MockBatchedDocumentsIterator.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/MockBatchedDocumentsIterator.java
index c0d15cab49c16..701599d958ae5 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/MockBatchedDocumentsIterator.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/MockBatchedDocumentsIterator.java
@@ -8,7 +8,9 @@
 import org.elasticsearch.client.Client;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.search.SearchHit;
+import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.ml.job.results.Result;
+import org.elasticsearch.xpack.ml.test.MockOriginSettingClient;
 
 import java.util.Deque;
 import java.util.List;
@@ -25,7 +27,7 @@ public class MockBatchedDocumentsIterator<T> extends BatchedResultsIterator<T> {
     private Boolean requireIncludeInterim;
 
     public MockBatchedDocumentsIterator(List<Deque<Result<T>>> batches, String resultType) {
-        super(mock(Client.class), "foo", resultType);
+        super(MockOriginSettingClient.mockOriginSettingClient(mock(Client.class), ClientHelper.ML_ORIGIN), "foo", resultType);
         this.batches = batches;
         index = 0;
         wasTimeRangeCalled = false;
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/normalizer/ScoresUpdaterTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/normalizer/ScoresUpdaterTests.java
index 9836cf93718e5..410c15e52c093 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/normalizer/ScoresUpdaterTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/normalizer/ScoresUpdaterTests.java
@@ -59,12 +59,12 @@ public class ScoresUpdaterTests extends ESTestCase {
     private Job job;
     private ScoresUpdater scoresUpdater;
 
-    private Bucket generateBucket(Date timestamp) throws IOException {
+    private Bucket generateBucket(Date timestamp) {
         return new Bucket(JOB_ID, timestamp, DEFAULT_BUCKET_SPAN);
     }
 
     @Before
-    public void setUpMocks() throws IOException {
+    public void setUpMocks() {
         MockitoAnnotations.initMocks(this);
 
         Job.Builder jobBuilder = new Job.Builder(JOB_ID);
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/AbstractExpiredJobDataRemoverTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/AbstractExpiredJobDataRemoverTests.java
index c5a24fc9e0609..eb29ba06b17ca 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/AbstractExpiredJobDataRemoverTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/AbstractExpiredJobDataRemoverTests.java
@@ -6,10 +6,11 @@
 package org.elasticsearch.xpack.ml.job.retention;
 
 import org.apache.lucene.search.TotalHits;
-import org.elasticsearch.action.ActionFuture;
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.search.SearchAction;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -17,8 +18,10 @@
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.search.SearchHits;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.ml.job.config.JobTests;
+import org.elasticsearch.xpack.ml.test.MockOriginSettingClient;
 import org.junit.Before;
 
 import java.io.IOException;
@@ -32,6 +35,7 @@
 
 import static org.hamcrest.Matchers.is;
 import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.eq;
 import static org.mockito.Mockito.doAnswer;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
@@ -44,7 +48,7 @@ private class ConcreteExpiredJobDataRemover extends AbstractExpiredJobDataRemove
 
         private int getRetentionDaysCallCount = 0;
 
-        ConcreteExpiredJobDataRemover(Client client) {
+        ConcreteExpiredJobDataRemover(OriginSettingClient client) {
             super(client);
         }
 
@@ -61,17 +65,30 @@ protected void removeDataBefore(Job job, long cutoffEpochMs, ActionListener<Bool
         }
     }
 
+    private OriginSettingClient originSettingClient;
     private Client client;
 
     @Before
     public void setUpTests() {
         client = mock(Client.class);
+        originSettingClient = MockOriginSettingClient.mockOriginSettingClient(client, ClientHelper.ML_ORIGIN);
     }
 
     static SearchResponse createSearchResponse(List<? extends ToXContent> toXContents) throws IOException {
         return createSearchResponse(toXContents, toXContents.size());
     }
 
+    @SuppressWarnings("unchecked")
+    static void givenJobs(Client client, List<Job> jobs) throws IOException {
+        SearchResponse response = AbstractExpiredJobDataRemoverTests.createSearchResponse(jobs);
+
+        doAnswer(invocationOnMock -> {
+            ActionListener<SearchResponse> listener = (ActionListener<SearchResponse>) invocationOnMock.getArguments()[2];
+            listener.onResponse(response);
+            return null;
+        }).when(client).execute(eq(SearchAction.INSTANCE), any(), any());
+    }
+
     private static SearchResponse createSearchResponse(List<? extends ToXContent> toXContents, int totalHits) throws IOException {
         SearchHit[] hitsArray = new SearchHit[toXContents.size()];
         for (int i = 0; i < toXContents.size(); i++) {
@@ -88,14 +105,10 @@ private static SearchResponse createSearchResponse(List<? extends ToXContent> to
 
     public void testRemoveGivenNoJobs() throws IOException {
         SearchResponse response = createSearchResponse(Collections.emptyList());
-
-        @SuppressWarnings("unchecked")
-        ActionFuture<SearchResponse> future = mock(ActionFuture.class);
-        when(future.actionGet()).thenReturn(response);
-        when(client.search(any())).thenReturn(future);
+        mockSearchResponse(response);
 
         TestListener listener = new TestListener();
-        ConcreteExpiredJobDataRemover remover = new ConcreteExpiredJobDataRemover(client);
+        ConcreteExpiredJobDataRemover remover = new ConcreteExpiredJobDataRemover(originSettingClient);
         remover.remove(listener, () -> false);
 
         listener.waitToCompletion();
@@ -103,6 +116,7 @@ public void testRemoveGivenNoJobs() throws IOException {
         assertEquals(0, remover.getRetentionDaysCallCount);
     }
 
+    @SuppressWarnings("unchecked")
     public void testRemoveGivenMultipleBatches() throws IOException {
         // This is testing AbstractExpiredJobDataRemover.WrappedBatchedJobsIterator
         int totalHits = 7;
@@ -126,13 +140,14 @@ public void testRemoveGivenMultipleBatches() throws IOException {
 
         AtomicInteger searchCount = new AtomicInteger(0);
 
-        @SuppressWarnings("unchecked")
-        ActionFuture<SearchResponse> future = mock(ActionFuture.class);
-        doAnswer(invocationOnMock -> responses.get(searchCount.getAndIncrement())).when(future).actionGet();
-        when(client.search(any())).thenReturn(future);
+        doAnswer(invocationOnMock -> {
+            ActionListener<SearchResponse> listener = (ActionListener<SearchResponse>) invocationOnMock.getArguments()[2];
+            listener.onResponse(responses.get(searchCount.getAndIncrement()));
+            return null;
+        }).when(client).execute(eq(SearchAction.INSTANCE), any(), any());
 
         TestListener listener = new TestListener();
-        ConcreteExpiredJobDataRemover remover = new ConcreteExpiredJobDataRemover(client);
+        ConcreteExpiredJobDataRemover remover = new ConcreteExpiredJobDataRemover(originSettingClient);
         remover.remove(listener, () -> false);
 
         listener.waitToCompletion();
@@ -153,13 +168,10 @@ public void testRemoveGivenTimeOut() throws IOException {
         final int timeoutAfter = randomIntBetween(0, totalHits - 1);
         AtomicInteger attemptsLeft = new AtomicInteger(timeoutAfter);
 
-        @SuppressWarnings("unchecked")
-        ActionFuture<SearchResponse> future = mock(ActionFuture.class);
-        when(future.actionGet()).thenReturn(response);
-        when(client.search(any())).thenReturn(future);
+        mockSearchResponse(response);
 
         TestListener listener = new TestListener();
-        ConcreteExpiredJobDataRemover remover = new ConcreteExpiredJobDataRemover(client);
+        ConcreteExpiredJobDataRemover remover = new ConcreteExpiredJobDataRemover(originSettingClient);
         remover.remove(listener, () -> (attemptsLeft.getAndDecrement() <= 0));
 
         listener.waitToCompletion();
@@ -167,6 +179,15 @@ public void testRemoveGivenTimeOut() throws IOException {
         assertEquals(timeoutAfter, remover.getRetentionDaysCallCount);
     }
 
+    @SuppressWarnings("unchecked")
+    private void mockSearchResponse(SearchResponse searchResponse) {
+        doAnswer(invocationOnMock -> {
+            ActionListener<SearchResponse> listener = (ActionListener<SearchResponse>) invocationOnMock.getArguments()[2];
+            listener.onResponse(searchResponse);
+            return null;
+        }).when(client).execute(eq(SearchAction.INSTANCE), any(), any());
+    }
+
     static class TestListener implements ActionListener<Boolean> {
 
         boolean success;
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/ExpiredModelSnapshotsRemoverTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/ExpiredModelSnapshotsRemoverTests.java
index 56c2333cae016..6e332bf148d17 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/ExpiredModelSnapshotsRemoverTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/ExpiredModelSnapshotsRemoverTests.java
@@ -5,24 +5,25 @@
  */
 package org.elasticsearch.xpack.ml.job.retention;
 
-import org.elasticsearch.action.ActionFuture;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.search.SearchAction;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.mock.orig.Mockito;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.threadpool.FixedExecutorBuilder;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.ml.action.DeleteModelSnapshotAction;
 import org.elasticsearch.xpack.core.ml.job.config.Job;
 import org.elasticsearch.xpack.core.ml.job.config.JobTests;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.ModelSnapshot;
 import org.elasticsearch.xpack.ml.MachineLearning;
+import org.elasticsearch.xpack.ml.test.MockOriginSettingClient;
 import org.junit.After;
 import org.junit.Before;
 import org.mockito.invocation.InvocationOnMock;
@@ -33,21 +34,23 @@
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
+import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicInteger;
 
 import static org.elasticsearch.xpack.ml.job.retention.AbstractExpiredJobDataRemoverTests.TestListener;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.eq;
 import static org.mockito.Matchers.same;
 import static org.mockito.Mockito.doAnswer;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.verify;
-import static org.mockito.Mockito.when;
 
 public class ExpiredModelSnapshotsRemoverTests extends ESTestCase {
 
     private Client client;
+    private OriginSettingClient originSettingClient;
     private ThreadPool threadPool;
     private List<SearchRequest> capturedSearchRequests;
     private List<DeleteModelSnapshotAction.Request> capturedDeleteModelSnapshotRequests;
@@ -59,7 +62,10 @@ public void setUpTests() {
         capturedSearchRequests = new ArrayList<>();
         capturedDeleteModelSnapshotRequests = new ArrayList<>();
         searchResponsesPerCall = new ArrayList<>();
+
         client = mock(Client.class);
+        originSettingClient = MockOriginSettingClient.mockOriginSettingClient(client, ClientHelper.ML_ORIGIN);
+
         listener = new TestListener();
 
         // Init thread pool
@@ -76,8 +82,7 @@ public void shutdownThreadPool() {
     }
 
     public void testRemove_GivenJobsWithoutRetentionPolicy() throws IOException {
-        givenClientRequestsSucceed();
-        givenJobs(Arrays.asList(
+        givenClientRequestsSucceed(Arrays.asList(
                 JobTests.buildJobBuilder("foo").build(),
                 JobTests.buildJobBuilder("bar").build()
         ));
@@ -86,25 +91,22 @@ public void testRemove_GivenJobsWithoutRetentionPolicy() throws IOException {
 
         listener.waitToCompletion();
         assertThat(listener.success, is(true));
-        verify(client).search(any());
-        Mockito.verifyNoMoreInteractions(client);
+        verify(client).execute(eq(SearchAction.INSTANCE), any(), any());
     }
 
     public void testRemove_GivenJobWithoutActiveSnapshot() throws IOException {
-        givenClientRequestsSucceed();
-        givenJobs(Collections.singletonList(JobTests.buildJobBuilder("foo").setModelSnapshotRetentionDays(7L).build()));
+        givenClientRequestsSucceed(Collections.singletonList(JobTests.buildJobBuilder("foo").setModelSnapshotRetentionDays(7L).build()));
 
         createExpiredModelSnapshotsRemover().remove(listener, () -> false);
 
         listener.waitToCompletion();
         assertThat(listener.success, is(true));
-        verify(client).search(any());
-        Mockito.verifyNoMoreInteractions(client);
+        verify(client).execute(eq(SearchAction.INSTANCE), any(), any());
     }
 
     public void testRemove_GivenJobsWithMixedRetentionPolicies() throws IOException {
-        givenClientRequestsSucceed();
-        givenJobs(Arrays.asList(
+        givenClientRequestsSucceed(
+                Arrays.asList(
                 JobTests.buildJobBuilder("none").build(),
                 JobTests.buildJobBuilder("snapshots-1").setModelSnapshotRetentionDays(7L).setModelSnapshotId("active").build(),
                 JobTests.buildJobBuilder("snapshots-2").setModelSnapshotRetentionDays(17L).setModelSnapshotId("active").build()
@@ -140,8 +142,8 @@ public void testRemove_GivenJobsWithMixedRetentionPolicies() throws IOException
     }
 
     public void testRemove_GivenTimeout() throws IOException {
-        givenClientRequestsSucceed();
-        givenJobs(Arrays.asList(
+        givenClientRequestsSucceed(
+                Arrays.asList(
             JobTests.buildJobBuilder("snapshots-1").setModelSnapshotRetentionDays(7L).setModelSnapshotId("active").build(),
             JobTests.buildJobBuilder("snapshots-2").setModelSnapshotRetentionDays(17L).setModelSnapshotId("active").build()
         ));
@@ -162,8 +164,8 @@ public void testRemove_GivenTimeout() throws IOException {
     }
 
     public void testRemove_GivenClientSearchRequestsFail() throws IOException {
-        givenClientSearchRequestsFail();
-        givenJobs(Arrays.asList(
+        givenClientSearchRequestsFail(
+                Arrays.asList(
                 JobTests.buildJobBuilder("none").build(),
                 JobTests.buildJobBuilder("snapshots-1").setModelSnapshotRetentionDays(7L).setModelSnapshotId("active").build(),
                 JobTests.buildJobBuilder("snapshots-2").setModelSnapshotRetentionDays(17L).setModelSnapshotId("active").build()
@@ -188,8 +190,8 @@ public void testRemove_GivenClientSearchRequestsFail() throws IOException {
     }
 
     public void testRemove_GivenClientDeleteSnapshotRequestsFail() throws IOException {
-        givenClientDeleteModelSnapshotRequestsFail();
-        givenJobs(Arrays.asList(
+        givenClientDeleteModelSnapshotRequestsFail(
+                Arrays.asList(
                 JobTests.buildJobBuilder("none").build(),
                 JobTests.buildJobBuilder("snapshots-1").setModelSnapshotRetentionDays(7L).setModelSnapshotId("active").build(),
                 JobTests.buildJobBuilder("snapshots-2").setModelSnapshotRetentionDays(17L).setModelSnapshotId("active").build()
@@ -216,59 +218,47 @@ public void testRemove_GivenClientDeleteSnapshotRequestsFail() throws IOExceptio
         assertThat(deleteSnapshotRequest.getSnapshotId(), equalTo("snapshots-1_1"));
     }
 
-    @SuppressWarnings("unchecked")
-    private void givenJobs(List<Job> jobs) throws IOException {
-        SearchResponse response = AbstractExpiredJobDataRemoverTests.createSearchResponse(jobs);
-
-        ActionFuture<SearchResponse> future = mock(ActionFuture.class);
-        when(future.actionGet()).thenReturn(response);
-        when(client.search(any())).thenReturn(future);
-    }
-
     private ExpiredModelSnapshotsRemover createExpiredModelSnapshotsRemover() {
-        return new ExpiredModelSnapshotsRemover(client, threadPool);
+        return new ExpiredModelSnapshotsRemover(originSettingClient, threadPool);
     }
 
     private static ModelSnapshot createModelSnapshot(String jobId, String snapshotId) {
         return new ModelSnapshot.Builder(jobId).setSnapshotId(snapshotId).build();
     }
 
-//    private static SearchResponse createSearchResponse(List<ModelSnapshot> modelSnapshots) throws IOException {
-//        SearchHit[] hitsArray = new SearchHit[modelSnapshots.size()];
-//        for (int i = 0; i < modelSnapshots.size(); i++) {
-//            hitsArray[i] = new SearchHit(randomInt());
-//            XContentBuilder jsonBuilder = JsonXContent.contentBuilder();
-//            modelSnapshots.get(i).toXContent(jsonBuilder, ToXContent.EMPTY_PARAMS);
-//            hitsArray[i].sourceRef(BytesReference.bytes(jsonBuilder));
-//        }
-//        SearchHits hits = new SearchHits(hitsArray, new TotalHits(hitsArray.length, TotalHits.Relation.EQUAL_TO), 1.0f);
-//        SearchResponse searchResponse = mock(SearchResponse.class);
-//        when(searchResponse.getHits()).thenReturn(hits);
-//        return searchResponse;
-//    }
-
-    private void givenClientRequestsSucceed() {
-        givenClientRequests(true, true);
+    private void givenClientRequestsSucceed(List<Job> jobs) throws IOException {
+        givenClientRequests(jobs, true, true);
     }
 
-    private void givenClientSearchRequestsFail() {
-        givenClientRequests(false, true);
+    private void givenClientSearchRequestsFail(List<Job> jobs) throws IOException {
+        givenClientRequests(jobs, false, true);
     }
 
-    private void givenClientDeleteModelSnapshotRequestsFail() {
-        givenClientRequests(true, false);
+    private void givenClientDeleteModelSnapshotRequestsFail(List<Job> jobs) throws IOException {
+        givenClientRequests(jobs, true, false);
     }
 
     @SuppressWarnings("unchecked")
-    private void givenClientRequests(boolean shouldSearchRequestsSucceed, boolean shouldDeleteSnapshotRequestsSucceed) {
+    private void givenClientRequests(List<Job> jobs,
+                                     boolean shouldSearchRequestsSucceed, boolean shouldDeleteSnapshotRequestsSucceed) throws IOException {
+        SearchResponse response = AbstractExpiredJobDataRemoverTests.createSearchResponse(jobs);
+
         doAnswer(new Answer<Void>() {
             int callCount = 0;
+            AtomicBoolean isJobQuery = new AtomicBoolean(true);
 
             @Override
             public Void answer(InvocationOnMock invocationOnMock) {
+                ActionListener<SearchResponse> listener = (ActionListener<SearchResponse>) invocationOnMock.getArguments()[2];
+
+                if (isJobQuery.get()) {
+                    listener.onResponse(response);
+                    isJobQuery.set(false);
+                    return null;
+                }
+
                 SearchRequest searchRequest = (SearchRequest) invocationOnMock.getArguments()[1];
                 capturedSearchRequests.add(searchRequest);
-                ActionListener<SearchResponse> listener = (ActionListener<SearchResponse>) invocationOnMock.getArguments()[2];
                 if (shouldSearchRequestsSucceed) {
                     listener.onResponse(searchResponsesPerCall.get(callCount++));
                 } else {
@@ -277,6 +267,7 @@ public Void answer(InvocationOnMock invocationOnMock) {
                 return null;
             }
         }).when(client).execute(same(SearchAction.INSTANCE), any(), any());
+
         doAnswer(new Answer<Void>() {
             @Override
             public Void answer(InvocationOnMock invocationOnMock) {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/ExpiredResultsRemoverTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/ExpiredResultsRemoverTests.java
index f5acae02b4f87..b4c5a051fb8c1 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/ExpiredResultsRemoverTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/retention/ExpiredResultsRemoverTests.java
@@ -5,22 +5,19 @@
  */
 package org.elasticsearch.xpack.ml.job.retention;
 
-import org.elasticsearch.action.ActionFuture;
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.action.search.SearchAction;
 import org.elasticsearch.client.Client;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.index.reindex.BulkByScrollResponse;
 import org.elasticsearch.index.reindex.DeleteByQueryAction;
 import org.elasticsearch.index.reindex.DeleteByQueryRequest;
-import org.elasticsearch.mock.orig.Mockito;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
-import org.elasticsearch.xpack.core.ml.job.config.Job;
+import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.core.ml.job.config.JobTests;
 import org.elasticsearch.xpack.core.ml.job.persistence.AnomalyDetectorsIndex;
 import org.elasticsearch.xpack.ml.notifications.AnomalyDetectionAuditor;
+import org.elasticsearch.xpack.ml.test.MockOriginSettingClient;
 import org.junit.Before;
 import org.mockito.invocation.InvocationOnMock;
 import org.mockito.stubbing.Answer;
@@ -34,6 +31,7 @@
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.eq;
 import static org.mockito.Matchers.same;
 import static org.mockito.Mockito.doAnswer;
 import static org.mockito.Mockito.mock;
@@ -43,6 +41,7 @@
 public class ExpiredResultsRemoverTests extends ESTestCase {
 
     private Client client;
+    private OriginSettingClient originSettingClient;
     private List<DeleteByQueryRequest> capturedDeleteByQueryRequests;
     private ActionListener<Boolean> listener;
 
@@ -50,37 +49,26 @@ public class ExpiredResultsRemoverTests extends ESTestCase {
     @SuppressWarnings("unchecked")
     public void setUpTests() {
         capturedDeleteByQueryRequests = new ArrayList<>();
-        client = mock(Client.class);
-        ThreadPool threadPool = mock(ThreadPool.class);
-        when(client.threadPool()).thenReturn(threadPool);
-        when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
-        doAnswer(new Answer<Void>() {
-                 @Override
-                 public Void answer(InvocationOnMock invocationOnMock) throws Throwable {
-                     capturedDeleteByQueryRequests.add((DeleteByQueryRequest) invocationOnMock.getArguments()[1]);
-                     ActionListener<BulkByScrollResponse> listener =
-                             (ActionListener<BulkByScrollResponse>) invocationOnMock.getArguments()[2];
-                     listener.onResponse(null);
-                     return null;
-                 }
-             }).when(client).execute(same(DeleteByQueryAction.INSTANCE), any(), any());
+
+        client = org.mockito.Mockito.mock(Client.class);
+        originSettingClient = MockOriginSettingClient.mockOriginSettingClient(client, ClientHelper.ML_ORIGIN);
         listener = mock(ActionListener.class);
     }
 
     public void testRemove_GivenNoJobs() throws IOException {
         givenClientRequestsSucceed();
-        givenJobs(Collections.emptyList());
+        AbstractExpiredJobDataRemoverTests.givenJobs(client, Collections.emptyList());
 
         createExpiredResultsRemover().remove(listener, () -> false);
 
+        verify(client).execute(eq(SearchAction.INSTANCE), any(), any());
         verify(listener).onResponse(true);
-        verify(client).search(any());
-        Mockito.verifyNoMoreInteractions(client);
     }
 
     public void testRemove_GivenJobsWithoutRetentionPolicy() throws IOException {
         givenClientRequestsSucceed();
-        givenJobs(Arrays.asList(
+        AbstractExpiredJobDataRemoverTests.givenJobs(client,
+                Arrays.asList(
                 JobTests.buildJobBuilder("foo").build(),
                 JobTests.buildJobBuilder("bar").build()
         ));
@@ -88,13 +76,13 @@ public void testRemove_GivenJobsWithoutRetentionPolicy() throws IOException {
         createExpiredResultsRemover().remove(listener, () -> false);
 
         verify(listener).onResponse(true);
-        verify(client).search(any());
-        Mockito.verifyNoMoreInteractions(client);
+        verify(client).execute(eq(SearchAction.INSTANCE), any(), any());
     }
 
     public void testRemove_GivenJobsWithAndWithoutRetentionPolicy() throws Exception {
         givenClientRequestsSucceed();
-        givenJobs(Arrays.asList(
+        AbstractExpiredJobDataRemoverTests.givenJobs(client,
+                Arrays.asList(
                 JobTests.buildJobBuilder("none").build(),
                 JobTests.buildJobBuilder("results-1").setResultsRetentionDays(10L).build(),
                 JobTests.buildJobBuilder("results-2").setResultsRetentionDays(20L).build()
@@ -112,7 +100,8 @@ public void testRemove_GivenJobsWithAndWithoutRetentionPolicy() throws Exception
 
     public void testRemove_GivenTimeout() throws Exception {
         givenClientRequestsSucceed();
-        givenJobs(Arrays.asList(
+        AbstractExpiredJobDataRemoverTests.givenJobs(client,
+                Arrays.asList(
             JobTests.buildJobBuilder("results-1").setResultsRetentionDays(10L).build(),
             JobTests.buildJobBuilder("results-2").setResultsRetentionDays(20L).build()
         ));
@@ -128,7 +117,8 @@ public void testRemove_GivenTimeout() throws Exception {
 
     public void testRemove_GivenClientRequestsFailed() throws IOException {
         givenClientRequestsFailed();
-        givenJobs(Arrays.asList(
+        AbstractExpiredJobDataRemoverTests.givenJobs(client,
+                Arrays.asList(
                 JobTests.buildJobBuilder("none").build(),
                 JobTests.buildJobBuilder("results-1").setResultsRetentionDays(10L).build(),
                 JobTests.buildJobBuilder("results-2").setResultsRetentionDays(20L).build()
@@ -154,7 +144,7 @@ private void givenClientRequestsFailed() {
     private void givenClientRequests(boolean shouldSucceed) {
         doAnswer(new Answer<Void>() {
             @Override
-            public Void answer(InvocationOnMock invocationOnMock) throws Throwable {
+            public Void answer(InvocationOnMock invocationOnMock) {
                 capturedDeleteByQueryRequests.add((DeleteByQueryRequest) invocationOnMock.getArguments()[1]);
                 ActionListener<BulkByScrollResponse> listener =
                         (ActionListener<BulkByScrollResponse>) invocationOnMock.getArguments()[2];
@@ -170,16 +160,7 @@ public Void answer(InvocationOnMock invocationOnMock) throws Throwable {
         }).when(client).execute(same(DeleteByQueryAction.INSTANCE), any(), any());
     }
 
-    @SuppressWarnings("unchecked")
-    private void givenJobs(List<Job> jobs) throws IOException {
-        SearchResponse response = AbstractExpiredJobDataRemoverTests.createSearchResponse(jobs);
-
-        ActionFuture<SearchResponse> future = mock(ActionFuture.class);
-        when(future.actionGet()).thenReturn(response);
-        when(client.search(any())).thenReturn(future);
-    }
-
     private ExpiredResultsRemover createExpiredResultsRemover() {
-        return new ExpiredResultsRemover(client, mock(AnomalyDetectionAuditor.class));
+        return new ExpiredResultsRemover(originSettingClient, mock(AnomalyDetectionAuditor.class));
     }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/test/MockOriginSettingClient.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/test/MockOriginSettingClient.java
new file mode 100644
index 0000000000000..b47245a40b93a
--- /dev/null
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/test/MockOriginSettingClient.java
@@ -0,0 +1,48 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.ml.test;
+
+
+import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.mockito.Mockito;
+
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * OriginSettingClient is a final class that cannot be mocked by mockito.
+ * The solution is to wrap a non-mocked OriginSettingClient around a
+ * mocked Client. All the mocking should take place on the client parameter.
+ */
+public class MockOriginSettingClient {
+
+    /**
+     * Create a OriginSettingClient on a mocked client.
+     *
+     * @param client The mocked client
+     * @param origin Whatever
+     * @return A OriginSettingClient using a mocked client
+     */
+    public static OriginSettingClient mockOriginSettingClient(Client client, String origin) {
+
+        if (Mockito.mockingDetails(client).isMock() == false) {
+            throw new AssertionError("client should be a mock");
+        }
+        ThreadContext tc = new ThreadContext(Settings.EMPTY);
+
+        ThreadPool tp = mock(ThreadPool.class);
+        when(tp.getThreadContext()).thenReturn(tc);
+
+        when(client.threadPool()).thenReturn(tp);
+
+        return new OriginSettingClient(client, origin);
+    }
+}
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIteratorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIteratorTests.java
index 381ff0612abe2..8373a75bfa117 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIteratorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/utils/persistence/BatchedDocumentsIteratorTests.java
@@ -6,12 +6,16 @@
 package org.elasticsearch.xpack.ml.utils.persistence;
 
 import org.apache.lucene.search.TotalHits;
-import org.elasticsearch.action.ActionFuture;
-import org.elasticsearch.action.search.ClearScrollRequestBuilder;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.search.ClearScrollAction;
+import org.elasticsearch.action.search.ClearScrollResponse;
+import org.elasticsearch.action.search.SearchAction;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.action.search.SearchScrollAction;
 import org.elasticsearch.action.search.SearchScrollRequest;
 import org.elasticsearch.client.Client;
+import org.elasticsearch.client.OriginSettingClient;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -19,6 +23,8 @@
 import org.elasticsearch.search.SearchHits;
 import org.elasticsearch.search.internal.SearchContext;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.ClientHelper;
+import org.elasticsearch.xpack.ml.test.MockOriginSettingClient;
 import org.elasticsearch.xpack.ml.test.SearchHitBuilder;
 import org.junit.Before;
 import org.mockito.ArgumentCaptor;
@@ -30,9 +36,13 @@
 import java.util.Deque;
 import java.util.List;
 import java.util.NoSuchElementException;
+import java.util.concurrent.atomic.AtomicInteger;
 
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
+import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.doAnswer;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
@@ -42,6 +52,7 @@ public class BatchedDocumentsIteratorTests extends ESTestCase {
     private static final String SCROLL_ID = "someScrollId";
 
     private Client client;
+    private OriginSettingClient originSettingClient;
     private boolean wasScrollCleared;
 
     private TestIterator testIterator;
@@ -52,8 +63,9 @@ public class BatchedDocumentsIteratorTests extends ESTestCase {
     @Before
     public void setUpMocks() {
         client = Mockito.mock(Client.class);
+        originSettingClient = MockOriginSettingClient.mockOriginSettingClient(client, ClientHelper.ML_ORIGIN);
         wasScrollCleared = false;
-        testIterator = new TestIterator(client, INDEX_NAME);
+        testIterator = new TestIterator(originSettingClient, INDEX_NAME);
         givenClearScrollRequest();
     }
 
@@ -122,14 +134,14 @@ private String createJsonDoc(String value) {
         return "{\"foo\":\"" + value + "\"}";
     }
 
+    @SuppressWarnings("unchecked")
     private void givenClearScrollRequest() {
-        ClearScrollRequestBuilder requestBuilder = mock(ClearScrollRequestBuilder.class);
-        when(client.prepareClearScroll()).thenReturn(requestBuilder);
-        when(requestBuilder.setScrollIds(Collections.singletonList(SCROLL_ID))).thenReturn(requestBuilder);
-        when(requestBuilder.get()).thenAnswer((invocation) -> {
+        doAnswer(invocationOnMock -> {
+            ActionListener<ClearScrollResponse> listener = (ActionListener<ClearScrollResponse>) invocationOnMock.getArguments()[2];
             wasScrollCleared = true;
+            listener.onResponse(mock(ClearScrollResponse.class));
             return null;
-        });
+        }).when(client).execute(eq(ClearScrollAction.INSTANCE), any(), any());
     }
 
     private void assertSearchRequest() {
@@ -156,6 +168,8 @@ private class ScrollResponsesMocker {
         private long totalHits = 0;
         private List<SearchResponse> responses = new ArrayList<>();
 
+        private AtomicInteger responseIndex = new AtomicInteger(0);
+
         ScrollResponsesMocker addBatch(String... hits) {
             totalHits += hits.length;
             batches.add(hits);
@@ -173,33 +187,23 @@ void finishMock() {
                 givenNextResponse(batches.get(i));
             }
             if (responses.size() > 0) {
-                ActionFuture<SearchResponse> first = wrapResponse(responses.get(0));
-                if (responses.size() > 1) {
-                    List<ActionFuture<SearchResponse>> rest = new ArrayList<>();
-                    for (int i = 1; i < responses.size(); ++i) {
-                        rest.add(wrapResponse(responses.get(i)));
-                    }
-
-                    when(client.searchScroll(searchScrollRequestCaptor.capture())).thenReturn(
-                            first, rest.toArray(new ActionFuture[rest.size() - 1]));
-                } else {
-                    when(client.searchScroll(searchScrollRequestCaptor.capture())).thenReturn(first);
-                }
+                doAnswer(invocationOnMock -> {
+                    ActionListener<SearchResponse> listener = (ActionListener<SearchResponse>) invocationOnMock.getArguments()[2];
+                    listener.onResponse(responses.get(responseIndex.getAndIncrement()));
+                    return null;
+                }).when(client).execute(eq(SearchScrollAction.INSTANCE), searchScrollRequestCaptor.capture(), any());
             }
         }
 
+        @SuppressWarnings("unchecked")
         private void givenInitialResponse(String... hits) {
             SearchResponse searchResponse = createSearchResponseWithHits(hits);
-            ActionFuture<SearchResponse> future = wrapResponse(searchResponse);
-            when(future.actionGet()).thenReturn(searchResponse);
-            when(client.search(searchRequestCaptor.capture())).thenReturn(future);
-        }
 
-        @SuppressWarnings("unchecked")
-        private ActionFuture<SearchResponse> wrapResponse(SearchResponse searchResponse) {
-            ActionFuture<SearchResponse> future = mock(ActionFuture.class);
-            when(future.actionGet()).thenReturn(searchResponse);
-            return future;
+            doAnswer(invocationOnMock -> {
+                ActionListener<SearchResponse> listener = (ActionListener<SearchResponse>) invocationOnMock.getArguments()[2];
+                listener.onResponse(searchResponse);
+                return null;
+            }).when(client).execute(eq(SearchAction.INSTANCE), searchRequestCaptor.capture(), any());
         }
 
         private void givenNextResponse(String... hits) {
@@ -224,7 +228,7 @@ private SearchHits createHits(String... values) {
     }
 
     private static class TestIterator extends BatchedDocumentsIterator<String> {
-        TestIterator(Client client, String jobId) {
+        TestIterator(OriginSettingClient client, String jobId) {
             super(client, jobId);
         }
 

From 2a70a6566f2f5431051f57062fb23f26ab80d492 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Tue, 14 Jan 2020 09:46:01 -0500
Subject: [PATCH 555/686] Switch AggregationSpec to ContextParser (#50871)

We seem to have settled on the `ContextParser` interface for parsing
stuff, mostly because `ObjectParser` implements it. We don't really
*need* the old `Aggregator.Parser` interface any more because it
duplicates `ContextParser` but with the arguments reversed.

This adds support to `AggregationSpec` to declare aggregation parsers
using `ContextParser`. This should integrate cleanly with
`ObjectParser`. It doesn't drop support for `Aggregator.Parser` or
change the plugin intrface at all so it *should* be safe to backport to
7.x. And we can remove `Aggregator.Parser` in a follow up which is only
targeted to 8.0.
---
 .../elasticsearch/plugins/SearchPlugin.java   | 39 +++++++++++++++++--
 .../elasticsearch/search/SearchModule.java    |  6 +--
 2 files changed, 39 insertions(+), 6 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java b/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
index b48f1cbcc3f1c..4e654262912c5 100644
--- a/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
+++ b/server/src/main/java/org/elasticsearch/plugins/SearchPlugin.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.lucene.search.function.ScoreFunction;
+import org.elasticsearch.common.xcontent.ContextParser;
 import org.elasticsearch.common.xcontent.XContent;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.index.query.QueryBuilder;
@@ -248,7 +249,7 @@ public QuerySpec(String name, Writeable.Reader<T> reader, QueryParser<T> parser)
     /**
      * Specification for an {@link Aggregation}.
      */
-    class AggregationSpec extends SearchExtensionSpec<AggregationBuilder, Aggregator.Parser> {
+    class AggregationSpec extends SearchExtensionSpec<AggregationBuilder, ContextParser<String, ? extends AggregationBuilder>> {
         private final Map<String, Writeable.Reader<? extends InternalAggregation>> resultReaders = new TreeMap<>();
 
         /**
@@ -261,7 +262,8 @@ class AggregationSpec extends SearchExtensionSpec<AggregationBuilder, Aggregator
          *        {@link StreamInput}
          * @param parser the parser the reads the aggregation builder from xcontent
          */
-        public AggregationSpec(ParseField name, Writeable.Reader<? extends AggregationBuilder> reader, Aggregator.Parser parser) {
+        public <T extends AggregationBuilder> AggregationSpec(ParseField name, Writeable.Reader<T> reader,
+                ContextParser<String, T> parser) {
             super(name, reader, parser);
         }
 
@@ -274,10 +276,41 @@ public AggregationSpec(ParseField name, Writeable.Reader<? extends AggregationBu
          *        {@link StreamInput}
          * @param parser the parser the reads the aggregation builder from xcontent
          */
-        public AggregationSpec(String name, Writeable.Reader<? extends AggregationBuilder> reader, Aggregator.Parser parser) {
+        public <T extends AggregationBuilder> AggregationSpec(String name, Writeable.Reader<T> reader, ContextParser<String, T> parser) {
             super(name, reader, parser);
         }
 
+        /**
+         * Specification for an {@link Aggregation}.
+         *
+         * @param name holds the names by which this aggregation might be parsed. The {@link ParseField#getPreferredName()} is special as it
+         *        is the name by under which the reader is registered. So it is the name that the {@link AggregationBuilder} should return
+         *        from {@link NamedWriteable#getWriteableName()}.
+         * @param reader the reader registered for this aggregation's builder. Typically a reference to a constructor that takes a
+         *        {@link StreamInput}
+         * @param parser the parser the reads the aggregation builder from xcontent
+         * @deprecated Use the ctor that takes a {@link ContextParser} instead
+         */
+        @Deprecated
+        public AggregationSpec(ParseField name, Writeable.Reader<? extends AggregationBuilder> reader, Aggregator.Parser parser) {
+            super(name, reader, (p, aggName) -> parser.parse(aggName, p));
+        }
+
+        /**
+         * Specification for an {@link Aggregation}.
+         *
+         * @param name the name by which this aggregation might be parsed or deserialized. Make sure that the {@link AggregationBuilder}
+         *        returns this from {@link NamedWriteable#getWriteableName()}.
+         * @param reader the reader registered for this aggregation's builder. Typically a reference to a constructor that takes a
+         *        {@link StreamInput}
+         * @param parser the parser the reads the aggregation builder from xcontent
+         * @deprecated Use the ctor that takes a {@link ContextParser} instead
+         */
+        @Deprecated
+        public AggregationSpec(String name, Writeable.Reader<? extends AggregationBuilder> reader, Aggregator.Parser parser) {
+            super(name, reader, (p, aggName) -> parser.parse(aggName, p));
+        }
+
         /**
          * Add a reader for the shard level results of the aggregation with {@linkplain #getName}'s {@link ParseField#getPreferredName()} as
          * the {@link NamedWriteable#getWriteableName()}.
diff --git a/server/src/main/java/org/elasticsearch/search/SearchModule.java b/server/src/main/java/org/elasticsearch/search/SearchModule.java
index 089132a6ef744..a68413dfc4d03 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchModule.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchModule.java
@@ -422,16 +422,16 @@ private void registerAggregations(List<SearchPlugin> plugins) {
         registerAggregation(new AggregationSpec(GeoCentroidAggregationBuilder.NAME, GeoCentroidAggregationBuilder::new,
                 GeoCentroidAggregationBuilder::parse).addResultReader(InternalGeoCentroid::new));
         registerAggregation(new AggregationSpec(ScriptedMetricAggregationBuilder.NAME, ScriptedMetricAggregationBuilder::new,
-                (name, p) -> ScriptedMetricAggregationBuilder.PARSER.parse(p, name)).addResultReader(InternalScriptedMetric::new));
+                ScriptedMetricAggregationBuilder.PARSER).addResultReader(InternalScriptedMetric::new));
         registerAggregation((new AggregationSpec(CompositeAggregationBuilder.NAME, CompositeAggregationBuilder::new,
-                (name, p) -> CompositeAggregationBuilder.PARSER.parse(p, name)).addResultReader(InternalComposite::new)));
+                CompositeAggregationBuilder.PARSER).addResultReader(InternalComposite::new)));
         registerFromPlugin(plugins, SearchPlugin::getAggregations, this::registerAggregation);
     }
 
     private void registerAggregation(AggregationSpec spec) {
         namedXContents.add(new NamedXContentRegistry.Entry(BaseAggregationBuilder.class, spec.getName(), (p, c) -> {
             String name = (String) c;
-            return spec.getParser().parse(name, p);
+            return spec.getParser().parse(p, name);
         }));
         namedWriteables.add(
                 new NamedWriteableRegistry.Entry(AggregationBuilder.class, spec.getName().getPreferredName(), spec.getReader()));

From 5b656db78a712e1cdd412f78c8e6ce89038bf3c6 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Tue, 14 Jan 2020 15:15:19 +0000
Subject: [PATCH 556/686] Don't use user-supplied type when building
 DocumentMapper (#50960)

This commit begins the process of removing types from the document parsing
infrastructure. Initially, we just ignore the user-supplied type after it has been
removed from the mapping json structure, and always supply _doc as the name
of the root parser.

The production code change is very small here, and most of the changeset
consists of alterations to Mapper test code that was passing in non-standard
type names and checking serialization.

Relates to #41059
---
 .../mapper/RankFeatureFieldMapperTests.java   | 12 +--
 .../RankFeatureMetaFieldMapperTests.java      |  6 +-
 .../mapper/RankFeaturesFieldMapperTests.java  |  8 +-
 .../mapper/ScaledFloatFieldMapperTests.java   | 40 ++++-----
 .../ICUCollationKeywordFieldMapperTests.java  | 44 +++++-----
 .../AnnotatedTextFieldMapperTests.java        | 48 +++++------
 .../index/mapper/DocumentMapperParser.java    | 11 +--
 .../index/mapper/BooleanFieldMapperTests.java |  4 +-
 .../index/mapper/CopyToMapperTests.java       |  6 +-
 .../index/mapper/DateFieldMapperTests.java    | 40 ++++-----
 .../mapper/DocumentMapperParserTests.java     | 10 ---
 .../index/mapper/DocumentMapperTests.java     |  4 +-
 .../index/mapper/DocumentParserTests.java     | 18 ++--
 .../index/mapper/DynamicMappingTests.java     | 46 +++++-----
 .../index/mapper/FieldAliasMapperTests.java   |  4 +-
 .../index/mapper/IpFieldMapperTests.java      | 28 +++---
 .../index/mapper/IpRangeFieldMapperTests.java |  4 +-
 .../index/mapper/KeywordFieldMapperTests.java | 44 +++++-----
 .../LegacyGeoShapeFieldMapperTests.java       |  4 +-
 .../index/mapper/MultiFieldTests.java         |  2 +-
 .../index/mapper/NumberFieldMapperTests.java  | 52 +++++------
 .../index/mapper/ObjectMapperTests.java       | 18 ----
 .../index/mapper/RangeFieldMapperTests.java   | 36 ++++----
 .../index/mapper/RootObjectMapperTests.java   | 48 +++++------
 .../index/mapper/SourceFieldMapperTests.java  | 26 +++---
 .../index/mapper/TextFieldMapperTests.java    | 86 +++++++++----------
 .../index/mapper/TypeFieldMapperTests.java    |  2 +-
 .../mapper/FlatObjectFieldMapperTests.java    | 52 +++++------
 28 files changed, 336 insertions(+), 367 deletions(-)

diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureFieldMapperTests.java
index 04ac52376d4c9..165dbe66f5f66 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureFieldMapperTests.java
@@ -64,11 +64,11 @@ static int getFrequency(TokenStream tk) throws IOException {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "rank_feature").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -99,12 +99,12 @@ public void testDefaults() throws Exception {
     }
 
     public void testNegativeScoreImpact() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "rank_feature")
                 .field("positive_score_impact", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -135,12 +135,12 @@ public void testNegativeScoreImpact() throws Exception {
     }
 
     public void testRejectMultiValuedFields() throws MapperParsingException, IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "rank_feature").endObject().startObject("foo")
                 .startObject("properties").startObject("field").field("type", "rank_feature").endObject().endObject()
                 .endObject().endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureMetaFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureMetaFieldMapperTests.java
index f293e10f9e9ea..46c2316aa161e 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureMetaFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureMetaFieldMapperTests.java
@@ -44,13 +44,13 @@ public void setup() {
     protected Collection<Class<? extends Plugin>> getPlugins() {
         return pluginList(MapperExtrasPlugin.class);
     }
-    
+
     public void testBasics() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "rank_feature").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
         assertNotNull(mapper.metadataMapper(RankFeatureMetaFieldMapper.class));
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeaturesFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeaturesFieldMapperTests.java
index f6dd518191e2c..ea8f2ed16f81b 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeaturesFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeaturesFieldMapperTests.java
@@ -53,11 +53,11 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "rank_features").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -85,12 +85,12 @@ public void testDefaults() throws Exception {
     }
 
     public void testRejectMultiValuedFields() throws MapperParsingException, IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "rank_features").endObject().startObject("foo")
                 .startObject("properties").startObject("field").field("type", "rank_features").endObject().endObject()
                 .endObject().endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
index 94ae0cee76bb7..c5c7358c8220f 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
@@ -58,12 +58,12 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -108,12 +108,12 @@ public void testIllegalScalingFactor() throws IOException {
     }
 
     public void testNotIndexed() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("index", false).field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -132,12 +132,12 @@ public void testNotIndexed() throws Exception {
     }
 
     public void testNoDocValues() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("doc_values", false).field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -156,12 +156,12 @@ public void testNoDocValues() throws Exception {
     }
 
     public void testStore() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("store", true).field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -185,12 +185,12 @@ public void testStore() throws Exception {
     }
 
     public void testCoerce() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -209,12 +209,12 @@ public void testCoerce() throws Exception {
         IndexableField dvField = fields[1];
         assertEquals(DocValuesType.SORTED_NUMERIC, dvField.fieldType().docValuesType());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("scaling_factor", 10.0).field("coerce", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper2.mappingSource().toString());
 
@@ -238,12 +238,12 @@ public void testIgnoreMalformed() throws Exception {
     }
 
     private void doTestIgnoreMalformed(String value, String exceptionMessageContains) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", "scaled_float")
             .field("scaling_factor", 10.0).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -256,12 +256,12 @@ private void doTestIgnoreMalformed(String value, String exceptionMessageContains
         MapperParsingException e = expectThrows(MapperParsingException.class, runnable);
         assertThat(e.getCause().getMessage(), containsString(exceptionMessageContains));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", "scaled_float")
             .field("scaling_factor", 10.0).field("ignore_malformed", true).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(mapping));
 
         ParsedDocument doc = mapper2.parse(new SourceToParse("test", "1", BytesReference
                 .bytes(XContentFactory.jsonBuilder()
@@ -276,7 +276,7 @@ private void doTestIgnoreMalformed(String value, String exceptionMessageContains
 
     public void testNullValue() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "scaled_float")
@@ -285,7 +285,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -297,7 +297,7 @@ public void testNullValue() throws IOException {
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "scaled_float")
@@ -307,7 +307,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         doc = mapper.parse(new SourceToParse("test", "1", BytesReference
diff --git a/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperTests.java b/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperTests.java
index e4db71bc07bb7..630113daf621f 100644
--- a/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperTests.java
+++ b/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperTests.java
@@ -64,11 +64,11 @@ public void setup() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -105,11 +105,11 @@ public void testDefaults() throws Exception {
     }
 
     public void testNullValue() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -120,12 +120,12 @@ public void testNullValue() throws IOException {
             XContentType.JSON));
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("null_value", "1234").endObject().endObject()
             .endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -155,12 +155,12 @@ public void testNullValue() throws IOException {
     }
 
     public void testEnableStore() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("store", true).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -177,12 +177,12 @@ public void testEnableStore() throws IOException {
     }
 
     public void testDisableIndex() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("index", false).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -200,12 +200,12 @@ public void testDisableIndex() throws IOException {
     }
 
     public void testDisableDocValues() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("doc_values", false).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -222,11 +222,11 @@ public void testDisableDocValues() throws IOException {
     }
 
     public void testMultipleValues() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -284,12 +284,12 @@ public void testMultipleValues() throws IOException {
     }
 
     public void testIndexOptions() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("index_options", "freqs").endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -317,12 +317,12 @@ public void testIndexOptions() throws IOException {
     }
 
     public void testEnableNorms() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("norms", true).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -339,14 +339,14 @@ public void testEnableNorms() throws IOException {
     }
 
     public void testCollator() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field")
             .field("type", FIELD_TYPE)
             .field("language", "tr")
             .field("strength", "primary")
             .endObject().endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -406,12 +406,12 @@ public void testUpdateCollator() throws IOException {
 
 
     public void testIgnoreAbove() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("ignore_above", 5).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
diff --git a/plugins/mapper-annotated-text/src/test/java/org/elasticsearch/index/mapper/annotatedtext/AnnotatedTextFieldMapperTests.java b/plugins/mapper-annotated-text/src/test/java/org/elasticsearch/index/mapper/annotatedtext/AnnotatedTextFieldMapperTests.java
index 5acc8c9a82280..885bf834ab23d 100644
--- a/plugins/mapper-annotated-text/src/test/java/org/elasticsearch/index/mapper/annotatedtext/AnnotatedTextFieldMapperTests.java
+++ b/plugins/mapper-annotated-text/src/test/java/org/elasticsearch/index/mapper/annotatedtext/AnnotatedTextFieldMapperTests.java
@@ -252,11 +252,11 @@ public void testAgainstTermVectorsAPI() throws IOException {
     // ===== Code below copied from TextFieldMapperTests ========
 
     public void testDefaults() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", getFieldType()).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -284,11 +284,11 @@ public void testDefaults() throws IOException {
     }
 
     public void testEnableStore() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", getFieldType()).field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -305,14 +305,14 @@ public void testEnableStore() throws IOException {
     }
 
     public void testDisableNorms() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                     .field("type", getFieldType())
                     .field("norms", false)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -360,11 +360,11 @@ public void testIndexOptions() throws IOException {
     }
 
     public void testDefaultPositionIncrementGap() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", getFieldType()).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = indexService.mapperService().merge("type",
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
                 new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         assertEquals(mapping, mapper.mappingSource().toString());
@@ -399,14 +399,14 @@ public void testDefaultPositionIncrementGap() throws IOException {
 
     public void testPositionIncrementGap() throws IOException {
         final int positionIncrementGap = randomIntBetween(1, 1000);
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                     .field("type", getFieldType())
                     .field("position_increment_gap", positionIncrementGap)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = indexService.mapperService().merge("type",
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
                 new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         assertEquals(mapping, mapper.mappingSource().toString());
@@ -440,7 +440,7 @@ public void testPositionIncrementGap() throws IOException {
     }
 
     public void testSearchAnalyzerSerialization() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", getFieldType())
@@ -449,11 +449,11 @@ public void testSearchAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default index analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", getFieldType())
@@ -462,10 +462,10 @@ public void testSearchAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field")
             .field("type", getFieldType())
@@ -473,11 +473,11 @@ public void testSearchAnalyzerSerialization() throws IOException {
             .endObject()
             .endObject().endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default search analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field")
             .field("type", getFieldType())
@@ -486,17 +486,17 @@ public void testSearchAnalyzerSerialization() throws IOException {
             .endObject()
             .endObject().endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field")
             .field("type", getFieldType())
             .field("analyzer", "keyword")
             .endObject()
             .endObject().endObject().endObject());
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         XContentBuilder builder = XContentFactory.jsonBuilder();
         builder.startObject();
@@ -510,7 +510,7 @@ public void testSearchAnalyzerSerialization() throws IOException {
     }
 
     public void testSearchQuoteAnalyzerSerialization() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", getFieldType())
@@ -520,11 +520,11 @@ public void testSearchQuoteAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default index/search analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", getFieldType())
@@ -534,7 +534,7 @@ public void testSearchQuoteAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapperParser.java b/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapperParser.java
index d4f16bcaf8458..1307e74f9f2f5 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapperParser.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapperParser.java
@@ -74,25 +74,22 @@ public DocumentMapper parse(@Nullable String type, CompressedXContent source) th
         if (source != null) {
             Map<String, Object> root = XContentHelper.convertToMap(source.compressedReference(), true, XContentType.JSON).v2();
             Tuple<String, Map<String, Object>> t = extractMapping(type, root);
-            type = t.v1();
             mapping = t.v2();
         }
         if (mapping == null) {
             mapping = new HashMap<>();
         }
-        return parse(type, mapping);
+        return parse(mapping);
     }
 
     @SuppressWarnings({"unchecked"})
-    private DocumentMapper parse(String type, Map<String, Object> mapping) throws MapperParsingException {
-        if (type == null) {
-            throw new MapperParsingException("Failed to derive type");
-        }
+    private DocumentMapper parse(Map<String, Object> mapping) throws MapperParsingException {
 
         Mapper.TypeParser.ParserContext parserContext = parserContext();
         // parse RootObjectMapper
         DocumentMapper.Builder docBuilder = new DocumentMapper.Builder(
-                (RootObjectMapper.Builder) rootObjectTypeParser.parse(type, mapping, parserContext), mapperService);
+            (RootObjectMapper.Builder) rootObjectTypeParser.parse(MapperService.SINGLE_MAPPING_NAME, mapping, parserContext),
+            mapperService);
         Iterator<Map.Entry<String, Object>> iterator = mapping.entrySet().iterator();
         // parse DocumentMapper
         while(iterator.hasNext()) {
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
index 1fd3f51ece916..d8712f582a5e5 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
@@ -180,7 +180,7 @@ public void testParsesBooleansNestedStrict() throws IOException {
 
 
     public void testMultiFields() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "boolean")
@@ -192,7 +192,7 @@ public void testMultiFields() throws IOException {
                     .endObject().endObject()
                 .endObject().endObject());
         DocumentMapper mapper = indexService.mapperService()
-            .merge("type", new CompressedXContent(mapping), MapperService.MergeReason.MAPPING_UPDATE);
+            .merge("_doc", new CompressedXContent(mapping), MapperService.MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
         BytesReference source = BytesReference.bytes(XContentFactory.jsonBuilder()
                 .startObject()
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperTests.java
index 6805db662821f..445611aba40fb 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperTests.java
@@ -232,7 +232,7 @@ public void testCopyToDynamicInnerInnerObjectParsing() throws Exception {
     }
 
     public void testCopyToStrictDynamicInnerObjectParsing() throws Exception {
-        String mapping = Strings.toString(jsonBuilder().startObject().startObject("type1")
+        String mapping = Strings.toString(jsonBuilder().startObject().startObject("_doc")
             .field("dynamic", "strict")
                 .startObject("properties")
                     .startObject("copy_test")
@@ -243,7 +243,7 @@ public void testCopyToStrictDynamicInnerObjectParsing() throws Exception {
             .endObject().endObject());
 
         DocumentMapper docMapper = createIndex("test").mapperService().documentMapperParser()
-            .parse("type1", new CompressedXContent(mapping));
+            .parse("_doc", new CompressedXContent(mapping));
 
         BytesReference json = BytesReference.bytes(jsonBuilder().startObject()
             .field("copy_test", "foo")
@@ -253,7 +253,7 @@ public void testCopyToStrictDynamicInnerObjectParsing() throws Exception {
             docMapper.parse(new SourceToParse("test", "1", json, XContentType.JSON)).rootDoc();
             fail();
         } catch (MapperParsingException ex) {
-            assertThat(ex.getMessage(), startsWith("mapping set to strict, dynamic introduction of [very] within [type1] is not allowed"));
+            assertThat(ex.getMessage(), startsWith("mapping set to strict, dynamic introduction of [very] within [_doc] is not allowed"));
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
index 477cf7de8285c..e7b2b90832ae6 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
@@ -62,11 +62,11 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "date").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -91,11 +91,11 @@ public void testDefaults() throws Exception {
     }
 
     public void testNotIndexed() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "date").field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -113,11 +113,11 @@ public void testNotIndexed() throws Exception {
     }
 
     public void testNoDocValues() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "date").field("doc_values", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -135,11 +135,11 @@ public void testNoDocValues() throws Exception {
     }
 
     public void testStore() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "date").field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -169,11 +169,11 @@ public void testIgnoreMalformed() throws IOException {
     }
 
     private void testIgnoreMalfomedForValue(String value, String expectedException) throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "date").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -206,12 +206,12 @@ private void testIgnoreMalfomedForValue(String value, String expectedException)
     }
 
     public void testChangeFormat() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "date")
                 .field("format", "epoch_second").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -230,13 +230,13 @@ public void testChangeFormat() throws IOException {
 
     public void testChangeLocale() throws IOException {
         assumeTrue("need java 9 for testing ",JavaVersion.current().compareTo(JavaVersion.parse("9")) >= 0);
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "date")
                     .field("format", "E, d MMM yyyy HH:mm:ss Z")
                     .field("locale", "de")
             .endObject().endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -250,7 +250,7 @@ public void testChangeLocale() throws IOException {
 
     public void testNullValue() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "date")
@@ -258,7 +258,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -270,7 +270,7 @@ public void testNullValue() throws IOException {
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "date")
@@ -279,7 +279,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -332,7 +332,7 @@ public void testTimeZoneParsing() throws Exception {
         final String timeZonePattern = "yyyy-MM-dd" + randomFrom("XXX", "[XXX]", "'['XXX']'");
 
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "date")
@@ -341,7 +341,7 @@ public void testTimeZoneParsing() throws Exception {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         DateFormatter formatter = DateFormatter.forPattern(timeZonePattern);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperParserTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperParserTests.java
index c35e083d687b1..b16ecb9a1591b 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperParserTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperParserTests.java
@@ -25,17 +25,7 @@
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.test.ESSingleNodeTestCase;
 
-import static org.hamcrest.Matchers.equalTo;
-
 public class DocumentMapperParserTests extends ESSingleNodeTestCase {
-    public void testTypeLevel() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
-                .endObject().endObject());
-
-        DocumentMapperParser parser = createIndex("test").mapperService().documentMapperParser();
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
-        assertThat(mapper.type(), equalTo("type"));
-    }
 
     public void testFieldNameWithDots() throws Exception {
         IndexService indexService = createIndex("test");
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
index 724c53d04f15b..8a14c1fbcca36 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
@@ -155,7 +155,7 @@ public void testChangeSearchAnalyzerToDefault() throws Exception {
 
     public void testConcurrentMergeTest() throws Throwable {
         final MapperService mapperService = createIndex("test").mapperService();
-        mapperService.merge("test", new CompressedXContent("{\"test\":{}}"), MapperService.MergeReason.MAPPING_UPDATE);
+        mapperService.merge("_doc", new CompressedXContent("{\"_doc\":{}}"), MapperService.MergeReason.MAPPING_UPDATE);
         final DocumentMapper documentMapper = mapperService.documentMapper();
 
         DocumentFieldMappers dfm = documentMapper.mappers();
@@ -184,7 +184,7 @@ public void run() {
                         Mapping update = doc.dynamicMappingsUpdate();
                         assert update != null;
                         lastIntroducedFieldName.set(fieldName);
-                        mapperService.merge("test", new CompressedXContent(update.toString()), MapperService.MergeReason.MAPPING_UPDATE);
+                        mapperService.merge("_doc", new CompressedXContent(update.toString()), MapperService.MergeReason.MAPPING_UPDATE);
                     }
                 } catch (Exception e) {
                     error.set(e);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DocumentParserTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DocumentParserTests.java
index e430125f28187..1d76efdd008b4 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DocumentParserTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DocumentParserTests.java
@@ -549,7 +549,7 @@ public void testDynamicStrictLongArray() throws Exception {
             .endArray().endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
     }
 
     public void testMappedGeoPointArray() throws Exception {
@@ -631,7 +631,7 @@ public void testDynamicStrictObject() throws Exception {
                 .endObject().endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
     }
 
     public void testDynamicFalseValue() throws Exception {
@@ -662,7 +662,7 @@ public void testDynamicStrictValue() throws Exception {
                 .endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [bar] within [type] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [bar] within [_doc] is not allowed", exception.getMessage());
     }
 
     public void testDynamicFalseNull() throws Exception {
@@ -693,7 +693,7 @@ public void testDynamicStrictNull() throws Exception {
                 .endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [bar] within [type] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [bar] within [_doc] is not allowed", exception.getMessage());
     }
 
     public void testMappedNullValue() throws Exception {
@@ -892,7 +892,7 @@ public void testDynamicStrictDottedFieldNameLongArray() throws Exception {
             .endArray().endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
     }
 
     public void testDynamicDottedFieldNameLong() throws Exception {
@@ -1009,7 +1009,7 @@ public void testDynamicStrictDottedFieldNameLong() throws Exception {
             .endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
     }
 
     public void testDynamicDottedFieldNameObject() throws Exception {
@@ -1136,7 +1136,7 @@ public void testDynamicStrictDottedFieldNameObject() throws Exception {
             .endObject().endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
     }
 
     public void testDocumentContainsMetadataField() throws Exception {
@@ -1175,7 +1175,7 @@ public void testParseToJsonAndParse() throws Exception {
         DocumentMapper docMapper = parser.parse("person", new CompressedXContent(mapping));
         String builtMapping = docMapper.mappingSource().string();
         // reparse it
-        DocumentMapper builtDocMapper = parser.parse("person", new CompressedXContent(builtMapping));
+        DocumentMapper builtDocMapper = parser.parse("_doc", new CompressedXContent(builtMapping));
         BytesReference json = new BytesArray(copyToBytesFromClasspath("/org/elasticsearch/index/mapper/simple/test1.json"));
         Document doc = builtDocMapper.parse(new SourceToParse("test", "1", json, XContentType.JSON)).rootDoc();
         assertThat(doc.getBinaryValue(docMapper.idFieldMapper().name()), equalTo(Uid.encodeId("1")));
@@ -1213,7 +1213,7 @@ public void testAttributes() throws Exception {
         assertThat((String) docMapper.meta().get("param1"), equalTo("value1"));
 
         String builtMapping = docMapper.mappingSource().string();
-        DocumentMapper builtDocMapper = parser.parse("person", new CompressedXContent(builtMapping));
+        DocumentMapper builtDocMapper = parser.parse("_doc", new CompressedXContent(builtMapping));
         assertThat((String) builtDocMapper.meta().get("param1"), equalTo("value1"));
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
index 9e0d9155d43bd..bb0a0af1b64a3 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
@@ -123,7 +123,7 @@ public void testDynamicStrict() throws IOException {
                         .field("field2", "value2")
                         .endObject()),
                 XContentType.JSON)));
-        assertThat(e.getMessage(), equalTo("mapping set to strict, dynamic introduction of [field2] within [type] is not allowed"));
+        assertThat(e.getMessage(), equalTo("mapping set to strict, dynamic introduction of [field2] within [_doc] is not allowed"));
 
         e = expectThrows(StrictDynamicMappingException.class,
             () -> defaultMapper.parse(new SourceToParse("test", "1",
@@ -133,7 +133,7 @@ public void testDynamicStrict() throws IOException {
                                 .field("field2", (String) null)
                                 .endObject()),
                     XContentType.JSON)));
-        assertThat(e.getMessage(), equalTo("mapping set to strict, dynamic introduction of [field2] within [type] is not allowed"));
+        assertThat(e.getMessage(), equalTo("mapping set to strict, dynamic introduction of [field2] within [_doc] is not allowed"));
     }
 
     public void testDynamicFalseWithInnerObjectButDynamicSetOnRoot() throws IOException {
@@ -234,10 +234,10 @@ public void testField() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type").endObject()
+                .startObject("_doc").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().field("foo", "bar").endObject());
@@ -245,7 +245,7 @@ public void testField() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("foo")
                     .field("type", "text")
                     .startObject("fields")
@@ -263,11 +263,11 @@ public void testIncremental() throws Exception {
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         // Make sure that mapping updates are incremental, this is important for performance otherwise
         // every new field introduction runs in linear time with the total number of fields
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("foo").field("type", "text").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().field("foo", "bar")
@@ -276,7 +276,7 @@ public void testIncremental() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 // foo is NOT in the update
                 .startObject("bar").field("type", "text")
                     .startObject("fields")
@@ -293,10 +293,10 @@ public void testIntroduceTwoFields() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type").endObject()
+                .startObject("_doc").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().field("foo", "bar")
@@ -305,7 +305,7 @@ public void testIntroduceTwoFields() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("bar").field("type", "text")
                     .startObject("fields")
                         .startObject("keyword")
@@ -329,10 +329,10 @@ public void testObject() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type").endObject()
+                .startObject("_doc").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().startObject("foo").startObject("bar")
@@ -341,7 +341,7 @@ public void testObject() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("foo").startObject("properties").startObject("bar").startObject("properties").startObject("baz")
                 .field("type", "text")
                 .startObject("fields").startObject("keyword").field("type", "keyword")
@@ -354,10 +354,10 @@ public void testArray() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type").endObject()
+                .startObject("_doc").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject()
@@ -366,7 +366,7 @@ public void testArray() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("foo")
                     .field("type", "text")
                     .startObject("fields")
@@ -382,11 +382,11 @@ public void testArray() throws Exception {
     public void testInnerDynamicMapping() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type") .startObject("properties")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc") .startObject("properties")
                 .startObject("foo").field("type", "object").endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().startObject("foo")
@@ -395,7 +395,7 @@ public void testInnerDynamicMapping() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("foo").startObject("properties").startObject("bar").startObject("properties")
                 .startObject("baz").field("type", "text").startObject("fields")
                 .startObject("keyword").field("type", "keyword").field("ignore_above", 256).endObject()
@@ -407,10 +407,10 @@ public void testComplexArray() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type").endObject()
+                .startObject("_doc").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().startArray("foo")
@@ -418,7 +418,7 @@ public void testComplexArray() throws Exception {
                 .startObject().field("baz", 3).endObject()
                 .endArray().endObject());
         assertEquals(mapping, serialize(mapper));
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("foo").startObject("properties")
                 .startObject("bar").field("type", "text")
                     .startObject("fields")
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/FieldAliasMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/FieldAliasMapperTests.java
index 9f87ad3d0390a..e09953d31abc8 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/FieldAliasMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/FieldAliasMapperTests.java
@@ -43,7 +43,7 @@ public void setup() {
     public void testParsing() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("alias-field")
                             .field("type", "alias")
@@ -55,7 +55,7 @@ public void testParsing() throws IOException {
                     .endObject()
                 .endObject()
             .endObject());
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/IpFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/IpFieldMapperTests.java
index a34adaca2f144..1adc12548c090 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/IpFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/IpFieldMapperTests.java
@@ -60,11 +60,11 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "ip").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -89,11 +89,11 @@ public void testDefaults() throws Exception {
     }
 
     public void testNotIndexed() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "ip").field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -111,11 +111,11 @@ public void testNotIndexed() throws Exception {
     }
 
     public void testNoDocValues() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "ip").field("doc_values", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -134,11 +134,11 @@ public void testNoDocValues() throws Exception {
     }
 
     public void testStore() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "ip").field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -162,11 +162,11 @@ public void testStore() throws Exception {
     }
 
     public void testIgnoreMalformed() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "ip").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -199,7 +199,7 @@ public void testIgnoreMalformed() throws Exception {
 
     public void testNullValue() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "ip")
@@ -207,7 +207,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -219,7 +219,7 @@ public void testNullValue() throws IOException {
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "ip")
@@ -228,7 +228,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         doc = mapper.parse(new SourceToParse("test", "1", BytesReference
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/IpRangeFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/IpRangeFieldMapperTests.java
index 2f861ca6fc79c..0c4b11004b460 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/IpRangeFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/IpRangeFieldMapperTests.java
@@ -48,11 +48,11 @@ public void setup() {
     }
 
     public void testStoreCidr() throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", "ip_range")
             .field("store", true);
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
         final Map<String, String> cases = new HashMap<>();
         cases.put("192.168.0.0/15", "192.169.255.255");
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
index fd821f1170ce8..c2063d1478a9b 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
@@ -94,11 +94,11 @@ public void setup() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -131,11 +131,11 @@ public void testDefaults() throws Exception {
     }
 
     public void testIgnoreAbove() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword").field("ignore_above", 5).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -161,11 +161,11 @@ public void testIgnoreAbove() throws IOException {
     }
 
     public void testNullValue() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -176,11 +176,11 @@ public void testNullValue() throws IOException {
                 XContentType.JSON));
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword").field("null_value", "uri").endObject().endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -206,11 +206,11 @@ public void testNullValue() throws IOException {
     }
 
     public void testEnableStore() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword").field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -227,11 +227,11 @@ public void testEnableStore() throws IOException {
     }
 
     public void testDisableIndex() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword").field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -249,11 +249,11 @@ public void testDisableIndex() throws IOException {
     }
 
     public void testDisableDocValues() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword").field("doc_values", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -270,12 +270,12 @@ public void testDisableDocValues() throws IOException {
     }
 
     public void testIndexOptions() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword")
                 .field("index_options", "freqs").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -302,17 +302,17 @@ public void testIndexOptions() throws IOException {
     }
 
     public void testBoost() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "keyword").field("boost", 2f).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
     }
 
     public void testEnableNorms() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
                 .startObject("field")
                     .field("type", "keyword")
@@ -322,7 +322,7 @@ public void testEnableNorms() throws IOException {
             .endObject()
         .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -341,12 +341,12 @@ public void testEnableNorms() throws IOException {
     }
 
     public void testNormalizer() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                 .field("type", "keyword").field("normalizer", "my_lowercase").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/LegacyGeoShapeFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/LegacyGeoShapeFieldMapperTests.java
index d53eb0bcac134..df6b43d041acf 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/LegacyGeoShapeFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/LegacyGeoShapeFieldMapperTests.java
@@ -53,7 +53,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaultConfiguration() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("location")
                     .field("type", "geo_shape")
                     .field("strategy", "recursive")
@@ -61,7 +61,7 @@ public void testDefaultConfiguration() throws IOException {
                 .endObject().endObject());
 
         DocumentMapper defaultMapper = createIndex("test").mapperService().documentMapperParser()
-            .parse("type1", new CompressedXContent(mapping));
+            .parse("_doc", new CompressedXContent(mapping));
         Mapper fieldMapper = defaultMapper.mappers().getMapper("location");
         assertThat(fieldMapper, instanceOf(LegacyGeoShapeFieldMapper.class));
         assertEquals(mapping, defaultMapper.mappingSource().toString());
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldTests.java b/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldTests.java
index f32608b53c79b..d6dfe8054f4b5 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldTests.java
@@ -186,7 +186,7 @@ public void testMultiFieldsInConsistentOrder() throws Exception {
             XContentHelper.convertToMap(docMapper.mappingSource().compressedReference(), true, builder.contentType()).v2();
         @SuppressWarnings("unchecked")
         Map<String, Object> multiFields =
-            (Map<String, Object>) XContentMapValues.extractValue("type.properties.my_field.fields", sourceAsMap);
+            (Map<String, Object>) XContentMapValues.extractValue("_doc.properties.my_field.fields", sourceAsMap);
         assertThat(multiFields.size(), equalTo(multiFieldNames.length));
 
         int i = 0;
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/NumberFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/NumberFieldMapperTests.java
index a1322c6614456..3181a92434121 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/NumberFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/NumberFieldMapperTests.java
@@ -53,11 +53,11 @@ protected void setTypeList() {
 
     @Override
     public void doTestDefaults(String type) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", type).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -81,11 +81,11 @@ public void doTestDefaults(String type) throws Exception {
 
     @Override
     public void doTestNotIndexed(String type) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", type).field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -104,11 +104,11 @@ public void doTestNotIndexed(String type) throws Exception {
 
     @Override
     public void doTestNoDocValues(String type) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", type).field("doc_values", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -128,11 +128,11 @@ public void doTestNoDocValues(String type) throws Exception {
 
     @Override
     public void doTestStore(String type) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", type).field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -157,11 +157,11 @@ public void doTestStore(String type) throws Exception {
 
     @Override
     public void doTestCoerce(String type) throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", type).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -180,11 +180,11 @@ public void doTestCoerce(String type) throws IOException {
         IndexableField dvField = fields[1];
         assertEquals(DocValuesType.SORTED_NUMERIC, dvField.fieldType().docValuesType());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", type).field("coerce", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper2.mappingSource().toString());
 
@@ -200,11 +200,11 @@ public void doTestCoerce(String type) throws IOException {
 
     @Override
     protected void doTestDecimalCoerce(String type) throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", type).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -223,10 +223,10 @@ protected void doTestDecimalCoerce(String type) throws IOException {
     public void testIgnoreMalformed() throws Exception {
         for (String type : TYPES) {
             for (Object malformedValue : new Object[] { "a", Boolean.FALSE }) {
-                String mapping = Strings.toString(jsonBuilder().startObject().startObject("type").startObject("properties")
+                String mapping = Strings.toString(jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field").field("type", type).endObject().endObject().endObject().endObject());
 
-                DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+                DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
                 assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -240,10 +240,10 @@ public void testIgnoreMalformed() throws Exception {
                     assertThat(e.getCause().getMessage(), containsString("not numeric, can not use numeric value accessors"));
                 }
 
-                mapping = Strings.toString(jsonBuilder().startObject().startObject("type").startObject("properties").startObject("field")
+                mapping = Strings.toString(jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field")
                         .field("type", type).field("ignore_malformed", true).endObject().endObject().endObject().endObject());
 
-                DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(mapping));
+                DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(mapping));
 
                 ParsedDocument doc = mapper2.parse(new SourceToParse("test", "1",
                         BytesReference.bytes(jsonBuilder().startObject().field("field", malformedValue).endObject()), XContentType.JSON));
@@ -268,9 +268,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             };
             for (Boolean ignoreMalformed : new Boolean[] { true, false }) {
                 String mapping = Strings.toString(
-                        jsonBuilder().startObject().startObject("type").startObject("properties").startObject("field").field("type", type)
+                        jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field").field("type", type)
                                 .field("ignore_malformed", ignoreMalformed).endObject().endObject().endObject().endObject());
-                DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+                DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
                 assertEquals(mapping, mapper.mappingSource().toString());
 
                 MapperParsingException e = expectThrows(MapperParsingException.class,
@@ -287,7 +287,7 @@ public void testRejectNorms() throws IOException {
         // not supported as of 5.0
         for (String type : TYPES) {
             DocumentMapperParser parser = createIndex("index-" + type).mapperService().documentMapperParser();
-            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("foo")
                         .field("type", type)
@@ -295,7 +295,7 @@ public void testRejectNorms() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
             MapperParsingException e = expectThrows(MapperParsingException.class,
-                    () -> parser.parse("type", new CompressedXContent(mapping)));
+                    () -> parser.parse("_doc", new CompressedXContent(mapping)));
             assertThat(e.getMessage(), containsString("Mapping definition for [foo] has unsupported parameters:  [norms"));
         }
     }
@@ -322,7 +322,7 @@ public void testRejectIndexOptions() throws IOException {
     @Override
     protected void doTestNullValue(String type) throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", type)
@@ -330,7 +330,7 @@ protected void doTestNullValue(String type) throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -348,7 +348,7 @@ protected void doTestNullValue(String type) throws IOException {
             missing = 123L;
         }
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", type)
@@ -357,7 +357,7 @@ protected void doTestNullValue(String type) throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         doc = mapper.parse(new SourceToParse("test", "1", BytesReference
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/ObjectMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/ObjectMapperTests.java
index 7672eb3df26b6..154ebf30f5984 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/ObjectMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/ObjectMapperTests.java
@@ -181,24 +181,6 @@ public void testMerge() throws IOException {
         assertEquals(Dynamic.STRICT, mapper.root().dynamic());
     }
 
-    public void testEmptyName() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder()
-            .startObject()
-                .startObject("")
-                    .startObject("properties")
-                        .startObject("name")
-                            .field("type", "text")
-                        .endObject()
-                    .endObject()
-                .endObject().endObject());
-
-        // Empty name not allowed in index created after 5.0
-        IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> {
-            createIndex("test").mapperService().documentMapperParser().parse("", new CompressedXContent(mapping));
-        });
-        assertThat(e.getMessage(), containsString("name cannot be empty string"));
-    }
-
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
         return pluginList(InternalSettingsPlugin.class);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldMapperTests.java
index d713988e19197..4c8b7c3794280 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldMapperTests.java
@@ -111,14 +111,14 @@ private Object getMax(String type) {
 
     @Override
     public void doTestDefaults(String type) throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", type);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference.bytes(XContentFactory.jsonBuilder()
@@ -142,14 +142,14 @@ public void doTestDefaults(String type) throws Exception {
 
     @Override
     protected void doTestNotIndexed(String type) throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", type).field("index", false);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference.bytes(XContentFactory.jsonBuilder()
@@ -167,13 +167,13 @@ protected void doTestNotIndexed(String type) throws Exception {
 
     @Override
     protected void doTestNoDocValues(String type) throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", type).field("doc_values", false);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference.bytes(XContentFactory.jsonBuilder()
@@ -193,13 +193,13 @@ protected void doTestNoDocValues(String type) throws Exception {
 
     @Override
     protected void doTestStore(String type) throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", type).field("store", true);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference.bytes(XContentFactory.jsonBuilder()
@@ -231,13 +231,13 @@ protected void doTestStore(String type) throws Exception {
 
     @Override
     public void doTestCoerce(String type) throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", type);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
 
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
@@ -260,9 +260,9 @@ public void doTestCoerce(String type) throws IOException {
         // date_range ignores the coerce parameter and epoch_millis date format truncates floats (see issue: #14641)
         if (type.equals("date_range") == false) {
 
-            mapping = XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties").startObject("field")
+            mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field")
                     .field("type", type).field("coerce", false).endObject().endObject().endObject().endObject();
-            DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+            DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
 
             assertEquals(Strings.toString(mapping), mapper2.mappingSource().toString());
 
@@ -279,11 +279,11 @@ public void doTestCoerce(String type) throws IOException {
 
     @Override
     protected void doTestDecimalCoerce(String type) throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", type);
 
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
 
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
@@ -313,14 +313,14 @@ protected void doTestDecimalCoerce(String type) throws IOException {
 
     @Override
     protected void doTestNullValue(String type) throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", type).field("store", true);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         // test null value for min and max
@@ -383,14 +383,14 @@ public void testNoBounds() throws Exception {
     }
 
     public void doTestNoBounds(String type) throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties").startObject("field").field("type", type).field("store", true);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         // test no bounds specified
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/RootObjectMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/RootObjectMapperTests.java
index 0b805eb726646..8946d7a235420 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/RootObjectMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/RootObjectMapperTests.java
@@ -32,99 +32,99 @@ public class RootObjectMapperTests extends ESSingleNodeTestCase {
     public void testNumericDetection() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("type")
+                    .startObject("_doc")
                         .field("numeric_detection", false)
                     .endObject()
                 .endObject());
         MapperService mapperService = createIndex("test").mapperService();
-        DocumentMapper mapper = mapperService.merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        DocumentMapper mapper = mapperService.merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         // update with a different explicit value
         String mapping2 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .field("numeric_detection", true)
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("type", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("_doc", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping2, mapper.mappingSource().toString());
 
         // update with an implicit value: no change
         String mapping3 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type")
+                .startObject("_doc")
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("type", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("_doc", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping2, mapper.mappingSource().toString());
     }
 
     public void testDateDetection() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("type")
+                    .startObject("_doc")
                         .field("date_detection", true)
                     .endObject()
                 .endObject());
         MapperService mapperService = createIndex("test").mapperService();
-        DocumentMapper mapper = mapperService.merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        DocumentMapper mapper = mapperService.merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         // update with a different explicit value
         String mapping2 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .field("date_detection", false)
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("type", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("_doc", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping2, mapper.mappingSource().toString());
 
         // update with an implicit value: no change
         String mapping3 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type")
+                .startObject("_doc")
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("type", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("_doc", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping2, mapper.mappingSource().toString());
     }
 
     public void testDateFormatters() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("type")
+                    .startObject("_doc")
                         .field("dynamic_date_formats", Arrays.asList("yyyy-MM-dd"))
                     .endObject()
                 .endObject());
         MapperService mapperService = createIndex("test").mapperService();
-        DocumentMapper mapper = mapperService.merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        DocumentMapper mapper = mapperService.merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         // no update if formatters are not set explicitly
         String mapping2 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type")
+                .startObject("_doc")
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("type", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("_doc", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         String mapping3 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .field("dynamic_date_formats", Arrays.asList())
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("type", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("_doc", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping3, mapper.mappingSource().toString());
     }
 
     public void testDynamicTemplates() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("type")
+                    .startObject("_doc")
                         .startArray("dynamic_templates")
                             .startObject()
                                 .startObject("my_template")
@@ -138,25 +138,25 @@ public void testDynamicTemplates() throws Exception {
                     .endObject()
                 .endObject());
         MapperService mapperService = createIndex("test").mapperService();
-        DocumentMapper mapper = mapperService.merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        DocumentMapper mapper = mapperService.merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         // no update if templates are not set explicitly
         String mapping2 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type")
+                .startObject("_doc")
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("type", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("_doc", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         String mapping3 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .field("dynamic_templates", Arrays.asList())
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("type", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("_doc", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping3, mapper.mappingSource().toString());
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
index cbfbb4a05c973..25c59fb26ddb1 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
@@ -121,13 +121,13 @@ public void testExcludes() throws Exception {
     }
 
     private void assertConflicts(String mapping1, String mapping2, DocumentMapperParser parser, String... conflicts) throws IOException {
-        DocumentMapper docMapper = parser.parse("type", new CompressedXContent(mapping1));
-        docMapper = parser.parse("type", docMapper.mappingSource());
+        DocumentMapper docMapper = parser.parse("_doc", new CompressedXContent(mapping1));
+        docMapper = parser.parse("_doc", docMapper.mappingSource());
         if (conflicts.length == 0) {
-            docMapper.merge(parser.parse("type", new CompressedXContent(mapping2)).mapping());
+            docMapper.merge(parser.parse("_doc", new CompressedXContent(mapping2)).mapping());
         } else {
             try {
-                docMapper.merge(parser.parse("type", new CompressedXContent(mapping2)).mapping());
+                docMapper.merge(parser.parse("_doc", new CompressedXContent(mapping2)).mapping());
                 fail();
             } catch (IllegalArgumentException e) {
                 for (String conflict : conflicts) {
@@ -140,14 +140,14 @@ private void assertConflicts(String mapping1, String mapping2, DocumentMapperPar
     public void testEnabledNotUpdateable() throws Exception {
         DocumentMapperParser parser = createIndex("test").mapperService().documentMapperParser();
         // using default of true
-        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").endObject().endObject());
-        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").endObject().endObject());
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("_source").field("enabled", false).endObject()
             .endObject().endObject());
         assertConflicts(mapping1, mapping2, parser, "Cannot update enabled setting for [_source]");
 
         // not changing is ok
-        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("_source").field("enabled", true).endObject()
             .endObject().endObject());
         assertConflicts(mapping1, mapping3, parser);
@@ -155,14 +155,14 @@ public void testEnabledNotUpdateable() throws Exception {
 
     public void testIncludesNotUpdateable() throws Exception {
         DocumentMapperParser parser = createIndex("test").mapperService().documentMapperParser();
-        String defaultMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").endObject().endObject());
-        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String defaultMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").endObject().endObject());
+        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("_source").array("includes", "foo.*").endObject()
             .endObject().endObject());
         assertConflicts(defaultMapping, mapping1, parser, "Cannot update includes setting for [_source]");
         assertConflicts(mapping1, defaultMapping, parser, "Cannot update includes setting for [_source]");
 
-        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("_source").array("includes", "foo.*", "bar.*").endObject()
             .endObject().endObject());
         assertConflicts(mapping1, mapping2, parser, "Cannot update includes setting for [_source]");
@@ -173,14 +173,14 @@ public void testIncludesNotUpdateable() throws Exception {
 
     public void testExcludesNotUpdateable() throws Exception {
         DocumentMapperParser parser = createIndex("test").mapperService().documentMapperParser();
-        String defaultMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").endObject().endObject());
-        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String defaultMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").endObject().endObject());
+        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("_source").array("excludes", "foo.*").endObject()
             .endObject().endObject());
         assertConflicts(defaultMapping, mapping1, parser, "Cannot update excludes setting for [_source]");
         assertConflicts(mapping1, defaultMapping, parser, "Cannot update excludes setting for [_source]");
 
-        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("_source").array("excludes", "foo.*", "bar.*").endObject()
             .endObject().endObject());
         assertConflicts(mapping1, mapping2, parser, "Cannot update excludes setting for [_source]");
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
index 539d8bbdeaf59..6d73ed8cfb1bc 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
@@ -106,11 +106,11 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "text").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -138,11 +138,11 @@ public void testDefaults() throws IOException {
     }
 
     public void testEnableStore() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "text").field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -159,11 +159,11 @@ public void testEnableStore() throws IOException {
     }
 
     public void testDisableIndex() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "text").field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -179,14 +179,14 @@ public void testDisableIndex() throws IOException {
     }
 
     public void testDisableNorms() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("norms", false)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -234,11 +234,11 @@ public void testIndexOptions() throws IOException {
     }
 
     public void testDefaultPositionIncrementGap() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field").field("type", "text").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = indexService.mapperService().merge("type",
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
                 new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         assertEquals(mapping, mapper.mappingSource().toString());
@@ -273,14 +273,14 @@ public void testDefaultPositionIncrementGap() throws IOException {
 
     public void testPositionIncrementGap() throws IOException {
         final int positionIncrementGap = randomIntBetween(1, 1000);
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("position_increment_gap", positionIncrementGap)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = indexService.mapperService().merge("type",
+        DocumentMapper mapper = indexService.mapperService().merge("_doc",
                 new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         assertEquals(mapping, mapper.mappingSource().toString());
@@ -314,7 +314,7 @@ public void testPositionIncrementGap() throws IOException {
     }
 
     public void testSearchAnalyzerSerialization() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "text")
@@ -323,11 +323,11 @@ public void testSearchAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default index analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "text")
@@ -336,10 +336,10 @@ public void testSearchAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field")
             .field("type", "text")
@@ -347,11 +347,11 @@ public void testSearchAnalyzerSerialization() throws IOException {
             .endObject()
             .endObject().endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default search analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field")
             .field("type", "text")
@@ -360,17 +360,17 @@ public void testSearchAnalyzerSerialization() throws IOException {
             .endObject()
             .endObject().endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field")
             .field("type", "text")
             .field("analyzer", "keyword")
             .endObject()
             .endObject().endObject().endObject());
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         XContentBuilder builder = XContentFactory.jsonBuilder();
         builder.startObject();
@@ -384,7 +384,7 @@ public void testSearchAnalyzerSerialization() throws IOException {
     }
 
     public void testSearchQuoteAnalyzerSerialization() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "text")
@@ -394,11 +394,11 @@ public void testSearchQuoteAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default index/search analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "text")
@@ -408,7 +408,7 @@ public void testSearchQuoteAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        mapper = parser.parse("type", new CompressedXContent(mapping));
+        mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
     }
 
@@ -488,14 +488,14 @@ public void testTermVectors() throws IOException {
     }
 
     public void testEagerGlobalOrdinals() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("eager_global_ordinals", true)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         FieldMapper fieldMapper = (FieldMapper) mapper.mappers().getMapper("field");
@@ -503,13 +503,13 @@ public void testEagerGlobalOrdinals() throws IOException {
     }
 
     public void testFielddata() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper disabledMapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper disabledMapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, disabledMapper.mappingSource().toString());
         IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> {
             FieldMapper fieldMapper = (FieldMapper) disabledMapper.mappers().getMapper("field");
@@ -517,14 +517,14 @@ public void testFielddata() throws IOException {
         });
         assertThat(e.getMessage(), containsString("Fielddata is disabled"));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("fielddata", true)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper enabledMapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper enabledMapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, enabledMapper.mappingSource().toString());
 
@@ -544,7 +544,7 @@ public void testFielddata() throws IOException {
     }
 
     public void testFrequencyFilter() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("fielddata", true)
@@ -555,7 +555,7 @@ public void testFrequencyFilter() throws IOException {
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
         TextFieldMapper fieldMapper = (TextFieldMapper) mapper.mappers().getMapper("field");
@@ -778,7 +778,7 @@ public void testFastPhraseMapping() throws IOException {
                 throw new UnsupportedOperationException();
             }, null);
 
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
             .startObject("properties")
             .startObject("field")
             .field("type", "text")
@@ -793,10 +793,10 @@ public void testFastPhraseMapping() throws IOException {
             .endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
-        queryShardContext.getMapperService().merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        queryShardContext.getMapperService().merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         Query q = new MatchPhraseQueryBuilder("field", "two words").toQuery(queryShardContext);
         assertThat(q, is(new PhraseQuery("field._index_phrase", "two words")));
@@ -862,7 +862,7 @@ protected TokenStreamComponents createComponents(String fieldName) {
         }
 
         {
-            String badConfigMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+            String badConfigMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                 .field("type", "text")
                 .field("index", "false")
@@ -870,13 +870,13 @@ protected TokenStreamComponents createComponents(String fieldName) {
                 .endObject().endObject()
                 .endObject().endObject());
             IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                () -> parser.parse("type", new CompressedXContent(badConfigMapping))
+                () -> parser.parse("_doc", new CompressedXContent(badConfigMapping))
             );
             assertThat(e.getMessage(), containsString("Cannot set index_phrases on unindexed field [field]"));
         }
 
         {
-            String badConfigMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+            String badConfigMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                 .field("type", "text")
                 .field("index_options", "freqs")
@@ -884,7 +884,7 @@ protected TokenStreamComponents createComponents(String fieldName) {
                 .endObject().endObject()
                 .endObject().endObject());
             IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                () -> parser.parse("type", new CompressedXContent(badConfigMapping))
+                () -> parser.parse("_doc", new CompressedXContent(badConfigMapping))
             );
             assertThat(e.getMessage(), containsString("Cannot set index_phrases on field [field] if positions are not enabled"));
         }
@@ -893,7 +893,7 @@ protected TokenStreamComponents createComponents(String fieldName) {
     public void testIndexPrefixMapping() throws IOException {
 
         {
-            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                 .startObject("properties").startObject("field")
                 .field("type", "text")
                 .field("analyzer", "standard")
@@ -904,7 +904,7 @@ public void testIndexPrefixMapping() throws IOException {
                 .endObject().endObject()
                 .endObject().endObject());
 
-            DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+            DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
             assertEquals(mapping, mapper.mappingSource().toString());
 
             assertThat(mapper.mappers().getMapper("field._index_prefix").toString(), containsString("prefixChars=2:10"));
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/TypeFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/TypeFieldMapperTests.java
index 1ef68cf42d166..689dfbdcc872d 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/TypeFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/TypeFieldMapperTests.java
@@ -75,7 +75,7 @@ public static void testDocValues(Function<String, IndexService> createIndex) thr
         assertTrue(values.advanceExact(0));
         assertEquals(0, values.nextOrd());
         assertEquals(SortedSetDocValues.NO_MORE_ORDS, values.nextOrd());
-        assertEquals(new BytesRef("type"), values.lookupOrd(0));
+        assertEquals(new BytesRef("_doc"), values.lookupOrd(0));
         r.close();
         dir.close();
     }
diff --git a/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectFieldMapperTests.java b/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectFieldMapperTests.java
index aeb22c331b355..44dfc11898016 100644
--- a/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectFieldMapperTests.java
+++ b/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectFieldMapperTests.java
@@ -56,7 +56,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
 
     public void testDefaults() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -65,7 +65,7 @@ public void testDefaults() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -111,7 +111,7 @@ public void testDefaults() throws Exception {
 
     public void testDisableIndex() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -121,7 +121,7 @@ public void testDisableIndex() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -143,7 +143,7 @@ public void testDisableIndex() throws Exception {
 
     public void testDisableDocValues() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -153,7 +153,7 @@ public void testDisableDocValues() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -195,7 +195,7 @@ public void testEnableStore() throws Exception {
 
     public void testIndexOptions() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -205,12 +205,12 @@ public void testIndexOptions() throws IOException {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         for (String indexOptions : Arrays.asList("positions", "offsets")) {
             String invalidMapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("type")
+                .startObject("_doc")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "flattened")
@@ -220,14 +220,14 @@ public void testIndexOptions() throws IOException {
                 .endObject()
             .endObject());
             IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                    () -> parser.parse("type", new CompressedXContent(invalidMapping)));
+                    () -> parser.parse("_doc", new CompressedXContent(invalidMapping)));
             assertEquals("The [flattened] field does not support positions, got [index_options]=" + indexOptions, e.getMessage());
         }
     }
 
     public void testNullField() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -236,7 +236,7 @@ public void testNullField() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -250,7 +250,7 @@ public void testNullField() throws Exception {
 
     public void testMalformedJson() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -259,7 +259,7 @@ public void testMalformedJson() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc1 = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -276,7 +276,7 @@ public void testMalformedJson() throws Exception {
 
     public void testFieldMultiplicity() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -285,7 +285,7 @@ public void testFieldMultiplicity() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -318,7 +318,7 @@ public void testFieldMultiplicity() throws Exception {
     public void testDepthLimit() throws IOException {
         // First verify the default behavior when depth_limit is not set.
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -327,7 +327,7 @@ public void testDepthLimit() throws IOException {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -344,7 +344,7 @@ public void testDepthLimit() throws IOException {
 
         // Set a lower value for depth_limit and check that the field is rejected.
         String newMapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -355,7 +355,7 @@ public void testDepthLimit() throws IOException {
         .endObject());
 
         DocumentMapper newMapper = mapper.merge(
-            parser.parse("type", new CompressedXContent(newMapping)).mapping());
+            parser.parse("_doc", new CompressedXContent(newMapping)).mapping());
 
         expectThrows(MapperParsingException.class, () ->
             newMapper.parse(new SourceToParse("test", "1", doc, XContentType.JSON)));
@@ -363,7 +363,7 @@ public void testDepthLimit() throws IOException {
 
     public void testEagerGlobalOrdinals() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -371,7 +371,7 @@ public void testEagerGlobalOrdinals() throws IOException {
                     .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         FieldMapper fieldMapper = (FieldMapper) mapper.mappers().getMapper("field");
@@ -381,7 +381,7 @@ public void testEagerGlobalOrdinals() throws IOException {
     public void testIgnoreAbove() throws IOException {
         // First verify the default behavior when ignore_above is not set.
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -390,7 +390,7 @@ public void testIgnoreAbove() throws IOException {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -427,7 +427,7 @@ public void testIgnoreAbove() throws IOException {
 
     public void testNullValues() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("type")
+            .startObject("_doc")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -440,7 +440,7 @@ public void testNullValues() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()

From a1df65571719f7081e4fc5a31a5e3c33e54c5045 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Tue, 14 Jan 2020 17:39:58 +0200
Subject: [PATCH 557/686] [ML] Unmute DFA BWC tests and fix versions after
 backport of #50914 (#50979)

---
 .../xpack/core/ml/dataframe/analyses/BoostedTreeParams.java  | 4 ++--
 .../test/mixed_cluster/90_ml_data_frame_analytics_crud.yml   | 5 -----
 .../test/old_cluster/90_ml_data_frame_analytics_crud.yml     | 3 ---
 .../upgraded_cluster/90_ml_data_frame_analytics_crud.yml     | 5 -----
 4 files changed, 2 insertions(+), 15 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
index ec563af73f520..e0890c21377ca 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/dataframe/analyses/BoostedTreeParams.java
@@ -92,7 +92,7 @@ public BoostedTreeParams(@Nullable Double lambda,
         eta = in.readOptionalDouble();
         maximumNumberTrees = in.readOptionalVInt();
         featureBagFraction = in.readOptionalDouble();
-        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
             numTopFeatureImportanceValues = in.readOptionalInt();
         } else {
             numTopFeatureImportanceValues = null;
@@ -106,7 +106,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeOptionalDouble(eta);
         out.writeOptionalVInt(maximumNumberTrees);
         out.writeOptionalDouble(featureBagFraction);
-        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             out.writeOptionalInt(numTopFeatureImportanceValues);
         }
     }
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
index 053ebf77984ae..af304afc57db6 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/mixed_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,8 +1,3 @@
-setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/pull/50914"
-
 ---
 "Get old outlier_detection job":
 
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
index de24432b4d091..fe160bba15f23 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/old_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,7 +1,4 @@
 setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/pull/50914"
 
   - do:
       index:
diff --git a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
index 7a3d44fff1aa7..14438883f0da1 100644
--- a/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
+++ b/x-pack/qa/rolling-upgrade/src/test/resources/rest-api-spec/test/upgraded_cluster/90_ml_data_frame_analytics_crud.yml
@@ -1,8 +1,3 @@
-setup:
-  - skip:
-      version: "all"
-      reason:  "Until backport of https://github.com/elastic/elasticsearch/pull/50914"
-
 ---
 "Get old cluster outlier_detection job":
 

From 1fb1b571e90c2d86bd72971695cc65d885a2d9cc Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Tue, 14 Jan 2020 10:42:05 -0500
Subject: [PATCH 558/686] Add "did you mean" to ObjectParser (#50938)

Check it out:
```
$ curl -u elastic:password -HContent-Type:application/json -XPOST localhost:9200/test/_update/foo?pretty -d'{
  "dac": {}
}'

{
  "error" : {
    "root_cause" : [
      {
        "type" : "x_content_parse_exception",
        "reason" : "[2:3] [UpdateRequest] unknown field [dac] did you mean [doc]?"
      }
    ],
    "type" : "x_content_parse_exception",
    "reason" : "[2:3] [UpdateRequest] unknown field [dac] did you mean [doc]?"
  },
  "status" : 400
}
```

The tricky thing about implementing this is that x-content doesn't
depend on Lucene. So this works by creating an extension point for the
error message using SPI. Elasticsearch's server module provides the
"spell checking" implementation.
---
 .../common/xcontent/ErrorOnUnknown.java       | 67 +++++++++++++++++
 .../common/xcontent/ObjectParser.java         | 22 +++---
 .../common/xcontent/ObjectParserTests.java    |  2 +-
 .../index/rankeval/RatedRequestsTests.java    |  1 -
 .../rest-api-spec/test/update/90_error.yml    | 13 ++++
 .../xcontent/SuggestingErrorOnUnknown.java    | 71 +++++++++++++++++++
 ...asticsearch.common.xcontent.ErrorOnUnknown |  1 +
 .../ClusterUpdateSettingsRequestTests.java    |  2 +-
 .../action/update/UpdateRequestTests.java     |  4 +-
 .../SuggestingErrorOnUnknownTests.java        | 46 ++++++++++++
 .../highlight/HighlightBuilderTests.java      | 12 ++--
 .../rescore/QueryRescorerBuilderTests.java    |  2 +-
 .../search/sort/FieldSortBuilderTests.java    |  2 +-
 .../search/sort/ScriptSortBuilderTests.java   |  4 +-
 .../phrase/DirectCandidateGeneratorTests.java |  2 +-
 .../test/AbstractQueryTestCase.java           |  2 +-
 .../core/ml/datafeed/DatafeedConfigTests.java |  2 +-
 .../DataFrameAnalyticsConfigTests.java        |  4 +-
 .../xpack/core/ml/job/config/JobTests.java    |  2 +-
 .../ml/process/ProcessResultsParserTests.java |  2 +-
 .../xpack/sql/qa/rest/RestSqlTestCase.java    |  2 +-
 .../test/ml/data_frame_analytics_crud.yml     |  8 +--
 .../rest-api-spec/test/ml/datafeeds_crud.yml  |  2 +-
 .../rest-api-spec/test/rollup/put_job.yml     |  2 +-
 .../common/text/TextTemplateTests.java        |  6 +-
 25 files changed, 240 insertions(+), 43 deletions(-)
 create mode 100644 libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ErrorOnUnknown.java
 create mode 100644 rest-api-spec/src/main/resources/rest-api-spec/test/update/90_error.yml
 create mode 100644 server/src/main/java/org/elasticsearch/common/xcontent/SuggestingErrorOnUnknown.java
 create mode 100644 server/src/main/resources/META-INF/services/org.elasticsearch.common.xcontent.ErrorOnUnknown
 create mode 100644 server/src/test/java/org/elasticsearch/common/xcontent/SuggestingErrorOnUnknownTests.java

diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ErrorOnUnknown.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ErrorOnUnknown.java
new file mode 100644
index 0000000000000..28ad02ff44812
--- /dev/null
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ErrorOnUnknown.java
@@ -0,0 +1,67 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.common.xcontent;
+
+import java.util.ServiceLoader;
+
+/**
+ * Extension point to customize the error message for unknown fields. We expect
+ * Elasticsearch to plug a fancy implementation that uses Lucene's spelling
+ * correction infrastructure to suggest corrections.
+ */
+public interface ErrorOnUnknown {
+    /**
+     * The implementation of this interface that was loaded from SPI.
+     */
+    ErrorOnUnknown IMPLEMENTATION = findImplementation();
+
+    /**
+     * Build the error message to use when {@link ObjectParser} encounters an unknown field.
+     * @param parserName the name of the thing we're parsing
+     * @param unknownField the field that we couldn't recognize
+     * @param candidates the possible fields
+     */
+    String errorMessage(String parserName, String unknownField, Iterable<String> candidates);
+
+    /**
+     * Priority that this error message handler should be used.
+     */
+    int priority();
+
+    private static ErrorOnUnknown findImplementation() {
+        ErrorOnUnknown best = new ErrorOnUnknown() {
+            @Override
+            public String errorMessage(String parserName, String unknownField, Iterable<String> candidates) {
+                return "[" + parserName + "] unknown field [" + unknownField + "]";
+            }
+
+            @Override
+            public int priority() {
+                return Integer.MIN_VALUE;
+            }
+        };
+        for (ErrorOnUnknown c : ServiceLoader.load(ErrorOnUnknown.class)) {
+            if (best.priority() < c.priority()) {
+                best = c;
+            }
+        }
+        return best;
+    }
+}
diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
index 69a4a4bd31e45..478b4c1369463 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
@@ -81,18 +81,17 @@ public static <Value, ElementValue> BiConsumer<Value, List<ElementValue>> fromLi
     }
 
     private interface UnknownFieldParser<Value, Context> {
-
-        void acceptUnknownField(String parserName, String field, XContentLocation location, XContentParser parser,
-                                Value value, Context context) throws IOException;
+        void acceptUnknownField(ObjectParser<Value, Context> objectParser, String field, XContentLocation location, XContentParser parser,
+                Value value, Context context) throws IOException;
     }
 
     private static <Value, Context> UnknownFieldParser<Value, Context> ignoreUnknown() {
-      return (n, f, l, p, v, c) -> p.skipChildren();
+      return (op, f, l, p, v, c) -> p.skipChildren();
     }
 
     private static <Value, Context> UnknownFieldParser<Value, Context> errorOnUnknown() {
-        return (n, f, l, p, v, c) -> {
-            throw new XContentParseException(l, "[" + n + "] unknown field [" + f + "], parser not found");
+        return (op, f, l, p, v, c) -> {
+            throw new XContentParseException(l, ErrorOnUnknown.IMPLEMENTATION.errorMessage(op.name, f, op.fieldParserMap.keySet()));
         };
     }
 
@@ -104,7 +103,7 @@ public interface UnknownFieldConsumer<Value> {
     }
 
     private static <Value, Context> UnknownFieldParser<Value, Context> consumeUnknownField(UnknownFieldConsumer<Value> consumer) {
-        return (parserName, field, location, parser, value, context) -> {
+        return (objectParser, field, location, parser, value, context) -> {
             XContentParser.Token t = parser.currentToken();
             switch (t) {
                 case VALUE_STRING:
@@ -127,7 +126,7 @@ private static <Value, Context> UnknownFieldParser<Value, Context> consumeUnknow
                     break;
                 default:
                     throw new XContentParseException(parser.getTokenLocation(),
-                        "[" + parserName + "] cannot parse field [" + field + "] with value type [" + t + "]");
+                        "[" + objectParser.name + "] cannot parse field [" + field + "] with value type [" + t + "]");
             }
         };
     }
@@ -136,12 +135,13 @@ private static <Value, Category, Context> UnknownFieldParser<Value, Context> unk
         Class<Category> categoryClass,
         BiConsumer<Value, ? super Category> consumer
     ) {
-        return (parserName, field, location, parser, value, context) -> {
+        return (objectParser, field, location, parser, value, context) -> {
             Category o;
             try {
                 o = parser.namedObject(categoryClass, field, context);
             } catch (NamedObjectNotFoundException e) {
-                throw new XContentParseException(location, "[" + parserName  + "] " + e.getBareMessage(), e);
+                // TODO It'd be lovely if we could the options here but we don't have the right stuff plumbed through. We'll get to it!
+                throw new XContentParseException(location, "[" + objectParser.name  + "] " + e.getBareMessage(), e);
             }
             consumer.accept(value, o);
         };
@@ -278,7 +278,7 @@ public Value parse(XContentParser parser, Value value, Context context) throws I
                     throw new XContentParseException(parser.getTokenLocation(), "[" + name  + "] no field found");
                 }
                 if (fieldParser == null) {
-                    unknownFieldParser.acceptUnknownField(name, currentFieldName, currentPosition, parser, value, context);
+                    unknownFieldParser.acceptUnknownField(this, currentFieldName, currentPosition, parser, value, context);
                 } else {
                     fieldParser.assertSupports(name, parser, currentFieldName);
                     parseSub(parser, fieldParser, currentFieldName, value, context);
diff --git a/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java b/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
index 96d0f11af7c40..5b52d5b2e120d 100644
--- a/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
+++ b/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
@@ -206,7 +206,7 @@ public void setTest(int test) {
         {
             XContentParser parser = createParser(JsonXContent.jsonXContent, "{\"not_supported_field\" : \"foo\"}");
             XContentParseException ex = expectThrows(XContentParseException.class, () -> objectParser.parse(parser, s, null));
-            assertEquals(ex.getMessage(), "[1:2] [the_parser] unknown field [not_supported_field], parser not found");
+            assertEquals(ex.getMessage(), "[1:2] [the_parser] unknown field [not_supported_field]");
         }
     }
 
diff --git a/modules/rank-eval/src/test/java/org/elasticsearch/index/rankeval/RatedRequestsTests.java b/modules/rank-eval/src/test/java/org/elasticsearch/index/rankeval/RatedRequestsTests.java
index 74683d8135ed7..a10459abfdce3 100644
--- a/modules/rank-eval/src/test/java/org/elasticsearch/index/rankeval/RatedRequestsTests.java
+++ b/modules/rank-eval/src/test/java/org/elasticsearch/index/rankeval/RatedRequestsTests.java
@@ -143,7 +143,6 @@ public void testXContentParsingIsNotLenient() throws IOException {
                 exception = exception.getCause();
             }
             assertThat(exception.getMessage(), containsString("unknown field"));
-            assertThat(exception.getMessage(), containsString("parser not found"));
         }
     }
 
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/update/90_error.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/update/90_error.yml
new file mode 100644
index 0000000000000..3102fd39afad9
--- /dev/null
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/update/90_error.yml
@@ -0,0 +1,13 @@
+---
+'Misspelled fields get "did you mean"':
+  - skip:
+      version: " - 7.99.99"
+      reason: Implemented in 8.0
+  - do:
+      catch: /\[UpdateRequest\] unknown field \[dac\] did you mean \[doc\]\?/
+      update:
+          index: test
+          id:    1
+          body:
+            dac:    { foo: baz }
+            upsert: { foo: bar }
diff --git a/server/src/main/java/org/elasticsearch/common/xcontent/SuggestingErrorOnUnknown.java b/server/src/main/java/org/elasticsearch/common/xcontent/SuggestingErrorOnUnknown.java
new file mode 100644
index 0000000000000..c24f74ef814a7
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/common/xcontent/SuggestingErrorOnUnknown.java
@@ -0,0 +1,71 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.common.xcontent;
+
+import org.apache.lucene.search.spell.LevenshteinDistance;
+import org.apache.lucene.util.CollectionUtil;
+import org.elasticsearch.common.collect.Tuple;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+
+import static java.util.stream.Collectors.toList;
+
+public class SuggestingErrorOnUnknown implements ErrorOnUnknown {
+    @Override
+    public String errorMessage(String parserName, String unknownField, Iterable<String> candidates) {
+        String message = String.format(Locale.ROOT, "[%s] unknown field [%s]", parserName, unknownField);
+        // TODO it'd be nice to combine this with BaseRestHandler's implementation.
+        LevenshteinDistance ld = new LevenshteinDistance();
+        final List<Tuple<Float, String>> scored = new ArrayList<>();
+        for (String candidate : candidates) {
+            float distance = ld.getDistance(unknownField, candidate);
+            if (distance > 0.5f) {
+                scored.add(new Tuple<>(distance, candidate));
+            }
+        }
+        if (scored.isEmpty()) {
+            return message;
+        }
+        CollectionUtil.timSort(scored, (a, b) -> {
+            // sort by distance in reverse order, then parameter name for equal distances
+            int compare = a.v1().compareTo(b.v1());
+            if (compare != 0) {
+                return -compare;
+            }
+            return a.v2().compareTo(b.v2());
+        });
+        List<String> keys = scored.stream().map(Tuple::v2).collect(toList());
+        StringBuilder builder = new StringBuilder(message).append(" did you mean ");
+        if (keys.size() == 1) {
+            builder.append("[").append(keys.get(0)).append("]");
+        } else {
+            builder.append("any of ").append(keys.toString());
+        }
+        builder.append("?");
+        return builder.toString();
+    }
+
+    @Override
+    public int priority() {
+        return 0;
+    }
+}
diff --git a/server/src/main/resources/META-INF/services/org.elasticsearch.common.xcontent.ErrorOnUnknown b/server/src/main/resources/META-INF/services/org.elasticsearch.common.xcontent.ErrorOnUnknown
new file mode 100644
index 0000000000000..38f08271bce10
--- /dev/null
+++ b/server/src/main/resources/META-INF/services/org.elasticsearch.common.xcontent.ErrorOnUnknown
@@ -0,0 +1 @@
+org.elasticsearch.common.xcontent.SuggestingErrorOnUnknown
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/settings/ClusterUpdateSettingsRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/settings/ClusterUpdateSettingsRequestTests.java
index 06bd3dc26d8f6..5a581d2d4088e 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/settings/ClusterUpdateSettingsRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/settings/ClusterUpdateSettingsRequestTests.java
@@ -56,7 +56,7 @@ private void doFromXContentTestWithRandomFields(boolean addRandomFields) throws
             XContentParseException iae = expectThrows(XContentParseException.class,
                     () -> ClusterUpdateSettingsRequest.fromXContent(createParser(xContentType.xContent(), mutated)));
             assertThat(iae.getMessage(),
-                    containsString("[cluster_update_settings_request] unknown field [" + unsupportedField + "], parser not found"));
+                    containsString("[cluster_update_settings_request] unknown field [" + unsupportedField + "]"));
         } else {
             try (XContentParser parser = createParser(xContentType.xContent(), originalBytes)) {
                 ClusterUpdateSettingsRequest parsedRequest = ClusterUpdateSettingsRequest.fromXContent(parser);
diff --git a/server/src/test/java/org/elasticsearch/action/update/UpdateRequestTests.java b/server/src/test/java/org/elasticsearch/action/update/UpdateRequestTests.java
index 2d76256c91a85..20526366624fb 100644
--- a/server/src/test/java/org/elasticsearch/action/update/UpdateRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/update/UpdateRequestTests.java
@@ -288,7 +288,7 @@ public void testUnknownFieldParsing() throws Exception {
                 .endObject());
 
         XContentParseException ex = expectThrows(XContentParseException.class, () -> request.fromXContent(contentParser));
-        assertEquals("[1:2] [UpdateRequest] unknown field [unknown_field], parser not found", ex.getMessage());
+        assertEquals("[1:2] [UpdateRequest] unknown field [unknown_field]", ex.getMessage());
 
         UpdateRequest request2 = new UpdateRequest("test", "1");
         XContentParser unknownObject = createParser(XContentFactory.jsonBuilder()
@@ -299,7 +299,7 @@ public void testUnknownFieldParsing() throws Exception {
                     .endObject()
                 .endObject());
         ex = expectThrows(XContentParseException.class, () -> request2.fromXContent(unknownObject));
-        assertEquals("[1:76] [UpdateRequest] unknown field [params], parser not found", ex.getMessage());
+        assertEquals("[1:76] [UpdateRequest] unknown field [params]", ex.getMessage());
     }
 
     public void testFetchSourceParsing() throws Exception {
diff --git a/server/src/test/java/org/elasticsearch/common/xcontent/SuggestingErrorOnUnknownTests.java b/server/src/test/java/org/elasticsearch/common/xcontent/SuggestingErrorOnUnknownTests.java
new file mode 100644
index 0000000000000..8e2e0b05612a1
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/common/xcontent/SuggestingErrorOnUnknownTests.java
@@ -0,0 +1,46 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.common.xcontent;
+
+import org.elasticsearch.test.ESTestCase;
+
+import java.util.Arrays;
+
+import static org.hamcrest.Matchers.equalTo;
+
+public class SuggestingErrorOnUnknownTests extends ESTestCase {
+    private String errorMessage(String unknownField, String... candidates) {
+        return new SuggestingErrorOnUnknown().errorMessage("test", unknownField, Arrays.asList(candidates));
+    }
+
+    public void testNoCandidates() {
+        assertThat(errorMessage("foo"), equalTo("[test] unknown field [foo]"));
+    }
+    public void testBadCandidates() {
+        assertThat(errorMessage("foo", "bar", "baz"), equalTo("[test] unknown field [foo]"));
+    }
+    public void testOneCandidate() {
+        assertThat(errorMessage("foo", "bar", "fop"), equalTo("[test] unknown field [foo] did you mean [fop]?"));
+    }
+    public void testManyCandidate() {
+        assertThat(errorMessage("foo", "bar", "fop", "fou", "baz"),
+                equalTo("[test] unknown field [foo] did you mean any of [fop, fou]?"));
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlightBuilderTests.java b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlightBuilderTests.java
index 36c0d7ea12375..9a542fd762ad9 100644
--- a/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlightBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlightBuilderTests.java
@@ -163,7 +163,7 @@ public void testUnknownArrayNameExpection() throws IOException {
             XContentParseException e = expectParseThrows(XContentParseException.class, "{\n" +
                     "    \"bad_fieldname\" : [ \"field1\" 1 \"field2\" ]\n" +
                     "}\n");
-            assertEquals("[2:5] [highlight] unknown field [bad_fieldname], parser not found", e.getMessage());
+            assertEquals("[2:5] [highlight] unknown field [bad_fieldname]", e.getMessage());
         }
 
         {
@@ -176,7 +176,7 @@ public void testUnknownArrayNameExpection() throws IOException {
                     "}\n");
             assertThat(e.getMessage(), containsString("[highlight] failed to parse field [fields]"));
             assertThat(e.getCause().getMessage(), containsString("[fields] failed to parse field [body]"));
-            assertEquals("[4:9] [highlight_field] unknown field [bad_fieldname], parser not found", e.getCause().getCause().getMessage());
+            assertEquals("[4:9] [highlight_field] unknown field [bad_fieldname]", e.getCause().getCause().getMessage());
         }
     }
 
@@ -194,7 +194,7 @@ public void testUnknownFieldnameExpection() throws IOException {
             XContentParseException e = expectParseThrows(XContentParseException.class, "{\n" +
                     "    \"bad_fieldname\" : \"value\"\n" +
                     "}\n");
-            assertEquals("[2:5] [highlight] unknown field [bad_fieldname], parser not found", e.getMessage());
+            assertEquals("[2:5] [highlight] unknown field [bad_fieldname]", e.getMessage());
         }
 
         {
@@ -207,7 +207,7 @@ public void testUnknownFieldnameExpection() throws IOException {
                     "}\n");
             assertThat(e.getMessage(), containsString("[highlight] failed to parse field [fields]"));
             assertThat(e.getCause().getMessage(), containsString("[fields] failed to parse field [body]"));
-            assertEquals("[4:9] [highlight_field] unknown field [bad_fieldname], parser not found", e.getCause().getCause().getMessage());
+            assertEquals("[4:9] [highlight_field] unknown field [bad_fieldname]", e.getCause().getCause().getMessage());
         }
     }
 
@@ -219,7 +219,7 @@ public void testUnknownObjectFieldnameExpection() throws IOException {
             XContentParseException e = expectParseThrows(XContentParseException.class, "{\n" +
                     "    \"bad_fieldname\" :  { \"field\" : \"value\" }\n \n" +
                     "}\n");
-            assertEquals("[2:5] [highlight] unknown field [bad_fieldname], parser not found", e.getMessage());
+            assertEquals("[2:5] [highlight] unknown field [bad_fieldname]", e.getMessage());
         }
 
         {
@@ -232,7 +232,7 @@ public void testUnknownObjectFieldnameExpection() throws IOException {
                     "}\n");
             assertThat(e.getMessage(), containsString("[highlight] failed to parse field [fields]"));
             assertThat(e.getCause().getMessage(), containsString("[fields] failed to parse field [body]"));
-            assertEquals("[4:9] [highlight_field] unknown field [bad_fieldname], parser not found", e.getCause().getCause().getMessage());
+            assertEquals("[4:9] [highlight_field] unknown field [bad_fieldname]", e.getCause().getCause().getMessage());
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/rescore/QueryRescorerBuilderTests.java b/server/src/test/java/org/elasticsearch/search/rescore/QueryRescorerBuilderTests.java
index 302bffd668997..dfcc65afb5c65 100644
--- a/server/src/test/java/org/elasticsearch/search/rescore/QueryRescorerBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/rescore/QueryRescorerBuilderTests.java
@@ -254,7 +254,7 @@ public void testUnknownFieldsExpection() throws IOException {
             "}\n";
         try (XContentParser parser = createParser(rescoreElement)) {
             XContentParseException e = expectThrows(XContentParseException.class, () -> RescorerBuilder.parseFromXContent(parser));
-            assertEquals("[3:17] [query] unknown field [bad_fieldname], parser not found", e.getMessage());
+            assertEquals("[3:17] [query] unknown field [bad_fieldname]", e.getMessage());
         }
 
         rescoreElement = "{\n" +
diff --git a/server/src/test/java/org/elasticsearch/search/sort/FieldSortBuilderTests.java b/server/src/test/java/org/elasticsearch/search/sort/FieldSortBuilderTests.java
index 750ec4f34dfa5..19351275f352c 100644
--- a/server/src/test/java/org/elasticsearch/search/sort/FieldSortBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/sort/FieldSortBuilderTests.java
@@ -316,7 +316,7 @@ public void testUnknownOptionFails() throws IOException {
             parser.nextToken();
 
             XContentParseException e = expectThrows(XContentParseException.class, () -> FieldSortBuilder.fromXContent(parser, ""));
-            assertEquals("[1:18] [field_sort] unknown field [reverse], parser not found", e.getMessage());
+            assertEquals("[1:18] [field_sort] unknown field [reverse]", e.getMessage());
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/sort/ScriptSortBuilderTests.java b/server/src/test/java/org/elasticsearch/search/sort/ScriptSortBuilderTests.java
index 2384d697e38dc..dbf78f6a4117d 100644
--- a/server/src/test/java/org/elasticsearch/search/sort/ScriptSortBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/sort/ScriptSortBuilderTests.java
@@ -228,7 +228,7 @@ public void testParseBadFieldNameExceptions() throws IOException {
             parser.nextToken();
 
             XContentParseException e = expectThrows(XContentParseException.class, () -> ScriptSortBuilder.fromXContent(parser, null));
-            assertEquals("[1:15] [_script] unknown field [bad_field], parser not found", e.getMessage());
+            assertEquals("[1:15] [_script] unknown field [bad_field]", e.getMessage());
         }
     }
 
@@ -241,7 +241,7 @@ public void testParseBadFieldNameExceptionsOnStartObject() throws IOException {
             parser.nextToken();
 
             XContentParseException e = expectThrows(XContentParseException.class, () -> ScriptSortBuilder.fromXContent(parser, null));
-            assertEquals("[1:15] [_script] unknown field [bad_field], parser not found", e.getMessage());
+            assertEquals("[1:15] [_script] unknown field [bad_field]", e.getMessage());
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/phrase/DirectCandidateGeneratorTests.java b/server/src/test/java/org/elasticsearch/search/suggest/phrase/DirectCandidateGeneratorTests.java
index 5bff24b934837..6b2d5b520f245 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/phrase/DirectCandidateGeneratorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/phrase/DirectCandidateGeneratorTests.java
@@ -172,7 +172,7 @@ public void testIllegalXContent() throws IOException {
         // test unknown field
         directGenerator = "{ \"unknown_param\" : \"f1\" }";
         assertIllegalXContent(directGenerator, IllegalArgumentException.class,
-                "[direct_generator] unknown field [unknown_param], parser not found");
+                "[direct_generator] unknown field [unknown_param]");
 
         // test bad value for field (e.g. size expects an int)
         directGenerator = "{ \"size\" : \"xxl\" }";
diff --git a/test/framework/src/main/java/org/elasticsearch/test/AbstractQueryTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/AbstractQueryTestCase.java
index 2fd1bf450f51c..ba06640b41342 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/AbstractQueryTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/AbstractQueryTestCase.java
@@ -189,7 +189,7 @@ public void testUnknownObjectException() throws IOException {
                 if (expectedException == false) {
                     throw new AssertionError("unexpected exception when parsing query:\n" + testQuery, e);
                 }
-                assertThat(e.getMessage(), containsString("unknown field [newField], parser not found"));
+                assertThat(e.getMessage(), containsString("unknown field [newField]"));
             }
         }
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/datafeed/DatafeedConfigTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/datafeed/DatafeedConfigTests.java
index 3d1677fcc78d3..4c8bd4168df20 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/datafeed/DatafeedConfigTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/datafeed/DatafeedConfigTests.java
@@ -274,7 +274,7 @@ public void testFutureConfigParse() throws IOException {
                 .createParser(xContentRegistry(), DeprecationHandler.THROW_UNSUPPORTED_OPERATION, FUTURE_DATAFEED);
         XContentParseException e = expectThrows(XContentParseException.class,
                 () -> DatafeedConfig.STRICT_PARSER.apply(parser, null).build());
-        assertEquals("[6:5] [datafeed_config] unknown field [tomorrows_technology_today], parser not found", e.getMessage());
+        assertEquals("[6:5] [datafeed_config] unknown field [tomorrows_technology_today]", e.getMessage());
     }
 
     public void testPastQueryConfigParse() throws IOException {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
index 428b63554d8cf..ad6f79fdd37ed 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/dataframe/DataFrameAnalyticsConfigTests.java
@@ -328,7 +328,7 @@ public void testPreventCreateTimeInjection() throws IOException {
                  XContentFactory.xContent(XContentType.JSON).createParser(
                      xContentRegistry(), DeprecationHandler.THROW_UNSUPPORTED_OPERATION, json)) {
             Exception e = expectThrows(IllegalArgumentException.class, () -> DataFrameAnalyticsConfig.STRICT_PARSER.apply(parser, null));
-            assertThat(e.getMessage(), containsString("unknown field [create_time], parser not found"));
+            assertThat(e.getMessage(), containsString("unknown field [create_time]"));
         }
     }
 
@@ -343,7 +343,7 @@ public void testPreventVersionInjection() throws IOException {
                  XContentFactory.xContent(XContentType.JSON).createParser(
                      xContentRegistry(), DeprecationHandler.THROW_UNSUPPORTED_OPERATION, json)) {
             Exception e = expectThrows(IllegalArgumentException.class, () -> DataFrameAnalyticsConfig.STRICT_PARSER.apply(parser, null));
-            assertThat(e.getMessage(), containsString("unknown field [version], parser not found"));
+            assertThat(e.getMessage(), containsString("unknown field [version]"));
         }
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/config/JobTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/config/JobTests.java
index f8fea739a2500..0ca0e1ccd814b 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/config/JobTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/job/config/JobTests.java
@@ -81,7 +81,7 @@ public void testFutureConfigParse() throws IOException {
                 .createParser(NamedXContentRegistry.EMPTY, DeprecationHandler.THROW_UNSUPPORTED_OPERATION, FUTURE_JOB);
         XContentParseException e = expectThrows(XContentParseException.class,
                 () -> Job.STRICT_PARSER.apply(parser, null).build());
-        assertEquals("[4:5] [job_details] unknown field [tomorrows_technology_today], parser not found", e.getMessage());
+        assertEquals("[4:5] [job_details] unknown field [tomorrows_technology_today]", e.getMessage());
     }
 
     public void testFutureMetadataParse() throws IOException {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/ProcessResultsParserTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/ProcessResultsParserTests.java
index dff432ab938d9..77428c2304961 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/ProcessResultsParserTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/process/ProcessResultsParserTests.java
@@ -41,7 +41,7 @@ public void testParse_GivenUnknownObject() throws IOException {
             XContentParseException e = expectThrows(XContentParseException.class,
                 () -> parser.parseResults(inputStream).forEachRemaining(a -> {
                 }));
-            assertEquals("[1:3] [test_result] unknown field [unknown], parser not found", e.getMessage());
+            assertEquals("[1:3] [test_result] unknown field [unknown]", e.getMessage());
         }
     }
 
diff --git a/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java b/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
index 3215c6b35efdf..d4cb83485d1e1 100644
--- a/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
+++ b/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
@@ -350,7 +350,7 @@ public void testUseColumnarForTranslateRequest() throws IOException {
         expectBadRequest(() -> {
                 client().performRequest(request);
                 return Collections.emptyMap();
-            }, containsString("unknown field [columnar], parser not found"));
+            }, containsString("unknown field [columnar]"));
     }
 
     public static void expectBadRequest(CheckedSupplier<Map<String, Object>, Exception> code, Matcher<String> errorMessageMatcher) {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
index 6dc8c800bd414..903ac36d90990 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
@@ -87,7 +87,7 @@ setup:
 ---
 "Test put config with security headers in the body":
   - do:
-      catch: /unknown field \[headers\], parser not found/
+      catch: /unknown field \[headers\]/
       ml.put_data_frame_analytics:
         id: "data_frame_with_header"
         body:  >
@@ -107,7 +107,7 @@ setup:
 "Test put config with create_time in the body":
 
   - do:
-      catch: /unknown field \[create_time\], parser not found/
+      catch: /unknown field \[create_time\]/
       ml.put_data_frame_analytics:
         id: "data_frame_with_create_time"
         body: >
@@ -126,7 +126,7 @@ setup:
 "Test put config with version in the body":
 
   - do:
-      catch: /unknown field \[version\], parser not found/
+      catch: /unknown field \[version\]/
       ml.put_data_frame_analytics:
         id: "data_frame_with_version"
         body: >
@@ -443,7 +443,7 @@ setup:
 "Test put config with unknown top level field":
 
   - do:
-      catch: /unknown field \[unknown_field\], parser not found/
+      catch: /unknown field \[unknown_field\]/
       ml.put_data_frame_analytics:
         id: "unknown_field"
         body: >
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/datafeeds_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/datafeeds_crud.yml
index 8c6e94635f4da..c63aa4b4e48d4 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/datafeeds_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/datafeeds_crud.yml
@@ -86,7 +86,7 @@ setup:
 ---
 "Test put datafeed with security headers in the body":
   - do:
-      catch: /unknown field \[headers\], parser not found/
+      catch: /unknown field \[headers\]/
       ml.put_datafeed:
         datafeed_id: test-datafeed-1
         body:  >
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/rollup/put_job.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/rollup/put_job.yml
index 27b637ba7081d..530bf6414bbed 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/rollup/put_job.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/rollup/put_job.yml
@@ -170,7 +170,7 @@ setup:
 "Try to include headers":
 
   - do:
-      catch: /unknown field \[headers\], parser not found/
+      catch: /unknown field \[headers\]/
       headers:
         Authorization: "Basic eF9wYWNrX3Jlc3RfdXNlcjp4LXBhY2stdGVzdC1wYXNzd29yZA==" # run as x_pack_rest_user, i.e. the test setup superuser
       rollup.put_job:
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/text/TextTemplateTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/text/TextTemplateTests.java
index ecc071d598105..2ebaccc61801c 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/text/TextTemplateTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/common/text/TextTemplateTests.java
@@ -196,7 +196,7 @@ public void testParserInvalidUnexpectedField() throws Exception {
             TextTemplate.parse(parser);
             fail("expected parse exception when encountering an unknown field");
         } catch (IllegalArgumentException e) {
-            assertThat(e.getMessage(), containsString("[script] unknown field [unknown_field], parser not found"));
+            assertThat(e.getMessage(), containsString("[script] unknown field [unknown_field]"));
         }
     }
 
@@ -210,7 +210,7 @@ public void testParserInvalidUnknownScriptType() throws Exception {
         XContentParser parser = createParser(JsonXContent.jsonXContent, bytes);
         parser.nextToken();
         XContentParseException ex = expectThrows(XContentParseException.class, () -> TextTemplate.parse(parser));
-        assertEquals("[1:2] [script] unknown field [template], parser not found", ex.getMessage());
+        assertEquals("[1:2] [script] unknown field [template]", ex.getMessage());
     }
 
     public void testParserInvalidMissingText() throws Exception {
@@ -222,7 +222,7 @@ public void testParserInvalidMissingText() throws Exception {
         XContentParser parser = createParser(JsonXContent.jsonXContent, bytes);
         parser.nextToken();
         XContentParseException ex = expectThrows(XContentParseException.class, () -> TextTemplate.parse(parser));
-        assertEquals("[1:2] [script] unknown field [type], parser not found", ex.getMessage());
+        assertEquals("[1:2] [script] unknown field [type]", ex.getMessage());
     }
 
     public void testNullObject() throws Exception {

From a7e63f0788de85542bc1cd077c78d21cccb8d846 Mon Sep 17 00:00:00 2001
From: Tim Brooks <tim@uncontended.net>
Date: Tue, 14 Jan 2020 09:53:24 -0600
Subject: [PATCH 559/686] Revert "Update handshake response version constants
 to 7.6 (#48917)" (#50945)

This reverts commit 77a8bc3cd1ec585873daad50ed34577184204571.
---
 .../elasticsearch/transport/TransportHandshaker.java |  6 ++++--
 .../transport/AbstractSimpleTransportTestCase.java   | 12 ++++++------
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/transport/TransportHandshaker.java b/server/src/main/java/org/elasticsearch/transport/TransportHandshaker.java
index 92eb641a6b1a9..efbf6d6018d2c 100644
--- a/server/src/main/java/org/elasticsearch/transport/TransportHandshaker.java
+++ b/server/src/main/java/org/elasticsearch/transport/TransportHandshaker.java
@@ -231,7 +231,8 @@ private HandshakeResponse(Version requestVersion, StreamInput in) throws IOExcep
             // During the handshake process, nodes set their stream version to the minimum compatibility
             // version they support. When deserializing the response, we use the version the other node
             // told us that it actually is in the handshake response (`version`).
-            if (requestVersion.onOrAfter(Version.V_7_6_0) && version.onOrAfter(Version.V_7_6_0)) {
+            // TODO: On backport update to 6.7
+            if (requestVersion.onOrAfter(Version.V_8_0_0) && version.onOrAfter(Version.V_8_0_0)) {
                 clusterName = new ClusterName(in);
                 discoveryNode = new DiscoveryNode(in);
             } else {
@@ -248,7 +249,8 @@ public void writeTo(StreamOutput out) throws IOException {
             // version they support. When deciding what response to send, we use the version the other node
             // told us that it actually is in the handshake request (`requestVersion`). If it did not tell
             // us a `requestVersion`, it is at least a pre-7.6 node.
-            if (requestVersion != null && requestVersion.onOrAfter(Version.V_7_6_0) && version.onOrAfter(Version.V_7_6_0)) {
+            // TODO: On backport update to 6.7
+            if (requestVersion != null && requestVersion.onOrAfter(Version.V_8_0_0) && version.onOrAfter(Version.V_8_0_0)) {
                 clusterName.writeTo(out);
                 discoveryNode.writeTo(out);
             }
diff --git a/test/framework/src/main/java/org/elasticsearch/transport/AbstractSimpleTransportTestCase.java b/test/framework/src/main/java/org/elasticsearch/transport/AbstractSimpleTransportTestCase.java
index 109a725672098..770cae55bcfc7 100644
--- a/test/framework/src/main/java/org/elasticsearch/transport/AbstractSimpleTransportTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/transport/AbstractSimpleTransportTestCase.java
@@ -2357,7 +2357,7 @@ public String executor() {
                 TransportStats transportStats = serviceC.transport.getStats(); // we did a single round-trip to do the initial handshake
                 assertEquals(1, transportStats.getRxCount());
                 assertEquals(1, transportStats.getTxCount());
-                assertEquals(138, transportStats.getRxSize().getBytes());
+                assertEquals(25, transportStats.getRxSize().getBytes());
                 assertEquals(51, transportStats.getTxSize().getBytes());
             });
             serviceC.sendRequest(connection, "internal:action", new TestRequest("hello world"), TransportRequestOptions.EMPTY,
@@ -2367,7 +2367,7 @@ public String executor() {
                 TransportStats transportStats = serviceC.transport.getStats(); // request has ben send
                 assertEquals(1, transportStats.getRxCount());
                 assertEquals(2, transportStats.getTxCount());
-                assertEquals(138, transportStats.getRxSize().getBytes());
+                assertEquals(25, transportStats.getRxSize().getBytes());
                 assertEquals(111, transportStats.getTxSize().getBytes());
             });
             sendResponseLatch.countDown();
@@ -2375,7 +2375,7 @@ public String executor() {
             stats = serviceC.transport.getStats(); // response has been received
             assertEquals(2, stats.getRxCount());
             assertEquals(2, stats.getTxCount());
-            assertEquals(163, stats.getRxSize().getBytes());
+            assertEquals(50, stats.getRxSize().getBytes());
             assertEquals(111, stats.getTxSize().getBytes());
         } finally {
             serviceC.close();
@@ -2472,7 +2472,7 @@ public String executor() {
                 TransportStats transportStats = serviceC.transport.getStats(); // request has been sent
                 assertEquals(1, transportStats.getRxCount());
                 assertEquals(1, transportStats.getTxCount());
-                assertEquals(138, transportStats.getRxSize().getBytes());
+                assertEquals(25, transportStats.getRxSize().getBytes());
                 assertEquals(51, transportStats.getTxSize().getBytes());
             });
             serviceC.sendRequest(connection, "internal:action", new TestRequest("hello world"), TransportRequestOptions.EMPTY,
@@ -2482,7 +2482,7 @@ public String executor() {
                 TransportStats transportStats = serviceC.transport.getStats(); // request has been sent
                 assertEquals(1, transportStats.getRxCount());
                 assertEquals(2, transportStats.getTxCount());
-                assertEquals(138, transportStats.getRxSize().getBytes());
+                assertEquals(25, transportStats.getRxSize().getBytes());
                 assertEquals(111, transportStats.getTxSize().getBytes());
             });
             sendResponseLatch.countDown();
@@ -2497,7 +2497,7 @@ public String executor() {
             String failedMessage = "Unexpected read bytes size. The transport exception that was received=" + exception;
             // 49 bytes are the non-exception message bytes that have been received. It should include the initial
             // handshake message and the header, version, etc bytes in the exception message.
-            assertEquals(failedMessage, 166 + streamOutput.bytes().length(), stats.getRxSize().getBytes());
+            assertEquals(failedMessage, 53 + streamOutput.bytes().length(), stats.getRxSize().getBytes());
             assertEquals(111, stats.getTxSize().getBytes());
         } finally {
             serviceC.close();

From b3501cb99a5ee7326ab12bf0ea837da00b2ff925 Mon Sep 17 00:00:00 2001
From: Tom Veasey <tveasey@users.noreply.github.com>
Date: Tue, 14 Jan 2020 16:12:37 +0000
Subject: [PATCH 560/686] [ML] Disable invalid assertion (#50986)

---
 .../xpack/ml/integration/ClassificationIT.java             | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index ab130089df3f0..14c855ef68e77 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -5,7 +5,8 @@
  */
 package org.elasticsearch.xpack.ml.integration;
 
-import com.google.common.collect.Ordering;
+// Pending fix
+//import com.google.common.collect.Ordering;
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.admin.indices.get.GetIndexAction;
 import org.elasticsearch.action.admin.indices.get.GetIndexRequest;
@@ -592,7 +593,9 @@ private static <T> void assertTopClasses(Map<String, Object> resultsObject,
         // Assert that all the class probabilities lie within [0, 1] interval.
         classProbabilities.forEach(p -> assertThat(p, allOf(greaterThanOrEqualTo(0.0), lessThanOrEqualTo(1.0))));
         // Assert that the top classes are listed in the order of decreasing probabilities.
-        assertThat(Ordering.natural().reverse().isOrdered(classProbabilities), is(true));
+        // This is not true after https://github.com/elastic/ml-cpp/pull/926. I'll fix and re-enable
+        // once that change is merged.
+        //assertThat(Ordering.natural().reverse().isOrdered(classProbabilities), is(true));
     }
 
     private <T> void assertEvaluation(String dependentVariable, List<T> dependentVariableValues, String predictedClassField) {

From 94e071ddb0616c7667eef6069620880e0917cd5f Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Tue, 14 Jan 2020 17:15:00 +0100
Subject: [PATCH 561/686] Track Snapshot Version in RepositoryData (#50930)

Add tracking of snapshot versions to RepositoryData to make BwC logic more efficient.
Follow up to #50853
---
 .../routing/allocation/AllocationService.java |  3 +-
 .../repositories/RepositoryData.java          | 59 ++++++++++++++++---
 .../blobstore/BlobStoreRepository.java        | 47 +++++++++++++--
 .../snapshots/SnapshotsService.java           |  9 ++-
 .../repositories/RepositoryDataTests.java     | 20 +++++--
 .../blobstore/BlobStoreRepositoryTests.java   |  3 +-
 .../CorruptedBlobStoreRepositoryIT.java       | 27 ++++++++-
 .../index/shard/RestoreOnlyRepository.java    |  2 +-
 .../xpack/ccr/repository/CcrRepository.java   |  5 +-
 9 files changed, 148 insertions(+), 27 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/cluster/routing/allocation/AllocationService.java b/server/src/main/java/org/elasticsearch/cluster/routing/allocation/AllocationService.java
index cf693f0c60a0e..d7e0c2e4d816c 100644
--- a/server/src/main/java/org/elasticsearch/cluster/routing/allocation/AllocationService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/routing/allocation/AllocationService.java
@@ -332,7 +332,8 @@ private void resetFailedAllocationCounter(RoutingAllocation allocation) {
      * @param <T>       The list element type.
      * @return A comma-separated string of the first few elements.
      */
-    static <T> String firstListElementsToCommaDelimitedString(List<T> elements, Function<T, String> formatter, boolean isDebugEnabled) {
+    public static <T> String firstListElementsToCommaDelimitedString(List<T> elements, Function<T, String> formatter,
+                                                                     boolean isDebugEnabled) {
         final int maxNumberOfElements = 10;
         if (isDebugEnabled || elements.size() <= maxNumberOfElements) {
             return elements.stream().map(formatter).collect(Collectors.joining(", "));
diff --git a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
index 82c41251c586a..618eb246a14b4 100644
--- a/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
+++ b/server/src/main/java/org/elasticsearch/repositories/RepositoryData.java
@@ -69,7 +69,7 @@ public final class RepositoryData {
      * An instance initialized for an empty repository.
      */
     public static final RepositoryData EMPTY = new RepositoryData(EMPTY_REPO_GEN,
-        Collections.emptyMap(), Collections.emptyMap(), Collections.emptyMap(), ShardGenerations.EMPTY);
+        Collections.emptyMap(), Collections.emptyMap(), Collections.emptyMap(), Collections.emptyMap(), ShardGenerations.EMPTY);
 
     /**
      * The generational id of the index file from which the repository data was read.
@@ -92,13 +92,16 @@ public final class RepositoryData {
      */
     private final Map<IndexId, Set<SnapshotId>> indexSnapshots;
 
+    private final Map<String, Version> snapshotVersions;
+
     /**
      * Shard generations.
      */
     private final ShardGenerations shardGenerations;
 
     public RepositoryData(long genId, Map<String, SnapshotId> snapshotIds, Map<String, SnapshotState> snapshotStates,
-                          Map<IndexId, Set<SnapshotId>> indexSnapshots, ShardGenerations shardGenerations) {
+                          Map<String, Version> snapshotVersions, Map<IndexId, Set<SnapshotId>> indexSnapshots,
+                          ShardGenerations shardGenerations) {
         this.genId = genId;
         this.snapshotIds = Collections.unmodifiableMap(snapshotIds);
         this.snapshotStates = Collections.unmodifiableMap(snapshotStates);
@@ -106,12 +109,27 @@ public RepositoryData(long genId, Map<String, SnapshotId> snapshotIds, Map<Strin
             .collect(Collectors.toMap(IndexId::getName, Function.identity())));
         this.indexSnapshots = Collections.unmodifiableMap(indexSnapshots);
         this.shardGenerations = Objects.requireNonNull(shardGenerations);
+        this.snapshotVersions = snapshotVersions;
         assert indices.values().containsAll(shardGenerations.indices()) : "ShardGenerations contained indices "
             + shardGenerations.indices() + " but snapshots only reference indices " + indices.values();
     }
 
     protected RepositoryData copy() {
-        return new RepositoryData(genId, snapshotIds, snapshotStates, indexSnapshots, shardGenerations);
+        return new RepositoryData(genId, snapshotIds, snapshotStates, snapshotVersions, indexSnapshots, shardGenerations);
+    }
+
+    /**
+     * Creates a copy of this instance that contains updated version data.
+     * @param versions map of snapshot versions
+     * @return copy with updated version data
+     */
+    public RepositoryData withVersions(Map<SnapshotId, Version> versions) {
+        if (versions.isEmpty()) {
+            return this;
+        }
+        final Map<String, Version> newVersions = new HashMap<>(snapshotVersions);
+        versions.forEach((id, version) -> newVersions.put(id.getUUID(), version));
+        return new RepositoryData(genId, snapshotIds, snapshotStates, newVersions, indexSnapshots, shardGenerations);
     }
 
     public ShardGenerations shardGenerations() {
@@ -141,6 +159,14 @@ public SnapshotState getSnapshotState(final SnapshotId snapshotId) {
         return snapshotStates.get(snapshotId.getUUID());
     }
 
+    /**
+     * Returns the {@link Version} for the given snapshot or {@code null} if unknown.
+     */
+    @Nullable
+    public Version getVersion(SnapshotId snapshotId) {
+        return snapshotVersions.get(snapshotId.getUUID());
+    }
+
     /**
      * Returns an unmodifiable map of the index names to {@link IndexId} in the repository.
      */
@@ -173,6 +199,7 @@ public List<IndexId> indicesToUpdateAfterRemovingSnapshot(SnapshotId snapshotId)
      */
     public RepositoryData addSnapshot(final SnapshotId snapshotId,
                                       final SnapshotState snapshotState,
+                                      final Version version,
                                       final ShardGenerations shardGenerations) {
         if (snapshotIds.containsKey(snapshotId.getUUID())) {
             // if the snapshot id already exists in the repository data, it means an old master
@@ -184,11 +211,13 @@ public RepositoryData addSnapshot(final SnapshotId snapshotId,
         snapshots.put(snapshotId.getUUID(), snapshotId);
         Map<String, SnapshotState> newSnapshotStates = new HashMap<>(snapshotStates);
         newSnapshotStates.put(snapshotId.getUUID(), snapshotState);
+        Map<String, Version> newSnapshotVersions = new HashMap<>(snapshotVersions);
+        newSnapshotVersions.put(snapshotId.getUUID(), version);
         Map<IndexId, Set<SnapshotId>> allIndexSnapshots = new HashMap<>(indexSnapshots);
         for (final IndexId indexId : shardGenerations.indices()) {
             allIndexSnapshots.computeIfAbsent(indexId, k -> new LinkedHashSet<>()).add(snapshotId);
         }
-        return new RepositoryData(genId, snapshots, newSnapshotStates, allIndexSnapshots,
+        return new RepositoryData(genId, snapshots, newSnapshotStates, newSnapshotVersions, allIndexSnapshots,
             ShardGenerations.builder().putAll(this.shardGenerations).putAll(shardGenerations).build());
     }
 
@@ -202,7 +231,7 @@ public RepositoryData withGenId(long newGeneration) {
         if (newGeneration == genId) {
             return this;
         }
-        return new RepositoryData(newGeneration, this.snapshotIds, this.snapshotStates, this.indexSnapshots, this.shardGenerations);
+        return new RepositoryData(newGeneration, snapshotIds, snapshotStates, snapshotVersions, indexSnapshots, shardGenerations);
     }
 
     /**
@@ -222,6 +251,8 @@ public RepositoryData removeSnapshot(final SnapshotId snapshotId, final ShardGen
         }
         Map<String, SnapshotState> newSnapshotStates = new HashMap<>(snapshotStates);
         newSnapshotStates.remove(snapshotId.getUUID());
+        final Map<String, Version> newSnapshotVersions = new HashMap<>(snapshotVersions);
+        newSnapshotVersions.remove(snapshotId.getUUID());
         Map<IndexId, Set<SnapshotId>> indexSnapshots = new HashMap<>();
         for (final IndexId indexId : indices.values()) {
             Set<SnapshotId> set;
@@ -241,7 +272,7 @@ public RepositoryData removeSnapshot(final SnapshotId snapshotId, final ShardGen
             indexSnapshots.put(indexId, set);
         }
 
-        return new RepositoryData(genId, newSnapshotIds, newSnapshotStates, indexSnapshots,
+        return new RepositoryData(genId, newSnapshotIds, newSnapshotStates, newSnapshotVersions, indexSnapshots,
             ShardGenerations.builder().putAll(shardGenerations).putAll(updatedShardGenerations)
                 .retainIndicesAndPruneDeletes(indexSnapshots.keySet()).build()
         );
@@ -269,6 +300,7 @@ public boolean equals(Object obj) {
         RepositoryData that = (RepositoryData) obj;
         return snapshotIds.equals(that.snapshotIds)
                    && snapshotStates.equals(that.snapshotStates)
+                   && snapshotVersions.equals(that.snapshotVersions)
                    && indices.equals(that.indices)
                    && indexSnapshots.equals(that.indexSnapshots)
                    && shardGenerations.equals(that.shardGenerations);
@@ -276,7 +308,7 @@ public boolean equals(Object obj) {
 
     @Override
     public int hashCode() {
-        return Objects.hash(snapshotIds, snapshotStates, indices, indexSnapshots, shardGenerations);
+        return Objects.hash(snapshotIds, snapshotStates, snapshotVersions, indices, indexSnapshots, shardGenerations);
     }
 
     /**
@@ -323,6 +355,7 @@ public List<IndexId> resolveNewIndices(final List<String> indicesToResolve) {
     private static final String NAME = "name";
     private static final String UUID = "uuid";
     private static final String STATE = "state";
+    private static final String VERSION = "version";
     private static final String MIN_VERSION = "min_version";
 
     /**
@@ -339,6 +372,9 @@ public XContentBuilder snapshotsToXContent(final XContentBuilder builder, final
             if (snapshotStates.containsKey(snapshot.getUUID())) {
                 builder.field(STATE, snapshotStates.get(snapshot.getUUID()).value());
             }
+            if (snapshotVersions.containsKey(snapshot.getUUID())) {
+                builder.field(VERSION, snapshotVersions.get(snapshot.getUUID()).toString());
+            }
             builder.endObject();
         }
         builder.endArray();
@@ -378,6 +414,7 @@ public XContentBuilder snapshotsToXContent(final XContentBuilder builder, final
     public static RepositoryData snapshotsFromXContent(final XContentParser parser, long genId) throws IOException {
         final Map<String, SnapshotId> snapshots = new HashMap<>();
         final Map<String, SnapshotState> snapshotStates = new HashMap<>();
+        final Map<String, Version> snapshotVersions = new HashMap<>();
         final Map<IndexId, Set<SnapshotId>> indexSnapshots = new HashMap<>();
         final ShardGenerations.Builder shardGenerations = ShardGenerations.builder();
 
@@ -390,6 +427,7 @@ public static RepositoryData snapshotsFromXContent(final XContentParser parser,
                             String name = null;
                             String uuid = null;
                             SnapshotState state = null;
+                            Version version = null;
                             while (parser.nextToken() != XContentParser.Token.END_OBJECT) {
                                 String currentFieldName = parser.currentName();
                                 parser.nextToken();
@@ -399,12 +437,17 @@ public static RepositoryData snapshotsFromXContent(final XContentParser parser,
                                     uuid = parser.text();
                                 } else if (STATE.equals(currentFieldName)) {
                                     state = SnapshotState.fromValue(parser.numberValue().byteValue());
+                                } else if (VERSION.equals(currentFieldName)) {
+                                    version = Version.fromString(parser.text());
                                 }
                             }
                             final SnapshotId snapshotId = new SnapshotId(name, uuid);
                             if (state != null) {
                                 snapshotStates.put(uuid, state);
                             }
+                            if (version != null) {
+                                snapshotVersions.put(uuid, version);
+                            }
                             snapshots.put(snapshotId.getUUID(), snapshotId);
                         }
                     } else {
@@ -488,7 +531,7 @@ public static RepositoryData snapshotsFromXContent(final XContentParser parser,
         } else {
             throw new ElasticsearchParseException("start object expected");
         }
-        return new RepositoryData(genId, snapshots, snapshotStates, indexSnapshots, shardGenerations.build());
+        return new RepositoryData(genId, snapshots, snapshotStates, snapshotVersions, indexSnapshots, shardGenerations.build());
     }
 
 }
diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index b9016394ca514..87fbf9c44d0c3 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -32,6 +32,7 @@
 import org.apache.lucene.store.RateLimiter;
 import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.ExceptionsHelper;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.StepListener;
@@ -46,6 +47,7 @@
 import org.elasticsearch.cluster.metadata.RepositoriesMetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.cluster.routing.allocation.AllocationService;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Numbers;
@@ -121,6 +123,7 @@
 import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.BlockingQueue;
+import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.Executor;
 import java.util.concurrent.LinkedBlockingQueue;
 import java.util.concurrent.TimeUnit;
@@ -873,7 +876,7 @@ public void finalizeSnapshot(final SnapshotId snapshotId,
                 final SnapshotInfo snapshotInfo = snapshotInfos.iterator().next();
                 getRepositoryData(ActionListener.wrap(existingRepositoryData -> {
                     final RepositoryData updatedRepositoryData =
-                        existingRepositoryData.addSnapshot(snapshotId, snapshotInfo.state(), shardGenerations);
+                        existingRepositoryData.addSnapshot(snapshotId, snapshotInfo.state(), Version.CURRENT, shardGenerations);
                     writeIndexGen(updatedRepositoryData, repositoryStateId, writeShardGens, ActionListener.wrap(v -> {
                         if (writeShardGens) {
                             cleanupOldShardGens(existingRepositoryData, updatedRepositoryData);
@@ -1252,8 +1255,42 @@ public void clusterStateProcessed(String source, ClusterState oldState, ClusterS
                 }
             });
 
+        final StepListener<RepositoryData> filterRepositoryDataStep = new StepListener<>();
+
         // Step 2: Write new index-N blob to repository and update index.latest
         setPendingStep.whenComplete(newGen -> threadPool().executor(ThreadPool.Names.SNAPSHOT).execute(ActionRunnable.wrap(listener, l -> {
+            // BwC logic: Load snapshot version information if any snapshot is missing a version in RepositoryData so that the new
+            // RepositoryData contains a version for every snapshot
+            final List<SnapshotId> snapshotIdsWithoutVersion = repositoryData.getSnapshotIds().stream().filter(
+                snapshotId -> repositoryData.getVersion(snapshotId) == null).collect(Collectors.toList());
+            if (snapshotIdsWithoutVersion.isEmpty() == false) {
+                final Map<SnapshotId, Version> updatedVersionMap = new ConcurrentHashMap<>();
+                final GroupedActionListener<Void> loadAllVersionsListener = new GroupedActionListener<>(
+                    ActionListener.runAfter(
+                        new ActionListener<>() {
+                            @Override
+                            public void onResponse(Collection<Void> voids) {
+                                logger.info("Successfully loaded all snapshot's version information for {} from snapshot metadata",
+                                    AllocationService.firstListElementsToCommaDelimitedString(
+                                        snapshotIdsWithoutVersion, SnapshotId::toString, logger.isDebugEnabled()));
+                            }
+
+                            @Override
+                            public void onFailure(Exception e) {
+                                logger.warn("Failure when trying to load missing version information from snapshot metadata", e);
+                            }
+                        }, () -> filterRepositoryDataStep.onResponse(repositoryData.withVersions(updatedVersionMap))),
+                    snapshotIdsWithoutVersion.size());
+                for (SnapshotId snapshotId : snapshotIdsWithoutVersion) {
+                    threadPool().executor(ThreadPool.Names.SNAPSHOT).execute(ActionRunnable.run(loadAllVersionsListener, () ->
+                        updatedVersionMap.put(snapshotId, getSnapshotInfo(snapshotId).version())));
+                }
+            } else {
+                filterRepositoryDataStep.onResponse(repositoryData);
+            }
+        })), listener::onFailure);
+        filterRepositoryDataStep.whenComplete(filteredRepositoryData -> {
+            final long newGen = setPendingStep.result();
             if (latestKnownRepoGen.get() >= newGen) {
                 throw new IllegalArgumentException(
                     "Tried writing generation [" + newGen + "] but repository is at least at generation [" + latestKnownRepoGen.get()
@@ -1263,7 +1300,7 @@ public void clusterStateProcessed(String source, ClusterState oldState, ClusterS
             final String indexBlob = INDEX_FILE_PREFIX + Long.toString(newGen);
             logger.debug("Repository [{}] writing new index generational blob [{}]", metadata.name(), indexBlob);
             writeAtomic(indexBlob,
-                BytesReference.bytes(repositoryData.snapshotsToXContent(XContentFactory.jsonBuilder(), writeShardGens)), true);
+                BytesReference.bytes(filteredRepositoryData.snapshotsToXContent(XContentFactory.jsonBuilder(), writeShardGens)), true);
             // write the current generation to the index-latest file
             final BytesReference genBytes;
             try (BytesStreamOutput bStream = new BytesStreamOutput()) {
@@ -1297,13 +1334,13 @@ public ClusterState execute(ClusterState currentState) {
 
                     @Override
                     public void onFailure(String source, Exception e) {
-                        l.onFailure(
+                        listener.onFailure(
                             new RepositoryException(metadata.name(), "Failed to execute cluster state update [" + source + "]", e));
                     }
 
                     @Override
                     public void clusterStateProcessed(String source, ClusterState oldState, ClusterState newState) {
-                        threadPool.executor(ThreadPool.Names.SNAPSHOT).execute(ActionRunnable.run(l, () -> {
+                        threadPool.executor(ThreadPool.Names.SNAPSHOT).execute(ActionRunnable.run(listener, () -> {
                             // Delete all now outdated index files up to 1000 blobs back from the new generation.
                             // If there are more than 1000 dangling index-N cleanup functionality on repo delete will take care of them.
                             // Deleting one older than the current expectedGen is done for BwC reasons as older versions used to keep
@@ -1320,7 +1357,7 @@ public void clusterStateProcessed(String source, ClusterState oldState, ClusterS
                         }));
                     }
                 });
-        })), listener::onFailure);
+        }, listener::onFailure);
     }
 
     private RepositoryMetaData getRepoMetaData(ClusterState state) {
diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
index 9340e1508999c..45967235e8086 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
@@ -365,9 +365,12 @@ public boolean hasOldVersionSnapshots(String repositoryName, RepositoryData repo
             } else {
                 try {
                     final Repository repository = repositoriesService.repository(repositoryName);
-                    hasOldFormatSnapshots = snapshotIds.stream().map(repository::getSnapshotInfo).anyMatch(
-                        snapshotInfo -> (excluded == null || snapshotInfo.snapshotId().equals(excluded) == false)
-                            && snapshotInfo.version().before(SHARD_GEN_IN_REPO_DATA_VERSION));
+                    hasOldFormatSnapshots = snapshotIds.stream().filter(snapshotId -> snapshotId.equals(excluded) == false).anyMatch(
+                        snapshotId -> {
+                            final Version known = repositoryData.getVersion(snapshotId);
+                            return (known == null ? repository.getSnapshotInfo(snapshotId).version() : known)
+                                .before(SHARD_GEN_IN_REPO_DATA_VERSION);
+                        });
                 } catch (SnapshotMissingException e) {
                     logger.warn("Failed to load snapshot metadata, assuming repository is in old format", e);
                     return true;
diff --git a/server/src/test/java/org/elasticsearch/repositories/RepositoryDataTests.java b/server/src/test/java/org/elasticsearch/repositories/RepositoryDataTests.java
index 12adfb49120a7..0d15856745793 100644
--- a/server/src/test/java/org/elasticsearch/repositories/RepositoryDataTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/RepositoryDataTests.java
@@ -20,6 +20,7 @@
 package org.elasticsearch.repositories;
 
 import org.elasticsearch.ElasticsearchParseException;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.xcontent.XContent;
@@ -105,7 +106,8 @@ public void testAddSnapshots() {
             builder.put(indexId, 0, "2");
         }
         RepositoryData newRepoData = repositoryData.addSnapshot(newSnapshot,
-            randomFrom(SnapshotState.SUCCESS, SnapshotState.PARTIAL, SnapshotState.FAILED), builder.build());
+            randomFrom(SnapshotState.SUCCESS, SnapshotState.PARTIAL, SnapshotState.FAILED),
+            randomFrom(Version.CURRENT, Version.CURRENT.minimumCompatibilityVersion()), builder.build());
         // verify that the new repository data has the new snapshot and its indices
         assertTrue(newRepoData.getSnapshotIds().contains(newSnapshot));
         for (IndexId indexId : indices) {
@@ -122,17 +124,19 @@ public void testInitIndices() {
         final int numSnapshots = randomIntBetween(1, 30);
         final Map<String, SnapshotId> snapshotIds = new HashMap<>(numSnapshots);
         final Map<String, SnapshotState> snapshotStates = new HashMap<>(numSnapshots);
+        final Map<String, Version> snapshotVersions = new HashMap<>(numSnapshots);
         for (int i = 0; i < numSnapshots; i++) {
             final SnapshotId snapshotId = new SnapshotId(randomAlphaOfLength(8), UUIDs.randomBase64UUID());
             snapshotIds.put(snapshotId.getUUID(), snapshotId);
             snapshotStates.put(snapshotId.getUUID(), randomFrom(SnapshotState.values()));
+            snapshotVersions.put(snapshotId.getUUID(), randomFrom(Version.CURRENT, Version.CURRENT.minimumCompatibilityVersion()));
         }
         RepositoryData repositoryData = new RepositoryData(EMPTY_REPO_GEN, snapshotIds,
-            Collections.emptyMap(), Collections.emptyMap(), ShardGenerations.EMPTY);
+            Collections.emptyMap(), Collections.emptyMap(), Collections.emptyMap(), ShardGenerations.EMPTY);
         // test that initializing indices works
         Map<IndexId, Set<SnapshotId>> indices = randomIndices(snapshotIds);
         RepositoryData newRepoData =
-            new RepositoryData(repositoryData.getGenId(), snapshotIds, snapshotStates, indices, ShardGenerations.EMPTY);
+            new RepositoryData(repositoryData.getGenId(), snapshotIds, snapshotStates, snapshotVersions, indices, ShardGenerations.EMPTY);
         List<SnapshotId> expected = new ArrayList<>(repositoryData.getSnapshotIds());
         Collections.sort(expected);
         List<SnapshotId> actual = new ArrayList<>(newRepoData.getSnapshotIds());
@@ -168,7 +172,8 @@ public void testResolveIndexId() {
     public void testGetSnapshotState() {
         final SnapshotId snapshotId = new SnapshotId(randomAlphaOfLength(8), UUIDs.randomBase64UUID());
         final SnapshotState state = randomFrom(SnapshotState.values());
-        final RepositoryData repositoryData = RepositoryData.EMPTY.addSnapshot(snapshotId, state, ShardGenerations.EMPTY);
+        final RepositoryData repositoryData = RepositoryData.EMPTY.addSnapshot(snapshotId, state,
+            randomFrom(Version.CURRENT, Version.CURRENT.minimumCompatibilityVersion()), ShardGenerations.EMPTY);
         assertEquals(state, repositoryData.getSnapshotState(snapshotId));
         assertNull(repositoryData.getSnapshotState(new SnapshotId(randomAlphaOfLength(8), UUIDs.randomBase64UUID())));
     }
@@ -187,9 +192,11 @@ public void testIndexThatReferencesAnUnknownSnapshot() throws IOException {
 
         Map<String, SnapshotId> snapshotIds = new HashMap<>();
         Map<String, SnapshotState> snapshotStates = new HashMap<>();
+        Map<String, Version> snapshotVersions = new HashMap<>();
         for (SnapshotId snapshotId : parsedRepositoryData.getSnapshotIds()) {
             snapshotIds.put(snapshotId.getUUID(), snapshotId);
             snapshotStates.put(snapshotId.getUUID(), parsedRepositoryData.getSnapshotState(snapshotId));
+            snapshotVersions.put(snapshotId.getUUID(), parsedRepositoryData.getVersion(snapshotId));
         }
 
         final IndexId corruptedIndexId = randomFrom(parsedRepositoryData.getIndices().values());
@@ -211,7 +218,7 @@ public void testIndexThatReferencesAnUnknownSnapshot() throws IOException {
         assertNotNull(corruptedIndexId);
 
         RepositoryData corruptedRepositoryData = new RepositoryData(parsedRepositoryData.getGenId(), snapshotIds, snapshotStates,
-            indexSnapshots, shardGenBuilder.build());
+            snapshotVersions, indexSnapshots, shardGenBuilder.build());
 
         final XContentBuilder corruptedBuilder = XContentBuilder.builder(xContent);
         corruptedRepositoryData.snapshotsToXContent(corruptedBuilder, true);
@@ -280,7 +287,8 @@ public static RepositoryData generateRandomRepoData() {
                     builder.put(someIndex, j, uuid);
                 }
             }
-            repositoryData = repositoryData.addSnapshot(snapshotId, randomFrom(SnapshotState.values()), builder.build());
+            repositoryData = repositoryData.addSnapshot(snapshotId, randomFrom(SnapshotState.values()),
+                randomFrom(Version.CURRENT, Version.CURRENT.minimumCompatibilityVersion()), builder.build());
         }
         return repositoryData;
     }
diff --git a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
index 13102182cd7b0..3f0e80a93d263 100644
--- a/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
+++ b/server/src/test/java/org/elasticsearch/repositories/blobstore/BlobStoreRepositoryTests.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.repositories.blobstore;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.action.support.master.AcknowledgedResponse;
@@ -259,7 +260,7 @@ private RepositoryData addRandomSnapshotsToRepoData(RepositoryData repoData, boo
                 builder.put(new IndexId(randomAlphaOfLength(8), UUIDs.randomBase64UUID()), 0, "1");
             }
             repoData = repoData.addSnapshot(snapshotId,
-                randomFrom(SnapshotState.SUCCESS, SnapshotState.PARTIAL, SnapshotState.FAILED), builder.build());
+                randomFrom(SnapshotState.SUCCESS, SnapshotState.PARTIAL, SnapshotState.FAILED), Version.CURRENT, builder.build());
         }
         return repoData;
     }
diff --git a/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java b/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
index 9abb107521042..8e08d0700ca2a 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
@@ -18,6 +18,7 @@
  */
 package org.elasticsearch.snapshots;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotResponse;
 import org.elasticsearch.action.support.PlainActionFuture;
@@ -27,18 +28,25 @@
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoriesMetaData;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
+import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.repositories.RepositoriesService;
 import org.elasticsearch.repositories.Repository;
 import org.elasticsearch.repositories.RepositoryData;
 import org.elasticsearch.repositories.RepositoryException;
+import org.elasticsearch.repositories.ShardGenerations;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
 import org.elasticsearch.threadpool.ThreadPool;
 
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.nio.file.StandardOpenOption;
+import java.util.Collections;
 import java.util.Locale;
+import java.util.function.Function;
+import java.util.stream.Collectors;
 
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.containsString;
@@ -263,11 +271,24 @@ public void testHandlingMissingRootLevelSnapshotMetadata() throws Exception {
         logger.info("--> delete root level snapshot metadata blob for snapshot [{}]", snapshotToCorrupt);
         Files.delete(repo.resolve(String.format(Locale.ROOT, BlobStoreRepository.SNAPSHOT_NAME_FORMAT, snapshotToCorrupt.getUUID())));
 
+        logger.info("--> strip version information from index-N blob");
+        final RepositoryData withoutVersions = new RepositoryData(repositoryData.getGenId(),
+            repositoryData.getSnapshotIds().stream().collect(Collectors.toMap(
+                SnapshotId::getUUID, Function.identity())),
+            repositoryData.getSnapshotIds().stream().collect(Collectors.toMap(
+                SnapshotId::getUUID, repositoryData::getSnapshotState)),
+            Collections.emptyMap(), Collections.emptyMap(), ShardGenerations.EMPTY);
+
+        Files.write(repo.resolve(BlobStoreRepository.INDEX_FILE_PREFIX + withoutVersions.getGenId()),
+            BytesReference.toBytes(BytesReference.bytes(withoutVersions.snapshotsToXContent(XContentFactory.jsonBuilder(),
+                true))), StandardOpenOption.TRUNCATE_EXISTING);
+
         logger.info("--> verify that repo is assumed in old metadata format");
         final SnapshotsService snapshotsService = internalCluster().getCurrentMasterNodeInstance(SnapshotsService.class);
         final ThreadPool threadPool = internalCluster().getCurrentMasterNodeInstance(ThreadPool.class);
         assertThat(PlainActionFuture.get(f -> threadPool.generic().execute(
-            ActionRunnable.supply(f, () -> snapshotsService.hasOldVersionSnapshots(repoName, repositoryData, null)))), is(true));
+            ActionRunnable.supply(f, () -> snapshotsService.hasOldVersionSnapshots(repoName, getRepositoryData(repository), null)))),
+            is(true));
 
         logger.info("--> verify that snapshot with missing root level metadata can be deleted");
         assertAcked(client().admin().cluster().prepareDeleteSnapshot(repoName, snapshotToCorrupt.getName()).get());
@@ -276,6 +297,10 @@ public void testHandlingMissingRootLevelSnapshotMetadata() throws Exception {
         assertThat(PlainActionFuture.get(f -> threadPool.generic().execute(
             ActionRunnable.supply(f, () -> snapshotsService.hasOldVersionSnapshots(repoName, getRepositoryData(repository), null)))),
             is(false));
+        final RepositoryData finalRepositoryData = getRepositoryData(repository);
+        for (SnapshotId snapshotId : finalRepositoryData.getSnapshotIds()) {
+            assertThat(finalRepositoryData.getVersion(snapshotId), is(Version.CURRENT));
+        }
     }
 
     private void assertRepositoryBlocked(Client client, String repo, String existingSnapshot) {
diff --git a/test/framework/src/main/java/org/elasticsearch/index/shard/RestoreOnlyRepository.java b/test/framework/src/main/java/org/elasticsearch/index/shard/RestoreOnlyRepository.java
index f0118d3c0b699..ecce14dfd460c 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/shard/RestoreOnlyRepository.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/shard/RestoreOnlyRepository.java
@@ -88,7 +88,7 @@ public IndexMetaData getSnapshotIndexMetaData(SnapshotId snapshotId, IndexId ind
     @Override
     public void getRepositoryData(ActionListener<RepositoryData> listener) {
         final IndexId indexId = new IndexId(indexName, "blah");
-        listener.onResponse(new RepositoryData(EMPTY_REPO_GEN, Collections.emptyMap(), Collections.emptyMap(),
+        listener.onResponse(new RepositoryData(EMPTY_REPO_GEN, Collections.emptyMap(), Collections.emptyMap(), Collections.emptyMap(),
             Collections.singletonMap(indexId, emptySet()), ShardGenerations.EMPTY));
     }
 
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/repository/CcrRepository.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/repository/CcrRepository.java
index 20c098ee7f82a..19ee64290133c 100644
--- a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/repository/CcrRepository.java
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/repository/CcrRepository.java
@@ -13,6 +13,7 @@
 import org.apache.lucene.index.IndexCommit;
 import org.elasticsearch.ElasticsearchSecurityException;
 import org.elasticsearch.ExceptionsHelper;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.cluster.state.ClusterStateRequest;
 import org.elasticsearch.action.admin.cluster.state.ClusterStateResponse;
@@ -231,6 +232,7 @@ public void getRepositoryData(ActionListener<RepositoryData> listener) {
 
             Map<String, SnapshotId> copiedSnapshotIds = new HashMap<>();
             Map<String, SnapshotState> snapshotStates = new HashMap<>(copiedSnapshotIds.size());
+            Map<String, Version> snapshotVersions = new HashMap<>(copiedSnapshotIds.size());
             Map<IndexId, Set<SnapshotId>> indexSnapshots = new HashMap<>(copiedSnapshotIds.size());
 
             ImmutableOpenMap<String, IndexMetaData> remoteIndices = remoteMetaData.getIndices();
@@ -239,10 +241,11 @@ public void getRepositoryData(ActionListener<RepositoryData> listener) {
                 SnapshotId snapshotId = new SnapshotId(LATEST, LATEST);
                 copiedSnapshotIds.put(indexName, snapshotId);
                 snapshotStates.put(indexName, SnapshotState.SUCCESS);
+                snapshotVersions.put(indexName, Version.CURRENT);
                 Index index = remoteIndices.get(indexName).getIndex();
                 indexSnapshots.put(new IndexId(indexName, index.getUUID()), Collections.singleton(snapshotId));
             }
-            return new RepositoryData(1, copiedSnapshotIds, snapshotStates, indexSnapshots, ShardGenerations.EMPTY);
+            return new RepositoryData(1, copiedSnapshotIds, snapshotStates, snapshotVersions, indexSnapshots, ShardGenerations.EMPTY);
         });
     }
 

From a2ed7e9aeb550e8aa35c5ae6754745327d8020ce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <cbuescher@posteo.de>
Date: Tue, 14 Jan 2020 17:18:47 +0100
Subject: [PATCH 562/686] Deprecate and remove camel-case nGram and edgeNGram
 tokenizers (#50862)

We already deprecated and removed the camel-case versions of the nGram and edgeNGram
filters a while ago and we should do the same with the nGram and edgeNGram tokenizers.
This PR deprecates the use of these names in favour of ngram and edge_ngram in 7
and disallows usage in new indices starting with 8.

Closes #50561
---
 .../migration/migrate_8_0/analysis.asciidoc   |  9 +++
 .../analysis/common/CommonAnalysisPlugin.java | 44 +++++++++-
 .../common/CommonAnalysisPluginTests.java     | 81 +++++++++++++++++++
 .../common/EdgeNGramTokenizerTests.java       |  6 +-
 4 files changed, 135 insertions(+), 5 deletions(-)

diff --git a/docs/reference/migration/migrate_8_0/analysis.asciidoc b/docs/reference/migration/migrate_8_0/analysis.asciidoc
index dd4b4ae73e920..6a7205436d0f6 100644
--- a/docs/reference/migration/migrate_8_0/analysis.asciidoc
+++ b/docs/reference/migration/migrate_8_0/analysis.asciidoc
@@ -16,3 +16,12 @@
 The `nGram` and `edgeNGram` token filter names that have been deprecated since
 version 6.4 have been removed. Both token filters can only be used by their 
 alternative names `ngram` and `edge_ngram` since version 7.0.
+
+[float]
+[[nGram-edgeNGram-tokenizer-dreprecation]]
+==== Disallow use of the `nGram` and `edgeNGram` tokenizer names
+
+The `nGram` and `edgeNGram` tokenizer names haven been deprecated with 7.6 and are no longer
+supported on new indices. Mappings for indices created after 7.6 will continue to work but
+emit a deprecation warning. The tokenizer name should be changed to the fully equivalent
+`ngram` or `edge_ngram` names for new indices and in index templates.
diff --git a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
index b9de97952eb4b..3c614f84d4e23 100644
--- a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
+++ b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
@@ -337,9 +337,29 @@ public Map<String, AnalysisProvider<TokenizerFactory>> getTokenizers() {
         tokenizers.put("simple_pattern", SimplePatternTokenizerFactory::new);
         tokenizers.put("simple_pattern_split", SimplePatternSplitTokenizerFactory::new);
         tokenizers.put("thai", ThaiTokenizerFactory::new);
-        tokenizers.put("nGram", NGramTokenizerFactory::new);
+        tokenizers.put("nGram", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {
+            if (indexSettings.getIndexVersionCreated().onOrAfter(org.elasticsearch.Version.V_8_0_0)) {
+                throw new IllegalArgumentException("The [nGram] tokenizer name was deprecated in 7.6. "
+                        + "Please use the tokenizer name to [ngram] for indices created in versions 8 or higher instead.");
+            } else if (indexSettings.getIndexVersionCreated().onOrAfter(org.elasticsearch.Version.V_7_6_0)) {
+                deprecationLogger.deprecatedAndMaybeLog("nGram_tokenizer_deprecation",
+                        "The [nGram] tokenizer name is deprecated and will be removed in a future version. "
+                                + "Please change the tokenizer name to [ngram] instead.");
+            }
+            return new NGramTokenizerFactory(indexSettings, environment, name, settings);
+        });
         tokenizers.put("ngram", NGramTokenizerFactory::new);
-        tokenizers.put("edgeNGram", EdgeNGramTokenizerFactory::new);
+        tokenizers.put("edgeNGram", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {
+            if (indexSettings.getIndexVersionCreated().onOrAfter(org.elasticsearch.Version.V_8_0_0)) {
+                throw new IllegalArgumentException("The [edgeNGram] tokenizer name was deprecated in 7.6. "
+                        + "Please use the tokenizer name to [edge_nGram] for indices created in versions 8 or higher instead.");
+            } else if (indexSettings.getIndexVersionCreated().onOrAfter(org.elasticsearch.Version.V_7_6_0)) {
+                deprecationLogger.deprecatedAndMaybeLog("edgeNGram_tokenizer_deprecation",
+                        "The [edgeNGram] tokenizer name is deprecated and will be removed in a future version. "
+                                + "Please change the tokenizer name to [edge_ngram] instead.");
+            }
+            return new EdgeNGramTokenizerFactory(indexSettings, environment, name, settings);
+        });
         tokenizers.put("edge_ngram", EdgeNGramTokenizerFactory::new);
         tokenizers.put("char_group", CharGroupTokenizerFactory::new);
         tokenizers.put("classic", ClassicTokenizerFactory::new);
@@ -522,8 +542,26 @@ public List<PreConfiguredTokenizer> getPreConfiguredTokenizers() {
         tokenizers.add(PreConfiguredTokenizer.singleton("lowercase", XLowerCaseTokenizer::new));
 
         // Temporary shim for aliases. TODO deprecate after they are moved
-        tokenizers.add(PreConfiguredTokenizer.singleton("nGram", NGramTokenizer::new));
+        tokenizers.add(PreConfiguredTokenizer.elasticsearchVersion("nGram", (version) -> {
+            if (version.onOrAfter(org.elasticsearch.Version.V_8_0_0)) {
+                throw new IllegalArgumentException("The [nGram] tokenizer name was deprecated in 7.6. "
+                        + "Please use the tokenizer name to [ngram] for indices created in versions 8 or higher instead.");
+            } else if (version.onOrAfter(org.elasticsearch.Version.V_7_6_0)) {
+                deprecationLogger.deprecatedAndMaybeLog("nGram_tokenizer_deprecation",
+                        "The [nGram] tokenizer name is deprecated and will be removed in a future version. "
+                                + "Please change the tokenizer name to [ngram] instead.");
+            }
+            return new NGramTokenizer();
+        }));
         tokenizers.add(PreConfiguredTokenizer.elasticsearchVersion("edgeNGram", (version) -> {
+            if (version.onOrAfter(org.elasticsearch.Version.V_8_0_0)) {
+                throw new IllegalArgumentException("The [edgeNGram] tokenizer name was deprecated in 7.6. "
+                        + "Please use the tokenizer name to [edge_ngram] for indices created in versions 8 or higher instead.");
+            } else if (version.onOrAfter(org.elasticsearch.Version.V_7_6_0)) {
+                deprecationLogger.deprecatedAndMaybeLog("edgeNGram_tokenizer_deprecation",
+                        "The [edgeNGram] tokenizer name is deprecated and will be removed in a future version. "
+                                + "Please change the tokenizer name to [edge_ngram] instead.");
+            }
             if (version.onOrAfter(Version.V_7_3_0)) {
                 return new EdgeNGramTokenizer(NGramTokenizer.DEFAULT_MIN_NGRAM_SIZE, NGramTokenizer.DEFAULT_MAX_NGRAM_SIZE);
             }
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
index 607450b9322d6..03200d1966ba3 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
@@ -19,15 +19,18 @@
 
 package org.elasticsearch.analysis.common;
 
+import org.apache.lucene.analysis.Tokenizer;
 import org.elasticsearch.Version;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.env.Environment;
+import org.elasticsearch.index.analysis.TokenizerFactory;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
 import org.elasticsearch.test.VersionUtils;
 
 import java.io.IOException;
+import java.util.Map;
 
 public class CommonAnalysisPluginTests extends ESTestCase {
 
@@ -102,4 +105,82 @@ public void testEdgeNGramFilterInCustomAnalyzerDeprecationError() throws IOExcep
                     + "Please change the filter name to [edge_ngram] instead.");
         }
     }
+
+    /**
+     * Check that we log a deprecation warning for "nGram" and "edgeNGram" tokenizer names with 7.6 and
+     * disallow usages for indices created after 8.0
+     */
+    public void testNGramTokenizerDeprecation() throws IOException {
+        // tests for prebuilt tokenizer
+        doTestPrebuiltTokenizerDeprecation("nGram", "ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_5_2), false);
+        doTestPrebuiltTokenizerDeprecation("edgeNGram", "edge_ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_5_2), false);
+        doTestPrebuiltTokenizerDeprecation("nGram", "ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_7_6_0,
+                        Version.max(Version.V_7_6_0, VersionUtils.getPreviousVersion(Version.V_8_0_0))),
+                true);
+        doTestPrebuiltTokenizerDeprecation("edgeNGram", "edge_ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_7_6_0,
+                        Version.max(Version.V_7_6_0, VersionUtils.getPreviousVersion(Version.V_8_0_0))), true);
+        expectThrows(IllegalArgumentException.class, () -> doTestPrebuiltTokenizerDeprecation("nGram", "ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_8_0_0, Version.CURRENT), true));
+        expectThrows(IllegalArgumentException.class, () -> doTestPrebuiltTokenizerDeprecation("edgeNGram", "edge_ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_8_0_0, Version.CURRENT), true));
+
+        // same batch of tests for custom tokenizer definition in the settings
+        doTestCustomTokenizerDeprecation("nGram", "ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_5_2), false);
+        doTestCustomTokenizerDeprecation("edgeNGram", "edge_ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_5_2), false);
+        doTestCustomTokenizerDeprecation("nGram", "ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_7_6_0,
+                        Version.max(Version.V_7_6_0, VersionUtils.getPreviousVersion(Version.V_8_0_0))),
+                true);
+        doTestCustomTokenizerDeprecation("edgeNGram", "edge_ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_7_6_0,
+                        Version.max(Version.V_7_6_0, VersionUtils.getPreviousVersion(Version.V_8_0_0))), true);
+        expectThrows(IllegalArgumentException.class, () -> doTestCustomTokenizerDeprecation("nGram", "ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_8_0_0, Version.CURRENT), true));
+        expectThrows(IllegalArgumentException.class, () -> doTestCustomTokenizerDeprecation("edgeNGram", "edge_ngram",
+                VersionUtils.randomVersionBetween(random(), Version.V_8_0_0, Version.CURRENT), true));
+    }
+
+    public void doTestPrebuiltTokenizerDeprecation(String deprecatedName, String replacement, Version version, boolean expectWarning)
+            throws IOException {
+        final Settings settings = Settings.builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(IndexMetaData.SETTING_VERSION_CREATED, version).build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            Map<String, TokenizerFactory> tokenizers = createTestAnalysis(
+                    IndexSettingsModule.newIndexSettings("index", settings), settings, commonAnalysisPlugin).tokenizer;
+            TokenizerFactory tokenizerFactory = tokenizers.get(deprecatedName);
+
+            Tokenizer tokenizer = tokenizerFactory.create();
+            assertNotNull(tokenizer);
+            if (expectWarning) {
+                assertWarnings("The [" + deprecatedName + "] tokenizer name is deprecated and will be removed in a future version. "
+                        + "Please change the tokenizer name to [" + replacement + "] instead.");
+            }
+        }
+    }
+
+    public void doTestCustomTokenizerDeprecation(String deprecatedName, String replacement, Version version, boolean expectWarning)
+            throws IOException {
+        final Settings settings = Settings.builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(IndexMetaData.SETTING_VERSION_CREATED, version)
+            .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+            .put("index.analysis.analyzer.custom_analyzer.tokenizer", "my_tokenizer")
+            .put("index.analysis.tokenizer.my_tokenizer.type", deprecatedName)
+        .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings), settings, commonAnalysisPlugin);
+
+            if (expectWarning) {
+                assertWarnings("The [" + deprecatedName + "] tokenizer name is deprecated and will be removed in a future version. "
+                        + "Please change the tokenizer name to [" + replacement + "] instead.");
+            }
+        }
+    }
 }
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/EdgeNGramTokenizerTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/EdgeNGramTokenizerTests.java
index 95bf41f8e92c9..e1fbe90647e4b 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/EdgeNGramTokenizerTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/EdgeNGramTokenizerTests.java
@@ -86,9 +86,11 @@ public void testPreConfiguredTokenizer() throws IOException {
             }
         }
 
-        // Check deprecated name as well
+        // Check deprecated name as well, needs version before 8.0 because throws IAE after that
         {
-            try (IndexAnalyzers indexAnalyzers = buildAnalyzers(Version.CURRENT, "edgeNGram")) {
+            try (IndexAnalyzers indexAnalyzers = buildAnalyzers(
+                    VersionUtils.randomVersionBetween(random(), Version.V_7_3_0, VersionUtils.getPreviousVersion(Version.V_8_0_0)),
+                    "edgeNGram")) {
                 NamedAnalyzer analyzer = indexAnalyzers.get("my_analyzer");
                 assertNotNull(analyzer);
                 assertAnalyzesTo(analyzer, "test", new String[]{"t", "te"});

From ab8627bae97dd75aa57150898071ad3686d99b74 Mon Sep 17 00:00:00 2001
From: Tal Levy <JubBoy333@gmail.com>
Date: Tue, 14 Jan 2020 08:29:10 -0800
Subject: [PATCH 563/686] Adds support for geo-bounds filtering in geogrid
 aggregations (#50002)

It is fairly common to filter the geo point candidates in
geohash_grid and geotile_grid aggregations according to some
viewable bounding box. This change introduces the option of
specifying this filter directly in the tiling aggregation.

This is even more relevant to `geo_shape` where the bounds will restrict
the shape to be within the bounds

this optional `bounds` parameter is parsed in an equivalent fashion to
the bounds specified in the geo_bounding_box query.
---
 .../bucket/geohashgrid-aggregation.asciidoc   | 58 +++++++++++
 .../bucket/geotilegrid-aggregation.asciidoc   | 58 +++++++++++
 .../query-dsl/geo-bounding-box-query.asciidoc |  1 +
 .../common/geo/GeoBoundingBox.java            | 25 +++++
 .../elasticsearch/common/geo/GeoUtils.java    |  1 +
 .../GeoTileGridValuesSourceBuilder.java       | 31 +++++-
 .../bucket/geogrid/BoundedCellValues.java     | 49 ++++++++++
 .../bucket/geogrid/CellIdSource.java          | 39 ++------
 .../bucket/geogrid/CellValues.java            | 68 +++++++++++++
 .../geogrid/GeoGridAggregationBuilder.java    | 40 +++++++-
 .../bucket/geogrid/GeoGridAggregator.java     |  4 +-
 .../GeoHashGridAggregationBuilder.java        | 12 ++-
 .../bucket/geogrid/GeoHashGridAggregator.java |  8 +-
 .../geogrid/GeoHashGridAggregatorFactory.java | 19 ++--
 .../GeoTileGridAggregationBuilder.java        | 12 +--
 .../bucket/geogrid/GeoTileGridAggregator.java |  8 +-
 .../geogrid/GeoTileGridAggregatorFactory.java | 19 ++--
 .../bucket/geogrid/GeoTileUtils.java          |  2 +-
 .../bucket/geogrid/UnboundedCellValues.java   | 39 ++++++++
 .../common/geo/GeoBoundingBoxTests.java       | 48 ++++++++-
 .../aggregations/bucket/GeoHashGridTests.java | 31 ++++++
 .../aggregations/bucket/GeoTileGridTests.java | 76 ++++++++++++++
 .../CompositeAggregationBuilderTests.java     |  9 +-
 .../GeoTileGridValuesSourceBuilderTests.java  | 32 ++++++
 .../geogrid/GeoGridAggregatorTestCase.java    | 98 ++++++++++++++++---
 .../geogrid/GeoHashGridParserTests.java       | 17 ++++
 .../geogrid/GeoTileGridAggregatorTests.java   |  1 -
 .../geogrid/GeoTileGridParserTests.java       | 17 ++++
 28 files changed, 726 insertions(+), 96 deletions(-)
 create mode 100644 server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/BoundedCellValues.java
 create mode 100644 server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/CellValues.java
 create mode 100644 server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/UnboundedCellValues.java
 create mode 100644 server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoTileGridTests.java

diff --git a/docs/reference/aggregations/bucket/geohashgrid-aggregation.asciidoc b/docs/reference/aggregations/bucket/geohashgrid-aggregation.asciidoc
index 59033843078b1..8d4652aebe2c5 100644
--- a/docs/reference/aggregations/bucket/geohashgrid-aggregation.asciidoc
+++ b/docs/reference/aggregations/bucket/geohashgrid-aggregation.asciidoc
@@ -191,6 +191,62 @@ var bbox = geohash.decode_bbox('u17');
 --------------------------------------------------
 // NOTCONSOLE
 
+==== Requests with additional bounding box filtering
+
+The `geohash_grid` aggregation supports an optional `bounds` parameter
+that restricts the points considered to those that fall within the
+bounds provided. The `bounds` parameter accepts the bounding box in
+all the same <<query-dsl-geo-bounding-box-query-accepted-formats,accepted formats>> of the
+bounds specified in the Geo Bounding Box Query. This bounding box can be used with or
+without an additional `geo_bounding_box` query filtering the points prior to aggregating.
+It is an independent bounding box that can intersect with, be equal to, or be disjoint
+to any additional `geo_bounding_box` queries defined in the context of the aggregation.
+
+[source,console,id=geohashgrid-aggregation-with-bounds]
+--------------------------------------------------
+POST /museums/_search?size=0
+{
+    "aggregations" : {
+        "tiles-in-bounds" : {
+            "geohash_grid" : {
+                "field" : "location",
+                "precision" : 8,
+                "bounds": {
+                  "top_left" : "53.4375, 4.21875",
+                  "bottom_right" : "52.03125, 5.625"
+                }
+            }
+        }
+    }
+}
+--------------------------------------------------
+// TEST[continued]
+
+[source,console-result]
+--------------------------------------------------
+{
+    ...
+    "aggregations" : {
+        "tiles-in-bounds" : {
+           "buckets" : [
+               {
+                 "key" : "u173zy3j",
+                 "doc_count" : 1
+               },
+               {
+                 "key" : "u173zvfz",
+                 "doc_count" : 1
+               },
+               {
+                 "key" : "u173zt90",
+                 "doc_count" : 1
+               }
+           ]
+        }
+    }
+}
+--------------------------------------------------
+// TESTRESPONSE[s/\.\.\./"took": $body.took,"_shards": $body._shards,"hits":$body.hits,"timed_out":false,/]
 
 ==== Cell dimensions at the equator
 The table below shows the metric dimensions for cells covered by various string lengths of geohash.
@@ -230,6 +286,8 @@ precision::     Optional. The string length of the geohashes used to define
                 to precision levels higher than the supported 12 levels,
                 (e.g. for distances <5.6cm) the value is rejected.
 
+bounds:         Optional. The bounding box to filter the points in the bucket.
+
 size::          Optional. The maximum number of geohash buckets to return
                 (defaults to 10,000). When results are trimmed, buckets are
                 prioritised based on the volumes of documents they contain.
diff --git a/docs/reference/aggregations/bucket/geotilegrid-aggregation.asciidoc b/docs/reference/aggregations/bucket/geotilegrid-aggregation.asciidoc
index c60b14b0f2687..25cc1a977c86b 100644
--- a/docs/reference/aggregations/bucket/geotilegrid-aggregation.asciidoc
+++ b/docs/reference/aggregations/bucket/geotilegrid-aggregation.asciidoc
@@ -162,6 +162,62 @@ POST /museums/_search?size=0
 --------------------------------------------------
 // TESTRESPONSE[s/\.\.\./"took": $body.took,"_shards": $body._shards,"hits":$body.hits,"timed_out":false,/]
 
+==== Requests with additional bounding box filtering
+
+The `geotile_grid` aggregation supports an optional `bounds` parameter
+that restricts the points considered to those that fall within the
+bounds provided. The `bounds` parameter accepts the bounding box in
+all the same <<query-dsl-geo-bounding-box-query-accepted-formats,accepted formats>> of the
+bounds specified in the Geo Bounding Box Query. This bounding box can be used with or
+without an additional `geo_bounding_box` query filtering the points prior to aggregating.
+It is an independent bounding box that can intersect with, be equal to, or be disjoint
+to any additional `geo_bounding_box` queries defined in the context of the aggregation.
+
+[source,console,id=geotilegrid-aggregation-with-bounds]
+--------------------------------------------------
+POST /museums/_search?size=0
+{
+    "aggregations" : {
+        "tiles-in-bounds" : {
+            "geotile_grid" : {
+                "field" : "location",
+                "precision" : 22,
+                "bounds": {
+                  "top_left" : "52.4, 4.9",
+                  "bottom_right" : "52.3, 5.0"
+                }
+            }
+        }
+    }
+}
+--------------------------------------------------
+// TEST[continued]
+
+[source,console-result]
+--------------------------------------------------
+{
+    ...
+    "aggregations" : {
+        "tiles-in-bounds" : {
+           "buckets" : [
+               {
+                 "key" : "22/2154412/1378379",
+                 "doc_count" : 1
+               },
+               {
+                 "key" : "22/2154385/1378332",
+                 "doc_count" : 1
+               },
+               {
+                 "key" : "22/2154259/1378425",
+                 "doc_count" : 1
+               }
+           ]
+        }
+    }
+}
+--------------------------------------------------
+// TESTRESPONSE[s/\.\.\./"took": $body.took,"_shards": $body._shards,"hits":$body.hits,"timed_out":false,/]
 
 ==== Options
 
@@ -172,6 +228,8 @@ precision::     Optional. The integer zoom of the key used to define
                 cells/buckets in the results. Defaults to 7.
                 Values outside of [0,29] will be rejected.
 
+bounds:         Optional. The bounding box to filter the points in the bucket.
+
 size::          Optional. The maximum number of geohash buckets to return
                 (defaults to 10,000). When results are trimmed, buckets are
                 prioritised based on the volumes of documents they contain.
diff --git a/docs/reference/query-dsl/geo-bounding-box-query.asciidoc b/docs/reference/query-dsl/geo-bounding-box-query.asciidoc
index a51283ceeb341..27f37423fa28f 100644
--- a/docs/reference/query-dsl/geo-bounding-box-query.asciidoc
+++ b/docs/reference/query-dsl/geo-bounding-box-query.asciidoc
@@ -84,6 +84,7 @@ be executed in memory or indexed. See <<geo-bbox-type,Type>> below for further d
 Default is `memory`.
 |=======================================================================
 
+[[query-dsl-geo-bounding-box-query-accepted-formats]]
 [float]
 ==== Accepted Formats
 
diff --git a/server/src/main/java/org/elasticsearch/common/geo/GeoBoundingBox.java b/server/src/main/java/org/elasticsearch/common/geo/GeoBoundingBox.java
index 78e81925275d7..01315d3e9848c 100644
--- a/server/src/main/java/org/elasticsearch/common/geo/GeoBoundingBox.java
+++ b/server/src/main/java/org/elasticsearch/common/geo/GeoBoundingBox.java
@@ -68,6 +68,11 @@ public GeoBoundingBox(StreamInput input) throws IOException {
         this.bottomRight = input.readGeoPoint();
     }
 
+    public boolean isUnbounded() {
+        return Double.isNaN(topLeft.lon()) || Double.isNaN(topLeft.lat())
+            || Double.isNaN(bottomRight.lon()) || Double.isNaN(bottomRight.lat());
+    }
+
     public GeoPoint topLeft() {
         return topLeft;
     }
@@ -120,6 +125,26 @@ public XContentBuilder toXContentFragment(XContentBuilder builder, boolean build
         return builder;
     }
 
+    /**
+     * If the bounding box crosses the date-line (left greater-than right) then the
+     * longitude of the point need only to be higher than the left or lower
+     * than the right. Otherwise, it must be both.
+     *
+     * @param lon the longitude of the point
+     * @param lat the latitude of the point
+     * @return whether the point (lon, lat) is in the specified bounding box
+     */
+    public boolean pointInBounds(double lon, double lat) {
+        if (lat >= bottom() && lat <= top()) {
+            if (left() <= right()) {
+                return lon >= left() && lon <= right();
+            } else {
+                return lon >= left() || lon <= right();
+            }
+        }
+        return false;
+    }
+
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeGeoPoint(topLeft);
diff --git a/server/src/main/java/org/elasticsearch/common/geo/GeoUtils.java b/server/src/main/java/org/elasticsearch/common/geo/GeoUtils.java
index 359b7781b895f..d33f90043b1d5 100644
--- a/server/src/main/java/org/elasticsearch/common/geo/GeoUtils.java
+++ b/server/src/main/java/org/elasticsearch/common/geo/GeoUtils.java
@@ -93,6 +93,7 @@ public static boolean isValidLongitude(double longitude) {
         return true;
     }
 
+
     /**
      * Calculate the width (in meters) of geohash cells at a specific level
      * @param level geohash level must be greater or equal to zero
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
index b6f2b2788cd25..30728af31b730 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
@@ -19,7 +19,10 @@
 
 package org.elasticsearch.search.aggregations.bucket.composite;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.geo.GeoBoundingBox;
+import org.elasticsearch.common.geo.GeoPoint;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ObjectParser;
@@ -45,6 +48,8 @@ public class GeoTileGridValuesSourceBuilder extends CompositeValuesSourceBuilder
     static {
         PARSER = new ObjectParser<>(GeoTileGridValuesSourceBuilder.TYPE);
         PARSER.declareInt(GeoTileGridValuesSourceBuilder::precision, new ParseField("precision"));
+        PARSER.declareField(((p, builder, context) -> builder.geoBoundingBox(GeoBoundingBox.parseBoundingBox(p))),
+            GeoBoundingBox.BOUNDS_FIELD, ObjectParser.ValueType.OBJECT);
         CompositeValuesSourceParserHelper.declareValuesSourceFields(PARSER, ValueType.NUMERIC);
     }
 
@@ -53,6 +58,7 @@ static GeoTileGridValuesSourceBuilder parse(String name, XContentParser parser)
     }
 
     private int precision = GeoTileGridAggregationBuilder.DEFAULT_PRECISION;
+    private GeoBoundingBox geoBoundingBox = new GeoBoundingBox(new GeoPoint(Double.NaN, Double.NaN), new GeoPoint(Double.NaN, Double.NaN));
 
     GeoTileGridValuesSourceBuilder(String name) {
         super(name);
@@ -61,6 +67,9 @@ static GeoTileGridValuesSourceBuilder parse(String name, XContentParser parser)
     GeoTileGridValuesSourceBuilder(StreamInput in) throws IOException {
         super(in);
         this.precision = in.readInt();
+        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            this.geoBoundingBox = new GeoBoundingBox(in);
+        }
     }
 
     public GeoTileGridValuesSourceBuilder precision(int precision) {
@@ -68,6 +77,11 @@ public GeoTileGridValuesSourceBuilder precision(int precision) {
         return this;
     }
 
+    public GeoTileGridValuesSourceBuilder geoBoundingBox(GeoBoundingBox geoBoundingBox) {
+        this.geoBoundingBox = geoBoundingBox;
+        return this;
+    }
+
     @Override
     public GeoTileGridValuesSourceBuilder format(String format) {
         throw new IllegalArgumentException("[format] is not supported for [" + TYPE + "]");
@@ -76,11 +90,17 @@ public GeoTileGridValuesSourceBuilder format(String format) {
     @Override
     protected void innerWriteTo(StreamOutput out) throws IOException {
         out.writeInt(precision);
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            geoBoundingBox.writeTo(out);
+        }
     }
 
     @Override
     protected void doXContentBody(XContentBuilder builder, Params params) throws IOException {
         builder.field("precision", precision);
+        if (geoBoundingBox.isUnbounded() == false) {
+            geoBoundingBox.toXContent(builder, params);
+        }
     }
 
     @Override
@@ -88,9 +108,13 @@ String type() {
         return TYPE;
     }
 
+    GeoBoundingBox geoBoundingBox() {
+        return geoBoundingBox;
+    }
+
     @Override
     public int hashCode() {
-        return Objects.hash(super.hashCode(), precision);
+        return Objects.hash(super.hashCode(), precision, geoBoundingBox);
     }
 
     @Override
@@ -99,7 +123,8 @@ public boolean equals(Object obj) {
         if (obj == null || getClass() != obj.getClass()) return false;
         if (super.equals(obj) == false) return false;
         GeoTileGridValuesSourceBuilder other = (GeoTileGridValuesSourceBuilder) obj;
-        return precision == other.precision;
+        return Objects.equals(precision,other.precision)
+            && Objects.equals(geoBoundingBox, other.geoBoundingBox);
     }
 
     @Override
@@ -112,7 +137,7 @@ protected CompositeValuesSourceConfig innerBuild(QueryShardContext queryShardCon
             ValuesSource.GeoPoint geoPoint = (ValuesSource.GeoPoint) orig;
             // is specified in the builder.
             final MappedFieldType fieldType = config.fieldContext() != null ? config.fieldContext().fieldType() : null;
-            CellIdSource cellIdSource = new CellIdSource(geoPoint, precision, GeoTileUtils::longEncode);
+            CellIdSource cellIdSource = new CellIdSource(geoPoint, precision, geoBoundingBox, GeoTileUtils::longEncode);
             return new CompositeValuesSourceConfig(name, fieldType, cellIdSource, DocValueFormat.GEOTILE, order(),
                 missingBucket(), script() != null);
         } else {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/BoundedCellValues.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/BoundedCellValues.java
new file mode 100644
index 0000000000000..52fddb34b0576
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/BoundedCellValues.java
@@ -0,0 +1,49 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.search.aggregations.bucket.geogrid;
+
+import org.elasticsearch.common.geo.GeoBoundingBox;
+import org.elasticsearch.index.fielddata.MultiGeoPointValues;
+
+/**
+ * Class representing {@link CellValues} whose values are filtered
+ * according to whether they are within the specified {@link GeoBoundingBox}.
+ *
+ * The specified bounding box is assumed to be bounded.
+ */
+class BoundedCellValues extends CellValues {
+
+    private final GeoBoundingBox geoBoundingBox;
+
+    protected BoundedCellValues(MultiGeoPointValues geoValues, int precision, CellIdSource.GeoPointLongEncoder encoder,
+                                GeoBoundingBox geoBoundingBox) {
+        super(geoValues, precision, encoder);
+        this.geoBoundingBox = geoBoundingBox;
+    }
+
+
+    @Override
+    int advanceValue(org.elasticsearch.common.geo.GeoPoint target, int valuesIdx) {
+        if (geoBoundingBox.pointInBounds(target.getLon(), target.getLat())) {
+            values[valuesIdx] = encoder.encode(target.getLon(), target.getLat(), precision);
+            return valuesIdx + 1;
+        }
+        return valuesIdx;
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/CellIdSource.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/CellIdSource.java
index 4ebb689c7c44f..84f963bbbd9ce 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/CellIdSource.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/CellIdSource.java
@@ -20,14 +20,12 @@
 
 import org.apache.lucene.index.LeafReaderContext;
 import org.apache.lucene.index.SortedNumericDocValues;
-import org.elasticsearch.index.fielddata.AbstractSortingNumericDocValues;
+import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.index.fielddata.MultiGeoPointValues;
 import org.elasticsearch.index.fielddata.SortedBinaryDocValues;
 import org.elasticsearch.index.fielddata.SortedNumericDoubleValues;
 import org.elasticsearch.search.aggregations.support.ValuesSource;
 
-import java.io.IOException;
-
 /**
  * Wrapper class to help convert {@link MultiGeoPointValues}
  * to numeric long values for bucketing.
@@ -36,11 +34,13 @@ public class CellIdSource extends ValuesSource.Numeric {
     private final ValuesSource.GeoPoint valuesSource;
     private final int precision;
     private final GeoPointLongEncoder encoder;
+    private final GeoBoundingBox geoBoundingBox;
 
-    public CellIdSource(GeoPoint valuesSource, int precision, GeoPointLongEncoder encoder) {
+    public CellIdSource(GeoPoint valuesSource,int precision, GeoBoundingBox geoBoundingBox, GeoPointLongEncoder encoder) {
         this.valuesSource = valuesSource;
         //different GeoPoints could map to the same or different hashing cells.
         this.precision = precision;
+        this.geoBoundingBox = geoBoundingBox;
         this.encoder = encoder;
     }
 
@@ -55,7 +55,10 @@ public boolean isFloatingPoint() {
 
     @Override
     public SortedNumericDocValues longValues(LeafReaderContext ctx) {
-        return new CellValues(valuesSource.geoPointValues(ctx), precision, encoder);
+        if (geoBoundingBox.isUnbounded()) {
+            return new UnboundedCellValues(valuesSource.geoPointValues(ctx), precision, encoder);
+        }
+        return new BoundedCellValues(valuesSource.geoPointValues(ctx), precision, encoder, geoBoundingBox);
     }
 
     @Override
@@ -77,30 +80,4 @@ public interface GeoPointLongEncoder {
         long encode(double lon, double lat, int precision);
     }
 
-    private static class CellValues extends AbstractSortingNumericDocValues {
-        private MultiGeoPointValues geoValues;
-        private int precision;
-        private GeoPointLongEncoder encoder;
-
-        protected CellValues(MultiGeoPointValues geoValues, int precision, GeoPointLongEncoder encoder) {
-            this.geoValues = geoValues;
-            this.precision = precision;
-            this.encoder = encoder;
-        }
-
-        @Override
-        public boolean advanceExact(int docId) throws IOException {
-            if (geoValues.advanceExact(docId)) {
-                resize(geoValues.docValueCount());
-                for (int i = 0; i < docValueCount(); ++i) {
-                    org.elasticsearch.common.geo.GeoPoint target = geoValues.nextValue();
-                    values[i] = encoder.encode(target.getLon(), target.getLat(), precision);
-                }
-                sort();
-                return true;
-            } else {
-                return false;
-            }
-        }
-    }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/CellValues.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/CellValues.java
new file mode 100644
index 0000000000000..5d428373ccd8f
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/CellValues.java
@@ -0,0 +1,68 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.search.aggregations.bucket.geogrid;
+
+import org.elasticsearch.index.fielddata.AbstractSortingNumericDocValues;
+import org.elasticsearch.index.fielddata.MultiGeoPointValues;
+
+import java.io.IOException;
+
+/**
+ * Class representing the long-encoded grid-cells belonging to
+ * the geo-doc-values. Class must encode the values and then
+ * sort them in order to account for the cells correctly.
+ */
+abstract class CellValues extends AbstractSortingNumericDocValues {
+    private MultiGeoPointValues geoValues;
+    protected int precision;
+    protected CellIdSource.GeoPointLongEncoder encoder;
+
+    protected CellValues(MultiGeoPointValues geoValues, int precision, CellIdSource.GeoPointLongEncoder encoder) {
+        this.geoValues = geoValues;
+        this.precision = precision;
+        this.encoder = encoder;
+    }
+
+    @Override
+    public boolean advanceExact(int docId) throws IOException {
+        if (geoValues.advanceExact(docId)) {
+            int docValueCount = geoValues.docValueCount();
+            resize(docValueCount);
+            int j = 0;
+            for (int i = 0; i < docValueCount; i++) {
+                j = advanceValue(geoValues.nextValue(), j);
+            }
+            resize(j);
+            sort();
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    /**
+     * Sets the appropriate long-encoded value for <code>target</code>
+     * in <code>values</code>.
+     *
+     * @param target    the geo-value to encode
+     * @param valuesIdx the index into <code>values</code> to set
+     * @return          valuesIdx + 1 if value was set, valuesIdx otherwise.
+     */
+    abstract int advanceValue(org.elasticsearch.common.geo.GeoPoint target, int valuesIdx);
+}
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregationBuilder.java
index e1c4221139202..233fd4c6885e8 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregationBuilder.java
@@ -20,7 +20,10 @@
 package org.elasticsearch.search.aggregations.bucket.geogrid;
 
 import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.Version;
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.geo.GeoBoundingBox;
+import org.elasticsearch.common.geo.GeoPoint;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ObjectParser;
@@ -53,6 +56,8 @@ public abstract class GeoGridAggregationBuilder extends ValuesSourceAggregationB
     protected int precision;
     protected int requiredSize;
     protected int shardSize;
+    private GeoBoundingBox geoBoundingBox = new GeoBoundingBox(new GeoPoint(Double.NaN, Double.NaN), new GeoPoint(Double.NaN, Double.NaN));
+
 
     @FunctionalInterface
     protected interface PrecisionParser {
@@ -66,6 +71,10 @@ public static ObjectParser<GeoGridAggregationBuilder, Void> createParser(String
             org.elasticsearch.common.xcontent.ObjectParser.ValueType.INT);
         parser.declareInt(GeoGridAggregationBuilder::size, FIELD_SIZE);
         parser.declareInt(GeoGridAggregationBuilder::shardSize, FIELD_SHARD_SIZE);
+        parser.declareField((p, builder, context) -> {
+                builder.setGeoBoundingBox(GeoBoundingBox.parseBoundingBox(p));
+            },
+            GeoBoundingBox.BOUNDS_FIELD, org.elasticsearch.common.xcontent.ObjectParser.ValueType.OBJECT);
         return parser;
     }
 
@@ -78,7 +87,7 @@ protected GeoGridAggregationBuilder(GeoGridAggregationBuilder clone, Builder fac
         this.precision = clone.precision;
         this.requiredSize = clone.requiredSize;
         this.shardSize = clone.shardSize;
-
+        this.geoBoundingBox = clone.geoBoundingBox;
     }
 
     /**
@@ -89,6 +98,9 @@ public GeoGridAggregationBuilder(StreamInput in) throws IOException {
         precision = in.readVInt();
         requiredSize = in.readVInt();
         shardSize = in.readVInt();
+        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+            geoBoundingBox = new GeoBoundingBox(in);
+        }
     }
 
     @Override
@@ -96,6 +108,9 @@ protected void innerWriteTo(StreamOutput out) throws IOException {
         out.writeVInt(precision);
         out.writeVInt(requiredSize);
         out.writeVInt(shardSize);
+        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+            geoBoundingBox.writeTo(out);
+        }
     }
 
     /**
@@ -110,7 +125,8 @@ protected void innerWriteTo(StreamOutput out) throws IOException {
      */
     protected abstract ValuesSourceAggregatorFactory<ValuesSource.GeoPoint> createFactory(
         String name, ValuesSourceConfig<ValuesSource.GeoPoint> config, int precision, int requiredSize, int shardSize,
-        QueryShardContext queryShardContext, AggregatorFactory parent, Builder subFactoriesBuilder, Map<String, Object> metaData
+        GeoBoundingBox geoBoundingBox, QueryShardContext queryShardContext, AggregatorFactory parent,
+        Builder subFactoriesBuilder, Map<String, Object> metaData
     ) throws IOException;
 
     public int precision() {
@@ -143,6 +159,16 @@ public int shardSize() {
         return shardSize;
     }
 
+    public GeoGridAggregationBuilder setGeoBoundingBox(GeoBoundingBox geoBoundingBox) {
+        this.geoBoundingBox = geoBoundingBox;
+        // no validation done here, similar to geo_bounding_box query behavior.
+        return this;
+    }
+
+    public GeoBoundingBox geoBoundingBox() {
+        return geoBoundingBox;
+    }
+
     @Override
     protected ValuesSourceAggregatorFactory<ValuesSource.GeoPoint> innerBuild(QueryShardContext queryShardContext,
                                                                                 ValuesSourceConfig<ValuesSource.GeoPoint> config,
@@ -166,7 +192,7 @@ protected ValuesSourceAggregatorFactory<ValuesSource.GeoPoint> innerBuild(QueryS
         if (shardSize < requiredSize) {
             shardSize = requiredSize;
         }
-        return createFactory(name, config, precision, requiredSize, shardSize, queryShardContext, parent,
+        return createFactory(name, config, precision, requiredSize, shardSize, geoBoundingBox, queryShardContext, parent,
                 subFactoriesBuilder, metaData);
     }
 
@@ -177,6 +203,9 @@ protected XContentBuilder doXContentBody(XContentBuilder builder, Params params)
         if (shardSize > -1) {
             builder.field(FIELD_SHARD_SIZE.getPreferredName(), shardSize);
         }
+        if (geoBoundingBox.isUnbounded() == false) {
+            geoBoundingBox.toXContent(builder, params);
+        }
         return builder;
     }
 
@@ -188,11 +217,12 @@ public boolean equals(Object obj) {
         GeoGridAggregationBuilder other = (GeoGridAggregationBuilder) obj;
         return precision == other.precision
             && requiredSize == other.requiredSize
-            && shardSize == other.shardSize;
+            && shardSize == other.shardSize
+            && Objects.equals(geoBoundingBox, other.geoBoundingBox);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(super.hashCode(), precision, requiredSize, shardSize);
+        return Objects.hash(super.hashCode(), precision, requiredSize, shardSize, geoBoundingBox);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregator.java
index c91f763b603c0..c77578f2570c7 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregator.java
@@ -48,8 +48,8 @@ public abstract class GeoGridAggregator<T extends InternalGeoGrid> extends Bucke
     protected final LongHash bucketOrds;
 
     GeoGridAggregator(String name, AggregatorFactories factories, CellIdSource valuesSource,
-                      int requiredSize, int shardSize, SearchContext aggregationContext, Aggregator parent,
-                      List<PipelineAggregator> pipelineAggregators, Map<String, Object> metaData) throws IOException {
+                      int requiredSize, int shardSize, SearchContext aggregationContext,
+                      Aggregator parent, List<PipelineAggregator> pipelineAggregators, Map<String, Object> metaData) throws IOException {
         super(name, factories, aggregationContext, parent, pipelineAggregators, metaData);
         this.valuesSource = valuesSource;
         this.requiredSize = requiredSize;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregationBuilder.java
index d58beeb781c25..acc9cde113164 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregationBuilder.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.search.aggregations.bucket.geogrid;
 
+import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.common.geo.GeoUtils;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.xcontent.ObjectParser;
@@ -60,11 +61,12 @@ public GeoGridAggregationBuilder precision(int precision) {
 
     @Override
     protected ValuesSourceAggregatorFactory<ValuesSource.GeoPoint> createFactory(
-        String name, ValuesSourceConfig<ValuesSource.GeoPoint> config, int precision, int requiredSize, int shardSize,
-        QueryShardContext queryShardContext, AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder,
-        Map<String, Object> metaData) throws IOException {
-        return new GeoHashGridAggregatorFactory(name, config, precision, requiredSize, shardSize, queryShardContext, parent,
-            subFactoriesBuilder, metaData);
+            String name, ValuesSourceConfig<ValuesSource.GeoPoint> config, int precision, int requiredSize, int shardSize,
+            GeoBoundingBox geoBoundingBox, QueryShardContext queryShardContext,
+            AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder,
+            Map<String, Object> metaData) throws IOException {
+        return new GeoHashGridAggregatorFactory(name, config, precision, requiredSize, shardSize, geoBoundingBox,
+            queryShardContext, parent, subFactoriesBuilder, metaData);
     }
 
     private GeoHashGridAggregationBuilder(GeoHashGridAggregationBuilder clone, AggregatorFactories.Builder factoriesBuilder,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregator.java
index 54d1e2e940649..1ad59ccc45100 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregator.java
@@ -34,9 +34,11 @@
 public class GeoHashGridAggregator extends GeoGridAggregator<InternalGeoHashGrid> {
 
     GeoHashGridAggregator(String name, AggregatorFactories factories, CellIdSource valuesSource,
-                          int requiredSize, int shardSize, SearchContext aggregationContext, Aggregator parent,
-                          List<PipelineAggregator> pipelineAggregators, Map<String, Object> metaData) throws IOException {
-        super(name, factories, valuesSource, requiredSize, shardSize, aggregationContext, parent, pipelineAggregators, metaData);
+                          int requiredSize, int shardSize, SearchContext aggregationContext,
+                          Aggregator parent, List<PipelineAggregator> pipelineAggregators,
+                          Map<String, Object> metaData) throws IOException {
+        super(name, factories, valuesSource, requiredSize, shardSize, aggregationContext, parent,
+            pipelineAggregators, metaData);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregatorFactory.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregatorFactory.java
index a049a07f13dbe..2d7087a693bfa 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregatorFactory.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridAggregatorFactory.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.search.aggregations.bucket.geogrid;
 
+import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.geometry.utils.Geohash;
 import org.elasticsearch.index.query.QueryShardContext;
 import org.elasticsearch.search.aggregations.Aggregator;
@@ -28,7 +29,6 @@
 import org.elasticsearch.search.aggregations.NonCollectingAggregator;
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
 import org.elasticsearch.search.aggregations.support.ValuesSource;
-import org.elasticsearch.search.aggregations.support.ValuesSource.GeoPoint;
 import org.elasticsearch.search.aggregations.support.ValuesSourceAggregatorFactory;
 import org.elasticsearch.search.aggregations.support.ValuesSourceConfig;
 import org.elasticsearch.search.internal.SearchContext;
@@ -43,14 +43,17 @@ public class GeoHashGridAggregatorFactory extends ValuesSourceAggregatorFactory<
     private final int precision;
     private final int requiredSize;
     private final int shardSize;
+    private final GeoBoundingBox geoBoundingBox;
 
-    GeoHashGridAggregatorFactory(String name, ValuesSourceConfig<GeoPoint> config, int precision, int requiredSize,
-                                 int shardSize, QueryShardContext queryShardContext, AggregatorFactory parent,
-                                 AggregatorFactories.Builder subFactoriesBuilder, Map<String, Object> metaData) throws IOException {
+    GeoHashGridAggregatorFactory(String name, ValuesSourceConfig<ValuesSource.GeoPoint> config, int precision, int requiredSize,
+                                 int shardSize, GeoBoundingBox geoBoundingBox, QueryShardContext queryShardContext,
+                                 AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder,
+                                 Map<String, Object> metaData) throws IOException {
         super(name, config, queryShardContext, parent, subFactoriesBuilder, metaData);
         this.precision = precision;
         this.requiredSize = requiredSize;
         this.shardSize = shardSize;
+        this.geoBoundingBox = geoBoundingBox;
     }
 
     @Override
@@ -69,7 +72,7 @@ public InternalAggregation buildEmptyAggregation() {
     }
 
     @Override
-    protected Aggregator doCreateInternal(final GeoPoint valuesSource,
+    protected Aggregator doCreateInternal(final ValuesSource.GeoPoint valuesSource,
                                             SearchContext searchContext,
                                             Aggregator parent,
                                             boolean collectsFromSingleBucket,
@@ -78,8 +81,8 @@ protected Aggregator doCreateInternal(final GeoPoint valuesSource,
         if (collectsFromSingleBucket == false) {
             return asMultiBucketAggregator(this, searchContext, parent);
         }
-        CellIdSource cellIdSource = new CellIdSource(valuesSource, precision, Geohash::longEncode);
-        return new GeoHashGridAggregator(name, factories, cellIdSource, requiredSize, shardSize, searchContext, parent,
-                pipelineAggregators, metaData);
+        CellIdSource cellIdSource = new CellIdSource(valuesSource, precision, geoBoundingBox, Geohash::longEncode);
+        return new GeoHashGridAggregator(name, factories, cellIdSource, requiredSize, shardSize,
+            searchContext, parent, pipelineAggregators, metaData);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregationBuilder.java
index b3d9888781362..595c6cab6e718 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregationBuilder.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.search.aggregations.bucket.geogrid;
 
+import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.XContentParser;
@@ -59,12 +60,11 @@ public GeoGridAggregationBuilder precision(int precision) {
 
     @Override
     protected ValuesSourceAggregatorFactory<ValuesSource.GeoPoint> createFactory(
-        String name, ValuesSourceConfig<ValuesSource.GeoPoint> config, int precision, int requiredSize, int shardSize,
-        QueryShardContext queryShardContext, AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder,
-        Map<String, Object> metaData
-    ) throws IOException {
-        return new GeoTileGridAggregatorFactory(name, config, precision, requiredSize, shardSize, queryShardContext, parent,
-            subFactoriesBuilder, metaData);
+            String name, ValuesSourceConfig<ValuesSource.GeoPoint> config, int precision, int requiredSize, int shardSize,
+            GeoBoundingBox geoBoundingBox, QueryShardContext queryShardContext, AggregatorFactory parent,
+            AggregatorFactories.Builder subFactoriesBuilder, Map<String, Object> metaData ) throws IOException {
+        return new GeoTileGridAggregatorFactory(name, config, precision, requiredSize, shardSize, geoBoundingBox,
+            queryShardContext, parent, subFactoriesBuilder, metaData);
     }
 
     private GeoTileGridAggregationBuilder(GeoTileGridAggregationBuilder clone, AggregatorFactories.Builder factoriesBuilder,
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregator.java
index d2ff5ed82513c..350761aa84050 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregator.java
@@ -35,9 +35,11 @@
 public class GeoTileGridAggregator extends GeoGridAggregator<InternalGeoTileGrid> {
 
     GeoTileGridAggregator(String name, AggregatorFactories factories, CellIdSource valuesSource,
-                          int requiredSize, int shardSize, SearchContext aggregationContext, Aggregator parent,
-                          List<PipelineAggregator> pipelineAggregators, Map<String, Object> metaData) throws IOException {
-        super(name, factories, valuesSource, requiredSize, shardSize, aggregationContext, parent, pipelineAggregators, metaData);
+                          int requiredSize, int shardSize, SearchContext aggregationContext,
+                          Aggregator parent, List<PipelineAggregator> pipelineAggregators,
+                          Map<String, Object> metaData) throws IOException {
+        super(name, factories, valuesSource, requiredSize, shardSize, aggregationContext, parent,
+            pipelineAggregators, metaData);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregatorFactory.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregatorFactory.java
index 8380a4172c9c5..0f59c9a71ea40 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregatorFactory.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregatorFactory.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.search.aggregations.bucket.geogrid;
 
+import org.elasticsearch.common.geo.GeoBoundingBox;
 import org.elasticsearch.index.query.QueryShardContext;
 import org.elasticsearch.search.aggregations.Aggregator;
 import org.elasticsearch.search.aggregations.AggregatorFactories;
@@ -27,7 +28,6 @@
 import org.elasticsearch.search.aggregations.NonCollectingAggregator;
 import org.elasticsearch.search.aggregations.pipeline.PipelineAggregator;
 import org.elasticsearch.search.aggregations.support.ValuesSource;
-import org.elasticsearch.search.aggregations.support.ValuesSource.GeoPoint;
 import org.elasticsearch.search.aggregations.support.ValuesSourceAggregatorFactory;
 import org.elasticsearch.search.aggregations.support.ValuesSourceConfig;
 import org.elasticsearch.search.internal.SearchContext;
@@ -42,14 +42,17 @@ public class GeoTileGridAggregatorFactory extends ValuesSourceAggregatorFactory<
     private final int precision;
     private final int requiredSize;
     private final int shardSize;
+    private final GeoBoundingBox geoBoundingBox;
 
-    GeoTileGridAggregatorFactory(String name, ValuesSourceConfig<GeoPoint> config, int precision, int requiredSize,
-                                 int shardSize, QueryShardContext queryShardContext, AggregatorFactory parent,
-                                 AggregatorFactories.Builder subFactoriesBuilder, Map<String, Object> metaData) throws IOException {
+    GeoTileGridAggregatorFactory(String name, ValuesSourceConfig<ValuesSource.GeoPoint> config, int precision, int requiredSize,
+                                 int shardSize, GeoBoundingBox geoBoundingBox, QueryShardContext queryShardContext,
+                                 AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder,
+                                 Map<String, Object> metaData) throws IOException {
         super(name, config, queryShardContext, parent, subFactoriesBuilder, metaData);
         this.precision = precision;
         this.requiredSize = requiredSize;
         this.shardSize = shardSize;
+        this.geoBoundingBox = geoBoundingBox;
     }
 
     @Override
@@ -68,7 +71,7 @@ public InternalAggregation buildEmptyAggregation() {
     }
 
     @Override
-    protected Aggregator doCreateInternal(final GeoPoint valuesSource,
+    protected Aggregator doCreateInternal(final ValuesSource.GeoPoint valuesSource,
                                             SearchContext searchContext,
                                             Aggregator parent,
                                             boolean collectsFromSingleBucket,
@@ -77,8 +80,8 @@ protected Aggregator doCreateInternal(final GeoPoint valuesSource,
         if (collectsFromSingleBucket == false) {
             return asMultiBucketAggregator(this, searchContext, parent);
         }
-        CellIdSource cellIdSource = new CellIdSource(valuesSource, precision, GeoTileUtils::longEncode);
-        return new GeoTileGridAggregator(name, factories, cellIdSource, requiredSize, shardSize, searchContext, parent,
-                pipelineAggregators, metaData);
+        CellIdSource cellIdSource = new CellIdSource(valuesSource, precision, geoBoundingBox, GeoTileUtils::longEncode);
+        return new GeoTileGridAggregator(name, factories, cellIdSource, requiredSize, shardSize,
+            searchContext, parent, pipelineAggregators, metaData);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileUtils.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileUtils.java
index 19381e87fedb6..03f821296f2a6 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileUtils.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileUtils.java
@@ -51,7 +51,7 @@ private GeoTileUtils() {}
      * Another consideration is that index optimizes lat/lng storage, loosing some precision.
      * E.g. hash lng=140.74779717298918D lat=45.61884022447444D == "18/233561/93659", but shown as "18/233561/93658"
      */
-    static final int MAX_ZOOM = 29;
+    public static final int MAX_ZOOM = 29;
 
     /**
      * Bit position of the zoom value within hash - zoom is stored in the most significant 6 bits of a long number.
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/UnboundedCellValues.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/UnboundedCellValues.java
new file mode 100644
index 0000000000000..e64061eae5ae5
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/UnboundedCellValues.java
@@ -0,0 +1,39 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.search.aggregations.bucket.geogrid;
+
+import org.elasticsearch.common.geo.GeoBoundingBox;
+import org.elasticsearch.index.fielddata.MultiGeoPointValues;
+
+/**
+ * Class representing {@link CellValues} that are unbounded by any
+ * {@link GeoBoundingBox}.
+ */
+class UnboundedCellValues extends CellValues {
+
+    UnboundedCellValues(MultiGeoPointValues geoValues, int precision, CellIdSource.GeoPointLongEncoder encoder) {
+        super(geoValues, precision, encoder);
+    }
+
+    @Override
+    int advanceValue(org.elasticsearch.common.geo.GeoPoint target, int valuesIdx) {
+        values[valuesIdx] = encoder.encode(target.getLon(), target.getLat(), precision);
+        return valuesIdx + 1;
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/common/geo/GeoBoundingBoxTests.java b/server/src/test/java/org/elasticsearch/common/geo/GeoBoundingBoxTests.java
index ef705fa27c42c..309302214f462 100644
--- a/server/src/test/java/org/elasticsearch/common/geo/GeoBoundingBoxTests.java
+++ b/server/src/test/java/org/elasticsearch/common/geo/GeoBoundingBoxTests.java
@@ -19,11 +19,13 @@
 
 package org.elasticsearch.common.geo;
 
+import org.apache.lucene.geo.GeoEncodingUtils;
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.geo.GeometryTestUtils;
+import org.elasticsearch.geometry.Rectangle;
 import org.elasticsearch.test.ESTestCase;
 
 import java.io.IOException;
@@ -133,6 +135,35 @@ public void testNullTopBottomLeftRight() throws Exception {
         }
     }
 
+    public void testPointInBounds() {
+        for (int iter = 0; iter < 1000; iter++) {
+            GeoBoundingBox geoBoundingBox = randomBBox();
+            GeoBoundingBox bbox = new GeoBoundingBox(
+                new GeoPoint(quantizeLat(geoBoundingBox.top()), quantizeLon(geoBoundingBox.left())),
+                    new GeoPoint(quantizeLat(geoBoundingBox.bottom()), quantizeLon(geoBoundingBox.right())));
+            if (bbox.left() > bbox.right()) {
+                double lonWithin = randomBoolean() ?
+                    randomDoubleBetween(bbox.left(), 180.0, true)
+                    : randomDoubleBetween(-180.0, bbox.right(), true);
+                double latWithin = randomDoubleBetween(bbox.bottom(), bbox.top(), true);
+                double lonOutside = randomDoubleBetween(bbox.left(), bbox.right(), true);
+                double latOutside = randomBoolean() ? randomDoubleBetween(Math.max(bbox.top(), bbox.bottom()), 90, false)
+                    : randomDoubleBetween(-90, Math.min(bbox.bottom(), bbox.top()), false);
+
+                assertTrue(bbox.pointInBounds(lonWithin, latWithin));
+                    assertFalse(bbox.pointInBounds(lonOutside, latOutside));
+            } else {
+                double lonWithin = randomDoubleBetween(bbox.left(), bbox.right(), true);
+                double latWithin = randomDoubleBetween(bbox.bottom(), bbox.top(), true);
+                double lonOutside = GeoUtils.normalizeLon(randomDoubleBetween(bbox.right(), 180, false));
+                double latOutside = GeoUtils.normalizeLat(randomDoubleBetween(bbox.top(), 90, false));
+
+                assertTrue(bbox.pointInBounds(lonWithin, latWithin));
+                assertFalse(bbox.pointInBounds(lonOutside, latOutside));
+            }
+        }
+    }
+
     private void assertBBox(GeoBoundingBox expected, XContentBuilder builder) throws IOException {
         try (XContentParser parser = createParser(builder)) {
             parser.nextToken();
@@ -140,10 +171,17 @@ private void assertBBox(GeoBoundingBox expected, XContentBuilder builder) throws
         }
     }
 
-    private GeoBoundingBox randomBBox() {
-        double topLat = GeometryTestUtils.randomLat();
-        double bottomLat = randomDoubleBetween(GeoUtils.MIN_LAT, topLat, true);
-        return new GeoBoundingBox(new GeoPoint(topLat, GeometryTestUtils.randomLon()),
-            new GeoPoint(bottomLat, GeometryTestUtils.randomLon()));
+    public static GeoBoundingBox randomBBox() {
+        Rectangle rectangle = GeometryTestUtils.randomRectangle();
+        return new GeoBoundingBox(new GeoPoint(rectangle.getMaxLat(), rectangle.getMinLon()),
+            new GeoPoint(rectangle.getMinLat(), rectangle.getMaxLon()));
+    }
+
+    private static double quantizeLat(double lat) {
+        return GeoEncodingUtils.decodeLatitude(GeoEncodingUtils.encodeLatitude(lat));
+    }
+
+    private static double quantizeLon(double lon) {
+        return GeoEncodingUtils.decodeLongitude(GeoEncodingUtils.encodeLongitude(lon));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridTests.java
index e414b86403a09..883810b25d76b 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridTests.java
@@ -19,9 +19,22 @@
 
 package org.elasticsearch.search.aggregations.bucket;
 
+import org.elasticsearch.Version;
+import org.elasticsearch.common.geo.GeoBoundingBox;
+import org.elasticsearch.common.geo.GeoBoundingBoxTests;
+import org.elasticsearch.common.geo.GeoPoint;
+import org.elasticsearch.common.io.stream.BytesStreamOutput;
+import org.elasticsearch.common.io.stream.NamedWriteableAwareStreamInput;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.search.aggregations.BaseAggregationTestCase;
 import org.elasticsearch.search.aggregations.bucket.geogrid.GeoGridAggregationBuilder;
 import org.elasticsearch.search.aggregations.bucket.geogrid.GeoHashGridAggregationBuilder;
+import org.elasticsearch.test.VersionUtils;
+
+import java.util.Collections;
+
+import static org.hamcrest.Matchers.equalTo;
 
 public class GeoHashGridTests extends BaseAggregationTestCase<GeoGridAggregationBuilder> {
 
@@ -39,7 +52,25 @@ protected GeoHashGridAggregationBuilder createTestAggregatorBuilder() {
         if (randomBoolean()) {
             factory.shardSize(randomIntBetween(1, Integer.MAX_VALUE));
         }
+        if (randomBoolean()) {
+            factory.setGeoBoundingBox(GeoBoundingBoxTests.randomBBox());
+        }
         return factory;
     }
 
+    public void testSerializationPreBounds() throws Exception {
+        Version noBoundsSupportVersion = VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0);
+        GeoHashGridAggregationBuilder builder = createTestAggregatorBuilder();
+        try (BytesStreamOutput output = new BytesStreamOutput()) {
+            output.setVersion(Version.V_8_0_0);
+            builder.writeTo(output);
+            try (StreamInput in = new NamedWriteableAwareStreamInput(output.bytes().streamInput(),
+                new NamedWriteableRegistry(Collections.emptyList()))) {
+                in.setVersion(noBoundsSupportVersion);
+                GeoHashGridAggregationBuilder readBuilder = new GeoHashGridAggregationBuilder(in);
+                assertThat(readBuilder.geoBoundingBox(), equalTo(new GeoBoundingBox(
+                    new GeoPoint(Double.NaN, Double.NaN), new GeoPoint(Double.NaN, Double.NaN))));
+            }
+        }
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoTileGridTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoTileGridTests.java
new file mode 100644
index 0000000000000..33631d39f720d
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoTileGridTests.java
@@ -0,0 +1,76 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.search.aggregations.bucket;
+
+import org.elasticsearch.Version;
+import org.elasticsearch.common.geo.GeoBoundingBox;
+import org.elasticsearch.common.geo.GeoBoundingBoxTests;
+import org.elasticsearch.common.geo.GeoPoint;
+import org.elasticsearch.common.io.stream.BytesStreamOutput;
+import org.elasticsearch.common.io.stream.NamedWriteableAwareStreamInput;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.search.aggregations.BaseAggregationTestCase;
+import org.elasticsearch.search.aggregations.bucket.geogrid.GeoGridAggregationBuilder;
+import org.elasticsearch.search.aggregations.bucket.geogrid.GeoTileGridAggregationBuilder;
+import org.elasticsearch.search.aggregations.bucket.geogrid.GeoTileUtils;
+import org.elasticsearch.test.VersionUtils;
+
+import java.util.Collections;
+
+import static org.hamcrest.Matchers.equalTo;
+
+public class GeoTileGridTests extends BaseAggregationTestCase<GeoGridAggregationBuilder> {
+
+    @Override
+    protected GeoTileGridAggregationBuilder createTestAggregatorBuilder() {
+        String name = randomAlphaOfLengthBetween(3, 20);
+        GeoTileGridAggregationBuilder factory = new GeoTileGridAggregationBuilder(name);
+        if (randomBoolean()) {
+            factory.precision(randomIntBetween(0, GeoTileUtils.MAX_ZOOM));
+        }
+        if (randomBoolean()) {
+            factory.size(randomIntBetween(1, Integer.MAX_VALUE));
+        }
+        if (randomBoolean()) {
+            factory.shardSize(randomIntBetween(1, Integer.MAX_VALUE));
+        }
+        if (randomBoolean()) {
+            factory.setGeoBoundingBox(GeoBoundingBoxTests.randomBBox());
+        }
+        return factory;
+    }
+
+    public void testSerializationPreBounds() throws Exception {
+        Version noBoundsSupportVersion = VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0);
+        GeoTileGridAggregationBuilder builder = createTestAggregatorBuilder();
+        try (BytesStreamOutput output = new BytesStreamOutput()) {
+            output.setVersion(Version.V_8_0_0);
+            builder.writeTo(output);
+            try (StreamInput in = new NamedWriteableAwareStreamInput(output.bytes().streamInput(),
+                new NamedWriteableRegistry(Collections.emptyList()))) {
+                in.setVersion(noBoundsSupportVersion);
+                GeoTileGridAggregationBuilder readBuilder = new GeoTileGridAggregationBuilder(in);
+                assertThat(readBuilder.geoBoundingBox(), equalTo(new GeoBoundingBox(
+                    new GeoPoint(Double.NaN, Double.NaN), new GeoPoint(Double.NaN, Double.NaN))));
+            }
+        }
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilderTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilderTests.java
index c78a55b253297..c36ff50b7a36d 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/CompositeAggregationBuilderTests.java
@@ -19,8 +19,10 @@
 
 package org.elasticsearch.search.aggregations.bucket.composite;
 
+import org.elasticsearch.common.geo.GeoBoundingBoxTests;
 import org.elasticsearch.script.Script;
 import org.elasticsearch.search.aggregations.BaseAggregationTestCase;
+import org.elasticsearch.search.aggregations.bucket.geogrid.GeoTileUtils;
 import org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval;
 import org.elasticsearch.search.sort.SortOrder;
 
@@ -54,7 +56,10 @@ private DateHistogramValuesSourceBuilder randomDateHistogramSourceBuilder() {
     private GeoTileGridValuesSourceBuilder randomGeoTileGridValuesSourceBuilder() {
         GeoTileGridValuesSourceBuilder geoTile = new GeoTileGridValuesSourceBuilder(randomAlphaOfLengthBetween(5, 10));
         if (randomBoolean()) {
-            geoTile.precision(randomIntBetween(1, 12));
+            geoTile.precision(randomIntBetween(0, GeoTileUtils.MAX_ZOOM));
+        }
+        if (randomBoolean()) {
+            geoTile.geoBoundingBox(GeoBoundingBoxTests.randomBBox());
         }
         return geoTile;
     }
@@ -90,9 +95,11 @@ private HistogramValuesSourceBuilder randomHistogramSourceBuilder() {
     @Override
     protected CompositeAggregationBuilder createTestAggregatorBuilder() {
         int numSources = randomIntBetween(1, 10);
+        numSources = 1;
         List<CompositeValuesSourceBuilder<?>> sources = new ArrayList<>();
         for (int i = 0; i < numSources; i++) {
             int type = randomIntBetween(0, 3);
+            type = 3;
             switch (type) {
                 case 0:
                     sources.add(randomTermsSourceBuilder());
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilderTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilderTests.java
index 6f9e0f697da25..7817a236d6680 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilderTests.java
@@ -19,7 +19,21 @@
 
 package org.elasticsearch.search.aggregations.bucket.composite;
 
+import org.elasticsearch.Version;
+import org.elasticsearch.common.geo.GeoBoundingBox;
+import org.elasticsearch.common.geo.GeoBoundingBoxTests;
+import org.elasticsearch.common.geo.GeoPoint;
+import org.elasticsearch.common.io.stream.BytesStreamOutput;
+import org.elasticsearch.common.io.stream.NamedWriteableAwareStreamInput;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.VersionUtils;
+
+import java.io.IOException;
+import java.util.Collections;
+
+import static org.hamcrest.Matchers.equalTo;
 
 public class GeoTileGridValuesSourceBuilderTests extends ESTestCase {
 
@@ -28,4 +42,22 @@ public void testSetFormat() {
         expectThrows(IllegalArgumentException.class, () -> builder.format("format"));
     }
 
+    public void testBWCBounds() throws IOException {
+        Version noBoundsSupportVersion = VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0);
+        GeoTileGridValuesSourceBuilder builder = new GeoTileGridValuesSourceBuilder("name");
+        if (randomBoolean()) {
+            builder.geoBoundingBox(GeoBoundingBoxTests.randomBBox());
+        }
+        try (BytesStreamOutput output = new BytesStreamOutput()) {
+            output.setVersion(Version.V_8_0_0);
+            builder.writeTo(output);
+            try (StreamInput in = new NamedWriteableAwareStreamInput(output.bytes().streamInput(),
+                new NamedWriteableRegistry(Collections.emptyList()))) {
+                in.setVersion(noBoundsSupportVersion);
+                GeoTileGridValuesSourceBuilder readBuilder = new GeoTileGridValuesSourceBuilder(in);
+                assertThat(readBuilder.geoBoundingBox(), equalTo(new GeoBoundingBox(
+                    new GeoPoint(Double.NaN, Double.NaN), new GeoPoint(Double.NaN, Double.NaN))));
+            }
+        }
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
index 047903bc86100..085be3855ac9f 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
@@ -28,6 +28,9 @@
 import org.apache.lucene.search.Query;
 import org.apache.lucene.store.Directory;
 import org.elasticsearch.common.CheckedConsumer;
+import org.elasticsearch.common.geo.GeoBoundingBox;
+import org.elasticsearch.common.geo.GeoBoundingBoxTests;
+import org.elasticsearch.common.geo.GeoUtils;
 import org.elasticsearch.index.mapper.GeoPointFieldMapper;
 import org.elasticsearch.index.mapper.MappedFieldType;
 import org.elasticsearch.search.aggregations.Aggregator;
@@ -44,6 +47,8 @@
 import java.util.Set;
 import java.util.function.Consumer;
 
+import static org.hamcrest.Matchers.equalTo;
+
 public abstract class GeoGridAggregatorTestCase<T extends InternalGeoGridBucket> extends AggregatorTestCase {
 
     private static final String FIELD_NAME = "location";
@@ -64,18 +69,18 @@ public abstract class GeoGridAggregatorTestCase<T extends InternalGeoGridBucket>
     protected abstract GeoGridAggregationBuilder createBuilder(String name);
 
     public void testNoDocs() throws IOException {
-        testCase(new MatchAllDocsQuery(), FIELD_NAME, randomPrecision(), iw -> {
-            // Intentionally not writing any docs
-        }, geoGrid -> {
+        testCase(new MatchAllDocsQuery(), FIELD_NAME, randomPrecision(), null, geoGrid -> {
             assertEquals(0, geoGrid.getBuckets().size());
+        }, iw -> {
+            // Intentionally not writing any docs
         });
     }
 
     public void testFieldMissing() throws IOException {
-        testCase(new MatchAllDocsQuery(), "wrong_field", randomPrecision(), iw -> {
-            iw.addDocument(Collections.singleton(new LatLonDocValuesField(FIELD_NAME, 10D, 10D)));
-        }, geoGrid -> {
+        testCase(new MatchAllDocsQuery(), "wrong_field", randomPrecision(), null, geoGrid -> {
             assertEquals(0, geoGrid.getBuckets().size());
+        }, iw -> {
+            iw.addDocument(Collections.singleton(new LatLonDocValuesField(FIELD_NAME, 10D, 10D)));
         });
     }
 
@@ -83,7 +88,13 @@ public void testWithSeveralDocs() throws IOException {
         int precision = randomPrecision();
         int numPoints = randomIntBetween(8, 128);
         Map<String, Integer> expectedCountPerGeoHash = new HashMap<>();
-        testCase(new MatchAllDocsQuery(), FIELD_NAME, precision, iw -> {
+        testCase(new MatchAllDocsQuery(), FIELD_NAME, precision, null, geoHashGrid -> {
+            assertEquals(expectedCountPerGeoHash.size(), geoHashGrid.getBuckets().size());
+            for (GeoGrid.Bucket bucket : geoHashGrid.getBuckets()) {
+                assertEquals((long) expectedCountPerGeoHash.get(bucket.getKeyAsString()), bucket.getDocCount());
+            }
+            assertTrue(AggregationInspectionHelper.hasValue(geoHashGrid));
+        }, iw -> {
             List<LatLonDocValuesField> points = new ArrayList<>();
             Set<String> distinctHashesPerDoc = new HashSet<>();
             for (int pointId = 0; pointId < numPoints; pointId++) {
@@ -112,17 +123,71 @@ public void testWithSeveralDocs() throws IOException {
             if (points.size() != 0) {
                 iw.addDocument(points);
             }
-        }, geoHashGrid -> {
-            assertEquals(expectedCountPerGeoHash.size(), geoHashGrid.getBuckets().size());
-            for (GeoGrid.Bucket bucket : geoHashGrid.getBuckets()) {
-                assertEquals((long) expectedCountPerGeoHash.get(bucket.getKeyAsString()), bucket.getDocCount());
+        });
+    }
+
+    public void testBounds() throws IOException {
+        final int numDocs = randomIntBetween(64, 256);
+        final GeoGridAggregationBuilder builder = createBuilder("_name");
+
+        expectThrows(IllegalArgumentException.class, () -> builder.precision(-1));
+        expectThrows(IllegalArgumentException.class, () -> builder.precision(30));
+
+        GeoBoundingBox bbox = GeoBoundingBoxTests.randomBBox();
+
+        int in = 0, out = 0;
+        List<LatLonDocValuesField> docs = new ArrayList<>();
+        while (in + out < numDocs) {
+            if (bbox.left() > bbox.right()) {
+                if (randomBoolean()) {
+                    double lonWithin = randomBoolean() ?
+                        randomDoubleBetween(bbox.left(), 180.0, true)
+                        : randomDoubleBetween(-180.0, bbox.right(), true);
+                    double latWithin = randomDoubleBetween(bbox.bottom(), bbox.top(), true);
+                    in++;
+                    docs.add(new LatLonDocValuesField(FIELD_NAME, latWithin, lonWithin));
+                } else {
+                    double lonOutside = randomDoubleBetween(bbox.left(), bbox.right(), true);
+                    double latOutside = randomDoubleBetween(bbox.top(), -90, false);
+                    out++;
+                    docs.add(new LatLonDocValuesField(FIELD_NAME, latOutside, lonOutside));
+                }
+            } else {
+                if (randomBoolean()) {
+                    double lonWithin = randomDoubleBetween(bbox.left(), bbox.right(), true);
+                    double latWithin = randomDoubleBetween(bbox.bottom(), bbox.top(), true);
+                    in++;
+                    docs.add(new LatLonDocValuesField(FIELD_NAME, latWithin, lonWithin));
+                } else {
+                    double lonOutside = GeoUtils.normalizeLon(randomDoubleBetween(bbox.right(), 180.001, false));
+                    double latOutside = GeoUtils.normalizeLat(randomDoubleBetween(bbox.top(), 90.001, false));
+                    out++;
+                    docs.add(new LatLonDocValuesField(FIELD_NAME, latOutside, lonOutside));
+                }
+            }
+
+        }
+
+        final long numDocsInBucket = in;
+        final int precision = randomPrecision();
+
+        testCase(new MatchAllDocsQuery(), FIELD_NAME, precision, bbox, geoGrid -> {
+            assertTrue(AggregationInspectionHelper.hasValue(geoGrid));
+            long docCount = 0;
+            for (int i = 0; i < geoGrid.getBuckets().size(); i++) {
+                docCount += geoGrid.getBuckets().get(i).getDocCount();
+            }
+            assertThat(docCount, equalTo(numDocsInBucket));
+        }, iw -> {
+            for (LatLonDocValuesField docField : docs) {
+                iw.addDocument(Collections.singletonList(docField));
             }
-            assertTrue(AggregationInspectionHelper.hasValue(geoHashGrid));
         });
     }
 
-    private void testCase(Query query, String field, int precision, CheckedConsumer<RandomIndexWriter, IOException> buildIndex,
-                          Consumer<InternalGeoGrid<T>> verify) throws IOException {
+    private void testCase(Query query, String field, int precision, GeoBoundingBox geoBoundingBox,
+                          Consumer<InternalGeoGrid<T>> verify,
+                          CheckedConsumer<RandomIndexWriter, IOException> buildIndex) throws IOException {
         Directory directory = newDirectory();
         RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
         buildIndex.accept(indexWriter);
@@ -133,6 +198,11 @@ private void testCase(Query query, String field, int precision, CheckedConsumer<
 
         GeoGridAggregationBuilder aggregationBuilder = createBuilder("_name").field(field);
         aggregationBuilder.precision(precision);
+        if (geoBoundingBox != null) {
+            aggregationBuilder.setGeoBoundingBox(geoBoundingBox);
+            assertThat(aggregationBuilder.geoBoundingBox(), equalTo(geoBoundingBox));
+        }
+
         MappedFieldType fieldType = new GeoPointFieldMapper.GeoPointFieldType();
         fieldType.setHasDocValues(true);
         fieldType.setName(FIELD_NAME);
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridParserTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridParserTests.java
index 824a069203856..5075ed9f02aa2 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridParserTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoHashGridParserTests.java
@@ -22,6 +22,8 @@
 import org.elasticsearch.common.xcontent.XContentParseException;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.geo.GeometryTestUtils;
+import org.elasticsearch.geometry.Rectangle;
 import org.elasticsearch.test.ESTestCase;
 
 import static org.hamcrest.Matchers.containsString;
@@ -113,4 +115,19 @@ public void testParseErrorOnPrecisionOutOfRange() throws Exception {
             assertEquals("Invalid geohash aggregation precision of 13. Must be between 1 and 12.", ex.getCause().getMessage());
         }
     }
+
+    public void testParseValidBounds() throws Exception {
+        Rectangle bbox = GeometryTestUtils.randomRectangle();
+        XContentParser stParser = createParser(JsonXContent.jsonXContent,
+            "{\"field\":\"my_loc\", \"precision\": 5, \"size\": 500, \"shard_size\": 550," + "\"bounds\": { "
+                + "\"top\": " + bbox.getMaxY() + ","
+                + "\"bottom\": " + bbox.getMinY() + ","
+                + "\"left\": " + bbox.getMinX() + ","
+                + "\"right\": " + bbox.getMaxX() + "}"
+                + "}");
+        XContentParser.Token token = stParser.nextToken();
+        assertSame(XContentParser.Token.START_OBJECT, token);
+        // can create a factory
+        assertNotNull(GeoHashGridAggregationBuilder.parse("geohash_grid", stParser));
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregatorTests.java
index 6544344543e34..85b2306403230 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridAggregatorTests.java
@@ -46,5 +46,4 @@ public void testPrecision() {
         builder.precision(precision);
         assertEquals(precision, builder.precision());
     }
-
 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridParserTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridParserTests.java
index 6f15263a53b11..aa5253564fb49 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridParserTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoTileGridParserTests.java
@@ -22,6 +22,8 @@
 import org.elasticsearch.common.xcontent.XContentParseException;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.geo.GeometryTestUtils;
+import org.elasticsearch.geometry.Rectangle;
 import org.elasticsearch.test.ESTestCase;
 
 import static org.hamcrest.Matchers.containsString;
@@ -70,4 +72,19 @@ public void testParseErrorOnPrecisionOutOfRange() throws Exception {
             assertEquals("Invalid geotile_grid precision of 30. Must be between 0 and 29.", ex.getCause().getMessage());
         }
     }
+
+    public void testParseValidBounds() throws Exception {
+        Rectangle bbox = GeometryTestUtils.randomRectangle();
+        XContentParser stParser = createParser(JsonXContent.jsonXContent,
+            "{\"field\":\"my_loc\", \"precision\": 5, \"size\": 500, \"shard_size\": 550," + "\"bounds\": { "
+                + "\"top\": " + bbox.getMaxY() + ","
+                + "\"bottom\": " + bbox.getMinY() + ","
+                + "\"left\": " + bbox.getMinX() + ","
+                + "\"right\": " + bbox.getMaxX() + "}"
+                + "}");
+        XContentParser.Token token = stParser.nextToken();
+        assertSame(XContentParser.Token.START_OBJECT, token);
+        // can create a factory
+        assertNotNull(GeoTileGridAggregationBuilder.parse("geotile_grid", stParser));
+    }
 }

From 756683aa4f9913735d360b04137ca9f0d67822d3 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Tue, 14 Jan 2020 11:32:18 -0500
Subject: [PATCH 564/686] [ML][Inference] Adding classification_weights to
 ensemble models (#50874)

* [ML][Inference] Adding classification_weights to ensemble models

classification_weights are a way to allow models to
prefer specific classification results over others
this might be advantageous if classification value
probabilities are a known quantity and can improve
model error rates.
---
 .../trainedmodel/ensemble/Ensemble.java       | 27 ++++++-
 .../trainedmodel/ensemble/EnsembleTests.java  | 10 ++-
 .../ClassificationInferenceResults.java       | 25 ++++--
 .../trainedmodel/InferenceHelpers.java        | 52 ++++++++-----
 .../inference/trainedmodel/TrainedModel.java  | 13 ----
 .../trainedmodel/ensemble/Ensemble.java       | 77 ++++++++++++++-----
 .../langident/LangIdentNeuralNetwork.java     | 31 ++------
 .../ml/inference/trainedmodel/tree/Tree.java  | 23 +++---
 .../trainedmodel/ensemble/EnsembleTests.java  | 61 +++++++--------
 .../trainedmodel/tree/TreeTests.java          | 21 +----
 .../ml/integration/InferenceIngestIT.java     |  4 +-
 .../loadingservice/LocalModelTests.java       |  2 +-
 12 files changed, 190 insertions(+), 156 deletions(-)

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/Ensemble.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/Ensemble.java
index d16d758769c2b..60ffde6e35f59 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/Ensemble.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/Ensemble.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 
 import java.io.IOException;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
 import java.util.Objects;
@@ -41,6 +42,7 @@ public class Ensemble implements TrainedModel {
     public static final ParseField AGGREGATE_OUTPUT  = new ParseField("aggregate_output");
     public static final ParseField TARGET_TYPE = new ParseField("target_type");
     public static final ParseField CLASSIFICATION_LABELS = new ParseField("classification_labels");
+    public static final ParseField CLASSIFICATION_WEIGHTS = new ParseField("classification_weights");
 
     private static final ObjectParser<Builder, Void> PARSER = new ObjectParser<>(
         NAME,
@@ -60,6 +62,7 @@ public class Ensemble implements TrainedModel {
             AGGREGATE_OUTPUT);
         PARSER.declareString(Ensemble.Builder::setTargetType, TARGET_TYPE);
         PARSER.declareStringArray(Ensemble.Builder::setClassificationLabels, CLASSIFICATION_LABELS);
+        PARSER.declareDoubleArray(Ensemble.Builder::setClassificationWeights, CLASSIFICATION_WEIGHTS);
     }
 
     public static Ensemble fromXContent(XContentParser parser) {
@@ -71,17 +74,20 @@ public static Ensemble fromXContent(XContentParser parser) {
     private final OutputAggregator outputAggregator;
     private final TargetType targetType;
     private final List<String> classificationLabels;
+    private final double[] classificationWeights;
 
     Ensemble(List<String> featureNames,
              List<TrainedModel> models,
              @Nullable OutputAggregator outputAggregator,
              TargetType targetType,
-             @Nullable List<String> classificationLabels) {
+             @Nullable List<String> classificationLabels,
+             @Nullable double[] classificationWeights) {
         this.featureNames = featureNames;
         this.models = models;
         this.outputAggregator = outputAggregator;
         this.targetType = targetType;
         this.classificationLabels = classificationLabels;
+        this.classificationWeights = classificationWeights;
     }
 
     @Override
@@ -116,6 +122,9 @@ public XContentBuilder toXContent(XContentBuilder builder, ToXContent.Params par
         if (classificationLabels != null) {
             builder.field(CLASSIFICATION_LABELS.getPreferredName(), classificationLabels);
         }
+        if (classificationWeights != null) {
+            builder.field(CLASSIFICATION_WEIGHTS.getPreferredName(), classificationWeights);
+        }
         builder.endObject();
         return builder;
     }
@@ -129,12 +138,18 @@ public boolean equals(Object o) {
             && Objects.equals(models, that.models)
             && Objects.equals(targetType, that.targetType)
             && Objects.equals(classificationLabels, that.classificationLabels)
+            && Arrays.equals(classificationWeights, that.classificationWeights)
             && Objects.equals(outputAggregator, that.outputAggregator);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(featureNames, models, outputAggregator, classificationLabels, targetType);
+        return Objects.hash(featureNames,
+            models,
+            outputAggregator,
+            classificationLabels,
+            targetType,
+            Arrays.hashCode(classificationWeights));
     }
 
     public static Builder builder() {
@@ -147,6 +162,7 @@ public static class Builder {
         private OutputAggregator outputAggregator;
         private TargetType targetType;
         private List<String> classificationLabels;
+        private double[] classificationWeights;
 
         public Builder setFeatureNames(List<String> featureNames) {
             this.featureNames = featureNames;
@@ -173,6 +189,11 @@ public Builder setClassificationLabels(List<String> classificationLabels) {
             return this;
         }
 
+        public Builder setClassificationWeights(List<Double> classificationWeights) {
+            this.classificationWeights = classificationWeights.stream().mapToDouble(Double::doubleValue).toArray();
+            return this;
+        }
+
         private void setOutputAggregatorFromParser(List<OutputAggregator> outputAggregators) {
             this.setOutputAggregator(outputAggregators.get(0));
         }
@@ -182,7 +203,7 @@ private void setTargetType(String targetType) {
         }
 
         public Ensemble build() {
-            return new Ensemble(featureNames, trainedModels, outputAggregator, targetType, classificationLabels);
+            return new Ensemble(featureNames, trainedModels, outputAggregator, targetType, classificationLabels, classificationWeights);
         }
     }
 }
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/EnsembleTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/EnsembleTests.java
index a26adf5f09c71..9f15a3f8a31b3 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/EnsembleTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/ml/inference/trainedmodel/ensemble/EnsembleTests.java
@@ -80,11 +80,19 @@ public static Ensemble createRandom(TargetType targetType) {
         if (randomBoolean() && targetType.equals(TargetType.CLASSIFICATION)) {
             categoryLabels = Arrays.asList(generateRandomStringArray(randomIntBetween(1, 10), randomIntBetween(1, 10), false, false));
         }
+        double[] thresholds = randomBoolean() && targetType == TargetType.CLASSIFICATION  ?
+            Stream.generate(ESTestCase::randomDouble)
+                .limit(categoryLabels == null ? randomIntBetween(1, 10) : categoryLabels.size())
+                .mapToDouble(Double::valueOf)
+                .toArray() :
+            null;
+
         return new Ensemble(featureNames,
             models,
             outputAggregator,
             targetType,
-            categoryLabels);
+            categoryLabels,
+            thresholds);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
index 226a9c1104346..39ae4057fd9ca 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/results/ClassificationInferenceResults.java
@@ -112,18 +112,26 @@ public static class TopClassEntry implements Writeable {
 
         public final ParseField CLASS_NAME = new ParseField("class_name");
         public final ParseField CLASS_PROBABILITY = new ParseField("class_probability");
+        public final ParseField CLASS_SCORE = new ParseField("class_score");
 
         private final String classification;
         private final double probability;
+        private final double score;
 
-        public TopClassEntry(String classification, Double probability) {
+        public TopClassEntry(String classification, double probability) {
+            this(classification, probability, probability);
+        }
+
+        public TopClassEntry(String classification, double probability, double score) {
             this.classification = ExceptionsHelper.requireNonNull(classification, CLASS_NAME);
-            this.probability = ExceptionsHelper.requireNonNull(probability, CLASS_PROBABILITY);
+            this.probability = probability;
+            this.score = score;
         }
 
         public TopClassEntry(StreamInput in) throws IOException {
             this.classification = in.readString();
             this.probability = in.readDouble();
+            this.score = in.readDouble();
         }
 
         public String getClassification() {
@@ -134,10 +142,15 @@ public double getProbability() {
             return probability;
         }
 
+        public double getScore() {
+            return score;
+        }
+
         public Map<String, Object> asValueMap() {
-            Map<String, Object> map = new HashMap<>(2);
+            Map<String, Object> map = new HashMap<>(3, 1.0f);
             map.put(CLASS_NAME.getPreferredName(), classification);
             map.put(CLASS_PROBABILITY.getPreferredName(), probability);
+            map.put(CLASS_SCORE.getPreferredName(), score);
             return map;
         }
 
@@ -145,6 +158,7 @@ public Map<String, Object> asValueMap() {
         public void writeTo(StreamOutput out) throws IOException {
             out.writeString(classification);
             out.writeDouble(probability);
+            out.writeDouble(score);
         }
 
         @Override
@@ -152,13 +166,12 @@ public boolean equals(Object object) {
             if (object == this) { return true; }
             if (object == null || getClass() != object.getClass()) { return false; }
             TopClassEntry that = (TopClassEntry) object;
-            return Objects.equals(classification, that.classification) &&
-                Objects.equals(probability, that.probability);
+            return Objects.equals(classification, that.classification) && probability == that.probability && score == that.score;
         }
 
         @Override
         public int hashCode() {
-            return Objects.hash(classification, probability);
+            return Objects.hash(classification, probability, score);
         }
     }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/InferenceHelpers.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/InferenceHelpers.java
index 86bf076cd6bf1..ae5a4062a69dc 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/InferenceHelpers.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/InferenceHelpers.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.core.ml.inference.trainedmodel;
 
 import org.elasticsearch.common.Nullable;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.xpack.core.ml.inference.results.ClassificationInferenceResults;
 import org.elasticsearch.xpack.core.ml.utils.ExceptionsHelper;
 
@@ -20,17 +21,13 @@ public final class InferenceHelpers {
 
     private InferenceHelpers() { }
 
-    public static List<ClassificationInferenceResults.TopClassEntry> topClasses(List<Double> probabilities,
-                                                                                List<String> classificationLabels,
-                                                                                int numToInclude) {
-        if (numToInclude == 0) {
-            return Collections.emptyList();
-        }
-        int[] sortedIndices = IntStream.range(0, probabilities.size())
-            .boxed()
-            .sorted(Comparator.comparing(probabilities::get).reversed())
-            .mapToInt(i -> i)
-            .toArray();
+    /**
+     * @return Tuple of the highest scored index and the top classes
+     */
+    public static Tuple<Integer, List<ClassificationInferenceResults.TopClassEntry>> topClasses(List<Double> probabilities,
+                                                                                                List<String> classificationLabels,
+                                                                                                @Nullable double[] classificationWeights,
+                                                                                                int numToInclude) {
 
         if (classificationLabels != null && probabilities.size() != classificationLabels.size()) {
             throw ExceptionsHelper
@@ -38,7 +35,24 @@ public static List<ClassificationInferenceResults.TopClassEntry> topClasses(List
                     "model returned classification probabilities of size [{}] which is not equal to classification labels size [{}]",
                     null,
                     probabilities.size(),
-                    classificationLabels);
+                    classificationLabels.size());
+        }
+
+        List<Double> scores = classificationWeights == null ?
+            probabilities :
+            IntStream.range(0, probabilities.size())
+                .mapToDouble(i -> probabilities.get(i) * classificationWeights[i])
+                .boxed()
+                .collect(Collectors.toList());
+
+        int[] sortedIndices = IntStream.range(0, probabilities.size())
+            .boxed()
+            .sorted(Comparator.comparing(scores::get).reversed())
+            .mapToInt(i -> i)
+            .toArray();
+
+        if (numToInclude == 0) {
+            return Tuple.tuple(sortedIndices[0], Collections.emptyList());
         }
 
         List<String> labels = classificationLabels == null ?
@@ -50,26 +64,24 @@ public static List<ClassificationInferenceResults.TopClassEntry> topClasses(List
         List<ClassificationInferenceResults.TopClassEntry> topClassEntries = new ArrayList<>(count);
         for(int i = 0; i < count; i++) {
             int idx = sortedIndices[i];
-            topClassEntries.add(new ClassificationInferenceResults.TopClassEntry(labels.get(idx), probabilities.get(idx)));
+            topClassEntries.add(new ClassificationInferenceResults.TopClassEntry(labels.get(idx), probabilities.get(idx), scores.get(idx)));
         }
 
-        return topClassEntries;
+        return Tuple.tuple(sortedIndices[0], topClassEntries);
     }
 
-    public static String classificationLabel(double inferenceValue, @Nullable List<String> classificationLabels) {
-        assert inferenceValue == Math.rint(inferenceValue);
+    public static String classificationLabel(Integer inferenceValue, @Nullable List<String> classificationLabels) {
         if (classificationLabels == null) {
             return String.valueOf(inferenceValue);
         }
-        int label = Double.valueOf(inferenceValue).intValue();
-        if (label < 0 || label >= classificationLabels.size()) {
+        if (inferenceValue < 0 || inferenceValue >= classificationLabels.size()) {
             throw ExceptionsHelper.serverError(
                 "model returned classification value of [{}] which is not a valid index in classification labels [{}]",
                 null,
-                label,
+                inferenceValue,
                 classificationLabels);
         }
-        return classificationLabels.get(label);
+        return classificationLabels.get(inferenceValue);
     }
 
     public static Double toDouble(Object value) {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/TrainedModel.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/TrainedModel.java
index e206a70918096..4bbca5ed0b1d5 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/TrainedModel.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/TrainedModel.java
@@ -6,21 +6,14 @@
 package org.elasticsearch.xpack.core.ml.inference.trainedmodel;
 
 import org.apache.lucene.util.Accountable;
-import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.xpack.core.ml.inference.results.InferenceResults;
 import org.elasticsearch.xpack.core.ml.utils.NamedXContentObject;
 
-import java.util.List;
 import java.util.Map;
 
 public interface TrainedModel extends NamedXContentObject, NamedWriteable, Accountable {
 
-    /**
-     * @return List of featureNames expected by the model. In the order that they are expected
-     */
-    List<String> getFeatureNames();
-
     /**
      * Infer against the provided fields
      *
@@ -36,12 +29,6 @@ public interface TrainedModel extends NamedXContentObject, NamedWriteable, Accou
      */
     TargetType targetType();
 
-    /**
-     * @return Ordinal encoded list of classification labels.
-     */
-    @Nullable
-    List<String> classificationLabels();
-
     /**
      * Runs validations against the model.
      *
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/Ensemble.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/Ensemble.java
index c9bde54c460cd..a455730ae8208 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/Ensemble.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/Ensemble.java
@@ -10,6 +10,7 @@
 import org.apache.lucene.util.RamUsageEstimator;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ObjectParser;
@@ -33,6 +34,7 @@
 
 import java.io.IOException;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.List;
@@ -53,6 +55,7 @@ public class Ensemble implements LenientlyParsedTrainedModel, StrictlyParsedTrai
     public static final ParseField AGGREGATE_OUTPUT  = new ParseField("aggregate_output");
     public static final ParseField TARGET_TYPE = new ParseField("target_type");
     public static final ParseField CLASSIFICATION_LABELS = new ParseField("classification_labels");
+    public static final ParseField CLASSIFICATION_WEIGHTS = new ParseField("classification_weights");
 
     private static final ObjectParser<Ensemble.Builder, Void> LENIENT_PARSER = createParser(true);
     private static final ObjectParser<Ensemble.Builder, Void> STRICT_PARSER = createParser(false);
@@ -77,6 +80,7 @@ private static ObjectParser<Ensemble.Builder, Void> createParser(boolean lenient
             AGGREGATE_OUTPUT);
         parser.declareString(Ensemble.Builder::setTargetType, TARGET_TYPE);
         parser.declareStringArray(Ensemble.Builder::setClassificationLabels, CLASSIFICATION_LABELS);
+        parser.declareDoubleArray(Ensemble.Builder::setClassificationWeights, CLASSIFICATION_WEIGHTS);
         return parser;
     }
 
@@ -93,17 +97,22 @@ public static Ensemble fromXContentLenient(XContentParser parser) {
     private final OutputAggregator outputAggregator;
     private final TargetType targetType;
     private final List<String> classificationLabels;
+    private final double[] classificationWeights;
 
     Ensemble(List<String> featureNames,
              List<TrainedModel> models,
              OutputAggregator outputAggregator,
              TargetType targetType,
-             @Nullable List<String> classificationLabels) {
+             @Nullable List<String> classificationLabels,
+             @Nullable double[] classificationWeights) {
         this.featureNames = Collections.unmodifiableList(ExceptionsHelper.requireNonNull(featureNames, FEATURE_NAMES));
         this.models = Collections.unmodifiableList(ExceptionsHelper.requireNonNull(models, TRAINED_MODELS));
         this.outputAggregator = ExceptionsHelper.requireNonNull(outputAggregator, AGGREGATE_OUTPUT);
         this.targetType = ExceptionsHelper.requireNonNull(targetType, TARGET_TYPE);
         this.classificationLabels = classificationLabels == null ? null : Collections.unmodifiableList(classificationLabels);
+        this.classificationWeights = classificationWeights == null ?
+            null :
+            Arrays.copyOf(classificationWeights, classificationWeights.length);
     }
 
     public Ensemble(StreamInput in) throws IOException {
@@ -116,11 +125,11 @@ public Ensemble(StreamInput in) throws IOException {
         } else {
             this.classificationLabels = null;
         }
-    }
-
-    @Override
-    public List<String> getFeatureNames() {
-        return featureNames;
+        if (in.readBoolean()) {
+            this.classificationWeights = in.readDoubleArray();
+        } else {
+            this.classificationWeights = null;
+        }
     }
 
     @Override
@@ -153,25 +162,22 @@ private InferenceResults buildResults(List<Double> processedInferences, Inferenc
                 return new RegressionInferenceResults(outputAggregator.aggregate(processedInferences), config);
             case CLASSIFICATION:
                 ClassificationConfig classificationConfig = (ClassificationConfig) config;
-                List<ClassificationInferenceResults.TopClassEntry> topClasses = InferenceHelpers.topClasses(
+                assert classificationWeights == null || processedInferences.size() == classificationWeights.length;
+                // Adjust the probabilities according to the thresholds
+                Tuple<Integer, List<ClassificationInferenceResults.TopClassEntry>> topClasses = InferenceHelpers.topClasses(
                     processedInferences,
                     classificationLabels,
+                    classificationWeights,
                     classificationConfig.getNumTopClasses());
-                double value = outputAggregator.aggregate(processedInferences);
-                return new ClassificationInferenceResults(outputAggregator.aggregate(processedInferences),
-                    classificationLabel(value, classificationLabels),
-                    topClasses,
+                return new ClassificationInferenceResults((double)topClasses.v1(),
+                    classificationLabel(topClasses.v1(), classificationLabels),
+                    topClasses.v2(),
                     config);
             default:
                 throw new UnsupportedOperationException("unsupported target_type [" + targetType + "] for inference on ensemble model");
         }
     }
 
-    @Override
-    public List<String> classificationLabels() {
-        return classificationLabels;
-    }
-
     @Override
     public String getWriteableName() {
         return NAME.getPreferredName();
@@ -187,6 +193,10 @@ public void writeTo(StreamOutput out) throws IOException {
         if (classificationLabels != null) {
             out.writeStringCollection(classificationLabels);
         }
+        out.writeBoolean(classificationWeights != null);
+        if (classificationWeights != null) {
+            out.writeDoubleArray(classificationWeights);
+        }
     }
 
     @Override
@@ -208,6 +218,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (classificationLabels != null) {
             builder.field(CLASSIFICATION_LABELS.getPreferredName(), classificationLabels);
         }
+        if (classificationWeights != null) {
+            builder.field(CLASSIFICATION_WEIGHTS.getPreferredName(), classificationWeights);
+        }
         builder.endObject();
         return builder;
     }
@@ -221,12 +234,18 @@ public boolean equals(Object o) {
             && Objects.equals(models, that.models)
             && Objects.equals(targetType, that.targetType)
             && Objects.equals(classificationLabels, that.classificationLabels)
-            && Objects.equals(outputAggregator, that.outputAggregator);
+            && Objects.equals(outputAggregator, that.outputAggregator)
+            && Arrays.equals(classificationWeights, that.classificationWeights);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(featureNames, models, outputAggregator, targetType, classificationLabels);
+        return Objects.hash(featureNames,
+            models,
+            outputAggregator,
+            targetType,
+            classificationLabels,
+            Arrays.hashCode(classificationWeights));
     }
 
     @Override
@@ -246,9 +265,16 @@ public void validate() {
                 outputAggregator.expectedValueSize(),
                 models.size());
         }
-        if ((this.targetType == TargetType.CLASSIFICATION) != (this.classificationLabels != null)) {
+        if ((this.classificationLabels != null || this.classificationWeights != null) && (this.targetType != TargetType.CLASSIFICATION)) {
             throw ExceptionsHelper.badRequestException(
-                "[target_type] should be [classification] if [classification_labels] is provided, and vice versa");
+                "[target_type] should be [classification] if [classification_labels] or [classification_weights] are provided");
+        }
+        if (classificationWeights != null &&
+            classificationLabels != null &&
+            classificationWeights.length != classificationLabels.size()) {
+            throw ExceptionsHelper.badRequestException(
+                "[classification_weights] and [classification_labels] should be the same length if both are provided"
+            );
         }
         this.models.forEach(TrainedModel::validate);
     }
@@ -271,6 +297,9 @@ public long ramBytesUsed() {
         size += RamUsageEstimator.sizeOfCollection(featureNames);
         size += RamUsageEstimator.sizeOfCollection(classificationLabels);
         size += RamUsageEstimator.sizeOfCollection(models);
+        if (classificationWeights != null) {
+            size += RamUsageEstimator.sizeOf(classificationWeights);
+        }
         size += outputAggregator.ramBytesUsed();
         return size;
     }
@@ -291,6 +320,7 @@ public static class Builder {
         private OutputAggregator outputAggregator = new WeightedSum();
         private TargetType targetType = TargetType.REGRESSION;
         private List<String> classificationLabels;
+        private double[] classificationWeights;
         private boolean modelsAreOrdered;
 
         private Builder (boolean modelsAreOrdered) {
@@ -330,6 +360,11 @@ public Builder setClassificationLabels(List<String> classificationLabels) {
             return this;
         }
 
+        public Builder setClassificationWeights(List<Double> classificationWeights) {
+            this.classificationWeights = classificationWeights.stream().mapToDouble(Double::doubleValue).toArray();
+            return this;
+        }
+
         private void setOutputAggregatorFromParser(List<OutputAggregator> outputAggregators) {
             if (outputAggregators.size() != 1) {
                 throw ExceptionsHelper.badRequestException("[{}] must have exactly one aggregator defined.",
@@ -352,7 +387,7 @@ public Ensemble build() {
             if (modelsAreOrdered == false && trainedModels != null && trainedModels.size() > 1) {
                 throw ExceptionsHelper.badRequestException("[trained_models] needs to be an array of objects");
             }
-            return new Ensemble(featureNames, trainedModels, outputAggregator, targetType, classificationLabels);
+            return new Ensemble(featureNames, trainedModels, outputAggregator, targetType, classificationLabels, classificationWeights);
         }
     }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
index b9edeb7885504..7de2c8f060500 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/langident/LangIdentNeuralNetwork.java
@@ -8,6 +8,7 @@
 
 import org.apache.lucene.util.RamUsageEstimator;
 import org.elasticsearch.common.ParseField;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ConstructingObjectParser;
@@ -25,13 +26,10 @@
 
 import java.io.IOException;
 import java.util.Arrays;
-import java.util.Collections;
-import java.util.Comparator;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 import java.util.stream.Collectors;
-import java.util.stream.IntStream;
 
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 import static org.elasticsearch.xpack.core.ml.inference.utils.Statistics.softMax;
@@ -105,11 +103,6 @@ public LangIdentNeuralNetwork(StreamInput in) throws IOException {
         this.softmaxLayer = new LangNetLayer(in);
     }
 
-    @Override
-    public List<String> getFeatureNames() {
-        return Collections.singletonList(embeddedVectorFeatureName);
-    }
-
     @Override
     public InferenceResults infer(Map<String, Object> fields, InferenceConfig config) {
         if (config instanceof ClassificationConfig == false) {
@@ -134,20 +127,17 @@ public InferenceResults infer(Map<String, Object> fields, InferenceConfig config
 
         List<Double> probabilities = softMax(Arrays.stream(scores).boxed().collect(Collectors.toList()));
 
-        int maxIndex = IntStream.range(0, probabilities.size())
-            .boxed()
-            .max(Comparator.comparing(probabilities::get))
-            .orElseThrow(() -> ExceptionsHelper.serverError("Unexpected null value while searching for max probability"));
-
-        assert maxIndex >= 0 && maxIndex < LANGUAGE_NAMES.size() : "Invalid language predicted. Predicted language index " + maxIndex;
         ClassificationConfig classificationConfig = (ClassificationConfig) config;
-        List<ClassificationInferenceResults.TopClassEntry> topClasses = InferenceHelpers.topClasses(
+        Tuple<Integer, List<ClassificationInferenceResults.TopClassEntry>> topClasses = InferenceHelpers.topClasses(
             probabilities,
             LANGUAGE_NAMES,
+            null,
             classificationConfig.getNumTopClasses());
-        return new ClassificationInferenceResults(maxIndex,
-            LANGUAGE_NAMES.get(maxIndex),
-            topClasses,
+        assert topClasses.v1() >= 0 && topClasses.v1() < LANGUAGE_NAMES.size() :
+            "Invalid language predicted. Predicted language index " + topClasses.v1();
+        return new ClassificationInferenceResults(topClasses.v1(),
+            LANGUAGE_NAMES.get(topClasses.v1()),
+            topClasses.v2(),
             classificationConfig);
     }
 
@@ -156,11 +146,6 @@ public TargetType targetType() {
         return TargetType.CLASSIFICATION;
     }
 
-    @Override
-    public List<String> classificationLabels() {
-        return LANGUAGE_NAMES;
-    }
-
     @Override
     public void validate() {
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
index 831838e0f7df2..527307597a597 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/Tree.java
@@ -10,6 +10,7 @@
 import org.apache.lucene.util.RamUsageEstimator;
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.util.CachedSupplier;
@@ -114,11 +115,6 @@ public String getName() {
         return NAME.getPreferredName();
     }
 
-    @Override
-    public List<String> getFeatureNames() {
-        return featureNames;
-    }
-
     public List<TreeNode> getNodes() {
         return nodes;
     }
@@ -152,11 +148,15 @@ private InferenceResults buildResult(Double value, InferenceConfig config) {
         switch (targetType) {
             case CLASSIFICATION:
                 ClassificationConfig classificationConfig = (ClassificationConfig) config;
-                List<ClassificationInferenceResults.TopClassEntry> topClasses = InferenceHelpers.topClasses(
+                Tuple<Integer, List<ClassificationInferenceResults.TopClassEntry>> topClasses = InferenceHelpers.topClasses(
                     classificationProbability(value),
                     classificationLabels,
+                    null,
                     classificationConfig.getNumTopClasses());
-                return new ClassificationInferenceResults(value, classificationLabel(value, classificationLabels), topClasses, config);
+                return new ClassificationInferenceResults(value,
+                    classificationLabel(topClasses.v1(), classificationLabels),
+                    topClasses.v2(),
+                    config);
             case REGRESSION:
                 return new RegressionInferenceResults(value, config);
             default:
@@ -197,11 +197,6 @@ private List<Double> classificationProbability(double inferenceValue) {
         return list;
     }
 
-    @Override
-    public List<String> classificationLabels() {
-        return classificationLabels;
-    }
-
     @Override
     public String getWriteableName() {
         return NAME.getPreferredName();
@@ -270,9 +265,9 @@ public long estimatedNumOperations() {
     }
 
     private void checkTargetType() {
-        if ((this.targetType == TargetType.CLASSIFICATION) != (this.classificationLabels != null)) {
+        if (this.classificationLabels != null && this.targetType != TargetType.CLASSIFICATION) {
             throw ExceptionsHelper.badRequestException(
-                "[target_type] should be [classification] if [classification_labels] is provided, and vice versa");
+                "[target_type] should be [classification] if [classification_labels] are provided");
         }
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
index 46373dae834c9..ba2926e5050b3 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/ensemble/EnsembleTests.java
@@ -8,10 +8,8 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable;
-import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.search.SearchModule;
 import org.elasticsearch.test.AbstractSerializingTestCase;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
@@ -28,7 +26,6 @@
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Arrays;
-import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -77,16 +74,24 @@ public static Ensemble createRandom() {
         OutputAggregator outputAggregator = randomFrom(new WeightedMode(weights),
             new WeightedSum(weights),
             new LogisticRegression(weights));
+        TargetType targetType = randomFrom(TargetType.values());
         List<String> categoryLabels = null;
-        if (randomBoolean()) {
+        if (randomBoolean() && targetType == TargetType.CLASSIFICATION) {
             categoryLabels = Arrays.asList(generateRandomStringArray(randomIntBetween(1, 10), randomIntBetween(1, 10), false, false));
         }
+        double[] thresholds = randomBoolean() && targetType == TargetType.CLASSIFICATION ?
+            Stream.generate(ESTestCase::randomDouble)
+                .limit(categoryLabels == null ? randomIntBetween(1, 10) : categoryLabels.size())
+                .mapToDouble(Double::valueOf)
+                .toArray() :
+            null;
 
         return new Ensemble(featureNames,
             models,
             outputAggregator,
-            randomFrom(TargetType.values()),
-            categoryLabels);
+            targetType,
+            categoryLabels,
+            thresholds);
     }
 
     @Override
@@ -101,17 +106,12 @@ protected Writeable.Reader<Ensemble> instanceReader() {
 
     @Override
     protected NamedXContentRegistry xContentRegistry() {
-        List<NamedXContentRegistry.Entry> namedXContent = new ArrayList<>();
-        namedXContent.addAll(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
-        namedXContent.addAll(new SearchModule(Settings.EMPTY, Collections.emptyList()).getNamedXContents());
-        return new NamedXContentRegistry(namedXContent);
+        return new NamedXContentRegistry(new MlInferenceNamedXContentProvider().getNamedXContentParsers());
     }
 
     @Override
     protected NamedWriteableRegistry getNamedWriteableRegistry() {
-        List<NamedWriteableRegistry.Entry> entries = new ArrayList<>();
-        entries.addAll(new MlInferenceNamedXContentProvider().getNamedWriteables());
-        return new NamedWriteableRegistry(entries);
+        return new NamedWriteableRegistry(new MlInferenceNamedXContentProvider().getNamedWriteables());
     }
 
     public void testEnsembleWithAggregatedOutputDifferingFromTrainedModels() {
@@ -184,16 +184,15 @@ public void testEnsembleWithAggregatorOutputNotSupportingTargetType() {
 
     public void testEnsembleWithTargetTypeAndLabelsMismatch() {
         List<String> featureNames = Arrays.asList("foo", "bar");
-        String msg = "[target_type] should be [classification] if [classification_labels] is provided, and vice versa";
+        String msg = "[target_type] should be [classification] if " +
+            "[classification_labels] or [classification_weights] are provided";
         ElasticsearchException ex = expectThrows(ElasticsearchException.class, () -> {
             Ensemble.builder()
                 .setFeatureNames(featureNames)
                 .setTrainedModels(Arrays.asList(
                     Tree.builder()
                         .setNodes(TreeNode.builder(0)
-                                .setLeftChild(1)
-                                .setSplitFeature(1)
-                                .setThreshold(randomDouble()))
+                                .setLeafValue(randomDouble()))
                         .setFeatureNames(featureNames)
                         .build()))
                 .setClassificationLabels(Arrays.asList("label1", "label2"))
@@ -201,23 +200,6 @@ public void testEnsembleWithTargetTypeAndLabelsMismatch() {
                 .validate();
         });
         assertThat(ex.getMessage(), equalTo(msg));
-        ex = expectThrows(ElasticsearchException.class, () -> {
-            Ensemble.builder()
-                .setFeatureNames(featureNames)
-                .setTrainedModels(Arrays.asList(
-                    Tree.builder()
-                        .setNodes(TreeNode.builder(0)
-                            .setLeftChild(1)
-                            .setSplitFeature(1)
-                            .setThreshold(randomDouble()))
-                        .setFeatureNames(featureNames)
-                        .build()))
-                .setTargetType(TargetType.CLASSIFICATION)
-                .setOutputAggregator(new WeightedMode())
-                .build()
-                .validate();
-        });
-        assertThat(ex.getMessage(), equalTo(msg));
     }
 
     public void testClassificationProbability() {
@@ -262,34 +244,41 @@ public void testClassificationProbability() {
             .setFeatureNames(featureNames)
             .setTrainedModels(Arrays.asList(tree1, tree2, tree3))
             .setOutputAggregator(new WeightedMode(new double[]{0.7, 0.5, 1.0}))
+            .setClassificationWeights(Arrays.asList(0.7, 0.3))
             .build();
 
         List<Double> featureVector = Arrays.asList(0.4, 0.0);
         Map<String, Object> featureMap = zipObjMap(featureNames, featureVector);
         List<Double> expected = Arrays.asList(0.768524783, 0.231475216);
+        List<Double> scores   = Arrays.asList(0.230557435, 0.162032651);
         double eps = 0.000001;
         List<ClassificationInferenceResults.TopClassEntry> probabilities =
             ((ClassificationInferenceResults)ensemble.infer(featureMap, new ClassificationConfig(2))).getTopClasses();
         for(int i = 0; i < expected.size(); i++) {
             assertThat(probabilities.get(i).getProbability(), closeTo(expected.get(i), eps));
+            assertThat(probabilities.get(i).getScore(), closeTo(scores.get(i), eps));
         }
 
         featureVector = Arrays.asList(2.0, 0.7);
         featureMap = zipObjMap(featureNames, featureVector);
-        expected = Arrays.asList(0.689974481, 0.3100255188);
+        expected = Arrays.asList(0.310025518, 0.6899744811);
+        scores   = Arrays.asList(0.217017863, 0.2069923443);
         probabilities =
             ((ClassificationInferenceResults)ensemble.infer(featureMap, new ClassificationConfig(2))).getTopClasses();
         for(int i = 0; i < expected.size(); i++) {
             assertThat(probabilities.get(i).getProbability(), closeTo(expected.get(i), eps));
+            assertThat(probabilities.get(i).getScore(), closeTo(scores.get(i), eps));
         }
 
         featureVector = Arrays.asList(0.0, 1.0);
         featureMap = zipObjMap(featureNames, featureVector);
         expected = Arrays.asList(0.768524783, 0.231475216);
+        scores   = Arrays.asList(0.230557435, 0.162032651);
         probabilities =
             ((ClassificationInferenceResults)ensemble.infer(featureMap, new ClassificationConfig(2))).getTopClasses();
         for(int i = 0; i < expected.size(); i++) {
             assertThat(probabilities.get(i).getProbability(), closeTo(expected.get(i), eps));
+            assertThat(probabilities.get(i).getScore(), closeTo(scores.get(i), eps));
         }
 
         // This should handle missing values and take the default_left path
@@ -298,10 +287,12 @@ public void testClassificationProbability() {
             put("bar", null);
         }};
         expected = Arrays.asList(0.6899744811, 0.3100255188);
+        scores   = Arrays.asList(0.482982136, 0.0930076556);
         probabilities =
             ((ClassificationInferenceResults)ensemble.infer(featureMap, new ClassificationConfig(2))).getTopClasses();
         for(int i = 0; i < expected.size(); i++) {
             assertThat(probabilities.get(i).getProbability(), closeTo(expected.get(i), eps));
+            assertThat(probabilities.get(i).getScore(), closeTo(scores.get(i), eps));
         }
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
index 8c05c8d7b9d3a..123a298b1d3a9 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/tree/TreeTests.java
@@ -93,14 +93,13 @@ public static Tree buildRandomTree(List<String> featureNames, int depth) {
             }
             childNodes = nextNodes;
         }
+        TargetType targetType = randomFrom(TargetType.values());
         List<String> categoryLabels = null;
-        if (randomBoolean()) {
+        if (randomBoolean() && targetType == TargetType.CLASSIFICATION) {
             categoryLabels = Arrays.asList(generateRandomStringArray(randomIntBetween(1, 10), randomIntBetween(1, 10), false, false));
         }
 
-        return builder.setTargetType(randomFrom(TargetType.values()))
-            .setClassificationLabels(categoryLabels)
-            .build();
+        return builder.setTargetType(targetType).setClassificationLabels(categoryLabels).build();
     }
 
     @Override
@@ -325,7 +324,7 @@ public void testTreeWithCycle() {
 
     public void testTreeWithTargetTypeAndLabelsMismatch() {
         List<String> featureNames = Arrays.asList("foo", "bar");
-        String msg = "[target_type] should be [classification] if [classification_labels] is provided, and vice versa";
+        String msg = "[target_type] should be [classification] if [classification_labels] are provided";
         ElasticsearchException ex = expectThrows(ElasticsearchException.class, () -> {
             Tree.builder()
                 .setRoot(TreeNode.builder(0)
@@ -338,18 +337,6 @@ public void testTreeWithTargetTypeAndLabelsMismatch() {
                 .validate();
         });
         assertThat(ex.getMessage(), equalTo(msg));
-        ex = expectThrows(ElasticsearchException.class, () -> {
-            Tree.builder()
-                .setRoot(TreeNode.builder(0)
-                    .setLeftChild(1)
-                    .setSplitFeature(1)
-                    .setThreshold(randomDouble()))
-                .setFeatureNames(featureNames)
-                .setTargetType(TargetType.CLASSIFICATION)
-                .build()
-                .validate();
-        });
-        assertThat(ex.getMessage(), equalTo(msg));
     }
 
     public void testOperationsEstimations() {
diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
index 216eac723115f..9320d393a4f66 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/InferenceIngestIT.java
@@ -470,7 +470,7 @@ private Map<String, Object> generateSourceDoc() {
         "              },\n" +
         "              {\n" +
         "                \"node_index\": 2,\n" +
-        "                \"leaf_value\": 2\n" +
+        "                \"leaf_value\": 0\n" +
         "              }\n" +
         "            ],\n" +
         "            \"target_type\": \"regression\"\n" +
@@ -500,7 +500,7 @@ private Map<String, Object> generateSourceDoc() {
         "              },\n" +
         "              {\n" +
         "                \"node_index\": 2,\n" +
-        "                \"leaf_value\": 2\n" +
+        "                \"leaf_value\": 0\n" +
         "              }\n" +
         "            ],\n" +
         "            \"target_type\": \"regression\"\n" +
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
index faa1717cc4fde..512baa7624a68 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/inference/loadingservice/LocalModelTests.java
@@ -56,7 +56,7 @@ public void testClassificationInfer() throws Exception {
 
         SingleValueInferenceResults result = getSingleValue(model, fields, new ClassificationConfig(0));
         assertThat(result.value(), equalTo(0.0));
-        assertThat(result.valueAsString(), is("0.0"));
+        assertThat(result.valueAsString(), is("0"));
 
         ClassificationInferenceResults classificationResult =
             (ClassificationInferenceResults)getSingleValue(model, fields, new ClassificationConfig(1));

From 166fb0fefd777dcac22172529b43e9a5de4a3ce0 Mon Sep 17 00:00:00 2001
From: Bogdan Pintea <bpintea@gmail.com>
Date: Tue, 14 Jan 2020 17:39:30 +0100
Subject: [PATCH 565/686] SQL: Extend the optimisations for equalities (#50792)

* Extend the optimizations for equalities

This commit supplements the optimisations of equalities in conjunctions
and disjunctions:
* for conjunctions, the existing optimizations with ranges are extended
with not-equalities and inequalities; these lead to a fast resolution,
the conjunction either being evaluate to a FALSE, or the non-equality
conditions being dropped as superfluous;
* optimisations for disjunctions are added to be applied against ranges,
inequalities and not-equalities; these lead to disjunction either
becoming TRUE or the equality being dropped, either as superfluous or
merged into a range/inequality.

* Adress review notes

* Fix the bug around wrongly optimizing 'a=2 OR a!=?', which only yields
TRUE for same values in equality and inequality.
* Var renamings, code style adjustments, comments corrections.

* Address further review comments. Extend optim.

- fix a few code comments;
- extend the Equals OR NotEquals optimitsation (a=2 OR a!=5 -> a!=5);
- extend the Equals OR Range optimisation on limits equality (a=2 OR
  2<=a<5 -> 2<=a<5);
- in case an equality is being removed in a conjunction, the rest of
  possible optimisations to test is now skipped.

* rename one var for better legiblity

- s/rmEqual/removeEquals
---
 .../xpack/sql/optimizer/Optimizer.java        | 243 +++++++++++++++--
 .../xpack/sql/optimizer/OptimizerTests.java   | 246 ++++++++++++++++++
 2 files changed, 467 insertions(+), 22 deletions(-)

diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
index 5c947ebce5829..c52f1722c7e76 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
@@ -84,6 +84,7 @@
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.HashMap;
+import java.util.Iterator;
 import java.util.LinkedHashMap;
 import java.util.LinkedHashSet;
 import java.util.LinkedList;
@@ -814,7 +815,7 @@ private Expression simplifyAndOr(BinaryPredicate<?, ?, ?, ?> bc) {
                 }
 
                 //
-                // common factor extraction -> (a || b) && (a || c) => a && (b || c)
+                // common factor extraction -> (a || b) && (a || c) => a || (b && c)
                 //
                 List<Expression> leftSplit = splitOr(l);
                 List<Expression> rightSplit = splitOr(r);
@@ -852,7 +853,7 @@ private Expression simplifyAndOr(BinaryPredicate<?, ?, ?, ?> bc) {
                 }
 
                 //
-                // common factor extraction -> (a && b) || (a && c) => a || (b & c)
+                // common factor extraction -> (a && b) || (a && c) => a && (b || c)
                 //
                 List<Expression> leftSplit = splitAnd(l);
                 List<Expression> rightSplit = splitAnd(r);
@@ -958,9 +959,11 @@ private Expression literalToTheRight(BinaryOperator<?, ?, ?, ?> be) {
     }
 
     /**
-     * Propagate Equals to eliminate conjuncted Ranges.
-     * When encountering a different Equals or non-containing {@link Range}, the conjunction becomes false.
-     * When encountering a containing {@link Range}, the range gets eliminated by the equality.
+     * Propagate Equals to eliminate conjuncted Ranges or BinaryComparisons.
+     * When encountering a different Equals, non-containing {@link Range} or {@link BinaryComparison}, the conjunction becomes false.
+     * When encountering a containing {@link Range}, {@link BinaryComparison} or {@link NotEquals}, these get eliminated by the equality.
+     *
+     * Since this rule can eliminate Ranges and BinaryComparisons, it should be applied before {@link CombineBinaryComparisons}.
      *
      * This rule doesn't perform any promotion of {@link BinaryComparison}s, that is handled by
      * {@link CombineBinaryComparisons} on purpose as the resulting Range might be foldable
@@ -976,6 +979,8 @@ static class PropagateEquals extends OptimizerExpressionRule {
         protected Expression rule(Expression e) {
             if (e instanceof And) {
                 return propagate((And) e);
+            } else if (e instanceof Or) {
+                return propagate((Or) e);
             }
             return e;
         }
@@ -983,7 +988,11 @@ protected Expression rule(Expression e) {
         // combine conjunction
         private Expression propagate(And and) {
             List<Range> ranges = new ArrayList<>();
+            // Only equalities, not-equalities and inequalities with a foldable .right are extracted separately;
+            // the others go into the general 'exps'.
             List<BinaryComparison> equals = new ArrayList<>();
+            List<NotEquals> notEquals = new ArrayList<>();
+            List<BinaryComparison> inequalities = new ArrayList<>();
             List<Expression> exps = new ArrayList<>();
 
             boolean changed = false;
@@ -996,24 +1005,35 @@ private Expression propagate(And and) {
                     // equals on different values evaluate to FALSE
                     if (otherEq.right().foldable()) {
                         for (BinaryComparison eq : equals) {
-                            // cannot evaluate equals so skip it
-                            if (!eq.right().foldable()) {
-                                continue;
-                            }
                             if (otherEq.left().semanticEquals(eq.left())) {
-                                if (eq.right().foldable() && otherEq.right().foldable()) {
-                                    Integer comp = BinaryComparison.compare(eq.right().fold(), otherEq.right().fold());
-                                    if (comp != null) {
-                                        // var cannot be equal to two different values at the same time
-                                        if (comp != 0) {
-                                            return FALSE;
-                                        }
+                                Integer comp = BinaryComparison.compare(eq.right().fold(), otherEq.right().fold());
+                                if (comp != null) {
+                                    // var cannot be equal to two different values at the same time
+                                    if (comp != 0) {
+                                        return FALSE;
                                     }
                                 }
                             }
                         }
+                        equals.add(otherEq);
+                    } else {
+                        exps.add(otherEq);
+                    }
+                } else if (ex instanceof GreaterThan || ex instanceof GreaterThanOrEqual ||
+                    ex instanceof LessThan || ex instanceof LessThanOrEqual) {
+                    BinaryComparison bc = (BinaryComparison) ex;
+                    if (bc.right().foldable()) {
+                        inequalities.add(bc);
+                    } else {
+                        exps.add(ex);
+                    }
+                } else if (ex instanceof NotEquals) {
+                    NotEquals otherNotEq = (NotEquals) ex;
+                    if (otherNotEq.right().foldable()) {
+                        notEquals.add(otherNotEq);
+                    } else {
+                        exps.add(ex);
                     }
-                    equals.add(otherEq);
                 } else {
                     exps.add(ex);
                 }
@@ -1021,10 +1041,6 @@ private Expression propagate(And and) {
 
             // check
             for (BinaryComparison eq : equals) {
-                // cannot evaluate equals so skip it
-                if (!eq.right().foldable()) {
-                    continue;
-                }
                 Object eqValue = eq.right().fold();
 
                 for (int i = 0; i < ranges.size(); i++) {
@@ -1060,9 +1076,192 @@ private Expression propagate(And and) {
                         changed = true;
                     }
                 }
+
+                // evaluate all NotEquals against the Equal
+                for (Iterator<NotEquals> iter = notEquals.iterator(); iter.hasNext(); ) {
+                    NotEquals neq = iter.next();
+                    if (eq.left().semanticEquals(neq.left())) {
+                        Integer comp = BinaryComparison.compare(eqValue, neq.right().fold());
+                        if (comp != null) {
+                            if (comp == 0) {
+                                return FALSE; // clashing and conflicting: a = 1 AND a != 1
+                            } else {
+                                iter.remove(); // clashing and redundant: a = 1 AND a != 2
+                                changed = true;
+                            }
+                        }
+                    }
+                }
+
+                // evaluate all inequalities against the Equal
+                for (Iterator<BinaryComparison> iter = inequalities.iterator(); iter.hasNext(); ) {
+                    BinaryComparison bc = iter.next();
+                    if (eq.left().semanticEquals(bc.left())) {
+                        Integer compare = BinaryComparison.compare(eqValue, bc.right().fold());
+                        if (compare != null) {
+                            if (bc instanceof LessThan || bc instanceof LessThanOrEqual) { // a = 2 AND a </<= ?
+                                if ((compare == 0 && bc instanceof LessThan) || // a = 2 AND a < 2
+                                    0 < compare) { // a = 2 AND a </<= 1
+                                    return FALSE;
+                                }
+                            } else if (bc instanceof GreaterThan || bc instanceof GreaterThanOrEqual) { // a = 2 AND a >/>= ?
+                                if ((compare == 0 && bc instanceof GreaterThan) || // a = 2 AND a > 2
+                                    compare < 0) { // a = 2 AND a >/>= 3
+                                    return FALSE;
+                                }
+                            }
+
+                            iter.remove();
+                            changed = true;
+                        }
+                    }
+                }
+            }
+
+            return changed ? Predicates.combineAnd(CollectionUtils.combine(exps, equals, notEquals, inequalities, ranges)) : and;
+        }
+
+        // combine disjunction:
+        // a = 2 OR a > 3 -> nop; a = 2 OR a > 1 -> a > 1
+        // a = 2 OR a < 3 -> a < 3; a = 2 OR a < 1 -> nop
+        // a = 2 OR 3 < a < 5 -> nop; a = 2 OR 1 < a < 3 -> 1 < a < 3; a = 2 OR 0 < a < 1 -> nop
+        // a = 2 OR a != 2 -> TRUE; a = 2 OR a = 5 -> nop; a = 2 OR a != 5 -> a != 5
+        private Expression propagate(Or or) {
+            List<Expression> exps = new ArrayList<>();
+            List<Equals> equals = new ArrayList<>(); // foldable right term Equals
+            List<NotEquals> notEquals = new ArrayList<>(); // foldable right term NotEquals
+            List<Range> ranges = new ArrayList<>();
+            List<BinaryComparison> inequalities = new ArrayList<>(); // foldable right term (=limit) BinaryComparision
+
+            // split expressions by type
+            for (Expression ex : Predicates.splitOr(or)) {
+                if (ex instanceof Equals) {
+                    Equals eq = (Equals) ex;
+                    if (eq.right().foldable()) {
+                        equals.add(eq);
+                    } else {
+                        exps.add(ex);
+                    }
+                } else if (ex instanceof NotEquals) {
+                    NotEquals neq = (NotEquals) ex;
+                    if (neq.right().foldable()) {
+                        notEquals.add(neq);
+                    } else {
+                        exps.add(ex);
+                    }
+                } else if (ex instanceof Range) {
+                    ranges.add((Range) ex);
+                } else if (ex instanceof BinaryComparison) {
+                    BinaryComparison bc = (BinaryComparison) ex;
+                    if (bc.right().foldable()) {
+                        inequalities.add(bc);
+                    } else {
+                        exps.add(ex);
+                    }
+                } else {
+                    exps.add(ex);
+                }
+            }
+
+            boolean updated = false; // has the expression been modified?
+
+            // evaluate the impact of each Equal over the different types of Expressions
+            for (Iterator<Equals> iterEq = equals.iterator(); iterEq.hasNext(); ) {
+                Equals eq = iterEq.next();
+                Object eqValue = eq.right().fold();
+                boolean removeEquals = false;
+
+                // Equals OR NotEquals
+                for (NotEquals neq : notEquals) {
+                    if (eq.left().semanticEquals(neq.left())) { // a = 2 OR a != ? -> ...
+                        Integer comp = BinaryComparison.compare(eqValue, neq.right().fold());
+                        if (comp != null) {
+                            if (comp == 0) { // a = 2 OR a != 2 -> TRUE
+                                return TRUE;
+                            } else { // a = 2 OR a != 5 -> a != 5
+                                removeEquals = true;
+                                break;
+                            }
+                        }
+                    }
+                }
+                if (removeEquals) {
+                    iterEq.remove();
+                    updated = true;
+                    continue;
+                }
+
+                // Equals OR Range
+                for (int i = 0; i < ranges.size(); i ++) { // might modify list, so use index loop
+                    Range range = ranges.get(i);
+                    if (eq.left().semanticEquals(range.value())) {
+                        Integer lowerComp = range.lower().foldable() ? BinaryComparison.compare(eqValue, range.lower().fold()) : null;
+                        Integer upperComp = range.upper().foldable() ? BinaryComparison.compare(eqValue, range.upper().fold()) : null;
+
+                        if (lowerComp != null && lowerComp == 0) {
+                            if (!range.includeLower()) { // a = 2 OR 2 < a < ? -> 2 <= a < ?
+                                ranges.set(i, new Range(range.source(), range.value(), range.lower(), true,
+                                    range.upper(), range.includeUpper()));
+                            } // else : a = 2 OR 2 <= a < ? -> 2 <= a < ?
+                            removeEquals = true; // update range with lower equality instead or simply superfluous
+                            break;
+                        } else if (upperComp != null && upperComp == 0) {
+                            if (!range.includeUpper()) { // a = 2 OR ? < a < 2 -> ? < a <= 2
+                                ranges.set(i, new Range(range.source(), range.value(), range.lower(), range.includeLower(),
+                                    range.upper(), true));
+                            } // else : a = 2 OR ? < a <= 2 -> ? < a <= 2
+                            removeEquals = true; // update range with upper equality instead
+                            break;
+                        } else if (lowerComp != null && upperComp != null) {
+                            if (0 < lowerComp && upperComp < 0) { // a = 2 OR 1 < a < 3
+                                removeEquals = true; // equality is superfluous
+                                break;
+                            }
+                        }
+                    }
+                }
+                if (removeEquals) {
+                    iterEq.remove();
+                    updated = true;
+                    continue;
+                }
+
+                // Equals OR Inequality
+                for (int i = 0; i < inequalities.size(); i ++) {
+                    BinaryComparison bc = inequalities.get(i);
+                    if (eq.left().semanticEquals(bc.left())) {
+                        Integer comp = BinaryComparison.compare(eqValue, bc.right().fold());
+                        if (comp != null) {
+                            if (bc instanceof GreaterThan || bc instanceof GreaterThanOrEqual) {
+                                if (comp < 0) { // a = 1 OR a > 2 -> nop
+                                    continue;
+                                } else if (comp == 0 && bc instanceof GreaterThan) { // a = 2 OR a > 2 -> a >= 2
+                                    inequalities.set(i, new GreaterThanOrEqual(bc.source(), bc.left(), bc.right()));
+                                } // else (0 < comp || bc instanceof GreaterThanOrEqual) :
+                                // a = 3 OR a > 2 -> a > 2; a = 2 OR a => 2 -> a => 2
+
+                                removeEquals = true; // update range with equality instead or simply superfluous
+                                break;
+                            } else if (bc instanceof LessThan || bc instanceof LessThanOrEqual) {
+                                if (comp > 0) { // a = 2 OR a < 1 -> nop
+                                    continue;
+                                }
+                                if (comp == 0 && bc instanceof LessThan) { // a = 2 OR a < 2 -> a <= 2
+                                    inequalities.set(i, new LessThanOrEqual(bc.source(), bc.left(), bc.right()));
+                                } // else (comp < 0 || bc instanceof LessThanOrEqual) : a = 2 OR a < 3 -> a < 3; a = 2 OR a <= 2 -> a <= 2
+                                removeEquals = true; // update range with equality instead or simply superfluous
+                                break;
+                            }
+                        }
+                    }
+                }
+                if (removeEquals) {
+                    iterEq.remove();
+                    updated = true;
+                }
             }
 
-            return changed ? Predicates.combineAnd(CollectionUtils.combine(exps, equals, ranges)) : and;
+            return updated ? Predicates.combineOr(CollectionUtils.combine(exps, equals, notEquals, inequalities, ranges)) : or;
         }
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
index 349c644fb43f7..860b759bb8f3f 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/optimizer/OptimizerTests.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.xpack.ql.expression.function.aggregate.AggregateFunction;
 import org.elasticsearch.xpack.ql.expression.function.aggregate.InnerAggregate;
 import org.elasticsearch.xpack.ql.expression.predicate.BinaryOperator;
+import org.elasticsearch.xpack.ql.expression.predicate.Predicates;
 import org.elasticsearch.xpack.ql.expression.predicate.Range;
 import org.elasticsearch.xpack.ql.expression.predicate.conditional.ArbitraryConditionalFunction;
 import org.elasticsearch.xpack.ql.expression.predicate.conditional.Case;
@@ -1550,6 +1551,251 @@ public void testEliminateRangeByNullEqualsOutsideInterval() {
         assertEquals(FALSE, rule.rule(exp));
     }
 
+    // a != 3 AND a = 3 -> FALSE
+    public void testPropagateEquals_VarNeq3AndVarEq3() {
+        FieldAttribute fa = getFieldAttribute();
+        NotEquals neq = new NotEquals(EMPTY, fa, THREE);
+        Equals eq = new Equals(EMPTY, fa, THREE);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new And(EMPTY, neq, eq));
+        assertEquals(FALSE, rule.rule(exp));
+    }
+
+    // a != 4 AND a = 3 -> a = 3
+    public void testPropagateEquals_VarNeq4AndVarEq3() {
+        FieldAttribute fa = getFieldAttribute();
+        NotEquals neq = new NotEquals(EMPTY, fa, FOUR);
+        Equals eq = new Equals(EMPTY, fa, THREE);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new And(EMPTY, neq, eq));
+        assertEquals(Equals.class, exp.getClass());
+        assertEquals(eq, rule.rule(exp));
+    }
+
+    // a = 2 AND a < 2 -> FALSE
+    public void testPropagateEquals_VarEq2AndVarLt2() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        LessThan lt = new LessThan(EMPTY, fa, TWO);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new And(EMPTY, eq, lt));
+        assertEquals(FALSE, exp);
+    }
+
+    // a = 2 AND a <= 2 -> a = 2
+    public void testPropagateEquals_VarEq2AndVarLte2() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        LessThanOrEqual lt = new LessThanOrEqual(EMPTY, fa, TWO);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new And(EMPTY, eq, lt));
+        assertEquals(eq, exp);
+    }
+
+    // a = 2 AND a <= 1 -> FALSE
+    public void testPropagateEquals_VarEq2AndVarLte1() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        LessThanOrEqual lt = new LessThanOrEqual(EMPTY, fa, ONE);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new And(EMPTY, eq, lt));
+        assertEquals(FALSE, exp);
+    }
+
+    // a = 2 AND a > 2 -> FALSE
+    public void testPropagateEquals_VarEq2AndVarGt2() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        GreaterThan gt = new GreaterThan(EMPTY, fa, TWO);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new And(EMPTY, eq, gt));
+        assertEquals(FALSE, exp);
+    }
+
+    // a = 2 AND a >= 2 -> a = 2
+    public void testPropagateEquals_VarEq2AndVarGte2() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        GreaterThanOrEqual gte = new GreaterThanOrEqual(EMPTY, fa, TWO);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new And(EMPTY, eq, gte));
+        assertEquals(eq, exp);
+    }
+
+    // a = 2 AND a > 3 -> FALSE
+    public void testPropagateEquals_VarEq2AndVarLt3() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        GreaterThan gt = new GreaterThan(EMPTY, fa, THREE);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new And(EMPTY, eq, gt));
+        assertEquals(FALSE, exp);
+    }
+
+    // a = 2 AND a < 3 AND a > 1 AND a != 4 -> a = 2
+    public void testPropagateEquals_VarEq2AndVarLt3AndVarGt1AndVarNeq4() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        LessThan lt = new LessThan(EMPTY, fa, THREE);
+        GreaterThan gt = new GreaterThan(EMPTY, fa, ONE);
+        NotEquals neq = new NotEquals(EMPTY, fa, FOUR);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression and = Predicates.combineAnd(Arrays.asList(eq, lt, gt, neq));
+        Expression exp = rule.rule(and);
+        assertEquals(eq, exp);
+    }
+
+    // a = 2 AND 1 < a < 3 AND a > 0 AND a != 4 -> a = 2
+    public void testPropagateEquals_VarEq2AndVarRangeGt1Lt3AndVarGt0AndVarNeq4() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        Range range = new Range(EMPTY, fa, ONE, false, THREE, false);
+        GreaterThan gt = new GreaterThan(EMPTY, fa, L(0));
+        NotEquals neq = new NotEquals(EMPTY, fa, FOUR);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression and = Predicates.combineAnd(Arrays.asList(eq, range, gt, neq));
+        Expression exp = rule.rule(and);
+        assertEquals(eq, exp);
+    }
+
+    // a = 2 OR a > 1 -> a > 1
+    public void testPropagateEquals_VarEq2OrVarGt1() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        GreaterThan gt = new GreaterThan(EMPTY, fa, ONE);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, gt));
+        assertEquals(gt, exp);
+    }
+
+    // a = 2 OR a > 2 -> a >= 2
+    public void testPropagateEquals_VarEq2OrVarGte2() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        GreaterThan gt = new GreaterThan(EMPTY, fa, TWO);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, gt));
+        assertEquals(GreaterThanOrEqual.class, exp.getClass());
+        GreaterThanOrEqual gte = (GreaterThanOrEqual) exp;
+        assertEquals(TWO, gte.right());
+    }
+
+    // a = 2 OR a < 3 -> a < 3
+    public void testPropagateEquals_VarEq2OrVarLt3() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        LessThan lt = new LessThan(EMPTY, fa, THREE);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, lt));
+        assertEquals(lt, exp);
+    }
+
+    // a = 3 OR a < 3 -> a <= 3
+    public void testPropagateEquals_VarEq3OrVarLt3() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, THREE);
+        LessThan lt = new LessThan(EMPTY, fa, THREE);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, lt));
+        assertEquals(LessThanOrEqual.class, exp.getClass());
+        LessThanOrEqual lte = (LessThanOrEqual) exp;
+        assertEquals(THREE, lte.right());
+    }
+
+    // a = 2 OR 1 < a < 3 -> 1 < a < 3
+    public void testPropagateEquals_VarEq2OrVarRangeGt1Lt3() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        Range range = new Range(EMPTY, fa, ONE, false, THREE, false);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, range));
+        assertEquals(range, exp);
+    }
+
+    // a = 2 OR 2 < a < 3 -> 2 <= a < 3
+    public void testPropagateEquals_VarEq2OrVarRangeGt2Lt3() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        Range range = new Range(EMPTY, fa, TWO, false, THREE, false);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, range));
+        assertEquals(Range.class, exp.getClass());
+        Range r = (Range) exp;
+        assertEquals(TWO, r.lower());
+        assertTrue(r.includeLower());
+        assertEquals(THREE, r.upper());
+        assertFalse(r.includeUpper());
+    }
+
+    // a = 3 OR 2 < a < 3 -> 2 < a <= 3
+    public void testPropagateEquals_VarEq3OrVarRangeGt2Lt3() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, THREE);
+        Range range = new Range(EMPTY, fa, TWO, false, THREE, false);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, range));
+        assertEquals(Range.class, exp.getClass());
+        Range r = (Range) exp;
+        assertEquals(TWO, r.lower());
+        assertFalse(r.includeLower());
+        assertEquals(THREE, r.upper());
+        assertTrue(r.includeUpper());
+    }
+
+    // a = 2 OR a != 2 -> TRUE
+    public void testPropagateEquals_VarEq2OrVarNeq2() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        NotEquals neq = new NotEquals(EMPTY, fa, TWO);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, neq));
+        assertEquals(TRUE, exp);
+    }
+
+    // a = 2 OR a != 5 -> a != 5
+    public void testPropagateEquals_VarEq2OrVarNeq5() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        NotEquals neq = new NotEquals(EMPTY, fa, FIVE);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(new Or(EMPTY, eq, neq));
+        assertEquals(NotEquals.class, exp.getClass());
+        NotEquals ne = (NotEquals) exp;
+        assertEquals(ne.right(), FIVE);
+    }
+
+    // a = 2 OR 3 < a < 4 OR a > 2 OR a!= 2 -> TRUE
+    public void testPropagateEquals_VarEq2OrVarRangeGt3Lt4OrVarGt2OrVarNe2() {
+        FieldAttribute fa = getFieldAttribute();
+        Equals eq = new Equals(EMPTY, fa, TWO);
+        Range range = new Range(EMPTY, fa, THREE, false, FOUR, false);
+        GreaterThan gt = new GreaterThan(EMPTY, fa, TWO);
+        NotEquals neq = new NotEquals(EMPTY, fa, TWO);
+
+        PropagateEquals rule = new PropagateEquals();
+        Expression exp = rule.rule(Predicates.combineOr(Arrays.asList(eq, range, neq, gt)));
+        assertEquals(TRUE, exp);
+    }
+
     public void testTranslateMinToFirst() {
         Min min1 =  new Min(EMPTY, new FieldAttribute(EMPTY, "str", new EsField("str", DataType.KEYWORD, emptyMap(), true)));
         Min min2 =  new Min(EMPTY, getFieldAttribute());

From da6ed28eb0aae665e7b4a628e7498d43d5c6f015 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Tue, 14 Jan 2020 09:00:26 -0800
Subject: [PATCH 566/686] [DOCS] Fix realm chains example (#50568)

---
 .../authentication/realm-chains.asciidoc      | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/x-pack/docs/en/security/authentication/realm-chains.asciidoc b/x-pack/docs/en/security/authentication/realm-chains.asciidoc
index 314c9dbe491d0..a7d7166239aac 100644
--- a/x-pack/docs/en/security/authentication/realm-chains.asciidoc
+++ b/x-pack/docs/en/security/authentication/realm-chains.asciidoc
@@ -34,32 +34,25 @@ The following snippet configures a realm chain that includes the `file` and
 
 [source,yaml]
 ----------------------------------------
-xpack.security.authc:
-  realms:
-
-    file:
-      type: file
+xpack.security.authc.realms:
+  file.file1:
       order: 0
 
-    native:
-      type: native
+  native.native1:
       order: 1
 
-    ldap1:
-      type: ldap
+  ldap.ldap1:
       order: 2
       enabled: false
       url: 'url_to_ldap1'
       ...
 
-    ldap2:
-      type: ldap
+  ldap.ldap2:
       order: 3
       url: 'url_to_ldap2'
       ...
 
-    ad1:
-      type: active_directory
+  active_directory.ad1:
       order: 4
       url: 'url_to_ad'
 ----------------------------------------

From 610c4ee9464467d870985144c255d25cd3fc52ac Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Tue, 14 Jan 2020 12:12:20 -0500
Subject: [PATCH 567/686] Allow installing multiple plugins as a transaction
 (#50924)

This commit allows the plugin installer to install multiple plugins in a
single invocation. The installation will be treated as a transaction, so
that all of the plugins are install successfully, or none of the plugins
are installed.
---
 .../plugins/InstallPluginCommand.java         | 63 +++++++++++--------
 .../plugins/InstallPluginCommandTests.java    | 50 +++++++++++++--
 docs/plugins/plugin-script.asciidoc           | 26 ++++++++
 3 files changed, 108 insertions(+), 31 deletions(-)

diff --git a/distribution/tools/plugin-cli/src/main/java/org/elasticsearch/plugins/InstallPluginCommand.java b/distribution/tools/plugin-cli/src/main/java/org/elasticsearch/plugins/InstallPluginCommand.java
index f404f941168d7..9205c248e519e 100644
--- a/distribution/tools/plugin-cli/src/main/java/org/elasticsearch/plugins/InstallPluginCommand.java
+++ b/distribution/tools/plugin-cli/src/main/java/org/elasticsearch/plugins/InstallPluginCommand.java
@@ -206,24 +206,50 @@ protected void printAdditionalHelp(Terminal terminal) {
 
     @Override
     protected void execute(Terminal terminal, OptionSet options, Environment env) throws Exception {
-        String pluginId = arguments.value(options);
+        List<String> pluginId = arguments.values(options);
         final boolean isBatch = options.has(batchOption);
         execute(terminal, pluginId, isBatch, env);
     }
 
     // pkg private for testing
-    void execute(Terminal terminal, String pluginId, boolean isBatch, Environment env) throws Exception {
-        if (pluginId == null) {
-            throw new UserException(ExitCodes.USAGE, "plugin id is required");
+    void execute(Terminal terminal, List<String> pluginIds, boolean isBatch, Environment env) throws Exception {
+        if (pluginIds.isEmpty()) {
+            throw new UserException(ExitCodes.USAGE, "at least one plugin id is required");
         }
 
-        if ("x-pack".equals(pluginId)) {
-            handleInstallXPack(buildFlavor());
+        final Set<String> uniquePluginIds = new HashSet<>();
+        for (final String pluginId : pluginIds) {
+            if (uniquePluginIds.add(pluginId) == false) {
+                throw new UserException(ExitCodes.USAGE, "duplicate plugin id [" + pluginId + "]");
+            }
+        }
+
+        final List<Path> deleteOnFailure = new ArrayList<>();
+        final Set<PluginInfo> pluginInfos = new HashSet<>();
+        for (final String pluginId : pluginIds) {
+            try {
+                if ("x-pack".equals(pluginId)) {
+                    handleInstallXPack(buildFlavor());
+                }
+
+                final Path pluginZip = download(terminal, pluginId, env.tmpFile(), isBatch);
+                final Path extractedZip = unzip(pluginZip, env.pluginsFile());
+                deleteOnFailure.add(extractedZip);
+                final PluginInfo pluginInfo = installPlugin(terminal, isBatch, extractedZip, env, deleteOnFailure);
+                pluginInfos.add(pluginInfo);
+            } catch (final Exception installProblem) {
+                try {
+                    IOUtils.rm(deleteOnFailure.toArray(new Path[0]));
+                } catch (final IOException exceptionWhileRemovingFiles) {
+                    installProblem.addSuppressed(exceptionWhileRemovingFiles);
+                }
+                throw installProblem;
+            }
         }
 
-        Path pluginZip = download(terminal, pluginId, env.tmpFile(), isBatch);
-        Path extractedZip = unzip(pluginZip, env.pluginsFile());
-        install(terminal, isBatch, extractedZip, env);
+        for (final PluginInfo pluginInfo : pluginInfos) {
+            terminal.println("-> Installed " + pluginInfo.getName());
+        }
     }
 
     Build.Flavor buildFlavor() {
@@ -773,26 +799,11 @@ void jarHellCheck(PluginInfo candidateInfo, Path candidateDir, Path pluginsDir,
         // TODO: verify the classname exists in one of the jars!
     }
 
-    private void install(Terminal terminal, boolean isBatch, Path tmpRoot, Environment env) throws Exception {
-        List<Path> deleteOnFailure = new ArrayList<>();
-        deleteOnFailure.add(tmpRoot);
-        try {
-            installPlugin(terminal, isBatch, tmpRoot, env, deleteOnFailure);
-        } catch (Exception installProblem) {
-            try {
-                IOUtils.rm(deleteOnFailure.toArray(new Path[0]));
-            } catch (IOException exceptionWhileRemovingFiles) {
-                installProblem.addSuppressed(exceptionWhileRemovingFiles);
-            }
-            throw installProblem;
-        }
-    }
-
     /**
      * Installs the plugin from {@code tmpRoot} into the plugins dir.
      * If the plugin has a bin dir and/or a config dir, those are moved.
      */
-    private void installPlugin(Terminal terminal, boolean isBatch, Path tmpRoot,
+    private PluginInfo installPlugin(Terminal terminal, boolean isBatch, Path tmpRoot,
                                Environment env, List<Path> deleteOnFailure) throws Exception {
         final PluginInfo info = loadPluginInfo(terminal, tmpRoot, env);
         // read optional security policy (extra permissions), if it exists, confirm or warn the user
@@ -811,7 +822,7 @@ private void installPlugin(Terminal terminal, boolean isBatch, Path tmpRoot,
         installPluginSupportFiles(info, tmpRoot, env.binFile().resolve(info.getName()),
                                   env.configFile().resolve(info.getName()), deleteOnFailure);
         movePlugin(tmpRoot, destination);
-        terminal.println("-> Installed " + info.getName());
+        return info;
     }
 
     /** Moves bin and config directories from the plugin if they exist */
diff --git a/distribution/tools/plugin-cli/src/test/java/org/elasticsearch/plugins/InstallPluginCommandTests.java b/distribution/tools/plugin-cli/src/test/java/org/elasticsearch/plugins/InstallPluginCommandTests.java
index 45fbd3133d175..6822f07d4c10f 100644
--- a/distribution/tools/plugin-cli/src/test/java/org/elasticsearch/plugins/InstallPluginCommandTests.java
+++ b/distribution/tools/plugin-cli/src/test/java/org/elasticsearch/plugins/InstallPluginCommandTests.java
@@ -64,6 +64,7 @@
 import java.io.BufferedReader;
 import java.io.ByteArrayInputStream;
 import java.io.ByteArrayOutputStream;
+import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.StringReader;
@@ -280,9 +281,17 @@ void installPlugin(String pluginUrl, Path home) throws Exception {
         installPlugin(pluginUrl, home, skipJarHellCommand);
     }
 
+    void installPlugins(final List<String> pluginUrls, final Path home) throws Exception {
+        installPlugins(pluginUrls, home, skipJarHellCommand);
+    }
+
     void installPlugin(String pluginUrl, Path home, InstallPluginCommand command) throws Exception {
-        Environment env = TestEnvironment.newEnvironment(Settings.builder().put("path.home", home).build());
-        command.execute(terminal, pluginUrl, false, env);
+        installPlugins(pluginUrl == null ? List.of() : List.of(pluginUrl), home, command);
+    }
+
+    void installPlugins(final List<String> pluginUrls, final Path home, final InstallPluginCommand command) throws Exception {
+        final Environment env = TestEnvironment.newEnvironment(Settings.builder().put("path.home", home).build());
+        command.execute(terminal, pluginUrls, false, env);
     }
 
     void assertPlugin(String name, Path original, Environment env) throws IOException {
@@ -382,7 +391,7 @@ void assertInstallCleaned(Environment env) throws IOException {
     public void testMissingPluginId() throws IOException {
         final Tuple<Path, Environment> env = createEnv(fs, temp);
         final UserException e = expectThrows(UserException.class, () -> installPlugin(null, env.v1()));
-        assertTrue(e.getMessage(), e.getMessage().contains("plugin id is required"));
+        assertTrue(e.getMessage(), e.getMessage().contains("at least one plugin id is required"));
     }
 
     public void testSomethingWorks() throws Exception {
@@ -393,6 +402,37 @@ public void testSomethingWorks() throws Exception {
         assertPlugin("fake", pluginDir, env.v2());
     }
 
+    public void testMultipleWorks() throws Exception {
+        Tuple<Path, Environment> env = createEnv(fs, temp);
+        Path pluginDir = createPluginDir(temp);
+        String fake1PluginZip = createPluginUrl("fake1", pluginDir);
+        String fake2PluginZip = createPluginUrl("fake2", pluginDir);
+        installPlugins(List.of(fake1PluginZip, fake2PluginZip), env.v1());
+        assertPlugin("fake1", pluginDir, env.v2());
+        assertPlugin("fake2", pluginDir, env.v2());
+    }
+
+    public void testDuplicateInstall() throws Exception {
+        Tuple<Path, Environment> env = createEnv(fs, temp);
+        Path pluginDir = createPluginDir(temp);
+        String pluginZip = createPluginUrl("fake", pluginDir);
+        final UserException e = expectThrows(UserException.class, () -> installPlugins(List.of(pluginZip, pluginZip), env.v1()));
+        assertThat(e, hasToString(containsString("duplicate plugin id [" + pluginZip + "]")));
+    }
+
+    public void testTransaction() throws Exception {
+        Tuple<Path, Environment> env = createEnv(fs, temp);
+        Path pluginDir = createPluginDir(temp);
+        String pluginZip = createPluginUrl("fake", pluginDir);
+        final FileNotFoundException e =
+            expectThrows(FileNotFoundException.class, () -> installPlugins(List.of(pluginZip, pluginZip + "does-not-exist"), env.v1()));
+        assertThat(e, hasToString(containsString("does-not-exist")));
+        final Path fakeInstallPath = env.v2().pluginsFile().resolve("fake");
+        // fake should have been removed when the file not found exception occurred
+        assertFalse(Files.exists(fakeInstallPath));
+        assertInstallCleaned(env.v2());
+    }
+
     public void testInstallFailsIfPreviouslyRemovedPluginFailed() throws Exception {
         Tuple<Path, Environment> env = createEnv(fs, temp);
         Path pluginDir = createPluginDir(temp);
@@ -769,7 +809,7 @@ Build.Flavor buildFlavor() {
         };
 
         final Environment environment = createEnv(fs, temp).v2();
-        final T exception = expectThrows(clazz, () -> flavorCommand.execute(terminal, "x-pack", false, environment));
+        final T exception = expectThrows(clazz, () -> flavorCommand.execute(terminal, List.of("x-pack"), false, environment));
         assertThat(exception, hasToString(containsString(expectedMessage)));
     }
 
@@ -830,7 +870,7 @@ private void installPlugin(MockTerminal terminal, boolean isBatch) throws Except
             writePluginSecurityPolicy(pluginDir, "setFactory");
         }
         String pluginZip = createPlugin("fake", pluginDir).toUri().toURL().toString();
-        skipJarHellCommand.execute(terminal, pluginZip, isBatch, env.v2());
+        skipJarHellCommand.execute(terminal, List.of(pluginZip), isBatch, env.v2());
     }
 
     void assertInstallPluginFromUrl(
diff --git a/docs/plugins/plugin-script.asciidoc b/docs/plugins/plugin-script.asciidoc
index f7906a0be50ec..37bc8b6e66557 100644
--- a/docs/plugins/plugin-script.asciidoc
+++ b/docs/plugins/plugin-script.asciidoc
@@ -106,6 +106,32 @@ sudo ES_JAVA_OPTS="-Djavax.net.ssl.trustStore=/path/to/trustStore.jks" bin/elast
 -----------------------------------
 --
 
+[[installing-multiple-plugins]]
+=== Installing multiple plugins
+
+Multiple plugins can be installed in one invocation as follows:
+
+[source,shell]
+-----------------------------------
+sudo bin/elasticsearch-plugin install [plugin_id] [plugin_id] ... [plugin_id]
+-----------------------------------
+
+Each `plugin_id` can be any valid form for installing a single plugin (e.g., the
+name of a core plugin, or a custom URL).
+
+For instance, to install the core <<analysis-icu,ICU plugin>>, and
+<<repository-s3,S3 repository plugin>> run the following command:
+
+[source,shell]
+-----------------------------------
+sudo bin/elasticsearch-plugin install analysis-icu repository-s3
+-----------------------------------
+
+This command will install the versions of the plugins that matches your
+Elasticsearch version. The installation will be treated as a transaction, so
+that all the plugins will be installed, or none of the plugins will be installed
+if any installation fails.
+
 [[mandatory-plugins]]
 === Mandatory Plugins
 

From cf3551526f18d2c72a0d708b9189c0348e4b4063 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 14 Jan 2020 18:33:53 +0100
Subject: [PATCH 568/686] Remove custom metadata tool (#50813)

Adds a command-line tool to remove broken custom metadata from the cluster state.

Relates to #48701
---
 docs/reference/commands/node-tool.asciidoc    |  55 +++++++-
 .../cluster/coordination/NodeToolCli.java     |   1 +
 .../coordination/RemoveCustomsCommand.java    | 102 ++++++++++++++
 .../coordination/RemoveCustomsCommandIT.java  | 125 ++++++++++++++++++
 4 files changed, 280 insertions(+), 3 deletions(-)
 create mode 100644 server/src/main/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommand.java
 create mode 100644 server/src/test/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommandIT.java

diff --git a/docs/reference/commands/node-tool.asciidoc b/docs/reference/commands/node-tool.asciidoc
index 862420ba30b5e..f1dc24bc761a5 100644
--- a/docs/reference/commands/node-tool.asciidoc
+++ b/docs/reference/commands/node-tool.asciidoc
@@ -20,7 +20,7 @@ bin/elasticsearch-node repurpose|unsafe-bootstrap|detach-cluster|override-versio
 [float]
 === Description
 
-This tool has five modes:
+This tool has a number of modes:
 
 * `elasticsearch-node repurpose` can be used to delete unwanted data from a
   node if it used to be a <<data-node,data node>> or a
@@ -28,8 +28,12 @@ This tool has five modes:
   or other of these roles.
 
 * `elasticsearch-node remove-settings` can be used to remove persistent settings
-   from the cluster state in case where it contains incompatible settings that
-   prevent the cluster from forming.
+  from the cluster state in case where it contains incompatible settings that
+  prevent the cluster from forming.
+
+* `elasticsearch-node remove-customs` can be used to remove custom metadata
+  from the cluster state in case where it contains broken metadata that
+  prevents the cluster state from being loaded.
 
 * `elasticsearch-node unsafe-bootstrap` can be used to perform _unsafe cluster
   bootstrapping_.  It forces one of the nodes to form a brand-new cluster on
@@ -100,6 +104,24 @@ The intended use is:
 * Repeat for all other master-eligible nodes
 * Start the nodes
 
+[float]
+==== Removing custom metadata from the cluster state
+
+There may be situations where a node contains custom metadata, typically
+provided by plugins, that prevent the node from starting up and loading
+the cluster from disk.
+
+The `elasticsearch-node remove-customs` tool allows you to forcefully remove
+the problematic custom metadata. The tool takes a list of custom metadata names
+as parameters that should be removed, and also supports wildcard patterns.
+
+The intended use is:
+
+* Stop the node
+* Run `elasticsearch-node remove-customs name-of-custom-to-remove` on the node
+* Repeat for all other master-eligible nodes
+* Start the nodes
+
 [float]
 ==== Recovering data after a disaster
 
@@ -407,6 +429,33 @@ You can also use wildcards to remove multiple settings, for example using
 node$ ./bin/elasticsearch-node remove-settings xpack.monitoring.*
 ----
 
+[float]
+==== Removing custom metadata from the cluster state
+
+If the on-disk cluster state contains custom metadata that prevents the node
+from starting up and loading the cluster state, you can run the following
+commands to remove this custom metadata.
+
+[source,txt]
+----
+node$ ./bin/elasticsearch-node remove-customs snapshot_lifecycle
+
+    WARNING: Elasticsearch MUST be stopped before running this tool.
+
+The following customs will be removed:
+snapshot_lifecycle
+
+You should only run this tool if you have broken custom metadata in the
+cluster state that prevents the cluster state from being loaded.
+This tool can cause data loss and its use should be your last resort.
+
+Do you want to proceed?
+
+Confirm [y/N] y
+
+Customs were successfully removed from the cluster state
+----
+
 [float]
 ==== Unsafe cluster bootstrapping
 
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/NodeToolCli.java b/server/src/main/java/org/elasticsearch/cluster/coordination/NodeToolCli.java
index 29c03dbb8c46c..7c96f631be6dd 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/NodeToolCli.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/NodeToolCli.java
@@ -42,6 +42,7 @@ public NodeToolCli() {
         subcommands.put("detach-cluster", new DetachClusterCommand());
         subcommands.put("override-version", new OverrideNodeVersionCommand());
         subcommands.put("remove-settings", new RemoveSettingsCommand());
+        subcommands.put("remove-customs", new RemoveCustomsCommand());
     }
 
     public static void main(String[] args) throws Exception {
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommand.java
new file mode 100644
index 0000000000000..82bcd4f3db484
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommand.java
@@ -0,0 +1,102 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.cluster.coordination;
+
+import com.carrotsearch.hppc.cursors.ObjectCursor;
+import joptsimple.OptionSet;
+import joptsimple.OptionSpec;
+import org.elasticsearch.cli.ExitCodes;
+import org.elasticsearch.cli.Terminal;
+import org.elasticsearch.cli.UserException;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.common.collect.Tuple;
+import org.elasticsearch.common.regex.Regex;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.gateway.PersistedClusterStateService;
+
+import java.io.IOException;
+import java.nio.file.Path;
+import java.util.List;
+
+public class RemoveCustomsCommand extends ElasticsearchNodeCommand {
+
+    static final String CUSTOMS_REMOVED_MSG = "Customs were successfully removed from the cluster state";
+    static final String CONFIRMATION_MSG =
+        DELIMITER +
+            "\n" +
+            "You should only run this tool if you have broken custom metadata in the\n" +
+            "cluster state that prevents the cluster state from being loaded.\n" +
+            "This tool can cause data loss and its use should be your last resort.\n" +
+            "\n" +
+            "Do you want to proceed?\n";
+
+    private final OptionSpec<String> arguments;
+
+    public RemoveCustomsCommand() {
+        super("Removes custom metadata from the cluster state");
+        arguments = parser.nonOptions("custom metadata names");
+    }
+
+    @Override
+    protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet options, Environment env)
+        throws IOException, UserException {
+        final List<String> customsToRemove = arguments.values(options);
+        if (customsToRemove.isEmpty()) {
+            throw new UserException(ExitCodes.USAGE, "Must supply at least one custom metadata name to remove");
+        }
+
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+
+        terminal.println(Terminal.Verbosity.VERBOSE, "Loading cluster state");
+        final Tuple<Long, ClusterState> termAndClusterState = loadTermAndClusterState(persistedClusterStateService, env);
+        final ClusterState oldClusterState = termAndClusterState.v2();
+        terminal.println(Terminal.Verbosity.VERBOSE, "custom metadata names: " + oldClusterState.metaData().customs().keys());
+        final MetaData.Builder metaDataBuilder = MetaData.builder(oldClusterState.metaData());
+        for (String customToRemove : customsToRemove) {
+            boolean matched = false;
+            for (ObjectCursor<String> customKeyCur : oldClusterState.metaData().customs().keys()) {
+                final String customKey = customKeyCur.value;
+                if (Regex.simpleMatch(customToRemove, customKey)) {
+                    metaDataBuilder.removeCustom(customKey);
+                    if (matched == false) {
+                        terminal.println("The following customs will be removed:");
+                    }
+                    matched = true;
+                    terminal.println(customKey);
+                }
+            }
+            if (matched == false) {
+                throw new UserException(ExitCodes.USAGE,
+                    "No custom metadata matching [" + customToRemove + "] were found on this node");
+            }
+        }
+        final ClusterState newClusterState = ClusterState.builder(oldClusterState).metaData(metaDataBuilder.build()).build();
+        terminal.println(Terminal.Verbosity.VERBOSE,
+            "[old cluster state = " + oldClusterState + ", new cluster state = " + newClusterState + "]");
+
+        confirm(terminal, CONFIRMATION_MSG);
+
+        try (PersistedClusterStateService.Writer writer = persistedClusterStateService.createWriter()) {
+            writer.writeFullStateAndCommit(termAndClusterState.v1(), newClusterState);
+        }
+
+        terminal.println(CUSTOMS_REMOVED_MSG);
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommandIT.java b/server/src/test/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommandIT.java
new file mode 100644
index 0000000000000..867f05131f654
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommandIT.java
@@ -0,0 +1,125 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.cluster.coordination;
+
+import joptsimple.OptionSet;
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.cli.MockTerminal;
+import org.elasticsearch.cli.UserException;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.env.TestEnvironment;
+import org.elasticsearch.test.ESIntegTestCase;
+
+import static org.hamcrest.Matchers.containsString;
+
+@ESIntegTestCase.ClusterScope(scope = ESIntegTestCase.Scope.TEST, numDataNodes = 0, autoManageMasterNodes = false)
+public class RemoveCustomsCommandIT extends ESIntegTestCase {
+
+    public void testRemoveCustomsAbortedByUser() throws Exception {
+        internalCluster().setBootstrapMasterNodeIndex(0);
+        String node = internalCluster().startNode();
+        Settings dataPathSettings = internalCluster().dataPathSettings(node);
+        ensureStableCluster(1);
+        internalCluster().stopRandomDataNode();
+
+        Environment environment = TestEnvironment.newEnvironment(
+            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
+        expectThrows(() -> removeCustoms(environment, true, new String[]{ "index-graveyard" }),
+            ElasticsearchNodeCommand.ABORTED_BY_USER_MSG);
+    }
+
+    public void testRemoveCustomsSuccessful() throws Exception {
+        internalCluster().setBootstrapMasterNodeIndex(0);
+        String node = internalCluster().startNode();
+        createIndex("test");
+        client().admin().indices().prepareDelete("test").get();
+        assertEquals(1, client().admin().cluster().prepareState().get().getState().metaData().indexGraveyard().getTombstones().size());
+        Settings dataPathSettings = internalCluster().dataPathSettings(node);
+        ensureStableCluster(1);
+        internalCluster().stopRandomDataNode();
+
+        Environment environment = TestEnvironment.newEnvironment(
+            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
+        MockTerminal terminal = removeCustoms(environment, false,
+            randomBoolean() ?
+                new String[]{ "index-graveyard" } :
+                new String[]{ "index-*" }
+            );
+        assertThat(terminal.getOutput(), containsString(RemoveCustomsCommand.CUSTOMS_REMOVED_MSG));
+        assertThat(terminal.getOutput(), containsString("The following customs will be removed:"));
+        assertThat(terminal.getOutput(), containsString("index-graveyard"));
+
+        internalCluster().startNode(dataPathSettings);
+        assertEquals(0, client().admin().cluster().prepareState().get().getState().metaData().indexGraveyard().getTombstones().size());
+    }
+
+    public void testCustomDoesNotMatch() throws Exception {
+        internalCluster().setBootstrapMasterNodeIndex(0);
+        String node = internalCluster().startNode();
+        createIndex("test");
+        client().admin().indices().prepareDelete("test").get();
+        assertEquals(1, client().admin().cluster().prepareState().get().getState().metaData().indexGraveyard().getTombstones().size());
+        Settings dataPathSettings = internalCluster().dataPathSettings(node);
+        ensureStableCluster(1);
+        internalCluster().stopRandomDataNode();
+
+        Environment environment = TestEnvironment.newEnvironment(
+            Settings.builder().put(internalCluster().getDefaultSettings()).put(dataPathSettings).build());
+        UserException ex = expectThrows(UserException.class, () -> removeCustoms(environment, false,
+            new String[]{ "index-greveyard-with-typos" }));
+        assertThat(ex.getMessage(), containsString("No custom metadata matching [index-greveyard-with-typos] were " +
+            "found on this node"));
+    }
+
+    private MockTerminal executeCommand(ElasticsearchNodeCommand command, Environment environment, boolean abort, String... args)
+        throws Exception {
+        final MockTerminal terminal = new MockTerminal();
+        final OptionSet options = command.getParser().parse(args);
+        final String input;
+
+        if (abort) {
+            input = randomValueOtherThanMany(c -> c.equalsIgnoreCase("y"), () -> randomAlphaOfLength(1));
+        } else {
+            input = randomBoolean() ? "y" : "Y";
+        }
+
+        terminal.addTextInput(input);
+
+        try {
+            command.execute(terminal, options, environment);
+        } finally {
+            assertThat(terminal.getOutput(), containsString(ElasticsearchNodeCommand.STOP_WARNING_MSG));
+        }
+
+        return terminal;
+    }
+
+    private MockTerminal removeCustoms(Environment environment, boolean abort, String... args) throws Exception {
+        final MockTerminal terminal = executeCommand(new RemoveCustomsCommand(), environment, abort, args);
+        assertThat(terminal.getOutput(), containsString(RemoveCustomsCommand.CONFIRMATION_MSG));
+        assertThat(terminal.getOutput(), containsString(RemoveCustomsCommand.CUSTOMS_REMOVED_MSG));
+        return terminal;
+    }
+
+    private void expectThrows(ThrowingRunnable runnable, String message) {
+        ElasticsearchException ex = expectThrows(ElasticsearchException.class, runnable);
+        assertThat(ex.getMessage(), containsString(message));
+    }
+}

From 00b11b95b8dfc16a22bc8cdbb06e6ecd93223532 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Tue, 14 Jan 2020 18:42:37 +0100
Subject: [PATCH 569/686] Fix compilation for #50813

Bad interaction with other recently merged PR.
---
 .../cluster/coordination/RemoveCustomsCommand.java              | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommand.java b/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommand.java
index 82bcd4f3db484..923c6721f9131 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommand.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/RemoveCustomsCommand.java
@@ -62,7 +62,7 @@ protected void processNodePaths(Terminal terminal, Path[] dataPaths, OptionSet o
             throw new UserException(ExitCodes.USAGE, "Must supply at least one custom metadata name to remove");
         }
 
-        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(dataPaths);
+        final PersistedClusterStateService persistedClusterStateService = createPersistedClusterStateService(env.settings(), dataPaths);
 
         terminal.println(Terminal.Verbosity.VERBOSE, "Loading cluster state");
         final Tuple<Long, ClusterState> termAndClusterState = loadTermAndClusterState(persistedClusterStateService, env);

From 1c45ebd532a05859864297d2f06a68ae582090aa Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Tue, 14 Jan 2020 09:53:46 -0800
Subject: [PATCH 570/686] Add matrix job params as build scan tag

Signed-off-by: Mark Vieira <portugee@gmail.com>
---
 gradle/build-scan.gradle | 1 +
 1 file changed, 1 insertion(+)

diff --git a/gradle/build-scan.gradle b/gradle/build-scan.gradle
index 4281b794e760f..7ce2b136a20e6 100644
--- a/gradle/build-scan.gradle
+++ b/gradle/build-scan.gradle
@@ -40,6 +40,7 @@ buildScan {
     if (splitJobName.length > 1 && splitJobName.last() ==~ /^([a-zA-Z0-9_\-]+=[a-zA-Z0-9_\-]+,?)+$/) {
       def baseJobName = splitJobName.dropRight(1).join('/')
       tag baseJobName
+      tag splitJobName.last()
       value 'Job Name', baseJobName
       def matrixParams = splitJobName.last().split(',')
       matrixParams.collect { it.split('=') }.each { param ->

From 07b8e85e08dd49dc1ef87b882f27871fdd11b698 Mon Sep 17 00:00:00 2001
From: Tal Levy <JubBoy333@gmail.com>
Date: Tue, 14 Jan 2020 11:18:25 -0800
Subject: [PATCH 571/686] Disable BWC tests until #50996 is merged (#51002)

---
 build.gradle | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/build.gradle b/build.gradle
index b03bb7e5a3794..b8c19c8f4373f 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = true
-final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = false
+final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/50996" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")

From 10eb0e3ecd13945b5eb6feae0e101698e1e9b978 Mon Sep 17 00:00:00 2001
From: lcawl <lcawley@elastic.co>
Date: Tue, 14 Jan 2020 11:56:08 -0800
Subject: [PATCH 572/686] [DOCS] Fixes typo in keystore command

---
 docs/reference/commands/keystore.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/commands/keystore.asciidoc b/docs/reference/commands/keystore.asciidoc
index f9ce718d3b35f..7b2df6ee24c77 100644
--- a/docs/reference/commands/keystore.asciidoc
+++ b/docs/reference/commands/keystore.asciidoc
@@ -48,7 +48,7 @@ for the value of the setting.
 
 `list`:: Lists the settings in the keystore.
 
-`remove <setting>:: Removes a setting from the keystore.
+`remove <setting>`:: Removes a setting from the keystore.
 
 `-s, --silent`:: Shows minimal output.
 

From d976f312388589a6e47515b9898dcbe6c5b2ba5f Mon Sep 17 00:00:00 2001
From: Tal Levy <JubBoy333@gmail.com>
Date: Tue, 14 Jan 2020 12:08:11 -0800
Subject: [PATCH 573/686] re-enable bwc tests and update geo-grid bounds
 version guard to 7.6 after #50996 (#50997)

after #50996 (backport of #50002) merged, the version guard
on geo-grid `bounds` parameter can be updated to 7.6

re-enables bwc tests
---
 build.gradle                                                  | 4 ++--
 .../bucket/composite/GeoTileGridValuesSourceBuilder.java      | 4 ++--
 .../bucket/geogrid/GeoGridAggregationBuilder.java             | 4 ++--
 .../search/aggregations/bucket/GeoHashGridTests.java          | 4 ++--
 .../search/aggregations/bucket/GeoTileGridTests.java          | 4 ++--
 .../bucket/composite/GeoTileGridValuesSourceBuilderTests.java | 4 ++--
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/build.gradle b/build.gradle
index b8c19c8f4373f..b03bb7e5a3794 100644
--- a/build.gradle
+++ b/build.gradle
@@ -205,8 +205,8 @@ task verifyVersions {
  * after the backport of the backcompat code is complete.
  */
 
-boolean bwc_tests_enabled = false
-final String bwc_tests_disabled_issue = "https://github.com/elastic/elasticsearch/pull/50996" /* place a PR link here when committing bwc changes */
+boolean bwc_tests_enabled = true
+final String bwc_tests_disabled_issue = "" /* place a PR link here when committing bwc changes */
 if (bwc_tests_enabled == false) {
   if (bwc_tests_disabled_issue.isEmpty()) {
     throw new GradleException("bwc_tests_disabled_issue must be set when bwc_tests_enabled == false")
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
index 30728af31b730..165a50db60d18 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilder.java
@@ -67,7 +67,7 @@ static GeoTileGridValuesSourceBuilder parse(String name, XContentParser parser)
     GeoTileGridValuesSourceBuilder(StreamInput in) throws IOException {
         super(in);
         this.precision = in.readInt();
-        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
             this.geoBoundingBox = new GeoBoundingBox(in);
         }
     }
@@ -90,7 +90,7 @@ public GeoTileGridValuesSourceBuilder format(String format) {
     @Override
     protected void innerWriteTo(StreamOutput out) throws IOException {
         out.writeInt(precision);
-        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             geoBoundingBox.writeTo(out);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregationBuilder.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregationBuilder.java
index 233fd4c6885e8..0a7c918231c73 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregationBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregationBuilder.java
@@ -98,7 +98,7 @@ public GeoGridAggregationBuilder(StreamInput in) throws IOException {
         precision = in.readVInt();
         requiredSize = in.readVInt();
         shardSize = in.readVInt();
-        if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (in.getVersion().onOrAfter(Version.V_7_6_0)) {
             geoBoundingBox = new GeoBoundingBox(in);
         }
     }
@@ -108,7 +108,7 @@ protected void innerWriteTo(StreamOutput out) throws IOException {
         out.writeVInt(precision);
         out.writeVInt(requiredSize);
         out.writeVInt(shardSize);
-        if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
+        if (out.getVersion().onOrAfter(Version.V_7_6_0)) {
             geoBoundingBox.writeTo(out);
         }
     }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridTests.java
index 883810b25d76b..9909495c230f0 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridTests.java
@@ -59,10 +59,10 @@ protected GeoHashGridAggregationBuilder createTestAggregatorBuilder() {
     }
 
     public void testSerializationPreBounds() throws Exception {
-        Version noBoundsSupportVersion = VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0);
+        Version noBoundsSupportVersion = VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_5_0);
         GeoHashGridAggregationBuilder builder = createTestAggregatorBuilder();
         try (BytesStreamOutput output = new BytesStreamOutput()) {
-            output.setVersion(Version.V_8_0_0);
+            output.setVersion(Version.V_7_6_0);
             builder.writeTo(output);
             try (StreamInput in = new NamedWriteableAwareStreamInput(output.bytes().streamInput(),
                 new NamedWriteableRegistry(Collections.emptyList()))) {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoTileGridTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoTileGridTests.java
index 33631d39f720d..dc2a72f387f11 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoTileGridTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/GeoTileGridTests.java
@@ -59,10 +59,10 @@ protected GeoTileGridAggregationBuilder createTestAggregatorBuilder() {
     }
 
     public void testSerializationPreBounds() throws Exception {
-        Version noBoundsSupportVersion = VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0);
+        Version noBoundsSupportVersion = VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_5_0);
         GeoTileGridAggregationBuilder builder = createTestAggregatorBuilder();
         try (BytesStreamOutput output = new BytesStreamOutput()) {
-            output.setVersion(Version.V_8_0_0);
+            output.setVersion(Version.V_7_6_0);
             builder.writeTo(output);
             try (StreamInput in = new NamedWriteableAwareStreamInput(output.bytes().streamInput(),
                 new NamedWriteableRegistry(Collections.emptyList()))) {
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilderTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilderTests.java
index 7817a236d6680..17b63e0ee6603 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/composite/GeoTileGridValuesSourceBuilderTests.java
@@ -43,13 +43,13 @@ public void testSetFormat() {
     }
 
     public void testBWCBounds() throws IOException {
-        Version noBoundsSupportVersion = VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0);
+        Version noBoundsSupportVersion = VersionUtils.randomVersionBetween(random(), Version.V_7_0_0, Version.V_7_5_0);
         GeoTileGridValuesSourceBuilder builder = new GeoTileGridValuesSourceBuilder("name");
         if (randomBoolean()) {
             builder.geoBoundingBox(GeoBoundingBoxTests.randomBBox());
         }
         try (BytesStreamOutput output = new BytesStreamOutput()) {
-            output.setVersion(Version.V_8_0_0);
+            output.setVersion(Version.V_7_6_0);
             builder.writeTo(output);
             try (StreamInput in = new NamedWriteableAwareStreamInput(output.bytes().streamInput(),
                 new NamedWriteableRegistry(Collections.emptyList()))) {

From a3e75e50c3bd34c75d633440a815ef78bd9e7793 Mon Sep 17 00:00:00 2001
From: Mykhailo Havelia <Arfey17.mg@gmail.com>
Date: Tue, 14 Jan 2020 22:46:07 +0200
Subject: [PATCH 574/686] Change ExampleRescoreBuilder ctor visibility (#50922)

The existing package private visibility of the serialization ctor isn't enough when copying
example code to oder packages or projects when bootstrapping a new project from it.
---
 .../elasticsearch/example/rescore/ExampleRescoreBuilder.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plugins/examples/rescore/src/main/java/org/elasticsearch/example/rescore/ExampleRescoreBuilder.java b/plugins/examples/rescore/src/main/java/org/elasticsearch/example/rescore/ExampleRescoreBuilder.java
index 14f4d4f8ba326..b459c91283585 100644
--- a/plugins/examples/rescore/src/main/java/org/elasticsearch/example/rescore/ExampleRescoreBuilder.java
+++ b/plugins/examples/rescore/src/main/java/org/elasticsearch/example/rescore/ExampleRescoreBuilder.java
@@ -64,7 +64,7 @@ public ExampleRescoreBuilder(float factor, @Nullable String factorField) {
         this.factorField = factorField;
     }
 
-    ExampleRescoreBuilder(StreamInput in) throws IOException {
+    public ExampleRescoreBuilder(StreamInput in) throws IOException {
         super(in);
         factor = in.readFloat();
         factorField = in.readOptionalString();

From 479768af51af5e04cbc435f637988713eedcdef2 Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Tue, 14 Jan 2020 16:23:58 -0500
Subject: [PATCH 575/686] Report progress of multiple plugin installs (#51001)

When installing multiple plugins at once, this commit changes the
behavior to report installed plugins as we go. In the case of failure,
we emit a message that we are rolling back any plugins that were
installed successfully, and also that they were successfully rolled
back. In the case a plugin is not successfully rolled back, we report
this clearly too, alerting the user that there might still be state on
disk they would have to clean up.
---
 .../plugins/InstallPluginCommand.java         | 38 +++++++++++++------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/distribution/tools/plugin-cli/src/main/java/org/elasticsearch/plugins/InstallPluginCommand.java b/distribution/tools/plugin-cli/src/main/java/org/elasticsearch/plugins/InstallPluginCommand.java
index 9205c248e519e..f2de4fd3b1763 100644
--- a/distribution/tools/plugin-cli/src/main/java/org/elasticsearch/plugins/InstallPluginCommand.java
+++ b/distribution/tools/plugin-cli/src/main/java/org/elasticsearch/plugins/InstallPluginCommand.java
@@ -81,6 +81,7 @@
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
+import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
@@ -224,32 +225,47 @@ void execute(Terminal terminal, List<String> pluginIds, boolean isBatch, Environ
             }
         }
 
-        final List<Path> deleteOnFailure = new ArrayList<>();
-        final Set<PluginInfo> pluginInfos = new HashSet<>();
+        final Map<String, List<Path>> deleteOnFailures = new LinkedHashMap<>();
         for (final String pluginId : pluginIds) {
+            terminal.println("-> Installing " + pluginId);
             try {
                 if ("x-pack".equals(pluginId)) {
                     handleInstallXPack(buildFlavor());
                 }
 
+                final List<Path> deleteOnFailure = new ArrayList<>();
+                deleteOnFailures.put(pluginId, deleteOnFailure);
+
                 final Path pluginZip = download(terminal, pluginId, env.tmpFile(), isBatch);
                 final Path extractedZip = unzip(pluginZip, env.pluginsFile());
                 deleteOnFailure.add(extractedZip);
                 final PluginInfo pluginInfo = installPlugin(terminal, isBatch, extractedZip, env, deleteOnFailure);
-                pluginInfos.add(pluginInfo);
+                terminal.println("-> Installed " + pluginInfo.getName());
+                // swap the entry by plugin id for one with the installed plugin name, it gives a cleaner error message for URL installs
+                deleteOnFailures.remove(pluginId);
+                deleteOnFailures.put(pluginInfo.getName(), deleteOnFailure);
             } catch (final Exception installProblem) {
-                try {
-                    IOUtils.rm(deleteOnFailure.toArray(new Path[0]));
-                } catch (final IOException exceptionWhileRemovingFiles) {
-                    installProblem.addSuppressed(exceptionWhileRemovingFiles);
+                terminal.println("-> Failed installing " + pluginId);
+                for (final Map.Entry<String, List<Path>> deleteOnFailureEntry : deleteOnFailures.entrySet()) {
+                    terminal.println("-> Rolling back " + deleteOnFailureEntry.getKey());
+                    boolean success = false;
+                    try {
+                        IOUtils.rm(deleteOnFailureEntry.getValue().toArray(new Path[0]));
+                        success = true;
+                    } catch (final IOException exceptionWhileRemovingFiles) {
+                        final Exception exception = new Exception(
+                            "failed rolling back installation of [" + deleteOnFailureEntry.getKey() + "]",
+                            exceptionWhileRemovingFiles);
+                        installProblem.addSuppressed(exception);
+                        terminal.println("-> Failed rolling back " + deleteOnFailureEntry.getKey());
+                    }
+                    if (success) {
+                        terminal.println("-> Rolled back " + deleteOnFailureEntry.getKey());
+                    }
                 }
                 throw installProblem;
             }
         }
-
-        for (final PluginInfo pluginInfo : pluginInfos) {
-            terminal.println("-> Installed " + pluginInfo.getName());
-        }
     }
 
     Build.Flavor buildFlavor() {

From 60ac896c2f032451cd0c496d0f395e1e44ea2140 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Tue, 14 Jan 2020 16:48:35 -0500
Subject: [PATCH 576/686] [DOCS] Document `breakers`, `script`, and `discovery`
 node stats (#50509)

Documents the `breakers`, `script`, and `discovery` parameters returned
by the `_nodes/stats` API.
---
 docs/reference/cluster/nodes-stats.asciidoc | 72 +++++++++++++++++++++
 1 file changed, 72 insertions(+)

diff --git a/docs/reference/cluster/nodes-stats.asciidoc b/docs/reference/cluster/nodes-stats.asciidoc
index 9306c23e43f43..ed04e1b085594 100644
--- a/docs/reference/cluster/nodes-stats.asciidoc
+++ b/docs/reference/cluster/nodes-stats.asciidoc
@@ -960,6 +960,78 @@ Current number of open HTTP connections for the node.
 (integer)
 Total number of HTTP connections opened for the node.
 
+[[cluster-nodes-stats-api-response-body-breakers]]
+===== `breakers` section
+
+`breakers.<circuit_breaker_name>.limit_size_in_bytes`::
+(integer)
+Memory limit, in bytes, for the circuit breaker.
+
+`breakers.<circuit_breaker_name>.limit_size`::
+(<<byte-units,byte value>>)
+Memory limit for the circuit breaker.
+
+`breakers.<circuit_breaker_name>.estimated_size_in_bytes`::
+(integer)
+Estimated memory used, in bytes, for the operation.
+
+`breakers.<circuit_breaker_name>.estimated_size`::
+(<<byte-units,byte value>>)
+Estimated memory used for the operation.
+
+`breakers.<circuit_breaker_name>.overhead`::
+(float)
+A constant that all estimates for the circuit breaker are multiplied with to
+calculate a final estimate.
+
+`breakers.<circuit_breaker_name>.tripped`::
+(integer)
+Total number of times the circuit breaker has been triggered and prevented an
+out of memory error.
+
+[[cluster-nodes-stats-api-response-body-script]]
+===== `script` section
+
+`script.compilations`::
+(integer)
+Total number of inline script compilations performed by the node.
+
+`script.cache_evictions`::
+(integer)
+Total number of times the script cache has evicted old data.
+
+`script.compilation_limit_triggered`::
+(integer)
+Total number of times the <<script-compilation-circuit-breaker,script
+compilation>> circuit breaker has limited inline script compilations.
+
+[[cluster-nodes-stats-api-response-body-discovery]]
+===== `discovery` section
+
+`discovery.cluster_state_queue.total`::
+(integer)
+Total number of cluster states in queue.
+
+`discovery.cluster_state_queue.pending`::
+(integer)
+Number of pending cluster states in queue.
+
+`discovery.cluster_state_queue.committed`::
+(integer)
+Number of committed cluster states in queue.
+
+`discovery.published_cluster_states.full_states`::
+(integer)
+Number of published cluster states.
+
+`discovery.published_cluster_states.incompatible_diffs`::
+(integer)
+Number of incompatible differences between published cluster states.
+
+`discovery.published_cluster_states.compatible_diffs`::
+(integer)
+Number of compatible differences between published cluster states.
+
 [[cluster-nodes-stats-api-response-body-ingest]]
 ===== `ingest` section
 

From 1ff58533af883c8fae24b717ae07cfdf5cb7d9a0 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Tue, 14 Jan 2020 13:52:11 -0800
Subject: [PATCH 577/686] Migrate cron eval bats test to java (#50940)

This commit migrates the simple test of the cron eval tool from bats to
java packaging tests.

relates #46005
---
 .../gradle/test/DistroTestPlugin.java         |  1 -
 qa/os/bats/default/10_basic.bats              | 47 -----------------
 qa/os/build.gradle                            |  2 +-
 .../packaging/test/CronEvalCliTests.java      | 50 +++++++++++++++++++
 .../packaging/util/Installation.java          |  1 +
 .../trigger/schedule/tool/CronEvalTool.java   |  2 +-
 6 files changed, 53 insertions(+), 50 deletions(-)
 delete mode 100644 qa/os/bats/default/10_basic.bats
 create mode 100644 qa/os/src/test/java/org/elasticsearch/packaging/test/CronEvalCliTests.java

diff --git a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java b/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
index b62ff129c8638..3afd66ea00012 100644
--- a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
+++ b/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
@@ -117,7 +117,6 @@ public void apply(Project project) {
         }
         Map<String, TaskProvider<?>> batsTests = new HashMap<>();
         batsTests.put("bats oss", configureBatsTest(project, "oss", distributionsDir, copyDistributionsTask));
-        batsTests.put("bats default", configureBatsTest(project, "default", distributionsDir, copyDistributionsTask));
         configureBatsTest(project, "plugins",distributionsDir, copyDistributionsTask, copyPluginsTask).configure(t ->
             t.setPluginsDir(pluginsDir)
         );
diff --git a/qa/os/bats/default/10_basic.bats b/qa/os/bats/default/10_basic.bats
deleted file mode 100644
index b3683b5dd158e..0000000000000
--- a/qa/os/bats/default/10_basic.bats
+++ /dev/null
@@ -1,47 +0,0 @@
-#!/usr/bin/env bats
-
-# Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
-# or more contributor license agreements. Licensed under the Elastic License;
-# you may not use this file except in compliance with the Elastic License.
-
-# This file is used to test the X-Pack package.
-
-# WARNING: This testing file must be executed as root and can
-# dramatically change your system. It removes the 'elasticsearch'
-# user/group and also many directories. Do not execute this file
-# unless you know exactly what you are doing.
-
-load $BATS_UTILS/utils.bash
-load $BATS_UTILS/tar.bash
-load $BATS_UTILS/plugins.bash
-load $BATS_UTILS/xpack.bash
-
-setup() {
-    skip_not_tar_gz
-    export ESHOME=/tmp/elasticsearch
-    export PACKAGE_NAME="elasticsearch"
-    export_elasticsearch_paths
-    export ESPLUGIN_COMMAND_USER=elasticsearch
-}
-
-@test "[X-PACK] install default distribution" {
-    # Cleans everything for the 1st execution
-    clean_before_test
-
-    # Install the archive
-    install_archive
-    set_debug_logging
-}
-
-@test "[X-PACK] verify x-pack installation" {
-    verify_xpack_installation
-}
-
-@test "[X-PACK] verify croneval works" {
-    run $ESHOME/bin/elasticsearch-croneval "0 0 20 ? * MON-THU" -c 2
-    [ "$status" -eq 0 ]
-    [[ "$output" == *"Valid!"* ]] || {
-      echo "Expected output message to contain [Valid!] but found: $output"
-      false
-    }
-}
diff --git a/qa/os/build.gradle b/qa/os/build.gradle
index fc91e77606219..204ff38bce349 100644
--- a/qa/os/build.gradle
+++ b/qa/os/build.gradle
@@ -58,7 +58,7 @@ tasks.dependenciesInfo.enabled = false
 tasks.thirdPartyAudit.ignoreMissingClasses()
 
 tasks.register('destructivePackagingTest') {
-  dependsOn 'destructiveDistroTest', 'destructiveBatsTest.oss', 'destructiveBatsTest.default'
+  dependsOn 'destructiveDistroTest', 'destructiveBatsTest.oss'
 }
 
 processTestResources {
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/CronEvalCliTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/CronEvalCliTests.java
new file mode 100644
index 0000000000000..4ae95713af9fe
--- /dev/null
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/CronEvalCliTests.java
@@ -0,0 +1,50 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.packaging.test;
+
+import org.elasticsearch.packaging.util.Distribution;
+import org.elasticsearch.packaging.util.Shell;
+import org.junit.Before;
+
+import static org.hamcrest.CoreMatchers.containsString;
+import static org.junit.Assume.assumeTrue;
+
+public class CronEvalCliTests extends PackagingTestCase {
+
+    @Before
+    public void filterDistros() {
+        assumeTrue("only default distro", distribution.flavor == Distribution.Flavor.DEFAULT);
+        assumeTrue("no docker", distribution.packaging != Distribution.Packaging.DOCKER);
+    }
+
+    public void test10Install() throws Exception {
+        install();
+    }
+
+    public void test20Help() throws Exception {
+        Shell.Result result = installation.executables().cronevalTool.run("--help");
+        assertThat(result.stdout, containsString("Validates and evaluates a cron expression"));
+    }
+
+    public void test30Run() throws Exception {
+        Shell.Result result = installation.executables().cronevalTool.run("'0 0 20 ? * MON-THU' -c 2");
+        assertThat(result.stdout, containsString("Valid!"));
+    }
+}
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
index 717f15aebc6d9..e879fe24c8be2 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Installation.java
@@ -177,6 +177,7 @@ public class Executables {
         public final Executable keystoreTool = new Executable("elasticsearch-keystore");
         public final Executable certutilTool = new Executable("elasticsearch-certutil");
         public final Executable certgenTool = new Executable("elasticsearch-certgen");
+        public final Executable cronevalTool = new Executable("elasticsearch-croneval");
         public final Executable shardTool = new Executable("elasticsearch-shard");
         public final Executable nodeTool = new Executable("elasticsearch-node");
         public final Executable setupPasswordsTool = new Executable("elasticsearch-setup-passwords");
diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
index 9464abcc4ba59..2e496c2ec619c 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/trigger/schedule/tool/CronEvalTool.java
@@ -56,7 +56,7 @@ protected void execute(Terminal terminal, OptionSet options) throws Exception {
         int count = countOption.value(options);
         List<String> args = arguments.values(options);
         if (args.size() != 1) {
-            throw new UserException(ExitCodes.USAGE, "expecting a single argument that is the cron expression to evaluate");
+            throw new UserException(ExitCodes.USAGE, "expecting a single argument that is the cron expression to evaluate, got " + args);
         }
         boolean printDetail = options.has(detailOption);
         execute(terminal, args.get(0), count, printDetail);

From c0a8f41c6149b9da93a7f78cb8dd43348be7359b Mon Sep 17 00:00:00 2001
From: Gordon Brown <gordon.brown@elastic.co>
Date: Tue, 14 Jan 2020 15:24:37 -0700
Subject: [PATCH 578/686] Add generated benchmark files to gitignore

When building IntelliJ generates several source files related to the
benchmarks. This commit adds that path to the gitignore so these don't
get accidentally committed.
---
 .gitignore | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index e3f75ba3d1fb4..ec394ab09063a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,6 +5,8 @@
 *.ipr
 *.iws
 build-idea/
+# These files are generated in the main tree by IntelliJ
+benchmarks/src/main/generated/*
 
 # eclipse files
 .project
@@ -42,7 +44,7 @@ html_docs
 /tmp/
 eclipse-build
 
-# projects using testfixtures 
+# projects using testfixtures
 testfixtures_shared/
 
 # These are generated from .ci/jobs.t

From d6f728f393600f532aa7b4f5c818bf069e3ac00a Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@elastic.co>
Date: Tue, 14 Jan 2020 14:39:30 -0800
Subject: [PATCH 579/686] Fix windows chown to work with single file (#51004)

The chown utility for packaging tests works on windows when the given
path is a directory, but would fail if the path was a single file. This
commit fixes it to handle both cases.

relates #50825
---
 .../java/org/elasticsearch/packaging/util/Shell.java   | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java b/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
index 18988a7310fb4..95141aae17359 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/util/Shell.java
@@ -88,9 +88,13 @@ public void chown(Path path) throws Exception {
         Platforms.onLinux(() -> run("chown -R elasticsearch:elasticsearch " + path));
         Platforms.onWindows(() -> run(
             "$account = New-Object System.Security.Principal.NTAccount '" + System.getenv("username")  + "'; " +
-                "$tempConf = Get-ChildItem '" + path + "' -Recurse; " +
-                "$tempConf += Get-Item '" + path + "'; " +
-                "$tempConf | ForEach-Object { " +
+                "$pathInfo = Get-Item '" + path + "'; " +
+                "$toChown = @(); " +
+                "if ($pathInfo.PSIsContainer) { " +
+                "  $toChown += Get-ChildItem '" + path + "' -Recurse; " +
+                "}" +
+                "$toChown += $pathInfo; " +
+                "$toChown | ForEach-Object { " +
                 "$acl = Get-Acl $_.FullName; " +
                 "$acl.SetOwner($account); " +
                 "Set-Acl $_.FullName $acl " +

From 4c824a9936e2f948bfef190ecbc342fe31654bd6 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Tue, 14 Jan 2020 19:41:14 -0500
Subject: [PATCH 580/686] Update skip after backport (#51015)

Now that we've backported #50938 to 7.x it should be safe to run its
test against BWC clusters that include that branch.
---
 .../src/main/resources/rest-api-spec/test/update/90_error.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/update/90_error.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/update/90_error.yml
index 3102fd39afad9..9a48d24783b44 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/update/90_error.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/update/90_error.yml
@@ -1,8 +1,8 @@
 ---
 'Misspelled fields get "did you mean"':
   - skip:
-      version: " - 7.99.99"
-      reason: Implemented in 8.0
+      version: " - 7.5.99"
+      reason: Implemented in 7.6
   - do:
       catch: /\[UpdateRequest\] unknown field \[dac\] did you mean \[doc\]\?/
       update:

From 09c770379299a52485efc28813641b1355f75d7a Mon Sep 17 00:00:00 2001
From: Tomas Della Vedova <delvedor@users.noreply.github.com>
Date: Wed, 15 Jan 2020 07:44:45 +0100
Subject: [PATCH 581/686] [ML] Removed key value from the catch regex test
 (#50977)

---
 .../test/ml/data_frame_analytics_crud.yml            | 12 ++++++------
 .../test/ml/start_data_frame_analytics.yml           |  2 +-
 .../test/transform/preview_transforms.yml            |  2 +-
 .../rest-api-spec/test/transform/transforms_crud.yml |  8 ++++----
 .../test/transform/transforms_update.yml             | 10 +++++-----
 5 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
index 903ac36d90990..afd6701af145c 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/data_frame_analytics_crud.yml
@@ -272,7 +272,7 @@ setup:
 "Test put config given dest index contains uppercase chars":
 
   - do:
-      catch: /.*reason=Validation Failed.* Destination index \[Foo\] must be lowercase;.*/
+      catch: /.*Validation Failed.* Destination index \[Foo\] must be lowercase;.*/
       ml.put_data_frame_analytics:
         id: "config-given-dest-index-uppercase"
         body: >
@@ -308,7 +308,7 @@ setup:
 "Test put config with missing concrete source index":
 
   - do:
-      catch: /.*reason=Validation Failed.* no such index \[missing\]/
+      catch: /.*Validation Failed.* no such index \[missing\]/
       ml.put_data_frame_analytics:
         id: "config-with-missing-concrete-source-index"
         body: >
@@ -344,7 +344,7 @@ setup:
 "Test put config with dest index same as source index":
 
   - do:
-      catch: /.*reason=Validation Failed.* Destination index \[index-source\] is included in source expression \[index-source\]/
+      catch: /.*Validation Failed.* Destination index \[index-source\] is included in source expression \[index-source\]/
       ml.put_data_frame_analytics:
         id: "config-with-same-source-dest-index"
         body: >
@@ -380,7 +380,7 @@ setup:
         name: multiple-dest-index
 
   - do:
-      catch: /.*reason=Validation Failed.* no write index is defined for alias \[multiple-dest-index\].*/
+      catch: /.*Validation Failed.* no write index is defined for alias \[multiple-dest-index\].*/
       ml.put_data_frame_analytics:
         id: "config-with-dest-index-matching-multiple-indices"
         body: >
@@ -407,7 +407,7 @@ setup:
         name: dest-alias
 
   - do:
-      catch: /.*reason=Validation Failed.* Destination index \[another-source-index\] is included in source expression \[another-source-index\]/
+      catch: /.*Validation Failed.* Destination index \[another-source-index\] is included in source expression \[another-source-index\]/
       ml.put_data_frame_analytics:
         id: "config-with-dest-index-included-in-source-via-alias"
         body: >
@@ -425,7 +425,7 @@ setup:
 "Test put config with remote source index":
 
   - do:
-      catch: /.*reason=Validation Failed.* remote source indices are not supported/
+      catch: /.*Validation Failed.* remote source indices are not supported/
       ml.put_data_frame_analytics:
         id: "config-with-missing-concrete-source-index"
         body: >
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/start_data_frame_analytics.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/start_data_frame_analytics.yml
index 8cae555a201f5..1bac227066204 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/start_data_frame_analytics.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/ml/start_data_frame_analytics.yml
@@ -31,7 +31,7 @@
         index: missing
 
   - do:
-      catch: /.*reason=Validation Failed.* no such index \[missing\]/
+      catch: /.*Validation Failed.* no such index \[missing\]/
       ml.start_data_frame_analytics:
         id: "missing_index"
 
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/preview_transforms.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/preview_transforms.yml
index cf139b04b44c5..7abb83834f515 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/preview_transforms.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/preview_transforms.yml
@@ -166,7 +166,7 @@ setup:
 ---
 "Test preview with non-existing source index":
   - do:
-      catch: /.*reason=Validation Failed.* no such index \[does_not_exist\]/
+      catch: /.*Validation Failed.* no such index \[does_not_exist\]/
       transform.preview_transform:
         body: >
           {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
index b8dc88c3ae0c1..e66982aadece1 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_crud.yml
@@ -79,7 +79,7 @@ setup:
 ---
 "Test put transform with invalid source index":
   - do:
-      catch: /.*reason=Validation Failed.* no such index \[missing-index\]/
+      catch: /.*Validation Failed.* no such index \[missing-index\]/
       transform.put_transform:
         transform_id: "missing-source-transform"
         body: >
@@ -400,7 +400,7 @@ setup:
         name: source-index
 
   - do:
-      catch: /.*reason=Validation Failed.* Destination index \[created-destination-index\] is included in source expression \[airline-data,created-destination-index\]/
+      catch: /.*Validation Failed.* Destination index \[created-destination-index\] is included in source expression \[airline-data,created-destination-index\]/
       transform.put_transform:
         transform_id: "transform-from-aliases-failures"
         body: >
@@ -426,7 +426,7 @@ setup:
         name: dest-index
 
   - do:
-      catch: /.*reason=Validation Failed.* no write index is defined for alias [dest2-index].*/
+      catch: /.*Validation Failed.* no write index is defined for alias [dest2-index].*/
       transform.put_transform:
         transform_id: "airline-transform"
         body: >
@@ -537,7 +537,7 @@ setup:
 ---
 "Test invalid destination index name":
   - do:
-      catch: /.*reason=Validation Failed.* Destination index \[DeStInAtIoN\] must be lowercase/
+      catch: /.*Validation Failed.* Destination index \[DeStInAtIoN\] must be lowercase/
       transform.put_transform:
         transform_id: "airline-transform"
         body: >
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_update.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_update.yml
index f55fcd2cb07e5..d82bc1bea9d0a 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_update.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/transform/transforms_update.yml
@@ -67,7 +67,7 @@ setup:
 ---
 "Test put transform with invalid source index":
   - do:
-      catch: /.*reason=Validation Failed.* no such index \[missing-index\]/
+      catch: /.*Validation Failed.* no such index \[missing-index\]/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
@@ -255,7 +255,7 @@ setup:
         name: source2-index
 
   - do:
-      catch: /.*reason=Validation Failed.* Destination index \[created-destination-index\] is included in source expression \[created-destination-index\]/
+      catch: /.*Validation Failed.* Destination index \[created-destination-index\] is included in source expression \[created-destination-index\]/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
@@ -280,7 +280,7 @@ setup:
         index: created-destination-index
         name: dest2-index
   - do:
-      catch: /.*reason=Validation Failed.* no write index is defined for alias [dest2-index].*/
+      catch: /.*Validation Failed.* no write index is defined for alias [dest2-index].*/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
@@ -290,7 +290,7 @@ setup:
 ---
 "Test invalid destination index name":
   - do:
-      catch: /.*reason=Validation Failed.* Destination index \[DeStInAtIoN\] must be lowercase/
+      catch: /.*Validation Failed.* Destination index \[DeStInAtIoN\] must be lowercase/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >
@@ -298,7 +298,7 @@ setup:
             "dest": { "index": "DeStInAtIoN" }
           }
   - do:
-      catch: /.*reason=Validation Failed.* Invalid index name \[destination#dest\], must not contain \'#\'/
+      catch: /.*Validation Failed.* Invalid index name \[destination#dest\], must not contain \'#\'/
       transform.update_transform:
         transform_id: "updating-airline-transform"
         body: >

From af7b08a84fbdbcbb7031ad00496d4aed10a58814 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Wed, 15 Jan 2020 08:45:03 +0100
Subject: [PATCH 582/686] [DOCS] Describes the relationship of the time-related
 settings in anomaly detection docs (#50959)

Co-Authored-By: David Roberts <dave.roberts@elastic.co>
---
 .../apis/put-datafeed.asciidoc                | 24 +++++++++++++++++++
 .../anomaly-detection/apis/put-job.asciidoc   |  5 ++++
 2 files changed, 29 insertions(+)

diff --git a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
index 796d4995404a9..a823c9c0ec7b5 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
@@ -64,6 +64,11 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
 `frequency`::
 (Optional, <<time-units, time units>>)
 include::{docdir}/ml/ml-shared.asciidoc[tag=frequency]
++
+--
+To learn more about the relationship between time related settings, see 
+<<ml-put-datafeed-time-related-settings>>.
+--
 
 `indices`::
 (Required, array)
@@ -84,6 +89,11 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=query]
 `query_delay`::
 (Optional, <<time-units, time units>>)
 include::{docdir}/ml/ml-shared.asciidoc[tag=query-delay]
++
+--
+To learn more about the relationship between time related settings, see 
+<<ml-put-datafeed-time-related-settings>>.
+--
 
 `script_fields`::
 (Optional, object)
@@ -93,6 +103,20 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=script-fields]
 (Optional, unsigned integer)
 include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
 
+
+[[ml-put-datafeed-time-related-settings]]
+===== Interaction between time-related settings
+
+Time-related settings have the following relationships:
+
+* Queries run at `query_delay` after the end of 
+  each `frequency`.
+  
+* When `frequency` is shorter than `bucket_span` of the associated job, interim 
+  results for the last (partial) bucket are written, and then overwritten by the 
+  full bucket results eventually.
+
+
 [[ml-put-datafeed-example]]
 ==== {api-examples-title}
 
diff --git a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
index a4661a19c435d..f3de1621644ed 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
@@ -49,6 +49,11 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-config]
 `analysis_config`.`bucket_span`:::
 (<<time-units,time units>>)
 include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span]
++
+--
+To learn more about the relationship between time related settings, see 
+<<ml-put-datafeed-time-related-settings>>.
+--
 
 `analysis_config`.`categorization_field_name`:::
 (string)

From 1b2e8fbfde5fab7d462c609c9248f8390f02c284 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Wed, 15 Jan 2020 08:50:50 +0100
Subject: [PATCH 583/686] Tidy up enrich processors: (#50957)

* Fix generics usages.
* Sealed match processor class.
---
 .../org/elasticsearch/xpack/enrich/GeoMatchProcessor.java     | 3 +--
 .../java/org/elasticsearch/xpack/enrich/MatchProcessor.java   | 4 ++--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/GeoMatchProcessor.java b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/GeoMatchProcessor.java
index b10bafa5e959c..62f8c16dd0d0b 100644
--- a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/GeoMatchProcessor.java
+++ b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/GeoMatchProcessor.java
@@ -59,12 +59,11 @@ public final class GeoMatchProcessor extends AbstractEnrichProcessor {
         this.shapeRelation = shapeRelation;
     }
 
-    @SuppressWarnings("unchecked")
     @Override
     public QueryBuilder getQueryBuilder(Object fieldValue) {
         List<Point> points = new ArrayList<>();
         if (fieldValue instanceof List) {
-            List<Object> values = (List<Object>) fieldValue;
+            List<?> values = (List<?>) fieldValue;
             if (values.size() == 2 && values.get(0) instanceof Number) {
                 GeoPoint geoPoint = GeoUtils.parseGeoPoint(values, true);
                 points.add(new Point(geoPoint.lon(), geoPoint.lat()));
diff --git a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/MatchProcessor.java b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/MatchProcessor.java
index 6e2967272fa26..317e470b764d9 100644
--- a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/MatchProcessor.java
+++ b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/MatchProcessor.java
@@ -16,7 +16,7 @@
 import java.util.List;
 import java.util.function.BiConsumer;
 
-public class MatchProcessor extends AbstractEnrichProcessor {
+public final class MatchProcessor extends AbstractEnrichProcessor {
 
     MatchProcessor(
         String tag,
@@ -50,7 +50,7 @@ public class MatchProcessor extends AbstractEnrichProcessor {
     @Override
     public QueryBuilder getQueryBuilder(Object fieldValue) {
         if (fieldValue instanceof List) {
-            return new TermsQueryBuilder(matchField, (List) fieldValue);
+            return new TermsQueryBuilder(matchField, (List<?>) fieldValue);
         } else {
             return new TermQueryBuilder(matchField, fieldValue);
         }

From db1b98fe37da87117f50c702f3813971b849852f Mon Sep 17 00:00:00 2001
From: David Roberts <dave.roberts@elastic.co>
Date: Wed, 15 Jan 2020 08:55:46 +0000
Subject: [PATCH 584/686] [TEST] Increase ML distributed test job open timeout
 (#50998)

There have been occasional failures, presumably due to
too many tests running in parallel, caused by jobs taking
around 15 seconds to open.  (You can see the job open
successfully during the cleanup phase shortly after the
failure of the test in these cases.)  This change increases
the wait time from 10 seconds to 20 seconds to reduce the
risk of this happening.
---
 .../xpack/ml/integration/MlDistributedFailureIT.java            | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
index dcddb842d21b6..f0ef71c0a6a4c 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
@@ -416,7 +416,7 @@ private void setupJobAndDatafeed(String jobId, String datafeedId, TimeValue data
             GetJobsStatsAction.Response statsResponse =
                     client().execute(GetJobsStatsAction.INSTANCE, new GetJobsStatsAction.Request(job.getId())).actionGet();
             assertEquals(JobState.OPENED, statsResponse.getResponse().results().get(0).getState());
-        });
+        }, 20, TimeUnit.SECONDS);
 
         StartDatafeedAction.Request startDatafeedRequest = new StartDatafeedAction.Request(config.getId(), 0L);
         client().execute(StartDatafeedAction.INSTANCE, startDatafeedRequest).get();

From 78a49a7ac0cd38a9aa6a6e5b7999cb3d96e64aa1 Mon Sep 17 00:00:00 2001
From: Costin Leau <costin@users.noreply.github.com>
Date: Wed, 15 Jan 2020 11:05:52 +0200
Subject: [PATCH 585/686] QL: Extend NodeSubclass to read classes from jars
 (#50866)

As the test classes are spread across more than one project, the Gradle
classpath contains not just folders but also jars.
This commit allows the test class to explore the archive content and
load matching classes from said source.
---
 .../xpack/ql/tree/NodeSubclassTests.java      | 106 ++++++++++++------
 .../xpack/sql/expression/ProcessorTests.java  |   4 +-
 .../xpack/sql/tree/SqlNodeSubclassTests.java  |   2 -
 3 files changed, 73 insertions(+), 39 deletions(-)

diff --git a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeSubclassTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeSubclassTests.java
index 836450cff5cf2..48fe6cdf22318 100644
--- a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeSubclassTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/tree/NodeSubclassTests.java
@@ -8,6 +8,7 @@
 import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
 
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.SuppressForbidden;
 import org.elasticsearch.common.io.PathUtils;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.ql.expression.Expression;
@@ -52,10 +53,14 @@
 import java.util.Collection;
 import java.util.EnumSet;
 import java.util.HashMap;
+import java.util.LinkedHashSet;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
+import java.util.Set;
 import java.util.function.Supplier;
+import java.util.jar.JarEntry;
+import java.util.jar.JarInputStream;
 
 import static java.util.Collections.emptyList;
 import static java.util.stream.Collectors.toList;
@@ -603,60 +608,93 @@ public <T extends Node<?>> T makeNode(Class<? extends T> nodeClass) throws Excep
      * Cache of subclasses. We use a cache because it significantly speeds up
      * the test.
      */
-    private static final Map<Class<?>, List<?>> subclassCache = new HashMap<>();
+    private static final Map<Class<?>, Set<?>> subclassCache = new HashMap<>();
+
     /**
      * Find all subclasses of a particular class.
      */
-    public static <T> List<Class<? extends T>> subclassesOf(Class<T> clazz) throws IOException {
+    public static <T> Set<Class<? extends T>> subclassesOf(Class<T> clazz) throws IOException {
         @SuppressWarnings("unchecked") // The map is built this way
-        List<Class<? extends T>> lookup = (List<Class<? extends T>>) subclassCache.get(clazz);
+        Set<Class<? extends T>> lookup = (Set<Class<? extends T>>) subclassCache.get(clazz);
         if (lookup != null) {
             return lookup;
         }
-        List<Class<? extends T>> results = new ArrayList<>();
+        Set<Class<? extends T>> results = new LinkedHashSet<>();
         String[] paths = System.getProperty("java.class.path").split(System.getProperty("path.separator"));
         for (String path: paths) {
             Path root = PathUtils.get(path);
             int rootLength = root.toString().length() + 1;
-            Files.walkFileTree(root, new SimpleFileVisitor<Path>() {
-
-                @Override
-                public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
-                    if (Files.isRegularFile(file) && file.getFileName().toString().endsWith(".class")) {
-                        String className = file.toString();
-                        // Chop off the root and file extension
-                        className = className.substring(rootLength, className.length() - ".class".length());
-                        // Go from "path" style to class style
-                        className = className.replace(PathUtils.getDefaultFileSystem().getSeparator(), ".");
-
-                        // filter the class that are not interested
-                        // (and IDE folders like eclipse)
-                        if (!className.startsWith("org.elasticsearch.xpack.ql") && !className.startsWith("org.elasticsearch.xpack.sql")) {
-                            return FileVisitResult.CONTINUE;
-                        }
-
-                        Class<?> c;
-                        try {
-                            c = Class.forName(className);
-                        } catch (ClassNotFoundException e) {
-                            throw new IOException("Couldn't find " + file, e);
-                        }
 
-                        if (false == Modifier.isAbstract(c.getModifiers())
-                                && false == c.isAnonymousClass()
-                                && clazz.isAssignableFrom(c)) {
-                            Class<? extends T> s = c.asSubclass(clazz);
-                            results.add(s);
+            // load classes from jar files
+            // NIO FileSystem API is not used since it trips the SecurityManager
+            // https://bugs.openjdk.java.net/browse/JDK-8160798
+            // so iterate the jar "by hand"
+            if (path.endsWith(".jar") && path.contains("x-pack-ql")) {
+                try (JarInputStream jar = jarStream(root)) {
+                    JarEntry je = null;
+                    while ((je = jar.getNextJarEntry()) != null) {
+                        String name = je.getName();
+                        if (name.endsWith(".class")) {
+                            String className = name.substring(0, name.length() - ".class".length()).replace("/", ".");
+                            maybeLoadClass(clazz, className, root + "!/" + name, results);
                         }
                     }
-                    return FileVisitResult.CONTINUE;
                 }
-            });
+            }
+            // for folders, just use the FileSystems API
+            else {
+                Files.walkFileTree(root, new SimpleFileVisitor<Path>() {
+                    @Override
+                    public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
+                        if (Files.isRegularFile(file) && file.getFileName().toString().endsWith(".class")) {
+                            String fileName = file.toString();
+                            // Chop off the root and file extension
+                            String className = fileName.substring(rootLength, fileName.length() - ".class".length());
+                            // Go from "path" style to class style
+                            className = className.replace(PathUtils.getDefaultFileSystem().getSeparator(), ".");
+                            maybeLoadClass(clazz, className, fileName, results);
+                        }
+                        return FileVisitResult.CONTINUE;
+                    }
+                });
+            }
         }
         subclassCache.put(clazz, results);
         return results;
     }
 
+    @SuppressForbidden(reason = "test reads from jar")
+    private static JarInputStream jarStream(Path path) throws IOException {
+        return new JarInputStream(path.toUri().toURL().openStream());
+    }
+
+    /**
+     * Load classes from predefined packages (hack to limit the scope) and if they match the hierarchy, add them to the cache
+     */
+    private static <T> void maybeLoadClass(Class<T> clazz, String className, String location, Set<Class<? extends T>> results)
+            throws IOException {
+
+        // filter the class that are not interested
+        // (and IDE folders like eclipse)
+        if (className.startsWith("org.elasticsearch.xpack.ql") == false && className.startsWith("org.elasticsearch.xpack.sql") == false) {
+            return;
+        }
+
+        Class<?> c;
+        try {
+            c = Class.forName(className);
+        } catch (ClassNotFoundException e) {
+            throw new IOException("Couldn't load " + location, e);
+        }
+
+        if (false == Modifier.isAbstract(c.getModifiers())
+                && false == c.isAnonymousClass()
+                && clazz.isAssignableFrom(c)) {
+            Class<? extends T> s = c.asSubclass(clazz);
+            results.add(s);
+        }
+    }
+
     /**
      * The test class for some subclass of node or {@code null}
      * if there isn't such a class or it doesn't extend
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ProcessorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ProcessorTests.java
index c46be2d9a8448..7e4758c6d95ff 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ProcessorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/ProcessorTests.java
@@ -6,7 +6,6 @@
 
 package org.elasticsearch.xpack.sql.expression;
 
-import org.apache.lucene.util.LuceneTestCase.AwaitsFix;
 import org.elasticsearch.common.io.stream.NamedWriteable;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
@@ -22,10 +21,9 @@
 
 import static java.util.stream.Collectors.toCollection;
 
-@AwaitsFix(bugUrl = "classpath inside tests is different")
 public class ProcessorTests extends ESTestCase {
 
-    private static List<Class<? extends Processor>> processors;
+    private static Set<Class<? extends Processor>> processors;
 
     @BeforeClass
     public static void init() throws Exception {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SqlNodeSubclassTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SqlNodeSubclassTests.java
index 56576198173a9..4937b618cf35c 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SqlNodeSubclassTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/tree/SqlNodeSubclassTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.sql.tree;
 
-import org.apache.lucene.util.LuceneTestCase.AwaitsFix;
 import org.elasticsearch.xpack.ql.expression.Expression;
 import org.elasticsearch.xpack.ql.expression.Literal;
 import org.elasticsearch.xpack.ql.expression.LiteralTests;
@@ -48,7 +47,6 @@
  * node of that type is called for.
  * </ul>
  */
-@AwaitsFix(bugUrl = "classpath inside tests is different")
 public class SqlNodeSubclassTests<T extends B, B extends Node<B>> extends NodeSubclassTests<T, B> {
 
     private static final List<Class<?>> CLASSES_WITH_MIN_TWO_CHILDREN = CollectionUtils.combine(

From b0586adb413def5a720ac7d9ea63a2d34abe6cd9 Mon Sep 17 00:00:00 2001
From: Costin Leau <costin@users.noreply.github.com>
Date: Wed, 15 Jan 2020 11:06:20 +0200
Subject: [PATCH 586/686] QL: Remove implicit conversion inside Literal
 (#50962)

Literal constructor makes an implicit conversion for each value given
which turns out has some subtle side-effects.
Improve MathProcessors to preserve numeric type where possible
Fix bug on issue compatibility between date and intervals
Preserve the source when folding inside the Optimizer
---
 .../xpack/ql/expression/Literal.java          |  9 ++-
 .../function/UnresolvedFunction.java          |  2 +-
 .../predicate/operator/comparison/In.java     |  5 +-
 .../xpack/ql/type/DataTypeConversion.java     |  8 ++-
 .../xpack/ql/expression/LiteralTests.java     |  3 +-
 .../ql/type/DataTypeConversionTests.java      |  4 +-
 .../src/main/resources/conditionals.csv-spec  |  2 +-
 .../sql/expression/function/scalar/Cast.java  |  6 +-
 .../function/scalar/math/MathProcessor.java   | 67 ++++++++++++++++---
 .../whitelist/InternalSqlScriptUtils.java     | 48 ++++++-------
 .../xpack/sql/optimizer/Optimizer.java        | 54 +++++++--------
 .../xpack/sql/plugin/sql_whitelist.txt        | 48 ++++++-------
 .../scalar/math/MathOperationTests.java       | 38 +++++++++++
 .../sql/planner/QueryTranslatorTests.java     |  8 +--
 14 files changed, 193 insertions(+), 109 deletions(-)
 create mode 100644 x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathOperationTests.java

diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Literal.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Literal.java
index 1813799aad19b..0064edc26740e 100644
--- a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Literal.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/Literal.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.xpack.ql.tree.NodeInfo;
 import org.elasticsearch.xpack.ql.tree.Source;
 import org.elasticsearch.xpack.ql.type.DataType;
-import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 import org.elasticsearch.xpack.ql.type.DataTypes;
 
 import java.util.Objects;
@@ -19,9 +18,9 @@
  */
 public class Literal extends LeafExpression {
 
-    public static final Literal TRUE = Literal.of(Source.EMPTY, Boolean.TRUE);
-    public static final Literal FALSE = Literal.of(Source.EMPTY, Boolean.FALSE);
-    public static final Literal NULL = Literal.of(Source.EMPTY, null);
+    public static final Literal TRUE = new Literal(Source.EMPTY, Boolean.TRUE, DataType.BOOLEAN);
+    public static final Literal FALSE = new Literal(Source.EMPTY, Boolean.FALSE, DataType.BOOLEAN);
+    public static final Literal NULL = new Literal(Source.EMPTY, null, DataType.NULL);
 
     private final Object value;
     private final DataType dataType;
@@ -29,7 +28,7 @@ public class Literal extends LeafExpression {
     public Literal(Source source, Object value, DataType dataType) {
         super(source);
         this.dataType = dataType;
-        this.value = DataTypeConversion.convert(value, dataType);
+        this.value = value;
     }
 
     @Override
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunction.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunction.java
index 7f0ee174554c1..f2a3deb60da02 100644
--- a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunction.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/function/UnresolvedFunction.java
@@ -195,7 +195,7 @@ public UnresolvedFunction preprocessStar(UnresolvedFunction uf) {
                 // dedicated count optimization
                 if (uf.name.toUpperCase(Locale.ROOT).equals("COUNT")) {
                     return new UnresolvedFunction(uf.source(), uf.name(), uf.resolutionType,
-                        singletonList(Literal.of(uf.arguments().get(0).source(), Integer.valueOf(1))));
+                            singletonList(new Literal(uf.arguments().get(0).source(), Integer.valueOf(1), DataType.INTEGER)));
                 }
                 return uf;
             }
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/In.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/In.java
index 435a3447f46cc..e2bf7a59030c4 100644
--- a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/In.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/expression/predicate/operator/comparison/In.java
@@ -74,14 +74,13 @@ public Nullability nullable() {
     @Override
     public boolean foldable() {
         return Expressions.foldable(children()) ||
-            (Expressions.foldable(list) && list().stream().allMatch(e -> e.dataType() == DataType.NULL));
+                (Expressions.foldable(list) && list().stream().allMatch(Expressions::isNull));
     }
 
     @Override
     public Boolean fold() {
         // Optimization for early return and Query folding to LocalExec
-        if (value.dataType() == DataType.NULL ||
-            list.size() == 1 && list.get(0).dataType() == DataType.NULL) {
+        if (Expressions.isNull(value) || list.size() == 1 && Expressions.isNull(list.get(0))) {
             return null;
         }
         return InProcessor.apply(value.fold(), Foldables.valuesOf(list, value.dataType()));
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypeConversion.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypeConversion.java
index cff0e13cfb846..e3f97fa7240e3 100644
--- a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypeConversion.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypeConversion.java
@@ -86,14 +86,18 @@ public static DataType commonType(DataType left, DataType right) {
 
         // interval and dates
         if (left == DATE) {
-            if (right.isInterval()) {
+            if (right.isYearMonthInterval()) {
                 return left;
             }
+            // promote
+            return DATETIME;
         }
         if (right == DATE) {
-            if (left.isInterval()) {
+            if (left.isYearMonthInterval()) {
                 return right;
             }
+            // promote
+            return DATETIME;
         }
         if (left == TIME) {
             if (right == DATE) {
diff --git a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/LiteralTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/LiteralTests.java
index 01e0a2ba5f4f0..fca1ca0726a08 100644
--- a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/LiteralTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/expression/LiteralTests.java
@@ -51,7 +51,8 @@ static class ValueAndCompatibleTypes {
 
     public static Literal randomLiteral() {
         ValueAndCompatibleTypes gen = randomFrom(GENERATORS);
-        return new Literal(SourceTests.randomSource(), gen.valueSupplier.get(), randomFrom(gen.validDataTypes));
+        DataType dataType = randomFrom(gen.validDataTypes);
+        return new Literal(SourceTests.randomSource(), DataTypeConversion.convert(gen.valueSupplier.get(), dataType), dataType);
     }
 
     @Override
diff --git a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypeConversionTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypeConversionTests.java
index 77c5f097131fa..1258e05432b1f 100644
--- a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypeConversionTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/DataTypeConversionTests.java
@@ -640,8 +640,8 @@ public void testCommonType() {
         assertEquals(DATETIME, commonType(randomInterval(), DATETIME));
         assertEquals(DATETIME, commonType(DATE, TIME));
         assertEquals(DATETIME, commonType(TIME, DATE));
-        assertEquals(DATE, commonType(DATE, randomInterval()));
-        assertEquals(DATE, commonType(randomInterval(), DATE));
+        assertEquals(DATE, commonType(DATE, INTERVAL_YEAR));
+        assertEquals(DATETIME, commonType(DATE, INTERVAL_HOUR_TO_MINUTE));
         assertEquals(TIME, commonType(TIME, randomInterval()));
         assertEquals(TIME, commonType(randomInterval(), TIME));
 
diff --git a/x-pack/plugin/sql/qa/src/main/resources/conditionals.csv-spec b/x-pack/plugin/sql/qa/src/main/resources/conditionals.csv-spec
index 9f424da2710e3..e6453ad1420e1 100644
--- a/x-pack/plugin/sql/qa/src/main/resources/conditionals.csv-spec
+++ b/x-pack/plugin/sql/qa/src/main/resources/conditionals.csv-spec
@@ -441,7 +441,7 @@ SELECT ISNULL(birth_date, INTERVAL '23:45' HOUR TO MINUTES + {d '2019-09-17'}) A
          c:ts           |    salary:i     |      birth_date:ts     |       hire_date:ts        
 ------------------------+-----------------+------------------------+------------------------
 1956-12-13T00:00:00.000Z|74999            |1956-12-13T00:00:00.000Z|1985-11-20T00:00:00.000Z
-2019-09-17T00:00:00.000Z|74970            |null                    |1989-09-02T00:00:00.000Z
+2019-09-17T23:45:00.000Z|74970            |null                    |1989-09-02T00:00:00.000Z
 1957-05-23T00:00:00.000Z|74572            |1957-05-23T00:00:00.000Z|1989-02-10T00:00:00.000Z
 1962-07-10T00:00:00.000Z|73851            |1962-07-10T00:00:00.000Z|1989-07-07T00:00:00.000Z
 1953-01-23T00:00:00.000Z|73717            |1953-01-23T00:00:00.000Z|1999-04-30T00:00:00.000Z
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
index c437b704035d0..31377efc2823d 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/Cast.java
@@ -6,6 +6,7 @@
 package org.elasticsearch.xpack.sql.expression.function.scalar;
 
 import org.elasticsearch.xpack.ql.expression.Expression;
+import org.elasticsearch.xpack.ql.expression.Expressions;
 import org.elasticsearch.xpack.ql.expression.Nullability;
 import org.elasticsearch.xpack.ql.expression.function.scalar.UnaryScalarFunction;
 import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
@@ -64,10 +65,7 @@ public Object fold() {
 
     @Override
     public Nullability nullable() {
-        if (from().isNull()) {
-            return Nullability.TRUE;
-        }
-        return Nullability.UNKNOWN;
+        return Expressions.isNull(field()) ? Nullability.TRUE : Nullability.UNKNOWN;
     }
 
     @Override
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathProcessor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathProcessor.java
index 7e1e13b60e9f0..bc13b8ef36f21 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathProcessor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathProcessor.java
@@ -8,7 +8,9 @@
 import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
 import org.elasticsearch.xpack.ql.expression.gen.processor.Processor;
+import org.elasticsearch.xpack.ql.type.DataTypeConversion;
 import org.elasticsearch.xpack.sql.SqlIllegalArgumentException;
 
 import java.io.IOException;
@@ -21,17 +23,38 @@ public class MathProcessor implements Processor {
     
     public enum MathOperation {
         ABS((Object l) -> {
-            if (l instanceof Float) {
-                return Double.valueOf(Math.abs(((Float) l).floatValue()));
-            }
             if (l instanceof Double) {
                 return Math.abs(((Double) l).doubleValue());
             }
+            if (l instanceof Float) {
+                return Math.abs(((Float) l).floatValue());
+            }
+
+            // fallback to integer
             long lo = ((Number) l).longValue();
-            //handles the corner-case of Long.MIN_VALUE
-            return lo >= 0 ? lo : lo == Long.MIN_VALUE ? Double.valueOf(Long.MAX_VALUE) : -lo;
-        }),
 
+            if (lo == Long.MIN_VALUE) {
+                throw new QlIllegalArgumentException("[" + lo + "] cannot be negated since the result is outside the range");
+            }
+
+            lo = lo < 0 ? -lo : lo;
+
+            if (l instanceof Integer) {
+                if ((int) lo == Integer.MIN_VALUE) {
+                    throw new QlIllegalArgumentException("[" + lo + "] cannot be negated since the result is outside the range");
+                }
+                return DataTypeConversion.safeToInt(lo);
+            }
+
+            if (l instanceof Short) {
+                return DataTypeConversion.safeToShort(lo);
+            }
+            if (l instanceof Byte) {
+                return DataTypeConversion.safeToByte(lo);
+            }
+
+            return lo;
+        }),
         ACOS(Math::acos),
         ASIN(Math::asin),
         ATAN(Math::atan),
@@ -52,15 +75,37 @@ public enum MathOperation {
         RANDOM((Object l) -> l != null ?
                 new Random(((Number) l).longValue()).nextDouble() :
                 Randomness.get().nextDouble(), true),
-        SIGN((DoubleFunction<Double>) Math::signum),
+        SIGN((Object l) -> {
+            if (l instanceof Double) {
+                return Math.signum((Double) l);
+            }
+            if (l instanceof Float) {
+                return Math.signum((Float) l);
+            }
+
+            long lo = Long.signum(((Number) l).longValue());
+
+            if (l instanceof Integer) {
+                return DataTypeConversion.safeToInt(lo);
+            }
+            if (l instanceof Short) {
+                return DataTypeConversion.safeToShort(lo);
+            }
+            if (l instanceof Byte) {
+                return DataTypeConversion.safeToByte(lo);
+            }
+
+            //fallback to generic double
+            return lo;
+        }),
         SIN(Math::sin),
         SINH(Math::sinh),
         SQRT(Math::sqrt),
         TAN(Math::tan);
 
-        private final Function<Object, Double> apply;
+        private final Function<Object, Number> apply;
 
-        MathOperation(Function<Object, Double> apply) {
+        MathOperation(Function<Object, Number> apply) {
             this(apply, false);
         }
 
@@ -69,7 +114,7 @@ public enum MathOperation {
          * If true, nulls are passed through, otherwise the function is short-circuited
          * and null returned.
          */
-        MathOperation(Function<Object, Double> apply, boolean nullAware) {
+        MathOperation(Function<Object, Number> apply, boolean nullAware) {
             if (nullAware) {
                 this.apply = apply;
             } else {
@@ -85,7 +130,7 @@ public enum MathOperation {
             this.apply = l -> supplier.get();
         }
 
-        public final Double apply(Object l) {
+        public final Number apply(Object l) {
             return apply.apply(l);
         }
     }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalSqlScriptUtils.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalSqlScriptUtils.java
index 6778cbfcc8d2c..2eea2da544037 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalSqlScriptUtils.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/expression/function/scalar/whitelist/InternalSqlScriptUtils.java
@@ -130,19 +130,19 @@ public static Number truncate(Number v, Number s) {
         return BinaryOptionalMathOperation.TRUNCATE.apply(v, s);
     }
 
-    public static Double abs(Number value) {
+    public static Number abs(Number value) {
         return MathOperation.ABS.apply(value);
     }
 
-    public static Double acos(Number value) {
+    public static Number acos(Number value) {
         return MathOperation.ACOS.apply(value);
     }
 
-    public static Double asin(Number value) {
+    public static Number asin(Number value) {
         return MathOperation.ASIN.apply(value);
     }
 
-    public static Double atan(Number value) {
+    public static Number atan(Number value) {
         return MathOperation.ATAN.apply(value);
     }
 
@@ -150,55 +150,55 @@ public static Number atan2(Number left, Number right) {
         return BinaryMathOperation.ATAN2.apply(left, right);
     }
 
-    public static Double cbrt(Number value) {
+    public static Number cbrt(Number value) {
         return MathOperation.CBRT.apply(value);
     }
 
-    public static Double ceil(Number value) {
+    public static Number ceil(Number value) {
         return MathOperation.CEIL.apply(value);
     }
 
-    public static Double cos(Number value) {
+    public static Number cos(Number value) {
         return MathOperation.COS.apply(value);
     }
 
-    public static Double cosh(Number value) {
+    public static Number cosh(Number value) {
         return MathOperation.COSH.apply(value);
     }
 
-    public static Double cot(Number value) {
+    public static Number cot(Number value) {
         return MathOperation.COT.apply(value);
     }
 
-    public static Double degrees(Number value) {
+    public static Number degrees(Number value) {
         return MathOperation.DEGREES.apply(value);
     }
 
-    public static Double e(Number value) {
+    public static Number e(Number value) {
         return MathOperation.E.apply(value);
     }
 
-    public static Double exp(Number value) {
+    public static Number exp(Number value) {
         return MathOperation.EXP.apply(value);
     }
 
-    public static Double expm1(Number value) {
+    public static Number expm1(Number value) {
         return MathOperation.EXPM1.apply(value);
     }
 
-    public static Double floor(Number value) {
+    public static Number floor(Number value) {
         return MathOperation.FLOOR.apply(value);
     }
 
-    public static Double log(Number value) {
+    public static Number log(Number value) {
         return MathOperation.LOG.apply(value);
     }
 
-    public static Double log10(Number value) {
+    public static Number log10(Number value) {
         return MathOperation.LOG10.apply(value);
     }
 
-    public static Double pi(Number value) {
+    public static Number pi(Number value) {
         return MathOperation.PI.apply(value);
     }
 
@@ -206,31 +206,31 @@ public static Number power(Number left, Number right) {
         return BinaryMathOperation.POWER.apply(left, right);
     }
 
-    public static Double radians(Number value) {
+    public static Number radians(Number value) {
         return MathOperation.RADIANS.apply(value);
     }
 
-    public static Double random(Number value) {
+    public static Number random(Number value) {
         return MathOperation.RANDOM.apply(value);
     }
 
-    public static Double sign(Number value) {
+    public static Number sign(Number value) {
         return MathOperation.SIGN.apply(value);
     }
 
-    public static Double sin(Number value) {
+    public static Number sin(Number value) {
         return MathOperation.SIN.apply(value);
     }
 
-    public static Double sinh(Number value) {
+    public static Number sinh(Number value) {
         return MathOperation.SINH.apply(value);
     }
 
-    public static Double sqrt(Number value) {
+    public static Number sqrt(Number value) {
         return MathOperation.SQRT.apply(value);
     }
 
-    public static Double tan(Number value) {
+    public static Number tan(Number value) {
         return MathOperation.TAN.apply(value);
     }
 
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
index c52f1722c7e76..06e90a755ecfe 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/optimizer/Optimizer.java
@@ -705,7 +705,7 @@ static class ConstantFolding extends OptimizerExpressionRule {
 
         @Override
         protected Expression rule(Expression e) {
-            return e.foldable() && (e instanceof Literal == false) ? Literal.of(e) : e;
+            return e.foldable() ? Literal.of(e) : e;
         }
     }
 
@@ -808,7 +808,7 @@ private Expression simplifyAndOr(BinaryPredicate<?, ?, ?, ?> bc) {
                 }
 
                 if (FALSE.equals(l) || FALSE.equals(r)) {
-                    return FALSE;
+                    return new Literal(bc.source(), Boolean.FALSE, DataType.BOOLEAN);
                 }
                 if (l.semanticEquals(r)) {
                     return l;
@@ -838,7 +838,7 @@ private Expression simplifyAndOr(BinaryPredicate<?, ?, ?, ?> bc) {
 
             if (bc instanceof Or) {
                 if (TRUE.equals(l) || TRUE.equals(r)) {
-                    return TRUE;
+                    return new Literal(bc.source(), Boolean.TRUE, DataType.BOOLEAN);
                 }
 
                 if (FALSE.equals(l)) {
@@ -883,10 +883,10 @@ private Expression simplifyNot(Not n) {
             Expression c = n.field();
 
             if (TRUE.semanticEquals(c)) {
-                return FALSE;
+                return new Literal(n.source(), Boolean.FALSE, DataType.BOOLEAN);
             }
             if (FALSE.semanticEquals(c)) {
-                return TRUE;
+                return new Literal(n.source(), Boolean.TRUE, DataType.BOOLEAN);
             }
 
             if (c instanceof Negatable) {
@@ -919,12 +919,12 @@ private Expression simplify(BinaryComparison bc) {
             // true for equality
             if (bc instanceof Equals || bc instanceof GreaterThanOrEqual || bc instanceof LessThanOrEqual) {
                 if (l.nullable() == Nullability.FALSE && r.nullable() == Nullability.FALSE && l.semanticEquals(r)) {
-                    return TRUE;
+                    return new Literal(bc.source(), Boolean.TRUE, DataType.BOOLEAN);
                 }
             }
             if (bc instanceof NullEquals) {
                 if (l.semanticEquals(r)) {
-                    return TRUE;
+                    return new Literal(bc.source(), Boolean.TRUE, DataType.BOOLEAN);
                 }
                 if (Expressions.isNull(r)) {
                     return new IsNull(bc.source(), l);
@@ -934,7 +934,7 @@ private Expression simplify(BinaryComparison bc) {
             // false for equality
             if (bc instanceof NotEquals || bc instanceof GreaterThan || bc instanceof LessThan) {
                 if (l.nullable() == Nullability.FALSE && r.nullable() == Nullability.FALSE && l.semanticEquals(r)) {
-                    return FALSE;
+                    return new Literal(bc.source(), Boolean.FALSE, DataType.BOOLEAN);
                 }
             }
 
@@ -1006,19 +1006,19 @@ private Expression propagate(And and) {
                     if (otherEq.right().foldable()) {
                         for (BinaryComparison eq : equals) {
                             if (otherEq.left().semanticEquals(eq.left())) {
-                                Integer comp = BinaryComparison.compare(eq.right().fold(), otherEq.right().fold());
-                                if (comp != null) {
-                                    // var cannot be equal to two different values at the same time
-                                    if (comp != 0) {
-                                        return FALSE;
+                                    Integer comp = BinaryComparison.compare(eq.right().fold(), otherEq.right().fold());
+                                    if (comp != null) {
+                                        // var cannot be equal to two different values at the same time
+                                        if (comp != 0) {
+                                            return new Literal(and.source(), Boolean.FALSE, DataType.BOOLEAN);
+                                        }
                                     }
                                 }
                             }
-                        }
                         equals.add(otherEq);
                     } else {
                         exps.add(otherEq);
-                    }
+                        }
                 } else if (ex instanceof GreaterThan || ex instanceof GreaterThanOrEqual ||
                     ex instanceof LessThan || ex instanceof LessThanOrEqual) {
                     BinaryComparison bc = (BinaryComparison) ex;
@@ -1031,12 +1031,12 @@ private Expression propagate(And and) {
                     NotEquals otherNotEq = (NotEquals) ex;
                     if (otherNotEq.right().foldable()) {
                         notEquals.add(otherNotEq);
-                    } else {
-                        exps.add(ex);
-                    }
                 } else {
                     exps.add(ex);
                 }
+                } else {
+                    exps.add(ex);
+            }
             }
 
             // check
@@ -1055,8 +1055,8 @@ private Expression propagate(And and) {
                                  compare > 0 ||
                                  // eq matches the boundary but should not be included
                                  (compare == 0 && !range.includeLower()))
-                                ) {
-                                return FALSE;
+                            ) {
+                                return new Literal(and.source(), Boolean.FALSE, DataType.BOOLEAN);
                             }
                         }
                         if (range.upper().foldable()) {
@@ -1066,8 +1066,8 @@ private Expression propagate(And and) {
                                  compare < 0 ||
                                  // eq matches the boundary but should not be included
                                  (compare == 0 && !range.includeUpper()))
-                                ) {
-                                return FALSE;
+                            ) {
+                                return new Literal(and.source(), Boolean.FALSE, DataType.BOOLEAN);
                             }
                         }
 
@@ -1088,7 +1088,7 @@ private Expression propagate(And and) {
                             } else {
                                 iter.remove(); // clashing and redundant: a = 1 AND a != 2
                                 changed = true;
-                            }
+            }
                         }
                     }
                 }
@@ -1103,12 +1103,12 @@ private Expression propagate(And and) {
                                 if ((compare == 0 && bc instanceof LessThan) || // a = 2 AND a < 2
                                     0 < compare) { // a = 2 AND a </<= 1
                                     return FALSE;
-                                }
+        }
                             } else if (bc instanceof GreaterThan || bc instanceof GreaterThanOrEqual) { // a = 2 AND a >/>= ?
                                 if ((compare == 0 && bc instanceof GreaterThan) || // a = 2 AND a > 2
                                     compare < 0) { // a = 2 AND a >/>= 3
                                     return FALSE;
-                                }
+    }
                             }
 
                             iter.remove();
@@ -1950,7 +1950,7 @@ private static Expression foldBinaryLogic(Expression expression) {
                 boolean nullLeft = Expressions.isNull(or.left());
                 boolean nullRight = Expressions.isNull(or.right());
                 if (nullLeft && nullRight) {
-                    return Literal.NULL;
+                    return new Literal(expression.source(), null, DataType.NULL);
                 }
                 if (nullLeft) {
                     return or.right();
@@ -1962,7 +1962,7 @@ private static Expression foldBinaryLogic(Expression expression) {
             if (expression instanceof And) {
                 And and = (And) expression;
                 if (Expressions.isNull(and.left()) || Expressions.isNull(and.right())) {
-                    return Literal.NULL;
+                    return new Literal(expression.source(), null, DataType.NULL);
                 }
             }
             return expression;
diff --git a/x-pack/plugin/sql/src/main/resources/org/elasticsearch/xpack/sql/plugin/sql_whitelist.txt b/x-pack/plugin/sql/src/main/resources/org/elasticsearch/xpack/sql/plugin/sql_whitelist.txt
index 771b5aa9046e1..b38620c033c96 100644
--- a/x-pack/plugin/sql/src/main/resources/org/elasticsearch/xpack/sql/plugin/sql_whitelist.txt
+++ b/x-pack/plugin/sql/src/main/resources/org/elasticsearch/xpack/sql/plugin/sql_whitelist.txt
@@ -82,30 +82,30 @@ class org.elasticsearch.xpack.sql.expression.function.scalar.whitelist.InternalS
   Number round(Number, Number)
   Number truncate(Number, Number)
   
-  Double abs(Number)
-  Double acos(Number)
-  Double asin(Number)
-  Double atan(Number)
-  Double cbrt(Number)
-  Double ceil(Number)
-  Double cos(Number)
-  Double cosh(Number)
-  Double cot(Number)
-  Double degrees(Number)
-  Double e(Number)
-  Double exp(Number)
-  Double expm1(Number)
-  Double floor(Number)
-  Double log(Number)
-  Double log10(Number)
-  Double pi(Number)
-  Double radians(Number)
-  Double random(Number)
-  Double sign(Number)
-  Double sin(Number)
-  Double sinh(Number)
-  Double sqrt(Number)
-  Double tan(Number)
+  Number abs(Number)
+  Number acos(Number)
+  Number asin(Number)
+  Number atan(Number)
+  Number cbrt(Number)
+  Number ceil(Number)
+  Number cos(Number)
+  Number cosh(Number)
+  Number cot(Number)
+  Number degrees(Number)
+  Number e(Number)
+  Number exp(Number)
+  Number expm1(Number)
+  Number floor(Number)
+  Number log(Number)
+  Number log10(Number)
+  Number pi(Number)
+  Number radians(Number)
+  Number random(Number)
+  Number sign(Number)
+  Number sin(Number)
+  Number sinh(Number)
+  Number sqrt(Number)
+  Number tan(Number)
   
 #
 # Date/Time functions 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathOperationTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathOperationTests.java
new file mode 100644
index 0000000000000..3c1c880a8b457
--- /dev/null
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/expression/function/scalar/math/MathOperationTests.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.sql.expression.function.scalar.math;
+
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.ql.QlIllegalArgumentException;
+import org.elasticsearch.xpack.sql.expression.function.scalar.math.MathProcessor.MathOperation;
+
+public class MathOperationTests extends ESTestCase {
+
+    public void testAbsLongMax() {
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> MathOperation.ABS.apply(Long.MIN_VALUE));
+        assertTrue(ex.getMessage().contains("cannot be negated"));
+    }
+
+    public void testAbsIntegerMax() {
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> MathOperation.ABS.apply(Integer.MIN_VALUE));
+        assertTrue(ex.getMessage().contains("cannot be negated"));
+    }
+
+    public void testAbsShortMax() {
+        QlIllegalArgumentException ex = expectThrows(QlIllegalArgumentException.class, () -> MathOperation.ABS.apply(Short.MIN_VALUE));
+        assertTrue(ex.getMessage().contains("out of"));
+    }
+
+    public void testAbsPreservesType() {
+        assertEquals((byte) 42, MathOperation.ABS.apply((byte) -42));
+        assertEquals((short) 42, MathOperation.ABS.apply((short) -42));
+        assertEquals(42, MathOperation.ABS.apply(-42));
+        assertEquals((long) 42, MathOperation.ABS.apply((long) -42));
+        assertEquals(42f, MathOperation.ABS.apply(-42f));
+        assertEquals(42d, MathOperation.ABS.apply(-42d));
+    }
+}
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
index 5037b74885d80..1c11ee3a4460c 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/planner/QueryTranslatorTests.java
@@ -249,15 +249,15 @@ public void testDateRangeWithCurrentTimestamp() {
     public void testDateRangeWithCurrentDate() {
         testDateRangeWithCurrentFunctions("CURRENT_DATE()", DATE_FORMAT, DateUtils.asDateOnly(TestUtils.TEST_CFG.now()));
         testDateRangeWithCurrentFunctions_AndRangeOptimization("CURRENT_DATE()", DATE_FORMAT,
-                DateUtils.asDateOnly(TestUtils.TEST_CFG.now().minusDays(2L)),
-                DateUtils.asDateOnly(TestUtils.TEST_CFG.now().plusDays(1L)));
+                DateUtils.asDateOnly(TestUtils.TEST_CFG.now().minusDays(1L)).minusSeconds(1),
+                DateUtils.asDateOnly(TestUtils.TEST_CFG.now().plusDays(1L)).plusSeconds(1));
     }
 
     public void testDateRangeWithToday() {
         testDateRangeWithCurrentFunctions("TODAY()", DATE_FORMAT, DateUtils.asDateOnly(TestUtils.TEST_CFG.now()));
         testDateRangeWithCurrentFunctions_AndRangeOptimization("TODAY()", DATE_FORMAT,
-                DateUtils.asDateOnly(TestUtils.TEST_CFG.now().minusDays(2L)),
-                DateUtils.asDateOnly(TestUtils.TEST_CFG.now().plusDays(1L)));
+                DateUtils.asDateOnly(TestUtils.TEST_CFG.now().minusDays(1L)).minusSeconds(1),
+                DateUtils.asDateOnly(TestUtils.TEST_CFG.now().plusDays(1L)).plusSeconds(1));
     }
 
     public void testDateRangeWithNow() {

From 29599df1ba069d6f2a585e99a1c01450c3cab279 Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Wed, 15 Jan 2020 09:49:38 +0000
Subject: [PATCH 587/686] Tweak formatter config for long generic lines
 (#50909)

The current formatting config allows some long generic declarations to
break the 140 character limit. Tweak the config to wrap such lines.
---
 .eclipseformat.xml                                        | 6 +++---
 .../master/MasterNodeReadOperationRequestBuilder.java     | 8 +++++---
 .../enrich/action/TransportExecuteEnrichPolicyAction.java | 5 +++--
 .../enrich/action/TransportGetEnrichPolicyAction.java     | 5 +++--
 4 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/.eclipseformat.xml b/.eclipseformat.xml
index ebda0af1503e5..9e913b41926a8 100644
--- a/.eclipseformat.xml
+++ b/.eclipseformat.xml
@@ -62,7 +62,7 @@
         <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_arguments" value="do not insert"/>
         <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_method" value="insert"/>
         <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_switch" value="do not insert"/>
-        <setting id="org.eclipse.jdt.core.formatter.alignment_for_parameterized_type_references" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_parameterized_type_references" value="48"/>
         <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_anonymous_type_declaration" value="insert"/>
         <setting id="org.eclipse.jdt.core.formatter.alignment_for_logical_operator" value="48"/>
         <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_parenthesized_expression" value="do not insert"/>
@@ -129,7 +129,7 @@
         <setting id="org.eclipse.jdt.core.formatter.insert_space_before_bitwise_operator" value="insert"/>
         <setting id="org.eclipse.jdt.core.formatter.put_empty_statement_on_new_line" value="true"/>
         <setting id="org.eclipse.jdt.core.formatter.alignment_for_parameters_in_constructor_declaration" value="48"/>
-        <setting id="org.eclipse.jdt.core.formatter.alignment_for_type_parameters" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_type_parameters" value="48"/>
         <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_invocation_arguments" value="insert"/>
         <setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_method_invocation" value="48"/>
         <setting id="org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_constructor_declaration" value="64"/>
@@ -242,7 +242,7 @@
         <setting id="org.eclipse.jdt.core.formatter.alignment_for_compact_if" value="16"/>
         <setting id="org.eclipse.jdt.core.formatter.keep_lambda_body_block_on_one_line" value="one_line_if_single_item"/>
         <setting id="org.eclipse.jdt.core.formatter.indent_empty_lines" value="false"/>
-        <setting id="org.eclipse.jdt.core.formatter.alignment_for_type_arguments" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_type_arguments" value="48"/>
         <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_parameterized_type_reference" value="do not insert"/>
         <setting id="org.eclipse.jdt.core.formatter.insert_space_after_unary_operator" value="do not insert"/>
         <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_enum_constant" value="do not insert"/>
diff --git a/server/src/main/java/org/elasticsearch/action/support/master/MasterNodeReadOperationRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/support/master/MasterNodeReadOperationRequestBuilder.java
index f385746365e9a..f7852e43148c0 100644
--- a/server/src/main/java/org/elasticsearch/action/support/master/MasterNodeReadOperationRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/support/master/MasterNodeReadOperationRequestBuilder.java
@@ -26,9 +26,11 @@
 /**
  * Base request builder for master node read operations that can be executed on the local node as well
  */
-public abstract class MasterNodeReadOperationRequestBuilder<Request extends MasterNodeReadRequest<Request>, Response extends ActionResponse,
-        RequestBuilder extends MasterNodeReadOperationRequestBuilder<Request, Response, RequestBuilder>>
-        extends MasterNodeOperationRequestBuilder<Request, Response, RequestBuilder> {
+public abstract class MasterNodeReadOperationRequestBuilder<
+        Request extends MasterNodeReadRequest<Request>,
+        Response extends ActionResponse,
+        RequestBuilder extends MasterNodeReadOperationRequestBuilder<Request, Response, RequestBuilder>
+    > extends MasterNodeOperationRequestBuilder<Request, Response, RequestBuilder> {
 
     protected MasterNodeReadOperationRequestBuilder(ElasticsearchClient client, ActionType<Response> action, Request request) {
         super(client, action, request);
diff --git a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/TransportExecuteEnrichPolicyAction.java b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/TransportExecuteEnrichPolicyAction.java
index 080a119d6564f..f288d5e71b80a 100644
--- a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/TransportExecuteEnrichPolicyAction.java
+++ b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/TransportExecuteEnrichPolicyAction.java
@@ -29,8 +29,9 @@
 
 import java.io.IOException;
 
-public class TransportExecuteEnrichPolicyAction extends
-    TransportMasterNodeAction<ExecuteEnrichPolicyAction.Request, ExecuteEnrichPolicyAction.Response> {
+public class TransportExecuteEnrichPolicyAction extends TransportMasterNodeAction<
+    ExecuteEnrichPolicyAction.Request,
+    ExecuteEnrichPolicyAction.Response> {
 
     private final EnrichPolicyExecutor executor;
 
diff --git a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/TransportGetEnrichPolicyAction.java b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/TransportGetEnrichPolicyAction.java
index 46fe85b7307c6..59f3f20ee5bab 100644
--- a/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/TransportGetEnrichPolicyAction.java
+++ b/x-pack/plugin/enrich/src/main/java/org/elasticsearch/xpack/enrich/action/TransportGetEnrichPolicyAction.java
@@ -26,8 +26,9 @@
 import java.util.HashMap;
 import java.util.Map;
 
-public class TransportGetEnrichPolicyAction extends
-    TransportMasterNodeReadAction<GetEnrichPolicyAction.Request, GetEnrichPolicyAction.Response> {
+public class TransportGetEnrichPolicyAction extends TransportMasterNodeReadAction<
+    GetEnrichPolicyAction.Request,
+    GetEnrichPolicyAction.Response> {
 
     @Inject
     public TransportGetEnrichPolicyAction(

From b9aa9dfe83986b26b6a88f4c5e74ce2a5866b7d3 Mon Sep 17 00:00:00 2001
From: Tom Veasey <tveasey@users.noreply.github.com>
Date: Wed, 15 Jan 2020 09:52:48 +0000
Subject: [PATCH 588/686] [ML] Assert top classes are ordered by score (#51003)

---
 .../xpack/ml/integration/ClassificationIT.java        | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
index 14c855ef68e77..d1c8c6c4c75ef 100644
--- a/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
+++ b/x-pack/plugin/ml/qa/native-multi-node-tests/src/test/java/org/elasticsearch/xpack/ml/integration/ClassificationIT.java
@@ -5,8 +5,7 @@
  */
 package org.elasticsearch.xpack.ml.integration;
 
-// Pending fix
-//import com.google.common.collect.Ordering;
+import com.google.common.collect.Ordering;
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.admin.indices.get.GetIndexAction;
 import org.elasticsearch.action.admin.indices.get.GetIndexRequest;
@@ -582,9 +581,11 @@ private static <T> void assertTopClasses(Map<String, Object> resultsObject,
         assertThat(topClasses, hasSize(numTopClasses));
         List<T> classNames = new ArrayList<>(topClasses.size());
         List<Double> classProbabilities = new ArrayList<>(topClasses.size());
+        List<Double> classScores = new ArrayList<>(topClasses.size());
         for (Map<String, Object> topClass : topClasses) {
             classNames.add(getFieldValue(topClass, "class_name"));
             classProbabilities.add(getFieldValue(topClass, "class_probability"));
+            classScores.add(getFieldValue(topClass, "class_score"));
         }
         // Assert that all the predicted class names come from the set of dependent variable values.
         classNames.forEach(className -> assertThat(className, is(in(dependentVariableValues))));
@@ -592,10 +593,8 @@ private static <T> void assertTopClasses(Map<String, Object> resultsObject,
         assertThat(classNames.get(0), equalTo(resultsObject.get(dependentVariable + "_prediction")));
         // Assert that all the class probabilities lie within [0, 1] interval.
         classProbabilities.forEach(p -> assertThat(p, allOf(greaterThanOrEqualTo(0.0), lessThanOrEqualTo(1.0))));
-        // Assert that the top classes are listed in the order of decreasing probabilities.
-        // This is not true after https://github.com/elastic/ml-cpp/pull/926. I'll fix and re-enable
-        // once that change is merged.
-        //assertThat(Ordering.natural().reverse().isOrdered(classProbabilities), is(true));
+        // Assert that the top classes are listed in the order of decreasing scores.
+        assertThat(Ordering.natural().reverse().isOrdered(classScores), is(true));
     }
 
     private <T> void assertEvaluation(String dependentVariable, List<T> dependentVariableValues, String predictedClassField) {

From 9a9164a806c3d406d120fa74f1a836ac9364762f Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Wed, 15 Jan 2020 13:19:06 +0000
Subject: [PATCH 589/686] Auto-format buildSrc (#50786)

Opt-in buildSrc for automatic formatting. This required a config tweak
in order to pick up all the Java sources, and as a result more files are
now found in the Enrich plugin, that were previously missed.

Following on from the formatting, improve some code's layout, most notably by
replacing a number of String concatentations with String.format().
---
 build.gradle                                  |   5 +
 .../elasticsearch/gradle/reaper/Reaper.java   |   6 +-
 .../org/elasticsearch/gradle/BwcVersions.java | 108 ++-
 .../elasticsearch/gradle/ConcatFilesTask.java |  17 +-
 .../gradle/DistributionDownloadPlugin.java    |  31 +-
 .../gradle/ElasticsearchDistribution.java     |  27 +-
 ...ExportElasticsearchBuildResourcesTask.java |  27 +-
 .../elasticsearch/gradle/FileSupplier.java    |   3 +-
 .../java/org/elasticsearch/gradle/Jdk.java    |   8 +-
 .../gradle/JdkDownloadPlugin.java             |  93 ++-
 .../elasticsearch/gradle/LazyPropertyMap.java |   9 +-
 .../gradle/LoggingOutputStream.java           |   8 +-
 .../elasticsearch/gradle/ReaperPlugin.java    |  11 +-
 .../elasticsearch/gradle/ReaperService.java   |  27 +-
 .../gradle/http/WaitForHttpResource.java      |  11 +-
 .../info/GenerateGlobalBuildInfoTask.java     |  65 +-
 .../gradle/info/GlobalBuildInfoPlugin.java    |  47 +-
 .../precommit/DependencyLicensesTask.java     |  30 +-
 .../gradle/precommit/FilePermissionsTask.java |  34 +-
 .../precommit/ForbiddenPatternsTask.java      |  31 +-
 .../gradle/precommit/LoggerUsageTask.java     |  11 +-
 .../gradle/precommit/PrecommitTask.java       |   2 +-
 .../precommit/TestingConventionRule.java      |   7 +-
 .../precommit/TestingConventionsTasks.java    | 156 ++--
 .../gradle/precommit/ThirdPartyAuditTask.java |  52 +-
 .../gradle/tar/SymbolicLinkPreservingTar.java |  12 +-
 .../tar/SymbolicLinkPreservingUntarTask.java  |  14 +-
 .../gradle/test/BatsTestTask.java             |   6 +-
 .../gradle/test/DistroTestPlugin.java         | 232 +++---
 .../test/ErrorReportingTestListener.java      |  10 +-
 .../gradle/test/JNAKernel32Library.java       |   0
 .../testclusters/ElasticsearchCluster.java    |  34 +-
 .../testclusters/ElasticsearchNode.java       | 264 +++---
 .../testclusters/RestTestRunnerTask.java      |  26 +-
 .../gradle/testclusters/RunTask.java          |  33 +-
 .../TestClusterConfiguration.java             |  35 +-
 .../testclusters/TestClustersAware.java       |  12 +-
 .../testclusters/TestClustersPlugin.java      |  77 +-
 .../testclusters/TestClustersRegistry.java    |  11 +-
 .../testfixtures/TestFixtureExtension.java    |  31 +-
 .../testfixtures/TestFixturesPlugin.java      | 130 ++-
 .../gradle/tool/Boilerplate.java              |  28 +-
 .../gradle/tool/ClasspathUtils.java           |   3 +-
 .../gradle/tool/DockerUtils.java              |  28 +-
 .../gradle/vagrant/BatsProgressLogger.java    |   7 +-
 .../gradle/vagrant/VagrantBasePlugin.java     |  32 +-
 .../gradle/vagrant/VagrantShellTask.java      |  18 +-
 .../elasticsearch/gradle/JdkJarHellCheck.java |   6 +-
 .../gradle/LazyFileOutputStream.java          |   2 +
 .../org/elasticsearch/gradle/LoggedExec.java  |   4 +-
 .../org/elasticsearch/gradle/Version.java     |  28 +-
 .../gradle/VersionProperties.java             |   2 +-
 .../gradle/info/BuildParams.java              |  33 +-
 .../elasticsearch/gradle/BuildPluginIT.java   |  38 +-
 .../gradle/BuildPluginTests.java              |   1 -
 .../gradle/BwcVersionsTests.java              | 771 +++++++++++++-----
 .../gradle/ConcatFilesTaskTests.java          |   7 +-
 .../gradle/DistributionDownloadPluginIT.java  | 103 ++-
 .../DistributionDownloadPluginTests.java      | 193 ++++-
 ...portElasticsearchBuildResourcesTaskIT.java |  26 +-
 .../gradle/JdkDownloadPluginIT.java           |  20 +-
 .../gradle/JdkDownloadPluginTests.java        |  21 +-
 .../elasticsearch/gradle/VersionTests.java    |  42 +-
 .../doc/RestTestFromSnippetsTaskTests.java    |   6 +-
 .../gradle/http/WaitForHttpResourceTests.java |   4 +-
 .../gradle/plugin/PluginBuildPluginTests.java |  26 +-
 .../PluginPropertiesExtensionTests.java       |   8 +-
 .../DependencyLicensesTaskTests.java          |  11 +-
 .../precommit/FilePermissionsTaskTests.java   |   1 -
 .../precommit/TestingConventionsTasksIT.java  |  96 ++-
 .../precommit/ThirdPartyAuditTaskIT.java      | 108 +--
 .../gradle/precommit/UpdateShasTaskTests.java |  22 +-
 .../tar/SymbolicLinkPreservingTarIT.java      |  25 +-
 .../gradle/test/BaseTestCase.java             |  13 +-
 .../gradle/test/DistroTestPluginTests.java    |  33 +-
 .../test/GradleIntegrationTestCase.java       |  63 +-
 .../gradle/test/GradleUnitTestCase.java       |  12 +-
 .../gradle/test/JUnit3MethodProvider.java     |  13 +-
 .../gradle/testkit/NamingConventionIT.java    |   2 +-
 ...ooksLikeATestWithoutNamingConvention1.java |   2 +-
 ...ooksLikeATestWithoutNamingConvention3.java |   5 +-
 .../testkit/LooksLikeTestsButAbstract.java    |   3 -
 .../gradle/testkit/NamingConventionIT.java    |   2 +-
 .../gradle/testkit/NamingConventionTests.java |   2 +-
 .../gradle/testkit/Integration.java           |   2 +-
 .../gradle/testkit/NamingConventionIT.java    |   2 +-
 .../gradle/testkit/NamingConventionIT.java    |   2 +-
 .../gradle/testkit/NamingConventionIT.java    |   2 +-
 .../sample_jars/src/main/java/TestingIO.java  |   1 -
 .../test/enrich/CommonEnrichRestTestCase.java |  63 +-
 .../xpack/enrich/EnrichSecurityFailureIT.java |   8 +-
 .../xpack/enrich/EnrichSecurityIT.java        |  14 +-
 .../elasticsearch/xpack/enrich/EnrichIT.java  |   3 +-
 93 files changed, 2097 insertions(+), 1623 deletions(-)
 rename buildSrc/src/main/{groovy => java}/org/elasticsearch/gradle/test/DistroTestPlugin.java (78%)
 rename buildSrc/src/main/{groovy => java}/org/elasticsearch/gradle/test/JNAKernel32Library.java (100%)

diff --git a/build.gradle b/build.gradle
index b03bb7e5a3794..343ee3df31452 100644
--- a/build.gradle
+++ b/build.gradle
@@ -106,6 +106,7 @@ subprojects {
     // is greater than the number of unformatted projects, this can be
     // switched to an exclude list, and eventualy removed completely.
     def projectPathsToFormat = [
+      ':build-tools',
       ':x-pack:plugin:enrich'
     ]
 
@@ -114,6 +115,10 @@ subprojects {
 
       spotless {
         java {
+          // Normally this isn't necessary, but we have Java sources in
+          // non-standard places
+          target '**/*.java'
+
           removeUnusedImports()
           eclipse().configFile rootProject.file('.eclipseformat.xml')
           trimTrailingWhitespace()
diff --git a/buildSrc/reaper/src/main/java/org/elasticsearch/gradle/reaper/Reaper.java b/buildSrc/reaper/src/main/java/org/elasticsearch/gradle/reaper/Reaper.java
index 27cde3b6e1bf7..8895e4f6077f6 100644
--- a/buildSrc/reaper/src/main/java/org/elasticsearch/gradle/reaper/Reaper.java
+++ b/buildSrc/reaper/src/main/java/org/elasticsearch/gradle/reaper/Reaper.java
@@ -65,14 +65,14 @@ public static void main(String[] args) throws Exception {
         }
         Path inputDir = Paths.get(args[0]);
 
-        try (Reaper reaper = new Reaper(inputDir)){
+        try (Reaper reaper = new Reaper(inputDir)) {
             System.in.read();
             reaper.reap();
         }
     }
 
     private void reap() {
-        try (Stream<Path> stream = Files.list(inputDir)){
+        try (Stream<Path> stream = Files.list(inputDir)) {
             final List<Path> inputFiles = stream.filter(p -> p.getFileName().toString().endsWith(".cmd")).collect(Collectors.toList());
 
             for (Path inputFile : inputFiles) {
@@ -118,7 +118,7 @@ private void delete(Path toDelete) {
     @Override
     public void close() {
         if (failed == false) {
-            try (Stream<Path> stream = Files.walk(inputDir)){
+            try (Stream<Path> stream = Files.walk(inputDir)) {
                 stream.sorted(Comparator.reverseOrder()).forEach(this::delete);
             } catch (IOException e) {
                 throw new UncheckedIOException(e);
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/BwcVersions.java b/buildSrc/src/main/java/org/elasticsearch/gradle/BwcVersions.java
index b5f1aa5f551dc..7c272ac35c667 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/BwcVersions.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/BwcVersions.java
@@ -109,15 +109,20 @@ public BwcVersions(List<String> versionLines) {
     }
 
     protected BwcVersions(List<String> versionLines, Version currentVersionProperty) {
-        this(versionLines.stream()
-            .map(LINE_PATTERN::matcher)
-            .filter(Matcher::matches)
-            .map(match -> new Version(
-                Integer.parseInt(match.group(1)),
-                Integer.parseInt(match.group(2)),
-                Integer.parseInt(match.group(3))
-            ))
-            .collect(Collectors.toCollection(TreeSet::new)), currentVersionProperty);
+        this(
+            versionLines.stream()
+                .map(LINE_PATTERN::matcher)
+                .filter(Matcher::matches)
+                .map(
+                    match -> new Version(
+                        Integer.parseInt(match.group(1)),
+                        Integer.parseInt(match.group(2)),
+                        Integer.parseInt(match.group(3))
+                    )
+                )
+                .collect(Collectors.toCollection(TreeSet::new)),
+            currentVersionProperty
+        );
     }
 
     // for testkit tests, until BwcVersions is extracted into an extension
@@ -140,8 +145,10 @@ public BwcVersions(SortedSet<Version> allVersions, Version currentVersionPropert
 
         Map<Version, UnreleasedVersionInfo> unreleased = new HashMap<>();
         for (Version unreleasedVersion : getUnreleased()) {
-            unreleased.put(unreleasedVersion,
-                new UnreleasedVersionInfo(unreleasedVersion, getBranchFor(unreleasedVersion), getGradleProjectPathFor(unreleasedVersion)));
+            unreleased.put(
+                unreleasedVersion,
+                new UnreleasedVersionInfo(unreleasedVersion, getBranchFor(unreleasedVersion), getGradleProjectPathFor(unreleasedVersion))
+            );
         }
         this.unreleased = Collections.unmodifiableMap(unreleased);
     }
@@ -149,18 +156,18 @@ public BwcVersions(SortedSet<Version> allVersions, Version currentVersionPropert
     private void assertNoOlderThanTwoMajors() {
         Set<Integer> majors = groupByMajor.keySet();
         if (majors.size() != 2 && currentVersion.getMinor() != 0 && currentVersion.getRevision() != 0) {
-            throw new IllegalStateException(
-                "Expected exactly 2 majors in parsed versions but found: " + majors
-            );
+            throw new IllegalStateException("Expected exactly 2 majors in parsed versions but found: " + majors);
         }
     }
 
     private void assertCurrentVersionMatchesParsed(Version currentVersionProperty) {
         if (currentVersionProperty.equals(currentVersion) == false) {
             throw new IllegalStateException(
-                "Parsed versions latest version does not match the one configured in build properties. " +
-                    "Parsed latest version is " + currentVersion + " but the build has " +
-                    currentVersionProperty
+                "Parsed versions latest version does not match the one configured in build properties. "
+                    + "Parsed latest version is "
+                    + currentVersion
+                    + " but the build has "
+                    + currentVersionProperty
             );
         }
     }
@@ -175,12 +182,7 @@ public UnreleasedVersionInfo unreleasedInfo(Version version) {
     public void forPreviousUnreleased(Consumer<UnreleasedVersionInfo> consumer) {
         List<UnreleasedVersionInfo> collect = getUnreleased().stream()
             .filter(version -> version.equals(currentVersion) == false)
-            .map(version -> new UnreleasedVersionInfo(
-                    version,
-                    getBranchFor(version),
-                    getGradleProjectPathFor(version)
-                )
-            )
+            .map(version -> new UnreleasedVersionInfo(version, getBranchFor(version), getGradleProjectPathFor(version)))
             .collect(Collectors.toList());
 
         collect.forEach(uvi -> consumer.accept(uvi));
@@ -196,22 +198,18 @@ private String getGradleProjectPathFor(Version version) {
         Map<Integer, List<Version>> releasedMajorGroupedByMinor = getReleasedMajorGroupedByMinor();
 
         if (version.getRevision() == 0) {
-            List<Version> unreleasedStagedOrMinor = getUnreleased().stream()
-                .filter(v -> v.getRevision() == 0)
-                .collect(Collectors.toList());
+            List<Version> unreleasedStagedOrMinor = getUnreleased().stream().filter(v -> v.getRevision() == 0).collect(Collectors.toList());
             if (unreleasedStagedOrMinor.size() > 2) {
                 if (unreleasedStagedOrMinor.get(unreleasedStagedOrMinor.size() - 2).equals(version)) {
                     return ":distribution:bwc:minor";
-                } else{
+                } else {
                     return ":distribution:bwc:staged";
                 }
             } else {
                 return ":distribution:bwc:minor";
             }
         } else {
-            if (releasedMajorGroupedByMinor
-                .getOrDefault(version.getMinor(), emptyList())
-                .contains(version)) {
+            if (releasedMajorGroupedByMinor.getOrDefault(version.getMinor(), emptyList()).contains(version)) {
                 return ":distribution:bwc:bugfix";
             } else {
                 return ":distribution:bwc:maintenance";
@@ -229,7 +227,7 @@ private String getBranchFor(Version version) {
                 return "master";
             case ":distribution:bwc:minor":
                 // The .x branch will always point to the latest minor (for that major), so a "minor" project will be on the .x branch
-                //  unless there is more recent (higher) minor.
+                // unless there is more recent (higher) minor.
                 final Version latestInMajor = getLatestVersionByKey(groupByMajor, version.getMajor());
                 if (latestInMajor.getMinor() == version.getMinor()) {
                     return version.getMajor() + ".x";
@@ -279,23 +277,16 @@ public List<Version> getUnreleased() {
             }
         }
 
-        return unmodifiableList(
-            unreleased.stream()
-                .sorted()
-                .distinct()
-                .collect(Collectors.toList())
-        );
+        return unmodifiableList(unreleased.stream().sorted().distinct().collect(Collectors.toList()));
     }
 
     private Version getLatestInMinor(int major, int minor) {
-        return groupByMajor.get(major).stream()
-            .filter(v -> v.getMinor() == minor)
-            .max(Version::compareTo)
-            .orElse(null);
+        return groupByMajor.get(major).stream().filter(v -> v.getMinor() == minor).max(Version::compareTo).orElse(null);
     }
 
     private Version getLatestVersionByKey(Map<Integer, List<Version>> groupByMajor, int key) {
-        return groupByMajor.getOrDefault(key, emptyList()).stream()
+        return groupByMajor.getOrDefault(key, emptyList())
+            .stream()
             .max(Version::compareTo)
             .orElseThrow(() -> new IllegalStateException("Unexpected number of versions in collection"));
     }
@@ -307,11 +298,9 @@ private Map<Integer, List<Version>> getReleasedMajorGroupedByMinor() {
         final Map<Integer, List<Version>> groupByMinor;
         if (currentMajorVersions.size() == 1) {
             // Current is an unreleased major: x.0.0 so we have to look for other unreleased versions in the previous major
-            groupByMinor = previousMajorVersions.stream()
-                .collect(Collectors.groupingBy(Version::getMinor, Collectors.toList()));
+            groupByMinor = previousMajorVersions.stream().collect(Collectors.groupingBy(Version::getMinor, Collectors.toList()));
         } else {
-            groupByMinor = currentMajorVersions.stream()
-                .collect(Collectors.groupingBy(Version::getMinor, Collectors.toList()));
+            groupByMinor = currentMajorVersions.stream().collect(Collectors.groupingBy(Version::getMinor, Collectors.toList()));
         }
         return groupByMinor;
     }
@@ -321,8 +310,9 @@ public void compareToAuthoritative(List<Version> authoritativeReleasedVersions)
         notReallyReleased.removeAll(authoritativeReleasedVersions);
         if (notReallyReleased.isEmpty() == false) {
             throw new IllegalStateException(
-                "out-of-date released versions" +
-                    "\nFollowing versions are not really released, but the build thinks they are: " + notReallyReleased
+                "out-of-date released versions"
+                    + "\nFollowing versions are not really released, but the build thinks they are: "
+                    + notReallyReleased
             );
         }
 
@@ -330,17 +320,19 @@ public void compareToAuthoritative(List<Version> authoritativeReleasedVersions)
         incorrectlyConsideredUnreleased.retainAll(getUnreleased());
         if (incorrectlyConsideredUnreleased.isEmpty() == false) {
             throw new IllegalStateException(
-                "out-of-date released versions" +
-                    "\nBuild considers versions unreleased, " +
-                    "but they are released according to an authoritative source: " + incorrectlyConsideredUnreleased +
-                    "\nThe next versions probably needs to be added to Version.java (CURRENT doesn't count)."
+                "out-of-date released versions"
+                    + "\nBuild considers versions unreleased, "
+                    + "but they are released according to an authoritative source: "
+                    + incorrectlyConsideredUnreleased
+                    + "\nThe next versions probably needs to be added to Version.java (CURRENT doesn't count)."
             );
         }
     }
 
     private List<Version> getReleased() {
         List<Version> unreleased = getUnreleased();
-        return groupByMajor.values().stream()
+        return groupByMajor.values()
+            .stream()
             .flatMap(Collection::stream)
             .filter(each -> unreleased.contains(each) == false)
             .collect(Collectors.toList());
@@ -348,10 +340,7 @@ private List<Version> getReleased() {
 
     public List<Version> getIndexCompatible() {
         return unmodifiableList(
-            Stream.concat(
-                groupByMajor.get(currentVersion.getMajor() - 1).stream(),
-                groupByMajor.get(currentVersion.getMajor()).stream()
-            )
+            Stream.concat(groupByMajor.get(currentVersion.getMajor() - 1).stream(), groupByMajor.get(currentVersion.getMajor()).stream())
                 .collect(Collectors.toList())
         );
     }
@@ -361,10 +350,7 @@ public List<Version> getWireCompatible() {
 
         List<Version> prevMajors = groupByMajor.get(currentVersion.getMajor() - 1);
         int minor = prevMajors.get(prevMajors.size() - 1).getMinor();
-        for (int i = prevMajors.size() - 1;
-             i > 0 && prevMajors.get(i).getMinor() == minor;
-             i--
-        ) {
+        for (int i = prevMajors.size() - 1; i > 0 && prevMajors.get(i).getMinor() == minor; i--) {
             wireCompat.add(prevMajors.get(i));
         }
         wireCompat.addAll(groupByMajor.get(currentVersion.getMajor()));
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/ConcatFilesTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/ConcatFilesTask.java
index 7da6381cc2a24..ac5f030e7e8a4 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/ConcatFilesTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/ConcatFilesTask.java
@@ -55,7 +55,9 @@ public void setFiles(FileTree files) {
     }
 
     @InputFiles
-    public FileTree getFiles() { return files; }
+    public FileTree getFiles() {
+        return files;
+    }
 
     public void setHeaderLine(String headerLine) {
         this.headerLine = headerLine;
@@ -63,7 +65,9 @@ public void setHeaderLine(String headerLine) {
 
     @Input
     @Optional
-    public String getHeaderLine() { return headerLine; }
+    public String getHeaderLine() {
+        return headerLine;
+    }
 
     public void setTarget(File target) {
         this.target = target;
@@ -77,10 +81,7 @@ public File getTarget() {
     @TaskAction
     public void concatFiles() throws IOException {
         if (getHeaderLine() != null) {
-            Files.write(
-                getTarget().toPath(),
-                (getHeaderLine() + '\n').getBytes(StandardCharsets.UTF_8)
-            );
+            Files.write(getTarget().toPath(), (getHeaderLine() + '\n').getBytes(StandardCharsets.UTF_8));
         }
 
         // To remove duplicate lines
@@ -88,9 +89,7 @@ public void concatFiles() throws IOException {
         for (File f : getFiles()) {
             uniqueLines.addAll(Files.readAllLines(f.toPath(), StandardCharsets.UTF_8));
         }
-        Files.write(
-            getTarget().toPath(), uniqueLines, StandardCharsets.UTF_8, StandardOpenOption.APPEND
-        );
+        Files.write(getTarget().toPath(), uniqueLines, StandardCharsets.UTF_8, StandardOpenOption.APPEND);
     }
 
 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
index 861d5afcaf65c..1a520341f12b1 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/DistributionDownloadPlugin.java
@@ -105,8 +105,10 @@ void setupDistributions(Project project) {
             if (distribution.getType().shouldExtract()) {
                 // for the distribution extracted, add a root level task that does the extraction, and depend on that
                 // extracted configuration as an artifact consisting of the extracted distribution directory
-                dependencies.add(distribution.getExtracted().configuration.getName(),
-                    projectDependency(project, ":", configName("extracted_elasticsearch", distribution)));
+                dependencies.add(
+                    distribution.getExtracted().configuration.getName(),
+                    projectDependency(project, ":", configName("extracted_elasticsearch", distribution))
+                );
                 // ensure a root level download task exists
                 setupRootDownload(project.getRootProject(), distribution);
             }
@@ -139,7 +141,7 @@ private void setupRootDownload(Project rootProject, ElasticsearchDistribution di
             TaskProvider<Sync> extractTask = rootProject.getTasks().register(extractTaskName, Sync.class, syncTask -> {
                 syncTask.dependsOn(downloadConfig);
                 syncTask.into(extractDir);
-                syncTask.from((Callable<FileTree>)() -> {
+                syncTask.from((Callable<FileTree>) () -> {
                     File archiveFile = archiveGetter.get();
                     String archivePath = archiveFile.toString();
                     if (archivePath.endsWith(".zip")) {
@@ -150,9 +152,12 @@ private void setupRootDownload(Project rootProject, ElasticsearchDistribution di
                     throw new IllegalStateException("unexpected file extension on [" + archivePath + "]");
                 });
             });
-            rootProject.getArtifacts().add(extractedConfigName,
-                rootProject.getLayout().getProjectDirectory().dir(extractDir),
-                artifact -> artifact.builtBy(extractTask));
+            rootProject.getArtifacts()
+                .add(
+                    extractedConfigName,
+                    rootProject.getLayout().getProjectDirectory().dir(extractDir),
+                    artifact -> artifact.builtBy(extractTask)
+                );
         }
     }
 
@@ -219,7 +224,6 @@ private Object dependencyNotation(Project project, ElasticsearchDistribution dis
             return "org.elasticsearch.distribution.integ-test-zip:elasticsearch:" + distribution.getVersion() + "@zip";
         }
 
-
         Version distroVersion = Version.fromString(distribution.getVersion());
         String extension = distribution.getType().toString();
         String classifier = ":x86_64";
@@ -293,9 +297,16 @@ private static String distributionProjectName(ElasticsearchDistribution distribu
     }
 
     private static String configName(String prefix, ElasticsearchDistribution distribution) {
-        return prefix + "_" + distribution.getVersion() + "_" + distribution.getType() + "_" +
-            (distribution.getPlatform() == null ? "" : distribution.getPlatform() + "_")
-            + distribution.getFlavor() + (distribution.getBundledJdk() ? "" : "_nojdk");
+        return String.format(
+            Locale.ROOT,
+            "%s_%s_%s_%s%s%s",
+            prefix,
+            distribution.getVersion(),
+            distribution.getType(),
+            distribution.getPlatform() == null ? "" : distribution.getPlatform() + "_",
+            distribution.getFlavor(),
+            distribution.getBundledJdk() ? "" : "_nojdk"
+        );
     }
 
     private static String capitalize(String s) {
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/ElasticsearchDistribution.java b/buildSrc/src/main/java/org/elasticsearch/gradle/ElasticsearchDistribution.java
index bf482edb250dd..ff6b53fa29447 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/ElasticsearchDistribution.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/ElasticsearchDistribution.java
@@ -120,8 +120,12 @@ public String toString() {
     private final Property<Flavor> flavor;
     private final Property<Boolean> bundledJdk;
 
-    ElasticsearchDistribution(String name, ObjectFactory objectFactory, Configuration fileConfiguration,
-                              Configuration extractedConfiguration) {
+    ElasticsearchDistribution(
+        String name,
+        ObjectFactory objectFactory,
+        Configuration fileConfiguration,
+        Configuration extractedConfiguration
+    ) {
         this.name = name;
         this.configuration = fileConfiguration;
         this.version = objectFactory.property(String.class).convention(VersionProperties.getElasticsearch());
@@ -188,8 +192,9 @@ public Extracted getExtracted() {
             case DEB:
             case DOCKER:
             case RPM:
-                throw new UnsupportedOperationException("distribution type [" + getType() + "] for " +
-                    "elasticsearch distribution [" + name + "] cannot be extracted");
+                throw new UnsupportedOperationException(
+                    "distribution type [" + getType() + "] for " + "elasticsearch distribution [" + name + "] cannot be extracted"
+                );
 
             default:
                 return extracted;
@@ -217,15 +222,18 @@ void finalizeValues() {
         if (getType() == Type.INTEG_TEST_ZIP) {
             if (platform.getOrNull() != null) {
                 throw new IllegalArgumentException(
-                    "platform not allowed for elasticsearch distribution [" + name + "] of type [integ_test_zip]");
+                    "platform not allowed for elasticsearch distribution [" + name + "] of type [integ_test_zip]"
+                );
             }
             if (flavor.getOrNull() != null) {
                 throw new IllegalArgumentException(
-                    "flavor [" + flavor.get() + "] not allowed for elasticsearch distribution [" + name + "] of type [integ_test_zip]");
+                    "flavor [" + flavor.get() + "] not allowed for elasticsearch distribution [" + name + "] of type [integ_test_zip]"
+                );
             }
             if (bundledJdk.getOrNull() != null) {
                 throw new IllegalArgumentException(
-                    "bundledJdk not allowed for elasticsearch distribution [" + name + "] of type [integ_test_zip]");
+                    "bundledJdk not allowed for elasticsearch distribution [" + name + "] of type [integ_test_zip]"
+                );
             }
             return;
         }
@@ -237,8 +245,9 @@ void finalizeValues() {
             }
         } else { // rpm, deb or docker
             if (platform.isPresent()) {
-                throw new IllegalArgumentException("platform not allowed for elasticsearch distribution ["
-                    + name + "] of type [" + getType() + "]");
+                throw new IllegalArgumentException(
+                    "platform not allowed for elasticsearch distribution [" + name + "] of type [" + getType() + "]"
+                );
             }
         }
 
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/ExportElasticsearchBuildResourcesTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/ExportElasticsearchBuildResourcesTask.java
index dff60f7693bbd..4b30848ac4235 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/ExportElasticsearchBuildResourcesTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/ExportElasticsearchBuildResourcesTask.java
@@ -82,8 +82,8 @@ public void setOutputDir(File outputDir) {
 
     public File copy(String resource) {
         if (getState().getExecuted() || getState().getExecuting()) {
-            throw new GradleException("buildResources can't be configured after the task ran. " +
-                "Make sure task is not used after configuration time"
+            throw new GradleException(
+                "buildResources can't be configured after the task ran. " + "Make sure task is not used after configuration time"
             );
         }
         resources.add(resource);
@@ -96,19 +96,18 @@ public void doExport() {
             setDidWork(false);
             throw new StopExecutionException();
         }
-        resources.stream().parallel()
-            .forEach(resourcePath -> {
-                Path destination = outputDir.get().file(resourcePath).getAsFile().toPath();
-                try (InputStream is = getClass().getClassLoader().getResourceAsStream(resourcePath)) {
-                    Files.createDirectories(destination.getParent());
-                    if (is == null) {
-                        throw new GradleException("Can't export `" + resourcePath + "` from build-tools: not found");
-                    }
-                    Files.copy(is, destination, StandardCopyOption.REPLACE_EXISTING);
-                } catch (IOException e) {
-                    throw new GradleException("Can't write resource `" + resourcePath + "` to " + destination, e);
+        resources.stream().parallel().forEach(resourcePath -> {
+            Path destination = outputDir.get().file(resourcePath).getAsFile().toPath();
+            try (InputStream is = getClass().getClassLoader().getResourceAsStream(resourcePath)) {
+                Files.createDirectories(destination.getParent());
+                if (is == null) {
+                    throw new GradleException("Can't export `" + resourcePath + "` from build-tools: not found");
                 }
-            });
+                Files.copy(is, destination, StandardCopyOption.REPLACE_EXISTING);
+            } catch (IOException e) {
+                throw new GradleException("Can't write resource `" + resourcePath + "` to " + destination, e);
+            }
+        });
     }
 
 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/FileSupplier.java b/buildSrc/src/main/java/org/elasticsearch/gradle/FileSupplier.java
index d28afe0c41dd0..a2d85d75a75d3 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/FileSupplier.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/FileSupplier.java
@@ -3,5 +3,4 @@
 import java.io.File;
 import java.util.function.Supplier;
 
-public interface FileSupplier extends Supplier<File> {
-}
+public interface FileSupplier extends Supplier<File> {}
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/Jdk.java b/buildSrc/src/main/java/org/elasticsearch/gradle/Jdk.java
index ca429b67bdd0d..12f0a8e8e9c76 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/Jdk.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/Jdk.java
@@ -35,8 +35,7 @@
 public class Jdk implements Buildable, Iterable<File> {
 
     private static final List<String> ALLOWED_VENDORS = List.of("adoptopenjdk", "openjdk");
-    static final Pattern VERSION_PATTERN =
-        Pattern.compile("(\\d+)(\\.\\d+\\.\\d+)?\\+(\\d+(?:\\.\\d+)?)(@([a-f0-9]{32}))?");
+    static final Pattern VERSION_PATTERN = Pattern.compile("(\\d+)(\\.\\d+\\.\\d+)?\\+(\\d+(?:\\.\\d+)?)(@([a-f0-9]{32}))?");
     private static final List<String> ALLOWED_PLATFORMS = Collections.unmodifiableList(Arrays.asList("darwin", "linux", "windows", "mac"));
 
     private final String name;
@@ -87,7 +86,8 @@ public String getPlatform() {
     public void setPlatform(String platform) {
         if (ALLOWED_PLATFORMS.contains(platform) == false) {
             throw new IllegalArgumentException(
-                "unknown platform [" + platform + "] for jdk [" + name + "], must be one of " + ALLOWED_PLATFORMS);
+                "unknown platform [" + platform + "] for jdk [" + name + "], must be one of " + ALLOWED_PLATFORMS
+            );
         }
         this.platform.set(platform);
     }
@@ -135,7 +135,7 @@ void finalizeValues() {
         }
         version.finalizeValue();
         platform.finalizeValue();
-        vendor.finalizeValue();;
+        vendor.finalizeValue();
     }
 
     @Override
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/JdkDownloadPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/JdkDownloadPlugin.java
index 59b2aa98d4f36..b1895727949ef 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/JdkDownloadPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/JdkDownloadPlugin.java
@@ -56,9 +56,7 @@ public class JdkDownloadPlugin implements Plugin<Project> {
 
     @Override
     public void apply(Project project) {
-        NamedDomainObjectContainer<Jdk> jdksContainer = project.container(Jdk.class, name ->
-            new Jdk(name, project)
-        );
+        NamedDomainObjectContainer<Jdk> jdksContainer = project.container(Jdk.class, name -> new Jdk(name, project));
         project.getExtensions().add(CONTAINER_NAME, jdksContainer);
 
         project.afterEvaluate(p -> {
@@ -134,7 +132,8 @@ private static void setupRootJdkDownload(Project rootProject, String platform, S
                         Locale.ROOT,
                         "adoptopenjdk/OpenJDK%sU-jdk_x64_[module]_hotspot_[revision]_%s.[ext]",
                         jdkMajor,
-                        jdkBuild);
+                        jdkBuild
+                    );
                     ivyRepo.patternLayout(layout -> layout.artifact(pattern));
                     ivyRepo.content(content -> content.includeGroup("adoptopenjdk"));
                 });
@@ -146,8 +145,11 @@ private static void setupRootJdkDownload(Project rootProject, String platform, S
                         ivyRepo.setName(repoName);
                         ivyRepo.setUrl("https://download.oracle.com");
                         ivyRepo.metadataSources(IvyArtifactRepository.MetadataSources::artifact);
-                        ivyRepo.patternLayout(layout -> layout.artifact(
-                            "java/GA/jdk" + jdkVersion + "/" + hash + "/" + jdkBuild + "/GPL/openjdk-[revision]_[module]-x64_bin.[ext]"));
+                        ivyRepo.patternLayout(
+                            layout -> layout.artifact(
+                                "java/GA/jdk" + jdkVersion + "/" + hash + "/" + jdkBuild + "/GPL/openjdk-[revision]_[module]-x64_bin.[ext]"
+                            )
+                        );
                         ivyRepo.content(content -> content.includeGroup("openjdk"));
                     });
                 } else {
@@ -156,8 +158,11 @@ private static void setupRootJdkDownload(Project rootProject, String platform, S
                         ivyRepo.setName(repoName);
                         ivyRepo.setUrl("https://download.oracle.com");
                         ivyRepo.metadataSources(IvyArtifactRepository.MetadataSources::artifact);
-                        ivyRepo.patternLayout(layout ->
-                            layout.artifact("java/GA/jdk" + jdkMajor + "/" + jdkBuild + "/GPL/openjdk-[revision]_[module]-x64_bin.[ext]"));
+                        ivyRepo.patternLayout(
+                            layout -> layout.artifact(
+                                "java/GA/jdk" + jdkMajor + "/" + jdkBuild + "/GPL/openjdk-[revision]_[module]-x64_bin.[ext]"
+                            )
+                        );
                         ivyRepo.content(content -> content.includeGroup("openjdk"));
                     });
                 }
@@ -173,15 +178,17 @@ private static void setupRootJdkDownload(Project rootProject, String platform, S
             jdkConfig = configurations.create(remoteConfigName);
             configurations.create(localConfigName);
         }
-        String platformDep = platform.equals("darwin") || platform.equals("osx") ?
-            (vendor.equals("adoptopenjdk") ? "mac" : "osx") : platform;
+        String platformDep = platform.equals("darwin") || platform.equals("osx")
+            ? (vendor.equals("adoptopenjdk") ? "mac" : "osx")
+            : platform;
         String extension = platform.equals("windows") ? "zip" : "tar.gz";
         String jdkDep = vendor + ":" + platformDep + ":" + jdkVersion + "@" + extension;
         rootProject.getDependencies().add(configName(vendor, version, platform), jdkDep);
 
         // add task for extraction
-        final Provider<Directory> extractPath =
-            rootProject.getLayout().getBuildDirectory().dir("jdks/" + vendor + "-" + jdkVersion + "_" + platform);
+        final Provider<Directory> extractPath = rootProject.getLayout()
+            .getBuildDirectory()
+            .dir("jdks/" + vendor + "-" + jdkVersion + "_" + platform);
 
         // delay resolving jdkConfig until runtime
         Supplier<File> jdkArchiveGetter = jdkConfig::getSingleFile;
@@ -208,7 +215,8 @@ private static void setupRootJdkDownload(Project rootProject, String platform, S
                     String[] pathSegments = details.getRelativePath().getSegments();
                     int index = 0;
                     for (; index < pathSegments.length; index++) {
-                        if (pathSegments[index].matches("jdk-.*")) break;
+                        if (pathSegments[index].matches("jdk-.*"))
+                            break;
                     }
                     assert index + 1 <= pathSegments.length;
                     String[] newPathSegments = Arrays.copyOfRange(pathSegments, index + 1, pathSegments.length);
@@ -235,39 +243,38 @@ public void execute(Task t) {
             extractTask = rootProject.getTasks().register(extractTaskName, SymbolicLinkPreservingUntarTask.class, task -> {
                 task.getTarFile().set(jdkConfiguration.getSingleFile());
                 task.getExtractPath().set(extractPath);
-                task.setTransform(
-                    name -> {
-                        /*
-                         * We want to remove up to the and including the jdk-.* relative paths. That is a JDK archive is structured as:
-                         *   jdk-12.0.1/
-                         *   jdk-12.0.1/Contents
-                         *   ...
-                         *
-                         * and we want to remove the leading jdk-12.0.1. Note however that there could also be a leading ./ as in
-                         *   ./
-                         *   ./jdk-12.0.1/
-                         *   ./jdk-12.0.1/Contents
-                         *
-                         * so we account for this and search the path components until we find the jdk-12.0.1, and strip the leading
-                         * components.
-                         */
-                        final Path entryName = Paths.get(name);
-                        int index = 0;
-                        for (; index < entryName.getNameCount(); index++) {
-                            if (entryName.getName(index).toString().matches("jdk-.*")) break;
-                        }
-                        if (index + 1 >= entryName.getNameCount()) {
-                            // this happens on the top-level directories in the archive, which we are removing
-                            return null;
+                task.setTransform(name -> {
+                    /*
+                     * We want to remove up to the and including the jdk-.* relative paths. That is a JDK archive is structured as:
+                     *   jdk-12.0.1/
+                     *   jdk-12.0.1/Contents
+                     *   ...
+                     *
+                     * and we want to remove the leading jdk-12.0.1. Note however that there could also be a leading ./ as in
+                     *   ./
+                     *   ./jdk-12.0.1/
+                     *   ./jdk-12.0.1/Contents
+                     *
+                     * so we account for this and search the path components until we find the jdk-12.0.1, and strip the leading
+                     * components.
+                     */
+                    final Path entryName = Paths.get(name);
+                    int index = 0;
+                    for (; index < entryName.getNameCount(); index++) {
+                        if (entryName.getName(index).toString().matches("jdk-.*")) {
+                            break;
                         }
-                        // finally remove the top-level directories from the output path
-                        return entryName.subpath(index + 1, entryName.getNameCount());
-                    });
+                    }
+                    if (index + 1 >= entryName.getNameCount()) {
+                        // this happens on the top-level directories in the archive, which we are removing
+                        return null;
+                    }
+                    // finally remove the top-level directories from the output path
+                    return entryName.subpath(index + 1, entryName.getNameCount());
+                });
             });
         }
-        rootProject.getArtifacts().add(localConfigName,
-            extractPath,
-            artifact -> artifact.builtBy(extractTask));
+        rootProject.getArtifacts().add(localConfigName, extractPath, artifact -> artifact.builtBy(extractTask));
     }
 
     private static String configName(String vendor, String version, String platform) {
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/LazyPropertyMap.java b/buildSrc/src/main/java/org/elasticsearch/gradle/LazyPropertyMap.java
index a6e8d5cbbe8bd..dcfce3829376c 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/LazyPropertyMap.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/LazyPropertyMap.java
@@ -110,14 +110,17 @@ public Collection<V> values() {
 
     @Override
     public Set<Entry<K, V>> entrySet() {
-        return delegate.entrySet().stream()
+        return delegate.entrySet()
+            .stream()
             .peek(this::validate)
-            .collect(Collectors.toMap(Entry::getKey, entry -> entry.getValue().getValue())).entrySet();
+            .collect(Collectors.toMap(Entry::getKey, entry -> entry.getValue().getValue()))
+            .entrySet();
     }
 
     @Override
     public List<? extends Object> getNormalizedCollection() {
-        return delegate.values().stream()
+        return delegate.values()
+            .stream()
             .peek(this::validate)
             .filter(entry -> entry.getNormalization() != PropertyNormalization.IGNORE_VALUE)
             .map(entry -> normalizationMapper == null ? entry : normalizationMapper.apply(entry.getKey(), entry.getValue()))
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/LoggingOutputStream.java b/buildSrc/src/main/java/org/elasticsearch/gradle/LoggingOutputStream.java
index 8a1dfe16de28f..be77c68dbc1cf 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/LoggingOutputStream.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/LoggingOutputStream.java
@@ -44,7 +44,9 @@ public abstract class LoggingOutputStream extends OutputStream {
 
     @Override
     public void write(final int b) throws IOException {
-        if (b == 0) return;
+        if (b == 0) {
+            return;
+        }
         if (b == '\n') {
             // always flush with newlines instead of adding to the buffer
             flush();
@@ -69,7 +71,9 @@ public void write(final int b) throws IOException {
 
     @Override
     public void flush() {
-        if (end == start) return;
+        if (end == start) {
+            return;
+        }
         logLine(new String(buffer, start, end - start));
         start = end;
     }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/ReaperPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/ReaperPlugin.java
index 2d37e30391cfa..fb6edfc87d399 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/ReaperPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/ReaperPlugin.java
@@ -38,10 +38,13 @@ public void apply(Project project) {
 
         project.getPlugins().apply(GlobalBuildInfoPlugin.class);
 
-        Path inputDir = project.getRootDir().toPath().resolve(".gradle")
-            .resolve("reaper").resolve("build-" + ProcessHandle.current().pid());
-        ReaperService service = project.getExtensions().create("reaper", ReaperService.class,
-            project, project.getBuildDir().toPath(), inputDir);
+        Path inputDir = project.getRootDir()
+            .toPath()
+            .resolve(".gradle")
+            .resolve("reaper")
+            .resolve("build-" + ProcessHandle.current().pid());
+        ReaperService service = project.getExtensions()
+            .create("reaper", ReaperService.class, project, project.getBuildDir().toPath(), inputDir);
 
         project.getGradle().buildFinished(result -> service.shutdown());
     }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/ReaperService.java b/buildSrc/src/main/java/org/elasticsearch/gradle/ReaperService.java
index f60fb5b2816ac..f7e2d74c9a205 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/ReaperService.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/ReaperService.java
@@ -59,8 +59,8 @@ public ReaperService(Project project, Path buildDir, Path inputDir) {
      */
     public void registerPid(String serviceId, long pid) {
         String[] killPidCommand = OS.<String[]>conditional()
-            .onWindows(() -> new String[]{"Taskill", "/F", "/PID", String.valueOf(pid)})
-            .onUnix(() -> new String[]{"kill", "-9", String.valueOf(pid)})
+            .onWindows(() -> new String[] { "Taskill", "/F", "/PID", String.valueOf(pid) })
+            .onUnix(() -> new String[] { "kill", "-9", String.valueOf(pid) })
             .supply();
         registerCommand(serviceId, killPidCommand);
     }
@@ -79,9 +79,7 @@ public void registerCommand(String serviceId, String... command) {
     }
 
     private Path getCmdFile(String serviceId) {
-        return inputDir.resolve(
-            serviceId.replaceAll("[^a-zA-Z0-9]","-") + ".cmd"
-        );
+        return inputDir.resolve(serviceId.replaceAll("[^a-zA-Z0-9]", "-") + ".cmd");
     }
 
     public void unregister(String serviceId) {
@@ -99,8 +97,7 @@ void shutdown() {
                 reaperProcess.getOutputStream().close();
                 logger.info("Waiting for reaper to exit normally");
                 if (reaperProcess.waitFor() != 0) {
-                    throw new GradleException("Reaper process failed. Check log at "
-                        + inputDir.resolve("error.log") + " for details");
+                    throw new GradleException("Reaper process failed. Check log at " + inputDir.resolve("error.log") + " for details");
                 }
             } catch (Exception e) {
                 throw new RuntimeException(e);
@@ -120,9 +117,12 @@ private synchronized void ensureReaperStarted() {
                 // start the reaper
                 ProcessBuilder builder = new ProcessBuilder(
                     Jvm.current().getJavaExecutable().toString(), // same jvm as gradle
-                    "-Xms4m", "-Xmx16m", // no need for a big heap, just need to read some files and execute
-                    "-jar", jarPath.toString(),
-                    inputDir.toString());
+                    "-Xms4m",
+                    "-Xmx16m", // no need for a big heap, just need to read some files and execute
+                    "-jar",
+                    jarPath.toString(),
+                    inputDir.toString()
+                );
                 logger.info("Launching reaper: " + String.join(" ", builder.command()));
                 // be explicit for stdin, we use closing of the pipe to signal shutdown to the reaper
                 builder.redirectInput(ProcessBuilder.Redirect.PIPE);
@@ -146,12 +146,7 @@ private Path locateReaperJar() {
 
             if (matcher.matches()) {
                 String path = matcher.group(1);
-                return Path.of(
-                    OS.<String>conditional()
-                        .onWindows(() -> path.substring(1))
-                        .onUnix(() -> path)
-                        .supply()
-                );
+                return Path.of(OS.<String>conditional().onWindows(() -> path.substring(1)).onUnix(() -> path).supply());
             } else {
                 throw new RuntimeException("Unable to locate " + REAPER_CLASS + " on build classpath.");
             }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/http/WaitForHttpResource.java b/buildSrc/src/main/java/org/elasticsearch/gradle/http/WaitForHttpResource.java
index 52447b6bc20a1..db805b26cdca5 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/http/WaitForHttpResource.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/http/WaitForHttpResource.java
@@ -112,7 +112,7 @@ public boolean wait(int durationInMs) throws GeneralSecurityException, Interrupt
             ssl = null;
         }
         IOException failure = null;
-        for (; ; ) {
+        while (true) {
             try {
                 checkResource(ssl);
                 return true;
@@ -161,11 +161,12 @@ private void configureSslContext(HttpURLConnection connection, SSLContext ssl) {
     private void configureBasicAuth(HttpURLConnection connection) {
         if (username != null) {
             if (password == null) {
-                throw new IllegalStateException("Basic Auth user [" + username
-                    + "] has been set, but no password has been configured");
+                throw new IllegalStateException("Basic Auth user [" + username + "] has been set, but no password has been configured");
             }
-            connection.setRequestProperty("Authorization",
-                "Basic " + Base64.getEncoder().encodeToString((username + ":" + password).getBytes(StandardCharsets.UTF_8)));
+            connection.setRequestProperty(
+                "Authorization",
+                "Basic " + Base64.getEncoder().encodeToString((username + ":" + password).getBytes(StandardCharsets.UTF_8))
+            );
         }
     }
 
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/info/GenerateGlobalBuildInfoTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/info/GenerateGlobalBuildInfoTask.java
index 07d68ca679f81..75ae735e8a9f1 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/info/GenerateGlobalBuildInfoTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/info/GenerateGlobalBuildInfoTask.java
@@ -28,6 +28,7 @@
 import java.nio.file.Files;
 import java.util.Arrays;
 import java.util.List;
+import java.util.Locale;
 
 import static java.nio.charset.StandardCharsets.UTF_8;
 
@@ -115,8 +116,14 @@ public RegularFileProperty getRuntimeVersionFile() {
     public void generate() {
         String javaVendorVersion = System.getProperty("java.vendor.version", System.getProperty("java.vendor"));
         String gradleJavaVersion = System.getProperty("java.version");
-        String gradleJavaVersionDetails = javaVendorVersion + " " + gradleJavaVersion + " [" + System.getProperty("java.vm.name")
-            + " " + System.getProperty("java.vm.version") + "]";
+        String gradleJavaVersionDetails = javaVendorVersion
+            + " "
+            + gradleJavaVersion
+            + " ["
+            + System.getProperty("java.vm.name")
+            + " "
+            + System.getProperty("java.vm.version")
+            + "]";
 
         String compilerJavaVersionDetails = gradleJavaVersionDetails;
         JavaVersion compilerJavaVersionEnum = JavaVersion.current();
@@ -147,21 +154,24 @@ public void generate() {
         }
 
         try (BufferedWriter writer = new BufferedWriter(new FileWriter(outputFile.getAsFile().get()))) {
+            final String osName = System.getProperty("os.name");
+            final String osVersion = System.getProperty("os.version");
+            final String osArch = System.getProperty("os.arch");
+            final JavaVersion parsedVersion = JavaVersion.toVersion(gradleJavaVersion);
+
             writer.write("  Gradle Version        : " + getProject().getGradle().getGradleVersion() + "\n");
-            writer.write("  OS Info               : " + System.getProperty("os.name") + " " + System.getProperty("os.version")
-                + " (" + System.getProperty("os.arch") + ")\n");
+            writer.write("  OS Info               : " + osName + " " + osVersion + " (" + osArch + ")\n");
+
             if (gradleJavaVersionDetails.equals(compilerJavaVersionDetails) == false
                 || gradleJavaVersionDetails.equals(runtimeJavaVersionDetails) == false) {
                 writer.write("  Compiler JDK Version  : " + compilerJavaVersionEnum + " (" + compilerJavaVersionDetails + ")\n");
                 writer.write("  Compiler java.home    : " + compilerJavaHome + "\n");
                 writer.write("  Runtime JDK Version   : " + runtimeJavaVersionEnum + " (" + runtimeJavaVersionDetails + ")\n");
                 writer.write("  Runtime java.home     : " + runtimeJavaHome + "\n");
-                writer.write("  Gradle JDK Version    : " + JavaVersion.toVersion(gradleJavaVersion)
-                    + " (" + gradleJavaVersionDetails + ")\n");
+                writer.write("  Gradle JDK Version    : " + parsedVersion + " (" + gradleJavaVersionDetails + ")\n");
                 writer.write("  Gradle java.home      : " + gradleJavaHome);
             } else {
-                writer.write("  JDK Version           : " + JavaVersion.toVersion(gradleJavaVersion)
-                    + " (" + gradleJavaVersionDetails + ")\n");
+                writer.write("  JDK Version           : " + parsedVersion + " (" + gradleJavaVersionDetails + ")\n");
                 writer.write("  JAVA_HOME             : " + gradleJavaHome);
             }
         } catch (IOException e) {
@@ -170,14 +180,24 @@ public void generate() {
 
         // enforce Java version
         if (compilerJavaVersionEnum.compareTo(minimumCompilerVersion) < 0) {
-            String message = "The compiler java.home must be set to a JDK installation directory for Java " + minimumCompilerVersion +
-                " but is [" + compilerJavaHome + "] corresponding to [" + compilerJavaVersionEnum + "]";
+            String message = String.format(
+                Locale.ROOT,
+                "The compiler java.home must be set to a JDK installation directory for Java %s but is [%s] " + "corresponding to [%s]",
+                minimumCompilerVersion,
+                compilerJavaHome,
+                compilerJavaVersionEnum
+            );
             throw new GradleException(message);
         }
 
         if (runtimeJavaVersionEnum.compareTo(minimumRuntimeVersion) < 0) {
-            String message = "The runtime java.home must be set to a JDK installation directory for Java " + minimumRuntimeVersion +
-                " but is [" + runtimeJavaHome + "] corresponding to [" + runtimeJavaVersionEnum + "]";
+            String message = String.format(
+                Locale.ROOT,
+                "The runtime java.home must be set to a JDK installation directory for Java %s but is [%s] " + "corresponding to [%s]",
+                minimumRuntimeVersion,
+                runtimeJavaHome,
+                runtimeJavaVersionEnum
+            );
             throw new GradleException(message);
         }
 
@@ -195,8 +215,15 @@ public void generate() {
                 expectedJavaVersionEnum = JavaVersion.toVersion(Integer.toString(version));
             }
             if (javaVersionEnum != expectedJavaVersionEnum) {
-                String message = "The environment variable JAVA" + version + "_HOME must be set to a JDK installation directory for Java " +
-                    expectedJavaVersionEnum + " but is [" + javaHome + "] corresponding to [" + javaVersionEnum + "]";
+                String message = String.format(
+                    Locale.ROOT,
+                    "The environment variable JAVA%d_HOME must be set to a JDK installation directory for Java"
+                        + " %s but is [%s] corresponding to [%s]",
+                    version,
+                    expectedJavaVersionEnum,
+                    javaHome,
+                    javaVersionEnum
+                );
                 throw new GradleException(message);
             }
         }
@@ -217,11 +244,11 @@ private void writeToFile(File file, String content) {
      * Finds printable java version of the given JAVA_HOME
      */
     private String findJavaVersionDetails(File javaHome) {
-        String versionInfoScript = "print(" +
-            "java.lang.System.getProperty(\"java.vendor.version\", java.lang.System.getProperty(\"java.vendor\")) + \" \" + " +
-            "java.lang.System.getProperty(\"java.version\") + \" [\" + " +
-            "java.lang.System.getProperty(\"java.vm.name\") + \" \" + " +
-            "java.lang.System.getProperty(\"java.vm.version\") + \"]\");";
+        String versionInfoScript = "print("
+            + "java.lang.System.getProperty(\"java.vendor.version\", java.lang.System.getProperty(\"java.vendor\")) + \" \" + "
+            + "java.lang.System.getProperty(\"java.version\") + \" [\" + "
+            + "java.lang.System.getProperty(\"java.vm.name\") + \" \" + "
+            + "java.lang.System.getProperty(\"java.vm.version\") + \"]\");";
         return runJavaAsScript(javaHome, versionInfoScript).trim();
     }
 
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java
index 7c3c4ab8e8083..dbe13916a2858 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/info/GlobalBuildInfoPlugin.java
@@ -66,8 +66,8 @@ public void apply(Project project) {
             }
         }
 
-        GenerateGlobalBuildInfoTask generateTask = project.getTasks().create("generateGlobalBuildInfo",
-            GenerateGlobalBuildInfoTask.class, task -> {
+        GenerateGlobalBuildInfoTask generateTask = project.getTasks()
+            .create("generateGlobalBuildInfo", GenerateGlobalBuildInfoTask.class, task -> {
                 task.setJavaVersions(javaVersions);
                 task.setMinimumCompilerVersion(minimumCompilerVersion);
                 task.setMinimumRuntimeVersion(minimumRuntimeVersion);
@@ -104,14 +104,16 @@ public void apply(Project project) {
             params.setInFipsJvm(isInFipsJvm());
         });
 
-        project.allprojects(p -> {
-            // Make sure than any task execution generates and prints build info
-            p.getTasks().configureEach(task -> {
-                if (task != generateTask && task != printTask) {
-                    task.dependsOn(printTask);
-                }
-            });
-        });
+        project.allprojects(
+            p -> {
+                // Make sure than any task execution generates and prints build info
+                p.getTasks().configureEach(task -> {
+                    if (task != generateTask && task != printTask) {
+                        task.dependsOn(printTask);
+                    }
+                });
+            }
+        );
     }
 
     private static File findCompilerJavaHome() {
@@ -139,11 +141,16 @@ private static File findRuntimeJavaHome(final File compilerJavaHome) {
     private static String findJavaHome(String version) {
         String versionedJavaHome = System.getenv(getJavaHomeEnvVarName(version));
         if (versionedJavaHome == null) {
-            throw new GradleException(
-                "$" + getJavaHomeEnvVarName(version) + " must be set to build Elasticsearch. " +
-                    "Note that if the variable was just set you might have to run `./gradlew --stop` for " +
-                    "it to be picked up. See https://github.com/elastic/elasticsearch/issues/31399 details."
+            final String exceptionMessage = String.format(
+                Locale.ROOT,
+                "$%s must be set to build Elasticsearch. "
+                    + "Note that if the variable was just set you "
+                    + "might have to run `./gradlew --stop` for "
+                    + "it to be picked up. See https://github.com/elastic/elasticsearch/issues/31399 details.",
+                getJavaHomeEnvVarName(version)
             );
+
+            throw new GradleException(exceptionMessage);
         }
         return versionedJavaHome;
     }
@@ -157,9 +164,9 @@ private static boolean isInFipsJvm() {
     }
 
     private static String getResourceContents(String resourcePath) {
-        try (BufferedReader reader = new BufferedReader(
-            new InputStreamReader(GlobalBuildInfoPlugin.class.getResourceAsStream(resourcePath))
-        )) {
+        try (
+            BufferedReader reader = new BufferedReader(new InputStreamReader(GlobalBuildInfoPlugin.class.getResourceAsStream(resourcePath)))
+        ) {
             StringBuilder b = new StringBuilder();
             for (String line = reader.readLine(); line != null; line = reader.readLine()) {
                 if (b.length() != 0) {
@@ -194,7 +201,7 @@ private static int findDefaultParallel(Project project) {
                             if (name.equals("physical id")) {
                                 currentID = value;
                             }
-                            // Number  of cores not including hyper-threading
+                            // Number of cores not including hyper-threading
                             if (name.equals("cpu cores")) {
                                 assert currentID.isEmpty() == false;
                                 socketToCore.put("currentID", Integer.valueOf(value));
@@ -298,9 +305,7 @@ public static String gitRevision(File rootDir) {
     private static String readFirstLine(final Path path) throws IOException {
         String firstLine;
         try (Stream<String> lines = Files.lines(path, StandardCharsets.UTF_8)) {
-            firstLine = lines
-                .findFirst()
-                .orElseThrow(() -> new IOException("file [" + path + "] is empty"));
+            firstLine = lines.findFirst().orElseThrow(() -> new IOException("file [" + path + "] is empty"));
         }
         return firstLine;
     }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/DependencyLicensesTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/DependencyLicensesTask.java
index 07f13ab338c4b..e6d147b8ee606 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/DependencyLicensesTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/DependencyLicensesTask.java
@@ -44,6 +44,7 @@
 import java.util.HashSet;
 import java.util.LinkedHashMap;
 import java.util.List;
+import java.util.Locale;
 import java.util.Map;
 import java.util.Set;
 import java.util.regex.Matcher;
@@ -209,7 +210,8 @@ private void failIfAnyMissing(String item, Boolean exists, String type) {
     }
 
     private void checkDependencies(Map<String, Boolean> licenses, Map<String, Boolean> notices, Set<File> shaFiles)
-        throws NoSuchAlgorithmException, IOException {
+        throws NoSuchAlgorithmException,
+        IOException {
         for (File dependency : dependencies) {
             String jarName = dependency.getName();
             String depName = regex.matcher(jarName).replaceFirst("");
@@ -223,8 +225,8 @@ private void checkDependencies(Map<String, Boolean> licenses, Map<String, Boolea
         }
     }
 
-    private void validateSha(Set<File> shaFiles, File dependency, String jarName, String depName)
-        throws NoSuchAlgorithmException, IOException {
+    private void validateSha(Set<File> shaFiles, File dependency, String jarName, String depName) throws NoSuchAlgorithmException,
+        IOException {
         if (ignoreShas.contains(depName)) {
             // local deps should not have sha files!
             if (getShaFile(jarName).exists()) {
@@ -269,10 +271,18 @@ private void checkSha(File jar, String jarName, Set<File> shaFiles) throws NoSuc
         String sha = getSha1(jar);
 
         if (expectedSha.equals(sha) == false) {
-            throw new GradleException(
-                "SHA has changed! Expected " + expectedSha + " for " + jarName + " but got " + sha + ". " +
-                    "\nThis usually indicates a corrupt dependency cache or artifacts changed upstream." +
-                    "\nEither wipe your cache, fix the upstream artifact, or delete " + shaFile + " and run updateShas");
+            final String exceptionMessage = String.format(
+                Locale.ROOT,
+                "SHA has changed! Expected %s for %s but got %s."
+                    + "\nThis usually indicates a corrupt dependency cache or artifacts changed upstream."
+                    + "\nEither wipe your cache, fix the upstream artifact, or delete %s and run updateShas",
+                expectedSha,
+                jarName,
+                sha,
+                shaFile
+            );
+
+            throw new GradleException(exceptionMessage);
         }
         shaFiles.remove(shaFile);
     }
@@ -314,13 +324,11 @@ Set<File> getShaFiles() {
             throw new GradleException("\"" + licensesDir.getPath() + "\" isn't a valid directory");
         }
 
-        return Arrays.stream(array)
-            .filter(file -> file.getName().endsWith(SHA_EXTENSION))
-            .collect(Collectors.toSet());
+        return Arrays.stream(array).filter(file -> file.getName().endsWith(SHA_EXTENSION)).collect(Collectors.toSet());
     }
 
     String getSha1(File file) throws IOException, NoSuchAlgorithmException {
-        byte[] bytes =  Files.readAllBytes(file.toPath());
+        byte[] bytes = Files.readAllBytes(file.toPath());
 
         MessageDigest digest = MessageDigest.getInstance("SHA-1");
         char[] encoded = Hex.encodeHex(digest.digest(bytes));
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/FilePermissionsTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/FilePermissionsTask.java
index 4b079384be5c5..68839f86c1035 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/FilePermissionsTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/FilePermissionsTask.java
@@ -50,10 +50,10 @@ public class FilePermissionsTask extends DefaultTask {
      * A pattern set of which files should be checked.
      */
     private final PatternFilterable filesFilter = new PatternSet()
-            // we always include all source files, and exclude what should not be checked
-            .include("**")
-            // exclude sh files that might have the executable bit set
-            .exclude("**/*.sh");
+        // we always include all source files, and exclude what should not be checked
+        .include("**")
+        // exclude sh files that might have the executable bit set
+        .exclude("**/*.sh");
 
     private File outputMarker = new File(getProject().getBuildDir(), "markers/filePermissions");
 
@@ -64,11 +64,11 @@ public FilePermissionsTask() {
     private static boolean isExecutableFile(File file) {
         try {
             Set<PosixFilePermission> permissions = Files.getFileAttributeView(file.toPath(), PosixFileAttributeView.class)
-                    .readAttributes()
-                    .permissions();
+                .readAttributes()
+                .permissions();
             return permissions.contains(PosixFilePermission.OTHERS_EXECUTE)
-                    || permissions.contains(PosixFilePermission.OWNER_EXECUTE)
-                    || permissions.contains(PosixFilePermission.GROUP_EXECUTE);
+                || permissions.contains(PosixFilePermission.OWNER_EXECUTE)
+                || permissions.contains(PosixFilePermission.GROUP_EXECUTE);
         } catch (IOException e) {
             throw new IllegalStateException("unable to read the file " + file + " attributes", e);
         }
@@ -80,10 +80,11 @@ private static boolean isExecutableFile(File file) {
     @InputFiles
     @SkipWhenEmpty
     public FileCollection getFiles() {
-        return Boilerplate.getJavaSourceSets(getProject()).stream()
-                .map(sourceSet -> sourceSet.getAllSource().matching(filesFilter))
-                .reduce(FileTree::plus)
-                .orElse(getProject().files().getAsFileTree());
+        return Boilerplate.getJavaSourceSets(getProject())
+            .stream()
+            .map(sourceSet -> sourceSet.getAllSource().matching(filesFilter))
+            .reduce(FileTree::plus)
+            .orElse(getProject().files().getAsFileTree());
     }
 
     @TaskAction
@@ -91,10 +92,11 @@ public void checkInvalidPermissions() throws IOException {
         if (Os.isFamily(Os.FAMILY_WINDOWS)) {
             throw new StopExecutionException();
         }
-        List<String> failures = getFiles().getFiles().stream()
-                .filter(FilePermissionsTask::isExecutableFile)
-                .map(file -> "Source file is executable: " + file)
-                .collect(Collectors.toList());
+        List<String> failures = getFiles().getFiles()
+            .stream()
+            .filter(FilePermissionsTask::isExecutableFile)
+            .map(file -> "Source file is executable: " + file)
+            .collect(Collectors.toList());
 
         if (!failures.isEmpty()) {
             throw new GradleException("Found invalid file permissions:\n" + String.join("\n", failures));
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/ForbiddenPatternsTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/ForbiddenPatternsTask.java
index 123aa397da856..2bf9e56d3afbd 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/ForbiddenPatternsTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/ForbiddenPatternsTask.java
@@ -88,7 +88,9 @@ public ForbiddenPatternsTask() {
     @InputFiles
     @SkipWhenEmpty
     public FileCollection getFiles() {
-        return getProject().getConvention().getPlugin(JavaPluginConvention.class).getSourceSets()
+        return getProject().getConvention()
+            .getPlugin(JavaPluginConvention.class)
+            .getSourceSets()
             .stream()
             .map(sourceSet -> sourceSet.getAllSource().matching(filesFilter))
             .reduce(FileTree::plus)
@@ -101,8 +103,8 @@ public void checkInvalidPatterns() throws IOException {
         List<String> failures = new ArrayList<>();
         for (File f : getFiles()) {
             List<String> lines;
-            try(Stream<String> stream = Files.lines(f.toPath(), StandardCharsets.UTF_8)) {
-                    lines = stream.collect(Collectors.toList());
+            try (Stream<String> stream = Files.lines(f.toPath(), StandardCharsets.UTF_8)) {
+                lines = stream.collect(Collectors.toList());
             } catch (UncheckedIOException e) {
                 throw new IllegalArgumentException("Failed to read " + f + " as UTF_8", e);
             }
@@ -112,13 +114,17 @@ public void checkInvalidPatterns() throws IOException {
                 .collect(Collectors.toList());
 
             String path = getProject().getRootProject().getProjectDir().toURI().relativize(f.toURI()).toString();
-            failures.addAll(invalidLines.stream()
-                .map(l -> new AbstractMap.SimpleEntry<>(l+1, lines.get(l)))
-                .flatMap(kv -> patterns.entrySet().stream()
-                    .filter(p -> Pattern.compile(p.getValue()).matcher(kv.getValue()).find())
-                    .map(p -> "- " + p.getKey() + " on line " + kv.getKey() + " of " + path)
-                )
-                .collect(Collectors.toList()));
+            failures.addAll(
+                invalidLines.stream()
+                    .map(l -> new AbstractMap.SimpleEntry<>(l + 1, lines.get(l)))
+                    .flatMap(
+                        kv -> patterns.entrySet()
+                            .stream()
+                            .filter(p -> Pattern.compile(p.getValue()).matcher(kv.getValue()).find())
+                            .map(p -> "- " + p.getKey() + " on line " + kv.getKey() + " of " + path)
+                    )
+                    .collect(Collectors.toList())
+            );
         }
         if (failures.isEmpty() == false) {
             throw new GradleException("Found invalid patterns:\n" + String.join("\n", failures));
@@ -143,7 +149,7 @@ public void exclude(String... excludes) {
         filesFilter.exclude(excludes);
     }
 
-    public void rule(Map<String,String> props) {
+    public void rule(Map<String, String> props) {
         String name = props.remove("name");
         if (name == null) {
             throw new InvalidUserDataException("Missing [name] for invalid pattern rule");
@@ -153,8 +159,7 @@ public void rule(Map<String,String> props) {
             throw new InvalidUserDataException("Missing [pattern] for invalid pattern rule");
         }
         if (props.isEmpty() == false) {
-            throw new InvalidUserDataException("Unknown arguments for ForbiddenPatterns rule mapping: "
-                + props.keySet().toString());
+            throw new InvalidUserDataException("Unknown arguments for ForbiddenPatterns rule mapping: " + props.keySet().toString());
         }
         // TODO: fail if pattern contains a newline, it won't work (currently)
         patterns.put(name, pattern);
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/LoggerUsageTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/LoggerUsageTask.java
index a730e069d5a7f..0cb01d764b28f 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/LoggerUsageTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/LoggerUsageTask.java
@@ -67,10 +67,15 @@ public void setClasspath(FileCollection classpath) {
     @PathSensitive(PathSensitivity.RELATIVE)
     @SkipWhenEmpty
     public FileCollection getClassDirectories() {
-        return getProject().getConvention().getPlugin(JavaPluginConvention.class).getSourceSets().stream()
+        return getProject().getConvention()
+            .getPlugin(JavaPluginConvention.class)
+            .getSourceSets()
+            .stream()
             // Don't pick up all source sets like the java9 ones as logger-check doesn't support the class format
-            .filter(sourceSet -> sourceSet.getName().equals(SourceSet.MAIN_SOURCE_SET_NAME)
-                || sourceSet.getName().equals(SourceSet.TEST_SOURCE_SET_NAME))
+            .filter(
+                sourceSet -> sourceSet.getName().equals(SourceSet.MAIN_SOURCE_SET_NAME)
+                    || sourceSet.getName().equals(SourceSet.TEST_SOURCE_SET_NAME)
+            )
             .map(sourceSet -> sourceSet.getOutput().getClassesDirs())
             .reduce(FileCollection::plus)
             .orElse(getProject().files())
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/PrecommitTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/PrecommitTask.java
index 5a29c4a4a3570..9e2ac08a8ddea 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/PrecommitTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/PrecommitTask.java
@@ -36,7 +36,7 @@ public File getSuccessMarker() {
 
     @TaskAction
     public void writeMarker() throws IOException {
-        Files.write(getSuccessMarker().toPath(), new byte[]{}, StandardOpenOption.CREATE);
+        Files.write(getSuccessMarker().toPath(), new byte[] {}, StandardOpenOption.CREATE);
     }
 
 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/TestingConventionRule.java b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/TestingConventionRule.java
index 5fec05d945ed5..32838fd243d6f 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/TestingConventionRule.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/TestingConventionRule.java
@@ -67,6 +67,7 @@ public void setBaseClasses(Collection<String> baseClasses) {
     public void taskName(Pattern expression) {
         taskNames.add(expression);
     }
+
     public void taskName(String expression) {
         taskNames.add(Pattern.compile(expression));
     }
@@ -86,8 +87,10 @@ public Set<Pattern> getTaskNames() {
 
     @Override
     public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
+        if (this == o)
+            return true;
+        if (o == null || getClass() != o.getClass())
+            return false;
         TestingConventionRule that = (TestingConventionRule) o;
         return Objects.equals(suffix, that.suffix);
     }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/TestingConventionsTasks.java b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/TestingConventionsTasks.java
index 2f5028315a425..5b16ca7d40f1e 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/TestingConventionsTasks.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/TestingConventionsTasks.java
@@ -71,19 +71,22 @@ public TestingConventionsTasks() {
 
     @Input
     public Map<String, Set<File>> getClassFilesPerEnabledTask() {
-        return getProject().getTasks().withType(Test.class).stream()
+        return getProject().getTasks()
+            .withType(Test.class)
+            .stream()
             .filter(Task::getEnabled)
-            .collect(Collectors.toMap(
-                Task::getPath,
-                task -> task.getCandidateClassFiles().getFiles()
-            ));
+            .collect(Collectors.toMap(Task::getPath, task -> task.getCandidateClassFiles().getFiles()));
     }
 
     @Input
     public Map<String, File> getTestClassNames() {
         if (testClassNames == null) {
-            testClassNames = Boilerplate.getJavaSourceSets(getProject()).getByName("test").getOutput().getClassesDirs()
-                .getFiles().stream()
+            testClassNames = Boilerplate.getJavaSourceSets(getProject())
+                .getByName("test")
+                .getOutput()
+                .getClassesDirs()
+                .getFiles()
+                .stream()
                 .filter(File::exists)
                 .flatMap(testRoot -> walkPathAndLoadClasses(testRoot).entrySet().stream())
                 .collect(Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue));
@@ -113,8 +116,11 @@ public Set<String> getMainClassNamedLikeTests() {
             return Collections.emptySet();
         }
         return javaSourceSets.getByName(SourceSet.MAIN_SOURCE_SET_NAME)
-            .getOutput().getClassesDirs().getAsFileTree()
-            .getFiles().stream()
+            .getOutput()
+            .getClassesDirs()
+            .getAsFileTree()
+            .getFiles()
+            .stream()
             .filter(file -> file.getName().endsWith(".class"))
             .map(File::getName)
             .map(name -> name.substring(0, name.length() - 6))
@@ -126,21 +132,22 @@ public Set<String> getMainClassNamedLikeTests() {
     public void doCheck() throws IOException {
         final String problems;
 
-        try (URLClassLoader isolatedClassLoader = new URLClassLoader(
-            getTestsClassPath().getFiles().stream().map(this::fileToUrl).toArray(URL[]::new)
-        )) {
+        try (
+            URLClassLoader isolatedClassLoader = new URLClassLoader(
+                getTestsClassPath().getFiles().stream().map(this::fileToUrl).toArray(URL[]::new)
+            )
+        ) {
             Predicate<Class<?>> isStaticClass = clazz -> Modifier.isStatic(clazz.getModifiers());
             Predicate<Class<?>> isPublicClass = clazz -> Modifier.isPublic(clazz.getModifiers());
             Predicate<Class<?>> isAbstractClass = clazz -> Modifier.isAbstract(clazz.getModifiers());
 
-            final Map<File, ? extends Class<?>> classes = getTestClassNames().entrySet().stream()
-                .collect(Collectors.toMap(
-                    Map.Entry::getValue,
-                    entry -> loadClassWithoutInitializing(entry.getKey(), isolatedClassLoader))
-                );
+            final Map<File, ? extends Class<?>> classes = getTestClassNames().entrySet()
+                .stream()
+                .collect(Collectors.toMap(Map.Entry::getValue, entry -> loadClassWithoutInitializing(entry.getKey(), isolatedClassLoader)));
 
             final FileTree allTestClassFiles = getProject().files(
-                classes.values().stream()
+                classes.values()
+                    .stream()
                     .filter(isStaticClass.negate())
                     .filter(isPublicClass)
                     .filter((Predicate<Class<?>>) this::implementsNamingConvention)
@@ -150,11 +157,13 @@ public void doCheck() throws IOException {
 
             final Map<String, Set<File>> classFilesPerTask = getClassFilesPerEnabledTask();
 
-            final Map<String, Set<Class<?>>> testClassesPerTask = classFilesPerTask.entrySet().stream()
+            final Map<String, Set<Class<?>>> testClassesPerTask = classFilesPerTask.entrySet()
+                .stream()
                 .collect(
                     Collectors.toMap(
                         Map.Entry::getKey,
-                        entry -> entry.getValue().stream()
+                        entry -> entry.getValue()
+                            .stream()
                             .map(classes::get)
                             .filter(this::implementsNamingConvention)
                             .collect(Collectors.toSet())
@@ -172,23 +181,27 @@ public void doCheck() throws IOException {
                     .collect(
                         Collectors.toMap(
                             TestingConventionRule::getSuffix,
-                            rule -> rule.getBaseClasses().stream()
+                            rule -> rule.getBaseClasses()
+                                .stream()
                                 .map(each -> loadClassWithoutInitializing(each, isolatedClassLoader))
                                 .collect(Collectors.toSet())
-                        ));
+                        )
+                    );
             }
 
             problems = collectProblems(
                 checkNoneExists(
                     "Test classes implemented by inner classes will not run",
-                    classes.values().stream()
+                    classes.values()
+                        .stream()
                         .filter(isStaticClass)
                         .filter(isPublicClass)
                         .filter(((Predicate<Class<?>>) this::implementsNamingConvention).or(this::seemsLikeATest))
                 ),
                 checkNoneExists(
                     "Seem like test classes but don't match naming convention",
-                    classes.values().stream()
+                    classes.values()
+                        .stream()
                         .filter(isStaticClass.negate())
                         .filter(isPublicClass)
                         .filter(isAbstractClass.negate())
@@ -199,54 +212,42 @@ public void doCheck() throws IOException {
                 // TODO: check for abstract classes that implement the naming conventions
                 // No empty enabled tasks
                 collectProblems(
-                    testClassesPerTask.entrySet().stream()
-                        .map(entry ->
-                            checkAtLeastOneExists(
-                                "test class included in task " + entry.getKey(),
-                                entry.getValue().stream()
-                            )
-                        )
+                    testClassesPerTask.entrySet()
+                        .stream()
+                        .map(entry -> checkAtLeastOneExists("test class included in task " + entry.getKey(), entry.getValue().stream()))
                         .sorted()
                         .collect(Collectors.joining("\n"))
                 ),
                 checkNoneExists(
-                    "Test classes are not included in any enabled task (" +
-                        classFilesPerTask.keySet().stream()
-                            .collect(Collectors.joining(",")) + ")",
-                    allTestClassFiles.getFiles().stream()
-                        .filter(testFile ->
-                            classFilesPerTask.values().stream()
-                                .anyMatch(fileSet -> fileSet.contains(testFile)) == false
-                        )
+                    "Test classes are not included in any enabled task ("
+                        + classFilesPerTask.keySet().stream().collect(Collectors.joining(","))
+                        + ")",
+                    allTestClassFiles.getFiles()
+                        .stream()
+                        .filter(testFile -> classFilesPerTask.values().stream().anyMatch(fileSet -> fileSet.contains(testFile)) == false)
                         .map(classes::get)
                 ),
-                collectProblems(
-                    suffixToBaseClass.entrySet().stream()
-                        .filter(entry -> entry.getValue().isEmpty() == false)
-                        .map(entry -> {
-                            return checkNoneExists(
-                                "Tests classes with suffix `" + entry.getKey() + "` should extend " +
-                                    entry.getValue().stream().map(Class::getName).collect(Collectors.joining(" or ")) +
-                                    " but the following classes do not",
-                                classes.values().stream()
-                                    .filter(clazz -> clazz.getName().endsWith(entry.getKey()))
-                                    .filter(clazz -> entry.getValue().stream()
-                                        .anyMatch(test -> test.isAssignableFrom(clazz)) == false)
-                            );
-                        }).sorted()
-                        .collect(Collectors.joining("\n"))
-                ),
+                collectProblems(suffixToBaseClass.entrySet().stream().filter(entry -> entry.getValue().isEmpty() == false).map(entry -> {
+                    return checkNoneExists(
+                        "Tests classes with suffix `"
+                            + entry.getKey()
+                            + "` should extend "
+                            + entry.getValue().stream().map(Class::getName).collect(Collectors.joining(" or "))
+                            + " but the following classes do not",
+                        classes.values()
+                            .stream()
+                            .filter(clazz -> clazz.getName().endsWith(entry.getKey()))
+                            .filter(clazz -> entry.getValue().stream().anyMatch(test -> test.isAssignableFrom(clazz)) == false)
+                    );
+                }).sorted().collect(Collectors.joining("\n"))),
                 // TODO: check that the testing tasks are included in the right task based on the name ( from the rule )
-                checkNoneExists(
-                    "Classes matching the test naming convention should be in test not main",
-                    getMainClassNamedLikeTests()
-                )
+                checkNoneExists("Classes matching the test naming convention should be in test not main", getMainClassNamedLikeTests())
             );
         }
 
         if (problems.isEmpty()) {
             getSuccessMarker().getParentFile().mkdirs();
-            Files.write(getSuccessMarker().toPath(), new byte[]{}, StandardOpenOption.CREATE);
+            Files.write(getSuccessMarker().toPath(), new byte[] {}, StandardOpenOption.CREATE);
         } else {
             getLogger().error(problems);
             throw new IllegalStateException("Testing conventions are not honored");
@@ -254,17 +255,11 @@ public void doCheck() throws IOException {
     }
 
     private String collectProblems(String... problems) {
-        return Stream.of(problems)
-            .map(String::trim)
-            .filter(s -> s.isEmpty() == false)
-            .collect(Collectors.joining("\n"));
+        return Stream.of(problems).map(String::trim).filter(s -> s.isEmpty() == false).collect(Collectors.joining("\n"));
     }
 
     private String checkNoneExists(String message, Stream<? extends Class<?>> stream) {
-        String problem = stream
-            .map(each -> "  * " + each.getName())
-            .sorted()
-            .collect(Collectors.joining("\n"));
+        String problem = stream.map(each -> "  * " + each.getName()).sorted().collect(Collectors.joining("\n"));
         if (problem.isEmpty() == false) {
             return message + ":\n" + problem;
         } else {
@@ -273,10 +268,7 @@ private String checkNoneExists(String message, Stream<? extends Class<?>> stream
     }
 
     private String checkNoneExists(String message, Set<? extends String> candidates) {
-        String problem = candidates.stream()
-            .map(each -> "  * " + each)
-            .sorted()
-            .collect(Collectors.joining("\n"));
+        String problem = candidates.stream().map(each -> "  * " + each).sorted().collect(Collectors.joining("\n"));
         if (problem.isEmpty() == false) {
             return message + ":\n" + problem;
         } else {
@@ -309,8 +301,12 @@ private boolean seemsLikeATest(Class<?> clazz) {
                     return true;
                 }
                 if (isAnnotated(method, junitAnnotation)) {
-                    getLogger().debug("{} is a test because it has method '{}' annotated with '{}'",
-                        clazz.getName(), method.getName(), junitAnnotation.getName());
+                    getLogger().debug(
+                        "{} is a test because it has method '{}' annotated with '{}'",
+                        clazz.getName(),
+                        method.getName(),
+                        junitAnnotation.getName()
+                    );
                     return true;
                 }
             }
@@ -318,9 +314,7 @@ private boolean seemsLikeATest(Class<?> clazz) {
             return false;
         } catch (NoClassDefFoundError e) {
             // Include the message to get more info to get more a more useful message when running Gradle without -s
-            throw new IllegalStateException(
-                "Failed to inspect class " + clazz.getName() + ". Missing class? " + e.getMessage(),
-                e);
+            throw new IllegalStateException("Failed to inspect class " + clazz.getName() + ". Missing class? " + e.getMessage(), e);
         }
     }
 
@@ -329,9 +323,7 @@ private boolean implementsNamingConvention(Class<?> clazz) {
     }
 
     private boolean implementsNamingConvention(String className) {
-        if (naming.stream()
-            .map(TestingConventionRule::getSuffix)
-            .anyMatch(suffix -> className.endsWith(suffix))) {
+        if (naming.stream().map(TestingConventionRule::getSuffix).anyMatch(suffix -> className.endsWith(suffix))) {
             getLogger().debug("{} is a test because it matches the naming convention", className);
             return true;
         }
@@ -339,9 +331,7 @@ private boolean implementsNamingConvention(String className) {
     }
 
     private boolean matchesTestMethodNamingConvention(Method method) {
-        return method.getName().startsWith(TEST_METHOD_PREFIX) &&
-            Modifier.isStatic(method.getModifiers()) == false
-            ;
+        return method.getName().startsWith(TEST_METHOD_PREFIX) && Modifier.isStatic(method.getModifiers()) == false;
     }
 
     private boolean isAnnotated(Method method, Class<?> annotation) {
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/ThirdPartyAuditTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/ThirdPartyAuditTask.java
index 4ed1543df1b55..b97ff3cb214a1 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/ThirdPartyAuditTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/precommit/ThirdPartyAuditTask.java
@@ -69,9 +69,7 @@ public class ThirdPartyAuditTask extends DefaultTask {
         "WARNING: Class '(.*)' cannot be loaded \\(.*\\)\\. Please fix the classpath!"
     );
 
-    private static final Pattern VIOLATION_PATTERN = Pattern.compile(
-        "\\s\\sin ([a-zA-Z0-9$.]+) \\(.*\\)"
-    );
+    private static final Pattern VIOLATION_PATTERN = Pattern.compile("\\s\\sin ([a-zA-Z0-9$.]+) \\(.*\\)");
     private static final int SIG_KILL_EXIT_VALUE = 137;
     private static final List<Integer> EXPECTED_EXIT_CODES = Arrays.asList(
         CliMain.EXIT_SUCCESS,
@@ -124,10 +122,7 @@ public void setJavaHome(String javaHome) {
 
     @Internal
     public File getJarExpandDir() {
-        return new File(
-            new File(getProject().getBuildDir(), "precommit/thirdPartyAudit"),
-            getName()
-        );
+        return new File(new File(getProject().getBuildDir(), "precommit/thirdPartyAudit"), getName());
     }
 
     @OutputFile
@@ -154,7 +149,7 @@ public void ignoreViolations(String... violatingClasses) {
         }
     }
 
-    public void ignoreJarHellWithJDK(String ...classes) {
+    public void ignoreJarHellWithJDK(String... classes) {
         for (String each : classes) {
             jdkJarHellExcludes.add(each);
         }
@@ -174,16 +169,15 @@ public Set<String> getMissingClassExcludes() {
     @Classpath
     @SkipWhenEmpty
     public Set<File> getJarsToScan() {
-        // These are SelfResolvingDependency, and some of them backed by file collections, like  the Gradle API files,
+        // These are SelfResolvingDependency, and some of them backed by file collections, like the Gradle API files,
         // or dependencies added as `files(...)`, we can't be sure if those are third party or not.
         // err on the side of scanning these to make sure we don't miss anything
-        Spec<Dependency> reallyThirdParty = dep -> dep.getGroup() != null &&
-            dep.getGroup().startsWith("org.elasticsearch") == false;
-        Set<File> jars = getRuntimeConfiguration()
+        Spec<Dependency> reallyThirdParty = dep -> dep.getGroup() != null && dep.getGroup().startsWith("org.elasticsearch") == false;
+        Set<File> jars = getRuntimeConfiguration().getResolvedConfiguration().getFiles(reallyThirdParty);
+        Set<File> compileOnlyConfiguration = getProject().getConfigurations()
+            .getByName("compileOnly")
             .getResolvedConfiguration()
             .getFiles(reallyThirdParty);
-        Set<File> compileOnlyConfiguration = getProject().getConfigurations().getByName("compileOnly").getResolvedConfiguration()
-            .getFiles(reallyThirdParty);
         // don't scan provided dependencies that we already scanned, e.x. don't scan cores dependencies for every plugin
         if (compileOnlyConfiguration != null) {
             jars.removeAll(compileOnlyConfiguration);
@@ -221,8 +215,7 @@ public void runThirdPartyAudit() throws IOException {
             if (bogousExcludesCount != 0 && bogousExcludesCount == missingClassExcludes.size() + violationsExcludes.size()) {
                 logForbiddenAPIsOutput(forbiddenApisOutput);
                 throw new IllegalStateException(
-                    "All excluded classes seem to have no issues. " +
-                        "This is sometimes an indication that the check silently failed"
+                    "All excluded classes seem to have no issues. This is sometimes an indication that the check silently failed"
                 );
             }
             assertNoPointlessExclusions("are not missing", missingClassExcludes, missingClasses);
@@ -232,10 +225,7 @@ public void runThirdPartyAudit() throws IOException {
         assertNoPointlessExclusions("do not generate jar hell with the JDK", jdkJarHellExcludes, jdkJarHellClasses);
 
         if (missingClassExcludes == null && (missingClasses.isEmpty() == false)) {
-            getLogger().info(
-                "Found missing classes, but task is configured to ignore all of them:\n {}",
-                formatClassList(missingClasses)
-            );
+            getLogger().info("Found missing classes, but task is configured to ignore all of them:\n {}", formatClassList(missingClasses));
             missingClasses.clear();
         }
 
@@ -247,7 +237,7 @@ public void runThirdPartyAudit() throws IOException {
             if (missingClasses.isEmpty() == false) {
                 getLogger().error("Missing classes:\n{}", formatClassList(missingClasses));
             }
-            if(violationsClasses.isEmpty() == false) {
+            if (violationsClasses.isEmpty() == false) {
                 getLogger().error("Classes with violations:\n{}", formatClassList(violationsClasses));
             }
             throw new IllegalStateException("Audit of third party dependencies failed");
@@ -257,7 +247,7 @@ public void runThirdPartyAudit() throws IOException {
 
         // Mark successful third party audit check
         getSuccessMarker().getParentFile().mkdirs();
-        Files.write(getSuccessMarker().toPath(), new byte[]{});
+        Files.write(getSuccessMarker().toPath(), new byte[] {});
     }
 
     private void logForbiddenAPIsOutput(String forbiddenApisOutput) {
@@ -310,8 +300,7 @@ private void assertNoJarHell(Set<String> jdkJarHellClasses) {
         jdkJarHellClasses.removeAll(jdkJarHellExcludes);
         if (jdkJarHellClasses.isEmpty() == false) {
             throw new IllegalStateException(
-                "Audit of third party dependencies failed:\n" +
-                    "  Jar Hell with the JDK:\n" + formatClassList(jdkJarHellClasses)
+                "Audit of third party dependencies failed:\n  Jar Hell with the JDK:\n" + formatClassList(jdkJarHellClasses)
             );
         }
     }
@@ -328,10 +317,7 @@ private void assertNoPointlessExclusions(String specifics, Set<String> excludes,
     }
 
     private String formatClassList(Set<String> classList) {
-        return classList.stream()
-            .map(name -> "  * " + name)
-            .sorted()
-            .collect(Collectors.joining("\n"));
+        return classList.stream().map(name -> "  * " + name).sorted().collect(Collectors.joining("\n"));
     }
 
     private String runForbiddenAPIsCli() throws IOException {
@@ -347,11 +333,7 @@ private String runForbiddenAPIsCli() throws IOException {
             );
             spec.jvmArgs("-Xmx1g");
             spec.setMain("de.thetaphi.forbiddenapis.cli.CliMain");
-            spec.args(
-                "-f", getSignatureFile().getAbsolutePath(),
-                "-d", getJarExpandDir(),
-                "--allowmissingclasses"
-            );
+            spec.args("-f", getSignatureFile().getAbsolutePath(), "-d", getJarExpandDir(), "--allowmissingclasses");
             spec.setErrorOutput(errorOut);
             if (getLogger().isInfoEnabled() == false) {
                 spec.setStandardOutput(new NullOutputStream());
@@ -359,9 +341,7 @@ private String runForbiddenAPIsCli() throws IOException {
             spec.setIgnoreExitValue(true);
         });
         if (OS.current().equals(OS.LINUX) && result.getExitValue() == SIG_KILL_EXIT_VALUE) {
-            throw new IllegalStateException(
-                "Third party audit was killed buy SIGKILL, could be a victim of the Linux OOM killer"
-            );
+            throw new IllegalStateException("Third party audit was killed buy SIGKILL, could be a victim of the Linux OOM killer");
         }
         final String forbiddenApisOutput;
         try (ByteArrayOutputStream outputStream = errorOut) {
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingTar.java b/buildSrc/src/main/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingTar.java
index f76289dc591b3..e92221f1f869e 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingTar.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingTar.java
@@ -79,7 +79,8 @@ private static class SymbolicLinkPreservingTarCopyAction implements CopyAction {
         SymbolicLinkPreservingTarCopyAction(
             final Provider<RegularFile> tarFile,
             final ArchiveOutputStreamFactory compressor,
-            final boolean isPreserveFileTimestamps) {
+            final boolean isPreserveFileTimestamps
+        ) {
             this.tarFile = tarFile;
             this.compressor = compressor;
             this.isPreserveFileTimestamps = isPreserveFileTimestamps;
@@ -87,8 +88,10 @@ private static class SymbolicLinkPreservingTarCopyAction implements CopyAction {
 
         @Override
         public WorkResult execute(final CopyActionProcessingStream stream) {
-            try (OutputStream out = compressor.createArchiveOutputStream(tarFile.get().getAsFile());
-                TarArchiveOutputStream tar = new TarArchiveOutputStream(out)) {
+            try (
+                OutputStream out = compressor.createArchiveOutputStream(tarFile.get().getAsFile());
+                TarArchiveOutputStream tar = new TarArchiveOutputStream(out)
+            ) {
                 tar.setLongFileMode(TarArchiveOutputStream.LONGFILE_GNU);
                 stream.process(new SymbolicLinkPreservingTarStreamAction(tar));
             } catch (final IOException e) {
@@ -136,7 +139,8 @@ private boolean isChildOfVisitedSymbolicLink(final FileCopyDetailsInternal detai
                     return false;
                 }
                 for (final File symbolicLink : visitedSymbolicLinks) {
-                    if (isChildOf(symbolicLink, file)) return true;
+                    if (isChildOf(symbolicLink, file))
+                        return true;
                 }
                 return false;
             }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingUntarTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingUntarTask.java
index 8b65bfc553fd9..7b35531cb1efd 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingUntarTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingUntarTask.java
@@ -95,8 +95,11 @@ public SymbolicLinkPreservingUntarTask(final ObjectFactory objectFactory) {
     final void execute() {
         // ensure the target extraction path is empty
         getProject().delete(extractPath);
-        try (TarArchiveInputStream tar =
-                 new TarArchiveInputStream(new GzipCompressorInputStream(new FileInputStream(tarFile.getAsFile().get())))) {
+        try (
+            TarArchiveInputStream tar = new TarArchiveInputStream(
+                new GzipCompressorInputStream(new FileInputStream(tarFile.getAsFile().get()))
+            )
+        ) {
             final Path destinationPath = extractPath.get().getAsFile().toPath();
             TarArchiveEntry entry = tar.getNextTarEntry();
             while (entry != null) {
@@ -127,9 +130,10 @@ final void execute() {
                     final PosixFileAttributeView view = Files.getFileAttributeView(destination, PosixFileAttributeView.class);
                     if (view != null) {
                         final Set<PosixFilePermission> permissions = PosixFilePermissions.fromString(
-                            permissions((entry.getMode() >> 6) & 07) +
-                                permissions((entry.getMode() >> 3) & 07) +
-                                permissions((entry.getMode() >> 0) & 07));
+                            permissions((entry.getMode() >> 6) & 07) + permissions((entry.getMode() >> 3) & 07) + permissions(
+                                (entry.getMode() >> 0) & 07
+                            )
+                        );
                         Files.setPosixFilePermissions(destination, permissions);
                     }
                 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/test/BatsTestTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/test/BatsTestTask.java
index 8b5d106b6ab8b..8dbac3f7c19fd 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/test/BatsTestTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/test/BatsTestTask.java
@@ -110,9 +110,9 @@ public void runBats() {
         List<Object> command = new ArrayList<>();
         command.add("bats");
         command.add("--tap");
-        command.addAll(testsDir.getAsFileTree().getFiles().stream()
-            .filter(f -> f.getName().endsWith(".bats"))
-            .sorted().collect(Collectors.toList()));
+        command.addAll(
+            testsDir.getAsFileTree().getFiles().stream().filter(f -> f.getName().endsWith(".bats")).sorted().collect(Collectors.toList())
+        );
         getProject().exec(spec -> {
             spec.setWorkingDir(distributionsDir.getAsFile());
             spec.environment(System.getenv());
diff --git a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/test/DistroTestPlugin.java
similarity index 78%
rename from buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
rename to buildSrc/src/main/java/org/elasticsearch/gradle/test/DistroTestPlugin.java
index 3afd66ea00012..28aac0f558412 100644
--- a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/DistroTestPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/test/DistroTestPlugin.java
@@ -19,7 +19,6 @@
 
 package org.elasticsearch.gradle.test;
 
-import org.elasticsearch.gradle.BuildPlugin;
 import org.elasticsearch.gradle.BwcVersions;
 import org.elasticsearch.gradle.DistributionDownloadPlugin;
 import org.elasticsearch.gradle.ElasticsearchDistribution;
@@ -93,7 +92,7 @@ public void apply(Project project) {
         final boolean runDockerTests = shouldRunDockerTests(project);
 
         project.getPluginManager().apply(DistributionDownloadPlugin.class);
-        project.getPluginManager().apply(BuildPlugin.class);
+        project.getPluginManager().apply("elasticsearch.build");
 
         // TODO: it would be useful to also have the SYSTEM_JAVA_HOME setup in the root project, so that running from GCP only needs
         // a java for gradle to run, and the tests are self sufficient and consistent with the java they use
@@ -117,11 +116,12 @@ public void apply(Project project) {
         }
         Map<String, TaskProvider<?>> batsTests = new HashMap<>();
         batsTests.put("bats oss", configureBatsTest(project, "oss", distributionsDir, copyDistributionsTask));
-        configureBatsTest(project, "plugins",distributionsDir, copyDistributionsTask, copyPluginsTask).configure(t ->
-            t.setPluginsDir(pluginsDir)
+        configureBatsTest(project, "plugins", distributionsDir, copyDistributionsTask, copyPluginsTask).configure(
+            t -> t.setPluginsDir(pluginsDir)
+        );
+        configureBatsTest(project, "upgrade", distributionsDir, copyDistributionsTask, copyUpgradeTask).configure(
+            t -> t.setUpgradeDir(upgradeDir)
         );
-        configureBatsTest(project, "upgrade", distributionsDir, copyDistributionsTask, copyUpgradeTask).configure(t ->
-            t.setUpgradeDir(upgradeDir));
 
         project.subprojects(vmProject -> {
             vmProject.getPluginManager().apply(VagrantBasePlugin.class);
@@ -135,8 +135,12 @@ public void apply(Project project) {
                 Platform platform = distribution.getPlatform();
                 // this condition ensures windows boxes get windows distributions, and linux boxes get linux distributions
                 if (isWindows(vmProject) == (platform == Platform.WINDOWS)) {
-                    TaskProvider<GradleDistroTestTask> vmTask =
-                        configureVMWrapperTask(vmProject, distribution.getName() + " distribution", destructiveTaskName, vmDependencies);
+                    TaskProvider<GradleDistroTestTask> vmTask = configureVMWrapperTask(
+                        vmProject,
+                        distribution.getName() + " distribution",
+                        destructiveTaskName,
+                        vmDependencies
+                    );
                     vmTask.configure(t -> t.dependsOn(distribution));
 
                     distroTest.configure(t -> {
@@ -169,7 +173,12 @@ public void apply(Project project) {
     }
 
     private static Jdk createJdk(
-        NamedDomainObjectContainer<Jdk> jdksContainer, String name, String vendor, String version, String platform) {
+        NamedDomainObjectContainer<Jdk> jdksContainer,
+        String name,
+        String vendor,
+        String version,
+        String platform
+    ) {
         Jdk jdk = jdksContainer.create(name);
         jdk.setVendor(vendor);
         jdk.setVersion(version);
@@ -215,17 +224,14 @@ private static List<Object> configureVM(Project project) {
         vagrant.vmEnv("PATH", convertPath(project, vagrant, gradleJdk, "/bin:$PATH", "\\bin;$Env:PATH"));
         // pass these along to get correct build scans
         if (System.getenv("JENKINS_URL") != null) {
-            Stream.of("JOB_NAME", "JENKINS_URL", "BUILD_NUMBER", "BUILD_URL").forEach(name ->
-                vagrant.vmEnv(name, System.getenv(name))
-            );
+            Stream.of("JOB_NAME", "JENKINS_URL", "BUILD_NUMBER", "BUILD_URL").forEach(name -> vagrant.vmEnv(name, System.getenv(name)));
         }
         vagrant.setIsWindowsVM(isWindows(project));
 
         return Arrays.asList(systemJdk, gradleJdk);
     }
 
-    private static Object convertPath(Project project, VagrantExtension vagrant, Jdk jdk,
-                                      String additionaLinux, String additionalWindows) {
+    private static Object convertPath(Project project, VagrantExtension vagrant, Jdk jdk, String additionaLinux, String additionalWindows) {
         return new Object() {
             @Override
             public String toString() {
@@ -240,110 +246,111 @@ public String toString() {
     private static TaskProvider<Copy> configureCopyDistributionsTask(Project project, Provider<Directory> distributionsDir) {
 
         // temporary, until we have tasks per distribution
-        return project.getTasks().register(COPY_DISTRIBUTIONS_TASK, Copy.class,
-            t -> {
-                t.into(distributionsDir);
-                t.from(project.getConfigurations().getByName(DISTRIBUTIONS_CONFIGURATION));
-
-                Path distributionsPath = distributionsDir.get().getAsFile().toPath();
-                TaskInputs inputs = t.getInputs();
-                inputs.property("version", VersionProperties.getElasticsearch());
-                t.doLast(action -> {
-                    try {
-                        Files.writeString(distributionsPath.resolve("version"), VersionProperties.getElasticsearch());
-                    } catch (IOException e) {
-                        throw new UncheckedIOException(e);
-                    }
-                });
+        return project.getTasks().register(COPY_DISTRIBUTIONS_TASK, Copy.class, t -> {
+            t.into(distributionsDir);
+            t.from(project.getConfigurations().getByName(DISTRIBUTIONS_CONFIGURATION));
+
+            Path distributionsPath = distributionsDir.get().getAsFile().toPath();
+            TaskInputs inputs = t.getInputs();
+            inputs.property("version", VersionProperties.getElasticsearch());
+            t.doLast(action -> {
+                try {
+                    Files.writeString(distributionsPath.resolve("version"), VersionProperties.getElasticsearch());
+                } catch (IOException e) {
+                    throw new UncheckedIOException(e);
+                }
+            });
         });
     }
 
-    private static TaskProvider<Copy> configureCopyUpgradeTask(Project project, Version upgradeVersion,
-                                                               Provider<Directory> upgradeDir) {
+    private static TaskProvider<Copy> configureCopyUpgradeTask(Project project, Version upgradeVersion, Provider<Directory> upgradeDir) {
         // temporary, until we have tasks per distribution
-        return project.getTasks().register(COPY_UPGRADE_TASK, Copy.class,
-            t -> {
-                t.into(upgradeDir);
-                t.from(project.getConfigurations().getByName(UPGRADE_CONFIGURATION));
-
-                Path upgradePath = upgradeDir.get().getAsFile().toPath();
-
-                // write bwc version, and append -SNAPSHOT if it is an unreleased version
-                ExtraPropertiesExtension extraProperties = project.getExtensions().getByType(ExtraPropertiesExtension.class);
-                BwcVersions bwcVersions = (BwcVersions) extraProperties.get("bwcVersions");
-                final String upgradeFromVersion;
-                if (bwcVersions.unreleasedInfo(upgradeVersion) != null) {
-                    upgradeFromVersion = upgradeVersion.toString() + "-SNAPSHOT";
-                } else {
-                    upgradeFromVersion = upgradeVersion.toString();
+        return project.getTasks().register(COPY_UPGRADE_TASK, Copy.class, t -> {
+            t.into(upgradeDir);
+            t.from(project.getConfigurations().getByName(UPGRADE_CONFIGURATION));
+
+            Path upgradePath = upgradeDir.get().getAsFile().toPath();
+
+            // write bwc version, and append -SNAPSHOT if it is an unreleased version
+            ExtraPropertiesExtension extraProperties = project.getExtensions().getByType(ExtraPropertiesExtension.class);
+            BwcVersions bwcVersions = (BwcVersions) extraProperties.get("bwcVersions");
+            final String upgradeFromVersion;
+            if (bwcVersions.unreleasedInfo(upgradeVersion) != null) {
+                upgradeFromVersion = upgradeVersion.toString() + "-SNAPSHOT";
+            } else {
+                upgradeFromVersion = upgradeVersion.toString();
+            }
+            TaskInputs inputs = t.getInputs();
+            inputs.property("upgrade_from_version", upgradeFromVersion);
+            // TODO: this is serializable, need to think how to represent this as an input
+            // inputs.property("bwc_versions", bwcVersions);
+            t.doLast(action -> {
+                try {
+                    Files.writeString(upgradePath.resolve("upgrade_from_version"), upgradeFromVersion);
+                    // this is always true, but bats tests rely on it. It is just temporary until bats is removed.
+                    Files.writeString(upgradePath.resolve("upgrade_is_oss"), "");
+                } catch (IOException e) {
+                    throw new UncheckedIOException(e);
                 }
-                TaskInputs inputs = t.getInputs();
-                inputs.property("upgrade_from_version", upgradeFromVersion);
-                // TODO: this is serializable, need to think how to represent this as an input
-                //inputs.property("bwc_versions", bwcVersions);
-                t.doLast(action -> {
-                    try {
-                        Files.writeString(upgradePath.resolve("upgrade_from_version"), upgradeFromVersion);
-                        // this is always true, but bats tests rely on it. It is just temporary until bats is removed.
-                        Files.writeString(upgradePath.resolve("upgrade_is_oss"), "");
-                    } catch (IOException e) {
-                        throw new UncheckedIOException(e);
-                    }
-                });
             });
+        });
     }
 
     private static TaskProvider<Copy> configureCopyPluginsTask(Project project, Provider<Directory> pluginsDir) {
         Configuration pluginsConfiguration = project.getConfigurations().create(PLUGINS_CONFIGURATION);
 
         // temporary, until we have tasks per distribution
-        return project.getTasks().register(COPY_PLUGINS_TASK, Copy.class,
-            t -> {
-                t.into(pluginsDir);
-                t.from(pluginsConfiguration);
-            });
+        return project.getTasks().register(COPY_PLUGINS_TASK, Copy.class, t -> {
+            t.into(pluginsDir);
+            t.from(pluginsConfiguration);
+        });
     }
 
-    private static TaskProvider<GradleDistroTestTask> configureVMWrapperTask(Project project, String type, String destructiveTaskPath,
-                                                                             List<Object> dependsOn) {
+    private static TaskProvider<GradleDistroTestTask> configureVMWrapperTask(
+        Project project,
+        String type,
+        String destructiveTaskPath,
+        List<Object> dependsOn
+    ) {
         int taskNameStart = destructiveTaskPath.lastIndexOf(':') + "destructive".length() + 1;
         String taskname = destructiveTaskPath.substring(taskNameStart);
         taskname = taskname.substring(0, 1).toLowerCase(Locale.ROOT) + taskname.substring(1);
-        return project.getTasks().register(taskname, GradleDistroTestTask.class,
-            t -> {
-                t.setGroup(JavaBasePlugin.VERIFICATION_GROUP);
-                t.setDescription("Runs " + type + " tests within vagrant");
-                t.setTaskName(destructiveTaskPath);
-                t.extraArg("-D'" + IN_VM_SYSPROP + "'");
-                t.dependsOn(dependsOn);
-            });
+        return project.getTasks().register(taskname, GradleDistroTestTask.class, t -> {
+            t.setGroup(JavaBasePlugin.VERIFICATION_GROUP);
+            t.setDescription("Runs " + type + " tests within vagrant");
+            t.setTaskName(destructiveTaskPath);
+            t.extraArg("-D'" + IN_VM_SYSPROP + "'");
+            t.dependsOn(dependsOn);
+        });
     }
 
     private static TaskProvider<?> configureDistroTest(Project project, ElasticsearchDistribution distribution) {
-        return project.getTasks().register(destructiveDistroTestTaskName(distribution), Test.class,
-            t -> {
-                t.setMaxParallelForks(1);
-                t.setWorkingDir(project.getProjectDir());
-                t.systemProperty(DISTRIBUTION_SYSPROP, distribution.toString());
-                if (System.getProperty(IN_VM_SYSPROP) == null) {
-                    t.dependsOn(distribution);
-                }
-            });
+        return project.getTasks().register(destructiveDistroTestTaskName(distribution), Test.class, t -> {
+            t.setMaxParallelForks(1);
+            t.setWorkingDir(project.getProjectDir());
+            t.systemProperty(DISTRIBUTION_SYSPROP, distribution.toString());
+            if (System.getProperty(IN_VM_SYSPROP) == null) {
+                t.dependsOn(distribution);
+            }
+        });
     }
 
-    private static TaskProvider<BatsTestTask> configureBatsTest(Project project, String type, Provider<Directory> distributionsDir,
-                                                                Object... deps) {
-        return project.getTasks().register("destructiveBatsTest." + type, BatsTestTask.class,
-            t -> {
-                Directory batsDir = project.getLayout().getProjectDirectory().dir("bats");
-                t.setTestsDir(batsDir.dir(type));
-                t.setUtilsDir(batsDir.dir("utils"));
-                t.setDistributionsDir(distributionsDir);
-                t.setPackageName("elasticsearch" + (type.equals("oss") ? "-oss" : ""));
-                if (System.getProperty(IN_VM_SYSPROP) == null) {
-                    t.dependsOn(deps);
-                }
-            });
+    private static TaskProvider<BatsTestTask> configureBatsTest(
+        Project project,
+        String type,
+        Provider<Directory> distributionsDir,
+        Object... deps
+    ) {
+        return project.getTasks().register("destructiveBatsTest." + type, BatsTestTask.class, t -> {
+            Directory batsDir = project.getLayout().getProjectDirectory().dir("bats");
+            t.setTestsDir(batsDir.dir(type));
+            t.setUtilsDir(batsDir.dir("utils"));
+            t.setDistributionsDir(distributionsDir);
+            t.setPackageName("elasticsearch" + (type.equals("oss") ? "-oss" : ""));
+            if (System.getProperty(IN_VM_SYSPROP) == null) {
+                t.dependsOn(deps);
+            }
+        });
     }
 
     private List<ElasticsearchDistribution> configureDistributions(Project project, Version upgradeVersion, boolean runDockerTests) {
@@ -383,8 +390,15 @@ private List<ElasticsearchDistribution> configureDistributions(Project project,
         for (Platform platform : Arrays.asList(Platform.LINUX, Platform.WINDOWS)) {
             for (Flavor flavor : Flavor.values()) {
                 for (boolean bundledJdk : Arrays.asList(true, false)) {
-                    addDistro(distributions, Type.ARCHIVE, platform, flavor, bundledJdk,
-                              VersionProperties.getElasticsearch(), currentDistros);
+                    addDistro(
+                        distributions,
+                        Type.ARCHIVE,
+                        platform,
+                        flavor,
+                        bundledJdk,
+                        VersionProperties.getElasticsearch(),
+                        currentDistros
+                    );
                 }
             }
         }
@@ -398,16 +412,23 @@ private List<ElasticsearchDistribution> configureDistributions(Project project,
         packagingConfig.setExtendsFrom(distroConfigs);
 
         Configuration packagingUpgradeConfig = project.getConfigurations().create(UPGRADE_CONFIGURATION);
-        List<Configuration> distroUpgradeConfigs = upgradeDistros.stream().map(ElasticsearchDistribution::getConfiguration)
+        List<Configuration> distroUpgradeConfigs = upgradeDistros.stream()
+            .map(ElasticsearchDistribution::getConfiguration)
             .collect(Collectors.toList());
         packagingUpgradeConfig.setExtendsFrom(distroUpgradeConfigs);
 
         return currentDistros;
     }
 
-    private static void addDistro(NamedDomainObjectContainer<ElasticsearchDistribution> distributions,
-                                  Type type, Platform platform, Flavor flavor, boolean bundledJdk, String version,
-                                  List<ElasticsearchDistribution> container) {
+    private static void addDistro(
+        NamedDomainObjectContainer<ElasticsearchDistribution> distributions,
+        Type type,
+        Platform platform,
+        Flavor flavor,
+        boolean bundledJdk,
+        String version,
+        List<ElasticsearchDistribution> container
+    ) {
 
         String name = distroId(type, platform, flavor, bundledJdk) + "-" + version;
         if (distributions.findByName(name) != null) {
@@ -436,11 +457,7 @@ private static String distroId(Type type, Platform platform, Flavor flavor, bool
 
     private static String destructiveDistroTestTaskName(ElasticsearchDistribution distro) {
         Type type = distro.getType();
-        return "destructiveDistroTest." + distroId(
-            type,
-            distro.getPlatform(),
-            distro.getFlavor(),
-            distro.getBundledJdk());
+        return "destructiveDistroTest." + distroId(type, distro.getPlatform(), distro.getFlavor(), distro.getBundledJdk());
     }
 
     static Map<String, String> parseOsRelease(final List<String> osReleaseLines) {
@@ -484,7 +501,6 @@ private static List<String> getLinuxExclusionList(Project project) {
      * method determines whether the Docker tests should be run on the host
      * OS. Essentially, unless an OS and version is specifically excluded, we expect
      * to be able to run Docker and test the Docker images.
-     * @param project
      */
     private static boolean shouldRunDockerTests(Project project) {
         switch (OS.current()) {
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/test/ErrorReportingTestListener.java b/buildSrc/src/main/java/org/elasticsearch/gradle/test/ErrorReportingTestListener.java
index ce806b48e56a7..37811f335763c 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/test/ErrorReportingTestListener.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/test/ErrorReportingTestListener.java
@@ -193,12 +193,12 @@ public String getFullName() {
 
         @Override
         public boolean equals(Object o) {
-            if (this == o) return true;
-            if (o == null || getClass() != o.getClass()) return false;
+            if (this == o)
+                return true;
+            if (o == null || getClass() != o.getClass())
+                return false;
             Descriptor that = (Descriptor) o;
-            return Objects.equals(name, that.name) &&
-                Objects.equals(className, that.className) &&
-                Objects.equals(parent, that.parent);
+            return Objects.equals(name, that.name) && Objects.equals(className, that.className) && Objects.equals(parent, that.parent);
         }
 
         @Override
diff --git a/buildSrc/src/main/groovy/org/elasticsearch/gradle/test/JNAKernel32Library.java b/buildSrc/src/main/java/org/elasticsearch/gradle/test/JNAKernel32Library.java
similarity index 100%
rename from buildSrc/src/main/groovy/org/elasticsearch/gradle/test/JNAKernel32Library.java
rename to buildSrc/src/main/java/org/elasticsearch/gradle/test/JNAKernel32Library.java
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchCluster.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchCluster.java
index 32789f69e9f2f..9359f59d762b8 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchCluster.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchCluster.java
@@ -62,22 +62,16 @@ public class ElasticsearchCluster implements TestClusterConfiguration, Named {
     private final LinkedHashMap<String, Predicate<TestClusterConfiguration>> waitConditions = new LinkedHashMap<>();
     private final Project project;
     private final ReaperService reaper;
-    private int nodeIndex  = 0;
+    private int nodeIndex = 0;
 
-    public ElasticsearchCluster(String path, String clusterName, Project project,
-                                ReaperService reaper, File workingDirBase) {
+    public ElasticsearchCluster(String path, String clusterName, Project project, ReaperService reaper, File workingDirBase) {
         this.path = path;
         this.clusterName = clusterName;
         this.project = project;
         this.reaper = reaper;
         this.workingDirBase = workingDirBase;
         this.nodes = project.container(ElasticsearchNode.class);
-        this.nodes.add(
-            new ElasticsearchNode(
-                path, clusterName + "-0",
-                project, reaper, workingDirBase
-                )
-        );
+        this.nodes.add(new ElasticsearchNode(path, clusterName + "-0", project, reaper, workingDirBase));
         // configure the cluster name eagerly so nodes know about it
         this.nodes.all((node) -> node.defaultConfig.put("cluster.name", safeName(clusterName)));
 
@@ -97,10 +91,8 @@ public void setNumberOfNodes(int numberOfNodes) {
             );
         }
 
-        for (int i = nodes.size() ; i < numberOfNodes; i++) {
-            this.nodes.add(new ElasticsearchNode(
-                path, clusterName + "-" + i, project, reaper, workingDirBase
-                ));
+        for (int i = nodes.size(); i < numberOfNodes; i++) {
+            this.nodes.add(new ElasticsearchNode(path, clusterName + "-" + i, project, reaper, workingDirBase));
         }
     }
 
@@ -274,7 +266,8 @@ private void commonNodeConfig() {
             // Can only configure master nodes if we have node names defined
             if (nodeNames != null) {
                 if (node.getVersion().onOrAfter("7.0.0")) {
-                    node.defaultConfig.keySet().stream()
+                    node.defaultConfig.keySet()
+                        .stream()
                         .filter(name -> name.startsWith("discovery.zen."))
                         .collect(Collectors.toList())
                         .forEach(node.defaultConfig::remove);
@@ -413,9 +406,7 @@ public boolean isProcessAlive() {
 
     public ElasticsearchNode singleNode() {
         if (nodes.size() != 1) {
-            throw new IllegalStateException(
-                "Can't treat " + this + " as single node as it has " + nodes.size() + " nodes"
-            );
+            throw new IllegalStateException("Can't treat " + this + " as single node as it has " + nodes.size() + " nodes");
         }
         return getFirstNode();
     }
@@ -456,11 +447,12 @@ public NamedDomainObjectContainer<ElasticsearchNode> getNodes() {
 
     @Override
     public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
+        if (this == o)
+            return true;
+        if (o == null || getClass() != o.getClass())
+            return false;
         ElasticsearchCluster that = (ElasticsearchCluster) o;
-        return Objects.equals(clusterName, that.clusterName) &&
-            Objects.equals(path, that.path);
+        return Objects.equals(clusterName, that.clusterName) && Objects.equals(path, that.path);
     }
 
     @Override
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
index 36656a2516634..aeb8e3e359d7a 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/ElasticsearchNode.java
@@ -430,26 +430,20 @@ public synchronized void start() {
 
         if (plugins.isEmpty() == false) {
             logToProcessStdout("Installing " + plugins.size() + " plugins");
-            plugins.forEach(plugin -> runElasticsearchBinScript(
-                "elasticsearch-plugin",
-                "install", "--batch", plugin.toString())
-            );
+            plugins.forEach(plugin -> runElasticsearchBinScript("elasticsearch-plugin", "install", "--batch", plugin.toString()));
         }
 
         if (getVersion().before("6.3.0") && testDistribution == TestDistribution.DEFAULT) {
             LOGGER.info("emulating the {} flavor for {} by installing x-pack", testDistribution, getVersion());
-            runElasticsearchBinScript(
-                "elasticsearch-plugin",
-                "install", "--batch", "x-pack"
-            );
+            runElasticsearchBinScript("elasticsearch-plugin", "install", "--batch", "x-pack");
         }
 
         if (keystoreSettings.isEmpty() == false || keystoreFiles.isEmpty() == false) {
             logToProcessStdout("Adding " + keystoreSettings.size() + " keystore settings and " + keystoreFiles.size() + " keystore files");
             runElasticsearchBinScript("elasticsearch-keystore", "create");
 
-            keystoreSettings.forEach((key, value) ->
-                runElasticsearchBinScriptWithInput(value.toString(), "elasticsearch-keystore", "add", "-x", key)
+            keystoreSettings.forEach(
+                (key, value) -> runElasticsearchBinScriptWithInput(value.toString(), "elasticsearch-keystore", "add", "-x", key)
             );
 
             for (Map.Entry<String, File> entry : keystoreFiles.entrySet()) {
@@ -473,12 +467,12 @@ public synchronized void start() {
         if (credentials.isEmpty() == false) {
             logToProcessStdout("Setting up " + credentials.size() + " users");
 
-            credentials.forEach(paramMap -> runElasticsearchBinScript(
-                getVersion().onOrAfter("6.3.0") ? "elasticsearch-users" : "x-pack/users",
-                paramMap.entrySet().stream()
-                    .flatMap(entry -> Stream.of(entry.getKey(), entry.getValue()))
-                    .toArray(String[]::new)
-            ));
+            credentials.forEach(
+                paramMap -> runElasticsearchBinScript(
+                    getVersion().onOrAfter("6.3.0") ? "elasticsearch-users" : "x-pack/users",
+                    paramMap.entrySet().stream().flatMap(entry -> Stream.of(entry.getKey(), entry.getValue())).toArray(String[]::new)
+                )
+            );
         }
 
         if (cliSetup.isEmpty() == false) {
@@ -501,7 +495,8 @@ private void logToProcessStdout(String message) {
             Files.write(
                 esStdoutFile,
                 ("[" + Instant.now().toString() + "] [BUILD] " + message + "\n").getBytes(StandardCharsets.UTF_8),
-                StandardOpenOption.CREATE, StandardOpenOption.APPEND
+                StandardOpenOption.CREATE,
+                StandardOpenOption.APPEND
             );
         } catch (IOException e) {
             throw new UncheckedIOException(e);
@@ -534,8 +529,7 @@ private void copyExtraConfigFiles() {
         }
         extraConfigFiles.forEach((destination, from) -> {
             if (Files.exists(from.toPath()) == false) {
-                throw new TestClustersException("Can't create extra config file from " + from + " for " + this +
-                    " as it does not exist");
+                throw new TestClustersException("Can't create extra config file from " + from + " for " + this + " as it does not exist");
             }
             Path dst = configFile.getParent().resolve(destination);
             try {
@@ -553,7 +547,7 @@ private void copyExtraConfigFiles() {
      * //TODO: Remove this when system modules are available
      */
     private void copyExtraJars() {
-        if (extraJarFiles.isEmpty() == false){
+        if (extraJarFiles.isEmpty() == false) {
             logToProcessStdout("Setting up " + extraJarFiles.size() + " additional jar dependencies");
         }
         extraJarFiles.forEach(from -> {
@@ -571,9 +565,8 @@ private void installModules() {
         if (testDistribution == TestDistribution.INTEG_TEST) {
             logToProcessStdout("Installing " + modules.size() + "modules");
             for (File module : modules) {
-                Path destination = getDistroDir().resolve("modules").resolve(module.getName().replace(".zip", "")
-                    .replace("-" + getVersion(), "")
-                    .replace("-SNAPSHOT", ""));
+                Path destination = getDistroDir().resolve("modules")
+                    .resolve(module.getName().replace(".zip", "").replace("-" + getVersion(), "").replace("-SNAPSHOT", ""));
 
                 // only install modules that are not already bundled with the integ-test distribution
                 if (Files.exists(destination) == false) {
@@ -590,16 +583,14 @@ private void installModules() {
                 }
             }
         } else {
-            LOGGER.info("Not installing " + modules.size() + "(s) since the " + distributions + " distribution already " +
-                "has them");
+            LOGGER.info("Not installing " + modules.size() + "(s) since the " + distributions + " distribution already has them");
         }
     }
 
     @Override
     public void extraConfigFile(String destination, File from) {
         if (destination.contains("..")) {
-            throw new IllegalArgumentException("extra config file destination can't be relative, was " + destination +
-                " for " + this);
+            throw new IllegalArgumentException("extra config file destination can't be relative, was " + destination + " for " + this);
         }
         extraConfigFiles.put(destination, from);
     }
@@ -607,8 +598,7 @@ public void extraConfigFile(String destination, File from) {
     @Override
     public void extraConfigFile(String destination, File from, PropertyNormalization normalization) {
         if (destination.contains("..")) {
-            throw new IllegalArgumentException("extra config file destination can't be relative, was " + destination +
-                " for " + this);
+            throw new IllegalArgumentException("extra config file destination can't be relative, was " + destination + " for " + this);
         }
         extraConfigFiles.put(destination, from, normalization);
     }
@@ -638,37 +628,26 @@ public void user(Map<String, String> userSpec) {
     }
 
     private void runElasticsearchBinScriptWithInput(String input, String tool, CharSequence... args) {
-        if (
-            Files.exists(getDistroDir().resolve("bin").resolve(tool)) == false &&
-                Files.exists(getDistroDir().resolve("bin").resolve(tool + ".bat")) == false
-        ) {
-            throw new TestClustersException("Can't run bin script: `" + tool + "` does not exist. " +
-                "Is this the distribution you expect it to be ?");
+        if (Files.exists(getDistroDir().resolve("bin").resolve(tool)) == false
+            && Files.exists(getDistroDir().resolve("bin").resolve(tool + ".bat")) == false) {
+            throw new TestClustersException(
+                "Can't run bin script: `" + tool + "` does not exist. " + "Is this the distribution you expect it to be ?"
+            );
         }
         try (InputStream byteArrayInputStream = new ByteArrayInputStream(input.getBytes(StandardCharsets.UTF_8))) {
             LoggedExec.exec(project, spec -> {
                 spec.setEnvironment(getESEnvironment());
                 spec.workingDir(getDistroDir());
-                spec.executable(
-                    OS.conditionalString()
-                        .onUnix(() -> "./bin/" + tool)
-                        .onWindows(() -> "cmd")
-                        .supply()
-                );
-                spec.args(
-                    OS.<List<CharSequence>>conditional()
-                        .onWindows(() -> {
-                            ArrayList<CharSequence> result = new ArrayList<>();
-                            result.add("/c");
-                            result.add("bin\\" + tool + ".bat");
-                            for (CharSequence arg : args) {
-                                result.add(arg);
-                            }
-                            return result;
-                        })
-                        .onUnix(() -> Arrays.asList(args))
-                        .supply()
-                );
+                spec.executable(OS.conditionalString().onUnix(() -> "./bin/" + tool).onWindows(() -> "cmd").supply());
+                spec.args(OS.<List<CharSequence>>conditional().onWindows(() -> {
+                    ArrayList<CharSequence> result = new ArrayList<>();
+                    result.add("/c");
+                    result.add("bin\\" + tool + ".bat");
+                    for (CharSequence arg : args) {
+                        result.add(arg);
+                    }
+                    return result;
+                }).onUnix(() -> Arrays.asList(args)).supply());
                 spec.setStandardInput(byteArrayInputStream);
 
             });
@@ -683,38 +662,38 @@ private void runElasticsearchBinScript(String tool, CharSequence... args) {
 
     private Map<String, String> getESEnvironment() {
         Map<String, String> defaultEnv = new HashMap<>();
-        if ( getJavaHome() != null) {
+        if (getJavaHome() != null) {
             defaultEnv.put("JAVA_HOME", getJavaHome().getAbsolutePath());
         }
         defaultEnv.put("ES_PATH_CONF", configFile.getParent().toString());
         String systemPropertiesString = "";
         if (systemProperties.isEmpty() == false) {
-            systemPropertiesString = " " + systemProperties.entrySet().stream()
-                .map(entry -> "-D" + entry.getKey() + "=" + entry.getValue())
-                // ES_PATH_CONF is also set as an environment variable and for a reference to ${ES_PATH_CONF}
-                // to work ES_JAVA_OPTS, we need to make sure that ES_PATH_CONF before ES_JAVA_OPTS. Instead,
-                // we replace the reference with the actual value in other environment variables
-                .map(p -> p.replace("${ES_PATH_CONF}", configFile.getParent().toString()))
-                .collect(Collectors.joining(" "));
+            systemPropertiesString = " "
+                + systemProperties.entrySet()
+                    .stream()
+                    .map(entry -> "-D" + entry.getKey() + "=" + entry.getValue())
+                    // ES_PATH_CONF is also set as an environment variable and for a reference to ${ES_PATH_CONF}
+                    // to work ES_JAVA_OPTS, we need to make sure that ES_PATH_CONF before ES_JAVA_OPTS. Instead,
+                    // we replace the reference with the actual value in other environment variables
+                    .map(p -> p.replace("${ES_PATH_CONF}", configFile.getParent().toString()))
+                    .collect(Collectors.joining(" "));
         }
         String jvmArgsString = "";
         if (jvmArgs.isEmpty() == false) {
-            jvmArgsString = " " + jvmArgs.stream()
-                .peek(argument -> {
-                    if (argument.toString().startsWith("-D")) {
-                        throw new TestClustersException("Invalid jvm argument `" + argument +
-                            "` configure as systemProperty instead for " + this
-                        );
-                    }
-                })
-                .collect(Collectors.joining(" "));
+            jvmArgsString = " " + jvmArgs.stream().peek(argument -> {
+                if (argument.toString().startsWith("-D")) {
+                    throw new TestClustersException(
+                        "Invalid jvm argument `" + argument + "` configure as systemProperty instead for " + this
+                    );
+                }
+            }).collect(Collectors.joining(" "));
         }
         String heapSize = System.getProperty("tests.heap.size", "512m");
-        defaultEnv.put("ES_JAVA_OPTS", "-Xms" + heapSize + " -Xmx" + heapSize + " -ea -esa " +
-            systemPropertiesString + " " +
-            jvmArgsString + " " +
-            // Support  passing in additional JVM arguments
-            System.getProperty("tests.jvm.argline", "")
+        defaultEnv.put(
+            "ES_JAVA_OPTS",
+            "-Xms" + heapSize + " -Xmx" + heapSize + " -ea -esa " + systemPropertiesString + " " + jvmArgsString + " " +
+            // Support passing in additional JVM arguments
+                System.getProperty("tests.jvm.argline", "")
         );
         defaultEnv.put("ES_TMPDIR", tmpDir.toString());
         // Windows requires this as it defaults to `c:\windows` despite ES_TMPDIR
@@ -727,9 +706,7 @@ private Map<String, String> getESEnvironment() {
         Set<String> commonKeys = new HashSet<>(environment.keySet());
         commonKeys.retainAll(defaultEnv.keySet());
         if (commonKeys.isEmpty() == false) {
-            throw new IllegalStateException(
-                "testcluster does not allow overwriting the following env vars " + commonKeys + " for " + this
-            );
+            throw new IllegalStateException("testcluster does not allow overwriting the following env vars " + commonKeys + " for " + this);
         }
 
         environment.forEach((key, value) -> defaultEnv.put(key, value.toString()));
@@ -746,7 +723,7 @@ private void startElasticsearchProcess() {
         processBuilder.command(command);
         processBuilder.directory(workingDir.toFile());
         Map<String, String> environment = processBuilder.environment();
-        // Don't inherit anything from the environment for as that would  lack reproducibility
+        // Don't inherit anything from the environment for as that would lack reproducibility
         environment.clear();
         environment.putAll(getESEnvironment());
 
@@ -858,10 +835,7 @@ private void stopHandle(ProcessHandle processHandle, boolean forcibly) {
         // and in that case the ML processes will be grandchildren of the wrapper.
         List<ProcessHandle> children = processHandle.children().collect(Collectors.toList());
         try {
-            logProcessInfo(
-                "Terminating elasticsearch process" + (forcibly ? " forcibly " : "gracefully") + ":",
-                processHandle.info()
-            );
+            logProcessInfo("Terminating elasticsearch process" + (forcibly ? " forcibly " : "gracefully") + ":", processHandle.info());
 
             if (forcibly) {
                 processHandle.destroyForcibly();
@@ -871,8 +845,7 @@ private void stopHandle(ProcessHandle processHandle, boolean forcibly) {
                 if (processHandle.isAlive() == false) {
                     return;
                 }
-                LOGGER.info("process did not terminate after {} {}, stopping it forcefully",
-                    ES_DESTROY_TIMEOUT, ES_DESTROY_TIMEOUT_UNIT);
+                LOGGER.info("process did not terminate after {} {}, stopping it forcefully", ES_DESTROY_TIMEOUT, ES_DESTROY_TIMEOUT_UNIT);
                 processHandle.destroyForcibly();
             }
 
@@ -886,11 +859,11 @@ private void stopHandle(ProcessHandle processHandle, boolean forcibly) {
     }
 
     private void logProcessInfo(String prefix, ProcessHandle.Info info) {
-        LOGGER.info(prefix + " commandLine:`{}` command:`{}` args:`{}`",
-            info.commandLine().orElse("-"), info.command().orElse("-"),
-            Arrays.stream(info.arguments().orElse(new String[]{}))
-                .map(each -> "'" + each + "'")
-                .collect(Collectors.joining(" "))
+        LOGGER.info(
+            prefix + " commandLine:`{}` command:`{}` args:`{}`",
+            info.commandLine().orElse("-"),
+            info.command().orElse("-"),
+            Arrays.stream(info.arguments().orElse(new String[] {})).map(each -> "'" + each + "'").collect(Collectors.joining(" "))
         );
     }
 
@@ -898,7 +871,7 @@ private void logFileContents(String description, Path from) {
         final Map<String, Integer> errorsAndWarnings = new LinkedHashMap<>();
         LinkedList<String> ring = new LinkedList<>();
         try (LineNumberReader reader = new LineNumberReader(Files.newBufferedReader(from))) {
-            for (String line = reader.readLine(); line != null ; line = reader.readLine()) {
+            for (String line = reader.readLine(); line != null; line = reader.readLine()) {
                 final String lineToAdd;
                 if (ring.isEmpty()) {
                     lineToAdd = line;
@@ -908,12 +881,9 @@ private void logFileContents(String description, Path from) {
                         // check to see if the previous message (possibly combined from multiple lines) was an error or
                         // warning as we want to show all of them
                         String previousMessage = normalizeLogLine(ring.getLast());
-                        if (MESSAGES_WE_DONT_CARE_ABOUT.stream().noneMatch(previousMessage::contains) &&
-                            (previousMessage.contains("ERROR") || previousMessage.contains("WARN"))) {
-                            errorsAndWarnings.put(
-                                previousMessage,
-                                errorsAndWarnings.getOrDefault(previousMessage, 0) + 1
-                            );
+                        if (MESSAGES_WE_DONT_CARE_ABOUT.stream().noneMatch(previousMessage::contains)
+                            && (previousMessage.contains("ERROR") || previousMessage.contains("WARN"))) {
+                            errorsAndWarnings.put(previousMessage, errorsAndWarnings.getOrDefault(previousMessage, 0) + 1);
                         }
                     } else {
                         // We combine multi line log messages to make sure we never break exceptions apart
@@ -1026,9 +996,7 @@ private void syncWithLinks(Path sourceRoot, Path destinationRoot) {
                         Files.createLink(destination, source);
                     } catch (IOException e) {
                         // Note does not work for network drives, e.g. Vagrant
-                        throw new UncheckedIOException(
-                            "Failed to create hard link " + destination + " pointing to " + source, e
-                        );
+                        throw new UncheckedIOException("Failed to create hard link " + destination + " pointing to " + source, e);
                     }
                 }
             });
@@ -1085,21 +1053,17 @@ private void createConfiguration() {
             );
         }
         // Make sure no duplicate config keys
-        settings.keySet().stream()
-            .filter(OVERRIDABLE_SETTINGS::contains)
-            .forEach(defaultConfig::remove);
+        settings.keySet().stream().filter(OVERRIDABLE_SETTINGS::contains).forEach(defaultConfig::remove);
 
         try {
             Files.write(
                 configFile,
-                Stream.concat(
-                    settings.entrySet().stream(),
-                    defaultConfig.entrySet().stream()
-                )
+                Stream.concat(settings.entrySet().stream(), defaultConfig.entrySet().stream())
                     .map(entry -> entry.getKey() + ": " + entry.getValue())
                     .collect(Collectors.joining("\n"))
                     .getBytes(StandardCharsets.UTF_8),
-                StandardOpenOption.TRUNCATE_EXISTING, StandardOpenOption.CREATE
+                StandardOpenOption.TRUNCATE_EXISTING,
+                StandardOpenOption.CREATE
             );
 
             final List<Path> configFiles;
@@ -1129,9 +1093,7 @@ private List<String> getTransportPortInternal() {
         try {
             return readPortsFile(transportPortFile);
         } catch (IOException e) {
-            throw new UncheckedIOException(
-                "Failed to read transport ports file: " + transportPortFile + " for " + this, e
-            );
+            throw new UncheckedIOException("Failed to read transport ports file: " + transportPortFile + " for " + this, e);
         }
     }
 
@@ -1139,9 +1101,7 @@ private List<String> getHttpPortInternal() {
         try {
             return readPortsFile(httpPortsFile);
         } catch (IOException e) {
-            throw new UncheckedIOException(
-                "Failed to read http ports file: " + httpPortsFile + " for " + this, e
-            );
+            throw new UncheckedIOException("Failed to read http ports file: " + httpPortsFile + " for " + this, e);
         }
     }
 
@@ -1156,10 +1116,7 @@ private Path getExtractedDistributionDir() {
     }
 
     private List<File> getInstalledFileSet(Action<? super PatternFilterable> filter) {
-        return Stream.concat(
-            plugins.stream().filter(uri -> uri.getScheme().equalsIgnoreCase("file")).map(File::new),
-            modules.stream()
-        )
+        return Stream.concat(plugins.stream().filter(uri -> uri.getScheme().equalsIgnoreCase("file")).map(File::new), modules.stream())
             .filter(File::exists)
             // TODO: We may be able to simplify this with Gradle 5.6
             // https://docs.gradle.org/nightly/release-notes.html#improved-handling-of-zip-archives-on-classpaths
@@ -1200,11 +1157,7 @@ public Set<File> getDistributionFiles() {
     private Set<File> getDistributionFiles(Action<PatternFilterable> patternFilter) {
         Set<File> files = new TreeSet<>();
         for (ElasticsearchDistribution distribution : distributions) {
-            files.addAll(
-                project.fileTree(Paths.get(distribution.getExtracted().toString()))
-                    .matching(patternFilter)
-                    .getFiles()
-            );
+            files.addAll(project.fileTree(Paths.get(distribution.getExtracted().toString())).matching(patternFilter).getFiles());
         }
         return files;
     }
@@ -1252,40 +1205,27 @@ public List<?> getExtraConfigFiles() {
     @Override
     @Internal
     public boolean isProcessAlive() {
-        requireNonNull(
-            esProcess,
-            "Can't wait for `" + this + "` as it's not started. Does the task have `useCluster` ?"
-        );
+        requireNonNull(esProcess, "Can't wait for `" + this + "` as it's not started. Does the task have `useCluster` ?");
         return esProcess.isAlive();
     }
 
     void waitForAllConditions() {
-        waitForConditions(
-            waitConditions,
-            System.currentTimeMillis(),
-            NODE_UP_TIMEOUT_UNIT.toMillis(NODE_UP_TIMEOUT) +
-                // Installing plugins at config time and loading them when nods start requires additional time we need to
-                // account for
-                ADDITIONAL_CONFIG_TIMEOUT_UNIT.toMillis(ADDITIONAL_CONFIG_TIMEOUT *
-                    (
-                        plugins.size() +
-                            keystoreFiles.size() +
-                            keystoreSettings.size() +
-                            credentials.size()
-                    )
-                ),
-            TimeUnit.MILLISECONDS,
-            this
-        );
+        waitForConditions(waitConditions, System.currentTimeMillis(), NODE_UP_TIMEOUT_UNIT.toMillis(NODE_UP_TIMEOUT) +
+        // Installing plugins at config time and loading them when nods start requires additional time we need to
+        // account for
+            ADDITIONAL_CONFIG_TIMEOUT_UNIT.toMillis(
+                ADDITIONAL_CONFIG_TIMEOUT * (plugins.size() + keystoreFiles.size() + keystoreSettings.size() + credentials.size())
+            ), TimeUnit.MILLISECONDS, this);
     }
 
     @Override
     public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
+        if (this == o)
+            return true;
+        if (o == null || getClass() != o.getClass())
+            return false;
         ElasticsearchNode that = (ElasticsearchNode) o;
-        return Objects.equals(name, that.name) &&
-            Objects.equals(path, that.path);
+        return Objects.equals(name, that.name) && Objects.equals(path, that.path);
     }
 
     @Override
@@ -1318,37 +1258,23 @@ private boolean checkPortsFilesExistWithDelay(TestClusterConfiguration node) {
 
     @Internal
     public boolean isHttpSslEnabled() {
-        return Boolean.valueOf(
-            settings.getOrDefault("xpack.security.http.ssl.enabled", "false").toString()
-        );
+        return Boolean.valueOf(settings.getOrDefault("xpack.security.http.ssl.enabled", "false").toString());
     }
 
     void configureHttpWait(WaitForHttpResource wait) {
         if (settings.containsKey("xpack.security.http.ssl.certificate_authorities")) {
             wait.setCertificateAuthorities(
-                getConfigDir()
-                    .resolve(settings.get("xpack.security.http.ssl.certificate_authorities").toString())
-                    .toFile()
+                getConfigDir().resolve(settings.get("xpack.security.http.ssl.certificate_authorities").toString()).toFile()
             );
         }
         if (settings.containsKey("xpack.security.http.ssl.certificate")) {
-            wait.setCertificateAuthorities(
-                getConfigDir()
-                    .resolve(settings.get("xpack.security.http.ssl.certificate").toString())
-                    .toFile()
-            );
+            wait.setCertificateAuthorities(getConfigDir().resolve(settings.get("xpack.security.http.ssl.certificate").toString()).toFile());
         }
         if (settings.containsKey("xpack.security.http.ssl.keystore.path")) {
-            wait.setTrustStoreFile(
-                getConfigDir()
-                    .resolve(settings.get("xpack.security.http.ssl.keystore.path").toString())
-                    .toFile()
-            );
+            wait.setTrustStoreFile(getConfigDir().resolve(settings.get("xpack.security.http.ssl.keystore.path").toString()).toFile());
         }
         if (keystoreSettings.containsKey("xpack.security.http.ssl.keystore.secure_password")) {
-            wait.setTrustStorePassword(
-                keystoreSettings.get("xpack.security.http.ssl.keystore.secure_password").toString()
-            );
+            wait.setTrustStorePassword(keystoreSettings.get("xpack.security.http.ssl.keystore.secure_password").toString());
         }
     }
 
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RestTestRunnerTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RestTestRunnerTask.java
index 9698e4a664b74..f4de829009de3 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RestTestRunnerTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RestTestRunnerTask.java
@@ -19,17 +19,21 @@ public class RestTestRunnerTask extends Test implements TestClustersAware {
     private Collection<ElasticsearchCluster> clusters = new HashSet<>();
 
     public RestTestRunnerTask() {
-        this.getOutputs().doNotCacheIf("Caching disabled for this task since it uses a cluster shared by other tasks",
-            /*
-             * Look for any other tasks which use the same cluster as this task. Since tests often have side effects for the cluster they
-             * execute against, this state can cause issues when trying to cache tests results of tasks that share a cluster. To avoid any
-             * undesired behavior we simply disable the cache if we detect that this task uses a cluster shared between multiple tasks.
-             */
-            t -> getProject().getTasks().withType(RestTestRunnerTask.class)
-                .stream()
-                .filter(task -> task != this)
-                .anyMatch(task -> Collections.disjoint(task.getClusters(), getClusters()) == false)
-        );
+        this.getOutputs()
+            .doNotCacheIf(
+                "Caching disabled for this task since it uses a cluster shared by other tasks",
+                /*
+                 * Look for any other tasks which use the same cluster as this task. Since tests often have side effects for the cluster
+                 * they execute against, this state can cause issues when trying to cache tests results of tasks that share a cluster. To
+                 * avoid any undesired behavior we simply disable the cache if we detect that this task uses a cluster shared between
+                 * multiple tasks.
+                 */
+                t -> getProject().getTasks()
+                    .withType(RestTestRunnerTask.class)
+                    .stream()
+                    .filter(task -> task != this)
+                    .anyMatch(task -> Collections.disjoint(task.getClusters(), getClusters()) == false)
+            );
     }
 
     @Override
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
index cedeff6a9cf5d..99114ed15ec2c 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/RunTask.java
@@ -28,10 +28,7 @@ public class RunTask extends DefaultTestClustersTask {
 
     private Path dataDir = null;
 
-    @Option(
-        option = "debug-jvm",
-        description = "Enable debugging configuration, to allow attaching a debugger to elasticsearch."
-    )
+    @Option(option = "debug-jvm", description = "Enable debugging configuration, to allow attaching a debugger to elasticsearch.")
     public void setDebug(boolean enabled) {
         this.debug = enabled;
     }
@@ -41,10 +38,7 @@ public Boolean getDebug() {
         return debug;
     }
 
-    @Option(
-        option = "data-dir",
-        description = "Override the base data directory used by the testcluster"
-    )
+    @Option(option = "data-dir", description = "Override the base data directory used by the testcluster")
     public void setDataDir(String dataDirStr) {
         dataDir = Paths.get(dataDirStr).toAbsolutePath();
     }
@@ -52,7 +46,9 @@ public void setDataDir(String dataDirStr) {
     @Input
     @Optional
     public String getDataDir() {
-        if (dataDir == null) { return null;}
+        if (dataDir == null) {
+            return null;
+        }
         return dataDir.toString();
     }
 
@@ -61,12 +57,16 @@ public void beforeStart() {
         int debugPort = 5005;
         int httpPort = 9200;
         int transportPort = 9300;
-        Map<String, String> additionalSettings = System.getProperties().entrySet().stream()
+        Map<String, String> additionalSettings = System.getProperties()
+            .entrySet()
+            .stream()
             .filter(entry -> entry.getKey().toString().startsWith(CUSTOM_SETTINGS_PREFIX))
-            .collect(Collectors.toMap(
-                entry -> entry.getKey().toString().substring(CUSTOM_SETTINGS_PREFIX.length()),
-                entry -> entry.getValue().toString()
-            ));
+            .collect(
+                Collectors.toMap(
+                    entry -> entry.getKey().toString().substring(CUSTOM_SETTINGS_PREFIX.length()),
+                    entry -> entry.getValue().toString()
+                )
+            );
         boolean singleNode = getClusters().stream().flatMap(c -> c.getNodes().stream()).count() == 1;
         final Function<ElasticsearchNode, Path> getDataPath;
         if (singleNode) {
@@ -86,10 +86,7 @@ public void beforeStart() {
                     node.setDataPath(getDataPath.apply(node));
                 }
                 if (debug) {
-                    logger.lifecycle(
-                        "Running elasticsearch in debug mode, {} suspending until connected on debugPort {}",
-                        node, debugPort
-                    );
+                    logger.lifecycle("Running elasticsearch in debug mode, {} suspending until connected on debugPort {}", node, debugPort);
                     node.jvmArgs("-agentlib:jdwp=transport=dt_socket,server=n,suspend=y,address=" + debugPort);
                     debugPort += 1;
                 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClusterConfiguration.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClusterConfiguration.java
index 11e5a35604837..b484bc58a1380 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClusterConfiguration.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClusterConfiguration.java
@@ -27,13 +27,13 @@
 import java.net.URI;
 import java.util.LinkedHashMap;
 import java.util.List;
+import java.util.Locale;
 import java.util.Map;
 import java.util.concurrent.TimeUnit;
 import java.util.function.Function;
 import java.util.function.Predicate;
 import java.util.function.Supplier;
 
-
 public interface TestClusterConfiguration {
 
     void setVersion(String version);
@@ -113,7 +113,8 @@ public interface TestClusterConfiguration {
     default void waitForConditions(
         LinkedHashMap<String, Predicate<TestClusterConfiguration>> waitConditions,
         long startedAtMillis,
-        long nodeUpTimeout, TimeUnit nodeUpTimeoutUnit,
+        long nodeUpTimeout,
+        TimeUnit nodeUpTimeoutUnit,
         TestClusterConfiguration context
     ) {
         Logger logger = Logging.getLogger(TestClusterConfiguration.class);
@@ -121,17 +122,13 @@ default void waitForConditions(
             long thisConditionStartedAt = System.currentTimeMillis();
             boolean conditionMet = false;
             Throwable lastException = null;
-            while (
-                System.currentTimeMillis() - startedAtMillis < TimeUnit.MILLISECONDS.convert(nodeUpTimeout, nodeUpTimeoutUnit)
-            ) {
+            while (System.currentTimeMillis() - startedAtMillis < TimeUnit.MILLISECONDS.convert(nodeUpTimeout, nodeUpTimeoutUnit)) {
                 if (context.isProcessAlive() == false) {
-                    throw new TestClustersException(
-                        "process was found dead while waiting for " + description + ", " + this
-                    );
+                    throw new TestClustersException("process was found dead while waiting for " + description + ", " + this);
                 }
 
                 try {
-                    if(predicate.test(context)) {
+                    if (predicate.test(context)) {
                         conditionMet = true;
                         break;
                     }
@@ -142,8 +139,14 @@ default void waitForConditions(
                 }
             }
             if (conditionMet == false) {
-                String message = "`" + context + "` failed to wait for " + description + " after " +
-                    nodeUpTimeout + " " + nodeUpTimeoutUnit;
+                String message = String.format(
+                    Locale.ROOT,
+                    "`%s` failed to wait for %s after %d %s",
+                    context,
+                    description,
+                    nodeUpTimeout,
+                    nodeUpTimeoutUnit
+                );
                 if (lastException == null) {
                     throw new TestClustersException(message);
                 } else {
@@ -160,18 +163,12 @@ default void waitForConditions(
                     throw new TestClustersException(message + extraCause, lastException);
                 }
             }
-            logger.info(
-                "{}: {} took {} seconds",
-                this,  description,
-                (System.currentTimeMillis() - thisConditionStartedAt) / 1000.0
-            );
+            logger.info("{}: {} took {} seconds", this, description, (System.currentTimeMillis() - thisConditionStartedAt) / 1000.0);
         });
     }
 
     default String safeName(String name) {
-        return name
-            .replaceAll("^[^a-zA-Z0-9]+", "")
-            .replaceAll("[^a-zA-Z0-9\\.]+", "-");
+        return name.replaceAll("^[^a-zA-Z0-9]+", "").replaceAll("[^a-zA-Z0-9\\.]+", "-");
     }
 
     boolean isProcessAlive();
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersAware.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersAware.java
index 8cbb4ca133214..2e212f805e99e 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersAware.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersAware.java
@@ -12,19 +12,13 @@ interface TestClustersAware extends Task {
 
     default void useCluster(ElasticsearchCluster cluster) {
         if (cluster.getPath().equals(getProject().getPath()) == false) {
-            throw new TestClustersException(
-                "Task " + getPath() + " can't use test cluster from" +
-                    " another project " + cluster
-            );
+            throw new TestClustersException("Task " + getPath() + " can't use test cluster from" + " another project " + cluster);
         }
 
-        cluster.getNodes().stream().flatMap(node -> node.getDistributions().stream()).forEach(distro ->
-            dependsOn(distro.getExtracted())
-        );
+        cluster.getNodes().stream().flatMap(node -> node.getDistributions().stream()).forEach(distro -> dependsOn(distro.getExtracted()));
         getClusters().add(cluster);
     }
 
-    default void beforeStart() {
-    }
+    default void beforeStart() {}
 
 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersPlugin.java
index a96f8913e8208..e45119670d91f 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersPlugin.java
@@ -40,7 +40,7 @@ public class TestClustersPlugin implements Plugin<Project> {
     public static final String EXTENSION_NAME = "testClusters";
     private static final String REGISTRY_EXTENSION_NAME = "testClustersRegistry";
 
-    private static final Logger logger =  Logging.getLogger(TestClustersPlugin.class);
+    private static final Logger logger = Logging.getLogger(TestClustersPlugin.class);
 
     private ReaperService reaper;
 
@@ -58,7 +58,8 @@ public void apply(Project project) {
         createListClustersTask(project, container);
 
         if (project.getRootProject().getExtensions().findByName(REGISTRY_EXTENSION_NAME) == null) {
-            TestClustersRegistry registry = project.getRootProject().getExtensions()
+            TestClustersRegistry registry = project.getRootProject()
+                .getExtensions()
                 .create(REGISTRY_EXTENSION_NAME, TestClustersRegistry.class);
 
             // When we know what tasks will run, we claim the clusters of those task to differentiate between clusters
@@ -79,27 +80,18 @@ private NamedDomainObjectContainer<ElasticsearchCluster> createTestClustersConta
         // Create an extensions that allows describing clusters
         NamedDomainObjectContainer<ElasticsearchCluster> container = project.container(
             ElasticsearchCluster.class,
-            name -> new ElasticsearchCluster(
-                project.getPath(),
-                name,
-                project,
-                reaper,
-                new File(project.getBuildDir(), "testclusters")
-            )
+            name -> new ElasticsearchCluster(project.getPath(), name, project, reaper, new File(project.getBuildDir(), "testclusters"))
         );
         project.getExtensions().add(EXTENSION_NAME, container);
         return container;
     }
 
-
     private void createListClustersTask(Project project, NamedDomainObjectContainer<ElasticsearchCluster> container) {
         Task listTask = project.getTasks().create(LIST_TASK_NAME);
         listTask.setGroup("ES cluster formation");
         listTask.setDescription("Lists all ES clusters configured for this project");
-        listTask.doLast((Task task) ->
-            container.forEach(cluster ->
-                logger.lifecycle("   * {}: {}", cluster.getName(), cluster.getNumberOfNodes())
-            )
+        listTask.doLast(
+            (Task task) -> container.forEach(cluster -> logger.lifecycle("   * {}: {}", cluster.getName(), cluster.getNumberOfNodes()))
         );
     }
 
@@ -107,7 +99,8 @@ private static void configureClaimClustersHook(Gradle gradle, TestClustersRegist
         // Once we know all the tasks that need to execute, we claim all the clusters that belong to those and count the
         // claims so we'll know when it's safe to stop them.
         gradle.getTaskGraph().whenReady(taskExecutionGraph -> {
-            taskExecutionGraph.getAllTasks().stream()
+            taskExecutionGraph.getAllTasks()
+                .stream()
                 .filter(task -> task instanceof TestClustersAware)
                 .map(task -> (TestClustersAware) task)
                 .flatMap(task -> task.getClusters().stream())
@@ -116,42 +109,38 @@ private static void configureClaimClustersHook(Gradle gradle, TestClustersRegist
     }
 
     private static void configureStartClustersHook(Gradle gradle, TestClustersRegistry registry) {
-        gradle.addListener(
-            new TaskActionListener() {
-                @Override
-                public void beforeActions(Task task) {
-                    if (task instanceof TestClustersAware == false) {
-                        return;
-                    }
-                    // we only start the cluster before the actions, so we'll not start it if the task is up-to-date
-                    TestClustersAware awareTask = (TestClustersAware) task;
-                    awareTask.beforeStart();
-                    awareTask.getClusters().forEach(registry::maybeStartCluster);
+        gradle.addListener(new TaskActionListener() {
+            @Override
+            public void beforeActions(Task task) {
+                if (task instanceof TestClustersAware == false) {
+                    return;
                 }
-                @Override
-                public void afterActions(Task task) {}
+                // we only start the cluster before the actions, so we'll not start it if the task is up-to-date
+                TestClustersAware awareTask = (TestClustersAware) task;
+                awareTask.beforeStart();
+                awareTask.getClusters().forEach(registry::maybeStartCluster);
             }
-        );
+
+            @Override
+            public void afterActions(Task task) {}
+        });
     }
 
     private static void configureStopClustersHook(Gradle gradle, TestClustersRegistry registry) {
-        gradle.addListener(
-            new TaskExecutionListener() {
-                @Override
-                public void afterExecute(Task task, TaskState state) {
-                    if (task instanceof TestClustersAware == false) {
-                        return;
-                    }
-                    // always unclaim the cluster, even if _this_ task is up-to-date, as others might not have been
-                    // and caused the cluster to start.
-                    ((TestClustersAware) task).getClusters()
-                        .forEach(cluster -> registry.stopCluster(cluster, state.getFailure() != null));
+        gradle.addListener(new TaskExecutionListener() {
+            @Override
+            public void afterExecute(Task task, TaskState state) {
+                if (task instanceof TestClustersAware == false) {
+                    return;
                 }
-                @Override
-                public void beforeExecute(Task task) {}
+                // always unclaim the cluster, even if _this_ task is up-to-date, as others might not have been
+                // and caused the cluster to start.
+                ((TestClustersAware) task).getClusters().forEach(cluster -> registry.stopCluster(cluster, state.getFailure() != null));
             }
-        );
-    }
 
+            @Override
+            public void beforeExecute(Task task) {}
+        });
+    }
 
 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersRegistry.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersRegistry.java
index fe1c75cdd44be..d78aecc82185a 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersRegistry.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testclusters/TestClustersRegistry.java
@@ -9,7 +9,7 @@
 import java.util.Set;
 
 public class TestClustersRegistry {
-    private static final Logger logger =  Logging.getLogger(TestClustersRegistry.class);
+    private static final Logger logger = Logging.getLogger(TestClustersRegistry.class);
     private static final String TESTCLUSTERS_INSPECT_FAILURE = "testclusters.inspect.failure";
     private final Boolean allowClusterToSurvive = Boolean.valueOf(System.getProperty(TESTCLUSTERS_INSPECT_FAILURE, "false"));
     private final Map<ElasticsearchCluster, Integer> claimsInventory = new HashMap<>();
@@ -35,10 +35,10 @@ public void stopCluster(ElasticsearchCluster cluster, boolean taskFailed) {
             if (allowClusterToSurvive) {
                 logger.info("Not stopping clusters, disabled by property");
                 // task failed or this is the last one to stop
-                for (int i = 1; ; i += i) {
+                for (int i = 1;; i += i) {
                     logger.lifecycle(
-                        "No more test clusters left to run, going to sleep because {} was set," +
-                            " interrupt (^C) to stop clusters.", TESTCLUSTERS_INSPECT_FAILURE
+                        "No more test clusters left to run, going to sleep because {} was set," + " interrupt (^C) to stop clusters.",
+                        TESTCLUSTERS_INSPECT_FAILURE
                     );
                     try {
                         Thread.sleep(1000 * i);
@@ -52,7 +52,7 @@ public void stopCluster(ElasticsearchCluster cluster, boolean taskFailed) {
                 runningClusters.remove(cluster);
             }
         } else {
-            int currentClaims  = claimsInventory.getOrDefault(cluster, 0) - 1;
+            int currentClaims = claimsInventory.getOrDefault(cluster, 0) - 1;
             claimsInventory.put(cluster, currentClaims);
 
             if (currentClaims <= 0 && runningClusters.contains(cluster)) {
@@ -62,5 +62,4 @@ public void stopCluster(ElasticsearchCluster cluster, boolean taskFailed) {
         }
     }
 
-
 }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testfixtures/TestFixtureExtension.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testfixtures/TestFixtureExtension.java
index 1521b7971333b..8d34ce5a89844 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testfixtures/TestFixtureExtension.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testfixtures/TestFixtureExtension.java
@@ -23,6 +23,7 @@
 import org.gradle.api.Project;
 
 import java.util.HashMap;
+import java.util.Locale;
 import java.util.Map;
 import java.util.Optional;
 
@@ -54,9 +55,16 @@ public void useFixture(String path, String serviceName) {
         Optional<String> otherProject = this.findOtherProjectUsingService(key);
         if (otherProject.isPresent()) {
             throw new GradleException(
-                "Projects " + otherProject.get() + " and " + this.project.getPath() + " both claim the "+ serviceName +
-                    " service defined in the docker-compose.yml of " + path + "This is not supported because it breaks " +
-                    "running in parallel. Configure dedicated services for each project and use those instead."
+                String.format(
+                    Locale.ROOT,
+                    "Projects %s and %s both claim the %s service defined in the docker-compose.yml of "
+                        + "%sThis is not supported because it breaks running in parallel. Configure dedicated "
+                        + "services for each project and use those instead.",
+                    otherProject.get(),
+                    this.project.getPath(),
+                    serviceName,
+                    path
+                )
             );
         }
     }
@@ -66,7 +74,9 @@ private String getServiceNameKey(String fixtureProjectPath, String serviceName)
     }
 
     private Optional<String> findOtherProjectUsingService(String serviceName) {
-        return this.project.getRootProject().getAllprojects().stream()
+        return this.project.getRootProject()
+            .getAllprojects()
+            .stream()
             .filter(p -> p.equals(this.project) == false)
             .filter(p -> p.getExtensions().findByType(TestFixtureExtension.class) != null)
             .map(project -> project.getExtensions().getByType(TestFixtureExtension.class))
@@ -90,9 +100,16 @@ private void addFixtureProject(String path) {
         // Check for exclusive access
         Optional<String> otherProject = this.findOtherProjectUsingService(path);
         if (otherProject.isPresent()) {
-            throw new GradleException("Projects " + otherProject.get() + " and " + this.project.getPath() + " both " +
-                "claim all services from " + path + ". This is not supported because it breaks running in parallel. " +
-                "Configure specific services in docker-compose.yml for each and add the service name to `useFixture`"
+            throw new GradleException(
+                String.format(
+                    Locale.ROOT,
+                    "Projects %s and %s both claim all services from %s. This is not supported because it"
+                        + " breaks running in parallel. Configure specific services in docker-compose.yml "
+                        + "for each and add the service name to `useFixture`",
+                    otherProject.get(),
+                    this.project.getPath(),
+                    path
+                )
             );
         }
     }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/testfixtures/TestFixturesPlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/testfixtures/TestFixturesPlugin.java
index 93c91cbee51d3..9146c1f71beea 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/testfixtures/TestFixturesPlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/testfixtures/TestFixturesPlugin.java
@@ -50,9 +50,7 @@ public class TestFixturesPlugin implements Plugin<Project> {
     public void apply(Project project) {
         TaskContainer tasks = project.getTasks();
 
-        TestFixtureExtension extension = project.getExtensions().create(
-            "testFixtures", TestFixtureExtension.class, project
-        );
+        TestFixtureExtension extension = project.getExtensions().create("testFixtures", TestFixtureExtension.class, project);
 
         ExtraPropertiesExtension ext = project.getExtensions().getByType(ExtraPropertiesExtension.class);
         File testfixturesDir = project.file("testfixtures_shared");
@@ -89,38 +87,34 @@ public void apply(Project project) {
                 composeExtension.setUseComposeFiles(Collections.singletonList(DOCKER_COMPOSE_YML));
                 composeExtension.setRemoveContainers(true);
                 composeExtension.setExecutable(
-                    project.file("/usr/local/bin/docker-compose").exists() ?
-                        "/usr/local/bin/docker-compose" : "/usr/bin/docker-compose"
+                    project.file("/usr/local/bin/docker-compose").exists() ? "/usr/local/bin/docker-compose" : "/usr/bin/docker-compose"
                 );
 
                 buildFixture.dependsOn(tasks.getByName("composeUp"));
                 pullFixture.dependsOn(tasks.getByName("composePull"));
                 tasks.getByName("composeUp").mustRunAfter(preProcessFixture);
                 tasks.getByName("composePull").mustRunAfter(preProcessFixture);
-                tasks.getByName("composeDown").doLast((task) -> {
-                    project.delete(testfixturesDir);
-                });
+                tasks.getByName("composeDown").doLast((task) -> { project.delete(testfixturesDir); });
 
                 configureServiceInfoForTask(
                     postProcessFixture,
                     project,
                     false,
-                    (name, port) -> postProcessFixture.getExtensions()
-                        .getByType(ExtraPropertiesExtension.class).set(name, port)
+                    (name, port) -> postProcessFixture.getExtensions().getByType(ExtraPropertiesExtension.class).set(name, port)
                 );
             }
         } else {
             project.afterEvaluate(spec -> {
                 if (extension.fixtures.isEmpty()) {
                     // if only one fixture is used, that's this one, but without a compose file that's not a valid configuration
-                    throw new IllegalStateException("No " + DOCKER_COMPOSE_YML + " found for " + project.getPath() +
-                        " nor does it use other fixtures.");
+                    throw new IllegalStateException(
+                        "No " + DOCKER_COMPOSE_YML + " found for " + project.getPath() + " nor does it use other fixtures."
+                    );
                 }
             });
         }
 
-        extension.fixtures
-            .matching(fixtureProject -> fixtureProject.equals(project) == false)
+        extension.fixtures.matching(fixtureProject -> fixtureProject.equals(project) == false)
             .all(fixtureProject -> project.evaluationDependsOn(fixtureProject.getPath()));
 
         conditionTaskByType(tasks, extension, Test.class);
@@ -129,89 +123,81 @@ public void apply(Project project) {
         conditionTaskByType(tasks, extension, ComposeUp.class);
 
         if (dockerComposeSupported() == false) {
-            project.getLogger().warn(
-                "Tests for {} require docker-compose at /usr/local/bin/docker-compose or /usr/bin/docker-compose " +
-                    "but none could be found so these will be skipped", project.getPath()
-            );
+            project.getLogger()
+                .warn(
+                    "Tests for {} require docker-compose at /usr/local/bin/docker-compose or /usr/bin/docker-compose "
+                        + "but none could be found so these will be skipped",
+                    project.getPath()
+                );
             return;
         }
 
-        tasks.withType(Test.class, task ->
-            extension.fixtures.all(fixtureProject -> {
-                fixtureProject.getTasks().matching(it -> it.getName().equals("buildFixture")).all(task::dependsOn);
-                fixtureProject.getTasks().matching(it -> it.getName().equals("composeDown")).all(task::finalizedBy);
-                configureServiceInfoForTask(
-                    task,
-                    fixtureProject,
-                    true,
-                    (name, host) ->
-                        task.getExtensions().getByType(SystemPropertyCommandLineArgumentProvider.class).systemProperty(name, host)
-                );
-                task.dependsOn(fixtureProject.getTasks().getByName("postProcessFixture"));
-            })
-        );
+        tasks.withType(Test.class, task -> extension.fixtures.all(fixtureProject -> {
+            fixtureProject.getTasks().matching(it -> it.getName().equals("buildFixture")).all(task::dependsOn);
+            fixtureProject.getTasks().matching(it -> it.getName().equals("composeDown")).all(task::finalizedBy);
+            configureServiceInfoForTask(
+                task,
+                fixtureProject,
+                true,
+                (name, host) -> task.getExtensions().getByType(SystemPropertyCommandLineArgumentProvider.class).systemProperty(name, host)
+            );
+            task.dependsOn(fixtureProject.getTasks().getByName("postProcessFixture"));
+        }));
 
     }
 
     private void conditionTaskByType(TaskContainer tasks, TestFixtureExtension extension, Class<? extends DefaultTask> taskClass) {
         tasks.withType(
             taskClass,
-            task -> task.onlyIf(spec ->
-                extension.fixtures.stream()
-                    .anyMatch(fixtureProject ->
-                        fixtureProject.getTasks().getByName("buildFixture").getEnabled() == false
-                    ) == false
+            task -> task.onlyIf(
+                spec -> extension.fixtures.stream()
+                    .anyMatch(fixtureProject -> fixtureProject.getTasks().getByName("buildFixture").getEnabled() == false) == false
             )
         );
     }
 
     private void configureServiceInfoForTask(
-        Task task, Project fixtureProject, boolean enableFilter, BiConsumer<String, Integer> consumer
+        Task task,
+        Project fixtureProject,
+        boolean enableFilter,
+        BiConsumer<String, Integer> consumer
     ) {
         // Configure ports for the tests as system properties.
         // We only know these at execution time so we need to do it in doFirst
         TestFixtureExtension extension = task.getProject().getExtensions().getByType(TestFixtureExtension.class);
         task.doFirst(new Action<Task>() {
-                         @Override
-                         public void execute(Task theTask) {
-                             fixtureProject.getExtensions().getByType(ComposeExtension.class).getServicesInfos()
-                                 .entrySet().stream()
-                                 .filter(entry -> enableFilter == false ||
-                                     extension.isServiceRequired(entry.getKey(), fixtureProject.getPath())
-                                 )
-                                 .forEach(entry -> {
-                                     String service = entry.getKey();
-                                     ServiceInfo infos = entry.getValue();
-                                     infos.getTcpPorts()
-                                         .forEach((container, host) -> {
-                                             String name = "test.fixtures." + service + ".tcp." + container;
-                                             theTask.getLogger().info("port mapping property: {}={}", name, host);
-                                             consumer.accept(
-                                                 name,
-                                                 host
-                                             );
-                                         });
-                                     infos.getUdpPorts()
-                                         .forEach((container, host) -> {
-                                             String name = "test.fixtures." + service + ".udp." + container;
-                                             theTask.getLogger().info("port mapping property: {}={}", name, host);
-                                             consumer.accept(
-                                                 name,
-                                                 host
-                                             );
-                                         });
-                                 });
-                         }
-                     }
-        );
+            @Override
+            public void execute(Task theTask) {
+                fixtureProject.getExtensions()
+                    .getByType(ComposeExtension.class)
+                    .getServicesInfos()
+                    .entrySet()
+                    .stream()
+                    .filter(entry -> enableFilter == false || extension.isServiceRequired(entry.getKey(), fixtureProject.getPath()))
+                    .forEach(entry -> {
+                        String service = entry.getKey();
+                        ServiceInfo infos = entry.getValue();
+                        infos.getTcpPorts().forEach((container, host) -> {
+                            String name = "test.fixtures." + service + ".tcp." + container;
+                            theTask.getLogger().info("port mapping property: {}={}", name, host);
+                            consumer.accept(name, host);
+                        });
+                        infos.getUdpPorts().forEach((container, host) -> {
+                            String name = "test.fixtures." + service + ".udp." + container;
+                            theTask.getLogger().info("port mapping property: {}={}", name, host);
+                            consumer.accept(name, host);
+                        });
+                    });
+            }
+        });
     }
 
     public static boolean dockerComposeSupported() {
         if (OS.current().equals(OS.WINDOWS)) {
             return false;
         }
-        final boolean hasDockerCompose = (new File("/usr/local/bin/docker-compose")).exists() ||
-            (new File("/usr/bin/docker-compose").exists());
+        final boolean hasDockerCompose = (new File("/usr/local/bin/docker-compose")).exists()
+            || (new File("/usr/bin/docker-compose").exists());
         return hasDockerCompose && Boolean.parseBoolean(System.getProperty("tests.fixture.enabled", "true"));
     }
 
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/tool/Boilerplate.java b/buildSrc/src/main/java/org/elasticsearch/gradle/tool/Boilerplate.java
index f4ce626f7d600..3652944e1647e 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/tool/Boilerplate.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/tool/Boilerplate.java
@@ -38,28 +38,25 @@ public static SourceSetContainer getJavaSourceSets(Project project) {
     }
 
     public static <T> T maybeCreate(NamedDomainObjectContainer<T> collection, String name) {
-        return Optional.ofNullable(collection.findByName(name))
-            .orElse(collection.create(name));
+        return Optional.ofNullable(collection.findByName(name)).orElse(collection.create(name));
 
     }
 
     public static <T> T maybeCreate(NamedDomainObjectContainer<T> collection, String name, Action<T> action) {
-        return Optional.ofNullable(collection.findByName(name))
-            .orElseGet(() -> {
-                T result = collection.create(name);
-                action.execute(result);
-                return result;
-            });
+        return Optional.ofNullable(collection.findByName(name)).orElseGet(() -> {
+            T result = collection.create(name);
+            action.execute(result);
+            return result;
+        });
 
     }
 
     public static <T> T maybeCreate(PolymorphicDomainObjectContainer<T> collection, String name, Class<T> type, Action<T> action) {
-        return Optional.ofNullable(collection.findByName(name))
-            .orElseGet(() -> {
-                T result = collection.create(name, type);
-                action.execute(result);
-                return result;
-            });
+        return Optional.ofNullable(collection.findByName(name)).orElseGet(() -> {
+            T result = collection.create(name, type);
+            action.execute(result);
+            return result;
+        });
 
     }
 
@@ -83,7 +80,8 @@ public static void maybeConfigure(TaskContainer tasks, String name, Action<? sup
     }
 
     public static <T extends Task> void maybeConfigure(
-        TaskContainer tasks, String name,
+        TaskContainer tasks,
+        String name,
         Class<? extends T> type,
         Action<? super T> config
     ) {
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/tool/ClasspathUtils.java b/buildSrc/src/main/java/org/elasticsearch/gradle/tool/ClasspathUtils.java
index ed064b4ff046b..45c3b55f61066 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/tool/ClasspathUtils.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/tool/ClasspathUtils.java
@@ -5,8 +5,7 @@
 
 public class ClasspathUtils {
 
-    private ClasspathUtils() {
-    }
+    private ClasspathUtils() {}
 
     /**
      * Determine if we are running in the context of the `elastic/elasticsearch` project. This method will return {@code false} when
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/tool/DockerUtils.java b/buildSrc/src/main/java/org/elasticsearch/gradle/tool/DockerUtils.java
index 2442ffce427c8..657087afcb848 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/tool/DockerUtils.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/tool/DockerUtils.java
@@ -31,10 +31,7 @@ public class DockerUtils {
      */
     public static Optional<String> getDockerPath() {
         // Check if the Docker binary exists
-        return List.of(DOCKER_BINARIES)
-            .stream()
-            .filter(path -> new File(path).exists())
-            .findFirst();
+        return List.of(DOCKER_BINARIES).stream().filter(path -> new File(path).exists()).findFirst();
     }
 
     /**
@@ -144,7 +141,8 @@ public static void assertDockerIsAvailable(Project project, List<String> tasks)
                 "Docker (checked [%s]) is required to run the following task%s: \n%s",
                 String.join(", ", DOCKER_BINARIES),
                 tasks.size() > 1 ? "s" : "",
-                String.join("\n", tasks));
+                String.join("\n", tasks)
+            );
             throwDockerRequiredException(message);
         }
 
@@ -153,7 +151,8 @@ public static void assertDockerIsAvailable(Project project, List<String> tasks)
                 Locale.ROOT,
                 "Docker is required to run the following task%s, but it doesn't appear to be running: \n%s",
                 tasks.size() > 1 ? "s" : "",
-                String.join("\n", tasks));
+                String.join("\n", tasks)
+            );
             throwDockerRequiredException(message);
         }
 
@@ -161,20 +160,22 @@ public static void assertDockerIsAvailable(Project project, List<String> tasks)
             final String message = String.format(
                 Locale.ROOT,
                 "building Docker images requires Docker version 17.05+ due to use of multi-stage builds yet was [%s]",
-                availability.version);
+                availability.version
+            );
             throwDockerRequiredException(message);
         }
 
         // Some other problem, print the error
         final String message = String.format(
             Locale.ROOT,
-            "a problem occurred running Docker from [%s] yet it is required to run the following task%s: \n%s\n" +
-                "the problem is that Docker exited with exit code [%d] with standard error output [%s]",
+            "a problem occurred running Docker from [%s] yet it is required to run the following task%s: \n%s\n"
+                + "the problem is that Docker exited with exit code [%d] with standard error output [%s]",
             availability.path,
             tasks.size() > 1 ? "s" : "",
             String.join("\n", tasks),
             availability.lastCommand.exitCode,
-            availability.lastCommand.stderr.trim());
+            availability.lastCommand.stderr.trim()
+        );
         throwDockerRequiredException(message);
     }
 
@@ -184,9 +185,12 @@ private static void throwDockerRequiredException(final String message) {
 
     private static void throwDockerRequiredException(final String message, Exception e) {
         throw new GradleException(
-            message + "\nyou can address this by attending to the reported issue, "
+            message
+                + "\nyou can address this by attending to the reported issue, "
                 + "removing the offending tasks from being executed, "
-                + "or by passing -Dbuild.docker=false", e);
+                + "or by passing -Dbuild.docker=false",
+            e
+        );
     }
 
     /**
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/BatsProgressLogger.java b/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/BatsProgressLogger.java
index 8db4e704fb469..3ace00ef4a920 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/BatsProgressLogger.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/BatsProgressLogger.java
@@ -41,8 +41,9 @@
  */
 public class BatsProgressLogger implements UnaryOperator<String> {
 
-    private static final Pattern lineRegex =
-        Pattern.compile("(?<status>ok|not ok) \\d+(?<skip> # skip (?<skipReason>\\(.+\\))?)? \\[(?<suite>.+)\\] (?<test>.+)");
+    private static final Pattern lineRegex = Pattern.compile(
+        "(?<status>ok|not ok) \\d+(?<skip> # skip (?<skipReason>\\(.+\\))?)? \\[(?<suite>.+)\\] (?<test>.+)"
+    );
     private static final Pattern startRegex = Pattern.compile("1..(\\d+)");
 
     private final Logger logger;
@@ -67,7 +68,7 @@ public String apply(String line) {
             testCount = Integer.parseInt(m.group(1));
             int length = String.valueOf(testCount).length();
             String count = "%0" + length + "d";
-            countsFormat = "[" + count +"|" + count + "|" + count + "/" + count + "]";
+            countsFormat = "[" + count + "|" + count + "|" + count + "/" + count + "]";
             return null;
         }
         Matcher m = lineRegex.matcher(line);
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/VagrantBasePlugin.java b/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/VagrantBasePlugin.java
index f77fe982f74a3..341efedd8e851 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/VagrantBasePlugin.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/VagrantBasePlugin.java
@@ -31,6 +31,7 @@
 import java.io.ByteArrayOutputStream;
 import java.nio.charset.StandardCharsets;
 import java.util.List;
+import java.util.Locale;
 import java.util.function.Consumer;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
@@ -49,14 +50,17 @@ public void apply(Project project) {
         VagrantExtension extension = project.getExtensions().create("vagrant", VagrantExtension.class, project);
         VagrantMachine service = project.getExtensions().create("vagrantService", VagrantMachine.class, project, extension, reaper);
 
-        project.getGradle().getTaskGraph().whenReady(graph ->
-            service.refs = graph.getAllTasks().stream()
-                .filter(t -> t instanceof VagrantShellTask)
-                .filter(t -> t.getProject() == project)
-                .count());
+        project.getGradle()
+            .getTaskGraph()
+            .whenReady(
+                graph -> service.refs = graph.getAllTasks()
+                    .stream()
+                    .filter(t -> t instanceof VagrantShellTask)
+                    .filter(t -> t.getProject() == project)
+                    .count()
+            );
     }
 
-
     /**
      * Check vagrant and virtualbox versions, if any vagrant test tasks will be run.
      */
@@ -89,8 +93,9 @@ void checkVersion(Project project, String tool, Pattern versionRegex, int... min
             String output = pipe.toString(StandardCharsets.UTF_8).trim();
             Matcher matcher = versionRegex.matcher(output);
             if (matcher.find() == false) {
-                throw new IllegalStateException(tool +
-                    " version output [" + output + "] did not match regex [" + versionRegex.pattern() + "]");
+                throw new IllegalStateException(
+                    tool + " version output [" + output + "] did not match regex [" + versionRegex.pattern() + "]"
+                );
             }
 
             String version = matcher.group(1);
@@ -100,8 +105,15 @@ void checkVersion(Project project, String tool, Pattern versionRegex, int... min
                 if (found > minVersion[i]) {
                     break; // most significant version is good
                 } else if (found < minVersion[i]) {
-                    throw new IllegalStateException("Unsupported version of " + tool + ". Found [" + version + "], expected [" +
-                        Stream.of(minVersion).map(String::valueOf).collect(Collectors.joining(".")) + "+");
+                    final String exceptionMessage = String.format(
+                        Locale.ROOT,
+                        "Unsupported version of %s. Found [%s], expected [%s+]",
+                        tool,
+                        version,
+                        Stream.of(minVersion).map(String::valueOf).collect(Collectors.joining("."))
+                    );
+
+                    throw new IllegalStateException(exceptionMessage);
                 } // else equal, so check next element
             }
         }
diff --git a/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/VagrantShellTask.java b/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/VagrantShellTask.java
index 89d95de5d4415..7576defe78308 100644
--- a/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/VagrantShellTask.java
+++ b/buildSrc/src/main/java/org/elasticsearch/gradle/vagrant/VagrantShellTask.java
@@ -78,13 +78,16 @@ public void runScript() {
                 script.add("cd " + convertWindowsPath(getProject(), rootDir));
                 extension.getVmEnv().forEach((k, v) -> script.add("$Env:" + k + " = \"" + v + "\""));
                 script.addAll(getWindowsScript().stream().map(s -> "    " + s).collect(Collectors.toList()));
-                script.addAll(Arrays.asList(
-                    "    exit $LASTEXITCODE",
-                    "} catch {",
-                    // catch if we have a failure to even run the script at all above, equivalent to set -e, sort of
-                    "    echo $_.Exception.Message",
-                    "    exit 1",
-                    "}"));
+                script.addAll(
+                    Arrays.asList(
+                        "    exit $LASTEXITCODE",
+                        "} catch {",
+                        // catch if we have a failure to even run the script at all above, equivalent to set -e, sort of
+                        "    echo $_.Exception.Message",
+                        "    exit 1",
+                        "}"
+                    )
+                );
                 spec.setArgs("--elevated", "--command", String.join("\n", script));
                 spec.setProgressHandler(progressHandler);
             });
@@ -118,5 +121,4 @@ public void runScript() {
         }
     }
 
-
 }
diff --git a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/JdkJarHellCheck.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/JdkJarHellCheck.java
index 7a2504efdd0fc..2fda233f1db2f 100644
--- a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/JdkJarHellCheck.java
+++ b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/JdkJarHellCheck.java
@@ -45,11 +45,7 @@ public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
                 String entry = root.relativize(file).toString().replace('\\', '/');
                 if (entry.endsWith(".class") && entry.endsWith("module-info.class") == false) {
                     if (ext.getResource(entry) != null) {
-                        detected.add(
-                            entry
-                                .replace("/", ".")
-                                .replace(".class","")
-                        );
+                        detected.add(entry.replace("/", ".").replace(".class", ""));
                     }
                 }
                 return FileVisitResult.CONTINUE;
diff --git a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/LazyFileOutputStream.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/LazyFileOutputStream.java
index d3101868e84b6..e0da9afc8ab12 100644
--- a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/LazyFileOutputStream.java
+++ b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/LazyFileOutputStream.java
@@ -37,11 +37,13 @@ private void bootstrap() throws IOException {
                 file.getParentFile().mkdirs();
                 delegate = new FileOutputStream(file);
             }
+
             @Override
             public void write(int b) throws IOException {
                 bootstrap();
                 delegate.write(b);
             }
+
             @Override
             public void write(byte b[], int off, int len) throws IOException {
                 bootstrap();
diff --git a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/LoggedExec.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/LoggedExec.java
index aff3faf10e0cf..233d3eab7c0fb 100644
--- a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/LoggedExec.java
+++ b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/LoggedExec.java
@@ -103,9 +103,9 @@ public static ExecResult javaexec(Project project, Action<JavaExecSpec> action)
 
     private static final Pattern NEWLINE = Pattern.compile(System.lineSeparator());
 
-    private static <T extends BaseExecSpec>  ExecResult genericExec(
+    private static <T extends BaseExecSpec> ExecResult genericExec(
         Project project,
-        Function<Action<T>,ExecResult> function,
+        Function<Action<T>, ExecResult> function,
         Action<T> action
     ) {
         if (project.getLogger().isInfoEnabled()) {
diff --git a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/Version.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/Version.java
index d31e15b842b2c..80dd4c622b598 100644
--- a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/Version.java
+++ b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/Version.java
@@ -29,11 +29,9 @@ public enum Mode {
         RELAXED
     }
 
-    private static final Pattern pattern =
-            Pattern.compile("(\\d)+\\.(\\d+)\\.(\\d+)(-alpha\\d+|-beta\\d+|-rc\\d+)?(-SNAPSHOT)?");
+    private static final Pattern pattern = Pattern.compile("(\\d)+\\.(\\d+)\\.(\\d+)(-alpha\\d+|-beta\\d+|-rc\\d+)?(-SNAPSHOT)?");
 
-    private static final Pattern relaxedPattern =
-        Pattern.compile("(\\d)+\\.(\\d+)\\.(\\d+)(-[a-zA-Z0-9_]+)*?");
+    private static final Pattern relaxedPattern = Pattern.compile("(\\d)+\\.(\\d+)\\.(\\d+)(-[a-zA-Z0-9_]+)*?");
 
     public Version(int major, int minor, int revision) {
         Objects.requireNonNull(major, "major version can't be null");
@@ -65,16 +63,10 @@ public static Version fromString(final String s, final Mode mode) {
             String expected = mode == Mode.STRICT == true
                 ? "major.minor.revision[-(alpha|beta|rc)Number][-SNAPSHOT]"
                 : "major.minor.revision[-extra]";
-            throw new IllegalArgumentException(
-                "Invalid version format: '" + s + "'. Should be " + expected
-            );
+            throw new IllegalArgumentException("Invalid version format: '" + s + "'. Should be " + expected);
         }
 
-        return new Version(
-                Integer.parseInt(matcher.group(1)),
-                parseSuffixNumber(matcher.group(2)),
-                parseSuffixNumber(matcher.group(3))
-        );
+        return new Version(Integer.parseInt(matcher.group(1)), parseSuffixNumber(matcher.group(2)), parseSuffixNumber(matcher.group(3)));
     }
 
     @Override
@@ -116,12 +108,14 @@ public boolean after(String compareTo) {
 
     @Override
     public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
         Version version = (Version) o;
-        return major == version.major &&
-                minor == version.minor &&
-                revision == version.revision;
+        return major == version.major && minor == version.minor && revision == version.revision;
     }
 
     @Override
diff --git a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/VersionProperties.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/VersionProperties.java
index e4b75c94aa5f2..4509695fb829b 100644
--- a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/VersionProperties.java
+++ b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/VersionProperties.java
@@ -15,7 +15,7 @@ public static String getElasticsearch() {
         return elasticsearch;
     }
 
-    public static Version getElasticsearchVersion()  {
+    public static Version getElasticsearchVersion() {
         return Version.fromString(elasticsearch);
     }
 
diff --git a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
index 19748de1b96f1..0c00d99c120d3 100644
--- a/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
+++ b/buildSrc/src/minimumRuntime/java/org/elasticsearch/gradle/info/BuildParams.java
@@ -124,8 +124,8 @@ private static <T> T value(T object) {
 
             String message = "Build parameter '" + propertyName(callingMethod) + "' has not been initialized. ";
             if (executionTime) {
-                message += "This property is initialized at execution time, " +
-                    "please ensure you are not attempting to access it during project configuration.";
+                message += "This property is initialized at execution time, "
+                    + "please ensure you are not attempting to access it during project configuration.";
             } else {
                 message += "Perhaps the plugin responsible for initializing this property has not been applied.";
             }
@@ -144,24 +144,22 @@ private static String propertyName(String methodName) {
     public static class MutableBuildParams {
         private static MutableBuildParams INSTANCE = new MutableBuildParams();
 
-        private MutableBuildParams() { }
+        private MutableBuildParams() {}
 
         /**
          * Resets any existing values from previous initializations.
          */
         public void reset() {
-            Arrays.stream(BuildParams.class.getDeclaredFields())
-                .filter(f -> Modifier.isStatic(f.getModifiers()))
-                .forEach(f -> {
-                    try {
-                        // Since we are mutating private static fields from a public static inner class we need to suppress
-                        // accessibility controls here.
-                        f.setAccessible(true);
-                        f.set(null, null);
-                    } catch (IllegalAccessException e) {
-                        throw new RuntimeException(e);
-                    }
-                });
+            Arrays.stream(BuildParams.class.getDeclaredFields()).filter(f -> Modifier.isStatic(f.getModifiers())).forEach(f -> {
+                try {
+                    // Since we are mutating private static fields from a public static inner class we need to suppress
+                    // accessibility controls here.
+                    f.setAccessible(true);
+                    f.set(null, null);
+                } catch (IllegalAccessException e) {
+                    throw new RuntimeException(e);
+                }
+            });
         }
 
         public void setCompilerJavaHome(File compilerJavaHome) {
@@ -233,8 +231,9 @@ public void setDefaultParallel(int defaultParallel) {
      * Indicates that a build parameter is initialized at task execution time and is not available at project configuration time.
      * Attempts to read an uninitialized parameter wil result in an {@link IllegalStateException}.
      */
-    @Target({ElementType.METHOD, ElementType.FIELD})
+    @Target({ ElementType.METHOD, ElementType.FIELD })
     @Retention(RetentionPolicy.RUNTIME)
     @Documented
-    public @interface ExecutionTime {}
+    public @interface ExecutionTime {
+    }
 }
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginIT.java b/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginIT.java
index c1c8a8b5e52e8..c69a23021f535 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginIT.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginIT.java
@@ -42,17 +42,13 @@ public class BuildPluginIT extends GradleIntegrationTestCase {
     public TemporaryFolder tmpDir = new TemporaryFolder();
 
     public void testPluginCanBeApplied() {
-        BuildResult result = getGradleRunner("elasticsearch.build")
-            .withArguments("hello", "-s")
-            .build();
+        BuildResult result = getGradleRunner("elasticsearch.build").withArguments("hello", "-s").build();
         assertTaskSuccessful(result, ":hello");
         assertOutputContains("build plugin can be applied");
     }
 
     public void testCheckTask() {
-        BuildResult result = getGradleRunner("elasticsearch.build")
-            .withArguments("check", "assemble", "-s")
-            .build();
+        BuildResult result = getGradleRunner("elasticsearch.build").withArguments("check", "assemble", "-s").build();
         assertTaskSuccessful(result, ":check");
     }
 
@@ -64,9 +60,10 @@ public void testInsecureMavenRepository() throws IOException {
             "repositories {",
             "  maven {",
             "    name \"elastic-maven\"",
-            "    url \"" +  url + "\"\n",
+            "    url \"" + url + "\"\n",
             "  }",
-            "}");
+            "}"
+        );
         runInsecureArtifactRepositoryTest(name, url, lines);
     }
 
@@ -78,17 +75,17 @@ public void testInsecureIvyRepository() throws IOException {
             "repositories {",
             "  ivy {",
             "    name \"elastic-ivy\"",
-            "    url \"" +  url + "\"\n",
+            "    url \"" + url + "\"\n",
             "  }",
-            "}");
+            "}"
+        );
         runInsecureArtifactRepositoryTest(name, url, lines);
     }
 
     private void runInsecureArtifactRepositoryTest(final String name, final String url, final List<String> lines) throws IOException {
         final File projectDir = getProjectDir("elasticsearch.build");
         FileUtils.copyDirectory(projectDir, tmpDir.getRoot(), pathname -> pathname.getPath().contains("/build/") == false);
-        final List<String> buildGradleLines =
-            Files.readAllLines(tmpDir.getRoot().toPath().resolve("build.gradle"), StandardCharsets.UTF_8);
+        final List<String> buildGradleLines = Files.readAllLines(tmpDir.getRoot().toPath().resolve("build.gradle"), StandardCharsets.UTF_8);
         buildGradleLines.addAll(lines);
         Files.write(tmpDir.getRoot().toPath().resolve("build.gradle"), buildGradleLines, StandardCharsets.UTF_8);
         final BuildResult result = GradleRunner.create()
@@ -98,34 +95,27 @@ private void runInsecureArtifactRepositoryTest(final String name, final String u
             .buildAndFail();
         assertOutputContains(
             result.getOutput(),
-            "repository [" + name + "] on project with path [:] is not using a secure protocol for artifacts on [" + url + "]");
+            "repository [" + name + "] on project with path [:] is not using a secure protocol for artifacts on [" + url + "]"
+        );
     }
 
     public void testLicenseAndNotice() throws IOException {
-        BuildResult result = getGradleRunner("elasticsearch.build")
-            .withArguments("clean", "assemble")
-            .build();
+        BuildResult result = getGradleRunner("elasticsearch.build").withArguments("clean", "assemble").build();
 
         assertTaskSuccessful(result, ":assemble");
 
         assertBuildFileExists(result, "elasticsearch.build", "distributions/elasticsearch.build.jar");
 
-        try (ZipFile zipFile = new ZipFile(new File(
-            getBuildDir("elasticsearch.build"), "distributions/elasticsearch.build.jar"
-        ))) {
+        try (ZipFile zipFile = new ZipFile(new File(getBuildDir("elasticsearch.build"), "distributions/elasticsearch.build.jar"))) {
             ZipEntry licenseEntry = zipFile.getEntry("META-INF/LICENSE.txt");
             ZipEntry noticeEntry = zipFile.getEntry("META-INF/NOTICE.txt");
             assertNotNull("Jar does not have META-INF/LICENSE.txt", licenseEntry);
             assertNotNull("Jar does not have META-INF/NOTICE.txt", noticeEntry);
-            try (
-                InputStream license = zipFile.getInputStream(licenseEntry);
-                InputStream notice = zipFile.getInputStream(noticeEntry)
-            ) {
+            try (InputStream license = zipFile.getInputStream(licenseEntry); InputStream notice = zipFile.getInputStream(noticeEntry)) {
                 assertEquals("this is a test license file", IOUtils.toString(license, StandardCharsets.UTF_8.name()));
                 assertEquals("this is a test notice file", IOUtils.toString(notice, StandardCharsets.UTF_8.name()));
             }
         }
     }
 
-
 }
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginTests.java
index 8d6d0be00dbe8..4389af00c0304 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginTests.java
@@ -25,7 +25,6 @@
 import java.net.URI;
 import java.net.URISyntaxException;
 
-
 public class BuildPluginTests extends GradleUnitTestCase {
 
     @Test(expected = GradleException.class)
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/BwcVersionsTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/BwcVersionsTests.java
index 27e84fcf85404..dd6ee426ee78b 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/BwcVersionsTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/BwcVersionsTests.java
@@ -42,48 +42,252 @@ public class BwcVersionsTests extends GradleUnitTestCase {
 
     static {
         // unreleased major and two unreleased minors ( minor in feature freeze )
-        sampleVersions.put("8.0.0", asList(
-            "7_0_0", "7_0_1", "7_1_0", "7_1_1", "7_2_0", "7_3_0", "8.0.0"
-        ));
-        sampleVersions.put("7.0.0-alpha1", asList(
-            "6_0_0_alpha1", "6_0_0_alpha2", "6_0_0_beta1", "6_0_0_beta2", "6_0_0_rc1", "6_0_0_rc2",
-            "6_0_0", "6_0_1", "6_1_0", "6_1_1", "6_1_2", "6_1_3", "6_1_4",
-            "6_2_0", "6_2_1", "6_2_2", "6_2_3", "6_2_4",
-            "6_3_0", "6_3_1", "6_3_2",
-            "6_4_0", "6_4_1", "6_4_2",
-            "6_5_0", "7_0_0_alpha1"
-        ));
-        sampleVersions.put("6.5.0", asList(
-            "5_0_0_alpha1", "5_0_0_alpha2", "5_0_0_alpha3", "5_0_0_alpha4", "5_0_0_alpha5", "5_0_0_beta1", "5_0_0_rc1",
-            "5_0_0", "5_0_1", "5_0_2", "5_1_1", "5_1_2", "5_2_0", "5_2_1", "5_2_2", "5_3_0", "5_3_1", "5_3_2", "5_3_3",
-            "5_4_0", "5_4_1", "5_4_2", "5_4_3", "5_5_0", "5_5_1", "5_5_2", "5_5_3", "5_6_0", "5_6_1", "5_6_2", "5_6_3",
-            "5_6_4", "5_6_5", "5_6_6", "5_6_7", "5_6_8", "5_6_9", "5_6_10", "5_6_11", "5_6_12", "5_6_13",
-            "6_0_0_alpha1", "6_0_0_alpha2", "6_0_0_beta1", "6_0_0_beta2", "6_0_0_rc1", "6_0_0_rc2", "6_0_0", "6_0_1",
-            "6_1_0", "6_1_1", "6_1_2", "6_1_3", "6_1_4", "6_2_0", "6_2_1", "6_2_2", "6_2_3", "6_2_4", "6_3_0", "6_3_1",
-            "6_3_2", "6_4_0", "6_4_1", "6_4_2", "6_5_0"
-        ));
-        sampleVersions.put("6.6.0", asList(
-            "5_0_0_alpha1", "5_0_0_alpha2", "5_0_0_alpha3", "5_0_0_alpha4", "5_0_0_alpha5", "5_0_0_beta1", "5_0_0_rc1",
-            "5_0_0", "5_0_1", "5_0_2", "5_1_1", "5_1_2", "5_2_0", "5_2_1", "5_2_2", "5_3_0", "5_3_1", "5_3_2", "5_3_3",
-            "5_4_0", "5_4_1", "5_4_2", "5_4_3", "5_5_0", "5_5_1", "5_5_2", "5_5_3", "5_6_0", "5_6_1", "5_6_2", "5_6_3",
-            "5_6_4", "5_6_5", "5_6_6", "5_6_7", "5_6_8", "5_6_9", "5_6_10", "5_6_11", "5_6_12", "5_6_13",
-            "6_0_0_alpha1", "6_0_0_alpha2", "6_0_0_beta1", "6_0_0_beta2", "6_0_0_rc1", "6_0_0_rc2", "6_0_0", "6_0_1",
-            "6_1_0", "6_1_1", "6_1_2", "6_1_3", "6_1_4", "6_2_0", "6_2_1", "6_2_2", "6_2_3", "6_2_4", "6_3_0", "6_3_1",
-            "6_3_2", "6_4_0", "6_4_1", "6_4_2", "6_5_0", "6_6_0"
-        ));
-        sampleVersions.put("6.4.2", asList(
-            "5_0_0_alpha1", "5_0_0_alpha2", "5_0_0_alpha3", "5_0_0_alpha4", "5_0_0_alpha5", "5_0_0_beta1", "5_0_0_rc1",
-            "5_0_0", "5_0_1", "5_0_2", "5_1_1", "5_1_2", "5_2_0", "5_2_1", "5_2_2", "5_3_0",
-            "5_3_1", "5_3_2", "5_3_3", "5_4_0", "5_4_1", "5_4_2", "5_4_3", "5_5_0", "5_5_1", "5_5_2", "5_5_3",
-            "5_6_0", "5_6_1", "5_6_2", "5_6_3", "5_6_4", "5_6_5", "5_6_6", "5_6_7", "5_6_8", "5_6_9", "5_6_10",
-            "5_6_11", "5_6_12", "5_6_13",
-            "6_0_0_alpha1", "6_0_0_alpha2", "6_0_0_beta1", "6_0_0_beta2", "6_0_0_rc1", "6_0_0_rc2",
-            "6_0_0", "6_0_1", "6_1_0", "6_1_1", "6_1_2", "6_1_3", "6_1_4", "6_2_0", "6_2_1", "6_2_2", "6_2_3",
-            "6_2_4", "6_3_0", "6_3_1", "6_3_2", "6_4_0", "6_4_1", "6_4_2"
-        ));
-        sampleVersions.put("7.1.0", asList(
-            "7_1_0", "7_0_0", "6_7_0", "6_6_1", "6_6_0"
-        ));
+        sampleVersions.put("8.0.0", asList("7_0_0", "7_0_1", "7_1_0", "7_1_1", "7_2_0", "7_3_0", "8.0.0"));
+        sampleVersions.put(
+            "7.0.0-alpha1",
+            asList(
+                "6_0_0_alpha1",
+                "6_0_0_alpha2",
+                "6_0_0_beta1",
+                "6_0_0_beta2",
+                "6_0_0_rc1",
+                "6_0_0_rc2",
+                "6_0_0",
+                "6_0_1",
+                "6_1_0",
+                "6_1_1",
+                "6_1_2",
+                "6_1_3",
+                "6_1_4",
+                "6_2_0",
+                "6_2_1",
+                "6_2_2",
+                "6_2_3",
+                "6_2_4",
+                "6_3_0",
+                "6_3_1",
+                "6_3_2",
+                "6_4_0",
+                "6_4_1",
+                "6_4_2",
+                "6_5_0",
+                "7_0_0_alpha1"
+            )
+        );
+        sampleVersions.put(
+            "6.5.0",
+            asList(
+                "5_0_0_alpha1",
+                "5_0_0_alpha2",
+                "5_0_0_alpha3",
+                "5_0_0_alpha4",
+                "5_0_0_alpha5",
+                "5_0_0_beta1",
+                "5_0_0_rc1",
+                "5_0_0",
+                "5_0_1",
+                "5_0_2",
+                "5_1_1",
+                "5_1_2",
+                "5_2_0",
+                "5_2_1",
+                "5_2_2",
+                "5_3_0",
+                "5_3_1",
+                "5_3_2",
+                "5_3_3",
+                "5_4_0",
+                "5_4_1",
+                "5_4_2",
+                "5_4_3",
+                "5_5_0",
+                "5_5_1",
+                "5_5_2",
+                "5_5_3",
+                "5_6_0",
+                "5_6_1",
+                "5_6_2",
+                "5_6_3",
+                "5_6_4",
+                "5_6_5",
+                "5_6_6",
+                "5_6_7",
+                "5_6_8",
+                "5_6_9",
+                "5_6_10",
+                "5_6_11",
+                "5_6_12",
+                "5_6_13",
+                "6_0_0_alpha1",
+                "6_0_0_alpha2",
+                "6_0_0_beta1",
+                "6_0_0_beta2",
+                "6_0_0_rc1",
+                "6_0_0_rc2",
+                "6_0_0",
+                "6_0_1",
+                "6_1_0",
+                "6_1_1",
+                "6_1_2",
+                "6_1_3",
+                "6_1_4",
+                "6_2_0",
+                "6_2_1",
+                "6_2_2",
+                "6_2_3",
+                "6_2_4",
+                "6_3_0",
+                "6_3_1",
+                "6_3_2",
+                "6_4_0",
+                "6_4_1",
+                "6_4_2",
+                "6_5_0"
+            )
+        );
+        sampleVersions.put(
+            "6.6.0",
+            asList(
+                "5_0_0_alpha1",
+                "5_0_0_alpha2",
+                "5_0_0_alpha3",
+                "5_0_0_alpha4",
+                "5_0_0_alpha5",
+                "5_0_0_beta1",
+                "5_0_0_rc1",
+                "5_0_0",
+                "5_0_1",
+                "5_0_2",
+                "5_1_1",
+                "5_1_2",
+                "5_2_0",
+                "5_2_1",
+                "5_2_2",
+                "5_3_0",
+                "5_3_1",
+                "5_3_2",
+                "5_3_3",
+                "5_4_0",
+                "5_4_1",
+                "5_4_2",
+                "5_4_3",
+                "5_5_0",
+                "5_5_1",
+                "5_5_2",
+                "5_5_3",
+                "5_6_0",
+                "5_6_1",
+                "5_6_2",
+                "5_6_3",
+                "5_6_4",
+                "5_6_5",
+                "5_6_6",
+                "5_6_7",
+                "5_6_8",
+                "5_6_9",
+                "5_6_10",
+                "5_6_11",
+                "5_6_12",
+                "5_6_13",
+                "6_0_0_alpha1",
+                "6_0_0_alpha2",
+                "6_0_0_beta1",
+                "6_0_0_beta2",
+                "6_0_0_rc1",
+                "6_0_0_rc2",
+                "6_0_0",
+                "6_0_1",
+                "6_1_0",
+                "6_1_1",
+                "6_1_2",
+                "6_1_3",
+                "6_1_4",
+                "6_2_0",
+                "6_2_1",
+                "6_2_2",
+                "6_2_3",
+                "6_2_4",
+                "6_3_0",
+                "6_3_1",
+                "6_3_2",
+                "6_4_0",
+                "6_4_1",
+                "6_4_2",
+                "6_5_0",
+                "6_6_0"
+            )
+        );
+        sampleVersions.put(
+            "6.4.2",
+            asList(
+                "5_0_0_alpha1",
+                "5_0_0_alpha2",
+                "5_0_0_alpha3",
+                "5_0_0_alpha4",
+                "5_0_0_alpha5",
+                "5_0_0_beta1",
+                "5_0_0_rc1",
+                "5_0_0",
+                "5_0_1",
+                "5_0_2",
+                "5_1_1",
+                "5_1_2",
+                "5_2_0",
+                "5_2_1",
+                "5_2_2",
+                "5_3_0",
+                "5_3_1",
+                "5_3_2",
+                "5_3_3",
+                "5_4_0",
+                "5_4_1",
+                "5_4_2",
+                "5_4_3",
+                "5_5_0",
+                "5_5_1",
+                "5_5_2",
+                "5_5_3",
+                "5_6_0",
+                "5_6_1",
+                "5_6_2",
+                "5_6_3",
+                "5_6_4",
+                "5_6_5",
+                "5_6_6",
+                "5_6_7",
+                "5_6_8",
+                "5_6_9",
+                "5_6_10",
+                "5_6_11",
+                "5_6_12",
+                "5_6_13",
+                "6_0_0_alpha1",
+                "6_0_0_alpha2",
+                "6_0_0_beta1",
+                "6_0_0_beta2",
+                "6_0_0_rc1",
+                "6_0_0_rc2",
+                "6_0_0",
+                "6_0_1",
+                "6_1_0",
+                "6_1_1",
+                "6_1_2",
+                "6_1_3",
+                "6_1_4",
+                "6_2_0",
+                "6_2_1",
+                "6_2_2",
+                "6_2_3",
+                "6_2_4",
+                "6_3_0",
+                "6_3_1",
+                "6_3_2",
+                "6_4_0",
+                "6_4_1",
+                "6_4_2"
+            )
+        );
+        sampleVersions.put("7.1.0", asList("7_1_0", "7_0_0", "6_7_0", "6_6_1", "6_6_0"));
     }
 
     @Test(expected = IllegalArgumentException.class)
@@ -99,131 +303,347 @@ public void testExceptionOnNonCurrent() {
     @Test(expected = IllegalStateException.class)
     public void testExceptionOnTooManyMajors() {
         new BwcVersions(
-            asList(
-                formatVersionToLine("5.6.12"),
-                formatVersionToLine("6.5.0"),
-                formatVersionToLine("7.0.0")
-            ),
+            asList(formatVersionToLine("5.6.12"), formatVersionToLine("6.5.0"), formatVersionToLine("7.0.0")),
             Version.fromString("6.5.0")
         );
     }
 
     public void testWireCompatible() {
-        assertVersionsEquals(
-            asList("6.5.0", "7.0.0"),
-            getVersionCollection("7.0.0-alpha1").getWireCompatible()
-        );
+        assertVersionsEquals(asList("6.5.0", "7.0.0"), getVersionCollection("7.0.0-alpha1").getWireCompatible());
         assertVersionsEquals(
             asList(
-                "5.6.0", "5.6.1", "5.6.2", "5.6.3", "5.6.4", "5.6.5", "5.6.6", "5.6.7", "5.6.8", "5.6.9", "5.6.10",
-                "5.6.11", "5.6.12", "5.6.13",
-                "6.0.0", "6.0.1", "6.1.0", "6.1.1", "6.1.2", "6.1.3", "6.1.4",
-                "6.2.0", "6.2.1", "6.2.2", "6.2.3", "6.2.4",
-                "6.3.0", "6.3.1", "6.3.2", "6.4.0", "6.4.1", "6.4.2", "6.5.0"
+                "5.6.0",
+                "5.6.1",
+                "5.6.2",
+                "5.6.3",
+                "5.6.4",
+                "5.6.5",
+                "5.6.6",
+                "5.6.7",
+                "5.6.8",
+                "5.6.9",
+                "5.6.10",
+                "5.6.11",
+                "5.6.12",
+                "5.6.13",
+                "6.0.0",
+                "6.0.1",
+                "6.1.0",
+                "6.1.1",
+                "6.1.2",
+                "6.1.3",
+                "6.1.4",
+                "6.2.0",
+                "6.2.1",
+                "6.2.2",
+                "6.2.3",
+                "6.2.4",
+                "6.3.0",
+                "6.3.1",
+                "6.3.2",
+                "6.4.0",
+                "6.4.1",
+                "6.4.2",
+                "6.5.0"
             ),
             getVersionCollection("6.5.0").getWireCompatible()
         );
 
         assertVersionsEquals(
             asList(
-                "5.6.0", "5.6.1", "5.6.2", "5.6.3", "5.6.4", "5.6.5", "5.6.6", "5.6.7", "5.6.8", "5.6.9", "5.6.10",
-                "5.6.11", "5.6.12", "5.6.13", "6.0.0", "6.0.1", "6.1.0", "6.1.1", "6.1.2", "6.1.3", "6.1.4",
-                "6.2.0", "6.2.1", "6.2.2", "6.2.3", "6.2.4", "6.3.0", "6.3.1", "6.3.2", "6.4.0", "6.4.1", "6.4.2"
+                "5.6.0",
+                "5.6.1",
+                "5.6.2",
+                "5.6.3",
+                "5.6.4",
+                "5.6.5",
+                "5.6.6",
+                "5.6.7",
+                "5.6.8",
+                "5.6.9",
+                "5.6.10",
+                "5.6.11",
+                "5.6.12",
+                "5.6.13",
+                "6.0.0",
+                "6.0.1",
+                "6.1.0",
+                "6.1.1",
+                "6.1.2",
+                "6.1.3",
+                "6.1.4",
+                "6.2.0",
+                "6.2.1",
+                "6.2.2",
+                "6.2.3",
+                "6.2.4",
+                "6.3.0",
+                "6.3.1",
+                "6.3.2",
+                "6.4.0",
+                "6.4.1",
+                "6.4.2"
             ),
             getVersionCollection("6.4.2").getWireCompatible()
         );
 
         assertVersionsEquals(
             asList(
-                "5.6.0", "5.6.1", "5.6.2", "5.6.3", "5.6.4", "5.6.5", "5.6.6", "5.6.7", "5.6.8", "5.6.9", "5.6.10",
-                "5.6.11", "5.6.12", "5.6.13",
-                "6.0.0", "6.0.1", "6.1.0", "6.1.1", "6.1.2", "6.1.3", "6.1.4",
-                "6.2.0", "6.2.1", "6.2.2", "6.2.3", "6.2.4",
-                "6.3.0", "6.3.1", "6.3.2", "6.4.0", "6.4.1", "6.4.2", "6.5.0", "6.6.0"
+                "5.6.0",
+                "5.6.1",
+                "5.6.2",
+                "5.6.3",
+                "5.6.4",
+                "5.6.5",
+                "5.6.6",
+                "5.6.7",
+                "5.6.8",
+                "5.6.9",
+                "5.6.10",
+                "5.6.11",
+                "5.6.12",
+                "5.6.13",
+                "6.0.0",
+                "6.0.1",
+                "6.1.0",
+                "6.1.1",
+                "6.1.2",
+                "6.1.3",
+                "6.1.4",
+                "6.2.0",
+                "6.2.1",
+                "6.2.2",
+                "6.2.3",
+                "6.2.4",
+                "6.3.0",
+                "6.3.1",
+                "6.3.2",
+                "6.4.0",
+                "6.4.1",
+                "6.4.2",
+                "6.5.0",
+                "6.6.0"
             ),
             getVersionCollection("6.6.0").getWireCompatible()
         );
 
-        assertVersionsEquals(
-            asList("7.3.0", "8.0.0"),
-            getVersionCollection("8.0.0").getWireCompatible()
-        );
-        assertVersionsEquals(
-            asList("6.7.0", "7.0.0", "7.1.0"),
-            getVersionCollection("7.1.0").getWireCompatible()
-        );
+        assertVersionsEquals(asList("7.3.0", "8.0.0"), getVersionCollection("8.0.0").getWireCompatible());
+        assertVersionsEquals(asList("6.7.0", "7.0.0", "7.1.0"), getVersionCollection("7.1.0").getWireCompatible());
 
     }
 
     public void testWireCompatibleUnreleased() {
-        assertVersionsEquals(
-            asList("6.5.0", "7.0.0"),
-            getVersionCollection("7.0.0-alpha1").getUnreleasedWireCompatible()
-        );
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2", "6.5.0"),
-            getVersionCollection("6.5.0").getUnreleasedWireCompatible()
-        );
+        assertVersionsEquals(asList("6.5.0", "7.0.0"), getVersionCollection("7.0.0-alpha1").getUnreleasedWireCompatible());
+        assertVersionsEquals(asList("5.6.13", "6.4.2", "6.5.0"), getVersionCollection("6.5.0").getUnreleasedWireCompatible());
 
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2"),
-            getVersionCollection("6.4.2").getUnreleasedWireCompatible()
-        );
+        assertVersionsEquals(asList("5.6.13", "6.4.2"), getVersionCollection("6.4.2").getUnreleasedWireCompatible());
 
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2", "6.5.0", "6.6.0"),
-            getVersionCollection("6.6.0").getUnreleasedWireCompatible()
-        );
+        assertVersionsEquals(asList("5.6.13", "6.4.2", "6.5.0", "6.6.0"), getVersionCollection("6.6.0").getUnreleasedWireCompatible());
 
-        assertVersionsEquals(
-            asList("7.3.0", "8.0.0"),
-            getVersionCollection("8.0.0").getUnreleasedWireCompatible()
-        );
-        assertVersionsEquals(
-            asList("6.7.0", "7.0.0", "7.1.0"),
-            getVersionCollection("7.1.0").getWireCompatible()
-        );
+        assertVersionsEquals(asList("7.3.0", "8.0.0"), getVersionCollection("8.0.0").getUnreleasedWireCompatible());
+        assertVersionsEquals(asList("6.7.0", "7.0.0", "7.1.0"), getVersionCollection("7.1.0").getWireCompatible());
     }
 
     public void testIndexCompatible() {
         assertVersionsEquals(
             asList(
-                "6.0.0", "6.0.1", "6.1.0", "6.1.1", "6.1.2", "6.1.3", "6.1.4",
-                "6.2.0", "6.2.1", "6.2.2", "6.2.3", "6.2.4", "6.3.0", "6.3.1",
-                "6.3.2", "6.4.0", "6.4.1", "6.4.2", "6.5.0", "7.0.0"
+                "6.0.0",
+                "6.0.1",
+                "6.1.0",
+                "6.1.1",
+                "6.1.2",
+                "6.1.3",
+                "6.1.4",
+                "6.2.0",
+                "6.2.1",
+                "6.2.2",
+                "6.2.3",
+                "6.2.4",
+                "6.3.0",
+                "6.3.1",
+                "6.3.2",
+                "6.4.0",
+                "6.4.1",
+                "6.4.2",
+                "6.5.0",
+                "7.0.0"
             ),
             getVersionCollection("7.0.0-alpha1").getIndexCompatible()
         );
 
         assertVersionsEquals(
             asList(
-                "5.0.0", "5.0.1", "5.0.2", "5.1.1", "5.1.2", "5.2.0", "5.2.1", "5.2.2", "5.3.0", "5.3.1", "5.3.2", "5.3.3",
-                "5.4.0", "5.4.1", "5.4.2", "5.4.3", "5.5.0", "5.5.1", "5.5.2", "5.5.3", "5.6.0", "5.6.1", "5.6.2", "5.6.3",
-                "5.6.4", "5.6.5", "5.6.6", "5.6.7", "5.6.8", "5.6.9", "5.6.10", "5.6.11", "5.6.12", "5.6.13",
-                "6.0.0", "6.0.1", "6.1.0", "6.1.1", "6.1.2", "6.1.3", "6.1.4", "6.2.0", "6.2.1", "6.2.2", "6.2.3", "6.2.4",
-                "6.3.0", "6.3.1", "6.3.2", "6.4.0", "6.4.1", "6.4.2", "6.5.0"
+                "5.0.0",
+                "5.0.1",
+                "5.0.2",
+                "5.1.1",
+                "5.1.2",
+                "5.2.0",
+                "5.2.1",
+                "5.2.2",
+                "5.3.0",
+                "5.3.1",
+                "5.3.2",
+                "5.3.3",
+                "5.4.0",
+                "5.4.1",
+                "5.4.2",
+                "5.4.3",
+                "5.5.0",
+                "5.5.1",
+                "5.5.2",
+                "5.5.3",
+                "5.6.0",
+                "5.6.1",
+                "5.6.2",
+                "5.6.3",
+                "5.6.4",
+                "5.6.5",
+                "5.6.6",
+                "5.6.7",
+                "5.6.8",
+                "5.6.9",
+                "5.6.10",
+                "5.6.11",
+                "5.6.12",
+                "5.6.13",
+                "6.0.0",
+                "6.0.1",
+                "6.1.0",
+                "6.1.1",
+                "6.1.2",
+                "6.1.3",
+                "6.1.4",
+                "6.2.0",
+                "6.2.1",
+                "6.2.2",
+                "6.2.3",
+                "6.2.4",
+                "6.3.0",
+                "6.3.1",
+                "6.3.2",
+                "6.4.0",
+                "6.4.1",
+                "6.4.2",
+                "6.5.0"
             ),
             getVersionCollection("6.5.0").getIndexCompatible()
         );
 
         assertVersionsEquals(
             asList(
-                "5.0.0", "5.0.1", "5.0.2", "5.1.1", "5.1.2", "5.2.0", "5.2.1", "5.2.2", "5.3.0", "5.3.1", "5.3.2", "5.3.3",
-                "5.4.0", "5.4.1", "5.4.2", "5.4.3", "5.5.0", "5.5.1", "5.5.2", "5.5.3", "5.6.0", "5.6.1", "5.6.2", "5.6.3",
-                "5.6.4", "5.6.5", "5.6.6", "5.6.7", "5.6.8", "5.6.9", "5.6.10", "5.6.11", "5.6.12", "5.6.13",
-                "6.0.0", "6.0.1", "6.1.0", "6.1.1", "6.1.2", "6.1.3", "6.1.4", "6.2.0", "6.2.1", "6.2.2", "6.2.3", "6.2.4",
-                "6.3.0", "6.3.1", "6.3.2", "6.4.0", "6.4.1", "6.4.2"
+                "5.0.0",
+                "5.0.1",
+                "5.0.2",
+                "5.1.1",
+                "5.1.2",
+                "5.2.0",
+                "5.2.1",
+                "5.2.2",
+                "5.3.0",
+                "5.3.1",
+                "5.3.2",
+                "5.3.3",
+                "5.4.0",
+                "5.4.1",
+                "5.4.2",
+                "5.4.3",
+                "5.5.0",
+                "5.5.1",
+                "5.5.2",
+                "5.5.3",
+                "5.6.0",
+                "5.6.1",
+                "5.6.2",
+                "5.6.3",
+                "5.6.4",
+                "5.6.5",
+                "5.6.6",
+                "5.6.7",
+                "5.6.8",
+                "5.6.9",
+                "5.6.10",
+                "5.6.11",
+                "5.6.12",
+                "5.6.13",
+                "6.0.0",
+                "6.0.1",
+                "6.1.0",
+                "6.1.1",
+                "6.1.2",
+                "6.1.3",
+                "6.1.4",
+                "6.2.0",
+                "6.2.1",
+                "6.2.2",
+                "6.2.3",
+                "6.2.4",
+                "6.3.0",
+                "6.3.1",
+                "6.3.2",
+                "6.4.0",
+                "6.4.1",
+                "6.4.2"
             ),
             getVersionCollection("6.4.2").getIndexCompatible()
         );
 
         assertVersionsEquals(
             asList(
-                "5.0.0", "5.0.1", "5.0.2", "5.1.1", "5.1.2", "5.2.0", "5.2.1", "5.2.2", "5.3.0", "5.3.1", "5.3.2", "5.3.3",
-                "5.4.0", "5.4.1", "5.4.2", "5.4.3", "5.5.0", "5.5.1", "5.5.2", "5.5.3", "5.6.0", "5.6.1", "5.6.2", "5.6.3",
-                "5.6.4", "5.6.5", "5.6.6", "5.6.7", "5.6.8", "5.6.9", "5.6.10", "5.6.11", "5.6.12", "5.6.13",
-                "6.0.0", "6.0.1", "6.1.0", "6.1.1", "6.1.2", "6.1.3", "6.1.4", "6.2.0", "6.2.1", "6.2.2", "6.2.3", "6.2.4",
-                "6.3.0", "6.3.1", "6.3.2", "6.4.0", "6.4.1", "6.4.2", "6.5.0", "6.6.0"
+                "5.0.0",
+                "5.0.1",
+                "5.0.2",
+                "5.1.1",
+                "5.1.2",
+                "5.2.0",
+                "5.2.1",
+                "5.2.2",
+                "5.3.0",
+                "5.3.1",
+                "5.3.2",
+                "5.3.3",
+                "5.4.0",
+                "5.4.1",
+                "5.4.2",
+                "5.4.3",
+                "5.5.0",
+                "5.5.1",
+                "5.5.2",
+                "5.5.3",
+                "5.6.0",
+                "5.6.1",
+                "5.6.2",
+                "5.6.3",
+                "5.6.4",
+                "5.6.5",
+                "5.6.6",
+                "5.6.7",
+                "5.6.8",
+                "5.6.9",
+                "5.6.10",
+                "5.6.11",
+                "5.6.12",
+                "5.6.13",
+                "6.0.0",
+                "6.0.1",
+                "6.1.0",
+                "6.1.1",
+                "6.1.2",
+                "6.1.3",
+                "6.1.4",
+                "6.2.0",
+                "6.2.1",
+                "6.2.2",
+                "6.2.3",
+                "6.2.4",
+                "6.3.0",
+                "6.3.1",
+                "6.3.2",
+                "6.4.0",
+                "6.4.1",
+                "6.4.2",
+                "6.5.0",
+                "6.6.0"
             ),
             getVersionCollection("6.6.0").getIndexCompatible()
         );
@@ -235,76 +655,31 @@ public void testIndexCompatible() {
     }
 
     public void testIndexCompatibleUnreleased() {
-        assertVersionsEquals(
-            asList("6.4.2", "6.5.0", "7.0.0"),
-            getVersionCollection("7.0.0-alpha1").getUnreleasedIndexCompatible()
-        );
+        assertVersionsEquals(asList("6.4.2", "6.5.0", "7.0.0"), getVersionCollection("7.0.0-alpha1").getUnreleasedIndexCompatible());
 
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2", "6.5.0"),
-            getVersionCollection("6.5.0").getUnreleasedIndexCompatible()
-        );
+        assertVersionsEquals(asList("5.6.13", "6.4.2", "6.5.0"), getVersionCollection("6.5.0").getUnreleasedIndexCompatible());
 
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2"),
-            getVersionCollection("6.4.2").getUnreleasedIndexCompatible()
-        );
+        assertVersionsEquals(asList("5.6.13", "6.4.2"), getVersionCollection("6.4.2").getUnreleasedIndexCompatible());
 
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2", "6.5.0", "6.6.0"),
-            getVersionCollection("6.6.0").getUnreleasedIndexCompatible()
-        );
+        assertVersionsEquals(asList("5.6.13", "6.4.2", "6.5.0", "6.6.0"), getVersionCollection("6.6.0").getUnreleasedIndexCompatible());
 
-        assertVersionsEquals(
-            asList("7.1.1", "7.2.0", "7.3.0", "8.0.0"),
-            getVersionCollection("8.0.0").getUnreleasedIndexCompatible()
-        );
+        assertVersionsEquals(asList("7.1.1", "7.2.0", "7.3.0", "8.0.0"), getVersionCollection("8.0.0").getUnreleasedIndexCompatible());
     }
 
     public void testGetUnreleased() {
-        assertVersionsEquals(
-            asList("6.4.2", "6.5.0", "7.0.0-alpha1"),
-            getVersionCollection("7.0.0-alpha1").getUnreleased()
-        );
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2", "6.5.0"),
-            getVersionCollection("6.5.0").getUnreleased()
-        );
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2"),
-            getVersionCollection("6.4.2").getUnreleased()
-        );
-        assertVersionsEquals(
-            asList("5.6.13", "6.4.2", "6.5.0", "6.6.0"),
-            getVersionCollection("6.6.0").getUnreleased()
-        );
-        assertVersionsEquals(
-            asList("7.1.1", "7.2.0", "7.3.0", "8.0.0"),
-            getVersionCollection("8.0.0").getUnreleased()
-        );
+        assertVersionsEquals(asList("6.4.2", "6.5.0", "7.0.0-alpha1"), getVersionCollection("7.0.0-alpha1").getUnreleased());
+        assertVersionsEquals(asList("5.6.13", "6.4.2", "6.5.0"), getVersionCollection("6.5.0").getUnreleased());
+        assertVersionsEquals(asList("5.6.13", "6.4.2"), getVersionCollection("6.4.2").getUnreleased());
+        assertVersionsEquals(asList("5.6.13", "6.4.2", "6.5.0", "6.6.0"), getVersionCollection("6.6.0").getUnreleased());
+        assertVersionsEquals(asList("7.1.1", "7.2.0", "7.3.0", "8.0.0"), getVersionCollection("8.0.0").getUnreleased());
     }
 
     public void testGetBranch() {
-        assertUnreleasedBranchNames(
-            asList("6.4", "6.x"),
-            getVersionCollection("7.0.0-alpha1")
-        );
-        assertUnreleasedBranchNames(
-            asList("5.6", "6.4"),
-            getVersionCollection("6.5.0")
-        );
-        assertUnreleasedBranchNames(
-            singletonList("5.6"),
-            getVersionCollection("6.4.2")
-        );
-        assertUnreleasedBranchNames(
-            asList("5.6", "6.4", "6.5"),
-            getVersionCollection("6.6.0")
-        );
-        assertUnreleasedBranchNames(
-            asList("7.1", "7.2", "7.x"),
-            getVersionCollection("8.0.0")
-        );
+        assertUnreleasedBranchNames(asList("6.4", "6.x"), getVersionCollection("7.0.0-alpha1"));
+        assertUnreleasedBranchNames(asList("5.6", "6.4"), getVersionCollection("6.5.0"));
+        assertUnreleasedBranchNames(singletonList("5.6"), getVersionCollection("6.4.2"));
+        assertUnreleasedBranchNames(asList("5.6", "6.4", "6.5"), getVersionCollection("6.6.0"));
+        assertUnreleasedBranchNames(asList("7.1", "7.2", "7.x"), getVersionCollection("8.0.0"));
     }
 
     public void testGetGradleProjectPath() {
@@ -316,10 +691,7 @@ public void testGetGradleProjectPath() {
             asList(":distribution:bwc:maintenance", ":distribution:bwc:bugfix"),
             getVersionCollection("6.5.0")
         );
-        assertUnreleasedGradleProjectPaths(
-            singletonList(":distribution:bwc:maintenance"),
-            getVersionCollection("6.4.2")
-        );
+        assertUnreleasedGradleProjectPaths(singletonList(":distribution:bwc:maintenance"), getVersionCollection("6.4.2"));
         assertUnreleasedGradleProjectPaths(
             asList(":distribution:bwc:maintenance", ":distribution:bwc:bugfix", ":distribution:bwc:minor"),
             getVersionCollection("6.6.0")
@@ -337,13 +709,11 @@ public void testGetGradleProjectPath() {
     public void testCompareToAuthoritative() {
         List<String> listOfVersions = asList("7.0.0", "7.0.1", "7.1.0", "7.1.1", "7.2.0", "7.3.0", "8.0.0");
         List<Version> authoritativeReleasedVersions = Stream.of("7.0.0", "7.0.1", "7.1.0")
-                .map(Version::fromString)
-                .collect(Collectors.toList());
+            .map(Version::fromString)
+            .collect(Collectors.toList());
 
         BwcVersions vc = new BwcVersions(
-            listOfVersions.stream()
-                .map(this::formatVersionToLine)
-                .collect(Collectors.toList()),
+            listOfVersions.stream().map(this::formatVersionToLine).collect(Collectors.toList()),
             Version.fromString("8.0.0")
         );
         vc.compareToAuthoritative(authoritativeReleasedVersions);
@@ -352,13 +722,11 @@ public void testCompareToAuthoritative() {
     public void testCompareToAuthoritativeUnreleasedActuallyReleased() {
         List<String> listOfVersions = asList("7.0.0", "7.0.1", "7.1.0", "7.1.1", "7.2.0", "7.3.0", "8.0.0");
         List<Version> authoritativeReleasedVersions = Stream.of("7.0.0", "7.0.1", "7.1.0", "7.1.1", "8.0.0")
-                .map(Version::fromString)
-                .collect(Collectors.toList());
+            .map(Version::fromString)
+            .collect(Collectors.toList());
 
         BwcVersions vc = new BwcVersions(
-            listOfVersions.stream()
-                .map(this::formatVersionToLine)
-                .collect(Collectors.toList()),
+            listOfVersions.stream().map(this::formatVersionToLine).collect(Collectors.toList()),
             Version.fromString("8.0.0")
         );
         expectedEx.expect(IllegalStateException.class);
@@ -368,13 +736,9 @@ public void testCompareToAuthoritativeUnreleasedActuallyReleased() {
 
     public void testCompareToAuthoritativeNotReallyRelesed() {
         List<String> listOfVersions = asList("7.0.0", "7.0.1", "7.1.0", "7.1.1", "7.2.0", "7.3.0", "8.0.0");
-        List<Version> authoritativeReleasedVersions = Stream.of("7.0.0", "7.0.1")
-                .map(Version::fromString)
-                .collect(Collectors.toList());
+        List<Version> authoritativeReleasedVersions = Stream.of("7.0.0", "7.0.1").map(Version::fromString).collect(Collectors.toList());
         BwcVersions vc = new BwcVersions(
-            listOfVersions.stream()
-                .map(this::formatVersionToLine)
-                .collect(Collectors.toList()),
+            listOfVersions.stream().map(this::formatVersionToLine).collect(Collectors.toList()),
             Version.fromString("8.0.0")
         );
         expectedEx.expect(IllegalStateException.class);
@@ -384,17 +748,13 @@ public void testCompareToAuthoritativeNotReallyRelesed() {
 
     private void assertUnreleasedGradleProjectPaths(List<String> expectedNAmes, BwcVersions bwcVersions) {
         List<String> actualNames = new ArrayList<>();
-        bwcVersions.forPreviousUnreleased(unreleasedVersion ->
-            actualNames.add(unreleasedVersion.gradleProjectPath)
-        );
+        bwcVersions.forPreviousUnreleased(unreleasedVersion -> actualNames.add(unreleasedVersion.gradleProjectPath));
         assertEquals(expectedNAmes, actualNames);
     }
 
     private void assertUnreleasedBranchNames(List<String> expectedBranches, BwcVersions bwcVersions) {
         List<String> actualBranches = new ArrayList<>();
-        bwcVersions.forPreviousUnreleased(unreleasedVersionInfo ->
-            actualBranches.add(unreleasedVersionInfo.branch)
-        );
+        bwcVersions.forPreviousUnreleased(unreleasedVersionInfo -> actualBranches.add(unreleasedVersionInfo.branch));
         assertEquals(expectedBranches, actualBranches);
     }
 
@@ -403,19 +763,12 @@ private String formatVersionToLine(final String version) {
     }
 
     private void assertVersionsEquals(List<String> expected, List<Version> actual) {
-        assertEquals(
-            expected.stream()
-                .map(Version::fromString)
-                .collect(Collectors.toList()),
-            actual
-        );
+        assertEquals(expected.stream().map(Version::fromString).collect(Collectors.toList()), actual);
     }
 
     private BwcVersions getVersionCollection(String currentVersion) {
         return new BwcVersions(
-            sampleVersions.get(currentVersion).stream()
-                .map(this::formatVersionToLine)
-                .collect(Collectors.toList()),
+            sampleVersions.get(currentVersion).stream().map(this::formatVersionToLine).collect(Collectors.toList()),
             Version.fromString(currentVersion)
         );
     }
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/ConcatFilesTaskTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/ConcatFilesTaskTests.java
index 72e128b72efd7..18ee983dd7a8b 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/ConcatFilesTaskTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/ConcatFilesTaskTests.java
@@ -66,17 +66,14 @@ public void testConcatenationWithUnique() throws IOException {
         file2.getParentFile().mkdirs();
         file1.createNewFile();
         file2.createNewFile();
-        Files.write(file1.toPath(), ("Hello" + System.lineSeparator() +  "Hello").getBytes(StandardCharsets.UTF_8));
+        Files.write(file1.toPath(), ("Hello" + System.lineSeparator() + "Hello").getBytes(StandardCharsets.UTF_8));
         Files.write(file2.toPath(), ("Hello" + System.lineSeparator() + "नमस�ते").getBytes(StandardCharsets.UTF_8));
 
         concatFilesTask.setFiles(project.fileTree(file1.getParentFile().getParentFile()));
 
         concatFilesTask.concatFiles();
 
-        assertEquals(
-            Arrays.asList("Hello", "नमस�ते"),
-            Files.readAllLines(concatFilesTask.getTarget().toPath(), StandardCharsets.UTF_8)
-        );
+        assertEquals(Arrays.asList("Hello", "नमस�ते"), Files.readAllLines(concatFilesTask.getTarget().toPath(), StandardCharsets.UTF_8));
 
     }
 
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/DistributionDownloadPluginIT.java b/buildSrc/src/test/java/org/elasticsearch/gradle/DistributionDownloadPluginIT.java
index fe2ba08853170..eb6fdd889455a 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/DistributionDownloadPluginIT.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/DistributionDownloadPluginIT.java
@@ -44,49 +44,100 @@ public class DistributionDownloadPluginIT extends GradleIntegrationTestCase {
 
     public void testCurrent() throws Exception {
         String projectName = ":distribution:archives:linux-tar";
-        assertExtractedDistro(VersionProperties.getElasticsearch(), "archive", "linux", null, null,
-            "tests.local_distro.config", "default",
-            "tests.local_distro.project", projectName);
+        assertExtractedDistro(
+            VersionProperties.getElasticsearch(),
+            "archive",
+            "linux",
+            null,
+            null,
+            "tests.local_distro.config",
+            "default",
+            "tests.local_distro.project",
+            projectName
+        );
     }
 
     public void testCurrentExternal() throws Exception {
-        checkService(VersionProperties.getElasticsearch(), "archive", "linux", null, null,
+        checkService(
+            VersionProperties.getElasticsearch(),
+            "archive",
+            "linux",
+            null,
+            null,
             "/downloads/elasticsearch/elasticsearch-" + VersionProperties.getElasticsearch() + "-linux-x86_64.tar.gz",
-            "tests.internal", "false");
+            "tests.internal",
+            "false"
+        );
     }
 
     public void testBwc() throws Exception {
-        assertExtractedDistro("8.1.0", "archive", "linux", null, null,
-            "tests.local_distro.config", "linux-tar",
-            "tests.local_distro.project", ":distribution:bwc:minor",
-            "tests.current_version", "8.0.0");
+        assertExtractedDistro(
+            "8.1.0",
+            "archive",
+            "linux",
+            null,
+            null,
+            "tests.local_distro.config",
+            "linux-tar",
+            "tests.local_distro.project",
+            ":distribution:bwc:minor",
+            "tests.current_version",
+            "8.0.0"
+        );
     }
 
     public void testBwcExternal() throws Exception {
-        checkService("8.1.0-SNAPSHOT", "archive", "linux", null, null,
+        checkService(
+            "8.1.0-SNAPSHOT",
+            "archive",
+            "linux",
+            null,
+            null,
             "/downloads/elasticsearch/elasticsearch-8.1.0-SNAPSHOT-linux-x86_64.tar.gz",
-            "tests.internal", "false",
-            "tests.current_version", "9.0.0");
+            "tests.internal",
+            "false",
+            "tests.current_version",
+            "9.0.0"
+        );
     }
 
     public void testReleased() throws Exception {
-        checkService("7.0.0", "archive", "windows", null, null,
-            "/downloads/elasticsearch/elasticsearch-7.0.0-windows-x86_64.zip");
-        checkService("6.5.0", "archive", "windows", null, null,
-            "/downloads/elasticsearch/elasticsearch-6.5.0.zip");
+        checkService("7.0.0", "archive", "windows", null, null, "/downloads/elasticsearch/elasticsearch-7.0.0-windows-x86_64.zip");
+        checkService("6.5.0", "archive", "windows", null, null, "/downloads/elasticsearch/elasticsearch-6.5.0.zip");
     }
 
     public void testReleasedExternal() throws Exception {
-        checkService("7.0.0", "archive", "windows", null, null,
+        checkService(
+            "7.0.0",
+            "archive",
+            "windows",
+            null,
+            null,
             "/downloads/elasticsearch/elasticsearch-7.0.0-windows-x86_64.zip",
-            "tests.internal", "false");
-        checkService("6.5.0", "archive", "windows", null, null,
+            "tests.internal",
+            "false"
+        );
+        checkService(
+            "6.5.0",
+            "archive",
+            "windows",
+            null,
+            null,
             "/downloads/elasticsearch/elasticsearch-6.5.0.zip",
-            "tests.internal", "false");
+            "tests.internal",
+            "false"
+        );
     }
 
-    private void checkService(String version, String type, String platform, String flavor, Boolean bundledJdk,
-                              String urlPath, String... sysProps) throws IOException {
+    private void checkService(
+        String version,
+        String type,
+        String platform,
+        String flavor,
+        Boolean bundledJdk,
+        String urlPath,
+        String... sysProps
+    ) throws IOException {
         String suffix = urlPath.endsWith("zip") ? "zip" : "tar.gz";
         String sourceFile = "src/testKit/distribution-download/distribution/files/fake_elasticsearch." + suffix;
         WireMockServer wireMock = new WireMockServer(0);
@@ -113,16 +164,16 @@ private void checkService(String version, String type, String platform, String f
         }
     }
 
-    private void assertFileDistro(String version, String type, String platform, String flavor, Boolean bundledJdk,
-                                  String... sysProps) throws IOException {
+    private void assertFileDistro(String version, String type, String platform, String flavor, Boolean bundledJdk, String... sysProps)
+        throws IOException {
         List<String> finalSysProps = new ArrayList<>();
         addDistroSysProps(finalSysProps, version, type, platform, flavor, bundledJdk);
         finalSysProps.addAll(Arrays.asList(sysProps));
         runBuild(":subproj:assertDistroFile", finalSysProps.toArray(new String[0]));
     }
 
-    private void assertExtractedDistro(String version, String type, String platform, String flavor, Boolean bundledJdk,
-                                       String... sysProps) throws IOException {
+    private void assertExtractedDistro(String version, String type, String platform, String flavor, Boolean bundledJdk, String... sysProps)
+        throws IOException {
         List<String> finalSysProps = new ArrayList<>();
         addDistroSysProps(finalSysProps, version, type, platform, flavor, bundledJdk);
         finalSysProps.addAll(Arrays.asList(sysProps));
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/DistributionDownloadPluginTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/DistributionDownloadPluginTests.java
index 00c9bf20a56d3..a2e7413c5d717 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/DistributionDownloadPluginTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/DistributionDownloadPluginTests.java
@@ -45,64 +45,138 @@ public class DistributionDownloadPluginTests extends GradleUnitTestCase {
     private static final Version BWC_STAGED_VERSION = Version.fromString("1.0.0");
     private static final Version BWC_BUGFIX_VERSION = Version.fromString("1.0.1");
     private static final Version BWC_MAINTENANCE_VERSION = Version.fromString("0.90.1");
-    private static final BwcVersions BWC_MINOR =
-        new BwcVersions(new TreeSet<>(Arrays.asList(BWC_BUGFIX_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)), BWC_MAJOR_VERSION);
-    private static final BwcVersions BWC_STAGED =
-        new BwcVersions(new TreeSet<>(Arrays.asList(BWC_STAGED_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)), BWC_MAJOR_VERSION);
-    private static final BwcVersions BWC_BUGFIX =
-        new BwcVersions(new TreeSet<>(Arrays.asList(BWC_BUGFIX_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)), BWC_MAJOR_VERSION);
-    private static final BwcVersions BWC_MAINTENANCE =
-        new BwcVersions(new TreeSet<>(Arrays.asList(BWC_MAINTENANCE_VERSION, BWC_STAGED_VERSION, BWC_MINOR_VERSION)), BWC_MINOR_VERSION);
+    private static final BwcVersions BWC_MINOR = new BwcVersions(
+        new TreeSet<>(Arrays.asList(BWC_BUGFIX_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)),
+        BWC_MAJOR_VERSION
+    );
+    private static final BwcVersions BWC_STAGED = new BwcVersions(
+        new TreeSet<>(Arrays.asList(BWC_STAGED_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)),
+        BWC_MAJOR_VERSION
+    );
+    private static final BwcVersions BWC_BUGFIX = new BwcVersions(
+        new TreeSet<>(Arrays.asList(BWC_BUGFIX_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)),
+        BWC_MAJOR_VERSION
+    );
+    private static final BwcVersions BWC_MAINTENANCE = new BwcVersions(
+        new TreeSet<>(Arrays.asList(BWC_MAINTENANCE_VERSION, BWC_STAGED_VERSION, BWC_MINOR_VERSION)),
+        BWC_MINOR_VERSION
+    );
 
     public void testVersionDefault() {
-        ElasticsearchDistribution distro = checkDistro(createProject(null, false),
-            "testdistro", null, Type.ARCHIVE, Platform.LINUX, Flavor.OSS, true);
+        ElasticsearchDistribution distro = checkDistro(
+            createProject(null, false),
+            "testdistro",
+            null,
+            Type.ARCHIVE,
+            Platform.LINUX,
+            Flavor.OSS,
+            true
+        );
         assertEquals(distro.getVersion(), VersionProperties.getElasticsearch());
     }
 
     public void testBadVersionFormat() {
-        assertDistroError(createProject(null, false), "testdistro", "badversion", Type.ARCHIVE, Platform.LINUX, Flavor.OSS, true,
-            "Invalid version format: 'badversion'");
+        assertDistroError(
+            createProject(null, false),
+            "testdistro",
+            "badversion",
+            Type.ARCHIVE,
+            Platform.LINUX,
+            Flavor.OSS,
+            true,
+            "Invalid version format: 'badversion'"
+        );
     }
 
     public void testTypeDefault() {
-        ElasticsearchDistribution distro = checkDistro(createProject(null, false),
-            "testdistro", "5.0.0", null, Platform.LINUX, Flavor.OSS, true);
+        ElasticsearchDistribution distro = checkDistro(
+            createProject(null, false),
+            "testdistro",
+            "5.0.0",
+            null,
+            Platform.LINUX,
+            Flavor.OSS,
+            true
+        );
         assertEquals(distro.getType(), Type.ARCHIVE);
     }
 
     public void testPlatformDefault() {
-        ElasticsearchDistribution distro = checkDistro(createProject(null, false),
-            "testdistro", "5.0.0", Type.ARCHIVE, null, Flavor.OSS, true);
+        ElasticsearchDistribution distro = checkDistro(
+            createProject(null, false),
+            "testdistro",
+            "5.0.0",
+            Type.ARCHIVE,
+            null,
+            Flavor.OSS,
+            true
+        );
         assertEquals(distro.getPlatform(), ElasticsearchDistribution.CURRENT_PLATFORM);
     }
 
     public void testPlatformForIntegTest() {
-        assertDistroError(createProject(null, false), "testdistro", "5.0.0", Type.INTEG_TEST_ZIP, Platform.LINUX, null, null,
-            "platform not allowed for elasticsearch distribution [testdistro]");
+        assertDistroError(
+            createProject(null, false),
+            "testdistro",
+            "5.0.0",
+            Type.INTEG_TEST_ZIP,
+            Platform.LINUX,
+            null,
+            null,
+            "platform not allowed for elasticsearch distribution [testdistro]"
+        );
     }
 
     public void testFlavorDefault() {
-        ElasticsearchDistribution distro = checkDistro(createProject(null, false),
-            "testdistro", "5.0.0", Type.ARCHIVE, Platform.LINUX, null, true);
+        ElasticsearchDistribution distro = checkDistro(
+            createProject(null, false),
+            "testdistro",
+            "5.0.0",
+            Type.ARCHIVE,
+            Platform.LINUX,
+            null,
+            true
+        );
         assertEquals(distro.getFlavor(), Flavor.DEFAULT);
     }
 
     public void testFlavorForIntegTest() {
-        assertDistroError(createProject(null, false),
-            "testdistro", "5.0.0", Type.INTEG_TEST_ZIP, null, Flavor.OSS, null,
-            "flavor [oss] not allowed for elasticsearch distribution [testdistro] of type [integ_test_zip]");
+        assertDistroError(
+            createProject(null, false),
+            "testdistro",
+            "5.0.0",
+            Type.INTEG_TEST_ZIP,
+            null,
+            Flavor.OSS,
+            null,
+            "flavor [oss] not allowed for elasticsearch distribution [testdistro] of type [integ_test_zip]"
+        );
     }
 
     public void testBundledJdkDefault() {
-        ElasticsearchDistribution distro = checkDistro(createProject(null, false),
-            "testdistro", "5.0.0", Type.ARCHIVE, Platform.LINUX, null, true);
+        ElasticsearchDistribution distro = checkDistro(
+            createProject(null, false),
+            "testdistro",
+            "5.0.0",
+            Type.ARCHIVE,
+            Platform.LINUX,
+            null,
+            true
+        );
         assertTrue(distro.getBundledJdk());
     }
 
     public void testBundledJdkForIntegTest() {
-        assertDistroError(createProject(null, false), "testdistro", "5.0.0", Type.INTEG_TEST_ZIP, null, null, true,
-            "bundledJdk not allowed for elasticsearch distribution [testdistro]");
+        assertDistroError(
+            createProject(null, false),
+            "testdistro",
+            "5.0.0",
+            Type.INTEG_TEST_ZIP,
+            null,
+            null,
+            true,
+            "bundledJdk not allowed for elasticsearch distribution [testdistro]"
+        );
     }
 
     public void testLocalCurrentVersionIntegTestZip() {
@@ -110,15 +184,14 @@ public void testLocalCurrentVersionIntegTestZip() {
         Project archiveProject = ProjectBuilder.builder().withParent(archivesProject).withName("integ-test-zip").build();
         archiveProject.getConfigurations().create("default");
         archiveProject.getArtifacts().add("default", new File("doesnotmatter"));
-        createDistro(project, "distro",
-            VersionProperties.getElasticsearch(), Type.INTEG_TEST_ZIP, null, null, null);
+        createDistro(project, "distro", VersionProperties.getElasticsearch(), Type.INTEG_TEST_ZIP, null, null, null);
         checkPlugin(project);
     }
 
     public void testLocalCurrentVersionArchives() {
         for (Platform platform : Platform.values()) {
             for (Flavor flavor : Flavor.values()) {
-                for (boolean bundledJdk : new boolean[] { true, false}) {
+                for (boolean bundledJdk : new boolean[] { true, false }) {
                     // create a new project in each iteration, so that we know we are resolving the only additional project being created
                     Project project = createProject(BWC_MINOR, true);
                     String projectName = projectName(platform.toString(), flavor, bundledJdk);
@@ -126,8 +199,7 @@ public void testLocalCurrentVersionArchives() {
                     Project archiveProject = ProjectBuilder.builder().withParent(archivesProject).withName(projectName).build();
                     archiveProject.getConfigurations().create("default");
                     archiveProject.getArtifacts().add("default", new File("doesnotmatter"));
-                    createDistro(project, "distro",
-                        VersionProperties.getElasticsearch(), Type.ARCHIVE, platform, flavor, bundledJdk);
+                    createDistro(project, "distro", VersionProperties.getElasticsearch(), Type.ARCHIVE, platform, flavor, bundledJdk);
                     checkPlugin(project);
                 }
             }
@@ -137,14 +209,13 @@ public void testLocalCurrentVersionArchives() {
     public void testLocalCurrentVersionPackages() {
         for (Type packageType : new Type[] { Type.RPM, Type.DEB }) {
             for (Flavor flavor : Flavor.values()) {
-                for (boolean bundledJdk : new boolean[] { true, false}) {
+                for (boolean bundledJdk : new boolean[] { true, false }) {
                     Project project = createProject(BWC_MINOR, true);
                     String projectName = projectName(packageType.toString(), flavor, bundledJdk);
                     Project packageProject = ProjectBuilder.builder().withParent(packagesProject).withName(projectName).build();
                     packageProject.getConfigurations().create("default");
                     packageProject.getArtifacts().add("default", new File("doesnotmatter"));
-                    createDistro(project, "distro",
-                        VersionProperties.getElasticsearch(), packageType, null, flavor, bundledJdk);
+                    createDistro(project, "distro", VersionProperties.getElasticsearch(), packageType, null, flavor, bundledJdk);
                     checkPlugin(project);
                 }
             }
@@ -180,15 +251,32 @@ public void testLocalBwcPackages() {
         }
     }
 
-    private void assertDistroError(Project project, String name, String version, Type type, Platform platform,
-                                   Flavor flavor, Boolean bundledJdk, String message) {
-        IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-            () -> checkDistro(project, name, version, type, platform, flavor, bundledJdk));
+    private void assertDistroError(
+        Project project,
+        String name,
+        String version,
+        Type type,
+        Platform platform,
+        Flavor flavor,
+        Boolean bundledJdk,
+        String message
+    ) {
+        IllegalArgumentException e = expectThrows(
+            IllegalArgumentException.class,
+            () -> checkDistro(project, name, version, type, platform, flavor, bundledJdk)
+        );
         assertThat(e.getMessage(), containsString(message));
     }
 
-    private ElasticsearchDistribution createDistro(Project project, String name, String version, Type type,
-                              Platform platform, Flavor flavor, Boolean bundledJdk) {
+    private ElasticsearchDistribution createDistro(
+        Project project,
+        String name,
+        String version,
+        Type type,
+        Platform platform,
+        Flavor flavor,
+        Boolean bundledJdk
+    ) {
         NamedDomainObjectContainer<ElasticsearchDistribution> distros = DistributionDownloadPlugin.getContainer(project);
         return distros.create(name, distro -> {
             if (version != null) {
@@ -210,8 +298,15 @@ private ElasticsearchDistribution createDistro(Project project, String name, Str
     }
 
     // create a distro and finalize its configuration
-    private ElasticsearchDistribution checkDistro(Project project, String name, String version, Type type,
-                                                  Platform platform, Flavor flavor, Boolean bundledJdk) {
+    private ElasticsearchDistribution checkDistro(
+        Project project,
+        String name,
+        String version,
+        Type type,
+        Platform platform,
+        Flavor flavor,
+        Boolean bundledJdk
+    ) {
         ElasticsearchDistribution distribution = createDistro(project, name, version, type, platform, flavor, bundledJdk);
         distribution.finalizeValues();
         return distribution;
@@ -223,8 +318,16 @@ private void checkPlugin(Project project) {
         plugin.setupDistributions(project);
     }
 
-    private void checkBwc(String projectName, String config, Version version,
-                          Type type, Platform platform, Flavor flavor, BwcVersions bwcVersions, boolean isInternal) {
+    private void checkBwc(
+        String projectName,
+        String config,
+        Version version,
+        Type type,
+        Platform platform,
+        Flavor flavor,
+        BwcVersions bwcVersions,
+        boolean isInternal
+    ) {
         Project project = createProject(bwcVersions, isInternal);
         Project archiveProject = ProjectBuilder.builder().withParent(bwcProject).withName(projectName).build();
         archiveProject.getConfigurations().create(config);
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/ExportElasticsearchBuildResourcesTaskIT.java b/buildSrc/src/test/java/org/elasticsearch/gradle/ExportElasticsearchBuildResourcesTaskIT.java
index 7968f4f57cf90..cd84920907887 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/ExportElasticsearchBuildResourcesTaskIT.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/ExportElasticsearchBuildResourcesTaskIT.java
@@ -22,35 +22,26 @@
 import org.elasticsearch.gradle.test.GradleIntegrationTestCase;
 import org.gradle.testkit.runner.BuildResult;
 
-
 public class ExportElasticsearchBuildResourcesTaskIT extends GradleIntegrationTestCase {
 
     public static final String PROJECT_NAME = "elasticsearch-build-resources";
 
     public void testUpToDateWithSourcesConfigured() {
-        getGradleRunner(PROJECT_NAME)
-            .withArguments("clean", "-s")
-            .build();
+        getGradleRunner(PROJECT_NAME).withArguments("clean", "-s").build();
 
-        BuildResult result = getGradleRunner(PROJECT_NAME)
-            .withArguments("buildResources", "-s", "-i")
-            .build();
+        BuildResult result = getGradleRunner(PROJECT_NAME).withArguments("buildResources", "-s", "-i").build();
         assertTaskSuccessful(result, ":buildResources");
         assertBuildFileExists(result, PROJECT_NAME, "build-tools-exported/checkstyle.xml");
         assertBuildFileExists(result, PROJECT_NAME, "build-tools-exported/checkstyle_suppressions.xml");
 
-        result = getGradleRunner(PROJECT_NAME)
-            .withArguments("buildResources", "-s", "-i")
-            .build();
+        result = getGradleRunner(PROJECT_NAME).withArguments("buildResources", "-s", "-i").build();
         assertTaskUpToDate(result, ":buildResources");
         assertBuildFileExists(result, PROJECT_NAME, "build-tools-exported/checkstyle.xml");
         assertBuildFileExists(result, PROJECT_NAME, "build-tools-exported/checkstyle_suppressions.xml");
     }
 
     public void testImplicitTaskDependencyCopy() {
-        BuildResult result = getGradleRunner(PROJECT_NAME)
-            .withArguments("clean", "sampleCopyAll", "-s", "-i")
-            .build();
+        BuildResult result = getGradleRunner(PROJECT_NAME).withArguments("clean", "sampleCopyAll", "-s", "-i").build();
 
         assertTaskSuccessful(result, ":buildResources");
         assertTaskSuccessful(result, ":sampleCopyAll");
@@ -60,9 +51,7 @@ public void testImplicitTaskDependencyCopy() {
     }
 
     public void testImplicitTaskDependencyInputFileOfOther() {
-        BuildResult result = getGradleRunner(PROJECT_NAME)
-            .withArguments("clean", "sample", "-s", "-i")
-            .build();
+        BuildResult result = getGradleRunner(PROJECT_NAME).withArguments("clean", "sample", "-s", "-i").build();
 
         assertTaskSuccessful(result, ":sample");
         assertBuildFileExists(result, PROJECT_NAME, "build-tools-exported/checkstyle.xml");
@@ -71,10 +60,7 @@ public void testImplicitTaskDependencyInputFileOfOther() {
 
     public void testIncorrectUsage() {
         assertOutputContains(
-            getGradleRunner(PROJECT_NAME)
-                .withArguments("noConfigAfterExecution", "-s", "-i")
-                .buildAndFail()
-                .getOutput(),
+            getGradleRunner(PROJECT_NAME).withArguments("noConfigAfterExecution", "-s", "-i").buildAndFail().getOutput(),
             "buildResources can't be configured after the task ran"
         );
     }
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/JdkDownloadPluginIT.java b/buildSrc/src/test/java/org/elasticsearch/gradle/JdkDownloadPluginIT.java
index 4e760502e2c2e..8e76334e80df1 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/JdkDownloadPluginIT.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/JdkDownloadPluginIT.java
@@ -95,24 +95,30 @@ private void assertExtraction(String taskname, String platform, String javaBin,
 
     protected abstract byte[] filebytes(String platform, String extension) throws IOException;
 
-    private void runBuild(
-        String taskname, String platform, Consumer<BuildResult> assertions, String vendor, String version) throws IOException {
+    private void runBuild(String taskname, String platform, Consumer<BuildResult> assertions, String vendor, String version)
+        throws IOException {
         WireMockServer wireMock = new WireMockServer(0);
         try {
             String extension = platform.equals("windows") ? "zip" : "tar.gz";
             boolean isOld = version.equals(oldJdkVersion());
 
             wireMock.stubFor(head(urlEqualTo(urlPath(isOld, platform, extension))).willReturn(aResponse().withStatus(200)));
-            wireMock.stubFor(get(urlEqualTo(urlPath(isOld, platform, extension)))
-                .willReturn(aResponse().withStatus(200).withBody(filebytes(platform, extension))));
+            wireMock.stubFor(
+                get(urlEqualTo(urlPath(isOld, platform, extension))).willReturn(
+                    aResponse().withStatus(200).withBody(filebytes(platform, extension))
+                )
+            );
             wireMock.start();
 
-            GradleRunner runner = GradleRunner.create().withProjectDir(getProjectDir("jdk-download"))
-                .withArguments(taskname,
+            GradleRunner runner = GradleRunner.create()
+                .withProjectDir(getProjectDir("jdk-download"))
+                .withArguments(
+                    taskname,
                     "-Dtests.jdk_vendor=" + vendor,
                     "-Dtests.jdk_version=" + version,
                     "-Dtests.jdk_repo=" + wireMock.baseUrl(),
-                    "-i")
+                    "-i"
+                )
                 .withPluginClasspath();
 
             BuildResult result = runner.build();
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/JdkDownloadPluginTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/JdkDownloadPluginTests.java
index b8918096340ec..ea291858913f8 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/JdkDownloadPluginTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/JdkDownloadPluginTests.java
@@ -32,7 +32,7 @@ public class JdkDownloadPluginTests extends GradleUnitTestCase {
 
     @BeforeClass
     public static void setupRoot() {
-         rootProject = ProjectBuilder.builder().build();
+        rootProject = ProjectBuilder.builder().build();
     }
 
     public void testMissingVendor() {
@@ -46,7 +46,8 @@ public void testUnknownVendor() {
             "unknown",
             "11.0.2+33",
             "linux",
-            "unknown vendor [unknown] for jdk [testjdk], must be one of [adoptopenjdk, openjdk]");
+            "unknown vendor [unknown] for jdk [testjdk], must be one of [adoptopenjdk, openjdk]"
+        );
     }
 
     public void testMissingVersion() {
@@ -62,13 +63,21 @@ public void testMissingPlatform() {
     }
 
     public void testUnknownPlatform() {
-        assertJdkError(createProject(), "testjdk", "openjdk", "11.0.2+33", "unknown",
-            "unknown platform [unknown] for jdk [testjdk], must be one of [darwin, linux, windows, mac]");
+        assertJdkError(
+            createProject(),
+            "testjdk",
+            "openjdk",
+            "11.0.2+33",
+            "unknown",
+            "unknown platform [unknown] for jdk [testjdk], must be one of [darwin, linux, windows, mac]"
+        );
     }
 
     private void assertJdkError(Project project, String name, String vendor, String version, String platform, String message) {
-        IllegalArgumentException e =
-            expectThrows(IllegalArgumentException.class, () -> createJdk(project, name, vendor, version, platform));
+        IllegalArgumentException e = expectThrows(
+            IllegalArgumentException.class,
+            () -> createJdk(project, name, vendor, version, platform)
+        );
         assertThat(e.getMessage(), equalTo(message));
     }
 
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/VersionTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/VersionTests.java
index ae2fb0e6215db..253490666d937 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/VersionTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/VersionTests.java
@@ -49,13 +49,13 @@ public void testRelaxedVersionParsing() {
     }
 
     public void testCompareWithStringVersions() {
-        assertTrue("1.10.20 is not interpreted as before 2.0.0",
-            Version.fromString("1.10.20").before("2.0.0")
-        );
-        assertTrue("7.0.0-alpha1 should be equal to 7.0.0-alpha1",
+        assertTrue("1.10.20 is not interpreted as before 2.0.0", Version.fromString("1.10.20").before("2.0.0"));
+        assertTrue(
+            "7.0.0-alpha1 should be equal to 7.0.0-alpha1",
             Version.fromString("7.0.0-alpha1").equals(Version.fromString("7.0.0-alpha1"))
         );
-        assertTrue("7.0.0-SNAPSHOT should be equal to 7.0.0-SNAPSHOT",
+        assertTrue(
+            "7.0.0-SNAPSHOT should be equal to 7.0.0-SNAPSHOT",
             Version.fromString("7.0.0-SNAPSHOT").equals(Version.fromString("7.0.0-SNAPSHOT"))
         );
     }
@@ -63,21 +63,25 @@ public void testCompareWithStringVersions() {
     public void testCollections() {
         assertTrue(
             Arrays.asList(
-                Version.fromString("5.2.0"), Version.fromString("5.2.1-SNAPSHOT"), Version.fromString("6.0.0"),
-                Version.fromString("6.0.1"), Version.fromString("6.1.0")
-            ).containsAll(Arrays.asList(
-                Version.fromString("6.0.1"), Version.fromString("5.2.1-SNAPSHOT")
-            ))
+                Version.fromString("5.2.0"),
+                Version.fromString("5.2.1-SNAPSHOT"),
+                Version.fromString("6.0.0"),
+                Version.fromString("6.0.1"),
+                Version.fromString("6.1.0")
+            ).containsAll(Arrays.asList(Version.fromString("6.0.1"), Version.fromString("5.2.1-SNAPSHOT")))
         );
         Set<Version> versions = new HashSet<>();
-        versions.addAll(Arrays.asList(
-            Version.fromString("5.2.0"), Version.fromString("5.2.1-SNAPSHOT"), Version.fromString("6.0.0"),
-            Version.fromString("6.0.1"), Version.fromString("6.1.0")
-        ));
+        versions.addAll(
+            Arrays.asList(
+                Version.fromString("5.2.0"),
+                Version.fromString("5.2.1-SNAPSHOT"),
+                Version.fromString("6.0.0"),
+                Version.fromString("6.0.1"),
+                Version.fromString("6.1.0")
+            )
+        );
         Set<Version> subset = new HashSet<>();
-        subset.addAll(Arrays.asList(
-            Version.fromString("6.0.1"), Version.fromString("5.2.1-SNAPSHOT")
-        ));
+        subset.addAll(Arrays.asList(Version.fromString("6.0.1"), Version.fromString("5.2.1-SNAPSHOT")));
         assertTrue(versions.containsAll(subset));
     }
 
@@ -86,9 +90,7 @@ public void testToString() {
     }
 
     public void testCompareVersions() {
-        assertEquals(0,
-            new Version(7, 0, 0).compareTo(new Version(7, 0, 0))
-        );
+        assertEquals(0, new Version(7, 0, 0).compareTo(new Version(7, 0, 0)));
     }
 
     public void testExceptionEmpty() {
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/doc/RestTestFromSnippetsTaskTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/doc/RestTestFromSnippetsTaskTests.java
index 8f0f12747ffc3..a8e03cc0b0488 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/doc/RestTestFromSnippetsTaskTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/doc/RestTestFromSnippetsTaskTests.java
@@ -23,8 +23,10 @@ public void testSimpleBlockQuote() {
     }
 
     public void testMultipleBlockQuotes() {
-        assertEquals("\"foo\": \"bort baz\", \"bar\": \"other\"",
-            replaceBlockQuote("\"foo\": \"\"\"bort baz\"\"\", \"bar\": \"\"\"other\"\"\""));
+        assertEquals(
+            "\"foo\": \"bort baz\", \"bar\": \"other\"",
+            replaceBlockQuote("\"foo\": \"\"\"bort baz\"\"\", \"bar\": \"\"\"other\"\"\"")
+        );
     }
 
     public void testEscapingInBlockQuote() {
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/http/WaitForHttpResourceTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/http/WaitForHttpResourceTests.java
index 67bae367c6f9f..991f6ff444c45 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/http/WaitForHttpResourceTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/http/WaitForHttpResourceTests.java
@@ -43,7 +43,7 @@ public void testBuildTrustStoreFromFile() throws Exception {
         final Certificate certificate = store.getCertificate("ca");
         assertThat(certificate, notNullValue());
         assertThat(certificate, instanceOf(X509Certificate.class));
-        assertThat(((X509Certificate)certificate).getSubjectDN().toString(), equalTo("CN=Elastic Certificate Tool Autogenerated CA"));
+        assertThat(((X509Certificate) certificate).getSubjectDN().toString(), equalTo("CN=Elastic Certificate Tool Autogenerated CA"));
     }
 
     public void testBuildTrustStoreFromCA() throws Exception {
@@ -55,6 +55,6 @@ public void testBuildTrustStoreFromCA() throws Exception {
         final Certificate certificate = store.getCertificate("cert-0");
         assertThat(certificate, notNullValue());
         assertThat(certificate, instanceOf(X509Certificate.class));
-        assertThat(((X509Certificate)certificate).getSubjectDN().toString(), equalTo("CN=Elastic Certificate Tool Autogenerated CA"));
+        assertThat(((X509Certificate) certificate).getSubjectDN().toString(), equalTo("CN=Elastic Certificate Tool Autogenerated CA"));
     }
 }
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/plugin/PluginBuildPluginTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/plugin/PluginBuildPluginTests.java
index b3dccfbcbc891..113821f97f5e7 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/plugin/PluginBuildPluginTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/plugin/PluginBuildPluginTests.java
@@ -18,38 +18,26 @@ public class PluginBuildPluginTests extends GradleUnitTestCase {
 
     @Before
     public void setUp() throws Exception {
-        project = ProjectBuilder.builder()
-            .withName(getClass().getName())
-            .build();
+        project = ProjectBuilder.builder().withName(getClass().getName()).build();
     }
 
     public void testApply() {
         // FIXME: distribution download plugin doesn't support running externally
-        project.getExtensions().getExtraProperties().set(
-            "bwcVersions", Mockito.mock(BwcVersions.class)
-        );
+        project.getExtensions().getExtraProperties().set("bwcVersions", Mockito.mock(BwcVersions.class));
         project.getPlugins().apply(PluginBuildPlugin.class);
 
         assertNotNull(
             "plugin extension created with the right name",
             project.getExtensions().findByName(PluginBuildPlugin.PLUGIN_EXTENSION_NAME)
         );
-        assertNotNull(
-            "plugin extensions has the right type",
-            project.getExtensions().findByType(PluginPropertiesExtension.class)
-        );
+        assertNotNull("plugin extensions has the right type", project.getExtensions().findByType(PluginPropertiesExtension.class));
 
-        assertNotNull(
-            "plugin created an integTest class",
-            project.getTasks().findByName("integTest")
-        );
+        assertNotNull("plugin created an integTest class", project.getTasks().findByName("integTest"));
     }
 
     @Ignore("https://github.com/elastic/elasticsearch/issues/47123")
     public void testApplyWithAfterEvaluate() {
-        project.getExtensions().getExtraProperties().set(
-            "bwcVersions", Mockito.mock(BwcVersions.class)
-        );
+        project.getExtensions().getExtraProperties().set("bwcVersions", Mockito.mock(BwcVersions.class));
         project.getPlugins().apply(PluginBuildPlugin.class);
         PluginPropertiesExtension extension = project.getExtensions().getByType(PluginPropertiesExtension.class);
         extension.setNoticeFile(project.file("test.notice"));
@@ -60,9 +48,7 @@ public void testApplyWithAfterEvaluate() {
         ((ProjectInternal) project).evaluate();
 
         assertNotNull(
-            "Task to generate notice not created: " + project.getTasks().stream()
-                .map(Task::getPath)
-                .collect(Collectors.joining(", ")),
+            "Task to generate notice not created: " + project.getTasks().stream().map(Task::getPath).collect(Collectors.joining(", ")),
             project.getTasks().findByName("generateNotice")
         );
     }
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/plugin/PluginPropertiesExtensionTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/plugin/PluginPropertiesExtensionTests.java
index b93d400f3e057..a64f2133001b6 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/plugin/PluginPropertiesExtensionTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/plugin/PluginPropertiesExtensionTests.java
@@ -30,8 +30,9 @@ public void testCreatingPluginPropertiesExtensionWithNameAndVersion() {
         String projectName = "Test";
         String projectVersion = "5.0";
 
-        PluginPropertiesExtension pluginPropertiesExtension  =
-                new PluginPropertiesExtension(this.createProject(projectName, projectVersion));
+        PluginPropertiesExtension pluginPropertiesExtension = new PluginPropertiesExtension(
+            this.createProject(projectName, projectVersion)
+        );
 
         assertEquals(projectName, pluginPropertiesExtension.getName());
         assertEquals(projectVersion, pluginPropertiesExtension.getVersion());
@@ -40,8 +41,7 @@ public void testCreatingPluginPropertiesExtensionWithNameAndVersion() {
     public void testCreatingPluginPropertiesExtensionWithNameWithoutVersion() {
         String projectName = "Test";
 
-        PluginPropertiesExtension pluginPropertiesExtension  =
-                new PluginPropertiesExtension(this.createProject(projectName, null));
+        PluginPropertiesExtension pluginPropertiesExtension = new PluginPropertiesExtension(this.createProject(projectName, null));
 
         assertEquals(projectName, pluginPropertiesExtension.getName());
         assertEquals("unspecified", pluginPropertiesExtension.getVersion());
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/DependencyLicensesTaskTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/DependencyLicensesTaskTests.java
index 5492a7cfa9668..fdf44ddaf6967 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/DependencyLicensesTaskTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/DependencyLicensesTaskTests.java
@@ -170,10 +170,7 @@ public void givenProjectWithADependencyWithWrongShaThenShouldThrowException() th
         File licensesDir = getLicensesDir(project);
         createAllDefaultDependencyFiles(licensesDir, "groovy-all");
 
-        Path groovySha = Files
-            .list(licensesDir.toPath())
-            .filter(file -> file.toFile().getName().contains("sha"))
-            .findFirst().get();
+        Path groovySha = Files.list(licensesDir.toPath()).filter(file -> file.toFile().getName().contains("sha")).findFirst().get();
 
         Files.write(groovySha, new byte[] { 1 }, StandardOpenOption.CREATE);
 
@@ -247,16 +244,14 @@ private void createFileIn(File parent, String name, String content) throws IOExc
     }
 
     private UpdateShasTask createUpdateShasTask(Project project, TaskProvider<DependencyLicensesTask> dependencyLicensesTask) {
-        UpdateShasTask task =  project.getTasks()
-            .register("updateShas", UpdateShasTask.class)
-            .get();
+        UpdateShasTask task = project.getTasks().register("updateShas", UpdateShasTask.class).get();
 
         task.setParentTask(dependencyLicensesTask);
         return task;
     }
 
     private TaskProvider<DependencyLicensesTask> createDependencyLicensesTask(Project project) {
-        TaskProvider<DependencyLicensesTask> task =  project.getTasks()
+        TaskProvider<DependencyLicensesTask> task = project.getTasks()
             .register("dependencyLicenses", DependencyLicensesTask.class, new Action<DependencyLicensesTask>() {
                 @Override
                 public void execute(DependencyLicensesTask dependencyLicensesTask) {
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/FilePermissionsTaskTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/FilePermissionsTaskTests.java
index 574545c4361d6..122dae068beee 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/FilePermissionsTaskTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/FilePermissionsTaskTests.java
@@ -55,7 +55,6 @@ public void testCheckPermissionsWhenAnExecutableFileExists() throws Exception {
         file.delete();
     }
 
-
     public void testCheckPermissionsWhenNoFileExists() throws Exception {
         RandomizedTest.assumeFalse("Functionality is Unix specific", Os.isFamily(Os.FAMILY_WINDOWS));
 
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/TestingConventionsTasksIT.java b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/TestingConventionsTasksIT.java
index c6e1e2783cebc..1ac206b2a5d36 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/TestingConventionsTasksIT.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/TestingConventionsTasksIT.java
@@ -26,14 +26,18 @@
 public class TestingConventionsTasksIT extends GradleIntegrationTestCase {
 
     @Before
-    public void setUp() {
-    }
+    public void setUp() {}
 
     public void testInnerClasses() {
-        GradleRunner runner = getGradleRunner("testingConventions")
-            .withArguments("clean", ":no_tests_in_inner_classes:testingConventions", "-i", "-s");
+        GradleRunner runner = getGradleRunner("testingConventions").withArguments(
+            "clean",
+            ":no_tests_in_inner_classes:testingConventions",
+            "-i",
+            "-s"
+        );
         BuildResult result = runner.buildAndFail();
-        assertOutputContains(result.getOutput(),
+        assertOutputContains(
+            result.getOutput(),
             "Test classes implemented by inner classes will not run:",
             "  * org.elasticsearch.gradle.testkit.NastyInnerClasses$LooksLikeATestWithoutNamingConvention1",
             "  * org.elasticsearch.gradle.testkit.NastyInnerClasses$LooksLikeATestWithoutNamingConvention2",
@@ -44,10 +48,15 @@ public void testInnerClasses() {
     }
 
     public void testNamingConvention() {
-        GradleRunner runner = getGradleRunner("testingConventions")
-            .withArguments("clean", ":incorrect_naming_conventions:testingConventions", "-i", "-s");
+        GradleRunner runner = getGradleRunner("testingConventions").withArguments(
+            "clean",
+            ":incorrect_naming_conventions:testingConventions",
+            "-i",
+            "-s"
+        );
         BuildResult result = runner.buildAndFail();
-        assertOutputContains(result.getOutput(),
+        assertOutputContains(
+            result.getOutput(),
             "Seem like test classes but don't match naming convention:",
             "  * org.elasticsearch.gradle.testkit.LooksLikeATestWithoutNamingConvention1",
             "  * org.elasticsearch.gradle.testkit.LooksLikeATestWithoutNamingConvention2",
@@ -57,61 +66,84 @@ public void testNamingConvention() {
     }
 
     public void testNoEmptyTasks() {
-        GradleRunner runner = getGradleRunner("testingConventions")
-            .withArguments("clean", ":empty_test_task:testingConventions", "-i", "-s");
+        GradleRunner runner = getGradleRunner("testingConventions").withArguments(
+            "clean",
+            ":empty_test_task:testingConventions",
+            "-i",
+            "-s"
+        );
         BuildResult result = runner.buildAndFail();
-        assertOutputContains(result.getOutput(),
+        assertOutputContains(
+            result.getOutput(),
             "Expected at least one test class included in task :empty_test_task:emptyTest, but found none.",
             "Expected at least one test class included in task :empty_test_task:test, but found none."
         );
     }
 
     public void testAllTestTasksIncluded() {
-        GradleRunner runner = getGradleRunner("testingConventions")
-            .withArguments("clean", ":all_classes_in_tasks:testingConventions", "-i", "-s");
+        GradleRunner runner = getGradleRunner("testingConventions").withArguments(
+            "clean",
+            ":all_classes_in_tasks:testingConventions",
+            "-i",
+            "-s"
+        );
         BuildResult result = runner.buildAndFail();
-        assertOutputContains(result.getOutput(),
+        assertOutputContains(
+            result.getOutput(),
             "Test classes are not included in any enabled task (:all_classes_in_tasks:test):",
             "  * org.elasticsearch.gradle.testkit.NamingConventionIT"
         );
     }
 
     public void testTaskNotImplementBaseClass() {
-        GradleRunner runner = getGradleRunner("testingConventions")
-            .withArguments("clean", ":not_implementing_base:testingConventions", "-i", "-s");
+        GradleRunner runner = getGradleRunner("testingConventions").withArguments(
+            "clean",
+            ":not_implementing_base:testingConventions",
+            "-i",
+            "-s"
+        );
         BuildResult result = runner.buildAndFail();
-        assertOutputContains(result.getOutput(),
+        assertOutputContains(
+            result.getOutput(),
             "Tests classes with suffix `IT` should extend org.elasticsearch.gradle.testkit.Integration but the following classes do not:",
-                "  * org.elasticsearch.gradle.testkit.NamingConventionIT",
-                "  * org.elasticsearch.gradle.testkit.NamingConventionMissmatchIT",
-                "Tests classes with suffix `Tests` should extend org.elasticsearch.gradle.testkit.Unit but the following classes do not:",
-                "  * org.elasticsearch.gradle.testkit.NamingConventionMissmatchTests",
-                "  * org.elasticsearch.gradle.testkit.NamingConventionTests"
+            "  * org.elasticsearch.gradle.testkit.NamingConventionIT",
+            "  * org.elasticsearch.gradle.testkit.NamingConventionMissmatchIT",
+            "Tests classes with suffix `Tests` should extend org.elasticsearch.gradle.testkit.Unit but the following classes do not:",
+            "  * org.elasticsearch.gradle.testkit.NamingConventionMissmatchTests",
+            "  * org.elasticsearch.gradle.testkit.NamingConventionTests"
         );
     }
 
     public void testValidSetupWithoutBaseClass() {
-        GradleRunner runner = getGradleRunner("testingConventions")
-            .withArguments("clean", ":valid_setup_no_base:testingConventions", "-i", "-s");
+        GradleRunner runner = getGradleRunner("testingConventions").withArguments(
+            "clean",
+            ":valid_setup_no_base:testingConventions",
+            "-i",
+            "-s"
+        );
         BuildResult result = runner.build();
         assertTaskSuccessful(result, ":valid_setup_no_base:testingConventions");
     }
 
     public void testValidSetupWithBaseClass() {
-        GradleRunner runner = getGradleRunner("testingConventions")
-            .withArguments("clean", ":valid_setup_with_base:testingConventions", "-i", "-s");
+        GradleRunner runner = getGradleRunner("testingConventions").withArguments(
+            "clean",
+            ":valid_setup_with_base:testingConventions",
+            "-i",
+            "-s"
+        );
         BuildResult result = runner.build();
         assertTaskSuccessful(result, ":valid_setup_with_base:testingConventions");
     }
 
     public void testTestsInMain() {
-        GradleRunner runner = getGradleRunner("testingConventions")
-            .withArguments("clean", ":tests_in_main:testingConventions", "-i", "-s");
+        GradleRunner runner = getGradleRunner("testingConventions").withArguments("clean", ":tests_in_main:testingConventions", "-i", "-s");
         BuildResult result = runner.buildAndFail();
-        assertOutputContains(result.getOutput(),
-          "Classes matching the test naming convention should be in test not main:",
-              "  * NamingConventionIT",
-              "  * NamingConventionTests"
+        assertOutputContains(
+            result.getOutput(),
+            "Classes matching the test naming convention should be in test not main:",
+            "  * NamingConventionIT",
+            "  * NamingConventionTests"
         );
     }
 
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/ThirdPartyAuditTaskIT.java b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/ThirdPartyAuditTaskIT.java
index a57d6da036583..f2354e0fffc34 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/ThirdPartyAuditTaskIT.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/ThirdPartyAuditTaskIT.java
@@ -27,57 +27,64 @@ public class ThirdPartyAuditTaskIT extends GradleIntegrationTestCase {
     @Before
     public void setUp() throws Exception {
         // Build the sample jars
-        getGradleRunner("thirdPartyAudit")
-            .withArguments("build", "-s")
-            .build();
+        getGradleRunner("thirdPartyAudit").withArguments("build", "-s").build();
     }
 
     public void testElasticsearchIgnored() {
-        BuildResult result = getGradleRunner("thirdPartyAudit")
-            .withArguments("clean", "empty", "-s",
-                "-PcompileOnlyGroup=elasticsearch.gradle:broken-log4j", "-PcompileOnlyVersion=0.0.1",
-                "-PcompileGroup=elasticsearch.gradle:dummy-io", "-PcompileVersion=0.0.1"
-            )
-            .build();
+        BuildResult result = getGradleRunner("thirdPartyAudit").withArguments(
+            "clean",
+            "empty",
+            "-s",
+            "-PcompileOnlyGroup=elasticsearch.gradle:broken-log4j",
+            "-PcompileOnlyVersion=0.0.1",
+            "-PcompileGroup=elasticsearch.gradle:dummy-io",
+            "-PcompileVersion=0.0.1"
+        ).build();
         assertTaskNoSource(result, ":empty");
     }
 
     public void testWithEmptyRules() {
-        BuildResult result = getGradleRunner("thirdPartyAudit")
-            .withArguments("clean", "empty", "-s",
-                "-PcompileOnlyGroup=other.gradle:broken-log4j", "-PcompileOnlyVersion=0.0.1",
-                "-PcompileGroup=other.gradle:dummy-io", "-PcompileVersion=0.0.1"
-            )
-            .buildAndFail();
+        BuildResult result = getGradleRunner("thirdPartyAudit").withArguments(
+            "clean",
+            "empty",
+            "-s",
+            "-PcompileOnlyGroup=other.gradle:broken-log4j",
+            "-PcompileOnlyVersion=0.0.1",
+            "-PcompileGroup=other.gradle:dummy-io",
+            "-PcompileVersion=0.0.1"
+        ).buildAndFail();
     }
 
     public void testViolationFoundAndCompileOnlyIgnored() {
-        BuildResult result = getGradleRunner("thirdPartyAudit")
-            .withArguments("clean", "absurd", "-s",
-                "-PcompileOnlyGroup=other.gradle:broken-log4j", "-PcompileOnlyVersion=0.0.1",
-                "-PcompileGroup=other.gradle:dummy-io", "-PcompileVersion=0.0.1"
-            )
-            .buildAndFail();
+        BuildResult result = getGradleRunner("thirdPartyAudit").withArguments(
+            "clean",
+            "absurd",
+            "-s",
+            "-PcompileOnlyGroup=other.gradle:broken-log4j",
+            "-PcompileOnlyVersion=0.0.1",
+            "-PcompileGroup=other.gradle:dummy-io",
+            "-PcompileVersion=0.0.1"
+        ).buildAndFail();
 
         assertTaskFailed(result, ":absurd");
-        assertOutputContains(result.getOutput(),
-            "Classes with violations:",
-            "  * TestingIO",
-            "> Audit of third party dependencies failed"
-        );
-        assertOutputDoesNotContain(result.getOutput(),"Missing classes:");
+        assertOutputContains(result.getOutput(), "Classes with violations:", "  * TestingIO", "> Audit of third party dependencies failed");
+        assertOutputDoesNotContain(result.getOutput(), "Missing classes:");
     }
 
     public void testClassNotFoundAndCompileOnlyIgnored() {
-        BuildResult result = getGradleRunner("thirdPartyAudit")
-            .withArguments("clean", "absurd", "-s",
-                "-PcompileGroup=other.gradle:broken-log4j", "-PcompileVersion=0.0.1",
-                "-PcompileOnlyGroup=other.gradle:dummy-io", "-PcompileOnlyVersion=0.0.1"
-            )
-            .buildAndFail();
+        BuildResult result = getGradleRunner("thirdPartyAudit").withArguments(
+            "clean",
+            "absurd",
+            "-s",
+            "-PcompileGroup=other.gradle:broken-log4j",
+            "-PcompileVersion=0.0.1",
+            "-PcompileOnlyGroup=other.gradle:dummy-io",
+            "-PcompileOnlyVersion=0.0.1"
+        ).buildAndFail();
         assertTaskFailed(result, ":absurd");
 
-        assertOutputContains(result.getOutput(),
+        assertOutputContains(
+            result.getOutput(),
             "Missing classes:",
             "  * org.apache.logging.log4j.LogManager",
             "> Audit of third party dependencies failed"
@@ -86,15 +93,19 @@ public void testClassNotFoundAndCompileOnlyIgnored() {
     }
 
     public void testJarHellWithJDK() {
-        BuildResult result = getGradleRunner("thirdPartyAudit")
-            .withArguments("clean", "absurd", "-s",
-                "-PcompileGroup=other.gradle:jarhellJdk", "-PcompileVersion=0.0.1",
-                "-PcompileOnlyGroup=other.gradle:dummy-io", "-PcompileOnlyVersion=0.0.1"
-            )
-            .buildAndFail();
+        BuildResult result = getGradleRunner("thirdPartyAudit").withArguments(
+            "clean",
+            "absurd",
+            "-s",
+            "-PcompileGroup=other.gradle:jarhellJdk",
+            "-PcompileVersion=0.0.1",
+            "-PcompileOnlyGroup=other.gradle:dummy-io",
+            "-PcompileOnlyVersion=0.0.1"
+        ).buildAndFail();
         assertTaskFailed(result, ":absurd");
 
-        assertOutputContains(result.getOutput(),
+        assertOutputContains(
+            result.getOutput(),
             "> Audit of third party dependencies failed:",
             "   Jar Hell with the JDK:",
             "    * java.lang.String"
@@ -103,12 +114,15 @@ public void testJarHellWithJDK() {
     }
 
     public void testElasticsearchIgnoredWithViolations() {
-        BuildResult result = getGradleRunner("thirdPartyAudit")
-            .withArguments("clean", "absurd", "-s",
-                "-PcompileOnlyGroup=elasticsearch.gradle:broken-log4j", "-PcompileOnlyVersion=0.0.1",
-                "-PcompileGroup=elasticsearch.gradle:dummy-io", "-PcompileVersion=0.0.1"
-            )
-            .build();
+        BuildResult result = getGradleRunner("thirdPartyAudit").withArguments(
+            "clean",
+            "absurd",
+            "-s",
+            "-PcompileOnlyGroup=elasticsearch.gradle:broken-log4j",
+            "-PcompileOnlyVersion=0.0.1",
+            "-PcompileGroup=elasticsearch.gradle:dummy-io",
+            "-PcompileVersion=0.0.1"
+        ).build();
         assertTaskNoSource(result, ":absurd");
     }
 
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/UpdateShasTaskTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/UpdateShasTaskTests.java
index 1cf523e2e62d8..363bc9c344af8 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/UpdateShasTaskTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/precommit/UpdateShasTaskTests.java
@@ -45,8 +45,7 @@ public void prepare() throws IOException {
     }
 
     @Test
-    public void whenDependencyDoesntExistThenShouldDeleteDependencySha()
-        throws IOException, NoSuchAlgorithmException {
+    public void whenDependencyDoesntExistThenShouldDeleteDependencySha() throws IOException, NoSuchAlgorithmException {
 
         File unusedSha = createFileIn(getLicensesDir(project), "test.sha1", "");
         task.updateShas();
@@ -55,23 +54,19 @@ public void whenDependencyDoesntExistThenShouldDeleteDependencySha()
     }
 
     @Test
-    public void whenDependencyExistsButShaNotThenShouldCreateNewShaFile()
-        throws IOException, NoSuchAlgorithmException {
+    public void whenDependencyExistsButShaNotThenShouldCreateNewShaFile() throws IOException, NoSuchAlgorithmException {
         project.getDependencies().add("compile", dependency);
 
         getLicensesDir(project).mkdir();
         task.updateShas();
 
-        Path groovySha = Files
-            .list(getLicensesDir(project).toPath())
-            .findFirst().get();
+        Path groovySha = Files.list(getLicensesDir(project).toPath()).findFirst().get();
 
         assertTrue(groovySha.toFile().getName().startsWith("groovy-all"));
     }
 
     @Test
-    public void whenDependencyAndWrongShaExistsThenShouldNotOverwriteShaFile()
-        throws IOException, NoSuchAlgorithmException {
+    public void whenDependencyAndWrongShaExistsThenShouldNotOverwriteShaFile() throws IOException, NoSuchAlgorithmException {
         project.getDependencies().add("compile", dependency);
 
         File groovyJar = task.getParentTask().getDependencies().getFiles().iterator().next();
@@ -84,8 +79,7 @@ public void whenDependencyAndWrongShaExistsThenShouldNotOverwriteShaFile()
     }
 
     @Test
-    public void whenLicensesDirDoesntExistThenShouldThrowException()
-        throws IOException, NoSuchAlgorithmException {
+    public void whenLicensesDirDoesntExistThenShouldThrowException() throws IOException, NoSuchAlgorithmException {
         expectedException.expect(GradleException.class);
         expectedException.expectMessage(containsString("isn't a valid directory"));
 
@@ -119,16 +113,14 @@ private File createFileIn(File parent, String name, String content) throws IOExc
     }
 
     private UpdateShasTask createUpdateShasTask(Project project) {
-        UpdateShasTask task =  project.getTasks()
-            .register("updateShas", UpdateShasTask.class)
-            .get();
+        UpdateShasTask task = project.getTasks().register("updateShas", UpdateShasTask.class).get();
 
         task.setParentTask(createDependencyLicensesTask(project));
         return task;
     }
 
     private TaskProvider<DependencyLicensesTask> createDependencyLicensesTask(Project project) {
-        TaskProvider<DependencyLicensesTask> task =  project.getTasks()
+        TaskProvider<DependencyLicensesTask> task = project.getTasks()
             .register("dependencyLicenses", DependencyLicensesTask.class, new Action<DependencyLicensesTask>() {
                 @Override
                 public void execute(DependencyLicensesTask dependencyLicensesTask) {
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingTarIT.java b/buildSrc/src/test/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingTarIT.java
index c7b59f64252e9..c5bbfc7c3d554 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingTarIT.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/tar/SymbolicLinkPreservingTarIT.java
@@ -74,8 +74,8 @@ interface FileInputStreamWrapper {
         InputStream apply(FileInputStream fis) throws IOException;
     }
 
-    private void assertTar(
-        final String extension, final FileInputStreamWrapper wrapper, boolean preserveFileTimestamps) throws IOException {
+    private void assertTar(final String extension, final FileInputStreamWrapper wrapper, boolean preserveFileTimestamps)
+        throws IOException {
         try (TarArchiveInputStream tar = new TarArchiveInputStream(wrapper.apply(new FileInputStream(getOutputFile(extension))))) {
             TarArchiveEntry entry = tar.getNextTarEntry();
             boolean realFolderEntry = false;
@@ -93,27 +93,18 @@ private void assertTar(
                     fileEntry = true;
                 } else if (entry.getName().equals("real-folder/link-to-file")) {
                     assertTrue(entry.isSymbolicLink());
-                    assertThat(
-                        entry.getLinkName(),
-                        anyOf(equalTo("./file"), equalTo(".\\file"))
-                    );
+                    assertThat(entry.getLinkName(), anyOf(equalTo("./file"), equalTo(".\\file")));
                     linkToFileEntry = true;
                 } else if (entry.getName().equals("link-in-folder/")) {
                     assertTrue(entry.isDirectory());
                     linkInFolderEntry = true;
                 } else if (entry.getName().equals("link-in-folder/link-to-file")) {
                     assertTrue(entry.isSymbolicLink());
-                    assertThat(
-                        entry.getLinkName(),
-                        anyOf(equalTo("../real-folder/file"), equalTo("..\\real-folder\\file"))
-                    );
+                    assertThat(entry.getLinkName(), anyOf(equalTo("../real-folder/file"), equalTo("..\\real-folder\\file")));
                     linkInFolderLinkToFileEntry = true;
                 } else if (entry.getName().equals("link-to-real-folder")) {
                     assertTrue(entry.isSymbolicLink());
-                    assertThat(
-                        entry.getLinkName(),
-                        anyOf(equalTo("./real-folder"), equalTo(".\\real-folder"))
-                    );
+                    assertThat(entry.getLinkName(), anyOf(equalTo("./real-folder"), equalTo(".\\real-folder")));
                     linkToRealFolderEntry = true;
                 } else {
                     throw new GradleException("unexpected entry [" + entry.getName() + "]");
@@ -135,12 +126,14 @@ private void assertTar(
     }
 
     private void runBuild(final String task, final boolean preserveFileTimestamps) {
-        final GradleRunner runner = GradleRunner.create().withProjectDir(getProjectDir())
+        final GradleRunner runner = GradleRunner.create()
+            .withProjectDir(getProjectDir())
             .withArguments(
                 task,
                 "-Dtests.symbolic_link_preserving_tar_source=" + temporaryFolder.getRoot().toString(),
                 "-Dtests.symbolic_link_preserving_tar_preserve_file_timestamps=" + preserveFileTimestamps,
-                "-i")
+                "-i"
+            )
             .withPluginClasspath();
 
         runner.build();
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/test/BaseTestCase.java b/buildSrc/src/test/java/org/elasticsearch/gradle/test/BaseTestCase.java
index 0fc26f0284c44..1f77aa803c3b3 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/test/BaseTestCase.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/test/BaseTestCase.java
@@ -27,10 +27,7 @@
 import org.junit.runner.RunWith;
 
 @RunWith(RandomizedRunner.class)
-@TestMethodProviders({
-    JUnit4MethodProvider.class,
-    JUnit3MethodProvider.class
-})
+@TestMethodProviders({ JUnit4MethodProvider.class, JUnit3MethodProvider.class })
 @ThreadLeakLingering(linger = 5000) // wait for "Connection worker" to die
 public abstract class BaseTestCase extends Assert {
 
@@ -39,6 +36,7 @@ public abstract class BaseTestCase extends Assert {
     public interface ThrowingRunnable {
         void run() throws Throwable;
     }
+
     public static <T extends Throwable> T expectThrows(Class<T> expectedType, ThrowingRunnable runnable) {
         try {
             runnable.run();
@@ -46,11 +44,12 @@ public static <T extends Throwable> T expectThrows(Class<T> expectedType, Throwi
             if (expectedType.isInstance(e)) {
                 return expectedType.cast(e);
             }
-            AssertionFailedError assertion =
-                new AssertionFailedError("Unexpected exception type, expected " + expectedType.getSimpleName() + " but got " + e);
+            AssertionFailedError assertion = new AssertionFailedError(
+                "Unexpected exception type, expected " + expectedType.getSimpleName() + " but got " + e
+            );
             assertion.initCause(e);
             throw assertion;
         }
-        throw new AssertionFailedError("Expected exception "+ expectedType.getSimpleName() + " but no exception was thrown");
+        throw new AssertionFailedError("Expected exception " + expectedType.getSimpleName() + " but no exception was thrown");
     }
 }
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/test/DistroTestPluginTests.java b/buildSrc/src/test/java/org/elasticsearch/gradle/test/DistroTestPluginTests.java
index f88a4c11415bc..96b6208be7205 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/test/DistroTestPluginTests.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/test/DistroTestPluginTests.java
@@ -11,23 +11,22 @@
 public class DistroTestPluginTests extends GradleIntegrationTestCase {
 
     public void testParseOsReleaseOnOracle() {
-        final List<String> lines = List
-            .of(
-                "NAME=\"Oracle Linux Server\"",
-                "VERSION=\"6.10\"",
-                "ID=\"ol\"",
-                "VERSION_ID=\"6.10\"",
-                "PRETTY_NAME=\"Oracle Linux Server 6.10\"",
-                "ANSI_COLOR=\"0;31\"",
-                "CPE_NAME=\"cpe:/o:oracle:linux:6:10:server\"",
-                "HOME_URL" + "=\"https://linux.oracle.com/\"",
-                "BUG_REPORT_URL=\"https://bugzilla.oracle.com/\"",
-                "",
-                "ORACLE_BUGZILLA_PRODUCT" + "=\"Oracle Linux 6\"",
-                "ORACLE_BUGZILLA_PRODUCT_VERSION=6.10",
-                "ORACLE_SUPPORT_PRODUCT=\"Oracle Linux\"",
-                "ORACLE_SUPPORT_PRODUCT_VERSION=6.10"
-            );
+        final List<String> lines = List.of(
+            "NAME=\"Oracle Linux Server\"",
+            "VERSION=\"6.10\"",
+            "ID=\"ol\"",
+            "VERSION_ID=\"6.10\"",
+            "PRETTY_NAME=\"Oracle Linux Server 6.10\"",
+            "ANSI_COLOR=\"0;31\"",
+            "CPE_NAME=\"cpe:/o:oracle:linux:6:10:server\"",
+            "HOME_URL" + "=\"https://linux.oracle.com/\"",
+            "BUG_REPORT_URL=\"https://bugzilla.oracle.com/\"",
+            "",
+            "ORACLE_BUGZILLA_PRODUCT" + "=\"Oracle Linux 6\"",
+            "ORACLE_BUGZILLA_PRODUCT_VERSION=6.10",
+            "ORACLE_SUPPORT_PRODUCT=\"Oracle Linux\"",
+            "ORACLE_SUPPORT_PRODUCT_VERSION=6.10"
+        );
 
         final Map<String, String> results = parseOsRelease(lines);
 
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/test/GradleIntegrationTestCase.java b/buildSrc/src/test/java/org/elasticsearch/gradle/test/GradleIntegrationTestCase.java
index 6c8795cbdab04..8f0f2e69551cf 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/test/GradleIntegrationTestCase.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/test/GradleIntegrationTestCase.java
@@ -26,8 +26,10 @@ public abstract class GradleIntegrationTestCase extends GradleUnitTestCase {
     protected File getProjectDir(String name) {
         File root = new File("src/testKit/");
         if (root.exists() == false) {
-            throw new RuntimeException("Could not find resources dir for integration tests. " +
-                "Note that these tests can only be ran by Gradle and are not currently supported by the IDE");
+            throw new RuntimeException(
+                "Could not find resources dir for integration tests. "
+                    + "Note that these tests can only be ran by Gradle and are not currently supported by the IDE"
+            );
         }
         return new File(root, name).getAbsoluteFile();
     }
@@ -39,10 +41,7 @@ protected GradleRunner getGradleRunner(String sampleProject) {
         } catch (IOException e) {
             throw new UncheckedIOException(e);
         }
-        return GradleRunner.create()
-            .withProjectDir(getProjectDir(sampleProject))
-            .withPluginClasspath()
-            .withTestKitDir(testkit);
+        return GradleRunner.create().withProjectDir(getProjectDir(sampleProject)).withPluginClasspath().withTestKitDir(testkit);
     }
 
     protected File getBuildDir(String name) {
@@ -55,9 +54,12 @@ protected void assertOutputContains(String output, String... lines) {
         }
         List<Integer> index = Stream.of(lines).map(line -> output.indexOf(line)).collect(Collectors.toList());
         if (index.equals(index.stream().sorted().collect(Collectors.toList())) == false) {
-            fail("Expected the following lines to appear in this order:\n" +
-                Stream.of(lines).map(line -> "   - `" + line + "`").collect(Collectors.joining("\n")) +
-                "\nTBut the order was different. Output is:\n\n```" + output + "\n```\n"
+            fail(
+                "Expected the following lines to appear in this order:\n"
+                    + Stream.of(lines).map(line -> "   - `" + line + "`").collect(Collectors.joining("\n"))
+                    + "\nTBut the order was different. Output is:\n\n```"
+                    + output
+                    + "\n```\n"
             );
         }
     }
@@ -69,17 +71,11 @@ protected void assertOutputContains(String output, Set<String> lines) {
     }
 
     protected void assertOutputContains(String output, String line) {
-        assertTrue(
-            "Expected the following line in output:\n\n" + line + "\n\nOutput is:\n" + output,
-            output.contains(line)
-        );
+        assertTrue("Expected the following line in output:\n\n" + line + "\n\nOutput is:\n" + output, output.contains(line));
     }
 
     protected void assertOutputDoesNotContain(String output, String line) {
-        assertFalse(
-            "Expected the following line not to be in output:\n\n" + line + "\n\nOutput is:\n" + output,
-            output.contains(line)
-        );
+        assertFalse("Expected the following line not to be in output:\n\n" + line + "\n\nOutput is:\n" + output, output.contains(line));
     }
 
     protected void assertOutputDoesNotContain(String output, String... lines) {
@@ -113,12 +109,19 @@ protected void assertTaskNoSource(BuildResult result, String... taskNames) {
     private void assertTaskOutcome(BuildResult result, String taskName, TaskOutcome taskOutcome) {
         BuildTask task = result.task(taskName);
         if (task == null) {
-            fail("Expected task `" + taskName + "` to be " + taskOutcome +", but it did not run" +
-                "\n\nOutput is:\n" + result.getOutput());
+            fail(
+                "Expected task `" + taskName + "` to be " + taskOutcome + ", but it did not run" + "\n\nOutput is:\n" + result.getOutput()
+            );
         }
         assertEquals(
-            "Expected task `" + taskName +"` to be " + taskOutcome + " but it was: " + task.getOutcome() +
-                "\n\nOutput is:\n" + result.getOutput() ,
+            "Expected task `"
+                + taskName
+                + "` to be "
+                + taskOutcome
+                + " but it was: "
+                + task.getOutcome()
+                + "\n\nOutput is:\n"
+                + result.getOutput(),
             taskOutcome,
             task.getOutcome()
         );
@@ -131,8 +134,7 @@ protected void assertTaskUpToDate(BuildResult result, String... taskNames) {
                 fail("Expected task `" + taskName + "` to be up-to-date, but it did not run");
             }
             assertEquals(
-                "Expected task to be up to date but it was: " + task.getOutcome() +
-                    "\n\nOutput is:\n" + result.getOutput(),
+                "Expected task to be up to date but it was: " + task.getOutcome() + "\n\nOutput is:\n" + result.getOutput(),
                 TaskOutcome.UP_TO_DATE,
                 task.getOutcome()
             );
@@ -142,8 +144,7 @@ protected void assertTaskUpToDate(BuildResult result, String... taskNames) {
     protected void assertBuildFileExists(BuildResult result, String projectName, String path) {
         Path absPath = getBuildDir(projectName).toPath().resolve(path);
         assertTrue(
-            result.getOutput() + "\n\nExpected `" + absPath + "` to exists but it did not" +
-                "\n\nOutput is:\n" + result.getOutput(),
+            result.getOutput() + "\n\nExpected `" + absPath + "` to exists but it did not" + "\n\nOutput is:\n" + result.getOutput(),
             Files.exists(absPath)
         );
     }
@@ -151,8 +152,7 @@ protected void assertBuildFileExists(BuildResult result, String projectName, Str
     protected void assertBuildFileDoesNotExists(BuildResult result, String projectName, String path) {
         Path absPath = getBuildDir(projectName).toPath().resolve(path);
         assertFalse(
-            result.getOutput() + "\n\nExpected `" + absPath + "` bo to exists but it did" +
-                "\n\nOutput is:\n" + result.getOutput(),
+            result.getOutput() + "\n\nExpected `" + absPath + "` bo to exists but it did" + "\n\nOutput is:\n" + result.getOutput(),
             Files.exists(absPath)
         );
     }
@@ -177,12 +177,11 @@ private String getLocalTestPath(String propertyName) {
     public void assertOutputOnlyOnce(String output, String... text) {
         for (String each : text) {
             int i = output.indexOf(each);
-            if (i == -1 ) {
-                fail("Expected \n```" + each + "```\nto appear at most once, but it didn't at all.\n\nOutout is:\n"+ output
-                );
+            if (i == -1) {
+                fail("Expected \n```" + each + "```\nto appear at most once, but it didn't at all.\n\nOutout is:\n" + output);
             }
-            if(output.indexOf(each) !=  output.lastIndexOf(each)) {
-                fail("Expected `" + each + "` to appear at most once, but it did multiple times.\n\nOutout is:\n"+ output);
+            if (output.indexOf(each) != output.lastIndexOf(each)) {
+                fail("Expected `" + each + "` to appear at most once, but it did multiple times.\n\nOutout is:\n" + output);
             }
         }
     }
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/test/GradleUnitTestCase.java b/buildSrc/src/test/java/org/elasticsearch/gradle/test/GradleUnitTestCase.java
index 58852230bb7e6..543469e6ff5f1 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/test/GradleUnitTestCase.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/test/GradleUnitTestCase.java
@@ -7,12 +7,6 @@
 import org.junit.runner.RunWith;
 
 @RunWith(RandomizedRunner.class)
-@TestMethodProviders({
-    JUnit4MethodProvider.class,
-    JUnit3MethodProvider.class
-})
-@ThreadLeakFilters(defaultFilters = true, filters = {
-    GradleThreadsFilter.class
-})
-public abstract class GradleUnitTestCase extends BaseTestCase  {
-}
+@TestMethodProviders({ JUnit4MethodProvider.class, JUnit3MethodProvider.class })
+@ThreadLeakFilters(defaultFilters = true, filters = { GradleThreadsFilter.class })
+public abstract class GradleUnitTestCase extends BaseTestCase {}
diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/test/JUnit3MethodProvider.java b/buildSrc/src/test/java/org/elasticsearch/gradle/test/JUnit3MethodProvider.java
index 18871e16555ef..4b3384eb117c3 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/test/JUnit3MethodProvider.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/test/JUnit3MethodProvider.java
@@ -36,17 +36,18 @@
 public final class JUnit3MethodProvider implements TestMethodProvider {
     @Override
     public Collection<Method> getTestMethods(Class<?> suiteClass, ClassModel classModel) {
-        Map<Method,MethodModel> methods = classModel.getMethods();
+        Map<Method, MethodModel> methods = classModel.getMethods();
         ArrayList<Method> result = new ArrayList<>();
         for (MethodModel mm : methods.values()) {
             // Skip any methods that have overrieds/ shadows.
-            if (mm.getDown() != null) continue;
+            if (mm.getDown() != null)
+                continue;
 
             Method m = mm.element;
-            if (m.getName().startsWith("test") &&
-                Modifier.isPublic(m.getModifiers()) &&
-                !Modifier.isStatic(m.getModifiers()) &&
-                m.getParameterTypes().length == 0) {
+            if (m.getName().startsWith("test")
+                && Modifier.isPublic(m.getModifiers())
+                && !Modifier.isStatic(m.getModifiers())
+                && m.getParameterTypes().length == 0) {
                 result.add(m);
             }
         }
diff --git a/buildSrc/src/testKit/testingConventions/all_classes_in_tasks/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java b/buildSrc/src/testKit/testingConventions/all_classes_in_tasks/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
index 48a4f7adfd99e..a78b438abfd5a 100644
--- a/buildSrc/src/testKit/testingConventions/all_classes_in_tasks/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
+++ b/buildSrc/src/testKit/testingConventions/all_classes_in_tasks/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
@@ -20,4 +20,4 @@
 
 public class NamingConventionIT {
 
-}
\ No newline at end of file
+}
diff --git a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeATestWithoutNamingConvention1.java b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeATestWithoutNamingConvention1.java
index 35d60d8a56b53..fa5295e926b78 100644
--- a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeATestWithoutNamingConvention1.java
+++ b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeATestWithoutNamingConvention1.java
@@ -27,4 +27,4 @@ public void annotatedTestMethod() {
 
     }
 
-}
\ No newline at end of file
+}
diff --git a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeATestWithoutNamingConvention3.java b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeATestWithoutNamingConvention3.java
index 4a946c3aeb0ae..253559bb59ae5 100644
--- a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeATestWithoutNamingConvention3.java
+++ b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeATestWithoutNamingConvention3.java
@@ -18,13 +18,10 @@
  */
 package org.elasticsearch.gradle.testkit;
 
-import org.junit.Assert;
-import org.junit.Test;
-
 public class LooksLikeATestWithoutNamingConvention3 {
 
     public void testMethod() {
 
     }
 
-}
\ No newline at end of file
+}
diff --git a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeTestsButAbstract.java b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeTestsButAbstract.java
index 15718cff841e1..49a327480579a 100644
--- a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeTestsButAbstract.java
+++ b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/LooksLikeTestsButAbstract.java
@@ -18,9 +18,6 @@
  */
 package org.elasticsearch.gradle.testkit;
 
-import org.junit.Assert;
-import org.junit.Test;
-
 public abstract class LooksLikeTestsButAbstract {
 
     public void testMethod() {
diff --git a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
index 48a4f7adfd99e..a78b438abfd5a 100644
--- a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
+++ b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
@@ -20,4 +20,4 @@
 
 public class NamingConventionIT {
 
-}
\ No newline at end of file
+}
diff --git a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionTests.java b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionTests.java
index 95152520a3f2d..6afb89ddf56b0 100644
--- a/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionTests.java
+++ b/buildSrc/src/testKit/testingConventions/incorrect_naming_conventions/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionTests.java
@@ -20,4 +20,4 @@
 
 public class NamingConventionTests {
 
-}
\ No newline at end of file
+}
diff --git a/buildSrc/src/testKit/testingConventions/not_implementing_base/src/test/java/org/elasticsearch/gradle/testkit/Integration.java b/buildSrc/src/testKit/testingConventions/not_implementing_base/src/test/java/org/elasticsearch/gradle/testkit/Integration.java
index 80522be3fb5ab..508adc24bc73a 100644
--- a/buildSrc/src/testKit/testingConventions/not_implementing_base/src/test/java/org/elasticsearch/gradle/testkit/Integration.java
+++ b/buildSrc/src/testKit/testingConventions/not_implementing_base/src/test/java/org/elasticsearch/gradle/testkit/Integration.java
@@ -19,5 +19,5 @@
 package org.elasticsearch.gradle.testkit;
 
 public class Integration {
-    
+
 }
diff --git a/buildSrc/src/testKit/testingConventions/not_implementing_base/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java b/buildSrc/src/testKit/testingConventions/not_implementing_base/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
index 48a4f7adfd99e..a78b438abfd5a 100644
--- a/buildSrc/src/testKit/testingConventions/not_implementing_base/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
+++ b/buildSrc/src/testKit/testingConventions/not_implementing_base/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
@@ -20,4 +20,4 @@
 
 public class NamingConventionIT {
 
-}
\ No newline at end of file
+}
diff --git a/buildSrc/src/testKit/testingConventions/tests_in_main/src/main/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java b/buildSrc/src/testKit/testingConventions/tests_in_main/src/main/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
index 48a4f7adfd99e..a78b438abfd5a 100644
--- a/buildSrc/src/testKit/testingConventions/tests_in_main/src/main/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
+++ b/buildSrc/src/testKit/testingConventions/tests_in_main/src/main/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
@@ -20,4 +20,4 @@
 
 public class NamingConventionIT {
 
-}
\ No newline at end of file
+}
diff --git a/buildSrc/src/testKit/testingConventions/valid_setup_no_base/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java b/buildSrc/src/testKit/testingConventions/valid_setup_no_base/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
index 48a4f7adfd99e..a78b438abfd5a 100644
--- a/buildSrc/src/testKit/testingConventions/valid_setup_no_base/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
+++ b/buildSrc/src/testKit/testingConventions/valid_setup_no_base/src/test/java/org/elasticsearch/gradle/testkit/NamingConventionIT.java
@@ -20,4 +20,4 @@
 
 public class NamingConventionIT {
 
-}
\ No newline at end of file
+}
diff --git a/buildSrc/src/testKit/thirdPartyAudit/sample_jars/src/main/java/TestingIO.java b/buildSrc/src/testKit/thirdPartyAudit/sample_jars/src/main/java/TestingIO.java
index e4d8a0bbe0f87..eeda1f2b7b23a 100644
--- a/buildSrc/src/testKit/thirdPartyAudit/sample_jars/src/main/java/TestingIO.java
+++ b/buildSrc/src/testKit/thirdPartyAudit/sample_jars/src/main/java/TestingIO.java
@@ -5,4 +5,3 @@ public TestingIO() {
         new File("foo");
     }
 }
-
diff --git a/x-pack/plugin/enrich/qa/common/src/main/java/org/elasticsearch/test/enrich/CommonEnrichRestTestCase.java b/x-pack/plugin/enrich/qa/common/src/main/java/org/elasticsearch/test/enrich/CommonEnrichRestTestCase.java
index 9ab357f23499e..39c331008ff46 100644
--- a/x-pack/plugin/enrich/qa/common/src/main/java/org/elasticsearch/test/enrich/CommonEnrichRestTestCase.java
+++ b/x-pack/plugin/enrich/qa/common/src/main/java/org/elasticsearch/test/enrich/CommonEnrichRestTestCase.java
@@ -34,11 +34,10 @@ public abstract class CommonEnrichRestTestCase extends ESRestTestCase {
     public void deletePolicies() throws Exception {
         Map<String, Object> responseMap = toMap(adminClient().performRequest(new Request("GET", "/_enrich/policy")));
         @SuppressWarnings("unchecked")
-        List<Map<?,?>> policies = (List<Map<?,?>>) responseMap.get("policies");
+        List<Map<?, ?>> policies = (List<Map<?, ?>>) responseMap.get("policies");
 
-        for (Map<?, ?> entry: policies) {
-            client().performRequest(new Request("DELETE", "/_enrich/policy/" +
-                XContentMapValues.extractValue("config.match.name", entry)));
+        for (Map<?, ?> entry : policies) {
+            client().performRequest(new Request("DELETE", "/_enrich/policy/" + XContentMapValues.extractValue("config.match.name", entry)));
 
             List<?> sourceIndices = (List<?>) XContentMapValues.extractValue("config.match.indices", entry);
             for (Object sourceIndex : sourceIndices) {
@@ -72,9 +71,9 @@ private void setupGenericLifecycleTest(boolean deletePipeilne) throws Exception
 
         // Create pipeline
         Request putPipelineRequest = new Request("PUT", "/_ingest/pipeline/my_pipeline");
-        putPipelineRequest.setJsonEntity("{\"processors\":[" +
-            "{\"enrich\":{\"policy_name\":\"my_policy\",\"field\":\"host\",\"target_field\":\"entry\"}}" +
-            "]}");
+        putPipelineRequest.setJsonEntity(
+            "{\"processors\":[" + "{\"enrich\":{\"policy_name\":\"my_policy\",\"field\":\"host\",\"target_field\":\"entry\"}}" + "]}"
+        );
         assertOK(client().performRequest(putPipelineRequest));
 
         // Index document using pipeline with enrich processor:
@@ -120,8 +119,10 @@ public void testDeleteIsCaseSensitive() throws Exception {
         putPolicyRequest.setJsonEntity(generatePolicySource("my-source-index"));
         assertOK(client().performRequest(putPolicyRequest));
 
-        ResponseException exc = expectThrows(ResponseException.class,
-            () -> client().performRequest(new Request("DELETE", "/_enrich/policy/MY_POLICY")));
+        ResponseException exc = expectThrows(
+            ResponseException.class,
+            () -> client().performRequest(new Request("DELETE", "/_enrich/policy/MY_POLICY"))
+        );
         assertTrue(exc.getMessage().contains("policy [MY_POLICY] not found"));
     }
 
@@ -130,15 +131,19 @@ public void testDeleteExistingPipeline() throws Exception {
         setupGenericLifecycleTest(false);
 
         Request putPipelineRequest = new Request("PUT", "/_ingest/pipeline/another_pipeline");
-        putPipelineRequest.setJsonEntity("{\"processors\":[" +
-            "{\"enrich\":{\"policy_name\":\"my_policy\",\"field\":\"host\",\"target_field\":\"entry\"}}" +
-            "]}");
+        putPipelineRequest.setJsonEntity(
+            "{\"processors\":[" + "{\"enrich\":{\"policy_name\":\"my_policy\",\"field\":\"host\",\"target_field\":\"entry\"}}" + "]}"
+        );
         assertOK(client().performRequest(putPipelineRequest));
 
-        ResponseException exc = expectThrows(ResponseException.class,
-            () -> client().performRequest(new Request("DELETE", "/_enrich/policy/my_policy")));
-        assertTrue(exc.getMessage().contains("Could not delete policy [my_policy] because" +
-            " a pipeline is referencing it [my_pipeline, another_pipeline]"));
+        ResponseException exc = expectThrows(
+            ResponseException.class,
+            () -> client().performRequest(new Request("DELETE", "/_enrich/policy/my_policy"))
+        );
+        assertTrue(
+            exc.getMessage()
+                .contains("Could not delete policy [my_policy] because" + " a pipeline is referencing it [my_pipeline, another_pipeline]")
+        );
 
         // delete the pipelines so the policies can be deleted
         client().performRequest(new Request("DELETE", "/_ingest/pipeline/my_pipeline"));
@@ -157,7 +162,7 @@ public static String generatePolicySource(String index) throws IOException {
                 source.field("query", QueryBuilders.matchAllQuery());
             }
             source.field("match_field", "host");
-            source.field("enrich_fields", new String[] {"globalRank", "tldRank", "tld"});
+            source.field("enrich_fields", new String[] { "globalRank", "tldRank", "tld" });
         }
         source.endObject().endObject();
         return Strings.toString(source);
@@ -169,12 +174,12 @@ public static void createSourceIndex(String index) throws IOException {
     }
 
     public static String createSourceIndexMapping() {
-        return "\"properties\":" +
-            "{\"host\": {\"type\":\"keyword\"}," +
-            "\"globalRank\":{\"type\":\"keyword\"}," +
-            "\"tldRank\":{\"type\":\"keyword\"}," +
-            "\"tld\":{\"type\":\"keyword\"}" +
-            "}";
+        return "\"properties\":"
+            + "{\"host\": {\"type\":\"keyword\"},"
+            + "\"globalRank\":{\"type\":\"keyword\"},"
+            + "\"tldRank\":{\"type\":\"keyword\"},"
+            + "\"tld\":{\"type\":\"keyword\"}"
+            + "}";
     }
 
     private static Map<String, Object> toMap(Response response) throws IOException {
@@ -204,11 +209,15 @@ private static void verifyEnrichMonitoring() throws IOException {
         for (int i = 0; i < hits.size(); i++) {
             Map<?, ?> hit = (Map<?, ?>) hits.get(i);
 
-            int foundRemoteRequestsTotal =
-                (int) XContentMapValues.extractValue("_source.enrich_coordinator_stats.remote_requests_total", hit);
+            int foundRemoteRequestsTotal = (int) XContentMapValues.extractValue(
+                "_source.enrich_coordinator_stats.remote_requests_total",
+                hit
+            );
             maxRemoteRequestsTotal = Math.max(maxRemoteRequestsTotal, foundRemoteRequestsTotal);
-            int foundExecutedSearchesTotal =
-                (int) XContentMapValues.extractValue("_source.enrich_coordinator_stats.executed_searches_total", hit);
+            int foundExecutedSearchesTotal = (int) XContentMapValues.extractValue(
+                "_source.enrich_coordinator_stats.executed_searches_total",
+                hit
+            );
             maxExecutedSearchesTotal = Math.max(maxExecutedSearchesTotal, foundExecutedSearchesTotal);
         }
 
diff --git a/x-pack/plugin/enrich/qa/rest-with-security/src/test/java/org/elasticsearch/xpack/enrich/EnrichSecurityFailureIT.java b/x-pack/plugin/enrich/qa/rest-with-security/src/test/java/org/elasticsearch/xpack/enrich/EnrichSecurityFailureIT.java
index 4129dcbf920f1..483e5c7056fa2 100644
--- a/x-pack/plugin/enrich/qa/rest-with-security/src/test/java/org/elasticsearch/xpack/enrich/EnrichSecurityFailureIT.java
+++ b/x-pack/plugin/enrich/qa/rest-with-security/src/test/java/org/elasticsearch/xpack/enrich/EnrichSecurityFailureIT.java
@@ -20,17 +20,13 @@ public class EnrichSecurityFailureIT extends ESRestTestCase {
     @Override
     protected Settings restClientSettings() {
         String token = basicAuthHeaderValue("test_enrich_no_privs", new SecureString("x-pack-test-password".toCharArray()));
-        return Settings.builder()
-            .put(ThreadContext.PREFIX + ".Authorization", token)
-            .build();
+        return Settings.builder().put(ThreadContext.PREFIX + ".Authorization", token).build();
     }
 
     @Override
     protected Settings restAdminSettings() {
         String token = basicAuthHeaderValue("test_admin", new SecureString("x-pack-test-password".toCharArray()));
-        return Settings.builder()
-            .put(ThreadContext.PREFIX + ".Authorization", token)
-            .build();
+        return Settings.builder().put(ThreadContext.PREFIX + ".Authorization", token).build();
     }
 
     public void testFailure() throws Exception {
diff --git a/x-pack/plugin/enrich/qa/rest-with-security/src/test/java/org/elasticsearch/xpack/enrich/EnrichSecurityIT.java b/x-pack/plugin/enrich/qa/rest-with-security/src/test/java/org/elasticsearch/xpack/enrich/EnrichSecurityIT.java
index 7ea64a121c32b..76afb1173224f 100644
--- a/x-pack/plugin/enrich/qa/rest-with-security/src/test/java/org/elasticsearch/xpack/enrich/EnrichSecurityIT.java
+++ b/x-pack/plugin/enrich/qa/rest-with-security/src/test/java/org/elasticsearch/xpack/enrich/EnrichSecurityIT.java
@@ -20,17 +20,13 @@ public class EnrichSecurityIT extends CommonEnrichRestTestCase {
     @Override
     protected Settings restClientSettings() {
         String token = basicAuthHeaderValue("test_enrich", new SecureString("x-pack-test-password".toCharArray()));
-        return Settings.builder()
-            .put(ThreadContext.PREFIX + ".Authorization", token)
-            .build();
+        return Settings.builder().put(ThreadContext.PREFIX + ".Authorization", token).build();
     }
 
     @Override
     protected Settings restAdminSettings() {
         String token = basicAuthHeaderValue("test_admin", new SecureString("x-pack-test-password".toCharArray()));
-        return Settings.builder()
-            .put(ThreadContext.PREFIX + ".Authorization", token)
-            .build();
+        return Settings.builder().put(ThreadContext.PREFIX + ".Authorization", token).build();
     }
 
     public void testInsufficientPermissionsOnNonExistentIndex() throws Exception {
@@ -42,7 +38,9 @@ public void testInsufficientPermissionsOnNonExistentIndex() throws Exception {
         Request putPolicyRequest = new Request("PUT", "/_enrich/policy/my_policy");
         putPolicyRequest.setJsonEntity(generatePolicySource("some-other-index"));
         ResponseException exc = expectThrows(ResponseException.class, () -> client().performRequest(putPolicyRequest));
-        assertThat(exc.getMessage(),
-            containsString("unable to store policy because no indices match with the specified index patterns [some-other-index]"));
+        assertThat(
+            exc.getMessage(),
+            containsString("unable to store policy because no indices match with the specified index patterns [some-other-index]")
+        );
     }
 }
diff --git a/x-pack/plugin/enrich/qa/rest/src/test/java/org/elasticsearch/xpack/enrich/EnrichIT.java b/x-pack/plugin/enrich/qa/rest/src/test/java/org/elasticsearch/xpack/enrich/EnrichIT.java
index ccc3386ee42c2..a0b44f227cbcd 100644
--- a/x-pack/plugin/enrich/qa/rest/src/test/java/org/elasticsearch/xpack/enrich/EnrichIT.java
+++ b/x-pack/plugin/enrich/qa/rest/src/test/java/org/elasticsearch/xpack/enrich/EnrichIT.java
@@ -7,5 +7,4 @@
 
 import org.elasticsearch.test.enrich.CommonEnrichRestTestCase;
 
-public class EnrichIT extends CommonEnrichRestTestCase {
-}
+public class EnrichIT extends CommonEnrichRestTestCase {}

From 8e797beeb29f1cc8a13e084602505240b71a6174 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Wed, 15 Jan 2020 14:23:37 +0100
Subject: [PATCH 590/686] Add missing docs for new evaluation metrics (#50967)

---
 .../apis/evaluate-dfanalytics.asciidoc        | 79 +++++++++++--------
 1 file changed, 48 insertions(+), 31 deletions(-)

diff --git a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
index c331d9bda7aab..ad4f0467750fd 100644
--- a/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc
@@ -43,15 +43,16 @@ result field to be present.
 ==== {api-request-body-title}
 
 `evaluation`::
-(Required, object) Defines the type of evaluation you want to perform. The 
-value of this object can be different depending on the type of evaluation you 
-want to perform. See <<ml-evaluate-dfanalytics-resources>>.
+(Required, object) Defines the type of evaluation you want to perform.
+See <<ml-evaluate-dfanalytics-resources>>.
 +
 --
 Available evaluation types:
+
 * `binary_soft_classification`
 * `regression`
 * `classification`
+
 --
 
 `index`::
@@ -59,14 +60,14 @@ Available evaluation types:
 performed.
 
 `query`::
-(Optional, object) A query clause that retrieves a subset of data from the 
+(Optional, object) A query clause that retrieves a subset of data from the
 source index. See <<query-dsl>>.
 
 [[ml-evaluate-dfanalytics-resources]]
 ==== {dfanalytics-cap} evaluation resources
 
 [[binary-sc-resources]]
-===== Binary soft classification configuration objects
+===== Binary soft classification evaluation objects
 
 Binary soft classification evaluates the results of an analysis which outputs 
 the probability that each document belongs to a certain class. For example, in 
@@ -87,24 +88,24 @@ document is an outlier.
   (Optional, object) Specifies the metrics that are used for the evaluation. 
   Available metrics:
   
-  `auc_roc`::
+  `auc_roc`:::
     (Optional, object) The AUC ROC (area under the curve of the receiver 
     operating characteristic) score and optionally the curve. Default value is 
     {"includes_curve": false}.
     
-  `precision`::
+  `confusion_matrix`:::
+    (Optional, object) Set the different thresholds of the {olscore} at where
+    the metrics (`tp` - true positive, `fp` - false positive, `tn` - true
+    negative, `fn` - false negative) are calculated. Default value is
+    {"at": [0.25, 0.50, 0.75]}.
+
+  `precision`:::
     (Optional, object) Set the different thresholds of the {olscore} at where 
     the metric is calculated. Default value is {"at": [0.25, 0.50, 0.75]}.
   
-  `recall`::
+  `recall`:::
     (Optional, object) Set the different thresholds of the {olscore} at where 
     the metric is calculated. Default value is {"at": [0.25, 0.50, 0.75]}.
-  
-  `confusion_matrix`::
-    (Optional, object) Set the different thresholds of the {olscore} at where 
-    the metrics (`tp` - true positive, `fp` - false positive, `tn` - true 
-    negative, `fn` - false negative) are calculated. Default value is 
-    {"at": [0.25, 0.50, 0.75]}.
 
     
 [[regression-evaluation-resources]]
@@ -122,9 +123,18 @@ which outputs a prediction of values.
   in other words the results of the {regression} analysis.
   
 `metrics`::
-  (Required, object) Specifies the metrics that are used for the evaluation. 
-  Available metrics are `r_squared` and `mean_squared_error`.
-  
+  (Optional, object) Specifies the metrics that are used for the evaluation.
+  Available metrics:
+
+  `mean_squared_error`:::
+    (Optional, object) Average squared difference between the predicted values and the actual (`ground truth`) value.
+    For more information, read https://en.wikipedia.org/wiki/Mean_squared_error[this wiki article].
+
+  `r_squared`:::
+    (Optional, object) Proportion of the variance in the dependent variable that is predictable from the independent variables.
+    For more information, read https://en.wikipedia.org/wiki/Coefficient_of_determination[this wiki article].
+
+
   
 [[classification-evaluation-resources]]
 ==== {classification-cap} evaluation objects
@@ -134,20 +144,28 @@ outputs a prediction that identifies to which of the classes each document
 belongs.
 
 `actual_field`::
-  (Required, string) The field of the `index` which contains the ground truth. 
-  The data type of this field must be keyword.
-  
-`metrics`::
-  (Required, object) Specifies the metrics that are used for the evaluation. 
-  Available metric is `multiclass_confusion_matrix`.
+  (Required, string) The field of the `index` which contains the `ground truth`.
+  The data type of this field must be categorical.
   
 `predicted_field`::
   (Required, string) The field in the `index` that contains the predicted value, 
-  in other words the results of the {classanalysis}. The data type of this field 
-  is string. You need to add `.keyword` to the predicted field name (the name 
-  you put in the {classanalysis} object as `prediction_field_name` or the 
-  default value of the same field if you didn't specified explicitly). For 
-  example, `predicted_field` : `ml.animal_class_prediction.keyword`.
+  in other words the results of the {classanalysis}.
+
+`metrics`::
+  (Optional, object) Specifies the metrics that are used for the evaluation.
+  Available metrics:
+
+  `accuracy`:::
+    (Optional, object) Accuracy of predictions (per-class and overall).
+
+  `multiclass_confusion_matrix`:::
+    (Optional, object) Multiclass confusion matrix.
+
+  `precision`:::
+    (Optional, object) Precision of predictions (per-class and average).
+
+  `recall`:::
+    (Optional, object) Recall of predictions (per-class and average).
 
 
 ////
@@ -360,7 +378,7 @@ POST _ml/data_frame/_evaluate
    "evaluation": {
       "classification": { <1>
          "actual_field": "animal_class", <2>
-         "predicted_field": "ml.animal_class_prediction.keyword", <3>
+         "predicted_field": "ml.animal_class_prediction", <3>
          "metrics": {  
            "multiclass_confusion_matrix" : {} <4>
          }
@@ -374,8 +392,7 @@ POST _ml/data_frame/_evaluate
 <2> The field that contains the ground truth value for the actual animal 
 classification. This is required in order to evaluate results.
 <3> The field that contains the predicted value for animal classification by 
-the {classanalysis}. Since the field storing predicted class is dynamically 
-mapped as text and keyword, you need to add the `.keyword` suffix to the name.
+the {classanalysis}.
 <4> Specifies the metric for the evaluation.
 
 

From 99c8507da30e73f150e04eba9fda81b18aa2a379 Mon Sep 17 00:00:00 2001
From: Yannick Welsch <yannick@welsch.lu>
Date: Wed, 15 Jan 2020 15:50:08 +0100
Subject: [PATCH 591/686] Block too many concurrent mapping updates (#51038)

Ensures that there are not too many concurrent dynamic mapping updates going out from the
data nodes to the master.

Closes #50670
---
 .../action/index/MappingUpdatedAction.java    |  66 ++++++++++
 .../common/settings/ClusterSettings.java      |   1 +
 .../index/MappingUpdatedActionTests.java      | 118 ++++++++++++++++++
 .../snapshots/SnapshotResiliencyTests.java    |   1 +
 .../test/InternalTestCluster.java             |   2 +
 5 files changed, 188 insertions(+)
 create mode 100644 server/src/test/java/org/elasticsearch/cluster/action/index/MappingUpdatedActionTests.java

diff --git a/server/src/main/java/org/elasticsearch/cluster/action/index/MappingUpdatedAction.java b/server/src/main/java/org/elasticsearch/cluster/action/index/MappingUpdatedAction.java
index 874b5eb00646c..f1051bca36c43 100644
--- a/server/src/main/java/org/elasticsearch/cluster/action/index/MappingUpdatedAction.java
+++ b/server/src/main/java/org/elasticsearch/cluster/action/index/MappingUpdatedAction.java
@@ -30,10 +30,13 @@
 import org.elasticsearch.common.settings.Setting.Property;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
+import org.elasticsearch.common.util.concurrent.RunOnce;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.mapper.Mapping;
 
+import java.util.concurrent.Semaphore;
+
 /**
  * Called by shards in the cluster when their mapping was dynamically updated and it needs to be updated
  * in the cluster state meta data (and broadcast to all members).
@@ -44,19 +47,30 @@ public class MappingUpdatedAction {
         Setting.positiveTimeSetting("indices.mapping.dynamic_timeout", TimeValue.timeValueSeconds(30),
             Property.Dynamic, Property.NodeScope);
 
+    public static final Setting<Integer> INDICES_MAX_IN_FLIGHT_UPDATES_SETTING =
+        Setting.intSetting("indices.mapping.max_in_flight_updates", 10, 1, 1000,
+            Property.Dynamic, Property.NodeScope);
+
     private IndicesAdminClient client;
     private volatile TimeValue dynamicMappingUpdateTimeout;
+    private final AdjustableSemaphore semaphore;
 
     @Inject
     public MappingUpdatedAction(Settings settings, ClusterSettings clusterSettings) {
         this.dynamicMappingUpdateTimeout = INDICES_MAPPING_DYNAMIC_TIMEOUT_SETTING.get(settings);
+        this.semaphore = new AdjustableSemaphore(INDICES_MAX_IN_FLIGHT_UPDATES_SETTING.get(settings), true);
         clusterSettings.addSettingsUpdateConsumer(INDICES_MAPPING_DYNAMIC_TIMEOUT_SETTING, this::setDynamicMappingUpdateTimeout);
+        clusterSettings.addSettingsUpdateConsumer(INDICES_MAX_IN_FLIGHT_UPDATES_SETTING, this::setMaxInFlightUpdates);
     }
 
     private void setDynamicMappingUpdateTimeout(TimeValue dynamicMappingUpdateTimeout) {
         this.dynamicMappingUpdateTimeout = dynamicMappingUpdateTimeout;
     }
 
+    private void setMaxInFlightUpdates(int maxInFlightUpdates) {
+        semaphore.setMaxPermits(maxInFlightUpdates);
+    }
+
     public void setClient(Client client) {
         this.client = client.admin().indices();
     }
@@ -68,6 +82,32 @@ public void setClient(Client client) {
      * potentially waiting for a master node to be available.
      */
     public void updateMappingOnMaster(Index index, Mapping mappingUpdate, ActionListener<Void> listener) {
+        final RunOnce release = new RunOnce(() -> semaphore.release());
+        try {
+            semaphore.acquire();
+        } catch (InterruptedException e) {
+            Thread.currentThread().interrupt();
+            listener.onFailure(e);
+            return;
+        }
+        boolean successFullySent = false;
+        try {
+            sendUpdateMapping(index, mappingUpdate, ActionListener.runBefore(listener, release::run));
+            successFullySent = true;
+        } finally {
+            if (successFullySent == false) {
+                release.run();
+            }
+        }
+    }
+
+    // used by tests
+    int blockedThreads() {
+        return semaphore.getQueueLength();
+    }
+
+    // can be overridden by tests
+    protected void sendUpdateMapping(Index index, Mapping mappingUpdate, ActionListener<Void> listener) {
         client.preparePutMapping().setConcreteIndex(index).setSource(mappingUpdate.toString(), XContentType.JSON)
             .setMasterNodeTimeout(dynamicMappingUpdateTimeout).setTimeout(TimeValue.ZERO)
             .execute(new ActionListener<>() {
@@ -82,4 +122,30 @@ public void onFailure(Exception e) {
                 }
             });
     }
+
+    static class AdjustableSemaphore extends Semaphore {
+
+        private final Object maxPermitsMutex = new Object();
+        private int maxPermits;
+
+        AdjustableSemaphore(int maxPermits, boolean fair) {
+            super(maxPermits, fair);
+            this.maxPermits = maxPermits;
+        }
+
+        void setMaxPermits(int permits) {
+            synchronized (maxPermitsMutex) {
+                final int diff = Math.subtractExact(permits, maxPermits);
+                if (diff > 0) {
+                    // add permits
+                    release(diff);
+                } else if (diff < 0) {
+                    // remove permits
+                    reducePermits(Math.negateExact(diff));
+                }
+
+                maxPermits = permits;
+            }
+        }
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
index 6cb2bbd3eaafd..f8ea133c0ed63 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/ClusterSettings.java
@@ -201,6 +201,7 @@ public void apply(Settings value, Settings current, Settings previous) {
             IndicesService.INDICES_ID_FIELD_DATA_ENABLED_SETTING,
             IndicesService.WRITE_DANGLING_INDICES_INFO_SETTING,
             MappingUpdatedAction.INDICES_MAPPING_DYNAMIC_TIMEOUT_SETTING,
+            MappingUpdatedAction.INDICES_MAX_IN_FLIGHT_UPDATES_SETTING,
             MetaData.SETTING_READ_ONLY_SETTING,
             MetaData.SETTING_READ_ONLY_ALLOW_DELETE_SETTING,
             MetaData.SETTING_CLUSTER_MAX_SHARDS_PER_NODE,
diff --git a/server/src/test/java/org/elasticsearch/cluster/action/index/MappingUpdatedActionTests.java b/server/src/test/java/org/elasticsearch/cluster/action/index/MappingUpdatedActionTests.java
new file mode 100644
index 0000000000000..7f19e725c5d4f
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/cluster/action/index/MappingUpdatedActionTests.java
@@ -0,0 +1,118 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.cluster.action.index;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.cluster.action.index.MappingUpdatedAction.AdjustableSemaphore;
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.index.mapper.Mapping;
+import org.elasticsearch.test.ESTestCase;
+
+import java.util.List;
+import java.util.concurrent.CopyOnWriteArrayList;
+
+public class MappingUpdatedActionTests extends ESTestCase {
+
+    public void testAdjustableSemaphore() {
+        AdjustableSemaphore sem = new AdjustableSemaphore(1, randomBoolean());
+        assertEquals(1, sem.availablePermits());
+        assertTrue(sem.tryAcquire());
+        assertEquals(0, sem.availablePermits());
+        assertFalse(sem.tryAcquire());
+        assertEquals(0, sem.availablePermits());
+
+        // increase the number of max permits to 2
+        sem.setMaxPermits(2);
+        assertEquals(1, sem.availablePermits());
+        assertTrue(sem.tryAcquire());
+        assertEquals(0, sem.availablePermits());
+
+        // release all current permits
+        sem.release();
+        assertEquals(1, sem.availablePermits());
+        sem.release();
+        assertEquals(2, sem.availablePermits());
+
+        // reduce number of max permits to 1
+        sem.setMaxPermits(1);
+        assertEquals(1, sem.availablePermits());
+        // set back to 2
+        sem.setMaxPermits(2);
+        assertEquals(2, sem.availablePermits());
+
+        // take both permits and reduce max permits
+        assertTrue(sem.tryAcquire());
+        assertTrue(sem.tryAcquire());
+        assertEquals(0, sem.availablePermits());
+        assertFalse(sem.tryAcquire());
+        sem.setMaxPermits(1);
+        assertEquals(-1, sem.availablePermits());
+        assertFalse(sem.tryAcquire());
+
+        // release one permit
+        sem.release();
+        assertEquals(0, sem.availablePermits());
+        assertFalse(sem.tryAcquire());
+
+        // release second permit
+        sem.release();
+        assertEquals(1, sem.availablePermits());
+        assertTrue(sem.tryAcquire());
+    }
+
+    public void testMappingUpdatedActionBlocks() throws Exception {
+        List<ActionListener<Void>> inFlightListeners = new CopyOnWriteArrayList<>();
+        final MappingUpdatedAction mua = new MappingUpdatedAction(Settings.builder()
+            .put(MappingUpdatedAction.INDICES_MAX_IN_FLIGHT_UPDATES_SETTING.getKey(), 1).build(),
+            new ClusterSettings(Settings.EMPTY, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS)) {
+
+            @Override
+            protected void sendUpdateMapping(Index index, Mapping mappingUpdate, ActionListener<Void> listener) {
+                inFlightListeners.add(listener);
+            }
+        };
+
+        PlainActionFuture<Void> fut1 = new PlainActionFuture<>();
+        mua.updateMappingOnMaster(null, null, fut1);
+        assertEquals(1, inFlightListeners.size());
+        assertEquals(0, mua.blockedThreads());
+
+        PlainActionFuture<Void> fut2 = new PlainActionFuture<>();
+        Thread thread = new Thread(() -> {
+            mua.updateMappingOnMaster(null, null, fut2); // blocked
+        });
+        thread.start();
+        assertBusy(() -> assertEquals(1, mua.blockedThreads()));
+
+        assertEquals(1, inFlightListeners.size());
+        assertFalse(fut1.isDone());
+        inFlightListeners.remove(0).onResponse(null);
+        assertTrue(fut1.isDone());
+
+        thread.join();
+        assertEquals(0, mua.blockedThreads());
+        assertEquals(1, inFlightListeners.size());
+        assertFalse(fut2.isDone());
+        inFlightListeners.remove(0).onResponse(null);
+        assertTrue(fut2.isDone());
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
index 9b8950c813b4f..03153595dcf18 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
@@ -885,6 +885,7 @@ private Environment createEnvironment(String nodeName) {
             .put(Environment.PATH_REPO_SETTING.getKey(), tempDir.resolve("repo").toAbsolutePath())
             .putList(ClusterBootstrapService.INITIAL_MASTER_NODES_SETTING.getKey(),
                 ClusterBootstrapService.INITIAL_MASTER_NODES_SETTING.get(Settings.EMPTY))
+            .put(MappingUpdatedAction.INDICES_MAX_IN_FLIGHT_UPDATES_SETTING.getKey(), 1000) // o.w. some tests might block
             .build());
     }
 
diff --git a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
index 98911fe3f4cb1..58144da28d111 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
@@ -471,6 +471,8 @@ private static Settings getRandomNodeSettings(long seed) {
         if (random.nextBoolean()) {
             builder.put(MappingUpdatedAction.INDICES_MAPPING_DYNAMIC_TIMEOUT_SETTING.getKey(),
                     timeValueSeconds(RandomNumbers.randomIntBetween(random, 10, 30)).getStringRep());
+            builder.put(MappingUpdatedAction.INDICES_MAX_IN_FLIGHT_UPDATES_SETTING.getKey(),
+                    RandomNumbers.randomIntBetween(random, 1, 10));
         }
 
         // turning on the real memory circuit breaker leads to spurious test failures. As have no full control over heap usage, we

From e397be1c7198bcd2702fc4317e440b6858082b74 Mon Sep 17 00:00:00 2001
From: Zachary Tong <zach@elastic.co>
Date: Wed, 15 Jan 2020 10:14:19 -0500
Subject: [PATCH 592/686] Add version constant for 7.7.0

---
 server/src/main/java/org/elasticsearch/Version.java | 1 +
 1 file changed, 1 insertion(+)

diff --git a/server/src/main/java/org/elasticsearch/Version.java b/server/src/main/java/org/elasticsearch/Version.java
index ce8d0053e76dc..41e108638ad39 100644
--- a/server/src/main/java/org/elasticsearch/Version.java
+++ b/server/src/main/java/org/elasticsearch/Version.java
@@ -73,6 +73,7 @@ public class Version implements Comparable<Version>, ToXContentFragment {
     public static final Version V_7_5_1 = new Version(7050199, org.apache.lucene.util.Version.LUCENE_8_3_0);
     public static final Version V_7_5_2 = new Version(7050299, org.apache.lucene.util.Version.LUCENE_8_3_0);
     public static final Version V_7_6_0 = new Version(7060099, org.apache.lucene.util.Version.LUCENE_8_4_0);
+    public static final Version V_7_7_0 = new Version(7070099, org.apache.lucene.util.Version.LUCENE_8_4_0);
     public static final Version V_8_0_0 = new Version(8000099, org.apache.lucene.util.Version.LUCENE_8_4_0);
     public static final Version CURRENT = V_8_0_0;
 

From ee020628f30cad34474d2297c1a279c979988ada Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Wed, 15 Jan 2020 16:17:05 +0100
Subject: [PATCH 593/686] Add pipeline name to ingest metadata (#50467)

This commit adds the name of the current pipeline to ingest metadata.
This pipeline name is accessible under the following key: '_ingest.pipeline'.

Example usage in pipeline:
PUT /_ingest/pipeline/2
{
    "processors": [
        {
            "set": {
                "field": "pipeline_name",
                "value": "{{_ingest.pipeline}}"
            }
        }
    ]
}

Closes #42106
---
 .../ingest/apis/simulate-pipeline.asciidoc    | 12 ++-
 .../ingest/processors/pipeline.asciidoc       |  2 +
 .../test/ingest/210_pipeline_processor.yml    | 78 +++++++++++++++++++
 .../rest-api-spec/test/ingest/90_simulate.yml | 18 +++--
 .../elasticsearch/ingest/IngestDocument.java  |  6 ++
 .../ingest/PipelineProcessor.java             |  2 +-
 .../ingest/SimulateExecutionServiceTests.java | 56 +++++++------
 .../ingest/CompoundProcessorTests.java        |  3 +-
 .../ingest/PipelineProcessorTests.java        | 57 ++++++++++++++
 .../ingest/TrackingResultProcessorTests.java  |  5 ++
 10 files changed, 198 insertions(+), 41 deletions(-)

diff --git a/docs/reference/ingest/apis/simulate-pipeline.asciidoc b/docs/reference/ingest/apis/simulate-pipeline.asciidoc
index 1b2317b83ecd6..cb954d6d2a081 100644
--- a/docs/reference/ingest/apis/simulate-pipeline.asciidoc
+++ b/docs/reference/ingest/apis/simulate-pipeline.asciidoc
@@ -350,7 +350,8 @@ The API returns the following response:
                      "foo": "bar"
                   },
                   "_ingest": {
-                     "timestamp": "2017-05-04T22:46:09.674Z"
+                     "timestamp": "2017-05-04T22:46:09.674Z",
+                     "pipeline": "_simulate_pipeline"
                   }
                }
             },
@@ -364,7 +365,8 @@ The API returns the following response:
                      "foo": "bar"
                   },
                   "_ingest": {
-                     "timestamp": "2017-05-04T22:46:09.675Z"
+                     "timestamp": "2017-05-04T22:46:09.675Z",
+                     "pipeline": "_simulate_pipeline"
                   }
                }
             }
@@ -381,7 +383,8 @@ The API returns the following response:
                      "foo": "rab"
                   },
                   "_ingest": {
-                     "timestamp": "2017-05-04T22:46:09.676Z"
+                     "timestamp": "2017-05-04T22:46:09.676Z",
+                     "pipeline": "_simulate_pipeline"
                   }
                }
             },
@@ -395,7 +398,8 @@ The API returns the following response:
                      "foo": "rab"
                   },
                   "_ingest": {
-                     "timestamp": "2017-05-04T22:46:09.677Z"
+                     "timestamp": "2017-05-04T22:46:09.677Z",
+                     "pipeline": "_simulate_pipeline"
                   }
                }
             }
diff --git a/docs/reference/ingest/processors/pipeline.asciidoc b/docs/reference/ingest/processors/pipeline.asciidoc
index 7f1ea2885e69a..8a8b0310142d8 100644
--- a/docs/reference/ingest/processors/pipeline.asciidoc
+++ b/docs/reference/ingest/processors/pipeline.asciidoc
@@ -21,6 +21,8 @@ include::common-options.asciidoc[]
 --------------------------------------------------
 // NOTCONSOLE
 
+The name of the current pipeline can be accessed from the `_ingest.pipeline` ingest metadata key.
+
 An example of using this processor for nesting pipelines would be:
 
 Define an inner pipeline:
diff --git a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/210_pipeline_processor.yml b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/210_pipeline_processor.yml
index a012536c53bb4..bc82b7f1ca7e1 100644
--- a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/210_pipeline_processor.yml
+++ b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/210_pipeline_processor.yml
@@ -202,3 +202,81 @@ teardown:
           }
   - match: { error.root_cause.0.type: "illegal_state_exception" }
   - match: { error.root_cause.0.reason: "Pipeline processor configured for non-existent pipeline [legal-department]" }
+
+---
+"Test _ingest.pipeline metadata":
+  - do:
+      ingest.put_pipeline:
+        id: "pipeline1"
+        body:  >
+          {
+            "processors" : [
+              {
+                "append" : {
+                  "field": "pipelines",
+                  "value": "{{_ingest.pipeline}}"
+                }
+              },
+              {
+                "pipeline" : {
+                  "name": "another_pipeline"
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      ingest.put_pipeline:
+        id: "another_pipeline"
+        body:  >
+          {
+            "processors" : [
+              {
+                "append" : {
+                  "field": "pipelines",
+                  "value": "{{_ingest.pipeline}}"
+                }
+              },
+              {
+                "pipeline" : {
+                  "name": "another_pipeline2"
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      ingest.put_pipeline:
+        id: "another_pipeline2"
+        body:  >
+          {
+            "processors" : [
+              {
+                "append" : {
+                  "field": "pipelines",
+                  "value": "{{_ingest.pipeline}}"
+                }
+              }
+            ]
+          }
+  - match: { acknowledged: true }
+
+  - do:
+      index:
+        index: test
+        id: 1
+        pipeline: "pipeline1"
+        body: >
+          {
+          }
+
+  - do:
+      get:
+        index: test
+        id: 1
+  - length: { _source.pipelines: 3 }
+  - match: { _source.pipelines.0: "pipeline1" }
+  - match: { _source.pipelines.1: "another_pipeline" }
+  - match: { _source.pipelines.2: "another_pipeline2" }
diff --git a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/90_simulate.yml b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/90_simulate.yml
index 456a2ba15dd4c..6203326e1c2f9 100644
--- a/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/90_simulate.yml
+++ b/modules/ingest-common/src/test/resources/rest-api-spec/test/ingest/90_simulate.yml
@@ -284,26 +284,30 @@ teardown:
   - length: { docs.0.processor_results.0.doc._source: 2 }
   - match: { docs.0.processor_results.0.doc._source.foo.bar.0.item: "HELLO" }
   - match: { docs.0.processor_results.0.doc._source.field2.value: "_value" }
-  - length: { docs.0.processor_results.0.doc._ingest: 1 }
+  - length: { docs.0.processor_results.0.doc._ingest: 2 }
   - is_true: docs.0.processor_results.0.doc._ingest.timestamp
+  - is_true: docs.0.processor_results.0.doc._ingest.pipeline
   - length: { docs.0.processor_results.1.doc._source: 3 }
   - match: { docs.0.processor_results.1.doc._source.foo.bar.0.item: "HELLO" }
   - match: { docs.0.processor_results.1.doc._source.field2.value: "_value" }
   - match: { docs.0.processor_results.1.doc._source.field3: "third_val" }
-  - length: { docs.0.processor_results.1.doc._ingest: 1 }
+  - length: { docs.0.processor_results.1.doc._ingest: 2 }
   - is_true: docs.0.processor_results.1.doc._ingest.timestamp
+  - is_true: docs.0.processor_results.1.doc._ingest.pipeline
   - length: { docs.0.processor_results.2.doc._source: 3 }
   - match: { docs.0.processor_results.2.doc._source.foo.bar.0.item: "HELLO" }
   - match: { docs.0.processor_results.2.doc._source.field2.value: "_VALUE" }
   - match: { docs.0.processor_results.2.doc._source.field3: "third_val" }
-  - length: { docs.0.processor_results.2.doc._ingest: 1 }
+  - length: { docs.0.processor_results.2.doc._ingest: 2 }
   - is_true: docs.0.processor_results.2.doc._ingest.timestamp
+  - is_true: docs.0.processor_results.2.doc._ingest.pipeline
   - length: { docs.0.processor_results.3.doc._source: 3 }
   - match: { docs.0.processor_results.3.doc._source.foo.bar.0.item: "hello" }
   - match: { docs.0.processor_results.3.doc._source.field2.value: "_VALUE" }
   - match: { docs.0.processor_results.3.doc._source.field3: "third_val" }
-  - length: { docs.0.processor_results.3.doc._ingest: 1 }
+  - length: { docs.0.processor_results.3.doc._ingest: 2 }
   - is_true: docs.0.processor_results.3.doc._ingest.timestamp
+  - is_true: docs.0.processor_results.3.doc._ingest.pipeline
 
 ---
 "Test simulate with exception thrown":
@@ -393,12 +397,14 @@ teardown:
   - match: { docs.1.processor_results.0.doc._index: "index" }
   - match: { docs.1.processor_results.0.doc._source.foo: 5 }
   - match: { docs.1.processor_results.0.doc._source.bar: "hello" }
-  - length: { docs.1.processor_results.0.doc._ingest: 1 }
+  - length: { docs.1.processor_results.0.doc._ingest: 2 }
   - is_true: docs.1.processor_results.0.doc._ingest.timestamp
+  - is_true: docs.1.processor_results.0.doc._ingest.pipeline
   - match: { docs.1.processor_results.1.doc._source.foo: 5 }
   - match: { docs.1.processor_results.1.doc._source.bar: "HELLO" }
-  - length: { docs.1.processor_results.1.doc._ingest: 1 }
+  - length: { docs.1.processor_results.1.doc._ingest: 2 }
   - is_true: docs.1.processor_results.1.doc._ingest.timestamp
+  - is_true: docs.1.processor_results.1.doc._ingest.pipeline
 
 ---
 "Test verbose simulate with on_failure":
diff --git a/server/src/main/java/org/elasticsearch/ingest/IngestDocument.java b/server/src/main/java/org/elasticsearch/ingest/IngestDocument.java
index 1f0d2b4757128..72adbfae0e6c0 100644
--- a/server/src/main/java/org/elasticsearch/ingest/IngestDocument.java
+++ b/server/src/main/java/org/elasticsearch/ingest/IngestDocument.java
@@ -646,8 +646,14 @@ private static Object deepCopy(Object value) {
      */
     public void executePipeline(Pipeline pipeline, BiConsumer<IngestDocument, Exception> handler) {
         if (executedPipelines.add(pipeline.getId())) {
+            Object previousPipeline = ingestMetadata.put("pipeline", pipeline.getId());
             pipeline.execute(this, (result, e) -> {
                 executedPipelines.remove(pipeline.getId());
+                if (previousPipeline != null) {
+                    ingestMetadata.put("pipeline", previousPipeline);
+                } else {
+                    ingestMetadata.remove("pipeline");
+                }
                 handler.accept(result, e);
             });
         } else {
diff --git a/server/src/main/java/org/elasticsearch/ingest/PipelineProcessor.java b/server/src/main/java/org/elasticsearch/ingest/PipelineProcessor.java
index be02fe24752c1..2ee99d6e5d48f 100644
--- a/server/src/main/java/org/elasticsearch/ingest/PipelineProcessor.java
+++ b/server/src/main/java/org/elasticsearch/ingest/PipelineProcessor.java
@@ -31,7 +31,7 @@ public class PipelineProcessor extends AbstractProcessor {
     private final TemplateScript.Factory pipelineTemplate;
     private final IngestService ingestService;
 
-    private PipelineProcessor(String tag, TemplateScript.Factory pipelineTemplate, IngestService ingestService) {
+    PipelineProcessor(String tag, TemplateScript.Factory pipelineTemplate, IngestService ingestService) {
         super(tag);
         this.pipelineTemplate = pipelineTemplate;
         this.ingestService = ingestService;
diff --git a/server/src/test/java/org/elasticsearch/action/ingest/SimulateExecutionServiceTests.java b/server/src/test/java/org/elasticsearch/action/ingest/SimulateExecutionServiceTests.java
index 7276ef2ebada4..834aa57b2d825 100644
--- a/server/src/test/java/org/elasticsearch/action/ingest/SimulateExecutionServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/action/ingest/SimulateExecutionServiceTests.java
@@ -91,23 +91,17 @@ public void testExecuteVerboseItem() throws Exception {
         assertThat(actualItemResponse, instanceOf(SimulateDocumentVerboseResult.class));
         SimulateDocumentVerboseResult simulateDocumentVerboseResult = (SimulateDocumentVerboseResult) actualItemResponse;
         assertThat(simulateDocumentVerboseResult.getProcessorResults().size(), equalTo(2));
-        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getProcessorTag(), equalTo("test-id"));
-        IngestDocument firstProcessorIngestDocument = simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument();
-        assertThat(firstProcessorIngestDocument, not(sameInstance(this.ingestDocument)));
-        assertIngestDocument(firstProcessorIngestDocument, this.ingestDocument);
-        assertThat(firstProcessorIngestDocument.getSourceAndMetadata(), not(sameInstance(this.ingestDocument.getSourceAndMetadata())));
 
+        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getProcessorTag(), equalTo("test-id"));
+        assertVerboseResult(simulateDocumentVerboseResult.getProcessorResults().get(0), pipeline.getId(), ingestDocument);
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getFailure(), nullValue());
+
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(1).getProcessorTag(), equalTo("test-id"));
-        IngestDocument secondProcessorIngestDocument = simulateDocumentVerboseResult.getProcessorResults().get(1).getIngestDocument();
-        assertThat(secondProcessorIngestDocument, not(sameInstance(this.ingestDocument)));
-        assertIngestDocument(secondProcessorIngestDocument, this.ingestDocument);
-        assertThat(secondProcessorIngestDocument.getSourceAndMetadata(), not(sameInstance(this.ingestDocument.getSourceAndMetadata())));
-        assertThat(secondProcessorIngestDocument.getSourceAndMetadata(),
-            not(sameInstance(firstProcessorIngestDocument.getSourceAndMetadata())));
+        assertVerboseResult(simulateDocumentVerboseResult.getProcessorResults().get(1), pipeline.getId(), ingestDocument);
+        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(1).getIngestDocument().getSourceAndMetadata(),
+            not(sameInstance(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument().getSourceAndMetadata())));
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(1).getFailure(), nullValue());
     }
-
     public void testExecuteItem() throws Exception {
         TestProcessor processor = new TestProcessor("processor_0", "mock", ingestDocument -> {});
         Pipeline pipeline = new Pipeline("_id", "_description", version, new CompoundProcessor(processor, processor));
@@ -147,10 +141,7 @@ public void testExecuteVerboseItemExceptionWithoutOnFailure() throws Exception {
         assertThat(simulateDocumentVerboseResult.getProcessorResults().size(), equalTo(2));
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getProcessorTag(), equalTo("processor_0"));
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getFailure(), nullValue());
-        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument(), not(sameInstance(ingestDocument)));
-        assertIngestDocument(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument(), ingestDocument);
-        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument().getSourceAndMetadata(),
-                not(sameInstance(ingestDocument.getSourceAndMetadata())));
+        assertVerboseResult(simulateDocumentVerboseResult.getProcessorResults().get(0), pipeline.getId(), ingestDocument);
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(1).getProcessorTag(), equalTo("processor_1"));
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(1).getIngestDocument(), nullValue());
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(1).getFailure(), instanceOf(RuntimeException.class));
@@ -191,14 +182,12 @@ public void testExecuteVerboseItemWithOnFailure() throws Exception {
         metadata.put(CompoundProcessor.ON_FAILURE_PROCESSOR_TYPE_FIELD, "mock");
         metadata.put(CompoundProcessor.ON_FAILURE_PROCESSOR_TAG_FIELD, "processor_0");
         metadata.put(CompoundProcessor.ON_FAILURE_MESSAGE_FIELD, "processor failed");
-        assertIngestDocument(simulateDocumentVerboseResult.getProcessorResults().get(1).getIngestDocument(),
-                ingestDocumentWithOnFailureMetadata);
-
+        assertVerboseResult(simulateDocumentVerboseResult.getProcessorResults().get(1), pipeline.getId(),
+            ingestDocumentWithOnFailureMetadata);
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(1).getFailure(), nullValue());
 
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(2).getProcessorTag(), equalTo("processor_2"));
-        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(2).getIngestDocument(), not(sameInstance(ingestDocument)));
-        assertIngestDocument(simulateDocumentVerboseResult.getProcessorResults().get(2).getIngestDocument(), ingestDocument);
+        assertVerboseResult(simulateDocumentVerboseResult.getProcessorResults().get(2), pipeline.getId(), ingestDocument);
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(2).getFailure(), nullValue());
     }
 
@@ -221,10 +210,7 @@ public void testExecuteVerboseItemExceptionWithIgnoreFailure() throws Exception
         assertThat(simulateDocumentVerboseResult.getProcessorResults().size(), equalTo(1));
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getProcessorTag(), equalTo("processor_0"));
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getFailure(), sameInstance(exception));
-        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument(), not(sameInstance(ingestDocument)));
-        assertIngestDocument(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument(), ingestDocument);
-        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument().getSourceAndMetadata(),
-                not(sameInstance(ingestDocument.getSourceAndMetadata())));
+        assertVerboseResult(simulateDocumentVerboseResult.getProcessorResults().get(0), pipeline.getId(), ingestDocument);
     }
 
     public void testExecuteVerboseItemWithoutExceptionAndWithIgnoreFailure() throws Exception {
@@ -245,10 +231,7 @@ public void testExecuteVerboseItemWithoutExceptionAndWithIgnoreFailure() throws
         assertThat(simulateDocumentVerboseResult.getProcessorResults().size(), equalTo(1));
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getProcessorTag(), equalTo("processor_0"));
         assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getFailure(), nullValue());
-        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument(), not(sameInstance(ingestDocument)));
-        assertIngestDocument(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument(), ingestDocument);
-        assertThat(simulateDocumentVerboseResult.getProcessorResults().get(0).getIngestDocument().getSourceAndMetadata(),
-                not(sameInstance(ingestDocument.getSourceAndMetadata())));
+        assertVerboseResult(simulateDocumentVerboseResult.getProcessorResults().get(0), pipeline.getId(), ingestDocument);
     }
 
     public void testExecuteItemWithFailure() throws Exception {
@@ -392,4 +375,19 @@ public String getType() {
         }
     }
 
+    private static void assertVerboseResult(SimulateProcessorResult result,
+                                            String expectedPipelineId,
+                                            IngestDocument expectedIngestDocument) {
+        IngestDocument simulateVerboseIngestDocument = result.getIngestDocument();
+        // Remove and compare pipeline key. It is always in the verbose result,
+        // since that is a snapshot of how the ingest doc looks during pipeline execution, but not in the final ingestDocument.
+        // The key gets added and removed during pipeline execution.
+        String actualPipelineId = (String) simulateVerboseIngestDocument.getIngestMetadata().remove("pipeline");
+        assertThat(actualPipelineId, equalTo(expectedPipelineId));
+
+        assertThat(simulateVerboseIngestDocument, not(sameInstance(expectedIngestDocument)));
+        assertIngestDocument(simulateVerboseIngestDocument, expectedIngestDocument);
+        assertThat(simulateVerboseIngestDocument.getSourceAndMetadata(), not(sameInstance(expectedIngestDocument.getSourceAndMetadata())));
+    }
+
 }
diff --git a/server/src/test/java/org/elasticsearch/ingest/CompoundProcessorTests.java b/server/src/test/java/org/elasticsearch/ingest/CompoundProcessorTests.java
index 377679afc43f7..75f1d4d7afb6b 100644
--- a/server/src/test/java/org/elasticsearch/ingest/CompoundProcessorTests.java
+++ b/server/src/test/java/org/elasticsearch/ingest/CompoundProcessorTests.java
@@ -285,11 +285,12 @@ public void testBreakOnFailure() throws Exception {
     public void testFailureProcessorIsInvokedOnFailure() {
         TestProcessor onFailureProcessor = new TestProcessor(null, "on_failure", ingestDocument -> {
             Map<String, Object> ingestMetadata = ingestDocument.getIngestMetadata();
-            assertThat(ingestMetadata.entrySet(), hasSize(4));
+            assertThat(ingestMetadata.entrySet(), hasSize(5));
             assertThat(ingestMetadata.get(CompoundProcessor.ON_FAILURE_MESSAGE_FIELD), equalTo("failure!"));
             assertThat(ingestMetadata.get(CompoundProcessor.ON_FAILURE_PROCESSOR_TYPE_FIELD), equalTo("test-processor"));
             assertThat(ingestMetadata.get(CompoundProcessor.ON_FAILURE_PROCESSOR_TAG_FIELD), nullValue());
             assertThat(ingestMetadata.get(CompoundProcessor.ON_FAILURE_PIPELINE_FIELD), equalTo("2"));
+            assertThat(ingestMetadata.get("pipeline"), equalTo("1"));
         });
 
         Pipeline pipeline2 = new Pipeline("2", null, null, new CompoundProcessor(new TestProcessor(new RuntimeException("failure!"))));
diff --git a/server/src/test/java/org/elasticsearch/ingest/PipelineProcessorTests.java b/server/src/test/java/org/elasticsearch/ingest/PipelineProcessorTests.java
index aebcc28e77d5e..74dba097db792 100644
--- a/server/src/test/java/org/elasticsearch/ingest/PipelineProcessorTests.java
+++ b/server/src/test/java/org/elasticsearch/ingest/PipelineProcessorTests.java
@@ -20,17 +20,22 @@
 
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.script.ScriptService;
+import org.elasticsearch.script.TemplateScript;
 import org.elasticsearch.test.ESTestCase;
 
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.TimeUnit;
 import java.util.function.LongSupplier;
 
 import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.CoreMatchers.notNullValue;
+import static org.hamcrest.Matchers.nullValue;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
@@ -205,6 +210,58 @@ pipeline3Id, null, null, new CompoundProcessor(
         assertThat(pipeline3Stats.getIngestFailedCount(), equalTo(1L));
     }
 
+    public void testIngestPipelineMetadata() {
+        IngestService ingestService = createIngestService();
+
+        final int numPipelines = 16;
+        Pipeline firstPipeline = null;
+        for (int i = 0; i < numPipelines; i++) {
+            String pipelineId = Integer.toString(i);
+            List<Processor> processors = new ArrayList<>();
+            processors.add(new AbstractProcessor(null) {
+                @Override
+                public IngestDocument execute(final IngestDocument ingestDocument) throws Exception {
+                    ingestDocument.appendFieldValue("pipelines", ingestDocument.getIngestMetadata().get("pipeline"));
+                    return ingestDocument;
+                }
+
+                @Override
+                public String getType() {
+                    return null;
+                }
+
+            });
+            if (i < (numPipelines - 1)) {
+                TemplateScript.Factory pipelineName = new TestTemplateService.MockTemplateScript.Factory(Integer.toString(i + 1));
+                processors.add(new PipelineProcessor(null, pipelineName, ingestService));
+            }
+
+
+            Pipeline pipeline = new Pipeline(pipelineId, null, null, new CompoundProcessor(false, processors, List.of()));
+            when(ingestService.getPipeline(pipelineId)).thenReturn(pipeline);
+            if (firstPipeline == null) {
+                firstPipeline = pipeline;
+            }
+        }
+
+        IngestDocument testIngestDocument = RandomDocumentPicks.randomIngestDocument(random(), new HashMap<>());
+        IngestDocument[] docHolder = new IngestDocument[1];
+        Exception[] errorHolder = new Exception[1];
+        testIngestDocument.executePipeline(firstPipeline, (doc, e) -> {
+            docHolder[0] = doc;
+            errorHolder[0] = e;
+        });
+        assertThat(docHolder[0], notNullValue());
+        assertThat(errorHolder[0], nullValue());
+
+        IngestDocument ingestDocument = docHolder[0];
+        List<?> pipelines = ingestDocument.getFieldValue("pipelines", List.class);
+        assertThat(pipelines.size(), equalTo(numPipelines));
+        for (int i = 0; i < numPipelines; i++) {
+            assertThat(pipelines.get(i), equalTo(Integer.toString(i)));
+        }
+    }
+
     static IngestService createIngestService() {
         IngestService ingestService = mock(IngestService.class);
         ScriptService scriptService = mock(ScriptService.class);
diff --git a/server/src/test/java/org/elasticsearch/ingest/TrackingResultProcessorTests.java b/server/src/test/java/org/elasticsearch/ingest/TrackingResultProcessorTests.java
index c66d4742b991b..ef4613ce2ffd1 100644
--- a/server/src/test/java/org/elasticsearch/ingest/TrackingResultProcessorTests.java
+++ b/server/src/test/java/org/elasticsearch/ingest/TrackingResultProcessorTests.java
@@ -220,6 +220,7 @@ pipelineId, null, null, new CompoundProcessor(
         trackingProcessor.execute(ingestDocument, (result, e) -> {});
 
         SimulateProcessorResult expectedResult = new SimulateProcessorResult(actualProcessor.getTag(), ingestDocument);
+        expectedResult.getIngestDocument().getIngestMetadata().put("pipeline", pipelineId);
 
         verify(ingestService,  Mockito.atLeast(1)).getPipeline(pipelineId);
         assertThat(resultList.size(), equalTo(3));
@@ -287,6 +288,7 @@ pipelineId2, null, null, new CompoundProcessor(
 
 
         SimulateProcessorResult expectedResult = new SimulateProcessorResult(actualProcessor.getTag(), ingestDocument);
+        expectedResult.getIngestDocument().getIngestMetadata().put("pipeline", pipelineId1);
 
         verify(ingestService, Mockito.atLeast(1)).getPipeline(pipelineId1);
         verify(ingestService, Mockito.atLeast(1)).getPipeline(pipelineId2);
@@ -355,6 +357,7 @@ pipelineId2, null, null, new CompoundProcessor(
 
 
         SimulateProcessorResult expectedResult = new SimulateProcessorResult(actualProcessor.getTag(), ingestDocument);
+        expectedResult.getIngestDocument().getIngestMetadata().put("pipeline", pipelineId1);
 
         verify(ingestService, Mockito.atLeast(1)).getPipeline(pipelineId1);
         verify(ingestService, Mockito.never()).getPipeline(pipelineId2);
@@ -406,6 +409,7 @@ pipelineId, null, null, new CompoundProcessor(
         trackingProcessor.execute(ingestDocument, (result, e) -> {});
 
         SimulateProcessorResult expectedResult = new SimulateProcessorResult(actualProcessor.getTag(), ingestDocument);
+        expectedResult.getIngestDocument().getIngestMetadata().put("pipeline", pipelineId);
 
         verify(ingestService, Mockito.atLeast(2)).getPipeline(pipelineId);
         assertThat(resultList.size(), equalTo(4));
@@ -482,6 +486,7 @@ pipelineId, null, null, new CompoundProcessor(
         trackingProcessor.execute(ingestDocument, (result, e) -> {});
 
         SimulateProcessorResult expectedResult = new SimulateProcessorResult(actualProcessor.getTag(), ingestDocument);
+        expectedResult.getIngestDocument().getIngestMetadata().put("pipeline", pipelineId);
 
         verify(ingestService,  Mockito.atLeast(2)).getPipeline(pipelineId);
         assertThat(resultList.size(), equalTo(2));

From b767760b5c21fbf9496e876b5d7712a8f4a7a56c Mon Sep 17 00:00:00 2001
From: Robin Clarke <robin.clarke@elastic.co>
Date: Wed, 15 Jan 2020 16:15:53 +0100
Subject: [PATCH 594/686] [Docs] Fix sub-heading in start-stop-ilm.asciidoc
 (#51045)

Removed superfluous `=`.
---
 docs/reference/ilm/start-stop-ilm.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/ilm/start-stop-ilm.asciidoc b/docs/reference/ilm/start-stop-ilm.asciidoc
index fcbbbcd811545..dc9ecb817c407 100644
--- a/docs/reference/ilm/start-stop-ilm.asciidoc
+++ b/docs/reference/ilm/start-stop-ilm.asciidoc
@@ -79,7 +79,7 @@ The operating modes of ILM:
 |===
 
 [float]
-=== Stopping ILM=
+=== Stopping ILM
 
 The ILM service can be paused such that no further steps will be executed
 using the <<ilm-stop,Stop API>>.

From de2d9a24eed7174e19c86926d093b3775c037995 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Wed, 15 Jan 2020 09:45:44 -0700
Subject: [PATCH 595/686] Guard against null settings in CCRIndexLifecycleIT
 (#51008)

It's possible that the index could return no settings and thus throw a
`NullPointerException`.

I wasn't able to reproduce the original issue, but this should guard
against in the future.

Resolves #50646
---
 .../org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java   | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java b/x-pack/plugin/ilm/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java
index 4dfdc507350b5..3933a1cd70365 100644
--- a/x-pack/plugin/ilm/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java
+++ b/x-pack/plugin/ilm/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java
@@ -34,6 +34,7 @@
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
+import java.util.Optional;
 import java.util.concurrent.TimeUnit;
 
 import static java.util.Collections.singletonMap;
@@ -742,8 +743,10 @@ private static Object getIndexSetting(RestClient client, String index, String se
         Request request = new Request("GET", "/" + index + "/_settings");
         request.addParameter("flat_settings", "true");
         Map<String, Object> response = toMap(client.performRequest(request));
-        Map<?, ?> settings = (Map<?, ?>) ((Map<?, ?>) response.get(index)).get("settings");
-        return settings.get(setting);
+        return Optional.ofNullable((Map<?, ?>) response.get(index))
+            .map(m -> (Map<?, ?>) m.get("settings"))
+            .map(m -> m.get(setting))
+            .orElse(null);
     }
 
     private void assertDocumentExists(RestClient client, String index, String id) throws IOException {

From 826aa4cd0383e00f48c3c1c1c137d661e9189918 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Wed, 15 Jan 2020 09:46:34 -0700
Subject: [PATCH 596/686] Add blurb about ILM-injected unfollow action (#51009)

These injected actions are harmless and safe to ignore for non-CCR indices.

Resolves #50548
---
 docs/reference/ilm/policy-definitions.asciidoc | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/reference/ilm/policy-definitions.asciidoc b/docs/reference/ilm/policy-definitions.asciidoc
index b8c4121278e16..4cfa87489165a 100644
--- a/docs/reference/ilm/policy-definitions.asciidoc
+++ b/docs/reference/ilm/policy-definitions.asciidoc
@@ -670,7 +670,9 @@ PUT _ilm/policy/my_policy
 [IMPORTANT]
 This action may be used explicitly, as shown below, but this action is also run
 before <<ilm-rollover-action,the Rollover action>> and <<ilm-shrink-action,the
-Shrink action>> as described in the documentation for those actions.
+Shrink action>> as described in the documentation for those actions. This is
+expected and safe for non-CCR indices to run, as the steps are skipped when CCR
+is not in use.
 
 This action turns a {ref}/ccr-apis.html[ccr] follower index
 into a regular index. This can be desired when moving follower

From 674732f8e16db188a18beb3cbdc52fd77291fd58 Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Wed, 15 Jan 2020 18:05:54 +0100
Subject: [PATCH 597/686] Add analysis components and mapping types to the
 usage API. (#51031)

Knowing about used analysis components and mapping types would be incredibly
useful in order to know which ones may be deprecated or should get more love.

Some field types also act as a proxy to know about feature usage of some APIs
like the `percolator` or `completion` fields types for percolation and the
completion suggester, respectively.
---
 .../xpack/core/XPackClientPlugin.java         |   4 +-
 .../elasticsearch/xpack/core/XPackField.java  |   2 +
 .../elasticsearch/xpack/core/XPackPlugin.java |   3 +
 .../core/action/XPackUsageFeatureAction.java  |   3 +-
 .../xpack/oss/IndexFeatureSetUsage.java       | 185 ++++++++++++++++++
 .../xpack/oss/IndexUsageTransportAction.java  | 147 ++++++++++++++
 .../elasticsearch/xpack/oss/package-info.java |  10 +
 .../xpack/oss/IndexFeatureSetUsageTests.java  | 168 ++++++++++++++++
 .../oss/IndexUsageTransportActionTests.java   | 106 ++++++++++
 .../rest-api-spec/test/xpack/15_basic.yml     |  88 +++++++++
 10 files changed, 714 insertions(+), 2 deletions(-)
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsage.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexUsageTransportAction.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/package-info.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsageTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexUsageTransportActionTests.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
index 82daf97cb0b54..3c7a0c7615945 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackClientPlugin.java
@@ -236,6 +236,7 @@
 import org.elasticsearch.xpack.core.watcher.transport.actions.put.PutWatchAction;
 import org.elasticsearch.xpack.core.watcher.transport.actions.service.WatcherServiceAction;
 import org.elasticsearch.xpack.core.watcher.transport.actions.stats.WatcherStatsAction;
+import org.elasticsearch.xpack.oss.IndexFeatureSetUsage;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -561,7 +562,8 @@ public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
                 // Spatial
                 new NamedWriteableRegistry.Entry(XPackFeatureSet.Usage.class, XPackField.SPATIAL, SpatialFeatureSetUsage::new),
                 // data science
-                new NamedWriteableRegistry.Entry(XPackFeatureSet.Usage.class, XPackField.ANALYTICS, AnalyticsFeatureSetUsage::new)
+                new NamedWriteableRegistry.Entry(XPackFeatureSet.Usage.class, XPackField.ANALYTICS, AnalyticsFeatureSetUsage::new),
+                new NamedWriteableRegistry.Entry(XPackFeatureSet.Usage.class, XPackField.INDEX, IndexFeatureSetUsage::new)
             ).stream(),
             MlEvaluationNamedXContentProvider.getNamedWriteables().stream()
         ).collect(toList());
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackField.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackField.java
index 8a74272429f87..3a836931b45a3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackField.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackField.java
@@ -53,6 +53,8 @@ public final class XPackField {
     public static final String ANALYTICS = "analytics";
     /** Name constant for the enrich plugin. */
     public static final String ENRICH = "enrich";
+    /** Name constant for indices. */
+    public static final String INDEX = "index";
 
     private XPackField() {}
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
index 9a2d5fd65eb6d..7a0307308b95a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/XPackPlugin.java
@@ -59,6 +59,7 @@
 import org.elasticsearch.xpack.core.action.TransportXPackUsageAction;
 import org.elasticsearch.xpack.core.action.XPackInfoAction;
 import org.elasticsearch.xpack.core.action.XPackUsageAction;
+import org.elasticsearch.xpack.core.action.XPackUsageFeatureAction;
 import org.elasticsearch.xpack.core.action.XPackUsageResponse;
 import org.elasticsearch.xpack.core.ml.MlMetadata;
 import org.elasticsearch.xpack.core.rest.action.RestReloadAnalyzersAction;
@@ -68,6 +69,7 @@
 import org.elasticsearch.xpack.core.ssl.SSLConfigurationReloader;
 import org.elasticsearch.xpack.core.ssl.SSLService;
 import org.elasticsearch.xpack.core.watcher.WatcherMetaData;
+import org.elasticsearch.xpack.oss.IndexUsageTransportAction;
 
 import java.nio.file.Files;
 import java.nio.file.Path;
@@ -255,6 +257,7 @@ public Collection<Object> createComponents(Client client, ClusterService cluster
         actions.add(new ActionHandler<>(XPackUsageAction.INSTANCE, getUsageAction()));
         actions.addAll(licensing.getActions());
         actions.add(new ActionHandler<>(ReloadAnalyzerAction.INSTANCE, TransportReloadAnalyzersAction.class));
+        actions.add(new ActionHandler<>(XPackUsageFeatureAction.INDEX, IndexUsageTransportAction.class));
         return actions;
     }
 
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/action/XPackUsageFeatureAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/action/XPackUsageFeatureAction.java
index fe43f9661488a..15e18ef38a4f9 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/action/XPackUsageFeatureAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/action/XPackUsageFeatureAction.java
@@ -40,10 +40,11 @@ public class XPackUsageFeatureAction extends ActionType<XPackUsageFeatureRespons
     public static final XPackUsageFeatureAction FROZEN_INDICES = new XPackUsageFeatureAction(XPackField.FROZEN_INDICES);
     public static final XPackUsageFeatureAction SPATIAL = new XPackUsageFeatureAction(XPackField.SPATIAL);
     public static final XPackUsageFeatureAction ANALYTICS = new XPackUsageFeatureAction(XPackField.ANALYTICS);
+    public static final XPackUsageFeatureAction INDEX = new XPackUsageFeatureAction(XPackField.INDEX);
 
     public static final List<XPackUsageFeatureAction> ALL = Arrays.asList(
         SECURITY, MONITORING, WATCHER, GRAPH, MACHINE_LEARNING, LOGSTASH, SQL, ROLLUP, INDEX_LIFECYCLE, SNAPSHOT_LIFECYCLE, CCR,
-        TRANSFORM, FLATTENED, VECTORS, VOTING_ONLY, FROZEN_INDICES, SPATIAL, ANALYTICS
+        TRANSFORM, FLATTENED, VECTORS, VOTING_ONLY, FROZEN_INDICES, SPATIAL, ANALYTICS, INDEX
     );
 
     private XPackUsageFeatureAction(String name) {
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsage.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsage.java
new file mode 100644
index 0000000000000..cd779d09d52ac
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsage.java
@@ -0,0 +1,185 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.oss;
+
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.core.XPackFeatureSet;
+import org.elasticsearch.xpack.core.XPackField;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.Objects;
+import java.util.Set;
+import java.util.TreeSet;
+
+public class IndexFeatureSetUsage extends XPackFeatureSet.Usage {
+
+    private static Set<String> sort(Set<String> set) {
+        return Collections.unmodifiableSet(new TreeSet<>(set));
+    }
+
+    private final Set<String> usedFieldTypes;
+    private final Set<String> usedCharFilters, usedTokenizers, usedTokenFilters, usedAnalyzers;
+    private final Set<String> usedBuiltInCharFilters, usedBuiltInTokenizers, usedBuiltInTokenFilters, usedBuiltInAnalyzers;
+
+    public IndexFeatureSetUsage(Set<String> usedFieldTypes,
+            Set<String> usedCharFilters, Set<String> usedTokenizers, Set<String> usedTokenFilters, Set<String> usedAnalyzers,
+            Set<String> usedBuiltInCharFilters, Set<String> usedBuiltInTokenizers, Set<String> usedBuiltInTokenFilters,
+            Set<String> usedBuiltInAnalyzers) {
+        super(XPackField.INDEX, true, true);
+        this.usedFieldTypes = sort(usedFieldTypes);
+        this.usedCharFilters = sort(usedCharFilters);
+        this.usedTokenizers = sort(usedTokenizers);
+        this.usedTokenFilters = sort(usedTokenFilters);
+        this.usedAnalyzers = sort(usedAnalyzers);
+        this.usedBuiltInCharFilters = sort(usedBuiltInCharFilters);
+        this.usedBuiltInTokenizers = sort(usedBuiltInTokenizers);
+        this.usedBuiltInTokenFilters = sort(usedBuiltInTokenFilters);
+        this.usedBuiltInAnalyzers = sort(usedBuiltInAnalyzers);
+    }
+
+    public IndexFeatureSetUsage(StreamInput input) throws IOException {
+        super(input);
+        usedFieldTypes = input.readSet(StreamInput::readString);
+        usedCharFilters = input.readSet(StreamInput::readString);
+        usedTokenizers = input.readSet(StreamInput::readString);
+        usedTokenFilters = input.readSet(StreamInput::readString);
+        usedAnalyzers = input.readSet(StreamInput::readString);
+        usedBuiltInCharFilters = input.readSet(StreamInput::readString);
+        usedBuiltInTokenizers = input.readSet(StreamInput::readString);
+        usedBuiltInTokenFilters = input.readSet(StreamInput::readString);
+        usedBuiltInAnalyzers = input.readSet(StreamInput::readString);
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        super.writeTo(out);
+        out.writeCollection(usedFieldTypes, StreamOutput::writeString);
+        out.writeCollection(usedCharFilters, StreamOutput::writeString);
+        out.writeCollection(usedTokenizers, StreamOutput::writeString);
+        out.writeCollection(usedTokenFilters, StreamOutput::writeString);
+        out.writeCollection(usedAnalyzers, StreamOutput::writeString);
+        out.writeCollection(usedBuiltInCharFilters, StreamOutput::writeString);
+        out.writeCollection(usedBuiltInTokenizers, StreamOutput::writeString);
+        out.writeCollection(usedBuiltInTokenFilters, StreamOutput::writeString);
+        out.writeCollection(usedBuiltInAnalyzers, StreamOutput::writeString);
+    }
+
+    /**
+     * Return the set of used field types in the cluster.
+     */
+    public Set<String> getUsedFieldTypes() {
+        return usedFieldTypes;
+    }
+
+    /**
+     * Return the set of used char filters in the cluster.
+     */
+    public Set<String> getUsedCharFilterTypes() {
+        return usedCharFilters;
+    }
+
+    /**
+     * Return the set of used tokenizers in the cluster.
+     */
+    public Set<String> getUsedTokenizerTypes() {
+        return usedTokenizers;
+    }
+
+    /**
+     * Return the set of used token filters in the cluster.
+     */
+    public Set<String> getUsedTokenFilterTypes() {
+        return usedTokenFilters;
+    }
+
+    /**
+     * Return the set of used analyzers in the cluster.
+     */
+    public Set<String> getUsedAnalyzerTypes() {
+        return usedAnalyzers;
+    }
+
+    /**
+     * Return the set of used built-in char filters in the cluster.
+     */
+    public Set<String> getUsedBuiltInCharFilters() {
+        return usedCharFilters;
+    }
+
+    /**
+     * Return the set of used built-in tokenizers in the cluster.
+     */
+    public Set<String> getUsedBuiltInTokenizers() {
+        return usedTokenizers;
+    }
+
+    /**
+     * Return the set of used built-in token filters in the cluster.
+     */
+    public Set<String> getUsedBuiltInTokenFilters() {
+        return usedTokenFilters;
+    }
+
+    /**
+     * Return the set of used built-in analyzers in the cluster.
+     */
+    public Set<String> getUsedBuiltInAnalyzers() {
+        return usedAnalyzers;
+    }
+
+    @Override
+    protected void innerXContent(XContentBuilder builder, Params params) throws IOException {
+        super.innerXContent(builder, params);
+
+        builder.startObject("analysis");
+        {
+            builder.field("char_filter_types", usedCharFilters);
+            builder.field("tokenizer_types", usedTokenizers);
+            builder.field("filter_types", usedTokenFilters);
+            builder.field("analyzer_types", usedAnalyzers);
+
+            builder.field("built_in_char_filters", usedBuiltInCharFilters);
+            builder.field("built_in_tokenizers", usedBuiltInTokenizers);
+            builder.field("built_in_filters", usedBuiltInTokenFilters);
+            builder.field("built_in_analyzers", usedBuiltInAnalyzers);
+        }
+        builder.endObject();
+
+        builder.startObject("mappings");
+        {
+            builder.field("field_types", usedFieldTypes);
+        }
+        builder.endObject();
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        IndexFeatureSetUsage that = (IndexFeatureSetUsage) o;
+        return available == that.available && enabled == that.enabled &&
+                Objects.equals(usedFieldTypes, that.usedFieldTypes) &&
+                Objects.equals(usedCharFilters, that.usedCharFilters) &&
+                Objects.equals(usedTokenizers, that.usedTokenizers) &&
+                Objects.equals(usedTokenFilters, that.usedTokenFilters) &&
+                Objects.equals(usedAnalyzers, that.usedAnalyzers) &&
+                Objects.equals(usedBuiltInCharFilters, that.usedBuiltInCharFilters) &&
+                Objects.equals(usedBuiltInTokenizers, that.usedBuiltInTokenizers) &&
+                Objects.equals(usedBuiltInTokenFilters, that.usedBuiltInTokenFilters) &&
+                Objects.equals(usedBuiltInAnalyzers, that.usedBuiltInAnalyzers);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(available, enabled, usedFieldTypes, usedCharFilters, usedTokenizers, usedTokenFilters,
+                usedAnalyzers, usedBuiltInCharFilters, usedBuiltInTokenizers, usedBuiltInTokenFilters,
+                usedBuiltInAnalyzers);
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexUsageTransportAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexUsageTransportAction.java
new file mode 100644
index 0000000000000..dd0e002c93e84
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexUsageTransportAction.java
@@ -0,0 +1,147 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.oss;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
+import org.elasticsearch.cluster.metadata.MappingMetaData;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.inject.Inject;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.protocol.xpack.XPackUsageRequest;
+import org.elasticsearch.tasks.Task;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.action.XPackUsageFeatureAction;
+import org.elasticsearch.xpack.core.action.XPackUsageFeatureResponse;
+import org.elasticsearch.xpack.core.action.XPackUsageFeatureTransportAction;
+
+import java.util.Collection;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Consumer;
+
+public class IndexUsageTransportAction extends XPackUsageFeatureTransportAction {
+
+    @Inject
+    public IndexUsageTransportAction(TransportService transportService, ClusterService clusterService, ThreadPool threadPool,
+                                     ActionFilters actionFilters, IndexNameExpressionResolver indexNameExpressionResolver) {
+        super(XPackUsageFeatureAction.INDEX.name(), transportService, clusterService, threadPool, actionFilters,
+            indexNameExpressionResolver);
+    }
+
+    @Override
+    protected void masterOperation(Task task, XPackUsageRequest request, ClusterState state,
+                                   ActionListener<XPackUsageFeatureResponse> listener) {
+
+        final Set<String> usedFieldTypes = new HashSet<>();
+        final Set<String> usedCharFilters = new HashSet<>();
+        final Set<String> usedTokenizers = new HashSet<>();
+        final Set<String> usedTokenFilters = new HashSet<>();
+        final Set<String> usedAnalyzers = new HashSet<>();
+        final Set<String> usedBuiltInCharFilters = new HashSet<>();
+        final Set<String> usedBuiltInTokenizers = new HashSet<>();
+        final Set<String> usedBuiltInTokenFilters = new HashSet<>();
+        final Set<String> usedBuiltInAnalyzers = new HashSet<>();
+
+        for (IndexMetaData indexMetaData : state.metaData()) {
+            MappingMetaData mappingMetaData = indexMetaData.mapping();
+            if (mappingMetaData != null) {
+                visitMapping(mappingMetaData.getSourceAsMap(), fieldMapping -> {
+                    Object type = fieldMapping.get("type");
+                    if (type != null) {
+                        usedFieldTypes.add(type.toString());
+                    } else if (fieldMapping.containsKey("properties")) {
+                        usedFieldTypes.add("object");
+                    }
+
+                    for (String key : new String[] { "analyzer", "search_analyzer", "search_quote_analyzer" }) {
+                        Object analyzer = fieldMapping.get(key);
+                        if (analyzer != null) {
+                            usedBuiltInAnalyzers.add(analyzer.toString());
+                        }
+                    }
+                });
+            }
+
+            Settings indexSettings = indexMetaData.getSettings();
+
+            Map<String, Settings> analyzerSettings = indexSettings.getGroups("index.analysis.analyzer");
+            usedBuiltInAnalyzers.removeAll(analyzerSettings.keySet());
+            for (Settings analyzerSetting : analyzerSettings.values()) {
+                usedAnalyzers.add(analyzerSetting.get("type", "custom"));
+                usedBuiltInCharFilters.addAll(analyzerSetting.getAsList("char_filter"));
+                String tokenizer = analyzerSetting.get("tokenizer");
+                if (tokenizer != null) {
+                    usedBuiltInTokenizers.add(tokenizer);
+                }
+                usedBuiltInTokenFilters.addAll(analyzerSetting.getAsList("filter"));
+            }
+
+            Map<String, Settings> charFilterSettings = indexSettings.getGroups("index.analysis.char_filter");
+            usedBuiltInCharFilters.removeAll(charFilterSettings.keySet());
+            aggregateAnalysisTypes(charFilterSettings.values(), usedCharFilters);
+
+            Map<String, Settings> tokenizerSettings = indexSettings.getGroups("index.analysis.tokenizer");
+            usedBuiltInTokenizers.removeAll(tokenizerSettings.keySet());
+            aggregateAnalysisTypes(tokenizerSettings.values(), usedTokenizers);
+
+            Map<String, Settings> tokenFilterSettings = indexSettings.getGroups("index.analysis.filter");
+            usedBuiltInTokenFilters.removeAll(tokenFilterSettings.keySet());
+            aggregateAnalysisTypes(tokenFilterSettings.values(), usedTokenFilters);
+        }
+
+        listener.onResponse(new XPackUsageFeatureResponse(
+                new IndexFeatureSetUsage(usedFieldTypes,
+                        usedCharFilters, usedTokenizers, usedTokenFilters, usedAnalyzers,
+                        usedBuiltInCharFilters, usedBuiltInTokenizers, usedBuiltInTokenFilters, usedBuiltInAnalyzers)));
+    }
+
+    static void visitMapping(Map<String, ?> mapping, Consumer<Map<String, ?>> fieldMappingConsumer) {
+        Object properties = mapping.get("properties");
+        if (properties != null && properties instanceof Map) {
+            @SuppressWarnings("unchecked")
+            Map<String, ?> propertiesAsMap = (Map<String, ?>) properties;
+            for (Object v : propertiesAsMap.values()) {
+                if (v != null && v instanceof Map) {
+
+                    @SuppressWarnings("unchecked")
+                    Map<String, ?> fieldMapping = (Map<String, ?>) v;
+                    fieldMappingConsumer.accept(fieldMapping);
+                    visitMapping(fieldMapping, fieldMappingConsumer);
+
+                    // Multi fields
+                    Object fieldsO = fieldMapping.get("fields");
+                    if (fieldsO != null && fieldsO instanceof Map) {
+                        @SuppressWarnings("unchecked")
+                        Map<String, ?> fields = (Map<String, ?>) fieldsO;
+                        for (Object v2 : fields.values()) {
+                            if (v2 instanceof Map) {
+                                @SuppressWarnings("unchecked")
+                                Map<String, ?> fieldMapping2 = (Map<String, ?>) v2;
+                                fieldMappingConsumer.accept(fieldMapping2);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+
+    static void aggregateAnalysisTypes(Collection<Settings> analysisComponents, Set<String> usedTypes) {
+        for (Settings settings : analysisComponents) {
+            String type = settings.get("type");
+            if (type != null) {
+                usedTypes.add(type);
+            }
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/package-info.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/package-info.java
new file mode 100644
index 0000000000000..56582e0746737
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+/**
+ * Package containing usage information for features that are exposed in OSS.
+ */
+package org.elasticsearch.xpack.oss;
\ No newline at end of file
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsageTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsageTests.java
new file mode 100644
index 0000000000000..078a17a7aa555
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsageTests.java
@@ -0,0 +1,168 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.oss;
+
+import org.elasticsearch.common.io.stream.Writeable.Reader;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+
+import java.io.IOException;
+import java.util.HashSet;
+import java.util.Set;
+
+public class IndexFeatureSetUsageTests extends AbstractWireSerializingTestCase<IndexFeatureSetUsage> {
+
+    @Override
+    protected Reader<IndexFeatureSetUsage> instanceReader() {
+        return IndexFeatureSetUsage::new;
+    }
+
+    @Override
+    protected IndexFeatureSetUsage createTestInstance() {
+        Set<String> fields = new HashSet<>();
+        if (randomBoolean()) {
+            fields.add("keyword");
+        }
+        if (randomBoolean()) {
+            fields.add("integer");
+        }
+
+        Set<String> charFilters = new HashSet<>();
+        if (randomBoolean()) {
+            charFilters.add("pattern_replace");
+        }
+
+        Set<String> tokenizers = new HashSet<>();
+        if (randomBoolean()) {
+            tokenizers.add("whitespace");
+        }
+
+        Set<String> tokenFilters = new HashSet<>();
+        if (randomBoolean()) {
+            tokenFilters.add("stop");
+        }
+
+        Set<String> analyzers = new HashSet<>();
+        if (randomBoolean()) {
+            tokenFilters.add("english");
+        }
+
+        Set<String> builtInCharFilters = new HashSet<>();
+        if (randomBoolean()) {
+            builtInCharFilters.add("html_strip");
+        }
+
+        Set<String> builtInTokenizers = new HashSet<>();
+        if (randomBoolean()) {
+            builtInTokenizers.add("keyword");
+        }
+
+        Set<String> builtInTokenFilters = new HashSet<>();
+        if (randomBoolean()) {
+            builtInTokenFilters.add("trim");
+        }
+
+        Set<String> builtInAnalyzers = new HashSet<>();
+        if (randomBoolean()) {
+            builtInAnalyzers.add("french");
+        }
+
+        return new IndexFeatureSetUsage(fields,
+                charFilters, tokenizers, tokenFilters, analyzers,
+                builtInCharFilters, builtInTokenizers, builtInTokenFilters, builtInAnalyzers);
+    }
+
+    @Override
+    protected IndexFeatureSetUsage mutateInstance(IndexFeatureSetUsage instance) throws IOException {
+        switch (randomInt(8)) {
+        case 0:
+            Set<String> fields = new HashSet<>(instance.getUsedFieldTypes());
+            if (fields.add("keyword") == false) {
+                fields.remove("keyword");
+            }
+            return new IndexFeatureSetUsage(fields, instance.getUsedCharFilterTypes(), instance.getUsedTokenizerTypes(),
+                    instance.getUsedTokenFilterTypes(), instance.getUsedAnalyzerTypes(), instance.getUsedBuiltInCharFilters(),
+                    instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
+                    instance.getUsedBuiltInAnalyzers());
+        case 1:
+            Set<String> charFilters = new HashSet<>(instance.getUsedCharFilterTypes());
+            if (charFilters.add("pattern_replace") == false) {
+                charFilters.remove("pattern_replace");
+            }
+            return new IndexFeatureSetUsage(instance.getUsedFieldTypes(), charFilters, instance.getUsedTokenizerTypes(),
+                    instance.getUsedTokenFilterTypes(), instance.getUsedAnalyzerTypes(), instance.getUsedBuiltInCharFilters(),
+                    instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
+                    instance.getUsedBuiltInAnalyzers());
+        case 2:
+            Set<String> tokenizers = new HashSet<>(instance.getUsedTokenizerTypes());
+            if (tokenizers.add("whitespace") == false) {
+                tokenizers.remove("whitespace");
+            }
+            return new IndexFeatureSetUsage(instance.getUsedFieldTypes(), instance.getUsedCharFilterTypes(), tokenizers,
+                    instance.getUsedTokenFilterTypes(), instance.getUsedAnalyzerTypes(), instance.getUsedBuiltInCharFilters(),
+                    instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
+                    instance.getUsedBuiltInAnalyzers());
+        case 3:
+            Set<String> tokenFilters = new HashSet<>(instance.getUsedTokenFilterTypes());
+            if (tokenFilters.add("stop") == false) {
+                tokenFilters.remove("stop");
+            }
+            return new IndexFeatureSetUsage(instance.getUsedFieldTypes(), instance.getUsedCharFilterTypes(),
+                    instance.getUsedTokenizerTypes(),
+                    tokenFilters, instance.getUsedAnalyzerTypes(), instance.getUsedBuiltInCharFilters(),
+                    instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
+                    instance.getUsedBuiltInAnalyzers());
+        case 4:
+            Set<String> analyzers = new HashSet<>(instance.getUsedAnalyzerTypes());
+            if (analyzers.add("english") == false) {
+                analyzers.remove("english");
+            }
+            return new IndexFeatureSetUsage(instance.getUsedFieldTypes(), instance.getUsedCharFilterTypes(),
+                    instance.getUsedTokenizerTypes(), instance.getUsedTokenFilterTypes(), analyzers,
+                    instance.getUsedBuiltInCharFilters(), instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
+                    instance.getUsedBuiltInAnalyzers());
+        case 5:
+            Set<String> builtInCharFilters = new HashSet<>();
+            if (builtInCharFilters.add("html_strip") == false) {
+                builtInCharFilters.remove("html_strip");
+            }
+            return new IndexFeatureSetUsage(instance.getUsedFieldTypes(), instance.getUsedCharFilterTypes(),
+                    instance.getUsedTokenizerTypes(),
+                    instance.getUsedTokenFilterTypes(), instance.getUsedAnalyzerTypes(), builtInCharFilters,
+                    instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
+                    instance.getUsedBuiltInAnalyzers());
+        case 6:
+            Set<String> builtInTokenizers = new HashSet<>();
+            if (builtInTokenizers.add("keyword") == false) {
+                builtInTokenizers.remove("keyword");
+            }
+            return new IndexFeatureSetUsage(instance.getUsedFieldTypes(), instance.getUsedCharFilterTypes(),
+                    instance.getUsedTokenizerTypes(), instance.getUsedTokenFilterTypes(), instance.getUsedAnalyzerTypes(),
+                    instance.getUsedBuiltInCharFilters(), builtInTokenizers, instance.getUsedBuiltInTokenFilters(),
+                    instance.getUsedBuiltInAnalyzers());
+        case 7:
+            Set<String> builtInTokenFilters = new HashSet<>();
+            if (builtInTokenFilters.add("trim") == false) {
+                builtInTokenFilters.remove("trim");
+            }
+            return new IndexFeatureSetUsage(instance.getUsedFieldTypes(), instance.getUsedCharFilterTypes(),
+                    instance.getUsedTokenizerTypes(), instance.getUsedTokenFilterTypes(), instance.getUsedAnalyzerTypes(),
+                    instance.getUsedBuiltInCharFilters(), instance.getUsedBuiltInTokenizers(), builtInTokenFilters,
+                    instance.getUsedBuiltInAnalyzers());
+        case 8:
+            Set<String> builtInAnalyzers = new HashSet<>();
+            if (builtInAnalyzers.add("french") == false) {
+                builtInAnalyzers.remove("french");
+            }
+            return new IndexFeatureSetUsage(instance.getUsedFieldTypes(), instance.getUsedCharFilterTypes(),
+                    instance.getUsedTokenizerTypes(), instance.getUsedTokenFilterTypes(), instance.getUsedAnalyzerTypes(),
+                    instance.getUsedBuiltInCharFilters(), instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
+                    builtInAnalyzers);
+        default:
+            throw new AssertionError();
+        }
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexUsageTransportActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexUsageTransportActionTests.java
new file mode 100644
index 0000000000000..605e8cc0e1534
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexUsageTransportActionTests.java
@@ -0,0 +1,106 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.oss;
+
+import org.elasticsearch.test.ESTestCase;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+
+public class IndexUsageTransportActionTests extends ESTestCase {
+
+    private static void collectTypes(Map<String, ?> mapping, Set<String> types) {
+        IndexUsageTransportAction.visitMapping(mapping,
+                m -> {
+                    if (m.containsKey("type")) {
+                        types.add(m.get("type").toString());
+                    } else {
+                        types.add("object");
+                    }
+                });
+    }
+
+    public void testCountTopLevelFields() {
+        Map<String, Object> mapping = new HashMap<>();
+        Set<String> fields = new HashSet<>();
+        collectTypes(mapping, fields);
+        assertEquals(Collections.emptySet(), fields);
+
+        Map<String, Object> properties = new HashMap<>();
+        mapping.put("properties", properties);
+
+        Map<String, Object> keywordField = new HashMap<>();
+        keywordField.put("type", "keyword");
+        properties.put("foo", keywordField);
+        collectTypes(mapping, fields);
+        assertEquals(Collections.singleton("keyword"), fields);
+
+        Map<String, Object> IndexField = new HashMap<>();
+        IndexField.put("type", "integer");
+        properties.put("bar", IndexField);
+        fields = new HashSet<>();
+        collectTypes(mapping, fields);
+        assertEquals(new HashSet<>(Arrays.asList("keyword", "integer")), fields);
+
+        properties.put("baz", IndexField);
+        fields = new HashSet<>();
+        collectTypes(mapping, fields);
+        assertEquals(new HashSet<>(Arrays.asList("keyword", "integer")), fields);
+    }
+
+    public void testCountMultiFields() {
+        Map<String, Object> keywordField = new HashMap<>();
+        keywordField.put("type", "keyword");
+
+        Map<String, Object> textField = new HashMap<>();
+        textField.put("type", "text");
+
+        Map<String, Object> fields = new HashMap<>();
+        fields.put("keyword", keywordField);
+        textField.put("fields", fields);
+
+        Map<String, Object> properties = new HashMap<>();
+        properties.put("foo", textField);
+
+        Map<String, Object> mapping = new HashMap<>();
+        mapping.put("properties", properties);
+
+        Set<String> usedFields = new HashSet<>();
+        collectTypes(mapping, usedFields);
+        assertEquals(new HashSet<>(Arrays.asList("keyword", "text")), usedFields);
+    }
+
+    public void testCountInnerFields() {
+        Map<String, Object> keywordField = new HashMap<>();
+        keywordField.put("type", "keyword");
+
+        Map<String, Object> properties = new HashMap<>();
+        properties.put("foo", keywordField);
+
+        Map<String, Object> objectMapping = new HashMap<>();
+        objectMapping.put("properties", properties);
+
+        Map<String, Object> mapping = new HashMap<>();
+
+        properties = new HashMap<>();
+        properties.put("obj", objectMapping);
+        mapping.put("properties", properties);
+        Set<String> fields = new HashSet<>();
+        collectTypes(mapping, fields);
+        assertEquals(new HashSet<>(Arrays.asList("keyword", "object")), fields);
+
+        properties.put("bar", keywordField);
+        fields = new HashSet<>();
+        collectTypes(mapping, fields);
+        assertEquals(new HashSet<>(Arrays.asList("keyword", "object")), fields);
+    }
+
+}
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/xpack/15_basic.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/xpack/15_basic.yml
index d8b25a29531bc..4757ee00360e9 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/xpack/15_basic.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/xpack/15_basic.yml
@@ -166,4 +166,92 @@
   - is_true:    features.monitoring.available
   - is_false:   tagline
 
+---
+"Usage stats for mappings":
+  - do:
+      xpack.usage: {}
+
+  - match: { index.mappings.field_types: [] }
+
+  - do:
+      indices.create:
+        index: test-index1
+        body:
+          mappings:
+            properties:
+              foo:
+                type: keyword
+
+  - do:
+      indices.create:
+        index: test-index2
+        body:
+          mappings:
+            properties:
+              foo:
+                type: keyword
+              bar:
+                properties:
+                  quux:
+                    type: integer
+
+  - do:
+      xpack.usage: {}
+
+  - match: { index.mappings.field_types: [ "integer", "keyword", "object" ] }
+
+---
+"Usage stats for analysis":
+  - do:
+      xpack.usage: {}
+
+  - match: { index.analysis.char_filter_types: [] }
+  - match: { index.analysis.tokenizer_types: [] }
+  - match: { index.analysis.filter_types: [] }
+  - match: { index.analysis.analyzer_types: [] }
+
+  - do:
+      indices.create:
+        index: test-index1
+        body:
+          settings:
+            analysis:
+              char_filter:
+                c:
+                  type: mapping
+                  mappings: [ "a => b" ]
+              tokenizer:
+                tok:
+                  type: pattern
+                  pattern: ","
+              filter:
+                st:
+                  type: stop
+                  stopwords: [ "a" ]
+              analyzer:
+                en:
+                  type: standard
+                  stopwords: "_english_"
+                cust:
+                  char_filter: [ "html_strip" ]
+                  tokenizer: "keyword"
+                  filter: [ "trim" ]
+          mappings:
+            properties:
+              message:
+                type: "text"
+                analyzer: french
+                search_analyzer: spanish
+                search_quote_analyzer: german
+
+  - do:
+      xpack.usage: {}
 
+  - match: { index.analysis.char_filter_types: [ "mapping" ] }
+  - match: { index.analysis.tokenizer_types: [ "pattern" ] }
+  - match: { index.analysis.filter_types: [ "stop" ] }
+  - match: { index.analysis.analyzer_types: [ "custom", "standard" ] }
+  - match: { index.analysis.built_in_char_filters: [ "html_strip" ] }
+  - match: { index.analysis.built_in_tokenizers: [ "keyword" ] }
+  - match: { index.analysis.built_in_filters: [ "trim" ] }
+  - match: { index.analysis.built_in_analyzers: [ "french", "german", "spanish" ] }

From 66d1f54401f2c8c8fc0b4fa11ee16907e06f5b12 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Wed, 15 Jan 2020 10:34:40 -0700
Subject: [PATCH 598/686] =?UTF-8?q?Address=20failures=20in=20SnapshotLifec?=
 =?UTF-8?q?ycleRestIT.testFullPolicySnap=E2=80=A6=20(#51055)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This test failed a couple of different ways, related to timing, as well
as concurrent snapshots, and also naming.

This commit splits the giant `assertBusy` into separate parts so that we don't
perform ~5 different requests and tests in the same loop. It also gives each
test a unique repository so that no other test can accidentally re-use
snapshots.

Resolves #50358 (hopefully!)
---
 .../xpack/slm/SnapshotLifecycleRestIT.java    | 23 +++++++++++--------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
index 07628b54c960e..b3c114b5e67fb 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
@@ -82,11 +82,10 @@ public void testMissingRepo() throws Exception {
     }
 
     @SuppressWarnings("unchecked")
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50358")
     public void testFullPolicySnapshot() throws Exception {
         final String indexName = "test";
         final String policyName = "test-policy";
-        final String repoId = "my-repo";
+        final String repoId = "full-policy-repo";
         int docCount = randomIntBetween(10, 50);
         List<IndexRequestBuilder> indexReqs = new ArrayList<>();
         for (int i = 0; i < docCount; i++) {
@@ -116,9 +115,12 @@ public void testFullPolicySnapshot() throws Exception {
             Map<String, Object> metadata = (Map<String, Object>) snapResponse.get(0).get("metadata");
             assertNotNull(metadata);
             assertThat(metadata.get("policy"), equalTo(policyName));
-            assertHistoryIsPresent(policyName, true, repoId, CREATE_OPERATION);
+        });
+
+        assertBusy(() -> assertHistoryIsPresent(policyName, true, repoId, CREATE_OPERATION));
 
-            // Check that the last success date was written to the cluster state
+        // Check that the last success date was written to the cluster state
+        assertBusy(() -> {
             Request getReq = new Request("GET", "/_slm/policy/" + policyName);
             Response policyMetadata = client().performRequest(getReq);
             Map<String, Object> policyResponseMap;
@@ -136,9 +138,10 @@ public void testFullPolicySnapshot() throws Exception {
 
             String lastSnapshotName = (String) lastSuccessObject.get("snapshot_name");
             assertThat(lastSnapshotName, startsWith("snap-"));
+        });
 
-            assertHistoryIsPresent(policyName, true, repoId, CREATE_OPERATION);
-
+        // Check that the stats are written
+        assertBusy(() -> {
             Map<String, Object> stats = getSLMStats();
             Map<String, Object> policyStats = policyStatsAsMap(stats);
             Map<String, Object> policyIdStats = (Map<String, Object>) policyStats.get(policyName);
@@ -155,7 +158,7 @@ public void testFullPolicySnapshot() throws Exception {
     @SuppressWarnings("unchecked")
     public void testPolicyFailure() throws Exception {
         final String policyName = "test-policy";
-        final String repoName = "test-repo";
+        final String repoName = "policy-failure-repo";
         final String indexPattern = "index-doesnt-exist";
         initializeRepo(repoName);
 
@@ -204,7 +207,7 @@ public void testPolicyFailure() throws Exception {
     public void testPolicyManualExecution() throws Exception {
         final String indexName = "test";
         final String policyName = "test-policy";
-        final String repoId = "my-repo";
+        final String repoId = "manual-execution-repo";
         int docCount = randomIntBetween(10, 50);
         for (int i = 0; i < docCount; i++) {
             index(client(), indexName, "" + i, "foo", "bar");
@@ -348,10 +351,10 @@ public void testStartStopStatus() throws Exception {
     @SuppressWarnings("unchecked")
     @TestIssueLogging(value = "org.elasticsearch.xpack.slm:TRACE,org.elasticsearch.xpack.core.slm:TRACE,org.elasticsearch.snapshots:TRACE",
         issueUrl = "https://github.com/elastic/elasticsearch/issues/48017")
-    public void testBasicTimeBasedRetenion() throws Exception {
+    public void testBasicTimeBasedRetention() throws Exception {
         final String indexName = "test";
         final String policyName = "test-policy";
-        final String repoId = "my-repo";
+        final String repoId = "time-based-retention-repo";
         int docCount = randomIntBetween(10, 50);
         List<IndexRequestBuilder> indexReqs = new ArrayList<>();
         for (int i = 0; i < docCount; i++) {

From d71846892ac02f4223c9acc1ce4ff72057fe9d87 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Wed, 15 Jan 2020 10:39:11 -0700
Subject: [PATCH 599/686] Fix AllocateRoutedStepTests reusing keys for random
 values (#51016)

In these tests there was a very small chance that keys could collide,
which causes test failures.

Resolves #49307
---
 .../xpack/core/ilm/AllocateActionTests.java   |  2 +-
 .../core/ilm/AllocationRoutedStepTests.java   | 21 +++++++++++++------
 2 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/AllocateActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/AllocateActionTests.java
index f19b31d659ffa..4b6700e7ac151 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/AllocateActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/AllocateActionTests.java
@@ -114,7 +114,7 @@ public static Map<String, String> randomMap(int minEntries, int maxEntries) {
         Map<String, String> map = new HashMap<>();
         int numIncludes = randomIntBetween(minEntries, maxEntries);
         for (int i = 0; i < numIncludes; i++) {
-            map.put(randomAlphaOfLengthBetween(1, 20), randomAlphaOfLengthBetween(1, 20));
+            map.put(randomAlphaOfLengthBetween(2, 20), randomAlphaOfLengthBetween(2, 20));
         }
         return map;
     }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/AllocationRoutedStepTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/AllocationRoutedStepTests.java
index f06b8c873e237..4d45e18b32671 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/AllocationRoutedStepTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/AllocationRoutedStepTests.java
@@ -196,8 +196,11 @@ public void testConditionNotMetDueToRelocation() {
     public void testExecuteAllocateNotComplete() throws Exception {
         Index index = new Index(randomAlphaOfLengthBetween(1, 20), randomAlphaOfLengthBetween(1, 20));
         Map<String, String> includes = AllocateActionTests.randomMap(1, 5);
-        Map<String, String> excludes = AllocateActionTests.randomMap(1, 5);
-        Map<String, String> requires = AllocateActionTests.randomMap(1, 5);
+        Map<String, String> excludes = randomValueOtherThanMany(map -> map.keySet().stream().anyMatch(includes::containsKey),
+            () -> AllocateActionTests.randomMap(1, 5));
+        Map<String, String> requires = randomValueOtherThanMany(map -> map.keySet().stream().anyMatch(includes::containsKey) ||
+                map.keySet().stream().anyMatch(excludes::containsKey),
+            () -> AllocateActionTests.randomMap(1, 5));
         Settings.Builder existingSettings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT.id)
                 .put(IndexMetaData.SETTING_INDEX_UUID, index.getUUID());
         Settings.Builder expectedSettings = Settings.builder();
@@ -230,8 +233,11 @@ public void testExecuteAllocateNotComplete() throws Exception {
     public void testExecuteAllocateNotCompleteOnlyOneCopyAllocated() throws Exception {
         Index index = new Index(randomAlphaOfLengthBetween(1, 20), randomAlphaOfLengthBetween(1, 20));
         Map<String, String> includes = AllocateActionTests.randomMap(1, 5);
-        Map<String, String> excludes = AllocateActionTests.randomMap(1, 5);
-        Map<String, String> requires = AllocateActionTests.randomMap(1, 5);
+        Map<String, String> excludes = randomValueOtherThanMany(map -> map.keySet().stream().anyMatch(includes::containsKey),
+            () -> AllocateActionTests.randomMap(1, 5));
+        Map<String, String> requires = randomValueOtherThanMany(map -> map.keySet().stream().anyMatch(includes::containsKey) ||
+                map.keySet().stream().anyMatch(excludes::containsKey),
+            () -> AllocateActionTests.randomMap(1, 5));
         Settings.Builder existingSettings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT.id)
                 .put(IndexMetaData.SETTING_INDEX_UUID, index.getUUID());
         Settings.Builder expectedSettings = Settings.builder();
@@ -266,8 +272,11 @@ public void testExecuteAllocateNotCompleteOnlyOneCopyAllocated() throws Exceptio
     public void testExecuteAllocateUnassigned() throws Exception {
         Index index = new Index(randomAlphaOfLengthBetween(1, 20), randomAlphaOfLengthBetween(1, 20));
         Map<String, String> includes = AllocateActionTests.randomMap(1, 5);
-        Map<String, String> excludes = AllocateActionTests.randomMap(1, 5);
-        Map<String, String> requires = AllocateActionTests.randomMap(1, 5);
+        Map<String, String> excludes = randomValueOtherThanMany(map -> map.keySet().stream().anyMatch(includes::containsKey),
+            () -> AllocateActionTests.randomMap(1, 5));
+        Map<String, String> requires = randomValueOtherThanMany(map -> map.keySet().stream().anyMatch(includes::containsKey) ||
+                map.keySet().stream().anyMatch(excludes::containsKey),
+            () -> AllocateActionTests.randomMap(1, 5));
         Settings.Builder existingSettings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT.id)
                 .put(IndexMetaData.SETTING_INDEX_UUID, index.getUUID());
         Settings.Builder expectedSettings = Settings.builder();

From bbcd397cc307c139d48e08859f65f24ec5344c32 Mon Sep 17 00:00:00 2001
From: markharwood <markharwood@gmail.com>
Date: Wed, 15 Jan 2020 18:29:37 +0000
Subject: [PATCH 600/686] Fix NPE in PinnedQuery call to DisjunctionMaxScorer.
 (#51047)

Fix NPE in PinnedQuery call to DisjunctionMaxScorer.
Added test and fix that tests for score type.
Closes #51034
---
 .../lucene/search/CappedScoreQuery.java       | 13 ++++++----
 .../PinnedQueryBuilderIT.java                 | 26 +++++++++++++++++++
 2 files changed, 34 insertions(+), 5 deletions(-)

diff --git a/x-pack/plugin/search-business-rules/src/main/java/org/apache/lucene/search/CappedScoreQuery.java b/x-pack/plugin/search-business-rules/src/main/java/org/apache/lucene/search/CappedScoreQuery.java
index 140e26c5e974c..9a8f4fbe38bd1 100644
--- a/x-pack/plugin/search-business-rules/src/main/java/org/apache/lucene/search/CappedScoreQuery.java
+++ b/x-pack/plugin/search-business-rules/src/main/java/org/apache/lucene/search/CappedScoreQuery.java
@@ -123,11 +123,14 @@ public ScorerSupplier scorerSupplier(LeafReaderContext context) throws IOExcepti
                         @Override
                         public Scorer get(long leadCost) throws IOException {
                             final Scorer innerScorer = innerScorerSupplier.get(leadCost);
-                            // short-circuit if scores will not need capping
-                            innerScorer.advanceShallow(0);
-                            if (innerScorer.getMaxScore(DocIdSetIterator.NO_MORE_DOCS) <= maxScore) {
-                              return innerScorer;
-                            }                            
+                            // test scoreMode to avoid NPE - see https://github.com/elastic/elasticsearch/issues/51034
+                            if (scoreMode == ScoreMode.TOP_SCORES) {                                
+                                // short-circuit if scores will not need capping
+                                innerScorer.advanceShallow(0);
+                                if (innerScorer.getMaxScore(DocIdSetIterator.NO_MORE_DOCS) <= maxScore) {
+                                  return innerScorer;
+                                }
+                            }
                             return new CappedScorer(innerWeight, innerScorer, maxScore);
                         }
 
diff --git a/x-pack/plugin/search-business-rules/src/test/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilderIT.java b/x-pack/plugin/search-business-rules/src/test/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilderIT.java
index 9f80e1c8ec91d..6aa69a2325a8f 100644
--- a/x-pack/plugin/search-business-rules/src/test/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilderIT.java
+++ b/x-pack/plugin/search-business-rules/src/test/java/org/elasticsearch/xpack/searchbusinessrules/PinnedQueryBuilderIT.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.index.query.QueryStringQueryBuilder;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.test.ESIntegTestCase;
@@ -141,6 +142,31 @@ public void testPinnedPromotions() throws Exception {
 
     }
 
+    /**
+     * Test scoring the entire set of documents, which uses a slightly different logic when creating scorers.
+     */
+    public void testExhaustiveScoring() throws Exception {
+        assertAcked(prepareCreate("test")
+                .setMapping(jsonBuilder().startObject().startObject("_doc").startObject("properties")
+                        .startObject("field1").field("analyzer", "whitespace").field("type", "text").endObject()
+                        .startObject("field2").field("analyzer", "whitespace").field("type", "text").endObject()
+                                .endObject().endObject().endObject())
+                .setSettings(Settings.builder().put(indexSettings()).put("index.number_of_shards", 1)));
+
+        client().prepareIndex("test").setId("1").setSource("field1", "foo").get();
+        client().prepareIndex("test").setId("2").setSource("field1", "foo", "field2", "foo").get();
+
+        refresh();
+
+        QueryStringQueryBuilder organicQuery = QueryBuilders.queryStringQuery("foo");
+        PinnedQueryBuilder pqb = new PinnedQueryBuilder(organicQuery, "2");
+        SearchResponse searchResponse = client().prepareSearch().setQuery(pqb).setTrackTotalHits(true)
+                .setSearchType(DFS_QUERY_THEN_FETCH).get();
+
+        long numHits = searchResponse.getHits().getTotalHits().value;
+        assertThat(numHits, equalTo(2L));
+    }    
+    
     public void testExplain() throws Exception {
         assertAcked(prepareCreate("test").setMapping(
                 jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field1")

From 9ae917a3945322cc86f45e8ec62d6c95f4eb08fd Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Wed, 15 Jan 2020 15:06:29 -0500
Subject: [PATCH 601/686] Move test of custom sig heuristic to plugin (#50891)

This moves the testing of custom significance heuristic plugins from an
`ESIntegTestCase` to an example plugin. This is *much* more "real" and
can be used as an example for anyone that needs to actually build such a
plugin. The old test had testing concerns and the example all jumbled
together.
---
 .../build.gradle                              |  28 ++++
 .../CustomSignificanceHeuristicPlugin.java    |  38 +++++
 .../customsigheuristic/SimpleHeuristic.java   |  90 +++++++++++
 ...ficanceHeuristicClientYamlTestSuiteIT.java |  36 +++++
 .../SimpleHeuristicWireTests.java             |  57 +++++++
 .../10_basic.yml                              |  16 ++
 .../20_custom_heuristic.yml                   | 121 +++++++++++++++
 .../SignificantTermsSignificanceScoreIT.java  | 145 +-----------------
 8 files changed, 388 insertions(+), 143 deletions(-)
 create mode 100644 plugins/examples/custom-significance-heuristic/build.gradle
 create mode 100644 plugins/examples/custom-significance-heuristic/src/main/java/org/elasticsearch/example/customsigheuristic/CustomSignificanceHeuristicPlugin.java
 create mode 100644 plugins/examples/custom-significance-heuristic/src/main/java/org/elasticsearch/example/customsigheuristic/SimpleHeuristic.java
 create mode 100644 plugins/examples/custom-significance-heuristic/src/test/java/org/elasticsearch/example/customsigheuristic/CustomSignificanceHeuristicClientYamlTestSuiteIT.java
 create mode 100644 plugins/examples/custom-significance-heuristic/src/test/java/org/elasticsearch/example/customsigheuristic/SimpleHeuristicWireTests.java
 create mode 100644 plugins/examples/custom-significance-heuristic/src/test/resources/rest-api-spec/test/custom-significance-heuristic/10_basic.yml
 create mode 100644 plugins/examples/custom-significance-heuristic/src/test/resources/rest-api-spec/test/custom-significance-heuristic/20_custom_heuristic.yml

diff --git a/plugins/examples/custom-significance-heuristic/build.gradle b/plugins/examples/custom-significance-heuristic/build.gradle
new file mode 100644
index 0000000000000..4aebd4ac31150
--- /dev/null
+++ b/plugins/examples/custom-significance-heuristic/build.gradle
@@ -0,0 +1,28 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+apply plugin: 'elasticsearch.testclusters'
+apply plugin: 'elasticsearch.esplugin'
+
+esplugin {
+  name 'custom-significance-heuristic'
+  description 'An example plugin showing how to write and register a custom significance heuristic'
+  classname 'org.elasticsearch.example.customsigheuristic.CustomSignificanceHeuristicPlugin'
+  licenseFile rootProject.file('licenses/APACHE-LICENSE-2.0.txt')
+  noticeFile rootProject.file('NOTICE.txt')
+}
diff --git a/plugins/examples/custom-significance-heuristic/src/main/java/org/elasticsearch/example/customsigheuristic/CustomSignificanceHeuristicPlugin.java b/plugins/examples/custom-significance-heuristic/src/main/java/org/elasticsearch/example/customsigheuristic/CustomSignificanceHeuristicPlugin.java
new file mode 100644
index 0000000000000..f0e5ae2a313e7
--- /dev/null
+++ b/plugins/examples/custom-significance-heuristic/src/main/java/org/elasticsearch/example/customsigheuristic/CustomSignificanceHeuristicPlugin.java
@@ -0,0 +1,38 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.example.customsigheuristic;
+
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.plugins.SearchPlugin;
+import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
+
+import java.util.List;
+
+import static java.util.Collections.singletonList;
+
+/**
+ * Plugin declaring a custom {@link SignificanceHeuristic}.
+ */
+public class CustomSignificanceHeuristicPlugin extends Plugin implements SearchPlugin {
+    @Override
+    public List<SignificanceHeuristicSpec<?>> getSignificanceHeuristics() {
+        return singletonList(new SignificanceHeuristicSpec<>(SimpleHeuristic.NAME, SimpleHeuristic::new, SimpleHeuristic.PARSER));
+    }
+}
diff --git a/plugins/examples/custom-significance-heuristic/src/main/java/org/elasticsearch/example/customsigheuristic/SimpleHeuristic.java b/plugins/examples/custom-significance-heuristic/src/main/java/org/elasticsearch/example/customsigheuristic/SimpleHeuristic.java
new file mode 100644
index 0000000000000..0f32330190f37
--- /dev/null
+++ b/plugins/examples/custom-significance-heuristic/src/main/java/org/elasticsearch/example/customsigheuristic/SimpleHeuristic.java
@@ -0,0 +1,90 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.example.customsigheuristic;
+
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic;
+
+import java.io.IOException;
+
+/**
+ * A simple {@linkplain SignificanceHeuristic} used an example of declaring a custom heuristic.
+ */
+public class SimpleHeuristic extends SignificanceHeuristic {
+    public static final String NAME = "simple";
+    public static final ObjectParser<SimpleHeuristic, Void> PARSER = new ObjectParser<>(NAME, SimpleHeuristic::new);
+
+    public SimpleHeuristic() {
+    }
+
+    /**
+     * Read from a stream.
+     */
+    public SimpleHeuristic(StreamInput in) throws IOException {
+        // Nothing to read
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        // Nothing to write
+    }
+
+    @Override
+    public String getWriteableName() {
+        return NAME;
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject(NAME).endObject();
+        return builder;
+    }
+
+    @Override
+    public int hashCode() {
+        return 1;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (obj == null) {
+            return false;
+        }
+        if (getClass() != obj.getClass()) {
+            return false;
+        }
+        return true;
+    }
+
+    /**
+     * @param subsetFreq   The frequency of the term in the selected sample
+     * @param subsetSize   The size of the selected sample (typically number of docs)
+     * @param supersetFreq The frequency of the term in the superset from which the sample was taken
+     * @param supersetSize The size of the superset from which the sample was taken  (typically number of docs)
+     * @return a "significance" score
+     */
+    @Override
+    public double getScore(long subsetFreq, long subsetSize, long supersetFreq, long supersetSize) {
+        return subsetFreq / subsetSize > supersetFreq / supersetSize ? 2.0 : 1.0;
+    }
+}
\ No newline at end of file
diff --git a/plugins/examples/custom-significance-heuristic/src/test/java/org/elasticsearch/example/customsigheuristic/CustomSignificanceHeuristicClientYamlTestSuiteIT.java b/plugins/examples/custom-significance-heuristic/src/test/java/org/elasticsearch/example/customsigheuristic/CustomSignificanceHeuristicClientYamlTestSuiteIT.java
new file mode 100644
index 0000000000000..b9ed2dda74d83
--- /dev/null
+++ b/plugins/examples/custom-significance-heuristic/src/test/java/org/elasticsearch/example/customsigheuristic/CustomSignificanceHeuristicClientYamlTestSuiteIT.java
@@ -0,0 +1,36 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.example.customsigheuristic;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+import org.elasticsearch.test.rest.yaml.ClientYamlTestCandidate;
+import org.elasticsearch.test.rest.yaml.ESClientYamlSuiteTestCase;
+
+public class CustomSignificanceHeuristicClientYamlTestSuiteIT extends ESClientYamlSuiteTestCase {
+    public CustomSignificanceHeuristicClientYamlTestSuiteIT(@Name("yaml") ClientYamlTestCandidate testCandidate) {
+        super(testCandidate);
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() throws Exception {
+        return ESClientYamlSuiteTestCase.createParameters();
+    }
+}
diff --git a/plugins/examples/custom-significance-heuristic/src/test/java/org/elasticsearch/example/customsigheuristic/SimpleHeuristicWireTests.java b/plugins/examples/custom-significance-heuristic/src/test/java/org/elasticsearch/example/customsigheuristic/SimpleHeuristicWireTests.java
new file mode 100644
index 0000000000000..e43ed8be5ba5a
--- /dev/null
+++ b/plugins/examples/custom-significance-heuristic/src/test/java/org/elasticsearch/example/customsigheuristic/SimpleHeuristicWireTests.java
@@ -0,0 +1,57 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.example.customsigheuristic;
+
+import org.elasticsearch.common.io.stream.Writeable.Reader;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentParser.Token;
+import org.elasticsearch.test.AbstractSerializingTestCase;
+
+import java.io.IOException;
+
+import static org.hamcrest.Matchers.equalTo;
+
+public class SimpleHeuristicWireTests extends AbstractSerializingTestCase<SimpleHeuristic> {
+    @Override
+    protected SimpleHeuristic doParseInstance(XContentParser parser) throws IOException {
+        /* Because Heuristics are XContent "fragments" we need to throw away
+         * the "extra" stuff before calling the parser. */
+        parser.nextToken();
+        assertThat(parser.currentToken(), equalTo(Token.START_OBJECT));
+        parser.nextToken();
+        assertThat(parser.currentToken(), equalTo(Token.FIELD_NAME));
+        assertThat(parser.currentName(), equalTo("simple"));
+        parser.nextToken();
+        SimpleHeuristic h = SimpleHeuristic.PARSER.apply(parser, null);
+        assertThat(parser.currentToken(), equalTo(Token.END_OBJECT));
+        parser.nextToken();
+        return h;
+    }
+
+    @Override
+    protected Reader<SimpleHeuristic> instanceReader() {
+        return SimpleHeuristic::new;
+    }
+
+    @Override
+    protected SimpleHeuristic createTestInstance() {
+        return new SimpleHeuristic();
+    }
+}
diff --git a/plugins/examples/custom-significance-heuristic/src/test/resources/rest-api-spec/test/custom-significance-heuristic/10_basic.yml b/plugins/examples/custom-significance-heuristic/src/test/resources/rest-api-spec/test/custom-significance-heuristic/10_basic.yml
new file mode 100644
index 0000000000000..620aa393a6b5b
--- /dev/null
+++ b/plugins/examples/custom-significance-heuristic/src/test/resources/rest-api-spec/test/custom-significance-heuristic/10_basic.yml
@@ -0,0 +1,16 @@
+# tests that the custom suggester plugin is installed
+---
+"plugin loaded":
+    - skip:
+        reason: "contains is a newly added assertion"
+        features: contains
+
+    # Get master node id
+    - do:
+        cluster.state: {}
+    - set: { master_node: master }
+
+    - do:
+        nodes.info: {}
+
+    - contains: { nodes.$master.plugins: { name: custom-significance-heuristic } }
diff --git a/plugins/examples/custom-significance-heuristic/src/test/resources/rest-api-spec/test/custom-significance-heuristic/20_custom_heuristic.yml b/plugins/examples/custom-significance-heuristic/src/test/resources/rest-api-spec/test/custom-significance-heuristic/20_custom_heuristic.yml
new file mode 100644
index 0000000000000..262c91403bfdb
--- /dev/null
+++ b/plugins/examples/custom-significance-heuristic/src/test/resources/rest-api-spec/test/custom-significance-heuristic/20_custom_heuristic.yml
@@ -0,0 +1,121 @@
+setup:
+  - do:
+      indices.create:
+        index: test
+        body:
+          mappings:
+            properties:
+              text:
+                type: text
+                fielddata: true
+              long:
+                type: long
+  - do:
+      bulk:
+        refresh: true
+        index: test
+        body:
+          - '{"index": {"_id": "1"}}'
+          - '{"text": "foo", "long": 1, "class": 1}'
+          - '{"index": {"_id": "2"}}'
+          - '{"text": "foo", "long": 1, "class": 1}'
+          - '{"index": {"_id": "3"}}'
+          - '{"text": "bar", "long": 0, "class": 0}'
+          - '{"index": {"_id": "4"}}'
+          - '{"text": "bar", "long": 0, "class": 0}'
+          - '{"index": {"_id": "5"}}'
+          - '{"text": ["foo", "bar"], "long": [1, 0], "class": 1}'
+          - '{"index": {"_id": "6"}}'
+          - '{"text": ["foo", "bar"], "long": [1, 0], "class": 0}'
+          - '{"index": {"_id": "7"}}'
+          - '{"text": "bar", "long": 0, "class": 0}'
+
+---
+"test custom heuristic on significant_text":
+  - do:
+      search:
+        index: test
+        size: 0
+        body:
+          aggs:
+            class:
+              terms:
+                field: class
+                order: { _key: asc }
+              aggs:
+                sig:
+                  significant_text:
+                    field: text
+                    simple: {}
+                    min_doc_count: 1
+
+  - match: { aggregations.class.buckets.0.key: 0 }
+  - match: { aggregations.class.buckets.0.sig.buckets.0.key: bar }
+  - match: { aggregations.class.buckets.0.sig.buckets.0.score: 2.0 }
+  - match: { aggregations.class.buckets.0.sig.buckets.1.key: foo }
+  - match: { aggregations.class.buckets.0.sig.buckets.1.score: 1.0 }
+  - match: { aggregations.class.buckets.1.key: 1 }
+  - match: { aggregations.class.buckets.1.sig.buckets.0.key: foo }
+  - match: { aggregations.class.buckets.1.sig.buckets.0.score: 2.0 }
+  - match: { aggregations.class.buckets.1.sig.buckets.1.key: bar }
+  - match: { aggregations.class.buckets.1.sig.buckets.1.score: 1.0 }
+
+---
+"test custom heuristic on text significant_terms":
+  - do:
+      search:
+        index: test
+        size: 0
+        body:
+          aggs:
+            class:
+              terms:
+                field: class
+                order: { _key: asc }
+              aggs:
+                sig:
+                  significant_terms:
+                    field: text
+                    simple: {}
+                    min_doc_count: 1
+
+  - match: { aggregations.class.buckets.0.key: 0 }
+  - match: { aggregations.class.buckets.0.sig.buckets.0.key: bar }
+  - match: { aggregations.class.buckets.0.sig.buckets.0.score: 2.0 }
+  - match: { aggregations.class.buckets.0.sig.buckets.1.key: foo }
+  - match: { aggregations.class.buckets.0.sig.buckets.1.score: 1.0 }
+  - match: { aggregations.class.buckets.1.key: 1 }
+  - match: { aggregations.class.buckets.1.sig.buckets.0.key: foo }
+  - match: { aggregations.class.buckets.1.sig.buckets.0.score: 2.0 }
+  - match: { aggregations.class.buckets.1.sig.buckets.1.key: bar }
+  - match: { aggregations.class.buckets.1.sig.buckets.1.score: 1.0 }
+
+---
+"test custom heuristic on long significant_terms":
+  - do:
+      search:
+        index: test
+        size: 0
+        body:
+          aggs:
+            class:
+              terms:
+                field: class
+                order: { _key: asc }
+              aggs:
+                sig:
+                  significant_terms:
+                    field: long
+                    simple: {}
+                    min_doc_count: 1
+
+  - match: { aggregations.class.buckets.0.key: 0 }
+  - match: { aggregations.class.buckets.0.sig.buckets.0.key: 0 }
+  - match: { aggregations.class.buckets.0.sig.buckets.0.score: 2.0 }
+  - match: { aggregations.class.buckets.0.sig.buckets.1.key: 1 }
+  - match: { aggregations.class.buckets.0.sig.buckets.1.score: 1.0 }
+  - match: { aggregations.class.buckets.1.key: 1 }
+  - match: { aggregations.class.buckets.1.sig.buckets.0.key: 1 }
+  - match: { aggregations.class.buckets.1.sig.buckets.0.score: 2.0 }
+  - match: { aggregations.class.buckets.1.sig.buckets.1.key: 0 }
+  - match: { aggregations.class.buckets.1.sig.buckets.1.score: 1.0 }
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
index 2c7d1de83f7b5..8b8864d3ecfdd 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/SignificantTermsSignificanceScoreIT.java
@@ -22,10 +22,7 @@
 import org.elasticsearch.action.search.SearchRequestBuilder;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.ToXContent;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
@@ -65,7 +62,6 @@
 import java.util.concurrent.ExecutionException;
 import java.util.function.Function;
 
-import static java.util.Collections.singletonList;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_REPLICAS;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
 import static org.elasticsearch.search.aggregations.AggregationBuilders.filter;
@@ -88,92 +84,14 @@ public class SignificantTermsSignificanceScoreIT extends ESIntegTestCase {
 
     @Override
     protected Collection<Class<? extends Plugin>> nodePlugins() {
-        return Arrays.asList(CustomSignificanceHeuristicPlugin.class);
+        return Arrays.asList(TestScriptPlugin.class);
     }
 
     public String randomExecutionHint() {
         return randomBoolean() ? null : randomFrom(SignificantTermsAggregatorFactory.ExecutionMode.values()).toString();
     }
 
-    public void testPlugin() throws Exception {
-        String type = randomBoolean() ? "text" : "long";
-        String settings = "{\"index.number_of_shards\": 1, \"index.number_of_replicas\": 0}";
-        SharedSignificantTermsTestMethods.index01Docs(type, settings, this);
-        SearchRequestBuilder request;
-        if ("text".equals(type) && randomBoolean()) {
-            // Use significant_text on text fields but occasionally run with alternative of
-            // significant_terms on legacy fieldData=true too.
-            request = client().prepareSearch(INDEX_NAME)
-                    .addAggregation(
-                            terms("class")
-                            .field(CLASS_FIELD)
-                                    .subAggregation((significantText("sig_terms", TEXT_FIELD))
-                                    .significanceHeuristic(new SimpleHeuristic())
-                                    .minDocCount(1)
-                            )
-                    );
-        }else
-        {
-            request = client().prepareSearch(INDEX_NAME)
-                    .addAggregation(
-                            terms("class")
-                            .field(CLASS_FIELD)
-                                    .subAggregation((significantTerms("sig_terms"))
-                                    .field(TEXT_FIELD)
-                                    .significanceHeuristic(new SimpleHeuristic())
-                                    .minDocCount(1)
-                            )
-                    );
-        }
-
-        SearchResponse response = request.get();
-        assertSearchResponse(response);
-        StringTerms classes = response.getAggregations().get("class");
-        assertThat(classes.getBuckets().size(), equalTo(2));
-        for (Terms.Bucket classBucket : classes.getBuckets()) {
-            Map<String, Aggregation> aggs = classBucket.getAggregations().asMap();
-            assertTrue(aggs.containsKey("sig_terms"));
-            SignificantTerms agg = (SignificantTerms) aggs.get("sig_terms");
-            assertThat(agg.getBuckets().size(), equalTo(2));
-            Iterator<SignificantTerms.Bucket> bucketIterator = agg.iterator();
-            SignificantTerms.Bucket sigBucket = bucketIterator.next();
-            String term = sigBucket.getKeyAsString();
-            String classTerm = classBucket.getKeyAsString();
-            assertTrue(term.equals(classTerm));
-            assertThat(sigBucket.getSignificanceScore(), closeTo(2.0, 1.e-8));
-            sigBucket = bucketIterator.next();
-            assertThat(sigBucket.getSignificanceScore(), closeTo(1.0, 1.e-8));
-        }
-
-        // we run the same test again but this time we do not call assertSearchResponse() before the assertions
-        // the reason is that this would trigger toXContent and we would like to check that this has no potential side effects
-
-        response = request.get();
-
-        classes = (StringTerms) response.getAggregations().get("class");
-        assertThat(classes.getBuckets().size(), equalTo(2));
-        for (Terms.Bucket classBucket : classes.getBuckets()) {
-            Map<String, Aggregation> aggs = classBucket.getAggregations().asMap();
-            assertTrue(aggs.containsKey("sig_terms"));
-            SignificantTerms agg = (SignificantTerms) aggs.get("sig_terms");
-            assertThat(agg.getBuckets().size(), equalTo(2));
-            Iterator<SignificantTerms.Bucket> bucketIterator = agg.iterator();
-            SignificantTerms.Bucket sigBucket = bucketIterator.next();
-            String term = sigBucket.getKeyAsString();
-            String classTerm = classBucket.getKeyAsString();
-            assertTrue(term.equals(classTerm));
-            assertThat(sigBucket.getSignificanceScore(), closeTo(2.0, 1.e-8));
-            sigBucket = bucketIterator.next();
-            assertThat(sigBucket.getSignificanceScore(), closeTo(1.0, 1.e-8));
-        }
-    }
-
-    public static class CustomSignificanceHeuristicPlugin extends MockScriptPlugin implements SearchPlugin {
-        @Override
-        public List<SignificanceHeuristicSpec<?>> getSignificanceHeuristics() {
-            return singletonList(new SignificanceHeuristicSpec<>(SimpleHeuristic.NAME, SimpleHeuristic::new, SimpleHeuristic.PARSER));
-        }
-
+    public static class TestScriptPlugin extends MockScriptPlugin implements SearchPlugin {
         @Override
         public Map<String, Function<Map<String, Object>, Object>> pluginScripts() {
             Map<String, Function<Map<String, Object>, Object>> scripts = new HashMap<>();
@@ -203,65 +121,6 @@ private static long longValue(Object value) {
         }
     }
 
-    public static class SimpleHeuristic extends SignificanceHeuristic {
-        public static final String NAME = "simple";
-        public static final ObjectParser<SimpleHeuristic, Void> PARSER = new ObjectParser<>(NAME, SimpleHeuristic::new);
-
-        public SimpleHeuristic() {
-        }
-
-        /**
-         * Read from a stream.
-         */
-        public SimpleHeuristic(StreamInput in) throws IOException {
-            // Nothing to read
-        }
-
-        @Override
-        public void writeTo(StreamOutput out) throws IOException {
-            // Nothing to write
-        }
-
-        @Override
-        public String getWriteableName() {
-            return NAME;
-        }
-
-        @Override
-        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            builder.startObject(NAME).endObject();
-            return builder;
-        }
-
-        @Override
-        public int hashCode() {
-            return 1;
-        }
-
-        @Override
-        public boolean equals(Object obj) {
-            if (obj == null) {
-                return false;
-            }
-            if (getClass() != obj.getClass()) {
-                return false;
-            }
-            return true;
-        }
-
-        /**
-         * @param subsetFreq   The frequency of the term in the selected sample
-         * @param subsetSize   The size of the selected sample (typically number of docs)
-         * @param supersetFreq The frequency of the term in the superset from which the sample was taken
-         * @param supersetSize The size of the superset from which the sample was taken  (typically number of docs)
-         * @return a "significance" score
-         */
-        @Override
-        public double getScore(long subsetFreq, long subsetSize, long supersetFreq, long supersetSize) {
-            return subsetFreq / subsetSize > supersetFreq / supersetSize ? 2.0 : 1.0;
-        }
-    }
-
     public void testXContentResponse() throws Exception {
         String type = randomBoolean() ? "text" : "long";
         String settings = "{\"index.number_of_shards\": 1, \"index.number_of_replicas\": 0}";

From 4efcfb3320d52d440eeb437579b14e90eb45bdde Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Wed, 15 Jan 2020 15:20:02 -0500
Subject: [PATCH 602/686] [DOCS] Add note to community clients page (#51065)

Adds a note to the 'Community Contributed Clients' page explicitly
stating that Elastic does not support or endorse the clients.
---
 docs/community-clients/index.asciidoc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/community-clients/index.asciidoc b/docs/community-clients/index.asciidoc
index 97e0996712640..cdd4d3e0457ee 100644
--- a/docs/community-clients/index.asciidoc
+++ b/docs/community-clients/index.asciidoc
@@ -4,6 +4,15 @@
 == Preface
 :client: https://www.elastic.co/guide/en/elasticsearch/client
 
+[NOTE]
+====
+This is a list of clients submitted by members of the Elastic community.
+Elastic does not support or endorse these clients.
+
+If you'd like to add a new client to this list, please
+https://github.com/elastic/elasticsearch/blob/master/CONTRIBUTING.md#contributing-code-and-documentation-changes[open a pull request].
+====
+
 Besides the link:/guide[officially supported Elasticsearch clients], there are
 a number of clients that have been contributed by the community for various languages:
 

From 42373ad9b6035356400c51186f31460bec919345 Mon Sep 17 00:00:00 2001
From: Oleksandr Stasyk <sashman90@gmail.com>
Date: Wed, 15 Jan 2020 21:07:21 +0000
Subject: [PATCH 603/686] [DOCS] Add Elixir Bulk Processor to community clients
 (#50630)

---
 docs/community-clients/index.asciidoc | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/community-clients/index.asciidoc b/docs/community-clients/index.asciidoc
index cdd4d3e0457ee..8cd0609730d50 100644
--- a/docs/community-clients/index.asciidoc
+++ b/docs/community-clients/index.asciidoc
@@ -73,6 +73,8 @@ a number of clients that have been contributed by the community for various lang
   http://github.com/karmi/tire[Tire]. Ready to use in pure Erlang
   environment.
 
+* https://github.com/sashman/elasticsearch_elixir_bulk_processor[Elixir Bulk Processor]:
+  Dynamically configurable Elixir port of the [Bulk Processor](https://www.elastic.co/guide/en/elasticsearch/client/java-api/current/java-docs-bulk-processor.html). Implemented using GenStages to handle backpressure.
 
 [[go]]
 == Go

From 9dde43c37e116eb66d4c0a1e23b75750b3e86984 Mon Sep 17 00:00:00 2001
From: Yang Wang <yang.wang@elastic.co>
Date: Thu, 16 Jan 2020 08:43:28 +1100
Subject: [PATCH 604/686] Encrypt generated key with AES (#51019)

Replace DES with AES to align with modern encryption standards

Resolves: #50843
---
 .../xpack/security/cli/CertificateTool.java   |  2 +-
 .../security/cli/CertificateToolTests.java    | 20 ++++++++++++++++++-
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertificateTool.java b/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertificateTool.java
index 4ae1f313ce152..ad5cfd5e05b1d 100644
--- a/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertificateTool.java
+++ b/x-pack/plugin/security/cli/src/main/java/org/elasticsearch/xpack/security/cli/CertificateTool.java
@@ -922,7 +922,7 @@ static Collection<CertificateInformation> parseFile(Path file) throws Exception
     }
 
     static PEMEncryptor getEncrypter(char[] password) {
-        return new JcePEMEncryptorBuilder("DES-EDE3-CBC").setProvider(BC_PROV).build(password);
+        return new JcePEMEncryptorBuilder("AES-128-CBC").setProvider(BC_PROV).build(password);
     }
 
     private static <T, E extends Exception> T withPassword(String description, char[] password, Terminal terminal,
diff --git a/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/CertificateToolTests.java b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/CertificateToolTests.java
index 6845edbdc6b38..21a8440a7003c 100644
--- a/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/CertificateToolTests.java
+++ b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/CertificateToolTests.java
@@ -21,6 +21,7 @@
 import org.bouncycastle.asn1.x509.GeneralName;
 import org.bouncycastle.asn1.x509.GeneralNames;
 import org.bouncycastle.cert.X509CertificateHolder;
+import org.bouncycastle.openssl.PEMDecryptorProvider;
 import org.bouncycastle.openssl.PEMEncryptedKeyPair;
 import org.bouncycastle.openssl.PEMParser;
 import org.bouncycastle.pkcs.PKCS10CertificationRequest;
@@ -50,6 +51,7 @@
 import org.hamcrest.Matchers;
 import org.junit.After;
 import org.junit.BeforeClass;
+import org.mockito.Mockito;
 
 import javax.net.ssl.KeyManagerFactory;
 import javax.net.ssl.TrustManagerFactory;
@@ -349,6 +351,16 @@ public void testGeneratingSignedPemCertificates() throws Exception {
                         PEMParser pemParser = new PEMParser(reader);
                         Object parsed = pemParser.readObject();
                         assertThat(parsed, instanceOf(PEMEncryptedKeyPair.class));
+                        // Verify we are using AES encryption
+                        final PEMDecryptorProvider pemDecryptorProvider = Mockito.mock(PEMDecryptorProvider.class);
+                        try {
+                            ((PEMEncryptedKeyPair) parsed).decryptKeyPair(pemDecryptorProvider);
+                        } catch (Exception e) {
+                            // Catch error thrown by the empty mock, we are only interested in the argument passed in
+                        }
+                        finally {
+                            Mockito.verify(pemDecryptorProvider).get("AES-128-CBC");
+                        }
                         char[] zeroChars = new char[caInfo.password.length];
                         Arrays.fill(zeroChars, (char) 0);
                         assertArrayEquals(zeroChars, caInfo.password);
@@ -368,7 +380,13 @@ public void testGeneratingSignedPemCertificates() throws Exception {
             assertTrue(Files.exists(zipRoot.resolve(filename)));
             final Path cert = zipRoot.resolve(filename + "/" + filename + ".crt");
             assertTrue(Files.exists(cert));
-            assertTrue(Files.exists(zipRoot.resolve(filename + "/" + filename + ".key")));
+            Path keyFile = zipRoot.resolve(filename + "/" + filename + ".key");
+            assertTrue(Files.exists(keyFile));
+            if (keyPassword != null) {
+                assertTrue(Files.readString(keyFile).contains("DEK-Info: AES-128-CBC"));
+            } else {
+                assertFalse(Files.readString(keyFile).contains("DEK-Info:"));
+            }
             final Path p12 = zipRoot.resolve(filename + "/" + filename + ".p12");
             try (InputStream input = Files.newInputStream(cert)) {
                 X509Certificate certificate = readX509Certificate(input);

From 70d39735173485f227bcd60ca2430f7e36b2bbd8 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Thu, 16 Jan 2020 09:32:47 +1100
Subject: [PATCH 605/686] Fix windows newline issue in test (#51030)

Fixes HttpCertificateCommandTests.testTextFileSubstitutions on Windows

Resolves: #50964
---
 .../xpack/security/cli/HttpCertificateCommandTests.java       | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
index cb9ec6fe7c5ab..8cb4774d098d2 100644
--- a/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
+++ b/x-pack/plugin/security/cli/src/test/java/org/elasticsearch/xpack/security/cli/HttpCertificateCommandTests.java
@@ -9,7 +9,6 @@
 import com.google.common.jimfs.Configuration;
 import com.google.common.jimfs.Jimfs;
 import joptsimple.OptionSet;
-import org.apache.lucene.util.Constants;
 import org.bouncycastle.asn1.DERIA5String;
 import org.bouncycastle.asn1.DEROctetString;
 import org.bouncycastle.asn1.DERSequence;
@@ -530,13 +529,12 @@ public void testGuessFileType() throws Exception {
     }
 
     public void testTextFileSubstitutions() throws Exception {
-        assumeFalse("https://github.com/elastic/elasticsearch/issues/50964", Constants.WINDOWS);
         CheckedBiFunction<String, Map<String, String>, String, Exception> copy = (source, subs) -> {
             try (InputStream in = new ByteArrayInputStream(source.getBytes(StandardCharsets.UTF_8));
                  StringWriter out = new StringWriter();
                  PrintWriter writer = new PrintWriter(out)) {
                 HttpCertificateCommand.copyWithSubstitutions(in, writer, subs);
-                return out.toString();
+                return out.toString().replace("\r\n", "\n");
             }
         };
         assertThat(copy.apply("abc\n", Map.of()), is("abc\n"));

From b8b98460287999cbdf6823bbcc17c0e324bf1c9b Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Thu, 16 Jan 2020 09:16:52 +0100
Subject: [PATCH 606/686] Unmute SmokeTestWatcherTestSuiteIT suite (#50973)

Also adds `assertWatchCount(0)` snippet inside assertBusy(...) based on
the findings in: https://github.com/elastic/elasticsearch/issues/32299#issuecomment-466305686

Relates to #32299
---
 .../smoketest/SmokeTestWatcherTestSuiteIT.java         | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java b/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java
index 2b509a348e901..c7fcf719d5594 100644
--- a/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java
+++ b/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java
@@ -109,7 +109,6 @@ protected Settings restAdminSettings() {
         return Settings.builder().put(ThreadContext.PREFIX + ".Authorization", token).build();
     }
 
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/32299")
     public void testMonitorClusterHealth() throws Exception {
         String watchId = "cluster_health_watch";
 
@@ -125,7 +124,7 @@ public void testMonitorClusterHealth() throws Exception {
         assertThat(address, is(notNullValue()));
         String[] splitAddress = address.split(":", 2);
         String host = splitAddress[0];
-        int port = Integer.valueOf(splitAddress[1]);
+        int port = Integer.parseInt(splitAddress[1]);
 
         // put watch
         try (XContentBuilder builder = jsonBuilder()) {
@@ -161,7 +160,12 @@ public void testMonitorClusterHealth() throws Exception {
         assertThat(conditionMet, is(true));
 
         deleteWatch(watchId);
-        assertWatchCount(0);
+        // Wrap inside an assertBusy(...), because watch may execute just after being deleted,
+        // This tries to re-add the watch which fails, because of version conflict,
+        // but for a moment the watch count from watcher stats api may be incorrect.
+        // (via WatcherIndexingListener#preIndex)
+        // The WatcherIndexingListener#postIndex() detects this version conflict and corrects the watch count.
+        assertBusy(() -> assertWatchCount(0));
     }
 
     private void indexWatch(String watchId, XContentBuilder builder) throws Exception {

From 182d7ce15a8ec594a77ddcc23d8ea484b2b09304 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Thu, 16 Jan 2020 10:29:45 +0100
Subject: [PATCH 607/686] Add more logging when failing watch history entry
 fails. (#50931)

Relates to #30777
---
 .../SmokeTestWatcherWithSecurityIT.java       | 95 +++++++++++++------
 1 file changed, 66 insertions(+), 29 deletions(-)

diff --git a/x-pack/qa/smoke-test-watcher-with-security/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherWithSecurityIT.java b/x-pack/qa/smoke-test-watcher-with-security/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherWithSecurityIT.java
index 7675642860b7c..bcc8aa3acdb07 100644
--- a/x-pack/qa/smoke-test-watcher-with-security/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherWithSecurityIT.java
+++ b/x-pack/qa/smoke-test-watcher-with-security/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherWithSecurityIT.java
@@ -305,39 +305,76 @@ private ObjectPath getWatchHistoryEntry(String watchId) throws Exception {
 
     private ObjectPath getWatchHistoryEntry(String watchId, String state) throws Exception {
         final AtomicReference<ObjectPath> objectPathReference = new AtomicReference<>();
-        assertBusy(() -> {
-            client().performRequest(new Request("POST", "/.watcher-history-*/_refresh"));
-
-            try (XContentBuilder builder = jsonBuilder()) {
-                builder.startObject();
-                builder.startObject("query").startObject("bool").startArray("must");
-                builder.startObject().startObject("term").startObject("watch_id").field("value", watchId).endObject().endObject()
+        try {
+            assertBusy(() -> {
+                client().performRequest(new Request("POST", "/.watcher-history-*/_refresh"));
+
+                try (XContentBuilder builder = jsonBuilder()) {
+                    builder.startObject();
+                    builder.startObject("query").startObject("bool").startArray("must");
+                    builder.startObject().startObject("term").startObject("watch_id").field("value", watchId).endObject().endObject()
                         .endObject();
-                if (Strings.isNullOrEmpty(state) == false) {
-                    builder.startObject().startObject("term").startObject("state").field("value", state).endObject().endObject()
+                    if (Strings.isNullOrEmpty(state) == false) {
+                        builder.startObject().startObject("term").startObject("state").field("value", state).endObject().endObject()
                             .endObject();
-                }
-                builder.endArray().endObject().endObject();
-                builder.startArray("sort").startObject().startObject("trigger_event.triggered_time").field("order", "desc").endObject()
+                    }
+                    builder.endArray().endObject().endObject();
+                    builder.startArray("sort").startObject().startObject("trigger_event.triggered_time").field("order", "desc").endObject()
                         .endObject().endArray();
-                builder.endObject();
-
-                Request searchRequest = new Request("POST", "/.watcher-history-*/_search");
-                searchRequest.addParameter(TOTAL_HITS_AS_INT_PARAM, "true");
-                searchRequest.setJsonEntity(Strings.toString(builder));
-                Response response = client().performRequest(searchRequest);
-                ObjectPath objectPath = ObjectPath.createFromResponse(response);
-                int totalHits = objectPath.evaluate("hits.total");
-                assertThat(totalHits, is(greaterThanOrEqualTo(1)));
-                String watchid = objectPath.evaluate("hits.hits.0._source.watch_id");
-                assertThat(watchid, is(watchId));
-                objectPathReference.set(objectPath);
-            } catch (ResponseException e) {
-                final String err = "Failed to perform search of watcher history";
-                logger.info(err, e);
-                fail(err);
+                    builder.endObject();
+
+                    Request searchRequest = new Request("POST", "/.watcher-history-*/_search");
+                    searchRequest.addParameter(TOTAL_HITS_AS_INT_PARAM, "true");
+                    searchRequest.setJsonEntity(Strings.toString(builder));
+                    Response response = client().performRequest(searchRequest);
+                    ObjectPath objectPath = ObjectPath.createFromResponse(response);
+                    int totalHits = objectPath.evaluate("hits.total");
+                    assertThat(totalHits, is(greaterThanOrEqualTo(1)));
+                    String watchid = objectPath.evaluate("hits.hits.0._source.watch_id");
+                    assertThat(watchid, is(watchId));
+                    objectPathReference.set(objectPath);
+                } catch (ResponseException e) {
+                    final String err = "Failed to perform search of watcher history";
+                    logger.info(err, e);
+                    fail(err);
+                }
+            });
+        } catch (AssertionError ae) {
+            {
+                Request request = new Request("GET", "/_watcher/stats");
+                request.addParameter("metric", "_all");
+                request.addParameter("pretty", "true");
+                try {
+                    Response response = client().performRequest(request);
+                    logger.info("watcher_stats: {}", EntityUtils.toString(response.getEntity()));
+                } catch (IOException e) {
+                    logger.error("error while fetching watcher_stats", e);
+                }
             }
-        });
+            {
+                Request request = new Request("GET", "/_cluster/state");
+                request.addParameter("pretty", "true");
+                try {
+                    Response response = client().performRequest(request);
+                    logger.info("cluster_state: {}", EntityUtils.toString(response.getEntity()));
+                } catch (IOException e) {
+                    logger.error("error while fetching cluster_state", e);
+                }
+            }
+            {
+                Request request = new Request("GET", "/.watcher-history-*/_search");
+                request.addParameter("size", "100");
+                request.addParameter("sort", "trigger_event.triggered_time:desc");
+                request.addParameter("pretty", "true");
+                try {
+                    Response response = client().performRequest(request);
+                    logger.info("watcher_history_snippets: {}", EntityUtils.toString(response.getEntity()));
+                } catch (IOException e) {
+                    logger.error("error while fetching watcher_history_snippets", e);
+                }
+            }
+            throw ae;
+        }
         return objectPathReference.get();
     }
 }

From 4284e34746d9e40fea3ac6a64ad1be68d1608a6f Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Thu, 16 Jan 2020 10:06:45 +0000
Subject: [PATCH 608/686] Fix hardcoded version replacement in
 put-dfanalytics.asciidoc (#51056)

---
 docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index 18b3446bca56c..9c1b41c9b57ad 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -407,7 +407,7 @@ The API returns the following result:
 }
 ----
 // TESTRESPONSE[s/1562265491319/$body.$_path/]
-// TESTRESPONSE[s/"version": "8.0.0"/"version": $body.version/]
+// TESTRESPONSE[s/"version" : "8.0.0"/"version" : $body.version/]
 
 
 [[ml-put-dfanalytics-example-r]]

From 96ec19a7e1bbdae5c9a114fbfc7374eafd7ba5e1 Mon Sep 17 00:00:00 2001
From: Benedict Jin <asdf2014@apache.org>
Date: Thu, 16 Jan 2020 18:27:13 +0800
Subject: [PATCH 609/686] Remove useless logger instance from
 CircuitBreakerService (#50580)

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
---
 .../elasticsearch/indices/breaker/CircuitBreakerService.java   | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/indices/breaker/CircuitBreakerService.java b/server/src/main/java/org/elasticsearch/indices/breaker/CircuitBreakerService.java
index 90a814b29b3c5..c69b6b740aebd 100644
--- a/server/src/main/java/org/elasticsearch/indices/breaker/CircuitBreakerService.java
+++ b/server/src/main/java/org/elasticsearch/indices/breaker/CircuitBreakerService.java
@@ -19,8 +19,6 @@
 
 package org.elasticsearch.indices.breaker;
 
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
 import org.elasticsearch.common.breaker.CircuitBreaker;
 import org.elasticsearch.common.component.AbstractLifecycleComponent;
 
@@ -29,7 +27,6 @@
  * that load field data.
  */
 public abstract class CircuitBreakerService extends AbstractLifecycleComponent {
-    private static final Logger logger = LogManager.getLogger(CircuitBreakerService.class);
 
     protected CircuitBreakerService() {
     }

From 7d6221eaa101827cd80cb56d2b47b9c2b3a7ed9f Mon Sep 17 00:00:00 2001
From: PND <fujjisaaan@gmail.com>
Date: Thu, 16 Jan 2020 19:32:55 +0900
Subject: [PATCH 610/686] =?UTF-8?q?[Docs]=C2=A0Fix=20example=20output=20of?=
 =?UTF-8?q?=20edge=20n-gram=20token=20filter.=20(#51085)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../analysis/tokenfilters/edgengram-tokenfilter.asciidoc        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/analysis/tokenfilters/edgengram-tokenfilter.asciidoc b/docs/reference/analysis/tokenfilters/edgengram-tokenfilter.asciidoc
index c41df5095c8f2..3c7f429c97bc3 100644
--- a/docs/reference/analysis/tokenfilters/edgengram-tokenfilter.asciidoc
+++ b/docs/reference/analysis/tokenfilters/edgengram-tokenfilter.asciidoc
@@ -49,7 +49,7 @@ The filter produces the following tokens:
 
 [source,text]
 --------------------------------------------------
-[ t, th, q, ui, b, br, f, fo, j, ju ]
+[ t, th, q, qu, b, br, f, fo, j, ju ]
 --------------------------------------------------
 
 /////////////////////

From e1a055e1e3d5af90878ab55fc5fbd7517042746a Mon Sep 17 00:00:00 2001
From: Marios Trivyzas <matriv@gmail.com>
Date: Thu, 16 Jan 2020 12:04:14 +0100
Subject: [PATCH 611/686] Fix caching for PreConfiguredTokenFilter (#50912)

The PreConfiguredTokenFilter#singletonWithVersion uses the version
internaly for the token filter factories but it registers only one
instance in the cahce and not one instance per version. This can lead
to exceptions like the one described in #50734 since the singleton is
created and cached using the version created of the first index
that is processed.

Remove the singletonWithVersion() methods and use the
elasticsearchVersion() methods instead.

Fixes: #50734
---
 .../analysis/common/CommonAnalysisPlugin.java |   2 +-
 .../analysis/PreConfiguredTokenFilter.java    |  29 ++--
 .../indices/analysis/AnalysisModule.java      |   2 +-
 .../PreConfiguredTokenFilterTests.java        | 130 ++++++++++++++++++
 4 files changed, 142 insertions(+), 21 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilterTests.java

diff --git a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
index 3c614f84d4e23..ea1c810d6696d 100644
--- a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
+++ b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
@@ -507,7 +507,7 @@ public List<PreConfiguredTokenFilter> getPreConfiguredTokenFilters() {
                       | WordDelimiterFilter.SPLIT_ON_CASE_CHANGE
                       | WordDelimiterFilter.SPLIT_ON_NUMERICS
                       | WordDelimiterFilter.STEM_ENGLISH_POSSESSIVE, null)));
-        filters.add(PreConfiguredTokenFilter.singletonWithVersion("word_delimiter_graph", false, false, (input, version) -> {
+        filters.add(PreConfiguredTokenFilter.elasticsearchVersion("word_delimiter_graph", false, false, (input, version) -> {
             boolean adjustOffsets = version.onOrAfter(Version.V_7_3_0);
             return new WordDelimiterGraphFilter(input, adjustOffsets, WordDelimiterIterator.DEFAULT_WORD_DELIM_TABLE,
                         WordDelimiterGraphFilter.GENERATE_WORD_PARTS
diff --git a/server/src/main/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilter.java b/server/src/main/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilter.java
index f8e14ef9af52b..fc28f0bd34d2d 100644
--- a/server/src/main/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilter.java
+++ b/server/src/main/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilter.java
@@ -52,25 +52,6 @@ public static PreConfiguredTokenFilter singleton(String name, boolean useFilterF
             (tokenStream, version) -> create.apply(tokenStream));
     }
 
-    /**
-     * Create a pre-configured token filter that may vary based on the Elasticsearch version.
-     */
-    public static PreConfiguredTokenFilter singletonWithVersion(String name, boolean useFilterForMultitermQueries,
-            BiFunction<TokenStream, Version, TokenStream> create) {
-        return new PreConfiguredTokenFilter(name, useFilterForMultitermQueries, true, CachingStrategy.ONE,
-                (tokenStream, version) -> create.apply(tokenStream, version));
-    }
-
-    /**
-     * Create a pre-configured token filter that may vary based on the Elasticsearch version.
-     */
-    public static PreConfiguredTokenFilter singletonWithVersion(String name, boolean useFilterForMultitermQueries,
-                                                                boolean useFilterForParsingSynonyms,
-                                                                BiFunction<TokenStream, Version, TokenStream> create) {
-        return new PreConfiguredTokenFilter(name, useFilterForMultitermQueries, useFilterForParsingSynonyms, CachingStrategy.ONE,
-            (tokenStream, version) -> create.apply(tokenStream, version));
-    }
-
     /**
      * Create a pre-configured token filter that may vary based on the Lucene version.
      */
@@ -88,6 +69,16 @@ public static PreConfiguredTokenFilter elasticsearchVersion(String name, boolean
         return new PreConfiguredTokenFilter(name, useFilterForMultitermQueries, true, CachingStrategy.ELASTICSEARCH, create);
     }
 
+    /**
+     * Create a pre-configured token filter that may vary based on the Elasticsearch version.
+     */
+    public static PreConfiguredTokenFilter elasticsearchVersion(String name, boolean useFilterForMultitermQueries,
+                                                                boolean useFilterForParsingSynonyms,
+                                                                BiFunction<TokenStream, Version, TokenStream> create) {
+        return new PreConfiguredTokenFilter(name, useFilterForMultitermQueries, useFilterForParsingSynonyms,
+                CachingStrategy.ELASTICSEARCH, create);
+    }
+
     private final boolean useFilterForMultitermQueries;
     private final boolean allowForSynonymParsing;
     private final BiFunction<TokenStream, Version, TokenStream> create;
diff --git a/server/src/main/java/org/elasticsearch/indices/analysis/AnalysisModule.java b/server/src/main/java/org/elasticsearch/indices/analysis/AnalysisModule.java
index 60a2b1640ed5b..2b856579ff15b 100644
--- a/server/src/main/java/org/elasticsearch/indices/analysis/AnalysisModule.java
+++ b/server/src/main/java/org/elasticsearch/indices/analysis/AnalysisModule.java
@@ -181,7 +181,7 @@ static Map<String, PreConfiguredTokenFilter> setupPreConfiguredTokenFilters(List
         preConfiguredTokenFilters.register("lowercase", PreConfiguredTokenFilter.singleton("lowercase", true, LowerCaseFilter::new));
         // Add "standard" for old indices (bwc)
         preConfiguredTokenFilters.register( "standard",
-            PreConfiguredTokenFilter.singletonWithVersion("standard", true, (reader, version) -> {
+            PreConfiguredTokenFilter.elasticsearchVersion("standard", true, (reader, version) -> {
                 if (version.before(Version.V_7_0_0)) {
                     deprecationLogger.deprecatedAndMaybeLog("standard_deprecation",
                         "The [standard] token filter is deprecated and will be removed in a future version.");
diff --git a/server/src/test/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilterTests.java b/server/src/test/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilterTests.java
new file mode 100644
index 0000000000000..8c4c62487c21c
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilterTests.java
@@ -0,0 +1,130 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.elasticsearch.index.analysis;
+
+import org.apache.lucene.analysis.TokenFilter;
+import org.elasticsearch.Version;
+import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.env.TestEnvironment;
+import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.IndexSettingsModule;
+import org.elasticsearch.test.VersionUtils;
+
+import java.io.IOException;
+
+public class PreConfiguredTokenFilterTests extends ESTestCase {
+
+    private final Settings emptyNodeSettings = Settings.builder()
+            .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString())
+            .build();
+
+    public void testCachingWithSingleton() throws IOException {
+        PreConfiguredTokenFilter pctf =
+                PreConfiguredTokenFilter.singleton("singleton", randomBoolean(),
+                        (tokenStream) -> new TokenFilter(tokenStream) {
+                            @Override
+                            public boolean incrementToken() {
+                                return false;
+                            }
+                        });
+
+        IndexSettings indexSettings = IndexSettingsModule.newIndexSettings("test", Settings.EMPTY);
+
+        Version version1 = VersionUtils.randomVersion(random());
+        Settings settings1 = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version1)
+                .build();
+        TokenFilterFactory tff_v1_1 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "singleton", settings1);
+        TokenFilterFactory tff_v1_2 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "singleton", settings1);
+        assertSame(tff_v1_1, tff_v1_2);
+
+        Version version2 = randomValueOtherThan(version1, () -> randomFrom(VersionUtils.allVersions()));
+        Settings settings2 = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version2)
+                .build();
+
+        TokenFilterFactory tff_v2 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "singleton", settings2);
+        assertSame(tff_v1_1, tff_v2);
+    }
+
+    public void testCachingWithElasticsearchVersion() throws IOException {
+        PreConfiguredTokenFilter pctf =
+            PreConfiguredTokenFilter.elasticsearchVersion("elasticsearch_version", randomBoolean(),
+                (tokenStream, esVersion) -> new TokenFilter(tokenStream) {
+                    @Override
+                    public boolean incrementToken() {
+                        return false;
+                    }
+                });
+
+        IndexSettings indexSettings = IndexSettingsModule.newIndexSettings("test", Settings.EMPTY);
+
+        Version version1 = VersionUtils.randomVersion(random());
+        Settings settings1 = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version1)
+                .build();
+        TokenFilterFactory tff_v1_1 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "elasticsearch_version", settings1);
+        TokenFilterFactory tff_v1_2 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "elasticsearch_version", settings1);
+        assertSame(tff_v1_1, tff_v1_2);
+
+        Version version2 = randomValueOtherThan(version1, () -> randomFrom(VersionUtils.allVersions()));
+        Settings settings2 = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version2)
+                .build();
+
+        TokenFilterFactory tff_v2 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "elasticsearch_version", settings2);
+        assertNotSame(tff_v1_1, tff_v2);
+    }
+
+    public void testCachingWithLuceneVersion() throws IOException {
+        PreConfiguredTokenFilter pctf =
+                PreConfiguredTokenFilter.luceneVersion("lucene_version", randomBoolean(),
+                        (tokenStream, luceneVersion) -> new TokenFilter(tokenStream) {
+                            @Override
+                            public boolean incrementToken() {
+                                return false;
+                            }
+                        });
+
+        IndexSettings indexSettings = IndexSettingsModule.newIndexSettings("test", Settings.EMPTY);
+
+        Version version1 = Version.CURRENT;
+        Settings settings1 = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version1)
+                .build();
+        TokenFilterFactory tff_v1_1 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "lucene_version", settings1);
+        TokenFilterFactory tff_v1_2 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "lucene_version", settings1);
+        assertSame(tff_v1_1, tff_v1_2);
+
+        byte major = VersionUtils.getFirstVersion().major;
+        Version version2 = Version.fromString(major - 1 + ".0.0");
+        Settings settings2 = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, version2)
+                .build();
+
+        TokenFilterFactory tff_v2 =
+                pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "lucene_version", settings2);
+        assertNotSame(tff_v1_1, tff_v2);
+    }
+}

From b37755b4a95552a51f687046311d1803e2ba59ce Mon Sep 17 00:00:00 2001
From: Ted Timmons <ted@perljam.net>
Date: Fri, 17 Jan 2020 00:09:54 +1300
Subject: [PATCH 612/686] [Docs] Fix short alias for 'unassigned.for' (#51059)

The short alias for `unassigned.for` is `uf`, not 'ua'.
---
 docs/reference/cat/shards.asciidoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/cat/shards.asciidoc b/docs/reference/cat/shards.asciidoc
index b26472812f514..e2f362f8e7fbf 100644
--- a/docs/reference/cat/shards.asciidoc
+++ b/docs/reference/cat/shards.asciidoc
@@ -239,7 +239,7 @@ Time (UTC)].
 `unassigned.details`, `ud`::
 Details about why the shard became unassigned.
 
-`unassigned.for`, `ua`::
+`unassigned.for`, `uf`::
 Time at which the shard was requested to be unassigned in
 https://en.wikipedia.org/wiki/List_of_UTC_time_offsets[Coordinated Universal
 Time (UTC)].
@@ -388,4 +388,4 @@ twitter 0 r STARTED    3014 31.1mb 192.168.56.30 bGG90GE
 twitter 0 r STARTED    3014 31.1mb 192.168.56.20 I8hydUG
 twitter 0 r UNASSIGNED ALLOCATION_FAILED
 ---------------------------------------------------------------------------
-// TESTRESPONSE[non_json]
\ No newline at end of file
+// TESTRESPONSE[non_json]

From 8169470dbd57125d4783a473bd38f83138f7698f Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 16 Jan 2020 12:22:32 +0100
Subject: [PATCH 613/686] Fix Infinite Retry Loop in loading RepositoryData
 (#50987)

* Fix Infinite Retry Loop in loading RepositoryData

We were running into an infinite loop when trying to load corrupted (or otherwise un-loadable)
repository data for a repo that uses best effort consistency (e.g. that was just freshly mounted
as done in the test) because we kepy resetting to `-1` on `IOException`, listing and finding the broken
generation `N` and then interpreted the subsequent reset to `-1` as a concurrent change to the repository.
---
 .../blobstore/BlobStoreRepository.java        | 15 +++++--
 .../CorruptedBlobStoreRepositoryIT.java       | 40 +++++++++++++++++++
 2 files changed, 51 insertions(+), 4 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index 87fbf9c44d0c3..87a9da671e417 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -1052,6 +1052,9 @@ public void getRepositoryData(ActionListener<RepositoryData> listener) {
             return;
         }
         // Retry loading RepositoryData in a loop in case we run into concurrent modifications of the repository.
+        // Keep track of the most recent generation we failed to load so we can break out of the loop if we fail to load the same
+        // generation repeatedly.
+        long lastFailedGeneration = RepositoryData.UNKNOWN_REPO_GEN;
         while (true) {
             final long genToLoad;
             if (bestEffortConsistency) {
@@ -1061,7 +1064,9 @@ public void getRepositoryData(ActionListener<RepositoryData> listener) {
                 try {
                     generation = latestIndexBlobId();
                 } catch (IOException ioe) {
-                    throw new RepositoryException(metadata.name(), "Could not determine repository generation from root blobs", ioe);
+                    listener.onFailure(
+                        new RepositoryException(metadata.name(), "Could not determine repository generation from root blobs", ioe));
+                    return;
                 }
                 genToLoad = latestKnownRepoGen.updateAndGet(known -> Math.max(known, generation));
                 if (genToLoad > generation) {
@@ -1076,7 +1081,9 @@ public void getRepositoryData(ActionListener<RepositoryData> listener) {
                 listener.onResponse(getRepositoryData(genToLoad));
                 return;
             } catch (RepositoryException e) {
-                if (genToLoad != latestKnownRepoGen.get()) {
+                // If the generation to load changed concurrently and we didn't just try loading the same generation before we retry
+                if (genToLoad != latestKnownRepoGen.get() && genToLoad != lastFailedGeneration) {
+                    lastFailedGeneration = genToLoad;
                     logger.warn("Failed to load repository data generation [" + genToLoad +
                         "] because a concurrent operation moved the current generation to [" + latestKnownRepoGen.get() + "]", e);
                     continue;
@@ -1086,10 +1093,10 @@ public void getRepositoryData(ActionListener<RepositoryData> listener) {
                     // of N so we mark this repository as corrupted.
                     markRepoCorrupted(genToLoad, e,
                         ActionListener.wrap(v -> listener.onFailure(corruptedStateException(e)), listener::onFailure));
-                    return;
                 } else {
-                    throw e;
+                    listener.onFailure(e);
                 }
+                return;
             }
         }
     }
diff --git a/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java b/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
index 8e08d0700ca2a..4f26f31182e8d 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/CorruptedBlobStoreRepositoryIT.java
@@ -303,6 +303,46 @@ public void testHandlingMissingRootLevelSnapshotMetadata() throws Exception {
         }
     }
 
+    public void testMountCorruptedRepositoryData() throws Exception {
+        disableRepoConsistencyCheck("This test intentionally corrupts the repository contents");
+        Client client = client();
+
+        Path repo = randomRepoPath();
+        final String repoName = "test-repo";
+        logger.info("-->  creating repository at {}", repo.toAbsolutePath());
+        assertAcked(client.admin().cluster().preparePutRepository(repoName)
+            .setType("fs").setSettings(Settings.builder()
+                .put("location", repo)
+                .put("compress", false)));
+
+        final String snapshot = "test-snap";
+
+        logger.info("--> creating snapshot");
+        CreateSnapshotResponse createSnapshotResponse = client.admin().cluster().prepareCreateSnapshot(repoName, snapshot)
+            .setWaitForCompletion(true).setIndices("test-idx-*").get();
+        assertThat(createSnapshotResponse.getSnapshotInfo().successfulShards(),
+            equalTo(createSnapshotResponse.getSnapshotInfo().totalShards()));
+
+        logger.info("--> corrupt index-N blob");
+        final Repository repository = internalCluster().getCurrentMasterNodeInstance(RepositoriesService.class).repository(repoName);
+        final RepositoryData repositoryData = getRepositoryData(repository);
+        Files.write(repo.resolve("index-" + repositoryData.getGenId()), randomByteArrayOfLength(randomIntBetween(1, 100)));
+
+        logger.info("--> verify loading repository data throws RepositoryException");
+        expectThrows(RepositoryException.class, () -> getRepositoryData(repository));
+
+        logger.info("--> mount repository path in a new repository");
+        final String otherRepoName = "other-repo";
+        assertAcked(client.admin().cluster().preparePutRepository(otherRepoName)
+            .setType("fs").setSettings(Settings.builder()
+                .put("location", repo)
+                .put("compress", false)));
+        final Repository otherRepo = internalCluster().getCurrentMasterNodeInstance(RepositoriesService.class).repository(otherRepoName);
+
+        logger.info("--> verify loading repository data from newly mounted repository throws RepositoryException");
+        expectThrows(RepositoryException.class, () -> getRepositoryData(otherRepo));
+    }
+
     private void assertRepositoryBlocked(Client client, String repo, String existingSnapshot) {
         logger.info("--> try to delete snapshot");
         final RepositoryException repositoryException3 = expectThrows(RepositoryException.class,

From 9ab178292159451b36ce666070e24128f0256a7f Mon Sep 17 00:00:00 2001
From: Ioannis Kakavas <ioannis@elastic.co>
Date: Thu, 16 Jan 2020 14:11:56 +0200
Subject: [PATCH 614/686] Fail gracefully on invalid token strings (#51014)

When we receive a request with an Authorization header that contains
a Bearer token that is not generated by us or that is malformed in
some way, attempting to decode it as one of our own might cause a
number of exceptions that are not IOExceptions. This commit ensures
that we catch and log these too and call onResponse with `null, so
that we can return 401 instead of 500.

Resolves: #50497
---
 .../org/elasticsearch/xpack/security/authc/TokenService.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
index 42d582997d827..c479722b05098 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
@@ -526,7 +526,7 @@ void decodeToken(String token, ActionListener<UserToken> listener) {
                     listener.onResponse(null);
                 }
             }
-        } catch (IOException e) {
+        } catch (Exception e) {
             // could happen with a token that is not ours
             if (logger.isDebugEnabled()) {
                logger.debug("built in token service unable to decode token", e);

From d96755c62a11fc7bd3448e9c4e748653629dbb1f Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 16 Jan 2020 09:13:31 -0500
Subject: [PATCH 615/686] [DOCS] Use same index in Cluster Allocation Explain
 docs (#50936)

Updates several example snippets in the Cluster Allocation Explain API
docs to consistently use the `my_index` index.

Previously, the snippets switches from `my_index` to `idx`, which could
confuse users.

Co-authored-by: Emmanuel DEMEY <demey.emmanuel@gmail.com>

Co-authored-by: Emmanuel DEMEY <demey.emmanuel@gmail.com>
---
 .../cluster/allocation-explain.asciidoc       | 23 ++++++++++++-------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/docs/reference/cluster/allocation-explain.asciidoc b/docs/reference/cluster/allocation-explain.asciidoc
index fc407f069a0e2..6abbfe6b75e37 100644
--- a/docs/reference/cluster/allocation-explain.asciidoc
+++ b/docs/reference/cluster/allocation-explain.asciidoc
@@ -103,14 +103,21 @@ GET /_cluster/allocation/explain
 
 ===== Examples of unassigned primary shard explanations
 
+//////
+[source,console]
+--------------------------------------------------	
+DELETE myindex	
+--------------------------------------------------	
+//////
+
 [source,console]
 --------------------------------------------------
-PUT /idx?master_timeout=1s&timeout=1s
+PUT /my_index?master_timeout=1s&timeout=1s
 {"settings": {"index.routing.allocation.include._name": "non_existent_node"} }
 
 GET /_cluster/allocation/explain
 {
-  "index": "idx",
+  "index": "my_index",
   "shard": 0,
   "primary": true
 }
@@ -122,7 +129,7 @@ The API returns the following response for an unassigned primary shard:
 [source,console-result]
 --------------------------------------------------
 {
-  "index" : "idx",
+  "index" : "my_index",
   "shard" : 0,
   "primary" : true,
   "current_state" : "unassigned",                 <1>
@@ -171,7 +178,7 @@ allocated to a node in the cluster:
 [source,js]
 --------------------------------------------------
 {
-  "index" : "idx",
+  "index" : "my_index",
   "shard" : 0,
   "primary" : true,
   "current_state" : "unassigned",
@@ -196,7 +203,7 @@ allocation:
 [source,js]
 --------------------------------------------------
 {
-  "index" : "idx",
+  "index" : "my_index",
   "shard" : 0,
   "primary" : false,
   "current_state" : "unassigned",
@@ -232,7 +239,7 @@ allocation:
         {
           "decider" : "same_shard",
           "decision" : "NO",
-          "explanation" : "the shard cannot be allocated to the same node on which a copy of the shard already exists [[idx][0], node[3sULLVJrRneSg0EfBB-2Ew], [P], s[STARTED], a[id=eV9P8BN1QPqRc3B4PLx6cg]]"
+          "explanation" : "the shard cannot be allocated to the same node on which a copy of the shard already exists [[my_index][0], node[3sULLVJrRneSg0EfBB-2Ew], [P], s[STARTED], a[id=eV9P8BN1QPqRc3B4PLx6cg]]"
         }
       ]
     }
@@ -253,7 +260,7 @@ its current node and is required to move:
 [source,js]
 --------------------------------------------------
 {
-  "index" : "idx",
+  "index" : "my_index",
   "shard" : 0,
   "primary" : true,
   "current_state" : "started",
@@ -302,7 +309,7 @@ because moving the shard to another node does not form a better cluster balance:
 [source,js]
 --------------------------------------------------
 {
-  "index" : "idx",
+  "index" : "my_index",
   "shard" : 0,
   "primary" : true,
   "current_state" : "started",

From 059e4d2beeac2c1aa7139816c67190fb4b23bfae Mon Sep 17 00:00:00 2001
From: Rory Hunter <pugnascotia@users.noreply.github.com>
Date: Thu, 16 Jan 2020 14:23:15 +0000
Subject: [PATCH 616/686] Follow symlinks in Docker entrypoint (#50927)

Closes #49653. When using _FILE environment variables to supply values
to Elasticsearch, following symlinks when checking that file permissions
are secure.
---
 .../src/bin/elasticsearch-env-from-file       |  12 +-
 .../packaging/test/DockerTests.java           | 103 ++++++++++++++++--
 2 files changed, 104 insertions(+), 11 deletions(-)

diff --git a/distribution/src/bin/elasticsearch-env-from-file b/distribution/src/bin/elasticsearch-env-from-file
index fd5326afcc6b7..d2cca3d729951 100644
--- a/distribution/src/bin/elasticsearch-env-from-file
+++ b/distribution/src/bin/elasticsearch-env-from-file
@@ -24,10 +24,14 @@ for VAR_NAME_FILE in $(env | cut -f1 -d= | grep '_FILE$'); do
       exit 1
     fi
 
-    FILE_PERMS="$(stat -c '%a' ${!VAR_NAME_FILE})"
-
-    if [[ "$FILE_PERMS" != "400" && "$FILE_PERMS" != 600 ]]; then
-        echo "ERROR: File ${!VAR_NAME_FILE} from $VAR_NAME_FILE must have file permissions 400 or 600, but actually has: $FILE_PERMS" >&2
+    FILE_PERMS="$(stat -L -c '%a' ${!VAR_NAME_FILE})"
+
+    if [[ "$FILE_PERMS" != "400" && "$FILE_PERMS" != "600" ]]; then
+        if [[ -h "${!VAR_NAME_FILE}" ]]; then
+            echo "ERROR: File $(readlink "${!VAR_NAME_FILE}") (target of symlink ${!VAR_NAME_FILE} from $VAR_NAME_FILE) must have file permissions 400 or 600, but actually has: $FILE_PERMS" >&2
+        else
+            echo "ERROR: File ${!VAR_NAME_FILE} from $VAR_NAME_FILE must have file permissions 400 or 600, but actually has: $FILE_PERMS" >&2
+        fi
         exit 1
     fi
 
diff --git a/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java b/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
index a9fa84962490f..42e4262e4b947 100644
--- a/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
+++ b/qa/os/src/test/java/org/elasticsearch/packaging/test/DockerTests.java
@@ -59,6 +59,7 @@
 import static org.elasticsearch.packaging.util.Docker.waitForPathToExist;
 import static org.elasticsearch.packaging.util.FileMatcher.p600;
 import static org.elasticsearch.packaging.util.FileMatcher.p660;
+import static org.elasticsearch.packaging.util.FileMatcher.p775;
 import static org.elasticsearch.packaging.util.FileUtils.append;
 import static org.elasticsearch.packaging.util.FileUtils.getTempDir;
 import static org.elasticsearch.packaging.util.FileUtils.rm;
@@ -73,6 +74,7 @@
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.nullValue;
+import static org.junit.Assume.assumeFalse;
 import static org.junit.Assume.assumeTrue;
 
 public class DockerTests extends PackagingTestCase {
@@ -334,10 +336,51 @@ public void test081ConfigurePasswordThroughEnvironmentVariableFile() throws Exce
         assertThat("Expected server to require authentication", statusCode, equalTo(401));
     }
 
+    /**
+     * Check that when verifying the file permissions of _FILE environment variables, symlinks
+     * are followed.
+     */
+    public void test082SymlinksAreFollowedWithEnvironmentVariableFiles() throws Exception {
+        // Test relies on configuring security
+        assumeTrue(distribution.isDefault());
+        // Test relies on symlinks
+        assumeFalse(Platforms.WINDOWS);
+
+        final String xpackPassword = "hunter2";
+        final String passwordFilename = "password.txt";
+        final String symlinkFilename = "password_symlink";
+
+        // ELASTIC_PASSWORD_FILE
+        Files.writeString(tempDir.resolve(passwordFilename), xpackPassword + "\n");
+
+        // Link to the password file. We can't use an absolute path for the target, because
+        // it won't resolve inside the container.
+        Files.createSymbolicLink(tempDir.resolve(symlinkFilename), Path.of(passwordFilename));
+
+        Map<String, String> envVars = Map.of(
+            "ELASTIC_PASSWORD_FILE",
+            "/run/secrets/" + symlinkFilename,
+            // Enable security so that we can test that the password has been used
+            "xpack.security.enabled",
+            "true"
+        );
+
+        // File permissions need to be secured in order for the ES wrapper to accept
+        // them for populating env var values. The wrapper will resolve the symlink
+        // and check the target's permissions.
+        Files.setPosixFilePermissions(tempDir.resolve(passwordFilename), p600);
+
+        final Map<Path, Path> volumes = Map.of(tempDir, Path.of("/run/secrets"));
+
+        // Restart the container - this will check that Elasticsearch started correctly,
+        // and didn't fail to follow the symlink and check the file permissions
+        runContainer(distribution(), volumes, envVars);
+    }
+
     /**
      * Check that environment variables cannot be used with _FILE environment variables.
      */
-    public void test081CannotUseEnvVarsAndFiles() throws Exception {
+    public void test083CannotUseEnvVarsAndFiles() throws Exception {
         final String optionsFilename = "esJavaOpts.txt";
 
         // ES_JAVA_OPTS_FILE
@@ -368,7 +411,7 @@ public void test081CannotUseEnvVarsAndFiles() throws Exception {
      * Check that when populating environment variables by setting variables with the suffix "_FILE",
      * the files' permissions are checked.
      */
-    public void test082EnvironmentVariablesUsingFilesHaveCorrectPermissions() throws Exception {
+    public void test084EnvironmentVariablesUsingFilesHaveCorrectPermissions() throws Exception {
         final String optionsFilename = "esJavaOpts.txt";
 
         // ES_JAVA_OPTS_FILE
@@ -390,11 +433,60 @@ public void test082EnvironmentVariablesUsingFilesHaveCorrectPermissions() throws
         );
     }
 
+    /**
+     * Check that when verifying the file permissions of _FILE environment variables, symlinks
+     * are followed, and that invalid target permissions are detected.
+     */
+    public void test085SymlinkToFileWithInvalidPermissionsIsRejected() throws Exception {
+        // Test relies on configuring security
+        assumeTrue(distribution.isDefault());
+        // Test relies on symlinks
+        assumeFalse(Platforms.WINDOWS);
+
+        final String xpackPassword = "hunter2";
+        final String passwordFilename = "password.txt";
+        final String symlinkFilename = "password_symlink";
+
+        // ELASTIC_PASSWORD_FILE
+        Files.writeString(tempDir.resolve(passwordFilename), xpackPassword + "\n");
+
+        // Link to the password file. We can't use an absolute path for the target, because
+        // it won't resolve inside the container.
+        Files.createSymbolicLink(tempDir.resolve(symlinkFilename), Path.of(passwordFilename));
+
+        Map<String, String> envVars = Map.of(
+            "ELASTIC_PASSWORD_FILE",
+            "/run/secrets/" + symlinkFilename,
+            // Enable security so that we can test that the password has been used
+            "xpack.security.enabled",
+            "true"
+        );
+
+        // Set invalid permissions on the file that the symlink targets
+        Files.setPosixFilePermissions(tempDir.resolve(passwordFilename), p775);
+
+        final Map<Path, Path> volumes = Map.of(tempDir, Path.of("/run/secrets"));
+
+        // Restart the container
+        final Result dockerLogs = runContainerExpectingFailure(distribution(), volumes, envVars);
+
+        assertThat(
+            dockerLogs.stderr,
+            containsString(
+                "ERROR: File "
+                    + passwordFilename
+                    + " (target of symlink /run/secrets/"
+                    + symlinkFilename
+                    + " from ELASTIC_PASSWORD_FILE) must have file permissions 400 or 600, but actually has: 775"
+            )
+        );
+    }
+
     /**
      * Check that environment variables are translated to -E options even for commands invoked under
      * `docker exec`, where the Docker image's entrypoint is not executed.
      */
-    public void test83EnvironmentVariablesAreRespectedUnderDockerExec() {
+    public void test086EnvironmentVariablesAreRespectedUnderDockerExec() {
         // This test relies on a CLI tool attempting to connect to Elasticsearch, and the
         // tool in question is only in the default distribution.
         assumeTrue(distribution.isDefault());
@@ -405,10 +497,7 @@ public void test83EnvironmentVariablesAreRespectedUnderDockerExec() {
         final Result result = sh.runIgnoreExitCode("elasticsearch-setup-passwords auto");
 
         assertFalse("elasticsearch-setup-passwords command should have failed", result.isSuccess());
-        assertThat(
-            result.stdout,
-            containsString("java.net.UnknownHostException: this.is.not.valid: Name or service not known")
-        );
+        assertThat(result.stdout, containsString("java.net.UnknownHostException: this.is.not.valid: Name or service not known"));
     }
 
     /**

From e0cd30b13b1c8fb6eb87473b992839b3488da380 Mon Sep 17 00:00:00 2001
From: Florian Kelbert <florian.kelbert@elastic.co>
Date: Thu, 16 Jan 2020 15:34:25 +0100
Subject: [PATCH 617/686] [DOCS] Correctly read total hits inside watcher
 config (#50614)

With elastic/elasticsearch#35848, users can now retrieve total hits as an integer when the `rest_total_hits_as_int` query parameter is `true`. This is the default value.

This updates several snippet examples in the Watcher docs that used a workaround to get a total hits integer.
---
 x-pack/docs/en/watcher/actions.asciidoc | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/x-pack/docs/en/watcher/actions.asciidoc b/x-pack/docs/en/watcher/actions.asciidoc
index e140e622d304c..6e0a8c6efb377 100644
--- a/x-pack/docs/en/watcher/actions.asciidoc
+++ b/x-pack/docs/en/watcher/actions.asciidoc
@@ -69,14 +69,14 @@ PUT _watcher/watch/error_logs_alert
     }
   },
   "condition" : {
-    "compare" : { "ctx.payload.hits.total.value" : { "gt" : 5 }}
+    "compare" : { "ctx.payload.hits.total" : { "gt" : 5 }}
   },
   "actions" : {
     "email_administrator" : {
       "throttle_period": "15m", <1>
       "email" : { <2>
         "to" : "sys.admino@host.domain",
-        "subject" : "Encountered {{ctx.payload.hits.total.value}} errors",
+        "subject" : "Encountered {{ctx.payload.hits.total}} errors",
         "body" : "Too many error in the system, see attached data",
         "attachments" : {
           "attached_data" : {
@@ -119,14 +119,14 @@ PUT _watcher/watch/log_event_watch
     }
   },
   "condition" : {
-    "compare" : { "ctx.payload.hits.total.value" : { "gt" : 5 }}
+    "compare" : { "ctx.payload.hits.total" : { "gt" : 5 }}
   },
   "throttle_period" : "15m", <1>
   "actions" : {
     "email_administrator" : {
       "email" : {
         "to" : "sys.admino@host.domain",
-        "subject" : "Encountered {{ctx.payload.hits.total.value}} errors",
+        "subject" : "Encountered {{ctx.payload.hits.total}} errors",
         "body" : "Too many error in the system, see attached data",
         "attachments" : {
           "attached_data" : {
@@ -144,7 +144,7 @@ PUT _watcher/watch/log_event_watch
         "host" : "pager.service.domain",
         "port" : 1234,
         "path" : "/{{watch_id}}",
-        "body" : "Encountered {{ctx.payload.hits.total.value}} errors"
+        "body" : "Encountered {{ctx.payload.hits.total}} errors"
       }
     }
   }
@@ -265,13 +265,13 @@ PUT _watcher/watch/log_event_watch
     }
   },
   "condition" : {
-    "compare" : { "ctx.payload.hits.total.value" : { "gt" : 0 } }
+    "compare" : { "ctx.payload.hits.total" : { "gt" : 0 } }
   },
   "actions" : {
     "email_administrator" : {
       "email" : {
         "to" : "sys.admino@host.domain",
-        "subject" : "Encountered {{ctx.payload.hits.total.value}} errors",
+        "subject" : "Encountered {{ctx.payload.hits.total}} errors",
         "body" : "Too many error in the system, see attached data",
         "attachments" : {
           "attached_data" : {
@@ -285,14 +285,14 @@ PUT _watcher/watch/log_event_watch
     },
     "notify_pager" : {
       "condition": { <1>
-        "compare" : { "ctx.payload.hits.total.value" : { "gt" : 5 } }
+        "compare" : { "ctx.payload.hits.total" : { "gt" : 5 } }
       },
       "webhook" : {
         "method" : "POST",
         "host" : "pager.service.domain",
         "port" : 1234,
         "path" : "/{{watch_id}}",
-        "body" : "Encountered {{ctx.payload.hits.total.value}} errors"
+        "body" : "Encountered {{ctx.payload.hits.total}} errors"
       }
     }
   }

From 38fb64af8945fbf8e1300a0957d6f3fe4410019d Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Thu, 16 Jan 2020 09:43:07 -0500
Subject: [PATCH 618/686] Goodbye and thank you synced flush! (#50882)

Synced flush was a brilliant idea. It supports instant recoveries with a
quite small implementation. However, with the presence of sequence
numbers and retention leases, it is no longer needed. This change
removes it from 8.0.

Relates #5077
---
 .../elasticsearch/client/IndicesClient.java   |  36 -
 .../client/IndicesRequestConverters.java      |  10 -
 .../client/SyncedFlushResponse.java           | 346 --------
 .../elasticsearch/client/IndicesClientIT.java |  37 -
 .../client/IndicesRequestConvertersTests.java |  25 -
 .../client/SyncedFlushResponseTests.java      | 270 ------
 .../IndicesClientDocumentationIT.java         |  90 --
 .../high-level/indices/flush_synced.asciidoc  |  62 --
 .../high-level/supported-apis.asciidoc        |   2 -
 .../index-modules/allocation/delayed.asciidoc |   2 +-
 docs/reference/indices.asciidoc               |   5 +-
 docs/reference/indices/synced-flush.asciidoc  | 276 +------
 .../migration/migrate_8_0/indices.asciidoc    |   7 +
 docs/reference/modules/threadpool.asciidoc    |  24 +-
 docs/reference/setup/restart-cluster.asciidoc |  62 +-
 .../upgrade/cluster_restart.asciidoc          |  12 +-
 docs/reference/upgrade/synced-flush.asciidoc  |  14 -
 .../upgrades/FullClusterRestartIT.java        |  11 +-
 .../elasticsearch/backwards/IndexingIT.java   |  56 ++
 .../elasticsearch/upgrades/RecoveryIT.java    |  40 +-
 .../api/indices.flush_synced.json             |  54 --
 .../test/indices.flush/10_basic.yml           |  30 -
 .../elasticsearch/action/ActionModule.java    |   3 -
 .../indices/flush/SyncedFlushAction.java      |  33 -
 .../indices/flush/SyncedFlushRequest.java     |  57 --
 .../flush/SyncedFlushRequestBuilder.java      |  41 -
 .../indices/flush/SyncedFlushResponse.java    | 213 -----
 .../flush/TransportShardFlushAction.java      |  48 ++
 .../flush/TransportSyncedFlushAction.java     |  48 --
 .../client/IndicesAdminClient.java            |  26 -
 .../org/elasticsearch/client/Requests.java    |  12 -
 .../client/support/AbstractClient.java        |  19 -
 .../index/engine/CommitStats.java             |   7 -
 .../elasticsearch/index/shard/IndexShard.java |   6 -
 .../elasticsearch/indices/IndicesModule.java  |   2 -
 .../cluster/IndicesClusterStateService.java   |   4 -
 .../flush/ShardsSyncedFlushResult.java        | 163 ----
 .../indices/flush/SyncedFlushService.java     | 768 ------------------
 .../admin/indices/RestSyncedFlushAction.java  |  56 +-
 .../indices/flush/SyncedFlushUnitTests.java   | 189 -----
 .../gateway/ReplicaShardAllocatorIT.java      |  10 +-
 ...ClusterStateServiceRandomUpdatesTests.java |   1 -
 .../elasticsearch/indices/flush/FlushIT.java  | 276 -------
 .../flush/SyncedFlushSingleNodeTests.java     | 243 ------
 .../indices/flush/SyncedFlushUtil.java        | 110 ---
 .../indices/recovery/IndexRecoveryIT.java     |  89 +-
 .../indices/state/CloseIndexIT.java           |   7 +-
 .../snapshots/SnapshotResiliencyTests.java    |   2 -
 .../elasticsearch/test/ESIntegTestCase.java   |  10 +-
 .../test/InternalTestCluster.java             |  32 -
 .../test/rest/ESRestTestCase.java             |  67 +-
 .../engine/FrozenIndexRecoveryTests.java      |   6 +-
 .../integration/MlDistributedFailureIT.java   |   2 +-
 53 files changed, 290 insertions(+), 3731 deletions(-)
 delete mode 100644 client/rest-high-level/src/main/java/org/elasticsearch/client/SyncedFlushResponse.java
 delete mode 100644 client/rest-high-level/src/test/java/org/elasticsearch/client/SyncedFlushResponseTests.java
 delete mode 100644 docs/java-rest/high-level/indices/flush_synced.asciidoc
 delete mode 100644 docs/reference/upgrade/synced-flush.asciidoc
 delete mode 100644 rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
 delete mode 100644 server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushAction.java
 delete mode 100644 server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushRequest.java
 delete mode 100644 server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushRequestBuilder.java
 delete mode 100644 server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushResponse.java
 delete mode 100644 server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportSyncedFlushAction.java
 delete mode 100644 server/src/main/java/org/elasticsearch/indices/flush/ShardsSyncedFlushResult.java
 delete mode 100644 server/src/main/java/org/elasticsearch/indices/flush/SyncedFlushService.java
 delete mode 100644 server/src/test/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushUnitTests.java
 delete mode 100644 server/src/test/java/org/elasticsearch/indices/flush/SyncedFlushSingleNodeTests.java
 delete mode 100644 server/src/test/java/org/elasticsearch/indices/flush/SyncedFlushUtil.java

diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java
index e00a9c0da8d50..96494238e75e0 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushResponse;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeResponse;
 import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
@@ -415,41 +414,6 @@ public Cancellable flushAsync(FlushRequest flushRequest, RequestOptions options,
                 FlushResponse::fromXContent, listener, emptySet());
     }
 
-    /**
-     * Initiate a synced flush manually using the synced flush API.
-     * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-synced-flush-api.html">
-     *     Synced flush API on elastic.co</a>
-     * @param syncedFlushRequest the request
-     * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
-     * @return the response
-     * @throws IOException in case there is a problem sending the request or parsing back the response
-     * @deprecated synced flush is deprecated and will be removed in 8.0.
-     * Use {@link #flush(FlushRequest, RequestOptions)} instead.
-     */
-    @Deprecated
-    public SyncedFlushResponse flushSynced(SyncedFlushRequest syncedFlushRequest, RequestOptions options) throws IOException {
-        return restHighLevelClient.performRequestAndParseEntity(syncedFlushRequest, IndicesRequestConverters::flushSynced, options,
-                SyncedFlushResponse::fromXContent, emptySet());
-    }
-
-    /**
-     * Asynchronously initiate a synced flush manually using the synced flush API.
-     * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-synced-flush-api.html">
-     *     Synced flush API on elastic.co</a>
-     * @param syncedFlushRequest the request
-     * @param options the request options (e.g. headers), use {@link RequestOptions#DEFAULT} if nothing needs to be customized
-     * @param listener the listener to be notified upon request completion
-     * @return cancellable that may be used to cancel the request
-     * @deprecated synced flush is deprecated and will be removed in 8.0.
-     * Use {@link #flushAsync(FlushRequest, RequestOptions, ActionListener)} instead.
-     */
-    @Deprecated
-    public Cancellable flushSyncedAsync(SyncedFlushRequest syncedFlushRequest, RequestOptions options,
-                                        ActionListener<SyncedFlushResponse> listener) {
-        return restHighLevelClient.performRequestAsyncAndParseEntity(syncedFlushRequest, IndicesRequestConverters::flushSynced, options,
-                SyncedFlushResponse::fromXContent, listener, emptySet());
-    }
-
     /**
      * Retrieve the settings of one or more indices.
      * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-get-settings.html">
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesRequestConverters.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesRequestConverters.java
index 553da42711c38..fea48c1c3e909 100644
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesRequestConverters.java
+++ b/client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesRequestConverters.java
@@ -29,7 +29,6 @@
 import org.elasticsearch.action.admin.indices.cache.clear.ClearIndicesCacheRequest;
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequest;
 import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
 import org.elasticsearch.action.admin.indices.refresh.RefreshRequest;
@@ -194,15 +193,6 @@ static Request flush(FlushRequest flushRequest) {
         return request;
     }
 
-    static Request flushSynced(SyncedFlushRequest syncedFlushRequest) {
-        String[] indices = syncedFlushRequest.indices() == null ? Strings.EMPTY_ARRAY : syncedFlushRequest.indices();
-        Request request = new Request(HttpPost.METHOD_NAME, RequestConverters.endpoint(indices, "_flush/synced"));
-        RequestConverters.Params parameters = new RequestConverters.Params();
-        parameters.withIndicesOptions(syncedFlushRequest.indicesOptions());
-        request.addParameters(parameters.asMap());
-        return request;
-    }
-
     static Request forceMerge(ForceMergeRequest forceMergeRequest) {
         String[] indices = forceMergeRequest.indices() == null ? Strings.EMPTY_ARRAY : forceMergeRequest.indices();
         Request request = new Request(HttpPost.METHOD_NAME, RequestConverters.endpoint(indices, "_forcemerge"));
diff --git a/client/rest-high-level/src/main/java/org/elasticsearch/client/SyncedFlushResponse.java b/client/rest-high-level/src/main/java/org/elasticsearch/client/SyncedFlushResponse.java
deleted file mode 100644
index 41e9c3d062b0a..0000000000000
--- a/client/rest-high-level/src/main/java/org/elasticsearch/client/SyncedFlushResponse.java
+++ /dev/null
@@ -1,346 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.client;
-
-import org.elasticsearch.common.ParseField;
-import org.elasticsearch.common.ParsingException;
-import org.elasticsearch.common.xcontent.ConstructingObjectParser;
-import org.elasticsearch.common.xcontent.ToXContentFragment;
-import org.elasticsearch.common.xcontent.ToXContentObject;
-import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentLocation;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.common.xcontent.XContentParser.Token;
-
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
-import static org.elasticsearch.common.xcontent.ConstructingObjectParser.optionalConstructorArg;
-import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
-
-public class SyncedFlushResponse implements ToXContentObject {
-
-    public static final String SHARDS_FIELD = "_shards";
-
-    private ShardCounts totalCounts;
-    private Map<String, IndexResult> indexResults;
-
-    SyncedFlushResponse(ShardCounts totalCounts, Map<String, IndexResult> indexResults) {
-        this.totalCounts = new ShardCounts(totalCounts.total, totalCounts.successful, totalCounts.failed);
-        this.indexResults = Collections.unmodifiableMap(indexResults);
-    }
-
-    /**
-     * @return The total number of shard copies that were processed across all indexes
-     */
-    public int totalShards() {
-        return totalCounts.total;
-    }
-
-    /**
-     * @return The number of successful shard copies that were processed across all indexes
-     */
-    public int successfulShards() {
-        return totalCounts.successful;
-    }
-
-    /**
-     * @return The number of failed shard copies that were processed across all indexes
-     */
-    public int failedShards() {
-        return totalCounts.failed;
-    }
-
-    /**
-     * @return A map of results for each index where the keys of the map are the index names
-     *          and the values are the results encapsulated in {@link IndexResult}.
-     */
-    public Map<String, IndexResult> getIndexResults() {
-        return indexResults;
-    }
-
-    ShardCounts getShardCounts() {
-        return totalCounts;
-    }
-
-    @Override
-    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-        builder.startObject();
-        builder.startObject(SHARDS_FIELD);
-        totalCounts.toXContent(builder, params);
-        builder.endObject();
-        for (Map.Entry<String, IndexResult> entry: indexResults.entrySet()) {
-            String indexName = entry.getKey();
-            IndexResult indexResult = entry.getValue();
-            builder.startObject(indexName);
-            indexResult.toXContent(builder, params);
-            builder.endObject();
-        }
-        builder.endObject();
-        return builder;
-    }
-
-    public static SyncedFlushResponse fromXContent(XContentParser parser) throws IOException {
-        ensureExpectedToken(Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation);
-        ShardCounts totalCounts = null;
-        Map<String, IndexResult> indexResults = new HashMap<>();
-        XContentLocation startLoc = parser.getTokenLocation();
-        while (parser.nextToken().equals(Token.FIELD_NAME)) {
-            if (parser.currentName().equals(SHARDS_FIELD)) {
-                ensureExpectedToken(Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation);
-                totalCounts = ShardCounts.fromXContent(parser);
-            } else {
-                String indexName = parser.currentName();
-                IndexResult indexResult = IndexResult.fromXContent(parser);
-                indexResults.put(indexName, indexResult);
-            }
-        }
-        if (totalCounts != null) {
-            return new SyncedFlushResponse(totalCounts, indexResults);
-        } else {
-            throw new ParsingException(
-                startLoc,
-                "Unable to reconstruct object. Total counts for shards couldn't be parsed."
-            );
-        }
-    }
-
-    /**
-     * Encapsulates the number of total successful and failed shard copies
-     */
-    public static final class ShardCounts implements ToXContentFragment {
-
-        public static final String TOTAL_FIELD = "total";
-        public static final String SUCCESSFUL_FIELD = "successful";
-        public static final String FAILED_FIELD = "failed";
-
-        private static final ConstructingObjectParser<ShardCounts, Void> PARSER =
-            new ConstructingObjectParser<>(
-                "shardcounts",
-                a -> new ShardCounts((Integer) a[0], (Integer) a[1], (Integer) a[2])
-            );
-        static {
-            PARSER.declareInt(constructorArg(), new ParseField(TOTAL_FIELD));
-            PARSER.declareInt(constructorArg(), new ParseField(SUCCESSFUL_FIELD));
-            PARSER.declareInt(constructorArg(), new ParseField(FAILED_FIELD));
-        }
-
-        private int total;
-        private int successful;
-        private int failed;
-
-
-        ShardCounts(int total, int successful, int failed) {
-            this.total = total;
-            this.successful = successful;
-            this.failed = failed;
-        }
-
-        @Override
-        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            builder.field(TOTAL_FIELD, total);
-            builder.field(SUCCESSFUL_FIELD, successful);
-            builder.field(FAILED_FIELD, failed);
-            return builder;
-        }
-
-        public static ShardCounts fromXContent(XContentParser parser) throws IOException {
-            return PARSER.parse(parser, null);
-        }
-
-        public boolean equals(ShardCounts other) {
-            if (other != null) {
-                return
-                    other.total == this.total &&
-                    other.successful == this.successful &&
-                    other.failed == this.failed;
-            } else {
-                return false;
-            }
-        }
-
-    }
-
-    /**
-     * Description for the flush/synced results for a particular index.
-     * This includes total, successful and failed copies along with failure description for each failed copy.
-     */
-    public static final class IndexResult implements ToXContentFragment {
-
-        public static final String TOTAL_FIELD = "total";
-        public static final String SUCCESSFUL_FIELD = "successful";
-        public static final String FAILED_FIELD = "failed";
-        public static final String FAILURES_FIELD = "failures";
-
-        @SuppressWarnings("unchecked")
-        private static final ConstructingObjectParser<IndexResult, Void> PARSER =
-            new ConstructingObjectParser<>(
-                "indexresult",
-                a -> new IndexResult((Integer) a[0], (Integer) a[1], (Integer) a[2], (List<ShardFailure>)a[3])
-            );
-        static {
-            PARSER.declareInt(constructorArg(), new ParseField(TOTAL_FIELD));
-            PARSER.declareInt(constructorArg(), new ParseField(SUCCESSFUL_FIELD));
-            PARSER.declareInt(constructorArg(), new ParseField(FAILED_FIELD));
-            PARSER.declareObjectArray(optionalConstructorArg(), ShardFailure.PARSER, new ParseField(FAILURES_FIELD));
-        }
-
-        private ShardCounts counts;
-        private List<ShardFailure> failures;
-
-        IndexResult(int total, int successful, int failed, List<ShardFailure> failures) {
-            counts = new ShardCounts(total, successful, failed);
-            if (failures != null) {
-                this.failures = Collections.unmodifiableList(failures);
-            } else {
-                this.failures = Collections.unmodifiableList(new ArrayList<>());
-            }
-        }
-
-        /**
-         * @return The total number of shard copies that were processed for this index.
-         */
-        public int totalShards() {
-            return counts.total;
-        }
-
-        /**
-         * @return The number of successful shard copies that were processed for this index.
-         */
-        public int successfulShards() {
-            return counts.successful;
-        }
-
-        /**
-         * @return The number of failed shard copies that were processed for this index.
-         */
-        public int failedShards() {
-            return counts.failed;
-        }
-
-        /**
-         * @return A list of {@link ShardFailure} objects that describe each of the failed shard copies for this index.
-         */
-        public List<ShardFailure> failures() {
-            return failures;
-        }
-
-        ShardCounts getShardCounts() {
-            return counts;
-        }
-
-        @Override
-        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            counts.toXContent(builder, params);
-            if (failures.size() > 0) {
-                builder.startArray(FAILURES_FIELD);
-                for (ShardFailure failure : failures) {
-                    failure.toXContent(builder, params);
-                }
-                builder.endArray();
-            }
-            return builder;
-        }
-
-        public static IndexResult fromXContent(XContentParser parser) throws IOException {
-            return PARSER.parse(parser, null);
-        }
-    }
-
-    /**
-     * Description of a failed shard copy for an index.
-     */
-    public static final class ShardFailure implements ToXContentFragment {
-
-        public static String SHARD_ID_FIELD = "shard";
-        public static String FAILURE_REASON_FIELD = "reason";
-        public static String ROUTING_FIELD = "routing";
-
-        private int shardId;
-        private String failureReason;
-        private Map<String, Object> routing;
-
-        @SuppressWarnings("unchecked")
-        static final ConstructingObjectParser<ShardFailure, Void> PARSER = new ConstructingObjectParser<>(
-            "shardfailure",
-            a -> new ShardFailure((Integer)a[0], (String)a[1], (Map<String, Object>)a[2])
-        );
-        static {
-            PARSER.declareInt(constructorArg(), new ParseField(SHARD_ID_FIELD));
-            PARSER.declareString(constructorArg(), new ParseField(FAILURE_REASON_FIELD));
-            PARSER.declareObject(
-                optionalConstructorArg(),
-                (parser, c) -> parser.map(),
-                new ParseField(ROUTING_FIELD)
-            );
-        }
-
-        ShardFailure(int shardId, String failureReason, Map<String, Object> routing) {
-            this.shardId = shardId;
-            this.failureReason = failureReason;
-            if (routing != null) {
-                this.routing = Collections.unmodifiableMap(routing);
-            } else {
-                this.routing = Collections.unmodifiableMap(new HashMap<>());
-            }
-        }
-
-        /**
-         * @return Id of the shard whose copy failed
-         */
-        public int getShardId() {
-            return shardId;
-        }
-
-        /**
-         * @return Reason for failure of the shard copy
-         */
-        public String getFailureReason() {
-            return failureReason;
-        }
-
-        /**
-         * @return Additional information about the failure.
-         */
-        public Map<String, Object> getRouting() {
-            return routing;
-        }
-
-        @Override
-        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            builder.startObject();
-            builder.field(SHARD_ID_FIELD, shardId);
-            builder.field(FAILURE_REASON_FIELD, failureReason);
-            if (routing.size() > 0) {
-                builder.field(ROUTING_FIELD, routing);
-            }
-            builder.endObject();
-            return builder;
-        }
-
-        public static ShardFailure fromXContent(XContentParser parser) throws IOException {
-            return PARSER.parse(parser, null);
-        }
-    }
-}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesClientIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesClientIT.java
index 842d348115845..3303ed4f218e4 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesClientIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesClientIT.java
@@ -33,7 +33,6 @@
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushResponse;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeResponse;
 import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
@@ -97,7 +96,6 @@
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
-import org.elasticsearch.indices.flush.SyncedFlushService;
 import org.elasticsearch.rest.RestStatus;
 
 import java.io.IOException;
@@ -759,41 +757,6 @@ public void testFlush() throws IOException {
         }
     }
 
-    public void testSyncedFlush() throws IOException {
-        {
-            String index = "index";
-            Settings settings = Settings.builder()
-                    .put("number_of_shards", 1)
-                    .put("number_of_replicas", 0)
-                    .build();
-            createIndex(index, settings);
-            SyncedFlushRequest syncedFlushRequest = new SyncedFlushRequest(index);
-            SyncedFlushResponse flushResponse =
-                    execute(syncedFlushRequest, highLevelClient().indices()::flushSynced, highLevelClient().indices()::flushSyncedAsync,
-                        expectWarnings(SyncedFlushService.SYNCED_FLUSH_DEPRECATION_MESSAGE));
-            assertThat(flushResponse.totalShards(), equalTo(1));
-            assertThat(flushResponse.successfulShards(), equalTo(1));
-            assertThat(flushResponse.failedShards(), equalTo(0));
-        }
-        {
-            String nonExistentIndex = "non_existent_index";
-            assertFalse(indexExists(nonExistentIndex));
-            SyncedFlushRequest syncedFlushRequest = new SyncedFlushRequest(nonExistentIndex);
-            ElasticsearchException exception = expectThrows(
-                ElasticsearchException.class,
-                () ->
-                    execute(
-                        syncedFlushRequest,
-                        highLevelClient().indices()::flushSynced,
-                        highLevelClient().indices()::flushSyncedAsync,
-                        expectWarnings(SyncedFlushService.SYNCED_FLUSH_DEPRECATION_MESSAGE)
-                    )
-            );
-            assertEquals(RestStatus.NOT_FOUND, exception.status());
-        }
-    }
-
-
     public void testClearCache() throws IOException {
         {
             String index = "index";
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesRequestConvertersTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesRequestConvertersTests.java
index ae94e700b5fb7..c9c2ee065fded 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesRequestConvertersTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/IndicesRequestConvertersTests.java
@@ -32,7 +32,6 @@
 import org.elasticsearch.action.admin.indices.cache.clear.ClearIndicesCacheRequest;
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequest;
 import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
 import org.elasticsearch.action.admin.indices.refresh.RefreshRequest;
@@ -460,30 +459,6 @@ public void testFlush() {
         Assert.assertThat(request.getMethod(), equalTo(HttpPost.METHOD_NAME));
     }
 
-    public void testSyncedFlush() {
-        String[] indices = ESTestCase.randomBoolean() ? null : RequestConvertersTests.randomIndicesNames(0, 5);
-        SyncedFlushRequest syncedFlushRequest;
-        if (ESTestCase.randomBoolean()) {
-            syncedFlushRequest = new SyncedFlushRequest(indices);
-        } else {
-            syncedFlushRequest = new SyncedFlushRequest();
-            syncedFlushRequest.indices(indices);
-        }
-        Map<String, String> expectedParams = new HashMap<>();
-        RequestConvertersTests.setRandomIndicesOptions(syncedFlushRequest::indicesOptions, syncedFlushRequest::indicesOptions,
-            expectedParams);
-        Request request = IndicesRequestConverters.flushSynced(syncedFlushRequest);
-        StringJoiner endpoint = new StringJoiner("/", "/", "");
-        if (indices != null && indices.length > 0) {
-                endpoint.add(String.join(",", indices));
-            }
-        endpoint.add("_flush/synced");
-        Assert.assertThat(request.getEndpoint(), equalTo(endpoint.toString()));
-        Assert.assertThat(request.getParameters(), equalTo(expectedParams));
-        Assert.assertThat(request.getEntity(), nullValue());
-        Assert.assertThat(request.getMethod(), equalTo(HttpPost.METHOD_NAME));
-    }
-
     public void testForceMerge() {
         String[] indices = ESTestCase.randomBoolean() ? null : RequestConvertersTests.randomIndicesNames(0, 5);
         ForceMergeRequest forceMergeRequest;
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/SyncedFlushResponseTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/SyncedFlushResponseTests.java
deleted file mode 100644
index f5cb9cdb0e02b..0000000000000
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/SyncedFlushResponseTests.java
+++ /dev/null
@@ -1,270 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.client;
-
-import com.carrotsearch.hppc.ObjectIntHashMap;
-import com.carrotsearch.hppc.ObjectIntMap;
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.cluster.routing.ShardRoutingState;
-import org.elasticsearch.cluster.routing.TestShardRouting;
-import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.xcontent.DeprecationHandler;
-import org.elasticsearch.common.xcontent.ToXContent;
-import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.XContentParser;
-import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.shard.ShardId;
-import org.elasticsearch.indices.flush.ShardsSyncedFlushResult;
-import org.elasticsearch.indices.flush.SyncedFlushService;
-import org.elasticsearch.test.ESTestCase;
-
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.List;
-import java.util.Map;
-import java.util.Set;
-
-public class SyncedFlushResponseTests extends ESTestCase {
-
-    public void testXContentSerialization() throws IOException {
-        final XContentType xContentType = randomFrom(XContentType.values());
-        TestPlan plan = createTestPlan();
-
-        XContentBuilder serverResponsebuilder = XContentBuilder.builder(xContentType.xContent());
-        assertNotNull(plan.result);
-        serverResponsebuilder.startObject();
-        plan.result.toXContent(serverResponsebuilder, ToXContent.EMPTY_PARAMS);
-        serverResponsebuilder.endObject();
-        XContentBuilder clientResponsebuilder = XContentBuilder.builder(xContentType.xContent());
-        assertNotNull(plan.result);
-        plan.clientResult.toXContent(clientResponsebuilder, ToXContent.EMPTY_PARAMS);
-        Map<String, Object> serverContentMap = convertFailureListToSet(
-            serverResponsebuilder
-                .generator()
-                .contentType()
-                .xContent()
-                .createParser(
-                    xContentRegistry(),
-                    DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
-                    BytesReference.bytes(serverResponsebuilder).streamInput()
-                ).map()
-        );
-        Map<String, Object> clientContentMap = convertFailureListToSet(
-            clientResponsebuilder
-                .generator()
-                .contentType()
-                .xContent()
-                .createParser(
-                    xContentRegistry(),
-                    DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
-                    BytesReference.bytes(clientResponsebuilder).streamInput()
-                )
-                .map()
-        );
-        assertEquals(serverContentMap, clientContentMap);
-    }
-
-    public void testXContentDeserialization() throws IOException {
-        final XContentType xContentType = randomFrom(XContentType.values());
-        TestPlan plan = createTestPlan();
-        XContentBuilder builder = XContentBuilder.builder(xContentType.xContent());
-        builder.startObject();
-        plan.result.toXContent(builder, ToXContent.EMPTY_PARAMS);
-        builder.endObject();
-        XContentParser parser = builder
-            .generator()
-            .contentType()
-            .xContent()
-            .createParser(
-                xContentRegistry(),
-                DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
-                BytesReference.bytes(builder).streamInput()
-            );
-        SyncedFlushResponse originalResponse = plan.clientResult;
-        SyncedFlushResponse parsedResponse = SyncedFlushResponse.fromXContent(parser);
-        assertNotNull(parsedResponse);
-        assertShardCounts(originalResponse.getShardCounts(), parsedResponse.getShardCounts());
-        for (Map.Entry<String, SyncedFlushResponse.IndexResult> entry: originalResponse.getIndexResults().entrySet()) {
-            String index = entry.getKey();
-            SyncedFlushResponse.IndexResult responseResult = entry.getValue();
-            SyncedFlushResponse.IndexResult parsedResult = parsedResponse.getIndexResults().get(index);
-            assertNotNull(responseResult);
-            assertNotNull(parsedResult);
-            assertShardCounts(responseResult.getShardCounts(), parsedResult.getShardCounts());
-            assertEquals(responseResult.failures().size(), parsedResult.failures().size());
-            for (SyncedFlushResponse.ShardFailure responseShardFailure: responseResult.failures()) {
-                assertTrue(containsFailure(parsedResult.failures(), responseShardFailure));
-            }
-        }
-    }
-
-    static class TestPlan {
-        SyncedFlushResponse.ShardCounts totalCounts;
-        Map<String, SyncedFlushResponse.ShardCounts> countsPerIndex = new HashMap<>();
-        ObjectIntMap<String> expectedFailuresPerIndex = new ObjectIntHashMap<>();
-        org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse result;
-        SyncedFlushResponse clientResult;
-    }
-
-    TestPlan createTestPlan() throws IOException {
-        final TestPlan testPlan = new TestPlan();
-        final Map<String, List<ShardsSyncedFlushResult>> indicesResults = new HashMap<>();
-        Map<String, SyncedFlushResponse.IndexResult> indexResults = new HashMap<>();
-        final XContentType xContentType = randomFrom(XContentType.values());
-        final int indexCount = randomIntBetween(1, 10);
-        int totalShards = 0;
-        int totalSuccessful = 0;
-        int totalFailed = 0;
-        for (int i = 0; i < indexCount; i++) {
-            final String index = "index_" + i;
-            int shards = randomIntBetween(1, 4);
-            int replicas = randomIntBetween(0, 2);
-            int successful = 0;
-            int failed = 0;
-            int failures = 0;
-            List<ShardsSyncedFlushResult> shardsResults = new ArrayList<>();
-            List<SyncedFlushResponse.ShardFailure> shardFailures = new ArrayList<>();
-            for (int shard = 0; shard < shards; shard++) {
-                final ShardId shardId = new ShardId(index, "_na_", shard);
-                if (randomInt(5) < 2) {
-                    // total shard failure
-                    failed += replicas + 1;
-                    failures++;
-                    shardsResults.add(new ShardsSyncedFlushResult(shardId, replicas + 1, "simulated total failure"));
-                    shardFailures.add(
-                        new SyncedFlushResponse.ShardFailure(
-                            shardId.id(),
-                            "simulated total failure",
-                            new HashMap<>()
-                        )
-                    );
-                } else {
-                    Map<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> shardResponses = new HashMap<>();
-                    for (int copy = 0; copy < replicas + 1; copy++) {
-                        final ShardRouting shardRouting =
-                            TestShardRouting.newShardRouting(
-                                index, shard, "node_" + shardId + "_" + copy, null,
-                                copy == 0, ShardRoutingState.STARTED
-                            );
-                        if (randomInt(5) < 2) {
-                            // shard copy failure
-                            failed++;
-                            failures++;
-                            shardResponses.put(shardRouting, new SyncedFlushService.ShardSyncedFlushResponse("copy failure " + shardId));
-                            // Building the shardRouting map here.
-                            XContentBuilder builder = XContentBuilder.builder(xContentType.xContent());
-                            Map<String, Object> routing =
-                                shardRouting.toXContent(builder, ToXContent.EMPTY_PARAMS)
-                                    .generator()
-                                    .contentType()
-                                    .xContent()
-                                    .createParser(
-                                        xContentRegistry(),
-                                        DeprecationHandler.THROW_UNSUPPORTED_OPERATION,
-                                        BytesReference.bytes(builder).streamInput()
-                                    )
-                                    .map();
-                            shardFailures.add(
-                                new SyncedFlushResponse.ShardFailure(
-                                    shardId.id(),
-                                    "copy failure " + shardId,
-                                    routing
-                                )
-                            );
-                        } else {
-                            successful++;
-                            shardResponses.put(shardRouting, new SyncedFlushService.ShardSyncedFlushResponse((String) null));
-                        }
-                    }
-                    shardsResults.add(new ShardsSyncedFlushResult(shardId, "_sync_id_" + shard, replicas + 1, shardResponses));
-                }
-            }
-            indicesResults.put(index, shardsResults);
-            indexResults.put(
-                index,
-                new SyncedFlushResponse.IndexResult(
-                    shards * (replicas + 1),
-                    successful,
-                    failed,
-                    shardFailures
-                )
-            );
-            testPlan.countsPerIndex.put(index, new SyncedFlushResponse.ShardCounts(shards * (replicas + 1), successful, failed));
-            testPlan.expectedFailuresPerIndex.put(index, failures);
-            totalFailed += failed;
-            totalShards += shards * (replicas + 1);
-            totalSuccessful += successful;
-        }
-        testPlan.result = new org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse(indicesResults);
-        testPlan.totalCounts = new SyncedFlushResponse.ShardCounts(totalShards, totalSuccessful, totalFailed);
-        testPlan.clientResult = new SyncedFlushResponse(
-            new SyncedFlushResponse.ShardCounts(totalShards, totalSuccessful, totalFailed),
-            indexResults
-        );
-        return testPlan;
-    }
-
-    public boolean containsFailure(List<SyncedFlushResponse.ShardFailure> failures, SyncedFlushResponse.ShardFailure origFailure) {
-        for (SyncedFlushResponse.ShardFailure failure: failures) {
-            if (failure.getShardId() == origFailure.getShardId() &&
-                failure.getFailureReason().equals(origFailure.getFailureReason()) &&
-                failure.getRouting().equals(origFailure.getRouting())) {
-                return true;
-            }
-        }
-        return false;
-    }
-
-
-    public void assertShardCounts(SyncedFlushResponse.ShardCounts first, SyncedFlushResponse.ShardCounts second) {
-        if (first == null) {
-            assertNull(second);
-        } else {
-            assertTrue(first.equals(second));
-        }
-    }
-
-    public Map<String, Object> convertFailureListToSet(Map<String, Object> input) {
-        Map<String, Object> retMap = new HashMap<>();
-        for (Map.Entry<String, Object> entry: input.entrySet()) {
-            if (entry.getKey().equals(SyncedFlushResponse.SHARDS_FIELD)) {
-                retMap.put(entry.getKey(), entry.getValue());
-            } else {
-                // This was an index entry.
-                @SuppressWarnings("unchecked")
-                Map<String, Object> indexResult = (Map<String, Object>)entry.getValue();
-                Map<String, Object> retResult = new HashMap<>();
-                for (Map.Entry<String, Object> entry2: indexResult.entrySet()) {
-                    if (entry2.getKey().equals(SyncedFlushResponse.IndexResult.FAILURES_FIELD)) {
-                        @SuppressWarnings("unchecked")
-                        List<Object> failures = (List<Object>)entry2.getValue();
-                        Set<Object> retSet = new HashSet<>(failures);
-                        retResult.put(entry.getKey(), retSet);
-                    } else {
-                        retResult.put(entry2.getKey(), entry2.getValue());
-                    }
-                }
-                retMap.put(entry.getKey(), retResult);
-            }
-        }
-        return retMap;
-    }
-}
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/IndicesClientDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/IndicesClientDocumentationIT.java
index 02d426e4b6c6d..506a2b52e47b1 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/IndicesClientDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/IndicesClientDocumentationIT.java
@@ -31,7 +31,6 @@
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushResponse;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeResponse;
 import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
@@ -56,7 +55,6 @@
 import org.elasticsearch.client.GetAliasesResponse;
 import org.elasticsearch.client.RequestOptions;
 import org.elasticsearch.client.RestHighLevelClient;
-import org.elasticsearch.client.SyncedFlushResponse;
 import org.elasticsearch.client.core.BroadcastResponse.Shards;
 import org.elasticsearch.client.core.ShardsAcknowledgedResponse;
 import org.elasticsearch.client.indices.AnalyzeRequest;
@@ -998,94 +996,6 @@ public void onFailure(Exception e) {
         }
     }
 
-    @SuppressWarnings("unused")
-    public void testSyncedFlushIndex() throws Exception {
-        RestHighLevelClient client = highLevelClient();
-
-        {
-            createIndex("index1", Settings.EMPTY);
-        }
-
-        {
-            // tag::flush-synced-request
-            SyncedFlushRequest request = new SyncedFlushRequest("index1"); // <1>
-            SyncedFlushRequest requestMultiple = new SyncedFlushRequest("index1", "index2"); // <2>
-            SyncedFlushRequest requestAll = new SyncedFlushRequest(); // <3>
-            // end::flush-synced-request
-
-            // tag::flush-synced-request-indicesOptions
-            request.indicesOptions(IndicesOptions.lenientExpandOpen()); // <1>
-            // end::flush-synced-request-indicesOptions
-
-            // tag::flush-synced-execute
-            SyncedFlushResponse flushSyncedResponse = client.indices().flushSynced(request, expectWarnings(
-                "Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead."
-            ));
-            // end::flush-synced-execute
-
-            // tag::flush-synced-response
-            int totalShards = flushSyncedResponse.totalShards(); // <1>
-            int successfulShards = flushSyncedResponse.successfulShards(); // <2>
-            int failedShards = flushSyncedResponse.failedShards(); // <3>
-
-            for (Map.Entry<String, SyncedFlushResponse.IndexResult> responsePerIndexEntry:
-                flushSyncedResponse.getIndexResults().entrySet()) {
-                String indexName = responsePerIndexEntry.getKey(); // <4>
-                SyncedFlushResponse.IndexResult indexResult = responsePerIndexEntry.getValue();
-                int totalShardsForIndex = indexResult.totalShards(); // <5>
-                int successfulShardsForIndex = indexResult.successfulShards(); // <6>
-                int failedShardsForIndex = indexResult.failedShards(); // <7>
-                if (failedShardsForIndex > 0) {
-                    for (SyncedFlushResponse.ShardFailure failureEntry: indexResult.failures()) {
-                        int shardId = failureEntry.getShardId(); // <8>
-                        String failureReason = failureEntry.getFailureReason(); // <9>
-                        Map<String, Object> routing = failureEntry.getRouting(); // <10>
-                    }
-                }
-            }
-            // end::flush-synced-response
-
-            // tag::flush-synced-execute-listener
-            ActionListener<SyncedFlushResponse> listener = new ActionListener<SyncedFlushResponse>() {
-                @Override
-                public void onResponse(SyncedFlushResponse refreshResponse) {
-                    // <1>
-                }
-
-                @Override
-                public void onFailure(Exception e) {
-                    // <2>
-                }
-            };
-            // end::flush-synced-execute-listener
-
-            // Replace the empty listener by a blocking listener in test
-            final CountDownLatch latch = new CountDownLatch(1);
-            listener = new LatchedActionListener<>(listener, latch);
-
-            // tag::flush-synced-execute-async
-            client.indices().flushSyncedAsync(request, expectWarnings(
-                "Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead."
-            ), listener); // <1>
-            // end::flush-synced-execute-async
-
-            assertTrue(latch.await(30L, TimeUnit.SECONDS));
-        }
-
-        {
-            // tag::flush-synced-notfound
-            try {
-                SyncedFlushRequest request = new SyncedFlushRequest("does_not_exist");
-                client.indices().flushSynced(request, RequestOptions.DEFAULT);
-            } catch (ElasticsearchException exception) {
-                if (exception.status() == RestStatus.NOT_FOUND) {
-                    // <1>
-                }
-            }
-            // end::flush-synced-notfound
-        }
-    }
-
     public void testGetSettings() throws Exception {
         RestHighLevelClient client = highLevelClient();
 
diff --git a/docs/java-rest/high-level/indices/flush_synced.asciidoc b/docs/java-rest/high-level/indices/flush_synced.asciidoc
deleted file mode 100644
index e5dfa59153b09..0000000000000
--- a/docs/java-rest/high-level/indices/flush_synced.asciidoc
+++ /dev/null
@@ -1,62 +0,0 @@
---
-:api: flush-synced
-:request: SyncedFlushRequest
-:response: SyncedFlushResponse
---
-
-[id="{upid}-{api}"]
-=== Flush Synced API
-
-[id="{upid}-{api}-request"]
-==== Flush Synced Request
-
-A +{request}+ can be applied to one or more indices, or even on `_all` the indices:
-
-["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
-include-tagged::{doc-tests-file}[{api}-request]
---------------------------------------------------
-<1> Flush synced one index
-<2> Flush synced multiple indices
-<3> Flush synced all the indices
-
-==== Optional arguments
-
-["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
-include-tagged::{doc-tests-file}[{api}-request-indicesOptions]
---------------------------------------------------
-<1> Setting `IndicesOptions` controls how unavailable indices are resolved and
-how wildcard expressions are expanded
-
-include::../execution.asciidoc[]
-
-[id="{upid}-{api}-response"]
-==== Flush Synced Response
-
-The returned +{response}+ allows to retrieve information about the
-executed operation as follows:
-
-["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
-include-tagged::{doc-tests-file}[{api}-response]
---------------------------------------------------
-<1> Total number of shards hit by the flush request
-<2> Number of shards where the flush has succeeded
-<3> Number of shards where the flush has failed
-<4> Name of the index whose results we are about to calculate.
-<5> Total number of shards for index mentioned in 4.
-<6> Successful shards for index mentioned in 4.
-<7> Failed shards for index mentioned in 4.
-<8> One of the failed shard ids of the failed index mentioned in 4.
-<9> Reason for failure of copies of the shard mentioned in 8.
-<10> JSON represented by a Map<String, Object>. Contains shard related information like id, state, version etc.
-for the failed shard copies. If the entire shard failed then this returns an empty map.
-
-By default, if the indices were not found, an `ElasticsearchException` will be thrown:
-
-["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
-include-tagged::{doc-tests-file}[{api}-notfound]
---------------------------------------------------
-<1> Do something if the indices to be flushed were not found
diff --git a/docs/java-rest/high-level/supported-apis.asciidoc b/docs/java-rest/high-level/supported-apis.asciidoc
index 4b848819702b4..3e2ed5ce6cb38 100644
--- a/docs/java-rest/high-level/supported-apis.asciidoc
+++ b/docs/java-rest/high-level/supported-apis.asciidoc
@@ -102,7 +102,6 @@ Index Management::
 * <<{upid}-clone-index>>
 * <<{upid}-refresh>>
 * <<{upid}-flush>>
-* <<{upid}-flush-synced>>
 * <<{upid}-clear-cache>>
 * <<{upid}-force-merge>>
 * <<{upid}-rollover-index>>
@@ -138,7 +137,6 @@ include::indices/split_index.asciidoc[]
 include::indices/clone_index.asciidoc[]
 include::indices/refresh.asciidoc[]
 include::indices/flush.asciidoc[]
-include::indices/flush_synced.asciidoc[]
 include::indices/clear_cache.asciidoc[]
 include::indices/force_merge.asciidoc[]
 include::indices/rollover.asciidoc[]
diff --git a/docs/reference/index-modules/allocation/delayed.asciidoc b/docs/reference/index-modules/allocation/delayed.asciidoc
index f49ed7e05dbcd..5dee9444668ca 100644
--- a/docs/reference/index-modules/allocation/delayed.asciidoc
+++ b/docs/reference/index-modules/allocation/delayed.asciidoc
@@ -28,7 +28,7 @@ this scenario:
 If the master had just waited for a few minutes, then the missing shards could
 have been re-allocated to Node 5 with the minimum of network traffic.  This
 process would be even quicker for idle shards (shards not receiving indexing
-requests) which have been automatically <<indices-synced-flush-api,sync-flushed>>.
+requests) which have been automatically <<indices-flush, flushed>>.
 
 The allocation of replica shards which become unassigned because a node has
 left can be delayed with the `index.unassigned.node_left.delayed_timeout`
diff --git a/docs/reference/indices.asciidoc b/docs/reference/indices.asciidoc
index e1bec04eabc03..224346f3f5dfa 100644
--- a/docs/reference/indices.asciidoc
+++ b/docs/reference/indices.asciidoc
@@ -68,7 +68,6 @@ index settings, aliases, mappings, and index templates.
 * <<indices-clearcache>>
 * <<indices-refresh>>
 * <<indices-flush>>
-* <<indices-synced-flush-api>>
 * <<indices-forcemerge>>
 
 
@@ -136,10 +135,8 @@ include::indices/shrink-index.asciidoc[]
 
 include::indices/split-index.asciidoc[]
 
-include::indices/synced-flush.asciidoc[]
-
 include::indices/apis/unfreeze.asciidoc[]
 
 include::indices/aliases.asciidoc[]
 
-include::indices/update-settings.asciidoc[]
\ No newline at end of file
+include::indices/update-settings.asciidoc[]
diff --git a/docs/reference/indices/synced-flush.asciidoc b/docs/reference/indices/synced-flush.asciidoc
index 8e3a85aceca33..4d0ab4ff98c2a 100644
--- a/docs/reference/indices/synced-flush.asciidoc
+++ b/docs/reference/indices/synced-flush.asciidoc
@@ -4,278 +4,4 @@
 <titleabbrev>Synced flush</titleabbrev>
 ++++
 
-deprecated::[7.6, synced-flush is deprecated and will be removed in 8.0.
-Use <<indices-flush,flush>> instead. A <<indices-flush,flush>> has the
-same effect as a synced flush on Elasticsearch 7.6 or later]
-
-Performs a synced flush on one or more indices.
-
-[source,console]
---------------------------------------------------
-POST /twitter/_flush/synced
---------------------------------------------------
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
-
-
-[[synced-flush-api-request]]
-==== {api-request-title}
-
-`POST /<index>/flush/synced`
-
-`GET /<index>/flush/synced`
-
-`POST /flush/synced`
-
-`GET /flush/synced`
-
-
-[[synced-flush-api-desc]]
-==== {api-description-title}
-
-[[synced-flush-using-api]]
-===== Use the synced flush API
-
-Use the synced flush API to manually initiate a synced flush.
-This can be useful for a planned cluster restart where
-you can stop indexing but don't want to wait for 5 minutes until all indices
-are marked as inactive and automatically sync-flushed.
-
-You can request a synced flush even if there is ongoing indexing activity, and
-{es} will perform the synced flush on a "best-effort" basis: shards that do not
-have any ongoing indexing activity will be successfully sync-flushed, and other
-shards will fail to sync-flush. The successfully sync-flushed shards will have
-faster recovery times as long as the `sync_id` marker is not removed by a
-subsequent flush.
-
-
-[[synced-flush-overview]]
-===== Synced flush overview
-
-{es} keeps track of which shards have received indexing activity recently, and
-considers shards that have not received any indexing operations for 5 minutes to
-be inactive.
-
-When a shard becomes inactive {es} performs a special kind of flush
-known as a *synced flush*. A synced flush performs a normal
-<<indices-flush,flush>> on each replica of the shard, and then adds a marker known
-as the `sync_id` to each replica to indicate that these copies have identical
-Lucene indices. Comparing the `sync_id` markers of the two copies is a very
-efficient way to check whether they have identical contents.
-
-When allocating shard replicas, {es} must ensure that each replica contains the
-same data as the primary. If the shard copies have been synced-flushed and the
-replica shares a `sync_id` with the primary then {es} knows that the two copies
-have identical contents. This means there is no need to copy any segment files
-from the primary to the replica, which saves a good deal of time during
-recoveries and restarts.
-
-This is particularly useful for clusters having lots of indices which are very
-rarely updated, such as with time-based indices. Without the synced flush
-marker, recovery of this kind of cluster would be much slower.
-
-
-[[synced-flush-sync-id-markers]]
-===== Check for `sync_id` markers
-
-To check whether a shard has a `sync_id` marker or not, look for the `commit`
-section of the shard stats returned by the <<indices-stats,indices stats>> API:
-
-[source,console]
---------------------------------------------------
-GET /twitter/_stats?filter_path=**.commit&level=shards <1>
---------------------------------------------------
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
-
-<1> `filter_path` is used to reduce the verbosity of the response, but is entirely optional
-
-The API returns the following response:
-
-[source,console-result]
---------------------------------------------------
-{
-   "indices": {
-      "twitter": {
-         "shards": {
-            "0": [
-               {
-                 "commit" : {
-                   "id" : "3M3zkw2GHMo2Y4h4/KFKCg==",
-                   "generation" : 3,
-                   "user_data" : {
-                     "translog_uuid" : "hnOG3xFcTDeoI_kvvvOdNA",
-                     "history_uuid" : "XP7KDJGiS1a2fHYiFL5TXQ",
-                     "local_checkpoint" : "-1",
-                     "translog_generation" : "2",
-                     "max_seq_no" : "-1",
-                     "sync_id" : "AVvFY-071siAOuFGEO9P", <1>
-                     "max_unsafe_auto_id_timestamp" : "-1",
-                     "min_retained_seq_no" : "0"
-                   },
-                   "num_docs" : 0
-                 }
-               }
-            ]
-         }
-      }
-   }
-}
---------------------------------------------------
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
-<1> the `sync id` marker
-
-NOTE: The `sync_id` marker is removed as soon as the shard is flushed again, and
-{es} may trigger an automatic flush of a shard at any time if there are
-unflushed operations in the shard's translog. In practice this means that one
-should consider any indexing operation on an index as having removed its
-`sync_id` markers.
-
-
-[[synced-flush-api-path-params]]
-==== {api-path-parms-title}
-
-include::{docdir}/rest-api/common-parms.asciidoc[tag=index]
-+
-To sync-flush all indices,
-omit this parameter
-or use a value of `_all` or `*`.
-
-
-[[synced-flush-api-query-params]]
-==== {api-query-parms-title}
-
-include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-indices]
-
-include::{docdir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
-+
-Defaults to `open`.
-
-include::{docdir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
-
-
-[[synced-flush-api-response-codes]]
-==== {api-response-codes-title}
-
-`200`::
-All shards successfully sync-flushed.
-
-`409`::
-A replica shard failed to sync-flush.
-
-
-[[synced-flush-api-example]]
-==== {api-examples-title}
-
-
-[[synced-flush-api-specific-ex]]
-===== Sync-flush a specific index
-
-[source,console]
-----
-POST /kimchy/_flush/synced
-----
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
-
-
-[[synced-flush-api-multi-ex]]
-===== Synch-flush several indices
-
-[source,console]
---------------------------------------------------
-POST /kimchy,elasticsearch/_flush/synced
---------------------------------------------------
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
-
-
-[[synced-flush-api-all-ex]]
-===== Sync-flush all indices
-
-[source,console]
---------------------------------------------------
-POST /_flush/synced
---------------------------------------------------
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
-
-The response contains details about how many shards were successfully
-sync-flushed and information about any failure.
-
-The following response indicates two shards
-and one replica shard
-successfully sync-flushed:
-
-[source,console-result]
---------------------------------------------------
-{
-   "_shards": {
-      "total": 2,
-      "successful": 2,
-      "failed": 0
-   },
-   "twitter": {
-      "total": 2,
-      "successful": 2,
-      "failed": 0
-   }
-}
---------------------------------------------------
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
-
-The following response indicates one shard group failed
-due to pending operations:
-
-[source,console-result]
---------------------------------------------------
-{
-   "_shards": {
-      "total": 4,
-      "successful": 2,
-      "failed": 2
-   },
-   "twitter": {
-      "total": 4,
-      "successful": 2,
-      "failed": 2,
-      "failures": [
-         {
-            "shard": 1,
-            "reason": "[2] ongoing operations on primary"
-         }
-      ]
-   }
-}
---------------------------------------------------
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
-
-Sometimes the failures are specific to a shard replica. The copies that failed
-will not be eligible for fast recovery but those that succeeded still will be.
-This case is reported as follows:
-
-[source,console-result]
---------------------------------------------------
-{
-   "_shards": {
-      "total": 4,
-      "successful": 1,
-      "failed": 1
-   },
-   "twitter": {
-      "total": 4,
-      "successful": 3,
-      "failed": 1,
-      "failures": [
-         {
-            "shard": 1,
-            "reason": "unexpected error",
-            "routing": {
-               "state": "STARTED",
-               "primary": false,
-               "node": "SZNr2J_ORxKTLUCydGX4zA",
-               "relocating_node": null,
-               "shard": 1,
-               "index": "twitter"
-            }
-         }
-      ]
-   }
-}
---------------------------------------------------
-// TEST[skip: Synced flush can conflict with scheduled flushes in doc tests]
+Synced flush was removed. Use normal <<indices-flush,flush>> instead.
diff --git a/docs/reference/migration/migrate_8_0/indices.asciidoc b/docs/reference/migration/migrate_8_0/indices.asciidoc
index 5b1d5a10df090..ef5cd25f81808 100644
--- a/docs/reference/migration/migrate_8_0/indices.asciidoc
+++ b/docs/reference/migration/migrate_8_0/indices.asciidoc
@@ -27,3 +27,10 @@ and the setting is removed.
 In 6.0, we deprecated the `template` field in put index template requests
 in favor of using `index_patterns`. Support for the `template` field is now
 removed in 8.0.
+
+
+[float]
+==== Remove synced flush
+
+Synced flush was deprecated in 7.6 and is removed in 8.0. Use a regular flush
+instead as it has the same effect as a synced flush in 7.6 and later.
diff --git a/docs/reference/modules/threadpool.asciidoc b/docs/reference/modules/threadpool.asciidoc
index c69f736feb17c..5a5c5c5e0b748 100644
--- a/docs/reference/modules/threadpool.asciidoc
+++ b/docs/reference/modules/threadpool.asciidoc
@@ -20,8 +20,8 @@ There are several thread pools, but the important ones include:
     `1000`.
 
 [[search-throttled]]`search_throttled`::
-    For count/search/suggest/get operations on `search_throttled indices`. 
-    Thread pool type is `fixed_auto_queue_size` with a size of `1`, and initial 
+    For count/search/suggest/get operations on `search_throttled indices`.
+    Thread pool type is `fixed_auto_queue_size` with a size of `1`, and initial
     queue_size of `100`.
 
 `get`::
@@ -30,7 +30,7 @@ There are several thread pools, but the important ones include:
     queue_size of `1000`.
 
 `analyze`::
-    For analyze requests. Thread pool type is `fixed` with a size of `1`, queue 
+    For analyze requests. Thread pool type is `fixed` with a size of `1`, queue
     size of `16`.
 
 `write`::
@@ -51,8 +51,8 @@ There are several thread pools, but the important ones include:
     keep-alive of `5m` and a max of `min(10, (# of available processors)/2)`.
 
 `listener`::
-    Mainly for java client executing of action when listener threaded is set to 
-    `true`. Thread pool type is `scaling` with a default max of 
+    Mainly for java client executing of action when listener threaded is set to
+    `true`. Thread pool type is `scaling` with a default max of
     `min(10, (# of available processors)/2)`.
 
 `fetch_shard_started`::
@@ -66,7 +66,7 @@ There are several thread pools, but the important ones include:
     size of `2 * # of available processors`.
 
 `flush`::
-    For <<indices-flush,flush>>, <<indices-synced-flush-api,synced flush>>, and <<index-modules-translog, translog>> `fsync` operations.
+    For <<indices-flush,flush>> and <<index-modules-translog, translog>> `fsync` operations.
     Thread pool type is `scaling` with a keep-alive of `5m` and a default
     maximum size of `min(5, (# of available processors)/2)`.
 
@@ -202,13 +202,13 @@ processors: 2
 There are a few use-cases for explicitly overriding the `processors`
 setting:
 
-. If you are running multiple instances of {es} on the same host but want {es} 
-to size its thread pools as if it only has a fraction of the CPU, you should 
-override the `processors` setting to the desired fraction, for example, if 
+. If you are running multiple instances of {es} on the same host but want {es}
+to size its thread pools as if it only has a fraction of the CPU, you should
+override the `processors` setting to the desired fraction, for example, if
 you're running two instances of {es} on a 16-core machine, set `processors` to 8.
-Note that this is an expert-level use case and there's a lot more involved 
-than just setting the `processors` setting as there are other considerations 
-like changing the number of garbage collector threads, pinning processes to 
+Note that this is an expert-level use case and there's a lot more involved
+than just setting the `processors` setting as there are other considerations
+like changing the number of garbage collector threads, pinning processes to
 cores, and so on.
 . Sometimes the number of processors is wrongly detected and in such
 cases explicitly setting the `processors` setting will workaround such
diff --git a/docs/reference/setup/restart-cluster.asciidoc b/docs/reference/setup/restart-cluster.asciidoc
index 58402758a72d8..6b3151f752cf9 100644
--- a/docs/reference/setup/restart-cluster.asciidoc
+++ b/docs/reference/setup/restart-cluster.asciidoc
@@ -1,11 +1,11 @@
 [[restart-cluster]]
 == Full-cluster restart and rolling restart
- 
-There may be {ref}/configuring-tls.html#tls-transport[situations where you want 
-to perform a full-cluster restart] or a rolling restart. In the case of 
-<<restart-cluster-full,full-cluster restart>>, you shut down and restart all the 
-nodes in the cluster while in the case of 
-<<restart-cluster-rolling,rolling restart>>, you shut down only one node at a 
+
+There may be {ref}/configuring-tls.html#tls-transport[situations where you want
+to perform a full-cluster restart] or a rolling restart. In the case of
+<<restart-cluster-full,full-cluster restart>>, you shut down and restart all the
+nodes in the cluster while in the case of
+<<restart-cluster-rolling,rolling restart>>, you shut down only one node at a
 time, so the service remains uninterrupted.
 
 
@@ -21,27 +21,29 @@ include::{docdir}/upgrade/disable-shard-alloc.asciidoc[]
 --
 // end::disable_shard_alloc[]
 // tag::stop_indexing[]
-. *Stop indexing and perform a synced flush.*
+. *Stop indexing and perform a flush.*
 +
 --
-Performing a <<indices-synced-flush-api, synced-flush>> speeds up shard
-recovery.
+Performing a <<indices-flush, flush>> speeds up shard recovery.
 
-include::{docdir}/upgrade/synced-flush.asciidoc[]
+[source,console]
+--------------------------------------------------
+POST /_flush
+--------------------------------------------------
 --
 // end::stop_indexing[]
 //tag::stop_ml[]
 . *Temporarily stop the tasks associated with active {ml} jobs and {dfeeds}.* (Optional)
 +
 --
-{ml-cap} features require a platinum license or higher. For more information about Elastic 
+{ml-cap} features require a platinum license or higher. For more information about Elastic
 license levels, see https://www.elastic.co/subscriptions[the subscription page].
 
-You have two options to handle {ml} jobs and {dfeeds} when you shut down a 
+You have two options to handle {ml} jobs and {dfeeds} when you shut down a
 cluster:
 
 * Temporarily halt the tasks associated with your {ml} jobs and {dfeeds} and
-prevent new jobs from opening by using the 
+prevent new jobs from opening by using the
 <<ml-set-upgrade-mode,set upgrade mode API>>:
 +
 [source,console]
@@ -50,15 +52,15 @@ POST _ml/set_upgrade_mode?enabled=true
 --------------------------------------------------
 // TEST
 +
-When you disable upgrade mode, the jobs resume using the last model state that 
-was automatically saved. This option avoids the overhead of managing active jobs 
-during the shutdown and is faster than explicitly stopping {dfeeds} and closing 
+When you disable upgrade mode, the jobs resume using the last model state that
+was automatically saved. This option avoids the overhead of managing active jobs
+during the shutdown and is faster than explicitly stopping {dfeeds} and closing
 jobs.
 
 * {ml-docs}/stopping-ml.html[Stop all {dfeeds} and close all jobs]. This option
 saves the model state at the time of closure. When you reopen the jobs after the
-cluster restart, they use the exact same model. However, saving the latest model 
-state takes longer than using upgrade mode, especially if you have a lot of jobs 
+cluster restart, they use the exact same model. However, saving the latest model
+state takes longer than using upgrade mode, especially if you have a lot of jobs
 or jobs with large model states.
 --
 // end::stop_ml[]
@@ -102,8 +104,8 @@ When a node joins the cluster, it begins to recover any primary shards that
 are stored locally. The <<cat-health,`_cat/health`>> API initially reports
 a `status` of `red`, indicating that not all primary shards have been allocated.
 
-Once a node recovers its local shards, the cluster `status` switches to 
-`yellow`, indicating that all primary shards have been recovered, but not all 
+Once a node recovers its local shards, the cluster `status` switches to
+`yellow`, indicating that all primary shards have been recovered, but not all
 replica shards are allocated. This is to be expected because you have not yet
 re-enabled allocation. Delaying the allocation of replicas until all nodes
 are `yellow` allows the master to allocate replicas to nodes that
@@ -149,7 +151,7 @@ GET _cat/recovery
 . *Restart machine learning jobs.* (Optional)
 +
 --
-If you temporarily halted the tasks associated with your {ml} jobs, use the 
+If you temporarily halted the tasks associated with your {ml} jobs, use the
 <<ml-set-upgrade-mode,set upgrade mode API>> to return them to active states:
 
 [source,console]
@@ -158,7 +160,7 @@ POST _ml/set_upgrade_mode?enabled=false
 --------------------------------------------------
 // TEST[continued]
 
-If you closed all {ml} jobs before stopping the nodes, open the jobs and start 
+If you closed all {ml} jobs before stopping the nodes, open the jobs and start
 the datafeeds from {kib} or with the <<ml-open-job,open jobs>> and
 <<ml-start-datafeed,start datafeed>> APIs.
 --
@@ -177,10 +179,10 @@ include::{docdir}/setup/restart-cluster.asciidoc[tag=stop_indexing]
 include::{docdir}/setup/restart-cluster.asciidoc[tag=stop_ml]
 +
 --
-* If you perform a rolling restart, you can also leave your machine learning 
-jobs running. When you shut down a machine learning node, its jobs automatically 
-move to another node and restore the model states. This option enables your jobs 
-to continue running during the shutdown but it puts increased load on the 
+* If you perform a rolling restart, you can also leave your machine learning
+jobs running. When you shut down a machine learning node, its jobs automatically
+move to another node and restore the model states. This option enables your jobs
+to continue running during the shutdown but it puts increased load on the
 cluster.
 --
 
@@ -191,11 +193,11 @@ include::{docdir}/upgrade/shut-down-node.asciidoc[]
 --
 
 . *Perform any needed changes.*
- 
+
 . *Restart the node you changed.*
 +
 --
-Start the node and confirm that it joins the cluster by checking the log file or 
+Start the node and confirm that it joins the cluster by checking the log file or
 by submitting a `_cat/nodes` request:
 
 [source,console]
@@ -208,8 +210,8 @@ GET _cat/nodes
 . *Reenable shard allocation.*
 +
 --
-Once the node has joined the cluster, remove the 
-`cluster.routing.allocation.enable` setting to enable shard allocation and start 
+Once the node has joined the cluster, remove the
+`cluster.routing.allocation.enable` setting to enable shard allocation and start
 using the node:
 
 [source,console]
diff --git a/docs/reference/upgrade/cluster_restart.asciidoc b/docs/reference/upgrade/cluster_restart.asciidoc
index 5d967929dc18d..3066d44c71010 100644
--- a/docs/reference/upgrade/cluster_restart.asciidoc
+++ b/docs/reference/upgrade/cluster_restart.asciidoc
@@ -22,13 +22,15 @@ To perform a full cluster restart upgrade to {version}:
 include::disable-shard-alloc.asciidoc[]
 --
 
-. *Stop indexing and perform a synced flush.*
+. *Stop indexing and perform a flush.*
 +
 --
-Performing a <<indices-synced-flush-api, synced-flush>> speeds up shard
-recovery.
+Performing a <<indices-flush, flush>> speeds up shard recovery.
 
-include::synced-flush.asciidoc[]
+[source,console]
+--------------------------------------------------
+POST /_flush
+--------------------------------------------------
 --
 
 . *Temporarily stop the tasks associated with active {ml} jobs and {dfeeds}.* (Optional)
@@ -71,7 +73,7 @@ a node.
 . If you use {es} {security-features} to define realms, verify that your realm
 settings are up-to-date. The format of realm settings changed in version 7.0, in
 particular, the placement of the realm type changed. See
-<<realm-settings,Realm settings>>. 
+<<realm-settings,Realm settings>>.
 
 . *Start each upgraded node.*
 +
diff --git a/docs/reference/upgrade/synced-flush.asciidoc b/docs/reference/upgrade/synced-flush.asciidoc
deleted file mode 100644
index a67c171f99875..0000000000000
--- a/docs/reference/upgrade/synced-flush.asciidoc
+++ /dev/null
@@ -1,14 +0,0 @@
-
-[source,console]
---------------------------------------------------
-POST _flush/synced
---------------------------------------------------
-// TEST[skip: will fail as synced flush is deprecated]
-
-When you perform a synced flush, check the response to make sure there are
-no failures. Synced flush operations that fail due to pending indexing
-operations are listed in the response body, although the request itself
-still returns a 200 OK status. If there are failures, reissue the request.
-
-Note that synced flush is deprecated and will be removed in 8.0. A flush
-has the same effect as a synced flush on Elasticsearch 7.6 or later.
diff --git a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
index 9c7d7af4ca6c8..427383d7d8292 100644
--- a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
+++ b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.Version;
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.Response;
-import org.elasticsearch.client.ResponseException;
 import org.elasticsearch.client.RestClient;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaDataIndexStateService;
@@ -679,16 +678,10 @@ public void testRecovery() throws Exception {
             flushRequest.addParameter("force", "true");
             flushRequest.addParameter("wait_if_ongoing", "true");
             assertOK(client().performRequest(flushRequest));
-
             if (randomBoolean()) {
-                // We had a bug before where we failed to perform peer recovery with sync_id from 5.x to 6.x.
-                // We added this synced flush so we can exercise different paths of recovery code.
-                try {
-                    performSyncedFlush(index);
-                } catch (ResponseException ignored) {
-                    // synced flush is optional here
-                }
+                syncedFlush(index);
             }
+
             if (shouldHaveTranslog) {
                 // Update a few documents so we are sure to have a translog
                 indexRandomDocuments(
diff --git a/qa/mixed-cluster/src/test/java/org/elasticsearch/backwards/IndexingIT.java b/qa/mixed-cluster/src/test/java/org/elasticsearch/backwards/IndexingIT.java
index 3acefce8e4e8b..d951c4d0c56eb 100644
--- a/qa/mixed-cluster/src/test/java/org/elasticsearch/backwards/IndexingIT.java
+++ b/qa/mixed-cluster/src/test/java/org/elasticsearch/backwards/IndexingIT.java
@@ -21,13 +21,17 @@
 import org.apache.http.HttpHost;
 import org.elasticsearch.Version;
 import org.elasticsearch.client.Request;
+import org.elasticsearch.client.RequestOptions;
 import org.elasticsearch.client.Response;
+import org.elasticsearch.client.ResponseException;
 import org.elasticsearch.client.RestClient;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.common.xcontent.support.XContentMapValues;
 import org.elasticsearch.index.seqno.SeqNoStats;
+import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.test.rest.ESRestTestCase;
 import org.elasticsearch.test.rest.yaml.ObjectPath;
 
@@ -38,6 +42,7 @@
 import java.util.Map;
 import java.util.stream.Collectors;
 
+import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.equalTo;
 
 public class IndexingIT extends ESRestTestCase {
@@ -274,6 +279,57 @@ public void testUpdateSnapshotStatus() throws Exception {
         request.setJsonEntity("{\"indices\": \"" + index + "\"}");
     }
 
+    public void testSyncedFlushTransition() throws Exception {
+        Nodes nodes = buildNodeAndVersions();
+        assertTrue("bwc version is on 7.x", nodes.getBWCVersion().before(Version.V_8_0_0));
+        assumeFalse("no new node found", nodes.getNewNodes().isEmpty());
+        assumeFalse("no bwc node found", nodes.getBWCNodes().isEmpty());
+        // Allocate shards to new nodes then verify synced flush requests processed by old nodes/new nodes
+        String newNodes = nodes.getNewNodes().stream().map(Node::getNodeName).collect(Collectors.joining(","));
+        int numShards = randomIntBetween(1, 10);
+        int numOfReplicas = randomIntBetween(0, nodes.getNewNodes().size() - 1);
+        int totalShards = numShards * (numOfReplicas + 1);
+        final String index = "test_synced_flush";
+        createIndex(index, Settings.builder()
+            .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), numShards)
+            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, numOfReplicas)
+            .put("index.routing.allocation.include._name", newNodes).build());
+        ensureGreen(index);
+        indexDocs(index, randomIntBetween(0, 100), between(1, 100));
+        try (RestClient oldNodeClient = buildClient(restClientSettings(),
+            nodes.getBWCNodes().stream().map(Node::getPublishAddress).toArray(HttpHost[]::new))) {
+            Request request = new Request("POST", index + "/_flush/synced");
+            assertBusy(() -> {
+                ResponseException responseException = expectThrows(ResponseException.class, () -> oldNodeClient.performRequest(request));
+                assertThat(responseException.getResponse().getStatusLine().getStatusCode(), equalTo(RestStatus.CONFLICT.getStatus()));
+                assertThat(responseException.getResponse().getWarnings(),
+                    contains("Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead."));
+                Map<String, Object> result = ObjectPath.createFromResponse(responseException.getResponse()).evaluate("_shards");
+                assertThat(result.get("total"), equalTo(totalShards));
+                assertThat(result.get("successful"), equalTo(0));
+                assertThat(result.get("failed"), equalTo(totalShards));
+            });
+            Map<String, Object> stats = entityAsMap(client().performRequest(new Request("GET", index + "/_stats?level=shards")));
+            assertThat(XContentMapValues.extractValue("indices." + index + ".total.translog.uncommitted_operations", stats), equalTo(0));
+        }
+        indexDocs(index, randomIntBetween(0, 100), between(1, 100));
+        try (RestClient newNodeClient = buildClient(restClientSettings(),
+            nodes.getNewNodes().stream().map(Node::getPublishAddress).toArray(HttpHost[]::new))) {
+            Request request = new Request("POST", index + "/_flush/synced");
+            List<String> warningMsg = List.of("Synced flush was removed and a normal flush was performed instead. " +
+                "This transition will be removed in a future version.");
+            request.setOptions(RequestOptions.DEFAULT.toBuilder().setWarningsHandler(warnings -> warnings.equals(warningMsg) == false));
+            assertBusy(() -> {
+                Map<String, Object> result = ObjectPath.createFromResponse(newNodeClient.performRequest(request)).evaluate("_shards");
+                assertThat(result.get("total"), equalTo(totalShards));
+                assertThat(result.get("successful"), equalTo(totalShards));
+                assertThat(result.get("failed"), equalTo(0));
+            });
+            Map<String, Object> stats = entityAsMap(client().performRequest(new Request("GET", index + "/_stats?level=shards")));
+            assertThat(XContentMapValues.extractValue("indices." + index + ".total.translog.uncommitted_operations", stats), equalTo(0));
+        }
+    }
+
     private void assertCount(final String index, final String preference, final int expectedCount) throws IOException {
         Request request = new Request("GET", index + "/_count");
         request.addParameter("preference", preference);
diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index f29bfddde0420..d0892fd914f57 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -44,7 +44,6 @@
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
-import java.util.Objects;
 import java.util.concurrent.Future;
 import java.util.concurrent.TimeUnit;
 import java.util.function.Predicate;
@@ -283,7 +282,7 @@ public void testRelocationWithConcurrentIndexing() throws Exception {
     }
 
     public void testRecovery() throws Exception {
-        final String index = "recover_with_soft_deletes";
+        final String index = "test_recovery";
         if (CLUSTER_TYPE == ClusterType.OLD) {
             Settings.Builder settings = Settings.builder()
                 .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
@@ -315,6 +314,9 @@ public void testRecovery() throws Exception {
                 }
             }
         }
+        if (randomBoolean()) {
+            syncedFlush(index);
+        }
         ensureGreen(index);
     }
 
@@ -557,40 +559,6 @@ private void assertClosedIndex(final String index, final boolean checkRoutingTab
         }
     }
 
-    private void syncedFlush(String index) throws Exception {
-        // We have to spin synced-flush requests here because we fire the global checkpoint sync for the last write operation.
-        // A synced-flush request considers the global checkpoint sync as an going operation because it acquires a shard permit.
-        assertBusy(() -> {
-            try {
-                Response resp = performSyncedFlush(index);
-                Map<String, Object> result = ObjectPath.createFromResponse(resp).evaluate("_shards");
-                assertThat(result.get("failed"), equalTo(0));
-            } catch (ResponseException ex) {
-                throw new AssertionError(ex); // cause assert busy to retry
-            }
-        });
-        // ensure the global checkpoint is synced; otherwise we might trim the commit with syncId
-        ensureGlobalCheckpointSynced(index);
-    }
-
-    @SuppressWarnings("unchecked")
-    private void ensureGlobalCheckpointSynced(String index) throws Exception {
-        assertBusy(() -> {
-            Map<?, ?> stats = entityAsMap(client().performRequest(new Request("GET", index + "/_stats?level=shards")));
-            List<Map<?, ?>> shardStats = (List<Map<?, ?>>) XContentMapValues.extractValue("indices." + index + ".shards.0", stats);
-            shardStats.stream()
-                .map(shard -> (Map<?, ?>) XContentMapValues.extractValue("seq_no", shard))
-                .filter(Objects::nonNull)
-                .forEach(seqNoStat -> {
-                    long globalCheckpoint = ((Number) XContentMapValues.extractValue("global_checkpoint", seqNoStat)).longValue();
-                    long localCheckpoint = ((Number) XContentMapValues.extractValue("local_checkpoint", seqNoStat)).longValue();
-                    long maxSeqNo = ((Number) XContentMapValues.extractValue("max_seq_no", seqNoStat)).longValue();
-                    assertThat(shardStats.toString(), localCheckpoint, equalTo(maxSeqNo));
-                    assertThat(shardStats.toString(), globalCheckpoint, equalTo(maxSeqNo));
-                });
-        }, 60, TimeUnit.SECONDS);
-    }
-
     /** Ensure that we can always execute update requests regardless of the version of cluster */
     public void testUpdateDoc() throws Exception {
         final String index = "test_update_doc";
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
deleted file mode 100644
index a7b4541c9623a..0000000000000
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
+++ /dev/null
@@ -1,54 +0,0 @@
-{
-  "indices.flush_synced":{
-    "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-synced-flush-api.html",
-      "description":"Performs a synced flush operation on one or more indices. Synced flush is deprecated and will be removed in 8.0. Use flush instead"
-    },
-    "stability":"stable",
-    "url":{
-      "paths":[
-        {
-          "path":"/_flush/synced",
-          "methods":[
-            "POST",
-            "GET"
-          ]
-        },
-        {
-          "path":"/{index}/_flush/synced",
-          "methods":[
-            "POST",
-            "GET"
-          ],
-          "parts":{
-            "index":{
-              "type":"list",
-              "description":"A comma-separated list of index names; use `_all` or empty string for all indices"
-            }
-          }
-        }
-      ]
-    },
-    "params":{
-      "ignore_unavailable":{
-        "type":"boolean",
-        "description":"Whether specified concrete indices should be ignored when unavailable (missing or closed)"
-      },
-      "allow_no_indices":{
-        "type":"boolean",
-        "description":"Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)"
-      },
-      "expand_wildcards":{
-        "type":"enum",
-        "options":[
-          "open",
-          "closed",
-          "none",
-          "all"
-        ],
-        "default":"open",
-        "description":"Whether to expand wildcard expression to concrete indices that are open, closed or both."
-      }
-    }
-  }
-}
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.flush/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.flush/10_basic.yml
index e3681c834dbad..89b8236225c0a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.flush/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.flush/10_basic.yml
@@ -1,33 +1,3 @@
----
-"Index synced flush rest test":
-  - skip:
-      version: " - 7.5.99"
-      reason: "synced flush is deprecated in 7.6"
-      features: "warnings"
-  - do:
-      indices.create:
-        index: testing
-        body:
-          settings:
-            index:
-              number_of_replicas: 0
-
-  - do:
-      cluster.health:
-        wait_for_status: green
-  - do:
-      warnings:
-        - Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead.
-      indices.flush_synced:
-        index: testing
-
-  - is_false: _shards.failed
-
-  - do:
-      indices.stats: {level: shards}
-
-  - is_true: indices.testing.shards.0.0.commit.user_data.sync_id
-
 ---
 "Flush stats":
 
diff --git a/server/src/main/java/org/elasticsearch/action/ActionModule.java b/server/src/main/java/org/elasticsearch/action/ActionModule.java
index 3d60a1fb698d2..1ef3c1418adba 100644
--- a/server/src/main/java/org/elasticsearch/action/ActionModule.java
+++ b/server/src/main/java/org/elasticsearch/action/ActionModule.java
@@ -107,10 +107,8 @@
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexAction;
 import org.elasticsearch.action.admin.indices.delete.TransportDeleteIndexAction;
 import org.elasticsearch.action.admin.indices.flush.FlushAction;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushAction;
 import org.elasticsearch.action.admin.indices.flush.TransportFlushAction;
 import org.elasticsearch.action.admin.indices.flush.TransportShardFlushAction;
-import org.elasticsearch.action.admin.indices.flush.TransportSyncedFlushAction;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeAction;
 import org.elasticsearch.action.admin.indices.forcemerge.TransportForceMergeAction;
 import org.elasticsearch.action.admin.indices.get.GetIndexAction;
@@ -492,7 +490,6 @@ public <Request extends ActionRequest, Response extends ActionResponse> void reg
         actions.register(ValidateQueryAction.INSTANCE, TransportValidateQueryAction.class);
         actions.register(RefreshAction.INSTANCE, TransportRefreshAction.class);
         actions.register(FlushAction.INSTANCE, TransportFlushAction.class);
-        actions.register(SyncedFlushAction.INSTANCE, TransportSyncedFlushAction.class);
         actions.register(ForceMergeAction.INSTANCE, TransportForceMergeAction.class);
         actions.register(UpgradeAction.INSTANCE, TransportUpgradeAction.class);
         actions.register(UpgradeStatusAction.INSTANCE, TransportUpgradeStatusAction.class);
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushAction.java
deleted file mode 100644
index d5180c799ade7..0000000000000
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushAction.java
+++ /dev/null
@@ -1,33 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.action.admin.indices.flush;
-
-import org.elasticsearch.action.ActionType;
-
-
-public class SyncedFlushAction extends ActionType<SyncedFlushResponse> {
-
-    public static final SyncedFlushAction INSTANCE = new SyncedFlushAction();
-    public static final String NAME = "indices:admin/synced_flush";
-
-    private SyncedFlushAction() {
-        super(NAME, SyncedFlushResponse::new);
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushRequest.java
deleted file mode 100644
index cb3333354b8e1..0000000000000
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushRequest.java
+++ /dev/null
@@ -1,57 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.action.admin.indices.flush;
-
-import org.elasticsearch.action.support.broadcast.BroadcastRequest;
-import org.elasticsearch.common.io.stream.StreamInput;
-
-import java.io.IOException;
-import java.util.Arrays;
-
-/**
- * A synced flush request to sync flush one or more indices. The synced flush process of an index performs a flush
- * and writes the same sync id to primary and all copies.
- *
- * <p>Best created with {@link org.elasticsearch.client.Requests#syncedFlushRequest(String...)}. </p>
- *
- * @see org.elasticsearch.client.Requests#flushRequest(String...)
- * @see org.elasticsearch.client.IndicesAdminClient#syncedFlush(SyncedFlushRequest)
- * @see SyncedFlushResponse
- */
-public class SyncedFlushRequest extends BroadcastRequest<SyncedFlushRequest> {
-
-    /**
-     * Constructs a new synced flush request against one or more indices. If nothing is provided, all indices will
-     * be sync flushed.
-     */
-    public SyncedFlushRequest(String... indices) {
-        super(indices);
-    }
-
-    public SyncedFlushRequest(StreamInput in) throws IOException {
-        super(in);
-    }
-
-    @Override
-    public String toString() {
-        return "SyncedFlushRequest{" +
-            "indices=" + Arrays.toString(indices) + "}";
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushRequestBuilder.java
deleted file mode 100644
index aee7c4688bb6c..0000000000000
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushRequestBuilder.java
+++ /dev/null
@@ -1,41 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.action.admin.indices.flush;
-
-import org.elasticsearch.action.ActionRequestBuilder;
-import org.elasticsearch.action.support.IndicesOptions;
-import org.elasticsearch.client.ElasticsearchClient;
-
-public class SyncedFlushRequestBuilder extends ActionRequestBuilder<SyncedFlushRequest, SyncedFlushResponse> {
-
-    public SyncedFlushRequestBuilder(ElasticsearchClient client, SyncedFlushAction action) {
-        super(client, action, new SyncedFlushRequest());
-    }
-
-    public SyncedFlushRequestBuilder setIndices(String[] indices) {
-        super.request().indices(indices);
-        return this;
-    }
-
-    public SyncedFlushRequestBuilder setIndicesOptions(IndicesOptions indicesOptions) {
-        super.request().indicesOptions(indicesOptions);
-        return this;
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushResponse.java b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushResponse.java
deleted file mode 100644
index 5e286b184fecc..0000000000000
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushResponse.java
+++ /dev/null
@@ -1,213 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.action.admin.indices.flush;
-
-import org.elasticsearch.action.ActionResponse;
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.io.stream.Writeable;
-import org.elasticsearch.common.util.iterable.Iterables;
-import org.elasticsearch.common.xcontent.ToXContentFragment;
-import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.indices.flush.ShardsSyncedFlushResult;
-import org.elasticsearch.indices.flush.SyncedFlushService;
-import org.elasticsearch.rest.RestStatus;
-
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-import static java.util.Collections.unmodifiableMap;
-
-/**
- * The result of performing a sync flush operation on all shards of multiple indices
- */
-public class SyncedFlushResponse extends ActionResponse implements ToXContentFragment {
-
-    private final Map<String, List<ShardsSyncedFlushResult>> shardsResultPerIndex;
-    private final ShardCounts shardCounts;
-
-    public SyncedFlushResponse(Map<String, List<ShardsSyncedFlushResult>> shardsResultPerIndex) {
-        // shardsResultPerIndex is never modified after it is passed to this
-        // constructor so this is safe even though shardsResultPerIndex is a
-        // ConcurrentHashMap
-        this.shardsResultPerIndex = unmodifiableMap(shardsResultPerIndex);
-        this.shardCounts = calculateShardCounts(Iterables.flatten(shardsResultPerIndex.values()));
-    }
-
-    public SyncedFlushResponse(StreamInput in) throws IOException {
-        super(in);
-        shardCounts = new ShardCounts(in);
-        Map<String, List<ShardsSyncedFlushResult>> tmpShardsResultPerIndex = new HashMap<>();
-        int numShardsResults = in.readInt();
-        for (int i =0 ; i< numShardsResults; i++) {
-            String index = in.readString();
-            List<ShardsSyncedFlushResult> shardsSyncedFlushResults = new ArrayList<>();
-            int numShards = in.readInt();
-            for (int j =0; j< numShards; j++) {
-                shardsSyncedFlushResults.add(new ShardsSyncedFlushResult(in));
-            }
-            tmpShardsResultPerIndex.put(index, shardsSyncedFlushResults);
-        }
-        shardsResultPerIndex = Collections.unmodifiableMap(tmpShardsResultPerIndex);
-    }
-
-    /**
-     * total number shards, including replicas, both assigned and unassigned
-     */
-    public int totalShards() {
-        return shardCounts.total;
-    }
-
-    /**
-     * total number of shards for which the operation failed
-     */
-    public int failedShards() {
-        return shardCounts.failed;
-    }
-
-    /**
-     * total number of shards which were successfully sync-flushed
-     */
-    public int successfulShards() {
-        return shardCounts.successful;
-    }
-
-    public RestStatus restStatus() {
-        return failedShards() == 0 ? RestStatus.OK : RestStatus.CONFLICT;
-    }
-
-    public Map<String, List<ShardsSyncedFlushResult>> getShardsResultPerIndex() {
-        return shardsResultPerIndex;
-    }
-
-    @Override
-    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-        builder.startObject(Fields._SHARDS);
-        shardCounts.toXContent(builder, params);
-        builder.endObject();
-        for (Map.Entry<String, List<ShardsSyncedFlushResult>> indexEntry : shardsResultPerIndex.entrySet()) {
-            List<ShardsSyncedFlushResult> indexResult = indexEntry.getValue();
-            builder.startObject(indexEntry.getKey());
-            ShardCounts indexShardCounts = calculateShardCounts(indexResult);
-            indexShardCounts.toXContent(builder, params);
-            if (indexShardCounts.failed > 0) {
-                builder.startArray(Fields.FAILURES);
-                for (ShardsSyncedFlushResult shardResults : indexResult) {
-                    if (shardResults.failed()) {
-                        builder.startObject();
-                        builder.field(Fields.SHARD, shardResults.shardId().id());
-                        builder.field(Fields.REASON, shardResults.failureReason());
-                        builder.endObject();
-                        continue;
-                    }
-                    Map<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> failedShards = shardResults.failedShards();
-                    for (Map.Entry<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> shardEntry : failedShards.entrySet()) {
-                        builder.startObject();
-                        builder.field(Fields.SHARD, shardResults.shardId().id());
-                        builder.field(Fields.REASON, shardEntry.getValue().failureReason());
-                        builder.field(Fields.ROUTING, shardEntry.getKey());
-                        builder.endObject();
-                    }
-                }
-                builder.endArray();
-            }
-            builder.endObject();
-        }
-        return builder;
-    }
-
-    static ShardCounts calculateShardCounts(Iterable<ShardsSyncedFlushResult> results) {
-        int total = 0, successful = 0, failed = 0;
-        for (ShardsSyncedFlushResult result : results) {
-            total += result.totalShards();
-            successful += result.successfulShards();
-            if (result.failed()) {
-                // treat all shard copies as failed
-                failed += result.totalShards();
-            } else {
-                // some shards may have failed during the sync phase
-                failed += result.failedShards().size();
-            }
-        }
-        return new ShardCounts(total, successful, failed);
-    }
-
-    static final class ShardCounts implements ToXContentFragment, Writeable {
-
-        public final int total;
-        public final int successful;
-        public final int failed;
-
-        ShardCounts(int total, int successful, int failed) {
-            this.total = total;
-            this.successful = successful;
-            this.failed = failed;
-        }
-
-        ShardCounts(StreamInput in) throws IOException {
-            total = in.readInt();
-            successful = in.readInt();
-            failed = in.readInt();
-        }
-
-        @Override
-        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            builder.field(Fields.TOTAL, total);
-            builder.field(Fields.SUCCESSFUL, successful);
-            builder.field(Fields.FAILED, failed);
-            return builder;
-        }
-
-        @Override
-        public void writeTo(StreamOutput out) throws IOException {
-            out.writeInt(total);
-            out.writeInt(successful);
-            out.writeInt(failed);
-        }
-    }
-
-    static final class Fields {
-        static final String _SHARDS = "_shards";
-        static final String TOTAL = "total";
-        static final String SUCCESSFUL = "successful";
-        static final String FAILED = "failed";
-        static final String FAILURES = "failures";
-        static final String SHARD = "shard";
-        static final String ROUTING = "routing";
-        static final String REASON = "reason";
-    }
-
-    @Override
-    public void writeTo(StreamOutput out) throws IOException {
-        shardCounts.writeTo(out);
-        out.writeInt(shardsResultPerIndex.size());
-        for (Map.Entry<String, List<ShardsSyncedFlushResult>> entry : shardsResultPerIndex.entrySet()) {
-            out.writeString(entry.getKey());
-            out.writeInt(entry.getValue().size());
-            for (ShardsSyncedFlushResult shardsSyncedFlushResult : entry.getValue()) {
-                shardsSyncedFlushResult.writeTo(out);
-            }
-        }
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportShardFlushAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportShardFlushAction.java
index 077657cc62dd4..397ce43747d53 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportShardFlushAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportShardFlushAction.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.action.admin.indices.flush;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionType;
 import org.elasticsearch.action.support.ActionFilters;
@@ -28,10 +29,16 @@
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.shard.IndexShard;
+import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.indices.IndicesService;
+import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.TransportChannel;
+import org.elasticsearch.transport.TransportRequest;
+import org.elasticsearch.transport.TransportRequestHandler;
 import org.elasticsearch.transport.TransportService;
 
 import java.io.IOException;
@@ -48,6 +55,8 @@ public TransportShardFlushAction(Settings settings, TransportService transportSe
                                      ActionFilters actionFilters) {
         super(settings, NAME, transportService, clusterService, indicesService, threadPool, shardStateAction,
             actionFilters, ShardFlushRequest::new, ShardFlushRequest::new, ThreadPool.Names.FLUSH);
+        transportService.registerRequestHandler(PRE_SYNCED_FLUSH_ACTION_NAME,
+            ThreadPool.Names.FLUSH, PreShardSyncedFlushRequest::new, new PreSyncedFlushTransportHandler(indicesService));
     }
 
     @Override
@@ -71,4 +80,43 @@ protected ReplicaResult shardOperationOnReplica(ShardFlushRequest request, Index
         logger.trace("{} flush request executed on replica", replica.shardId());
         return new ReplicaResult();
     }
+
+    // TODO: Remove this transition in 9.0
+    private static final String PRE_SYNCED_FLUSH_ACTION_NAME = "internal:indices/flush/synced/pre";
+
+    private static class PreShardSyncedFlushRequest extends TransportRequest {
+        private final ShardId shardId;
+
+        private PreShardSyncedFlushRequest(StreamInput in) throws IOException {
+            super(in);
+            assert in.getVersion().before(Version.V_8_0_0) : "received pre_sync request from a new node";
+            this.shardId = new ShardId(in);
+        }
+
+        @Override
+        public String toString() {
+            return "PreShardSyncedFlushRequest{" + "shardId=" + shardId + '}';
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            assert false : "must not send pre_sync request from a new node";
+            throw new UnsupportedOperationException("");
+        }
+    }
+
+    private static final class PreSyncedFlushTransportHandler implements TransportRequestHandler<PreShardSyncedFlushRequest> {
+        private final IndicesService indicesService;
+
+        PreSyncedFlushTransportHandler(IndicesService indicesService) {
+            this.indicesService = indicesService;
+        }
+
+        @Override
+        public void messageReceived(PreShardSyncedFlushRequest request, TransportChannel channel, Task task) {
+            IndexShard indexShard = indicesService.indexServiceSafe(request.shardId.getIndex()).getShard(request.shardId.id());
+            indexShard.flush(new FlushRequest().force(false).waitIfOngoing(true));
+            throw new UnsupportedOperationException("Synced flush was removed and a normal flush was performed instead.");
+        }
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportSyncedFlushAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportSyncedFlushAction.java
deleted file mode 100644
index 3eb72e0b02277..0000000000000
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/flush/TransportSyncedFlushAction.java
+++ /dev/null
@@ -1,48 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.action.admin.indices.flush;
-
-import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.action.support.ActionFilters;
-import org.elasticsearch.action.support.HandledTransportAction;
-import org.elasticsearch.common.inject.Inject;
-import org.elasticsearch.indices.flush.SyncedFlushService;
-import org.elasticsearch.tasks.Task;
-import org.elasticsearch.transport.TransportService;
-
-/**
- * Synced flush Action.
- */
-public class TransportSyncedFlushAction extends HandledTransportAction<SyncedFlushRequest, SyncedFlushResponse> {
-
-    SyncedFlushService syncedFlushService;
-
-    @Inject
-    public TransportSyncedFlushAction(TransportService transportService, ActionFilters actionFilters,
-                                      SyncedFlushService syncedFlushService) {
-        super(SyncedFlushAction.NAME, transportService, actionFilters, SyncedFlushRequest::new);
-        this.syncedFlushService = syncedFlushService;
-    }
-
-    @Override
-    protected void doExecute(Task task, SyncedFlushRequest request, ActionListener<SyncedFlushResponse> listener) {
-        syncedFlushService.attemptSyncedFlush(request.indices(), request.indicesOptions(), listener);
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/client/IndicesAdminClient.java b/server/src/main/java/org/elasticsearch/client/IndicesAdminClient.java
index 40c4c1046577b..36b34a7b24c85 100644
--- a/server/src/main/java/org/elasticsearch/client/IndicesAdminClient.java
+++ b/server/src/main/java/org/elasticsearch/client/IndicesAdminClient.java
@@ -42,9 +42,6 @@
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushRequestBuilder;
 import org.elasticsearch.action.admin.indices.flush.FlushResponse;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequestBuilder;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequestBuilder;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeResponse;
@@ -336,29 +333,6 @@ public interface IndicesAdminClient extends ElasticsearchClient {
      */
     FlushRequestBuilder prepareFlush(String... indices);
 
-    /**
-     * Explicitly sync flush one or more indices (write sync id to shards for faster recovery).
-     *
-     * @param request The sync flush request
-     * @return A result future
-     * @see org.elasticsearch.client.Requests#syncedFlushRequest(String...)
-     */
-    ActionFuture<SyncedFlushResponse> syncedFlush(SyncedFlushRequest request);
-
-    /**
-     * Explicitly sync flush one or more indices (write sync id to shards for faster recovery).
-     *
-     * @param request  The sync flush request
-     * @param listener A listener to be notified with a result
-     * @see org.elasticsearch.client.Requests#syncedFlushRequest(String...)
-     */
-    void syncedFlush(SyncedFlushRequest request, ActionListener <SyncedFlushResponse> listener);
-
-    /**
-     * Explicitly sync flush one or more indices (write sync id to shards for faster recovery).
-     */
-    SyncedFlushRequestBuilder prepareSyncedFlush(String... indices);
-
     /**
      * Explicitly force merge one or more indices into a the number of segments.
      *
diff --git a/server/src/main/java/org/elasticsearch/client/Requests.java b/server/src/main/java/org/elasticsearch/client/Requests.java
index 01d04c64ae1b1..bec0865bea8a6 100644
--- a/server/src/main/java/org/elasticsearch/client/Requests.java
+++ b/server/src/main/java/org/elasticsearch/client/Requests.java
@@ -47,7 +47,6 @@
 import org.elasticsearch.action.admin.indices.create.CreateIndexRequest;
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequest;
 import org.elasticsearch.action.admin.indices.mapping.put.PutMappingRequest;
 import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
@@ -248,17 +247,6 @@ public static FlushRequest flushRequest(String... indices) {
         return new FlushRequest(indices);
     }
 
-    /**
-     * Creates a synced flush indices request.
-     *
-     * @param indices The indices to sync flush. Use {@code null} or {@code _all} to execute against all indices
-     * @return The synced flush request
-     * @see org.elasticsearch.client.IndicesAdminClient#syncedFlush(SyncedFlushRequest)
-     */
-    public static SyncedFlushRequest syncedFlushRequest(String... indices) {
-        return new SyncedFlushRequest(indices);
-    }
-
     /**
      * Creates a force merge request.
      *
diff --git a/server/src/main/java/org/elasticsearch/client/support/AbstractClient.java b/server/src/main/java/org/elasticsearch/client/support/AbstractClient.java
index 5bb480d8c23c3..1ee480fb55edd 100644
--- a/server/src/main/java/org/elasticsearch/client/support/AbstractClient.java
+++ b/server/src/main/java/org/elasticsearch/client/support/AbstractClient.java
@@ -163,10 +163,6 @@
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushRequestBuilder;
 import org.elasticsearch.action.admin.indices.flush.FlushResponse;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushAction;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequestBuilder;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeAction;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequest;
 import org.elasticsearch.action.admin.indices.forcemerge.ForceMergeRequestBuilder;
@@ -1351,21 +1347,6 @@ public FlushRequestBuilder prepareFlush(String... indices) {
             return new FlushRequestBuilder(this, FlushAction.INSTANCE).setIndices(indices);
         }
 
-        @Override
-        public ActionFuture<SyncedFlushResponse> syncedFlush(SyncedFlushRequest request) {
-            return execute(SyncedFlushAction.INSTANCE, request);
-        }
-
-        @Override
-        public void syncedFlush(SyncedFlushRequest request, ActionListener<SyncedFlushResponse> listener) {
-            execute(SyncedFlushAction.INSTANCE, request, listener);
-        }
-
-        @Override
-        public SyncedFlushRequestBuilder prepareSyncedFlush(String... indices) {
-            return new SyncedFlushRequestBuilder(this, SyncedFlushAction.INSTANCE).setIndices(indices);
-        }
-
         @Override
         public void getMappings(GetMappingsRequest request, ActionListener<GetMappingsResponse> listener) {
             execute(GetMappingsAction.INSTANCE, request, listener);
diff --git a/server/src/main/java/org/elasticsearch/index/engine/CommitStats.java b/server/src/main/java/org/elasticsearch/index/engine/CommitStats.java
index 22587cf6aad79..517e2966e41c2 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/CommitStats.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/CommitStats.java
@@ -88,13 +88,6 @@ public Engine.CommitId getRawCommitId() {
         return new Engine.CommitId(Base64.getDecoder().decode(id));
     }
 
-    /**
-     * The synced-flush id of the commit if existed.
-     */
-    public String syncId() {
-        return userData.get(InternalEngine.SYNC_COMMIT_ID);
-    }
-
     /**
      * Returns the number of documents in the in this commit
      */
diff --git a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
index 5415a433d8670..549b3b7a21dc3 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
@@ -1035,12 +1035,6 @@ public CompletionStats completionStats(String... fields) {
         }
     }
 
-    public Engine.SyncedFlushResult syncFlush(String syncId, Engine.CommitId expectedCommitId) {
-        verifyNotClosed();
-        logger.trace("trying to sync flush. sync id [{}]. expected commit id [{}]]", syncId, expectedCommitId);
-        return getEngine().syncFlush(syncId, expectedCommitId);
-    }
-
     /**
      * Executes the given flush request against the engine.
      *
diff --git a/server/src/main/java/org/elasticsearch/indices/IndicesModule.java b/server/src/main/java/org/elasticsearch/indices/IndicesModule.java
index 7584fda21c329..1214103dd69c0 100644
--- a/server/src/main/java/org/elasticsearch/indices/IndicesModule.java
+++ b/server/src/main/java/org/elasticsearch/indices/IndicesModule.java
@@ -61,7 +61,6 @@
 import org.elasticsearch.index.seqno.RetentionLeaseSyncer;
 import org.elasticsearch.index.shard.PrimaryReplicaSyncer;
 import org.elasticsearch.indices.cluster.IndicesClusterStateService;
-import org.elasticsearch.indices.flush.SyncedFlushService;
 import org.elasticsearch.indices.mapper.MapperRegistry;
 import org.elasticsearch.indices.store.IndicesStore;
 import org.elasticsearch.plugins.MapperPlugin;
@@ -238,7 +237,6 @@ private static Function<String, Predicate<String>> and(Function<String, Predicat
     protected void configure() {
         bind(IndicesStore.class).asEagerSingleton();
         bind(IndicesClusterStateService.class).asEagerSingleton();
-        bind(SyncedFlushService.class).asEagerSingleton();
         bind(TransportResyncReplicationAction.class).asEagerSingleton();
         bind(PrimaryReplicaSyncer.class).asEagerSingleton();
         bind(RetentionLeaseSyncAction.class).asEagerSingleton();
diff --git a/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java b/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
index e7e6d954aa1c4..754635b121249 100644
--- a/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
+++ b/server/src/main/java/org/elasticsearch/indices/cluster/IndicesClusterStateService.java
@@ -68,7 +68,6 @@
 import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.index.shard.ShardNotFoundException;
 import org.elasticsearch.indices.IndicesService;
-import org.elasticsearch.indices.flush.SyncedFlushService;
 import org.elasticsearch.indices.recovery.PeerRecoverySourceService;
 import org.elasticsearch.indices.recovery.PeerRecoveryTargetService;
 import org.elasticsearch.indices.recovery.RecoveryFailedException;
@@ -135,7 +134,6 @@ public IndicesClusterStateService(
             final NodeMappingRefreshAction nodeMappingRefreshAction,
             final RepositoriesService repositoriesService,
             final SearchService searchService,
-            final SyncedFlushService syncedFlushService,
             final PeerRecoverySourceService peerRecoverySourceService,
             final SnapshotShardsService snapshotShardsService,
             final PrimaryReplicaSyncer primaryReplicaSyncer,
@@ -151,7 +149,6 @@ public IndicesClusterStateService(
                 nodeMappingRefreshAction,
                 repositoriesService,
                 searchService,
-                syncedFlushService,
                 peerRecoverySourceService,
                 snapshotShardsService,
                 primaryReplicaSyncer,
@@ -170,7 +167,6 @@ public IndicesClusterStateService(
             final NodeMappingRefreshAction nodeMappingRefreshAction,
             final RepositoriesService repositoriesService,
             final SearchService searchService,
-            final SyncedFlushService syncedFlushService,
             final PeerRecoverySourceService peerRecoverySourceService,
             final SnapshotShardsService snapshotShardsService,
             final PrimaryReplicaSyncer primaryReplicaSyncer,
diff --git a/server/src/main/java/org/elasticsearch/indices/flush/ShardsSyncedFlushResult.java b/server/src/main/java/org/elasticsearch/indices/flush/ShardsSyncedFlushResult.java
deleted file mode 100644
index 4748c41d4b3e7..0000000000000
--- a/server/src/main/java/org/elasticsearch/indices/flush/ShardsSyncedFlushResult.java
+++ /dev/null
@@ -1,163 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.indices.flush;
-
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.io.stream.Writeable;
-import org.elasticsearch.index.shard.ShardId;
-
-import java.io.IOException;
-import java.util.HashMap;
-import java.util.Map;
-
-import static java.util.Collections.emptyMap;
-
-/**
- * Result for all copies of a shard
- */
-public class ShardsSyncedFlushResult implements Writeable {
-    private String failureReason;
-    private Map<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> shardResponses;
-    private String syncId;
-    private ShardId shardId;
-    // some shards may be unassigned, so we need this as state
-    private int totalShards;
-
-    public ShardsSyncedFlushResult(StreamInput in) throws IOException {
-        failureReason = in.readOptionalString();
-        int numResponses = in.readInt();
-        shardResponses = new HashMap<>();
-        for (int i = 0; i < numResponses; i++) {
-            ShardRouting shardRouting = new ShardRouting(in);
-            SyncedFlushService.ShardSyncedFlushResponse response = SyncedFlushService.ShardSyncedFlushResponse.readSyncedFlushResponse(in);
-            shardResponses.put(shardRouting, response);
-        }
-        syncId = in.readOptionalString();
-        shardId = new ShardId(in);
-        totalShards = in.readInt();
-    }
-
-    public ShardId getShardId() {
-        return shardId;
-    }
-
-    /**
-     * failure constructor
-     */
-    public ShardsSyncedFlushResult(ShardId shardId, int totalShards, String failureReason) {
-        this.syncId = null;
-        this.failureReason = failureReason;
-        this.shardResponses = emptyMap();
-        this.shardId = shardId;
-        this.totalShards = totalShards;
-    }
-
-    /**
-     * success constructor
-     */
-    public ShardsSyncedFlushResult(ShardId shardId,
-                                   String syncId,
-                                   int totalShards,
-                                   Map<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> shardResponses) {
-        this.failureReason = null;
-        this.shardResponses = Map.copyOf(shardResponses);
-        this.syncId = syncId;
-        this.totalShards = totalShards;
-        this.shardId = shardId;
-    }
-
-    /**
-     * @return true if the operation failed before reaching step three of synced flush. {@link #failureReason()} can be used for
-     * more details
-     */
-    public boolean failed() {
-        return failureReason != null;
-    }
-
-    /**
-     * @return the reason for the failure if synced flush failed before step three of synced flush
-     */
-    public String failureReason() {
-        return failureReason;
-    }
-
-    public String syncId() {
-        return syncId;
-    }
-
-    /**
-     * @return total number of shards for which a sync attempt was made
-     */
-    public int totalShards() {
-        return totalShards;
-    }
-
-    /**
-     * @return total number of successful shards
-     */
-    public int successfulShards() {
-        int i = 0;
-        for (SyncedFlushService.ShardSyncedFlushResponse result : shardResponses.values()) {
-            if (result.success()) {
-                i++;
-            }
-        }
-        return i;
-    }
-
-    /**
-     * @return an array of shard failures
-     */
-    public Map<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> failedShards() {
-        Map<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> failures = new HashMap<>();
-        for (Map.Entry<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> result : shardResponses.entrySet()) {
-            if (result.getValue().success() == false) {
-                failures.put(result.getKey(), result.getValue());
-            }
-        }
-        return failures;
-    }
-
-    /**
-     * @return Individual responses for each shard copy with a detailed failure message if the copy failed to perform the synced flush.
-     * Empty if synced flush failed before step three.
-     */
-    public Map<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> shardResponses() {
-        return shardResponses;
-    }
-
-    public ShardId shardId() {
-        return shardId;
-    }
-
-    @Override
-    public void writeTo(StreamOutput out) throws IOException {
-        out.writeOptionalString(failureReason);
-        out.writeInt(shardResponses.size());
-        for (Map.Entry<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> entry : shardResponses.entrySet()) {
-            entry.getKey().writeTo(out);
-            entry.getValue().writeTo(out);
-        }
-        out.writeOptionalString(syncId);
-        shardId.writeTo(out);
-        out.writeInt(totalShards);
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/indices/flush/SyncedFlushService.java b/server/src/main/java/org/elasticsearch/indices/flush/SyncedFlushService.java
deleted file mode 100644
index a0fc2e153b90e..0000000000000
--- a/server/src/main/java/org/elasticsearch/indices/flush/SyncedFlushService.java
+++ /dev/null
@@ -1,768 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.indices.flush;
-
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
-import org.apache.logging.log4j.message.ParameterizedMessage;
-import org.elasticsearch.ElasticsearchException;
-import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.action.StepListener;
-import org.elasticsearch.action.admin.indices.flush.FlushRequest;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse;
-import org.elasticsearch.action.support.IndicesOptions;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
-import org.elasticsearch.cluster.node.DiscoveryNode;
-import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.cluster.service.ClusterService;
-import org.elasticsearch.common.Nullable;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.UUIDs;
-import org.elasticsearch.common.inject.Inject;
-import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.logging.DeprecationLogger;
-import org.elasticsearch.common.util.concurrent.ConcurrentCollections;
-import org.elasticsearch.common.util.concurrent.CountDown;
-import org.elasticsearch.index.Index;
-import org.elasticsearch.index.IndexNotFoundException;
-import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.engine.CommitStats;
-import org.elasticsearch.index.engine.Engine;
-import org.elasticsearch.index.shard.IndexShard;
-import org.elasticsearch.index.shard.ShardId;
-import org.elasticsearch.index.shard.ShardNotFoundException;
-import org.elasticsearch.indices.IndexClosedException;
-import org.elasticsearch.indices.IndicesService;
-import org.elasticsearch.tasks.Task;
-import org.elasticsearch.threadpool.ThreadPool;
-import org.elasticsearch.transport.TransportChannel;
-import org.elasticsearch.transport.TransportException;
-import org.elasticsearch.transport.TransportRequest;
-import org.elasticsearch.transport.TransportRequestHandler;
-import org.elasticsearch.transport.TransportResponse;
-import org.elasticsearch.transport.TransportResponseHandler;
-import org.elasticsearch.transport.TransportService;
-
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.concurrent.ConcurrentMap;
-
-public class SyncedFlushService {
-
-    private static final Logger logger = LogManager.getLogger(SyncedFlushService.class);
-
-    private static final DeprecationLogger DEPRECATION_LOGGER = new DeprecationLogger(logger);
-
-    public static final String SYNCED_FLUSH_DEPRECATION_MESSAGE =
-        "Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead.";
-
-    private static final String PRE_SYNCED_FLUSH_ACTION_NAME = "internal:indices/flush/synced/pre";
-    private static final String SYNCED_FLUSH_ACTION_NAME = "internal:indices/flush/synced/sync";
-    private static final String IN_FLIGHT_OPS_ACTION_NAME = "internal:indices/flush/synced/in_flight";
-
-    private final IndicesService indicesService;
-    private final ClusterService clusterService;
-    private final TransportService transportService;
-    private final IndexNameExpressionResolver indexNameExpressionResolver;
-
-    @Inject
-    public SyncedFlushService(IndicesService indicesService,
-                              ClusterService clusterService,
-                              TransportService transportService,
-                              IndexNameExpressionResolver indexNameExpressionResolver) {
-        this.indicesService = indicesService;
-        this.clusterService = clusterService;
-        this.transportService = transportService;
-        this.indexNameExpressionResolver = indexNameExpressionResolver;
-        transportService.registerRequestHandler(PRE_SYNCED_FLUSH_ACTION_NAME, ThreadPool.Names.FLUSH, PreShardSyncedFlushRequest::new,
-            new PreSyncedFlushTransportHandler());
-        transportService.registerRequestHandler(SYNCED_FLUSH_ACTION_NAME, ThreadPool.Names.FLUSH, ShardSyncedFlushRequest::new,
-            new SyncedFlushTransportHandler());
-        transportService.registerRequestHandler(IN_FLIGHT_OPS_ACTION_NAME, ThreadPool.Names.SAME, InFlightOpsRequest::new,
-            new InFlightOpCountTransportHandler());
-    }
-
-    /**
-     * a utility method to perform a synced flush for all shards of multiple indices.
-     * see {@link #attemptSyncedFlush(ShardId, ActionListener)}
-     * for more details.
-     */
-    public void attemptSyncedFlush(final String[] aliasesOrIndices,
-                                   IndicesOptions indicesOptions,
-                                   final ActionListener<SyncedFlushResponse> listener) {
-        final ClusterState state = clusterService.state();
-        DEPRECATION_LOGGER.deprecatedAndMaybeLog("synced_flush", SYNCED_FLUSH_DEPRECATION_MESSAGE);
-        final Index[] concreteIndices = indexNameExpressionResolver.concreteIndices(state, indicesOptions, aliasesOrIndices);
-        final Map<String, List<ShardsSyncedFlushResult>> results = ConcurrentCollections.newConcurrentMap();
-        int numberOfShards = 0;
-        for (Index index : concreteIndices) {
-            final IndexMetaData indexMetaData = state.metaData().getIndexSafe(index);
-            numberOfShards += indexMetaData.getNumberOfShards();
-            results.put(index.getName(), Collections.synchronizedList(new ArrayList<>()));
-
-        }
-        if (numberOfShards == 0) {
-            listener.onResponse(new SyncedFlushResponse(results));
-            return;
-        }
-        final CountDown countDown = new CountDown(numberOfShards);
-
-        for (final Index concreteIndex : concreteIndices) {
-            final String index = concreteIndex.getName();
-            final IndexMetaData indexMetaData = state.metaData().getIndexSafe(concreteIndex);
-            final int indexNumberOfShards = indexMetaData.getNumberOfShards();
-            for (int shard = 0; shard < indexNumberOfShards; shard++) {
-                final ShardId shardId = new ShardId(indexMetaData.getIndex(), shard);
-                innerAttemptSyncedFlush(shardId, state, new ActionListener<ShardsSyncedFlushResult>() {
-                    @Override
-                    public void onResponse(ShardsSyncedFlushResult syncedFlushResult) {
-                        results.get(index).add(syncedFlushResult);
-                        if (countDown.countDown()) {
-                            listener.onResponse(new SyncedFlushResponse(results));
-                        }
-                    }
-
-                    @Override
-                    public void onFailure(Exception e) {
-                        logger.debug("{} unexpected error while executing synced flush", shardId);
-                        final int totalShards = indexMetaData.getNumberOfReplicas() + 1;
-                        results.get(index).add(new ShardsSyncedFlushResult(shardId, totalShards, e.getMessage()));
-                        if (countDown.countDown()) {
-                            listener.onResponse(new SyncedFlushResponse(results));
-                        }
-                    }
-                });
-            }
-        }
-    }
-
-    /*
-    * Tries to flush all copies of a shard and write a sync id to it.
-    * After a synced flush two shard copies may only contain the same sync id if they contain the same documents.
-    * To ensure this, synced flush works in three steps:
-    * 1. Flush all shard copies and gather the commit ids for each copy after the flush
-    * 2. Ensure that there are no ongoing indexing operations on the primary
-    * 3. Perform an additional flush on each shard copy that writes the sync id
-    *
-    * Step 3 is only executed on a shard if
-    * a) the shard has no uncommitted changes since the last flush
-    * b) the last flush was the one executed in 1 (use the collected commit id to verify this)
-    *
-    * This alone is not enough to ensure that all copies contain the same documents.
-    * Without step 2 a sync id would be written for inconsistent copies in the following scenario:
-    *
-    * Write operation has completed on a primary and is being sent to replicas. The write request does not reach the
-    * replicas until sync flush is finished.
-    * Step 1 is executed. After the flush the commit points on primary contains a write operation that the replica does not have.
-    * Step 3 will be executed on primary and replica as well because there are no uncommitted changes on primary (the first flush
-    * committed them) and there are no uncommitted changes on the replica (the write operation has not reached the replica yet).
-    *
-    * Step 2 detects this scenario and fails the whole synced flush if a write operation is ongoing on the primary.
-    * Together with the conditions for step 3 (same commit id and no uncommitted changes) this guarantees that a snc id will only
-    * be written on a primary if no write operation was executed between step 1 and step 3 and sync id will only be written on
-    * the replica if it contains the same changes that the primary contains.
-    *
-    * Synced flush is a best effort operation. The sync id may be written on all, some or none of the copies.
-    **/
-    public void attemptSyncedFlush(final ShardId shardId, final ActionListener<ShardsSyncedFlushResult> actionListener) {
-        innerAttemptSyncedFlush(shardId, clusterService.state(), actionListener);
-    }
-
-    private void innerAttemptSyncedFlush(final ShardId shardId,
-                                         final ClusterState state,
-                                         final ActionListener<ShardsSyncedFlushResult> actionListener) {
-        try {
-            final IndexShardRoutingTable shardRoutingTable = getShardRoutingTable(shardId, state);
-            final List<ShardRouting> activeShards = shardRoutingTable.activeShards();
-            final int totalShards = shardRoutingTable.getSize();
-
-            if (activeShards.size() == 0) {
-                actionListener.onResponse(new ShardsSyncedFlushResult(shardId, totalShards, "no active shards"));
-                return;
-            }
-
-            // 1. send pre-sync flushes to all replicas
-            final StepListener<Map<String, PreSyncedFlushResponse>> presyncStep = new StepListener<>();
-            sendPreSyncRequests(activeShards, state, shardId, presyncStep);
-
-            // 2. fetch in flight operations
-            final StepListener<InFlightOpsResponse> inflightOpsStep = new StepListener<>();
-            presyncStep.whenComplete(presyncResponses -> {
-                if (presyncResponses.isEmpty()) {
-                    actionListener.onResponse(new ShardsSyncedFlushResult(shardId, totalShards, "all shards failed to commit on pre-sync"));
-                } else {
-                    getInflightOpsCount(shardId, state, shardRoutingTable, inflightOpsStep);
-                }
-            }, actionListener::onFailure);
-
-            // 3. now send the sync request to all the shards
-            inflightOpsStep.whenComplete(inFlightOpsResponse -> {
-                final Map<String, PreSyncedFlushResponse> presyncResponses = presyncStep.result();
-                final int inflight = inFlightOpsResponse.opCount();
-                assert inflight >= 0;
-                if (inflight != 0) {
-                    actionListener.onResponse(
-                        new ShardsSyncedFlushResult(shardId, totalShards, "[" + inflight + "] ongoing operations on primary"));
-                } else {
-                    final String sharedSyncId = sharedExistingSyncId(presyncResponses);
-                    if (sharedSyncId != null) {
-                        assert presyncResponses.values().stream().allMatch(r -> r.existingSyncId.equals(sharedSyncId)) :
-                            "Not all shards have the same existing sync id [" + sharedSyncId + "], responses [" + presyncResponses + "]";
-                        reportSuccessWithExistingSyncId(shardId, sharedSyncId, activeShards, totalShards, presyncResponses, actionListener);
-                    }else {
-                        String syncId = UUIDs.randomBase64UUID();
-                        sendSyncRequests(syncId, activeShards, state, presyncResponses, shardId, totalShards, actionListener);
-                    }
-                }
-            }, actionListener::onFailure);
-        } catch (Exception e) {
-            actionListener.onFailure(e);
-        }
-    }
-
-    private String sharedExistingSyncId(Map<String, PreSyncedFlushResponse> preSyncedFlushResponses) {
-        String existingSyncId = null;
-        for (PreSyncedFlushResponse resp : preSyncedFlushResponses.values()) {
-            if (Strings.isNullOrEmpty(resp.existingSyncId)) {
-                return null;
-            }
-            if (existingSyncId == null) {
-                existingSyncId = resp.existingSyncId;
-            }
-            if (existingSyncId.equals(resp.existingSyncId) == false) {
-                return null;
-            }
-        }
-        return existingSyncId;
-    }
-
-    private void reportSuccessWithExistingSyncId(ShardId shardId,
-                                                 String existingSyncId,
-                                                 List<ShardRouting> shards,
-                                                 int totalShards,
-                                                 Map<String, PreSyncedFlushResponse> preSyncResponses,
-                                                 ActionListener<ShardsSyncedFlushResult> listener) {
-        final Map<ShardRouting, ShardSyncedFlushResponse> results = new HashMap<>();
-        for (final ShardRouting shard : shards) {
-            if (preSyncResponses.containsKey(shard.currentNodeId())) {
-                results.put(shard, new ShardSyncedFlushResponse((String) null));
-            }
-        }
-        listener.onResponse(new ShardsSyncedFlushResult(shardId, existingSyncId, totalShards, results));
-    }
-
-    final IndexShardRoutingTable getShardRoutingTable(final ShardId shardId, final ClusterState state) {
-        final IndexMetaData indexMetaData = state.getMetaData().index(shardId.getIndex());
-        if (indexMetaData == null) {
-            throw new IndexNotFoundException(shardId.getIndexName());
-        } else if (indexMetaData.getState() == IndexMetaData.State.CLOSE) {
-            throw new IndexClosedException(shardId.getIndex());
-        }
-        final IndexShardRoutingTable shardRoutingTable = state.routingTable().index(indexMetaData.getIndex()).shard(shardId.id());
-        if (shardRoutingTable == null) {
-            throw new ShardNotFoundException(shardId);
-        }
-        return shardRoutingTable;
-    }
-
-    /**
-     * returns the number of in flight operations on primary. -1 upon error.
-     */
-    protected void getInflightOpsCount(final ShardId shardId,
-                                       ClusterState state,
-                                       IndexShardRoutingTable shardRoutingTable,
-                                       final ActionListener<InFlightOpsResponse> listener) {
-        try {
-            final ShardRouting primaryShard = shardRoutingTable.primaryShard();
-            final DiscoveryNode primaryNode = state.nodes().get(primaryShard.currentNodeId());
-            if (primaryNode == null) {
-                logger.trace("{} failed to resolve node for primary shard {}, skipping sync", shardId, primaryShard);
-                listener.onResponse(new InFlightOpsResponse(-1));
-                return;
-            }
-            logger.trace("{} retrieving in flight operation count", shardId);
-            transportService.sendRequest(primaryNode, IN_FLIGHT_OPS_ACTION_NAME, new InFlightOpsRequest(shardId),
-                    new TransportResponseHandler<InFlightOpsResponse>() {
-                        @Override
-                        public InFlightOpsResponse read(StreamInput in) throws IOException {
-                            return new InFlightOpsResponse(in);
-                        }
-
-                        @Override
-                        public void handleResponse(InFlightOpsResponse response) {
-                            listener.onResponse(response);
-                        }
-
-                        @Override
-                        public void handleException(TransportException exp) {
-                            logger.debug("{} unexpected error while retrieving in flight op count", shardId);
-                            listener.onFailure(exp);
-                        }
-
-                        @Override
-                        public String executor() {
-                            return ThreadPool.Names.SAME;
-                        }
-                    });
-        } catch (Exception e) {
-            listener.onFailure(e);
-        }
-    }
-
-    private int numDocsOnPrimary(List<ShardRouting> shards, Map<String, PreSyncedFlushResponse> preSyncResponses) {
-        for (ShardRouting shard : shards) {
-            if (shard.primary()) {
-                final PreSyncedFlushResponse resp = preSyncResponses.get(shard.currentNodeId());
-                if (resp != null) {
-                    return resp.numDocs;
-                }
-            }
-        }
-        return PreSyncedFlushResponse.UNKNOWN_NUM_DOCS;
-    }
-
-    void sendSyncRequests(final String syncId,
-                          final List<ShardRouting> shards,
-                          ClusterState state,
-                          Map<String, PreSyncedFlushResponse> preSyncResponses,
-                          final ShardId shardId,
-                          final int totalShards,
-                          final ActionListener<ShardsSyncedFlushResult> listener) {
-        final CountDown countDown = new CountDown(shards.size());
-        final Map<ShardRouting, ShardSyncedFlushResponse> results = ConcurrentCollections.newConcurrentMap();
-        final int numDocsOnPrimary = numDocsOnPrimary(shards, preSyncResponses);
-        for (final ShardRouting shard : shards) {
-            final DiscoveryNode node = state.nodes().get(shard.currentNodeId());
-            if (node == null) {
-                logger.trace("{} is assigned to an unknown node. skipping for sync id [{}]. shard routing {}", shardId, syncId, shard);
-                results.put(shard, new ShardSyncedFlushResponse("unknown node"));
-                countDownAndSendResponseIfDone(syncId, shards, shardId, totalShards, listener, countDown, results);
-                continue;
-            }
-            final PreSyncedFlushResponse preSyncedResponse = preSyncResponses.get(shard.currentNodeId());
-            if (preSyncedResponse == null) {
-                logger.trace("{} can't resolve expected commit id for current node, skipping for sync id [{}]. shard routing {}",
-                    shardId, syncId, shard);
-                results.put(shard, new ShardSyncedFlushResponse("no commit id from pre-sync flush"));
-                countDownAndSendResponseIfDone(syncId, shards, shardId, totalShards, listener, countDown, results);
-                continue;
-            }
-            if (preSyncedResponse.numDocs != numDocsOnPrimary &&
-                preSyncedResponse.numDocs != PreSyncedFlushResponse.UNKNOWN_NUM_DOCS &&
-                numDocsOnPrimary != PreSyncedFlushResponse.UNKNOWN_NUM_DOCS) {
-                logger.debug("{} can't issue sync id [{}] for replica [{}] with num docs [{}]; num docs on primary [{}]",
-                    shardId, syncId, shard, preSyncedResponse.numDocs, numDocsOnPrimary);
-                results.put(shard, new ShardSyncedFlushResponse("ongoing indexing operations: " +
-                    "num docs on replica [" + preSyncedResponse.numDocs + "]; num docs on primary [" + numDocsOnPrimary + "]"));
-                countDownAndSendResponseIfDone(syncId, shards, shardId, totalShards, listener, countDown, results);
-                continue;
-            }
-            logger.trace("{} sending synced flush request to {}. sync id [{}].", shardId, shard, syncId);
-            ShardSyncedFlushRequest syncedFlushRequest = new ShardSyncedFlushRequest(shard.shardId(), syncId, preSyncedResponse.commitId);
-            transportService.sendRequest(node, SYNCED_FLUSH_ACTION_NAME, syncedFlushRequest,
-                    new TransportResponseHandler<ShardSyncedFlushResponse>() {
-                        @Override
-                        public ShardSyncedFlushResponse read(StreamInput in) throws IOException {
-                            return new ShardSyncedFlushResponse(in);
-                        }
-
-                        @Override
-                        public void handleResponse(ShardSyncedFlushResponse response) {
-                            ShardSyncedFlushResponse existing = results.put(shard, response);
-                            assert existing == null : "got two answers for node [" + node + "]";
-                            // count after the assert so we won't decrement twice in handleException
-                            countDownAndSendResponseIfDone(syncId, shards, shardId, totalShards, listener, countDown, results);
-                        }
-
-                        @Override
-                        public void handleException(TransportException exp) {
-                            logger.trace(() -> new ParameterizedMessage("{} error while performing synced flush on [{}], skipping",
-                                shardId, shard), exp);
-                            results.put(shard, new ShardSyncedFlushResponse(exp.getMessage()));
-                            countDownAndSendResponseIfDone(syncId, shards, shardId, totalShards, listener, countDown, results);
-                        }
-
-                        @Override
-                        public String executor() {
-                            return ThreadPool.Names.SAME;
-                        }
-                    });
-        }
-
-    }
-
-    private void countDownAndSendResponseIfDone(String syncId,
-                                                List<ShardRouting> shards,
-                                                ShardId shardId,
-                                                int totalShards,
-                                                ActionListener<ShardsSyncedFlushResult> listener,
-                                                CountDown countDown,
-                                                Map<ShardRouting, ShardSyncedFlushResponse> results) {
-        if (countDown.countDown()) {
-            assert results.size() == shards.size();
-            listener.onResponse(new ShardsSyncedFlushResult(shardId, syncId, totalShards, results));
-        }
-    }
-
-    /**
-     * send presync requests to all started copies of the given shard
-     */
-    void sendPreSyncRequests(final List<ShardRouting> shards,
-                             final ClusterState state,
-                             final ShardId shardId,
-                             final ActionListener<Map<String, PreSyncedFlushResponse>> listener) {
-        final CountDown countDown = new CountDown(shards.size());
-        final ConcurrentMap<String, PreSyncedFlushResponse> presyncResponses = ConcurrentCollections.newConcurrentMap();
-        for (final ShardRouting shard : shards) {
-            logger.trace("{} sending pre-synced flush request to {}", shardId, shard);
-            final DiscoveryNode node = state.nodes().get(shard.currentNodeId());
-            if (node == null) {
-                logger.trace("{} shard routing {} refers to an unknown node. skipping.", shardId, shard);
-                if (countDown.countDown()) {
-                    listener.onResponse(presyncResponses);
-                }
-                continue;
-            }
-            transportService.sendRequest(node, PRE_SYNCED_FLUSH_ACTION_NAME, new PreShardSyncedFlushRequest(shard.shardId()),
-                new TransportResponseHandler<PreSyncedFlushResponse>() {
-                @Override
-                public PreSyncedFlushResponse read(StreamInput in) throws IOException {
-                    return new PreSyncedFlushResponse(in);
-                }
-
-                @Override
-                public void handleResponse(PreSyncedFlushResponse response) {
-                    PreSyncedFlushResponse existing = presyncResponses.putIfAbsent(node.getId(), response);
-                    assert existing == null : "got two answers for node [" + node + "]";
-                    // count after the assert so we won't decrement twice in handleException
-                    if (countDown.countDown()) {
-                        listener.onResponse(presyncResponses);
-                    }
-                }
-
-                @Override
-                public void handleException(TransportException exp) {
-                    logger.trace(() -> new ParameterizedMessage("{} error while performing pre synced flush on [{}], skipping",
-                        shardId, shard), exp);
-                    if (countDown.countDown()) {
-                        listener.onResponse(presyncResponses);
-                    }
-                }
-
-                @Override
-                public String executor() {
-                    return ThreadPool.Names.SAME;
-                }
-            });
-        }
-    }
-
-    private PreSyncedFlushResponse performPreSyncedFlush(PreShardSyncedFlushRequest request) {
-        IndexShard indexShard = indicesService.indexServiceSafe(request.shardId().getIndex()).getShard(request.shardId().id());
-        FlushRequest flushRequest = new FlushRequest().force(false).waitIfOngoing(true);
-        logger.trace("{} performing pre sync flush", request.shardId());
-        indexShard.flush(flushRequest);
-        final CommitStats commitStats = indexShard.commitStats();
-        final Engine.CommitId commitId = commitStats.getRawCommitId();
-        logger.trace("{} pre sync flush done. commit id {}, num docs {}", request.shardId(), commitId, commitStats.getNumDocs());
-        return new PreSyncedFlushResponse(commitId, commitStats.getNumDocs(), commitStats.syncId());
-    }
-
-    private ShardSyncedFlushResponse performSyncedFlush(ShardSyncedFlushRequest request) {
-        IndexService indexService = indicesService.indexServiceSafe(request.shardId().getIndex());
-        IndexShard indexShard = indexService.getShard(request.shardId().id());
-        logger.trace("{} performing sync flush. sync id [{}], expected commit id {}",
-            request.shardId(), request.syncId(), request.expectedCommitId());
-        Engine.SyncedFlushResult result = indexShard.syncFlush(request.syncId(), request.expectedCommitId());
-        logger.trace("{} sync flush done. sync id [{}], result [{}]", request.shardId(), request.syncId(), result);
-        switch (result) {
-            case SUCCESS:
-                return new ShardSyncedFlushResponse((String) null);
-            case COMMIT_MISMATCH:
-                return new ShardSyncedFlushResponse("commit has changed");
-            case PENDING_OPERATIONS:
-                return new ShardSyncedFlushResponse("pending operations");
-            default:
-                throw new ElasticsearchException("unknown synced flush result [" + result + "]");
-        }
-    }
-
-    private InFlightOpsResponse performInFlightOps(InFlightOpsRequest request) {
-        IndexService indexService = indicesService.indexServiceSafe(request.shardId().getIndex());
-        IndexShard indexShard = indexService.getShard(request.shardId().id());
-        if (indexShard.routingEntry().primary() == false) {
-            throw new IllegalStateException("[" + request.shardId() +"] expected a primary shard");
-        }
-        int opCount = indexShard.getActiveOperationsCount();
-        return new InFlightOpsResponse(opCount == IndexShard.OPERATIONS_BLOCKED ? 0 : opCount);
-    }
-
-    public static final class PreShardSyncedFlushRequest extends TransportRequest {
-        private ShardId shardId;
-
-        public PreShardSyncedFlushRequest(StreamInput in) throws IOException {
-            super(in);
-            this.shardId = new ShardId(in);
-        }
-
-        public PreShardSyncedFlushRequest(ShardId shardId) {
-            this.shardId = shardId;
-        }
-
-        @Override
-        public String toString() {
-            return "PreShardSyncedFlushRequest{" +
-                    "shardId=" + shardId +
-                    '}';
-        }
-
-        @Override
-        public void writeTo(StreamOutput out) throws IOException {
-            super.writeTo(out);
-            shardId.writeTo(out);
-        }
-
-        public ShardId shardId() {
-            return shardId;
-        }
-    }
-
-    /**
-     * Response for first step of synced flush (flush) for one shard copy
-     */
-    static final class PreSyncedFlushResponse extends TransportResponse {
-        static final int UNKNOWN_NUM_DOCS = -1;
-
-        Engine.CommitId commitId;
-        int numDocs;
-        @Nullable String existingSyncId = null;
-
-        PreSyncedFlushResponse(StreamInput in) throws IOException {
-            super(in);
-            commitId = new Engine.CommitId(in);
-            numDocs = in.readInt();
-            existingSyncId = in.readOptionalString();
-        }
-
-        PreSyncedFlushResponse(Engine.CommitId commitId, int numDocs, String existingSyncId) {
-            this.commitId = commitId;
-            this.numDocs = numDocs;
-            this.existingSyncId = existingSyncId;
-        }
-
-        @Override
-        public void writeTo(StreamOutput out) throws IOException {
-            commitId.writeTo(out);
-            out.writeInt(numDocs);
-            out.writeOptionalString(existingSyncId);
-        }
-    }
-
-    public static final class ShardSyncedFlushRequest extends TransportRequest {
-
-        private String syncId;
-        private Engine.CommitId expectedCommitId;
-        private ShardId shardId;
-
-        public ShardSyncedFlushRequest(StreamInput in) throws IOException {
-            super(in);
-            shardId = new ShardId(in);
-            expectedCommitId = new Engine.CommitId(in);
-            syncId = in.readString();
-        }
-
-        public ShardSyncedFlushRequest(ShardId shardId, String syncId, Engine.CommitId expectedCommitId) {
-            this.expectedCommitId = expectedCommitId;
-            this.shardId = shardId;
-            this.syncId = syncId;
-        }
-
-        @Override
-        public void writeTo(StreamOutput out) throws IOException {
-            super.writeTo(out);
-            shardId.writeTo(out);
-            expectedCommitId.writeTo(out);
-            out.writeString(syncId);
-        }
-
-        public ShardId shardId() {
-            return shardId;
-        }
-
-        public String syncId() {
-            return syncId;
-        }
-
-        public Engine.CommitId expectedCommitId() {
-            return expectedCommitId;
-        }
-
-        @Override
-        public String toString() {
-            return "ShardSyncedFlushRequest{" +
-                    "shardId=" + shardId +
-                    ",syncId='" + syncId + '\'' +
-                    '}';
-        }
-    }
-
-    /**
-     * Response for third step of synced flush (writing the sync id) for one shard copy
-     */
-    public static final class ShardSyncedFlushResponse extends TransportResponse {
-
-        /**
-         * a non null value indicates a failure to sync flush. null means success
-         */
-        String failureReason;
-
-        public ShardSyncedFlushResponse(StreamInput in) throws IOException {
-            super(in);
-            failureReason = in.readOptionalString();
-        }
-
-        public ShardSyncedFlushResponse(String failureReason) {
-            this.failureReason = failureReason;
-        }
-
-        @Override
-        public void writeTo(StreamOutput out) throws IOException {
-            out.writeOptionalString(failureReason);
-        }
-
-        public boolean success() {
-            return failureReason == null;
-        }
-
-        public String failureReason() {
-            return failureReason;
-        }
-
-        @Override
-        public String toString() {
-            return "ShardSyncedFlushResponse{" +
-                    "success=" + success() +
-                    ", failureReason='" + failureReason + '\'' +
-                    '}';
-        }
-
-        public static ShardSyncedFlushResponse readSyncedFlushResponse(StreamInput in) throws IOException {
-            return new ShardSyncedFlushResponse(in);
-        }
-    }
-
-
-    public static final class InFlightOpsRequest extends TransportRequest {
-
-        private ShardId shardId;
-
-        public InFlightOpsRequest(StreamInput in) throws IOException {
-            super(in);
-            shardId = new ShardId(in);
-        }
-
-        public InFlightOpsRequest(ShardId shardId) {
-            this.shardId = shardId;
-        }
-
-        @Override
-        public void writeTo(StreamOutput out) throws IOException {
-            super.writeTo(out);
-            shardId.writeTo(out);
-        }
-
-        public ShardId shardId() {
-            return shardId;
-        }
-
-        @Override
-        public String toString() {
-            return "InFlightOpsRequest{" +
-                    "shardId=" + shardId +
-                    '}';
-        }
-    }
-
-    /**
-     * Response for second step of synced flush (check operations in flight)
-     */
-    static final class InFlightOpsResponse extends TransportResponse {
-
-        int opCount;
-
-        InFlightOpsResponse(StreamInput in) throws IOException {
-            super(in);
-            opCount = in.readVInt();
-        }
-
-        InFlightOpsResponse(int opCount) {
-            assert opCount >= 0 : opCount;
-            this.opCount = opCount;
-        }
-
-        @Override
-        public void writeTo(StreamOutput out) throws IOException {
-            out.writeVInt(opCount);
-        }
-
-        public int opCount() {
-            return opCount;
-        }
-
-        @Override
-        public String toString() {
-            return "InFlightOpsResponse{" +
-                    "opCount=" + opCount +
-                    '}';
-        }
-    }
-
-    private final class PreSyncedFlushTransportHandler implements TransportRequestHandler<PreShardSyncedFlushRequest> {
-
-        @Override
-        public void messageReceived(PreShardSyncedFlushRequest request, TransportChannel channel, Task task) throws Exception {
-            channel.sendResponse(performPreSyncedFlush(request));
-        }
-    }
-
-    private final class SyncedFlushTransportHandler implements TransportRequestHandler<ShardSyncedFlushRequest> {
-
-        @Override
-        public void messageReceived(ShardSyncedFlushRequest request, TransportChannel channel, Task task) throws Exception {
-            channel.sendResponse(performSyncedFlush(request));
-        }
-    }
-
-    private final class InFlightOpCountTransportHandler implements TransportRequestHandler<InFlightOpsRequest> {
-
-        @Override
-        public void messageReceived(InFlightOpsRequest request, TransportChannel channel, Task task) throws Exception {
-            channel.sendResponse(performInFlightOps(request));
-        }
-    }
-
-}
diff --git a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestSyncedFlushAction.java b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestSyncedFlushAction.java
index 53cbb5c6d10dd..d775189af48e3 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestSyncedFlushAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestSyncedFlushAction.java
@@ -19,18 +19,23 @@
 
 package org.elasticsearch.rest.action.admin.indices;
 
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushRequest;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.action.admin.indices.flush.FlushRequest;
+import org.elasticsearch.action.admin.indices.flush.FlushResponse;
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.rest.BaseRestHandler;
 import org.elasticsearch.rest.BytesRestResponse;
+import org.elasticsearch.rest.RestChannel;
 import org.elasticsearch.rest.RestController;
 import org.elasticsearch.rest.RestRequest;
 import org.elasticsearch.rest.RestResponse;
-import org.elasticsearch.rest.action.RestBuilderListener;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.rest.action.RestToXContentListener;
 
 import java.io.IOException;
 
@@ -39,6 +44,9 @@
 
 public class RestSyncedFlushAction extends BaseRestHandler {
 
+    private static final Logger logger = LogManager.getLogger(RestSyncedFlushAction.class);
+    private static final DeprecationLogger DEPRECATION_LOGGER = new DeprecationLogger(logger);
+
     public RestSyncedFlushAction(RestController controller) {
         controller.registerHandler(POST, "/_flush/synced", this);
         controller.registerHandler(POST, "/{index}/_flush/synced", this);
@@ -54,17 +62,35 @@ public String getName() {
 
     @Override
     public RestChannelConsumer prepareRequest(final RestRequest request, final NodeClient client) throws IOException {
-        IndicesOptions indicesOptions = IndicesOptions.fromRequest(request, IndicesOptions.lenientExpandOpen());
-        SyncedFlushRequest syncedFlushRequest = new SyncedFlushRequest(Strings.splitStringByCommaToArray(request.param("index")));
-        syncedFlushRequest.indicesOptions(indicesOptions);
-        return channel -> client.admin().indices().syncedFlush(syncedFlushRequest, new RestBuilderListener<SyncedFlushResponse>(channel) {
-            @Override
-            public RestResponse buildResponse(SyncedFlushResponse results, XContentBuilder builder) throws Exception {
-                builder.startObject();
-                results.toXContent(builder, request);
-                builder.endObject();
-                return new BytesRestResponse(results.restStatus(), builder);
-            }
-        });
+        DEPRECATION_LOGGER.deprecatedAndMaybeLog("synced_flush",
+            "Synced flush was removed and a normal flush was performed instead. This transition will be removed in a future version.");
+        final FlushRequest flushRequest = new FlushRequest(Strings.splitStringByCommaToArray(request.param("index")));
+        flushRequest.indicesOptions(IndicesOptions.fromRequest(request, flushRequest.indicesOptions()));
+        return channel -> client.admin().indices().flush(flushRequest, new SimulateSyncedFlushResponseListener(channel));
+    }
+
+    static final class SimulateSyncedFlushResponseListener extends RestToXContentListener<FlushResponse> {
+
+        SimulateSyncedFlushResponseListener(RestChannel channel) {
+            super(channel);
+        }
+
+        @Override
+        public RestResponse buildResponse(FlushResponse flushResponse, XContentBuilder builder) throws Exception {
+            builder.startObject();
+            buildSyncedFlushResponse(builder, flushResponse);
+            builder.endObject();
+            final RestStatus restStatus = flushResponse.getFailedShards() == 0 ? RestStatus.OK : RestStatus.CONFLICT;
+            return new BytesRestResponse(restStatus, builder);
+        }
+
+        private void buildSyncedFlushResponse(XContentBuilder builder, FlushResponse flushResponse) throws IOException {
+            builder.startObject("_shards");
+            builder.field("total", flushResponse.getTotalShards());
+            builder.field("successful", flushResponse.getSuccessfulShards());
+            builder.field("failed", flushResponse.getFailedShards());
+            // can't serialize the detail of each index as we don't have the shard count per index.
+            builder.endObject();
+        }
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushUnitTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushUnitTests.java
deleted file mode 100644
index 5fc8ce5fe3cfd..0000000000000
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/flush/SyncedFlushUnitTests.java
+++ /dev/null
@@ -1,189 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.action.admin.indices.flush;
-
-import com.carrotsearch.hppc.ObjectIntHashMap;
-import com.carrotsearch.hppc.ObjectIntMap;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse.ShardCounts;
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.cluster.routing.ShardRoutingState;
-import org.elasticsearch.cluster.routing.TestShardRouting;
-import org.elasticsearch.common.io.stream.BytesStreamOutput;
-import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.index.shard.ShardId;
-import org.elasticsearch.indices.flush.ShardsSyncedFlushResult;
-import org.elasticsearch.indices.flush.SyncedFlushService;
-import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.test.ESTestCase;
-
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-import static org.elasticsearch.test.XContentTestUtils.convertToMap;
-import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.hasSize;
-
-public class SyncedFlushUnitTests extends ESTestCase {
-
-    private static class TestPlan {
-        public SyncedFlushResponse.ShardCounts totalCounts;
-        public Map<String, SyncedFlushResponse.ShardCounts> countsPerIndex = new HashMap<>();
-        public ObjectIntMap<String> expectedFailuresPerIndex = new ObjectIntHashMap<>();
-        public SyncedFlushResponse result;
-    }
-
-    public void testIndicesSyncedFlushResult() throws IOException {
-        final TestPlan testPlan = createTestPlan();
-        assertThat(testPlan.result.totalShards(), equalTo(testPlan.totalCounts.total));
-        assertThat(testPlan.result.successfulShards(), equalTo(testPlan.totalCounts.successful));
-        assertThat(testPlan.result.failedShards(), equalTo(testPlan.totalCounts.failed));
-        assertThat(testPlan.result.restStatus(), equalTo(testPlan.totalCounts.failed > 0 ? RestStatus.CONFLICT : RestStatus.OK));
-        Map<String, Object> asMap = convertToMap(testPlan.result);
-        assertShardCount("_shards header", (Map<String, Object>) asMap.get("_shards"), testPlan.totalCounts);
-
-        assertThat("unexpected number of indices", asMap.size(), equalTo(1 + testPlan.countsPerIndex.size())); // +1 for the shards header
-        for (String index : testPlan.countsPerIndex.keySet()) {
-            Map<String, Object> indexMap = (Map<String, Object>) asMap.get(index);
-            assertShardCount(index, indexMap, testPlan.countsPerIndex.get(index));
-            List<Map<String, Object>> failureList = (List<Map<String, Object>>) indexMap.get("failures");
-            final int expectedFailures = testPlan.expectedFailuresPerIndex.get(index);
-            if (expectedFailures == 0) {
-                assertNull(index + " has unexpected failures", failureList);
-            } else {
-                assertNotNull(index + " should have failures", failureList);
-                assertThat(failureList, hasSize(expectedFailures));
-            }
-        }
-    }
-
-    public void testResponseStreaming() throws IOException {
-        final TestPlan testPlan = createTestPlan();
-        assertThat(testPlan.result.totalShards(), equalTo(testPlan.totalCounts.total));
-        assertThat(testPlan.result.successfulShards(), equalTo(testPlan.totalCounts.successful));
-        assertThat(testPlan.result.failedShards(), equalTo(testPlan.totalCounts.failed));
-        assertThat(testPlan.result.restStatus(), equalTo(testPlan.totalCounts.failed > 0 ? RestStatus.CONFLICT : RestStatus.OK));
-        BytesStreamOutput out = new BytesStreamOutput();
-        testPlan.result.writeTo(out);
-        StreamInput in = out.bytes().streamInput();
-        SyncedFlushResponse readResponse = new SyncedFlushResponse(in);
-        assertThat(readResponse.totalShards(), equalTo(testPlan.totalCounts.total));
-        assertThat(readResponse.successfulShards(), equalTo(testPlan.totalCounts.successful));
-        assertThat(readResponse.failedShards(), equalTo(testPlan.totalCounts.failed));
-        assertThat(readResponse.restStatus(), equalTo(testPlan.totalCounts.failed > 0 ? RestStatus.CONFLICT : RestStatus.OK));
-        assertThat(readResponse.getShardsResultPerIndex().size(), equalTo(testPlan.result.getShardsResultPerIndex().size()));
-        for (Map.Entry<String, List<ShardsSyncedFlushResult>> entry : readResponse.getShardsResultPerIndex().entrySet()) {
-            List<ShardsSyncedFlushResult> originalShardsResults = testPlan.result.getShardsResultPerIndex().get(entry.getKey());
-            assertNotNull(originalShardsResults);
-            List<ShardsSyncedFlushResult> readShardsResults = entry.getValue();
-            assertThat(readShardsResults.size(), equalTo(originalShardsResults.size()));
-            for (int i = 0; i < readShardsResults.size(); i++) {
-                ShardsSyncedFlushResult originalShardResult = originalShardsResults.get(i);
-                ShardsSyncedFlushResult readShardResult = readShardsResults.get(i);
-                assertThat(originalShardResult.failureReason(), equalTo(readShardResult.failureReason()));
-                assertThat(originalShardResult.failed(), equalTo(readShardResult.failed()));
-                assertThat(originalShardResult.getShardId(), equalTo(readShardResult.getShardId()));
-                assertThat(originalShardResult.successfulShards(), equalTo(readShardResult.successfulShards()));
-                assertThat(originalShardResult.syncId(), equalTo(readShardResult.syncId()));
-                assertThat(originalShardResult.totalShards(), equalTo(readShardResult.totalShards()));
-                assertThat(originalShardResult.failedShards().size(), equalTo(readShardResult.failedShards().size()));
-                for (Map.Entry<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> shardEntry
-                        : originalShardResult.failedShards().entrySet()) {
-                    SyncedFlushService.ShardSyncedFlushResponse readShardResponse = readShardResult.failedShards().get(shardEntry.getKey());
-                    assertNotNull(readShardResponse);
-                    SyncedFlushService.ShardSyncedFlushResponse originalShardResponse = shardEntry.getValue();
-                    assertThat(originalShardResponse.failureReason(), equalTo(readShardResponse.failureReason()));
-                    assertThat(originalShardResponse.success(), equalTo(readShardResponse.success()));
-                }
-                assertThat(originalShardResult.shardResponses().size(), equalTo(readShardResult.shardResponses().size()));
-                for (Map.Entry<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> shardEntry
-                        : originalShardResult.shardResponses().entrySet()) {
-                    SyncedFlushService.ShardSyncedFlushResponse readShardResponse = readShardResult.shardResponses()
-                        .get(shardEntry.getKey());
-                    assertNotNull(readShardResponse);
-                    SyncedFlushService.ShardSyncedFlushResponse originalShardResponse = shardEntry.getValue();
-                    assertThat(originalShardResponse.failureReason(), equalTo(readShardResponse.failureReason()));
-                    assertThat(originalShardResponse.success(), equalTo(readShardResponse.success()));
-                }
-            }
-        }
-    }
-
-    private void assertShardCount(String name, Map<String, Object> header, ShardCounts expectedCounts) {
-        assertThat(name + " has unexpected total count", (Integer) header.get("total"), equalTo(expectedCounts.total));
-        assertThat(name + " has unexpected successful count", (Integer) header.get("successful"), equalTo(expectedCounts.successful));
-        assertThat(name + " has unexpected failed count", (Integer) header.get("failed"), equalTo(expectedCounts.failed));
-    }
-
-    protected TestPlan createTestPlan() {
-        final TestPlan testPlan = new TestPlan();
-        final Map<String, List<ShardsSyncedFlushResult>> indicesResults = new HashMap<>();
-        final int indexCount = randomIntBetween(1, 10);
-        int totalShards = 0;
-        int totalSuccesful = 0;
-        int totalFailed = 0;
-        for (int i = 0; i < indexCount; i++) {
-            final String index = "index_" + i;
-            int shards = randomIntBetween(1, 4);
-            int replicas = randomIntBetween(0, 2);
-            int successful = 0;
-            int failed = 0;
-            int failures = 0;
-            List<ShardsSyncedFlushResult> shardsResults = new ArrayList<>();
-            for (int shard = 0; shard < shards; shard++) {
-                final ShardId shardId = new ShardId(index, "_na_", shard);
-                if (randomInt(5) < 2) {
-                    // total shard failure
-                    failed += replicas + 1;
-                    failures++;
-                    shardsResults.add(new ShardsSyncedFlushResult(shardId, replicas + 1, "simulated total failure"));
-                } else {
-                    Map<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> shardResponses = new HashMap<>();
-                    for (int copy = 0; copy < replicas + 1; copy++) {
-                        final ShardRouting shardRouting = TestShardRouting.newShardRouting(index, shard, "node_" + shardId + "_" + copy,
-                            null, copy == 0, ShardRoutingState.STARTED);
-                        if (randomInt(5) < 2) {
-                            // shard copy failure
-                            failed++;
-                            failures++;
-                            shardResponses.put(shardRouting, new SyncedFlushService.ShardSyncedFlushResponse("copy failure " + shardId));
-                        } else {
-                            successful++;
-                            shardResponses.put(shardRouting, new SyncedFlushService.ShardSyncedFlushResponse((String) null));
-                        }
-                    }
-                    shardsResults.add(new ShardsSyncedFlushResult(shardId, "_sync_id_" + shard, replicas + 1, shardResponses));
-                }
-            }
-            indicesResults.put(index, shardsResults);
-            testPlan.countsPerIndex.put(index, new SyncedFlushResponse.ShardCounts(shards * (replicas + 1), successful, failed));
-            testPlan.expectedFailuresPerIndex.put(index, failures);
-            totalFailed += failed;
-            totalShards += shards * (replicas + 1);
-            totalSuccesful += successful;
-        }
-        testPlan.result = new SyncedFlushResponse(indicesResults);
-        testPlan.totalCounts = new SyncedFlushResponse.ShardCounts(totalShards, totalSuccesful, totalFailed);
-        return testPlan;
-    }
-
-}
diff --git a/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java b/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
index 9868adfe3b86b..cf0c766972e09 100644
--- a/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
@@ -19,7 +19,6 @@
 
 package org.elasticsearch.gateway;
 
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse;
 import org.elasticsearch.action.admin.indices.stats.ShardStats;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.node.DiscoveryNode;
@@ -150,10 +149,6 @@ public void testRecentPrimaryInformation() throws Exception {
 
         indexRandom(randomBoolean(), false, randomBoolean(), IntStream.range(0, between(10, 100))
             .mapToObj(n -> client().prepareIndex(indexName).setSource("f", "v")).collect(Collectors.toList()));
-        assertBusy(() -> {
-            SyncedFlushResponse syncedFlushResponse = client().admin().indices().prepareSyncedFlush(indexName).get();
-            assertThat(syncedFlushResponse.successfulShards(), equalTo(2));
-        });
         internalCluster().stopRandomNode(InternalTestCluster.nameFilter(nodeWithReplica));
         if (randomBoolean()) {
             indexRandom(randomBoolean(), false, randomBoolean(), IntStream.range(0, between(10, 100))
@@ -357,10 +352,11 @@ public void testPeerRecoveryForClosedIndices() throws Exception {
         assertNoOpRecoveries(indexName);
     }
 
-    private void ensureActivePeerRecoveryRetentionLeasesAdvanced(String indexName) throws Exception {
+    public static void ensureActivePeerRecoveryRetentionLeasesAdvanced(String indexName) throws Exception {
+        final ClusterService clusterService = internalCluster().clusterService();
         assertBusy(() -> {
             Index index = resolveIndex(indexName);
-            Set<String> activeRetentionLeaseIds = clusterService().state().routingTable().index(index).shard(0).shards().stream()
+            Set<String> activeRetentionLeaseIds = clusterService.state().routingTable().index(index).shard(0).shards().stream()
                 .map(shardRouting -> ReplicationTracker.getPeerRecoveryRetentionLeaseId(shardRouting.currentNodeId()))
                 .collect(Collectors.toSet());
             for (String node : internalCluster().nodesInclude(indexName)) {
diff --git a/server/src/test/java/org/elasticsearch/indices/cluster/IndicesClusterStateServiceRandomUpdatesTests.java b/server/src/test/java/org/elasticsearch/indices/cluster/IndicesClusterStateServiceRandomUpdatesTests.java
index 71af6ac7f040f..4fc8f4395e56c 100644
--- a/server/src/test/java/org/elasticsearch/indices/cluster/IndicesClusterStateServiceRandomUpdatesTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/cluster/IndicesClusterStateServiceRandomUpdatesTests.java
@@ -514,7 +514,6 @@ private IndicesClusterStateService createIndicesClusterStateService(DiscoveryNod
                 null,
                 null,
                 null,
-                null,
                 primaryReplicaSyncer,
                 RetentionLeaseSyncer.EMPTY,
                 client) {
diff --git a/server/src/test/java/org/elasticsearch/indices/flush/FlushIT.java b/server/src/test/java/org/elasticsearch/indices/flush/FlushIT.java
index 5b4b80aab8c57..ed442fd9cb51a 100644
--- a/server/src/test/java/org/elasticsearch/indices/flush/FlushIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/flush/FlushIT.java
@@ -18,63 +18,34 @@
  */
 package org.elasticsearch.indices.flush;
 
-import org.apache.lucene.index.Term;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
 import org.elasticsearch.action.admin.indices.flush.FlushResponse;
-import org.elasticsearch.action.admin.indices.flush.SyncedFlushResponse;
-import org.elasticsearch.action.admin.indices.stats.IndexStats;
 import org.elasticsearch.action.admin.indices.stats.ShardStats;
-import org.elasticsearch.action.support.ActiveShardCount;
-import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.cluster.routing.allocation.command.MoveAllocationCommand;
-import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.ValidationException;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.unit.ByteSizeUnit;
-import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.IndexSettings;
-import org.elasticsearch.index.engine.Engine;
-import org.elasticsearch.index.engine.InternalEngine;
-import org.elasticsearch.index.engine.InternalEngineTests;
-import org.elasticsearch.index.mapper.ParsedDocument;
-import org.elasticsearch.index.mapper.Uid;
-import org.elasticsearch.index.seqno.SequenceNumbers;
-import org.elasticsearch.index.shard.IndexShard;
-import org.elasticsearch.index.shard.IndexShardTestCase;
-import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.indices.IndexingMemoryController;
-import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.InternalSettingsPlugin;
 import org.elasticsearch.test.InternalTestCluster;
 
-import java.io.IOException;
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.List;
-import java.util.Map;
 import java.util.concurrent.CopyOnWriteArrayList;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
-import java.util.concurrent.atomic.AtomicBoolean;
-import java.util.concurrent.atomic.AtomicInteger;
-import java.util.stream.Collectors;
 
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.emptyArray;
 import static org.hamcrest.Matchers.emptyIterable;
 import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.not;
-import static org.hamcrest.Matchers.nullValue;
 
 @ESIntegTestCase.ClusterScope(scope = ESIntegTestCase.Scope.TEST)
 public class FlushIT extends ESIntegTestCase {
@@ -136,253 +107,6 @@ public void testRejectIllegalFlushParameters() {
             .actionGet().getShardFailures(), emptyArray());
     }
 
-    public void testSyncedFlush() throws Exception {
-        internalCluster().ensureAtLeastNumDataNodes(2);
-        prepareCreate("test").setSettings(Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)).get();
-        ensureGreen();
-
-        final Index index = client().admin().cluster().prepareState().get().getState().metaData().index("test").getIndex();
-
-        IndexStats indexStats = client().admin().indices().prepareStats("test").get().getIndex("test");
-        for (ShardStats shardStats : indexStats.getShards()) {
-            assertNull(shardStats.getCommitStats().getUserData().get(Engine.SYNC_COMMIT_ID));
-        }
-
-        ShardsSyncedFlushResult result;
-        if (randomBoolean()) {
-            logger.info("--> sync flushing shard 0");
-            result = SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), new ShardId(index, 0));
-        } else {
-            logger.info("--> sync flushing index [test]");
-            SyncedFlushResponse indicesResult = client().admin().indices().prepareSyncedFlush("test").get();
-            result = indicesResult.getShardsResultPerIndex().get("test").get(0);
-        }
-        assertFalse(result.failed());
-        assertThat(result.totalShards(), equalTo(indexStats.getShards().length));
-        assertThat(result.successfulShards(), equalTo(indexStats.getShards().length));
-
-        indexStats = client().admin().indices().prepareStats("test").get().getIndex("test");
-        String syncId = result.syncId();
-        for (ShardStats shardStats : indexStats.getShards()) {
-            final String shardSyncId = shardStats.getCommitStats().getUserData().get(Engine.SYNC_COMMIT_ID);
-            assertThat(shardSyncId, equalTo(syncId));
-        }
-
-        // now, start new node and relocate a shard there and see if sync id still there
-        String newNodeName = internalCluster().startNode();
-        ClusterState clusterState = client().admin().cluster().prepareState().get().getState();
-        ShardRouting shardRouting = clusterState.getRoutingTable().index("test").shard(0).iterator().next();
-        String currentNodeName = clusterState.nodes().resolveNode(shardRouting.currentNodeId()).getName();
-        assertFalse(currentNodeName.equals(newNodeName));
-        internalCluster().client().admin().cluster().prepareReroute()
-            .add(new MoveAllocationCommand("test", 0, currentNodeName, newNodeName)).get();
-
-        client().admin().cluster().prepareHealth()
-                .setWaitForNoRelocatingShards(true)
-                .get();
-        indexStats = client().admin().indices().prepareStats("test").get().getIndex("test");
-        for (ShardStats shardStats : indexStats.getShards()) {
-            assertNotNull(shardStats.getCommitStats().getUserData().get(Engine.SYNC_COMMIT_ID));
-        }
-
-        client().admin().indices().prepareUpdateSettings("test").setSettings(Settings.builder()
-            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0).build()).get();
-        ensureGreen("test");
-        indexStats = client().admin().indices().prepareStats("test").get().getIndex("test");
-        for (ShardStats shardStats : indexStats.getShards()) {
-            assertNotNull(shardStats.getCommitStats().getUserData().get(Engine.SYNC_COMMIT_ID));
-        }
-        client().admin().indices().prepareUpdateSettings("test").setSettings(Settings.builder()
-            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, internalCluster().numDataNodes() - 1).build()).get();
-        ensureGreen("test");
-        indexStats = client().admin().indices().prepareStats("test").get().getIndex("test");
-        for (ShardStats shardStats : indexStats.getShards()) {
-            assertNotNull(shardStats.getCommitStats().getUserData().get(Engine.SYNC_COMMIT_ID));
-        }
-    }
-
-    public void testSyncedFlushWithConcurrentIndexing() throws Exception {
-
-        internalCluster().ensureAtLeastNumDataNodes(3);
-        createIndex("test");
-
-        client().admin().indices().prepareUpdateSettings("test").setSettings(
-                Settings.builder()
-                    .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(), new ByteSizeValue(1, ByteSizeUnit.PB))
-                    .put("index.refresh_interval", -1)
-                    .put("index.number_of_replicas", internalCluster().numDataNodes() - 1))
-                .get();
-        ensureGreen();
-        final AtomicBoolean stop = new AtomicBoolean(false);
-        final AtomicInteger numDocs = new AtomicInteger(0);
-        Thread indexingThread = new Thread() {
-            @Override
-            public void run() {
-                while (stop.get() == false) {
-                    client().prepareIndex().setIndex("test").setSource("{}", XContentType.JSON).get();
-                    numDocs.incrementAndGet();
-                }
-            }
-        };
-        indexingThread.start();
-
-        IndexStats indexStats = client().admin().indices().prepareStats("test").get().getIndex("test");
-        for (ShardStats shardStats : indexStats.getShards()) {
-            assertNull(shardStats.getCommitStats().getUserData().get(Engine.SYNC_COMMIT_ID));
-        }
-        logger.info("--> trying sync flush");
-        SyncedFlushResponse syncedFlushResult = client().admin().indices().prepareSyncedFlush("test").get();
-        logger.info("--> sync flush done");
-        stop.set(true);
-        indexingThread.join();
-        indexStats = client().admin().indices().prepareStats("test").get().getIndex("test");
-        assertFlushResponseEqualsShardStats(indexStats.getShards(), syncedFlushResult.getShardsResultPerIndex().get("test"));
-        refresh();
-        assertThat(client().prepareSearch().setSize(0).get().getHits().getTotalHits().value, equalTo((long) numDocs.get()));
-        logger.info("indexed {} docs", client().prepareSearch().setSize(0).get().getHits().getTotalHits().value);
-        logClusterState();
-        internalCluster().fullRestart();
-        ensureGreen();
-        assertThat(client().prepareSearch().setSize(0).get().getHits().getTotalHits().value, equalTo((long) numDocs.get()));
-    }
-
-    private void assertFlushResponseEqualsShardStats(ShardStats[] shardsStats, List<ShardsSyncedFlushResult> syncedFlushResults) {
-
-        for (final ShardStats shardStats : shardsStats) {
-            for (final ShardsSyncedFlushResult shardResult : syncedFlushResults) {
-                if (shardStats.getShardRouting().getId() == shardResult.shardId().getId()) {
-                    for (Map.Entry<ShardRouting, SyncedFlushService.ShardSyncedFlushResponse> singleResponse :
-                        shardResult.shardResponses().entrySet()) {
-                        if (singleResponse.getKey().currentNodeId().equals(shardStats.getShardRouting().currentNodeId())) {
-                            if (singleResponse.getValue().success()) {
-                                logger.info("{} sync flushed on node {}", singleResponse.getKey().shardId(),
-                                    singleResponse.getKey().currentNodeId());
-                                assertNotNull(shardStats.getCommitStats().getUserData().get(Engine.SYNC_COMMIT_ID));
-                            } else {
-                                logger.info("{} sync flush failed for on node {}", singleResponse.getKey().shardId(),
-                                    singleResponse.getKey().currentNodeId());
-                                assertNull(shardStats.getCommitStats().getUserData().get(Engine.SYNC_COMMIT_ID));
-                            }
-                        }
-                    }
-                }
-            }
-        }
-    }
-
-    public void testUnallocatedShardsDoesNotHang() throws InterruptedException {
-        //  create an index but disallow allocation
-        prepareCreate("test").setWaitForActiveShards(ActiveShardCount.NONE).setSettings(Settings.builder()
-            .put("index.routing.allocation.include._name", "nonexistent")).get();
-
-        // this should not hang but instead immediately return with empty result set
-        List<ShardsSyncedFlushResult> shardsResult = client().admin().indices().prepareSyncedFlush("test").get()
-            .getShardsResultPerIndex().get("test");
-        // just to make sure the test actually tests the right thing
-        int numShards = client().admin().indices().prepareGetSettings("test").get().getIndexToSettings().get("test")
-            .getAsInt(IndexMetaData.SETTING_NUMBER_OF_SHARDS, -1);
-        assertThat(shardsResult.size(), equalTo(numShards));
-        assertThat(shardsResult.get(0).failureReason(), equalTo("no active shards"));
-    }
-
-    private void indexDoc(Engine engine, String id) throws IOException {
-        final ParsedDocument doc = InternalEngineTests.createParsedDoc(id, null);
-        final Engine.IndexResult indexResult = engine.index(new Engine.Index(new Term("_id", Uid.encodeId(doc.id())), doc,
-            ((InternalEngine) engine).getProcessedLocalCheckpoint() + 1, 1L, 1L, null, Engine.Operation.Origin.REPLICA, System.nanoTime(),
-            -1L, false, SequenceNumbers.UNASSIGNED_SEQ_NO, 0));
-        assertThat(indexResult.getFailure(), nullValue());
-        engine.syncTranslog();
-    }
-
-    public void testSyncedFlushSkipOutOfSyncReplicas() throws Exception {
-        internalCluster().ensureAtLeastNumDataNodes(between(2, 3));
-        final int numberOfReplicas = internalCluster().numDataNodes() - 1;
-        assertAcked(
-            prepareCreate("test").setSettings(Settings.builder()
-                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, numberOfReplicas)).get()
-        );
-        ensureGreen();
-        final Index index = clusterService().state().metaData().index("test").getIndex();
-        final ShardId shardId = new ShardId(index, 0);
-        final int numDocs = between(1, 10);
-        for (int i = 0; i < numDocs; i++) {
-            indexDoc("test", Integer.toString(i));
-        }
-        final List<IndexShard> indexShards = internalCluster().nodesInclude("test").stream()
-            .map(node -> internalCluster().getInstance(IndicesService.class, node).getShardOrNull(shardId))
-            .collect(Collectors.toList());
-        // Index extra documents to one replica - synced-flush should fail on that replica.
-        final IndexShard outOfSyncReplica = randomValueOtherThanMany(s -> s.routingEntry().primary(), () -> randomFrom(indexShards));
-        final int extraDocs = between(1, 10);
-        for (int i = 0; i < extraDocs; i++) {
-            indexDoc(IndexShardTestCase.getEngine(outOfSyncReplica), "extra_" + i);
-        }
-        final ShardsSyncedFlushResult partialResult = SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), shardId);
-        assertThat(partialResult.totalShards(), equalTo(numberOfReplicas + 1));
-        assertThat(partialResult.successfulShards(), equalTo(numberOfReplicas));
-        assertThat(partialResult.shardResponses().get(outOfSyncReplica.routingEntry()).failureReason, equalTo(
-            "ongoing indexing operations: num docs on replica [" + (numDocs + extraDocs) + "]; num docs on primary [" + numDocs + "]"));
-        // Index extra documents to all shards - synced-flush should be ok.
-        for (IndexShard indexShard : indexShards) {
-            // Do reindex documents to the out of sync replica to avoid trigger merges
-            if (indexShard != outOfSyncReplica) {
-                for (int i = 0; i < extraDocs; i++) {
-                    indexDoc(IndexShardTestCase.getEngine(indexShard), "extra_" + i);
-                }
-            }
-        }
-        final ShardsSyncedFlushResult fullResult = SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), shardId);
-        assertThat(fullResult.totalShards(), equalTo(numberOfReplicas + 1));
-        assertThat(fullResult.successfulShards(), equalTo(numberOfReplicas + 1));
-    }
-
-    public void testDoNotRenewSyncedFlushWhenAllSealed() throws Exception {
-        internalCluster().ensureAtLeastNumDataNodes(between(2, 3));
-        final int numberOfReplicas = internalCluster().numDataNodes() - 1;
-        assertAcked(
-            prepareCreate("test").setSettings(Settings.builder()
-                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, numberOfReplicas)).get()
-        );
-        ensureGreen();
-        final Index index = clusterService().state().metaData().index("test").getIndex();
-        final ShardId shardId = new ShardId(index, 0);
-        final int numDocs = between(1, 10);
-        for (int i = 0; i < numDocs; i++) {
-            indexDoc("test", Integer.toString(i));
-        }
-        final ShardsSyncedFlushResult firstSeal = SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), shardId);
-        assertThat(firstSeal.successfulShards(), equalTo(numberOfReplicas + 1));
-        // Do not renew synced-flush
-        final ShardsSyncedFlushResult secondSeal = SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), shardId);
-        assertThat(secondSeal.successfulShards(), equalTo(numberOfReplicas + 1));
-        assertThat(secondSeal.syncId(), equalTo(firstSeal.syncId()));
-        // Shards were updated, renew synced flush.
-        final int moreDocs = between(1, 10);
-        for (int i = 0; i < moreDocs; i++) {
-            indexDoc("test", "more-" + i);
-        }
-        final ShardsSyncedFlushResult thirdSeal = SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), shardId);
-        assertThat(thirdSeal.successfulShards(), equalTo(numberOfReplicas + 1));
-        assertThat(thirdSeal.syncId(), not(equalTo(firstSeal.syncId())));
-        // Manually remove or change sync-id, renew synced flush.
-        IndexShard shard = internalCluster().getInstance(IndicesService.class, randomFrom(internalCluster().nodesInclude("test")))
-            .getShardOrNull(shardId);
-        if (randomBoolean()) {
-            // Change the existing sync-id of a single shard.
-            shard.syncFlush(UUIDs.randomBase64UUID(random()), shard.commitStats().getRawCommitId());
-            assertThat(shard.commitStats().syncId(), not(equalTo(thirdSeal.syncId())));
-        } else {
-            // Flush will create a new commit without sync-id
-            shard.flush(new FlushRequest(shardId.getIndexName()).force(true).waitIfOngoing(true));
-            assertThat(shard.commitStats().syncId(), nullValue());
-        }
-        final ShardsSyncedFlushResult forthSeal = SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), shardId);
-        assertThat(forthSeal.successfulShards(), equalTo(numberOfReplicas + 1));
-        assertThat(forthSeal.syncId(), not(equalTo(thirdSeal.syncId())));
-    }
-
     public void testFlushOnInactive() throws Exception {
         final String indexName = "flush_on_inactive";
         List<String> dataNodes = internalCluster().startDataOnlyNodes(2, Settings.builder()
diff --git a/server/src/test/java/org/elasticsearch/indices/flush/SyncedFlushSingleNodeTests.java b/server/src/test/java/org/elasticsearch/indices/flush/SyncedFlushSingleNodeTests.java
deleted file mode 100644
index d695e5e612de1..0000000000000
--- a/server/src/test/java/org/elasticsearch/indices/flush/SyncedFlushSingleNodeTests.java
+++ /dev/null
@@ -1,243 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.indices.flush;
-
-import org.elasticsearch.action.support.PlainActionFuture;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.metadata.IndexMetaData;
-import org.elasticsearch.cluster.routing.IndexShardRoutingTable;
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.cluster.service.ClusterService;
-import org.elasticsearch.common.UUIDs;
-import org.elasticsearch.common.lease.Releasable;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.shard.IndexShard;
-import org.elasticsearch.index.shard.ShardId;
-import org.elasticsearch.index.shard.ShardNotFoundException;
-import org.elasticsearch.indices.IndicesService;
-import org.elasticsearch.test.ESSingleNodeTestCase;
-import org.elasticsearch.threadpool.ThreadPool;
-
-import java.util.List;
-import java.util.Map;
-
-import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
-
-public class SyncedFlushSingleNodeTests extends ESSingleNodeTestCase {
-
-    public void testModificationPreventsFlushing() throws InterruptedException {
-        createIndex("test");
-        client().prepareIndex("test").setId("1").setSource("{}", XContentType.JSON).get();
-        IndexService test = getInstanceFromNode(IndicesService.class).indexService(resolveIndex("test"));
-        IndexShard shard = test.getShardOrNull(0);
-
-        SyncedFlushService flushService = getInstanceFromNode(SyncedFlushService.class);
-        final ShardId shardId = shard.shardId();
-        final ClusterState state = getInstanceFromNode(ClusterService.class).state();
-        final IndexShardRoutingTable shardRoutingTable = flushService.getShardRoutingTable(shardId, state);
-        final List<ShardRouting> activeShards = shardRoutingTable.activeShards();
-        assertEquals("exactly one active shard", 1, activeShards.size());
-        Map<String, SyncedFlushService.PreSyncedFlushResponse> preSyncedResponses =
-            SyncedFlushUtil.sendPreSyncRequests(flushService, activeShards, state, shardId);
-        assertEquals("exactly one commit id", 1, preSyncedResponses.size());
-        client().prepareIndex("test").setId("2").setSource("{}", XContentType.JSON).get();
-        String syncId = UUIDs.randomBase64UUID();
-        SyncedFlushUtil.LatchedListener<ShardsSyncedFlushResult> listener = new SyncedFlushUtil.LatchedListener<>();
-        flushService.sendSyncRequests(syncId, activeShards, state, preSyncedResponses, shardId, shardRoutingTable.size(), listener);
-        listener.latch.await();
-        assertNull(listener.error);
-        ShardsSyncedFlushResult syncedFlushResult = listener.result;
-        assertNotNull(syncedFlushResult);
-        assertEquals(0, syncedFlushResult.successfulShards());
-        assertEquals(1, syncedFlushResult.totalShards());
-        assertEquals(syncId, syncedFlushResult.syncId());
-        assertNotNull(syncedFlushResult.shardResponses().get(activeShards.get(0)));
-        assertFalse(syncedFlushResult.shardResponses().get(activeShards.get(0)).success());
-        assertEquals("pending operations", syncedFlushResult.shardResponses().get(activeShards.get(0)).failureReason());
-
-        // pull another commit and make sure we can't sync-flush with the old one
-        SyncedFlushUtil.sendPreSyncRequests(flushService, activeShards, state, shardId);
-        listener = new SyncedFlushUtil.LatchedListener<>();
-        flushService.sendSyncRequests(syncId, activeShards, state, preSyncedResponses, shardId, shardRoutingTable.size(), listener);
-        listener.latch.await();
-        assertNull(listener.error);
-        syncedFlushResult = listener.result;
-        assertNotNull(syncedFlushResult);
-        assertEquals(0, syncedFlushResult.successfulShards());
-        assertEquals(1, syncedFlushResult.totalShards());
-        assertEquals(syncId, syncedFlushResult.syncId());
-        assertNotNull(syncedFlushResult.shardResponses().get(activeShards.get(0)));
-        assertFalse(syncedFlushResult.shardResponses().get(activeShards.get(0)).success());
-        assertEquals("commit has changed", syncedFlushResult.shardResponses().get(activeShards.get(0)).failureReason());
-    }
-
-    public void testSingleShardSuccess() throws InterruptedException {
-        createIndex("test");
-        client().prepareIndex("test").setId("1").setSource("{}", XContentType.JSON).get();
-        IndexService test = getInstanceFromNode(IndicesService.class).indexService(resolveIndex("test"));
-        IndexShard shard = test.getShardOrNull(0);
-
-        SyncedFlushService flushService = getInstanceFromNode(SyncedFlushService.class);
-        final ShardId shardId = shard.shardId();
-        SyncedFlushUtil.LatchedListener<ShardsSyncedFlushResult> listener = new SyncedFlushUtil.LatchedListener<>();
-        flushService.attemptSyncedFlush(shardId, listener);
-        listener.latch.await();
-        assertNull(listener.error);
-        ShardsSyncedFlushResult syncedFlushResult = listener.result;
-        assertNotNull(syncedFlushResult);
-        assertEquals(1, syncedFlushResult.successfulShards());
-        assertEquals(1, syncedFlushResult.totalShards());
-        SyncedFlushService.ShardSyncedFlushResponse response = syncedFlushResult.shardResponses().values().iterator().next();
-        assertTrue(response.success());
-    }
-
-    public void testSyncFailsIfOperationIsInFlight() throws Exception {
-        createIndex("test");
-        client().prepareIndex("test").setId("1").setSource("{}", XContentType.JSON).get();
-        IndexService test = getInstanceFromNode(IndicesService.class).indexService(resolveIndex("test"));
-        IndexShard shard = test.getShardOrNull(0);
-
-        // wait for the GCP sync spawned from the index request above to complete to avoid that request disturbing the check below
-        assertBusy(() -> {
-            assertEquals(0, shard.getLastSyncedGlobalCheckpoint());
-            assertEquals(0, shard.getActiveOperationsCount());
-        });
-
-        SyncedFlushService flushService = getInstanceFromNode(SyncedFlushService.class);
-        final ShardId shardId = shard.shardId();
-        PlainActionFuture<Releasable> fut = new PlainActionFuture<>();
-        shard.acquirePrimaryOperationPermit(fut, ThreadPool.Names.WRITE, "");
-        try (Releasable operationLock = fut.get()) {
-            SyncedFlushUtil.LatchedListener<ShardsSyncedFlushResult> listener = new SyncedFlushUtil.LatchedListener<>();
-            flushService.attemptSyncedFlush(shardId, listener);
-            listener.latch.await();
-            assertNull(listener.error);
-            ShardsSyncedFlushResult syncedFlushResult = listener.result;
-            assertNotNull(syncedFlushResult);
-            assertEquals(0, syncedFlushResult.successfulShards());
-            assertNotEquals(0, syncedFlushResult.totalShards());
-            assertEquals("[1] ongoing operations on primary", syncedFlushResult.failureReason());
-        }
-    }
-
-    public void testSyncFailsOnIndexClosedOrMissing() throws InterruptedException {
-        createIndex("test", Settings.builder()
-            .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
-            .build());
-        IndexService test = getInstanceFromNode(IndicesService.class).indexService(resolveIndex("test"));
-        final IndexShard shard = test.getShardOrNull(0);
-        assertNotNull(shard);
-        final ShardId shardId = shard.shardId();
-
-        final SyncedFlushService flushService = getInstanceFromNode(SyncedFlushService.class);
-
-        SyncedFlushUtil.LatchedListener listener = new SyncedFlushUtil.LatchedListener();
-        flushService.attemptSyncedFlush(new ShardId(shard.shardId().getIndex(), 1), listener);
-        listener.latch.await();
-        assertNotNull(listener.error);
-        assertNull(listener.result);
-        assertEquals(ShardNotFoundException.class, listener.error.getClass());
-        assertEquals("no such shard", listener.error.getMessage());
-
-        assertAcked(client().admin().indices().prepareClose("test"));
-        listener = new SyncedFlushUtil.LatchedListener();
-        flushService.attemptSyncedFlush(shardId, listener);
-        listener.latch.await();
-        assertNotNull(listener.error);
-        assertNull(listener.result);
-        assertEquals("closed", listener.error.getMessage());
-
-        listener = new SyncedFlushUtil.LatchedListener();
-        flushService.attemptSyncedFlush(new ShardId("index not found", "_na_", 0), listener);
-        listener.latch.await();
-        assertNotNull(listener.error);
-        assertNull(listener.result);
-        assertEquals("no such index [index not found]", listener.error.getMessage());
-    }
-
-    public void testFailAfterIntermediateCommit() throws InterruptedException {
-        createIndex("test");
-        client().prepareIndex("test").setId("1").setSource("{}", XContentType.JSON).get();
-        IndexService test = getInstanceFromNode(IndicesService.class).indexService(resolveIndex("test"));
-        IndexShard shard = test.getShardOrNull(0);
-
-        SyncedFlushService flushService = getInstanceFromNode(SyncedFlushService.class);
-        final ShardId shardId = shard.shardId();
-        final ClusterState state = getInstanceFromNode(ClusterService.class).state();
-        final IndexShardRoutingTable shardRoutingTable = flushService.getShardRoutingTable(shardId, state);
-        final List<ShardRouting> activeShards = shardRoutingTable.activeShards();
-        assertEquals("exactly one active shard", 1, activeShards.size());
-        Map<String, SyncedFlushService.PreSyncedFlushResponse> preSyncedResponses =
-            SyncedFlushUtil.sendPreSyncRequests(flushService, activeShards, state, shardId);
-        assertEquals("exactly one commit id", 1, preSyncedResponses.size());
-        if (randomBoolean()) {
-            client().prepareIndex("test").setId("2").setSource("{}", XContentType.JSON).get();
-        }
-        client().admin().indices().prepareFlush("test").setForce(true).get();
-        String syncId = UUIDs.randomBase64UUID();
-        final SyncedFlushUtil.LatchedListener<ShardsSyncedFlushResult> listener = new SyncedFlushUtil.LatchedListener<>();
-        flushService.sendSyncRequests(syncId, activeShards, state, preSyncedResponses, shardId, shardRoutingTable.size(), listener);
-        listener.latch.await();
-        assertNull(listener.error);
-        ShardsSyncedFlushResult syncedFlushResult = listener.result;
-        assertNotNull(syncedFlushResult);
-        assertEquals(0, syncedFlushResult.successfulShards());
-        assertEquals(1, syncedFlushResult.totalShards());
-        assertEquals(syncId, syncedFlushResult.syncId());
-        assertNotNull(syncedFlushResult.shardResponses().get(activeShards.get(0)));
-        assertFalse(syncedFlushResult.shardResponses().get(activeShards.get(0)).success());
-        assertEquals("commit has changed", syncedFlushResult.shardResponses().get(activeShards.get(0)).failureReason());
-    }
-
-    public void testFailWhenCommitIsMissing() throws InterruptedException {
-        createIndex("test");
-        client().prepareIndex("test").setId("1").setSource("{}", XContentType.JSON).get();
-        IndexService test = getInstanceFromNode(IndicesService.class).indexService(resolveIndex("test"));
-        IndexShard shard = test.getShardOrNull(0);
-
-        SyncedFlushService flushService = getInstanceFromNode(SyncedFlushService.class);
-        final ShardId shardId = shard.shardId();
-        final ClusterState state = getInstanceFromNode(ClusterService.class).state();
-        final IndexShardRoutingTable shardRoutingTable = flushService.getShardRoutingTable(shardId, state);
-        final List<ShardRouting> activeShards = shardRoutingTable.activeShards();
-        assertEquals("exactly one active shard", 1, activeShards.size());
-        Map<String, SyncedFlushService.PreSyncedFlushResponse> preSyncedResponses =
-            SyncedFlushUtil.sendPreSyncRequests(flushService, activeShards, state, shardId);
-        assertEquals("exactly one commit id", 1, preSyncedResponses.size());
-        preSyncedResponses.clear(); // wipe it...
-        String syncId = UUIDs.randomBase64UUID();
-        SyncedFlushUtil.LatchedListener<ShardsSyncedFlushResult> listener = new SyncedFlushUtil.LatchedListener<>();
-        flushService.sendSyncRequests(syncId, activeShards, state, preSyncedResponses, shardId, shardRoutingTable.size(), listener);
-        listener.latch.await();
-        assertNull(listener.error);
-        ShardsSyncedFlushResult syncedFlushResult = listener.result;
-        assertNotNull(syncedFlushResult);
-        assertEquals(0, syncedFlushResult.successfulShards());
-        assertEquals(1, syncedFlushResult.totalShards());
-        assertEquals(syncId, syncedFlushResult.syncId());
-        assertNotNull(syncedFlushResult.shardResponses().get(activeShards.get(0)));
-        assertFalse(syncedFlushResult.shardResponses().get(activeShards.get(0)).success());
-        assertEquals("no commit id from pre-sync flush", syncedFlushResult.shardResponses().get(activeShards.get(0)).failureReason());
-    }
-
-
-}
diff --git a/server/src/test/java/org/elasticsearch/indices/flush/SyncedFlushUtil.java b/server/src/test/java/org/elasticsearch/indices/flush/SyncedFlushUtil.java
deleted file mode 100644
index ffb494570a5b9..0000000000000
--- a/server/src/test/java/org/elasticsearch/indices/flush/SyncedFlushUtil.java
+++ /dev/null
@@ -1,110 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-package org.elasticsearch.indices.flush;
-
-import org.apache.logging.log4j.Logger;
-import org.elasticsearch.ExceptionsHelper;
-import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.routing.ShardRouting;
-import org.elasticsearch.index.shard.ShardId;
-import org.elasticsearch.test.InternalTestCluster;
-
-import java.util.List;
-import java.util.Map;
-import java.util.concurrent.CountDownLatch;
-import java.util.concurrent.atomic.AtomicReference;
-
-import static org.elasticsearch.test.ESTestCase.assertBusy;
-
-/** Utils for SyncedFlush */
-public class SyncedFlushUtil {
-
-    private SyncedFlushUtil() {
-
-    }
-
-    /**
-     * Blocking version of {@link SyncedFlushService#attemptSyncedFlush(ShardId, ActionListener)}
-     */
-    public static ShardsSyncedFlushResult attemptSyncedFlush(Logger logger, InternalTestCluster cluster, ShardId shardId) throws Exception {
-        /*
-         * When the last indexing operation is completed, we will fire a global checkpoint sync.
-         * Since a global checkpoint sync request is a replication request, it will acquire an index
-         * shard permit on the primary when executing. If this happens at the same time while we are
-         * issuing the synced-flush, the synced-flush request will fail as it thinks there are
-         * in-flight operations. We can avoid such situation by continuing issuing another synced-flush
-         * if the synced-flush failed due to the ongoing operations on the primary.
-         */
-        SyncedFlushService service = cluster.getInstance(SyncedFlushService.class);
-        AtomicReference<LatchedListener<ShardsSyncedFlushResult>> listenerHolder = new AtomicReference<>();
-        assertBusy(() -> {
-            LatchedListener<ShardsSyncedFlushResult> listener = new LatchedListener<>();
-            listenerHolder.set(listener);
-            service.attemptSyncedFlush(shardId, listener);
-            listener.latch.await();
-            if (listener.result != null && listener.result.failureReason() != null
-                && listener.result.failureReason().contains("ongoing operations on primary")) {
-                throw new AssertionError(listener.result.failureReason()); // cause the assert busy to retry
-            }
-        });
-        if (listenerHolder.get().error != null) {
-            throw ExceptionsHelper.convertToElastic(listenerHolder.get().error);
-        }
-        return listenerHolder.get().result;
-    }
-
-    public static final class LatchedListener<T> implements ActionListener<T> {
-        public volatile T result;
-        public volatile Exception error;
-        public final CountDownLatch latch = new CountDownLatch(1);
-
-        @Override
-        public void onResponse(T result) {
-            this.result = result;
-            latch.countDown();
-        }
-
-        @Override
-        public void onFailure(Exception e) {
-            error = e;
-            latch.countDown();
-        }
-    }
-
-    /**
-     * Blocking version of {@link SyncedFlushService#sendPreSyncRequests(List, ClusterState, ShardId, ActionListener)}
-     */
-    public static Map<String, SyncedFlushService.PreSyncedFlushResponse> sendPreSyncRequests(SyncedFlushService service,
-                                                                                             List<ShardRouting> activeShards,
-                                                                                             ClusterState state,
-                                                                                             ShardId shardId) {
-        LatchedListener<Map<String, SyncedFlushService.PreSyncedFlushResponse>> listener = new LatchedListener<>();
-        service.sendPreSyncRequests(activeShards, state, shardId, listener);
-        try {
-            listener.latch.await();
-        } catch (InterruptedException e) {
-            Thread.currentThread().interrupt();
-        }
-        if (listener.error != null) {
-            throw ExceptionsHelper.convertToElastic(listener.error);
-        }
-        return listener.result;
-    }
-}
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java b/server/src/test/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
index 414df8d648c51..a8b3d82a02989 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
@@ -62,6 +62,7 @@
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.gateway.ReplicaShardAllocatorIT;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.index.IndexSettings;
@@ -78,7 +79,6 @@
 import org.elasticsearch.index.store.Store;
 import org.elasticsearch.indices.IndicesService;
 import org.elasticsearch.indices.analysis.AnalysisModule;
-import org.elasticsearch.indices.flush.SyncedFlushUtil;
 import org.elasticsearch.indices.recovery.RecoveryState.Stage;
 import org.elasticsearch.node.NodeClosedException;
 import org.elasticsearch.node.RecoverySettingsChunkSizePlugin;
@@ -109,7 +109,6 @@
 import java.util.Collection;
 import java.util.List;
 import java.util.Map;
-import java.util.Set;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.Semaphore;
@@ -118,7 +117,6 @@
 import java.util.function.Consumer;
 import java.util.stream.Collectors;
 import java.util.stream.IntStream;
-import java.util.stream.Stream;
 import java.util.stream.StreamSupport;
 
 import static java.util.Collections.singletonMap;
@@ -329,8 +327,19 @@ public void testCancelNewShardRecoveryAndUsesExistingShardCopy() throws Exceptio
         final String nodeA = internalCluster().startNode();
 
         logger.info("--> create index on node: {}", nodeA);
-        createAndPopulateIndex(INDEX_NAME, 1, SHARD_COUNT, REPLICA_COUNT)
-            .getShards()[0].getStats().getStore().size();
+        createIndex(INDEX_NAME, Settings.builder()
+            .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1)
+            .put(IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(), "100ms")
+            .put(IndexService.GLOBAL_CHECKPOINT_SYNC_INTERVAL_SETTING.getKey(), "100ms").build());
+
+        int numDocs = randomIntBetween(10, 200);
+        final IndexRequestBuilder[] docs = new IndexRequestBuilder[numDocs];
+        for (int i = 0; i < numDocs; i++) {
+            docs[i] = client().prepareIndex(INDEX_NAME).
+                setSource("foo-int", randomInt(), "foo-string", randomAlphaOfLength(32), "foo-float", randomFloat());
+        }
+        indexRandom(randomBoolean(), docs);
 
         logger.info("--> start node B");
         // force a shard recovery from nodeA to nodeB
@@ -346,8 +355,7 @@ public void testCancelNewShardRecoveryAndUsesExistingShardCopy() throws Exceptio
         logger.info("--> start node C");
         final String nodeC = internalCluster().startNode();
 
-        // do sync flush to gen sync id
-        assertThat(client().admin().indices().prepareSyncedFlush(INDEX_NAME).get().failedShards(), equalTo(0));
+        ReplicaShardAllocatorIT.ensureActivePeerRecoveryRetentionLeasesAdvanced(INDEX_NAME);
 
         // hold peer recovery on phase 2 after nodeB down
         CountDownLatch phase1ReadyBlocked = new CountDownLatch(1);
@@ -1077,73 +1085,6 @@ public void testOngoingRecoveryAndMasterFailOver() throws Exception {
         ensureGreen(indexName);
     }
 
-    public void testRecoveryFlushReplica() throws Exception {
-        internalCluster().ensureAtLeastNumDataNodes(3);
-        String indexName = "test-index";
-        createIndex(indexName, Settings.builder().put("index.number_of_replicas", 0).put("index.number_of_shards", 1).build());
-        int numDocs = randomIntBetween(0, 10);
-        indexRandom(randomBoolean(), false, randomBoolean(), IntStream.range(0, numDocs)
-            .mapToObj(n -> client().prepareIndex(indexName).setSource("num", n)).collect(toList()));
-        assertAcked(client().admin().indices().prepareUpdateSettings(indexName)
-            .setSettings(Settings.builder().put("index.number_of_replicas", 1)));
-        ensureGreen(indexName);
-        ShardId shardId = null;
-        for (ShardStats shardStats : client().admin().indices().prepareStats(indexName).get().getIndex(indexName).getShards()) {
-            shardId = shardStats.getShardRouting().shardId();
-            if (shardStats.getShardRouting().primary() == false) {
-                assertThat(shardStats.getCommitStats().getNumDocs(), equalTo(numDocs));
-                SequenceNumbers.CommitInfo commitInfo = SequenceNumbers.loadSeqNoInfoFromLuceneCommit(
-                    shardStats.getCommitStats().getUserData().entrySet());
-                assertThat(commitInfo.localCheckpoint, equalTo(shardStats.getSeqNoStats().getLocalCheckpoint()));
-                assertThat(commitInfo.maxSeqNo, equalTo(shardStats.getSeqNoStats().getMaxSeqNo()));
-            }
-        }
-        SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), shardId);
-        assertBusy(() -> assertThat(client().admin().indices().prepareSyncedFlush(indexName).get().failedShards(), equalTo(0)));
-        assertAcked(client().admin().indices().prepareUpdateSettings(indexName)
-            .setSettings(Settings.builder().put("index.number_of_replicas", 2)));
-        ensureGreen(indexName);
-        // Recovery should keep syncId if no indexing activity on the primary after synced-flush.
-        Set<String> syncIds = Stream.of(client().admin().indices().prepareStats(indexName).get().getIndex(indexName).getShards())
-            .map(shardStats -> shardStats.getCommitStats().syncId())
-            .collect(Collectors.toSet());
-        assertThat(syncIds, hasSize(1));
-    }
-
-    public void testRecoveryUsingSyncedFlushWithoutRetentionLease() throws Exception {
-        internalCluster().ensureAtLeastNumDataNodes(2);
-        String indexName = "test-index";
-        createIndex(indexName, Settings.builder()
-            .put("index.number_of_shards", 1)
-            .put("index.number_of_replicas", 1)
-            .put(UnassignedInfo.INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), "24h") // do not reallocate the lost shard
-            .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_LEASE_PERIOD_SETTING.getKey(), "100ms") // expire leases quickly
-            .put(IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(), "100ms") // sync frequently
-            .build());
-        int numDocs = randomIntBetween(0, 10);
-        indexRandom(randomBoolean(), false, randomBoolean(), IntStream.range(0, numDocs)
-            .mapToObj(n -> client().prepareIndex(indexName).setSource("num", n)).collect(toList()));
-        ensureGreen(indexName);
-
-        final ShardId shardId = new ShardId(resolveIndex(indexName), 0);
-        assertThat(SyncedFlushUtil.attemptSyncedFlush(logger, internalCluster(), shardId).successfulShards(), equalTo(2));
-
-        final ClusterState clusterState = client().admin().cluster().prepareState().get().getState();
-        final ShardRouting shardToResync = randomFrom(clusterState.routingTable().shardRoutingTable(shardId).activeShards());
-        internalCluster().restartNode(clusterState.nodes().get(shardToResync.currentNodeId()).getName(),
-            new InternalTestCluster.RestartCallback() {
-                @Override
-                public Settings onNodeStopped(String nodeName) throws Exception {
-                    assertBusy(() -> assertFalse(client().admin().indices().prepareStats(indexName).get()
-                        .getShards()[0].getRetentionLeaseStats().retentionLeases().contains(
-                        ReplicationTracker.getPeerRecoveryRetentionLeaseId(shardToResync))));
-                    return super.onNodeStopped(nodeName);
-                }
-            });
-
-        ensureGreen(indexName);
-    }
-
     public void testRecoverLocallyUpToGlobalCheckpoint() throws Exception {
         internalCluster().ensureAtLeastNumDataNodes(2);
         List<String> nodes = randomSubsetOf(2, StreamSupport.stream(clusterService().state().nodes().getDataNodes().spliterator(), false)
diff --git a/server/src/test/java/org/elasticsearch/indices/state/CloseIndexIT.java b/server/src/test/java/org/elasticsearch/indices/state/CloseIndexIT.java
index 1000a3df4c8d4..ff5a3b3097a61 100644
--- a/server/src/test/java/org/elasticsearch/indices/state/CloseIndexIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/state/CloseIndexIT.java
@@ -404,11 +404,8 @@ public void testRecoverExistingReplica() throws Exception {
         indexRandom(randomBoolean(), randomBoolean(), randomBoolean(), IntStream.range(0, randomIntBetween(0, 50))
             .mapToObj(n -> client().prepareIndex(indexName).setSource("num", n)).collect(toList()));
         ensureGreen(indexName);
-        if (randomBoolean()) {
-            client().admin().indices().prepareFlush(indexName).get();
-        } else {
-            client().admin().indices().prepareSyncedFlush(indexName).get();
-        }
+        client().admin().indices().prepareFlush(indexName).get();
+
         // index more documents while one shard copy is offline
         internalCluster().restartNode(dataNodes.get(1), new InternalTestCluster.RestartCallback() {
             @Override
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
index 03153595dcf18..d36a31a30f59b 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotResiliencyTests.java
@@ -154,7 +154,6 @@
 import org.elasticsearch.indices.analysis.AnalysisModule;
 import org.elasticsearch.indices.breaker.NoneCircuitBreakerService;
 import org.elasticsearch.indices.cluster.IndicesClusterStateService;
-import org.elasticsearch.indices.flush.SyncedFlushService;
 import org.elasticsearch.indices.mapper.MapperRegistry;
 import org.elasticsearch.indices.recovery.PeerRecoverySourceService;
 import org.elasticsearch.indices.recovery.PeerRecoveryTargetService;
@@ -1202,7 +1201,6 @@ public void onFailure(final Exception e) {
                     new NodeMappingRefreshAction(transportService, metaDataMappingService),
                     repositoriesService,
                     mock(SearchService.class),
-                    new SyncedFlushService(indicesService, clusterService, transportService, indexNameExpressionResolver),
                     new PeerRecoverySourceService(transportService, indicesService, recoverySettings),
                     snapshotShardsService,
                     new PrimaryReplicaSyncer(
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESIntegTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESIntegTestCase.java
index 236779306baba..038efa4d4159f 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESIntegTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESIntegTestCase.java
@@ -164,7 +164,6 @@
 import java.util.function.Function;
 import java.util.stream.Collectors;
 
-import static org.elasticsearch.client.Requests.syncedFlushRequest;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_REPLICAS;
 import static org.elasticsearch.cluster.metadata.IndexMetaData.SETTING_NUMBER_OF_SHARDS;
 import static org.elasticsearch.common.unit.TimeValue.timeValueMillis;
@@ -1401,13 +1400,8 @@ private void postIndexAsyncActions(String[] indices, List<CountDownLatch> inFlig
                 client().admin().indices().prepareRefresh(indices).setIndicesOptions(IndicesOptions.lenientExpandOpen()).execute(
                     new LatchedActionListener<>(newLatch(inFlightAsyncOperations)));
             } else if (maybeFlush && rarely()) {
-                if (randomBoolean()) {
-                    client().admin().indices().prepareFlush(indices).setIndicesOptions(IndicesOptions.lenientExpandOpen()).execute(
-                        new LatchedActionListener<>(newLatch(inFlightAsyncOperations)));
-                } else {
-                    client().admin().indices().syncedFlush(syncedFlushRequest(indices).indicesOptions(IndicesOptions.lenientExpandOpen()),
-                        new LatchedActionListener<>(newLatch(inFlightAsyncOperations)));
-                }
+                client().admin().indices().prepareFlush(indices).setIndicesOptions(IndicesOptions.lenientExpandOpen()).execute(
+                    new LatchedActionListener<>(newLatch(inFlightAsyncOperations)));
             } else if (rarely()) {
                 client().admin().indices().prepareForceMerge(indices)
                         .setIndicesOptions(IndicesOptions.lenientExpandOpen())
diff --git a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
index 58144da28d111..7e325b61db9b7 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/InternalTestCluster.java
@@ -79,7 +79,6 @@
 import org.elasticsearch.http.HttpServerTransport;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.engine.CommitStats;
 import org.elasticsearch.index.engine.DocIdSeqNoAndSource;
 import org.elasticsearch.index.engine.Engine;
 import org.elasticsearch.index.engine.EngineTestCase;
@@ -116,7 +115,6 @@
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
-import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Iterator;
 import java.util.List;
@@ -1144,40 +1142,10 @@ public void beforeIndexDeletion() throws Exception {
         // and not all docs have been purged after the test) and inherit from
         // ElasticsearchIntegrationTest must override beforeIndexDeletion() to avoid failures.
         assertNoPendingIndexOperations();
-        //check that shards that have same sync id also contain same number of documents
-        assertSameSyncIdSameDocs();
         assertOpenTranslogReferences();
         assertNoSnapshottedIndexCommit();
     }
 
-    private void assertSameSyncIdSameDocs() {
-        Map<String, Long> docsOnShards = new HashMap<>();
-        final Collection<NodeAndClient> nodesAndClients = nodes.values();
-        for (NodeAndClient nodeAndClient : nodesAndClients) {
-            IndicesService indexServices = getInstance(IndicesService.class, nodeAndClient.name);
-            for (IndexService indexService : indexServices) {
-                for (IndexShard indexShard : indexService) {
-                    try {
-                        CommitStats commitStats = indexShard.commitStats();
-                        String syncId = commitStats.getUserData().get(Engine.SYNC_COMMIT_ID);
-                        if (syncId != null) {
-                            long liveDocsOnShard = commitStats.getNumDocs();
-                            if (docsOnShards.get(syncId) != null) {
-                                assertThat("sync id is equal but number of docs does not match on node "
-                                    + nodeAndClient.name + ". expected " + docsOnShards.get(syncId) + " but got "
-                                    + liveDocsOnShard, docsOnShards.get(syncId), equalTo(liveDocsOnShard));
-                            } else {
-                                docsOnShards.put(syncId, liveDocsOnShard);
-                            }
-                        }
-                    } catch (AlreadyClosedException e) {
-                        // the engine is closed or if the shard is recovering
-                    }
-                }
-            }
-        }
-    }
-
     private void assertNoPendingIndexOperations() throws Exception {
         assertBusy(() -> {
             for (NodeAndClient nodeAndClient : nodes.values()) {
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index 988975619fd89..6ec594a0fdafa 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -54,7 +54,6 @@
 import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.seqno.ReplicationTracker;
-import org.elasticsearch.indices.flush.SyncedFlushService;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.snapshots.SnapshotState;
 import org.elasticsearch.test.ESTestCase;
@@ -1214,18 +1213,60 @@ protected static Version minimumNodeVersion() throws IOException {
         return minVersion;
     }
 
-    protected static Response performSyncedFlush(String indexName) throws IOException {
-        final Request request = new Request("POST", indexName + "/_flush/synced");
-        final List<String> expectedWarnings = Collections.singletonList(SyncedFlushService.SYNCED_FLUSH_DEPRECATION_MESSAGE);
-        if (nodeVersions.stream().allMatch(version -> version.onOrAfter(Version.V_7_6_0))) {
-            final Builder options = RequestOptions.DEFAULT.toBuilder();
-            options.setWarningsHandler(warnings -> warnings.equals(expectedWarnings) == false);
-            request.setOptions(options);
-        } else if (nodeVersions.stream().anyMatch(version -> version.onOrAfter(Version.V_7_6_0))) {
-            final Builder options = RequestOptions.DEFAULT.toBuilder();
-            options.setWarningsHandler(warnings -> warnings.isEmpty() == false && warnings.equals(expectedWarnings) == false);
-            request.setOptions(options);
+    protected void syncedFlush(String indexName) throws Exception {
+        final List<String> deprecationMessages = List.of(
+            "Synced flush is deprecated and will be removed in 8.0. Use flush at _/flush or /{index}/_flush instead.");
+        final List<String> transitionMessages = List.of(
+            "Synced flush was removed and a normal flush was performed instead. This transition will be removed in a future version.");
+        final WarningsHandler warningsHandler;
+        if (minimumNodeVersion().onOrAfter(Version.V_8_0_0)) {
+            warningsHandler = warnings -> warnings.equals(transitionMessages) == false;
+        } else if (minimumNodeVersion().onOrAfter(Version.V_7_6_0)) {
+            warningsHandler = warnings -> warnings.equals(deprecationMessages) == false && warnings.equals(transitionMessages) == false;
+        } else if (nodeVersions.stream().anyMatch(n -> n.onOrAfter(Version.V_8_0_0))) {
+            warningsHandler = warnings -> warnings.isEmpty() == false && warnings.equals(transitionMessages) == false;
+        } else {
+            warningsHandler = warnings -> warnings.isEmpty() == false;
         }
-        return client().performRequest(request);
+        // We have to spin synced-flush requests here because we fire the global checkpoint sync for the last write operation.
+        // A synced-flush request considers the global checkpoint sync as an going operation because it acquires a shard permit.
+        assertBusy(() -> {
+            try {
+                final Request request = new Request("POST", indexName + "/_flush/synced");
+                request.setOptions(RequestOptions.DEFAULT.toBuilder().setWarningsHandler(warningsHandler));
+                Response resp = client().performRequest(request);
+                if (nodeVersions.stream().allMatch(v -> v.before(Version.V_8_0_0))) {
+                    Map<String, Object> result = ObjectPath.createFromResponse(resp).evaluate("_shards");
+                    assertThat(result.get("failed"), equalTo(0));
+                }
+            } catch (ResponseException ex) {
+                if (ex.getResponse().getStatusLine().getStatusCode() == RestStatus.CONFLICT.getStatus()
+                    && ex.getResponse().getWarnings().equals(transitionMessages)) {
+                    logger.info("a normal flush was performed instead");
+                } else {
+                    throw new AssertionError(ex); // cause assert busy to retry
+                }
+            }
+        });
+        // ensure the global checkpoint is synced; otherwise we might trim the commit with syncId
+        ensureGlobalCheckpointSynced(indexName);
+    }
+
+    @SuppressWarnings("unchecked")
+    private void ensureGlobalCheckpointSynced(String index) throws Exception {
+        assertBusy(() -> {
+            Map<?, ?> stats = entityAsMap(client().performRequest(new Request("GET", index + "/_stats?level=shards")));
+            List<Map<?, ?>> shardStats = (List<Map<?, ?>>) XContentMapValues.extractValue("indices." + index + ".shards.0", stats);
+            shardStats.stream()
+                .map(shard -> (Map<?, ?>) XContentMapValues.extractValue("seq_no", shard))
+                .filter(Objects::nonNull)
+                .forEach(seqNoStat -> {
+                    long globalCheckpoint = ((Number) XContentMapValues.extractValue("global_checkpoint", seqNoStat)).longValue();
+                    long localCheckpoint = ((Number) XContentMapValues.extractValue("local_checkpoint", seqNoStat)).longValue();
+                    long maxSeqNo = ((Number) XContentMapValues.extractValue("max_seq_no", seqNoStat)).longValue();
+                    assertThat(shardStats.toString(), localCheckpoint, equalTo(maxSeqNo));
+                    assertThat(shardStats.toString(), globalCheckpoint, equalTo(maxSeqNo));
+                });
+        }, 60, TimeUnit.SECONDS);
     }
 }
diff --git a/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenIndexRecoveryTests.java b/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenIndexRecoveryTests.java
index 6de7952e4d84f..a877159b079cd 100644
--- a/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenIndexRecoveryTests.java
+++ b/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenIndexRecoveryTests.java
@@ -57,11 +57,7 @@ public void testRecoverExistingReplica() throws Exception {
         indexRandom(randomBoolean(), randomBoolean(), randomBoolean(), IntStream.range(0, randomIntBetween(0, 50))
             .mapToObj(n -> client().prepareIndex(indexName).setSource("num", n)).collect(toList()));
         ensureGreen(indexName);
-        if (randomBoolean()) {
-            client().admin().indices().prepareFlush(indexName).get();
-        } else {
-            client().admin().indices().prepareSyncedFlush(indexName).get();
-        }
+        client().admin().indices().prepareFlush(indexName).get();
         // index more documents while one shard copy is offline
         internalCluster().restartNode(dataNodes.get(1), new InternalTestCluster.RestartCallback() {
             @Override
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
index f0ef71c0a6a4c..cd58db91466d2 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/integration/MlDistributedFailureIT.java
@@ -435,7 +435,7 @@ private void run(String jobId, CheckedRunnable<Exception> disrupt) throws Except
         setupJobAndDatafeed(jobId, "data_feed_id", TimeValue.timeValueSeconds(1));
         waitForDatafeed(jobId, numDocs1);
 
-        client().admin().indices().prepareSyncedFlush().get();
+        client().admin().indices().prepareFlush().get();
 
         disrupt.run();
 

From df30a81de7d0f66860c45ebe5ddca08a39153f33 Mon Sep 17 00:00:00 2001
From: Zachary Tong <zach@elastic.co>
Date: Thu, 16 Jan 2020 10:23:24 -0500
Subject: [PATCH 619/686] Mute GeoGridAggregatorTestCase#testBounds()

Tracking issue: https://github.com/elastic/elasticsearch/issues/51103
---
 .../aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
index 085be3855ac9f..15d6f503d03f6 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
@@ -126,6 +126,7 @@ public void testWithSeveralDocs() throws IOException {
         });
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/51103")
     public void testBounds() throws IOException {
         final int numDocs = randomIntBetween(64, 256);
         final GeoGridAggregationBuilder builder = createBuilder("_name");

From e5fb48d889332ff77d310ea800e385c92a348139 Mon Sep 17 00:00:00 2001
From: Mark Tozzi <mark.tozzi@elastic.co>
Date: Thu, 16 Jan 2020 10:53:37 -0500
Subject: [PATCH 620/686] Tests for agg missing values (#51068)

---
 .../geogrid/GeoGridAggregatorTestCase.java    | 19 +++++++++++++--
 .../AutoDateHistogramAggregatorTests.java     | 11 +++++++++
 .../metrics/GeoCentroidAggregatorTests.java   | 24 +++++++++++++++++++
 3 files changed, 52 insertions(+), 2 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
index 15d6f503d03f6..c7cacb0d960a0 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/geogrid/GeoGridAggregatorTestCase.java
@@ -76,7 +76,7 @@ public void testNoDocs() throws IOException {
         });
     }
 
-    public void testFieldMissing() throws IOException {
+    public void testUnmapped() throws IOException {
         testCase(new MatchAllDocsQuery(), "wrong_field", randomPrecision(), null, geoGrid -> {
             assertEquals(0, geoGrid.getBuckets().size());
         }, iw -> {
@@ -84,6 +84,15 @@ public void testFieldMissing() throws IOException {
         });
     }
 
+    public void testUnmappedMissing() throws IOException {
+        GeoGridAggregationBuilder builder = createBuilder("_name")
+            .field("wrong_field")
+            .missing("53.69437,6.475031");
+        testCase(new MatchAllDocsQuery(), randomPrecision(), null, geoGrid -> assertEquals(1, geoGrid.getBuckets().size()),
+            iw -> iw.addDocument(Collections.singleton(new LatLonDocValuesField(FIELD_NAME, 10D, 10D))), builder);
+
+    }
+
     public void testWithSeveralDocs() throws IOException {
         int precision = randomPrecision();
         int numPoints = randomIntBetween(8, 128);
@@ -189,6 +198,13 @@ public void testBounds() throws IOException {
     private void testCase(Query query, String field, int precision, GeoBoundingBox geoBoundingBox,
                           Consumer<InternalGeoGrid<T>> verify,
                           CheckedConsumer<RandomIndexWriter, IOException> buildIndex) throws IOException {
+        testCase(query, precision, geoBoundingBox, verify, buildIndex, createBuilder("_name").field(field));
+    }
+
+    private void testCase(Query query, int precision, GeoBoundingBox geoBoundingBox,
+                          Consumer<InternalGeoGrid<T>> verify,
+                          CheckedConsumer<RandomIndexWriter, IOException> buildIndex,
+                          GeoGridAggregationBuilder aggregationBuilder) throws IOException {
         Directory directory = newDirectory();
         RandomIndexWriter indexWriter = new RandomIndexWriter(random(), directory);
         buildIndex.accept(indexWriter);
@@ -197,7 +213,6 @@ private void testCase(Query query, String field, int precision, GeoBoundingBox g
         IndexReader indexReader = DirectoryReader.open(directory);
         IndexSearcher indexSearcher = newSearcher(indexReader, true, true);
 
-        GeoGridAggregationBuilder aggregationBuilder = createBuilder("_name").field(field);
         aggregationBuilder.precision(precision);
         if (geoBoundingBox != null) {
             aggregationBuilder.setGeoBoundingBox(geoBoundingBox);
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/AutoDateHistogramAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/AutoDateHistogramAggregatorTests.java
index c6bb10fa6c947..05407483a593c 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/AutoDateHistogramAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/AutoDateHistogramAggregatorTests.java
@@ -219,6 +219,17 @@ public void testAggregateWrongField() throws IOException {
         );
     }
 
+    public void testUnmappedMissing() throws IOException {
+        testBothCases(DEFAULT_QUERY, DATES_WITH_TIME,
+            aggregation -> aggregation.setNumBuckets(10).field("wrong_field").missing("2017-12-12"),
+            histogram -> {
+                assertEquals(1, histogram.getBuckets().size());
+                assertTrue(AggregationInspectionHelper.hasValue(histogram));
+            }
+        );
+    }
+
+
     public void testIntervalYear() throws IOException {
 
 
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/GeoCentroidAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/GeoCentroidAggregatorTests.java
index 4acae1764953a..4f27cc1e3099e 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/metrics/GeoCentroidAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/metrics/GeoCentroidAggregatorTests.java
@@ -84,6 +84,30 @@ public void testUnmapped() throws Exception {
         }
     }
 
+    public void testUnmappedWithMissing() throws Exception {
+        try (Directory dir = newDirectory();
+             RandomIndexWriter w = new RandomIndexWriter(random(), dir)) {
+            GeoCentroidAggregationBuilder aggBuilder = new GeoCentroidAggregationBuilder("my_agg")
+                .field("another_field")
+                .missing("53.69437,6.475031");
+
+            GeoPoint expectedCentroid = new GeoPoint(53.69437, 6.475031);
+            Document document = new Document();
+            document.add(new LatLonDocValuesField("field", 10, 10));
+            w.addDocument(document);
+            try (IndexReader reader = w.getReader()) {
+                IndexSearcher searcher = new IndexSearcher(reader);
+
+                MappedFieldType fieldType = new GeoPointFieldMapper.GeoPointFieldType();
+                fieldType.setHasDocValues(true);
+                fieldType.setName("another_field");
+                InternalGeoCentroid result = search(searcher, new MatchAllDocsQuery(), aggBuilder, fieldType);
+                assertEquals(result.centroid(), expectedCentroid);
+                assertTrue(AggregationInspectionHelper.hasValue(result));
+            }
+        }
+    }
+
     public void testSingleValuedField() throws Exception {
         int numDocs = scaledRandomIntBetween(64, 256);
         int numUniqueGeoPoints = randomIntBetween(1, numDocs);

From f4974e93b273332f0849c375bb0c6bcfffa2d14d Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 16 Jan 2020 10:59:18 -0500
Subject: [PATCH 621/686] [DOCS] Fix indent issue in similarity snippet
 (#51107)

Updates snippet to consistently use 2-space indentation. The snippet
previously used a mix of tab/5-space and 2-space indents.

Co-authored-by: Peter Johnson <wiz@wiz.co.nz>

Co-authored-by: Peter Johnson <peter@geocode.earth>
---
 .../index-modules/similarity.asciidoc         | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/reference/index-modules/similarity.asciidoc b/docs/reference/index-modules/similarity.asciidoc
index 3fbbc746b2ed7..9f6ed505eb09f 100644
--- a/docs/reference/index-modules/similarity.asciidoc
+++ b/docs/reference/index-modules/similarity.asciidoc
@@ -22,19 +22,19 @@ settings.
 --------------------------------------------------
 PUT /index
 {
-    "settings" : {
-        "index" : {
-            "similarity" : {
-              "my_similarity" : {
-                "type" : "DFR",
-                "basic_model" : "g",
-                "after_effect" : "l",
-                "normalization" : "h2",
-                "normalization.h2.c" : "3.0"
-              }
-            }
+  "settings": {
+    "index": {
+      "similarity": {
+        "my_similarity": {
+          "type": "DFR",
+          "basic_model": "g",
+          "after_effect": "l",
+          "normalization": "h2",
+          "normalization.h2.c": "3.0"
         }
+      }
     }
+  }
 }
 --------------------------------------------------
 

From a7c7f0eb30f523408b5db21bfe9973eb7a2b837e Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Thu, 16 Jan 2020 17:35:37 +0100
Subject: [PATCH 622/686] Muted test.

See #32299
---
 .../org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java | 1 +
 1 file changed, 1 insertion(+)

diff --git a/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java b/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java
index c7fcf719d5594..d0ca0e8e8219a 100644
--- a/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java
+++ b/x-pack/qa/smoke-test-watcher/src/test/java/org/elasticsearch/smoketest/SmokeTestWatcherTestSuiteIT.java
@@ -109,6 +109,7 @@ protected Settings restAdminSettings() {
         return Settings.builder().put(ThreadContext.PREFIX + ".Authorization", token).build();
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/32299")
     public void testMonitorClusterHealth() throws Exception {
         String watchId = "cluster_health_watch";
 

From 1df8338186051f6fd25cd139b6196c5eb72091bb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Thu, 16 Jan 2020 18:09:04 +0100
Subject: [PATCH 623/686] [ML] Update DFA progress document in the index the
 document belongs to (#51111)

---
 ...rameAnalyticsStatsActionResponseTests.java |  8 +-
 .../ml/dataframe/DataFrameAnalyticsTask.java  | 84 ++++++++++++-----
 .../DataFrameAnalyticsTaskTests.java          | 91 +++++++++++++++++++
 3 files changed, 160 insertions(+), 23 deletions(-)

diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/GetDataFrameAnalyticsStatsActionResponseTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/GetDataFrameAnalyticsStatsActionResponseTests.java
index 8ada940252139..602ebe8543978 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/GetDataFrameAnalyticsStatsActionResponseTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/GetDataFrameAnalyticsStatsActionResponseTests.java
@@ -19,8 +19,7 @@
 
 public class GetDataFrameAnalyticsStatsActionResponseTests extends AbstractWireSerializingTestCase<Response> {
 
-    @Override
-    protected Response createTestInstance() {
+    public static Response randomResponse() {
         int listSize = randomInt(10);
         List<Response.Stats> analytics = new ArrayList<>(listSize);
         for (int j = 0; j < listSize; j++) {
@@ -36,6 +35,11 @@ protected Response createTestInstance() {
         return new Response(new QueryPage<>(analytics, analytics.size(), GetDataFrameAnalyticsAction.Response.RESULTS_FIELD));
     }
 
+    @Override
+    protected Response createTestInstance() {
+        return randomResponse();
+    }
+
     @Override
     protected Writeable.Reader<Response> instanceReader() {
         return Response::new;
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
index df293e6502d22..0ac70286da2a0 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
@@ -8,6 +8,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.logging.log4j.message.ParameterizedMessage;
+import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.cluster.node.tasks.cancel.CancelTasksRequest;
@@ -15,6 +16,10 @@
 import org.elasticsearch.action.admin.cluster.node.tasks.get.GetTaskRequest;
 import org.elasticsearch.action.index.IndexAction;
 import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.action.index.IndexResponse;
+import org.elasticsearch.action.search.SearchAction;
+import org.elasticsearch.action.search.SearchRequest;
+import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.service.ClusterService;
@@ -22,8 +27,10 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
+import org.elasticsearch.index.query.IdsQueryBuilder;
 import org.elasticsearch.index.reindex.BulkByScrollTask;
 import org.elasticsearch.persistent.AllocatedPersistentTask;
+import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.tasks.TaskId;
 import org.elasticsearch.tasks.TaskResult;
 import org.elasticsearch.xpack.core.ml.MlTasks;
@@ -239,35 +246,70 @@ private TaskId getReindexTaskId() {
 
     private void persistProgress(Runnable runnable) {
         LOGGER.debug("[{}] Persisting progress", taskParams.getId());
-        GetDataFrameAnalyticsStatsAction.Request getStatsRequest = new GetDataFrameAnalyticsStatsAction.Request(taskParams.getId());
-        executeAsyncWithOrigin(client, ML_ORIGIN, GetDataFrameAnalyticsStatsAction.INSTANCE, getStatsRequest, ActionListener.wrap(
-            statsResponse -> {
-                GetDataFrameAnalyticsStatsAction.Response.Stats stats = statsResponse.getResponse().results().get(0);
-                IndexRequest indexRequest = new IndexRequest(AnomalyDetectorsIndex.jobStateIndexWriteAlias());
-                indexRequest.id(StoredProgress.documentId(taskParams.getId()));
-                indexRequest.setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
+
+        String progressDocId = StoredProgress.documentId(taskParams.getId());
+        SetOnce<GetDataFrameAnalyticsStatsAction.Response.Stats> stats = new SetOnce<>();
+
+        // Step 4: Run the runnable provided as the argument
+        ActionListener<IndexResponse> indexProgressDocListener = ActionListener.wrap(
+            indexResponse -> {
+                LOGGER.debug("[{}] Successfully indexed progress document", taskParams.getId());
+                runnable.run();
+            },
+            indexError -> {
+                LOGGER.error(new ParameterizedMessage(
+                    "[{}] cannot persist progress as an error occurred while indexing", taskParams.getId()), indexError);
+                runnable.run();
+            }
+        );
+
+        // Step 3: Create or update the progress document:
+        //   - if the document did not exist, create the new one in the current write index
+        //   - if the document did exist, update it in the index where it resides (not necessarily the current write index)
+        ActionListener<SearchResponse> searchFormerProgressDocListener = ActionListener.wrap(
+            searchResponse -> {
+                String indexOrAlias = AnomalyDetectorsIndex.jobStateIndexWriteAlias();
+                if (searchResponse.getHits().getHits().length > 0) {
+                    indexOrAlias = searchResponse.getHits().getHits()[0].getIndex();
+                }
+                IndexRequest indexRequest = new IndexRequest(indexOrAlias)
+                    .id(progressDocId)
+                    .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE);
                 try (XContentBuilder jsonBuilder = JsonXContent.contentBuilder()) {
-                    new StoredProgress(stats.getProgress()).toXContent(jsonBuilder, Payload.XContent.EMPTY_PARAMS);
+                    new StoredProgress(stats.get().getProgress()).toXContent(jsonBuilder, Payload.XContent.EMPTY_PARAMS);
                     indexRequest.source(jsonBuilder);
                 }
-                executeAsyncWithOrigin(client, ML_ORIGIN, IndexAction.INSTANCE, indexRequest, ActionListener.wrap(
-                    indexResponse -> {
-                        LOGGER.debug("[{}] Successfully indexed progress document", taskParams.getId());
-                        runnable.run();
-                    },
-                    indexError -> {
-                        LOGGER.error(new ParameterizedMessage(
-                        "[{}] cannot persist progress as an error occurred while indexing", taskParams.getId()), indexError);
-                        runnable.run();
-                    }
-                ));
+                executeAsyncWithOrigin(client, ML_ORIGIN, IndexAction.INSTANCE, indexRequest, indexProgressDocListener);
             },
             e -> {
                 LOGGER.error(new ParameterizedMessage(
-                "[{}] cannot persist progress as an error occurred while retrieving stats", taskParams.getId()), e);
+                    "[{}] cannot persist progress as an error occurred while retrieving former progress document", taskParams.getId()), e);
                 runnable.run();
             }
-        ));
+        );
+
+        // Step 2: Search for existing progress document in .ml-state*
+        ActionListener<GetDataFrameAnalyticsStatsAction.Response> getStatsListener = ActionListener.wrap(
+            statsResponse -> {
+                stats.set(statsResponse.getResponse().results().get(0));
+                SearchRequest searchRequest =
+                    new SearchRequest(AnomalyDetectorsIndex.jobStateIndexPattern())
+                        .source(
+                            new SearchSourceBuilder()
+                                .size(1)
+                                .query(new IdsQueryBuilder().addIds(progressDocId)));
+                executeAsyncWithOrigin(client, ML_ORIGIN, SearchAction.INSTANCE, searchRequest, searchFormerProgressDocListener);
+            },
+            e -> {
+                LOGGER.error(new ParameterizedMessage(
+                    "[{}] cannot persist progress as an error occurred while retrieving stats", taskParams.getId()), e);
+                runnable.run();
+            }
+        );
+
+        // Step 1: Fetch progress to be persisted
+        GetDataFrameAnalyticsStatsAction.Request getStatsRequest = new GetDataFrameAnalyticsStatsAction.Request(taskParams.getId());
+        executeAsyncWithOrigin(client, ML_ORIGIN, GetDataFrameAnalyticsStatsAction.INSTANCE, getStatsRequest, getStatsListener);
     }
 
     /**
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTaskTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTaskTests.java
index 5874e5c1cb63e..bc3d3c253259c 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTaskTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTaskTests.java
@@ -5,15 +5,43 @@
  */
 package org.elasticsearch.xpack.ml.dataframe;
 
+import org.elasticsearch.Version;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.index.IndexAction;
+import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.action.index.IndexResponse;
+import org.elasticsearch.action.search.SearchAction;
+import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.client.Client;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.search.SearchHit;
+import org.elasticsearch.search.SearchHits;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.core.ml.action.GetDataFrameAnalyticsStatsAction;
+import org.elasticsearch.xpack.core.ml.action.GetDataFrameAnalyticsStatsActionResponseTests;
+import org.elasticsearch.xpack.core.ml.action.StartDataFrameAnalyticsAction.TaskParams;
 import org.elasticsearch.xpack.core.ml.utils.PhaseProgress;
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask.StartingState;
+import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
+import org.mockito.ArgumentCaptor;
+import org.mockito.InOrder;
+import org.mockito.stubbing.Answer;
 
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
+import java.util.Map;
 
 import static org.hamcrest.Matchers.equalTo;
+import static org.mockito.Matchers.any;
+import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.inOrder;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
 
 public class DataFrameAnalyticsTaskTests extends ESTestCase {
 
@@ -87,4 +115,67 @@ public void testDetermineStartingState_GivenEmptyProgress() {
         StartingState startingState = DataFrameAnalyticsTask.determineStartingState("foo", Collections.emptyList());
         assertThat(startingState, equalTo(StartingState.FINISHED));
     }
+
+    private void testMarkAsCompleted(SearchHits searchHits, String expectedIndexOrAlias) {
+        Client client = mock(Client.class);
+        ThreadPool threadPool = mock(ThreadPool.class);
+        when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
+        when(client.threadPool()).thenReturn(threadPool);
+
+        GetDataFrameAnalyticsStatsAction.Response getStatsResponse = GetDataFrameAnalyticsStatsActionResponseTests.randomResponse();
+        doAnswer(withResponse(getStatsResponse)).when(client).execute(eq(GetDataFrameAnalyticsStatsAction.INSTANCE), any(), any());
+
+        SearchResponse searchResponse = mock(SearchResponse.class);
+        when(searchResponse.getHits()).thenReturn(searchHits);
+        doAnswer(withResponse(searchResponse)).when(client).execute(eq(SearchAction.INSTANCE), any(), any());
+
+        IndexResponse indexResponse = mock(IndexResponse.class);
+        doAnswer(withResponse(indexResponse)).when(client).execute(eq(IndexAction.INSTANCE), any(), any());
+
+        TaskParams taskParams = new TaskParams("task_id", Version.CURRENT, Collections.emptyList(), false);
+        DataFrameAnalyticsTask task =
+            new DataFrameAnalyticsTask(
+                0,
+                "",
+                "",
+                null,
+                null,
+                client,
+                mock(ClusterService.class),
+                mock(DataFrameAnalyticsManager.class),
+                mock(DataFrameAnalyticsAuditor.class),
+                taskParams);
+        task.markAsCompleted();
+
+        ArgumentCaptor<IndexRequest> indexRequestCaptor = ArgumentCaptor.forClass(IndexRequest.class);
+
+        InOrder inOrder = inOrder(client);
+        inOrder.verify(client).execute(eq(GetDataFrameAnalyticsStatsAction.INSTANCE), any(), any());
+        inOrder.verify(client).execute(eq(SearchAction.INSTANCE), any(), any());
+        inOrder.verify(client).execute(eq(IndexAction.INSTANCE), indexRequestCaptor.capture(), any());
+        inOrder.verifyNoMoreInteractions();
+
+        IndexRequest indexRequest = indexRequestCaptor.getValue();
+        assertThat(indexRequest.index(), equalTo(expectedIndexOrAlias));
+        assertThat(indexRequest.id(), equalTo("data_frame_analytics-task_id-progress"));
+    }
+
+    public void testMarkAsCompleted_ProgressDocumentCreated() {
+        testMarkAsCompleted(SearchHits.empty(), ".ml-state-write");
+    }
+
+    public void testMarkAsCompleted_ProgressDocumentUpdated() {
+        testMarkAsCompleted(
+            new SearchHits(new SearchHit[]{ SearchHit.createFromMap(Map.of("_index", ".ml-state-dummy")) }, null, 0.0f),
+            ".ml-state-dummy");
+    }
+
+    @SuppressWarnings("unchecked")
+    private static <Response> Answer<Response> withResponse(Response response) {
+        return invocationOnMock -> {
+            ActionListener<Response> listener = (ActionListener<Response>) invocationOnMock.getArguments()[2];
+            listener.onResponse(response);
+            return null;
+        };
+    }
 }

From 94c781abaf3ebf4d6c9e4a8d09435e67dd7e0f4d Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 16 Jan 2020 12:27:54 -0500
Subject: [PATCH 624/686] [DOCS] Retitle analysis reference pages (#51071)

* Changes titles to sentence case.

* Appends pages with 'reference' to differentiate their content from
  conceptual overviews.

* Moves the 'Normalizers' page to end of the Analysis topic pages.
---
 docs/reference/analysis.asciidoc              | 4 ++--
 docs/reference/analysis/analyzers.asciidoc    | 2 +-
 docs/reference/analysis/charfilters.asciidoc  | 2 +-
 docs/reference/analysis/tokenfilters.asciidoc | 2 +-
 docs/reference/analysis/tokenizers.asciidoc   | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/reference/analysis.asciidoc b/docs/reference/analysis.asciidoc
index aaa40c01aea1f..a5625abbd6153 100644
--- a/docs/reference/analysis.asciidoc
+++ b/docs/reference/analysis.asciidoc
@@ -150,11 +150,11 @@ include::analysis/testing.asciidoc[]
 
 include::analysis/analyzers.asciidoc[]
 
-include::analysis/normalizers.asciidoc[]
-
 include::analysis/tokenizers.asciidoc[]
 
 include::analysis/tokenfilters.asciidoc[]
 
 include::analysis/charfilters.asciidoc[]
 
+include::analysis/normalizers.asciidoc[]
+
diff --git a/docs/reference/analysis/analyzers.asciidoc b/docs/reference/analysis/analyzers.asciidoc
index 2fac8fb145590..84b6011a86458 100644
--- a/docs/reference/analysis/analyzers.asciidoc
+++ b/docs/reference/analysis/analyzers.asciidoc
@@ -1,5 +1,5 @@
 [[analysis-analyzers]]
-== Analyzers
+== Built-in analyzer reference
 
 Elasticsearch ships with a wide range of built-in analyzers, which can be used
 in any index without further configuration:
diff --git a/docs/reference/analysis/charfilters.asciidoc b/docs/reference/analysis/charfilters.asciidoc
index 47390fe0ae837..97fe4fd266b3b 100644
--- a/docs/reference/analysis/charfilters.asciidoc
+++ b/docs/reference/analysis/charfilters.asciidoc
@@ -1,5 +1,5 @@
 [[analysis-charfilters]]
-== Character Filters
+== Character filters reference
 
 _Character filters_ are used to preprocess the stream of characters before it
 is passed to the <<analysis-tokenizers,tokenizer>>.
diff --git a/docs/reference/analysis/tokenfilters.asciidoc b/docs/reference/analysis/tokenfilters.asciidoc
index 7172b5e4149b8..46cd0347b72fd 100644
--- a/docs/reference/analysis/tokenfilters.asciidoc
+++ b/docs/reference/analysis/tokenfilters.asciidoc
@@ -1,5 +1,5 @@
 [[analysis-tokenfilters]]
-== Token Filters
+== Token filter reference
 
 Token filters accept a stream of tokens from a
 <<analysis-tokenizers,tokenizer>> and can modify tokens
diff --git a/docs/reference/analysis/tokenizers.asciidoc b/docs/reference/analysis/tokenizers.asciidoc
index f4a8a13aabb0b..830ab3149ce20 100644
--- a/docs/reference/analysis/tokenizers.asciidoc
+++ b/docs/reference/analysis/tokenizers.asciidoc
@@ -1,5 +1,5 @@
 [[analysis-tokenizers]]
-== Tokenizers
+== Tokenizer reference
 
 A _tokenizer_  receives a stream of characters, breaks it up into individual
 _tokens_ (usually individual words), and outputs a stream of _tokens_. For

From 073a113af33b90c5e8f80123425d7cd9f9e2b2f2 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 16 Jan 2020 13:00:04 -0500
Subject: [PATCH 625/686] [DOCS] Add concepts section to analysis topic
 (#50801)

This helps the topic better match the structure of
our machine learning docs, e.g.
https://www.elastic.co/guide/en/machine-learning/7.5/ml-concepts.html

This PR only includes the 'Anatomy of an analyzer' page as a 'Concepts'
child page, but I plan to add other concepts, such as 'Index time vs.
search time', with later PRs.
---
 docs/reference/analysis.asciidoc          |  2 +-
 docs/reference/analysis/anatomy.asciidoc  | 18 +++++-------------
 docs/reference/analysis/concepts.asciidoc | 11 +++++++++++
 3 files changed, 17 insertions(+), 14 deletions(-)
 create mode 100644 docs/reference/analysis/concepts.asciidoc

diff --git a/docs/reference/analysis.asciidoc b/docs/reference/analysis.asciidoc
index a5625abbd6153..17efa15479f86 100644
--- a/docs/reference/analysis.asciidoc
+++ b/docs/reference/analysis.asciidoc
@@ -144,7 +144,7 @@ looking for:
 
 include::analysis/overview.asciidoc[]
 
-include::analysis/anatomy.asciidoc[]
+include::analysis/concepts.asciidoc[]
 
 include::analysis/testing.asciidoc[]
 
diff --git a/docs/reference/analysis/anatomy.asciidoc b/docs/reference/analysis/anatomy.asciidoc
index 729e0f7a27ef8..1db14e787a54a 100644
--- a/docs/reference/analysis/anatomy.asciidoc
+++ b/docs/reference/analysis/anatomy.asciidoc
@@ -1,5 +1,5 @@
 [[analyzer-anatomy]]
-== Anatomy of an analyzer
+=== Anatomy of an analyzer
 
 An _analyzer_  -- whether built-in or custom -- is just a package which
 contains three lower-level building blocks: _character filters_,
@@ -10,8 +10,7 @@ blocks into analyzers suitable for different languages and types of text.
 Elasticsearch also exposes the individual building blocks so that they can be
 combined to define new <<analysis-custom-analyzer,`custom`>> analyzers.
 
-[float]
-=== Character filters
+==== Character filters
 
 A _character filter_ receives the original text as a stream of characters and
 can transform the stream by adding, removing, or changing characters.  For
@@ -22,8 +21,7 @@ elements like `<b>` from the stream.
 An analyzer may have *zero or more* <<analysis-charfilters,character filters>>,
 which are applied in order.
 
-[float]
-=== Tokenizer
+==== Tokenizer
 
 A _tokenizer_  receives a stream of characters, breaks it up into individual
 _tokens_ (usually individual words), and outputs a stream of _tokens_. For
@@ -37,9 +35,7 @@ the term represents.
 
 An analyzer must have *exactly one* <<analysis-tokenizers,tokenizer>>.
 
-
-[float]
-=== Token filters
+==== Token filters
 
 A _token filter_ receives the token stream and may add, remove, or change
 tokens.  For example, a <<analysis-lowercase-tokenfilter,`lowercase`>> token
@@ -53,8 +49,4 @@ Token filters are not allowed to change the position or character offsets of
 each token.
 
 An analyzer may have *zero or more* <<analysis-tokenfilters,token filters>>,
-which are applied in order.
-
-
-
-
+which are applied in order.
\ No newline at end of file
diff --git a/docs/reference/analysis/concepts.asciidoc b/docs/reference/analysis/concepts.asciidoc
new file mode 100644
index 0000000000000..451b23c49d7e9
--- /dev/null
+++ b/docs/reference/analysis/concepts.asciidoc
@@ -0,0 +1,11 @@
+[[analysis-concepts]]
+== Text analysis concepts
+++++
+<titleabbrev>Concepts</titleabbrev>
+++++
+
+This section explains the fundamental concepts of text analysis in {es}.
+
+* <<analyzer-anatomy>>
+
+include::anatomy.asciidoc[]
\ No newline at end of file

From 167e9085d5d079df96b1cfba44aa31f96ebc6c0d Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 16 Jan 2020 13:11:42 -0500
Subject: [PATCH 626/686] [DOCS] Add tutorials section to analysis topic
 (#50809)

Adds a 'Configure text analysis' page to house tutorial content for the
analysis topic.

Also relocates the following pages as children as this new page:

* 'Test an analyzer'
* 'Configuring built-in analyzers'
* 'Create a custom analyzer'

I plan to add a tutorial for specifying index-time and search-time
analyzers to this section as part of a future PR.
---
 docs/reference/analysis.asciidoc              |  2 +-
 docs/reference/analysis/analyzers.asciidoc    |  6 +---
 .../analyzers/custom-analyzer.asciidoc        |  2 +-
 .../analysis/configure-text-analysis.asciidoc | 29 +++++++++++++++++++
 docs/reference/analysis/testing.asciidoc      |  3 +-
 5 files changed, 34 insertions(+), 8 deletions(-)
 create mode 100644 docs/reference/analysis/configure-text-analysis.asciidoc

diff --git a/docs/reference/analysis.asciidoc b/docs/reference/analysis.asciidoc
index 17efa15479f86..6a1d31dbef3e7 100644
--- a/docs/reference/analysis.asciidoc
+++ b/docs/reference/analysis.asciidoc
@@ -146,7 +146,7 @@ include::analysis/overview.asciidoc[]
 
 include::analysis/concepts.asciidoc[]
 
-include::analysis/testing.asciidoc[]
+include::analysis/configure-text-analysis.asciidoc[]
 
 include::analysis/analyzers.asciidoc[]
 
diff --git a/docs/reference/analysis/analyzers.asciidoc b/docs/reference/analysis/analyzers.asciidoc
index 84b6011a86458..fe527b56bb69a 100644
--- a/docs/reference/analysis/analyzers.asciidoc
+++ b/docs/reference/analysis/analyzers.asciidoc
@@ -54,8 +54,6 @@ If you do not find an analyzer suitable for your needs, you can create a
 <<analysis-tokenizers,tokenizer>>, and <<analysis-tokenfilters,token filters>>.
 
 
-include::analyzers/configuring.asciidoc[]
-
 include::analyzers/fingerprint-analyzer.asciidoc[]
 
 include::analyzers/keyword-analyzer.asciidoc[]
@@ -70,6 +68,4 @@ include::analyzers/standard-analyzer.asciidoc[]
 
 include::analyzers/stop-analyzer.asciidoc[]
 
-include::analyzers/whitespace-analyzer.asciidoc[]
-
-include::analyzers/custom-analyzer.asciidoc[]
+include::analyzers/whitespace-analyzer.asciidoc[]
\ No newline at end of file
diff --git a/docs/reference/analysis/analyzers/custom-analyzer.asciidoc b/docs/reference/analysis/analyzers/custom-analyzer.asciidoc
index f29a314a4f42b..e7907f7e4bb73 100644
--- a/docs/reference/analysis/analyzers/custom-analyzer.asciidoc
+++ b/docs/reference/analysis/analyzers/custom-analyzer.asciidoc
@@ -1,5 +1,5 @@
 [[analysis-custom-analyzer]]
-=== Custom Analyzer
+=== Create a custom analyzer
 
 When the built-in analyzers do not fulfill your needs, you can create a
 `custom` analyzer which uses the appropriate combination of:
diff --git a/docs/reference/analysis/configure-text-analysis.asciidoc b/docs/reference/analysis/configure-text-analysis.asciidoc
new file mode 100644
index 0000000000000..3e9721bf65d84
--- /dev/null
+++ b/docs/reference/analysis/configure-text-analysis.asciidoc
@@ -0,0 +1,29 @@
+[[configure-text-analysis]]
+== Configure text analysis
+
+By default, {es} uses the <<analysis-standard-analyzer,`standard` analyzer>> for
+all text analysis. The `standard` analyzer gives you out-of-the-box support for
+most natural languages and use cases. If you chose to use the `standard`
+analyzer as-is, no further configuration is needed.
+
+If the standard analyzer does not fit your needs, review and test {es}'s other
+built-in <<analysis-analyzers,built-in analyzers>>. Built-in analyzers don't
+require configuration, but some support options that can be used to adjust their
+behavior. For example, you can configure the `standard` analyzer with a list of
+custom stop words to remove.
+
+If no built-in analyzer fits your needs, you can test and create a custom
+analyzer. Custom analyzers involve selecting and combining different
+<<analyzer-anatomy,analyzer components>>, giving you greater control over
+the process.
+
+* <<test-analyzer>>
+* <<configuring-analyzers>>
+* <<analysis-custom-analyzer>>
+
+
+include::testing.asciidoc[]
+
+include::analyzers/configuring.asciidoc[]
+
+include::analyzers/custom-analyzer.asciidoc[]
\ No newline at end of file
diff --git a/docs/reference/analysis/testing.asciidoc b/docs/reference/analysis/testing.asciidoc
index 092a7aa70ee1b..a4ae7a555f271 100644
--- a/docs/reference/analysis/testing.asciidoc
+++ b/docs/reference/analysis/testing.asciidoc
@@ -1,4 +1,5 @@
-== Testing analyzers
+[[test-analyzer]]
+=== Test an analyzer
 
 The <<indices-analyze,`analyze` API>> is an invaluable tool for viewing the
 terms produced by an analyzer. A built-in analyzer (or combination of built-in

From 21b9c614063a36624ea238e0aa925fa8277b2e65 Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 16 Jan 2020 13:18:36 -0500
Subject: [PATCH 627/686] [DOCS] Collapse node stats response sections (#51063)

elastic/docs#1687 added support for the `[%collapsible]` Asciidoc
attribute, which creates collapsible sections in the HTML output.

This PR makes two related changes to the nodes stats API documentation:

* Makes the response parameter sections collapsible. This allows users
  to more easily navigate the page without long walls of text.

* Reorders the response parameter sections to match the default order
  returned by the API.

Relates to #47524.
---
 docs/reference/cluster/nodes-stats.asciidoc | 212 ++++++++++++--------
 1 file changed, 125 insertions(+), 87 deletions(-)

diff --git a/docs/reference/cluster/nodes-stats.asciidoc b/docs/reference/cluster/nodes-stats.asciidoc
index ed04e1b085594..649c491acf96d 100644
--- a/docs/reference/cluster/nodes-stats.asciidoc
+++ b/docs/reference/cluster/nodes-stats.asciidoc
@@ -140,6 +140,8 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=include-segment-file-sizes]
 [[cluster-nodes-stats-api-response-body-indices]]
 ===== `indices` section
 
+[%collapsible]
+====
 `indices.docs.count`::
 (integer)
 include::{docdir}/rest-api/common-parms.asciidoc[tag=docs-count]
@@ -536,97 +538,13 @@ that used an index shard as a target.
 (integer)
 Time in milliseconds
 recovery operations were delayed due to throttling.
-
-[[cluster-nodes-stats-api-response-body-fs]]
-===== `fs` section
-
-`fs.timestamp`::
-    Last time the file stores statistics have been refreshed.
-
-`fs.total.total_in_bytes`::
-    Total size (in bytes) of all file stores.
-
-`fs.total.free_in_bytes`::
-    Total number of unallocated bytes in all file stores.
-
-`fs.total.available_in_bytes`::
-    Total number of bytes available to this Java virtual machine on all file 
-    stores. Depending on OS or process level restrictions, this might appear 
-    less than `fs.total.free_in_bytes`. This is the actual amount of free disk 
-    space the {es} node can utilise.
-
-`fs.data`::
-    List of all file stores.
-
-`fs.data.path`::
-    Path to the file store.
-
-`fs.data.mount`::
-    Mount point of the file store (ex: /dev/sda2).
-
-`fs.data.type`::
-    Type of the file store (ex: ext4).
-
-`fs.data.total_in_bytes`::
-    Total size (in bytes) of the file store.
-
-`fs.data.free_in_bytes`::
-    Total number of unallocated bytes in the file store.
-
-`fs.data.available_in_bytes`::
-    Total number of bytes available to this Java virtual machine on this file 
-    store.
-
-`fs.io_stats.devices` (Linux only)::
-    Array of disk metrics for each device that is backing an {es} data path. 
-    These disk metrics are probed periodically and averages between the last 
-    probe and the current probe are computed.
-
-`fs.io_stats.devices.device_name` (Linux only)::
-    The Linux device name.
-
-`fs.io_stats.devices.operations` (Linux only)::
-    The total number of read and write operations for the device completed since 
-    starting {es}.
-
-`fs.io_stats.devices.read_operations` (Linux only)::
-    The total number of read operations for the device completed since starting 
-    {es}.
-
-`fs.io_stats.devices.write_operations` (Linux only)::
-    The total number of write operations for the device completed since starting 
-    {es}.
-
-`fs.io_stats.devices.read_kilobytes` (Linux only)::
-    The total number of kilobytes read for the device since starting {es}.
-
-`fs.io_stats.devices.write_kilobytes` (Linux only)::
-    The total number of kilobytes written for the device since starting {es}.
-
-`fs.io_stats.operations` (Linux only)::
-    The total number of read and write operations across all devices used by 
-    {es} completed since starting {es}.
-
-`fs.io_stats.read_operations` (Linux only)::
-    The total number of read operations for across all devices used by {es} 
-    completed since starting {es}.
-
-`fs.io_stats.write_operations` (Linux only)::
-    The total number of write operations across all devices used by {es} 
-    completed since starting {es}.
-
-`fs.io_stats.read_kilobytes` (Linux only)::
-    The total number of kilobytes read across all devices used by {es} since 
-    starting {es}.
-
-`fs.io_stats.write_kilobytes` (Linux only)::
-    The total number of kilobytes written across all devices used by {es} since 
-    starting {es}.
-
+====
 
 [[cluster-nodes-stats-api-response-body-os]]
 ===== `os` section
 
+[%collapsible]
+====
 `os.timestamp`::
     Last time the operating system statistics have been refreshed.
 
@@ -720,10 +638,13 @@ recovery operations were delayed due to throttling.
 NOTE: For the cgroup stats to be visible, cgroups must be compiled into the 
 kernel, the `cpu` and `cpuacct` cgroup subsystems must be configured and stats 
 must be readable from `/sys/fs/cgroup/cpu` and `/sys/fs/cgroup/cpuacct`.
+====
 
 [[cluster-nodes-stats-api-response-body-process]]
 ===== `process` section
 
+[%collapsible]
+====
 `process.timestamp`::
     Last time the process statistics have been refreshed.
 
@@ -745,10 +666,13 @@ must be readable from `/sys/fs/cgroup/cpu` and `/sys/fs/cgroup/cpuacct`.
 `process.mem.total_virtual_in_bytes`::
     Size in bytes of virtual memory that is guaranteed to be available to the 
     running process.
+====
 
 [[cluster-nodes-stats-api-response-body-jvm]]
 ===== `jvm` section
 
+[%collapsible]
+====
 `jvm.timestamp`::
 (integer)
 Last time JVM statistics were refreshed.
@@ -894,10 +818,13 @@ Total number of buffer pool classes loaded since the JVM started.
 `jvm.classes.total_unloaded_count`::
 (integer)
 Total number of buffer pool classes unloaded since the JVM started.
+====
 
 [[cluster-nodes-stats-api-response-body-threadpool]]
 ===== `thread_pool` section
 
+[%collapsible]
+====
 `thread_pool.<thread_pool_name>.threads`::
 (integer)
 Number of threads in the thread pool.
@@ -921,10 +848,102 @@ Highest number of active threads in the thread pool.
 `thread_pool.<thread_pool_name>.completed`::
 (integer)
 Number of tasks completed by the thread pool executor.
+====
+
+[[cluster-nodes-stats-api-response-body-fs]]
+===== `fs` section
+
+[%collapsible]
+====
+`fs.timestamp`::
+    Last time the file stores statistics have been refreshed.
+
+`fs.total.total_in_bytes`::
+    Total size (in bytes) of all file stores.
+
+`fs.total.free_in_bytes`::
+    Total number of unallocated bytes in all file stores.
+
+`fs.total.available_in_bytes`::
+    Total number of bytes available to this Java virtual machine on all file 
+    stores. Depending on OS or process level restrictions, this might appear 
+    less than `fs.total.free_in_bytes`. This is the actual amount of free disk 
+    space the {es} node can utilise.
+
+`fs.data`::
+    List of all file stores.
+
+`fs.data.path`::
+    Path to the file store.
+
+`fs.data.mount`::
+    Mount point of the file store (ex: /dev/sda2).
+
+`fs.data.type`::
+    Type of the file store (ex: ext4).
+
+`fs.data.total_in_bytes`::
+    Total size (in bytes) of the file store.
+
+`fs.data.free_in_bytes`::
+    Total number of unallocated bytes in the file store.
+
+`fs.data.available_in_bytes`::
+    Total number of bytes available to this Java virtual machine on this file 
+    store.
+
+`fs.io_stats.devices` (Linux only)::
+    Array of disk metrics for each device that is backing an {es} data path. 
+    These disk metrics are probed periodically and averages between the last 
+    probe and the current probe are computed.
+
+`fs.io_stats.devices.device_name` (Linux only)::
+    The Linux device name.
+
+`fs.io_stats.devices.operations` (Linux only)::
+    The total number of read and write operations for the device completed since 
+    starting {es}.
+
+`fs.io_stats.devices.read_operations` (Linux only)::
+    The total number of read operations for the device completed since starting 
+    {es}.
+
+`fs.io_stats.devices.write_operations` (Linux only)::
+    The total number of write operations for the device completed since starting 
+    {es}.
+
+`fs.io_stats.devices.read_kilobytes` (Linux only)::
+    The total number of kilobytes read for the device since starting {es}.
+
+`fs.io_stats.devices.write_kilobytes` (Linux only)::
+    The total number of kilobytes written for the device since starting {es}.
+
+`fs.io_stats.operations` (Linux only)::
+    The total number of read and write operations across all devices used by 
+    {es} completed since starting {es}.
+
+`fs.io_stats.read_operations` (Linux only)::
+    The total number of read operations for across all devices used by {es} 
+    completed since starting {es}.
+
+`fs.io_stats.write_operations` (Linux only)::
+    The total number of write operations across all devices used by {es} 
+    completed since starting {es}.
+
+`fs.io_stats.read_kilobytes` (Linux only)::
+    The total number of kilobytes read across all devices used by {es} since 
+    starting {es}.
+
+`fs.io_stats.write_kilobytes` (Linux only)::
+    The total number of kilobytes written across all devices used by {es} since 
+    starting {es}.
+====
 
 [[cluster-nodes-stats-api-response-body-transport]]
 ===== `transport` section
 
+[%collapsible]
+====
 `transport.server_open`::
 (integer)
 Number of open TCP connections used for internal communication between nodes.
@@ -948,10 +967,13 @@ communication.
 (integer)
 Size, in bytes, of TX packets sent by the node during internal cluster
 communication.
+====
 
 [[cluster-nodes-stats-api-response-body-http]]
 ===== `http` section
 
+[%collapsible]
+====
 `http.current_open`::
 (integer)
 Current number of open HTTP connections for the node.
@@ -959,10 +981,13 @@ Current number of open HTTP connections for the node.
 `http.total_opened`::
 (integer)
 Total number of HTTP connections opened for the node.
+====
 
 [[cluster-nodes-stats-api-response-body-breakers]]
 ===== `breakers` section
 
+[%collapsible]
+====
 `breakers.<circuit_breaker_name>.limit_size_in_bytes`::
 (integer)
 Memory limit, in bytes, for the circuit breaker.
@@ -988,10 +1013,13 @@ calculate a final estimate.
 (integer)
 Total number of times the circuit breaker has been triggered and prevented an
 out of memory error.
+====
 
 [[cluster-nodes-stats-api-response-body-script]]
 ===== `script` section
 
+[%collapsible]
+====
 `script.compilations`::
 (integer)
 Total number of inline script compilations performed by the node.
@@ -1004,10 +1032,13 @@ Total number of times the script cache has evicted old data.
 (integer)
 Total number of times the <<script-compilation-circuit-breaker,script
 compilation>> circuit breaker has limited inline script compilations.
+====
 
 [[cluster-nodes-stats-api-response-body-discovery]]
 ===== `discovery` section
 
+[%collapsible]
+====
 `discovery.cluster_state_queue.total`::
 (integer)
 Total number of cluster states in queue.
@@ -1031,10 +1062,13 @@ Number of incompatible differences between published cluster states.
 `discovery.published_cluster_states.compatible_diffs`::
 (integer)
 Number of compatible differences between published cluster states.
+====
 
 [[cluster-nodes-stats-api-response-body-ingest]]
 ===== `ingest` section
 
+[%collapsible]
+====
 `ingest.total.count`::
     (integer)
     Total number of documents ingested during the lifetime of this node.
@@ -1079,10 +1113,13 @@ Number of compatible differences between published cluster states.
 `ingest.pipelines.<pipeline_id>.<processor>.failed`::
     (integer)
     Number of failed operations for the processor.
+====
 
 [[cluster-nodes-stats-api-response-body-adaptive-selection]]
 ===== `adaptive_selection` section
 
+[%collapsible]
+====
 The `adaptive_selection` statistics are keyed by node. For each node:
 
 `adaptive_selection.outgoing_searches`::
@@ -1104,6 +1141,7 @@ The `adaptive_selection` statistics are keyed by node. For each node:
 `rank`::
     The rank of this node; used for shard selection when routing search 
     requests.
+====
 
 
 [[cluster-nodes-stats-api-example]]

From f6942e7f85d105351d4f078257f7b369e290a504 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Thu, 16 Jan 2020 11:08:07 -0800
Subject: [PATCH 628/686] Upgrade to Gradle 6.1 (#50453)

---
 .ci/java-versions.properties                  |   3 ---
 .../src/main/resources/minimumGradleVersion   |   2 +-
 distribution/bwc/build.gradle                 |   6 ------
 gradle/wrapper/gradle-wrapper.jar             | Bin 58702 -> 58695 bytes
 gradle/wrapper/gradle-wrapper.properties      |   4 ++--
 5 files changed, 3 insertions(+), 12 deletions(-)

diff --git a/.ci/java-versions.properties b/.ci/java-versions.properties
index f5c4978113ba3..46f7eab9cde60 100644
--- a/.ci/java-versions.properties
+++ b/.ci/java-versions.properties
@@ -7,6 +7,3 @@
 ES_BUILD_JAVA=openjdk13
 ES_RUNTIME_JAVA=openjdk11
 GRADLE_TASK=build
-
-# Workaround for https://github.com/gradle/gradle/issues/11426
-OPENSHIFT_IP=0.0.0.0
diff --git a/buildSrc/src/main/resources/minimumGradleVersion b/buildSrc/src/main/resources/minimumGradleVersion
index 6d54bbd77512d..e8f1734af0f2f 100644
--- a/buildSrc/src/main/resources/minimumGradleVersion
+++ b/buildSrc/src/main/resources/minimumGradleVersion
@@ -1 +1 @@
-6.0.1
\ No newline at end of file
+6.1
\ No newline at end of file
diff --git a/distribution/bwc/build.gradle b/distribution/bwc/build.gradle
index dca0d18ac4aee..e8ad7121c4a4a 100644
--- a/distribution/bwc/build.gradle
+++ b/distribution/bwc/build.gradle
@@ -162,12 +162,6 @@ bwcVersions.forPreviousUnreleased { BwcVersions.UnreleasedVersionInfo unreleased
         spoolOutput = true
         workingDir = checkoutDir
         doFirst {
-          // TODO: Remove this once we've updated to Gradle 6.1
-          // Workaround for https://github.com/gradle/gradle/issues/11426
-          if (GradleVersion.version(file("${ checkoutDir}/buildSrc/src/main/resources/minimumGradleVersion").text) != GradleVersion.current()) {
-            environment = environment.findAll { key, val -> key != 'OPENSHIFT_IP' }
-          }
-
           // Execution time so that the checkouts are available
           List<String> lines = file("${checkoutDir}/.ci/java-versions.properties").readLines()
           environment(
diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar
index cc4fdc293d0e50b0ad9b65c16e7ddd1db2f6025b..f3d88b1c2faf2fc91d853cd5d4242b5547257070 100644
GIT binary patch
delta 12333
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

delta 12451
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

diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index ba9078ad2addb..22ff086ed7d3d 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.0.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.1-all.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionSha256Sum=6f6cfdbb12a577c3845522a1c7fbfe1295ea05d87edabedd4e23fd2bf02b88b1
+distributionSha256Sum=634f972af958e3c753aeb42d7a688fab6820b527a0aef9eed03d7f3f6f9c7c06

From d0fefc58f26ef4663d85f79e348756c3520e6e71 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 16 Jan 2020 20:38:19 +0100
Subject: [PATCH 629/686] Fix X-Pack Indices Breaking Repository BwC Tests
 (#51120)

If some internal `.watcher` or so index gets created during these tests
then the shard counts on snapshot restores and creates won't match up with expectations.
Fixed by only creating the snapshot for the test index

Closes #50819
---
 .../MultiVersionRepositoryAccessIT.java       | 27 ++++++++++---------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java b/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
index 57c38e5cff267..f0735025b44e8 100644
--- a/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
+++ b/qa/repository-multi-version/src/test/java/org/elasticsearch/upgrades/MultiVersionRepositoryAccessIT.java
@@ -115,13 +115,14 @@ public void testCreateAndRestoreSnapshot() throws IOException {
         final String repoName = getTestName();
         try (RestHighLevelClient client = new RestHighLevelClient(RestClient.builder(adminClient().getNodes().toArray(new Node[0])))) {
             final int shards = 3;
-            createIndex(client, "test-index", shards);
+            final String index = "test-index";
+            createIndex(client, index, shards);
             createRepository(client, repoName, false);
-            createSnapshot(client, repoName, "snapshot-" + TEST_STEP);
+            createSnapshot(client, repoName, "snapshot-" + TEST_STEP, index);
             final String snapshotToDeleteName = "snapshot-to-delete";
             // Create a snapshot and delete it right away again to test the impact of each version's cleanup functionality that is run
             // as part of the snapshot delete
-            createSnapshot(client, repoName, snapshotToDeleteName);
+            createSnapshot(client, repoName, snapshotToDeleteName, index);
             final List<Map<String, Object>> snapshotsIncludingToDelete = listSnapshots(repoName);
             // Every step creates one snapshot and we have to add one more for the temporary snapshot
             assertThat(snapshotsIncludingToDelete, hasSize(TEST_STEP.ordinal() + 1 + 1));
@@ -162,9 +163,10 @@ public void testReadOnlyRepo() throws IOException {
             final int shards = 3;
             final boolean readOnly = TEST_STEP.ordinal() > 1; // only restore from read-only repo in steps 3 and 4
             createRepository(client, repoName, readOnly);
+            final String index = "test-index";
             if (readOnly == false) {
-                createIndex(client, "test-index", shards);
-                createSnapshot(client, repoName, "snapshot-" + TEST_STEP);
+                createIndex(client, index, shards);
+                createSnapshot(client, repoName, "snapshot-" + TEST_STEP, index);
             }
             final List<Map<String, Object>> snapshots = listSnapshots(repoName);
             switch (TEST_STEP) {
@@ -196,11 +198,12 @@ public void testUpgradeMovesRepoToNewMetaVersion() throws IOException {
         final String repoName = getTestName();
         try (RestHighLevelClient client = new RestHighLevelClient(RestClient.builder(adminClient().getNodes().toArray(new Node[0])))) {
             final int shards = 3;
-            createIndex(client, "test-index", shards);
+            final String index=  "test-index";
+            createIndex(client, index, shards);
             createRepository(client, repoName, false);
             // only create some snapshots in the first two steps
             if (TEST_STEP == TestStep.STEP1_OLD_CLUSTER || TEST_STEP == TestStep.STEP2_NEW_CLUSTER) {
-                createSnapshot(client, repoName, "snapshot-" + TEST_STEP);
+                createSnapshot(client, repoName, "snapshot-" + TEST_STEP, index);
                 final List<Map<String, Object>> snapshots = listSnapshots(repoName);
                 // Every step creates one snapshot
                 assertThat(snapshots, hasSize(TEST_STEP.ordinal() + 1));
@@ -211,10 +214,10 @@ public void testUpgradeMovesRepoToNewMetaVersion() throws IOException {
                 } else {
                     deleteSnapshot(client, repoName, "snapshot-" + TestStep.STEP1_OLD_CLUSTER);
                     ensureSnapshotRestoreWorks(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER, shards);
-                    createSnapshot(client, repoName, "snapshot-1");
+                    createSnapshot(client, repoName, "snapshot-1", index);
                     ensureSnapshotRestoreWorks(client, repoName, "snapshot-1", shards);
                     deleteSnapshot(client, repoName, "snapshot-" + TestStep.STEP2_NEW_CLUSTER);
-                    createSnapshot(client, repoName, "snapshot-2");
+                    createSnapshot(client, repoName, "snapshot-2", index);
                     ensureSnapshotRestoreWorks(client, repoName, "snapshot-2", shards);
                 }
             } else {
@@ -225,7 +228,7 @@ public void testUpgradeMovesRepoToNewMetaVersion() throws IOException {
                     expectThrowsAnyOf(expectedExceptions, () -> listSnapshots(repoName));
                     expectThrowsAnyOf(expectedExceptions, () -> deleteSnapshot(client, repoName, "snapshot-1"));
                     expectThrowsAnyOf(expectedExceptions, () -> deleteSnapshot(client, repoName, "snapshot-2"));
-                    expectThrowsAnyOf(expectedExceptions, () -> createSnapshot(client, repoName, "snapshot-impossible"));
+                    expectThrowsAnyOf(expectedExceptions, () -> createSnapshot(client, repoName, "snapshot-impossible", index));
                 } else {
                     assertThat(listSnapshots(repoName), hasSize(2));
                     if (TEST_STEP == TestStep.STEP4_NEW_CLUSTER) {
@@ -284,8 +287,8 @@ private static void createRepository(RestHighLevelClient client, String repoName
             is(true));
     }
 
-    private static void createSnapshot(RestHighLevelClient client, String repoName, String name) throws IOException {
-        client.snapshot().create(new CreateSnapshotRequest(repoName, name).waitForCompletion(true), RequestOptions.DEFAULT);
+    private static void createSnapshot(RestHighLevelClient client, String repoName, String name, String index) throws IOException {
+        client.snapshot().create(new CreateSnapshotRequest(repoName, name).waitForCompletion(true).indices(index), RequestOptions.DEFAULT);
     }
 
     private void createIndex(RestHighLevelClient client, String name, int shards) throws IOException {

From 5689cea3c783c3b7ca1fecded82fe923790fc960 Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Fri, 17 Jan 2020 07:40:02 +0100
Subject: [PATCH 630/686] [Transform] Improve force stop robustness in case of
 an error (#51072)

If a transform config got lost (e.g. because the internal index disappeared) tasks could not be
stopped using transform API. This change makes it possible to stop transforms without a config,
meaning to remove the background task. In order to do so force must be set to true.
---
 .../core/transform/TransformMessages.java     |   2 +
 .../integration/TransformPivotRestIT.java     |   8 --
 .../integration/TransformRestTestCase.java    | 102 ++++++++--------
 .../integration/TransformRobustnessIT.java    | 115 ++++++++++++++++++
 .../TransformTaskFailedStateIT.java           |  36 +++---
 .../action/TransportStopTransformAction.java  |  53 +++++++-
 6 files changed, 238 insertions(+), 78 deletions(-)
 create mode 100644 x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformRobustnessIT.java

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
index d0279d9aebd38..912f7032fe3b0 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/transform/TransformMessages.java
@@ -17,6 +17,8 @@ public class TransformMessages {
             "Interrupted while waiting for transform [{0}] to stop";
     public static final String REST_PUT_TRANSFORM_EXISTS = "Transform with id [{0}] already exists";
     public static final String REST_UNKNOWN_TRANSFORM = "Transform with id [{0}] could not be found";
+    public static final String REST_STOP_TRANSFORM_WITHOUT_CONFIG =
+            "Detected transforms with no config [{0}]. Use force to stop/delete them.";
     public static final String REST_PUT_TRANSFORM_FAILED_TO_VALIDATE_CONFIGURATION =
             "Failed to validate configuration";
     public static final String REST_PUT_FAILED_PERSIST_TRANSFORM_CONFIGURATION = "Failed to persist transform configuration";
diff --git a/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformPivotRestIT.java b/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformPivotRestIT.java
index 16a559d5b5c68..0b7aaf42b7c2d 100644
--- a/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformPivotRestIT.java
+++ b/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformPivotRestIT.java
@@ -918,12 +918,4 @@ public void testContinuousStopWaitForCheckpoint() throws Exception {
         assertOnePivotValue(dataFrameIndex + "/_search?q=reviewer:user_26", 3.918918918);
         deleteIndex(indexName);
     }
-
-    private void assertOnePivotValue(String query, double expected) throws IOException {
-        Map<String, Object> searchResult = getAsMap(query);
-
-        assertEquals(1, XContentMapValues.extractValue("hits.total.value", searchResult));
-        double actual = (Double) ((List<?>) XContentMapValues.extractValue("hits.hits._source.avg_rating", searchResult)).get(0);
-        assertEquals(expected, actual, 0.000001);
-    }
 }
diff --git a/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformRestTestCase.java b/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformRestTestCase.java
index bf10e3976e983..d9c61dddeab47 100644
--- a/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformRestTestCase.java
+++ b/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformRestTestCase.java
@@ -73,7 +73,7 @@ protected RestClient buildClient(Settings settings, HttpHost[] hosts) throws IOE
     }
 
     protected void createReviewsIndex(String indexName, int numDocs) throws IOException {
-        int[] distributionTable = {5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 4, 4, 4, 3, 3, 2, 1, 1, 1};
+        int[] distributionTable = { 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 4, 4, 4, 3, 3, 2, 1, 1, 1 };
 
         // create mapping
         try (XContentBuilder builder = jsonBuilder()) {
@@ -158,6 +158,7 @@ protected void createReviewsIndex(String indexName, int numDocs) throws IOExcept
         bulkRequest.setJsonEntity(bulk.toString());
         client().performRequest(bulkRequest);
     }
+
     /**
      * Create a simple dataset for testing with reviewers, ratings and businesses
      */
@@ -182,9 +183,8 @@ protected void createContinuousPivotReviewsTransform(String transformId, String
 
         final Request createDataframeTransformRequest = createRequestWithAuth("PUT", getTransformEndpoint() + transformId, authHeader);
 
-        String config = "{ \"dest\": {\"index\":\"" + dataFrameIndex + "\"},"
-            + " \"source\": {\"index\":\"" + REVIEWS_INDEX_NAME + "\"},"
-            //Set frequency high for testing
+        String config = "{ \"dest\": {\"index\":\"" + dataFrameIndex + "\"}," + " \"source\": {\"index\":\"" + REVIEWS_INDEX_NAME + "\"},"
+        // Set frequency high for testing
             + " \"sync\": {\"time\":{\"field\": \"timestamp\", \"delay\": \"15m\"}},"
             + " \"frequency\": \"1s\","
             + " \"pivot\": {"
@@ -206,7 +206,6 @@ protected void createContinuousPivotReviewsTransform(String transformId, String
         assertThat(createDataframeTransformResponse.get("acknowledged"), equalTo(Boolean.TRUE));
     }
 
-
     protected void createPivotReviewsTransform(String transformId, String dataFrameIndex, String query, String pipeline, String authHeader)
         throws IOException {
         final Request createDataframeTransformRequest = createRequestWithAuth("PUT", getTransformEndpoint() + transformId, authHeader);
@@ -226,18 +225,18 @@ protected void createPivotReviewsTransform(String transformId, String dataFrameI
         }
 
         config += " \"pivot\": {"
-                + "   \"group_by\": {"
-                + "     \"reviewer\": {"
-                + "       \"terms\": {"
-                + "         \"field\": \"user_id\""
-                + " } } },"
-                + "   \"aggregations\": {"
-                + "     \"avg_rating\": {"
-                + "       \"avg\": {"
-                + "         \"field\": \"stars\""
-                + " } } } },"
-                + "\"frequency\":\"1s\""
-                + "}";
+            + "   \"group_by\": {"
+            + "     \"reviewer\": {"
+            + "       \"terms\": {"
+            + "         \"field\": \"user_id\""
+            + " } } },"
+            + "   \"aggregations\": {"
+            + "     \"avg_rating\": {"
+            + "       \"avg\": {"
+            + "         \"field\": \"stars\""
+            + " } } } },"
+            + "\"frequency\":\"1s\""
+            + "}";
 
         createDataframeTransformRequest.setJsonEntity(config);
 
@@ -245,11 +244,11 @@ protected void createPivotReviewsTransform(String transformId, String dataFrameI
         assertThat(createDataframeTransformResponse.get("acknowledged"), equalTo(Boolean.TRUE));
     }
 
-    protected void startDataframeTransform(String transformId) throws IOException {
-        startDataframeTransform(transformId, null);
+    protected void startTransform(String transformId) throws IOException {
+        startTransform(transformId, null);
     }
 
-    protected void startDataframeTransform(String transformId, String authHeader, String... warnings) throws IOException {
+    protected void startTransform(String transformId, String authHeader, String... warnings) throws IOException {
         // start the transform
         final Request startTransformRequest = createRequestWithAuth("POST", getTransformEndpoint() + transformId + "/_start", authHeader);
         if (warnings.length > 0) {
@@ -280,10 +279,10 @@ protected void startAndWaitForTransform(String transformId, String dataFrameInde
         startAndWaitForTransform(transformId, dataFrameIndex, authHeader, new String[0]);
     }
 
-    protected void startAndWaitForTransform(String transformId, String dataFrameIndex,
-                                            String authHeader, String... warnings) throws Exception {
+    protected void startAndWaitForTransform(String transformId, String dataFrameIndex, String authHeader, String... warnings)
+        throws Exception {
         // start the transform
-        startDataframeTransform(transformId, authHeader, warnings);
+        startTransform(transformId, authHeader, warnings);
         assertTrue(indexExists(dataFrameIndex));
         // wait until the dataframe has been created and all data is available
         waitForDataFrameCheckpoint(transformId);
@@ -292,18 +291,14 @@ protected void startAndWaitForTransform(String transformId, String dataFrameInde
         refreshIndex(dataFrameIndex);
     }
 
-    protected void startAndWaitForContinuousTransform(String transformId,
-                                                      String dataFrameIndex,
-                                                      String authHeader) throws Exception {
+    protected void startAndWaitForContinuousTransform(String transformId, String dataFrameIndex, String authHeader) throws Exception {
         startAndWaitForContinuousTransform(transformId, dataFrameIndex, authHeader, 1L);
     }
 
-    protected void startAndWaitForContinuousTransform(String transformId,
-                                                      String dataFrameIndex,
-                                                      String authHeader,
-                                                      long checkpoint) throws Exception {
+    protected void startAndWaitForContinuousTransform(String transformId, String dataFrameIndex, String authHeader, long checkpoint)
+        throws Exception {
         // start the transform
-        startDataframeTransform(transformId, authHeader, new String[0]);
+        startTransform(transformId, authHeader, new String[0]);
         assertTrue(indexExists(dataFrameIndex));
         // wait until the dataframe has been created and all data is available
         waitForTransformCheckpoint(transformId, checkpoint);
@@ -323,9 +318,7 @@ protected Request createRequestWithAuth(final String method, final String endpoi
     }
 
     void waitForDataFrameStopped(String transformId) throws Exception {
-        assertBusy(() -> {
-            assertEquals("stopped", getDataFrameTransformState(transformId));
-        }, 15, TimeUnit.SECONDS);
+        assertBusy(() -> { assertEquals("stopped", getTransformState(transformId)); }, 15, TimeUnit.SECONDS);
     }
 
     void waitForDataFrameCheckpoint(String transformId) throws Exception {
@@ -341,7 +334,7 @@ void refreshIndex(String index) throws IOException {
     }
 
     @SuppressWarnings("unchecked")
-    private static List<Map<String, Object>> getDataFrameTransforms() throws IOException {
+    protected static List<Map<String, Object>> getTransforms() throws IOException {
         Response response = adminClient().performRequest(new Request("GET", getTransformEndpoint() + "_all"));
         Map<String, Object> transforms = entityAsMap(response);
         List<Map<String, Object>> transformConfigs = (List<Map<String, Object>>) XContentMapValues.extractValue("transforms", transforms);
@@ -349,12 +342,12 @@ private static List<Map<String, Object>> getDataFrameTransforms() throws IOExcep
         return transformConfigs == null ? Collections.emptyList() : transformConfigs;
     }
 
-    protected static String getDataFrameTransformState(String transformId) throws IOException {
-        Map<?, ?> transformStatsAsMap = getDataFrameState(transformId);
+    protected static String getTransformState(String transformId) throws IOException {
+        Map<?, ?> transformStatsAsMap = getTransformStateAndStats(transformId);
         return transformStatsAsMap == null ? null : (String) XContentMapValues.extractValue("state", transformStatsAsMap);
     }
 
-    protected static Map<?, ?> getDataFrameState(String transformId) throws IOException {
+    protected static Map<?, ?> getTransformStateAndStats(String transformId) throws IOException {
         Response statsResponse = client().performRequest(new Request("GET", getTransformEndpoint() + transformId + "/_stats"));
         List<?> transforms = ((List<?>) entityAsMap(statsResponse).get("transforms"));
         if (transforms.isEmpty()) {
@@ -383,7 +376,7 @@ public static void removeIndices() throws Exception {
     }
 
     public void wipeTransforms() throws IOException {
-        List<Map<String, Object>> transformConfigs = getDataFrameTransforms();
+        List<Map<String, Object>> transformConfigs = getTransforms();
         for (Map<String, Object> transformConfig : transformConfigs) {
             String transformId = (String) transformConfig.get("id");
             Request request = new Request("POST", getTransformEndpoint() + transformId + "/_stop");
@@ -395,7 +388,7 @@ public void wipeTransforms() throws IOException {
 
         for (Map<String, Object> transformConfig : transformConfigs) {
             String transformId = (String) transformConfig.get("id");
-            String state = getDataFrameTransformState(transformId);
+            String state = getTransformState(transformId);
             assertEquals("Transform [" + transformId + "] is not in the stopped state", "stopped", state);
         }
 
@@ -405,7 +398,7 @@ public void wipeTransforms() throws IOException {
         }
 
         // transforms should be all gone
-        transformConfigs = getDataFrameTransforms();
+        transformConfigs = getTransforms();
         assertTrue(transformConfigs.isEmpty());
 
         // the configuration index should be empty
@@ -437,11 +430,15 @@ static int getDataFrameCheckpoint(String transformId) throws IOException {
     protected void setupDataAccessRole(String role, String... indices) throws IOException {
         String indicesStr = Arrays.stream(indices).collect(Collectors.joining("\",\"", "\"", "\""));
         Request request = new Request("PUT", "/_security/role/" + role);
-        request.setJsonEntity("{"
-            + "  \"indices\" : ["
-            + "    { \"names\": [" + indicesStr + "], \"privileges\": [\"create_index\", \"read\", \"write\", \"view_index_metadata\"] }"
-            + "  ]"
-            + "}");
+        request.setJsonEntity(
+            "{"
+                + "  \"indices\" : ["
+                + "    { \"names\": ["
+                + indicesStr
+                + "], \"privileges\": [\"create_index\", \"read\", \"write\", \"view_index_metadata\"] }"
+                + "  ]"
+                + "}"
+        );
         client().performRequest(request);
     }
 
@@ -450,13 +447,18 @@ protected void setupUser(String user, List<String> roles) throws IOException {
 
         String rolesStr = roles.stream().collect(Collectors.joining("\",\"", "\"", "\""));
         Request request = new Request("PUT", "/_security/user/" + user);
-        request.setJsonEntity("{"
-            + "  \"password\" : \"" + password + "\","
-            + "  \"roles\" : [ " + rolesStr + " ]"
-            + "}");
+        request.setJsonEntity("{" + "  \"password\" : \"" + password + "\"," + "  \"roles\" : [ " + rolesStr + " ]" + "}");
         client().performRequest(request);
     }
 
+    protected void assertOnePivotValue(String query, double expected) throws IOException {
+        Map<String, Object> searchResult = getAsMap(query);
+
+        assertEquals(1, XContentMapValues.extractValue("hits.total.value", searchResult));
+        double actual = (Double) ((List<?>) XContentMapValues.extractValue("hits.hits._source.avg_rating", searchResult)).get(0);
+        assertEquals(expected, actual, 0.000001);
+    }
+
     protected static String getTransformEndpoint() {
         return useDeprecatedEndpoints ? TransformField.REST_BASE_PATH_TRANSFORMS_DEPRECATED : TransformField.REST_BASE_PATH_TRANSFORMS;
     }
diff --git a/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformRobustnessIT.java b/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformRobustnessIT.java
new file mode 100644
index 0000000000000..0a9b5ca68ac16
--- /dev/null
+++ b/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformRobustnessIT.java
@@ -0,0 +1,115 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.transform.integration;
+
+import org.elasticsearch.client.Request;
+import org.elasticsearch.client.ResponseException;
+import org.elasticsearch.xpack.core.transform.TransformField;
+import org.elasticsearch.xpack.core.transform.transforms.persistence.TransformInternalIndexConstants;
+
+import java.io.IOException;
+import java.util.Map;
+import java.util.Map.Entry;
+
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+
+public class TransformRobustnessIT extends TransformRestTestCase {
+
+    public void testTaskRemovalAfterInternalIndexGotDeleted() throws Exception {
+        String indexName = "continuous_reviews";
+        createReviewsIndex(indexName);
+        String transformId = "simple_continuous_pivot";
+        String transformIndex = "pivot_reviews_continuous";
+        final Request createTransformRequest = new Request("PUT", TransformField.REST_BASE_PATH_TRANSFORMS + transformId);
+        String config = "{"
+            + " \"source\": {\"index\":\""
+            + indexName
+            + "\"},"
+            + " \"dest\": {\"index\":\""
+            + transformIndex
+            + "\"},"
+            + " \"frequency\": \"1s\","
+            + " \"sync\": {\"time\": {\"field\": \"timestamp\", \"delay\": \"1s\"}},"
+            + " \"pivot\": {"
+            + "   \"group_by\": {"
+            + "     \"reviewer\": {"
+            + "       \"terms\": {"
+            + "         \"field\": \"user_id\""
+            + " } } },"
+            + "   \"aggregations\": {"
+            + "     \"avg_rating\": {"
+            + "       \"avg\": {"
+            + "         \"field\": \"stars\""
+            + " } } } }"
+            + "}";
+        createTransformRequest.setJsonEntity(config);
+        Map<String, Object> createTransformResponse = entityAsMap(client().performRequest(createTransformRequest));
+        assertThat(createTransformResponse.get("acknowledged"), equalTo(Boolean.TRUE));
+        assertEquals(1, getTransforms().size());
+        // there shouldn't be a task yet
+        assertEquals(0, getNumberOfTransformTasks());
+        startAndWaitForContinuousTransform(transformId, transformIndex, null);
+        assertTrue(indexExists(transformIndex));
+
+        // a task exists
+        assertEquals(1, getNumberOfTransformTasks());
+        // get and check some users
+        assertOnePivotValue(transformIndex + "/_search?q=reviewer:user_0", 3.776978417);
+        assertOnePivotValue(transformIndex + "/_search?q=reviewer:user_5", 3.72);
+        assertNotNull(getTransformState(transformId));
+
+        assertEquals(1, getTransforms().size());
+
+        // delete the transform index
+        beEvilAndDeleteTheTransformIndex();
+        // transform is gone
+        assertEquals(0, getTransforms().size());
+        // but the task is still there
+        assertEquals(1, getNumberOfTransformTasks());
+
+        Request stopTransformRequest = new Request("POST", TransformField.REST_BASE_PATH_TRANSFORMS + transformId + "/_stop");
+        ResponseException e = expectThrows(ResponseException.class, () -> client().performRequest(stopTransformRequest));
+
+        assertEquals(409, e.getResponse().getStatusLine().getStatusCode());
+        assertThat(
+            e.getMessage(),
+            containsString("Detected transforms with no config [" + transformId + "]. Use force to stop/delete them.")
+        );
+        stopTransformRequest.addParameter(TransformField.FORCE.getPreferredName(), Boolean.toString(true));
+        Map<String, Object> stopTransformResponse = entityAsMap(client().performRequest(stopTransformRequest));
+        assertThat(stopTransformResponse.get("acknowledged"), equalTo(Boolean.TRUE));
+
+        // the task is gone
+        assertEquals(1, getNumberOfTransformTasks());
+    }
+
+    @SuppressWarnings("unchecked")
+    private int getNumberOfTransformTasks() throws IOException {
+        final Request tasksRequest = new Request("GET", "/_tasks");
+        tasksRequest.addParameter("actions", TransformField.TASK_NAME + "*");
+        Map<String, Object> tasksResponse = entityAsMap(client().performRequest(tasksRequest));
+
+        Map<String, Object> nodes = (Map<String, Object>) tasksResponse.get("nodes");
+        if (nodes == null) {
+            return 0;
+        }
+
+        int foundTasks = 0;
+        for (Entry<String, Object> node : nodes.entrySet()) {
+            Map<String, Object> nodeInfo = (Map<String, Object>) node.getValue();
+            Map<String, Object> tasks = (Map<String, Object>) nodeInfo.get("tasks");
+            foundTasks += tasks != null ? tasks.size() : 0;
+        }
+
+        return foundTasks;
+    }
+
+    private void beEvilAndDeleteTheTransformIndex() throws IOException {
+        adminClient().performRequest(new Request("DELETE", TransformInternalIndexConstants.LATEST_INDEX_NAME));
+    }
+}
diff --git a/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformTaskFailedStateIT.java b/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformTaskFailedStateIT.java
index 033cf57ba84fa..809064df4c039 100644
--- a/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformTaskFailedStateIT.java
+++ b/x-pack/plugin/transform/qa/single-node-tests/src/test/java/org/elasticsearch/xpack/transform/integration/TransformTaskFailedStateIT.java
@@ -40,16 +40,15 @@ public void setClusterSettings() throws IOException {
         // Set logging level to trace
         // see: https://github.com/elastic/elasticsearch/issues/45562
         Request addFailureRetrySetting = new Request("PUT", "/_cluster/settings");
-        addFailureRetrySetting
-            .setJsonEntity(
-                "{\"transient\": {\"xpack.transform.num_transform_failure_retries\": \""
-                    + 0
-                    + "\","
-                    + "\"logger.org.elasticsearch.action.bulk\": \"info\","
-                    + // reduces bulk failure spam
-                    "\"logger.org.elasticsearch.xpack.core.indexing.AsyncTwoPhaseIndexer\": \"trace\","
-                    + "\"logger.org.elasticsearch.xpack.transform\": \"trace\"}}"
-            );
+        addFailureRetrySetting.setJsonEntity(
+            "{\"transient\": {\"xpack.transform.num_transform_failure_retries\": \""
+                + 0
+                + "\","
+                + "\"logger.org.elasticsearch.action.bulk\": \"info\","
+                + // reduces bulk failure spam
+                "\"logger.org.elasticsearch.xpack.core.indexing.AsyncTwoPhaseIndexer\": \"trace\","
+                + "\"logger.org.elasticsearch.xpack.transform\": \"trace\"}}"
+        );
         client().performRequest(addFailureRetrySetting);
     }
 
@@ -70,9 +69,9 @@ public void testForceStopFailedTransform() throws Exception {
         createDestinationIndexWithBadMapping(transformIndex);
         createContinuousPivotReviewsTransform(transformId, transformIndex, null);
         failureTransforms.add(transformId);
-        startDataframeTransform(transformId);
+        startTransform(transformId);
         awaitState(transformId, TransformStats.State.FAILED);
-        Map<?, ?> fullState = getDataFrameState(transformId);
+        Map<?, ?> fullState = getTransformStateAndStats(transformId);
         final String failureReason = "task encountered more than 0 failures; latest failure: "
             + ".*BulkIndexingException: Bulk index experienced failures. See the logs of the node running the transform for details.";
         // Verify we have failed for the expected reason
@@ -94,7 +93,7 @@ public void testForceStopFailedTransform() throws Exception {
         stopTransform(transformId, true);
 
         awaitState(transformId, TransformStats.State.STOPPED);
-        fullState = getDataFrameState(transformId);
+        fullState = getTransformStateAndStats(transformId);
         assertThat(XContentMapValues.extractValue("reason", fullState), is(nullValue()));
     }
 
@@ -105,9 +104,9 @@ public void testStartFailedTransform() throws Exception {
         createDestinationIndexWithBadMapping(dataFrameIndex);
         createContinuousPivotReviewsTransform(transformId, dataFrameIndex, null);
         failureTransforms.add(transformId);
-        startDataframeTransform(transformId);
+        startTransform(transformId);
         awaitState(transformId, TransformStats.State.FAILED);
-        Map<?, ?> fullState = getDataFrameState(transformId);
+        Map<?, ?> fullState = getTransformStateAndStats(transformId);
         final String failureReason = "task encountered more than 0 failures; latest failure: "
             + ".*BulkIndexingException: Bulk index experienced failures. See the logs of the node running the transform for details.";
         // Verify we have failed for the expected reason
@@ -119,7 +118,7 @@ public void testStartFailedTransform() throws Exception {
             + "\\]. Use force stop and then restart the transform once error is resolved.";
         // Verify that we cannot start the transform when the task is in a failed state
         assertBusy(() -> {
-            ResponseException ex = expectThrows(ResponseException.class, () -> startDataframeTransform(transformId));
+            ResponseException ex = expectThrows(ResponseException.class, () -> startTransform(transformId));
             assertThat(ex.getResponse().getStatusLine().getStatusCode(), equalTo(RestStatus.CONFLICT.getStatus()));
             assertThat(
                 (String) XContentMapValues.extractValue("error.reason", entityAsMap(ex.getResponse())),
@@ -132,7 +131,7 @@ public void testStartFailedTransform() throws Exception {
 
     private void awaitState(String transformId, TransformStats.State state) throws Exception {
         assertBusy(() -> {
-            String currentState = getDataFrameTransformState(transformId);
+            String currentState = getTransformState(transformId);
             assertThat(currentState, equalTo(state.value()));
         }, 180, TimeUnit.SECONDS); // It should not take this long, but if the scheduler gets deferred, it could
     }
@@ -142,8 +141,7 @@ private void createDestinationIndexWithBadMapping(String indexName) throws IOExc
         try (XContentBuilder builder = jsonBuilder()) {
             builder.startObject();
             {
-                builder
-                    .startObject("mappings")
+                builder.startObject("mappings")
                     .startObject("properties")
                     .startObject("reviewer")
                     .field("type", "long")
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
index bd3ddc3e8ceab..4cea47c399238 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
@@ -9,6 +9,7 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionListenerResponseHandler;
 import org.elasticsearch.action.FailedNodeException;
@@ -19,22 +20,28 @@
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.collect.Tuple;
 import org.elasticsearch.common.inject.Inject;
 import org.elasticsearch.common.logging.LoggerMessageFormat;
+import org.elasticsearch.common.regex.Regex;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.discovery.MasterNotDiscoveredException;
 import org.elasticsearch.persistent.PersistentTasksCustomMetaData;
+import org.elasticsearch.persistent.PersistentTasksCustomMetaData.PersistentTask;
 import org.elasticsearch.persistent.PersistentTasksService;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.action.util.PageParams;
+import org.elasticsearch.xpack.core.transform.TransformField;
 import org.elasticsearch.xpack.core.transform.TransformMessages;
 import org.elasticsearch.xpack.core.transform.action.StopTransformAction;
 import org.elasticsearch.xpack.core.transform.action.StopTransformAction.Request;
 import org.elasticsearch.xpack.core.transform.action.StopTransformAction.Response;
 import org.elasticsearch.xpack.core.transform.transforms.TransformState;
+import org.elasticsearch.xpack.core.transform.transforms.TransformTaskParams;
 import org.elasticsearch.xpack.core.transform.transforms.TransformTaskState;
 import org.elasticsearch.xpack.core.transform.transforms.persistence.TransformInternalIndexConstants;
 import org.elasticsearch.xpack.transform.TransformServices;
@@ -47,6 +54,7 @@
 import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.ConcurrentHashMap;
+import java.util.function.Predicate;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
@@ -127,6 +135,25 @@ static void validateTaskState(ClusterState state, List<String> transformIds, boo
         }
     }
 
+    static Tuple<Set<String>, Set<String>> findTasksWithoutConfig(ClusterState state, String transformId) {
+        PersistentTasksCustomMetaData tasks = state.metaData().custom(PersistentTasksCustomMetaData.TYPE);
+
+        Set<String> taskIds = new HashSet<>();
+        Set<String> executorNodes = new HashSet<>();
+
+        Predicate<PersistentTask<?>> taskMatcher = Strings.isAllOrWildcard(new String[] { transformId }) ? t -> true : t -> {
+            TransformTaskParams transformParams = (TransformTaskParams) t.getParams();
+            return Regex.simpleMatch(transformId, transformParams.getId());
+        };
+
+        for (PersistentTasksCustomMetaData.PersistentTask<?> pTask : tasks.findTasks(TransformField.TASK_NAME, taskMatcher)) {
+            executorNodes.add(pTask.getExecutorNode());
+            taskIds.add(pTask.getId());
+        }
+
+        return new Tuple<>(taskIds, executorNodes);
+    }
+
     @Override
     protected void doExecute(Task task, Request request, ActionListener<Response> listener) {
         final ClusterState state = clusterService.state();
@@ -160,7 +187,31 @@ protected void doExecute(Task task, Request request, ActionListener<Response> li
                     request.setExpandedIds(new HashSet<>(hitsAndIds.v2()));
                     request.setNodes(TransformNodes.transformTaskNodes(hitsAndIds.v2(), state));
                     super.doExecute(task, request, finalListener);
-                }, listener::onFailure)
+                }, e -> {
+                    if (e instanceof ResourceNotFoundException) {
+                        Tuple<Set<String>, Set<String>> runningTasksAndNodes = findTasksWithoutConfig(state, request.getId());
+                        if (runningTasksAndNodes.v1().isEmpty()) {
+                            listener.onFailure(e);
+                            // found transforms without a config
+                        } else if (request.isForce()) {
+                            request.setExpandedIds(runningTasksAndNodes.v1());
+                            request.setNodes(runningTasksAndNodes.v2().toArray(new String[0]));
+                            super.doExecute(task, request, finalListener);
+                        } else {
+                            listener.onFailure(
+                                new ElasticsearchStatusException(
+                                    TransformMessages.getMessage(
+                                        TransformMessages.REST_STOP_TRANSFORM_WITHOUT_CONFIG,
+                                        Strings.arrayToCommaDelimitedString(runningTasksAndNodes.v1().toArray(new String[0]))
+                                    ),
+                                    RestStatus.CONFLICT
+                                )
+                            );
+                        }
+                    } else {
+                        listener.onFailure(e);
+                    }
+                })
             );
         }
     }

From 98d0b4111520ceb030c9c3a9f6bcb25240003db9 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Fri, 17 Jan 2020 08:47:39 +0000
Subject: [PATCH 631/686] Remove types from WatcherSearchTemplateRequest
 (#51112)

There is no longer any point in restricting the types for a Watcher search template. The
types parameter was deprecated in 7x, and can be removed from 8x.

Relates to #41059
---
 .../search/WatcherSearchTemplateRequest.java  | 45 +++----------------
 ...storyTemplateSearchInputMappingsTests.java | 10 +----
 .../watcher/support/WatcherUtilsTests.java    | 27 +----------
 .../WatcherSearchTemplateRequestTests.java    | 18 --------
 .../xpack/watcher/test/WatcherTestUtils.java  |  2 +-
 .../test/integration/BasicWatcherTests.java   |  2 +-
 6 files changed, 10 insertions(+), 94 deletions(-)

diff --git a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/support/search/WatcherSearchTemplateRequest.java b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/support/search/WatcherSearchTemplateRequest.java
index 670f4ffe66852..8453b58efeca0 100644
--- a/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/support/search/WatcherSearchTemplateRequest.java
+++ b/x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/support/search/WatcherSearchTemplateRequest.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.watcher.support.search;
 
-import org.apache.logging.log4j.LogManager;
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.action.search.SearchType;
 import org.elasticsearch.action.support.IndicesOptions;
@@ -14,7 +13,6 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentFactory;
@@ -38,21 +36,15 @@
 public class WatcherSearchTemplateRequest implements ToXContentObject {
 
     private final String[] indices;
-    private final String[] types;
     private final SearchType searchType;
     private final IndicesOptions indicesOptions;
     private final Script template;
     private final BytesReference searchSource;
     private boolean restTotalHitsAsInt = true;
 
-    private static final DeprecationLogger deprecationLogger =
-        new DeprecationLogger(LogManager.getLogger(WatcherSearchTemplateRequest.class));
-    public static final String TYPES_DEPRECATION_MESSAGE = "[types removal] Specifying types in a watcher search request is deprecated.";
-
-    public WatcherSearchTemplateRequest(String[] indices, String[] types, SearchType searchType, IndicesOptions indicesOptions,
+    public WatcherSearchTemplateRequest(String[] indices, SearchType searchType, IndicesOptions indicesOptions,
                                         BytesReference searchSource) {
         this.indices = indices;
-        this.types = types;
         this.searchType = searchType;
         this.indicesOptions = indicesOptions;
         // Here we convert a watch search request body into an inline search template,
@@ -61,10 +53,9 @@ public WatcherSearchTemplateRequest(String[] indices, String[] types, SearchType
         this.searchSource = BytesArray.EMPTY;
     }
 
-    public WatcherSearchTemplateRequest(String[] indices, String[] types, SearchType searchType, IndicesOptions indicesOptions,
+    public WatcherSearchTemplateRequest(String[] indices, SearchType searchType, IndicesOptions indicesOptions,
                                         Script template) {
         this.indices = indices;
-        this.types = types;
         this.searchType = searchType;
         this.indicesOptions = indicesOptions;
         this.template = template;
@@ -73,7 +64,6 @@ public WatcherSearchTemplateRequest(String[] indices, String[] types, SearchType
 
     public WatcherSearchTemplateRequest(WatcherSearchTemplateRequest original, BytesReference source) {
         this.indices = original.indices;
-        this.types = original.types;
         this.searchType = original.searchType;
         this.indicesOptions = original.indicesOptions;
         this.searchSource = source;
@@ -81,10 +71,9 @@ public WatcherSearchTemplateRequest(WatcherSearchTemplateRequest original, Bytes
         this.restTotalHitsAsInt = original.restTotalHitsAsInt;
     }
 
-    private WatcherSearchTemplateRequest(String[] indices, String[] types, SearchType searchType, IndicesOptions indicesOptions,
+    private WatcherSearchTemplateRequest(String[] indices, SearchType searchType, IndicesOptions indicesOptions,
                                  BytesReference searchSource, Script template) {
         this.indices = indices;
-        this.types = types;
         this.searchType = searchType;
         this.indicesOptions = indicesOptions;
         this.template = template;
@@ -100,10 +89,6 @@ public String[] getIndices() {
         return indices;
     }
 
-    public String[] getTypes() {
-        return types;
-    }
-
     public SearchType getSearchType() {
         return searchType;
     }
@@ -146,9 +131,6 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         if (indices != null) {
             builder.array(INDICES_FIELD.getPreferredName(), indices);
         }
-        if (types != null) {
-            builder.array(TYPES_FIELD.getPreferredName(), types);
-        }
         if (restTotalHitsAsInt) {
             builder.field(REST_TOTAL_HITS_AS_INT_FIELD.getPreferredName(), restTotalHitsAsInt);
         }
@@ -186,7 +168,6 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
      */
     public static WatcherSearchTemplateRequest fromXContent(XContentParser parser, SearchType searchType) throws IOException {
         List<String> indices = new ArrayList<>();
-        List<String> types = new ArrayList<>();
         IndicesOptions indicesOptions = DEFAULT_INDICES_OPTIONS;
         BytesReference searchSource = null;
         Script template = null;
@@ -208,16 +189,6 @@ public static WatcherSearchTemplateRequest fromXContent(XContentParser parser, S
                                     currentFieldName + "] field, but instead found [" + token + "]");
                         }
                     }
-                } else if (TYPES_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    deprecationLogger.deprecatedAndMaybeLog("watcher_search_input", TYPES_DEPRECATION_MESSAGE);
-                    while ((token = parser.nextToken()) != XContentParser.Token.END_ARRAY) {
-                        if (token == XContentParser.Token.VALUE_STRING) {
-                            types.add(parser.textOrNull());
-                        } else {
-                            throw new ElasticsearchParseException("could not read search request. expected string values in [" +
-                                    currentFieldName + "] field, but instead found [" + token + "]");
-                        }
-                    }
                 } else {
                     throw new ElasticsearchParseException("could not read search request. unexpected array field [" +
                             currentFieldName + "]");
@@ -284,10 +255,6 @@ public static WatcherSearchTemplateRequest fromXContent(XContentParser parser, S
                 if (INDICES_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
                     String indicesStr = parser.text();
                     indices.addAll(Arrays.asList(Strings.delimitedListToStringArray(indicesStr, ",", " \t")));
-                } else if (TYPES_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
-                    deprecationLogger.deprecatedAndMaybeLog("watcher_search_input", TYPES_DEPRECATION_MESSAGE);
-                    String typesStr = parser.text();
-                    types.addAll(Arrays.asList(Strings.delimitedListToStringArray(typesStr, ",", " \t")));
                 } else if (SEARCH_TYPE_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
                     searchType = SearchType.fromString(parser.text().toLowerCase(Locale.ROOT));
                 } else if (REST_TOTAL_HITS_AS_INT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
@@ -313,7 +280,7 @@ public static WatcherSearchTemplateRequest fromXContent(XContentParser parser, S
         }
 
         WatcherSearchTemplateRequest request = new WatcherSearchTemplateRequest(indices.toArray(new String[0]),
-            types.size() == 0 ? null : types.toArray(new String[0]), searchType, indicesOptions, searchSource, template);
+            searchType, indicesOptions, searchSource, template);
         request.setRestTotalHitsAsInt(totalHitsAsInt);
         return request;
     }
@@ -325,7 +292,6 @@ public boolean equals(Object o) {
 
         WatcherSearchTemplateRequest other = (WatcherSearchTemplateRequest) o;
         return Arrays.equals(indices, other.indices) &&
-                Arrays.equals(types, other.types) &&
                 Objects.equals(searchType, other.searchType) &&
                 Objects.equals(indicesOptions, other.indicesOptions) &&
                 Objects.equals(searchSource, other.searchSource) &&
@@ -336,11 +302,10 @@ public boolean equals(Object o) {
 
     @Override
     public int hashCode() {
-        return Objects.hash(indices, types, searchType, indicesOptions, searchSource, template, restTotalHitsAsInt);
+        return Objects.hash(indices, searchType, indicesOptions, searchSource, template, restTotalHitsAsInt);
     }
 
     private static final ParseField INDICES_FIELD = new ParseField("indices");
-    private static final ParseField TYPES_FIELD = new ParseField("types");
     private static final ParseField BODY_FIELD = new ParseField("body");
     private static final ParseField SEARCH_TYPE_FIELD = new ParseField("search_type");
     private static final ParseField INDICES_OPTIONS_FIELD = new ParseField("indices_options");
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/history/HistoryTemplateSearchInputMappingsTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/history/HistoryTemplateSearchInputMappingsTests.java
index eed684a91bdae..a605f3c0756b1 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/history/HistoryTemplateSearchInputMappingsTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/history/HistoryTemplateSearchInputMappingsTests.java
@@ -36,14 +36,13 @@ public class HistoryTemplateSearchInputMappingsTests extends AbstractWatcherInte
 
     public void testHttpFields() throws Exception {
         String index = "the-index";
-        String type = "the-type";
         createIndex(index);
         indexDoc(index, "{}");
         flush();
         refresh();
 
         WatcherSearchTemplateRequest request = new WatcherSearchTemplateRequest(
-                new String[]{index}, new String[]{type}, SearchType.QUERY_THEN_FETCH,
+                new String[]{index}, SearchType.QUERY_THEN_FETCH,
                 WatcherSearchTemplateRequest.DEFAULT_INDICES_OPTIONS, new BytesArray("{}")
         );
         PutWatchResponse putWatchResponse = new PutWatchRequestBuilder(client(), "_id").setSource(watchBuilder()
@@ -64,7 +63,6 @@ WatcherSearchTemplateRequest.DEFAULT_INDICES_OPTIONS, new BytesArray("{}")
         SearchResponse response = client().prepareSearch(HistoryStoreField.INDEX_PREFIX_WITH_TEMPLATE + "*").setSource(searchSource()
                 .aggregation(terms("input_search_type").field("result.input.search.request.search_type"))
                 .aggregation(terms("input_indices").field("result.input.search.request.indices"))
-                .aggregation(terms("input_types").field("result.input.search.request.types"))
                 .aggregation(terms("input_body").field("result.input.search.request.body")))
                 .get();
 
@@ -85,12 +83,6 @@ WatcherSearchTemplateRequest.DEFAULT_INDICES_OPTIONS, new BytesArray("{}")
         assertThat(terms.getBucketByKey(index), notNullValue());
         assertThat(terms.getBucketByKey(index).getDocCount(), is(1L));
 
-        terms = aggs.get("input_types");
-        assertThat(terms, notNullValue());
-        assertThat(terms.getBuckets().size(), is(1));
-        assertThat(terms.getBucketByKey(type), notNullValue());
-        assertThat(terms.getBucketByKey(type).getDocCount(), is(1L));
-
         terms = aggs.get("input_body");
         assertThat(terms, notNullValue());
         assertThat(terms.getBuckets().size(), is(0));
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/support/WatcherUtilsTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/support/WatcherUtilsTests.java
index b0d2a333838dd..a5dcfaef35db8 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/support/WatcherUtilsTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/support/WatcherUtilsTests.java
@@ -90,7 +90,6 @@ public void testResponseToData() throws Exception {
 
     public void testSerializeSearchRequest() throws Exception {
         String[] expectedIndices = generateRandomStringArray(5, 5, true);
-        String[] expectedTypes = generateRandomStringArray(2, 5, true, false);
         IndicesOptions expectedIndicesOptions = IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(),
                 randomBoolean(), WatcherSearchTemplateRequest.DEFAULT_INDICES_OPTIONS);
         SearchType expectedSearchType = getRandomSupportedSearchType();
@@ -111,14 +110,14 @@ public void testSerializeSearchRequest() throws Exception {
             ScriptType scriptType = randomFrom(ScriptType.values());
             stored = scriptType == ScriptType.STORED;
             expectedTemplate = new Script(scriptType, stored ? null : "mustache", text, params);
-            request = new WatcherSearchTemplateRequest(expectedIndices, expectedTypes, expectedSearchType,
+            request = new WatcherSearchTemplateRequest(expectedIndices, expectedSearchType,
                     expectedIndicesOptions, expectedTemplate);
         } else {
             SearchSourceBuilder sourceBuilder = SearchSourceBuilder.searchSource().query(QueryBuilders.matchAllQuery()).size(11);
             XContentBuilder builder = jsonBuilder();
             builder.value(sourceBuilder);
             expectedSource = BytesReference.bytes(builder);
-            request = new WatcherSearchTemplateRequest(expectedIndices, expectedTypes, expectedSearchType,
+            request = new WatcherSearchTemplateRequest(expectedIndices, expectedSearchType,
                     expectedIndicesOptions, expectedSource);
         }
 
@@ -142,12 +141,6 @@ public void testSerializeSearchRequest() throws Exception {
             assertThat(result.getTemplate().getIdOrCode(), equalTo(expectedSource.utf8ToString()));
             assertThat(result.getTemplate().getType(), equalTo(ScriptType.INLINE));
         }
-        if (expectedTypes == null) {
-            assertNull(result.getTypes());
-        } else {
-            assertThat(result.getTypes(), arrayContainingInAnyOrder(expectedTypes));
-            assertWarnings(WatcherSearchTemplateRequest.TYPES_DEPRECATION_MESSAGE);
-        }
     }
 
     public void testDeserializeSearchRequest() throws Exception {
@@ -164,16 +157,6 @@ public void testDeserializeSearchRequest() throws Exception {
             }
         }
 
-        String[] types = Strings.EMPTY_ARRAY;
-        if (randomBoolean()) {
-            types = generateRandomStringArray(2, 5, false, false);
-            if (randomBoolean()) {
-                builder.array("types", types);
-            } else {
-                builder.field("types", Strings.arrayToCommaDelimitedString(types));
-            }
-        }
-
         IndicesOptions indicesOptions = WatcherSearchTemplateRequest.DEFAULT_INDICES_OPTIONS;
         if (randomBoolean()) {
             indicesOptions = IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(),
@@ -240,12 +223,6 @@ public void testDeserializeSearchRequest() throws Exception {
             assertThat(result.getTemplate().getParams(), equalTo(template.getParams()));
             assertThat(result.getTemplate().getLang(), equalTo(stored ? null : "mustache"));
         }
-        if (types == Strings.EMPTY_ARRAY) {
-            assertNull(result.getTypes());
-        } else {
-            assertThat(result.getTypes(), arrayContainingInAnyOrder(types));
-            assertWarnings(WatcherSearchTemplateRequest.TYPES_DEPRECATION_MESSAGE);
-        }
     }
 
 }
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/support/search/WatcherSearchTemplateRequestTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/support/search/WatcherSearchTemplateRequestTests.java
index c535e1036824a..07fd3c7765485 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/support/search/WatcherSearchTemplateRequestTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/support/search/WatcherSearchTemplateRequestTests.java
@@ -39,24 +39,6 @@ public void testDefaultHitCountsConfigured() throws IOException {
         assertHitCount(source, hitCountsAsInt);
     }
 
-    public void testDeprecationForSingleType() throws IOException {
-        String source = "{\"types\":\"mytype\"}";
-        try (XContentParser parser = createParser(JsonXContent.jsonXContent, source)) {
-            parser.nextToken();
-            WatcherSearchTemplateRequest.fromXContent(parser, SearchType.QUERY_THEN_FETCH);
-        }
-        assertWarnings(WatcherSearchTemplateRequest.TYPES_DEPRECATION_MESSAGE);
-    }
-
-    public void testDeprecationForMultiType() throws IOException {
-        String source = "{\"types\":[\"mytype1\",\"mytype2\"]}";
-        try (XContentParser parser = createParser(JsonXContent.jsonXContent, source)) {
-            parser.nextToken();
-            WatcherSearchTemplateRequest.fromXContent(parser, SearchType.QUERY_THEN_FETCH);
-        }
-        assertWarnings(WatcherSearchTemplateRequest.TYPES_DEPRECATION_MESSAGE);
-    }
-
     private void assertHitCount(String source, boolean expectedHitCountAsInt) throws IOException {
         try (XContentParser parser = createParser(JsonXContent.jsonXContent, source)) {
             parser.nextToken();
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/WatcherTestUtils.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/WatcherTestUtils.java
index c10f010f98ef3..a01aa0293bbdc 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/WatcherTestUtils.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/WatcherTestUtils.java
@@ -92,7 +92,7 @@ public static WatcherSearchTemplateRequest templateRequest(SearchSourceBuilder s
         try {
             XContentBuilder xContentBuilder = jsonBuilder();
             xContentBuilder.value(sourceBuilder);
-            return new WatcherSearchTemplateRequest(indices, null, searchType,
+            return new WatcherSearchTemplateRequest(indices, searchType,
                     WatcherSearchTemplateRequest.DEFAULT_INDICES_OPTIONS, BytesReference.bytes(xContentBuilder));
         } catch (IOException e) {
             throw new RuntimeException(e);
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/integration/BasicWatcherTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/integration/BasicWatcherTests.java
index 9b401a57c5f44..34755cd143ac3 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/integration/BasicWatcherTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/test/integration/BasicWatcherTests.java
@@ -223,7 +223,7 @@ public void testConditionSearchWithIndexedTemplate() throws Exception {
                 .get());
 
         Script template = new Script(ScriptType.STORED, null, "my-template", Collections.emptyMap());
-        WatcherSearchTemplateRequest searchRequest = new WatcherSearchTemplateRequest(new String[]{"events"}, new String[0],
+        WatcherSearchTemplateRequest searchRequest = new WatcherSearchTemplateRequest(new String[]{"events"},
                 SearchType.DEFAULT, WatcherSearchTemplateRequest.DEFAULT_INDICES_OPTIONS, template);
         testConditionSearch(searchRequest);
     }

From 067bc72642f437217f7a62d83e37e9a3d5a84ae2 Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Fri, 17 Jan 2020 10:13:26 +0000
Subject: [PATCH 632/686] Remove the AllFieldMapper from master (#51106)

We have a few references left in master to the AllFieldMapper, which was deprecated
in the 6x line and only kept in 7x for backwards compatibility. These references can be
removed entirely in master.
---
 .../index/mapper/AllFieldMapper.java          | 175 ------------------
 .../indices/mapper/MapperRegistry.java        |   9 +-
 .../indices/IndicesModuleTests.java           |   6 -
 3 files changed, 1 insertion(+), 189 deletions(-)
 delete mode 100644 server/src/main/java/org/elasticsearch/index/mapper/AllFieldMapper.java

diff --git a/server/src/main/java/org/elasticsearch/index/mapper/AllFieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/AllFieldMapper.java
deleted file mode 100644
index 1427e67c5389b..0000000000000
--- a/server/src/main/java/org/elasticsearch/index/mapper/AllFieldMapper.java
+++ /dev/null
@@ -1,175 +0,0 @@
-/*
- * Licensed to Elasticsearch under one or more contributor
- * license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright
- * ownership. Elasticsearch licenses this file to you under
- * the Apache License, Version 2.0 (the "License"); you may
- * not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.elasticsearch.index.mapper;
-
-import org.apache.lucene.index.IndexOptions;
-import org.apache.lucene.index.IndexableField;
-import org.apache.lucene.search.MatchNoDocsQuery;
-import org.apache.lucene.search.Query;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.xcontent.XContentBuilder;
-import org.elasticsearch.common.xcontent.support.XContentMapValues;
-import org.elasticsearch.index.query.QueryShardContext;
-
-import java.io.IOException;
-import java.util.Iterator;
-import java.util.List;
-import java.util.Map;
-
-/**
- * Noop mapper that ensures that mappings created in 6x that explicitly disable the _all field
- * can be restored in this version.
- *
- * TODO: Remove in 8
- */
-public class AllFieldMapper extends MetadataFieldMapper {
-    public static final String NAME = "_all";
-    public static final String CONTENT_TYPE = "_all";
-
-    public static class Defaults {
-        public static final MappedFieldType FIELD_TYPE = new AllFieldType();
-
-        static {
-            FIELD_TYPE.setIndexOptions(IndexOptions.DOCS_AND_FREQS_AND_POSITIONS);
-            FIELD_TYPE.setTokenized(true);
-            FIELD_TYPE.setName(NAME);
-            FIELD_TYPE.freeze();
-        }
-    }
-
-    public static class Builder extends MetadataFieldMapper.Builder<Builder, AllFieldMapper> {
-        private boolean disableExplicit = false;
-
-        public Builder(MappedFieldType existing) {
-            super(NAME, existing == null ? Defaults.FIELD_TYPE : existing, Defaults.FIELD_TYPE);
-            builder = this;
-        }
-
-        private Builder setDisableExplicit() {
-            this.disableExplicit = true;
-            return this;
-        }
-
-        @Override
-        public AllFieldMapper build(BuilderContext context) {
-            return new AllFieldMapper(fieldType, context.indexSettings(), disableExplicit);
-        }
-    }
-
-    public static class TypeParser implements MetadataFieldMapper.TypeParser {
-        @Override
-        public MetadataFieldMapper.Builder<?,?> parse(String name, Map<String, Object> node,
-                                                 ParserContext parserContext) throws MapperParsingException {
-            Builder builder = new Builder(parserContext.mapperService().fullName(NAME));
-            for (Iterator<Map.Entry<String, Object>> iterator = node.entrySet().iterator(); iterator.hasNext();) {
-                Map.Entry<String, Object> entry = iterator.next();
-                String fieldName = entry.getKey();
-                if (fieldName.equals("enabled")) {
-                    boolean enabled = XContentMapValues.nodeBooleanValue(entry.getValue(), "enabled");
-                    if (enabled) {
-                        throw new IllegalArgumentException("[_all] is disabled in this version.");
-                    }
-                    builder.setDisableExplicit();
-                    iterator.remove();
-                }
-            }
-            return builder;
-        }
-
-        @Override
-        public MetadataFieldMapper getDefault(MappedFieldType fieldType, ParserContext context) {
-            final Settings indexSettings = context.mapperService().getIndexSettings().getSettings();
-            return new AllFieldMapper(indexSettings, Defaults.FIELD_TYPE, false);
-        }
-    }
-
-    static final class AllFieldType extends StringFieldType {
-        AllFieldType() {
-        }
-
-        protected AllFieldType(AllFieldType ref) {
-            super(ref);
-        }
-
-        @Override
-        public MappedFieldType clone() {
-            return new AllFieldType(this);
-        }
-
-        @Override
-        public String typeName() {
-            return CONTENT_TYPE;
-        }
-
-        @Override
-        public Query existsQuery(QueryShardContext context) {
-            return new MatchNoDocsQuery();
-        }
-    }
-
-    private final boolean disableExplicit;
-
-    private AllFieldMapper(Settings indexSettings, MappedFieldType existing, boolean disableExplicit) {
-        this(existing.clone(), indexSettings, disableExplicit);
-    }
-
-    private AllFieldMapper(MappedFieldType fieldType, Settings indexSettings, boolean disableExplicit) {
-        super(NAME, fieldType, Defaults.FIELD_TYPE, indexSettings);
-        this.disableExplicit = disableExplicit;
-    }
-
-    @Override
-    public void preParse(ParseContext context) throws IOException {
-    }
-
-    @Override
-    public void postParse(ParseContext context) throws IOException {
-        super.parse(context);
-    }
-
-    @Override
-    public void parse(ParseContext context) throws IOException {
-        // we parse in post parse
-    }
-
-    @Override
-    protected void parseCreateField(ParseContext context, List<IndexableField> fields) throws IOException {
-        // noop mapper
-        return;
-    }
-
-    @Override
-    protected String contentType() {
-        return CONTENT_TYPE;
-    }
-
-    @Override
-    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-        boolean includeDefaults = params.paramAsBoolean("include_defaults", false);
-        if (includeDefaults || disableExplicit) {
-            builder.startObject(CONTENT_TYPE);
-            if (disableExplicit) {
-                builder.field("enabled", false);
-            }
-            builder.endObject();
-        }
-        return builder;
-    }
-}
diff --git a/server/src/main/java/org/elasticsearch/indices/mapper/MapperRegistry.java b/server/src/main/java/org/elasticsearch/indices/mapper/MapperRegistry.java
index c79da36200e4f..b185067d4d032 100644
--- a/server/src/main/java/org/elasticsearch/indices/mapper/MapperRegistry.java
+++ b/server/src/main/java/org/elasticsearch/indices/mapper/MapperRegistry.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.indices.mapper;
 
 import org.elasticsearch.Version;
-import org.elasticsearch.index.mapper.AllFieldMapper;
 import org.elasticsearch.index.mapper.Mapper;
 import org.elasticsearch.index.mapper.MetadataFieldMapper;
 import org.elasticsearch.plugins.MapperPlugin;
@@ -38,7 +37,6 @@ public final class MapperRegistry {
 
     private final Map<String, Mapper.TypeParser> mapperParsers;
     private final Map<String, MetadataFieldMapper.TypeParser> metadataMapperParsers;
-    private final Map<String, MetadataFieldMapper.TypeParser> metadataMapperParsers6x;
     private final Function<String, Predicate<String>> fieldFilter;
 
 
@@ -46,11 +44,6 @@ public MapperRegistry(Map<String, Mapper.TypeParser> mapperParsers,
             Map<String, MetadataFieldMapper.TypeParser> metadataMapperParsers, Function<String, Predicate<String>> fieldFilter) {
         this.mapperParsers = Collections.unmodifiableMap(new LinkedHashMap<>(mapperParsers));
         this.metadataMapperParsers = Collections.unmodifiableMap(new LinkedHashMap<>(metadataMapperParsers));
-        // add the _all field mapper for indices created in 6x
-        Map<String, MetadataFieldMapper.TypeParser> metadata6x = new LinkedHashMap<>();
-        metadata6x.put(AllFieldMapper.NAME, new AllFieldMapper.TypeParser());
-        metadata6x.putAll(metadataMapperParsers);
-        this.metadataMapperParsers6x = Collections.unmodifiableMap(metadata6x);
         this.fieldFilter = fieldFilter;
     }
 
@@ -67,7 +60,7 @@ public Map<String, Mapper.TypeParser> getMapperParsers() {
      * returned map uses the name of the field as a key.
      */
     public Map<String, MetadataFieldMapper.TypeParser> getMetadataMapperParsers(Version indexCreatedVersion) {
-        return indexCreatedVersion.onOrAfter(Version.V_7_0_0) ? metadataMapperParsers : metadataMapperParsers6x;
+        return metadataMapperParsers;
     }
 
     /**
diff --git a/server/src/test/java/org/elasticsearch/indices/IndicesModuleTests.java b/server/src/test/java/org/elasticsearch/indices/IndicesModuleTests.java
index 6254449df05a6..c97bd6f217f10 100644
--- a/server/src/test/java/org/elasticsearch/indices/IndicesModuleTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/IndicesModuleTests.java
@@ -20,7 +20,6 @@
 package org.elasticsearch.indices;
 
 import org.elasticsearch.Version;
-import org.elasticsearch.index.mapper.AllFieldMapper;
 import org.elasticsearch.index.mapper.FieldNamesFieldMapper;
 import org.elasticsearch.index.mapper.IdFieldMapper;
 import org.elasticsearch.index.mapper.IgnoredFieldMapper;
@@ -90,11 +89,6 @@ public Map<String, MetadataFieldMapper.TypeParser> getMetadataMappers() {
             RoutingFieldMapper.NAME, IndexFieldMapper.NAME, SourceFieldMapper.NAME, TypeFieldMapper.NAME,
             VersionFieldMapper.NAME, SeqNoFieldMapper.NAME, FieldNamesFieldMapper.NAME};
 
-    private static String[] EXPECTED_METADATA_FIELDS_6x = new String[]{AllFieldMapper.NAME, IgnoredFieldMapper.NAME,
-        IdFieldMapper.NAME, RoutingFieldMapper.NAME, IndexFieldMapper.NAME, SourceFieldMapper.NAME, TypeFieldMapper.NAME,
-        VersionFieldMapper.NAME, SeqNoFieldMapper.NAME, FieldNamesFieldMapper.NAME};
-
-
     public void testBuiltinMappers() {
         IndicesModule module = new IndicesModule(Collections.emptyList());
         {

From 16e891bd80e83364d03e12af87d1e052a881a5d6 Mon Sep 17 00:00:00 2001
From: Dimitris Athanasiou <dimitris@elastic.co>
Date: Fri, 17 Jan 2020 12:24:17 +0200
Subject: [PATCH 633/686] [ML] DF Analytics _explain API should skip object
 fields (#51115)

Object fields cannot be used as features. At the moment _explain
API includes them and even worse it allows it does not error when
an object field is excluded. This creates the expectation to the
user that all children fields will also be excluded while it's not
the case.

This commit omits object fields from the _explain API and also
adds an error if an object field is included or excluded.
---
 .../apis/explain-dfanalytics.asciidoc         |  5 ++-
 .../extractor/ExtractedFieldsDetector.java    | 31 +++++++++++++
 .../ExtractedFieldsDetectorTests.java         | 43 +++++++++++++++++++
 3 files changed, 77 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
index ea3ed38d85c2f..ade8dc5c81ef3 100644
--- a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
@@ -45,9 +45,10 @@ The following explanations are provided:
 
 * which fields are included or not in the analysis and why,
 * how much memory is estimated to be required. The estimate can be used when 
-  deciding the appropriate value for `model_memory_limit` setting later on,
+  deciding the appropriate value for `model_memory_limit` setting later on.
 
-about either an existing {dfanalytics-job} or one that has not been created yet.
+If you have object fields or fields that are excluded via source filtering,
+they are not included in the explanation.
 
 
 [[ml-explain-dfanalytics-path-params]]
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
index ba33d63ec3a9d..0a7e7eb5662c9 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetector.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.common.regex.Regex;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.mapper.BooleanFieldMapper;
+import org.elasticsearch.index.mapper.ObjectMapper;
 import org.elasticsearch.search.fetch.subphase.FetchSourceContext;
 import org.elasticsearch.xpack.core.ml.dataframe.DataFrameAnalyticsConfig;
 import org.elasticsearch.xpack.core.ml.dataframe.analyses.DataFrameAnalysis;
@@ -40,6 +41,7 @@
 import java.util.Set;
 import java.util.TreeSet;
 import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 public class ExtractedFieldsDetector {
 
@@ -82,6 +84,7 @@ private Set<String> getIncludedFields(Set<FieldSelection> fieldSelection) {
         Set<String> fields = new TreeSet<>(fieldCapabilitiesResponse.get().keySet());
         fields.removeAll(IGNORE_FIELDS);
         removeFieldsUnderResultsField(fields);
+        removeObjects(fields);
         applySourceFiltering(fields);
         FetchSourceContext analyzedFields = config.getAnalyzedFields();
 
@@ -112,6 +115,17 @@ private void removeFieldsUnderResultsField(Set<String> fields) {
         fields.removeIf(field -> field.startsWith(resultsField + "."));
     }
 
+    private void removeObjects(Set<String> fields) {
+        Iterator<String> fieldsIterator = fields.iterator();
+        while (fieldsIterator.hasNext()) {
+            String field = fieldsIterator.next();
+            Set<String> types = getMappingTypes(field);
+            if (isObject(types)) {
+                fieldsIterator.remove();
+            }
+        }
+    }
+
     private void applySourceFiltering(Set<String> fields) {
         Iterator<String> fieldsIterator = fields.iterator();
         while (fieldsIterator.hasNext()) {
@@ -178,6 +192,9 @@ private void includeAndExcludeFields(Set<String> fields, Set<FieldSelection> fie
         if (analyzedFields == null) {
             return;
         }
+
+        checkIncludesExcludesAreNotObjects(analyzedFields);
+
         String includes = analyzedFields.includes().length == 0 ? "*" : Strings.arrayToCommaDelimitedString(analyzedFields.includes());
         String excludes = Strings.arrayToCommaDelimitedString(analyzedFields.excludes());
 
@@ -205,6 +222,16 @@ private void includeAndExcludeFields(Set<String> fields, Set<FieldSelection> fie
         }
     }
 
+    private void checkIncludesExcludesAreNotObjects(FetchSourceContext analyzedFields) {
+        List<String> objectFields = Stream.concat(Arrays.stream(analyzedFields.includes()), Arrays.stream(analyzedFields.excludes()))
+            .filter(field -> isObject(getMappingTypes(field)))
+            .collect(Collectors.toList());
+        if (objectFields.isEmpty() == false) {
+            throw ExceptionsHelper.badRequestException("{} must not include or exclude object fields: {}",
+                DataFrameAnalyticsConfig.ANALYZED_FIELDS.getPreferredName(), objectFields);
+        }
+    }
+
     private void applyIncludesExcludes(Set<String> fields, Set<String> includes, Set<String> excludes,
                                        Set<FieldSelection> fieldSelection) {
         Iterator<String> fieldsIterator = fields.iterator();
@@ -394,4 +421,8 @@ static Set<String> getCategoricalFields(ExtractedFields extractedFields, DataFra
     private static boolean isBoolean(Set<String> types) {
         return types.size() == 1 && types.contains(BooleanFieldMapper.CONTENT_TYPE);
     }
+
+    private boolean isObject(Set<String> types) {
+        return types.size() == 1 && types.contains(ObjectMapper.CONTENT_TYPE);
+    }
 }
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
index 47776b85ae8db..983ebce303b65 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/extractor/ExtractedFieldsDetectorTests.java
@@ -861,6 +861,49 @@ public void testDetect_GivenSourceFilteringWithExcludes() {
             FieldSelection.included("field_22", Collections.singleton("float"), false, FieldSelection.FeatureType.NUMERICAL));
     }
 
+    public void testDetect_GivenObjectFields() {
+        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
+            .addAggregatableField("float_field", "float")
+            .addNonAggregatableField("object_field_1", "object")
+            .addNonAggregatableField("object_field_2", "object").build();
+
+        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
+        Tuple<ExtractedFields, List<FieldSelection>> fieldExtraction = extractedFieldsDetector.detect();
+
+        List<ExtractedField> allFields = fieldExtraction.v1().getAllFields();
+        assertThat(allFields, hasSize(1));
+        assertThat(allFields.get(0).getName(), equalTo("float_field"));
+    }
+
+    public void testDetect_GivenAnalyzedFieldIncludesObjectField() {
+        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
+            .addAggregatableField("float_field", "float")
+            .addNonAggregatableField("object_field", "object").build();
+
+        analyzedFields = new FetchSourceContext(true, new String[] { "float_field", "object_field" }, null);
+
+        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
+
+        assertThat(e.getMessage(), equalTo("analyzed_fields must not include or exclude object fields: [object_field]"));
+    }
+
+    public void testDetect_GivenAnalyzedFieldExcludesObjectField() {
+        FieldCapabilitiesResponse fieldCapabilities = new MockFieldCapsResponseBuilder()
+            .addAggregatableField("float_field", "float")
+            .addNonAggregatableField("object_field", "object").build();
+
+        analyzedFields = new FetchSourceContext(true, null, new String[] { "object_field" });
+
+        ExtractedFieldsDetector extractedFieldsDetector = new ExtractedFieldsDetector(
+            SOURCE_INDEX, buildOutlierDetectionConfig(), 100, fieldCapabilities, Collections.emptyMap());
+        ElasticsearchStatusException e = expectThrows(ElasticsearchStatusException.class, extractedFieldsDetector::detect);
+
+        assertThat(e.getMessage(), equalTo("analyzed_fields must not include or exclude object fields: [object_field]"));
+    }
+
     private DataFrameAnalyticsConfig buildOutlierDetectionConfig() {
         return new DataFrameAnalyticsConfig.Builder()
             .setId("foo")

From a46fed182e0ab3ffb44bda8e1c6d31392a10ed94 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Witek?= <przemyslaw.witek@elastic.co>
Date: Fri, 17 Jan 2020 12:26:21 +0100
Subject: [PATCH 634/686] [ML] Fix tests randomly failing on CI (#51142)

---
 ...rameAnalyticsStatsActionResponseTests.java |  5 ++-
 .../ml/dataframe/DataFrameAnalyticsTask.java  | 21 +++++------
 .../DataFrameAnalyticsTaskTests.java          | 36 ++++++-------------
 3 files changed, 24 insertions(+), 38 deletions(-)

diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/GetDataFrameAnalyticsStatsActionResponseTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/GetDataFrameAnalyticsStatsActionResponseTests.java
index 602ebe8543978..84c77a5fb38b1 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/GetDataFrameAnalyticsStatsActionResponseTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/action/GetDataFrameAnalyticsStatsActionResponseTests.java
@@ -19,8 +19,7 @@
 
 public class GetDataFrameAnalyticsStatsActionResponseTests extends AbstractWireSerializingTestCase<Response> {
 
-    public static Response randomResponse() {
-        int listSize = randomInt(10);
+    public static Response randomResponse(int listSize) {
         List<Response.Stats> analytics = new ArrayList<>(listSize);
         for (int j = 0; j < listSize; j++) {
             String failureReason = randomBoolean() ? null : randomAlphaOfLength(10);
@@ -37,7 +36,7 @@ public static Response randomResponse() {
 
     @Override
     protected Response createTestInstance() {
-        return randomResponse();
+        return randomResponse(randomInt(10));
     }
 
     @Override
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
index 0ac70286da2a0..fdc0ea079f7e6 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTask.java
@@ -121,12 +121,12 @@ public void markAsCompleted() {
             isMarkAsCompletedCalled = true;
         }
 
-        persistProgress(() -> super.markAsCompleted());
+        persistProgress(client, taskParams.getId(), () -> super.markAsCompleted());
     }
 
     @Override
     public void markAsFailed(Exception e) {
-        persistProgress(() -> super.markAsFailed(e));
+        persistProgress(client, taskParams.getId(), () -> super.markAsFailed(e));
     }
 
     public void stop(String reason, TimeValue timeout) {
@@ -244,21 +244,22 @@ private TaskId getReindexTaskId() {
         }
     }
 
-    private void persistProgress(Runnable runnable) {
-        LOGGER.debug("[{}] Persisting progress", taskParams.getId());
+    // Visible for testing
+    static void persistProgress(Client client, String jobId, Runnable runnable) {
+        LOGGER.debug("[{}] Persisting progress", jobId);
 
-        String progressDocId = StoredProgress.documentId(taskParams.getId());
+        String progressDocId = StoredProgress.documentId(jobId);
         SetOnce<GetDataFrameAnalyticsStatsAction.Response.Stats> stats = new SetOnce<>();
 
         // Step 4: Run the runnable provided as the argument
         ActionListener<IndexResponse> indexProgressDocListener = ActionListener.wrap(
             indexResponse -> {
-                LOGGER.debug("[{}] Successfully indexed progress document", taskParams.getId());
+                LOGGER.debug("[{}] Successfully indexed progress document", jobId);
                 runnable.run();
             },
             indexError -> {
                 LOGGER.error(new ParameterizedMessage(
-                    "[{}] cannot persist progress as an error occurred while indexing", taskParams.getId()), indexError);
+                    "[{}] cannot persist progress as an error occurred while indexing", jobId), indexError);
                 runnable.run();
             }
         );
@@ -283,7 +284,7 @@ private void persistProgress(Runnable runnable) {
             },
             e -> {
                 LOGGER.error(new ParameterizedMessage(
-                    "[{}] cannot persist progress as an error occurred while retrieving former progress document", taskParams.getId()), e);
+                    "[{}] cannot persist progress as an error occurred while retrieving former progress document", jobId), e);
                 runnable.run();
             }
         );
@@ -302,13 +303,13 @@ private void persistProgress(Runnable runnable) {
             },
             e -> {
                 LOGGER.error(new ParameterizedMessage(
-                    "[{}] cannot persist progress as an error occurred while retrieving stats", taskParams.getId()), e);
+                    "[{}] cannot persist progress as an error occurred while retrieving stats", jobId), e);
                 runnable.run();
             }
         );
 
         // Step 1: Fetch progress to be persisted
-        GetDataFrameAnalyticsStatsAction.Request getStatsRequest = new GetDataFrameAnalyticsStatsAction.Request(taskParams.getId());
+        GetDataFrameAnalyticsStatsAction.Request getStatsRequest = new GetDataFrameAnalyticsStatsAction.Request(jobId);
         executeAsyncWithOrigin(client, ML_ORIGIN, GetDataFrameAnalyticsStatsAction.INSTANCE, getStatsRequest, getStatsListener);
     }
 
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTaskTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTaskTests.java
index bc3d3c253259c..6e90b9d8f8d32 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTaskTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/dataframe/DataFrameAnalyticsTaskTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.ml.dataframe;
 
-import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.index.IndexAction;
 import org.elasticsearch.action.index.IndexRequest;
@@ -13,7 +12,6 @@
 import org.elasticsearch.action.search.SearchAction;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.client.Client;
-import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.search.SearchHit;
@@ -22,10 +20,8 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.core.ml.action.GetDataFrameAnalyticsStatsAction;
 import org.elasticsearch.xpack.core.ml.action.GetDataFrameAnalyticsStatsActionResponseTests;
-import org.elasticsearch.xpack.core.ml.action.StartDataFrameAnalyticsAction.TaskParams;
 import org.elasticsearch.xpack.core.ml.utils.PhaseProgress;
 import org.elasticsearch.xpack.ml.dataframe.DataFrameAnalyticsTask.StartingState;
-import org.elasticsearch.xpack.ml.notifications.DataFrameAnalyticsAuditor;
 import org.mockito.ArgumentCaptor;
 import org.mockito.InOrder;
 import org.mockito.stubbing.Answer;
@@ -116,13 +112,13 @@ public void testDetermineStartingState_GivenEmptyProgress() {
         assertThat(startingState, equalTo(StartingState.FINISHED));
     }
 
-    private void testMarkAsCompleted(SearchHits searchHits, String expectedIndexOrAlias) {
+    private void testPersistProgress(SearchHits searchHits, String expectedIndexOrAlias) {
         Client client = mock(Client.class);
         ThreadPool threadPool = mock(ThreadPool.class);
         when(threadPool.getThreadContext()).thenReturn(new ThreadContext(Settings.EMPTY));
         when(client.threadPool()).thenReturn(threadPool);
 
-        GetDataFrameAnalyticsStatsAction.Response getStatsResponse = GetDataFrameAnalyticsStatsActionResponseTests.randomResponse();
+        GetDataFrameAnalyticsStatsAction.Response getStatsResponse = GetDataFrameAnalyticsStatsActionResponseTests.randomResponse(1);
         doAnswer(withResponse(getStatsResponse)).when(client).execute(eq(GetDataFrameAnalyticsStatsAction.INSTANCE), any(), any());
 
         SearchResponse searchResponse = mock(SearchResponse.class);
@@ -132,27 +128,17 @@ private void testMarkAsCompleted(SearchHits searchHits, String expectedIndexOrAl
         IndexResponse indexResponse = mock(IndexResponse.class);
         doAnswer(withResponse(indexResponse)).when(client).execute(eq(IndexAction.INSTANCE), any(), any());
 
-        TaskParams taskParams = new TaskParams("task_id", Version.CURRENT, Collections.emptyList(), false);
-        DataFrameAnalyticsTask task =
-            new DataFrameAnalyticsTask(
-                0,
-                "",
-                "",
-                null,
-                null,
-                client,
-                mock(ClusterService.class),
-                mock(DataFrameAnalyticsManager.class),
-                mock(DataFrameAnalyticsAuditor.class),
-                taskParams);
-        task.markAsCompleted();
+        Runnable runnable = mock(Runnable.class);
+
+        DataFrameAnalyticsTask.persistProgress(client, "task_id", runnable);
 
         ArgumentCaptor<IndexRequest> indexRequestCaptor = ArgumentCaptor.forClass(IndexRequest.class);
 
-        InOrder inOrder = inOrder(client);
+        InOrder inOrder = inOrder(client, runnable);
         inOrder.verify(client).execute(eq(GetDataFrameAnalyticsStatsAction.INSTANCE), any(), any());
         inOrder.verify(client).execute(eq(SearchAction.INSTANCE), any(), any());
         inOrder.verify(client).execute(eq(IndexAction.INSTANCE), indexRequestCaptor.capture(), any());
+        inOrder.verify(runnable).run();
         inOrder.verifyNoMoreInteractions();
 
         IndexRequest indexRequest = indexRequestCaptor.getValue();
@@ -160,12 +146,12 @@ private void testMarkAsCompleted(SearchHits searchHits, String expectedIndexOrAl
         assertThat(indexRequest.id(), equalTo("data_frame_analytics-task_id-progress"));
     }
 
-    public void testMarkAsCompleted_ProgressDocumentCreated() {
-        testMarkAsCompleted(SearchHits.empty(), ".ml-state-write");
+    public void testPersistProgress_ProgressDocumentCreated() {
+        testPersistProgress(SearchHits.empty(), ".ml-state-write");
     }
 
-    public void testMarkAsCompleted_ProgressDocumentUpdated() {
-        testMarkAsCompleted(
+    public void testPersistProgress_ProgressDocumentUpdated() {
+        testPersistProgress(
             new SearchHits(new SearchHit[]{ SearchHit.createFromMap(Map.of("_index", ".ml-state-dummy")) }, null, 0.0f),
             ".ml-state-dummy");
     }

From 95aca0492b8a60910fb6b41a47b323e89f914168 Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Fri, 17 Jan 2020 12:57:05 +0100
Subject: [PATCH 635/686] increase timeout of DocsClientYamlTestSuiteIT

increase timeout of DocsClientYamlTestSuiteIT to 35 minutes, temporary solution for issue #49753
---
 .../elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java b/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
index ff796aba81d69..bd35630d2c7fd 100644
--- a/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
+++ b/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
@@ -22,6 +22,7 @@
 import com.carrotsearch.randomizedtesting.annotations.Name;
 import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
 import com.carrotsearch.randomizedtesting.annotations.TimeoutSuite;
+
 import org.apache.http.HttpHost;
 import org.apache.lucene.util.BytesRef;
 import org.apache.lucene.util.TimeUnits;
@@ -57,7 +58,8 @@
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 
 //The default 20 minutes timeout isn't always enough, please do not increase further than 30 before analyzing what makes this suite so slow
-@TimeoutSuite(millis = 30 * TimeUnits.MINUTE)
+// gh#49753 increasing timeout to 35 minutes until this gets fixes properly
+@TimeoutSuite(millis = 35 * TimeUnits.MINUTE)
 public class DocsClientYamlTestSuiteIT extends ESClientYamlSuiteTestCase {
 
     public DocsClientYamlTestSuiteIT(@Name("yaml") ClientYamlTestCandidate testCandidate) {

From 27db4d993d322af060861164a7f021abff2bf5e6 Mon Sep 17 00:00:00 2001
From: Ioannis Kakavas <ioannis@elastic.co>
Date: Fri, 17 Jan 2020 15:50:40 +0200
Subject: [PATCH 636/686] Don't fallback to anonymous for tokens/apikeys
 (#51042)

This commit changes our behavior so that when we receive a
request with an invalid/expired/wrong access token or API Key
we do not fallback to authenticating as the anonymous user even if
anonymous access is enabled for Elasticsearch.
---
 .../security/authc/AuthenticationService.java | 17 +++++-
 .../authc/AuthenticationServiceTests.java     | 54 +++++++++++++++++++
 2 files changed, 70 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/AuthenticationService.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/AuthenticationService.java
index 20289c5f09e91..f94e198c0e359 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/AuthenticationService.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/AuthenticationService.java
@@ -460,6 +460,7 @@ private List<Realm> getRealmList(String principal) {
          * <ul>
          * <li>this is an initial request from a client without preemptive authentication, so we must return an authentication
          * challenge</li>
+         * <li>this is a request that contained an Authorization Header that we can't validate </li>
          * <li>this is a request made internally within a node and there is a fallback user, which is typically the
          * {@link SystemUser}</li>
          * <li>anonymous access is enabled and this will be considered an anonymous request</li>
@@ -475,7 +476,7 @@ void handleNullToken() {
                 RealmRef authenticatedBy = new RealmRef("__fallback", "__fallback", nodeName);
                 authentication = new Authentication(fallbackUser, authenticatedBy, null, Version.CURRENT, AuthenticationType.INTERNAL,
                     Collections.emptyMap());
-            } else if (isAnonymousUserEnabled) {
+            } else if (isAnonymousUserEnabled && shouldFallbackToAnonymous()) {
                 logger.trace("No valid credentials found in request [{}], using anonymous [{}]", request, anonymousUser.principal());
                 RealmRef authenticatedBy = new RealmRef("__anonymous", "__anonymous", nodeName);
                 authentication = new Authentication(anonymousUser, authenticatedBy, null, Version.CURRENT, AuthenticationType.ANONYMOUS,
@@ -499,6 +500,20 @@ void handleNullToken() {
             action.run();
         }
 
+        /**
+         * When an API Key or an Elasticsearch Token Service token is used for authentication and authentication fails (as indicated by
+         * a null AuthenticationToken) we should not fallback to the anonymous user.
+         */
+        boolean shouldFallbackToAnonymous(){
+            String header = threadContext.getHeader("Authorization");
+            if (Strings.hasText(header) &&
+                ((header.regionMatches(true, 0, "Bearer ", 0, "Bearer ".length()) && header.length() > "Bearer ".length()) ||
+                (header.regionMatches(true, 0, "ApiKey ", 0, "ApiKey ".length()) && header.length() > "ApiKey ".length()))) {
+                return false;
+            }
+            return true;
+        }
+
         /**
          * Consumes the {@link User} that resulted from attempting to authenticate a token against the {@link Realms}. When the user is
          * {@code null}, authentication fails and does not proceed. When there is a user, the request is inspected to see if the run as
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/AuthenticationServiceTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/AuthenticationServiceTests.java
index 532b9121c1a00..d85689e1678ee 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/AuthenticationServiceTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/AuthenticationServiceTests.java
@@ -99,6 +99,7 @@
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.Consumer;
 
+import static org.elasticsearch.index.seqno.SequenceNumbers.UNASSIGNED_PRIMARY_TERM;
 import static org.elasticsearch.test.SecurityTestsUtils.assertAuthenticationException;
 import static org.elasticsearch.xpack.core.security.support.Exceptions.authenticationError;
 import static org.elasticsearch.xpack.security.authc.TokenServiceTests.mockGetTokenFromId;
@@ -743,6 +744,59 @@ public void testAuthenticateTamperedUser() throws Exception {
         }
     }
 
+    public void testWrongTokenDoesNotFallbackToAnonymous() {
+        String username = randomBoolean() ? AnonymousUser.DEFAULT_ANONYMOUS_USERNAME : "user1";
+        Settings.Builder builder = Settings.builder()
+            .putList(AnonymousUser.ROLES_SETTING.getKey(), "r1", "r2", "r3");
+        if (username.equals(AnonymousUser.DEFAULT_ANONYMOUS_USERNAME) == false) {
+            builder.put(AnonymousUser.USERNAME_SETTING.getKey(), username);
+        }
+        Settings anonymousEnabledSettings = builder.build();
+        final AnonymousUser anonymousUser = new AnonymousUser(anonymousEnabledSettings);
+        service = new AuthenticationService(anonymousEnabledSettings, realms, auditTrail,
+            new DefaultAuthenticationFailureHandler(Collections.emptyMap()), threadPool, anonymousUser, tokenService, apiKeyService);
+
+        try (ThreadContext.StoredContext ignore = threadContext.stashContext()) {
+            final String reqId = AuditUtil.getOrGenerateRequestId(threadContext);
+            threadContext.putHeader("Authorization", "Bearer thisisaninvalidtoken");
+            ElasticsearchSecurityException e =
+                expectThrows(ElasticsearchSecurityException.class, () -> authenticateBlocking("_action", message, null));
+            verify(auditTrail).anonymousAccessDenied(reqId, "_action", message);
+            verifyNoMoreInteractions(auditTrail);
+            assertAuthenticationException(e);
+        }
+    }
+
+    public void testWrongApiKeyDoesNotFallbackToAnonymous() {
+        String username = randomBoolean() ? AnonymousUser.DEFAULT_ANONYMOUS_USERNAME : "user1";
+        Settings.Builder builder = Settings.builder()
+            .putList(AnonymousUser.ROLES_SETTING.getKey(), "r1", "r2", "r3");
+        if (username.equals(AnonymousUser.DEFAULT_ANONYMOUS_USERNAME) == false) {
+            builder.put(AnonymousUser.USERNAME_SETTING.getKey(), username);
+        }
+        Settings anonymousEnabledSettings = builder.build();
+        final AnonymousUser anonymousUser = new AnonymousUser(anonymousEnabledSettings);
+        service = new AuthenticationService(anonymousEnabledSettings, realms, auditTrail,
+            new DefaultAuthenticationFailureHandler(Collections.emptyMap()), threadPool, anonymousUser, tokenService, apiKeyService);
+        doAnswer(invocationOnMock -> {
+            final GetRequest request = (GetRequest) invocationOnMock.getArguments()[0];
+            final ActionListener<GetResponse> listener = (ActionListener<GetResponse>) invocationOnMock.getArguments()[1];
+            listener.onResponse(new GetResponse(new GetResult(request.index(), request.id(),
+                SequenceNumbers.UNASSIGNED_SEQ_NO, UNASSIGNED_PRIMARY_TERM, -1L, false, null,
+                Collections.emptyMap(), Collections.emptyMap())));
+            return Void.TYPE;
+        }).when(client).get(any(GetRequest.class), any(ActionListener.class));
+        try (ThreadContext.StoredContext ignore = threadContext.stashContext()) {
+            final String reqId = AuditUtil.getOrGenerateRequestId(threadContext);
+            threadContext.putHeader("Authorization", "ApiKey dGhpc2lzYW5pbnZhbGlkaWQ6dGhpc2lzYW5pbnZhbGlkc2VjcmV0");
+            ElasticsearchSecurityException e =
+                expectThrows(ElasticsearchSecurityException.class, () -> authenticateBlocking("_action", message, null));
+            verify(auditTrail).anonymousAccessDenied(reqId, "_action", message);
+            verifyNoMoreInteractions(auditTrail);
+            assertAuthenticationException(e);
+        }
+    }
+
     public void testAnonymousUserRest() throws Exception {
         String username = randomBoolean() ? AnonymousUser.DEFAULT_ANONYMOUS_USERNAME : "user1";
         Settings.Builder builder = Settings.builder()

From 281ae2586aa5bc4459bc6cba56162d3bb6d64d98 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 17 Jan 2020 10:41:14 -0500
Subject: [PATCH 637/686] "did you mean" for ObjectParser with top named
 (#51018)

When you declare an ObjectParser with top level named objects like we do
with `significant_terms` we didn't support "did you mean". This fixes
that.

Relates #50938
---
 .../NamedObjectNotFoundException.java         | 13 ++++++++----
 .../xcontent/NamedXContentRegistry.java       |  9 ++++----
 .../common/xcontent/ObjectParser.java         |  8 +++++--
 .../xcontent/XContentParseException.java      |  9 +-------
 .../common/xcontent/ObjectParserTests.java    |  5 ++++-
 .../test/search.aggregation/30_sig_terms.yml  | 15 +++++++++++++
 .../common/xcontent/BaseXContentTestCase.java |  9 +++++---
 .../xcontent/XContentParserUtilsTests.java    |  2 +-
 .../gateway/MetaDataStateFormatTests.java     | 21 ++++++++++++++++++-
 .../rescore/QueryRescorerBuilderTests.java    |  2 +-
 .../search/suggest/SuggestionTests.java       |  2 +-
 11 files changed, 68 insertions(+), 27 deletions(-)

diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/NamedObjectNotFoundException.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/NamedObjectNotFoundException.java
index ecc322b60d8fc..eea323ad7f33b 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/NamedObjectNotFoundException.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/NamedObjectNotFoundException.java
@@ -24,12 +24,17 @@
  * parse for a particular name
  */
 public class NamedObjectNotFoundException extends XContentParseException {
+    private final Iterable<String> candidates;
 
-    public NamedObjectNotFoundException(String message) {
-        this(null, message);
+    public NamedObjectNotFoundException(XContentLocation location, String message, Iterable<String> candidates) {
+        super(location, message);
+        this.candidates = candidates;
     }
 
-    public NamedObjectNotFoundException(XContentLocation location, String message) {
-        super(location, message);
+    /**
+     * The possible matches.
+     */
+    public Iterable<String> getCandidates() {
+        return candidates;
     }
 }
diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/NamedXContentRegistry.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/NamedXContentRegistry.java
index 9135bf648a19e..9efe568955f39 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/NamedXContentRegistry.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/NamedXContentRegistry.java
@@ -123,19 +123,18 @@ public <T, C> T parseNamedObject(Class<T> categoryClass, String name, XContentPa
         if (parsers == null) {
             if (registry.isEmpty()) {
                 // The "empty" registry will never work so we throw a better exception as a hint.
-                throw new NamedObjectNotFoundException("named objects are not supported for this parser");
+                throw new XContentParseException("named objects are not supported for this parser");
             }
-            throw new NamedObjectNotFoundException("unknown named object category [" + categoryClass.getName() + "]");
+            throw new XContentParseException("unknown named object category [" + categoryClass.getName() + "]");
         }
         Entry entry = parsers.get(name);
         if (entry == null) {
-            throw new NamedObjectNotFoundException(parser.getTokenLocation(), "unable to parse " + categoryClass.getSimpleName() +
-                " with name [" + name + "]: parser not found");
+            throw new NamedObjectNotFoundException(parser.getTokenLocation(), "unknown field [" + name + "]", parsers.keySet());
         }
         if (false == entry.name.match(name, parser.getDeprecationHandler())) {
             /* Note that this shouldn't happen because we already looked up the entry using the names but we need to call `match` anyway
              * because it is responsible for logging deprecation warnings. */
-            throw new NamedObjectNotFoundException(parser.getTokenLocation(),
+            throw new XContentParseException(parser.getTokenLocation(),
                     "unable to parse " + categoryClass.getSimpleName() + " with name [" + name + "]: parser didn't match");
         }
         return categoryClass.cast(entry.parser.parse(parser, context));
diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
index 478b4c1369463..30810637044d7 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/ObjectParser.java
@@ -27,8 +27,10 @@
 import java.util.Arrays;
 import java.util.EnumSet;
 import java.util.HashMap;
+import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
 import java.util.function.Consumer;
@@ -140,8 +142,10 @@ private static <Value, Category, Context> UnknownFieldParser<Value, Context> unk
             try {
                 o = parser.namedObject(categoryClass, field, context);
             } catch (NamedObjectNotFoundException e) {
-                // TODO It'd be lovely if we could the options here but we don't have the right stuff plumbed through. We'll get to it!
-                throw new XContentParseException(location, "[" + objectParser.name  + "] " + e.getBareMessage(), e);
+                Set<String> candidates = new HashSet<>(objectParser.fieldParserMap.keySet());
+                e.getCandidates().forEach(candidates::add);
+                String message = ErrorOnUnknown.IMPLEMENTATION.errorMessage(objectParser.name, field, candidates);
+                throw new XContentParseException(location, message, e);
             }
             consumer.accept(value, o);
         };
diff --git a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentParseException.java b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentParseException.java
index cf9d4ed6713d9..8a7a10d6ebb90 100644
--- a/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentParseException.java
+++ b/libs/x-content/src/main/java/org/elasticsearch/common/xcontent/XContentParseException.java
@@ -59,13 +59,6 @@ public XContentLocation getLocation() {
 
     @Override
     public String getMessage() {
-        return location.map(l -> "[" + l.toString() + "] ").orElse("") + getBareMessage();
-    }
-
-    /**
-     * Get the exception message without location information.
-     */
-    public String getBareMessage() {
-        return super.getMessage();
+        return location.map(l -> "[" + l.toString() + "] ").orElse("") + super.getMessage();
     }
 }
diff --git a/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java b/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
index 5b52d5b2e120d..ab56b8977ad5d 100644
--- a/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
+++ b/libs/x-content/src/test/java/org/elasticsearch/common/xcontent/ObjectParserTests.java
@@ -38,6 +38,7 @@
 import java.util.Map;
 import java.util.concurrent.atomic.AtomicReference;
 
+import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasSize;
@@ -803,7 +804,9 @@ public void testTopLevelNamedXContent() throws IOException {
         {
             XContentParser parser = createParser(JsonXContent.jsonXContent, "{\"not_supported_field\" : \"foo\"}");
             XContentParseException ex = expectThrows(XContentParseException.class, () -> TopLevelNamedXConent.PARSER.parse(parser, null));
-            assertEquals("[1:2] [test] unable to parse Object with name [not_supported_field]: parser not found", ex.getMessage());
+            assertEquals("[1:2] [test] unknown field [not_supported_field]", ex.getMessage());
+            NamedObjectNotFoundException cause = (NamedObjectNotFoundException) ex.getCause();
+            assertThat(cause.getCandidates(), containsInAnyOrder("str", "int", "float", "bool"));
         }
     }
 
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/30_sig_terms.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/30_sig_terms.yml
index 99d0f29a9b2ad..5204d65d33348 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/30_sig_terms.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/30_sig_terms.yml
@@ -137,3 +137,18 @@
       search:
         rest_total_hits_as_int: true
         body: { "size" : 0, "aggs" : { "ip_terms" : { "significant_terms" : { "field" : "ip", "exclude" :  "127.*"  } } } }
+
+---
+'Misspelled fields get "did you mean"':
+  - skip:
+      version: " - 7.99.99"
+      reason: Implemented in 8.0 (to be backported to 7.7)
+  - do:
+      catch: /\[significant_terms\] unknown field \[jlp\] did you mean \[jlh\]\?/
+      search:
+          body:
+            aggs:
+              foo:
+                significant_terms:
+                  field: foo
+                  jlp: {}
diff --git a/server/src/test/java/org/elasticsearch/common/xcontent/BaseXContentTestCase.java b/server/src/test/java/org/elasticsearch/common/xcontent/BaseXContentTestCase.java
index 4c2fcfbb589bf..860adf2c2333c 100644
--- a/server/src/test/java/org/elasticsearch/common/xcontent/BaseXContentTestCase.java
+++ b/server/src/test/java/org/elasticsearch/common/xcontent/BaseXContentTestCase.java
@@ -22,6 +22,7 @@
 import com.fasterxml.jackson.core.JsonGenerationException;
 import com.fasterxml.jackson.core.JsonGenerator;
 import com.fasterxml.jackson.core.JsonParseException;
+
 import org.apache.lucene.util.BytesRef;
 import org.apache.lucene.util.Constants;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
@@ -78,6 +79,7 @@
 import static java.util.Collections.emptyMap;
 import static java.util.Collections.singletonMap;
 import static org.hamcrest.Matchers.allOf;
+import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.endsWith;
 import static org.hamcrest.Matchers.equalTo;
@@ -1169,16 +1171,17 @@ public void testNamedObject() throws IOException {
             {
                 NamedObjectNotFoundException e = expectThrows(NamedObjectNotFoundException.class,
                     () -> p.namedObject(Object.class, "unknown", null));
-                assertThat(e.getMessage(), endsWith("unable to parse Object with name [unknown]: parser not found"));
+                assertThat(e.getMessage(), endsWith("unknown field [unknown]"));
+                assertThat(e.getCandidates(), containsInAnyOrder("test1", "test2", "deprecated", "str"));
             }
             {
-                Exception e = expectThrows(NamedObjectNotFoundException.class, () -> p.namedObject(String.class, "doesn't matter", null));
+                Exception e = expectThrows(XContentParseException.class, () -> p.namedObject(String.class, "doesn't matter", null));
                 assertEquals("unknown named object category [java.lang.String]", e.getMessage());
             }
         }
         try (XContentParser emptyRegistryParser = xcontentType().xContent()
             .createParser(NamedXContentRegistry.EMPTY, DeprecationHandler.THROW_UNSUPPORTED_OPERATION, new byte[] {})) {
-            Exception e = expectThrows(NamedObjectNotFoundException.class,
+            Exception e = expectThrows(XContentParseException.class,
                 () -> emptyRegistryParser.namedObject(String.class, "doesn't matter", null));
             assertEquals("named objects are not supported for this parser", e.getMessage());
         }
diff --git a/server/src/test/java/org/elasticsearch/common/xcontent/XContentParserUtilsTests.java b/server/src/test/java/org/elasticsearch/common/xcontent/XContentParserUtilsTests.java
index 5b65e6af7898b..db3dabdcafe49 100644
--- a/server/src/test/java/org/elasticsearch/common/xcontent/XContentParserUtilsTests.java
+++ b/server/src/test/java/org/elasticsearch/common/xcontent/XContentParserUtilsTests.java
@@ -190,7 +190,7 @@ public void testParseTypedKeysObject() throws IOException {
             ensureExpectedToken(XContentParser.Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation);
             NamedObjectNotFoundException e = expectThrows(NamedObjectNotFoundException.class,
                     () -> parseTypedKeysObject(parser, delimiter, Boolean.class, a -> {}));
-            assertThat(e.getMessage(), endsWith("unable to parse Boolean with name [type]: parser not found"));
+            assertThat(e.getMessage(), endsWith("unknown field [type]"));
         }
 
         final long longValue = randomLong();
diff --git a/server/src/test/java/org/elasticsearch/gateway/MetaDataStateFormatTests.java b/server/src/test/java/org/elasticsearch/gateway/MetaDataStateFormatTests.java
index c7dab0dc4d4a0..c2f04a8bd03b1 100644
--- a/server/src/test/java/org/elasticsearch/gateway/MetaDataStateFormatTests.java
+++ b/server/src/test/java/org/elasticsearch/gateway/MetaDataStateFormatTests.java
@@ -30,9 +30,12 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.Version;
+import org.elasticsearch.cluster.ClusterModule;
 import org.elasticsearch.cluster.metadata.IndexGraveyard;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.MetaData;
+import org.elasticsearch.cluster.metadata.RepositoriesMetaData;
+import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.collect.ImmutableOpenMap;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
@@ -277,7 +280,7 @@ private void runLoadStateTest(boolean hasMissingCustoms, boolean preserveUnknown
         List<Path> dirList = Arrays.asList(dirs);
         Collections.shuffle(dirList, random());
         MetaData loadedMetaData = format.loadLatestState(logger, hasMissingCustoms ?
-            NamedXContentRegistry.EMPTY : xContentRegistry(), dirList.toArray(new Path[0]));
+            xContentRegistryWithMissingCustoms() : xContentRegistry(), dirList.toArray(new Path[0]));
         MetaData latestMetaData = meta.get(numStates-1);
         assertThat(loadedMetaData.clusterUUID(), not(equalTo("_na_")));
         assertThat(loadedMetaData.clusterUUID(), equalTo(latestMetaData.clusterUUID()));
@@ -706,4 +709,20 @@ public long addDummyFiles(String prefix, Path... paths) throws IOException {
         }
         return realId + 1;
     }
+
+    /**
+     * The {@link NamedXContentRegistry} to use for most {@link XContentParser} in this test.
+     */
+    protected final NamedXContentRegistry xContentRegistry() {
+        return new NamedXContentRegistry(ClusterModule.getNamedXWriteables());
+    }
+
+    /**
+     * The {@link NamedXContentRegistry} to use for {@link XContentParser}s that should be
+     * missing all of the normal cluster state parsers.
+     */
+    protected NamedXContentRegistry xContentRegistryWithMissingCustoms() {
+        return new NamedXContentRegistry(Arrays.asList(
+                new NamedXContentRegistry.Entry(MetaData.Custom.class, new ParseField("garbage"), RepositoriesMetaData::fromXContent)));
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/search/rescore/QueryRescorerBuilderTests.java b/server/src/test/java/org/elasticsearch/search/rescore/QueryRescorerBuilderTests.java
index dfcc65afb5c65..e22daab2e89cf 100644
--- a/server/src/test/java/org/elasticsearch/search/rescore/QueryRescorerBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/rescore/QueryRescorerBuilderTests.java
@@ -223,7 +223,7 @@ public void testUnknownFieldsExpection() throws IOException {
             "}\n";
         try (XContentParser parser = createParser(rescoreElement)) {
             Exception e = expectThrows(NamedObjectNotFoundException.class, () -> RescorerBuilder.parseFromXContent(parser));
-            assertEquals("[3:27] unable to parse RescorerBuilder with name [bad_rescorer_name]: parser not found", e.getMessage());
+            assertEquals("[3:27] unknown field [bad_rescorer_name]", e.getMessage());
         }
         rescoreElement = "{\n" +
             "    \"bad_fieldName\" : 20\n" +
diff --git a/server/src/test/java/org/elasticsearch/search/suggest/SuggestionTests.java b/server/src/test/java/org/elasticsearch/search/suggest/SuggestionTests.java
index 36e49933ed524..e53aab10b9d02 100644
--- a/server/src/test/java/org/elasticsearch/search/suggest/SuggestionTests.java
+++ b/server/src/test/java/org/elasticsearch/search/suggest/SuggestionTests.java
@@ -187,7 +187,7 @@ public void testUnknownSuggestionTypeThrows() throws IOException {
             ensureExpectedToken(XContentParser.Token.FIELD_NAME, parser.nextToken(), parser::getTokenLocation);
             ensureExpectedToken(XContentParser.Token.START_ARRAY, parser.nextToken(), parser::getTokenLocation);
             NamedObjectNotFoundException e = expectThrows(NamedObjectNotFoundException.class, () -> Suggestion.fromXContent(parser));
-            assertEquals("[1:31] unable to parse Suggestion with name [unknownType]: parser not found", e.getMessage());
+            assertEquals("[1:31] unknown field [unknownType]", e.getMessage());
         }
     }
 

From 94d4b0afcea643c53ebd7f7a1754567d1e4033d9 Mon Sep 17 00:00:00 2001
From: Jay Modi <jaymode@users.noreply.github.com>
Date: Fri, 17 Jan 2020 08:57:06 -0700
Subject: [PATCH 638/686] Upgrade to the latest OWASP HTML sanitizer (#50765)

This commit upgrades the OWASP HTML sanitizer used by watcher to the
latest version and also upgrades guava, which it depends on. The guava
upgrade also requires the addition of a new dependency that guava
itself requires as of version 27.0. The sanitizer's behavior has changed to
re-write these templated values with a comment that results in this output
`{<!-- -->{ctx.metadata.name}}`. This would be an issue if we attempted to
sanitize the template, but the code that uses the sanitizer runs the rendered
string through the sanitizer, which means that the templated values have
been replaced already.

Relates #50395
---
 x-pack/plugin/watcher/build.gradle            |  16 +-
 .../licenses/failureaccess-1.0.1.jar.sha1     |   1 +
 .../licenses/failureaccess-LICENSE.txt        | 202 ++++++++++++++++++
 .../watcher/licenses/failureaccess-NOTICE.txt |   0
 .../watcher/licenses/guava-16.0.1.jar.sha1    |   1 -
 .../watcher/licenses/guava-27.1-jre.jar.sha1  |   1 +
 ...sp-java-html-sanitizer-20191001.1.jar.sha1 |   1 +
 .../owasp-java-html-sanitizer-r239.jar.sha1   |   1 -
 .../email/HtmlSanitizerTests.java             |  35 ---
 9 files changed, 218 insertions(+), 40 deletions(-)
 create mode 100644 x-pack/plugin/watcher/licenses/failureaccess-1.0.1.jar.sha1
 create mode 100644 x-pack/plugin/watcher/licenses/failureaccess-LICENSE.txt
 create mode 100644 x-pack/plugin/watcher/licenses/failureaccess-NOTICE.txt
 delete mode 100644 x-pack/plugin/watcher/licenses/guava-16.0.1.jar.sha1
 create mode 100644 x-pack/plugin/watcher/licenses/guava-27.1-jre.jar.sha1
 create mode 100644 x-pack/plugin/watcher/licenses/owasp-java-html-sanitizer-20191001.1.jar.sha1
 delete mode 100644 x-pack/plugin/watcher/licenses/owasp-java-html-sanitizer-r239.jar.sha1

diff --git a/x-pack/plugin/watcher/build.gradle b/x-pack/plugin/watcher/build.gradle
index eee2b74334250..d7c07fd7172ad 100644
--- a/x-pack/plugin/watcher/build.gradle
+++ b/x-pack/plugin/watcher/build.gradle
@@ -32,8 +32,9 @@ dependencies {
   testCompile project(xpackModule('ilm'))
 
   // watcher deps
-  compile 'com.googlecode.owasp-java-html-sanitizer:owasp-java-html-sanitizer:r239'
-  compile 'com.google.guava:guava:16.0.1' // needed by watcher for the html sanitizer
+  compile 'com.googlecode.owasp-java-html-sanitizer:owasp-java-html-sanitizer:20191001.1'
+  compile 'com.google.guava:guava:27.1-jre' // needed by watcher for the html sanitizer
+  compile 'com.google.guava:failureaccess:1.0.1'
   compile 'com.sun.mail:jakarta.mail:1.6.4'
   compile 'com.sun.activation:jakarta.activation:1.2.1'
   compileOnly "org.apache.httpcomponents:httpclient:${versions.httpclient}"
@@ -51,8 +52,17 @@ thirdPartyAudit {
     'com.google.common.cache.Striped64',
     'com.google.common.cache.Striped64$1',
     'com.google.common.cache.Striped64$Cell',
+    'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray',
+    'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray$1',
+    'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray$2',
+    'com.google.common.hash.LittleEndianByteArray$UnsafeByteArray$3',
+    'com.google.common.hash.Striped64',
+    'com.google.common.hash.Striped64$1',
+    'com.google.common.hash.Striped64$Cell',
     'com.google.common.primitives.UnsignedBytes$LexicographicalComparatorHolder$UnsafeComparator',
-    'com.google.common.primitives.UnsignedBytes$LexicographicalComparatorHolder$UnsafeComparator$1'
+    'com.google.common.primitives.UnsignedBytes$LexicographicalComparatorHolder$UnsafeComparator$1',
+    'com.google.common.util.concurrent.AbstractFuture$UnsafeAtomicHelper',
+    'com.google.common.util.concurrent.AbstractFuture$UnsafeAtomicHelper$1'
   )
 
   ignoreViolations(
diff --git a/x-pack/plugin/watcher/licenses/failureaccess-1.0.1.jar.sha1 b/x-pack/plugin/watcher/licenses/failureaccess-1.0.1.jar.sha1
new file mode 100644
index 0000000000000..4798b37e20691
--- /dev/null
+++ b/x-pack/plugin/watcher/licenses/failureaccess-1.0.1.jar.sha1
@@ -0,0 +1 @@
+1dcf1de382a0bf95a3d8b0849546c88bac1292c9
\ No newline at end of file
diff --git a/x-pack/plugin/watcher/licenses/failureaccess-LICENSE.txt b/x-pack/plugin/watcher/licenses/failureaccess-LICENSE.txt
new file mode 100644
index 0000000000000..d645695673349
--- /dev/null
+++ b/x-pack/plugin/watcher/licenses/failureaccess-LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/x-pack/plugin/watcher/licenses/failureaccess-NOTICE.txt b/x-pack/plugin/watcher/licenses/failureaccess-NOTICE.txt
new file mode 100644
index 0000000000000..e69de29bb2d1d
diff --git a/x-pack/plugin/watcher/licenses/guava-16.0.1.jar.sha1 b/x-pack/plugin/watcher/licenses/guava-16.0.1.jar.sha1
deleted file mode 100644
index 68f2b233a000d..0000000000000
--- a/x-pack/plugin/watcher/licenses/guava-16.0.1.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-5fa98cd1a63c99a44dd8d3b77e4762b066a5d0c5
\ No newline at end of file
diff --git a/x-pack/plugin/watcher/licenses/guava-27.1-jre.jar.sha1 b/x-pack/plugin/watcher/licenses/guava-27.1-jre.jar.sha1
new file mode 100644
index 0000000000000..07bf9c19e42b2
--- /dev/null
+++ b/x-pack/plugin/watcher/licenses/guava-27.1-jre.jar.sha1
@@ -0,0 +1 @@
+e47b59c893079b87743cdcfb6f17ca95c08c592c
\ No newline at end of file
diff --git a/x-pack/plugin/watcher/licenses/owasp-java-html-sanitizer-20191001.1.jar.sha1 b/x-pack/plugin/watcher/licenses/owasp-java-html-sanitizer-20191001.1.jar.sha1
new file mode 100644
index 0000000000000..310c13200fc0d
--- /dev/null
+++ b/x-pack/plugin/watcher/licenses/owasp-java-html-sanitizer-20191001.1.jar.sha1
@@ -0,0 +1 @@
+fb8b19019d7673e70c4a6111f7d0cb2b0cf0e513
\ No newline at end of file
diff --git a/x-pack/plugin/watcher/licenses/owasp-java-html-sanitizer-r239.jar.sha1 b/x-pack/plugin/watcher/licenses/owasp-java-html-sanitizer-r239.jar.sha1
deleted file mode 100644
index 71eaba394daf9..0000000000000
--- a/x-pack/plugin/watcher/licenses/owasp-java-html-sanitizer-r239.jar.sha1
+++ /dev/null
@@ -1 +0,0 @@
-ea8dd89a9e8fcf90c1b666ac0585e7769224da5e
\ No newline at end of file
diff --git a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/notification/email/HtmlSanitizerTests.java b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/notification/email/HtmlSanitizerTests.java
index 3ffd8dbf548e6..7ff74c684f99d 100644
--- a/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/notification/email/HtmlSanitizerTests.java
+++ b/x-pack/plugin/watcher/src/test/java/org/elasticsearch/xpack/watcher/notification/email/HtmlSanitizerTests.java
@@ -15,41 +15,6 @@
 
 
 public class HtmlSanitizerTests extends ESTestCase {
-    public void testDefaultWithTemplatePlaceholders() {
-        String blockTag = randomFrom(HtmlSanitizer.BLOCK_TAGS);
-        while (blockTag.equals("li")) {
-            blockTag = randomFrom(HtmlSanitizer.BLOCK_TAGS);
-        }
-        String html =
-                "<html>" +
-                        "<head></head>" +
-                        "<body>" +
-                        "<" + blockTag + ">Hello {{ctx.metadata.name}}</" + blockTag + ">" +
-                        "<ul><li>item1</li></ul>" +
-                        "<ol><li>item2</li></ol>" +
-                        "meta <a href='https://www.google.com/search?q={{ctx.metadata.name}}'>Testlink</a> meta" +
-                        "</body>" +
-                        "</html>";
-        HtmlSanitizer sanitizer = new HtmlSanitizer(Settings.EMPTY);
-        String sanitizedHtml = sanitizer.sanitize(html);
-        if (blockTag.equals("ol") || blockTag.equals("ul")) {
-            assertThat(sanitizedHtml, equalTo(
-                    "<head></head><body>" +
-                            "<" + blockTag + "><li>Hello {{ctx.metadata.name}}</li></" + blockTag + ">" +
-                            "<ul><li>item1</li></ul>" +
-                            "<ol><li>item2</li></ol>" +
-                            "meta <a href=\"https://www.google.com/search?q&#61;{{ctx.metadata.name}}\" rel=\"nofollow\">Testlink</a> " +
-                            "meta</body>"));
-        } else {
-            assertThat(sanitizedHtml, equalTo(
-                    "<head></head><body>" +
-                            "<" + blockTag + ">Hello {{ctx.metadata.name}}</" + blockTag + ">" +
-                            "<ul><li>item1</li></ul>" +
-                            "<ol><li>item2</li></ol>" +
-                            "meta <a href=\"https://www.google.com/search?q&#61;{{ctx.metadata.name}}\" rel=\"nofollow\">Testlink</a> " +
-                            "meta</body>"));
-        }
-    }
 
     public void testDefaultOnClickDisallowed() {
         String badHtml = "<button type=\"button\"" +

From e7a556ddb75cb586c40ef18d63414e29fa7631fb Mon Sep 17 00:00:00 2001
From: Jay Modi <jaymode@users.noreply.github.com>
Date: Fri, 17 Jan 2020 09:16:31 -0700
Subject: [PATCH 639/686] Introduce hidden indices (#50452)

This change introduces a new feature for indices so that they can be
hidden from wildcard expansion. The feature is referred to as hidden
indices. An index can be marked hidden through the use of an index
setting, `index.hidden`, at creation time. One primary use case for
this feature is to have a construct that fits indices that are created
by the stack that contain data used for display to the user and/or
intended for querying by the user. The desire to keep them hidden is
to avoid confusing users when searching all of the data they have
indexed and getting results returned from indices created by the
system.

Hidden indices have the following properties:
* API calls for all indices (empty indices array, _all, or *) will not
  return hidden indices by default.
* Wildcard expansion will not return hidden indices by default unless
  the wildcard pattern begins with a `.`. This behavior is similar to
  shell expansion of wildcards.
* REST API calls can enable the expansion of wildcards to hidden
  indices with the `expand_wildcards` parameter. To expand wildcards
  to hidden indices, use the value `hidden` in conjunction with `open`
  and/or `closed`.
* Creation of a hidden index will ignore global index templates. A
  global index template is one with a match-all pattern.
* Index templates can make an index hidden, with the exception of a
  global index template.
* Accessing a hidden index directly requires no additional parameters.

Relates #50251
---
 docs/reference/index-modules.asciidoc         |   7 +
 docs/reference/rest-api/common-parms.asciidoc |  55 +++---
 .../cluster/health/ClusterHealthRequest.java  |   2 +-
 .../rollover/TransportRolloverAction.java     |  12 +-
 .../action/bulk/TransportBulkAction.java      |   2 +-
 .../action/search/MultiSearchRequest.java     |  11 +-
 .../action/support/IndicesOptions.java        | 138 ++++++++++++---
 .../cluster/metadata/IndexMetaData.java       |   7 +
 .../metadata/IndexNameExpressionResolver.java |  32 +++-
 .../cluster/metadata/MetaData.java            |  66 ++++++-
 .../metadata/MetaDataCreateIndexService.java  |   4 +-
 .../MetaDataIndexTemplateService.java         |  64 ++++++-
 .../common/settings/IndexScopedSettings.java  |   1 +
 .../action/OriginalIndicesTests.java          |  15 +-
 .../health/ClusterHealthRequestTests.java     |   5 +
 .../ClusterSearchShardsRequestTests.java      |  11 +-
 .../indices/close/CloseIndexRequestTests.java |  43 ++++-
 .../TransportRolloverActionTests.java         |  20 ++-
 .../MetaDataIndexTemplateServiceTests.java    |  75 ++++++--
 .../search/MultiSearchRequestTests.java       |  36 ++++
 .../action/support/IndicesOptionsTests.java   | 106 +++++++-----
 .../IndexNameExpressionResolverTests.java     | 163 ++++++++++++++++--
 .../elasticsearch/index/HiddenIndexIT.java    | 129 ++++++++++++++
 .../org/elasticsearch/test/TestCluster.java   |   5 +-
 .../persistence/JobResultsProviderTests.java  |   1 +
 .../authz/IndicesAndAliasesResolver.java      |  41 +++--
 .../authz/IndicesAndAliasesResolverTests.java |  70 +++++++-
 27 files changed, 930 insertions(+), 191 deletions(-)
 create mode 100644 server/src/test/java/org/elasticsearch/index/HiddenIndexIT.java

diff --git a/docs/reference/index-modules.asciidoc b/docs/reference/index-modules.asciidoc
index a6cc8019c96fb..69a45555e9401 100644
--- a/docs/reference/index-modules.asciidoc
+++ b/docs/reference/index-modules.asciidoc
@@ -79,6 +79,13 @@ indices.
     Indicates whether <<query-filter-context, cached filters>> are pre-loaded for
     nested queries. Possible values are `true` (default) and `false`.
 
+`index.hidden`::
+
+    Indicates whether the index should be hidden by default. Hidden indices are not
+    returned by default when using a wildcard expression. This behavior is controlled
+    per request through the use of the `expand_wildcards` parameter. Possible values are
+    `true` and `false` (default).
+
 [float]
 [[dynamic-index-settings]]
 === Dynamic index settings
diff --git a/docs/reference/rest-api/common-parms.asciidoc b/docs/reference/rest-api/common-parms.asciidoc
index 0703260414716..813fb242af5f9 100644
--- a/docs/reference/rest-api/common-parms.asciidoc
+++ b/docs/reference/rest-api/common-parms.asciidoc
@@ -53,7 +53,7 @@ Specifies what to do when the request:
 --
 * Contains wildcard expressions and there are no {transforms} that match.
 * Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
+* Contains wildcard expressions and there are only partial matches.
 
 The default value is `true`, which returns an empty `transforms` array when
 there are no matches and the subset of results when there are partial matches.
@@ -69,7 +69,7 @@ Specifies what to do when the request:
 --
 * Contains wildcard expressions and there are no {transforms} that match.
 * Contains the `_all` string or no identifiers and there are no matches.
-* Contains wildcard expressions and there are only partial matches. 
+* Contains wildcard expressions and there are only partial matches.
 
 The default value is `true`, which returns a successful acknowledgement message
 when there are no matches. When there are only partial matches, the API stops
@@ -90,7 +90,7 @@ end::analyzer[]
 
 tag::analyze_wildcard[]
 `analyze_wildcard`::
-(Optional, boolean) If `true`, wildcard and prefix queries are 
+(Optional, boolean) If `true`, wildcard and prefix queries are
 analyzed. Defaults to `false`.
 end::analyze_wildcard[]
 
@@ -118,7 +118,7 @@ end::completion-fields[]
 
 tag::default_operator[]
 `default_operator`::
-(Optional, string) The default operator for query string query: AND or OR. 
+(Optional, string) The default operator for query string query: AND or OR.
 Defaults to `OR`.
 end::default_operator[]
 
@@ -144,7 +144,7 @@ end::detailed[]
 
 tag::df[]
 `df`::
-(Optional, string) Field to use as default where no field prefix is 
+(Optional, string) Field to use as default where no field prefix is
 given in the query string.
 end::df[]
 
@@ -181,6 +181,9 @@ Expand only to open indices.
 `closed`::
 Expand only to closed indices.
 
+`hidden`::
+Expansion of wildcards will include hidden indices.
+
 `none`::
 Wildcard expressions are not accepted.
 --
@@ -188,7 +191,7 @@ end::expand-wildcards[]
 
 tag::field_statistics[]
 `field_statistics`::
-(Optional, boolean) If `true`, the response includes the document count, sum of document frequencies, 
+(Optional, boolean) If `true`, the response includes the document count, sum of document frequencies,
 and sum of total term frequencies.
 Defaults to `true`.
 end::field_statistics[]
@@ -297,9 +300,9 @@ end::help[]
 
 tag::bulk-id[]
 `_id`::
-(Optional, string) 
+(Optional, string)
 The document ID.
-If no ID is specified, a document ID is automatically generated. 
+If no ID is specified, a document ID is automatically generated.
 end::bulk-id[]
 
 tag::if_primary_term[]
@@ -316,7 +319,7 @@ end::if_seq_no[]
 
 tag::ignore_throttled[]
 `ignore_throttled`::
-(Optional, boolean) If `true`, concrete, expanded or aliased indices are 
+(Optional, boolean) If `true`, concrete, expanded or aliased indices are
 ignored when throttled.
 end::ignore_throttled[]
 
@@ -362,7 +365,7 @@ end::index[]
 tag::bulk-index[]
 `_index`::
 (Optional, string)
-The name of the target index. 
+The name of the target index.
 Required if not specified as a path parameter.
 end::bulk-index[]
 
@@ -447,7 +450,7 @@ end::index-template[]
 
 tag::lenient[]
 `lenient`::
-(Optional, boolean) If `true`, format-based query failures (such as 
+(Optional, boolean) If `true`, format-based query failures (such as
 providing text to a numeric field) will be ignored. Defaults to `false`.
 end::lenient[]
 
@@ -618,13 +621,13 @@ end::search-q[]
 
 tag::query[]
 `query`::
-(Optional, <<query-dsl,query object>>) Defines the search definition using the 
+(Optional, <<query-dsl,query object>>) Defines the search definition using the
 <<query-dsl,Query DSL>>.
 end::query[]
 
 tag::realtime[]
 `realtime`::
-(Optional, boolean) If `true`, the request is real-time as opposed to near-real-time. 
+(Optional, boolean) If `true`, the request is real-time as opposed to near-real-time.
 Defaults to `true`. See <<realtime>>.
 end::realtime[]
 
@@ -638,7 +641,7 @@ end::refresh[]
 
 tag::request_cache[]
 `request_cache`::
-(Optional, boolean) If `true`, the request cache is used for this request. 
+(Optional, boolean) If `true`, the request cache is used for this request.
 Defaults to the index-level setting.
 end::request_cache[]
 
@@ -668,14 +671,14 @@ end::cat-s[]
 
 tag::scroll[]
 `scroll`::
-(Optional, <<time-units, time units>>) Specifies how long a consistent view of 
+(Optional, <<time-units, time units>>) Specifies how long a consistent view of
 the index should be maintained for scrolled search.
 end::scroll[]
 
 tag::scroll_size[]
 `scroll_size`::
-(Optional, integer) Size of the scroll request that powers the operation. 
-Defaults to 100. 
+(Optional, integer) Size of the scroll request that powers the operation.
+Defaults to 100.
 end::scroll_size[]
 
 tag::search_timeout[]
@@ -731,7 +734,7 @@ end::size-transforms[]
 
 tag::slices[]
 `slices`::
-(Optional, integer) The number of slices this task should be divided into. 
+(Optional, integer) The number of slices this task should be divided into.
 Defaults to 1 meaning the task isn't sliced into subtasks.
 end::slices[]
 
@@ -742,24 +745,24 @@ end::sort[]
 
 tag::source[]
 `_source`::
-(Optional, string) True or false to return the `_source` field or not, or a 
+(Optional, string) True or false to return the `_source` field or not, or a
 list of fields to return.
 end::source[]
 
 tag::source_excludes[]
 `_source_excludes`::
-(Optional, string) A list of fields to exclude from the returned `_source` 
+(Optional, string) A list of fields to exclude from the returned `_source`
 field.
 end::source_excludes[]
 
 tag::source_includes[]
 `_source_includes`::
-(Optional, string) A list of fields to extract and return from the `_source` 
+(Optional, string) A list of fields to extract and return from the `_source`
 field.
 end::source_includes[]
 
 tag::source-transforms[]
-The source of the data for the {transform}. 
+The source of the data for the {transform}.
 end::source-transforms[]
 
 tag::source-index-transforms[]
@@ -823,13 +826,13 @@ end::task-id[]
 
 tag::term_statistics[]
 `term_statistics`::
-(Optional, boolean) If `true`, the response includes term frequency and document frequency. 
+(Optional, boolean) If `true`, the response includes term frequency and document frequency.
 Defaults to `false`.
 end::term_statistics[]
 
 tag::terminate_after[]
 `terminate_after`::
-(Optional, integer) The maximum number of documents to collect for each shard, 
+(Optional, integer) The maximum number of documents to collect for each shard,
 upon reaching which the query execution will terminate early.
 end::terminate_after[]
 
@@ -871,7 +874,7 @@ end::transform-id-wildcard[]
 
 tag::cat-v[]
 `v`::
-(Optional, boolean) If `true`, the response includes column headings. 
+(Optional, boolean) If `true`, the response includes column headings.
 Defaults to `false`.
 end::cat-v[]
 
@@ -912,6 +915,6 @@ end::wait_for_active_shards[]
 
 tag::wait_for_completion[]
 `wait_for_completion`::
-(Optional, boolean) If `true`, the request blocks until the operation is complete. 
+(Optional, boolean) If `true`, the request blocks until the operation is complete.
 Defaults to `true`.
 end::wait_for_completion[]
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthRequest.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthRequest.java
index 9bea7b68caf0b..bbe24d7c0443f 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthRequest.java
@@ -39,7 +39,7 @@
 public class ClusterHealthRequest extends MasterNodeReadRequest<ClusterHealthRequest> implements IndicesRequest.Replaceable {
 
     private String[] indices;
-    private IndicesOptions indicesOptions = IndicesOptions.lenientExpand();
+    private IndicesOptions indicesOptions = IndicesOptions.lenientExpandHidden();
     private TimeValue timeout = new TimeValue(30, TimeUnit.SECONDS);
     private ClusterHealthStatus waitForStatus;
     private boolean waitForNoRelocatingShards = false;
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverAction.java
index 9c1c9d71d6708..5f6ee87e87fd8 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverAction.java
@@ -43,7 +43,6 @@
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.MetaDataCreateIndexService;
 import org.elasticsearch.cluster.metadata.MetaDataIndexAliasesService;
-import org.elasticsearch.cluster.metadata.MetaDataIndexTemplateService;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.inject.Inject;
@@ -63,6 +62,8 @@
 import java.util.regex.Pattern;
 import java.util.stream.Collectors;
 
+import static org.elasticsearch.cluster.metadata.MetaDataIndexTemplateService.findTemplates;
+
 /**
  * Main class to swap the index pointed to by an alias, given some conditions
  */
@@ -122,7 +123,9 @@ protected void masterOperation(Task task, final RolloverRequest rolloverRequest,
             : generateRolloverIndexName(sourceProvidedName, indexNameExpressionResolver);
         final String rolloverIndexName = indexNameExpressionResolver.resolveDateMathExpression(unresolvedName);
         MetaDataCreateIndexService.validateIndexName(rolloverIndexName, state); // will fail if the index already exists
-        checkNoDuplicatedAliasInIndexTemplate(metaData, rolloverIndexName, rolloverRequest.getAlias());
+        final Boolean isHidden = IndexMetaData.INDEX_HIDDEN_SETTING.exists(rolloverRequest.getCreateIndexRequest().settings()) ?
+            IndexMetaData.INDEX_HIDDEN_SETTING.get(rolloverRequest.getCreateIndexRequest().settings()) : null;
+        checkNoDuplicatedAliasInIndexTemplate(metaData, rolloverIndexName, rolloverRequest.getAlias(), isHidden);
         IndicesStatsRequest statsRequest = new IndicesStatsRequest().indices(rolloverRequest.getAlias())
             .clear()
             .indicesOptions(IndicesOptions.fromOptions(true, false, true, true))
@@ -291,8 +294,9 @@ static CreateIndexClusterStateUpdateRequest prepareCreateIndexRequest(final Stri
      * the rollover alias will point to multiple indices. This causes indexing requests to be rejected.
      * To avoid this, we make sure that there is no duplicated alias in index templates before creating a new index.
      */
-    static void checkNoDuplicatedAliasInIndexTemplate(MetaData metaData, String rolloverIndexName, String rolloverRequestAlias) {
-        final List<IndexTemplateMetaData> matchedTemplates = MetaDataIndexTemplateService.findTemplates(metaData, rolloverIndexName);
+    static void checkNoDuplicatedAliasInIndexTemplate(MetaData metaData, String rolloverIndexName, String rolloverRequestAlias,
+                                                      @Nullable Boolean isHidden) {
+        final List<IndexTemplateMetaData> matchedTemplates = findTemplates(metaData, rolloverIndexName, isHidden);
         for (IndexTemplateMetaData template : matchedTemplates) {
             if (template.aliases().containsKey(rolloverRequestAlias)) {
                 throw new IllegalArgumentException(String.format(Locale.ROOT,
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java b/server/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java
index 6a8912cc1dc82..b0a88c512a75e 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java
@@ -307,7 +307,7 @@ static boolean resolvePipelines(final DocWriteRequest<?> originalRequest, final
                 }
             } else if (indexRequest.index() != null) {
                 // the index does not exist yet (and this is a valid request), so match index templates to look for pipelines
-                List<IndexTemplateMetaData> templates = MetaDataIndexTemplateService.findTemplates(metaData, indexRequest.index());
+                List<IndexTemplateMetaData> templates = MetaDataIndexTemplateService.findTemplates(metaData, indexRequest.index(), null);
                 assert (templates != null);
                 // order of templates are highest order first
                 for (final IndexTemplateMetaData template : templates) {
diff --git a/server/src/main/java/org/elasticsearch/action/search/MultiSearchRequest.java b/server/src/main/java/org/elasticsearch/action/search/MultiSearchRequest.java
index e6e11e5eeb5c4..2fba92f5bab26 100644
--- a/server/src/main/java/org/elasticsearch/action/search/MultiSearchRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/search/MultiSearchRequest.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.action.CompositeIndicesRequest;
 import org.elasticsearch.action.support.IndicesOptions;
+import org.elasticsearch.action.support.IndicesOptions.WildcardStates;
 import org.elasticsearch.common.CheckedBiConsumer;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -304,15 +305,7 @@ public static void writeSearchRequestParams(SearchRequest request, XContentBuild
             xContentBuilder.field("index", request.indices());
         }
         if (request.indicesOptions() != null && request.indicesOptions() != SearchRequest.DEFAULT_INDICES_OPTIONS) {
-            if (request.indicesOptions().expandWildcardsOpen() && request.indicesOptions().expandWildcardsClosed()) {
-                xContentBuilder.field("expand_wildcards", "all");
-            } else if (request.indicesOptions().expandWildcardsOpen()) {
-                xContentBuilder.field("expand_wildcards", "open");
-            } else if (request.indicesOptions().expandWildcardsClosed()) {
-                xContentBuilder.field("expand_wildcards", "closed");
-            } else {
-                xContentBuilder.field("expand_wildcards", "none");
-            }
+            WildcardStates.toXContent(request.indicesOptions().getExpandWildcards(), xContentBuilder);
             xContentBuilder.field("ignore_unavailable", request.indicesOptions().ignoreUnavailable());
             xContentBuilder.field("allow_no_indices", request.indicesOptions().allowNoIndices());
         }
diff --git a/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java b/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
index e830ed8795608..42c97b25b950e 100644
--- a/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
+++ b/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
@@ -19,6 +19,7 @@
 package org.elasticsearch.action.support;
 
 
+import org.elasticsearch.Version;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ToXContent;
@@ -29,10 +30,9 @@
 import java.io.IOException;
 import java.util.Collection;
 import java.util.EnumSet;
-import java.util.HashSet;
 import java.util.Locale;
 import java.util.Map;
-import java.util.Set;
+import java.util.stream.Collectors;
 
 import static org.elasticsearch.common.xcontent.support.XContentMapValues.nodeBooleanValue;
 import static org.elasticsearch.common.xcontent.support.XContentMapValues.nodeStringArrayValue;
@@ -45,7 +45,8 @@ public class IndicesOptions implements ToXContentFragment {
 
     public enum WildcardStates {
         OPEN,
-        CLOSED;
+        CLOSED,
+        HIDDEN;
 
         public static final EnumSet<WildcardStates> NONE = EnumSet.noneOf(WildcardStates.class);
 
@@ -54,24 +55,45 @@ public static EnumSet<WildcardStates> parseParameter(Object value, EnumSet<Wildc
                 return defaultStates;
             }
 
-            Set<WildcardStates> states = new HashSet<>();
+            EnumSet<WildcardStates> states = EnumSet.noneOf(WildcardStates.class);
             String[] wildcards = nodeStringArrayValue(value);
+            // TODO why do we let patterns like "none,all" or "open,none,closed" get used. The location of 'none' in the array changes the
+            // meaning of the resulting value
             for (String wildcard : wildcards) {
-                if ("open".equals(wildcard)) {
-                    states.add(OPEN);
-                } else if ("closed".equals(wildcard)) {
-                    states.add(CLOSED);
-                } else if ("none".equals(wildcard)) {
-                    states.clear();
-                } else if ("all".equals(wildcard)) {
-                    states.add(OPEN);
-                    states.add(CLOSED);
-                } else {
-                    throw new IllegalArgumentException("No valid expand wildcard value [" + wildcard + "]");
+                switch (wildcard) {
+                    case "open":
+                        states.add(OPEN);
+                        break;
+                    case "closed":
+                        states.add(CLOSED);
+                        break;
+                    case "hidden":
+                        states.add(HIDDEN);
+                        break;
+                    case "none":
+                        states.clear();
+                        break;
+                    case "all":
+                        states = EnumSet.allOf(WildcardStates.class);
+                        break;
+                    default:
+                        throw new IllegalArgumentException("No valid expand wildcard value [" + wildcard + "]");
                 }
             }
 
-            return states.isEmpty() ? NONE : EnumSet.copyOf(states);
+            return states;
+        }
+
+        public static XContentBuilder toXContent(EnumSet<WildcardStates> states, XContentBuilder builder) throws IOException {
+            if (states.isEmpty()) {
+                builder.field("expand_wildcards", "none");
+            } else if (states.containsAll(EnumSet.allOf(WildcardStates.class))) {
+                builder.field("expand_wildcards", "all");
+            } else {
+                builder.field("expand_wildcards",
+                    states.stream().map(state -> state.toString().toLowerCase(Locale.ROOT)).collect(Collectors.joining(",")));
+            }
+            return builder;
         }
     }
 
@@ -91,9 +113,15 @@ public enum Option {
     public static final IndicesOptions LENIENT_EXPAND_OPEN =
         new IndicesOptions(EnumSet.of(Option.ALLOW_NO_INDICES, Option.IGNORE_UNAVAILABLE),
             EnumSet.of(WildcardStates.OPEN));
+    public static final IndicesOptions LENIENT_EXPAND_OPEN_HIDDEN =
+        new IndicesOptions(EnumSet.of(Option.ALLOW_NO_INDICES, Option.IGNORE_UNAVAILABLE),
+            EnumSet.of(WildcardStates.OPEN, WildcardStates.HIDDEN));
     public static final IndicesOptions LENIENT_EXPAND_OPEN_CLOSED =
         new IndicesOptions(EnumSet.of(Option.ALLOW_NO_INDICES, Option.IGNORE_UNAVAILABLE),
             EnumSet.of(WildcardStates.OPEN, WildcardStates.CLOSED));
+    public static final IndicesOptions LENIENT_EXPAND_OPEN_CLOSED_HIDDEN =
+        new IndicesOptions(EnumSet.of(Option.ALLOW_NO_INDICES, Option.IGNORE_UNAVAILABLE),
+            EnumSet.of(WildcardStates.OPEN, WildcardStates.CLOSED, WildcardStates.HIDDEN));
     public static final IndicesOptions STRICT_EXPAND_OPEN_CLOSED =
         new IndicesOptions(EnumSet.of(Option.ALLOW_NO_INDICES), EnumSet.of(WildcardStates.OPEN, WildcardStates.CLOSED));
     public static final IndicesOptions STRICT_EXPAND_OPEN_FORBID_CLOSED =
@@ -149,6 +177,13 @@ public boolean expandWildcardsClosed() {
         return expandWildcards.contains(WildcardStates.CLOSED);
     }
 
+    /**
+     * @return Whether wildcard expressions should get expanded to hidden indices
+     */
+    public boolean expandWildcardsHidden() {
+        return expandWildcards.contains(WildcardStates.HIDDEN);
+    }
+
     /**
      * @return Whether execution on closed indices is allowed.
      */
@@ -173,39 +208,71 @@ public boolean ignoreAliases() {
     }
 
     /**
-     *
      * @return whether indices that are marked as throttled should be ignored
      */
     public boolean ignoreThrottled() {
         return options.contains(Option.IGNORE_THROTTLED);
     }
 
+    /**
+     * @return a copy of the {@link WildcardStates} that these indices options will expand to
+     */
+    public EnumSet<WildcardStates> getExpandWildcards() {
+        return EnumSet.copyOf(expandWildcards);
+    }
+
     public void writeIndicesOptions(StreamOutput out) throws IOException {
         out.writeEnumSet(options);
-        out.writeEnumSet(expandWildcards);
+        if (out.getVersion().before(Version.V_8_0_0) && expandWildcards.contains(WildcardStates.HIDDEN)) {
+            final EnumSet<WildcardStates> states = EnumSet.copyOf(expandWildcards);
+            states.remove(WildcardStates.HIDDEN);
+            out.writeEnumSet(states);
+        } else {
+            out.writeEnumSet(expandWildcards);
+        }
     }
 
     public static IndicesOptions readIndicesOptions(StreamInput in) throws IOException {
-        return new IndicesOptions(in.readEnumSet(Option.class), in.readEnumSet(WildcardStates.class));
+        EnumSet<Option> options = in.readEnumSet(Option.class);
+        EnumSet<WildcardStates> states = in.readEnumSet(WildcardStates.class);
+        if (in.getVersion().before(Version.V_8_0_0)) {
+            states.add(WildcardStates.HIDDEN);
+        }
+        return new IndicesOptions(options, states);
     }
 
     public static IndicesOptions fromOptions(boolean ignoreUnavailable, boolean allowNoIndices, boolean expandToOpenIndices,
                                              boolean expandToClosedIndices) {
-        return fromOptions(ignoreUnavailable, allowNoIndices, expandToOpenIndices, expandToClosedIndices, true, false, false, false);
+        return fromOptions(ignoreUnavailable, allowNoIndices, expandToOpenIndices, expandToClosedIndices, false);
+    }
+
+    public static IndicesOptions fromOptions(boolean ignoreUnavailable, boolean allowNoIndices, boolean expandToOpenIndices,
+                                             boolean expandToClosedIndices, boolean expandToHiddenIndices) {
+        return fromOptions(ignoreUnavailable, allowNoIndices, expandToOpenIndices, expandToClosedIndices, expandToHiddenIndices, true,
+            false, false, false);
     }
 
     public static IndicesOptions fromOptions(boolean ignoreUnavailable, boolean allowNoIndices, boolean expandToOpenIndices,
                                              boolean expandToClosedIndices, IndicesOptions defaultOptions) {
         return fromOptions(ignoreUnavailable, allowNoIndices, expandToOpenIndices, expandToClosedIndices,
-            defaultOptions.allowAliasesToMultipleIndices(), defaultOptions.forbidClosedIndices(), defaultOptions.ignoreAliases(),
-            defaultOptions.ignoreThrottled());
+            defaultOptions.expandWildcardsHidden(), defaultOptions.allowAliasesToMultipleIndices(),
+            defaultOptions.forbidClosedIndices(), defaultOptions.ignoreAliases(), defaultOptions.ignoreThrottled());
+    }
+
+    public static IndicesOptions fromOptions(boolean ignoreUnavailable, boolean allowNoIndices, boolean expandToOpenIndices,
+                                             boolean expandToClosedIndices, boolean allowAliasesToMultipleIndices,
+                                             boolean forbidClosedIndices, boolean ignoreAliases,
+                                             boolean ignoreThrottled) {
+        return fromOptions(ignoreUnavailable, allowNoIndices, expandToOpenIndices, expandToClosedIndices, false,
+            allowAliasesToMultipleIndices, forbidClosedIndices, ignoreAliases, ignoreThrottled);
     }
 
     public static IndicesOptions fromOptions(boolean ignoreUnavailable, boolean allowNoIndices, boolean expandToOpenIndices,
-            boolean expandToClosedIndices, boolean allowAliasesToMultipleIndices, boolean forbidClosedIndices, boolean ignoreAliases,
+                                             boolean expandToClosedIndices, boolean expandToHiddenIndices,
+                                             boolean allowAliasesToMultipleIndices, boolean forbidClosedIndices, boolean ignoreAliases,
                                              boolean ignoreThrottled) {
-        final Set<Option> opts = new HashSet<>();
-        final Set<WildcardStates> wildcards = new HashSet<>();
+        final EnumSet<Option> opts = EnumSet.noneOf(Option.class);
+        final EnumSet<WildcardStates> wildcards = EnumSet.noneOf(WildcardStates.class);
 
         if (ignoreUnavailable) {
             opts.add(Option.IGNORE_UNAVAILABLE);
@@ -219,6 +286,9 @@ public static IndicesOptions fromOptions(boolean ignoreUnavailable, boolean allo
         if (expandToClosedIndices) {
             wildcards.add(WildcardStates.CLOSED);
         }
+        if (expandToHiddenIndices) {
+            wildcards.add(WildcardStates.HIDDEN);
+        }
         if (allowAliasesToMultipleIndices == false) {
             opts.add(Option.FORBID_ALIASES_TO_MULTIPLE_INDICES);
         }
@@ -278,6 +348,7 @@ public static IndicesOptions fromParameters(Object wildcardsString, Object ignor
                 nodeBooleanValue(allowNoIndicesString, "allow_no_indices", defaultSettings.allowNoIndices()),
                 wildcards.contains(WildcardStates.OPEN),
                 wildcards.contains(WildcardStates.CLOSED),
+                wildcards.contains(WildcardStates.HIDDEN),
                 defaultSettings.allowAliasesToMultipleIndices(),
                 defaultSettings.forbidClosedIndices(),
                 defaultSettings.ignoreAliases(),
@@ -348,6 +419,14 @@ public static IndicesOptions lenientExpandOpen() {
         return LENIENT_EXPAND_OPEN;
     }
 
+    /**
+     * @return indices options that ignores unavailable indices, expands wildcards to open and hidden indices, and
+     *         allows that no indices are resolved from wildcard expressions (not returning an error).
+     */
+    public static IndicesOptions lenientExpandOpenHidden() {
+        return LENIENT_EXPAND_OPEN_HIDDEN;
+    }
+
     /**
      * @return indices options that ignores unavailable indices,  expands wildcards to both open and closed
      * indices and allows that no indices are resolved from wildcard expressions (not returning an error).
@@ -356,6 +435,14 @@ public static IndicesOptions lenientExpand() {
         return LENIENT_EXPAND_OPEN_CLOSED;
     }
 
+    /**
+     * @return indices options that ignores unavailable indices,  expands wildcards to all open and closed
+     * indices and allows that no indices are resolved from wildcard expressions (not returning an error).
+     */
+    public static IndicesOptions lenientExpandHidden() {
+        return LENIENT_EXPAND_OPEN_CLOSED_HIDDEN;
+    }
+
     @Override
     public boolean equals(Object obj) {
         if (obj == null) {
@@ -383,6 +470,7 @@ public String toString() {
                 ", allow_no_indices=" + allowNoIndices() +
                 ", expand_wildcards_open=" + expandWildcardsOpen() +
                 ", expand_wildcards_closed=" + expandWildcardsClosed() +
+                ", expand_wildcards_hidden=" + expandWildcardsHidden() +
                 ", allow_aliases_to_multiple_indices=" + allowAliasesToMultipleIndices() +
                 ", forbid_closed_indices=" + forbidClosedIndices() +
                 ", ignore_aliases=" + ignoreAliases() +
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/IndexMetaData.java b/server/src/main/java/org/elasticsearch/cluster/metadata/IndexMetaData.java
index f8e1b48c6dd83..5d5faacc10a2a 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/IndexMetaData.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/IndexMetaData.java
@@ -256,6 +256,13 @@ public Iterator<Setting<?>> settings() {
                       Setting.Property.Dynamic,
                       Setting.Property.IndexScope);
 
+    /**
+     * Whether the index is considered hidden or not. A hidden index will not be resolved in
+     * normal wildcard searches unless explicitly allowed
+     */
+    public static final Setting<Boolean> INDEX_HIDDEN_SETTING =
+        Setting.boolSetting("index.hidden", false, Property.IndexScope, Property.Final);
+
     /**
      * an internal index format description, allowing us to find out if this index is upgraded or needs upgrading
      */
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolver.java b/server/src/main/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolver.java
index 93e8b84936133..d68d69bf24e8c 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolver.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolver.java
@@ -158,7 +158,7 @@ Index[] concreteIndices(Context context, String... indexExpressions) {
         for (ExpressionResolver expressionResolver : expressionResolvers) {
             expressions = expressionResolver.resolve(context, expressions);
         }
-        
+
         if (expressions.isEmpty()) {
             if (!options.allowNoIndices()) {
                 IndexNotFoundException infe;
@@ -187,7 +187,7 @@ Index[] concreteIndices(Context context, String... indexExpressions) {
                     if (expression.equals(MetaData.ALL)) {
                         infe = new IndexNotFoundException("no indices exist", expression);
                     } else {
-                        infe = new IndexNotFoundException(expression);  
+                        infe = new IndexNotFoundException(expression);
                     }
                     infe.setResources("index_expression", expression);
                     throw infe;
@@ -670,6 +670,8 @@ static final class WildcardExpressionResolver implements ExpressionResolver {
         public List<String> resolve(Context context, List<String> expressions) {
             IndicesOptions options = context.getOptions();
             MetaData metaData = context.getState().metaData();
+            // only check open/closed since if we do not expand to open or closed it doesn't make sense to
+            // expand to hidden
             if (options.expandWildcardsClosed() == false && options.expandWildcardsOpen() == false) {
                 return expressions;
             }
@@ -739,7 +741,7 @@ private Set<String> innerResolve(Context context, List<String> expressions, Indi
 
                 final IndexMetaData.State excludeState = excludeState(options);
                 final Map<String, AliasOrIndex> matches = matches(context, metaData, expression);
-                Set<String> expand = expand(context, excludeState, matches);
+                Set<String> expand = expand(context, excludeState, matches, expression, options.expandWildcardsHidden());
                 if (add) {
                     result.addAll(expand);
                 } else {
@@ -834,7 +836,8 @@ private static Map<String, AliasOrIndex> otherWildcard(Context context, MetaData
                 .collect(Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue));
         }
 
-        private static Set<String> expand(Context context, IndexMetaData.State excludeState, Map<String, AliasOrIndex> matches) {
+        private static Set<String> expand(Context context, IndexMetaData.State excludeState, Map<String, AliasOrIndex> matches,
+                                          String expression, boolean includeHidden) {
             Set<String> expand = new HashSet<>();
             for (Map.Entry<String, AliasOrIndex> entry : matches.entrySet()) {
                 AliasOrIndex aliasOrIndex = entry.getValue();
@@ -843,7 +846,14 @@ private static Set<String> expand(Context context, IndexMetaData.State excludeSt
                 } else {
                     for (IndexMetaData meta : aliasOrIndex.getIndices()) {
                         if (excludeState == null || meta.getState() != excludeState) {
-                            expand.add(meta.getIndex().getName());
+                            if (includeHidden) {
+                                expand.add(meta.getIndex().getName());
+                            } else if (IndexMetaData.INDEX_HIDDEN_SETTING.get(meta.getSettings()) == false) {
+                                expand.add(meta.getIndex().getName());
+                            } else if (meta.getIndex().getName().startsWith(".") &&
+                                expression.startsWith(".") && Regex.isSimpleMatchPattern(expression)) {
+                                expand.add(meta.getIndex().getName());
+                            }
                         }
                     }
                 }
@@ -857,12 +867,18 @@ private boolean isEmptyOrTrivialWildcard(List<String> expressions) {
         }
 
         private static List<String> resolveEmptyOrTrivialWildcard(IndicesOptions options, MetaData metaData) {
-            if (options.expandWildcardsOpen() && options.expandWildcardsClosed()) {
+            if (options.expandWildcardsOpen() && options.expandWildcardsClosed() && options.expandWildcardsHidden()) {
                 return Arrays.asList(metaData.getConcreteAllIndices());
-            } else if (options.expandWildcardsOpen()) {
+            } else if (options.expandWildcardsOpen() && options.expandWildcardsClosed()) {
+                return Arrays.asList(metaData.getConcreteVisibleIndices());
+            } else if (options.expandWildcardsOpen() && options.expandWildcardsHidden()) {
                 return Arrays.asList(metaData.getConcreteAllOpenIndices());
-            } else if (options.expandWildcardsClosed()) {
+            } else if (options.expandWildcardsOpen()) {
+                return Arrays.asList(metaData.getConcreteVisibleOpenIndices());
+            } else if (options.expandWildcardsClosed() && options.expandWildcardsHidden()) {
                 return Arrays.asList(metaData.getConcreteAllClosedIndices());
+            } else if (options.expandWildcardsClosed()) {
+                return Arrays.asList(metaData.getConcreteVisibleClosedIndices());
             } else {
                 return Collections.emptyList();
             }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
index 482d57bed54b5..02dca032a11c2 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaData.java
@@ -177,15 +177,19 @@ public interface Custom extends NamedDiffable<Custom>, ToXContentFragment {
     private final int totalOpenIndexShards;
 
     private final String[] allIndices;
+    private final String[] visibleIndices;
     private final String[] allOpenIndices;
+    private final String[] visibleOpenIndices;
     private final String[] allClosedIndices;
+    private final String[] visibleClosedIndices;
 
     private final SortedMap<String, AliasOrIndex> aliasAndIndexLookup;
 
     MetaData(String clusterUUID, boolean clusterUUIDCommitted, long version, CoordinationMetaData coordinationMetaData,
              Settings transientSettings, Settings persistentSettings, DiffableStringMap hashesOfConsistentSettings,
              ImmutableOpenMap<String, IndexMetaData> indices, ImmutableOpenMap<String, IndexTemplateMetaData> templates,
-             ImmutableOpenMap<String, Custom> customs, String[] allIndices, String[] allOpenIndices, String[] allClosedIndices,
+             ImmutableOpenMap<String, Custom> customs, String[] allIndices, String[] visibleIndices, String[] allOpenIndices,
+             String[] visibleOpenIndices, String[] allClosedIndices, String[] visibleClosedIndices,
              SortedMap<String, AliasOrIndex> aliasAndIndexLookup) {
         this.clusterUUID = clusterUUID;
         this.clusterUUIDCommitted = clusterUUIDCommitted;
@@ -210,8 +214,11 @@ public interface Custom extends NamedDiffable<Custom>, ToXContentFragment {
         this.totalOpenIndexShards = totalOpenIndexShards;
 
         this.allIndices = allIndices;
+        this.visibleIndices = visibleIndices;
         this.allOpenIndices = allOpenIndices;
+        this.visibleOpenIndices = visibleOpenIndices;
         this.allClosedIndices = allClosedIndices;
+        this.visibleClosedIndices = visibleClosedIndices;
         this.aliasAndIndexLookup = aliasAndIndexLookup;
     }
 
@@ -479,14 +486,41 @@ public String[] getConcreteAllIndices() {
         return allIndices;
     }
 
+    /**
+     * Returns all the concrete indices that are not hidden.
+     */
+    public String[] getConcreteVisibleIndices() {
+        return visibleIndices;
+    }
+
+    /**
+     * Returns all of the concrete indices that are open.
+     */
     public String[] getConcreteAllOpenIndices() {
         return allOpenIndices;
     }
 
+    /**
+     * Returns all of the concrete indices that are open and not hidden.
+     */
+    public String[] getConcreteVisibleOpenIndices() {
+        return visibleOpenIndices;
+    }
+
+    /**
+     * Returns all of the concrete indices that are closed.
+     */
     public String[] getConcreteAllClosedIndices() {
         return allClosedIndices;
     }
 
+    /**
+     * Returns all of the concrete indices that are closed and not hidden.
+     */
+    public String[] getConcreteVisibleClosedIndices() {
+        return visibleClosedIndices;
+    }
+
     /**
      * Returns indexing routing for the given <code>aliasOrIndex</code>. Resolves routing from the alias metadata used
      * in the write index.
@@ -1147,18 +1181,31 @@ public MetaData build() {
             // 2) The aliasAndIndexLookup can be updated instead of rebuilding it all the time.
 
             final Set<String> allIndices = new HashSet<>(indices.size());
+            final List<String> visibleIndices = new ArrayList<>();
             final List<String> allOpenIndices = new ArrayList<>();
+            final List<String> visibleOpenIndices = new ArrayList<>();
             final List<String> allClosedIndices = new ArrayList<>();
+            final List<String> visibleClosedIndices = new ArrayList<>();
             final Set<String> duplicateAliasesIndices = new HashSet<>();
             for (ObjectCursor<IndexMetaData> cursor : indices.values()) {
                 final IndexMetaData indexMetaData = cursor.value;
                 final String name = indexMetaData.getIndex().getName();
                 boolean added = allIndices.add(name);
                 assert added : "double index named [" + name + "]";
+                final boolean visible = IndexMetaData.INDEX_HIDDEN_SETTING.get(indexMetaData.getSettings()) == false;
+                if (visible) {
+                    visibleIndices.add(name);
+                }
                 if (indexMetaData.getState() == IndexMetaData.State.OPEN) {
-                    allOpenIndices.add(indexMetaData.getIndex().getName());
+                    allOpenIndices.add(name);
+                    if (visible) {
+                        visibleOpenIndices.add(name);
+                    }
                 } else if (indexMetaData.getState() == IndexMetaData.State.CLOSE) {
-                    allClosedIndices.add(indexMetaData.getIndex().getName());
+                    allClosedIndices.add(name);
+                    if (visible) {
+                        visibleClosedIndices.add(name);
+                    }
                 }
                 indexMetaData.getAliases().keysIt().forEachRemaining(duplicateAliasesIndices::add);
             }
@@ -1186,13 +1233,16 @@ public MetaData build() {
             // TODO: I think we can remove these arrays. it isn't worth the effort, for operations on all indices.
             // When doing an operation across all indices, most of the time is spent on actually going to all shards and
             // do the required operations, the bottleneck isn't resolving expressions into concrete indices.
-            String[] allIndicesArray = allIndices.toArray(new String[allIndices.size()]);
-            String[] allOpenIndicesArray = allOpenIndices.toArray(new String[allOpenIndices.size()]);
-            String[] allClosedIndicesArray = allClosedIndices.toArray(new String[allClosedIndices.size()]);
+            String[] allIndicesArray = allIndices.toArray(Strings.EMPTY_ARRAY);
+            String[] visibleIndicesArray = visibleIndices.toArray(Strings.EMPTY_ARRAY);
+            String[] allOpenIndicesArray = allOpenIndices.toArray(Strings.EMPTY_ARRAY);
+            String[] visibleOpenIndicesArray = visibleOpenIndices.toArray(Strings.EMPTY_ARRAY);
+            String[] allClosedIndicesArray = allClosedIndices.toArray(Strings.EMPTY_ARRAY);
+            String[] visibleClosedIndicesArray = visibleClosedIndices.toArray(Strings.EMPTY_ARRAY);
 
             return new MetaData(clusterUUID, clusterUUIDCommitted, version, coordinationMetaData, transientSettings, persistentSettings,
-                    hashesOfConsistentSettings, indices.build(), templates.build(), customs.build(), allIndicesArray, allOpenIndicesArray,
-                    allClosedIndicesArray, aliasAndIndexLookup);
+                hashesOfConsistentSettings, indices.build(), templates.build(), customs.build(), allIndicesArray, visibleIndicesArray,
+                allOpenIndicesArray, visibleOpenIndicesArray, allClosedIndicesArray, visibleClosedIndicesArray, aliasAndIndexLookup);
         }
 
         private SortedMap<String, AliasOrIndex> buildAliasAndIndexLookup() {
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
index ded77ce4287d6..ba1772d091b65 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
@@ -278,8 +278,10 @@ public ClusterState applyCreateIndexRequest(ClusterState currentState, CreateInd
 
         // we only find a template when its an API call (a new index)
         // find templates, highest order are better matching
+        final Boolean isHidden = IndexMetaData.INDEX_HIDDEN_SETTING.exists(request.settings()) ?
+            IndexMetaData.INDEX_HIDDEN_SETTING.get(request.settings()) : null;
         final List<IndexTemplateMetaData> templates = sourceMetaData == null ?
-            Collections.unmodifiableList(MetaDataIndexTemplateService.findTemplates(currentState.metaData(), request.index())) :
+            Collections.unmodifiableList(MetaDataIndexTemplateService.findTemplates(currentState.metaData(), request.index(), isHidden)) :
             List.of();
 
         final Map<String, Object> mappings = Collections.unmodifiableMap(parseMappings(request.mappings(), templates, xContentRegistry));
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
index 825e6758e5df0..55e03a604ec55 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
@@ -28,6 +28,7 @@
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.ClusterStateUpdateTask;
 import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.UUIDs;
@@ -55,7 +56,9 @@
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
+import java.util.Optional;
 import java.util.Set;
+import java.util.function.Predicate;
 
 import static org.elasticsearch.indices.cluster.IndicesClusterStateService.AllocatedIndices.IndexRemovalReason.NO_LONGER_ASSIGNED;
 
@@ -196,19 +199,61 @@ public void clusterStateProcessed(String source, ClusterState oldState, ClusterS
     }
 
     /**
-     * Finds index templates whose index pattern matched with the given index name.
-     * The result is sorted by {@link IndexTemplateMetaData#order} descending.
+     * Finds index templates whose index pattern matched with the given index name. In the case of
+     * hidden indices, a template with a match all pattern or global template will not be returned.
+     *
+     * @param metaData The {@link MetaData} containing all of the {@link IndexTemplateMetaData} values
+     * @param indexName The name of the index that templates are being found for
+     * @param isHidden Whether or not the index is known to be hidden. May be {@code null} if the index
+     *                 being hidden has not been explicitly requested. When {@code null} if the result
+     *                 of template application results in a hidden index, then global templates will
+     *                 not be returned
+     * @return a list of templates sorted by {@link IndexTemplateMetaData#order()} descending.
+     *
      */
-    public static List<IndexTemplateMetaData> findTemplates(MetaData metaData, String indexName) {
+    public static List<IndexTemplateMetaData> findTemplates(MetaData metaData, String indexName, @Nullable Boolean isHidden) {
+        final Predicate<String> patternMatchPredicate = pattern -> Regex.simpleMatch(pattern, indexName);
         final List<IndexTemplateMetaData> matchedTemplates = new ArrayList<>();
         for (ObjectCursor<IndexTemplateMetaData> cursor : metaData.templates().values()) {
             final IndexTemplateMetaData template = cursor.value;
-            final boolean matched = template.patterns().stream().anyMatch(pattern -> Regex.simpleMatch(pattern, indexName));
-            if (matched) {
-                matchedTemplates.add(template);
+            if (isHidden == null || isHidden == Boolean.FALSE) {
+                final boolean matched = template.patterns().stream().anyMatch(patternMatchPredicate);
+                if (matched) {
+                    matchedTemplates.add(template);
+                }
+            } else {
+                assert isHidden == Boolean.TRUE;
+                final boolean isNotMatchAllTemplate = template.patterns().stream().noneMatch(Regex::isMatchAllPattern);
+                if (isNotMatchAllTemplate) {
+                    if (template.patterns().stream().anyMatch(patternMatchPredicate)) {
+                        matchedTemplates.add(template);
+                    }
+                }
             }
         }
         CollectionUtil.timSort(matchedTemplates, Comparator.comparingInt(IndexTemplateMetaData::order).reversed());
+
+        // this is complex but if the index is not hidden in the create request but is hidden as the result of template application,
+        // then we need to exclude global templates
+        if (isHidden == null) {
+            final Optional<IndexTemplateMetaData> templateWithHiddenSetting = matchedTemplates.stream()
+                .filter(template -> IndexMetaData.INDEX_HIDDEN_SETTING.exists(template.settings())).findFirst();
+            if (templateWithHiddenSetting.isPresent()) {
+                final boolean templatedIsHidden = IndexMetaData.INDEX_HIDDEN_SETTING.get(templateWithHiddenSetting.get().settings());
+                if (templatedIsHidden) {
+                    // remove the global templates
+                    matchedTemplates.removeIf(current -> current.patterns().stream().anyMatch(Regex::isMatchAllPattern));
+                }
+                // validate that hidden didn't change
+                final Optional<IndexTemplateMetaData> templateWithHiddenSettingPostRemoval = matchedTemplates.stream()
+                    .filter(template -> IndexMetaData.INDEX_HIDDEN_SETTING.exists(template.settings())).findFirst();
+                if (templateWithHiddenSettingPostRemoval.isEmpty() ||
+                    templateWithHiddenSetting.get() != templateWithHiddenSettingPostRemoval.get()) {
+                    throw new IllegalStateException("A global index template [" + templateWithHiddenSetting.get().name() +
+                        "] defined the index hidden setting, which is not allowed");
+                }
+            }
+        }
         return matchedTemplates;
     }
 
@@ -307,6 +352,13 @@ private void validate(PutRequest request) {
         }
         List<String> indexSettingsValidation = metaDataCreateIndexService.getIndexSettingsValidationErrors(request.settings, true);
         validationErrors.addAll(indexSettingsValidation);
+
+        if (request.indexPatterns.stream().anyMatch(Regex::isMatchAllPattern)) {
+            if (IndexMetaData.INDEX_HIDDEN_SETTING.exists(request.settings)) {
+                validationErrors.add("global templates may not specify the setting " + IndexMetaData.INDEX_HIDDEN_SETTING.getKey());
+            }
+        }
+
         if (!validationErrors.isEmpty()) {
             ValidationException validationException = new ValidationException();
             validationException.addValidationErrors(validationErrors);
diff --git a/server/src/main/java/org/elasticsearch/common/settings/IndexScopedSettings.java b/server/src/main/java/org/elasticsearch/common/settings/IndexScopedSettings.java
index e278f01002595..f60a2e7ea56d5 100644
--- a/server/src/main/java/org/elasticsearch/common/settings/IndexScopedSettings.java
+++ b/server/src/main/java/org/elasticsearch/common/settings/IndexScopedSettings.java
@@ -77,6 +77,7 @@ public final class IndexScopedSettings extends AbstractScopedSettings {
             IndexMetaData.INDEX_BLOCKS_READ_ONLY_ALLOW_DELETE_SETTING,
             IndexMetaData.INDEX_PRIORITY_SETTING,
             IndexMetaData.INDEX_DATA_PATH_SETTING,
+            IndexMetaData.INDEX_HIDDEN_SETTING,
             IndexMetaData.INDEX_FORMAT_SETTING,
             SearchSlowLog.INDEX_SEARCH_SLOWLOG_THRESHOLD_FETCH_DEBUG_SETTING,
             SearchSlowLog.INDEX_SEARCH_SLOWLOG_THRESHOLD_FETCH_WARN_SETTING,
diff --git a/server/src/test/java/org/elasticsearch/action/OriginalIndicesTests.java b/server/src/test/java/org/elasticsearch/action/OriginalIndicesTests.java
index 177c0870803d7..39f453d448fd7 100644
--- a/server/src/test/java/org/elasticsearch/action/OriginalIndicesTests.java
+++ b/server/src/test/java/org/elasticsearch/action/OriginalIndicesTests.java
@@ -19,6 +19,7 @@
 
 package org.elasticsearch.action;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -26,7 +27,7 @@
 
 import java.io.IOException;
 
-import static org.elasticsearch.test.VersionUtils.randomVersion;
+import static org.elasticsearch.test.VersionUtils.randomCompatibleVersion;
 import static org.hamcrest.CoreMatchers.equalTo;
 
 public class OriginalIndicesTests extends ESTestCase {
@@ -41,7 +42,7 @@ public void testOriginalIndicesSerialization() throws IOException {
             OriginalIndices originalIndices = randomOriginalIndices();
 
             BytesStreamOutput out = new BytesStreamOutput();
-            out.setVersion(randomVersion(random()));
+            out.setVersion(randomCompatibleVersion(random(), Version.CURRENT));
             OriginalIndices.writeOriginalIndices(originalIndices, out);
 
             StreamInput in = out.bytes().streamInput();
@@ -49,7 +50,15 @@ public void testOriginalIndicesSerialization() throws IOException {
             OriginalIndices originalIndices2 = OriginalIndices.readOriginalIndices(in);
 
             assertThat(originalIndices2.indices(), equalTo(originalIndices.indices()));
-            assertThat(originalIndices2.indicesOptions(), equalTo(originalIndices.indicesOptions()));
+            // indices options are not equivalent when sent to an older version and re-read due
+            // to the addition of hidden indices as expand to hidden indices is always true when
+            // read from a prior version
+            // TODO update version on backport!
+            if (out.getVersion().onOrAfter(Version.V_8_0_0) || originalIndices.indicesOptions().expandWildcardsHidden()) {
+                assertThat(originalIndices2.indicesOptions(), equalTo(originalIndices.indicesOptions()));
+            } else if (originalIndices.indicesOptions().expandWildcardsHidden()) {
+                assertThat(originalIndices2.indicesOptions(), equalTo(originalIndices.indicesOptions()));
+            }
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthRequestTests.java
index a901c8c9bc2e1..40be77001bb71 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/health/ClusterHealthRequestTests.java
@@ -56,6 +56,11 @@ public void testSerialize() throws Exception {
         assertThat(cloneRequest.indicesOptions(), equalTo(originalRequest.indicesOptions()));
     }
 
+    public void testRequestReturnsHiddenIndicesByDefault() {
+        final ClusterHealthRequest defaultRequest = new ClusterHealthRequest();
+        assertTrue(defaultRequest.indicesOptions().expandWildcardsHidden());
+    }
+
     public void testBwcSerialization() throws Exception {
         for (int runs = 0; runs < randomIntBetween(5, 20); runs++) {
             // Generate a random cluster health request in version < 7.2.0 and serializes it
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequestTests.java
index 600920267fcb3..ee943518ac1c2 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequestTests.java
@@ -40,7 +40,7 @@ public void testSerialization() throws Exception {
         }
         if (randomBoolean()) {
             request.indicesOptions(
-                    IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean()));
+                    IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean()));
         }
         if (randomBoolean()) {
             request.preference(randomAlphaOfLengthBetween(3, 10));
@@ -54,7 +54,7 @@ public void testSerialization() throws Exception {
             request.routing(routings);
         }
 
-        Version version = VersionUtils.randomIndexCompatibleVersion(random());
+        Version version = VersionUtils.randomCompatibleVersion(random(), Version.CURRENT);
         try (BytesStreamOutput out = new BytesStreamOutput()) {
             out.setVersion(version);
             request.writeTo(out);
@@ -62,7 +62,12 @@ public void testSerialization() throws Exception {
                 in.setVersion(version);
                 ClusterSearchShardsRequest deserialized = new ClusterSearchShardsRequest(in);
                 assertArrayEquals(request.indices(), deserialized.indices());
-                assertEquals(request.indicesOptions(), deserialized.indicesOptions());
+                // indices options are not equivalent when sent to an older version and re-read due
+                // to the addition of hidden indices as expand to hidden indices is always true when
+                // read from a prior version
+                if (version.onOrAfter(Version.V_8_0_0) || request.indicesOptions().expandWildcardsHidden()) { // TODO change on backport!
+                    assertEquals(request.indicesOptions(), deserialized.indicesOptions());
+                }
                 assertEquals(request.routing(), deserialized.routing());
                 assertEquals(request.preference(), deserialized.preference());
             }
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/close/CloseIndexRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/close/CloseIndexRequestTests.java
index f6c500fe3f22b..3b33791b9bfe8 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/close/CloseIndexRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/close/CloseIndexRequestTests.java
@@ -52,40 +52,66 @@ public void testBwcSerialization() throws Exception {
         {
             final CloseIndexRequest request = randomRequest();
             try (BytesStreamOutput out = new BytesStreamOutput()) {
-                out.setVersion(VersionUtils.randomVersionBetween(random(), VersionUtils.getFirstVersion(),
-                    VersionUtils.getPreviousVersion(Version.V_7_2_0)));
+                out.setVersion(VersionUtils.randomCompatibleVersion(random(), Version.CURRENT));
                 request.writeTo(out);
 
                 try (StreamInput in = out.bytes().streamInput()) {
+                    in.setVersion(out.getVersion());
                     assertEquals(request.getParentTask(), TaskId.readFromStream(in));
                     assertEquals(request.masterNodeTimeout(), in.readTimeValue());
                     assertEquals(request.timeout(), in.readTimeValue());
                     assertArrayEquals(request.indices(), in.readStringArray());
-                    assertEquals(request.indicesOptions(), IndicesOptions.readIndicesOptions(in));
+                    final IndicesOptions indicesOptions = IndicesOptions.readIndicesOptions(in);
+                    // indices options are not equivalent when sent to an older version and re-read due
+                    // to the addition of hidden indices as expand to hidden indices is always true when
+                    // read from a prior version
+                    // TODO update version on backport!
+                    if (out.getVersion().onOrAfter(Version.V_8_0_0) || request.indicesOptions().expandWildcardsHidden()) {
+                        assertEquals(request.indicesOptions(), indicesOptions);
+                    }
+                    if (in.getVersion().onOrAfter(Version.V_7_2_0)) {
+                        assertEquals(request.waitForActiveShards(), ActiveShardCount.readFrom(in));
+                    } else {
+                        assertEquals(0, in.available());
+                    }
                 }
             }
         }
         {
             final CloseIndexRequest sample = randomRequest();
+            final Version version = VersionUtils.randomCompatibleVersion(random(), Version.CURRENT);
             try (BytesStreamOutput out = new BytesStreamOutput()) {
+                out.setVersion(version);
                 sample.getParentTask().writeTo(out);
                 out.writeTimeValue(sample.masterNodeTimeout());
                 out.writeTimeValue(sample.timeout());
                 out.writeStringArray(sample.indices());
                 sample.indicesOptions().writeIndicesOptions(out);
+                if (out.getVersion().onOrAfter(Version.V_7_2_0)) {
+                    sample.waitForActiveShards().writeTo(out);
+                }
 
                 final CloseIndexRequest deserializedRequest;
                 try (StreamInput in = out.bytes().streamInput()) {
-                    in.setVersion(VersionUtils.randomVersionBetween(random(), VersionUtils.getFirstVersion(),
-                        VersionUtils.getPreviousVersion(Version.V_7_2_0)));
+                    in.setVersion(version);
                     deserializedRequest = new CloseIndexRequest(in);
                 }
                 assertEquals(sample.getParentTask(), deserializedRequest.getParentTask());
                 assertEquals(sample.masterNodeTimeout(), deserializedRequest.masterNodeTimeout());
                 assertEquals(sample.timeout(), deserializedRequest.timeout());
                 assertArrayEquals(sample.indices(), deserializedRequest.indices());
-                assertEquals(sample.indicesOptions(), deserializedRequest.indicesOptions());
-                assertEquals(ActiveShardCount.NONE, deserializedRequest.waitForActiveShards());
+                // indices options are not equivalent when sent to an older version and re-read due
+                // to the addition of hidden indices as expand to hidden indices is always true when
+                // read from a prior version
+                // TODO change version on backport
+                if (out.getVersion().onOrAfter(Version.V_8_0_0) || sample.indicesOptions().expandWildcardsHidden()) {
+                    assertEquals(sample.indicesOptions(), deserializedRequest.indicesOptions());
+                }
+                if (out.getVersion().onOrAfter(Version.V_7_2_0)) {
+                    assertEquals(sample.waitForActiveShards(), deserializedRequest.waitForActiveShards());
+                } else {
+                    assertEquals(ActiveShardCount.NONE, deserializedRequest.waitForActiveShards());
+                }
             }
         }
     }
@@ -94,7 +120,8 @@ private CloseIndexRequest randomRequest() {
         CloseIndexRequest request = new CloseIndexRequest();
         request.indices(generateRandomStringArray(10, 5, false, false));
         if (randomBoolean()) {
-            request.indicesOptions(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean()));
+            request.indicesOptions(
+                IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean()));
         }
         if (randomBoolean()) {
             request.timeout(randomPositiveTimeValue());
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverActionTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverActionTests.java
index 54454cd9f7ecb..c4afcf57e599a 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverActionTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/rollover/TransportRolloverActionTests.java
@@ -79,6 +79,7 @@
 import java.nio.file.Path;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Locale;
@@ -359,7 +360,24 @@ public void testRejectDuplicateAlias() {
         String indexName = randomFrom("foo-123", "bar-xyz");
         String aliasName = randomFrom("foo-write", "bar-write");
         final IllegalArgumentException ex = expectThrows(IllegalArgumentException.class,
-            () -> TransportRolloverAction.checkNoDuplicatedAliasInIndexTemplate(metaData, indexName, aliasName));
+            () -> TransportRolloverAction.checkNoDuplicatedAliasInIndexTemplate(metaData, indexName, aliasName, randomBoolean()));
+        assertThat(ex.getMessage(), containsString("index template [test-template]"));
+    }
+
+    public void testHiddenAffectsResolvedTemplates() {
+        final IndexTemplateMetaData template = IndexTemplateMetaData.builder("test-template")
+            .patterns(Collections.singletonList("*"))
+            .putAlias(AliasMetaData.builder("foo-write")).putAlias(AliasMetaData.builder("bar-write").writeIndex(randomBoolean()))
+            .build();
+        final MetaData metaData = MetaData.builder().put(createMetaData(randomAlphaOfLengthBetween(5, 7)), false).put(template).build();
+        String indexName = randomFrom("foo-123", "bar-xyz");
+        String aliasName = randomFrom("foo-write", "bar-write");
+
+        // hidden shouldn't throw
+        TransportRolloverAction.checkNoDuplicatedAliasInIndexTemplate(metaData, indexName, aliasName, Boolean.TRUE);
+        // not hidden will throw
+        final IllegalArgumentException ex = expectThrows(IllegalArgumentException.class, () ->
+            TransportRolloverAction.checkNoDuplicatedAliasInIndexTemplate(metaData, indexName, aliasName, randomFrom(Boolean.FALSE, null)));
         assertThat(ex.getMessage(), containsString("index template [test-template]"));
     }
 
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
index 5652f20e8b390..31add95f55401 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
@@ -48,17 +48,20 @@
 import java.util.concurrent.CountDownLatch;
 import java.util.stream.Collectors;
 
+import static java.util.Collections.singletonList;
 import static org.elasticsearch.common.settings.Settings.builder;
 import static org.hamcrest.CoreMatchers.containsString;
 import static org.hamcrest.CoreMatchers.equalTo;
 import static org.hamcrest.CoreMatchers.instanceOf;
 import static org.hamcrest.Matchers.contains;
+import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.empty;
+import static org.hamcrest.Matchers.is;
 
 public class MetaDataIndexTemplateServiceTests extends ESSingleNodeTestCase {
     public void testIndexTemplateInvalidNumberOfShards() {
         PutRequest request = new PutRequest("test", "test_shards");
-        request.patterns(Collections.singletonList("test_shards*"));
+        request.patterns(singletonList("test_shards*"));
 
         request.settings(builder()
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, "0")
@@ -76,7 +79,7 @@ public void testIndexTemplateInvalidNumberOfShards() {
 
     public void testIndexTemplateValidationAccumulatesValidationErrors() {
         PutRequest request = new PutRequest("test", "putTemplate shards");
-        request.patterns(Collections.singletonList("_test_shards*"));
+        request.patterns(singletonList("_test_shards*"));
         request.settings(builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, "0").build());
 
         List<Throwable> throwables = putTemplate(xContentRegistry(), request);
@@ -101,7 +104,7 @@ public void testIndexTemplateWithAliasNameEqualToTemplatePattern() {
 
     public void testIndexTemplateWithValidateMapping() throws Exception {
         PutRequest request = new PutRequest("api", "validate_template");
-        request.patterns(Collections.singletonList("te*"));
+        request.patterns(singletonList("te*"));
         request.putMapping("type1", Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
                         .startObject("properties").startObject("field2").field("type", "text").field("analyzer", "custom_1").endObject()
                         .endObject().endObject().endObject()));
@@ -114,7 +117,7 @@ public void testIndexTemplateWithValidateMapping() throws Exception {
 
     public void testBrokenMapping() throws Exception {
         PutRequest request = new PutRequest("api", "broken_mapping");
-        request.patterns(Collections.singletonList("te*"));
+        request.patterns(singletonList("te*"));
         request.putMapping("type1", "abcde");
 
         List<Throwable> errors = putTemplateDetail(request);
@@ -126,7 +129,7 @@ public void testBrokenMapping() throws Exception {
     public void testAliasInvalidFilterInvalidJson() throws Exception {
         //invalid json: put index template fails
         PutRequest request = new PutRequest("api", "blank_mapping");
-        request.patterns(Collections.singletonList("te*"));
+        request.patterns(singletonList("te*"));
         request.putMapping("type1", "{}");
         Set<Alias> aliases = new HashSet<>();
         aliases.add(new Alias("invalid_alias").filter("abcde"));
@@ -140,15 +143,63 @@ public void testAliasInvalidFilterInvalidJson() throws Exception {
 
     public void testFindTemplates() throws Exception {
         client().admin().indices().prepareDeleteTemplate("*").get(); // Delete all existing templates
-        putTemplateDetail(new PutRequest("test", "foo-1").patterns(Arrays.asList("foo-*")).order(1));
-        putTemplateDetail(new PutRequest("test", "foo-2").patterns(Arrays.asList("foo-*")).order(2));
-        putTemplateDetail(new PutRequest("test", "bar").patterns(Arrays.asList("bar-*")).order(between(0, 100)));
+        putTemplateDetail(new PutRequest("test", "foo-1").patterns(singletonList("foo-*")).order(1));
+        putTemplateDetail(new PutRequest("test", "foo-2").patterns(singletonList("foo-*")).order(2));
+        putTemplateDetail(new PutRequest("test", "bar").patterns(singletonList("bar-*")).order(between(0, 100)));
         final ClusterState state = client().admin().cluster().prepareState().get().getState();
-        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "foo-1234").stream()
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "foo-1234", randomBoolean()).stream()
             .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("foo-2", "foo-1"));
-        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "bar-xyz").stream()
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "bar-xyz", randomBoolean()).stream()
             .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("bar"));
-        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "baz"), empty());
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "baz", randomBoolean()), empty());
+    }
+
+    public void testFindTemplatesWithHiddenIndices() throws Exception {
+        client().admin().indices().prepareDeleteTemplate("*").get(); // Delete all existing templates
+        putTemplateDetail(new PutRequest("testFindTemplatesWithHiddenIndices", "foo-1").patterns(singletonList("foo-*")).order(1));
+        putTemplateDetail(new PutRequest("testFindTemplatesWithHiddenIndices", "foo-2").patterns(singletonList("foo-*")).order(2));
+        putTemplateDetail(
+            new PutRequest("testFindTemplatesWithHiddenIndices", "bar").patterns(singletonList("bar-*")).order(between(0, 100)));
+        putTemplateDetail(new PutRequest("testFindTemplatesWithHiddenIndices", "global").patterns(singletonList("*")));
+        putTemplateDetail(new PutRequest("testFindTemplatesWithHiddenIndices", "sneaky-hidden")
+            .patterns(singletonList("sneaky*")).settings(Settings.builder().put("index.hidden", true).build()));
+        final ClusterState state = client().admin().cluster().prepareState().get().getState();
+
+        // hidden
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "foo-1234", true).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("foo-2", "foo-1"));
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "bar-xyz", true).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("bar"));
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "baz", true), empty());
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "sneaky1", true).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("sneaky-hidden"));
+
+        // not hidden
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "foo-1234", false).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("foo-2", "foo-1", "global"));
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "bar-xyz", false).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("bar", "global"));
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "baz", false).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("global"));
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "sneaky1", false).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), containsInAnyOrder("global", "sneaky-hidden"));
+
+        // unknown
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "foo-1234", null).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("foo-2", "foo-1", "global"));
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "bar-xyz", null).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("bar", "global"));
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "baz", null).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("global"));
+        assertThat(MetaDataIndexTemplateService.findTemplates(state.metaData(), "sneaky1", null).stream()
+            .map(IndexTemplateMetaData::name).collect(Collectors.toList()), contains("sneaky-hidden"));
+    }
+
+    public void testPutGlobalTemplateWithIndexHiddenSetting() throws Exception {
+        List<Throwable> errors = putTemplateDetail(new PutRequest("testPutGlobalTemplateWithIndexHiddenSetting", "sneaky-hidden")
+            .patterns(singletonList("*")).settings(Settings.builder().put("index.hidden", true).build()));
+        assertThat(errors.size(), is(1));
+        assertThat(errors.get(0).getMessage(), containsString("global templates may not specify the setting index.hidden"));
     }
 
     private static List<Throwable> putTemplate(NamedXContentRegistry xContentRegistry, PutRequest request) {
@@ -192,7 +243,7 @@ private List<Throwable> putTemplateDetail(PutRequest request) throws Exception {
                 null,
                 null,
                 new Environment(builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString()).build(), null),
-                null,
+                IndexScopedSettings.DEFAULT_SCOPED_SETTINGS,
                 null,
                 xContentRegistry(),
                 true);
diff --git a/server/src/test/java/org/elasticsearch/action/search/MultiSearchRequestTests.java b/server/src/test/java/org/elasticsearch/action/search/MultiSearchRequestTests.java
index 35f60546bb023..11e586a6724a9 100644
--- a/server/src/test/java/org/elasticsearch/action/search/MultiSearchRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/search/MultiSearchRequestTests.java
@@ -25,9 +25,13 @@
 import org.elasticsearch.common.ParseField;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesArray;
+import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
+import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.query.MatchAllQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.rest.RestRequest;
@@ -43,6 +47,7 @@
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
+import java.util.Map;
 
 import static java.util.Collections.singletonList;
 import static org.elasticsearch.search.RandomSearchRequestGenerator.randomSearchRequest;
@@ -256,6 +261,37 @@ public void testMultiLineSerialization() throws IOException {
         }
     }
 
+    public void testWritingExpandWildcards() throws IOException {
+        assertExpandWildcardsValue(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), true, true, true, randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean()), "all");
+        assertExpandWildcardsValue(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), true, true, false, randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean()), "open,closed");
+        assertExpandWildcardsValue(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), true, false, true, randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean()), "open,hidden");
+        assertExpandWildcardsValue(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), true, false, false, randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean()), "open");
+        assertExpandWildcardsValue(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), false, true, true, randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean()), "closed,hidden");
+        assertExpandWildcardsValue(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), false, true, false, randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean()), "closed");
+        assertExpandWildcardsValue(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), false, false, true, randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean()), "hidden");
+        assertExpandWildcardsValue(IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), false, false, false, randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean()), "none");
+    }
+
+    private void assertExpandWildcardsValue(IndicesOptions options, String expectedValue) throws IOException {
+        SearchRequest request = new SearchRequest();
+        request.indicesOptions(options);
+        try (XContentBuilder builder = JsonXContent.contentBuilder()) {
+            MultiSearchRequest.writeSearchRequestParams(request, builder);
+            Map<String, Object> map =
+                XContentHelper.convertToMap(XContentType.JSON.xContent(), BytesReference.bytes(builder).streamInput(), false);
+            final String value = (String) map.get("expand_wildcards");
+            assertEquals(expectedValue, value);
+        }
+    }
+
     public void testEqualsAndHashcode() {
         checkEqualsAndHashCode(createMultiSearchRequest(), MultiSearchRequestTests::copyRequest, MultiSearchRequestTests::mutate);
     }
diff --git a/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java b/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
index f28873e155102..b5e60966e51fe 100644
--- a/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.test.EqualsHashCodeTestUtils;
 
 import java.io.IOException;
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
@@ -45,6 +46,7 @@
 
 import static org.elasticsearch.test.VersionUtils.randomVersionBetween;
 import static org.hamcrest.CoreMatchers.equalTo;
+import static org.hamcrest.Matchers.is;
 
 public class IndicesOptionsTests extends ESTestCase {
 
@@ -54,7 +56,7 @@ public void testSerialization() throws Exception {
             Version version = randomVersionBetween(random(), Version.V_7_0_0, null);
             IndicesOptions indicesOptions = IndicesOptions.fromOptions(
                 randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(),
-                randomBoolean());
+                randomBoolean(), randomBoolean());
 
             BytesStreamOutput output = new BytesStreamOutput();
             output.setVersion(version);
@@ -68,6 +70,11 @@ public void testSerialization() throws Exception {
             assertThat(indicesOptions2.allowNoIndices(), equalTo(indicesOptions.allowNoIndices()));
             assertThat(indicesOptions2.expandWildcardsOpen(), equalTo(indicesOptions.expandWildcardsOpen()));
             assertThat(indicesOptions2.expandWildcardsClosed(), equalTo(indicesOptions.expandWildcardsClosed()));
+            if (version.before(Version.V_8_0_0)) {
+                assertThat(indicesOptions2.expandWildcardsHidden(), is(true));
+            } else {
+                assertThat(indicesOptions2.expandWildcardsHidden(), equalTo(indicesOptions.expandWildcardsHidden()));
+            }
 
             assertThat(indicesOptions2.forbidClosedIndices(), equalTo(indicesOptions.forbidClosedIndices()));
             assertThat(indicesOptions2.allowAliasesToMultipleIndices(), equalTo(indicesOptions.allowAliasesToMultipleIndices()));
@@ -77,27 +84,30 @@ public void testSerialization() throws Exception {
     }
 
     public void testFromOptions() {
-        boolean ignoreUnavailable = randomBoolean();
-        boolean allowNoIndices = randomBoolean();
-        boolean expandToOpenIndices = randomBoolean();
-        boolean expandToClosedIndices = randomBoolean();
-        boolean allowAliasesToMultipleIndices = randomBoolean();
-        boolean forbidClosedIndices = randomBoolean();
-        boolean ignoreAliases = randomBoolean();
-        boolean ingoreThrottled = randomBoolean();
-
-        IndicesOptions indicesOptions = IndicesOptions.fromOptions(ignoreUnavailable, allowNoIndices,expandToOpenIndices,
-                expandToClosedIndices, allowAliasesToMultipleIndices, forbidClosedIndices, ignoreAliases, ingoreThrottled);
+        final boolean ignoreUnavailable = randomBoolean();
+        final boolean allowNoIndices = randomBoolean();
+        final boolean expandToOpenIndices = randomBoolean();
+        final boolean expandToClosedIndices = randomBoolean();
+        final boolean expandToHiddenIndices = randomBoolean();
+        final boolean allowAliasesToMultipleIndices = randomBoolean();
+        final boolean forbidClosedIndices = randomBoolean();
+        final boolean ignoreAliases = randomBoolean();
+        final boolean ignoreThrottled = randomBoolean();
+
+        IndicesOptions indicesOptions = IndicesOptions.fromOptions(ignoreUnavailable, allowNoIndices, expandToOpenIndices,
+            expandToClosedIndices, expandToHiddenIndices, allowAliasesToMultipleIndices, forbidClosedIndices, ignoreAliases,
+            ignoreThrottled);
 
         assertThat(indicesOptions.ignoreUnavailable(), equalTo(ignoreUnavailable));
         assertThat(indicesOptions.allowNoIndices(), equalTo(allowNoIndices));
         assertThat(indicesOptions.expandWildcardsOpen(), equalTo(expandToOpenIndices));
         assertThat(indicesOptions.expandWildcardsClosed(), equalTo(expandToClosedIndices));
+        assertThat(indicesOptions.expandWildcardsHidden(), equalTo(expandToHiddenIndices));
         assertThat(indicesOptions.allowAliasesToMultipleIndices(), equalTo(allowAliasesToMultipleIndices));
         assertThat(indicesOptions.allowAliasesToMultipleIndices(), equalTo(allowAliasesToMultipleIndices));
         assertThat(indicesOptions.forbidClosedIndices(), equalTo(forbidClosedIndices));
         assertEquals(ignoreAliases, indicesOptions.ignoreAliases());
-        assertEquals(ingoreThrottled, indicesOptions.ignoreThrottled());
+        assertEquals(ignoreThrottled, indicesOptions.ignoreThrottled());
     }
 
     public void testFromOptionsWithDefaultOptions() {
@@ -106,53 +116,64 @@ public void testFromOptionsWithDefaultOptions() {
         boolean expandToOpenIndices = randomBoolean();
         boolean expandToClosedIndices = randomBoolean();
 
-        IndicesOptions defaultOptions = IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(),
+        IndicesOptions defaultOptions = IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(),
                 randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean());
 
-        IndicesOptions indicesOptions = IndicesOptions.fromOptions(ignoreUnavailable, allowNoIndices,expandToOpenIndices,
+        IndicesOptions indicesOptions = IndicesOptions.fromOptions(ignoreUnavailable, allowNoIndices, expandToOpenIndices,
                 expandToClosedIndices, defaultOptions);
 
         assertEquals(ignoreUnavailable, indicesOptions.ignoreUnavailable());
         assertEquals(allowNoIndices, indicesOptions.allowNoIndices());
         assertEquals(expandToOpenIndices, indicesOptions.expandWildcardsOpen());
         assertEquals(expandToClosedIndices, indicesOptions.expandWildcardsClosed());
+        assertEquals(defaultOptions.expandWildcardsHidden(), indicesOptions.expandWildcardsHidden());
         assertEquals(defaultOptions.allowAliasesToMultipleIndices(), indicesOptions.allowAliasesToMultipleIndices());
         assertEquals(defaultOptions.forbidClosedIndices(), indicesOptions.forbidClosedIndices());
         assertEquals(defaultOptions.ignoreAliases(), indicesOptions.ignoreAliases());
     }
 
     public void testFromParameters() {
-        boolean expandWildcardsOpen = randomBoolean();
-        boolean expandWildcardsClosed = randomBoolean();
-        String expandWildcardsString;
-        if (expandWildcardsOpen && expandWildcardsClosed) {
+        final boolean expandWildcardsOpen = randomBoolean();
+        final boolean expandWildcardsClosed = randomBoolean();
+        final boolean expandWildcardsHidden = randomBoolean();
+        final String expandWildcardsString;
+        if (expandWildcardsOpen && expandWildcardsClosed && expandWildcardsHidden) {
             if (randomBoolean()) {
-                expandWildcardsString = "open,closed";
+                expandWildcardsString = "open,closed,hidden";
             } else {
                 expandWildcardsString = "all";
             }
-        } else if (expandWildcardsOpen) {
-            expandWildcardsString = "open";
-        } else if (expandWildcardsClosed) {
-            expandWildcardsString = "closed";
         } else {
-            expandWildcardsString = "none";
+            List<String> values = new ArrayList<>();
+            if (expandWildcardsOpen) {
+                values.add("open");
+            }
+            if (expandWildcardsClosed) {
+                values.add("closed");
+            }
+            if (expandWildcardsHidden) {
+                values.add("hidden");
+            }
+            if (values.isEmpty() && randomBoolean()) {
+                values.add("none");
+            }
+            expandWildcardsString = String.join(",", values);
         }
         boolean ignoreUnavailable = randomBoolean();
         String ignoreUnavailableString = Boolean.toString(ignoreUnavailable);
         boolean ignoreThrottled = randomBoolean();
-        String ignoreThrottledString = Boolean.toString(ignoreThrottled);
         boolean allowNoIndices = randomBoolean();
         String allowNoIndicesString = Boolean.toString(allowNoIndices);
 
         IndicesOptions defaultOptions = IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(),
-                randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean());
+                randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean());
 
         IndicesOptions updatedOptions = IndicesOptions.fromParameters(expandWildcardsString, ignoreUnavailableString,
                 allowNoIndicesString, ignoreThrottled, defaultOptions);
 
         assertEquals(expandWildcardsOpen, updatedOptions.expandWildcardsOpen());
         assertEquals(expandWildcardsClosed, updatedOptions.expandWildcardsClosed());
+        assertEquals(expandWildcardsHidden, updatedOptions.expandWildcardsHidden());
         assertEquals(ignoreUnavailable, updatedOptions.ignoreUnavailable());
         assertEquals(allowNoIndices, updatedOptions.allowNoIndices());
         assertEquals(defaultOptions.allowAliasesToMultipleIndices(), updatedOptions.allowAliasesToMultipleIndices());
@@ -161,20 +182,20 @@ public void testFromParameters() {
     }
 
     public void testEqualityAndHashCode() {
-        IndicesOptions indicesOptions = IndicesOptions.fromOptions(
-            randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(),
-            randomBoolean());
+        IndicesOptions indicesOptions = IndicesOptions.fromOptions(randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(),
+            randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean(), randomBoolean());
 
         EqualsHashCodeTestUtils.checkEqualsAndHashCode(indicesOptions, opts -> {
             return IndicesOptions.fromOptions(opts.ignoreUnavailable(), opts.allowNoIndices(), opts.expandWildcardsOpen(),
-                opts.expandWildcardsClosed(), opts.allowAliasesToMultipleIndices(), opts.forbidClosedIndices(), opts.ignoreAliases(),
-                opts.ignoreThrottled());
+                opts.expandWildcardsClosed(), opts.expandWildcardsHidden(), opts.allowAliasesToMultipleIndices(),
+                opts.forbidClosedIndices(), opts.ignoreAliases(), opts.ignoreThrottled());
         }, opts -> {
             boolean mutated = false;
             boolean ignoreUnavailable = opts.ignoreUnavailable();
             boolean allowNoIndices = opts.allowNoIndices();
             boolean expandOpen = opts.expandWildcardsOpen();
             boolean expandClosed = opts.expandWildcardsClosed();
+            boolean expandHidden = opts.expandWildcardsHidden();
             boolean allowAliasesToMulti = opts.allowAliasesToMultipleIndices();
             boolean forbidClosed = opts.forbidClosedIndices();
             boolean ignoreAliases = opts.ignoreAliases();
@@ -196,6 +217,10 @@ public void testEqualityAndHashCode() {
                     expandClosed = !expandClosed;
                     mutated = true;
                 }
+                if (randomBoolean()) {
+                    expandHidden = !expandHidden;
+                    mutated = true;
+                }
                 if (randomBoolean()) {
                     allowAliasesToMulti = !allowAliasesToMulti;
                     mutated = true;
@@ -213,7 +238,7 @@ public void testEqualityAndHashCode() {
                     mutated = true;
                 }
             }
-            return IndicesOptions.fromOptions(ignoreUnavailable, allowNoIndices, expandOpen, expandClosed,
+            return IndicesOptions.fromOptions(ignoreUnavailable, allowNoIndices, expandOpen, expandClosed, expandHidden,
                 allowAliasesToMulti, forbidClosed, ignoreAliases, ignoreThrottled);
         });
     }
@@ -221,7 +246,7 @@ public void testEqualityAndHashCode() {
     public void testFromMap() {
         IndicesOptions defaults = IndicesOptions.strictExpandOpen();
         Collection<String> wildcardStates = randomBoolean() ?
-                null : randomSubsetOf(Arrays.asList("open", "closed"));
+                null : randomSubsetOf(Arrays.asList("open", "closed", "hidden"));
         Boolean ignoreUnavailable = randomBoolean() ? null : randomBoolean();
         Boolean allowNoIndices = randomBoolean() ? null : randomBoolean();
         Boolean ignoreThrottled = randomBoolean() ? null : randomBoolean();
@@ -247,13 +272,15 @@ public void testFromMap() {
         IndicesOptions fromMap = IndicesOptions.fromMap(settings, defaults);
 
         boolean open = wildcardStates != null ? wildcardStates.contains("open") : defaults.expandWildcardsOpen();
-        assertEquals(fromMap.expandWildcardsOpen(), open);
+        assertEquals(open, fromMap.expandWildcardsOpen());
         boolean closed = wildcardStates != null ? wildcardStates.contains("closed") : defaults.expandWildcardsClosed();
-        assertEquals(fromMap.expandWildcardsClosed(), closed);
+        assertEquals(closed, fromMap.expandWildcardsClosed());
+        boolean hidden = wildcardStates != null ? wildcardStates.contains("hidden") : defaults.expandWildcardsHidden();
+        assertEquals(hidden, fromMap.expandWildcardsHidden());
 
-        assertEquals(fromMap.ignoreUnavailable(), ignoreUnavailable == null ? defaults.ignoreUnavailable() : ignoreUnavailable);
-        assertEquals(fromMap.allowNoIndices(), allowNoIndices == null ? defaults.allowNoIndices() : allowNoIndices);
-        assertEquals(fromMap.ignoreThrottled(), ignoreThrottled == null ? defaults.ignoreThrottled() : ignoreThrottled);
+        assertEquals(ignoreUnavailable == null ? defaults.ignoreUnavailable() : ignoreUnavailable, fromMap.ignoreUnavailable());
+        assertEquals(allowNoIndices == null ? defaults.allowNoIndices() : allowNoIndices, fromMap.allowNoIndices());
+        assertEquals(ignoreThrottled == null ? defaults.ignoreThrottled() : ignoreThrottled, fromMap.ignoreThrottled());
     }
 
     public void testToXContent() throws IOException {
@@ -284,6 +311,7 @@ public void testToXContent() throws IOException {
         } else {
             assertFalse(((List<?>) map.get("expand_wildcards")).contains("closed"));
         }
+        assertEquals(wildcardStates.contains(WildcardStates.HIDDEN), ((List<?>) map.get("expand_wildcards")).contains("hidden"));
         assertEquals(map.get("ignore_unavailable"), options.contains(Option.IGNORE_UNAVAILABLE));
         assertEquals(map.get("allow_no_indices"), options.contains(Option.ALLOW_NO_INDICES));
         assertEquals(map.get("ignore_throttled"), options.contains(Option.IGNORE_THROTTLED));
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolverTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolverTests.java
index 371ce0be6aa87..ab2177b51d684 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolverTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/IndexNameExpressionResolverTests.java
@@ -272,11 +272,15 @@ public void testIndexOptionsWildcardExpansion() {
         MetaData.Builder mdBuilder = MetaData.builder()
                 .put(indexBuilder("foo").state(IndexMetaData.State.CLOSE))
                 .put(indexBuilder("bar"))
-                .put(indexBuilder("foobar").putAlias(AliasMetaData.builder("barbaz")));
+                .put(indexBuilder("foobar").putAlias(AliasMetaData.builder("barbaz")))
+                .put(indexBuilder("hidden", Settings.builder().put("index.hidden", true).build()))
+                .put(indexBuilder(".hidden", Settings.builder().put("index.hidden", true).build()))
+                .put(indexBuilder(".hidden-closed", Settings.builder().put("index.hidden", true).build()).state(IndexMetaData.State.CLOSE))
+                .put(indexBuilder("hidden-closed", Settings.builder().put("index.hidden", true).build()).state(IndexMetaData.State.CLOSE));
         ClusterState state = ClusterState.builder(new ClusterName("_name")).metaData(mdBuilder).build();
 
         // Only closed
-        IndicesOptions options = IndicesOptions.fromOptions(false, true, false, true);
+        IndicesOptions options = IndicesOptions.fromOptions(false, true, false, true, false);
         IndexNameExpressionResolver.Context context = new IndexNameExpressionResolver.Context(state, options);
         String[] results = indexNameExpressionResolver.concreteIndexNames(context, Strings.EMPTY_ARRAY);
         assertEquals(1, results.length);
@@ -291,8 +295,17 @@ public void testIndexOptionsWildcardExpansion() {
         assertEquals(1, results.length);
         assertEquals("bar", results[0]);
 
+        // implicit hidden for dot indices based on wildcard starting with .
+        results = indexNameExpressionResolver.concreteIndexNames(context, ".*");
+        assertEquals(1, results.length);
+        assertThat(results, arrayContainingInAnyOrder(".hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, ".hidd*");
+        assertEquals(1, results.length);
+        assertThat(results, arrayContainingInAnyOrder(".hidden-closed"));
+
         // Only open
-        options = IndicesOptions.fromOptions(false, true, true, false);
+        options = IndicesOptions.fromOptions(false, true, true, false, false);
         context = new IndexNameExpressionResolver.Context(state, options);
         results = indexNameExpressionResolver.concreteIndexNames(context, Strings.EMPTY_ARRAY);
         assertEquals(2, results.length);
@@ -306,8 +319,17 @@ public void testIndexOptionsWildcardExpansion() {
         assertEquals(1, results.length);
         assertEquals("bar", results[0]);
 
+        // implicit hidden for dot indices based on wildcard starting with .
+        results = indexNameExpressionResolver.concreteIndexNames(context, ".*");
+        assertEquals(1, results.length);
+        assertThat(results, arrayContainingInAnyOrder(".hidden"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, ".hidd*");
+        assertEquals(1, results.length);
+        assertThat(results, arrayContainingInAnyOrder(".hidden"));
+
         // Open and closed
-        options = IndicesOptions.fromOptions(false, true, true, true);
+        options = IndicesOptions.fromOptions(false, true, true, true, false);
         context = new IndexNameExpressionResolver.Context(state, options);
         results = indexNameExpressionResolver.concreteIndexNames(context, Strings.EMPTY_ARRAY);
         assertEquals(3, results.length);
@@ -332,7 +354,111 @@ public void testIndexOptionsWildcardExpansion() {
         results = indexNameExpressionResolver.concreteIndexNames(context, "-*");
         assertEquals(0, results.length);
 
-        options = IndicesOptions.fromOptions(false, false, true, true);
+        // implicit hidden for dot indices based on wildcard starting with .
+        results = indexNameExpressionResolver.concreteIndexNames(context, ".*");
+        assertEquals(2, results.length);
+        assertThat(results, arrayContainingInAnyOrder(".hidden", ".hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, ".hidd*");
+        assertEquals(2, results.length);
+        assertThat(results, arrayContainingInAnyOrder(".hidden", ".hidden-closed"));
+
+        // open closed and hidden
+        options = IndicesOptions.fromOptions(false, true, true, true, true);
+        context = new IndexNameExpressionResolver.Context(state, options);
+        results = indexNameExpressionResolver.concreteIndexNames(context, Strings.EMPTY_ARRAY);
+        assertEquals(7, results.length);
+        assertThat(results, arrayContainingInAnyOrder("bar", "foobar", "foo", "hidden", "hidden-closed", ".hidden", ".hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "foo*");
+        assertEquals(2, results.length);
+        assertThat(results, arrayContainingInAnyOrder("foobar", "foo"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "bar");
+        assertEquals(1, results.length);
+        assertEquals("bar", results[0]);
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "*", "-foo*");
+        assertEquals(5, results.length);
+        assertThat(results, arrayContainingInAnyOrder("bar", "hidden", "hidden-closed", ".hidden", ".hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "*", "-foo", "-foobar");
+        assertEquals(5, results.length);
+        assertThat(results, arrayContainingInAnyOrder("bar", "hidden", "hidden-closed", ".hidden", ".hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "*", "-foo", "-foobar", "-hidden*");
+        assertEquals(3, results.length);
+        assertThat(results, arrayContainingInAnyOrder("bar", ".hidden", ".hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "hidden*");
+        assertEquals(2, results.length);
+        assertThat(results, arrayContainingInAnyOrder("hidden", "hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "hidden");
+        assertEquals(1, results.length);
+        assertThat(results, arrayContainingInAnyOrder("hidden"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "hidden-closed");
+        assertEquals(1, results.length);
+        assertThat(results, arrayContainingInAnyOrder("hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "-*");
+        assertEquals(0, results.length);
+
+        // open and hidden
+        options = IndicesOptions.fromOptions(false, true, true, false, true);
+        context = new IndexNameExpressionResolver.Context(state, options);
+        results = indexNameExpressionResolver.concreteIndexNames(context, Strings.EMPTY_ARRAY);
+        assertEquals(4, results.length);
+        assertThat(results, arrayContainingInAnyOrder("bar", "foobar", "hidden", ".hidden"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "foo*");
+        assertEquals(1, results.length);
+        assertEquals("foobar", results[0]);
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "bar");
+        assertEquals(1, results.length);
+        assertEquals("bar", results[0]);
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "h*");
+        assertEquals(1, results.length);
+        assertEquals("hidden", results[0]);
+
+        // closed and hidden
+        options = IndicesOptions.fromOptions(false, true, false, true, true);
+        context = new IndexNameExpressionResolver.Context(state, options);
+        results = indexNameExpressionResolver.concreteIndexNames(context, Strings.EMPTY_ARRAY);
+        assertEquals(3, results.length);
+        assertThat(results, arrayContainingInAnyOrder("foo", "hidden-closed", ".hidden-closed"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "foo*");
+        assertEquals(1, results.length);
+        assertEquals("foo", results[0]);
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "bar");
+        assertEquals(1, results.length);
+        assertEquals("bar", results[0]);
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "h*");
+        assertEquals(1, results.length);
+        assertEquals("hidden-closed", results[0]);
+
+        // only hidden
+        options = IndicesOptions.fromOptions(false, true, false, false, true);
+        context = new IndexNameExpressionResolver.Context(state, options);
+        results = indexNameExpressionResolver.concreteIndexNames(context, Strings.EMPTY_ARRAY);
+        assertThat(results, emptyArray());
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "h*");
+        assertThat(results, emptyArray());
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "hidden");
+        assertThat(results, arrayContainingInAnyOrder("hidden"));
+
+        results = indexNameExpressionResolver.concreteIndexNames(context, "hidden-closed");
+        assertThat(results, arrayContainingInAnyOrder("hidden-closed"));
+
+        options = IndicesOptions.fromOptions(false, false, true, true, true);
         IndexNameExpressionResolver.Context context2 = new IndexNameExpressionResolver.Context(state, options);
         IndexNotFoundException infe = expectThrows(IndexNotFoundException.class,
                 () -> indexNameExpressionResolver.concreteIndexNames(context2, "-*"));
@@ -349,7 +475,7 @@ public void testIndexOptionsNoExpandWildcards() {
 
         //ignore unavailable and allow no indices
         {
-            IndicesOptions noExpandLenient = IndicesOptions.fromOptions(true, true, false, false);
+            IndicesOptions noExpandLenient = IndicesOptions.fromOptions(true, true, false, false, randomBoolean());
             IndexNameExpressionResolver.Context context = new IndexNameExpressionResolver.Context(state, noExpandLenient);
             String[] results = indexNameExpressionResolver.concreteIndexNames(context, "baz*");
             assertThat(results, emptyArray());
@@ -371,7 +497,7 @@ public void testIndexOptionsNoExpandWildcards() {
 
         //ignore unavailable but don't allow no indices
         {
-            IndicesOptions noExpandDisallowEmpty = IndicesOptions.fromOptions(true, false, false, false);
+            IndicesOptions noExpandDisallowEmpty = IndicesOptions.fromOptions(true, false, false, false, randomBoolean());
             IndexNameExpressionResolver.Context context = new IndexNameExpressionResolver.Context(state, noExpandDisallowEmpty);
 
             {
@@ -396,7 +522,7 @@ public void testIndexOptionsNoExpandWildcards() {
 
         //error on unavailable but allow no indices
         {
-            IndicesOptions noExpandErrorUnavailable = IndicesOptions.fromOptions(false, true, false, false);
+            IndicesOptions noExpandErrorUnavailable = IndicesOptions.fromOptions(false, true, false, false, randomBoolean());
             IndexNameExpressionResolver.Context context = new IndexNameExpressionResolver.Context(state, noExpandErrorUnavailable);
             {
                 String[] results = indexNameExpressionResolver.concreteIndexNames(context, "baz*");
@@ -422,7 +548,7 @@ public void testIndexOptionsNoExpandWildcards() {
 
         //error on both unavailable and no indices
         {
-            IndicesOptions noExpandStrict = IndicesOptions.fromOptions(false, false, false, false);
+            IndicesOptions noExpandStrict = IndicesOptions.fromOptions(false, false, false, false, randomBoolean());
             IndexNameExpressionResolver.Context context = new IndexNameExpressionResolver.Context(state, noExpandStrict);
             IndexNotFoundException infe = expectThrows(IndexNotFoundException.class,
                     () -> indexNameExpressionResolver.concreteIndexNames(context, "baz*"));
@@ -539,12 +665,17 @@ public void testIndexOptionsEmptyCluster() {
     }
 
     private static IndexMetaData.Builder indexBuilder(String index) {
-        return IndexMetaData.builder(index).settings(settings());
+        return indexBuilder(index, Settings.EMPTY);
+    }
+
+    private static IndexMetaData.Builder indexBuilder(String index, Settings additionalSettings) {
+        return IndexMetaData.builder(index).settings(settings(additionalSettings));
     }
 
-    private static Settings.Builder settings() {
+    private static Settings.Builder settings(Settings additionalSettings) {
         return settings(Version.CURRENT).put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0);
+            .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
+            .put(additionalSettings);
     }
 
     public void testConcreteIndicesIgnoreIndicesOneMissingIndex() {
@@ -1397,13 +1528,13 @@ public void testInvalidIndex() {
 
     public void testIgnoreThrottled() {
         MetaData.Builder mdBuilder = MetaData.builder()
-            .put(indexBuilder("test-index").state(State.OPEN)
-                .settings(settings().put(IndexSettings.INDEX_SEARCH_THROTTLED.getKey(), true))
+            .put(indexBuilder("test-index", Settings.builder().put(IndexSettings.INDEX_SEARCH_THROTTLED.getKey(), true).build())
+                .state(State.OPEN)
                 .putAlias(AliasMetaData.builder("test-alias")))
             .put(indexBuilder("index").state(State.OPEN)
                 .putAlias(AliasMetaData.builder("test-alias2")))
-            .put(indexBuilder("index-closed").state(State.CLOSE)
-                .settings(settings().put(IndexSettings.INDEX_SEARCH_THROTTLED.getKey(), true))
+            .put(indexBuilder("index-closed", Settings.builder().put(IndexSettings.INDEX_SEARCH_THROTTLED.getKey(), true).build())
+                .state(State.CLOSE)
                 .putAlias(AliasMetaData.builder("test-alias-closed")));
         ClusterState state = ClusterState.builder(new ClusterName("_name")).metaData(mdBuilder).build();
         {
diff --git a/server/src/test/java/org/elasticsearch/index/HiddenIndexIT.java b/server/src/test/java/org/elasticsearch/index/HiddenIndexIT.java
new file mode 100644
index 0000000000000..ca4fa588b144a
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/HiddenIndexIT.java
@@ -0,0 +1,129 @@
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.elasticsearch.index;
+
+import org.elasticsearch.action.admin.indices.mapping.get.GetMappingsResponse;
+import org.elasticsearch.action.admin.indices.settings.get.GetSettingsResponse;
+import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.action.support.IndicesOptions;
+import org.elasticsearch.action.support.WriteRequest.RefreshPolicy;
+import org.elasticsearch.cluster.metadata.MappingMetaData;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.indices.InvalidIndexTemplateException;
+import org.elasticsearch.test.ESIntegTestCase;
+
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.is;
+
+public class HiddenIndexIT extends ESIntegTestCase {
+
+    public void testHiddenIndexSearch() {
+        assertAcked(client().admin().indices().prepareCreate("hidden-index")
+            .setSettings(Settings.builder().put("index.hidden", true).build())
+            .get());
+        client().prepareIndex("hidden-index").setSource("foo", "bar").setRefreshPolicy(RefreshPolicy.IMMEDIATE).get();
+
+        // default not visible to wildcard expansion
+        SearchResponse searchResponse =
+            client().prepareSearch(randomFrom("*", "_all", "h*", "*index")).setSize(1000).setQuery(QueryBuilders.matchAllQuery()).get();
+        boolean matchedHidden = Arrays.stream(searchResponse.getHits().getHits()).anyMatch(hit -> "hidden-index".equals(hit.getIndex()));
+        assertFalse(matchedHidden);
+
+        // direct access allowed
+        searchResponse = client().prepareSearch("hidden-index").setSize(1000).setQuery(QueryBuilders.matchAllQuery()).get();
+        matchedHidden = Arrays.stream(searchResponse.getHits().getHits()).anyMatch(hit -> "hidden-index".equals(hit.getIndex()));
+        assertTrue(matchedHidden);
+
+        // with indices option to include hidden
+        searchResponse = client().prepareSearch(randomFrom("*", "_all", "h*", "*index"))
+            .setSize(1000)
+            .setQuery(QueryBuilders.matchAllQuery())
+            .setIndicesOptions(IndicesOptions.LENIENT_EXPAND_OPEN_HIDDEN)
+            .get();
+        matchedHidden = Arrays.stream(searchResponse.getHits().getHits()).anyMatch(hit -> "hidden-index".equals(hit.getIndex()));
+        assertTrue(matchedHidden);
+
+        // implicit based on use of pattern starting with . and a wildcard
+        assertAcked(client().admin().indices().prepareCreate(".hidden-index")
+            .setSettings(Settings.builder().put("index.hidden", true).build())
+            .get());
+        client().prepareIndex(".hidden-index").setSource("foo", "bar").setRefreshPolicy(RefreshPolicy.IMMEDIATE).get();
+        searchResponse = client().prepareSearch(randomFrom(".*", ".hidden-*"))
+            .setSize(1000)
+            .setQuery(QueryBuilders.matchAllQuery())
+            .get();
+        matchedHidden = Arrays.stream(searchResponse.getHits().getHits()).anyMatch(hit -> ".hidden-index".equals(hit.getIndex()));
+        assertTrue(matchedHidden);
+    }
+
+    public void testGlobalTemplatesDoNotApply() {
+        assertAcked(client().admin().indices().preparePutTemplate("a_global_template").setPatterns(List.of("*"))
+            .setMapping("foo", "type=text").get());
+        assertAcked(client().admin().indices().preparePutTemplate("not_global_template").setPatterns(List.of("a*"))
+            .setMapping("bar", "type=text").get());
+        assertAcked(client().admin().indices().preparePutTemplate("specific_template").setPatterns(List.of("a_hidden_index"))
+            .setMapping("baz", "type=text").get());
+        assertAcked(client().admin().indices().preparePutTemplate("unused_template").setPatterns(List.of("not_used"))
+            .setMapping("foobar", "type=text").get());
+
+        assertAcked(client().admin().indices().prepareCreate("a_hidden_index")
+            .setSettings(Settings.builder().put("index.hidden", true).build()).get());
+
+        GetMappingsResponse mappingsResponse = client().admin().indices().prepareGetMappings("a_hidden_index").get();
+        assertThat(mappingsResponse.mappings().size(), is(1));
+        MappingMetaData mappingMetaData = mappingsResponse.mappings().get("a_hidden_index");
+        assertNotNull(mappingMetaData);
+        Map<String, Object> propertiesMap = (Map<String, Object>) mappingMetaData.getSourceAsMap().get("properties");
+        assertNotNull(propertiesMap);
+        assertThat(propertiesMap.size(), is(2));
+        Map<String, Object> barMap = (Map<String, Object>) propertiesMap.get("bar");
+        assertNotNull(barMap);
+        assertThat(barMap.get("type"), is("text"));
+        Map<String, Object> bazMap = (Map<String, Object>) propertiesMap.get("baz");
+        assertNotNull(bazMap);
+        assertThat(bazMap.get("type"), is("text"));
+    }
+
+    public void testGlobalTemplateCannotMakeIndexHidden() {
+        InvalidIndexTemplateException invalidIndexTemplateException = expectThrows(InvalidIndexTemplateException.class,
+            () -> client().admin().indices().preparePutTemplate("a_global_template")
+                .setPatterns(List.of("*"))
+                .setSettings(Settings.builder().put("index.hidden", randomBoolean()).build())
+                .get());
+        assertThat(invalidIndexTemplateException.getMessage(), containsString("global templates may not specify the setting index.hidden"));
+    }
+
+    public void testNonGlobalTemplateCanMakeIndexHidden() {
+        assertAcked(client().admin().indices().preparePutTemplate("a_global_template")
+            .setPatterns(List.of("my_hidden_pattern*"))
+            .setMapping("foo", "type=text")
+            .setSettings(Settings.builder().put("index.hidden", true).build())
+            .get());
+        assertAcked(client().admin().indices().prepareCreate("my_hidden_pattern1").get());
+        GetSettingsResponse getSettingsResponse = client().admin().indices().prepareGetSettings("my_hidden_pattern1").get();
+        assertThat(getSettingsResponse.getSetting("my_hidden_pattern1", "index.hidden"), is("true"));
+    }
+}
diff --git a/test/framework/src/main/java/org/elasticsearch/test/TestCluster.java b/test/framework/src/main/java/org/elasticsearch/test/TestCluster.java
index a469088bcb6c3..b11e4b0c35e3e 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/TestCluster.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/TestCluster.java
@@ -25,6 +25,7 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.admin.cluster.state.ClusterStateResponse;
 import org.elasticsearch.action.admin.indices.template.get.GetIndexTemplatesResponse;
+import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.cluster.metadata.IndexTemplateMetaData;
@@ -134,7 +135,9 @@ public void wipeIndices(String... indices) {
         assert indices != null && indices.length > 0;
         if (size() > 0) {
             try {
-                assertAcked(client().admin().indices().prepareDelete(indices));
+                // include wiping hidden indices!
+                assertAcked(client().admin().indices().prepareDelete(indices)
+                    .setIndicesOptions(IndicesOptions.fromOptions(false, true, true, true, true, false, false, true, false)));
             } catch (IndexNotFoundException e) {
                 // ignore
             } catch (IllegalArgumentException e) {
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProviderTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProviderTests.java
index 866fc3337c5a7..969ecbaa75c81 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProviderTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/persistence/JobResultsProviderTests.java
@@ -160,6 +160,7 @@ public void testCreateJobWithExistingIndex() {
 
         ImmutableOpenMap<String, AliasMetaData> aliases = ImmutableOpenMap.of();
         when(indexMetaData.getAliases()).thenReturn(aliases);
+        when(indexMetaData.getSettings()).thenReturn(Settings.EMPTY);
 
         ImmutableOpenMap<String, IndexMetaData> indexMap = ImmutableOpenMap.<String, IndexMetaData>builder()
                 .fPut(AnomalyDetectorsIndex.jobResultsAliasedName("foo"), indexMetaData).build();
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/IndicesAndAliasesResolver.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/IndicesAndAliasesResolver.java
index 7245bf7356611..21af40707aec9 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/IndicesAndAliasesResolver.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/IndicesAndAliasesResolver.java
@@ -16,6 +16,7 @@
 import org.elasticsearch.cluster.metadata.AliasMetaData;
 import org.elasticsearch.cluster.metadata.AliasOrIndex;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.IndexMetaData.State;
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.service.ClusterService;
@@ -120,16 +121,15 @@ ResolvedIndices resolveIndicesAndAliases(IndicesRequest indicesRequest, MetaData
                     : "indices are: " + Arrays.toString(indicesRequest.indices()); // Arrays.toString() can handle null values - all good
             resolvedIndicesBuilder.addLocal(getPutMappingIndexOrAlias((PutMappingRequest) indicesRequest, authorizedIndices, metaData));
         } else if (indicesRequest instanceof IndicesRequest.Replaceable) {
-            IndicesRequest.Replaceable replaceable = (IndicesRequest.Replaceable) indicesRequest;
-            final boolean replaceWildcards = indicesRequest.indicesOptions().expandWildcardsOpen()
-                    || indicesRequest.indicesOptions().expandWildcardsClosed();
-            IndicesOptions indicesOptions = indicesRequest.indicesOptions();
+            final IndicesRequest.Replaceable replaceable = (IndicesRequest.Replaceable) indicesRequest;
+            final IndicesOptions indicesOptions = indicesRequest.indicesOptions();
+            final boolean replaceWildcards = indicesOptions.expandWildcardsOpen() || indicesOptions.expandWildcardsClosed();
 
             // check for all and return list of authorized indices
             if (IndexNameExpressionResolver.isAllIndices(indicesList(indicesRequest.indices()))) {
                 if (replaceWildcards) {
                     for (String authorizedIndex : authorizedIndices) {
-                        if (isIndexVisible(authorizedIndex, indicesOptions, metaData)) {
+                        if (isIndexVisible("*", authorizedIndex, indicesOptions, metaData)) {
                             resolvedIndicesBuilder.addLocal(authorizedIndex);
                         }
                     }
@@ -356,7 +356,8 @@ private List<String> replaceWildcardsWithAuthorizedIndices(Iterable<String> indi
                 if (replaceWildcards && Regex.isSimpleMatchPattern(dateMathName)) {
                     // continue
                     aliasOrIndex = dateMathName;
-                } else if (authorizedIndices.contains(dateMathName) && isIndexVisible(dateMathName, indicesOptions, metaData, true)) {
+                } else if (authorizedIndices.contains(dateMathName) &&
+                    isIndexVisible(aliasOrIndex, dateMathName, indicesOptions, metaData, true)) {
                     if (minus) {
                         finalIndices.remove(dateMathName);
                     } else {
@@ -373,7 +374,8 @@ private List<String> replaceWildcardsWithAuthorizedIndices(Iterable<String> indi
                 wildcardSeen = true;
                 Set<String> resolvedIndices = new HashSet<>();
                 for (String authorizedIndex : authorizedIndices) {
-                    if (Regex.simpleMatch(aliasOrIndex, authorizedIndex) && isIndexVisible(authorizedIndex, indicesOptions, metaData)) {
+                    if (Regex.simpleMatch(aliasOrIndex, authorizedIndex) &&
+                        isIndexVisible(aliasOrIndex, authorizedIndex, indicesOptions, metaData)) {
                         resolvedIndices.add(authorizedIndex);
                     }
                 }
@@ -408,11 +410,12 @@ private List<String> replaceWildcardsWithAuthorizedIndices(Iterable<String> indi
         return finalIndices;
     }
 
-    private static boolean isIndexVisible(String index, IndicesOptions indicesOptions, MetaData metaData) {
-        return isIndexVisible(index, indicesOptions, metaData, false);
+    private static boolean isIndexVisible(String expression, String index, IndicesOptions indicesOptions, MetaData metaData) {
+        return isIndexVisible(expression, index, indicesOptions, metaData, false);
     }
 
-    private static boolean isIndexVisible(String index, IndicesOptions indicesOptions, MetaData metaData, boolean dateMathExpression) {
+    private static boolean isIndexVisible(String expression, String index, IndicesOptions indicesOptions, MetaData metaData,
+                                          boolean dateMathExpression) {
         AliasOrIndex aliasOrIndex = metaData.getAliasAndIndexLookup().get(index);
         if (aliasOrIndex.isAlias()) {
             //it's an alias, ignore expandWildcardsOpen and expandWildcardsClosed.
@@ -422,15 +425,29 @@ private static boolean isIndexVisible(String index, IndicesOptions indicesOption
         }
         assert aliasOrIndex.getIndices().size() == 1 : "concrete index must point to a single index";
         IndexMetaData indexMetaData = aliasOrIndex.getIndices().get(0);
-        if (indexMetaData.getState() == IndexMetaData.State.CLOSE && (indicesOptions.expandWildcardsClosed() || dateMathExpression)) {
+        final boolean isHidden = IndexMetaData.INDEX_HIDDEN_SETTING.get(indexMetaData.getSettings());
+        if (isHidden && indicesOptions.expandWildcardsHidden() == false && isVisibleDueToImplicitHidden(expression, index) == false) {
+            return false;
+        }
+
+        // the index is not hidden and since it is a date math expression, we consider it visible regardless of open/closed
+        if (dateMathExpression) {
+            assert State.values().length == 2 : "a new IndexMetaData.State value may need to be handled!";
+            return true;
+        }
+        if (indexMetaData.getState() == IndexMetaData.State.CLOSE && indicesOptions.expandWildcardsClosed()) {
             return true;
         }
-        if (indexMetaData.getState() == IndexMetaData.State.OPEN && (indicesOptions.expandWildcardsOpen() || dateMathExpression)) {
+        if (indexMetaData.getState() == IndexMetaData.State.OPEN && indicesOptions.expandWildcardsOpen()) {
             return true;
         }
         return false;
     }
 
+    private static boolean isVisibleDueToImplicitHidden(String expression, String index) {
+        return index.startsWith(".") && expression.startsWith(".") && Regex.isSimpleMatchPattern(expression);
+    }
+
     private static List<String> indicesList(String[] list) {
         return (list == null) ? null : Arrays.asList(list);
     }
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/IndicesAndAliasesResolverTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/IndicesAndAliasesResolverTests.java
index e79f6bea966b2..3f3334c3646f1 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/IndicesAndAliasesResolverTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/IndicesAndAliasesResolverTests.java
@@ -33,6 +33,7 @@
 import org.elasticsearch.action.termvectors.MultiTermVectorsRequest;
 import org.elasticsearch.cluster.metadata.AliasMetaData;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
+import org.elasticsearch.cluster.metadata.IndexMetaData.State;
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.service.ClusterService;
@@ -123,13 +124,13 @@ public void setup() {
                         .putAlias(AliasMetaData.builder("foounauthorized")).settings(settings))
                 .put(indexBuilder("foobar").putAlias(AliasMetaData.builder("foofoobar"))
                         .putAlias(AliasMetaData.builder("foobarfoo")).settings(settings))
-                .put(indexBuilder("closed").state(IndexMetaData.State.CLOSE)
+                .put(indexBuilder("closed").state(State.CLOSE)
                         .putAlias(AliasMetaData.builder("foofoobar")).settings(settings))
-                .put(indexBuilder("foofoo-closed").state(IndexMetaData.State.CLOSE).settings(settings))
-                .put(indexBuilder("foobar-closed").state(IndexMetaData.State.CLOSE).settings(settings))
+                .put(indexBuilder("foofoo-closed").state(State.CLOSE).settings(settings))
+                .put(indexBuilder("foobar-closed").state(State.CLOSE).settings(settings))
                 .put(indexBuilder("foofoo").putAlias(AliasMetaData.builder("barbaz")).settings(settings))
                 .put(indexBuilder("bar").settings(settings))
-                .put(indexBuilder("bar-closed").state(IndexMetaData.State.CLOSE).settings(settings))
+                .put(indexBuilder("bar-closed").state(State.CLOSE).settings(settings))
                 .put(indexBuilder("bar2").settings(settings))
                 .put(indexBuilder(indexNameExpressionResolver.resolveDateMathExpression("<datetime-{now/M}>")).settings(settings))
                 .put(indexBuilder("-index10").settings(settings))
@@ -139,6 +140,12 @@ public void setup() {
                 .put(indexBuilder("logs-00001").putAlias(AliasMetaData.builder("logs-alias").writeIndex(false)).settings(settings))
                 .put(indexBuilder("logs-00002").putAlias(AliasMetaData.builder("logs-alias").writeIndex(false)).settings(settings))
                 .put(indexBuilder("logs-00003").putAlias(AliasMetaData.builder("logs-alias").writeIndex(true)).settings(settings))
+                .put(indexBuilder("hidden-open").settings(Settings.builder().put(settings).put("index.hidden", true).build()))
+                .put(indexBuilder(".hidden-open").settings(Settings.builder().put(settings).put("index.hidden", true).build()))
+                .put(indexBuilder(".hidden-closed").state(State.CLOSE)
+                    .settings(Settings.builder().put(settings).put("index.hidden", true).build()))
+                .put(indexBuilder("hidden-closed").state(State.CLOSE)
+                    .settings(Settings.builder().put(settings).put("index.hidden", true).build()))
                 .put(indexBuilder(securityIndexName).settings(settings)).build();
 
         if (withAlias) {
@@ -150,7 +157,8 @@ public void setup() {
         userDashIndices = new User("dash", "dash");
         userNoIndices = new User("test", "test");
         rolesStore = mock(CompositeRolesStore.class);
-        String[] authorizedIndices = new String[] { "bar", "bar-closed", "foofoobar", "foobarfoo", "foofoo", "missing", "foofoo-closed"};
+        String[] authorizedIndices = new String[] { "bar", "bar-closed", "foofoobar", "foobarfoo", "foofoo", "missing", "foofoo-closed",
+            "hidden-open", "hidden-closed", ".hidden-open", ".hidden-closed"};
         String[] dashIndices = new String[]{"-index10", "-index11", "-index20", "-index21"};
         roleMap = new HashMap<>();
         roleMap.put("role", new RoleDescriptor("role", null,
@@ -1368,8 +1376,56 @@ public void testWhenAliasToMultipleIndicesAndUserIsAuthorizedUsingAliasReturnsIn
         assertEquals(message, index, putMappingIndexOrAlias);
     }
 
-    // TODO with the removal of DeleteByQuery is there another way to test resolving a write action?
-
+    public void testHiddenIndicesResolution() {
+        SearchRequest searchRequest = new SearchRequest();
+        searchRequest.indicesOptions(IndicesOptions.fromOptions(false, false, true, true, true));
+        List<String> authorizedIndices = buildAuthorizedIndices(user, SearchAction.NAME);
+        ResolvedIndices resolvedIndices = defaultIndicesResolver.resolveIndicesAndAliases(searchRequest, metaData, authorizedIndices);
+        assertThat(resolvedIndices.getLocal(), containsInAnyOrder("bar", "bar-closed", "foofoobar", "foobarfoo", "foofoo", "foofoo-closed",
+            "hidden-open", "hidden-closed", ".hidden-open", ".hidden-closed"));
+        assertThat(resolvedIndices.getRemote(), emptyIterable());
+
+        // open + hidden
+        searchRequest = new SearchRequest();
+        searchRequest.indicesOptions(IndicesOptions.fromOptions(false, false, true, false, true));
+        authorizedIndices = buildAuthorizedIndices(user, SearchAction.NAME);
+        resolvedIndices = defaultIndicesResolver.resolveIndicesAndAliases(searchRequest, metaData, authorizedIndices);
+        assertThat(resolvedIndices.getLocal(),
+            containsInAnyOrder("bar", "foofoobar", "foobarfoo", "foofoo", "hidden-open", ".hidden-open"));
+        assertThat(resolvedIndices.getRemote(), emptyIterable());
+
+        // open + implicit hidden for . indices
+        searchRequest = new SearchRequest(randomFrom(".*", ".hid*"));
+        searchRequest.indicesOptions(IndicesOptions.fromOptions(false, false, true, false, false));
+        authorizedIndices = buildAuthorizedIndices(user, SearchAction.NAME);
+        resolvedIndices = defaultIndicesResolver.resolveIndicesAndAliases(searchRequest, metaData, authorizedIndices);
+        assertThat(resolvedIndices.getLocal(), containsInAnyOrder(".hidden-open"));
+        assertThat(resolvedIndices.getRemote(), emptyIterable());
+
+        // closed + hidden, ignore aliases
+        searchRequest = new SearchRequest();
+        searchRequest.indicesOptions(IndicesOptions.fromOptions(false, false, false, true, true, true, false, true, false));
+        authorizedIndices = buildAuthorizedIndices(user, SearchAction.NAME);
+        resolvedIndices = defaultIndicesResolver.resolveIndicesAndAliases(searchRequest, metaData, authorizedIndices);
+        assertThat(resolvedIndices.getLocal(), containsInAnyOrder("bar-closed", "foofoo-closed", "hidden-closed", ".hidden-closed"));
+        assertThat(resolvedIndices.getRemote(), emptyIterable());
+
+        // closed + implicit hidden for . indices
+        searchRequest = new SearchRequest(randomFrom(".*", ".hid*"));
+        searchRequest.indicesOptions(IndicesOptions.fromOptions(false, false, false, true, false));
+        authorizedIndices = buildAuthorizedIndices(user, SearchAction.NAME);
+        resolvedIndices = defaultIndicesResolver.resolveIndicesAndAliases(searchRequest, metaData, authorizedIndices);
+        assertThat(resolvedIndices.getLocal(), containsInAnyOrder(".hidden-closed"));
+        assertThat(resolvedIndices.getRemote(), emptyIterable());
+
+        // allow no indices, do not expand to open or closed, expand hidden, ignore aliases
+        searchRequest = new SearchRequest();
+        searchRequest.indicesOptions(IndicesOptions.fromOptions(false, true, false, false, false, true, false, true, false));
+        authorizedIndices = buildAuthorizedIndices(user, SearchAction.NAME);
+        resolvedIndices = defaultIndicesResolver.resolveIndicesAndAliases(searchRequest, metaData, authorizedIndices);
+        assertThat(resolvedIndices.getLocal(), contains("-*"));
+        assertThat(resolvedIndices.getRemote(), emptyIterable());
+    }
 
     private List<String> buildAuthorizedIndices(User user, String action) {
         PlainActionFuture<Role> rolesListener = new PlainActionFuture<>();

From 6901ed3da4798bab6a6af8f7d60d5992f1115f11 Mon Sep 17 00:00:00 2001
From: David Roberts <dave.roberts@elastic.co>
Date: Fri, 17 Jan 2020 16:25:06 +0000
Subject: [PATCH 640/686] [ML] Add audit warning for 1000 categories found
 early in job (#51146)

If 1000 different category definitions are created for a job in
the first 100 buckets it processes then an audit warning will now
be created.  (This will cause a yellow warning triangle in the
ML UI's jobs list.)

Such a large number of categories suggests that the field that
categorization is working on is not well suited to the ML
categorization functionality.
---
 .../xpack/core/ml/job/messages/Messages.java  |  2 +
 .../output/AutodetectResultProcessor.java     | 34 ++++++--
 .../AutodetectResultProcessorTests.java       | 87 ++++++++++++++++---
 3 files changed, 104 insertions(+), 19 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
index ef0fcd4fdb172..dbebc580b5730 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/messages/Messages.java
@@ -135,6 +135,8 @@ public final class Messages {
             "Adjust the analysis_limits.model_memory_limit setting to ensure all data is analyzed";
     public static final String JOB_AUDIT_MEMORY_STATUS_HARD_LIMIT_PRE_7_2 = "Job memory status changed to hard_limit at {0}; adjust the " +
         "analysis_limits.model_memory_limit setting to ensure all data is analyzed";
+    public static final String JOB_AUDIT_EXCESSIVE_EARLY_CATEGORIES = "{0} categories observed in the first [{1}] buckets." +
+        " This suggests an inappropriate categorization_field_name has been chosen.";
 
     public static final String JOB_CONFIG_CATEGORIZATION_FILTERS_CONTAINS_DUPLICATES = "categorization_filters contain duplicates";
     public static final String JOB_CONFIG_CATEGORIZATION_FILTERS_CONTAINS_EMPTY =
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessor.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessor.java
index 422f13926d441..51043d4da42bd 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessor.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessor.java
@@ -74,6 +74,9 @@ public class AutodetectResultProcessor {
 
     private static final Logger LOGGER = LogManager.getLogger(AutodetectResultProcessor.class);
 
+    static final long EARLY_BUCKET_THRESHOLD = 100;
+    static final int EXCESSIVE_EARLY_CATEGORY_COUNT = 1000;
+
     private final Client client;
     private final AnomalyDetectionAuditor auditor;
     private final String jobId;
@@ -87,7 +90,9 @@ public class AutodetectResultProcessor {
     private final FlushListener flushListener;
     private volatile boolean processKilled;
     private volatile boolean failed;
-    private int bucketCount; // only used from the process() thread, so doesn't need to be volatile
+    private long priorRunsBucketCount;
+    private long currentRunBucketCount; // only used from the process() thread, so doesn't need to be volatile
+    private boolean excessiveCategoryWarningIssued; // only used from the process() thread, so doesn't need to be volatile
     private final JobResultsPersister.Builder bulkResultsPersister;
     private boolean deleteInterimRequired;
 
@@ -122,6 +127,7 @@ public AutodetectResultProcessor(Client client,
         this.bulkResultsPersister = persister.bulkPersisterBuilder(jobId, this::isAlive);
         this.timingStatsReporter = new TimingStatsReporter(timingStats, bulkResultsPersister);
         this.deleteInterimRequired = true;
+        this.priorRunsBucketCount = timingStats.getBucketCount();
     }
 
     public void process() {
@@ -140,7 +146,7 @@ public void process() {
             } catch (Exception e) {
                 LOGGER.warn(new ParameterizedMessage("[{}] Error persisting autodetect results", jobId), e);
             }
-            LOGGER.info("[{}] {} buckets parsed from autodetect output", jobId, bucketCount);
+            LOGGER.info("[{}] {} buckets parsed from autodetect output", jobId, currentRunBucketCount);
 
         } catch (Exception e) {
             failed = true;
@@ -166,7 +172,7 @@ public void process() {
     }
 
     private void readResults() {
-        bucketCount = 0;
+        currentRunBucketCount = 0;
         try {
             Iterator<AutodetectResult> iterator = process.readAutodetectResults();
             while (iterator.hasNext()) {
@@ -174,7 +180,7 @@ private void readResults() {
                     AutodetectResult result = iterator.next();
                     processResult(result);
                     if (result.getBucket() != null) {
-                        LOGGER.trace("[{}] Bucket number {} parsed from output", jobId, bucketCount);
+                        LOGGER.trace("[{}] Bucket number {} parsed from output", jobId, currentRunBucketCount);
                     }
                 } catch (Exception e) {
                     if (isAlive() == false) {
@@ -212,7 +218,7 @@ void processResult(AutodetectResult result) {
             // results are also interim
             timingStatsReporter.reportBucket(bucket);
             bulkResultsPersister.persistBucket(bucket).executeRequest();
-            ++bucketCount;
+            ++currentRunBucketCount;
         }
         List<AnomalyRecord> records = result.getRecords();
         if (records != null && !records.isEmpty()) {
@@ -224,7 +230,7 @@ void processResult(AutodetectResult result) {
         }
         CategoryDefinition categoryDefinition = result.getCategoryDefinition();
         if (categoryDefinition != null) {
-            persister.persistCategoryDefinition(categoryDefinition, this::isAlive);
+            processCategoryDefinition(categoryDefinition);
         }
         ModelPlot modelPlot = result.getModelPlot();
         if (modelPlot != null) {
@@ -308,6 +314,22 @@ void processResult(AutodetectResult result) {
         }
     }
 
+    private void processCategoryDefinition(CategoryDefinition categoryDefinition) {
+        persister.persistCategoryDefinition(categoryDefinition, this::isAlive);
+        if (categoryDefinition.getCategoryId() == EXCESSIVE_EARLY_CATEGORY_COUNT &&
+            priorRunsBucketCount + currentRunBucketCount < EARLY_BUCKET_THRESHOLD &&
+            excessiveCategoryWarningIssued == false) {
+            auditor.warning(jobId, Messages.getMessage(Messages.JOB_AUDIT_EXCESSIVE_EARLY_CATEGORIES, EXCESSIVE_EARLY_CATEGORY_COUNT,
+                // Add 1 because category definitions are written before buckets
+                1L + priorRunsBucketCount + currentRunBucketCount));
+            // This flag won't be retained if the job is closed and reopened, or if the job migrates to another node.
+            // This means it's possible the audit message is generated multiple times.  However, that's not a
+            // disaster, and is also very unlikely in the the (best practice) cases where initial lookback covers
+            // more than 100 buckets.
+            excessiveCategoryWarningIssued = true;
+        }
+    }
+
     private void processModelSizeStats(ModelSizeStats modelSizeStats) {
         LOGGER.trace("[{}] Parsed ModelSizeStats: {} / {} / {} / {} / {} / {}",
                 jobId, modelSizeStats.getModelBytes(), modelSizeStats.getTotalByFieldCount(),
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessorTests.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessorTests.java
index 2f31015b575c7..d7375ac9a8481 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessorTests.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/job/process/autodetect/output/AutodetectResultProcessorTests.java
@@ -133,7 +133,7 @@ public void testProcess() throws TimeoutException {
         verify(persister).commitStateWrites(JOB_ID);
     }
 
-    public void testProcessResult_bucket() throws Exception {
+    public void testProcessResult_bucket() {
         when(bulkBuilder.persistTimingStats(any(TimingStats.class))).thenReturn(bulkBuilder);
         when(bulkBuilder.persistBucket(any(Bucket.class))).thenReturn(bulkBuilder);
         AutodetectResult result = mock(AutodetectResult.class);
@@ -150,7 +150,7 @@ public void testProcessResult_bucket() throws Exception {
         verify(persister, never()).deleteInterimResults(JOB_ID);
     }
 
-    public void testProcessResult_bucket_deleteInterimRequired() throws Exception {
+    public void testProcessResult_bucket_deleteInterimRequired() {
         when(bulkBuilder.persistTimingStats(any(TimingStats.class))).thenReturn(bulkBuilder);
         when(bulkBuilder.persistBucket(any(Bucket.class))).thenReturn(bulkBuilder);
         AutodetectResult result = mock(AutodetectResult.class);
@@ -167,7 +167,7 @@ public void testProcessResult_bucket_deleteInterimRequired() throws Exception {
         verify(persister).deleteInterimResults(JOB_ID);
     }
 
-    public void testProcessResult_records() throws Exception {
+    public void testProcessResult_records() {
         AutodetectResult result = mock(AutodetectResult.class);
         List<AnomalyRecord> records =
             Arrays.asList(
@@ -183,7 +183,7 @@ public void testProcessResult_records() throws Exception {
         verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
     }
 
-    public void testProcessResult_influencers() throws Exception {
+    public void testProcessResult_influencers() {
         AutodetectResult result = mock(AutodetectResult.class);
         List<Influencer> influencers =
             Arrays.asList(
@@ -199,9 +199,10 @@ public void testProcessResult_influencers() throws Exception {
         verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
     }
 
-    public void testProcessResult_categoryDefinition() throws Exception {
+    public void testProcessResult_categoryDefinition() {
         AutodetectResult result = mock(AutodetectResult.class);
         CategoryDefinition categoryDefinition = mock(CategoryDefinition.class);
+        when(categoryDefinition.getCategoryId()).thenReturn(1L);
         when(result.getCategoryDefinition()).thenReturn(categoryDefinition);
 
         processorUnderTest.setDeleteInterimRequired(false);
@@ -212,7 +213,66 @@ public void testProcessResult_categoryDefinition() throws Exception {
         verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
     }
 
-    public void testProcessResult_flushAcknowledgement() throws Exception {
+    public void testProcessResult_excessiveCategoryDefinitionCountEarly() {
+        int iterations = 3;
+        int categoryCount = AutodetectResultProcessor.EXCESSIVE_EARLY_CATEGORY_COUNT * 2;
+
+        processorUnderTest.setDeleteInterimRequired(false);
+
+        AutodetectResult result = mock(AutodetectResult.class);
+        for (int iteration = 1; iteration <= iterations; ++iteration) {
+            for (int categoryId = 1; categoryId <= categoryCount; ++categoryId) {
+                CategoryDefinition categoryDefinition = new CategoryDefinition(JOB_ID);
+                categoryDefinition.setCategoryId(categoryId);
+                when(result.getCategoryDefinition()).thenReturn(categoryDefinition);
+
+                processorUnderTest.processResult(result);
+            }
+        }
+
+        verify(bulkBuilder, never()).executeRequest();
+        verify(persister, times(iterations * categoryCount)).persistCategoryDefinition(any(CategoryDefinition.class), any());
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        verify(auditor).warning(eq(JOB_ID), eq(Messages.getMessage(Messages.JOB_AUDIT_EXCESSIVE_EARLY_CATEGORIES,
+            AutodetectResultProcessor.EXCESSIVE_EARLY_CATEGORY_COUNT, 1)));
+    }
+
+    public void testProcessResult_highCategoryDefinitionCountLateOn() {
+        int iterations = 3;
+        int categoryCount = AutodetectResultProcessor.EXCESSIVE_EARLY_CATEGORY_COUNT * 2;
+
+        processorUnderTest.setDeleteInterimRequired(false);
+
+        when(bulkBuilder.persistTimingStats(any(TimingStats.class))).thenReturn(bulkBuilder);
+        when(bulkBuilder.persistBucket(any(Bucket.class))).thenReturn(bulkBuilder);
+
+        AutodetectResult bucketResult = mock(AutodetectResult.class);
+        final int numPriorBuckets = (int) AutodetectResultProcessor.EARLY_BUCKET_THRESHOLD + 1;
+        for (int i = 0; i < numPriorBuckets; ++i) {
+            Bucket bucket = new Bucket(JOB_ID, new Date(i * 1000 + 1000000), BUCKET_SPAN_MS);
+            when(bucketResult.getBucket()).thenReturn(bucket);
+            processorUnderTest.processResult(bucketResult);
+        }
+
+        AutodetectResult categoryResult = mock(AutodetectResult.class);
+        for (int iteration = 1; iteration <= iterations; ++iteration) {
+            for (int categoryId = 1; categoryId <= categoryCount; ++categoryId) {
+                CategoryDefinition categoryDefinition = new CategoryDefinition(JOB_ID);
+                categoryDefinition.setCategoryId(categoryId);
+                when(categoryResult.getCategoryDefinition()).thenReturn(categoryDefinition);
+                processorUnderTest.processResult(categoryResult);
+            }
+        }
+
+        verify(bulkBuilder).persistTimingStats(any(TimingStats.class));
+        verify(bulkBuilder, times(numPriorBuckets)).persistBucket(any(Bucket.class));
+        verify(bulkBuilder, times(numPriorBuckets)).executeRequest();
+        verify(persister, times(iterations * categoryCount)).persistCategoryDefinition(any(CategoryDefinition.class), any());
+        verify(persister).bulkPersisterBuilder(eq(JOB_ID), any());
+        verify(auditor, never()).warning(eq(JOB_ID), anyString());
+    }
+
+    public void testProcessResult_flushAcknowledgement() {
         AutodetectResult result = mock(AutodetectResult.class);
         FlushAcknowledgement flushAcknowledgement = mock(FlushAcknowledgement.class);
         when(flushAcknowledgement.getId()).thenReturn(JOB_ID);
@@ -228,12 +288,13 @@ public void testProcessResult_flushAcknowledgement() throws Exception {
         verify(bulkBuilder).executeRequest();
     }
 
-    public void testProcessResult_flushAcknowledgementMustBeProcessedLast() throws Exception {
+    public void testProcessResult_flushAcknowledgementMustBeProcessedLast() {
         AutodetectResult result = mock(AutodetectResult.class);
         FlushAcknowledgement flushAcknowledgement = mock(FlushAcknowledgement.class);
         when(flushAcknowledgement.getId()).thenReturn(JOB_ID);
         when(result.getFlushAcknowledgement()).thenReturn(flushAcknowledgement);
         CategoryDefinition categoryDefinition = mock(CategoryDefinition.class);
+        when(categoryDefinition.getCategoryId()).thenReturn(1L);
         when(result.getCategoryDefinition()).thenReturn(categoryDefinition);
 
         processorUnderTest.setDeleteInterimRequired(false);
@@ -248,7 +309,7 @@ public void testProcessResult_flushAcknowledgementMustBeProcessedLast() throws E
         inOrder.verify(flushListener).acknowledgeFlush(flushAcknowledgement, null);
     }
 
-    public void testProcessResult_modelPlot() throws Exception {
+    public void testProcessResult_modelPlot() {
         AutodetectResult result = mock(AutodetectResult.class);
         ModelPlot modelPlot = mock(ModelPlot.class);
         when(result.getModelPlot()).thenReturn(modelPlot);
@@ -260,7 +321,7 @@ public void testProcessResult_modelPlot() throws Exception {
         verify(bulkBuilder).persistModelPlot(modelPlot);
     }
 
-    public void testProcessResult_modelSizeStats() throws Exception {
+    public void testProcessResult_modelSizeStats() {
         AutodetectResult result = mock(AutodetectResult.class);
         ModelSizeStats modelSizeStats = mock(ModelSizeStats.class);
         when(result.getModelSizeStats()).thenReturn(modelSizeStats);
@@ -273,7 +334,7 @@ public void testProcessResult_modelSizeStats() throws Exception {
         verify(persister).persistModelSizeStats(eq(modelSizeStats), any());
     }
 
-    public void testProcessResult_modelSizeStatsWithMemoryStatusChanges() throws Exception {
+    public void testProcessResult_modelSizeStatsWithMemoryStatusChanges() {
         TimeValue delay = TimeValue.timeValueSeconds(5);
         // Set up schedule delay time
         when(threadPool.schedule(any(Runnable.class), any(TimeValue.class), anyString()))
@@ -313,7 +374,7 @@ public void testProcessResult_modelSizeStatsWithMemoryStatusChanges() throws Exc
         verify(auditor).error(JOB_ID, Messages.getMessage(Messages.JOB_AUDIT_MEMORY_STATUS_HARD_LIMIT, "512mb", "1kb"));
     }
 
-    public void testProcessResult_modelSnapshot() throws Exception {
+    public void testProcessResult_modelSnapshot() {
         AutodetectResult result = mock(AutodetectResult.class);
         ModelSnapshot modelSnapshot = new ModelSnapshot.Builder(JOB_ID)
             .setSnapshotId("a_snapshot_id")
@@ -337,7 +398,7 @@ public void testProcessResult_modelSnapshot() throws Exception {
         verify(client).execute(same(UpdateJobAction.INSTANCE), eq(expectedJobUpdateRequest), any());
     }
 
-    public void testProcessResult_quantiles_givenRenormalizationIsEnabled() throws Exception {
+    public void testProcessResult_quantiles_givenRenormalizationIsEnabled() {
         AutodetectResult result = mock(AutodetectResult.class);
         Quantiles quantiles = mock(Quantiles.class);
         when(result.getQuantiles()).thenReturn(quantiles);
@@ -354,7 +415,7 @@ public void testProcessResult_quantiles_givenRenormalizationIsEnabled() throws E
         verify(renormalizer).renormalize(quantiles);
     }
 
-    public void testProcessResult_quantiles_givenRenormalizationIsDisabled() throws Exception {
+    public void testProcessResult_quantiles_givenRenormalizationIsDisabled() {
         AutodetectResult result = mock(AutodetectResult.class);
         Quantiles quantiles = mock(Quantiles.class);
         when(result.getQuantiles()).thenReturn(quantiles);

From 798b63bf1a5f79851d10a43eff8211c6461bd0a6 Mon Sep 17 00:00:00 2001
From: Jay Modi <jaymode@users.noreply.github.com>
Date: Fri, 17 Jan 2020 09:59:23 -0700
Subject: [PATCH 641/686] Improve file filter for insecure repo tests (#51121)

Tests in BuildPluginIT copy the workspace but exclude the build
directories based on whether the directory string representation
includes `/build/` or not. This check is problematic if the directory
of the project has a parent directory also named `build`. The change in
this commit checks to see if the path relative to the project directory
has any path parts equal to `build`.
---
 .../java/org/elasticsearch/gradle/BuildPluginIT.java | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginIT.java b/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginIT.java
index c69a23021f535..57864326629ed 100644
--- a/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginIT.java
+++ b/buildSrc/src/test/java/org/elasticsearch/gradle/BuildPluginIT.java
@@ -31,6 +31,7 @@
 import java.io.InputStream;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
+import java.nio.file.Path;
 import java.util.Arrays;
 import java.util.List;
 import java.util.zip.ZipEntry;
@@ -84,7 +85,16 @@ public void testInsecureIvyRepository() throws IOException {
 
     private void runInsecureArtifactRepositoryTest(final String name, final String url, final List<String> lines) throws IOException {
         final File projectDir = getProjectDir("elasticsearch.build");
-        FileUtils.copyDirectory(projectDir, tmpDir.getRoot(), pathname -> pathname.getPath().contains("/build/") == false);
+        final Path projectDirPath = projectDir.toPath();
+        FileUtils.copyDirectory(projectDir, tmpDir.getRoot(), file -> {
+            final Path relativePath = projectDirPath.relativize(file.toPath());
+            for (Path segment : relativePath) {
+                if (segment.toString().equals("build")) {
+                    return false;
+                }
+            }
+            return true;
+        });
         final List<String> buildGradleLines = Files.readAllLines(tmpDir.getRoot().toPath().resolve("build.gradle"), StandardCharsets.UTF_8);
         buildGradleLines.addAll(lines);
         Files.write(tmpDir.getRoot().toPath().resolve("build.gradle"), buildGradleLines, StandardCharsets.UTF_8);

From d03e9f662fa77c83ec5bfd8a3c5aa5a89e5d5bb3 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Fri, 17 Jan 2020 09:21:20 -0800
Subject: [PATCH 642/686] [DOCS] Remove out-dated monitoring note (#51129)

---
 docs/reference/monitoring/collecting-monitoring-data.asciidoc | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/docs/reference/monitoring/collecting-monitoring-data.asciidoc b/docs/reference/monitoring/collecting-monitoring-data.asciidoc
index 612911a3ca17d..fc1d33cebc520 100644
--- a/docs/reference/monitoring/collecting-monitoring-data.asciidoc
+++ b/docs/reference/monitoring/collecting-monitoring-data.asciidoc
@@ -10,10 +10,6 @@ data collection is disabled.
 This method involves sending the metrics to the monitoring cluster by using 
 exporters. For an alternative method, see <<configuring-metricbeat>>.
 
-NOTE: If you want to collect monitoring data from sources such as Beats and {ls}
-and route it to a monitoring cluster, you must follow this method. You cannot
-use {metricbeat} to ship the monitoring data for those products yet.
-
 Advanced monitoring settings enable you to control how frequently data is 
 collected, configure timeouts, and set the retention period for locally-stored 
 monitoring indices. You can also adjust how monitoring data is displayed. 

From 3a1fe8251af1d48543d1363c334182bca4880e55 Mon Sep 17 00:00:00 2001
From: cachedout <mike.place@elastic.co>
Date: Mon, 2 Dec 2019 21:31:47 +0000
Subject: [PATCH 643/686] [DOCS] Recommend Metricbeat for 7.x (#49758)

---
 .../collecting-monitoring-data.asciidoc       | 140 ++++++++++--------
 docs/reference/monitoring/collectors.asciidoc |  40 +++--
 docs/reference/monitoring/exporters.asciidoc  |  77 ++++++----
 .../monitoring/how-monitoring-works.asciidoc  |  14 +-
 .../reference/monitoring/http-export.asciidoc |  67 +++++----
 docs/reference/monitoring/index.asciidoc      |   4 +-
 .../monitoring/local-export.asciidoc          |  66 +++++----
 docs/reference/monitoring/production.asciidoc |  78 +++++-----
 8 files changed, 277 insertions(+), 209 deletions(-)

diff --git a/docs/reference/monitoring/collecting-monitoring-data.asciidoc b/docs/reference/monitoring/collecting-monitoring-data.asciidoc
index fc1d33cebc520..b08cd776ef2c8 100644
--- a/docs/reference/monitoring/collecting-monitoring-data.asciidoc
+++ b/docs/reference/monitoring/collecting-monitoring-data.asciidoc
@@ -3,44 +3,56 @@
 [[collecting-monitoring-data]]
 == Collecting monitoring data
 
-If you enable the Elastic {monitor-features} in your cluster, you can 
-optionally collect metrics about {es}. By default, monitoring is enabled but 
-data collection is disabled. 
+[IMPORTANT]
+=========================
+{metricbeat} is the recommended method for collecting and shipping monitoring
+data to a monitoring cluster.
 
-This method involves sending the metrics to the monitoring cluster by using 
-exporters. For an alternative method, see <<configuring-metricbeat>>.
+If you have previously configured internal collection, you should migrate to
+using {metricbeat} collection. Use either {metricbeat} collection or
+internal collection; do not use both.
 
-Advanced monitoring settings enable you to control how frequently data is 
-collected, configure timeouts, and set the retention period for locally-stored 
-monitoring indices. You can also adjust how monitoring data is displayed. 
+Learn more about <<configuring-metricbeat>>.
+=========================
 
-To learn about monitoring in general, see <<monitor-elasticsearch-cluster>>. 
+If you enable the Elastic {monitor-features} in your cluster, you can
+optionally collect metrics about {es}. By default, monitoring is enabled but
+data collection is disabled.
+
+This method involves sending the metrics to the monitoring cluster by using
+exporters. For the recommended method, see <<configuring-metricbeat>>.
+
+Advanced monitoring settings enable you to control how frequently data is
+collected, configure timeouts, and set the retention period for locally-stored
+monitoring indices. You can also adjust how monitoring data is displayed.
+
+To learn about monitoring in general, see <<monitor-elasticsearch-cluster>>.
 
 . Configure your cluster to collect monitoring data:
 
-.. Verify that the `xpack.monitoring.enabled` setting is `true`, which is its 
-default value, on each node in the cluster. For more information, see 
-<<monitoring-settings>>. 
+.. Verify that the `xpack.monitoring.enabled` setting is `true`, which is its
+default value, on each node in the cluster. For more information, see
+<<monitoring-settings>>.
 
-.. Verify that the `xpack.monitoring.elasticsearch.collection.enabled` setting 
-is `true`, which is its default value, on each node in the cluster. 
+.. Verify that the `xpack.monitoring.elasticsearch.collection.enabled` setting
+is `true`, which is its default value, on each node in the cluster.
 +
 --
-NOTE: You can specify this setting in either the `elasticsearch.yml` on each 
-node or across the cluster as a dynamic cluster setting. If {es} 
-{security-features} are enabled, you must have `monitor` cluster privileges to 
+NOTE: You can specify this setting in either the `elasticsearch.yml` on each
+node or across the cluster as a dynamic cluster setting. If {es}
+{security-features} are enabled, you must have `monitor` cluster privileges to
 view the cluster settings and `manage` cluster privileges to change them.
 
 For more information, see <<monitoring-settings>> and <<cluster-update-settings>>.
 --
 
 .. Set the `xpack.monitoring.collection.enabled` setting to `true` on each
-node in the cluster. By default, it is is disabled (`false`). 
-+ 
+node in the cluster. By default, it is is disabled (`false`).
++
 --
-NOTE: You can specify this setting in either the `elasticsearch.yml` on each 
-node or across the cluster as a dynamic cluster setting. If {es} 
-{security-features} are enabled, you must have `monitor` cluster privileges to 
+NOTE: You can specify this setting in either the `elasticsearch.yml` on each
+node or across the cluster as a dynamic cluster setting. If {es}
+{security-features} are enabled, you must have `monitor` cluster privileges to
 view the cluster settings and `manage` cluster privileges to change them.
 
 For example, use the following APIs to review and change this setting:
@@ -57,21 +69,21 @@ PUT _cluster/settings
 }
 ----------------------------------
 
-Alternatively, you can enable this setting in {kib}. In the side navigation, 
-click *Monitoring*. If data collection is disabled, you are prompted to turn it 
-on. 
+Alternatively, you can enable this setting in {kib}. In the side navigation,
+click *Monitoring*. If data collection is disabled, you are prompted to turn it
+on.
 
-For more 
+For more
 information, see <<monitoring-settings>> and <<cluster-update-settings>>.
 --
 
-.. Optional: Specify which indices you want to monitor. 
+.. Optional: Specify which indices you want to monitor.
 +
 --
 By default, the monitoring agent collects data from all {es} indices.
 To collect data from particular indices, configure the
-`xpack.monitoring.collection.indices` setting. You can specify multiple indices 
-as a comma-separated list or use an index pattern to match multiple indices. For 
+`xpack.monitoring.collection.indices` setting. You can specify multiple indices
+as a comma-separated list or use an index pattern to match multiple indices. For
 example:
 
 [source,yaml]
@@ -80,36 +92,36 @@ xpack.monitoring.collection.indices: logstash-*, index1, test2
 ----------------------------------
 
 You can prepend `-` to explicitly exclude index names or
-patterns. For example, to include all indices that start with `test` except 
+patterns. For example, to include all indices that start with `test` except
 `test3`, you could specify `test*,-test3`. To include system indices such as
 .security and .kibana, add `.*` to the list of included names.
 For example `.*,test*,-test3`
 --
 
-.. Optional: Specify how often to collect monitoring data. The default value for 
-the `xpack.monitoring.collection.interval` setting 10 seconds. See 
+.. Optional: Specify how often to collect monitoring data. The default value for
+the `xpack.monitoring.collection.interval` setting 10 seconds. See
 <<monitoring-settings>>.
 
-. Identify where to store monitoring data. 
+. Identify where to store monitoring data.
 +
 --
-By default, the data is stored on the same cluster by using a 
-<<local-exporter,`local` exporter>>. Alternatively, you can use an <<http-exporter,`http` exporter>> to send data to 
-a separate _monitoring cluster_. 
+By default, the data is stored on the same cluster by using a
+<<local-exporter,`local` exporter>>. Alternatively, you can use an <<http-exporter,`http` exporter>> to send data to
+a separate _monitoring cluster_.
 
 IMPORTANT: The {es} {monitor-features} use ingest pipelines, therefore the
-cluster that stores the monitoring data must have at least one 
-<<ingest,ingest node>>. 
+cluster that stores the monitoring data must have at least one
+<<ingest,ingest node>>.
 
-For more information about typical monitoring architectures, 
+For more information about typical monitoring architectures,
 see <<how-monitoring-works>>.
 --
 
-. If you choose to use an `http` exporter: 
+. If you choose to use an `http` exporter:
 
-.. On the cluster that you want to monitor (often called the _production cluster_), 
-configure each node to send metrics to your monitoring cluster. Configure an 
-HTTP exporter in the `xpack.monitoring.exporters` settings in the 
+.. On the cluster that you want to monitor (often called the _production cluster_),
+configure each node to send metrics to your monitoring cluster. Configure an
+HTTP exporter in the `xpack.monitoring.exporters` settings in the
 `elasticsearch.yml` file. For example:
 +
 --
@@ -118,19 +130,19 @@ HTTP exporter in the `xpack.monitoring.exporters` settings in the
 xpack.monitoring.exporters:
   id1:
     type: http
-    host: ["http://es-mon-1:9200", "http://es-mon2:9200"] 
+    host: ["http://es-mon-1:9200", "http://es-mon2:9200"]
 --------------------------------------------------
 --
 
-.. If the Elastic {security-features} are enabled on the monitoring cluster, you 
+.. If the Elastic {security-features} are enabled on the monitoring cluster, you
 must provide appropriate credentials when data is shipped to the monitoring cluster:
 
-... Create a user on the monitoring cluster that has the 
-<<built-in-roles,`remote_monitoring_agent` built-in role>>. 
-Alternatively, use the 
+... Create a user on the monitoring cluster that has the
+<<built-in-roles,`remote_monitoring_agent` built-in role>>.
+Alternatively, use the
 <<built-in-users,`remote_monitoring_user` built-in user>>.
 
-... Add the user ID and password settings to the HTTP exporter settings in the 
+... Add the user ID and password settings to the HTTP exporter settings in the
 `elasticsearch.yml` file on each node. +
 +
 --
@@ -141,19 +153,19 @@ For example:
 xpack.monitoring.exporters:
   id1:
     type: http
-    host: ["http://es-mon-1:9200", "http://es-mon2:9200"] 
-    auth.username: remote_monitoring_user 
+    host: ["http://es-mon-1:9200", "http://es-mon2:9200"]
+    auth.username: remote_monitoring_user
     auth.password: YOUR_PASSWORD
 --------------------------------------------------
 --
 
-.. If you configured the monitoring cluster to use 
-<<configuring-tls,encrypted communications>>, you must use the HTTPS protocol in 
-the `host` setting. You must also specify the trusted CA certificates that will 
-be used to verify the identity of the nodes in the monitoring cluster. 
+.. If you configured the monitoring cluster to use
+<<configuring-tls,encrypted communications>>, you must use the HTTPS protocol in
+the `host` setting. You must also specify the trusted CA certificates that will
+be used to verify the identity of the nodes in the monitoring cluster.
 
-*** To add a CA certificate to an {es} node's trusted certificates, you can 
-specify the location of the PEM encoded certificate with the 
+*** To add a CA certificate to an {es} node's trusted certificates, you can
+specify the location of the PEM encoded certificate with the
 `certificate_authorities` setting. For example:
 +
 --
@@ -162,7 +174,7 @@ specify the location of the PEM encoded certificate with the
 xpack.monitoring.exporters:
   id1:
     type: http
-    host: ["https://es-mon1:9200", "https://es-mon2:9200"] 
+    host: ["https://es-mon1:9200", "https://es-mon2:9200"]
     auth:
       username: remote_monitoring_user
       password: YOUR_PASSWORD
@@ -190,12 +202,12 @@ xpack.monitoring.exporters:
 --------------------------------------------------
 --
 
-. Configure your cluster to route monitoring data from sources such as {kib}, 
+. Configure your cluster to route monitoring data from sources such as {kib},
 Beats, and {ls} to the monitoring cluster. For information about configuring
 each product to collect and send monitoring data, see <<monitor-elasticsearch-cluster>>.
 
-. If you updated settings in the `elasticsearch.yml` files on your production 
-cluster, restart {es}. See <<stopping-elasticsearch>> and <<starting-elasticsearch>>. 
+. If you updated settings in the `elasticsearch.yml` files on your production
+cluster, restart {es}. See <<stopping-elasticsearch>> and <<starting-elasticsearch>>.
 +
 --
 TIP: You may want to temporarily {ref}/modules-cluster.html[disable shard
@@ -204,7 +216,7 @@ reallocation during the install process.
 
 --
 
-. Optional: 
-<<config-monitoring-indices,Configure the indices that store the monitoring data>>. 
+. Optional:
+<<config-monitoring-indices,Configure the indices that store the monitoring data>>.
 
-. {kibana-ref}/monitoring-data.html[View the monitoring data in {kib}]. 
+. {kibana-ref}/monitoring-data.html[View the monitoring data in {kib}].
diff --git a/docs/reference/monitoring/collectors.asciidoc b/docs/reference/monitoring/collectors.asciidoc
index 2a091e1c23c8d..2dde0a5ba36ca 100644
--- a/docs/reference/monitoring/collectors.asciidoc
+++ b/docs/reference/monitoring/collectors.asciidoc
@@ -3,6 +3,18 @@
 [[es-monitoring-collectors]]
 == Collectors
 
+[IMPORTANT]
+=========================
+{metricbeat} is the recommended method for collecting and shipping monitoring
+data to a monitoring cluster.
+
+If you have previously configured internal collection, you should migrate to
+using {metricbeat} collection. Use either {metricbeat} collection or
+internal collection; do not use both.
+
+Learn more about <<configuring-metricbeat>>.
+=========================
+
 Collectors, as their name implies, collect things. Each collector runs once for
 each collection interval to obtain data from the public APIs in {es} and {xpack}
 that it chooses to monitor. When the data collection is finished, the data is
@@ -12,9 +24,9 @@ runs once per collection interval.
 
 There is only one collector per data type gathered. In other words, for any
 monitoring document that is created, it comes from a single collector rather
-than being merged from multiple collectors. {monitoring} for {es} currently has
-a few collectors because the goal is to minimize overlap between them for
-optimal performance.
+than being merged from multiple collectors. The {es} {monitor-features}
+currently have a few collectors because the goal is to minimize overlap between
+them for optimal performance.
 
 Each collector can create zero or more monitoring documents. For example,
 the `index_stats` collector collects all index statistics at the same time to
@@ -70,7 +82,7 @@ node to be able to perform the collection, the master node must have
 | Node Stats      | `node_stats`
 | Gathers details about the running node, such as memory utilization and CPU
 usage (for example, `GET /_nodes/_local/stats`). This runs on _every_ node with
-{monitoring} enabled. One common failure results in the timeout of the node
+{monitor-features} enabled. One common failure results in the timeout of the node
 stats request due to too many segment files. As a result, the collector spends
 too much time waiting for the file system stats to be calculated until it
 finally times out. A single `node_stats` document is created per collection.
@@ -79,19 +91,19 @@ with each other, but not with the monitoring cluster (for example, intermittent
 network issues or memory pressure).
 |=======================
 
-{monitoring} uses a single threaded scheduler to run the collection of {es} 
-monitoring data by all of the appropriate collectors on each node. This 
-scheduler is managed locally by each node and its interval is controlled by 
-specifying the `xpack.monitoring.collection.interval`, which defaults to 10 
-seconds (`10s`), at either the node or cluster level.
+The {es} {monitor-features} use a single threaded scheduler to run the
+collection of {es} monitoring data by all of the appropriate collectors on each
+node. This scheduler is managed locally by each node and its interval is
+controlled by specifying the `xpack.monitoring.collection.interval`, which
+defaults to 10 seconds (`10s`), at either the node or cluster level.
 
 Fundamentally, each collector works on the same principle. Per collection
-interval, each collector is checked to see whether it should run and then the 
-appropriate collectors run. The failure of an individual collector does not 
+interval, each collector is checked to see whether it should run and then the
+appropriate collectors run. The failure of an individual collector does not
 impact any other collector.
 
 Once collection has completed, all of the monitoring data is passed to the
-exporters to route the monitoring data to the monitoring clusters. 
+exporters to route the monitoring data to the monitoring clusters.
 
 If gaps exist in the monitoring charts in {kib}, it is typically because either
 a collector failed or the monitoring cluster did not receive the data (for
@@ -112,7 +124,7 @@ For more information about the configuration options for the collectors, see
 [[es-monitoring-stack]]
 ==== Collecting data from across the Elastic Stack
 
-{monitoring} in {es} also receives monitoring data from other parts of the
+{es} {monitor-features} also receive monitoring data from other parts of the
 Elastic Stack. In this way, it serves as an unscheduled monitoring data
 collector for the stack.
 
@@ -125,7 +137,7 @@ Once data is received, it is forwarded to the exporters
 to be routed to the monitoring cluster like all monitoring data.
 
 WARNING: Because this stack-level "collector" lives outside of the collection
-interval of {monitoring} for {es}, it is not impacted by the
+interval of {es} {monitor-features}, it is not impacted by the
 `xpack.monitoring.collection.interval` setting. Therefore, data is passed to the
 exporters whenever it is received. This behavior can result in indices for {kib},
 Logstash, or Beats being created somewhat unexpectedly.
diff --git a/docs/reference/monitoring/exporters.asciidoc b/docs/reference/monitoring/exporters.asciidoc
index 742b24608f250..e1a27641b6e75 100644
--- a/docs/reference/monitoring/exporters.asciidoc
+++ b/docs/reference/monitoring/exporters.asciidoc
@@ -3,6 +3,18 @@
 [[es-monitoring-exporters]]
 == Exporters
 
+[IMPORTANT]
+=========================
+{metricbeat} is the recommended method for collecting and shipping monitoring
+data to a monitoring cluster.
+
+If you have previously configured internal collection, you should migrate to
+using {metricbeat} collection. Use either {metricbeat} collection or
+internal collection; do not use both.
+
+Learn more about <<configuring-metricbeat>>.
+=========================
+
 The purpose of exporters is to take data collected from any Elastic Stack
 source and route it to the monitoring cluster. It is possible to configure
 more than one exporter, but the general and default setup is to use a single
@@ -11,13 +23,13 @@ exporter.
 There are two types of exporters in {es}:
 
 `local`::
-The default exporter used by {monitoring} for {es}. This exporter routes data
-back into the _same_ cluster. See <<local-exporter>>. 
+The default exporter used by {es} {monitor-features}. This exporter routes data
+back into the _same_ cluster. See <<local-exporter>>.
 
 `http`::
 The preferred exporter, which you can use to route data into any supported
 {es} cluster accessible via HTTP. Production environments should always use a
-separate monitoring cluster. See <<http-exporter>>. 
+separate monitoring cluster. See <<http-exporter>>.
 
 Both exporters serve the same purpose: to set up the monitoring cluster and route
 monitoring data. However, they perform these tasks in very different ways. Even
@@ -34,43 +46,43 @@ IMPORTANT: It is critical that all nodes share the same setup. Otherwise,
 monitoring data might be routed in different ways or to different places.
 
 When the exporters route monitoring data into the monitoring cluster, they use
-`_bulk` indexing for optimal performance. All monitoring data is forwarded in 
-bulk to all enabled exporters on the same node. From there, the exporters 
+`_bulk` indexing for optimal performance. All monitoring data is forwarded in
+bulk to all enabled exporters on the same node. From there, the exporters
 serialize the monitoring data and send a bulk request to the monitoring cluster.
-There is no queuing--in memory or persisted to disk--so any failure during the 
-export results in the loss of that batch of monitoring data. This design limits 
+There is no queuing--in memory or persisted to disk--so any failure during the
+export results in the loss of that batch of monitoring data. This design limits
 the impact on {es} and the assumption is that the next pass will succeed.
 
-Routing monitoring data involves indexing it into the appropriate monitoring 
-indices. Once the data is indexed, it exists in a monitoring index that, by 
-default, is named with a daily index pattern. For {es} monitoring data, this is 
-an index that matches `.monitoring-es-6-*`. From there, the data lives inside 
-the monitoring cluster and must be curated or cleaned up as necessary. If you do 
-not curate the monitoring data, it eventually fills up the nodes and the cluster 
-might fail due to lack of disk space. 
+Routing monitoring data involves indexing it into the appropriate monitoring
+indices. Once the data is indexed, it exists in a monitoring index that, by
+default, is named with a daily index pattern. For {es} monitoring data, this is
+an index that matches `.monitoring-es-6-*`. From there, the data lives inside
+the monitoring cluster and must be curated or cleaned up as necessary. If you do
+not curate the monitoring data, it eventually fills up the nodes and the cluster
+might fail due to lack of disk space.
 
-TIP: You are strongly recommended to manage the curation of indices and 
+TIP: You are strongly recommended to manage the curation of indices and
 particularly the monitoring indices. To do so, you can take advantage of the
-<<local-exporter-cleaner,cleaner service>> or 
+<<local-exporter-cleaner,cleaner service>> or
 {curator-ref-current}/index.html[Elastic Curator].
 
 //TO-DO: Add information about index lifecycle management https://github.com/elastic/x-pack-elasticsearch/issues/2814
 
-There is also a disk watermark (known as the flood stage 
-watermark), which protects clusters from running out of disk space. When this 
-feature is triggered, it makes all indices (including monitoring indices) 
-read-only until the issue is fixed and a user manually makes the index writeable 
-again. While an active monitoring index is read-only, it will naturally fail to 
-write (index) new data and will continuously log errors that indicate the write 
-failure. For more information, see 
+There is also a disk watermark (known as the flood stage
+watermark), which protects clusters from running out of disk space. When this
+feature is triggered, it makes all indices (including monitoring indices)
+read-only until the issue is fixed and a user manually makes the index writeable
+again. While an active monitoring index is read-only, it will naturally fail to
+write (index) new data and will continuously log errors that indicate the write
+failure. For more information, see
 {ref}/disk-allocator.html[Disk-based Shard Allocation].
 
 [float]
 [[es-monitoring-default-exporter]]
 === Default exporters
 
-If a node or cluster does not explicitly define an {monitoring} exporter, the
-following default exporter is used:
+If a node or cluster does not explicitly define an exporter, the following
+default exporter is used:
 
 [source,yaml]
 ---------------------------------------------------
@@ -117,7 +129,7 @@ information, see <<http-exporter-settings>>.
 WARNING: Some users create their own templates that match _all_ index patterns,
 which therefore impact the monitoring indices that get created. It is critical
 that you do not disable `_source` storage for the monitoring indices. If you do,
-{monitoring} for {kib} does not work and you cannot visualize monitoring data
+{kib} {monitor-features} do not work and you cannot visualize monitoring data
 for your cluster.
 
 The following table lists the ingest pipelines that are required before an
@@ -127,7 +139,7 @@ exporter can route monitoring data:
 |=======================
 | Pipeline               | Purpose
 | `xpack_monitoring_2`   | Upgrades X-Pack monitoring data coming from X-Pack
-5.0 - 5.4 to be compatible with the format used in {monitoring} 5.5.
+5.0 - 5.4 to be compatible with the format used in 5.5 {monitor-features}.
 | `xpack_monitoring_6`   | A placeholder pipeline that is empty.
 |=======================
 
@@ -153,8 +165,9 @@ whether this update has occurred is by checking for the presence of indices
 matching `.monitoring-es-6-*` (or more concretely the existence of the
 new pipeline). Versions prior to 5.5 used `.monitoring-es-2-*`.
 
-Each resource that is created by an {monitoring} exporter has a `version` field, 
-which is used to determine whether the resource should be replaced. The `version` 
-field value represents the latest version of {monitoring} that changed the 
-resource. If a resource is edited by someone or something external to 
-{monitoring}, those changes are lost the next time an automatic update occurs. 
+Each resource that is created by an exporter has a `version` field,
+which is used to determine whether the resource should be replaced. The `version`
+field value represents the latest version of {monitor-features} that changed the
+resource. If a resource is edited by someone or something external to the
+{monitor-features}, those changes are lost the next time an automatic update
+occurs.
diff --git a/docs/reference/monitoring/how-monitoring-works.asciidoc b/docs/reference/monitoring/how-monitoring-works.asciidoc
index 283ed0412be35..dc1c54ce9b865 100644
--- a/docs/reference/monitoring/how-monitoring-works.asciidoc
+++ b/docs/reference/monitoring/how-monitoring-works.asciidoc
@@ -10,18 +10,12 @@ Each {es} node, {ls} node, {kib} instance, and Beat is considered unique in the
 cluster based on its persistent UUID, which is written to the
 <<path-settings,`path.data`>> directory when the node or instance starts.
 
-Monitoring documents are just ordinary JSON documents built by monitoring each 
+Monitoring documents are just ordinary JSON documents built by monitoring each
 {stack} component at a specified collection interval. If you want to alter the
 templates for these indices, see <<config-monitoring-indices>>.
 
-Each component in the {stack} is responsible for monitoring itself and then 
-forwarding those documents to the production cluster for both routing and 
-indexing (storage). The routing and indexing processes in {es} are handled by 
-what are called <<es-monitoring-collectors,collectors>> and 
-<<es-monitoring-exporters,exporters>>.
-
-Alternatively, you can use {metricbeat} to collect monitoring data and ship it
-directly to the monitoring cluster. 
+{metricbeat} is used to collect monitoring data and to ship it directly to the
+monitoring cluster.
 
 To learn how to collect monitoring data, see:
 
@@ -32,7 +26,7 @@ To learn how to collect monitoring data, see:
 * Monitoring Beats:
 ** {auditbeat-ref}/monitoring.html[{auditbeat}]
 ** {filebeat-ref}/monitoring.html[{filebeat}]
-** {functionbeat-ref}/monitoring.html[{functionbeat}] 
+** {functionbeat-ref}/monitoring.html[{functionbeat}]
 ** {heartbeat-ref}/monitoring.html[{heartbeat}]
 ** {metricbeat-ref}/monitoring.html[{metricbeat}]
 ** {packetbeat-ref}/monitoring.html[{packetbeat}]
diff --git a/docs/reference/monitoring/http-export.asciidoc b/docs/reference/monitoring/http-export.asciidoc
index eaca9904d04d1..0a12b7d44d882 100644
--- a/docs/reference/monitoring/http-export.asciidoc
+++ b/docs/reference/monitoring/http-export.asciidoc
@@ -3,16 +3,29 @@
 [[http-exporter]]
 === HTTP exporters
 
-The `http` exporter is the preferred exporter in {monitoring} because it enables 
-the use of a separate monitoring cluster. As a secondary benefit, it avoids 
-using a production cluster node as a coordinating node for indexing monitoring 
-data because all requests are HTTP requests to the monitoring cluster.
+[IMPORTANT]
+=========================
+{metricbeat} is the recommended method for collecting and shipping monitoring
+data to a monitoring cluster.
 
-The `http` exporter uses the low-level {es} REST Client, which enables it to 
-send its data to any {es} cluster it can access through the network. Its requests 
-make use of the <<common-options-response-filtering,`filter_path`>> parameter to 
-reduce bandwidth whenever possible, which helps to ensure that communications 
-between the production and monitoring clusters are as lightweight as possible. 
+If you have previously configured internal collection, you should migrate to
+using {metricbeat} collection. Use either {metricbeat} collection or
+internal collection; do not use both.
+
+Learn more about <<configuring-metricbeat>>.
+=========================
+
+The `http` exporter is the preferred exporter in the {es} {monitor-features}
+because it enables the use of a separate monitoring cluster. As a secondary
+benefit, it avoids using a production cluster node as a coordinating node for
+indexing monitoring data because all requests are HTTP requests to the
+monitoring cluster.
+
+The `http` exporter uses the low-level {es} REST Client, which enables it to
+send its data to any {es} cluster it can access through the network. Its requests
+make use of the <<common-options-response-filtering,`filter_path`>> parameter to
+reduce bandwidth whenever possible, which helps to ensure that communications
+between the production and monitoring clusters are as lightweight as possible.
 
 The `http` exporter supports a number of settings that control how it
 communicates over HTTP to remote clusters. In most cases, it is not
@@ -43,13 +56,13 @@ xpack.monitoring.exporters:
 
 ----------------------------------
 <1> A `local` exporter defined explicitly whose arbitrary name is `my_local`.
-<2> An `http` exporter defined whose arbitrary name is `my_remote`. This name 
-uniquely defines the exporter but is otherwise unused. 
-<3> `host` is a required setting for `http` exporters. It must specify the HTTP 
-port rather than the transport port. The default port value is `9200`. 
+<2> An `http` exporter defined whose arbitrary name is `my_remote`. This name
+uniquely defines the exporter but is otherwise unused.
+<3> `host` is a required setting for `http` exporters. It must specify the HTTP
+port rather than the transport port. The default port value is `9200`.
 <4> User authentication for those using {stack} {security-features} or some other
     form of user authentication protecting the cluster.
-<5> See <<http-exporter-settings>> for all TLS/SSL settings. If not supplied, 
+<5> See <<http-exporter-settings>> for all TLS/SSL settings. If not supplied,
 the default node-level TLS/SSL settings are used.
 <6> Optional base path to prefix any outgoing request with in order to
     work with proxies.
@@ -57,13 +70,13 @@ the default node-level TLS/SSL settings are used.
     The array-based key/value format sends one header per value.
 <8> A mechanism for changing the date suffix used by default.
 
-NOTE: The `http` exporter accepts an array of `hosts` and it will round robin 
-through the list. It is a good idea to take advantage of that feature when the 
+NOTE: The `http` exporter accepts an array of `hosts` and it will round robin
+through the list. It is a good idea to take advantage of that feature when the
 monitoring cluster contains more than one node.
 
 Unlike the `local` exporter, _every_ node that uses the `http` exporter attempts
-to check and create the resources that it needs. The `http` exporter avoids 
-re-checking the resources unless something triggers it to perform the checks 
+to check and create the resources that it needs. The `http` exporter avoids
+re-checking the resources unless something triggers it to perform the checks
 again. These triggers include:
 
 * The production cluster's node restarts.
@@ -73,21 +86,21 @@ again. These triggers include:
 
 The easiest way to trigger a check is to disable, then re-enable the exporter.
 
-WARNING: This resource management behavior can create a hole for users that 
-delete monitoring resources. Since the `http` exporter does not re-check its 
-resources unless one of the triggers occurs, this can result in malformed index 
+WARNING: This resource management behavior can create a hole for users that
+delete monitoring resources. Since the `http` exporter does not re-check its
+resources unless one of the triggers occurs, this can result in malformed index
 mappings.
 
 Unlike the `local` exporter, the `http` exporter is inherently routing requests
-outside of the cluster. This situation means that the exporter must provide a 
-username and password when the monitoring cluster requires one (or other 
+outside of the cluster. This situation means that the exporter must provide a
+username and password when the monitoring cluster requires one (or other
 appropriate security configurations, such as TLS/SSL settings).
 
 IMPORTANT: When discussing security relative to the `http` exporter, it is
-critical to remember that all users are managed on the monitoring cluster. This 
-is particularly important to remember when you move from development 
-environments to production environments, where you often have dedicated 
+critical to remember that all users are managed on the monitoring cluster. This
+is particularly important to remember when you move from development
+environments to production environments, where you often have dedicated
 monitoring clusters.
 
-For more information about the configuration options for the `http` exporter, 
+For more information about the configuration options for the `http` exporter,
 see <<http-exporter-settings>>.
diff --git a/docs/reference/monitoring/index.asciidoc b/docs/reference/monitoring/index.asciidoc
index 0876184f0e74d..c7ba76dc3d886 100644
--- a/docs/reference/monitoring/index.asciidoc
+++ b/docs/reference/monitoring/index.asciidoc
@@ -6,14 +6,14 @@
 [partintro]
 --
 The {stack} {monitor-features} provide a way to keep a pulse on the health and
-performance of your {es} cluster. 
+performance of your {es} cluster.
 
 * <<monitoring-overview>>
 * <<how-monitoring-works>>
 * <<monitoring-production>>
-* <<collecting-monitoring-data>>
 * <<configuring-metricbeat>>
 * <<configuring-filebeat>>
+* <<collecting-monitoring-data>>
 * <<config-monitoring-indices>>
 * <<es-monitoring-collectors>>
 * <<es-monitoring-exporters>>
diff --git a/docs/reference/monitoring/local-export.asciidoc b/docs/reference/monitoring/local-export.asciidoc
index 8723b226ca766..01dd2892d42dc 100644
--- a/docs/reference/monitoring/local-export.asciidoc
+++ b/docs/reference/monitoring/local-export.asciidoc
@@ -3,10 +3,22 @@
 [[local-exporter]]
 === Local exporters
 
-The `local` exporter is the default exporter in {monitoring}. It routes data 
-back into the same (local) cluster. In other words, it uses the production 
+[IMPORTANT]
+=========================
+{metricbeat} is the recommended method for collecting and shipping monitoring
+data to a monitoring cluster.
+
+If you have previously configured internal collection, you should migrate to
+using {metricbeat} collection. Use either {metricbeat} collection or
+internal collection; do not use both.
+
+Learn more about <<configuring-metricbeat>>.
+=========================
+
+The `local` exporter is the default exporter in {monitoring}. It routes data
+back into the same (local) cluster. In other words, it uses the production
 cluster as the monitoring cluster. For example:
- 
+
 [source,yaml]
 ---------------------------------------------------
 xpack.monitoring.exporters.my_local_exporter: <1>
@@ -16,57 +28,57 @@ xpack.monitoring.exporters.my_local_exporter: <1>
 
 This exporter exists to provide a convenient option when hardware is simply not
 available. It is also a way for developers to get an idea of what their actions
-do for pre-production clusters when they do not have the time or resources to 
-provide a separate monitoring cluster. However, this exporter has disadvantages 
+do for pre-production clusters when they do not have the time or resources to
+provide a separate monitoring cluster. However, this exporter has disadvantages
 that impact the local cluster:
 
-* All indexing impacts the local cluster and the nodes that hold the monitoring 
+* All indexing impacts the local cluster and the nodes that hold the monitoring
 indices' shards.
-* Most collectors run on the elected master node. Therefore most indexing occurs 
+* Most collectors run on the elected master node. Therefore most indexing occurs
 with the elected master node as the coordinating node, which is a bad practice.
-* Any usage of {monitoring} for {kib} uses the local cluster's resources for 
+* Any usage of {monitoring} for {kib} uses the local cluster's resources for
 searches and aggregations, which means that they might not be available for
 non-monitoring tasks.
-* If the local cluster goes down, the monitoring cluster has inherently gone 
+* If the local cluster goes down, the monitoring cluster has inherently gone
 down with it (and vice versa), which generally defeats the purpose of monitoring.
 
-For the `local` exporter, all setup occurs only on the elected master node. This 
-means that if you do not see any monitoring templates or ingest pipelines, the 
-elected master node is having issues or it is not configured in the same way. 
-Unlike the `http` exporter, the `local` exporter has the advantage of accessing 
-the monitoring cluster's up-to-date cluster state. It can therefore always check 
-that the templates and ingest pipelines exist without a performance penalty. If 
-the elected master node encounters errors while trying to create the monitoring 
-resources, it logs errors, ignores that collection, and tries again after the 
+For the `local` exporter, all setup occurs only on the elected master node. This
+means that if you do not see any monitoring templates or ingest pipelines, the
+elected master node is having issues or it is not configured in the same way.
+Unlike the `http` exporter, the `local` exporter has the advantage of accessing
+the monitoring cluster's up-to-date cluster state. It can therefore always check
+that the templates and ingest pipelines exist without a performance penalty. If
+the elected master node encounters errors while trying to create the monitoring
+resources, it logs errors, ignores that collection, and tries again after the
 next collection.
 
-The elected master node is the only node to set up resources for the `local` 
+The elected master node is the only node to set up resources for the `local`
 exporter. Therefore all other nodes wait for the resources to be set up before
-indexing any monitoring data from their own collectors. Each of these nodes logs 
-a message indicating that they are waiting for the resources to be set up. 
+indexing any monitoring data from their own collectors. Each of these nodes logs
+a message indicating that they are waiting for the resources to be set up.
 
 One benefit of the `local` exporter is that it lives within the cluster and
 therefore no extra configuration is required when the cluster is secured with
 {stack} {security-features}. All operations, including indexing operations, that
 occur from a `local` exporter make use of the internal transport mechanisms
 within {es}. This behavior enables the exporter to be used without providing any
-user credentials when {security-features} are enabled. 
+user credentials when {security-features} are enabled.
 
-For more information about the configuration options for the `local` exporter, 
+For more information about the configuration options for the `local` exporter,
 see <<local-exporter-settings>>.
 
 [[local-exporter-cleaner]]
 ==== Cleaner service
 
-One feature of the `local` exporter, which is not present in the `http` exporter, 
-is a cleaner service. The cleaner service runs once per day at 01:00 AM UTC on 
+One feature of the `local` exporter, which is not present in the `http` exporter,
+is a cleaner service. The cleaner service runs once per day at 01:00 AM UTC on
 the elected master node.
 
 The role of the cleaner service is to clean, or curate, the monitoring indices
 that are older than a configurable amount of time (the default is `7d`). This
 cleaner exists as part of the `local` exporter as a safety mechanism. The `http`
 exporter does not make use of it because it could enable a single misconfigured
-node to prematurely curate data from other production clusters that share the 
+node to prematurely curate data from other production clusters that share the
 same monitoring cluster.
 
 In a dedicated monitoring cluster, the cleaning service can be used without
@@ -78,6 +90,6 @@ xpack.monitoring.collection.enabled: false <1>
 xpack.monitoring.history.duration: 3d <2>
 ---------------------------------------------------
 <1> Disable the collection of data on the monitoring cluster.
-<2> Lower the default history duration from `7d` to `3d`. The minimum value is 
-`1d`. This setting can be modified only when using a Gold or higher level 
+<2> Lower the default history duration from `7d` to `3d`. The minimum value is
+`1d`. This setting can be modified only when using a Gold or higher level
 license. For the Basic license level, it uses the default of 7 days.
diff --git a/docs/reference/monitoring/production.asciidoc b/docs/reference/monitoring/production.asciidoc
index ed6401a9f06bb..de0e1aa3912cf 100644
--- a/docs/reference/monitoring/production.asciidoc
+++ b/docs/reference/monitoring/production.asciidoc
@@ -8,13 +8,25 @@ not. For example, you can use {metricbeat} to ship monitoring data about {kib},
 {es}, {ls}, and Beats to the monitoring cluster.
 //If you are sending your data to the {esms-init}, see <<esms>>.
 
-If you have at least a gold license, using a dedicated monitoring cluster also 
+[IMPORTANT]
+=========================
+{metricbeat} is the recommended method for collecting and shipping monitoring
+data to a monitoring cluster.
+
+If you have previously configured internal collection, you should migrate to
+using {metricbeat} collection. Use either {metricbeat} collection or
+internal collection; do not use both.
+
+Learn more about <<configuring-metricbeat>>.
+=========================
+
+If you have at least a gold license, using a dedicated monitoring cluster also
 enables you to monitor multiple clusters from a central location.
 
 To store monitoring data in a separate cluster:
 
-. Set up the {es} cluster you want to use as the monitoring cluster. 
-For example, you might set up a two host cluster with the nodes `es-mon-1` and 
+. Set up the {es} cluster you want to use as the monitoring cluster.
+For example, you might set up a two host cluster with the nodes `es-mon-1` and
 `es-mon-2`.
 +
 --
@@ -27,10 +39,10 @@ cluster; it does not need to be a dedicated ingest node.
 ===============================
 --
 
-.. (Optional) Verify that the collection of monitoring data is disabled on the 
-monitoring cluster. By default, the `xpack.monitoring.collection.enabled` setting 
-is `false`. 
-+ 
+.. (Optional) Verify that the collection of monitoring data is disabled on the
+monitoring cluster. By default, the `xpack.monitoring.collection.enabled` setting
+is `false`.
++
 --
 For example, you can use the following APIs to review and change this setting:
 
@@ -48,28 +60,28 @@ PUT _cluster/settings
 // TEST[skip:security errs]
 --
 
-.. If the {es} {security-features} are enabled on the monitoring cluster, create 
-users that can send and retrieve monitoring data. 
+.. If the {es} {security-features} are enabled on the monitoring cluster, create
+users that can send and retrieve monitoring data.
 +
 --
-NOTE: If you plan to use {kib} to view monitoring data, username and password 
-credentials must be valid on both the {kib} server and the monitoring cluster. 
+NOTE: If you plan to use {kib} to view monitoring data, username and password
+credentials must be valid on both the {kib} server and the monitoring cluster.
 
 --
 
-*** If you plan to use {metricbeat} to collect data about {es} or {kib}, 
-create a user that has the `remote_monitoring_collector` built-in role and a 
-user that has the `remote_monitoring_agent` 
-<<built-in-roles-remote-monitoring-agent,built-in role>>. Alternatively, use the 
-`remote_monitoring_user` <<built-in-users,built-in user>>. 
+*** If you plan to use {metricbeat} to collect data about {es} or {kib},
+create a user that has the `remote_monitoring_collector` built-in role and a
+user that has the `remote_monitoring_agent`
+<<built-in-roles-remote-monitoring-agent,built-in role>>. Alternatively, use the
+`remote_monitoring_user` <<built-in-users,built-in user>>.
 
-*** If you plan to use HTTP exporters to route data through your production 
-cluster, create a user that has the `remote_monitoring_agent` 
-<<built-in-roles-remote-monitoring-agent,built-in role>>. 
+*** If you plan to use HTTP exporters to route data through your production
+cluster, create a user that has the `remote_monitoring_agent`
+<<built-in-roles-remote-monitoring-agent,built-in role>>.
 +
 --
-For example, the 
-following request creates a `remote_monitor` user that has the 
+For example, the
+following request creates a `remote_monitor` user that has the
 `remote_monitoring_agent` role:
 
 [source,console]
@@ -83,11 +95,11 @@ POST /_security/user/remote_monitor
 ---------------------------------------------------------------
 // TEST[skip:needs-gold+-license]
 
-Alternatively, use the `remote_monitoring_user` <<built-in-users,built-in user>>. 
+Alternatively, use the `remote_monitoring_user` <<built-in-users,built-in user>>.
 --
 
-. Configure your production cluster to collect data and send it to the 
-monitoring cluster. 
+. Configure your production cluster to collect data and send it to the
+monitoring cluster.
 
 ** <<configuring-metricbeat,Use {metricbeat}>>.
 
@@ -97,13 +109,13 @@ monitoring cluster.
 {logstash-ref}/configuring-logstash.html[Configure {ls} to collect data and send it to the monitoring cluster].
 
 . (Optional) Configure the Beats to collect data and send it to the monitoring
-cluster. 
+cluster.
 ** {auditbeat-ref}/monitoring.html[Auditbeat]
 ** {filebeat-ref}/monitoring.html[Filebeat]
 ** {heartbeat-ref}/monitoring.html[Heartbeat]
 ** {metricbeat-ref}/monitoring.html[Metricbeat]
 ** {packetbeat-ref}/monitoring.html[Packetbeat]
-** {winlogbeat-ref}/monitoring.html[Winlogbeat] 
+** {winlogbeat-ref}/monitoring.html[Winlogbeat]
 
 . (Optional) Configure {kib} to collect data and send it to the monitoring cluster:
 
@@ -111,13 +123,13 @@ cluster.
 
 ** {kibana-ref}/monitoring-kibana.html[Use HTTP exporters].
 
-. (Optional) Create a dedicated {kib} instance for monitoring, rather than using 
-a single {kib} instance to access both your production cluster and monitoring 
+. (Optional) Create a dedicated {kib} instance for monitoring, rather than using
+a single {kib} instance to access both your production cluster and monitoring
 cluster.
 
-.. (Optional) Disable the collection of monitoring data in this {kib} instance. 
-Set the `xpack.monitoring.kibana.collection.enabled` setting to `false` in the 
-`kibana.yml` file. For more information about this setting, see 
-{kibana-ref}/monitoring-settings-kb.html[Monitoring settings in {kib}]. 
+.. (Optional) Disable the collection of monitoring data in this {kib} instance.
+Set the `xpack.monitoring.kibana.collection.enabled` setting to `false` in the
+`kibana.yml` file. For more information about this setting, see
+{kibana-ref}/monitoring-settings-kb.html[Monitoring settings in {kib}].
 
-. {kibana-ref}/monitoring-data.html[Configure {kib} to retrieve and display the monitoring data]. 
+. {kibana-ref}/monitoring-data.html[Configure {kib} to retrieve and display the monitoring data].

From f2e1fd0083abbfe0c6684fc12f4fa317a5d19aa1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Fri, 17 Jan 2020 18:52:57 +0100
Subject: [PATCH 644/686] [DOCS] Adds text about data types to the
 categorization docs (#51145)

---
 .../ml/anomaly-detection/categories.asciidoc  | 51 ++++++++++++++-----
 1 file changed, 37 insertions(+), 14 deletions(-)

diff --git a/docs/reference/ml/anomaly-detection/categories.asciidoc b/docs/reference/ml/anomaly-detection/categories.asciidoc
index 79c349509156b..e159b46cc2bda 100644
--- a/docs/reference/ml/anomaly-detection/categories.asciidoc
+++ b/docs/reference/ml/anomaly-detection/categories.asciidoc
@@ -1,6 +1,28 @@
 [role="xpack"]
 [[ml-configuring-categories]]
-=== Categorizing log messages
+=== Categorizing data
+
+Categorization is a {ml} process that considers a tokenization of a field, 
+clusters similar data together, and classifies them into categories. However, 
+categorization doesn't work equally well on different data types. It works 
+best on machine-written messages and application outputs, typically on data that 
+consists of repeated elements, for example log messages for the purpose of 
+system troubleshooting. Log categorization groups unstructured log messages into 
+categories, then you can use {anomaly-detect} to model and identify rare or 
+unusual counts of log message categories.
+
+Categorization is tuned to work best on data like log messages by taking token
+order into account, not considering synonyms, and including stop words in its 
+analysis. Complete sentences in human communication or literary text (for 
+example emails, wiki pages, prose, or other human generated content) can be 
+extremely diverse in structure.  Since categorization is tuned for machine data 
+it will give poor results on such human generated data. For example, the 
+categorization job would create so many categories that couldn't be handled 
+effectively.  Categorization is _not_ natural language processing (NLP).
+
+[float]
+[[ml-categorization-log-messages]]
+==== Categorizing log messages
 
 Application log events are often unstructured and contain variable data. For
 example:
@@ -65,8 +87,8 @@ defining categories. The categorization filters are applied in the order they
 are listed in the job configuration, which allows you to disregard multiple
 sections of the categorization field value. In this example, we have decided that
 we do not want the detailed SQL to be considered in the message categorization.
-This particular categorization filter removes the SQL statement from the categorization
-algorithm.
+This particular categorization filter removes the SQL statement from the 
+categorization algorithm.
 
 If your data is stored in {es}, you can create an advanced {anomaly-job} with
 these same properties:
@@ -79,7 +101,7 @@ NOTE: To add the `categorization_examples_limit` property, you must use the
 
 [float]
 [[ml-configuring-analyzer]]
-==== Customizing the categorization analyzer
+===== Customizing the categorization analyzer
 
 Categorization uses English dictionary words to identify log message categories.
 By default, it also uses English tokenization rules. For this reason, if you use
@@ -135,7 +157,8 @@ here achieves exactly the same as the `categorization_filters` in the first
 example.
 <2> The `ml_classic` tokenizer works like the non-customizable tokenization
 that was used for categorization in older versions of machine learning. If you
-want the same categorization behavior as older versions, use this property value.
+want the same categorization behavior as older versions, use this property 
+value.
 <3> By default, English day or month words are filtered from log messages before
 categorization. If your logs are in a different language and contain
 dates, you might get better results by filtering the day or month words in your
@@ -178,9 +201,9 @@ POST _ml/anomaly_detectors/_validate
 If you specify any part of the `categorization_analyzer`, however, any omitted
 sub-properties are _not_ set to default values.
 
-The `ml_classic` tokenizer and the day and month stopword filter are more or less
-equivalent to the following analyzer, which is defined using only built-in {es}
-{ref}/analysis-tokenizers.html[tokenizers] and
+The `ml_classic` tokenizer and the day and month stopword filter are more or 
+less equivalent to the following analyzer, which is defined using only built-in 
+{es} {ref}/analysis-tokenizers.html[tokenizers] and
 {ref}/analysis-tokenfilters.html[token filters]:
 
 [source,console]
@@ -234,11 +257,11 @@ PUT _ml/anomaly_detectors/it_ops_new_logs3
 <4> Underscores, hyphens, and dots are removed from the beginning of tokens.
 <5> Underscores, hyphens, and dots are also removed from the end of tokens.
 
-The key difference between the default `categorization_analyzer` and this example
-analyzer is that using the `ml_classic` tokenizer is several times faster. The
-difference in behavior is that this custom analyzer does not include accented
-letters in tokens whereas the `ml_classic` tokenizer does, although that could
-be fixed by using more complex regular expressions.
+The key difference between the default `categorization_analyzer` and this 
+example analyzer is that using the `ml_classic` tokenizer is several times 
+faster. The difference in behavior is that this custom analyzer does not include 
+accented letters in tokens whereas the `ml_classic` tokenizer does, although 
+that could be fixed by using more complex regular expressions.
 
 If you are categorizing non-English messages in a language where words are
 separated by spaces, you might get better results if you change the day or month
@@ -263,7 +286,7 @@ API examples above.
 
 [float]
 [[ml-viewing-categories]]
-==== Viewing categorization results
+===== Viewing categorization results
 
 After you open the job and start the {dfeed} or supply data to the job, you can
 view the categorization results in {kib}. For example:

From 2d2eee225637fb7ce0fdadcc6363099b99fa473e Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 17 Jan 2020 13:25:33 -0500
Subject: [PATCH 645/686] Fix flaky usage tracking test (#51169)

We added tracking of index feature usage in #51031 but due to some copy
and paste errors the test fails on some seeds. This fixes those errors.
---
 .../xpack/oss/IndexFeatureSetUsage.java            | 14 ++++++++++----
 .../xpack/oss/IndexFeatureSetUsageTests.java       | 10 +++++-----
 2 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsage.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsage.java
index cd779d09d52ac..d086d649f4ae0 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsage.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsage.java
@@ -6,6 +6,7 @@
 
 package org.elasticsearch.xpack.oss;
 
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.XContentBuilder;
@@ -110,28 +111,28 @@ public Set<String> getUsedAnalyzerTypes() {
      * Return the set of used built-in char filters in the cluster.
      */
     public Set<String> getUsedBuiltInCharFilters() {
-        return usedCharFilters;
+        return usedBuiltInCharFilters;
     }
 
     /**
      * Return the set of used built-in tokenizers in the cluster.
      */
     public Set<String> getUsedBuiltInTokenizers() {
-        return usedTokenizers;
+        return usedBuiltInTokenizers;
     }
 
     /**
      * Return the set of used built-in token filters in the cluster.
      */
     public Set<String> getUsedBuiltInTokenFilters() {
-        return usedTokenFilters;
+        return usedBuiltInTokenFilters;
     }
 
     /**
      * Return the set of used built-in analyzers in the cluster.
      */
     public Set<String> getUsedBuiltInAnalyzers() {
-        return usedAnalyzers;
+        return usedBuiltInAnalyzers;
     }
 
     @Override
@@ -182,4 +183,9 @@ public int hashCode() {
                 usedAnalyzers, usedBuiltInCharFilters, usedBuiltInTokenizers, usedBuiltInTokenFilters,
                 usedBuiltInAnalyzers);
     }
+
+    @Override
+    public String toString() {
+        return Strings.toString(this, true, true);
+    }
 }
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsageTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsageTests.java
index 078a17a7aa555..5d3b35b67ecbc 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsageTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/oss/IndexFeatureSetUsageTests.java
@@ -116,7 +116,7 @@ protected IndexFeatureSetUsage mutateInstance(IndexFeatureSetUsage instance) thr
                     instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
                     instance.getUsedBuiltInAnalyzers());
         case 4:
-            Set<String> analyzers = new HashSet<>(instance.getUsedAnalyzerTypes());
+           Set<String> analyzers = new HashSet<>(instance.getUsedAnalyzerTypes());
             if (analyzers.add("english") == false) {
                 analyzers.remove("english");
             }
@@ -125,7 +125,7 @@ protected IndexFeatureSetUsage mutateInstance(IndexFeatureSetUsage instance) thr
                     instance.getUsedBuiltInCharFilters(), instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
                     instance.getUsedBuiltInAnalyzers());
         case 5:
-            Set<String> builtInCharFilters = new HashSet<>();
+            Set<String> builtInCharFilters = new HashSet<>(instance.getUsedBuiltInCharFilters());
             if (builtInCharFilters.add("html_strip") == false) {
                 builtInCharFilters.remove("html_strip");
             }
@@ -135,7 +135,7 @@ protected IndexFeatureSetUsage mutateInstance(IndexFeatureSetUsage instance) thr
                     instance.getUsedBuiltInTokenizers(), instance.getUsedBuiltInTokenFilters(),
                     instance.getUsedBuiltInAnalyzers());
         case 6:
-            Set<String> builtInTokenizers = new HashSet<>();
+            Set<String> builtInTokenizers = new HashSet<>(instance.getUsedBuiltInTokenizers());
             if (builtInTokenizers.add("keyword") == false) {
                 builtInTokenizers.remove("keyword");
             }
@@ -144,7 +144,7 @@ protected IndexFeatureSetUsage mutateInstance(IndexFeatureSetUsage instance) thr
                     instance.getUsedBuiltInCharFilters(), builtInTokenizers, instance.getUsedBuiltInTokenFilters(),
                     instance.getUsedBuiltInAnalyzers());
         case 7:
-            Set<String> builtInTokenFilters = new HashSet<>();
+            Set<String> builtInTokenFilters = new HashSet<>(instance.getUsedBuiltInTokenFilters());
             if (builtInTokenFilters.add("trim") == false) {
                 builtInTokenFilters.remove("trim");
             }
@@ -153,7 +153,7 @@ protected IndexFeatureSetUsage mutateInstance(IndexFeatureSetUsage instance) thr
                     instance.getUsedBuiltInCharFilters(), instance.getUsedBuiltInTokenizers(), builtInTokenFilters,
                     instance.getUsedBuiltInAnalyzers());
         case 8:
-            Set<String> builtInAnalyzers = new HashSet<>();
+            Set<String> builtInAnalyzers = new HashSet<>(instance.getUsedBuiltInAnalyzers());
             if (builtInAnalyzers.add("french") == false) {
                 builtInAnalyzers.remove("french");
             }

From c868d0f9b7088e0a2a083a97500a9ba92b90bc7a Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 17 Jan 2020 13:32:07 -0500
Subject: [PATCH 646/686] Update skip after backport (#51175)

Now that we've backported #50869 we can update the skip config for its
test.
---
 .../rest-api-spec/test/search.aggregation/230_composite.yml   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
index adc61f1204fa9..6af3c8bd1b773 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/search.aggregation/230_composite.yml
@@ -740,8 +740,8 @@ setup:
 ---
 "Mixed ip and unmapped fields":
   - skip:
-      version: " - 7.99.99"
-      reason: This will fail against 7.x until the fix is backported there
+      version: " - 7.5.99"
+      reason: This was fixed in 7.6.0
   # It is important that the index *without* the ip field be sorted *before*
   # the index *with* the ip field because that has caused bugs in the past.
   - do:

From 17fd7e940840db0ede97378a58e5dd0c4ae1efd3 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Fri, 17 Jan 2020 12:16:01 -0700
Subject: [PATCH 647/686] Use separate policies for tests in
 SnapshotLifecycleRestIT (#51075)

These policies store statistics, but since stats updating is asynchronous, it's
possible for the update from one test to bleed into a separate one. This change
switches the tests to use separate policy ids so that their stats are tracked
independently. It also relaxes the checking constraint in one of the tests.

Hopefully this:
Resolves #48531
Resolves #48017
---
 .../xpack/slm/SnapshotLifecycleRestIT.java       | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
index b3c114b5e67fb..93ec47e14ce83 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleRestIT.java
@@ -66,10 +66,10 @@ protected boolean waitForAllSnapshotsWiped() {
     }
 
     public void testMissingRepo() throws Exception {
-        SnapshotLifecyclePolicy policy = new SnapshotLifecyclePolicy("test-policy", "snap",
+        SnapshotLifecyclePolicy policy = new SnapshotLifecyclePolicy("missing-repo-policy", "snap",
             "*/1 * * * * ?", "missing-repo", Collections.emptyMap(), SnapshotRetentionConfiguration.EMPTY);
 
-        Request putLifecycle = new Request("PUT", "/_slm/policy/test-policy");
+        Request putLifecycle = new Request("PUT", "/_slm/policy/missing-repo-policy");
         XContentBuilder lifecycleBuilder = JsonXContent.contentBuilder();
         policy.toXContent(lifecycleBuilder, ToXContent.EMPTY_PARAMS);
         putLifecycle.setJsonEntity(Strings.toString(lifecycleBuilder));
@@ -84,7 +84,7 @@ public void testMissingRepo() throws Exception {
     @SuppressWarnings("unchecked")
     public void testFullPolicySnapshot() throws Exception {
         final String indexName = "test";
-        final String policyName = "test-policy";
+        final String policyName = "full-policy";
         final String repoId = "full-policy-repo";
         int docCount = randomIntBetween(10, 50);
         List<IndexRequestBuilder> indexReqs = new ArrayList<>();
@@ -157,7 +157,7 @@ public void testFullPolicySnapshot() throws Exception {
 
     @SuppressWarnings("unchecked")
     public void testPolicyFailure() throws Exception {
-        final String policyName = "test-policy";
+        final String policyName = "failure-policy";
         final String repoName = "policy-failure-repo";
         final String indexPattern = "index-doesnt-exist";
         initializeRepo(repoName);
@@ -206,7 +206,7 @@ public void testPolicyFailure() throws Exception {
         issueUrl = "https://github.com/elastic/elasticsearch/issues/48531")
     public void testPolicyManualExecution() throws Exception {
         final String indexName = "test";
-        final String policyName = "test-policy";
+        final String policyName = "manual-policy";
         final String repoId = "manual-execution-repo";
         int docCount = randomIntBetween(10, 50);
         for (int i = 0; i < docCount; i++) {
@@ -353,7 +353,7 @@ public void testStartStopStatus() throws Exception {
         issueUrl = "https://github.com/elastic/elasticsearch/issues/48017")
     public void testBasicTimeBasedRetention() throws Exception {
         final String indexName = "test";
-        final String policyName = "test-policy";
+        final String policyName = "basic-time-policy";
         final String repoId = "time-based-retention-repo";
         int docCount = randomIntBetween(10, 50);
         List<IndexRequestBuilder> indexReqs = new ArrayList<>();
@@ -424,8 +424,8 @@ public void testBasicTimeBasedRetention() throws Exception {
                 int retentionRun = (int) stats.get(SnapshotLifecycleStats.RETENTION_RUNS.getPreferredName());
                 int totalTaken = (int) stats.get(SnapshotLifecycleStats.TOTAL_TAKEN.getPreferredName());
                 int totalDeleted = (int) stats.get(SnapshotLifecycleStats.TOTAL_DELETIONS.getPreferredName());
-                assertThat(snapsTaken, equalTo(1));
-                assertThat(totalTaken, equalTo(1));
+                assertThat(snapsTaken, greaterThanOrEqualTo(1));
+                assertThat(totalTaken, greaterThanOrEqualTo(1));
                 assertThat(retentionRun, greaterThanOrEqualTo(1));
                 assertThat(snapsDeleted, greaterThanOrEqualTo(1));
                 assertThat(totalDeleted, greaterThanOrEqualTo(1));

From 2ee6ee3fe04c9e8c94729f129e70690e2aa6bee7 Mon Sep 17 00:00:00 2001
From: Jay Modi <jaymode@users.noreply.github.com>
Date: Fri, 17 Jan 2020 12:27:35 -0700
Subject: [PATCH 648/686] Update BWC version for hidden indices (#51174)

This commit updates the BWC version we use in wire serialization for
the hidden indices to V_7_7_0 after the backport of the feature to the
7.x branch.

Relates #50452
---
 .../java/org/elasticsearch/action/support/IndicesOptions.java | 4 ++--
 .../java/org/elasticsearch/action/OriginalIndicesTests.java   | 3 +--
 .../admin/cluster/shards/ClusterSearchShardsRequestTests.java | 2 +-
 .../action/admin/indices/close/CloseIndexRequestTests.java    | 4 ++--
 .../org/elasticsearch/action/support/IndicesOptionsTests.java | 2 +-
 5 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java b/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
index 42c97b25b950e..5438eb2122ea0 100644
--- a/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
+++ b/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
@@ -223,7 +223,7 @@ public EnumSet<WildcardStates> getExpandWildcards() {
 
     public void writeIndicesOptions(StreamOutput out) throws IOException {
         out.writeEnumSet(options);
-        if (out.getVersion().before(Version.V_8_0_0) && expandWildcards.contains(WildcardStates.HIDDEN)) {
+        if (out.getVersion().before(Version.V_7_7_0) && expandWildcards.contains(WildcardStates.HIDDEN)) {
             final EnumSet<WildcardStates> states = EnumSet.copyOf(expandWildcards);
             states.remove(WildcardStates.HIDDEN);
             out.writeEnumSet(states);
@@ -235,7 +235,7 @@ public void writeIndicesOptions(StreamOutput out) throws IOException {
     public static IndicesOptions readIndicesOptions(StreamInput in) throws IOException {
         EnumSet<Option> options = in.readEnumSet(Option.class);
         EnumSet<WildcardStates> states = in.readEnumSet(WildcardStates.class);
-        if (in.getVersion().before(Version.V_8_0_0)) {
+        if (in.getVersion().before(Version.V_7_7_0)) {
             states.add(WildcardStates.HIDDEN);
         }
         return new IndicesOptions(options, states);
diff --git a/server/src/test/java/org/elasticsearch/action/OriginalIndicesTests.java b/server/src/test/java/org/elasticsearch/action/OriginalIndicesTests.java
index 39f453d448fd7..91959264746b0 100644
--- a/server/src/test/java/org/elasticsearch/action/OriginalIndicesTests.java
+++ b/server/src/test/java/org/elasticsearch/action/OriginalIndicesTests.java
@@ -53,8 +53,7 @@ public void testOriginalIndicesSerialization() throws IOException {
             // indices options are not equivalent when sent to an older version and re-read due
             // to the addition of hidden indices as expand to hidden indices is always true when
             // read from a prior version
-            // TODO update version on backport!
-            if (out.getVersion().onOrAfter(Version.V_8_0_0) || originalIndices.indicesOptions().expandWildcardsHidden()) {
+            if (out.getVersion().onOrAfter(Version.V_7_7_0) || originalIndices.indicesOptions().expandWildcardsHidden()) {
                 assertThat(originalIndices2.indicesOptions(), equalTo(originalIndices.indicesOptions()));
             } else if (originalIndices.indicesOptions().expandWildcardsHidden()) {
                 assertThat(originalIndices2.indicesOptions(), equalTo(originalIndices.indicesOptions()));
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequestTests.java
index ee943518ac1c2..3b57ab53826d3 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/shards/ClusterSearchShardsRequestTests.java
@@ -65,7 +65,7 @@ public void testSerialization() throws Exception {
                 // indices options are not equivalent when sent to an older version and re-read due
                 // to the addition of hidden indices as expand to hidden indices is always true when
                 // read from a prior version
-                if (version.onOrAfter(Version.V_8_0_0) || request.indicesOptions().expandWildcardsHidden()) { // TODO change on backport!
+                if (version.onOrAfter(Version.V_7_7_0) || request.indicesOptions().expandWildcardsHidden()) {
                     assertEquals(request.indicesOptions(), deserialized.indicesOptions());
                 }
                 assertEquals(request.routing(), deserialized.routing());
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/close/CloseIndexRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/close/CloseIndexRequestTests.java
index 3b33791b9bfe8..2f87a1a35fd7d 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/close/CloseIndexRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/close/CloseIndexRequestTests.java
@@ -66,7 +66,7 @@ public void testBwcSerialization() throws Exception {
                     // to the addition of hidden indices as expand to hidden indices is always true when
                     // read from a prior version
                     // TODO update version on backport!
-                    if (out.getVersion().onOrAfter(Version.V_8_0_0) || request.indicesOptions().expandWildcardsHidden()) {
+                    if (out.getVersion().onOrAfter(Version.V_7_7_0) || request.indicesOptions().expandWildcardsHidden()) {
                         assertEquals(request.indicesOptions(), indicesOptions);
                     }
                     if (in.getVersion().onOrAfter(Version.V_7_2_0)) {
@@ -104,7 +104,7 @@ public void testBwcSerialization() throws Exception {
                 // to the addition of hidden indices as expand to hidden indices is always true when
                 // read from a prior version
                 // TODO change version on backport
-                if (out.getVersion().onOrAfter(Version.V_8_0_0) || sample.indicesOptions().expandWildcardsHidden()) {
+                if (out.getVersion().onOrAfter(Version.V_7_7_0) || sample.indicesOptions().expandWildcardsHidden()) {
                     assertEquals(sample.indicesOptions(), deserializedRequest.indicesOptions());
                 }
                 if (out.getVersion().onOrAfter(Version.V_7_2_0)) {
diff --git a/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java b/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
index b5e60966e51fe..f318e59d1a408 100644
--- a/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
+++ b/server/src/test/java/org/elasticsearch/action/support/IndicesOptionsTests.java
@@ -70,7 +70,7 @@ public void testSerialization() throws Exception {
             assertThat(indicesOptions2.allowNoIndices(), equalTo(indicesOptions.allowNoIndices()));
             assertThat(indicesOptions2.expandWildcardsOpen(), equalTo(indicesOptions.expandWildcardsOpen()));
             assertThat(indicesOptions2.expandWildcardsClosed(), equalTo(indicesOptions.expandWildcardsClosed()));
-            if (version.before(Version.V_8_0_0)) {
+            if (version.before(Version.V_7_7_0)) {
                 assertThat(indicesOptions2.expandWildcardsHidden(), is(true));
             } else {
                 assertThat(indicesOptions2.expandWildcardsHidden(), equalTo(indicesOptions.expandWildcardsHidden()));

From 396778ae728f416af946522207e8cd3665c8b569 Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Fri, 17 Jan 2020 14:54:53 -0500
Subject: [PATCH 649/686] Initial autoscaling commit (#51161)

This commit merely adds the skeleton for the autoscaling project, adding
the basics to include the autoscaling module in the default
distribution, opt-in to code formatting, and a placeholder for the docs.
---
 build.gradle                                  |  1 +
 docs/reference/autoscaling/index.asciidoc     | 19 ++++++++
 docs/reference/index.asciidoc                 |  2 +
 x-pack/plugin/autoscaling/build.gradle        | 20 +++++++++
 .../xpack/autoscaling/Autoscaling.java        | 44 +++++++++++++++++++
 .../xpack/autoscaling/AutoscalingTests.java   | 40 +++++++++++++++++
 6 files changed, 126 insertions(+)
 create mode 100644 docs/reference/autoscaling/index.asciidoc
 create mode 100644 x-pack/plugin/autoscaling/build.gradle
 create mode 100644 x-pack/plugin/autoscaling/src/main/java/org/elasticsearch/xpack/autoscaling/Autoscaling.java
 create mode 100644 x-pack/plugin/autoscaling/src/test/java/org/elasticsearch/xpack/autoscaling/AutoscalingTests.java

diff --git a/build.gradle b/build.gradle
index 343ee3df31452..b87665783f88f 100644
--- a/build.gradle
+++ b/build.gradle
@@ -107,6 +107,7 @@ subprojects {
     // switched to an exclude list, and eventualy removed completely.
     def projectPathsToFormat = [
       ':build-tools',
+      ':x-pack:plugin:autoscaling',
       ':x-pack:plugin:enrich'
     ]
 
diff --git a/docs/reference/autoscaling/index.asciidoc b/docs/reference/autoscaling/index.asciidoc
new file mode 100644
index 0000000000000..f8f1f98c04275
--- /dev/null
+++ b/docs/reference/autoscaling/index.asciidoc
@@ -0,0 +1,19 @@
+[role="xpack"]
+[testenv="platinum"]
+[[xpack-autoscaling]]
+[chapter]
+= Autoscaling
+
+experimental[]
+
+The autoscaling feature enables an operator to configure tiers of nodes that
+self-monitor whether or not they need to scale based on an operator-defined
+policy. Then, via the autoscaling API, an Elasticsearch cluster can report
+whether or not it needs additional resources to meet the policy. For example, an
+operator could define a policy that a warm tier should scale on available disk
+space. Elasticsearch would monitor and forecast the available disk space in the
+warm tier, and if the forecast is such that the cluster will soon not be able to
+allocate existing and future shard copies due to disk space, then the
+autoscaling API would report that the cluster needs to scale due to disk space.
+It remains the responsibility of the operator to add the additional resources
+that the cluster signals it requires.
diff --git a/docs/reference/index.asciidoc b/docs/reference/index.asciidoc
index e203b1d4e8730..7199b97981453 100644
--- a/docs/reference/index.asciidoc
+++ b/docs/reference/index.asciidoc
@@ -40,6 +40,8 @@ include::ingest.asciidoc[]
 
 include::ilm/index.asciidoc[]
 
+include::autoscaling/index.asciidoc[]
+
 include::sql/index.asciidoc[]
 
 include::monitoring/index.asciidoc[]
diff --git a/x-pack/plugin/autoscaling/build.gradle b/x-pack/plugin/autoscaling/build.gradle
new file mode 100644
index 0000000000000..4ffbdb781590e
--- /dev/null
+++ b/x-pack/plugin/autoscaling/build.gradle
@@ -0,0 +1,20 @@
+evaluationDependsOn(xpackModule('core'))
+
+apply plugin: 'elasticsearch.esplugin'
+
+esplugin {
+  name 'x-pack-autoscaling'
+  description 'Elasticsearch Expanded Pack Plugin - Autoscaling'
+  classname 'org.elasticsearch.xpack.autoscaling.Autoscaling'
+  extendedPlugins = ['x-pack-core']
+  hasNativeController false
+  requiresKeystore true
+}
+archivesBaseName = 'x-pack-autoscaling'
+
+integTest.enabled = false
+
+dependencies {
+  compileOnly project(path: xpackModule('core'), configuration: 'default')
+  testCompile project(path: xpackModule('core'), configuration: 'testArtifacts')
+}
diff --git a/x-pack/plugin/autoscaling/src/main/java/org/elasticsearch/xpack/autoscaling/Autoscaling.java b/x-pack/plugin/autoscaling/src/main/java/org/elasticsearch/xpack/autoscaling/Autoscaling.java
new file mode 100644
index 0000000000000..b56ef627d56ff
--- /dev/null
+++ b/x-pack/plugin/autoscaling/src/main/java/org/elasticsearch/xpack/autoscaling/Autoscaling.java
@@ -0,0 +1,44 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.autoscaling;
+
+import org.elasticsearch.Build;
+import org.elasticsearch.common.settings.Setting;
+import org.elasticsearch.plugins.Plugin;
+
+import java.util.List;
+
+/**
+ * Container class for autoscaling functionality.
+ */
+public class Autoscaling extends Plugin {
+
+    public static final Setting<Boolean> AUTOSCALING_ENABLED_SETTING = Setting.boolSetting(
+        "xpack.autoscaling.enabled",
+        false,
+        Setting.Property.NodeScope
+    );
+
+    /**
+     * The settings defined by autoscaling.
+     *
+     * @return the settings
+     */
+    @Override
+    public List<Setting<?>> getSettings() {
+        if (isSnapshot()) {
+            return List.of(AUTOSCALING_ENABLED_SETTING);
+        } else {
+            return List.of();
+        }
+    }
+
+    boolean isSnapshot() {
+        return Build.CURRENT.isSnapshot();
+    }
+
+}
diff --git a/x-pack/plugin/autoscaling/src/test/java/org/elasticsearch/xpack/autoscaling/AutoscalingTests.java b/x-pack/plugin/autoscaling/src/test/java/org/elasticsearch/xpack/autoscaling/AutoscalingTests.java
new file mode 100644
index 0000000000000..32c2b94ab439d
--- /dev/null
+++ b/x-pack/plugin/autoscaling/src/test/java/org/elasticsearch/xpack/autoscaling/AutoscalingTests.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License;
+ * you may not use this file except in compliance with the Elastic License.
+ */
+
+package org.elasticsearch.xpack.autoscaling;
+
+import org.elasticsearch.test.ESTestCase;
+
+import static org.hamcrest.Matchers.hasItem;
+import static org.hamcrest.Matchers.not;
+
+public class AutoscalingTests extends ESTestCase {
+
+    public void testEnabledSettingRegisteredInSnapshotBuilds() {
+        final Autoscaling plugin = new Autoscaling() {
+
+            @Override
+            protected boolean isSnapshot() {
+                return true;
+            }
+
+        };
+        assertThat(plugin.getSettings(), hasItem(Autoscaling.AUTOSCALING_ENABLED_SETTING));
+    }
+
+    public void testEnabledSettingNotRegisteredInNonSnapshotBuilds() {
+        final Autoscaling plugin = new Autoscaling() {
+
+            @Override
+            protected boolean isSnapshot() {
+                return false;
+            }
+
+        };
+        assertThat(plugin.getSettings(), not(hasItem(Autoscaling.AUTOSCALING_ENABLED_SETTING)));
+    }
+
+}

From ebe33d41d7b928f878a5614a10391d90c2e4a3f5 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 17 Jan 2020 22:23:25 +0100
Subject: [PATCH 650/686] Fix CorruptedBlobStoreRepository Test (#51128)

The tests, when creating broken serialized blobs could randomly create
a sequence of bytes that is partially readable by the deserializer and then
not throw `IOException` but instead `ElasticsearchParseException`.
We should just handle these unexpected exceptions downstream properly and pass them
wrapped as `RepositoryException` to the listener to fix the test and keep the API consistent.
---
 .../repositories/blobstore/BlobStoreRepository.java            | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
index 87a9da671e417..9787faab98510 100644
--- a/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
+++ b/server/src/main/java/org/elasticsearch/repositories/blobstore/BlobStoreRepository.java
@@ -1097,6 +1097,9 @@ public void getRepositoryData(ActionListener<RepositoryData> listener) {
                     listener.onFailure(e);
                 }
                 return;
+            } catch (Exception e) {
+                listener.onFailure(new RepositoryException(metadata.name(), "Unexpected exception when loading repository data", e));
+                return;
             }
         }
     }

From 829ad5f449a3a638567d2516ff25246b0674cd89 Mon Sep 17 00:00:00 2001
From: Maxim <timonin.maksim@mail.ru>
Date: Sat, 18 Jan 2020 00:52:46 +0300
Subject: [PATCH 651/686] Deprecates _upgrade API (#47678) (#50484)

* Deprecates _upgrade API

Ref #47678

* Move deprecation flags to path section. Add deprecation warning tests for _upgrade API.

Ref #47678
---
 .../api/indices.get_upgrade.json              |  12 ++-
 .../rest-api-spec/api/indices.upgrade.json    |  12 ++-
 .../test/indices.upgrade/10_basic.yml         |  42 +++++++-
 .../test/indices.upgrade/20_deprecated.yml    | 102 ++++++++++++++++++
 .../elasticsearch/action/ActionModule.java    |   8 +-
 ....java => RestUpgradeActionDeprecated.java} |  18 +++-
 ...=> RestUpgradeStatusActionDeprecated.java} |  16 ++-
 7 files changed, 193 insertions(+), 17 deletions(-)
 create mode 100644 rest-api-spec/src/main/resources/rest-api-spec/test/indices.upgrade/20_deprecated.yml
 rename server/src/main/java/org/elasticsearch/rest/action/admin/indices/{RestUpgradeAction.java => RestUpgradeActionDeprecated.java} (70%)
 rename server/src/main/java/org/elasticsearch/rest/action/admin/indices/{RestUpgradeStatusAction.java => RestUpgradeStatusActionDeprecated.java} (70%)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_upgrade.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_upgrade.json
index 981478b41fecc..862fdde4ac395 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_upgrade.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_upgrade.json
@@ -2,7 +2,7 @@
   "indices.get_upgrade":{
     "documentation":{
       "url":"https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-upgrade.html",
-      "description":"The _upgrade API is no longer useful and will be removed."
+      "description":"DEPRECATED Returns a progress status of current upgrade."
     },
     "stability":"stable",
     "url":{
@@ -11,7 +11,11 @@
           "path":"/_upgrade",
           "methods":[
             "GET"
-          ]
+          ],
+          "deprecated":{
+            "version":"8.0.0",
+            "description":"The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
+          }
         },
         {
           "path":"/{index}/_upgrade",
@@ -23,6 +27,10 @@
               "type":"list",
               "description":"A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices"
             }
+          },
+          "deprecated":{
+            "version":"8.0.0",
+            "description":"The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
           }
         }
       ]
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.upgrade.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.upgrade.json
index 7cdf098e7c617..93628fdd106d0 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.upgrade.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.upgrade.json
@@ -2,7 +2,7 @@
   "indices.upgrade":{
     "documentation":{
       "url":"https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-upgrade.html",
-      "description":"The _upgrade API is no longer useful and will be removed."
+      "description":"DEPRECATED Upgrades to the current version of Lucene."
     },
     "stability":"stable",
     "url":{
@@ -11,7 +11,11 @@
           "path":"/_upgrade",
           "methods":[
             "POST"
-          ]
+          ],
+          "deprecated":{
+            "version":"8.0.0",
+            "description":"The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
+          }
         },
         {
           "path":"/{index}/_upgrade",
@@ -23,6 +27,10 @@
               "type":"list",
               "description":"A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices"
             }
+          },
+          "deprecated":{
+            "version":"8.0.0",
+            "description":"The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
           }
         }
       ]
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.upgrade/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.upgrade/10_basic.yml
index 55070cb8c1f97..4f1f330fdd39f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.upgrade/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.upgrade/10_basic.yml
@@ -1,5 +1,9 @@
 ---
 "Basic test for upgrade indices":
+  - skip:
+      version: " - 7.99.99"
+      reason: "_upgrade api is deprecated since 8.0.0"
+      features: ["warnings", "node_selector"]
 
   - do:
       indices.create:
@@ -12,12 +16,21 @@
   - do:
       indices.upgrade:
         index: test_index
+      warnings:
+        - "The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
+      node_selector:
+        version: "8.0.0 - "
 
   - match: {upgraded_indices.test_index.oldest_lucene_segment_version: '/(\d\.)+\d/'}
   - is_true: upgraded_indices.test_index.upgrade_version
 
 ---
 "Upgrade indices ignore unavailable":
+  - skip:
+      version: " - 7.99.99"
+      reason: "_upgrade api is deprecated since 8.0.0"
+      features: ["warnings", "node_selector"]
+
   - do:
       indices.create:
         index: test_index
@@ -31,6 +44,10 @@
       indices.upgrade:
         index: ["does_not_exist", "test_index"]
         ignore_unavailable: true
+      warnings:
+        - "The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
+      node_selector:
+        version: "8.0.0 - "
 
   - match: {_shards.total: 1}
   - is_true: upgraded_indices.test_index.upgrade_version
@@ -38,17 +55,29 @@
 
 ---
 "Upgrade indices allow no indices":
+  - skip:
+      version: " - 7.99.99"
+      reason: "_upgrade api is deprecated since 8.0.0"
+      features: ["warnings", "node_selector"]
 
   - do:
       indices.upgrade:
         index: test_index
         ignore_unavailable: true
         allow_no_indices: true
+      warnings:
+        - "The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
+      node_selector:
+        version: "8.0.0 - "
 
   - match: {_shards.total: 0}
 
 ---
 "Upgrade indices disallow no indices":
+  - skip:
+      version: " - 7.99.99"
+      reason: "_upgrade api is deprecated since 8.0.0"
+      features: ["warnings", "node_selector"]
 
   - do:
       catch: missing
@@ -56,9 +85,17 @@
         index: test_index
         ignore_unavailable: true
         allow_no_indices: false
+      warnings:
+        - "The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
+      node_selector:
+        version: "8.0.0 - "
 
 ---
 "Upgrade indices disallow unavailable":
+  - skip:
+      version: " - 7.99.99"
+      reason: "_upgrade api is deprecated since 8.0.0"
+      features: ["warnings", "node_selector"]
 
   - do:
       indices.create:
@@ -69,4 +106,7 @@
       indices.upgrade:
         index: ["test_index", "does_not_exist"]
         ignore_unavailable: false
-
+      warnings:
+        - "The _upgrade API is no longer useful and will be removed. Instead, see _reindex API."
+      node_selector:
+        version: "8.0.0 - "
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.upgrade/20_deprecated.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.upgrade/20_deprecated.yml
new file mode 100644
index 0000000000000..e4c45e7d99530
--- /dev/null
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.upgrade/20_deprecated.yml
@@ -0,0 +1,102 @@
+---
+"Basic test for upgrade indices < 8.0.0":
+  - skip:
+      version: "8.0.0 - "
+      reason: "_upgrade api has deprecation header since 8.0.0"
+      features: "node_selector"
+
+  - do:
+      indices.create:
+        index: test_index
+        body:
+          settings:
+            index:
+              number_of_replicas: 0
+
+  - do:
+      indices.upgrade:
+        index: test_index
+      node_selector:
+        version: " - 7.99.99"
+
+  - match: {upgraded_indices.test_index.oldest_lucene_segment_version: '/(\d\.)+\d/'}
+  - is_true: upgraded_indices.test_index.upgrade_version
+
+---
+"Upgrade indices ignore unavailable < 8.0.0":
+  - skip:
+      version: "8.0.0 - "
+      reason: "_upgrade api has deprecation header since 8.0.0"
+      features: "node_selector"
+
+  - do:
+      indices.create:
+        index: test_index
+        body:
+          settings:
+            index:
+              number_of_shards: 1
+              number_of_replicas: 0
+
+  - do:
+      indices.upgrade:
+        index: ["does_not_exist", "test_index"]
+        ignore_unavailable: true
+      node_selector:
+        version: " - 7.99.99"
+
+  - match: {_shards.total: 1}
+  - is_true: upgraded_indices.test_index.upgrade_version
+  - is_false: upgraded_indices.does_not_exist
+
+---
+"Upgrade indices allow no indices < 8.0.0":
+  - skip:
+      version: "8.0.0 - "
+      reason: "_upgrade api has deprecation header since 8.0.0"
+      features: "node_selector"
+
+  - do:
+      indices.upgrade:
+        index: test_index
+        ignore_unavailable: true
+        allow_no_indices: true
+      node_selector:
+        version: " - 7.99.99"
+
+  - match: {_shards.total: 0}
+
+---
+"Upgrade indices disallow no indices < 8.0.0":
+  - skip:
+      version: "8.0.0 - "
+      reason: "_upgrade api has deprecation header since 8.0.0"
+      features: "node_selector"
+
+  - do:
+      catch: missing
+      indices.upgrade:
+        index: test_index
+        ignore_unavailable: true
+        allow_no_indices: false
+      node_selector:
+        version: " - 7.99.99"
+
+---
+"Upgrade indices disallow unavailable < 8.0.0":
+  - skip:
+      version: "8.0.0 - "
+      reason: "_upgrade api has deprecation header since 8.0.0"
+      features: "node_selector"
+
+  - do:
+      indices.create:
+        index: test_index
+
+  - do:
+      catch: missing
+      indices.upgrade:
+        index: ["test_index", "does_not_exist"]
+        ignore_unavailable: false
+      node_selector:
+        version: " - 7.99.99"
diff --git a/server/src/main/java/org/elasticsearch/action/ActionModule.java b/server/src/main/java/org/elasticsearch/action/ActionModule.java
index 1ef3c1418adba..064b28808dc32 100644
--- a/server/src/main/java/org/elasticsearch/action/ActionModule.java
+++ b/server/src/main/java/org/elasticsearch/action/ActionModule.java
@@ -295,8 +295,8 @@
 import org.elasticsearch.rest.action.admin.indices.RestRolloverIndexAction;
 import org.elasticsearch.rest.action.admin.indices.RestSyncedFlushAction;
 import org.elasticsearch.rest.action.admin.indices.RestUpdateSettingsAction;
-import org.elasticsearch.rest.action.admin.indices.RestUpgradeAction;
-import org.elasticsearch.rest.action.admin.indices.RestUpgradeStatusAction;
+import org.elasticsearch.rest.action.admin.indices.RestUpgradeActionDeprecated;
+import org.elasticsearch.rest.action.admin.indices.RestUpgradeStatusActionDeprecated;
 import org.elasticsearch.rest.action.admin.indices.RestValidateQueryAction;
 import org.elasticsearch.rest.action.cat.AbstractCatAction;
 import org.elasticsearch.rest.action.cat.RestAliasAction;
@@ -630,8 +630,8 @@ public void initRestHandlers(Supplier<DiscoveryNodes> nodesInCluster) {
         registerHandler.accept(new RestFlushAction(restController));
         registerHandler.accept(new RestSyncedFlushAction(restController));
         registerHandler.accept(new RestForceMergeAction(restController));
-        registerHandler.accept(new RestUpgradeAction(restController));
-        registerHandler.accept(new RestUpgradeStatusAction(restController));
+        registerHandler.accept(new RestUpgradeActionDeprecated(restController));
+        registerHandler.accept(new RestUpgradeStatusActionDeprecated(restController));
         registerHandler.accept(new RestClearIndicesCacheAction(restController));
 
         registerHandler.accept(new RestIndexAction(restController, clusterService));
diff --git a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeAction.java b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeActionDeprecated.java
similarity index 70%
rename from server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeAction.java
rename to server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeActionDeprecated.java
index 77f2d4f7b86c8..f63fe49ec6e91 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeActionDeprecated.java
@@ -19,10 +19,12 @@
 
 package org.elasticsearch.rest.action.admin.indices;
 
+import org.apache.logging.log4j.LogManager;
 import org.elasticsearch.action.admin.indices.upgrade.post.UpgradeRequest;
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.rest.BaseRestHandler;
 import org.elasticsearch.rest.RestController;
 import org.elasticsearch.rest.RestRequest;
@@ -32,11 +34,19 @@
 
 import static org.elasticsearch.rest.RestRequest.Method.POST;
 
-public class RestUpgradeAction extends BaseRestHandler {
+public class RestUpgradeActionDeprecated extends BaseRestHandler {
 
-    public RestUpgradeAction(RestController controller) {
-        controller.registerHandler(POST, "/_upgrade", this);
-        controller.registerHandler(POST, "/{index}/_upgrade", this);
+    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(
+        LogManager.getLogger(RestUpgradeActionDeprecated.class));
+
+    public static final String UPGRADE_API_DEPRECATION_MESSAGE =
+        "The _upgrade API is no longer useful and will be removed. Instead, see _reindex API.";
+
+    public RestUpgradeActionDeprecated(RestController controller) {
+        controller.registerAsDeprecatedHandler(POST, "/_upgrade", this,
+            UPGRADE_API_DEPRECATION_MESSAGE, deprecationLogger);
+        controller.registerAsDeprecatedHandler(POST, "/{index}/_upgrade", this,
+            UPGRADE_API_DEPRECATION_MESSAGE, deprecationLogger);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeStatusAction.java b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeStatusActionDeprecated.java
similarity index 70%
rename from server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeStatusAction.java
rename to server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeStatusActionDeprecated.java
index a560c19daf77f..1eb09b31ce26f 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeStatusAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestUpgradeStatusActionDeprecated.java
@@ -19,10 +19,12 @@
 
 package org.elasticsearch.rest.action.admin.indices;
 
+import org.apache.logging.log4j.LogManager;
 import org.elasticsearch.action.admin.indices.upgrade.get.UpgradeStatusRequest;
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.node.NodeClient;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.rest.BaseRestHandler;
 import org.elasticsearch.rest.RestController;
 import org.elasticsearch.rest.RestRequest;
@@ -31,12 +33,18 @@
 import java.io.IOException;
 
 import static org.elasticsearch.rest.RestRequest.Method.GET;
+import static org.elasticsearch.rest.action.admin.indices.RestUpgradeActionDeprecated.UPGRADE_API_DEPRECATION_MESSAGE;
 
-public class RestUpgradeStatusAction extends BaseRestHandler {
+public class RestUpgradeStatusActionDeprecated extends BaseRestHandler {
 
-    public RestUpgradeStatusAction(RestController controller) {
-        controller.registerHandler(GET, "/_upgrade", this);
-        controller.registerHandler(GET, "/{index}/_upgrade", this);
+    private static final DeprecationLogger deprecationLogger = new DeprecationLogger(
+        LogManager.getLogger(RestUpgradeStatusActionDeprecated.class));
+
+    public RestUpgradeStatusActionDeprecated(RestController controller) {
+        controller.registerAsDeprecatedHandler(GET, "/_upgrade", this,
+            UPGRADE_API_DEPRECATION_MESSAGE, deprecationLogger);
+        controller.registerAsDeprecatedHandler(GET, "/{index}/_upgrade", this,
+            UPGRADE_API_DEPRECATION_MESSAGE, deprecationLogger);
     }
 
     @Override

From eff5d0d11154922fbd2b3f7b6736ef6a59800e87 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 17 Jan 2020 17:34:22 -0500
Subject: [PATCH 652/686] Make soft-deletes mandatory in 8.0 (#51122)

Creating indices with soft deletes disabled is no longer supported in 8.0.
---
 .../migration/migrate_8_0/indices.asciidoc    |   9 ++
 .../upgrades/FullClusterRestartIT.java        |  89 ++++++++++-
 .../elasticsearch/upgrades/RecoveryIT.java    |  25 +--
 .../test/indices.create/10_basic.yml          |  10 +-
 .../test/indices.stats/20_translog.yml        | 144 +-----------------
 .../metadata/MetaDataCreateIndexService.java  |  10 +-
 .../elasticsearch/index/IndexSettings.java    |   8 +-
 .../MetaDataCreateIndexServiceTests.java      |  24 ++-
 .../gateway/ReplicaShardAllocatorIT.java      |   4 -
 .../index/IndexSettingsTests.java             |  35 -----
 .../index/engine/InternalEngineTests.java     |   5 +-
 .../RecoveryDuringReplicationTests.java       |  63 --------
 .../index/shard/IndexShardIT.java             |   1 -
 .../shard/IndexShardRetentionLeaseTests.java  |  15 --
 .../index/shard/IndexShardTests.java          |  12 +-
 .../recovery/RecoverySourceHandlerTests.java  |   1 -
 .../indices/recovery/RecoveryTests.java       |   6 +-
 .../indices/state/OpenCloseIndexIT.java       |  10 +-
 .../elasticsearch/recovery/RelocationIT.java  |   2 -
 .../index/engine/EngineTestCase.java          |   4 +-
 .../ESIndexLevelReplicationTestCase.java      |   4 +-
 .../index/shard/IndexShardTestCase.java       |   1 -
 .../elasticsearch/test/ESIntegTestCase.java   |   1 -
 .../test/ESSingleNodeTestCase.java            |   6 +-
 .../elasticsearch/xpack/ccr/AutoFollowIT.java |  35 -----
 .../xpack/ccr/LocalIndexFollowingIT.java      |  16 --
 26 files changed, 150 insertions(+), 390 deletions(-)

diff --git a/docs/reference/migration/migrate_8_0/indices.asciidoc b/docs/reference/migration/migrate_8_0/indices.asciidoc
index ef5cd25f81808..03acac7753539 100644
--- a/docs/reference/migration/migrate_8_0/indices.asciidoc
+++ b/docs/reference/migration/migrate_8_0/indices.asciidoc
@@ -34,3 +34,12 @@ removed in 8.0.
 
 Synced flush was deprecated in 7.6 and is removed in 8.0. Use a regular flush
 instead as it has the same effect as a synced flush in 7.6 and later.
+
+
+[float]
+==== Indices with soft deletes disabled
+
+Creating indices with soft deletes disabled was deprecated in 7.6 and
+is no longer supported in 8.0. The setting index.soft_deletes.enabled
+can no longer be set to false. As the setting defaults to true, simply
+leave the setting unset.
diff --git a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
index 427383d7d8292..406099c82e09e 100644
--- a/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
+++ b/qa/full-cluster-restart/src/test/java/org/elasticsearch/upgrades/FullClusterRestartIT.java
@@ -776,6 +776,11 @@ public void testSnapshotRestore() throws IOException {
         if (isRunningAgainstOldCluster()) {
             // Create the index
             count = between(200, 300);
+            Settings.Builder settings = Settings.builder();
+            if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
+                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
+            }
+            createIndex(index, settings.build());
             indexRandomDocuments(count, true, true, i -> jsonBuilder().startObject().field("field", "value").endObject());
         } else {
             count = countOfIndexedRandomDocuments();
@@ -1257,11 +1262,12 @@ public void testPeerRecoveryRetentionLeases() throws IOException {
      */
     public void testOperationBasedRecovery() throws Exception {
         if (isRunningAgainstOldCluster()) {
-            createIndex(index, Settings.builder()
-                .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
-                .build());
+            Settings.Builder settings = Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1);
+            if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
+                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
+            }
+            createIndex(index, settings.build());
             ensureGreen(index);
             int committedDocs = randomIntBetween(100, 200);
             for (int i = 0; i < committedDocs; i++) {
@@ -1309,4 +1315,77 @@ public void testTurnOffTranslogRetentionAfterUpgraded() throws Exception {
             ensurePeerRecoveryRetentionLeasesRenewedAndSynced(index);
         }
     }
+
+    public void testResize() throws Exception {
+        int numDocs;
+        if (isRunningAgainstOldCluster()) {
+            final Settings.Builder settings = Settings.builder()
+                .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 3)
+                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 1);
+            if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
+                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false);
+            }
+            createIndex(index, settings.build());
+            numDocs = randomIntBetween(10, 1000);
+            for (int i = 0; i < numDocs; i++) {
+                indexDocument(Integer.toString(i));
+                if (rarely()) {
+                    flush(index, randomBoolean());
+                }
+            }
+            saveInfoDocument("num_doc_" + index, Integer.toString(numDocs));
+            ensureGreen(index);
+        } else {
+            ensureGreen(index);
+            numDocs = Integer.parseInt(loadInfoDocument("num_doc_" + index));
+            int moreDocs = randomIntBetween(0, 100);
+            for (int i = 0; i < moreDocs; i++) {
+                indexDocument(Integer.toString(numDocs + i));
+                if (rarely()) {
+                    flush(index, randomBoolean());
+                }
+            }
+            Request updateSettingsRequest = new Request("PUT", "/" + index + "/_settings");
+            updateSettingsRequest.setJsonEntity("{\"settings\": {\"index.blocks.write\": true}}");
+            client().performRequest(updateSettingsRequest);
+            {
+                final String target = index + "_shrunken";
+                Request shrinkRequest = new Request("PUT", "/" + index + "/_shrink/" + target);
+                Settings.Builder settings = Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1);
+                if (randomBoolean()) {
+                    settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
+                }
+                shrinkRequest.setJsonEntity("{\"settings\":" + Strings.toString(settings.build()) + "}");
+                client().performRequest(shrinkRequest);
+                ensureGreenLongWait(target);
+                assertNumHits(target, numDocs + moreDocs, 1);
+            }
+            {
+                final String target = index + "_split";
+                Settings.Builder settings = Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 6);
+                if (randomBoolean()) {
+                    settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
+                }
+                Request splitRequest = new Request("PUT", "/" + index + "/_split/" + target);
+                splitRequest.setJsonEntity("{\"settings\":" + Strings.toString(settings.build()) + "}");
+                client().performRequest(splitRequest);
+                ensureGreenLongWait(target);
+                assertNumHits(target, numDocs + moreDocs, 6);
+            }
+            {
+                final String target = index + "_cloned";
+                client().performRequest(new Request("PUT", "/" + index + "/_clone/" + target));
+                ensureGreenLongWait(target);
+                assertNumHits(target, numDocs + moreDocs, 3);
+            }
+        }
+    }
+
+    private void assertNumHits(String index, int numHits, int totalShards) throws IOException {
+        Map<String, Object> resp = entityAsMap(client().performRequest(new Request("GET", "/" + index + "/_search")));
+        assertNoFailures(resp);
+        assertThat(XContentMapValues.extractValue("_shards.total", resp), equalTo(totalShards));
+        assertThat(XContentMapValues.extractValue("_shards.successful", resp), equalTo(totalShards));
+        assertThat(extractTotalHits(resp), equalTo(numHits));
+    }
 }
diff --git a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
index d0892fd914f57..dfca9dd74a635 100644
--- a/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
+++ b/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RecoveryIT.java
@@ -293,7 +293,7 @@ public void testRecovery() throws Exception {
                 // before timing out
                 .put(INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), "100ms")
                 .put(SETTING_ALLOCATION_MAX_RETRY.getKey(), "0"); // fail faster
-            if (randomBoolean()) {
+            if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
                 settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
             }
             createIndex(index, settings.build());
@@ -327,8 +327,10 @@ public void testRetentionLeasesEstablishedWhenPromotingPrimary() throws Exceptio
                 .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), between(1, 5))
                 .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), between(1, 2)) // triggers nontrivial promotion
                 .put(INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), "100ms")
-                .put(SETTING_ALLOCATION_MAX_RETRY.getKey(), "0") // fail faster
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
+                .put(SETTING_ALLOCATION_MAX_RETRY.getKey(), "0"); // fail faster
+            if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
+                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
+            }
             createIndex(index, settings.build());
             int numDocs = randomInt(10);
             indexDocs(index, 0, numDocs);
@@ -350,8 +352,10 @@ public void testRetentionLeasesEstablishedWhenRelocatingPrimary() throws Excepti
                     .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), between(1, 5))
                     .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), between(0, 1))
                     .put(INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), "100ms")
-                    .put(SETTING_ALLOCATION_MAX_RETRY.getKey(), "0") // fail faster
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
+                    .put(SETTING_ALLOCATION_MAX_RETRY.getKey(), "0"); // fail faster
+                if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
+                    settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
+                }
                 createIndex(index, settings.build());
                 int numDocs = randomInt(10);
                 indexDocs(index, 0, numDocs);
@@ -635,10 +639,13 @@ private void assertNoopRecoveries(String indexName, Predicate<String> targetNode
     public void testOperationBasedRecovery() throws Exception {
         final String index = "test_operation_based_recovery";
         if (CLUSTER_TYPE == ClusterType.OLD) {
-            createIndex(index, Settings.builder()
+            final Settings.Builder settings = Settings.builder()
                 .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
-                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 2)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean()).build());
+                .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 2);
+            if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
+                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
+            }
+            createIndex(index, settings.build());
             ensureGreen(index);
             indexDocs(index, 0, randomIntBetween(100, 200));
             flush(index, randomBoolean());
@@ -714,7 +721,7 @@ public void testSoftDeletesDisabledWarning() throws Exception {
         if (CLUSTER_TYPE == ClusterType.OLD) {
             boolean softDeletesEnabled = true;
             Settings.Builder settings = Settings.builder();
-            if (randomBoolean()) {
+            if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
                 softDeletesEnabled = randomBoolean();
                 settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), softDeletesEnabled);
             }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
index b5ce95c31a581..44ec99ce9f95d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.create/10_basic.yml
@@ -123,14 +123,10 @@
 ---
 "Create index without soft deletes":
   - skip:
-      version:  " - 7.5.99"
-      reason:   "indices without soft deletes are deprecated in 7.6"
-      features: "warnings"
-
+      version:  " - 7.9.99"
+      reason:   "indices without soft-deletes is no longer supported "
   - do:
-      warnings:
-        - Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions.
-          Please do not specify value for setting [index.soft_deletes.enabled] of index [test_index].
+      catch: /illegal_argument_exception/
       indices.create:
         index: test_index
         body:
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
index 0cc21eda1bdcd..fbbc49bbe59eb 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
+++ b/rest-api-spec/src/main/resources/rest-api-spec/test/indices.stats/20_translog.yml
@@ -1,83 +1,5 @@
 ---
-"Translog retention without soft_deletes":
-  - skip:
-      version:  " - 7.5.99"
-      reason:   "indices without soft deletes are deprecated in 7.6"
-      features: "warnings"
-
-  - do:
-      indices.create:
-        index: test
-        body:
-          settings:
-            soft_deletes.enabled: false
-      warnings:
-        - Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions.
-          Please do not specify value for setting [index.soft_deletes.enabled] of index [test].
-  - do:
-      cluster.health:
-        wait_for_no_initializing_shards: true
-        wait_for_events: languid
-  - do:
-      indices.stats:
-        metric: [ translog ]
-  - set: { indices.test.primaries.translog.size_in_bytes: creation_size }
-
-  - do:
-      index:
-        index: test
-        id:    1
-        body:  { "foo": "bar" }
-
-  - do:
-      indices.stats:
-        metric: [ translog ]
-  - gt: { indices.test.primaries.translog.size_in_bytes: $creation_size }
-  - match: { indices.test.primaries.translog.operations: 1 }
-# we can't check this yet as creation size will contain two empty translog generations. A single
-# non empty generation with one op may be smaller or larger than that.
-#  - gt: { indices.test.primaries.translog.uncommitted_size_in_bytes: $creation_size }
-  - match: { indices.test.primaries.translog.uncommitted_operations: 1 }
-
-  - do:
-      indices.flush:
-        index: test
-
-  - do:
-      indices.stats:
-        metric: [ translog ]
-  - gt: { indices.test.primaries.translog.size_in_bytes: $creation_size }
-  - match: { indices.test.primaries.translog.operations: 1 }
-  ## creation translog size has some overhead due to an initial empty generation that will be trimmed later
-  - lt: { indices.test.primaries.translog.uncommitted_size_in_bytes: $creation_size }
-  - match: { indices.test.primaries.translog.uncommitted_operations: 0 }
-
-  - do:
-      indices.put_settings:
-        index: test
-        body:
-          index.translog.retention.size: -1
-          index.translog.retention.age: -1
-
-  - do:
-      indices.flush:
-        index: test
-        force: true # force flush as we don't have pending ops
-
-  - do:
-      indices.stats:
-        metric: [ translog ]
-  ## creation translog size has some overhead due to an initial empty generation that will be trimmed later
-  - lte: { indices.test.primaries.translog.size_in_bytes: $creation_size }
-  - match: { indices.test.primaries.translog.operations: 0 }
-  - lte: { indices.test.primaries.translog.uncommitted_size_in_bytes: $creation_size }
-  - match: { indices.test.primaries.translog.uncommitted_operations: 0 }
-
----
-"Translog retention with soft_deletes":
-  - skip:
-      version: " - 7.3.99"
-      reason:  "start ignoring translog retention policy with soft-deletes enabled in 7.4"
+"Translog retention":
   - do:
       indices.create:
         index: test
@@ -136,69 +58,7 @@
   - gte: { indices.test.primaries.translog.earliest_last_modified_age: 0 }
 
 ---
-"Translog stats on closed indices without soft-deletes":
-  - skip:
-      version: " - 7.5.99"
-      reason:  "indices without soft deletes are deprecated in 7.6"
-      features: "warnings"
-
-  - do:
-      indices.create:
-        index: test
-        body:
-          settings:
-            soft_deletes.enabled: false
-      warnings:
-        - Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions.
-          Please do not specify value for setting [index.soft_deletes.enabled] of index [test].
-
-  - do:
-      cluster.health:
-        wait_for_no_initializing_shards: true
-        wait_for_events: languid
-  - do:
-      index:
-        index: test
-        id:    1
-        body:  { "foo": "bar" }
-
-  - do:
-      index:
-        index: test
-        id:    2
-        body:  { "foo": "bar" }
-
-  - do:
-      index:
-        index: test
-        id:    3
-        body:  { "foo": "bar" }
-
-  - do:
-      indices.stats:
-        metric: [ translog ]
-  - match: { indices.test.primaries.translog.operations: 3 }
-  - match: { indices.test.primaries.translog.uncommitted_operations: 3 }
-
-  - do:
-      indices.close:
-        index: test
-        wait_for_active_shards: 1
-  - is_true: acknowledged
-
-  - do:
-      indices.stats:
-        metric: [ translog ]
-        expand_wildcards: all
-        forbid_closed_indices: false
-  - match: { indices.test.primaries.translog.operations: 3 }
-  - match: { indices.test.primaries.translog.uncommitted_operations: 0 }
-
----
-"Translog stats on closed indices with soft-deletes":
-  - skip:
-      version: " - 7.3.99"
-      reason:  "start ignoring translog retention policy with soft-deletes enabled in 7.4"
+"Translog stats on closed indices":
   - do:
       indices.create:
         index: test
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
index ba1772d091b65..51796ecc89e41 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java
@@ -53,7 +53,6 @@
 import org.elasticsearch.common.ValidationException;
 import org.elasticsearch.common.compress.CompressedXContent;
 import org.elasticsearch.common.io.PathUtils;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.settings.IndexScopedSettings;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
@@ -104,7 +103,6 @@
  */
 public class MetaDataCreateIndexService {
     private static final Logger logger = LogManager.getLogger(MetaDataCreateIndexService.class);
-    private static final DeprecationLogger DEPRECATION_LOGGER = new DeprecationLogger(logger);
 
     public static final int MAX_INDEX_NAME_BYTES = 255;
 
@@ -439,10 +437,10 @@ static Settings aggregateIndexSettings(ClusterState currentState, CreateIndexClu
          * that will be used to create this index.
          */
         MetaDataCreateIndexService.checkShardLimit(indexSettings, currentState);
-        if (indexSettings.getAsBoolean(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true) == false) {
-            DEPRECATION_LOGGER.deprecatedAndMaybeLog("soft_deletes_disabled",
-                "Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions. " +
-                "Please do not specify value for setting [index.soft_deletes.enabled] of index [" + request.index() + "].");
+        if (IndexSettings.INDEX_SOFT_DELETES_SETTING.get(indexSettings) == false
+            && IndexMetaData.SETTING_INDEX_VERSION_CREATED.get(indexSettings).onOrAfter(Version.V_8_0_0)) {
+            throw new IllegalArgumentException("Creating indices with soft-deletes disabled is no longer supported. " +
+                "Please do not specify a value for setting [index.soft_deletes.enabled].");
         }
         return indexSettings;
     }
diff --git a/server/src/main/java/org/elasticsearch/index/IndexSettings.java b/server/src/main/java/org/elasticsearch/index/IndexSettings.java
index cce17b8f441e7..0ffbbedeea32e 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexSettings.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexSettings.java
@@ -227,11 +227,10 @@ public final class IndexSettings {
 
     /**
      * Specifies if the index should use soft-delete instead of hard-delete for update/delete operations.
-     * Soft-deletes is enabled by default for 7.0+ indices.
+     * Soft-deletes is enabled by default for 7.0 indices and mandatory for 8.0 indices.
      */
-    public static final Setting<Boolean> INDEX_SOFT_DELETES_SETTING = Setting.boolSetting("index.soft_deletes.enabled",
-        settings -> Boolean.toString(IndexMetaData.SETTING_INDEX_VERSION_CREATED.get(settings).onOrAfter(Version.V_7_0_0)),
-        Property.IndexScope, Property.Final);
+    public static final Setting<Boolean> INDEX_SOFT_DELETES_SETTING =
+        Setting.boolSetting("index.soft_deletes.enabled", true, Property.IndexScope, Property.Final);
 
     /**
      * Controls how many soft-deleted documents will be kept around before being merged away. Keeping more deleted
@@ -492,6 +491,7 @@ public IndexSettings(final IndexMetaData indexMetaData, final Settings nodeSetti
         mergeSchedulerConfig = new MergeSchedulerConfig(this);
         gcDeletesInMillis = scopedSettings.get(INDEX_GC_DELETES_SETTING).getMillis();
         softDeleteEnabled = scopedSettings.get(INDEX_SOFT_DELETES_SETTING);
+        assert softDeleteEnabled || version.before(Version.V_8_0_0) : "soft deletes must be enabled in version " + version;
         softDeleteRetentionOperations = scopedSettings.get(INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING);
         retentionLeaseMillis = scopedSettings.get(INDEX_SOFT_DELETES_RETENTION_LEASE_PERIOD_SETTING).millis();
         warmerEnabled = scopedSettings.get(INDEX_WARMER_ENABLED_SETTING);
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
index e90f710af0f45..416491ce31ba5 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java
@@ -779,14 +779,12 @@ public void testBuildIndexMetadata() {
 
         Settings indexSettings = Settings.builder()
             .put("index.version.created", Version.CURRENT)
-            .put(INDEX_SOFT_DELETES_SETTING.getKey(), false)
             .put(SETTING_NUMBER_OF_REPLICAS, 0)
             .put(SETTING_NUMBER_OF_SHARDS, 1)
             .build();
         List<AliasMetaData> aliases = List.of(AliasMetaData.builder("alias1").build());
         IndexMetaData indexMetaData = buildIndexMetaData("test", aliases, () -> null, indexSettings, 4, sourceIndexMetaData);
 
-        assertThat(indexMetaData.getSettings().getAsBoolean(INDEX_SOFT_DELETES_SETTING.getKey(), true), is(false));
         assertThat(indexMetaData.getAliases().size(), is(1));
         assertThat(indexMetaData.getAliases().keys().iterator().next().value, is("alias1"));
         assertThat("The source index primary term must be used", indexMetaData.primaryTerm(0), is(3L));
@@ -828,19 +826,15 @@ public void testGetIndexNumberOfRoutingShardsYieldsSourceNumberOfShards() {
         assertThat(targetRoutingNumberOfShards, is(6));
     }
 
-    public void testSoftDeletesDisabledDeprecation() {
-        request = new CreateIndexClusterStateUpdateRequest("create index", "test", "test");
-        request.settings(Settings.builder().put(INDEX_SOFT_DELETES_SETTING.getKey(), false).build());
-        aggregateIndexSettings(ClusterState.EMPTY_STATE, request, List.of(), Map.of(),
-            null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
-        assertWarnings("Creating indices with soft-deletes disabled is deprecated and will be removed in future Elasticsearch versions. "
-            + "Please do not specify value for setting [index.soft_deletes.enabled] of index [test].");
-        request = new CreateIndexClusterStateUpdateRequest("create index", "test", "test");
-        if (randomBoolean()) {
-            request.settings(Settings.builder().put(INDEX_SOFT_DELETES_SETTING.getKey(), true).build());
-        }
-        aggregateIndexSettings(ClusterState.EMPTY_STATE, request, List.of(), Map.of(),
-            null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+    public void testRejectWithSoftDeletesDisabled() {
+        final IllegalArgumentException error = expectThrows(IllegalArgumentException.class, () -> {
+            request = new CreateIndexClusterStateUpdateRequest("create index", "test", "test");
+            request.settings(Settings.builder().put(INDEX_SOFT_DELETES_SETTING.getKey(), false).build());
+            aggregateIndexSettings(ClusterState.EMPTY_STATE, request, List.of(), Map.of(),
+                null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
+        });
+        assertThat(error.getMessage(), equalTo("Creating indices with soft-deletes disabled is no longer supported. "
+            + "Please do not specify a value for setting [index.soft_deletes.enabled]."));
     }
 
     private IndexTemplateMetaData addMatchingTemplate(Consumer<IndexTemplateMetaData.Builder> configurator) {
diff --git a/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java b/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
index cf0c766972e09..67c9c3a7844bb 100644
--- a/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/ReplicaShardAllocatorIT.java
@@ -77,7 +77,6 @@ public void testPreferCopyCanPerformNoopRecovery() throws Exception {
         assertAcked(
             client().admin().indices().prepareCreate(indexName)
                 .setSettings(Settings.builder()
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1)
                     .put(IndexSettings.FILE_BASED_RECOVERY_THRESHOLD_SETTING.getKey(), 1.0f)
@@ -206,7 +205,6 @@ public void testFullClusterRestartPerformNoopRecovery() throws Exception {
         assertAcked(
             client().admin().indices().prepareCreate(indexName)
                 .setSettings(Settings.builder()
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                     .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(), randomIntBetween(10, 100) + "kb")
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, numOfReplicas)
@@ -243,7 +241,6 @@ public void testPreferCopyWithHighestMatchingOperations() throws Exception {
         assertAcked(
             client().admin().indices().prepareCreate(indexName)
                 .setSettings(Settings.builder()
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                     .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(), randomIntBetween(10, 100) + "kb")
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 1)
@@ -324,7 +321,6 @@ public void testPeerRecoveryForClosedIndices() throws Exception {
         createIndex(indexName, Settings.builder()
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
             .put(IndexService.GLOBAL_CHECKPOINT_SYNC_INTERVAL_SETTING.getKey(), "100ms")
             .put(IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(), "100ms")
             .build());
diff --git a/server/src/test/java/org/elasticsearch/index/IndexSettingsTests.java b/server/src/test/java/org/elasticsearch/index/IndexSettingsTests.java
index 1a19647ea7f78..57dfebbd231c0 100644
--- a/server/src/test/java/org/elasticsearch/index/IndexSettingsTests.java
+++ b/server/src/test/java/org/elasticsearch/index/IndexSettingsTests.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Setting.Property;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.translog.Translog;
@@ -572,38 +571,4 @@ public void testIgnoreTranslogRetentionSettingsIfSoftDeletesEnabled() {
         assertThat(indexSettings.getTranslogRetentionAge().millis(), equalTo(-1L));
         assertThat(indexSettings.getTranslogRetentionSize().getBytes(), equalTo(-1L));
     }
-
-    public void testUpdateTranslogRetentionSettingsWithSoftDeletesDisabled() {
-        Settings.Builder settings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false)
-            .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT);
-
-        TimeValue ageSetting = TimeValue.timeValueHours(12);
-        if (randomBoolean()) {
-            ageSetting = randomBoolean() ? TimeValue.MINUS_ONE : TimeValue.timeValueMillis(randomIntBetween(0, 10000));
-            settings.put(IndexSettings.INDEX_TRANSLOG_RETENTION_AGE_SETTING.getKey(), ageSetting);
-        }
-        ByteSizeValue sizeSetting = new ByteSizeValue(512, ByteSizeUnit.MB);
-        if (randomBoolean()) {
-            sizeSetting = randomBoolean() ? new ByteSizeValue(-1) : new ByteSizeValue(randomIntBetween(0, 1024));
-            settings.put(IndexSettings.INDEX_TRANSLOG_RETENTION_SIZE_SETTING.getKey(), sizeSetting);
-        }
-        IndexMetaData metaData = newIndexMeta("index", settings.build());
-        IndexSettings indexSettings = new IndexSettings(metaData, Settings.EMPTY);
-        assertThat(indexSettings.getTranslogRetentionAge(), equalTo(ageSetting));
-        assertThat(indexSettings.getTranslogRetentionSize(), equalTo(sizeSetting));
-
-        Settings.Builder newSettings = Settings.builder().put(settings.build());
-        if (randomBoolean()) {
-            ageSetting = randomBoolean() ? TimeValue.MINUS_ONE : TimeValue.timeValueMillis(randomIntBetween(0, 10000));
-            newSettings.put(IndexSettings.INDEX_TRANSLOG_RETENTION_AGE_SETTING.getKey(), ageSetting);
-        }
-        if (randomBoolean()) {
-            sizeSetting = randomBoolean() ? new ByteSizeValue(-1) : new ByteSizeValue(randomIntBetween(0, 1024));
-            newSettings.put(IndexSettings.INDEX_TRANSLOG_RETENTION_SIZE_SETTING.getKey(), sizeSetting);
-        }
-        indexSettings.updateIndexMetaData(newIndexMeta("index", newSettings.build()));
-        assertThat(indexSettings.getTranslogRetentionAge(), equalTo(ageSetting));
-        assertThat(indexSettings.getTranslogRetentionSize(), equalTo(sizeSetting));
-    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
index 2d5dc675f025b..bcf20e1fd1f0b 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
@@ -5477,8 +5477,9 @@ public long softUpdateDocuments(Term term, Iterable<? extends Iterable<? extends
         Path translogPath = createTempDir();
         List<Engine.Operation> operations = generateHistoryOnReplica(between(1, 500), randomBoolean(), randomBoolean(), randomBoolean());
         final IndexMetaData indexMetaData = IndexMetaData.builder(defaultSettings.getIndexMetaData())
-            .settings(Settings.builder().put(defaultSettings.getSettings()).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false))
-            .build();
+            .settings(Settings.builder().put(defaultSettings.getSettings())
+                .put(IndexMetaData.SETTING_VERSION_CREATED, VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0))
+                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false)).build();
         final IndexSettings indexSettings = IndexSettingsModule.newIndexSettings(indexMetaData);
         try (Store store = createStore()) {
             EngineConfig config = config(indexSettings, store, translogPath, NoMergePolicy.INSTANCE, null, null, globalCheckpoint::get);
diff --git a/server/src/test/java/org/elasticsearch/index/replication/RecoveryDuringReplicationTests.java b/server/src/test/java/org/elasticsearch/index/replication/RecoveryDuringReplicationTests.java
index 53a96e531585a..ec10e2a5e8444 100644
--- a/server/src/test/java/org/elasticsearch/index/replication/RecoveryDuringReplicationTests.java
+++ b/server/src/test/java/org/elasticsearch/index/replication/RecoveryDuringReplicationTests.java
@@ -38,7 +38,6 @@
 import org.elasticsearch.common.lucene.uid.Versions;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.core.internal.io.IOUtils;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.VersionType;
 import org.elasticsearch.index.engine.DocIdSeqNoAndSource;
@@ -108,68 +107,6 @@ public void testIndexingDuringFileRecovery() throws Exception {
         }
     }
 
-    public void testRecoveryOfDisconnectedReplica() throws Exception {
-        Settings settings = Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false).build();
-        try (ReplicationGroup shards = createGroup(1, settings)) {
-            shards.startAll();
-            int docs = shards.indexDocs(randomInt(50));
-            shards.flush();
-            final IndexShard originalReplica = shards.getReplicas().get(0);
-            for (int i = 0; i < randomInt(2); i++) {
-                final int indexedDocs = shards.indexDocs(randomInt(5));
-                docs += indexedDocs;
-
-                final boolean flush = randomBoolean();
-                if (flush) {
-                    originalReplica.flush(new FlushRequest());
-                }
-            }
-
-            // simulate a background global checkpoint sync at which point we expect the global checkpoint to advance on the replicas
-            shards.syncGlobalCheckpoint();
-            long globalCheckpointOnReplica = originalReplica.getLastSyncedGlobalCheckpoint();
-            Optional<SequenceNumbers.CommitInfo> safeCommitOnReplica =
-                originalReplica.store().findSafeIndexCommit(globalCheckpointOnReplica);
-            assertTrue(safeCommitOnReplica.isPresent());
-            shards.removeReplica(originalReplica);
-
-            final int missingOnReplica = shards.indexDocs(randomInt(5));
-            docs += missingOnReplica;
-
-            final boolean translogTrimmed;
-            if (randomBoolean()) {
-                shards.flush();
-                translogTrimmed = randomBoolean();
-                if (translogTrimmed) {
-                    final Translog translog = getTranslog(shards.getPrimary());
-                    translog.getDeletionPolicy().setRetentionAgeInMillis(0);
-                    translog.trimUnreferencedReaders();
-                }
-            } else {
-                translogTrimmed = false;
-            }
-            originalReplica.close("disconnected", false);
-            IOUtils.close(originalReplica.store());
-            final IndexShard recoveredReplica =
-                shards.addReplicaWithExistingPath(originalReplica.shardPath(), originalReplica.routingEntry().currentNodeId());
-            shards.recoverReplica(recoveredReplica);
-            if (translogTrimmed && missingOnReplica > 0) {
-                // replica has something to catch up with, but since we trimmed the primary translog, we should fall back to full recovery
-                assertThat(recoveredReplica.recoveryState().getIndex().fileDetails(), not(empty()));
-            } else {
-                assertThat(recoveredReplica.recoveryState().getIndex().fileDetails(), empty());
-                assertThat(recoveredReplica.recoveryState().getTranslog().recoveredOperations(),
-                    equalTo(Math.toIntExact(docs - 1 - safeCommitOnReplica.get().localCheckpoint)));
-                assertThat(recoveredReplica.recoveryState().getTranslog().totalLocal(),
-                    equalTo(Math.toIntExact(globalCheckpointOnReplica - safeCommitOnReplica.get().localCheckpoint)));
-            }
-
-            docs += shards.indexDocs(randomInt(5));
-
-            shards.assertAllEqual(docs);
-        }
-    }
-
     /*
      * Simulate a scenario with two replicas where one of the replicas receives an extra document, the other replica is promoted on primary
      * failure, the receiving replica misses the primary/replica re-sync and then recovers from the primary. We expect that a
diff --git a/server/src/test/java/org/elasticsearch/index/shard/IndexShardIT.java b/server/src/test/java/org/elasticsearch/index/shard/IndexShardIT.java
index 86fa8c613b628..4f90b042ebd10 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/IndexShardIT.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/IndexShardIT.java
@@ -844,7 +844,6 @@ public void testLimitNumberOfRetainedTranslogFiles() throws Exception {
         Settings.Builder settings = Settings.builder()
             .put(SETTING_NUMBER_OF_SHARDS, 1)
             .put(SETTING_NUMBER_OF_REPLICAS, 0)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false)
             .put(IndexSettings.INDEX_TRANSLOG_RETENTION_TOTAL_FILES_SETTING.getKey(), translogRetentionTotalFiles);
         if (randomBoolean()) {
             settings.put(IndexSettings.INDEX_TRANSLOG_RETENTION_SIZE_SETTING.getKey(), new ByteSizeValue(between(1, 1024 * 1024)));
diff --git a/server/src/test/java/org/elasticsearch/index/shard/IndexShardRetentionLeaseTests.java b/server/src/test/java/org/elasticsearch/index/shard/IndexShardRetentionLeaseTests.java
index 31bdfce261ad9..28995efc4be20 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/IndexShardRetentionLeaseTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/IndexShardRetentionLeaseTests.java
@@ -303,21 +303,6 @@ public void testRetentionLeaseStats() throws IOException {
         }
     }
 
-    public void testRetentionLeasesActionsFailWithSoftDeletesDisabled() throws Exception {
-        IndexShard shard = newStartedShard(true, Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false).build());
-        assertThat(expectThrows(AssertionError.class, () -> shard.addRetentionLease(randomAlphaOfLength(10),
-            randomLongBetween(SequenceNumbers.NO_OPS_PERFORMED, Long.MAX_VALUE), "test", ActionListener.wrap(() -> {}))).getMessage(),
-            equalTo("retention leases requires soft deletes but [index] does not have soft deletes enabled"));
-        assertThat(expectThrows(AssertionError.class, () -> shard.renewRetentionLease(
-            randomAlphaOfLength(10), randomLongBetween(SequenceNumbers.NO_OPS_PERFORMED, Long.MAX_VALUE), "test")).getMessage(),
-            equalTo("retention leases requires soft deletes but [index] does not have soft deletes enabled"));
-        assertThat(expectThrows(AssertionError.class, () -> shard.removeRetentionLease(
-            randomAlphaOfLength(10), ActionListener.wrap(() -> {}))).getMessage(),
-            equalTo("retention leases requires soft deletes but [index] does not have soft deletes enabled"));
-        shard.syncRetentionLeases();
-        closeShards(shard);
-    }
-
     private void assertRetentionLeases(
             final IndexShard indexShard,
             final int size,
diff --git a/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java b/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
index 6a8a63ce17f32..39f120b2fa3a3 100644
--- a/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
+++ b/server/src/test/java/org/elasticsearch/index/shard/IndexShardTests.java
@@ -2113,8 +2113,7 @@ public void testPrimaryHandOffUpdatesLocalCheckpoint() throws IOException {
         }
         IndexShardTestCase.updateRoutingEntry(primarySource,
             primarySource.routingEntry().relocate(randomAlphaOfLength(10), -1));
-        final IndexShard primaryTarget = newShard(primarySource.routingEntry().getTargetRelocatingShard(), Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), primarySource.indexSettings().isSoftDeleteEnabled()).build());
+        final IndexShard primaryTarget = newShard(primarySource.routingEntry().getTargetRelocatingShard());
         updateMappings(primaryTarget, primarySource.indexSettings().getIndexMetaData());
         recoverReplica(primaryTarget, primarySource, true);
 
@@ -2128,13 +2127,11 @@ public void testPrimaryHandOffUpdatesLocalCheckpoint() throws IOException {
 
     /* This test just verifies that we fill up local checkpoint up to max seen seqID on primary recovery */
     public void testRecoverFromStoreWithNoOps() throws IOException {
-        final Settings settings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean()).build();
-        final IndexShard shard = newStartedShard(true, settings);
+        final IndexShard shard = newStartedShard(true);
         indexDoc(shard, "_doc", "0");
         indexDoc(shard, "_doc", "1");
         // start a replica shard and index the second doc
-        final IndexShard otherShard = newStartedShard(false, settings);
+        final IndexShard otherShard = newStartedShard(false);
         updateMappings(otherShard, shard.indexSettings().getIndexMetaData());
         SourceToParse sourceToParse = new SourceToParse(shard.shardId().getIndexName(), "1",
             new BytesArray("{}"), XContentType.JSON);
@@ -2314,8 +2311,7 @@ public void testRecoveryFailsAfterMovingToRelocatedState() throws InterruptedExc
 
     public void testRestoreShard() throws IOException {
         final IndexShard source = newStartedShard(true);
-        IndexShard target = newStartedShard(true, Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), source.indexSettings().isSoftDeleteEnabled()).build());
+        IndexShard target = newStartedShard(true);
 
         indexDoc(source, "_doc", "0");
         EngineTestCase.generateNewSeqNo(source.getEngine()); // create a gap in the history
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
index 999028cb083fd..8ddb59ef5db1a 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
@@ -446,7 +446,6 @@ public void testThrowExceptionOnPrimaryRelocatedBeforePhase1Started() throws IOE
         final IndexMetaData.Builder indexMetaData = IndexMetaData.builder("test").settings(Settings.builder()
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, between(0,5))
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, between(1,5))
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
             .put(IndexMetaData.SETTING_VERSION_CREATED, VersionUtils.randomVersion(random()))
             .put(IndexMetaData.SETTING_INDEX_UUID, UUIDs.randomBase64UUID(random())));
         if (randomBoolean()) {
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/RecoveryTests.java b/server/src/test/java/org/elasticsearch/indices/recovery/RecoveryTests.java
index 05aebcc459a6e..5cadc31d7946e 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/RecoveryTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/RecoveryTests.java
@@ -28,6 +28,7 @@
 import org.apache.lucene.index.NoMergePolicy;
 import org.apache.lucene.store.AlreadyClosedException;
 import org.elasticsearch.ExceptionsHelper;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.indices.flush.FlushRequest;
 import org.elasticsearch.action.bulk.BulkShardRequest;
@@ -55,6 +56,7 @@
 import org.elasticsearch.index.store.Store;
 import org.elasticsearch.index.translog.SnapshotMatchers;
 import org.elasticsearch.index.translog.Translog;
+import org.elasticsearch.test.VersionUtils;
 
 import java.io.IOException;
 import java.util.HashMap;
@@ -132,7 +134,9 @@ public void testRecoveryWithOutOfOrderDeleteWithTranslog() throws Exception {
          * - index #5
          * - If flush and the translog retention disabled, delete #1 will be removed while index #0 is still retained and replayed.
          */
-        Settings settings = Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false).build();
+        Settings settings = Settings.builder()
+            .put(IndexMetaData.SETTING_VERSION_CREATED, VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0))
+            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false).build();
         try (ReplicationGroup shards = createGroup(1, settings)) {
             shards.startAll();
             // create out of order delete and index op on replica
diff --git a/server/src/test/java/org/elasticsearch/indices/state/OpenCloseIndexIT.java b/server/src/test/java/org/elasticsearch/indices/state/OpenCloseIndexIT.java
index c95b61f7e6a90..df908fd4f8cce 100644
--- a/server/src/test/java/org/elasticsearch/indices/state/OpenCloseIndexIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/state/OpenCloseIndexIT.java
@@ -34,7 +34,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.index.IndexNotFoundException;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.test.ESIntegTestCase;
@@ -354,8 +353,6 @@ public void testTranslogStats() throws Exception {
         createIndex(indexName, Settings.builder()
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
             .build());
-        boolean softDeletesEnabled = IndexSettings.INDEX_SOFT_DELETES_SETTING.get(
-            client().admin().indices().prepareGetSettings(indexName).get().getIndexToSettings().get(indexName));
 
         final int nbDocs = randomIntBetween(0, 50);
         int uncommittedOps = 0;
@@ -375,8 +372,8 @@ public void testTranslogStats() throws Exception {
         assertBusy(() -> {
             IndicesStatsResponse stats = client().admin().indices().prepareStats(indexName).clear().setTranslog(true).get();
             assertThat(stats.getIndex(indexName), notNullValue());
-            assertThat(stats.getIndex(indexName).getPrimaries().getTranslog().estimatedNumberOfOperations(), equalTo(
-                softDeletesEnabled ? uncommittedTranslogOps : nbDocs));
+            assertThat(stats.getIndex(indexName).getPrimaries().getTranslog().estimatedNumberOfOperations(),
+                equalTo(uncommittedTranslogOps));
             assertThat(stats.getIndex(indexName).getPrimaries().getTranslog().getUncommittedOperations(), equalTo(uncommittedTranslogOps));
         });
 
@@ -386,8 +383,7 @@ public void testTranslogStats() throws Exception {
         IndicesStatsResponse stats = client().admin().indices().prepareStats(indexName).setIndicesOptions(indicesOptions)
             .clear().setTranslog(true).get();
         assertThat(stats.getIndex(indexName), notNullValue());
-        assertThat(stats.getIndex(indexName).getPrimaries().getTranslog().estimatedNumberOfOperations(),
-            equalTo(softDeletesEnabled ? 0 : nbDocs));
+        assertThat(stats.getIndex(indexName).getPrimaries().getTranslog().estimatedNumberOfOperations(), equalTo(0));
         assertThat(stats.getIndex(indexName).getPrimaries().getTranslog().getUncommittedOperations(), equalTo(0));
     }
 }
diff --git a/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java b/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
index 7a3de4f4c977e..2a29582fdefd3 100644
--- a/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
+++ b/server/src/test/java/org/elasticsearch/recovery/RelocationIT.java
@@ -47,7 +47,6 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.env.NodeEnvironment;
 import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.seqno.ReplicationTracker;
 import org.elasticsearch.index.seqno.RetentionLease;
 import org.elasticsearch.index.shard.IndexEventListener;
@@ -627,7 +626,6 @@ public void testRelocationEstablishedPeerRecoveryRetentionLeases() throws Except
         ensureStableCluster(halfNodes * 2);
         assertAcked(
             client().admin().indices().prepareCreate(indexName).setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, randomIntBetween(0, halfNodes - 1))
                 .put("index.routing.allocation.include.color", "blue")));
         ensureGreen("test");
diff --git a/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java b/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
index 6ec344783c8f2..f2a44b766e73e 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/engine/EngineTestCase.java
@@ -184,9 +184,7 @@ protected Settings indexSettings() {
             .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
             .put(IndexSettings.MAX_REFRESH_LISTENERS_PER_SHARD.getKey(),
                 between(10, 10 * IndexSettings.MAX_REFRESH_LISTENERS_PER_SHARD.get(Settings.EMPTY)))
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
-            .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(),
-                randomBoolean() ? IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.get(Settings.EMPTY) : between(0, 1000))
+            .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), between(0, 1000))
             .build();
     }
 
diff --git a/test/framework/src/main/java/org/elasticsearch/index/replication/ESIndexLevelReplicationTestCase.java b/test/framework/src/main/java/org/elasticsearch/index/replication/ESIndexLevelReplicationTestCase.java
index c067c0717dcce..54bc1c3dfcda2 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/replication/ESIndexLevelReplicationTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/replication/ESIndexLevelReplicationTestCase.java
@@ -133,9 +133,7 @@ protected IndexMetaData buildIndexMetaData(int replicas, Settings indexSettings,
         Settings settings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, replicas)
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
-            .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(),
-                randomBoolean() ? IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.get(Settings.EMPTY) : between(0, 1000))
+            .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), between(0, 1000))
             .put(indexSettings)
             .build();
         IndexMetaData.Builder metaData = IndexMetaData.builder(index.getName())
diff --git a/test/framework/src/main/java/org/elasticsearch/index/shard/IndexShardTestCase.java b/test/framework/src/main/java/org/elasticsearch/index/shard/IndexShardTestCase.java
index d0c5bf1ca53a1..c215078635915 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/shard/IndexShardTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/shard/IndexShardTestCase.java
@@ -249,7 +249,6 @@ protected IndexShard newShard(
         Settings indexSettings = Settings.builder().put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
                 .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(),
                     randomBoolean() ? IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.get(Settings.EMPTY) : between(0, 1000))
                 .put(settings)
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESIntegTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESIntegTestCase.java
index 038efa4d4159f..dd4f937039afc 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESIntegTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESIntegTestCase.java
@@ -670,7 +670,6 @@ public Settings indexSettings() {
         }
         // always default delayed allocation to 0 to make sure we have tests are not delayed
         builder.put(UnassignedInfo.INDEX_DELAYED_NODE_LEFT_TIMEOUT_SETTING.getKey(), 0);
-        builder.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
         if (randomBoolean()) {
             builder.put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), between(0, 1000));
         }
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
index 6265dbe559fa5..79ded94250da6 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESSingleNodeTestCase.java
@@ -95,10 +95,8 @@ protected void startNode(long seed) throws Exception {
             .preparePutTemplate("random-soft-deletes-template")
             .setPatterns(Collections.singletonList("*"))
             .setOrder(0)
-            .setSettings(Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean())
-                .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(),
-                    randomBoolean() ? IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.get(Settings.EMPTY) : between(0, 1000))
-            ).get();
+            .setSettings(Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), between(0, 1000)))
+            .get();
     }
 
     private static void stopNode() throws IOException, InterruptedException {
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
index f944dd70813bc..dcbcad3b2048d 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
@@ -358,41 +358,6 @@ public void testConflictingPatterns() throws Exception {
         assertFalse(ESIntegTestCase.indexExists("copy-logs-201801", followerClient()));
     }
 
-    public void testAutoFollowSoftDeletesDisabled() throws Exception {
-        putAutoFollowPatterns("my-pattern1", new String[] {"logs-*"});
-
-        // Soft deletes are disabled:
-        Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false)
-            .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
-            .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
-            .build();
-        createLeaderIndex("logs-20200101", leaderIndexSettings);
-        assertBusy(() -> {
-            AutoFollowStats autoFollowStats = getAutoFollowStats();
-            assertThat(autoFollowStats.getNumberOfSuccessfulFollowIndices(), equalTo(0L));
-            assertThat(autoFollowStats.getNumberOfFailedFollowIndices(), equalTo(1L));
-            assertThat(autoFollowStats.getRecentAutoFollowErrors().size(), equalTo(1));
-            ElasticsearchException failure  = autoFollowStats.getRecentAutoFollowErrors().firstEntry().getValue().v2();
-            assertThat(failure.getMessage(), equalTo("index [logs-20200101] cannot be followed, " +
-                "because soft deletes are not enabled"));
-            assertFalse(ESIntegTestCase.indexExists("copy-logs-20200101", followerClient()));
-        });
-
-        // Soft deletes are enabled:
-        leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
-            .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
-            .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
-            .build();
-        createLeaderIndex("logs-20200102", leaderIndexSettings);
-        assertBusy(() -> {
-            AutoFollowStats autoFollowStats = getAutoFollowStats();
-            assertThat(autoFollowStats.getNumberOfSuccessfulFollowIndices(), equalTo(1L));
-            assertTrue(ESIntegTestCase.indexExists("copy-logs-20200102", followerClient()));
-        });
-    }
-
     public void testPauseAndResumeAutoFollowPattern() throws Exception {
         final Settings leaderIndexSettings = Settings.builder()
             .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/LocalIndexFollowingIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/LocalIndexFollowingIT.java
index 3a52950d1788b..b623be7ccbe0c 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/LocalIndexFollowingIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/LocalIndexFollowingIT.java
@@ -13,7 +13,6 @@
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexSettings;
-import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.xpack.CcrSingleNodeTestCase;
 import org.elasticsearch.xpack.core.ccr.action.CcrStatsAction;
 import org.elasticsearch.xpack.core.ccr.action.FollowStatsAction;
@@ -78,21 +77,6 @@ public void testFollowIndex() throws Exception {
         ensureEmptyWriteBuffers();
     }
 
-    public void testDoNotCreateFollowerIfLeaderDoesNotHaveSoftDeletes() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(2, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "false"));
-        assertAcked(client().admin().indices().prepareCreate("leader-index").setSource(leaderIndexSettings, XContentType.JSON));
-        ResumeFollowAction.Request followRequest = getResumeFollowRequest("follower");
-        followRequest.setFollowerIndex("follower-index");
-        PutFollowAction.Request putFollowRequest = getPutFollowRequest("leader", "follower");
-        putFollowRequest.setLeaderIndex("leader-index");
-        putFollowRequest.setFollowerIndex("follower-index");
-        IllegalArgumentException error = expectThrows(IllegalArgumentException.class,
-            () -> client().execute(PutFollowAction.INSTANCE, putFollowRequest).actionGet());
-        assertThat(error.getMessage(), equalTo("leader index [leader-index] does not have soft deletes enabled"));
-        assertThat(ESIntegTestCase.indexExists("follower-index", client()), equalTo(false));
-    }
-
     public void testRemoveRemoteConnection() throws Exception {
         PutAutoFollowPatternAction.Request request = new PutAutoFollowPatternAction.Request();
         request.setName("my_pattern");

From 60e4bcd02d36ec529f5b8c5707877eb99d7f59a7 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sat, 18 Jan 2020 11:09:22 -0800
Subject: [PATCH 653/686] Adding Elastic Exception

---
 .../java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java  | 3 ++-
 .../java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java   | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
index c5bdb620ddcca..01aa3125706e2 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/CloseIndexStep.java
@@ -6,6 +6,7 @@
 
 package org.elasticsearch.xpack.core.ilm;
 
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.indices.close.CloseIndexRequest;
 import org.elasticsearch.client.Client;
@@ -32,7 +33,7 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
             getClient().admin().indices()
                 .close(request, ActionListener.wrap(closeIndexResponse -> {
                     if (closeIndexResponse.isAcknowledged() == false) {
-                       new ErrorStep(getKey());
+                        throw new ElasticsearchException("close index request failed to be acknowledged");
                     }
                     listener.onResponse(true);
                 }, listener::onFailure));
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
index 86e58815712d7..56cd50025def3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/OpenIndexStep.java
@@ -6,6 +6,7 @@
 
 package org.elasticsearch.xpack.core.ilm;
 
+import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.indices.open.OpenIndexRequest;
 import org.elasticsearch.client.Client;
@@ -34,7 +35,7 @@ public void performAction(IndexMetaData indexMetaData, ClusterState currentClust
                 .open(request,
                     ActionListener.wrap(openIndexResponse -> {
                         if (openIndexResponse.isAcknowledged() == false) {
-                            new ErrorStep(getKey());
+                            throw new ElasticsearchException("open index request failed to be acknowledged");
                         }
                         listener.onResponse(true);
                     }, listener::onFailure));

From 181b5d30e2f33fd5ee4d009b0b9eaafd71a82cc5 Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Mon, 20 Jan 2020 15:23:07 +1100
Subject: [PATCH 654/686] Bump docs test suite timeout to 40min (#51200)

The docs test suite is still timing out on CI at 35 minutes, so
pushing it to 40 minutes while we determine the cause of the slowdown.

Relates: #49753
---
 .../elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java b/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
index bd35630d2c7fd..99ac21ae3e9b7 100644
--- a/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
+++ b/docs/src/test/java/org/elasticsearch/smoketest/DocsClientYamlTestSuiteIT.java
@@ -58,8 +58,8 @@
 import static org.elasticsearch.common.xcontent.ConstructingObjectParser.constructorArg;
 
 //The default 20 minutes timeout isn't always enough, please do not increase further than 30 before analyzing what makes this suite so slow
-// gh#49753 increasing timeout to 35 minutes until this gets fixes properly
-@TimeoutSuite(millis = 35 * TimeUnits.MINUTE)
+// gh#49753, tv#49753 : increasing timeout to 40 minutes until this gets fixes properly
+@TimeoutSuite(millis = 40 * TimeUnits.MINUTE)
 public class DocsClientYamlTestSuiteIT extends ESClientYamlSuiteTestCase {
 
     public DocsClientYamlTestSuiteIT(@Name("yaml") ClientYamlTestCandidate testCandidate) {

From 76427effd1859ab21196921a75c43c55658722ff Mon Sep 17 00:00:00 2001
From: Tim Vernum <tim.vernum@elastic.co>
Date: Mon, 20 Jan 2020 16:31:44 +1100
Subject: [PATCH 655/686] Mute TimeSeriesLifecycleActionsIT.waitForSnapshot
 (#51203)

This test was recently un-muted, but is still failing

Relates: #50781
---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index e33a413f9f208..22a98c09c925b 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -326,6 +326,7 @@ public void testAllocateActionOnlyReplicas() throws Exception {
         });
     }
 
+    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/50781")
     public void testWaitForSnapshot() throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));

From f52ffb4915dacd8d36c8bfbc3217ec4f7005768c Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Sun, 19 Jan 2020 23:29:34 -0800
Subject: [PATCH 656/686] Fixing broken tests

---
 .../xpack/ilm/action/TransportPutLifecycleActionTests.java      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java
index f2f67fa281f90..a771ef533c860 100644
--- a/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java
+++ b/x-pack/plugin/ilm/src/test/java/org/elasticsearch/xpack/ilm/action/TransportPutLifecycleActionTests.java
@@ -148,7 +148,7 @@ public void testReadStepKeys() {
                 new Step.StepKey("phase", "set_priority", SetPriorityAction.NAME)));
 
         Map<String, LifecycleAction> actions = new HashMap<>();
-        actions.put("forcemerge", new ForceMergeAction(5));
+        actions.put("forcemerge", new ForceMergeAction(5, null));
         actions.put("freeze", new FreezeAction());
         actions.put("allocate", new AllocateAction(1, null, null, null));
         PhaseExecutionInfo pei = new PhaseExecutionInfo("policy", new Phase("wonky", TimeValue.ZERO, actions), 1, 1);

From 60ec6518b2660f4137abee64dff34d5c91925b35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Mon, 20 Jan 2020 09:42:04 +0100
Subject: [PATCH 657/686] [DOCS] Removes CCS limitation item from Transforms
 limitations. (#51151)

---
 docs/reference/transform/limitations.asciidoc | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/docs/reference/transform/limitations.asciidoc b/docs/reference/transform/limitations.asciidoc
index 463f66f24e3e5..7b2b29c027288 100644
--- a/docs/reference/transform/limitations.asciidoc
+++ b/docs/reference/transform/limitations.asciidoc
@@ -51,13 +51,6 @@ the API. If you try to create one, the UI will fail to show the source index
 table.
 
 
-[float]
-[[transform-ccs-limitations]]
-==== {ccs-cap} is not supported
-
-{ccs-cap} is not supported for {transforms}.
-
-
 [float]
 [[transform-kibana-limitations]]
 ==== Up to 1,000 {transforms} are supported

From 875daa74118fb97ede182412a43348140d99719b Mon Sep 17 00:00:00 2001
From: Jess <13388033+liebeslied@users.noreply.github.com>
Date: Mon, 20 Jan 2020 10:29:36 +0100
Subject: [PATCH 658/686] =?UTF-8?q?[Docs]=C2=A0Small=20edits=20to=20Rankin?=
 =?UTF-8?q?g=20Evaluation=20API=20docs=20(#51116)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Small updates to grammar, syntax, and unclear wordings.
---
 docs/reference/search/rank-eval.asciidoc | 82 ++++++++++++------------
 1 file changed, 41 insertions(+), 41 deletions(-)

diff --git a/docs/reference/search/rank-eval.asciidoc b/docs/reference/search/rank-eval.asciidoc
index 43e500e9152d6..57488f2459516 100644
--- a/docs/reference/search/rank-eval.asciidoc
+++ b/docs/reference/search/rank-eval.asciidoc
@@ -23,7 +23,7 @@ _precision_ or _discounted cumulative gain_.
 
 Search quality evaluation starts with looking at the users of your search 
 application, and the things that they are searching for. Users have a specific 
-_information need_, for example they are looking for gift in a web shop or want 
+_information need_; for example, they are looking for gift in a web shop or want 
 to book a flight for their next holiday. They usually enter some search terms 
 into a search box or some other web form. All of this information, together with 
 meta information about the user (for example the browser, location, earlier 
@@ -31,21 +31,21 @@ preferences and so on) then gets translated into a query to the underlying
 search system.
 
 The challenge for search engineers is to tweak this translation process from 
-user entries to a concrete query in such a way, that the search results contain 
-the most relevant information with respect to the users information need. This 
+user entries to a concrete query, in such a way that the search results contain 
+the most relevant information with respect to the user's information need. This 
 can only be done if the search result quality is evaluated constantly across a 
 representative test suite of typical user queries, so that improvements in the 
-rankings for one particular query doesn't negatively effect the ranking for 
+rankings for one particular query don't negatively affect the ranking for 
 other types of queries.
 
-In order to get started with search quality evaluation, three basic things are 
-needed:
+In order to get started with search quality evaluation, you need three basic
+things:
 
 . A collection of documents you want to evaluate your query performance against, 
   usually one or more indices.
 . A collection of typical search requests that users enter into your system.
-. A set of document ratings that judge the documents relevance with respect to a 
-  search request.
+. A set of document ratings that represent the documents' relevance with respect
+  to a search request.
   
 It is important to note that one set of document ratings is needed per test 
 query, and that the relevance judgements are based on the information need of 
@@ -53,7 +53,7 @@ the user that entered the query.
 
 The ranking evaluation API provides a convenient way to use this information in 
 a ranking evaluation request to calculate different search evaluation metrics. 
-This gives a first estimation of your overall search quality and give you a 
+This gives you a first estimation of your overall search quality, as well as a 
 measurement to optimize against when fine-tuning various aspect of the query 
 generation in your application.
 
@@ -133,26 +133,26 @@ GET /my_index/_rank_eval
 -----------------------------
 // NOTCONSOLE
 
-<1> the search requests id, used to group result details later 
+<1> the search request's id, used to group result details later 
 <2> the query that is being evaluated
-<3> a list of document ratings, each entry containing the documents `_index` and 
-`_id` together with the rating of the documents relevance with regards to this 
+<3> a list of document ratings, each entry containing the document's `_index` and 
+`_id` together with the rating of the document's relevance with regard to this 
 search request
 
 A document `rating` can be any integer value that expresses the relevance of the 
-document on a user defined scale. For some of the metrics, just giving a binary 
+document on a user-defined scale. For some of the metrics, just giving a binary 
 rating (for example `0` for irrelevant and `1` for relevant) will be sufficient, 
-other metrics can use a more fine grained scale.
+while other metrics can use a more fine-grained scale.
 
 
-===== Template based ranking evaluation
+===== Template-based ranking evaluation
 
 As an alternative to having to provide a single query per test request, it is 
 possible to specify query templates in the evaluation request and later refer to 
-them. Queries with similar structure that only differ in their parameters don't 
-have to be repeated all the time in the `requests` section this way. In typical 
-search systems where user inputs usually get filled into a small set of query 
-templates, this helps making the evaluation request more succinct.
+them. This way, queries with a similar structure that differ only in their 
+parameters don't have to be repeated all the time in the `requests` section. 
+In typical search systems, where user inputs usually get filled into a small 
+set of query templates, this helps make the evaluation request more succinct.
 
 [source,js]
 --------------------------------
@@ -194,27 +194,27 @@ GET /my_index/_rank_eval
 
 ===== Available evaluation metrics
 
-The `metric` section determines which of the available evaluation metrics is 
-going to be used. The following metrics are supported:
+The `metric` section determines which of the available evaluation metrics 
+will be used. The following metrics are supported:
 
 [float]
 [[k-precision]]
 ===== Precision at K (P@k)
 
 This metric measures the number of relevant results in the top k search results. 
-Its a form of the well known 
+It's a form of the well-known 
 https://en.wikipedia.org/wiki/Information_retrieval#Precision[Precision] metric 
 that only looks at the top k documents. It is the fraction of relevant documents 
-in those first k search. A precision at 10 (P@10) value of 0.6 then means six 
-out of the 10 top hits are relevant with respect to the users information need.
+in those first k results. A precision at 10 (P@10) value of 0.6 then means six 
+out of the 10 top hits are relevant with respect to the user's information need.
 
 P@k works well as a simple evaluation metric that has the benefit of being easy 
-to understand and explain. Documents in the collection need to be rated either 
-as relevant or irrelevant with respect to the current query. P@k does not take 
-into account where in the top k results the relevant documents occur, so a 
-ranking of ten results that contains one relevant result in position 10 is 
-equally good as a ranking of ten results that contains one relevant result in 
-position 1.
+to understand and explain. Documents in the collection need to be rated as either 
+relevant or irrelevant with respect to the current query. P@k does not take 
+into account the position of the relevant documents within the top k results, 
+so a ranking of ten results that contains one relevant result in position 10 is 
+equally as good as a ranking of ten results that contains one relevant result  
+in position 1.
 
 [source,console]
 --------------------------------
@@ -255,7 +255,7 @@ If set to 'true', unlabeled documents are ignored and neither count as relevant
 ===== Mean reciprocal rank
 
 For every query in the test suite, this metric calculates the reciprocal of the 
-rank of the first relevant document. For example finding the first relevant 
+rank of the first relevant document. For example, finding the first relevant 
 result in position 3 means the reciprocal rank is 1/3. The reciprocal rank for 
 each query is averaged across all queries in the test suite to give the 
 https://en.wikipedia.org/wiki/Mean_reciprocal_rank[mean reciprocal rank].
@@ -297,7 +297,7 @@ in the query. Defaults to 10.
 
 In contrast to the two metrics above, 
 https://en.wikipedia.org/wiki/Discounted_cumulative_gain[discounted cumulative gain] 
-takes both, the rank and the rating of the search results, into account.
+takes both the rank and the rating of the search results into account.
 
 The assumption is that highly relevant documents are more useful for the user 
 when appearing at the top of the result list. Therefore, the DCG formula reduces 
@@ -346,16 +346,16 @@ http://olivier.chapelle.cc/pub/err.pdf[Expected reciprocal rank for graded relev
 It is based on the assumption of a cascade model of search, in which a user 
 scans through ranked search results in order and stops at the first document 
 that satisfies the information need. For this reason, it is a good metric for 
-question answering and navigation queries, but less so for survey oriented 
+question answering and navigation queries, but less so for survey-oriented 
 information needs where the user is interested in finding many relevant 
 documents in the top k results.
 
 The metric models the expectation of the reciprocal of the position at which a 
-user stops reading through the result list. This means that relevant document in 
-top ranking positions will contribute much to the overall score. However, the 
-same document will contribute much less to the score if it appears in a lower 
-rank, even more so if there are some relevant (but maybe less relevant) 
-documents preceding it. In this way, the ERR metric discounts documents which 
+user stops reading through the result list. This means that a relevant document
+in a top ranking position will have a large contribution to the overall score. 
+However, the same document will contribute much less to the score if it appears 
+in a lower rank; even more so if there are some relevant (but maybe less relevant) 
+documents preceding it. In this way, the ERR metric discounts documents that 
 are shown after very relevant documents. This introduces a notion of dependency 
 in the ordering of relevant documents that e.g. Precision or DCG don't account 
 for.
@@ -385,7 +385,7 @@ The `expected_reciprocal_rank` metric takes the following parameters:
 [cols="<,<",options="header",]
 |=======================================================================
 |Parameter |Description
-| `maximum_relevance` | Mandatory parameter. The highest relevance grade used in the user supplied
+| `maximum_relevance` | Mandatory parameter. The highest relevance grade used in the user-supplied
 relevance judgments.
 |`k` | sets the maximum number of documents retrieved per query. This value will act in place of the usual `size` parameter
 in the query. Defaults to 10.
@@ -444,6 +444,6 @@ potential errors of individual queries. The response has the following format:
 <3> the `metric_score` in the `details` section shows the contribution of this query to the global quality metric score
 <4> the `unrated_docs` section contains an `_index` and `_id` entry for each document in the search result for this
 query that didn't have a ratings value. This can be used to ask the user to supply ratings for these documents
-<5> the `hits` section shows a grouping of the search results with their supplied rating
+<5> the `hits` section shows a grouping of the search results with their supplied ratings
 <6> the `metric_details` give additional information about the calculated quality metric (e.g. how many of the retrieved
-documents where relevant). The content varies for each metric but allows for better interpretation of the results
+documents were relevant). The content varies for each metric but allows for better interpretation of the results

From 559617b79332b9fb2c85f7df95daa9894aea2c43 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 20 Jan 2020 10:32:21 +0100
Subject: [PATCH 659/686] Add CoolDown Period to S3 Repository (#51074)

Add cool down period after snapshot finalization and delete to prevent eventually consistent AWS S3 from corrupting shard level metadata as long as the repository is using the old format metadata on the shard level.
---
 .../repositories/s3/S3Repository.java         | 116 +++++++++++++++++-
 .../s3/S3BlobStoreRepositoryTests.java        |  54 ++++++++
 2 files changed, 169 insertions(+), 1 deletion(-)

diff --git a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3Repository.java b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3Repository.java
index db6968ea71059..91b5dfeb5f546 100644
--- a/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3Repository.java
+++ b/plugins/repository-s3/src/main/java/org/elasticsearch/repositories/s3/S3Repository.java
@@ -21,6 +21,9 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.ActionRunnable;
+import org.elasticsearch.cluster.metadata.MetaData;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.Strings;
@@ -29,11 +32,23 @@
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
 import org.elasticsearch.monitor.jvm.JvmInfo;
 import org.elasticsearch.repositories.RepositoryException;
+import org.elasticsearch.repositories.ShardGenerations;
 import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
-
+import org.elasticsearch.snapshots.SnapshotId;
+import org.elasticsearch.snapshots.SnapshotInfo;
+import org.elasticsearch.snapshots.SnapshotShardFailure;
+import org.elasticsearch.snapshots.SnapshotsService;
+import org.elasticsearch.threadpool.Scheduler;
+import org.elasticsearch.threadpool.ThreadPool;
+
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Function;
 
 /**
@@ -126,6 +141,23 @@ class S3Repository extends BlobStoreRepository {
 
     static final Setting<String> CLIENT_NAME = new Setting<>("client", "default", Function.identity());
 
+    /**
+     * Artificial delay to introduce after a snapshot finalization or delete has finished so long as the repository is still using the
+     * backwards compatible snapshot format from before
+     * {@link org.elasticsearch.snapshots.SnapshotsService#SHARD_GEN_IN_REPO_DATA_VERSION} ({@link org.elasticsearch.Version#V_7_6_0}).
+     * This delay is necessary so that the eventually consistent nature of AWS S3 does not randomly result in repository corruption when
+     * doing repository operations in rapid succession on a repository in the old metadata format.
+     * This setting should not be adjusted in production when working with an AWS S3 backed repository. Doing so risks the repository
+     * becoming silently corrupted. To get rid of this waiting period, either create a new S3 repository or remove all snapshots older than
+     * {@link org.elasticsearch.Version#V_7_6_0} from the repository which will trigger an upgrade of the repository metadata to the new
+     * format and disable the cooldown period.
+     */
+    static final Setting<TimeValue> COOLDOWN_PERIOD = Setting.timeSetting(
+        "cooldown_period",
+        new TimeValue(3, TimeUnit.MINUTES),
+        new TimeValue(0, TimeUnit.MILLISECONDS),
+        Setting.Property.Dynamic);
+
     /**
      * Specifies the path within bucket to repository data. Defaults to root directory.
      */
@@ -145,6 +177,12 @@ class S3Repository extends BlobStoreRepository {
 
     private final String cannedACL;
 
+    /**
+     * Time period to delay repository operations by after finalizing or deleting a snapshot.
+     * See {@link #COOLDOWN_PERIOD} for details.
+     */
+    private final TimeValue coolDown;
+
     /**
      * Constructs an s3 backed repository
      */
@@ -176,6 +214,8 @@ class S3Repository extends BlobStoreRepository {
         this.storageClass = STORAGE_CLASS_SETTING.get(metadata.settings());
         this.cannedACL = CANNED_ACL_SETTING.get(metadata.settings());
 
+        coolDown = COOLDOWN_PERIOD.get(metadata.settings());
+
         logger.debug(
                 "using bucket [{}], chunk_size [{}], server_side_encryption [{}], buffer_size [{}], cannedACL [{}], storageClass [{}]",
                 bucket,
@@ -186,6 +226,70 @@ class S3Repository extends BlobStoreRepository {
                 storageClass);
     }
 
+    /**
+     * Holds a reference to delayed repository operation {@link Scheduler.Cancellable} so it can be cancelled should the repository be
+     * closed concurrently.
+     */
+    private final AtomicReference<Scheduler.Cancellable> finalizationFuture = new AtomicReference<>();
+
+    @Override
+    public void finalizeSnapshot(SnapshotId snapshotId, ShardGenerations shardGenerations, long startTime, String failure, int totalShards,
+                                 List<SnapshotShardFailure> shardFailures, long repositoryStateId, boolean includeGlobalState,
+                                 MetaData clusterMetaData, Map<String, Object> userMetadata, boolean writeShardGens,
+                                 ActionListener<SnapshotInfo> listener) {
+        if (writeShardGens == false) {
+            listener = delayedListener(listener);
+        }
+        super.finalizeSnapshot(snapshotId, shardGenerations, startTime, failure, totalShards, shardFailures, repositoryStateId,
+            includeGlobalState, clusterMetaData, userMetadata, writeShardGens, listener);
+    }
+
+    @Override
+    public void deleteSnapshot(SnapshotId snapshotId, long repositoryStateId, boolean writeShardGens, ActionListener<Void> listener) {
+        if (writeShardGens == false) {
+            listener = delayedListener(listener);
+        }
+        super.deleteSnapshot(snapshotId, repositoryStateId, writeShardGens, listener);
+    }
+
+    /**
+     * Wraps given listener such that it is executed with a delay of {@link #coolDown} on the snapshot thread-pool after being invoked.
+     * See {@link #COOLDOWN_PERIOD} for details.
+     */
+    private <T> ActionListener<T> delayedListener(ActionListener<T> listener) {
+        final ActionListener<T> wrappedListener = ActionListener.runBefore(listener, () -> {
+            final Scheduler.Cancellable cancellable = finalizationFuture.getAndSet(null);
+            assert cancellable != null;
+        });
+        return new ActionListener<>() {
+            @Override
+            public void onResponse(T response) {
+                logCooldownInfo();
+                final Scheduler.Cancellable existing = finalizationFuture.getAndSet(
+                    threadPool.schedule(ActionRunnable.wrap(wrappedListener, l -> l.onResponse(response)),
+                        coolDown, ThreadPool.Names.SNAPSHOT));
+                assert existing == null : "Already have an ongoing finalization " + finalizationFuture;
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                logCooldownInfo();
+                final Scheduler.Cancellable existing = finalizationFuture.getAndSet(
+                    threadPool.schedule(ActionRunnable.wrap(wrappedListener, l -> l.onFailure(e)), coolDown, ThreadPool.Names.SNAPSHOT));
+                assert existing == null : "Already have an ongoing finalization " + finalizationFuture;
+            }
+        };
+    }
+
+    private void logCooldownInfo() {
+        logger.info("Sleeping for [{}] after modifying repository [{}] because it contains snapshots older than version [{}]" +
+                " and therefore is using a backwards compatible metadata format that requires this cooldown period to avoid " +
+                "repository corruption. To get rid of this message and move to the new repository metadata format, either remove " +
+                "all snapshots older than version [{}] from the repository or create a new repository at an empty location.",
+            coolDown, metadata.name(), SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION,
+            SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION);
+    }
+
     private static BlobPath buildBasePath(RepositoryMetaData metadata) {
         final String basePath = BASE_PATH_SETTING.get(metadata.settings());
         if (Strings.hasLength(basePath)) {
@@ -210,4 +314,14 @@ protected BlobStore getBlobStore() {
     protected ByteSizeValue chunkSize() {
         return chunkSize;
     }
+
+    @Override
+    protected void doClose() {
+        final Scheduler.Cancellable cancellable = finalizationFuture.getAndSet(null);
+        if (cancellable != null) {
+            logger.debug("Repository [{}] closed during cool-down period", metadata.name());
+            cancellable.cancel();
+        }
+        super.doClose();
+    }
 }
diff --git a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreRepositoryTests.java b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreRepositoryTests.java
index 3c26c99f8a528..f4f4990d1c5b4 100644
--- a/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreRepositoryTests.java
+++ b/plugins/repository-s3/src/test/java/org/elasticsearch/repositories/s3/S3BlobStoreRepositoryTests.java
@@ -22,30 +22,48 @@
 import com.sun.net.httpserver.HttpExchange;
 import com.sun.net.httpserver.HttpHandler;
 import fixture.s3.S3HttpHandler;
+import org.elasticsearch.action.ActionRunnable;
+import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.cluster.metadata.RepositoryMetaData;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.SuppressForbidden;
 import org.elasticsearch.common.blobstore.BlobContainer;
 import org.elasticsearch.common.blobstore.BlobPath;
 import org.elasticsearch.common.blobstore.BlobStore;
+import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.MockSecureSettings;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.ByteSizeUnit;
+import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentFactory;
 import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.repositories.RepositoriesService;
+import org.elasticsearch.repositories.RepositoryData;
+import org.elasticsearch.repositories.blobstore.BlobStoreRepository;
 import org.elasticsearch.repositories.blobstore.ESMockAPIBasedRepositoryIntegTestCase;
+import org.elasticsearch.snapshots.SnapshotId;
+import org.elasticsearch.snapshots.SnapshotsService;
 import org.elasticsearch.snapshots.mockstore.BlobStoreWrapper;
+import org.elasticsearch.threadpool.ThreadPool;
 
+import java.io.IOException;
+import java.io.InputStream;
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
 
+import static org.hamcrest.Matchers.greaterThan;
+import static org.hamcrest.Matchers.lessThan;
+
 @SuppressForbidden(reason = "this test uses a HttpServer to emulate an S3 endpoint")
 public class S3BlobStoreRepositoryTests extends ESMockAPIBasedRepositoryIntegTestCase {
 
+    private static final TimeValue TEST_COOLDOWN_PERIOD = TimeValue.timeValueSeconds(5L);
+
     @Override
     protected String repositoryType() {
         return S3Repository.TYPE;
@@ -82,6 +100,7 @@ protected Settings nodeSettings(int nodeOrdinal) {
         secureSettings.setString(S3ClientSettings.SECRET_KEY_SETTING.getConcreteSettingForNamespace("test").getKey(), "secret");
 
         return Settings.builder()
+            .put(ThreadPool.ESTIMATED_TIME_INTERVAL_SETTING.getKey(), 0) // We have tests that verify an exact wait time
             .put(S3ClientSettings.ENDPOINT_SETTING.getConcreteSettingForNamespace("test").getKey(), httpServerUrl())
             // Disable chunked encoding as it simplifies a lot the request parsing on the httpServer side
             .put(S3ClientSettings.DISABLE_CHUNKED_ENCODING.getConcreteSettingForNamespace("test").getKey(), true)
@@ -92,6 +111,41 @@ protected Settings nodeSettings(int nodeOrdinal) {
             .build();
     }
 
+    public void testEnforcedCooldownPeriod() throws IOException {
+        final String repoName = createRepository(randomName(), Settings.builder().put(repositorySettings())
+            .put(S3Repository.COOLDOWN_PERIOD.getKey(), TEST_COOLDOWN_PERIOD).build());
+
+        final SnapshotId fakeOldSnapshot = client().admin().cluster().prepareCreateSnapshot(repoName, "snapshot-old")
+            .setWaitForCompletion(true).setIndices().get().getSnapshotInfo().snapshotId();
+        final RepositoriesService repositoriesService = internalCluster().getCurrentMasterNodeInstance(RepositoriesService.class);
+        final BlobStoreRepository repository = (BlobStoreRepository) repositoriesService.repository(repoName);
+        final RepositoryData repositoryData =
+            PlainActionFuture.get(f -> repository.threadPool().generic().execute(() -> repository.getRepositoryData(f)));
+        final RepositoryData modifiedRepositoryData = repositoryData.withVersions(Collections.singletonMap(fakeOldSnapshot,
+            SnapshotsService.SHARD_GEN_IN_REPO_DATA_VERSION.minimumCompatibilityVersion()));
+        final BytesReference serialized =
+            BytesReference.bytes(modifiedRepositoryData.snapshotsToXContent(XContentFactory.jsonBuilder(), false));
+        PlainActionFuture.get(f -> repository.threadPool().generic().execute(ActionRunnable.run(f, () -> {
+            try (InputStream stream = serialized.streamInput()) {
+                repository.blobStore().blobContainer(repository.basePath()).writeBlobAtomic(
+                    BlobStoreRepository.INDEX_FILE_PREFIX + modifiedRepositoryData.getGenId(), stream, serialized.length(), true);
+            }
+        })));
+
+        final String newSnapshotName = "snapshot-new";
+        final long beforeThrottledSnapshot = repository.threadPool().relativeTimeInNanos();
+        client().admin().cluster().prepareCreateSnapshot(repoName, newSnapshotName).setWaitForCompletion(true).setIndices().get();
+        assertThat(repository.threadPool().relativeTimeInNanos() - beforeThrottledSnapshot, greaterThan(TEST_COOLDOWN_PERIOD.getNanos()));
+
+        final long beforeThrottledDelete = repository.threadPool().relativeTimeInNanos();
+        client().admin().cluster().prepareDeleteSnapshot(repoName, newSnapshotName).get();
+        assertThat(repository.threadPool().relativeTimeInNanos() - beforeThrottledDelete, greaterThan(TEST_COOLDOWN_PERIOD.getNanos()));
+
+        final long beforeFastDelete = repository.threadPool().relativeTimeInNanos();
+        client().admin().cluster().prepareDeleteSnapshot(repoName, fakeOldSnapshot.getName()).get();
+        assertThat(repository.threadPool().relativeTimeInNanos() - beforeFastDelete, lessThan(TEST_COOLDOWN_PERIOD.getNanos()));
+    }
+
     /**
      * S3RepositoryPlugin that allows to disable chunked encoding and to set a low threshold between single upload and multipart upload.
      */

From 9cab6e8abc75a698a4e9d4fb2a157276177dec76 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Mon, 20 Jan 2020 11:11:57 +0100
Subject: [PATCH 660/686] [DOCS] Expands the documentation of Node Query Cache
 (#51105)

Co-authored-by: debadair <debadair@elastic.co>
---
 .../modules/indices/query_cache.asciidoc      | 25 ++++++++++++-------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/docs/reference/modules/indices/query_cache.asciidoc b/docs/reference/modules/indices/query_cache.asciidoc
index b61c2a6eee046..9b1736096f6f3 100644
--- a/docs/reference/modules/indices/query_cache.asciidoc
+++ b/docs/reference/modules/indices/query_cache.asciidoc
@@ -1,27 +1,34 @@
 [[query-cache]]
 === Node Query Cache
 
-The query cache is responsible for caching the results of queries.
-There is one queries cache per node that is shared by all shards.
-The cache implements an LRU eviction policy: when a cache becomes full, the
-least recently used data is evicted to make way for new data.
-It is not possible to look at the contents being cached.
+The results of queries used in the filter context are cached in the node query 
+cache for fast lookup. There is one queries cache per node that is shared by all 
+shards. The cache uses an LRU eviction policy: when the cache is full, the least 
+recently used query results are evicted to make way for new data. You cannot 
+inspect the contents of the query cache.
 
-The query cache only caches queries which are being used in a filter context.
+Term queries and queries used outside of a filter context are not eligible for 
+caching.
+
+By default, the cache holds a maximum of 10000 queries in up to 10% of the total 
+heap space. To determine if a query is eligible for caching, {es} maintains a 
+query history to track occurrences.
+
+Caching is done on a per segment basis if a segment contains at least 10000 
+documents and the segment has at least 3% of the total documents of a shard. 
+Because caching is per segment, merging segments can invalidate cached queries.
 
 The following setting is _static_ and must be configured on every data node in
 the cluster:
 
 `indices.queries.cache.size`::
-
     Controls the memory size for the filter cache , defaults to `10%`. Accepts
     either a percentage value, like `5%`, or an exact value, like `512mb`.
 
-The following setting is an _index_ setting that can be configured on a
+The following setting is an _index_ setting that can be configured on a 
 per-index basis. Can only be set at index creation time or on a
 <<indices-open-close,closed index>>:
 
 `index.queries.cache.enabled`::
-
     Controls whether to enable query caching. Accepts `true` (default) or
     `false`.

From c31d60e04432a4c855bf55906f19243ef3c58961 Mon Sep 17 00:00:00 2001
From: zacharymorn <zacharymorn@gmail.com>
Date: Mon, 20 Jan 2020 02:53:38 -0800
Subject: [PATCH 661/686] Exclude unmapped fields from query max_clause limit
 (#49523)

Take into account of number of unmapped fields when calculating against limit.
Closes #49002
---
 .../index/search/QueryParserHelper.java       |  7 ++---
 .../search/query/QueryStringIT.java           | 29 +++++++++++++++++++
 2 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/search/QueryParserHelper.java b/server/src/main/java/org/elasticsearch/index/search/QueryParserHelper.java
index e4b397c9a538b..768d017974e2f 100644
--- a/server/src/main/java/org/elasticsearch/index/search/QueryParserHelper.java
+++ b/server/src/main/java/org/elasticsearch/index/search/QueryParserHelper.java
@@ -87,8 +87,8 @@ public static Map<String, Float> resolveMappingFields(QueryShardContext context,
             boolean allField = Regex.isMatchAllPattern(fieldEntry.getKey());
             boolean multiField = Regex.isSimpleMatchPattern(fieldEntry.getKey());
             float weight = fieldEntry.getValue() == null ? 1.0f : fieldEntry.getValue();
-            Map<String, Float> fieldMap = resolveMappingField(context, fieldEntry.getKey(), weight,
-                !multiField, !allField, fieldSuffix);
+            Map<String, Float> fieldMap = resolveMappingField(context, fieldEntry.getKey(), weight, !multiField, !allField, fieldSuffix);
+
             for (Map.Entry<String, Float> field : fieldMap.entrySet()) {
                 float boost = field.getValue();
                 if (resolvedFields.containsKey(field.getKey())) {
@@ -97,6 +97,7 @@ public static Map<String, Float> resolveMappingFields(QueryShardContext context,
                 resolvedFields.put(field.getKey(), boost);
             }
         }
+
         checkForTooManyFields(resolvedFields, context);
         return resolvedFields;
     }
@@ -141,8 +142,6 @@ public static Map<String, Float> resolveMappingField(QueryShardContext context,
 
             MappedFieldType fieldType = context.getMapperService().fullName(fieldName);
             if (fieldType == null) {
-                // Note that we don't ignore unmapped fields.
-                fields.put(fieldName, weight);
                 continue;
             }
 
diff --git a/server/src/test/java/org/elasticsearch/search/query/QueryStringIT.java b/server/src/test/java/org/elasticsearch/search/query/QueryStringIT.java
index c901ab8270433..e47c330bb9fb5 100644
--- a/server/src/test/java/org/elasticsearch/search/query/QueryStringIT.java
+++ b/server/src/test/java/org/elasticsearch/search/query/QueryStringIT.java
@@ -295,6 +295,35 @@ public void testLimitOnExpandedFields() throws Exception {
                         + (CLUSTER_MAX_CLAUSE_COUNT + 1)));
     }
 
+    // The only expectation for this test is to not throw exception
+    public void testLimitOnExpandedFieldsButIgnoreUnmappedFields() throws Exception {
+        XContentBuilder builder = jsonBuilder();
+        builder.startObject();
+        builder.startObject("_doc");
+        builder.startObject("properties");
+        for (int i = 0; i < CLUSTER_MAX_CLAUSE_COUNT; i++) {
+            builder.startObject("field" + i).field("type", "text").endObject();
+        }
+        builder.endObject(); // properties
+        builder.endObject(); // type1
+        builder.endObject();
+
+        assertAcked(prepareCreate("ignoreunmappedfields").setMapping(builder));
+
+        client().prepareIndex("ignoreunmappedfields").setId("1").setSource("field1", "foo bar baz").get();
+        refresh();
+
+        QueryStringQueryBuilder qb = queryStringQuery("bar");
+        if (randomBoolean()) {
+            qb.field("*")
+                .field("unmappedField1")
+                .field("unmappedField2")
+                .field("unmappedField3")
+                .field("unmappedField4");
+        }
+        client().prepareSearch("ignoreunmappedfields").setQuery(qb).get();
+    }
+
     public void testFieldAlias() throws Exception {
         List<IndexRequestBuilder> indexRequests = new ArrayList<>();
         indexRequests.add(client().prepareIndex("test").setId("1").setSource("f3", "text", "f2", "one"));

From 7b411750496b5813a80873e835602c871ff96fad Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Mon, 20 Jan 2020 12:59:30 +0200
Subject: [PATCH 662/686] SQL: change the way unsupported data types fields are
 handled (#50823)

The hierarchy of fields/sub-fields under a field that is of an unsupported data type will be marked as unsupported as well. Until this change, the behavior was to set the unsupported data type field's hierarchy as empty.

Example, considering the following hierarchy of fields/subfields  a -> b -> c -> d, if b would be of type "foo", then b, c and d will be marked as unsupported.
---
 .../xpack/ql/index/IndexResolver.java         | 22 ++++-
 .../elasticsearch/xpack/ql/type/Types.java    | 22 ++++-
 .../xpack/ql/type/UnsupportedEsField.java     | 31 +++++--
 .../xpack/ql/type/TypesTests.java             |  4 +
 .../mapping-multi-field-with-nested.json      | 20 +++++
 .../test/resources/mapping-unsupported.json   |  3 +
 .../xpack/sql/analysis/analyzer/Analyzer.java | 10 ++-
 .../analyzer/VerifierErrorMessagesTests.java  | 24 +++--
 .../analysis/index/IndexResolverTests.java    | 90 ++++++++++++++++++-
 .../logical/command/sys/SysColumnsTests.java  |  6 +-
 10 files changed, 209 insertions(+), 23 deletions(-)

diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolver.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolver.java
index 17442da04138b..21b466e6919b2 100644
--- a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolver.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/index/IndexResolver.java
@@ -358,11 +358,12 @@ private static EsField createField(String fieldName, Map<String, Map<String, Fie
 
         int dot = fieldName.lastIndexOf('.');
         String fullFieldName = fieldName;
+        EsField parent = null;
 
         if (dot >= 0) {
             String parentName = fieldName.substring(0, dot);
             fieldName = fieldName.substring(dot + 1);
-            EsField parent = flattedMapping.get(parentName);
+            parent = flattedMapping.get(parentName);
             if (parent == null) {
                 Map<String, FieldCapabilities> map = globalCaps.get(parentName);
                 Function<String, EsField> fieldFunction;
@@ -387,7 +388,22 @@ private static EsField createField(String fieldName, Map<String, Map<String, Fie
         }
 
         EsField esField = field.apply(fieldName);
-        
+
+        if (parent != null && parent instanceof UnsupportedEsField) {
+            UnsupportedEsField unsupportedParent = (UnsupportedEsField) parent;
+            String inherited = unsupportedParent.getInherited();
+            String type = unsupportedParent.getOriginalType();
+            
+            if (inherited == null) {
+                // mark the sub-field as unsupported, just like its parent, setting the first unsupported parent as the current one
+                esField = new UnsupportedEsField(esField.getName(), type, unsupportedParent.getName(), esField.getProperties());
+            } else {
+                // mark the sub-field as unsupported, just like its parent, but setting the first unsupported parent
+                // as the parent's first unsupported grandparent
+                esField = new UnsupportedEsField(esField.getName(), type, inherited, esField.getProperties());
+            }
+        }
+
         parentProps.put(fieldName, esField);
         flattedMapping.put(fullFieldName, esField);
 
@@ -408,7 +424,7 @@ private static EsField createField(String fieldName, String typeName, Map<String
             case DATETIME:
                 return new DateEsField(fieldName, props, isAggregateable);
             case UNSUPPORTED:
-                return new UnsupportedEsField(fieldName, typeName);
+                return new UnsupportedEsField(fieldName, typeName, null, props);
             default:
                 return new EsField(fieldName, esType, props, isAggregateable, isAlias);
         }
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Types.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Types.java
index 957f5deed19e6..08defc2fada3b 100644
--- a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Types.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/Types.java
@@ -73,7 +73,7 @@ private static void walkMapping(String name, Object value, Map<String, EsField>
                     properties = Collections.emptyMap();
                 }
             } else {
-                properties = Collections.emptyMap();
+                properties = fromEs(content);
             }
             boolean docValues = boolSetting(content.get("doc_values"), esDataType.defaultDocValues);
             final EsField field;
@@ -91,7 +91,8 @@ private static void walkMapping(String name, Object value, Map<String, EsField>
                     break;
                 case UNSUPPORTED:
                     String type = content.get("type").toString();
-                    field = new UnsupportedEsField(name, type);
+                    field = new UnsupportedEsField(name, type, null, properties);
+                    propagateUnsupportedType(name, type, properties);
                     break;
                 default:
                     field = new EsField(name, esDataType, properties, docValues);
@@ -113,4 +114,21 @@ private static boolean boolSetting(Object value, boolean defaultValue) {
     private static int intSetting(Object value, int defaultValue) {
         return value == null ? defaultValue : Integer.parseInt(value.toString());
     }
+    
+    private static void propagateUnsupportedType(String inherited, String originalType, Map<String, EsField> properties) {
+        if (properties != null && properties.isEmpty() == false) {
+            for (Entry<String, EsField> entry : properties.entrySet()) {
+                EsField field = entry.getValue();
+                UnsupportedEsField u;
+                if (field instanceof UnsupportedEsField) {
+                    u = (UnsupportedEsField) field;
+                    u = new UnsupportedEsField(u.getName(), originalType, inherited, u.getProperties());
+                } else {
+                    u = new UnsupportedEsField(field.getName(), originalType, inherited, field.getProperties());
+                }
+                entry.setValue(u);
+                propagateUnsupportedType(inherited, originalType, u.getProperties());
+            }
+        }
+    }
 }
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/UnsupportedEsField.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/UnsupportedEsField.java
index b41f9458864c2..4987ba97f2ba1 100644
--- a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/UnsupportedEsField.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/UnsupportedEsField.java
@@ -5,24 +5,40 @@
  */
 package org.elasticsearch.xpack.ql.type;
 
-import java.util.Collections;
+import java.util.Map;
 import java.util.Objects;
+import java.util.TreeMap;
 
 /**
- * SQL-related information about an index field that cannot be supported by SQL
+ * SQL-related information about an index field that cannot be supported by SQL.
+ * All the subfields (properties) of an unsupported type should also be unsupported.
  */
 public class UnsupportedEsField extends EsField {
 
-    private String originalType;
-
+    private final String originalType;
+    private final String inherited; // for fields belonging to parents (or grandparents) that have an unsupported type
+    
     public UnsupportedEsField(String name, String originalType) {
-        super(name, DataType.UNSUPPORTED, Collections.emptyMap(), false);
+        this(name, originalType, null, new TreeMap<>());
+    }
+    
+    public UnsupportedEsField(String name, String originalType, String inherited, Map<String, EsField> properties) {
+        super(name, DataType.UNSUPPORTED, properties, false);
         this.originalType = originalType;
+        this.inherited = inherited;
     }
 
     public String getOriginalType() {
         return originalType;
     }
+    
+    public String getInherited() {
+        return inherited;
+    }
+    
+    public boolean hasInherited() {
+        return inherited != null;
+    }
 
     @Override
     public boolean equals(Object o) {
@@ -36,11 +52,12 @@ public boolean equals(Object o) {
             return false;
         }
         UnsupportedEsField that = (UnsupportedEsField) o;
-        return Objects.equals(originalType, that.originalType);
+        return Objects.equals(originalType, that.originalType)
+                && Objects.equals(inherited, that.inherited);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(super.hashCode(), originalType);
+        return Objects.hash(super.hashCode(), originalType, inherited);
     }
 }
diff --git a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/TypesTests.java b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/TypesTests.java
index 9fc3fdb0b7594..8be30f389973d 100644
--- a/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/TypesTests.java
+++ b/x-pack/plugin/ql/src/test/java/org/elasticsearch/xpack/ql/type/TypesTests.java
@@ -188,6 +188,10 @@ public void testUnsupportedTypes() {
         Map<String, EsField> mapping = loadMapping("mapping-unsupported.json");
         EsField dt = mapping.get("range");
         assertThat(dt.getDataType().typeName(), is("unsupported"));
+        dt = mapping.get("time_frame");
+        assertThat(dt.getDataType().typeName(), is("unsupported"));
+        dt = mapping.get("flat");
+        assertThat(dt.getDataType().typeName(), is("unsupported"));
     }
 
     public static Map<String, EsField> loadMapping(String name) {
diff --git a/x-pack/plugin/ql/src/test/resources/mapping-multi-field-with-nested.json b/x-pack/plugin/ql/src/test/resources/mapping-multi-field-with-nested.json
index e46d64a45e88f..d66dd7efd5fca 100644
--- a/x-pack/plugin/ql/src/test/resources/mapping-multi-field-with-nested.json
+++ b/x-pack/plugin/ql/src/test/resources/mapping-multi-field-with-nested.json
@@ -7,6 +7,26 @@
         "unsupported" : { "type" : "ip_range" },
         "date" : { "type" : "date"},
         "shape": { "type" : "geo_shape" },
+        "x" : {
+            "type" : "text",
+            "fields" : {
+                "y" : {
+                    "type" : "foobar",
+                    "fields" : {
+                        "z" : {
+                            "properties" : {
+                                "v" : {
+                                    "type" : "keyword"
+                                },
+                                "w" : {
+                                    "type" : "foo"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
         "some" : {
             "properties" : {
                 "dotted" : {
diff --git a/x-pack/plugin/ql/src/test/resources/mapping-unsupported.json b/x-pack/plugin/ql/src/test/resources/mapping-unsupported.json
index 832dc9c0d745d..d3afa7fa52405 100644
--- a/x-pack/plugin/ql/src/test/resources/mapping-unsupported.json
+++ b/x-pack/plugin/ql/src/test/resources/mapping-unsupported.json
@@ -6,6 +6,9 @@
         "time_frame" : {
             "type" : "date_range",
             "format" : "yyyy-MM-dd"
+        },
+        "flat" : {
+            "type" : "flattened"
         }
     }
 }
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
index 5119378d6462b..c47f31bcb901f 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/analysis/analyzer/Analyzer.java
@@ -217,8 +217,14 @@ private static Attribute handleSpecialFields(UnresolvedAttribute u, Attribute na
             // unsupported types
             else if (DataTypes.isUnsupported(fa.dataType())) {
                 UnsupportedEsField unsupportedField = (UnsupportedEsField) fa.field();
-                named = u.withUnresolvedMessage(
-                        "Cannot use field [" + fa.name() + "] type [" + unsupportedField.getOriginalType() + "] as is unsupported");
+                if (unsupportedField.hasInherited()) {
+                    named = u.withUnresolvedMessage(
+                            "Cannot use field [" + fa.name() + "] with unsupported type [" + unsupportedField.getOriginalType() + "] "
+                                    + "in hierarchy (field [" + unsupportedField.getInherited() + "])");
+                } else {
+                    named = u.withUnresolvedMessage(
+                            "Cannot use field [" + fa.name() + "] with unsupported type [" + unsupportedField.getOriginalType() + "]");
+                }
             }
             // compound fields
             else if (allowCompound == false && fa.dataType().isPrimitive() == false) {
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
index b6bedfe02b86e..7cfcc2bdc7642 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/analyzer/VerifierErrorMessagesTests.java
@@ -482,19 +482,33 @@ public void testGroupByScalarFunctionWithAggOnTarget() {
     }
 
     public void testUnsupportedType() {
-        assertEquals("1:8: Cannot use field [unsupported] type [ip_range] as is unsupported",
+        assertEquals("1:8: Cannot use field [unsupported] with unsupported type [ip_range]",
                 error("SELECT unsupported FROM test"));
     }
 
     public void testUnsupportedStarExpansion() {
-        assertEquals("1:8: Cannot use field [unsupported] type [ip_range] as is unsupported",
+        assertEquals("1:8: Cannot use field [unsupported] with unsupported type [ip_range]",
                 error("SELECT unsupported.* FROM test"));
     }
 
     public void testUnsupportedTypeInFilter() {
-        assertEquals("1:26: Cannot use field [unsupported] type [ip_range] as is unsupported",
+        assertEquals("1:26: Cannot use field [unsupported] with unsupported type [ip_range]",
                 error("SELECT * FROM test WHERE unsupported > 1"));
     }
+    
+    public void testValidRootFieldWithUnsupportedChildren() {
+        accept("SELECT x FROM test");
+    }
+    
+    public void testUnsupportedTypeInHierarchy() {
+        assertEquals("1:8: Cannot use field [x.y.z.w] with unsupported type [foobar] in hierarchy (field [y])",
+                error("SELECT x.y.z.w FROM test"));
+        assertEquals("1:8: Cannot use field [x.y.z.v] with unsupported type [foobar] in hierarchy (field [y])",
+                error("SELECT x.y.z.v FROM test"));
+        assertEquals("1:8: Cannot use field [x.y.z] with unsupported type [foobar] in hierarchy (field [y])",
+                error("SELECT x.y.z.* FROM test"));
+        assertEquals("1:8: Cannot use field [x.y] with unsupported type [foobar]", error("SELECT x.y FROM test"));
+    }
 
     public void testTermEqualitOnInexact() {
         assertEquals("1:26: [text = 'value'] cannot operate on first argument field of data type [text]: " +
@@ -509,12 +523,12 @@ public void testTermEqualityOnAmbiguous() {
     }
 
     public void testUnsupportedTypeInFunction() {
-        assertEquals("1:12: Cannot use field [unsupported] type [ip_range] as is unsupported",
+        assertEquals("1:12: Cannot use field [unsupported] with unsupported type [ip_range]",
                 error("SELECT ABS(unsupported) FROM test"));
     }
 
     public void testUnsupportedTypeInOrder() {
-        assertEquals("1:29: Cannot use field [unsupported] type [ip_range] as is unsupported",
+        assertEquals("1:29: Cannot use field [unsupported] with unsupported type [ip_range]",
                 error("SELECT * FROM test ORDER BY unsupported"));
     }
 
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
index f58925c16d828..181d0791f93b8 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/analysis/index/IndexResolverTests.java
@@ -128,6 +128,94 @@ public void testMetaFieldsAreIgnored() throws Exception {
         assertEquals(DataType.INTEGER, esIndex.mapping().get("_meta_field").getDataType());
         assertEquals(DataType.KEYWORD, esIndex.mapping().get("text").getDataType());
     }
+    
+    public void testFlattenedHiddenSubfield() throws Exception {
+        Map<String, Map<String, FieldCapabilities>> fieldCaps = new HashMap<>();
+        addFieldCaps(fieldCaps, "some_field", "flattened", false, false);
+        addFieldCaps(fieldCaps, "some_field._keyed", "flattened", false, false);
+        addFieldCaps(fieldCaps, "another_field", "object", true, false);
+        addFieldCaps(fieldCaps, "another_field._keyed", "keyword", true, false);
+        addFieldCaps(fieldCaps, "nested_field", "object", false, false);
+        addFieldCaps(fieldCaps, "nested_field.sub_field", "flattened", true, true);
+        addFieldCaps(fieldCaps, "nested_field.sub_field._keyed", "flattened", true, true);
+        addFieldCaps(fieldCaps, "text", "keyword", true, true);
+        
+        String wildcard = "*";
+        IndexResolution resolution = IndexResolver.mergedMappings(wildcard, new String[] { "index" }, fieldCaps);
+        assertTrue(resolution.isValid());
+
+        EsIndex esIndex = resolution.get();
+        assertEquals(wildcard, esIndex.name());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("some_field").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("some_field").getProperties().get("_keyed").getDataType());
+        assertEquals(DataType.OBJECT, esIndex.mapping().get("nested_field").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("nested_field").getProperties().get("sub_field").getDataType());
+        assertEquals(DataType.UNSUPPORTED,
+                esIndex.mapping().get("nested_field").getProperties().get("sub_field").getProperties().get("_keyed").getDataType());
+        assertEquals(DataType.KEYWORD, esIndex.mapping().get("text").getDataType());
+        assertEquals(DataType.OBJECT, esIndex.mapping().get("another_field").getDataType());
+        assertEquals(DataType.KEYWORD, esIndex.mapping().get("another_field").getProperties().get("_keyed").getDataType());
+    }
+    
+    public void testPropagateUnsupportedTypeToSubFields() throws Exception {
+        // generate a field type having the name of the format "foobar43"
+        String esFieldType = randomAlphaOfLengthBetween(5, 10) + randomIntBetween(-100, 100);
+        Map<String, Map<String, FieldCapabilities>> fieldCaps = new HashMap<>();
+        addFieldCaps(fieldCaps, "a", "text", false, false);
+        addFieldCaps(fieldCaps, "a.b", esFieldType, false, false);
+        addFieldCaps(fieldCaps, "a.b.c", "object", true, false);
+        addFieldCaps(fieldCaps, "a.b.c.d", "keyword", true, false);
+        addFieldCaps(fieldCaps, "a.b.c.e", "foo", true, true);
+        
+        String wildcard = "*";
+        IndexResolution resolution = IndexResolver.mergedMappings(wildcard, new String[] { "index" }, fieldCaps);
+        assertTrue(resolution.isValid());
+
+        EsIndex esIndex = resolution.get();
+        assertEquals(wildcard, esIndex.name());
+        assertEquals(DataType.TEXT, esIndex.mapping().get("a").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("a").getProperties().get("b").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("a").getProperties().get("b").getProperties().get("c").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("a").getProperties().get("b").getProperties().get("c")
+                .getProperties().get("d").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("a").getProperties().get("b").getProperties().get("c")
+                .getProperties().get("e").getDataType());
+    }
+    
+    public void testRandomMappingFieldTypeMappedAsUnsupported() throws Exception {
+        // generate a field type having the name of the format "foobar43"
+        String esFieldType = randomAlphaOfLengthBetween(5, 10) + randomIntBetween(-100, 100);
+        
+        Map<String, Map<String, FieldCapabilities>> fieldCaps = new HashMap<>();
+        addFieldCaps(fieldCaps, "some_field", esFieldType, false, false);
+        addFieldCaps(fieldCaps, "another_field", "object", true, false);
+        addFieldCaps(fieldCaps, "another_field._foo", esFieldType, true, false);
+        addFieldCaps(fieldCaps, "nested_field", "object", false, false);
+        addFieldCaps(fieldCaps, "nested_field.sub_field1", esFieldType, true, true);
+        addFieldCaps(fieldCaps, "nested_field.sub_field1.bar", esFieldType, true, true);
+        addFieldCaps(fieldCaps, "nested_field.sub_field2", esFieldType, true, true);
+        // even if this is of a supported type, because it belongs to an UNSUPPORTED type parent, it should also be UNSUPPORTED
+        addFieldCaps(fieldCaps, "nested_field.sub_field2.bar", "keyword", true, true);
+        addFieldCaps(fieldCaps, "text", "keyword", true, true);
+        
+        String wildcard = "*";
+        IndexResolution resolution = IndexResolver.mergedMappings(wildcard, new String[] { "index" }, fieldCaps);
+        assertTrue(resolution.isValid());
+
+        EsIndex esIndex = resolution.get();
+        assertEquals(wildcard, esIndex.name());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("some_field").getDataType());
+        assertEquals(DataType.OBJECT, esIndex.mapping().get("nested_field").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("nested_field").getProperties().get("sub_field1").getDataType());
+        assertEquals(DataType.UNSUPPORTED,
+                esIndex.mapping().get("nested_field").getProperties().get("sub_field1").getProperties().get("bar").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("nested_field").getProperties().get("sub_field2").getDataType());
+        assertEquals(DataType.UNSUPPORTED,
+                esIndex.mapping().get("nested_field").getProperties().get("sub_field2").getProperties().get("bar").getDataType());
+        assertEquals(DataType.KEYWORD, esIndex.mapping().get("text").getDataType());
+        assertEquals(DataType.OBJECT, esIndex.mapping().get("another_field").getDataType());
+        assertEquals(DataType.UNSUPPORTED, esIndex.mapping().get("another_field").getProperties().get("_foo").getDataType());
+    }
 
     public void testMergeIncompatibleCapabilitiesOfObjectFields() throws Exception {
         Map<String, Map<String, FieldCapabilities>> fieldCaps = new HashMap<>();
@@ -330,7 +418,7 @@ private static <K, V> void assertEqualsMaps(Map<K, V> left, Map<K, V> right) {
     private void addFieldCaps(Map<String, Map<String, FieldCapabilities>> fieldCaps, String name, String type, boolean isSearchable,
             boolean isAggregatable) {
         Map<String, FieldCapabilities> cap = new HashMap<>();
-        cap.put(name, new FieldCapabilities(name, type, isSearchable, isAggregatable, Collections.emptyMap()));
+        cap.put(type, new FieldCapabilities(name, type, isSearchable, isAggregatable, Collections.emptyMap()));
         fieldCaps.put(name, cap);
     }
 }
diff --git a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumnsTests.java b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumnsTests.java
index cfadd61828e23..5bdeff1f20e42 100644
--- a/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumnsTests.java
+++ b/x-pack/plugin/sql/src/test/java/org/elasticsearch/xpack/sql/plan/logical/command/sys/SysColumnsTests.java
@@ -463,7 +463,7 @@ public void testSysColumnsNoArg() throws Exception {
 
     public void testSysColumnsWithCatalogWildcard() throws Exception {
         executeCommand("SYS COLUMNS CATALOG 'cluster' TABLE LIKE 'test' LIKE '%'", emptyList(), r -> {
-            assertEquals(14, r.size());
+            assertEquals(15, r.size());
             assertEquals(CLUSTER_NAME, r.column(0));
             assertEquals("test", r.column(2));
             assertEquals("bool", r.column(3));
@@ -476,7 +476,7 @@ public void testSysColumnsWithCatalogWildcard() throws Exception {
 
     public void testSysColumnsWithMissingCatalog() throws Exception {
         executeCommand("SYS COLUMNS TABLE LIKE 'test' LIKE '%'", emptyList(), r -> {
-            assertEquals(14, r.size());
+            assertEquals(15, r.size());
             assertEquals(CLUSTER_NAME, r.column(0));
             assertEquals("test", r.column(2));
             assertEquals("bool", r.column(3));
@@ -489,7 +489,7 @@ public void testSysColumnsWithMissingCatalog() throws Exception {
 
     public void testSysColumnsWithNullCatalog() throws Exception {
         executeCommand("SYS COLUMNS CATALOG ? TABLE LIKE 'test' LIKE '%'", singletonList(new SqlTypedParamValue("keyword", null)), r -> {
-            assertEquals(14, r.size());
+            assertEquals(15, r.size());
             assertEquals(CLUSTER_NAME, r.column(0));
             assertEquals("test", r.column(2));
             assertEquals("bool", r.column(3));

From d607690c3b15be42cd15264d95a8c8bded7f314c Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@gmail.com>
Date: Mon, 20 Jan 2020 11:14:49 +0000
Subject: [PATCH 663/686] Revert "Don't use user-supplied type when building
 DocumentMapper (#50960)" (#51214)

Reverts #50960

This commit has been causing test failures during upgrade tests: specifically, an upgraded
node becomes master and sends a cluster state update to a 7.x node; this node sees that the
mapping version of its .tasks index is the same as the master, so asserts that the serialized
mappings are the same; however, because the master has rewritten the mapping to use
_docinstead oftasks`, we get an assertion failure. The logical fix is for the master to
increment its mapping version when it rewrites the mapping, but there isn't a simple way to
do that currently.

This reverts commit 774bfb5e22389a923678ed8013e8cd284703d5dd.
---
 .../mapper/RankFeatureFieldMapperTests.java   | 12 +--
 .../RankFeatureMetaFieldMapperTests.java      |  6 +-
 .../mapper/RankFeaturesFieldMapperTests.java  |  8 +-
 .../mapper/ScaledFloatFieldMapperTests.java   | 40 ++++-----
 .../ICUCollationKeywordFieldMapperTests.java  | 44 +++++-----
 .../AnnotatedTextFieldMapperTests.java        | 48 +++++------
 .../index/mapper/DocumentMapperParser.java    | 11 ++-
 .../index/mapper/BooleanFieldMapperTests.java |  4 +-
 .../index/mapper/CopyToMapperTests.java       |  6 +-
 .../index/mapper/DateFieldMapperTests.java    | 40 ++++-----
 .../mapper/DocumentMapperParserTests.java     | 10 +++
 .../index/mapper/DocumentMapperTests.java     |  4 +-
 .../index/mapper/DocumentParserTests.java     | 18 ++--
 .../index/mapper/DynamicMappingTests.java     | 46 +++++-----
 .../index/mapper/FieldAliasMapperTests.java   |  4 +-
 .../index/mapper/IpFieldMapperTests.java      | 28 +++---
 .../index/mapper/IpRangeFieldMapperTests.java |  4 +-
 .../index/mapper/KeywordFieldMapperTests.java | 44 +++++-----
 .../LegacyGeoShapeFieldMapperTests.java       |  4 +-
 .../index/mapper/MultiFieldTests.java         |  2 +-
 .../index/mapper/NumberFieldMapperTests.java  | 52 +++++------
 .../index/mapper/ObjectMapperTests.java       | 18 ++++
 .../index/mapper/RangeFieldMapperTests.java   | 36 ++++----
 .../index/mapper/RootObjectMapperTests.java   | 48 +++++------
 .../index/mapper/SourceFieldMapperTests.java  | 26 +++---
 .../index/mapper/TextFieldMapperTests.java    | 86 +++++++++----------
 .../index/mapper/TypeFieldMapperTests.java    |  2 +-
 .../mapper/FlatObjectFieldMapperTests.java    | 52 +++++------
 28 files changed, 367 insertions(+), 336 deletions(-)

diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureFieldMapperTests.java
index 165dbe66f5f66..04ac52376d4c9 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureFieldMapperTests.java
@@ -64,11 +64,11 @@ static int getFrequency(TokenStream tk) throws IOException {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "rank_feature").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -99,12 +99,12 @@ public void testDefaults() throws Exception {
     }
 
     public void testNegativeScoreImpact() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "rank_feature")
                 .field("positive_score_impact", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -135,12 +135,12 @@ public void testNegativeScoreImpact() throws Exception {
     }
 
     public void testRejectMultiValuedFields() throws MapperParsingException, IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "rank_feature").endObject().startObject("foo")
                 .startObject("properties").startObject("field").field("type", "rank_feature").endObject().endObject()
                 .endObject().endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureMetaFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureMetaFieldMapperTests.java
index 46c2316aa161e..f293e10f9e9ea 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureMetaFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeatureMetaFieldMapperTests.java
@@ -44,13 +44,13 @@ public void setup() {
     protected Collection<Class<? extends Plugin>> getPlugins() {
         return pluginList(MapperExtrasPlugin.class);
     }
-
+    
     public void testBasics() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "rank_feature").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
         assertNotNull(mapper.metadataMapper(RankFeatureMetaFieldMapper.class));
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeaturesFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeaturesFieldMapperTests.java
index ea8f2ed16f81b..f6dd518191e2c 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeaturesFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/RankFeaturesFieldMapperTests.java
@@ -53,11 +53,11 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "rank_features").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -85,12 +85,12 @@ public void testDefaults() throws Exception {
     }
 
     public void testRejectMultiValuedFields() throws MapperParsingException, IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "rank_features").endObject().startObject("foo")
                 .startObject("properties").startObject("field").field("type", "rank_features").endObject().endObject()
                 .endObject().endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
diff --git a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
index c5c7358c8220f..94ae0cee76bb7 100644
--- a/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
+++ b/modules/mapper-extras/src/test/java/org/elasticsearch/index/mapper/ScaledFloatFieldMapperTests.java
@@ -58,12 +58,12 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -108,12 +108,12 @@ public void testIllegalScalingFactor() throws IOException {
     }
 
     public void testNotIndexed() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("index", false).field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -132,12 +132,12 @@ public void testNotIndexed() throws Exception {
     }
 
     public void testNoDocValues() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("doc_values", false).field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -156,12 +156,12 @@ public void testNoDocValues() throws Exception {
     }
 
     public void testStore() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("store", true).field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -185,12 +185,12 @@ public void testStore() throws Exception {
     }
 
     public void testCoerce() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("scaling_factor", 10.0).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -209,12 +209,12 @@ public void testCoerce() throws Exception {
         IndexableField dvField = fields[1];
         assertEquals(DocValuesType.SORTED_NUMERIC, dvField.fieldType().docValuesType());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "scaled_float")
                 .field("scaling_factor", 10.0).field("coerce", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper2.mappingSource().toString());
 
@@ -238,12 +238,12 @@ public void testIgnoreMalformed() throws Exception {
     }
 
     private void doTestIgnoreMalformed(String value, String exceptionMessageContains) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", "scaled_float")
             .field("scaling_factor", 10.0).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -256,12 +256,12 @@ private void doTestIgnoreMalformed(String value, String exceptionMessageContains
         MapperParsingException e = expectThrows(MapperParsingException.class, runnable);
         assertThat(e.getCause().getMessage(), containsString(exceptionMessageContains));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", "scaled_float")
             .field("scaling_factor", 10.0).field("ignore_malformed", true).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(mapping));
 
         ParsedDocument doc = mapper2.parse(new SourceToParse("test", "1", BytesReference
                 .bytes(XContentFactory.jsonBuilder()
@@ -276,7 +276,7 @@ private void doTestIgnoreMalformed(String value, String exceptionMessageContains
 
     public void testNullValue() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "scaled_float")
@@ -285,7 +285,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -297,7 +297,7 @@ public void testNullValue() throws IOException {
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "scaled_float")
@@ -307,7 +307,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         doc = mapper.parse(new SourceToParse("test", "1", BytesReference
diff --git a/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperTests.java b/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperTests.java
index 630113daf621f..e4db71bc07bb7 100644
--- a/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperTests.java
+++ b/plugins/analysis-icu/src/test/java/org/elasticsearch/index/mapper/ICUCollationKeywordFieldMapperTests.java
@@ -64,11 +64,11 @@ public void setup() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -105,11 +105,11 @@ public void testDefaults() throws Exception {
     }
 
     public void testNullValue() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -120,12 +120,12 @@ public void testNullValue() throws IOException {
             XContentType.JSON));
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("null_value", "1234").endObject().endObject()
             .endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -155,12 +155,12 @@ public void testNullValue() throws IOException {
     }
 
     public void testEnableStore() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("store", true).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -177,12 +177,12 @@ public void testEnableStore() throws IOException {
     }
 
     public void testDisableIndex() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("index", false).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -200,12 +200,12 @@ public void testDisableIndex() throws IOException {
     }
 
     public void testDisableDocValues() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("doc_values", false).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -222,11 +222,11 @@ public void testDisableDocValues() throws IOException {
     }
 
     public void testMultipleValues() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -284,12 +284,12 @@ public void testMultipleValues() throws IOException {
     }
 
     public void testIndexOptions() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("index_options", "freqs").endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -317,12 +317,12 @@ public void testIndexOptions() throws IOException {
     }
 
     public void testEnableNorms() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("norms", true).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -339,14 +339,14 @@ public void testEnableNorms() throws IOException {
     }
 
     public void testCollator() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field")
             .field("type", FIELD_TYPE)
             .field("language", "tr")
             .field("strength", "primary")
             .endObject().endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -406,12 +406,12 @@ public void testUpdateCollator() throws IOException {
 
 
     public void testIgnoreAbove() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", FIELD_TYPE)
             .field("ignore_above", 5).endObject().endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
diff --git a/plugins/mapper-annotated-text/src/test/java/org/elasticsearch/index/mapper/annotatedtext/AnnotatedTextFieldMapperTests.java b/plugins/mapper-annotated-text/src/test/java/org/elasticsearch/index/mapper/annotatedtext/AnnotatedTextFieldMapperTests.java
index 885bf834ab23d..5acc8c9a82280 100644
--- a/plugins/mapper-annotated-text/src/test/java/org/elasticsearch/index/mapper/annotatedtext/AnnotatedTextFieldMapperTests.java
+++ b/plugins/mapper-annotated-text/src/test/java/org/elasticsearch/index/mapper/annotatedtext/AnnotatedTextFieldMapperTests.java
@@ -252,11 +252,11 @@ public void testAgainstTermVectorsAPI() throws IOException {
     // ===== Code below copied from TextFieldMapperTests ========
 
     public void testDefaults() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", getFieldType()).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -284,11 +284,11 @@ public void testDefaults() throws IOException {
     }
 
     public void testEnableStore() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", getFieldType()).field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -305,14 +305,14 @@ public void testEnableStore() throws IOException {
     }
 
     public void testDisableNorms() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                     .field("type", getFieldType())
                     .field("norms", false)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -360,11 +360,11 @@ public void testIndexOptions() throws IOException {
     }
 
     public void testDefaultPositionIncrementGap() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", getFieldType()).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+        DocumentMapper mapper = indexService.mapperService().merge("type",
                 new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         assertEquals(mapping, mapper.mappingSource().toString());
@@ -399,14 +399,14 @@ public void testDefaultPositionIncrementGap() throws IOException {
 
     public void testPositionIncrementGap() throws IOException {
         final int positionIncrementGap = randomIntBetween(1, 1000);
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                     .field("type", getFieldType())
                     .field("position_increment_gap", positionIncrementGap)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+        DocumentMapper mapper = indexService.mapperService().merge("type",
                 new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         assertEquals(mapping, mapper.mappingSource().toString());
@@ -440,7 +440,7 @@ public void testPositionIncrementGap() throws IOException {
     }
 
     public void testSearchAnalyzerSerialization() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", getFieldType())
@@ -449,11 +449,11 @@ public void testSearchAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default index analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", getFieldType())
@@ -462,10 +462,10 @@ public void testSearchAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties")
             .startObject("field")
             .field("type", getFieldType())
@@ -473,11 +473,11 @@ public void testSearchAnalyzerSerialization() throws IOException {
             .endObject()
             .endObject().endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default search analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties")
             .startObject("field")
             .field("type", getFieldType())
@@ -486,17 +486,17 @@ public void testSearchAnalyzerSerialization() throws IOException {
             .endObject()
             .endObject().endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties")
             .startObject("field")
             .field("type", getFieldType())
             .field("analyzer", "keyword")
             .endObject()
             .endObject().endObject().endObject());
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
 
         XContentBuilder builder = XContentFactory.jsonBuilder();
         builder.startObject();
@@ -510,7 +510,7 @@ public void testSearchAnalyzerSerialization() throws IOException {
     }
 
     public void testSearchQuoteAnalyzerSerialization() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", getFieldType())
@@ -520,11 +520,11 @@ public void testSearchQuoteAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default index/search analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", getFieldType())
@@ -534,7 +534,7 @@ public void testSearchQuoteAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
     }
 
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapperParser.java b/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapperParser.java
index 1307e74f9f2f5..d4f16bcaf8458 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapperParser.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapperParser.java
@@ -74,22 +74,25 @@ public DocumentMapper parse(@Nullable String type, CompressedXContent source) th
         if (source != null) {
             Map<String, Object> root = XContentHelper.convertToMap(source.compressedReference(), true, XContentType.JSON).v2();
             Tuple<String, Map<String, Object>> t = extractMapping(type, root);
+            type = t.v1();
             mapping = t.v2();
         }
         if (mapping == null) {
             mapping = new HashMap<>();
         }
-        return parse(mapping);
+        return parse(type, mapping);
     }
 
     @SuppressWarnings({"unchecked"})
-    private DocumentMapper parse(Map<String, Object> mapping) throws MapperParsingException {
+    private DocumentMapper parse(String type, Map<String, Object> mapping) throws MapperParsingException {
+        if (type == null) {
+            throw new MapperParsingException("Failed to derive type");
+        }
 
         Mapper.TypeParser.ParserContext parserContext = parserContext();
         // parse RootObjectMapper
         DocumentMapper.Builder docBuilder = new DocumentMapper.Builder(
-            (RootObjectMapper.Builder) rootObjectTypeParser.parse(MapperService.SINGLE_MAPPING_NAME, mapping, parserContext),
-            mapperService);
+                (RootObjectMapper.Builder) rootObjectTypeParser.parse(type, mapping, parserContext), mapperService);
         Iterator<Map.Entry<String, Object>> iterator = mapping.entrySet().iterator();
         // parse DocumentMapper
         while(iterator.hasNext()) {
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
index d8712f582a5e5..1fd3f51ece916 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/BooleanFieldMapperTests.java
@@ -180,7 +180,7 @@ public void testParsesBooleansNestedStrict() throws IOException {
 
 
     public void testMultiFields() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "boolean")
@@ -192,7 +192,7 @@ public void testMultiFields() throws IOException {
                     .endObject().endObject()
                 .endObject().endObject());
         DocumentMapper mapper = indexService.mapperService()
-            .merge("_doc", new CompressedXContent(mapping), MapperService.MergeReason.MAPPING_UPDATE);
+            .merge("type", new CompressedXContent(mapping), MapperService.MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
         BytesReference source = BytesReference.bytes(XContentFactory.jsonBuilder()
                 .startObject()
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperTests.java
index 445611aba40fb..6805db662821f 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/CopyToMapperTests.java
@@ -232,7 +232,7 @@ public void testCopyToDynamicInnerInnerObjectParsing() throws Exception {
     }
 
     public void testCopyToStrictDynamicInnerObjectParsing() throws Exception {
-        String mapping = Strings.toString(jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(jsonBuilder().startObject().startObject("type1")
             .field("dynamic", "strict")
                 .startObject("properties")
                     .startObject("copy_test")
@@ -243,7 +243,7 @@ public void testCopyToStrictDynamicInnerObjectParsing() throws Exception {
             .endObject().endObject());
 
         DocumentMapper docMapper = createIndex("test").mapperService().documentMapperParser()
-            .parse("_doc", new CompressedXContent(mapping));
+            .parse("type1", new CompressedXContent(mapping));
 
         BytesReference json = BytesReference.bytes(jsonBuilder().startObject()
             .field("copy_test", "foo")
@@ -253,7 +253,7 @@ public void testCopyToStrictDynamicInnerObjectParsing() throws Exception {
             docMapper.parse(new SourceToParse("test", "1", json, XContentType.JSON)).rootDoc();
             fail();
         } catch (MapperParsingException ex) {
-            assertThat(ex.getMessage(), startsWith("mapping set to strict, dynamic introduction of [very] within [_doc] is not allowed"));
+            assertThat(ex.getMessage(), startsWith("mapping set to strict, dynamic introduction of [very] within [type1] is not allowed"));
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
index e7b2b90832ae6..477cf7de8285c 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DateFieldMapperTests.java
@@ -62,11 +62,11 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -91,11 +91,11 @@ public void testDefaults() throws Exception {
     }
 
     public void testNotIndexed() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date").field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -113,11 +113,11 @@ public void testNotIndexed() throws Exception {
     }
 
     public void testNoDocValues() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date").field("doc_values", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -135,11 +135,11 @@ public void testNoDocValues() throws Exception {
     }
 
     public void testStore() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date").field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -169,11 +169,11 @@ public void testIgnoreMalformed() throws IOException {
     }
 
     private void testIgnoreMalfomedForValue(String value, String expectedException) throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -206,12 +206,12 @@ private void testIgnoreMalfomedForValue(String value, String expectedException)
     }
 
     public void testChangeFormat() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date")
                 .field("format", "epoch_second").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -230,13 +230,13 @@ public void testChangeFormat() throws IOException {
 
     public void testChangeLocale() throws IOException {
         assumeTrue("need java 9 for testing ",JavaVersion.current().compareTo(JavaVersion.parse("9")) >= 0);
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "date")
                     .field("format", "E, d MMM yyyy HH:mm:ss Z")
                     .field("locale", "de")
             .endObject().endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -250,7 +250,7 @@ public void testChangeLocale() throws IOException {
 
     public void testNullValue() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "date")
@@ -258,7 +258,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -270,7 +270,7 @@ public void testNullValue() throws IOException {
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "date")
@@ -279,7 +279,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -332,7 +332,7 @@ public void testTimeZoneParsing() throws Exception {
         final String timeZonePattern = "yyyy-MM-dd" + randomFrom("XXX", "[XXX]", "'['XXX']'");
 
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "date")
@@ -341,7 +341,7 @@ public void testTimeZoneParsing() throws Exception {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         DateFormatter formatter = DateFormatter.forPattern(timeZonePattern);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperParserTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperParserTests.java
index b16ecb9a1591b..c35e083d687b1 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperParserTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperParserTests.java
@@ -25,7 +25,17 @@
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.test.ESSingleNodeTestCase;
 
+import static org.hamcrest.Matchers.equalTo;
+
 public class DocumentMapperParserTests extends ESSingleNodeTestCase {
+    public void testTypeLevel() throws Exception {
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
+                .endObject().endObject());
+
+        DocumentMapperParser parser = createIndex("test").mapperService().documentMapperParser();
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
+        assertThat(mapper.type(), equalTo("type"));
+    }
 
     public void testFieldNameWithDots() throws Exception {
         IndexService indexService = createIndex("test");
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
index 8a14c1fbcca36..724c53d04f15b 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
@@ -155,7 +155,7 @@ public void testChangeSearchAnalyzerToDefault() throws Exception {
 
     public void testConcurrentMergeTest() throws Throwable {
         final MapperService mapperService = createIndex("test").mapperService();
-        mapperService.merge("_doc", new CompressedXContent("{\"_doc\":{}}"), MapperService.MergeReason.MAPPING_UPDATE);
+        mapperService.merge("test", new CompressedXContent("{\"test\":{}}"), MapperService.MergeReason.MAPPING_UPDATE);
         final DocumentMapper documentMapper = mapperService.documentMapper();
 
         DocumentFieldMappers dfm = documentMapper.mappers();
@@ -184,7 +184,7 @@ public void run() {
                         Mapping update = doc.dynamicMappingsUpdate();
                         assert update != null;
                         lastIntroducedFieldName.set(fieldName);
-                        mapperService.merge("_doc", new CompressedXContent(update.toString()), MapperService.MergeReason.MAPPING_UPDATE);
+                        mapperService.merge("test", new CompressedXContent(update.toString()), MapperService.MergeReason.MAPPING_UPDATE);
                     }
                 } catch (Exception e) {
                     error.set(e);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DocumentParserTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DocumentParserTests.java
index 1d76efdd008b4..e430125f28187 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DocumentParserTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DocumentParserTests.java
@@ -549,7 +549,7 @@ public void testDynamicStrictLongArray() throws Exception {
             .endArray().endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
     }
 
     public void testMappedGeoPointArray() throws Exception {
@@ -631,7 +631,7 @@ public void testDynamicStrictObject() throws Exception {
                 .endObject().endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
     }
 
     public void testDynamicFalseValue() throws Exception {
@@ -662,7 +662,7 @@ public void testDynamicStrictValue() throws Exception {
                 .endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [bar] within [_doc] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [bar] within [type] is not allowed", exception.getMessage());
     }
 
     public void testDynamicFalseNull() throws Exception {
@@ -693,7 +693,7 @@ public void testDynamicStrictNull() throws Exception {
                 .endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [bar] within [_doc] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [bar] within [type] is not allowed", exception.getMessage());
     }
 
     public void testMappedNullValue() throws Exception {
@@ -892,7 +892,7 @@ public void testDynamicStrictDottedFieldNameLongArray() throws Exception {
             .endArray().endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
     }
 
     public void testDynamicDottedFieldNameLong() throws Exception {
@@ -1009,7 +1009,7 @@ public void testDynamicStrictDottedFieldNameLong() throws Exception {
             .endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
     }
 
     public void testDynamicDottedFieldNameObject() throws Exception {
@@ -1136,7 +1136,7 @@ public void testDynamicStrictDottedFieldNameObject() throws Exception {
             .endObject().endObject());
         StrictDynamicMappingException exception = expectThrows(StrictDynamicMappingException.class,
                 () -> mapper.parse(new SourceToParse("test", "1", bytes, XContentType.JSON)));
-        assertEquals("mapping set to strict, dynamic introduction of [foo] within [_doc] is not allowed", exception.getMessage());
+        assertEquals("mapping set to strict, dynamic introduction of [foo] within [type] is not allowed", exception.getMessage());
     }
 
     public void testDocumentContainsMetadataField() throws Exception {
@@ -1175,7 +1175,7 @@ public void testParseToJsonAndParse() throws Exception {
         DocumentMapper docMapper = parser.parse("person", new CompressedXContent(mapping));
         String builtMapping = docMapper.mappingSource().string();
         // reparse it
-        DocumentMapper builtDocMapper = parser.parse("_doc", new CompressedXContent(builtMapping));
+        DocumentMapper builtDocMapper = parser.parse("person", new CompressedXContent(builtMapping));
         BytesReference json = new BytesArray(copyToBytesFromClasspath("/org/elasticsearch/index/mapper/simple/test1.json"));
         Document doc = builtDocMapper.parse(new SourceToParse("test", "1", json, XContentType.JSON)).rootDoc();
         assertThat(doc.getBinaryValue(docMapper.idFieldMapper().name()), equalTo(Uid.encodeId("1")));
@@ -1213,7 +1213,7 @@ public void testAttributes() throws Exception {
         assertThat((String) docMapper.meta().get("param1"), equalTo("value1"));
 
         String builtMapping = docMapper.mappingSource().string();
-        DocumentMapper builtDocMapper = parser.parse("_doc", new CompressedXContent(builtMapping));
+        DocumentMapper builtDocMapper = parser.parse("person", new CompressedXContent(builtMapping));
         assertThat((String) builtDocMapper.meta().get("param1"), equalTo("value1"));
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
index bb0a0af1b64a3..9e0d9155d43bd 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DynamicMappingTests.java
@@ -123,7 +123,7 @@ public void testDynamicStrict() throws IOException {
                         .field("field2", "value2")
                         .endObject()),
                 XContentType.JSON)));
-        assertThat(e.getMessage(), equalTo("mapping set to strict, dynamic introduction of [field2] within [_doc] is not allowed"));
+        assertThat(e.getMessage(), equalTo("mapping set to strict, dynamic introduction of [field2] within [type] is not allowed"));
 
         e = expectThrows(StrictDynamicMappingException.class,
             () -> defaultMapper.parse(new SourceToParse("test", "1",
@@ -133,7 +133,7 @@ public void testDynamicStrict() throws IOException {
                                 .field("field2", (String) null)
                                 .endObject()),
                     XContentType.JSON)));
-        assertThat(e.getMessage(), equalTo("mapping set to strict, dynamic introduction of [field2] within [_doc] is not allowed"));
+        assertThat(e.getMessage(), equalTo("mapping set to strict, dynamic introduction of [field2] within [type] is not allowed"));
     }
 
     public void testDynamicFalseWithInnerObjectButDynamicSetOnRoot() throws IOException {
@@ -234,10 +234,10 @@ public void testField() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc").endObject()
+                .startObject("type").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().field("foo", "bar").endObject());
@@ -245,7 +245,7 @@ public void testField() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
                 .startObject("foo")
                     .field("type", "text")
                     .startObject("fields")
@@ -263,11 +263,11 @@ public void testIncremental() throws Exception {
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         // Make sure that mapping updates are incremental, this is important for performance otherwise
         // every new field introduction runs in linear time with the total number of fields
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("foo").field("type", "text").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().field("foo", "bar")
@@ -276,7 +276,7 @@ public void testIncremental() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
                 // foo is NOT in the update
                 .startObject("bar").field("type", "text")
                     .startObject("fields")
@@ -293,10 +293,10 @@ public void testIntroduceTwoFields() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc").endObject()
+                .startObject("type").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().field("foo", "bar")
@@ -305,7 +305,7 @@ public void testIntroduceTwoFields() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
                 .startObject("bar").field("type", "text")
                     .startObject("fields")
                         .startObject("keyword")
@@ -329,10 +329,10 @@ public void testObject() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc").endObject()
+                .startObject("type").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().startObject("foo").startObject("bar")
@@ -341,7 +341,7 @@ public void testObject() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
                 .startObject("foo").startObject("properties").startObject("bar").startObject("properties").startObject("baz")
                 .field("type", "text")
                 .startObject("fields").startObject("keyword").field("type", "keyword")
@@ -354,10 +354,10 @@ public void testArray() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc").endObject()
+                .startObject("type").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject()
@@ -366,7 +366,7 @@ public void testArray() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
                 .startObject("foo")
                     .field("type", "text")
                     .startObject("fields")
@@ -382,11 +382,11 @@ public void testArray() throws Exception {
     public void testInnerDynamicMapping() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc") .startObject("properties")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type") .startObject("properties")
                 .startObject("foo").field("type", "object").endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().startObject("foo")
@@ -395,7 +395,7 @@ public void testInnerDynamicMapping() throws Exception {
         // original mapping not modified
         assertEquals(mapping, serialize(mapper));
         // but we have an update
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
                 .startObject("foo").startObject("properties").startObject("bar").startObject("properties")
                 .startObject("baz").field("type", "text").startObject("fields")
                 .startObject("keyword").field("type", "keyword").field("ignore_above", 256).endObject()
@@ -407,10 +407,10 @@ public void testComplexArray() throws Exception {
         IndexService indexService = createIndex("test");
         DocumentMapperParser parser = indexService.mapperService().documentMapperParser();
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc").endObject()
+                .startObject("type").endObject()
                 .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, serialize(mapper));
 
         Mapper update = parse(mapper, parser, XContentFactory.jsonBuilder().startObject().startArray("foo")
@@ -418,7 +418,7 @@ public void testComplexArray() throws Exception {
                 .startObject().field("baz", 3).endObject()
                 .endArray().endObject());
         assertEquals(mapping, serialize(mapper));
-        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
+        assertEquals(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties")
                 .startObject("foo").startObject("properties")
                 .startObject("bar").field("type", "text")
                     .startObject("fields")
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/FieldAliasMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/FieldAliasMapperTests.java
index e09953d31abc8..9f87ad3d0390a 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/FieldAliasMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/FieldAliasMapperTests.java
@@ -43,7 +43,7 @@ public void setup() {
     public void testParsing() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
             .startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("alias-field")
                             .field("type", "alias")
@@ -55,7 +55,7 @@ public void testParsing() throws IOException {
                     .endObject()
                 .endObject()
             .endObject());
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/IpFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/IpFieldMapperTests.java
index 1adc12548c090..a34adaca2f144 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/IpFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/IpFieldMapperTests.java
@@ -60,11 +60,11 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "ip").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -89,11 +89,11 @@ public void testDefaults() throws Exception {
     }
 
     public void testNotIndexed() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "ip").field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -111,11 +111,11 @@ public void testNotIndexed() throws Exception {
     }
 
     public void testNoDocValues() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "ip").field("doc_values", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -134,11 +134,11 @@ public void testNoDocValues() throws Exception {
     }
 
     public void testStore() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "ip").field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -162,11 +162,11 @@ public void testStore() throws Exception {
     }
 
     public void testIgnoreMalformed() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "ip").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -199,7 +199,7 @@ public void testIgnoreMalformed() throws Exception {
 
     public void testNullValue() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "ip")
@@ -207,7 +207,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -219,7 +219,7 @@ public void testNullValue() throws IOException {
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "ip")
@@ -228,7 +228,7 @@ public void testNullValue() throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         doc = mapper.parse(new SourceToParse("test", "1", BytesReference
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/IpRangeFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/IpRangeFieldMapperTests.java
index 0c4b11004b460..2f861ca6fc79c 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/IpRangeFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/IpRangeFieldMapperTests.java
@@ -48,11 +48,11 @@ public void setup() {
     }
 
     public void testStoreCidr() throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", "ip_range")
             .field("store", true);
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
         final Map<String, String> cases = new HashMap<>();
         cases.put("192.168.0.0/15", "192.169.255.255");
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
index c2063d1478a9b..fd821f1170ce8 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/KeywordFieldMapperTests.java
@@ -94,11 +94,11 @@ public void setup() {
     }
 
     public void testDefaults() throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -131,11 +131,11 @@ public void testDefaults() throws Exception {
     }
 
     public void testIgnoreAbove() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword").field("ignore_above", 5).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -161,11 +161,11 @@ public void testIgnoreAbove() throws IOException {
     }
 
     public void testNullValue() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -176,11 +176,11 @@ public void testNullValue() throws IOException {
                 XContentType.JSON));
         assertArrayEquals(new IndexableField[0], doc.rootDoc().getFields("field"));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword").field("null_value", "uri").endObject().endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -206,11 +206,11 @@ public void testNullValue() throws IOException {
     }
 
     public void testEnableStore() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword").field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -227,11 +227,11 @@ public void testEnableStore() throws IOException {
     }
 
     public void testDisableIndex() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword").field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -249,11 +249,11 @@ public void testDisableIndex() throws IOException {
     }
 
     public void testDisableDocValues() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword").field("doc_values", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -270,12 +270,12 @@ public void testDisableDocValues() throws IOException {
     }
 
     public void testIndexOptions() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword")
                 .field("index_options", "freqs").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -302,17 +302,17 @@ public void testIndexOptions() throws IOException {
     }
 
     public void testBoost() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "keyword").field("boost", 2f).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
     }
 
     public void testEnableNorms() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties")
                 .startObject("field")
                     .field("type", "keyword")
@@ -322,7 +322,7 @@ public void testEnableNorms() throws IOException {
             .endObject()
         .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -341,12 +341,12 @@ public void testEnableNorms() throws IOException {
     }
 
     public void testNormalizer() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                 .field("type", "keyword").field("normalizer", "my_lowercase").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/LegacyGeoShapeFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/LegacyGeoShapeFieldMapperTests.java
index df6b43d041acf..d53eb0bcac134 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/LegacyGeoShapeFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/LegacyGeoShapeFieldMapperTests.java
@@ -53,7 +53,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaultConfiguration() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
                 .startObject("properties").startObject("location")
                     .field("type", "geo_shape")
                     .field("strategy", "recursive")
@@ -61,7 +61,7 @@ public void testDefaultConfiguration() throws IOException {
                 .endObject().endObject());
 
         DocumentMapper defaultMapper = createIndex("test").mapperService().documentMapperParser()
-            .parse("_doc", new CompressedXContent(mapping));
+            .parse("type1", new CompressedXContent(mapping));
         Mapper fieldMapper = defaultMapper.mappers().getMapper("location");
         assertThat(fieldMapper, instanceOf(LegacyGeoShapeFieldMapper.class));
         assertEquals(mapping, defaultMapper.mappingSource().toString());
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldTests.java b/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldTests.java
index d6dfe8054f4b5..f32608b53c79b 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/MultiFieldTests.java
@@ -186,7 +186,7 @@ public void testMultiFieldsInConsistentOrder() throws Exception {
             XContentHelper.convertToMap(docMapper.mappingSource().compressedReference(), true, builder.contentType()).v2();
         @SuppressWarnings("unchecked")
         Map<String, Object> multiFields =
-            (Map<String, Object>) XContentMapValues.extractValue("_doc.properties.my_field.fields", sourceAsMap);
+            (Map<String, Object>) XContentMapValues.extractValue("type.properties.my_field.fields", sourceAsMap);
         assertThat(multiFields.size(), equalTo(multiFieldNames.length));
 
         int i = 0;
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/NumberFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/NumberFieldMapperTests.java
index 3181a92434121..a1322c6614456 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/NumberFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/NumberFieldMapperTests.java
@@ -53,11 +53,11 @@ protected void setTypeList() {
 
     @Override
     public void doTestDefaults(String type) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", type).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -81,11 +81,11 @@ public void doTestDefaults(String type) throws Exception {
 
     @Override
     public void doTestNotIndexed(String type) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", type).field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -104,11 +104,11 @@ public void doTestNotIndexed(String type) throws Exception {
 
     @Override
     public void doTestNoDocValues(String type) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", type).field("doc_values", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -128,11 +128,11 @@ public void doTestNoDocValues(String type) throws Exception {
 
     @Override
     public void doTestStore(String type) throws Exception {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", type).field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -157,11 +157,11 @@ public void doTestStore(String type) throws Exception {
 
     @Override
     public void doTestCoerce(String type) throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", type).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -180,11 +180,11 @@ public void doTestCoerce(String type) throws IOException {
         IndexableField dvField = fields[1];
         assertEquals(DocValuesType.SORTED_NUMERIC, dvField.fieldType().docValuesType());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", type).field("coerce", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper2.mappingSource().toString());
 
@@ -200,11 +200,11 @@ public void doTestCoerce(String type) throws IOException {
 
     @Override
     protected void doTestDecimalCoerce(String type) throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", type).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -223,10 +223,10 @@ protected void doTestDecimalCoerce(String type) throws IOException {
     public void testIgnoreMalformed() throws Exception {
         for (String type : TYPES) {
             for (Object malformedValue : new Object[] { "a", Boolean.FALSE }) {
-                String mapping = Strings.toString(jsonBuilder().startObject().startObject("_doc").startObject("properties")
+                String mapping = Strings.toString(jsonBuilder().startObject().startObject("type").startObject("properties")
                         .startObject("field").field("type", type).endObject().endObject().endObject().endObject());
 
-                DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+                DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
                 assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -240,10 +240,10 @@ public void testIgnoreMalformed() throws Exception {
                     assertThat(e.getCause().getMessage(), containsString("not numeric, can not use numeric value accessors"));
                 }
 
-                mapping = Strings.toString(jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field")
+                mapping = Strings.toString(jsonBuilder().startObject().startObject("type").startObject("properties").startObject("field")
                         .field("type", type).field("ignore_malformed", true).endObject().endObject().endObject().endObject());
 
-                DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(mapping));
+                DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(mapping));
 
                 ParsedDocument doc = mapper2.parse(new SourceToParse("test", "1",
                         BytesReference.bytes(jsonBuilder().startObject().field("field", malformedValue).endObject()), XContentType.JSON));
@@ -268,9 +268,9 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             };
             for (Boolean ignoreMalformed : new Boolean[] { true, false }) {
                 String mapping = Strings.toString(
-                        jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field").field("type", type)
+                        jsonBuilder().startObject().startObject("type").startObject("properties").startObject("field").field("type", type)
                                 .field("ignore_malformed", ignoreMalformed).endObject().endObject().endObject().endObject());
-                DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+                DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
                 assertEquals(mapping, mapper.mappingSource().toString());
 
                 MapperParsingException e = expectThrows(MapperParsingException.class,
@@ -287,7 +287,7 @@ public void testRejectNorms() throws IOException {
         // not supported as of 5.0
         for (String type : TYPES) {
             DocumentMapperParser parser = createIndex("index-" + type).mapperService().documentMapperParser();
-            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("foo")
                         .field("type", type)
@@ -295,7 +295,7 @@ public void testRejectNorms() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
             MapperParsingException e = expectThrows(MapperParsingException.class,
-                    () -> parser.parse("_doc", new CompressedXContent(mapping)));
+                    () -> parser.parse("type", new CompressedXContent(mapping)));
             assertThat(e.getMessage(), containsString("Mapping definition for [foo] has unsupported parameters:  [norms"));
         }
     }
@@ -322,7 +322,7 @@ public void testRejectIndexOptions() throws IOException {
     @Override
     protected void doTestNullValue(String type) throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", type)
@@ -330,7 +330,7 @@ protected void doTestNullValue(String type) throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference
@@ -348,7 +348,7 @@ protected void doTestNullValue(String type) throws IOException {
             missing = 123L;
         }
         mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", type)
@@ -357,7 +357,7 @@ protected void doTestNullValue(String type) throws IOException {
                     .endObject()
                 .endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         doc = mapper.parse(new SourceToParse("test", "1", BytesReference
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/ObjectMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/ObjectMapperTests.java
index 154ebf30f5984..7672eb3df26b6 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/ObjectMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/ObjectMapperTests.java
@@ -181,6 +181,24 @@ public void testMerge() throws IOException {
         assertEquals(Dynamic.STRICT, mapper.root().dynamic());
     }
 
+    public void testEmptyName() throws Exception {
+        String mapping = Strings.toString(XContentFactory.jsonBuilder()
+            .startObject()
+                .startObject("")
+                    .startObject("properties")
+                        .startObject("name")
+                            .field("type", "text")
+                        .endObject()
+                    .endObject()
+                .endObject().endObject());
+
+        // Empty name not allowed in index created after 5.0
+        IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> {
+            createIndex("test").mapperService().documentMapperParser().parse("", new CompressedXContent(mapping));
+        });
+        assertThat(e.getMessage(), containsString("name cannot be empty string"));
+    }
+
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
         return pluginList(InternalSettingsPlugin.class);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldMapperTests.java
index 4c8b7c3794280..d713988e19197 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/RangeFieldMapperTests.java
@@ -111,14 +111,14 @@ private Object getMax(String type) {
 
     @Override
     public void doTestDefaults(String type) throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", type);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference.bytes(XContentFactory.jsonBuilder()
@@ -142,14 +142,14 @@ public void doTestDefaults(String type) throws Exception {
 
     @Override
     protected void doTestNotIndexed(String type) throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", type).field("index", false);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference.bytes(XContentFactory.jsonBuilder()
@@ -167,13 +167,13 @@ protected void doTestNotIndexed(String type) throws Exception {
 
     @Override
     protected void doTestNoDocValues(String type) throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", type).field("doc_values", false);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference.bytes(XContentFactory.jsonBuilder()
@@ -193,13 +193,13 @@ protected void doTestNoDocValues(String type) throws Exception {
 
     @Override
     protected void doTestStore(String type) throws Exception {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", type).field("store", true);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         ParsedDocument doc = mapper.parse(new SourceToParse("test", "1", BytesReference.bytes(XContentFactory.jsonBuilder()
@@ -231,13 +231,13 @@ protected void doTestStore(String type) throws Exception {
 
     @Override
     public void doTestCoerce(String type) throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", type);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
 
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
@@ -260,9 +260,9 @@ public void doTestCoerce(String type) throws IOException {
         // date_range ignores the coerce parameter and epoch_millis date format truncates floats (see issue: #14641)
         if (type.equals("date_range") == false) {
 
-            mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties").startObject("field")
+            mapping = XContentFactory.jsonBuilder().startObject().startObject("type").startObject("properties").startObject("field")
                     .field("type", type).field("coerce", false).endObject().endObject().endObject().endObject();
-            DocumentMapper mapper2 = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+            DocumentMapper mapper2 = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
 
             assertEquals(Strings.toString(mapping), mapper2.mappingSource().toString());
 
@@ -279,11 +279,11 @@ public void doTestCoerce(String type) throws IOException {
 
     @Override
     protected void doTestDecimalCoerce(String type) throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", type);
 
         mapping = mapping.endObject().endObject().endObject().endObject();
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
 
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
@@ -313,14 +313,14 @@ protected void doTestDecimalCoerce(String type) throws IOException {
 
     @Override
     protected void doTestNullValue(String type) throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", type).field("store", true);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         // test null value for min and max
@@ -383,14 +383,14 @@ public void testNoBounds() throws Exception {
     }
 
     public void doTestNoBounds(String type) throws IOException {
-        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        XContentBuilder mapping = XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties").startObject("field").field("type", type).field("store", true);
         if (type.equals("date_range")) {
             mapping = mapping.field("format", DATE_FORMAT);
         }
         mapping = mapping.endObject().endObject().endObject().endObject();
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(Strings.toString(mapping)));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(Strings.toString(mapping)));
         assertEquals(Strings.toString(mapping), mapper.mappingSource().toString());
 
         // test no bounds specified
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/RootObjectMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/RootObjectMapperTests.java
index 8946d7a235420..0b805eb726646 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/RootObjectMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/RootObjectMapperTests.java
@@ -32,99 +32,99 @@ public class RootObjectMapperTests extends ESSingleNodeTestCase {
     public void testNumericDetection() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("_doc")
+                    .startObject("type")
                         .field("numeric_detection", false)
                     .endObject()
                 .endObject());
         MapperService mapperService = createIndex("test").mapperService();
-        DocumentMapper mapper = mapperService.merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        DocumentMapper mapper = mapperService.merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         // update with a different explicit value
         String mapping2 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .field("numeric_detection", true)
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("_doc", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("type", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping2, mapper.mappingSource().toString());
 
         // update with an implicit value: no change
         String mapping3 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("_doc")
+                .startObject("type")
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("_doc", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("type", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping2, mapper.mappingSource().toString());
     }
 
     public void testDateDetection() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("_doc")
+                    .startObject("type")
                         .field("date_detection", true)
                     .endObject()
                 .endObject());
         MapperService mapperService = createIndex("test").mapperService();
-        DocumentMapper mapper = mapperService.merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        DocumentMapper mapper = mapperService.merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         // update with a different explicit value
         String mapping2 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .field("date_detection", false)
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("_doc", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("type", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping2, mapper.mappingSource().toString());
 
         // update with an implicit value: no change
         String mapping3 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("_doc")
+                .startObject("type")
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("_doc", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("type", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping2, mapper.mappingSource().toString());
     }
 
     public void testDateFormatters() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("_doc")
+                    .startObject("type")
                         .field("dynamic_date_formats", Arrays.asList("yyyy-MM-dd"))
                     .endObject()
                 .endObject());
         MapperService mapperService = createIndex("test").mapperService();
-        DocumentMapper mapper = mapperService.merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        DocumentMapper mapper = mapperService.merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         // no update if formatters are not set explicitly
         String mapping2 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("_doc")
+                .startObject("type")
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("_doc", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("type", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         String mapping3 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .field("dynamic_date_formats", Arrays.asList())
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("_doc", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("type", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping3, mapper.mappingSource().toString());
     }
 
     public void testDynamicTemplates() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                    .startObject("_doc")
+                    .startObject("type")
                         .startArray("dynamic_templates")
                             .startObject()
                                 .startObject("my_template")
@@ -138,25 +138,25 @@ public void testDynamicTemplates() throws Exception {
                     .endObject()
                 .endObject());
         MapperService mapperService = createIndex("test").mapperService();
-        DocumentMapper mapper = mapperService.merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        DocumentMapper mapper = mapperService.merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         // no update if templates are not set explicitly
         String mapping2 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("_doc")
+                .startObject("type")
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("_doc", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("type", new CompressedXContent(mapping2), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping, mapper.mappingSource().toString());
 
         String mapping3 = Strings.toString(XContentFactory.jsonBuilder()
                 .startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .field("dynamic_templates", Arrays.asList())
                 .endObject()
             .endObject());
-        mapper = mapperService.merge("_doc", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
+        mapper = mapperService.merge("type", new CompressedXContent(mapping3), MergeReason.MAPPING_UPDATE);
         assertEquals(mapping3, mapper.mappingSource().toString());
     }
 
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
index 25c59fb26ddb1..cbfbb4a05c973 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
@@ -121,13 +121,13 @@ public void testExcludes() throws Exception {
     }
 
     private void assertConflicts(String mapping1, String mapping2, DocumentMapperParser parser, String... conflicts) throws IOException {
-        DocumentMapper docMapper = parser.parse("_doc", new CompressedXContent(mapping1));
-        docMapper = parser.parse("_doc", docMapper.mappingSource());
+        DocumentMapper docMapper = parser.parse("type", new CompressedXContent(mapping1));
+        docMapper = parser.parse("type", docMapper.mappingSource());
         if (conflicts.length == 0) {
-            docMapper.merge(parser.parse("_doc", new CompressedXContent(mapping2)).mapping());
+            docMapper.merge(parser.parse("type", new CompressedXContent(mapping2)).mapping());
         } else {
             try {
-                docMapper.merge(parser.parse("_doc", new CompressedXContent(mapping2)).mapping());
+                docMapper.merge(parser.parse("type", new CompressedXContent(mapping2)).mapping());
                 fail();
             } catch (IllegalArgumentException e) {
                 for (String conflict : conflicts) {
@@ -140,14 +140,14 @@ private void assertConflicts(String mapping1, String mapping2, DocumentMapperPar
     public void testEnabledNotUpdateable() throws Exception {
         DocumentMapperParser parser = createIndex("test").mapperService().documentMapperParser();
         // using default of true
-        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").endObject().endObject());
-        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").endObject().endObject());
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("_source").field("enabled", false).endObject()
             .endObject().endObject());
         assertConflicts(mapping1, mapping2, parser, "Cannot update enabled setting for [_source]");
 
         // not changing is ok
-        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping3 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("_source").field("enabled", true).endObject()
             .endObject().endObject());
         assertConflicts(mapping1, mapping3, parser);
@@ -155,14 +155,14 @@ public void testEnabledNotUpdateable() throws Exception {
 
     public void testIncludesNotUpdateable() throws Exception {
         DocumentMapperParser parser = createIndex("test").mapperService().documentMapperParser();
-        String defaultMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").endObject().endObject());
-        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String defaultMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").endObject().endObject());
+        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("_source").array("includes", "foo.*").endObject()
             .endObject().endObject());
         assertConflicts(defaultMapping, mapping1, parser, "Cannot update includes setting for [_source]");
         assertConflicts(mapping1, defaultMapping, parser, "Cannot update includes setting for [_source]");
 
-        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("_source").array("includes", "foo.*", "bar.*").endObject()
             .endObject().endObject());
         assertConflicts(mapping1, mapping2, parser, "Cannot update includes setting for [_source]");
@@ -173,14 +173,14 @@ public void testIncludesNotUpdateable() throws Exception {
 
     public void testExcludesNotUpdateable() throws Exception {
         DocumentMapperParser parser = createIndex("test").mapperService().documentMapperParser();
-        String defaultMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc").endObject().endObject());
-        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String defaultMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type").endObject().endObject());
+        String mapping1 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("_source").array("excludes", "foo.*").endObject()
             .endObject().endObject());
         assertConflicts(defaultMapping, mapping1, parser, "Cannot update excludes setting for [_source]");
         assertConflicts(mapping1, defaultMapping, parser, "Cannot update excludes setting for [_source]");
 
-        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping2 = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("_source").array("excludes", "foo.*", "bar.*").endObject()
             .endObject().endObject());
         assertConflicts(mapping1, mapping2, parser, "Cannot update excludes setting for [_source]");
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
index 6d73ed8cfb1bc..539d8bbdeaf59 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/TextFieldMapperTests.java
@@ -106,11 +106,11 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
     }
 
     public void testDefaults() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "text").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -138,11 +138,11 @@ public void testDefaults() throws IOException {
     }
 
     public void testEnableStore() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "text").field("store", true).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -159,11 +159,11 @@ public void testEnableStore() throws IOException {
     }
 
     public void testDisableIndex() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "text").field("index", false).endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -179,14 +179,14 @@ public void testDisableIndex() throws IOException {
     }
 
     public void testDisableNorms() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("norms", false)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
 
@@ -234,11 +234,11 @@ public void testIndexOptions() throws IOException {
     }
 
     public void testDefaultPositionIncrementGap() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field").field("type", "text").endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+        DocumentMapper mapper = indexService.mapperService().merge("type",
                 new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         assertEquals(mapping, mapper.mappingSource().toString());
@@ -273,14 +273,14 @@ public void testDefaultPositionIncrementGap() throws IOException {
 
     public void testPositionIncrementGap() throws IOException {
         final int positionIncrementGap = randomIntBetween(1, 1000);
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("position_increment_gap", positionIncrementGap)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = indexService.mapperService().merge("_doc",
+        DocumentMapper mapper = indexService.mapperService().merge("type",
                 new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         assertEquals(mapping, mapper.mappingSource().toString());
@@ -314,7 +314,7 @@ public void testPositionIncrementGap() throws IOException {
     }
 
     public void testSearchAnalyzerSerialization() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "text")
@@ -323,11 +323,11 @@ public void testSearchAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default index analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "text")
@@ -336,10 +336,10 @@ public void testSearchAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties")
             .startObject("field")
             .field("type", "text")
@@ -347,11 +347,11 @@ public void testSearchAnalyzerSerialization() throws IOException {
             .endObject()
             .endObject().endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default search analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties")
             .startObject("field")
             .field("type", "text")
@@ -360,17 +360,17 @@ public void testSearchAnalyzerSerialization() throws IOException {
             .endObject()
             .endObject().endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties")
             .startObject("field")
             .field("type", "text")
             .field("analyzer", "keyword")
             .endObject()
             .endObject().endObject().endObject());
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
 
         XContentBuilder builder = XContentFactory.jsonBuilder();
         builder.startObject();
@@ -384,7 +384,7 @@ public void testSearchAnalyzerSerialization() throws IOException {
     }
 
     public void testSearchQuoteAnalyzerSerialization() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "text")
@@ -394,11 +394,11 @@ public void testSearchQuoteAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
 
         // special case: default index/search analyzer
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "text")
@@ -408,7 +408,7 @@ public void testSearchQuoteAnalyzerSerialization() throws IOException {
                     .endObject()
                 .endObject().endObject().endObject());
 
-        mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping,  mapper.mappingSource().toString());
     }
 
@@ -488,14 +488,14 @@ public void testTermVectors() throws IOException {
     }
 
     public void testEagerGlobalOrdinals() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("eager_global_ordinals", true)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         FieldMapper fieldMapper = (FieldMapper) mapper.mappers().getMapper("field");
@@ -503,13 +503,13 @@ public void testEagerGlobalOrdinals() throws IOException {
     }
 
     public void testFielddata() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper disabledMapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper disabledMapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, disabledMapper.mappingSource().toString());
         IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> {
             FieldMapper fieldMapper = (FieldMapper) disabledMapper.mappers().getMapper("field");
@@ -517,14 +517,14 @@ public void testFielddata() throws IOException {
         });
         assertThat(e.getMessage(), containsString("Fielddata is disabled"));
 
-        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("fielddata", true)
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper enabledMapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper enabledMapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, enabledMapper.mappingSource().toString());
 
@@ -544,7 +544,7 @@ public void testFielddata() throws IOException {
     }
 
     public void testFrequencyFilter() throws IOException {
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                     .field("type", "text")
                     .field("fielddata", true)
@@ -555,7 +555,7 @@ public void testFrequencyFilter() throws IOException {
                 .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
 
         assertEquals(mapping, mapper.mappingSource().toString());
         TextFieldMapper fieldMapper = (TextFieldMapper) mapper.mappers().getMapper("field");
@@ -778,7 +778,7 @@ public void testFastPhraseMapping() throws IOException {
                 throw new UnsupportedOperationException();
             }, null);
 
-        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+        String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
             .startObject("properties")
             .startObject("field")
             .field("type", "text")
@@ -793,10 +793,10 @@ public void testFastPhraseMapping() throws IOException {
             .endObject()
             .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
-        queryShardContext.getMapperService().merge("_doc", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
+        queryShardContext.getMapperService().merge("type", new CompressedXContent(mapping), MergeReason.MAPPING_UPDATE);
 
         Query q = new MatchPhraseQueryBuilder("field", "two words").toQuery(queryShardContext);
         assertThat(q, is(new PhraseQuery("field._index_phrase", "two words")));
@@ -862,7 +862,7 @@ protected TokenStreamComponents createComponents(String fieldName) {
         }
 
         {
-            String badConfigMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+            String badConfigMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                 .field("type", "text")
                 .field("index", "false")
@@ -870,13 +870,13 @@ protected TokenStreamComponents createComponents(String fieldName) {
                 .endObject().endObject()
                 .endObject().endObject());
             IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                () -> parser.parse("_doc", new CompressedXContent(badConfigMapping))
+                () -> parser.parse("type", new CompressedXContent(badConfigMapping))
             );
             assertThat(e.getMessage(), containsString("Cannot set index_phrases on unindexed field [field]"));
         }
 
         {
-            String badConfigMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+            String badConfigMapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                 .field("type", "text")
                 .field("index_options", "freqs")
@@ -884,7 +884,7 @@ protected TokenStreamComponents createComponents(String fieldName) {
                 .endObject().endObject()
                 .endObject().endObject());
             IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                () -> parser.parse("_doc", new CompressedXContent(badConfigMapping))
+                () -> parser.parse("type", new CompressedXContent(badConfigMapping))
             );
             assertThat(e.getMessage(), containsString("Cannot set index_phrases on field [field] if positions are not enabled"));
         }
@@ -893,7 +893,7 @@ protected TokenStreamComponents createComponents(String fieldName) {
     public void testIndexPrefixMapping() throws IOException {
 
         {
-            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
+            String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type")
                 .startObject("properties").startObject("field")
                 .field("type", "text")
                 .field("analyzer", "standard")
@@ -904,7 +904,7 @@ public void testIndexPrefixMapping() throws IOException {
                 .endObject().endObject()
                 .endObject().endObject());
 
-            DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+            DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
             assertEquals(mapping, mapper.mappingSource().toString());
 
             assertThat(mapper.mappers().getMapper("field._index_prefix").toString(), containsString("prefixChars=2:10"));
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/TypeFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/TypeFieldMapperTests.java
index 689dfbdcc872d..1ef68cf42d166 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/TypeFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/TypeFieldMapperTests.java
@@ -75,7 +75,7 @@ public static void testDocValues(Function<String, IndexService> createIndex) thr
         assertTrue(values.advanceExact(0));
         assertEquals(0, values.nextOrd());
         assertEquals(SortedSetDocValues.NO_MORE_ORDS, values.nextOrd());
-        assertEquals(new BytesRef("_doc"), values.lookupOrd(0));
+        assertEquals(new BytesRef("type"), values.lookupOrd(0));
         r.close();
         dir.close();
     }
diff --git a/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectFieldMapperTests.java b/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectFieldMapperTests.java
index 44dfc11898016..aeb22c331b355 100644
--- a/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectFieldMapperTests.java
+++ b/x-pack/plugin/mapper-flattened/src/test/java/org/elasticsearch/xpack/flattened/mapper/FlatObjectFieldMapperTests.java
@@ -56,7 +56,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
 
     public void testDefaults() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -65,7 +65,7 @@ public void testDefaults() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -111,7 +111,7 @@ public void testDefaults() throws Exception {
 
     public void testDisableIndex() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -121,7 +121,7 @@ public void testDisableIndex() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -143,7 +143,7 @@ public void testDisableIndex() throws Exception {
 
     public void testDisableDocValues() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -153,7 +153,7 @@ public void testDisableDocValues() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -195,7 +195,7 @@ public void testEnableStore() throws Exception {
 
     public void testIndexOptions() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -205,12 +205,12 @@ public void testIndexOptions() throws IOException {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         for (String indexOptions : Arrays.asList("positions", "offsets")) {
             String invalidMapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-                .startObject("_doc")
+                .startObject("type")
                     .startObject("properties")
                         .startObject("field")
                             .field("type", "flattened")
@@ -220,14 +220,14 @@ public void testIndexOptions() throws IOException {
                 .endObject()
             .endObject());
             IllegalArgumentException e = expectThrows(IllegalArgumentException.class,
-                    () -> parser.parse("_doc", new CompressedXContent(invalidMapping)));
+                    () -> parser.parse("type", new CompressedXContent(invalidMapping)));
             assertEquals("The [flattened] field does not support positions, got [index_options]=" + indexOptions, e.getMessage());
         }
     }
 
     public void testNullField() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -236,7 +236,7 @@ public void testNullField() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -250,7 +250,7 @@ public void testNullField() throws Exception {
 
     public void testMalformedJson() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -259,7 +259,7 @@ public void testMalformedJson() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc1 = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -276,7 +276,7 @@ public void testMalformedJson() throws Exception {
 
     public void testFieldMultiplicity() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -285,7 +285,7 @@ public void testFieldMultiplicity() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -318,7 +318,7 @@ public void testFieldMultiplicity() throws Exception {
     public void testDepthLimit() throws IOException {
         // First verify the default behavior when depth_limit is not set.
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -327,7 +327,7 @@ public void testDepthLimit() throws IOException {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -344,7 +344,7 @@ public void testDepthLimit() throws IOException {
 
         // Set a lower value for depth_limit and check that the field is rejected.
         String newMapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -355,7 +355,7 @@ public void testDepthLimit() throws IOException {
         .endObject());
 
         DocumentMapper newMapper = mapper.merge(
-            parser.parse("_doc", new CompressedXContent(newMapping)).mapping());
+            parser.parse("type", new CompressedXContent(newMapping)).mapping());
 
         expectThrows(MapperParsingException.class, () ->
             newMapper.parse(new SourceToParse("test", "1", doc, XContentType.JSON)));
@@ -363,7 +363,7 @@ public void testDepthLimit() throws IOException {
 
     public void testEagerGlobalOrdinals() throws IOException {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -371,7 +371,7 @@ public void testEagerGlobalOrdinals() throws IOException {
                     .endObject().endObject()
                 .endObject().endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         FieldMapper fieldMapper = (FieldMapper) mapper.mappers().getMapper("field");
@@ -381,7 +381,7 @@ public void testEagerGlobalOrdinals() throws IOException {
     public void testIgnoreAbove() throws IOException {
         // First verify the default behavior when ignore_above is not set.
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -390,7 +390,7 @@ public void testIgnoreAbove() throws IOException {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()
@@ -427,7 +427,7 @@ public void testIgnoreAbove() throws IOException {
 
     public void testNullValues() throws Exception {
         String mapping = Strings.toString(XContentFactory.jsonBuilder().startObject()
-            .startObject("_doc")
+            .startObject("type")
                 .startObject("properties")
                     .startObject("field")
                         .field("type", "flattened")
@@ -440,7 +440,7 @@ public void testNullValues() throws Exception {
             .endObject()
         .endObject());
 
-        DocumentMapper mapper = parser.parse("_doc", new CompressedXContent(mapping));
+        DocumentMapper mapper = parser.parse("type", new CompressedXContent(mapping));
         assertEquals(mapping, mapper.mappingSource().toString());
 
         BytesReference doc = BytesReference.bytes(XContentFactory.jsonBuilder().startObject()

From 9c850606b5535fca53cb0d929ca13dfcf0d939db Mon Sep 17 00:00:00 2001
From: Hendrik Muhs <hendrik.muhs@elastic.co>
Date: Mon, 20 Jan 2020 13:52:19 +0100
Subject: [PATCH 664/686] check custom meta data to avoid NPE (#51163)

check custom meta data to avoid NPE, fixes a problem introduced in #51072

fixes #51153
---
 .../action/TransportStopTransformAction.java   | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
index 4cea47c399238..32bc9b7c90d19 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/action/TransportStopTransformAction.java
@@ -141,14 +141,16 @@ static Tuple<Set<String>, Set<String>> findTasksWithoutConfig(ClusterState state
         Set<String> taskIds = new HashSet<>();
         Set<String> executorNodes = new HashSet<>();
 
-        Predicate<PersistentTask<?>> taskMatcher = Strings.isAllOrWildcard(new String[] { transformId }) ? t -> true : t -> {
-            TransformTaskParams transformParams = (TransformTaskParams) t.getParams();
-            return Regex.simpleMatch(transformId, transformParams.getId());
-        };
-
-        for (PersistentTasksCustomMetaData.PersistentTask<?> pTask : tasks.findTasks(TransformField.TASK_NAME, taskMatcher)) {
-            executorNodes.add(pTask.getExecutorNode());
-            taskIds.add(pTask.getId());
+        if (tasks != null) {
+            Predicate<PersistentTask<?>> taskMatcher = Strings.isAllOrWildcard(new String[] { transformId }) ? t -> true : t -> {
+                TransformTaskParams transformParams = (TransformTaskParams) t.getParams();
+                return Regex.simpleMatch(transformId, transformParams.getId());
+            };
+
+            for (PersistentTasksCustomMetaData.PersistentTask<?> pTask : tasks.findTasks(TransformField.TASK_NAME, taskMatcher)) {
+                executorNodes.add(pTask.getExecutorNode());
+                taskIds.add(pTask.getId());
+            }
         }
 
         return new Tuple<>(taskIds, executorNodes);

From 5b667b7d874ac19caf1276c69db7e76538fa4331 Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Mon, 20 Jan 2020 15:21:17 +0200
Subject: [PATCH 665/686] Add trace logging for responses coming from server
 (#50530)

---
 .../execution/search/CompositeAggCursor.java  |  5 ++-
 .../xpack/sql/execution/search/Querier.java   | 31 ++++++++++++++++++-
 .../sql/execution/search/ScrollCursor.java    |  5 ++-
 3 files changed, 38 insertions(+), 3 deletions(-)

diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggCursor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggCursor.java
index c165343f20371..182372d4cd989 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggCursor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/CompositeAggCursor.java
@@ -46,7 +46,7 @@
  */
 public class CompositeAggCursor implements Cursor {
 
-    private final Logger log = LogManager.getLogger(getClass());
+    private static final Logger log = LogManager.getLogger(CompositeAggCursor.class);
 
     public static final String NAME = "c";
 
@@ -167,6 +167,9 @@ static void handle(SearchResponse response, SearchSourceBuilder source,
             ActionListener<Page> listener,
             Schema schema) {
         
+        if (log.isTraceEnabled()) {
+            Querier.logSearchResponse(response, log);
+        }
         // there are some results
         if (response.getAggregations().asList().isEmpty() == false) {
             // retry
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
index 0645f274b4342..b84b75cbdcfda 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/Querier.java
@@ -70,6 +70,7 @@
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.BitSet;
+import java.util.Collections;
 import java.util.Comparator;
 import java.util.LinkedHashSet;
 import java.util.List;
@@ -86,7 +87,7 @@
 // TODO: add retry/back-off
 public class Querier {
 
-    private final Logger log = LogManager.getLogger(getClass());
+    private static final Logger log = LogManager.getLogger(Querier.class);
 
     private final PlanExecutor planExecutor;
     private final Configuration cfg;
@@ -149,6 +150,30 @@ public static SearchRequest prepareRequest(Client client, SearchSourceBuilder so
                         includeFrozen ? IndexResolver.FIELD_CAPS_FROZEN_INDICES_OPTIONS : IndexResolver.FIELD_CAPS_INDICES_OPTIONS)
                 .request();
     }
+    
+    protected static void logSearchResponse(SearchResponse response, Logger logger) {
+        List<Aggregation> aggs = Collections.emptyList();
+        if (response.getAggregations() != null) {
+            aggs = response.getAggregations().asList();
+        }
+        StringBuilder aggsNames = new StringBuilder();
+        for (int i = 0; i < aggs.size(); i++) {
+            aggsNames.append(aggs.get(i).getName() + (i + 1 == aggs.size() ? "" : ", "));
+        }
+        
+        logger.trace("Got search response [hits {} {}, {} aggregations: [{}], {} failed shards, {} skipped shards, "
+                + "{} successful shards, {} total shards, took {}, timed out [{}]]",
+                response.getHits().getTotalHits().relation.toString(),
+                response.getHits().getTotalHits().value,
+                aggs.size(),
+                aggsNames,
+                response.getFailedShards(),
+                response.getSkippedShards(),
+                response.getSuccessfulShards(),
+                response.getTotalShards(),
+                response.getTook(),
+                response.isTimedOut());
+    }
 
     /**
      * Listener used for local sorting (typically due to aggregations used inside `ORDER BY`).
@@ -280,6 +305,10 @@ public Aggregations getAggregations() {
 
         @Override
         protected void handleResponse(SearchResponse response, ActionListener<Page> listener) {
+            if (log.isTraceEnabled()) {
+                logSearchResponse(response, log);
+            }
+            
             Aggregations aggs = response.getAggregations();
             if (aggs != null) {
                 Aggregation agg = aggs.get(Aggs.ROOT_GROUP_NAME);
diff --git a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursor.java b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursor.java
index 5df6752198f3b..df6ad34384a96 100644
--- a/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursor.java
+++ b/x-pack/plugin/sql/src/main/java/org/elasticsearch/xpack/sql/execution/search/ScrollCursor.java
@@ -36,7 +36,7 @@
 
 public class ScrollCursor implements Cursor {
 
-    private final Logger log = LogManager.getLogger(getClass());
+    private static final Logger log = LogManager.getLogger(ScrollCursor.class);
 
     public static final String NAME = "s";
 
@@ -113,6 +113,9 @@ public void clear(Configuration cfg, Client client, ActionListener<Boolean> list
     
     static void handle(SearchResponse response, Supplier<SearchHitRowSet> makeRowHit, Consumer<Page> onPage, Consumer<Page> clearScroll,
             Schema schema) {
+        if (log.isTraceEnabled()) {
+            Querier.logSearchResponse(response, log);
+        }
         SearchHit[] hits = response.getHits().getHits();
         // clean-up
         if (hits.length > 0) {

From 3c1529a84dfa1968eb9004f1af30db9c3b1a5d5e Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Mon, 20 Jan 2020 15:29:53 +0200
Subject: [PATCH 666/686] SQL: add support for passing query parameters in REST
 API calls (#51029)

* REST PreparedStatement-like query parameters are now supported in the form of an array of non-object, non-array values where ES SQL parser will try to infer the data type of the value being passed as parameter.
---
 docs/reference/sql/endpoints/rest.asciidoc    |  37 +++-
 .../xpack/sql/qa/rest/RestSqlTestCase.java    |   5 +-
 .../sql/action/AbstractSqlQueryRequest.java   |  96 +++++++++-
 .../xpack/sql/action/SqlQueryRequest.java     |   4 +-
 .../xpack/sql/action/SqlTranslateRequest.java |   1 +
 .../sql/action/SqlQueryRequestTests.java      | 170 ++++++++++++++----
 .../sql/action/SqlRequestParsersTests.java    | 133 +++++++++++++-
 .../xpack/sql/proto/SqlTypedParamValue.java   |  32 +++-
 8 files changed, 427 insertions(+), 51 deletions(-)

diff --git a/docs/reference/sql/endpoints/rest.asciidoc b/docs/reference/sql/endpoints/rest.asciidoc
index 6001005f3de2c..2f9be5da17d65 100644
--- a/docs/reference/sql/endpoints/rest.asciidoc
+++ b/docs/reference/sql/endpoints/rest.asciidoc
@@ -8,6 +8,7 @@
 * <<sql-pagination>>
 * <<sql-rest-filtering>>
 * <<sql-rest-columnar>>
+* <<sql-rest-params>>
 * <<sql-rest-fields>>
 
 [[sql-rest-overview]]
@@ -337,7 +338,7 @@ Which will like return the
 [[sql-rest-filtering]]
 === Filtering using {es} query DSL
 
-You can filter the results that SQL will run on using a standard
+One can filter the results that SQL will run on using a standard
 {es} query DSL by specifying the query in the filter
 parameter.
 
@@ -442,6 +443,36 @@ Which looks like:
 --------------------------------------------------
 // TESTRESPONSE[s/46ToAwFzQERYRjFaWEo1UVc1a1JtVjBZMmdCQUFBQUFBQUFBQUVXWjBaNlFXbzNOV0pVY21Wa1NUZDJhV2t3V2xwblp3PT3\/\/\/\/\/DwQBZgZhdXRob3IBBHRleHQAAAFmBG5hbWUBBHRleHQAAAFmCnBhZ2VfY291bnQBBGxvbmcBAAFmDHJlbGVhc2VfZGF0ZQEIZGF0ZXRpbWUBAAEP/$body.cursor/]
 
+[[sql-rest-params]]
+=== Passing parameters to a query
+
+Using values in a query condition, for example, or in a `HAVING` statement can be done "inline",
+by integrating the value in the query string itself:
+
+[source,console]
+--------------------------------------------------
+POST /_sql?format=txt
+{
+	"query": "SELECT YEAR(release_date) AS year FROM library WHERE page_count > 300 AND author = 'Frank Herbert' GROUP BY year HAVING COUNT(*) > 0"
+}
+--------------------------------------------------
+// TEST[setup:library]
+
+or it can be done by extracting the values in a separate list of parameters and using question mark placeholders (`?`) in the query string:
+
+[source,console]
+--------------------------------------------------
+POST /_sql?format=txt
+{
+	"query": "SELECT YEAR(release_date) AS year FROM library WHERE page_count > ? AND author = ? GROUP BY year HAVING COUNT(*) > ?",
+	"params": [300, "Frank Herbert", 0]
+}
+--------------------------------------------------
+// TEST[setup:library]
+
+[IMPORTANT]
+The recommended way of passing values to a query is with question mark placeholders, to avoid any attempts of hacking or SQL injection.
+
 [[sql-rest-fields]]
 === Supported REST parameters
 
@@ -495,6 +526,10 @@ More information available https://docs.oracle.com/javase/8/docs/api/java/time/Z
 |false
 |Whether to include <<frozen-indices, frozen-indices>> in the query execution or not (default).
 
+|params
+|none
+|Optional list of parameters to replace question mark (`?`) placeholders inside the query.
+
 |===
 
 Do note that most parameters (outside the timeout and `columnar` ones) make sense only during the initial query - any follow-up pagination request only requires the `cursor` parameter as explained in the <<sql-pagination, pagination>> chapter.
diff --git a/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java b/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
index d4cb83485d1e1..9a08c538b3ff3 100644
--- a/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
+++ b/x-pack/plugin/sql/qa/src/main/java/org/elasticsearch/xpack/sql/qa/rest/RestSqlTestCase.java
@@ -538,8 +538,11 @@ public void testBasicQueryWithParameters() throws IOException {
         } else {
             expected.put("rows", Arrays.asList(Arrays.asList("foo", 10)));
         }
+        
+        String params = mode.equals("jdbc") ? "{\"type\": \"integer\", \"value\": 10}, {\"type\": \"keyword\", \"value\": \"foo\"}" :
+            "10, \"foo\"";
         assertResponse(expected, runSql(new StringEntity("{\"query\":\"SELECT test, ? param FROM test WHERE test = ?\", " +
-                "\"params\":[{\"type\": \"integer\", \"value\": 10}, {\"type\": \"keyword\", \"value\": \"foo\"}]"
+                "\"params\":[" + params + "]"
                 + mode(mode) + columnarParameter(columnar) + "}", ContentType.APPLICATION_JSON), StringUtils.EMPTY, mode));
     }
 
diff --git a/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/AbstractSqlQueryRequest.java b/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/AbstractSqlQueryRequest.java
index 776f64f2962a9..14857c95b3dc0 100644
--- a/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/AbstractSqlQueryRequest.java
+++ b/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/AbstractSqlQueryRequest.java
@@ -12,7 +12,12 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.ObjectParser;
+import org.elasticsearch.common.xcontent.ObjectParser.ValueType;
 import org.elasticsearch.common.xcontent.ToXContentFragment;
+import org.elasticsearch.common.xcontent.XContentLocation;
+import org.elasticsearch.common.xcontent.XContentParseException;
+import org.elasticsearch.common.xcontent.XContentParser;
+import org.elasticsearch.common.xcontent.XContentParser.Token;
 import org.elasticsearch.index.query.AbstractQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.xpack.sql.proto.Mode;
@@ -22,6 +27,7 @@
 
 import java.io.IOException;
 import java.time.ZoneId;
+import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 import java.util.Objects;
@@ -75,11 +81,11 @@ protected static <R extends AbstractSqlQueryRequest> ObjectParser<R, Void> objec
         parser.declareString(AbstractSqlQueryRequest::query, QUERY);
         parser.declareString((request, mode) -> request.mode(Mode.fromString(mode)), MODE);
         parser.declareString((request, clientId) -> request.clientId(clientId), CLIENT_ID);
-        parser.declareObjectArray(AbstractSqlQueryRequest::params, (p, c) -> SqlTypedParamValue.fromXContent(p), PARAMS);
+        parser.declareField(AbstractSqlQueryRequest::params, AbstractSqlQueryRequest::parseParams, PARAMS, ValueType.VALUE_ARRAY);
         parser.declareString((request, zoneId) -> request.zoneId(ZoneId.of(zoneId)), TIME_ZONE);
         parser.declareInt(AbstractSqlQueryRequest::fetchSize, FETCH_SIZE);
         parser.declareString((request, timeout) -> request.requestTimeout(TimeValue.parseTimeValue(timeout, Protocol.REQUEST_TIMEOUT,
-            "request_timeout")), REQUEST_TIMEOUT);
+                "request_timeout")), REQUEST_TIMEOUT);
         parser.declareString(
                 (request, timeout) -> request.pageTimeout(TimeValue.parseTimeValue(timeout, Protocol.PAGE_TIMEOUT, "page_timeout")),
                 PAGE_TIMEOUT);
@@ -117,6 +123,87 @@ public AbstractSqlQueryRequest params(List<SqlTypedParamValue> params) {
         this.params = params;
         return this;
     }
+    
+    private static List<SqlTypedParamValue> parseParams(XContentParser p) throws IOException {
+        List<SqlTypedParamValue> result = new ArrayList<>();
+        Token token = p.currentToken();
+        
+        if (token == Token.START_ARRAY) {
+            Object value = null;
+            String type = null;
+            SqlTypedParamValue previousParam = null;
+            SqlTypedParamValue currentParam = null;
+            
+            while ((token = p.nextToken()) != Token.END_ARRAY) {
+                XContentLocation loc = p.getTokenLocation();
+                
+                if (token == Token.START_OBJECT) {
+                    // we are at the start of a value/type pair... hopefully
+                    currentParam = SqlTypedParamValue.fromXContent(p);
+                    /*
+                     * Always set the xcontentlocation for the first param just in case the first one happens to not meet the parsing rules
+                     * that are checked later in validateParams method.
+                     * Also, set the xcontentlocation of the param that is different from the previous param in list when it comes to 
+                     * its type being explicitly set or inferred.
+                     */
+                    if ((previousParam != null && previousParam.hasExplicitType() == false) || result.isEmpty()) {
+                        currentParam.tokenLocation(loc);
+                    }
+                } else {
+                    if (token == Token.VALUE_STRING) {
+                        value = p.text();
+                        type = "keyword";
+                    } else if (token == Token.VALUE_NUMBER) {
+                        XContentParser.NumberType numberType = p.numberType();
+                        if (numberType == XContentParser.NumberType.INT) {
+                            value = p.intValue();
+                            type = "integer";
+                        } else if (numberType == XContentParser.NumberType.LONG) {
+                            value = p.longValue();
+                            type = "long";
+                        } else if (numberType == XContentParser.NumberType.FLOAT) {
+                            value = p.floatValue();
+                            type = "float";
+                        } else if (numberType == XContentParser.NumberType.DOUBLE) {
+                            value = p.doubleValue();
+                            type = "double";
+                        }
+                    } else if (token == Token.VALUE_BOOLEAN) {
+                        value = p.booleanValue();
+                        type = "boolean";
+                    } else if (token == Token.VALUE_NULL) {
+                        value = null;
+                        type = "null";
+                    } else {
+                        throw new XContentParseException(loc, "Failed to parse object: unexpected token [" + token + "] found");
+                    }
+                    
+                    currentParam = new SqlTypedParamValue(type, value, false);
+                    if ((previousParam != null && previousParam.hasExplicitType() == true) || result.isEmpty()) {
+                        currentParam.tokenLocation(loc);
+                    }
+                }
+
+                result.add(currentParam);
+                previousParam = currentParam;
+            }
+        }
+        
+        return result;
+    }
+    
+    protected static void validateParams(List<SqlTypedParamValue> params, Mode mode) {
+        for(SqlTypedParamValue param : params) {            
+            if (Mode.isDriver(mode) && param.hasExplicitType() == false) {
+                throw new XContentParseException(param.tokenLocation(), "[params] must be an array where each entry is an object with a "
+                        + "value/type pair");
+            }
+            if (Mode.isDriver(mode) == false && param.hasExplicitType() == true) {
+                throw new XContentParseException(param.tokenLocation(), "[params] must be an array where each entry is a single field (no "
+                        + "objects supported)");
+            }
+        }
+    }
 
     /**
      * The client's time zone
@@ -204,10 +291,11 @@ public AbstractSqlQueryRequest(StreamInput in) throws IOException {
     public static void writeSqlTypedParamValue(StreamOutput out, SqlTypedParamValue value) throws IOException {
         out.writeString(value.type);
         out.writeGenericValue(value.value);
+        out.writeBoolean(value.hasExplicitType());
     }
 
     public static SqlTypedParamValue readSqlTypedParamValue(StreamInput in) throws IOException {
-        return new SqlTypedParamValue(in.readString(), in.readGenericValue());
+        return new SqlTypedParamValue(in.readString(), in.readGenericValue(), in.readBoolean());
     }
 
     @Override
@@ -248,6 +336,6 @@ public boolean equals(Object o) {
 
     @Override
     public int hashCode() {
-        return Objects.hash(super.hashCode(), query, zoneId, fetchSize, requestTimeout, pageTimeout, filter);
+        return Objects.hash(super.hashCode(), query, params, zoneId, fetchSize, requestTimeout, pageTimeout, filter);
     }
 }
diff --git a/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlQueryRequest.java b/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlQueryRequest.java
index 933cccb686ac1..a338410b7278e 100644
--- a/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlQueryRequest.java
+++ b/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlQueryRequest.java
@@ -188,6 +188,8 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     }
 
     public static SqlQueryRequest fromXContent(XContentParser parser) {
-        return PARSER.apply(parser, null);
+        SqlQueryRequest request = PARSER.apply(parser,  null);
+        validateParams(request.params(), request.mode());
+        return request;
     }
 }
\ No newline at end of file
diff --git a/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlTranslateRequest.java b/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlTranslateRequest.java
index 9bf6f0db194a5..708779ec6e3c3 100644
--- a/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlTranslateRequest.java
+++ b/x-pack/plugin/sql/sql-action/src/main/java/org/elasticsearch/xpack/sql/action/SqlTranslateRequest.java
@@ -58,6 +58,7 @@ public String getDescription() {
 
     public static SqlTranslateRequest fromXContent(XContentParser parser) {
         SqlTranslateRequest request = PARSER.apply(parser, null);
+        validateParams(request.params(), request.mode());
         return request;
     }
 
diff --git a/x-pack/plugin/sql/sql-action/src/test/java/org/elasticsearch/xpack/sql/action/SqlQueryRequestTests.java b/x-pack/plugin/sql/sql-action/src/test/java/org/elasticsearch/xpack/sql/action/SqlQueryRequestTests.java
index 5a5ec18dc9475..d902e75121c75 100644
--- a/x-pack/plugin/sql/sql-action/src/test/java/org/elasticsearch/xpack/sql/action/SqlQueryRequestTests.java
+++ b/x-pack/plugin/sql/sql-action/src/test/java/org/elasticsearch/xpack/sql/action/SqlQueryRequestTests.java
@@ -5,31 +5,37 @@
  */
 package org.elasticsearch.xpack.sql.action;
 
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.ToXContent;
+import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.search.SearchModule;
-import org.elasticsearch.test.AbstractSerializingTestCase;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.sql.proto.Mode;
+import org.elasticsearch.xpack.sql.proto.Protocol;
 import org.elasticsearch.xpack.sql.proto.RequestInfo;
 import org.elasticsearch.xpack.sql.proto.SqlTypedParamValue;
 import org.junit.Before;
 
+import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 import java.util.function.Consumer;
 import java.util.function.Supplier;
 
+import static org.elasticsearch.test.AbstractXContentTestCase.xContentTester;
 import static org.elasticsearch.xpack.sql.action.SqlTestUtils.randomFilter;
 import static org.elasticsearch.xpack.sql.action.SqlTestUtils.randomFilterOrNull;
 import static org.elasticsearch.xpack.sql.proto.RequestInfo.CLIENT_IDS;
 
-public class SqlQueryRequestTests extends AbstractSerializingTestCase<SqlQueryRequest> {
+public class SqlQueryRequestTests extends AbstractWireSerializingTestCase<SqlQueryRequest> {
 
     public RequestInfo requestInfo;
 
@@ -60,49 +66,16 @@ protected SqlQueryRequest createTestInstance() {
         );
     }
     
-    private RequestInfo randomRequestInfo() {
-        return new RequestInfo(randomFrom(Mode.values()), randomFrom(randomFrom(CLIENT_IDS), requestInfo.clientId()));
-    }
-
-    public List<SqlTypedParamValue> randomParameters() {
-        if (randomBoolean()) {
-            return Collections.emptyList();
-        } else {
-            int len = randomIntBetween(1, 10);
-            List<SqlTypedParamValue> arr = new ArrayList<>(len);
-            for (int i = 0; i < len; i++) {
-                @SuppressWarnings("unchecked") Supplier<SqlTypedParamValue> supplier = randomFrom(
-                        () -> new SqlTypedParamValue("boolean", randomBoolean()),
-                        () -> new SqlTypedParamValue("long", randomLong()),
-                        () -> new SqlTypedParamValue("double", randomDouble()),
-                        () -> new SqlTypedParamValue("null", null),
-                        () -> new SqlTypedParamValue("keyword", randomAlphaOfLength(10))
-                );
-                arr.add(supplier.get());
-            }
-            return Collections.unmodifiableList(arr);
-        }
-    }
-
     @Override
     protected Writeable.Reader<SqlQueryRequest> instanceReader() {
         return SqlQueryRequest::new;
     }
 
-    private TimeValue randomTV() {
-        return TimeValue.parseTimeValue(randomTimeValue(), null, "test");
-    }
-
-    @Override
-    protected SqlQueryRequest doParseInstance(XContentParser parser) {
-        return SqlQueryRequest.fromXContent(parser);
-    }
-
     @Override
     protected SqlQueryRequest mutateInstance(SqlQueryRequest instance) {
         @SuppressWarnings("unchecked")
         Consumer<SqlQueryRequest> mutator = randomFrom(
-                request -> request.requestInfo(randomValueOtherThan(request.requestInfo(), this::randomRequestInfo)),
+                request -> mutateRequestInfo(instance, request),
                 request -> request.query(randomValueOtherThan(request.query(), () -> randomAlphaOfLength(5))),
                 request -> request.params(randomValueOtherThan(request.params(), this::randomParameters)),
                 request -> request.zoneId(randomValueOtherThan(request.zoneId(), ESTestCase::randomZone)),
@@ -119,10 +92,135 @@ protected SqlQueryRequest mutateInstance(SqlQueryRequest instance) {
         mutator.accept(newRequest);
         return newRequest;
     }
+    
+    private AbstractSqlQueryRequest mutateRequestInfo(SqlQueryRequest oldRequest, SqlQueryRequest newRequest) {
+        RequestInfo requestInfo = randomValueOtherThan(newRequest.requestInfo(), this::randomRequestInfo);
+        newRequest.requestInfo(requestInfo);
+        if (Mode.isDriver(oldRequest.requestInfo().mode()) && Mode.isDriver(requestInfo.mode()) == false) {
+            for(SqlTypedParamValue param : oldRequest.params()) {
+                param.hasExplicitType(false);
+            }
+        }
+        if (Mode.isDriver(oldRequest.requestInfo().mode()) == false && Mode.isDriver(requestInfo.mode())) {
+            for(SqlTypedParamValue param : oldRequest.params()) {
+                param.hasExplicitType(true);
+            }
+        }
+        
+        return newRequest;
+    }
+    
+    public void testFromXContent() throws IOException {
+        xContentTester(this::createParser, this::createTestInstance, SqlQueryRequestTests::toXContent, this::doParseInstance)
+            .numberOfTestRuns(NUMBER_OF_TEST_RUNS)
+            .supportsUnknownFields(false)
+            .shuffleFieldsExceptions(Strings.EMPTY_ARRAY)
+            .randomFieldsExcludeFilter(field -> false)
+            .assertEqualsConsumer(this::assertEqualInstances)
+            .assertToXContentEquivalence(true)
+            .test();
+    }
 
     public void testTimeZoneNullException() {
         final SqlQueryRequest sqlQueryRequest = createTestInstance();
         IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> sqlQueryRequest.zoneId(null));
         assertEquals("time zone may not be null.", e.getMessage());
     }
+    
+    private RequestInfo randomRequestInfo() {
+        return new RequestInfo(randomFrom(Mode.values()), randomFrom(randomFrom(CLIENT_IDS), requestInfo.clientId()));
+    }
+    
+    private TimeValue randomTV() {
+        return TimeValue.parseTimeValue(randomTimeValue(), null, "test");
+    }
+
+    public List<SqlTypedParamValue> randomParameters() {
+        if (randomBoolean()) {
+            return Collections.emptyList();
+        } else {
+            int len = randomIntBetween(1, 10);
+            List<SqlTypedParamValue> arr = new ArrayList<>(len);
+            boolean hasExplicitType = Mode.isDriver(this.requestInfo.mode());
+            for (int i = 0; i < len; i++) {
+                @SuppressWarnings("unchecked") Supplier<SqlTypedParamValue> supplier = randomFrom(
+                        () -> new SqlTypedParamValue("boolean", randomBoolean(), hasExplicitType),
+                        () -> new SqlTypedParamValue("long", randomLong(), hasExplicitType),
+                        () -> new SqlTypedParamValue("double", randomDouble(), hasExplicitType),
+                        () -> new SqlTypedParamValue("null", null, hasExplicitType),
+                        () -> new SqlTypedParamValue("keyword", randomAlphaOfLength(10), hasExplicitType)
+                );
+                arr.add(supplier.get());
+            }
+            return Collections.unmodifiableList(arr);
+        }
+    }
+
+    private SqlQueryRequest doParseInstance(XContentParser parser) {
+        return SqlQueryRequest.fromXContent(parser);
+    }
+
+    /**
+     * This is needed because {@link SqlQueryRequest#toXContent(XContentBuilder, org.elasticsearch.common.xcontent.ToXContent.Params)}
+     * is not serializing {@link SqlTypedParamValue} according to the request's {@link Mode} and it shouldn't, in fact.
+     * For testing purposes, different serializing methods for {@link SqlTypedParamValue} are necessary so that
+     * {@link SqlQueryRequest#fromXContent(XContentParser)} populates {@link SqlTypedParamValue#hasExplicitType()}
+     * properly.
+     */
+    private static void toXContent(SqlQueryRequest request, XContentBuilder builder) throws IOException {
+        builder.startObject();
+        if (request.query() != null) {
+            builder.field("query", request.query());
+        }
+        builder.field("mode", request.mode().toString());
+        if (request.clientId() != null) {
+            builder.field("client_id", request.clientId());
+        }
+        if (request.params() != null && request.params().isEmpty() == false) {
+            builder.startArray("params");
+            for (SqlTypedParamValue val : request.params()) {
+                if (Mode.isDriver(request.mode())) {
+                    builder.startObject();
+                    builder.field("type", val.type);
+                    builder.field("value", val.value);
+                    builder.endObject();
+                } else {
+                    builder.value(val.value);
+                }
+            }
+            builder.endArray();
+        }
+        if (request.zoneId() != null) {
+            builder.field("time_zone", request.zoneId().getId());
+        }
+        if (request.fetchSize() != Protocol.FETCH_SIZE) {
+            builder.field("fetch_size", request.fetchSize());
+        }
+        if (request.requestTimeout() != Protocol.REQUEST_TIMEOUT) {
+            builder.field("request_timeout", request.requestTimeout().getStringRep());
+        }
+        if (request.pageTimeout() != Protocol.PAGE_TIMEOUT) {
+            builder.field("page_timeout", request.pageTimeout().getStringRep());
+        }
+        if (request.filter() != null) {
+            builder.field("filter");
+            request.filter().toXContent(builder, ToXContent.EMPTY_PARAMS);
+        }
+        if (request.columnar() != null) {
+            builder.field("columnar", request.columnar());
+        }
+        if (request.fieldMultiValueLeniency()) {
+            builder.field("field_multi_value_leniency", request.fieldMultiValueLeniency());
+        }
+        if (request.indexIncludeFrozen()) {
+            builder.field("index_include_frozen", request.indexIncludeFrozen());
+        }
+        if (request.binaryCommunication() != null) {
+            builder.field("binary_format", request.binaryCommunication());
+        }
+        if (request.cursor() != null) {
+            builder.field("cursor", request.cursor());
+        }
+        builder.endObject();
+    }
 }
diff --git a/x-pack/plugin/sql/sql-action/src/test/java/org/elasticsearch/xpack/sql/action/SqlRequestParsersTests.java b/x-pack/plugin/sql/sql-action/src/test/java/org/elasticsearch/xpack/sql/action/SqlRequestParsersTests.java
index c9bdc8d670c6d..34245945e506b 100644
--- a/x-pack/plugin/sql/sql-action/src/test/java/org/elasticsearch/xpack/sql/action/SqlRequestParsersTests.java
+++ b/x-pack/plugin/sql/sql-action/src/test/java/org/elasticsearch/xpack/sql/action/SqlRequestParsersTests.java
@@ -9,6 +9,7 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.DeprecationHandler;
 import org.elasticsearch.common.xcontent.NamedXContentRegistry;
+import org.elasticsearch.common.xcontent.XContentParseException;
 import org.elasticsearch.common.xcontent.XContentParser;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.test.ESTestCase;
@@ -21,7 +22,7 @@
 import java.util.function.Consumer;
 import java.util.function.Function;
 
-import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.CoreMatchers.containsString;
 
 public class SqlRequestParsersTests extends ESTestCase {
 
@@ -105,23 +106,139 @@ public void testQueryRequestParser() throws IOException {
                 SqlQueryRequest::fromXContent);
         
         Mode randomMode = randomFrom(Mode.values());
+        String params;
+        List<SqlTypedParamValue> list = new ArrayList<>(1);
+        
+        if (Mode.isDriver(randomMode)) {
+            params = "{\"value\":123, \"type\":\"whatever\"}";
+            list.add(new SqlTypedParamValue("whatever", 123, true));
+        } else {
+            params = "123";
+            list.add(new SqlTypedParamValue("integer", 123, false));
+        }
+        
         SqlQueryRequest request = generateRequest("{\"cursor\" : \"whatever\", \"mode\" : \""
                 + randomMode.toString() + "\", \"client_id\" : \"bla\","
-                + "\"query\":\"select\",\"params\":[{\"value\":123, \"type\":\"whatever\"}], \"time_zone\":\"UTC\","
+                + "\"query\":\"select\","
+                + "\"params\":[" + params + "],"
+                + " \"time_zone\":\"UTC\","
                 + "\"request_timeout\":\"5s\",\"page_timeout\":\"10s\"}", SqlQueryRequest::fromXContent);
         assertNull(request.clientId());
         assertEquals(randomMode, request.mode());
         assertEquals("whatever", request.cursor());
         assertEquals("select", request.query());
-        
-        List<SqlTypedParamValue> list = new ArrayList<>(1);
-        list.add(new SqlTypedParamValue("whatever", 123));
+
         assertEquals(list, request.params());
         assertEquals("UTC", request.zoneId().getId());
         assertEquals(TimeValue.parseTimeValue("5s", "request_timeout"), request.requestTimeout());
         assertEquals(TimeValue.parseTimeValue("10s", "page_timeout"), request.pageTimeout());
     }
     
+    public void testParamsSuccessfulParsingInDriverMode() throws IOException {
+        Mode driverMode = randomValueOtherThanMany((m) -> Mode.isDriver(m) == false, () -> randomFrom(Mode.values()));
+        String json = "{" + 
+                      "    \"params\":[{\"type\":\"integer\",\"value\":35000},"
+                      + "              {\"type\":\"date\",\"value\":\"1960-01-01\"},"
+                      + "              {\"type\":\"boolean\",\"value\":false},"
+                      + "              {\"type\":\"keyword\",\"value\":\"foo\"}]," + 
+                      "    \"mode\": \"" + driverMode.toString() + "\"" + 
+                      "}";
+        SqlQueryRequest request = generateRequest(json, SqlQueryRequest::fromXContent);
+        List<SqlTypedParamValue> params = request.params();
+        assertEquals(4, params.size());
+        
+        assertEquals(35000, params.get(0).value);
+        assertEquals("integer", params.get(0).type);
+        assertTrue(params.get(0).hasExplicitType());
+        
+        assertEquals("1960-01-01", params.get(1).value);
+        assertEquals("date", params.get(1).type);
+        assertTrue(params.get(1).hasExplicitType());
+        
+        assertEquals(false, params.get(2).value);
+        assertEquals("boolean", params.get(2).type);
+        assertTrue(params.get(2).hasExplicitType());
+        
+        assertEquals("foo", params.get(3).value);
+        assertEquals("keyword", params.get(3).type);
+        assertTrue(params.get(3).hasExplicitType());
+    }
+    
+    public void testParamsSuccessfulParsingInNonDriverMode() throws IOException {
+        Mode nonDriverMode = randomValueOtherThanMany(Mode::isDriver, () -> randomFrom(Mode.values()));
+        String json = "{" + 
+                      "    \"params\":[35000,\"1960-01-01\",false,\"foo\"]," + 
+                      "    \"mode\": \"" + nonDriverMode.toString() + "\"" + 
+                      "}";
+        SqlQueryRequest request = generateRequest(json, SqlQueryRequest::fromXContent);
+        List<SqlTypedParamValue> params = request.params();
+        assertEquals(4, params.size());
+        
+        assertEquals(35000, params.get(0).value);
+        assertEquals("integer", params.get(0).type);
+        assertFalse(params.get(0).hasExplicitType());
+        
+        assertEquals("1960-01-01", params.get(1).value);
+        assertEquals("keyword", params.get(1).type);
+        assertFalse(params.get(1).hasExplicitType());
+        
+        assertEquals(false, params.get(2).value);
+        assertEquals("boolean", params.get(2).type);
+        assertFalse(params.get(2).hasExplicitType());
+        
+        assertEquals("foo", params.get(3).value);
+        assertEquals("keyword", params.get(3).type);
+        assertFalse(params.get(3).hasExplicitType());
+    }
+    
+    public void testParamsParsingFailure_QueryRequest_NonDriver() throws IOException {
+        Mode m = randomValueOtherThanMany(Mode::isDriver, () -> randomFrom(Mode.values()));
+        assertXContentParsingErrorMessage("{\"params\":[{\"whatever\":35000},\"1960-01-01\",false,\"foo\"],\"mode\": \""
+                + m.toString() + "\"}",
+                "[sql/query] failed to parse field [params]",
+                SqlQueryRequest::fromXContent);
+        assertXContentParsingErrorMessage("{\"params\":[350.123,\"1960-01-01\",{\"foobar\":false},\"foo\"],\"mode\": \"}"
+                + m.toString() + "\"}",
+                "[sql/query] failed to parse field [params]",
+                SqlQueryRequest::fromXContent);
+        assertXContentParsingErrorMessage("{\"mode\": \"" + m.toString() + "\",\"params\":[350.123,\"1960-01-01\",false,"
+                + "{\"type\":\"keyword\",\"value\":\"foo\"}]}",
+                "[params] must be an array where each entry is a single field (no objects supported)",
+                SqlQueryRequest::fromXContent);
+    }
+    
+    public void testParamsParsingFailure_TranslateRequest_NonDriver() throws IOException {
+        Mode m = randomValueOtherThanMany(Mode::isDriver, () -> randomFrom(Mode.values()));
+        assertXContentParsingErrorMessage("{\"params\":[{\"whatever\":35000},\"1960-01-01\",false,\"foo\"],\"mode\": \""
+                + m.toString() + "\"}",
+                "[sql/query] failed to parse field [params]",
+                SqlTranslateRequest::fromXContent);
+        assertXContentParsingErrorMessage("{\"params\":[350.123,\"1960-01-01\",{\"foobar\":false},\"foo\"],\"mode\": \"}"
+                + m.toString() + "\"}",
+                "[sql/query] failed to parse field [params]",
+                SqlTranslateRequest::fromXContent);
+        assertXContentParsingErrorMessage("{\"mode\": \"" + m.toString() + "\",\"params\":[350.123,\"1960-01-01\",false,"
+                + "{\"type\":\"keyword\",\"value\":\"foo\"}]}",
+                "[params] must be an array where each entry is a single field (no objects supported)",
+                SqlTranslateRequest::fromXContent);
+    }
+    
+    public void testParamsParsingFailure_Driver() throws IOException {
+        Mode m = randomValueOtherThanMany((t) -> Mode.isDriver(t) == false, () -> randomFrom(Mode.values()));
+        assertXContentParsingErrorMessage("{\"params\":[35000,{\"value\":\"1960-01-01\",\"type\":\"date\"},{\"value\":\"foo\","
+                + "\"type\":\"keyword\"}],\"mode\": \"" + m.toString() + "\"}",
+                "[params] must be an array where each entry is an object with a value/type pair",
+                SqlQueryRequest::fromXContent);
+        assertXContentParsingErrorMessage("{\"params\":[{\"value\":10,\"type\":\"integer\"},{\"value\":\"1960-01-01\",\"type\":\"date\"},"
+                + "false,\"foo\"],\"mode\": \"" + m.toString() + "\"}",
+                "[params] must be an array where each entry is an object with a value/type pair",
+                SqlQueryRequest::fromXContent);
+        assertXContentParsingErrorMessage("{\"mode\": \"" + m.toString() + "\",\"params\":[{\"value\":10,\"type\":\"integer\"},"
+                + "{\"value\":\"1960-01-01\",\"type\":\"date\"},{\"foo\":\"bar\"}]}",
+                "[sql/query] failed to parse field [params]",
+                SqlQueryRequest::fromXContent);
+    }
+    
     private <R extends AbstractSqlRequest> R generateRequest(String json, Function<XContentParser, R> fromXContent)
             throws IOException {
         XContentParser parser = parser(json);
@@ -140,6 +257,12 @@ private void assertParsingErrorMessageReason(String json, String errorMessage, C
         assertThat(e.getCause().getMessage(), containsString(errorMessage));
     }
     
+    private void assertXContentParsingErrorMessage(String json, String errorMessage, Consumer<XContentParser> consumer) throws IOException {
+        XContentParser parser = parser(json);
+        Exception e = expectThrows(XContentParseException.class, () -> consumer.accept(parser));
+        assertThat(e.getMessage(), containsString(errorMessage));
+    }
+    
     private XContentParser parser(String content) throws IOException {
         XContentType xContentType = XContentType.JSON;
         return xContentType.xContent().createParser(
diff --git a/x-pack/plugin/sql/sql-proto/src/main/java/org/elasticsearch/xpack/sql/proto/SqlTypedParamValue.java b/x-pack/plugin/sql/sql-proto/src/main/java/org/elasticsearch/xpack/sql/proto/SqlTypedParamValue.java
index caa230d06350e..89cf13eb52e8a 100644
--- a/x-pack/plugin/sql/sql-proto/src/main/java/org/elasticsearch/xpack/sql/proto/SqlTypedParamValue.java
+++ b/x-pack/plugin/sql/sql-proto/src/main/java/org/elasticsearch/xpack/sql/proto/SqlTypedParamValue.java
@@ -10,6 +10,7 @@
 import org.elasticsearch.common.xcontent.ObjectParser;
 import org.elasticsearch.common.xcontent.ToXContentObject;
 import org.elasticsearch.common.xcontent.XContentBuilder;
+import org.elasticsearch.common.xcontent.XContentLocation;
 import org.elasticsearch.common.xcontent.XContentParser;
 
 import java.io.IOException;
@@ -37,10 +38,33 @@ public class SqlTypedParamValue implements ToXContentObject {
 
     public final Object value;
     public final String type;
+    private boolean hasExplicitType;        // the type is explicitly set in the request or inferred by the parser
+    private XContentLocation tokenLocation; // location of the token failing the parsing rules
 
     public SqlTypedParamValue(String type, Object value) {
+        this(type, value, true);
+    }
+    
+    public SqlTypedParamValue(String type, Object value, boolean hasExplicitType) {
         this.value = value;
         this.type = type;
+        this.hasExplicitType = hasExplicitType;
+    }
+    
+    public boolean hasExplicitType() {
+        return hasExplicitType;
+    }
+    
+    public void hasExplicitType(boolean hasExplicitType) {
+        this.hasExplicitType = hasExplicitType;
+    }
+    
+    public XContentLocation tokenLocation() {
+        return tokenLocation;
+    }
+    
+    public void tokenLocation(XContentLocation tokenLocation) {
+        this.tokenLocation = tokenLocation;
     }
 
     @Override
@@ -65,16 +89,18 @@ public boolean equals(Object o) {
             return false;
         }
         SqlTypedParamValue that = (SqlTypedParamValue) o;
-        return Objects.equals(value, that.value) && Objects.equals(type, that.type);
+        return Objects.equals(value, that.value)
+                && Objects.equals(type, that.type)
+                && Objects.equals(hasExplicitType, that.hasExplicitType);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(value, type);
+        return Objects.hash(value, type, hasExplicitType);
     }
 
     @Override
     public String toString() {
-        return String.valueOf(value) + "[" + type + "]";
+        return String.valueOf(value) + " [" + type + "][" + hasExplicitType + "][" + tokenLocation + "]";
     }
 }
\ No newline at end of file

From d804ff0237833a8d24b15c7deb597d5ba30e03f1 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Mon, 20 Jan 2020 09:48:28 -0500
Subject: [PATCH 667/686] Account soft-deletes in FrozenEngine (#51192)

Currently, we do not exclude soft-deleted documents when opening index
reader in the FrozenEngine.

Relates #50775
---
 .../index/engine/NoOpEngine.java              |  2 +-
 .../index/engine/ReadOnlyEngine.java          |  6 ++-
 .../index/engine/FrozenEngine.java            |  4 +-
 .../index/engine/FrozenEngineTests.java       | 28 ++++++++++++++
 .../xpack/restart/FullClusterRestartIT.java   | 38 +++++++++++++++++++
 5 files changed, 74 insertions(+), 4 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/engine/NoOpEngine.java b/server/src/main/java/org/elasticsearch/index/engine/NoOpEngine.java
index 149dd03a23905..ea88c2aca0d17 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/NoOpEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/NoOpEngine.java
@@ -54,7 +54,7 @@ public NoOpEngine(EngineConfig config) {
         super(config, null, null, true, Function.identity());
         this.stats = new SegmentsStats();
         Directory directory = store.directory();
-        try (DirectoryReader reader = DirectoryReader.open(directory, OFF_HEAP_READER_ATTRIBUTES)) {
+        try (DirectoryReader reader = openDirectory(directory)) {
             for (LeafReaderContext ctx : reader.getContext().leaves()) {
                 SegmentReader segmentReader = Lucene.segmentReader(ctx.reader());
                 fillSegmentStats(segmentReader, true, stats);
diff --git a/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java b/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
index 4bc06aeea00b9..60d66c53f80e0 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
@@ -68,7 +68,7 @@ public class ReadOnlyEngine extends Engine {
      * Reader attributes used for read only engines. These attributes prevent loading term dictionaries on-heap even if the field is an
      * ID field if we are reading form memory maps.
      */
-    public static final Map<String, String> OFF_HEAP_READER_ATTRIBUTES = Collections.singletonMap(BlockTreeTermsReader.FST_MODE_KEY,
+    private static final Map<String, String> OFF_HEAP_READER_ATTRIBUTES = Collections.singletonMap(BlockTreeTermsReader.FST_MODE_KEY,
         BlockTreeTermsReader.FSTLoadMode.AUTO.name());
     private final SegmentInfos lastCommittedSegmentInfos;
     private final SeqNoStats seqNoStats;
@@ -528,4 +528,8 @@ public void advanceMaxSeqNoOfUpdatesOrDeletes(long maxSeqNoOfUpdatesOnPrimary) {
         assert maxSeqNoOfUpdatesOnPrimary <= getMaxSeqNoOfUpdatesOrDeletes() :
             maxSeqNoOfUpdatesOnPrimary + ">" + getMaxSeqNoOfUpdatesOrDeletes();
     }
+
+    protected static DirectoryReader openDirectory(Directory dir) throws IOException {
+        return new SoftDeletesDirectoryReaderWrapper(DirectoryReader.open(dir, OFF_HEAP_READER_ATTRIBUTES), Lucene.SOFT_DELETES_FIELD);
+    }
 }
diff --git a/x-pack/plugin/frozen-indices/src/main/java/org/elasticsearch/index/engine/FrozenEngine.java b/x-pack/plugin/frozen-indices/src/main/java/org/elasticsearch/index/engine/FrozenEngine.java
index 42fbc09a5fce0..694781c5ebec7 100644
--- a/x-pack/plugin/frozen-indices/src/main/java/org/elasticsearch/index/engine/FrozenEngine.java
+++ b/x-pack/plugin/frozen-indices/src/main/java/org/elasticsearch/index/engine/FrozenEngine.java
@@ -77,7 +77,7 @@ public FrozenEngine(EngineConfig config) {
 
         boolean success = false;
         Directory directory = store.directory();
-        try (DirectoryReader reader = DirectoryReader.open(directory, OFF_HEAP_READER_ATTRIBUTES)) {
+        try (DirectoryReader reader = openDirectory(directory)) {
             canMatchReader = ElasticsearchDirectoryReader.wrap(new RewriteCachingDirectoryReader(directory, reader.leaves()),
                 config.getShardId());
             // we record the segment stats here - that's what the reader needs when it's open and it give the user
@@ -167,7 +167,7 @@ private synchronized ElasticsearchDirectoryReader getOrOpenReader() throws IOExc
                 for (ReferenceManager.RefreshListener listeners : config ().getInternalRefreshListener()) {
                     listeners.beforeRefresh();
                 }
-                final DirectoryReader dirReader = DirectoryReader.open(engineConfig.getStore().directory(), OFF_HEAP_READER_ATTRIBUTES);
+                final DirectoryReader dirReader = openDirectory(engineConfig.getStore().directory());
                 reader = lastOpenedReader = wrapReader(dirReader, Function.identity());
                 processReader(reader);
                 reader.getReaderCacheHelper().addClosedListener(this::onReaderClosed);
diff --git a/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenEngineTests.java b/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenEngineTests.java
index 549035ec163a0..0334d3b198431 100644
--- a/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenEngineTests.java
+++ b/x-pack/plugin/frozen-indices/src/test/java/org/elasticsearch/index/engine/FrozenEngineTests.java
@@ -33,6 +33,8 @@
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.concurrent.atomic.AtomicLong;
 
+import static org.hamcrest.Matchers.equalTo;
+
 public class FrozenEngineTests extends EngineTestCase {
 
     public void testAcquireReleaseReset() throws IOException {
@@ -328,4 +330,30 @@ public void testCanMatch() throws IOException {
             }
         }
     }
+
+    public void testSearchers() throws Exception {
+        IOUtils.close(engine, store);
+        final AtomicLong globalCheckpoint = new AtomicLong(SequenceNumbers.NO_OPS_PERFORMED);
+        try (Store store = createStore()) {
+            EngineConfig config = config(defaultSettings, store, createTempDir(), newMergePolicy(), null, null, null,
+                globalCheckpoint::get, new NoneCircuitBreakerService());
+            final int totalDocs;
+            try (InternalEngine engine = createEngine(config)) {
+                applyOperations(engine, generateHistoryOnReplica(between(10, 1000), false, randomBoolean(), randomBoolean()));
+                globalCheckpoint.set(engine.getProcessedLocalCheckpoint());
+                engine.syncTranslog();
+                engine.flush();
+                engine.refresh("test");
+                try (Engine.Searcher searcher = engine.acquireSearcher("test")) {
+                    totalDocs = searcher.search(new MatchAllDocsQuery(), Integer.MAX_VALUE).scoreDocs.length;
+                }
+            }
+            try (FrozenEngine frozenEngine = new FrozenEngine(config)) {
+                try (Engine.Searcher searcher = frozenEngine.acquireSearcher("test")) {
+                    TopDocs topDocs = searcher.search(new MatchAllDocsQuery(), Integer.MAX_VALUE);
+                    assertThat(topDocs.scoreDocs.length, equalTo(totalDocs));
+                }
+            }
+        }
+    }
 }
diff --git a/x-pack/qa/full-cluster-restart/src/test/java/org/elasticsearch/xpack/restart/FullClusterRestartIT.java b/x-pack/qa/full-cluster-restart/src/test/java/org/elasticsearch/xpack/restart/FullClusterRestartIT.java
index e8c1b6e94ccf6..94c3ba4c51866 100644
--- a/x-pack/qa/full-cluster-restart/src/test/java/org/elasticsearch/xpack/restart/FullClusterRestartIT.java
+++ b/x-pack/qa/full-cluster-restart/src/test/java/org/elasticsearch/xpack/restart/FullClusterRestartIT.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.rest.action.search.RestSearchAction;
 import org.elasticsearch.test.StreamsUtils;
@@ -595,4 +596,41 @@ private Map<String, Object> getJob(Map<String, Object> jobsMap, String targetJob
         }
         return null;
     }
+
+    public void testFrozenIndexAfterRestarted() throws Exception {
+        final String index = "test_frozen_index";
+        if (isRunningAgainstOldCluster()) {
+            Settings.Builder settings = Settings.builder();
+            if (minimumNodeVersion().before(Version.V_8_0_0) && randomBoolean()) {
+                settings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), randomBoolean());
+            }
+            String mappings = randomBoolean() ? "\"_source\": { \"enabled\": false}" : null;
+            createIndex(index, settings.build(), mappings);
+            ensureGreen(index);
+            int numDocs = randomIntBetween(10, 500);
+            for (int i = 0; i < numDocs; i++) {
+                int id = randomIntBetween(0, 100);
+                final Request indexRequest = new Request("POST", "/" + index + "/" + "_doc/" + id);
+                indexRequest.setJsonEntity(Strings.toString(JsonXContent.contentBuilder().startObject().field("f", "v").endObject()));
+                assertOK(client().performRequest(indexRequest));
+                if (rarely()) {
+                    flush(index, randomBoolean());
+                }
+            }
+        } else {
+            ensureGreen(index);
+            final int totalHits = (int) XContentMapValues.extractValue("hits.total.value",
+                entityAsMap(client().performRequest(new Request("GET", "/" + index + "/_search"))));
+            assertOK(client().performRequest(new Request("POST", index + "/_freeze")));
+            ensureGreen(index);
+            assertNoFileBasedRecovery(index, n -> true);
+            final Request request = new Request("GET", "/" + index + "/_search");
+            request.addParameter("ignore_throttled", "false");
+            assertThat(XContentMapValues.extractValue("hits.total.value", entityAsMap(client().performRequest(request))),
+                equalTo(totalHits));
+            assertOK(client().performRequest(new Request("POST", index + "/_unfreeze")));
+            ensureGreen(index);
+            assertNoFileBasedRecovery(index, n -> true);
+        }
+    }
 }

From 46045dc88803120792d48725ee64a61484a1b2bb Mon Sep 17 00:00:00 2001
From: Alan Woodward <romseygeek@apache.org>
Date: Mon, 20 Jan 2020 15:05:52 +0000
Subject: [PATCH 668/686] PutIndexTemplateRequest contains a single mapping
 (#50899)

New index templates can only contain a single mapping, as we no longer support
multiple types. This commit changes the internal classes used to represent a
PutIndexTemplateRequest from holding a map of types to mappings, to instead
holding a single mapping string.

Relates to #41059
---
 .../indices/PutIndexTemplateRequestTests.java |  2 +-
 .../template/put/PutIndexTemplateRequest.java | 79 ++++++++++---------
 .../put/PutIndexTemplateRequestBuilder.java   | 21 +----
 .../MetaDataIndexTemplateService.java         | 28 ++-----
 .../MetaDataIndexTemplateServiceTests.java    |  8 +-
 .../put/PutIndexTemplateRequestTests.java     | 67 ++++++++--------
 .../cluster/SimpleClusterStateIT.java         |  8 +-
 .../gateway/RecoveryFromGatewayIT.java        |  2 +-
 .../template/IndexTemplateBlocksIT.java       |  2 +-
 .../template/SimpleIndexTemplateIT.java       | 32 ++++----
 .../SharedClusterSnapshotRestoreIT.java       |  6 +-
 .../support/SecurityIndexManager.java         |  3 +-
 .../support/SecurityIndexManagerTests.java    | 26 +++---
 .../persistence/TransformInternalIndex.java   |  4 +-
 14 files changed, 132 insertions(+), 156 deletions(-)

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/indices/PutIndexTemplateRequestTests.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/indices/PutIndexTemplateRequestTests.java
index 9118690201e5e..b10decb15b5a9 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/indices/PutIndexTemplateRequestTests.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/indices/PutIndexTemplateRequestTests.java
@@ -109,7 +109,7 @@ protected void assertInstances(org.elasticsearch.action.admin.indices.template.p
                 throw new UncheckedIOException(e);
             }
         }
-        assertThat(serverInstance.mappings().get("_doc"), equalTo(mapping));
+        assertThat(serverInstance.mappings(), equalTo(mapping));
         assertThat(serverInstance.settings(), equalTo(clientTestInstance.settings()));
     }
 
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
index 3e6b4f5bc45d2..1ad5cedb9332c 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequest.java
@@ -21,16 +21,17 @@
 import org.apache.logging.log4j.LogManager;
 import org.elasticsearch.ElasticsearchGenerationException;
 import org.elasticsearch.ElasticsearchParseException;
+import org.elasticsearch.Version;
 import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.action.IndicesRequest;
 import org.elasticsearch.action.admin.indices.alias.Alias;
 import org.elasticsearch.action.admin.indices.mapping.put.PutMappingRequest;
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.action.support.master.MasterNodeRequest;
+import org.elasticsearch.common.Nullable;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.collect.MapBuilder;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.logging.DeprecationLogger;
@@ -47,7 +48,6 @@
 
 import java.io.IOException;
 import java.util.Collections;
-import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
@@ -79,7 +79,8 @@ public class PutIndexTemplateRequest extends MasterNodeRequest<PutIndexTemplateR
 
     private Settings settings = EMPTY_SETTINGS;
 
-    private Map<String, String> mappings = new HashMap<>();
+    @Nullable
+    private String mappings;
 
     private final Set<Alias> aliases = new HashSet<>();
 
@@ -93,11 +94,14 @@ public PutIndexTemplateRequest(StreamInput in) throws IOException {
         order = in.readInt();
         create = in.readBoolean();
         settings = readSettingsFromStream(in);
-        int size = in.readVInt();
-        for (int i = 0; i < size; i++) {
-            final String type = in.readString();
-            String mappingSource = in.readString();
-            mappings.put(type, mappingSource);
+        if (in.getVersion().before(Version.V_8_0_0)) {
+            int size = in.readVInt();
+            for (int i = 0; i < size; i++) {
+                in.readString();    // type - cannot assert on _doc because 7x allows arbitrary type names
+                this.mappings = in.readString();
+            }
+        } else {
+            this.mappings = in.readOptionalString();
         }
         int aliasesSize = in.readVInt();
         for (int i = 0; i < aliasesSize; i++) {
@@ -225,17 +229,6 @@ public Settings settings() {
         return this.settings;
     }
 
-    /**
-     * Adds mapping that will be added when the index gets created.
-     *
-     * @param type   The mapping type
-     * @param source The mapping source
-     * @param xContentType The type of content contained within the source
-     */
-    public PutIndexTemplateRequest mapping(String type, String source, XContentType xContentType) {
-        return mapping(type, new BytesArray(source), xContentType);
-    }
-
     /**
      * The cause for this index template creation.
      */
@@ -251,41 +244,47 @@ public String cause() {
     /**
      * Adds mapping that will be added when the index gets created.
      *
-     * @param type   The mapping type
      * @param source The mapping source
+     * @param xContentType The type of content contained within the source
      */
-    public PutIndexTemplateRequest mapping(String type, XContentBuilder source) {
-        return mapping(type, BytesReference.bytes(source), source.contentType());
+    public PutIndexTemplateRequest mapping(String source, XContentType xContentType) {
+        return mapping(new BytesArray(source), xContentType);
+    }
+
+    /**
+     * Adds mapping that will be added when the index gets created.
+     *
+     * @param source The mapping source
+     */
+    public PutIndexTemplateRequest mapping(XContentBuilder source) {
+        return mapping(BytesReference.bytes(source), source.contentType());
     }
 
     /**
      * Adds mapping that will be added when the index gets created.
      *
-     * @param type   The mapping type
      * @param source The mapping source
      * @param xContentType the source content type
      */
-    public PutIndexTemplateRequest mapping(String type, BytesReference source, XContentType xContentType) {
+    public PutIndexTemplateRequest mapping(BytesReference source, XContentType xContentType) {
         Objects.requireNonNull(xContentType);
         Map<String, Object> mappingAsMap = XContentHelper.convertToMap(source, false, xContentType).v2();
-        return mapping(type, mappingAsMap);
+        return mapping(mappingAsMap);
     }
 
     /**
      * Adds mapping that will be added when the index gets created.
      *
-     * @param type   The mapping type
      * @param source The mapping source
      */
-    public PutIndexTemplateRequest mapping(String type, Map<String, Object> source) {
-        // wrap it in a type map if its not
-        if (source.size() != 1 || !source.containsKey(type)) {
-            source = MapBuilder.<String, Object>newMapBuilder().put(type, source).map();
+    public PutIndexTemplateRequest mapping(Map<String, Object> source) {
+        if (source.size() != 1 || source.containsKey(MapperService.SINGLE_MAPPING_NAME) == false) {
+            source = Map.of(MapperService.SINGLE_MAPPING_NAME, source);
         }
         try {
             XContentBuilder builder = XContentFactory.jsonBuilder();
             builder.map(source);
-            mappings.put(type, Strings.toString(builder));
+            mappings = Strings.toString(builder);
             return this;
         } catch (IOException e) {
             throw new ElasticsearchGenerationException("Failed to generate [" + source + "]", e);
@@ -297,11 +296,11 @@ public PutIndexTemplateRequest mapping(String type, Map<String, Object> source)
      * ("field1", "type=string,store=true").
      */
     public PutIndexTemplateRequest mapping(String... source) {
-        mapping(MapperService.SINGLE_MAPPING_NAME, PutMappingRequest.simpleMapping(source));
+        mapping(PutMappingRequest.simpleMapping(source));
         return this;
     }
 
-    public Map<String, String> mappings() {
+    public String mappings() {
         return this.mappings;
     }
 
@@ -353,7 +352,7 @@ public PutIndexTemplateRequest source(Map<String, Object> templateSource) {
                             "Malformed [mappings] section for type [" + entry1.getKey() +
                                 "], should include an inner object describing the mapping");
                     }
-                    mapping(entry1.getKey(), (Map<String, Object>) entry1.getValue());
+                    mapping((Map<String, Object>) entry1.getValue());
                 }
             } else if (name.equals("aliases")) {
                 aliases((Map<String, Object>) entry.getValue());
@@ -471,10 +470,14 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeInt(order);
         out.writeBoolean(create);
         writeSettingsToStream(settings, out);
-        out.writeVInt(mappings.size());
-        for (Map.Entry<String, String> entry : mappings.entrySet()) {
-            out.writeString(entry.getKey());
-            out.writeString(entry.getValue());
+        if (out.getVersion().before(Version.V_8_0_0)) {
+            out.writeVInt(mappings == null ? 0 : 1);
+            if (mappings != null) {
+                out.writeString(MapperService.SINGLE_MAPPING_NAME);
+                out.writeString(mappings);
+            }
+        } else {
+            out.writeOptionalString(mappings);
         }
         out.writeVInt(aliases.size());
         for (Alias alias : aliases) {
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestBuilder.java b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestBuilder.java
index b4d998c6e6770..33b7c13d204bf 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestBuilder.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestBuilder.java
@@ -109,12 +109,11 @@ public PutIndexTemplateRequestBuilder setSettings(Map<String, Object> source) {
     /**
      * Adds mapping that will be added when the index template gets created.
      *
-     * @param type   The mapping type
      * @param source The mapping source
      * @param xContentType The type/format of the source
      */
-    public PutIndexTemplateRequestBuilder addMapping(String type, String source, XContentType xContentType) {
-        request.mapping(type, source, xContentType);
+    public PutIndexTemplateRequestBuilder setMapping(String source, XContentType xContentType) {
+        request.mapping(source, xContentType);
         return this;
     }
 
@@ -181,22 +180,10 @@ public PutIndexTemplateRequestBuilder cause(String cause) {
     /**
      * Adds mapping that will be added when the index template gets created.
      *
-     * @param type   The mapping type
      * @param source The mapping source
      */
-    public PutIndexTemplateRequestBuilder addMapping(String type, XContentBuilder source) {
-        request.mapping(type, source);
-        return this;
-    }
-
-    /**
-     * Adds mapping that will be added when the index gets created.
-     *
-     * @param type   The mapping type
-     * @param source The mapping source
-     */
-    public PutIndexTemplateRequestBuilder addMapping(String type, Map<String, Object> source) {
-        request.mapping(type, source);
+    public PutIndexTemplateRequestBuilder setMapping(XContentBuilder source) {
+        request.mapping(source);
         return this;
     }
 
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
index 55e03a604ec55..f47dd8f7dec31 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataIndexTemplateService.java
@@ -51,11 +51,9 @@
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.Comparator;
-import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Locale;
-import java.util.Map;
 import java.util.Optional;
 import java.util.Set;
 import java.util.function.Predicate;
@@ -285,19 +283,14 @@ private static void validateAndAddTemplate(final PutRequest request, IndexTempla
             templateBuilder.patterns(request.indexPatterns);
             templateBuilder.settings(request.settings);
 
-            Map<String, Map<String, Object>> mappingsForValidation = new HashMap<>();
-            for (Map.Entry<String, String> entry : request.mappings.entrySet()) {
+            if (request.mappings != null) {
                 try {
-                    templateBuilder.putMapping(entry.getKey(), entry.getValue());
+                    templateBuilder.putMapping(MapperService.SINGLE_MAPPING_NAME, request.mappings);
                 } catch (Exception e) {
-                    throw new MapperParsingException("Failed to parse mapping [{}]: {}", e, entry.getKey(), e.getMessage());
+                    throw new MapperParsingException("Failed to parse mapping: {}", e, request.mappings);
                 }
-                mappingsForValidation.put(entry.getKey(), MapperService.parseMapping(xContentRegistry, entry.getValue()));
-            }
-            if (mappingsForValidation.isEmpty() == false) {
-                assert mappingsForValidation.size() == 1;
-                String type = mappingsForValidation.keySet().iterator().next();
-                dummyIndexService.mapperService().merge(type, mappingsForValidation.get(type), MergeReason.MAPPING_UPDATE);
+                dummyIndexService.mapperService().merge(MapperService.SINGLE_MAPPING_NAME,
+                    MapperService.parseMapping(xContentRegistry, request.mappings), MergeReason.MAPPING_UPDATE);
             }
 
         } finally {
@@ -390,7 +383,7 @@ public static class PutRequest {
         Integer version;
         List<String> indexPatterns;
         Settings settings = Settings.Builder.EMPTY_SETTINGS;
-        Map<String, String> mappings = new HashMap<>();
+        String mappings = null;
         List<Alias> aliases = new ArrayList<>();
 
         TimeValue masterTimeout = MasterNodeRequest.DEFAULT_MASTER_NODE_TIMEOUT;
@@ -420,8 +413,8 @@ public PutRequest settings(Settings settings) {
             return this;
         }
 
-        public PutRequest mappings(Map<String, String> mappings) {
-            this.mappings.putAll(mappings);
+        public PutRequest mappings(String mappings) {
+            this.mappings = mappings;
             return this;
         }
 
@@ -430,11 +423,6 @@ public PutRequest aliases(Set<Alias> aliases) {
             return this;
         }
 
-        public PutRequest putMapping(String mappingType, String mappingSource) {
-            mappings.put(mappingType, mappingSource);
-            return this;
-        }
-
         public PutRequest masterTimeout(TimeValue masterTimeout) {
             this.masterTimeout = masterTimeout;
             return this;
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
index 31add95f55401..d31e87f9ca09f 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/MetaDataIndexTemplateServiceTests.java
@@ -105,7 +105,7 @@ public void testIndexTemplateWithAliasNameEqualToTemplatePattern() {
     public void testIndexTemplateWithValidateMapping() throws Exception {
         PutRequest request = new PutRequest("api", "validate_template");
         request.patterns(singletonList("te*"));
-        request.putMapping("type1", Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("type1")
+        request.mappings(Strings.toString(XContentFactory.jsonBuilder().startObject().startObject("_doc")
                         .startObject("properties").startObject("field2").field("type", "text").field("analyzer", "custom_1").endObject()
                         .endObject().endObject().endObject()));
 
@@ -118,19 +118,19 @@ public void testIndexTemplateWithValidateMapping() throws Exception {
     public void testBrokenMapping() throws Exception {
         PutRequest request = new PutRequest("api", "broken_mapping");
         request.patterns(singletonList("te*"));
-        request.putMapping("type1", "abcde");
+        request.mappings("abcde");
 
         List<Throwable> errors = putTemplateDetail(request);
         assertThat(errors.size(), equalTo(1));
         assertThat(errors.get(0), instanceOf(MapperParsingException.class));
-        assertThat(errors.get(0).getMessage(), containsString("Failed to parse mapping "));
+        assertThat(errors.get(0).getMessage(), containsString("Failed to parse mapping"));
     }
 
     public void testAliasInvalidFilterInvalidJson() throws Exception {
         //invalid json: put index template fails
         PutRequest request = new PutRequest("api", "blank_mapping");
         request.patterns(singletonList("te*"));
-        request.putMapping("type1", "{}");
+        request.mappings("{}");
         Set<Alias> aliases = new HashSet<>();
         aliases.add(new Alias("invalid_alias").filter("abcde"));
         request.aliases(aliases);
diff --git a/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestTests.java b/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestTests.java
index 6dd3dcb1f14f5..4f68777f9bf0d 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/indices/template/put/PutIndexTemplateRequestTests.java
@@ -34,7 +34,6 @@
 import static org.hamcrest.Matchers.containsInAnyOrder;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.hasKey;
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.nullValue;
 import static org.hamcrest.core.Is.is;
@@ -64,56 +63,56 @@ public void testMappingKeyedByType() throws IOException {
             XContentBuilder builder = XContentFactory.contentBuilder(randomFrom(XContentType.values()));
             builder.startObject().startObject("properties")
                 .startObject("field1")
-                    .field("type", "text")
+                .field("type", "text")
                 .endObject()
                 .startObject("field2")
-                    .startObject("properties")
-                        .startObject("field21")
-                            .field("type", "keyword")
-                        .endObject()
-                    .endObject()
+                .startObject("properties")
+                .startObject("field21")
+                .field("type", "keyword")
                 .endObject()
-            .endObject().endObject();
-            request1.mapping("type1", builder);
+                .endObject()
+                .endObject()
+                .endObject().endObject();
+            request1.mapping(builder);
             builder = XContentFactory.contentBuilder(randomFrom(XContentType.values()));
-            builder.startObject().startObject("type1")
+            builder.startObject().startObject("_doc")
                 .startObject("properties")
-                    .startObject("field1")
-                        .field("type", "text")
-                    .endObject()
-                    .startObject("field2")
-                        .startObject("properties")
-                            .startObject("field21")
-                                .field("type", "keyword")
-                            .endObject()
-                        .endObject()
-                    .endObject()
+                .startObject("field1")
+                .field("type", "text")
+                .endObject()
+                .startObject("field2")
+                .startObject("properties")
+                .startObject("field21")
+                .field("type", "keyword")
+                .endObject()
+                .endObject()
+                .endObject()
                 .endObject()
-            .endObject().endObject();
-            request2.mapping("type1", builder);
+                .endObject().endObject();
+            request2.mapping(builder);
             assertEquals(request1.mappings(), request2.mappings());
         }
         {
             request1 = new PutIndexTemplateRequest("foo");
             request2 = new PutIndexTemplateRequest("bar");
             String nakedMapping = "{\"properties\": {\"foo\": {\"type\": \"integer\"}}}";
-            request1.mapping("type2", nakedMapping, XContentType.JSON);
-            request2.mapping("type2", "{\"type2\": " + nakedMapping + "}", XContentType.JSON);
+            request1.mapping(nakedMapping, XContentType.JSON);
+            request2.mapping("{\"_doc\": " + nakedMapping + "}", XContentType.JSON);
             assertEquals(request1.mappings(), request2.mappings());
         }
         {
             request1 = new PutIndexTemplateRequest("foo");
             request2 = new PutIndexTemplateRequest("bar");
-            Map<String , Object> nakedMapping = MapBuilder.<String, Object>newMapBuilder()
-                    .put("properties", MapBuilder.<String, Object>newMapBuilder()
-                            .put("bar", MapBuilder.<String, Object>newMapBuilder()
-                                    .put("type", "scaled_float")
-                                    .put("scaling_factor", 100)
-                            .map())
+            Map<String, Object> nakedMapping = MapBuilder.<String, Object>newMapBuilder()
+                .put("properties", MapBuilder.<String, Object>newMapBuilder()
+                    .put("bar", MapBuilder.<String, Object>newMapBuilder()
+                        .put("type", "scaled_float")
+                        .put("scaling_factor", 100)
+                        .map())
                     .map())
-            .map();
-            request1.mapping("type3", nakedMapping);
-            request2.mapping("type3", MapBuilder.<String, Object>newMapBuilder().put("type3", nakedMapping).map());
+                .map();
+            request1.mapping(nakedMapping);
+            request2.mapping(Map.of("_doc", nakedMapping));
             assertEquals(request1.mappings(), request2.mappings());
         }
     }
@@ -154,7 +153,7 @@ public void testSourceParsing() throws IOException {
             .build();
         assertThat(request.settings(), equalTo(settings));
 
-        assertThat(request.mappings(), hasKey("_doc"));
+        assertThat(request.mappings(), containsString("field"));
 
         Alias alias = new Alias("my-alias");
         assertThat(request.aliases().size(), equalTo(1));
diff --git a/server/src/test/java/org/elasticsearch/cluster/SimpleClusterStateIT.java b/server/src/test/java/org/elasticsearch/cluster/SimpleClusterStateIT.java
index 01bef1d292597..fde1f1b54d4fc 100644
--- a/server/src/test/java/org/elasticsearch/cluster/SimpleClusterStateIT.java
+++ b/server/src/test/java/org/elasticsearch/cluster/SimpleClusterStateIT.java
@@ -140,9 +140,9 @@ public void testIndexTemplates() throws Exception {
         client().admin().indices().preparePutTemplate("foo_template")
                 .setPatterns(Collections.singletonList("te*"))
                 .setOrder(0)
-                .addMapping("type1", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                     .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                             .startObject("properties")
                                 .startObject("field1")
                                     .field("type", "text")
@@ -160,9 +160,9 @@ public void testIndexTemplates() throws Exception {
         client().admin().indices().preparePutTemplate("fuu_template")
                 .setPatterns(Collections.singletonList("test*"))
                 .setOrder(1)
-                .addMapping("type1", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                         .startObject()
-                            .startObject("type1")
+                            .startObject("_doc")
                                 .startObject("properties")
                                     .startObject("field2")
                                         .field("type", "text")
diff --git a/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java b/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
index ee55545fe34ea..4e7ff217c9c5f 100644
--- a/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
+++ b/server/src/test/java/org/elasticsearch/gateway/RecoveryFromGatewayIT.java
@@ -383,7 +383,7 @@ public void testLatestVersionLoaded() throws Exception {
         client().admin().indices().preparePutTemplate("template_1")
             .setPatterns(Collections.singletonList("te*"))
             .setOrder(0)
-            .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+            .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                 .startObject("field1").field("type", "text").field("store", true).endObject()
                 .startObject("field2").field("type", "keyword").field("store", true).endObject()
                 .endObject().endObject().endObject())
diff --git a/server/src/test/java/org/elasticsearch/indices/template/IndexTemplateBlocksIT.java b/server/src/test/java/org/elasticsearch/indices/template/IndexTemplateBlocksIT.java
index 3e38a6df187f8..10154ea5c12b5 100644
--- a/server/src/test/java/org/elasticsearch/indices/template/IndexTemplateBlocksIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/template/IndexTemplateBlocksIT.java
@@ -38,7 +38,7 @@ public void testIndexTemplatesWithBlocks() throws IOException {
         client().admin().indices().preparePutTemplate("template_blocks")
                 .setPatterns(Collections.singletonList("te*"))
                 .setOrder(0)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").field("type", "text").field("store", true).endObject()
                         .startObject("field2").field("type", "keyword").field("store", true).endObject()
                         .endObject().endObject().endObject())
diff --git a/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java b/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
index 8367791d4748d..38bd2e0199306 100644
--- a/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
+++ b/server/src/test/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
@@ -93,7 +93,7 @@ public void testSimpleIndexTemplateTests() throws Exception {
                 .setPatterns(Collections.singletonList("te*"))
                 .setSettings(indexSettings())
                 .setOrder(0)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").field("type", "text").field("store", true).endObject()
                         .startObject("field2").field("type", "keyword").field("store", true).endObject()
                         .endObject().endObject().endObject())
@@ -103,7 +103,7 @@ public void testSimpleIndexTemplateTests() throws Exception {
                 .setPatterns(Collections.singletonList("test*"))
                 .setSettings(indexSettings())
                 .setOrder(1)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field2").field("type", "text").field("store", false).endObject()
                         .endObject().endObject().endObject())
                 .get();
@@ -114,7 +114,7 @@ public void testSimpleIndexTemplateTests() throws Exception {
                 .setSettings(indexSettings())
                 .setCreate(true)
                 .setOrder(1)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field2").field("type", "text").field("store", false).endObject()
                         .endObject().endObject().endObject())
                 , IllegalArgumentException.class
@@ -164,9 +164,9 @@ public void testDeleteIndexTemplate() throws Exception {
         client().admin().indices().preparePutTemplate("template_1")
                 .setPatterns(Collections.singletonList("te*"))
                 .setOrder(0)
-                .addMapping("type1", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                     .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                             .startObject("properties")
                                 .startObject("field1")
                                     .field("type", "text")
@@ -184,9 +184,9 @@ public void testDeleteIndexTemplate() throws Exception {
         client().admin().indices().preparePutTemplate("template_2")
                 .setPatterns(Collections.singletonList("test*"))
                 .setOrder(1)
-                .addMapping("type1", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                     .startObject()
-                        .startObject("type1")
+                        .startObject("_doc")
                             .startObject("properties")
                                 .startObject("field2")
                                     .field("type", "text")
@@ -211,7 +211,7 @@ public void testDeleteIndexTemplate() throws Exception {
         client().admin().indices().preparePutTemplate("template_1")
                 .setPatterns(Collections.singletonList("te*"))
                 .setOrder(0)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").field("type", "text").field("store", true).endObject()
                         .startObject("field2").field("type", "keyword").field("store", true).endObject()
                         .endObject().endObject().endObject())
@@ -234,7 +234,7 @@ public void testThatGetIndexTemplatesWorks() throws Exception {
                 .setPatterns(Collections.singletonList("te*"))
                 .setOrder(0)
                 .setVersion(123)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").field("type", "text").field("store", true).endObject()
                         .startObject("field2").field("type", "keyword").field("store", true).endObject()
                         .endObject().endObject().endObject())
@@ -259,7 +259,7 @@ public void testThatGetIndexTemplatesWithSimpleRegexWorks() throws Exception {
         client().admin().indices().preparePutTemplate("template_1")
                 .setPatterns(Collections.singletonList("te*"))
                 .setOrder(0)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").field("type", "text").field("store", true).endObject()
                         .startObject("field2").field("type", "keyword").field("store", true).endObject()
                         .endObject().endObject().endObject())
@@ -269,7 +269,7 @@ public void testThatGetIndexTemplatesWithSimpleRegexWorks() throws Exception {
         client().admin().indices().preparePutTemplate("template_2")
                 .setPatterns(Collections.singletonList("te*"))
                 .setOrder(0)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").field("type", "text").field("store", true).endObject()
                         .startObject("field2").field("type", "keyword").field("store", true).endObject()
                         .endObject().endObject().endObject())
@@ -279,7 +279,7 @@ public void testThatGetIndexTemplatesWithSimpleRegexWorks() throws Exception {
         client().admin().indices().preparePutTemplate("template3")
                 .setPatterns(Collections.singletonList("te*"))
                 .setOrder(0)
-                .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field1").field("type", "text").field("store", true).endObject()
                         .startObject("field2").field("type", "keyword").field("store", true).endObject()
                         .endObject().endObject().endObject())
@@ -345,7 +345,7 @@ public void testBrokenMapping() throws Exception {
         MapperParsingException e = expectThrows( MapperParsingException.class,
             () -> client().admin().indices().preparePutTemplate("template_1")
                 .setPatterns(Collections.singletonList("te*"))
-                .addMapping("type1", "{\"foo\": \"abcde\"}", XContentType.JSON)
+                .setMapping("{\"foo\": \"abcde\"}", XContentType.JSON)
                 .get());
         assertThat(e.getMessage(), containsString("Failed to parse mapping"));
 
@@ -687,7 +687,7 @@ public void testCombineTemplates() throws Exception{
                     .setPatterns(Collections.singletonList("test*"))
                     .setCreate(true)
                     .setOrder(1)
-                    .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+                    .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
                         .startObject("field2").field("type", "text").field("analyzer", "custom_1").endObject()
                         .endObject().endObject().endObject())
                 .get());
@@ -719,7 +719,7 @@ public void testMultipleTemplate() throws IOException {
         client().admin().indices().preparePutTemplate("template_1")
             .setPatterns(Arrays.asList("a*", "b*"))
             .setSettings(indexSettings())
-            .addMapping("type1", XContentFactory.jsonBuilder().startObject().startObject("type1").startObject("properties")
+            .setMapping(XContentFactory.jsonBuilder().startObject().startObject("_doc").startObject("properties")
             .startObject("field1").field("type", "text").field("store", true).endObject()
             .startObject("field2").field("type", "keyword").field("store", false).endObject()
             .endObject().endObject().endObject())
@@ -781,7 +781,7 @@ public void testPartitionedTemplate() throws Exception {
         IllegalArgumentException eBadMapping = expectThrows(IllegalArgumentException.class,
             () -> client().admin().indices().preparePutTemplate("template_2")
                 .setPatterns(Collections.singletonList("te*"))
-                .addMapping("type", "{\"type\":{\"_routing\":{\"required\":false}}}", XContentType.JSON)
+                .setMapping("{\"_doc\":{\"_routing\":{\"required\":false}}}", XContentType.JSON)
                 .setSettings(Settings.builder()
                     .put("index.number_of_shards", "6")
                     .put("index.routing_partition_size", "3"))
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java b/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
index b54359e516d00..d5f6c98711cf4 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SharedClusterSnapshotRestoreIT.java
@@ -553,9 +553,9 @@ public void testRestoreTemplates() throws Exception {
         assertThat(client.admin().indices()
             .preparePutTemplate("test-template")
                 .setPatterns(Collections.singletonList("te*"))
-                .addMapping("test-mapping", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                     .startObject()
-                        .startObject("test-mapping")
+                        .startObject("_doc")
                             .startObject("properties")
                                 .startObject("field1")
                                     .field("type", "text")
@@ -611,7 +611,7 @@ public void testIncludeGlobalState() throws Exception {
             assertThat(client.admin().indices()
                 .preparePutTemplate("test-template")
                 .setPatterns(Collections.singletonList("te*"))
-                .addMapping("_doc", XContentFactory.jsonBuilder()
+                .setMapping(XContentFactory.jsonBuilder()
                     .startObject()
                         .startObject("_doc")
                             .startObject("properties")
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
index 635294ff7e4d9..b5305abd826c3 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
@@ -47,7 +47,6 @@
 import org.elasticsearch.gateway.GatewayService;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexNotFoundException;
-import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.indices.IndexClosedException;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.xpack.core.security.index.RestrictedIndicesNames;
@@ -429,7 +428,7 @@ private static byte[] readTemplateAsBytes(String templateName) {
 
     private static Tuple<String, Settings> parseMappingAndSettingsFromTemplateBytes(byte[] template) throws IOException {
         final PutIndexTemplateRequest request = new PutIndexTemplateRequest("name_is_not_important").source(template, XContentType.JSON);
-        final String mappingSource = request.mappings().get(MapperService.SINGLE_MAPPING_NAME);
+        final String mappingSource = request.mappings();
         try (XContentParser parser = XContentType.JSON.xContent().createParser(NamedXContentRegistry.EMPTY,
                 DeprecationHandler.THROW_UNSUPPORTED_OPERATION, mappingSource)) {
             ensureExpectedToken(XContentParser.Token.START_OBJECT, parser.nextToken(), parser::getTokenLocation); // {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/SecurityIndexManagerTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/SecurityIndexManagerTests.java
index b785f24f7c6a7..b6ac14041bb9b 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/SecurityIndexManagerTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/SecurityIndexManagerTests.java
@@ -38,6 +38,7 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.gateway.GatewayService;
 import org.elasticsearch.index.Index;
+import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.test.ESTestCase;
@@ -406,8 +407,7 @@ private static ClusterState state() {
     }
 
     private static IndexMetaData.Builder getIndexMetadata(String indexName, String aliasName, String templateName, int format,
-                                                          IndexMetaData.State state)
-            throws IOException {
+                                                          IndexMetaData.State state) {
         IndexMetaData.Builder indexMetaData = IndexMetaData.builder(indexName);
         indexMetaData.settings(Settings.builder()
                 .put(IndexMetaData.SETTING_VERSION_CREATED, Version.CURRENT)
@@ -417,25 +417,25 @@ private static IndexMetaData.Builder getIndexMetadata(String indexName, String a
                 .build());
         indexMetaData.putAlias(AliasMetaData.builder(aliasName).build());
         indexMetaData.state(state);
-        final Map<String, String> mappings = getTemplateMappings(templateName);
-        for (Map.Entry<String, String> entry : mappings.entrySet()) {
-            indexMetaData.putMapping(entry.getValue());
+        final String mappings = getTemplateMappings(templateName);
+        if (mappings != null) {
+            indexMetaData.putMapping(mappings);
         }
 
         return indexMetaData;
     }
 
     private static IndexTemplateMetaData.Builder getIndexTemplateMetaData(String templateName) throws IOException {
-        final Map<String, String> mappings = getTemplateMappings(templateName);
+        final String mappings = getTemplateMappings(templateName);
         IndexTemplateMetaData.Builder templateBuilder = IndexTemplateMetaData.builder(TEMPLATE_NAME)
                 .patterns(Arrays.asList(generateRandomStringArray(10, 100, false, false)));
-        for (Map.Entry<String, String> entry : mappings.entrySet()) {
-            templateBuilder.putMapping(entry.getKey(), entry.getValue());
+        if (mappings != null) {
+            templateBuilder.putMapping(MapperService.SINGLE_MAPPING_NAME, mappings);
         }
         return templateBuilder;
     }
 
-    private static Map<String, String> getTemplateMappings(String templateName) {
+    private static String getTemplateMappings(String templateName) {
         String template = loadTemplate(templateName);
         PutIndexTemplateRequest request = new PutIndexTemplateRequest();
         request.source(template, XContentType.JSON);
@@ -534,8 +534,8 @@ private static IndexMetaData.Builder createIndexMetadata(String indexName, Strin
             .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .build());
 
-        for (Map.Entry<String, String> entry : request.mappings().entrySet()) {
-            indexMetaData.putMapping(entry.getValue());
+        if (request.mappings() != null) {
+            indexMetaData.putMapping(request.mappings());
         }
         return indexMetaData;
     }
@@ -568,8 +568,8 @@ private static IndexTemplateMetaData.Builder getIndexTemplateMetaData(String tem
         request.source(template, XContentType.JSON);
         IndexTemplateMetaData.Builder templateBuilder = IndexTemplateMetaData.builder(templateName)
             .patterns(Arrays.asList(generateRandomStringArray(10, 100, false, false)));
-        for (Map.Entry<String, String> entry : request.mappings().entrySet()) {
-            templateBuilder.putMapping(entry.getKey(), entry.getValue());
+        if (request.mappings() != null) {
+            templateBuilder.putMapping(MapperService.SINGLE_MAPPING_NAME, request.mappings());
         }
         return templateBuilder;
     }
diff --git a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
index 2951ade8f47fb..df205e8e7a928 100644
--- a/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
+++ b/x-pack/plugin/transform/src/main/java/org/elasticsearch/xpack/transform/persistence/TransformInternalIndex.java
@@ -367,7 +367,7 @@ protected static void installLatestVersionedIndexTemplateIfRequired(
                 .patterns(indexTemplateMetaData.patterns())
                 .version(indexTemplateMetaData.version())
                 .settings(indexTemplateMetaData.settings())
-                .mapping(SINGLE_MAPPING_NAME, XContentHelper.convertToMap(jsonMappings, true, XContentType.JSON).v2());
+                .mapping(XContentHelper.convertToMap(jsonMappings, true, XContentType.JSON).v2());
             ActionListener<AcknowledgedResponse> innerListener = ActionListener.wrap(r -> listener.onResponse(null), listener::onFailure);
             executeAsyncWithOrigin(
                 client.threadPool().getThreadContext(),
@@ -402,7 +402,7 @@ protected static void installLatestAuditIndexTemplateIfRequired(
             )
                 .version(indexTemplateMetaData.version())
                 .settings(indexTemplateMetaData.settings())
-                .mapping(SINGLE_MAPPING_NAME, XContentHelper.convertToMap(jsonMappings, true, XContentType.JSON).v2());
+                .mapping(XContentHelper.convertToMap(jsonMappings, true, XContentType.JSON).v2());
             ActionListener<AcknowledgedResponse> innerListener = ActionListener.wrap(r -> listener.onResponse(null), listener::onFailure);
             executeAsyncWithOrigin(
                 client.threadPool().getThreadContext(),

From 8ca83e0b7e7b892b2f7653fff46acacd54c9296a Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Mon, 20 Jan 2020 10:49:22 -0500
Subject: [PATCH 669/686] Clean soft-deletes setting in ccr tests (#51113)

We no longer need to explicitly enable soft-deletes in CCR tests.

Relates #50775
---
 .../java/org/elasticsearch/client/CCRIT.java  |  3 -
 .../documentation/CCRDocumentationIT.java     |  7 --
 .../xpack/ccr/FollowIndexIT.java              |  8 +-
 .../elasticsearch/xpack/ccr/AutoFollowIT.java | 20 +----
 .../org/elasticsearch/xpack/ccr/ChainIT.java  |  5 +-
 .../xpack/ccr/FollowIndexIT.java              |  5 +-
 .../elasticsearch/xpack/ccr/XPackUsageIT.java |  7 +-
 .../elasticsearch/xpack/ccr/RestartIT.java    |  4 +-
 .../xpack/ccr/FollowIndexSecurityIT.java      | 18 +----
 .../elasticsearch/xpack/CcrIntegTestCase.java |  4 +
 .../elasticsearch/xpack/ccr/AutoFollowIT.java |  8 --
 .../xpack/ccr/CcrRepositoryIT.java            | 18 ++---
 .../xpack/ccr/CcrRetentionLeaseIT.java        | 18 +----
 .../xpack/ccr/CloseFollowerIndexIT.java       |  4 +-
 .../elasticsearch/xpack/ccr/FollowInfoIT.java |  9 +--
 .../xpack/ccr/FollowStatsIT.java              | 14 ++--
 .../xpack/ccr/FollowerFailOverIT.java         | 11 +--
 .../xpack/ccr/IndexFollowingIT.java           | 75 ++++++-------------
 .../xpack/ccr/LocalIndexFollowingIT.java      |  6 +-
 .../xpack/ccr/RestartIndexFollowingIT.java    |  5 +-
 .../action/AutoFollowCoordinatorTests.java    | 25 +++----
 .../ccr/action/ShardChangesActionTests.java   |  4 -
 .../xpack/ccr/action/ShardChangesTests.java   |  5 +-
 .../ShardFollowTaskReplicationTests.java      |  8 +-
 .../TransportResumeFollowActionTests.java     | 24 ++----
 .../action/bulk/BulkShardOperationsTests.java |  7 +-
 .../engine/FollowEngineIndexShardTests.java   | 12 +--
 .../index/engine/FollowingEngineTests.java    | 12 +--
 .../xpack/ilm/CCRIndexLifecycleIT.java        |  7 --
 29 files changed, 88 insertions(+), 265 deletions(-)

diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
index c6678102fe2b1..b2d8b2a4c4354 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/CCRIT.java
@@ -76,7 +76,6 @@ public void testIndexFollowing() throws Exception {
         CcrClient ccrClient = highLevelClient().ccr();
 
         CreateIndexRequest createIndexRequest = new CreateIndexRequest("leader");
-        createIndexRequest.settings(Collections.singletonMap("index.soft_deletes.enabled", true));
         CreateIndexResponse response = highLevelClient().indices().create(createIndexRequest, RequestOptions.DEFAULT);
         assertThat(response.isAcknowledged(), is(true));
 
@@ -193,7 +192,6 @@ public void testForgetFollower() throws IOException {
         final int numberOfShards = randomIntBetween(1, 2);
         settings.put("index.number_of_replicas", "0");
         settings.put("index.number_of_shards", Integer.toString(numberOfShards));
-        settings.put("index.soft_deletes.enabled", Boolean.TRUE.toString());
         createIndexRequest.settings(settings);
         final CreateIndexResponse response = highLevelClient().indices().create(createIndexRequest, RequestOptions.DEFAULT);
         assertThat(response.isAcknowledged(), is(true));
@@ -252,7 +250,6 @@ public void testAutoFollowing() throws Exception {
         assertThat(putAutoFollowPatternResponse.isAcknowledged(), is(true));
 
         CreateIndexRequest createIndexRequest = new CreateIndexRequest("logs-20200101");
-        createIndexRequest.settings(Collections.singletonMap("index.soft_deletes.enabled", true));
         CreateIndexResponse response = highLevelClient().indices().create(createIndexRequest, RequestOptions.DEFAULT);
         assertThat(response.isAcknowledged(), is(true));
 
diff --git a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
index 5e7da8142129d..5f5b76d0c5158 100644
--- a/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
+++ b/client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/CCRDocumentationIT.java
@@ -80,7 +80,6 @@ public void testPutFollow() throws Exception {
         {
             // Create leader index:
             CreateIndexRequest createIndexRequest = new CreateIndexRequest("leader");
-            createIndexRequest.settings(Collections.singletonMap("index.soft_deletes.enabled", true));
             CreateIndexResponse response = client.indices().create(createIndexRequest, RequestOptions.DEFAULT);
             assertThat(response.isAcknowledged(), is(true));
         }
@@ -161,7 +160,6 @@ public void testPauseFollow() throws Exception {
         {
             // Create leader index:
             CreateIndexRequest createIndexRequest = new CreateIndexRequest("leader");
-            createIndexRequest.settings(Collections.singletonMap("index.soft_deletes.enabled", true));
             CreateIndexResponse response = client.indices().create(createIndexRequest, RequestOptions.DEFAULT);
             assertThat(response.isAcknowledged(), is(true));
         }
@@ -227,7 +225,6 @@ public void testResumeFollow() throws Exception {
         {
             // Create leader index:
             CreateIndexRequest createIndexRequest = new CreateIndexRequest("leader");
-            createIndexRequest.settings(Collections.singletonMap("index.soft_deletes.enabled", true));
             CreateIndexResponse response = client.indices().create(createIndexRequest, RequestOptions.DEFAULT);
             assertThat(response.isAcknowledged(), is(true));
         }
@@ -303,7 +300,6 @@ public void testUnfollow() throws Exception {
         {
             // Create leader index:
             CreateIndexRequest createIndexRequest = new CreateIndexRequest("leader");
-            createIndexRequest.settings(Collections.singletonMap("index.soft_deletes.enabled", true));
             CreateIndexResponse response = client.indices().create(createIndexRequest, RequestOptions.DEFAULT);
             assertThat(response.isAcknowledged(), is(true));
         }
@@ -392,7 +388,6 @@ public void testForgetFollower() throws InterruptedException, IOException {
             final Map<String, String> settings = new HashMap<>(2);
             final int numberOfShards = randomIntBetween(1, 2);
             settings.put("index.number_of_shards", Integer.toString(numberOfShards));
-            settings.put("index.soft_deletes.enabled", Boolean.TRUE.toString());
             createIndexRequest.settings(settings);
             final CreateIndexResponse response = client.indices().create(createIndexRequest, RequestOptions.DEFAULT);
             assertThat(response.isAcknowledged(), is(true));
@@ -837,7 +832,6 @@ public void testGetFollowStats() throws Exception {
         {
             // Create leader index:
             CreateIndexRequest createIndexRequest = new CreateIndexRequest("leader");
-            createIndexRequest.settings(Collections.singletonMap("index.soft_deletes.enabled", true));
             CreateIndexResponse response = client.indices().create(createIndexRequest, RequestOptions.DEFAULT);
             assertThat(response.isAcknowledged(), is(true));
         }
@@ -905,7 +899,6 @@ public void testGetFollowInfos() throws Exception {
         {
             // Create leader index:
             CreateIndexRequest createIndexRequest = new CreateIndexRequest("leader");
-            createIndexRequest.settings(Collections.singletonMap("index.soft_deletes.enabled", true));
             CreateIndexResponse response = client.indices().create(createIndexRequest, RequestOptions.DEFAULT);
             assertThat(response.isAcknowledged(), is(true));
         }
diff --git a/x-pack/plugin/ccr/qa/downgrade-to-basic-license/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexIT.java b/x-pack/plugin/ccr/qa/downgrade-to-basic-license/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexIT.java
index 4e46de95adb03..cc8d399776ece 100644
--- a/x-pack/plugin/ccr/qa/downgrade-to-basic-license/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexIT.java
+++ b/x-pack/plugin/ccr/qa/downgrade-to-basic-license/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexIT.java
@@ -9,11 +9,9 @@
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.ResponseException;
 import org.elasticsearch.client.RestClient;
-import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.PathUtils;
 import org.elasticsearch.common.logging.JsonLogLine;
 import org.elasticsearch.common.logging.JsonLogsStream;
-import org.elasticsearch.common.settings.Settings;
 import org.hamcrest.FeatureMatcher;
 import org.hamcrest.Matcher;
 import org.hamcrest.Matchers;
@@ -114,12 +112,8 @@ protected Boolean featureValueOf(JsonLogLine actual) {
     }
 
     private void createNewIndexAndIndexDocs(RestClient client, String index) throws IOException {
-        Settings settings = Settings.builder()
-                                    .put("index.soft_deletes.enabled", true)
-                                    .build();
         Request request = new Request("PUT", "/" + index);
-        request.setJsonEntity("{\"settings\": " + Strings.toString(settings) +
-            ", \"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}");
+        request.setJsonEntity("{\"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}");
         assertOK(client.performRequest(request));
 
         for (int i = 0; i < 5; i++) {
diff --git a/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java b/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
index 055c536faac39..cad4ffb314b4f 100644
--- a/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
+++ b/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
@@ -8,8 +8,6 @@
 
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.RestClient;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.settings.Settings;
 
 import java.io.IOException;
 import java.util.Map;
@@ -33,12 +31,8 @@ public void testMultipleAutoFollowPatternsDifferentClusters() throws Exception {
         putPatternRequest.setJsonEntity("{\"leader_index_patterns\": [\"logs-*\"], \"remote_cluster\": \"middle_cluster\"}");
         assertOK(client().performRequest(putPatternRequest));
         try (RestClient leaderClient = buildLeaderClient()) {
-            Settings settings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
-                .build();
             Request request = new Request("PUT", "/logs-20190101");
-            request.setJsonEntity("{\"settings\": " + Strings.toString(settings) +
-                ", \"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}");
+            request.setJsonEntity("{\"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}");
             assertOK(leaderClient.performRequest(request));
             for (int i = 0; i < 5; i++) {
                 String id = Integer.toString(i);
@@ -46,12 +40,8 @@ public void testMultipleAutoFollowPatternsDifferentClusters() throws Exception {
             }
         }
         try (RestClient middleClient = buildMiddleClient()) {
-            Settings settings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
-                .build();
             Request request = new Request("PUT", "/logs-20200101");
-            request.setJsonEntity("{\"settings\": " + Strings.toString(settings) +
-                ", \"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}");
+            request.setJsonEntity("{\"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}");
             assertOK(middleClient.performRequest(request));
             for (int i = 0; i < 5; i++) {
                 String id = Integer.toString(i);
@@ -80,12 +70,8 @@ public void testAutoFollowPatterns() throws Exception {
         assertOK(client().performRequest(request));
 
         try (RestClient leaderClient = buildLeaderClient()) {
-            Settings settings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
-                .build();
             request = new Request("PUT", "/metrics-20210101");
-            request.setJsonEntity("{\"settings\": " + Strings.toString(settings) +
-                ", \"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}");
+            request.setJsonEntity("{\"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}");
             assertOK(leaderClient.performRequest(request));
 
             for (int i = 0; i < 5; i++) {
diff --git a/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/ChainIT.java b/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/ChainIT.java
index b3e6384f7f635..72ae8764e7099 100644
--- a/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/ChainIT.java
+++ b/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/ChainIT.java
@@ -25,10 +25,7 @@ public void testFollowIndex() throws Exception {
                     "  \"excludes\": [\"filtered_field\"]" +
                     "}";
             }
-            Settings indexSettings = Settings.builder()
-                    .put("index.soft_deletes.enabled", true)
-                    .build();
-            createIndex(leaderIndexName, indexSettings, mapping);
+            createIndex(leaderIndexName, Settings.EMPTY, mapping);
             for (int i = 0; i < numDocs; i++) {
                 logger.info("Indexing doc [{}]", i);
                 index(client(), leaderIndexName, Integer.toString(i), "field", i, "filtered_field", "true");
diff --git a/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexIT.java b/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexIT.java
index b50fe9233e8fa..61b3c8b11865d 100644
--- a/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexIT.java
+++ b/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexIT.java
@@ -30,10 +30,7 @@ public void testFollowIndex() throws Exception {
                     "  \"excludes\": [\"filtered_field\"]" +
                     "}";
             }
-            Settings indexSettings = Settings.builder()
-                    .put("index.soft_deletes.enabled", true)
-                    .build();
-            createIndex(leaderIndexName, indexSettings, mapping);
+            createIndex(leaderIndexName, Settings.EMPTY, mapping);
             for (int i = 0; i < numDocs; i++) {
                 logger.info("Indexing doc [{}]", i);
                 index(client(), leaderIndexName, Integer.toString(i), "field", i, "filtered_field", "true");
diff --git a/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/XPackUsageIT.java b/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/XPackUsageIT.java
index b429657fe57cf..8d5a8d62a46ff 100644
--- a/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/XPackUsageIT.java
+++ b/x-pack/plugin/ccr/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ccr/XPackUsageIT.java
@@ -7,8 +7,6 @@
 
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.RestClient;
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.ObjectPath;
 
 import java.io.IOException;
@@ -70,11 +68,8 @@ public void testXPackCcrUsage() throws Exception {
 
     private void createLeaderIndex(String indexName) throws IOException {
         try (RestClient leaderClient = buildLeaderClient()) {
-            Settings settings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
-                .build();
             Request request = new Request("PUT", "/" + indexName);
-            request.setJsonEntity("{\"settings\": " + Strings.toString(settings) + "}");
+            request.setJsonEntity("{}");
             assertOK(leaderClient.performRequest(request));
         }
     }
diff --git a/x-pack/plugin/ccr/qa/restart/src/test/java/org/elasticsearch/xpack/ccr/RestartIT.java b/x-pack/plugin/ccr/qa/restart/src/test/java/org/elasticsearch/xpack/ccr/RestartIT.java
index cbbc6945034c0..7422fe1b766ac 100644
--- a/x-pack/plugin/ccr/qa/restart/src/test/java/org/elasticsearch/xpack/ccr/RestartIT.java
+++ b/x-pack/plugin/ccr/qa/restart/src/test/java/org/elasticsearch/xpack/ccr/RestartIT.java
@@ -10,7 +10,6 @@
 import org.elasticsearch.client.RestClient;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.index.IndexSettings;
 
 import java.io.IOException;
 
@@ -71,9 +70,8 @@ public void testRestart() throws Exception {
     }
 
     private void createIndexAndIndexDocuments(final String index, final int numberOfDocuments, final RestClient client) throws IOException {
-        final Settings settings = Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
         final Request createIndexRequest = new Request("PUT", "/" + index);
-        createIndexRequest.setJsonEntity("{\"settings\":" + Strings.toString(settings) + "}");
+        createIndexRequest.setJsonEntity("{\"settings\":" + Strings.toString(Settings.EMPTY) + "}");
         assertOK(client.performRequest(createIndexRequest));
         indexDocuments(index, numberOfDocuments, 0, client);
     }
diff --git a/x-pack/plugin/ccr/qa/security/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java b/x-pack/plugin/ccr/qa/security/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java
index f8ed48777dacc..7f1e4c37536b5 100644
--- a/x-pack/plugin/ccr/qa/security/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java
+++ b/x-pack/plugin/ccr/qa/security/src/test/java/org/elasticsearch/xpack/ccr/FollowIndexSecurityIT.java
@@ -9,7 +9,6 @@
 import org.elasticsearch.client.Response;
 import org.elasticsearch.client.ResponseException;
 import org.elasticsearch.client.RestClient;
-import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.SecureString;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
@@ -53,9 +52,8 @@ public void testFollowIndex() throws Exception {
         final String unallowedIndex  = "unallowed-index";
         if ("leader".equals(targetCluster)) {
             logger.info("Running against leader cluster");
-            Settings indexSettings = Settings.builder().put("index.soft_deletes.enabled", true).build();
-            createIndex(allowedIndex, indexSettings);
-            createIndex(unallowedIndex, indexSettings);
+            createIndex(allowedIndex, Settings.EMPTY);
+            createIndex(unallowedIndex, Settings.EMPTY);
             for (int i = 0; i < numDocs; i++) {
                 logger.info("Indexing doc [{}]", i);
                 index(allowedIndex, Integer.toString(i), "field", i);
@@ -150,11 +148,7 @@ public void testAutoFollowPatterns() throws Exception {
 
         try (RestClient leaderClient = buildLeaderClient()) {
             for (String index : new String[]{allowedIndex, disallowedIndex}) {
-                Settings settings = Settings.builder()
-                    .put("index.soft_deletes.enabled", true)
-                    .build();
-                String requestBody = "{\"settings\": " + Strings.toString(settings) +
-                    ", \"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}";
+                String requestBody = "{\"mappings\": {\"properties\": {\"field\": {\"type\": \"keyword\"}}}}";
                 request = new Request("PUT", "/" + index);
                 request.setJsonEntity(requestBody);
                 assertOK(leaderClient.performRequest(request));
@@ -187,11 +181,7 @@ public void testForgetFollower() throws IOException {
         final String forgetFollower = "forget-follower";
         if ("leader".equals(targetCluster)) {
             logger.info("running against leader cluster");
-            final Settings indexSettings = Settings.builder()
-                    .put("index.number_of_replicas", 0)
-                    .put("index.number_of_shards", 1)
-                    .put("index.soft_deletes.enabled", true)
-                    .build();
+            final Settings indexSettings = Settings.builder().put("index.number_of_replicas", 0).put("index.number_of_shards", 1).build();
             createIndex(forgetLeader, indexSettings);
         } else {
             logger.info("running against follower cluster");
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
index fbd537ed18d98..7181dd9b6c9a2 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/CcrIntegTestCase.java
@@ -413,6 +413,10 @@ public void setupSourceEnabledOrDisabled() {
 
     protected boolean sourceEnabled;
 
+    protected String getIndexSettings(final int numberOfShards, final int numberOfReplicas) throws IOException {
+        return getIndexSettings(numberOfShards, numberOfReplicas, Collections.emptyMap());
+    }
+
     protected String getIndexSettings(final int numberOfShards, final int numberOfReplicas,
                                     final Map<String, String> additionalIndexSettings) throws IOException {
         final String settings;
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
index dcbcad3b2048d..3551288b65342 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/AutoFollowIT.java
@@ -18,7 +18,6 @@
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.index.IndexNotFoundException;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.xpack.CcrIntegTestCase;
 import org.elasticsearch.xpack.core.ccr.AutoFollowMetadata;
@@ -60,7 +59,6 @@ protected boolean reuseClusters() {
 
     public void testAutoFollow() throws Exception {
         Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
             .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
             .build();
@@ -94,7 +92,6 @@ public void testAutoFollow() throws Exception {
 
     public void testCleanFollowedLeaderIndexUUIDs() throws Exception {
         Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
             .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
             .build();
@@ -133,7 +130,6 @@ public void testCleanFollowedLeaderIndexUUIDs() throws Exception {
 
     public void testAutoFollowManyIndices() throws Exception {
         Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
             .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
             .build();
@@ -215,7 +211,6 @@ public void testAutoFollowManyIndices() throws Exception {
 
     public void testAutoFollowParameterAreDelegated() throws Exception {
         Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
             .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
             .build();
@@ -318,7 +313,6 @@ public void testAutoFollowParameterAreDelegated() throws Exception {
 
     public void testConflictingPatterns() throws Exception {
         Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
             .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
             .build();
@@ -360,7 +354,6 @@ public void testConflictingPatterns() throws Exception {
 
     public void testPauseAndResumeAutoFollowPattern() throws Exception {
         final Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
             .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
             .build();
@@ -430,7 +423,6 @@ public void testPauseAndResumeAutoFollowPattern() throws Exception {
 
     public void testPauseAndResumeWithMultipleAutoFollowPatterns() throws Exception {
         final Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
             .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
             .build();
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRepositoryIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRepositoryIT.java
index a8f393073a745..e48e03b8d2b79 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRepositoryIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRepositoryIT.java
@@ -24,7 +24,6 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.repositories.RepositoriesService;
 import org.elasticsearch.repositories.Repository;
 import org.elasticsearch.repositories.RepositoryMissingException;
@@ -48,7 +47,6 @@
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.greaterThan;
@@ -109,8 +107,7 @@ public void testThatRepositoryRecoversEmptyIndexBasedOnLeaderSettings() throws I
         String followerIndex = "index2";
 
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen(leaderIndex);
 
@@ -157,7 +154,6 @@ public void testThatRepositoryRecoversEmptyIndexBasedOnLeaderSettings() throws I
         assertEquals(leaderMetadata.getIndexUUID(), ccrMetadata.get(Ccr.CCR_CUSTOM_METADATA_LEADER_INDEX_UUID_KEY));
         assertEquals("leader_cluster", ccrMetadata.get(Ccr.CCR_CUSTOM_METADATA_REMOTE_CLUSTER_NAME_KEY));
         assertEquals(followerIndex, followerMetadata.getSettings().get(IndexMetaData.SETTING_INDEX_PROVIDED_NAME));
-        assertEquals(true, IndexSettings.INDEX_SOFT_DELETES_SETTING.get(followerMetadata.getSettings()));
 
         // UUID is changed so that we can follow indexes on same cluster
         assertNotEquals(leaderMetadata.getIndexUUID(), followerMetadata.getIndexUUID());
@@ -174,8 +170,7 @@ public void testDocsAreRecovered() throws Exception {
         String followerIndex = "index2";
 
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen(leaderIndex);
 
@@ -231,8 +226,7 @@ public void testRateLimitingIsEmployed() throws Exception {
         String followerIndex = "index2";
 
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen(leaderIndex);
 
@@ -297,8 +291,7 @@ public void testIndividualActionsTimeout() throws Exception {
         String followerIndex = "index2";
 
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen(leaderIndex);
 
@@ -372,8 +365,7 @@ public void testFollowerMappingIsUpdated() throws IOException {
         String followerIndex = "index2";
 
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen(leaderIndex);
 
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRetentionLeaseIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRetentionLeaseIT.java
index b74ca1dbc985a..782a61206d8ce 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRetentionLeaseIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CcrRetentionLeaseIT.java
@@ -32,7 +32,6 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.seqno.RetentionLease;
 import org.elasticsearch.index.seqno.RetentionLeaseActions;
 import org.elasticsearch.index.seqno.RetentionLeaseNotFoundException;
@@ -75,7 +74,6 @@
 import java.util.stream.IntStream;
 import java.util.stream.Stream;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.elasticsearch.xpack.ccr.CcrRetentionLeases.retentionLeaseId;
 import static org.hamcrest.Matchers.arrayWithSize;
@@ -128,7 +126,6 @@ private RestoreSnapshotRequest setUpRestoreSnapshotRequest(
         final String leaderClusterRepoName = CcrRepository.NAME_PREFIX + "leader_cluster";
 
         final Map<String, String> additionalSettings = new HashMap<>();
-        additionalSettings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true");
         additionalSettings.put(IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(), TimeValue.timeValueMillis(200).getStringRep());
         final String leaderIndexSettings = getIndexSettings(numberOfShards, numberOfReplicas, additionalSettings);
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON));
@@ -371,8 +368,7 @@ public void testUnfollowRemovesRetentionLeases() throws Exception {
         final String leaderIndex = "leader";
         final String followerIndex = "follower";
         final int numberOfShards = randomIntBetween(1, 4);
-        final String leaderIndexSettings =
-                getIndexSettings(numberOfShards, 0, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfShards, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON).get());
         ensureLeaderYellow(leaderIndex);
         final PutFollowAction.Request followRequest = putFollow(leaderIndex, followerIndex);
@@ -464,8 +460,7 @@ public void testUnfollowFailsToRemoveRetentionLeases() throws Exception {
         final String leaderIndex = "leader";
         final String followerIndex = "follower";
         final int numberOfShards = randomIntBetween(1, 4);
-        final String leaderIndexSettings =
-                getIndexSettings(numberOfShards, 0, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfShards, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON).get());
         ensureLeaderYellow(leaderIndex);
         final PutFollowAction.Request followRequest = putFollow(leaderIndex, followerIndex);
@@ -536,7 +531,6 @@ public void testRetentionLeaseRenewedWhileFollowing() throws Exception {
         final int numberOfShards = randomIntBetween(1, 4);
         final int numberOfReplicas = randomIntBetween(0, 1);
         final Map<String, String> additionalIndexSettings = new HashMap<>();
-        additionalIndexSettings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), Boolean.toString(true));
         additionalIndexSettings.put(
                 IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(),
                 TimeValue.timeValueMillis(200).getStringRep());
@@ -556,7 +550,6 @@ public void testRetentionLeaseAdvancesWhileFollowing() throws Exception {
         final int numberOfShards = randomIntBetween(1, 4);
         final int numberOfReplicas = randomIntBetween(0, 1);
         final Map<String, String> additionalIndexSettings = new HashMap<>();
-        additionalIndexSettings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), Boolean.toString(true));
         additionalIndexSettings.put(
                 IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(),
                 TimeValue.timeValueMillis(200).getStringRep());
@@ -620,7 +613,6 @@ public void testRetentionLeaseRenewalIsCancelledWhenFollowingIsPaused() throws E
         final int numberOfShards = randomIntBetween(1, 4);
         final int numberOfReplicas = randomIntBetween(0, 1);
         final Map<String, String> additionalIndexSettings = new HashMap<>();
-        additionalIndexSettings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), Boolean.toString(true));
         additionalIndexSettings.put(
                 IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(),
                 TimeValue.timeValueMillis(200).getStringRep());
@@ -727,7 +719,6 @@ public void testRetentionLeaseRenewalIsResumedWhenFollowingIsResumed() throws Ex
         final int numberOfShards = randomIntBetween(1, 4);
         final int numberOfReplicas = randomIntBetween(0, 1);
         final Map<String, String> additionalIndexSettings = new HashMap<>();
-        additionalIndexSettings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), Boolean.toString(true));
         additionalIndexSettings.put(
                 IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(),
                 TimeValue.timeValueMillis(200).getStringRep());
@@ -754,7 +745,6 @@ public void testRetentionLeaseIsAddedIfItDisappearsWhileFollowing() throws Excep
         final int numberOfShards = 1;
         final int numberOfReplicas = 1;
         final Map<String, String> additionalIndexSettings = new HashMap<>();
-        additionalIndexSettings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), Boolean.toString(true));
         additionalIndexSettings.put(
                 IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(),
                 TimeValue.timeValueMillis(200).getStringRep());
@@ -855,7 +845,6 @@ public void testPeriodicRenewalDoesNotAddRetentionLeaseAfterUnfollow() throws Ex
         final int numberOfShards = 1;
         final int numberOfReplicas = 1;
         final Map<String, String> additionalIndexSettings = new HashMap<>();
-        additionalIndexSettings.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), Boolean.toString(true));
         additionalIndexSettings.put(
                 IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(),
                 TimeValue.timeValueMillis(200).getStringRep());
@@ -945,8 +934,7 @@ public void testForgetFollower() throws Exception {
         final String leaderIndex = "leader";
         final String followerIndex = "follower";
         final int numberOfShards = randomIntBetween(1, 4);
-        final String leaderIndexSettings =
-                getIndexSettings(numberOfShards, 0, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfShards, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON).get());
         ensureLeaderYellow(leaderIndex);
         final PutFollowAction.Request followRequest = putFollow(leaderIndex, followerIndex);
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CloseFollowerIndexIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CloseFollowerIndexIT.java
index 82ca1a61e752d..c77515abefb9e 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CloseFollowerIndexIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/CloseFollowerIndexIT.java
@@ -17,7 +17,6 @@
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.engine.ReadOnlyEngine;
 import org.elasticsearch.xpack.CcrIntegTestCase;
 import org.elasticsearch.xpack.core.ccr.action.PutFollowAction;
@@ -29,7 +28,6 @@
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
@@ -67,7 +65,7 @@ public void restoreUncaughtExceptionHandler() {
     }
 
     public void testCloseAndReopenFollowerIndex() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 1, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 1);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("index1");
 
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowInfoIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowInfoIT.java
index 478043a862b38..07f9380b45ebb 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowInfoIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowInfoIT.java
@@ -8,15 +8,14 @@
 
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.index.IndexNotFoundException;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.xpack.CcrSingleNodeTestCase;
 import org.elasticsearch.xpack.core.ccr.action.FollowInfoAction;
 import org.elasticsearch.xpack.core.ccr.action.PauseFollowAction;
 import org.elasticsearch.xpack.core.ccr.action.PutFollowAction;
 
+import java.util.Collections;
 import java.util.Comparator;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.elasticsearch.xpack.ccr.LocalIndexFollowingIT.getIndexSettings;
 import static org.elasticsearch.xpack.core.ccr.action.FollowInfoAction.Response.Status;
@@ -27,8 +26,7 @@
 public class FollowInfoIT extends CcrSingleNodeTestCase {
 
     public void testFollowInfoApiFollowerIndexFiltering() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0, Collections.emptyMap());
         assertAcked(client().admin().indices().prepareCreate("leader1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureGreen("leader1");
         assertAcked(client().admin().indices().prepareCreate("leader2").setSource(leaderIndexSettings, XContentType.JSON));
@@ -111,8 +109,7 @@ public void testFollowInfoApiFollowerIndexFiltering() throws Exception {
     }
 
     public void testFollowInfoApiIndexMissing() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0, Collections.emptyMap());
         assertAcked(client().admin().indices().prepareCreate("leader1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureGreen("leader1");
         assertAcked(client().admin().indices().prepareCreate("leader2").setSource(leaderIndexSettings, XContentType.JSON));
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowStatsIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowStatsIT.java
index df24a5296a24c..fea0ede8f96ad 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowStatsIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowStatsIT.java
@@ -13,7 +13,6 @@
 import org.elasticsearch.action.admin.indices.close.CloseIndexRequest;
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.persistent.PersistentTasksCustomMetaData;
 import org.elasticsearch.xpack.CcrSingleNodeTestCase;
 import org.elasticsearch.xpack.core.ccr.action.CcrStatsAction;
@@ -21,12 +20,12 @@
 import org.elasticsearch.xpack.core.ccr.action.PauseFollowAction;
 import org.elasticsearch.xpack.core.ccr.action.PutFollowAction;
 
+import java.util.Collections;
 import java.util.Comparator;
 import java.util.List;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.atomic.AtomicBoolean;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.elasticsearch.xpack.ccr.LocalIndexFollowingIT.getIndexSettings;
 import static org.hamcrest.Matchers.equalTo;
@@ -79,8 +78,7 @@ public void onFailure(final Exception e) {
     }
 
     public void testFollowStatsApiFollowerIndexFiltering() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0, Collections.emptyMap());
         assertAcked(client().admin().indices().prepareCreate("leader1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureGreen("leader1");
         assertAcked(client().admin().indices().prepareCreate("leader2").setSource(leaderIndexSettings, XContentType.JSON));
@@ -130,8 +128,7 @@ public void testFollowStatsApiResourceNotFound() throws Exception {
             () -> client().execute(FollowStatsAction.INSTANCE, statsRequest).actionGet());
         assertThat(e.getMessage(), equalTo("No shard follow tasks for follower indices [follower1]"));
 
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0, Collections.emptyMap());
         assertAcked(client().admin().indices().prepareCreate("leader1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureGreen("leader1");
 
@@ -151,7 +148,7 @@ public void testFollowStatsApiResourceNotFound() throws Exception {
     }
 
     public void testFollowStatsApiWithDeletedFollowerIndex() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 0, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0, Collections.emptyMap());
         assertAcked(client().admin().indices().prepareCreate("leader1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureGreen("leader1");
 
@@ -179,8 +176,7 @@ public void testFollowStatsApiWithDeletedFollowerIndex() throws Exception {
     }
 
     public void testFollowStatsApiIncludeShardFollowStatsWithClosedFollowerIndex() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0, Collections.emptyMap());
         assertAcked(client().admin().indices().prepareCreate("leader1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureGreen("leader1");
 
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowerFailOverIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowerFailOverIT.java
index 177b1c66ca457..1b7f7c1a9aa1f 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowerFailOverIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/FollowerFailOverIT.java
@@ -21,7 +21,6 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.mapper.DocumentMapper;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.shard.ShardId;
@@ -39,7 +38,6 @@
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicInteger;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.equalTo;
 
@@ -56,8 +54,7 @@ public void testFailOverOnFollower() throws Exception {
         int numberOfReplicas = between(1, 2);
         getFollowerCluster().startMasterOnlyNode();
         getFollowerCluster().ensureAtLeastNumDataNodes(numberOfReplicas + between(1, 2));
-        String leaderIndexSettings = getIndexSettings(1, numberOfReplicas,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        String leaderIndexSettings = getIndexSettings(1, numberOfReplicas);
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex).setSource(leaderIndexSettings, XContentType.JSON));
         AtomicBoolean stopped = new AtomicBoolean();
         Thread[] threads = new Thread[between(1, 8)];
@@ -122,7 +119,7 @@ public void testFailOverOnFollower() throws Exception {
 
     public void testFollowIndexAndCloseNode() throws Exception {
         getFollowerCluster().ensureAtLeastNumDataNodes(3);
-        String leaderIndexSettings = getIndexSettings(3, 1, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        String leaderIndexSettings = getIndexSettings(3, 1);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen("index1");
 
@@ -176,8 +173,7 @@ public void testFollowIndexAndCloseNode() throws Exception {
 
     public void testAddNewReplicasOnFollower() throws Exception {
         int numberOfReplicas = between(0, 1);
-        String leaderIndexSettings = getIndexSettings(1, numberOfReplicas,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        String leaderIndexSettings = getIndexSettings(1, numberOfReplicas);
         assertAcked(leaderClient().admin().indices().prepareCreate("leader-index").setSource(leaderIndexSettings, XContentType.JSON));
         PutFollowAction.Request follow = putFollow("leader-index", "follower-index");
         followerClient().execute(PutFollowAction.INSTANCE, follow).get();
@@ -244,7 +240,6 @@ public void testReadRequestsReturnLatestMappingVersion() throws Exception {
                 .setSettings(Settings.builder()
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true")
                     .put("index.routing.allocation.require.box", "large"))
                 .get()
         );
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
index e25c0be5731ae..c12021eaf21ee 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/IndexFollowingIT.java
@@ -66,7 +66,6 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexNotFoundException;
 import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.seqno.ReplicationTracker;
 import org.elasticsearch.index.seqno.RetentionLeaseActions;
 import org.elasticsearch.index.shard.ShardId;
@@ -114,7 +113,6 @@
 import java.util.stream.IntStream;
 import java.util.stream.Stream;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.elasticsearch.xpack.ccr.CcrRetentionLeases.retentionLeaseId;
@@ -145,8 +143,7 @@ public void testFollowIndex() throws Exception {
                 new ByteSizeValue(randomIntBetween(1, 1000), ByteSizeUnit.KB)))
             .get();
 
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, numberOfReplicas,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, numberOfReplicas);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("index1");
 
@@ -244,8 +241,7 @@ public void testFollowIndex() throws Exception {
 
     public void testFollowIndexWithConcurrentMappingChanges() throws Exception {
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("index1");
 
@@ -313,8 +309,7 @@ public void testFollowIndexWithConcurrentMappingChanges() throws Exception {
 
     public void testFollowIndexWithoutWaitForComplete() throws Exception {
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("index1");
 
@@ -355,8 +350,7 @@ public void testFollowIndexWithoutWaitForComplete() throws Exception {
     }
 
     public void testSyncMappings() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(2, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(2, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("index1");
 
@@ -395,7 +389,6 @@ public void testSyncMappings() throws Exception {
     public void testNoMappingDefined() throws Exception {
         assertAcked(leaderClient().admin().indices().prepareCreate("index1")
             .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .build()));
@@ -415,8 +408,7 @@ public void testNoMappingDefined() throws Exception {
     }
 
     public void testDoNotAllowPutMappingToFollower() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(between(1, 2), between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(between(1, 2), between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("index-1").setSource(leaderIndexSettings, XContentType.JSON));
         followerClient().execute(PutFollowAction.INSTANCE, putFollow("index-1", "index-2")).get();
         PutMappingRequest putMappingRequest = new PutMappingRequest("index-2").source("new_field", "type=keyword");
@@ -435,7 +427,7 @@ public void testDoNotAllowPutMappingToFollower() throws Exception {
 
     public void testDoNotAllowAddAliasToFollower() throws Exception {
         final String leaderIndexSettings =
-                getIndexSettings(between(1, 2), between(0, 1), singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+                getIndexSettings(between(1, 2), between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(leaderIndexSettings, XContentType.JSON));
         followerClient().execute(PutFollowAction.INSTANCE, putFollow("leader", "follower")).get();
         final IndicesAliasesRequest request = new IndicesAliasesRequest()
@@ -451,7 +443,7 @@ public void testDoNotAllowAddAliasToFollower() throws Exception {
 
     public void testAddAliasAfterUnfollow() throws Exception {
         final String leaderIndexSettings =
-                getIndexSettings(between(1, 2), between(0, 1), singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+                getIndexSettings(between(1, 2), between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(leaderIndexSettings, XContentType.JSON));
         followerClient().execute(PutFollowAction.INSTANCE, putFollow("leader", "follower")).get();
         pauseFollow("follower");
@@ -472,8 +464,7 @@ public void testAddAliasAfterUnfollow() throws Exception {
 
     public void testFollowIndex_backlog() throws Exception {
         int numberOfShards = between(1, 5);
-        String leaderIndexSettings = getIndexSettings(numberOfShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        String leaderIndexSettings = getIndexSettings(numberOfShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         BulkProcessor.Listener listener = new BulkProcessor.Listener() {
             @Override
@@ -536,8 +527,7 @@ public void afterBulk(long executionId, BulkRequest request, Throwable failure)
     }
 
     public void testFollowIndexWithNestedField() throws Exception {
-        final String leaderIndexSettings =
-            getIndexSettingsWithNestedMapping(1, between(0, 1), singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettingsWithNestedMapping(1, between(0, 1), Collections.emptyMap());
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen("index1");
 
@@ -582,7 +572,7 @@ public void testUnfollowNonExistingIndex() {
     }
 
     public void testFollowNonExistentIndex() throws Exception {
-        String indexSettings = getIndexSettings(1, 0, Collections.emptyMap());
+        String indexSettings = getIndexSettings(1, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate("test-leader").setSource(indexSettings, XContentType.JSON).get());
         assertAcked(followerClient().admin().indices().prepareCreate("test-follower").setSource(indexSettings, XContentType.JSON).get());
         ensureLeaderGreen("test-leader");
@@ -603,8 +593,7 @@ public void testFollowNonExistentIndex() throws Exception {
     }
 
     public void testFollowIndexMaxOperationSizeInBytes() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("index1");
 
@@ -638,7 +627,7 @@ public void testFollowIndexMaxOperationSizeInBytes() throws Exception {
     }
 
     public void testAttemptToChangeCcrFollowingIndexSetting() throws Exception {
-        String leaderIndexSettings = getIndexSettings(1, 0, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        String leaderIndexSettings = getIndexSettings(1, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON).get());
         ensureLeaderYellow("index1");
         PutFollowAction.Request followRequest = putFollow("index1", "index2");
@@ -657,7 +646,6 @@ public void testAttemptToChangeCcrFollowingIndexSetting() throws Exception {
     public void testCloseLeaderIndex() throws Exception {
         assertAcked(leaderClient().admin().indices().prepareCreate("index1")
             .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .build()));
@@ -691,7 +679,6 @@ public void testCloseLeaderIndex() throws Exception {
     public void testCloseFollowIndex() throws Exception {
         assertAcked(leaderClient().admin().indices().prepareCreate("index1")
             .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .build()));
@@ -720,7 +707,6 @@ public void testCloseFollowIndex() throws Exception {
     public void testDeleteLeaderIndex() throws Exception {
         assertAcked(leaderClient().admin().indices().prepareCreate("index1")
             .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .build()));
@@ -748,10 +734,7 @@ public void testDeleteLeaderIndex() throws Exception {
 
     public void testFollowClosedIndex() {
         final String leaderIndex = "test-index";
-        assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex)
-            .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
-                .build()));
+        assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex));
         assertAcked(leaderClient().admin().indices().prepareClose(leaderIndex));
 
         final String followerIndex = "follow-test-index";
@@ -764,7 +747,6 @@ public void testResumeFollowOnClosedIndex() throws Exception {
         final String leaderIndex = "test-index";
         assertAcked(leaderClient().admin().indices().prepareCreate(leaderIndex)
             .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .build()));
@@ -790,7 +772,6 @@ public void testResumeFollowOnClosedIndex() throws Exception {
     public void testDeleteFollowerIndex() throws Exception {
         assertAcked(leaderClient().admin().indices().prepareCreate("index1")
             .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .build()));
@@ -821,7 +802,6 @@ public void testDeleteFollowerIndex() throws Exception {
     public void testPauseIndex() throws Exception {
         assertAcked(leaderClient().admin().indices().prepareCreate("leader")
             .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                 .build()));
@@ -840,7 +820,7 @@ public void testPauseIndex() throws Exception {
     }
 
     public void testUnfollowIndex() throws Exception {
-        String leaderIndexSettings = getIndexSettings(1, 0, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        String leaderIndexSettings = getIndexSettings(1, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON).get());
         PutFollowAction.Request followRequest = putFollow("index1", "index2");
         followerClient().execute(PutFollowAction.INSTANCE, followRequest).get();
@@ -867,8 +847,7 @@ public void testUnfollowIndex() throws Exception {
     }
 
     public void testUnknownClusterAlias() throws Exception {
-        String leaderIndexSettings = getIndexSettings(1, 0,
-            Collections.singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        String leaderIndexSettings = getIndexSettings(1, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen("index1");
         PutFollowAction.Request followRequest = putFollow("index1", "index2");
@@ -893,7 +872,6 @@ public void testLeaderIndexRed() throws Exception {
             assertAcked(leaderClient().admin().indices().prepareCreate("index1")
                 .setWaitForActiveShards(ActiveShardCount.NONE)
                 .setSettings(Settings.builder()
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
                     .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0)
                     .build()));
@@ -913,8 +891,7 @@ public void testLeaderIndexRed() throws Exception {
     }
 
     public void testUpdateDynamicLeaderIndexSettings() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("leader");
 
@@ -967,8 +944,7 @@ public void testLeaderIndexSettingNotPercolatedToFollower() throws Exception {
         // Sets an index setting on leader index that is excluded from being replicated to the follower index and
         // expects that this setting is not replicated to the follower index, but does expect that the settings version
         // is incremented.
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("leader");
 
@@ -1017,8 +993,7 @@ public void testLeaderIndexSettingNotPercolatedToFollower() throws Exception {
     }
 
     public void testUpdateAnalysisLeaderIndexSettings() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("leader");
 
@@ -1089,8 +1064,7 @@ public void testUpdateAnalysisLeaderIndexSettings() throws Exception {
     }
 
     public void testDoNotReplicatePrivateSettings() throws Exception {
-        assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(
-            getIndexSettings(1, 0, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true")), XContentType.JSON));
+        assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(getIndexSettings(1, 0), XContentType.JSON));
         ensureLeaderGreen("leader");
         final PutFollowAction.Request followRequest = putFollow("leader", "follower");
         followerClient().execute(PutFollowAction.INSTANCE, followRequest).get();
@@ -1129,8 +1103,7 @@ public void onFailure(String source, Exception e) {
     }
 
     public void testReplicatePrivateSettingsOnly() throws Exception {
-        assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(
-            getIndexSettings(1, 0, singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true")), XContentType.JSON));
+        assertAcked(leaderClient().admin().indices().prepareCreate("leader").setSource(getIndexSettings(1, 0), XContentType.JSON));
         ensureLeaderGreen("leader");
         followerClient().execute(PutFollowAction.INSTANCE, putFollow("leader", "follower")).get();
         final ClusterService clusterService = getLeaderCluster().getInstance(ClusterService.class, getLeaderCluster().getMasterName());
@@ -1170,8 +1143,7 @@ public void onFailure(String source, Exception e) {
 
     public void testMustCloseIndexAndPauseToRestartWithPutFollowing() throws Exception {
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1),
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1));
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("index1");
 
@@ -1254,7 +1226,6 @@ private void runFallBehindTest(
             final Consumer<Collection<ResourceNotFoundException>> exceptionConsumer) throws Exception {
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
         final Map<String, String> extraSettingsMap = new HashMap<>(2);
-        extraSettingsMap.put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true");
         extraSettingsMap.put(IndexService.RETENTION_LEASE_SYNC_INTERVAL_SETTING.getKey(), "200ms");
         final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, between(0, 1), extraSettingsMap);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
@@ -1337,8 +1308,7 @@ public void testUpdateRemoteConfigsDuringFollowing() throws Exception {
         final int numberOfPrimaryShards = randomIntBetween(1, 3);
         int numberOfReplicas = between(0, 1);
 
-        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, numberOfReplicas,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(numberOfPrimaryShards, numberOfReplicas);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderYellow("index1");
 
@@ -1400,7 +1370,6 @@ public void testCleanUpShardFollowTasksForDeletedIndices() throws Exception {
         final int numberOfShards = randomIntBetween(1, 10);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1")
             .setSettings(Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, numberOfShards)
                 .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, randomIntBetween(0, 1))
                 .build()));
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/LocalIndexFollowingIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/LocalIndexFollowingIT.java
index b623be7ccbe0c..1ea95db2df6c5 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/LocalIndexFollowingIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/LocalIndexFollowingIT.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.common.unit.TimeValue;
 import org.elasticsearch.common.xcontent.XContentBuilder;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.xpack.CcrSingleNodeTestCase;
 import org.elasticsearch.xpack.core.ccr.action.CcrStatsAction;
 import org.elasticsearch.xpack.core.ccr.action.FollowStatsAction;
@@ -25,7 +24,6 @@
 import java.util.Collections;
 import java.util.Map;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.common.xcontent.XContentFactory.jsonBuilder;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.equalTo;
@@ -34,8 +32,7 @@
 public class LocalIndexFollowingIT extends CcrSingleNodeTestCase {
 
     public void testFollowIndex() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(2, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(2, 0, Collections.emptyMap());
         assertAcked(client().admin().indices().prepareCreate("leader").setSource(leaderIndexSettings, XContentType.JSON));
         ensureGreen("leader");
 
@@ -88,7 +85,6 @@ public void testRemoveRemoteConnection() throws Exception {
         long previousNumberOfSuccessfulFollowedIndices = getAutoFollowStats().getNumberOfSuccessfulFollowIndices();
 
         Settings leaderIndexSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexMetaData.INDEX_NUMBER_OF_SHARDS_SETTING.getKey(), 1)
             .put(IndexMetaData.INDEX_NUMBER_OF_REPLICAS_SETTING.getKey(), 0)
             .build();
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/RestartIndexFollowingIT.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/RestartIndexFollowingIT.java
index 88370aed0db71..c13d778634fd9 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/RestartIndexFollowingIT.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/RestartIndexFollowingIT.java
@@ -11,7 +11,6 @@
 import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.transport.RemoteConnectionInfo;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.CcrIntegTestCase;
@@ -20,7 +19,6 @@
 import java.util.List;
 import java.util.Locale;
 
-import static java.util.Collections.singletonMap;
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
 import static org.hamcrest.Matchers.equalTo;
 
@@ -37,8 +35,7 @@ protected boolean configureRemoteClusterViaNodeSettings() {
     }
 
     public void testFollowIndex() throws Exception {
-        final String leaderIndexSettings = getIndexSettings(1, 0,
-            singletonMap(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true"));
+        final String leaderIndexSettings = getIndexSettings(1, 0);
         assertAcked(leaderClient().admin().indices().prepareCreate("index1").setSource(leaderIndexSettings, XContentType.JSON));
         ensureLeaderGreen("index1");
         setupRemoteCluster();
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/AutoFollowCoordinatorTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/AutoFollowCoordinatorTests.java
index 1801171866540..b51839bb7cf2c 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/AutoFollowCoordinatorTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/AutoFollowCoordinatorTests.java
@@ -31,6 +31,7 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.VersionUtils;
 import org.elasticsearch.xpack.ccr.Ccr;
 import org.elasticsearch.xpack.ccr.CcrLicenseChecker;
 import org.elasticsearch.xpack.ccr.CcrSettings;
@@ -617,7 +618,7 @@ public void testGetLeaderIndicesToFollow_shardsNotStarted() {
         ClusterState remoteState = createRemoteClusterState("index1", true);
         MetaData.Builder mBuilder= MetaData.builder(remoteState.metaData());
         mBuilder.put(IndexMetaData.builder("index2")
-            .settings(settings(Version.CURRENT).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true))
+            .settings(settings(Version.CURRENT))
             .numberOfShards(1)
             .numberOfReplicas(0));
         ShardRouting shardRouting =
@@ -706,13 +707,11 @@ public void testCleanFollowedLeaderIndices() {
         MetaData remoteMetadata = new MetaData.Builder()
             .put(IndexMetaData.builder("index1")
                 .settings(settings(Version.CURRENT)
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_INDEX_UUID, "index1"))
                 .numberOfShards(1)
                 .numberOfReplicas(0))
             .put(IndexMetaData.builder("index3")
                 .settings(settings(Version.CURRENT)
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_INDEX_UUID, "index3"))
                 .numberOfShards(1)
                 .numberOfReplicas(0))
@@ -735,19 +734,16 @@ public void testCleanFollowedLeaderIndicesNoChanges() {
         MetaData remoteMetadata = new MetaData.Builder()
             .put(IndexMetaData.builder("index1")
                 .settings(settings(Version.CURRENT)
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_INDEX_UUID, "index1"))
                 .numberOfShards(1)
                 .numberOfReplicas(0))
             .put(IndexMetaData.builder("index2")
                 .settings(settings(Version.CURRENT)
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_INDEX_UUID, "index2"))
                 .numberOfShards(1)
                 .numberOfReplicas(0))
             .put(IndexMetaData.builder("index3")
                 .settings(settings(Version.CURRENT)
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_INDEX_UUID, "index3"))
                 .numberOfShards(1)
                 .numberOfReplicas(0))
@@ -767,7 +763,7 @@ public void testCleanFollowedLeaderIndicesNoEntry() {
 
         MetaData remoteMetadata = new MetaData.Builder()
             .put(IndexMetaData.builder("index1")
-                .settings(settings(Version.CURRENT).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true))
+                .settings(settings(Version.CURRENT))
                 .numberOfShards(1)
                 .numberOfReplicas(0))
             .build();
@@ -1251,7 +1247,7 @@ public void testAutoFollowerFollowerIndexAlreadyExists() {
         ClusterState currentState = ClusterState.builder(new ClusterName("name"))
             .metaData(MetaData.builder()
                 .put(IndexMetaData.builder("logs-20190101")
-                    .settings(settings(Version.CURRENT).put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true))
+                    .settings(settings(Version.CURRENT))
                     .putCustom(Ccr.CCR_CUSTOM_METADATA_KEY, Map.of(Ccr.CCR_CUSTOM_METADATA_LEADER_INDEX_UUID_KEY,
                         remoteState.metaData().index("logs-20190101").getIndexUUID()))
                     .numberOfShards(1)
@@ -1396,7 +1392,7 @@ public void testClosedIndicesAreNotAutoFollowed() {
         final ClusterState localState = ClusterState.builder(new ClusterName("local"))
             .metaData(MetaData.builder()
                 .putCustom(AutoFollowMetadata.TYPE,
-                    new AutoFollowMetadata(Map.of(pattern, new AutoFollowPattern("remote", List.of("docs-*"), null, true, 
+                    new AutoFollowMetadata(Map.of(pattern, new AutoFollowPattern("remote", List.of("docs-*"), null, true,
                         null, null, null, null, null, null, null, null, null, null)),
                         Map.of(pattern, List.of()), Map.of(pattern, Map.of()))))
             .build();
@@ -1473,9 +1469,13 @@ private static ClusterState createRemoteClusterState(String indexName, boolean e
 
     private static ClusterState createRemoteClusterState(String indexName, boolean enableSoftDeletes, long metadataVersion) {
         Settings.Builder indexSettings;
-        indexSettings = settings(Version.CURRENT)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), enableSoftDeletes)
-            .put(IndexMetaData.SETTING_INDEX_UUID, UUIDs.randomBase64UUID(random()));
+        if (enableSoftDeletes == false) {
+            indexSettings = settings(VersionUtils.randomPreviousCompatibleVersion(random(), Version.V_8_0_0))
+                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), false);
+        } else {
+            indexSettings = settings(Version.CURRENT);
+        }
+        indexSettings.put(IndexMetaData.SETTING_INDEX_UUID, UUIDs.randomBase64UUID(random()));
 
         IndexMetaData indexMetaData = IndexMetaData.builder(indexName)
             .settings(indexSettings)
@@ -1504,7 +1504,6 @@ private static ClusterState createRemoteClusterState(final ClusterState previous
         for (String indexName : indices) {
             IndexMetaData indexMetaData = IndexMetaData.builder(indexName)
                 .settings(settings(Version.CURRENT)
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                     .put(IndexMetaData.SETTING_INDEX_UUID, UUIDs.randomBase64UUID(random())))
                 .numberOfShards(1)
                 .numberOfReplicas(0)
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardChangesActionTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardChangesActionTests.java
index 801cc7aef158c..b4980913e6bd7 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardChangesActionTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardChangesActionTests.java
@@ -17,7 +17,6 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexNotFoundException;
 import org.elasticsearch.index.IndexService;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.shard.IndexShardNotStartedException;
 import org.elasticsearch.index.shard.ShardId;
@@ -50,7 +49,6 @@ public void testGetOperations() throws Exception {
         final Settings settings = Settings.builder()
                 .put("index.number_of_shards", 1)
                 .put("index.number_of_replicas", 0)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .build();
         final IndexService indexService = createIndex("index", settings);
 
@@ -135,7 +133,6 @@ public void testGetOperationsExceedByteLimit() throws Exception {
         final Settings settings = Settings.builder()
                 .put("index.number_of_shards", 1)
                 .put("index.number_of_replicas", 0)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .build();
         final IndexService indexService = createIndex("index", settings);
 
@@ -166,7 +163,6 @@ public void testGetOperationsAlwaysReturnAtLeastOneOp() throws Exception {
         final Settings settings = Settings.builder()
             .put("index.number_of_shards", 1)
             .put("index.number_of_replicas", 0)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .build();
         final IndexService indexService = createIndex("index", settings);
 
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardChangesTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardChangesTests.java
index c4b56adbd388e..856693b976648 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardChangesTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardChangesTests.java
@@ -46,9 +46,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
 
     // this emulates what the CCR persistent task will do for pulling
     public void testGetOperationsBasedOnGlobalSequenceId() throws Exception {
-        client().admin().indices().prepareCreate("index")
-            .setSettings(Settings.builder().put("index.number_of_shards", 1).put("index.soft_deletes.enabled", true))
-            .get();
+        client().admin().indices().prepareCreate("index").setSettings(Settings.builder().put("index.number_of_shards", 1)).get();
 
         client().prepareIndex("index").setId("1").setSource("{}", XContentType.JSON).get();
         client().prepareIndex("index").setId("2").setSource("{}", XContentType.JSON).get();
@@ -105,7 +103,6 @@ public void testGetOperationsBasedOnGlobalSequenceId() throws Exception {
     public void testMissingOperations() throws Exception {
         client().admin().indices().prepareCreate("index")
             .setSettings(Settings.builder()
-                .put("index.soft_deletes.enabled", true)
                 .put("index.soft_deletes.retention.operations", 0)
                 .put("index.number_of_shards", 1)
                 .put("index.number_of_replicas", 0)
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardFollowTaskReplicationTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardFollowTaskReplicationTests.java
index aebf4129c1afb..67c46b60dddf6 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardFollowTaskReplicationTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/ShardFollowTaskReplicationTests.java
@@ -341,7 +341,6 @@ public void testAddNewFollowingReplica() throws Exception {
         }
         Future<Void> recoveryFuture = null;
         Settings settings = Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(), new ByteSizeValue(between(1, 1000), ByteSizeUnit.KB))
             .build();
         IndexMetaData indexMetaData = buildIndexMetaData(between(0, 1), settings, indexMapping);
@@ -427,7 +426,6 @@ public void testRetentionLeaseManagement() throws Exception {
 
     private ReplicationGroup createLeaderGroup(int replicas) throws IOException {
         Settings settings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .put(IndexSettings.INDEX_SOFT_DELETES_RETENTION_OPERATIONS_SETTING.getKey(), 10000)
             .build();
         return createGroup(replicas, settings);
@@ -435,10 +433,8 @@ private ReplicationGroup createLeaderGroup(int replicas) throws IOException {
 
     private ReplicationGroup createFollowGroup(ReplicationGroup leaderGroup, int replicas) throws IOException {
         final Settings settings = Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
-                .put(
-                        IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(),
-                        new ByteSizeValue(between(1, 1000), ByteSizeUnit.KB))
+                .put(IndexSettings.INDEX_TRANSLOG_FLUSH_THRESHOLD_SIZE_SETTING.getKey(),
+                     new ByteSizeValue(between(1, 1000), ByteSizeUnit.KB))
                 .build();
         IndexMetaData indexMetaData = buildIndexMetaData(replicas, settings, indexMapping);
         return new ReplicationGroup(indexMetaData) {
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/TransportResumeFollowActionTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/TransportResumeFollowActionTests.java
index 3fddd5a7d3f7e..12ee49bd9432e 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/TransportResumeFollowActionTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/TransportResumeFollowActionTests.java
@@ -96,8 +96,7 @@ public void testValidation() throws IOException {
         }
         {
             // should fail, because leader index is closed
-            IndexMetaData leaderIMD = createIMD("index1", State.CLOSE, "{}", 5, Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true").build(), null);
+            IndexMetaData leaderIMD = createIMD("index1", State.CLOSE, "{}", 5, Settings.EMPTY, null);
             IndexMetaData followIMD = createIMD("index2", State.OPEN, "{}", 5, Settings.EMPTY, customMetaData);
             Exception e = expectThrows(IllegalArgumentException.class, () -> validate(request, leaderIMD, followIMD, UUIDs, null));
             assertThat(e.getMessage(), equalTo("leader and follow index must be open"));
@@ -116,10 +115,9 @@ public void testValidation() throws IOException {
         {
             // should fail, because leader has a field with the same name mapped as keyword and follower as text
             IndexMetaData leaderIMD = createIMD("index1", State.OPEN, "{\"properties\": {\"field\": {\"type\": \"keyword\"}}}", 5,
-                Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true").build(), null);
+                Settings.EMPTY, null);
             IndexMetaData followIMD = createIMD("index2", State.OPEN, "{\"properties\": {\"field\": {\"type\": \"text\"}}}", 5,
-                Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-                    .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build(), customMetaData);
+                Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true).build(), customMetaData);
             MapperService mapperService = MapperTestUtils.newMapperService(xContentRegistry(), createTempDir(), Settings.EMPTY, "index2");
             mapperService.updateMapping(null, followIMD);
             Exception e = expectThrows(IllegalArgumentException.class, () -> validate(request, leaderIMD, followIMD, UUIDs, mapperService));
@@ -129,12 +127,10 @@ public void testValidation() throws IOException {
             // should fail because of non whitelisted settings not the same between leader and follow index
             String mapping = "{\"properties\": {\"field\": {\"type\": \"text\", \"analyzer\": \"my_analyzer\"}}}";
             IndexMetaData leaderIMD = createIMD("index1", State.OPEN, mapping, 5, Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true")
                 .put("index.analysis.analyzer.my_analyzer.type", "custom")
                 .put("index.analysis.analyzer.my_analyzer.tokenizer", "whitespace").build(), null);
             IndexMetaData followIMD = createIMD("index2", State.OPEN, mapping, 5, Settings.builder()
                 .put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put("index.analysis.analyzer.my_analyzer.type", "custom")
                 .put("index.analysis.analyzer.my_analyzer.tokenizer", "standard").build(), customMetaData);
             Exception e = expectThrows(IllegalArgumentException.class, () -> validate(request, leaderIMD, followIMD, UUIDs, null));
@@ -145,10 +141,8 @@ public void testValidation() throws IOException {
         }
         {
             // should fail because the following index does not have the following_index settings
-            IndexMetaData leaderIMD = createIMD("index1", 5,
-                Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true").build(), null);
-            Settings followingIndexSettings = Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
-                .put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), false).build();
+            IndexMetaData leaderIMD = createIMD("index1", 5, Settings.EMPTY, null);
+            Settings followingIndexSettings = Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), false).build();
             IndexMetaData followIMD = createIMD("index2", 5, followingIndexSettings, customMetaData);
             MapperService mapperService = MapperTestUtils.newMapperService(xContentRegistry(), createTempDir(),
                 followingIndexSettings, "index2");
@@ -160,10 +154,8 @@ public void testValidation() throws IOException {
         }
         {
             // should succeed
-            IndexMetaData leaderIMD = createIMD("index1", 5, Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true").build(), null);
+            IndexMetaData leaderIMD = createIMD("index1", 5, Settings.EMPTY, null);
             IndexMetaData followIMD = createIMD("index2", 5, Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true).build(), customMetaData);
             MapperService mapperService = MapperTestUtils.newMapperService(xContentRegistry(), createTempDir(), Settings.EMPTY, "index2");
             mapperService.updateMapping(null, followIMD);
@@ -173,12 +165,10 @@ public void testValidation() throws IOException {
             // should succeed, index settings are identical
             String mapping = "{\"properties\": {\"field\": {\"type\": \"text\", \"analyzer\": \"my_analyzer\"}}}";
             IndexMetaData leaderIMD = createIMD("index1", State.OPEN, mapping, 5, Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true")
                 .put("index.analysis.analyzer.my_analyzer.type", "custom")
                 .put("index.analysis.analyzer.my_analyzer.tokenizer", "standard").build(), null);
             IndexMetaData followIMD = createIMD("index2", State.OPEN, mapping, 5, Settings.builder()
                 .put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put("index.analysis.analyzer.my_analyzer.type", "custom")
                 .put("index.analysis.analyzer.my_analyzer.tokenizer", "standard").build(), customMetaData);
             MapperService mapperService = MapperTestUtils.newMapperService(xContentRegistry(), createTempDir(),
@@ -190,13 +180,11 @@ public void testValidation() throws IOException {
             // should succeed despite whitelisted settings being different
             String mapping = "{\"properties\": {\"field\": {\"type\": \"text\", \"analyzer\": \"my_analyzer\"}}}";
             IndexMetaData leaderIMD = createIMD("index1", State.OPEN, mapping, 5, Settings.builder()
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), "true")
                 .put(IndexSettings.INDEX_REFRESH_INTERVAL_SETTING.getKey(), "1s")
                 .put("index.analysis.analyzer.my_analyzer.type", "custom")
                 .put("index.analysis.analyzer.my_analyzer.tokenizer", "standard").build(), null);
             IndexMetaData followIMD = createIMD("index2", State.OPEN, mapping, 5, Settings.builder()
                 .put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-                .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
                 .put(IndexSettings.INDEX_REFRESH_INTERVAL_SETTING.getKey(), "10s")
                 .put("index.analysis.analyzer.my_analyzer.type", "custom")
                 .put("index.analysis.analyzer.my_analyzer.tokenizer", "standard").build(), customMetaData);
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
index 2510a177056d3..1915e578e7f0e 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/action/bulk/BulkShardOperationsTests.java
@@ -13,7 +13,6 @@
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.engine.Engine;
 import org.elasticsearch.index.mapper.Uid;
 import org.elasticsearch.index.shard.IndexShard;
@@ -41,8 +40,7 @@ public class BulkShardOperationsTests extends IndexShardTestCase {
 
     // test that we use the primary term on the follower when applying operations from the leader
     public void testPrimaryTermFromFollower() throws IOException {
-        final Settings settings = Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
+        final Settings settings = Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true).build();
         final IndexShard followerPrimary = newStartedShard(true, settings, new FollowingEngineFactory());
 
         // we use this primary on the operations yet we expect the applied operations to have the primary term of the follower
@@ -92,8 +90,7 @@ public void testPrimaryTermFromFollower() throws IOException {
     }
 
     public void testPrimaryResultIncludeOnlyAppliedOperations() throws Exception {
-        final Settings settings = Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
+        final Settings settings = Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true).build();
         final IndexShard oldPrimary = newStartedShard(true, settings, new FollowingEngineFactory());
         final long oldPrimaryTerm = oldPrimary.getOperationPrimaryTerm();
         long seqno = 0;
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/index/engine/FollowEngineIndexShardTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/index/engine/FollowEngineIndexShardTests.java
index 44112b114a771..74a331064dce8 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/index/engine/FollowEngineIndexShardTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/index/engine/FollowEngineIndexShardTests.java
@@ -21,7 +21,6 @@
 import org.elasticsearch.common.lease.Releasable;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.xcontent.XContentType;
-import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.engine.EngineTestCase;
 import org.elasticsearch.index.mapper.SourceToParse;
 import org.elasticsearch.index.shard.IndexShard;
@@ -50,10 +49,7 @@
 public class FollowEngineIndexShardTests extends IndexShardTestCase {
 
     public void testDoNotFillGaps() throws Exception {
-        Settings settings = Settings.builder()
-            .put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
-            .build();
+        Settings settings = Settings.builder().put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true).build();
         final IndexShard indexShard = newStartedShard(false, settings, new FollowingEngineFactory());
 
         long seqNo = -1;
@@ -99,13 +95,9 @@ public void testDoNotFillGaps() throws Exception {
     }
 
     public void testRestoreShard() throws IOException {
-        final Settings sourceSettings = Settings.builder()
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
-            .build();
-        final IndexShard source = newStartedShard(true, sourceSettings);
+        final IndexShard source = newStartedShard(true, Settings.EMPTY);
         final Settings targetSettings = Settings.builder()
             .put(CcrSettings.CCR_FOLLOWING_INDEX_SETTING.getKey(), true)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
             .build();
         IndexShard target = newStartedShard(true, targetSettings, new FollowingEngineFactory());
         assertThat(IndexShardTestCase.getEngine(target), instanceOf(FollowingEngine.class));
diff --git a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/index/engine/FollowingEngineTests.java b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/index/engine/FollowingEngineTests.java
index eb07feed60068..286526f6e70f2 100644
--- a/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/index/engine/FollowingEngineTests.java
+++ b/x-pack/plugin/ccr/src/test/java/org/elasticsearch/xpack/ccr/index/engine/FollowingEngineTests.java
@@ -131,7 +131,6 @@ public void testOutOfOrderDocuments() throws IOException {
                         .put("index.number_of_replicas", 0)
                         .put("index.version.created", Version.CURRENT)
                         .put("index.xpack.ccr.following_index", true)
-                        .put("index.soft_deletes.enabled", true)
                         .build();
         final IndexMetaData indexMetaData = IndexMetaData.builder(index.getName()).settings(settings).build();
         final IndexSettings indexSettings = new IndexSettings(indexMetaData, settings);
@@ -157,7 +156,6 @@ public void runIndexTest(
                         .put("index.number_of_replicas", 0)
                         .put("index.version.created", Version.CURRENT)
                         .put("index.xpack.ccr.following_index", true)
-                        .put("index.soft_deletes.enabled", true)
                         .build();
         final IndexMetaData indexMetaData = IndexMetaData.builder(index.getName()).settings(settings).build();
         final IndexSettings indexSettings = new IndexSettings(indexMetaData, settings);
@@ -192,7 +190,6 @@ public void runDeleteTest(
                         .put("index.number_of_replicas", 0)
                         .put("index.version.created", Version.CURRENT)
                         .put("index.xpack.ccr.following_index", true)
-                        .put("index.soft_deletes.enabled", true)
                         .build();
         final IndexMetaData indexMetaData = IndexMetaData.builder(index.getName()).settings(settings).build();
         final IndexSettings indexSettings = new IndexSettings(indexMetaData, settings);
@@ -223,7 +220,6 @@ public void testDoNotFillSeqNoGaps() throws Exception {
                 .put("index.number_of_replicas", 0)
                 .put("index.version.created", Version.CURRENT)
                 .put("index.xpack.ccr.following_index", true)
-                .put("index.soft_deletes.enabled", true)
                 .build();
         final IndexMetaData indexMetaData = IndexMetaData.builder(index.getName()).settings(settings).build();
         final IndexSettings indexSettings = new IndexSettings(indexMetaData, settings);
@@ -492,7 +488,7 @@ private void runFollowTest(CheckedBiConsumer<InternalEngine, FollowingEngine, Ex
 
         Settings leaderSettings = Settings.builder()
             .put("index.number_of_shards", 1).put("index.number_of_replicas", 0)
-            .put("index.version.created", Version.CURRENT).put("index.soft_deletes.enabled", true).build();
+            .put("index.version.created", Version.CURRENT).build();
         IndexMetaData leaderIndexMetaData = IndexMetaData.builder(index.getName()).settings(leaderSettings).build();
         IndexSettings leaderIndexSettings = new IndexSettings(leaderIndexMetaData, leaderSettings);
         try (Store leaderStore = createStore(shardId, leaderIndexSettings, newDirectory())) {
@@ -578,8 +574,7 @@ public void close() throws IOException {
 
     public void testProcessOnceOnPrimary() throws Exception {
         final Settings settings = Settings.builder().put("index.number_of_shards", 1).put("index.number_of_replicas", 0)
-            .put("index.version.created", Version.CURRENT).put("index.xpack.ccr.following_index", true)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
+            .put("index.version.created", Version.CURRENT).put("index.xpack.ccr.following_index", true).build();
         final IndexMetaData indexMetaData = IndexMetaData.builder(index.getName()).settings(settings).build();
         final IndexSettings indexSettings = new IndexSettings(indexMetaData, settings);
         final CheckedBiFunction<String, Integer, ParsedDocument, IOException> nestedDocFunc = EngineTestCase.nestedParsedDocFactory();
@@ -673,8 +668,7 @@ public void testVerifyShardBeforeIndexClosingIsNoOp() throws IOException {
 
     public void testMaxSeqNoInCommitUserData() throws Exception {
         final Settings settings = Settings.builder().put("index.number_of_shards", 1).put("index.number_of_replicas", 0)
-            .put("index.version.created", Version.CURRENT).put("index.xpack.ccr.following_index", true)
-            .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true).build();
+            .put("index.version.created", Version.CURRENT).put("index.xpack.ccr.following_index", true).build();
         final IndexMetaData indexMetaData = IndexMetaData.builder(index.getName()).settings(settings).build();
         final IndexSettings indexSettings = new IndexSettings(indexMetaData, settings);
         try (Store store = createStore(shardId, indexSettings, newDirectory())) {
diff --git a/x-pack/plugin/ilm/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java b/x-pack/plugin/ilm/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java
index 3933a1cd70365..2f4c61a9fe006 100644
--- a/x-pack/plugin/ilm/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java
+++ b/x-pack/plugin/ilm/qa/multi-cluster/src/test/java/org/elasticsearch/xpack/ilm/CCRIndexLifecycleIT.java
@@ -55,7 +55,6 @@ public void testBasicCCRAndILMIntegration() throws Exception {
         if ("leader".equals(targetCluster)) {
             putILMPolicy(policyName, "50GB", null, TimeValue.timeValueHours(7*24));
             Settings indexSettings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
                 .put("index.number_of_shards", 1)
                 .put("index.number_of_replicas", 0)
                 .put("index.lifecycle.name", policyName)
@@ -114,7 +113,6 @@ public void testCCRUnfollowDuringSnapshot() throws Exception {
         String indexName = "unfollow-test-index";
         if ("leader".equals(targetCluster)) {
             Settings indexSettings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
                 .put("index.number_of_shards", 2)
                 .put("index.number_of_replicas", 0)
                 .build();
@@ -190,7 +188,6 @@ public void testCcrAndIlmWithRollover() throws Exception {
             putILMPolicy(policyName, null, 1, null);
             Request templateRequest = new Request("PUT", "_template/my_template");
             Settings indexSettings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
                 .put("index.number_of_shards", 1)
                 .put("index.number_of_replicas", 0)
                 .put("index.lifecycle.name", policyName)
@@ -290,7 +287,6 @@ public void testAliasReplicatedOnShrink() throws Exception {
 
         if ("leader".equals(targetCluster)) {
             Settings indexSettings = Settings.builder()
-                    .put("index.soft_deletes.enabled", true)
                     .put("index.number_of_shards", 3)
                     .put("index.number_of_replicas", 0)
                     .put("index.lifecycle.name", policyName) // this policy won't exist on the leader, that's fine
@@ -356,7 +352,6 @@ public void testUnfollowInjectedBeforeShrink() throws Exception {
 
         if ("leader".equals(targetCluster)) {
             Settings indexSettings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
                 .put("index.number_of_shards", 3)
                 .put("index.number_of_replicas", 0)
                 .put("index.lifecycle.name", policyName) // this policy won't exist on the leader, that's fine
@@ -408,7 +403,6 @@ public void testCannotShrinkLeaderIndex() throws Exception {
             // follower
             putShrinkOnlyPolicy(client(), policyName);
             Settings indexSettings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
                 .put("index.number_of_shards", 2)
                 .put("index.number_of_replicas", 0)
                 .build();
@@ -481,7 +475,6 @@ public void testILMUnfollowFailsToRemoveRetentionLeases() throws Exception {
 
         if ("leader".equals(targetCluster)) {
             Settings indexSettings = Settings.builder()
-                .put("index.soft_deletes.enabled", true)
                 .put("index.number_of_shards", 1)
                 .put("index.number_of_replicas", 0)
                 .put("index.lifecycle.name", policyName) // this policy won't exist on the leader, that's fine

From 8c0d2106b99bf5376c4c7fbbfb68037ef687f4d2 Mon Sep 17 00:00:00 2001
From: Jason Tedor <jason@tedor.me>
Date: Mon, 20 Jan 2020 10:52:19 -0500
Subject: [PATCH 670/686] Exclude autoscaling docs from release docs (#51190)

Since autoscaling is currently only under development, this commit
causes the autoscaling docs to be excluded any time that release docs
are being built.
---
 docs/reference/index.asciidoc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/reference/index.asciidoc b/docs/reference/index.asciidoc
index 7199b97981453..2609d20313140 100644
--- a/docs/reference/index.asciidoc
+++ b/docs/reference/index.asciidoc
@@ -40,8 +40,12 @@ include::ingest.asciidoc[]
 
 include::ilm/index.asciidoc[]
 
+ifeval::["{release-state}"=="unreleased"]
+
 include::autoscaling/index.asciidoc[]
 
+endif::[]
+
 include::sql/index.asciidoc[]
 
 include::monitoring/index.asciidoc[]

From fe0a41c4c2068110b72c53bcd57cdf6a73236017 Mon Sep 17 00:00:00 2001
From: Adrien Grand <jpountz@gmail.com>
Date: Mon, 20 Jan 2020 18:05:26 +0100
Subject: [PATCH 671/686] Disable xpack/15_basic/Usage stats for mappings.

Relates #51127
---
 .../src/test/resources/rest-api-spec/test/xpack/15_basic.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/test/xpack/15_basic.yml b/x-pack/plugin/src/test/resources/rest-api-spec/test/xpack/15_basic.yml
index 4757ee00360e9..cb54a464aef2f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/test/xpack/15_basic.yml
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/test/xpack/15_basic.yml
@@ -168,6 +168,11 @@
 
 ---
 "Usage stats for mappings":
+
+  - skip:
+      version: "all"
+      reason: "AwaitsFix https://github.com/elastic/elasticsearch/issues/51127"
+
   - do:
       xpack.usage: {}
 

From 4d5f670c405d1706ef88d223982c7439ac56ba57 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 22 Jan 2020 23:02:16 -0800
Subject: [PATCH 672/686] Rebase master

---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 22a98c09c925b..0b0f3b4dc8f6c 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -353,7 +353,7 @@ public void testWaitForSnapshot() throws Exception {
         request = new Request("DELETE", "/_snapshot/" + repo);
         assertOK(client().performRequest(request));
     }
-    
+
     public void testWaitForSnapshotSlmExecutedBefore() throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));

From 6a8195f257ebf5497584514323b35ed98151743d Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Tue, 28 Jan 2020 22:55:01 -0800
Subject: [PATCH 673/686] Fixing broken tests

---
 .../org/elasticsearch/xpack/core/ilm/ForceMergeAction.java    | 2 +-
 .../elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java   | 2 +-
 .../elasticsearch/xpack/core/ilm/ForceMergeActionTests.java   | 4 ++--
 .../xpack/core/ilm/WaitForIndexColorStepTests.java            | 4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 502ad7722d105..a5ca84b65a55d 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -150,7 +150,7 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         List<Step> mergeSteps = new ArrayList<>();
         mergeSteps.add(readOnlyStep);
 
-        if (codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
+        if (codec != null && codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
             mergeSteps.add(closeIndexStep);
             mergeSteps.add(updateBestCompressionSettings);
             mergeSteps.add(openIndexStep);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
index fd02a69999c73..13a20016c05bb 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
@@ -54,7 +54,7 @@ public boolean equals(Object obj) {
             return false;
         }
         WaitForIndexColorStep other = (WaitForIndexColorStep) obj;
-        return super.equals(obj) && Objects.equals(this.color, other.color);
+        return super.equals(obj) && Objects.equals(this.color.value(), other.color.value());
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index e581237177b17..9f99c5adacf72 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -119,8 +119,8 @@ public void testInvalidNegativeSegmentNumber() {
 
     public void testInvalidCodec() {
         Exception r = expectThrows(IllegalArgumentException.class, () -> new
-            ForceMergeAction(randomIntBetween(-10, 0), Codec.forName(CodecService.DEFAULT_CODEC)));
-        assertThat(r.getMessage(), equalTo("Best Compression type not found instead " + CodecService.DEFAULT_CODEC + " is used."));
+            ForceMergeAction(randomIntBetween(1, 10), Codec.forName("DummyCompressingStoredFields")));
+        assertThat(r.getMessage(), equalTo("unknown index codec: [DummyCompressingStoredFields]"));
     }
 
     public void testToSteps() {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
index 0baa5a830df82..a8e997eada829 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
@@ -130,7 +130,7 @@ public void testConditionNotMetNoIndexRoutingTable() {
         assertThat(result.isComplete(), is(false));
         WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
         assertThat(info, notNullValue());
-        assertThat(info.getMessage(), equalTo("index is red; no IndexRoutingTable"));
+        assertThat(info.getMessage(), equalTo("index is red; no indexRoutingTable"));
     }
 
     public void testConditionMetForYellow() {
@@ -198,7 +198,7 @@ public void testConditionNotMetNoIndexRoutingTableForYellow() {
         assertThat(result.isComplete(), is(false));
         WaitForIndexColorStep.Info info = (WaitForIndexColorStep.Info) result.getInfomationContext();
         assertThat(info, notNullValue());
-        assertThat(info.getMessage(), equalTo("index is red; no IndexRoutingTable"));
+        assertThat(info.getMessage(), equalTo("index is red; no indexRoutingTable"));
     }
 }
 

From 000821dca838cce4c366c804a20e83ba6f09aee5 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 29 Jan 2020 15:06:08 -0800
Subject: [PATCH 674/686] Changing codec to String for best compression

---
 .../xpack/core/ilm/ForceMergeAction.java      | 25 +++++-----
 .../xpack/core/ilm/WaitForIndexColorStep.java |  2 +-
 .../xpack/core/ilm/ForceMergeActionTests.java | 47 ++++++++++---------
 .../core/ilm/WaitForIndexColorStepTests.java  |  5 +-
 4 files changed, 41 insertions(+), 38 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index a5ca84b65a55d..d4468b3a1b7bc 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
-import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.Version;
 import org.elasticsearch.client.Client;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
@@ -39,30 +38,30 @@ public class ForceMergeAction implements LifecycleAction {
     private static final ConstructingObjectParser<ForceMergeAction, Void> PARSER = new ConstructingObjectParser<>(NAME,
         false, a -> {
         int maxNumSegments = (int) a[0];
-        Codec codec = a[1] != null ? Codec.forName((String) a[1]) : null;
+        String codec = a[1] != null ? (String) a[1] : null;
         return new ForceMergeAction(maxNumSegments, codec);
     });
 
     static {
         PARSER.declareInt(ConstructingObjectParser.constructorArg(), MAX_NUM_SEGMENTS_FIELD);
-        PARSER.declareInt(ConstructingObjectParser.optionalConstructorArg(), CODEC);
+        PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), CODEC);
     }
 
     private final int maxNumSegments;
-    private final Codec codec;
+    private final String codec;
 
     public static ForceMergeAction parse(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
 
-    public ForceMergeAction(int maxNumSegments, @Nullable Codec codec) {
+    public ForceMergeAction(int maxNumSegments, @Nullable String codec) {
         if (maxNumSegments <= 0) {
             throw new IllegalArgumentException("[" + MAX_NUM_SEGMENTS_FIELD.getPreferredName()
                 + "] must be a positive integer");
         }
         this.maxNumSegments = maxNumSegments;
-        if (codec != null && CodecService.BEST_COMPRESSION_CODEC.equals(codec.getName()) == false) {
-            throw new IllegalArgumentException("unknown index codec: [" + codec.getName() + "]");
+        if (codec != null && CodecService.BEST_COMPRESSION_CODEC.equals(codec) == false) {
+            throw new IllegalArgumentException("unknown index codec: [" + codec + "]");
         }
         this.codec = codec;
     }
@@ -74,7 +73,7 @@ public ForceMergeAction(StreamInput in) throws IOException {
             if (codecStr == null) {
                 this.codec = null;
             } else {
-                this.codec = Codec.forName(codecStr);
+                this.codec = codecStr;
             }
         } else {
             this.codec = null;
@@ -85,7 +84,7 @@ public int getMaxNumSegments() {
         return maxNumSegments;
     }
 
-    public Codec getCodec() {
+    public String getCodec() {
         return this.codec;
     }
 
@@ -96,7 +95,7 @@ public void writeTo(StreamOutput out) throws IOException {
             if (codec == null) {
                 out.writeOptionalString(null);
             } else {
-                out.writeOptionalString(codec.getName());
+                out.writeOptionalString(codec);
             }
         }
     }
@@ -150,7 +149,7 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         List<Step> mergeSteps = new ArrayList<>();
         mergeSteps.add(readOnlyStep);
 
-        if (codec != null && codec.getName().equals(CodecService.BEST_COMPRESSION_CODEC)) {
+        if (codec != null && codec.equals(CodecService.BEST_COMPRESSION_CODEC)) {
             mergeSteps.add(closeIndexStep);
             mergeSteps.add(updateBestCompressionSettings);
             mergeSteps.add(openIndexStep);
@@ -176,8 +175,8 @@ public boolean equals(Object obj) {
             return false;
         }
         ForceMergeAction other = (ForceMergeAction) obj;
-        return Objects.equals(maxNumSegments, other.maxNumSegments)
-            && Objects.equals(codec, other.codec);
+        return Objects.equals(this.maxNumSegments, other.maxNumSegments)
+            && Objects.equals(this.codec, other.codec);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
index 13a20016c05bb..fd02a69999c73 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStep.java
@@ -54,7 +54,7 @@ public boolean equals(Object obj) {
             return false;
         }
         WaitForIndexColorStep other = (WaitForIndexColorStep) obj;
-        return super.equals(obj) && Objects.equals(this.color.value(), other.color.value());
+        return super.equals(obj) && Objects.equals(this.color, other.color);
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 9f99c5adacf72..d77bc54c089f1 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -5,7 +5,6 @@
  */
 package org.elasticsearch.xpack.core.ilm;
 
-import org.apache.lucene.codecs.Codec;
 import org.elasticsearch.cluster.metadata.IndexMetaData;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.Writeable.Reader;
@@ -39,11 +38,11 @@ static ForceMergeAction randomInstance() {
         return new ForceMergeAction(randomIntBetween(1, 100), createRandomCompressionSettings());
     }
 
-    static Codec createRandomCompressionSettings() {
+    static String createRandomCompressionSettings() {
         if (randomBoolean()) {
             return null;
         }
-        return Codec.forName(CodecService.BEST_COMPRESSION_CODEC);
+        return CodecService.BEST_COMPRESSION_CODEC;
     }
 
     @Override
@@ -81,26 +80,30 @@ private void assertBestCompression(ForceMergeAction instance) {
         StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
         List<Step> steps = instance.toSteps(null, phase, nextStepKey);
         assertNotNull(steps);
-        assertEquals(6, steps.size());
-        CloseIndexStep firstStep = (CloseIndexStep) steps.get(0);
-        UpdateSettingsStep secondStep = (UpdateSettingsStep) steps.get(1);
-        OpenIndexStep thirdStep = (OpenIndexStep) steps.get(2);
-        WaitForIndexColorStep fourthStep = (WaitForIndexColorStep) steps.get(3);
-        ForceMergeStep fifthStep = (ForceMergeStep) steps.get(4);
-        SegmentCountStep sixthStep = (SegmentCountStep) steps.get(4);
-        assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
-        assertThat(firstStep.getNextStepKey(), equalTo(secondStep.getKey()));
-        assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
-        assertThat(secondStep.getSettings().get(EngineConfig.INDEX_CODEC_SETTING.getKey()), equalTo(CodecService.BEST_COMPRESSION_CODEC));
+        assertEquals(7, steps.size());
+        UpdateSettingsStep firstStep = (UpdateSettingsStep) steps.get(0);
+        CloseIndexStep secondStep = (CloseIndexStep) steps.get(1);
+        UpdateSettingsStep thirdStep = (UpdateSettingsStep) steps.get(2);
+        OpenIndexStep fourthStep = (OpenIndexStep) steps.get(3);
+        WaitForIndexColorStep fifthStep = (WaitForIndexColorStep) steps.get(4);
+        ForceMergeStep sixthStep = (ForceMergeStep) steps.get(5);
+        SegmentCountStep seventhStep = (SegmentCountStep) steps.get(6);
+        assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ReadOnlyAction.NAME)));
+        assertThat(firstStep.getNextStepKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
+        assertTrue(IndexMetaData.INDEX_BLOCKS_WRITE_SETTING.get(firstStep.getSettings()));
+        assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
         assertThat(secondStep.getNextStepKey(), equalTo(thirdStep.getKey()));
-        assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
-        assertThat(thirdStep.getNextStepKey(), equalTo(fourthStep));
-        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexColorStep.NAME)));
+        assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
+        assertThat(thirdStep.getSettings().get(EngineConfig.INDEX_CODEC_SETTING.getKey()), equalTo(CodecService.BEST_COMPRESSION_CODEC));
+        assertThat(thirdStep.getNextStepKey(), equalTo(fourthStep.getKey()));
+        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
         assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
-        assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
-        assertThat(fifthStep.getNextStepKey(), equalTo(nextStepKey));
-        assertThat(sixthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
+        assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexColorStep.NAME)));
+        assertThat(fifthStep.getNextStepKey(), equalTo(sixthStep));
+        assertThat(sixthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
         assertThat(sixthStep.getNextStepKey(), equalTo(nextStepKey));
+        assertThat(seventhStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
+        assertThat(seventhStep.getNextStepKey(), equalTo(nextStepKey));
     }
 
     public void testMissingMaxNumSegments() throws IOException {
@@ -119,13 +122,13 @@ public void testInvalidNegativeSegmentNumber() {
 
     public void testInvalidCodec() {
         Exception r = expectThrows(IllegalArgumentException.class, () -> new
-            ForceMergeAction(randomIntBetween(1, 10), Codec.forName("DummyCompressingStoredFields")));
+            ForceMergeAction(randomIntBetween(1, 10), "DummyCompressingStoredFields"));
         assertThat(r.getMessage(), equalTo("unknown index codec: [DummyCompressingStoredFields]"));
     }
 
     public void testToSteps() {
         ForceMergeAction instance = createTestInstance();
-        if (instance.getCodec() != null && CodecService.BEST_COMPRESSION_CODEC.equals(instance.getCodec().getName())) {
+        if (instance.getCodec() != null && CodecService.BEST_COMPRESSION_CODEC.equals(instance.getCodec())) {
             assertBestCompression(instance);
         }
         else {
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
index a8e997eada829..69652fb26b401 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
@@ -44,7 +44,7 @@ protected WaitForIndexColorStep createRandomInstance() {
     protected WaitForIndexColorStep mutateInstance(WaitForIndexColorStep instance) {
         StepKey key = instance.getKey();
         StepKey nextKey = instance.getNextStepKey();
-        ClusterHealthStatus color = instance.getColor();
+        ClusterHealthStatus color = instance.getColor(), newColor = randomColor();
 
         switch (between(0, 2)) {
             case 0:
@@ -54,7 +54,8 @@ protected WaitForIndexColorStep mutateInstance(WaitForIndexColorStep instance) {
                 nextKey = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
                 break;
             case 2:
-                color = randomColor();
+                color = (color != newColor) ? newColor: randomColor();
+                break;
         }
 
         return new WaitForIndexColorStep(key, nextKey, color);

From 99933309f091fb00ba1725758de3bcd658314fe4 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 29 Jan 2020 16:30:12 -0800
Subject: [PATCH 675/686] Random color test fix

---
 .../xpack/core/ilm/WaitForIndexColorStepTests.java           | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
index 69652fb26b401..236d6005c71bb 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/WaitForIndexColorStepTests.java
@@ -45,6 +45,9 @@ protected WaitForIndexColorStep mutateInstance(WaitForIndexColorStep instance) {
         StepKey key = instance.getKey();
         StepKey nextKey = instance.getNextStepKey();
         ClusterHealthStatus color = instance.getColor(), newColor = randomColor();
+        while (color.equals(newColor)) {
+            newColor = randomColor();
+        }
 
         switch (between(0, 2)) {
             case 0:
@@ -54,7 +57,7 @@ protected WaitForIndexColorStep mutateInstance(WaitForIndexColorStep instance) {
                 nextKey = new StepKey(key.getPhase(), key.getAction(), key.getName() + randomAlphaOfLength(5));
                 break;
             case 2:
-                color = (color != newColor) ? newColor: randomColor();
+                color = newColor;
                 break;
         }
 

From e338e949ffe2e824b62681a14667a171a458a376 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 29 Jan 2020 19:01:32 -0800
Subject: [PATCH 676/686] fixing broken test

---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index b598495cf0218..90a757a19b3b5 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -482,7 +482,7 @@ public void forceMergeActionWithCodec(Codec codec) throws Exception {
         };
         assertThat(numSegments.get(), greaterThan(1));
 
-        createNewSingletonPolicy("warm", new ForceMergeAction(1, codec));
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, codec.getName()));
         updatePolicy(index, policy);
 
         assertBusy(() -> {

From 2063828c592686235933076d94ddc89b0cdf75eb Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 29 Jan 2020 20:57:06 -0800
Subject: [PATCH 677/686] adding null pointer check

---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 90a757a19b3b5..a13dd0db2350a 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -481,8 +481,8 @@ public void forceMergeActionWithCodec(Codec codec) throws Exception {
             }
         };
         assertThat(numSegments.get(), greaterThan(1));
-
-        createNewSingletonPolicy("warm", new ForceMergeAction(1, codec.getName()));
+        String codecName = codec != null ? codec.getName(): null;
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, codecName));
         updatePolicy(index, policy);
 
         assertBusy(() -> {

From 69d58ebe22c81cd970ea12efdb2709744f3f59ce Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 29 Jan 2020 22:56:07 -0800
Subject: [PATCH 678/686] refactor plus fixing test

---
 .../org/elasticsearch/xpack/core/ilm/ForceMergeAction.java  | 6 +++---
 .../elasticsearch/xpack/core/ilm/ForceMergeActionTests.java | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index d4468b3a1b7bc..85f80274eb84f 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -136,15 +136,15 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
         StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
 
-        UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, forceMergeKey, client, readOnlySettings);
-        ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
-        SegmentCountStep segmentCountStep = new SegmentCountStep(countKey, nextStepKey, client, maxNumSegments);
+        UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, closeKey, client, readOnlySettings);
         CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
         UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
             openKey, client, bestCompressionSettings);
         OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
         WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
             forceMergeKey, ClusterHealthStatus.GREEN);
+        ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
+        SegmentCountStep segmentCountStep = new SegmentCountStep(countKey, nextStepKey, client, maxNumSegments);
 
         List<Step> mergeSteps = new ArrayList<>();
         mergeSteps.add(readOnlyStep);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index d77bc54c089f1..69769138501b3 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -89,7 +89,7 @@ private void assertBestCompression(ForceMergeAction instance) {
         ForceMergeStep sixthStep = (ForceMergeStep) steps.get(5);
         SegmentCountStep seventhStep = (SegmentCountStep) steps.get(6);
         assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ReadOnlyAction.NAME)));
-        assertThat(firstStep.getNextStepKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
+        assertThat(firstStep.getNextStepKey(), equalTo(secondStep));
         assertTrue(IndexMetaData.INDEX_BLOCKS_WRITE_SETTING.get(firstStep.getSettings()));
         assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
         assertThat(secondStep.getNextStepKey(), equalTo(thirdStep.getKey()));

From af20e442724cfa801b00f6ad9f12e4d112323629 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 29 Jan 2020 23:47:05 -0800
Subject: [PATCH 679/686] Adding forceMerge step for handling both old and new
 flow

---
 .../xpack/core/ilm/ForceMergeAction.java      |  6 ++-
 .../xpack/core/ilm/ForceMergeActionTests.java | 37 ++++++++++---------
 2 files changed, 24 insertions(+), 19 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 85f80274eb84f..013af8f19e3a3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -136,20 +136,22 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
         StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
 
-        UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, closeKey, client, readOnlySettings);
+        UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, forceMergeKey, client, readOnlySettings);
+        ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
         CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
+        ForceMergeStep forceMergeStepForBestCompression = new ForceMergeStep(forceMergeKey, closeKey, client, maxNumSegments);
         UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
             openKey, client, bestCompressionSettings);
         OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
         WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
             forceMergeKey, ClusterHealthStatus.GREEN);
-        ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
         SegmentCountStep segmentCountStep = new SegmentCountStep(countKey, nextStepKey, client, maxNumSegments);
 
         List<Step> mergeSteps = new ArrayList<>();
         mergeSteps.add(readOnlyStep);
 
         if (codec != null && codec.equals(CodecService.BEST_COMPRESSION_CODEC)) {
+            mergeSteps.add(forceMergeStepForBestCompression);
             mergeSteps.add(closeIndexStep);
             mergeSteps.add(updateBestCompressionSettings);
             mergeSteps.add(openIndexStep);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 69769138501b3..07e68c8662258 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -80,30 +80,33 @@ private void assertBestCompression(ForceMergeAction instance) {
         StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
         List<Step> steps = instance.toSteps(null, phase, nextStepKey);
         assertNotNull(steps);
-        assertEquals(7, steps.size());
+        assertEquals(8, steps.size());
         UpdateSettingsStep firstStep = (UpdateSettingsStep) steps.get(0);
-        CloseIndexStep secondStep = (CloseIndexStep) steps.get(1);
-        UpdateSettingsStep thirdStep = (UpdateSettingsStep) steps.get(2);
-        OpenIndexStep fourthStep = (OpenIndexStep) steps.get(3);
-        WaitForIndexColorStep fifthStep = (WaitForIndexColorStep) steps.get(4);
-        ForceMergeStep sixthStep = (ForceMergeStep) steps.get(5);
-        SegmentCountStep seventhStep = (SegmentCountStep) steps.get(6);
+        ForceMergeStep secondStep = (ForceMergeStep) steps.get(1);
+        CloseIndexStep thirdStep = (CloseIndexStep) steps.get(2);
+        UpdateSettingsStep fourthStep = (UpdateSettingsStep) steps.get(3);
+        OpenIndexStep fifthStep = (OpenIndexStep) steps.get(4);
+        WaitForIndexColorStep sixthStep = (WaitForIndexColorStep) steps.get(5);
+        ForceMergeStep seventhStep = (ForceMergeStep) steps.get(6);
+        SegmentCountStep eighthStep = (SegmentCountStep) steps.get(7);
         assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ReadOnlyAction.NAME)));
         assertThat(firstStep.getNextStepKey(), equalTo(secondStep));
         assertTrue(IndexMetaData.INDEX_BLOCKS_WRITE_SETTING.get(firstStep.getSettings()));
-        assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
-        assertThat(secondStep.getNextStepKey(), equalTo(thirdStep.getKey()));
-        assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
-        assertThat(thirdStep.getSettings().get(EngineConfig.INDEX_CODEC_SETTING.getKey()), equalTo(CodecService.BEST_COMPRESSION_CODEC));
+        assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeAction.NAME)));
+        assertThat(secondStep.getNextStepKey(), equalTo(thirdStep));
+        assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
         assertThat(thirdStep.getNextStepKey(), equalTo(fourthStep.getKey()));
-        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
-        assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
-        assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexColorStep.NAME)));
+        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
+        assertThat(fourthStep.getSettings().get(EngineConfig.INDEX_CODEC_SETTING.getKey()), equalTo(CodecService.BEST_COMPRESSION_CODEC));
+        assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep.getKey()));
+        assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
         assertThat(fifthStep.getNextStepKey(), equalTo(sixthStep));
-        assertThat(sixthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
-        assertThat(sixthStep.getNextStepKey(), equalTo(nextStepKey));
-        assertThat(seventhStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
+        assertThat(sixthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexColorStep.NAME)));
+        assertThat(sixthStep.getNextStepKey(), equalTo(seventhStep));
+        assertThat(seventhStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
         assertThat(seventhStep.getNextStepKey(), equalTo(nextStepKey));
+        assertThat(eighthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
+        assertThat(eighthStep.getNextStepKey(), equalTo(nextStepKey));
     }
 
     public void testMissingMaxNumSegments() throws IOException {

From 3c1db21194abf55ae0179253a9418099fbc7d914 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Wed, 29 Jan 2020 23:47:05 -0800
Subject: [PATCH 680/686] Adding forceMerge step (as it idempotent) for
 handling both old and new flow

---
 .../xpack/core/ilm/ForceMergeAction.java      |  6 ++-
 .../xpack/core/ilm/ForceMergeActionTests.java | 37 ++++++++++---------
 2 files changed, 24 insertions(+), 19 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 85f80274eb84f..013af8f19e3a3 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -136,20 +136,22 @@ public List<Step> toSteps(Client client, String phase, Step.StepKey nextStepKey)
         StepKey waitForGreenIndexKey = new StepKey(phase, NAME, WaitForIndexColorStep.NAME);
         StepKey updateCompressionKey = new StepKey(phase, NAME, UpdateSettingsStep.NAME);
 
-        UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, closeKey, client, readOnlySettings);
+        UpdateSettingsStep readOnlyStep = new UpdateSettingsStep(readOnlyKey, forceMergeKey, client, readOnlySettings);
+        ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
         CloseIndexStep closeIndexStep = new CloseIndexStep(closeKey, updateCompressionKey, client);
+        ForceMergeStep forceMergeStepForBestCompression = new ForceMergeStep(forceMergeKey, closeKey, client, maxNumSegments);
         UpdateSettingsStep updateBestCompressionSettings = new UpdateSettingsStep(updateCompressionKey,
             openKey, client, bestCompressionSettings);
         OpenIndexStep openIndexStep = new OpenIndexStep(openKey, waitForGreenIndexKey, client);
         WaitForIndexColorStep waitForIndexGreenStep = new WaitForIndexColorStep(waitForGreenIndexKey,
             forceMergeKey, ClusterHealthStatus.GREEN);
-        ForceMergeStep forceMergeStep = new ForceMergeStep(forceMergeKey, countKey, client, maxNumSegments);
         SegmentCountStep segmentCountStep = new SegmentCountStep(countKey, nextStepKey, client, maxNumSegments);
 
         List<Step> mergeSteps = new ArrayList<>();
         mergeSteps.add(readOnlyStep);
 
         if (codec != null && codec.equals(CodecService.BEST_COMPRESSION_CODEC)) {
+            mergeSteps.add(forceMergeStepForBestCompression);
             mergeSteps.add(closeIndexStep);
             mergeSteps.add(updateBestCompressionSettings);
             mergeSteps.add(openIndexStep);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
index 69769138501b3..07e68c8662258 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ilm/ForceMergeActionTests.java
@@ -80,30 +80,33 @@ private void assertBestCompression(ForceMergeAction instance) {
         StepKey nextStepKey = new StepKey(randomAlphaOfLength(10), randomAlphaOfLength(10), randomAlphaOfLength(10));
         List<Step> steps = instance.toSteps(null, phase, nextStepKey);
         assertNotNull(steps);
-        assertEquals(7, steps.size());
+        assertEquals(8, steps.size());
         UpdateSettingsStep firstStep = (UpdateSettingsStep) steps.get(0);
-        CloseIndexStep secondStep = (CloseIndexStep) steps.get(1);
-        UpdateSettingsStep thirdStep = (UpdateSettingsStep) steps.get(2);
-        OpenIndexStep fourthStep = (OpenIndexStep) steps.get(3);
-        WaitForIndexColorStep fifthStep = (WaitForIndexColorStep) steps.get(4);
-        ForceMergeStep sixthStep = (ForceMergeStep) steps.get(5);
-        SegmentCountStep seventhStep = (SegmentCountStep) steps.get(6);
+        ForceMergeStep secondStep = (ForceMergeStep) steps.get(1);
+        CloseIndexStep thirdStep = (CloseIndexStep) steps.get(2);
+        UpdateSettingsStep fourthStep = (UpdateSettingsStep) steps.get(3);
+        OpenIndexStep fifthStep = (OpenIndexStep) steps.get(4);
+        WaitForIndexColorStep sixthStep = (WaitForIndexColorStep) steps.get(5);
+        ForceMergeStep seventhStep = (ForceMergeStep) steps.get(6);
+        SegmentCountStep eighthStep = (SegmentCountStep) steps.get(7);
         assertThat(firstStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ReadOnlyAction.NAME)));
         assertThat(firstStep.getNextStepKey(), equalTo(secondStep));
         assertTrue(IndexMetaData.INDEX_BLOCKS_WRITE_SETTING.get(firstStep.getSettings()));
-        assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
-        assertThat(secondStep.getNextStepKey(), equalTo(thirdStep.getKey()));
-        assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
-        assertThat(thirdStep.getSettings().get(EngineConfig.INDEX_CODEC_SETTING.getKey()), equalTo(CodecService.BEST_COMPRESSION_CODEC));
+        assertThat(secondStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeAction.NAME)));
+        assertThat(secondStep.getNextStepKey(), equalTo(thirdStep));
+        assertThat(thirdStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, CloseIndexStep.NAME)));
         assertThat(thirdStep.getNextStepKey(), equalTo(fourthStep.getKey()));
-        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
-        assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep));
-        assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexColorStep.NAME)));
+        assertThat(fourthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, UpdateSettingsStep.NAME)));
+        assertThat(fourthStep.getSettings().get(EngineConfig.INDEX_CODEC_SETTING.getKey()), equalTo(CodecService.BEST_COMPRESSION_CODEC));
+        assertThat(fourthStep.getNextStepKey(), equalTo(fifthStep.getKey()));
+        assertThat(fifthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, OpenIndexStep.NAME)));
         assertThat(fifthStep.getNextStepKey(), equalTo(sixthStep));
-        assertThat(sixthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
-        assertThat(sixthStep.getNextStepKey(), equalTo(nextStepKey));
-        assertThat(seventhStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
+        assertThat(sixthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, WaitForIndexColorStep.NAME)));
+        assertThat(sixthStep.getNextStepKey(), equalTo(seventhStep));
+        assertThat(seventhStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, ForceMergeStep.NAME)));
         assertThat(seventhStep.getNextStepKey(), equalTo(nextStepKey));
+        assertThat(eighthStep.getKey(), equalTo(new StepKey(phase, ForceMergeAction.NAME, SegmentCountStep.NAME)));
+        assertThat(eighthStep.getNextStepKey(), equalTo(nextStepKey));
     }
 
     public void testMissingMaxNumSegments() throws IOException {

From a4be717f1ff649338f677c0be1d4c3578d1b03c7 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 30 Jan 2020 09:45:42 -0800
Subject: [PATCH 681/686] Adding non-compression test fix

---
 .../xpack/ilm/TimeSeriesLifecycleActionsIT.java            | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index a13dd0db2350a..4254b6efb4362 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -458,7 +458,7 @@ public void testReadOnly() throws Exception {
     }
 
     @SuppressWarnings("unchecked")
-    public void forceMergeActionWithCodec(Codec codec) throws Exception {
+    public void forceMergeActionWithCodec(String codec) throws Exception {
         createIndexWithSettings(index, Settings.builder().put(IndexMetaData.SETTING_NUMBER_OF_SHARDS, 1)
             .put(IndexMetaData.SETTING_NUMBER_OF_REPLICAS, 0));
         for (int i = 0; i < randomIntBetween(2, 10); i++) {
@@ -481,8 +481,7 @@ public void forceMergeActionWithCodec(Codec codec) throws Exception {
             }
         };
         assertThat(numSegments.get(), greaterThan(1));
-        String codecName = codec != null ? codec.getName(): null;
-        createNewSingletonPolicy("warm", new ForceMergeAction(1, codecName));
+        createNewSingletonPolicy("warm", new ForceMergeAction(1, codec));
         updatePolicy(index, policy);
 
         assertBusy(() -> {
@@ -496,7 +495,7 @@ public void forceMergeActionWithCodec(Codec codec) throws Exception {
 
     public void testForceMergeAction() throws Exception {
         forceMergeActionWithCodec(null);
-        forceMergeActionWithCodec(Codec.forName(CodecService.BEST_COMPRESSION_CODEC));
+        forceMergeActionWithCodec(CodecService.BEST_COMPRESSION_CODEC);
     }
 
 

From 59e15525c6affcb2c18e9fbf92b933a39c8e79d6 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 30 Jan 2020 18:55:06 -0800
Subject: [PATCH 682/686] Removing unused import

---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java    | 1 -
 1 file changed, 1 deletion(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 4254b6efb4362..7ce1e3c164492 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -8,7 +8,6 @@
 
 import org.apache.http.entity.ContentType;
 import org.apache.http.entity.StringEntity;
-import org.apache.lucene.codecs.Codec;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.client.Request;

From 3380459546e9cf5708252f7529ccb8575c0a4229 Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 30 Jan 2020 23:12:33 -0800
Subject: [PATCH 683/686] Removing compression test

---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java   | 2 --
 1 file changed, 2 deletions(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index 7ce1e3c164492..a669eadbf3e8a 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -494,10 +494,8 @@ public void forceMergeActionWithCodec(String codec) throws Exception {
 
     public void testForceMergeAction() throws Exception {
         forceMergeActionWithCodec(null);
-        forceMergeActionWithCodec(CodecService.BEST_COMPRESSION_CODEC);
     }
 
-
     public void testShrinkAction() throws Exception {
         int numShards = 4;
         int divisor = randomFrom(2, 4);

From 766ed8e3d3befbdde19c2fede15455bae23f8bab Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Thu, 30 Jan 2020 23:19:53 -0800
Subject: [PATCH 684/686] Remove unused import

---
 .../elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java    | 1 -
 1 file changed, 1 deletion(-)

diff --git a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
index a669eadbf3e8a..57911b4d18162 100644
--- a/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
+++ b/x-pack/plugin/ilm/qa/multi-node/src/test/java/org/elasticsearch/xpack/ilm/TimeSeriesLifecycleActionsIT.java
@@ -24,7 +24,6 @@
 import org.elasticsearch.common.xcontent.XContentType;
 import org.elasticsearch.common.xcontent.json.JsonXContent;
 import org.elasticsearch.index.IndexSettings;
-import org.elasticsearch.index.codec.CodecService;
 import org.elasticsearch.test.rest.ESRestTestCase;
 import org.elasticsearch.xpack.core.ilm.AllocateAction;
 import org.elasticsearch.xpack.core.ilm.DeleteAction;

From c3ec0b2c3c64d5256983287e4075ba4c8ebf524a Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Fri, 31 Jan 2020 16:27:36 -0800
Subject: [PATCH 685/686] review comments

---
 .../xpack/core/ilm/ForceMergeAction.java              | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 013af8f19e3a3..43bd785c33dcd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -69,12 +69,7 @@ public ForceMergeAction(int maxNumSegments, @Nullable String codec) {
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
         if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
-            String codecStr = in.readOptionalString();
-            if (codecStr == null) {
-                this.codec = null;
-            } else {
-                this.codec = codecStr;
-            }
+                this.codec = in.readOptionalString();;
         } else {
             this.codec = null;
         }
@@ -92,11 +87,7 @@ public String getCodec() {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
         if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
-            if (codec == null) {
-                out.writeOptionalString(null);
-            } else {
                 out.writeOptionalString(codec);
-            }
         }
     }
 

From f32b6048f48dcc8c6cba9a8f1b445e2a2716038f Mon Sep 17 00:00:00 2001
From: Sivagurunathan Velayutham <sivadeva.93@gmail.com>
Date: Fri, 31 Jan 2020 16:42:23 -0800
Subject: [PATCH 686/686] Formatting the code :face_palm

---
 .../org/elasticsearch/xpack/core/ilm/ForceMergeAction.java    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
index 43bd785c33dcd..9715c12d6b906 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/ForceMergeAction.java
@@ -69,7 +69,7 @@ public ForceMergeAction(int maxNumSegments, @Nullable String codec) {
     public ForceMergeAction(StreamInput in) throws IOException {
         this.maxNumSegments = in.readVInt();
         if (in.getVersion().onOrAfter(Version.V_8_0_0)) {
-                this.codec = in.readOptionalString();;
+            this.codec = in.readOptionalString();
         } else {
             this.codec = null;
         }
@@ -87,7 +87,7 @@ public String getCodec() {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(maxNumSegments);
         if (out.getVersion().onOrAfter(Version.V_8_0_0)) {
-                out.writeOptionalString(codec);
+            out.writeOptionalString(codec);
         }
     }